truthmark 2.2.0 → 2.2.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.
package/README.de.md CHANGED
@@ -394,7 +394,7 @@ Es darf keinen funktionalen Code ändern.
394
394
  Nutze Truth Realize, wenn eine Produkt- oder Architekturentscheidung in Dokumenten beginnt und Code daran angepasst werden soll.
395
395
 
396
396
  ```text
397
- /truthmark-realize docs/truthmark/truth/authentication/session-timeout.md in Code realisieren
397
+ /truthmark-realize docs/truthmark/product/capabilities/session-timeout.md in Code realisieren
398
398
  ```
399
399
 
400
400
  Truth Realize ist doc-first.
@@ -441,7 +441,7 @@ Die meisten Maintainer beginnen mit drei Befehlen.
441
441
  | `truthmark init` | Installiert oder aktualisiert konfigurierte Workflow-Schnittstellen aus der geprüften Config. |
442
442
  | `truthmark check` | Validiert Config, Autorität, Routing, entscheidungstragende Dokumente, Frontmatter, interne Links, Branch-Scope, generierte Oberflächen, Freshness und Coverage-Diagnostik. |
443
443
 
444
- Optionale Repository-Intelligence-Helfer erzeugen abgeleitetes Review-Material für den aktiven Checkout, etwa RepoIndex-, RouteMap-, ImpactSet- und begrenzte ContextPack-Artefakte. Generierte Workflow-Skill-Pakete können außerdem Helper-Manifeste und Helper-Policies bereitstellen, die installierte `truthmark validate ... --json` CLI-Validatoren aufrufen; diese Helpers sind Beschleuniger, keine im Repository gebündelten lokalen Skripte und keine Quellen der Wahrheit. Eigenständige Copilot-Prompts und Gemini-Commands verwenden denselben CLI-Validator-Vertrag, wenn der installierte Runner verfügbar ist; andernfalls melden sie einen sichtbaren übersprungenen Helper-Status und führen eine manuelle Validierung durch.
444
+ Optionale Repository-Intelligence-Helfer erzeugen abgeleitetes Review-Material für den aktiven Checkout, etwa RepoIndex-, RouteMap-, ImpactSet- und kompaktes WorkflowState/action-context-JSON. Generierte Workflow-Skill-Pakete können außerdem Helper-Manifeste und Helper-Policies bereitstellen, die installierte `truthmark validate ... --json` CLI-Validatoren aufrufen; diese Helpers sind Beschleuniger, keine im Repository gebündelten lokalen Skripte und keine Quellen der Wahrheit. Eigenständige Copilot-Prompts und Gemini-Commands verwenden denselben CLI-Validator-Vertrag, wenn der installierte Runner verfügbar ist; andernfalls melden sie einen sichtbaren übersprungenen Helper-Status und führen eine manuelle Validierung durch.
445
445
 
446
446
  Sie sind keine Quellen der Wahrheit.
447
447
 
@@ -449,7 +449,7 @@ Sie sind keine Quellen der Wahrheit.
449
449
  | --- | --- |
450
450
  | `truthmark index` | Baut RepoIndex- und RouteMap-JSON für den aktiven Checkout. |
451
451
  | `truthmark impact --base <ref>` | Ordnet geänderte Dateien gerouteten Truth-Dokumenten, besitzenden Routen, nahen Tests und öffentlichen Symbolen zu. |
452
- | `truthmark ctx --workflow <workflow> [--base <ref>]` | Erzeugt ein begrenztes ContextPack für Truth Sync, Truth Document oder Truth Realize. Nutze `--format markdown` für eine menschenlesbare Fassung. |
452
+ | `truthmark workflow status --workflow <workflow> [--base <ref>] --json` | Liefert Workflow-Anwendbarkeit, Schreibgrenzen, Ziel-Truth-Dokumente, Checks, Helper-Commands und kompakte Hinweise zu betroffenen Tests. |
453
453
 
454
454
  Strukturierte Ausgabe ist mit `--json` verfügbar, wo sie unterstützt wird.
455
455
 
@@ -642,7 +642,7 @@ truthmark check
642
642
  ### Implementiertes Verhalten dokumentieren
643
643
 
644
644
  ```text
645
- /truthmark-document den implementierten Password-Reset-Flow unter docs/truthmark/truth/authentication dokumentieren
645
+ /truthmark-document den implementierten Password-Reset-Flow unter docs/truthmark/engineering/behaviors/authentication dokumentieren
646
646
  ```
647
647
 
