truthmark 2.2.7 → 2.3.0

package/docs/readmes/README.ko.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 호스트를 활성화하세요. 새 설정은 기본적으로 호스트 중립적이므로, 초기화 전에 `.truthmark/config.yml`에 최상위 `platforms` 목록을 추가하세요:
-
-```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`에 저장된 선택을 유지합니다.
+
 이제 가장 흔한 도입 경로를 시도해 보세요. 코드와 테스트에서 기존 동작 하나를 문서화합니다. AI 코딩 호스트에서 설치된 워크플로에 요청하세요:
 
 ```text
@@ -45,7 +37,7 @@ git diff
 
 그 이후에는 사용자가 일반적으로 Truth Sync를 직접 호출할 필요가 없습니다. AI 호스트를 통해 계속 코딩하세요. 설치된 저장소 지침이 기능 코드가 변경될 때 에이전트에게 관련 테스트를 실행하고 인계 전에 Truth Sync 검토를 수행하라고 알려줍니다. 사용자는 결과 코드 diff와 truth-doc diff를 함께 검토합니다.
 
-아직 호스트별 AI 워크플로는 원하지 않고 CLI 검증만 원한다면 `platforms`를 생략한 채 `truthmark init && truthmark check`를 실행하세요. 나중에 플랫폼을 추가하고 `truthmark init`을 다시 실행할 수 있습니다.
+CLI 검증만 원한다면 `none`을 선택하고 `truthmark check`를 실행하세요. 나중에 `truthmark init`을 다시 실행해 플랫폼을 선택할 수 있습니다.
 
 ## 💡 문제: AI 문서화 격차
 
@@ -90,8 +82,7 @@ Truthmark에는 저장소 로컬 계약 하나와 그것을 사용하는 두 가
 
 유지관리자와 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 문서와 파생된 저장소 인텔리전스 산출물

package/docs/readmes/README.pl.md

@@ -13,30 +13,22 @@ Uruchom to w repozytorium Git, którym ma zarządzać Truthmark:
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-Włącz hosta AI, którego faktycznie używasz. Nowe konfiguracje są neutralne wobec hosta, więc przed inicjalizacją dodaj listę najwyższego poziomu `platforms` do `.truthmark/config.yml`:
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+W terminalu interaktywnym `truthmark init` wyświetla numerowany wybór wielokrotny. Wybierz zero lub więcej platform albo wpisz `none`, aby skonfigurować tryb neutralny wobec hosta i tylko CLI.
 
-Następnie zainstaluj lokalne dla repozytorium dokumenty truth, routing i powierzchnie workflow agentów:
+W skryptach i CI powtarzaj `--platform`; `--json` nigdy nie wyświetla pytania:
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+Przy pierwszym nieinteraktywnym uruchomieniu bez `--platform` konfiguracja pozostaje neutralna; kolejne uruchomienia zachowują wybór zapisany w `.truthmark/config.yml`.
+
 Teraz wypróbuj najczęstszą ścieżkę adopcji: udokumentuj jedno istniejące zachowanie na podstawie kodu i testów. W swoim hoście kodowania AI poproś zainstalowany workflow:
 
 ```text
@@ -45,7 +37,7 @@ Teraz wypróbuj najczęstszą ścieżkę adopcji: udokumentuj jedno istniejące
 
 Po tym użytkownicy zwykle nie powinni wywoływać Truth Sync bezpośrednio. Kontynuuj kodowanie przez swojego hosta AI; zainstalowane instrukcje repozytorium mówią agentowi, aby przy zmianach kodu funkcjonalnego uruchomił odpowiednie testy i wykonał przegląd Truth Sync przed przekazaniem pracy. Ty przeglądasz wynikowy diff kodu oraz diff truth-doc.
 
-Jeśli chcesz tylko walidacji CLI i nie potrzebujesz jeszcze workflow AI specyficznych dla hosta, pozostaw `platforms` pominięte i uruchom `truthmark init && truthmark check`; później możesz dodać platformę i ponownie uruchomić `truthmark init`.
+Jeśli chcesz tylko walidacji CLI, wybierz `none` i uruchom `truthmark check`; później możesz ponownie uruchomić `truthmark init`, aby wybrać platformy.
 
 ## 💡 Problem: luka w dokumentacji AI
 
@@ -90,8 +82,7 @@ Truthmark ma jeden lokalny kontrakt repozytorium i dwa sposoby korzystania z nie
 
 Opiekunowie i CI używają CLI:
 
