@c4a/context-cli 0.5.41-beta.4 → 0.5.41-beta.5

package/cli.js

@@ -38084,6 +38084,7 @@ var init_alignWorkflowStructureSchemas = __esm(() => {
         "Skipping a relation-only, navigation-only, or placeholder-only source does not dispose of its coverable blocks. If you do not emit any Node for that source, still add an ownership_groups[] source_id rule that marks the source context_only or ignored; placeholder-only sources with no kept Node usually use ignored.",
         "Emit depends_on only when cited blocks explicitly say one Node consumes, requires, calls, is configured by, or is downstream of another Node as a prerequisite, capability provider, upstream input, runtime dependency, or data-flow source. Direction is consumer/downstream -> provider/upstream.",
         "Do not emit depends_on for parent/child containment, Related/See also lists, sibling co-occurrence, shared table membership, name similarity, or a plain mention without a dependency predicate.",
+        "Use edges[].from/to for endpoints, or from_ref/to_ref for llm_slug_hint values. Do not use source/target or consumer/provider.",
         "edges[].evidence_blocks must include the block that states the dependency. If the relation matters but evidence is missing, leave the edge out or add an unresolved question instead of guessing.",
         "The persisted workspace truth remains canonical align-structure-decision; this schema is an authoring input only."
       ]
@@ -45537,7 +45538,7 @@ function nodeLanguageIssues(input) {
   return [{
     severity: "warning",
     code: NODE_GENERATION_LANGUAGE_INCONSISTENT,
-    message: `node ${fields.join("/")} appears to be English prose, but workspace generation language is Chinese`,
+    message: `generated node metadata ${fields.join("/")} appears to be English prose, but workspace generation language is Chinese`,
     path: input.path,
     slug: input.node.id
   }];
@@ -46954,13 +46955,15 @@ function staleSourceSnapshot(input) {
   };
 }
 function pushStaleSourceSnapshotIssue(input) {
+  const sourceRef = input.sourceRef ?? input.section.source_ref;
   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})`,
+    message: `section source_ref "${sourceRef}" 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
+    sectionId: input.section.id,
+    source_ref: sourceRef
   });
 }
 function normalizedRawForCompare(value) {
@@ -47000,12 +47003,122 @@ function pushSectionRawStateIssues(input) {
     });
   }
 }
+function pushRawSourceRefIssue(input) {
+  input.issues.push({
+    severity: "error",
+    code: input.code,
+    message: input.message,
+    path: input.node.relativePath,
+    slug: input.node.parsed.node.id,
+    sectionId: input.section.id,
+    source_ref: input.sourceRef
+  });
+}
+async function validateRawSectionSourceRef(input) {
+  const { ctxDir, node: node3, section, sourceRef, sourcesById, rawBlockCache, issues } = input;
+  const parsed = parseSourceRef(sourceRef);
+  if (!parsed) {
+    pushRawSourceRefIssue({
+      issues,
+      node: node3,
+      section,
+      sourceRef,
+      code: "invalid-source-ref",
+      message: `section source_ref "${sourceRef}" must use ${SOURCE_REF_FORMAT_HINT}, for example ${SOURCE_REF_FORMAT_EXAMPLE}`
+    });
+    return null;
+  }
+  const aliasMatch = /^src-(\d+)#/.exec(sourceRef);
+  const aliasIndex2 = Number(aliasMatch?.[1] ?? "0");
+  if (aliasIndex2 <= 0 || aliasIndex2 > node3.parsed.node.sources.length) {
+    pushRawSourceRefIssue({
+      issues,
+      node: node3,
+      section,
+      sourceRef,
+      code: "dangling-source-alias",
+      message: `section source_ref "${sourceRef}" points past node.sources[]`
+    });
+    return null;
+  }
+  const sourceEntry = node3.parsed.node.sources[aliasIndex2 - 1];
+  if (!sourceEntry) {
+    pushRawSourceRefIssue({
+      issues,
+      node: node3,
+      section,
+      sourceRef,
+      code: "dangling-source-alias",
+      message: `section source_ref "${sourceRef}" points to an empty node.sources[] slot`
+    });
+    return null;
+  }
+  const sourceId = sourceIdWithoutVersion(sourceEntry);
+  const source2 = sourcesById.get(sourceId);
+  if (source2?.status !== "active")
+    return null;
+  const stale = staleSourceSnapshot({ sourceEntry, source: source2 });
+  if (stale !== null) {
+    pushStaleSourceSnapshotIssue({ issues, node: node3, section, sourceEntry, sourceRef, stale });
+    return null;
+  }
+  const resolvedSourceRef = await resolveHashedSourceRef({
+    ctxDir,
+    sourceRef,
+    nodeSources: node3.parsed.node.sources,
+    allowStableLocatorReanchor: true
+  });
+  if (resolvedSourceRef === null) {
+    pushRawSourceRefIssue({
+      issues,
+      node: node3,
+      section,
+      sourceRef,
+      code: "invalid-source-ref",
+      message: `section source_ref "${sourceRef}" must include a valid @hash for a raw evidence block`
+    });
+    return null;
+  }
+  if (input.validateCanonical !== false && resolvedSourceRef.source_ref !== sourceRef) {
+    pushRawSourceRefIssue({
+      issues,
+      node: node3,
+      section,
+      sourceRef,
+      code: "invalid-source-ref",
+      message: `section source_ref "${sourceRef}" is not canonical; expected "${resolvedSourceRef.source_ref}"`
+    });
+    return null;
+  }
+  if (input.validateRawOverlap !== false) {
+    const hasOverlap = await sourceRefHasRawBlockOverlap({
+      ctxDir,
+      source: source2,
+      cache: rawBlockCache,
+      lineStart: parsed.lineStart,
+      lineEnd: parsed.lineEnd,
+      sourceEntry
+    });
+    if (hasOverlap === false) {
+      pushRawSourceRefIssue({
+        issues,
+        node: node3,
+        section,
+        sourceRef,
+        code: "source-ref-out-of-range",
+        message: `section source_ref "${sourceRef}" does not overlap any raw block in latest source snapshot`
+      });
+      return null;
+    }
+  }
+  return resolvedSourceRef;
+}
 async function pushSectionReferenceIssues(input) {
   const { node: node3, section, issues } = input;
   if (section.status === SectionStatus.deprecated)
     return;
   pushSectionRawStateIssues({ issues, node: node3, section });
-  const nodeHasCodeSource = node3.parsed.node.sources.some((source3) => sourceIdWithoutVersion(source3).startsWith("aspect:code:"));
+  const nodeHasCodeSource = node3.parsed.node.sources.some((source2) => sourceIdWithoutVersion(source2).startsWith("aspect:code:"));
   for (const target of section.refers_to_nodes ?? []) {
     if (!input.knownRefSlugs.has(target)) {
       issues.push({
@@ -47027,6 +47140,21 @@ async function pushSectionReferenceIssues(input) {
       });
     }
   }
+  for (const sourceRef of [...new Set(section.source_refs ?? [])]) {
+    if (sourceRef === section.source_ref)
+      continue;
+    await validateRawSectionSourceRef({
+      ctxDir: input.ctxDir,
+      node: node3,
+      section,
+      sourceRef,
+      sourcesById: input.sourcesById,
+      rawBlockCache: input.rawBlockCache,
+      issues,
+      validateRawOverlap: false,
+      validateCanonical: false
+    });
+  }
   if (section.source_ref.length === 0)
     return;
   const dispatch = dispatchSourceRef(node3.parsed.node.sources, section.source_ref);
@@ -47065,13 +47193,13 @@ async function pushSectionReferenceIssues(input) {
       });
       return;
     }