648
648
  ### Nach Codeänderungen synchronisieren
@@ -654,7 +654,7 @@ truthmark check
654
654
  ### Eine doc-first Entscheidung realisieren
655
655
 
656
656
  ```text
657
- /truthmark-realize docs/truthmark/truth/billing/invoice-retry-policy.md in Code realisieren
657
+ /truthmark-realize docs/truthmark/product/capabilities/invoice-retry-policy.md in Code realisieren
658
658
  ```
659
659
 
660
660
  ### Truth-Gesundheit im Terminal auditieren
@@ -669,10 +669,10 @@ truthmark check
669
669
  truthmark impact --base main
670
670
  ```
671
671
 
672
- ### Workflow-ContextPack erzeugen
672
+ ### Workflow-Status prüfen
673
673
 
674
674
  ```bash
675
- truthmark ctx --workflow truth-sync --base main --format markdown
675
+ truthmark workflow status --workflow truthmark-sync --base main --json
676
676
  ```
677
677
 
678
678
  ### Optionalen Portal-Workflow aktivieren
@@ -699,7 +699,7 @@ Truthmark V1 bietet derzeit:
699
699
  - `truthmark check`
700
700
  - `truthmark index`
701
701
  - `truthmark impact`
702
- - `truthmark ctx`
702
+ - `truthmark workflow status`
703
703
  - Branch-Scope-Metadaten
704
704
  - verwaltete Instruktionsblöcke
705
705
  - generierte Truth-Structure-Workflow-Schnittstellen
@@ -710,7 +710,7 @@ Truthmark V1 bietet derzeit:
710
710
  - generierte Truth-Check-Workflow-Schnittstellen
711
711
  - optionale generierte Truthmark-Portal-Workflow-Schnittstellen
712
712
  - Diagnostik für Route, Autorität, Entscheidungsstruktur, Frontmatter, Links, Freshness, generierte Schnittstellen und Coverage
713
- - abgeleitete RepoIndex-, RouteMap-, ImpactSet- und ContextPack-Artefakte
713
+ - abgeleitete RepoIndex-, RouteMap-, ImpactSet- und WorkflowState-Artefakte
714
714
  - host-spezifische Schnittstellen für Codex, Claude Code, GitHub Copilot, OpenCode und Gemini CLI
715
715
 
716
716
  ## Entwicklung
@@ -755,11 +755,11 @@ Die README ist der schnelle Pfad für Evaluation und Setup.
755
755
  Aktuelles Verhalten im Detail lebt unter `docs/`:
756
756
 
757
757
  - [Dokumentationsindex](docs/README.md)
758
- - [Architekturüberblick](docs/truthmark/truth/architecture/overview.md)
759
- - [API- und CLI-Verträge](docs/truthmark/truth/contracts.md)
760
- - [Init- und Scaffold-Verhalten](docs/truthmark/truth/init-and-scaffold.md)
761
- - [Check-Diagnostik](docs/truthmark/truth/check-diagnostics.md)
762
- - [Installierte Workflows](docs/truthmark/truth/workflows/overview.md)
758
+ - [Architekturüberblick](docs/truthmark/engineering/architecture/overview.md)
759
+ - [API- und CLI-Verträge](docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
760
+ - [Init- und Scaffold-Verhalten](docs/truthmark/engineering/behaviors/init-and-scaffold.md)
761
+ - [Check-Diagnostik](docs/truthmark/engineering/behaviors/check-diagnostics.md)
762
+ - [Installierte Workflows](docs/truthmark/engineering/workflows/installed-workflow-runtime.md)
763
763
  - [Leitfaden zur Pflege von Repository-Truth](docs/standards/maintaining-repository-truth.md)
764
764
 
765
765
  ## Designgrenzen
package/README.es.md CHANGED
@@ -394,7 +394,7 @@ No debe cambiar código funcional.
394
394
  Usa Truth Realize cuando una decisión de producto o arquitectura empieza en documentos y el código debe actualizarse para coincidir.
395
395
 
396
396
  ```text
