truthmark 1.5.0 → 1.6.1

package/README.de.md

@@ -155,6 +155,8 @@ Das installiert oder aktualisiert:
 - verwaltete Instruktionsblöcke
 - KI-orientierte Workflow-Oberflächen für konfigurierte Plattformen
 
+Die Standardvorlagen für Truth-Dokumente werden in [Template Standards](docs/standards/template-standards.md) begründet. Dort werden sie anerkannten Software-Engineering-Referenzen wie ISO/IEC/IEEE 42010, ISO/IEC/IEEE 29148, ISO/IEC/IEEE 12207, ISO/IEC 25010, C4, arc42, OpenAPI, SemVer, Google SRE und Diátaxis zugeordnet.
+
 ### Das Setup validieren
 
 ```bash
@@ -194,6 +196,7 @@ Wenn der Agent funktionalen Code ändert, wirkt Truth Sync als Abschlusskontroll
 | Local-first-Betrieb | Benötigt keinen gehosteten Dienst, Daemon, keine Datenbank und keinen MCP-Server. |
 | Sicherere Schreibgrenzen | Trennt code-first, doc-first, read-only und doc-only Workflows. |
 | Validierung | Meldet Probleme bei Routing, Autorität, Frontmatter, Links, generierten Oberflächen, Branch-Scope, Freshness und Coverage. |
+| Optionales Portal | Erzeugt eine festgeschriebene statische HTML-Präsentationssite aus Markdown-Truth-Dokumenten, wenn es ausdrücklich aktiviert und angefragt wird. |
 
 ## Visueller Überblick
 
@@ -326,6 +329,7 @@ Sie werden von Agenten oder Agenten-Hosts während der Repository-Arbeit genutzt
 | Truth Preview | read-only | Der Agent vor Änderungen wahrscheinliches Routing einschätzen muss. | Liest nur. Autorisiert keine Schreibzugriffe. |
 | Truth Realize | doc-first | Produkt- oder Architektur-Truth-Dokumente führen und Code daran angepasst werden soll. | Aktualisiert nur Code. Der Agent darf die Truth-Dokumente, die er realisiert, nicht bearbeiten. |
 | Truth Check | audit-first | Ein Reviewer oder Agent die Gesundheit der Repository-Wahrheit auditieren muss. | Auditiert und berichtet. |
+| Truthmark Portal | presentation-only | Ein Mensch ausdrücklich eine durchsuchbare statische HTML-Portalansicht über Repository-Truth-Dokumente anfordert. | Schreibt generierte nicht-kanonische statische Dateien nur unter dem konfigurierten Portal-Ausgabeverzeichnis. |
 
 ### Wichtige Unterscheidung
 
@@ -437,6 +441,35 @@ Sie sind keine Quellen der Wahrheit.
 
 Strukturierte Ausgabe ist mit `--json` verfügbar, wo sie unterstützt wird.
 
+## Truthmark Portal
+
+Truthmark Portal ist ein optionaler Präsentations-Workflow für Teams, die eine menschenlesbare Site über ihren festgeschriebenen Truth-Dokumenten möchten.
+
+Er ist bewusst vom Kern-Truth-Workflow getrennt:
+
+- Markdown-Truth-Dokumente bleiben kanonisch.
+- Generiertes Portal-HTML dient nur der Präsentation.
+- Portal wird nur manuell ausgeführt; es läuft nicht als Completion-Gate, Truth-Sync-Schritt, `truthmark check`-Schritt oder automatischer Post-Change-Hook.
+- Portal-Schreibzugriffe bleiben im konfigurierten Ausgabeverzeichnis, sofern der Nutzer den Scope nicht ausdrücklich ändert.
+- Generierte Seiten sollten lokale Assets, Quellen-Provenance und einen sichtbaren Markdown-ist-kanonisch-Hinweis verwenden.
+
+Aktiviere es mit dem namespaced Config-Block:
+
+```yaml
+truthmark-portal:
+  enabled: true
+  output: docs/truthmark-portal
+  template: default
+```
+
+Dann erneut ausführen:
+
+```bash
+truthmark init
+```
+
+Wenn aktiviert, installiert Truthmark host-native Portal-Workflow-Oberflächen für die konfigurierten Plattformen, etwa `/truthmark-portal` oder `/truthmark:portal` je nach Agenten-Host.
+
 ## Konfiguration
 
 Truthmark ist config-first.
@@ -471,6 +504,7 @@ Wichtige Config-Bereiche sind:
 | `docs.routing.area_files_root` | Verzeichnis für delegierte untergeordnete Routendateien. |
 | `docs.routing.default_area` | Dateiname des initial erzeugten untergeordneten Routings ohne Erweiterung. |
 | `docs.routing.max_delegation_depth` | Aktuelle maximale Routing-Delegationstiefe. |
+| `truthmark-portal` | Optionale manuelle Präsentations-Workflow-Einstellungen: `enabled`, `output` und `template`. |
 | `authority` | Geordnete kanonische Dokumente und Globs, die als Repository-Truth-Autorität dienen. |
 | `instruction_targets` | Dateien, die gemeinsam verwaltete Instruktionsblöcke erhalten, etwa `AGENTS.md`. |
 | `frontmatter.required` | Metadatenfelder, die bei Fehlen Error-Diagnostik erzeugen. |
@@ -632,6 +666,21 @@ truthmark impact --base main
 truthmark context --workflow truth-sync --base main --format markdown
 ```
 
