@c4a/context-cli 0.7.35 → 0.7.36

package/cli.js

@@ -79425,6 +79425,33 @@ var init_productionStage = __esm(() => {
   terminal = new Set(["accepted", "excluded", "replaced"]);
 });
 
+// src/project/productionSourceSummary.ts
+function productionSourceSummary(stage) {
+  const pending = new Set(stage.pending_scopes);
+  const unavailable = new Set(stage.gaps.map((gap) => gap.scope));
+  return {
+    stage_source_count: new Set(stage.scopes.map((source2) => source2.scope)).size,
+    pending_scope_count: pending.size,
+    unavailable_source_count: unavailable.size,
+    pending_without_read_failure_count: [...pending].filter((scope2) => !unavailable.has(scope2)).length,
+    planned_article_count: new Set(stage.tasks.filter((task) => !["excluded", "replaced"].includes(task.status)).map((task) => task.path)).size,
+    unavailable_sources: stage.gaps,
+    meaning: "Pending scopes are remaining investigation, not missing knowledge or failed captures. Unavailable sources have current material/baseline read failures; inspect their reasons. Counts can overlap and must not be added. Restore required code dependencies even for document-led work."
+  };
+}
+function productionSourceSummaryMarkdown(stage) {
+  const summary = productionSourceSummary(stage);
+  return [
+    "## Source availability and progress",
+    "",
+    `Stage sources: ${summary.stage_source_count}; pending investigation scopes: ${summary.pending_scope_count}; sources with read failures: ${summary.unavailable_source_count}; pending scopes without read failures: ${summary.pending_without_read_failure_count}; planned articles: ${summary.planned_article_count}.`,
+    summary.meaning,
+    "",
+    ...summary.unavailable_sources.map((gap) => `- ${gap.scope}: ${gap.reason}`),
+    ""
+  ];
+}
+
 // src/project/productionStageStore.ts
 var exports_productionStageStore = {};
 __export(exports_productionStageStore, {
@@ -79544,8 +79571,7 @@ function productionPlanMarkdown(stage) {
       "Then present the updated report and apply context.gate.work_start_scope; an old decision does not approve changed article goals.",
       ""
     ] : [],
-    ...stage.gaps.map((gap) => `- ${gap.scope}: ${gap.reason}`),
-    ""
+    ...productionSourceSummaryMarkdown(stage)
   ].join(`
 `);
 }
@@ -81069,8 +81095,9 @@ async function resolveProductionExclusions(requirements, readBaseline) {
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { readFile as readFile34, access as access3 } from "node:fs/promises";
 import { join as join39 } from "node:path";
-function refreshRequired(stage, message) {
+function refreshRequired(stage, message, detail = {}) {
   return new ContextError(ExitCode.UserError, message, {
+    ...detail,
     category: ErrorCategory.UserInputInvalid,
     reason_code: "production-planning-refresh-required",
     next_action: { command: `context action prepare-current --revision ${stage} --format json` }
@@ -81169,6 +81196,7 @@ Restore the authorized source and retry preparation.
       `Existing reader topics: ${join39(directory, "guidance/existing-articles.md")}`,
       `Stage: ${stage.id}`,
       "",
+      ...productionSourceSummaryMarkdown(stage),
       ...scopes.map((scope2) => `- ${scope2.scope}: ${join39(directory, productionSourceFile(scope2.scope))}`),
       "",
       "Use code skeletons and document outlines to identify the authorized capability families and document tasks, then selectively read full material to decide reader topics. Navigation is not a complete feature inventory. Keep unchecked scope pending; do not parse all code or maintain per-symbol disposition just to plan.",
@@ -81192,7 +81220,7 @@ Restore the authorized source and retry preparation.
       capabilities: productionCapabilitiesSchema.parse({}),
       materials: { ...prepared.materials, sources: sourceMaterials, guidance }
     });
-    return { stage_state: "active", next: { directory, mode: "single-agent" } };
+    return { stage_state: "active", source_summary: productionSourceSummary(stage), next: { directory, mode: "single-agent" } };
   });
 }
 async function submitProductionPlan(input) {
@@ -81220,9 +81248,12 @@ async function submitProductionPlan(input) {
       throw new TypeError("Pending investigation must name unique authorized stage scopes");
     }
     if (stage.gaps.some((gap) => !pendingScopes.includes(gap.scope)))
-      throw refreshRequired(stage.id, "Keep unresolved material gaps in pending_scopes; restore the source if unavailable, then prepare the current stage to refresh its material snapshot");
+      throw refreshRequired(stage.id, "Keep unresolved material gaps in pending_scopes. These are current material/baseline read failures, not evidence that knowledge was never captured. Restore required dependencies before preparing their snapshots; do not label every pending source as unavailable.", {
+        source_summary: productionSourceSummary(stage),
+        missing_pending_scopes: [...new Set(stage.gaps.filter((gap) => !pendingScopes.includes(gap.scope)).map((gap) => gap.scope))]
+      });
     if (plan.articles.some((article) => article.sources.some((scope2) => stage.gaps.some((gap) => gap.scope === scope2)))) {
-      throw refreshRequired(stage.id, "An article requires unavailable material in the captured stage. Restore the source if needed, then prepare the current stage; independent source plans may proceed");
+      throw refreshRequired(stage.id, "An article requires unavailable material in the captured stage. Restore the required source, including code dependencies of document-led work, then prepare the current stage; independent source plans may proceed.", { source_summary: productionSourceSummary(stage) });
     }
     for (const source2 of stage.scopes)
       if (!stage.gaps.some((gap) => gap.scope === source2.scope) && await productionSourceBaseline(input.projectRoot, source2.scope) !== source2.baseline) {
@@ -102470,6 +102501,7 @@ async function projectStatusSummary(status, projectRoot) {
       packages: status.packages.map((item) => ({ name: item.name, state: item.state })),
       meaning: status.evidenceStatus === "not-checked" ? "Progress only: workspace verification and delivery freshness were not checked. Delivery actions validate their inputs; context verify performs an explicit audit." : "Approved pages may not yet be built. Package freshness describes dist; task completion describes the current stage only."
     },
+    counts_scope: "Workspace inventory, not this request’s additions or article workload. Captured documents, approved articles, pending investigation and source-read failures are different measures; source ready counts alone do not explain failure causes.",
     counts: {
       sources: status.sourceSummary,
       draftCandidates: status.draftCandidates,
@@ -106412,7 +106444,8 @@ async function acknowledgeCurrentWorkflowResources(input) {
     resourceAcknowledgement: {
       protocol: "context.workflow.resource-receipts.v1",
       acknowledged: directResources.length,
-      receiptReference: `@${join92(found.projectRoot, continuation.path)}`
+      receiptReference: `@${join92(found.projectRoot, continuation.path)}`,
+      message: "Read the returned workflow and follow its selected command unchanged, including revision and resource-receipt arguments. Do not pre-chain an earlier write command or replace this result with status without receipts. Acknowledgement does not necessarily change the revision; reread only changed or unavailable required content."
     }
   };
 }