-* `truthmark config` - tworzy początkową konfigurację.
-* `truthmark init` - instaluje lub odświeża routing, szkielety truth-doc i instrukcje dla hostów AI.
+* `truthmark init` - tworzy lub odświeża konfigurację, pozwala wybrać zero lub więcej platform oraz instaluje routing, szkielety truth-doc i instrukcje dla wybranych hostów AI.
 * `truthmark check` - waliduje truth repozytorium z terminala.
 
 ### Agenci podążają za kontraktem podczas kodowania
@@ -199,7 +190,7 @@ Aby poznać użycie komenda po komendzie, porównanie powierzchni, szczegóły o
 
 Obecne wydanie zapewnia:
 
-- lokalne komendy CLI dla config, init, check, index, impact i workflow status
+- lokalne komendy CLI dla init, check, index, impact i workflow status
 - wygenerowane lokalne instrukcje agenta dla Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity i Cursor
 - diagnostykę route, authority, frontmatter, link, freshness, generated-surface, branch-scope i coverage
 - dokumenty truth w zakresie gałęzi oraz pochodne artefakty inteligencji repozytorium

package/docs/readmes/README.pt.md

@@ -13,30 +13,22 @@ Execute isto dentro do repositório Git que você quer que o Truthmark gerencie:
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-Ative o host de IA que você realmente usa. Configurações novas são neutras em relação a host; portanto, adicione uma lista `platforms` de nível superior a `.truthmark/config.yml` antes da inicialização:
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+Em um terminal interativo, `truthmark init` mostra uma seleção múltipla numerada. Escolha zero ou mais plataformas, ou `none` para uma configuração neutra em relação a host e somente de CLI.
 
-Em seguida, instale os documentos de verdade locais do repositório, o roteamento e as instruções para hosts de IA:
+Para scripts e CI, repita `--platform`; `--json` nunca exibe uma solicitação interativa:
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+Na primeira execução não interativa sem `--platform`, a configuração permanece neutra; execuções posteriores mantêm a seleção salva em `.truthmark/config.yml`.
+
 Agora experimente o caminho de adoção mais comum: documentar, a partir do código e dos testes, um comportamento existente. No seu host de codificação com IA, peça ao workflow instalado:
 
 ```text
@@ -45,7 +37,7 @@ Agora experimente o caminho de adoção mais comum: documentar, a partir do cód
 
 Depois disso, usuários normalmente não devem invocar o Truth Sync diretamente. Continue codificando por meio do seu host de IA; as instruções instaladas no repositório dizem ao agente para executar os testes relevantes e realizar a revisão Truth Sync antes da entrega quando houver mudanças em código funcional. Você revisa o diff de código resultante junto com o diff dos documentos de verdade.
 
-Se você quer apenas validação por CLI e ainda não quer workflows de IA específicos de host, deixe `platforms` omitido e execute `truthmark init && truthmark check`; você pode adicionar uma plataforma depois e executar `truthmark init` novamente.
+Se você quer apenas validação por CLI, escolha `none` e continue com `truthmark check`; depois você pode executar `truthmark init` novamente para selecionar plataformas.
 
 ## 💡 O problema: a lacuna de documentação da IA
 
@@ -90,8 +82,7 @@ Truthmark tem um contrato local do repositório e duas formas de usá-lo.
 
 Mantenedores e CI usam a CLI:
 
-* `truthmark config` - cria a configuração inicial.
-* `truthmark init` - instala ou atualiza roteamento, scaffolds de documentos de verdade e instruções para hosts de IA.
+* `truthmark init` - cria ou atualiza a configuração, permite escolher zero ou mais plataformas e instala roteamento, scaffolds de documentos de verdade e instruções dos hosts selecionados.
 * `truthmark check` - valida a verdade do repositório pelo terminal.
 
 ### Agentes seguem o contrato enquanto programam
@@ -199,7 +190,7 @@ Para uso comando por comando, comparações de superfícies, detalhes de platafo
 
 A versão atual fornece:
 
-- comandos CLI locais para config, init, check, index, impact e status de workflows
+- comandos CLI locais para init, check, index, impact e status de workflows
 - instruções de agente locais do repositório geradas para Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity e Cursor
 - diagnósticos de roteamento, autoridade, frontmatter, links, frescor, superfícies geradas, escopo de branch e cobertura
 - documentos de verdade com escopo de branch e artefatos derivados de inteligência do repositório

package/docs/readmes/README.ru.md

@@ -13,30 +13,22 @@
 ```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` показывает нумерованный множественный выбор. Выберите ноль или несколько платформ либо введите `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`.
+
 Теперь попробуйте самый распространенный путь внедрения: задокументируйте одно существующее поведение по коду и тестам. В вашем AI-хосте для разработки попросите установленный рабочий процесс:
 
 ```text
