@c4a/context-cli 0.7.10 → 0.7.11

package/cli.js

@@ -32029,7 +32029,17 @@ ${end.comment}` : end.comment;
 });
 
 // ../../node_modules/.bun/zod-to-json-schema@3.25.2+27912429049419a2/node_modules/zod-to-json-schema/dist/esm/Options.js
-var ignoreOverride, defaultOptions, getDefaultOptions = (options) => typeof options === "string" ? {
+var ignoreOverride, jsonDescription = (jsonSchema, def) => {
+  if (def.description) {
+    try {
+      return {
+        ...jsonSchema,
+        ...JSON.parse(def.description)
+      };
+    } catch {}
+  }
+  return jsonSchema;
+}, defaultOptions, getDefaultOptions = (options) => typeof options === "string" ? {
   ...defaultOptions,
   name: options
 } : {
@@ -33397,6 +33407,54 @@ var init_zodToJsonSchema = __esm(() => {
 });
 
 // ../../node_modules/.bun/zod-to-json-schema@3.25.2+27912429049419a2/node_modules/zod-to-json-schema/dist/esm/index.js
+var exports_esm = {};
+__export(exports_esm, {
+  zodToJsonSchema: () => zodToJsonSchema,
+  zodPatterns: () => zodPatterns,
+  setResponseValueAndErrors: () => setResponseValueAndErrors,
+  selectParser: () => selectParser,
+  primitiveMappings: () => primitiveMappings,
+  parseUnknownDef: () => parseUnknownDef,
+  parseUnionDef: () => parseUnionDef,
+  parseUndefinedDef: () => parseUndefinedDef,
+  parseTupleDef: () => parseTupleDef,
+  parseStringDef: () => parseStringDef,
+  parseSetDef: () => parseSetDef,
+  parseRecordDef: () => parseRecordDef,
+  parseReadonlyDef: () => parseReadonlyDef,
+  parsePromiseDef: () => parsePromiseDef,
+  parsePipelineDef: () => parsePipelineDef,
+  parseOptionalDef: () => parseOptionalDef,
+  parseObjectDef: () => parseObjectDef,
+  parseNumberDef: () => parseNumberDef,
+  parseNullableDef: () => parseNullableDef,
+  parseNullDef: () => parseNullDef,
+  parseNeverDef: () => parseNeverDef,
+  parseNativeEnumDef: () => parseNativeEnumDef,
+  parseMapDef: () => parseMapDef,
+  parseLiteralDef: () => parseLiteralDef,
+  parseIntersectionDef: () => parseIntersectionDef,
+  parseEnumDef: () => parseEnumDef,
+  parseEffectsDef: () => parseEffectsDef,
+  parseDefaultDef: () => parseDefaultDef,
+  parseDef: () => parseDef,
+  parseDateDef: () => parseDateDef,
+  parseCatchDef: () => parseCatchDef,
+  parseBrandedDef: () => parseBrandedDef,
+  parseBooleanDef: () => parseBooleanDef,
+  parseBigintDef: () => parseBigintDef,
+  parseArrayDef: () => parseArrayDef,
+  parseAnyDef: () => parseAnyDef,
+  jsonDescription: () => jsonDescription,
+  ignoreOverride: () => ignoreOverride,
+  getRelativePath: () => getRelativePath,
+  getRefs: () => getRefs,
+  getDefaultOptions: () => getDefaultOptions,
+  defaultOptions: () => defaultOptions,
+  default: () => esm_default,
+  addErrorMessage: () => addErrorMessage
+});
+var esm_default;
 var init_esm = __esm(() => {
   init_zodToJsonSchema();
   init_Options();
@@ -33430,17 +33488,42 @@ var init_esm = __esm(() => {
   init_unknown();
   init_selectParser();
   init_zodToJsonSchema();
+  esm_default = zodToJsonSchema;
 });
 
 // ../context/src/packageSite.ts
-var packageSiteSchema;
+var siteHrefSchema, packageSiteHomeActionSchema, packageSiteHomeResourceSchema, packageSiteHomeSchema, packageSiteSchema;
 var init_packageSite = __esm(() => {
   init_zod();
+  siteHrefSchema = exports_external.string().trim().min(1).refine((value) => /^(?:https?:\/\/|mailto:|\/(?!\/)|#)/u.test(value), "Use an https URL, mailto URL, root-relative path, or page anchor");
+  packageSiteHomeActionSchema = exports_external.object({
+    text: exports_external.string().trim().min(1),
+    link: siteHrefSchema,
+    theme: exports_external.enum(["brand", "alt"]).optional()
+  }).strict();
+  packageSiteHomeResourceSchema = exports_external.object({
+    title: exports_external.string().trim().min(1),
+    description: exports_external.string().trim().min(1).optional(),
+    href: siteHrefSchema.optional(),
+    action: exports_external.string().trim().min(1).optional(),
+    command: exports_external.string().trim().min(1).optional(),
+    featured: exports_external.boolean().optional()
+  }).strict().refine((value) => value.href !== undefined || value.command !== undefined, {
+    message: "A homepage resource requires href or command"
+  });
+  packageSiteHomeSchema = exports_external.object({
+    title: exports_external.string().trim().min(1).optional(),
+    slogan: exports_external.string().trim().min(1).optional(),
+    description: exports_external.string().trim().min(1).optional(),
+    actions: exports_external.array(packageSiteHomeActionSchema).optional(),
+    resources: exports_external.array(packageSiteHomeResourceSchema).optional()
+  }).strict();
   packageSiteSchema = exports_external.object({
     title: exports_external.string().trim().min(1).optional(),
     description: exports_external.string().optional(),
     lang: exports_external.string().min(1).default("en-US"),
-    base: exports_external.string().regex(/^\/(?:[a-zA-Z0-9_-]+\/)*$/, "Use / or a slash-delimited deployment path, such as /docs/").default("/")
+    base: exports_external.string().regex(/^\/(?:[a-zA-Z0-9_-]+\/)*$/, "Use / or a slash-delimited deployment path, such as /docs/").default("/"),
+    home: packageSiteHomeSchema.optional()
   }).strict();
 });
 
@@ -55119,6 +55202,7 @@ async function withProjectWriteLock(projectRoot, name, action) {
         owner: lockOwnerDetail(owner),
         next_action: {
           kind: processState === "running" ? "wait-for-active-context-command" : "inspect-project-write-lock",
+          ...processState === "not-running" ? { command: "context task recover --format json" } : {},
           message: processState === "running" ? "Keep polling the existing Context command until it returns an exit code and receipt; do not start another write command." : "No active owner could be confirmed. Inspect the runtime lock and the previous Context process before retrying; do not delete a lock owned by a running process."
         },
         next: processState === "running" ? "Wait for the running context command to finish, then retry." : "Inspect the workspace runtime lock and previous Context process before retrying."
@@ -55673,6 +55757,40 @@ function inlineLinksFromTree(content3, tree) {
 }
 function replaceMarkdownInlineLinkTargets(content3, replacement) {
   const links = markdownInlineLinks(content3);
+  if (content3.includes("]:")) {
+    const tree = unified().use(remarkParse).parse(content3);
+    const visit2 = (node3) => {
+      if (node3.type === "definition" && node3.url !== undefined) {
+        const start = node3.position?.start?.offset;
+        const end = node3.position?.end?.offset;
+        if (start !== undefined && end !== undefined) {
+          const raw = content3.slice(start, end);
+          const prefix = /^\[[^\n]+\]:\s*/u.exec(raw);
+          if (prefix) {
+            const offset = prefix[0].length;
+            const angle = raw[offset] === "<";
+            const match = angle ? /^<([^>]*)>/u.exec(raw.slice(offset)) : /^((?:\\.|[^\s])+)/u.exec(raw.slice(offset));
+            if (match) {
+              const targetStart = start + offset + (angle ? 1 : 0);
+              links.push({
+                image: false,
+                label: node3.identifier ?? "",
+                target: match[1],
+                start,
+                end,
+                targetStart,
+                targetEnd: targetStart + match[1].length
+              });
+            }
+          }
+        }
+      }
+      for (const child of node3.children ?? [])
+        visit2(child);
+    };
+    visit2(tree);
+    links.sort((a, b) => a.targetStart - b.targetStart);
+  }
   let cursor = 0;
   let output = "";
   for (const link of links) {
@@ -63603,8 +63721,9 @@ function validateProductionStage(value) {
     throw new TypeError("An unavailable source requires an explicit gap and pending investigation");
   }
   for (const usage of stage.indexer_usage) {
-    if (usage.scopes.some((scope2) => !scopes.has(scope2)))
-      throw new TypeError("Indexer usage cannot extend the authorized stage scope");
+    const invalid = usage.scopes.filter((scope2) => !scopes.has(scope2));
+    if (invalid.length)
+      throw new TypeError(`indexer_usage.scopes contains unauthorized source refs: ${invalid.join(", ")}. Use stage.scopes source refs (${[...scopes.keys()].join(", ")}), not collection names. This is not an Indexer registration error.`);
   }
   const visited = new Set;
   const visiting = new Set;
@@ -63624,7 +63743,9 @@ function validateProductionStage(value) {
     visited.add(task.id);
   }
   for (const task of stage.tasks) {
-    indexerKnowledgeCollectionSchema2.parse(task.path.split("/")[0]);
+    if (!indexerKnowledgeCollectionSchema2.safeParse(task.path.split("/")[0]).success) {
+      throw new TypeError(`Article path "${task.path}" must be relative to knowledge/, e.g. business/example.md (without the knowledge/ prefix). Valid collections: ${TOP_LEVEL_NAMESPACES.join(", ")}. Correct the article path, not indexer_usage.scopes.`);
+    }
     if (!isSafeKnowledgeTargetPath(task.path.split("/")[0], task.path))
       throw new TypeError(`Unsafe article target for ${task.id}`);
     if (task.input !== productionTaskInput(task))
@@ -63712,7 +63833,7 @@ var init_productionStage = __esm(() => {
     skills: exports_external.array(exports_external.object({ name, entry: name.optional() }).strict()).default([])
   }).strict();
   productionIndexerUsageSchema = exports_external.object({
-    scopes: exports_external.array(name).min(1),
+    scopes: exports_external.array(name).min(1).describe("Authorized source refs from stage.scopes, e.g. note:20260913/decision.md; not knowledge collection names"),
     skills: exports_external.array(name).min(1),
     purpose: name
   }).strict();
@@ -64632,12 +64753,14 @@ Restore the authorized source and retry preparation.
       "",
       ...scopes.map((scope2) => `- ${scope2.scope}: ${join25(directory, productionSourceFile(scope2.scope))}`),
       "",
-      "Use code skeletons and document outlines first; selectively read full material to decide reader topics and batches. Multiple skills may investigate one module. Do not parse all code or maintain per-symbol disposition just to plan.",
+      "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.",
       "Scale planning to the current request. For one or two documents or a clearly bounded module, decide which articles to add or revise and where they belong; do not redesign the whole knowledge base. Start with related existing topics, expand reading only when needed, and reuse applicable decisions. A large module may need several topics, but not investigation of unrelated modules.",
-      "Use one writing batch unless actual dependencies or useful parallel work justify more. Do not invent dependencies, taxonomy, page counts or extra investigation to fill plan fields. Leave unrelated unfinished scope pending rather than treating it as completed.",
+      "Separate the whole requested outcome from the current writing batch. Use one batch unless actual dependencies or useful parallel work justify more; do not invent page counts or dependencies. A first useful delivery does not settle remaining authorized work.",
+      "Use question and brief to describe the reader task and useful depth: a checked file/symbol or document section with a concrete next step for navigation, or the behavior, conditions and steps needed for explanation. Reuse or revise existing articles without replacing valid detail with generic summaries; split distinct tasks, not sources or symbols.",
       ...request.reassess.length ? [`Reassess earlier content exclusions: ${request.reassess.join(", ")}. Their source material changed or is unavailable. The stored decisions were preserved but no longer suppress investigation.`] : [],
       "Keep user-confirmed long-term exclusions in the existing requirements file. For a content-based exclusion, retain source_baselines from the supplied stage scopes for the material actually read; changed material is investigated again. Do not turn a temporary failure or an unapproved suggestion into a permanent exclusion.",
       "Declare available relevant skills and whether you can coordinate multiple Agents. Article sources may cross registered source and skill boundaries. Batch dependencies in after name article paths.",
+      "Article path is relative to knowledge/ (for example business/example.md, not knowledge/business/example.md). indexer_usage.scopes names authorized source refs from the stage, not knowledge collections. Declare skills here; no separate Indexer registry is required.",
       "List remaining investigation in pending_scopes when submitting a partial plan. This is source/module-level progress, not a per-file ledger. Omit it on a writing amendment to preserve the remaining scope; submit an explicit list to update it. Unresolved material gaps cannot be cleared by declaring their investigation complete.",
       `Write the plan to ${productionAgentDirectory(stage.id)}/submissions/plan.yaml and use the current action command. This does not approve the work-start report.`,
       ""
@@ -64784,7 +64907,7 @@ var init_productionPlanning = __esm(() => {
     stage: text5,
     capabilities: productionCapabilitiesSchema,
     articles: exports_external.array(exports_external.object({
-      path: text5,
+      path: text5.describe("Relative to knowledge/, e.g. business/example.md; do not prefix knowledge/"),
       question: text5,
       sources: exports_external.array(text5).min(1),
       batch: text5,
@@ -66152,6 +66275,77 @@ var init_knowledgeAssetRepair = __esm(() => {
   init_assetSourceRegistry();
 });
 
+// src/project/reviewApplyIndexer.ts
+var exports_reviewApplyIndexer = {};
+__export(exports_reviewApplyIndexer, {
+  renderApprovedIndexerMarkdown: () => renderApprovedIndexerMarkdown
+});
+function escapeHtmlAttribute(value) {
+  return value.replace(/&/gu, "&amp;").replace(/"/gu, "&quot;").replace(/</gu, "&lt;").replace(/>/gu, "&gt;");
+}
+function sectionMarkdown(section) {
+  return [
+    `<!-- context:section id="${escapeHtmlAttribute(section.section_key)}" -->`,
+    "",
+    section.markdown.trimEnd(),
+    "",
+    "<!-- /context:section -->"
+  ].join(`
+`);
+}
+function renderApprovedIndexerMarkdown(input) {
+  if (input.record.approved_revision !== undefined) {
+    const content3 = compactApprovedKnowledgeMarkdown(ensureApprovedKnowledgePresentation(input.record.body));
+    return content3.replace(/^---\r?\n([\s\S]*?)\r?\n---/u, (_match, header) => {
+      const metadata = import_yaml25.default.parse(header);
+      const reclassified = input.record.approved_revision?.previous_path !== undefined && input.record.approved_revision.previous_path.split("/")[0] !== input.record.collection;
+      return ["---", import_yaml25.default.stringify({
+        ...metadata,
+        type: reclassified ? okfTypeForCollection(input.record.collection) : metadata.type ?? okfTypeForCollection(input.record.collection),
+        timestamp: input.timestamp
+      }).trimEnd(), "---"].join(`
+`);
+    });
+  }
+  const binding = input.record.indexer_candidate;
+  if (input.record.candidate_type !== "indexer-artifact" || binding === undefined) {
+    throw new TypeError("Indexer approved renderer requires an indexer-artifact Candidate");
+  }
+  const title = input.record.review.title;
+  const body = binding.sections.flatMap((section, index2) => [
+    ...index2 === 0 ? [] : [""],
+    sectionMarkdown(section)
+  ]).join(`
+`);
+  const description = readerKnowledgeDescription({
+    description: input.record.review.summary,
+    markdown: body,
+    title
+  });
+  const frontmatter = import_yaml25.default.stringify({
+    title,
+    type: okfTypeForCollection(input.record.collection),
+    description,
+    timestamp: input.timestamp
+  }).trimEnd();
+  return [
+    "---",
+    frontmatter,
+    "---",
+    "",
+    ensureMarkdownPageTitle(body, title),
+    ""
+  ].join(`
+`);
+}
+var import_yaml25;
+var init_reviewApplyIndexer = __esm(() => {
+  init_okfTypes();
+  init_packageKnowledgeProjection();
+  init_approvedKnowledgeMetadata();
+  import_yaml25 = __toESM(require_dist(), 1);
+});
+
 // src/project/approvedRevisionBatch.ts
 var exports_approvedRevisionBatch = {};
 __export(exports_approvedRevisionBatch, {
@@ -66208,7 +66402,8 @@ async function approvedRevisionCandidateApplied(root, candidate, applied, closed
     return false;
   if (!closed && applied === candidate.body)
     return true;
-  const expected = revisionComparableMarkdown(candidate.body);
+  const { renderApprovedIndexerMarkdown: renderApprovedIndexerMarkdown2 } = await Promise.resolve().then(() => (init_reviewApplyIndexer(), exports_reviewApplyIndexer));
+  const expected = revisionComparableMarkdown(renderApprovedIndexerMarkdown2({ record: candidate, timestamp: candidate.updated }));
   const approved = revisionComparableMarkdown(applied);
   if (expected === approved)
     return true;
@@ -66224,9 +66419,9 @@ async function approvedRevisionCandidateApplied(root, candidate, applied, closed
 function revisionComparableMarkdown(markdown) {
   const compact = compactApprovedKnowledgeMarkdown(ensureApprovedKnowledgePresentation(markdown));
   return compact.replace(/^---\r?\n([\s\S]*?)\r?\n---/u, (_match, header) => {
-    const metadata = import_yaml25.default.parse(header);
+    const metadata = import_yaml26.default.parse(header);
     const { timestamp: _timestamp, ...content3 } = metadata;
-    return ["---", import_yaml25.default.stringify(content3).trimEnd(), "---"].join(`
+    return ["---", import_yaml26.default.stringify(content3).trimEnd(), "---"].join(`
 `);
   });
 }
@@ -66266,7 +66461,7 @@ async function observeApprovedRevisionBatch(root, request) {
     ...candidates.some((candidate) => candidate.status === "rejected") ? { revision_pending: true } : {}
   };
 }