397
- /truthmark-realize realiza docs/truthmark/truth/authentication/session-timeout.md como código
397
+ /truthmark-realize realiza docs/truthmark/product/capabilities/session-timeout.md como código
398
398
  ```
399
399
 
400
400
  Truth Realize es doc-first.
@@ -441,7 +441,7 @@ La mayoría de los mantenedores empieza con tres comandos.
441
441
  | `truthmark init` | Instala o refresca interfaces de flujo de trabajo configuradas desde la config revisada. |
442
442
  | `truthmark check` | Valida configuración, autoridad, rutas, documentos con decisiones, frontmatter, enlaces internos, alcance de rama, interfaces generadas, vigencia y diagnósticos de cobertura. |
443
443
 
444
- Los ayudantes opcionales de inteligencia del repositorio generan material derivado para revisión sobre el checkout activo, como artefactos RepoIndex, RouteMap, ImpactSet y ContextPack acotados. Los paquetes de skills de flujo generados también pueden exponer manifiestos y políticas de helpers que llaman a validadores CLI `truthmark validate ... --json` instalados; esos helpers son aceleradores, no scripts locales empaquetados en el repo ni fuentes de verdad. Los prompts independientes de Copilot y los comandos de Gemini usan el mismo contrato de validador CLI cuando el runner instalado está disponible; de lo contrario informan un estado visible de helper omitido y hacen validación manual.
444
+ Los ayudantes opcionales de inteligencia del repositorio generan material derivado para revisión sobre el checkout activo, como RepoIndex, RouteMap, ImpactSet y JSON compacto de WorkflowState/action-context. Los paquetes de skills de flujo generados también pueden exponer manifiestos y políticas de helpers que llaman a validadores CLI `truthmark validate ... --json` instalados; esos helpers son aceleradores, no scripts locales empaquetados en el repo ni fuentes de verdad. Los prompts independientes de Copilot y los comandos de Gemini usan el mismo contrato de validador CLI cuando el runner instalado está disponible; de lo contrario informan un estado visible de helper omitido y hacen validación manual.
445
445
 
446
446
  No son fuentes de verdad.
447
447
 
@@ -449,7 +449,7 @@ No son fuentes de verdad.
449
449
  | --- | --- |
450
450
  | `truthmark index` | Construye JSON de RepoIndex y RouteMap para el checkout activo. |
451
451
  | `truthmark impact --base <ref>` | Mapea archivos cambiados a documentos de verdad enrutados, rutas propietarias, pruebas cercanas y símbolos públicos. |
452
- | `truthmark ctx --workflow <workflow> [--base <ref>]` | Genera un ContextPack acotado para Truth Sync, Truth Document o Truth Realize. Usa `--format markdown` para una versión legible por personas. |
452
+ | `truthmark workflow status --workflow <workflow> [--base <ref>] --json` | Devuelve aplicabilidad del flujo, límites de escritura, documentos de verdad objetivo, checks, comandos helper y guía compacta de pruebas afectadas. |
453
453
 
454
454
  La salida estructurada está disponible con `--json` donde se admite.
455
455
 
@@ -642,7 +642,7 @@ truthmark check
642
642
  ### Documentar comportamiento implementado
643
643
 
644
644
  ```text
645
- /truthmark-document documenta el flujo implementado de restablecimiento de contraseña bajo docs/truthmark/truth/authentication
645
+ /truthmark-document documenta el flujo implementado de restablecimiento de contraseña bajo docs/truthmark/engineering/behaviors/authentication
646
646
  ```
647
647
 
648
648
  ### Sincronizar después de cambios de código
@@ -654,7 +654,7 @@ truthmark check
654
654
  ### Realizar una decisión doc-first
655
655
 
656
656
  ```text
657
- /truthmark-realize realiza docs/truthmark/truth/billing/invoice-retry-policy.md como código
657
+ /truthmark-realize realiza docs/truthmark/product/capabilities/invoice-retry-policy.md como código
658
658
  ```
659
659
 
660
660
  ### Auditar la salud de verdad desde la terminal
@@ -669,10 +669,10 @@ truthmark check
669
669
  truthmark impact --base main
670
670
  ```
671
671
 
672
- ### Generar un ContextPack de workflow
672
+ ### Inspeccionar el estado del workflow
673
673
 
674
674
  ```bash
675
- truthmark ctx --workflow truth-sync --base main --format markdown
675
+ truthmark workflow status --workflow truthmark-sync --base main --json
676
676
  ```
677
677
 
678
678
  ### Habilitar el flujo Portal opcional
@@ -699,7 +699,7 @@ Truthmark V1 actualmente proporciona:
699
699
  - `truthmark check`
700
700
  - `truthmark index`
701
701
  - `truthmark impact`
702
- - `truthmark ctx`
702
+ - `truthmark workflow status`
703
703
  - metadatos de alcance de rama
704
704
  - bloques de instrucciones administrados
705
705
  - interfaces generadas de flujo Truth Structure
