Leck gemeldet.
\" \\\n --execute \\\n --confirm-write yes \\\n --json\n\nfacilioo-agent-cli ops processes update \\\n --id 987 \\\n --set stageId=8 \\\n --set isFinished=false \\\n --execute \\\n --confirm-write yes \\\n --json\n```\n\n### Process delete with explicit special approval\n\n```bash\nfacilioo-agent-cli ops processes delete \\\n --id 987 \\\n --preview \\\n --json\n\nfacilioo-agent-cli ops processes delete \\\n --id 987 \\\n --execute \\\n --allow-delete \\\n --confirm-delete yes \\\n --json\n```\n\nThe same delete rule applies to every exposed delete command in this package.\n\n### Documents\n\n```bash\nfacilioo-agent-cli documents search --property-id 123 --search \"Versicherung\" --json\nfacilioo-agent-cli documents show --id 5001 --json\nfacilioo-agent-cli documents download --id 5001 --output /absolute/path/file.pdf --json\n```\n\nCreate a document through the signed upload flow:\n\n```bash\nfacilioo-agent-cli documents create \\\n --input /absolute/path/rechnung.pdf \\\n --type-id 12 \\\n --title \"Rechnung Sanitär\" \\\n --property-id 123 \\\n --execute \\\n --confirm-write yes \\\n --json\n```\n\n### Attachments\n\n```bash\nfacilioo-agent-cli documents attachments list --target inquiry --target-id 2001 --json\n\nfacilioo-agent-cli documents attachments add \\\n --target inquiry \\\n --target-id 2001 \\\n --input /absolute/path/foto.jpg \\\n --type-id 12 \\\n --execute \\\n --confirm-write yes \\\n --json\n```\n\n### Conferences\n\n```bash\nfacilioo-agent-cli conferences search --property-id 123 --json\nfacilioo-agent-cli conferences show --id 7001 --json\nfacilioo-agent-cli conferences agenda --id 7001 --json\nfacilioo-agent-cli conferences protocol --id 7001 --json\nfacilioo-agent-cli conferences technical-protocol --id 7001 --json\nfacilioo-agent-cli conferences context --id 7001 --json\nfacilioo-agent-cli conferences match-transcript --conference-id 7001 --input /absolute/path/transcript.txt --json\nfacilioo-agent-cli conferences implementation-plan --conference-id 7001 --input /absolute/path/final-protocol.txt --preview --json\n```\n\nEV analysis commands default to curated, redacted JSON. Use `--raw` only when a human explicitly needs raw Facilioo payloads for debugging.\n\n## Guardrails\n\n- Reads are available by default.\n- EV analysis reads are redacted by default because owners, contracts, attendees, and protocols can contain personal data.\n- Writes require `--execute --confirm-write yes`.\n- Every exposed delete requires `--execute --allow-delete --confirm-delete yes`.\n- `--preview` should be used before sensitive changes or deletes.\n- Password login is interactive only.\n- Tokens are never printed in normal status or doctor output.\n- `auth export` is explicit and opt-in for cross-process handoff.\n- Public docs and examples use placeholders only.\n\n## Auth and session model\n\nThe CLI is static-env-first and persisted-session-first.\n\nStatic values still come from environment variables:\n\n- `FACILIOO_BASE_URL`\n- `FACILIOO_API_VERSION`\n- `FACILIOO_AUTH_METHOD`\n- optional: `FACILIOO_API_KEY`\n\nAfter `auth login`, the CLI persists the live session locally.\nOn macOS it prefers the Keychain.\nBusiness commands automatically refresh old sessions before work starts and retry once after `401 Unauthorized`.\n`auth export` exists only as an explicit bridge for another shell process.\n\nUseful commands:\n\n```bash\nfacilioo-agent-cli auth status --json\nfacilioo-agent-cli auth refresh --json\nfacilioo-agent-cli auth export --write-env-file ~/.config/facilioo-agent-cli/session.env --json\nfacilioo-agent-cli auth clear --json\n```\n\n## Privacy and publish hygiene\n\nThis package is intentionally published with a strict npm file whitelist.\nPrivate planning and research data are not part of the public package surface.\n\nThat means:\n\n- `Plans/` is private\n- repo-local research and knowledge notes are private\n- `.env*` is private\n- tarballs and local output folders stay private\n\n## References\n\n- `skills/facilioo-agent-cli/SKILL.md`\n- `skills/facilioo-agent-cli/references/overview.md`\n- `skills/facilioo-agent-cli/references/agent-onboarding.md`\n- `skills/facilioo-agent-cli/references/facilioo-first-run.md`\n- `skills/facilioo-agent-cli/references/command-cheatsheet.md`\n\n---\n\n# Deutsch\n\n## Zweck\n\n`facilioo-agent-skill` ist ein agentenorientiertes Facilioo-Toolkit mit dem Produktziel, Arbeitsabläufe einer Hausverwaltung in Facilioo möglichst umfassend zu automatisieren.\nEs besteht aus einer echten CLI plus einem Codex-Skill-Payload, sodass ein Agent es installieren, sich einmal authentifizieren, Kontext zu Objekten oder Einheiten aufbauen und Facilioo-Workflows per Terminal statt über den Browser ausführen kann.\n\nDie Zielrichtung ist nicht nur selektiver API-Zugriff, sondern eine Ende-zu-Ende-Automatisierung der wichtigen Tagesgeschäfts-Workflows einer Hausverwaltung in Facilioo.\nDazu gehören Kontextaufbau, operative Fallbearbeitung, Dokumentenarbeit und konferenzbezogene Abläufe.\nDer aktuelle veröffentlichbare Stand deckt bereits den operativen Kern ab und ist bewusst so aufgebaut, dass tiefere Workflow-Automatisierung später ohne Redesign der öffentlichen CLI-Oberfläche ergänzt werden kann.\n\nDie öffentliche Produktoberfläche ist:\n\n- `facilioo-agent-cli`\n- `facilioo-agent-skill`\n\nDer Skill erklärt, wie ein Agent diese CLI sicher verwenden soll.\nEr ist keine alternative Implementierung.\n\n## Aktueller Umfang\n\n- passwortbasierte Standard-Authentifizierung mit lokal persistierter Session\n- technischer API-Key-Login als explizite Option\n- automatische Session-Härtung durch Preflight-Refresh und einen Retry nach `401 Unauthorized`\n- `auth status`, `auth login`, `auth refresh`, `auth export`, `auth clear`\n- `doctor`-Profile für Auth, Core-Reads und Dokumenten-I/O\n- Kontextsuche für Objekte, Eingänge, Einheiten, Parteien, Konten und Kontaktdaten\n- operative Workflows für Anfragen, Vorgänge, Work Orders, Termine, User Tasks, Notifications und Notices\n- Dokumentensuche, Dokumentendownload und Dokumentenerstellung über den signierten Upload-Flow\n- Anhangs-Workflows für Anfragen, Anfrageantworten und Prozess-Feed-Einträge\n- Konferenzsuche sowie Details, Agenda, Protokoll, Themen und Beschlüsse\n- Installer, der den Skill-Payload nach `~/.codex/skills/facilioo-agent-cli` kopiert\n\n## Produktrichtung\n\nDas langfristige Produktziel ist, einen Agenten dazu zu befähigen, Facilioo-Workflows so vollständig wie möglich über die CLI zu bearbeiten.\n\nPraktisch bedeutet das:\n\n- den richtigen Arbeitskontext schnell aufbauen\n- offene operative Arbeit über Anfragen, Vorgänge, Work Orders, Termine, Tasks, Notifications und Notices verstehen\n- Dokumente lesen, erstellen, verknüpfen und herunterladen, ohne die Oberfläche zu wechseln\n- konferenzbezogene Daten dort bearbeiten, wo sie im Verwaltungsalltag relevant sind\n- gefährliche Aktionen explizit absichern, statt sie hinter rohen API-Calls zu verstecken\n\nDie aktuelle Umsetzung ist deshalb als erste veröffentlichbare Automatisierungsoberfläche zu lesen, nicht als endgültige Funktionsgrenze.\n\n## Installation\n\n### 1. Paket installieren\n\n```bash\nnpm install -g @codecell-germany/facilioo-agent-skill\n```\n\nDiese globale Installation macht die öffentlichen CLI-Binaries verfügbar.\nSie kopiert den Codex-Skill-Payload noch nicht nach `~/.codex/skills/`.\n\n### 2. CLI prüfen\n\n```bash\nfacilioo-agent-cli --help\nfacilioo-agent-skill --help\n```\n\n### 3. Skill-Payload für Codex installieren\n\n```bash\nfacilioo-agent-skill install --force\n```\n\nDieser zweite Schritt ist beabsichtigt.\nEr installiert den Codex-Skill-Payload und den lokalen Codex-Shim unter `~/.codex/`.\n\n## Schnellstart\n\nVoraussetzungen:\n\n- Node.js `>= 20`\n- Facilioo-Konto mit API-Zugang\n- bevorzugt: Zugang über den normalen Benutzerlogin\n\nWenn dies die erste Einrichtung ist, zuerst den eingebauten Guide ausgeben:\n\n```bash\nfacilioo-agent-cli setup --language en\nfacilioo-agent-cli setup --language de\n```\n\nEmpfohlene statische Umgebungswerte:\n\n```bash\nexport FACILIOO_BASE_URL=\"https://api.facilioo.de\"\nexport FACILIOO_API_VERSION=\"2.0\"\nexport FACILIOO_AUTH_METHOD=\"password\"\n```\n\nDiese CLI zielt auf die aktuelle Gen2-API-Oberfläche unter `/api`.\nDie ältere OpenAPI-Oberfläche ist laut Facilioo veraltet und soll am 1. Januar 2027 abgeschaltet werden.\n\nStandard-Login:\n\n```bash\nfacilioo-agent-cli auth login --method password --interactive --persist\n```\n\nDieser Passwort-Flow ist bewusst lokal und interaktiv.\nEr sollte von einem Menschen in einem echten TTY abgeschlossen werden, nicht von einem headless oder nicht-interaktiven Agentenloop.\n\nOptionaler technischer Login:\n\n```bash\nexport FACILIOO_API_KEY=\"...\"\nfacilioo-agent-cli auth login --method api-key --persist\n```\n\nTokens sollten nicht fest im Code hinterlegt werden.\nSie sollten bei Bedarf dynamisch angefordert werden, während die CLI die Session lokal persistiert.\n\nVor echter Arbeit die Session validieren:\n\n```bash\nfacilioo-agent-cli auth status --json\nfacilioo-agent-cli doctor --profile auth --json\nfacilioo-agent-cli doctor --profile core-read --json\n```\n\nErst wenn `doctor` gesund ist, sollte der Agent zu Arbeitskommandos wechseln:\n\n```bash\nfacilioo-agent-cli context lookup --search \"Musterstraße 12\" --json\nfacilioo-agent-cli ops inbox --property-id 123 --json\n```\n\n## Deterministische Erstreihenfolge für Agenten\n\nWenn ein frischer Agent diesen Skill erhält, ist die richtige Reihenfolge:\n\n1. `facilioo-agent-cli --help`\n2. `facilioo-agent-cli auth status --json`\n3. `facilioo-agent-cli doctor --profile auth --json`\n4. wenn das Setup unvollständig ist, `facilioo-agent-cli setup --language en|de` ausgeben\n5. zuerst nur statische Werte einsammeln:\n - `FACILIOO_BASE_URL`\n - `FACILIOO_API_VERSION`\n - `FACILIOO_AUTH_METHOD`\n6. wenn ein Mensch am Terminal verfügbar ist, zuerst den lokalen Passwort-Flow verwenden:\n - `facilioo-agent-cli auth login --method password --interactive --persist`\n7. API-Key-Login nur verwenden, wenn der Nutzer ausdrücklich ein technisches oder stärker automatisiertes Setup möchte:\n - `FACILIOO_API_KEY`\n - `facilioo-agent-cli auth login --method api-key --persist`\n8. danach erneut ausführen:\n - `facilioo-agent-cli auth status --json`\n - `facilioo-agent-cli doctor --profile core-read --json`\n9. erst dann mit `context`, `ops`, `documents` oder `conferences` beginnen\n\nNicht mit versteckten lokalen Installationspfaden, repo-lokalem `dist/` oder rohen HTTP-Experimenten starten.\n\n## Beispielkommandos\n\n### Kontextsuche\n\n```bash\nfacilioo-agent-cli context lookup --search \"Musterstraße 12\" --json\nfacilioo-agent-cli context property --id 123 --include entrances,units,tenant,documents,ops,owners,contracts,responsibilities --json\nfacilioo-agent-cli context unit --id 456 --include documents,ops --json\n```\n\n`owners`, `contracts` und `responsibilities` lesen EV-relevante Stammdaten wie Eigentümer,\nEinheitsverträge, Notfallkontakte, zuständige Mitarbeitende, Gewerke und zugewiesene ausführende Firmen.\n\n### Vorgänge\n\n```bash\nfacilioo-agent-cli ops processes search --property-id 123 --open-only --json\nfacilioo-agent-cli ops processes show --id 987 --json\nfacilioo-agent-cli ops processes feed --id 987 --json\nfacilioo-agent-cli ops processes tasks --id 987 --json\nfacilioo-agent-cli ops processes work-orders --id 987 --json\n```\n\n### Vorgang anlegen und aktualisieren\n\n```bash\nfacilioo-agent-cli ops processes create \\\n --set contactId=321 \\\n --set typeId=4 \\\n --set unitId=456 \\\n --set subject=\"Wasserschaden Küche\" \\\n --set report=\"Leck gemeldet.
\" \\\n --execute \\\n --confirm-write yes \\\n --json\n\nfacilioo-agent-cli ops processes update \\\n --id 987 \\\n --set stageId=8 \\\n --set isFinished=false \\\n --execute \\\n --confirm-write yes \\\n --json\n```\n\n### Vorgang löschen nur mit ausdrücklicher Sonderfreigabe\n\n```bash\nfacilioo-agent-cli ops processes delete \\\n --id 987 \\\n --preview \\\n --json\n\nfacilioo-agent-cli ops processes delete \\\n --id 987 \\\n --execute \\\n --allow-delete \\\n --confirm-delete yes \\\n --json\n```\n\nDieselbe Delete-Regel gilt für jeden öffentlich exponierten Delete-Befehl in diesem Paket.\n\n### Dokumente\n\n```bash\nfacilioo-agent-cli documents search --property-id 123 --search \"Versicherung\" --json\nfacilioo-agent-cli documents show --id 5001 --json\nfacilioo-agent-cli documents download --id 5001 --output /absolute/path/file.pdf --json\n```\n\nDokument über den signierten Upload-Flow anlegen:\n\n```bash\nfacilioo-agent-cli documents create \\\n --input /absolute/path/rechnung.pdf \\\n --type-id 12 \\\n --title \"Rechnung Sanitär\" \\\n --property-id 123 \\\n --execute \\\n --confirm-write yes \\\n --json\n```\n\n### Anhänge\n\n```bash\nfacilioo-agent-cli documents attachments list --target inquiry --target-id 2001 --json\n\nfacilioo-agent-cli documents attachments add \\\n --target inquiry \\\n --target-id 2001 \\\n --input /absolute/path/foto.jpg \\\n --type-id 12 \\\n --execute \\\n --confirm-write yes \\\n --json\n```\n\n### Konferenzen\n\n```bash\nfacilioo-agent-cli conferences search --property-id 123 --json\nfacilioo-agent-cli conferences show --id 7001 --json\nfacilioo-agent-cli conferences agenda --id 7001 --json\nfacilioo-agent-cli conferences protocol --id 7001 --json\nfacilioo-agent-cli conferences technical-protocol --id 7001 --json\nfacilioo-agent-cli conferences context --id 7001 --json\nfacilioo-agent-cli conferences match-transcript --conference-id 7001 --input /absolute/path/transkript.txt --json\nfacilioo-agent-cli conferences implementation-plan --conference-id 7001 --input /absolute/path/finales-protokoll.txt --preview --json\n```\n\nEV-Analysebefehle liefern standardmäßig kuratierte, redigierte JSON-Ausgaben. `--raw` nur verwenden, wenn ein Mensch Rohdaten ausdrücklich zur Diagnose braucht.\n\n## Guardrails\n\n- Reads sind standardmäßig verfügbar.\n- EV-Analyse-Reads sind standardmäßig redigiert, weil Eigentümer, Verträge, Teilnehmer und Protokolle personenbezogene Daten enthalten können.\n- Writes erfordern `--execute --confirm-write yes`.\n- Jeder exponierte Delete erfordert `--execute --allow-delete --confirm-delete yes`.\n- `--preview` sollte vor sensiblen Änderungen oder Deletes verwendet werden.\n- Passwort-Login ist nur interaktiv.\n- Tokens werden in normaler Status- oder Doctor-Ausgabe nie ausgegeben.\n- `auth export` ist explizit opt-in für prozessübergreifende Übergabe.\n- Öffentliche Doku und Beispiele verwenden nur Platzhalter.\n\n## Auth- und Session-Modell\n\nDie CLI ist static-env-first und persisted-session-first.\n\nStatische Werte kommen weiterhin aus Umgebungsvariablen:\n\n- `FACILIOO_BASE_URL`\n- `FACILIOO_API_VERSION`\n- `FACILIOO_AUTH_METHOD`\n- optional: `FACILIOO_API_KEY`\n\nNach `auth login` persistiert die CLI die Live-Session lokal.\nAuf macOS bevorzugt sie die Keychain.\nFachkommandos erneuern alte Sessions automatisch vor Arbeitsbeginn und wiederholen einen Request einmal nach `401 Unauthorized`.\n`auth export` existiert nur als explizite Brücke für einen anderen Shell-Prozess.\n\nNützliche Befehle:\n\n```bash\nfacilioo-agent-cli auth status --json\nfacilioo-agent-cli auth refresh --json\nfacilioo-agent-cli auth export --write-env-file ~/.config/facilioo-agent-cli/session.env --json\nfacilioo-agent-cli auth clear --json\n```\n\n## Datenschutz und Publish-Hygiene\n\nDieses Paket wird bewusst mit einer strikten npm-Datei-Whitelist veröffentlicht.\nPrivate Planungs- und Rechercheartefakte gehören nicht zur öffentlichen Paketoberfläche.\n\nDas bedeutet:\n\n- `Plans/` ist privat\n- repo-lokale Recherche- und Knowledge-Notizen sind privat\n- `.env*` ist privat\n- Tarballs und lokale Output-Ordner bleiben privat\n\n## Referenzen\n\n- `skills/facilioo-agent-cli/SKILL.md`\n- `skills/facilioo-agent-cli/references/overview.md`\n- `skills/facilioo-agent-cli/references/agent-onboarding.md`\n- `skills/facilioo-agent-cli/references/facilioo-first-run.md`\n- `skills/facilioo-agent-cli/references/command-cheatsheet.md`\n","readmeFilename":"README.md"}