+### Optionalen Portal-Workflow aktivieren
+
+```yaml
+truthmark-portal:
+  enabled: true
+  output: docs/truthmark-portal
+  template: default
+```
+
+```bash
+truthmark init
+```
+
+Bitte den Agenten-Host anschließend ausdrücklich, den installierten Portal-Workflow auszuführen, wenn die statische Präsentationssite erzeugt oder aktualisiert werden soll.
+
 ## Projektstatus
 
 Truthmark V1 bietet derzeit:
@@ -650,6 +699,7 @@ Truthmark V1 bietet derzeit:
 - generierte Truth-Preview-Workflow-Oberflächen
 - generierte Truth-Realize-Workflow-Oberflächen
 - generierte Truth-Check-Workflow-Oberflächen
+- optionale generierte Truthmark-Portal-Workflow-Oberflächen
 - Diagnostik für Route, Autorität, Entscheidungsstruktur, Frontmatter, Links, Freshness, generierte Oberflächen und Coverage
 - abgeleitete RepoIndex-, RouteMap-, ImpactSet- und ContextPack-Artefakte
 - host-spezifische Oberflächen für Codex, Claude Code, GitHub Copilot, OpenCode und Gemini CLI
@@ -712,7 +762,7 @@ Es ist nicht:
 - ein gehosteter Dienst
 - ein MCP-Server
 - eine Vektordatenbank
-- ein Generator für Dokumentations-Websites
+- ein kanonischer Dokumentations-Website-Generator oder eine gehostete Docs-Plattform
 - ein CI- oder PR-Enforcement-Produkt
 - ein Ersatz für Tests, Code Review oder technische Führung
 - eine autonome Code-Rewrite-Engine

package/README.es.md

@@ -155,6 +155,8 @@ Esto instala o refresca:
 - bloques de instrucciones administrados
 - superficies de flujo orientadas a IA para las plataformas configuradas
 