-    const source3 = input.sourcesById.get(sourceIdWithoutVersion(dispatch.sourceEntry));
+    const source2 = input.sourcesById.get(sourceIdWithoutVersion(dispatch.sourceEntry));
     await pushCodeSourceReferenceIssues({
       ctxDir: input.ctxDir,
       node: node3,
       section,
       sourceEntry: dispatch.sourceEntry,
-      source: source3,
+      source: source2,
       parsed: dispatch.code,
       issues
     });
@@ -47089,11 +47217,11 @@ async function pushSectionReferenceIssues(input) {
       });
       return;
     }
-    const source3 = input.sourcesById.get(sourceIdWithoutVersion(dispatch.sourceEntry));
-    if (source3 !== undefined) {
-      const stale2 = staleSourceSnapshot({ sourceEntry: dispatch.sourceEntry, source: source3 });
-      if (stale2 !== null) {
-        pushStaleSourceSnapshotIssue({ issues, node: node3, section, sourceEntry: dispatch.sourceEntry, stale: stale2 });
+    const source2 = input.sourcesById.get(sourceIdWithoutVersion(dispatch.sourceEntry));
+    if (source2 !== undefined) {
+      const stale = staleSourceSnapshot({ sourceEntry: dispatch.sourceEntry, source: source2 });
+      if (stale !== null) {
+        pushStaleSourceSnapshotIssue({ issues, node: node3, section, sourceEntry: dispatch.sourceEntry, stale });
         return;
       }
     }
@@ -47102,103 +47230,22 @@ async function pushSectionReferenceIssues(input) {
       node: node3,
       section,
       sourceEntry: dispatch.sourceEntry,
-      source: source3,
+      source: source2,
       parsed: dispatch.aspectFile,
       issues
     });
     return;
   }
