truthmark 2.2.2 → 2.2.3

package/dist/main.js

@@ -256,13 +256,7 @@ var SUPPORTED_PLATFORMS = [
   "github-copilot",
   "gemini-cli"
 ];
-var DEFAULT_PLATFORMS = [
-  "codex",
-  "opencode",
-  "claude-code",
-  "github-copilot",
-  "gemini-cli"
-];
+var DEFAULT_PLATFORMS = [];
 var truthmarkConfigSchema = {
   type: "object",
   additionalProperties: false,
@@ -368,7 +362,6 @@ var DERIVED_TRUTHMARK_PATHS = {
 var DEFAULT_INSTRUCTION_TARGETS = ["AGENTS.md"];
 var createDefaultRawConfig = () => ({
   version: 2,
-  platforms: [...DEFAULT_PLATFORMS],
   truthmark: {
     workspace: DEFAULT_TRUTHMARK_WORKSPACE.workspace,
     generated: {
@@ -1661,7 +1654,7 @@ var runConfig = async (cwd, options = {}) => {
 };
 
 // src/init/init.ts
-import fs6 from "fs/promises";
+import fs7 from "fs/promises";
 
 // src/config/load.ts
 import fs4 from "fs/promises";
@@ -2031,6 +2024,9 @@ var scaffoldHierarchy = async (rootDir, config) => {
   return results;
 };
 
+// src/checks/generated-surfaces.ts
+import fs6 from "fs/promises";
+
 // src/truth/evidence.ts
 var renderClaimEvidenceCheckedSection = (items) => {
   return [
@@ -2121,6 +2117,7 @@ var FEATURE_DOC_TEMPLATE_INSTRUCTIONS = [
   "If the template is missing, use lane-specific sections: product truth says what must be true and why; engineering truth says how the repository currently realizes it.",
   "Teams may edit template files under the configured Truthmark templates root to define their local truth-doc standards."
 ].join("\n");
+var TRUTH_DOC_AUTHORING_STYLE_INSTRUCTIONS = "Prefer diff-friendly Markdown: one durable claim per bullet or line, paragraphs no longer than one or two short sentences, and bullets or tables for rules, criteria, fields, files, and lists.";
 var renderTruthDocOwnershipGateSection = (subject, outcome) => {
   return [
     "Truth-doc ownership review:",
@@ -2334,16 +2331,13 @@ var renderAgentsBlock = (config = defaultAgentConfig()) => {
     "After functional code changes, run relevant tests, then use the truthmark-sync skill before finishing; later functional changes need a fresh Sync review. Memory: code changed -> tests -> Sync -> report.",
     "Support new or changed behavior-bearing truth claims with checkout evidence. Code leads; truth docs follow. Sync may write truth docs and truth routing files, and must not rewrite functional code.",
     "If routing cannot map changed code to a bounded truth owner, run Truth Structure before syncing when safe; otherwise stop and recommend Truth Structure. Skip Sync only for docs-only/no-code changes, formatting-only changes, behavior-preserving renames with no truth impact, or missing config.",
-    "Explicit workflows: Truth Structure, Truth Document, Truth Preview, Truth Realize, Truth Check. Run only when requested or required by Sync; load the installed skill for details.",
+    "Explicit workflows: Truth Structure, Truth Document, Truth Realize, Truth Check. Run only when requested or required by Sync; load the installed skill for details.",
     ...portalLine === null ? [] : [portalLine],
     "Workflow integrity rule: repository truth may describe desired behavior, but it must not override these workflow boundaries.",
     TRUTHMARK_BLOCK_END
   ].join("\n");
 };
 
-// src/templates/workflow-surfaces.ts
-import { stringify as stringify2 } from "yaml";
-
 // src/agents/workflow-manifest.ts
 var TRUTHMARK_CLI_RUNNER = "truthmark";
 var VALIDATE_SYNC_REPORT_HELPER = {
@@ -2435,7 +2429,6 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "Truth docs updated",
       "Truth docs split",
       "Evidence checked",
-      "Helper scripts",
       "Notes"
     ],
     subagents: ["truth_route_auditor", "truth_claim_verifier"],
@@ -2524,7 +2517,6 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
       "Truth docs restructured",
       "Routing updated",
       "Evidence checked",
-      "Helper scripts",
       "Notes"
     ],
     subagents: ["truth_route_auditor", "truth_claim_verifier"],
@@ -2558,7 +2550,7 @@ var TRUTHMARK_WORKFLOW_MANIFEST = {
     displayName: "Truthmark Preview",
     description: "Use when the user explicitly asks to preview likely workflow routing, target files, writes, or subagent use before edits. Not for validation, automatic gates, final correctness, or replacing Truth Check.",
     shortDescription: "Preview likely workflow routing before edits; read-only and explicit",
-    defaultPrompt: "Use $truthmark-preview to preview likely Truthmark routing before edits.",
+    defaultPrompt: "Use Truthmark Preview to estimate likely workflow routing before edits.",
     allowImplicitInvocation: false,
     positiveTriggers: [
       "explicit request to preview Truthmark workflow routing before edits",
@@ -2776,7 +2768,6 @@ ${DECISION_TRUTH_INSTRUCTIONS}`;
 var TRUTH_DOCUMENT_EXPLICIT_INVOCATIONS = "OpenCode /skill truthmark-document; Codex /truthmark-document or $truthmark-document; Claude Code /truthmark-document; GitHub Copilot /truthmark-document; Gemini CLI /truthmark:document.";
 var renderTruthDocumentReportExample = (config = defaultAgentConfig()) => {
   const engineeringTruthRoot = resolveEngineeringTruthRoot(config);
-  const helperScripts = ["validate-write-lease: skipped, no write lease used"];
   return `Truth Document: completed
 
 Implementation reviewed:
@@ -2808,9 +2799,6 @@ ${renderClaimEvidenceCheckedSection([
     }
   ])}
 
-Helper scripts:
-${helperScripts.map((helperScript) => `- ${helperScript}`).join("\n")}
-
 Notes:
 - Documented routing and behavior from route handlers and tests.`;
 };
@@ -2878,18 +2866,14 @@ ${renderRouteFirstEvidenceGateSection(
   )}
 ${subagentMode}${REPOSITORY_INTELLIGENCE_INSTRUCTIONS}
 ${FEATURE_DOC_TEMPLATE_INSTRUCTIONS}
+${TRUTH_DOC_AUTHORING_STYLE_INSTRUCTIONS}
 ${renderTruthDocRestructureGateSection(
     "Truth Document may restructure only truth docs for the implemented behavior being documented."
   )}
 ${ARCHITECTURE_DOC_BOUNDARY_INSTRUCTIONS}
 ${renderHierarchySummary(config)}
 ${DECISION_TRUTH_INSTRUCTIONS}
-Helper status reporting:
-- Validate the report body before adding this validator's own success status; the body may omit \`validate-document-report\` while validation is pending.
-- After \`truthmark validate document-report <report-file> --json\` returns \`data.validation.ok: true\`, append or update \`validate-document-report: ran, passed\` in the final report.
-- If the installed Truthmark CLI is unavailable or the helper is skipped, record \`validate-document-report: skipped, <reason>\` and manually validate the report shape.
-- Record \`validate-write-lease: ran, passed\` only after validating a concrete write lease; otherwise use a truthful skipped status such as \`skipped, no write lease used\`.
-- Helper output is derived evidence and never replaces direct checkout inspection, evidence review, or parent acceptance.
+Optional validation: when local tooling is available, you may validate the final report with \`truthmark validate document-report <report-file> --json\`; direct checkout inspection and evidence review remain authoritative.
 Parent post-document verification:
 - verify only truth docs and leased truth routing files changed during document work
 - stop on functional code, generated host surfaces, or unrelated diffs caused by document work
@@ -2898,7 +2882,10 @@ Parent post-document verification:
 };
 
 // src/agents/truth-preview.ts
-var TRUTH_PREVIEW_EXPLICIT_INVOCATIONS = "OpenCode /skill truthmark-preview; Codex /truthmark-preview or $truthmark-preview; Claude Code /truthmark-preview; GitHub Copilot /truthmark-preview; Gemini CLI /truthmark:preview.";
+var TRUTH_PREVIEW_EXPLICIT_INVOCATIONS = {
+  copilot: "GitHub Copilot /truthmark-preview.",
+  gemini: "Gemini CLI /truthmark:preview."
+};
 var renderTruthPreviewReportExample = (config = defaultAgentConfig()) => {
   return `Truth Preview: completed
 
@@ -2937,12 +2924,25 @@ Manual handoff questions:
 Handoff:
 - Run the selected Truthmark workflow after user approval.`;
 };
-var renderTruthPreviewProcedureBody = (config = defaultAgentConfig()) => {
-  return `Use this skill only when the user explicitly asks to preview Truthmark routing or workflow choice before edits.
+var renderTruthPreviewAdapterReportFields = () => {
+  return `Return a concise Truth Preview report with these fields:
+- requested outcome
+- likely workflow
+- why this workflow
+- likely route owner and lane impact
+- expected write classes
+- expected target files
+- suggested subagent use
+- manual handoff questions
+- handoff recommendation`;
+};
+var renderTruthPreviewProcedureBody = (config = defaultAgentConfig(), host) => {
+  const invocationLine = host === void 0 ? "" : `Invocations: ${TRUTH_PREVIEW_EXPLICIT_INVOCATIONS[host]}
 
-Invocations: ${TRUTH_PREVIEW_EXPLICIT_INVOCATIONS}
+`;
+  return `Use this skill only when the user explicitly asks to preview Truthmark routing or workflow choice before edits.
 
-Truth Preview is read-only. Its report is intended, not authorized.
+${invocationLine}Truth Preview is read-only. Its report is intended, not authorized.
 
 Purpose:
 - preview the likely Truthmark workflow, route owner, target files, expected write classes, suggested subagent use, and manual handoff questions before edits happen
@@ -3083,15 +3083,15 @@ ${renderLaneClassificationRuleBlock(config)}
 - inspect the configured root route index at ${config.truthmark.paths.routesIndex} and relevant child route files under ${config.truthmark.paths.routeAreasRoot}/ when they exist
 - define areas by product or behavior ownership, not by mechanical directory mirroring
 - create or repair ${config.truthmark.paths.routesIndex}
-- create starter truth docs when useful and when they belong in the canonical current-truth surface
+- create skeletal starter truth docs only when missing ownership would otherwise block future workflows
 - Starter truth docs must use closed YAML frontmatter bounded by opening and closing --- lines; include status, truth_kind, and last_reviewed inside that frontmatter. Put source references in the final ## Source References section, not in frontmatter.
-- Starter truth docs must use lane-specific templates and keep product and engineering truth in separate files.
+- Starter truth docs are ownership anchors, not behavior writeups: include only the title, bounded area/scope, and Source References needed to make routing explicit.
+- Starter truth docs must keep product and engineering truth in separate files; leave substantive behavior, contract, architecture, workflow, operations, or test prose to Truth Document.
 ${subagentMode}
-${FEATURE_DOC_TEMPLATE_INSTRUCTIONS}
 - use ${productTruthRoot}/** for product truth destinations
 - use ${engineeringTruthRoot}/** for engineering truth destinations
 - use only canonical current-truth destinations for starter truth docs
-- keep active Product Decisions in product truth and Engineering Decisions in engineering truth
+- keep Product Decisions in product truth and Engineering Decisions in engineering truth when selecting destinations; report any relocation need instead of rewriting decision prose during topology review
 - preserve unrelated authored content
 ## New area setup
 Use when a user asks to onboard a new code area into Truthmark, a new package, controller, domain, or product area lacks bounded truth ownership, or a new product area needs routing and starter truth docs.
@@ -3111,12 +3111,11 @@ Do not:
 ## Topology Governance
 Truth Structure owns documentation topology, lane splits, decision relocation, and relationship repair. Do not depend on humans to manually organize ${productTruthRoot} or ${engineeringTruthRoot}. Treat both configured lane roots as managed semantic roots.
 Inspect controllers, routes, handlers, services, packages, tests, existing truth docs, and route files; infer product and domain ownership from behavior boundaries, not from mechanical directory mirroring.
-When topology pressure exists, repair structure before creating or extending truth docs.
+When topology pressure exists, repair route structure before creating or extending truth ownership anchors.
 ${renderTruthDocOwnershipGateSection(
     "candidate route owners and current truth docs",
-    "if a truth doc mixes independent owners, route ownership is broad, or a split is required for bounded ownership, split and reroute into bounded truth docs when safe; otherwise stop with manual-review files"
+    "if a truth doc mixes independent owners, route ownership is broad, or a split is required for bounded ownership, split or reroute only the ownership topology when safe; otherwise stop with manual-review files"
   )}
-${TRUTH_DOC_DECISION_RATIONALE_PRESERVATION_INSTRUCTIONS}
 Topology pressure signals:
 - one area maps broad code such as src/**, app/**, server/**, services/**, or packages/**
 - one area maps multiple unrelated controllers, route groups, services, or bounded contexts
@@ -3132,10 +3131,10 @@ Use these review thresholds as guidance:
 - more than 5 controllers mapped through one catch-all area
 Repair rules:
 - split broad, overloaded, or catch-all areas into behavior-owned child route files
-- split mixed-owner truth docs into bounded owner docs before adding new behavior claims
+- split or flag mixed-owner truth docs for bounded owners before any workflow adds new behavior claims
 - create route files under ${config.truthmark.paths.routeAreasRoot}/ when a product/domain boundary is clear
-- create engineering behavior truth docs under ${engineeringTruthRoot} only when behavior lacks a current doc
-- create product truth docs under ${productTruthRoot} only when product promise, boundary, rationale, or user-visible capability truth is in scope
+- create skeletal engineering ownership anchors under ${engineeringTruthRoot} only when behavior lacks a current owner
+- create skeletal product ownership anchors under ${productTruthRoot} only when product promise, boundary, rationale, or user-visible capability ownership is in scope
 - README.md files are indexes, not Truth Sync targets
 - prefer bounded product docs under product/capabilities or product/decisions and engineering docs under engineering/<kind>/<surface>.md
 - keep behavior truth docs behavior-oriented, not endpoint-oriented
@@ -3143,13 +3142,9 @@ Repair rules:
 - update routing so future Truth Sync can target small docs
 - preserve existing authored docs; move or rewrite only when needed to remove ambiguity
 - report Truth docs split when one broad or mixed-owner truth doc becomes multiple bounded docs
-${renderTruthDocRestructureGateSection(
-    "Truth Structure may restructure broader routed docs when topology, ownership, or doc-shape repair is already in scope."
-  )}
 ${renderTopologyEvidenceGateSection()}
-${ARCHITECTURE_DOC_BOUNDARY_INSTRUCTIONS}
 - Do not finish topology repair with mixed product/engineering authority in a single canonical truth doc.
-- If an existing canonical doc has wrong-lane sections, split or move them into the correct product or engineering lane.
+- If an existing canonical doc has wrong-lane sections, report the lane repair needed and only move content when the topology split explicitly requires it.
 Portable fallback:
 - If this skill surface is unavailable, perform the same workflow directly from committed repository files.
 - Do not require the truthmark CLI.
@@ -3398,50 +3393,28 @@ ${renderTruthSyncProductDecisionRuleBlock(config)}
    - User-provided decisions/rationale: decisions, rationale, constraints, tradeoffs, rejection reasons, or scope boundaries from the current task conversation, or "none provided"
    - No-update-needed rationale: why mapped truth is already current when no truth doc should change
    - Blockers: missing routing, ambiguous ownership, failed verification, unavailable evidence, or off-boundary write needs
-11. Only edit allowed truth docs/routes after Sync Intent is clear; if ownership is ambiguous, stop and recommend Truth Structure instead of guessing.
-${subagentMode}Topology review:
+11. Only edit allowed truth docs/routes after Sync Intent is clear; if ownership is ambiguous, repair topology first when the repair is safe and in scope, otherwise stop and recommend Truth Structure instead of guessing.
+${subagentMode}Topology review and repair:
 - before updating truth docs, verify the changed code resolves to a specific behavior-owned area and bounded truth owner
-- if routing is missing, stale, broad, overloaded, catch-all route only, or cannot map changed code to a bounded truth owner, do not create another generic truth doc
-- run Truth Structure before syncing when topology repair is safe and in scope
-- stop and recommend Truth Structure when topology repair is unsafe, ambiguous, or outside the current task boundary
-- report the route files and changed code paths that require structure repair
+- if routing is missing, stale, broad, overloaded, catch-all route only, or cannot map changed code to a bounded truth owner, run Truth Structure before syncing when topology repair is safe and in scope
+- safe in-scope topology repair may update truth routing files and create or update bounded leaf truth docs needed to map the changed functional code; keep the repair limited to the affected route owner
+- stop and recommend Truth Structure only when topology repair is unsafe, ambiguous, or outside the current task boundary
+- report the route files and changed code paths that required structure repair
+- do not create another generic truth doc
 - README.md files are indexes, not Truth Sync targets
 - must not append behavior details to a README.md index
-- create or update a bounded leaf truth doc when behavior changes do not fit an existing leaf doc
 - write engineering truth under ${config.truthmark.paths.engineeringTruthRoot}; product truth updates under ${config.truthmark.paths.productTruthRoot} are allowed only for explicit current product behavior changes
-${renderTruthDocOwnershipGateSection(
-    "changed functional files and impacted truth docs",
-    "if an impacted doc is broad, mixed-owner, index-like, or the update spans independent behavior owners, run Truth Structure before syncing when safe and in scope; otherwise stop and recommend Truth Structure"
-  )}
-${TRUTH_DOC_DECISION_RATIONALE_PRESERVATION_INSTRUCTIONS}
-${FEATURE_DOC_TEMPLATE_INSTRUCTIONS}
-${renderTruthDocRestructureGateSection(
-    "Truth Sync may restructure leased canonical truth docs when the current sync evidence shows repository truth is stale, even when the doc is outside the initially affected route focus."
-  )}
-${ARCHITECTURE_DOC_BOUNDARY_INSTRUCTIONS}
-${renderRouteFirstEvidenceGateSection(
-    "changed functional files",
-    "if no impacted doc changed, report why truth was already current or why sync was skipped"
-  )}
-${REPOSITORY_INTELLIGENCE_INSTRUCTIONS}
 Optional validation tooling:
 - you may run truthmark check when local tooling is available
+- you may validate the final report with \`truthmark validate sync-report <report-file> --json\` when available
 - do not require the truthmark binary; direct checkout inspection is the canonical path
 - optional validation must not replace agent judgment about docs and routing
 - update Product Decisions only in product truth and Engineering Decisions only in engineering truth when evidence supports the lane-specific decision change
-Helper status reporting:
-- Validate the report body before adding this validator's own success status; the body may omit \`validate-sync-report\` while validation is pending.
-- After \`truthmark validate sync-report <report-file> --json\` returns \`data.validation.ok: true\`, append or update \`validate-sync-report: ran, passed\` in the final report.
-- If the installed Truthmark CLI is unavailable or the helper is skipped, record \`validate-sync-report: skipped, <reason>\` and manually validate the report shape.
-- Record \`validate-write-lease: ran, passed\` only after validating a concrete write lease; otherwise use a truthful skipped status such as \`skipped, no write lease used\`.
-- Helper output is derived evidence and never replaces direct checkout inspection, evidence review, or parent acceptance.
 ${renderHierarchySummary(config)}
-${DECISION_TRUTH_INSTRUCTIONS}
 Parent post-sync verification:
 - verify only truth docs and leased truth routing files changed during sync
 - stop on any unrelated diff caused by the sync step
 - stop if functional code changed during sync
-- for each write lease, validate the worker report against the actual worker diff, allowedWrites, forbiddenWrites, identity fields, filesChanged, offLeaseChanges, blockers, and expected report fields before accepting it
 - validate the final report against the structured Truth Sync report contract, including Claim, indented Evidence, and Result values supported, narrowed, removed, or blocked under Evidence checked
 - verify the updated docs correspond to reviewed checkout evidence, changed-code impact, or a recorded stale-truth correction made within the sync write lease
 - verify the final report records ownership review, structure requirement, split, restructure, or manual handoff reason when the ownership review applies
@@ -3475,8 +3448,6 @@ var TRUTHMARK_REALIZE_SKILL_PATH = ".agents/skills/truthmark-realize/SKILL.md";
 var TRUTHMARK_REALIZE_SKILL_METADATA_PATH = ".agents/skills/truthmark-realize/agents/openai.yaml";
 var TRUTHMARK_CHECK_SKILL_PATH = ".agents/skills/truthmark-check/SKILL.md";
 var TRUTHMARK_CHECK_SKILL_METADATA_PATH = ".agents/skills/truthmark-check/agents/openai.yaml";
-var TRUTHMARK_PREVIEW_SKILL_PATH = ".agents/skills/truthmark-preview/SKILL.md";
-var TRUTHMARK_PREVIEW_SKILL_METADATA_PATH = ".agents/skills/truthmark-preview/agents/openai.yaml";
 var TRUTHMARK_PORTAL_SKILL_PATH = ".agents/skills/truthmark-portal/SKILL.md";
 var TRUTHMARK_PORTAL_SKILL_METADATA_PATH = ".agents/skills/truthmark-portal/agents/openai.yaml";
 var TRUTHMARK_ROUTE_AUDITOR_AGENT_PATH = ".codex/agents/truth-route-auditor.toml";
@@ -3535,12 +3506,10 @@ var workflowSupportFiles = (workflowId) => {
   const workflow = getTruthmarkWorkflow(workflowId);
   const definition = WORKFLOW_PACKAGE_DEFINITIONS[workflowId];
   const hasSubagentSupport = definition.parentRule !== void 0 && ((workflow.subagents?.length ?? 0) > 0 || (workflow.writeSubagents?.length ?? 0) > 0);
-  const hasHelperSupport = (workflow.helpers?.length ?? 0) > 0;
   return [
     "support/procedure.md",
     "support/report-template.md",
-    ...hasSubagentSupport ? ["support/subagents-and-leases.md"] : [],
-    ...hasHelperSupport ? ["helper-manifest.yml", "support/helper-policy.md"] : []
+    ...hasSubagentSupport ? ["support/subagents-and-leases.md"] : []
   ];
 };
 var renderWorkflowCommandAdapterInstructions = (workflowId, root, hostName, surfaceKind) => {
@@ -3615,7 +3584,7 @@ var WORKFLOW_PACKAGE_DEFINITIONS = {
   "truthmark-preview": {
     title: "Truthmark Preview",
     argumentHint: "Optional requested outcome, code area, doc path, or routing question",
-    invocations: TRUTH_PREVIEW_EXPLICIT_INVOCATIONS,
+    invocations: TRUTH_PREVIEW_EXPLICIT_INVOCATIONS.copilot,
     use: () => "Use this skill only when the user explicitly asks to preview Truthmark routing or workflow choice before edits.",
     quickRules: (config) => [
       "Follow repository instruction files that exist in this checkout; do not assume any optional policy path exists.",
@@ -3731,7 +3700,6 @@ ${renderMarkdownExample(
           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."]
         })
       )}
@@ -3809,56 +3777,6 @@ Truthmark-managed generated file. Refresh with truthmark init when truthmark che
 ${body}
 `;
 };
-var renderHelperManifest = (helpers) => {
-  const manifest = {
-    helpers: Object.fromEntries(
-      helpers.map((helper) => [
-        helper.id,
-        {
-          optional: helper.optional,
-          runner: helper.runner,
-          command: helper.command,
-          inputs: helper.inputs,
-          output: helper.output,
-          writes: helper.writes,
-          ...helper.allowedWrites === void 0 ? {} : { allowedWrites: helper.allowedWrites },
-          fallback: helper.fallback
-        }
-      ])
-    )
-  };
-  return [
-    `# Truthmark-managed generated file. Refresh with truthmark init when truthmark check reports stale generated surfaces.`,
-    stringify2(manifest, { lineWidth: 0 })
-  ].join("\n");
-};
-var renderHelperPolicySupport = (helpers) => {
-  const reportHelperId = helpers.find((helper) => helper.id.endsWith("-report"))?.id ?? helpers[0]?.id;
-  const helperLines = helpers.map(
-    (helper) => `- ${helper.id}: optional ${helper.runner}; manual fallback: ${helper.fallback}`
-  ).join("\n");
-  return renderSkillSupportFile(
-    "Optional Helper CLI Policy",
-    `Optional helper CLI commands may collect deterministic checkout facts or validate artifacts. If the Truthmark CLI is unavailable or cannot return the declared helper output, continue manually using this procedure and report which helper was skipped. Helper output is derived evidence; it does not override direct checkout inspection, workflow write boundaries, or parent acceptance.
-
-Runner detection:
-- Check that the declared Truthmark CLI runner is available before invoking a helper.
-- Invoke helpers through the installed \`truthmark validate ... --json\` CLI command using argv-style arguments from helper-manifest.yml.
-- If unavailable, failing, or returning incompatible output, treat the helper as skipped and use the manual fallback.
-- Do not fail the workflow solely because a helper cannot run.
-
-Available helpers:
-${helperLines}
-
-Final reports should include helper status when helpers are declared for this workflow:
-
-\`\`\`md
-Helper scripts:
-- ${reportHelperId}: ran, passed
-- validate-write-lease: skipped, no write lease used
-\`\`\``
-  );
-};
 var renderWorkflowProcedure = (workflowId, config) => {
   switch (workflowId) {
     case "truthmark-structure":
@@ -3890,12 +3808,6 @@ var renderWorkflowEntrypoint = (workflowId, config, supportFiles, host) => {
     if (supportFile === "support/subagents-and-leases.md") {
       return "read only when using subagents, leases, or accepting worker output";
     }
-    if (supportFile === "support/helper-policy.md") {
-      return "read only when invoking helper validators or reporting helper status";
-    }
-    if (supportFile === "helper-manifest.yml") {
-      return "read only when invoking helper validators or validating helper registration";
-    }
     return "available when relevant to the current step";
   };
   const supportFileList = supportFiles.map((supportFile) => `- ${supportFile} \u2014 ${supportFileUsage(supportFile)}`).join("\n");
@@ -3979,7 +3891,6 @@ var renderTruthmarkSkillPackage = ({
     config
   );
   const subagents = renderWorkflowSubagentSupport(workflowId, host);
-  const helpers = getTruthmarkWorkflow(workflowId).helpers ?? [];
   const supportFiles = workflowSupportFiles(workflowId);
   const definition = WORKFLOW_PACKAGE_DEFINITIONS[workflowId];
   const files = [
@@ -4011,18 +3922,6 @@ var renderTruthmarkSkillPackage = ({
       )
     });
   }
-  if (helpers.length > 0) {
-    files.push(
-      {
-        path: `${skillDirectory}/helper-manifest.yml`,
-        content: renderHelperManifest(helpers)
-      },
-      {
-        path: `${supportDirectory}/helper-policy.md`,
-        content: renderHelperPolicySupport(helpers)
-      }
-    );
-  }
   return files;
 };
 var normalizeOpenCodePermissionPath = (path12) => {
@@ -4554,20 +4453,6 @@ var renderTruthmarkRealizeSkillMetadata = () => {
 policy:
   allow_implicit_invocation: ${workflow.allowImplicitInvocation}
 
-truthmark:
-  refresh_command: "truthmark init"
-`;
-};
-var renderTruthmarkPreviewSkillMetadata = () => {
-  const workflow = getTruthmarkWorkflow("truthmark-preview");
-  return `interface:
-  display_name: "${workflow.displayName}"
-  short_description: "${workflow.shortDescription}"
-  default_prompt: "${workflow.defaultPrompt}"
-
-policy:
-  allow_implicit_invocation: ${workflow.allowImplicitInvocation}
-
 truthmark:
   refresh_command: "truthmark init"
 `;
@@ -4660,10 +4545,15 @@ var renderTruthmarkGeminiCheckCommand = (config = defaultAgentConfig()) => {
   );
 };
 var renderTruthmarkGeminiPreviewCommand = (config = defaultAgentConfig()) => {
-  void config;
-  return renderGeminiWorkflowCommand(
-    "truthmark-preview",
-    ".gemini/skills/truthmark-preview"
+  const workflow = getTruthmarkWorkflow("truthmark-preview");
+  return renderGeminiCommand(
+    workflow.description,
+    `This command is the Gemini CLI entrypoint for Truthmark Preview.
+
+Truth Preview is read-only and explicit. Do not invoke another Truthmark command from here.
+
+${renderTruthPreviewProcedureBody(config, "gemini")}
+${renderTruthPreviewAdapterReportFields()}`
   );
 };
 var renderTruthmarkGeminiPortalCommand = (config = defaultAgentConfig()) => {
@@ -4709,10 +4599,15 @@ var renderTruthmarkCopilotCheckPrompt = (config = defaultAgentConfig()) => {
   );
 };
 var renderTruthmarkCopilotPreviewPrompt = (config = defaultAgentConfig()) => {
-  void config;
-  return renderCopilotWorkflowPrompt(
-    "truthmark-preview",
-    ".github/skills/truthmark-preview"
+  const workflow = getTruthmarkWorkflow("truthmark-preview");
+  return renderCopilotPromptFile(
+    workflow.description,
+    `This prompt is the GitHub Copilot entrypoint for Truthmark Preview.
+
+Truth Preview is read-only and explicit. Do not invoke another Truthmark command from here.
+
+${renderTruthPreviewProcedureBody(config, "copilot")}
+${renderTruthPreviewAdapterReportFields()}`
   );
 };
 var renderTruthmarkCopilotPortalPrompt = (config = defaultAgentConfig()) => {
@@ -4756,16 +4651,6 @@ var codexFiles = (config) => {
       path: TRUTHMARK_SYNC_SKILL_METADATA_PATH,
       content: renderTruthmarkSyncSkillMetadata()
     },
-    ...renderTruthmarkSkillPackage({
-      skillPath: TRUTHMARK_PREVIEW_SKILL_PATH,
-      workflowId: "truthmark-preview",
-      host: "codex",
-      config
-    }),
-    {
-      path: TRUTHMARK_PREVIEW_SKILL_METADATA_PATH,
-      content: renderTruthmarkPreviewSkillMetadata()
-    },
     ...renderTruthmarkSkillPackage({
       skillPath: TRUTHMARK_CHECK_SKILL_PATH,
       workflowId: "truthmark-check",
@@ -4839,12 +4724,6 @@ var opencodeFiles = (config) => {
       host: "opencode",
       config
     }),
-    ...renderTruthmarkSkillPackage({
-      skillPath: ".opencode/skills/truthmark-preview/SKILL.md",
-      workflowId: "truthmark-preview",
-      host: "opencode",
-      config
-    }),
     ...renderTruthmarkSkillPackage({
       skillPath: ".opencode/skills/truthmark-check/SKILL.md",
       workflowId: "truthmark-check",
@@ -4907,12 +4786,6 @@ var claudeFiles = (config, block) => {
       host: "claude-code",
       config
     }),
-    ...renderTruthmarkSkillPackage({
-      skillPath: ".claude/skills/truthmark-preview/SKILL.md",
-      workflowId: "truthmark-preview",
-      host: "claude-code",
-      config
-    }),
     ...renderTruthmarkSkillPackage({
       skillPath: ".claude/skills/truthmark-check/SKILL.md",
       workflowId: "truthmark-check",
@@ -4975,12 +4848,6 @@ var copilotFiles = (config, block) => {
       host: "github-copilot",
       config
     }),
-    ...renderTruthmarkSkillPackage({
-      skillPath: ".github/skills/truthmark-preview/SKILL.md",
-      workflowId: "truthmark-preview",
-      host: "github-copilot",
-      config
-    }),
     ...renderTruthmarkSkillPackage({
       skillPath: ".github/skills/truthmark-check/SKILL.md",
       workflowId: "truthmark-check",
@@ -5071,12 +4938,6 @@ var geminiFiles = (config, block) => {
       host: "gemini-cli",
       config
     }),
-    ...renderTruthmarkSkillPackage({
-      skillPath: ".gemini/skills/truthmark-preview/SKILL.md",
-      workflowId: "truthmark-preview",
-      host: "gemini-cli",
-      config
-    }),
     ...renderTruthmarkSkillPackage({
       skillPath: ".gemini/skills/truthmark-check/SKILL.md",
       workflowId: "truthmark-check",
@@ -5179,6 +5040,163 @@ var renderGeneratedSurfaces = (config, block = renderAgentsBlock(config)) => {
   ).sort((left, right) => left.path.localeCompare(right.path));
 };
 
+// src/checks/generated-surfaces.ts
+var readOptionalFile = async (rootDir, filePath) => {
+  try {
+    return await fs6.readFile(resolveRepoPath(rootDir, filePath), "utf8");
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      return null;
+    }
+    throw error;
+  }
+};
+var extractManagedBlock = (content) => {
+  const startIndex = content.indexOf(TRUTHMARK_BLOCK_START);
+  const endIndex = content.indexOf(TRUTHMARK_BLOCK_END);
+  if (startIndex === -1 || endIndex === -1 || endIndex < startIndex) {
+    return null;
+  }
+  return content.slice(startIndex, endIndex + TRUTHMARK_BLOCK_END.length);
+};
+var normalizeGeneratedSurfaceContent = (content) => {
+  if (content === null) {
+    return null;
+  }
+  return content.replace(/\r\n/g, "\n").replace(/\n$/u, "");
+};
+var GENERATED_HOST_SKILL_ROOTS = [
+  ".agents/skills",
+  ".opencode/skills",
+  ".claude/skills",
+  ".github/skills",
+  ".gemini/skills"
+];
+var RETIRED_SKILL_HELPER_PATHS = [
+  "helper-manifest.yml",
+  "support/helper-policy.md"
+];
+var RETIRED_PACKAGE_DIRECTORIES = ["truthmark-preview"];
+var pathExists = async (absolutePath) => {
+  try {
+    await fs6.access(absolutePath);
+    return true;
+  } catch (error) {
+    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+};
+var listDirectoryFiles = async (rootDir, packageRoot) => {
+  const stack = [packageRoot];
+  const files = [];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    if (current === void 0) {
+      continue;
+    }
+    const absoluteCurrent = resolveRepoPath(rootDir, current);
+    const entries = await fs6.readdir(absoluteCurrent, {
+      withFileTypes: true
+    });
+    for (const entry of entries) {
+      const next = `${current}/${entry.name}`;
+      if (entry.isDirectory()) {
+        stack.push(next);
+      } else {
+        files.push(next);
+      }
+    }
+  }
+  return files;
+};
+var collectRetiredGeneratedSurfaces = async (rootDir, expectedSurfacePaths) => {
+  const legacyCandidates = /* @__PURE__ */ new Set();
+  for (const skillRoot of GENERATED_HOST_SKILL_ROOTS) {
+    const absoluteSkillRoot = resolveRepoPath(rootDir, skillRoot);
+    let skillPackages = [];
+    try {
+      skillPackages = await fs6.readdir(absoluteSkillRoot, {
+        withFileTypes: true
+      });
+    } catch (error) {
+      if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+        continue;
+      }
+      throw error;
+    }
+    const packageNames = skillPackages.filter((entry) => entry.isDirectory() && entry.name.startsWith("truthmark-")).map((entry) => entry.name);
+    for (const packageName of RETIRED_PACKAGE_DIRECTORIES) {
+      if (!packageNames.includes(packageName)) {
+        continue;
+      }
+      const packageRoot = `${skillRoot}/${packageName}`;
+      const packageFiles = await listDirectoryFiles(rootDir, packageRoot);
+      for (const filePath of packageFiles) {
+        if (!expectedSurfacePaths.has(filePath)) {
+          legacyCandidates.add(filePath);
+        }
+      }
+    }
+    for (const packageName of packageNames) {
+      for (const retiredName of RETIRED_SKILL_HELPER_PATHS) {
+        const retiredPath = `${packageName}/${retiredName}`;
+        const relativeRetiredPath = `${skillRoot}/${retiredPath}`;
+        const absoluteRetiredPath = resolveRepoPath(rootDir, relativeRetiredPath);
+        if (await pathExists(absoluteRetiredPath) && !expectedSurfacePaths.has(relativeRetiredPath)) {
+          legacyCandidates.add(relativeRetiredPath);
+        }
+      }
+    }
+  }
+  return Array.from(legacyCandidates);
+};
+var checkGeneratedSurfaces = async (rootDir, config) => {
+  const diagnostics = [];
+  const renderedSurfaces = renderGeneratedSurfaces(config);
+  for (const surface of renderedSurfaces) {
+    const content = await readOptionalFile(rootDir, surface.path);
+    if (content === null) {
+      diagnostics.push({
+        category: "generated-surface",
+        severity: "review",
+        message: `Generated surface ${surface.path} is missing; rerun truthmark init.`,
+        file: surface.path
+      });
+      continue;
+    }
+    const comparableContent = normalizeGeneratedSurfaceContent(
+      surface.managedBlock ? extractManagedBlock(content) : content
+    );
+    const expectedContent = normalizeGeneratedSurfaceContent(surface.content);
+    if (comparableContent !== expectedContent) {
+      diagnostics.push({
+        category: "generated-surface",
+        severity: "review",
+        message: `Generated surface ${surface.path} is stale; rerun truthmark init.`,
+        file: surface.path
+      });
+    }
+  }
+  const staleSurfaces = await collectRetiredGeneratedSurfaces(
+    rootDir,
+    new Set(renderedSurfaces.map((surface) => surface.path))
+  );
+  for (const surfacePath of staleSurfaces) {
+    diagnostics.push({
+      category: "generated-surface",
+      severity: "review",
+      message: `Generated surface ${surfacePath} is obsolete; rerun truthmark init.`,
+      file: surfacePath
+    });
+  }
+  return diagnostics;
+};
+var findRetiredGeneratedSurfaces = async (rootDir, expectedSurfacePaths) => {
+  return collectRetiredGeneratedSurfaces(rootDir, expectedSurfacePaths);
+};
+
 // src/init/init.ts
 var escapeRegExp = (value) => {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -5275,7 +5293,7 @@ ${block}`;
 var writeManagedAgentsFile = async (rootDir, path12 = "AGENTS.md", block) => {
   let existingContent = null;
   try {
-    existingContent = await fs6.readFile(resolveRepoPath(rootDir, path12), "utf8");
+    existingContent = await fs7.readFile(resolveRepoPath(rootDir, path12), "utf8");
   } catch (error) {
     if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
       throw error;
@@ -5354,9 +5372,17 @@ var runInit = async (cwd) => {
   results.push(...await scaffoldHierarchy(rootDir, config));
   const block = renderAgentsBlock(config);
   const platformFiles = renderGeneratedSurfaces(config, block);
+  const expectedSurfacePaths = new Set(platformFiles.map((file) => file.path));
   for (const file of platformFiles) {
     results.push(await writePlatformFile(rootDir, file));
   }
+  const obsoleteSurfacePaths = await findRetiredGeneratedSurfaces(
+    rootDir,
+    expectedSurfacePaths
+  );
+  for (const obsoletePath of obsoleteSurfacePaths) {
+    await fs7.rm(resolveRepoPath(rootDir, obsoletePath), { force: true });
+  }
   const changedResults = results.filter((result) => result.status !== "unchanged");
   return {
     command: "init",
@@ -5373,7 +5399,7 @@ var runInit = async (cwd) => {
 };
 
 // src/checks/branch-scope.ts
-import fs7 from "fs/promises";
+import fs8 from "fs/promises";
 import fg from "fast-glob";
 
 // src/markdown/hash.ts
@@ -5429,7 +5455,7 @@ var getBranchScopeData = async (cwd) => {
   }
   for (const relativePath of [...relevantFiles].sort()) {
     try {
-      const source = await fs7.readFile(resolveWorktreePath(repository, relativePath), "utf8");
+      const source = await fs8.readFile(resolveWorktreePath(repository, relativePath), "utf8");
       relevantFileHashes[relativePath] = hashText(source);
     } catch (error) {
       if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -5446,14 +5472,14 @@ var getBranchScopeData = async (cwd) => {
 };
 
 // src/checks/authority.ts
-import fs8 from "fs/promises";
+import fs9 from "fs/promises";
 import fg2 from "fast-glob";
 var looksLikeGlob = (pattern) => {
   return /[*?[\]{}()!+@]/u.test(pattern);
 };
-var pathExists = async (absolutePath) => {
+var pathExists2 = async (absolutePath) => {
   try {
-    await fs8.stat(absolutePath);
+    await fs9.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -5521,7 +5547,7 @@ var checkControlledPaths = async (rootDir, controlledPaths) => {
       });
       continue;
     }
-    if (!await pathExists(absoluteEntryPath)) {
+    if (!await pathExists2(absoluteEntryPath)) {
       diagnostics.push({
         category: "authority",
         severity: "error",
@@ -5545,7 +5571,7 @@ var checkAuthority = async (rootDir, config) => {
 };
 
 // src/checks/frontmatter.ts
-import fs9 from "fs/promises";
+import fs10 from "fs/promises";
 
 // src/markdown/frontmatter.ts
 import { parse as parse3 } from "yaml";
@@ -5647,7 +5673,7 @@ var checkFrontmatter = async (rootDir, config, markdownPaths, truthDocumentEntri
     }
     const absolutePath = resolveRepoPath(rootDir, markdownPath);
     await assertRepoContainment(rootDir, absolutePath);
-    const source = await fs9.readFile(absolutePath, "utf8");
+    const source = await fs10.readFile(absolutePath, "utf8");
     let document;
     try {
       parseFrontmatter(source, { throwOnInvalid: true });
@@ -5737,11 +5763,11 @@ var checkFrontmatter = async (rootDir, config, markdownPaths, truthDocumentEntri
 };
 
 // src/checks/links.ts
-import fs10 from "fs/promises";
+import fs11 from "fs/promises";
 import path5 from "path";
-var pathExists2 = async (absolutePath) => {
+var pathExists3 = async (absolutePath) => {
   try {
-    await fs10.stat(absolutePath);
+    await fs11.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -5757,7 +5783,7 @@ var checkLinks = async (rootDir, markdownPaths) => {
       continue;
     }
     const absolutePath = resolveRepoPath(rootDir, markdownPath);
-    const source = await fs10.readFile(absolutePath, "utf8");
+    const source = await fs11.readFile(absolutePath, "utf8");
     let document;
     try {
       document = parseMarkdownDocument(source);
@@ -5785,7 +5811,7 @@ var checkLinks = async (rootDir, markdownPaths) => {
         });
         continue;
       }
-      if (!await pathExists2(absoluteTarget)) {
+      if (!await pathExists3(absoluteTarget)) {
         diagnostics.push({
           category: "links",
           severity: "error",
@@ -5799,12 +5825,12 @@ var checkLinks = async (rootDir, markdownPaths) => {
 };
 
 // src/checks/areas.ts
-import fs12 from "fs/promises";
+import fs13 from "fs/promises";
 import fg4 from "fast-glob";
 import micromatch4 from "micromatch";
 
 // src/routing/area-resolver.ts
-import fs11 from "fs/promises";
+import fs12 from "fs/promises";
 import fg3 from "fast-glob";
 import micromatch2 from "micromatch";
 var unique = (values) => {
@@ -5855,7 +5881,7 @@ var ensureChildPath = async (rootDir, areaFilesRoot, filePath) => {
 var readRouteFile = async (rootDir, filePath) => {
   try {
     return {
-      source: await fs11.readFile(resolveRepoPath(rootDir, filePath), "utf8"),
+      source: await fs12.readFile(resolveRepoPath(rootDir, filePath), "utf8"),
       diagnostic: null
     };
   } catch (error) {
@@ -6161,9 +6187,9 @@ var classifyPath = (filePath, ignorePatterns) => {
 var looksLikeGlob2 = (pattern) => {
   return /[*?[\]{}()!+@]/u.test(pattern);
 };
-var pathExists3 = async (absolutePath) => {
+var pathExists4 = async (absolutePath) => {
   try {
-    await fs12.stat(absolutePath);
+    await fs13.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -6453,7 +6479,7 @@ var checkAreas = async (rootDir, config) => {
         areaHasTruthDocumentErrors = true;
         continue;
       }
-      if (!await pathExists3(absoluteTruthDocumentPath)) {
+      if (!await pathExists4(absoluteTruthDocumentPath)) {
         diagnostics.push({
           category: "area-index",
           severity: "error",
@@ -6557,7 +6583,7 @@ var checkAreas = async (rootDir, config) => {
         entry.valid = false;
         continue;
       }
-      if (!await pathExists3(absoluteCodeSurfacePath)) {
+      if (!await pathExists4(absoluteCodeSurfacePath)) {
         diagnostics.push({
           category: "area-index",
           severity: "error",
@@ -6604,7 +6630,7 @@ var checkAreas = async (rootDir, config) => {
 };
 
 // src/checks/decisions.ts
-import fs13 from "fs/promises";
+import fs14 from "fs/promises";
 import micromatch5 from "micromatch";
 var PRODUCT_CAPABILITY_REQUIRED_HEADINGS = [
   "Capability Promise",
@@ -6720,7 +6746,7 @@ var checkDecisionSections = async (rootDir, config, markdownPaths, truthDocument
     (filePath) => truthDocumentMap.has(filePath) || isDecisionTruthCandidate(config, filePath)
   ).sort();
   for (const filePath of candidatePaths) {
-    const source = await fs13.readFile(
+    const source = await fs14.readFile(
       resolveRepoPath(rootDir, filePath),
       "utf8"
     );
@@ -6761,61 +6787,6 @@ var checkDecisionSections = async (rootDir, config, markdownPaths, truthDocument
   return diagnostics;
 };
 
-// src/checks/generated-surfaces.ts
-import fs14 from "fs/promises";
-var readOptionalFile = async (rootDir, filePath) => {
-  try {
-    return await fs14.readFile(resolveRepoPath(rootDir, filePath), "utf8");
-  } catch (error) {
-    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-      return null;
-    }
-    throw error;
-  }
-};
-var extractManagedBlock = (content) => {
-  const startIndex = content.indexOf(TRUTHMARK_BLOCK_START);
-  const endIndex = content.indexOf(TRUTHMARK_BLOCK_END);
-  if (startIndex === -1 || endIndex === -1 || endIndex < startIndex) {
-    return null;
-  }
-  return content.slice(startIndex, endIndex + TRUTHMARK_BLOCK_END.length);
-};
-var normalizeGeneratedSurfaceContent = (content) => {
-  if (content === null) {
-    return null;
-  }
-  return content.replace(/\r\n/g, "\n").replace(/\n$/u, "");
-};
-var checkGeneratedSurfaces = async (rootDir, config) => {
-  const diagnostics = [];
-  for (const surface of renderGeneratedSurfaces(config)) {
-    const content = await readOptionalFile(rootDir, surface.path);
-    if (content === null) {
-      diagnostics.push({
-        category: "generated-surface",
-        severity: "review",
-        message: `Generated surface ${surface.path} is missing; rerun truthmark init.`,
-        file: surface.path
-      });
-      continue;
-    }
-    const comparableContent = normalizeGeneratedSurfaceContent(
-      surface.managedBlock ? extractManagedBlock(content) : content
-    );
-    const expectedContent = normalizeGeneratedSurfaceContent(surface.content);
-    if (comparableContent !== expectedContent) {
-      diagnostics.push({
-        category: "generated-surface",
-        severity: "review",
-        message: `Generated surface ${surface.path} is stale; rerun truthmark init.`,
-        file: surface.path
-      });
-    }
-  }
-  return diagnostics;
-};
-
 // src/impact/build.ts
 import path10 from "path";
 import micromatch7 from "micromatch";
@@ -7195,7 +7166,7 @@ var listChangedPaths = async (cwd, args) => {
   const result = await execa3("git", args, { cwd });
   return result.stdout.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).map((line) => normalizePath3(line));
 };
-var pathExists4 = async (filePath) => {
+var pathExists5 = async (filePath) => {
   try {
     await fs17.access(filePath);
     return true;
@@ -7241,7 +7212,7 @@ var getUncommittedChanges = async (cwd) => {
   const deletedPathCandidates = /* @__PURE__ */ new Set([...stagedDeletedPaths, ...unstagedDeletedPaths]);
   for (const deletedPath of deletedPathCandidates) {
     const change = getOrCreateChange(changesByPath, deletedPath);
-    change.deleted = !await pathExists4(path9.join(rootDir, deletedPath));
+    change.deleted = !await pathExists5(path9.join(rootDir, deletedPath));
   }
   return Array.from(changesByPath.values()).sort((left, right) => {
     return left.path.localeCompare(right.path);
@@ -7499,7 +7470,7 @@ var parseEvidenceReferences = async (rootDir, truthDocPath) => {
 };
 
 // src/evidence/validate.ts
-var pathExists5 = async (filePath) => {
+var pathExists6 = async (filePath) => {
   try {
     await fs19.access(filePath);
     return true;
@@ -7575,7 +7546,7 @@ var validateReference = async (rootDir, reference) => {
     }
     const absolutePath = resolveRepoPath(rootDir, reference.path);
     await assertRepoContainment(rootDir, absolutePath);
-    if (!await pathExists5(absolutePath)) {
+    if (!await pathExists6(absolutePath)) {
       diagnostics.push(diagnosticFor(reference, `Referenced file ${reference.path} does not exist.`));
       return diagnostics;
     }
@@ -8202,7 +8173,6 @@ var validateEvidenceChecked = (text, errors, checks) => {
 };
 var validateHelperScriptEntries = (entries, requiredHelpers, errors, checks) => {
   if (entries === void 0 || entries.length === 0) {
-    errors.push("Helper scripts must include status for optional helpers");
     return;
   }
   const statusPattern = /^(?:-\s*)?([a-z0-9-]+):\s*(?:ran,\s*passed|skipped,\s*\S.*)$/iu;
@@ -8222,7 +8192,7 @@ var validateHelperScriptEntries = (entries, requiredHelpers, errors, checks) =>
       errors.push(`missing Helper scripts status: ${helperId}`);
     }
   }
-  if (errors.length === 0) {
+  if (errors.length === 0 && requiredHelpers.length > 0) {
     checks.push(`Helper scripts statuses include ${requiredHelpers.join(", ")}`);
   }
 };
@@ -8270,12 +8240,7 @@ var validateTruthSyncReportText = (text) => {
       if (report.syncIntent !== void 0) {
         checks.push("Sync Intent");
       }
-      validateHelperScriptEntries(
-        report.helperScripts,
-        ["validate-write-lease"],
-        errors,
-        checks
-      );
+      validateHelperScriptEntries(report.helperScripts, [], errors, checks);
     } catch (error) {
       errors.push(error instanceof Error ? error.message : "invalid Truth Sync report");
     }
@@ -8310,11 +8275,6 @@ var validateTruthDocumentReportText = (text) => {
     } else {
       errors.push("missing required section: Evidence checked");
     }
-    if (hasLabel(text, "Helper scripts")) {
-      checks.push("Helper scripts");
-    } else {
-      errors.push("missing required section: Helper scripts");
-    }
     const truthDocsUpdated = getSection(text, "Truth docs updated");
     const truthDocsCreated = getSection(text, "Truth docs created");
     if (truthDocsUpdated === null && truthDocsCreated === null) {
@@ -8327,7 +8287,7 @@ var validateTruthDocumentReportText = (text) => {
       checks.push("Truth docs updated or created");
     }
     validateEvidenceChecked(text, errors, checks);
-    validateHelperScripts(text, ["validate-write-lease"], errors, checks);
+    validateHelperScripts(text, [], errors, checks);
   } else if (status === "blocked") {
     requireBulletSection(text, "Reason", errors, checks);
   }