+Las plantillas predeterminadas de documentos de verdad se justifican en [Template Standards](docs/standards/template-standards.md), que las mapea a referencias reconocidas de ingeniería de software como ISO/IEC/IEEE 42010, ISO/IEC/IEEE 29148, ISO/IEC/IEEE 12207, ISO/IEC 25010, C4, arc42, OpenAPI, SemVer, Google SRE y Diátaxis.
+
 ### Validar la configuración
 
 ```bash
@@ -194,6 +196,7 @@ Cuando el agente cambia código funcional, Truth Sync actúa como guarda de cier
 | Operación local-first | No requiere servicio alojado, demonio, base de datos ni servidor MCP. |
 | Límites de escritura más seguros | Separa flujos code-first, doc-first, read-only y doc-only. |
 | Validación | Reporta problemas de rutas, autoridad, frontmatter, enlaces, superficies generadas, alcance de rama, frescura y cobertura. |
+| Portal opcional | Genera un sitio HTML estático confirmado desde documentos de verdad Markdown cuando se habilita y solicita explícitamente. |
 
 ## Resumen visual
 
@@ -326,6 +329,7 @@ Los usan agentes o hosts de agentes durante el trabajo en el repositorio. No son
 | Truth Preview | read-only | El agente necesita previsualizar rutas probables antes de editar. | Solo lee. No autoriza escrituras. |
 | Truth Realize | doc-first | Documentos de verdad de producto o arquitectura lideran y el código debe actualizarse para coincidir. | Actualiza solo código. El agente no debe editar los documentos de verdad que está realizando. |
 | Truth Check | audit-first | Un revisor o agente necesita auditar la salud de la verdad del repositorio. | Audita e informa. |
+| Truthmark Portal | presentation-only | Una persona pide explícitamente un Portal HTML estático navegable sobre los documentos de verdad del repositorio. | Escribe solo archivos estáticos generados no canónicos bajo el directorio de salida Portal configurado. |
 
 ### Distinción importante
 
@@ -437,6 +441,35 @@ No son fuentes de verdad.
 
 La salida estructurada está disponible con `--json` donde se admite.
 
+## Truthmark Portal
+
+Truthmark Portal es un flujo opcional de presentación para equipos que quieren un sitio legible por personas sobre sus documentos de verdad confirmados.
+
+Está separado deliberadamente del flujo central de verdad:
+
+- Los documentos de verdad Markdown siguen siendo canónicos.
+- El HTML Portal generado es solo presentación.
+- Portal se ejecuta solo manualmente; no se ejecuta como puerta de finalización, paso de Truth Sync, paso de `truthmark check` ni hook automático post-change.
+- Las escrituras de Portal permanecen dentro del directorio de salida configurado salvo que la persona cambie el alcance explícitamente.
+- Las páginas generadas deben usar assets locales, procedencia de fuentes y un aviso visible de que Markdown es canónico.
+
+Habilítalo con el bloque de configuración con espacio de nombres:
+
+```yaml
+truthmark-portal:
+  enabled: true
+  output: docs/truthmark-portal
+  template: default
+```
+
+Luego vuelve a ejecutar:
+
+```bash
+truthmark init
+```
+
+Cuando está habilitado, Truthmark instala superficies Portal host-native para las plataformas configuradas, como `/truthmark-portal` o `/truthmark:portal` según el host de agente.
+
 ## Configuración
 
 Truthmark es config-first.
@@ -471,6 +504,7 @@ Las áreas importantes de configuración incluyen:
 | `docs.routing.area_files_root` | Directorio para archivos de rutas secundarias delegadas. |
 | `docs.routing.default_area` | Nombre base de la ruta secundaria inicial generada. |
 | `docs.routing.max_delegation_depth` | Profundidad máxima actual de delegación de rutas. |
+| `truthmark-portal` | Ajustes opcionales del flujo manual de presentación: `enabled`, `output` y `template`. |
 | `authority` | Documentos canónicos y globs ordenados usados como autoridad de verdad del repositorio. |
 | `instruction_targets` | Archivos que reciben bloques de instrucciones administrados compartidos, como `AGENTS.md`. |
 | `frontmatter.required` | Campos de metadatos que producen diagnósticos de error cuando faltan. |
@@ -632,6 +666,21 @@ truthmark impact --base main
 truthmark context --workflow truth-sync --base main --format markdown
 ```
 
+### Habilitar el flujo Portal opcional
+
+```yaml
+truthmark-portal:
+  enabled: true
+  output: docs/truthmark-portal
+  template: default
+```
+
+```bash
+truthmark init
+```
+
+Luego pide explícitamente al host de agente que ejecute el flujo Portal instalado cuando quieras generar o refrescar el sitio estático de presentación.
+
 ## Estado del proyecto
 
 Truthmark V1 actualmente proporciona:
@@ -650,6 +699,7 @@ Truthmark V1 actualmente proporciona:
 - superficies generadas de flujo Truth Preview
 - superficies generadas de flujo Truth Realize
 - superficies generadas de flujo Truth Check
