truthmark 2.2.7 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,229 +1,194 @@
1
1
  # Truthmark
2
2
 
3
- **Deine Agenten schreiben Code. Truthmark pflegt menschenorientierte, in Git überprüfbare Dokumentation.**
3
+ **Deine Agenten schreiben Code. Truthmark pflegt die menschenlesbare Dokumentation, die du direkt in Git prüfen kannst.**
4
4
 
5
- [🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
6
-
7
- ![Truthmark-Banner](../assets/truthmark-banner.png)
8
-
9
- ## 🚀 Schnellstart: lokal in fünf Minuten ausführen
10
-
11
- Führe dies in dem Git-Repository aus, das Truthmark verwalten soll:
12
-
13
- ```bash
14
- cd /path/to/your-repo
15
- npm install -g truthmark
16
- truthmark config
17
- ```
18
-
19
- Aktiviere den KI-Host, den du tatsächlich nutzt. Neue Konfigurationen sind host-neutral; füge daher vor der Initialisierung eine `platforms`-Liste auf oberster Ebene zu `.truthmark/config.yml` hinzu:
20
-
21
- ```yaml
22
- version: 2
23
- platforms:
24
- - codex # or: claude-code, github-copilot, opencode, antigravity, cursor
25
- truthmark:
26
- workspace: docs/truthmark
27
- generated:
28
- portal:
29
- enabled: false
30
- ```
31
-
32
- Installiere anschließend die repo-lokalen Truth-Dokumente, das Routing und die Anweisungen für KI-Hosts:
33
-
34
- ```bash
35
- truthmark init
36
- truthmark check
37
- git diff
38
- ```
39
-
40
- Probiere nun den häufigsten Einstiegspfad: ein bestehendes Verhalten anhand von Code und Tests dokumentieren. Bitte in deinem KI-Coding-Host den installierten Workflow:
41
-
42
- ```text
43
- /truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
44
- ```
45
-
46
- Danach sollten Nutzer Truth Sync normalerweise nicht direkt aufrufen. Programmiere weiter über deinen KI-Host; die installierten Repository-Anweisungen weisen den Agenten an, relevante Tests auszuführen und vor der Übergabe die Truth Sync-Prüfung durchzuführen, wenn funktionaler Code geändert wurde. Du prüfst den daraus entstehenden Code-Diff plus den Truth-Doc-Diff.
5
+ Truthmark installiert Git-native Workflows, mit denen KI-Coding-Agenten aus bestehendem Code und Tests neue Produkt- und Engineering-Dokumentation erstellen, sie nach jeder Codeänderung aktuell halten und dir gewöhnliche Markdown-Diffs zur Prüfung vorlegen.
47
6
 
48
- Wenn du nur CLI-Validierung möchtest und noch keine host-spezifischen KI-Workflows willst, lasse `platforms` weg und führe `truthmark init && truthmark check` aus; du kannst später eine Plattform hinzufügen und `truthmark init` erneut ausführen.
7
+ [![npm version](https://img.shields.io/npm/v/truthmark?color=cb3837&label=npm)](https://www.npmjs.com/package/truthmark)
8
+ [![CI](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/merlinhu1/truthmark/actions/workflows/ci.yml)
9
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
10
+ [![Node.js >=24](https://img.shields.io/badge/node-%3E%3D24-339933?logo=node.js&logoColor=white)](../../package.json)
49
11
 
50
- ## 💡 Das Problem: die KI-Dokumentationslücke
12
+ [Jetzt starten](#schnellstart-dein-erstes-truth-dokument-erstellen) · [Website](https://merlinhu1.github.io/truthmark/) · [Benutzerhandbuch](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md) · [GitHub](https://github.com/merlinhu1/truthmark)
51
13
 
52
- KI-Coding-Agenten sind unglaublich gut darin, schnell Code zu schreiben. Doch diese Geschwindigkeit erzeugt einen gefährlichen neuen Fehlermodus: **die Geschichte des Repositories driftet von der Realität ab.**
14
+ <details>
15
+ <summary>Dieses README in 16 Sprachen lesen</summary>
53
16
 
54
- * Verhalten geht in flüchtigen Chatverläufen verloren.
55
- * Architekturdokumente geraten schnell in Rückstand.
56
- * Produktentscheidungen verschwinden nach der Übergabe.
57
- * Code-Reviewer prüfen rohe Code-Diffs, ohne das „Warum“ zu verstehen.
58
- * Jede neue KI-Sitzung muss die Wahrheit deines Repositories von Grund auf neu entdecken.
17
+ [🇺🇸 English](../../README.md) | [🇨🇳 简体中文](README.zh.md) | [🇯🇵 日本語](README.ja.md) | [🇰🇷 한국어](README.ko.md) | [🇩🇪 Deutsch](README.de.md) | [🇫🇷 Français](README.fr.md) | [🇪🇸 Español](README.es.md) | [🇧🇷 Português](README.pt.md) | [🇷🇺 Русский](README.ru.md) | [🇸🇦 العربية](README.ar.md) | [🇮🇹 Italiano](README.it.md) | [🇵🇱 Polski](README.pl.md) | [🇹🇷 Türkçe](README.tr.md) | [🇻🇳 Tiếng Việt](README.vi.md) | [🇮🇩 Bahasa Indonesia](README.id.md) | [🇬🇷 Ελληνικά](README.el.md)
59
18
 
60
- ## 🎯 Die Lösung: Truthmark
19
+ </details>
61
20
 
62
- **Truthmark** installiert eine Git-native Workflow-Schicht in deinem Repository. Es behebt den Teil der KI-Entwicklung, der normalerweise kaputtgeht: die Dokumentation dabei zu unterstützen, mit dem Code synchron zu bleiben.
21
+ ## Erstelle die ersten Dokumente und halte sie wahr
63
22
 
64
- Statt darauf zu hoffen, dass Menschen und KI-Agenten daran denken, Dokumentation zu aktualisieren, macht Truthmark Dokumentation direkt in deinem Repo zu einer systematischen, überprüfbaren Gewohnheit.
23
+ Die meisten Dokumentationswerkzeuge enden bei der Generierung. Truthmark gibt Agenten einen vollständigen Dokumentationslebenszyklus direkt in deinem Repository:
65
24
 
66
- ### Warum Truthmark einzigartig ist
25
+ - **Neue Dokumentation aus funktionierender Software erstellen.** Truth Document liest Code und Tests und erstellt daraus klar abgegrenzte Produkt- oder Engineering-Dokumentation.
26
+ - **Dokumentation automatisch auf Kurs halten.** Truth Sync läuft nach Änderungen an funktionalem Code bei der Agentenübergabe und aktualisiert die Repository-Wahrheit, bevor die Arbeit abgeschlossen ist.
27
+ - **Dokumentation wieder in Code verwandeln.** Truth Realize setzt freigegebene Truth-Dokumente um und wahrt dabei einen sauberen Doc-first-Workflow.
28
+ - **Ownership mit dem Codebestand weiterentwickeln.** Truth Structure erstellt klar abgegrenzte Routen und Startdokumente für neue oder überlastete Bereiche.
29
+ - **Alles in Git prüfen.** Code, Entscheidungen, Verträge, Architektur, Betrieb und Verhalten reisen gemeinsam mit dem Branch.
67
30
 
68
- Truthmark ist nicht einfach nur ein weiteres Dokumentationstool. Es ist tief in den KI-Workflow integriert:
31
+ Keine gehostete Wissensdatenbank. Kein privates Agentengedächtnis. Keine Dokumentation, die in Chatverläufen gefangen bleibt.
69
32
 
70
- * **🚫 Kein Vendor-Lock-in:** keine gehosteten Dienste, keine versteckten Datenbanken, keine zusätzlichen Server im Betrieb.
71
- * **🌳 100 % Git-nativ:** alles lebt in deinem Repository. Die Wahrheit bewegt sich mit deinem Branch.
72
- * **🤝 Von Menschen besessener, von Agenten befolgter Vertrag:** Maintainer besitzen den Repository-Vertrag; Agenten folgen beim Coden den installierten Anweisungen.
73
- * **✅ Vertrauen durch Verifikation:** KI-Arbeit wird leichter vertrauenswürdig, weil verhaltensändernde Arbeit eine für Menschen überprüfbare Truth-Doc-Entscheidung oder einen Diff enthält.
33
+ ## Schnellstart: dein erstes Truth-Dokument erstellen
74
34
 
75
- ## 🔄 Wie es funktioniert
35
+ **Voraussetzungen:** Node.js 24 oder neuer, ein Git-Repository und ein unterstützter KI-Coding-Host für Agenten-Workflows.
76
36
 
77
- Wenn ein KI-Agent deinen Code verändert, ist die Arbeit nicht erledigt. Truthmark installiert eine Workflow-Schutzschiene zum Abschluss, der Agenten vor der Übergabe folgen:
37
+ Führe Folgendes in dem Repository aus, das Truthmark verwalten soll:
78
38
 
79
- 1. 💻 **Code:** Der Agent ändert funktionalen Code.
80
- 2. 🧪 **Test:** Relevante Tests werden ausgeführt.
81
- 3. 🔍 **Prüfen:** Truthmark prüft zugeordnete Dokumentation als Teil der installierten Abschlussprüfung.
82
- 4. 📝 **Dokumentation:** Docs werden vom Agenten aktualisiert, wenn sich die Repository-Wahrheit geändert hat.
83
- 5. 👀 **Review:** Ein Mensch prüft den *Code-Diff* + den *Truth-Diff*.
39
+ ```bash
40
+ cd /path/to/your-repo
41
+ npm install -g truthmark
42
+ truthmark init
43
+ ```
84
44
 
85
- ## 🛠 Wie du mit Truthmark interagierst
45
+ Mit `truthmark init` kannst du Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, Cursor oder eine host-neutrale Einrichtung der Befehlszeilenschnittstelle auswählen.
86
46
 
87
- Truthmark hat einen repo-lokalen Vertrag und zwei Arten, ihn zu nutzen.
47
+ Bitte nun deinen konfigurierten Agenten, ein echtes Verhalten zu dokumentieren:
88
48
 
89
- ### Menschen installieren und validieren den Vertrag
49
+ ```text
50
+ /truthmark-document document the implemented session timeout behavior across src/auth/session.ts and tests/auth/session.test.ts
51
+ ```
90
52
 
91
- Maintainer und CI nutzen die CLI:
53
+ Truth Document erstellt ein neues, klar abgegrenztes Truth-Dokument, wenn noch keines vorhanden ist, aktualisiert andernfalls das bestehende zuständige Dokument und passt bei Bedarf das Routing an. Funktionalen Code ändert es nicht.
92
54
 
93
- * `truthmark config` - erstellt die Anfangskonfiguration.
94
- * `truthmark init` - installiert oder aktualisiert Routing, Truth-Doc-Scaffolds und Anweisungen für KI-Hosts.
95
- * `truthmark check` - validiert die Repository-Truth im Terminal.
55
+ Prüfe das Ergebnis:
96
56
 
97
- ### Agenten folgen dem Vertrag beim Coden
57
+ ```bash
58
+ truthmark check
59
+ git status --short --untracked-files=all
60
+ git diff
61
+ ```
98
62
 
99
- Truthmark installiert repo-lokale Anweisungen für unterstützte KI-Coding-Hosts wie Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity und Cursor.
63
+ Nun solltest du Folgendes haben:
100
64
 
101
- Der normale Ablauf ist einfach:
65
+ ```text
66
+ docs/truthmark/engineering/behaviors/session-timeout.md
67
+ docs/truthmark/routes/areas/authentication.md
68
+ ```
102
69
 
103
- 1. Bitte deinen Agenten um eine Codeänderung oder darum, vorhandenes Verhalten zu dokumentieren.
104
- 2. Die installierten Anweisungen sagen dem Agenten, wann er testen, wann er Truth-Dokumente aktualisieren und wann er für menschliche Prüfung stoppen soll.
105
- 3. Du prüfst normale Git-Diffs: Code plus alle Truth-Doc-Änderungen.
70
+ Die genauen Pfade folgen der Ownership-Struktur deines Repositories. Neue Dateien erscheinen in `git status`; Änderungen an verfolgten Dateien erscheinen in `git diff`.
106
71
 
107
- Die vom Nutzer gestarteten Agentenanfragen bleiben bewusst wenige:
72
+ Der Aufruf unterscheidet sich je nach Host. OpenCode verwendet `/skill truthmark-document`, Antigravity verwendet `@truthmark-document`, und andere unterstützte Hosts nutzen ihre native Skill- oder Slash-Command-Oberfläche. Die genauen Befehle findest du in der [Plattformtabelle](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md#supported-agent-platforms).
108
73
 
109
- * `/truthmark-document` - dokumentiert vorhandenes implementiertes Verhalten aus Code und Tests.
110
- * `/truthmark-realize` - implementiert Code aus vorhandenen Truth-Dokumenten.
111
- * `/truthmark-check` - auditiert die Repository-Truth.
74
+ Übergib die ausgewählten Plattformen für Skripte und Continuous Integration ausdrücklich:
112
75
 
113
- Truth Sync ist nicht der übliche Weg, Arbeit zu starten; es ist die Abschlussprüfung nach funktionalen Codeänderungen.
114
- Truth Structure ist kein Alltagsbefehl; es repariert Routing oder Ownership nur, wenn das die Arbeit blockiert.
76
+ ```bash
77
+ truthmark init --platform codex --platform cursor
78
+ truthmark init --json
79
+ ```
115
80
 
116
- ## Was du bekommst
81
+ Wähle interaktiv `none` oder führe `truthmark init --clear-platforms` für ein host-neutrales Repository aus. Agentenplattformen kannst du später hinzufügen, indem du `truthmark init` erneut ausführst.
117
82
 
118
- | Fähigkeit | Was sie tut |
119
- | --- | --- |
120
- | Git-native Wahrheit | Hält Repository-Wahrheit in committetem Markdown und Konfiguration. |
121
- | Branch-bezogene Dokumentation | Die Wahrheit bewegt sich mit dem Branch, statt in einer privaten Sitzung zu leben. |
122
- | Menschliche CLI | Gibt Maintainern Befehle für Einrichtung, Aktualisierung, Validierung und Inspektion. |
123
- | Installierte Agentenanleitung | Sagt Coding-Agenten, wann sie dokumentieren, testen, Truth synchronisieren, auditieren oder für Review stoppen sollen. |
124
- | Explizites Routing | Ordnet Codebereiche kanonischen Truth-Dokumenten zu. |
125
- | Überprüfbare Übergaben | Erzeugt normale Git-Diffs sowohl für Code als auch für Truth-Dokumente. |
126
- | Local-first-Betrieb | Benötigt keinen gehosteten Dienst, Daemon, keine Datenbank und keinen MCP-Server. |
127
- | Sicherere Schreibgrenzen | Trennt code-first-, doc-first-, read-only- und doc-only-Workflows. |
128
- | Validierung | Meldet Probleme bei Routing, Autorität, Frontmatter, Links, generierten Oberflächen, Branch-Scope, Aktualität und Abdeckung. |
129
- | Optionales Portal | Erzeugt bei ausdrücklicher Aktivierung und Anforderung eine committete statische HTML-Präsentationssite aus Markdown-Truth-Dokumenten. |
83
+ Übergib für Branch-relative Aktualitätsdiagnosen eine Git-Basis:
130
84
 
131
- ## Visueller Überblick
85
+ ```bash
86
+ truthmark check --base <base-ref>
87
+ ```
132
88
 
133
- ![Truthmark-Funktionen](../assets/truthmark-features.png)
89
+ ## So funktioniert Truthmark
134
90
 
135
- **Funktionen:** was Truthmark installiert und wie Agenten repo-lokale Anweisungen nutzen.
91
+ <picture>
92
+ <source media="(max-width: 700px)" srcset="../assets/truthmark-workflow-mobile.svg">
93
+ <img src="../assets/truthmark-workflow.svg" alt="So funktioniert Truthmark" width="1440">
94
+ </picture>
136
95
 
137
- ![Truthmark-Position](../assets/truthmark-position.png)
96
+ Die Truthmark-Befehlszeilenschnittstelle installiert und validiert den Repository-Vertrag. Dein Coding-Agent prüft die Evidenz und erledigt die Dokumentationsarbeit über die installierten host-nativen Workflows.
138
97
 
139
- **Position:** wo Truthmark im Verhältnis zu Prompts, Memory und Spec-Workflows steht.
98
+ Eine normale Codeänderung folgt einer einfachen Schleife:
140
99
 
141
- ![Truthmark-Sync-Ablauf](../assets/truthmark-syncflow.png)
100
+ 1. Der Agent ändert funktionalen Code.
101
+ 2. Relevante Tests werden ausgeführt.
102
+ 3. Truth Sync prüft die zugeordnete Dokumentation.
103
+ 4. Wenn sich die Repository-Wahrheit geändert hat, erstellt oder aktualisiert der Agent Dokumentation und Routing.
104
+ 5. Du prüfst Code-Diff und Truth-Diff gemeinsam.
142
105
 
143
- **Sync-Ablauf:** wie Truth Sync normale Codeänderungen vor der Übergabe abschließt.
106
+ ## Workflows
144
107
 
145
- ## Warum Teams es einsetzen
108
+ | Workflow | Einsatzzeitpunkt | Ergebnis |
109
+ | -------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
110
+ | **Truth Document** | Bestehender Code benötigt Dokumentation | Erstellt oder aktualisiert evidenzgestützte Produkt- und Engineering-Dokumentation |
111
+ | **Truth Sync** | Funktionaler Code wurde geändert | Hält zugeordnete Dokumentation und Routing vor der Übergabe synchron |
112
+ | **Truth Structure** | Ein neuer Bereich benötigt Ownership oder vorhandene Dokumentation ist zu breit | Erstellt klar abgegrenzte Routen und skelettartige Startdokumente |
113
+ | **Truth Realize** | Ein freigegebenes Truth-Dokument soll funktionierende Software werden | Aktualisiert funktionalen Code anhand der Dokumentation |
114
+ | **Truth Check** | Die Repository-Wahrheit muss auditiert werden | Meldet Probleme mit Routing, Ownership, Evidenz und Dokumentation |
115
+ | **Truthmark Portal** | Das Team wünscht eine durchsuchbare Dokumentationswebsite | Erzeugt aus Markdown-Truth-Dokumenten eine committete statische HTML-Präsentation |
146
116
 
147
- Truthmark ist für Teams, die bereits wissen, dass KI-Agenten Code erzeugen können.
117
+ Truthmark installiert diese Workflows als native Repository-Oberflächen für Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity und Cursor.
148
118
 
149
- Das nächste Problem ist Governance.
119
+ ## Das erhältst du
150
120
 
151
- Nicht Governance als Zeremonie. Governance als einfache Frage:
121
+ ### Dokumentation, die von der Realität ausgeht
152
122
 
153
- > Sagt das Repository nach dieser KI-gestützten Änderung noch die Wahrheit?
123
+ Truthmark kann Produktfunktionen, Implementierungsverhalten, Programmierschnittstellen, Architektur, Workflows, Betrieb und Tests dokumentieren. Code und Tests liefern die Evidenz; klar abgegrenzte Markdown-Dokumente bewahren das Ergebnis.
154
124
 
155
- Truthmark hilft Teams, diese Frage mit committeten Dateien, explizitem Routing und überprüfbaren Diffs zu beantworten.
125
+ ### Dokumentation, die die nächste Änderung übersteht
156
126
 
157
- Es ist nützlich, wenn du Folgendes brauchst:
127
+ Routen verbinden Codebereiche mit kanonischer Dokumentation. Wenn Agenten Verhalten ändern, weiß Truth Sync, wohin die zugehörige Wahrheit gehört, und hält die Übergabe überprüfbar.
158
128
 
159
- - weniger Dokumentationsdrift
160
- - bessere Übergaben
161
- - branch-spezifische Produktwahrheit
162
- - dauerhafte Architektur- und API-Dokumentation
163
- - explizite Ownership zwischen Docs und Code
164
- - sicherere Schreibgrenzen für Agenten
165
- - überprüfbare Dokumentation statt versteckter Memory
166
- - Agentenanleitung, die weiterhin aus committeten Repo-Dateien funktioniert
129
+ ### Produkt- und Engineering-Wahrheit in getrennten Bahnen
167
130
 
168
- ## Wo Truthmark hineinpasst
131
+ Produktwahrheit erfasst nutzerorientierte Versprechen, Grenzen, Entscheidungen und Akzeptanzkriterien. Engineering-Wahrheit erfasst aktuelles Verhalten, Verträge, Architektur, Workflows, Betrieb und Testverhalten.
169
132
 
170
- Truthmark ersetzt keine Prompts, Memory, Specs, Tests oder Code-Reviews.
133
+ ### Git-native Zusammenarbeit
171
134
 
172
- Es gibt diesen Workflows einen dauerhaften Ort in Git.
135
+ Alles Wichtige lebt in committeten Repository-Dateien. Die Wahrheit folgt dem Branch, funktioniert mit gewöhnlichen Pull Requests und bleibt für alle Maintainer und Coding-Agenten sichtbar.
173
136
 
174
- | Bedarf | Besser geeignet |
175
- | --- | --- |
176
- | Bessere Ausgabe aus einer Agentensitzung | Besserer Prompt |
177
- | Persönliche oder sitzungsbezogene Kontinuität | Memory-Tool |
178
- | Plan-first-Feature-Arbeit | Spec-Workflow |
179
- | Branch-bezogene Wahrheit, die mit Code reist | Truthmark |
180
- | Verhaltenskorrektheit validieren | Tests und Review |
181
- | KI-gestützte Dokumentationsänderungen prüfen | Truthmark plus Git-Review |
137
+ ### Local-first-Betrieb
182
138
 
183
- Truthmarks Spur ist bewusst schmal:
139
+ Truthmark benötigt keinen gehosteten Dienst, Daemon, keine Datenbank, keinen Vektorspeicher und keinen Model Context Protocol Server. Das Repository bringt seinen eigenen Dokumentations-Workflow mit.
184
140
 
185
- ```text
186
- make repository truth explicit
187
- route it to code
188
- Agentenanleitung darum installieren
189
- keep the result reviewable in Git
190
- ```
141
+ ## Wo Truthmark passt
191
142
 
192
- ## Tiefer einsteigen
143
+ | Bedarf | Beste Lösung |
144
+ | ----------------------------------------------------- | -------------------------- |
145
+ | Bessere Ergebnisse aus einer einzelnen Agentensitzung | Besserer Prompt |
146
+ | Persönliche oder sitzungsbezogene Kontinuität | Memory-Tool |
147
+ | Plan-first-Feature-Arbeit | Spezifikations-Workflow |
148
+ | Branch-bezogene Dokumentation, die mit dem Code reist | **Truthmark** |
149
+ | Korrektes Verhalten | Tests und Code-Review |
150
+ | Überprüfbare KI-gestützte Dokumentation | **Truthmark + Git-Review** |
193
151
 
194
- Das README ist das Schaufenster: schneller Kontext, Schnellstart und das zentrale Denkmodell.
152
+ Truthmark ist für Maintainer und Engineering-Teams konzipiert, die bereits KI-Coding-Agenten einsetzen und möchten, dass ihr Repository so schnell die Wahrheit weiterschreibt, wie sich der Code ändert.
195
153
 
196
- Für befehlsweise Nutzung, Oberflächenvergleiche, Details zu unterstützten Plattformen, Konfiguration, Routing, Portal und Beispiele lies den [Truthmark-Benutzerleitfaden](../user-guide.md).
154
+ ## Unterstützte Hosts und Befehlszeile
197
155
 
198
- ## Projektstatus
156
+ Unterstützte Agenten-Hosts:
199
157
 
200
- Die aktuelle Version bietet:
158
+ - Codex
159
+ - Claude Code
160
+ - GitHub Copilot
161
+ - OpenCode
162
+ - Antigravity
163
+ - Cursor
201
164
 
202
- - lokale CLI-Befehle für config, init, check, index, impact und Workflow-Status
203
- - generierte repo-lokale Agentenanweisungen für Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity und Cursor
204
- - Diagnosen für Routing, Autorität, Frontmatter, Links, Aktualität, generierte Oberflächen, Branch-Scope und Abdeckung
205
- - branch-bezogene Truth-Dokumente und abgeleitete Repository-Intelligence-Artefakte
165
+ <details>
166
+ <summary>Befehlszeilenreferenz</summary>
206
167
 
207
- ## Dokumentation
168
+ | Befehl | Zweck |
169
+ | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
170
+ | `truthmark init` | Konfiguration, Routing, Vorlagen und ausgewählte Host-Workflows erstellen oder aktualisieren |
171
+ | `truthmark check [--base <ref>]` | Repository-Wahrheit validieren und optional Branch-Aktualitätsdiagnosen ausführen |
172
+ | `truthmark index --json` | Abgeleitete Repository- und Routing-Metadaten prüfen |
173
+ | `truthmark impact --base <ref> --json` | Geänderte Dateien Dokumentation, Verantwortlichen und nahen Tests zuordnen |
174
+ | `truthmark workflow status --workflow <id> [--base <ref>] --json` | Anwendbarkeit und Ziele eines Workflows prüfen |
175
+ | `truthmark validate ...` | Workflow-Berichte und Schreib-Leases validieren |
176
+ | `truthmark uninstall --dry-run` / `truthmark uninstall --apply` | Generierte Host-Oberflächen anzeigen oder entfernen und verfasste Wahrheit bewahren |
208
177
 
209
- - [Benutzerleitfaden](../user-guide.md)
210
- - [Docs-Index](../README.md)
211
- - [Architekturüberblick](../truthmark/engineering/architecture/overview.md)
212
- - [API- und CLI-Verträge](../truthmark/engineering/contracts/config-route-and-check-contracts.md)
213
- - [Leitfaden zur Pflege der Repository-Wahrheit](../standards/maintaining-repository-truth.md)
178
+ Strukturierte JSON-Ausgabe ist in der gesamten Befehlszeilenschnittstelle für Skripte und Continuous Integration verfügbar.
214
179
 
215
- Für lokale Entwicklungs- und Beitragsbefehle siehe [CONTRIBUTING.md](../../CONTRIBUTING.md).
180
+ </details>
216
181
 
217
- ## Designgrenzen
182
+ ## Mehr erfahren
218
183
 
219
- Truthmark ist bewusst klein: lokal, committet, branch-bezogen und überprüfbar.
184
+ - [Truthmark-Benutzerhandbuch](https://github.com/merlinhu1/truthmark/blob/main/docs/user-guide.md)
185
+ - [Dokumentationsindex](https://github.com/merlinhu1/truthmark/blob/main/docs/README.md)
186
+ - [Architekturüberblick](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/architecture/overview.md)
187
+ - [Konfigurations-, Routing- und Befehlsverträge](https://github.com/merlinhu1/truthmark/blob/main/docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
188
+ - [Mitwirken](https://github.com/merlinhu1/truthmark/blob/main/CONTRIBUTING.md)
220
189
 
221
- Es ist kein gehosteter Dienst, MCP-Server, keine Vektordatenbank, versteckte Memory-Schicht, kein CI-Enforcement-Produkt und keine autonome Code-Rewrite-Engine. Es hilft, Repository-Wahrheit sichtbar zu halten; es ersetzt keine Tests, Code-Reviews oder menschliches Urteil.
190
+ **Installiere Truthmark, wähle deinen Coding-Host und verwandle noch heute ein echtes Verhalten in Dokumentation.**
222
191
 
223
192
  ## Lizenz
224
193
 
225
194
  MIT. Siehe [LICENSE](../../LICENSE).
226
-
227
- ## Sichere Entfernung
228
-
229
- Verwenden Sie `truthmark uninstall --dry-run`, um die exakt erzeugten Host-Surfaces zu prüfen, und anschließend `truthmark uninstall --apply`, um sie zu entfernen. Erstellte truth, Konfiguration, Templates, Portal-Ausgabe, Gemini-Dateien und nicht zusammenhängende Benutzerdateien bleiben erhalten; entfernen Sie eine globale npm-Installation separat mit Ihrem Paketmanager.