@c4a/context-cli 0.5.29-beta.16 → 0.5.29-beta.17

package/cli.js

@@ -19673,15 +19673,40 @@ function isEvidenceEchoDetail(detail, basisTexts = []) {
     return true;
   return stripped.label !== undefined && PREFIX_ONLY_ECHO_LABEL_RE.test(stripped.label);
 }
+function fencedBlocksIn(value) {
+  return [...value.matchAll(FENCED_DETAIL_BLOCK_RE)].map((match) => normalizeMarkdown(match[0]).trim()).filter((block) => block.length > 0);
+}
+function basisText(value) {
+  return typeof value === "string" ? value : value.join(`
+`);
+}
+function hasCitedFencedDetail(detail, basisTexts) {
+  const cited = normalizeMarkdown(basisText(basisTexts)).trim();
+  if (cited.length === 0)
+    return false;
+  return fencedBlocksIn(detail).some((block) => cited.includes(block));
+}
+function isOnlyCitedFencedDetail(detail, basisTexts) {
+  const normalizedDetail = normalizeMarkdown(detail).trim();
+  if (normalizedDetail.length === 0)
+    return false;
+  const cited = normalizeMarkdown(basisText(basisTexts)).trim();
+  const blocks = fencedBlocksIn(normalizedDetail);
+  if (cited.length === 0 || blocks.length === 0 || !blocks.every((block) => cited.includes(block)))
+    return false;
+  return normalizedDetail.replace(FENCED_DETAIL_BLOCK_RE, "").trim().length === 0;
+}
 function renderableSectionDetail(detail) {
   if (detail === undefined || detail.trim().length === 0)
     return;
   return isEvidenceEchoDetail(detail) ? undefined : detail;
 }
-var EVIDENCE_ECHO_PREFIX_RE, PREFIX_ONLY_ECHO_LABEL_RE;
+var EVIDENCE_ECHO_PREFIX_RE, PREFIX_ONLY_ECHO_LABEL_RE, FENCED_DETAIL_BLOCK_RE;
 var init_sectionDetail = __esm(() => {
+  init_normalize();
   EVIDENCE_ECHO_PREFIX_RE = /^\s*(原文|原始文本|原始引用|引用|证据|source|raw|quote|original)\s*[:：]\s*/iu;
   PREFIX_ONLY_ECHO_LABEL_RE = /^(?:原文|原始文本|原始引用|引用|证据)$/iu;
+  FENCED_DETAIL_BLOCK_RE = /```[^\n`]*\n[\s\S]*?```|~~~[^\n~]*\n[\s\S]*?~~~/gu;
 });
 
 // src/lib/nodeRenderer.ts
@@ -28706,13 +28731,6 @@ function textIsUrlReferenceOnly(content, citedText) {
   const requiredMatches = Math.max(1, Math.ceil(lexical.contentTermCount * 0.5));
   return lexical.matchedTermCount >= requiredMatches && lexical.missingTerms.length <= 2;
 }
-function fencedBlocksIn(text) {
-  return [...text.matchAll(FENCED_CODE_RE2)].map((match) => normalizeMarkdown(match[0]).trim()).filter((block) => block.length > 0);
-}
-function hasCitedFencedDetail(detail, citedText) {
-  const cited = normalizeMarkdown(citedText).trim();
-  return fencedBlocksIn(detail).some((block) => cited.includes(block));
-}
 function urlSupportFor(content, citedText) {
   const contentUrls = evidenceUrlsIn(content);
   const citedUrls = new Set(evidenceUrlsIn(citedText));
@@ -28806,11 +28824,13 @@ function supportLexicalOverlap(content, citedText) {
 function hardTermPresent(term, citedText, citedHardTerms) {
   if (citedHardTerms.has(term) || normalizedToken(citedText).includes(term))
     return true;
-  const slashParts = term.split("/").map(normalizedToken).filter((part) => part.length > 0);
-  if (slashParts.length <= 1)
-    return false;
   const normalizedCited = normalizedToken(citedText);
-  return slashParts.every((part) => citedHardTerms.has(part) || normalizedCited.includes(part));
+  const slashParts = term.split("/").map(normalizedToken).filter((part) => part.length > 0);
+  if (slashParts.length > 1) {
+    return slashParts.every((part) => citedHardTerms.has(part) || normalizedCited.includes(part));
+  }
+  const hyphenParts = term.includes("-") && !/[0-9._/:#]/u.test(term) ? term.split("-").map(normalizedToken).filter((part) => part.length > 1) : [];
+  return hyphenParts.length > 1 && hyphenParts.every((part) => citedHardTerms.has(part) || normalizedCited.includes(part));
 }
 function thresholdsForKind(kind) {
   return kind === "spec" || kind === "comparison" || kind === "decision" ? { supported: 0.5, weak: 0.3 } : DEFAULT_THRESHOLDS;
@@ -28872,8 +28892,7 @@ function sourceTextSupportDiagnostic(content, citedText, thresholds = DEFAULT_TH
   const requiredMatches = Math.max(1, Math.ceil(contentTermCount * thresholds.supported));
   const overlapRatio = matchedTermCount / contentTermCount;
   const shortText = contentTermCount <= 10;
-  const hasHardFacts = contentHardTerms.length > 0;
-  const baseVerdict = missingHardTerms.length > 0 ? "unsupported" : overlapRatio >= thresholds.supported || shortText && lexical.missingTerms.length <= 2 ? "supported" : overlapRatio >= thresholds.weak || shortText && lexical.missingTerms.length <= 4 ? "weak" : hasHardFacts && matchedTermCount > 0 ? "weak" : "unsupported";
+  const baseVerdict = missingHardTerms.length > 0 ? "unsupported" : overlapRatio >= thresholds.supported || shortText && lexical.missingTerms.length <= 2 ? "supported" : overlapRatio >= thresholds.weak || shortText && lexical.missingTerms.length <= 4 ? "weak" : matchedTermCount > 0 ? "weak" : "unsupported";
   const urlAwareVerdict = urlSupport.contentUrls.length > 0 && urlSupport.missingUrls.length === 0 && missingHardTerms.length === 0 ? urlSupport.referenceOnly && (baseVerdict === "weak" || baseVerdict === "unsupported") ? "supported" : baseVerdict === "unsupported" ? "weak" : baseVerdict : baseVerdict;
   const verdict = missingPlaceholderTerms.length > 0 && urlAwareVerdict === "supported" ? "weak" : urlAwareVerdict;
   return {
@@ -29067,13 +29086,14 @@ function weakSourceSupportGuidance(action, verdict) {
   if (verdict !== "weak")
     return "";
   if (action === "keep_separate") {
-    return " Key facts match, but support is weak; ask the user to confirm the summary/compression during review, then apply the final keep_separate decision marked decided_by: user.";
+    return " Key facts match, but support is weak; ask the user to confirm the summary/compression during review, then apply the final keep_separate decision marked decided_by: user. Auto mode or general permission to continue is not confirmation.";
   }
   return " Key facts match, but this action rewrites or reanchors existing knowledge and requires direct support; choose source_ref/source_refs from the prepared evidence, split the claim, or ask the user before choosing a different final action.";
 }
-var DEFAULT_THRESHOLDS, CJK_ONLY_RE, CJK_CHAR_RE, URL_RE2, FENCED_CODE_RE2, TRAILING_URL_PUNCTUATION_RE, TRACKING_QUERY_PARAM_RE, EN_URL_REFERENCE_LABEL_RE, CJK_URL_REFERENCE_LABEL_RE, CONSTRAINT_PATTERNS, PLACEHOLDER_ANCHOR_PARTS;
+var DEFAULT_THRESHOLDS, CJK_ONLY_RE, CJK_CHAR_RE, URL_RE2, TRAILING_URL_PUNCTUATION_RE, TRACKING_QUERY_PARAM_RE, EN_URL_REFERENCE_LABEL_RE, CJK_URL_REFERENCE_LABEL_RE, CONSTRAINT_PATTERNS, PLACEHOLDER_ANCHOR_PARTS;
 var init_sourceSupport = __esm(() => {
   init_normalize();
+  init_sectionDetail();
   init_sourceRef();
   init_ref();
   init_rawBlocks();
@@ -29082,7 +29102,6 @@ var init_sourceSupport = __esm(() => {
   CJK_ONLY_RE = /^[\u4e00-\u9fff]+$/u;
   CJK_CHAR_RE = /[\u4e00-\u9fff]/gu;
   URL_RE2 = /https?:\/\/[^\s)\]}>"'）】》」』，。；：！？]+/giu;
-  FENCED_CODE_RE2 = /```[^\n`]*\n[\s\S]*?```/gu;
   TRAILING_URL_PUNCTUATION_RE = /[.,;:!?)\]\}>"'，。；：！？）】》」』]+$/u;
   TRACKING_QUERY_PARAM_RE = /^(?:utm_|fbclid$|gclid$|mc_cid$|mc_eid$)/iu;
   EN_URL_REFERENCE_LABEL_RE = /\b(?:url|urls|link|links|doc|docs|document|documents|documentation|reference|references|page|pages|guide|guides|entry|entries|website|official|source|sources)\b/giu;
@@ -30012,6 +30031,33 @@ function workflowPayloadReceipt(record, extraOrOptions = []) {
     next_command: options.nextCommand ?? showCommand
   };
 }
+function stalePayloadAgentHints(input) {
+  if (input.payload === "align-coarse-read") {
+    const ledgerDigest = input.workflowInputDigests?.["align-candidate-ledger"];
+    const ledgerCommand = ledgerDigest === undefined ? `context workflow show --payload align-candidate-ledger --scope ${shellQuote(input.resolvedScopeId)} --view ledger --unwrap --format json` : [
+      "context workflow show --payload align-candidate-ledger",
+      `--scope ${shellQuote(input.resolvedScopeId)}`,
+      `--digest ${shellQuote(ledgerDigest)}`,
+      "--view ledger",
+      "--unwrap",
+      "--format json"
+    ].join(" ");
+    return [{
+      code: "workflow-input-digest-stale",
+      severity: "error",
+      message: "align-coarse-read is a latest checkpoint; earlier per-source reading notes are stored in align-candidate-ledger.source_readings.",
+      next_action: "Read the align-candidate-ledger ledger view, optionally adding --source <source_id> to inspect a specific source reading.",
+      command: ledgerCommand
+    }];
+  }
+  return [{
+    code: "workflow-input-digest-stale",
+    severity: "error",
+    message: "The submitted payload digest does not match the current workflow payload.",
+    next_action: "Run `context workflow show --payload <name>` again and retry with the returned digest.",
+    command: "context workflow show --payload <name>"
+  }];
+}
 async function writeWorkflowPayloadWithDigest(input) {
   const path8 = workflowPayloadPath(input);
   const body2 = encodePayload(input.value, input.format);
@@ -30059,13 +30105,7 @@ async function readWorkflowPayloadByDigest(input) {
       workflow_id: input.workflowId,
       scope_id: scopeId,
       payload: input.payload,
-      agent_hints: [{
-        code: "workflow-input-digest-stale",
-        severity: "error",
-        message: "The submitted payload digest does not match the current workflow payload.",
-        next_action: "Run `context workflow show --payload <name>` again and retry with the returned digest.",
-        command: "context workflow show --payload <name>"
-      }]
+      agent_hints: stalePayloadAgentHints({ ...input, resolvedScopeId: scopeId })
     });
   }
   return {
@@ -32047,8 +32087,11 @@ async function assertNoUnresolvedHighSignalCoverage(ctxDir) {
       code: "coverage-high-signal-unresolved",
       severity: "error",
       message: `${unresolved.length} high-signal coverage candidate(s) must be disposed before close.`,
-      next_action: "Read the node-scoped coverage-candidates payload, submit a coverage disposition patch, then rerun close.",
-      command: `context workflow show --payload coverage-candidates --scope ${nodeRunIdForSlug(unresolved[0].node_slug)} --view coverage`
+      next_action: "Read the node-scoped coverage-candidates payload. If the remaining candidates are intentionally excluded for this node, run --coverage-skip-unresolved with an audit reason; otherwise submit a targeted disposition patch.",
+      command: `context workflow show --payload coverage-candidates --scope ${nodeRunIdForSlug(unresolved[0].node_slug)} --view coverage`,
+      diagnostics: {
+        bulk_skip_command: `context compile --coverage-skip-unresolved --coverage-disposition-node ${unresolved[0].node_slug} --payload-digest <digest> --reason "<reason>"`
+      }
     }]
   });
 }
