@c4a/context-cli 0.7.11 → 0.7.12

package/cli.js

@@ -56219,7 +56219,9 @@ function projectPackageKnowledgeMarkdown(content3) {
     return content3;
   const body = content3.slice(match[0].length).replace(CONTEXT_METADATA_BLOCK_RE, "").replace(CONTEXT_SECTION_OPEN_RE, (opening) => {
     const key = /\bid="([a-zA-Z0-9_-]+)"/u.exec(opening)?.[1];
-    return key === undefined ? "" : `<a id="section-${encodeURIComponent(key)}"></a>
+    return key === undefined ? "" : `
+
+<a id="section-${encodeURIComponent(key)}"></a>
 
 `;
   }).replace(CONTEXT_SECTION_CLOSE_RE, `
@@ -63869,6 +63871,20 @@ var init_productionStage = __esm(() => {
 });
 
 // src/project/productionStageStore.ts
+var exports_productionStageStore = {};
+__export(exports_productionStageStore, {
+  writeProductionProjection: () => writeProductionProjection,
+  saveProductionStage: () => saveProductionStage,
+  readProductionStageSnapshot: () => readProductionStageSnapshot,
+  readProductionStage: () => readProductionStage,
+  readProductionCapabilities: () => readProductionCapabilities,
+  productionStageDirectory: () => productionStageDirectory,
+  productionSourceFile: () => productionSourceFile,
+  productionPlanMarkdown: () => productionPlanMarkdown,
+  prepareNextProductionStage: () => prepareNextProductionStage,
+  materializeProductionStage: () => materializeProductionStage,
+  PRODUCTION_STAGES_ROOT: () => PRODUCTION_STAGES_ROOT
+});
 import { constants as constants4 } from "node:fs";
 import { readFile as readFile21, access as access2, stat as stat5 } from "node:fs/promises";
 import { join as join20 } from "node:path";
@@ -64800,9 +64816,9 @@ 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 new TypeError("Keep unresolved material gaps in pending_scopes; declaring investigation complete does not resolve unavailable material");
+      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");
     if (plan.articles.some((article) => article.sources.some((scope2) => stage.gaps.some((gap) => gap.scope === scope2)))) {
-      throw new TypeError("An article requires unavailable material. Resolve that source gap before issuing it; independent source plans may proceed");
+      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");
     }
     for (const source2 of stage.scopes)
       if (!stage.gaps.some((gap) => gap.scope === source2.scope) && await productionSourceBaseline(input.projectRoot, source2.scope) !== source2.baseline) {
@@ -64916,7 +64932,7 @@ var init_productionPlanning = __esm(() => {
     }).strict()),
     indexer_usage: exports_external.array(productionIndexerUsageSchema).default([]),
     replaces: exports_external.array(text5).default([]),
-    pending_scopes: exports_external.array(text5).optional()
+    pending_scopes: exports_external.array(text5).describe("Exact authorized source refs from the current stage scopes; no prose or module descriptions. Omit on amendments to preserve remaining investigation.").optional()
   }).strict();
 });
 