+- superficies generadas opcionales de flujo Truthmark Portal
 - diagnósticos de rutas, autoridad, estructura de decisiones, frontmatter, enlaces, frescura, superficies generadas y cobertura
 - artefactos derivados RepoIndex, RouteMap, ImpactSet y ContextPack
 - superficies específicas de host para Codex, Claude Code, GitHub Copilot, OpenCode y Gemini CLI
@@ -712,7 +762,7 @@ No es:
 - un servicio alojado
 - un servidor MCP
 - una base de datos vectorial
-- un generador de sitios de documentación
+- un generador canónico de sitios de documentación o plataforma de docs alojada
 - un producto de enforcement para CI o PR
 - un reemplazo de pruebas, revisión de código o liderazgo técnico
 - un motor autónomo de reescritura de código

package/README.md

@@ -155,6 +155,8 @@ This installs or refreshes:
 - managed instruction blocks
 - AI-facing workflow surfaces for configured platforms
 
+Default truth-doc templates are justified in [Template Standards](docs/standards/template-standards.md), which maps them to recognized software engineering references such as ISO/IEC/IEEE 42010, ISO/IEC/IEEE 29148, ISO/IEC/IEEE 12207, ISO/IEC 25010, C4, arc42, OpenAPI, SemVer, Google SRE, and Diátaxis.
+
 ### Validate the setup
 
 ```bash
@@ -194,6 +196,7 @@ When the agent changes functional code, Truth Sync acts as the finish-time guard
 | Local-first operation | Requires no hosted service, daemon, database, or MCP server. |
 | Safer write boundaries | Separates code-first, doc-first, read-only, and doc-only workflows. |
 | Validation | Reports routing, authority, frontmatter, link, generated-surface, branch-scope, freshness, and coverage issues. |
+| Optional Portal | Generates a committed static HTML presentation site from Markdown truth docs when explicitly enabled and requested. |
 
 ## Visual overview
 
@@ -326,6 +329,7 @@ They are used by agents or agent hosts during repository work. They are not top-
 | Truth Preview | read-only | The agent needs to preview likely routing before edits. | Reads only. Does not authorize writes. |
 | Truth Realize | doc-first | Product or architecture truth docs lead and code should be updated to match. | Updates code only. The agent must not edit the truth docs it is realizing. |
 | Truth Check | audit-first | A reviewer or agent needs to audit repository truth health. | Audits and reports. |
+| Truthmark Portal | presentation-only | A human explicitly asks for a browsable static HTML Portal over repository truth docs. | Writes generated non-canonical static files only under the configured Portal output directory. |
 
 ### Important distinction
 
@@ -437,6 +441,35 @@ They are not sources of truth.
 
 Structured output is available with `--json` where supported.
 
+## Truthmark Portal
+
+Truthmark Portal is an optional presentation workflow for teams that want a human-readable site over their committed truth docs.
+
+It is deliberately separate from the core truth workflow:
+
+- Markdown truth docs remain canonical.
+- Generated Portal HTML is presentation only.
+- Portal is manual-only; it does not run as a completion gate, Truth Sync step, `truthmark check` step, or automatic post-change hook.
+- Portal writes stay inside the configured output directory unless the user explicitly changes scope.
+- Generated pages should use local assets, source provenance, and a visible Markdown-canonical disclaimer.
+
+Enable it with the namespaced config block:
+
+```yaml
+truthmark-portal:
+  enabled: true
+  output: docs/truthmark-portal
+  template: default
+```
+
+Then rerun:
+
+```bash
+truthmark init
+```
+
+When enabled, Truthmark installs host-native Portal workflow surfaces for the configured platforms, such as `/truthmark-portal` or `/truthmark:portal` depending on the agent host.
+
 ## Configuration
 
 Truthmark is config-first.
@@ -471,6 +504,7 @@ Important config areas include:
 | `docs.routing.area_files_root` | Directory for delegated child route files. |
 | `docs.routing.default_area` | Initial scaffolded child route basename. |
 | `docs.routing.max_delegation_depth` | Current maximum route delegation depth. |
+| `truthmark-portal` | Optional manual presentation workflow settings: `enabled`, `output`, and `template`. |
 | `authority` | Ordered canonical docs and globs used as repository truth authority. |
 | `instruction_targets` | Files that receive shared managed instruction blocks, such as `AGENTS.md`. |
 | `frontmatter.required` | Metadata fields that produce error diagnostics when missing. |
@@ -632,6 +666,21 @@ truthmark impact --base main
 truthmark context --workflow truth-sync --base main --format markdown
 ```
 