@@ -35202,7 +35245,7 @@ var init_agentHintRegistry = __esm(() => {
     "verify-section-issues-run-compile",
     "verify-source-coverage-review",
     "verify-structural-issues-run-align",
-    "weak-source-support-needs-confirmation",
+    "weak-source-support-warning",
     "workflow-abandon-id-mismatch",
     "workflow-active-node-run-rejected",
     "workflow-aggregate-summary",
@@ -35220,6 +35263,7 @@ var init_agentHintRegistry = __esm(() => {
     "workflow-input-digest-stale",
     "workflow-input-digests-empty",
     "workflow-ledger-summary",
+    "workflow-ledger-source-filter",
     "workflow-ownership-by-node-summary",
     "workflow-payload-scope-ambiguous",
     "workflow-payload-view-unsupported",
@@ -35271,7 +35315,7 @@ var init_agentHintRegistry = __esm(() => {
       severity: "warning",
       description: "High-signal coverage candidates remain unresolved before close.",
       trigger: "A compile context/apply result sees unresolved high-signal coverage candidates for the current node.",
-      command: "context workflow show --payload coverage-candidates"
+      command: 'context compile --coverage-skip-unresolved --coverage-disposition-node <slug> --payload-digest <digest> --reason "<reason>"'
     },
     {
       code: "review-safe-defaults-partial",
@@ -35441,8 +35485,8 @@ function excerptAround(value, index, radius = 80) {
   const suffix = end < value.length ? "..." : "";
   return `${prefix}${value.slice(start2, end)}${suffix}`;
 }
-function normalizedDivergence(basisText, draftText) {
-  const basis = normalizeEvidenceText(basisText);
+function normalizedDivergence(basisText2, draftText) {
+  const basis = normalizeEvidenceText(basisText2);
   const draft = normalizeEvidenceText(draftText);
   const max = Math.min(basis.length, draft.length);
   let offset = 0;
@@ -35462,8 +35506,8 @@ function normalizedExtractSegments(value) {
 function normalizeSegmentSearchText(value) {
   return normalizeEvidenceText(value).replace(/[.,;:!?，。；：！？]+/gu, " ").replace(/\s+/gu, " ").trim();
 }
-function extractModeHint(field, basisText, draftText) {
-  const basis = normalizeSegmentSearchText(basisText);
+function extractModeHint(field, basisText2, draftText) {
+  const basis = normalizeSegmentSearchText(basisText2);
   const draftSegments = normalizedExtractSegments(draftText);
   const segments = draftSegments.map((segment, index) => ({
     detail_order: index,
@@ -35714,7 +35758,7 @@ async function resolveBasisSpans(ctxDir, spans, slug, context, label) {
 function assertExtractContent(action, slug, context, label, resolvedBasisSpans, state) {
   if (action.content_mode !== "extract")
     return;
-  const basisText = resolvedBasisSpans.map((span) => span.text).join(`
+  const basisText2 = resolvedBasisSpans.map((span) => span.text).join(`
 `);
   for (const [field, value] of [
     ["content", action.content],
@@ -35722,16 +35766,16 @@ function assertExtractContent(action, slug, context, label, resolvedBasisSpans,
   ]) {
     if (typeof value !== "string" || value.trim().length === 0)
       continue;
-    const normalizedMatch = normalizedIncludes(basisText, value);
-    const exactMatch = basisText.includes(value);
+    const normalizedMatch = normalizedIncludes(basisText2, value);
+    const exactMatch = basisText2.includes(value);
     if (!normalizedMatch) {
-      const modeHint = extractModeHint(field, basisText, value);
+      const modeHint = extractModeHint(field, basisText2, value);
       throw draftError(slug, context, `extract ${field} must be a normalized substring of the cited source text`, {
         path: `${label}.${field}`,
         reasonCode: `extract-${field}-not-in-basis`,
         diffHint: modeHint !== null ? String(modeHint.next_action) : `${field} must be copied from the cited source text as one contiguous normalized substring when content_mode=extract. Use the diagnostics.divergence excerpts to fix the first mismatch, or switch to minimal_paraphrase when you intentionally rewrite or reorder text.`,
         diagnostics: {
-          divergence: normalizedDivergence(basisText, value),
+          divergence: normalizedDivergence(basisText2, value),
           ...modeHint !== null ? { extract_mode_hint: modeHint } : {}
         }
       });
@@ -35753,6 +35797,9 @@ function assertNonEchoDetail(action, slug, context, label, resolvedBasisSpans) {
   const basisTexts = resolvedBasisSpans.map((span) => span.text);
   if (!isEvidenceEchoDetail(action.detail, basisTexts))
     return;
+  const sectionKind = "kind" in action ? action.kind : context.existing?.sections.find((section) => section.id === action.target_section_id)?.kind;
+  if (sectionKind === "example" && isOnlyCitedFencedDetail(action.detail, basisTexts))
+    return;
   throw draftError(slug, context, `${label}.detail must not echo raw cited evidence`, {
     path: `${label}.detail`,
     reasonCode: "detail-evidence-echo",
@@ -36163,30 +36210,141 @@ async function archiveOutputArtifacts(options) {
 }
 var init_outputArchive = () => {};
 
-// src/workflow/compileClose.ts
+// src/workflow/compileCloseFinalizedNodes.ts
 import { existsSync as existsSync43 } from "node:fs";
-import { readFile as readFile51, readdir as readdir19, rm as rm13 } from "node:fs/promises";
 import { join as join52 } from "node:path";
+function finalizedContainerChildren(nodes, parent) {
+  if (parent.type !== "domain")
+    return [];
+  return nodes.filter((node2) => node2.contains_parent === parent.slug).sort((left, right) => left.slug.localeCompare(right.slug));
+}
+function finalizedNodePath(ctxDir, node2) {
+  return join52(ctxDir, "knowledge", node2.type, `${node2.slug}.md`);
+}
+function isExplicitNoWriteNode(node2) {
+  return node2.planned_sections !== undefined && node2.planned_sections.length === 0;
+}
+function hasFinalizedGraphLink(ownership, node2) {
+  if (typeof node2.contains_parent === "string" && node2.contains_parent.length > 0)
+    return true;
+  if ((ownership.nodes ?? []).some((candidate) => candidate.contains_parent === node2.slug))
+    return true;
+  return (ownership.edges ?? []).some((edge2) => edge2.from === node2.slug || edge2.to === node2.slug);
+}
+function hasNoWritePlaceholderSupport(ownership, node2) {
+  return (node2.context_sources?.length ?? 0) > 0 || hasFinalizedGraphLink(ownership, node2);
+}
+async function ensureFinalizedContainerDomains(ctxDir, now) {
+  const ownership = await readCurrentSourceOwnership(ctxDir);
+  const nodes = ownership?.nodes ?? [];
+  let created = 0;
+  for (const node2 of nodes) {
+    const children = finalizedContainerChildren(nodes, node2);
+    if (children.length === 0)
+      continue;
+    if (existsSync43(finalizedNodePath(ctxDir, node2)))
+      continue;
+    await mdriveNodeCreate({
+      ctxDir,
+      input: {
+        node: {
+          id: node2.slug,
+          title: node2.title,
+          type: node2.type,
+          tags: node2.tags,
+          sources: [...node2.sources],
+          updated: now.toISOString().slice(0, 10),
+          ...node2.context_sources !== undefined ? { context_sources: [...node2.context_sources] } : {},
+          ...node2.summary !== undefined ? { summary: node2.summary } : {},
+          ...node2.domain_gate !== undefined ? { domain_gate: node2.domain_gate } : {}
+        },
+        body: "",
+        sections: [],
+        containsList: children.map((child) => ({
+          slug: child.slug,
+          title: child.title,
+          href: `../${child.type}/${child.slug}.md`
+        })),
+        children: []
+      }
+    });
+    created += 1;
+  }
+  return created;
+}
+async function ensureFinalizedNoWritePlaceholders(ctxDir, now) {
+  const ownership = await readCurrentSourceOwnership(ctxDir);
+  if (!ownership)
+    return 0;
+  const nodes = ownership.nodes ?? [];
+  let created = 0;
+  for (const node2 of nodes) {
+    if (!isExplicitNoWriteNode(node2))
+      continue;
+    if (node2.sources.length > 0)
+      continue;
+    if (!hasNoWritePlaceholderSupport(ownership, node2))
+      continue;
+    if (existsSync43(finalizedNodePath(ctxDir, node2)))
+      continue;
+    const children = finalizedContainerChildren(nodes, node2);
+    await mdriveNodeCreate({
+      ctxDir,
+      input: {
+        node: {
+          id: node2.slug,
+          title: node2.title,
+          type: node2.type,
+          tags: [...node2.tags],
+          sources: [],
+          updated: now.toISOString().slice(0, 10),
+          ...node2.context_sources !== undefined ? { context_sources: [...node2.context_sources] } : {},
+          ...node2.summary !== undefined ? { summary: node2.summary } : {},
+          ...node2.language !== undefined ? { language: node2.language } : {}
+        },
+        body: "",
+        sections: [],
+        containsList: children.map((child) => ({
+          slug: child.slug,
+          title: child.title,
+          href: `../${child.type}/${child.slug}.md`
+        })),
+        children: []
+      }
+    });
+    created += 1;
+  }
+  return created;
+}
+var init_compileCloseFinalizedNodes = __esm(() => {
+  init_node2();
+  init_sourceOwnership();
+});
+
+// src/workflow/compileClose.ts
+import { existsSync as existsSync44 } from "node:fs";
+import { readFile as readFile51, readdir as readdir19, rm as rm13 } from "node:fs/promises";
+import { join as join53 } from "node:path";
 function knowledgePath(ctxDir, name) {
-  return join52(ctxDir, "knowledge", name);
+  return join53(ctxDir, "knowledge", name);
 }
 async function snapshotFile(path8) {
-  return existsSync43(path8) ? { path: path8, content: await readFile51(path8, "utf8") } : { path: path8 };
+  return existsSync44(path8) ? { path: path8, content: await readFile51(path8, "utf8") } : { path: path8 };
 }
 async function snapshotCompileCloseFiles(ctxDir) {
   const paths = new Set([
     knowledgePath(ctxDir, "_index.md"),
     knowledgePath(ctxDir, "changelog.md"),
-    join52(ctxDir, "knowledge", "_edges.yaml")
+    join53(ctxDir, "knowledge", "_edges.yaml")
   ]);
   for (const type of NODE_TYPES) {
-    const dir = join52(ctxDir, "knowledge", type);
-    if (!existsSync43(dir))
+    const dir = join53(ctxDir, "knowledge", type);
+    if (!existsSync44(dir))
       continue;
     const entries = await readdir19(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (entry.isFile() && entry.name.endsWith(".md")) {
-        paths.add(join52(dir, entry.name));
+        paths.add(join53(dir, entry.name));
       }
     }
   }
@@ -36205,7 +36363,7 @@ async function restoreCompileCloseSnapshot(snapshot) {
 }
 async function readLastCompileAt2(ctxDir) {
   const changelog = knowledgePath(ctxDir, "changelog.md");
-  if (!existsSync43(changelog))
+  if (!existsSync44(changelog))
     return null;
   const lines = (await readFile51(changelog, "utf8")).split(`
 `).filter((line) => line.includes("[compile]"));
@@ -36242,7 +36400,7 @@ async function compileLedgerAppliedNodesAfter(ctxDir, timestamp) {
 }
 async function compileDraftScratchEntries(ctxDir) {
   const outputDir = workflowOutputDir(ctxDir, "compile");
-  if (!existsSync43(outputDir))
+  if (!existsSync44(outputDir))
     return [];
   const entries = await readdir19(outputDir, { withFileTypes: true });
   const out2 = [];
@@ -36251,7 +36409,7 @@ async function compileDraftScratchEntries(ctxDir) {
       continue;
     const match = /^compile\.(.+)\.draft\.(?:json|ya?ml)$/u.exec(entry.name);
     if (match?.[1])
-      out2.push({ slug: match[1], path: join52(outputDir, entry.name) });
+      out2.push({ slug: match[1], path: join53(outputDir, entry.name) });
   }
   return out2;
 }
@@ -36331,54 +36489,11 @@ async function assertCompileCloseVerifyOk(ctxDir, allowedActiveEmptySlugs = new
     });
   }
 }
-function finalizedContainerChildren(nodes, parent) {
-  if (parent.type !== "domain")
-    return [];
-  return nodes.filter((node2) => node2.contains_parent === parent.slug).sort((left, right) => left.slug.localeCompare(right.slug));
-}
-async function ensureFinalizedContainerDomains(ctxDir, now) {
-  const ownership = await readCurrentSourceOwnership(ctxDir);
-  const nodes = ownership?.nodes ?? [];
-  let created = 0;
-  for (const node2 of nodes) {
-    const children = finalizedContainerChildren(nodes, node2);
-    if (children.length === 0)
-      continue;
-    if (existsSync43(join52(ctxDir, "knowledge", "domain", `${node2.slug}.md`)))
-      continue;
-    await mdriveNodeCreate({
-      ctxDir,
-      input: {
-        node: {
-          id: node2.slug,
-          title: node2.title,
-          type: node2.type,
-          tags: node2.tags,
-          sources: [...node2.sources],
-          updated: now.toISOString().slice(0, 10),
-          ...node2.context_sources !== undefined ? { context_sources: [...node2.context_sources] } : {},
-          ...node2.summary !== undefined ? { summary: node2.summary } : {},
-          ...node2.domain_gate !== undefined ? { domain_gate: node2.domain_gate } : {}
-        },
-        body: "",
-        sections: [],
-        containsList: children.map((child) => ({
-          slug: child.slug,
-          title: child.title,
-          href: `../${child.type}/${child.slug}.md`
-        })),
-        children: []
-      }
-    });
-    created += 1;
-  }
-  return created;
-}
 async function assertFinalizedKnowledgeNodesMaterialized(ctxDir) {
   const ownership = await readCurrentSourceOwnership(ctxDir);
   if (!ownership)
     return;
-  const missing = (ownership.nodes ?? []).filter((node2) => !existsSync43(join52(ctxDir, "knowledge", node2.type, `${node2.slug}.md`)));
+  const missing = (ownership.nodes ?? []).filter((node2) => !existsSync44(finalizedNodePath(ctxDir, node2)));
   if (missing.length === 0)
     return;
   const activeSlugs = finalizedSlugSet(ownership);
@@ -36522,8 +36637,8 @@ async function compileClose(options) {
   }
 }
 async function compileCloseInner(options) {
-  const rebuiltIndex = !existsSync43(knowledgePath(options.ctxDir, "_index.md"));
-  const rebuiltChangelog = !existsSync43(knowledgePath(options.ctxDir, "changelog.md"));
+  const rebuiltIndex = !existsSync44(knowledgePath(options.ctxDir, "_index.md"));
+  const rebuiltChangelog = !existsSync44(knowledgePath(options.ctxDir, "changelog.md"));
   const now = options.now ?? new Date;
   const sourcesFile = await loadSources(options.ctxDir);
   const workspaceRoot = workspaceRootFromCtxDir(options.ctxDir);
@@ -36551,6 +36666,7 @@ async function compileCloseInner(options) {
   const coverageStatus = await readCoverageWorkspaceStatus(options.ctxDir);
   const retractedNodes = await retractRemovedFinalizedNodes(options.ctxDir);
   const createdContainerDomains = await ensureFinalizedContainerDomains(options.ctxDir, now);
+  await ensureFinalizedNoWritePlaceholders(options.ctxDir, now);
   await assertFinalizedKnowledgeNodesMaterialized(options.ctxDir);
   await projectFinalizedGraph(options.ctxDir);
   const stats = await mdriveWorkspaceStats({ ctxDir: options.ctxDir });
@@ -36655,21 +36771,21 @@ function coverageDebtItems(status) {
   }));
 }
 async function readWorkflowPayloadFiles(ctxDir, payloadBaseName) {
-  const root = join52(ctxDir, "output", "workflows");
-  if (!existsSync43(root))
+  const root = join53(ctxDir, "output", "workflows");
+  if (!existsSync44(root))
     return [];
   const out2 = [];
   for (const workflowEntry of await readdir19(root, { withFileTypes: true })) {
     if (!workflowEntry.isDirectory())
       continue;
-    const workflowDir = join52(root, workflowEntry.name);
+    const workflowDir = join53(root, workflowEntry.name);
     for (const scopeEntry of await readdir19(workflowDir, { withFileTypes: true }).catch(() => [])) {
       if (!scopeEntry.isDirectory())
         continue;
-      const scopeDir = join52(workflowDir, scopeEntry.name);
+      const scopeDir = join53(workflowDir, scopeEntry.name);
       for (const format of ["json", "yaml"]) {
-        const path8 = join52(scopeDir, `${payloadBaseName}.${format}`);
-        if (!existsSync43(path8))
+        const path8 = join53(scopeDir, `${payloadBaseName}.${format}`);
+        if (!existsSync44(path8))
           continue;
         const body2 = await readFile51(path8, "utf8");
         out2.push(format === "json" ? JSON.parse(body2) : import_yaml27.default.parse(body2));
@@ -36781,6 +36897,7 @@ var init_compileClose = __esm(() => {
   init_workflowPayloadStore();
   init_edge2();
   init_graphEdges();
+  init_compileCloseFinalizedNodes();
   import_yaml27 = __toESM(require_dist(), 1);
 });
 
@@ -37643,9 +37760,9 @@ var exports_prepareCompile = {};
 __export(exports_prepareCompile, {
   prepareCompileReconcileContext: () => prepareCompileReconcileContext
 });
-import { existsSync as existsSync44 } from "node:fs";
+import { existsSync as existsSync45 } from "node:fs";
 import { readdir as readdir20, readFile as readFile52 } from "node:fs/promises";
-import { join as join53 } from "node:path";
+import { join as join54 } from "node:path";
 function targetSectionSourceRef(node2, sectionId) {
   if (!sectionId)
     return;
@@ -37943,7 +38060,7 @@ function isSafeRelativePath(path8) {
   return path8.trim().length > 0 && !path8.startsWith("/") && !path8.split(/[\\/]+/u).includes("..");
 }
 async function readDropArchiveManifest2(path8) {
-  if (!existsSync44(path8))
+  if (!existsSync45(path8))
     return null;
   try {
     const parsed = import_yaml28.default.parse(await readFile52(path8, "utf8"));
@@ -37988,27 +38105,27 @@ async function restoredArchiveCandidatesForNode(ctxDir, targetNode) {
   const restoredSourceIds = new Set(sourcesFile.sources.filter((source2) => source2.status === "active" && typeof source2.restored_at === "string").map((source2) => source2.id));
   if (restoredSourceIds.size === 0)
     return [];
-  const sourcesRoot = join53(ctxDir, "archive", "sources");
-  if (!existsSync44(sourcesRoot))
+  const sourcesRoot = join54(ctxDir, "archive", "sources");
+  if (!existsSync45(sourcesRoot))
     return [];
   const out2 = [];
   for (const sourceDir of await readdir20(sourcesRoot, { withFileTypes: true })) {
     if (!sourceDir.isDirectory())
       continue;
-    const sourceRoot = join53(sourcesRoot, sourceDir.name);
+    const sourceRoot = join54(sourcesRoot, sourceDir.name);
     for (const archiveDir of await readdir20(sourceRoot, { withFileTypes: true })) {
       if (!archiveDir.isDirectory())
         continue;
       const archivePath = `archive/sources/${sourceDir.name}/${archiveDir.name}`;
-      const manifest = await readDropArchiveManifest2(join53(ctxDir, archivePath, "manifest.yaml"));
+      const manifest = await readDropArchiveManifest2(join54(ctxDir, archivePath, "manifest.yaml"));
       if (!manifest || !restoredSourceIds.has(manifest.source_id))
         continue;
       const knowledgeBefore = Array.isArray(manifest.knowledge_before) ? manifest.knowledge_before : [];
       for (const relPath of knowledgeBefore) {
         if (!isSafeRelativePath(relPath))
           continue;
-        const absPath = join53(ctxDir, relPath);
-        if (!existsSync44(absPath))
+        const absPath = join54(ctxDir, relPath);
+        if (!existsSync45(absPath))
           continue;
         let parsed;
         try {
@@ -38711,8 +38828,8 @@ var init_prepare = __esm(() => {
 });
 
 // src/cli.ts
-import { existsSync as existsSync48, readFileSync as readFileSync3, realpathSync } from "node:fs";
-import { dirname as dirname28, join as join62 } from "node:path";
+import { existsSync as existsSync49, readFileSync as readFileSync3, realpathSync } from "node:fs";
+import { dirname as dirname28, join as join63 } from "node:path";
 import { fileURLToPath as fileURLToPath4, pathToFileURL as pathToFileURL3 } from "node:url";
 
 // ../../node_modules/.bun/commander@11.1.0/node_modules/commander/esm.mjs
@@ -38882,6 +38999,7 @@ This directory is the C4A data root for a knowledge workspace.
 - Do not pipe or wrap \`context ... --format json\` output through \`python3\`, \`node\`, \`jq\`, \`sed\`, \`cat\`, \`2>&1\`, \`|| echo\`, or similar shell helpers. Run the \`context\` command directly and consume its complete stdout.
 - Schema discovery must also go through direct \`context\` commands. Schema commands support \`--format text|json|yaml\`; use readable YAML/text while drafting and JSON when a caller needs machine parsing. Inspect the schema \`enums\` field for allowed tags/actions instead of inventing labels such as \`platform\` or \`tool\`.
 - When passing large JSON / YAML / Markdown bodies to the CLI, feed stdin directly into the \`context\` command with a heredoc, for example \`context align --finalize - --digest <segments-digest> <<'JSON'\`. Do not pipe a heredoc through another command, and never redirect heredocs to workspace files.
+- For large \`context align --finalize\` payloads, use \`block_ownership_defaults[]\` as a compact source-level ownership rule instead of generating temporary JSON files or enumerating hundreds of block rows. Defaults must still declare an explicit \`source_id\`, \`ownership_role\`, owner/visibility fields, and reason when needed; use \`block_ownership[]\` for block-level exceptions. Defaults are a compression mechanism, not permission to assign mixed-source evidence to one owner without review.
 - In Claude Code, direct heredoc commands such as \`context compile --draft <slug> --input - --plan <<'JSON'\` may still prompt for permission when only subcommand-specific allow rules are configured. If that happens, ask the user before adding the scoped allow rule \`Bash(context:*)\` to the project \`.claude/settings.local.json\`; do not enable \`bypassPermissions\`.
 - Never hand-edit \`raw/\`, \`raw/_sources.yaml\`, \`archive/\`, \`knowledge/\`, \`knowledge/_index.md\`, or \`knowledge/changelog.md\`. Maintain them through \`context\` CLI commands and \`/context:*\` workflows.
 - \`decisions/\` stores CLI-managed semantic reconciliation decisions. Do not directly read, search, or write \`decisions/semantic.yaml\`; use \`context reconcile prepare|review|apply|record\`.
@@ -47457,8 +47575,8 @@ var DOCTOR_ACTIONS = {
   "coverage-high-signal-unresolved": {
     hintCode: "coverage-high-signal-unresolved",
     message: (count) => `${count} high-signal coverage issue(s) must be disposed before compile close.`,
-    next_action: "Use context status --format json to find coverage.candidates[].node_slug, then open the matching node-scoped coverage payload with context workflow show and continue /context:compile.",
-    command: "context schema coverage-disposition"
+    next_action: "Use context status --format json to find coverage.candidates[].node_slug, read the matching node-scoped coverage payload, then use --coverage-skip-unresolved when all unresolved candidates are intentionally excluded.",
+    command: 'context compile --coverage-skip-unresolved --coverage-disposition-node <slug> --payload-digest <digest> --reason "<reason>"'
   },
   "coverage-diagnostics-failed": {
     hintCode: "coverage-diagnostics-failed",
@@ -49722,7 +49840,7 @@ function reviewAgentHints(input) {
       code: "source-support-repair",
       severity: "error",
       message: `${sourceSupportIssueCount} decision(s) cite raw text that does not support the proposed content.`,
-      next_action: "Do not accept defaults for unsupported items. Inspect the prepared item with --view issues, then fix the draft by narrowing content, choosing source_support.evidence_block_source_ref/candidates, or splitting the action. Use draft-patch when a draft session digest exists; use source resolve-ref only when you have an exact quote but not the citation token.",
+      next_action: "Do not accept defaults for unsupported items. Missing hard facts mean the cited raw text does not cover the proposed content; narrow content, choose source_support.evidence_block_source_ref/candidates, or split the action. Low lexical overlap without missing hard facts is reported as a warning.",
       command: "context workflow show --payload prepare --scope <scope-id> --digest <prepare-digest> --view issues --status unsupported --unwrap --format json"
     });
   }
@@ -49799,13 +49917,13 @@ function reviewAgentHints(input) {
       schema: "context schema semantic-decisions --format yaml"
     });
   }
-  const weakSupportCount = input.questions.filter((question) => question.type === "support_confirmation").length;
+  const weakSupportCount = input.issues.filter((issue) => issue.code === "weak-source-support").length + input.questions.filter((question) => question.type === "support_confirmation").length;
   if (weakSupportCount > 0) {
     hints.push({
-      code: "weak-source-support-needs-confirmation",
+      code: "weak-source-support-warning",
       severity: "warning",
       message: `${weakSupportCount} item(s) are only weakly supported by the cited evidence.`,
-      next_action: "Ask the user/tester to confirm the summary/compression or choose/split source_ref/source_refs before applying."
+      next_action: "Proceed only if the weak summary/compression is acceptable for this workflow; otherwise narrow content or choose/split source_ref/source_refs."
     });
   }
   const exampleDetailQuestionCount = input.questions.filter((question) => question.type === "example_detail_preservation").length;
@@ -49814,7 +49932,7 @@ function reviewAgentHints(input) {
       code: "example-detail-preservation",
       severity: "warning",
       message: `${exampleDetailQuestionCount} example decision(s) cite code/config/command evidence without preserving it in detail.`,
-      next_action: "Move the relevant fenced block into proposed.detail and rerun review, or ask the user to confirm prose-only summary is acceptable."
+      next_action: "Move the relevant fenced block into proposed.detail and rerun review, or ask the user to confirm prose-only summary is acceptable. Auto mode or general permission to continue is not confirmation."
     });
   }
   const urlReferenceQuestionCount = input.questions.filter((question) => question.type === "url_reference_preservation").length;
@@ -49823,7 +49941,7 @@ function reviewAgentHints(input) {
       code: "url-reference-preservation",
       severity: "warning",
       message: `${urlReferenceQuestionCount} decision(s) cite URL evidence without preserving the referenced link.`,
-      next_action: "Move the relevant URL into proposed.detail and rerun review, or ask the user to confirm the link may be omitted."
+      next_action: "Move the relevant URL into proposed.detail and rerun review, or ask the user to confirm the link may be omitted. Auto mode or general permission to continue is not confirmation."
     });
   }
   const unresolvedQuestionCount = input.questions.length;
@@ -49893,7 +50011,7 @@ function urlReferencePreservationQuestion(input) {
     ...input.decision.proposed?.content !== undefined ? { proposed_content: input.decision.proposed.content } : {},
     cited_urls: diagnostic.citedUrls,
     missing_urls: diagnostic.missingUrls,
-    prompt: "The cited raw evidence includes URL(s), but this document/link/reference claim does not preserve them in proposed content or detail. " + "Add the relevant URL(s) to proposed.detail and rerun review, or ask the user to confirm that omitting the link is acceptable and mark the decision decided_by: user."
+    prompt: "The cited raw evidence includes URL(s), but this document/link/reference claim does not preserve them in proposed content or detail. " + "Add the relevant URL(s) to proposed.detail and rerun review, or ask the user to confirm that omitting the link is acceptable and mark the decision decided_by: user. Auto mode or general permission to continue is not confirmation."
   };
 }
 function urlReferencePreservationQuestions(input) {
@@ -50103,7 +50221,7 @@ function semanticDecisionSchemaErrorReview(input) {
 }
 
 // src/reconcile/review.ts
-var FENCED_CODE_RE3 = /(^|\n)\s*(```|~~~)/u;
+var FENCED_CODE_RE2 = /(^|\n)\s*(```|~~~)/u;
 function isRecord21(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -50371,6 +50489,11 @@ function actionNeedsSourceSupport2(action) {
 function actionRequiresStrictSourceSupport(action) {
   return action === "merge_update" || action === "supersede" || action === "reanchor" || action === "split_then_reanchor";
 }
+function sourceRefChangedFromPreparedSupport(input) {
+  const proposedSourceRef = input.decision.proposed?.source_ref;
+  const preparedSourceRef = input.item?.source_support?.source_ref;
+  return typeof proposedSourceRef === "string" && typeof preparedSourceRef === "string" && proposedSourceRef !== preparedSourceRef;
+}
 function supportKind(decision, item) {
   if (typeof decision.proposed?.kind === "string")
     return decision.proposed.kind;
@@ -50396,21 +50519,14 @@ function sourceSupportIssue(input) {
     ...splitCandidateCount > 1 ? { code: "source-support-split-by-evidence-blocks" } : {}
   };
 }
-function weakSupportQuestion(input) {
-  const sourceAlias2 = typeof input.decision.proposed?.source_ref === "string" ? /^(src-\d+)#/u.exec(input.decision.proposed.source_ref)?.[1] : undefined;
-  const node2 = input.decision.target?.node ?? input.item?.target?.node;
-  const groupKey = node2 !== undefined && sourceAlias2 !== undefined ? `support:${node2}:${sourceAlias2}` : undefined;
+function weakSupportWarning(input) {
   return {
-    question_id: `q-${String(input.questionIndex + 1).padStart(3, "0")}`,
+    path: `${input.decision.item_id}.proposed.source_ref`,
     item_id: input.decision.item_id,
-    type: "support_confirmation",
-    ...groupKey !== undefined ? {
-      group_key: groupKey,
-      group_reason: "same Node/source weak summary support; show each cited evidence boundary before asking once"
-    } : {},
-    ...input.summary !== undefined ? { candidate_summary: { active: input.summary.active, archive: input.summary.archive } } : {},
-    ...input.decision.proposed?.content !== undefined ? { proposed_content: input.decision.proposed.content } : {},
-    prompt: "The proposed new knowledge is only weakly supported by the cited raw text. " + `${formatSupportDiagnostic(input.diagnostic)}. ` + "Ask the user whether this is an acceptable summary/compression; if confirmed, regenerate the final decision with decided_by: user."
+    severity: "warning",
+    code: "weak-source-support",
+    message: `proposed keep_separate is weakly supported by its cited raw text: ${formatSupportDiagnostic(input.diagnostic)}.`,
+    next_action: "Review the cited evidence if the summary looks surprising; missing hard facts still remain errors."
   };
 }
 function citedTextForDecision2(decision, item) {
@@ -50431,9 +50547,9 @@ function needsExampleDetailPreservationQuestion(input) {
     return false;
   if (supportKind(input.decision, input.item) !== "example")
     return false;
-  if (!FENCED_CODE_RE3.test(citedTextForDecision2(input.decision, input.item)))
+  if (!FENCED_CODE_RE2.test(citedTextForDecision2(input.decision, input.item)))
     return false;
-  return !FENCED_CODE_RE3.test(input.decision.proposed?.detail ?? "");
+  return !FENCED_CODE_RE2.test(input.decision.proposed?.detail ?? "");
 }
 function exampleDetailPreservationQuestion(input) {
   return {
@@ -50442,7 +50558,7 @@ function exampleDetailPreservationQuestion(input) {
     type: "example_detail_preservation",
     ...input.summary !== undefined ? { candidate_summary: { active: input.summary.active, archive: input.summary.archive } } : {},
     ...input.decision.proposed?.content !== undefined ? { proposed_content: input.decision.proposed.content } : {},
-    prompt: "The cited raw evidence contains a fenced code/config/command block, but this example decision does not preserve it in proposed.detail. " + "Add the relevant fenced block to proposed.detail and rerun review, or ask the user to confirm that a prose-only summary is acceptable and mark the decision decided_by: user."
+    prompt: "The cited raw evidence contains a fenced code/config/command block, but this example decision does not preserve it in proposed.detail. " + "Add the relevant fenced block to proposed.detail and rerun review, or ask the user to confirm that a prose-only summary is acceptable and mark the decision decided_by: user. Auto mode or general permission to continue is not confirmation."
   };
 }
 function itemRequiresDecision(item) {
@@ -50515,15 +50631,13 @@ function reviewSemanticDecisions(input) {
   }
   for (const prior of priorResults) {
     const diagnostic = supportDiagnosticFromItem({ decision: prior.decision, item: prior.item });
-    if (diagnostic?.verdict === "weak" && prior.decision.action === "keep_separate" && prior.decision.decided_by !== "user") {
-      questions.push(weakSupportQuestion({
+    const changedSourceRef = sourceRefChangedFromPreparedSupport({ decision: prior.decision, item: prior.item });
+    if (diagnostic?.verdict === "weak" && prior.decision.action === "keep_separate" && !changedSourceRef) {
+      issues.push(weakSupportWarning({
         decision: prior.decision,
-        item: prior.item,
-        questionIndex: questions.length,
-        summary: candidateSummaryByItem.get(prior.decision.item_id),
         diagnostic
       }));
-    } else if (diagnostic?.verdict === "unsupported" || diagnostic?.verdict === "weak" && !(prior.decision.action === "keep_separate" && prior.decision.decided_by === "user")) {
+    } else if (diagnostic?.verdict === "unsupported" || changedSourceRef && diagnostic?.verdict === "weak" || diagnostic?.verdict === "weak" && !(prior.decision.action === "keep_separate" && prior.decision.decided_by === "user")) {
       issues.push(sourceSupportIssue({ decision: prior.decision, diagnostic, support: prior.item?.source_support }));
     }
   }
@@ -50651,6 +50765,7 @@ async function reviewSemanticDecisionsWithWorkspace(input) {
     if (node2 === undefined)
       continue;
     try {
+      const changedPreparedSourceRef = typeof item?.source_support?.source_ref === "string" && item.source_support.source_ref !== sourceRef;
       const result = await diagnoseSectionSourceSupport({
         ctxDir: input.ctxDir,
         nodeSources: node2.parsed.node.sources,
@@ -50663,13 +50778,21 @@ async function reviewSemanticDecisionsWithWorkspace(input) {
           source_ref: sourceRef
         }
       });
-      item.source_support = sourceSupportFromDiagnostic({
+      const diagnostic = changedPreparedSourceRef && result.diagnostic.verdict === "weak" ? { ...result.diagnostic, verdict: "unsupported" } : result.diagnostic;
+      const sourceSupport = sourceSupportFromDiagnostic({
         sourceRef: result.sourceRef,
         citedText: result.citedText,
-        diagnostic: result.diagnostic,
+        diagnostic,
         ...result.evidenceBlock !== undefined ? { evidenceBlock: result.evidenceBlock } : {},
         ...result.evidenceBlockCandidates !== undefined ? { evidenceBlockCandidates: result.evidenceBlockCandidates } : {}
       });
+      if (changedPreparedSourceRef && result.diagnostic.verdict === "weak") {
+        const withoutCitedText = { ...sourceSupport };
+        delete withoutCitedText.cited_text;
+        item.source_support = withoutCitedText;
+      } else {
+        item.source_support = sourceSupport;
+      }
     } catch (error) {
       item.source_support = {
         source_ref: sourceRef,
@@ -50755,10 +50878,10 @@ init_compileNode();
 init_coverage();
 init_evidence();
 init_ledger();
-import { existsSync as existsSync45 } from "node:fs";
+import { existsSync as existsSync46 } from "node:fs";
 import { cp as cp3, mkdir as mkdir25, mkdtemp as mkdtemp2, rm as rm14 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
-import { dirname as dirname22, join as join54 } from "node:path";
+import { dirname as dirname22, join as join55 } from "node:path";
 init_sourceSupport();
 init_locatedNodeSources();
 init_types3();
@@ -50848,13 +50971,13 @@ async function propagateOmitCoverageSkips(input) {
   }
 }
 async function createApplyRollbackSnapshot(ctxDir) {
-  const tmpDir = await mkdtemp2(join54(tmpdir2(), "c4a-reconcile-apply-"));
-  const knowledgePath2 = join54(ctxDir, "knowledge");
+  const tmpDir = await mkdtemp2(join55(tmpdir2(), "c4a-reconcile-apply-"));
+  const knowledgePath2 = join55(ctxDir, "knowledge");
   const ledgerPath = semanticLedgerPath2(ctxDir);
-  const knowledgeBackup = join54(tmpDir, "knowledge");
-  const ledgerBackup = join54(tmpDir, "semantic.yaml");
-  const knowledgeExisted = existsSync45(knowledgePath2);
-  const ledgerExisted = existsSync45(ledgerPath);
+  const knowledgeBackup = join55(tmpDir, "knowledge");
+  const ledgerBackup = join55(tmpDir, "semantic.yaml");
+  const knowledgeExisted = existsSync46(knowledgePath2);
+  const ledgerExisted = existsSync46(ledgerPath);
   if (knowledgeExisted)
     await cp3(knowledgePath2, knowledgeBackup, { recursive: true });
   if (ledgerExisted)
@@ -50862,7 +50985,7 @@ async function createApplyRollbackSnapshot(ctxDir) {
   return { ctxDir, tmpDir, knowledgeExisted, ledgerExisted, knowledgeBackup, ledgerBackup };
 }
 async function restoreApplyRollbackSnapshot(snapshot) {
-  const knowledgePath2 = join54(snapshot.ctxDir, "knowledge");
+  const knowledgePath2 = join55(snapshot.ctxDir, "knowledge");
   if (snapshot.knowledgeExisted) {
     await rm14(knowledgePath2, { recursive: true, force: true });
     await cp3(snapshot.knowledgeBackup, knowledgePath2, { recursive: true });
@@ -52364,9 +52487,9 @@ init_edge2();
 // src/lib/glossary.ts
 init_knowledge();
 init_nodeParser();
-import { existsSync as existsSync46 } from "node:fs";
+import { existsSync as existsSync47 } from "node:fs";
 import { readdir as readdir21, readFile as readFile55 } from "node:fs/promises";
-import { join as join55 } from "node:path";
+import { join as join56 } from "node:path";
 function collectGlossaryFromParsedTree(parsed, glossary, allowedTypes) {
   const type = parsed.node.type;
   if (allowedTypes.has(type)) {
@@ -52389,16 +52512,16 @@ function normalizeGlossaryTerm(value) {
   return value.normalize("NFC").trim().toLowerCase();
 }
 function resolveKnowledgeRoot(path8) {
-  if (existsSync46(join55(path8, "knowledge"))) {
-    return join55(path8, "knowledge");
+  if (existsSync47(join56(path8, "knowledge"))) {
+    return join56(path8, "knowledge");
   }
   return path8;
 }
 async function readGlossaryFiles(dir) {
-  if (!existsSync46(dir))
+  if (!existsSync47(dir))
     return [];
   const entries = await readdir21(dir, { withFileTypes: true });
-  return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".md") && entry.name !== "_index.md" && entry.name !== "changelog.md").map((entry) => join55(dir, entry.name));
+  return entries.filter((entry) => entry.isFile() && entry.name.endsWith(".md") && entry.name !== "_index.md" && entry.name !== "changelog.md").map((entry) => join56(dir, entry.name));
 }
 async function buildGlossary(path8, options = {}) {
   const knowledgeRoot2 = resolveKnowledgeRoot(path8);
@@ -52406,7 +52529,7 @@ async function buildGlossary(path8, options = {}) {
   const allowedTypes = new Set(targets);
   const glossary = [];
   for (const type of targets) {
-    const files = await readGlossaryFiles(join55(knowledgeRoot2, type));
+    const files = await readGlossaryFiles(join56(knowledgeRoot2, type));
     for (const file of files) {
       const parsed = parseNodeMarkdown(await readFile55(file, "utf8"));
       if (parsed.node.type !== type)
@@ -53020,9 +53143,9 @@ function registerMdriveCommands(program2) {
 init_cliFeedback();
 init_errors();
 var import_yaml32 = __toESM(require_dist(), 1);
-import { existsSync as existsSync47 } from "node:fs";
+import { existsSync as existsSync48 } from "node:fs";
 import { lstat as lstat2, mkdir as mkdir28, readFile as readFile58, readdir as readdir22, realpath as realpath3, rename as rename7, writeFile as writeFile21 } from "node:fs/promises";
-import { dirname as dirname25, isAbsolute as isAbsolute6, join as join56, relative as relative12 } from "node:path";
+import { dirname as dirname25, isAbsolute as isAbsolute6, join as join57, relative as relative12 } from "node:path";
 init_workspaceLayout();
 init_section();
 init_exitCode();
@@ -53086,7 +53209,7 @@ async function assertRealPathInside(ctxDir, targetPath) {
   });
 }
 function resolveWorkspacePath(ctxDir, relPath) {
-  return relPath === "." ? ctxDir : join56(ctxDir, relPath);
+  return relPath === "." ? ctxDir : join57(ctxDir, relPath);
 }
 function pathKind2(stats) {
   if (stats.isFile())
@@ -53241,7 +53364,7 @@ function assertWorkspaceWriteAllowed(relPath) {
 async function writeWorkspaceFile(input) {
   assertWorkspaceWriteAllowed(input.relPath);
   const destination = resolveWorkspacePath(input.ctxDir, input.relPath);
-  if (existsSync47(destination) && !input.overwrite) {
+  if (existsSync48(destination) && !input.overwrite) {
     throw new ContextError(ExitCode.UserError, `workspace file already exists: ${input.relPath}`, {
       category: ErrorCategory.UserInputInvalid,
       path: input.relPath
@@ -54122,12 +54245,32 @@ function candidateRows(value) {
     churn: candidate.churn
   }));
 }
+function sourceReadingRows(value) {
+  if (!isRecord24(value))
+    return [];
+  return asRecords(value.source_readings).map((reading) => ({
+    ...typeof reading.source_id === "string" ? { source_id: reading.source_id } : {},
+    ...typeof reading.segments_digest === "string" ? { segments_digest: reading.segments_digest } : {},
+    ...typeof reading.coarse_read_digest === "string" ? { coarse_read_digest: reading.coarse_read_digest } : {},
+    ...typeof reading.read_at === "string" ? { read_at: reading.read_at } : {},
+    ...typeof reading.density_profile === "string" ? { density_profile: reading.density_profile } : {},
+    reading_anchor_count: asRecords(reading.reading_anchors).length,
+    section_proposal_count: asRecords(reading.section_proposals).length,
+    reading_anchors: reading.reading_anchors,
+    section_proposals: reading.section_proposals
+  }));
+}
 function compactAlignLedger(record, value, options) {
   if (!isRecord24(value))
     return { candidates: [], block_dispositions: [], counts: { candidates: 0 } };
   const allCandidates = candidateRows(value);
+  const allSourceReadings = sourceReadingRows(value);
+  const sourceReadings = allSourceReadings.filter((reading) => options.sourceId === undefined || reading.source_id === options.sourceId);
   const filtered = allCandidates.filter((candidate) => (options.status === undefined || candidate.status === options.status) && (options.candidateId === undefined || candidate.candidate_id === options.candidateId));
-  const wantsDetail = options.status !== undefined || options.candidateId !== undefined || options.pageSize !== undefined || options.pageToken !== undefined;
+  const shouldShowCandidates = options.sourceId === undefined || options.status !== undefined || options.candidateId !== undefined;
+  const candidateRowsForDetail = shouldShowCandidates ? filtered : [];
+  const sourceReadingsForDetail = options.sourceId === undefined ? [] : sourceReadings;
+  const wantsDetail = options.sourceId !== undefined || options.status !== undefined || options.candidateId !== undefined || options.pageSize !== undefined || options.pageToken !== undefined;
   if (!wantsDetail) {
     const firstCandidateId = allCandidates.find((candidate) => candidate.candidate_id !== undefined)?.candidate_id;
     const firstStatus = allCandidates.find((candidate) => candidate.status !== undefined)?.status;
@@ -54136,10 +54279,18 @@ function compactAlignLedger(record, value, options) {
       last_batch_id: value.last_batch_id,
       summary: {
         candidates: allCandidates.length,
+        source_readings: allSourceReadings.length,
         block_dispositions: asRecords(value.block_dispositions).length,
         by_status: countBy(allCandidates.map((candidate) => candidate.status ?? "unknown")),
         by_node_type: countBy(allCandidates.map((candidate) => candidate.node_type ?? "unknown"))
       },
+      source_reading_index: allSourceReadings.slice(0, DEFAULT_INDEX_LIMIT).map((reading) => ({
+        source_id: reading.source_id,
+        density_profile: reading.density_profile,
+        reading_anchor_count: reading.reading_anchor_count,
+        section_proposal_count: reading.section_proposal_count,
+        read_at: reading.read_at
+      })),
       candidate_index: allCandidates.slice(0, DEFAULT_INDEX_LIMIT).map((candidate) => ({
         candidate_id: candidate.candidate_id,
         current_slug: candidate.current_slug,
@@ -54162,11 +54313,19 @@ function compactAlignLedger(record, value, options) {
       }]
     };
   }
-  const page = paginate(filtered, options);
+  const page = paginate(candidateRowsForDetail, options);
   return {
     mode: "detail",
     last_batch_id: value.last_batch_id,
     filters: compactFilters(options),
+    source_readings: sourceReadingsForDetail,
+    ...options.sourceId === undefined ? { source_reading_index: allSourceReadings.slice(0, DEFAULT_INDEX_LIMIT).map((reading) => ({
+      source_id: reading.source_id,
+      density_profile: reading.density_profile,
+      reading_anchor_count: reading.reading_anchor_count,
+      section_proposal_count: reading.section_proposal_count,
+      read_at: reading.read_at
+    })) } : {},
     candidates: page.items,
     block_dispositions: asRecords(value.block_dispositions).map((item) => ({
       block_id: item.block_id,
@@ -54177,9 +54336,18 @@ function compactAlignLedger(record, value, options) {
     ...page.page !== undefined ? { page: page.page } : {},
     counts: {
       matched_candidates: filtered.length,
+      candidate_filter_applied: shouldShowCandidates,
       shown_candidates: page.items.length,
+      matched_source_readings: sourceReadings.length,
+      shown_source_readings: sourceReadingsForDetail.length,
       block_dispositions: asRecords(value.block_dispositions).length
-    }
+    },
+    ...options.sourceId !== undefined && !shouldShowCandidates ? { agent_hints: [{
+      code: "workflow-ledger-source-filter",
+      severity: "info",
+      message: "--source filters source_readings only; candidates do not carry source_id.",
+      next_action: "Add --status or --candidate-id when you also need candidate rows from the ledger view."
+    }] } : {}
   };
 }
 function compactAlignAggregate(record, value, options) {
@@ -55514,6 +55682,16 @@ function coverageSkipPatch(input) {
     }]
   };
 }
+function coverageSkipUnresolvedPatch(input) {
+  return {
+    schema_version: COVERAGE_DISPOSITION_SCHEMA_VERSION,
+    dispositions: input.candidates.filter((candidate) => candidate.status === "unresolved").map((candidate) => ({
+      candidate_id: candidate.candidate_id,
+      action: "skip",
+      reason: input.reason
+    }))
+  };
+}
 function renderCompileClosedFeedbackBody(input) {
   const lines = [];
   if (input.workflowSummary)
@@ -56191,11 +56369,10 @@ function candidateId(batchId, localRef, slug) {
   const hash2 = createHash8("sha256").update(`${batchId}\x00${localRef}\x00${slug}`).digest("hex").slice(0, 16);
   return `cand_${hash2}`;
 }
-function cloneLedger(ledger, batchId) {
-  return ledger ? {
-    ...ledger,
-    last_batch_id: batchId,
-    id_mappings_from_last_batch: [],
+function cloneLedgerState(ledger) {
+  return {
+    schema_version: ledger.schema_version,
+    source_readings: cloneSourceReadings(ledger.source_readings),
     candidates: ledger.candidates.map((candidate) => ({
       ...candidate,
       block_ids: [...candidate.block_ids],
@@ -56210,10 +56387,14 @@ function cloneLedger(ledger, batchId) {
     proposed_sections: ledger.proposed_sections.map((item) => ({ ...item })),
     ops_history: [...ledger.ops_history],
     warnings: [...ledger.warnings]
-  } : {
+  };
+}
+function emptyLedger2(batchId) {
+  return {
     schema_version: ALIGN_CANDIDATE_LEDGER_SCHEMA_VERSION,
     last_batch_id: batchId,
     id_mappings_from_last_batch: [],
+    source_readings: [],
     candidates: [],
     block_dispositions: [],
     parent_hints: [],
@@ -56223,6 +56404,55 @@ function cloneLedger(ledger, batchId) {
     warnings: []
   };
 }
+function cloneLedger(ledger, batchId) {
+  if (ledger === undefined)
+    return emptyLedger2(batchId);
+  return {
+    ...cloneLedgerState(ledger),
+    last_batch_id: batchId,
+    id_mappings_from_last_batch: []
+  };
+}
+function cloneSourceReadings(value) {
+  return (value ?? []).map((reading) => ({
+    ...reading,
+    reading_anchors: reading.reading_anchors.map((anchor) => ({ ...anchor })),
+    section_proposals: reading.section_proposals.map((section) => ({ ...section }))
+  }));
+}
+function cloneLedgerForSourceReading(ledger) {
+  if (ledger === undefined)
+    return emptyLedger2("coarse-read");
+  return {
+    ...cloneLedgerState(ledger),
+    last_batch_id: ledger.last_batch_id,
+    id_mappings_from_last_batch: ledger.id_mappings_from_last_batch.map((mapping) => ({ ...mapping }))
+  };
+}
+function upsertSourceReading(input) {
+  const ledger = cloneLedgerForSourceReading(input.ledger);
+  const densityProfile = text(input.coarseRead.density_profile);
+  if (densityProfile === undefined) {
+    throw new ContextError(ExitCode.UserError, "density_profile is required before storing source reading", {
+      category: ErrorCategory.SchemaInvalid,
+      path: "density_profile"
+    });
+  }
+  const next = {
+    source_id: input.sourceId,
+    segments_digest: input.segmentsDigest,
+    coarse_read_digest: input.coarseReadDigest,
+    read_at: (input.now ?? new Date).toISOString(),
+    density_profile: densityProfile,
+    reading_anchors: Array.isArray(input.coarseRead.reading_anchors) ? input.coarseRead.reading_anchors.filter(isRecord26).map((anchor) => ({ ...anchor })) : [],
+    section_proposals: Array.isArray(input.coarseRead.section_proposals) ? input.coarseRead.section_proposals.filter(isRecord26).map((section) => ({ ...section })) : []
+  };
+  ledger.source_readings = [
+    ...(ledger.source_readings ?? []).filter((reading) => reading.source_id !== input.sourceId),
+    next
+  ].sort((left, right) => left.source_id.localeCompare(right.source_id));
+  return ledger;
+}
 function terminal(candidate) {
   return candidate?.status === "rejected" || candidate?.status === "superseded";
 }
@@ -56754,6 +56984,65 @@ function nodesFromDecision(decision, sources, language) {
     };
   });
 }
+function nodeWithRecomputedSources(node2, sources) {
+  const sourceIds = sourceIdsForNode(sources, node2.slug);
+  return {
+    slug: node2.slug,
+    type: node2.type,
+    tags: node2.tags,
+    title: node2.title,
+    sources: sourceIds.evidence,
+    ...sourceIds.context.length > 0 ? { context_sources: sourceIds.context } : {},
+    ...node2.summary !== undefined ? { summary: node2.summary } : {},
+    ...node2.language !== undefined ? { language: node2.language } : {},
+    ...node2.contains_parent !== undefined ? { contains_parent: node2.contains_parent } : {},
+    ...node2.planned_sections !== undefined ? { planned_sections: node2.planned_sections } : {},
+    ...node2.domain_gate !== undefined ? { domain_gate: node2.domain_gate } : {},
+    ...node2.action_gate !== undefined ? { action_gate: node2.action_gate } : {}
+  };
+}
+function mergeSources(input) {
+  const currentBySource = new Map(input.current.map((source2) => [source2.source_id, source2]));
+  const seen = new Set;
+  const merged = input.previous.map((source2) => {
+    const replacement = currentBySource.get(source2.source_id);
+    if (replacement !== undefined) {
+      seen.add(source2.source_id);
+      return replacement;
+    }
+    return source2;
+  });
+  for (const source2 of input.current) {
+    if (!seen.has(source2.source_id))
+      merged.push(source2);
+  }
+  return merged;
+}
+function mergeNodes(input) {
+  const currentBySlug = new Map(input.current.map((node2) => [node2.slug, node2]));
+  const seen = new Set;
+  const merged = input.previous.map((node2) => {
+    const replacement = currentBySlug.get(node2.slug);
+    seen.add(node2.slug);
+    return nodeWithRecomputedSources(replacement ?? node2, input.sources);
+  });
+  for (const node2 of input.current) {
+    if (!seen.has(node2.slug))
+      merged.push(nodeWithRecomputedSources(node2, input.sources));
+  }
+  return merged;
+}
+function mergeEdges(input) {
+  const byKey = new Map;
+  const put = (edge2) => {
+    if (!input.activeSlugs.has(edge2.from) || !input.activeSlugs.has(edge2.to))
+      return;
+    byKey.set(`${edge2.type}\x00${edge2.from}\x00${edge2.to}`, edge2);
+  };
+  input.previous.forEach(put);
+  input.current.forEach(put);
+  return [...byKey.values()].sort((left, right) => `${left.from}\x00${left.to}`.localeCompare(`${right.from}\x00${right.to}`));
+}
 function isCitationEligibleForNode(block, slug) {
   if (block.status === "owned")
     return block.owner === slug || block.coverable_by.includes(slug);
@@ -56769,6 +57058,16 @@ function isVisibleNonCitationForNode(block, slug) {
 function isContainerDomain(nodes, node2) {
   return node2.type === "domain" && nodes.some((candidate) => candidate.contains_parent === node2.slug);
 }
+function isExplicitNoWriteNode2(node2) {
+  return node2.planned_sections !== undefined && node2.planned_sections.length === 0;
+}
+function hasFinalizedGraphLink2(ownership, node2) {
+  if (typeof node2.contains_parent === "string" && node2.contains_parent.length > 0)
+    return true;
+  if ((ownership.nodes ?? []).some((candidate) => candidate.contains_parent === node2.slug))
+    return true;
+  return (ownership.edges ?? []).some((edge2) => edge2.from === node2.slug || edge2.to === node2.slug);
+}
 function auditFinalizedCitationEvidence(ownership) {
   const nodes = ownership.nodes ?? [];
   const blocks = ownership.sources.flatMap((source2) => source2.blocks);
@@ -56778,6 +57077,9 @@ function auditFinalizedCitationEvidence(ownership) {
     if (blocks.some((block) => isCitationEligibleForNode(block, node2.slug)))
       return [];
     const visibleBlocks = blocks.filter((block) => isVisibleNonCitationForNode(block, node2.slug)).map((block) => block.block_id).filter((blockId2) => typeof blockId2 === "string" && blockId2.length > 0);
+    if (isExplicitNoWriteNode2(node2) && (visibleBlocks.length > 0 || hasFinalizedGraphLink2(ownership, node2))) {
+      return [];
+    }
     return [{
       kind: "node_without_citation_evidence",
       node_slug: node2.slug,
@@ -56835,6 +57137,31 @@ function buildSourceOwnershipFromFinalized(input) {
     summary: summary(sources)
   };
 }
+function mergeIncrementalSourceOwnership(input) {
+  const sources = mergeSources({
+    previous: input.previous.sources,
+    current: input.current.sources
+  });
+  const nodes = mergeNodes({
+    previous: input.previous.nodes ?? [],
+    current: input.current.nodes ?? [],
+    sources
+  });
+  const activeSlugs = new Set(nodes.map((node2) => node2.slug));
+  const edges = mergeEdges({
+    previous: input.previous.edges ?? [],
+    current: input.current.edges ?? [],
+    activeSlugs
+  });
+  return {
+    schema_version: SOURCE_OWNERSHIP_SCHEMA_VERSION,
+    generated_at: input.current.generated_at,
+    nodes,
+    ...edges.length > 0 ? { edges } : {},
+    sources,
+    summary: summary(sources)
+  };
+}
 
 // src/workflow/alignConstraintRegistry.ts
 function duplicateValues2(values) {
@@ -56917,7 +57244,7 @@ function structureIssueHint(issue) {
   const availableNodeSlugs = sortedUnique(context.availableNodeSlugs ?? []);
   const availableBlockIds = sortedUnique(context.availableBlockIds ?? []);
   const gateHelp = path8.includes("action_gate") || path8.includes("domain_gate") ? " For gate fields, follow plugin/skills/skill-align-workflow/references/gates.md." : "";
-  const nextAction = context.reasonCode === "unknown-node-ref" ? `Use one of agent_hints[].available_node_refs for *_ref fields, then resubmit the corrected align-structure-decision.${gateHelp}` : context.correctShape !== undefined ? `Reshape this entry to match agent_hints[].correct_shape and resubmit the structure decision.${gateHelp}` : `Read \`context schema align-structure-decision\` and resubmit the structure decision.${gateHelp}`;
+  const nextAction = context.reasonCode === "unknown-node-ref" ? `Use one of agent_hints[].available_node_refs for *_ref fields, then resubmit the corrected align-structure-decision.${gateHelp}` : context.reasonCode === "existing-node-type-drift" ? "Do not change node_type for an existing or previously removed slug. In incremental align, reference the existing slug from contains_parent, edges, domain_gate.child_refs, or block_ownership instead of redeclaring it. If the concept really needs a different type, use a new slug; if the old slug should be retired first, use `context drop` or an explicit structure correction path. `context align --scan --full` does not bypass this guard." : context.reasonCode === "section-owner-not-current-node" ? "sections[] plans Sections only for nodes declared in the current align-structure-decision. Move this Section plan to a current node or omit it for the previous finalized Node; previous Nodes can still be referenced from contains_parent, edges, domain_gate.child_refs, and block_ownership visibility." : context.correctShape !== undefined ? `Reshape this entry to match agent_hints[].correct_shape and resubmit the structure decision.${gateHelp}` : `Read \`context schema align-structure-decision\` and resubmit the structure decision.${gateHelp}`;
   return {
     code: "align-structure-decision-invalid",
     severity: "error",
@@ -57245,7 +57572,8 @@ var SCHEMAS = {
       "density_profile must be one of macro, meso, micro, or single_pass.",
       "content_signals keys must be temporal_density, actor_density, step_density, or directive_density.",
       "content_signals values must be high, med, or low. Use med, not medium.",
-      "content_signals describe text shape only; they are not action/type/tag hints."
+      "content_signals describe text shape only; they are not action/type/tag hints.",
+      "align-coarse-read is a per-source input and latest checkpoint. Durable multi-source recall lives in align-candidate-ledger.source_readings."
     ]
   },
   "align-candidate-ops": {
@@ -57346,6 +57674,15 @@ var SCHEMAS = {
       schema_version: "align.candidate-ledger.v1",
       last_batch_id: "discovery_batch_0001",
       id_mappings_from_last_batch: [{ local_candidate_ref: "local:region", candidate_id: "cand_0001" }],
+      source_readings: [{
+        source_id: "local:demo",
+        segments_digest: "sha256:segments",
+        coarse_read_digest: "sha256:coarse",
+        read_at: "2026-05-12T00:00:00.000Z",
+        density_profile: "single_pass",
+        reading_anchors: [{ anchor_id: "a0001", evidence_blocks: ["b0001"] }],
+        section_proposals: [{ section_id: "s0001", block_ids: ["b0001"], context_prefix: "Overview." }]
+      }],
       candidates: [{
         candidate_id: "cand_0001",
         current_slug: "data-region",
@@ -57361,6 +57698,9 @@ var SCHEMAS = {
       block_dispositions: []
     },
     notes: [
+      "source_readings stores per-source coarse-read notes so multiple coarse-read submissions do not rely on the latest align-coarse-read checkpoint.",
+      "source_readings is discovery memory only; final structure still comes from align-structure-decision and finalized ownership.",
+      "source_readings are sorted by source_id for deterministic output; they are not an execution-order log.",
       "Batch-local refs may appear only in id_mappings_from_last_batch and must not leak into later batches.",
       "Merged and superseded chains must remain acyclic."
     ]
@@ -57492,7 +57832,14 @@ var SCHEMAS = {
         evidence_blocks: ["b0002"],
         rationale: "Failover depends on the region scope."
       }],
-      block_ownership: BLOCK_OWNERSHIP_EXAMPLE,
+      block_ownership_defaults: [{
+        source_id: "local:regional-ops",
+        ownership_role: "owned",
+        owners: ["data-region"],
+        visible_to: ["data-region", "regional-operations"],
+        reason: "Remaining blocks in this source describe the data-region term."
+      }],
+      block_ownership: BLOCK_OWNERSHIP_EXAMPLE.filter((item) => item.block_id !== "b0002"),
       unresolved: [
         {
           question_id: "q_failover_owner",
@@ -57505,16 +57852,22 @@ var SCHEMAS = {
       "Use align-segments.generation_policy when choosing node.title, node.summary, rationale prose, and planned Section wording.",
       "nodes[].contains_parent is the only hierarchy field; edges[] only accepts depends_on.",
       "domain nodes need domain_gate; unresolved or weak domain gates are downgraded to entity.",
+      "When align-segments.incremental.mode is incremental, finalize preserves previous finalized ownership for unscanned sources. The current decision should describe only the scanned evidence while referencing previous active Nodes when needed.",
+      "In incremental mode, absence of an old Node or edge is not a deletion signal; use a full align, drop source, or explicit structure correction path for removals.",
+      "Incremental finalize may reference previous active Nodes from nodes[].contains_parent, edges[].from/to, domain_gate.child_refs, and block_ownership owners/visible_to/primary_owner. Do not redeclare an old parent/domain just to attach new children.",
+      "sections[].owner is intentionally limited to nodes declared in the current align-structure-decision payload; do not plan new Sections for previous finalized Nodes in an incremental payload.",
+      "Existing and previously removed Node slugs cannot change node_type in either incremental or full finalize. context align --scan --full controls replacement/removal semantics, not type-drift bypass. Use a new slug for a different type, or retire the old slug through context drop or explicit structure correction first.",
       "action_probe is the only place for action qualification booleans; action_gate accepts inference_sources only.",
       "If the current candidate ledger already has action_probe for this action node and the digest matches, finalize may hydrate it. Directly new action nodes must provide action_probe explicitly.",
       "action_gate.inference_sources needs actor, outcome_or_goal, repeatability_or_plan, and answerability. source_type must be one of explicit-block / heading-and-block / ref-node / inferred-from-block. explicit-block and heading-and-block entries may omit rationale; ref-node and inferred-from-block mappings must explain rationale.",
+      "For large finalize payloads, use block_ownership_defaults[] to assign all remaining coverable blocks from a source_id to one role/owner, then use block_ownership[] only for block-level exceptions. The CLI expands defaults before validation; explicit block_ownership[] entries override defaults for the same block_id.",
       "Each block_ownership[] entry sets `ownership_role` to one of owned / shared / context_only / ignored / unresolved.",
       "owned: exactly one slug in `owners[]`, plus `visible_to[]`. Do not set `primary_owner` or `context_prefix`. reason is optional for mechanical owned cases.",
       "shared: at least two slugs in `owners[]`, plus `primary_owner` chosen from those owners, plus `visible_to[]` and `reason`. The primary owner is the only Node allowed to author cited Sections from that block; secondary owners must request full text or raise an ownership challenge before citing it.",
       "context_only: omit `owners` and `primary_owner` entirely. Required: `context_prefix` (short summary travelling with citing Sections), `visible_to[]`. reason is optional for mechanical context-only cases. The block carries context but is not citation evidence on its own.",
       "ignored: omit `owners`, `primary_owner`, `context_prefix`, and `visible_to`. reason is optional for mechanical ignored cases. Use for outdated markers, navigation/external-link blocks, and placeholders without independent knowledge.",
       "unresolved: omit `owners`, `primary_owner`, and `context_prefix`. Required: `question_id` (matching a top-level `unresolved[].question_id`) and `reason`. Use when classification is blocked by missing evidence.",
-      "Every coverable block must have exactly one ownership disposition; the validator returns `agent_hints[].correct_shape` with the exact JSON skeleton when a role-specific field is wrong.",
+      "Every coverable block must have exactly one ownership disposition after block_ownership_defaults[] expansion; the validator returns `agent_hints[].correct_shape` with the exact JSON skeleton when a role-specific field is wrong.",
       "block_ownership assigns evidence visibility and citation authority only; write Section kinds in sections[].section_kind."
     ]
   }
@@ -57527,6 +57880,92 @@ function alignWorkflowSchemaExample(name) {
 }
 
 // src/workflow/alignStructureOwnership.ts
+function expandOwnershipDefaults(input) {
+  if (input.blockOwnershipDefaults === undefined)
+    return input.blockOwnership;
+  if (!Array.isArray(input.blockOwnership))
+    return input.blockOwnership;
+  if (!Array.isArray(input.blockOwnershipDefaults)) {
+    throwStructureIssues([{
+      path: "block_ownership_defaults",
+      message: "block_ownership_defaults must be an array when present",
+      context: {}
+    }]);
+  }
+  if (input.coverableBlocks === undefined) {
+    throwStructureIssues([{
+      path: "block_ownership_defaults",
+      message: "block_ownership_defaults requires align-segments source metadata",
+      context: {}
+    }]);
+  }
+  const sourceByBlock = new Map(input.coverableBlocks.map((block) => [block.block_id, block.source_id]));
+  const blocksBySource = new Map;
+  for (const blockId2 of input.coverableBlockIds) {
+    const sourceId = sourceByBlock.get(blockId2);
+    if (sourceId === undefined)
+      continue;
+    const blocks = blocksBySource.get(sourceId) ?? [];
+    blocks.push(blockId2);
+    blocksBySource.set(sourceId, blocks);
+  }
+  const explicitBlockIds = new Set(input.blockOwnership.filter(isRecord28).map((entry) => stringValue2(entry.block_id)).filter((blockId2) => blockId2 !== undefined));
+  const issues = [];
+  const defaultsBySource = new Set;
+  const expanded = [];
+  input.blockOwnershipDefaults.forEach((raw, index) => {
+    if (!isRecord28(raw)) {
+      issues.push({ path: `block_ownership_defaults[${index}]`, message: "ownership default must be an object", context: {} });
+      return;
+    }
+    if (raw.block_id !== undefined) {
+      issues.push({
+        path: `block_ownership_defaults[${index}].block_id`,
+        message: "block_ownership_defaults entries must omit block_id; the CLI expands them across source blocks",
+        context: {}
+      });
+      return;
+    }
+    const sourceId = stringValue2(raw.source_id);
+    if (sourceId === undefined) {
+      issues.push({
+        path: `block_ownership_defaults[${index}].source_id`,
+        message: "source_id is required",
+        context: { availableBlockIds: input.coverableBlockIds }
+      });
+      return;
+    }
+    if (defaultsBySource.has(sourceId)) {
+      issues.push({
+        path: `block_ownership_defaults[${index}].source_id`,
+        message: `duplicate ownership default for source "${sourceId}"`,
+        context: { reasonCode: "duplicate-source-ownership-default" }
+      });
+      return;
+    }
+    defaultsBySource.add(sourceId);
+    const blockIds = blocksBySource.get(sourceId);
+    if (blockIds === undefined || blockIds.length === 0) {
+      issues.push({
+        path: `block_ownership_defaults[${index}].source_id`,
+        message: `source "${sourceId}" has no coverable blocks in this align-segments payload`,
+        context: {
+          reasonCode: "unknown-source-ownership-default",
+          availableBlockIds: input.coverableBlockIds
+        }
+      });
+      return;
+    }
+    for (const blockId2 of blockIds) {
+      if (explicitBlockIds.has(blockId2))
+        continue;
+      expanded.push({ ...raw, block_id: blockId2 });
+    }
+  });
+  if (issues.length > 0)
+    throwStructureIssues(issues);
+  return [...expanded, ...input.blockOwnership];
+}
 function normalizeOwnership(value, refs, slugs, coverableBlockIds) {
   if (!Array.isArray(value))
     throwStructureIssues([{
@@ -57770,22 +58209,47 @@ function setRef(map, ref, slug, path8) {
   }
   map.set(ref, slug);
 }
-function refMap(nodes) {
+function refMap(nodes, previous) {
   const map = new Map;
   const slugs = new Set;
+  const currentSlugs = new Set;
+  for (const node2 of previous?.nodes ?? []) {
+    slugs.add(node2.slug);
+    setRef(map, node2.slug, node2.slug, "previous.nodes[].slug");
+  }
   for (const node2 of nodes) {
-    if (slugs.has(node2.slug)) {
+    if (currentSlugs.has(node2.slug)) {
       reject3("nodes[].slug", `duplicate node slug "${node2.slug}"`, {
         reasonCode: "duplicate-node-slug",
-        availableNodeSlugs: [...slugs]
+        availableNodeSlugs: [...slugs, node2.slug]
       });
     }
+    currentSlugs.add(node2.slug);
+    if (slugs.has(node2.slug)) {
+      const existingType = previous?.nodes?.find((candidate) => candidate.slug === node2.slug)?.type;
+      if (existingType === undefined) {
+        reject3("nodes[].slug", `duplicate node slug "${node2.slug}"`, {
+          reasonCode: "duplicate-node-slug",
+          availableNodeSlugs: [...slugs]
+        });
+      }
+    }
     slugs.add(node2.slug);
     setRef(map, node2.slug, node2.slug, "nodes[].slug");
     setRef(map, node2.llm_slug_hint, node2.slug, "nodes[].llm_slug_hint");
   }
   return map;
 }
+function previousNodeTypes(previous) {
+  const types4 = new Map;
+  for (const node2 of previous?.removed_nodes ?? []) {
+    types4.set(node2.slug, node2.type);
+  }
+  for (const node2 of previous?.nodes ?? []) {
+    types4.set(node2.slug, node2.type);
+  }
+  return types4;
+}
 function resolveRef2(refs, value, path8) {
   if (value === null || value === undefined)
     return value;
@@ -57800,6 +58264,9 @@ function resolveRef2(refs, value, path8) {
   }
   return resolved;
 }
+function nodeRefsForSlugs(refs, slugs) {
+  return [...refs.entries()].filter(([, slug]) => slugs.has(slug)).map(([ref]) => ref).sort();
+}
 function parseNodes(value) {
   if (!Array.isArray(value))
     reject3("nodes", "nodes must be an array");
@@ -57906,8 +58373,7 @@ function downgradeNode(node2, warningKind, reason) {
     }
   };
 }
-function normalizeNodes(nodes, refs) {
-  const slugs = new Set(nodes.map((node2) => node2.slug));
+function normalizeNodes(nodes, refs, allSlugs, previousTypes) {
   const warnings = [];
   const normalized = nodes.map((node2, index) => {
     const parent = resolveRef2(refs, node2.contains_parent_ref ?? node2.contains_parent, `nodes[${index}].contains_parent_ref`);
@@ -57915,21 +58381,40 @@ function normalizeNodes(nodes, refs) {
       ...node2,
       ...parent !== undefined ? { contains_parent: parent } : {}
     };
-    if (next.contains_parent !== null && next.contains_parent !== undefined && !slugs.has(next.contains_parent)) {
+    if (next.contains_parent !== null && next.contains_parent !== undefined && !allSlugs.has(next.contains_parent)) {
       reject3(`nodes[${index}].contains_parent`, "contains_parent must reference a finalized node", {
         reasonCode: "unknown-finalized-parent",
         availableNodeRefs: nodeRefsForHint(refs),
-        availableNodeSlugs: [...slugs]
+        availableNodeSlugs: [...allSlugs]
       });
     }
     if (next.node_type === "domain") {
       const gate = next.domain_gate;
-      const childRefs = gate?.child_refs ?? [];
-      const validGate = gate !== undefined && Array.isArray(gate.scope_blocks) && Array.isArray(childRefs) && typeof gate.grouping_reason === "string" && childRefs.every((ref) => refs.has(ref) || slugs.has(ref));
+      const rawChildRefs = Array.isArray(gate?.child_refs) ? gate.child_refs : undefined;
+      const childRefs = rawChildRefs?.map((ref) => typeof ref === "string" ? ref.trim() : "") ?? [];
+      const validGate = gate !== undefined && Array.isArray(gate.scope_blocks) && rawChildRefs !== undefined && typeof gate.grouping_reason === "string" && childRefs.length === rawChildRefs.length && childRefs.every((ref) => ref.length > 0 && (refs.has(ref) || allSlugs.has(ref)));
       if (!validGate) {
         const downgraded = downgradeNode(next, "domain_downgrade", "domain_gate is missing or references unresolved child refs");
         next = downgraded.node;
         warnings.push(downgraded.warning);
+      } else {
+        const canonicalChildRefs = childRefs.map((ref) => refs.get(ref) ?? ref);
+        const duplicateChildRef = canonicalChildRefs.find((ref, refIndex) => canonicalChildRefs.indexOf(ref) !== refIndex);
+        if (duplicateChildRef !== undefined) {
+          reject3(`nodes[${index}].domain_gate.child_refs`, `domain_gate.child_refs contains duplicate child "${duplicateChildRef}"`, {
+            reasonCode: "duplicate-domain-child-ref",
+            failedRef: duplicateChildRef,
+            availableNodeRefs: nodeRefsForHint(refs),
+            availableNodeSlugs: [...allSlugs]
+          });
+        }
+        next = {
+          ...next,
+          domain_gate: {
+            ...gate,
+            child_refs: canonicalChildRefs
+          }
+        };
       }
     }
     if (next.node_type === "action") {
@@ -57945,6 +58430,14 @@ function normalizeNodes(nodes, refs) {
         validateInferenceSources(gate, `nodes[${index}].action_gate`);
       }
     }
+    const previousType = previousTypes.get(next.slug);
+    if (previousType !== undefined && previousType !== next.node_type) {
+      reject3(`nodes[${index}].node_type`, `existing node "${next.slug}" is already ${previousType}; align finalize cannot change it to ${next.node_type}`, {
+        reasonCode: "existing-node-type-drift",
+        availableNodeRefs: nodeRefsForHint(refs),
+        availableNodeSlugs: [...allSlugs]
+      });
+    }
     const plannedSections = next.planned_sections ?? [];
     for (const issue of alignStructureNodeConstraintIssues({ node: next, nodeIndex: index })) {
       reject3(issue.path, issue.message, { reasonCode: issue.code });
@@ -57973,11 +58466,18 @@ function hydrateActionProbesFromLedger(nodes, input) {
     return actionProbe !== undefined ? { ...node2, action_probe: actionProbe } : node2;
   });
 }
-function assertNoContainsCycles(nodes, refs) {
+function assertNoContainsCycles(nodes, refs, previous) {
   const parentBySlug = new Map;
+  for (const node2 of previous?.nodes ?? []) {
+    if (typeof node2.contains_parent === "string" && node2.contains_parent.length > 0) {
+      parentBySlug.set(node2.slug, node2.contains_parent);
+    }
+  }
   nodes.forEach((node2) => {
     if (typeof node2.contains_parent === "string" && node2.contains_parent.length > 0) {
       parentBySlug.set(node2.slug, node2.contains_parent);
+    } else {
+      parentBySlug.delete(node2.slug);
     }
   });
   nodes.forEach((node2, index) => {
@@ -57989,7 +58489,7 @@ function assertNoContainsCycles(nodes, refs) {
           reasonCode: "contains-parent-cycle",
           failedRef: current,
           availableNodeRefs: nodeRefsForHint(refs),
-          availableNodeSlugs: nodes.map((candidate) => candidate.slug)
+          availableNodeSlugs: nodeSlugsForHint(refs)
         });
       }
       seen.add(current);
@@ -57997,18 +58497,30 @@ function assertNoContainsCycles(nodes, refs) {
     }
   });
 }
-function normalizeSections(value, refs, slugs) {
+function normalizeSections(value, refs, currentSlugs) {
   if (!Array.isArray(value))
     reject3("sections", "sections must be an array");
+  const currentRefs = nodeRefsForSlugs(refs, currentSlugs);
   return value.map((raw, index) => {
     if (!isRecord28(raw))
       reject3(`sections[${index}]`, "section must be an object");
-    const owner = resolveNodeRef(refs, stringValue2(raw.owner), `sections[${index}].owner`);
-    if (!owner || !slugs.has(owner)) {
-      reject3(`sections[${index}].owner`, "owner must reference a finalized node", {
-        reasonCode: "unknown-section-owner",
-        availableNodeRefs: nodeRefsForHint(refs),
-        availableNodeSlugs: [...slugs]
+    const rawOwner = stringValue2(raw.owner);
+    if (rawOwner === undefined)
+      reject3(`sections[${index}].owner`, `sections[${index}].owner is required`);
+    const owner = refs.get(rawOwner);
+    if (owner === undefined) {
+      reject3(`sections[${index}].owner`, `sections[${index}].owner references unknown node "${rawOwner}"`, {
+        reasonCode: "unknown-node-ref",
+        failedRef: rawOwner,
+        availableNodeRefs: currentRefs,
+        availableNodeSlugs: [...currentSlugs]
+      });
+    }
+    if (!owner || !currentSlugs.has(owner)) {
+      reject3(`sections[${index}].owner`, "owner must reference a node declared in this align-structure-decision payload", {
+        reasonCode: "section-owner-not-current-node",
+        availableNodeRefs: currentRefs,
+        availableNodeSlugs: [...currentSlugs]
       });
     }
     const rationale = stringValue2(raw.rationale);
@@ -58074,12 +58586,18 @@ function normalizeAlignStructureDecision(input) {
     });
   }
   const parsedNodes = hydrateActionProbesFromLedger(parseNodes(input.payload.nodes), input);
-  const refs = refMap(parsedNodes);
-  const normalizedNodes = normalizeNodes(parsedNodes, refs);
-  const slugs = new Set(normalizedNodes.nodes.map((node2) => node2.slug));
-  assertNoContainsCycles(normalizedNodes.nodes, refs);
-  const sections = normalizeSections(input.payload.sections, refs, slugs);
-  const edges = normalizeEdges(input.payload.edges, refs, slugs);
+  const previousForRefs = input.allowExistingNodeRefs === true ? input.previousOwnership : undefined;
+  const refs = refMap(parsedNodes, previousForRefs);
+  const previousTypes = previousNodeTypes(input.previousOwnership);
+  const currentSlugs = new Set(parsedNodes.map((node2) => node2.slug));
+  const allSlugs = new Set([
+    ...currentSlugs,
+    ...input.allowExistingNodeRefs === true ? (input.previousOwnership?.nodes ?? []).map((node2) => node2.slug) : []
+  ]);
+  const normalizedNodes = normalizeNodes(parsedNodes, refs, allSlugs, previousTypes);
+  assertNoContainsCycles(normalizedNodes.nodes, refs, input.previousOwnership);
+  const sections = normalizeSections(input.payload.sections, refs, currentSlugs);
+  const edges = normalizeEdges(input.payload.edges, refs, allSlugs);
   validateStructureEvidence({
     nodes: normalizedNodes.nodes,
     sections,
@@ -58087,7 +58605,13 @@ function normalizeAlignStructureDecision(input) {
     coverableBlockIds: input.coverableBlockIds,
     reject: reject3
   });
-  const blockOwnership = normalizeOwnership(input.payload.block_ownership, refs, slugs, input.coverableBlockIds);
+  const ownershipInput = expandOwnershipDefaults({
+    blockOwnership: input.payload.block_ownership,
+    blockOwnershipDefaults: input.payload.block_ownership_defaults,
+    coverableBlockIds: input.coverableBlockIds,
+    ...input.coverableBlocks !== undefined ? { coverableBlocks: input.coverableBlocks } : {}
+  });
+  const blockOwnership = normalizeOwnership(ownershipInput, refs, allSlugs, input.coverableBlockIds);
   const unresolved = normalizeUnresolved(input.payload.unresolved);
   validateUnresolvedQuestions({ blockOwnership, unresolved, reject: reject3 });
   const artifactKind = stringValue2(input.payload.artifact_kind);
@@ -58225,18 +58749,27 @@ async function finalizeAlignStructureDecisionCommand(input) {
     digest: input.workflowState.input_digests["align-candidate-ledger"],
     workflowInputDigests: input.workflowState.input_digests
   })).value : undefined;
+  const previousOwnership = await readCurrentSourceOwnership(input.ctxDir);
+  const isIncrementalFinalize = segments.incremental.mode === "incremental";
   const rawDecision = await readStructuredInput2(finalizePath);
+  const coverableBlockSet = new Set(segments.coverage.coverable_block_ids);
   const decision = normalizeAlignStructureDecision({
     payload: rawDecision,
     coverableBlockIds: segments.coverage.coverable_block_ids,
-    ...candidateLedger !== undefined ? { candidateLedger } : {}
+    coverableBlocks: segments.sources.flatMap((source2) => source2.blocks.filter((block) => coverableBlockSet.has(block.block_id)).map((block) => ({ block_id: block.block_id, source_id: source2.source_id }))),
+    ...candidateLedger !== undefined ? { candidateLedger } : {},
+    ...previousOwnership !== null ? { previousOwnership } : {},
+    allowExistingNodeRefs: isIncrementalFinalize
   });
-  const previousOwnership = await readCurrentSourceOwnership(input.ctxDir);
-  const ownership = buildSourceOwnershipFromFinalized({
+  const currentOwnership = buildSourceOwnershipFromFinalized({
     segments,
     decision,
     now: new Date
   });
+  const ownership = isIncrementalFinalize && previousOwnership !== null ? mergeIncrementalSourceOwnership({
+    previous: previousOwnership,
+    current: currentOwnership
+  }) : currentOwnership;
   const citationIssues = alignFinalizeConstraintIssues({ ownership });
   if (citationIssues.length > 0) {
     throw new ContextError(ExitCode.UserError, `align finalize rejected ${citationIssues.length} Node(s) without citation-eligible owned/shared-primary evidence`, {
@@ -58277,7 +58810,8 @@ async function finalizeAlignStructureDecisionCommand(input) {
   const removedNodes = finalizedRemovedNodes({
     previous: previousOwnership,
     next: ownership,
-    workflowState
+    workflowState,
+    mode: segments.incremental.mode
   });
   const publishedOwnership = {
     ...ownership,
@@ -58364,6 +58898,8 @@ async function finalizeAlignStructureDecisionCommand(input) {
 function finalizedRemovedNodes(input) {
   const nextSlugs = new Set((input.next.nodes ?? []).map((node2) => node2.slug));
   const carried = (input.previous?.removed_nodes ?? []).filter((node2) => !nextSlugs.has(node2.slug));
+  if (input.mode === "incremental")
+    return carried.sort((left, right) => left.slug.localeCompare(right.slug));
   const carriedSlugs = new Set(carried.map((node2) => node2.slug));
   const newlyRemoved = (input.previous?.nodes ?? []).filter((node2) => !nextSlugs.has(node2.slug) && !carriedSlugs.has(node2.slug)).map((node2) => ({
     slug: node2.slug,
@@ -58910,6 +59446,25 @@ async function runAlignCoarseReadCommand(input) {
     value: coarseRead,
     format: "yaml"
   });
+  const previousLedger = await readExistingLedger({
+    ctxDir: input.ctxDir,
+    workflowState: input.workflowState
+  });
+  const ledger = upsertSourceReading({
+    ...previousLedger !== undefined ? { ledger: previousLedger } : {},
+    sourceId: coarseRead.source_id,
+    segmentsDigest,
+    coarseReadDigest: payloadRecord.digest,
+    coarseRead
+  });
+  const ledgerRecord = await writeWorkflowPayloadWithDigest({
+    ctxDir: input.ctxDir,
+    workflowId: input.workflowState.workflow_id,
+    scopeId: workflowScope(input.workflowState),
+    payload: "align-candidate-ledger",
+    value: ledger,
+    format: "json"
+  });
   const workflowState = await advanceCurrentWorkflow({
     ctxDir: input.ctxDir,
     family: "align",
@@ -58917,17 +59472,37 @@ async function runAlignCoarseReadCommand(input) {
     scopeId: workflowScope(input.workflowState),
     inputDigests: {
       ...input.workflowState.input_digests,
-      "align-coarse-read": payloadRecord.digest
+      "align-coarse-read": payloadRecord.digest,
+      "align-candidate-ledger": ledgerRecord.digest
     }
   });
   const payloadReceipt = workflowPayloadReceipt(payloadRecord, {
     nextCommand: "context align --ops -"
   });
+  const ledgerReceipt = workflowPayloadReceipt(ledgerRecord, {
+    view: ["--view ledger"],
+    nextCommand: "context align --ops -"
+  });
+  const sourceId = coarseRead.source_id;
+  const sourceReadingShowCommand = workflowPayloadShowCommand(ledgerRecord, [
+    `--view ledger --source ${shellQuote(sourceId)}`,
+    "--unwrap",
+    "--format json"
+  ]);
   if (input.format === "json") {
     writeJson3({
       action: "coarse-read-saved",
       workflow: workflowMetadata(workflowState),
       payload: payloadReceipt,
+      ledger: ledgerReceipt,
+      source_reading: {
+        source_id: sourceId,
+        show_command: sourceReadingShowCommand
+      },
+      summary: {
+        source_readings: (ledger.source_readings ?? []).length,
+        source_id: sourceId
+      },
       next: "produce candidate ops with context align --ops -"
     });
     return;
@@ -58940,7 +59515,9 @@ async function runAlignCoarseReadCommand(input) {
     body: [
       workflowSummaryLine(workflowState),
       `digest: ${payloadRecord.digest}`,
-      `show: ${workflowPayloadShowCommand(payloadRecord)}`
+      `show: ${workflowPayloadShowCommand(payloadRecord)}`,
+      `candidate ledger: ${ledgerReceipt.show_command}`,
+      `source reading: ${sourceReadingShowCommand}`
     ],
     next: "produce candidate ops with context align --ops -"
   }));
@@ -59341,9 +59918,11 @@ function collectRequestedBlock(value, previous) {
 function ignoredSourceIds(value) {
   return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.length > 0) : [];
 }
-function coverageSkipMissingOptionsError(missingFields) {
+function coverageSkipMissingOptionsError(missingFields, mode = "single") {
+  const flag = mode === "bulk" ? "--coverage-skip-unresolved" : "--coverage-skip";
+  const command = mode === "bulk" ? 'context compile --coverage-skip-unresolved --coverage-disposition-node <slug> --payload-digest <digest> --reason "<reason>"' : 'context compile --coverage-skip <candidate-id> --coverage-disposition-node <slug> --payload-digest <digest> --reason "<reason>"';
   const reasonOnly = missingFields.length === 1 && missingFields[0] === "--reason <text>";
-  const message = reasonOnly ? "--coverage-skip requires --reason <text>" : `--coverage-skip is missing required option(s): ${missingFields.join(", ")}`;
+  const message = reasonOnly ? `${flag} requires --reason <text>` : `${flag} is missing required option(s): ${missingFields.join(", ")}`;
   return new ContextError(ExitCode.UserError, message, {
     category: ErrorCategory.UserInputInvalid,
     missing_fields: missingFields,
@@ -59351,8 +59930,8 @@ function coverageSkipMissingOptionsError(missingFields) {
       code: reasonOnly ? "coverage-skip-reason-required" : "coverage-skip-required-options",
       severity: "error",
       message: reasonOnly ? "Skipping coverage requires a reason for auditability." : "Coverage skip needs every non-inferable option in one retry.",
-      next_action: "Retry with the candidate id, node, payload digest, and audit reason in one command.",
-      command: 'context compile --coverage-skip <candidate-id> --coverage-disposition-node <slug> --payload-digest <digest> --reason "<reason>"',
+      next_action: mode === "single" ? "Retry with the candidate id, node, payload digest, and audit reason in one command." : "Retry with the node, payload digest, and audit reason in one command.",
+      command,
       diagnostics: { missing_fields: missingFields }
     }]
   });
@@ -59362,7 +59941,7 @@ function compileStageForOptions(options) {
     return "node_draft_ready";
   if (typeof options.context === "string")
     return "node_context_ready";
-  if (typeof options.coverageDisposition === "string" || typeof options.coverageSkip === "string")
+  if (typeof options.coverageDisposition === "string" || typeof options.coverageSkip === "string" || options.coverageSkipUnresolved === true)
     return null;
   if (typeof options.draft === "string")
     return "node_draft_ready";
@@ -59407,7 +59986,7 @@ async function writeCompileDraftChallengePayloads2(input) {
 function registerWorkflowCommands(program2) {
   registerWorkflowStateCommands(program2);
   registerAlignWorkflowCommand(program2);
-  program2.command("compile").description("Workflow helpers for /context:compile").option("--scan-changes", "print incremental compile workset without creating a workflow lock").addOption(new Option("--scan", "removed; use --scan-changes").hideHelp()).option("--format <format>", "with --scan-changes/--context/--source-refs, output format: json | table", "table").option("--view <view>", "compact output view: full | summary | source-refs | issues").option("--ignore-source <source-id>", "with --scan-changes, --context, or --source-refs, ignore refresh-applied source ids", collectIgnoredSource, []).option("--context <slug>", "prepare NodeContext payload for one align node and print summary/digests").option("--source-refs <slug>", "print compact citation source_ref list for one align node").option("--request-full-text <block-id>", "with --context, expand one secondary shared finalized ownership block", collectRequestedBlock, []).option("--node-cycle <slug>", "validate one node draft, prepare reconcile, review safe defaults, and apply in one command").option("--draft <slug>", "validate a compile draft JSON/YAML document from stdin for one node").option("--prepare", "with --draft --plan, also prepare the semantic reconcile payload").option("--draft-status <slug>", "print the current compile draft session summary").option("--draft-patch <slug>", "apply a compile draft patch for one node").option("--input <stdin>", "compile draft JSON/YAML document used with --draft; use '-' for stdin").option("--accept-safe-defaults", "with --node-cycle, accept mechanically safe defaults and stop if anything needs judgment").option("--coverage-disposition <stdin>", "coverage disposition patch JSON/YAML document; use '-' for stdin").option("--coverage-skip <candidate-id>", "skip one coverage candidate without writing a disposition file").option("--coverage-disposition-node <slug>", "node slug for --coverage-disposition").option("--coverage-disposition-replace", "replace existing dispositions for the patched coverage candidates").option("--payload-digest <digest>", "expected workflow payload digest for write commands").option("--reason <text>", "reason for --coverage-skip").option("--plan", "validate the draft without writing knowledge").option("--close", "run compile close: compact, rebuild index, append changelog, verify").option("--save-input", "with --draft, save the consumed draft under output/compile/compile.<slug>.draft.yaml").action(async (options) => {
+  program2.command("compile").description("Workflow helpers for /context:compile").option("--scan-changes", "print incremental compile workset without creating a workflow lock").addOption(new Option("--scan", "removed; use --scan-changes").hideHelp()).option("--format <format>", "with --scan-changes/--context/--source-refs, output format: json | table", "table").option("--view <view>", "compact output view: full | summary | source-refs | issues").option("--ignore-source <source-id>", "with --scan-changes, --context, or --source-refs, ignore refresh-applied source ids", collectIgnoredSource, []).option("--context <slug>", "prepare NodeContext payload for one align node and print summary/digests").option("--source-refs <slug>", "print compact citation source_ref list for one align node").option("--request-full-text <block-id>", "with --context, expand one secondary shared finalized ownership block", collectRequestedBlock, []).option("--node-cycle <slug>", "validate one node draft, prepare reconcile, review safe defaults, and apply in one command").option("--draft <slug>", "validate a compile draft JSON/YAML document from stdin for one node").option("--prepare", "with --draft --plan, also prepare the semantic reconcile payload").option("--draft-status <slug>", "print the current compile draft session summary").option("--draft-patch <slug>", "apply a compile draft patch for one node").option("--input <stdin>", "compile draft JSON/YAML document used with --draft; use '-' for stdin").option("--accept-safe-defaults", "with --node-cycle, accept mechanically safe defaults and stop if anything needs judgment").option("--coverage-disposition <stdin>", "coverage disposition patch JSON/YAML document; use '-' for stdin").option("--coverage-skip <candidate-id>", "skip one coverage candidate without writing a disposition file").option("--coverage-skip-unresolved", "skip every unresolved coverage candidate in the node payload").option("--coverage-disposition-node <slug>", "node slug for --coverage-disposition").option("--coverage-disposition-replace", "replace existing dispositions for the patched coverage candidates").option("--payload-digest <digest>", "expected workflow payload digest for write commands").option("--reason <text>", "reason for coverage skip shortcuts").option("--plan", "validate the draft without writing knowledge").option("--close", "run compile close: compact, rebuild index, append changelog, verify").option("--save-input", "with --draft, save the consumed draft under output/compile/compile.<slug>.draft.yaml").action(async (options) => {
     if (options.scan === true) {
       throw new ContextError(ExitCode.UserError, "context compile --scan was removed; use context compile --scan-changes", {
         category: ErrorCategory.UserInputInvalid,
@@ -59421,9 +60000,9 @@ function registerWorkflowCommands(program2) {
       });
     }
     const wantsChanges = options.scanChanges === true;
-    const actionCount = countActions(wantsChanges, typeof options.context === "string", typeof options.sourceRefs === "string", typeof options.nodeCycle === "string", typeof options.draft === "string", typeof options.draftStatus === "string", typeof options.draftPatch === "string", typeof options.coverageDisposition === "string", typeof options.coverageSkip === "string", options.close === true);
+    const actionCount = countActions(wantsChanges, typeof options.context === "string", typeof options.sourceRefs === "string", typeof options.nodeCycle === "string", typeof options.draft === "string", typeof options.draftStatus === "string", typeof options.draftPatch === "string", typeof options.coverageDisposition === "string", typeof options.coverageSkip === "string", options.coverageSkipUnresolved === true, options.close === true);
     if (actionCount !== 1) {
-      throw new ContextError(ExitCode.UserError, "usage: context compile --scan-changes [--format json|table] [--ignore-source <source-id>...] | --context <slug> [--request-full-text <block-id>...] [--ignore-source <source-id>...] | --source-refs <slug> [--format json|table] | --node-cycle <slug> --input - --accept-safe-defaults [--format json|table] | --draft <slug> --input - --plan [--prepare] | --draft-status <slug> [--format json|table] | --draft-patch <slug> --input - --payload-digest <digest> --plan | --coverage-disposition - --coverage-disposition-node <slug> --payload-digest <digest> [--coverage-disposition-replace] | --coverage-skip <candidate-id> --coverage-disposition-node <slug> --payload-digest <digest> --reason <text> | --close", { category: ErrorCategory.UserInputInvalid });
+      throw new ContextError(ExitCode.UserError, "usage: context compile --scan-changes [--format json|table] [--ignore-source <source-id>...] | --context <slug> [--request-full-text <block-id>...] [--ignore-source <source-id>...] | --source-refs <slug> [--format json|table] | --node-cycle <slug> --input - --accept-safe-defaults [--format json|table] | --draft <slug> --input - --plan [--prepare] | --draft-status <slug> [--format json|table] | --draft-patch <slug> --input - --payload-digest <digest> --plan | --coverage-disposition - --coverage-disposition-node <slug> --payload-digest <digest> [--coverage-disposition-replace] | --coverage-skip <candidate-id> --coverage-disposition-node <slug> --payload-digest <digest> --reason <text> | --coverage-skip-unresolved --coverage-disposition-node <slug> --payload-digest <digest> --reason <text> | --close", { category: ErrorCategory.UserInputInvalid });
     }
     const viewWasExplicit = typeof options.view === "string";
     const view = compileOutputView(options.view);
@@ -59670,20 +60249,22 @@ function registerWorkflowCommands(program2) {
           });
           return;
         }
-        if (typeof options.coverageDisposition === "string" || typeof options.coverageSkip === "string") {
+        if (typeof options.coverageDisposition === "string" || typeof options.coverageSkip === "string" || options.coverageSkipUnresolved === true) {
           const currentRead = await readCurrentWorkflow(ctx.ctxDir);
-          if (typeof options.coverageSkip === "string" && currentRead.status !== "ready") {
+          const coverageSkipMode = options.coverageSkipUnresolved === true ? "bulk" : "single";
+          const wantsCoverageSkip = typeof options.coverageSkip === "string" || options.coverageSkipUnresolved === true;
+          if (wantsCoverageSkip && currentRead.status !== "ready") {
             const missingFields = [
               ...typeof options.coverageDispositionNode === "string" ? [] : ["--coverage-disposition-node <slug>"],
               ...typeof options.payloadDigest === "string" ? [] : ["--payload-digest <digest>"],
               ...typeof options.reason === "string" && options.reason.trim().length > 0 ? [] : ["--reason <text>"]
             ];
             if (missingFields.length > 0)
-              throw coverageSkipMissingOptionsError(missingFields);
+              throw coverageSkipMissingOptionsError(missingFields, coverageSkipMode);
           }
           const current = requireCurrentWorkflow(currentRead);
-          if (typeof options.coverageSkip === "string" && (typeof options.reason !== "string" || options.reason.trim().length === 0)) {
-            throw coverageSkipMissingOptionsError(["--reason <text>"]);
+          if (wantsCoverageSkip && (typeof options.reason !== "string" || options.reason.trim().length === 0)) {
+            throw coverageSkipMissingOptionsError(["--reason <text>"], coverageSkipMode);
           }
           const requestedNode = typeof options.coverageDispositionNode === "string" ? options.coverageDispositionNode : undefined;
           const requestedDigest = typeof options.payloadDigest === "string" ? options.payloadDigest : undefined;
@@ -59703,8 +60284,9 @@ function registerWorkflowCommands(program2) {
             inferred.push(`payload digest: ${payload.digest}`);
           const value = payload.value;
           const candidates = Array.isArray(value.candidates) ? value.candidates : [];
-          const patchInput = typeof options.coverageSkip === "string" ? coverageSkipPatch({ candidateId: options.coverageSkip, reason: String(options.reason).trim() }) : await readStructuredInput2(resolveStdinOnlyInput(options.coverageDisposition, "--coverage-disposition"));
+          const patchInput = typeof options.coverageSkip === "string" ? coverageSkipPatch({ candidateId: options.coverageSkip, reason: String(options.reason).trim() }) : options.coverageSkipUnresolved === true ? coverageSkipUnresolvedPatch({ candidates, reason: String(options.reason).trim() }) : await readStructuredInput2(resolveStdinOnlyInput(options.coverageDisposition, "--coverage-disposition"));
           const patch = await validateCoverageDispositions({ ctxDir: ctx.ctxDir, candidates, patch: patchInput });
+          const skippedCount = patch.dispositions.filter((disposition2) => disposition2.action === "skip").length;
           const status = await applyCoverageDispositionPatch({
             ctxDir: ctx.ctxDir,
             candidates,
@@ -59713,8 +60295,8 @@ function registerWorkflowCommands(program2) {
           });
           process.stdout.write(formatFeedback({
             symbol: status.high_signal_unresolved > 0 ? "⚠" : "✓",
-            action: typeof options.coverageSkip === "string" ? "skipped" : "applied",
-            subject: typeof options.coverageSkip === "string" ? `coverage candidate ${options.coverageSkip}` : `coverage disposition ${options.coverageDispositionNode}`,
+            action: wantsCoverageSkip ? "skipped" : "applied",
+            subject: typeof options.coverageSkip === "string" ? `coverage candidate ${options.coverageSkip}` : options.coverageSkipUnresolved === true ? `${skippedCount} unresolved coverage candidate(s) for ${value.node ?? scopeId}` : `coverage disposition ${options.coverageDispositionNode}`,
             headline: formatCoverageSummary(status),
             body: [
               workflowSummaryLine(workflowState),
@@ -59903,7 +60485,7 @@ function registerWorkflowCommands(program2) {
 init_cliFeedback();
 init_errors();
 import { lstat as lstat3, readdir as readdir23 } from "node:fs/promises";
-import { isAbsolute as isAbsolute7, join as join57, relative as relative13, resolve as resolve11 } from "node:path";
+import { isAbsolute as isAbsolute7, join as join58, relative as relative13, resolve as resolve11 } from "node:path";
 
 // src/lib/pathFreeCommandMatrix.ts
 var COMMAND_MATRIX = [
@@ -60180,12 +60762,12 @@ async function debugSourceRawPath(ctx, options) {
 function workspaceStorageRoots(ctxDir) {
   return {
     ctxDir,
-    raw: join57(ctxDir, "raw"),
-    knowledge: join57(ctxDir, "knowledge"),
-    output: join57(ctxDir, "output"),
-    archive: join57(ctxDir, "archive"),
-    decisions: join57(ctxDir, "decisions"),
-    cache: join57(ctxDir, ".cache")
+    raw: join58(ctxDir, "raw"),
+    knowledge: join58(ctxDir, "knowledge"),
+    output: join58(ctxDir, "output"),
+    archive: join58(ctxDir, "archive"),
+    decisions: join58(ctxDir, "decisions"),
+    cache: join58(ctxDir, ".cache")
   };
 }
 async function debugWorkspaceLocate(ctx, options) {
@@ -60275,7 +60857,7 @@ async function knowledgeNodeTypeDirs(ctxDir) {
 async function inspectNodeObject(ctxDir, slug) {
   const typeDirs = await knowledgeNodeTypeDirs(ctxDir);
   const candidates = await Promise.all(typeDirs.map((type) => {
-    const relPath = join57("knowledge", type, `${slug}.md`);
+    const relPath = join58("knowledge", type, `${slug}.md`);
     return inspectWorkspacePath(ctxDir, relPath, relPath);
   }));
   return {
@@ -60291,7 +60873,7 @@ function safeArchiveSourceSegment(value) {
 async function inspectArchiveObject(ctx, archiveId) {
   const ctxDir = requireContext2(ctx, "debug storage inspect");
   const source2 = (ctx.sources?.sources ?? []).find((entry) => entry.id === archiveId);
-  const directRel = join57("archive", "sources", safeArchiveSourceSegment(archiveId));
+  const directRel = join58("archive", "sources", safeArchiveSourceSegment(archiveId));
   const paths = [
     ...source2?.archive_path !== undefined ? [await inspectWorkspacePath(ctxDir, source2.archive_path, "source.archive_path")] : [],
     await inspectWorkspacePath(ctxDir, directRel, directRel)
@@ -60339,7 +60921,7 @@ async function walkForFileName(root, fileName, out2 = []) {
     throw error;
   }
   for (const entry of entries) {
-    const child = join57(root, entry.name);
+    const child = join58(root, entry.name);
     if (entry.isDirectory()) {
       await walkForFileName(child, fileName, out2);
     } else if (entry.isFile() && entry.name === fileName) {
@@ -60349,7 +60931,7 @@ async function walkForFileName(root, fileName, out2 = []) {
   return out2;
 }
 async function inspectReviewObject(ctxDir, reviewId) {
-  const matches = await walkForFileName(join57(ctxDir, "output", "workflows"), `review.${reviewId}.yaml`);
+  const matches = await walkForFileName(join58(ctxDir, "output", "workflows"), `review.${reviewId}.yaml`);
   return {
     object: `review:${reviewId}`,
     kind: "review",
@@ -60359,14 +60941,14 @@ async function inspectReviewObject(ctxDir, reviewId) {
 }
 async function inspectWorkflowObject(ctxDir, workflowId) {
   const current = await readCurrentWorkflow(ctxDir);
-  const workflowRoot = workspacePath(ctxDir, join57("output", "workflows", safePathSegment2(workflowId)), "workflow output root");
+  const workflowRoot = workspacePath(ctxDir, join58("output", "workflows", safePathSegment2(workflowId)), "workflow output root");
   const currentMatches = current.status === "ready" && current.state.workflow_id === workflowId;
   return {
     object: `workflow:${workflowId}`,
     kind: "workflow",
     paths: [
       await inspectPath(workflowRoot, "workflow_output_root"),
-      ...currentMatches ? [await inspectWorkspacePath(ctxDir, join57(".cache", "workflows", "current.yaml"), "current_workflow_state")] : []
+      ...currentMatches ? [await inspectWorkspacePath(ctxDir, join58(".cache", "workflows", "current.yaml"), "current_workflow_state")] : []
     ],
     current_workflow_state: current.status === "ready" ? {
       status: currentMatches ? "matches-query" : "latest-singleton-different-workflow",
@@ -60513,10 +61095,10 @@ async function buildDebugSnapshot(ctx) {
       manifest: cache.manifest
     },
     counts: {
-      raw_entries: await countDirectEntries(join57(ctxDir, "raw")),
-      knowledge_entries: await countDirectEntries(join57(ctxDir, "knowledge")),
-      output_entries: await countDirectEntries(join57(ctxDir, "output")),
-      archive_entries: await countDirectEntries(join57(ctxDir, "archive"))
+      raw_entries: await countDirectEntries(join58(ctxDir, "raw")),
+      knowledge_entries: await countDirectEntries(join58(ctxDir, "knowledge")),
+      output_entries: await countDirectEntries(join58(ctxDir, "output")),
+      archive_entries: await countDirectEntries(join58(ctxDir, "archive"))
     }
   };
 }
@@ -60590,11 +61172,11 @@ init_errors();
 init_cliFeedback();
 init_config();
 init_errors();
-import { join as join61 } from "node:path";
+import { join as join62 } from "node:path";
 
 // src/build/llms.ts
 import { writeFile as writeFile24 } from "node:fs/promises";
-import { join as join59 } from "node:path";
+import { join as join60 } from "node:path";
 
 // src/build/renderKnowledge.ts
 init_nodeRenderer();
@@ -60677,7 +61259,7 @@ init_nodeRenderer();
 init_exitCode();
 init_knowledge();
 import { mkdir as mkdir31 } from "node:fs/promises";
-import { join as join58 } from "node:path";
+import { join as join59 } from "node:path";
 var MAX_TIMESTAMP_COLLISION_ATTEMPTS = 60;
 var SUMMARY_MAX_LENGTH = 160;
 var NODE_TYPE_ORDER = [NodeType2.domain, NodeType2.entity, NodeType2.action];
@@ -60704,11 +61286,11 @@ function isFsCode(error, code) {
   return typeof error === "object" && error !== null && "code" in error && error.code === code;
 }
 async function createTimestampedPackageDir(outputRoot, packageName, now) {
-  const packageRoot = join58(outputRoot, packageName);
+  const packageRoot = join59(outputRoot, packageName);
   await mkdir31(packageRoot, { recursive: true });
   for (let offsetSeconds = 0;offsetSeconds < MAX_TIMESTAMP_COLLISION_ATTEMPTS; offsetSeconds += 1) {
     const candidateTime = new Date(now.getTime() + offsetSeconds * 1000);
-    const candidate = join58(packageRoot, formatBuildTimestamp(candidateTime));
+    const candidate = join59(packageRoot, formatBuildTimestamp(candidateTime));
     try {
       await mkdir31(candidate);
       return candidate;
@@ -60784,10 +61366,10 @@ function renderLlmsIndex(input) {
 }
 async function writeLlmsPackage(input) {
   const packageDir = await createTimestampedPackageDir(input.outputRoot, "llms-pkg", input.now);
-  await writeFile24(join59(packageDir, "llms.txt"), renderLlmsIndex(input), "utf8");
+  await writeFile24(join60(packageDir, "llms.txt"), renderLlmsIndex(input), "utf8");
   await Promise.all(input.nodes.map(async (node2) => {
     const parsed = node2.located.parsed.node;
-    await writeFile24(join59(packageDir, buildNodeFileName(parsed)), renderExportNodeMarkdown({ node: parsed, sections: node2.activeSections }), "utf8");
+    await writeFile24(join60(packageDir, buildNodeFileName(parsed)), renderExportNodeMarkdown({ node: parsed, sections: node2.activeSections }), "utf8");
   }));
   return {
     packageDir,
@@ -60797,7 +61379,7 @@ async function writeLlmsPackage(input) {
 
 // src/build/skillsPack.ts
 import { mkdir as mkdir32, writeFile as writeFile25 } from "node:fs/promises";
-import { join as join60 } from "node:path";
+import { join as join61 } from "node:path";
 var KNOWLEDGE_QUERY_PROCEDURE = [
   "1. For a named topic, read the matching wiki file directly from `wikis/`.",
   "2. For a broad question, grep `wikis/` with relevant keywords, then read the matching wiki files.",
@@ -60858,23 +61440,23 @@ function renderKnowledgeQuerySkill() {
 }
 async function writeSkillsPack(input) {
   const packageDir = await createTimestampedPackageDir(input.outputRoot, "skills-pkg", input.now);
-  const guidesDir = join60(packageDir, "guides");
-  const skillsDir = join60(packageDir, "skills");
-  const wikisDir = join60(packageDir, "wikis");
+  const guidesDir = join61(packageDir, "guides");
+  const skillsDir = join61(packageDir, "skills");
+  const wikisDir = join61(packageDir, "wikis");
   await Promise.all([
     mkdir32(guidesDir, { recursive: true }),
     mkdir32(skillsDir, { recursive: true }),
     mkdir32(wikisDir, { recursive: true }),
-    mkdir32(join60(packageDir, "rules"), { recursive: true }),
-    mkdir32(join60(packageDir, "integrations"), { recursive: true })
+    mkdir32(join61(packageDir, "rules"), { recursive: true }),
+    mkdir32(join61(packageDir, "integrations"), { recursive: true })
   ]);
   await Promise.all([
-    writeFile25(join60(guidesDir, "AGENTS.md"), renderAgentsGuide2(input), "utf8"),
-    writeFile25(join60(skillsDir, "knowledge-query.md"), renderKnowledgeQuerySkill(), "utf8")
+    writeFile25(join61(guidesDir, "AGENTS.md"), renderAgentsGuide2(input), "utf8"),
+    writeFile25(join61(skillsDir, "knowledge-query.md"), renderKnowledgeQuerySkill(), "utf8")
   ]);
   await Promise.all(input.nodes.map(async (node2) => {
     const parsed = node2.located.parsed.node;
-    await writeFile25(join60(wikisDir, buildNodeFileName(parsed)), renderExportNodeMarkdown({ node: parsed, sections: node2.activeSections }), "utf8");
+    await writeFile25(join61(wikisDir, buildNodeFileName(parsed)), renderExportNodeMarkdown({ node: parsed, sections: node2.activeSections }), "utf8");
   }));
   return {
     packageDir,
@@ -60956,7 +61538,7 @@ async function collectExportNodes(ctxDir) {
   return {
     config,
     nodes,
-    outputRoot: join61(ctxDir, "output")
+    outputRoot: join62(ctxDir, "output")
   };
 }
 async function buildKnowledgePackage(input) {
@@ -61248,8 +61830,9 @@ function reconcileSchemaExample(name) {
         "Do not use decisions: [] to accept all defaults; an empty decisions array means no decisions were made.",
         "Keep proposed.content short and single-line; put long prose, code fences, and extended examples in proposed.detail.",
         "Do not copy basis/evidence text into proposed.detail just to show the original raw text; source_ref/source_refs already provide traceability.",
+        "For kind=example, preserving the cited fenced code/config/command block in proposed.detail is active example detail, not raw-evidence echo.",
         'Use source_ref/source_refs copied from raw_snippets[].source_ref. Only run context source resolve-ref --node <slug> --text "<quote>" for manual recovery from a short quoted text fragment.',
-        "Only set decided_by: user after an actual user or tester confirmed the answer.",
+        "Only set decided_by: user after an actual user or tester confirmed the answer. Auto mode or broad permission to continue is not user confirmation; if no confirmation exists, fix/split evidence or leave ask_user unresolved.",
         "When prepare/review returns agent_hints[], follow those result-specific hints before retrying."
       ],
       example: {
@@ -61360,6 +61943,7 @@ function compileSchemaExample(name) {
         "Prefer content_mode=extract when the cited raw sentence already fits as a short single-line claim. Use minimal_paraphrase only when direct extract would violate the content contract or when consolidating multiple spans; paraphrase_reason defaults to summary when omitted.",
         "content must be a short single-line claim of 256 characters or fewer; put long prose, code fences, and extended examples in detail.",
         "detail may contain active knowledge such as code/config/example material that cannot fit in content; do not use detail as a raw evidence copy or prefix it with labels such as 原文. source_refs already trace the evidence.",
+        "For kind=example, preserving a cited fenced code/config/command block in detail is valid active example detail when the block is the knowledge users need to copy.",
         "source_refs is the only compile-draft citation input. For a single citation, use an array with one source_ref string.",
         "For dense raw material where one Section summarizes multiple contiguous blocks, provide all relevant source_refs. Contiguous means the selected source_refs resolve to consecutive evidence-manifest blocks from the same source, snapshot, and alias; if an intervening citation-eligible block is skipped, split the action or include that block's source_ref.",
         "If NodeContext only contains navigation or placeholder evidence (Parent/Children/Related/Relations, no detailed content), use op: skip; do not create a low-value description Section from those lines.",
@@ -61445,7 +62029,8 @@ function compileSchemaExample(name) {
       schema: "coverage-disposition",
       schema_version: COVERAGE_DISPOSITION_SCHEMA_VERSION,
       consumed_by: [
-        "context compile --coverage-disposition - --coverage-disposition-node <slug> --payload-digest <digest>"
+        "context compile --coverage-disposition - --coverage-disposition-node <slug> --payload-digest <digest>",
+        'context compile --coverage-skip-unresolved --coverage-disposition-node <slug> --payload-digest <digest> --reason "<reason>"'
       ],
       required: ["schema_version", "dispositions"],
       enums: {
@@ -61455,7 +62040,8 @@ function compileSchemaExample(name) {
         "Read node-scoped candidates with context workflow show --payload coverage-candidates --scope <node-run-scope> --view coverage.",
         "Use new_section when the candidate source_refs were covered by new draft Sections.",
         "Use merge_into_existing or covered_by_section only with target_section_id that mechanically covers the listed source_refs.",
-        "Use skip with a reason when the candidate is intentionally not written for this node. For skip only, source_refs may be omitted to dispose the whole candidate."
+        "Use skip with a reason when the candidate is intentionally not written for this node. For skip only, source_refs may be omitted to dispose the whole candidate.",
+        "When every unresolved candidate in the node payload has the same skip rationale, prefer --coverage-skip-unresolved over hand-writing one disposition per candidate."
       ],
       example: {
         schema_version: COVERAGE_DISPOSITION_SCHEMA_VERSION,
@@ -61566,8 +62152,8 @@ function readPackageVersion() {
   try {
     let dir = dirname28(fileURLToPath4(import.meta.url));
     for (let i = 0;i < 8; i++) {
-      const pkg = join62(dir, "package.json");
-      if (existsSync48(pkg)) {
+      const pkg = join63(dir, "package.json");
+      if (existsSync49(pkg)) {
         const parsed = JSON.parse(readFileSync3(pkg, "utf8"));
         return parsed.version ?? "unknown";
       }