# 🛡️ AI Guardrails Protocol (v0.1.0)

> **A small, free, MIT-licensed research prototype for one rule: A CLAIM IS NOT EVIDENCE.** It does not authenticate source claims or provide production security certification.

## 🌐 Dienstleistungen jetzt direkt anfragen

**[CERBERRUS144 Services – öffentliche Angebotsseite öffnen](https://faint-cipher-9q5qgja.shipstatic.com/)**

- **Quellenbasierter Recherche-Brief:** ab 79 € für eine klar abgegrenzte Recherche mit Quellenliste
- **Büroablauf-Check:** 99 € für 30 Minuten Gespräch und eine kurze Ergebnisnotiz
- **Kontakt:** [cerberrus144-os@agentmail.to](mailto:cerberrus144-os@agentmail.to)

Die Kontaktseite eröffnet nur eine E-Mail im Mailprogramm des Besuchers; sie nimmt keine Zahlungen an und erzeugt ohne aktives Versenden keine Kundenanfrage. Auftragsannahme erst nach individueller Prüfung und Zustimmung. **Das ist eine veröffentlichte Angebotsseite, kein Beleg für zahlende Kunden.**

## 🔎 Wir übernehmen konkrete Recherche- und Büroaufgaben

**Neuer Schwerpunkt: Dienstleistungen statt KI-Produktverkauf.** Wir prüfen einen bestehenden Verwaltungsablauf, dokumentieren konkrete Verbesserungen oder recherchieren ein eng begrenztes Geschäftsthema – ohne neue Software und ohne Zugriff auf vertrauliche Daten.

- **Büroablauf-Check (99 €):** 30 Minuten persönliches Gespräch über einen Ablauf + kurze umsetzbare Ergebnisnotiz.
- **Quellenbasierter Recherche-Brief (ab 79 €):** 2–3 Seiten zu einem eng definierten Thema mit prüfbarer Quellenliste.

➡️ **[Leistungen, Grenzen und Ablauf ansehen](SERVICES.md)** · **[Unverbindliche Anfrage an das CERBERRUS144-Postfach](mailto:cerberrus144-os@agentmail.to?subject=Anfrage%20CERBERRUS144%20Dienstleistung)**

Ein Auftrag entsteht erst nach individueller Prüfung, schriftlicher Umfangsbestätigung und Klärung der formalen Voraussetzungen. Keine automatischen Gebühren durch eine Anfrage, keine zugesicherten Umsatzsteigerungen.

### Selbstprüfung und bisherige Materialien

Der [kostenlose KI-Workflow-Selbstcheck](https://charlysmoky2010-hub.github.io/ai-guardrails-protocol/?utm_source=github&utm_medium=readme&utm_campaign=cerberrus_xray_q4_2026#selbstcheck) und das bisherige [29-€-Workbook](https://smokycharly.gumroad.com/l/cyrada?utm_source=github&utm_medium=readme&utm_campaign=cerberrus_xray_q4_2026&utm_content=legacy_workbook) bleiben verfügbar, stehen aber **nicht mehr im Mittelpunkt unseres Dienstleistungsangebots**.

## KI-Agenten und Automatisierung: 8 Kontrollfragen vor dem Einsatz

MCP, n8n, API-Workflows oder autonome Agenten? Prüfe zuerst **Zugriffsrechte, menschliche Verantwortung, sensible Daten, Fehlermodi und Belegbarkeit** – kostenlos, ohne Anmeldung und ohne Upload sensibler Daten.

### 1. Kostenlos beginnen

[**KI-Workflow-Selbstcheck im Browser öffnen (8 Fragen) →**](https://charlysmoky2010-hub.github.io/ai-guardrails-protocol/?utm_source=github&utm_medium=readme&utm_campaign=cerberrus_xray_q4_2026#selbstcheck)

Die acht Fragen liefern eine erste Orientierung, **keinen** belastbaren Sicherheits- oder Compliance-Nachweis. KI-Risiken und wirtschaftliche Automatisierbarkeit müssen separat geprüft werden.

**Praxisbeispiel für kleine Betreuungsdienste:** [7-Punkte-Checkliste zur Digitalisierung von Büroanfragen (kostenlos)](docs/betreuungsdienst-bueroarbeit-digitalisieren-checkliste.md) – mit konkreten Prüffragen, Datenschutzgrenzen und menschlichen Freigaben; keine echten Patienten- oder Kundendaten.

### 2. Einen konkreten Prozess systematisch bewerten

[**CERBERRUS Operational X-Ray (€29) – Anwendung, kostenloses Beispiel und Kaufoption →**](https://charlysmoky2010-hub.github.io/ai-guardrails-protocol/operational-xray-workbook/?utm_source=github&utm_medium=readme&utm_campaign=operational_xray_de)

Offline-Arbeitsmaterial zur Beschreibung eines wiederkehrenden Prozesses, möglicher Engpässe, Prüfaufwände und Entscheidungskriterien **vor einer KI-Investition**. Digitales Selbstlernprodukt, keine persönliche Beratung. Zusätzliche Steuern werden gegebenenfalls im Gumroad-Checkout angezeigt.

### 3. Persönliche Unterstützung nur bei konkretem Bedarf

[**Projektanfrage bei CERBERRUS144 AI Operations →**](https://baseless-dust-738gwd3.shipstatic.com/?utm_source=github&utm_medium=readme&utm_campaign=cerberrus_inbound_q4_2026)

Für begrenzte Workflow-Analysen, Datenaufgaben oder technische Vorprüfungen. Das Formular ist freiwillig; eine Anfrage ist **keine** Bestellung, Zahlung oder garantierte Projektannahme. Keine automatische Kaltakquise. Persönliche Beratungsangebote sind vom freien MIT-Code und vom €29-Workbook getrennt.

**Status der kommerziellen Angebote:** Öffentliche Links sind keine Belege für Besucher, bezahlte Käufe oder Einsparungen. Wir messen ausschließlich nachprüfbare Ergebnisse.

---

> **Security notice (2026-10-11):** This public version does **not** authenticate caller-supplied verifier names or primary-source metadata. A malicious agent can supply fabricated verification information that is not independently checked. Do not use it as a production security, payment, compliance or source-authenticity verifier. **Update 2026-10-11:** The published truth-boundary function now rejects every caller-supplied `VERIFIED` value, including records with fabricated `independent_verifier` labels. This is a fail-closed mitigation, not a trusted source-verification adapter.

[![License: MIT](https://img.shields.io/badge/License-MIT-emerald.svg)](LICENSE)
[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/)

---

### Why this exists
Most autonomous agent frameworks allow an LLM to declare its own completion and success. This self-evaluative hallucination is unsafe. This prototype implements some deterministic validation rules. It rejects certain unsupported claims (for example, some records missing a verifier field) but **does not establish that a named verifier really checked the evidence**. A malicious or mistaken caller may still supply an untrusted verifier label. Correct source authentication and trusted authorization boundaries require additional engineering.

---

### Usage Example

```python
from guardrails import TruthBoundaryEnforcer, GuardrailViolation

# 1. Unverified observation passes cleanly into the state graph:
valid_record = {
    "entity": "github_stats",
    "state": "OBSERVED",
    "verification_status": "UNVERIFIED"
}
TruthBoundaryEnforcer.validate_observation(valid_record) # OK

# 2. A VERIFIED record with no verifier field is rejected by this prototype:
hallucinated_record = {
    "entity": "revenue",
    "state": "OBSERVED",
    "verification_status": "VERIFIED" # Missing independent_verifier!
}

try:
    TruthBoundaryEnforcer.validate_observation(hallucinated_record)
except GuardrailViolation as e:
    print(f"Blocked: {e}")
```

---

### MCP Server Configuration
An entry point for Model Context Protocol is included in `mcp_server.py`. You can configure it in Claude Desktop by adding this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ai-guardrails": {
      "command": "python3",
      "args": ["/absolute/path/to/ai-guardrails-protocol/mcp_server.py"]
    }
  }
}
```

Replace `/absolute/path/to/ai-guardrails-protocol` with the path to your own clone.

---

### Current Status & Limitations
- **Fail-closed guard:** `enforce_truth_boundary` blocks any incoming `VERIFIED` assertion. Independent verification requires an authenticated primary-source integration not included in this repository.
- **Regression tests:** 30 passing on 2026-10-11, including five new forged-verifier tests.
- **Prototype:** This is a minimalist reference implementation. Its verification field is not independently authenticated.
- **Security boundary:** Caller-supplied evidence provenance and verifier identity must not be treated as genuine verification. Do not deploy this as a standalone security enforcement service.
- **MCP annotations:** The provided tool annotations are metadata, not access-control enforcement.
- **No Paid Version:** The code is completely free and open source under MIT.
- **Warranty:** Provided as-is without warranty.

---

### Related PHI NEXUS service (optional)

For teams who want to assess a real AI-enabled workflow, [PHI NEXUS offers a free browser-based operational self-check](https://reverent-echo-c6ynd3a.shipstatic.com/), plus an optional human-guided 30-minute workflow discovery (€99) and a scoped review (€490). For a lower-cost **self-service** alternative, the [German CERBERRUS Operational X-Ray offline workbook (€29, Gumroad)](https://smokycharly.gumroad.com/l/cyrada?utm_source=github&utm_medium=project_readme&utm_campaign=xray_sales_q4_2026&utm_content=ai_guardrails) provides a process analysis template and decision scorecard without personal consulting. These are separate optional commercial offers, **not** a paid license, security certification or endorsement of this open-source module. The source code here remains MIT licensed and free.

---

## License
MIT License. Copyright (c) 2026 Yusuf Sen / PHI-BRAIN Systems.

## TITANIUS autonomous commercial and design workers

This public, credential-free runner is the independent observer for the
private TITANIUS/CERBERRUS parent brain. See
[runner documentation](docs/TITANIUS_AUTONOMOUS_RUNNER.md),
[the live persistent work queue](https://github.com/charlysmoky2010-hub/ai-guardrails-protocol/issues/1),
and [the verified Lighthouse results](https://github.com/charlysmoky2010-hub/ai-guardrails-protocol/actions/runs/40073582153).
Public site audits and task journaling function without ChatGPT or a paid LLM.
They do not create sales or prove payments.