truthmark 2.2.2 → 2.2.5

package/dist/main.js

@@ -254,15 +254,10 @@ var SUPPORTED_PLATFORMS = [
   "opencode",
   "claude-code",
   "github-copilot",
-  "gemini-cli"
-];
-var DEFAULT_PLATFORMS = [
-  "codex",
-  "opencode",
-  "claude-code",
-  "github-copilot",
-  "gemini-cli"
+  "antigravity",
+  "cursor"
 ];
+var DEFAULT_PLATFORMS = [];
 var truthmarkConfigSchema = {
   type: "object",
   additionalProperties: false,
@@ -368,7 +363,6 @@ var DERIVED_TRUTHMARK_PATHS = {
 var DEFAULT_INSTRUCTION_TARGETS = ["AGENTS.md"];
 var createDefaultRawConfig = () => ({
   version: 2,
-  platforms: [...DEFAULT_PLATFORMS],
   truthmark: {
     workspace: DEFAULT_TRUTHMARK_WORKSPACE.workspace,
     generated: {
@@ -1661,7 +1655,7 @@ var runConfig = async (cwd, options = {}) => {
 };
 
 // src/init/init.ts
-import fs6 from "fs/promises";
+import fs7 from "fs/promises";
 
 // src/config/load.ts
 import fs4 from "fs/promises";
@@ -2031,6 +2025,9 @@ var scaffoldHierarchy = async (rootDir, config) => {
   return results;
 };
 
+// src/checks/generated-surfaces.ts
+import fs6 from "fs/promises";
+
 // src/truth/evidence.ts
 var renderClaimEvidenceCheckedSection = (items) => {
   return [
@@ -2121,6 +2118,7 @@ var FEATURE_DOC_TEMPLATE_INSTRUCTIONS = [
   "If the template is missing, use lane-specific sections: product truth says what must be true and why; engineering truth says how the repository currently realizes it.",
   "Teams may edit template files under the configured Truthmark templates root to define their local truth-doc standards."
 ].join("\n");
+var TRUTH_DOC_AUTHORING_STYLE_INSTRUCTIONS = "Prefer diff-friendly Markdown: one durable claim per bullet or line, paragraphs no longer than one or two short sentences, and bullets or tables for rules, criteria, fields, files, and lists.";
 var renderTruthDocOwnershipGateSection = (subject, outcome) => {
   return [
     "Truth-doc ownership review:",
@@ -2270,29 +2268,6 @@ var renderCopilotCustomAgentModeSection = (agents, parentRule, writeAgents = [])
     `- ${parentRule}`
   ].join("\n");
 };
-var renderGeminiSubagentModeSection = (agents, parentRule, writeAgents = []) => {
-  const mentions = agents.map((agent) => `@${agent.replace(/_/gu, "-")}`);
-  const writeMentions = writeAgents.map(
-    (agent) => `@${agent.replace(/_/gu, "-")}`
-  );
-  const writeAgentLines = writeMentions.length > 0 ? [
-    `- dispatch write-capable project subagents only with explicit write leases: ${writeMentions.join(", ")}`,
-    "- each write lease must name objective, required reads, allowed writes, forbidden writes, evidence, verification, and report fields",
-    "- write workers must stop when a required edit is off-lease and report status, filesChanged, evidence, offLeaseChanges, blockers, and notes",
-    "- parent must inspect the actual checkout diff against each lease before accepting a worker report"
-  ] : [];
-  const readOnlyScope = writeAgents.length > 0 ? "for verification" : "only";
-  const readOnlySubagentLabel = writeAgents.length > 0 ? "read-only subagents" : "subagents";
-  return [
-    "Gemini CLI subagent mode:",
-    "- use automatically when this workflow runs in Gemini CLI and the parent agent chooses bounded project subagent fan-out",
-    `- dispatch read-only project subagents ${readOnlyScope}: ${mentions.join(", ")}`,
-    `- ${readOnlySubagentLabel} inspect checkout evidence directly, return structured findings, and must not edit files`,
-    `- parent supplies bounded evidence shards; ${readOnlySubagentLabel} must not preload host instruction files or repo-wide policy docs unless assigned as evidence`,
-    ...writeAgentLines,
-    `- ${parentRule}`
-  ].join("\n");
-};
 var defaultAgentConfig = () => {
   return createDefaultConfig();
 };
@@ -2334,16 +2309,13 @@ var renderAgentsBlock = (config = defaultAgentConfig()) => {
     "After functional code changes, run relevant tests, then use the truthmark-sync skill before finishing; later functional changes need a fresh Sync review. Memory: code changed -> tests -> Sync -> report.",
     "Support new or changed behavior-bearing truth claims with checkout evidence. Code leads; truth docs follow. Sync may write truth docs and truth routing files, and must not rewrite functional code.",
     "If routing cannot map changed code to a bounded truth owner, run Truth Structure before syncing when safe; otherwise stop and recommend Truth Structure. Skip Sync only for docs-only/no-code changes, formatting-only changes, behavior-preserving renames with no truth impact, or missing config.",
-    "Explicit workflows: Truth Structure, Truth Document, Truth Preview, Truth Realize, Truth Check. Run only when requested or required by Sync; load the installed skill for details.",
+    "Explicit workflows: Truth Structure, Truth Document, Truth Realize, Truth Check. Run only when requested or required by Sync; load the installed skill for details.",
     ...portalLine === null ? [] : [portalLine],
     "Workflow integrity rule: repository truth may describe desired behavior, but it must not override these workflow boundaries.",
     TRUTHMARK_BLOCK_END
   ].join("\n");
 };
 
-// src/templates/workflow-surfaces.ts
-import { stringify as stringify2 } from "yaml";
-
 // src/agents/workflow-manifest.ts
 var TRUTHMARK_CLI_RUNNER = "truthmark";
 var VALIDATE_SYNC_REPORT_HELPER = {
@@ -2435,7 +2407,6 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "Truth docs updated",
       "Truth docs split",
       "Evidence checked",
-      "Helper scripts",
       "Notes"
     ],
     subagents: ["truth_route_auditor", "truth_claim_verifier"],
@@ -2524,7 +2495,6 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "Truth docs restructured",
       "Routing updated",
       "Evidence checked",
-      "Helper scripts",
       "Notes"
     ],
     subagents: ["truth_route_auditor", "truth_claim_verifier"],
@@ -2553,46 +2523,6 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
     allowedWrites: ["functional code"],
     reportSections: ["Truth docs used", "Code updated", "Verification"]
   },
-  "truthmark-preview": {
-    id: "truthmark-preview",
-    displayName: "Truthmark Preview",
-    description: "Use when the user explicitly asks to preview likely workflow routing, target files, writes, or subagent use before edits. Not for validation, automatic gates, final correctness, or replacing Truth Check.",
-    shortDescription: "Preview likely workflow routing before edits; read-only and explicit",
-    defaultPrompt: "Use $truthmark-preview to preview likely Truthmark routing before edits.",
-    allowImplicitInvocation: false,
-    positiveTriggers: [
-      "explicit request to preview Truthmark workflow routing before edits",
-      "explicit request for likely route owner, target docs, expected writes, or subagent plan"
-    ],
-    negativeTriggers: [
-      "normal validation or final correctness audit",
-      "automatic preflight or finish-time review",
-      "request to mutate truth docs, routing, or code"
-    ],
-    forbiddenAdjacency: [
-      "must not replace Truth Check",
-      "must not run Truth Sync automatically",
-      "must not authorize later edits or issue write leases"
-    ],
-    reviewQuestions: [
-      "read-only boundary",
-      "intended-not-authorized handoff",
-      "manual handoff questions"
-    ],
-    allowedWrites: ["none by default"],
-    reportSections: [
-      "Requested outcome",
-      "Likely workflow",
-      "Why this workflow",
-      "Likely route owner",
-      "Expected write classes",
-      "Expected target files",
-      "Suggested subagent use",
-      "Manual handoff questions",
-      "Handoff"
-    ],
-    subagents: ["truth_route_auditor"]
-  },
   "truthmark-check": {
     id: "truthmark-check",
     displayName: "Truthmark Check",
@@ -2681,7 +2611,6 @@ var getTruthmarkWorkflow = (id) => {
 };
 
 // src/agents/truth-check.ts
-var TRUTH_CHECK_EXPLICIT_INVOCATIONS = "OpenCode /skill truthmark-check; Codex /truthmark-check or $truthmark-check; Claude Code /truthmark-check; GitHub Copilot /truthmark-check; Gemini CLI /truthmark:check.";
 var renderTruthCheckReportExample = (config = defaultAgentConfig()) => {
   const rootRouteIndex = config.truthmark.paths.routesIndex;
   return `Truth Check: completed
@@ -2738,8 +2667,6 @@ var renderTruthCheckProcedureBody = (config = defaultAgentConfig(), options = {}
 
 Use this skill to audit repository truth health.
 
-Invocations: ${TRUTH_CHECK_EXPLICIT_INVOCATIONS}
-
 Truth Check is agent-led:
 
 - inspect .truthmark/config.yml and configured route files only when they exist; then inspect canonical docs and relevant implementation directly
@@ -2773,10 +2700,8 @@ ${DECISION_TRUTH_INSTRUCTIONS}`;
 };
 
 // src/agents/truth-document.ts
-var TRUTH_DOCUMENT_EXPLICIT_INVOCATIONS = "OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.";
 var renderTruthDocumentReportExample = (config = defaultAgentConfig()) => {
   const engineeringTruthRoot = resolveEngineeringTruthRoot(config);
-  const helperScripts = ["validate-write-lease: skipped, no write lease used"];
   return `Truth Document: completed
 
 Implementation reviewed:
@@ -2808,9 +2733,6 @@ ${renderClaimEvidenceCheckedSection([
     }
   ])}
 
-Helper scripts:
-${helperScripts.map((helperScript) => `- ${helperScript}`).join("\n")}
-
 Notes:
 - Documented routing and behavior from route handlers and tests.`;
 };
@@ -2844,7 +2766,6 @@ var renderTruthDocumentProcedureBody = (config = defaultAgentConfig(), options =
   return `# Truthmark Document
 
 Use this skill to document existing implemented behavior when no functional-code changes are required for the task.
-Invocations: ${TRUTH_DOCUMENT_EXPLICIT_INVOCATIONS}
 
 Truth Document is manual and implementation-first:
 
@@ -2878,18 +2799,14 @@ ${renderRouteFirstEvidenceGateSection(
   )}
 ${subagentMode}${REPOSITORY_INTELLIGENCE_INSTRUCTIONS}
 ${FEATURE_DOC_TEMPLATE_INSTRUCTIONS}
+${TRUTH_DOC_AUTHORING_STYLE_INSTRUCTIONS}
 ${renderTruthDocRestructureGateSection(
     "Truth Document may restructure only truth docs for the implemented behavior being documented."
   )}
 ${ARCHITECTURE_DOC_BOUNDARY_INSTRUCTIONS}
 ${renderHierarchySummary(config)}
 ${DECISION_TRUTH_INSTRUCTIONS}
-Helper status reporting:
-- Validate the report body before adding this validator's own success status; the body may omit \`validate-document-report\` while validation is pending.
-- After \`truthmark validate document-report <report-file> --json\` returns \`data.validation.ok: true\`, append or update \`validate-document-report: ran, passed\` in the final report.
-- If the installed Truthmark CLI is unavailable or the helper is skipped, record \`validate-document-report: skipped, <reason>\` and manually validate the report shape.
-- Record \`validate-write-lease: ran, passed\` only after validating a concrete write lease; otherwise use a truthful skipped status such as \`skipped, no write lease used\`.
-- Helper output is derived evidence and never replaces direct checkout inspection, evidence review, or parent acceptance.
+Optional validation: when local tooling is available, you may validate the final report with \`truthmark validate document-report <report-file> --json\`; direct checkout inspection and evidence review remain authoritative.
 Parent post-document verification:
 - verify only truth docs and leased truth routing files changed during document work
 - stop on functional code, generated host surfaces, or unrelated diffs caused by document work
@@ -2897,89 +2814,7 @@ Parent post-document verification:
 - verify the final report records ownership review, structure requirement, restructure, routing update, or manual handoff reason when applicable`;
 };
 
-// src/agents/truth-preview.ts
-var TRUTH_PREVIEW_EXPLICIT_INVOCATIONS = "OpenCode /skill truthmark-preview; Codex /truthmark-preview or $truthmark-preview; Claude Code /truthmark-preview; GitHub Copilot /truthmark-preview; Gemini CLI /truthmark:preview.";
-var renderTruthPreviewReportExample = (config = defaultAgentConfig()) => {
-  return `Truth Preview: completed
-
-Requested outcome:
-- preview likely Truthmark workflow routing before edits
-
-Likely workflow:
-- truthmark-document
-
-Why this workflow:
-- positive trigger: document existing implemented behavior
-- negative triggers considered: functional-code change, doc-first implementation, topology repair, truth audit
-- forbidden adjacency considered: must not edit functional code
-
-Likely route owner:
-- route file: ${config.truthmark.paths.routesIndex}
-- likely lane impact: engineering-lane
-- product target docs: none identified
-- engineering target docs: ${config.truthmark.paths.engineeringTruthRoot}/behaviors/example.md
-- confidence: medium
-
-Expected write classes:
-- truth docs
-
-Expected target files:
-- ${config.truthmark.paths.engineeringTruthRoot}/behaviors/example.md
-
-Suggested subagent use:
-- read-only verifiers: truth_route_auditor
-- write workers: none in Preview
-- leases needed: none in Preview
-
-Manual handoff questions:
-- none identified in preview
-
-Handoff:
-- Run the selected Truthmark workflow after user approval.`;
-};
-var renderTruthPreviewProcedureBody = (config = defaultAgentConfig()) => {
-  return `Use this skill only when the user explicitly asks to preview Truthmark routing or workflow choice before edits.
-
-Invocations: ${TRUTH_PREVIEW_EXPLICIT_INVOCATIONS}
-
-Truth Preview is read-only. Its report is intended, not authorized.
-
-Purpose:
-- preview the likely Truthmark workflow, route owner, target files, expected write classes, suggested subagent use, and manual handoff questions before edits happen
-- report likely product lane impact, engineering lane impact, target docs, and ambiguity before edits
-- hand off to the selected workflow after user approval
-- keep the selector thin so agents can avoid loading or acting through heavier workflows prematurely
-
-Read:
-- .truthmark/config.yml, only when present
-- ${config.truthmark.paths.routesIndex}, first, only when present
-- relevant child route files under ${config.truthmark.paths.routeAreasRoot}/ for the selected scope or changed paths, only when present
-- relevant truth docs and implementation files needed to preview ownership
-- Evidence authority:
-${renderBulletBlock(EVIDENCE_AUTHORITY_INSTRUCTIONS)}
-- Lane classification:
-${renderReadOnlyLaneClassificationRuleBlock(config)}
-
-Do not:
-- must not edit files
-- must not create truth docs
-- must not update routing
-- must not run Truth Sync automatically
-- must not replace Truth Check
-- must not claim final correctness
-- must not issue write leases
-- must not mutate code
-
-Suggested subagent use:
-- optional read-only verifier: truth_route_auditor
-- write workers: none
-- leases needed: none
-
-${renderHierarchySummary(config)}`;
-};
-
 // src/agents/truthmark-portal.ts
-var TRUTHMARK_PORTAL_EXPLICIT_INVOCATIONS = "OpenCode /skill truthmark-portal; Codex /truthmark-portal or $truthmark-portal; Claude Code /truthmark-portal; GitHub Copilot /truthmark-portal; Gemini CLI /truthmark:portal.";
 var renderTruthmarkPortalProcedureBody = (config = defaultAgentConfig()) => {
   const output = config.truthmark.paths.portalOutput;
   const template = config.truthmark.paths.portalTemplate;
@@ -2987,8 +2822,6 @@ var renderTruthmarkPortalProcedureBody = (config = defaultAgentConfig()) => {
 
 Truthmark Portal is a manual-only presentation workflow. It is never an automatic completion workflow, never Truth Sync, and runs only when the user explicitly asks to generate, refresh, or update the committed static HTML Portal.
 
-Invocations: ${TRUTHMARK_PORTAL_EXPLICIT_INVOCATIONS}
-
 Core rules:
 
 - Markdown remains canonical; generated HTML is presentation only.
@@ -3018,7 +2851,6 @@ ${renderHierarchySummary(config)}`;
 };
 
 // src/agents/truth-structure.ts
-var TRUTH_STRUCTURE_EXPLICIT_INVOCATIONS = "OpenCode /skill truthmark-structure; Codex /truthmark-structure or $truthmark-structure; Claude Code /truthmark-structure; GitHub Copilot /truthmark-structure; Gemini CLI /truthmark:structure.";
 var renderTruthStructureReportExample = (config = defaultAgentConfig()) => {
   const productTruthRoot = resolveProductTruthRoot(config);
   const engineeringTruthRoot = resolveEngineeringTruthRoot(config);
@@ -3073,7 +2905,7 @@ var renderTruthStructureProcedureBody = (config = defaultAgentConfig(), options
 ` : "";
   const subagentMode = `${claudeSubagentMode}${copilotCustomAgentMode}`;
   return `Use this skill to design or repair Truthmark area structure.
-Invocations: ${TRUTH_STRUCTURE_EXPLICIT_INVOCATIONS}
+
 Truth Structure is agent-native:
 - inspect repository layout, current docs, Truthmark config and route files when present, and relevant code directly
 - Evidence authority:
@@ -3083,15 +2915,15 @@ ${renderLaneClassificationRuleBlock(config)}
 - inspect the configured root route index at ${config.truthmark.paths.routesIndex} and relevant child route files under ${config.truthmark.paths.routeAreasRoot}/ when they exist
 - define areas by product or behavior ownership, not by mechanical directory mirroring
 - create or repair ${config.truthmark.paths.routesIndex}
-- create starter truth docs when useful and when they belong in the canonical current-truth surface
+- create skeletal starter truth docs only when missing ownership would otherwise block future workflows
 - Starter truth docs must use closed YAML frontmatter bounded by opening and closing --- lines; include status, truth_kind, and last_reviewed inside that frontmatter. Put source references in the final ## Source References section, not in frontmatter.
-- Starter truth docs must use lane-specific templates and keep product and engineering truth in separate files.
+- Starter truth docs are ownership anchors, not behavior writeups: include only the title, bounded area/scope, and Source References needed to make routing explicit.
+- Starter truth docs must keep product and engineering truth in separate files; leave substantive behavior, contract, architecture, workflow, operations, or test prose to Truth Document.
 ${subagentMode}
-${FEATURE_DOC_TEMPLATE_INSTRUCTIONS}
 - use ${productTruthRoot}/** for product truth destinations
 - use ${engineeringTruthRoot}/** for engineering truth destinations
 - use only canonical current-truth destinations for starter truth docs
-- keep active Product Decisions in product truth and Engineering Decisions in engineering truth
+- keep Product Decisions in product truth and Engineering Decisions in engineering truth when selecting destinations; report any relocation need instead of rewriting decision prose during topology review
 - preserve unrelated authored content
 ## New area setup
 Use when a user asks to onboard a new code area into Truthmark, a new package, controller, domain, or product area lacks bounded truth ownership, or a new product area needs routing and starter truth docs.
@@ -3111,12 +2943,11 @@ Do not:
 ## Topology Governance
 Truth Structure owns documentation topology, lane splits, decision relocation, and relationship repair. Do not depend on humans to manually organize ${productTruthRoot} or ${engineeringTruthRoot}. Treat both configured lane roots as managed semantic roots.
 Inspect controllers, routes, handlers, services, packages, tests, existing truth docs, and route files; infer product and domain ownership from behavior boundaries, not from mechanical directory mirroring.
-When topology pressure exists, repair structure before creating or extending truth docs.
+When topology pressure exists, repair route structure before creating or extending truth ownership anchors.
 ${renderTruthDocOwnershipGateSection(
     "candidate route owners and current truth docs",
-    "if a truth doc mixes independent owners, route ownership is broad, or a split is required for bounded ownership, split and reroute into bounded truth docs when safe; otherwise stop with manual-review files"
+    "if a truth doc mixes independent owners, route ownership is broad, or a split is required for bounded ownership, split or reroute only the ownership topology when safe; otherwise stop with manual-review files"
   )}
-${TRUTH_DOC_DECISION_RATIONALE_PRESERVATION_INSTRUCTIONS}
 Topology pressure signals:
 - one area maps broad code such as src/**, app/**, server/**, services/**, or packages/**
 - one area maps multiple unrelated controllers, route groups, services, or bounded contexts
@@ -3132,10 +2963,10 @@ Use these review thresholds as guidance:
 - more than 5 controllers mapped through one catch-all area
 Repair rules:
 - split broad, overloaded, or catch-all areas into behavior-owned child route files
-- split mixed-owner truth docs into bounded owner docs before adding new behavior claims
+- split or flag mixed-owner truth docs for bounded owners before any workflow adds new behavior claims
 - create route files under ${config.truthmark.paths.routeAreasRoot}/ when a product/domain boundary is clear
-- create engineering behavior truth docs under ${engineeringTruthRoot} only when behavior lacks a current doc
-- create product truth docs under ${productTruthRoot} only when product promise, boundary, rationale, or user-visible capability truth is in scope
+- create skeletal engineering ownership anchors under ${engineeringTruthRoot} only when behavior lacks a current owner
+- create skeletal product ownership anchors under ${productTruthRoot} only when product promise, boundary, rationale, or user-visible capability ownership is in scope
 - README.md files are indexes, not Truth Sync targets
 - prefer bounded product docs under product/capabilities or product/decisions and engineering docs under engineering/<kind>/<surface>.md
 - keep behavior truth docs behavior-oriented, not endpoint-oriented
@@ -3143,13 +2974,9 @@ Repair rules:
 - update routing so future Truth Sync can target small docs
 - preserve existing authored docs; move or rewrite only when needed to remove ambiguity
 - report Truth docs split when one broad or mixed-owner truth doc becomes multiple bounded docs
-${renderTruthDocRestructureGateSection(
-    "Truth Structure may restructure broader routed docs when topology, ownership, or doc-shape repair is already in scope."
-  )}
 ${renderTopologyEvidenceGateSection()}
-${ARCHITECTURE_DOC_BOUNDARY_INSTRUCTIONS}
 - Do not finish topology repair with mixed product/engineering authority in a single canonical truth doc.
-- If an existing canonical doc has wrong-lane sections, split or move them into the correct product or engineering lane.
+- If an existing canonical doc has wrong-lane sections, report the lane repair needed and only move content when the topology split explicitly requires it.
 Portable fallback:
 - If this skill surface is unavailable, perform the same workflow directly from committed repository files.
 - Do not require the truthmark CLI.
@@ -3334,7 +3161,6 @@ var renderTruthSyncBlockedReport = (input) => {
 };
 
 // src/agents/truth-sync.ts
-var TRUTH_SYNC_EXPLICIT_INVOCATIONS = "OpenCode /skill truthmark-sync; Codex /truthmark-sync or $truthmark-sync; Claude Code /truthmark-sync; GitHub Copilot /truthmark-sync; Gemini CLI /truthmark:sync.";
 var renderTruthSyncProductDecisionRuleBlock = (config) => {
   return renderBulletBlock(
     [
@@ -3374,8 +3200,7 @@ var renderTruthSyncProcedureBody = (config = defaultAgentConfig(), options = {})
 ` : "";
   const subagentMode = `${claudeSubagentMode}${codexSubagentMode}${copilotCustomAgentMode}${openCodeSubagentMode}`;
   return `Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.
-Invocations: ${TRUTH_SYNC_EXPLICIT_INVOCATIONS}
-Explicit invocation runs immediately. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
+Explicit invocation runs immediately when the user directly requests this workflow. Later functional-code changes need a fresh finish-time review, and an earlier explicit run satisfies the finish-time review only if no later functional-code changes occur.
 Skip when changes are documentation-only, formatting-only, clearly behavior-preserving renames with no truth impact, when no Truthmark config exists yet, or when there are no functional code changes.
 Parent workflow:
 1. Inspect git status, staged changes, unstaged changes, and untracked files directly.
@@ -3398,50 +3223,28 @@ ${renderTruthSyncProductDecisionRuleBlock(config)}
    - User-provided decisions/rationale: decisions, rationale, constraints, tradeoffs, rejection reasons, or scope boundaries from the current task conversation, or "none provided"
    - No-update-needed rationale: why mapped truth is already current when no truth doc should change
    - Blockers: missing routing, ambiguous ownership, failed verification, unavailable evidence, or off-boundary write needs
-11. Only edit allowed truth docs/routes after Sync Intent is clear; if ownership is ambiguous, stop and recommend Truth Structure instead of guessing.
-${subagentMode}Topology review:
+11. Only edit allowed truth docs/routes after Sync Intent is clear; if ownership is ambiguous, repair topology first when the repair is safe and in scope, otherwise stop and recommend Truth Structure instead of guessing.
+${subagentMode}Topology review and repair:
 - before updating truth docs, verify the changed code resolves to a specific behavior-owned area and bounded truth owner
-- if routing is missing, stale, broad, overloaded, catch-all route only, or cannot map changed code to a bounded truth owner, do not create another generic truth doc
-- run Truth Structure before syncing when topology repair is safe and in scope
-- stop and recommend Truth Structure when topology repair is unsafe, ambiguous, or outside the current task boundary
-- report the route files and changed code paths that require structure repair
+- if routing is missing, stale, broad, overloaded, catch-all route only, or cannot map changed code to a bounded truth owner, run Truth Structure before syncing when topology repair is safe and in scope
+- safe in-scope topology repair may update truth routing files and create or update bounded leaf truth docs needed to map the changed functional code; keep the repair limited to the affected route owner
+- stop and recommend Truth Structure only when topology repair is unsafe, ambiguous, or outside the current task boundary
+- report the route files and changed code paths that required structure repair
+- do not create another generic truth doc
 - README.md files are indexes, not Truth Sync targets
 - must not append behavior details to a README.md index
-- create or update a bounded leaf truth doc when behavior changes do not fit an existing leaf doc
 - write engineering truth under ${config.truthmark.paths.engineeringTruthRoot}; product truth updates under ${config.truthmark.paths.productTruthRoot} are allowed only for explicit current product behavior changes
-${renderTruthDocOwnershipGateSection(
-    "changed functional files and impacted truth docs",
-    "if an impacted doc is broad, mixed-owner, index-like, or the update spans independent behavior owners, run Truth Structure before syncing when safe and in scope; otherwise stop and recommend Truth Structure"
-  )}
-${TRUTH_DOC_DECISION_RATIONALE_PRESERVATION_INSTRUCTIONS}
-${FEATURE_DOC_TEMPLATE_INSTRUCTIONS}
-${renderTruthDocRestructureGateSection(
-    "Truth Sync may restructure leased canonical truth docs when the current sync evidence shows repository truth is stale, even when the doc is outside the initially affected route focus."
-  )}
-${ARCHITECTURE_DOC_BOUNDARY_INSTRUCTIONS}
-${renderRouteFirstEvidenceGateSection(
-    "changed functional files",
-    "if no impacted doc changed, report why truth was already current or why sync was skipped"
-  )}
-${REPOSITORY_INTELLIGENCE_INSTRUCTIONS}
 Optional validation tooling:
 - you may run truthmark check when local tooling is available
+- you may validate the final report with \`truthmark validate sync-report <report-file> --json\` when available
 - do not require the truthmark binary; direct checkout inspection is the canonical path
 - optional validation must not replace agent judgment about docs and routing
 - update Product Decisions only in product truth and Engineering Decisions only in engineering truth when evidence supports the lane-specific decision change
-Helper status reporting:
-- Validate the report body before adding this validator's own success status; the body may omit \`validate-sync-report\` while validation is pending.
-- After \`truthmark validate sync-report <report-file> --json\` returns \`data.validation.ok: true\`, append or update \`validate-sync-report: ran, passed\` in the final report.
-- If the installed Truthmark CLI is unavailable or the helper is skipped, record \`validate-sync-report: skipped, <reason>\` and manually validate the report shape.
-- Record \`validate-write-lease: ran, passed\` only after validating a concrete write lease; otherwise use a truthful skipped status such as \`skipped, no write lease used\`.
-- Helper output is derived evidence and never replaces direct checkout inspection, evidence review, or parent acceptance.
 ${renderHierarchySummary(config)}
-${DECISION_TRUTH_INSTRUCTIONS}
 Parent post-sync verification:
 - verify only truth docs and leased truth routing files changed during sync
 - stop on any unrelated diff caused by the sync step
 - stop if functional code changed during sync
-- for each write lease, validate the worker report against the actual worker diff, allowedWrites, forbiddenWrites, identity fields, filesChanged, offLeaseChanges, blockers, and expected report fields before accepting it
 - validate the final report against the structured Truth Sync report contract, including Claim, indented Evidence, and Result values supported, narrowed, removed, or blocked under Evidence checked
 - verify the updated docs correspond to reviewed checkout evidence, changed-code impact, or a recorded stale-truth correction made within the sync write lease
 - verify the final report records ownership review, structure requirement, split, restructure, or manual handoff reason when the ownership review applies
@@ -3475,8 +3278,6 @@ var TRUTHMARK_REALIZE_SKILL_PATH = ".agents/skills/truthmark-realize/SKILL.md";
 var TRUTHMARK_REALIZE_SKILL_METADATA_PATH = ".agents/skills/truthmark-realize/agents/openai.yaml";
 var TRUTHMARK_CHECK_SKILL_PATH = ".agents/skills/truthmark-check/SKILL.md";
 var TRUTHMARK_CHECK_SKILL_METADATA_PATH = ".agents/skills/truthmark-check/agents/openai.yaml";
-var TRUTHMARK_PREVIEW_SKILL_PATH = ".agents/skills/truthmark-preview/SKILL.md";
-var TRUTHMARK_PREVIEW_SKILL_METADATA_PATH = ".agents/skills/truthmark-preview/agents/openai.yaml";
 var TRUTHMARK_PORTAL_SKILL_PATH = ".agents/skills/truthmark-portal/SKILL.md";
 var TRUTHMARK_PORTAL_SKILL_METADATA_PATH = ".agents/skills/truthmark-portal/agents/openai.yaml";
 var TRUTHMARK_ROUTE_AUDITOR_AGENT_PATH = ".codex/agents/truth-route-auditor.toml";
@@ -3491,37 +3292,28 @@ var TRUTHMARK_CLAUDE_ROUTE_AUDITOR_AGENT_PATH = ".claude/agents/truth-route-audi
 var TRUTHMARK_CLAUDE_CLAIM_VERIFIER_AGENT_PATH = ".claude/agents/truth-claim-verifier.md";
 var TRUTHMARK_CLAUDE_DOC_REVIEWER_AGENT_PATH = ".claude/agents/truth-doc-reviewer.md";
 var TRUTHMARK_CLAUDE_DOC_WRITER_AGENT_PATH = ".claude/agents/truth-doc-writer.md";
-var TRUTHMARK_GEMINI_STRUCTURE_COMMAND_PATH = ".gemini/commands/truthmark/structure.toml";
-var TRUTHMARK_GEMINI_DOCUMENT_COMMAND_PATH = ".gemini/commands/truthmark/document.toml";
-var TRUTHMARK_GEMINI_SYNC_COMMAND_PATH = ".gemini/commands/truthmark/sync.toml";
-var TRUTHMARK_GEMINI_REALIZE_COMMAND_PATH = ".gemini/commands/truthmark/realize.toml";
-var TRUTHMARK_GEMINI_CHECK_COMMAND_PATH = ".gemini/commands/truthmark/check.toml";
-var TRUTHMARK_GEMINI_PREVIEW_COMMAND_PATH = ".gemini/commands/truthmark/preview.toml";
-var TRUTHMARK_GEMINI_PORTAL_COMMAND_PATH = ".gemini/commands/truthmark/portal.toml";
-var TRUTHMARK_GEMINI_ROUTE_AUDITOR_AGENT_PATH = ".gemini/agents/truth-route-auditor.md";
-var TRUTHMARK_GEMINI_CLAIM_VERIFIER_AGENT_PATH = ".gemini/agents/truth-claim-verifier.md";
-var TRUTHMARK_GEMINI_DOC_REVIEWER_AGENT_PATH = ".gemini/agents/truth-doc-reviewer.md";
-var TRUTHMARK_GEMINI_DOC_WRITER_AGENT_PATH = ".gemini/agents/truth-doc-writer.md";
+var TRUTHMARK_ANTIGRAVITY_STRUCTURE_RULE_PATH = ".antigravity/rules/truthmark-structure.md";
+var TRUTHMARK_ANTIGRAVITY_DOCUMENT_RULE_PATH = ".antigravity/rules/truthmark-document.md";
+var TRUTHMARK_ANTIGRAVITY_SYNC_RULE_PATH = ".antigravity/rules/truthmark-sync.md";
+var TRUTHMARK_ANTIGRAVITY_REALIZE_RULE_PATH = ".antigravity/rules/truthmark-realize.md";
+var TRUTHMARK_ANTIGRAVITY_CHECK_RULE_PATH = ".antigravity/rules/truthmark-check.md";
+var TRUTHMARK_ANTIGRAVITY_PORTAL_RULE_PATH = ".antigravity/rules/truthmark-portal.md";
+var TRUTHMARK_CURSOR_STRUCTURE_SKILL_PATH = ".cursor/skills/truthmark-structure/SKILL.md";
+var TRUTHMARK_CURSOR_DOCUMENT_SKILL_PATH = ".cursor/skills/truthmark-document/SKILL.md";
+var TRUTHMARK_CURSOR_SYNC_SKILL_PATH = ".cursor/skills/truthmark-sync/SKILL.md";
+var TRUTHMARK_CURSOR_REALIZE_SKILL_PATH = ".cursor/skills/truthmark-realize/SKILL.md";
+var TRUTHMARK_CURSOR_CHECK_SKILL_PATH = ".cursor/skills/truthmark-check/SKILL.md";
+var TRUTHMARK_CURSOR_PORTAL_SKILL_PATH = ".cursor/skills/truthmark-portal/SKILL.md";
 var TRUTHMARK_COPILOT_STRUCTURE_PROMPT_PATH = ".github/prompts/truthmark-structure.prompt.md";
 var TRUTHMARK_COPILOT_DOCUMENT_PROMPT_PATH = ".github/prompts/truthmark-document.prompt.md";
 var TRUTHMARK_COPILOT_SYNC_PROMPT_PATH = ".github/prompts/truthmark-sync.prompt.md";
 var TRUTHMARK_COPILOT_REALIZE_PROMPT_PATH = ".github/prompts/truthmark-realize.prompt.md";
 var TRUTHMARK_COPILOT_CHECK_PROMPT_PATH = ".github/prompts/truthmark-check.prompt.md";
-var TRUTHMARK_COPILOT_PREVIEW_PROMPT_PATH = ".github/prompts/truthmark-preview.prompt.md";
 var TRUTHMARK_COPILOT_PORTAL_PROMPT_PATH = ".github/prompts/truthmark-portal.prompt.md";
 var TRUTHMARK_COPILOT_ROUTE_AUDITOR_AGENT_PATH = ".github/agents/truth-route-auditor.md";
 var TRUTHMARK_COPILOT_CLAIM_VERIFIER_AGENT_PATH = ".github/agents/truth-claim-verifier.md";
 var TRUTHMARK_COPILOT_DOC_REVIEWER_AGENT_PATH = ".github/agents/truth-doc-reviewer.md";
 var TRUTHMARK_COPILOT_DOC_WRITER_AGENT_PATH = ".github/agents/truth-doc-writer.md";
-var renderGeminiCommand = (description, prompt) => {
-  const promptWithArgs = `${prompt.trimEnd()}
-User focus or arguments: {{args}}`;
-  return `description = "${description}"
-prompt = '''
-${promptWithArgs}
-'''
-`;
-};
 var renderCopilotPromptFile = (description, prompt) => {
   return `---
 agent: 'agent'
@@ -3535,12 +3327,10 @@ var workflowSupportFiles = (workflowId) => {
   const workflow = getTruthmarkWorkflow(workflowId);
   const definition = WORKFLOW_PACKAGE_DEFINITIONS[workflowId];
   const hasSubagentSupport = definition.parentRule !== void 0 && ((workflow.subagents?.length ?? 0) > 0 || (workflow.writeSubagents?.length ?? 0) > 0);
-  const hasHelperSupport = (workflow.helpers?.length ?? 0) > 0;
   return [
     "support/procedure.md",
     "support/report-template.md",
-    ...hasSubagentSupport ? ["support/subagents-and-leases.md"] : [],
-    ...hasHelperSupport ? ["helper-manifest.yml", "support/helper-policy.md"] : []
+    ...hasSubagentSupport ? ["support/subagents-and-leases.md"] : []
   ];
 };
 var renderWorkflowCommandAdapterInstructions = (workflowId, root, hostName, surfaceKind) => {
@@ -3561,105 +3351,70 @@ var renderTomlString = (value) => {
 var renderTomlStringArray = (values) => {
   return `[${values.map(renderTomlString).join(", ")}]`;
 };
-var TRUTH_REALIZE_EXPLICIT_INVOCATIONS = "OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.";
 var routeFilesHint = (config) => `${config.truthmark.paths.routesIndex}; ${config.truthmark.paths.routeAreasRoot}/`;
 var WORKFLOW_PACKAGE_DEFINITIONS = {
   "truthmark-structure": {
     title: "Truthmark Structure",
     argumentHint: "Optional area, directory, or routing concern",
-    invocations: TRUTH_STRUCTURE_EXPLICIT_INVOCATIONS,
     use: () => "Use this skill to design or repair Truthmark area structure.",
     quickRules: (config) => [
       "Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.",
       `Inspect .truthmark/config.yml and configured route files (${routeFilesHint(config)}) only when they exist; then inspect current docs and relevant code directly.`,
       "Define areas by product or behavior ownership, not by mechanical directory mirroring.",
-      "Do not edit functional code.",
-      "Read support/procedure.md before writing route or starter truth-doc changes.",
-      "Read support/report-template.md before the final report."
+      "Do not edit functional code."
     ],
     parentRule: "Parent agent owns all Truth Structure writes and final topology decisions"
   },
   "truthmark-document": {
     title: "Truthmark Document",
     argumentHint: "Optional implemented behavior, API endpoint, route, controller, package, or truth-doc area to document",
-    invocations: TRUTH_DOCUMENT_EXPLICIT_INVOCATIONS,
     use: () => "Use this skill to document existing implemented behavior when no functional-code changes are required for the task.",
     quickRules: (config) => [
       "Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.",
       `Inspect .truthmark/config.yml and configured route files (${routeFilesHint(config)}) only when they exist; then inspect existing canonical docs, implementation code, and tests directly.`,
       "Document current implemented behavior; do not invent future behavior.",
-      "May write canonical truth docs and truth routing files only; must not write functional code.",
-      "Read support/procedure.md before editing truth docs.",
-      "Read support/subagents-and-leases.md only when dispatching or accepting worker output.",
-      "Read support/report-template.md before the final report."
+      "May write canonical truth docs and truth routing files only; must not write functional code."
     ],
     parentRule: "Parent agent owns Truth Document acceptance, lease validation, and final report"
   },
   "truthmark-sync": {
     title: "Truthmark Sync",
     argumentHint: "Optional changed-code area, truth-doc area, or sync focus",
-    invocations: TRUTH_SYNC_EXPLICIT_INVOCATIONS,
     use: () => "Use this skill automatically before finishing when functional code changed since the last successful Truth Sync. Also run it immediately when the user explicitly invokes Truth Sync.",
     quickRules: (config) => [
       "Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.",
       "Skip docs-only, formatting-only, behavior-preserving renames with no truth impact, missing config, and no-code changes.",
       `Inspect .truthmark/config.yml and configured route files (${routeFilesHint(config)}) only when they exist; then inspect relevant canonical docs directly.`,
       "direct checkout inspection is the canonical path; do not require the truthmark binary.",
-      "May write canonical truth docs and truth routing files only; must not rewrite functional code.",
-      "Read support/procedure.md before editing truth docs.",
-      "Read support/subagents-and-leases.md only when dispatching or accepting worker output.",
-      "Read support/report-template.md before the final report."
+      "May write canonical truth docs and truth routing files only; must not rewrite functional code."
     ],
     parentRule: "Parent agent owns Truth Sync acceptance, lease validation, and final report"
   },
-  "truthmark-preview": {
-    title: "Truthmark Preview",
-    argumentHint: "Optional requested outcome, code area, doc path, or routing question",
-    invocations: TRUTH_PREVIEW_EXPLICIT_INVOCATIONS,
-    use: () => "Use this skill only when the user explicitly asks to preview Truthmark routing or workflow choice before edits.",
-    quickRules: (config) => [
-      "Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.",
-      `Inspect .truthmark/config.yml and the root route index (${config.truthmark.paths.routesIndex}) first when present; then inspect only child route files under ${config.truthmark.paths.routeAreasRoot}/ that are relevant to the selected scope or changed paths, plus the truth docs or implementation files needed to preview ownership.`,
-      "Truth Preview is read-only; this report is intended, not authorized.",
-      "must not edit files and must not issue write leases; do not run Truth Sync automatically, replace Truth Check, claim final correctness, or mutate code.",
-      "Use optional read-only route-auditor evidence only when it reduces context or clarifies ownership.",
-      "Hand off to the selected workflow after user approval."
-    ],
-    parentRule: "Parent agent owns the final Truth Preview report"
-  },
   "truthmark-realize": {
     title: "Truthmark Realize",
     argumentHint: "Optional truth doc path, area, or desired code behavior to realize",
-    invocations: TRUTH_REALIZE_EXPLICIT_INVOCATIONS,
     use: () => "Use this skill only when the user explicitly asks to realize truth docs into code.",
     quickRules: (config) => [
       "Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.",
       `Read the source truth docs, inspect .truthmark/config.yml and configured route files (${routeFilesHint(config)}) only when they exist, then inspect tests and relevant functional code directly.`,
       "Truth docs lead; code follows.",
-      "may write functional code only; must not edit truth docs or truth routing while realizing those docs.",
-      "Read support/procedure.md before changing code.",
-      "Read support/report-template.md before the final report."
+      "may write functional code only; must not edit truth docs or truth routing while realizing those docs."
     ]
   },
   "truthmark-check": {
     title: "Truthmark Check",
     argumentHint: "Optional area, doc path, or audit focus",
-    invocations: TRUTH_CHECK_EXPLICIT_INVOCATIONS,
     use: () => "Use this skill to audit repository truth health.",
     quickRules: (config) => [
       "Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.",
       `Inspect .truthmark/config.yml and configured route files (${routeFilesHint(config)}) only when they exist; then inspect canonical docs and relevant implementation directly.`,
-      "Report issues and suggested fixes; do not silently rewrite unrelated files.",
-      "Read support/procedure.md before auditing details.",
-      "Read support/subagents-and-leases.md only when dispatching verifier subagents.",
-      "Read support/report-template.md before the final report."
+      "Report issues and suggested fixes; do not silently rewrite unrelated files."
     ],
     parentRule: "Parent agent owns the final Truth Check report"
   },
   "truthmark-portal": {
     title: "Truthmark Portal",
     argumentHint: "Optional portal generation focus",
-    invocations: TRUTHMARK_PORTAL_EXPLICIT_INVOCATIONS,
     use: () => "Use this skill only when the user explicitly asks to generate or refresh the committed static HTML Truthmark Portal.",
     quickRules: (config) => [
       "Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.",
@@ -3669,9 +3424,7 @@ var WORKFLOW_PACKAGE_DEFINITIONS = {
       "Generate committed, generated non-canonical static files for humans.",
       `Write only under fixed Portal output ${config.truthmark.paths.portalOutput}.`,
       `Use determined Portal template ${config.truthmark.paths.portalTemplate} when present; no .truthmark/index.json dependency.`,
-      "Use no remote dependencies by default and include source provenance on every page.",
-      "Read support/procedure.md before generating Portal output.",
-      "Read support/report-template.md before the final report."
+      "Use no remote dependencies by default and include source provenance on every page."
     ]
   }
 };
@@ -3699,14 +3452,14 @@ ${renderMarkdownExample(
           changedCode: ["src/auth/session.ts"],
           syncIntent: {
             changedCodeReviewed: ["src/auth/session.ts"],
-            affectedRouteOrTruthOwner: [config.truthmark.paths.routesIndex],
-            targetTruthDocs: [
-              `${engineeringTruthRoot}/repository/bootstrap-routing.md`
+            affectedRouteOrTruthOwner: [
+              `${config.truthmark.paths.routeAreasRoot}/authentication.md`
             ],
+            targetTruthDocs: [`${engineeringTruthRoot}/behaviors/session-timeout.md`],
             intendedUpdate: ["Update session timeout behavior."],
             evidenceToVerify: [
               "src/auth/session.ts:12",
-              `${config.truthmark.paths.routesIndex}:11`
+              `${config.truthmark.paths.routeAreasRoot}/authentication.md:11`
             ],
             userProvidedDecisionRationale: [
               "User rationale: session timeout behavior changed for internal implementation consistency"
@@ -3714,40 +3467,37 @@ ${renderMarkdownExample(
             noUpdateNeededRationale: ["not applicable; mapped truth is stale"],
             blockers: ["none"]
           },
-          ownershipReviewed: [config.truthmark.paths.routesIndex],
-          truthDocsUpdated: [
-            `${engineeringTruthRoot}/repository/bootstrap-routing.md`
+          ownershipReviewed: [
+            `${config.truthmark.paths.routeAreasRoot}/authentication.md`
           ],
+          truthDocsUpdated: [`${engineeringTruthRoot}/behaviors/session-timeout.md`],
           evidenceChecked: [
             {
-              claim: "Session timeout behavior is documented in the mapped repository truth doc.",
+              claim: "Session timeout behavior is documented in the bounded authentication behavior truth doc.",
               evidence: [
                 "src/auth/session.ts:12",
-                `${config.truthmark.paths.routesIndex}:11`
+                `${config.truthmark.paths.routeAreasRoot}/authentication.md:11`
               ],
               result: "supported"
             }
           ],
           decisionRationaleCaptured: [
-            "Placed user rationale in the mapped engineering truth doc under Engineering Decisions/Rationale."
+            "Placed user rationale in the bounded authentication behavior truth doc under Engineering Decisions/Rationale."
           ],
-          helperScripts: ["validate-write-lease: skipped, no write lease used"],
           notes: ["Updated session timeout behavior."]
         })
       )}
 Blocked report example:
 ${renderMarkdownExample(
         renderTruthSyncBlockedReport({
-          reason: "routing repair is not allowed",
-          manualReviewFiles: [config.truthmark.paths.routesIndex],
-          nextAction: "update routing metadata and rerun Truth Sync"
+          reason: "Changed code maps only to the provisional bootstrap route.",
+          manualReviewFiles: [
+            "src/auth/**",
+            `${config.truthmark.paths.routeAreasRoot}/${config.truthmark.routes.defaultArea}.md`
+          ],
+          nextAction: "Run Truth Structure for src/auth/** before updating behavior truth."
         })
       )}`;
-    case "truthmark-preview":
-      return `Report completion in this shape:
-${renderMarkdownExample(
-        renderTruthPreviewReportExample(config)
-      )}`;
     case "truthmark-realize":
       return `Report completion in this shape:
 
@@ -3809,56 +3559,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che
 ${body}
 `;
 };
-var renderHelperManifest = (helpers) => {
-  const manifest = {
-    helpers: Object.fromEntries(
-      helpers.map((helper) => [
-        helper.id,
-        {
-          optional: helper.optional,
-          runner: helper.runner,
-          command: helper.command,
-          inputs: helper.inputs,
-          output: helper.output,
-          writes: helper.writes,
-          ...helper.allowedWrites === void 0 ? {} : { allowedWrites: helper.allowedWrites },
-          fallback: helper.fallback
-        }
-      ])
-    )
-  };
-  return [
-    `# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.`,
-    stringify2(manifest, { lineWidth: 0 })
-  ].join("\n");
-};
-var renderHelperPolicySupport = (helpers) => {
-  const reportHelperId = helpers.find((helper) => helper.id.endsWith("-report"))?.id ?? helpers[0]?.id;
-  const helperLines = helpers.map(
-    (helper) => `- ${helper.id}: optional ${helper.runner}; manual fallback: ${helper.fallback}`
-  ).join("\n");
-  return renderSkillSupportFile(
-    "Optional Helper CLI Policy",
-    `Optional helper CLI commands may collect deterministic checkout facts or validate artifacts. If the Truthmark CLI is unavailable or cannot return the declared helper output, continue manually using this procedure and report which helper was skipped. Helper output is derived evidence; it does not override direct checkout inspection, workflow write boundaries, or parent acceptance.
-
-Runner detection:
-- Check that the declared Truthmark CLI runner is available before invoking a helper.
-- Invoke helpers through the installed \`truthmark validate ... --json\` CLI command using argv-style arguments from helper-manifest.yml.
-- If unavailable, failing, or returning incompatible output, treat the helper as skipped and use the manual fallback.
-- Do not fail the workflow solely because a helper cannot run.
-
-Available helpers:
-${helperLines}
-
-Final reports should include helper status when helpers are declared for this workflow:
-
-\`\`\`md
-Helper scripts:
-- ${reportHelperId}: ran, passed
-- validate-write-lease: skipped, no write lease used
-\`\`\``
-  );
-};
 var renderWorkflowProcedure = (workflowId, config) => {
   switch (workflowId) {
     case "truthmark-structure":
@@ -3867,8 +3567,6 @@ var renderWorkflowProcedure = (workflowId, config) => {
       return renderTruthDocumentProcedureBody(config);
     case "truthmark-sync":
       return renderTruthSyncProcedureBody(config);
-    case "truthmark-preview":
-      return renderTruthPreviewProcedureBody(config);
     case "truthmark-realize":
       return renderTruthmarkRealizeProcedureBody(config);
     case "truthmark-check":
@@ -3890,16 +3588,10 @@ var renderWorkflowEntrypoint = (workflowId, config, supportFiles, host) => {
     if (supportFile === "support/subagents-and-leases.md") {
       return "read only when using subagents, leases, or accepting worker output";
     }
-    if (supportFile === "support/helper-policy.md") {
-      return "read only when invoking helper validators or reporting helper status";
-    }
-    if (supportFile === "helper-manifest.yml") {
-      return "read only when invoking helper validators or validating helper registration";
-    }
     return "available when relevant to the current step";
   };
   const supportFileList = supportFiles.map((supportFile) => `- ${supportFile} \u2014 ${supportFileUsage(supportFile)}`).join("\n");
-  const hostUsage = host === "github-copilot" ? "Use as a Copilot agent skill. Prompt files remain available under `.github/prompts/` for command-style invocation in supported Copilot IDEs." : host === "gemini-cli" ? "Use as a Gemini CLI Agent Skill; commands remain available under `/truthmark:*` for command-first invocation." : void 0;
+  const hostUsage = host === "github-copilot" ? "Use as a Copilot agent skill. Prompt files remain available under `.github/prompts/` for command-style invocation in supported Copilot IDEs." : host === "cursor" ? "Use as a Cursor Agent Skill. Cursor discovers project skills under `.cursor/skills/`, selects them from the description when relevant, and supports manual `/` invocation." : void 0;
   return `---
 name: ${workflowId}
 description: ${workflow.description}
@@ -3913,8 +3605,6 @@ ${definition.use(config)}${hostUsage === void 0 ? "" : `
 
 ${hostUsage}`}
 
-Invocations: ${definition.invocations}
-
 Quick procedure:
 ${definition.quickRules(config).map((rule) => `- ${rule}`).join("\n")}
 
@@ -3958,12 +3648,8 @@ var renderWorkflowSubagentSupport = (workflowId, host) => {
         definition.parentRule,
         writeAgents
       );
-    case "gemini-cli":
-      return renderGeminiSubagentModeSection(
-        readAgents,
-        definition.parentRule,
-        writeAgents
-      );
+    case "cursor":
+      return void 0;
   }
 };
 var renderTruthmarkSkillPackage = ({
@@ -3979,8 +3665,11 @@ var renderTruthmarkSkillPackage = ({
     config
   );
   const subagents = renderWorkflowSubagentSupport(workflowId, host);
-  const helpers = getTruthmarkWorkflow(workflowId).helpers ?? [];
-  const supportFiles = workflowSupportFiles(workflowId);
+  const supportFiles = [
+    "support/procedure.md",
+    "support/report-template.md",
+    ...subagents !== void 0 ? ["support/subagents-and-leases.md"] : []
+  ];
   const definition = WORKFLOW_PACKAGE_DEFINITIONS[workflowId];
   const files = [
     {
@@ -4011,18 +3700,6 @@ var renderTruthmarkSkillPackage = ({
       )
     });
   }
-  if (helpers.length > 0) {
-    files.push(
-      {
-        path: `${skillDirectory}/helper-manifest.yml`,
-        content: renderHelperManifest(helpers)
-      },
-      {
-        path: `${supportDirectory}/helper-policy.md`,
-        content: renderHelperPolicySupport(helpers)
-      }
-    );
-  }
   return files;
 };
 var normalizeOpenCodePermissionPath = (path12) => {
@@ -4053,7 +3730,7 @@ var renderOpenCodeWriterEditAllowRules = (config) => {
   return [...new Set(allowedPatterns)].map((pattern) => `    ${JSON.stringify(pattern)}: allow`).join("\n");
 };
 var READ_ONLY_SUBAGENT_CONTEXT_BOUNDARY = `Context boundary:
-Do not preload AGENTS.md, CLAUDE.md, GEMINI.md, .github/copilot-instructions.md, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
+Do not preload AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, .cursor/skills, .antigravity/rules, or repo-wide policy docs unless the parent explicitly assigns them as evidence.
 Use only the parent-assigned shard plus required checkout evidence files.
 Return findings only; the parent workflow owns repository-policy interpretation, final decisions, and all writes.`;
 var renderReadOnlySubagentInstructions = (instructions) => {
@@ -4188,45 +3865,6 @@ tools: [read, search, edit]
 
 # Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 
-${instructions}
-`;
-};
-var renderGeminiReadOnlyAgent = ({
-  copilotName,
-  description,
-  instructions
-}) => {
-  const agentInstructions = renderReadOnlySubagentInstructions(instructions);
-  return `---
-name: ${copilotName}
-description: ${description}
-kind: local
-tools: [read_file, grep_search]
----
-
-# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
-
-Manual invocation: @${copilotName}
-
-${agentInstructions}
-`;
-};
-var renderGeminiWriteAgent = ({
-  copilotName,
-  description,
-  instructions
-}) => {
-  return `---
-name: ${copilotName}
-description: ${description}
-kind: local
-tools: [read_file, grep_search, write_file]
----
-
-# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
-
-Manual invocation: @${copilotName} with an explicit parent write lease.
-
 ${instructions}
 `;
 };
@@ -4329,26 +3967,6 @@ var renderTruthmarkCopilotDocWriterAgent = () => {
     TRUTHMARK_WRITE_SUBAGENT_PROFILES.truth_doc_writer
   );
 };
-var renderTruthmarkGeminiRouteAuditorAgent = () => {
-  return renderGeminiReadOnlyAgent(
-    TRUTHMARK_SUBAGENT_PROFILES.truth_route_auditor
-  );
-};
-var renderTruthmarkGeminiClaimVerifierAgent = () => {
-  return renderGeminiReadOnlyAgent(
-    TRUTHMARK_SUBAGENT_PROFILES.truth_claim_verifier
-  );
-};
-var renderTruthmarkGeminiDocReviewerAgent = () => {
-  return renderGeminiReadOnlyAgent(
-    TRUTHMARK_SUBAGENT_PROFILES.truth_doc_reviewer
-  );
-};
-var renderTruthmarkGeminiDocWriterAgent = () => {
-  return renderGeminiWriteAgent(
-    TRUTHMARK_WRITE_SUBAGENT_PROFILES.truth_doc_writer
-  );
-};
 var renderTruthmarkClaudeRouteAuditorAgent = () => {
   return renderClaudeReadOnlyAgent(
     TRUTHMARK_SUBAGENT_PROFILES.truth_route_auditor
@@ -4515,8 +4133,6 @@ var renderTruthmarkRealizeProcedureBody = (config = defaultAgentConfig()) => {
 
 Use this skill only when the user explicitly asks to realize truth docs into code.
 
-Invocations: OpenCode /skill truthmark-realize; Codex /truthmark-realize or $truthmark-realize; Claude Code /truthmark-realize; GitHub Copilot /truthmark-realize; Gemini CLI /truthmark:realize.
-
 Truth Realize is doc-first:
 
 - truth docs lead
@@ -4554,20 +4170,6 @@ var renderTruthmarkRealizeSkillMetadata = () => {
 policy:
   allow_implicit_invocation: ${workflow.allowImplicitInvocation}
 
-truthmark:
-  refresh_command: "truthmark init"
-`;
-};
-var renderTruthmarkPreviewSkillMetadata = () => {
-  const workflow = getTruthmarkWorkflow("truthmark-preview");
-  return `interface:
-  display_name: "${workflow.displayName}"
-  short_description: "${workflow.shortDescription}"
-  default_prompt: "${workflow.defaultPrompt}"
-
-policy:
-  allow_implicit_invocation: ${workflow.allowImplicitInvocation}
-
 truthmark:
   refresh_command: "truthmark init"
 `;
@@ -4600,17 +4202,41 @@ truthmark:
   refresh_command: "truthmark init"
 `;
 };
-var renderGeminiWorkflowCommand = (workflowId, root) => {
+var renderWorkflowRuleFile = ({
+  workflowId,
+  hostName,
+  ruleName,
+  config = defaultAgentConfig()
+}) => {
   const workflow = getTruthmarkWorkflow(workflowId);
-  return renderGeminiCommand(
-    workflow.description,
-    renderWorkflowCommandAdapterInstructions(
-      workflowId,
-      root,
-      "Gemini CLI",
-      "command"
-    )
+  const definition = WORKFLOW_PACKAGE_DEFINITIONS[workflowId];
+  const { procedure, reportTemplate } = renderWorkflowSupportParts(
+    workflowId,
+    config
   );
+  const body = `# ${definition.title}
+
+Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
+
+This rule is the ${hostName} entrypoint for ${definition.title}.
+
+Do not invoke another Truthmark command from here.
+
+Manual invocation: @${ruleName}
+
+If skill entrypoints are unavailable, use the host's direct evidence-first manual fallback procedure.
+
+Description: ${workflow.description}
+
+## Procedure
+
+${procedure}
+
+## Report Template
+
+${reportTemplate}
+`;
+  return body;
 };
 var renderCopilotWorkflowPrompt = (workflowId, root) => {
   const workflow = getTruthmarkWorkflow(workflowId);
@@ -4624,55 +4250,42 @@ var renderCopilotWorkflowPrompt = (workflowId, root) => {
     )
   );
 };
-var renderTruthmarkGeminiStructureCommand = (config = defaultAgentConfig()) => {
-  void config;
-  return renderGeminiWorkflowCommand(
-    "truthmark-structure",
-    ".gemini/skills/truthmark-structure"
-  );
-};
-var renderTruthmarkGeminiDocumentCommand = (config = defaultAgentConfig()) => {
-  void config;
-  return renderGeminiWorkflowCommand(
-    "truthmark-document",
-    ".gemini/skills/truthmark-document"
-  );
-};
-var renderTruthmarkGeminiSyncCommand = (config = defaultAgentConfig()) => {
-  void config;
-  return renderGeminiWorkflowCommand(
-    "truthmark-sync",
-    ".gemini/skills/truthmark-sync"
-  );
-};
-var renderTruthmarkGeminiRealizeCommand = (config = defaultAgentConfig()) => {
-  void config;
-  return renderGeminiWorkflowCommand(
-    "truthmark-realize",
-    ".gemini/skills/truthmark-realize"
-  );
-};
-var renderTruthmarkGeminiCheckCommand = (config = defaultAgentConfig()) => {
-  void config;
-  return renderGeminiWorkflowCommand(
-    "truthmark-check",
-    ".gemini/skills/truthmark-check"
-  );
-};
-var renderTruthmarkGeminiPreviewCommand = (config = defaultAgentConfig()) => {
-  void config;
-  return renderGeminiWorkflowCommand(
-    "truthmark-preview",
-    ".gemini/skills/truthmark-preview"
-  );
-};
-var renderTruthmarkGeminiPortalCommand = (config = defaultAgentConfig()) => {
-  void config;
-  return renderGeminiWorkflowCommand(
-    "truthmark-portal",
-    ".gemini/skills/truthmark-portal"
-  );
-};
+var renderTruthmarkAntigravityStructureRule = (config = defaultAgentConfig()) => renderWorkflowRuleFile({
+  workflowId: "truthmark-structure",
+  hostName: "Antigravity",
+  ruleName: "truthmark-structure",
+  config
+});
+var renderTruthmarkAntigravityDocumentRule = (config = defaultAgentConfig()) => renderWorkflowRuleFile({
+  workflowId: "truthmark-document",
+  hostName: "Antigravity",
+  ruleName: "truthmark-document",
+  config
+});
+var renderTruthmarkAntigravitySyncRule = (config = defaultAgentConfig()) => renderWorkflowRuleFile({
+  workflowId: "truthmark-sync",
+  hostName: "Antigravity",
+  ruleName: "truthmark-sync",
+  config
+});
+var renderTruthmarkAntigravityRealizeRule = (config = defaultAgentConfig()) => renderWorkflowRuleFile({
+  workflowId: "truthmark-realize",
+  hostName: "Antigravity",
+  ruleName: "truthmark-realize",
+  config
+});
+var renderTruthmarkAntigravityCheckRule = (config = defaultAgentConfig()) => renderWorkflowRuleFile({
+  workflowId: "truthmark-check",
+  hostName: "Antigravity",
+  ruleName: "truthmark-check",
+  config
+});
+var renderTruthmarkAntigravityPortalRule = (config = defaultAgentConfig()) => renderWorkflowRuleFile({
+  workflowId: "truthmark-portal",
+  hostName: "Antigravity",
+  ruleName: "truthmark-portal",
+  config
+});
 var renderTruthmarkCopilotStructurePrompt = (config = defaultAgentConfig()) => {
   void config;
   return renderCopilotWorkflowPrompt(
@@ -4708,13 +4321,6 @@ var renderTruthmarkCopilotCheckPrompt = (config = defaultAgentConfig()) => {
     ".github/skills/truthmark-check"
   );
 };
-var renderTruthmarkCopilotPreviewPrompt = (config = defaultAgentConfig()) => {
-  void config;
-  return renderCopilotWorkflowPrompt(
-    "truthmark-preview",
-    ".github/skills/truthmark-preview"
-  );
-};
 var renderTruthmarkCopilotPortalPrompt = (config = defaultAgentConfig()) => {
   void config;
   return renderCopilotWorkflowPrompt(
@@ -4757,24 +4363,14 @@ var codexFiles = (config) => {
       content: renderTruthmarkSyncSkillMetadata()
     },
     ...renderTruthmarkSkillPackage({
-      skillPath: TRUTHMARK_PREVIEW_SKILL_PATH,
-      workflowId: "truthmark-preview",
+      skillPath: TRUTHMARK_CHECK_SKILL_PATH,
+      workflowId: "truthmark-check",
       host: "codex",
       config
     }),
     {
-      path: TRUTHMARK_PREVIEW_SKILL_METADATA_PATH,
-      content: renderTruthmarkPreviewSkillMetadata()
-    },
-    ...renderTruthmarkSkillPackage({
-      skillPath: TRUTHMARK_CHECK_SKILL_PATH,
-      workflowId: "truthmark-check",
-      host: "codex",
-      config
-    }),
-    {
-      path: TRUTHMARK_CHECK_SKILL_METADATA_PATH,
-      content: renderTruthmarkCheckSkillMetadata()
+      path: TRUTHMARK_CHECK_SKILL_METADATA_PATH,
+      content: renderTruthmarkCheckSkillMetadata()
     },
     ...renderTruthmarkSkillPackage({
       skillPath: TRUTHMARK_REALIZE_SKILL_PATH,
@@ -4839,12 +4435,6 @@ var opencodeFiles = (config) => {
       host: "opencode",
       config
     }),
-    ...renderTruthmarkSkillPackage({
-      skillPath: ".opencode/skills/truthmark-preview/SKILL.md",
-      workflowId: "truthmark-preview",
-      host: "opencode",
-      config
-    }),
     ...renderTruthmarkSkillPackage({
       skillPath: ".opencode/skills/truthmark-check/SKILL.md",
       workflowId: "truthmark-check",
@@ -4907,12 +4497,6 @@ var claudeFiles = (config, block) => {
       host: "claude-code",
       config
     }),
-    ...renderTruthmarkSkillPackage({
-      skillPath: ".claude/skills/truthmark-preview/SKILL.md",
-      workflowId: "truthmark-preview",
-      host: "claude-code",
-      config
-    }),
     ...renderTruthmarkSkillPackage({
       skillPath: ".claude/skills/truthmark-check/SKILL.md",
       workflowId: "truthmark-check",
@@ -4975,12 +4559,6 @@ var copilotFiles = (config, block) => {
       host: "github-copilot",
       config
     }),
-    ...renderTruthmarkSkillPackage({
-      skillPath: ".github/skills/truthmark-preview/SKILL.md",
-      workflowId: "truthmark-preview",
-      host: "github-copilot",
-      config
-    }),
     ...renderTruthmarkSkillPackage({
       skillPath: ".github/skills/truthmark-check/SKILL.md",
       workflowId: "truthmark-check",
@@ -5005,10 +4583,6 @@ var copilotFiles = (config, block) => {
       path: TRUTHMARK_COPILOT_SYNC_PROMPT_PATH,
       content: renderTruthmarkCopilotSyncPrompt(config)
     },
-    {
-      path: TRUTHMARK_COPILOT_PREVIEW_PROMPT_PATH,
-      content: renderTruthmarkCopilotPreviewPrompt(config)
-    },
     {
       path: TRUTHMARK_COPILOT_CHECK_PROMPT_PATH,
       content: renderTruthmarkCopilotCheckPrompt(config)
@@ -5050,98 +4624,78 @@ var copilotFiles = (config, block) => {
   }
   return files;
 };
-var geminiFiles = (config, block) => {
+var antigravityFiles = (config) => {
+  const files = [
+    {
+      path: TRUTHMARK_ANTIGRAVITY_STRUCTURE_RULE_PATH,
+      content: renderTruthmarkAntigravityStructureRule(config)
+    },
+    {
+      path: TRUTHMARK_ANTIGRAVITY_DOCUMENT_RULE_PATH,
+      content: renderTruthmarkAntigravityDocumentRule(config)
+    },
+    {
+      path: TRUTHMARK_ANTIGRAVITY_SYNC_RULE_PATH,
+      content: renderTruthmarkAntigravitySyncRule(config)
+    },
+    {
+      path: TRUTHMARK_ANTIGRAVITY_CHECK_RULE_PATH,
+      content: renderTruthmarkAntigravityCheckRule(config)
+    },
+    {
+      path: TRUTHMARK_ANTIGRAVITY_REALIZE_RULE_PATH,
+      content: renderTruthmarkAntigravityRealizeRule(config)
+    }
+  ];
+  if (config.truthmark.generated.portal.enabled) {
+    files.push({
+      path: TRUTHMARK_ANTIGRAVITY_PORTAL_RULE_PATH,
+      content: renderTruthmarkAntigravityPortalRule(config)
+    });
+  }
+  return files;
+};
+var cursorFiles = (config) => {
   const files = [
-    ...instructionBlockFiles(["GEMINI.md"], block),
     ...renderTruthmarkSkillPackage({
-      skillPath: ".gemini/skills/truthmark-structure/SKILL.md",
+      skillPath: TRUTHMARK_CURSOR_STRUCTURE_SKILL_PATH,
       workflowId: "truthmark-structure",
-      host: "gemini-cli",
+      host: "cursor",
       config
     }),
     ...renderTruthmarkSkillPackage({
-      skillPath: ".gemini/skills/truthmark-document/SKILL.md",
+      skillPath: TRUTHMARK_CURSOR_DOCUMENT_SKILL_PATH,
       workflowId: "truthmark-document",
-      host: "gemini-cli",
+      host: "cursor",
       config
     }),
     ...renderTruthmarkSkillPackage({
-      skillPath: ".gemini/skills/truthmark-sync/SKILL.md",
+      skillPath: TRUTHMARK_CURSOR_SYNC_SKILL_PATH,
       workflowId: "truthmark-sync",
-      host: "gemini-cli",
-      config
-    }),
-    ...renderTruthmarkSkillPackage({
-      skillPath: ".gemini/skills/truthmark-preview/SKILL.md",
-      workflowId: "truthmark-preview",
-      host: "gemini-cli",
+      host: "cursor",
       config
     }),
     ...renderTruthmarkSkillPackage({
-      skillPath: ".gemini/skills/truthmark-check/SKILL.md",
+      skillPath: TRUTHMARK_CURSOR_CHECK_SKILL_PATH,
       workflowId: "truthmark-check",
-      host: "gemini-cli",
+      host: "cursor",
       config
     }),
     ...renderTruthmarkSkillPackage({
-      skillPath: ".gemini/skills/truthmark-realize/SKILL.md",
+      skillPath: TRUTHMARK_CURSOR_REALIZE_SKILL_PATH,
       workflowId: "truthmark-realize",
-      host: "gemini-cli",
+      host: "cursor",
       config
-    }),
-    {
-      path: TRUTHMARK_GEMINI_STRUCTURE_COMMAND_PATH,
-      content: renderTruthmarkGeminiStructureCommand(config)
-    },
-    {
-      path: TRUTHMARK_GEMINI_DOCUMENT_COMMAND_PATH,
-      content: renderTruthmarkGeminiDocumentCommand(config)
-    },
-    {
-      path: TRUTHMARK_GEMINI_SYNC_COMMAND_PATH,
-      content: renderTruthmarkGeminiSyncCommand(config)
-    },
-    {
-      path: TRUTHMARK_GEMINI_PREVIEW_COMMAND_PATH,
-      content: renderTruthmarkGeminiPreviewCommand(config)
-    },
-    {
-      path: TRUTHMARK_GEMINI_CHECK_COMMAND_PATH,
-      content: renderTruthmarkGeminiCheckCommand(config)
-    },
-    {
-      path: TRUTHMARK_GEMINI_REALIZE_COMMAND_PATH,
-      content: renderTruthmarkGeminiRealizeCommand(config)
-    },
-    {
-      path: TRUTHMARK_GEMINI_ROUTE_AUDITOR_AGENT_PATH,
-      content: renderTruthmarkGeminiRouteAuditorAgent()
-    },
-    {
-      path: TRUTHMARK_GEMINI_CLAIM_VERIFIER_AGENT_PATH,
-      content: renderTruthmarkGeminiClaimVerifierAgent()
-    },
-    {
-      path: TRUTHMARK_GEMINI_DOC_REVIEWER_AGENT_PATH,
-      content: renderTruthmarkGeminiDocReviewerAgent()
-    },
-    {
-      path: TRUTHMARK_GEMINI_DOC_WRITER_AGENT_PATH,
-      content: renderTruthmarkGeminiDocWriterAgent()
-    }
+    })
   ];
   if (config.truthmark.generated.portal.enabled) {
     files.push(
       ...renderTruthmarkSkillPackage({
-        skillPath: ".gemini/skills/truthmark-portal/SKILL.md",
+        skillPath: TRUTHMARK_CURSOR_PORTAL_SKILL_PATH,
         workflowId: "truthmark-portal",
-        host: "gemini-cli",
+        host: "cursor",
         config
-      }),
-      {
-        path: TRUTHMARK_GEMINI_PORTAL_COMMAND_PATH,
-        content: renderTruthmarkGeminiPortalCommand(config)
-      }
+      })
     );
   }
   return files;
@@ -5163,8 +4717,10 @@ var filesForPlatform = (platform, config, block) => {
       return claudeFiles(config, block);
     case "github-copilot":
       return copilotFiles(config, block);
-    case "gemini-cli":
-      return geminiFiles(config, block);
+    case "antigravity":
+      return antigravityFiles(config);
+    case "cursor":
+      return cursorFiles(config);
   }
 };
 var renderGeneratedSurfaces = (config, block = renderAgentsBlock(config)) => {
@@ -5179,6 +4735,208 @@ var renderGeneratedSurfaces = (config, block = renderAgentsBlock(config)) => {
   ).sort((left, right) => left.path.localeCompare(right.path));
 };
 
+// src/checks/generated-surfaces.ts
+var readOptionalFile = async (rootDir, filePath) => {
+  try {
+    return await fs6.readFile(resolveRepoPath(rootDir, filePath), "utf8");
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  }
+};
+var extractManagedBlock = (content) => {
+  const startIndex = content.indexOf(TRUTHMARK_BLOCK_START);
+  const endIndex = content.indexOf(TRUTHMARK_BLOCK_END);
+  if (startIndex === -1 || endIndex === -1 || endIndex < startIndex) {
+    return null;
+  }
+  return content.slice(startIndex, endIndex + TRUTHMARK_BLOCK_END.length);
+};
+var normalizeGeneratedSurfaceContent = (content) => {
+  if (content === null) {
+    return null;
+  }
+  return content.replace(/\r\n/g, "\n").replace(/\n$/u, "");
+};
+var GENERATED_HOST_SKILL_ROOTS = [
+  ".agents/skills",
+  ".opencode/skills",
+  ".claude/skills",
+  ".github/skills",
+  ".cursor/skills"
+];
+var RETIRED_SKILL_HELPER_PATHS = [
+  "helper-manifest.yml",
+  "support/helper-policy.md"
+];
+var RETIRED_PACKAGE_DIRECTORIES = ["truthmark-preview"];
+var RETIRED_GENERATED_SURFACE_PATHS = [
+  "GEMINI.md",
+  ".github/prompts/truthmark-preview.prompt.md",
+  ".cursor/rules/truthmark-structure.mdc",
+  ".cursor/rules/truthmark-document.mdc",
+  ".cursor/rules/truthmark-sync.mdc",
+  ".cursor/rules/truthmark-realize.mdc",
+  ".cursor/rules/truthmark-check.mdc",
+  ".cursor/rules/truthmark-portal.mdc"
+];
+var RETIRED_GENERATED_SURFACE_ROOTS = [".gemini"];
+var isRetiredGeminiSurfacePath = (filePath) => filePath === "GEMINI.md" || filePath.startsWith(".gemini/");
+var obsoleteGeneratedSurfaceMessage = (surfacePath) => {
+  if (isRetiredGeminiSurfacePath(surfacePath)) {
+    return `Generated surface ${surfacePath} is obsolete; remove stale Gemini instructions manually if they are no longer wanted.`;
+  }
+  return `Generated surface ${surfacePath} is obsolete; rerun truthmark init.`;
+};
+var pathExists = async (absolutePath) => {
+  try {
+    await fs6.access(absolutePath);
+    return true;
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+};
+var listDirectoryFiles = async (rootDir, packageRoot) => {
+  const stack = [packageRoot];
+  const files = [];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    if (current === void 0) {
+      continue;
+    }
+    const absoluteCurrent = resolveRepoPath(rootDir, current);
+    const entries = await fs6.readdir(absoluteCurrent, {
+      withFileTypes: true
+    });
+    for (const entry of entries) {
+      const next = `${current}/${entry.name}`;
+      if (entry.isDirectory()) {
+        stack.push(next);
+      } else {
+        files.push(next);
+      }
+    }
+  }
+  return files;
+};
+var collectRetiredGeneratedSurfaces = async (rootDir, expectedSurfacePaths, options = {}) => {
+  const legacyCandidates = /* @__PURE__ */ new Set();
+  const includeGeminiSurfaces = options.includeGeminiSurfaces ?? true;
+  for (const retiredPath of RETIRED_GENERATED_SURFACE_PATHS) {
+    if (!includeGeminiSurfaces && isRetiredGeminiSurfacePath(retiredPath)) {
+      continue;
+    }
+    const absoluteRetiredPath = resolveRepoPath(rootDir, retiredPath);
+    if (await pathExists(absoluteRetiredPath) && !expectedSurfacePaths.has(retiredPath)) {
+      legacyCandidates.add(retiredPath);
+    }
+  }
+  for (const retiredRoot of RETIRED_GENERATED_SURFACE_ROOTS) {
+    if (!includeGeminiSurfaces && isRetiredGeminiSurfacePath(`${retiredRoot}/`)) {
+      continue;
+    }
+    const absoluteRetiredRoot = resolveRepoPath(rootDir, retiredRoot);
+    if (!await pathExists(absoluteRetiredRoot)) {
+      continue;
+    }
+    const retiredFiles = await listDirectoryFiles(rootDir, retiredRoot);
+    for (const filePath of retiredFiles) {
+      if (!expectedSurfacePaths.has(filePath)) {
+        legacyCandidates.add(filePath);
+      }
+    }
+  }
+  for (const skillRoot of GENERATED_HOST_SKILL_ROOTS) {
+    const absoluteSkillRoot = resolveRepoPath(rootDir, skillRoot);
+    let skillPackages = [];
+    try {
+      skillPackages = await fs6.readdir(absoluteSkillRoot, {
+        withFileTypes: true
+      });
+    } catch (error) {
+      if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+        continue;
+      }
+      throw error;
+    }
+    const packageNames = skillPackages.filter((entry) => entry.isDirectory() && entry.name.startsWith("truthmark-")).map((entry) => entry.name);
+    for (const packageName of RETIRED_PACKAGE_DIRECTORIES) {
+      if (!packageNames.includes(packageName)) {
+        continue;
+      }
+      const packageRoot = `${skillRoot}/${packageName}`;
+      const packageFiles = await listDirectoryFiles(rootDir, packageRoot);
+      for (const filePath of packageFiles) {
+        if (!expectedSurfacePaths.has(filePath)) {
+          legacyCandidates.add(filePath);
+        }
+      }
+    }
+    for (const packageName of packageNames) {
+      for (const retiredName of RETIRED_SKILL_HELPER_PATHS) {
+        const retiredPath = `${packageName}/${retiredName}`;
+        const relativeRetiredPath = `${skillRoot}/${retiredPath}`;
+        const absoluteRetiredPath = resolveRepoPath(rootDir, relativeRetiredPath);
+        if (await pathExists(absoluteRetiredPath) && !expectedSurfacePaths.has(relativeRetiredPath)) {
+          legacyCandidates.add(relativeRetiredPath);
+        }
+      }
+    }
+  }
+  return Array.from(legacyCandidates);
+};
+var checkGeneratedSurfaces = async (rootDir, config) => {
+  const diagnostics = [];
+  const renderedSurfaces = renderGeneratedSurfaces(config);
+  for (const surface of renderedSurfaces) {
+    const content = await readOptionalFile(rootDir, surface.path);
+    if (content === null) {
+      diagnostics.push({
+        category: "generated-surface",
+        severity: "review",
+        message: `Generated surface ${surface.path} is missing; rerun truthmark init.`,
+        file: surface.path
+      });
+      continue;
+    }
+    const comparableContent = normalizeGeneratedSurfaceContent(
+      surface.managedBlock ? extractManagedBlock(content) : content
+    );
+    const expectedContent = normalizeGeneratedSurfaceContent(surface.content);
+    if (comparableContent !== expectedContent) {
+      diagnostics.push({
+        category: "generated-surface",
+        severity: "review",
+        message: `Generated surface ${surface.path} is stale; rerun truthmark init.`,
+        file: surface.path
+      });
+    }
+  }
+  const staleSurfaces = await collectRetiredGeneratedSurfaces(
+    rootDir,
+    new Set(renderedSurfaces.map((surface) => surface.path))
+  );
+  for (const surfacePath of staleSurfaces) {
+    diagnostics.push({
+      category: "generated-surface",
+      severity: "review",
+      message: obsoleteGeneratedSurfaceMessage(surfacePath),
+      file: surfacePath
+    });
+  }
+  return diagnostics;
+};
+var findAutoRemovableRetiredGeneratedSurfaces = async (rootDir, expectedSurfacePaths) => {
+  return collectRetiredGeneratedSurfaces(rootDir, expectedSurfacePaths, {
+    includeGeminiSurfaces: false
+  });
+};
+
 // src/init/init.ts
 var escapeRegExp = (value) => {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -5275,7 +5033,7 @@ ${block}`;
 var writeManagedAgentsFile = async (rootDir, path12 = "AGENTS.md", block) => {
   let existingContent = null;
   try {
-    existingContent = await fs6.readFile(resolveRepoPath(rootDir, path12), "utf8");
+    existingContent = await fs7.readFile(resolveRepoPath(rootDir, path12), "utf8");
   } catch (error) {
     if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
       throw error;
@@ -5287,21 +5045,15 @@ var diagnosticCategoryForPath = (filePath, config) => {
   if (filePath === "AGENTS.md") {
     return "truth-sync";
   }
-  if (filePath === ".github/prompts/truthmark-realize.prompt.md" || filePath.startsWith(".github/skills/truthmark-realize/") || filePath.startsWith(".claude/skills/truthmark-realize/") || filePath.startsWith(".opencode/skills/truthmark-realize/") || filePath.startsWith(".agents/skills/truthmark-realize/") || filePath.startsWith(".gemini/skills/truthmark-realize/")) {
+  if (filePath === ".github/prompts/truthmark-realize.prompt.md" || filePath.startsWith(".github/skills/truthmark-realize/") || filePath.startsWith(".claude/skills/truthmark-realize/") || filePath.startsWith(".opencode/skills/truthmark-realize/") || filePath.startsWith(".agents/skills/truthmark-realize/") || filePath.startsWith(".antigravity/rules/truthmark-realize") || filePath.startsWith(".cursor/rules/truthmark-realize") || filePath.startsWith(".cursor/skills/truthmark-realize/")) {
     return "realization";
   }
-  if (filePath === "CLAUDE.md" || filePath === "GEMINI.md" || filePath === ".github/copilot-instructions.md" || filePath.startsWith(".github/prompts/truthmark-") || filePath.startsWith(".github/agents/truth-") || filePath.startsWith(".github/skills/truthmark-") || filePath.startsWith(".claude/agents/truth-") || filePath.startsWith(".claude/skills/truthmark-") || filePath.startsWith(".opencode/skills/truthmark-") || filePath.startsWith(".opencode/agents/") || filePath.startsWith(".codex/agents/") || filePath.startsWith(".gemini/agents/truth-") || filePath.startsWith(".gemini/skills/truthmark-")) {
+  if (filePath === "CLAUDE.md" || filePath === ".github/copilot-instructions.md" || filePath.startsWith(".github/prompts/truthmark-") || filePath.startsWith(".github/agents/truth-") || filePath.startsWith(".github/skills/truthmark-") || filePath.startsWith(".claude/agents/truth-") || filePath.startsWith(".claude/skills/truthmark-") || filePath.startsWith(".opencode/skills/truthmark-") || filePath.startsWith(".opencode/agents/") || filePath.startsWith(".codex/agents/") || filePath.startsWith(".antigravity/rules/truthmark-") || filePath.startsWith(".cursor/rules/truthmark-") || filePath.startsWith(".cursor/skills/truthmark-")) {
     return "truth-sync";
   }
   if (filePath.startsWith(".agents/skills/truthmark-")) {
     return "truth-sync";
   }
-  if (filePath.startsWith(".gemini/commands/truthmark/realize")) {
-    return "realization";
-  }
-  if (filePath.startsWith(".gemini/commands/truthmark/")) {
-    return "truth-sync";
-  }
   if (filePath === config.truthmark.paths.routesIndex) {
     return "area-index";
   }
@@ -5354,9 +5106,17 @@ var runInit = async (cwd) => {
   results.push(...await scaffoldHierarchy(rootDir, config));
   const block = renderAgentsBlock(config);
   const platformFiles = renderGeneratedSurfaces(config, block);
+  const expectedSurfacePaths = new Set(platformFiles.map((file) => file.path));
   for (const file of platformFiles) {
     results.push(await writePlatformFile(rootDir, file));
   }
+  const obsoleteSurfacePaths = await findAutoRemovableRetiredGeneratedSurfaces(
+    rootDir,
+    expectedSurfacePaths
+  );
+  for (const obsoletePath of obsoleteSurfacePaths) {
+    await fs7.rm(resolveRepoPath(rootDir, obsoletePath), { force: true });
+  }
   const changedResults = results.filter((result) => result.status !== "unchanged");
   return {
     command: "init",
@@ -5373,7 +5133,7 @@ var runInit = async (cwd) => {
 };
 
 // src/checks/branch-scope.ts
-import fs7 from "fs/promises";
+import fs8 from "fs/promises";
 import fg from "fast-glob";
 
 // src/markdown/hash.ts
@@ -5429,7 +5189,7 @@ var getBranchScopeData = async (cwd) => {
   }
   for (const relativePath of [...relevantFiles].sort()) {
     try {
-      const source = await fs7.readFile(resolveWorktreePath(repository, relativePath), "utf8");
+      const source = await fs8.readFile(resolveWorktreePath(repository, relativePath), "utf8");
       relevantFileHashes[relativePath] = hashText(source);
     } catch (error) {
       if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -5446,14 +5206,14 @@ var getBranchScopeData = async (cwd) => {
 };
 
 // src/checks/authority.ts
-import fs8 from "fs/promises";
+import fs9 from "fs/promises";
 import fg2 from "fast-glob";
 var looksLikeGlob = (pattern) => {
   return /[*?[\]{}()!+@]/u.test(pattern);
 };
-var pathExists = async (absolutePath) => {
+var pathExists2 = async (absolutePath) => {
   try {
-    await fs8.stat(absolutePath);
+    await fs9.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -5521,7 +5281,7 @@ var checkControlledPaths = async (rootDir, controlledPaths) => {
       });
       continue;
     }
-    if (!await pathExists(absoluteEntryPath)) {
+    if (!await pathExists2(absoluteEntryPath)) {
       diagnostics.push({
         category: "authority",
         severity: "error",
@@ -5545,7 +5305,7 @@ var checkAuthority = async (rootDir, config) => {
 };
 
 // src/checks/frontmatter.ts
-import fs9 from "fs/promises";
+import fs10 from "fs/promises";
 
 // src/markdown/frontmatter.ts
 import { parse as parse3 } from "yaml";
@@ -5647,7 +5407,7 @@ var checkFrontmatter = async (rootDir, config, markdownPaths, truthDocumentEntri
     }
     const absolutePath = resolveRepoPath(rootDir, markdownPath);
     await assertRepoContainment(rootDir, absolutePath);
-    const source = await fs9.readFile(absolutePath, "utf8");
+    const source = await fs10.readFile(absolutePath, "utf8");
     let document;
     try {
       parseFrontmatter(source, { throwOnInvalid: true });
@@ -5737,11 +5497,11 @@ var checkFrontmatter = async (rootDir, config, markdownPaths, truthDocumentEntri
 };
 
 // src/checks/links.ts
-import fs10 from "fs/promises";
+import fs11 from "fs/promises";
 import path5 from "path";
-var pathExists2 = async (absolutePath) => {
+var pathExists3 = async (absolutePath) => {
   try {
-    await fs10.stat(absolutePath);
+    await fs11.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -5757,7 +5517,7 @@ var checkLinks = async (rootDir, markdownPaths) => {
       continue;
     }
     const absolutePath = resolveRepoPath(rootDir, markdownPath);
-    const source = await fs10.readFile(absolutePath, "utf8");
+    const source = await fs11.readFile(absolutePath, "utf8");
     let document;
     try {
       document = parseMarkdownDocument(source);
@@ -5785,7 +5545,7 @@ var checkLinks = async (rootDir, markdownPaths) => {
         });
         continue;
       }
-      if (!await pathExists2(absoluteTarget)) {
+      if (!await pathExists3(absoluteTarget)) {
         diagnostics.push({
           category: "links",
           severity: "error",
@@ -5799,12 +5559,12 @@ var checkLinks = async (rootDir, markdownPaths) => {
 };
 
 // src/checks/areas.ts
-import fs12 from "fs/promises";
+import fs13 from "fs/promises";
 import fg4 from "fast-glob";
 import micromatch4 from "micromatch";
 
 // src/routing/area-resolver.ts
-import fs11 from "fs/promises";
+import fs12 from "fs/promises";
 import fg3 from "fast-glob";
 import micromatch2 from "micromatch";
 var unique = (values) => {
@@ -5855,7 +5615,7 @@ var ensureChildPath = async (rootDir, areaFilesRoot, filePath) => {
 var readRouteFile = async (rootDir, filePath) => {
   try {
     return {
-      source: await fs11.readFile(resolveRepoPath(rootDir, filePath), "utf8"),
+      source: await fs12.readFile(resolveRepoPath(rootDir, filePath), "utf8"),
       diagnostic: null
     };
   } catch (error) {
@@ -6136,7 +5896,7 @@ var classifyPath = (filePath, ignorePatterns) => {
   if (normalizedPath.startsWith(".truthmark/")) {
     return "derived";
   }
-  if (normalizedPath.startsWith(".agents/skills/truthmark-") || normalizedPath.startsWith(".claude/") || normalizedPath.startsWith(".codex/") || normalizedPath.startsWith(".gemini/agents/truth-") || normalizedPath.startsWith(".gemini/commands/") || normalizedPath.startsWith(".gemini/skills/truthmark-") || normalizedPath.startsWith(".opencode/") || normalizedPath === ".github/copilot-instructions.md" || normalizedPath.startsWith(".github/agents/truth-") || normalizedPath.startsWith(".github/prompts/truthmark-") || normalizedPath.startsWith(".github/skills/truthmark-") || normalizedPath === "AGENTS.md" || normalizedPath === "CLAUDE.md" || normalizedPath === "GEMINI.md" || normalizedPath.startsWith(".gemini/commands/truthmark/")) {
+  if (normalizedPath.startsWith(".agents/skills/truthmark-") || normalizedPath.startsWith(".claude/") || normalizedPath.startsWith(".codex/") || normalizedPath.startsWith(".opencode/") || normalizedPath.startsWith(".antigravity/rules/truthmark-") || normalizedPath.startsWith(".cursor/rules/truthmark-") || normalizedPath.startsWith(".cursor/skills/truthmark-") || normalizedPath === ".github/copilot-instructions.md" || normalizedPath.startsWith(".github/agents/truth-") || normalizedPath.startsWith(".github/prompts/truthmark-") || normalizedPath.startsWith(".github/skills/truthmark-") || normalizedPath === "AGENTS.md" || normalizedPath === "CLAUDE.md") {
     return "derived";
   }
   if (ignorePatterns.length > 0 && micromatch3.isMatch(normalizedPath, ignorePatterns)) {
@@ -6161,9 +5921,9 @@ var classifyPath = (filePath, ignorePatterns) => {
 var looksLikeGlob2 = (pattern) => {
   return /[*?[\]{}()!+@]/u.test(pattern);
 };
-var pathExists3 = async (absolutePath) => {
+var pathExists4 = async (absolutePath) => {
   try {
-    await fs12.stat(absolutePath);
+    await fs13.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -6453,7 +6213,7 @@ var checkAreas = async (rootDir, config) => {
         areaHasTruthDocumentErrors = true;
         continue;
       }
-      if (!await pathExists3(absoluteTruthDocumentPath)) {
+      if (!await pathExists4(absoluteTruthDocumentPath)) {
         diagnostics.push({
           category: "area-index",
           severity: "error",
@@ -6557,7 +6317,7 @@ var checkAreas = async (rootDir, config) => {
         entry.valid = false;
         continue;
       }
-      if (!await pathExists3(absoluteCodeSurfacePath)) {
+      if (!await pathExists4(absoluteCodeSurfacePath)) {
         diagnostics.push({
           category: "area-index",
           severity: "error",
@@ -6604,7 +6364,7 @@ var checkAreas = async (rootDir, config) => {
 };
 
 // src/checks/decisions.ts
-import fs13 from "fs/promises";
+import fs14 from "fs/promises";
 import micromatch5 from "micromatch";
 var PRODUCT_CAPABILITY_REQUIRED_HEADINGS = [
   "Capability Promise",
@@ -6720,7 +6480,7 @@ var checkDecisionSections = async (rootDir, config, markdownPaths, truthDocument
     (filePath) => truthDocumentMap.has(filePath) || isDecisionTruthCandidate(config, filePath)
   ).sort();
   for (const filePath of candidatePaths) {
-    const source = await fs13.readFile(
+    const source = await fs14.readFile(
       resolveRepoPath(rootDir, filePath),
       "utf8"
     );
@@ -6761,61 +6521,6 @@ var checkDecisionSections = async (rootDir, config, markdownPaths, truthDocument
   return diagnostics;
 };
 
-// src/checks/generated-surfaces.ts
-import fs14 from "fs/promises";
-var readOptionalFile = async (rootDir, filePath) => {
-  try {
-    return await fs14.readFile(resolveRepoPath(rootDir, filePath), "utf8");
-  } catch (error) {
-    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-      return null;
-    }
-    throw error;
-  }
-};
-var extractManagedBlock = (content) => {
-  const startIndex = content.indexOf(TRUTHMARK_BLOCK_START);
-  const endIndex = content.indexOf(TRUTHMARK_BLOCK_END);
-  if (startIndex === -1 || endIndex === -1 || endIndex < startIndex) {
-    return null;
-  }
-  return content.slice(startIndex, endIndex + TRUTHMARK_BLOCK_END.length);
-};
-var normalizeGeneratedSurfaceContent = (content) => {
-  if (content === null) {
-    return null;
-  }
-  return content.replace(/\r\n/g, "\n").replace(/\n$/u, "");
-};
-var checkGeneratedSurfaces = async (rootDir, config) => {
-  const diagnostics = [];
-  for (const surface of renderGeneratedSurfaces(config)) {
-    const content = await readOptionalFile(rootDir, surface.path);
-    if (content === null) {
-      diagnostics.push({
-        category: "generated-surface",
-        severity: "review",
-        message: `Generated surface ${surface.path} is missing; rerun truthmark init.`,
-        file: surface.path
-      });
-      continue;
-    }
-    const comparableContent = normalizeGeneratedSurfaceContent(
-      surface.managedBlock ? extractManagedBlock(content) : content
-    );
-    const expectedContent = normalizeGeneratedSurfaceContent(surface.content);
-    if (comparableContent !== expectedContent) {
-      diagnostics.push({
-        category: "generated-surface",
-        severity: "review",
-        message: `Generated surface ${surface.path} is stale; rerun truthmark init.`,
-        file: surface.path
-      });
-    }
-  }
-  return diagnostics;
-};
-
 // src/impact/build.ts
 import path10 from "path";
 import micromatch7 from "micromatch";
@@ -7195,7 +6900,7 @@ var listChangedPaths = async (cwd, args) => {
   const result = await execa3("git", args, { cwd });
   return result.stdout.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).map((line) => normalizePath3(line));
 };
-var pathExists4 = async (filePath) => {
+var pathExists5 = async (filePath) => {
   try {
     await fs17.access(filePath);
     return true;
@@ -7241,7 +6946,7 @@ var getUncommittedChanges = async (cwd) => {
   const deletedPathCandidates = /* @__PURE__ */ new Set([...stagedDeletedPaths, ...unstagedDeletedPaths]);
   for (const deletedPath of deletedPathCandidates) {
     const change = getOrCreateChange(changesByPath, deletedPath);
-    change.deleted = !await pathExists4(path9.join(rootDir, deletedPath));
+    change.deleted = !await pathExists5(path9.join(rootDir, deletedPath));
   }
   return Array.from(changesByPath.values()).sort((left, right) => {
     return left.path.localeCompare(right.path);
@@ -7499,7 +7204,7 @@ var parseEvidenceReferences = async (rootDir, truthDocPath) => {
 };
 
 // src/evidence/validate.ts
-var pathExists5 = async (filePath) => {
+var pathExists6 = async (filePath) => {
   try {
     await fs19.access(filePath);
     return true;
@@ -7575,7 +7280,7 @@ var validateReference = async (rootDir, reference) => {
     }
     const absolutePath = resolveRepoPath(rootDir, reference.path);
     await assertRepoContainment(rootDir, absolutePath);
-    if (!await pathExists5(absolutePath)) {
+    if (!await pathExists6(absolutePath)) {
       diagnostics.push(diagnosticFor(reference, `Referenced file ${reference.path} does not exist.`));
       return diagnostics;
     }
@@ -7837,6 +7542,7 @@ var runCheck = async (cwd, options = {}) => {
 
 // src/workflow-state/build.ts
 import { execa as execa5 } from "execa";
+import micromatch8 from "micromatch";
 
 // src/workflow-state/action-context.ts
 var uniqueSorted3 = (values) => [...new Set(values.filter((value) => value.length > 0))].sort();
@@ -7870,7 +7576,7 @@ var baseContext = (manifestEntry, mode, allowedWritePaths, routeFiles, primaryTr
   writeLeaseRequired
 });
 var buildWorkflowActionContext = (manifestEntry, data = {}) => {
-  if (manifestEntry.id === "truthmark-preview" || manifestEntry.id === "truthmark-check") {
+  if (manifestEntry.id === "truthmark-check") {
     return baseContext(manifestEntry, "read-only", [], [], [], [], [], false);
   }
   if (manifestEntry.id === "truthmark-sync" || manifestEntry.id === "truthmark-document") {
@@ -7946,7 +7652,7 @@ var helperCommandsFor2 = (workflow) => (TRUTHMARK_WORKFLOW_MANIFEST[workflow].he
   optional: helper.optional
 }));
 var uniqueSorted4 = (values) => [...new Set(values.filter((value) => value.length > 0))].sort();
-var isWriteCapable = (workflow) => !["truthmark-preview", "truthmark-check"].includes(workflow);
+var isWriteCapable = (workflow) => workflow !== "truthmark-check";
 var DEFAULT_BASE_CANDIDATES = [
   "@{upstream}",
   "origin/main",
@@ -7974,9 +7680,67 @@ var selectComparisonBase = async (rootDir, suppliedBase) => {
   return null;
 };
 var routeFilesFor = (repoIndex) => uniqueSorted4(repoIndex.routeMap.routes.map((route) => route.sourcePath));
-var candidateStaleTruthDocsFor = (indexedTruthDocs, primaryTruthDocs) => {
+var candidateStaleTruthDocsFor = (repoIndex, primaryTruthDocs, impactSet, diagnostics) => {
+  const indexedTruthDocs = new Set(
+    repoIndex.routeMap.routes.flatMap((route) => route.truthDocs)
+  );
   const primary = new Set(primaryTruthDocs);
-  return indexedTruthDocs.filter((truthDoc) => !primary.has(truthDoc));
+  const candidates = /* @__PURE__ */ new Set();
+  const changedPaths = new Set(
+    (impactSet?.changedFiles ?? []).flatMap((file) => [
+      file.path,
+      ...file.previousPath ? [file.previousPath] : []
+    ])
+  );
+  const docEntries = new Map(
+    repoIndex.routeMap.routes.flatMap((route) => route.truthDocumentEntries).map((entry) => [entry.path, entry])
+  );
+  const addCandidate = (truthDoc) => {
+    if (indexedTruthDocs.has(truthDoc) && !primary.has(truthDoc)) {
+      candidates.add(truthDoc);
+    }
+  };
+  const linkedTruthDocs = (truthDoc) => {
+    const entry = docEntries.get(truthDoc);
+    return uniqueSorted4([
+      ...entry?.realizedBy ?? [],
+      ...entry?.realizes ?? [],
+      ...entry?.dependsOn ?? [],
+      ...[...docEntries.values()].filter(
+        (candidate) => candidate.realizedBy.includes(truthDoc) || candidate.realizes.includes(truthDoc) || candidate.dependsOn.includes(truthDoc)
+      ).map((candidate) => candidate.path)
+    ]);
+  };
+  for (const truthDoc of [...primary, ...changedPaths].filter(
+    (path12) => indexedTruthDocs.has(path12)
+  )) {
+    for (const linkedTruthDoc of linkedTruthDocs(truthDoc)) {
+      addCandidate(linkedTruthDoc);
+    }
+  }
+  for (const diagnostic of diagnostics) {
+    if (diagnostic.category === "freshness" && diagnostic.file) {
+      addCandidate(diagnostic.file);
+    }
+  }
+  for (const route of repoIndex.routeMap.routes) {
+    if (changedPaths.has(route.sourcePath)) {
+      route.truthDocs.forEach(addCandidate);
+    }
+  }
+  for (const doc of repoIndex.docs) {
+    if (!indexedTruthDocs.has(doc.path) || primary.has(doc.path)) {
+      continue;
+    }
+    if (doc.sourceOfTruth.some(
+      (reference) => [...changedPaths].some(
+        (changedPath) => reference === changedPath || micromatch8.isMatch(changedPath, reference)
+      )
+    )) {
+      candidates.add(doc.path);
+    }
+  }
+  return uniqueSorted4([...candidates]);
 };
 var hasUnmappedFunctionalChange = (impactSet) => impactSet?.diagnostics.some(
   (diagnostic) => diagnostic.category === "impact" && /not mapped to a Truthmark route|no affected truth document/u.test(
@@ -8042,7 +7806,7 @@ var workflowCardFor = (workflow, applicability, diagnostics, impactSet) => {
     }))
   };
 };
-var contextDataFor = (workflow, repoIndex, config, impactSet) => {
+var contextDataFor = (workflow, repoIndex, config, impactSet, diagnostics) => {
   if (!config) {
     return {};
   }
@@ -8051,7 +7815,12 @@ var contextDataFor = (workflow, repoIndex, config, impactSet) => {
     repoIndex.routeMap.routes.flatMap((route) => route.truthDocs)
   );
   const primaryTruthDocs = uniqueSorted4(impactSet?.affectedTruthDocs ?? []);
-  const candidateStaleTruthDocs = workflow === "truthmark-sync" ? candidateStaleTruthDocsFor(indexedTruthDocs, primaryTruthDocs) : [];
+  const candidateStaleTruthDocs = workflow === "truthmark-sync" ? candidateStaleTruthDocsFor(
+    repoIndex,
+    primaryTruthDocs,
+    impactSet,
+    diagnostics
+  ) : [];
   const truthDocs = workflow === "truthmark-sync" ? uniqueSorted4([...primaryTruthDocs, ...candidateStaleTruthDocs]) : uniqueSorted4(impactSet?.affectedTruthDocs ?? indexedTruthDocs);
   return {
     routeIndexPath: config.truthmark.paths.routesIndex,
@@ -8111,7 +7880,8 @@ var buildWorkflowState = async (cwd, options) => {
     options.workflow,
     repoIndex,
     loadResult.config,
-    impactSet
+    impactSet,
+    diagnostics
   );
   return {
     schemaVersion: "truthmark-workflow/v0",
@@ -8202,7 +7972,6 @@ var validateEvidenceChecked = (text, errors, checks) => {
 };
 var validateHelperScriptEntries = (entries, requiredHelpers, errors, checks) => {
   if (entries === void 0 || entries.length === 0) {
-    errors.push("Helper scripts must include status for optional helpers");
     return;
   }
   const statusPattern = /^(?:-\s*)?([a-z0-9-]+):\s*(?:ran,\s*passed|skipped,\s*\S.*)$/iu;
@@ -8222,7 +7991,7 @@ var validateHelperScriptEntries = (entries, requiredHelpers, errors, checks) =>
       errors.push(`missing Helper scripts status: ${helperId}`);
     }
   }
-  if (errors.length === 0) {
+  if (errors.length === 0 && requiredHelpers.length > 0) {
     checks.push(`Helper scripts statuses include ${requiredHelpers.join(", ")}`);
   }
 };
@@ -8267,15 +8036,20 @@ var validateTruthSyncReportText = (text) => {
           "Evidence checked entries include Claim:, Evidence:, and Result: supported | narrowed | removed | blocked"
         );
       }
+      const completedTargets = [
+        ...report.truthDocsUpdated,
+        ...report.syncIntent?.targetTruthDocs ?? []
+      ];
+      const bootstrapTargets = completedTargets.filter(isBootstrapRoutingDocPath);
+      if (bootstrapTargets.length > 0) {
+        errors.push(
+          `bootstrap-routing.md is a provisional topology handoff, not a completed behavior-update target: ${bootstrapTargets.join(", ")}`
+        );
+      }
       if (report.syncIntent !== void 0) {
         checks.push("Sync Intent");
       }
-      validateHelperScriptEntries(
-        report.helperScripts,
-        ["validate-write-lease"],
-        errors,
-        checks
-      );
+      validateHelperScriptEntries(report.helperScripts, [], errors, checks);
     } catch (error) {
       errors.push(error instanceof Error ? error.message : "invalid Truth Sync report");
     }
@@ -8310,11 +8084,6 @@ var validateTruthDocumentReportText = (text) => {
     } else {
       errors.push("missing required section: Evidence checked");
     }
-    if (hasLabel(text, "Helper scripts")) {
-      checks.push("Helper scripts");
-    } else {
-      errors.push("missing required section: Helper scripts");
-    }
     const truthDocsUpdated = getSection(text, "Truth docs updated");
     const truthDocsCreated = getSection(text, "Truth docs created");
     if (truthDocsUpdated === null && truthDocsCreated === null) {
@@ -8327,7 +8096,7 @@ var validateTruthDocumentReportText = (text) => {
       checks.push("Truth docs updated or created");
     }
     validateEvidenceChecked(text, errors, checks);
-    validateHelperScripts(text, ["validate-write-lease"], errors, checks);
+    validateHelperScripts(text, [], errors, checks);
   } else if (status === "blocked") {
     requireBulletSection(text, "Reason", errors, checks);
   }
@@ -8335,6 +8104,7 @@ var validateTruthDocumentReportText = (text) => {
 };
 var cleanPathValue = (value) => value.trim().replace(/^["']|["']$/gu, "");
 var normalizePath5 = (value) => cleanPathValue(value).replace(/^\.\//u, "");
+var isBootstrapRoutingDocPath = (value) => normalizePath5(value).endsWith("/bootstrap-routing.md");
 var windowsDriveAbsolutePattern = /^[A-Za-z]:[\\/]/u;
 var uncPathPattern = /^[/\\]{2}[^/\\]+[/\\]+[^/\\]+/u;
 var isUnsafePathValue = (value) => {