-  const parsed = parseSourceRef(section.source_ref);
-  if (!parsed) {
-    issues.push({
-      severity: "error",
-      code: "invalid-source-ref",
-      message: `section source_ref "${section.source_ref}" must use ${SOURCE_REF_FORMAT_HINT}, for example ${SOURCE_REF_FORMAT_EXAMPLE}`,
-      path: node3.relativePath,
-      slug: node3.parsed.node.id,
-      sectionId: section.id
-    });
-    return;
-  }
-  const aliasMatch = /^src-(\d+)#/.exec(section.source_ref);
-  const aliasIndex2 = Number(aliasMatch?.[1] ?? "0");
-  if (aliasIndex2 <= 0 || aliasIndex2 > node3.parsed.node.sources.length) {
-    issues.push({
-      severity: "error",
-      code: "dangling-source-alias",
-      message: `section source_ref "${section.source_ref}" points past node.sources[]`,
-      path: node3.relativePath,
-      slug: node3.parsed.node.id,
-      sectionId: section.id
-    });
-    return;
-  }
-  const sourceEntry = node3.parsed.node.sources[aliasIndex2 - 1];
-  if (!sourceEntry) {
-    issues.push({
-      severity: "error",
-      code: "dangling-source-alias",
-      message: `section source_ref "${section.source_ref}" points to an empty node.sources[] slot`,
-      path: node3.relativePath,
-      slug: node3.parsed.node.id,
-      sectionId: section.id
-    });
-    return;
-  }
-  const sourceId = sourceIdWithoutVersion(sourceEntry);
-  const source2 = input.sourcesById.get(sourceId);
-  if (source2?.status !== "active")
-    return;
-  const stale = staleSourceSnapshot({ sourceEntry, source: source2 });
-  if (stale !== null) {
-    pushStaleSourceSnapshotIssue({ issues, node: node3, section, sourceEntry, stale });
-    return;
-  }
-  const resolvedSourceRef = await resolveHashedSourceRef({
+  const resolvedSourceRef = await validateRawSectionSourceRef({
     ctxDir: input.ctxDir,
+    node: node3,
+    section,
     sourceRef: section.source_ref,
-    nodeSources: node3.parsed.node.sources,
-    allowStableLocatorReanchor: true
+    sourcesById: input.sourcesById,
+    rawBlockCache: input.rawBlockCache,
+    issues
   });
   if (resolvedSourceRef === null) {
-    issues.push({
-      severity: "error",
-      code: "invalid-source-ref",
-      message: `section source_ref "${section.source_ref}" must include a valid @hash for a raw evidence block`,
-      path: node3.relativePath,
-      slug: node3.parsed.node.id,
-      sectionId: section.id
-    });
-    return;
-  }
-  if (resolvedSourceRef.source_ref !== section.source_ref) {
-    issues.push({
-      severity: "error",
-      code: "invalid-source-ref",
-      message: `section source_ref "${section.source_ref}" is not canonical; expected "${resolvedSourceRef.source_ref}"`,
-      path: node3.relativePath,
-      slug: node3.parsed.node.id,
-      sectionId: section.id
-    });
-    return;
-  }
-  const hasOverlap = await sourceRefHasRawBlockOverlap({
-    ctxDir: input.ctxDir,
-    source: source2,
-    cache: input.rawBlockCache,
-    lineStart: parsed.lineStart,
-    lineEnd: parsed.lineEnd,
-    sourceEntry
-  });
-  if (hasOverlap === false) {
-    issues.push({
-      severity: "error",
-      code: "source-ref-out-of-range",
-      message: `section source_ref "${section.source_ref}" does not overlap any raw block in latest source snapshot`,
-      path: node3.relativePath,
-      slug: node3.parsed.node.id,
-      sectionId: section.id
-    });
     return;
   }
   const sectionEvidence = sectionEvidenceText(section);
@@ -61258,8 +61305,8 @@ var init_agentHintRegistry = __esm(() => {
     {
       code: "align-node-generation-language-inconsistent",
       severity: "warning",
-      description: "An align payload Node title or summary appears to be generated in a different language from the workspace generation policy.",
-      trigger: "Align validate/finalize sees English-looking node.title or node.summary while align-segments.generation_policy.language is Chinese.",
+      description: "Generated Node metadata appears to use a different language from the workspace generation policy.",
+      trigger: "Align validate/finalize sees English-looking node.title or node.summary while align-segments.generation_policy.language is Chinese. Source-bound Section content can still follow the cited source language.",
       command: "context schema align-structure-intent --view minimal --format json"
     },
     {
@@ -62139,17 +62186,17 @@ function compileAgentEngagementSummary(input) {
   const writeRecords = input.records.filter((record) => record.mode === "compile" && record.action !== "duplicate_skip" && record.action !== "omit" && record.action !== "ask_user");
   const citedRefs = new Set(writeRecords.flatMap(refsFromRecord));
   const templateLikeActions = writeRecords.filter((record) => contentFromRecord(record).some(isTemplateLikeContent)).length;
-  const derivedPrimaryTotal = citedRefs.size + input.coverage.breakdown.primary_unresolved_total + input.coverage.breakdown.primary_covered + input.coverage.breakdown.primary_skipped_total;
+  const derivedPrimaryTotal = citedRefs.size + input.coverage.breakdown.primary_unresolved_total + input.coverage.breakdown.primary_skipped_total;
   const primaryTotal = Math.max(input.coverage.breakdown.primary_content_refs_total, derivedPrimaryTotal);
   const unsupportedOrLowSupport = writeRecords.filter((record) => record.action === "remove_unsupported" || judgeSupportVerdict(record) === "weak" || judgeSupportVerdict(record) === "unsupported").length + input.coverage.breakdown.blocking_unresolved;
-  const severity = writeRecords.length > 0 && citedRefs.size === 0 || primaryTotal > LOW_CITATION_PRIMARY_TOTAL_THRESHOLD && citedRefs.size / primaryTotal < LOW_CITATION_RATE_THRESHOLD || writeRecords.length >= 3 && (input.evidenceViews?.expected_evidence_views_total ?? 0) >= 3 && (input.evidenceViews?.expected_evidence_views_read ?? 0) <= (input.evidenceViews?.expected_evidence_views_total ?? 0) / 3 || templateLikeActions > 0 || unsupportedOrLowSupport > 0 ? "warning" : "info";
+  const severity = writeRecords.length > 0 && citedRefs.size === 0 || writeRecords.length > 0 && primaryTotal > LOW_CITATION_PRIMARY_TOTAL_THRESHOLD && citedRefs.size / primaryTotal < LOW_CITATION_RATE_THRESHOLD || writeRecords.length >= 3 && (input.evidenceViews?.expected_evidence_views_total ?? 0) >= 3 && (input.evidenceViews?.expected_evidence_views_read ?? 0) <= (input.evidenceViews?.expected_evidence_views_total ?? 0) / 3 || templateLikeActions > 0 || unsupportedOrLowSupport > 0 ? "warning" : "info";
   return {
     written_actions: writeRecords.length,
     primary_citable_refs_total: primaryTotal,
     cited_refs_count: citedRefs.size,
     ...input.evidenceViews?.expected_evidence_views_total !== undefined ? { expected_evidence_views_total: input.evidenceViews.expected_evidence_views_total } : {},
     ...input.evidenceViews?.expected_evidence_views_read !== undefined ? { expected_evidence_views_read: input.evidenceViews.expected_evidence_views_read } : {},
-    unexpanded_primary_refs: Math.max(0, primaryTotal - citedRefs.size),
+    unexpanded_primary_refs: writeRecords.length === 0 ? 0 : Math.max(0, primaryTotal - citedRefs.size),
     full_text_requests: input.evidenceViews?.full_text_requests ?? 0,
     template_like_actions: templateLikeActions,
     unsupported_or_low_support_actions: unsupportedOrLowSupport,
@@ -81588,6 +81635,7 @@ async function preflightSemanticDecisions(input) {
       const current = findTargetSection(node3, target.section_id, decision.action);
       const reanchorPatch = {
         ...decision.proposed?.source_ref !== undefined ? { source_ref: decision.proposed.source_ref } : {},
+        ...decision.proposed?.source_refs !== undefined ? { source_refs: decision.proposed.source_refs } : {},
         ...decision.proposed?.confidence !== undefined ? { confidence: decision.proposed.confidence } : {}
       };
       const finalSection = finalSectionFromPatch(current, reanchorPatch);
@@ -81619,7 +81667,8 @@ async function preflightSemanticDecisions(input) {
           ctxDir: input.ctxDir,
           nodeSources: node3.parsed.node.sources,
           section,
-          action: decision.action
+          action: decision.action,
+          sourceRefs: proposed.source_refs
         });
       }
     }
@@ -82452,14 +82501,21 @@ async function canonicalizeProposedForNode(input) {
   const [sourceRef, sourceRefs2, sections] = await Promise.all([
     typeof input.proposed.source_ref === "string" ? canonicalizeSourceRefForNode({ ctxDir: input.ctxDir, node: input.node, sourceRef: input.proposed.source_ref }) : Promise.resolve(undefined),
     input.proposed.source_refs !== undefined ? Promise.all(input.proposed.source_refs.map((ref) => canonicalizeSourceRefForNode({ ctxDir: input.ctxDir, node: input.node, sourceRef: ref }))) : Promise.resolve(undefined),
-    input.proposed.sections !== undefined ? Promise.all(input.proposed.sections.map(async (section) => ({
-      ...section,
-      source_ref: await canonicalizeSourceRefForNode({
-        ctxDir: input.ctxDir,
-        node: input.node,
-        sourceRef: section.source_ref
-      })
-    }))) : Promise.resolve(undefined)
+    input.proposed.sections !== undefined ? Promise.all(input.proposed.sections.map(async (section) => {
+      const [sectionSourceRef, sectionSourceRefs2] = await Promise.all([
+        canonicalizeSourceRefForNode({
+          ctxDir: input.ctxDir,
+          node: input.node,
+          sourceRef: section.source_ref
+        }),
+        section.source_refs !== undefined ? Promise.all(section.source_refs.map((ref) => canonicalizeSourceRefForNode({ ctxDir: input.ctxDir, node: input.node, sourceRef: ref }))) : Promise.resolve(undefined)
+      ]);
+      return {
+        ...section,
+        source_ref: sectionSourceRef,
+        ...sectionSourceRefs2 !== undefined ? { source_refs: [...new Set(sectionSourceRefs2)] } : {}
+      };
+    })) : Promise.resolve(undefined)
   ]);
   return {
     ...input.proposed,
@@ -82593,6 +82649,7 @@ async function applyReanchorPrimitive(input) {
     sectionId: input.sectionId,
     patch: {
       source_ref: input.proposed.source_ref,
+      ...input.proposed.source_refs !== undefined ? { source_refs: input.proposed.source_refs } : {},
       confidence: input.proposed.confidence
     }
   });
@@ -88983,7 +89040,7 @@ function projectNodeContextSourceRefsIndex(value, options = {}, baseCommand = "c
     selectionPolicy: {
       ...SOURCE_REFS_SELECTION_POLICY,
       id: "source-refs-index-v1",
-      note: "Compact block id index for compile-draft source_block_ids shorthand."
+      note: "Compact block id index for compile-draft source_block_ids shorthand; multi-block actions must stay within one same-source contiguous citation-eligible run."
     },
     howToExplore: sourceRefsHowToExplore({
       rows,
@@ -89001,7 +89058,7 @@ function projectNodeContextSourceRefsIndex(value, options = {}, baseCommand = "c
     view_of: "NodeContext.raw_snippets",
     projection_mode: projectionMode,
     current_workset_scope: projectionScope,
-    usage: "Use items[].block_id in compile-draft actions[].source_block_ids. Open source-refs detail only when text preview or canonical source_ref strings are needed.",
+    usage: "Use items[].block_id in compile-draft actions[].source_block_ids. For multi-block actions, use one same-source contiguous citation-eligible run; split around skipped citation-eligible rows or run draft-scaffold when unsure. Open source-refs detail only when text preview or canonical source_ref strings are needed.",
     ...isRecord37(value.incremental) ? { incremental: stripAgentInternalPathFields(value.incremental) } : {},
     ...Object.keys(filters).length > 0 ? { filters } : {},
     ...window2,
@@ -91698,9 +91755,10 @@ function normalizeEdges(value, refs, slugs) {
     if (raw.edge_type !== "depends_on" && raw.type !== "depends_on") {
       rejectLegacy(`edges[${index2}].edge_type`, `document edge type must be depends_on; allowed runtime EdgeType values are ${EDGE_TYPES.join("|")}`);
     }
-    const unsupportedEndpointFields = ["consumer", "provider"].filter((field) => Object.prototype.hasOwnProperty.call(raw, field));
+    const unsupportedEndpointFields = ["consumer", "provider", "source", "target"].filter((field) => Object.prototype.hasOwnProperty.call(raw, field));
     if (unsupportedEndpointFields.length > 0) {
-      reject(`edges[${index2}]`, "edge endpoint fields consumer/provider are not supported; use from/to or from_ref/to_ref", {
+      const endpointLabel = unsupportedEndpointFields.join("/");
+      reject(`edges[${index2}]`, `edge endpoint fields ${endpointLabel} are not supported; use from/to or from_ref/to_ref`, {
         reasonCode: "edge-endpoint-fields-unsupported",
         currentValue: Object.fromEntries(unsupportedEndpointFields.map((field) => [field, raw[field]])),
         availableNodeRefs: nodeRefsForHint(refs),
@@ -91713,6 +91771,7 @@ function normalizeEdges(value, refs, slugs) {
         }, null, 2),
         repairOptions: [
           "Rename consumer to from and provider to to.",
+          "Rename source to from and target to to.",
           "Use from_ref/to_ref when referring to llm_slug_hint values."
         ]
       });
@@ -93386,7 +93445,7 @@ function agentHintsForNodeLanguageWarnings(input) {
     message: issue2.message,
     path: issue2.path,
     target_node: issue2.slug,
-    next_action: "Revise node.title or node.summary to follow align-segments.generation_policy.language, then rerun context align validate. Preserve product names, code identifiers, slugs, flags, block_id tokens, and citation tokens exactly when needed.",
+    next_action: "Revise generated node.title or node.summary to follow align-segments.generation_policy.language, then rerun context align validate. This warning does not require translating source-bound Section content. Preserve product names, code identifiers, slugs, flags, block_id tokens, and citation tokens exactly when needed.",
     command: "context schema align-structure-intent --view minimal --format json",
     diagnostics: {
       ...input.expectedLanguage !== undefined ? { expected_language: input.expectedLanguage } : {},
@@ -97656,12 +97715,10 @@ function splitActionTemplate(original, split, index2) {
   delete action.source_block_ids;
   delete action.body;
   delete action.raw;
+  delete action.summary;
+  delete action.detail;
   action.source_refs = split.source_refs;
   action.content = `<rewrite content for split ${index2 + 1}; cite only listed source_refs>`;
-  if (typeof action.summary === "string")
-    action.summary = `<optional summary for split ${index2 + 1}>`;
-  if (typeof action.detail === "string")
-    action.detail = `<optional detail for split ${index2 + 1}>`;
   return action;
 }
 function suggestedSplitPatchTemplate(input) {
@@ -98693,14 +98750,12 @@ function draftActionTemplate(kind, rows) {
     return {
       op: "add",
       kind,
-      summary: "<write recall summary with object, mechanism, constraint, action, or entry term>",
       source_block_ids: sourceBlockIds2
     };
   }
   return {
     op: "add",
     kind,
-    summary: "<write recall summary with object, mechanism, constraint, action, or entry term>",
     source_refs: rows.map((row) => row.source_ref)
   };
 }
@@ -99478,7 +99533,7 @@ function plannedTemplateActions(sectionGroups) {
   return plannedReadySectionGroups(sectionGroups).flatMap((group) => recordArray3(group.draft_action_templates));
 }
 function scaffoldUsage() {
-  return "Confirm each action.kind and write a recall-focused summary; omit content by default because the CLI mirrors cited raw from source_block_ids/source_refs. Add content only for intentional translation, structural rewrite, or formatting preservation; c4a:raw is written only for rewritten evidence. Keep hard citation-gap actions separate; if one action cites multiple source_block_ids/source_refs, they must form one contiguous citation-eligible run from the same source, with no intervening citation-eligible block owned by another action. Read section_group_annotations when present because heading/local-heading annotations are context for your semantic split decision. Submit with context compile cycle <node> --input - --format json, or context compile draft <node> --input - for manual review.";
+  return "Confirm each action.kind; add a recall-focused summary only when it improves reader or query output. Omit content by default because the CLI mirrors cited raw from source_block_ids/source_refs. Add content only for intentional translation, structural rewrite, or formatting preservation; c4a:raw is written only for rewritten evidence. Keep hard citation-gap actions separate; if one action cites multiple source_block_ids/source_refs, they must form one contiguous citation-eligible run from the same source, with no intervening citation-eligible block owned by another action. Read section_group_annotations when present because heading/local-heading annotations are context for your semantic split decision. Submit with context compile cycle <node> --input - --format json, or context compile draft <node> --input - for manual review.";
 }
 function stringArray10(value) {
   return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.length > 0) : [];
@@ -99516,9 +99571,10 @@ function requestFullTextCommands(action, rows) {
 function scaffoldAction(action, refersToNodeCandidates = []) {
   const out2 = {
     op: typeof action.op === "string" ? action.op : "add",
-    kind: typeof action.kind === "string" ? action.kind : "description",
-    summary: typeof action.summary === "string" && action.summary.length > 0 ? action.summary : "<write recall summary with object, mechanism, constraint, action, or entry term>"
+    kind: typeof action.kind === "string" ? action.kind : "description"
   };
+  if (typeof action.summary === "string" && action.summary.length > 0)
+    out2.summary = action.summary;
   const sourceBlockIds2 = stringArray10(action.source_block_ids);
   const sourceRefs2 = stringArray10(action.source_refs);
   const refersToNodes = uniqueStrings6([
@@ -99610,7 +99666,6 @@ function sourceRefsDraftScaffold(input) {
       const scaffold = scaffoldAction({
         op: "add",
         kind,
-        summary: "<write recall summary with object, mechanism, constraint, action, or entry term>",
         source_block_ids: typeof row.block_id === "string" ? [row.block_id] : []
       }, input.refersToNodeCandidates);
       const commands = requestFullTextCommands(scaffold, selectedRows);
@@ -99836,7 +99891,7 @@ function sourceRefsSectionGroupHint(sectionGroups) {
     code: "compile-source-refs-planned-section-groups",
     severity: "info",
     message: "planned_section_groups is the primary source-refs authoring path for finalized align section plans.",
-    next_action: splitCount > 0 ? "Use each hard-split planned_section_groups[].draft_action_templates entry as a separate draft action because non-contiguous evidence cannot form one source_ref. heading_spans/local_headings are annotations, not split commands." : "Use planned_section_groups[].draft_action_templates as the default align section scaffold. Confirm kind and summary while keeping source_block_ids shorthand when present; heading_spans/local_headings are annotations when present, not split commands.",
+    next_action: splitCount > 0 ? "Use each hard-split planned_section_groups[].draft_action_templates entry as a separate draft action because non-contiguous evidence cannot form one source_ref. heading_spans/local_headings are annotations, not split commands." : "Use planned_section_groups[].draft_action_templates as the default align section scaffold. Confirm kind; add summary only when it improves reader or query output. Keep source_block_ids shorthand when present; heading_spans/local_headings are annotations when present, not split commands.",
     diagnostics: {
       planned_section_groups: sectionGroups.length,
       split_planned_section_groups: splitCount,
@@ -99861,7 +99916,7 @@ function sourceRefsDenseHintWithSectionGroups(hint, sectionGroups, visibleRows)
   delete baseHint.next_action;
   const plannedSuffix = sectionGroups.length > 0 ? " planned_section_groups are available for finalized align section plans." : "";
   const countSuffix = fullCount !== undefined && fullCount > visibleCitationRows.length ? ` (${fullCount} total in the NodeContext).` : ".";
-  const nextAction = sectionGroups.length > 0 ? "Use planned_section_groups[].draft_action_templates first as the align section scaffold. Confirm kind and summary; fallback may split finer only when a planned group is missing, needs attention, or you intentionally need finer-grained Sections. Treat heading_spans/local_headings as context annotations, not required prefixes." : hint.next_action;
+  const nextAction = sectionGroups.length > 0 ? "Use planned_section_groups[].draft_action_templates first as the align section scaffold. Confirm kind; add summary only when it improves reader or query output. Fallback may split finer only when a planned group is missing, needs attention, or you intentionally need finer-grained Sections. Treat heading_spans/local_headings as context annotations, not required prefixes." : hint.next_action;
   return {
     ...baseHint,
     message: `${visibleCitationRows.length} citation-eligible snippet(s)${sourceId !== undefined ? ` from ${sourceId}` : ""} are visible in this source-refs view${countSuffix}${plannedSuffix}`,
@@ -100035,7 +100090,7 @@ function sourceRefsNextActionEnvelope(input) {
     views: [
       {
         id: "source-refs-index",
-        purpose: "Compact source-ref index contains block ids eligible for compile draft source_block_ids.",
+        purpose: "Compact source-ref index contains block ids eligible for compile draft source_block_ids; multi-block actions must stay within one same-source contiguous citation-eligible run.",
         evidence_role: "primary",
         expected: true,
         budget_safety: "compact",
@@ -100094,14 +100149,14 @@ function writeCompileSourceRefs(context, format, options = {}) {
     code: "compile-source-refs-draft-scaffold-available",
     severity: "info",
     message: "source-refs view can emit a compile-draft skeleton so agents do not manually copy source_ref strings.",
-    next_action: "Run the draft scaffold command, confirm action.kind, and write action.summary; omit content by default because the CLI mirrors cited raw from source_block_ids. Add content only for intentional translation, structural rewrite, or formatting preservation. Keep hard citation-gap templates separate; split heading/local-heading annotated templates only when the cited evidence is semantically separable.",
+    next_action: "Run the draft scaffold command and confirm action.kind. Add action.summary only when it improves reader or query output; omit content by default because the CLI mirrors cited raw from source_block_ids. Add content only for intentional translation, structural rewrite, or formatting preservation. Keep hard citation-gap templates separate; split heading/local-heading annotated templates only when the cited evidence is semantically separable.",
     command: draftScaffoldCommand
   };
   const indexHint = {
     code: "compile-source-refs-index-ready",
     severity: "info",
     message: "source-refs-index is the compact Node-scoped citation index for source_block_ids; it intentionally omits quote previews.",
-    next_action: "Use items[].block_id when the indexed row is the evidence you will cite. Open the detailed source-refs view only when you need quote preview or explicit source_refs.",
+    next_action: "Use items[].block_id when the indexed row is the evidence you will cite. For multi-block actions, use block_ids from one same-source contiguous citation-eligible run; split around skipped citation-eligible rows, or run draft-scaffold when unsure. Open the detailed source-refs view only when you need quote preview or explicit source_refs.",
     command: sourceRefsIndex,
     detail_view_command: sourceRefsDetail
   };
@@ -107125,6 +107180,7 @@ function alignStructureIntentFieldGuidance() {
     },
     edges: {
       edge_type: "Only depends_on is accepted; direction is consumer/downstream -> provider/upstream.",
+      endpoint_fields: "Use from/to for endpoints, or from_ref/to_ref for llm_slug_hint values. Do not use source/target or consumer/provider.",
       evidence_blocks: "Include the block that explicitly states the dependency. Do not use edges for parent/child containment or Related/See also links."
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.5.41-beta.4",
+  "version": "0.5.41-beta.5",
   "type": "module",
   "bin": {
     "context": "./cli.js"

package/plugin/README.md

@@ -107,17 +107,19 @@ The compiled knowledge base can be packaged for distribution:
 
 The numbers below come from a parallel benchmark: each model runs the full c4a flow (capture → align → compile) end-to-end over the same 10-document business corpus, with no manual intervention. Quality is scored across 7 dimensions (totaling 100) based on the resulting knowledge base; duration covers the full flow from `context init` to `compile close`.
 
-| Dimension | Opus 4.8 (Claude) | GPT 5.5 (Codex) | Opus 4.7 (Claude) | DeepSeek V4 Pro (Claude) |
-|---|---:|---:|---:|---:|
-| Fact coverage (25) | 23 | 23 | 22 | 18 |
-| Fact fidelity (25) | 24 | 23 | 19 | 18 |
-| Structure (15) | 14 | 13 | 8 | 7 |
-| URL (5) | 5 | 4 | 2 | 5 |
-| Source ref (10) | 9 | 9 | 7 | 6 |
-| Section boundary (10) | 9 | 10 | 7 | 5 |
-| Schema (10) | 9 | 10 | 9 | 7 |
-| **Total** | **93** | **92** | **74** | **66** |
-| Duration | 30m47s | 10m07s | 19m6s | 14m44s |
+| Dimension | GPT 5.5 xh fast | GPT 5.5 m fast | Opus 4.8 | Sonnet 4.6 | DeepSeek V4 Pro | V4 Flash |
+|---|---:|---:|---:|---:|---:|---:|
+| Fact coverage | 24 | 24 | 24 | 23 | 24 | 23 |
+| Fact fidelity | 25 | 25 | 25 | 25 | 25 | 25 |
+| Structure | 15 | 15 | 15 | 14 | 15 | 14 |
+| URL | 5 | 5 | 5 | 5 | 5 | 5 |
+| Evidence link | 10 | 10 | 10 | 10 | 10 | 7 |
+| Section boundary | 9 | 9 | 8 | 9 | 9 | 3 |
+| Modeling | 9 | 9 | 8 | 8 | 7 | 6 |
+| **Total** | **97** | **97** | **95** | **94** | **95** | **83** |
+| Duration | 5m44s | 4m34s | 20m27s | 20m20s | ~9m28s | 2m37s |
+
+> GPT 5.5 xh fast / GPT 5.5 m fast run on Codex; Opus 4.8 / Sonnet 4.6 / DeepSeek V4 Pro / V4 Flash run on Claude.
 
 ## About this repository
 

package/plugin/README_CN.md

@@ -105,17 +105,19 @@ bun add -g @c4a/context-cli
 
 下方数据来自一次并发基准测试：每个模型在同一份 10 篇业务文档语料上端到端跑完 c4a 全流程（capture → align → compile），无人工介入。质量按 7 个维度评分（总分 100）反映产物知识库；耗时覆盖 `context init` 到 `compile close` 的全流程。
 
-| 维度 | Opus 4.8（Claude） | GPT 5.5（Codex） | Opus 4.7（Claude） | DeepSeek V4 Pro（Claude） |
-|---|---:|---:|---:|---:|
-| 事实覆盖（25） | 23 | 23 | 22 | 18 |
-| 事实忠实（25） | 24 | 23 | 19 | 18 |
-| 结构语义（15） | 14 | 13 | 8 | 7 |
-| URL（5） | 5 | 4 | 2 | 5 |
-| Source ref（10） | 9 | 9 | 7 | 6 |
-| Section 边界（10） | 9 | 10 | 7 | 5 |
-| Schema（10） | 9 | 10 | 9 | 7 |
-| **总分** | **93** | **92** | **74** | **66** |
-| 总耗时 | 30m47s | 10m07s | 19m6s | 14m44s |
+| 维度 | GPT 5.5 xh fast | GPT 5.5 m fast | Opus 4.8 | Sonnet 4.6 | DeepSeek V4 Pro | V4 Flash |
+|---|---:|---:|---:|---:|---:|---:|
+| 事实覆盖 | 24 | 24 | 24 | 23 | 24 | 23 |
+| 事实忠实 | 25 | 25 | 25 | 25 | 25 | 25 |
+| 结构语义 | 15 | 15 | 15 | 14 | 15 | 14 |
+| URL | 5 | 5 | 5 | 5 | 5 | 5 |
+| 证据链 | 10 | 10 | 10 | 10 | 10 | 7 |
+| Section 边界 | 9 | 9 | 8 | 9 | 9 | 3 |
+| 建模 | 9 | 9 | 8 | 8 | 7 | 6 |
+| **总分** | **97** | **97** | **95** | **94** | **95** | **83** |
+| 总耗时 | 5m44s | 4m34s | 20m27s | 20m20s | ~9m28s | 2m37s |
+
+> GPT 5.5 xh fast / GPT 5.5 m fast 运行于 Codex；Opus 4.8 / Sonnet 4.6 / DeepSeek V4 Pro / V4 Flash 运行于 Claude。
 
 ## 关于本仓库
 

package/plugin/commands/compile.md

@@ -57,7 +57,7 @@ Carry the latest envelope forward between iterations. After a successful node cy
 
 Run the evidence command returned by the envelope before writing. `views[].expected` identifies the default compact evidence entry, not a separate checklist to exhaust. For compile evidence, prefer the CLI-returned source-ref/scaffold views. They may expose:
 
-- `source_refs_index_command` / `source_refs_command` — compact Node-scoped citation index for drafting; use `items[].block_id` in `source_block_ids[]` when the row is the evidence you will cite.
+- `source_refs_index_command` / `source_refs_command` — compact Node-scoped citation index for drafting; use `items[].block_id` in `source_block_ids[]` when the row is the evidence you will cite. Multiple block ids in one action must be one same-source contiguous citation-eligible run; split around skipped citation-eligible rows or use `--draft-scaffold` when unsure.
 - `source_refs_detail_command` — detailed source refs with quote previews; open only when the compact index is not enough.
 - `request_full_text_command` / `--view text` — narrow text view for one block when quote preview is not enough; this is still Node-scoped, not a workspace evidence bundle.
 - `citable_source_refs[]` — detailed-view refs eligible for draft citations; prefer `block_id` values in `source_block_ids[]`.