truthmark 2.2.7 → 2.3.0

package/docs/README.md

@@ -1,7 +1,7 @@
 ---
 status: active
 doc_type: index
-last_reviewed: 2026-06-20
+last_reviewed: 2026-07-30
 source_of_truth:
   - docs/ai/repo-rules.md
   - ../.truthmark/config.yml
@@ -35,7 +35,7 @@ Repository-wide conflict order and completion policy live in [docs/ai/repo-rules
 - `docs/truthmark/product/` for product capability promises, boundaries, and acceptance criteria
 - `docs/truthmark/engineering/` for current implementation behavior, architecture, contracts, workflows, and operations
 - `docs/architecture/` for repository-specific architecture guardrails
-- `docs/research/` for non-canonical research and planning notes
+- `docs/research/` for non-canonical research evidence, evaluations, and comparisons
 - `docs/truthmark/templates/` for editable scaffold templates used to create new docs
 - `docs/truthmark/engineering/contracts/` for stable contracts the CLI exposes
 
@@ -54,7 +54,7 @@ Repository-wide conflict order and completion policy live in [docs/ai/repo-rules
 | `docs/truthmark/product/`     | product truth     | agent            | Product capability promises, boundaries, decisions, and acceptance criteria           |
 | `docs/truthmark/engineering/` | engineering truth | agent            | Current implementation behavior for init, check, contracts, workflows, and operations |
 | `docs/architecture/`          | architecture      | agent            | Repository-specific architecture guardrails                                           |
-| `docs/research/`              | research          | human            | Non-canonical research, comparison, and planning notes                                |
+| `docs/research/`              | research          | human            | Non-canonical research evidence, evaluations, and comparisons                           |
 | `docs/truthmark/templates/`   | template          | both             | Editable templates for scaffolded docs; templates are not Truth Sync targets          |
 | `docs/user-guide.md`          | guide             | human            | Detailed usage guide kept out of the root README so onboarding stays concise          |
 
@@ -76,13 +76,13 @@ Canonical docs should include frontmatter and keep these fields current:
 - When `truthmark init` or scaffolded files change, update the relevant truth or architecture doc, not only [README.md](../README.md).
 - When `truthmark check` changes what it validates or how it reports diagnostics, update both the current truth doc and the contract doc.
 - When major product, onboarding, install, command, positioning, or workflow behavior changes, review the root [README.md](../README.md) and update it if the human entry point would otherwise be stale.
-- Keep planning or proposal material outside the canonical current-state docs until it becomes implemented truth.
-- When current behavior changes for architecture, contracts, or lane-separated truth docs, update the owning canonical doc's `Product Decisions` and `Rationale` sections in the same change.
+- Keep active docs current-state focused; promote necessary accepted rationale into the owning decision section and rely on Git history for superseded plans.
+- When current behavior changes for architecture, contracts, or lane-separated truth docs, update the owning current-behavior and Product Decisions or Engineering Decisions sections in the same change.
 - Do not keep parallel documentation trees for the same subject.
 
 ## Important Truthmark-Specific Caveat
 
-New repositories should run `truthmark config` before `truthmark init` so teams can review the committed hierarchy contract before workflow surfaces are installed. The current scaffold writes a root route index plus one child route file under the configured routing root.
+`truthmark init` is the only setup command. In a TTY it offers a numbered zero-or-more platform selection; repeatable `--platform <id>` values provide noninteractive selection, while `--json` never prompts. A first noninteractive run without platform flags remains host-neutral. Init creates or updates the version-2 `.truthmark/config.yml`, then writes a root route index plus one child route file under the configured routing root.
 
 ## Recommended Reading Order
 
@@ -107,7 +107,7 @@ Use the route files under [docs/truthmark/routes/](truthmark/routes/) when desig
 
 ## Maintenance Principle
 
-The canonical tree should stay small, explicit, and current. Historical notes are useful for traceability, but current behavior belongs in the nearest maintained document class, not in old plans or chat summaries.
+The canonical tree should stay small, explicit, and current. Git history provides traceability for superseded context; active docs keep current behavior in the owning current-state section and accepted rationale in the owning decision section.
 
 ## Product Decisions
 

package/docs/readmes/README.ar.md

@@ -13,30 +13,22 @@
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-فعّل مضيف الذكاء الاصطناعي الذي تستخدمه فعلياً. تكون الإعدادات الجديدة محايدة تجاه المضيف، لذلك أضف قائمة `platforms` في المستوى الأعلى إلى `.truthmark/config.yml` قبل التهيئة:
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+في الطرفية التفاعلية يعرض `truthmark init` قائمة اختيار متعددة مرقمة. اختر صفراً أو أكثر من المنصات، أو أدخل `none` لإعداد محايد تجاه المضيف ويقتصر على CLI.
 
-ثم ثبّت توثيق الحقيقة المحلي للمستودع، والتوجيه، وأسطح سير عمل الوكلاء:
+في السكربتات وCI كرّر `--platform`؛ ولا يعرض `--json` أي مطالبة تفاعلية أبداً:
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+في أول تشغيل غير تفاعلي من دون `--platform` يبقى الإعداد محايداً تجاه المضيف؛ وتحافظ التشغيلات اللاحقة على الاختيار المحفوظ في `.truthmark/config.yml`.
+
 جرّب الآن مسار الاعتماد الأكثر شيوعاً: توثيق سلوك موجود من الكود والاختبارات. في مضيف البرمجة بالذكاء الاصطناعي، اطلب من سير العمل المثبّت:
 
 ```text
@@ -45,7 +37,7 @@ git diff
 
 بعد ذلك، لا ينبغي للمستخدمين عادةً استدعاء Truth Sync مباشرة. واصل البرمجة عبر مضيف الذكاء الاصطناعي؛ فتعليمات المستودع المثبّتة تطلب من الوكيل تشغيل الاختبارات ذات الصلة وتنفيذ مراجعة Truth Sync قبل التسليم عندما تتغير الشيفرة الوظيفية. أنت تراجع فرق الكود الناتج مع فرق توثيق الحقيقة.
 
-إذا كنت تريد فقط التحقق عبر CLI ولا تريد بعدُ مسارات عمل ذكاء اصطناعي خاصة بمضيف، فاترك `platforms` محذوفة وشغّل `truthmark init && truthmark check`؛ يمكنك إضافة منصة لاحقاً وإعادة تشغيل `truthmark init`.
+إذا كنت تريد التحقق عبر CLI فقط، فاختر `none` ثم شغّل `truthmark check`؛ ويمكنك إعادة تشغيل `truthmark init` لاحقاً لاختيار المنصات.
 
 ## 💡 المشكلة: فجوة توثيق الذكاء الاصطناعي
 
@@ -90,8 +82,7 @@ Truthmark ليس مجرد أداة توثيق أخرى. إنه مدمج بعمق
 
 يستخدم الصائنون وCI واجهة CLI:
 
-* `truthmark config` - إنشاء الإعدادات الأولية.
-* `truthmark init` - تثبيت أو تحديث التوجيه، وقوالب وثائق الحقيقة، وتعليمات مضيف الذكاء الاصطناعي.
+* `truthmark init` - إنشاء الإعدادات أو تحديثها، واختيار صفر أو أكثر من المنصات، وتثبيت التوجيه وقوالب وثائق الحقيقة وتعليمات المضيفات المختارة.
 * `truthmark check` - التحقق من حقيقة المستودع من الطرفية.
 
 ### الوكلاء يتبعون العقد أثناء البرمجة
@@ -199,7 +190,7 @@ README هو الواجهة: سياق سريع، وبدء سريع، والنمو
 
 يوفر الإصدار الحالي:
 
-- أوامر CLI محلية للإعداد والتهيئة والتحقق والفهرسة وتحليل الأثر وحالة سير العمل
+- أوامر CLI محلية للتهيئة والتحقق والفهرسة وتحليل الأثر وحالة سير العمل
 - تعليمات وكلاء محلية مولّدة لـ Codex وClaude Code وGitHub Copilot وOpenCode وAntigravity وCursor
 - تشخيصات للتوجيه والسلطة وfrontmatter والروابط والحداثة والأسطح المولّدة ونطاق الفرع والتغطية
 - وثائق حقيقة مرتبطة بالفرع وعناصر مستمدة لاستخبارات المستودع

package/docs/readmes/README.de.md

@@ -13,30 +13,22 @@ Führe dies in dem Git-Repository aus, das Truthmark verwalten soll:
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-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:
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+In einem interaktiven Terminal zeigt `truthmark init` eine nummerierte Mehrfachauswahl. Wähle null oder mehr Plattformen oder `none` für eine host-neutrale, reine CLI-Einrichtung.
 
-Installiere anschließend die repo-lokalen Truth-Dokumente, das Routing und die Anweisungen für KI-Hosts:
+Für Skripte und CI kannst du `--platform` wiederholen; `--json` fragt niemals interaktiv nach:
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+Beim ersten nicht interaktiven Lauf ohne `--platform` bleibt die Einrichtung host-neutral; spätere Läufe behalten die in `.truthmark/config.yml` gespeicherte Auswahl bei.
+
 Probiere nun den häufigsten Einstiegspfad: ein bestehendes Verhalten anhand von Code und Tests dokumentieren. Bitte in deinem KI-Coding-Host den installierten Workflow:
 
 ```text
@@ -45,7 +37,7 @@ Probiere nun den häufigsten Einstiegspfad: ein bestehendes Verhalten anhand von
 
 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.
 
-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.
+Wenn du nur CLI-Validierung möchtest, wähle `none` und fahre mit `truthmark check` fort; du kannst `truthmark init` später erneut ausführen und Plattformen auswählen.
 
 ## 💡 Das Problem: die KI-Dokumentationslücke
 
@@ -90,8 +82,7 @@ Truthmark hat einen repo-lokalen Vertrag und zwei Arten, ihn zu nutzen.
 
 Maintainer und CI nutzen die CLI:
 
-* `truthmark config` - erstellt die Anfangskonfiguration.
-* `truthmark init` - installiert oder aktualisiert Routing, Truth-Doc-Scaffolds und Anweisungen für KI-Hosts.
+* `truthmark init` - erstellt oder aktualisiert die Konfiguration, lässt null oder mehr Plattformen auswählen und installiert Routing, Truth-Doc-Scaffolds und die ausgewählten KI-Host-Anweisungen.
 * `truthmark check` - validiert die Repository-Truth im Terminal.
 
 ### Agenten folgen dem Vertrag beim Coden
@@ -199,7 +190,7 @@ Für befehlsweise Nutzung, Oberflächenvergleiche, Details zu unterstützten Pla
 
 Die aktuelle Version bietet:
 
-- lokale CLI-Befehle für config, init, check, index, impact und Workflow-Status
+- lokale CLI-Befehle für init, check, index, impact und Workflow-Status
 - generierte repo-lokale Agentenanweisungen für Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity und Cursor
 - Diagnosen für Routing, Autorität, Frontmatter, Links, Aktualität, generierte Oberflächen, Branch-Scope und Abdeckung
 - branch-bezogene Truth-Dokumente und abgeleitete Repository-Intelligence-Artefakte

package/docs/readmes/README.el.md

@@ -13,30 +13,22 @@
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-Ενεργοποιήστε τον AI host που πραγματικά χρησιμοποιείτε. Οι νέες ρυθμίσεις είναι ουδέτερες ως προς τον host, οπότε προσθέστε μια λίστα `platforms` στο ανώτερο επίπεδο του `.truthmark/config.yml` πριν από την αρχικοποίηση:
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+Σε διαδραστικό τερματικό, το `truthmark init` εμφανίζει αριθμημένη πολλαπλή επιλογή. Επιλέξτε μηδέν ή περισσότερες πλατφόρμες ή εισαγάγετε `none` για ρύθμιση ουδέτερη ως προς τον host και μόνο με CLI.
 
-Έπειτα εγκαταστήστε τοπικά τα έγγραφα αλήθειας του αποθετηρίου, τη δρομολόγηση και τις επιφάνειες ροής εργασίας πρακτόρων:
+Για scripts και CI, επαναλάβετε το `--platform`· το `--json` δεν εμφανίζει ποτέ προτροπή:
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+Στην πρώτη μη διαδραστική εκτέλεση χωρίς `--platform`, η ρύθμιση παραμένει ουδέτερη· οι επόμενες εκτελέσεις διατηρούν την επιλογή που έχει αποθηκευτεί στο `.truthmark/config.yml`.
+
 Τώρα δοκιμάστε την πιο συνηθισμένη διαδρομή υιοθέτησης: τεκμηριώστε μια υπάρχουσα συμπεριφορά από κώδικα και tests. Στον AI coding host σας, ζητήστε από την εγκατεστημένη ροή εργασίας:
 
 ```text
@@ -45,7 +37,7 @@ git diff
 
 Μετά από αυτό, οι χρήστες συνήθως δεν πρέπει να καλούν απευθείας το Truth Sync. Συνεχίστε να γράφετε κώδικα μέσω του AI host σας· οι εγκατεστημένες οδηγίες του αποθετηρίου λένε στον πράκτορα να εκτελεί τα σχετικά tests και να πραγματοποιεί την ανασκόπηση Truth Sync πριν από την παράδοση όταν αλλάζει λειτουργικός κώδικας. Εσείς ανασκοπείτε το προκύπτον code diff μαζί με το truth-doc diff.
 
-Αν θέλετε μόνο επικύρωση CLI και δεν θέλετε ακόμη host-specific AI workflows, αφήστε το `platforms` εκτός και εκτελέστε `truthmark init && truthmark check`· μπορείτε να προσθέσετε πλατφόρμα αργότερα και να εκτελέσετε ξανά `truthmark init`.
+Αν θέλετε μόνο επικύρωση CLI, επιλέξτε `none` και εκτελέστε `truthmark check`· μπορείτε αργότερα να εκτελέσετε ξανά `truthmark init` για να επιλέξετε πλατφόρμες.
 
 ## 💡 Το πρόβλημα: το κενό τεκμηρίωσης της AI
 
@@ -90,8 +82,7 @@ git diff
 
 Οι συντηρητές και το CI χρησιμοποιούν το CLI:
 
-* `truthmark config` - δημιουργεί την αρχική διαμόρφωση.
-* `truthmark init` - εγκαθιστά ή ανανεώνει routing, truth-doc scaffolds και οδηγίες για AI hosts.
+* `truthmark init` - δημιουργεί ή ανανεώνει τη διαμόρφωση, επιτρέπει επιλογή μηδέν ή περισσότερων πλατφορμών και εγκαθιστά routing, truth-doc scaffolds και οδηγίες για τους επιλεγμένους AI hosts.
 * `truthmark check` - επικυρώνει την αλήθεια του αποθετηρίου από το τερματικό.
 
 ### Οι agents ακολουθούν το συμβόλαιο ενώ γράφουν κώδικα
@@ -199,7 +190,7 @@ keep the result reviewable in Git
 
 Η τρέχουσα έκδοση παρέχει:
 
-- τοπικές CLI commands για config, init, check, index, impact και workflow status
+- τοπικές CLI commands για init, check, index, impact και workflow status
 - παραγόμενες repo-local οδηγίες για agents για Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity και Cursor
 - diagnostics για route, authority, frontmatter, link, freshness, generated-surface, branch-scope και coverage
 - έγγραφα αλήθειας με scope branch και παράγωγα τεχνουργήματα ευφυΐας αποθετηρίου

package/docs/readmes/README.es.md

@@ -13,30 +13,22 @@ Ejecuta esto dentro del repositorio Git que quieres que Truthmark gestione:
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-Activa el host de IA que realmente usas. Las configuraciones nuevas son neutrales respecto al host, así que añade una lista `platforms` de nivel superior a `.truthmark/config.yml` antes de la inicialización:
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+En una terminal interactiva, `truthmark init` muestra una selección múltiple numerada. Elige cero o más plataformas, o `none` para una configuración neutral respecto al host y solo de CLI.
 
-Después instala los documentos de verdad locales del repositorio, el enrutamiento y las instrucciones para hosts de IA:
+Para scripts y CI, repite `--platform`; `--json` nunca solicita entrada interactiva:
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+En la primera ejecución no interactiva sin `--platform`, la configuración permanece neutral; las ejecuciones posteriores conservan la selección guardada en `.truthmark/config.yml`.
+
 Ahora prueba la ruta de adopción más común: documentar un comportamiento existente a partir del código y las pruebas. En tu host de codificación con IA, pídele al workflow instalado:
 
 ```text
@@ -45,7 +37,7 @@ Ahora prueba la ruta de adopción más común: documentar un comportamiento exis
 
 Después de eso, normalmente los usuarios no deberían invocar Truth Sync directamente. Sigue programando mediante tu host de IA; las instrucciones instaladas en el repositorio le dicen al agente que ejecute las pruebas pertinentes y realice la revisión de Truth Sync antes de la entrega cuando haya cambios de código funcional. Tú revisas el diff de código resultante junto con el diff de los documentos de verdad.
 
-Si solo quieres validación por CLI y todavía no quieres workflows de IA específicos de un host, deja `platforms` omitido y ejecuta `truthmark init && truthmark check`; puedes añadir una plataforma más tarde y volver a ejecutar `truthmark init`.
+Si solo quieres validación por CLI, elige `none` y continúa con `truthmark check`; más tarde puedes volver a ejecutar `truthmark init` para seleccionar plataformas.
 
 ## 💡 El problema: la brecha de documentación de la IA
 
@@ -90,8 +82,7 @@ Truthmark tiene un contrato local del repositorio y dos formas de usarlo.
 
 Los mantenedores y CI usan la CLI:
 
-* `truthmark config` - crea la configuración inicial.
-* `truthmark init` - instala o actualiza el enrutamiento, los andamios de documentos de verdad y las instrucciones para hosts de IA.
+* `truthmark init` - crea o actualiza la configuración, permite elegir cero o más plataformas e instala el enrutamiento, los andamios de documentos de verdad y las instrucciones de los hosts elegidos.
 * `truthmark check` - valida la verdad del repositorio desde la terminal.
 
 ### Los agentes siguen el contrato mientras programan
@@ -199,7 +190,7 @@ Para uso comando por comando, comparaciones de superficies, detalles de platafor
 
 La versión actual proporciona:
 
-- comandos CLI locales para config, init, check, index, impact y estado de workflows
+- comandos CLI locales para init, check, index, impact y estado de workflows
 - instrucciones de agente locales del repositorio generadas para Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity y Cursor
 - diagnósticos de enrutamiento, autoridad, frontmatter, enlaces, frescura, superficies generadas, alcance de rama y cobertura
 - documentos de verdad con alcance de rama y artefactos derivados de inteligencia del repositorio

package/docs/readmes/README.fr.md

@@ -13,30 +13,22 @@ Exécutez ceci dans le dépôt Git que vous voulez faire gérer par Truthmark :
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-Activez l’hôte d’IA que vous utilisez réellement. Les nouvelles configurations sont neutres vis-à-vis des hôtes ; ajoutez donc une liste `platforms` de premier niveau à `.truthmark/config.yml` avant l’initialisation :
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+Dans un terminal interactif, `truthmark init` affiche une sélection multiple numérotée. Choisissez zéro ou plusieurs plateformes, ou `none` pour une installation neutre vis-à-vis des hôtes et limitée à la CLI.
 
-Installez ensuite les documents de vérité locaux au dépôt, le routage et les surfaces de workflow pour agents :
+Pour les scripts et la CI, répétez `--platform` ; `--json` ne déclenche jamais d’invite :
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+Lors d’une première exécution non interactive sans `--platform`, l’installation reste neutre ; les exécutions suivantes conservent la sélection enregistrée dans `.truthmark/config.yml`.
+
 Essayez maintenant le chemin d’adoption le plus courant : documenter, à partir du code et des tests, un comportement existant. Dans votre hôte de codage IA, demandez au workflow installé :
 
 ```text
@@ -45,7 +37,7 @@ Essayez maintenant le chemin d’adoption le plus courant : documenter, à parti
 
 Après cela, les utilisateurs ne devraient normalement pas invoquer Truth Sync directement. Continuez à coder dans votre hôte d’IA ; les instructions installées dans le dépôt indiquent à l’agent d’exécuter les tests pertinents et d’effectuer la revue Truth Sync avant la remise lorsqu’il y a des changements de code fonctionnel. Vous examinez le diff de code obtenu ainsi que le diff des documents de vérité.
 
-Si vous voulez seulement la validation CLI et ne voulez pas encore de workflows IA propres à un hôte, laissez `platforms` omis et exécutez `truthmark init && truthmark check` ; vous pourrez ajouter une plateforme plus tard et relancer `truthmark init`.
+Si vous voulez seulement la validation CLI, choisissez `none` puis exécutez `truthmark check` ; vous pourrez relancer `truthmark init` plus tard pour sélectionner des plateformes.
 
 ## 💡 Le problème : l’écart de documentation avec l’IA
 
@@ -90,8 +82,7 @@ Truthmark fournit un contrat local au dépôt, avec deux façons de l’utiliser
 
 Les mainteneurs et la CI utilisent la CLI :
 
-* `truthmark config` - crée la configuration initiale.
-* `truthmark init` - installe ou actualise le routage, les échafaudages de documents de vérité et les instructions pour les hôtes IA.
+* `truthmark init` - crée ou actualise la configuration, permet de choisir zéro ou plusieurs plateformes et installe le routage, les échafaudages de documents de vérité et les instructions des hôtes sélectionnés.
 * `truthmark check` - valide la vérité du dépôt depuis le terminal.
 
 ### Les agents suivent le contrat pendant qu’ils codent
@@ -199,7 +190,7 @@ Pour l’utilisation commande par commande, les comparaisons de surfaces, les d
 
 La version actuelle fournit :
 
-- des commandes CLI locales pour config, init, check, index, impact et l’état des workflows
+- des commandes CLI locales pour init, check, index, impact et l’état des workflows
 - instructions agent locales au dépôt générées pour Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity et Cursor
 - des diagnostics de routage, d’autorité, de frontmatter, de liens, de fraîcheur, de surfaces générées, de portée de branche et de couverture
 - des documents de vérité limités à la branche et des artefacts dérivés d’intelligence du dépôt

package/docs/readmes/README.id.md

@@ -13,30 +13,22 @@ Jalankan ini di dalam repositori Git yang ingin Anda kelola dengan Truthmark:
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-Aktifkan host AI yang benar-benar Anda gunakan. Konfigurasi baru bersifat netral terhadap host, jadi tambahkan daftar `platforms` tingkat atas ke `.truthmark/config.yml` sebelum inisialisasi:
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+Di terminal interaktif, `truthmark init` menampilkan pilihan ganda bernomor. Pilih nol atau lebih platform, atau masukkan `none` untuk penyiapan netral terhadap host yang hanya memakai CLI.
 
-Kemudian pasang dokumen kebenaran lokal repositori, perutean, dan permukaan alur kerja agen:
+Untuk skrip dan CI, ulangi `--platform`; `--json` tidak pernah menampilkan prompt:
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+Pada proses noninteraktif pertama tanpa `--platform`, penyiapan tetap netral terhadap host; proses berikutnya mempertahankan pilihan yang tersimpan di `.truthmark/config.yml`.
+
 Sekarang coba jalur adopsi yang paling umum: dokumentasikan satu perilaku yang sudah ada dari kode dan pengujian. Di host pengodean AI Anda, minta alur kerja yang terpasang:
 
 ```text
@@ -45,7 +37,7 @@ Sekarang coba jalur adopsi yang paling umum: dokumentasikan satu perilaku yang s
 
 Setelah itu, pengguna biasanya tidak perlu memanggil Truth Sync secara langsung. Teruslah membuat kode melalui host AI Anda; instruksi repositori yang terpasang memberi tahu agen untuk menjalankan pengujian yang relevan dan melakukan tinjauan Truth Sync sebelum serah terima ketika kode fungsional berubah. Anda meninjau diff kode yang dihasilkan beserta diff dokumen truth.
 
-Jika Anda hanya menginginkan validasi CLI dan belum menginginkan alur kerja AI khusus host, biarkan `platforms` tidak dicantumkan dan jalankan `truthmark init && truthmark check`; Anda dapat menambahkan platform nanti dan menjalankan ulang `truthmark init`.
+Jika Anda hanya menginginkan validasi CLI, pilih `none` lalu jalankan `truthmark check`; Anda dapat menjalankan ulang `truthmark init` nanti untuk memilih platform.
 
 ## 💡 Masalah: kesenjangan dokumentasi AI
 
@@ -90,8 +82,7 @@ Truthmark memiliki satu kontrak lokal repositori dengan dua cara pemakaian.
 
 Pemelihara dan CI menggunakan CLI:
 
-* `truthmark config` - membuat konfigurasi awal.
-* `truthmark init` - memasang atau menyegarkan perutean, scaffold dokumen kebenaran, dan instruksi host AI.
+* `truthmark init` - membuat atau menyegarkan konfigurasi, memilih nol atau lebih platform, lalu memasang perutean, scaffold dokumen kebenaran, dan instruksi untuk host AI yang dipilih.
 * `truthmark check` - memvalidasi kebenaran repositori dari terminal.
 
 ### Agen mengikuti kontrak saat membuat kode
@@ -199,7 +190,7 @@ Untuk penggunaan per perintah, perbandingan permukaan, detail platform yang didu
 
 Rilis saat ini menyediakan:
 
-- perintah CLI lokal untuk config, init, check, index, impact, dan status alur kerja
+- perintah CLI lokal untuk init, check, index, impact, dan status alur kerja
 - instruksi agen lokal repositori yang dihasilkan untuk Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity, dan Cursor
 - diagnostik perutean, otoritas, frontmatter, tautan, kesegaran, permukaan yang dihasilkan, cakupan branch, dan coverage
 - dokumen kebenaran berlingkup branch dan artefak kecerdasan repositori turunan

package/docs/readmes/README.it.md

@@ -13,30 +13,22 @@ Esegui questo comando nel repository Git che vuoi far gestire a Truthmark:
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-Abilita l’host IA che usi davvero. Le nuove configurazioni sono neutrali rispetto all’host, quindi aggiungi un elenco `platforms` di primo livello a `.truthmark/config.yml` prima dell’inizializzazione:
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+In un terminale interattivo, `truthmark init` mostra una selezione multipla numerata. Scegli zero o più piattaforme, oppure `none` per una configurazione neutrale rispetto all’host e solo CLI.
 
-Poi installa i documenti di verità locali al repository, il routing e le superfici di workflow per agenti:
+Per script e CI, ripeti `--platform`; `--json` non mostra mai prompt:
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+Alla prima esecuzione non interattiva senza `--platform`, la configurazione resta neutrale; le esecuzioni successive mantengono la selezione salvata in `.truthmark/config.yml`.
+
 Ora prova il percorso di adozione più comune: documentare un comportamento esistente a partire da codice e test. Nel tuo host di coding IA, chiedi al workflow installato:
 
 ```text
@@ -45,7 +37,7 @@ Ora prova il percorso di adozione più comune: documentare un comportamento esis
 
 Dopo questo, di norma gli utenti non dovrebbero invocare Truth Sync direttamente. Continua a scrivere codice tramite il tuo host IA; le istruzioni installate nel repository dicono all’agente di eseguire i test pertinenti e svolgere la revisione Truth Sync prima della consegna quando cambiano parti di codice funzionale. Tu revisioni il diff di codice risultante insieme al diff dei documenti di verità.
 
-Se vuoi solo la validazione CLI e non vuoi ancora workflow IA specifici per un host, lascia `platforms` omesso ed esegui `truthmark init && truthmark check`; potrai aggiungere una piattaforma più tardi e rieseguire `truthmark init`.
+Se vuoi solo la validazione CLI, scegli `none` e continua con `truthmark check`; potrai rieseguire `truthmark init` in seguito per selezionare le piattaforme.
 
 ## 💡 Il problema: il divario di documentazione dell’IA
 
@@ -90,8 +82,7 @@ Truthmark ha un contratto locale al repository e due modi per usarlo.
 
 Maintainer e CI usano la CLI:
 
-* `truthmark config` - crea la configurazione iniziale.
-* `truthmark init` - installa o aggiorna routing, scaffold dei documenti di verità e istruzioni per host IA.
+* `truthmark init` - crea o aggiorna la configurazione, consente di scegliere zero o più piattaforme e installa routing, scaffold dei documenti di verità e istruzioni per gli host selezionati.
 * `truthmark check` - valida la verità del repository dal terminale.
 
 ### Gli agenti seguono il contratto mentre scrivono codice
@@ -199,7 +190,7 @@ Per l’uso comando per comando, confronti tra superfici, dettagli sulle piattaf
 
 La release attuale fornisce:
 
-- comandi CLI locali per config, init, check, index, impact e stato dei workflow
+- comandi CLI locali per init, check, index, impact e stato dei workflow
 - istruzioni agente locali al repository generate per Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor
 - diagnostica su routing, autorità, frontmatter, link, freschezza, superfici generate, ambito di branch e copertura
 - documenti di verità con ambito di branch e artefatti derivati di intelligence del repository

package/docs/readmes/README.ja.md

@@ -13,30 +13,22 @@ Truthmark に管理させたい Git リポジトリ内でこれを実行しま
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-実際に使っている AI ホストを有効にします。新しい設定はホスト非依存なので、初期化前にトップレベルの `platforms` リストを `.truthmark/config.yml` に追加してください：
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+対話型ターミナルでは、`truthmark init` が番号付きの複数選択を表示します。0 個以上のプラットフォームを選ぶか、`none` を入力してホスト非依存の CLI 専用セットアップにします。
 
-次に、リポジトリローカルの truth ドキュメント、ルーティング、エージェントワークフローサーフェスをインストールします：
+スクリプトや CI では `--platform` を繰り返します。`--json` は決してプロンプトを表示しません：
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+初回の非対話実行で `--platform` がなければホスト非依存のままです。以後の実行では `.truthmark/config.yml` に保存済みの選択を維持します。
+
 次に、最も一般的な導入パスを試します。コードとテストから既存の振る舞いを 1 つドキュメント化します。AI コーディングホストで、インストール済みワークフローに依頼してください：
 
 ```text
@@ -45,7 +37,7 @@ git diff
 
 その後、通常ユーザーが Truth Sync を直接呼び出す必要はありません。AI ホストを通じてコーディングを続けてください。インストールされたリポジトリ指示が、機能コードの変更時に関連テストを実行し、引き渡し前に Truth Sync レビューを行うようエージェントに伝えます。あなたは結果のコード diff と truth-doc diff をレビューします。
 
-CLI 検証だけが必要で、ホスト固有の AI ワークフローをまだ使わない場合は、`platforms` を省略したまま `truthmark init && truthmark check` を実行してください。後からプラットフォームを追加し、`truthmark init` を再実行できます。
+CLI 検証だけが必要なら `none` を選び、`truthmark check` を実行してください。後から `truthmark init` を再実行してプラットフォームを選択できます。
 
 ## 💡 問題：AI ドキュメントギャップ
 
@@ -90,8 +82,7 @@ Truthmark には、リポジトリローカルな契約が 1 つあり、それ
 
 メンテナーと CI は CLI を使います:
 
-* `truthmark config` - 初期設定を作成します。
-* `truthmark init` - ルーティング、truth-doc の足場、AI ホスト向け指示をインストールまたは更新します。
+* `truthmark init` - 設定を作成または更新し、0 個以上のプラットフォームを選択して、ルーティング、truth-doc の足場、選択した AI ホスト向け指示をインストールします。
 * `truthmark check` - ターミナルからリポジトリ truth を検証します。
 
 ### エージェントはコーディング中に契約に従う
@@ -199,7 +190,7 @@ README は店頭のようなものです。素早い文脈、クイックスタ
 
 現在のリリースは次を提供します：
 
-- config、init、check、index、impact、workflow status のためのローカル CLI コマンド
+- init、check、index、impact、workflow status のためのローカル CLI コマンド
 - Codex、Claude Code、GitHub Copilot、OpenCode、Antigravity、Cursor 向けに生成されるリポジトリローカルなエージェント指示
 - ルーティング、権限、frontmatter、リンク、鮮度、生成サーフェス、ブランチスコープ、カバレッジの診断
 - ブランチ単位の truth ドキュメントと、派生したリポジトリインテリジェンス成果物