truthmark 2.2.0 → 2.2.2

package/dist/main.js

@@ -618,14 +618,14 @@ var parseTruthDocumentsFromYaml = (sectionLines, areaName, options) => {
   const diagnostics = [];
   const truthDocumentEntries = [];
   for (const rawEntry of rawEntries) {
-    const path14 = rawEntry && typeof rawEntry === "object" && "path" in rawEntry ? rawEntry.path : null;
+    const path12 = rawEntry && typeof rawEntry === "object" && "path" in rawEntry ? rawEntry.path : null;
     const kind = rawEntry && typeof rawEntry === "object" && "kind" in rawEntry ? rawEntry.kind : null;
     const lane = rawEntry && typeof rawEntry === "object" && "lane" in rawEntry ? rawEntry.lane : null;
-    const inferredKind = typeof path14 === "string" ? inferTruthDocumentKindFromPath(path14, options) : null;
-    const inferredLane = typeof path14 === "string" ? inferTruthDocumentLaneFromPath(path14, options) : null;
+    const inferredKind = typeof path12 === "string" ? inferTruthDocumentKindFromPath(path12, options) : null;
+    const inferredLane = typeof path12 === "string" ? inferTruthDocumentLaneFromPath(path12, options) : null;
     const normalizedKind = isTruthDocumentKind(kind) ? kind : inferredKind;
     const normalizedLane = lane === "product" || lane === "engineering" ? lane : normalizedKind ? laneForTruthDocumentKind(normalizedKind) : inferredLane;
-    if (typeof path14 !== "string" || path14.trim().length === 0 || !normalizedKind || !normalizedLane) {
+    if (typeof path12 !== "string" || path12.trim().length === 0 || !normalizedKind || !normalizedLane) {
       diagnostics.push(
         createAreaDiagnostic(
           `Area ${areaName} truth_documents entries must include non-empty path plus valid lane and kind fields.`,
@@ -635,7 +635,7 @@ var parseTruthDocumentsFromYaml = (sectionLines, areaName, options) => {
       continue;
     }
     truthDocumentEntries.push({
-      path: path14.trim(),
+      path: path12.trim(),
       kind: normalizedKind,
       kindSource: isTruthDocumentKind(kind) ? "explicit" : "inferred",
       lane: normalizedLane,
@@ -853,7 +853,7 @@ var renderChildAreaTemplate = (config) => {
   const defaultArea = config.truthmark.routes.defaultArea;
   const title = titleCase(defaultArea);
   const truthDocsRoot = truthRoot(config);
-  const leafTruthDoc = `${truthDocsRoot}/${defaultArea}/overview.md`;
+  const bootstrapTruthDoc = `${truthDocsRoot}/${defaultArea}/bootstrap-routing.md`;
   const templatePath = `${config.truthmark.paths.routeAreasRoot}/${defaultArea}.md`;
   const sourceOfTruth = resolveRelativePath(
     templatePath,
@@ -873,16 +873,20 @@ var renderChildAreaTemplate = (config) => {
     "Truth documents:",
     "```yaml",
     "truth_documents:",
-    `  - path: ${leafTruthDoc}`,
-    "    kind: engineering-behavior",
+    `  - path: ${bootstrapTruthDoc}`,
+    "    kind: engineering-workflow",
     "    lane: engineering",
     "```",
     "",
+    "This is a provisional bootstrap route. It exists only to make fresh repositories routeable until real product, service, domain, or ownership areas are created.",
+    "",
     "Code surface:",
     "- src/**",
     "",
     "Update truth when:",
-    "- behavior changes affect repository truth",
+    "- this provisional bootstrap route is the only match for a real code surface",
+    "- route ownership is still broad, mixed, or ambiguous",
+    "- Run Truth Structure before normal Truth Sync so the touched code gets a bounded owner",
     "",
     "## Source References",
     "",
@@ -890,6 +894,103 @@ var renderChildAreaTemplate = (config) => {
     ""
   ].join("\n");
 };
+var renderBootstrapRoutingDocTemplate = (config) => {
+  const defaultArea = config.truthmark.routes.defaultArea;
+  const title = titleCase(defaultArea);
+  const templatePath = `${truthRoot(config)}/${defaultArea}/bootstrap-routing.md`;
+  const routePath = `${config.truthmark.paths.routeAreasRoot}/${defaultArea}.md`;
+  const routeSource = resolveRelativePath(templatePath, routePath);
+  const configSource = resolveRelativePath(
+    templatePath,
+    ".truthmark/config.yml"
+  );
+  const today = currentDate();
+  return [
+    "---",
+    "status: active",
+    "truth_kind: engineering-workflow",
+    `last_reviewed: ${today}`,
+    "---",
+    "",
+    `# ${title} Bootstrap Routing`,
+    "",
+    "## Purpose",
+    "",
+    `This doc records the provisional broad route for ${defaultArea}.`,
+    "This doc is a bootstrap handoff, not a behavior truth dumping ground.",
+    "It is not a substitute for bounded product and engineering truth docs.",
+    "",
+    "## Scope",
+    "",
+    "This doc owns only the initial routing workflow for a fresh Truthmark repository whose default route still maps a broad code surface such as `src/**`.",
+    "It does not own implementation behavior under that code surface.",
+    "",
+    "## Current Implementation Behavior",
+    "",
+    "The scaffold creates this provisional bootstrap handoff only when a default broad route needs a canonical owner. Agents use it as a signal to run Truth Structure and create bounded routes before normal Truth Sync, not as a place to accumulate implementation claims.",
+    "",
+    "## Product Truth Links",
+    "",
+    "- None. This is an engineering bootstrap handoff for routing setup, not a product promise.",
+    "",
+    "## Triggers",
+    "",
+    "- A real code change maps only to this provisional broad route.",
+    "- Truth Sync cannot identify a specific behavior-owned route and bounded truth owner.",
+    "- A maintainer or agent is onboarding the first real product, service, domain, package, or ownership area.",
+    "",
+    "## Inputs",
+    "",
+    "- Current route files under the configured Truthmark route root.",
+    "- The touched code, tests, configuration, and existing docs needed to infer the smallest real owner.",
+    "- Repository instruction files that exist in the checkout.",
+    "",
+    "## Execution Model",
+    "",
+    "Run Truth Structure before normal Truth Sync when real code changes touch only this broad route. Truth Structure should create or repair bounded areas first; Truth Sync should then update the bounded owner docs.",
+    "",
+    "## Steps",
+    "",
+    "1. Treat this route as provisional and insufficient for normal behavior maintenance.",
+    "2. Inspect the touched code/test surface and infer the narrowest durable owner.",
+    "3. Create or repair route entries and truth docs for that owner.",
+    "4. Leave this bootstrap doc small; do not append behavior details here.",
+    "5. Resume Truth Sync only after the touched code resolves to a bounded owner.",
+    "",
+    "## State, Retry, And Failure Behavior",
+    "",
+    "If ownership cannot be inferred safely, stop and report manual-review files instead of widening this route or adding generic behavior prose.",
+    "",
+    "## Outputs",
+    "",
+    "- Bounded route areas and lane-appropriate truth docs for the touched surface.",
+    "- A compact manual handoff report when ownership remains ambiguous.",
+    "",
+    "## Engineering Decisions",
+    "",
+    `- Decision (${today}): Default broad routing is provisional bootstrap state. Agents should create bounded areas before normal Truth Sync rather than extending a catch-all overview doc.`,
+    "",
+    "## Rationale",
+    "",
+    "Scoped ownership keeps agent context close to affected files and prevents broad default docs from absorbing unrelated behavior. This preserves agent-native truth maintenance without adding a token-heavy discovery layer.",
+    "",
+    "## Non-Goals",
+    "",
+    "- This doc is not a repository behavior overview.",
+    "- This doc is not a product capability or engineering behavior owner.",
+    "- This doc is not a permanent home for claims about files under `src/**`.",
+    "",
+    "## Maintenance Notes",
+    "",
+    "Keep this doc short. When a repository has real bounded routes, prefer updating those routes and their truth docs instead of expanding this bootstrap handoff.",
+    "",
+    "## Source References",
+    "",
+    `- ${routeSource}`,
+    `- ${configSource}`,
+    ""
+  ].join("\n");
+};
 var renderTruthRootReadmeTemplate = (config = createDefaultConfig(), lane = "engineering") => {
   const templatePath = `${lane === "product" ? resolveProductTruthRoot(config) : resolveEngineeringTruthRoot(config)}/README.md`;
   const sourceOfTruth = resolveRelativePath(
@@ -940,7 +1041,7 @@ var renderTruthDomainReadmeTemplate = (config) => {
     "",
     "Current leaf docs:",
     "",
-    "- [Overview](overview.md)",
+    "- [Bootstrap routing](bootstrap-routing.md)",
     "",
     "## Source References",
     "",
@@ -948,7 +1049,6 @@ var renderTruthDomainReadmeTemplate = (config) => {
     ""
   ].join("\n");
 };
-var BEHAVIOR_DOC_TEMPLATE_PATH = "docs/truthmark/templates/engineering-behavior.md";
 var renderTemplateSection = (section) => {
   return [
     section.heading,
@@ -1363,7 +1463,7 @@ var renderContractDocTemplateFile = () => {
     ]),
     sectionSpec("## Compatibility Rules", [
       "State backward/forward compatibility guarantees, tolerated inputs, deprecation rules, and breaking-change triggers.",
-      "Include compatibility tests or review gates that protect the contract."
+      "Include compatibility tests or review questions that protect the contract."
     ]),
     sectionSpec("## Versioning And Migration", [
       "Document version negotiation, schema/API version fields, rollout requirements, migration steps, and rollback expectations.",
@@ -1411,7 +1511,7 @@ var renderWorkflowDocTemplateFile = () => {
     ]),
     sectionSpec("## Execution Model", [
       "Describe synchronous/asynchronous execution, concurrency, locking, leases, batching, ordering, and idempotency behavior.",
-      "State whether the workflow is user-blocking, background, distributed, or delegated to another system."
+      "State whether the workflow waits for user action, runs in the background, is distributed, or is delegated to another system."
     ]),
     sectionSpec("## Steps", [
       "Capture the current ordered steps or phases at a level useful for maintenance and review.",
@@ -1447,7 +1547,7 @@ var renderOperationsDocTemplateFile = () => {
     ]),
     sectionSpec("## Deployment And Rollback", [
       "Describe deployment mechanism, migration ordering, compatibility windows, rollback path, and known irreversible operations.",
-      "Call out manual gates, smoke checks, and post-deploy verification responsibilities."
+      "Call out manual review points, smoke checks, and post-deploy verification responsibilities."
     ]),
     sectionSpec("## Availability And Observability", [
       "Capture availability expectations, health checks, metrics, logs, traces, alerts, SLO/error-budget signals, and known blind spots.",
@@ -1483,39 +1583,6 @@ var renderTestBehaviorDocTemplateFile = () => {
     ])
   ]);
 };
-var renderTemplate = (template, values) => {
-  return Object.entries(values).reduce((rendered, [key, value]) => {
-    return rendered.split(`{{${key}}}`).join(value);
-  }, template);
-};
-var renderBehaviorLeafDocTemplate = (config, template = renderBehaviorDocTemplateFile()) => {
-  const defaultArea = config.truthmark.routes.defaultArea;
-  const title = titleCase(defaultArea);
-  const templatePath = `${truthRoot(config)}/${defaultArea}/overview.md`;
-  const sourceOfTruth = resolveRelativePath(
-    templatePath,
-    `${config.truthmark.paths.routeAreasRoot}/${defaultArea}.md`
-  );
-  const today = currentDate();
-  return renderTemplate(template, {
-    area: defaultArea,
-    contracts: "- External contracts should link to the nearest canonical contract doc when one exists.",
-    core_rules: "- Truth README files are indexes; behavior truth belongs in bounded leaf docs.",
-    current_implementation_behavior: "- Document current behavior here when implementation changes make repository truth incomplete.",
-    engineering_decisions: `- Decision (${today}): Truth README files are indexes; behavior truth belongs in bounded leaf docs.`,
-    flows_and_states: "- None beyond current behavior.",
-    maintenance_notes: "- Update this doc when routed implementation changes alter current behavior, rules, contracts, or decisions.",
-    non_goals: "- This doc is not a catch-all for unrelated repository behavior.",
-    purpose: `Describe why the default ${title.toLowerCase()} behavior surface exists and what outcome it protects.`,
-    rationale: "Bounded leaf docs keep agent context focused and prevent large products from accumulating unreviewable feature manuals.",
-    product_truth_links: "- None.",
-    scope: `This bounded leaf truth doc owns the default ${title.toLowerCase()} behavior surface created by Truthmark.`,
-    source_references: `- ${sourceOfTruth}`,
-    template_path: BEHAVIOR_DOC_TEMPLATE_PATH,
-    title: `${title} Overview`,
-    truth_kind: "engineering-behavior"
-  });
-};
 
 // src/config/command.ts
 var CONFIG_PATH = ".truthmark/config.yml";
@@ -1594,7 +1661,7 @@ var runConfig = async (cwd, options = {}) => {
 };
 
 // src/init/init.ts
-import fs7 from "fs/promises";
+import fs6 from "fs/promises";
 
 // src/config/load.ts
 import fs4 from "fs/promises";
@@ -1840,22 +1907,6 @@ var rootIndexReferencesChildRoute = async (rootDir, rootIndexPath, childRoutePat
 var truthTemplatePath = (config, fileName) => {
   return `${config.truthmark.paths.templatesRoot}/${fileName}`;
 };
-var readBehaviorDocTemplate = async (rootDir, config) => {
-  try {
-    return await fs5.readFile(
-      resolveRepoPath(
-        rootDir,
-        truthTemplatePath(config, BEHAVIOR_DOC_TEMPLATE_FILE_NAME)
-      ),
-      "utf8"
-    );
-  } catch (error) {
-    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-      return renderBehaviorDocTemplateFile();
-    }
-    throw error;
-  }
-};
 var ensureOrUpdateTruthDocTemplate = async (rootDir, templatePath, defaultTemplate) => {
   const seededResult = await ensureRepoFile(
     rootDir,
@@ -1970,12 +2021,11 @@ var scaffoldHierarchy = async (rootDir, config) => {
       renderProductCapabilityDocTemplateFile()
     )
   );
-  const behaviorDocTemplate = await readBehaviorDocTemplate(rootDir, config);
   results.push(
     await ensureRepoFile(
       rootDir,
-      `${truthDomainRoot}/overview.md`,
-      renderBehaviorLeafDocTemplate(config, behaviorDocTemplate)
+      `${truthDomainRoot}/bootstrap-routing.md`,
+      renderBootstrapRoutingDocTemplate(config)
     )
   );
   return results;
@@ -2029,7 +2079,7 @@ var renderReadOnlyLaneClassificationRuleBlock = (config = defaultAgentConfig(),
       `product-lane ownership belongs under ${productTruthRoot} and describes product promises, boundaries, rationale, decisions, and success criteria`,
       `engineering-lane ownership belongs under ${engineeringTruthRoot} and describes source-backed current realization, contracts, architecture, workflows, operations, or tests`,
       "both-lane ownership uses separate product and engineering docs cross-linked in route YAML with realized_by and realizes, not in doc frontmatter",
-      "ambiguous lane ownership should be reported as blocked or routed to Truth Structure",
+      "ambiguous lane ownership should be reported for manual handoff or routed to Truth Structure",
       LANE_INVARIANT
     ].join("\n"),
     indent
@@ -2045,12 +2095,12 @@ var renderLaneClassificationInstructions = (config = defaultAgentConfig()) => {
   const productTruthRoot = resolveProductTruthRoot(config);
   const engineeringTruthRoot = resolveEngineeringTruthRoot(config);
   return [
-    "Lane classification gate:",
+    "Lane review questions:",
     "- before writing canonical truth docs, classify the request or change as product-lane, engineering-lane, both-lane, or ambiguous",
     `- product-lane writes belong under ${productTruthRoot} and state product promises, boundaries, rationale, decisions, and success criteria`,
     `- engineering-lane writes belong under ${engineeringTruthRoot} and state source-backed current realization, contracts, architecture, workflows, operations, or tests`,
     "- both-lane work must write separate product and engineering docs and cross-link them in route YAML with realized_by and realizes, not in doc frontmatter",
-    "- ambiguous lane ownership must block or invoke Truth Structure instead of writing a mixed document",
+    "- ambiguous lane ownership must stop or invoke Truth Structure instead of writing a mixed document",
     `- ${LANE_INVARIANT}`
   ].join("\n");
 };
@@ -2059,7 +2109,7 @@ var EVIDENCE_AUTHORITY_INSTRUCTIONS = [
   "Implementation code and canonical truth docs are inspected evidence for current behavior; they do not silently override workflow write boundaries."
 ].join("\n");
 var REPOSITORY_INTELLIGENCE_INSTRUCTIONS = [
-  "Repository intelligence artifacts are optional derived context: RepoIndex, RouteMap, ImpactSet, and ContextPack may guide routing, context selection, and verification planning when available.",
+  "Repository intelligence artifacts are optional derived context: RepoIndex, RouteMap, ImpactSet, and WorkflowState/action context may guide routing, write boundaries, and verification planning when available.",
   "They do not override checkout evidence, canonical truth docs, route files, or workflow write boundaries.",
   "If unavailable, inspect any present Truthmark config, route files, source files, truth docs, and tests directly, then report that repository-intelligence artifacts were not generated."
 ].join("\n");
@@ -2073,29 +2123,29 @@ var FEATURE_DOC_TEMPLATE_INSTRUCTIONS = [
 ].join("\n");
 var renderTruthDocOwnershipGateSection = (subject, outcome) => {
   return [
-    "Truth-doc ownership gate:",
+    "Truth-doc ownership review:",
     `- before editing or relying on ${subject}, verify each target/source truth doc is a bounded owner for the behavior`,
     "- if a target/source doc mixes independent owners, spans unrelated behaviors, acts as an index, or needs cross-owner edits, do not patch or in-place repair it",
     `- ${outcome}`,
-    "- report Ownership reviewed, Structure required, Truth docs split, Truth docs restructured, or Blocked reason as applicable"
+    "- report Ownership reviewed, Structure required, Truth docs split, Truth docs restructured, or Manual handoff reason as applicable"
   ].join("\n");
 };
 var TRUTH_DOC_DECISION_RATIONALE_PRESERVATION_INSTRUCTIONS = [
-  "Decision/Rationale preservation gate:",
+  "Decision/Rationale preservation review:",
   "- before any truth-doc split, restructure, or shape repair, inventory existing Product Decisions, Engineering Decisions, and Rationale sections in every source or touched truth doc",
   "- preserve each current decision and rationale in the correct product or engineering lane owner; when splitting, move it to the new owner doc rather than deleting it or leaving it in an index",
   "- remove or narrow a decision or rationale only when checkout evidence shows it is stale or unsupported, and report the exact claim, evidence, and result",
-  "- if ownership of a decision or rationale is unclear, block with manual-review files instead of deleting it or guessing",
+  "- if ownership of a decision or rationale is unclear, stop with manual-review files instead of deleting it or guessing",
   "- after the edit, verify every touched truth doc keeps lane-appropriate decision/rationale sections and every pre-existing entry is preserved, moved, narrowed, removed with evidence, or blocked"
 ].join("\n");
 var renderTruthDocRestructureGateSection = (scope) => {
   return [
-    "Truth-doc shape repair gate:",
+    "Truth-doc shape repair review:",
     `- ${scope}`,
-    "- repair shape in place only after the ownership gate confirms the doc is the right bounded owner",
+    "- repair shape in place only after the ownership review confirms the doc is the right bounded owner",
     "- use Truth Structure for ownership splits; do not treat broad or mixed-owner docs as in-place repair work",
     "- repair shape when a narrow edit would make truth worse: missing template sections, stale evidence conflicts, cross-section updates within one owner, or wrong frontmatter/source/headings",
-    "- preserve supported claims; remove, narrow, or block unsupported or stale claims",
+    "- preserve supported claims; remove, narrow, or record unsupported or stale claims for manual handoff",
     "- report docs restructured and why a narrow edit was not sufficient"
   ].join("\n");
 };
@@ -2105,26 +2155,26 @@ var ARCHITECTURE_DOC_BOUNDARY_INSTRUCTIONS = [
 ].join("\n");
 var renderRouteFirstEvidenceGateSection = (subject, noImpactedDocOutcome) => {
   return [
-    "Evidence Gate:",
+    "Evidence checklist:",
     `- route-first: map ${subject} to bounded route owners and primary canonical docs`,
     "- review new or changed behavior-bearing claims only in touched docs, route ownership, lane-specific decisions, and rationale",
     "- support claims with primary checkout evidence: implementation, config, routing, generated templates, schemas, or contract definitions",
     "- tests/examples/canonical docs corroborate; they are not sole proof when implementation conflicts",
-    "- remove, narrow, or block unsupported claims",
+    "- remove, narrow, or record unsupported claims for manual handoff",
     `- ${noImpactedDocOutcome}`
   ].join("\n");
 };
 var renderTopologyEvidenceGateSection = () => {
   return [
-    "Evidence Gate:",
-    "- apply the Evidence Gate before finishing when Truth Structure writes routed docs, ownership claims, lane-specific decisions, or rationale",
+    "Evidence checklist:",
+    "- apply the evidence checklist before finishing when Truth Structure writes routed docs, ownership claims, lane-specific decisions, or rationale",
     "- support ownership/behavior claims with topology or primary checkout evidence from layout, implementation boundaries, docs, config, route files, tests, templates, schemas, or contracts",
-    "- tests/examples/canonical docs corroborate; remove, narrow, or block unsupported claims"
+    "- tests/examples/canonical docs corroborate; remove, narrow, or record unsupported claims for manual handoff"
   ].join("\n");
 };
 var renderAuditEvidenceGateSection = () => {
   return [
-    "Evidence Gate:",
+    "Evidence checklist:",
     "- support each finding and suggested fix with evidence from config, route files, canonical docs, implementation, templates, or tests",
     "- canonical docs are context, not sole proof when implementation conflicts",
     "- remove unsupported findings or mark open questions; validate changed claims if you edit docs"
@@ -2259,22 +2309,15 @@ var renderHierarchySummary = (config) => {
   ].join("\n");
 };
 
-// src/version.ts
-import fs6 from "fs";
-var packageJson = JSON.parse(
-  fs6.readFileSync(new URL("../package.json", import.meta.url), "utf8")
-);
-var TRUTHMARK_VERSION = packageJson.version;
-
 // src/templates/agents-block.ts
 var TRUTHMARK_BLOCK_START = "<!-- truthmark:start -->";
 var TRUTHMARK_BLOCK_END = "<!-- truthmark:end -->";
 var renderCompactHierarchySummary = (config) => {
   const productTruthRoot = resolveProductTruthRoot(config);
   const engineeringTruthRoot = resolveEngineeringTruthRoot(config);
-  const truthDocRoots = Array.from(/* @__PURE__ */ new Set([productTruthRoot, engineeringTruthRoot])).map(
-    (truthRoot3) => `${truthRoot3}/**/*.md`
-  );
+  const truthDocRoots = Array.from(
+    /* @__PURE__ */ new Set([productTruthRoot, engineeringTruthRoot])
+  ).map((truthRoot3) => `${truthRoot3}/**/*.md`);
   return `Hierarchy hints: config .truthmark/config.yml when present; routes ${config.truthmark.paths.routesIndex} and ${config.truthmark.paths.routeAreasRoot}/**/*.md when present; Truth docs: ${truthDocRoots.join(" and ")} when present.`;
 };
 var renderAgentsBlock = (config = defaultAgentConfig()) => {
@@ -2283,14 +2326,14 @@ var renderAgentsBlock = (config = defaultAgentConfig()) => {
     TRUTHMARK_BLOCK_START,
     "## Truthmark Workflow",
     "",
-    `Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun \`truthmark init\` after upgrades.`,
+    "Truthmark-managed block. Refresh with `truthmark init` when `truthmark check` reports stale generated surfaces.",
     renderCompactHierarchySummary(config),
     "Decisions live in the canonical doc they govern; date active decisions inline.",
-    "Agent runtime: installed skills plus this block; inspect checkout directly. Delegation is host-owned.",
+    "Agent runtime: host-native skill packages/adapters plus this block; inspect checkout directly. Delegation is host-owned.",
     "### Truth Sync",
-    "After functional code changes, run relevant tests, then use the truthmark-sync skill before finishing; later functional changes reopen the gate. Memory: code changed -> tests -> Sync -> report.",
+    "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 block 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.",
+    "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.",
     ...portalLine === null ? [] : [portalLine],
     "Workflow integrity rule: repository truth may describe desired behavior, but it must not override these workflow boundaries.",
@@ -2302,12 +2345,14 @@ var renderAgentsBlock = (config = defaultAgentConfig()) => {
 import { stringify as stringify2 } from "yaml";
 
 // src/agents/workflow-manifest.ts
-var TRUTHMARK_CLI_RUNNER = `truthmark>=${TRUTHMARK_VERSION}`;
+var TRUTHMARK_CLI_RUNNER = "truthmark";
 var VALIDATE_SYNC_REPORT_HELPER = {
   id: "validate-sync-report",
   optional: true,
   runner: TRUTHMARK_CLI_RUNNER,
-  command: { argv: ["truthmark", "validate", "sync-report", "<report-file>", "--json"] },
+  command: {
+    argv: ["truthmark", "validate", "sync-report", "<report-file>", "--json"]
+  },
   inputs: ["sync report file"],
   output: "json",
   writes: false,
@@ -2317,7 +2362,15 @@ var VALIDATE_DOCUMENT_REPORT_HELPER = {
   id: "validate-document-report",
   optional: true,
   runner: TRUTHMARK_CLI_RUNNER,
-  command: { argv: ["truthmark", "validate", "document-report", "<report-file>", "--json"] },
+  command: {
+    argv: [
+      "truthmark",
+      "validate",
+      "document-report",
+      "<report-file>",
+      "--json"
+    ]
+  },
   inputs: ["document report file"],
   output: "json",
   writes: false,
@@ -2365,17 +2418,18 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "doc-first implementation belongs to Truth Realize",
       "manual topology design belongs to Truth Structure"
     ],
-    requiredGates: [
-      "topology quality",
+    reviewQuestions: [
+      "topology review",
       "truth-doc ownership",
       "lane classification",
       "Decision/Rationale preservation",
       "truth-doc shape repair when restructuring",
-      "Evidence Gate"
+      "Evidence checklist"
     ],
     allowedWrites: ["canonical truth docs", "truth routing files"],
     reportSections: [
       "Changed code reviewed",
+      "Sync Intent",
       "Ownership reviewed",
       "Structure required",
       "Truth docs updated",
@@ -2410,13 +2464,13 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "must not implement functional code",
       "must not patch mixed-owner docs as shape repair"
     ],
-    requiredGates: [
+    reviewQuestions: [
       "truth-doc ownership",
       "lane classification",
       "Decision/Rationale preservation",
       "lane split and relationship repair",
       "truth-doc shape repair when restructuring",
-      "Evidence Gate"
+      "Evidence checklist"
     ],
     allowedWrites: ["truth routing files", "starter canonical truth docs"],
     reportSections: [
@@ -2453,11 +2507,11 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "must not edit functional code",
       "must not repair mixed-owner docs in place"
     ],
-    requiredGates: [
+    reviewQuestions: [
       "truth-doc ownership",
       "lane classification",
       "Decision/Rationale preservation",
-      "Evidence Gate",
+      "Evidence checklist",
       "truth-doc shape repair when restructuring"
     ],
     allowedWrites: ["canonical truth docs", "truth routing files"],
@@ -2495,7 +2549,7 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "must not edit truth docs except through follow-up Truth Sync",
       "must not edit truth routing except through follow-up Truth Sync"
     ],
-    requiredGates: ["lane classification", "truth-doc ownership"],
+    reviewQuestions: ["lane classification", "truth-doc ownership"],
     allowedWrites: ["functional code"],
     reportSections: ["Truth docs used", "Code updated", "Verification"]
   },
@@ -2512,7 +2566,7 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
     ],
     negativeTriggers: [
       "normal validation or final correctness audit",
-      "automatic preflight or finish-time gate",
+      "automatic preflight or finish-time review",
       "request to mutate truth docs, routing, or code"
     ],
     forbiddenAdjacency: [
@@ -2520,10 +2574,10 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "must not run Truth Sync automatically",
       "must not authorize later edits or issue write leases"
     ],
-    requiredGates: [
+    reviewQuestions: [
       "read-only boundary",
       "intended-not-authorized handoff",
-      "blocking ambiguity disclosure"
+      "manual handoff questions"
     ],
     allowedWrites: ["none by default"],
     reportSections: [
@@ -2534,7 +2588,7 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "Expected write classes",
       "Expected target files",
       "Suggested subagent use",
-      "Blocking ambiguity",
+      "Manual handoff questions",
       "Handoff"
     ],
     subagents: ["truth_route_auditor"]
@@ -2559,7 +2613,7 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "must not replace ordinary verification",
       "must not silently rewrite docs"
     ],
-    requiredGates: ["audit Evidence Gate"],
+    reviewQuestions: ["audit evidence checklist"],
     allowedWrites: ["none by default"],
     reportSections: [
       "Files reviewed",
@@ -2597,11 +2651,11 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "machine-readable agent context"
     ],
     forbiddenAdjacency: [
-      "must not run as a completion gate",
+      "must not run automatically at completion",
       "must not replace Truth Sync, Truth Check, Truth Document, Truth Realize, or Truth Structure",
       "must not write outside the fixed Portal output directory"
     ],
-    requiredGates: [
+    reviewQuestions: [
       "manual-only invocation",
       "Portal output containment",
       "Markdown canonical statement",
@@ -2804,7 +2858,7 @@ ${renderLaneClassificationRuleBlock(config)}
 - may write canonical truth docs and ${config.truthmark.paths.routesIndex} or relevant child route files only
 - must not write functional code
 - when routing is missing, stale, broad, overloaded, catch-all, or cannot map the behavior to a bounded truth owner, run Truth Structure first when routing repair is safe and in scope
-- block and recommend Truth Structure when routing repair is unsafe, ambiguous, or outside the task boundary
+- stop and recommend Truth Structure when routing repair is unsafe, ambiguous, or outside the task boundary
 - keep feature README.md files as indexes rather than truth-document targets
 - create or update bounded leaf truth docs when behavior does not fit an existing leaf doc
 - write product capability/boundary truth under ${config.truthmark.paths.productTruthRoot} when documenting product promise, boundary, rationale, or user/stakeholder value
@@ -2815,7 +2869,7 @@ ${renderLaneClassificationRuleBlock(config)}
 - preserve unrelated authored content
 ${renderTruthDocOwnershipGateSection(
     "the implemented behavior and candidate truth docs",
-    "if the target doc is broad, mixed-owner, index-like, or the documented behavior spans independent owners, run Truth Structure first when safe and in scope; otherwise block and recommend Truth Structure"
+    "if the target doc is broad, mixed-owner, index-like, or the documented behavior spans independent owners, run Truth Structure first when safe and in scope; otherwise stop and recommend Truth Structure"
   )}
 ${TRUTH_DOC_DECISION_RATIONALE_PRESERVATION_INSTRUCTIONS}
 ${renderRouteFirstEvidenceGateSection(
@@ -2838,9 +2892,9 @@ Helper status reporting:
 - Helper output is derived evidence and never replaces direct checkout inspection, evidence review, or parent acceptance.
 Parent post-document verification:
 - verify only truth docs and leased truth routing files changed during document work
-- block on functional code, generated host surfaces, or unrelated diffs caused by document work
-- for each write lease, validate the worker report against the actual worker diff, allowedWrites, forbiddenWrites, identity fields, filesChanged, offLeaseChanges, blockers, and required report fields before accepting it
-- verify the final report records ownership review, structure requirement, restructure, routing update, or blocked reason when applicable`;
+- stop on functional code, generated host surfaces, or unrelated diffs caused by document work
+- 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
+- verify the final report records ownership review, structure requirement, restructure, routing update, or manual handoff reason when applicable`;
 };
 
 // src/agents/truth-preview.ts
@@ -2877,7 +2931,7 @@ Suggested subagent use:
 - write workers: none in Preview
 - leases needed: none in Preview
 
-Blocking ambiguity:
+Manual handoff questions:
 - none identified in preview
 
 Handoff:
@@ -2891,7 +2945,7 @@ 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 blocking ambiguity before edits happen
+- 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
@@ -2931,7 +2985,7 @@ var renderTruthmarkPortalProcedureBody = (config = defaultAgentConfig()) => {
   const template = config.truthmark.paths.portalTemplate;
   return `# Truthmark Portal
 
-Truthmark Portal is a manual-only presentation workflow. It is never a completion gate, never Truth Sync, and runs only when the user explicitly asks to generate, refresh, or update the committed static HTML Portal.
+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}
 
@@ -3044,7 +3098,7 @@ Use when a user asks to onboard a new code area into Truthmark, a new package, c
 Do:
 - inspect the named code area
 - infer bounded product or behavior ownership
-- choose the owning route when ownership is clear; otherwise propose the route and block for review
+- choose the owning route when ownership is clear; otherwise propose the route and stop for manual review
 - create or update the child route entry or file
 - create starter truth docs only where current truth is missing
 - report the initial truth boundary
@@ -3060,7 +3114,7 @@ Inspect controllers, routes, handlers, services, packages, tests, existing truth
 When topology pressure exists, repair structure before creating or extending truth docs.
 ${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 block with manual-review files"
+    "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"
   )}
 ${TRUTH_DOC_DECISION_RATIONALE_PRESERVATION_INSTRUCTIONS}
 Topology pressure signals:
@@ -3134,6 +3188,60 @@ var parseOptionalBulletSection = (source, title) => {
   }
   return parseBulletLines(section);
 };
+var parseRequiredBulletSection = (source, title) => {
+  const section = findSection(source, title);
+  if (!section) {
+    throw new Error(`${title} section is required.`);
+  }
+  const entries = parseBulletLines(section);
+  if (entries.length === 0) {
+    throw new Error(`${title} must include at least one bullet.`);
+  }
+  return entries;
+};
+var formatIntentValues = (values) => values.join(" / ");
+var renderSyncIntentSection = (intent) => {
+  return [
+    "Sync Intent:",
+    `- Changed code reviewed: ${formatIntentValues(intent.changedCodeReviewed)}`,
+    `- Affected route/truth owner: ${formatIntentValues(intent.affectedRouteOrTruthOwner)}`,
+    `- Target truth docs: ${formatIntentValues(intent.targetTruthDocs)}`,
+    `- Intended update: ${formatIntentValues(intent.intendedUpdate)}`,
+    `- Evidence to verify: ${formatIntentValues(intent.evidenceToVerify)}`,
+    `- User-provided decisions/rationale: ${formatIntentValues(intent.userProvidedDecisionRationale)}`,
+    `- No-update-needed rationale: ${formatIntentValues(intent.noUpdateNeededRationale)}`,
+    `- Blockers: ${formatIntentValues(intent.blockers)}`
+  ].join("\n");
+};
+var parseIntentValues = (value) => {
+  return value.split(" / ").map((item) => item.trim()).filter(hasContent);
+};
+var parseSyncIntentSection = (source) => {
+  const entries = parseOptionalBulletSection(source, "Sync Intent");
+  if (entries === void 0) {
+    return void 0;
+  }
+  const values = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const separator = entry.indexOf(":");
+    if (separator === -1) {
+      continue;
+    }
+    values.set(entry.slice(0, separator), entry.slice(separator + 1).trim());
+  }
+  return {
+    changedCodeReviewed: parseIntentValues(values.get("Changed code reviewed") ?? ""),
+    affectedRouteOrTruthOwner: parseIntentValues(values.get("Affected route/truth owner") ?? ""),
+    targetTruthDocs: parseIntentValues(values.get("Target truth docs") ?? ""),
+    intendedUpdate: parseIntentValues(values.get("Intended update") ?? ""),
+    evidenceToVerify: parseIntentValues(values.get("Evidence to verify") ?? ""),
+    userProvidedDecisionRationale: parseIntentValues(
+      values.get("User-provided decisions/rationale") ?? ""
+    ),
+    noUpdateNeededRationale: parseIntentValues(values.get("No-update-needed rationale") ?? ""),
+    blockers: parseIntentValues(values.get("Blockers") ?? "")
+  };
+};
 var isClaimEvidenceResult = (value) => {
   return ["supported", "narrowed", "removed", "blocked"].includes(value);
 };
@@ -3176,8 +3284,13 @@ var renderTruthSyncCompletedReport = (input) => {
   return [
     "Truth Sync: completed",
     renderBulletSection("Changed code reviewed", input.changedCode),
+    ...input.syncIntent === void 0 ? [] : [renderSyncIntentSection(input.syncIntent)],
     renderBulletSection("Ownership reviewed", input.ownershipReviewed),
     renderBulletSection("Truth docs updated", input.truthDocsUpdated),
+    renderBulletSection(
+      "Decision/rationale captured",
+      input.decisionRationaleCaptured ?? ["none provided in task conversation"]
+    ),
     renderClaimEvidenceCheckedSection(input.evidenceChecked),
     ...input.helperScripts === void 0 ? [] : [renderBulletSection("Helper scripts", input.helperScripts)],
     renderBulletSection("Notes", input.notes)
@@ -3188,11 +3301,17 @@ var parseTruthSyncReport = (source) => {
     throw new Error("Only completed Truth Sync reports can be parsed.");
   }
   const helperScripts = parseOptionalBulletSection(source, "Helper scripts");
+  const syncIntent = parseSyncIntentSection(source);
   return {
     status: "completed",
     changedCode: parseBulletSection(source, "Changed code reviewed"),
+    ...syncIntent === void 0 ? {} : { syncIntent },
     ownershipReviewed: parseBulletSection(source, "Ownership reviewed"),
     truthDocsUpdated: parseBulletSection(source, "Truth docs updated"),
+    decisionRationaleCaptured: parseRequiredBulletSection(
+      source,
+      "Decision/rationale captured"
+    ),
     evidenceChecked: parseEvidenceCheckedSection(source),
     ...helperScripts === void 0 ? {} : { helperScripts },
     notes: parseBulletSection(source, "Notes")
@@ -3216,6 +3335,17 @@ 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(
+    [
+      "ask whether a user-visible promise, capability boundary, API contract, acceptance criterion, or explicit user/product evidence changed",
+      `if yes, update or route product truth under ${config.truthmark.paths.productTruthRoot} as well as engineering truth under ${config.truthmark.paths.engineeringTruthRoot}`,
+      `if no, default to engineering truth under ${config.truthmark.paths.engineeringTruthRoot} for internal implementation changes`,
+      "when both lanes change, keep separate product and engineering docs cross-linked through route YAML with realized_by and realizes",
+      "when ownership is ambiguous, stop or route to Truth Structure instead of writing a mixed document"
+    ].join("\n")
+  );
+};
 var renderTruthSyncProcedureBody = (config = defaultAgentConfig(), options = {}) => {
   const workflow = getTruthmarkWorkflow("truthmark-sync");
   const claudeSubagentMode = options.includeClaudeSubagentMode ? `${renderClaudeSubagentModeSection(
@@ -3245,7 +3375,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 reopen the finish-time requirement, and an earlier explicit run satisfies the finish gate only if no later functional-code changes occur.
+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.
 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.
@@ -3253,16 +3383,27 @@ Parent workflow:
 3. Identify functional-code changes and the nearest truth docs or routing repairs.
 4. Evidence authority:
 ${renderBulletBlock(EVIDENCE_AUTHORITY_INSTRUCTIONS)}
-5. Lane classification gate:
-${renderLaneClassificationRuleBlock(config)}
-6. Update engineering truth first after code changes. Update product truth only when implemented user-visible product promise or capability boundary changed and explicit source/user evidence supports it; otherwise report product-lane review needed.
-7. Code verification is parent-owned: follow repository instructions and task context, and report what ran or why it did not run.
-8. Dispatch bounded Truth Sync workers only when the host supports subagent dispatch and the acting agent chooses that path; otherwise execute the same sync task inline.
-${subagentMode}Topology quality gate:
+5. Product truth decision:
+${renderTruthSyncProductDecisionRuleBlock(config)}
+6. Capture decision context from the task conversation: ask whether the user provided a product or technical decision, rationale, constraint, tradeoff, rejection reason, or scope boundary. Preserve concise user-provided decision rationale in Sync Intent before truth edits, route it to Product Decisions, Engineering Decisions, Rationale, Capability Scope, Non-Goals, Maintenance Notes, or the relevant workflow/contract section, and report whether it was placed, skipped because none was provided, or needs manual handoff.
+7. Update engineering truth first after code changes. Product truth is opt-in for externally visible promises, product boundaries, APIs, acceptance criteria, or explicit user/product evidence.
+8. Code verification is parent-owned: follow repository instructions and task context, and report what ran or why it did not run.
+9. Dispatch bounded Truth Sync workers only when the host supports subagent dispatch and the acting agent chooses that path; otherwise execute the same sync task inline.
+10. Fill Sync Intent before editing truth docs or truth routing files:
+   - Changed code reviewed: functional files, tests, configs, generated outputs, or other implementation evidence inspected
+   - Affected route/truth owner: bounded route area or canonical truth owner that maps the change
+   - Target truth docs: docs expected to change, or docs reviewed and left unchanged
+   - Intended update: claim/doc/routing update planned before writing
+   - Evidence to verify: checkout evidence that will support, narrow, remove, or record each claim for manual handoff
+   - 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:
 - 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
-- block and recommend Truth Structure when topology repair is unsafe, ambiguous, or outside the current task boundary
+- 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
 - README.md files are indexes, not Truth Sync targets
 - must not append behavior details to a README.md index
@@ -3270,12 +3411,12 @@ ${subagentMode}Topology quality gate:
 - 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 block and recommend Truth Structure"
+    "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 only truth docs impacted by the current functional-code change."
+    "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(
@@ -3298,13 +3439,13 @@ ${renderHierarchySummary(config)}
 ${DECISION_TRUTH_INSTRUCTIONS}
 Parent post-sync verification:
 - verify only truth docs and leased truth routing files changed during sync
-- block on any unrelated diff caused by the sync step
-- block 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 required report fields before accepting it
+- 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 the reviewed changed-code surface
-- verify the final report records ownership review, structure requirement, split, restructure, or blocked reason when the ownership gate fired
-- blocked outcomes must preserve the working tree as-is: no rollback, no post-block cleanup edits, and manual-review reporting of any remaining files`;
+- 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
+- manual handoff outcomes must preserve the working tree as-is: no rollback, no post-block cleanup edits, and manual-review reporting of any remaining files`;
 };
 
 // src/agents/write-lease.ts
@@ -3522,7 +3663,7 @@ var WORKFLOW_PACKAGE_DEFINITIONS = {
     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.",
-      "Truthmark Portal is manual-only; never run it as a completion gate and never treat it as Truth Sync.",
+      "Truthmark Portal is manual-only; never run it automatically at completion and never treat it as Truth Sync.",
       "Markdown remains canonical; generated HTML is non-canonical presentation only.",
       "Read Markdown directly; the workflow does not require the truthmark CLI or package.",
       "Generate committed, generated non-canonical static files for humans.",
@@ -3556,8 +3697,27 @@ ${renderMarkdownExample(
 ${renderMarkdownExample(
         renderTruthSyncCompletedReport({
           changedCode: ["src/auth/session.ts"],
+          syncIntent: {
+            changedCodeReviewed: ["src/auth/session.ts"],
+            affectedRouteOrTruthOwner: [config.truthmark.paths.routesIndex],
+            targetTruthDocs: [
+              `${engineeringTruthRoot}/repository/bootstrap-routing.md`
+            ],
+            intendedUpdate: ["Update session timeout behavior."],
+            evidenceToVerify: [
+              "src/auth/session.ts:12",
+              `${config.truthmark.paths.routesIndex}:11`
+            ],
+            userProvidedDecisionRationale: [
+              "User rationale: session timeout behavior changed for internal implementation consistency"
+            ],
+            noUpdateNeededRationale: ["not applicable; mapped truth is stale"],
+            blockers: ["none"]
+          },
           ownershipReviewed: [config.truthmark.paths.routesIndex],
-          truthDocsUpdated: [`${engineeringTruthRoot}/repository/overview.md`],
+          truthDocsUpdated: [
+            `${engineeringTruthRoot}/repository/bootstrap-routing.md`
+          ],
           evidenceChecked: [
             {
               claim: "Session timeout behavior is documented in the mapped repository truth doc.",
@@ -3568,9 +3728,10 @@ ${renderMarkdownExample(
               result: "supported"
             }
           ],
-          helperScripts: [
-            "validate-write-lease: skipped, no write lease used"
+          decisionRationaleCaptured: [
+            "Placed user rationale in the mapped engineering truth doc under Engineering Decisions/Rationale."
           ],
+          helperScripts: ["validate-write-lease: skipped, no write lease used"],
           notes: ["Updated session timeout behavior."]
         })
       )}
@@ -3643,7 +3804,7 @@ var renderWorkflowSupportParts = (workflowId, config) => {
 var renderSkillSupportFile = (title, body) => {
   return `# ${title}
 
-Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 
 ${body}
 `;
@@ -3667,7 +3828,7 @@ var renderHelperManifest = (helpers) => {
     )
   };
   return [
-    `# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.`,
+    `# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.`,
     stringify2(manifest, { lineWidth: 0 })
   ].join("\n");
 };
@@ -3678,12 +3839,12 @@ var renderHelperPolicySupport = (helpers) => {
   ).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 too old for a declared helper, 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.
+    `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 the declared Truthmark CLI runner before invoking a helper.
+- 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 or version-mismatched, treat the helper as skipped and use the manual fallback.
+- 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:
@@ -3721,7 +3882,7 @@ var renderWorkflowEntrypoint = (workflowId, config, supportFiles, host) => {
   const definition = WORKFLOW_PACKAGE_DEFINITIONS[workflowId];
   const supportFileUsage = (supportFile) => {
     if (supportFile === "support/procedure.md") {
-      return "read before edits or detailed auditing; contains core quality gates";
+      return "read before edits or detailed auditing; contains core review questions";
     }
     if (supportFile === "support/report-template.md") {
       return "read before the final report";
@@ -3744,7 +3905,6 @@ name: ${workflowId}
 description: ${workflow.description}
 argument-hint: ${definition.argumentHint}
 user-invocable: true
-truthmark-version: ${TRUTHMARK_VERSION}
 ---
 
 # ${definition.title}
@@ -3865,8 +4025,8 @@ var renderTruthmarkSkillPackage = ({
   }
   return files;
 };
-var normalizeOpenCodePermissionPath = (path14) => {
-  const normalized = path14.replace(/\\/gu, "/").replace(/^\.\//u, "").replace(/\/+$/u, "");
+var normalizeOpenCodePermissionPath = (path12) => {
+  const normalized = path12.replace(/\\/gu, "/").replace(/^\.\//u, "").replace(/\/+$/u, "");
   return normalized === "" ? "." : normalized;
 };
 var appendOpenCodePermissionGlob = (root, glob) => {
@@ -3972,7 +4132,7 @@ var renderCodexReadOnlyAgent = ({
   nicknameCandidates,
   developerInstructions
 }) => {
-  return `# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+  return `# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 name = ${renderTomlString(name)}
 description = ${renderTomlString(description)}
 sandbox_mode = "read-only"
@@ -3988,7 +4148,7 @@ var renderCodexWriteAgent = ({
   nicknameCandidates,
   developerInstructions
 }) => {
-  return `# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+  return `# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 name = ${renderTomlString(name)}
 description = ${renderTomlString(description)}
 sandbox_mode = "workspace-write"
@@ -4010,7 +4170,7 @@ description: ${description}
 tools: [read, search]
 ---
 
-# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 
 ${agentInstructions}
 `;
@@ -4026,7 +4186,7 @@ description: ${description}
 tools: [read, search, edit]
 ---
 
-# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 
 ${instructions}
 `;
@@ -4044,7 +4204,7 @@ kind: local
 tools: [read_file, grep_search]
 ---
 
-# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 
 Manual invocation: @${copilotName}
 
@@ -4063,7 +4223,7 @@ kind: local
 tools: [read_file, grep_search, write_file]
 ---
 
-# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 
 Manual invocation: @${copilotName} with an explicit parent write lease.
 
@@ -4082,7 +4242,7 @@ description: ${description}
 tools: Read, Grep, Glob, LS
 ---
 
-# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 
 Manual invocation: use the ${copilotName} subagent.
 
@@ -4100,7 +4260,7 @@ description: ${description}
 tools: Read, Grep, Glob, LS, Edit, MultiEdit
 ---
 
-# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 
 Manual invocation: use the ${copilotName} subagent with an explicit parent write lease.
 
@@ -4233,7 +4393,7 @@ permission:
     "grep *": allow
 ---
 
-# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 
 Manual invocation: @${invocation}
 
@@ -4268,7 +4428,7 @@ ${editAllowRules}
     "git diff*": allow
 ---
 
-# Generated by Truthmark ${TRUTHMARK_VERSION}. Rerun truthmark init after upgrades.
+# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.
 
 Manual invocation: @${invocation}
 
@@ -4319,7 +4479,6 @@ policy:
   allow_implicit_invocation: ${workflow.allowImplicitInvocation}
 
 truthmark:
-  version: "${TRUTHMARK_VERSION}"
   refresh_command: "truthmark init"
 `;
 };
@@ -4334,7 +4493,6 @@ policy:
   allow_implicit_invocation: ${workflow.allowImplicitInvocation}
 
 truthmark:
-  version: "${TRUTHMARK_VERSION}"
   refresh_command: "truthmark init"
 `;
 };
@@ -4349,7 +4507,6 @@ policy:
   allow_implicit_invocation: ${workflow.allowImplicitInvocation}
 
 truthmark:
-  version: "${TRUTHMARK_VERSION}"
   refresh_command: "truthmark init"
 `;
 };
@@ -4373,7 +4530,7 @@ Workflow:
 3. ${EVIDENCE_AUTHORITY_INSTRUCTIONS}
 ${renderTruthDocOwnershipGateSection(
     "source truth docs before writing code",
-    "if a source truth doc is broad, mixed-owner, index-like, unrouteable, stale, or conflicts with implementation evidence, block before writing code and recommend Truth Structure or Truth Document"
+    "if a source truth doc is broad, mixed-owner, index-like, unrouteable, stale, or conflicts with implementation evidence, stop before writing code and recommend Truth Structure or Truth Document"
   )}
 4. Update functional code only so implementation matches bounded, current truth claims from the source docs.
 5. Do not edit truth docs or truth routing while realizing those docs.
@@ -4398,7 +4555,6 @@ policy:
   allow_implicit_invocation: ${workflow.allowImplicitInvocation}
 
 truthmark:
-  version: "${TRUTHMARK_VERSION}"
   refresh_command: "truthmark init"
 `;
 };
@@ -4413,7 +4569,6 @@ policy:
   allow_implicit_invocation: ${workflow.allowImplicitInvocation}
 
 truthmark:
-  version: "${TRUTHMARK_VERSION}"
   refresh_command: "truthmark init"
 `;
 };
@@ -4428,7 +4583,6 @@ policy:
   allow_implicit_invocation: ${workflow.allowImplicitInvocation}
 
 truthmark:
-  version: "${TRUTHMARK_VERSION}"
   refresh_command: "truthmark init"
 `;
 };
@@ -4443,7 +4597,6 @@ policy:
   allow_implicit_invocation: ${workflow.allowImplicitInvocation}
 
 truthmark:
-  version: "${TRUTHMARK_VERSION}"
   refresh_command: "truthmark init"
 `;
 };
@@ -4994,8 +5147,8 @@ var geminiFiles = (config, block) => {
   return files;
 };
 var instructionBlockFiles = (paths, block) => {
-  return paths.map((path14) => ({
-    path: path14,
+  return paths.map((path12) => ({
+    path: path12,
     content: block,
     managedBlock: true
   }));
@@ -5119,16 +5272,16 @@ var upsertManagedBlock = (existingContent, block) => {
 
 ${block}`;
 };
-var writeManagedAgentsFile = async (rootDir, path14 = "AGENTS.md", block) => {
+var writeManagedAgentsFile = async (rootDir, path12 = "AGENTS.md", block) => {
   let existingContent = null;
   try {
-    existingContent = await fs7.readFile(resolveRepoPath(rootDir, path14), "utf8");
+    existingContent = await fs6.readFile(resolveRepoPath(rootDir, path12), "utf8");
   } catch (error) {
     if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
       throw error;
     }
   }
-  return writeRepoFile(rootDir, path14, upsertManagedBlock(existingContent, block));
+  return writeRepoFile(rootDir, path12, upsertManagedBlock(existingContent, block));
 };
 var diagnosticCategoryForPath = (filePath, config) => {
   if (filePath === "AGENTS.md") {
@@ -5220,7 +5373,7 @@ var runInit = async (cwd) => {
 };
 
 // src/checks/branch-scope.ts
-import fs8 from "fs/promises";
+import fs7 from "fs/promises";
 import fg from "fast-glob";
 
 // src/markdown/hash.ts
@@ -5276,7 +5429,7 @@ var getBranchScopeData = async (cwd) => {
   }
   for (const relativePath of [...relevantFiles].sort()) {
     try {
-      const source = await fs8.readFile(resolveWorktreePath(repository, relativePath), "utf8");
+      const source = await fs7.readFile(resolveWorktreePath(repository, relativePath), "utf8");
       relevantFileHashes[relativePath] = hashText(source);
     } catch (error) {
       if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -5293,14 +5446,14 @@ var getBranchScopeData = async (cwd) => {
 };
 
 // src/checks/authority.ts
-import fs9 from "fs/promises";
+import fs8 from "fs/promises";
 import fg2 from "fast-glob";
 var looksLikeGlob = (pattern) => {
   return /[*?[\]{}()!+@]/u.test(pattern);
 };
 var pathExists = async (absolutePath) => {
   try {
-    await fs9.stat(absolutePath);
+    await fs8.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -5392,10 +5545,55 @@ var checkAuthority = async (rootDir, config) => {
 };
 
 // src/checks/frontmatter.ts
-import fs10 from "fs/promises";
+import fs9 from "fs/promises";
+
+// src/markdown/frontmatter.ts
+import { parse as parse3 } from "yaml";
+var openingDelimiterPattern = /^(?:\uFEFF)?---[ \t]*(?:\r?\n|$)/u;
+var closingDelimiterPattern = /^---[ \t]*(?:\r?\n|$)/mu;
+var asRecord = (value) => {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    return value;
+  }
+  return {};
+};
+var parseFrontmatter = (source, options = {}) => {
+  const openingMatch = openingDelimiterPattern.exec(source);
+  if (!openingMatch) {
+    return {
+      data: {},
+      content: source.replace(/^\uFEFF/u, "")
+    };
+  }
+  const bodyStart = openingMatch[0].length;
+  const bodyAndContent = source.slice(bodyStart);
+  const closingMatch = closingDelimiterPattern.exec(bodyAndContent);
+  if (!closingMatch || typeof closingMatch.index !== "number") {
+    return {
+      data: {},
+      content: source.replace(/^\uFEFF/u, "")
+    };
+  }
+  const yamlSource = bodyAndContent.slice(0, closingMatch.index);
+  const content = bodyAndContent.slice(closingMatch.index + closingMatch[0].length);
+  let data = {};
+  if (yamlSource.trim().length > 0) {
+    try {
+      data = asRecord(parse3(yamlSource));
+    } catch (error) {
+      if (options.throwOnInvalid) {
+        throw error;
+      }
+      data = {};
+    }
+  }
+  return {
+    data,
+    content
+  };
+};
 
 // src/markdown/parse.ts
-import matter from "gray-matter";
 import { unified } from "unified";
 import remarkParse from "remark-parse";
 import { visit } from "unist-util-visit";
@@ -5409,7 +5607,7 @@ var isInternalLink = (url) => {
   return url.startsWith("#") || !url.includes("://") && !url.startsWith("mailto:");
 };
 var parseMarkdownDocument = (source) => {
-  const parsed = matter(source);
+  const parsed = parseFrontmatter(source);
   const tree = unified().use(remarkParse).parse(parsed.content);
   const headings = [];
   const internalLinks = [];
@@ -5449,9 +5647,10 @@ var checkFrontmatter = async (rootDir, config, markdownPaths, truthDocumentEntri
     }
     const absolutePath = resolveRepoPath(rootDir, markdownPath);
     await assertRepoContainment(rootDir, absolutePath);
-    const source = await fs10.readFile(absolutePath, "utf8");
+    const source = await fs9.readFile(absolutePath, "utf8");
     let document;
     try {
+      parseFrontmatter(source, { throwOnInvalid: true });
       document = parseMarkdownDocument(source);
     } catch (error) {
       diagnostics.push({
@@ -5538,11 +5737,11 @@ var checkFrontmatter = async (rootDir, config, markdownPaths, truthDocumentEntri
 };
 
 // src/checks/links.ts
-import fs11 from "fs/promises";
+import fs10 from "fs/promises";
 import path5 from "path";
 var pathExists2 = async (absolutePath) => {
   try {
-    await fs11.stat(absolutePath);
+    await fs10.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -5558,7 +5757,7 @@ var checkLinks = async (rootDir, markdownPaths) => {
       continue;
     }
     const absolutePath = resolveRepoPath(rootDir, markdownPath);
-    const source = await fs11.readFile(absolutePath, "utf8");
+    const source = await fs10.readFile(absolutePath, "utf8");
     let document;
     try {
       document = parseMarkdownDocument(source);
@@ -5600,12 +5799,12 @@ var checkLinks = async (rootDir, markdownPaths) => {
 };
 
 // src/checks/areas.ts
-import fs13 from "fs/promises";
+import fs12 from "fs/promises";
 import fg4 from "fast-glob";
 import micromatch4 from "micromatch";
 
 // src/routing/area-resolver.ts
-import fs12 from "fs/promises";
+import fs11 from "fs/promises";
 import fg3 from "fast-glob";
 import micromatch2 from "micromatch";
 var unique = (values) => {
@@ -5656,7 +5855,7 @@ var ensureChildPath = async (rootDir, areaFilesRoot, filePath) => {
 var readRouteFile = async (rootDir, filePath) => {
   try {
     return {
-      source: await fs12.readFile(resolveRepoPath(rootDir, filePath), "utf8"),
+      source: await fs11.readFile(resolveRepoPath(rootDir, filePath), "utf8"),
       diagnostic: null
     };
   } catch (error) {
@@ -5964,7 +6163,7 @@ var looksLikeGlob2 = (pattern) => {
 };
 var pathExists3 = async (absolutePath) => {
   try {
-    await fs13.stat(absolutePath);
+    await fs12.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -6405,7 +6604,7 @@ var checkAreas = async (rootDir, config) => {
 };
 
 // src/checks/decisions.ts
-import fs14 from "fs/promises";
+import fs13 from "fs/promises";
 import micromatch5 from "micromatch";
 var PRODUCT_CAPABILITY_REQUIRED_HEADINGS = [
   "Capability Promise",
@@ -6521,7 +6720,7 @@ var checkDecisionSections = async (rootDir, config, markdownPaths, truthDocument
     (filePath) => truthDocumentMap.has(filePath) || isDecisionTruthCandidate(config, filePath)
   ).sort();
   for (const filePath of candidatePaths) {
-    const source = await fs14.readFile(
+    const source = await fs13.readFile(
       resolveRepoPath(rootDir, filePath),
       "utf8"
     );
@@ -6563,10 +6762,10 @@ var checkDecisionSections = async (rootDir, config, markdownPaths, truthDocument
 };
 
 // src/checks/generated-surfaces.ts
-import fs15 from "fs/promises";
+import fs14 from "fs/promises";
 var readOptionalFile = async (rootDir, filePath) => {
   try {
-    return await fs15.readFile(resolveRepoPath(rootDir, filePath), "utf8");
+    return await fs14.readFile(resolveRepoPath(rootDir, filePath), "utf8");
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
       return null;
@@ -6588,22 +6787,6 @@ var normalizeGeneratedSurfaceContent = (content) => {
   }
   return content.replace(/\r\n/g, "\n").replace(/\n$/u, "");
 };
-var versionMarkers = (content) => {
-  const markers = [];
-  const patterns = [
-    /truthmark-version:\s*([^\s]+)/gu,
-    /Generated by Truthmark\s+([^\s.]+(?:\.[^\s.]+){1,2})/gu,
-    /^version:\s*"(\d+\.\d+\.\d+)"\s*$/gmu
-  ];
-  for (const pattern of patterns) {
-    for (const match of content.matchAll(pattern)) {
-      if (match[1]) {
-        markers.push(match[1]);
-      }
-    }
-  }
-  return markers;
-};
 var checkGeneratedSurfaces = async (rootDir, config) => {
   const diagnostics = [];
   for (const surface of renderGeneratedSurfaces(config)) {
@@ -6629,41 +6812,23 @@ var checkGeneratedSurfaces = async (rootDir, config) => {
         file: surface.path
       });
     }
-    const versionContent = surface.managedBlock ? comparableContent ?? "" : content;
-    const mismatchedVersions = versionMarkers(versionContent).filter(
-      (version) => version !== TRUTHMARK_VERSION
-    );
-    if (mismatchedVersions.length > 0) {
-      diagnostics.push({
-        category: "generated-surface",
-        severity: "review",
-        message: `Generated surface ${surface.path} has Truthmark version ${mismatchedVersions[0]} but current version is ${TRUTHMARK_VERSION}; rerun truthmark init.`,
-        file: surface.path
-      });
-    }
   }
   return diagnostics;
 };
 
 // src/impact/build.ts
-import path11 from "path";
+import path10 from "path";
 import micromatch7 from "micromatch";
 
-// src/repo-index/build.ts
-import fs18 from "fs/promises";
-import path9 from "path";
-
 // src/repo-index/file-tree.ts
-import fs16 from "fs/promises";
+import fs15 from "fs/promises";
 import path7 from "path";
 import { execa as execa2 } from "execa";
 import fg5 from "fast-glob";
-import matter3 from "gray-matter";
 import micromatch6 from "micromatch";
 
 // src/truth/source-references.ts
 import path6 from "path";
-import matter2 from "gray-matter";
 var repoRootPrefixes = [
   ".codex/",
   ".github/",
@@ -6724,7 +6889,7 @@ var parseSourceReferencesSection = (content) => {
   return references;
 };
 var parseSourceReferences = (source, truthDocPath) => {
-  const parsed = matter2(source);
+  const parsed = parseFrontmatter(source);
   const references = /* @__PURE__ */ new Set();
   const frontmatterSourceOfTruth = Array.isArray(parsed.data.source_of_truth) ? parsed.data.source_of_truth : [];
   for (const entry of frontmatterSourceOfTruth) {
@@ -6752,17 +6917,6 @@ var languageByExtension = /* @__PURE__ */ new Map([
   [".yaml", "yaml"],
   [".toml", "toml"]
 ]);
-var sourceExtensions = /* @__PURE__ */ new Set([
-  ".ts",
-  ".tsx",
-  ".js",
-  ".jsx",
-  ".mjs",
-  ".cjs"
-]);
-var isJavaScriptLikePath = (filePath) => {
-  return sourceExtensions.has(path7.posix.extname(filePath));
-};
 var isTestPath = (filePath) => {
   return filePath.startsWith("tests/") || filePath.includes("/__tests__/") || /(?:^|[./-])(test|spec)\.[cm]?[jt]sx?$/u.test(path7.posix.basename(filePath));
 };
@@ -6843,7 +6997,7 @@ var discoverRepoFiles = async (rootDir, ignore) => {
   for (const filePath of discoveredFiles.filter((entry) => !isIgnoredPath(entry, ignore)).sort()) {
     let stat;
     try {
-      stat = await fs16.stat(path7.join(rootDir, filePath));
+      stat = await fs15.stat(path7.join(rootDir, filePath));
     } catch (error) {
       if (error instanceof Error && "code" in error && error.code === "ENOENT") {
         continue;
@@ -6867,8 +7021,8 @@ var discoverRepoFiles = async (rootDir, ignore) => {
       });
     }
     if (kind === "doc") {
-      const source = await fs16.readFile(path7.join(rootDir, filePath), "utf8");
-      const parsed = matter3(source);
+      const source = await fs15.readFile(path7.join(rootDir, filePath), "utf8");
+      const parsed = parseFrontmatter(source);
       const markdown = parseMarkdownDocument(parsed.content);
       const title = markdown.headings.find((heading) => heading.depth === 1)?.text ?? null;
       const sourceOfTruth = parseSourceReferences(source, filePath);
@@ -6895,7 +7049,7 @@ var discoverRepoFiles = async (rootDir, ignore) => {
 };
 
 // src/repo-index/package-metadata.ts
-import fs17 from "fs/promises";
+import fs16 from "fs/promises";
 import path8 from "path";
 import fg6 from "fast-glob";
 var packageManagerFor = async (rootDir, packageDir) => {
@@ -6908,7 +7062,7 @@ var packageManagerFor = async (rootDir, packageDir) => {
   ];
   for (const [lockfile, manager] of lockfiles) {
     try {
-      await fs17.access(path8.join(rootDir, packageDir, lockfile));
+      await fs16.access(path8.join(rootDir, packageDir, lockfile));
       return manager;
     } catch {
       continue;
@@ -6926,7 +7080,7 @@ var discoverPackageMetadata = async (rootDir) => {
   const packages = [];
   for (const packageFile of packageFiles.sort()) {
     const packageDir = path8.posix.dirname(packageFile) === "." ? "" : path8.posix.dirname(packageFile);
-    const raw = JSON.parse(await fs17.readFile(path8.join(rootDir, packageFile), "utf8"));
+    const raw = JSON.parse(await fs16.readFile(path8.join(rootDir, packageFile), "utf8"));
     const scripts = raw.scripts && typeof raw.scripts === "object" ? Object.keys(raw.scripts).sort() : [];
     packages.push({
       path: packageFile,
@@ -6998,96 +7152,6 @@ var buildRouteMap = async (rootDir) => {
   };
 };
 
-// src/repo-index/typescript-symbols.ts
-import ts from "typescript";
-var sortStrings = (values) => [...new Set(values)].sort();
-var hasExportModifier = (node) => {
-  return Boolean(
-    ts.canHaveModifiers(node) && ts.getModifiers(node)?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword)
-  );
-};
-var declarationName = (node) => {
-  if (!node.name || !ts.isIdentifier(node.name)) {
-    return null;
-  }
-  return node.name.text;
-};
-var addExport = (exports, publicSymbols, path14, name, kind) => {
-  if (!name) {
-    return;
-  }
-  const entry = { path: path14, name, kind };
-  exports.push(entry);
-  publicSymbols.push(entry);
-};
-var analyzeTypeScriptSource = (path14, source) => {
-  const sourceFile = ts.createSourceFile(path14, source, ts.ScriptTarget.Latest, true);
-  const imports = [];
-  const exports = [];
-  const publicSymbols = [];
-  for (const statement of sourceFile.statements) {
-    if (ts.isImportDeclaration(statement) && ts.isStringLiteral(statement.moduleSpecifier)) {
-      const imported = [];
-      const clause = statement.importClause;
-      if (clause?.name) {
-        imported.push("default");
-      }
-      if (clause?.namedBindings && ts.isNamespaceImport(clause.namedBindings)) {
-        imported.push("*");
-      }
-      if (clause?.namedBindings && ts.isNamedImports(clause.namedBindings)) {
-        for (const element of clause.namedBindings.elements) {
-          imported.push(element.propertyName?.text ?? element.name.text);
-        }
-      }
-      imports.push({
-        from: path14,
-        specifier: statement.moduleSpecifier.text,
-        imported: sortStrings(imported)
-      });
-      continue;
-    }
-    if (ts.isExportDeclaration(statement)) {
-      if (statement.exportClause && ts.isNamedExports(statement.exportClause)) {
-        for (const element of statement.exportClause.elements) {
-          addExport(exports, publicSymbols, path14, element.name.text, "re-export");
-        }
-      }
-      continue;
-    }
-    if (ts.isFunctionDeclaration(statement) && hasExportModifier(statement)) {
-      addExport(exports, publicSymbols, path14, declarationName(statement), "function");
-      continue;
-    }
-    if (ts.isClassDeclaration(statement) && hasExportModifier(statement)) {
-      addExport(exports, publicSymbols, path14, declarationName(statement), "class");
-      continue;
-    }
-    if (ts.isInterfaceDeclaration(statement) && hasExportModifier(statement)) {
-      addExport(exports, publicSymbols, path14, declarationName(statement), "interface");
-      continue;
-    }
-    if (ts.isTypeAliasDeclaration(statement) && hasExportModifier(statement)) {
-      addExport(exports, publicSymbols, path14, declarationName(statement), "type");
-      continue;
-    }
-    if (ts.isEnumDeclaration(statement) && hasExportModifier(statement)) {
-      addExport(exports, publicSymbols, path14, declarationName(statement), "enum");
-      continue;
-    }
-    if (ts.isVariableStatement(statement) && hasExportModifier(statement)) {
-      for (const declaration of statement.declarationList.declarations) {
-        addExport(exports, publicSymbols, path14, declarationName(declaration), "const");
-      }
-    }
-  }
-  return {
-    imports: imports.sort((left, right) => left.specifier.localeCompare(right.specifier)),
-    exports: exports.sort((left, right) => left.name.localeCompare(right.name)),
-    publicSymbols: publicSymbols.sort((left, right) => left.name.localeCompare(right.name))
-  };
-};
-
 // src/repo-index/build.ts
 var buildRepoIndex = async (cwd) => {
   const repository = await getGitRepository(cwd);
@@ -7100,20 +7164,7 @@ var buildRepoIndex = async (cwd) => {
     discoverRepoFiles(rootDir, ignore),
     buildRouteMap(rootDir)
   ]);
-  const imports = [];
-  const exports = [];
-  const publicSymbols = [];
   diagnostics.push(...routeMap.diagnostics);
-  for (const file of fileTree.files) {
-    if (!isJavaScriptLikePath(file.path)) {
-      continue;
-    }
-    const source = await fs18.readFile(path9.join(rootDir, file.path), "utf8");
-    const analysis = analyzeTypeScriptSource(file.path, source);
-    imports.push(...analysis.imports);
-    exports.push(...analysis.exports);
-    publicSymbols.push(...analysis.publicSymbols);
-  }
   return {
     schemaVersion: "repo-index/v0",
     repository: {
@@ -7125,11 +7176,6 @@ var buildRepoIndex = async (cwd) => {
     files: fileTree.files,
     docs: fileTree.docs,
     tests: fileTree.tests,
-    imports: imports.sort((left, right) => `${left.from}:${left.specifier}`.localeCompare(`${right.from}:${right.specifier}`)),
-    exports: exports.sort((left, right) => `${left.path}:${left.name}`.localeCompare(`${right.path}:${right.name}`)),
-    publicSymbols: publicSymbols.sort(
-      (left, right) => `${left.path}:${left.name}`.localeCompare(`${right.path}:${right.name}`)
-    ),
     routeMap,
     diagnostics
   };
@@ -7139,8 +7185,8 @@ var buildRepoIndex = async (cwd) => {
 import { execa as execa4 } from "execa";
 
 // src/git/changes.ts
-import fs19 from "fs/promises";
-import path10 from "path";
+import fs17 from "fs/promises";
+import path9 from "path";
 import { execa as execa3 } from "execa";
 var normalizePath3 = (filePath) => {
   return filePath.replaceAll("\\", "/").replace(/^\.\//u, "");
@@ -7151,7 +7197,7 @@ var listChangedPaths = async (cwd, args) => {
 };
 var pathExists4 = async (filePath) => {
   try {
-    await fs19.access(filePath);
+    await fs17.access(filePath);
     return true;
   } catch {
     return false;
@@ -7195,7 +7241,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(path10.join(rootDir, deletedPath));
+    change.deleted = !await pathExists4(path9.join(rootDir, deletedPath));
   }
   return Array.from(changesByPath.values()).sort((left, right) => {
     return left.path.localeCompare(right.path);
@@ -7279,14 +7325,6 @@ var getChangedFiles = async (cwd, base) => {
     diagnostics
   };
 };
-var readBaseFile = async (cwd, base, filePath) => {
-  const repository = await getGitRepository(cwd);
-  const result = await execa4("git", ["show", `${base}:${filePath}`], {
-    cwd: repository.worktreePath,
-    reject: false
-  });
-  return (result.exitCode ?? 1) === 0 ? result.stdout : null;
-};
 
 // src/impact/build.ts
 var uniqueSorted2 = (values) => [...new Set(values)].sort();
@@ -7304,65 +7342,15 @@ var toImpactRoute = (route) => ({
   truthDocs: [...route.truthDocs].sort(),
   codeSurface: [...route.codeSurface].sort()
 });
-var changedPathSet = (changedFiles) => {
-  return new Set(
-    changedFiles.flatMap((file) => [file.path, ...file.previousPath ? [file.previousPath] : []])
-  );
-};
 var changedFilePaths = (changedFile) => {
   return [changedFile.path, ...changedFile.previousPath ? [changedFile.previousPath] : []];
 };
-var resolveImportPath = (importEdge) => {
-  if (!importEdge.specifier.startsWith(".")) {
-    return null;
-  }
-  const basePath = path11.posix.normalize(path11.posix.join(path11.posix.dirname(importEdge.from), importEdge.specifier));
-  const withoutExtension = basePath.replace(/\.[cm]?[jt]sx?$/u, "");
-  return withoutExtension;
-};
-var importTargetsChangedFile = (importEdge, changedPath) => {
-  const resolved = resolveImportPath(importEdge);
-  if (!resolved) {
-    return false;
-  }
-  return changedPath.replace(/\.[cm]?[jt]sx?$/u, "") === resolved;
-};
 var pathSegments = (filePath) => filePath.split("/").filter(Boolean);
 var testHintMatchesChangedFile = (hints, changedPath) => {
-  const changedBaseName = path11.posix.basename(changedPath);
+  const changedBaseName = path10.posix.basename(changedPath);
   const changedSegments = pathSegments(changedPath);
   return hints.some((hint) => changedBaseName.startsWith(hint) || changedSegments.includes(hint));
 };
-var changedSymbolsFor = async (cwd, base, basePath, currentPath, currentExports) => {
-  if (!isJavaScriptLikePath(basePath) && !isJavaScriptLikePath(currentPath)) {
-    return [];
-  }
-  const baseSource = await readBaseFile(cwd, base, basePath);
-  const baseExports = baseSource ? analyzeTypeScriptSource(basePath, baseSource).exports : [];
-  const currentByName = new Map(currentExports.map((entry) => [entry.name, entry]));
-  const baseByName = new Map(baseExports.map((entry) => [entry.name, entry]));
-  const changes = [];
-  if (basePath !== currentPath) {
-    for (const entry of currentExports) {
-      changes.push({ path: currentPath, name: entry.name, kind: entry.kind, change: "added" });
-    }
-    for (const entry of baseExports) {
-      changes.push({ path: basePath, name: entry.name, kind: entry.kind, change: "removed" });
-    }
-    return changes;
-  }
-  for (const [name, entry] of currentByName) {
-    if (!baseByName.has(name)) {
-      changes.push({ path: currentPath, name, kind: entry.kind, change: "added" });
-    }
-  }
-  for (const [name, entry] of baseByName) {
-    if (!currentByName.has(name)) {
-      changes.push({ path: basePath, name, kind: entry.kind, change: "removed" });
-    }
-  }
-  return changes;
-};
 var buildImpactSet = async (cwd, options) => {
   const repository = await getGitRepository(cwd);
   const rootDir = repository.worktreePath;
@@ -7377,7 +7365,6 @@ var buildImpactSet = async (cwd, options) => {
   const affectedRoutes = /* @__PURE__ */ new Map();
   const affectedTruthDocs = [];
   const affectedTests = [];
-  const changedPublicSymbols = [];
   const knownTestPaths = new Set(repoIndex.tests.map((test) => test.path));
   for (const changedFile of changedFiles) {
     const routeCandidatePaths = changedFilePaths(changedFile);
@@ -7410,60 +7397,15 @@ var buildImpactSet = async (cwd, options) => {
         file: changedFile.path
       });
     }
-    const currentExports = repoIndex.exports.filter((entry) => entry.path === changedFile.path);
-    changedPublicSymbols.push(
-      ...await changedSymbolsFor(
-        rootDir,
-        options.base,
-        changedFile.previousPath ?? changedFile.path,
-        changedFile.path,
-        currentExports
-      )
-    );
   }
   const uniqueAffectedTruthDocs = uniqueSorted2(affectedTruthDocs);
-  const changedPaths = changedPathSet(changedFiles);
-  for (const symbol of changedPublicSymbols) {
-    if (uniqueAffectedTruthDocs.length === 0) {
-      diagnostics.push({
-        category: "impact",
-        severity: "review",
-        message: `Changed public symbol ${symbol.name} in ${symbol.path} has no affected truth document.`,
-        file: symbol.path,
-        data: {
-          symbol: symbol.name,
-          change: symbol.change
-        }
-      });
-      continue;
-    }
-    if (!uniqueAffectedTruthDocs.some((truthDoc) => changedPaths.has(truthDoc))) {
-      diagnostics.push({
-        category: "impact",
-        severity: "review",
-        message: `Changed public symbol ${symbol.name} in ${symbol.path} has affected truth docs but none were changed in this impact set.`,
-        file: symbol.path,
-        data: {
-          symbol: symbol.name,
-          change: symbol.change,
-          affectedTruthDocs: uniqueAffectedTruthDocs
-        }
-      });
-    }
-  }
   for (const test of repoIndex.tests) {
-    const testImports = repoIndex.imports.filter((edge) => edge.from === test.path);
-    const importsChangedFile = changedFiles.some(
-      (changedFile) => changedFilePaths(changedFile).some(
-        (filePath) => testImports.some((importEdge) => importTargetsChangedFile(importEdge, filePath))
-      )
-    );
     const hintMatchesChangedFile = changedFiles.some(
       (changedFile) => changedFilePaths(changedFile).some(
         (filePath) => testHintMatchesChangedFile(test.targetHints, filePath)
       )
     );
-    if (importsChangedFile || hintMatchesChangedFile) {
+    if (hintMatchesChangedFile) {
       affectedTests.push(test.path);
     }
   }
@@ -7477,9 +7419,6 @@ var buildImpactSet = async (cwd, options) => {
     ),
     affectedTruthDocs: uniqueAffectedTruthDocs,
     affectedTests: uniqueSorted2(affectedTests),
-    changedPublicSymbols: changedPublicSymbols.sort(
-      (left, right) => `${left.path}:${left.name}:${left.change}`.localeCompare(`${right.path}:${right.name}:${right.change}`)
-    ),
     diagnostics
   };
 };
@@ -7505,14 +7444,13 @@ var checkFreshness = async (rootDir, _config, _truthDocumentPaths, base) => {
 };
 
 // src/evidence/validate.ts
-import fs21 from "fs/promises";
+import fs19 from "fs/promises";
 import fg7 from "fast-glob";
 
 // src/evidence/parse.ts
-import fs20 from "fs/promises";
-import path12 from "path";
-import matter4 from "gray-matter";
-import { parse as parse3 } from "yaml";
+import fs18 from "fs/promises";
+import path11 from "path";
+import { parse as parse4 } from "yaml";
 var yamlFencePattern = /```ya?ml\s*\n([\s\S]*?)```/giu;
 var topLevelEvidenceMarkerPattern = /^evidence\s*:/imu;
 var toEvidenceReference = (truthDocPath, raw) => {
@@ -7530,8 +7468,8 @@ var toEvidenceReference = (truthDocPath, raw) => {
   };
 };
 var parseEvidenceReferences = async (rootDir, truthDocPath) => {
-  const source = await fs20.readFile(path12.join(rootDir, truthDocPath), "utf8");
-  const parsed = matter4(source);
+  const source = await fs18.readFile(path11.join(rootDir, truthDocPath), "utf8");
+  const parsed = parseFrontmatter(source);
   const references = [];
   for (const entry of parseSourceReferences(source, truthDocPath)) {
     references.push({
@@ -7545,7 +7483,7 @@ var parseEvidenceReferences = async (rootDir, truthDocPath) => {
     if (!topLevelEvidenceMarkerPattern.test(yamlBlock)) {
       continue;
     }
-    const block = parse3(yamlBlock);
+    const block = parse4(yamlBlock);
     const rawEvidence = block && typeof block === "object" && "evidence" in block ? block.evidence : null;
     if (!Array.isArray(rawEvidence)) {
       continue;
@@ -7563,7 +7501,7 @@ var parseEvidenceReferences = async (rootDir, truthDocPath) => {
 // src/evidence/validate.ts
 var pathExists5 = async (filePath) => {
   try {
-    await fs21.access(filePath);
+    await fs19.access(filePath);
     return true;
   } catch {
     return false;
@@ -7601,15 +7539,6 @@ var validateGlob = async (rootDir, reference) => {
   });
   return matches.length > 0 ? null : diagnosticFor(reference, `Referenced file pattern ${reference.path} does not match any file.`);
 };
-var validateSymbol = async (rootDir, reference) => {
-  if (!reference.symbol || !isJavaScriptLikePath(reference.path)) {
-    return null;
-  }
-  const source = await fs21.readFile(resolveRepoPath(rootDir, reference.path), "utf8");
-  const analysis = analyzeTypeScriptSource(reference.path, source);
-  const hasSymbol = analysis.publicSymbols.some((symbol) => symbol.name === reference.symbol);
-  return hasSymbol ? null : diagnosticFor(reference, `Evidence symbol ${reference.symbol} was not found in ${reference.path}.`);
-};
 var validateHash = async (rootDir, reference) => {
   if (!reference.contentHash) {
     return null;
@@ -7617,7 +7546,7 @@ var validateHash = async (rootDir, reference) => {
   if (!reference.contentHash.startsWith("sha256:")) {
     return diagnosticFor(reference, `Evidence hash for ${reference.path} must use sha256:.`);
   }
-  const source = await fs21.readFile(resolveRepoPath(rootDir, reference.path), "utf8");
+  const source = await fs19.readFile(resolveRepoPath(rootDir, reference.path), "utf8");
   const lines = source.split("\n");
   const startLine = reference.startLine ?? 1;
   const endLine = reference.endLine ?? lines.length;
@@ -7631,7 +7560,7 @@ var validateLineSpan = async (rootDir, reference) => {
   if (reference.startLine === void 0 && reference.endLine === void 0) {
     return null;
   }
-  const source = await fs21.readFile(resolveRepoPath(rootDir, reference.path), "utf8");
+  const source = await fs19.readFile(resolveRepoPath(rootDir, reference.path), "utf8");
   const lines = source.split("\n");
   const startLine = reference.startLine ?? 1;
   const endLine = reference.endLine ?? lines.length;
@@ -7650,10 +7579,6 @@ var validateReference = async (rootDir, reference) => {
       diagnostics.push(diagnosticFor(reference, `Referenced file ${reference.path} does not exist.`));
       return diagnostics;
     }
-    const symbolDiagnostic = await validateSymbol(rootDir, reference);
-    if (symbolDiagnostic) {
-      diagnostics.push(symbolDiagnostic);
-    }
     const lineSpanDiagnostic = await validateLineSpan(rootDir, reference);
     if (lineSpanDiagnostic) {
       diagnostics.push(lineSpanDiagnostic);
@@ -7910,220 +7835,60 @@ var runCheck = async (cwd, options = {}) => {
   };
 };
 
-// src/context-pack/build.ts
-import fs22 from "fs/promises";
-import path13 from "path";
-import fg8 from "fast-glob";
-var uniqueSorted3 = (values) => [...new Set(values)].sort();
-var repoRootPrefixes2 = [".codex/", ".github/", ".truthmark/", "docs/", "src/", "tests/"];
-var isGlobReference2 = (referencePath) => /[*?[\]{}()]/u.test(referencePath);
-var normalizeDocReferencePath = (docPath, referencePath) => {
-  const strippedPath = referencePath.split("#")[0]?.trim() ?? "";
-  if (strippedPath.length === 0 || strippedPath.startsWith("/")) {
-    return null;
-  }
-  const isRepoRelative = repoRootPrefixes2.some((prefix) => strippedPath.startsWith(prefix));
-  const normalized = isRepoRelative ? path13.posix.normalize(strippedPath) : path13.posix.normalize(path13.posix.join(path13.posix.dirname(docPath), strippedPath));
-  return normalized === ".." || normalized.startsWith("../") ? null : normalized;
-};
-var readIfExists = async (rootDir, filePath) => {
-  try {
-    return await fs22.readFile(path13.join(rootDir, filePath), "utf8");
-  } catch {
-    return null;
-  }
-};
-var boundContent = (content) => {
-  const lines = content.split("\n");
-  if (lines.length <= 200) {
-    return { content, truncated: false };
-  }
-  return {
-    content: [...lines.slice(0, 80), "...", ...lines.slice(-40)].join("\n"),
-    truncated: true
-  };
-};
-var boundedContent = (filePath, content, warnings) => {
-  const bounded = boundContent(content);
-  if (!bounded.truncated) {
-    return { path: filePath, content, truncated: false };
-  }
-  warnings.push({
-    category: "context-pack",
-    severity: "review",
-    message: `Context source file ${filePath} was truncated to fit ContextPack v0 bounds.`,
-    file: filePath
-  });
-  return {
-    path: filePath,
-    content: bounded.content,
-    truncated: true
-  };
-};
-var documentsFor = async (rootDir, paths, warnings) => {
-  const documents = [];
-  for (const filePath of uniqueSorted3(paths)) {
-    const content = await readIfExists(rootDir, filePath);
-    if (content !== null) {
-      const bounded = boundContent(content);
-      if (bounded.truncated) {
-        warnings.push({
-          category: "context-pack",
-          severity: "review",
-          message: `Context truth doc ${filePath} was truncated to fit ContextPack v0 bounds.`,
-          file: filePath
-        });
-      }
-      documents.push({ path: filePath, content: bounded.content, truncated: bounded.truncated });
-    }
-  }
-  return documents;
-};
-var sourceFilesFor = async (rootDir, paths, warnings) => {
-  const sourceFiles = [];
-  for (const filePath of uniqueSorted3(paths)) {
-    const content = await readIfExists(rootDir, filePath);
-    if (content !== null) {
-      sourceFiles.push(boundedContent(filePath, content, warnings));
-    }
-  }
-  return sourceFiles;
-};
-var sourceOfTruthPathsFor = async (rootDir, docs, truthDocPaths) => {
-  const selectedTruthDocs = new Set(truthDocPaths);
-  const sourcePaths = [];
-  for (const doc of docs) {
-    if (!selectedTruthDocs.has(doc.path)) {
-      continue;
-    }
-    for (const referencePath of doc.sourceOfTruth) {
-      const normalizedPath = normalizeDocReferencePath(doc.path, referencePath);
-      if (!normalizedPath) {
-        continue;
-      }
-      if (isGlobReference2(normalizedPath)) {
-        sourcePaths.push(
-          ...await fg8(normalizedPath, {
-            cwd: rootDir,
-            dot: true,
-            onlyFiles: true,
-            followSymbolicLinks: false
-          })
-        );
-      } else {
-        sourcePaths.push(normalizedPath);
-      }
-    }
-  }
-  return uniqueSorted3(sourcePaths);
-};
-var writePathsFor = (workflow, routeIndexPath, truthDocs, routes) => {
-  if (workflow === "truth-sync") {
-    return uniqueSorted3([routeIndexPath, ...truthDocs]);
-  }
-  if (workflow === "truth-document") {
-    return uniqueSorted3([routeIndexPath, ...truthDocs]);
-  }
-  return uniqueSorted3(routes.flatMap((route) => route.codeSurface));
-};
-var testCommandsFor = (affectedTests) => {
-  return affectedTests.length === 0 ? ["npm test"] : [`npm test -- ${affectedTests.join(" ")}`];
-};
-var buildContextPack = async (cwd, options) => {
-  const repoIndex = await buildRepoIndex(cwd);
-  const rootDir = repoIndex.repository.root;
-  const loadResult = await loadConfig(rootDir);
-  const config = loadResult.config ?? (loadResult.status === "missing" ? createDefaultConfig() : null);
-  const impactSet = options.base ? await buildImpactSet(rootDir, { base: options.base }) : null;
-  const routeMap = impactSet ? repoIndex.routeMap : repoIndex.routeMap;
-  const warnings = loadResult.status === "invalid" ? [...loadResult.diagnostics] : [];
-  const truthDocPaths = impactSet?.affectedTruthDocs ?? (options.workflow === "truth-realize" ? [] : routeMap.routes.flatMap((route) => route.truthDocs));
-  const contextRoutes = impactSet?.affectedRoutes ?? (options.workflow === "truth-realize" ? [] : routeMap.routes);
-  if (options.workflow === "truth-realize" && !impactSet) {
-    warnings.push({
-      category: "context-pack",
-      severity: "review",
-      message: "truth-realize requires --base to derive bounded allowed write paths."
-    });
-  }
-  const sourceOfTruthPaths = await sourceOfTruthPathsFor(rootDir, repoIndex.docs, truthDocPaths);
-  const sourceFilePaths = uniqueSorted3([
-    ...impactSet?.changedFiles.filter((file) => !file.deleted).map((file) => file.path) ?? [],
-    ...sourceOfTruthPaths
-  ]);
-  return {
-    schemaVersion: "context-pack/v0",
-    workflow: options.workflow,
-    base: options.base ?? null,
-    impactSet,
-    routeMap,
-    allowedWritePaths: config === null ? [] : writePathsFor(
-      options.workflow,
-      config.truthmark.paths.routesIndex,
-      truthDocPaths,
-      contextRoutes
-    ),
-    truthDocs: await documentsFor(rootDir, truthDocPaths, warnings),
-    sourceFiles: await sourceFilesFor(rootDir, sourceFilePaths, warnings),
-    testCommands: testCommandsFor(impactSet?.affectedTests ?? []),
-    warnings
-  };
-};
-
-// src/context-pack/render.ts
-var renderContextPackMarkdown = (pack) => {
-  const lines = [
-    `# Truthmark ContextPack (${pack.workflow})`,
-    "",
-    `Schema: ${pack.schemaVersion}`,
-    `Base: ${pack.base ?? "none"}`,
-    "",
-    "## Allowed Write Paths",
-    ...pack.allowedWritePaths.map((filePath) => `- ${filePath}`),
-    "",
-    "## Truth Docs",
-    ...pack.truthDocs.map((doc) => `- ${doc.path}${doc.truncated ? " (truncated)" : ""}`),
-    "",
-    "## Source Files",
-    ...pack.sourceFiles.map((file) => `- ${file.path}${file.truncated ? " (truncated)" : ""}`),
-    "",
-    "## Test Commands",
-    ...pack.testCommands.map((command) => `- ${command}`)
-  ];
-  return `${lines.join("\n")}
-`;
-};
-
 // src/workflow-state/build.ts
 import { execa as execa5 } from "execa";
 
 // src/workflow-state/action-context.ts
-var uniqueSorted4 = (values) => [...new Set(values.filter((value) => value.length > 0))].sort();
+var uniqueSorted3 = (values) => [...new Set(values.filter((value) => value.length > 0))].sort();
 var helperCommandsFor = (manifestEntry) => (manifestEntry.helpers ?? []).map((helper) => ({
   id: helper.id,
   runner: helper.runner,
   argv: [...helper.command.argv],
   optional: helper.optional
 }));
-var evidenceFor = (manifestEntry) => manifestEntry.requiredGates.filter((gate) => /evidence|ownership|containment/iu.test(gate));
-var baseContext = (manifestEntry, mode, allowedWritePaths, forbiddenWritePaths, writeLeaseRequired) => ({
+var evidenceFor = (manifestEntry) => manifestEntry.reviewQuestions.filter(
+  (question) => /evidence|ownership|containment/iu.test(question)
+);
+var baseContext = (manifestEntry, mode, allowedWritePaths, routeFiles, primaryTruthDocs, candidateStaleTruthDocs, forbiddenWritePaths, writeLeaseRequired) => ({
   mode,
-  allowedWritePaths: uniqueSorted4(allowedWritePaths),
-  forbiddenWritePaths: uniqueSorted4(forbiddenWritePaths),
-  stopConditions: [...manifestEntry.negativeTriggers, ...manifestEntry.forbiddenAdjacency],
-  requiredEvidence: evidenceFor(manifestEntry),
+  allowedWritePaths: uniqueSorted3(allowedWritePaths),
+  routeFiles: uniqueSorted3(routeFiles),
+  primaryTruthDocs: uniqueSorted3(primaryTruthDocs),
+  candidateStaleTruthDocs: uniqueSorted3(candidateStaleTruthDocs),
+  forbiddenWritePaths: uniqueSorted3(forbiddenWritePaths),
+  stopConditions: [
+    ...manifestEntry.negativeTriggers,
+    ...manifestEntry.forbiddenAdjacency
+  ],
+  evidencePrompts: uniqueSorted3([
+    ...evidenceFor(manifestEntry),
+    ...candidateStaleTruthDocs.length > 0 ? [
+      "Record checkout evidence and the reason before touching a candidate stale truth doc outside primaryTruthDocs."
+    ] : []
+  ]),
   helperValidationCommands: helperCommandsFor(manifestEntry),
   writeLeaseRequired
 });
 var buildWorkflowActionContext = (manifestEntry, data = {}) => {
   if (manifestEntry.id === "truthmark-preview" || manifestEntry.id === "truthmark-check") {
-    return baseContext(manifestEntry, "read-only", [], [], false);
+    return baseContext(manifestEntry, "read-only", [], [], [], [], [], false);
   }
   if (manifestEntry.id === "truthmark-sync" || manifestEntry.id === "truthmark-document") {
+    const routeFiles = data.routeFiles ?? [];
+    const primaryTruthDocs = data.primaryTruthDocs ?? data.truthDocs ?? [];
+    const candidateStaleTruthDocs = data.candidateStaleTruthDocs ?? [];
     return baseContext(
       manifestEntry,
       "truth-doc-write",
-      [...data.routeIndexPath ? [data.routeIndexPath] : [], ...data.routeFiles ?? [], ...data.truthDocs ?? []],
+      [
+        ...data.routeIndexPath ? [data.routeIndexPath] : [],
+        ...routeFiles,
+        ...primaryTruthDocs,
+        ...candidateStaleTruthDocs
+      ],
+      routeFiles,
+      primaryTruthDocs,
+      candidateStaleTruthDocs,
       [],
       true
     );
@@ -8137,6 +7902,9 @@ var buildWorkflowActionContext = (manifestEntry, data = {}) => {
         ...data.routeFiles ?? [],
         ...data.starterTruthDocs ?? []
       ],
+      data.routeFiles ?? [],
+      data.starterTruthDocs ?? [],
+      [],
       [],
       true
     );
@@ -8146,6 +7914,9 @@ var buildWorkflowActionContext = (manifestEntry, data = {}) => {
       manifestEntry,
       "code-write",
       data.codeWritePaths ?? [],
+      data.routeFiles ?? [],
+      data.truthDocs ?? [],
+      [],
       [
         ...data.routeIndexPath ? [data.routeIndexPath] : [],
         ...data.routeFiles ?? [],
@@ -8160,6 +7931,9 @@ var buildWorkflowActionContext = (manifestEntry, data = {}) => {
     "portal-write",
     data.portalEnabled && data.portalOutputPath ? [`${data.portalOutputPath}/**`] : [],
     [],
+    [],
+    [],
+    [],
     false
   );
 };
@@ -8171,79 +7945,139 @@ var helperCommandsFor2 = (workflow) => (TRUTHMARK_WORKFLOW_MANIFEST[workflow].he
   argv: [...helper.command.argv],
   optional: helper.optional
 }));
-var uniqueSorted5 = (values) => [...new Set(values.filter((value) => value.length > 0))].sort();
+var uniqueSorted4 = (values) => [...new Set(values.filter((value) => value.length > 0))].sort();
 var isWriteCapable = (workflow) => !["truthmark-preview", "truthmark-check"].includes(workflow);
-var DEFAULT_BASE_CANDIDATES = ["@{upstream}", "origin/main", "main", "origin/master", "master"];
+var DEFAULT_BASE_CANDIDATES = [
+  "@{upstream}",
+  "origin/main",
+  "main",
+  "origin/master",
+  "master"
+];
 var selectComparisonBase = async (rootDir, suppliedBase) => {
   if (suppliedBase) {
     return suppliedBase;
   }
   for (const candidate of DEFAULT_BASE_CANDIDATES) {
-    const result = await execa5("git", ["rev-parse", "--verify", `${candidate}^{commit}`], {
-      cwd: rootDir,
-      reject: false
-    });
+    const result = await execa5(
+      "git",
+      ["rev-parse", "--verify", `${candidate}^{commit}`],
+      {
+        cwd: rootDir,
+        reject: false
+      }
+    );
     if ((result.exitCode ?? 1) === 0) {
       return candidate;
     }
   }
   return null;
 };
-var routeFilesFor = (repoIndex) => uniqueSorted5(repoIndex.routeMap.routes.map((route) => route.sourcePath));
+var routeFilesFor = (repoIndex) => uniqueSorted4(repoIndex.routeMap.routes.map((route) => route.sourcePath));
+var candidateStaleTruthDocsFor = (indexedTruthDocs, primaryTruthDocs) => {
+  const primary = new Set(primaryTruthDocs);
+  return indexedTruthDocs.filter((truthDoc) => !primary.has(truthDoc));
+};
 var hasUnmappedFunctionalChange = (impactSet) => impactSet?.diagnostics.some(
-  (diagnostic) => diagnostic.category === "impact" && /not mapped to a Truthmark route|no affected truth document/u.test(diagnostic.message)
+  (diagnostic) => diagnostic.category === "impact" && /not mapped to a Truthmark route|no affected truth document/u.test(
+    diagnostic.message
+  )
 ) ?? false;
 var applicabilityFor = (workflow, diagnostics, impactSet) => {
   const reasons = [];
-  if (diagnostics.some((diagnostic) => diagnostic.message.includes("Missing .truthmark/config.yml"))) {
+  if (diagnostics.some(
+    (diagnostic) => diagnostic.message.includes("Missing .truthmark/config.yml")
+  )) {
     reasons.push("Missing .truthmark/config.yml.");
-    return { state: isWriteCapable(workflow) ? "blocked" : "not_applicable", reasons };
+    return {
+      state: isWriteCapable(workflow) ? "needs_manual_review" : "not_applicable",
+      reasons
+    };
   }
   if (workflow === "truthmark-sync" && !impactSet) {
-    reasons.push("truthmark-sync requires --base to derive bounded truth-doc write paths.");
-    return { state: "blocked", reasons };
+    reasons.push(
+      "Choose a comparison base with --base <ref> when workflow status cannot infer one automatically."
+    );
+    return { state: "needs_manual_review", reasons };
   }
   if (workflow === "truthmark-realize" && !impactSet) {
-    reasons.push("truthmark-realize requires --base to derive bounded allowed write paths.");
-    return { state: "blocked", reasons };
+    reasons.push(
+      "Choose a comparison base with --base <ref> so the helper can suggest bounded code-write paths."
+    );
+    return { state: "needs_manual_review", reasons };
   }
   if (hasUnmappedFunctionalChange(impactSet)) {
-    reasons.push("Changed functional files have ambiguous or missing Truthmark route ownership.");
-    return { state: "ambiguous", reasons };
+    reasons.push(
+      "Changed functional files need route ownership review before truth-doc suggestions are reliable."
+    );
+    return { state: "needs_routing_review", reasons };
   }
   if (diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
-    reasons.push("Existing diagnostics contain errors that block safe workflow execution.");
-    return { state: "blocked", reasons };
+    reasons.push(
+      "Existing diagnostics need manual review before using helper write suggestions."
+    );
+    return { state: "needs_manual_review", reasons };
   }
-  return { state: "applicable", reasons };
+  return { state: "ready", reasons };
+};
+var workflowCardFor = (workflow, applicability, diagnostics, impactSet) => {
+  const helpers = helperCommandsFor2(workflow);
+  const diagnosticQuestions = diagnostics.filter((diagnostic) => diagnostic.severity === "error").map((diagnostic) => diagnostic.message);
+  return {
+    affectedFiles: uniqueSorted4(
+      impactSet?.changedFiles.map((file) => file.path) ?? []
+    ),
+    likelyRouteOwners: uniqueSorted4(
+      impactSet?.affectedRoutes.map((route) => route.sourcePath) ?? []
+    ),
+    suggestedTruthDocs: applicability.state === "needs_routing_review" ? [] : uniqueSorted4(impactSet?.affectedTruthDocs ?? []),
+    openQuestions: uniqueSorted4([
+      ...applicability.reasons,
+      ...diagnosticQuestions
+    ]),
+    skippedHelperStatus: helpers.map((helper) => ({
+      helper: helper.id,
+      status: "skipped",
+      reason: "workflow status does not run optional helpers; inspect the checkout directly or run the helper manually when useful."
+    }))
+  };
 };
 var contextDataFor = (workflow, repoIndex, config, impactSet) => {
   if (!config) {
     return {};
   }
   const routeFiles = routeFilesFor(repoIndex);
-  const truthDocs = uniqueSorted5(
-    impactSet?.affectedTruthDocs ?? repoIndex.routeMap.routes.flatMap((route) => route.truthDocs)
+  const indexedTruthDocs = uniqueSorted4(
+    repoIndex.routeMap.routes.flatMap((route) => route.truthDocs)
   );
+  const primaryTruthDocs = uniqueSorted4(impactSet?.affectedTruthDocs ?? []);
+  const candidateStaleTruthDocs = workflow === "truthmark-sync" ? candidateStaleTruthDocsFor(indexedTruthDocs, primaryTruthDocs) : [];
+  const truthDocs = workflow === "truthmark-sync" ? uniqueSorted4([...primaryTruthDocs, ...candidateStaleTruthDocs]) : uniqueSorted4(impactSet?.affectedTruthDocs ?? indexedTruthDocs);
   return {
     routeIndexPath: config.truthmark.paths.routesIndex,
     routeFiles,
     truthRoot: config.truthmark.paths.truthRoot,
     truthDocs,
+    primaryTruthDocs: workflow === "truthmark-sync" ? primaryTruthDocs : truthDocs,
+    candidateStaleTruthDocs,
     starterTruthDocs: workflow === "truthmark-structure" ? truthDocs : [],
-    codeWritePaths: workflow === "truthmark-realize" ? uniqueSorted5(impactSet?.affectedRoutes.flatMap((route) => route.codeSurface) ?? []) : [],
+    codeWritePaths: workflow === "truthmark-realize" ? uniqueSorted4(
+      impactSet?.affectedRoutes.flatMap((route) => route.codeSurface) ?? []
+    ) : [],
     portalEnabled: config.truthmark.generated.portal.enabled,
     portalOutputPath: config.truthmark.paths.portalOutput,
     routes: repoIndex.routeMap.routes
   };
 };
 var nextStepsFor = (workflow, applicability, comparisonBase) => {
-  if (applicability.state === "ambiguous") {
-    return ["Run Truth Structure or repair route ownership before writing truth docs."];
+  if (applicability.state === "needs_routing_review") {
+    return [
+      "Run Truth Structure or repair route ownership before writing truth docs."
+    ];
   }
-  if ((workflow === "truthmark-sync" || workflow === "truthmark-realize") && applicability.state === "blocked" && !comparisonBase) {
+  if ((workflow === "truthmark-sync" || workflow === "truthmark-realize") && applicability.state === "needs_manual_review" && !comparisonBase) {
     return [
-      workflow === "truthmark-sync" ? "Rerun with --base <ref> so Truthmark can derive bounded truth-doc write paths." : "Rerun with --base <ref> so Truthmark can derive bounded allowed code-write paths."
+      workflow === "truthmark-sync" ? "Rerun with --base <ref> so the helper can suggest changed-file impact." : "Rerun with --base <ref> so the helper can suggest bounded code-write paths."
     ];
   }
   return [];
@@ -8258,28 +8092,47 @@ var buildWorkflowState = async (cwd, options) => {
   const loadResult = await loadConfig(rootDir);
   const comparisonBase = options.base ? options.base : options.workflow === "truthmark-sync" ? await selectComparisonBase(rootDir) : null;
   const impactSet = comparisonBase ? await buildImpactSet(rootDir, { base: comparisonBase }) : null;
-  const checkResult = await runCheck(cwd, comparisonBase ? { base: comparisonBase } : {});
+  const checkResult = await runCheck(
+    cwd,
+    comparisonBase ? { base: comparisonBase } : {}
+  );
   const diagnostics = [
     ...loadResult.diagnostics,
     ...repoIndex.diagnostics,
     ...impactSet?.diagnostics ?? [],
     ...checkResult.diagnostics
   ];
-  const applicability = applicabilityFor(options.workflow, diagnostics, impactSet);
-  const actionData = applicability.state === "blocked" || applicability.state === "ambiguous" ? {} : contextDataFor(options.workflow, repoIndex, loadResult.config, impactSet);
+  const applicability = applicabilityFor(
+    options.workflow,
+    diagnostics,
+    impactSet
+  );
+  const actionData = applicability.state === "needs_manual_review" || applicability.state === "needs_routing_review" ? {} : contextDataFor(
+    options.workflow,
+    repoIndex,
+    loadResult.config,
+    impactSet
+  );
   return {
     schemaVersion: "truthmark-workflow/v0",
     workflow: options.workflow,
     applicability,
     actionContext: buildWorkflowActionContext(manifestEntry, actionData),
+    workflowCard: workflowCardFor(
+      options.workflow,
+      applicability,
+      diagnostics,
+      impactSet
+    ),
     changedFiles: impactSet?.changedFiles ?? [],
     affectedRoutes: impactSet?.affectedRoutes ?? [],
-    targetTruthDocs: applicability.state === "ambiguous" ? [] : impactSet?.affectedTruthDocs ?? [],
+    targetTruthDocs: applicability.state === "needs_routing_review" ? [] : impactSet?.affectedTruthDocs ?? [],
     diagnostics,
     checks: {
-      required: [...manifestEntry.requiredGates],
+      reviewChecklist: [...manifestEntry.reviewQuestions],
       recommended: [...manifestEntry.positiveTriggers],
-      helpers: helperCommandsFor2(options.workflow)
+      helpers: helperCommandsFor2(options.workflow),
+      affectedTests: impactSet?.affectedTests ?? []
     },
     nextSteps: nextStepsFor(options.workflow, applicability, comparisonBase),
     reportSections: [...manifestEntry.reportSections]
@@ -8287,7 +8140,7 @@ var buildWorkflowState = async (cwd, options) => {
 };
 
 // src/cli/handlers.ts
-import fs23 from "fs/promises";
+import fs20 from "fs/promises";
 
 // src/agents/workflow-helper-validation.ts
 import { parse as parseYaml2 } from "yaml";
@@ -8398,6 +8251,7 @@ var validateTruthSyncReportText = (text) => {
         ["Changed code reviewed", report.changedCode],
         ["Ownership reviewed", report.ownershipReviewed],
         ["Truth docs updated", report.truthDocsUpdated],
+        ["Decision/rationale captured", report.decisionRationaleCaptured],
         ["Notes", report.notes]
       ]) {
         if (items.length === 0) {
@@ -8413,6 +8267,9 @@ var validateTruthSyncReportText = (text) => {
           "Evidence checked entries include Claim:, Evidence:, and Result: supported | narrowed | removed | blocked"
         );
       }
+      if (report.syncIntent !== void 0) {
+        checks.push("Sync Intent");
+      }
       validateHelperScriptEntries(
         report.helperScripts,
         ["validate-write-lease"],
@@ -8649,12 +8506,6 @@ var runImpact = async (options) => {
     }
   };
 };
-var isContextPackWorkflow = (value) => {
-  return value === "truth-sync" || value === "truth-document" || value === "truth-realize";
-};
-var isContextMarkdownFormat = (value) => {
-  return value === void 0 || value === "markdown";
-};
 var isTruthmarkWorkflowId = (value) => {
   return typeof value === "string" && TRUTHMARK_WORKFLOW_IDS.includes(value);
 };
@@ -8674,7 +8525,7 @@ var invalidWorkflowResult = (command, workflow) => ({
 });
 var readHelperFile = async (filePath, helper) => {
   try {
-    return await fs23.readFile(filePath, "utf8");
+    return await fs20.readFile(filePath, "utf8");
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     return { ok: false, helper, errors: [`could not read file: ${message}`] };
@@ -8699,63 +8550,6 @@ var runValidateWriteLease = async (leaseFile, changedFilesFile) => {
   }
   return validateWriteLeaseText(leaseText, changedText);
 };
-var runContext = async (options) => {
-  if (!isContextPackWorkflow(options.workflow)) {
-    return {
-      command: "context",
-      summary: "Truthmark context requires a supported --workflow value.",
-      diagnostics: [
-        {
-          category: "context-pack",
-          severity: "error",
-          message: "truthmark context requires --workflow truth-sync, truth-document, or truth-realize."
-        }
-      ]
-    };
-  }
-  if (options.format === "json") {
-    return {
-      command: "context",
-      summary: "Truthmark context no longer supports JSON ContextPack output.",
-      diagnostics: [
-        {
-          category: "context-pack",
-          severity: "error",
-          message: "JSON ContextPack output was removed in v2; use --format markdown."
-        }
-      ]
-    };
-  }
-  if (!isContextMarkdownFormat(options.format)) {
-    return {
-      command: "context",
-      summary: "Truthmark context requires a supported --format value.",
-      diagnostics: [
-        {
-          category: "context-pack",
-          severity: "error",
-          message: "truthmark context supports only --format markdown; JSON ContextPack output was removed in v2."
-        }
-      ]
-    };
-  }
-  const contextPack = await buildContextPack(process.cwd(), {
-    workflow: options.workflow,
-    base: options.base
-  });
-  const diagnostics = contextPack.warnings;
-  const summary = `Truthmark context generated ${contextPack.workflow} ContextPack with ${diagnostics.length} warnings.`;
-  const markdown = renderContextPackMarkdown(contextPack);
-  return {
-    command: "context",
-    summary,
-    diagnostics,
-    data: {
-      markdown,
-      summary
-    }
-  };
-};
 var runWorkflowStatus = async (options) => {
   if (!isTruthmarkWorkflowId(options.workflow)) {
     return invalidWorkflowResult("workflow status", options.workflow);
@@ -8790,14 +8584,6 @@ var writeResult = (result, options) => {
 `);
   markFailedWhenErrorDiagnosticsExist(result);
 };
-var writeContextResult = (result, options) => {
-  if (!options.json && typeof result.data?.markdown === "string") {
-    process.stdout.write(result.data.markdown);
-    markFailedWhenErrorDiagnosticsExist(result);
-    return;
-  }
-  writeResult(result, options);
-};
 var renderValidationHuman = (result) => {
   if (result.ok === true) {
     return [`${result.helper}: ok`, ...result.checks.map((check) => `- ${check}`)].join("\n");
@@ -8842,7 +8628,7 @@ var buildProgram = () => {
     writeResult(await runCheck2({ base: options.base }), options);
   });
   addJsonOption(
-    program.command("index").description("Build the deterministic Truthmark repository index.")
+    program.command("index").description("Inspect derived Truthmark workflow routing metadata for the current checkout.")
   ).action(async (options) => {
     writeResult(await runIndex(), options);
   });
@@ -8851,18 +8637,6 @@ var buildProgram = () => {
   ).action(async (options) => {
     writeResult(await runImpact({ base: options.base }), options);
   });
-  addJsonOption(
-    program.command("context").description("Generate a bounded workflow context pack.").requiredOption("--workflow <workflow>", "Workflow name: truth-sync, truth-document, or truth-realize").option("--base <ref>", "Base Git ref for impact-backed packs").option("--format <format>", "Output format: markdown", "markdown")
-  ).action(async (options) => {
-    writeContextResult(
-      await runContext({
-        workflow: options.workflow,
-        base: options.base,
-        format: options.format
-      }),
-      options
-    );
-  });
   const workflow = program.command("workflow").description("Inspect agent-facing Truthmark workflow state.");
   addJsonOption(
     workflow.command("status").description("Return schema-versioned workflow state for a canonical workflow ID.").option("--workflow <workflow>", "Canonical workflow ID, such as truthmark-sync").option("--base <ref>", "Base Git ref for impact-backed workflow state")