+### Enable the optional Portal workflow
+
+```yaml
+truthmark-portal:
+  enabled: true
+  output: docs/truthmark-portal
+  template: default
+```
+
+```bash
+truthmark init
+```
+
+Then explicitly ask the agent host to run the installed Portal workflow when you want the static presentation site generated or refreshed.
+
 ## Project status
 
 Truthmark V1 currently provides:
@@ -650,6 +699,7 @@ Truthmark V1 currently provides:
 - generated Truth Preview workflow surfaces
 - generated Truth Realize workflow surfaces
 - generated Truth Check workflow surfaces
+- optional generated Truthmark Portal workflow surfaces
 - route, authority, decision-structure, frontmatter, link, freshness, generated-surface, and coverage diagnostics
 - derived RepoIndex, RouteMap, ImpactSet, and ContextPack artifacts
 - host-specific surfaces for Codex, Claude Code, GitHub Copilot, OpenCode, and Gemini CLI
@@ -712,7 +762,7 @@ It is not:
 - a hosted service
 - an MCP server
 - a vector database
-- a documentation website generator
+- a canonical documentation website generator or hosted docs platform
 - a CI or PR enforcement product
 - a replacement for tests, code review, or technical leadership
 - an autonomous code rewrite engine

package/README.ru.md

@@ -155,6 +155,8 @@ truthmark init
 - управляемые блоки инструкций
 - поверхности рабочих процессов для ИИ для настроенных платформ
 
+Обоснование стандартных шаблонов документов истины находится в [Template Standards](docs/standards/template-standards.md). В документе показано, как они соотносятся с признанными источниками по инженерии ПО, включая ISO/IEC/IEEE 42010, ISO/IEC/IEEE 29148, ISO/IEC/IEEE 12207, ISO/IEC 25010, C4, arc42, OpenAPI, SemVer, Google SRE и Diátaxis.
+
 ### Проверить настройку
 
 ```bash
@@ -194,6 +196,7 @@ truthmark check
 | Local-first работа | Не требует размещенного сервиса, daemon, базы данных или MCP-сервера. |
 | Более безопасные границы записи | Разделяет code-first, doc-first, read-only и doc-only workflows. |
 | Валидация | Сообщает о проблемах маршрутизации, authority, frontmatter, ссылок, generated surfaces, branch scope, freshness и coverage. |
+| Опциональный Portal | Генерирует зафиксированный статический HTML-сайт презентации из Markdown-документов истины, когда он явно включен и запрошен. |
 
 ## Визуальный обзор
 
@@ -326,6 +329,7 @@ truthmark init
 | Truth Preview | read-only | Агенту нужно предварительно понять вероятный routing перед правками. | Только чтение. Не авторизует записи. |
 | Truth Realize | doc-first | Продуктовые или архитектурные документы истины ведут, и код нужно обновить под них. | Обновляет только код. Агент не должен редактировать документы истины, которые реализует. |
 | Truth Check | audit-first | Ревьюеру или агенту нужно проверить здоровье истины репозитория. | Аудитирует и сообщает. |
+| Truthmark Portal | presentation-only | Человек явно просит доступный для просмотра статический HTML Portal по документам истины репозитория. | Пишет только сгенерированные неканонические статические файлы в настроенную директорию вывода Portal. |
 
 ### Важное различие
 
@@ -437,6 +441,35 @@ truthmark check
 
 Структурированный вывод доступен с `--json` там, где поддерживается.
 
+## Truthmark Portal
+
+Truthmark Portal — опциональный презентационный workflow для команд, которым нужен человекочитаемый сайт поверх зафиксированных документов истины.
+
+Он намеренно отделен от основного workflow истины:
+
+- Markdown-документы истины остаются каноническими.
+- Сгенерированный HTML Portal предназначен только для презентации.
+- Portal запускается только вручную; он не выполняется как completion gate, шаг Truth Sync, шаг `truthmark check` или автоматический post-change hook.
+- Записи Portal остаются внутри настроенной директории вывода, если пользователь явно не меняет scope.
+- Сгенерированные страницы должны использовать локальные assets, provenance источников и видимое уведомление, что Markdown является каноническим источником.
+
+Включите его namespaced config-блоком:
+
+```yaml
+truthmark-portal:
+  enabled: true
+  output: docs/truthmark-portal
+  template: default
+```
+
+Затем запустите снова:
+
+```bash
+truthmark init
+```
+
+Когда Portal включен, Truthmark устанавливает host-native Portal workflow surfaces для настроенных платформ, например `/truthmark-portal` или `/truthmark:portal` в зависимости от agent host.
+
 ## Конфигурация
 
 Truthmark работает config-first.
@@ -471,6 +504,7 @@ truthmark init
 | `docs.routing.area_files_root` | Директория для делегированных дочерних файлов маршрутов. |
 | `docs.routing.default_area` | Базовое имя начального scaffolded дочернего маршрута. |
 | `docs.routing.max_delegation_depth` | Текущая максимальная глубина делегирования routing. |
+| `truthmark-portal` | Опциональные настройки ручного презентационного workflow: `enabled`, `output` и `template`. |
 | `authority` | Упорядоченные канонические docs и globs, используемые как authority истины репозитория. |
 | `instruction_targets` | Файлы, которые получают общие управляемые блоки инструкций, например `AGENTS.md`. |
 | `frontmatter.required` | Поля metadata, которые создают error diagnostics при отсутствии. |
@@ -632,6 +666,21 @@ truthmark impact --base main
 truthmark context --workflow truth-sync --base main --format markdown
 ```
 