@@ -67022,7 +67038,7 @@ var init_indexerMainRunStore = __esm(() => {
 // src/project/productionDeliveryScope.ts
 import { readFile as readFile34 } from "node:fs/promises";
 import { join as join36, posix as posix2 } from "node:path";
-async function productionDeliverableArticles(root) {
+async function productionDeliverableArticles(root, phase = "delivery") {
   return withProductionFeedback({ operation: "delivery-scope" }, async () => {
     const stage = await readProductionStage(root);
     if (!stage)
@@ -67045,6 +67061,8 @@ async function productionDeliverableArticles(root) {
         continue;
       selected.set(article.article_id, { path: article.path, article_id: article.article_id });
     }
+    if (phase === "review")
+      return [...selected.values()];
     for (const article of selected.values()) {
       const markdown = await readFile34(await safeProjectTarget(root, join36("knowledge", article.path)), "utf8");
       for (const link of markdownReaderLinks(markdown)) {
@@ -67143,6 +67161,9 @@ async function clearCompletedLifecycle(projectRoot) {
   if (production) {
     if (production.delivery)
       throw new TypeError("Partial delivery must retain the production stage and its unfinished tasks; finish the build or explicitly resume writing.");
+    if (dispatchProductionStage(production, productionCapabilitiesSchema.parse({})).state !== "ended") {
+      throw new TypeError("Production still has unfinished work; keep its files and follow context status --format json.");
+    }
     const candidates = await readCandidateRecords(projectRoot);
     await assertRequiredArticlesReviewed(projectRoot, candidates);
     if (candidates.some((candidate) => candidate.status === "draft") || (await readProjectCloseStatus(projectRoot)).state !== "ready") {
@@ -67182,6 +67203,7 @@ async function clearCompletedLifecycle(projectRoot) {
 var COMPLETED_RUNTIME_PATHS;
 var init_lifecycleCleanup = __esm(() => {
   init_productionStageStore();
+  init_productionStage();
   init_indexerRequiredArticleReview();
   init_candidateLedger();
   init_close();
@@ -67217,7 +67239,7 @@ async function requestProductionDelivery(root) {
     if (stage.delivery)
       return true;
     const candidates = await readCandidateRecords(root);
-    const formal = await productionDeliverableArticles(root);
+    const formal = await productionDeliverableArticles(root, "review");
     const selected = stage.tasks.filter((task) => task.status === "accepted" && (candidates.some((candidate) => candidate.candidate_id === task.accepted?.receipt) || formal.some((article) => article.article_id === task.article_id && article.path === task.path)));
     if (!selected.length)
       throw new TypeError("No completed articles are available. Continue the current writing task before requesting delivery.");
@@ -67271,7 +67293,7 @@ var init_productionDelivery = __esm(() => {
 
 // src/project/indexerRequiredArticleReview.ts
 async function assertRequiredArticlesReviewed(root, candidates) {
-  if ((await readMaintenance(root)).active)
+  if ((await readMaintenance(root)).active || await readApprovedRevision(root))
     return;
   const rejected = candidates.filter((candidate) => candidate.status === "rejected" && candidate.indexer_candidate);
   const production = await readProductionStage(root);
@@ -67342,6 +67364,7 @@ var init_indexerRequiredArticleReview = __esm(() => {
   init_productionSubmissionFiles();
   init_productionPlanning();
   init_maintenanceStorage();
+  init_approvedRevision();
 });
 
 // src/project/partialDelivery.ts
@@ -70817,6 +70840,14 @@ var siteMarkdownConfig, siteThemeScript, siteThemeCss = `
   .context-home-section, .context-home-powered { width: min(calc(100% - 36px), 680px); margin-left: auto; margin-right: auto; }
   .context-home-resource-grid { grid-template-columns: 1fr; }
 }
+@media (max-width: 959px) {
+  .VPNavBarMenu { display: none !important; }
+  .VPNavBarHamburger { display: flex !important; }
+  .VPNavScreen { display: block !important; }
+  .VPNavBarSearch { flex: 0 0 48px !important; width: 48px; padding: 0 4px !important; }
+  .VPNavBarSearch #local-search, .VPNavBarSearch .DocSearch-Button { width: 40px; }
+  .VPNavBarSearch .DocSearch-Button-Placeholder, .VPNavBarSearch .DocSearch-Button-Keys { display: none !important; }
+}
 @media (prefers-reduced-motion: reduce) {
   .context-home-map-card, .context-home-resource-card { animation: none; }
   .context-home-map-card:hover, .context-home-resource-card:hover { transform: none; }
@@ -70832,7 +70863,7 @@ var siteMarkdownConfig, siteThemeScript, siteThemeCss = `
 .context-sources a { color: inherit; text-decoration: none; border-bottom: 1px solid transparent; }
 .context-sources a:hover { color: var(--vp-c-brand-1); border-color: currentColor; }
 .context-diagram { overflow: auto; padding: 20px; background: var(--vp-c-bg); }
-.context-diagram svg { max-width: none !important; }
+.context-diagram svg { height: auto; }
 .context-diagram .node rect, .context-diagram .node polygon, .context-diagram .node circle,
 .context-diagram .flowchart-link { stroke-width: 1px !important; }
 .context-rendered:not(.context-show-source) pre, .context-rendered:not(.context-show-source) > .copy,
@@ -70889,7 +70920,7 @@ var init_packageSiteTheme = __esm(() => {
       if (!silent) { const token = state.push('context_anchor', '', 0); token.content = match[1]; }
       state.line = line + 1;
       return true;
-    });
+    }, { alt: ['paragraph'] });
     md.renderer.rules.context_anchor = (tokens, index) => '<a id="' + md.utils.escapeHtml(tokens[index].content) + '"></a>\n';
   }
 `;
@@ -71474,7 +71505,7 @@ title: LLM Docs
     await rm11(temporary, { recursive: true, force: true });
   }
 }
-var PACKAGE_SITE_VERSION = "vitepress-site-v41-home-safe-spacing", require2, encodePath = (path2) => path2.split("/").map(encodeURIComponent).join("/"), mdLabel = (value) => value.replace(/[\\[\]<>`*]/gu, "\\$&").replace(/[\r\n]/gu, " ");
+var PACKAGE_SITE_VERSION = "vitepress-site-v42-section-anchor-blocks", require2, encodePath = (path2) => path2.split("/").map(encodeURIComponent).join("/"), mdLabel = (value) => value.replace(/[\\[\]<>`*]/gu, "\\$&").replace(/[\r\n]/gu, " ");
 var init_packageSite2 = __esm(() => {
   init_packageOutputPaths();
   init_workspaceChangelog();
@@ -73188,10 +73219,11 @@ async function buildProjectPackagesInternal(projectRoot, options) {
     if (!production && (!maintenanceActive || (await readRevisionDelivery(projectRoot))?.partial) && !await readTaskRollback(projectRoot))
       await completeRevisionDelivery(projectRoot);
     const { finishApprovedRevision } = await Promise.resolve().then(() => (init_approvedRevision(), exports_approvedRevision));
-    await finishApprovedRevision(projectRoot);
     const { readApprovedRevision: readApprovedRevision2 } = await Promise.resolve().then(() => (init_approvedRevision(), exports_approvedRevision));
+    const revisionInterruptedProduction = !!production && !!await readApprovedRevision2(projectRoot);
+    await finishApprovedRevision(projectRoot);
     const { readKnowledgeUpdate } = await Promise.resolve().then(() => (init_knowledgeUpdate(), exports_knowledgeUpdate));
-    if (!production?.delivery && !maintenanceActive && !await readTaskRollback(projectRoot) && !await readApprovedRevision2(projectRoot) && !await readKnowledgeUpdate(projectRoot) && (await readProjectCloseStatus(projectRoot)).state === "ready") {
+    if (!revisionInterruptedProduction && !production?.delivery && !maintenanceActive && !await readTaskRollback(projectRoot) && !await readApprovedRevision2(projectRoot) && !await readKnowledgeUpdate(projectRoot) && (await readProjectCloseStatus(projectRoot)).state === "ready") {
       const { clearCompletedLifecycle: clearCompletedLifecycle2 } = await Promise.resolve().then(() => (init_lifecycleCleanup(), exports_lifecycleCleanup));
       await clearCompletedLifecycle2(projectRoot);
     }
@@ -74082,7 +74114,7 @@ __export(exports_approvedRevision, {
   assertApprovedRevisionBase: () => assertApprovedRevisionBase,
   APPROVED_REVISION_PATH: () => APPROVED_REVISION_PATH
 });
-import { readFile as readFile56, realpath as realpath6 } from "node:fs/promises";
+import { readFile as readFile56, realpath as realpath6, rm as rm15 } from "node:fs/promises";
 import { join as join66, relative as relative19, isAbsolute as isAbsolute12 } from "node:path";
 function requestDigest(input) {
   const scopes = input.processed_scopes?.filter((scope2) => input.target.source_refs.some((ref) => ref === scope2.source_ref || ref.startsWith(`${scope2.source_ref}#`) || ref.startsWith(`${scope2.source_ref}/`)));
@@ -74537,6 +74569,11 @@ async function advanceApprovedRevision(projectRoot, request) {
   const { finishMaintenanceRevision: finishMaintenanceRevision2 } = await Promise.resolve().then(() => (init_knowledgeMaintenance(), exports_knowledgeMaintenance));
   if (await finishMaintenanceRevision2(projectRoot))
     return;
+  const { readProductionStage: readProductionStage2 } = await Promise.resolve().then(() => (init_productionStageStore(), exports_productionStageStore));
+  if (await readProductionStage2(projectRoot)) {
+    await rm15(join66(projectRoot, await revisionStoragePath(projectRoot)), { force: true });
+    return;
+  }
   const { clearCompletedLifecycle: clearCompletedLifecycle2 } = await Promise.resolve().then(() => (init_lifecycleCleanup(), exports_lifecycleCleanup));
   await clearCompletedLifecycle2(projectRoot);
 }
@@ -80853,7 +80890,7 @@ var init_documentRun = __esm(() => {
 });
 
 // src/lib/atomicFileBatch.ts
-import { lstat as lstat7, mkdir as mkdir25, mkdtemp as mkdtemp3, rename as rename6, rm as rm15, writeFile as writeFile19 } from "node:fs/promises";
+import { lstat as lstat7, mkdir as mkdir25, mkdtemp as mkdtemp3, rename as rename6, rm as rm16, writeFile as writeFile19 } from "node:fs/promises";
 import { dirname as dirname31, join as join70, resolve as resolve23 } from "node:path";
 async function existingFileKind(path2) {
   try {
@@ -80916,7 +80953,7 @@ async function applyAtomicFileBatch(input) {
   } catch (error) {
     const rollbackFailures = [];
     for (const path2 of installed.reverse()) {
-      await rm15(path2, { force: true }).catch((rollbackError) => {
+      await rm16(path2, { force: true }).catch((rollbackError) => {
         rollbackFailures.push(`remove ${path2}: ${String(rollbackError)}`);
       });
     }
@@ -80933,7 +80970,7 @@ async function applyAtomicFileBatch(input) {
     throw error;
   } finally {
     if (!preserveTransaction)
-      await rm15(transactionDir, { recursive: true, force: true });
+      await rm16(transactionDir, { recursive: true, force: true });
   }
 }
 var init_atomicFileBatch = () => {};
@@ -87039,7 +87076,7 @@ var init_larkResourceCommand = __esm(() => {
 
 // src/lib/larkResourceMaterialization.ts
 import { createHash as createHash26 } from "node:crypto";
-import { mkdtemp as mkdtemp4, readFile as readFile67, readdir as readdir18, rm as rm18 } from "node:fs/promises";
+import { mkdtemp as mkdtemp4, readFile as readFile67, readdir as readdir18, rm as rm19 } from "node:fs/promises";
 import { extname as extname13, join as join88 } from "node:path";
 import { tmpdir } from "node:os";
 function countByKind(items, status) {
@@ -87172,7 +87209,7 @@ async function downloadedFile(input) {
     const bytes = await readFile67(join88(tempRoot, path3));
     return { path: path3, bytes, mediaType: mediaTypeFor(path3, bytes) };
   } finally {
-    await rm18(tempRoot, { recursive: true, force: true });
+    await rm19(tempRoot, { recursive: true, force: true });
   }
 }
 function parseCsv(value) {
@@ -87304,7 +87341,7 @@ ${markdownTable2(parseCsv(csv))}
 [CSV snapshot](${sourceAssetTarget(path3)}) <!-- ${resource.locator} -->`
     };
   } finally {
-    await rm18(tempRoot, { recursive: true, force: true });
+    await rm19(tempRoot, { recursive: true, force: true });
   }
 }
 function basePageRecords(value) {
@@ -87438,7 +87475,7 @@ async function whiteboardMaterialization(resource, runner2, identity) {
     ], { cwd: tempRoot });
     rawPayload = JSON.parse(await readFile67(join88(tempRoot, "raw.json"), "utf8"));
   } finally {
-    await rm18(tempRoot, { recursive: true, force: true });
+    await rm19(tempRoot, { recursive: true, force: true });
   }
   const digest6 = resourceDigest(resource);
   const previewPath = `materialized/${resource.kind}/${digest6}${extensionFor2(preview.mediaType, preview.path)}`;
@@ -89374,6 +89411,7 @@ var init_taskLocalSourceAdjustment = __esm(() => {
 // src/project/taskSourceAdjustment.ts
 var exports_taskSourceAdjustment = {};
 __export(exports_taskSourceAdjustment, {
+  taskSourceAdjustmentSchema: () => taskSourceAdjustmentSchema,
   adjustCurrentTaskSources: () => adjustCurrentTaskSources
 });
 async function adjustCurrentTaskSources(projectRoot, value) {
@@ -89428,7 +89466,7 @@ async function adjustCurrentTaskSources(projectRoot, value) {
     });
   });
 }
-var schema2;
+var schema2, taskSourceAdjustmentSchema;
 var init_taskSourceAdjustment = __esm(() => {
   init_src2();
   init_knowledgeMap2();
@@ -89455,6 +89493,7 @@ var init_taskSourceAdjustment = __esm(() => {
     instruction: exports_external.string().trim().min(1),
     refresh: exports_external.boolean().optional()
   }).strict();
+  taskSourceAdjustmentSchema = exports_external.union([schema2, exports_external.object({ knowledge_map: knowledgeMapUpdateSchema }).strict()]);
 });
 
 // src/project/managedDocumentImport.ts
@@ -89846,7 +89885,7 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 import { createHash as createHash21 } from "node:crypto";
-import { mkdir as mkdir26, readdir as readdir16, readFile as readFile60, rm as rm16, stat as stat10, writeFile as writeFile20 } from "node:fs/promises";
+import { mkdir as mkdir26, readdir as readdir16, readFile as readFile60, rm as rm17, stat as stat10, writeFile as writeFile20 } from "node:fs/promises";
 import { basename as basename8, dirname as dirname32, extname as extname12, join as join72, relative as relative22, resolve as resolve24 } from "node:path";
 
 // src/project/documentCaptureAssets.ts
@@ -98092,13 +98131,13 @@ async function removeEmptySnapshotDirs(root, dir = root) {
     return;
   const remaining = await readdir16(dir);
   if (remaining.length === 0) {
-    await rm16(dir, { recursive: true, force: true });
+    await rm17(dir, { recursive: true, force: true });
   }
 }
 async function cleanupStaleSnapshotFiles(input) {
   for (const path2 of input.previousPaths) {
     if (!input.currentPaths.has(path2)) {
-      await rm16(join72(input.materializedAtAbsPath, path2), { force: true });
+      await rm17(join72(input.materializedAtAbsPath, path2), { force: true });
     }
   }
   await removeEmptySnapshotDirs(input.materializedAtAbsPath);
@@ -98471,7 +98510,7 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 import { existsSync as existsSync21 } from "node:fs";
-import { lstat as lstat8, mkdir as mkdir27, readFile as readFile62, readlink, realpath as realpath7, rm as rm17, symlink as symlink2 } from "node:fs/promises";
+import { lstat as lstat8, mkdir as mkdir27, readFile as readFile62, readlink, realpath as realpath7, rm as rm18, symlink as symlink2 } from "node:fs/promises";
 import { execFile as execFile8 } from "node:child_process";
 import { promisify as promisify8 } from "node:util";
 import { dirname as dirname33, isAbsolute as isAbsolute14, join as join76, relative as relative23, resolve as resolve26 } from "node:path";
@@ -98825,7 +98864,7 @@ async function ensureMaterializedSymlink(input) {
     const currentAbs = resolve26(dirname33(linkPath), current2);
     if (currentAbs === input.localAbs)
       return true;
-    await rm17(linkPath);
+    await rm18(linkPath);
   }
   const relTarget = relative23(dirname33(linkPath), input.localAbs) || ".";
   await symlink2(relTarget, linkPath);
@@ -106229,12 +106268,13 @@ async function readProductionReviewCandidates(projectRoot) {
 init_productionFeedback();
 async function loadReviewCandidateAuthority(projectRoot) {
   return withProductionFeedback({ operation: "review" }, async () => {
-    const production = await readProductionReviewCandidates(projectRoot);
-    if (production)
-      return new Map(production.candidates.map((candidate) => [candidate.candidate_id, candidate]));
     const revision = await readApprovedRevision(projectRoot);
-    if (!revision)
+    if (!revision) {
+      const production = await readProductionReviewCandidates(projectRoot);
+      if (production)
+        return new Map(production.candidates.map((candidate) => [candidate.candidate_id, candidate]));
       throw new TypeError("No current production or article revision is available for Review");
+    }
     if (!revision.review_ready && !revision.candidate)
       throw new TypeError("Complete the current article revision before Review");
     const observed = await observeApprovedRevisionBatch(projectRoot, revision);
@@ -108117,9 +108157,19 @@ function registerDocumentRevisionCommand(program2) {
     process.stdout.write(`${JSON.stringify(await cancelKnowledgeMaintenance2(requireProjectRoot2(), id3, options.discardRevision))}
 `);
   });
-  task.command("adjust").description("Adjust current source/module inputs or reader organization while preserving unrelated work").requiredOption("--input <file>", "YAML/JSON source scopes with instruction, or knowledge_map; - for stdin").option("--format <format>", "output format: json", "json").action(async (options) => {
-    if (options.format !== "json")
-      throw new TypeError("--format must be json");
+  task.command("adjust").description("Adjust current source/module inputs or reader organization while preserving unrelated work").option("--input <file>", "YAML/JSON source scopes with instruction, or knowledge_map; - for stdin").option("--schema", "show source adjustment or knowledge map input schema").option("--format <format>", "output format: json", "json").action(async (options) => {
+    if (options.schema) {
+      const { taskSourceAdjustmentSchema: taskSourceAdjustmentSchema2 } = await Promise.resolve().then(() => (init_taskSourceAdjustment(), exports_taskSourceAdjustment));
+      const { zodToJsonSchema: zodToJsonSchema3 } = await Promise.resolve().then(() => (init_esm(), exports_esm));
+      const { writeSchemaOutput: writeSchemaOutput2, schemaOutputFormat: schemaOutputFormat2 } = await Promise.resolve().then(() => (init_schemaOutput(), exports_schemaOutput));
+      writeSchemaOutput2(zodToJsonSchema3(taskSourceAdjustmentSchema2), schemaOutputFormat2(options.format));
+      return;
+    }
+    if (options.format !== "json" || !options.input)
+      throw new ContextError(ExitCode.UserError, "Use --input <file> --format json, or --schema.", {
+        category: ErrorCategory.UserInputInvalid,
+        next_action: { command: "context task adjust --schema --format json" }
+      });
     assertActionInputWorkspace(process.cwd(), options.input);
     const value = await readYamlOrJsonInput({
       path: options.input,
@@ -108792,7 +108842,7 @@ function registerProjectActionCommands(program2) {
 // src/commands/cleanClaudePluginCache.ts
 init_cliFeedback();
 import { existsSync as existsSync27 } from "node:fs";
-import { readdir as readdir23, rm as rm19 } from "node:fs/promises";
+import { readdir as readdir23, rm as rm20 } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join as join98 } from "node:path";
 var ORPHAN_MARKER = ".orphaned_at";
@@ -108830,17 +108880,17 @@ async function cleanClaudePluginCache(opts = {}) {
         if (opts.dryRun) {
           lines.push(`  - would remove: ${label2}`);
         } else {
-          await rm19(verDir, { recursive: true, force: true });
+          await rm20(verDir, { recursive: true, force: true });
           removed += 1;
           lines.push(`  ✓ removed: ${label2}`);
         }
       }
       if (!opts.dryRun && await isEmptyDir(plDir)) {
-        await rm19(plDir, { recursive: true, force: true });
+        await rm20(plDir, { recursive: true, force: true });
       }
     }
     if (!opts.dryRun && await isEmptyDir(mpDir)) {
-      await rm19(mpDir, { recursive: true, force: true });
+      await rm20(mpDir, { recursive: true, force: true });
     }
   }
   if (scanned === 0) {
@@ -108929,7 +108979,7 @@ init_errors3();
 init_exitCode();
 import { execFile as execFile10 } from "node:child_process";
 import { existsSync as existsSync29 } from "node:fs";
-import { lstat as lstat11, mkdir as mkdir33, readlink as readlink2, realpath as realpath8, rm as rm20, symlink as symlink3 } from "node:fs/promises";
+import { lstat as lstat11, mkdir as mkdir33, readlink as readlink2, realpath as realpath8, rm as rm21, symlink as symlink3 } from "node:fs/promises";
 import { basename as basename11, dirname as dirname42, isAbsolute as isAbsolute19, relative as relative26, resolve as resolve34 } from "node:path";
 import { promisify as promisify10 } from "node:util";
 init_writeLock();
@@ -109025,7 +109075,9 @@ async function repositoryRecoveryPlan(input) {
   if (input.source !== undefined && selected.length === 0) {
     throw new ContextError(ExitCode.WorkspaceStateError, `repo source is not registered: ${input.source}`, {
       category: ErrorCategory.SourceNotFound,
-      sourceId: input.source
+      sourceId: input.source,
+      registered_names: registry2.repos.map((source2) => source2.name),
+      next_action: { command: "context source recovery-plan --format json" }
     });
   }
   const grouped = new Map;
@@ -109118,14 +109170,14 @@ async function cloneCheckout(input) {
   try {
     await execFileAsync6("git", cloneArgs, { encoding: "utf8", maxBuffer: 4 * 1024 * 1024 });
   } catch {
-    await rm20(target, { recursive: true, force: true });
+    await rm21(target, { recursive: true, force: true });
     try {
       await execFileAsync6("git", ["clone", "--no-checkout", "--depth=1", input.remote, target], {
         encoding: "utf8",
         maxBuffer: 4 * 1024 * 1024
       });
     } catch (error) {
-      await rm20(target, { recursive: true, force: true });
+      await rm21(target, { recursive: true, force: true });
       const detail = error !== null && typeof error === "object" && "stderr" in error ? String(error.stderr ?? "").trim() : error instanceof Error ? error.message : String(error);
       throw new ContextError(ExitCode.ExternalToolError, `cannot clone registered repository: ${input.remote}`, {
         category: ErrorCategory.ExternalToolFailed,
@@ -109150,7 +109202,7 @@ async function cloneCheckout(input) {
     await verifyCheckout({ checkout: target, remote: input.remote, ref: input.ref, subpaths: input.subpaths });
     return target;
   } catch (error) {
-    await rm20(target, { recursive: true, force: true });
+    await rm21(target, { recursive: true, force: true });
     throw error;
   }
 }
@@ -109166,7 +109218,7 @@ async function bindLocalAlias(input) {
       const actualReal = await realpath8(actual).catch(() => null);
       if (actualReal !== null && actualReal === await realpath8(input.checkout))
         return;
-      await rm20(alias);
+      await rm21(alias);
     } else {
       const actual = await realpath8(alias);
       if (actual === await realpath8(input.checkout))
@@ -109257,10 +109309,15 @@ async function restoreRepositorySources(input) {
     }
     if (registryChanged)
       await writeRepoRegistry(input.projectRoot, registry2);
+    const { readProductionStage: readProductionStage2 } = await Promise.resolve().then(() => (init_productionStageStore(), exports_productionStageStore));
+    const stage = await readProductionStage2(input.projectRoot);
+    const restoredScopes = new Set(restored.filter((result) => result.ready).flatMap((result) => result.sources.map((name3) => `repo:${name3}`)));
+    const { readMaintenance: readMaintenance2 } = await Promise.resolve().then(() => (init_maintenanceStorage(), exports_maintenanceStorage));
+    const refresh = stage && !stage.delivery && stage.scopes.some((source2) => restoredScopes.has(source2.scope)) && !(await readMaintenance2(input.projectRoot)).active;
     return {
       schema: "context.repository-source-recovery-result.v1",
       restored,
-      next_action: { command: "context status --format json" }
+      next_action: { command: refresh ? `context action prepare-current --revision ${stage.id} --format json` : "context status --format json" }
     };
   });
 }
@@ -110035,7 +110092,7 @@ init_writeLock();
 var import_yaml47 = __toESM(require_dist(), 1);
 import { existsSync as existsSync31 } from "node:fs";
 import { createHash as createHash31 } from "node:crypto";
-import { readFile as readFile81, readdir as readdir24, rm as rm21 } from "node:fs/promises";
+import { readFile as readFile81, readdir as readdir24, rm as rm22 } from "node:fs/promises";
 import { isAbsolute as isAbsolute21, join as join103, relative as relative28, resolve as resolve36, sep as sep8 } from "node:path";
 function sourceIdentity(source2) {
   if (source2.kind === "source.collection")
@@ -110426,7 +110483,7 @@ async function pruneExtractRuntime(projectRoot, source2) {
         const parsed = JSON.parse(await readFile81(path3, "utf8"));
         const refs = Array.isArray(parsed.source_refs) ? parsed.source_refs : [];
         if (parsed.source === source2.name || refs.some((ref2) => typeof ref2 === "string" && stringReferencesSource(ref2, source2))) {
-          await rm21(path3, { force: true });
+          await rm22(path3, { force: true });
         }
       } catch {}
     }
@@ -111555,7 +111612,7 @@ init_errors3();
 init_exitCode();
 import { execFile as execFile11 } from "node:child_process";
 import { existsSync as existsSync34 } from "node:fs";
-import { cp as cp2, mkdir as mkdir34, readdir as readdir26, readFile as readFile87, rename as rename8, rm as rm22, writeFile as writeFile25 } from "node:fs/promises";
+import { cp as cp2, mkdir as mkdir34, readdir as readdir26, readFile as readFile87, rename as rename8, rm as rm23, writeFile as writeFile25 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
 import { dirname as dirname45, join as join106 } from "node:path";
 import { promisify as promisify11 } from "node:util";
@@ -111707,7 +111764,7 @@ async function pruneCodexPluginCacheForName(pluginName, keepVersion, dryRun, ste
     status: dryRun ? "planned" : "ran"
   });
   if (!dryRun)
-    await Promise.all(versions.map((version3) => rm22(join106(cacheRoot, version3), { recursive: true, force: true })));
+    await Promise.all(versions.map((version3) => rm23(join106(cacheRoot, version3), { recursive: true, force: true })));
 }
 async function pruneCodexPluginCache(currentVersion, dryRun, steps) {
   await pruneCodexPluginCacheForName(PLUGIN_NAME, currentVersion, dryRun, steps);
@@ -111743,15 +111800,15 @@ async function pruneClaudeOrphanContextCache(dryRun, steps) {
         continue;
       removed.push(`${marketplace.name}/${PLUGIN_NAME}/${version3.name}`);
       if (!dryRun) {
-        await rm22(versionDir, { recursive: true, force: true });
+        await rm23(versionDir, { recursive: true, force: true });
       }
     }
     if (!dryRun && await isEmptyDir2(pluginDir)) {
-      await rm22(pluginDir, { recursive: true, force: true });
+      await rm23(pluginDir, { recursive: true, force: true });
     }
     const marketplaceDir = join106(cacheRoot, marketplace.name);
     if (!dryRun && await isEmptyDir2(marketplaceDir)) {
-      await rm22(marketplaceDir, { recursive: true, force: true });
+      await rm23(marketplaceDir, { recursive: true, force: true });
     }
   }
   if (removed.length > 0) {
@@ -111775,7 +111832,7 @@ async function pruneClaudeLegacyPluginCache(dryRun, steps) {
       continue;
     removed.push(`${MARKETPLACE_NAME}/${pluginName}`);
     if (!dryRun) {
-      await rm22(pluginDir, { recursive: true, force: true });
+      await rm23(pluginDir, { recursive: true, force: true });
     }
   }
   if (removed.length > 0) {
@@ -111801,7 +111858,7 @@ async function pruneClaudeSupersededContextCache(root2, dryRun, steps) {
     status: dryRun ? "planned" : "ran"
   });
   if (!dryRun) {
-    await Promise.all(staleVersions.map((version3) => rm22(join106(pluginDir, version3), { recursive: true, force: true })));
+    await Promise.all(staleVersions.map((version3) => rm23(join106(pluginDir, version3), { recursive: true, force: true })));
   }
 }
 function enableCodexPluginConfig(content3) {
@@ -111897,7 +111954,7 @@ async function replaceDirectoryFromSource(source2, target) {
   await mkdir34(dirname45(target), { recursive: true });
   const temporary = `${target}.tmp-${process.pid}-${Date.now()}`;
   const previous3 = `${target}.previous-${process.pid}-${Date.now()}`;
-  await rm22(temporary, { recursive: true, force: true });
+  await rm23(temporary, { recursive: true, force: true });
   await cp2(source2, temporary, { recursive: true, force: true });
   const hadPrevious = existsSync34(target);
   try {
@@ -111905,9 +111962,9 @@ async function replaceDirectoryFromSource(source2, target) {
       await rename8(target, previous3);
     await rename8(temporary, target);
     if (hadPrevious)
-      await rm22(previous3, { recursive: true, force: true });
+      await rm23(previous3, { recursive: true, force: true });
   } catch (error) {
-    await rm22(temporary, { recursive: true, force: true });
+    await rm23(temporary, { recursive: true, force: true });
     if (hadPrevious && !existsSync34(target) && existsSync34(previous3))
       await rename8(previous3, target);
     throw error;