@@ -45,7 +37,7 @@ git diff
 
 После этого пользователям обычно не следует напрямую вызывать Truth Sync. Продолжайте писать код через ваш AI-хост; установленные инструкции репозитория скажут агенту запускать релевантные тесты и выполнять проверку Truth Sync перед передачей, когда меняется функциональный код. Вы просматриваете получившийся diff кода вместе с diff truth-документов.
 
-Если вам нужна только CLI-валидация, а хост-специфичные AI workflow пока не нужны, оставьте `platforms` неуказанным и выполните `truthmark init && truthmark check`; позже можно добавить платформу и заново выполнить `truthmark init`.
+Если нужна только CLI-валидация, выберите `none` и выполните `truthmark check`; позже можно снова выполнить `truthmark init` и выбрать платформы.
 
 ## 💡 Проблема: разрыв в AI-документации
 
@@ -90,8 +82,7 @@ Truthmark — не просто очередной инструмент доку
 
 Мейнтейнеры и CI используют CLI:
 
-* `truthmark config` - создает начальную конфигурацию.
-* `truthmark init` - устанавливает или обновляет маршруты, scaffold для truth-doc и инструкции для AI-хостов.
+* `truthmark init` - создаёт или обновляет конфигурацию, позволяет выбрать ноль или несколько платформ и устанавливает маршруты, scaffold для truth-doc и инструкции выбранных AI-хостов.
 * `truthmark check` - проверяет truth репозитория из терминала.
 
 ### Агенты следуют контракту во время кодинга
@@ -199,7 +190,7 @@ README — это витрина: быстрый контекст, быстры
 
 Текущий релиз предоставляет:
 
-- локальные CLI-команды для config, init, check, index, impact и workflow status
+- локальные CLI-команды для init, check, index, impact и workflow status
 - сгенерированные локальные инструкции агента для Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity и Cursor
 - диагностику route, authority, frontmatter, links, freshness, generated-surface, branch-scope и coverage
 - branch-scoped truth docs и производные артефакты repository intelligence

package/docs/readmes/README.tr.md

@@ -13,30 +13,22 @@ Bunu Truthmark tarafından yönetilmesini istediğiniz Git deposunun içinde ça
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-Gerçekten kullandığınız AI ana makinesini etkinleştirin. Yeni yapılandırmalar ana makineden bağımsızdır; bu yüzden başlatmadan önce `.truthmark/config.yml` dosyasına üst düzey bir `platforms` listesi ekleyin:
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+Etkileşimli bir terminalde `truthmark init`, numaralı bir çoklu seçim gösterir. Sıfır veya daha fazla platform seçin ya da ana makineden bağımsız, yalnızca CLI kurulumu için `none` girin.
 