@@ -710,7 +710,7 @@ Truthmark V1 actualmente proporciona:
710
710
  - interfaces generadas de flujo Truth Check
711
711
  - interfaces generadas opcionales de flujo Truthmark Portal
712
712
  - diagnósticos de rutas, autoridad, estructura de decisiones, frontmatter, enlaces, vigencia, interfaces generadas y cobertura
713
- - artefactos derivados RepoIndex, RouteMap, ImpactSet y ContextPack
713
+ - artefactos derivados RepoIndex, RouteMap, ImpactSet y WorkflowState
714
714
  - interfaces específicas de host para Codex, Claude Code, GitHub Copilot, OpenCode y Gemini CLI
715
715
 
716
716
  ## Desarrollo
@@ -755,11 +755,11 @@ El README es el camino rápido para evaluación y configuración.
755
755
  El comportamiento actual detallado vive bajo `docs/`:
756
756
 
757
757
  - [Índice de documentación](docs/README.md)
758
- - [Resumen de arquitectura](docs/truthmark/truth/architecture/overview.md)
759
- - [Contratos de API y CLI](docs/truthmark/truth/contracts.md)
760
- - [Comportamiento de init y scaffold](docs/truthmark/truth/init-and-scaffold.md)
761
- - [Diagnósticos de check](docs/truthmark/truth/check-diagnostics.md)
762
- - [Flujos instalados](docs/truthmark/truth/workflows/overview.md)
758
+ - [Resumen de arquitectura](docs/truthmark/engineering/architecture/overview.md)
759
+ - [Contratos de API y CLI](docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
760
+ - [Comportamiento de init y scaffold](docs/truthmark/engineering/behaviors/init-and-scaffold.md)
761
+ - [Diagnósticos de check](docs/truthmark/engineering/behaviors/check-diagnostics.md)
762
+ - [Flujos instalados](docs/truthmark/engineering/workflows/installed-workflow-runtime.md)
763
763
  - [Guía para mantener la verdad del repositorio](docs/standards/maintaining-repository-truth.md)
764
764
 
765
765
  ## Límites de diseño
package/README.md CHANGED
@@ -394,7 +394,7 @@ It must not change functional code.
394
394
  Use Truth Realize when a product or architecture decision starts in docs and code should be updated to match.
395
395
 
396
396
  ```text
397
- /truthmark-realize realize docs/truthmark/truth/authentication/session-timeout.md into code
397
+ /truthmark-realize realize docs/truthmark/product/capabilities/session-timeout.md into code
398
398
  ```
399
399
 
400
400
  Truth Realize is doc-first.
@@ -441,7 +441,7 @@ Most maintainers start with three commands.
441
441
  | `truthmark init` | Install or refresh configured workflow surfaces from the reviewed config. |
442
442
  | `truthmark check` | Validate configuration, authority, routing, decision-bearing docs, frontmatter, internal links, branch scope, generated surfaces, freshness, and coverage diagnostics. |
443
443
 
444
- Optional repository-intelligence helpers generate derived review material for the active checkout, such as RepoIndex, RouteMap, ImpactSet, and bounded ContextPack artifacts. Generated workflow skill packages may also expose helper manifests and helper policies that call installed `truthmark validate ... --json` CLI validators; those helpers are accelerators, not bundled repo-local scripts or sources of truth. Standalone Copilot prompts and Gemini commands use the same CLI validator contract when the installed runner is available, and otherwise report a visible skipped helper status with manual validation.
444
+ Optional repository-intelligence helpers generate derived review material for the active checkout, such as RepoIndex, RouteMap, ImpactSet, and compact WorkflowState/action-context JSON. Generated workflow skill packages may also expose helper manifests and helper policies that call installed `truthmark validate ... --json` CLI validators; those helpers are accelerators, not bundled repo-local scripts or sources of truth. Standalone Copilot prompts and Gemini commands use the same CLI validator contract when the installed runner is available, and otherwise report a visible skipped helper status with manual validation.
445
445
 
446
446
  They are not sources of truth.
447
447
 
@@ -449,7 +449,7 @@ They are not sources of truth.
449
449
  | --- | --- |
450
450
  | `truthmark index` | Build RepoIndex and RouteMap JSON for the active checkout. |
451
451
  | `truthmark impact --base <ref>` | Map changed files to routed truth docs, owning routes, nearby tests, and public symbols. |
452
- | `truthmark context --workflow <workflow> [--base <ref>]` | Generate a bounded ContextPack for Truth Sync, Truth Document, or Truth Realize. Use `--format markdown` for a human-readable pack. |
452
+ | `truthmark workflow status --workflow <workflow> [--base <ref>] --json` | Return workflow applicability, write boundaries, target truth docs, checks, helper commands, and compact affected-test guidance. |
453
453
 
454
454
  Structured output is available with `--json` where supported.
455
455
 
@@ -642,7 +642,7 @@ truthmark check
642
642
  ### Document implemented behavior
643
643
 
644
644
  ```text
645
- /truthmark-document document the implemented password reset flow under docs/truthmark/truth/authentication
645
+ /truthmark-document document the implemented password reset flow under docs/truthmark/engineering/behaviors/authentication
646
646
  ```
647
647
 
648
648
  ### Sync after code changes
@@ -654,7 +654,7 @@ truthmark check
654
654
  ### Realize a doc-first decision
655
655
 
656
656
  ```text
657
- /truthmark-realize realize docs/truthmark/truth/billing/invoice-retry-policy.md into code
657
+ /truthmark-realize realize docs/truthmark/product/capabilities/invoice-retry-policy.md into code
658
658
  ```
659
659
 
660
660
  ### Audit truth health from the terminal
@@ -669,10 +669,10 @@ truthmark check
669
669
  truthmark impact --base main
670
670
  ```
671
671
 
672
- ### Generate a workflow ContextPack
672
+ ### Inspect workflow status
673
673
 
674
674
  ```bash
675
- truthmark context --workflow truth-sync --base main --format markdown
675
+ truthmark workflow status --workflow truthmark-sync --base main --json
676
676
  ```
677
677
 
678
678
  ### Enable the optional Portal workflow
@@ -699,7 +699,7 @@ Truthmark V1 currently provides:
699
699
  - `truthmark check`
700
700
  - `truthmark index`
701
701
  - `truthmark impact`
702
- - `truthmark context`
702
+ - `truthmark workflow status`
703
703
  - branch-scope metadata
704
704
  - managed instruction blocks
705
705
  - generated Truth Structure workflow surfaces
@@ -710,7 +710,7 @@ Truthmark V1 currently provides:
710
710
  - generated Truth Check workflow surfaces
711
711
  - optional generated Truthmark Portal workflow surfaces
712
712
  - route, authority, decision-structure, frontmatter, link, freshness, generated-surface, and coverage diagnostics
713
- - derived RepoIndex, RouteMap, ImpactSet, and ContextPack artifacts
713
+ - derived RepoIndex, RouteMap, ImpactSet, and WorkflowState artifacts
714
714
  - host-specific surfaces for Codex, Claude Code, GitHub Copilot, OpenCode, and Gemini CLI
715
715
 
716
716
  ## Development
@@ -755,11 +755,11 @@ The README is the fast path for evaluation and setup.
755
755
  Detailed current behavior lives under `docs/`:
756
756
 
757
757
  - [Docs index](docs/README.md)
758
- - [Architecture overview](docs/truthmark/truth/architecture/overview.md)
759
- - [API and CLI contracts](docs/truthmark/truth/contracts.md)
760
- - [Init and scaffold behavior](docs/truthmark/truth/init-and-scaffold.md)
761
- - [Check diagnostics](docs/truthmark/truth/check-diagnostics.md)
762
- - [Installed workflows](docs/truthmark/truth/workflows/overview.md)
758
+ - [Architecture overview](docs/truthmark/engineering/architecture/overview.md)
759
+ - [API and CLI contracts](docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
760
+ - [Init and scaffold behavior](docs/truthmark/engineering/behaviors/init-and-scaffold.md)
761
+ - [Check diagnostics](docs/truthmark/engineering/behaviors/check-diagnostics.md)
762
+ - [Installed workflows](docs/truthmark/engineering/workflows/installed-workflow-runtime.md)
763
763
  - [Repository truth maintenance guide](docs/standards/maintaining-repository-truth.md)
764
764
 
765
765
  ## Design boundaries
package/README.ru.md CHANGED
@@ -394,7 +394,7 @@ Truth Document проверяет реализацию, тесты, файлы
394
394
  Используйте Truth Realize, когда продуктовое или архитектурное решение начинается в docs и код нужно обновить под него.
395
395
 
396
396
  ```text
397
- /truthmark-realize реализуй docs/truthmark/truth/authentication/session-timeout.md в коде
397
+ /truthmark-realize реализуй docs/truthmark/product/capabilities/session-timeout.md в коде
398
398
  ```
399
399
 
400
400
  Truth Realize работает doc-first.
@@ -441,7 +441,7 @@ truthmark check
441
441
  | `truthmark init` | Устанавливает или обновляет настроенные интерфейсы workflow из проверенной config. |
442
442
  | `truthmark check` | Валидирует config, authority, routing, документы с decisions, frontmatter, внутренние ссылки, branch scope, generated surfaces, freshness и coverage diagnostics. |
443
443
 
444
- Необязательные helpers repository-intelligence создают производные материалы для ревью активного checkout, например артефакты RepoIndex, RouteMap, ImpactSet и ограниченные ContextPack. Сгенерированные workflow skill packages также могут предоставлять helper manifests и helper policies, которые вызывают установленные CLI validators `truthmark validate ... --json`; эти helpers являются ускорителями, а не локальными скриптами, упакованными в репозиторий, и не источниками истины. Отдельные Copilot prompts и Gemini commands используют тот же CLI validator contract, когда установленный runner доступен; иначе они должны сообщать видимый skipped helper status и выполнять manual validation.
444
+ Необязательные helpers repository-intelligence создают производные материалы для ревью активного checkout, например RepoIndex, RouteMap, ImpactSet и компактный WorkflowState/action-context JSON. Сгенерированные workflow skill packages также могут предоставлять helper manifests и helper policies, которые вызывают установленные CLI validators `truthmark validate ... --json`; эти helpers являются ускорителями, а не локальными скриптами, упакованными в репозиторий, и не источниками истины. Отдельные Copilot prompts и Gemini commands используют тот же CLI validator contract, когда установленный runner доступен; иначе они должны сообщать видимый skipped helper status и выполнять manual validation.
445
445
 
446
446
  Они не являются источниками истины.
447
447
 
@@ -449,7 +449,7 @@ truthmark check
449
449
  | --- | --- |
450
450
  | `truthmark index` | Строит JSON RepoIndex и RouteMap для активного checkout. |
451
451
  | `truthmark impact --base <ref>` | Сопоставляет измененные файлы с routed truth docs, owning routes, nearby tests и public symbols. |
452
- | `truthmark ctx --workflow <workflow> [--base <ref>]` | Генерирует ограниченный ContextPack для Truth Sync, Truth Document или Truth Realize. Используйте `--format markdown` для человекочитаемой версии. |
452
+ | `truthmark workflow status --workflow <workflow> [--base <ref>] --json` | Возвращает применимость workflow, границы записи, целевые truth docs, checks, helper commands и компактные hints по affected tests. |
453
453
 
454
454
  Структурированный вывод доступен с `--json` там, где поддерживается.
455
455
 
@@ -642,7 +642,7 @@ truthmark check
642
642
  ### Документировать реализованное поведение
643
643
 
644
644
  ```text
645
- /truthmark-document задокументируй реализованный password reset flow в docs/truthmark/truth/authentication
645
+ /truthmark-document задокументируй реализованный password reset flow в docs/truthmark/engineering/behaviors/authentication
646
646
  ```
647
647
 
648
648
  ### Синхронизировать после изменений кода
@@ -654,7 +654,7 @@ truthmark check
654
654
  ### Реализовать doc-first решение
655
655
 
656
656
  ```text
657
- /truthmark-realize реализуй docs/truthmark/truth/billing/invoice-retry-policy.md в коде
657
+ /truthmark-realize реализуй docs/truthmark/product/capabilities/invoice-retry-policy.md в коде
658
658
  ```
659
659
 
660
660
  ### Проверить здоровье истины из терминала
@@ -669,10 +669,10 @@ truthmark check
669
669
  truthmark impact --base main
670
670
  ```
671
671
 
672
- ### Создать workflow ContextPack
672
+ ### Проверить workflow status
673
673
 
674
674
  ```bash
675
- truthmark ctx --workflow truth-sync --base main --format markdown
675
+ truthmark workflow status --workflow truthmark-sync --base main --json
676
676
  ```
677
677
 
678
678
  ### Включить опциональный Portal workflow
@@ -699,7 +699,7 @@ Truthmark V1 сейчас предоставляет:
699
699
  - `truthmark check`
700
700
  - `truthmark index`
701
701
  - `truthmark impact`
702
- - `truthmark ctx`
702
+ - `truthmark workflow status`
703
703
  - branch-scope metadata
704
704
  - управляемые блоки инструкций
705
705
  - сгенерированные интерфейсы workflow Truth Structure
@@ -710,7 +710,7 @@ Truthmark V1 сейчас предоставляет:
710
710
  - сгенерированные интерфейсы workflow Truth Check
711
711
  - опциональные сгенерированные интерфейсы workflow Truthmark Portal
712
712
  - diagnostics для route, authority, decision-structure, frontmatter, links, freshness, generated-surface и coverage
713
- - производные артефакты RepoIndex, RouteMap, ImpactSet и ContextPack
713
+ - производные артефакты RepoIndex, RouteMap, ImpactSet и WorkflowState
714
714
  - host-specific интерфейсы для Codex, Claude Code, GitHub Copilot, OpenCode и Gemini CLI
715
715
 
716
716
  ## Разработка
@@ -755,11 +755,11 @@ README — быстрый путь для оценки и настройки.
755
755
  Подробное текущее поведение живет в `docs/`:
756
756
 
757
757
  - [Индекс документации](docs/README.md)
758
- - [Обзор архитектуры](docs/truthmark/truth/architecture/overview.md)
759
- - [Контракты API и CLI](docs/truthmark/truth/contracts.md)
760
- - [Поведение init и scaffold](docs/truthmark/truth/init-and-scaffold.md)
761
- - [Диагностика check](docs/truthmark/truth/check-diagnostics.md)
762
- - [Установленные workflows](docs/truthmark/truth/workflows/overview.md)
758
+ - [Обзор архитектуры](docs/truthmark/engineering/architecture/overview.md)
759
+ - [Контракты API и CLI](docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
760
+ - [Поведение init и scaffold](docs/truthmark/engineering/behaviors/init-and-scaffold.md)
761
+ - [Диагностика check](docs/truthmark/engineering/behaviors/check-diagnostics.md)
762
+ - [Установленные workflows](docs/truthmark/engineering/workflows/installed-workflow-runtime.md)
763
763
  - [Руководство по поддержанию истины репозитория](docs/standards/maintaining-repository-truth.md)
764
764
 
765
765
  ## Границы дизайна
package/README.zh.md CHANGED
@@ -394,7 +394,7 @@ Truth Document 会把实现、测试、路由文件和现有文档作为证据
394
394
  当产品或架构决策从文档开始,并且代码应更新以匹配时,使用 Truth Realize。
395
395
 
396
396
  ```text
397
- /truthmark-realize 将 docs/truthmark/truth/authentication/session-timeout.md 实现到代码中
397
+ /truthmark-realize 将 docs/truthmark/product/capabilities/session-timeout.md 实现到代码中
398
398
  ```
399
399
 
400
400
  Truth Realize 是 doc-first。
@@ -441,7 +441,7 @@ truthmark check
441
441
  | `truthmark init` | 从已审查配置安装或刷新已配置的工作流接口。 |
442
442
  | `truthmark check` | 验证配置、权限边界、路由、承载决策的文档、frontmatter、内部链接、分支范围、生成接口、freshness 和覆盖率诊断。 |
443
443
 
444
- 可选的仓库情报辅助工具会为当前 checkout 生成派生审查材料,例如 RepoIndex、RouteMap、ImpactSet 和有边界的 ContextPack 产物。生成的工作流 skill packages 也可以暴露 helper manifests 和 helper policies,用来调用已安装的 `truthmark validate ... --json` CLI validators;这些 helpers 是加速器,不是打包进仓库的本地脚本,也不是事实来源。独立的 Copilot prompts 和 Gemini commands 在已安装 runner 可用时使用同一 CLI validator contract;不可用时应报告可见的 skipped helper status,并进行 manual validation。
444
+ 可选的仓库情报辅助工具会为当前 checkout 生成派生审查材料,例如 RepoIndex、RouteMap、ImpactSet 和紧凑的 WorkflowState/action-context JSON。生成的工作流 skill packages 也可以暴露 helper manifests 和 helper policies,用来调用已安装的 `truthmark validate ... --json` CLI validators;这些 helpers 是加速器,不是打包进仓库的本地脚本,也不是事实来源。独立的 Copilot prompts 和 Gemini commands 在已安装 runner 可用时使用同一 CLI validator contract;不可用时应报告可见的 skipped helper status,并进行 manual validation。
445
445
 
446
446
  它们不是事实来源。
447
447
 
@@ -449,7 +449,7 @@ truthmark check
449
449
  | --- | --- |
450
450
  | `truthmark index` | 为当前 checkout 构建 RepoIndex 和 RouteMap JSON。 |
451
451
  | `truthmark impact --base <ref>` | 将变更文件映射到已路由事实文档、所属路由、附近测试和公开符号。 |
452
- | `truthmark ctx --workflow <workflow> [--base <ref>]` | Truth Sync、Truth Document 或 Truth Realize 生成有边界的 ContextPack。使用 `--format markdown` 生成可读版本。 |
452
+ | `truthmark workflow status --workflow <workflow> [--base <ref>] --json` | 返回工作流适用性、写入边界、目标事实文档、检查项、helper commands 和紧凑的受影响测试指引。 |
453
453
 
454
454
  受支持位置可使用 `--json` 获取结构化输出。
455
455
 
@@ -642,7 +642,7 @@ truthmark check
642
642
  ### 记录已实现行为
643
643
 
644
644
  ```text
645
- /truthmark-document 在 docs/truthmark/truth/authentication 下记录已实现的密码重置流程
645
+ /truthmark-document 在 docs/truthmark/engineering/behaviors/authentication 下记录已实现的密码重置流程
646
646
  ```
647
647
 
648
648
  ### 代码变更后同步
@@ -654,7 +654,7 @@ truthmark check
654
654
  ### 实现 doc-first 决策
655
655
 
656
656
  ```text
657
- /truthmark-realize 将 docs/truthmark/truth/billing/invoice-retry-policy.md 实现到代码中
657
+ /truthmark-realize 将 docs/truthmark/product/capabilities/invoice-retry-policy.md 实现到代码中
658
658
  ```
659
659
 
660
660
  ### 从终端审计事实健康
@@ -669,10 +669,10 @@ truthmark check
669
669
  truthmark impact --base main
670
670
  ```
671
671
 
672
- ### 生成工作流 ContextPack
672
+ ### 查看工作流状态
673
673
 
674
674
  ```bash
675
- truthmark ctx --workflow truth-sync --base main --format markdown
675
+ truthmark workflow status --workflow truthmark-sync --base main --json
676
676
  ```
677
677
 
678
678
  ### 启用可选 Portal 工作流
@@ -699,7 +699,7 @@ Truthmark V1 目前提供:
699
699
  - `truthmark check`
700
700
  - `truthmark index`
701
701
  - `truthmark impact`
702
- - `truthmark ctx`
702
+ - `truthmark workflow status`
703
703
  - 分支范围元数据
704
704
  - 受管指令块
705
705
  - 生成的 Truth Structure 工作流接口
@@ -710,7 +710,7 @@ Truthmark V1 目前提供:
710
710
  - 生成的 Truth Check 工作流接口
711
711
  - 可选生成的 Truthmark Portal 工作流接口
712
712
  - 路由、权限边界、决策结构、frontmatter、链接、freshness、生成接口和覆盖率诊断
713
- - 派生的 RepoIndex、RouteMap、ImpactSet 和 ContextPack 产物
713
+ - 派生的 RepoIndex、RouteMap、ImpactSet 和 WorkflowState 产物
714
714
  - 面向 Codex、Claude Code、GitHub Copilot、OpenCode 和 Gemini CLI 的宿主专属接口
715
715
 
716
716
  ## 开发
@@ -755,11 +755,11 @@ README 是评估和设置的快速路径。
755
755
  详细的当前行为位于 `docs/` 下:
756
756
 
757
757
  - [文档索引](docs/README.md)
758
- - [架构概览](docs/truthmark/truth/architecture/overview.md)
759
- - [API 和 CLI 契约](docs/truthmark/truth/contracts.md)
760
- - [Init 和脚手架行为](docs/truthmark/truth/init-and-scaffold.md)
761
- - [Check 诊断](docs/truthmark/truth/check-diagnostics.md)
762
- - [已安装工作流](docs/truthmark/truth/workflows/overview.md)
758
+ - [架构概览](docs/truthmark/engineering/architecture/overview.md)
759
+ - [API 和 CLI 契约](docs/truthmark/engineering/contracts/config-route-and-check-contracts.md)
760
+ - [Init 和脚手架行为](docs/truthmark/engineering/behaviors/init-and-scaffold.md)
761
+ - [Check 诊断](docs/truthmark/engineering/behaviors/check-diagnostics.md)
762
+ - [已安装工作流](docs/truthmark/engineering/workflows/installed-workflow-runtime.md)
763
763
  - [仓库事实维护指南](docs/standards/maintaining-repository-truth.md)
764
764
 
765
765
  ## 设计边界