+### Включить опциональный Portal workflow
+
+```yaml
+truthmark-portal:
+  enabled: true
+  output: docs/truthmark-portal
+  template: default
+```
+
+```bash
+truthmark init
+```
+
+Затем явно попросите agent host выполнить установленный Portal workflow, когда нужно сгенерировать или обновить статический презентационный сайт.
+
 ## Статус проекта
 
 Truthmark V1 сейчас предоставляет:
@@ -650,6 +699,7 @@ Truthmark V1 сейчас предоставляет:
 - сгенерированные поверхности workflow Truth Preview
 - сгенерированные поверхности workflow Truth Realize
 - сгенерированные поверхности workflow Truth Check
+- опциональные сгенерированные поверхности workflow Truthmark Portal
 - diagnostics для route, authority, decision-structure, frontmatter, links, freshness, generated-surface и coverage
 - производные артефакты RepoIndex, RouteMap, ImpactSet и ContextPack
 - host-specific поверхности для Codex, Claude Code, GitHub Copilot, OpenCode и Gemini CLI
@@ -712,7 +762,7 @@ Truthmark намеренно небольшой.
 - размещенным сервисом
 - MCP-сервером
 - векторной базой данных
-- генератором сайтов документации
+- каноническим генератором сайтов документации или hosted docs platform
 - CI- или PR-enforcement продуктом
 - заменой tests, code review или technical leadership
 - автономным движком переписывания кода

package/README.zh.md

@@ -155,6 +155,8 @@ truthmark init
 - 受管说明块
 - 已配置平台的面向 AI 工作流表面
 