-Ardından depoya yerel gerçeklik belgelerini, yönlendirmeyi ve ajan iş akışı yüzeylerini kurun:
+Betikler ve CI için `--platform` seçeneğini tekrarlayın; `--json` hiçbir zaman istem göstermez:
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+`--platform` olmadan ilk etkileşimsiz çalıştırmada kurulum ana makineden bağımsız kalır; sonraki çalıştırmalar `.truthmark/config.yml` içinde kayıtlı seçimi korur.
+
 Şimdi en yaygın benimseme yolunu deneyin: kod ve testlerden mevcut bir davranışı belgeleyin. AI kodlama ana makinenizde, kurulu iş akışına şunu isteyin:
 
 ```text
@@ -45,7 +37,7 @@ git diff
 
 Bundan sonra kullanıcılar normalde Truth Sync'i doğrudan çağırmamalıdır. AI ana makineniz üzerinden kod yazmaya devam edin; kurulu depo yönergeleri, işlevsel kod değiştiğinde teslimden önce ajana ilgili testleri çalıştırmasını ve Truth Sync incelemesini yapmasını söyler. Siz ortaya çıkan kod farkını ve truth-belge farkını incelersiniz.
 
-Yalnızca CLI doğrulaması istiyor ve henüz ana makineye özgü AI iş akışları istemiyorsanız, `platforms` alanını dışarıda bırakıp `truthmark init && truthmark check` çalıştırın; daha sonra bir platform ekleyip `truthmark init` komutunu yeniden çalıştırabilirsiniz.
+Yalnızca CLI doğrulaması istiyorsanız `none` seçip `truthmark check` çalıştırın; platform seçmek için daha sonra `truthmark init` komutunu yeniden çalıştırabilirsiniz.
 
 ## 💡 Sorun: AI dokümantasyon boşluğu
 
@@ -90,8 +82,7 @@ Truthmark’ın depo yerelinde tek bir sözleşmesi ve onu kullanmanın iki yolu
 
 Bakımcılar ve CI, CLI kullanır:
 
-* `truthmark config` - ilk yapılandırmayı oluşturur.
-* `truthmark init` - yönlendirmeyi, truth-doc iskelelerini ve AI ana makine talimatlarını kurar veya yeniler.
+* `truthmark init` - yapılandırmayı oluşturur veya yeniler, sıfır ya da daha fazla platform seçtirir ve yönlendirmeyi, truth-doc iskelelerini ve seçilen AI ana makine talimatlarını kurar.
 * `truthmark check` - depo gerçeğini terminalden doğrular.
 
 ### Ajanlar kod yazarken sözleşmeyi izler
@@ -199,7 +190,7 @@ Komut komut kullanım, yüzey karşılaştırmaları, desteklenen platform ayrı
 
 Mevcut sürüm şunları sağlar:
 
-- config, init, check, index, impact ve iş akışı durumu için yerel CLI komutları
+- init, check, index, impact ve iş akışı durumu için yerel CLI komutları
 - Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity ve Cursor için oluşturulan depo yerelinde ajan talimatları
 - yönlendirme, yetki, frontmatter, bağlantı, güncellik, üretilmiş yüzey, dal kapsamı ve kapsam tanıları
 - dal kapsamlı gerçeklik belgeleri ve türetilmiş depo zekâsı artefaktları

package/docs/readmes/README.vi.md

@@ -13,30 +13,22 @@ Chạy lệnh này bên trong kho Git mà bạn muốn Truthmark quản lý:
 ```bash
 cd /path/to/your-repo
 npm install -g truthmark
-truthmark config
+truthmark init
+truthmark check
+git diff
 ```
 
-Bật máy chủ AI mà bạn thực sự sử dụng. Cấu hình mới không gắn với máy chủ nào, vì vậy hãy thêm danh sách `platforms` ở cấp cao nhất vào `.truthmark/config.yml` trước khi khởi tạo:
-
-```yaml
-version: 2
-platforms:
-  - codex        # or: claude-code, github-copilot, opencode, antigravity, cursor
-truthmark:
-  workspace: docs/truthmark
-  generated:
-    portal:
-      enabled: false
-```
+Trong terminal tương tác, `truthmark init` hiển thị danh sách đa lựa chọn được đánh số. Chọn không, một hoặc nhiều nền tảng, hoặc nhập `none` để thiết lập chỉ dùng CLI và không gắn với host.
 
-Sau đó cài đặt tài liệu sự thật cục bộ của kho, định tuyến và các bề mặt quy trình làm việc cho tác tử:
+Với script và CI, hãy lặp lại `--platform`; `--json` không bao giờ hiển thị lời nhắc:
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+Ở lần chạy không tương tác đầu tiên mà không có `--platform`, thiết lập vẫn trung lập với host; các lần chạy sau giữ lựa chọn đã lưu trong `.truthmark/config.yml`.
+
 Bây giờ hãy thử lộ trình áp dụng phổ biến nhất: ghi tài liệu cho một hành vi hiện có từ mã và kiểm thử. Trong máy chủ lập trình AI của bạn, hãy yêu cầu quy trình đã cài đặt:
 
 ```text
@@ -45,7 +37,7 @@ Bây giờ hãy thử lộ trình áp dụng phổ biến nhất: ghi tài liệ
 
 Sau đó, người dùng thường không nên gọi Truth Sync trực tiếp. Hãy tiếp tục lập trình qua máy chủ AI của bạn; các chỉ dẫn kho đã cài đặt yêu cầu tác tử chạy các kiểm thử liên quan và thực hiện đánh giá Truth Sync trước khi bàn giao khi mã chức năng thay đổi. Bạn xem xét phần diff mã kết quả cùng với diff tài liệu truth.
 
