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 +14 -14
- package/README.es.md +14 -14
- package/README.md +14 -14
- package/README.ru.md +14 -14
- package/README.zh.md +14 -14
- package/dist/main.js +97 -564
- package/dist/main.js.map +1 -1
- package/package.json +1 -2
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/
|
|
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
|
|
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
|
|
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/
|
|
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/
|
|
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-
|
|
672
|
+
### Workflow-Status prüfen
|
|
673
673
|
|
|
674
674
|
```bash
|
|
675
|
-
truthmark
|
|
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
|
|
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
|
|
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/
|
|
759
|
-
- [API- und CLI-Verträge](docs/truthmark/
|
|
760
|
-
- [Init- und Scaffold-Verhalten](docs/truthmark/
|
|
761
|
-
- [Check-Diagnostik](docs/truthmark/
|
|
762
|
-
- [Installierte Workflows](docs/truthmark/
|
|
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/
|
|
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
|
|
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
|
|
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/
|
|
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/
|
|
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
|
-
###
|
|
672
|
+
### Inspeccionar el estado del workflow
|
|
673
673
|
|
|
674
674
|
```bash
|
|
675
|
-
truthmark
|
|
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
|
|
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
|
|
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/
|
|
759
|
-
- [Contratos de API y CLI](docs/truthmark/
|
|
760
|
-
- [Comportamiento de init y scaffold](docs/truthmark/
|
|
761
|
-
- [Diagnósticos de check](docs/truthmark/
|
|
762
|
-
- [Flujos instalados](docs/truthmark/
|
|
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/
|
|
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
|
|
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
|
|
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/
|
|
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/
|
|
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
|
-
###
|
|
672
|
+
### Inspect workflow status
|
|
673
673
|
|
|
674
674
|
```bash
|
|
675
|
-
truthmark
|
|
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
|
|
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
|
|
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/
|
|
759
|
-
- [API and CLI contracts](docs/truthmark/
|
|
760
|
-
- [Init and scaffold behavior](docs/truthmark/
|
|
761
|
-
- [Check diagnostics](docs/truthmark/
|
|
762
|
-
- [Installed workflows](docs/truthmark/
|
|
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/
|
|
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, например
|
|
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
|
|
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/
|
|
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/
|
|
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
|
-
###
|
|
672
|
+
### Проверить workflow status
|
|
673
673
|
|
|
674
674
|
```bash
|
|
675
|
-
truthmark
|
|
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
|
|
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 и
|
|
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/
|
|
759
|
-
- [Контракты API и CLI](docs/truthmark/
|
|
760
|
-
- [Поведение init и scaffold](docs/truthmark/
|
|
761
|
-
- [Диагностика check](docs/truthmark/
|
|
762
|
-
- [Установленные workflows](docs/truthmark/
|
|
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/
|
|
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
|
|
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
|
|
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/
|
|
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/
|
|
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
|
-
###
|
|
672
|
+
### 查看工作流状态
|
|
673
673
|
|
|
674
674
|
```bash
|
|
675
|
-
truthmark
|
|
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
|
|
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 和
|
|
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/
|
|
759
|
-
- [API 和 CLI 契约](docs/truthmark/
|
|
760
|
-
- [Init 和脚手架行为](docs/truthmark/
|
|
761
|
-
- [Check 诊断](docs/truthmark/
|
|
762
|
-
- [已安装工作流](docs/truthmark/
|
|
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
|
## 设计边界
|