+默认事实文档模板的依据见 [Template Standards](docs/standards/template-standards.md)。该文档说明这些模板如何对齐 ISO/IEC/IEEE 42010、ISO/IEC/IEEE 29148、ISO/IEC/IEEE 12207、ISO/IEC 25010、C4、arc42、OpenAPI、SemVer、Google SRE 和 Diátaxis 等公认软件工程参考。
+
 ### 验证设置
 
 ```bash
@@ -196,6 +198,7 @@ truthmark check
 | 本地优先运行 | 不需要托管服务、守护进程、数据库或 MCP 服务器。 |
 | 更安全的写入边界 | 区分 code-first、doc-first、read-only 和 doc-only 工作流。 |
 | 验证 | 报告路由、权限边界、frontmatter、链接、生成表面、分支范围、freshness 和覆盖率问题。 |
+| 可选 Portal | 在明确启用并请求时，从 Markdown 事实文档生成已提交的静态 HTML 展示站点。 |
 
 ## 视觉概览
 
@@ -328,6 +331,7 @@ truthmark init
 | Truth Preview | read-only | 代理需要在编辑前预览可能的路由。 | 只读。不授权写入。 |
 | Truth Realize | doc-first | 产品或架构事实文档在前，代码应更新以匹配它们。 | 只更新代码。代理不能编辑它正在实现的事实文档。 |
 | Truth Check | audit-first | 审查者或代理需要审计仓库事实健康状况。 | 审计并报告。 |
+| Truthmark Portal | presentation-only | 人类明确要求为仓库事实文档生成可浏览的静态 HTML Portal。 | 只在配置的 Portal 输出目录下写入生成的非规范静态文件。 |
 
 ### 重要区别
 
@@ -439,6 +443,35 @@ truthmark check
 
 受支持位置可使用 `--json` 获取结构化输出。
 
+## Truthmark Portal
+
+Truthmark Portal 是一个可选的展示工作流，适合想要基于已提交 truth 文档生成面向人的可读站点的团队。
+
+它有意与核心 truth 工作流分离：
+
+- Markdown truth 文档仍然是规范来源。
+- 生成的 Portal HTML 仅用于展示。
+- Portal 只能手动运行；它不会作为完成门禁、Truth Sync 步骤、`truthmark check` 步骤或自动 post-change hook 运行。
+- 除非用户明确改变范围，Portal 写入必须留在配置的输出目录内。
+- 生成页面应使用本地 assets、来源 provenance，并显示 Markdown 规范来源免责声明。
+
+用这个命名空间配置块启用它：
+
+```yaml
+truthmark-portal:
+  enabled: true
+  output: docs/truthmark-portal
+  template: default
+```
+
+然后重新运行：
+
+```bash
+truthmark init
+```
+
+启用后，Truthmark 会为已配置平台安装宿主原生 Portal 工作流表面，例如 `/truthmark-portal` 或 `/truthmark:portal`，具体取决于代理宿主。
+
 ## 配置
 
 Truthmark 是 config-first。
@@ -473,6 +506,7 @@ truthmark init
 | `docs.routing.area_files_root` | 委托子路由文件目录。 |
 | `docs.routing.default_area` | 初始脚手架子路由 basename。 |
 | `docs.routing.max_delegation_depth` | 当前最大路由委托深度。 |
+| `truthmark-portal` | 可选手动展示工作流设置：`enabled`、`output` 和 `template`。 |
 | `authority` | 用作仓库事实权威的有序规范文档和 glob。 |
 | `instruction_targets` | 接收共享受管说明块的文件，例如 `AGENTS.md`。 |
 | `frontmatter.required` | 缺失时产生错误诊断的元数据字段。 |
@@ -634,6 +668,21 @@ truthmark impact --base main
 truthmark context --workflow truth-sync --base main --format markdown
 ```
 
+### 启用可选 Portal 工作流
+
+```yaml
+truthmark-portal:
+  enabled: true
+  output: docs/truthmark-portal
+  template: default
+```
+
+```bash
+truthmark init
+```
+
+当你想生成或刷新静态展示站点时，再明确要求代理宿主运行已安装的 Portal 工作流。
+
 ## 项目状态
 
 Truthmark V1 目前提供：
@@ -652,6 +701,7 @@ Truthmark V1 目前提供：
 - 生成的 Truth Preview 工作流表面
 - 生成的 Truth Realize 工作流表面
 - 生成的 Truth Check 工作流表面
+- 可选生成的 Truthmark Portal 工作流表面
 - 路由、权限边界、决策结构、frontmatter、链接、freshness、生成表面和覆盖率诊断
 - 派生的 RepoIndex、RouteMap、ImpactSet 和 ContextPack 产物
 - 面向 Codex、Claude Code、GitHub Copilot、OpenCode 和 Gemini CLI 的宿主专属表面
@@ -714,7 +764,7 @@ Truthmark 有意保持小而清晰。
 - 托管服务
 - MCP 服务器
 - 向量数据库
-- 文档网站生成器
+- 规范文档网站生成器或托管文档平台
 - CI 或 PR 强制执行产品
 - 测试、代码审查或技术领导力的替代品
 - 自主代码重写引擎