-Nếu bạn chỉ muốn xác thực bằng CLI và chưa muốn các quy trình AI theo máy chủ, hãy để trống `platforms` và chạy `truthmark init && truthmark check`; bạn có thể thêm nền tảng sau và chạy lại `truthmark init`.
+Nếu bạn chỉ muốn xác thực bằng CLI, hãy chọn `none` rồi chạy `truthmark check`; bạn có thể chạy lại `truthmark init` sau để chọn nền tảng.
 
 ## 💡 Vấn đề: khoảng trống tài liệu AI
 
@@ -90,8 +82,7 @@ Truthmark có một hợp đồng cục bộ trong kho và hai cách sử dụng
 
 Người bảo trì và CI dùng CLI:
 
-* `truthmark config` - tạo cấu hình ban đầu.
-* `truthmark init` - cài đặt hoặc làm mới định tuyến, scaffold truth-doc và hướng dẫn cho AI host.
+* `truthmark init` - tạo hoặc làm mới cấu hình, cho phép chọn không, một hoặc nhiều nền tảng, rồi cài đặt định tuyến, scaffold truth-doc và hướng dẫn cho các AI host đã chọn.
 * `truthmark check` - xác thực sự thật của kho từ terminal.
 
 ### Tác tử tuân theo hợp đồng khi viết mã
@@ -199,7 +190,7 @@ README là mặt tiền: ngữ cảnh nhanh, bắt đầu nhanh và mô hình t
 
 Bản phát hành hiện tại cung cấp:
 
-- các lệnh CLI cục bộ cho config, init, check, index, impact và trạng thái quy trình
+- các lệnh CLI cục bộ cho init, check, index, impact và trạng thái quy trình
 - hướng dẫn tác tử cục bộ trong kho được tạo cho Codex, Claude Code, GitHub Copilot, OpenCode, Antigravity và Cursor
 - chẩn đoán về định tuyến, thẩm quyền, frontmatter, liên kết, độ mới, bề mặt sinh ra, phạm vi nhánh và độ phủ
 - tài liệu sự thật theo phạm vi nhánh và các hiện vật trí tuệ kho được suy dẫn

package/docs/readmes/README.zh.md

@@ -13,30 +13,22 @@
 ```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` 会显示带编号的多选列表。可选择零个或多个平台，也可输入 `none`，仅进行与宿主无关的 CLI 设置。
 
-然后安装仓库本地的事实文档、路由和 AI 宿主指令：
+在脚本和 CI 中可重复使用 `--platform`；`--json` 永远不会提示输入：
 
 ```bash
-truthmark init
-truthmark check
-git diff
+truthmark init --platform codex --platform cursor
+truthmark init --json
 ```
 
+首次非交互运行且没有 `--platform` 时，初始化保持宿主中立；之后的运行会保留 `.truthmark/config.yml` 中保存的选择。
+
 现在尝试最常见的采用路径：根据代码和测试记录一个已有行为。在你的 AI 编码宿主中，请求已安装的工作流：
 
 ```text
@@ -45,7 +37,7 @@ git diff
 
 之后，用户通常不应直接调用 Truth Sync。继续通过你的 AI 宿主编写代码；已安装的仓库指令会告诉代理：当功能代码发生变化时，在交接前运行相关测试并执行 Truth Sync 审查。你审查最终的代码 diff 和事实文档 diff。
 
-如果你暂时只想要 CLI 验证，而不需要特定宿主的 AI 工作流，可以省略 `platforms`，并运行 `truthmark init && truthmark check`；之后你可以再添加平台并重新运行 `truthmark init`。
+如果暂时只需要 CLI 验证，请选择 `none`，然后运行 `truthmark check`；之后可重新运行 `truthmark init` 来选择平台。
 
 ## 💡 问题：AI 文档缺口
 
@@ -90,8 +82,7 @@ Truthmark 有一个仓库本地契约，以及两种使用方式。
 
 维护者和 CI 使用 CLI：
 
-* `truthmark config` - 创建初始配置。
-* `truthmark init` - 安装或刷新路由、事实文档脚手架和 AI 宿主指令。
+* `truthmark init` - 创建或刷新配置，选择零个或多个平台，并安装路由、事实文档脚手架及所选 AI 宿主的指令。
 * `truthmark check` - 从终端验证仓库事实。
 
 ### 代理在编码时遵循契约
@@ -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、链接、新鲜度、生成界面、分支范围和覆盖率诊断
 - 按分支生效的事实文档和派生的仓库智能产物

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "truthmark",
-  "version": "2.2.7",
+  "version": "2.3.0",
   "description": "Git-native, branch-scoped truth workflow installer for local AI coding agents.",
   "license": "MIT",
   "type": "module",