-var import_yaml25;
+var import_yaml26;
 var init_approvedRevisionBatch = __esm(() => {
   init_src2();
   init_approvedRevision();
@@ -66275,7 +66470,7 @@ var init_approvedRevisionBatch = __esm(() => {
   init_approvedKnowledgeMetadata();
   init_durableSingleFileTransaction();
   init_knowledgeAssetRepair();
-  import_yaml25 = __toESM(require_dist(), 1);
+  import_yaml26 = __toESM(require_dist(), 1);
 });
 
 // src/project/verifyFrontmatter.ts
@@ -66291,7 +66486,7 @@ function isDeprecatedApprovedMarkdown(content3) {
   if (end < 0)
     return false;
   try {
-    const parsed = import_yaml26.default.parse(content3.slice(4, end));
+    const parsed = import_yaml27.default.parse(content3.slice(4, end));
     return isRecord7(parsed) && parsed.deprecated === true;
   } catch {
     return false;
@@ -66310,7 +66505,7 @@ function parseFrontmatter3(content3, path2, issues) {
     return;
   }
   try {
-    const parsed = import_yaml26.default.parse(content3.slice(4, end));
+    const parsed = import_yaml27.default.parse(content3.slice(4, end));
     if (!isRecord7(parsed)) {
       issues.push({ severity: "error", code: "frontmatter-invalid", path: path2, line: 1, message: "frontmatter must be a YAML object" });
       return;
@@ -66336,7 +66531,7 @@ function parseFrontmatterLoose(content3) {
   if (end < 0)
     return {};
   try {
-    const parsed = import_yaml26.default.parse(content3.slice(4, end));
+    const parsed = import_yaml27.default.parse(content3.slice(4, end));
     return isRecord7(parsed) ? parsed : {};
   } catch {
     return {};
@@ -66406,10 +66601,10 @@ async function validateApprovedMarkdown(input) {
     });
   }
 }
-var import_yaml26;
+var import_yaml27;
 var init_verifyFrontmatter = __esm(() => {
   init_okfTypes();
-  import_yaml26 = __toESM(require_dist(), 1);
+  import_yaml27 = __toESM(require_dist(), 1);
 });
 
 // src/project/indexerTemplateSnapshots.ts
@@ -67297,7 +67492,7 @@ async function prepareApprovedKnowledgeSnapshotTarget(input) {
     if (error.code !== "ENOENT")
       throw error;
   }
-  const structure = before === undefined ? {} : import_yaml27.default.parse(before);
+  const structure = before === undefined ? {} : import_yaml28.default.parse(before);
   if (!structure || typeof structure !== "object" || Array.isArray(structure))
     throw new TypeError("Invalid knowledge structure");
   const articles = new Map(approvedKnowledgeSnapshotsFromStructure(structure).map((article) => [article.article_id, article]));
@@ -67321,7 +67516,7 @@ async function prepareApprovedKnowledgeSnapshotTarget(input) {
     articles.set(article.article_id, article);
   }
   const entries2 = validateArticleStructureEntries([...articles.values()]);
-  const content3 = import_yaml27.default.stringify({
+  const content3 = import_yaml28.default.stringify({
     ...structure,
     articles: entries2.sort((a, b) => a.article_id.localeCompare(b.article_id))
   });
@@ -67335,12 +67530,12 @@ async function prepareApprovedKnowledgeSnapshotTarget(input) {
     content: content3
   };
 }
-var import_yaml27, STRUCTURE_PATH2 = "knowledge/structure.yaml";
+var import_yaml28, STRUCTURE_PATH2 = "knowledge/structure.yaml";
 var init_approvedKnowledgeSnapshots = __esm(() => {
   init_src2();
   init_approvedKnowledgeMetadata();
   init_durableSingleFileTransaction();
-  import_yaml27 = __toESM(require_dist(), 1);
+  import_yaml28 = __toESM(require_dist(), 1);
 });
 
 // src/runtimeEventOutbox.ts
@@ -69378,7 +69573,7 @@ function parseFrontmatter4(content3) {
   const match = /^---\r?\n([\s\S]*?)\r?\n---/u.exec(content3);
   if (match?.[1] === undefined)
     return {};
-  const parsed = import_yaml28.default.parse(match[1]);
+  const parsed = import_yaml29.default.parse(match[1]);
   return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
 }
 function isDeprecated(content3) {
@@ -69439,7 +69634,7 @@ async function writeApprovedStructureProjection(projectRoot) {
   const { inputHash, structure, compactFiles } = await deriveApprovedStructure(projectRoot);
   const outputPath = join48(projectRoot, STRUCTURE_PATH4);
   await mkdir17(dirname21(outputPath), { recursive: true });
-  await writeFile11(outputPath, import_yaml28.default.stringify(structure), "utf8");
+  await writeFile11(outputPath, import_yaml29.default.stringify(structure), "utf8");
   await Promise.all(compactFiles.map((file) => writeFile11(file.absPath, file.content, "utf8")));
   return { inputHash, articles: structure.articles.length, structure: STRUCTURE_PATH4 };
 }
@@ -69507,7 +69702,7 @@ async function closeProjectWorkspace(projectRoot) {
     }
     const outputPath = join48(projectRoot, STRUCTURE_PATH4);
     await mkdir17(dirname21(outputPath), { recursive: true });
-    await writeFile11(outputPath, `${import_yaml28.default.stringify(structure)}`, "utf8");
+    await writeFile11(outputPath, `${import_yaml29.default.stringify(structure)}`, "utf8");
     await Promise.all(compactFiles.map((file) => writeFile11(file.absPath, file.content, "utf8")));
     const { readTaskRollback } = await Promise.resolve().then(() => (init_taskRollback(), exports_taskRollback));
     if (!production && !await readTaskRollback(projectRoot))
@@ -69558,7 +69753,7 @@ async function runProjectCloseCommand(input) {
   }
   return true;
 }
-var import_yaml28, KNOWLEDGE_ROOT = "knowledge", STRUCTURE_PATH4, STRUCTURE_SCHEMA_VERSION = "context.approved-structure.v1";
+var import_yaml29, KNOWLEDGE_ROOT = "knowledge", STRUCTURE_PATH4, STRUCTURE_SCHEMA_VERSION = "context.approved-structure.v1";
 var init_close = __esm(() => {
   init_indexerRequiredArticleReview();
   init_approvedFileRead();
@@ -69579,7 +69774,7 @@ var init_close = __esm(() => {
   init_candidateLedger();
   init_knowledgeAssetRepair();
   init_approvedKnowledgeMetadata();
-  import_yaml28 = __toESM(require_dist(), 1);
+  import_yaml29 = __toESM(require_dist(), 1);
   STRUCTURE_PATH4 = join48(KNOWLEDGE_ROOT, "structure.yaml");
 });
 
@@ -69843,7 +70038,7 @@ async function optionalText(root, path2) {
 }
 async function readKnowledgeMap(root) {
   const content3 = await optionalText(root, KNOWLEDGE_MAP_PATH);
-  return content3 === undefined ? undefined : validateKnowledgeMap(import_yaml29.parse(content3));
+  return content3 === undefined ? undefined : validateKnowledgeMap(import_yaml30.parse(content3));
 }
 async function applyKnowledgeMapUpdate(projectRoot, update) {
   return withProjectWriteLock(projectRoot, "adjust-knowledge-map", async () => {
@@ -69855,7 +70050,7 @@ async function applyKnowledgeMapUpdate(projectRoot, update) {
     const preview = previewText === undefined ? undefined : JSON.parse(previewText);
     const planned = preview?.topics?.flatMap((topic) => topic.article_targets ?? []) ?? [];
     assertKnowledgeMapCoverage(next, approved, { known: [...approved, ...planned], current_revision: current?.revision ?? null });
-    const content3 = import_yaml29.stringify(next);
+    const content3 = import_yaml30.stringify(next);
     const previous2 = await optionalText(projectRoot, KNOWLEDGE_MAP_PATH);
     await runDurableMultiFileTransaction({
       projectRoot,
@@ -69876,14 +70071,14 @@ async function applyKnowledgeMapUpdate(projectRoot, update) {
     };
   });
 }
-var import_yaml29, KNOWLEDGE_MAP_PATH = "src/knowledge-map.yaml";
+var import_yaml30, KNOWLEDGE_MAP_PATH = "src/knowledge-map.yaml";
 var init_knowledgeMap2 = __esm(() => {
   init_knowledgeMapCoverage();
   init_src2();
   init_durableSingleFileTransaction();
   init_durableMultiFileTransaction();
   init_writeLock();
-  import_yaml29 = __toESM(require_dist(), 1);
+  import_yaml30 = __toESM(require_dist(), 1);
 });
 
 // src/project/packageKnowledgeMap.ts
@@ -70157,7 +70352,7 @@ async function optionalWorkspaceText(root, path2) {
 }
 async function readWorkspaceChangelog(root) {
   const value = await optionalWorkspaceText(root, "changelog.yaml");
-  return value === undefined ? [] : ledgerSchema.parse(import_yaml30.parse(value)).entries;
+  return value === undefined ? [] : ledgerSchema.parse(import_yaml31.parse(value)).entries;
 }
 async function workspaceVersion(root) {
   const manifest = JSON.parse(await readFile45(join55(root, "package.json"), "utf8"));
@@ -70299,7 +70494,7 @@ async function recordWorkspaceVersion(root, value) {
     const writes = {
       "package.json": JSON.stringify(manifest, null, 2) + `
 `,
-      "changelog.yaml": import_yaml30.stringify({ entries: entries2 }),
+      "changelog.yaml": import_yaml31.stringify({ entries: entries2 }),
       "CHANGELOG.md": renderChangelog(entries2),
       ".context-version.json": JSON.stringify({ version: entry.version, files: status.files }) + `
 `
@@ -70313,13 +70508,13 @@ async function recordWorkspaceVersion(root, value) {
     return { version: entry.version, next_action: { command: "context status --format json" } };
   });
 }
-var import_yaml30, exec, semver, text6, changelogEntrySchema, changelogInputSchema, ledgerSchema, baselineSchema, hash2 = (value) => createHash15("sha256").update(JSON.stringify(value)).digest("hex");
+var import_yaml31, exec, semver, text6, changelogEntrySchema, changelogInputSchema, ledgerSchema, baselineSchema, hash2 = (value) => createHash15("sha256").update(JSON.stringify(value)).digest("hex");
 var init_workspaceChangelog = __esm(() => {
   init_zod();
   init_writeLock();
   init_durableSingleFileTransaction();
   init_durableMultiFileTransaction();
-  import_yaml30 = __toESM(require_dist(), 1);
+  import_yaml31 = __toESM(require_dist(), 1);
   exec = promisify6(execFile6);
   semver = exports_external.string().regex(/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u);
   text6 = exports_external.string().trim().min(1);
@@ -70452,17 +70647,22 @@ var siteMarkdownConfig, siteThemeScript, siteThemeCss = `
 }
 .VPNavBar .wrapper { padding: 0 24px !important; }
 .VPNavBar .container { max-width: none !important; }
+.VPNav, .VPNavBar, .VPNavBar .wrapper { background: var(--vp-c-bg) !important; }
 .VPNavBar .title { position: static !important; padding: 0 !important; width: var(--vp-sidebar-width) !important; flex-shrink: 0; }
 .VPNavBarTitle .title { font-size: 15px; font-weight: 650; border: 0 !important; }
 .VPNavBar .content { flex: 1; min-width: 0; padding-left: 0 !important; }
 .VPNavBar .content-body { background: var(--vp-c-bg) !important; gap: 8px; }
 .VPNavBarMenu { order: -1; flex: 1; min-width: 0; }
-.context-language { display: flex; align-items: center; gap: 4px; white-space: nowrap; font-size: 12px; }
-.context-language button { padding: 4px; color: var(--vp-c-text-2); }
-.context-language button[aria-pressed='true'] { color: var(--vp-c-brand-1); font-weight: 600; }
+.context-language { display: inline-flex; align-items: center; padding: 5px 7px; border: 0; border-radius: 6px; color: var(--vp-c-text-2);
+  background: transparent; white-space: nowrap; font-size: 12px; font-weight: 550; cursor: pointer; }
+.context-language:hover { color: var(--vp-c-brand-1); background: var(--vp-c-brand-soft); }
 .VPNavBarMenuLink { font-size: 13px !important; font-weight: 550 !important; padding: 0 16px !important; }
 .VPNavBarMenuLink.active { box-shadow: inset 0 -2px var(--vp-c-brand-1); }
-.VPNavBarSearch { flex-grow: 0 !important; padding: 0 12px !important; }
+.VPNavBarSearch { flex: 0 0 376px !important; width: 376px; padding: 0 12px !important; }
+.VPNavBarSearch #local-search, .VPNavBarSearch .DocSearch-Button { width: 352px; }
+.VPNavBarSearch .DocSearch-Button { display: flex; align-items: center; }
+.VPNavBarSearch .DocSearch-Button-Container { display: flex; flex: 1; min-width: 0; align-items: center; }
+.VPNavBarSearch .DocSearch-Button-Keys { margin-left: auto; }
 .VPSidebar { border-top: 1px solid var(--vp-c-divider); border-right: 1px solid var(--vp-c-divider); scrollbar-width: thin; }
 .VPSidebar .group + .group { border: 0; padding-top: 8px; }
 .VPSidebarItem .link { min-width: 0; overflow: hidden; }
@@ -70508,16 +70708,84 @@ var siteMarkdownConfig, siteThemeScript, siteThemeCss = `
 .vp-doc details { margin: 20px 0; border: 1px solid var(--vp-c-divider); border-radius: 6px; padding: 12px 16px; }
 .vp-doc summary { cursor: pointer; font-size: 14px; font-weight: 550; }
 .vp-doc img { max-width: 100%; height: auto; }
+.context-home { max-width: 100%; min-width: 0; overflow-x: clip; }
+.context-home .VPContent, .context-home .VPHome, .context-home .VPHero { max-width: 100%; min-width: 0; }
+.context-home .VPHome { padding-bottom: 0; }
+.context-home .VPHero { position: relative; padding: 132px 0 62px; }
+.context-home .VPHero::before { content: ''; position: absolute; top: -1px; right: 0; bottom: 0; left: calc(0px - var(--vp-sidebar-width)); pointer-events: none;
+  background: linear-gradient(to bottom, transparent 58%, var(--vp-c-bg) 100%),
+    radial-gradient(ellipse 58% 145% at 8% 18%, rgba(37,99,235,.16), transparent 72%),
+    radial-gradient(ellipse 58% 150% at 68% 24%, rgba(0,190,200,.11), transparent 72%),
+    linear-gradient(90deg, rgba(37,99,235,.045), rgba(0,190,200,.025) 68%, transparent); }
+.context-home .VPHero .container { position: relative; box-sizing: border-box; width: min(1180px, calc(100% - 104px)); max-width: none; min-width: 0; margin-left: 52px; margin-right: auto; }
+.context-home .VPHero .main { width: 100%; max-width: 980px; min-width: 0; }
+.context-home .VPHero .heading { display: block; width: 100%; min-width: 0; max-width: 100%; }
+.context-home .VPHero .name { display: block; width: 100%; max-width: 100%; overflow-wrap: anywhere; white-space: normal; color: transparent;
+  background: linear-gradient(112deg, var(--vp-c-brand-1), var(--context-accent)); background-clip: text; -webkit-background-clip: text; }
+.context-home .VPHero .text { display: block; width: 100%; max-width: 100%; overflow-wrap: anywhere; word-break: break-word; white-space: normal;
+  font-size: clamp(38px, 4.2vw, 60px); line-height: 1.08; letter-spacing: -.045em; }
+.context-home .VPHero .tagline { max-width: 820px; font-size: 18px; line-height: 1.75; }
+.context-home .VPHero .actions { width: 100%; min-width: 0; padding-top: 38px; flex-wrap: wrap; }
+.context-home .VPFeatures { display: none; }
+.context-home-section { width: min(1180px, calc(100% - 104px)); margin: 0 auto 0 52px; padding: 36px 0 44px; }
+.context-home-section + .context-home-section { border-top: 1px solid var(--vp-c-divider); }
+.context-home-map { padding-top: 0; }
+.context-home-resources { padding-top: 6px; border-top: 0 !important; }
+.context-home-section-heading { max-width: 700px; margin-bottom: 24px; }
+.context-home-section-heading h2 { margin: 2px 0 8px; border: 0; font-size: 28px; line-height: 1.3; letter-spacing: -.02em; }
+.context-home-section-heading > p:last-child { color: var(--vp-c-text-2); line-height: 1.7; }
+.context-home-kicker { margin: 0; color: var(--vp-c-brand-1); font-size: 11px; font-weight: 700; letter-spacing: .16em; }
+.context-home-map-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(290px, 100%), 1fr)); gap: 14px; }
+.context-home-map-card, .context-home-resource-card { border: 1px solid var(--vp-c-divider); background: color-mix(in srgb, var(--vp-c-bg) 88%, var(--vp-c-bg-soft));
+  animation: context-home-rise .5s both; animation-delay: var(--context-home-delay); }
+.context-home-map-card { min-height: 224px; padding: 22px; border-radius: 14px; }
+.context-home-map-card:hover, .context-home-resource-card:hover { border-color: color-mix(in srgb, var(--vp-c-brand-1) 42%, var(--vp-c-divider));
+  box-shadow: 0 14px 38px rgba(23,36,66,.08); transform: translateY(-2px); transition: border-color .18s, box-shadow .18s, transform .18s; }
+.context-home-map-card-heading { display: flex; align-items: baseline; justify-content: space-between; gap: 16px; padding-bottom: 13px; border-bottom: 1px solid var(--vp-c-divider); }
+.context-home-map-card h3, .context-home-resource-card h3 { margin: 0; font-size: 17px; line-height: 1.45; }
+.context-home-map-card h3 a { color: var(--vp-c-text-1); }
+.context-home-map-card-heading span { flex: none; color: var(--vp-c-text-2); font-size: 11px; }
+.context-home-map-card ul { margin: 14px 0 0; padding: 0; list-style: none; }
+.context-home-map-card li { margin: 7px 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.context-home-map-card li a { color: var(--vp-c-text-2); font-size: 13px; }
+.context-home-map-card li a:hover, .context-home-map-more:hover { color: var(--vp-c-brand-1); }
+.context-home-map-more { display: inline-block; margin-top: 12px; color: var(--vp-c-brand-1); font-size: 12px; font-weight: 600; }
+.context-home-resource-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 14px; }
+.context-home-resource-card { min-height: 118px; padding: 16px 18px; border-radius: 12px; }
+.context-home-resource-heading { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
+.context-home-resource-actions { display: flex; flex: none; align-items: center; gap: 6px; }
+.context-home-resource-action, .context-home-install-action { display: inline-flex; align-items: center; min-height: 28px; padding: 4px 8px; border: 1px solid var(--vp-c-divider); border-radius: 6px;
+  color: var(--vp-c-text-2); background: var(--vp-c-bg); font-size: 11px; font-weight: 600; line-height: 1; white-space: nowrap; }
+.context-home-resource-action:hover, .context-home-install-action:hover { border-color: var(--vp-c-brand-1); color: var(--vp-c-brand-1); }
+.context-home-install-action { cursor: pointer; background: var(--vp-c-brand-soft); }
+.context-home-resource-card p { margin: 8px 0 0; color: var(--vp-c-text-2); font-size: 13px; line-height: 1.55; }
+.context-home-powered { width: min(1180px, calc(100% - 104px)); margin: 24px auto 0 52px; padding: 22px 0 30px; border-top: 1px solid var(--vp-c-divider);
+  color: var(--vp-c-text-2); font-size: 11px; text-align: right; }
+.context-home-powered a { color: inherit; }
+@keyframes context-home-rise { from { opacity: 0; transform: translateY(10px); } to { opacity: 1; transform: translateY(0); } }
 @media (min-width: 960px) {
   .VPSidebar { top: var(--vp-nav-height) !important; width: var(--vp-sidebar-width) !important; padding: 12px 0 48px !important; }
   .VPSidebar .curtain { display: none; }
   .VPContent.has-sidebar { padding-left: var(--vp-sidebar-width) !important; padding-right: 0 !important; }
   .context-empty-sidebar .VPContent { padding-left: var(--vp-sidebar-width) !important; padding-right: 0 !important; }
+  .context-home .VPContent { padding-left: var(--vp-sidebar-width) !important; padding-right: 0 !important; }
   .VPNavBar .content { padding-right: 32px !important; }
   .VPDoc { padding: 44px 36px 80px !important; }
   .VPDoc > .container > .content { padding: 0 24px 80px 0 !important; }
 }
 @media (min-width: 1600px) { .VPDoc { padding-left: 52px !important; padding-right: 36px !important; } }
+@media (min-width: 960px) and (max-width: 1279px) {
+  .VPNavBar .title { width: 220px !important; }
+  .VPNavBarMenuLink { padding: 0 9px !important; }
+  .VPNavBarSearch { flex-basis: 168px !important; width: 168px; }
+  .VPNavBarSearch .DocSearch-Button { width: 144px; }
+  .context-home .VPHero .main { max-width: 100%; }
+  .context-home-resource-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+}
+@media (min-width: 1280px) and (max-width: 1599px) {
+  .VPNavBarSearch { flex-basis: 248px !important; width: 248px; }
+  .VPNavBarSearch #local-search, .VPNavBarSearch .DocSearch-Button { width: 224px; }
+}
 .context-mobile-directory { display: none; }
 @media (max-width: 959px) {
   .VPNavBar .wrapper { padding: 0 16px !important; }
@@ -70541,6 +70809,17 @@ var siteMarkdownConfig, siteThemeScript, siteThemeCss = `
   .vp-doc h2 { font-size: 22px; }
   .VPDoc { padding: 32px 36px 64px !important; }
   .vp-doc a.header-anchor { margin-left: -0.8em; }
+  .context-home .VPHero { padding-top: 104px; padding-bottom: 66px; }
+  .context-home .VPHero::before { left: 0; }
+  .context-home .VPHero .container { width: min(calc(100% - 36px), 680px); margin-left: auto; margin-right: auto; }
+  .context-home .VPHero .text { font-size: 40px; }
+  .context-home .VPHero .tagline { font-size: 16px; }
+  .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 (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; }
 }
 .context-sources { margin-top: 0; margin-bottom: 24px; padding: 16px 20px; border: 1px solid var(--vp-c-divider); border-radius: 8px; background: var(--vp-sidebar-bg-color); color: var(--vp-c-text-2); font-size: 12px; line-height: 1.7; overflow-wrap: anywhere; }
 .context-sources-header { display: flex; align-items: baseline; justify-content: space-between; flex-wrap: wrap; gap: 4px 16px; margin-bottom: 8px; }
@@ -70626,9 +70905,12 @@ export default {
       const data = useData();
       const route = useRoute();
       const sections = computed(() => data.theme.value.contextSections || []);
+      const home = computed(() => data.theme.value.contextHome || {});
       const selected = ref('');
       const mounted = ref(false);
       const language = ref('zh');
+      const copiedCommand = ref('');
+      let copyReset;
       const chinese = computed(() => language.value === 'zh');
       const languageKey = 'context-language:' + data.site.value.base;
       onMounted(() => {
@@ -70641,6 +70923,76 @@ export default {
         language.value = value;
         try { localStorage.setItem(languageKey, value); } catch {}
       };
+      const href = value => value.startsWith('/') ? data.site.value.base + value.slice(1) : value;
+      const external = value => /^https?:\/\//.test(value) || value.startsWith('mailto:');
+      const copyCommand = async value => {
+        try {
+          await navigator.clipboard.writeText(value);
+          copiedCommand.value = value;
+          clearTimeout(copyReset);
+          copyReset = setTimeout(() => { if (copiedCommand.value === value) copiedCommand.value = ''; }, 1600);
+        } catch {}
+      };
+      const links = items => items.flatMap(item => [
+        ...(item.link ? [{ text: item.text, link: item.link }] : []),
+        ...links(item.items || []),
+      ]);
+      const siteMap = () => h('section', { class: 'context-home-section context-home-map', 'aria-labelledby': 'context-home-map-title' }, [
+        h('div', { class: 'context-home-section-heading' }, [
+          h('p', { class: 'context-home-kicker' }, chinese.value ? 'KNOWLEDGE MAP' : 'KNOWLEDGE MAP'),
+          h('h2', { id: 'context-home-map-title' }, chinese.value ? '网站地图' : 'Site map'),
+          h('p', chinese.value ? '从主题进入知识，也可以继续查看栏目中的具体页面。' :
+            'Start with a topic, then continue to the pages within each section.'),
+        ]),
+        h('div', { class: 'context-home-map-grid' }, sections.value.map((section, index) => {
+          const pages = links(section.items || []);
+          return h('article', { class: 'context-home-map-card', style: { '--context-home-delay': (index * 35) + 'ms' } }, [
+            h('div', { class: 'context-home-map-card-heading' }, [
+              h('h3', h('a', { href: href(section.href) }, section.title)),
+              h('span', chinese.value ? section.pages.length + ' 页' : section.pages.length + ' pages'),
+            ]),
+            pages.length ? h('ul', pages.slice(0, 6).map(page => h('li',
+              h('a', { href: href(page.link) }, page.text)))) : null,
+            pages.length > 6 ? h('a', { class: 'context-home-map-more', href: href(section.href) },
+              chinese.value ? '查看全部 ' + pages.length + ' 页 →' : 'View all ' + pages.length + ' pages →') : null,
+          ]);
+        })),
+      ]);
+      const resources = () => {
+        const builtins = [
+          { title: 'LLM Docs', description: chinese.value ? '面向 Agent 和模型的结构化知识入口。' :
+            'Structured knowledge entry points for agents and models.', href: '/llms/index.html', action: chinese.value ? '打开文档' : 'Open docs' },
+          { title: 'Changelog', description: chinese.value ? '查看知识内容的版本变化与更新时间。' :
+            'Review knowledge versions and update history.', href: '/changelog.html', action: chinese.value ? '查看更新' : 'View updates' },
+        ];
+        const items = [...(home.value.resources || []), ...builtins];
+        return h('section', { class: 'context-home-section context-home-resources', 'aria-labelledby': 'context-home-resources-title' }, [
+          h('div', { class: 'context-home-section-heading' }, [
+            h('p', { class: 'context-home-kicker' }, chinese.value ? 'RESOURCES' : 'RESOURCES'),
+            h('h2', { id: 'context-home-resources-title' }, chinese.value ? '工具与资源' : 'Tools and resources'),
+          ]),
+          h('div', { class: 'context-home-resource-grid' }, items.map((item, index) => h('article', {
+            class: 'context-home-resource-card', style: { '--context-home-delay': (index * 35) + 'ms' },
+          }, [
+            h('div', { class: 'context-home-resource-heading' }, [
+              h('h3', item.title),
+              h('div', { class: 'context-home-resource-actions' }, [
+                item.command ? h('button', { class: 'context-home-install-action', type: 'button',
+                  title: (chinese.value ? '复制安装命令：' : 'Copy install command: ') + item.command,
+                  onClick: () => copyCommand(item.command) }, copiedCommand.value === item.command
+                    ? (chinese.value ? '已复制' : 'Copied') : (chinese.value ? '安装' : 'Install')) : null,
+                item.href ? h('a', { class: 'context-home-resource-action', href: href(item.href), ...(external(item.href)
+                  ? { target: '_blank', rel: 'noopener noreferrer' } : {}) }, item.action || (chinese.value ? '访问' : 'Open')) : null,
+              ]),
+            ]),
+            item.description ? h('p', item.description) : null,
+          ]))),
+        ]);
+      };
+      const poweredBy = () => home.value.branding ? h('footer', { class: 'context-home-powered' }, [
+        home.value.branding.label + ' ',
+        h('a', { href: home.value.branding.href, target: '_blank', rel: 'noopener noreferrer' }, home.value.branding.name),
+      ]) : null;
       const history = computed(() => data.frontmatter.value.contextHistory
         ? JSON.parse(new TextDecoder().decode(Uint8Array.from(atob(data.frontmatter.value.contextHistory), char => char.charCodeAt(0)))) : null);
       onMounted(() => { mounted.value = true; });
@@ -70667,6 +71019,7 @@ export default {
       const active = computed(() => sections.value.find(section => section.key === selected.value));
       const inLlms = computed(() => route.path.startsWith(data.site.value.base + 'llms/'));
       const inHistory = computed(() => route.path === data.site.value.base + 'changelog.html');
+      const inHome = computed(() => data.frontmatter.value.layout === 'home');
       provide(dataSymbol, { ...data, theme: computed(() => ({ ...data.theme.value,
         ...data.theme.value.contextUiLabels?.[language.value],
         sidebar: inLlms.value || inHistory.value ? [] : active.value?.items || [],
@@ -70678,9 +71031,12 @@ export default {
             activeMatch: inLlms.value || inHistory.value ? '^' : '(?!)' }],
       })) });
       const slots = {
-        'nav-bar-content-after': () => h('div', { class: 'context-language', role: 'group', 'aria-label': '界面语言 / Interface language' },
-          ['zh', 'en'].map(value => h('button', { type: 'button', 'aria-pressed': language.value === value,
-            onClick: () => changeLanguage(value) }, value === 'zh' ? '中文' : 'EN'))),
+        'nav-bar-content-after': () => h('button', { class: 'context-language', type: 'button',
+          'aria-label': chinese.value ? 'Switch interface language to English' : '将界面语言切换为中文',
+          title: chinese.value ? 'Switch to English' : '切换为中文',
+          onClick: () => changeLanguage(chinese.value ? 'en' : 'zh') }, chinese.value ? 'EN' : '中文'),
+        'home-features-before': () => [siteMap(), resources()],
+        'home-features-after': poweredBy,
         'doc-after': () => history.value ? h('section', { class: 'context-history-cards' },
           history.value.length ? history.value.map((entry, index) =>
             h('details', { class: 'context-history-card', open: index < 3, key: entry.version }, [
@@ -70729,7 +71085,8 @@ export default {
         },
       };
       // History belongs between the page heading and footer metadata.
-      return () => h(DefaultTheme.Layout, { class: inLlms.value || inHistory.value ? 'context-empty-sidebar' : undefined }, { ...slots, 'doc-after': undefined,
+      return () => h(DefaultTheme.Layout, { class: inHome.value ? 'context-home' :
+        inLlms.value || inHistory.value ? 'context-empty-sidebar' : undefined }, { ...slots, 'doc-after': undefined,
         'doc-footer-before': () => [slots['doc-after'](), slots['doc-footer-before']()] });
     }
   },
@@ -70789,10 +71146,20 @@ export default {
 `;
 });
 
+// src/project/packageSiteBranding.ts
+var packageSiteBranding;
+var init_packageSiteBranding = __esm(() => {
+  packageSiteBranding = {
+    label: "Powered by",
+    name: "context4ai/context",
+    href: "https://github.com/context4ai/context"
+  };
+});
+
 // src/project/packageSite.ts
 import { createHash as createHash16 } from "node:crypto";
 import { spawn as spawn3 } from "node:child_process";
-import { mkdir as mkdir19, mkdtemp, readFile as readFile46, writeFile as writeFile14, rm as rm11, symlink, cp, access as access5 } from "node:fs/promises";
+import { mkdir as mkdir19, mkdtemp, readFile as readFile46, writeFile as writeFile14, rm as rm11, symlink, cp, access as access5, stat as stat7 } from "node:fs/promises";
 import { createRequire as createRequire5 } from "node:module";
 import { dirname as dirname23, join as join56, posix as posix6 } from "node:path";
 function sitePagePath(identity) {
@@ -70986,6 +71353,7 @@ async function writePackageSite(input) {
         contextUpdated: historyDate,
         contextUiLabels: { zh: siteThemeLabels("zh"), en: siteThemeLabels("en") },
         contextSections: sections.map(({ key, title, href, pages, items }) => ({ key, title, href, pages, items })),
+        contextHome: { resources: options.home?.resources ?? [], branding: packageSiteBranding },
         sidebar: sections[0]?.items ?? [],
         nav: [...sections.map((section) => ({ text: section.title, link: section.href })), { text: "更多", items: [{ text: "LLM Docs", link: "/llms/index.html" }, { text: "Changelog", link: "/changelog.html" }] }]
       }
@@ -71022,11 +71390,24 @@ ${body}`);
 `) + `
 `);
     }
-    const home = [`# ${mdLabel(options.title ?? pkg.name)}`, "", mdLabel(options.description ?? ""), ""];
-    for (const section of sections)
-      home.push(`- [${mdLabel(section.title)}](${section.href})`);
-    await writeFile14(join56(temporary, "index.md"), home.join(`
-`) + `
+    const chinese = (options.lang ?? "en-US").startsWith("zh");
+    const firstSection = sections[0]?.href ?? "/llms/index.html";
+    const featuredResources = (options.home?.resources ?? []).filter((resource) => resource.featured && resource.href);
+    const hero = {
+      name: options.home?.title ?? options.title ?? pkg.name,
+      text: options.home?.slogan ?? (chinese ? "从知识地图开始探索" : "Explore from the knowledge map"),
+      tagline: options.home?.description ?? options.description ?? "",
+      actions: options.home?.actions ?? [
+        { theme: "brand", text: chinese ? "浏览知识" : "Browse knowledge", link: firstSection },
+        ...featuredResources.map((resource) => ({ theme: "alt", text: resource.title, link: resource.href })),
+        { theme: "alt", text: "LLM Docs", link: "/llms/index.html" }
+      ]
+    };
+    await writeFile14(join56(temporary, "index.md"), `---
+layout: home
+title: ${JSON.stringify(options.home?.title ?? options.title ?? pkg.name)}
+hero: ${JSON.stringify(hero)}
+---
 `);
     await writeFile14(join56(temporary, "changelog.md"), `---
 title: Changelog
@@ -71068,6 +71449,15 @@ title: LLM Docs
       await cp(join56(root, path2), destination);
     }
     await compileSite(temporary, output);
+    for (const file of await walkPackageFiles(output)) {
+      const extension2 = posix6.extname(file.relPath).toLowerCase();
+      const placeholder = [".css", ".js", ".mjs", ".cjs"].includes(extension2) ? `/* Intentionally empty. */
+` : [".html", ".htm"].includes(extension2) ? `<!-- Intentionally empty. -->
+` : null;
+      if (placeholder !== null && (await stat7(file.absPath)).size === 0) {
+        await writeFile14(file.absPath, placeholder);
+      }
+    }
     await writeFile14(join56(output, "context-site-map.json"), JSON.stringify({
       protocol: "context.site-output/v1",
       knowledge_map_revision: structure?.revision ?? null,
@@ -71084,7 +71474,7 @@ title: LLM Docs
     await rm11(temporary, { recursive: true, force: true });
   }
 }
-var PACKAGE_SITE_VERSION = "vitepress-site-v22-llms-new-tab", require2, encodePath = (path2) => path2.split("/").map(encodeURIComponent).join("/"), mdLabel = (value) => value.replace(/[\\[\]<>`*]/gu, "\\$&").replace(/[\r\n]/gu, " ");
+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 init_packageSite2 = __esm(() => {
   init_packageOutputPaths();
   init_workspaceChangelog();
@@ -71096,6 +71486,7 @@ var init_packageSite2 = __esm(() => {
   init_packageKnowledgeMap();
   init_markdownLinks();
   init_packageSiteTheme();
+  init_packageSiteBranding();
   require2 = createRequire5(import.meta.url);
 });
 
@@ -72274,7 +72665,7 @@ function validateRenderedSkillDefinition(input) {
   }
   let frontmatter;
   try {
-    frontmatter = import_yaml31.parse(frontmatterMatch[1]);
+    frontmatter = import_yaml33.parse(frontmatterMatch[1]);
   } catch {
     frontmatter = null;
   }
@@ -72301,7 +72692,7 @@ function validateRenderedSkillDefinition(input) {
     });
   }
 }
-var import_yaml31, OKF_OUTPUT_ROOTS2, SKILL_NAME_PATTERN;
+var import_yaml33, OKF_OUTPUT_ROOTS2, SKILL_NAME_PATTERN;
 var init_packageTemplateGuard = __esm(() => {
   init_cliFeedback();
   init_errors3();
@@ -72309,7 +72700,7 @@ var init_packageTemplateGuard = __esm(() => {
   init_packageIndexes();
   init_packageDistribution();
   init_packageTemplateUtils();
-  import_yaml31 = __toESM(require_dist(), 1);
+  import_yaml33 = __toESM(require_dist(), 1);
   OKF_OUTPUT_ROOTS2 = new Set(["wikis", "guides", "rules", "feats"]);
   SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
 });
@@ -72370,7 +72761,7 @@ function isDeprecatedKnowledge(content3) {
   if (match?.[1] === undefined)
     return false;
   try {
-    const frontmatter = import_yaml33.parse(match[1]);
+    const frontmatter = import_yaml35.parse(match[1]);
     return frontmatter !== null && typeof frontmatter === "object" && !Array.isArray(frontmatter) && frontmatter.deprecated === true;
   } catch {
     return false;
@@ -72901,7 +73292,7 @@ async function runProjectBuildCommand(input) {
   process.stdout.write(formatProjectBuildResult(result, input.format ?? "text", input.verbose === true));
   return true;
 }
-var import_yaml33, PACKAGE_FINGERPRINT_ROOT, PACKAGE_BUILDER_PROTOCOL_VERSION = "v23-sibling-site-output";
+var import_yaml35, PACKAGE_FINGERPRINT_ROOT, PACKAGE_BUILDER_PROTOCOL_VERSION = "v23-sibling-site-output";
 var init_packageBuilder = __esm(() => {
   init_knowledgeMap2();
   init_approvedFileRead();
@@ -72938,7 +73329,7 @@ var init_packageBuilder = __esm(() => {
   init_workspace();
   init_packageTemplateReview();
   init_approvedKnowledgeMetadata();
-  import_yaml33 = __toESM(require_dist(), 1);
+  import_yaml35 = __toESM(require_dist(), 1);
   PACKAGE_FINGERPRINT_ROOT = join62(".tmp", "context-runtime", "packages");
 });
 
@@ -73709,7 +74100,7 @@ function parseApprovedRevision(value) {
   if (!value || typeof value !== "object" || !("protocol" in value) || value.protocol !== "context.approved-revision/v1")
     return;
   const parsed = requestSchema2.parse(value);
-  if (!isSafeKnowledgeTargetPath(parsed.target.collection, parsed.target.path) || parsed.revision !== requestDigest(parsed) || parsed.target.previous_path !== undefined && !isSafeKnowledgeTargetPath(parsed.target.collection, parsed.target.previous_path))
+  if (!isSafeKnowledgeTargetPath(parsed.target.collection, parsed.target.path) || parsed.revision !== requestDigest(parsed) || parsed.target.previous_path !== undefined && (!indexerKnowledgeCollectionSchema2.safeParse(parsed.target.previous_path.split("/")[0]).success || !isSafeKnowledgeTargetPath(parsed.target.previous_path.split("/")[0], parsed.target.previous_path)))
     throw new TypeError("Approved revision target or digest is invalid");
   const { candidate: raw, batch_candidates: batch, ...rest } = parsed;
   const request = { ...rest, ...batch === undefined ? {} : { batch_candidates: batch.map((item, index2) => parseCandidateRecord(item, index2 + 1)) } };
@@ -73902,12 +74293,15 @@ async function prepareApprovedRevision(input) {
       };
     }
     if (input.move_to !== undefined) {
-      if (input.create || !isSafeKnowledgeTargetPath(target.collection, input.move_to) || input.move_to === target.path) {
-        throw new TypeError("Move requires a different safe path in the same knowledge collection.");
+      const destinationCollection = indexerKnowledgeCollectionSchema2.safeParse(input.move_to.split("/")[0]);
+      if (input.create || !destinationCollection.success || !isSafeKnowledgeTargetPath(destinationCollection.data, input.move_to) || input.move_to.includes("\\") || input.move_to === target.path) {
+        throw new TypeError("Move requires a different safe path in a supported knowledge collection.");
       }
       const { moveKnowledgeLinkTargets: moveKnowledgeLinkTargets2 } = await Promise.resolve().then(() => (init_approvedPageMove(), exports_approvedPageMove));
-      const movedMarkdown = moveKnowledgeLinkTargets2(target.markdown, input.move_to, target.path, new Map([[target.path, input.move_to]])).replace(/^resource:.*$/mu, `resource: knowledge:${input.move_to.replace(/\.md$/u, "")}`);
-      target = { ...target, previous_path: target.path, path: input.move_to, markdown: movedMarkdown };
+      const movedMarkdown = moveKnowledgeLinkTargets2(target.markdown, input.move_to, target.path, new Map([[target.path, input.move_to]])).replace(/^resource:.*$/mu, `resource: knowledge:${input.move_to.replace(/\.md$/u, "")}`).replace(/^---\r?\n([\s\S]*?)\r?\n---/u, (header, fields) => target.collection === destinationCollection.data ? header : `---
+${import_yaml36.default.stringify({ ...import_yaml36.default.parse(fields), type: okfTypeForCollection(destinationCollection.data) }).trimEnd()}
+---`);
+      target = { ...target, collection: destinationCollection.data, previous_path: target.path, path: input.move_to, markdown: movedMarkdown };
       await assertApprovedRevisionBase(input.projectRoot, { target });
     }
     if (input.supporting_sources) {
@@ -73958,7 +74352,7 @@ async function prepareApprovedRevision(input) {
 }
 function frontmatter(markdown) {
   const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u.exec(markdown);
-  const parsed = match ? import_yaml35.default.parse(match[1]) : undefined;
+  const parsed = match ? import_yaml36.default.parse(match[1]) : undefined;
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
     throw new TypeError("Revision must retain the approved page frontmatter");
   return parsed;
@@ -74246,7 +74640,7 @@ async function reopenApprovedRevision(input) {
     };
   });
 }
-var import_yaml35, digest5, revisionTargetSchema, requestSchema2;
+var import_yaml36, digest5, revisionTargetSchema, requestSchema2;
 var init_approvedRevision = __esm(() => {
   init_productionRequirements();
   init_approvedRevisionEdits();
@@ -74263,8 +74657,9 @@ var init_approvedRevision = __esm(() => {
   init_durableSingleFileTransaction();
   init_durableMultiFileTransaction();
   init_processedScopeStorage();
+  init_okfTypes();
   init_maintenanceStorage();
-  import_yaml35 = __toESM(require_dist(), 1);
+  import_yaml36 = __toESM(require_dist(), 1);
   digest5 = exports_external.string().regex(/^sha256:[a-f0-9]{64}$/u);
   revisionTargetSchema = exports_external.object({
     path: exports_external.string().min(1),
@@ -81718,7 +82113,7 @@ async function approveProductionReport(input) {
       throw new TypeError("The report's plan changed. Read and present the current proposal before confirming it.");
     }
     const file = input.manifest ?? await readProductionFile(input);
-    const decision = productionReportInputSchema.extend({ stage: exports_external.literal(stage.id) }).parse(import_yaml38.default.parse(file.text));
+    const decision = productionReportInputSchema.extend({ stage: exports_external.literal(stage.id) }).parse(import_yaml39.default.parse(file.text));
     if (!stage.report_approved)
       await assertProductionPlanRequirementsCurrent(input.projectRoot, stage);
     if (decision.decision === "approved")
@@ -81734,7 +82129,7 @@ async function approveProductionReport(input) {
     }
   }));
 }
-var import_yaml38, productionReportInputSchema;
+var import_yaml39, productionReportInputSchema;
 var init_productionReport = __esm(() => {
   init_zod();
   init_src2();
@@ -81744,7 +82139,7 @@ var init_productionReport = __esm(() => {
   init_productionStagePreparation();
   init_productionPlanning();
   init_productionFeedback();
-  import_yaml38 = __toESM(require_dist(), 1);
+  import_yaml39 = __toESM(require_dist(), 1);
   productionReportInputSchema = exports_external.object({ stage: exports_external.string().min(1), decision: exports_external.literal("approved") }).strict();
 });
 
@@ -88328,6 +88723,355 @@ var init_actionInputWorkspace = __esm(() => {
   init_workspace();
 });
 
+// src/project/articleRetirement.ts
+var exports_articleRetirement = {};
+__export(exports_articleRetirement, {
+  retireArticles: () => retireArticles,
+  articleRetirementSchema: () => articleRetirementSchema
+});
+import { readFile as readFile74, readdir as readdir20 } from "node:fs/promises";
+import { posix as posix10 } from "node:path";
+function invalid(reason, message, details = {}) {
+  throw new ContextError(ExitCode.UserError, message, {
+    category: ErrorCategory.UserInputInvalid,
+    reason_code: reason,
+    ...details,
+    next_action: {
+      command: next,
+      message: "Keep the retirement input. Resolve the listed page/reference or finish the active revision, then preview it again; no retirement was applied."
+    }
+  });
+}
+async function text9(root2, path3) {
+  try {
+    return await readFile74(await safeProjectTarget(root2, path3), "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return;
+    throw error;
+  }
+}
+async function retireArticles(input) {
+  const parsed = articleRetirementSchema.safeParse(input.value);
+  if (!parsed.success)
+    invalid("article-retirement-input-invalid", "Provide reason and targets with exact approved paths and optional replacement paths.", { input_schema: { reason: "string", targets: [{ path: "collection/old.md", replacement: "collection/approved-successor.md (optional)" }] } });
+  const value = parsed.data;
+  return withProjectWriteLock(input.projectRoot, "retire-articles", async () => {
+    if (input.apply)
+      await recoverDurableMultiFileTransactions(input.projectRoot);
+    if (input.apply && input.plan_digest && /^sha256:[a-f0-9]{64}$/u.test(input.plan_digest)) {
+      const receipt3 = await text9(input.projectRoot, `.tmp/context-runtime/retirements/${input.plan_digest.slice(7)}/receipt.json`);
+      if (receipt3) {
+        const saved = JSON.parse(receipt3);
+        if (saved.request !== indexerProtocolDigest(value))
+          invalid("article-retirement-input-changed", "The retirement input differs from the applied request.");
+        for (const file of saved.files) {
+          const current2 = await text9(input.projectRoot, file.path);
+          if ((current2 === undefined ? null : durableContentDigest(current2)) !== file.digest)
+            invalid("article-retirement-result-changed", "Retirement was applied but a resulting file has since changed; inspect the current workspace.", { path: file.path });
+        }
+        return { action: "already-applied", revision: input.plan_digest, next_action: { command: next } };
+      }
+    }
+    const maintenance = await readMaintenance(input.projectRoot);
+    if ((await readCandidateRecords(input.projectRoot)).length || await readApprovedRevision(input.projectRoot) || await readKnowledgeUpdate(input.projectRoot) || await readTaskRollback(input.projectRoot) || maintenance.active) {
+      invalid("article-retirement-active-review", "Finish the active candidate/revision delivery before retiring approved pages.");
+    }
+    const before = await text9(input.projectRoot, "knowledge/structure.yaml");
+    const structure = before === undefined ? {} : import_yaml41.default.parse(before);
+    const articles = validateArticleStructureEntries(structure.articles ?? []);
+    const byPath = new Map(articles.map((article) => [article.path, article]));
+    const selected = new Set(value.targets.map((target) => target.path));
+    if (selected.size !== value.targets.length)
+      invalid("article-retirement-duplicate", "Select each approved article once.");
+    if (maintenance.pending.some((request) => request.targets.some((target) => selected.has(target.path)))) {
+      invalid("article-retirement-pending-maintenance", "Cancel or finish queued maintenance for the selected pages before retirement.");
+    }
+    const stage = await readProductionStage(input.projectRoot);
+    if (stage?.tasks.some((task) => selected.has(task.path) && !["accepted", "excluded", "replaced"].includes(task.status))) {
+      invalid("article-retirement-pending-task", "A selected article still has unfinished production; finish or amend that task first.");
+    }
+    const replacements = new Map;
+    for (const target of value.targets) {
+      if (!byPath.has(target.path))
+        invalid("article-retirement-target-missing", "Select an exact approved article path from knowledge/structure.yaml.", { path: target.path });
+      if (target.replacement !== undefined && (!byPath.has(target.replacement) || selected.has(target.replacement))) {
+        invalid("article-retirement-replacement-invalid", "Replacement must be an already-approved article outside the retirement set.", { path: target.path, replacement: target.replacement });
+      }
+      replacements.set(target.path, target.replacement);
+    }
+    const targets = [];
+    const restore = [];
+    function change(path3, old, content3) {
+      if (old === content3)
+        return;
+      targets.push(content3 === undefined ? { path: path3, operation: "delete", base_digest: durableContentDigest(old), target_digest: null } : { path: path3, operation: "write", base_digest: old === undefined ? null : durableContentDigest(old), target_digest: durableContentDigest(content3), content: content3 });
+      restore.push({ path: path3, base_digest: content3 === undefined ? null : durableContentDigest(content3), content: old ?? null });
+    }
+    const blockers = [];
+    const readDigests = [];
+    for (const article of articles) {
+      const path3 = `knowledge/${article.path}`;
+      const bytes = await text9(input.projectRoot, path3);
+      if (bytes === undefined)
+        invalid("article-retirement-article-missing", "Approved article bytes are missing; recover the workspace before retirement.", { path: path3 });
+      readDigests.push({ path: path3, digest: durableContentDigest(bytes) });
+      if (selected.has(article.path)) {
+        change(path3, bytes);
+        continue;
+      }
+      const content3 = replaceMarkdownInlineLinkTargets(bytes, (link2) => {
+        if (link2.target.startsWith("#") || link2.target.startsWith("//"))
+          return;
+        const knowledge = link2.target.startsWith("knowledge:");
+        if (!knowledge && /^[a-z][a-z0-9+.-]*:/iu.test(link2.target))
+          return;
+        const match = /^([^#?]*)(.*)$/u.exec(knowledge ? link2.target.slice(10) : link2.target);
+        let target;
+        try {
+          target = decodeURI(match[1]);
+        } catch {
+          return;
+        }
+        const rooted = /^\/?knowledge\//u.test(target);
+        if (target.startsWith("/") && !rooted)
+          return;
+        let resolved = knowledge ? target : rooted ? target.replace(/^\/?knowledge\//u, "") : posix10.normalize(posix10.join(posix10.dirname(article.path), target));
+        if (knowledge && !resolved.endsWith(".md"))
+          resolved += ".md";
+        if (!selected.has(resolved))
+          return;
+        const replacement = replacements.get(resolved);
+        if (!replacement || match[2].includes("#")) {
+          blockers.push({ path: path3, target: link2.target, reason: replacement ? "Repair fragment links explicitly before retirement." : "Repair this incoming link or supply an approved replacement." });
+          return;
+        }
+        return knowledge ? `knowledge:${target.endsWith(".md") ? replacement : replacement.replace(/\.md$/u, "")}${match[2]}` : `${encodeURI(rooted ? `${target.startsWith("/") ? "/" : ""}knowledge/${replacement}` : posix10.relative(posix10.dirname(article.path), replacement))}${match[2]}`;
+      });
+      change(path3, bytes, content3);
+    }
+    async function inspectTemplates(directory2) {
+      const absolute = await safeProjectTarget(input.projectRoot, directory2);
+      const entries2 = await readdir20(absolute, { withFileTypes: true }).catch((error) => {
+        if (error.code === "ENOENT")
+          return [];
+        throw error;
+      });
+      for (const entry of entries2) {
+        const path3 = `${directory2}/${entry.name}`;
+        if (entry.isDirectory()) {
+          await inspectTemplates(path3);
+          continue;
+        }
+        if (!entry.isFile() || !entry.name.endsWith(".md"))
+          continue;
+        const bytes = await text9(input.projectRoot, path3);
+        readDigests.push({ path: path3, digest: durableContentDigest(bytes) });
+        replaceMarkdownInlineLinkTargets(bytes, (link2) => {
+          if (/^(?!knowledge:)[a-z][a-z0-9+.-]*:/iu.test(link2.target))
+            return;
+          let destination;
+          try {
+            destination = decodeURI(link2.target.split(/[?#]/u)[0]);
+          } catch {
+            return;
+          }
+          if (destination.startsWith("knowledge:") && !destination.endsWith(".md"))
+            destination += ".md";
+          if ([...selected].some((old) => destination === old || destination.endsWith(`/${old}`) || destination === `knowledge:${old}`)) {
+            blockers.push({ path: path3, target: link2.target, reason: "Update this custom package-template link before retirement." });
+          }
+          return;
+        });
+      }
+    }
+    await inspectTemplates("src/package-templates");
+    const map4 = await readKnowledgeMap(input.projectRoot);
+    if (map4) {
+      const retiredIds = new Map(value.targets.map((target) => [byPath.get(target.path).article_id, target]));
+      const upsert = map4.entries.flatMap((entry) => {
+        const target = entry.target && retiredIds.get(entry.target.artifact_ref);
+        if (!target)
+          return [];
+        if (target.replacement && entry.target?.section_key) {
+          blockers.push({ path: KNOWLEDGE_MAP_PATH, target: entry.key, reason: "Rebind this fragment navigation entry explicitly before retirement." });
+          return [];
+        }
+        const { target: _old, ...group } = entry;
+        return [target.replacement ? { ...group, target: { artifact_ref: byPath.get(target.replacement).article_id } } : group];
+      });
+      const updated = updateKnowledgeMap(map4, { expected_revision: map4.revision, upsert, remove: [] });
+      change(KNOWLEDGE_MAP_PATH, await text9(input.projectRoot, KNOWLEDGE_MAP_PATH), import_yaml41.default.stringify(updated));
+    }
+    change("knowledge/structure.yaml", before, import_yaml41.default.stringify({ ...structure, articles: articles.filter((article) => !selected.has(article.path)) }));
+    targets.sort((a, b) => a.path.localeCompare(b.path));
+    const revision = indexerProtocolDigest({ value, readDigests, targets });
+    const preview = {
+      action: "preview",
+      revision,
+      reason: value.reason,
+      retired: value.targets,
+      changed_files: targets.map((target) => ({ path: target.path, operation: target.operation })),
+      blockers,
+      next_action: { command: blockers.length ? next : `context task retire --input <same-file> --apply --plan-digest '${revision}' --format json` }
+    };
+    if (!input.apply)
+      return preview;
+    if (input.plan_digest !== revision)
+      invalid("article-retirement-preview-stale", "Preview this retirement input again; the selected pages, links or navigation changed.");
+    if (blockers.length)
+      invalid("article-retirement-references-unresolved", "Resolve incoming fragment links before applying retirement.", { blockers });
+    const directory = `.tmp/context-runtime/retirements/${revision.slice(7)}`;
+    const recovery = `${directory}/restore.json`;
+    const receipt2 = `${directory}/receipt.json`;
+    change(recovery, await text9(input.projectRoot, recovery), JSON.stringify({ summary: `Restore retired articles: ${value.reason}`, discard_unfinished: true, files: [...restore] }));
+    change(receipt2, await text9(input.projectRoot, receipt2), JSON.stringify({
+      request: indexerProtocolDigest(value),
+      files: targets.map((target) => ({ path: target.path, digest: target.target_digest }))
+    }));
+    await runDurableMultiFileTransaction({
+      projectRoot: input.projectRoot,
+      kind: "retire-articles",
+      proposal_digest: revision,
+      targets: targets.sort((a, b) => a.path.localeCompare(b.path)),
+      ...input.inject_failure ? { inject_failure: input.inject_failure } : {}
+    });
+    return {
+      action: "applied",
+      revision,
+      retired: [...selected],
+      recovery,
+      next_action: { command: next, message: "Retired pages and references were updated together. Follow the current close/version/build Route before delivering outputs. The restore input is temporary; retain it or a Git baseline if later restoration is needed." }
+    };
+  });
+}
+var import_yaml41, articleRetirementSchema, next = "context status --format json";
+var init_articleRetirement = __esm(() => {
+  init_zod();
+  init_src2();
+  init_errors3();
+  init_cliFeedback();
+  init_exitCode();
+  init_candidateLedger();
+  init_approvedRevision();
+  init_knowledgeUpdate();
+  init_taskRollback();
+  init_maintenanceStorage();
+  init_productionStageStore();
+  init_knowledgeMap2();
+  init_markdownLinks();
+  init_durableSingleFileTransaction();
+  init_durableMultiFileTransaction();
+  init_writeLock();
+  import_yaml41 = __toESM(require_dist(), 1);
+  articleRetirementSchema = exports_external.object({
+    reason: exports_external.string().trim().min(1),
+    targets: exports_external.array(exports_external.object({ path: exports_external.string().min(1), replacement: exports_external.string().min(1).optional() }).strict()).min(1)
+  }).strict();
+});
+
+// src/lib/schemaOutput.ts
+var exports_schemaOutput = {};
+__export(exports_schemaOutput, {
+  writeSchemaOutput: () => writeSchemaOutput,
+  schemaOutputFormat: () => schemaOutputFormat
+});
+function schemaOutputFormat(value) {
+  if (value === "text" || value === "yaml" || value === "json")
+    return value;
+  throw new ContextError(ExitCode.UserError, "Expected schema format text, json, or yaml", { category: ErrorCategory.UserInputInvalid });
+}
+function writeSchemaOutput(value, format2) {
+  process.stdout.write(format2 === "json" ? `${JSON.stringify(value, null, 2)}
+` : import_yaml42.default.stringify(value));
+}
+var import_yaml42;
+var init_schemaOutput = __esm(() => {
+  init_errors3();
+  init_cliFeedback();
+  init_exitCode();
+  import_yaml42 = __toESM(require_dist(), 1);
+});
+
+// src/project/writeLockRecovery.ts
+var exports_writeLockRecovery = {};
+__export(exports_writeLockRecovery, {
+  recoverWriterLock: () => recoverWriterLock,
+  inspectWriterLock: () => inspectWriterLock
+});
+import { lstat as lstat9, mkdir as mkdir32, readFile as readFile75, readdir as readdir21, rename as rename7, rmdir as rmdir2 } from "node:fs/promises";
+import { join as join94 } from "node:path";
+import { createHash as createHash28, randomUUID as randomUUID7 } from "node:crypto";
+async function inspectWriterLock(root2) {
+  const path3 = await safeProjectTarget(root2, lockRelative);
+  let stat11;
+  try {
+    stat11 = await lstat9(path3);
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return null;
+    throw error;
+  }
+  if (!stat11.isDirectory() || stat11.isSymbolicLink())
+    throw new Error("Writer lock must be a real directory.");
+  const ownerPath = await safeProjectTarget(root2, `${lockRelative}/owner.json`);
+  const bytes = await readFile75(ownerPath, "utf8");
+  const owner = JSON.parse(bytes);
+  if (owner.protocol !== "context.project-write-lock.v1" || !Number.isSafeInteger(owner.pid) || owner.pid <= 0) {
+    throw new Error("Writer lock owner is invalid; preserve the lock for diagnosis.");
+  }
+  let processState = "running";
+  try {
+    process.kill(owner.pid, 0);
+  } catch (error) {
+    const code3 = error.code;
+    processState = code3 === "ESRCH" ? "not-running" : code3 === "EPERM" ? "running" : "unknown";
+  }
+  const digest6 = `sha256:${createHash28("sha256").update(`${stat11.dev}:${stat11.ino}:${stat11.birthtimeMs}:${bytes}`).digest("hex")}`;
+  return { ...owner, process_state: processState, digest: digest6, path: lockRelative };
+}
+async function recoverWriterLock(input) {
+  const before = await inspectWriterLock(input.projectRoot);
+  if (!before)
+    return { action: "writer-lock-absent", next: "context task recover --format json" };
+  if (before.process_state !== "not-running")
+    throw new Error("Writer is running or cannot be identified as stopped; keep the lock.");
+  if (!input.apply)
+    return {
+      action: "preview",
+      operation: "writer-lock",
+      revision: before.digest,
+      owner: before,
+      effect: "Archive only this orphan lock. Before applying, stop new workspace commands and confirm no surviving child writer or other host/container uses this workspace. This does not complete interrupted captures or transactions.",
+      next: `${command2} --apply --plan-digest '${before.digest}'`
+    };
+  if (input.plan_digest !== before.digest)
+    throw new Error("Writer lock changed; preview recovery again.");
+  const path3 = join94(input.projectRoot, lockRelative);
+  const guard = join94(path3, ".recovery");
+  await mkdir32(guard);
+  let archived = false;
+  try {
+    const current2 = await inspectWriterLock(input.projectRoot);
+    if (current2?.digest !== before.digest || current2.process_state !== "not-running")
+      throw new Error("Writer lock changed or owner resumed; keep the lock.");
+    const names = await readdir21(path3);
+    if (names.some((name3) => name3 !== "owner.json" && name3 !== ".recovery"))
+      throw new Error("Unexpected lock contents; preserve for diagnosis.");
+    const archive = `.tmp/context-runtime/locks/recovered-write-${randomUUID7()}.lock`;
+    await rename7(path3, join94(input.projectRoot, archive));
+    archived = true;
+    return { action: "writer-lock-recovered", archived_lock: archive, next: "context task recover --format json" };
+  } finally {
+    if (!archived)
+      await rmdir2(guard);
+  }
+}
+var lockRelative = ".tmp/context-runtime/locks/project-write.lock", command2 = "context task recover --operation writer-lock --format json";
+var init_writeLockRecovery = __esm(() => {
+  init_durableMultiFileTransaction();
+});
+
 // src/project/taskRecovery.ts
 var exports_taskRecovery = {};
 __export(exports_taskRecovery, {
@@ -88339,12 +89083,12 @@ __export(exports_taskRecovery, {
   RECOVERY_COMMAND: () => RECOVERY_COMMAND
 });
 import { existsSync as existsSync26 } from "node:fs";
-import { dirname as dirname40, join as join94 } from "node:path";
-import { lstat as lstat9, readdir as readdir20, readFile as readFile74 } from "node:fs/promises";
+import { dirname as dirname40, join as join95 } from "node:path";
+import { lstat as lstat10, readdir as readdir22, readFile as readFile76 } from "node:fs/promises";
 async function recoveryText(root2, path3) {
   const target = await safeProjectTarget(root2, path3);
   try {
-    return await readFile74(target, "utf8");
+    return await readFile76(target, "utf8");
   } catch (error) {
     if (error.code === "ENOENT")
       return;
@@ -88355,22 +89099,22 @@ async function recoveryJournals(root2) {
   const entries2 = [];
   async function visit4(path3, depth) {
     await safeProjectTarget(root2, path3);
-    let stat10;
+    let stat11;
     try {
-      stat10 = await lstat9(join94(root2, path3));
+      stat11 = await lstat10(join95(root2, path3));
     } catch (error) {
       if (error.code === "ENOENT")
         return;
       throw error;
     }
-    if (stat10.isSymbolicLink())
+    if (stat11.isSymbolicLink())
       throw new TypeError("Recovery does not follow transaction symlinks.");
-    if (stat10.isDirectory()) {
+    if (stat11.isDirectory()) {
       if (depth > 3)
         throw new TypeError("Unexpected transaction directory depth; preserve it for diagnosis.");
-      for (const name3 of (await readdir20(join94(root2, path3))).sort())
+      for (const name3 of (await readdir22(join95(root2, path3))).sort())
         await visit4(`${path3}/${name3}`, depth + 1);
-    } else if (stat10.isFile())
+    } else if (stat11.isFile())
       entries2.push({ path: path3, digest: indexerProtocolDigest(await recoveryText(root2, path3)) });
   }
   await visit4(TRANSACTIONS_PATH, 0);
@@ -88380,8 +89124,8 @@ function recoveryResources() {
   try {
     const root2 = dirname40(contextWorkflowProviderPath());
     const resources = {
-      skill: join94(root2, "skills/recover-workspace/SKILL.md"),
-      issue_template: join94(root2, "resources/templates/recovery-issue.md")
+      skill: join95(root2, "skills/recover-workspace/SKILL.md"),
+      issue_template: join95(root2, "resources/templates/recovery-issue.md")
     };
     if (!Object.values(resources).every((path3) => existsSync26(path3)))
       throw new Error("Recovery resources are absent from this Provider.");
@@ -88402,10 +89146,7 @@ async function inspectTaskRecovery(root2) {
   }
   const stage = await probe("production-stage", () => readProductionStage(root2));
   const journals = await probe("transactions", () => recoveryJournals(root2));
-  const lock = await probe("writer-lock", async () => {
-    const text9 = await recoveryText(root2, ".tmp/context-runtime/locks/project-write.lock/owner.json");
-    return text9 === undefined ? null : JSON.parse(text9);
-  });
+  const lock = await probe("writer-lock", () => inspectWriterLock(root2));
   return {
     action: "recovery-inspected",
     resources: recoveryResources(),
@@ -88415,6 +89156,7 @@ async function inspectTaskRecovery(root2) {
     transactions: journals,
     writer_lock: lock,
     actions: [
+      ...lock?.process_state === "not-running" ? [{ operation: "writer-lock", command: `${RECOVERY_COMMAND} --operation writer-lock` }] : [],
       ...journals?.length ? [{ operation: "transactions", command: `${RECOVERY_COMMAND} --operation transactions` }] : [],
       ...stage ? [{ operation: "continue", command: "context status --format json" }] : []
     ],
@@ -88460,6 +89202,7 @@ var init_taskRecovery = __esm(() => {
   init_writeLock();
   init_durableMultiFileTransaction();
   init_workflowProvider();
+  init_writeLockRecovery();
 });
 
 // src/project/taskLocalSourceAdjustment.ts
@@ -88467,8 +89210,8 @@ var exports_taskLocalSourceAdjustment = {};
 __export(exports_taskLocalSourceAdjustment, {
   adjustLocalRevisionSources: () => adjustLocalRevisionSources
 });
-import { readFile as readFile75 } from "node:fs/promises";
-import { join as join95 } from "node:path";
+import { readFile as readFile77 } from "node:fs/promises";
+import { join as join96 } from "node:path";
 async function adjustLocalRevisionSources(root2, input) {
   const { readMaintenance: readMaintenance2 } = await Promise.resolve().then(() => (init_maintenanceStorage(), exports_maintenanceStorage));
   if ((await readMaintenance2(root2)).active && await readProductionStage(root2))
@@ -88492,11 +89235,11 @@ async function adjustLocalRevisionSources(root2, input) {
   if (input.refresh && (!current2.refresh_sources || indexerProtocolDigest([...current2.refresh_sources].sort()) !== indexerProtocolDigest([...selected].sort()))) {
     throw new TypeError("No matching acquisition adjustment exists. Run task adjust without refresh first.");
   }
-  const raw = await readFile75(join95(root2, await revisionStoragePath(root2)), "utf8");
-  let next;
+  const raw = await readFile77(join96(root2, await revisionStoragePath(root2)), "utf8");
+  let next2;
   const discardIds = new Set;
   if (!input.refresh) {
-    next = { ...current2, refresh_sources: selected };
+    next2 = { ...current2, refresh_sources: selected };
   } else {
     const oldScopes = [
       ...revision?.processed_scopes ?? update?.scopes ?? [],
@@ -88570,7 +89313,7 @@ ${input.instruction}`,
 
 ${input.instruction}` : revision.instruction
       };
-      next = { ...payload, revision: requestDigest(payload), ...!affected && candidate ? { candidate } : {} };
+      next2 = { ...payload, revision: requestDigest(payload), ...!affected && candidate ? { candidate } : {} };
       if (affected && candidate)
         discardIds.add(candidate.candidate_id);
     } else {
@@ -88578,14 +89321,14 @@ ${input.instruction}` : revision.instruction
       const payload = { ...rest, scopes, requirements, changes: [rest.changes, input.instruction].filter(Boolean).join(`
 
 `) };
-      next = { ...payload, revision: indexerProtocolDigest(payload) };
+      next2 = { ...payload, revision: indexerProtocolDigest(payload) };
     }
   }
   if (update && !input.refresh) {
-    const { revision: _revision, ...payload } = next;
-    next.revision = indexerProtocolDigest(payload);
+    const { revision: _revision, ...payload } = next2;
+    next2.revision = indexerProtocolDigest(payload);
   }
-  const content3 = `${JSON.stringify(next)}
+  const content3 = `${JSON.stringify(next2)}
 `;
   const targets = [{
     path: await revisionStoragePath(root2),
@@ -88595,7 +89338,7 @@ ${input.instruction}` : revision.instruction
     content: content3
   }];
   if (discardIds.size > 0) {
-    const ledger = await readFile75(join95(root2, CANDIDATE_LEDGER_FILE), "utf8").catch((error) => {
+    const ledger = await readFile77(join96(root2, CANDIDATE_LEDGER_FILE), "utf8").catch((error) => {
       if (error.code === "ENOENT")
         return;
       throw error;
@@ -88715,7 +89458,7 @@ var init_taskSourceAdjustment = __esm(() => {
 });
 
 // src/project/managedDocumentImport.ts
-import { readFile as readFile81 } from "node:fs/promises";
+import { readFile as readFile83 } from "node:fs/promises";
 async function importManagedDocument(projectRoot, value) {
   const input = inputSchema.parse(value);
   if (input.type !== "sessions" && input.changes !== undefined)
@@ -88724,7 +89467,7 @@ async function importManagedDocument(projectRoot, value) {
     const path3 = await assertManagedDocumentPath(projectRoot, input.type, input.name);
     let previous3;
     try {
-      previous3 = await readFile81(path3, "utf8");
+      previous3 = await readFile83(path3, "utf8");
     } catch (error) {
       if (!(error && typeof error === "object" && ("code" in error) && error.code === "ENOENT"))
         throw error;
@@ -88771,14 +89514,14 @@ var init_managedDocumentImport = __esm(() => {
 });
 
 // src/project/larkDocumentImport.ts
-import { readFile as readFile82 } from "node:fs/promises";
+import { readFile as readFile84 } from "node:fs/promises";
 async function importLarkDocument(projectRoot, value) {
   const input = schema3.parse(value);
   const responsePages = [];
   for (const path3 of input.response_files) {
     assertActionInputWorkspace(projectRoot, path3);
     const { resolve: resolve8 } = await import("node:path");
-    responsePages.push(await readFile82(resolve8(projectRoot, path3), "utf8"));
+    responsePages.push(await readFile84(resolve8(projectRoot, path3), "utf8"));
   }
   const mediaFiles = {};
   for (const [token, path3] of Object.entries(input.media_files ?? {})) {
@@ -88846,11 +89589,11 @@ var exports_managedDocumentRename = {};
 __export(exports_managedDocumentRename, {
   renameManagedDocument: () => renameManagedDocument
 });
-import { readFile as readFile83 } from "node:fs/promises";
-import { join as join103, posix as posix10 } from "node:path";
+import { readFile as readFile85 } from "node:fs/promises";
+import { join as join104, posix as posix11 } from "node:path";
 async function optionalText2(path3) {
   try {
-    return await readFile83(path3, "utf8");
+    return await readFile85(path3, "utf8");
   } catch (error) {
     if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
       return;
@@ -88934,12 +89677,12 @@ async function renameManagedDocument(input) {
       if (path3.split("/").includes("..") || path3.startsWith("/"))
         throw new TypeError("Source references contain an unsafe knowledge path; repair it before renaming.");
       await safeProjectTarget(input.projectRoot, path3);
-      const before = await optionalText2(join103(input.projectRoot, path3));
+      const before = await optionalText2(join104(input.projectRoot, path3));
       if (before === undefined)
         continue;
       let after;
       if (path3.endsWith(".yaml")) {
-        const parsed = import_yaml46.default.parse(before);
+        const parsed = import_yaml48.default.parse(before);
         const updated = replace2(parsed);
         if (path3 === "knowledge/structure.yaml") {
           const rewritten = articles.map((article) => ({ ...article, sections: article.sections.map((section) => ({
@@ -88947,14 +89690,14 @@ async function renameManagedDocument(input) {
             references: section.references.map((citation) => citation.source_ref !== input.source_ref ? citation : {
               ...citation,
               source_ref: nextRef,
-              locator: { ...citation.locator, path: posix10.basename(input.name) }
+              locator: { ...citation.locator, path: posix11.basename(input.name) }
             })
           })) }));
           updated.articles = rewritten;
         }
         if (JSON.stringify(parsed) === JSON.stringify(updated))
           continue;
-        after = import_yaml46.default.stringify(updated);
+        after = import_yaml48.default.stringify(updated);
       } else
         after = before.replace(reference2, nextRef);
       if (path3 === "src/index.ts")
@@ -88973,11 +89716,11 @@ async function renameManagedDocument(input) {
             return;
           }
           const rooted = destination.startsWith("sources/") || destination.startsWith("/sources/");
-          const resolved = rooted ? destination.replace(/^\//u, "") : posix10.normalize(posix10.join(posix10.dirname(path3), destination));
+          const resolved = rooted ? destination.replace(/^\//u, "") : posix11.normalize(posix11.join(posix11.dirname(path3), destination));
           if (resolved !== `sources/${type}/${oldName}`)
             return;
           const renamed = `sources/${type}/${input.name}`;
-          return encodeURI(rooted ? `${destination.startsWith("/") ? "/" : ""}${renamed}` : posix10.relative(posix10.dirname(path3), renamed)) + match2[2];
+          return encodeURI(rooted ? `${destination.startsWith("/") ? "/" : ""}${renamed}` : posix11.relative(posix11.dirname(path3), renamed)) + match2[2];
         });
       if (before === after)
         continue;
@@ -89006,7 +89749,7 @@ async function renameManagedDocument(input) {
     };
   });
 }
-var import_yaml46;
+var import_yaml48;
 var init_managedDocumentRename = __esm(() => {
   init_markdownLinks();
   init_src2();
@@ -89018,12 +89761,12 @@ var init_managedDocumentRename = __esm(() => {
   init_durableSingleFileTransaction();
   init_durableMultiFileTransaction();
   init_writeLock();
-  import_yaml46 = __toESM(require_dist(), 1);
+  import_yaml48 = __toESM(require_dist(), 1);
 });
 
 // src/cli.ts
 import { existsSync as existsSync36, realpathSync as realpathSync3 } from "node:fs";
-import { dirname as dirname47, join as join107 } from "node:path";
+import { dirname as dirname47, join as join108 } from "node:path";
 import { fileURLToPath as fileURLToPath10, pathToFileURL as pathToFileURL3 } from "node:url";
 
 // ../../node_modules/.bun/commander@11.1.0/node_modules/commander/esm.mjs
@@ -89103,7 +89846,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 stat9, writeFile as writeFile20 } from "node:fs/promises";
+import { mkdir as mkdir26, readdir as readdir16, readFile as readFile60, rm as rm16, 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
@@ -89113,7 +89856,7 @@ init_errors3();
 init_exitCode();
 init_markdownLinks();
 import { readFileSync as readFileSync6 } from "node:fs";
-import { mkdir as mkdir24, readFile as readFile57, stat as stat7, writeFile as writeFile18 } from "node:fs/promises";
+import { mkdir as mkdir24, readFile as readFile57, stat as stat8, writeFile as writeFile18 } from "node:fs/promises";
 import { dirname as dirname29, isAbsolute as isAbsolute13, join as join67, relative as relative20, resolve as resolve21 } from "node:path";
 function runtimeError(message, detail) {
   return new ContextError(ExitCode.UserError, message, {
@@ -89154,7 +89897,7 @@ async function writeCaptureAssetIfChanged(path2, content3) {
   await writeFile18(path2, content3);
 }
 async function readLinkedCaptureAssets(input) {
-  const rootStat = await stat7(input.localRoot);
+  const rootStat = await stat8(input.localRoot);
   const boundaryRoot = rootStat.isFile() ? dirname29(input.localRoot) : input.localRoot;
   const bySnapshotPath = new Map;
   for (const file of input.files) {
@@ -89173,7 +89916,7 @@ async function readLinkedCaptureAssets(input) {
       }
       let bytes;
       try {
-        const assetStat = await stat7(absolutePath);
+        const assetStat = await stat8(absolutePath);
         if (!assetStat.isFile())
           throw new TypeError("asset target is not a file");
         bytes = await readFile57(absolutePath);
@@ -96967,7 +97710,7 @@ async function readRouteMetadataFiles(input) {
 }
 
 // src/project/documentSiteDetection.ts
-import { readdir as readdir15, stat as stat8 } from "node:fs/promises";
+import { readdir as readdir15, stat as stat9 } from "node:fs/promises";
 import { basename as basename7, extname as extname11, join as join68, relative as relative21, resolve as resolve22 } from "node:path";
 var SKIPPED_DIRS = new Set([
   ".cache",
@@ -97018,7 +97761,7 @@ async function detectDocumentSiteFiles(input) {
   const result = emptyDetection();
   let rootStats;
   try {
-    rootStats = await stat8(localRoot);
+    rootStats = await stat9(localRoot);
   } catch {
     return result;
   }
@@ -97222,7 +97965,7 @@ function assignFlatSnapshotPaths(files, module) {
   });
 }
 async function walkMarkdownFiles(input) {
-  const rootStat = await stat9(input.localRoot);
+  const rootStat = await stat10(input.localRoot);
   if (rootStat.isFile()) {
     const sourcePath = normalizeSnapshotRelativePath(basename8(input.localRoot));
     return {
@@ -97839,7 +98582,7 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 init_atomicWrite();
-var import_yaml36 = __toESM(require_dist(), 1);
+var import_yaml37 = __toESM(require_dist(), 1);
 import { existsSync as existsSync20 } from "node:fs";
 import { join as join75 } from "node:path";
 var SOURCE_NAME_PATTERN2 = /^[a-z0-9][a-z0-9._-]*$/u;
@@ -97916,7 +98659,7 @@ async function writeRepoRegistry(projectRoot, registry2) {
     modules.push(registryRecordToYaml(record4));
     namespaces.set(record4.namespace, modules);
   }
-  await atomicWriteFile(path2, import_yaml36.default.stringify({
+  await atomicWriteFile(path2, import_yaml37.default.stringify({
     sources: [...namespaces].map(([name3, modules]) => ({ name: name3, modules }))
   }));
 }
@@ -98479,7 +99222,7 @@ init_errors3();
 init_exitCode();
 init_approvedKnowledgeMetadata();
 init_knowledgeAssets();
-var import_yaml37 = __toESM(require_dist(), 1);
+var import_yaml38 = __toESM(require_dist(), 1);
 import { createHash as createHash22 } from "node:crypto";
 import { mkdir as mkdir28, writeFile as writeFile21 } from "node:fs/promises";
 import { dirname as dirname34, join as join77 } from "node:path";
@@ -98553,7 +99296,7 @@ async function buildApprovedArticleIndex(projectRoot) {
     const block = frontmatterBlock(content3);
     if (block === null)
       continue;
-    const parsed = import_yaml37.default.parse(block.yaml);
+    const parsed = import_yaml38.default.parse(block.yaml);
     if (!isRecord14(parsed))
       continue;
     const frontmatter2 = hydrateApprovedFrontmatter({
@@ -98600,13 +99343,13 @@ function updateFrontmatter(content3, mutate) {
       next: "Fix approved Markdown frontmatter before running this review maintenance command."
     });
   }
-  const parsed = import_yaml37.default.parse(block.yaml);
+  const parsed = import_yaml38.default.parse(block.yaml);
   if (!isRecord14(parsed)) {
     throw new ContextError(ExitCode.WorkspaceStateError, "approved page frontmatter must be a YAML object", {
       category: ErrorCategory.SchemaInvalid
     });
   }
-  const yaml3 = import_yaml37.default.stringify(mutate(parsed)).trimEnd();
+  const yaml3 = import_yaml38.default.stringify(mutate(parsed)).trimEnd();
   return `---
 ${yaml3}
 ---${content3.slice(block.end)}`;
@@ -105437,76 +106180,12 @@ init_errors3();
 init_exitCode();
 init_candidateLedger();
 init_writeLock();
+init_reviewApplyIndexer();
+init_approvedKnowledgeSnapshots();
 import { existsSync as existsSync25 } from "node:fs";
 import { readFile as readFile69 } from "node:fs/promises";
 import { join as join91 } from "node:path";
 
-// src/project/reviewApplyIndexer.ts
-init_okfTypes();
-init_packageKnowledgeProjection();
-init_approvedKnowledgeMetadata();
-var import_yaml39 = __toESM(require_dist(), 1);
-function escapeHtmlAttribute(value) {
-  return value.replace(/&/gu, "&amp;").replace(/"/gu, "&quot;").replace(/</gu, "&lt;").replace(/>/gu, "&gt;");
-}
-function sectionMarkdown(section) {
-  return [
-    `<!-- context:section id="${escapeHtmlAttribute(section.section_key)}" -->`,
-    "",
-    section.markdown.trimEnd(),
-    "",
-    "<!-- /context:section -->"
-  ].join(`
-`);
-}
-function renderApprovedIndexerMarkdown(input) {
-  if (input.record.approved_revision !== undefined) {
-    const content3 = compactApprovedKnowledgeMarkdown(ensureApprovedKnowledgePresentation(input.record.body));
-    return content3.replace(/^---\r?\n([\s\S]*?)\r?\n---/u, (_match, header) => {
-      const metadata = import_yaml39.default.parse(header);
-      return ["---", import_yaml39.default.stringify({
-        ...metadata,
-        type: metadata.type ?? okfTypeForCollection(input.record.collection),
-        timestamp: input.timestamp
-      }).trimEnd(), "---"].join(`
-`);
-    });
-  }
-  const binding = input.record.indexer_candidate;
-  if (input.record.candidate_type !== "indexer-artifact" || binding === undefined) {
-    throw new TypeError("Indexer approved renderer requires an indexer-artifact Candidate");
-  }
-  const title = input.record.review.title;
-  const body = binding.sections.flatMap((section, index2) => [
-    ...index2 === 0 ? [] : [""],
-    sectionMarkdown(section)
-  ]).join(`
-`);
-  const description = readerKnowledgeDescription({
-    description: input.record.review.summary,
-    markdown: body,
-    title
-  });
-  const frontmatter2 = import_yaml39.default.stringify({
-    title,
-    type: okfTypeForCollection(input.record.collection),
-    description,
-    timestamp: input.timestamp
-  }).trimEnd();
-  return [
-    "---",
-    frontmatter2,
-    "---",
-    "",
-    ensureMarkdownPageTitle(body, title),
-    ""
-  ].join(`
-`);
-}
-
-// src/project/reviewApply.ts
-init_approvedKnowledgeSnapshots();
-
 // src/project/reviewCandidateAuthority.ts
 init_src2();
 init_approvedRevision();
@@ -105604,7 +106283,7 @@ async function prepareApprovedPage(input) {
   const relPath = join91("knowledge", input.record.path);
   const existingView = findApprovedPageForArticleId(input.record.indexer_candidate.artifact_ref, input.approvedPageIndex);
   const previousPath = input.record.approved_revision?.previous_path;
-  if (previousPath !== undefined && !isSafeKnowledgeTargetPath(input.record.collection, previousPath))
+  if (previousPath !== undefined && (!isSafeKnowledgeTargetPath(previousPath.split("/")[0], previousPath) || previousPath.includes("\\")))
     throw new TypeError("Unsafe original page path in a move");
   if (existingView !== undefined && existingView.relPath !== relPath && existingView.relPath !== (previousPath === undefined ? undefined : `knowledge/${previousPath}`)) {
     throw new ContextError(ExitCode.WorkspaceStateError, `approved page already exists for view_ref at a different path: ${input.record.article_id}`, {
@@ -107326,22 +108005,52 @@ function requireProjectRoot2() {
 }
 function registerDocumentRevisionCommand(program2) {
   const task = program2.command("task").description("Explicit current-task recovery");
-  task.command("recover").description("Inspect or preview scoped recovery independently of the normal workflow Route").option("--operation <operation>", "inspect or transactions; use ordinary file submission/revise for article repair", "inspect").option("--apply", "apply the reviewed recovery scope within existing user authorization").option("--plan-digest <digest>", "exact current recovery preview").option("--format <format>", "output format: json", "json").action(async (options) => {
+  task.command("retire").description("Preview or apply explicit approved-article retirement and reference cleanup").option("--input <file>", "YAML/JSON reason and targets with optional approved replacement; - for stdin").option("--schema", "show the retirement input schema").option("--apply", "apply the reviewed retirement within existing user authorization").option("--plan-digest <digest>", "exact current retirement preview").option("--format <format>", "output format: json", "json").action(async (options) => {
+    const { retireArticles: retireArticles2, articleRetirementSchema: articleRetirementSchema2 } = await Promise.resolve().then(() => (init_articleRetirement(), exports_articleRetirement));
+    if (options.schema) {
+      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(articleRetirementSchema2), 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 });
+    assertActionInputWorkspace(process.cwd(), options.input);
+    const value = await readYamlOrJsonInput({
+      path: options.input,
+      label: "article retirement",
+      missingNext: "Provide reason and targets with exact approved paths and optional replacement paths.",
+      readFailureNext: "Use an input file in this workspace.",
+      parseFailureNext: "Provide valid YAML or JSON."
+    });
+    const result = await retireArticles2({
+      projectRoot: requireProjectRoot2(),
+      value,
+      ...options.apply ? { apply: true } : {},
+      ...options.planDigest ? { plan_digest: options.planDigest } : {}
+    });
+    if (result.action === "preview" && result.blockers.length === 0)
+      result.next_action.command = `context task retire --input '${options.input.replace(/'/gu, "'\\''")}' --apply --plan-digest '${result.revision}' --format json`;
+    process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+  });
+  task.command("recover").description("Inspect or preview scoped recovery independently of the normal workflow Route").option("--operation <operation>", "inspect, writer-lock or transactions; use ordinary file submission/revise for article repair", "inspect").option("--apply", "apply the reviewed recovery scope within existing user authorization").option("--plan-digest <digest>", "exact current recovery preview").option("--format <format>", "output format: json", "json").action(async (options) => {
     if (options.format !== "json")
       throw new TypeError("--format must be json");
-    if (!["inspect", "transactions"].includes(options.operation))
-      throw new TypeError("Use inspect or transactions. Repair current task files or use context revise for an accepted article; old workset/plan recovery is not supported.");
+    if (!["inspect", "writer-lock", "transactions"].includes(options.operation))
+      throw new TypeError("Use inspect, writer-lock or transactions. Repair current task files or use context revise for an accepted article; old workset/plan recovery is not supported.");
     if (options.operation === "inspect" && options.apply)
       throw new TypeError("Inspection is read-only; select a recovery operation to apply.");
     const projectRoot = requireProjectRoot2();
     const { inspectTaskRecovery: inspectTaskRecovery2, recoverTaskTransactions: recoverTaskTransactions2 } = await Promise.resolve().then(() => (init_taskRecovery(), exports_taskRecovery));
+    const { recoverWriterLock: recoverWriterLock2 } = await Promise.resolve().then(() => (init_writeLockRecovery(), exports_writeLockRecovery));
     const base = {
       projectRoot,
       ...options.apply ? { apply: true } : {},
       ...options.planDigest ? { plan_digest: options.planDigest } : {}
     };
     try {
-      const result = options.operation === "inspect" ? await inspectTaskRecovery2(projectRoot) : await recoverTaskTransactions2(base);
+      const result = options.operation === "inspect" ? await inspectTaskRecovery2(projectRoot) : options.operation === "writer-lock" ? await recoverWriterLock2(base) : await recoverTaskTransactions2(base);
       process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     } catch (error) {
@@ -107465,7 +108174,7 @@ function registerDocumentRevisionCommand(program2) {
     process.stdout.write(`${JSON.stringify(await beginKnowledgeUpdate(requireProjectRoot2(), value), null, 2)}
 `);
   });
-  program2.command("revise <target>").description("Repair one current Candidate or approved knowledge page through the Indexer lifecycle").requiredOption("--instruction <feedback>", "reader-facing correction request").option("--regenerate", "regenerate program blocks for an approved page, even at the same source version").option("--timing <timing>", "after-batch or priority for approved pages; current Candidates are repaired in place", "after-batch").option("--move-to <path>", "explicit new approved path in the same collection; preserves page identity").option("--format <format>", "output format: json", "json").action(async (target, options) => {
+  program2.command("revise <target>").description("Repair one current Candidate or approved knowledge page through the Indexer lifecycle").requiredOption("--instruction <feedback>", "reader-facing correction request").option("--regenerate", "regenerate program blocks for an approved page, even at the same source version").option("--timing <timing>", "after-batch or priority for approved pages; current Candidates are repaired in place", "after-batch").option("--move-to <path>", "explicit new approved path in any supported collection; preserves page identity").option("--format <format>", "output format: json", "json").action(async (target, options) => {
     if (options.format !== "json") {
       throw new ContextError(ExitCode.UserError, "--format must be json", {
         category: ErrorCategory.UserInputInvalid
@@ -107494,8 +108203,8 @@ function registerDocumentRevisionCommand(program2) {
 init_workspace();
 init_workspaceChangelog();
 function registerVersionCommands(program2) {
-  const command2 = program2.command("version").description("Inspect formal changes and record a knowledge workspace SemVer and changelog");
-  command2.command("inspect").option("--publish", "include same-version dist changes before publishing").option("--format <format>", "json", "json").action(async (options) => {
+  const command3 = program2.command("version").description("Inspect formal changes and record a knowledge workspace SemVer and changelog");
+  command3.command("inspect").option("--publish", "include same-version dist changes before publishing").option("--format <format>", "json", "json").action(async (options) => {
     const root2 = findContextProjectRoot(process.cwd())?.projectRoot;
     if (!root2)
       throw new TypeError("Run inside a Context workspace");
@@ -107507,7 +108216,7 @@ function registerVersionCommands(program2) {
     }, null, 2) + `
 `);
   });
-  command2.command("publish-check").option("--format <format>", "json", "json").action(async () => {
+  command3.command("publish-check").option("--format <format>", "json", "json").action(async () => {
     const root2 = findContextProjectRoot(process.cwd())?.projectRoot;
     if (!root2)
       throw new TypeError("Run inside a Context workspace");
@@ -107515,7 +108224,7 @@ function registerVersionCommands(program2) {
     process.stdout.write(JSON.stringify(await inspectWorkspacePublish2(root2), null, 2) + `
 `);
   });
-  command2.command("published").requiredOption("--hash <hash>", "publish-check hash of uploaded artifacts").requiredOption("--receipt <receipt>", "successful external publication receipt").option("--format <format>", "json", "json").action(async (options) => {
+  command3.command("published").requiredOption("--hash <hash>", "publish-check hash of uploaded artifacts").requiredOption("--receipt <receipt>", "successful external publication receipt").option("--format <format>", "json", "json").action(async (options) => {
     const root2 = findContextProjectRoot(process.cwd())?.projectRoot;
     if (!root2)
       throw new TypeError("Run inside a Context workspace");
@@ -107523,7 +108232,7 @@ function registerVersionCommands(program2) {
     process.stdout.write(JSON.stringify(await markWorkspacePublished2(root2, options.hash, options.receipt)) + `
 `);
   });
-  command2.command("record").requiredOption("--input <file>", "YAML/JSON file or -").option("--format <format>", "json", "json").action(async (options) => {
+  command3.command("record").requiredOption("--input <file>", "YAML/JSON file or -").option("--format <format>", "json", "json").action(async (options) => {
     const root2 = findContextProjectRoot(process.cwd())?.projectRoot;
     if (!root2)
       throw new TypeError("Run inside a Context workspace");
@@ -107641,10 +108350,10 @@ init_actionInputWorkspace();
 
 // src/project/actionCompletionOutput.ts
 init_atomicWrite();
-var import_yaml41 = __toESM(require_dist(), 1);
+var import_yaml43 = __toESM(require_dist(), 1);
 import { Buffer as Buffer4 } from "node:buffer";
-import { createHash as createHash28 } from "node:crypto";
-import { join as join96 } from "node:path";
+import { createHash as createHash29 } from "node:crypto";
+import { join as join97 } from "node:path";
 var INLINE_LIMIT = 16 * 1024;
 function record4(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
@@ -107657,7 +108366,7 @@ function shortText(value, limit = 400) {
 }
 function serializeActionCompletion(value, format2) {
   return format2 === "json" ? `${JSON.stringify(value, null, 2)}
-` : import_yaml41.default.stringify(value);
+` : import_yaml43.default.stringify(value);
 }
 async function prepareActionCompletionOutput(input) {
   if (input.verbose)
@@ -107669,9 +108378,9 @@ async function prepareActionCompletionOutput(input) {
   const production = typeof result.stage_state === "string";
   if (production && Buffer4.byteLength(full) <= INLINE_LIMIT)
     return input.result;
-  const digest6 = createHash28("sha256").update(full).digest("hex");
-  const root2 = join96(input.projectRoot, ".tmp/context-runtime/action-results");
-  const resultFile = join96(root2, `${digest6}.json`);
+  const digest6 = createHash29("sha256").update(full).digest("hex");
+  const root2 = join97(input.projectRoot, ".tmp/context-runtime/action-results");
+  const resultFile = join97(root2, `${digest6}.json`);
   await atomicWriteFile(resultFile, full);
   if (production)
     return {
@@ -107681,10 +108390,10 @@ async function prepareActionCompletionOutput(input) {
       details: resultFile,
       ...pick(result, ["next", "next_preparation"])
     };
-  const next = record4(result.next) ?? record4(record4(result.workflow)?.current) ?? record4(record4(result.continuation)?.next);
-  const nextFile = next === undefined ? undefined : join96(root2, `${digest6}.next.json`);
+  const next2 = record4(result.next) ?? record4(record4(result.workflow)?.current) ?? record4(record4(result.continuation)?.next);
+  const nextFile = next2 === undefined ? undefined : join97(root2, `${digest6}.next.json`);
   if (nextFile !== undefined)
-    await atomicWriteFile(nextFile, serializeActionCompletion(next, "json"));
+    await atomicWriteFile(nextFile, serializeActionCompletion(next2, "json"));
   const outcomes = (Array.isArray(result.outcomes) ? result.outcomes : []).map(record4).filter((item) => item !== undefined);
   const counts2 = {};
   for (const item of outcomes) {
@@ -107721,12 +108430,12 @@ async function prepareActionCompletionOutput(input) {
       "task_completion",
       "pages"
     ]),
-    next_route: next === undefined ? null : {
+    next_route: next2 === undefined ? null : {
       file: nextFile,
-      digest: `sha256:${createHash28("sha256").update(serializeActionCompletion(next, "json")).digest("hex")}`,
-      ...pick(next, ["revision", "node", "availability"]),
-      commands: next.commands,
-      gate: next.gate === undefined ? undefined : pick(record4(next.gate), ["id", "resolution", "delegatable"])
+      digest: `sha256:${createHash29("sha256").update(serializeActionCompletion(next2, "json")).digest("hex")}`,
+      ...pick(next2, ["revision", "node", "availability"]),
+      commands: next2.commands,
+      gate: next2.gate === undefined ? undefined : pick(record4(next2.gate), ["id", "resolution", "delegatable"])
     },
     ...failure2 === undefined ? {} : { next_preparation: {
       outcome: failure2.outcome,
@@ -107740,7 +108449,7 @@ async function prepareActionCompletionOutput(input) {
     summary.outcomes.pop();
     summary.outcomes_omitted++;
   }
-  summary.details_required = summary.outcomes_omitted > 0 || failure2?.outcome === "failed" || outcomes.some((item) => !["accepted", "material-expanded"].includes(String(item.outcome))) || outcomes.length === 0 && result.outcome === undefined && result.workflow_summary === undefined || next === undefined && result.workflow_summary === undefined;
+  summary.details_required = summary.outcomes_omitted > 0 || failure2?.outcome === "failed" || outcomes.some((item) => !["accepted", "material-expanded"].includes(String(item.outcome))) || outcomes.length === 0 && result.outcome === undefined && result.workflow_summary === undefined || next2 === undefined && result.workflow_summary === undefined;
   return summary;
 }
 
@@ -107770,34 +108479,34 @@ init_errors3();
 init_cliFeedback();
 init_exitCode();
 init_productionFeedback();
-var import_yaml42 = __toESM(require_dist(), 1);
+var import_yaml44 = __toESM(require_dist(), 1);
 import { relative as relative24, resolve as resolve32 } from "node:path";
 async function completeCurrentProductionAction(input) {
   return withProductionFeedback({ operation: "action", file: input.submissionPath }, () => withProjectWriteLock(input.projectRoot, "production-action", async () => {
     await recoverDurableMultiFileTransactions(input.projectRoot);
     const stage = await readProductionStage(input.projectRoot);
-    const invalid = (message) => new ContextError(ExitCode.UserError, message, {
+    const invalid2 = (message) => new ContextError(ExitCode.UserError, message, {
       category: ErrorCategory.UserInputInvalid,
       reason_code: "invalid-production-submission",
       next_action: { command: "context status --format json" }
     });
     if (!stage)
-      throw invalid("The production stage expired. Read the current route; do not restore a previous process.");
+      throw invalid2("The production stage expired. Read the current route; do not restore a previous process.");
     if (input.preview)
-      throw invalid("Stage files do not use the retired Author preview. Submit the current task files.");
+      throw invalid2("Stage files do not use the retired Author preview. Submit the current task files.");
     if (!input.submissionPath || input.submissionPath === "-")
-      throw invalid("Production requires a stage-local manifest file, not stdin.");
+      throw invalid2("Production requires a stage-local manifest file, not stdin.");
     const path3 = relative24(resolve32(input.projectRoot, productionAgentDirectory(stage.id)), resolve32(input.cwd, input.submissionPath));
     const manifest = await readProductionFile({ projectRoot: input.projectRoot, stage: stage.id, path: path3 });
-    const value = import_yaml42.default.parse(manifest.text, { uniqueKeys: true });
+    const value = import_yaml44.default.parse(manifest.text, { uniqueKeys: true });
     if (!value || typeof value !== "object" || !("stage" in value) || value.stage !== stage.id) {
-      throw invalid("The manifest must identify the current production stage. No tasks were saved.");
+      throw invalid2("The manifest must identify the current production stage. No tasks were saved.");
     }
     const submission = { projectRoot: input.projectRoot, stage: stage.id, path: path3, manifest, multiAgent: input.multiAgent === true };
     if ("decision" in value)
       return approveProductionReport({ ...submission, revision: input.revision });
     if (input.revision !== stage.id)
-      throw invalid("Use the current stage revision; task input handles protect independent submissions.");
+      throw invalid2("Use the current stage revision; task input handles protect independent submissions.");
     if (!stage.planning_complete || "articles" in value)
       return submitProductionPlan(submission);
     return completeProductionSubmission(submission);
@@ -107936,7 +108645,7 @@ init_errors3();
 init_cliFeedback();
 init_exitCode();
 init_productionFeedback();
-var import_yaml43 = __toESM(require_dist(), 1);
+var import_yaml45 = __toESM(require_dist(), 1);
 import { relative as relative25, resolve as resolve33 } from "node:path";
 var productionKnownTasksSchema = productionPlanInputSchema.omit({ stage: true });
 async function prepareKnownProductionTasks(input) {
@@ -107944,29 +108653,29 @@ async function prepareKnownProductionTasks(input) {
     await recoverDurableMultiFileTransactions(input.projectRoot);
     const path3 = relative25(resolve33(input.projectRoot, ".tmp/agent-work"), resolve33(input.cwd, input.path));
     const fixed2 = await readProductionPlanningFile({ projectRoot: input.projectRoot, path: path3 });
-    const invalid = (message) => new ContextError(ExitCode.UserError, message, {
+    const invalid2 = (message) => new ContextError(ExitCode.UserError, message, {
       category: ErrorCategory.UserInputInvalid,
       reason_code: "invalid-known-production-tasks",
       file: input.path,
       input_schema: zodToJsonSchema(productionKnownTasksSchema, { $refStrategy: "none" }),
       next_action: { command: "context status --format json" }
     });
-    const plan = productionKnownTasksSchema.parse(import_yaml43.default.parse(fixed2.text, { uniqueKeys: true }));
+    const plan = productionKnownTasksSchema.parse(import_yaml45.default.parse(fixed2.text, { uniqueKeys: true }));
     const request = await productionPlanningRequest(input.projectRoot);
     let stage = await readProductionStage(input.projectRoot);
     if (!request || stage?.report_approved || (stage ? ![stage.id, request.revision].includes(input.revision) : request.revision !== input.revision)) {
-      throw invalid("Use known tasks before report approval, with the current preparation revision. Approved stages use ordinary task amendments.");
+      throw invalid2("Use known tasks before report approval, with the current preparation revision. Approved stages use ordinary task amendments.");
     }
     if (!stage) {
       await prepareCurrentProductionStage({ projectRoot: input.projectRoot, revision: input.revision });
       stage = await readProductionStage(input.projectRoot);
     }
-    const text9 = import_yaml43.default.stringify({ ...plan, stage: stage.id });
+    const text10 = import_yaml45.default.stringify({ ...plan, stage: stage.id });
     const result = await submitProductionPlan({
       projectRoot: input.projectRoot,
       stage: stage.id,
       path: fixed2.path,
-      manifest: { path: fixed2.path, text: text9, bytes: Buffer.byteLength(text9), digest: durableContentDigest(text9) }
+      manifest: { path: fixed2.path, text: text10, bytes: Buffer.byteLength(text10), digest: durableContentDigest(text10) }
     });
     return { ...result, next_action: { command: "context status --format json" } };
   }));
@@ -108083,9 +108792,9 @@ function registerProjectActionCommands(program2) {
 // src/commands/cleanClaudePluginCache.ts
 init_cliFeedback();
 import { existsSync as existsSync27 } from "node:fs";
-import { readdir as readdir21, rm as rm19 } from "node:fs/promises";
+import { readdir as readdir23, rm as rm19 } from "node:fs/promises";
 import { homedir } from "node:os";
-import { join as join97 } from "node:path";
+import { join as join98 } from "node:path";
 var ORPHAN_MARKER = ".orphaned_at";
 var CLAUDE_PLUGIN_CACHE_ROOT_ENV = "C4A_CLAUDE_PLUGIN_CACHE_ROOT";
 var CLAUDE_PLUGIN_CACHE_HOME_ENV = "C4A_CLAUDE_PLUGIN_CACHE_HOME";
@@ -108098,23 +108807,23 @@ async function cleanClaudePluginCache(opts = {}) {
     lines.push("· claude plugin cache: missing — nothing to clean");
     return { lines, removed, scanned };
   }
-  const marketplaces = await readdir21(cacheRoot, { withFileTypes: true });
+  const marketplaces = await readdir23(cacheRoot, { withFileTypes: true });
   for (const mp of marketplaces) {
     if (!mp.isDirectory())
       continue;
-    const mpDir = join97(cacheRoot, mp.name);
-    const plugins = await readdir21(mpDir, { withFileTypes: true });
+    const mpDir = join98(cacheRoot, mp.name);
+    const plugins = await readdir23(mpDir, { withFileTypes: true });
     for (const pl of plugins) {
       if (!pl.isDirectory())
         continue;
-      const plDir = join97(mpDir, pl.name);
-      const versions = await readdir21(plDir, { withFileTypes: true });
+      const plDir = join98(mpDir, pl.name);
+      const versions = await readdir23(plDir, { withFileTypes: true });
       for (const ver of versions) {
         if (!ver.isDirectory())
           continue;
         scanned += 1;
-        const verDir = join97(plDir, ver.name);
-        const markerPath = join97(verDir, ORPHAN_MARKER);
+        const verDir = join98(plDir, ver.name);
+        const markerPath = join98(verDir, ORPHAN_MARKER);
         if (!existsSync27(markerPath))
           continue;
         const label2 = `${mp.name}/${pl.name}/${ver.name}`;
@@ -108146,11 +108855,11 @@ function resolveClaudePluginCacheRoot(opts) {
   if (explicitRoot)
     return explicitRoot;
   const home = opts.home ?? process.env[CLAUDE_PLUGIN_CACHE_HOME_ENV] ?? homedir();
-  return join97(home, ".claude", "plugins", "cache");
+  return join98(home, ".claude", "plugins", "cache");
 }
 async function isEmptyDir(dir) {
   try {
-    const entries2 = await readdir21(dir);
+    const entries2 = await readdir23(dir);
     return entries2.length === 0;
   } catch {
     return false;
@@ -108178,13 +108887,13 @@ init_exitCode();
 
 // src/lib/packageVersion.ts
 import { existsSync as existsSync28, readFileSync as readFileSync9 } from "node:fs";
-import { dirname as dirname41, join as join98 } from "node:path";
+import { dirname as dirname41, join as join99 } from "node:path";
 import { fileURLToPath as fileURLToPath7 } from "node:url";
 function readPackageVersion() {
   try {
     let dir = dirname41(fileURLToPath7(import.meta.url));
     for (let depth = 0;depth < 8; depth += 1) {
-      const packagePath = join98(dir, "package.json");
+      const packagePath = join99(dir, "package.json");
       if (existsSync28(packagePath)) {
         const parsed = JSON.parse(readFileSync9(packagePath, "utf8"));
         if (typeof parsed.version === "string" && parsed.version.length > 0) {
@@ -108207,12 +108916,12 @@ function readPackageVersion() {
 
 // src/project/sourceCommands.ts
 init_src2();
-import { readFile as readFile84 } from "node:fs/promises";
+import { readFile as readFile86 } from "node:fs/promises";
 import { isAbsolute as isAbsolute22, resolve as resolve37 } from "node:path";
 init_cliFeedback();
 init_errors3();
 init_exitCode();
-var import_yaml47 = __toESM(require_dist(), 1);
+var import_yaml49 = __toESM(require_dist(), 1);
 
 // src/project/repoSourceRecovery.ts
 init_cliFeedback();
@@ -108220,7 +108929,7 @@ init_errors3();
 init_exitCode();
 import { execFile as execFile10 } from "node:child_process";
 import { existsSync as existsSync29 } from "node:fs";
-import { lstat as lstat10, mkdir as mkdir32, 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 rm20, 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();
@@ -108404,7 +109113,7 @@ async function cloneCheckout(input) {
       next: `Use local mode with path ${JSON.stringify(target)} after inspecting the existing checkout.`
     });
   }
-  await mkdir32(dirname42(target), { recursive: true });
+  await mkdir33(dirname42(target), { recursive: true });
   const cloneArgs = ["clone", "--no-checkout", "--depth=1", "--filter=blob:none", input.remote, target];
   try {
     await execFileAsync6("git", cloneArgs, { encoding: "utf8", maxBuffer: 4 * 1024 * 1024 });
@@ -108450,7 +109159,7 @@ async function bindLocalAlias(input) {
     return;
   const projectRoot = await realpath8(input.projectRoot);
   const alias = resolve34(projectRoot, input.declaredLocal);
-  const stats = await lstat10(alias).catch(() => null);
+  const stats = await lstat11(alias).catch(() => null);
   if (stats !== null) {
     if (stats.isSymbolicLink()) {
       const actual = resolve34(dirname42(alias), await readlink2(alias));
@@ -108469,7 +109178,7 @@ async function bindLocalAlias(input) {
       });
     }
   }
-  await mkdir32(dirname42(alias), { recursive: true });
+  await mkdir33(dirname42(alias), { recursive: true });
   await symlink3(relative26(dirname42(alias), input.checkout) || ".", alias);
 }
 function selectPhysicalGroup(sources, selector) {
@@ -108559,11 +109268,11 @@ async function restoreRepositorySources(input) {
 // src/project/sourceDocumentStatus.ts
 init_src2();
 import { existsSync as existsSync30 } from "node:fs";
-import { readFile as readFile77 } from "node:fs/promises";
-import { join as join100 } from "node:path";
+import { readFile as readFile79 } from "node:fs/promises";
+import { join as join101 } from "node:path";
 // src/project/sourceCommandViews.ts
-import { readFile as readFile76 } from "node:fs/promises";
-import { join as join99 } from "node:path";
+import { readFile as readFile78 } from "node:fs/promises";
+import { join as join100 } from "node:path";
 init_workspace();
 init_documentBatchManifest();
 function repoSourceAgentView(source2) {
@@ -108626,7 +109335,7 @@ async function fileSourceAgentViewWithNextAction(input) {
   };
 }
 function documentSourceManifestPath(source2) {
-  return source2.snapshot?.manifest ?? join99(source2.materializedAt, "manifest.json");
+  return source2.snapshot?.manifest ?? join100(source2.materializedAt, "manifest.json");
 }
 async function fileSourceDocumentSiteHint(input) {
   const detection = await detectDocumentSiteFiles({
@@ -108636,7 +109345,7 @@ async function fileSourceDocumentSiteHint(input) {
   let snapshotConfigured = false;
   const manifest = documentSourceManifestPath(input.source);
   try {
-    const parsed = parseDocumentSnapshotForSource(JSON.parse(await readFile76(join99(input.projectRoot, manifest), "utf8")), input.source.name);
+    const parsed = parseDocumentSnapshotForSource(JSON.parse(await readFile78(join100(input.projectRoot, manifest), "utf8")), input.source.name);
     snapshotConfigured = manifestUsesMdxJsonDocs(parsed);
   } catch {
     snapshotConfigured = false;
@@ -108668,11 +109377,11 @@ async function larkSourceAgentViewWithNextAction(input) {
 // src/project/sourceDocumentStatus.ts
 init_documentBatchManifest();
 function documentSourceManifestPath2(source2) {
-  return source2.snapshot?.manifest ?? join100(source2.materializedAt, "manifest.json");
+  return source2.snapshot?.manifest ?? join101(source2.materializedAt, "manifest.json");
 }
 async function documentSnapshotState(input) {
   const manifest = documentSourceManifestPath2(input.source);
-  const manifestPath = join100(input.projectRoot, manifest);
+  const manifestPath = join101(input.projectRoot, manifest);
   if (!existsSync30(manifestPath)) {
     return {
       snapshotReady: false,
@@ -108683,7 +109392,7 @@ async function documentSnapshotState(input) {
     };
   }
   try {
-    const parsed = findDocumentSnapshotForSource(JSON.parse(await readFile77(manifestPath, "utf8")), input.source.name);
+    const parsed = findDocumentSnapshotForSource(JSON.parse(await readFile79(manifestPath, "utf8")), input.source.name);
     if (parsed === null) {
       return {
         snapshotReady: false,
@@ -108751,7 +109460,7 @@ async function documentSnapshotState(input) {
     const missing = [
       ...parsed.files.map((file) => file.path),
       ...(parsed.assets ?? []).filter((asset) => asset.content_hash !== undefined).map((asset) => asset.path)
-    ].find((path3) => !existsSync30(join100(input.projectRoot, input.source.materializedAt, path3)));
+    ].find((path3) => !existsSync30(join101(input.projectRoot, input.source.materializedAt, path3)));
     if (missing !== undefined) {
       return {
         snapshotReady: false,
@@ -108850,10 +109559,10 @@ init_atomicWrite();
 init_cliFeedback();
 init_errors3();
 init_exitCode();
-var import_yaml44 = __toESM(require_dist(), 1);
-import { createHash as createHash29 } from "node:crypto";
-import { readFile as readFile78, realpath as realpath9 } from "node:fs/promises";
-import { basename as basename12, extname as extname15, isAbsolute as isAbsolute20, join as join101, relative as relative27, resolve as resolve35 } from "node:path";
+var import_yaml46 = __toESM(require_dist(), 1);
+import { createHash as createHash30 } from "node:crypto";
+import { readFile as readFile80, realpath as realpath9 } from "node:fs/promises";
+import { basename as basename12, extname as extname15, isAbsolute as isAbsolute20, join as join102, relative as relative27, resolve as resolve35 } from "node:path";
 init_writeLock();
 var SOURCE_NAME_PATTERN3 = /^[a-z0-9][a-z0-9._-]*$/u;
 function isDateSourceNamespace(value) {
@@ -108882,7 +109591,7 @@ function defaultLarkModule(input) {
     if (titleSlug.length > 0)
       return titleSlug;
   }
-  const opaqueSlug = (kind, identity) => `${kind}-${createHash29("sha256").update(identity).digest("hex").slice(0, 12)}`;
+  const opaqueSlug = (kind, identity) => `${kind}-${createHash30("sha256").update(identity).digest("hex").slice(0, 12)}`;
   if (input.url !== undefined) {
     try {
       const parsed = new URL(input.url);
@@ -108949,8 +109658,8 @@ function assertSafeFileInclude(value) {
 }
 async function readRegistryDocument(projectRoot, registryPath2) {
   try {
-    const content3 = await readFile78(join101(projectRoot, registryPath2), "utf8");
-    return content3.trim().length === 0 ? { sources: [] } : import_yaml44.default.parse(content3);
+    const content3 = await readFile80(join102(projectRoot, registryPath2), "utf8");
+    return content3.trim().length === 0 ? { sources: [] } : import_yaml46.default.parse(content3);
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT")
       return { sources: [] };
@@ -109067,7 +109776,7 @@ async function addFileSourceUnlocked(input) {
     const record6 = entry2;
     return record6.name !== input.name && record6.id !== input.name;
   }), nextEntry];
-  await atomicWriteFile(join101(input.projectRoot, DEFAULT_FILE_SOURCES_REGISTRY_PATH), import_yaml44.default.stringify({ sources: nextSources }));
+  await atomicWriteFile(join102(input.projectRoot, DEFAULT_FILE_SOURCES_REGISTRY_PATH), import_yaml46.default.stringify({ sources: nextSources }));
   const updated = await loadSourcesRegistry({ rootDir: input.projectRoot });
   const entry = updated.files.find((source2) => source2.name === input.name || source2.id === input.name);
   if (entry === undefined) {
@@ -109123,7 +109832,7 @@ async function addLarkSourceUnlocked(input) {
     const record6 = entry2;
     return record6.name !== input.name && record6.id !== input.name;
   }), nextEntry];
-  await atomicWriteFile(join101(input.projectRoot, DEFAULT_LARK_SOURCES_REGISTRY_PATH), import_yaml44.default.stringify({ sources: nextSources }));
+  await atomicWriteFile(join102(input.projectRoot, DEFAULT_LARK_SOURCES_REGISTRY_PATH), import_yaml46.default.stringify({ sources: nextSources }));
   const updated = await loadSourcesRegistry({ rootDir: input.projectRoot });
   const entry = updated.larks.find((source2) => source2.name === input.name || source2.id === input.name);
   if (entry === undefined) {
@@ -109323,11 +110032,11 @@ init_candidateLedger();
 init_documentBatchManifest();
 init_workspace();
 init_writeLock();
-var import_yaml45 = __toESM(require_dist(), 1);
+var import_yaml47 = __toESM(require_dist(), 1);
 import { existsSync as existsSync31 } from "node:fs";
-import { createHash as createHash30 } from "node:crypto";
-import { readFile as readFile79, readdir as readdir22, rm as rm21 } from "node:fs/promises";
-import { isAbsolute as isAbsolute21, join as join102, relative as relative28, resolve as resolve36, sep as sep8 } from "node:path";
+import { createHash as createHash31 } from "node:crypto";
+import { readFile as readFile81, readdir as readdir24, rm as rm21 } 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")
     return;
@@ -109359,10 +110068,10 @@ function collectStrings(value, output) {
   }
 }
 async function yamlReferences(input) {
-  const absolutePath = join102(input.projectRoot, input.path);
+  const absolutePath = join103(input.projectRoot, input.path);
   if (!existsSync31(absolutePath))
     return false;
-  const parsed = import_yaml45.default.parse(await readFile79(absolutePath, "utf8"));
+  const parsed = import_yaml47.default.parse(await readFile81(absolutePath, "utf8"));
   const strings = [];
   collectStrings(parsed, strings);
   return strings.some((value) => stringReferencesSource(value, input.source));
@@ -109488,11 +110197,11 @@ async function registryRemovalWrite(projectRoot, source2) {
   const path3 = registryPath2(source2.type);
   if (path3 === null)
     return;
-  const absolutePath = join102(projectRoot, path3);
-  const document4 = existsSync31(absolutePath) ? import_yaml45.default.parse(await readFile79(absolutePath, "utf8")) : { sources: [] };
+  const absolutePath = join103(projectRoot, path3);
+  const document4 = existsSync31(absolutePath) ? import_yaml47.default.parse(await readFile81(absolutePath, "utf8")) : { sources: [] };
   return {
     path: absolutePath,
-    bytes: import_yaml45.default.stringify(removeDocumentEntry(document4, source2))
+    bytes: import_yaml47.default.stringify(removeDocumentEntry(document4, source2))
   };
 }
 function safeManagedMaterializedPath(projectRoot, source2) {
@@ -109507,7 +110216,7 @@ function safeManagedMaterializedPath(projectRoot, source2) {
   return absolute;
 }
 function safeManagedManifestPath(projectRoot, source2) {
-  const manifest = source2.manifest ?? join102(source2.materializedAt, "manifest.json");
+  const manifest = source2.manifest ?? join103(source2.materializedAt, "manifest.json");
   if (isAbsolute21(manifest))
     throw unsafeOwnership(source2, manifest);
   const absolute = resolve36(projectRoot, manifest);
@@ -109542,7 +110251,7 @@ function projectRelative(projectRoot, path3) {
   return relative28(projectRoot, path3).split(sep8).join("/");
 }
 function digest6(value) {
-  return `sha256:${createHash30("sha256").update(JSON.stringify(value)).digest("hex")}`;
+  return `sha256:${createHash31("sha256").update(JSON.stringify(value)).digest("hex")}`;
 }
 async function sharedMaterializedOwners(projectRoot, source2) {
   const target = safeManagedMaterializedPath(projectRoot, source2);
@@ -109636,12 +110345,12 @@ async function createRemovalPlan(projectRoot, selector) {
     source: source2,
     registry: registryPath2(source2.type),
     registryBytes: registryWrite?.bytes ?? null,
-    managedBytes: source2.type === "note" || source2.type === "sessions" ? await readFile79(absoluteRemovals[0], "utf8") : null,
+    managedBytes: source2.type === "note" || source2.type === "sessions" ? await readFile81(absoluteRemovals[0], "utf8") : null,
     references,
     cleanup,
     manifestBytes: manifestWrite?.bytes ?? null
   });
-  const next = references.length > 0 ? `Remove all listed references, then preview context source remove '${source2.id}' --format json again.` : `context source remove '${source2.id}' --yes --plan-digest '${planDigest}' --format json`;
+  const next2 = references.length > 0 ? `Remove all listed references, then preview context source remove '${source2.id}' --format json again.` : `context source remove '${source2.id}' --yes --plan-digest '${planDigest}' --format json`;
   return {
     action: "preview",
     source: source2,
@@ -109650,7 +110359,7 @@ async function createRemovalPlan(projectRoot, selector) {
     references,
     plan_digest: planDigest,
     cleanup,
-    next,
+    next: next2,
     ...registryWrite === undefined ? {} : { registryWrite },
     ...manifestWrite !== undefined ? { manifestWrite } : {},
     absoluteRemovals: [...new Set(absoluteRemovals)].sort()
@@ -109669,12 +110378,12 @@ function publicRemovalResult(plan, action) {
   };
 }
 async function pruneExtractRuntime(projectRoot, source2) {
-  const fingerprintPath = join102(projectRoot, ".tmp/context-runtime/extract/source-fingerprints.json");
+  const fingerprintPath = join103(projectRoot, ".tmp/context-runtime/extract/source-fingerprints.json");
   const removedPhaseIds = new Set;
   if (existsSync31(fingerprintPath)) {
-    const parsed = JSON.parse(await readFile79(fingerprintPath, "utf8"));
+    const parsed = JSON.parse(await readFile81(fingerprintPath, "utf8"));
     const phases = parsed.phases ?? {};
-    const next = Object.fromEntries(Object.entries(phases).filter(([phaseId, raw]) => {
+    const next2 = Object.fromEntries(Object.entries(phases).filter(([phaseId, raw]) => {
       if (raw === null || typeof raw !== "object" || Array.isArray(raw))
         return true;
       const sources = raw.sources;
@@ -109683,30 +110392,30 @@ async function pruneExtractRuntime(projectRoot, source2) {
         removedPhaseIds.add(phaseId);
       return keep;
     }));
-    await atomicWriteFile(fingerprintPath, `${JSON.stringify({ ...parsed, phases: next }, null, 2)}
+    await atomicWriteFile(fingerprintPath, `${JSON.stringify({ ...parsed, phases: next2 }, null, 2)}
 `);
   }
-  const phaseOwnershipPath = join102(projectRoot, ".tmp/context-runtime/extract/custom-phase-candidates.json");
+  const phaseOwnershipPath = join103(projectRoot, ".tmp/context-runtime/extract/custom-phase-candidates.json");
   if (existsSync31(phaseOwnershipPath) && removedPhaseIds.size > 0) {
-    const parsed = JSON.parse(await readFile79(phaseOwnershipPath, "utf8"));
+    const parsed = JSON.parse(await readFile81(phaseOwnershipPath, "utf8"));
     const phases = Object.fromEntries(Object.entries(parsed.phases ?? {}).filter(([phaseId]) => !removedPhaseIds.has(phaseId)));
     await atomicWriteFile(phaseOwnershipPath, `${JSON.stringify({ ...parsed, phases }, null, 2)}
 `);
   }
-  const symbolPath = join102(projectRoot, ".tmp/context-runtime/extract/source-symbols.json");
+  const symbolPath = join103(projectRoot, ".tmp/context-runtime/extract/source-symbols.json");
   if (existsSync31(symbolPath)) {
-    const parsed = JSON.parse(await readFile79(symbolPath, "utf8"));
+    const parsed = JSON.parse(await readFile81(symbolPath, "utf8"));
     const symbols = Array.isArray(parsed.symbols) ? parsed.symbols.filter((entry) => entry === null || typeof entry !== "object" || Array.isArray(entry) || entry.source !== source2.name) : [];
     const phaseFingerprints = Object.fromEntries(Object.entries(parsed.phaseFingerprints ?? {}).filter(([phaseId]) => !removedPhaseIds.has(phaseId)));
     await atomicWriteFile(symbolPath, `${JSON.stringify({ ...parsed, phaseFingerprints, symbols }, null, 2)}
 `);
   }
-  const snapshotRoot = join102(projectRoot, ".tmp/context-runtime/extract/candidates");
+  const snapshotRoot = join103(projectRoot, ".tmp/context-runtime/extract/candidates");
   const visit4 = async (directory) => {
     if (!existsSync31(directory))
       return;
-    for (const entry of await readdir22(directory, { withFileTypes: true })) {
-      const path3 = join102(directory, entry.name);
+    for (const entry of await readdir24(directory, { withFileTypes: true })) {
+      const path3 = join103(directory, entry.name);
       if (entry.isDirectory()) {
         await visit4(path3);
         continue;
@@ -109714,7 +110423,7 @@ async function pruneExtractRuntime(projectRoot, source2) {
       if (!entry.isFile() || !entry.name.endsWith(".json"))
         continue;
       try {
-        const parsed = JSON.parse(await readFile79(path3, "utf8"));
+        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 });
@@ -109756,7 +110465,7 @@ async function removeProjectSource(input) {
       });
     }
     await applyAtomicFileBatch({
-      transactionRoot: join102(input.projectRoot, ".tmp", "context-runtime", "source-remove-transactions"),
+      transactionRoot: join103(input.projectRoot, ".tmp", "context-runtime", "source-remove-transactions"),
       writes: [...plan.registryWrite === undefined ? [] : [plan.registryWrite], ...plan.manifestWrite !== undefined ? [plan.manifestWrite] : []],
       removals: plan.absoluteRemovals
     });
@@ -109772,11 +110481,11 @@ init_workspace();
 init_writeLock();
 init_durableMultiFileTransaction();
 init_durableSingleFileTransaction();
-import { readFile as readFile80 } from "node:fs/promises";
+import { readFile as readFile82 } from "node:fs/promises";
 import ts from "typescript";
-function generateSourceConfiguration(text9, selected) {
-  const file = ts.createSourceFile("index.ts", text9, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
-  if (ts.transpileModule(text9, { reportDiagnostics: true }).diagnostics?.some((item) => item.category === ts.DiagnosticCategory.Error))
+function generateSourceConfiguration(text10, selected) {
+  const file = ts.createSourceFile("index.ts", text10, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+  if (ts.transpileModule(text10, { reportDiagnostics: true }).diagnostics?.some((item) => item.category === ts.DiagnosticCategory.Error))
     return;
   const imports = file.statements.filter(ts.isImportDeclaration).filter((node3) => ts.isStringLiteral(node3.moduleSpecifier) && node3.moduleSpecifier.text === "@c4a/context");
   if (imports.length !== 1)
@@ -109887,7 +110596,7 @@ function generateSourceConfiguration(text9, selected) {
     }
   }
   if (!additions.length && !captures.length)
-    return text9;
+    return text10;
   const identifiers = new Set;
   const visit4 = (node3) => {
     if (ts.isIdentifier(node3))
@@ -109907,12 +110616,12 @@ function generateSourceConfiguration(text9, selected) {
     }
   if (needed.size)
     edits.push({ start: bindings.getStart(file) + 1, end: bindings.getStart(file) + 1, value: ` ${[...needed].join(", ")},` });
-  return edits.sort((a, b) => b.start - a.start).reduce((result, edit) => result.slice(0, edit.start) + edit.value + result.slice(edit.end), text9);
+  return edits.sort((a, b) => b.start - a.start).reduce((result, edit) => result.slice(0, edit.start) + edit.value + result.slice(edit.end), text10);
 }
 async function configureRegisteredSources(projectRoot, selected) {
   return withProjectWriteLock(projectRoot, "source-project-configuration", async () => {
     const path3 = "src/index.ts";
-    const config = JSON.parse(await readFile80(await safeProjectTarget(projectRoot, "package.json"), "utf8"));
+    const config = JSON.parse(await readFile82(await safeProjectTarget(projectRoot, "package.json"), "utf8"));
     if (config.context?.entry !== path3)
       return {
         status: "manual",
@@ -109921,8 +110630,8 @@ async function configureRegisteredSources(projectRoot, selected) {
         sources: selected
       };
     const target = await safeProjectTarget(projectRoot, path3);
-    const text9 = await readFile80(target, "utf8");
-    const updated = generateSourceConfiguration(text9, selected);
+    const text10 = await readFile82(target, "utf8");
+    const updated = generateSourceConfiguration(text10, selected);
     if (updated === undefined)
       return {
         status: "manual",
@@ -109930,15 +110639,15 @@ async function configureRegisteredSources(projectRoot, selected) {
         message: "Registration is saved. Preserve the custom project entry and configure only these sources manually.",
         sources: selected
       };
-    if (updated !== text9)
+    if (updated !== text10)
       await runDurableSingleFileTransaction({
         projectRoot,
         kind: "source-project-configuration",
         target_path: path3,
-        expected_base_digest: durableContentDigest(text9),
+        expected_base_digest: durableContentDigest(text10),
         target_content: updated
       });
-    return { status: updated === text9 ? "unchanged" : "configured", file: path3 };
+    return { status: updated === text10 ? "unchanged" : "configured", file: path3 };
   });
 }
 
@@ -110001,7 +110710,7 @@ async function readIncludeList(projectRoot, path3) {
   }
   let content3;
   try {
-    content3 = await readFile84(isAbsolute22(trimmed) ? resolve37(trimmed) : resolve37(projectRoot, trimmed), "utf8");
+    content3 = await readFile86(isAbsolute22(trimmed) ? resolve37(trimmed) : resolve37(projectRoot, trimmed), "utf8");
   } catch (error) {
     throw new ContextError(ExitCode.UserError, `cannot read include list: ${trimmed}`, {
       category: ErrorCategory.UserInputInvalid,
@@ -110042,7 +110751,7 @@ function rowsFromValue(value) {
     return value.map((item) => item && typeof item === "object" && !Array.isArray(item) ? item : { value: item });
   }
   if (value && typeof value === "object") {
-    return Object.entries(value).map(([key, next]) => ({ key, value: next }));
+    return Object.entries(value).map(([key, next2]) => ({ key, value: next2 }));
   }
   return [{ value }];
 }
@@ -110069,7 +110778,7 @@ function writeFormatted(value, format2) {
     return;
   }
   if (format2 === "yaml") {
-    process.stdout.write(import_yaml47.default.stringify(value));
+    process.stdout.write(import_yaml49.default.stringify(value));
     return;
   }
   process.stdout.write(renderTable2(value));
@@ -110390,16 +111099,16 @@ report shown above. A direct maintenance call outside that Route may omit it.
 init_cliFeedback();
 init_errors3();
 init_exitCode();
-var import_yaml49 = __toESM(require_dist(), 1);
+var import_yaml51 = __toESM(require_dist(), 1);
 
 // src/project/productionSkillCatalog.ts
 init_errors3();
 init_cliFeedback();
 init_exitCode();
-var import_yaml48 = __toESM(require_dist(), 1);
+var import_yaml50 = __toESM(require_dist(), 1);
 import { constants as constants6, existsSync as existsSync32 } from "node:fs";
-import { lstat as lstat11, open as open5, readdir as readdir23 } from "node:fs/promises";
-import { dirname as dirname43, join as join104, resolve as resolve38 } from "node:path";
+import { lstat as lstat12, open as open5, readdir as readdir25 } from "node:fs/promises";
+import { dirname as dirname43, join as join105, resolve as resolve38 } from "node:path";
 import { fileURLToPath as fileURLToPath8 } from "node:url";
 function bundledSkillRoot() {
   const directory = dirname43(fileURLToPath8(import.meta.url));
@@ -110426,11 +111135,11 @@ async function listProductionSkills(root2) {
   }
 }
 async function readProductionSkills(root2) {
-  const entries2 = (await readdir23(root2, { withFileTypes: true })).filter((entry) => entry.isDirectory()).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
+  const entries2 = (await readdir25(root2, { withFileTypes: true })).filter((entry) => entry.isDirectory()).sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0);
   const skills = [];
   for (const directory of entries2) {
-    const entry = join104(root2, directory.name, "SKILL.md");
-    if (!(await lstat11(entry)).isFile())
+    const entry = join105(root2, directory.name, "SKILL.md");
+    if (!(await lstat12(entry)).isFile())
       throw new TypeError(`Skill entry must be a regular file: ${entry}`);
     const handle2 = await open5(entry, constants6.O_RDONLY | constants6.O_NOFOLLOW | constants6.O_NONBLOCK);
     let header;
@@ -110446,7 +111155,7 @@ async function readProductionSkills(root2) {
     const frontmatter2 = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u.exec(header);
     if (!frontmatter2)
       throw new TypeError(`Skill entry needs complete frontmatter within 64 KiB: ${entry}`);
-    const value = import_yaml48.default.parse(frontmatter2[1], { uniqueKeys: true });
+    const value = import_yaml50.default.parse(frontmatter2[1], { uniqueKeys: true });
     if (!value || typeof value !== "object" || !("name" in value) || typeof value.name !== "string" || !value.name.trim() || !("description" in value) || typeof value.description !== "string" || !value.description.trim()) {
       throw new TypeError(`Skill entry needs a name and description: ${entry}`);
     }
@@ -110509,7 +111218,7 @@ function outputFormat2(options) {
 }
 function writeOutput(value, format2) {
   process.stdout.write(format2 === "json" ? `${JSON.stringify(value, null, 2)}
-` : import_yaml49.default.stringify(value));
+` : import_yaml51.default.stringify(value));
 }
 function registerProjectIndexerCommands(program2) {
   const indexer = program2.command("indexer").description("Discover bundled skills or inspect a benchmark result");
@@ -110593,7 +111302,7 @@ function initCommand2(input, projectDir) {
   return args.map(shellQuote7).join(" ");
 }
 function readyResult(input, projectRoot, relocation) {
-  const command2 = workflowCommand(input);
+  const command3 = workflowCommand(input);
   return {
     schema: "context.entry.v1",
     guidance: {
@@ -110610,7 +111319,7 @@ function readyResult(input, projectRoot, relocation) {
     },
     next_action: {
       kind: relocation ? "enter-workspace" : "evaluate-workflow",
-      command: relocation ? `cd ${shellQuote7(projectRoot)} && ${command2}` : command2,
+      command: relocation ? `cd ${shellQuote7(projectRoot)} && ${command3}` : command3,
       effect: "read",
       confirmation: "not-required"
     }
@@ -110837,7 +111546,7 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 import { existsSync as existsSync35 } from "node:fs";
-import { dirname as dirname46, join as join106, resolve as resolve40 } from "node:path";
+import { dirname as dirname46, join as join107, resolve as resolve40 } from "node:path";
 import { fileURLToPath as fileURLToPath9 } from "node:url";
 
 // src/project/pluginInstallTargets.ts
@@ -110846,9 +111555,9 @@ 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 mkdir33, readdir as readdir24, readFile as readFile85, rename as rename7, 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 rm22, writeFile as writeFile25 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
-import { dirname as dirname45, join as join105 } from "node:path";
+import { dirname as dirname45, join as join106 } from "node:path";
 import { promisify as promisify11 } from "node:util";
 var execFileAsync7 = promisify11(execFile11);
 var MARKETPLACE_NAME = "c4a";
@@ -110864,31 +111573,31 @@ var CURSOR_PLUGIN_ROOT_ENV = "CONTEXT_CURSOR_PLUGIN_ROOT";
 function shellQuote8(value) {
   return `'${value.replace(/'/g, "'\\''")}'`;
 }
-function commandLine(command2, args) {
-  return [command2, ...args.map((arg) => shellQuote8(arg))].join(" ");
+function commandLine(command3, args) {
+  return [command3, ...args.map((arg) => shellQuote8(arg))].join(" ");
 }
-async function runExternal(command2, args) {
+async function runExternal(command3, args) {
   try {
-    await execFileAsync7(command2, args, {
+    await execFileAsync7(command3, args, {
       maxBuffer: 1024 * 1024
     });
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
-    throw new ContextError(ExitCode.ExternalToolError, `${commandLine(command2, args)} failed: ${message}`, {
+    throw new ContextError(ExitCode.ExternalToolError, `${commandLine(command3, args)} failed: ${message}`, {
       category: ErrorCategory.ExternalToolFailed
     });
   }
 }
-async function runExternalOptional(command2, args) {
+async function runExternalOptional(command3, args) {
   try {
-    await runExternal(command2, args);
+    await runExternal(command3, args);
     return true;
   } catch {
     return false;
   }
 }
-async function commandAvailable(command2) {
-  return runExternalOptional("sh", ["-lc", `command -v ${command2} >/dev/null 2>&1`]);
+async function commandAvailable(command3) {
+  return runExternalOptional("sh", ["-lc", `command -v ${command3} >/dev/null 2>&1`]);
 }
 async function claudePluginInstalled(pluginId) {
   try {
@@ -110902,23 +111611,23 @@ async function claudePluginInstalled(pluginId) {
   }
 }
 function codexHome() {
-  return process.env.CODEX_HOME?.trim() || join105(homedir2(), ".codex");
+  return process.env.CODEX_HOME?.trim() || join106(homedir2(), ".codex");
 }
 function claudePluginCacheRoot() {
   const explicitRoot = process.env[CLAUDE_PLUGIN_CACHE_ROOT_ENV2]?.trim();
   if (explicitRoot)
     return explicitRoot;
   const home = process.env[CLAUDE_PLUGIN_CACHE_HOME_ENV2]?.trim() || homedir2();
-  return join105(home, ".claude", "plugins", "cache");
+  return join106(home, ".claude", "plugins", "cache");
 }
 function sharedSkillsRoot() {
-  return process.env[SHARED_SKILLS_ROOT_ENV]?.trim() || join105(homedir2(), ".agents", "skills");
+  return process.env[SHARED_SKILLS_ROOT_ENV]?.trim() || join106(homedir2(), ".agents", "skills");
 }
 function claudeSkillsRoot() {
-  return process.env[CLAUDE_SKILLS_ROOT_ENV]?.trim() || join105(homedir2(), ".claude", "skills");
+  return process.env[CLAUDE_SKILLS_ROOT_ENV]?.trim() || join106(homedir2(), ".claude", "skills");
 }
 function cursorPluginRoot() {
-  return process.env[CURSOR_PLUGIN_ROOT_ENV]?.trim() || join105(homedir2(), ".cursor", "plugins", "local", PLUGIN_NAME);
+  return process.env[CURSOR_PLUGIN_ROOT_ENV]?.trim() || join106(homedir2(), ".cursor", "plugins", "local", PLUGIN_NAME);
 }
 function blockHeader(line) {
   const match = line.match(/^\s*\[([^\]]+)\]\s*$/u);
@@ -110929,9 +111638,9 @@ function isStaleMarketplaceBlock(header, block) {
     return true;
   if (header !== `marketplaces.${MARKETPLACE_NAME}`)
     return false;
-  const text9 = block.join(`
+  const text10 = block.join(`
 `);
-  return text9.includes('source_type = "local"') || text9.includes("/c4a-plugins") || text9.includes("context4ai/context");
+  return text10.includes('source_type = "local"') || text10.includes("/c4a-plugins") || text10.includes("context4ai/context");
 }
 function isStalePluginBlock(header) {
   return header === `plugins."context@context"` || header === `plugins."context@c4a"` || header === "plugins.context";
@@ -110969,27 +111678,27 @@ function pruneLegacyCodexConfigContent(content3) {
 `), removed };
 }
 async function pruneLegacyCodexConfig(dryRun, steps) {
-  const configPath = join105(codexHome(), "config.toml");
-  const current2 = await readFile85(configPath, "utf8").catch(() => "");
+  const configPath = join106(codexHome(), "config.toml");
+  const current2 = await readFile87(configPath, "utf8").catch(() => "");
   if (!current2)
     return;
-  const next = pruneLegacyCodexConfigContent(current2);
-  if (next.removed.length === 0)
+  const next2 = pruneLegacyCodexConfigContent(current2);
+  if (next2.removed.length === 0)
     return;
   steps.push({
     agent: "codex",
-    command: `prune stale Codex config blocks: ${next.removed.join(", ")}`,
+    command: `prune stale Codex config blocks: ${next2.removed.join(", ")}`,
     status: dryRun ? "planned" : "ran"
   });
   if (!dryRun) {
-    await writeFile25(configPath, next.content, "utf8");
+    await writeFile25(configPath, next2.content, "utf8");
   }
 }
 async function pruneCodexPluginCacheForName(pluginName, keepVersion, dryRun, steps) {
-  const cacheRoot = join105(codexHome(), "plugins", "cache", MARKETPLACE_NAME, pluginName);
+  const cacheRoot = join106(codexHome(), "plugins", "cache", MARKETPLACE_NAME, pluginName);
   if (!existsSync34(cacheRoot))
     return;
-  const versions = (await readdir24(cacheRoot, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory() && entry.name !== keepVersion).map((entry) => entry.name).sort();
+  const versions = (await readdir26(cacheRoot, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory() && entry.name !== keepVersion).map((entry) => entry.name).sort();
   if (versions.length === 0)
     return;
   steps.push({
@@ -110998,7 +111707,7 @@ async function pruneCodexPluginCacheForName(pluginName, keepVersion, dryRun, ste
     status: dryRun ? "planned" : "ran"
   });
   if (!dryRun)
-    await Promise.all(versions.map((version3) => rm22(join105(cacheRoot, version3), { recursive: true, force: true })));
+    await Promise.all(versions.map((version3) => rm22(join106(cacheRoot, version3), { recursive: true, force: true })));
 }
 async function pruneCodexPluginCache(currentVersion, dryRun, steps) {
   await pruneCodexPluginCacheForName(PLUGIN_NAME, currentVersion, dryRun, steps);
@@ -111008,7 +111717,7 @@ async function pruneCodexPluginCache(currentVersion, dryRun, steps) {
 }
 async function isEmptyDir2(dir) {
   try {
-    return (await readdir24(dir)).length === 0;
+    return (await readdir26(dir)).length === 0;
   } catch {
     return false;
   }
@@ -111018,19 +111727,19 @@ async function pruneClaudeOrphanContextCache(dryRun, steps) {
   if (!existsSync34(cacheRoot))
     return;
   const removed = [];
-  const marketplaces = await readdir24(cacheRoot, { withFileTypes: true }).catch(() => []);
+  const marketplaces = await readdir26(cacheRoot, { withFileTypes: true }).catch(() => []);
   for (const marketplace of marketplaces) {
     if (!marketplace.isDirectory())
       continue;
-    const pluginDir = join105(cacheRoot, marketplace.name, PLUGIN_NAME);
+    const pluginDir = join106(cacheRoot, marketplace.name, PLUGIN_NAME);
     if (!existsSync34(pluginDir))
       continue;
-    const versions = await readdir24(pluginDir, { withFileTypes: true }).catch(() => []);
+    const versions = await readdir26(pluginDir, { withFileTypes: true }).catch(() => []);
     for (const version3 of versions) {
       if (!version3.isDirectory())
         continue;
-      const versionDir = join105(pluginDir, version3.name);
-      if (!existsSync34(join105(versionDir, ORPHAN_MARKER2)))
+      const versionDir = join106(pluginDir, version3.name);
+      if (!existsSync34(join106(versionDir, ORPHAN_MARKER2)))
         continue;
       removed.push(`${marketplace.name}/${PLUGIN_NAME}/${version3.name}`);
       if (!dryRun) {
@@ -111040,7 +111749,7 @@ async function pruneClaudeOrphanContextCache(dryRun, steps) {
     if (!dryRun && await isEmptyDir2(pluginDir)) {
       await rm22(pluginDir, { recursive: true, force: true });
     }
-    const marketplaceDir = join105(cacheRoot, marketplace.name);
+    const marketplaceDir = join106(cacheRoot, marketplace.name);
     if (!dryRun && await isEmptyDir2(marketplaceDir)) {
       await rm22(marketplaceDir, { recursive: true, force: true });
     }
@@ -111061,7 +111770,7 @@ async function pruneClaudeLegacyPluginCache(dryRun, steps) {
     return;
   const removed = [];
   for (const pluginName of LEGACY_PLUGIN_NAMES) {
-    const pluginDir = join105(cacheRoot, MARKETPLACE_NAME, pluginName);
+    const pluginDir = join106(cacheRoot, MARKETPLACE_NAME, pluginName);
     if (!existsSync34(pluginDir))
       continue;
     removed.push(`${MARKETPLACE_NAME}/${pluginName}`);
@@ -111078,12 +111787,12 @@ async function pruneClaudeLegacyPluginCache(dryRun, steps) {
   }
 }
 async function pruneClaudeSupersededContextCache(root2, dryRun, steps) {
-  const manifest = await readFile85(join105(root2, "claude", ".claude-plugin", "plugin.json"), "utf8").then((content3) => JSON.parse(content3)).catch(() => null);
+  const manifest = await readFile87(join106(root2, "claude", ".claude-plugin", "plugin.json"), "utf8").then((content3) => JSON.parse(content3)).catch(() => null);
   const currentVersion = typeof manifest?.version === "string" ? manifest.version : null;
   if (!currentVersion)
     return;
-  const pluginDir = join105(claudePluginCacheRoot(), MARKETPLACE_NAME, PLUGIN_NAME);
-  const staleVersions = (await readdir24(pluginDir, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory() && entry.name !== currentVersion).map((entry) => entry.name);
+  const pluginDir = join106(claudePluginCacheRoot(), MARKETPLACE_NAME, PLUGIN_NAME);
+  const staleVersions = (await readdir26(pluginDir, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory() && entry.name !== currentVersion).map((entry) => entry.name);
   if (staleVersions.length === 0)
     return;
   steps.push({
@@ -111092,7 +111801,7 @@ async function pruneClaudeSupersededContextCache(root2, dryRun, steps) {
     status: dryRun ? "planned" : "ran"
   });
   if (!dryRun) {
-    await Promise.all(staleVersions.map((version3) => rm22(join105(pluginDir, version3), { recursive: true, force: true })));
+    await Promise.all(staleVersions.map((version3) => rm22(join106(pluginDir, version3), { recursive: true, force: true })));
   }
 }
 function enableCodexPluginConfig(content3) {
@@ -111156,36 +111865,36 @@ source = ${JSON.stringify(root2)}
 `;
 }
 async function ensureCodexPluginEnabled() {
-  const configPath = join105(codexHome(), "config.toml");
-  await mkdir33(dirname45(configPath), { recursive: true });
-  const current2 = await readFile85(configPath, "utf8").catch(() => "");
-  const next = enableCodexPluginConfig(current2);
-  if (next !== current2) {
-    await writeFile25(configPath, next, "utf8");
+  const configPath = join106(codexHome(), "config.toml");
+  await mkdir34(dirname45(configPath), { recursive: true });
+  const current2 = await readFile87(configPath, "utf8").catch(() => "");
+  const next2 = enableCodexPluginConfig(current2);
+  if (next2 !== current2) {
+    await writeFile25(configPath, next2, "utf8");
   }
 }
 async function ensureCodexLocalMarketplace(root2) {
-  const configPath = join105(codexHome(), "config.toml");
-  await mkdir33(dirname45(configPath), { recursive: true });
-  const current2 = await readFile85(configPath, "utf8").catch(() => "");
-  const next = upsertCodexLocalMarketplaceConfig(current2, root2);
-  if (next !== current2) {
-    await writeFile25(configPath, next, "utf8");
+  const configPath = join106(codexHome(), "config.toml");
+  await mkdir34(dirname45(configPath), { recursive: true });
+  const current2 = await readFile87(configPath, "utf8").catch(() => "");
+  const next2 = upsertCodexLocalMarketplaceConfig(current2, root2);
+  if (next2 !== current2) {
+    await writeFile25(configPath, next2, "utf8");
   }
 }
 async function codexPluginVersion(root2) {
-  const manifestPath = join105(root2, "codex", ".codex-plugin", "plugin.json");
-  const manifest = JSON.parse(await readFile85(manifestPath, "utf8"));
+  const manifestPath = join106(root2, "codex", ".codex-plugin", "plugin.json");
+  const manifest = JSON.parse(await readFile87(manifestPath, "utf8"));
   if (typeof manifest.version !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._-]*$/u.test(manifest.version)) {
     throw new Error(`Codex plugin manifest has an invalid version: ${manifestPath}`);
   }
   return manifest.version;
 }
 function codexPluginCacheDir(version3) {
-  return join105(codexHome(), "plugins", "cache", MARKETPLACE_NAME, PLUGIN_NAME, version3);
+  return join106(codexHome(), "plugins", "cache", MARKETPLACE_NAME, PLUGIN_NAME, version3);
 }
 async function replaceDirectoryFromSource(source2, target) {
-  await mkdir33(dirname45(target), { recursive: true });
+  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 });
@@ -111193,19 +111902,19 @@ async function replaceDirectoryFromSource(source2, target) {
   const hadPrevious = existsSync34(target);
   try {
     if (hadPrevious)
-      await rename7(target, previous3);
-    await rename7(temporary, target);
+      await rename8(target, previous3);
+    await rename8(temporary, target);
     if (hadPrevious)
       await rm22(previous3, { recursive: true, force: true });
   } catch (error) {
     await rm22(temporary, { recursive: true, force: true });
     if (hadPrevious && !existsSync34(target) && existsSync34(previous3))
-      await rename7(previous3, target);
+      await rename8(previous3, target);
     throw error;
   }
 }
 async function materializeCodexPluginCache(root2, version3, dryRun, steps) {
-  const source2 = join105(root2, "codex");
+  const source2 = join106(root2, "codex");
   const target = codexPluginCacheDir(version3);
   steps.push({
     agent: "codex",
@@ -111217,16 +111926,16 @@ async function materializeCodexPluginCache(root2, version3, dryRun, steps) {
   await replaceDirectoryFromSource(source2, target);
 }
 async function bundledProviderSkillNames(root2) {
-  const skillsRoot = join105(root2, "skills");
-  const entries2 = await readdir24(skillsRoot, { withFileTypes: true });
+  const skillsRoot = join106(root2, "skills");
+  const entries2 = await readdir26(skillsRoot, { withFileTypes: true });
   const names = [];
   for (const entry of entries2) {
     if (!entry.isDirectory() || entry.name === "context")
       continue;
-    const skillPath = join105(skillsRoot, entry.name, "SKILL.md");
+    const skillPath = join106(skillsRoot, entry.name, "SKILL.md");
     if (!existsSync34(skillPath))
       continue;
-    const skill = await readFile85(skillPath, "utf8");
+    const skill = await readFile87(skillPath, "utf8");
     if (!/^\s*context-role:\s*["']?indexer-provider["']?\s*$/mu.test(skill))
       continue;
     names.push(entry.name);
@@ -111238,10 +111947,10 @@ async function bundledProviderSkillNames(root2) {
   return names;
 }
 async function materializeProviderSkills(root2, targetRoot, agent, dryRun, steps) {
-  const sourceRoot2 = join105(root2, "skills");
+  const sourceRoot2 = join106(root2, "skills");
   for (const name3 of await bundledProviderSkillNames(root2)) {
-    const source2 = join105(sourceRoot2, name3);
-    const target = join105(targetRoot, name3);
+    const source2 = join106(sourceRoot2, name3);
+    const target = join106(targetRoot, name3);
     steps.push({
       agent,
       command: `materialize lifecycle Provider skill: ${shellQuote8(source2)} -> ${shellQuote8(target)}`,
@@ -111252,7 +111961,7 @@ async function materializeProviderSkills(root2, targetRoot, agent, dryRun, steps
   }
 }
 async function installCursor(root2, dryRun, steps) {
-  const source2 = join105(root2, "cursor");
+  const source2 = join106(root2, "cursor");
   const target = cursorPluginRoot();
   steps.push({
     agent: "cursor",
@@ -111307,12 +112016,12 @@ async function installCodex(root2, dryRun, steps) {
   steps.push({ agent: "codex", command: commandLine("codex", addArgs), status: dryRun ? "planned" : "ran" });
   steps.push({
     agent: "codex",
-    command: `ensure ${shellQuote8(join105(codexHome(), "config.toml"))} registers local marketplace ${shellQuote8(MARKETPLACE_NAME)}`,
+    command: `ensure ${shellQuote8(join106(codexHome(), "config.toml"))} registers local marketplace ${shellQuote8(MARKETPLACE_NAME)}`,
     status: dryRun ? "planned" : "ran"
   });
   steps.push({
     agent: "codex",
-    command: `ensure ${shellQuote8(join105(codexHome(), "config.toml"))} enables ${shellQuote8(PLUGIN_ID)}`,
+    command: `ensure ${shellQuote8(join106(codexHome(), "config.toml"))} enables ${shellQuote8(PLUGIN_ID)}`,
     status: dryRun ? "planned" : "ran"
   });
   if (dryRun) {
@@ -111367,13 +112076,13 @@ function pluginRootCandidates() {
     return [resolve40(envRoot)];
   const candidates = [];
   for (const dir of packageCandidateDirs()) {
-    candidates.push(join106(dir, "plugins"));
-    candidates.push(join106(dir, "dist", "plugins"));
+    candidates.push(join107(dir, "plugins"));
+    candidates.push(join107(dir, "dist", "plugins"));
   }
   return [...new Set(candidates)];
 }
 function isInstallablePluginRoot(root2) {
-  return existsSync35(join106(root2, ".claude-plugin", "marketplace.json")) && existsSync35(join106(root2, ".agents", "plugins", "marketplace.json")) && existsSync35(join106(root2, "claude", ".claude-plugin", "plugin.json")) && existsSync35(join106(root2, "codex", ".codex-plugin", "plugin.json")) && existsSync35(join106(root2, "cursor", ".cursor-plugin", "plugin.json")) && existsSync35(join106(root2, "skills"));
+  return existsSync35(join107(root2, ".claude-plugin", "marketplace.json")) && existsSync35(join107(root2, ".agents", "plugins", "marketplace.json")) && existsSync35(join107(root2, "claude", ".claude-plugin", "plugin.json")) && existsSync35(join107(root2, "codex", ".codex-plugin", "plugin.json")) && existsSync35(join107(root2, "cursor", ".cursor-plugin", "plugin.json")) && existsSync35(join107(root2, "skills"));
 }
 function resolveBundledPluginsRoot() {
   const candidates = pluginRootCandidates();
@@ -111603,10 +112312,10 @@ function readQuickstartPath() {
   try {
     let dir = dirname47(fileURLToPath10(import.meta.url));
     for (let i2 = 0;i2 < 8; i2++) {
-      const candidate = join107(dir, "docs", "quickstart.md");
+      const candidate = join108(dir, "docs", "quickstart.md");
       if (existsSync36(candidate))
         return candidate;
-      const pkg = join107(dir, "package.json");
+      const pkg = join108(dir, "package.json");
       if (existsSync36(pkg))
         return candidate;
       const parent = dirname47(dir);
@@ -111615,7 +112324,7 @@ function readQuickstartPath() {
       dir = parent;
     }
   } catch {}
-  return join107(dirname47(fileURLToPath10(import.meta.url)), "docs", "quickstart.md");
+  return join108(dirname47(fileURLToPath10(import.meta.url)), "docs", "quickstart.md");
 }
 var GREEN = "\x1B[32m";
 var RESET = "\x1B[0m";
@@ -111641,7 +112350,7 @@ ${greenBox([
 `;
 }
 function assertKnownTopLevelCommand(argv, program2) {
-  const commands = new Set(["help", ...program2.commands.flatMap((command2) => [command2.name(), ...command2.aliases()])]);
+  const commands = new Set(["help", ...program2.commands.flatMap((command3) => [command3.name(), ...command3.aliases()])]);
   for (const token of argv.slice(2)) {
     if (token === "-h" || token === "--help" || token === "-V" || token === "--version")
       return;
@@ -111867,9 +112576,9 @@ async function cli_main(argv = process.argv) {
     await withContextRuntimeEventDelivery(async () => {
       const program2 = createCliProgram();
       assertKnownTopLevelCommand(argv, program2);
-      const overrideExit = (command2) => {
-        command2.exitOverride();
-        command2.commands.forEach(overrideExit);
+      const overrideExit = (command3) => {
+        command3.exitOverride();
+        command3.commands.forEach(overrideExit);
       };
       overrideExit(program2);
       try {