@c4a/context-cli 0.5.29-beta.21 → 0.5.29-beta.22

package/cli.js

@@ -19189,6 +19189,65 @@ function parseOptionalCommentBlock(input) {
     after: trimBlankEdges(input.lines.slice(end + 1))
   };
 }
+function stripSummaryBlockquote(value) {
+  const lines = value.split(/\r?\n/u);
+  const allQuoted = lines.every((line) => {
+    const trimmed = line.trimStart();
+    return trimmed.length === 0 || trimmed.startsWith(">");
+  });
+  if (!allQuoted)
+    return value;
+  return lines.map((line) => {
+    const trimmed = line.trimStart();
+    if (!trimmed.startsWith(">"))
+      return "";
+    return trimmed.slice(1).replace(/^\s/u, "");
+  }).join(`
+`).trim();
+}
+function unescapeRawComment(value) {
+  return value.replace(/--\\>/gu, "-->");
+}
+function parseOptionalRawBlock(lines, sectionId) {
+  const hiddenStart = lines.findIndex((line) => RAW_OPEN_RE.test(line.trim()));
+  const hiddenEnd = lines.findIndex((line) => RAW_CLOSE_RE.test(line.trim()));
+  const legacyStart = lines.findIndex((line) => LEGACY_RAW_OPEN_RE.test(line.trim()));
+  const legacyEnd = lines.findIndex((line) => LEGACY_RAW_CLOSE_RE.test(line.trim()));
+  if (hiddenStart >= 0 && legacyStart >= 0) {
+    throw new Error(`section ${sectionId} must contain at most one c4a:raw block`);
+  }
+  if (hiddenStart < 0 && hiddenEnd >= 0) {
+    throw new Error(`section ${sectionId} has c4a:raw close without open`);
+  }
+  if (legacyStart < 0 && legacyEnd >= 0) {
+    throw new Error(`section ${sectionId} has raw close without open`);
+  }
+  if (hiddenStart >= 0 && hiddenEnd < 0) {
+    throw new Error(`section ${sectionId} is missing /c4a:raw`);
+  }
+  if (hiddenStart >= 0 && hiddenEnd < hiddenStart) {
+    throw new Error(`section ${sectionId} has /c4a:raw before c4a:raw`);
+  }
+  if (hiddenStart >= 0) {
+    const valueLines = trimBlankEdges(lines.slice(hiddenStart + 1, hiddenEnd));
+    if (valueLines.length === 0) {
+      throw new Error(`section ${sectionId} has empty c4a:raw`);
+    }
+    return {
+      value: unescapeRawComment(valueLines.join(`
+`).trim()),
+      before: trimBlankEdges(lines.slice(0, hiddenStart)),
+      after: trimBlankEdges(lines.slice(hiddenEnd + 1))
+    };
+  }
+  return parseOptionalCommentBlock({
+    lines,
+    sectionId,
+    name: "raw",
+    open: LEGACY_RAW_OPEN_RE,
+    close: LEGACY_RAW_CLOSE_RE
+  });
+}
 function parseSectionBody(lines, sectionId) {
   const summary = parseOptionalCommentBlock({
     lines,
@@ -19201,13 +19260,7 @@ function parseSectionBody(lines, sectionId) {
     throw new Error(`section ${sectionId} has content before c4a:summary`);
   }
   const afterSummary = summary.value !== undefined ? summary.after : summary.before;
-  const raw = parseOptionalCommentBlock({
-    lines: afterSummary,
-    sectionId,
-    name: "raw",
-    open: RAW_OPEN_RE,
-    close: RAW_CLOSE_RE
-  });
+  const raw = parseOptionalRawBlock(afterSummary, sectionId);
   if (raw.after.length > 0) {
     throw new Error(`section ${sectionId} has content after /c4a:raw`);
   }
@@ -19216,7 +19269,7 @@ function parseSectionBody(lines, sectionId) {
     throw new Error(`section ${sectionId} is missing content`);
   }
   return {
-    ...summary.value !== undefined ? { summary: summary.value } : {},
+    ...summary.value !== undefined ? { summary: stripSummaryBlockquote(summary.value) } : {},
     content: contentLines.join(`
 `).trim(),
     ...raw.value !== undefined ? { raw: raw.value } : {}
@@ -19287,7 +19340,7 @@ function parseSectionBlock(lines, startIndex, anchorSlug) {
   }
   return { section, nextIndex: index };
 }
-var SECTION_OPEN_RE, SECTION_CLOSE_RE, LEGACY_SECTION_OPEN_RE, SUMMARY_OPEN_RE, SUMMARY_CLOSE_RE, RAW_OPEN_RE, RAW_CLOSE_RE, RELATION_RE, ATTR_RE;
+var SECTION_OPEN_RE, SECTION_CLOSE_RE, LEGACY_SECTION_OPEN_RE, SUMMARY_OPEN_RE, SUMMARY_CLOSE_RE, RAW_OPEN_RE, RAW_CLOSE_RE, LEGACY_RAW_OPEN_RE, LEGACY_RAW_CLOSE_RE, RELATION_RE, ATTR_RE;
 var init_nodeParserSections = __esm(() => {
   init_knowledge();
   SECTION_OPEN_RE = /^<!--\s*c4a:section\b([\s\S]*?)\s*-->$/u;
@@ -19295,8 +19348,10 @@ var init_nodeParserSections = __esm(() => {
   LEGACY_SECTION_OPEN_RE = /^<!--\s*section-\d+\s+([A-Za-z_][\w-]*)\b[\s\S]*-->$/u;
   SUMMARY_OPEN_RE = /^<!--\s*c4a:summary\s*-->$/u;
   SUMMARY_CLOSE_RE = /^<!--\s*\/c4a:summary\s*-->$/u;
-  RAW_OPEN_RE = /^<!--\s*c4a:raw\s*-->$/u;
-  RAW_CLOSE_RE = /^<!--\s*\/c4a:raw\s*-->$/u;
+  RAW_OPEN_RE = /^<!--\s*c4a:raw\s*$/u;
+  RAW_CLOSE_RE = /^\/c4a:raw\s*-->$/u;
+  LEGACY_RAW_OPEN_RE = /^<!--\s*c4a:raw\s*-->$/u;
+  LEGACY_RAW_CLOSE_RE = /^<!--\s*\/c4a:raw\s*-->$/u;
   RELATION_RE = /^<!--\s*c4a:relation\b([\s\S]*?)\s*-->$/u;
   ATTR_RE = /([A-Za-z_][\w:-]*)="([^"]*)"/yu;
 });
@@ -19847,12 +19902,15 @@ function renderSectionComment(section) {
   return [head, ...relationLines].join(`
 `);
 }
+function renderSummaryText(value) {
+  return value.trim().split(/\r?\n/u).map((line) => line.trim().length > 0 ? `> ${line}` : ">").join(`
+`);
+}
 function renderSectionBody(section) {
   return [
     renderSectionComment(section),
-    ...section.summary !== undefined ? ["<!-- c4a:summary -->", section.summary.trim(), "<!-- /c4a:summary -->", ""] : [],
+    ...section.summary !== undefined ? ["<!-- c4a:summary -->", renderSummaryText(section.summary), "<!-- /c4a:summary -->", ""] : [],
     section.content.trim(),
-    ...section.raw !== undefined ? ["", "<!-- c4a:raw -->", section.raw.trim(), "<!-- /c4a:raw -->"] : [],
     "<!-- /c4a:section -->"
   ].join(`
 `);
@@ -27004,6 +27062,20 @@ async function readCurrentSourceOwnershipRecord(ctxDir) {
 async function readCurrentSourceOwnership(ctxDir) {
   return (await readCurrentSourceOwnershipRecord(ctxDir))?.ownership ?? null;
 }
+async function readFreshCurrentSourceOwnership(ctxDir) {
+  const ownership = await readCurrentSourceOwnership(ctxDir);
+  if (ownership === null)
+    return null;
+  const currentHashes = await latestSnapshotHashes(ctxDir);
+  const stale = staleOwnershipSourceIds(ownership, currentHashes);
+  if (stale.length === 0)
+    return ownership;
+  const refreshed = await refreshStaleSourceOwnership(ctxDir, ownership);
+  if (refreshed === null)
+    throw sourceOwnershipStaleError(stale);
+  await writeCurrentSourceOwnership(ctxDir, refreshed);
+  return refreshed;
+}
 function publishedSourceOwnershipSummary(record) {
   return {
     source: "finalized-ownership",
@@ -27155,18 +27227,9 @@ function sourceOwnershipStaleError(sourceIds) {
   });
 }
 async function assertNoUnownedSourceOwnership(ctxDir) {
-  let ownership = await readCurrentSourceOwnership(ctxDir);
+  const ownership = await readFreshCurrentSourceOwnership(ctxDir);
   if (ownership === null)
     return;
-  const currentHashes = await latestSnapshotHashes(ctxDir);
-  const stale = staleOwnershipSourceIds(ownership, currentHashes);
-  if (stale.length > 0) {
-    const refreshed = await refreshStaleSourceOwnership(ctxDir, ownership);
-    if (refreshed === null)
-      throw sourceOwnershipStaleError(stale);
-    ownership = refreshed;
-    await writeCurrentSourceOwnership(ctxDir, refreshed);
-  }
   const unowned = ownership.sources.flatMap((source2) => source2.blocks.filter((block) => block.status === "unowned" && block.reason !== "no-accepted-heading-owner-after-refresh").map((block) => `${source2.source_id}:${block.file}:L${block.line_start}-L${block.line_end}`));
   if (unowned.length === 0)
     return;
@@ -28550,6 +28613,29 @@ function pushNodeSourceStateIssues(node2, sourceStatuses, alignedPendingCompileS
     });
   }
 }
+function staleSourceSnapshot(input) {
+  const current = parseVersionedSourceId(input.sourceEntry).snapshotHash;
+  if (current === undefined || input.source === undefined)
+    return null;
+  const latest = selectLatestSnapshot(input.source.snapshots);
+  if (latest === null)
+    return null;
+  const latestHash = shortSnapshotHash(latest.content_hash);
+  return current === latestHash ? null : {
+    current_snapshot_hash: current,
+    latest_snapshot_hash: latestHash
+  };
+}
+function pushStaleSourceSnapshotIssue(input) {
+  input.issues.push({
+    severity: "error",
+    code: "stale-node-source-snapshot",
+    message: `section source_ref "${input.section.source_ref}" cannot resolve because node.sources[] points to stale snapshot "${input.sourceEntry}" (latest @${input.stale.latest_snapshot_hash})`,
+    path: input.node.relativePath,
+    slug: input.node.parsed.node.id,
+    sectionId: input.section.id
+  });
+}
 async function pushSectionReferenceIssues(input) {
   const { node: node2, section, issues } = input;
   for (const target of section.refers_to_nodes ?? []) {
@@ -28616,6 +28702,11 @@ async function pushSectionReferenceIssues(input) {
   const source2 = input.sourcesById.get(sourceId);
   if (source2?.status !== "active")
     return;
+  const stale = staleSourceSnapshot({ sourceEntry, source: source2 });
+  if (stale !== null) {
+    pushStaleSourceSnapshotIssue({ issues, node: node2, section, sourceEntry, stale });
+    return;
+  }
   const canonicalSourceRef = await canonicalizeHashedSourceRef({
     ctxDir: input.ctxDir,
     sourceRef: section.source_ref,
@@ -28979,8 +29070,7 @@ function hasUrlReferenceLabel(text) {
   return regexMatches(EN_URL_REFERENCE_LABEL_RE, text) || regexMatches(CJK_URL_REFERENCE_LABEL_RE, text);
 }
 function diagnoseUrlReferencePreservation(input) {
-  const proposedText = `${input.summary ?? ""}
-${input.content}
+  const proposedText = `${input.content}
 ${input.detail ?? ""}`;
   const citedUrls = evidenceUrlsIn(input.citedText);
   const proposedUrls = evidenceUrlsIn(proposedText);
@@ -29042,14 +29132,17 @@ function supportLexicalOverlap(content, citedText) {
   };
 }
 function hardTermPresent(term, citedText, citedHardTerms) {
-  if (citedHardTerms.has(term) || normalizedToken(citedText).includes(term))
+  const variants = uniqueSorted([term, term.replace(TRAILING_HARD_TERM_PUNCTUATION_RE, "")]);
+  if (variants.some((variant) => citedHardTerms.has(variant) || normalizedToken(citedText).includes(variant))) {
     return true;
+  }
   const normalizedCited = normalizedToken(citedText);
-  const slashParts = term.split("/").map(normalizedToken).filter((part) => part.length > 0);
+  const normalizedTerm = variants[0] ?? term;
+  const slashParts = normalizedTerm.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) : [];
+  const hyphenParts = normalizedTerm.includes("-") && !/[0-9._/:#]/u.test(normalizedTerm) ? normalizedTerm.split("-").map(normalizedToken).filter((part) => part.length > 1) : [];
   return hyphenParts.length > 1 && hyphenParts.every((part) => citedHardTerms.has(part) || normalizedCited.includes(part));
 }
 function thresholdsForKind(kind) {
@@ -29127,12 +29220,13 @@ function sourceTextSupportDiagnostic(content, citedText, thresholds = DEFAULT_TH
   };
 }
 function sourceSectionSupportDiagnostic(input) {
-  const summary = typeof input.summary === "string" ? input.summary.trim() : "";
   const detail = typeof input.detail === "string" ? input.detail.trim() : "";
-  const content = summary.length > 0 ? `${summary}
-${input.content}` : input.content;
+  const content = input.content;
   if (detail.length === 0) {
-    return sourceTextSupportDiagnostic(content, input.citedText, thresholdsForKind(input.kind));
+    return {
+      ...sourceTextSupportDiagnostic(content, input.citedText, thresholdsForKind(input.kind)),
+      checkedFields: ["content"]
+    };
   }
   const thresholds = thresholdsForKind(input.kind);
   const contentDiagnostic = sourceTextSupportDiagnostic(content, input.citedText, thresholds);
@@ -29141,6 +29235,7 @@ ${input.content}` : input.content;
 ${detail}`, input.citedText, thresholds);
   const detailAware = {
     ...combined,
+    checkedFields: ["content", "detail"],
     detailAware: true,
     detailVerdict: detailDiagnostic.verdict
   };
@@ -29178,11 +29273,13 @@ function sourceTextSupportsContent(content, citedText) {
   return sourceTextSupportDiagnostic(content, citedText).verdict !== "unsupported";
 }
 function formatSupportDiagnostic(diagnostic) {
+  const basis = diagnostic.checkedFields !== undefined && diagnostic.checkedFields.length > 0 ? diagnostic.checkedFields.join("+") : diagnostic.detailAware === true ? "content+detail" : "content";
   const parts = [
-    `support=${diagnostic.verdict}; lexical overlap ${diagnostic.matchedTermCount}/${diagnostic.contentTermCount} terms; requires ${diagnostic.requiredTermCount}/${diagnostic.contentTermCount}`
+    `support=${diagnostic.verdict}; lexical overlap ${diagnostic.matchedTermCount}/${diagnostic.contentTermCount} terms; requires ${diagnostic.requiredTermCount}/${diagnostic.contentTermCount}`,
+    `basis=${basis}`
   ];
   if (diagnostic.detailAware === true) {
-    parts.push(`basis=content+detail; detail=${diagnostic.detailVerdict ?? "unknown"}`);
+    parts.push(`detail=${diagnostic.detailVerdict ?? "unknown"}`);
   }
   if (diagnostic.missingContentTerms.length > 0) {
     parts.push(`content terms not found in cited raw text: ${diagnostic.missingContentTerms.join(", ")}`);
@@ -29224,12 +29321,16 @@ async function findAutoNarrowedSourceRefs(input) {
     });
     if (resolved === null)
       continue;
+    const { supportText } = supportTextWithHeadingContext({
+      citedText: resolved.cited_text,
+      blocks: resolved.blocks
+    });
     const diagnostic = sourceSectionSupportDiagnostic({
       kind: input.section.kind,
       summary: input.section.summary,
       content: input.section.content,
       detail: input.section.detail,
-      citedText: resolved.cited_text
+      citedText: supportText
     });
     if (!isStrictlySupported(diagnostic))
       continue;
@@ -29267,6 +29368,21 @@ function evidenceBlocksLineRange(blocks) {
 function evidenceBlocksLocatorId(blocks) {
   return blocks.map((block) => block.block_locator_id).filter((value) => typeof value === "string" && value.length > 0).join(" + ");
 }
+function evidenceHeadingContext(blocks) {
+  const headings = blocks.flatMap((block) => block.heading_path ?? []).map((heading) => heading.trim()).filter((heading) => heading.length > 0 && heading !== "document");
+  return [...new Set(headings)];
+}
+function supportTextWithHeadingContext(input) {
+  const headingContext = evidenceHeadingContext(input.blocks);
+  if (headingContext.length === 0)
+    return { supportText: input.citedText };
+  return {
+    supportText: `${headingContext.join(`
+`)}
+${input.citedText}`,
+    headingContext
+  };
+}
 async function sourceRefForBlock(input) {
   return sourceRefForRange({
     ctxDir: input.ctxDir,
@@ -29277,12 +29393,16 @@ async function sourceRefForBlock(input) {
 async function rankEvidenceBlockCandidates(input) {
   const ranked = (await Promise.all(input.blocks.map(async (block) => {
     const citedText = sourceRefRangeText(input.raw, block.line_start, block.line_end);
+    const { supportText } = supportTextWithHeadingContext({
+      citedText,
+      blocks: [block]
+    });
     const diagnostic = sourceSectionSupportDiagnostic({
       kind: input.section.kind,
       summary: input.section.summary,
       content: input.section.content,
       detail: input.section.detail,
-      citedText
+      citedText: supportText
     });
     if (diagnostic.matchedTermCount === 0 && diagnostic.overlapRatio === 0)
       return null;
@@ -29320,6 +29440,10 @@ async function diagnoseSectionSourceSupport(input) {
     throw new Error(`${input.action} source_ref "${input.section.source_ref}" does not point to an active source`);
   }
   const citedText = resolved.cited_text;
+  const { supportText, headingContext } = supportTextWithHeadingContext({
+    citedText,
+    blocks: resolved.blocks
+  });
   const alias = `src-${resolved.alias_index}`;
   const rawBlocks = resolved.raw_text !== null ? extractRawBlocks(resolved.raw_text) : [];
   const evidenceBlock = {
@@ -29332,7 +29456,7 @@ async function diagnoseSectionSourceSupport(input) {
     summary: input.section.summary,
     content: input.section.content,
     detail: input.section.detail,
-    citedText
+    citedText: supportText
   });
   const evidenceBlockCandidates = resolved.raw_text !== null ? await rankEvidenceBlockCandidates({
     ctxDir: input.ctxDir,
@@ -29347,6 +29471,7 @@ async function diagnoseSectionSourceSupport(input) {
     sourceId,
     sourceRef: resolved.source_ref,
     citedText,
+    ...headingContext !== undefined ? { headingContext } : {},
     diagnostic,
     evidenceBlock,
     ...evidenceBlockCandidates !== undefined ? { evidenceBlockCandidates } : {}
@@ -29365,11 +29490,11 @@ 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. Auto mode or general permission to continue is not confirmation.";
+    return " Key facts match, but support is weak; ask the user to confirm the content 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, 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, TRAILING_HARD_TERM_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();
@@ -29382,6 +29507,7 @@ var init_sourceSupport = __esm(() => {
   CJK_CHAR_RE = /[\u4e00-\u9fff]/gu;
   URL_RE2 = /https?:\/\/[^\s)\]}>"'）】》」』，。；：！？]+/giu;
   TRAILING_URL_PUNCTUATION_RE = /[.,;:!?)\]\}>"'，。；：！？）】》」』]+$/u;
+  TRAILING_HARD_TERM_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;
   CJK_URL_REFERENCE_LABEL_RE = /文档|链接|入口|参考|资料|页面|地址|官网|官方|指南|来源|网址/gu;
@@ -32069,12 +32195,13 @@ async function upsertCoverageCandidates(input) {
       dispositions: existing?.dispositions ?? []
     });
   }
+  const candidates = await adjustMaterializedCandidates(input.ctxDir, [...byId.values()]);
   await writeCoverageStateFile(input.ctxDir, {
     schema_version: COVERAGE_STATE_SCHEMA_VERSION,
     updated_at: (input.now ?? new Date).toISOString(),
-    candidates: [...byId.values()]
+    candidates
   });
-  return summarizeCoverageCandidates([...byId.values()], 0, pruned.staleDropped);
+  return summarizeCoverageCandidates(candidates, 0, pruned.staleDropped);
 }
 function dispositionError(code, message) {
   const hint = {
@@ -33208,16 +33335,13 @@ function urlsIn(text) {
 }
 function proposedTextForAction(action) {
   if (action.op === "add")
-    return `${action.summary ?? ""}
-${action.content}
+    return `${action.content}
 ${action.detail ?? ""}`;
   if (action.op === "update")
-    return `${action.summary ?? ""}
-${action.content ?? ""}
+    return `${action.content ?? ""}
 ${action.detail ?? ""}`;
   if (action.op === "supersede")
-    return `${action.new.summary ?? ""}
-${action.new.content}
+    return `${action.new.content}
 ${action.new.detail ?? ""}`;
   return "";
 }
@@ -34010,8 +34134,24 @@ async function contentForBlock(ctxDir, source2, block, sourceEntry, options = {}
   const fullQuote = lines.slice(start2 - 1, end).join(`
 `).trim() || block.text_preview || "";
   const compactQuote = fullQuote.slice(0, MAX_SNIPPET_CHARS);
+  if (options.fullText === true) {
+    const blockLines = lines.slice(start2 - 1, end);
+    const page = fullTextPageForBlock({
+      nodeSlug: options.nodeSlug ?? "",
+      blockId: block.block_id,
+      blockLines,
+      blockRawStartLine: start2,
+      ...options.lineRange !== undefined ? { requestedRange: options.lineRange } : {}
+    });
+    return {
+      quote: page.quote.length > 0 ? page.quote : compactQuote,
+      compactQuote,
+      fullTextPage: page.info,
+      ...raw.note !== undefined ? { note: raw.note } : {}
+    };
+  }
   return {
-    quote: options.fullText === true ? fullQuote : compactQuote,
+    quote: compactQuote,
     compactQuote,
     ...raw.note !== undefined ? { note: raw.note } : {}
   };
@@ -34044,6 +34184,7 @@ function toSnippet(input) {
     block_id: input.entry.block_id,
     ...input.entry.block_locator_id !== undefined ? { block_locator_id: input.entry.block_locator_id } : {},
     ...input.entry.source_ref !== undefined ? { source_ref: input.entry.source_ref } : {},
+    ...input.entry.full_text_page !== undefined ? { full_text_page: input.entry.full_text_page } : {},
     ...input.sourceType !== undefined ? { source_type: input.sourceType } : {},
     ...input.note !== undefined ? {
       note_intent: input.note.intent,
@@ -34076,6 +34217,117 @@ function graphContext(edges, slug) {
 function tokenEstimate2(value) {
   return Math.ceil(value.length / 4);
 }
+function lineRangeText(range) {
+  return `${range.start}:${range.end}`;
+}
+function requestFullTextPageCommand(slug, blockId, range) {
+  return `context compile --context ${slug} --request-full-text ${blockId} --request-full-text-range ${range} --format json`;
+}
+function isFenceLine(line) {
+  return /^\s*(```|~~~)/u.test(line);
+}
+function isTableLine(line) {
+  return /^\s*\|.*\|\s*$/u.test(line);
+}
+function isMarkdownHeading(line) {
+  return /^\s{0,3}#{1,6}\s+\S/u.test(line);
+}
+function isNaturalBreak(line, nextLine, inFenceAfterLine) {
+  if (line.trim() === "")
+    return true;
+  if (isFenceLine(line) && !inFenceAfterLine)
+    return true;
+  if (inFenceAfterLine)
+    return false;
+  if (nextLine !== undefined && isMarkdownHeading(nextLine))
+    return true;
+  if (isTableLine(line))
+    return true;
+  return false;
+}
+function selectFullTextPageEnd(lines, startIndex) {
+  if (startIndex >= lines.length)
+    return { endIndex: lines.length };
+  if (tokenEstimate2(lines[startIndex] ?? "") > FULL_TEXT_PAGE_HARD_TOKENS) {
+    return {
+      endIndex: startIndex + 1,
+      warning: "single-line page exceeds the target token budget; content was kept intact at the line boundary"
+    };
+  }
+  let inFence = false;
+  let targetEnd;
+  for (let index = startIndex;index < lines.length; index += 1) {
+    const line = lines[index] ?? "";
+    if (isFenceLine(line))
+      inFence = !inFence;
+    const pageText = lines.slice(startIndex, index + 1).join(`
+`);
+    const tokens = tokenEstimate2(pageText);
+    const nextLine = lines[index + 1];
+    if (tokens >= FULL_TEXT_PAGE_TARGET_TOKENS && targetEnd === undefined && !inFence) {
+      targetEnd = index + 1;
+    }
+    if (tokens >= FULL_TEXT_PAGE_MIN_TOKENS && isNaturalBreak(line, nextLine, inFence)) {
+      return { endIndex: index + 1 };
+    }
+    if (tokens >= FULL_TEXT_PAGE_MAX_TOKENS && !inFence) {
+      return { endIndex: targetEnd ?? index + 1 };
+    }
+    if (tokens >= FULL_TEXT_PAGE_HARD_TOKENS) {
+      return {
+        endIndex: index + 1,
+        ...inFence ? { warning: "page reached the hard token budget inside a fenced block; content was kept intact at the line boundary" } : {}
+      };
+    }
+  }
+  return { endIndex: lines.length };
+}
+function normalizeRequestedFullTextRange(range, lineCount) {
+  if (lineCount === 0)
+    return { start: 1, end: 1 };
+  if (range === undefined)
+    return { start: 1, end: lineCount };
+  if (range.start < 1 || range.end < range.start || range.start > lineCount) {
+    throw new ContextError(ExitCode.UserError, `request_full_text range ${lineRangeText(range)} is outside the requested block`, {
+      category: ErrorCategory.UserInputInvalid,
+      agent_hints: [{
+        code: "compile-request-full-text-invalid",
+        severity: "error",
+        message: "request_full_text range must use block-relative line numbers inside the selected block.",
+        path: "request_full_text.range",
+        reason_code: "range-out-of-bounds",
+        next_action: "Use full_text_page.next_range from the previous response, or retry without --request-full-text-range."
+      }]
+    });
+  }
+  return { start: range.start, end: Math.min(range.end, lineCount) };
+}
+function fullTextPageForBlock(input) {
+  const requested = normalizeRequestedFullTextRange(input.requestedRange, input.blockLines.length);
+  const shouldAutoPage = input.requestedRange !== undefined || tokenEstimate2(input.blockLines.slice(requested.start - 1, requested.end).join(`
+`)) > FULL_TEXT_PAGE_MAX_TOKENS;
+  const startIndex = requested.start - 1;
+  const selected = shouldAutoPage ? selectFullTextPageEnd(input.blockLines.slice(0, requested.end), startIndex) : { endIndex: requested.end };
+  const relativeEnd = Math.max(requested.start, Math.min(selected.endIndex, requested.end));
+  const quote = input.blockLines.slice(startIndex, relativeEnd).join(`
+`).trim();
+  const hasMore = relativeEnd < input.blockLines.length;
+  const nextRange = hasMore ? `${relativeEnd + 1}:${Math.min(input.blockLines.length, relativeEnd + (relativeEnd - requested.start + 1))}` : undefined;
+  const range = `${requested.start}:${relativeEnd}`;
+  const info2 = {
+    block_id: input.blockId,
+    status: hasMore || input.requestedRange !== undefined ? "paged" : "full",
+    range,
+    raw_line_range: [input.blockRawStartLine + requested.start - 1, input.blockRawStartLine + relativeEnd - 1],
+    block_line_count: input.blockLines.length,
+    token_estimate: tokenEstimate2(quote),
+    has_more: hasMore,
+    ...nextRange !== undefined ? { next_range: nextRange } : {},
+    ...nextRange !== undefined && input.nodeSlug.length > 0 ? { next_command: requestFullTextPageCommand(input.nodeSlug, input.blockId, nextRange) } : {},
+    ...selected.warning !== undefined ? { warning: selected.warning } : {}
+  };
+  return { quote, info: info2 };
+}
 function requestableFullTextBlockIds(ownership, slug) {
   return ownership.sources.flatMap((source2) => source2.blocks.filter((block) => isPrimaryEvidence(block, slug) || isSecondaryShared(block, slug)).map((block) => block.block_id));
 }
@@ -34129,9 +34381,44 @@ function invalidRequestFullTextDetails(input) {
     reasonCode: "not-visible-evidence"
   };
 }
+function fullTextPagingHints(input) {
+  const pages = input.snippets.flatMap((snippet) => snippet.full_text_page?.has_more === true ? [snippet.full_text_page] : []);
+  if (pages.length === 0 && input.addedTokens <= input.tokenGrowthBudget)
+    return [];
+  return [{
+    code: "compile-request-full-text-paged",
+    severity: "info",
+    message: pages.length > 0 ? "request_full_text returned line-bounded page(s) for long evidence instead of failing the NodeContext token budget." : "request_full_text expansion exceeded the historical growth budget but stayed within page-bounded output.",
+    target_node: input.nodeSlug,
+    next_action: pages.length > 0 ? "Use raw_snippets[].full_text_page.next_command to continue reading the same block; cite only source_refs already present in NodeContext." : "Continue with the returned NodeContext.",
+    ...pages[0]?.next_command !== undefined ? { command: pages[0].next_command } : {},
+    diagnostics: {
+      added_tokens: input.addedTokens,
+      historical_growth_budget: input.tokenGrowthBudget,
+      page_count_with_more: pages.length,
+      pages: pages.map((page) => ({
+        block_id: page.block_id,
+        range: page.range,
+        raw_line_range: page.raw_line_range,
+        token_estimate: page.token_estimate,
+        next_range: page.next_range,
+        next_command: page.next_command
+      }))
+    }
+  }];
+}
 function validateExpandRequest(input) {
   const requested = [...new Set(input.request.blockIds)].filter((blockId) => blockId.length > 0);
   const availableBlockIds = requestableFullTextBlockIds(input.ownership, input.slug);
+  if (input.request.lineRange !== undefined && requested.length !== 1) {
+    throw requestFullTextError({
+      slug: input.slug,
+      message: "request_full_text range requires exactly one --request-full-text block id",
+      reasonCode: "range-requires-single-block",
+      availableBlockIds,
+      requestedBlockIds: requested
+    });
+  }
   if (requested.length > MAX_FULL_TEXT_REQUESTS) {
     throw requestFullTextError({
       slug: input.slug,
@@ -34187,7 +34474,10 @@ async function appendFinalizedBlock(input) {
   const blockId = input.block.block_id;
   const expanded = input.expandedBlockIds.has(blockId);
   const fullText = primary || expanded;
-  const content = await contentForBlock(input.ctxDir, input.source, input.block, input.sourceEntry, { fullText: expanded });
+  const content = await contentForBlock(input.ctxDir, input.source, input.block, input.sourceEntry, {
+    fullText: expanded,
+    ...expanded ? { lineRange: input.expandLineRange, nodeSlug: input.nodeSlug } : {}
+  });
   const quote = content.quote;
   const compactPrefix = (input.block.context_prefix ?? input.block.text_preview ?? quote).replace(/\s+/g, " ").slice(0, MAX_CONTEXT_PREFIX_CHARS);
   if (expanded) {
@@ -34213,6 +34503,7 @@ async function appendFinalizedBlock(input) {
     ownership_reason: input.block.reason,
     ...input.block.primary_owner !== undefined ? { primary_owner: input.block.primary_owner } : {},
     ...input.block.owners !== undefined ? { owners: [...input.block.owners] } : {},
+    ...content.fullTextPage !== undefined ? { full_text_page: content.fullTextPage } : {},
     ...secondary && !expanded ? {
       request_full_text: {
         available: true,
@@ -34275,6 +34566,7 @@ async function buildNodeContextFromFinalizedOwnership(input) {
         source: source2,
         block,
         expandedBlockIds,
+        ...input.options?.expand?.lineRange !== undefined ? { expandLineRange: input.options.expand.lineRange } : {},
         fullTextTokenGrowth,
         groups,
         snippets,
@@ -34286,20 +34578,12 @@ async function buildNodeContextFromFinalizedOwnership(input) {
   const addedTokens = fullTextTokenGrowth.reduce((sum, value) => sum + value, 0);
   const baseTokens = Math.max(1, snippets.reduce((sum, snippet) => sum + tokenEstimate2(snippet.quote), 0) - addedTokens);
   const tokenGrowthBudget = Math.max(MIN_CONTEXT_TOKEN_GROWTH_TOKENS, Math.ceil(baseTokens * MAX_CONTEXT_TOKEN_GROWTH_RATIO));
-  if (addedTokens > tokenGrowthBudget) {
-    throw requestFullTextError({
-      slug: input.node.slug,
-      message: "request_full_text expansion exceeds the NodeContext token growth budget",
-      reasonCode: "token-growth-budget",
-      availableBlockIds: requestableFullTextBlockIds(input.ownership, input.node.slug),
-      requestedBlockIds: [...expandedBlockIds],
-      repairOptions: [
-        "Retry with fewer visible evidence blocks.",
-        "Continue from the compact NodeContext snippet when it is enough.",
-        "Use pending_ownership_challenge only if a secondary shared block should become owned/shared-primary evidence for this Node."
-      ]
-    });
-  }
+  const pagingHints = fullTextPagingHints({
+    nodeSlug: input.node.slug,
+    snippets,
+    addedTokens,
+    tokenGrowthBudget
+  });
   return {
     node: {
       ...input.node,
@@ -34312,10 +34596,11 @@ async function buildNodeContextFromFinalizedOwnership(input) {
     finalized_ownership: {
       source: "finalized-ownership",
       groups
-    }
+    },
+    ...pagingHints.length > 0 ? { agent_hints: pagingHints } : {}
   };
 }
-var MAX_FULL_TEXT_REQUESTS = 3, MAX_CONTEXT_TOKEN_GROWTH_RATIO = 0.3, MIN_CONTEXT_TOKEN_GROWTH_TOKENS = 120, MAX_SNIPPET_CHARS = 1800, MAX_CONTEXT_PREFIX_CHARS = 320, NON_EVIDENCE_PLACEHOLDERS2;
+var MAX_FULL_TEXT_REQUESTS = 3, MAX_CONTEXT_TOKEN_GROWTH_RATIO = 0.3, MIN_CONTEXT_TOKEN_GROWTH_TOKENS = 120, MAX_SNIPPET_CHARS = 1800, MAX_CONTEXT_PREFIX_CHARS = 320, FULL_TEXT_PAGE_MIN_TOKENS = 600, FULL_TEXT_PAGE_TARGET_TOKENS = 800, FULL_TEXT_PAGE_MAX_TOKENS = 1000, FULL_TEXT_PAGE_HARD_TOKENS = 1200, NON_EVIDENCE_PLACEHOLDERS2;
 var init_compileFinalizedContext = __esm(() => {
   init_ref();
   init_manifest();
@@ -34464,7 +34749,7 @@ async function readCompileAlignNodes(ctxDir) {
     const node2 = compileAlignNodeFromKnowledge(located.parsed.node);
     return [node2.slug, node2];
   }));
-  const finalizedOwnership = await readCurrentSourceOwnership(ctxDir);
+  const finalizedOwnership = await readFreshCurrentSourceOwnership(ctxDir);
   for (const node2 of finalizedOwnership?.nodes ?? []) {
     const finalized = compileAlignNodeFromFinalized(node2);
     const existing = bySlug.get(finalized.slug);
@@ -34496,7 +34781,7 @@ async function readCompileAlignEdges(ctxDir) {
   for (const edge2 of await loadKnowledgeGraphEdges(ctxDir)) {
     add(edge2.type, edge2.from, edge2.to, edge2.note);
   }
-  const finalizedOwnership = await readCurrentSourceOwnership(ctxDir);
+  const finalizedOwnership = await readFreshCurrentSourceOwnership(ctxDir);
   for (const node2 of finalizedOwnership?.nodes ?? []) {
     if (typeof node2.contains_parent === "string" && node2.contains_parent.length > 0) {
       add("contains", node2.contains_parent, node2.slug);
@@ -34660,7 +34945,8 @@ async function readChangedBlockSnippet(ctxDir, block, source2, aliasIndex2) {
 }
 async function buildChangedNodeContext(ctxDir, slug, options = {}) {
   const full = await buildFullNodeContextWithOptions(ctxDir, slug, {
-    ...options.requestFullTextBlockIds !== undefined ? { requestFullTextBlockIds: options.requestFullTextBlockIds } : {}
+    ...options.requestFullTextBlockIds !== undefined ? { requestFullTextBlockIds: options.requestFullTextBlockIds } : {},
+    ...options.requestFullTextRange !== undefined ? { requestFullTextRange: options.requestFullTextRange } : {}
   });
   const changes = options.changes ?? await computeCompileChanges({
     ctxDir,
@@ -34739,7 +35025,7 @@ async function buildFullNodeContextWithOptions(ctxDir, slug, options = {}) {
   } catch {
     existing = undefined;
   }
-  const finalizedOwnership = await readCurrentSourceOwnership(ctxDir);
+  const finalizedOwnership = await readFreshCurrentSourceOwnership(ctxDir);
   if (finalizedOwnership === null) {
     throw new ContextError(ExitCode.WorkspaceStateError, "compile context requires finalized source ownership; run /context:align finalize first", {
       category: ErrorCategory.WorkspaceStateInvalid,
@@ -34749,7 +35035,12 @@ async function buildFullNodeContextWithOptions(ctxDir, slug, options = {}) {
   }
   const sourcesFile = await loadSources(ctxDir);
   const edges = await readCompileAlignEdges(ctxDir);
-  const finalizedOptions = options.requestFullTextBlockIds !== undefined ? { expand: { blockIds: options.requestFullTextBlockIds } } : {};
+  const finalizedOptions = options.requestFullTextBlockIds !== undefined ? {
+    expand: {
+      blockIds: options.requestFullTextBlockIds,
+      ...options.requestFullTextRange !== undefined ? { lineRange: options.requestFullTextRange } : {}
+    }
+  } : {};
   const baseContext = await buildNodeContextFromFinalizedOwnership({
     ctxDir,
     node: node2,
@@ -36146,6 +36437,7 @@ var init_agentHintRegistry = __esm(() => {
     "compile-prepare-missing-draft",
     "compile-prepare-missing-node",
     "compile-request-full-text-invalid",
+    "compile-request-full-text-paged",
     "compile-secondary-shared-compact",
     "compile-scan-changes-required",
     "compile-section-kind-guidance",
@@ -36195,6 +36487,7 @@ var init_agentHintRegistry = __esm(() => {
     "query-recall-truncated",
     "query-recall-uneven-anchors",
     "query-select-needs-scope",
+    "raw-snapshot-pending-compile",
     "ready-no-op-review",
     "ready-review-output",
     "reconcile-prepare-draft-mode-invalid",
@@ -37402,7 +37695,8 @@ function draftSessionError(message) {
       severity: "error",
       message,
       next_action: "Read the draft status, then submit a corrected compile draft patch.",
-      command: "context compile --draft-status <slug> --format json"
+      command: "context compile --draft-status <slug> --format json",
+      patch_schema_version: COMPILE_DRAFT_PATCH_SCHEMA_VERSION
     }]
   });
 }
@@ -37484,7 +37778,7 @@ function parseCompileDraftPatch(value) {
   if (value.patches !== undefined) {
     throw draftSessionError("compile draft patch field patches is not supported; use operations[]");
   }
-  if (value.schema_version !== COMPILE_DRAFT_PATCH_SCHEMA_VERSION) {
+  if (value.schema_version !== undefined && value.schema_version !== COMPILE_DRAFT_PATCH_SCHEMA_VERSION) {
     throw draftSessionError(`schema_version must be ${COMPILE_DRAFT_PATCH_SCHEMA_VERSION}`);
   }
   if (!Array.isArray(value.operations) || value.operations.length === 0) {
@@ -38111,8 +38405,11 @@ function uniqueSourceEntries(values) {
       continue;
     const base = sourceIdWithoutVersion(value);
     const current = byBase.get(base);
-    if (current === undefined || !current.includes("@") && value.includes("@"))
+    const currentVersion = current === undefined ? undefined : parseVersionedSourceId(current).snapshotHash;
+    const nextVersion = parseVersionedSourceId(value).snapshotHash;
+    if (current === undefined || nextVersion !== undefined && currentVersion === undefined || nextVersion !== undefined && currentVersion !== undefined && nextVersion !== currentVersion) {
       byBase.set(base, value);
+    }
   }
   return [...byBase.values()];
 }
@@ -38697,7 +38994,7 @@ async function compileSourceSupport(input) {
   if (typeof candidate.section.content !== "string" || candidate.section.content.length === 0)
     return;
   const sourceRefs = draftActionSourceRefs(input.action);
-  const { sourceRef, citedText, diagnostic, evidenceBlock, evidenceBlockCandidates } = await diagnoseSectionSourceSupport({
+  const { sourceRef, citedText, headingContext, diagnostic, evidenceBlock, evidenceBlockCandidates } = await diagnoseSectionSourceSupport({
     ctxDir: input.ctxDir,
     nodeSources: input.node.parsed.node.sources,
     sourceById: input.sourceById,
@@ -38713,7 +39010,10 @@ async function compileSourceSupport(input) {
   return {
     source_ref: sourceRef,
     cited_text: citedText,
+    ...headingContext !== undefined ? { heading_context: headingContext } : {},
     verdict: diagnostic.verdict,
+    ...diagnostic.checkedFields !== undefined ? { checked_fields: diagnostic.checkedFields } : {},
+    ...candidate.section.summary !== undefined ? { summary_policy: "advisory_not_hard_gated" } : {},
     content_term_count: diagnostic.contentTermCount,
     matched_term_count: diagnostic.matchedTermCount,
     required_term_count: diagnostic.requiredTermCount,
@@ -39227,6 +39527,8 @@ async function prepareCompileReconcileContext(input) {
     });
     resolvedItems.push({
       item_id: itemId,
+      ...typeof action.action_id === "string" ? { draft_action_id: action.action_id } : {},
+      draft_action_index: indexInDraft + 1,
       proposed: temporal.proposed,
       ...defaultDecision !== undefined ? { default_decision: defaultDecision } : {},
       ...target !== undefined ? { target } : {},
@@ -40891,16 +41193,17 @@ function queryAgentOutput(value) {
   return rest;
 }
 function semanticStatusAgentView(status) {
-  const refreshedNoteSourceIds = status.refreshed_source_pending_compile.source_ids.filter((sourceId) => sourceId.startsWith("note:"));
-  const agentHints = refreshedNoteSourceIds.length > 0 ? [{
-    code: "refresh-note-pending-compile",
+  const refreshedSourceIds = status.refreshed_source_pending_compile.source_ids;
+  const agentHints = refreshedSourceIds.length > 0 ? [{
+    code: "raw-snapshot-pending-compile",
     severity: "info",
-    message: "One or more captured note sources are pending compile absorption.",
-    next_action: "Run /context:compile and process semantic.refreshed_source_pending_compile.source_ids before the ordinary per-Node draft loop.",
+    message: "One or more active sources have newer raw snapshots that have not been absorbed into compiled knowledge.",
+    next_action: "Run /context:compile. The CLI will refresh deterministic source ownership when possible; if ownership cannot be reanchored, rerun context align --scan before compiling.",
     command: "/context:compile",
     diagnostics: {
-      source_ids: refreshedNoteSourceIds,
-      status_field: "semantic.refreshed_source_pending_compile.source_ids"
+      source_ids: refreshedSourceIds,
+      status_field: "semantic.refreshed_source_pending_compile.source_ids",
+      note: "This status means raw snapshots changed; it does not mean finalized ownership or node.sources[] are already updated."
     }
   }] : [];
   return agentPathFreeView({
@@ -41763,6 +42066,40 @@ async function refreshSources(input) {
   const file = await loadSources2(input.ctxDir);
   const rows = [];
   for (const s of file.sources.filter((source2) => source2.status === "active")) {
+    if (s.type === "local" && typeof s.origin === "string" && s.origin.length > 0) {
+      const path2 = isAbsolute2(s.origin) ? s.origin : input.workspaceRoot === undefined ? null : join21(input.workspaceRoot, s.origin);
+      if (path2 === null || !existsSync19(path2)) {
+        rows.push({
+          sourceId: s.id,
+          status: "skipped",
+          action: "skipped",
+          error: path2 === null ? "local source refresh requires workspaceRoot" : `local source origin not found: ${s.origin}`
+        });
+        continue;
+      }
+      try {
+        const outcome = await captureFile({
+          path: path2,
+          cwd: input.workspaceRoot ?? process.cwd(),
+          ctxDir: input.ctxDir,
+          ...input.workspaceRoot !== undefined ? { workspaceRoot: input.workspaceRoot } : {},
+          ...input.now !== undefined ? { now: input.now } : {}
+        });
+        rows.push({
+          sourceId: s.id,
+          status: "ok",
+          action: outcome.action === "unchanged" || outcome.action === "moved" || outcome.action === "duplicate" ? "unchanged" : "new-snapshot"
+        });
+      } catch (err2) {
+        rows.push({
+          sourceId: s.id,
+          status: "failed",
+          action: "failed",
+          error: err2 instanceof Error ? err2.message : String(err2)
+        });
+      }
+      continue;
+    }
     if (s.type !== "feishu" || typeof s.url !== "string" || s.url.length === 0) {
       rows.push({ sourceId: s.id, status: "skipped", action: "skipped" });
       continue;
@@ -51128,7 +51465,7 @@ function reviewAgentHints(input) {
       code: "split-by-evidence-blocks",
       severity: "error",
       message: `${splitByEvidenceBlockCount} unsupported decision(s) appear to combine facts from multiple evidence blocks.`,
-      next_action: "Split the proposed summary into one draft action per source_support.evidence_block_candidates[] entry, then rerun prepare/review. If the draft session is available, patch only the affected action with context compile --draft-patch <slug> --input - --plan.",
+      next_action: "Split the proposed content into one draft action per source_support.evidence_block_candidates[] entry, then rerun prepare/review. If the draft session is available, patch only the affected action with context compile --draft-patch <slug> --input - --plan.",
       command: "context compile --draft-patch <slug> --input - --plan"
     });
   }
@@ -51138,7 +51475,7 @@ function reviewAgentHints(input) {
       code: "review-content-shape",
       severity: "error",
       message: `${contentShapeIssueCount} proposed content field(s) contain long, multi-line, or code-block material.`,
-      next_action: "Use proposed.content for the active Section text and add proposed.summary for long content; rerun review with the current semantic-decisions schema.",
+      next_action: "Use proposed.content for the active Section text; proposed.summary is optional and is not a replacement for content. Rerun review with the current semantic-decisions schema.",
       schema: "context schema semantic-decisions --format yaml"
     });
   }
@@ -51216,7 +51553,7 @@ function reviewAgentHints(input) {
       code: "weak-source-support-warning",
       severity: "warning",
       message: `${weakSupportCount} item(s) are only weakly supported by the cited evidence.`,
-      next_action: "Proceed only if the weak summary/compression is acceptable for this workflow; otherwise narrow content or choose/split source_ref/source_refs."
+      next_action: "Proceed only if the weak content 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_content_preservation").length;
@@ -51225,7 +51562,7 @@ function reviewAgentHints(input) {
       code: "example-content-preservation",
       severity: "warning",
       message: `${exampleDetailQuestionCount} example decision(s) cite code/config/command evidence without preserving it in content.`,
-      next_action: "Move the relevant fenced block into proposed.content and rerun review, or ask the user to confirm prose-only summary is acceptable. Auto mode or general permission to continue is not confirmation."
+      next_action: "Move the relevant fenced block into proposed.content and rerun review, or ask the user to confirm prose-only content is acceptable. Auto mode or general permission to continue is not confirmation."
     });
   }
   const urlReferenceQuestionCount = input.questions.filter((question) => question.type === "url_reference_preservation").length;
@@ -51645,6 +51982,7 @@ function supportDiagnosticFromItem(input) {
   if (input.decision.judge_support_verdict !== undefined) {
     return {
       verdict: input.decision.judge_support_verdict,
+      checkedFields: ["content"],
       contentTermCount: 1,
       matchedTermCount: input.decision.judge_support_verdict === "unsupported" ? 0 : 1,
       requiredTermCount: 1,
@@ -51661,11 +51999,15 @@ function supportDiagnosticFromItem(input) {
   const detail = input.decision.proposed?.detail === null || typeof input.decision.proposed?.detail === "string" ? input.decision.proposed.detail : undefined;
   const itemSupport = input.item?.source_support;
   if (itemSupport !== undefined && itemSupport.source_ref === sourceRef && typeof itemSupport.cited_text === "string") {
-    return sourceSectionSupportDiagnostic({ kind, content, detail, citedText: itemSupport.cited_text });
+    const citedText2 = itemSupport.heading_context !== undefined && itemSupport.heading_context.length > 0 ? `${itemSupport.heading_context.join(`
+`)}
+${itemSupport.cited_text}` : itemSupport.cited_text;
+    return sourceSectionSupportDiagnostic({ kind, content, detail, citedText: citedText2 });
   }
   if (itemSupport !== undefined && itemSupport.source_ref === sourceRef && preparedSupportContentMatches({ content, item: input.item })) {
     return {
       verdict: itemSupport.verdict,
+      ...itemSupport.checked_fields !== undefined ? { checkedFields: itemSupport.checked_fields } : {},
       contentTermCount: itemSupport.content_term_count,
       matchedTermCount: itemSupport.matched_term_count,
       requiredTermCount: itemSupport.required_term_count,
@@ -51682,7 +52024,7 @@ function sourceSupportIssue(input) {
   const action = input.decision.action;
   const strict = actionRequiresStrictSourceSupport(action);
   const splitCandidates = input.support?.evidence_block_candidates?.slice(0, 6).map((candidate) => `${candidate.source_ref} (${candidate.block_locator_id})`).join("; ");
-  const repairHint = strict ? "Use source_ref/source_refs copied from prepared evidence that fully covers the rewritten/reanchored content, split separable claims, or ask the user before choosing a different final action." : "Use source_ref/source_refs copied from prepared evidence that covers every sentence, split the summary into separately supported claims, or ask the user to confirm a weak summary only after the evidence boundary is correct.";
+  const repairHint = strict ? "Use source_ref/source_refs copied from prepared evidence that fully covers the rewritten/reanchored content, split separable claims, or ask the user before choosing a different final action." : "Use source_ref/source_refs copied from prepared evidence that covers every sentence, split the content into separately supported claims, or ask the user to confirm weak content only after the evidence boundary is correct.";
   const splitHint = splitCandidates !== undefined && splitCandidates.length > 0 ? ` Candidate evidence blocks for split decisions: ${splitCandidates}.` : "";
   const splitCandidateCount = input.support?.evidence_block_candidates?.length ?? 0;
   return {
@@ -51699,7 +52041,7 @@ function weakSupportWarning(input) {
     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."
+    next_action: "Review the cited evidence if the content looks surprising; missing hard facts still remain errors."
   };
 }
 function citedTextForDecision2(decision, item) {
@@ -51731,7 +52073,7 @@ function exampleDetailPreservationQuestion(input) {
     type: "example_content_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.content. " + "Add the relevant fenced block to proposed.content 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."
+    prompt: "The cited raw evidence contains a fenced code/config/command block, but this example decision does not preserve it in proposed.content. " + "Add the relevant fenced block to proposed.content and rerun review, or ask the user to confirm that prose-only content is acceptable and mark the decision decided_by: user. Auto mode or general permission to continue is not confirmation."
   };
 }
 function sourceSupportFromDiagnostic(input) {
@@ -51739,6 +52081,7 @@ function sourceSupportFromDiagnostic(input) {
     source_ref: input.sourceRef,
     cited_text: input.citedText,
     verdict: input.diagnostic.verdict,
+    ...input.diagnostic.checkedFields !== undefined ? { checked_fields: input.diagnostic.checkedFields } : {},
     content_term_count: input.diagnostic.contentTermCount,
     matched_term_count: input.diagnostic.matchedTermCount,
     required_term_count: input.diagnostic.requiredTermCount,
@@ -56776,6 +57119,7 @@ init_cliFeedback();
 init_agentHints();
 init_exitCode();
 init_compile();
+init_compileDraftSession();
 init_currentWorkflow();
 init_workflowPayloadStore();
 function compileChangesFormat(value) {
@@ -57100,13 +57444,17 @@ function compileDraftRevisionHints(slug, digest2) {
     code: "compile-draft-patch-ready",
     severity: "info",
     message: "Current draft can be revised with a node-scoped patch instead of resubmitting all actions.",
-    next_action: "Replace, add, or remove only the affected action; the CLI resolves the current draft payload automatically.",
+    next_action: "Replace, add, or remove only the affected action; schema_version may be omitted, and the CLI resolves the current draft payload automatically.",
     command: `context compile --draft-patch ${slug} --input - --plan`,
+    patch_schema_version: COMPILE_DRAFT_PATCH_SCHEMA_VERSION,
     diagnostics: { optional_payload_digest: digest2 }
   }];
 }
 function writeCompileDraftStatus(input) {
-  const actions = summarizeCompileDraftSession(input.session);
+  const actions = compileDraftStatusActions({
+    session: input.session,
+    ...input.preparedReconcile !== undefined ? { preparedItems: input.preparedReconcile.items } : {}
+  });
   const hints = [
     ...compileDraftRevisionHints(input.session.node, input.digest),
     ...input.session.agent_hints ?? []
@@ -57115,9 +57463,11 @@ function writeCompileDraftStatus(input) {
     writeJson3({
       node: input.session.node,
       draft_digest: input.digest,
+      patch_schema_version: COMPILE_DRAFT_PATCH_SCHEMA_VERSION,
       show_command: input.showCommand,
       next_command: input.showCommand,
       action_count: actions.length,
+      ...input.preparedReconcile !== undefined ? { reconcile_prepare: { digest: input.preparedReconcile.digest, item_count: input.preparedReconcile.items.length } } : {},
       actions,
       agent_hints: hints
     });
@@ -57128,17 +57478,38 @@ function writeCompileDraftStatus(input) {
     `digest: ${input.digest}`,
     `show: ${input.showCommand}`,
     `actions: ${actions.length}`,
+    ...input.preparedReconcile !== undefined ? [`reconcile prepare: ${input.preparedReconcile.digest} (${input.preparedReconcile.items.length} item(s))`] : [],
     "",
-    "| action_id | op | kind | source_refs | preview |",
-    "|-----------|----|------|-------------|---------|"
+    "| action_id | claim_id | op | kind | source_refs | preview |",
+    "|-----------|----------|----|------|-------------|---------|"
   ];
   for (const action of actions) {
-    lines.push(`| ${action.action_id} | ${action.op} | ${action.kind ?? ""} | ${action.source_ref_count} | ${(action.content_preview ?? "").replace(/\|/g, "\\|")} |`);
+    lines.push(`| ${action.action_id} | ${action.reconcile_item_id ?? ""} | ${action.op} | ${action.kind ?? ""} | ${action.source_ref_count} | ${(action.content_preview ?? "").replace(/\|/g, "\\|")} |`);
   }
   lines.push("", `next: ${hints[0].command}`);
   process.stdout.write(lines.join(`
 `));
 }
+function claimIdForActionIndex(index) {
+  return `claim-${String(index + 1).padStart(3, "0")}`;
+}
+function compileDraftStatusActions(input) {
+  const itemsById = new Map((input.preparedItems ?? []).map((item) => [item.item_id, item]));
+  const itemsByActionId = new Map((input.preparedItems ?? []).filter((item) => typeof item.draft_action_id === "string").map((item) => [item.draft_action_id, item]));
+  const hasActionIdMapping = itemsByActionId.size > 0;
+  return summarizeCompileDraftSession(input.session).map((action, index) => {
+    const itemId = claimIdForActionIndex(index);
+    const item = itemsByActionId.get(action.action_id) ?? (hasActionIdMapping ? undefined : itemsById.get(itemId));
+    if (item === undefined)
+      return action;
+    return {
+      ...action,
+      reconcile_item_id: item.item_id,
+      reconcile_status: item.status ?? "pending",
+      ...item.source_support?.verdict !== undefined ? { source_support: item.source_support.verdict } : {}
+    };
+  });
+}
 function rejectSourceRefTextMainPath(draft) {
   const unsupportedEvidenceFieldNames = ["source_ref_text", "evidence_refs"];
   const hasUnsupportedEvidenceField = (value) => unsupportedEvidenceFieldNames.some((field) => (field in value));
@@ -57938,25 +58309,29 @@ function normalizeAlignCoarseReadPayloads(value) {
     reject("$", "align-coarse-read payload must be an object");
   if (Array.isArray(value.coarse_reads)) {
     walkForbidden(value, "$");
-    if (value.schema_version !== undefined && value.schema_version !== ALIGN_COARSE_READ_BATCH_SCHEMA_VERSION) {
-      reject("schema_version", `schema_version must be ${ALIGN_COARSE_READ_BATCH_SCHEMA_VERSION} for a coarse_reads envelope`);
+    if (value.schema_version !== undefined && value.schema_version !== ALIGN_COARSE_READ_BATCH_SCHEMA_VERSION && value.schema_version !== ALIGN_COARSE_READ_SCHEMA_VERSION) {
+      reject("schema_version", `schema_version must be omitted or be ${ALIGN_COARSE_READ_BATCH_SCHEMA_VERSION} for a coarse_reads envelope`);
     }
     if (value.coarse_reads.length === 0) {
       reject("coarse_reads", "coarse_reads must contain at least one coarse-read record");
     }
     return value.coarse_reads.map((record, index) => {
-      const normalized = isRecord25(record) ? {
+      const normalized2 = isRecord25(record) ? {
         ...record,
         schema_version: record.schema_version ?? ALIGN_COARSE_READ_SCHEMA_VERSION,
         reading_anchors: record.reading_anchors ?? [],
         section_proposals: record.section_proposals ?? []
       } : record;
-      validateAlignCoarseReadPayload(normalized, `coarse_reads[${index}]`);
-      return normalized;
+      validateAlignCoarseReadPayload(normalized2, `coarse_reads[${index}]`);
+      return normalized2;
     });
   }
-  validateAlignCoarseReadPayload(value);
-  return [value];
+  const normalized = {
+    ...value,
+    schema_version: value.schema_version ?? ALIGN_COARSE_READ_SCHEMA_VERSION
+  };
+  validateAlignCoarseReadPayload(normalized);
+  return [normalized];
 }
 
 // src/workflow/alignCandidateLedger.ts
@@ -59295,6 +59670,8 @@ var termTags = TERM_TAG_VALUES;
 var entityTags = [...ENTITY_TAG_A_VALUES, ...ENTITY_TAG_B_VALUES, ...termTags];
 var TERM_ENTITY_NOTES = [
   "Node type order: action first only when scale plus process evidence both pass; otherwise concrete/term entity; otherwise child-bearing domain; otherwise no Node.",
+  "Classify the Node by evidence referent, not by source title or heading. Source title/heading is ordinary evidence and does not automatically become node.title, aliases[], or slug.",
+  "After node_type is chosen, generate node.title to fit that type: entity titles name concrete objects or atomic terms; domain titles name grouping scopes with child refs; action titles name executable processes. Scope/process words such as 方案, 架构, 体系, 演练, 流程, 策略, 能力, 机制, framework, architecture, system, strategy, process, or drill in an Entity title require review.",
   "Action scale means at least two planned Section kinds or a child Action; process evidence means steps, phases, trigger->handling->result, role collaboration, or repeatable plan. Parallel options/config lists are not action evidence.",
   "Entity tag term is for a pure stable named definition only. term is mutually exclusive with A/B concrete tags; React is [lib], not [lib, term]. Split a separate [term] Entity when both identities matter.",
   "Legal Entity tag shapes: one A tag, one B tag, one A plus one B, or only [term]. A+A, B+B, term+A/B, and empty entity tags are invalid.",
@@ -59473,7 +59850,7 @@ var SCHEMAS = {
   },
   "align-coarse-read": {
     schema: "align-coarse-read",
-    schema_version: "align.coarse-read.v1",
+    schema_version: ALIGN_COARSE_READ_SCHEMA_VERSION,
     producer: "LLM Pass 0 + CLI id normalizer",
     consumer: "CLI storage / Discovery LLM",
     role: "Whole-document reading anchors, section planning, neutral content signals, and density profile.",
@@ -59482,10 +59859,10 @@ var SCHEMAS = {
       content_signal_key: ALIGN_CONTENT_SIGNAL_KEYS,
       content_signal_level: ALIGN_CONTENT_SIGNAL_LEVELS
     },
-    required: ["schema_version", "source_id", "density_profile", "reading_anchors", "section_proposals"],
+    required: ["source_id", "density_profile", "reading_anchors", "section_proposals"],
     forbidden_fields: [...ALIGN_WORKFLOW_FORBIDDEN_FIELDS, "node_type", "tags", "recommended_node", "action_tag"],
     example: {
-      schema_version: "align.coarse-read.v1",
+      schema_version: ALIGN_COARSE_READ_SCHEMA_VERSION,
       artifact_kind: "cli_normalized_llm_output",
       source_id: "local:demo",
       density_profile: "meso",
@@ -59512,12 +59889,27 @@ var SCHEMAS = {
         source_window_ids: ["w0001"]
       }]
     },
+    batch_example: {
+      coarse_reads: [{
+        source_id: "local:demo-a",
+        density_profile: "micro",
+        reading_anchors: [],
+        section_proposals: []
+      }, {
+        source_id: "local:demo-b",
+        density_profile: "macro",
+        reading_anchors: [],
+        section_proposals: []
+      }]
+    },
     notes: [
+      "When submitting through context align --coarse-read, schema_version may be omitted; the CLI infers single-source vs batch from the presence of coarse_reads[].",
+      "For batch input, prefer { coarse_reads: [...] } without a top-level schema_version. Each entry is a single-source coarse-read record.",
       "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.",
-      `Submit multiple sources as { schema_version: "${ALIGN_COARSE_READ_BATCH_SCHEMA_VERSION}", coarse_reads: [...] }; the single-source payload remains valid.`,
+      `If you include a top-level batch schema_version, use ${ALIGN_COARSE_READ_BATCH_SCHEMA_VERSION}; omitting it is simpler.`,
       "align-coarse-read is the latest checkpoint. Durable multi-source recall lives in align-candidate-ledger.source_readings."
     ]
   },
@@ -59528,7 +59920,7 @@ var SCHEMAS = {
     consumer: "CLI ledger reducer",
     role: "One transactional batch of candidate ledger operations.",
     enums: enums(),
-    required: ["schema_version", "batch_id", "sections_processed", "ops"],
+    required: ["batch_id", "sections_processed", "ops"],
     forbidden_fields: ALIGN_WORKFLOW_FORBIDDEN_FIELDS,
     example: {
       schema_version: ALIGN_CANDIDATE_OPS_SCHEMA_VERSION,
@@ -59595,6 +59987,7 @@ var SCHEMAS = {
       }]
     },
     notes: [
+      "When submitting through context align --ops, schema_version may be omitted; the CLI normalizes it to the current align-candidate-ops schema.",
       "add_candidate uses local:<name>; reducer assigns immutable candidate_id.",
       ...TERM_ENTITY_NOTES,
       "Action candidates must include boolean action_probe gate fields and structured action_signals; do not use free-form steps[] in candidate ops.",
@@ -61739,6 +62132,12 @@ function validateCandidateOpsAgainstSegments(opsInput, segments) {
   walk(opsInput.ops, "ops", "ops");
   throwIfIssues();
 }
+function normalizeCandidateOpsInput(value) {
+  return {
+    ...value,
+    schema_version: value.schema_version ?? ALIGN_CANDIDATE_OPS_SCHEMA_VERSION
+  };
+}
 async function readExistingLedger(input) {
   try {
     const record = await readWorkflowPayloadByDigest({
@@ -61757,12 +62156,13 @@ async function readExistingLedger(input) {
   }
 }
 async function runAlignCandidateOpsCommand(input) {
-  const opsInput = await readStructuredInput2(resolveStdinOnlyInput(input.options.ops, "--ops"));
-  if (typeof opsInput !== "object" || opsInput === null || Array.isArray(opsInput)) {
+  const rawOpsInput = await readStructuredInput2(resolveStdinOnlyInput(input.options.ops, "--ops"));
+  if (typeof rawOpsInput !== "object" || rawOpsInput === null || Array.isArray(rawOpsInput)) {
     throw new ContextError(ExitCode.UserError, "align candidate ops input must be an object", {
       category: ErrorCategory.SchemaInvalid
     });
   }
+  const opsInput = normalizeCandidateOpsInput(rawOpsInput);
   const segmentsDigest = input.workflowState.input_digests["align-segments"];
   if (segmentsDigest === undefined) {
     throw alignSegmentsRequiredError("candidate-ops");
@@ -62140,7 +62540,8 @@ async function saveRecoverableCompileDraft(input) {
     severity: "error",
     message: "Compile draft parsed, but validation failed. A patchable draft session was saved.",
     next_action: "Read draft status, patch only the failed action(s), then rerun compile draft prepare.",
-    command: `context compile --draft-status ${input.slug} --format json`
+    command: `context compile --draft-status ${input.slug} --format json`,
+    patch_schema_version: COMPILE_DRAFT_PATCH_SCHEMA_VERSION
   };
   const session = createCompileDraftSession({
     node: input.slug,
@@ -62172,6 +62573,7 @@ function throwCompileDraftRecoveredError(input) {
     draft_digest: input.recovery.payload.digest,
     draft_status_command: `context compile --draft-status ${input.slug} --format json`,
     patch_command: `context compile --draft-patch ${input.slug} --input - --plan`,
+    patch_schema_version: COMPILE_DRAFT_PATCH_SCHEMA_VERSION,
     issues: input.recovery.issues,
     agent_hints: input.recovery.agent_hints
   });
@@ -62695,6 +63097,9 @@ async function prepareCompileDraftWorkflow(input) {
 }
 
 // src/commands/compileDraftCommand.ts
+function isRecord31(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 async function writeCompileDraftChallengePayloads2(input) {
   const payloads = await compileDraftChallengePayloads({
     ctxDir: input.ctxDir,
@@ -62722,6 +63127,24 @@ async function writeCompileDraftChallengePayloads2(input) {
     });
   }
 }
+function preparedReconcileItems(value, slug) {
+  if (!isRecord31(value) || !Array.isArray(value.items))
+    return [];
+  const target = isRecord31(value.target) ? value.target : undefined;
+  if (target !== undefined && target.node !== slug)
+    return [];
+  return value.items.filter(isRecord31).flatMap((item) => {
+    if (typeof item.item_id !== "string")
+      return [];
+    const sourceSupport = isRecord31(item.source_support) && typeof item.source_support.verdict === "string" ? { verdict: item.source_support.verdict } : undefined;
+    return [{
+      item_id: item.item_id,
+      ...typeof item.draft_action_id === "string" ? { draft_action_id: item.draft_action_id } : {},
+      ...typeof item.status === "string" ? { status: item.status } : {},
+      ...sourceSupport !== undefined ? { source_support: sourceSupport } : {}
+    }];
+  });
+}
 async function runDraftStatus(input) {
   const current = requireCurrentWorkflow(await readCurrentWorkflow(input.ctxDir));
   if (current.family !== "compile") {
@@ -62738,11 +63161,22 @@ async function runDraftStatus(input) {
   });
   const session = parseCompileDraftSession(payload.value);
   assertCompileDraftSessionNode(session, input.slug);
+  const preparePayload = await readWorkflowPayloadByDigest({
+    ctxDir: input.ctxDir,
+    workflowId: current.workflow_id,
+    scopeId: nodeRunIdForSlug(input.slug),
+    payload: "prepare",
+    fallbackToUniqueScope: true
+  }).catch(() => {
+    return;
+  });
+  const prepareItems = preparePayload === undefined ? [] : preparedReconcileItems(preparePayload.value, input.slug);
   writeCompileDraftStatus({
     session,
     digest: payload.digest,
     showCommand: workflowPayloadShowCommand(payload),
-    format: compileChangesFormat(input.format)
+    format: compileChangesFormat(input.format),
+    ...preparePayload !== undefined && prepareItems.length > 0 ? { preparedReconcile: { digest: preparePayload.digest, items: prepareItems } } : {}
   });
 }
 async function runDraftPatch(input) {
@@ -62986,6 +63420,40 @@ function collectRequestedBlock(value, previous) {
 function ignoredSourceIds(value) {
   return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.length > 0) : [];
 }
+function parseRequestFullTextRange(value) {
+  if (value === undefined)
+    return;
+  if (typeof value !== "string") {
+    throw new ContextError(ExitCode.UserError, "--request-full-text-range must be start:end", {
+      category: ErrorCategory.UserInputInvalid,
+      flag: "--request-full-text-range"
+    });
+  }
+  const match = /^(\d+):(\d+)$/u.exec(value.trim());
+  if (!match) {
+    throw new ContextError(ExitCode.UserError, "--request-full-text-range must be start:end", {
+      category: ErrorCategory.UserInputInvalid,
+      flag: "--request-full-text-range",
+      agent_hints: [{
+        code: "compile-request-full-text-invalid",
+        severity: "error",
+        message: "request_full_text pagination uses block-relative line ranges such as 21:40.",
+        path: "request_full_text.range",
+        reason_code: "range-format-invalid",
+        next_action: "Use raw_snippets[].full_text_page.next_range or omit --request-full-text-range."
+      }]
+    });
+  }
+  const start2 = Number(match[1]);
+  const end = Number(match[2]);
+  if (!Number.isSafeInteger(start2) || !Number.isSafeInteger(end) || start2 < 1 || end < start2) {
+    throw new ContextError(ExitCode.UserError, "--request-full-text-range must be an increasing positive line range", {
+      category: ErrorCategory.UserInputInvalid,
+      flag: "--request-full-text-range"
+    });
+  }
+  return { start: start2, end };
+}
 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> --reason "<reason>"' : 'context compile --coverage-skip <candidate-id> --coverage-disposition-node <slug> --reason "<reason>"';
@@ -63029,7 +63497,7 @@ function compileScopeForOptions(options) {
 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("--cover-uncovered-only", "with --context, return only unresolved coverage candidates for a targeted repair round").option("--source-refs <slug>", "print compact citation source_ref list for one align node").option("--request-full-text <block-id>", "with --context, expand one visible finalized evidence block", collectRequestedBlock, []).option("--node-cycle <slug>", "validate one node draft, prepare reconcile, review safe defaults, and apply in one command").option("--delegated", "with a new compile workflow, record user-authorized delegated mode for low-risk review decisions").option("--draft <slug>", "validate a compile draft JSON/YAML document from stdin, or with --prepare reuse the saved draft").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>", "optional workflow payload digest stale guard 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) => {
+  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("--cover-uncovered-only", "with --context, return only unresolved coverage candidates for a targeted repair round").option("--source-refs <slug>", "print compact citation source_ref list for one align node").option("--request-full-text <block-id>", "with --context, expand one visible finalized evidence block", collectRequestedBlock, []).option("--request-full-text-range <start:end>", "with --request-full-text, read a block-relative line page").option("--node-cycle <slug>", "validate one node draft, prepare reconcile, review safe defaults, and apply in one command").option("--delegated", "with a new compile workflow, record user-authorized delegated mode for low-risk review decisions").option("--draft <slug>", "validate a compile draft JSON/YAML document from stdin, or with --prepare reuse the saved draft").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>", "optional workflow payload digest stale guard 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,
@@ -63045,7 +63513,7 @@ 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.coverageSkipUnresolved === true, options.close === true);
     if (actionCount !== 1) {
-      throw new ContextError(ExitCode.UserError, "usage: context compile --scan-changes [--delegated] | --context <slug> [--delegated] | --source-refs <slug> | --node-cycle <slug> --input - --accept-safe-defaults [--delegated] | --draft <slug> --input - --plan [--prepare] [--delegated] | --draft <slug> --plan --prepare | --draft-status <slug> | --draft-patch <slug> --input - --plan [--payload-digest <digest>] | --coverage-disposition - --coverage-disposition-node <slug> [--payload-digest <digest>] | --coverage-skip <candidate-id> --coverage-disposition-node <slug> --reason <text> | --coverage-skip-unresolved --coverage-disposition-node <slug> --reason <text> | --close", { category: ErrorCategory.UserInputInvalid });
+      throw new ContextError(ExitCode.UserError, "usage: context compile --scan-changes [--delegated] | --context <slug> [--request-full-text <block-id> [--request-full-text-range <start:end>]] [--delegated] | --source-refs <slug> | --node-cycle <slug> --input - --accept-safe-defaults [--delegated] | --draft <slug> --input - --plan [--prepare] [--delegated] | --draft <slug> --plan --prepare | --draft-status <slug> | --draft-patch <slug> --input - --plan [--payload-digest <digest>] | --coverage-disposition - --coverage-disposition-node <slug> [--payload-digest <digest>] | --coverage-skip <candidate-id> --coverage-disposition-node <slug> --reason <text> | --coverage-skip-unresolved --coverage-disposition-node <slug> --reason <text> | --close", { category: ErrorCategory.UserInputInvalid });
     }
     const viewWasExplicit = typeof options.view === "string";
     const view = compileOutputView(options.view);
@@ -63073,6 +63541,7 @@ function registerWorkflowCommands(program2) {
       }
     }
     const requestFullTextBlockIds = ignoredSourceIds(options.requestFullText);
+    const requestFullTextRange = parseRequestFullTextRange(options.requestFullTextRange);
     const coverUncoveredOnly = options.coverUncoveredOnly === true;
     const delegated = options.delegated === true;
     const delegatedAllowed = wantsChanges || typeof options.context === "string" || typeof options.nodeCycle === "string" || typeof options.draft === "string";
@@ -63111,6 +63580,20 @@ function registerWorkflowCommands(program2) {
         flag: "--request-full-text"
       });
     }
+    if (requestFullTextRange !== undefined && requestFullTextBlockIds.length !== 1) {
+      throw new ContextError(ExitCode.UserError, "--request-full-text-range requires exactly one --request-full-text block id", {
+        category: ErrorCategory.UserInputInvalid,
+        flag: "--request-full-text-range",
+        agent_hints: [{
+          code: "compile-request-full-text-invalid",
+          severity: "error",
+          message: "request_full_text range continues one long block page at a time.",
+          path: "request_full_text.range",
+          reason_code: "range-requires-single-block",
+          next_action: "Retry with one --request-full-text <block_id>, or omit --request-full-text-range."
+        }]
+      });
+    }
     if (coverUncoveredOnly && typeof options.context !== "string") {
       throw new ContextError(ExitCode.UserError, "--cover-uncovered-only is only valid with --context", {
         category: ErrorCategory.UserInputInvalid,
@@ -63229,7 +63712,8 @@ function registerWorkflowCommands(program2) {
         if (typeof options.sourceRefs === "string") {
           const format = compileChangesFormat(options.format);
           const context = await getNodeContext(ctx.ctxDir, options.sourceRefs, {
-            ...requestFullTextBlockIds.length > 0 ? { requestFullTextBlockIds } : {}
+            ...requestFullTextBlockIds.length > 0 ? { requestFullTextBlockIds } : {},
+            ...requestFullTextRange !== undefined ? { requestFullTextRange } : {}
           });
           writeCompileSourceRefs(context, format);
           return;
@@ -63247,7 +63731,8 @@ function registerWorkflowCommands(program2) {
           let context = await getNodeContext(ctx.ctxDir, options.context, {
             ...view !== "source-refs" && !coverUncoveredOnly ? { mode: "changed-only" } : {},
             ...ignoreSourceIds.length > 0 ? { ignoreSourceIds } : {},
-            ...requestFullTextBlockIds.length > 0 ? { requestFullTextBlockIds } : {}
+            ...requestFullTextBlockIds.length > 0 ? { requestFullTextBlockIds } : {},
+            ...requestFullTextRange !== undefined ? { requestFullTextRange } : {}
           });
           const sourceFinalize = await readCurrentSourceOwnershipRecord(ctx.ctxDir).then((record) => record === null ? undefined : publishedSourceOwnershipSummary(record));
           const selectedCoverageStatus = coverUncoveredOnly ? await readCoverageWorkspaceStatus(ctx.ctxDir) : undefined;
@@ -63334,13 +63819,15 @@ function registerWorkflowCommands(program2) {
             scopeId,
             payload: "coverage-candidates",
             ...requestedDigest !== undefined ? { digest: requestedDigest } : {},
-            fallbackToUniqueScope: true
+            fallbackToUniqueScope: requestedNode === undefined
           });
           if (requestedNode === undefined)
             inferred.push(`node/scope: ${payload.scope_id}`);
           if (requestedDigest === undefined)
             inferred.push("coverage payload digest");
           const value = payload.value;
+          const subjectNode = requestedNode ?? value.node ?? scopeId;
+          const nodeMetadataWarning = requestedNode !== undefined && value.node !== undefined && value.node !== requestedNode ? `coverage payload node metadata was ${value.node}; using requested node ${requestedNode}` : undefined;
           const candidates = Array.isArray(value.candidates) ? value.candidates : [];
           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 });
@@ -63354,10 +63841,11 @@ function registerWorkflowCommands(program2) {
           process.stdout.write(formatFeedback({
             symbol: status.high_signal_unresolved > 0 ? "⚠" : "✓",
             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}`,
+            subject: typeof options.coverageSkip === "string" ? `coverage candidate ${options.coverageSkip}` : options.coverageSkipUnresolved === true ? `${skippedCount} unresolved coverage candidate(s) for ${subjectNode}` : `coverage disposition ${options.coverageDispositionNode}`,
             headline: formatCoverageSummary(status),
             body: [
               workflowSummaryLine(workflowState),
+              nodeMetadataWarning,
               ...inferred.length > 0 ? [`inferred from current workflow: ${inferred.join("; ")}`] : [],
               `payload digest: ${payload.digest} (optional stale guard)`
             ],
@@ -64742,7 +65230,7 @@ function reconcileSchemaExample(name) {
         "Run context reconcile review before apply. Review persists the ready artifact; apply reads it from the current workflow scope.",
         "If prepare items include default_decision and you accept it, emit one compact decision object per item_id with accept_default: true; review hydrates target/proposed/action from that default.",
         "Do not use decisions: [] to accept all defaults; an empty decisions array means no decisions were made.",
-        "Keep proposed.content as the user-facing Section text. For long content, include proposed.summary as one plain paragraph; do not emit retired long-form fields.",
+        "Keep proposed.content as the user-facing Section text. Include proposed.summary only when it helps reader scanability or query output; do not emit retired long-form fields.",
         "Do not copy basis/evidence text into hidden fields just to show the original raw text; source_ref/source_refs already provide traceability. Preserved raw wording is acceptable only when it is active user-facing Section content.",
         "For kind=example, preserving the cited fenced code/config/command block in proposed.content is active example knowledge, 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.',
@@ -64846,6 +65334,7 @@ function compileSchemaExample(name) {
         "Op naming standard: compile-draft actions[] already targets Sections, so Section lifecycle ops are verb-only names. Use op: add for a new Section; do not use add_section, write_section, or propose_section.",
         "Every add/update/supersede Section write uses content plus source_refs[]. content is the user-facing Section text and may be long or contain fenced code.",
         "If content is longer than 200 characters, provide summary. summary is LLM-authored, one plain paragraph, about content length / 10, minimum 10 characters, recommended maximum 120. The CLI reports summary quality as warning hints, not hard errors.",
+        "source_support hard-term matching checks content (and legacy detail when present), not summary. Keep summary faithful to content, but do not add raw-only keywords just to satisfy source_support.",
         "content should default to the cited raw wording. Only make semantic-preserving edits for formatting, typos, casing, entity/alias consistency, or sentence cleanup. If raw is already clear, keep content equal to raw.",
         "source_support is a lexical diagnostic, not a target to game. There is no separate default evidence-echo warning; preserve source wording only when it is active user-facing knowledge, not traceability padding.",
         "For description/spec, a short summary plus cited descriptive bullets in content is allowed when the bullets themselves are useful knowledge. For code/config/command samples, prefer kind=example and keep the sample in content.",
@@ -64967,12 +65456,13 @@ function compileSchemaExample(name) {
       consumed_by: [
         "context compile --draft-patch <slug> --input - --plan"
       ],
-      required: ["schema_version", "operations"],
+      required: ["operations"],
       enums: {
         op: ["replace_action", "remove_action", "add_action"]
       },
       notes: [
         "Read the current draft with context compile --draft-status <slug> --format json.",
+        "schema_version may be omitted; when present it must match the schema_version shown here or draft-status.patch_schema_version.",
         "The CLI reads the current draft session by default; add --payload-digest only when an explicit stale guard is needed.",
         "replace_action keeps the same action_id; add_action receives a new CLI-owned action_id.",
         "The CLI validates the whole patched draft before saving it, so failed patches do not corrupt the current draft session."
@@ -65044,7 +65534,7 @@ function compileSchemaExample(name) {
             "section.content",
             "user_facing_report"
           ],
-          instruction: "Generate knowledge titles, summaries, and user-facing reports in Chinese; keep node.summary concise (target <15 tokens, never >30 tokens); section.summary is a short one-paragraph reader/query aid for long content; for source-bound Section content, prefer the cited source language when it differs from Chinese; preserve product names, code identifiers, CLI flags, block_id/source_ref tokens, slugs, and quoted evidence exactly when needed."
+          instruction: "Generate knowledge titles, summaries, and user-facing reports in Chinese; keep node.summary concise (target <15 tokens, never >30 tokens); section.summary is optional reader/query aid when useful; for source-bound Section content, prefer the cited source language when it differs from Chinese; preserve product names, code identifiers, CLI flags, block_id/source_ref tokens, slugs, and quoted evidence exactly when needed."
         },
         existing: {
           sections: [{