@c4a/context-cli 0.7.20 → 0.7.25

package/cli.js

@@ -76442,12 +76442,22 @@ var init_packageTemplateUtils = __esm(() => {
   TEMPLATE_ENGINE.registerHelper("json", (value) => JSON.stringify(value, null, 2));
 });
 
+// src/project/packageDistributionMetadata.ts
+import { join as join15 } from "node:path";
+function packageDistributionMetadataPath(fileName) {
+  return join15(PACKAGE_DISTRIBUTION_METADATA_DIR, fileName);
+}
+var PACKAGE_DISTRIBUTION_METADATA_DIR;
+var init_packageDistributionMetadata = __esm(() => {
+  PACKAGE_DISTRIBUTION_METADATA_DIR = join15("others", "context");
+});
+
 // src/project/packageBuildInventory.ts
 import { createHash as createHash9 } from "node:crypto";
 import { mkdir as mkdir12, writeFile as writeFile7 } from "node:fs/promises";
-import { dirname as dirname14, join as join15 } from "node:path";
+import { dirname as dirname14, join as join16 } from "node:path";
 function knowledgeStructurePath(projectRoot) {
-  return join15(projectRoot, "knowledge", "structure.yaml");
+  return join16(projectRoot, "knowledge", "structure.yaml");
 }
 async function readKnowledgeStructure(projectRoot) {
   const snapshot = await reuseCommandFileRead({
@@ -76594,11 +76604,19 @@ function packageBuildInventory(input) {
   };
 }
 async function writePackageBuildInventory(input) {
-  const outputPath = join15(input.projectRoot, input.pkg.outDir, PACKAGE_BUILD_INVENTORY_PATH);
-  await mkdir12(dirname14(outputPath), { recursive: true });
-  await writeFile7(outputPath, `${JSON.stringify(input.inventory, null, 2)}
-`, "utf8");
-  return 1;
+  const outputPath = join16(input.projectRoot, input.pkg.outDir, PACKAGE_BUILD_INVENTORY_PATH);
+  const distributionPath = join16(input.projectRoot, input.pkg.outDir, packageDistributionMetadataPath(PACKAGE_BUILD_INVENTORY_PATH));
+  const content3 = `${JSON.stringify(input.inventory, null, 2)}
+`;
+  await Promise.all([
+    mkdir12(dirname14(outputPath), { recursive: true }),
+    mkdir12(dirname14(distributionPath), { recursive: true })
+  ]);
+  await Promise.all([
+    writeFile7(outputPath, content3, "utf8"),
+    writeFile7(distributionPath, content3, "utf8")
+  ]);
+  return 2;
 }
 var PACKAGE_BUILD_INVENTORY_PATH = "context-build-inventory.json";
 var init_packageBuildInventory = __esm(() => {
@@ -76609,6 +76627,7 @@ var init_packageBuildInventory = __esm(() => {
   init_packageNavigation();
   init_packageDistribution();
   init_packageTemplateUtils();
+  init_packageDistributionMetadata();
 });
 
 // src/project/codeAnalysisInput.ts
@@ -76763,7 +76782,7 @@ var init_indexerSourceBoundary = __esm(() => {
 import { execFile as execFile3 } from "node:child_process";
 import { lstat as lstat4, readFile as readFile18 } from "node:fs/promises";
 import { promisify as promisify3 } from "node:util";
-import { basename as basename4, extname as extname8, join as join16 } from "node:path";
+import { basename as basename4, extname as extname8, join as join17 } from "node:path";
 function sourceRefName(sourceRef) {
   return sourceRef.startsWith("repo:") ? sourceRef.slice("repo:".length) : null;
 }
@@ -76800,7 +76819,7 @@ function sourceRoot(input) {
   const source2 = name2 === null ? undefined : input.sources.find((candidate) => candidate.name === name2 || candidate.id === name2);
   if (source2 === undefined)
     throw new TypeError(`parser plan uses unknown source ${input.sourceRef}`);
-  return join16(input.projectRoot, source2.materializedAt);
+  return join17(input.projectRoot, source2.materializedAt);
 }
 async function materializeProjectIndexerParserEntryInput(input) {
   const sources = await loadSourcesRegistry({ rootDir: input.projectRoot });
@@ -76896,7 +76915,7 @@ __export(exports_processedScopeStorage, {
   captureProcessedScopes: () => captureProcessedScopes
 });
 import { readFile as readFile20 } from "node:fs/promises";
-import { join as join17 } from "node:path";
+import { join as join18 } from "node:path";
 async function currentScopeSourceVersion(projectRoot, sourceRef) {
   const sources = await loadSourcesRegistry({ rootDir: projectRoot });
   const split = sourceRef.indexOf(":");
@@ -76913,7 +76932,7 @@ async function currentScopeSourceVersion(projectRoot, sourceRef) {
     const version3 = entries2[0].ref;
     if (!/^[a-f0-9]{40}(?:[a-f0-9]{24})?$/u.test(version3))
       throw new TypeError("Processing requires a fixed commit, not a moving ref");
-    await assertPinnedSource(join17(projectRoot, entries2[0].materializedAt), version3);
+    await assertPinnedSource(join18(projectRoot, entries2[0].materializedAt), version3);
     return version3;
   }
   const entries = (type === "file" ? sources.files : type === "lark" ? sources.larks : []).filter((entry2) => entry2.id === name2 || entry2.name === name2);
@@ -76921,7 +76940,7 @@ async function currentScopeSourceVersion(projectRoot, sourceRef) {
     throw new TypeError(`Source must identify one registered document: ${sourceRef}`);
   const entry = entries[0];
   const manifest = entry.snapshot?.manifest ?? `${entry.materializedAt}/manifest.json`;
-  return parseDocumentSnapshotForSource(JSON.parse(await readFile20(join17(projectRoot, manifest), "utf8")), entry.name).snapshot_hash;
+  return parseDocumentSnapshotForSource(JSON.parse(await readFile20(join18(projectRoot, manifest), "utf8")), entry.name).snapshot_hash;
 }
 async function captureProcessedScopes(projectRoot, requested) {
   const scopes = processedScopesSchema.parse(requested);
@@ -76949,7 +76968,7 @@ async function commitProcessedScopes(projectRoot, scopes) {
   if (structure.parsed === null)
     throw new TypeError("A closed knowledge structure is required before recording processed scopes");
   const processed = mergeProcessedScopes(readProcessedScopes(structure.parsed), scopes);
-  await atomicWriteFile(join17(projectRoot, structure.path), import_yaml13.default.stringify({ ...structure.parsed, processed_scopes: processed }));
+  await atomicWriteFile(join18(projectRoot, structure.path), import_yaml13.default.stringify({ ...structure.parsed, processed_scopes: processed }));
 }
 async function invalidateChangedProcessedRequirements(projectRoot, previous2, current2) {
   const targets = new Map(current2.map((requirement2) => [requirement2.id, indexerProtocolDigest(requirement2)]));
@@ -76963,7 +76982,7 @@ async function invalidateChangedProcessedRequirements(projectRoot, previous2, cu
   const retained = scopes.filter((scope2) => !changed.has(scope2.requirement_ref));
   if (retained.length === scopes.length)
     return;
-  await atomicWriteFile(join17(projectRoot, structure.path), import_yaml13.default.stringify({ ...structure.parsed, processed_scopes: retained }));
+  await atomicWriteFile(join18(projectRoot, structure.path), import_yaml13.default.stringify({ ...structure.parsed, processed_scopes: retained }));
 }
 var import_yaml13;
 var init_processedScopeStorage = __esm(() => {
@@ -77102,7 +77121,7 @@ __export(exports_approvedRevisionPrograms, {
 });
 import { execFile as execFile4 } from "node:child_process";
 import { promisify as promisify4 } from "node:util";
-import { extname as extname9, join as join18 } from "node:path";
+import { extname as extname9, join as join19 } from "node:path";
 import { createRequire as createRequire3 } from "node:module";
 import { pathToFileURL } from "node:url";
 async function prepareRevisionProgramBlocks(root, sourceRefs, scopes, references) {
@@ -77118,7 +77137,7 @@ async function prepareRevisionProgramBlocks(root, sourceRefs, scopes, references
     if (entries.length !== 1)
       throw new TypeError(`Regeneration requires one registered source: ${source2}`);
     const entry = entries[0];
-    const directory = join18(root, entry.materializedAt);
+    const directory = join19(root, entry.materializedAt);
     const paths = [...new Set(references.filter((reference2) => reference2.source_ref === source2).map((reference2) => reference2.locator.path))];
     if (!paths.length)
       continue;
@@ -77248,14 +77267,14 @@ var init_approvedRevisionEdits = __esm(() => {
 // src/project/articleRegionBaselines.ts
 import { createHash as createHash10 } from "node:crypto";
 import { lstatSync, mkdirSync, readFileSync as readFileSync3, realpathSync, writeFileSync } from "node:fs";
-import { join as join19 } from "node:path";
+import { join as join20 } from "node:path";
 function baselinePath(root, digest2, create) {
   const hash2 = DIGEST.exec(digest2)?.[1];
   if (!hash2)
     throw new TypeError("Invalid source region digest");
   let path2 = realpathSync(root);
   for (const part of [".tmp", "context-runtime", "source-regions"]) {
-    path2 = join19(path2, part);
+    path2 = join20(path2, part);
     if (create) {
       try {
         mkdirSync(path2);
@@ -77274,7 +77293,7 @@ function baselinePath(root, digest2, create) {
       throw error;
     }
   }
-  return join19(path2, `${hash2}.txt`);
+  return join20(path2, `${hash2}.txt`);
 }
 function digestOf(text5) {
   return `sha256:${createHash10("sha256").update(text5, "utf8").digest("hex")}`;
@@ -77390,10 +77409,10 @@ __export(exports_maintenanceStorage, {
   APPROVED_REVISION_PATH: () => APPROVED_REVISION_PATH
 });
 import { readFile as readFile21 } from "node:fs/promises";
-import { join as join20 } from "node:path";
+import { join as join21 } from "node:path";
 async function readMaintenance(root) {
   try {
-    return stateSchema.parse(JSON.parse(await readFile21(join20(root, MAINTENANCE_ROOT, "current.json"), "utf8")));
+    return stateSchema.parse(JSON.parse(await readFile21(join21(root, MAINTENANCE_ROOT, "current.json"), "utf8")));
   } catch (error) {
     if (error.code === "ENOENT")
       return { protocol: "context.maintenance/v1", pending: [], completed: [] };
@@ -77401,18 +77420,18 @@ async function readMaintenance(root) {
   }
 }
 function saveMaintenance(root, state) {
-  return atomicWriteFile(join20(root, MAINTENANCE_ROOT, "current.json"), `${JSON.stringify(stateSchema.parse(state))}
+  return atomicWriteFile(join21(root, MAINTENANCE_ROOT, "current.json"), `${JSON.stringify(stateSchema.parse(state))}
 `);
 }
 async function revisionStoragePath(root) {
-  return (await readMaintenance(root)).active ? join20(MAINTENANCE_ROOT, "revision.json") : APPROVED_REVISION_PATH;
+  return (await readMaintenance(root)).active ? join21(MAINTENANCE_ROOT, "revision.json") : APPROVED_REVISION_PATH;
 }
 var MAINTENANCE_ROOT, APPROVED_REVISION_PATH, targetSchema, maintenanceInputSchema, requestSchema, stateSchema;
 var init_maintenanceStorage = __esm(() => {
   init_zod();
   init_atomicWrite();
-  MAINTENANCE_ROOT = join20(".tmp", "context-runtime", "maintenance");
-  APPROVED_REVISION_PATH = join20(".tmp", "context-runtime", "revision", "current.json");
+  MAINTENANCE_ROOT = join21(".tmp", "context-runtime", "maintenance");
+  APPROVED_REVISION_PATH = join21(".tmp", "context-runtime", "revision", "current.json");
   targetSchema = exports_external.object({ path: exports_external.string().min(1), instruction: exports_external.string().trim().min(1) }).strict();
   maintenanceInputSchema = exports_external.object({
     id: exports_external.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,95}$/u),
@@ -77439,24 +77458,24 @@ var init_maintenanceStorage = __esm(() => {
 });
 
 // src/project/lifecyclePaths.ts
-import { join as join21 } from "node:path";
+import { join as join22 } from "node:path";
 var LIFECYCLE_ROOT, CANDIDATE_LEDGER_FILE, LIFECYCLE_STRUCTURE_FILE, REVIEW_RUNTIME_ROOT, REVIEW_ACTION_ROOT, STRUCTURE_REPORT_ROOT, CANDIDATE_SNAPSHOT_ROOT, INDEXER_RUNTIME_ROOT, INDEXER_WORKSET_VIEW_RUNTIME_ROOT;
 var init_lifecyclePaths = __esm(() => {
-  LIFECYCLE_ROOT = join21(".tmp", "context-runtime", "lifecycle");
-  CANDIDATE_LEDGER_FILE = join21(LIFECYCLE_ROOT, "candidates.jsonl");
-  LIFECYCLE_STRUCTURE_FILE = join21(LIFECYCLE_ROOT, "structure.yaml");
-  REVIEW_RUNTIME_ROOT = join21(".tmp", "context-runtime", "review");
-  REVIEW_ACTION_ROOT = join21(".tmp", "context-runtime", "review-actions");
-  STRUCTURE_REPORT_ROOT = join21(".tmp", "context-runtime", "reports");
-  CANDIDATE_SNAPSHOT_ROOT = join21(".tmp", "context-runtime", "extract", "candidates");
-  INDEXER_RUNTIME_ROOT = join21(".tmp", "context-runtime", "indexer");
-  INDEXER_WORKSET_VIEW_RUNTIME_ROOT = join21(INDEXER_RUNTIME_ROOT, "workset-views");
+  LIFECYCLE_ROOT = join22(".tmp", "context-runtime", "lifecycle");
+  CANDIDATE_LEDGER_FILE = join22(LIFECYCLE_ROOT, "candidates.jsonl");
+  LIFECYCLE_STRUCTURE_FILE = join22(LIFECYCLE_ROOT, "structure.yaml");
+  REVIEW_RUNTIME_ROOT = join22(".tmp", "context-runtime", "review");
+  REVIEW_ACTION_ROOT = join22(".tmp", "context-runtime", "review-actions");
+  STRUCTURE_REPORT_ROOT = join22(".tmp", "context-runtime", "reports");
+  CANDIDATE_SNAPSHOT_ROOT = join22(".tmp", "context-runtime", "extract", "candidates");
+  INDEXER_RUNTIME_ROOT = join22(".tmp", "context-runtime", "indexer");
+  INDEXER_WORKSET_VIEW_RUNTIME_ROOT = join22(INDEXER_RUNTIME_ROOT, "workset-views");
 });
 
 // src/project/candidateLedger.ts
 import { existsSync as existsSync4 } from "node:fs";
 import { mkdir as mkdir13, readFile as readFile22, rm as rm7, writeFile as writeFile8 } from "node:fs/promises";
-import { dirname as dirname16, join as join22 } from "node:path";
+import { dirname as dirname16, join as join23 } from "node:path";
 function isRecord6(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -77637,7 +77656,7 @@ function parseCandidateLine(line, lineNumber) {
   return parseCandidateRecord(parsed, lineNumber);
 }
 async function readCandidateRecords(projectRoot) {
-  const filePath = join22(projectRoot, CANDIDATE_LEDGER_FILE);
+  const filePath = join23(projectRoot, CANDIDATE_LEDGER_FILE);
   if (!existsSync4(filePath))
     return [];
   const records = await reuseCommandFileRead({ key: "candidate-records", paths: [filePath], read: async () => {
@@ -77720,7 +77739,7 @@ var init_newKnowledgePage = __esm(() => {
 
 // src/project/approvedKnowledgeMetadata.ts
 import { existsSync as existsSync5 } from "node:fs";
-import { join as join23 } from "node:path";
+import { join as join24 } from "node:path";
 function isRecord7(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -77750,7 +77769,7 @@ function approvedKnowledgeMetadataIndex(structure) {
 async function readApprovedKnowledgeMetadataIndex(projectRoot, structureOverride) {
   if (structureOverride !== undefined)
     return approvedKnowledgeMetadataIndex(structureOverride);
-  const path2 = join23(projectRoot, STRUCTURE_PATH);
+  const path2 = join24(projectRoot, STRUCTURE_PATH);
   if (!existsSync5(path2))
     return approvedKnowledgeMetadataIndex(undefined);
   try {
@@ -77827,7 +77846,7 @@ var init_approvedKnowledgeMetadata = __esm(() => {
   init_src2();
   init_packageKnowledgeProjection();
   import_yaml15 = __toESM(require_dist(), 1);
-  STRUCTURE_PATH = join23("knowledge", "structure.yaml");
+  STRUCTURE_PATH = join24("knowledge", "structure.yaml");
   FRONTMATTER_RE2 = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u;
   COMPACT_FIELDS = new Set([
     "title",
@@ -77878,7 +77897,7 @@ function selectDeliveryPages(input) {
 // src/project/knowledgeAssets.ts
 import { existsSync as existsSync6 } from "node:fs";
 import { readFile as readFile23, readdir as readdir8, rm as rm8 } from "node:fs/promises";
-import { dirname as dirname17, extname as extname10, join as join24, relative as relative13, resolve as resolve19, sep as sep3 } from "node:path";
+import { dirname as dirname17, extname as extname10, join as join25, relative as relative13, resolve as resolve19, sep as sep3 } from "node:path";
 function posixPath(value) {
   return value.split(sep3).join("/");
 }
@@ -77911,7 +77930,7 @@ function sourceAssetPath(documentPath, target) {
   const decoded = decodedTarget(target);
   if (/^[a-z][a-z0-9+.-]*:/iu.test(decoded) || decoded.startsWith("#") || decoded.startsWith("/"))
     return;
-  const normalized = posixPath(join24(dirname17(documentPath), decoded));
+  const normalized = posixPath(join25(dirname17(documentPath), decoded));
   if (normalized === "assets" || normalized.startsWith("assets/"))
     return normalized;
   return;
@@ -77923,7 +77942,7 @@ function selectedAssets(input) {
   const selected = new Map;
   for (const link of markdownInlineLinks(input.content)) {
     const target = link.target;
-    const pageTarget = posixPath(join24(dirname17(input.pageRelPath), decodedTarget(target)));
+    const pageTarget = posixPath(join25(dirname17(input.pageRelPath), decodedTarget(target)));
     const sourceRoot2 = posixPath(input.sourceMaterializedAt).replace(/\/$/u, "") + "/";
     const path2 = sourceAssetPath(input.documentPath, target) ?? (pageTarget.startsWith(sourceRoot2) ? pageTarget.slice(sourceRoot2.length) : undefined);
     if (path2 === undefined)
@@ -77968,7 +77987,7 @@ async function projectKnowledgeAssets(input) {
         next: "Rerun the source capture and resolve resource materialization errors before Review."
       });
     }
-    const sourcePath = join24(input.projectRoot, input.sourceMaterializedAt, asset.path);
+    const sourcePath = join25(input.projectRoot, input.sourceMaterializedAt, asset.path);
     let bytes;
     try {
       bytes = await readFile23(sourcePath);
@@ -77984,7 +78003,7 @@ async function projectKnowledgeAssets(input) {
     knowledgePathBySourcePath.set(asset.path, relPath);
     assets.push({
       relPath,
-      absPath: join24(input.projectRoot, relPath),
+      absPath: join25(input.projectRoot, relPath),
       bytes,
       contentHash: asset.content_hash
     });
@@ -78006,7 +78025,7 @@ function canonicalizeKnowledgeAssetLinks(input) {
   let rewritten = 0;
   const content3 = replaceMarkdownInlineLinkTargets(input.content, (link) => {
     const sourcePath = sourceAssetPath(input.documentPath, link.target);
-    const projectedPath = input.pageRelPath === undefined ? undefined : posixPath(join24(dirname17(input.pageRelPath), decodedTarget(link.target)));
+    const projectedPath = input.pageRelPath === undefined ? undefined : posixPath(join25(dirname17(input.pageRelPath), decodedTarget(link.target)));
     const asset = (sourcePath === undefined ? undefined : bySourcePath.get(sourcePath)) ?? (projectedPath === undefined ? undefined : byKnowledgePath.get(projectedPath));
     if (asset?.content_hash === undefined)
       return;
@@ -78021,7 +78040,7 @@ function knowledgeAssetReferences(input) {
     const target = link.target;
     if (/^[a-z][a-z0-9+.-]*:/iu.test(target) || target.startsWith("#"))
       continue;
-    const resolved = posixPath(join24(dirname17(input.pageRelPath), decodedTarget(target)));
+    const resolved = posixPath(join25(dirname17(input.pageRelPath), decodedTarget(target)));
     if (resolved.startsWith("knowledge/assets/"))
       references.add(resolved);
   }
@@ -78042,7 +78061,7 @@ async function walkFiles2(root) {
   const files = [];
   const visit3 = async (dir) => {
     for (const entry of await readdir8(dir, { withFileTypes: true })) {
-      const path2 = join24(dir, entry.name);
+      const path2 = join25(dir, entry.name);
       if (entry.isDirectory())
         await visit3(path2);
       else if (entry.isFile())
@@ -78053,8 +78072,8 @@ async function walkFiles2(root) {
   return files;
 }
 async function removeOrphanKnowledgeAssets(projectRoot, currentReferences) {
-  const knowledgeRoot = join24(projectRoot, "knowledge");
-  const assetRoot = join24(knowledgeRoot, "assets");
+  const knowledgeRoot = join25(projectRoot, "knowledge");
+  const assetRoot = join25(knowledgeRoot, "assets");
   if (!existsSync6(assetRoot))
     return [];
   const referenced = new Set(currentReferences ?? []);
@@ -78099,7 +78118,7 @@ var init_knowledgeAssets = __esm(() => {
 // src/project/documentEvidenceIndex.ts
 import { Buffer as Buffer3 } from "node:buffer";
 import { mkdir as mkdir14, readFile as readFile24, writeFile as writeFile9 } from "node:fs/promises";
-import { dirname as dirname18, join as join25 } from "node:path";
+import { dirname as dirname18, join as join26 } from "node:path";
 function workspaceStateError(message, detail = {}) {
   return new ContextError(ExitCode.WorkspaceStateError, message, {
     category: ErrorCategory.WorkspaceStateInvalid,
@@ -78113,10 +78132,10 @@ function userInputError(message, detail = {}) {
   });
 }
 function committedManifestRelativePath(sourceType, sourceName) {
-  return join25("sources", sourceType, normalizeDocumentSourceName(sourceName), "manifest.json");
+  return join26("sources", sourceType, normalizeDocumentSourceName(sourceName), "manifest.json");
 }
 function runtimeEvidenceIndexRelativePath(sourceType, sourceName) {
-  return join25(".tmp", "context-runtime", "evidence", sourceType, normalizeDocumentSourceName(sourceName), "source-index.json");
+  return join26(".tmp", "context-runtime", "evidence", sourceType, normalizeDocumentSourceName(sourceName), "source-index.json");
 }
 async function readJsonFile(path2, next) {
   try {
@@ -78138,7 +78157,7 @@ function assertManifestSource(input) {
   }
 }
 async function readCommittedSnapshotFile(input) {
-  const absolutePath = join25(input.projectRoot, input.materializedAt, input.path);
+  const absolutePath = join26(input.projectRoot, input.materializedAt, input.path);
   try {
     return await readFile24(absolutePath);
   } catch (error) {
@@ -78185,9 +78204,9 @@ async function buildCommittedEvidenceIndex(input) {
     });
   }
   const managed = input.sourceType === "note" || input.sourceType === "sessions" ? await (await Promise.resolve().then(() => (init_managedDocumentSnapshot(), exports_managedDocumentSnapshot))).readManagedDocumentSnapshot(input.projectRoot, input.sourceType, sourceName) : undefined;
-  const materializedAt = managed?.materializedAt ?? input.materializedAt ?? join25("sources", input.sourceType, sourceName);
+  const materializedAt = managed?.materializedAt ?? input.materializedAt ?? join26("sources", input.sourceType, sourceName);
   const manifestRelPath = managed ? `sources/${input.sourceType}/${sourceName}` : input.manifestPath ?? committedManifestRelativePath(input.sourceType, sourceName);
-  const manifestAbsPath = join25(input.projectRoot, manifestRelPath);
+  const manifestAbsPath = join26(input.projectRoot, manifestRelPath);
   let manifest;
   try {
     manifest = managed?.manifest ?? parseDocumentSnapshotForSource(await readJsonFile(manifestAbsPath, `rerun context run capture:${input.sourceType}:${sourceName} or restore ${manifestRelPath}`), sourceName);
@@ -78267,7 +78286,7 @@ async function buildCommittedEvidenceIndex(input) {
       continue;
     let bytes;
     try {
-      bytes = await readFile24(join25(input.projectRoot, materializedAt, asset.path));
+      bytes = await readFile24(join26(input.projectRoot, materializedAt, asset.path));
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       throw workspaceStateError(`document snapshot audit asset is missing: ${asset.path}`, {
@@ -78308,7 +78327,7 @@ async function buildCommittedEvidenceIndex(input) {
     documents
   };
   const runtimeIndexPath = runtimeEvidenceIndexRelativePath(input.sourceType, sourceName);
-  const absoluteRuntimeIndexPath = join25(input.projectRoot, runtimeIndexPath);
+  const absoluteRuntimeIndexPath = join26(input.projectRoot, runtimeIndexPath);
   if (input.writeRuntimeIndex ?? true) {
     await mkdir14(dirname18(absoluteRuntimeIndexPath), { recursive: true });
     await writeFile9(absoluteRuntimeIndexPath, `${JSON.stringify(index2, null, 2)}
@@ -78332,7 +78351,7 @@ var init_documentEvidenceIndex = __esm(() => {
 });
 
 // src/project/assetSourceRegistry.ts
-import { join as join26 } from "node:path";
+import { join as join27 } from "node:path";
 function emptySourceRegistryLookup(loaded) {
   return {
     loaded,
@@ -78402,10 +78421,10 @@ function registeredDocumentSource(registry2, sourceType, sourceName) {
   return registry2.documents[sourceType].get(sourceName);
 }
 function defaultDocumentMaterializedAt(sourceType, sourceName) {
-  return join26("sources", sourceType, sourceName);
+  return join27("sources", sourceType, sourceName);
 }
 function defaultDocumentManifest(materializedAt) {
-  return join26(materializedAt, "manifest.json");
+  return join27(materializedAt, "manifest.json");
 }
 async function getCommittedEvidenceIndex(input) {
   const key = `${input.sourceType}:${input.sourceName}:${input.materializedAt}:${input.manifestPath}`;
@@ -78698,7 +78717,7 @@ __export(exports_approvedRevisionBatch, {
   approvedRevisionCandidateApplied: () => approvedRevisionCandidateApplied
 });
 import { readFile as readFile26 } from "node:fs/promises";
-import { join as join27 } from "node:path";
+import { join as join28 } from "node:path";
 async function prepareRevisionBatchContinuation(root, request, batch) {
   const [next, ...remaining] = request.pending_targets ?? [];
   if (!next)
@@ -78778,13 +78797,13 @@ async function observeApprovedRevisionBatch(root, request) {
   for (const original of expected) {
     const candidate = rows.find((row) => row.candidate_id === original.candidate_id);
     const revision = original.approved_revision;
-    const bytes = await readFile26(join27(root, "knowledge", revision.previous_path ?? original.path), "utf8").catch((error) => {
+    const bytes = await readFile26(join28(root, "knowledge", revision.previous_path ?? original.path), "utf8").catch((error) => {
       if (error.code === "ENOENT")
         return;
       throw error;
     });
     if (!candidate) {
-      const applied = await readFile26(join27(root, "knowledge", original.path), "utf8").catch(() => {
+      const applied = await readFile26(join28(root, "knowledge", original.path), "utf8").catch(() => {
         return;
       });
       if (await approvedRevisionCandidateApplied(root, original, applied))
@@ -78954,7 +78973,7 @@ var init_verifyFrontmatter = __esm(() => {
 // src/project/productionSubmissionFiles.ts
 import { constants as constants3 } from "node:fs";
 import { lstat as lstat5, open as open3, realpath as realpath4 } from "node:fs/promises";
-import { isAbsolute as isAbsolute11, join as join28, relative as relative14 } from "node:path";
+import { isAbsolute as isAbsolute11, join as join29, relative as relative14 } from "node:path";
 function invalidFile(path2, message) {
   return new ContextError(ExitCode.UserError, message, {
     category: ErrorCategory.UserInputInvalid,
@@ -78965,7 +78984,7 @@ function invalidFile(path2, message) {
   });
 }
 function productionAgentDirectory(stage) {
-  return join28(".tmp", "agent-work", "production-stages", localId.parse(stage));
+  return join29(".tmp", "agent-work", "production-stages", localId.parse(stage));
 }
 function assertRelativeFile(path2) {
   if (isAbsolute11(path2) || /^[a-zA-Z]:/u.test(path2) || path2.includes("\\") || path2.includes("\x00") || path2.split("/").some((part) => !part || part === "." || part === "..")) {
@@ -78976,14 +78995,14 @@ async function readProductionFile(input) {
   return readFixedProductionFile({ ...input, directory: productionAgentDirectory(input.stage) });
 }
 async function readProductionPlanningFile(input) {
-  return readFixedProductionFile({ ...input, directory: join28(".tmp", "agent-work") });
+  return readFixedProductionFile({ ...input, directory: join29(".tmp", "agent-work") });
 }
 async function readFixedProductionFile(input) {
   assertRelativeFile(input.path);
   const limit = input.maxBytes ?? DEFAULT_LIMITS.file_bytes;
   if (!Number.isSafeInteger(limit) || limit < 1)
     throw invalidFile(input.path, "File budget must be a positive safe integer.");
-  const local = join28(input.directory, input.path);
+  const local = join29(input.directory, input.path);
   let handle;
   try {
     const root = await realpath4(input.projectRoot);
@@ -78994,7 +79013,7 @@ async function readFixedProductionFile(input) {
     handle = await open3(absolute, constants3.O_RDONLY | constants3.O_NOFOLLOW | constants3.O_NONBLOCK);
     const opened = await handle.stat();
     const resolved = await realpath4(absolute);
-    const stageRoot = join28(root, input.directory);
+    const stageRoot = join29(root, input.directory);
     const within = relative14(stageRoot, resolved);
     if (within.startsWith("..") || isAbsolute11(within) || opened.dev !== before.dev || opened.ino !== before.ino) {
       throw invalidFile(input.path, "The draft path changed while opening it; restore a stage-local file and retry.");
@@ -79120,7 +79139,7 @@ var init_productionSubmissionFiles = __esm(() => {
 
 // src/project/productionArticleTarget.ts
 import { readFile as readFile27 } from "node:fs/promises";
-import { join as join29 } from "node:path";
+import { join as join30 } from "node:path";
 function productionApprovedTargetsIndex(metadata) {
   const articles = validateArticleStructureEntries(metadata.structure?.articles ?? []);
   return {
@@ -79146,7 +79165,7 @@ async function readProductionArticleTarget(input) {
   let markdown = existing[0]?.body;
   if (markdown === undefined) {
     try {
-      markdown = await readFile27(await safeProjectTarget(input.projectRoot, join29("knowledge", task.path)), "utf8");
+      markdown = await readFile27(await safeProjectTarget(input.projectRoot, join30("knowledge", task.path)), "utf8");
     } catch (error) {
       if (error.code !== "ENOENT")
         throw error;
@@ -79166,7 +79185,7 @@ async function readProductionArticleTarget(input) {
   }
   let approvedBaseDigest = existing[0]?.approved_revision?.base_digest;
   if (approvedBaseDigest === undefined) {
-    const formalMarkdown = formal.length ? await readFile27(await safeProjectTarget(input.projectRoot, join29("knowledge", task.path)), "utf8") : undefined;
+    const formalMarkdown = formal.length ? await readFile27(await safeProjectTarget(input.projectRoot, join30("knowledge", task.path)), "utf8") : undefined;
     approvedBaseDigest = formalMarkdown === undefined ? null : durableContentDigest(formalMarkdown);
   }
   return { visibility, approvedBaseDigest, ...sections ? { base: { markdown, sections } } : {} };
@@ -79405,10 +79424,10 @@ __export(exports_productionStageStore, {
 });
 import { constants as constants4 } from "node:fs";
 import { readFile as readFile28, access as access2, stat as stat7 } from "node:fs/promises";
-import { join as join30 } from "node:path";
+import { join as join31 } from "node:path";
 function productionStageDirectory(id3) {
   productionAgentDirectory(id3);
-  return join30(PRODUCTION_STAGES_ROOT, id3);
+  return join31(PRODUCTION_STAGES_ROOT, id3);
 }
 async function readOptional(root, path2) {
   const absolute = await safeProjectTarget(root, path2);
@@ -79459,7 +79478,7 @@ async function readProductionStageSnapshot(root, id3) {
       }
       id3 = value.stage;
     }
-    feedback.file = join30(productionStageDirectory(id3), "manifest.json");
+    feedback.file = join31(productionStageDirectory(id3), "manifest.json");
     const content3 = await readOptional(root, feedback.file);
     if (content3 === undefined)
       return;
@@ -79472,7 +79491,7 @@ async function readProductionStageSnapshot(root, id3) {
 async function saveProductionStage(root, value) {
   const stage = validateProductionStage(value);
   await withProjectWriteLock(root, "production-stage", async () => {
-    await writeProductionProjection(root, join30(productionStageDirectory(stage.id), "manifest.json"), `${JSON.stringify(stage)}
+    await writeProductionProjection(root, join31(productionStageDirectory(stage.id), "manifest.json"), `${JSON.stringify(stage)}
 `);
     await writeProductionProjection(root, CURRENT_PATH, `${JSON.stringify({ stage: stage.id })}
 `);
@@ -79496,15 +79515,15 @@ function productionPlanMarkdown(stage) {
       ...stage.tasks.filter((task) => task.status === "replaced").map((task) => `- ${task.path}: ${task.reason ?? "Replaced by the current plan"}`)
     ] : [],
     "",
-    `Planned skill guidance: ${join30(directory, "indexer-usage.yaml")}`,
-    `Available skill entries: ${join30(directory, "skills.md")}`,
+    `Planned skill guidance: ${join31(directory, "indexer-usage.yaml")}`,
+    `Available skill entries: ${join31(directory, "skills.md")}`,
     "",
     `Remaining investigation: ${stage.pending_scopes.join(", ") || "none"}`,
     "",
     ...!stage.report_approved && stage.planning_complete ? [
-      `If the user requests changes, edit ${productionAgentDirectory(stage.id)}/submissions/plan.yaml using ${join30(directory, "planning.schema.json")}.`,
+      `If the user requests changes, edit ${productionAgentDirectory(stage.id)}/submissions/plan.yaml using ${join31(directory, "planning.schema.json")}.`,
       `Resubmit: context action complete-current --revision ${stage.id} --input ${productionAgentDirectory(stage.id)}/submissions/plan.yaml --format json`,
-      "Then present the updated report and wait for approval; an old report confirmation does not approve changed article goals.",
+      "Then present the updated report and apply context.gate.work_start_scope; an old decision does not approve changed article goals.",
       ""
     ] : [],
     ...stage.gaps.map((gap) => `- ${gap.scope}: ${gap.reason}`),
@@ -79528,12 +79547,12 @@ async function materializeProductionStage(input) {
         changed += 1;
     };
     if (input.materials) {
-      await write(join30(directory, "shared/requirements.md"), input.materials.requirements);
-    } else if (dispatch.batches.length && !await hasReadableProjection(input.projectRoot, join30(directory, "shared/requirements.md"))) {
+      await write(join31(directory, "shared/requirements.md"), input.materials.requirements);
+    } else if (dispatch.batches.length && !await hasReadableProjection(input.projectRoot, join31(directory, "shared/requirements.md"))) {
       throw new TypeError("Stage materials are missing. Re-prepare the current plan's directory; accepted tasks remain saved.");
     }
-    await write(join30(directory, "capabilities.yaml"), import_yaml21.default.stringify(input.capabilities));
-    await write(join30(directory, "skills.md"), [
+    await write(join31(directory, "capabilities.yaml"), import_yaml21.default.stringify(input.capabilities));
+    await write(join31(directory, "skills.md"), [
       "# Available skills",
       "",
       ...input.capabilities.skills.map((skill) => `- ${skill.name}${skill.entry ? `: ${skill.entry}` : " (read through the host)"}`),
@@ -79542,13 +79561,13 @@ async function materializeProductionStage(input) {
       ""
     ].join(`
 `));
-    await write(join30(directory, "indexer-usage.yaml"), import_yaml21.default.stringify(stage.indexer_usage));
-    await write(join30(directory, "plan.md"), productionPlanMarkdown(stage));
+    await write(join31(directory, "indexer-usage.yaml"), import_yaml21.default.stringify(stage.indexer_usage));
+    await write(join31(directory, "plan.md"), productionPlanMarkdown(stage));
     const issued = new Set(dispatch.batches.flatMap((batch) => batch.tasks));
     const neededScopes = new Set(stage.tasks.filter((task) => issued.has(task.id)).flatMap((task) => task.sources.map((source2) => source2.scope)));
     const scopePaths = new Map;
     for (const scope2 of stage.scopes) {
-      const path2 = join30(directory, productionSourceFile(scope2.scope));
+      const path2 = join31(directory, productionSourceFile(scope2.scope));
       scopePaths.set(scope2.scope, path2);
       if (input.materials) {
         const content3 = input.materials.sources.get(scope2.scope);
@@ -79562,15 +79581,15 @@ async function materializeProductionStage(input) {
     for (const [path2, content3] of input.materials?.guidance ?? []) {
       if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]*\.md$/u.test(path2))
         throw new TypeError("Guidance files need a local Markdown basename");
-      await write(join30(directory, "guidance", path2), content3);
+      await write(join31(directory, "guidance", path2), content3);
     }
     const submittedTasks = [];
     let candidates;
     let approved;
     const tasksById = new Map(stage.tasks.map((task) => [task.id, task]));
     for (const batch of dispatch.batches) {
-      const batchPath = join30(directory, "batches", batch.id);
-      await write(join30(batchPath, "batch.md"), `# Batch ${batch.id}
+      const batchPath = join31(directory, "batches", batch.id);
+      await write(join31(batchPath, "batch.md"), `# Batch ${batch.id}
 
 Tasks: ${batch.tasks.join(", ")}
 
@@ -79579,10 +79598,10 @@ Read each task's scope and dependencies. Workers write drafts only; the coordina
       for (let offset2 = 0;offset2 < batch.tasks.length; offset2 += 8) {
         const projections = await Promise.allSettled(batch.tasks.slice(offset2, offset2 + 8).map(async (id3) => {
           const task = tasksById.get(id3);
-          const taskRoot = join30(batchPath, "tasks", id3);
+          const taskRoot = join31(batchPath, "tasks", id3);
           if (task.base !== null) {
-            const basePath = join30(taskRoot, "base.md");
-            const referencesPath = join30(taskRoot, "base-references.yaml");
+            const basePath = join31(taskRoot, "base.md");
+            const referencesPath = join31(taskRoot, "base-references.yaml");
             let missing = false;
             try {
               await access2(await safeProjectTarget(input.projectRoot, basePath));
@@ -79606,7 +79625,7 @@ Read each task's scope and dependencies. Workers write drafts only; the coordina
               await write(referencesPath, import_yaml21.default.stringify({ sections: target.base.sections }));
             }
           }
-          await write(join30(taskRoot, "task.md"), [
+          await write(join31(taskRoot, "task.md"), [
             `# ${task.question}`,
             "",
             `Target: ${task.path}`,
@@ -79616,16 +79635,16 @@ Read each task's scope and dependencies. Workers write drafts only; the coordina
             task.brief ?? "Read the authorized sources and write the complete article, or revise the existing article's affected fragments.",
             "",
             ...task.base !== null ? [
-              `Revision base: ${join30(taskRoot, "base.md")}`,
-              `Existing sections and references: ${join30(taskRoot, "base-references.yaml")}`,
+              `Revision base: ${join31(taskRoot, "base.md")}`,
+              `Existing sections and references: ${join31(taskRoot, "base-references.yaml")}`,
               ""
             ] : [],
-            `Shared requirements: ${join30(directory, "shared/requirements.md")}`,
-            `Relevant planned skills: ${join30(directory, "indexer-usage.yaml")}`,
+            `Shared requirements: ${join31(directory, "shared/requirements.md")}`,
+            `Relevant planned skills: ${join31(directory, "indexer-usage.yaml")}`,
             ""
           ].join(`
 `));
-          await write(join30(taskRoot, "sources.md"), [
+          await write(join31(taskRoot, "sources.md"), [
             "# Authorized sources",
             "",
             ...task.sources.map((source2) => `- ${source2.scope}: ${scopePaths.get(source2.scope)}`),
@@ -79644,24 +79663,24 @@ Read each task's scope and dependencies. Workers write drafts only; the coordina
         }
       }
     }
-    const submission = dispatch.batches.length ? join30(directory, "submission.yaml") : undefined;
+    const submission = dispatch.batches.length ? join31(directory, "submission.yaml") : undefined;
     if (submission)
       await write(submission, import_yaml21.default.stringify({ stage: stage.id, tasks: submittedTasks }));
-    await write(join30(directory, "stage.md"), [
+    await write(join31(directory, "stage.md"), [
       `# ${stage.purpose}`,
       "",
       `Stage: ${stage.id}`,
       `State: ${dispatch.state}`,
       `Scheduling: ${dispatch.mode}`,
       "",
-      ...dispatch.batches.map((batch) => `- Batch ${batch.id}: ${join30(directory, "batches", batch.id, "batch.md")}`),
+      ...dispatch.batches.map((batch) => `- Batch ${batch.id}: ${join31(directory, "batches", batch.id, "batch.md")}`),
       "",
       `Agent output directory: ${agent}`,
       `Remaining investigation: ${stage.pending_scopes.join(", ") || "none"}`,
       "",
       ...stage.tasks.filter((task) => task.status === "blocked").map((task) => `- Blocked task ${task.id}: ${task.path} — ${task.reason ?? "Investigate the task's source and dependencies."}`),
       "",
-      `To add articles within this confirmed purpose and source scope, submit a plan amendment using ${join30(directory, "planning.schema.json")}.`,
+      `To add articles within this confirmed purpose and source scope, submit a plan amendment using ${join31(directory, "planning.schema.json")}.`,
       "During writing, articles adds tasks; replaces explicitly names unfinished task IDs. Existing task IDs may be used in after. Do not resubmit the whole original plan or widen the purpose without user confirmation.",
       `Plan amendment: context action complete-current --revision ${stage.id} --input ${agent}/submissions/plan-amendment.yaml --format json`,
       "",
@@ -79689,7 +79708,7 @@ async function prepareNextProductionStage(input) {
   return materializeProductionStage({ projectRoot: input.projectRoot, stage: input.stage, capabilities });
 }
 async function readProductionCapabilities(root, stage) {
-  const saved = await readOptional(root, join30(productionStageDirectory(stage), "capabilities.yaml"));
+  const saved = await readOptional(root, join31(productionStageDirectory(stage), "capabilities.yaml"));
   return productionCapabilitiesSchema.parse(saved ? import_yaml21.default.parse(saved) : {});
 }
 var import_yaml21, PRODUCTION_STAGES_ROOT = ".tmp/context-runtime/production-stages", CURRENT_PATH;
@@ -79705,19 +79724,19 @@ var init_productionStageStore = __esm(() => {
   init_productionFeedback();
   init_productionStage();
   import_yaml21 = __toESM(require_dist(), 1);
-  CURRENT_PATH = join30(PRODUCTION_STAGES_ROOT, "current.json");
+  CURRENT_PATH = join31(PRODUCTION_STAGES_ROOT, "current.json");
 });
 
 // src/project/indexerTemplateSnapshots.ts
 import { readFile as readFile29, mkdir as mkdir16 } from "node:fs/promises";
-import { join as join31 } from "node:path";
+import { join as join32 } from "node:path";
 function object3(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
 }
 function snapshotPath(root, digest3) {
   if (!/^sha256:[a-f0-9]{64}$/u.test(digest3))
     throw new TypeError("Invalid template snapshot digest");
-  return join31(root, ...ROOT, `${digest3.slice(7)}.json`);
+  return join32(root, ...ROOT, `${digest3.slice(7)}.json`);
 }
 async function encodeTemplateSnapshots(root, value) {
   const spec = object3(value);
@@ -79756,7 +79775,7 @@ async function encodeTemplateSnapshots(root, value) {
       if (indexerProtocolDigest(JSON.parse(existing)) !== digest3)
         throw new TypeError("Template snapshot integrity mismatch");
     } else {
-      await mkdir16(join31(root, ...ROOT), { recursive: true });
+      await mkdir16(join32(root, ...ROOT), { recursive: true });
       await atomicWriteFile(path2, canonicalIndexerJson(shared));
     }
     return { protocol: REF, digest: digest3, ...binding ? { binding } : {} };
@@ -79838,7 +79857,7 @@ __export(exports_indexerMainRunStoreRecords, {
   INDEXER_MAIN_RUN_CURRENT_PATH: () => INDEXER_MAIN_RUN_CURRENT_PATH
 });
 import { readFile as readFile30 } from "node:fs/promises";
-import { join as join32 } from "node:path";
+import { join as join33 } from "node:path";
 function isRecord9(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -79849,13 +79868,13 @@ function digestName(digest3) {
   return digest3.slice("sha256:".length);
 }
 function runSpecPath(requestDigest) {
-  return join32(INDEXER_MAIN_RUN_STORE_ROOT, "requests", `${digestName(requestDigest)}.json`);
+  return join33(INDEXER_MAIN_RUN_STORE_ROOT, "requests", `${digestName(requestDigest)}.json`);
 }
 function acceptedCachePath(requestDigest) {
-  return join32(INDEXER_MAIN_RUN_STORE_ROOT, "accepted", `${digestName(requestDigest)}.json`);
+  return join33(INDEXER_MAIN_RUN_STORE_ROOT, "accepted", `${digestName(requestDigest)}.json`);
 }
 function partitionConvergencePath(attemptDigest) {
-  return join32(INDEXER_MAIN_RUN_STORE_ROOT, "partition-convergence", `${digestName(attemptDigest)}.json`);
+  return join33(INDEXER_MAIN_RUN_STORE_ROOT, "partition-convergence", `${digestName(attemptDigest)}.json`);
 }
 function jsonContent(value) {
   const canonical = canonicalIndexerJson(value);
@@ -79866,7 +79885,7 @@ function jsonContent(value) {
 }
 async function readMaybe3(projectRoot, path2) {
   try {
-    return await readFile30(join32(projectRoot, path2), "utf8");
+    return await readFile30(join33(projectRoot, path2), "utf8");
   } catch (error) {
     if (error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT") {
       return;
@@ -79951,7 +79970,7 @@ async function currentLedger(projectRoot) {
 async function currentSpec(input) {
   return reuseCommandFileRead({
     key: "validated-main-run-spec",
-    paths: [join32(input.projectRoot, runSpecPath(input.request_digest))],
+    paths: [join33(input.projectRoot, runSpecPath(input.request_digest))],
     read: async () => {
       const value = await readJsonMaybe(input.projectRoot, runSpecPath(input.request_digest));
       if (value === undefined)
@@ -80039,8 +80058,8 @@ var init_indexerMainRunStoreRecords = __esm(() => {
   init_src2();
   init_durableSingleFileTransaction();
   init_durableMultiFileTransaction();
-  INDEXER_MAIN_RUN_STORE_ROOT = join32(".tmp", "context-runtime", "indexer", "main-index");
-  INDEXER_MAIN_RUN_CURRENT_PATH = join32(INDEXER_MAIN_RUN_STORE_ROOT, "current.json");
+  INDEXER_MAIN_RUN_STORE_ROOT = join33(".tmp", "context-runtime", "indexer", "main-index");
+  INDEXER_MAIN_RUN_CURRENT_PATH = join33(INDEXER_MAIN_RUN_STORE_ROOT, "current.json");
 });
 
 // src/project/indexerPartitionConvergenceStore.ts
@@ -80058,7 +80077,7 @@ var init_indexerMainRunBatchStore = __esm(() => {
 });
 
 // src/project/indexerMainRunStore.ts
-import { join as join33 } from "node:path";
+import { join as join34 } from "node:path";
 async function readAcceptedMainResultRecordsUnlocked(projectRoot, stage, allowPending = false) {
   await recoverDurableMultiFileTransactions(projectRoot);
   const ledger = await currentLedger(projectRoot);
@@ -80075,7 +80094,7 @@ async function readAcceptedMainResultRecordsUnlocked(projectRoot, stage, allowPe
     paths: [INDEXER_MAIN_RUN_CURRENT_PATH, ...ledger.entries.filter((entry) => entry.state === "accepted").flatMap((entry) => [
       runSpecPath(entry.execution_request_digest),
       acceptedCachePath(entry.execution_request_digest)
-    ])].map((path2) => join33(projectRoot, path2)),
+    ])].map((path2) => join34(projectRoot, path2)),
     read: async () => {
       const records = [];
       for (const entry of ledger.entries) {
@@ -80124,7 +80143,7 @@ var init_indexerMainRunStore = __esm(() => {
 import { execFile as execFile5 } from "node:child_process";
 import { promisify as promisify5 } from "node:util";
 import { readFile as readFile31 } from "node:fs/promises";
-import { basename as basename6, join as join34 } from "node:path";
+import { basename as basename6, join as join35 } from "node:path";
 function productionDocumentSkeleton(path2, markdown) {
   const lines = markdown.split(/\r?\n/u);
   let title;
@@ -80204,7 +80223,7 @@ This entire source is explicitly excluded from every selected requirement; no in
       if (selected.length !== 1)
         throw new TypeError(`Source must identify one registered input: ${scope2}`);
       const entry = selected[0];
-      const root = join34(input.projectRoot, entry.materializedAt);
+      const root = join35(input.projectRoot, entry.materializedAt);
       if (type === "repo") {
         const repo = registry2.repos.find((repo2) => repo2.id === name3 || repo2.name === name3);
         if (!/^[a-f0-9]{40}(?:[a-f0-9]{24})?$/u.test(repo.ref))
@@ -80255,7 +80274,7 @@ This entire source is explicitly excluded from every selected requirement; no in
       }
       const managed = type === "note" || type === "sessions";
       const manifestPath = "snapshot" in entry ? entry.snapshot?.manifest : undefined;
-      const paths = managed ? [basename6(entry.materializedAt)] : parseDocumentSnapshotForSource(JSON.parse(await readFile31(join34(input.projectRoot, manifestPath ?? `${entry.materializedAt}/manifest.json`), "utf8")), entry.name).files.map((file) => file.path);
+      const paths = managed ? [basename6(entry.materializedAt)] : parseDocumentSnapshotForSource(JSON.parse(await readFile31(join35(input.projectRoot, manifestPath ?? `${entry.materializedAt}/manifest.json`), "utf8")), entry.name).files.map((file) => file.path);
       const overviews = [];
       const included = paths.filter((path2) => !sourceExcludes(input.requirements, scope2, path2));
       for (const path2 of included) {
@@ -80616,9 +80635,9 @@ var init_productionArticle = __esm(() => {
 
 // src/project/productionRepairDraft.ts
 import { readFile as readFile32 } from "node:fs/promises";
-import { join as join35 } from "node:path";
+import { join as join36 } from "node:path";
 function draftPath(stage, task) {
-  return join35(productionStageDirectory(stage), "repair-drafts", `${task.id}.json`);
+  return join36(productionStageDirectory(stage), "repair-drafts", `${task.id}.json`);
 }
 async function retainProductionRepairDraft(input) {
   if (!input.files.content || !input.files.references)
@@ -80659,7 +80678,7 @@ var init_productionRepairDraft = __esm(() => {
 
 // src/project/productionSubmission.ts
 import { readFile as readFile33 } from "node:fs/promises";
-import { join as join36 } from "node:path";
+import { join as join37 } from "node:path";
 function submissionStateError(reason, message, command = "context status --format json") {
   return new ContextError(ExitCode.WorkspaceStateError, message, {
     category: ErrorCategory.WorkspaceStateInvalid,
@@ -80697,7 +80716,7 @@ async function completeProductionSubmission(input) {
     if (!stage || stage.id !== input.stage)
       throw submissionStateError("stale-production-stage", "Task stage no longer exists. Start a new production run; do not reuse a stale submission.");
     if (!stage.report_approved)
-      throw submissionStateError("production-report-approval-required", "Present the planned report and wait for user feedback before submitting bulk writing.");
+      throw submissionStateError("production-report-approval-required", "Present the planned report and apply context.gate.work_start_scope before submitting bulk writing.");
     if (stage.delivery)
       throw submissionStateError("production-delivery-paused", "Writing is paused for delivery. Finish Review and build, or run context run --resume-writing --format json; existing task inputs remain valid.");
     if ((await readMaintenance(input.projectRoot)).active)
@@ -80716,7 +80735,7 @@ async function completeProductionSubmission(input) {
       byPath.set(key, [...byPath.get(key) ?? [], candidate]);
       byArticle.set(candidate.article_id, [...byArticle.get(candidate.article_id) ?? [], candidate]);
     }
-    const manifestPath = join36(productionStageDirectory(stage.id), "manifest.json");
+    const manifestPath = join37(productionStageDirectory(stage.id), "manifest.json");
     const manifestText = snapshot.content;
     const baselines = new Map;
     let sourceReader;
@@ -80908,9 +80927,9 @@ var init_productionSubmission = __esm(() => {
 // src/project/productionExistingArticles.ts
 import { constants as constants5 } from "node:fs";
 import { open as open4 } from "node:fs/promises";
-import { join as join37 } from "node:path";
+import { join as join38 } from "node:path";
 async function readerHeader(root, path2) {
-  const absolute = await safeProjectTarget(root, join37("knowledge", path2));
+  const absolute = await safeProjectTarget(root, join38("knowledge", path2));
   const handle = await open4(absolute, constants5.O_RDONLY | constants5.O_NOFOLLOW | constants5.O_NONBLOCK);
   try {
     if (!(await handle.stat()).isFile())
@@ -81031,7 +81050,7 @@ async function resolveProductionExclusions(requirements, readBaseline) {
 // src/project/productionPlanning.ts
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { readFile as readFile34, access as access3 } from "node:fs/promises";
-import { join as join38 } from "node:path";
+import { join as join39 } from "node:path";
 function refreshRequired(stage, message) {
   return new ContextError(ExitCode.UserError, message, {
     category: ErrorCategory.UserInputInvalid,
@@ -81050,9 +81069,9 @@ async function productionPlanningIsPrepared(root, stage) {
   try {
     const directory = productionStageDirectory(stage.id);
     const current2 = await productionPlanningRequest(root);
-    const supplied = import_yaml27.default.parse(await readFile34(await safeProjectTarget(root, join38(directory, "shared/requirements.md")), "utf8"));
-    await access3(await safeProjectTarget(root, join38(directory, "planning.md")));
-    await access3(await safeProjectTarget(root, join38(directory, "planning.schema.json")));
+    const supplied = import_yaml27.default.parse(await readFile34(await safeProjectTarget(root, join39(directory, "shared/requirements.md")), "utf8"));
+    await access3(await safeProjectTarget(root, join39(directory, "planning.md")));
+    await access3(await safeProjectTarget(root, join39(directory, "planning.schema.json")));
     return !!current2 && current2.revision === indexerProtocolDigest(supplied);
   } catch (error) {
     if (error.code === "ENOENT")
@@ -81063,7 +81082,7 @@ async function productionPlanningIsPrepared(root, stage) {
 async function productionRequirementsAreCurrent(root, stage) {
   try {
     const current2 = await productionPlanningRequest(root);
-    const supplied = import_yaml27.default.parse(await readFile34(await safeProjectTarget(root, join38(productionStageDirectory(stage.id), "shared/requirements.md")), "utf8"));
+    const supplied = import_yaml27.default.parse(await readFile34(await safeProjectTarget(root, join39(productionStageDirectory(stage.id), "shared/requirements.md")), "utf8"));
     return !!current2 && current2.revision === indexerProtocolDigest(supplied);
   } catch (error) {
     if (error.code !== "ENOENT")
@@ -81122,17 +81141,17 @@ Restore the authorized source and retry preparation.
       gaps: prepared.gaps
     });
     const directory = productionStageDirectory(stage.id);
-    await writeProductionProjection(input.projectRoot, join38(directory, "planning.schema.json"), `${JSON.stringify(zodToJsonSchema(productionPlanInputSchema), null, 2)}
+    await writeProductionProjection(input.projectRoot, join39(directory, "planning.schema.json"), `${JSON.stringify(zodToJsonSchema(productionPlanInputSchema), null, 2)}
 `);
-    await writeProductionProjection(input.projectRoot, join38(directory, "planning.md"), [
+    await writeProductionProjection(input.projectRoot, join39(directory, "planning.md"), [
       "# Investigate and plan",
       "",
-      `Requirements: ${join38(directory, "shared/requirements.md")}`,
-      `Submission schema: ${join38(directory, "planning.schema.json")}`,
-      `Existing reader topics: ${join38(directory, "guidance/existing-articles.md")}`,
+      `Requirements: ${join39(directory, "shared/requirements.md")}`,
+      `Submission schema: ${join39(directory, "planning.schema.json")}`,
+      `Existing reader topics: ${join39(directory, "guidance/existing-articles.md")}`,
       `Stage: ${stage.id}`,
       "",
-      ...scopes.map((scope2) => `- ${scope2.scope}: ${join38(directory, productionSourceFile(scope2.scope))}`),
+      ...scopes.map((scope2) => `- ${scope2.scope}: ${join39(directory, productionSourceFile(scope2.scope))}`),
       "",
       "Use code skeletons and document outlines to identify the authorized capability families and document tasks, then selectively read full material to decide reader topics. Navigation is not a complete feature inventory. Keep unchecked scope pending; do not parse all code or maintain per-symbol disposition just to plan.",
       "Configured sources are the knowledge workspace coverage boundary, not a new investigation assignment on every request. First distinguish the user's current task, its actual source dependencies, and unrelated configured sources. Reuse approved content; a source-level pending entry alone does not prove missing knowledge or require new articles.",
@@ -81212,7 +81231,7 @@ async function submitProductionPlan(input) {
       }
       const prior = candidates.find((candidate) => candidate.path === article.path);
       const formal = approved.byPath.get(article.path);
-      const markdown = prior?.body ?? (formal ? await readFile34(await safeProjectTarget(input.projectRoot, join38("knowledge", formal.path)), "utf8") : undefined);
+      const markdown = prior?.body ?? (formal ? await readFile34(await safeProjectTarget(input.projectRoot, join39("knowledge", formal.path)), "utf8") : undefined);
       const sections = prior?.indexer_candidate?.sections.map((section) => ({ id: section.section_key, references: section.references })) ?? formal?.sections;
       const task = {
         id: identities.get(article.path),
@@ -81305,7 +81324,7 @@ var init_productionPlanning = __esm(() => {
 
 // src/project/productionDeliveryScope.ts
 import { readFile as readFile35 } from "node:fs/promises";
-import { join as join39, posix as posix2 } from "node:path";
+import { join as join40, posix as posix2 } from "node:path";
 async function productionDeliverableArticles(root, phase = "delivery") {
   return withProductionFeedback({ operation: "delivery-scope" }, async () => {
     const stage = await readProductionStage(root);
@@ -81332,7 +81351,7 @@ async function productionDeliverableArticles(root, phase = "delivery") {
     if (phase === "review")
       return [...selected.values()];
     for (const article of selected.values()) {
-      const markdown = await readFile35(await safeProjectTarget(root, join39("knowledge", article.path)), "utf8");
+      const markdown = await readFile35(await safeProjectTarget(root, join40("knowledge", article.path)), "utf8");
       for (const link of markdownReaderLinks(markdown)) {
         if (link.image || /^(?:[a-z][a-z\d+.-]*:|\/|#)/iu.test(link.target))
           continue;
@@ -81348,7 +81367,7 @@ async function productionDeliverableArticles(root, phase = "delivery") {
         if (path2.startsWith("../") || unresolved.has(path2) || !formal.byPath.has(path2)) {
           throw new TypeError(`Partial delivery needs its linked approved article: ${article.path} → ${path2}. Finish that article's Review before delivery.`);
         }
-        await readFile35(await safeProjectTarget(root, join39("knowledge", path2)), "utf8");
+        await readFile35(await safeProjectTarget(root, join40("knowledge", path2)), "utf8");
       }
     }
     return [...selected.values()];
@@ -81367,9 +81386,9 @@ var init_productionDeliveryScope = __esm(() => {
 
 // src/project/siteTheme.ts
 import { mkdir as mkdir17, readFile as readFile36, writeFile as writeFile11 } from "node:fs/promises";
-import { dirname as dirname20, join as join40 } from "node:path";
+import { dirname as dirname20, join as join41 } from "node:path";
 async function resolveSiteTheme(root, overrides, scaffold = false) {
-  const path2 = join40(root, SITE_THEME_FILE);
+  const path2 = join41(root, SITE_THEME_FILE);
   let file = {};
   try {
     file = siteThemeSchema.parse(JSON.parse(await readFile36(path2, "utf8")));
@@ -81470,10 +81489,10 @@ import { createHash as createHash11 } from "node:crypto";
 import { execFile as execFile7 } from "node:child_process";
 import { promisify as promisify7 } from "node:util";
 import { readFile as readFile37, lstat as lstat6, readdir as readdir9, realpath as realpath6 } from "node:fs/promises";
-import { join as join41 } from "node:path";
+import { join as join42 } from "node:path";
 async function optionalWorkspaceText(root, path2) {
   try {
-    return await readFile37(join41(root, path2), "utf8");
+    return await readFile37(join42(root, path2), "utf8");
   } catch (error) {
     if (error.code === "ENOENT")
       return;
@@ -81485,7 +81504,7 @@ async function readWorkspaceChangelog(root) {
   return value === undefined ? [] : ledgerSchema.parse(import_yaml28.parse(value)).entries;
 }
 async function workspaceVersion(root) {
-  const manifest = JSON.parse(await readFile37(join41(root, "package.json"), "utf8"));
+  const manifest = JSON.parse(await readFile37(join42(root, "package.json"), "utf8"));
   return semver.parse(manifest.version ?? "0.0.0");
 }
 function excluded(path2) {
@@ -81506,7 +81525,7 @@ async function workspaceContentSnapshot(root) {
   if (paths === undefined) {
     const discovered = [];
     const visit3 = async (dir) => {
-      for (const entry of await readdir9(join41(root, dir), { withFileTypes: true })) {
+      for (const entry of await readdir9(join42(root, dir), { withFileTypes: true })) {
         const path2 = dir ? `${dir}/${entry.name}` : entry.name;
         if (excluded(path2))
           continue;
@@ -81523,9 +81542,9 @@ async function workspaceContentSnapshot(root) {
   for (const path2 of [...new Set(paths)].filter((path3) => !excluded(path3)).sort()) {
     let bytes;
     try {
-      if (!(await lstat6(join41(root, path2))).isFile())
+      if (!(await lstat6(join42(root, path2))).isFile())
         continue;
-      bytes = await readFile37(join41(root, path2));
+      bytes = await readFile37(join42(root, path2));
     } catch (error) {
       if (error.code === "ENOENT")
         continue;
@@ -81610,7 +81629,7 @@ async function recordWorkspaceVersion(root, value) {
     const { expected_digest: _, base_ref: _base, ...fields } = input;
     const entry = changelogEntrySchema.parse({ ...fields, date: new Date().toISOString(), ...actor ? { actor } : {} });
     const entries = [entry, ...amend ? previousEntries.slice(1) : previousEntries];
-    const manifest = JSON.parse(await readFile37(join41(root, "package.json"), "utf8"));
+    const manifest = JSON.parse(await readFile37(join42(root, "package.json"), "utf8"));
     manifest.version = entry.version;
     const writes = {
       "package.json": JSON.stringify(manifest, null, 2) + `
@@ -81625,7 +81644,7 @@ async function recordWorkspaceVersion(root, value) {
     targets.sort((a2, b2) => a2.path < b2.path ? -1 : a2.path > b2.path ? 1 : 0);
     await runDurableMultiFileTransaction({ projectRoot: root, kind: "record-workspace-version", proposal_digest: hash2(writes), targets });
     try {
-      await atomicWriteFile(join41(root, VERSION_CHECKPOINT), JSON.stringify({ version: entry.version, digest: status.content_digest }) + `
+      await atomicWriteFile(join42(root, VERSION_CHECKPOINT), JSON.stringify({ version: entry.version, digest: status.content_digest }) + `
 `);
     } catch {}
     return { version: entry.version, next_action: { command: "context status --format json" } };
@@ -81664,7 +81683,7 @@ __export(exports_workspacePreparation, {
   PREPARATION_ROOTS: () => PREPARATION_ROOTS
 });
 import { lstat as lstat7, readFile as readFile38, readdir as readdir10 } from "node:fs/promises";
-import { join as join42 } from "node:path";
+import { join as join43 } from "node:path";
 function failure(reason, message, next) {
   throw new ContextError(ExitCode.WorkspaceStateError, message, {
     category: ErrorCategory.WorkspaceStateInvalid,
@@ -81676,7 +81695,7 @@ async function entries(root, path2) {
   await safeProjectTarget(root, path2);
   let stat8;
   try {
-    stat8 = await lstat7(join42(root, path2));
+    stat8 = await lstat7(join43(root, path2));
   } catch (error) {
     if (error.code === "ENOENT")
       return [];
@@ -81689,8 +81708,8 @@ async function entries(root, path2) {
   if (!stat8.isDirectory())
     failure("preparation-file-type", `Unsupported task-state file: ${path2}`, "Inspect this file before preparing the workspace.");
   const result = [];
-  for (const name3 of (await readdir10(join42(root, path2))).sort())
-    result.push(...await entries(root, join42(path2, name3)));
+  for (const name3 of (await readdir10(join43(root, path2))).sort())
+    result.push(...await entries(root, join43(path2, name3)));
   return result;
 }
 async function pendingJournals(root) {
@@ -81698,7 +81717,7 @@ async function pendingJournals(root) {
   const result = [];
   for (const path2 of files.filter((path3) => path3.endsWith("/journal.json") || path3.endsWith(".journal.json"))) {
     try {
-      result.push({ ...JSON.parse(await readFile38(join42(root, path2), "utf8")), path: path2 });
+      result.push({ ...JSON.parse(await readFile38(join43(root, path2), "utf8")), path: path2 });
     } catch {
       result.push({ path: path2 });
     }
@@ -81728,7 +81747,7 @@ async function prepareWorkspace(input) {
     const targets = [];
     for (const directory of PREPARATION_ROOTS)
       for (const path2 of await entries(input.projectRoot, directory)) {
-        const bytes = await readFile38(join42(input.projectRoot, path2));
+        const bytes = await readFile38(join43(input.projectRoot, path2));
         let content3;
         try {
           content3 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes);
@@ -81740,7 +81759,7 @@ async function prepareWorkspace(input) {
     const markerContent = JSON.stringify(taskPreparationRecord("cleared"));
     let oldMarker;
     try {
-      oldMarker = await readFile38(join42(input.projectRoot, TASK_PREPARATION_PATH), "utf8");
+      oldMarker = await readFile38(join43(input.projectRoot, TASK_PREPARATION_PATH), "utf8");
     } catch (error) {
       if (error.code !== "ENOENT")
         throw error;
@@ -81814,14 +81833,14 @@ __export(exports_taskResumption, {
   TASK_PREPARATION_PATH: () => TASK_PREPARATION_PATH
 });
 import { readFile as readFile39 } from "node:fs/promises";
-import { join as join43 } from "node:path";
+import { join as join44 } from "node:path";
 function taskPreparationRecord(state) {
   return { protocol: "context.task-preparation/v1", state };
 }
 async function readTaskPreparation(root) {
   let text7;
   try {
-    text7 = await readFile39(join43(root, TASK_PREPARATION_PATH), "utf8");
+    text7 = await readFile39(join44(root, TASK_PREPARATION_PATH), "utf8");
   } catch (error) {
     if (error.code !== "ENOENT")
       throw error;
@@ -81867,9 +81886,9 @@ var init_taskResumption = __esm(() => {
 
 // src/project/productionCleanup.ts
 import { readFile as readFile40, readdir as readdir11, rm as rm9 } from "node:fs/promises";
-import { join as join44 } from "node:path";
+import { join as join45 } from "node:path";
 async function clearCompletedProduction(root, stage) {
-  const pointerPath = join44(PRODUCTION_STAGES_ROOT, "current.json");
+  const pointerPath = join45(PRODUCTION_STAGES_ROOT, "current.json");
   const pointer = await readFile40(await safeProjectTarget(root, pointerPath), "utf8");
   const current2 = JSON.parse(pointer);
   if (!current2 || typeof current2 !== "object" || !("stage" in current2) || current2.stage !== stage.id) {
@@ -81881,9 +81900,9 @@ async function clearCompletedProduction(root, stage) {
   const entries2 = await readdir11(await safeProjectTarget(root, directory));
   for (const entry of entries2)
     if (entry !== "manifest.json")
-      await remove(join44(directory, entry));
+      await remove(join45(directory, entry));
   const targets = [];
-  for (const path2 of [join44(directory, "manifest.json"), pointerPath]) {
+  for (const path2 of [join45(directory, "manifest.json"), pointerPath]) {
     const content4 = path2 === pointerPath ? pointer : await readFile40(await safeProjectTarget(root, path2), "utf8");
     targets.push({ path: path2, operation: "delete", base_digest: durableContentDigest(content4), target_digest: null });
   }
@@ -81923,7 +81942,7 @@ __export(exports_lifecycleCleanup, {
   clearCompletedLifecycle: () => clearCompletedLifecycle
 });
 import { readdir as readdir12, rm as rm10 } from "node:fs/promises";
-import { join as join45 } from "node:path";
+import { join as join46 } from "node:path";
 async function clearCompletedLifecycle(projectRoot) {
   const production = await readProductionStage(projectRoot);
   if (production) {
@@ -81940,9 +81959,9 @@ async function clearCompletedLifecycle(projectRoot) {
   }
   for (const path2 of COMPLETED_RUNTIME_PATHS) {
     if (path2 !== INDEXER_RUNTIME_ROOT)
-      await rm10(join45(projectRoot, path2), { recursive: true, force: true });
+      await rm10(join46(projectRoot, path2), { recursive: true, force: true });
   }
-  const indexer = join45(projectRoot, INDEXER_RUNTIME_ROOT);
+  const indexer = join46(projectRoot, INDEXER_RUNTIME_ROOT);
   const entries2 = await readdir12(indexer).catch((error) => {
     if (error.code === "ENOENT")
       return [];
@@ -81950,9 +81969,9 @@ async function clearCompletedLifecycle(projectRoot) {
   });
   for (const name3 of entries2)
     if (name3 !== "candidate-compile") {
-      await rm10(join45(indexer, name3), { recursive: true, force: true });
+      await rm10(join46(indexer, name3), { recursive: true, force: true });
     }
-  const compile = join45(indexer, "candidate-compile");
+  const compile = join46(indexer, "candidate-compile");
   const compiled = await readdir12(compile).catch((error) => {
     if (error.code === "ENOENT")
       return [];
@@ -81960,11 +81979,11 @@ async function clearCompletedLifecycle(projectRoot) {
   });
   for (const name3 of compiled)
     if (name3 !== "current.json") {
-      await rm10(join45(compile, name3), { recursive: true, force: true });
+      await rm10(join46(compile, name3), { recursive: true, force: true });
     }
-  await rm10(join45(compile, "current.json"), { force: true });
+  await rm10(join46(compile, "current.json"), { force: true });
   await rm10(indexer, { recursive: true, force: true });
-  await rm10(join45(projectRoot, APPROVED_REVISION_PATH), { force: true });
+  await rm10(join46(projectRoot, APPROVED_REVISION_PATH), { force: true });
   if (production)
     await clearCompletedProduction(projectRoot, production);
 }
@@ -82138,7 +82157,7 @@ var init_indexerRequiredArticleReview = __esm(() => {
 // src/project/partialDelivery.ts
 import { existsSync as existsSync8 } from "node:fs";
 import { readFile as readFile41 } from "node:fs/promises";
-import { join as join46, posix as posix3 } from "node:path";
+import { join as join47, posix as posix3 } from "node:path";
 async function selectPartialDelivery(root) {
   const candidates = await readCandidateRecords(root);
   if (!candidates.some((item) => item.status === "draft"))
@@ -82152,7 +82171,7 @@ async function selectPartialDelivery(root) {
   }
   const pages = [...revision.batch_candidates ?? [], ...revision.candidate ? [revision.candidate] : []].map((item) => ({ path: `knowledge/${item.path}`, ref: item.article_id }));
   const unresolved = new Set(candidates.map((item) => `knowledge/${item.path}`));
-  const approved = pages.filter((item) => !unresolved.has(item.path) && existsSync8(join46(root, item.path)));
+  const approved = pages.filter((item) => !unresolved.has(item.path) && existsSync8(join47(root, item.path)));
   if (approved.length === 0)
     return;
   await assertIndependentPages(root, approved.map((item) => item.path), unresolved);
@@ -82162,7 +82181,7 @@ async function assertIndependentPages(root, paths, unresolved) {
   for (const path2 of paths) {
     if (unresolved.has(path2))
       throw new TypeError(`Selected delivery page now needs Review: ${path2}. Return to the current Route.`);
-    const markdown = await readFile41(join46(root, path2), "utf8");
+    const markdown = await readFile41(join47(root, path2), "utf8");
     for (const link of markdownReaderLinks(markdown)) {
       if (link.image || /^(?:[a-z][a-z\d+.-]*:|\/|#)/iu.test(link.target))
         continue;
@@ -82173,7 +82192,7 @@ async function assertIndependentPages(root, paths, unresolved) {
         continue;
       }
       const target = posix3.normalize(posix3.join(posix3.dirname(path2), href));
-      if (target.startsWith("knowledge/") && /\.md$/iu.test(target) && (unresolved.has(target) || !existsSync8(join46(root, target)))) {
+      if (target.startsWith("knowledge/") && /\.md$/iu.test(target) && (unresolved.has(target) || !existsSync8(join47(root, target)))) {
         throw new TypeError(`Partial delivery must include its linked page: ${path2} → ${target}. Finish that page's Review/repair, then request delivery again; existing approvals remain.`);
       }
     }
@@ -82201,10 +82220,10 @@ var init_partialDelivery = __esm(() => {
 
 // src/project/revisionDelivery.ts
 import { readFile as readFile42, rm as rm11 } from "node:fs/promises";
-import { join as join47 } from "node:path";
+import { join as join48 } from "node:path";
 async function readRevisionDelivery(root) {
   try {
-    return stateSchema2.parse(JSON.parse(await readFile42(join47(root, FILE), "utf8")));
+    return stateSchema2.parse(JSON.parse(await readFile42(join48(root, FILE), "utf8")));
   } catch (error) {
     if (error.code === "ENOENT")
       return;
@@ -82215,7 +82234,7 @@ function requestRevisionDelivery(root) {
   return withProjectWriteLock(root, "request-revision-delivery", async () => {
     const partial = await selectPartialDelivery(root);
     if (partial) {
-      await atomicWriteFile(join47(root, FILE), JSON.stringify(stateSchema2.parse({ partial, closed: false })) + `
+      await atomicWriteFile(join48(root, FILE), JSON.stringify(stateSchema2.parse({ partial, closed: false })) + `
 `);
       return;
     }
@@ -82233,7 +82252,7 @@ function closeRevisionDelivery(root) {
     const state = await readRevisionDelivery(root);
     if (!state)
       return false;
-    await atomicWriteFile(join47(root, FILE), JSON.stringify({ ...state, closed: true }) + `
+    await atomicWriteFile(join48(root, FILE), JSON.stringify({ ...state, closed: true }) + `
 `);
     return true;
   });
@@ -82241,7 +82260,7 @@ function closeRevisionDelivery(root) {
 function completeRevisionDelivery(root) {
   return withProjectWriteLock(root, "complete-revision-delivery", async () => {
     if ((await readRevisionDelivery(root))?.closed)
-      await rm11(join47(root, FILE), { force: true });
+      await rm11(join48(root, FILE), { force: true });
   });
 }
 var FILE, stateSchema2;
@@ -82256,7 +82275,7 @@ var init_revisionDelivery = __esm(() => {
   init_partialDelivery();
   init_approvedRevision();
   init_candidateLedger();
-  FILE = join47(LIFECYCLE_ROOT, "revision-delivery.json");
+  FILE = join48(LIFECYCLE_ROOT, "revision-delivery.json");
   stateSchema2 = exports_external.object({
     partial: exports_external.object({
       kind: exports_external.literal("revision"),
@@ -82269,7 +82288,7 @@ var init_revisionDelivery = __esm(() => {
 
 // src/project/approvedKnowledgeSnapshots.ts
 import { readFile as readFile43 } from "node:fs/promises";
-import { join as join48 } from "node:path";
+import { join as join49 } from "node:path";
 function approvedKnowledgeSnapshotsFromStructure(structure) {
   return validateArticleStructureEntries(structure?.articles ?? []);
 }
@@ -82278,7 +82297,7 @@ async function prepareApprovedKnowledgeSnapshotTarget(input) {
     return;
   let before;
   try {
-    before = await readFile43(join48(input.projectRoot, STRUCTURE_PATH2), "utf8");
+    before = await readFile43(join49(input.projectRoot, STRUCTURE_PATH2), "utf8");
   } catch (error) {
     if (error.code !== "ENOENT")
       throw error;
@@ -82341,7 +82360,7 @@ import {
   unlinkSync,
   writeFileSync as writeFileSync2
 } from "node:fs";
-import { dirname as dirname21, join as join49 } from "node:path";
+import { dirname as dirname21, join as join50 } from "node:path";
 function isRecord10(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -82359,7 +82378,7 @@ function parseEvent(value) {
   };
 }
 function runtimeEventOutboxPath(projectRoot) {
-  return join49(projectRoot, OUTBOX_RELATIVE_PATH);
+  return join50(projectRoot, OUTBOX_RELATIVE_PATH);
 }
 function readRuntimeEventOutboxFile(path2) {
   if (!existsSync9(path2))
@@ -82490,7 +82509,7 @@ function acknowledgeRuntimeEventOutbox(projectRoot, eventIds) {
 }
 var OUTBOX_EVENT_SCHEMA = "context.runtime-event-outbox.event.v1", OUTBOX_ACK_SCHEMA = "context.runtime-event-outbox.ack.v1", OUTBOX_RELATIVE_PATH, OUTBOX_LOCK_STALE_MS = 30000, OUTBOX_LOCK_RETRY_MS = 10, OUTBOX_LOCK_RETRIES = 100;
 var init_runtimeEventOutbox = __esm(() => {
-  OUTBOX_RELATIVE_PATH = join49(".tmp", "context-runtime", "logs", "outbox.jsonl");
+  OUTBOX_RELATIVE_PATH = join50(".tmp", "context-runtime", "logs", "outbox.jsonl");
 });
 
 // src/runtimeEvents.ts
@@ -82503,7 +82522,7 @@ import {
   writeFileSync as writeFileSync3
 } from "node:fs";
 import { spawn as spawn2 } from "node:child_process";
-import { dirname as dirname22, join as join50 } from "node:path";
+import { dirname as dirname22, join as join51 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 function isRecord11(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -82606,7 +82625,7 @@ function readRuntimePackageMetadata() {
   try {
     let dir = dirname22(fileURLToPath3(import.meta.url));
     for (let index2 = 0;index2 < 8; index2++) {
-      const packagePath = join50(dir, "package.json");
+      const packagePath = join51(dir, "package.json");
       if (existsSync10(packagePath)) {
         const parsed = JSON.parse(readFileSync5(packagePath, "utf8"));
         if (isRecord11(parsed)) {
@@ -82743,7 +82762,7 @@ function dispatchCommand(sink, batch, cwd) {
   });
 }
 function runtimeEventStatePath(cwd) {
-  return join50(cwd, ".tmp", "context-runtime", RUNTIME_EVENT_STATE_FILE);
+  return join51(cwd, ".tmp", "context-runtime", RUNTIME_EVENT_STATE_FILE);
 }
 function readRuntimeEventState(cwd) {
   try {
@@ -83099,10 +83118,10 @@ var init_approvedStructureInputHash = () => {};
 
 // src/project/verifyApprovedStructure.ts
 import { existsSync as existsSync11 } from "node:fs";
-import { join as join51 } from "node:path";
+import { join as join52 } from "node:path";
 async function validateApprovedStructure(input) {
   const issue = (code, path3, message) => input.issues.push({ severity: "error", code, path: path3, message });
-  const path2 = join51(input.projectRoot, STRUCTURE_PATH3);
+  const path2 = join52(input.projectRoot, STRUCTURE_PATH3);
   if (!input.structureOverride && !existsSync11(path2))
     return;
   let parsed;
@@ -83170,7 +83189,7 @@ var init_verifyApprovedStructure = __esm(() => {
 import { createHash as createHash13 } from "node:crypto";
 import { existsSync as existsSync12 } from "node:fs";
 import { mkdir as mkdir18, readFile as readFile44, readdir as readdir13, writeFile as writeFile12 } from "node:fs/promises";
-import { dirname as dirname23, join as join52, relative as relative15, resolve as resolve20 } from "node:path";
+import { dirname as dirname23, join as join53, relative as relative15, resolve as resolve20 } from "node:path";
 async function templateFiles(root) {
   if (!existsSync12(root))
     return [];
@@ -83178,7 +83197,7 @@ async function templateFiles(root) {
   const visit3 = async (dir) => {
     const entries2 = await readdir13(dir, { withFileTypes: true });
     for (const entry of entries2) {
-      const absolutePath = join52(dir, entry.name);
+      const absolutePath = join53(dir, entry.name);
       if (entry.isDirectory()) {
         await visit3(absolutePath);
         continue;
@@ -83205,7 +83224,7 @@ function isMarker(value) {
   return marker.schema === PACKAGE_TEMPLATE_REVIEW_SCHEMA && /^sha256:[a-f0-9]{64}$/u.test(marker.starter_digest ?? "") && (marker.disposition === "review-required" || marker.disposition === "starter-accepted");
 }
 async function readMarker(templateRoot) {
-  const markerPath = join52(templateRoot, PACKAGE_TEMPLATE_REVIEW_FILE);
+  const markerPath = join53(templateRoot, PACKAGE_TEMPLATE_REVIEW_FILE);
   if (!existsSync12(markerPath))
     return null;
   try {
@@ -83216,7 +83235,7 @@ async function readMarker(templateRoot) {
   }
 }
 async function writeStarterTemplateReviewMarker(templateRoot) {
-  const markerPath = join52(templateRoot, PACKAGE_TEMPLATE_REVIEW_FILE);
+  const markerPath = join53(templateRoot, PACKAGE_TEMPLATE_REVIEW_FILE);
   if (existsSync12(markerPath))
     return false;
   const marker = {
@@ -83244,7 +83263,7 @@ async function inspectPackageTemplateReview(projectRoot, pkg) {
       packageName: pkg.name,
       templatePath: pkg.template.path,
       state: "invalid",
-      diagnostic: `${join52(pkg.template.path, PACKAGE_TEMPLATE_REVIEW_FILE)} is invalid`
+      diagnostic: `${join53(pkg.template.path, PACKAGE_TEMPLATE_REVIEW_FILE)} is invalid`
     };
   }
   const currentDigest2 = await templateDigest(templateRoot);
@@ -83285,8 +83304,8 @@ async function acceptStarterPackageTemplates(input) {
         alreadyResolved.push(pkg.name);
         continue;
       }
-      const markerPath = join52(input.projectRoot, pkg.template.path, PACKAGE_TEMPLATE_REVIEW_FILE);
-      const marker = await readMarker(join52(input.projectRoot, pkg.template.path));
+      const markerPath = join53(input.projectRoot, pkg.template.path, PACKAGE_TEMPLATE_REVIEW_FILE);
+      const marker = await readMarker(join53(input.projectRoot, pkg.template.path));
       if (marker === null || marker === "invalid") {
         throw new ContextError(ExitCode.WorkspaceStateError, "package template review marker changed before acceptance", {
           category: ErrorCategory.WorkspaceStateInvalid,
@@ -83457,8 +83476,8 @@ function renderAgents(projectName, language) {
       "",
       "## 工作区契约",
       "",
-      "版本以 package.json.version 为准。正式内容变化收尾时通过 context version inspect / record 同步递增版本并生成 changelog.yaml 和 CHANGELOG.md，具体说明由 Agent 根据 diff 和会话撰写。新增模块或扩大知识覆盖升 minor，普通修补、目录和正式状态变化升 patch；major 只由人工明确指定。.tmp 进度不算变化，build 只记录 hash。仅主协调者记录版本，不自动 commit 或发布。触发来源必填；触发用户优先使用会话中明确的飞书显示名，否则由 CLI 读取 Git 用户名。",
-      "版本差异使用 Git 比较正文、结构、资源、导航和模板；可通过 version inspect --base 指定交付 commit/tag。构建预览不锁定版本；复用版本前核对目标平台与 Git tag，已发布版本必须递增。无需维护根目录 Context 版本、构建或发布回执。",
+      "版本以 package.json.version 为准。正式内容变化收尾时通过 context version inspect / record 同步递增版本并生成 changelog.yaml 和 CHANGELOG.md，具体说明由 Agent 根据 diff 和会话撰写。新增模块或扩大知识覆盖升 minor，普通修补、目录和正式状态变化升 patch；major 只由人工明确指定。.tmp 进度不算变化，build 只记录 hash。仅主协调者记录版本；版本记录本身不提交或发布，后续交付按本次授权和已安装的分发技能执行。触发来源必填；触发用户优先使用会话中明确的飞书显示名，否则由 CLI 读取 Git 用户名。",
+      "版本差异使用 Git 比较正文、结构、资源、导航和模板；可通过 version inspect --base 指定交付 commit/tag。构建预览不锁定版本，已发布内容发生变化时必须递增版本。无需维护根目录 Context 版本、构建或发布回执。",
       "每个版本的 Changelog 详情不得超过 1500 字：标题、变更列表、触发来源说明及用户显示名的可见字符合计计数，含标点，不计协议字段名、版本号和日期。超出时由 Agent 在提交前合并同类变化、删除重复过程描述，压缩至上限内；保留主要变化、影响和触发来源，不直接截断，也不把一轮拆成多个版本规避限制。",
       "",
       "- 通过已安装的 Context Skill 开始或恢复工作；直接使用 CLI 时，从 `context status --format json` 开始。",
@@ -83503,8 +83522,8 @@ function renderAgents(projectName, language) {
     "",
     "## Workspace Contract",
     "",
-    "package.json.version is the workspace version. At formal-content completion, use context version inspect / record to increment SemVer and generate changelog.yaml and CHANGELOG.md together. Write descriptions from the diff and conversation. Added modules/coverage increment minor; repairs, navigation and persistent status changes increment patch. Major requires an explicit user instruction. Ignore .tmp progress; build only records hashes. The coordinator alone records versions, without automatic commits or publishing. Triggers are required; use an explicitly known conversational Lark display name, otherwise let CLI use Git user.name.",
-    "Compare bodies, structure, assets, navigation and templates using Git; version inspect --base selects a delivery commit/tag. Preview builds do not seal versions. Check the remote target and Git tags before amending; published versions must increase. No root Context version/build/publication receipts are required.",
+    "package.json.version is the workspace version. At formal-content completion, use context version inspect / record to increment SemVer and generate changelog.yaml and CHANGELOG.md together. Write descriptions from the diff and conversation. Added modules/coverage increment minor; repairs, navigation and persistent status changes increment patch. Major requires an explicit user instruction. Ignore .tmp progress; build only records hashes. The coordinator alone records versions; recording a version does not commit or publish, and later delivery follows this task's authorization and the installed distribution skill. Triggers are required; use an explicitly known conversational Lark display name, otherwise let CLI use Git user.name.",
+    "Compare bodies, structure, assets, navigation and templates using Git; version inspect --base selects a delivery commit/tag. Preview builds do not seal versions. Changes to already published content must increment the version. No root Context version/build/publication receipts are required.",
     "Each version's changelog details must total at most 1500 visible characters, including punctuation across the title, changes, trigger descriptions and user display name; exclude protocol keys, version and date. Before submission, compress longer entries by merging related changes and removing repeated process narration. Preserve the main changes, impact and triggers; never truncate blindly or split one iteration into multiple versions to evade the limit.",
     "",
     "- Start or resume through the installed Context Skill. When using the CLI directly, begin with `context status --format json`.",
@@ -83574,14 +83593,14 @@ __export(exports_workspace, {
 import { existsSync as existsSync13, readFileSync as readFileSync6, statSync as statSync3 } from "node:fs";
 import { mkdir as mkdir19, readFile as readFile45, readdir as readdir14, writeFile as writeFile13 } from "node:fs/promises";
 import { createRequire as createRequire4 } from "node:module";
-import { basename as basename7, dirname as dirname24, isAbsolute as isAbsolute12, join as join53, parse as parse9, relative as relative16, resolve as resolve21 } from "node:path";
+import { basename as basename7, dirname as dirname24, isAbsolute as isAbsolute12, join as join54, parse as parse9, relative as relative16, resolve as resolve21 } from "node:path";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 import { createJiti } from "jiti";
 function isRecord12(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function readPackageJson(root) {
-  const packagePath = join53(root, "package.json");
+  const packagePath = join54(root, "package.json");
   if (!existsSync13(packagePath))
     return null;
   try {
@@ -83605,22 +83624,22 @@ function resolveExportImportTarget(packageJsonPath) {
     return null;
   const exportsField = parsed.exports;
   if (typeof exportsField === "string") {
-    return join53(dirname24(packageJsonPath), exportsField);
+    return join54(dirname24(packageJsonPath), exportsField);
   }
   if (isRecord12(exportsField)) {
     const rootExport = exportsField["."];
     if (typeof rootExport === "string") {
-      return join53(dirname24(packageJsonPath), rootExport);
+      return join54(dirname24(packageJsonPath), rootExport);
     }
     if (isRecord12(rootExport) && typeof rootExport.import === "string") {
-      return join53(dirname24(packageJsonPath), rootExport.import);
+      return join54(dirname24(packageJsonPath), rootExport.import);
     }
   }
   if (typeof parsed.module === "string") {
-    return join53(dirname24(packageJsonPath), parsed.module);
+    return join54(dirname24(packageJsonPath), parsed.module);
   }
   if (typeof parsed.main === "string") {
-    return join53(dirname24(packageJsonPath), parsed.main);
+    return join54(dirname24(packageJsonPath), parsed.main);
   }
   return null;
 }
@@ -83638,7 +83657,7 @@ function resolveContextSdkImportAlias(entryPath) {
 function readCurrentPackageVersion() {
   let dir = dirname24(fileURLToPath4(import.meta.url));
   for (let index2 = 0;index2 < 8; index2++) {
-    const packagePath = join53(dir, "package.json");
+    const packagePath = join54(dir, "package.json");
     if (existsSync13(packagePath)) {
       const parsed = readPackageJson(dir);
       if (typeof parsed?.version === "string" && parsed.version.trim().length > 0) {
@@ -83821,7 +83840,7 @@ async function listStaticTemplateFiles(root, dir = root) {
   const entries2 = await readdir14(dir, { withFileTypes: true });
   const files = [];
   for (const entry of entries2) {
-    const absolutePath = join53(dir, entry.name);
+    const absolutePath = join54(dir, entry.name);
     if (entry.isDirectory()) {
       files.push(...await listStaticTemplateFiles(root, absolutePath));
       continue;
@@ -83838,7 +83857,7 @@ async function listStaticTemplateFiles(root, dir = root) {
 function resolveContextPackageTemplatesRoot() {
   try {
     const packageJsonPath = createRequire4(import.meta.url).resolve("@c4a/context/package.json");
-    const templateRoot = join53(dirname24(packageJsonPath), "templates", "package-templates");
+    const templateRoot = join54(dirname24(packageJsonPath), "templates", "package-templates");
     if (existsSync13(templateRoot))
       return templateRoot;
   } catch {}
@@ -83850,7 +83869,7 @@ function resolveContextPackageTemplatesRoot() {
 }
 async function writeDefaultPackageTemplates(projectRoot, result, language) {
   const defaultRoot = resolveContextPackageTemplatesRoot();
-  const templateRoot = language === "zh-CN" ? join53(dirname24(defaultRoot), "package-templates.zh-CN") : defaultRoot;
+  const templateRoot = language === "zh-CN" ? join54(dirname24(defaultRoot), "package-templates.zh-CN") : defaultRoot;
   if (!existsSync13(templateRoot)) {
     throw new ContextError(ExitCode.WorkspaceStateError, `missing ${language} @c4a/context package templates`, {
       category: ErrorCategory.WorkspaceStateInvalid,
@@ -83860,15 +83879,15 @@ async function writeDefaultPackageTemplates(projectRoot, result, language) {
   }
   const files = await listStaticTemplateFiles(templateRoot);
   for (const file of files) {
-    await writeIfMissing(join53(projectRoot, "src", "package-templates", ...file.relativePath.split("/")), await readFile45(file.absolutePath, "utf8"), result);
+    await writeIfMissing(join54(projectRoot, "src", "package-templates", ...file.relativePath.split("/")), await readFile45(file.absolutePath, "utf8"), result);
   }
   const templateKinds = [...new Set(files.map((file) => file.relativePath.split("/")[0]).filter((value) => value !== undefined && value.length > 0))];
   for (const templateKind of templateKinds) {
-    const root = join53(projectRoot, "src", "package-templates", templateKind);
+    const root = join54(projectRoot, "src", "package-templates", templateKind);
     if (await writeStarterTemplateReviewMarker(root)) {
-      result.created.push(join53(root, PACKAGE_TEMPLATE_REVIEW_FILE));
+      result.created.push(join54(root, PACKAGE_TEMPLATE_REVIEW_FILE));
     } else {
-      result.kept.push(join53(root, PACKAGE_TEMPLATE_REVIEW_FILE));
+      result.kept.push(join54(root, PACKAGE_TEMPLATE_REVIEW_FILE));
     }
   }
 }
@@ -83958,23 +83977,23 @@ async function initContextProject(input) {
     kept: []
   };
   for (const dir of PROJECT_DIRS) {
-    await mkdir19(join53(projectRoot, dir), { recursive: true });
+    await mkdir19(join54(projectRoot, dir), { recursive: true });
   }
   for (const dir of PROJECT_SCRATCH_DIRS) {
-    await mkdir19(join53(projectRoot, dir), { recursive: true });
+    await mkdir19(join54(projectRoot, dir), { recursive: true });
   }
-  await mkdir19(join53(projectRoot, "sources", "repo"), { recursive: true });
-  await mkdir19(join53(projectRoot, "sources", "file"), { recursive: true });
-  await mkdir19(join53(projectRoot, "sources", "lark"), { recursive: true });
-  await writeIfMissing(join53(projectRoot, "package.json"), renderPackageJson(projectName, readCurrentPackageVersion(), input.dev, language, input.debug), result);
-  await writeIfMissing(join53(projectRoot, "src", "index.ts"), renderProjectEntry(language), result);
+  await mkdir19(join54(projectRoot, "sources", "repo"), { recursive: true });
+  await mkdir19(join54(projectRoot, "sources", "file"), { recursive: true });
+  await mkdir19(join54(projectRoot, "sources", "lark"), { recursive: true });
+  await writeIfMissing(join54(projectRoot, "package.json"), renderPackageJson(projectName, readCurrentPackageVersion(), input.dev, language, input.debug), result);
+  await writeIfMissing(join54(projectRoot, "src", "index.ts"), renderProjectEntry(language), result);
   await writeDefaultPackageTemplates(projectRoot, result, language);
-  await writeIfMissing(join53(projectRoot, "sources", "repo", "index.yaml"), renderRepoIndex(), result);
-  await writeIfMissing(join53(projectRoot, "sources", "file", "index.yaml"), renderFileIndex(), result);
-  await writeIfMissing(join53(projectRoot, "sources", "lark", "index.yaml"), renderLarkIndex(), result);
-  await writeIfMissing(join53(projectRoot, ".gitignore"), renderGitignore(), result);
-  await writeIfMissing(join53(projectRoot, "README.md"), renderReadme(projectName, language), result);
-  await writeIfMissing(join53(projectRoot, "AGENTS.md"), renderAgents(projectName, language), result);
+  await writeIfMissing(join54(projectRoot, "sources", "repo", "index.yaml"), renderRepoIndex(), result);
+  await writeIfMissing(join54(projectRoot, "sources", "file", "index.yaml"), renderFileIndex(), result);
+  await writeIfMissing(join54(projectRoot, "sources", "lark", "index.yaml"), renderLarkIndex(), result);
+  await writeIfMissing(join54(projectRoot, ".gitignore"), renderGitignore(), result);
+  await writeIfMissing(join54(projectRoot, "README.md"), renderReadme(projectName, language), result);
+  await writeIfMissing(join54(projectRoot, "AGENTS.md"), renderAgents(projectName, language), result);
   if (input.debug === true)
     await enableContextDebug(projectRoot, "init");
   return result;
@@ -83988,7 +84007,7 @@ async function loadContextProjectModule(root) {
       next: "Ensure package.json declares context.project=true and context.entry points to src/index.ts, then rerun the command."
     });
   }
-  const entryPath = join53(root, projectConfig.entry);
+  const entryPath = join54(root, projectConfig.entry);
   const jiti = createJiti(entryPath, {
     alias: {
       "@c4a/context": resolveContextSdkImportAlias(entryPath)
@@ -84058,7 +84077,7 @@ var init_workspace = __esm(() => {
   init_debugTrace();
   init_projectModulePolicy();
   PROJECT_DIRS = ["src", "sources", "knowledge", "dist"];
-  PROJECT_SCRATCH_DIRS = [join53(".tmp", "agent-payloads")];
+  PROJECT_SCRATCH_DIRS = [join54(".tmp", "agent-payloads")];
   PROJECT_LANGUAGES = ["en", "zh-CN"];
 });
 
@@ -84156,7 +84175,7 @@ var init_verifyDiagnostics = __esm(() => {
 
 // src/project/verify.ts
 import { existsSync as existsSync14 } from "node:fs";
-import { join as join54 } from "node:path";
+import { join as join55 } from "node:path";
 function evidenceStatusForIssues(issues) {
   if (issues.some((issue) => issue.severity === "error"))
     return "fail";
@@ -84230,7 +84249,7 @@ async function verifyProjectWorkspace(projectRoot, options = {}) {
       pageRelPath: `knowledge/${file.relPath}`,
       content: content3
     })) {
-      if (!existsSync14(join54(projectRoot, assetPath))) {
+      if (!existsSync14(join55(projectRoot, assetPath))) {
         issues.push({
           severity: "error",
           code: "approved-resource-missing",
@@ -84367,7 +84386,7 @@ __export(exports_close, {
 });
 import { existsSync as existsSync15 } from "node:fs";
 import { mkdir as mkdir20, writeFile as writeFile14 } from "node:fs/promises";
-import { dirname as dirname25, join as join55 } from "node:path";
+import { dirname as dirname25, join as join56 } from "node:path";
 function parseFrontmatter4(content3) {
   const match = /^---\r?\n([\s\S]*?)\r?\n---/u.exec(content3);
   if (match?.[1] === undefined)
@@ -84431,7 +84450,7 @@ async function deriveApprovedStructure(projectRoot) {
 }
 async function writeApprovedStructureProjection(projectRoot) {
   const { inputHash, structure, compactFiles } = await deriveApprovedStructure(projectRoot);
-  const outputPath = join55(projectRoot, STRUCTURE_PATH4);
+  const outputPath = join56(projectRoot, STRUCTURE_PATH4);
   await mkdir20(dirname25(outputPath), { recursive: true });
   await writeFile14(outputPath, import_yaml30.default.stringify(structure), "utf8");
   await Promise.all(compactFiles.map((file) => writeFile14(file.absPath, file.content, "utf8")));
@@ -84442,7 +84461,7 @@ function referencesReceipt() {
 }
 async function readProjectCloseStatus(projectRoot) {
   const approved = await approvedKnowledgeFiles(projectRoot);
-  const structurePath = join55(projectRoot, STRUCTURE_PATH4);
+  const structurePath = join56(projectRoot, STRUCTURE_PATH4);
   if (approved.length === 0 && !existsSync15(structurePath))
     return { state: "missing", diagnostics: [] };
   const inputHash = await approvedKnowledgeInputHash(projectRoot);
@@ -84499,7 +84518,7 @@ async function closeProjectWorkspace(projectRoot) {
         next: "Fix context verify errors, then rerun context close --format json."
       });
     }
-    const outputPath = join55(projectRoot, STRUCTURE_PATH4);
+    const outputPath = join56(projectRoot, STRUCTURE_PATH4);
     await mkdir20(dirname25(outputPath), { recursive: true });
     await writeFile14(outputPath, `${import_yaml30.default.stringify(structure)}`, "utf8");
     await Promise.all(compactFiles.map((file) => writeFile14(file.absPath, file.content, "utf8")));
@@ -84576,7 +84595,7 @@ var init_close = __esm(() => {
   init_knowledgeAssetRepair();
   init_approvedKnowledgeMetadata();
   import_yaml30 = __toESM(require_dist(), 1);
-  STRUCTURE_PATH4 = join55(KNOWLEDGE_ROOT, "structure.yaml");
+  STRUCTURE_PATH4 = join56(KNOWLEDGE_ROOT, "structure.yaml");
 });
 
 // src/project/packageOutputPaths.ts
@@ -84608,7 +84627,7 @@ var init_packageOutputPaths = __esm(() => {
 
 // src/project/packageSiteAddress.ts
 import { readFile as readFile46, writeFile as writeFile15, rename as rename6 } from "node:fs/promises";
-import { join as join56 } from "node:path";
+import { join as join57 } from "node:path";
 function normalizeSiteUrl(value) {
   const url = new URL(value);
   if (!["https:", "http:"].includes(url.protocol) || url.username || url.password || url.search || url.hash) {
@@ -84621,7 +84640,7 @@ async function readPackageSiteUrl(root, pkg) {
   if (pkg.kind !== "package.kb" || !pkg.site)
     return;
   try {
-    const map2 = JSON.parse(await readFile46(join56(root, packageSiteOutputDir(pkg), SITE_MAP_FILE), "utf8"));
+    const map2 = JSON.parse(await readFile46(join57(root, packageSiteOutputDir(pkg), SITE_MAP_FILE), "utf8"));
     return typeof map2.site_url === "string" ? normalizeSiteUrl(map2.site_url) : undefined;
   } catch (error) {
     if (error.code === "ENOENT" || error instanceof SyntaxError || error instanceof TypeError)
@@ -84638,7 +84657,7 @@ async function recordPackageSiteUrl(root, packageName, value) {
     if (!pkg || pkg.kind !== "package.kb" || !pkg.site) {
       throw new TypeError("Select a declared knowledge package with a website");
     }
-    const siteMap = join56(root, packageSiteOutputDir(pkg), SITE_MAP_FILE);
+    const siteMap = join57(root, packageSiteOutputDir(pkg), SITE_MAP_FILE);
     let map2;
     try {
       map2 = JSON.parse(await readFile46(siteMap, "utf8"));
@@ -84652,7 +84671,11 @@ async function recordPackageSiteUrl(root, packageName, value) {
     }
     const content3 = JSON.stringify({ ...map2, site_url: siteUrl }, null, 2) + `
 `;
-    for (const path2 of [siteMap, join56(root, pkg.outDir, SITE_MAP_FILE)]) {
+    for (const path2 of [
+      siteMap,
+      join57(root, pkg.outDir, SITE_MAP_FILE),
+      join57(root, pkg.outDir, packageDistributionMetadataPath(SITE_MAP_FILE))
+    ]) {
       await writeFile15(`${path2}.tmp`, content3);
       await rename6(`${path2}.tmp`, path2);
     }
@@ -84662,6 +84685,7 @@ async function recordPackageSiteUrl(root, packageName, value) {
 var SITE_MAP_FILE = "context-site-map.json";
 var init_packageSiteAddress = __esm(() => {
   init_packageOutputPaths();
+  init_packageDistributionMetadata();
   init_writeLock();
 });
 
@@ -84713,7 +84737,7 @@ var init_productionReviewCandidates = __esm(() => {
 import { createHash as createHash14 } from "node:crypto";
 import { existsSync as existsSync16 } from "node:fs";
 import { readFile as readFile47 } from "node:fs/promises";
-import { join as join57, relative as relative17 } from "node:path";
+import { join as join58, relative as relative17 } from "node:path";
 function parsePackageLinkWarnings(value) {
   if (!Array.isArray(value))
     return [];
@@ -84728,7 +84752,7 @@ async function walkPackageFiles(root) {
     for (const entry of entries2) {
       if (IGNORED_PACKAGE_FS_ENTRIES.has(entry.name))
         continue;
-      const absPath = join57(dir, entry.name);
+      const absPath = join58(dir, entry.name);
       if (entry.isDirectory()) {
         await visit3(absPath);
         continue;
@@ -84759,16 +84783,16 @@ function classifyOutputFile(path2, knowledgeGroups) {
 }
 async function packageOutputSnapshot(projectRoot, pkg, knowledgeGroups, previousOutputs = []) {
   const previousByPath = new Map(previousOutputs.map((file) => [file.path, file]));
-  const files = (await Promise.all(packageOutputDirs(pkg).map(async (output) => (await walkPackageFiles(join57(projectRoot, output))).map((file) => ({
+  const files = (await Promise.all(packageOutputDirs(pkg).map(async (output) => (await walkPackageFiles(join58(projectRoot, output))).map((file) => ({
     ...file,
-    relPath: toPosixPath6(relative17(join57(projectRoot, pkg.outDir), file.absPath))
+    relPath: toPosixPath6(relative17(join58(projectRoot, pkg.outDir), file.absPath))
   }))))).flat();
   return Promise.all(files.map(async (file) => {
     const current2 = classifyOutputFile(file.relPath, knowledgeGroups);
     const previous2 = previousByPath.get(file.relPath);
     const classification = current2.kind === "file" && previous2 !== undefined ? { path: file.relPath, kind: previous2.kind, ...previous2.group === undefined ? {} : { group: previous2.group } } : current2;
     let content3 = await readFile47(file.absPath);
-    if (file.absPath === join57(projectRoot, pkg.outDir, "context-site-map.json") || file.absPath === join57(projectRoot, packageSiteOutputDir(pkg), "context-site-map.json")) {
+    if (file.absPath === join58(projectRoot, pkg.outDir, "context-site-map.json") || file.absPath === join58(projectRoot, pkg.outDir, packageDistributionMetadataPath("context-site-map.json")) || file.absPath === join58(projectRoot, packageSiteOutputDir(pkg), "context-site-map.json")) {
       try {
         const map2 = JSON.parse(content3.toString());
         if (map2.protocol === "context.site-output/v1" && Array.isArray(map2.pages)) {
@@ -84787,8 +84811,8 @@ async function packageOutputFingerprint(projectRoot, pkg, observed) {
   const snapshot = observed ?? await packageOutputSnapshot(projectRoot, pkg, new Map);
   return {
     fingerprint: createHash14("sha256").update(JSON.stringify({
-      outDirExists: existsSync16(join57(projectRoot, pkg.outDir)),
-      siteDirExists: pkg.kind === "package.kb" && pkg.site ? existsSync16(join57(projectRoot, packageSiteOutputDir(pkg))) : undefined,
+      outDirExists: existsSync16(join58(projectRoot, pkg.outDir)),
+      siteDirExists: pkg.kind === "package.kb" && pkg.site ? existsSync16(join58(projectRoot, packageSiteOutputDir(pkg))) : undefined,
       files: snapshot.map(({ path: path2, sha256 }) => ({ path: path2, sha256 }))
     })).digest("hex"),
     files: snapshot.length
@@ -84872,12 +84896,13 @@ var init_packageBuildReceipt = __esm(() => {
   init_packageIndexes();
   init_packageTemplateUtils();
   init_packageOutputPaths();
+  init_packageDistributionMetadata();
   IGNORED_PACKAGE_FS_ENTRIES = new Set([".DS_Store"]);
 });
 
 // src/project/knowledgeMapCoverage.ts
 import { readFile as readFile48 } from "node:fs/promises";
-import { join as join58 } from "node:path";
+import { join as join59 } from "node:path";
 function knowledgeMapArticleTargets(files) {
   return files.flatMap((file) => {
     const meta = parseKnowledgeFrontmatter(file.content);
@@ -84893,7 +84918,7 @@ function knowledgeMapArticleTargets(files) {
 async function approvedKnowledgeMapTargets(root) {
   const metadata = await readApprovedKnowledgeMetadataIndex(root);
   const articles = new Map(validateArticleStructureEntries(metadata.structure?.articles ?? []).map((article) => [article.path, article]));
-  const files = await walkPackageFiles(join58(root, "knowledge"));
+  const files = await walkPackageFiles(join59(root, "knowledge"));
   const content3 = await Promise.all(files.filter((file) => isApprovedKnowledgeMarkdownPath(file.relPath) && !file.relPath.startsWith("assets/")).map(async (file) => ({
     article: articles.get(file.relPath),
     content: hydrateApprovedKnowledgeMarkdown({ content: await readFile48(file.absPath, "utf8"), relPath: file.relPath, metadata })
@@ -84943,10 +84968,10 @@ var init_knowledgeMapCoverage = __esm(() => {
 
 // src/project/knowledgeMap.ts
 import { readFile as readFile49 } from "node:fs/promises";
-import { join as join59 } from "node:path";
+import { join as join60 } from "node:path";
 async function optionalText(root, path2) {
   try {
-    return await readFile49(join59(root, path2), "utf8");
+    return await readFile49(join60(root, path2), "utf8");
   } catch (error) {
     if (error.code === "ENOENT")
       return;
@@ -85007,7 +85032,7 @@ var init_knowledgeMap2 = __esm(() => {
 
 // src/project/packageKnowledgeMap.ts
 import { readFile as readFile50, writeFile as writeFile16 } from "node:fs/promises";
-import { join as join60 } from "node:path";
+import { join as join61 } from "node:path";
 function knowledgeMapSectionAnchor(key) {
   return `section-${encodeURIComponent(key)}`;
 }
@@ -85032,8 +85057,8 @@ async function writePackageKnowledgeMap(input) {
     return [];
   const projected = projectKnowledgeMap(input.structure, packageKnowledgeMapTargets(input.pkg, input.selected));
   projected.warnings = projected.warnings.filter((warning) => !warning.target.startsWith("site:"));
-  const root = join60(input.projectRoot, input.pkg.outDir);
-  const mapPath = join60(root, "context-knowledge-map.json");
+  const root = join61(input.projectRoot, input.pkg.outDir);
+  const mapPath = join61(root, "context-knowledge-map.json");
   try {
     await readFile50(mapPath);
     throw new TypeError("package template uses reserved context-knowledge-map.json; rename that template output");
@@ -85054,7 +85079,7 @@ async function writePackageKnowledgeMap(input) {
   }
   render(projected.entries, 0);
   if (lines.length) {
-    const indexPath = join60(root, "index.md");
+    const indexPath = join61(root, "index.md");
     let existing = "";
     try {
       existing = await readFile50(indexPath, "utf8");
@@ -85081,7 +85106,7 @@ var init_packageKnowledgeMap = __esm(() => {
 // src/project/packageLlms.ts
 import { createHash as createHash15 } from "node:crypto";
 import { access as access4, mkdir as mkdir21, writeFile as writeFile17 } from "node:fs/promises";
-import { dirname as dirname26, join as join61, posix as posix5 } from "node:path";
+import { dirname as dirname26, join as join62, posix as posix5 } from "node:path";
 function llmsArticles(pkg, selected) {
   return selected.map((file) => {
     const meta = parseKnowledgeFrontmatter(file.content);
@@ -85181,7 +85206,7 @@ async function writeLlmsDocuments(root, documents, options = {}) {
   for (const [path2, content3] of documents.files) {
     let exists = false;
     try {
-      await access4(join61(root, path2));
+      await access4(join62(root, path2));
       exists = true;
     } catch (error) {
       if (error.code !== "ENOENT")
@@ -85191,8 +85216,8 @@ async function writeLlmsDocuments(root, documents, options = {}) {
       continue;
     if (exists)
       throw new Error(`Package template uses reserved LLMS output ${path2}; rename that template output.`);
-    await mkdir21(dirname26(join61(root, path2)), { recursive: true });
-    await writeFile17(join61(root, path2), options.utf8Bom ? "\uFEFF" + content3.replace(/^\uFEFF/u, "") : content3, "utf8");
+    await mkdir21(dirname26(join62(root, path2)), { recursive: true });
+    await writeFile17(join62(root, path2), options.utf8Bom ? "\uFEFF" + content3.replace(/^\uFEFF/u, "") : content3, "utf8");
   }
 }
 var PACKAGE_LLMS_VERSION = "knowledge-map-llms-v1", label = (text7) => text7.replace(/[\\[\]<>`*]/gu, "\\$&").replace(/[\r\n]/gu, " "), articlePath = (identity) => `llms/pages/${createHash15("sha256").update(identity).digest("hex").slice(0, 32)}.txt`;
@@ -86191,7 +86216,7 @@ var init_packageSiteBranding = __esm(() => {
 // src/project/packageSiteExtensions.ts
 import { createHash as createHash16 } from "node:crypto";
 import { lstat as lstat8, readdir as readdir15, readFile as readFile51, mkdir as mkdir22, writeFile as writeFile18, symlink } from "node:fs/promises";
-import { join as join62, dirname as dirname27, resolve as resolve22 } from "node:path";
+import { join as join63, dirname as dirname27, resolve as resolve22 } from "node:path";
 function invalidSiteExtension(message) {
   throw new ContextError(ExitCode.UserError, `Site extensions: ${message}. Update site.extensions, its src files or the knowledge-map target, then retry the build.`, {
     reason_code: "invalid-site-extension"
@@ -86210,7 +86235,7 @@ async function readSiteExtensions(projectRoot, extensions) {
     invalid(`unsafe root ${root}`);
   let cursor = projectRoot;
   for (const part of root.split("/")) {
-    cursor = join62(cursor, part);
+    cursor = join63(cursor, part);
     const info = await lstat8(cursor).catch((error) => {
       if (error.code === "ENOENT")
         invalid(`missing directory ${root}`);
@@ -86230,9 +86255,9 @@ async function readSiteExtensions(projectRoot, extensions) {
       if (entry.isSymbolicLink())
         invalid(`symlink at ${path2}`);
       if (entry.isDirectory())
-        await walk(join62(directory, entry.name), path2 + "/");
+        await walk(join63(directory, entry.name), path2 + "/");
       else if (entry.isFile())
-        files.push({ path: path2, bytes: await readFile51(join62(directory, entry.name)) });
+        files.push({ path: path2, bytes: await readFile51(join63(directory, entry.name)) });
     }
   }
   await walk(cursor, "");
@@ -86252,7 +86277,7 @@ async function readSiteExtensions(projectRoot, extensions) {
     hash3.update(file.path + "\x00").update(file.bytes).update("\x00");
   for (const name3 of ["package.json", "bun.lock", "pnpm-lock.yaml", "package-lock.json"]) {
     try {
-      hash3.update(name3).update(await readFile51(join62(projectRoot, name3)));
+      hash3.update(name3).update(await readFile51(join63(projectRoot, name3)));
     } catch (error) {
       if (error.code !== "ENOENT")
         throw error;
@@ -86265,9 +86290,9 @@ function siteExtensionTargets(site) {
 }
 async function writeSiteExtensions(projectRoot, temporary, extensions) {
   const { files } = await readSiteExtensions(projectRoot, extensions);
-  const root = join62(temporary, "_site");
+  const root = join63(temporary, "_site");
   for (const file of files) {
-    const path2 = join62(root, file.path);
+    const path2 = join63(root, file.path);
     await mkdir22(dirname27(path2), { recursive: true });
     await writeFile18(path2, file.bytes);
   }
@@ -86276,7 +86301,7 @@ async function writeSiteExtensions(projectRoot, temporary, extensions) {
       const modules = resolve22(projectRoot, "node_modules");
       if ((await lstat8(modules)).isDirectory() || (await lstat8(modules)).isSymbolicLink()) {
         await mkdir22(root, { recursive: true });
-        await symlink(modules, join62(root, "node_modules"), "dir");
+        await symlink(modules, join63(root, "node_modules"), "dir");
       }
     } catch (error) {
       if (error.code !== "ENOENT")
@@ -86295,16 +86320,16 @@ async function writeSiteExtensions(projectRoot, temporary, extensions) {
     imports.push(`const ${name3} = defineAsyncComponent(() => import(${JSON.stringify(`../../_site/${path2}`)}));`);
     slots.push(`${JSON.stringify(name3)}: ${name3 === "floating" ? `() => h(resolveComponent('ClientOnly'), null, { default: () => h(${name3}) })` : `() => h(${name3})`}`);
   }
-  await writeFile18(join62(temporary, ".vitepress/theme/extensions.js"), imports.join(`
+  await writeFile18(join63(temporary, ".vitepress/theme/extensions.js"), imports.join(`
 `) + `
 export default {${slots.join(",")}};
 `);
   for (const [key, path2] of Object.entries(extensions?.pages ?? {})) {
-    await mkdir22(join62(temporary, "custom"), { recursive: true });
+    await mkdir22(join63(temporary, "custom"), { recursive: true });
     const content3 = files.find((file) => file.path === path2).bytes.toString("utf8");
     const metadata = parseKnowledgeFrontmatter(content3);
     const title = metadata.title ?? /^#\s+(.+)$/m.exec(content3)?.[1] ?? key;
-    await writeFile18(join62(temporary, "custom", `${key}.md`), `---
+    await writeFile18(join63(temporary, "custom", `${key}.md`), `---
 ${JSON.stringify({ layout: "page", ...metadata, title })}
 ---
 <script setup>
@@ -86328,7 +86353,7 @@ import { createHash as createHash17 } from "node:crypto";
 import { spawn as spawn3 } from "node:child_process";
 import { mkdir as mkdir23, mkdtemp as mkdtemp2, readFile as readFile52, writeFile as writeFile19, rm as rm12, symlink as symlink2, cp, access as access5, stat as stat8 } from "node:fs/promises";
 import { createRequire as createRequire5 } from "node:module";
-import { dirname as dirname28, join as join63, posix as posix6 } from "node:path";
+import { dirname as dirname28, join as join64, posix as posix6 } from "node:path";
 function sitePagePath(identity) {
   return `pages/${createHash17("sha256").update(identity).digest("hex").slice(0, 32)}.html`;
 }
@@ -86449,7 +86474,7 @@ function siteSections(entries2) {
 async function compileSite(root, outDir) {
   const vitepressRoot = dirname28(require2.resolve("vitepress/package.json"));
   await new Promise((resolve8, reject) => {
-    const child = spawn3(process.versions.bun ? "node" : process.execPath, [join63(vitepressRoot, "bin/vitepress.js"), "build", root, "--outDir", outDir], { stdio: ["ignore", "pipe", "pipe"] });
+    const child = spawn3(process.versions.bun ? "node" : process.execPath, [join64(vitepressRoot, "bin/vitepress.js"), "build", root, "--outDir", outDir], { stdio: ["ignore", "pipe", "pipe"] });
     let tail = "";
     const receive = (chunk) => {
       tail = (tail + chunk.toString()).slice(-16000);
@@ -86480,8 +86505,8 @@ async function writePackageSite(input) {
   const base = options.base ?? "/";
   const history = await readWorkspaceChangelog(projectRoot);
   const historyDate = history[0]?.date ?? null;
-  const root = join63(projectRoot, pkg.outDir);
-  const output = join63(projectRoot, packageSiteOutputDir(pkg));
+  const root = join64(projectRoot, pkg.outDir);
+  const output = join64(projectRoot, packageSiteOutputDir(pkg));
   try {
     await access5(output);
     throw new Error("Website output already exists; build through the staged package workflow.");
@@ -86489,9 +86514,9 @@ async function writePackageSite(input) {
     if (error.code !== "ENOENT")
       throw error;
   }
-  const temporaryRoot = join63(projectRoot, ".tmp");
+  const temporaryRoot = join64(projectRoot, ".tmp");
   await mkdir23(temporaryRoot, { recursive: true });
-  const temporary = await mkdtemp2(join63(temporaryRoot, "website-"));
+  const temporary = await mkdtemp2(join64(temporaryRoot, "website-"));
   try {
     const registry2 = await loadSourcesRegistry({ rootDir: projectRoot });
     const sourceContent = new Map(selected.map((file) => [packageKnowledgeOutputPath(pkg, file.relPath), file]));
@@ -86512,22 +86537,22 @@ async function writePackageSite(input) {
     }
     const sections = siteSections(mapping.entries);
     const resources = new Set(delivered.filter((file) => file.relPath.startsWith("others/assets/") || file.relPath.startsWith("skills/") && !file.relPath.endsWith(".md")).map((file) => file.relPath));
-    const configRoot = join63(temporary, ".vitepress");
-    await mkdir23(join63(configRoot, "theme"), { recursive: true });
-    await mkdir23(join63(temporary, "node_modules"), { recursive: true });
+    const configRoot = join64(temporary, ".vitepress");
+    await mkdir23(join64(configRoot, "theme"), { recursive: true });
+    await mkdir23(join64(temporary, "node_modules"), { recursive: true });
     const vitepressRoot = dirname28(require2.resolve("vitepress/package.json"));
-    const vueRequire = createRequire5(join63(vitepressRoot, "package.json"));
+    const vueRequire = createRequire5(join64(vitepressRoot, "package.json"));
     for (const [name3, path2] of [
       ["vitepress", vitepressRoot],
       ["vue", dirname28(vueRequire.resolve("vue/package.json"))],
       ["@mermaid-js/layout-elk", dirname28(require2.resolve("@mermaid-js/layout-elk/package.json"))],
       ["mermaid", dirname28(require2.resolve("mermaid/package.json"))]
     ]) {
-      await mkdir23(dirname28(join63(temporary, "node_modules", name3)), { recursive: true });
-      await symlink2(path2, join63(temporary, "node_modules", name3), "dir");
+      await mkdir23(dirname28(join64(temporary, "node_modules", name3)), { recursive: true });
+      await symlink2(path2, join64(temporary, "node_modules", name3), "dir");
     }
-    await writeFile19(join63(configRoot, "theme/index.js"), siteThemeScript);
-    await writeFile19(join63(configRoot, "theme/style.css"), siteThemeCss + siteThemeVariables(await resolveSiteTheme(projectRoot, options.theme, true)));
+    await writeFile19(join64(configRoot, "theme/index.js"), siteThemeScript);
+    await writeFile19(join64(configRoot, "theme/style.css"), siteThemeCss + siteThemeVariables(await resolveSiteTheme(projectRoot, options.theme, true)));
     await writeSiteExtensions(projectRoot, temporary, options.extensions);
     const config = {
       title: options.title ?? pkg.name,
@@ -86553,11 +86578,11 @@ async function writePackageSite(input) {
         nav: [...sections.map((section) => ({ text: section.title, link: section.href })), { text: "更多", items: [{ text: "LLM Docs", link: "/llms/index.html" }, { text: "Changelog", link: "/changelog.html" }] }]
       }
     };
-    await writeFile19(join63(configRoot, "config.mjs"), `export default { ...${JSON.stringify(config)}, markdown: { ${siteMarkdownConfig} } };
+    await writeFile19(join64(configRoot, "config.mjs"), `export default { ...${JSON.stringify(config)}, markdown: { ${siteMarkdownConfig} } };
 `);
-    await mkdir23(join63(temporary, "pages"), { recursive: true });
+    await mkdir23(join64(temporary, "pages"), { recursive: true });
     for (const page of byPath.values()) {
-      const content3 = await readFile52(join63(root, page.package_path), "utf8");
+      const content3 = await readFile52(join64(root, page.package_path), "utf8");
       const original = sourceContent.get(page.package_path);
       const provenance = articleProvenanceMarkdown(original?.article, registry2);
       const pageContent = provenance && content3.endsWith(provenance) ? content3.slice(0, -provenance.length) : content3;
@@ -86565,7 +86590,7 @@ async function writePackageSite(input) {
       const sources = siteArticleSources(original?.article, registry2);
       const timestamp = parseKnowledgeFrontmatter(original?.content ?? content3).timestamp;
       const updated = typeof timestamp === "string" && Number.isFinite(Date.parse(timestamp)) ? new Date(timestamp).toISOString() : null;
-      await writeFile19(join63(temporary, page.site_path.replace(/\.html$/u, ".md")), `---
+      await writeFile19(join64(temporary, page.site_path.replace(/\.html$/u, ".md")), `---
 title: ${JSON.stringify(page.title)}
 contextSources: ${JSON.stringify(sources)}
 contextUpdated: ${JSON.stringify(updated)}
@@ -86577,11 +86602,11 @@ ${body}`);
       lines.push(`${"  ".repeat(level)}- ${entry.href ? `[${mdLabel(entry.title)}](${entry.href})` : mdLabel(entry.title)}`);
       menu(lines, entry.children, level + 1);
     });
-    await mkdir23(join63(temporary, "sections"), { recursive: true });
+    await mkdir23(join64(temporary, "sections"), { recursive: true });
     for (const section of sections) {
       const lines = [`# ${mdLabel(section.title)}`, ""];
       menu(lines, section.entries, 0);
-      await writeFile19(join63(temporary, section.href.slice(1).replace(/\.html$/u, ".md")), lines.join(`
+      await writeFile19(join64(temporary, section.href.slice(1).replace(/\.html$/u, ".md")), lines.join(`
 `) + `
 `);
     }
@@ -86600,12 +86625,12 @@ ${body}`);
     };
     const homeHero = options.extensions?.slots?.banner === undefined ? `hero: ${JSON.stringify(hero)}
 ` : "";
-    await writeFile19(join63(temporary, "index.md"), `---
+    await writeFile19(join64(temporary, "index.md"), `---
 layout: home
 title: ${JSON.stringify(options.home?.title ?? options.title ?? pkg.name)}
 ${homeHero}---
 `);
-    await writeFile19(join63(temporary, "changelog.md"), `---
+    await writeFile19(join64(temporary, "changelog.md"), `---
 title: Changelog
 contextHistory: ${JSON.stringify(Buffer.from(JSON.stringify(history)).toString("base64"))}
 ---
@@ -86618,19 +86643,19 @@ contextHistory: ${JSON.stringify(Buffer.from(JSON.stringify(history)).toString("
       assetsPrefix: "resources/",
       articles: await Promise.all(llmsArticles(pkg, selected).map(async (article) => ({
         ...article,
-        content: await readFile52(join63(root, article.path), "utf8")
+        content: await readFile52(join64(root, article.path), "utf8")
       }))),
       ...structure ? { map: structure } : {}
     });
-    await writeLlmsDocuments(join63(temporary, "public"), llms, { utf8Bom: true });
-    await mkdir23(join63(temporary, "llms"), { recursive: true });
+    await writeLlmsDocuments(join64(temporary, "public"), llms, { utf8Bom: true });
+    await mkdir23(join64(temporary, "llms"), { recursive: true });
     let landingNavigation = llms.navigationMarkdown;
     for (const link of markdownReaderLinks(landingNavigation).reverse()) {
       if (!link.target.startsWith(base))
         continue;
       landingNavigation = landingNavigation.slice(0, link.start) + `[${link.label}](</${link.target.slice(base.length)}>)` + landingNavigation.slice(link.end);
     }
-    await writeFile19(join63(temporary, "llms/index.md"), `---
+    await writeFile19(join64(temporary, "llms/index.md"), `---
 title: LLM Docs
 ---
 
@@ -86640,9 +86665,9 @@ title: LLM Docs
 
 ` + landingNavigation);
     for (const path2 of resources) {
-      const destination = join63(temporary, "public/resources", path2);
+      const destination = join64(temporary, "public/resources", path2);
       await mkdir23(dirname28(destination), { recursive: true });
-      await cp(join63(root, path2), destination);
+      await cp(join64(root, path2), destination);
     }
     await compileSite(temporary, output);
     for (const file of await walkPackageFiles(output)) {
@@ -86666,8 +86691,14 @@ title: LLM Docs
       warnings: mapping.warnings
     }, null, 2) + `
 `;
-    await writeFile19(join63(output, "context-site-map.json"), siteMapContent);
-    await writeFile19(join63(projectRoot, pkg.outDir, "context-site-map.json"), siteMapContent);
+    const packageSiteMap = join64(projectRoot, pkg.outDir, "context-site-map.json");
+    const distributedSiteMap = join64(projectRoot, pkg.outDir, packageDistributionMetadataPath("context-site-map.json"));
+    await mkdir23(dirname28(distributedSiteMap), { recursive: true });
+    await Promise.all([
+      writeFile19(join64(output, "context-site-map.json"), siteMapContent),
+      writeFile19(packageSiteMap, siteMapContent),
+      writeFile19(distributedSiteMap, siteMapContent)
+    ]);
     return mapping;
   } finally {
     await rm12(temporary, { recursive: true, force: true });
@@ -86688,12 +86719,13 @@ var init_packageSite2 = __esm(() => {
   init_packageSiteTheme();
   init_packageSiteBranding();
   init_packageSiteExtensions();
+  init_packageDistributionMetadata();
   PACKAGE_SITE_VERSION = `vitepress-site-v44-site-address:${createHash17("sha256").update(JSON.stringify([siteThemeVariables.toString(), siteMarkdownConfig, siteThemeCss, siteThemeScript, siteThemeLabels("zh"), siteThemeLabels("en")])).digest("hex")}`;
   require2 = createRequire5(import.meta.url);
 });
 
 // src/project/workspaceBuildVersion.ts
-import { join as join64 } from "node:path";
+import { join as join65 } from "node:path";
 import { mkdir as mkdir24, writeFile as writeFile20 } from "node:fs/promises";
 async function workspaceVersionFingerprint(root) {
   return { version: await workspaceVersion(root), changelog: await readWorkspaceChangelog(root) };
@@ -86705,8 +86737,8 @@ async function writePackageVersion(projectRoot, output) {
       throw new TypeError(`Package template uses reserved version output ${path2}; rename that template output.`);
   }
   await mkdir24(output, { recursive: true });
-  await writeFile20(join64(output, "CHANGELOG.md"), renderChangelog(info.changelog));
-  await writeFile20(join64(output, "context-version.json"), JSON.stringify({ version: info.version }) + `
+  await writeFile20(join65(output, "CHANGELOG.md"), renderChangelog(info.changelog));
+  await writeFile20(join65(output, "context-version.json"), JSON.stringify({ version: info.version }) + `
 `);
 }
 var init_workspaceBuildVersion = __esm(() => {
@@ -86716,11 +86748,11 @@ var init_workspaceBuildVersion = __esm(() => {
 // src/project/packageRenderCache.ts
 import { createHash as createHash18 } from "node:crypto";
 import { readFile as readFile53 } from "node:fs/promises";
-import { join as join65 } from "node:path";
+import { join as join66 } from "node:path";
 async function cachedPackageKnowledgeMarkdown(input) {
   const fingerprint = digest3(`${PACKAGE_READER_MARKDOWN_VERSION}
 ${input.content}`);
-  const path2 = join65(input.projectRoot, ".tmp/context-runtime/package-render", `${digest3(input.key)}.json`);
+  const path2 = join66(input.projectRoot, ".tmp/context-runtime/package-render", `${digest3(input.key)}.json`);
   try {
     const cached = JSON.parse(await readFile53(path2, "utf8"));
     if (cached !== null && typeof cached === "object" && "fingerprint" in cached && cached.fingerprint === fingerprint && "markdown" in cached && typeof cached.markdown === "string") {
@@ -86842,22 +86874,22 @@ var init_packageMarkdownAnchors = __esm(() => {
 
 // src/project/packageBuildStage.ts
 import { mkdir as mkdir25, mkdtemp as mkdtemp3, readFile as readFile55, rename as rename7, rm as rm13, rmdir } from "node:fs/promises";
-import { dirname as dirname29, join as join66, relative as relative18 } from "node:path";
+import { dirname as dirname29, join as join67, relative as relative18 } from "node:path";
 async function withStagedPackageOutput(projectRoot, pkg, render) {
-  const tempRoot = join66(projectRoot, ".tmp");
+  const tempRoot = join67(projectRoot, ".tmp");
   await mkdir25(tempRoot, { recursive: true });
-  const stage = await mkdtemp3(join66(tempRoot, "package-build-"));
-  const stagedPackage = { ...pkg, outDir: relative18(projectRoot, join66(stage, pkg.name)) };
+  const stage = await mkdtemp3(join67(tempRoot, "package-build-"));
+  const stagedPackage = { ...pkg, outDir: relative18(projectRoot, join67(stage, pkg.name)) };
   try {
-    await mkdir25(join66(projectRoot, stagedPackage.outDir), { recursive: true });
+    await mkdir25(join67(projectRoot, stagedPackage.outDir), { recursive: true });
     const value = await render(stagedPackage);
     await validatePackageIndexLinks({ projectRoot, pkg: stagedPackage });
     const destinations = packageOutputDirs(pkg);
     const staged = packageOutputDirs(stagedPackage);
     for (const [index2, destination] of destinations.entries()) {
-      const target = join66(projectRoot, destination);
+      const target = join67(projectRoot, destination);
       const previous2 = await walkPackageFiles(target);
-      const next = await walkPackageFiles(join66(projectRoot, staged[index2]));
+      const next = await walkPackageFiles(join67(projectRoot, staged[index2]));
       const desired = new Set(next.map((file) => file.relPath));
       for (const file of previous2) {
         if (desired.has(file.relPath))
@@ -86875,7 +86907,7 @@ async function withStagedPackageOutput(projectRoot, pkg, render) {
       }
       for (let offset2 = 0;offset2 < next.length; offset2 += 8) {
         const results = await Promise.allSettled(next.slice(offset2, offset2 + 8).map(async (file) => {
-          const output = join66(target, file.relPath);
+          const output = join67(target, file.relPath);
           const bytes = await readFile55(file.absPath);
           const old = await readFile55(output).catch((error) => {
             if (error.code === "ENOENT")
@@ -87283,7 +87315,7 @@ var init_packageAssetOptimization = __esm(() => {
 // src/project/packageAssetDelivery.ts
 import { execFile as execFile8 } from "node:child_process";
 import { realpath as realpath7 } from "node:fs/promises";
-import { join as join67, relative as relative20, sep as sep5 } from "node:path";
+import { join as join68, relative as relative20, sep as sep5 } from "node:path";
 import { promisify as promisify8 } from "node:util";
 async function git(projectRoot, args) {
   try {
@@ -87303,7 +87335,7 @@ async function git(projectRoot, args) {
   }
 }
 function repositoryPath(repoRoot, projectRoot, asset) {
-  const path2 = relative20(repoRoot, join67(projectRoot, asset.knowledgeRelPath)).split(sep5).join("/");
+  const path2 = relative20(repoRoot, join68(projectRoot, asset.knowledgeRelPath)).split(sep5).join("/");
   if (path2 === ".." || path2.startsWith("../") || path2.startsWith("/")) {
     throw new ContextError(ExitCode.WorkspaceStateError, "knowledge asset is outside the current Git repository", {
       category: ErrorCategory.WorkspaceStateInvalid,
@@ -87484,7 +87516,7 @@ var init_packageAssetDelivery = __esm(() => {
 // src/project/packageBuildContent.ts
 import { existsSync as existsSync17 } from "node:fs";
 import { mkdir as mkdir26, readFile as readFile57, writeFile as writeFile21 } from "node:fs/promises";
-import { dirname as dirname32, join as join68 } from "node:path";
+import { dirname as dirname32, join as join69 } from "node:path";
 function globToRegExp(pattern) {
   const normalized = toPosixPath6(pattern);
   if (normalized.endsWith("/**")) {
@@ -87625,7 +87657,7 @@ async function writeRenderedPackageTemplate(input) {
       templateRelPath: renderedRelPath,
       logicalTemplateRelPath: renderedLogicalRelPath
     });
-    const outputPath = join68(input.projectRoot, input.pkg.outDir, renderedRelPath);
+    const outputPath = join69(input.projectRoot, input.pkg.outDir, renderedRelPath);
     await mkdir26(dirname32(outputPath), { recursive: true });
     await writeFile21(outputPath, renderTemplateText(file.content, contentVars), "utf8");
     written++;
@@ -87658,7 +87690,7 @@ async function writeSelectedPackageKnowledge(input) {
   for (let offset2 = 0;offset2 < projectedPages.length; offset2 += 8) {
     const results = await Promise.allSettled(projectedPages.slice(offset2, offset2 + 8).map(async (projected) => {
       assertSafeRenderedPath2(projected.pageOutputPath, "knowledge path");
-      const outputPath = join68(input.projectRoot, input.pkg.outDir, projected.pageOutputPath);
+      const outputPath = join69(input.projectRoot, input.pkg.outDir, projected.pageOutputPath);
       let mediaContent = projected.content;
       const omitted = new Set((delivered.omittedImages ?? []).map((path2) => packageMarkdownTarget(projected.pageOutputPath, path2)));
       for (const link of markdownReaderLinks(mediaContent).reverse()) {
@@ -87695,7 +87727,7 @@ async function writeSelectedPackageKnowledge(input) {
   const deliveredAssets = new Map(delivered.assets.map((asset) => [asset.packageRelPath, asset]));
   for (const asset of deliveredAssets.values()) {
     assertSafeRenderedPath2(asset.packageRelPath, "package resource path");
-    const outputPath = join68(input.projectRoot, input.pkg.outDir, asset.packageRelPath);
+    const outputPath = join69(input.projectRoot, input.pkg.outDir, asset.packageRelPath);
     await mkdir26(dirname32(outputPath), { recursive: true });
     await writeFile21(outputPath, asset.bytes);
   }
@@ -87710,7 +87742,7 @@ async function writeSelectedPackageKnowledge(input) {
 async function appendLlmsKnowledge(input) {
   if (packageKind2(input.pkg) !== "llms" || input.templateConsumesKnowledge || input.knowledgeCount === 0)
     return 0;
-  const outputPath = join68(input.projectRoot, input.pkg.outDir, "llms.txt");
+  const outputPath = join69(input.projectRoot, input.pkg.outDir, "llms.txt");
   const existed = existsSync17(outputPath);
   const existing = existed ? await readFile57(outputPath, "utf8") : "";
   const content3 = existing.trim().length > 0 ? `${existing.trimEnd()}
@@ -87937,7 +87969,7 @@ __export(exports_packageBuilder, {
 import { createHash as createHash20 } from "node:crypto";
 import { existsSync as existsSync18 } from "node:fs";
 import { mkdir as mkdir27, readdir as readdir16, readFile as readFile58, rm as rm14, writeFile as writeFile22 } from "node:fs/promises";
-import { dirname as dirname33, join as join69, resolve as resolve23 } from "node:path";
+import { dirname as dirname33, join as join70, resolve as resolve23 } from "node:path";
 function packageAssetDeliverySummary(value) {
   if (value === null || typeof value !== "object" || Array.isArray(value))
     return;
@@ -87959,7 +87991,7 @@ function assertPackageOutputDir(pkg) {
 }
 function packageFingerprintPath(projectRoot, pkg) {
   assertSafeRenderedPath2(`${pkg.name}.json`, "package fingerprint path");
-  return join69(projectRoot, PACKAGE_FINGERPRINT_ROOT, `${pkg.name}.json`);
+  return join70(projectRoot, PACKAGE_FINGERPRINT_ROOT, `${pkg.name}.json`);
 }
 async function listApprovedKnowledge(projectRoot) {
   const metadata = await readApprovedKnowledgeMetadataIndex(projectRoot);
@@ -88112,12 +88144,12 @@ async function writePackageFingerprint(input) {
 `, "utf8");
 }
 async function removeOrphanPackageDirs(projectRoot, packages) {
-  const distRoot = join69(projectRoot, "dist");
+  const distRoot = join70(projectRoot, "dist");
   if (!existsSync18(distRoot))
     return;
   const declaredNames = new Set(packages.flatMap((pkg) => packageOutputDirs(pkg).map((path2) => path2.slice("dist/".length))));
   const entries2 = await readdir16(distRoot, { withFileTypes: true });
-  await Promise.all(entries2.filter((entry) => entry.isDirectory() && !declaredNames.has(entry.name)).map((entry) => rm14(join69(distRoot, entry.name), { recursive: true, force: true, maxRetries: 3, retryDelay: 100 })));
+  await Promise.all(entries2.filter((entry) => entry.isDirectory() && !declaredNames.has(entry.name)).map((entry) => rm14(join70(distRoot, entry.name), { recursive: true, force: true, maxRetries: 3, retryDelay: 100 })));
 }
 async function collectPackageFreshness(projectRoot, packages) {
   assertDistinctPackageOutputs(packages);
@@ -88126,7 +88158,7 @@ async function collectPackageFreshness(projectRoot, packages) {
     assertPackageOutputDir(pkg);
     const selected = selectPackageKnowledge(approved, pkg);
     assertSafeRenderedPath2(pkg.template.path, "package template path");
-    const templateRoot = join69(projectRoot, pkg.template.path);
+    const templateRoot = join70(projectRoot, pkg.template.path);
     const templateExists = existsSync18(templateRoot);
     if (!templateExists) {
       throw new ContextError(ExitCode.WorkspaceStateError, `package template path is missing: ${pkg.template.path}`, {
@@ -88355,19 +88387,19 @@ async function buildProjectPackagesInternal(projectRoot, options) {
       if (stagedPkg.kind === "package.llms") {
         const articles = await Promise.all(llmsArticles(stagedPkg, selected).map(async (article) => ({
           ...article,
-          content: await readFile58(join69(projectRoot, stagedPkg.outDir, article.path), "utf8")
+          content: await readFile58(join70(projectRoot, stagedPkg.outDir, article.path), "utf8")
         })));
-        await writeLlmsDocuments(join69(projectRoot, stagedPkg.outDir), buildLlmsDocuments({
+        await writeLlmsDocuments(join70(projectRoot, stagedPkg.outDir), buildLlmsDocuments({
           title: stagedPkg.name,
           articles,
           ...reading ? { map: reading } : {}
         }), { preserveIndex: true });
       }
-      await writePackageVersion(projectRoot, join69(projectRoot, stagedPkg.outDir));
+      await writePackageVersion(projectRoot, join70(projectRoot, stagedPkg.outDir));
       await writePackageSite({ projectRoot, pkg: stagedPkg, selected, ...siteUrl ? { siteUrl } : {}, ...reading ? { structure: reading } : {} });
       const linkWarnings = [
         ...writtenKnowledge2.linkWarnings,
-        ...await inspectPackageMarkdownDirectory(join69(projectRoot, stagedPkg.outDir))
+        ...await inspectPackageMarkdownDirectory(join70(projectRoot, stagedPkg.outDir))
       ];
       return { ...writtenKnowledge2, linkWarnings };
     });
@@ -88559,7 +88591,7 @@ var init_packageBuilder = __esm(() => {
   init_packageTemplateReview();
   init_approvedKnowledgeMetadata();
   import_yaml35 = __toESM(require_dist(), 1);
-  PACKAGE_FINGERPRINT_ROOT = join69(".tmp", "context-runtime", "packages");
+  PACKAGE_FINGERPRINT_ROOT = join70(".tmp", "context-runtime", "packages");
 });
 
 // src/project/taskRollback.ts
@@ -88570,7 +88602,7 @@ __export(exports_taskRollback, {
   finishTaskRollback: () => finishTaskRollback
 });
 import { readFile as readFile59 } from "node:fs/promises";
-import { join as join70 } from "node:path";
+import { join as join71 } from "node:path";
 async function readTaskRollback(projectRoot) {
   const raw = await readJsonMaybe(projectRoot, await revisionStoragePath(projectRoot));
   if (!raw || typeof raw !== "object" || !("protocol" in raw) || raw.protocol !== "context.task-rollback/v1")
@@ -88579,7 +88611,7 @@ async function readTaskRollback(projectRoot) {
 }
 async function contents(projectRoot, path2) {
   try {
-    return await readFile59(join70(projectRoot, path2), "utf8");
+    return await readFile59(join71(projectRoot, path2), "utf8");
   } catch (error) {
     if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
       return;
@@ -88747,11 +88779,11 @@ __export(exports_knowledgeUpdate, {
   beginKnowledgeUpdate: () => beginKnowledgeUpdate
 });
 import { readFile as readFile60 } from "node:fs/promises";
-import { join as join71 } from "node:path";
+import { join as join72 } from "node:path";
 async function readKnowledgeUpdate(projectRoot) {
   let value;
   try {
-    value = JSON.parse(await readFile60(join71(projectRoot, await revisionStoragePath(projectRoot)), "utf8"));
+    value = JSON.parse(await readFile60(join72(projectRoot, await revisionStoragePath(projectRoot)), "utf8"));
   } catch (error) {
     if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
       return;
@@ -88802,7 +88834,7 @@ async function beginKnowledgeUpdate(projectRoot, value) {
       ...input.changes === undefined ? {} : { changes: input.changes }
     };
     const request = updateSchema.parse({ ...payload, revision: indexerProtocolDigest(payload) });
-    await atomicWriteFile(join71(projectRoot, await revisionStoragePath(projectRoot)), `${JSON.stringify(request)}
+    await atomicWriteFile(join72(projectRoot, await revisionStoragePath(projectRoot)), `${JSON.stringify(request)}
 `);
     return {
       outcome: "update-prepared",
@@ -88847,7 +88879,7 @@ async function completeKnowledgeUpdate(input) {
     if (input.new_topics.length && !input.structure_approved) {
       const { revision: _revision, ...rest } = request;
       const payload = { ...rest, structure_proposal: { decisions: input.decisions, scope_summary: input.scope_summary, new_topics: input.new_topics } };
-      await atomicWriteFile(join71(input.projectRoot, await revisionStoragePath(input.projectRoot)), `${JSON.stringify({ ...payload, revision: indexerProtocolDigest(payload) })}
+      await atomicWriteFile(join72(input.projectRoot, await revisionStoragePath(input.projectRoot)), `${JSON.stringify({ ...payload, revision: indexerProtocolDigest(payload) })}
 `);
       return { outcome: "structure-review-required" };
     }
@@ -88884,7 +88916,7 @@ async function completeUpdateStructureReview(input) {
     const { revision: _revision, structure_proposal: _proposal, ...rest } = request;
     const payload = { ...rest, changes: `${rest.changes ?? ""}
 Structure feedback: ${input.feedback}` };
-    await atomicWriteFile(join71(input.projectRoot, await revisionStoragePath(input.projectRoot)), `${JSON.stringify({ ...payload, revision: indexerProtocolDigest(payload) })}
+    await atomicWriteFile(join72(input.projectRoot, await revisionStoragePath(input.projectRoot)), `${JSON.stringify({ ...payload, revision: indexerProtocolDigest(payload) })}
 `);
     return { outcome: "structure-adjustment-required" };
   });
@@ -89058,14 +89090,14 @@ __export(exports_knowledgeMaintenance, {
   advanceKnowledgeMaintenance: () => advanceKnowledgeMaintenance
 });
 import { readFile as readFile61, readdir as readdir17, rm as rm15 } from "node:fs/promises";
-import { join as join72 } from "node:path";
+import { join as join73 } from "node:path";
 async function deliveryDigest(root) {
-  const directory = join72(root, ".tmp/context-runtime/packages");
+  const directory = join73(root, ".tmp/context-runtime/packages");
   try {
     const files = (await readdir17(directory)).filter((name3) => name3.endsWith(".json")).sort();
     if (!files.length)
       return indexerProtocolDigest(null);
-    return indexerProtocolDigest(await Promise.all(files.map((name3) => readFile61(join72(directory, name3), "utf8"))));
+    return indexerProtocolDigest(await Promise.all(files.map((name3) => readFile61(join73(directory, name3), "utf8"))));
   } catch (error) {
     if (error.code === "ENOENT")
       return indexerProtocolDigest(null);
@@ -89164,7 +89196,7 @@ async function observeKnowledgeMaintenance(root) {
 async function maintenanceRevision(root) {
   const observed = await observeKnowledgeMaintenance(root);
   const localInputs = observed.state.active ? {
-    revision: await readFile61(join72(root, MAINTENANCE_ROOT, "revision.json"), "utf8").catch((error) => {
+    revision: await readFile61(join73(root, MAINTENANCE_ROOT, "revision.json"), "utf8").catch((error) => {
       if (error.code === "ENOENT")
         return null;
       throw error;
@@ -89241,7 +89273,7 @@ async function finishMaintenanceRevision(root, outcome = "completed") {
   outcome = state.active.completion_outcome;
   state.active.phase = "finishing";
   await saveMaintenance(root, state);
-  await rm15(join72(root, MAINTENANCE_ROOT, "revision.json"), { force: true });
+  await rm15(join73(root, MAINTENANCE_ROOT, "revision.json"), { force: true });
   state.completed.push({ id: state.active.input.id, input_digest: indexerProtocolDigest(state.active.input), outcome });
   delete state.active;
   await saveMaintenance(root, state);
@@ -89275,8 +89307,8 @@ async function discardMaintenanceDraft(root) {
   const owned = new Set([...request?.batch_candidates ?? [], ...request?.candidate ? [request.candidate] : []].map((item) => item.candidate_id));
   if (candidates.some((item) => !owned.has(item.candidate_id)))
     throw new TypeError("Unrelated Candidates are present; no draft was discarded. Inspect the current review before retrying cancellation.");
-  await rm15(join72(root, CANDIDATE_LEDGER_FILE), { force: true });
-  await rm15(join72(root, MAINTENANCE_ROOT, "revision.json"), { force: true });
+  await rm15(join73(root, CANDIDATE_LEDGER_FILE), { force: true });
+  await rm15(join73(root, MAINTENANCE_ROOT, "revision.json"), { force: true });
   const { closeProjectWorkspace: closeProjectWorkspace2 } = await Promise.resolve().then(() => (init_close(), exports_close));
   const { buildProjectPackages: buildProjectPackages2 } = await Promise.resolve().then(() => (init_packageBuilder(), exports_packageBuilder));
   await closeProjectWorkspace2(root);
@@ -89315,7 +89347,7 @@ __export(exports_approvedRevision, {
   APPROVED_REVISION_PATH: () => APPROVED_REVISION_PATH
 });
 import { readFile as readFile62, realpath as realpath8, rm as rm16 } from "node:fs/promises";
-import { join as join73, relative as relative21, isAbsolute as isAbsolute13 } from "node:path";
+import { join as join74, relative as relative21, isAbsolute as isAbsolute13 } from "node:path";
 function requestDigest(input) {
   const scopes = input.processed_scopes?.filter((scope2) => input.target.source_refs.some((ref2) => ref2 === scope2.source_ref || ref2.startsWith(`${scope2.source_ref}#`) || ref2.startsWith(`${scope2.source_ref}/`)));
   const ids = new Set(scopes?.map((scope2) => scope2.requirement_ref));
@@ -89353,7 +89385,7 @@ function revisionCandidateFingerprint(revision, markdown, sections) {
 }
 async function readApprovedRevision(projectRoot) {
   try {
-    return parseApprovedRevision(JSON.parse(await readFile62(join73(projectRoot, await revisionStoragePath(projectRoot)), "utf8")));
+    return parseApprovedRevision(JSON.parse(await readFile62(join74(projectRoot, await revisionStoragePath(projectRoot)), "utf8")));
   } catch (error) {
     if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
       return;
@@ -89412,12 +89444,12 @@ async function resolveApprovedRevisionAuthor(projectRoot, request) {
 }
 async function targetBytes(projectRoot, path2) {
   const project = await realpath8(projectRoot);
-  const root = await realpath8(join73(projectRoot, "knowledge"));
+  const root = await realpath8(join74(projectRoot, "knowledge"));
   const rootRelative = relative21(project, root);
   if (isAbsolute13(rootRelative) || rootRelative === ".." || rootRelative.startsWith("../")) {
     throw new TypeError("Approved knowledge directory leaves the Context workspace");
   }
-  const target = await realpath8(join73(root, path2));
+  const target = await realpath8(join74(root, path2));
   const rel = relative21(root, target);
   if (isAbsolute13(rel) || rel === ".." || rel.startsWith("../"))
     throw new TypeError("Approved revision target leaves knowledge/");
@@ -89573,7 +89605,7 @@ ${import_yaml36.default.stringify({ ...import_yaml36.default.parse(fields), type
       revision: requestDigest(payload)
     });
     if (input.persist !== false)
-      await atomicWriteFile(join73(input.projectRoot, await revisionStoragePath(input.projectRoot)), `${JSON.stringify(request)}
+      await atomicWriteFile(join74(input.projectRoot, await revisionStoragePath(input.projectRoot)), `${JSON.stringify(request)}
 `);
     return {
       status: "author-reopened",
@@ -89684,17 +89716,17 @@ async function completeApprovedRevision(input) {
       const { prepareRevisionBatchContinuation: prepareRevisionBatchContinuation3 } = await Promise.resolve().then(() => (init_approvedRevisionBatch(), exports_approvedRevisionBatch));
       const next2 = await prepareRevisionBatchContinuation3(input.projectRoot, request, request.batch_candidates ?? []);
       if (next2 || request.batch_candidates?.length || request.build_pending) {
-        await atomicWriteFile(join73(input.projectRoot, await revisionStoragePath(input.projectRoot)), `${JSON.stringify(next2 ?? { ...request, review_ready: true })}
+        await atomicWriteFile(join74(input.projectRoot, await revisionStoragePath(input.projectRoot)), `${JSON.stringify(next2 ?? { ...request, review_ready: true })}
 `);
       } else {
         await advanceApprovedRevision(input.projectRoot, request);
       }
       return;
     }
-    const current2 = await readFile62(join73(input.projectRoot, await revisionStoragePath(input.projectRoot)), "utf8");
+    const current2 = await readFile62(join74(input.projectRoot, await revisionStoragePath(input.projectRoot)), "utf8");
     let previous2;
     try {
-      previous2 = await readFile62(join73(input.projectRoot, CANDIDATE_LEDGER_FILE), "utf8");
+      previous2 = await readFile62(join74(input.projectRoot, CANDIDATE_LEDGER_FILE), "utf8");
     } catch (error) {
       if (!(error && typeof error === "object" && ("code" in error) && error.code === "ENOENT"))
         throw error;
@@ -89776,7 +89808,7 @@ async function advanceApprovedRevision(projectRoot, request, buildPending = fals
     return;
   const { readProductionStage: readProductionStage2 } = await Promise.resolve().then(() => (init_productionStageStore(), exports_productionStageStore));
   if (await readProductionStage2(projectRoot)) {
-    await rm16(join73(projectRoot, await revisionStoragePath(projectRoot)), { force: true });
+    await rm16(join74(projectRoot, await revisionStoragePath(projectRoot)), { force: true });
     return;
   }
   const { clearCompletedLifecycle: clearCompletedLifecycle2 } = await Promise.resolve().then(() => (init_lifecycleCleanup(), exports_lifecycleCleanup));
@@ -89847,12 +89879,12 @@ async function reopenApprovedRevision(input) {
         }))
       } : {}
     } };
-    const current2 = await readFile62(join73(input.projectRoot, await revisionStoragePath(input.projectRoot)), "utf8");
+    const current2 = await readFile62(join74(input.projectRoot, await revisionStoragePath(input.projectRoot)), "utf8");
     const content3 = `${JSON.stringify({ ...payload, revision: requestDigest(payload) })}
 `;
     let ledger;
     try {
-      ledger = await readFile62(join73(input.projectRoot, CANDIDATE_LEDGER_FILE), "utf8");
+      ledger = await readFile62(join74(input.projectRoot, CANDIDATE_LEDGER_FILE), "utf8");
     } catch (error) {
       if (!(error && typeof error === "object" && ("code" in error) && error.code === "ENOENT"))
         throw error;
@@ -89965,7 +89997,7 @@ var init_sourceInputMutation = __esm(() => {
 // src/project/documentCapture.ts
 import { createHash as createHash21 } from "node:crypto";
 import { mkdir as mkdir28, readdir as readdir18, readFile as readFile63, rm as rm17, stat as stat9, writeFile as writeFile23 } from "node:fs/promises";
-import { basename as basename8, dirname as dirname34, extname as extname12, join as join74, relative as relative22, resolve as resolve24 } from "node:path";
+import { basename as basename8, dirname as dirname34, extname as extname12, join as join75, relative as relative22, resolve as resolve24 } from "node:path";
 function toPosixPath7(path2) {
   return path2.split(/[\\/]+/u).filter((part) => part.length > 0).join("/");
 }
@@ -90088,7 +90120,7 @@ async function walkMarkdownFiles(input) {
   const visit3 = async (dir) => {
     const entries2 = await readdir18(dir, { withFileTypes: true });
     for (const entry of entries2) {
-      const absolutePath = join74(dir, entry.name);
+      const absolutePath = join75(dir, entry.name);
       if (entry.isDirectory()) {
         await visit3(absolutePath);
         continue;
@@ -90117,7 +90149,7 @@ async function writeTextIfChanged(path2, content3) {
   await writeFile23(path2, content3, "utf8");
 }
 function sourceManifestPath(entry) {
-  return entry.snapshot?.manifest ?? join74(entry.materializedAt, "manifest.json");
+  return entry.snapshot?.manifest ?? join75(entry.materializedAt, "manifest.json");
 }
 function runtimeError3(message, detail) {
   return new ContextError(ExitCode.UserError, message, {
@@ -90190,7 +90222,7 @@ async function removeEmptySnapshotDirs(root, dir = root) {
   for (const entry of entries2) {
     if (!entry.isDirectory() || entry.name === ".tmp" || entry.name === ".cache")
       continue;
-    await removeEmptySnapshotDirs(root, join74(dir, entry.name));
+    await removeEmptySnapshotDirs(root, join75(dir, entry.name));
   }
   if (dir === root)
     return;
@@ -90202,7 +90234,7 @@ async function removeEmptySnapshotDirs(root, dir = root) {
 async function cleanupStaleSnapshotFiles(input) {
   for (const path2 of input.previousPaths) {
     if (!input.currentPaths.has(path2)) {
-      await rm17(join74(input.materializedAtAbsPath, path2), { force: true });
+      await rm17(join75(input.materializedAtAbsPath, path2), { force: true });
     }
   }
   await removeEmptySnapshotDirs(input.materializedAtAbsPath);
@@ -90385,9 +90417,9 @@ async function runCaptureFilePhaseUnlocked(input) {
     documentSnapshot
   });
   const manifestPath = sourceManifestPath(entry);
-  const manifestAbsPath = join74(input.projectRoot, manifestPath);
+  const manifestAbsPath = join75(input.projectRoot, manifestPath);
   const materializedAt = entry.materializedAt;
-  const materializedAtAbsPath = join74(input.projectRoot, materializedAt);
+  const materializedAtAbsPath = join75(input.projectRoot, materializedAt);
   const manifestInput = {
     sourceType: "file",
     sourceName: resolved.sourceName,
@@ -90437,13 +90469,13 @@ async function runCaptureFilePhaseUnlocked(input) {
   }));
   try {
     for (const file of snapshotFiles) {
-      await writeTextIfChanged(join74(materializedAtAbsPath, file.path), String(file.bytes));
+      await writeTextIfChanged(join75(materializedAtAbsPath, file.path), String(file.bytes));
     }
     for (const file of files.metadata) {
-      await writeTextIfChanged(join74(materializedAtAbsPath, file.snapshotPath), routeMetadata.rawByPath.get(file.snapshotPath) ?? "");
+      await writeTextIfChanged(join75(materializedAtAbsPath, file.snapshotPath), routeMetadata.rawByPath.get(file.snapshotPath) ?? "");
     }
     for (const asset of linkedAssets) {
-      await writeCaptureAssetIfChanged(join74(materializedAtAbsPath, asset.snapshotPath), asset.bytes);
+      await writeCaptureAssetIfChanged(join75(materializedAtAbsPath, asset.snapshotPath), asset.bytes);
     }
     await writeTextIfChanged(manifestAbsPath, manifestContent);
     await cleanupStaleSnapshotFiles({
@@ -90621,7 +90653,7 @@ var init_larkCaptureReport = __esm(() => {
 
 // src/project/documentSnapshotFidelity.ts
 import { readFileSync as readFileSync7 } from "node:fs";
-import { join as join75 } from "node:path";
+import { join as join76 } from "node:path";
 function readDocumentSnapshotCaptureReport(input) {
   const summary = input.manifest.metadata?.capture?.report;
   if (summary === undefined)
@@ -90630,7 +90662,7 @@ function readDocumentSnapshotCaptureReport(input) {
   if (asset === undefined || asset.role !== "audit" || asset.content_hash === undefined) {
     throw new TypeError(`snapshot capture report is not registered as a hashed audit asset: ${summary.path}`);
   }
-  const bytes = readFileSync7(join75(input.projectRoot, input.materializedAt, summary.path));
+  const bytes = readFileSync7(join76(input.projectRoot, input.materializedAt, summary.path));
   if (computeDocumentContentHash(bytes) !== asset.content_hash) {
     throw new TypeError(`snapshot capture report hash does not match manifest: ${summary.path}`);
   }
@@ -90728,7 +90760,7 @@ function larkSnapshotIdentityDiagnostic(source2, manifest) {
 // src/project/repoSourceModules.ts
 import { existsSync as existsSync19 } from "node:fs";
 import { readFile as readFile64, readdir as readdir19 } from "node:fs/promises";
-import { join as join76, resolve as resolve25 } from "node:path";
+import { join as join77, resolve as resolve25 } from "node:path";
 async function rootNames(root) {
   try {
     return (await readdir19(root)).sort();
@@ -90737,7 +90769,7 @@ async function rootNames(root) {
   }
 }
 async function packageEntries(root) {
-  const path2 = join76(root, "package.json");
+  const path2 = join77(root, "package.json");
   if (!existsSync19(path2))
     return [];
   try {
@@ -90749,9 +90781,9 @@ async function packageEntries(root) {
   }
 }
 async function planningEvidence(inspectPath, module) {
-  const root = module.path === "." ? inspectPath : join76(inspectPath, module.path);
+  const root = module.path === "." ? inspectPath : join77(inspectPath, module.path);
   const names = await rootNames(root);
-  const commonEntries = ["src/index.ts", "src/index.tsx", "src/main.ts", "src/main.tsx", "main.go"].filter((path2) => existsSync19(join76(root, path2)));
+  const commonEntries = ["src/index.ts", "src/index.tsx", "src/main.ts", "src/main.tsx", "main.go"].filter((path2) => existsSync19(join77(root, path2)));
   const protocolNames = names.filter((name3) => /(?:openapi|swagger|schema|protocol|idl)/iu.test(name3) || /\.(?:proto|thrift)$/iu.test(name3));
   const lifecycleNames = names.filter((name3) => /(?:generated|vendor|mirror|legacy|sync)/iu.test(name3));
   return {
@@ -90789,7 +90821,7 @@ function suggestedModuleName(module) {
   return slug || "module";
 }
 async function inspectRepoSourceModules(input) {
-  const inspectPath = input.scopedAbs !== null && existsSync19(input.scopedAbs) ? input.scopedAbs : join76(input.projectRoot, input.status.materializedAt);
+  const inspectPath = input.scopedAbs !== null && existsSync19(input.scopedAbs) ? input.scopedAbs : join77(input.projectRoot, input.status.materializedAt);
   const modules = existsSync19(inspectPath) ? await detectModuleBoundaries(inspectPath, input.status.head ?? input.status.ref, DEFAULT_PATH_FILTER) : [];
   const recommended_sources = modules.filter((module) => module.path !== "." || modules.length === 1).map((module) => {
     const local = sourceModuleLocalForDisplay({ source: input.source, status: input.status, module });
@@ -90829,7 +90861,7 @@ var init_repoSourceModules = __esm(() => {
 
 // src/project/repoSourceRegistry.ts
 import { existsSync as existsSync20 } from "node:fs";
-import { join as join77 } from "node:path";
+import { join as join78 } from "node:path";
 function assertRepoModuleName(name3) {
   if (!SOURCE_NAME_PATTERN2.test(name3)) {
     throw new ContextError(ExitCode.UserError, `repo source name must be a lowercase path-safe slug: ${name3}`, {
@@ -90880,7 +90912,7 @@ function registryEntryToRecord(entry) {
   };
 }
 function registryPath(projectRoot) {
-  return join77(projectRoot, DEFAULT_REPO_SOURCES_REGISTRY_PATH);
+  return join78(projectRoot, DEFAULT_REPO_SOURCES_REGISTRY_PATH);
 }
 function defaultRepoMaterializedAt(source2) {
   return `sources/repo/${source2.namespace}/${source2.module}`;
@@ -90942,7 +90974,7 @@ import { existsSync as existsSync21 } from "node:fs";
 import { lstat as lstat9, mkdir as mkdir29, readFile as readFile65, readlink, realpath as realpath9, rm as rm18, symlink as symlink3 } from "node:fs/promises";
 import { execFile as execFile9 } from "node:child_process";
 import { promisify as promisify9 } from "node:util";
-import { dirname as dirname35, isAbsolute as isAbsolute14, join as join78, relative as relative23, resolve as resolve26 } from "node:path";
+import { dirname as dirname35, isAbsolute as isAbsolute14, join as join79, relative as relative23, resolve as resolve26 } from "node:path";
 function nonEmpty(value) {
   if (value == null)
     return null;
@@ -90996,13 +91028,13 @@ async function gitOutput(cwd, args) {
   }
 }
 async function readGitOriginRemote(cwd) {
-  const directConfigPath = join78(cwd, ".git", "config");
+  const directConfigPath = join79(cwd, ".git", "config");
   let config = await readFile65(directConfigPath, "utf8").catch(() => "");
   if (config.length === 0) {
     const gitDir = await resolveGitDir(cwd);
     if (gitDir === null)
       return null;
-    config = await readFile65(join78(gitDir, "config"), "utf8").catch(() => "");
+    config = await readFile65(join79(gitDir, "config"), "utf8").catch(() => "");
   }
   let inOriginBlock = false;
   for (const line of config.split(/\r?\n/u)) {
@@ -91022,7 +91054,7 @@ async function readGitOriginRemote(cwd) {
 async function resolveGitRoot(cwd) {
   let current2 = resolve26(cwd);
   while (true) {
-    if (existsSync21(join78(current2, ".git")))
+    if (existsSync21(join79(current2, ".git")))
       return current2;
     const parent = dirname35(current2);
     if (parent === current2)
@@ -91031,7 +91063,7 @@ async function resolveGitRoot(cwd) {
   }
 }
 async function resolveGitDir(cwd) {
-  const dotGit = join78(cwd, ".git");
+  const dotGit = join79(cwd, ".git");
   if (!existsSync21(dotGit))
     return null;
   const stats = await lstat9(dotGit);
@@ -91049,17 +91081,17 @@ async function readGitHead(cwd) {
   const gitDir = await resolveGitDir(cwd);
   if (gitDir === null)
     return null;
-  const headRaw = (await readFile65(join78(gitDir, "HEAD"), "utf8").catch(() => "")).trim();
+  const headRaw = (await readFile65(join79(gitDir, "HEAD"), "utf8").catch(() => "")).trim();
   if (/^[a-f0-9]{40}$/iu.test(headRaw))
     return headRaw.toLowerCase();
   const match = /^ref:\s*(.+)\s*$/iu.exec(headRaw);
   const refPath = match?.[1];
   if (refPath === undefined)
     return null;
-  const looseRef = (await readFile65(join78(gitDir, refPath), "utf8").catch(() => "")).trim();
+  const looseRef = (await readFile65(join79(gitDir, refPath), "utf8").catch(() => "")).trim();
   if (/^[a-f0-9]{40}$/iu.test(looseRef))
     return looseRef.toLowerCase();
-  const packedRefs = await readFile65(join78(gitDir, "packed-refs"), "utf8").catch(() => "");
+  const packedRefs = await readFile65(join79(gitDir, "packed-refs"), "utf8").catch(() => "");
   for (const line of packedRefs.split(/\r?\n/u)) {
     if (line.startsWith("#") || line.startsWith("^"))
       continue;
@@ -91070,7 +91102,7 @@ async function readGitHead(cwd) {
   return null;
 }
 async function ensureMaterializedSymlink(input) {
-  const linkPath = join78(input.projectRoot, input.materializedAt);
+  const linkPath = join79(input.projectRoot, input.materializedAt);
   await mkdir29(dirname35(linkPath), { recursive: true });
   if (existsSync21(linkPath)) {
     const stats = await lstat9(linkPath);
@@ -91089,7 +91121,7 @@ async function ensureMaterializedSymlink(input) {
   return true;
 }
 async function diagnoseMaterializedSymlink(input) {
-  const linkPath = join78(input.projectRoot, input.materializedAt);
+  const linkPath = join79(input.projectRoot, input.materializedAt);
   if (!existsSync21(linkPath)) {
     input.diagnostics.push(`materialized path is missing: ${input.materializedAt}`);
     input.agent_hints.push(`Run context source ensure ${input.sourceName} to materialize the local source link.`);
@@ -91312,7 +91344,7 @@ async function inspectRepoSource(input) {
   const subpath = normalizeSubpath2(source2.subpath);
   const scopedAbs = localAbs === null ? null : scopedLocalPath(localAbs, subpath);
   const scopeExists = scopedAbs !== null && existsSync21(scopedAbs);
-  let materialized = existsSync21(join78(input.projectRoot, materializedAt));
+  let materialized = existsSync21(join79(input.projectRoot, materializedAt));
   const checkout = await inspectRepoCheckout({
     source: source2,
     localAbs,
@@ -91498,7 +91530,7 @@ var init_entityId = __esm(() => {
 // src/project/reviewShared.ts
 import { createHash as createHash22 } from "node:crypto";
 import { mkdir as mkdir30, writeFile as writeFile24 } from "node:fs/promises";
-import { dirname as dirname36, join as join79 } from "node:path";
+import { dirname as dirname36, join as join80 } from "node:path";
 function isRecord14(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -91541,7 +91573,7 @@ async function buildApprovedArticleIndex(projectRoot) {
     if (!isApprovedKnowledgeMarkdownPath(rel))
       continue;
     const { absPath, content: content3 } = file;
-    const relPath = join79("knowledge", collection, rel);
+    const relPath = join80("knowledge", collection, rel);
     assetReferencesByRelPath.set(relPath, knowledgeAssetReferences({
       pageRelPath: relPath,
       content: content3
@@ -91554,7 +91586,7 @@ async function buildApprovedArticleIndex(projectRoot) {
       continue;
     const frontmatter2 = hydrateApprovedFrontmatter({
       frontmatter: parsed,
-      relPath: join79(collection, rel),
+      relPath: join80(collection, rel),
       metadata
     });
     const article = articlesByPath.get(`${collection}/${rel}`);
@@ -91609,8 +91641,8 @@ ${yaml3}
 }
 async function writeReviewActionLog(input) {
   const stamp = new Date().toISOString().replace(/[-:.TZ]/gu, "");
-  const relPath = join79(REVIEW_ACTION_ROOT2, `${stamp}-${input.action}-${input.id.replace(/[\\/]+/gu, "_")}.json`);
-  const path2 = join79(input.projectRoot, relPath);
+  const relPath = join80(REVIEW_ACTION_ROOT2, `${stamp}-${input.action}-${input.id.replace(/[\\/]+/gu, "_")}.json`);
+  const path2 = join80(input.projectRoot, relPath);
   await mkdir30(dirname36(path2), { recursive: true });
   await writeFile24(path2, `${JSON.stringify({
     action: input.action,
@@ -91643,7 +91675,7 @@ var init_reviewShared = __esm(() => {
   init_knowledgeAssets();
   init_entityId();
   import_yaml38 = __toESM(require_dist(), 1);
-  REVIEW_ACTION_ROOT2 = join79(".tmp", "context-runtime", "review-actions");
+  REVIEW_ACTION_ROOT2 = join80(".tmp", "context-runtime", "review-actions");
 });
 
 // src/project/managedDocumentStatus.ts
@@ -91719,7 +91751,7 @@ __export(exports_statusReaders, {
   countFiles: () => countFiles
 });
 import { existsSync as existsSync22, readFileSync as readFileSync8 } from "node:fs";
-import { join as join80 } from "node:path";
+import { join as join81 } from "node:path";
 async function countFiles(root, predicate) {
   if (!existsSync22(root))
     return 0;
@@ -91728,7 +91760,7 @@ async function countFiles(root, predicate) {
     const entries2 = await readCommandDirectory(dir);
     for (const entry of entries2) {
       const rel = prefix.length === 0 ? entry.name : `${prefix}/${entry.name}`;
-      const abs = join80(dir, entry.name);
+      const abs = join81(dir, entry.name);
       if (entry.isDirectory())
         await visit3(abs, rel);
       else if (entry.isFile() && predicate(rel))
@@ -91919,7 +91951,7 @@ async function documentSourceSiteHint(input) {
   });
 }
 function documentSnapshotReadiness(input) {
-  const manifestPath = join80(input.projectRoot, input.manifest);
+  const manifestPath = join81(input.projectRoot, input.manifest);
   if (!existsSync22(manifestPath)) {
     return {
       ready: false,
@@ -91989,7 +92021,7 @@ function documentSnapshotReadiness(input) {
     const missingFiles = [
       ...manifest.files.map((file) => file.path),
       ...(manifest.assets ?? []).filter((asset) => asset.content_hash !== undefined).map((asset) => asset.path)
-    ].filter((path2) => !existsSync22(join80(input.projectRoot, input.materializedAt, path2)));
+    ].filter((path2) => !existsSync22(join81(input.projectRoot, input.materializedAt, path2)));
     if (missingFiles.length > 0) {
       return {
         ready: false,
@@ -92780,7 +92812,7 @@ var init_workflowProvider = __esm(() => {
 
 // src/project/productionStageRefresh.ts
 import { readFile as readFile67 } from "node:fs/promises";
-import { join as join82 } from "node:path";
+import { join as join83 } from "node:path";
 async function refreshProductionStageSources(projectRoot, stage) {
   const affected = new Set(stage.gaps.map((gap) => gap.scope));
   const unavailable = new Map;
@@ -92820,8 +92852,8 @@ Restore the authorized source and retry preparation.
     tasks: stage.tasks.map((task) => !["accepted", "excluded", "replaced"].includes(task.status) && task.sources.some((source2) => affected.has(source2.scope)) ? { ...task, status: "blocked", reason: "Source material refreshed; investigate and explicitly replace this unfinished task." } : task)
   });
   const directory = productionStageDirectory(stage.id);
-  const contents2 = new Map([...sourceMaterials].map(([scope2, content3]) => [join82(directory, productionSourceFile(scope2)), content3]));
-  contents2.set(join82(directory, "manifest.json"), `${JSON.stringify(updated)}
+  const contents2 = new Map([...sourceMaterials].map(([scope2, content3]) => [join83(directory, productionSourceFile(scope2)), content3]));
+  contents2.set(join83(directory, "manifest.json"), `${JSON.stringify(updated)}
 `);
   const targets = [];
   for (const [path2, content3] of contents2) {
@@ -92951,7 +92983,7 @@ var init_productionReport = __esm(() => {
 });
 
 // src/project/productionPlanningRoute.ts
-import { join as join83 } from "node:path";
+import { join as join84 } from "node:path";
 async function productionPlanningRoute(input, stage) {
   const request = stage ? undefined : await productionPlanningRequest(input.projectRoot);
   const present = !!stage || !!request;
@@ -92989,7 +93021,7 @@ async function productionPlanningRoute(input, stage) {
           id: `production/${stage.id}/planning`,
           kind: "context-view",
           media_type: "text/markdown",
-          path: join83(input.projectRoot, productionStageDirectory(stage.id), "planning.md"),
+          path: join84(input.projectRoot, productionStageDirectory(stage.id), "planning.md"),
           read_state: "read-required"
         }] : []
       ],
@@ -93008,7 +93040,7 @@ var init_productionPlanningRoute = __esm(() => {
 
 // src/project/productionWorkflowRoute.ts
 import { existsSync as existsSync24 } from "node:fs";
-import { join as join84 } from "node:path";
+import { join as join85 } from "node:path";
 async function productionWorkflowRoute(input) {
   const stage = await readProductionStage(input.projectRoot);
   if (!stage || !stage.planning_complete)
@@ -93026,7 +93058,7 @@ async function productionWorkflowRoute(input) {
   const selected = new Set(dispatch.batches.flatMap((batch) => batch.tasks));
   const context = { workspace: input.projectRoot, authorities: [...input.authorities], facts: { production: {
     report_approved: stage.report_approved,
-    prepared: !dispatch.batches.length || existsSync24(join84(input.projectRoot, directory, "stage.md")) && stage.tasks.filter((task) => selected.has(task.id)).every((task) => task.status === "issued"),
+    prepared: !dispatch.batches.length || existsSync24(join85(input.projectRoot, directory, "stage.md")) && stage.tasks.filter((task) => selected.has(task.id)).every((task) => task.status === "issued"),
     writing_complete: dispatch.batches.length === 0,
     complete: dispatch.state === "ended",
     review_clear: rejected.length === 0,
@@ -93043,7 +93075,7 @@ async function productionWorkflowRoute(input) {
   const resolved = await resolveRoute(provider, "indexer", "production", primary.routeId, context, evaluated.evaluation.revision);
   const report = resolved.node === "confirm-production-report";
   if (report)
-    await writeProductionProjection(input.projectRoot, join84(directory, "plan.md"), productionPlanMarkdown(stage));
+    await writeProductionProjection(input.projectRoot, join85(directory, "plan.md"), productionPlanMarkdown(stage));
   const prepare = resolved.node === "prepare-production-stage";
   const writing = resolved.node === "work-production-stage";
   const repair = resolved.node === "repair-production-articles";
@@ -93058,7 +93090,7 @@ async function productionWorkflowRoute(input) {
     id: `production/${stage.id}/${report ? "plan" : "stage"}`,
     kind: "context-view",
     media_type: "text/markdown",
-    path: join84(input.projectRoot, directory, path3),
+    path: join85(input.projectRoot, directory, path3),
     read_state: "read-required"
   });
   if (report || writing)
@@ -93069,18 +93101,18 @@ async function productionWorkflowRoute(input) {
       id: `production/${stage.id}/planning`,
       kind: "context-view",
       media_type: "text/markdown",
-      path: join84(input.projectRoot, directory, "planning.md"),
+      path: join85(input.projectRoot, directory, "planning.md"),
       read_state: "read-required"
     });
   }
   if (repair) {
-    await writeProductionProjection(input.projectRoot, join84(directory, "repair.md"), [
+    await writeProductionProjection(input.projectRoot, join85(directory, "repair.md"), [
       "# Revise rejected articles",
       "",
       ...rejected.map((candidate) => `- ${candidate.path}: ${candidate.review.title}`),
       "",
       "Use the user's Review feedback to add revision tasks for these article paths. Rejection does not cancel their planned responsibilities. Ask for missing feedback instead of guessing the reason.",
-      `Submit the plan amendment to ${path2} using ${join84(directory, "planning.schema.json")}. Keep accepted task identities unchanged; the CLI assigns the revision tasks and preserves article identities.`,
+      `Submit the plan amendment to ${path2} using ${join85(directory, "planning.schema.json")}. Keep accepted task identities unchanged; the CLI assigns the revision tasks and preserves article identities.`,
       "Once issued, repair the affected sections through the existing edits submission. Unchanged sections and references do not need resubmission.",
       ""
     ].join(`
@@ -93089,7 +93121,7 @@ async function productionWorkflowRoute(input) {
       id: `production/${stage.id}/repair`,
       kind: "context-view",
       media_type: "text/markdown",
-      path: join84(input.projectRoot, directory, "repair.md"),
+      path: join85(input.projectRoot, directory, "repair.md"),
       read_state: "read-required"
     });
   }
@@ -93106,7 +93138,7 @@ async function productionWorkflowRoute(input) {
     revision,
     reason_code: resolved.reasonCode,
     availability: resolved.availability,
-    summary: report ? `Present the report and wait. After approval, write {stage: ${stage.id}, decision: approved} to ${path2}.` : writing ? "Read the issued task directories. Coordinate them sequentially unless this caller supports independent Agents; only the coordinator submits shared state." : repair ? "Add revision tasks for rejected articles using the Review feedback; accepted production responsibilities remain unchanged." : investigate ? `Review pending configured scopes: ${stage.pending_scopes.filter((scope2) => !stage.gaps.some((gap2) => gap2.scope === scope2)).join(", ")}. Check their relevance to the current request and existing approved content before assigning investigation. Submit supported article tasks and remaining pending_scopes; do not infer missing articles from this list or repeat accepted work. If the requested articles are already accepted, context run --deliver --format json enters their Review while retaining unrelated pending scopes.` : resolved.node === "resolve-production-gap" ? `Source availability gaps: ${stage.gaps.map((gap2) => `${gap2.scope}: ${gap2.reason}`).join("; ")}. These failures do not establish missing knowledge or a new investigation assignment. Identify which sources the current task actually depends on; report unrelated configured-source failures separately. Preserve the configuration. To review completed articles independently, use context run --deliver --format json; this retains pending scopes and does not approve or publish content. If these sources are required, use context source recovery-plan --format json and context source restore with explicit local or clone decisions before preparation.` : "Prepare the current stage's eligible task directories.",
+    summary: report ? `Present the report and apply context.gate.work_start_scope. After the applicable scope decision, write {stage: ${stage.id}, decision: approved} to ${path2}.` : writing ? "Read the issued task directories. Coordinate them sequentially unless this caller supports independent Agents; only the coordinator submits shared state." : repair ? "Add revision tasks for rejected articles using the Review feedback; accepted production responsibilities remain unchanged." : investigate ? `Review pending configured scopes: ${stage.pending_scopes.filter((scope2) => !stage.gaps.some((gap2) => gap2.scope === scope2)).join(", ")}. Check their relevance to the current request and existing approved content before assigning investigation. Submit supported article tasks and remaining pending_scopes; do not infer missing articles from this list or repeat accepted work. If the requested articles are already accepted, context run --deliver --format json enters their Review while retaining unrelated pending scopes.` : resolved.node === "resolve-production-gap" ? `Source availability gaps: ${stage.gaps.map((gap2) => `${gap2.scope}: ${gap2.reason}`).join("; ")}. These failures do not establish missing knowledge or a new investigation assignment. Identify which sources the current task actually depends on; report unrelated configured-source failures separately. Preserve the configuration. To review completed articles independently, use context run --deliver --format json; this retains pending scopes and does not approve or publish content. If these sources are required, use context source recovery-plan --format json and context source restore with explicit local or clone decisions before preparation.` : "Prepare the current stage's eligible task directories.",
     commands: report || prepare || writing || repair || investigate || gap ? [{
       command: command2,
       effect: "write",
@@ -97873,7 +97905,7 @@ var init_larkResourceCommand = __esm(() => {
 // src/lib/larkResourceMaterialization.ts
 import { createHash as createHash28 } from "node:crypto";
 import { mkdtemp as mkdtemp4, readFile as readFile74, readdir as readdir21, rm as rm20 } from "node:fs/promises";
-import { extname as extname13, join as join93 } from "node:path";
+import { extname as extname13, join as join94 } from "node:path";
 import { tmpdir } from "node:os";
 function countByKind(items, status) {
   const counts2 = new Map;
@@ -97981,7 +98013,7 @@ async function downloadedFile(input) {
     const bytes = await readFile74(input.localPath);
     return { path: input.localPath, bytes, mediaType: mediaTypeFor(input.localPath, bytes) };
   }
-  const tempRoot = await mkdtemp4(join93(tmpdir(), "context-lark-resource-"));
+  const tempRoot = await mkdtemp4(join94(tmpdir(), "context-lark-resource-"));
   try {
     await runLarkResourceCommand(input.runner, [
       "docs",
@@ -98002,7 +98034,7 @@ async function downloadedFile(input) {
     if (entries2.length !== 1)
       throw new Error(`media download produced ${entries2.length} files, expected exactly one`);
     const path3 = entries2[0]?.name ?? "resource.bin";
-    const bytes = await readFile74(join93(tempRoot, path3));
+    const bytes = await readFile74(join94(tempRoot, path3));
     return { path: path3, bytes, mediaType: mediaTypeFor(path3, bytes) };
   } finally {
     await rm20(tempRoot, { recursive: true, force: true });
@@ -98093,9 +98125,9 @@ async function sheetMaterialization(resource, runner2, identity2) {
   const sheetId = resource.attributes["sheet-id"];
   if (token === undefined || sheetId === undefined)
     throw new Error("embedded Sheet requires token and sheet-id");
-  const tempRoot = await mkdtemp4(join93(tmpdir(), "context-lark-sheet-"));
+  const tempRoot = await mkdtemp4(join94(tmpdir(), "context-lark-sheet-"));
   try {
-    const outputPath = join93(tempRoot, "sheet.json");
+    const outputPath = join94(tempRoot, "sheet.json");
     const stdout = await runLarkResourceCommand(runner2, [
       "sheets",
       "+csv-get",
@@ -98251,7 +98283,7 @@ async function whiteboardMaterialization(resource, runner2, identity2) {
   if (token === undefined)
     throw new Error(`${resource.kind} has no whiteboard token`);
   const preview = await downloadedFile({ runner: runner2, identity: identity2, token, type: "whiteboard" });
-  const tempRoot = await mkdtemp4(join93(tmpdir(), "context-lark-whiteboard-"));
+  const tempRoot = await mkdtemp4(join94(tmpdir(), "context-lark-whiteboard-"));
   let rawPayload;
   try {
     await runLarkResourceCommand(runner2, [
@@ -98269,7 +98301,7 @@ async function whiteboardMaterialization(resource, runner2, identity2) {
       "--format",
       "json"
     ], { cwd: tempRoot });
-    rawPayload = JSON.parse(await readFile74(join93(tempRoot, "raw.json"), "utf8"));
+    rawPayload = JSON.parse(await readFile74(join94(tempRoot, "raw.json"), "utf8"));
   } finally {
     await rm20(tempRoot, { recursive: true, force: true });
   }
@@ -98631,7 +98663,7 @@ function resolveDocsFetchPlan(requested, runner2) {
   }
   return capabilitiesPromise.then((capabilities) => {
     if (!capabilities.supportsDocFormat) {
-      throw new LarkCliError(`${LARK_BIN} docs +fetch does not support --doc-format xml; upgrade @larksuite/cli before capturing Lark sources`, 0, "");
+      throw new LarkCliError(`${LARK_BIN} docs +fetch does not support --doc-format xml; a compatible @larksuite/cli is required to capture Lark sources`, 0, "");
     }
     return { apiVersion: capabilities.apiVersion, docFormat: "xml" };
   });
@@ -98642,7 +98674,7 @@ function docsFetchFailureMessage(stderr, apiVersion) {
   const mentionsV2 = /api-version|--api-version|v2|deprecated|lark-cli update/iu.test(stderr);
   if (apiVersion === "v1" && mentionsV2) {
     return `${base}
-Detected docs API v2 guidance from lark-cli. Upgrade @larksuite/cli and run \`lark-cli update\`; newer docs +fetch supports \`--api-version v2\`.`;
+Detected docs API v2 guidance from lark-cli; a compatible CLI with \`--api-version v2\` is required.`;
   }
   return base;
 }
@@ -98707,7 +98739,7 @@ function extractDocsFetchContent(payload, requestedFormat) {
   const withTitle = (result) => title2 === undefined ? result : { ...result, title: title2 };
   if (markdown !== undefined) {
     if (requestedFormat === "xml") {
-      throw new LarkCliError(`${LARK_BIN} docs +fetch returned Markdown despite --doc-format xml; capture stopped because the response cannot provide auditable rich-block fidelity. Upgrade lark-cli and retry.`, 0, "");
+      throw new LarkCliError(`${LARK_BIN} docs +fetch returned Markdown despite --doc-format xml; capture stopped because the response cannot provide auditable rich-block fidelity. Use a compatible CLI and retry.`, 0, "");
     }
     return withTitle({ body: markdown, format: "markdown", recognizedShape: true });
   }
@@ -99038,7 +99070,7 @@ ${body2}`,
   };
 }
 var LARK_BIN = "lark-cli", MAX_FETCH_PAGES = 50, MAX_STRUCTURAL_FETCH_ATTEMPTS = 2, LarkCliNotInstalledError, LarkCliError, defaultRunner = (args, options) => new Promise((resolve8, reject) => {
-  const child = spawn4(LARK_BIN, args, {
+  const child = spawn4(process.env.CONTEXT_LARK_CLI_BIN?.trim() || LARK_BIN, args, {
     ...options?.cwd === undefined ? {} : { cwd: options.cwd },
     stdio: ["ignore", "pipe", "pipe"]
   });
@@ -99119,7 +99151,7 @@ var init_sensitiveSourceLiteral = __esm(() => {
 
 // src/project/documentCaptureLark.ts
 import { readdir as readdir22, readFile as readFile75 } from "node:fs/promises";
-import { basename as basename10, extname as extname14, join as join94 } from "node:path";
+import { basename as basename10, extname as extname14, join as join95 } from "node:path";
 function titleFromMarkdown2(markdown, fallbackPath) {
   const heading2 = markdown.split(`
 `).find((line) => /^#\s+\S/u.test(line));
@@ -99146,7 +99178,7 @@ async function fileContentMatches(path3, content3) {
   }
 }
 function sourceManifestPath2(entry) {
-  return entry.snapshot?.manifest ?? join94(entry.materializedAt, "manifest.json");
+  return entry.snapshot?.manifest ?? join95(entry.materializedAt, "manifest.json");
 }
 function larkRuntimeError(message, detail) {
   return new ContextError(ExitCode.ExternalToolError, message, {
@@ -99193,6 +99225,7 @@ function larkTarget(entry) {
 }
 function larkErrorRecovery(error, sourceName) {
   const message = error instanceof Error ? error.message : String(error);
+  const localCliRecovery = `Install @larksuite/cli in a private directory with \`npm install --prefix "$HOME/.cache/context/lark-cli" @larksuite/cli@latest\`, then rerun \`CONTEXT_LARK_CLI_BIN="$HOME/.cache/context/lark-cli/node_modules/.bin/lark-cli" context run capture:lark:${sourceName}\`. Keep this variable on subsequent Context commands that access Lark; do not replace the global lark-cli.`;
   const environmentIssue = detectExternalEnvironmentIssue(message);
   if (environmentIssue !== undefined) {
     return {
@@ -99207,13 +99240,13 @@ function larkErrorRecovery(error, sourceName) {
   if (error instanceof LarkCliNotInstalledError || /not installed|ENOENT/iu.test(message)) {
     return {
       reasonCode: "external.dependency-missing",
-      next: "Install lark-cli from https://github.com/larksuite/cli, then rerun capture"
+      next: localCliRecovery
     };
   }
   if (/does not support --doc-format|api-version|deprecated|unsupported tool version|tool version unsupported/iu.test(message)) {
     return {
       reasonCode: "external.tool-version-unsupported",
-      next: "Run lark-cli update, confirm docs +fetch --help lists --doc-format, then rerun capture"
+      next: localCliRecovery
     };
   }
   if (/empty|unsupported payload shape|not JSON|parse/iu.test(message)) {
@@ -99272,7 +99305,7 @@ function assetManifestEntry(asset, assetRoot) {
   };
 }
 async function listSnapshotAssetFiles(root2, assetRoot) {
-  const assetsRoot = join94(root2, assetRoot);
+  const assetsRoot = join95(root2, assetRoot);
   const files = [];
   const visit4 = async (dir, prefix = assetRoot) => {
     let entries2;
@@ -99285,7 +99318,7 @@ async function listSnapshotAssetFiles(root2, assetRoot) {
     }
     for (const entry of entries2) {
       const relPath = `${prefix}/${entry.name}`;
-      const absolutePath = join94(dir, entry.name);
+      const absolutePath = join95(dir, entry.name);
       if (entry.isDirectory()) {
         await visit4(absolutePath, relPath);
         continue;
@@ -99300,7 +99333,7 @@ async function listSnapshotAssetFiles(root2, assetRoot) {
 }
 async function staleSnapshotAssetPaths(input) {
   const existingPaths = await listSnapshotAssetFiles(input.materializedAtAbsPath, input.assetRoot);
-  return existingPaths.filter((path3) => !input.currentPaths.has(path3)).map((path3) => join94(input.materializedAtAbsPath, path3));
+  return existingPaths.filter((path3) => !input.currentPaths.has(path3)).map((path3) => join95(input.materializedAtAbsPath, path3));
 }
 function normalizeLarkError(error, sourceName) {
   if (error instanceof ContextError)
@@ -99412,9 +99445,9 @@ async function runCaptureLarkPhaseUnlocked(input) {
     locator
   }];
   const manifestPath = sourceManifestPath2(entry);
-  const manifestAbsPath = join94(input.projectRoot, manifestPath);
+  const manifestAbsPath = join95(input.projectRoot, manifestPath);
   const materializedAt = entry.materializedAt;
-  const materializedAtAbsPath = join94(input.projectRoot, materializedAt);
+  const materializedAtAbsPath = join95(input.projectRoot, materializedAt);
   const manifest = createDocumentSnapshotManifest({
     sourceType: "lark",
     sourceName: resolved.sourceName,
@@ -99448,13 +99481,13 @@ async function runCaptureLarkPhaseUnlocked(input) {
   }));
   try {
     const requestedWrites = [{
-      path: join94(materializedAtAbsPath, documentPath),
+      path: join95(materializedAtAbsPath, documentPath),
       bytes: normalized
     }];
     for (const asset of assets) {
       if (asset.bytes !== undefined) {
         requestedWrites.push({
-          path: join94(materializedAtAbsPath, asset.entry.path),
+          path: join95(materializedAtAbsPath, asset.entry.path),
           bytes: asset.bytes
         });
       }
@@ -99471,7 +99504,7 @@ async function runCaptureLarkPhaseUnlocked(input) {
       currentPaths: new Set(assets.filter((asset) => asset.bytes !== undefined).map((asset) => asset.entry.path))
     });
     await applyAtomicFileBatch({
-      transactionRoot: join94(input.projectRoot, ".tmp", "context-runtime", "capture-transactions"),
+      transactionRoot: join95(input.projectRoot, ".tmp", "context-runtime", "capture-transactions"),
       writes,
       removals
     });
@@ -99901,7 +99934,7 @@ __export(exports_writeLockRecovery, {
   inspectWriterLock: () => inspectWriterLock
 });
 import { lstat as lstat10, mkdir as mkdir34, readFile as readFile82, readdir as readdir24, rename as rename8, rmdir as rmdir2 } from "node:fs/promises";
-import { join as join99 } from "node:path";
+import { join as join100 } from "node:path";
 import { createHash as createHash30, randomUUID as randomUUID7 } from "node:crypto";
 async function inspectWriterLock(root2) {
   const path3 = await safeProjectTarget(root2, lockRelative);
@@ -99948,8 +99981,8 @@ async function recoverWriterLock(input) {
     };
   if (input.plan_digest !== before.digest)
     throw new Error("Writer lock changed; preview recovery again.");
-  const path3 = join99(input.projectRoot, lockRelative);
-  const guard = join99(path3, ".recovery");
+  const path3 = join100(input.projectRoot, lockRelative);
+  const guard = join100(path3, ".recovery");
   await mkdir34(guard);
   let archived = false;
   try {
@@ -99960,7 +99993,7 @@ async function recoverWriterLock(input) {
     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 rename8(path3, join99(input.projectRoot, archive));
+    await rename8(path3, join100(input.projectRoot, archive));
     archived = true;
     return { action: "writer-lock-recovered", archived_lock: archive, next: "context task recover --format json" };
   } finally {
@@ -99984,7 +100017,7 @@ __export(exports_taskRecovery, {
   RECOVERY_COMMAND: () => RECOVERY_COMMAND
 });
 import { existsSync as existsSync26 } from "node:fs";
-import { dirname as dirname41, join as join100 } from "node:path";
+import { dirname as dirname41, join as join101 } from "node:path";
 import { lstat as lstat11, readdir as readdir25, readFile as readFile83 } from "node:fs/promises";
 async function recoveryText(root2, path3) {
   const target = await safeProjectTarget(root2, path3);
@@ -100002,7 +100035,7 @@ async function recoveryJournals(root2) {
     await safeProjectTarget(root2, path3);
     let stat10;
     try {
-      stat10 = await lstat11(join100(root2, path3));
+      stat10 = await lstat11(join101(root2, path3));
     } catch (error) {
       if (error.code === "ENOENT")
         return;
@@ -100013,7 +100046,7 @@ async function recoveryJournals(root2) {
     if (stat10.isDirectory()) {
       if (depth > 3)
         throw new TypeError("Unexpected transaction directory depth; preserve it for diagnosis.");
-      for (const name3 of (await readdir25(join100(root2, path3))).sort())
+      for (const name3 of (await readdir25(join101(root2, path3))).sort())
         await visit4(`${path3}/${name3}`, depth + 1);
     } else if (stat10.isFile())
       entries2.push({ path: path3, digest: indexerProtocolDigest(await recoveryText(root2, path3)) });
@@ -100025,8 +100058,8 @@ function recoveryResources() {
   try {
     const root2 = dirname41(contextWorkflowProviderPath());
     const resources = {
-      skill: join100(root2, "skills/recover-workspace/SKILL.md"),
-      issue_template: join100(root2, "resources/templates/recovery-issue.md")
+      skill: join101(root2, "skills/recover-workspace/SKILL.md"),
+      issue_template: join101(root2, "resources/templates/recovery-issue.md")
     };
     if (!Object.values(resources).every((path3) => existsSync26(path3)))
       throw new Error("Recovery resources are absent from this Provider.");
@@ -100112,7 +100145,7 @@ __export(exports_taskLocalSourceAdjustment, {
   adjustLocalRevisionSources: () => adjustLocalRevisionSources
 });
 import { readFile as readFile84 } from "node:fs/promises";
-import { join as join101 } from "node:path";
+import { join as join102 } 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))
@@ -100155,7 +100188,7 @@ 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 readFile84(join101(root2, await revisionStoragePath(root2)), "utf8");
+  const raw = await readFile84(join102(root2, await revisionStoragePath(root2)), "utf8");
   let next2;
   const discardIds = new Set;
   if (!input.refresh) {
@@ -100258,7 +100291,7 @@ ${input.instruction}` : revision.instruction
     content: content3
   }];
   if (discardIds.size > 0) {
-    const ledger = await readFile84(join101(root2, CANDIDATE_LEDGER_FILE), "utf8").catch((error) => {
+    const ledger = await readFile84(join102(root2, CANDIDATE_LEDGER_FILE), "utf8").catch((error) => {
       if (error.code === "ENOENT")
         return;
       throw error;
@@ -100515,7 +100548,7 @@ __export(exports_managedDocumentRename, {
   renameManagedDocument: () => renameManagedDocument
 });
 import { readFile as readFile92 } from "node:fs/promises";
-import { join as join109, posix as posix11 } from "node:path";
+import { join as join110, posix as posix11 } from "node:path";
 async function optionalText2(path3) {
   try {
     return await readFile92(path3, "utf8");
@@ -100602,7 +100635,7 @@ 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(join109(input.projectRoot, path3));
+      const before = await optionalText2(join110(input.projectRoot, path3));
       if (before === undefined)
         continue;
       let after;
@@ -100691,7 +100724,7 @@ var init_managedDocumentRename = __esm(() => {
 
 // src/cli.ts
 import { existsSync as existsSync36, realpathSync as realpathSync3 } from "node:fs";
-import { dirname as dirname50, join as join115 } from "node:path";
+import { dirname as dirname49, join as join116 } from "node:path";
 import { fileURLToPath as fileURLToPath11, pathToFileURL as pathToFileURL3 } from "node:url";
 
 // ../../node_modules/.bun/commander@11.1.0/node_modules/commander/esm.mjs
@@ -100746,7 +100779,7 @@ init_dist();
 init_cliFeedback();
 init_errors3();
 init_exitCode();
-import { join as join91 } from "node:path";
+import { join as join92 } from "node:path";
 
 // src/project/documentCaptureAvailability.ts
 init_atomicFileBatch();
@@ -100755,11 +100788,11 @@ init_documentRun();
 init_writeLock();
 import { createHash as createHash23 } from "node:crypto";
 import { readFile as readFile66, rm as rm19 } from "node:fs/promises";
-import { join as join81 } from "node:path";
+import { join as join82 } from "node:path";
 import { isDeepStrictEqual } from "node:util";
 function receiptPath(root, phaseId) {
   const key = createHash23("sha256").update(phaseId).digest("hex");
-  return join81(root, ".tmp/context-runtime/document-acquisition", `${key}.json`);
+  return join82(root, ".tmp/context-runtime/document-acquisition", `${key}.json`);
 }
 async function identity(root, phase) {
   const resolved = await resolveDocumentPhaseSource({ projectRoot: root, phase });
@@ -100791,7 +100824,7 @@ async function runDocumentCaptureWithAvailability(root, phase, capture2) {
         retry_command: `context run ${phase.id}`,
         message: source2.snapshotReady ? "Document refresh unavailable. Retain the validated registered snapshot; it is not confirmed current upstream." : "Document acquisition unavailable. Keep this source registered as a pending evidence gap; do not cite it or invent content. Unrelated work may continue."
       };
-      await applyAtomicFileBatch({ transactionRoot: join81(root, ".tmp/context-runtime/transactions"), writes: [{ path: path2, bytes: `${JSON.stringify({ configuration, warning }, null, 2)}
+      await applyAtomicFileBatch({ transactionRoot: join82(root, ".tmp/context-runtime/transactions"), writes: [{ path: path2, bytes: `${JSON.stringify({ configuration, warning }, null, 2)}
 ` }] });
       return {
         kind: "document.capture.warning",
@@ -100834,7 +100867,7 @@ init_revisionDelivery();
 init_workspacePreparation();
 init_src2();
 init_statusReaders();
-import { join as join85 } from "node:path";
+import { join as join86 } from "node:path";
 
 // src/project/statusEvidence.ts
 function evidenceWarningState(issues) {
@@ -101274,7 +101307,7 @@ async function collectProjectStatusSnapshotInternal(projectRoot, options = {}) {
   const authoring = production && !production.delivery && (dispatchProductionStage(production, productionCapabilitiesSchema.parse({})).state !== "ended" || draftStatus.count > 0 && draftStatus.diagnostics.length === 0);
   const deferDeliveryChecks = !maintenance && !localRevision && !localUpdate && !localRollback && (taskPreparation === "cleared" && !production || !!authoring);
   const collectionsWithPages = new Set;
-  const approvedPages = await countFiles(join85(projectRoot, "knowledge"), (rel) => {
+  const approvedPages = await countFiles(join86(projectRoot, "knowledge"), (rel) => {
     if (!isApprovedKnowledgeMarkdownPath(rel) || rel.startsWith("assets/"))
       return false;
     collectionsWithPages.add(rel.split("/")[0]);
@@ -101282,7 +101315,7 @@ async function collectProjectStatusSnapshotInternal(projectRoot, options = {}) {
   });
   const approvedCollections = KNOWLEDGE_COLLECTIONS.filter((collection) => collectionsWithPages.has(collection));
   const closeStatus = deferDeliveryChecks ? { state: "not-checked", diagnostics: [] } : await readCloseStatus(projectRoot);
-  const distFiles = await countFiles(join85(projectRoot, "dist"), () => true);
+  const distFiles = await countFiles(join86(projectRoot, "dist"), () => true);
   const verifyStatus = !deferDeliveryChecks && draftStatus.diagnostics.length === 0 ? await readVerifyStatus(projectRoot) : { issues: [], diagnostics: [] };
   const revisionDocuments = localRevision ? documentSources.filter((source2) => localRevision.target.source_refs.some((ref2) => [source2.name, source2.id].filter(Boolean).some((name3) => ref2 === `${source2.type}:${name3}` || ref2 === `docs:${name3}` || ref2.startsWith(`${source2.type}:${name3}#`) || ref2.startsWith(`${source2.type}:${name3}/`)))) : documentSources;
   const pendingCapture = pendingDocumentCaptureCommands({
@@ -101653,14 +101686,14 @@ function bindWorkflowExecutionContext(result, context) {
 // src/project/workflow/workflowRouteOutput.ts
 init_atomicWrite();
 import { createHash as createHash24 } from "node:crypto";
-import { join as join86 } from "node:path";
+import { join as join87 } from "node:path";
 async function workflowRouteOutput(projectRoot, route) {
   if (!route)
     return null;
   const body = `${JSON.stringify(route, null, 2)}
 `;
   const digest6 = createHash24("sha256").update(body).digest("hex");
-  const file = join86(projectRoot, ".tmp/context-runtime/routes", `${digest6}.json`);
+  const file = join87(projectRoot, ".tmp/context-runtime/routes", `${digest6}.json`);
   await atomicWriteFile(file, body);
   return {
     file,
@@ -101676,7 +101709,7 @@ async function workflowRunResultFile(projectRoot, result) {
   const body = `${JSON.stringify(result, null, 2)}
 `;
   const digest6 = createHash24("sha256").update(body).digest("hex");
-  const file = join86(projectRoot, ".tmp/context-runtime/action-results", `${digest6}.run.json`);
+  const file = join87(projectRoot, ".tmp/context-runtime/action-results", `${digest6}.run.json`);
   await atomicWriteFile(file, body);
   return file;
 }
@@ -101820,7 +101853,7 @@ init_candidateLedger();
 init_reviewShared();
 import { mkdir as mkdir31, readFile as readFile71, writeFile as writeFile25 } from "node:fs/promises";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
-import { dirname as dirname38, isAbsolute as isAbsolute15, join as join89, resolve as resolve28 } from "node:path";
+import { dirname as dirname38, isAbsolute as isAbsolute15, join as join90, resolve as resolve28 } from "node:path";
 
 // src/project/reviewSiteModel.ts
 init_siteTheme2();
@@ -101829,7 +101862,7 @@ init_unified();
 init_remark_parse();
 var import_yaml40 = __toESM(require_dist(), 1);
 import { readFile as readFile70 } from "node:fs/promises";
-import { join as join88 } from "node:path";
+import { join as join89 } from "node:path";
 import { execFile as execFile10 } from "node:child_process";
 import { promisify as promisify10 } from "node:util";
 import { createHash as createHash25 } from "node:crypto";
@@ -104795,9 +104828,9 @@ init_workspace();
 
 // src/project/reviewFeedback.ts
 import { readdir as readdir20, readFile as readFile69 } from "node:fs/promises";
-import { join as join87 } from "node:path";
+import { join as join88 } from "node:path";
 async function readPendingReviewFeedback(root2, candidates) {
-  const directory = join87(root2, ".tmp/context-runtime/review-feedback");
+  const directory = join88(root2, ".tmp/context-runtime/review-feedback");
   let files;
   try {
     files = await readdir20(directory);
@@ -104810,7 +104843,7 @@ async function readPendingReviewFeedback(root2, candidates) {
   const results = new Map;
   const receipts = [];
   for (const file of files.filter((f) => /^[a-f0-9]+\.json$/u.test(f)).sort()) {
-    const receipt2 = JSON.parse(await readFile69(join87(directory, file), "utf8"));
+    const receipt2 = JSON.parse(await readFile69(join88(directory, file), "utf8"));
     receipts.push(receipt2);
   }
   for (const receipt2 of receipts.sort((a, b) => a.created_at.localeCompare(b.created_at))) {
@@ -104930,7 +104963,7 @@ async function optional2(path3) {
 async function reviewSiteBaselineHash(root2, reviewedPaths) {
   const files = await readApprovedMarkdownFiles(root2);
   return hash3(JSON.stringify([
-    await optional2(join88(root2, "src/knowledge-map.yaml")) ?? null,
+    await optional2(join89(root2, "src/knowledge-map.yaml")) ?? null,
     files.map((f) => [f.relPath, reviewedPaths.includes(f.relPath) ? hash3(f.content) : title(f.content, f.relPath)]).sort((a, b) => a[0].localeCompare(b[0]))
   ]));
 }
@@ -105043,9 +105076,9 @@ async function collectReviewSiteModel(root2, candidates) {
     for (const [i2, p] of unplaced.entries())
       nodes.push({ key: `review-page-${p.id}`, parent: "review-unplaced", title: p.title, order: i2, page: p.id, change: p.change });
   }
-  const pkgText = await optional2(join88(root2, "package.json"));
+  const pkgText = await optional2(join89(root2, "package.json"));
   const pkg = pkgText ? JSON.parse(pkgText) : {};
-  const project = await optional2(join88(root2, "src/index.ts")) === undefined ? undefined : await loadContextProjectModule(root2);
+  const project = await optional2(join89(root2, "src/index.ts")) === undefined ? undefined : await loadContextProjectModule(root2);
   const siteTitle = project?.project.packages.flatMap((p) => p.kind === "package.kb" && p.site?.title ? [p.site.title] : [])[0];
   const sitePackages = project?.project.packages.flatMap((p) => p.kind === "package.kb" && p.site ? [p.site] : []) ?? [];
   const themeCss = siteThemeVariables(await resolveSiteTheme(root2, sitePackages.length === 1 ? sitePackages[0]?.theme : undefined));
@@ -105214,7 +105247,7 @@ article.review-new-page .context-diagram-shell,article .changed .context-diagram
 `;
 
 // src/project/reviewHtml.ts
-var REVIEW_HTML_ROOT = join89(".tmp", "context-runtime", "review");
+var REVIEW_HTML_ROOT = join90(".tmp", "context-runtime", "review");
 async function collectReviewCandidates(projectRoot, collection) {
   const rows = await readCandidateRecords(projectRoot);
   const draftRows = rows.filter((row) => row.collection === collection && row.status === "draft");
@@ -105247,7 +105280,7 @@ ${diagramScript ? `<script>${diagramScript}</script>` : ""}<script>const DATA=${
 }
 function resolveOutputPath(projectRoot, outPath, reviewScope) {
   if (outPath === undefined)
-    return join89(projectRoot, REVIEW_HTML_ROOT, `${reviewScope}.html`);
+    return join90(projectRoot, REVIEW_HTML_ROOT, `${reviewScope}.html`);
   return isAbsolute15(outPath) ? outPath : resolve28(projectRoot, outPath);
 }
 async function writeReviewHtml(input) {
@@ -105263,7 +105296,7 @@ async function writeReviewHtml(input) {
   if (model.pages.some((page) => page.html.includes('class="language-mermaid"'))) {
     const here = dirname38(fileURLToPath6(import.meta.url));
     try {
-      diagramScript = await readFile71(join89(here, "browser/diagrams.js"), "utf8");
+      diagramScript = await readFile71(join90(here, "browser/diagrams.js"), "utf8");
     } catch (error) {
       if (error.code !== "ENOENT")
         throw error;
@@ -105285,7 +105318,7 @@ init_dist();
 init_atomicWrite();
 init_reviewShared();
 import { mkdir as mkdir32, readFile as readFile72 } from "node:fs/promises";
-import { join as join90 } from "node:path";
+import { join as join91 } from "node:path";
 var REVIEW_BATCH_MAX_CANDIDATES = 6;
 var REVIEW_BATCH_MAX_BYTES = 512 * 1024;
 async function readerPurposes(projectRoot, sources) {
@@ -105365,11 +105398,11 @@ async function materializeCurrentReviewBatchSet(input) {
   const batches = buildCurrentReviewBatchDocuments(input.candidates);
   const setDigest = digestText(batches.map((batch) => `${batch.task_key}:${batch.digest}`).join(`
 `));
-  const root2 = join90(input.projectRoot, ".tmp", "context-runtime", "review", `current-${setDigest.slice("sha256:".length)}`);
+  const root2 = join91(input.projectRoot, ".tmp", "context-runtime", "review", `current-${setDigest.slice("sha256:".length)}`);
   await mkdir32(root2, { recursive: true });
   const entries2 = [];
   for (const batch of batches) {
-    const path4 = join90(input.projectRoot, ".tmp", "context-runtime", "review", `${batch.task_key}-${batch.digest.slice("sha256:".length)}.md`);
+    const path4 = join91(input.projectRoot, ".tmp", "context-runtime", "review", `${batch.task_key}-${batch.digest.slice("sha256:".length)}.md`);
     const existing = await readFile72(path4, "utf8").catch((error) => {
       if (error.code === "ENOENT")
         return;
@@ -105423,7 +105456,7 @@ async function materializeCurrentReviewBatchSet(input) {
   ].join(`
 `);
   const digest6 = digestText(content3);
-  const path3 = join90(root2, "index.md");
+  const path3 = join91(root2, "index.md");
   await atomicWriteFile(path3, `${content3}
 `);
   return {
@@ -105456,11 +105489,11 @@ function shellQuote6(value) {
 }
 function receiptSetPath(receipts) {
   const token = digestText(JSON.stringify(receipts)).slice("sha256:".length);
-  return join91(".tmp", "context-runtime", "workflow", "read-receipts", `${token}.json`);
+  return join92(".tmp", "context-runtime", "workflow", "read-receipts", `${token}.json`);
 }
 async function writeReceiptContinuation(input) {
   const path3 = receiptSetPath(input.receipts);
-  const absolutePath = join91(input.projectRoot, path3);
+  const absolutePath = join92(input.projectRoot, path3);
   await writeJsonAtomic(absolutePath, input.receipts);
   const contextCommand = input.managed ? [
     "context",
@@ -105555,7 +105588,7 @@ async function materializeContextWorkflowResource(input) {
   const resourceId = workflowResourceId(input.resourceId);
   const content3 = renderContextWorkflowResource(resourceId, status);
   const location = await materializeResource(await loadContextWorkflowProvider(), resourceId, {
-    cache: join91(found.projectRoot, ".tmp", "context-runtime", "workflow", "resources"),
+    cache: join92(found.projectRoot, ".tmp", "context-runtime", "workflow", "resources"),
     workspace: found.projectRoot,
     revision: input.revision,
     input: {
@@ -105587,7 +105620,7 @@ async function materializeContextWorkflowResource(input) {
     receipts: afterReadReceipts
   });
   const directResources = (status.workflow.current?.resources.required ?? []).filter((resource) => resource.read_state === "read-required" && resource.path !== undefined && resource.digest !== undefined);
-  const afterReadCommand = directResources.length === 0 ? continuation.command : `context resource acknowledge-current --revision ${shellQuote6(input.revision)}${authorityCommandOptions(authorities, "resource")} --resource-receipts ${shellQuote6(`@${join91(found.projectRoot, continuation.path)}`)} --format json`;
+  const afterReadCommand = directResources.length === 0 ? continuation.command : `context resource acknowledge-current --revision ${shellQuote6(input.revision)}${authorityCommandOptions(authorities, "resource")} --resource-receipts ${shellQuote6(`@${join92(found.projectRoot, continuation.path)}`)} --format json`;
   return {
     protocol: "context.workflow.resource.v1",
     id: resourceId,
@@ -105648,14 +105681,14 @@ async function acknowledgeCurrentWorkflowResources(input) {
   const reevaluated = await reevaluateProjectStatusWorkflow({
     snapshot,
     resourceReceipts: normalizedReceipts,
-    resourceReceiptsReference: `@${join91(found.projectRoot, continuation.path)}`
+    resourceReceiptsReference: `@${join92(found.projectRoot, continuation.path)}`
   });
   return {
     ...reevaluated,
     resourceAcknowledgement: {
       protocol: "context.workflow.resource-receipts.v1",
       acknowledged: directResources.length,
-      receiptReference: `@${join91(found.projectRoot, continuation.path)}`
+      receiptReference: `@${join92(found.projectRoot, continuation.path)}`
     }
   };
 }
@@ -105702,8 +105735,8 @@ init_errors3();
 init_exitCode();
 init_workspace();
 import { readFile as readFile73 } from "node:fs/promises";
-import { isAbsolute as isAbsolute16, join as join92, sep as sep6, resolve as resolve29 } from "node:path";
-var RECEIPT_DIRECTORY = join92(".tmp", "context-runtime", "workflow", "read-receipts");
+import { isAbsolute as isAbsolute16, join as join93, sep as sep6, resolve as resolve29 } from "node:path";
+var RECEIPT_DIRECTORY = join93(".tmp", "context-runtime", "workflow", "read-receipts");
 function workflowResourceReceiptCwd(value, cwd) {
   if (value === undefined || !value.startsWith("@"))
     return cwd;
@@ -105974,14 +106007,14 @@ function compactJsonResult(result, verbose) {
 // src/project/runLog.ts
 import { randomUUID as randomUUID5 } from "node:crypto";
 import { mkdir as mkdir33, writeFile as writeFile26 } from "node:fs/promises";
-import { dirname as dirname39, join as join95 } from "node:path";
+import { dirname as dirname39, join as join96 } from "node:path";
 var createPhaseRunId = () => {
   const timestamp = new Date().toISOString().replace(/[-:.TZ]/gu, "");
   return `run_${timestamp}_${randomUUID5().slice(0, 8)}`;
 };
 async function writePhaseRunLog(input) {
-  const relPath = join95(".tmp", "context-runtime", "runs", `${input.runId}.json`);
-  const absPath = join95(input.projectRoot, relPath);
+  const relPath = join96(".tmp", "context-runtime", "runs", `${input.runId}.json`);
+  const absPath = join96(input.projectRoot, relPath);
   await mkdir33(dirname39(absPath), { recursive: true });
   await writeFile26(absPath, `${JSON.stringify({
     run_id: input.runId,
@@ -107081,7 +107114,7 @@ init_reviewApplyIndexer();
 init_approvedKnowledgeSnapshots();
 import { existsSync as existsSync25 } from "node:fs";
 import { readFile as readFile76 } from "node:fs/promises";
-import { join as join96 } from "node:path";
+import { join as join97 } from "node:path";
 
 // src/project/reviewCandidateAuthority.ts
 init_src2();
@@ -107144,7 +107177,7 @@ async function prepareApprovedPage(input) {
       next: "Refresh the current production or article revision, then reopen Review before approval."
     });
   }
-  const relPath = join96("knowledge", input.record.path);
+  const relPath = join97("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(previousPath.split("/")[0], previousPath) || previousPath.includes("\\")))
@@ -107159,13 +107192,13 @@ async function prepareApprovedPage(input) {
       next: "Resolve the approved page path migration explicitly before approving this candidate."
     });
   }
-  const absPath = join96(input.projectRoot, relPath);
+  const absPath = join97(input.projectRoot, relPath);
   const existing = existsSync25(absPath) ? await readFile76(absPath, "utf8") : undefined;
   let previous3;
   if (previousPath !== undefined) {
     if (existing !== undefined || existingView?.relPath !== `knowledge/${previousPath}`)
       throw new TypeError("Page move destination or original identity changed; refresh its revision.");
-    previous3 = { path: `knowledge/${previousPath}`, content: await readFile76(join96(input.projectRoot, "knowledge", previousPath), "utf8") };
+    previous3 = { path: `knowledge/${previousPath}`, content: await readFile76(join97(input.projectRoot, "knowledge", previousPath), "utf8") };
   }
   if (input.record.approved_revision !== undefined) {
     const base = previous3?.content ?? existing;
@@ -107212,7 +107245,7 @@ async function prepareApprovedPage(input) {
 }
 async function readProjectFileMaybe(projectRoot, relPath) {
   try {
-    return await readFile76(join96(projectRoot, relPath), "utf8");
+    return await readFile76(join97(projectRoot, relPath), "utf8");
   } catch (error) {
     if (error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT") {
       return;
@@ -107435,7 +107468,7 @@ async function applyReviewDecisions(input) {
           });
         }
         seenApprovedIds.set(approvedRef, row.candidate_id);
-        const approvedPath = join96("knowledge", row.path);
+        const approvedPath = join97("knowledge", row.path);
         const previousPathCandidate = seenApprovedPaths.get(knowledgeTargetPathKey(approvedPath));
         if (previousPathCandidate !== undefined) {
           throw new ContextError(ExitCode.UserError, `multiple approved review decisions target the same knowledge path: ${approvedPath}`, {
@@ -107485,7 +107518,7 @@ async function applyReviewDecisions(input) {
       for (const path3 of approvedPageIndex.byRelPath.keys()) {
         if (pagesToWrite.some((page) => page.relPath === path3 || page.previous?.path === path3))
           continue;
-        const before = await readFile76(join96(input.projectRoot, path3), "utf8");
+        const before = await readFile76(join97(input.projectRoot, path3), "utf8");
         const local = path3.replace(/^knowledge\//u, "");
         const after = moveKnowledgeLinkTargets2(before, local, local, moved);
         navigationTargets.push(reviewFileTarget({ path: path3, baseContent: before, targetContent: after }));
@@ -107569,12 +107602,12 @@ init_candidateLedger();
 
 // src/project/localHtmlReport.ts
 import { execFile as execFile11 } from "node:child_process";
-import { isAbsolute as isAbsolute17, join as join97 } from "node:path";
+import { isAbsolute as isAbsolute17, join as join98 } from "node:path";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
 import { promisify as promisify11 } from "node:util";
 var execFileAsync5 = promisify11(execFile11);
 function htmlReportReference(input) {
-  const absolutePath = isAbsolute17(input.path) ? input.path : join97(input.projectRoot, input.path);
+  const absolutePath = isAbsolute17(input.path) ? input.path : join98(input.projectRoot, input.path);
   return {
     format: "html",
     path: input.path,
@@ -108598,7 +108631,7 @@ init_maintenanceStorage();
 init_productionFeedback();
 import { randomUUID as randomUUID6 } from "node:crypto";
 import { readFile as readFile79 } from "node:fs/promises";
-import { join as join98 } from "node:path";
+import { join as join99 } from "node:path";
 async function beginProductionRevision(input) {
   return withProductionFeedback({ operation: "revision" }, () => withProjectWriteLock(input.projectRoot, "production-revision", async () => {
     await recoverDurableMultiFileTransactions(input.projectRoot);
@@ -108637,7 +108670,7 @@ async function beginProductionRevision(input) {
       const formal = approved.byPath.get(path3);
       if (!prior && !formal)
         throw invalid2("Write the current task first; there is no article draft to revise yet.");
-      const markdown = prior?.body ?? await readFile79(await safeProjectTarget(input.projectRoot, join98("knowledge", path3)), "utf8");
+      const markdown = prior?.body ?? await readFile79(await safeProjectTarget(input.projectRoot, join99("knowledge", path3)), "utf8");
       const sections = prior?.indexer_candidate.sections.map((section) => ({ id: section.section_key, references: section.references })) ?? formal?.sections;
       const sources = [];
       for (const source2 of owner.sources) {
@@ -109277,7 +109310,7 @@ init_atomicWrite();
 var import_yaml44 = __toESM(require_dist(), 1);
 import { Buffer as Buffer4 } from "node:buffer";
 import { createHash as createHash31 } from "node:crypto";
-import { join as join102 } from "node:path";
+import { join as join103 } from "node:path";
 var INLINE_LIMIT = 16 * 1024;
 function record4(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
@@ -109303,8 +109336,8 @@ async function prepareActionCompletionOutput(input) {
   if (production && Buffer4.byteLength(full) <= INLINE_LIMIT)
     return input.result;
   const digest6 = createHash31("sha256").update(full).digest("hex");
-  const root2 = join102(input.projectRoot, ".tmp/context-runtime/action-results");
-  const resultFile = join102(root2, `${digest6}.json`);
+  const root2 = join103(input.projectRoot, ".tmp/context-runtime/action-results");
+  const resultFile = join103(root2, `${digest6}.json`);
   await atomicWriteFile(resultFile, full);
   if (production)
     return {
@@ -109315,7 +109348,7 @@ async function prepareActionCompletionOutput(input) {
       ...pick(result, ["next", "next_preparation"])
     };
   const next2 = record4(result.next) ?? record4(record4(result.workflow)?.current) ?? record4(record4(result.continuation)?.next);
-  const nextFile = next2 === undefined ? undefined : join102(root2, `${digest6}.next.json`);
+  const nextFile = next2 === undefined ? undefined : join103(root2, `${digest6}.next.json`);
   if (nextFile !== undefined)
     await atomicWriteFile(nextFile, serializeActionCompletion(next2, "json"));
   const outcomes = (Array.isArray(result.outcomes) ? result.outcomes : []).map(record4).filter((item) => item !== undefined);
@@ -109722,7 +109755,7 @@ init_cliFeedback();
 import { existsSync as existsSync27 } from "node:fs";
 import { readdir as readdir26, rm as rm21 } from "node:fs/promises";
 import { homedir } from "node:os";
-import { join as join103 } from "node:path";
+import { join as join104 } 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";
@@ -109739,19 +109772,19 @@ async function cleanClaudePluginCache(opts = {}) {
   for (const mp of marketplaces) {
     if (!mp.isDirectory())
       continue;
-    const mpDir = join103(cacheRoot, mp.name);
+    const mpDir = join104(cacheRoot, mp.name);
     const plugins = await readdir26(mpDir, { withFileTypes: true });
     for (const pl of plugins) {
       if (!pl.isDirectory())
         continue;
-      const plDir = join103(mpDir, pl.name);
+      const plDir = join104(mpDir, pl.name);
       const versions = await readdir26(plDir, { withFileTypes: true });
       for (const ver of versions) {
         if (!ver.isDirectory())
           continue;
         scanned += 1;
-        const verDir = join103(plDir, ver.name);
-        const markerPath = join103(verDir, ORPHAN_MARKER);
+        const verDir = join104(plDir, ver.name);
+        const markerPath = join104(verDir, ORPHAN_MARKER);
         if (!existsSync27(markerPath))
           continue;
         const label2 = `${mp.name}/${pl.name}/${ver.name}`;
@@ -109783,7 +109816,7 @@ function resolveClaudePluginCacheRoot(opts) {
   if (explicitRoot)
     return explicitRoot;
   const home = opts.home ?? process.env[CLAUDE_PLUGIN_CACHE_HOME_ENV] ?? homedir();
-  return join103(home, ".claude", "plugins", "cache");
+  return join104(home, ".claude", "plugins", "cache");
 }
 async function isEmptyDir(dir) {
   try {
@@ -109815,13 +109848,13 @@ init_exitCode();
 
 // src/lib/packageVersion.ts
 import { existsSync as existsSync28, readFileSync as readFileSync9 } from "node:fs";
-import { dirname as dirname42, join as join104 } from "node:path";
+import { dirname as dirname42, join as join105 } from "node:path";
 import { fileURLToPath as fileURLToPath8 } from "node:url";
 function readPackageVersion() {
   try {
     let dir = dirname42(fileURLToPath8(import.meta.url));
     for (let depth = 0;depth < 8; depth += 1) {
-      const packagePath = join104(dir, "package.json");
+      const packagePath = join105(dir, "package.json");
       if (existsSync28(packagePath)) {
         const parsed = JSON.parse(readFileSync9(packagePath, "utf8"));
         if (typeof parsed.version === "string" && parsed.version.length > 0) {
@@ -110208,14 +110241,14 @@ init_src2();
 init_documentCapture();
 import { existsSync as existsSync30 } from "node:fs";
 import { readFile as readFile86 } from "node:fs/promises";
-import { join as join106 } from "node:path";
+import { join as join107 } from "node:path";
 
 // src/project/sourceCommandViews.ts
 init_documentSiteDetection();
 init_workspace();
 init_documentBatchManifest();
 import { readFile as readFile85 } from "node:fs/promises";
-import { join as join105 } from "node:path";
+import { join as join106 } from "node:path";
 function repoSourceAgentView(source2) {
   return {
     id: source2.id ?? source2.name,
@@ -110276,7 +110309,7 @@ async function fileSourceAgentViewWithNextAction(input) {
   };
 }
 function documentSourceManifestPath(source2) {
-  return source2.snapshot?.manifest ?? join105(source2.materializedAt, "manifest.json");
+  return source2.snapshot?.manifest ?? join106(source2.materializedAt, "manifest.json");
 }
 async function fileSourceDocumentSiteHint(input) {
   const detection = await detectDocumentSiteFiles({
@@ -110286,7 +110319,7 @@ async function fileSourceDocumentSiteHint(input) {
   let snapshotConfigured = false;
   const manifest = documentSourceManifestPath(input.source);
   try {
-    const parsed = parseDocumentSnapshotForSource(JSON.parse(await readFile85(join105(input.projectRoot, manifest), "utf8")), input.source.name);
+    const parsed = parseDocumentSnapshotForSource(JSON.parse(await readFile85(join106(input.projectRoot, manifest), "utf8")), input.source.name);
     snapshotConfigured = manifestUsesMdxJsonDocs(parsed);
   } catch {
     snapshotConfigured = false;
@@ -110319,11 +110352,11 @@ async function larkSourceAgentViewWithNextAction(input) {
 init_documentBatchManifest();
 init_documentSnapshotFidelity();
 function documentSourceManifestPath2(source2) {
-  return source2.snapshot?.manifest ?? join106(source2.materializedAt, "manifest.json");
+  return source2.snapshot?.manifest ?? join107(source2.materializedAt, "manifest.json");
 }
 async function documentSnapshotState(input) {
   const manifest = documentSourceManifestPath2(input.source);
-  const manifestPath = join106(input.projectRoot, manifest);
+  const manifestPath = join107(input.projectRoot, manifest);
   if (!existsSync30(manifestPath)) {
     return {
       snapshotReady: false,
@@ -110402,7 +110435,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(join106(input.projectRoot, input.source.materializedAt, path3)));
+    ].find((path3) => !existsSync30(join107(input.projectRoot, input.source.materializedAt, path3)));
     if (missing !== undefined) {
       return {
         snapshotReady: false,
@@ -110504,7 +110537,7 @@ init_exitCode();
 var import_yaml47 = __toESM(require_dist(), 1);
 import { createHash as createHash32 } from "node:crypto";
 import { readFile as readFile87, realpath as realpath11 } from "node:fs/promises";
-import { basename as basename12, extname as extname15, isAbsolute as isAbsolute20, join as join107, relative as relative27, resolve as resolve35 } from "node:path";
+import { basename as basename12, extname as extname15, isAbsolute as isAbsolute20, join as join108, 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) {
@@ -110600,7 +110633,7 @@ function assertSafeFileInclude(value) {
 }
 async function readRegistryDocument(projectRoot, registryPath2) {
   try {
-    const content3 = await readFile87(join107(projectRoot, registryPath2), "utf8");
+    const content3 = await readFile87(join108(projectRoot, registryPath2), "utf8");
     return content3.trim().length === 0 ? { sources: [] } : import_yaml47.default.parse(content3);
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT")
@@ -110718,7 +110751,7 @@ async function addFileSourceUnlocked(input) {
     const record6 = entry2;
     return record6.name !== input.name && record6.id !== input.name;
   }), nextEntry];
-  await atomicWriteFile(join107(input.projectRoot, DEFAULT_FILE_SOURCES_REGISTRY_PATH), import_yaml47.default.stringify({ sources: nextSources }));
+  await atomicWriteFile(join108(input.projectRoot, DEFAULT_FILE_SOURCES_REGISTRY_PATH), import_yaml47.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) {
@@ -110774,7 +110807,7 @@ async function addLarkSourceUnlocked(input) {
     const record6 = entry2;
     return record6.name !== input.name && record6.id !== input.name;
   }), nextEntry];
-  await atomicWriteFile(join107(input.projectRoot, DEFAULT_LARK_SOURCES_REGISTRY_PATH), import_yaml47.default.stringify({ sources: nextSources }));
+  await atomicWriteFile(join108(input.projectRoot, DEFAULT_LARK_SOURCES_REGISTRY_PATH), import_yaml47.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) {
@@ -110979,7 +111012,7 @@ var import_yaml48 = __toESM(require_dist(), 1);
 import { existsSync as existsSync31 } from "node:fs";
 import { createHash as createHash33 } from "node:crypto";
 import { readFile as readFile88, readdir as readdir27, rm as rm23 } from "node:fs/promises";
-import { isAbsolute as isAbsolute21, join as join108, relative as relative28, resolve as resolve36, sep as sep8 } from "node:path";
+import { isAbsolute as isAbsolute21, join as join109, relative as relative28, resolve as resolve36, sep as sep8 } from "node:path";
 function sourceIdentity(source2) {
   if (source2.kind === "source.collection")
     return;
@@ -111011,7 +111044,7 @@ function collectStrings(value, output) {
   }
 }
 async function yamlReferences(input) {
-  const absolutePath = join108(input.projectRoot, input.path);
+  const absolutePath = join109(input.projectRoot, input.path);
   if (!existsSync31(absolutePath))
     return false;
   const parsed = import_yaml48.default.parse(await readFile88(absolutePath, "utf8"));
@@ -111140,7 +111173,7 @@ async function registryRemovalWrite(projectRoot, source2) {
   const path3 = registryPath2(source2.type);
   if (path3 === null)
     return;
-  const absolutePath = join108(projectRoot, path3);
+  const absolutePath = join109(projectRoot, path3);
   const document4 = existsSync31(absolutePath) ? import_yaml48.default.parse(await readFile88(absolutePath, "utf8")) : { sources: [] };
   return {
     path: absolutePath,
@@ -111159,7 +111192,7 @@ function safeManagedMaterializedPath(projectRoot, source2) {
   return absolute;
 }
 function safeManagedManifestPath(projectRoot, source2) {
-  const manifest = source2.manifest ?? join108(source2.materializedAt, "manifest.json");
+  const manifest = source2.manifest ?? join109(source2.materializedAt, "manifest.json");
   if (isAbsolute21(manifest))
     throw unsafeOwnership(source2, manifest);
   const absolute = resolve36(projectRoot, manifest);
@@ -111321,7 +111354,7 @@ function publicRemovalResult(plan, action) {
   };
 }
 async function pruneExtractRuntime(projectRoot, source2) {
-  const fingerprintPath = join108(projectRoot, ".tmp/context-runtime/extract/source-fingerprints.json");
+  const fingerprintPath = join109(projectRoot, ".tmp/context-runtime/extract/source-fingerprints.json");
   const removedPhaseIds = new Set;
   if (existsSync31(fingerprintPath)) {
     const parsed = JSON.parse(await readFile88(fingerprintPath, "utf8"));
@@ -111338,14 +111371,14 @@ async function pruneExtractRuntime(projectRoot, source2) {
     await atomicWriteFile(fingerprintPath, `${JSON.stringify({ ...parsed, phases: next2 }, null, 2)}
 `);
   }
-  const phaseOwnershipPath = join108(projectRoot, ".tmp/context-runtime/extract/custom-phase-candidates.json");
+  const phaseOwnershipPath = join109(projectRoot, ".tmp/context-runtime/extract/custom-phase-candidates.json");
   if (existsSync31(phaseOwnershipPath) && removedPhaseIds.size > 0) {
     const parsed = JSON.parse(await readFile88(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 = join108(projectRoot, ".tmp/context-runtime/extract/source-symbols.json");
+  const symbolPath = join109(projectRoot, ".tmp/context-runtime/extract/source-symbols.json");
   if (existsSync31(symbolPath)) {
     const parsed = JSON.parse(await readFile88(symbolPath, "utf8"));
     const symbols = Array.isArray(parsed.symbols) ? parsed.symbols.filter((entry) => entry === null || typeof entry !== "object" || Array.isArray(entry) || entry.source !== source2.name) : [];
@@ -111353,12 +111386,12 @@ async function pruneExtractRuntime(projectRoot, source2) {
     await atomicWriteFile(symbolPath, `${JSON.stringify({ ...parsed, phaseFingerprints, symbols }, null, 2)}
 `);
   }
-  const snapshotRoot = join108(projectRoot, ".tmp/context-runtime/extract/candidates");
+  const snapshotRoot = join109(projectRoot, ".tmp/context-runtime/extract/candidates");
   const visit4 = async (directory) => {
     if (!existsSync31(directory))
       return;
     for (const entry of await readdir27(directory, { withFileTypes: true })) {
-      const path3 = join108(directory, entry.name);
+      const path3 = join109(directory, entry.name);
       if (entry.isDirectory()) {
         await visit4(path3);
         continue;
@@ -111408,7 +111441,7 @@ async function removeProjectSource(input) {
       });
     }
     await applyAtomicFileBatch({
-      transactionRoot: join108(input.projectRoot, ".tmp", "context-runtime", "source-remove-transactions"),
+      transactionRoot: join109(input.projectRoot, ".tmp", "context-runtime", "source-remove-transactions"),
       writes: [...plan.registryWrite === undefined ? [] : [plan.registryWrite], ...plan.manifestWrite !== undefined ? [plan.manifestWrite] : []],
       removals: plan.absoluteRemovals
     });
@@ -112051,7 +112084,7 @@ init_exitCode();
 var import_yaml51 = __toESM(require_dist(), 1);
 import { constants as constants6, existsSync as existsSync32 } from "node:fs";
 import { lstat as lstat13, open as open5, readdir as readdir28 } from "node:fs/promises";
-import { dirname as dirname44, join as join110, resolve as resolve38 } from "node:path";
+import { dirname as dirname44, join as join111, resolve as resolve38 } from "node:path";
 import { fileURLToPath as fileURLToPath9 } from "node:url";
 function bundledSkillRoot() {
   const directory = dirname44(fileURLToPath9(import.meta.url));
@@ -112081,7 +112114,7 @@ async function readProductionSkills(root2) {
   const entries2 = (await readdir28(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 = join110(root2, directory.name, "SKILL.md");
+    const entry = join111(root2, directory.name, "SKILL.md");
     if (!(await lstat13(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);
@@ -112490,7 +112523,7 @@ init_errors3();
 init_exitCode();
 import { createHash as createHash34 } from "node:crypto";
 import { cp as cp2, lstat as lstat14, mkdir as mkdir36, mkdtemp as mkdtemp5, readFile as readFile94, readdir as readdir29, rename as rename9, rm as rm24, writeFile as writeFile28 } from "node:fs/promises";
-import { dirname as dirname46, join as join111, resolve as resolve40 } from "node:path";
+import { dirname as dirname46, join as join112, resolve as resolve40 } from "node:path";
 var MARKER = ".context-skill-install.json";
 function conflict(path3) {
   throw new ContextError(ExitCode.UserError, `Local skill install conflict: ${path3}`, {
@@ -112521,7 +112554,7 @@ async function digest7(root2) {
     for (const name3 of (await readdir29(dir)).sort()) {
       if (!prefix && name3 === MARKER)
         continue;
-      const path3 = join111(dir, name3);
+      const path3 = join112(dir, name3);
       const entry = await lstat14(path3);
       if (entry.isSymbolicLink())
         conflict(path3);
@@ -112541,31 +112574,31 @@ async function installLocalSkills(root2, path3, dryRun, agent) {
   if (!path3.trim())
     conflict("--local requires a non-empty path");
   const targetRoot = resolve40(path3);
-  const skillsRoot = join111(targetRoot, "skills");
+  const skillsRoot = join112(targetRoot, "skills");
   await checkParents(skillsRoot);
-  const sourceRoot2 = join111(root2, "skills");
+  const sourceRoot2 = join112(root2, "skills");
   const commandPlans = [];
   const commandEntries = new Set;
   if (agent === "claude" || agent === "cursor") {
-    for (const name3 of await readdir29(join111(root2, "claude", "commands"))) {
+    for (const name3 of await readdir29(join112(root2, "claude", "commands"))) {
       if (name3.endsWith(".md"))
         commandEntries.add(name3.slice(0, -3));
     }
-    const commandsRoot = join111(targetRoot, "commands");
+    const commandsRoot = join112(targetRoot, "commands");
     await checkParents(commandsRoot);
-    for (const entry of await readdir29(join111(root2, agent, "commands"), { withFileTypes: true })) {
+    for (const entry of await readdir29(join112(root2, agent, "commands"), { withFileTypes: true })) {
       if (!entry.isFile() || !entry.name.endsWith(".md"))
         continue;
-      let content3 = await readFile94(join111(root2, agent, "commands", entry.name), "utf8");
+      let content3 = await readFile94(join112(root2, agent, "commands", entry.name), "utf8");
       if (agent === "claude") {
         const frontmatter2 = /^(---\r?\n)([\s\S]*?)(\r?\n---(?:\r?\n|$))/.exec(content3);
         if (!frontmatter2)
-          conflict(join111(root2, agent, "commands", entry.name));
+          conflict(join112(root2, agent, "commands", entry.name));
         content3 = `${frontmatter2[1]}disable-model-invocation: true
 ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmatter2[3]}${content3.slice(frontmatter2[0].length)}`;
       }
-      const target = join111(commandsRoot, entry.name);
-      const marker = join111(commandsRoot, `.context-${entry.name}.json`);
+      const target = join112(commandsRoot, entry.name);
+      const marker = join112(commandsRoot, `.context-${entry.name}.json`);
       for (const file of [target, marker]) {
         const existing = await stat10(file);
         if (existing && (!existing.isFile() || existing.isSymbolicLink()))
@@ -112586,14 +112619,14 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
       commandPlans.push({ name: entry.name, target, marker, content: content3, hash: createHash34("sha256").update(content3).digest("hex") });
     }
     if (!commandPlans.length)
-      conflict(join111(root2, agent, "commands"));
+      conflict(join112(root2, agent, "commands"));
   }
   const plans = [];
   for (const entry of (await readdir29(sourceRoot2, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
-    if (!entry.isDirectory() || !await stat10(join111(sourceRoot2, entry.name, "SKILL.md")))
+    if (!entry.isDirectory() || !await stat10(join112(sourceRoot2, entry.name, "SKILL.md")))
       continue;
-    const source2 = join111(sourceRoot2, entry.name);
-    const target = join111(skillsRoot, entry.name);
+    const source2 = join112(sourceRoot2, entry.name);
+    const target = join112(skillsRoot, entry.name);
     if (commandEntries.has(entry.name)) {
       if (await stat10(target))
         conflict(`${target} (use a fresh host directory to avoid duplicate command/skill entries)`);
@@ -112603,7 +112636,7 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
     if (existing) {
       if (!existing.isDirectory() || existing.isSymbolicLink())
         conflict(target);
-      const markerPath = join111(target, MARKER);
+      const markerPath = join112(target, MARKER);
       if (!(await stat10(markerPath))?.isFile())
         conflict(target);
       let marker;
@@ -112622,14 +112655,14 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
   if (!dryRun) {
     await mkdir36(skillsRoot, { recursive: true });
     for (const plan of plans) {
-      const staging = await mkdtemp5(join111(skillsRoot, ".context-install-"));
-      const candidate = join111(staging, "candidate");
-      const previous3 = join111(staging, "previous");
+      const staging = await mkdtemp5(join112(skillsRoot, ".context-install-"));
+      const candidate = join112(staging, "candidate");
+      const previous3 = join112(staging, "previous");
       let moved = false;
       try {
         await cp2(plan.source, candidate, { recursive: true });
         if (agent === "claude") {
-          const skillFile = join111(candidate, "SKILL.md");
+          const skillFile = join112(candidate, "SKILL.md");
           const content3 = await readFile94(skillFile, "utf8");
           const parts = /^(---\r?\n)([\s\S]*?)(\r?\n---(?:\r?\n|$))/.exec(content3);
           if (parts && /^\s*context-public-entry:\s*["']?false["']?\s*$/mu.test(parts[2])) {
@@ -112638,7 +112671,7 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
 ${frontmatter2}${parts[3]}${content3.slice(parts[0].length)}`);
           }
         }
-        await writeFile28(join111(candidate, MARKER), JSON.stringify({ owner: "context-plugin-local", digest: await digest7(candidate) }) + `
+        await writeFile28(join112(candidate, MARKER), JSON.stringify({ owner: "context-plugin-local", digest: await digest7(candidate) }) + `
 `);
         if (plan.exists) {
           await rename9(plan.target, previous3);
@@ -112662,12 +112695,12 @@ ${frontmatter2}${parts[3]}${content3.slice(parts[0].length)}`);
     }
     for (const command3 of commandPlans) {
       await mkdir36(dirname46(command3.target), { recursive: true });
-      const staging = await mkdtemp5(join111(dirname46(command3.target), ".context-install-"));
-      await writeFile28(join111(staging, "command"), command3.content);
-      await writeFile28(join111(staging, "marker"), JSON.stringify({ owner: "context-plugin-local", digest: command3.hash }) + `
+      const staging = await mkdtemp5(join112(dirname46(command3.target), ".context-install-"));
+      await writeFile28(join112(staging, "command"), command3.content);
+      await writeFile28(join112(staging, "marker"), JSON.stringify({ owner: "context-plugin-local", digest: command3.hash }) + `
 `);
-      await rename9(join111(staging, "command"), command3.target);
-      await rename9(join111(staging, "marker"), command3.marker);
+      await rename9(join112(staging, "command"), command3.target);
+      await rename9(join112(staging, "marker"), command3.marker);
       await rm24(staging, { recursive: true, force: true });
     }
   }
@@ -112690,66 +112723,49 @@ ${frontmatter2}${parts[3]}${content3.slice(parts[0].length)}`);
 init_cliFeedback();
 init_errors3();
 init_exitCode();
-import { access as access6, stat as stat11 } from "node:fs/promises";
-import { constants as constants7 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { basename as basename13, delimiter, dirname as dirname47, join as join112, resolve as resolve41 } from "node:path";
+import { lstat as lstat15 } from "node:fs/promises";
+import { join as join113, resolve as resolve41 } from "node:path";
 var HOST_DIRS = { claude: ".claude", cursor: ".cursor", codex: ".agents" };
-async function detectLocalAgent(agent) {
-  const commands = agent === "cursor" ? ["cursor", "cursor-agent"] : [agent];
-  for (const directory of (process.env.PATH ?? "").split(delimiter).filter(Boolean)) {
-    for (const command3 of commands) {
-      for (const suffix of process.platform === "win32" ? [".exe", ".cmd", ".bat", ""] : [""]) {
-        const file = join112(directory, command3 + suffix);
-        try {
-          if (!(await stat11(file)).isFile())
-            continue;
-          await access6(file, constants7.X_OK);
-          return true;
-        } catch {}
-      }
-    }
-  }
-  if (process.platform === "darwin") {
-    const app = { claude: "Claude.app", cursor: "Cursor.app", codex: "Codex.app" }[agent];
-    if (agent !== "claude") {
-      for (const directory of ["/Applications", join112(homedir2(), "Applications")]) {
-        try {
-          if ((await stat11(join112(directory, app))).isDirectory())
-            return true;
-        } catch {}
-      }
+async function detectLocalAgent(agent, repo) {
+  const path3 = join113(repo, HOST_DIRS[agent]);
+  try {
+    const entry = await lstat15(path3);
+    if (!entry.isDirectory() || entry.isSymbolicLink()) {
+      throw new ContextError(ExitCode.UserError, `Local host directory is not a regular directory: ${path3}`);
     }
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return false;
+    throw error;
   }
-  return false;
 }
-async function installAutoLocalSkills(root2, path3, dryRun, detect = detectLocalAgent) {
+async function installAutoLocalSkills(root2, path3, dryRun, detect = detectLocalAgent, selectedAgent) {
   if (!path3.trim())
     throw new ContextError(ExitCode.UserError, "--local requires a non-empty repository path", {
       category: ErrorCategory.UserInputInvalid,
-      next: "Run context plugin install --local /path/to/repository."
+      next: "Run context plugin install --local /path/to/repository --agent auto-detect."
     });
-  const requested = resolve41(path3);
-  const repo = Object.values(HOST_DIRS).some((name3) => name3 === basename13(requested)) ? dirname47(requested) : requested;
+  const repo = resolve41(path3);
   const agents = [];
   for (const agent of ["claude", "cursor", "codex"]) {
-    if (await detect(agent))
+    if (selectedAgent ? selectedAgent === "all" || agent === selectedAgent : await detect(agent, repo))
       agents.push(agent);
   }
-  const targets = agents.length ? agents.map((agent) => ({ agent, path: join112(repo, HOST_DIRS[agent]) })) : [{ path: join112(repo, ".agents") }];
+  const targets = agents.length ? agents.map((agent) => ({ agent, path: join113(repo, HOST_DIRS[agent]) })) : [{ path: join113(repo, ".agents") }];
   const previews = [];
   for (const target of targets)
     previews.push(await installLocalSkills(root2, target.path, true, target.agent));
   const header = formatFeedback({
     symbol: agents.length ? "✓" : "⚠",
-    action: "detected",
+    action: selectedAgent ? "selected" : "detected",
     subject: "local agent targets",
-    headline: agents.length ? agents.join(", ") : "No supported agent detected",
+    headline: agents.length ? agents.join(", ") : "No supported host directory found",
     body: [
       `repository: ${repo}`,
       ...targets.map((target) => `${target.agent ?? "standalone"}: ${target.path}`),
-      ...!agents.length ? ["Installing only .agents/skills. Configure a supported host to read this directory, or rerun with an explicit --agent and its target path."] : [],
-      "Host discovery does not verify runtime skill loading; refresh the host after installation."
+      ...!agents.length ? ["Installing only .agents/skills. Configure a supported host to read this directory, or select an explicit --agent with the same repository root."] : [],
+      "Repository directory discovery does not verify runtime skill loading; refresh the host after installation."
     ]
   });
   if (dryRun)
@@ -112769,7 +112785,7 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 import { existsSync as existsSync35 } from "node:fs";
-import { dirname as dirname49, join as join114, resolve as resolve42 } from "node:path";
+import { dirname as dirname48, join as join115, resolve as resolve42 } from "node:path";
 import { fileURLToPath as fileURLToPath10 } from "node:url";
 
 // src/project/pluginInstallTargets.ts
@@ -112779,8 +112795,8 @@ init_exitCode();
 import { execFile as execFile13 } from "node:child_process";
 import { existsSync as existsSync34 } from "node:fs";
 import { cp as cp3, mkdir as mkdir37, readdir as readdir30, readFile as readFile95, rename as rename10, rm as rm25, writeFile as writeFile29 } from "node:fs/promises";
-import { homedir as homedir3 } from "node:os";
-import { dirname as dirname48, join as join113 } from "node:path";
+import { homedir as homedir2 } from "node:os";
+import { dirname as dirname47, join as join114 } from "node:path";
 import { promisify as promisify13 } from "node:util";
 var execFileAsync7 = promisify13(execFile13);
 var MARKETPLACE_NAME = "c4a";
@@ -112834,23 +112850,23 @@ async function claudePluginInstalled(pluginId) {
   }
 }
 function codexHome() {
-  return process.env.CODEX_HOME?.trim() || join113(homedir3(), ".codex");
+  return process.env.CODEX_HOME?.trim() || join114(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() || homedir3();
-  return join113(home, ".claude", "plugins", "cache");
+  const home = process.env[CLAUDE_PLUGIN_CACHE_HOME_ENV2]?.trim() || homedir2();
+  return join114(home, ".claude", "plugins", "cache");
 }
 function sharedSkillsRoot() {
-  return process.env[SHARED_SKILLS_ROOT_ENV]?.trim() || join113(homedir3(), ".agents", "skills");
+  return process.env[SHARED_SKILLS_ROOT_ENV]?.trim() || join114(homedir2(), ".agents", "skills");
 }
 function claudeSkillsRoot() {
-  return process.env[CLAUDE_SKILLS_ROOT_ENV]?.trim() || join113(homedir3(), ".claude", "skills");
+  return process.env[CLAUDE_SKILLS_ROOT_ENV]?.trim() || join114(homedir2(), ".claude", "skills");
 }
 function cursorPluginRoot() {
-  return process.env[CURSOR_PLUGIN_ROOT_ENV]?.trim() || join113(homedir3(), ".cursor", "plugins", "local", PLUGIN_NAME);
+  return process.env[CURSOR_PLUGIN_ROOT_ENV]?.trim() || join114(homedir2(), ".cursor", "plugins", "local", PLUGIN_NAME);
 }
 function blockHeader(line) {
   const match = line.match(/^\s*\[([^\]]+)\]\s*$/u);
@@ -112901,7 +112917,7 @@ function pruneLegacyCodexConfigContent(content3) {
 `), removed };
 }
 async function pruneLegacyCodexConfig(dryRun, steps) {
-  const configPath = join113(codexHome(), "config.toml");
+  const configPath = join114(codexHome(), "config.toml");
   const current2 = await readFile95(configPath, "utf8").catch(() => "");
   if (!current2)
     return;
@@ -112918,7 +112934,7 @@ async function pruneLegacyCodexConfig(dryRun, steps) {
   }
 }
 async function pruneCodexPluginCacheForName(pluginName, keepVersion, dryRun, steps) {
-  const cacheRoot = join113(codexHome(), "plugins", "cache", MARKETPLACE_NAME, pluginName);
+  const cacheRoot = join114(codexHome(), "plugins", "cache", MARKETPLACE_NAME, pluginName);
   if (!existsSync34(cacheRoot))
     return;
   const versions = (await readdir30(cacheRoot, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory() && entry.name !== keepVersion).map((entry) => entry.name).sort();
@@ -112930,7 +112946,7 @@ async function pruneCodexPluginCacheForName(pluginName, keepVersion, dryRun, ste
     status: dryRun ? "planned" : "ran"
   });
   if (!dryRun)
-    await Promise.all(versions.map((version3) => rm25(join113(cacheRoot, version3), { recursive: true, force: true })));
+    await Promise.all(versions.map((version3) => rm25(join114(cacheRoot, version3), { recursive: true, force: true })));
 }
 async function pruneCodexPluginCache(currentVersion, dryRun, steps) {
   await pruneCodexPluginCacheForName(PLUGIN_NAME, currentVersion, dryRun, steps);
@@ -112954,15 +112970,15 @@ async function pruneClaudeOrphanContextCache(dryRun, steps) {
   for (const marketplace of marketplaces) {
     if (!marketplace.isDirectory())
       continue;
-    const pluginDir = join113(cacheRoot, marketplace.name, PLUGIN_NAME);
+    const pluginDir = join114(cacheRoot, marketplace.name, PLUGIN_NAME);
     if (!existsSync34(pluginDir))
       continue;
     const versions = await readdir30(pluginDir, { withFileTypes: true }).catch(() => []);
     for (const version3 of versions) {
       if (!version3.isDirectory())
         continue;
-      const versionDir = join113(pluginDir, version3.name);
-      if (!existsSync34(join113(versionDir, ORPHAN_MARKER2)))
+      const versionDir = join114(pluginDir, version3.name);
+      if (!existsSync34(join114(versionDir, ORPHAN_MARKER2)))
         continue;
       removed.push(`${marketplace.name}/${PLUGIN_NAME}/${version3.name}`);
       if (!dryRun) {
@@ -112972,7 +112988,7 @@ async function pruneClaudeOrphanContextCache(dryRun, steps) {
     if (!dryRun && await isEmptyDir2(pluginDir)) {
       await rm25(pluginDir, { recursive: true, force: true });
     }
-    const marketplaceDir = join113(cacheRoot, marketplace.name);
+    const marketplaceDir = join114(cacheRoot, marketplace.name);
     if (!dryRun && await isEmptyDir2(marketplaceDir)) {
       await rm25(marketplaceDir, { recursive: true, force: true });
     }
@@ -112993,7 +113009,7 @@ async function pruneClaudeLegacyPluginCache(dryRun, steps) {
     return;
   const removed = [];
   for (const pluginName of LEGACY_PLUGIN_NAMES) {
-    const pluginDir = join113(cacheRoot, MARKETPLACE_NAME, pluginName);
+    const pluginDir = join114(cacheRoot, MARKETPLACE_NAME, pluginName);
     if (!existsSync34(pluginDir))
       continue;
     removed.push(`${MARKETPLACE_NAME}/${pluginName}`);
@@ -113010,11 +113026,11 @@ async function pruneClaudeLegacyPluginCache(dryRun, steps) {
   }
 }
 async function pruneClaudeSupersededContextCache(root2, dryRun, steps) {
-  const manifest = await readFile95(join113(root2, "claude", ".claude-plugin", "plugin.json"), "utf8").then((content3) => JSON.parse(content3)).catch(() => null);
+  const manifest = await readFile95(join114(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 = join113(claudePluginCacheRoot(), MARKETPLACE_NAME, PLUGIN_NAME);
+  const pluginDir = join114(claudePluginCacheRoot(), MARKETPLACE_NAME, PLUGIN_NAME);
   const staleVersions = (await readdir30(pluginDir, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory() && entry.name !== currentVersion).map((entry) => entry.name);
   if (staleVersions.length === 0)
     return;
@@ -113024,7 +113040,7 @@ async function pruneClaudeSupersededContextCache(root2, dryRun, steps) {
     status: dryRun ? "planned" : "ran"
   });
   if (!dryRun) {
-    await Promise.all(staleVersions.map((version3) => rm25(join113(pluginDir, version3), { recursive: true, force: true })));
+    await Promise.all(staleVersions.map((version3) => rm25(join114(pluginDir, version3), { recursive: true, force: true })));
   }
 }
 function enableCodexPluginConfig(content3) {
@@ -113088,8 +113104,8 @@ source = ${JSON.stringify(root2)}
 `;
 }
 async function ensureCodexPluginEnabled() {
-  const configPath = join113(codexHome(), "config.toml");
-  await mkdir37(dirname48(configPath), { recursive: true });
+  const configPath = join114(codexHome(), "config.toml");
+  await mkdir37(dirname47(configPath), { recursive: true });
   const current2 = await readFile95(configPath, "utf8").catch(() => "");
   const next2 = enableCodexPluginConfig(current2);
   if (next2 !== current2) {
@@ -113097,8 +113113,8 @@ async function ensureCodexPluginEnabled() {
   }
 }
 async function ensureCodexLocalMarketplace(root2) {
-  const configPath = join113(codexHome(), "config.toml");
-  await mkdir37(dirname48(configPath), { recursive: true });
+  const configPath = join114(codexHome(), "config.toml");
+  await mkdir37(dirname47(configPath), { recursive: true });
   const current2 = await readFile95(configPath, "utf8").catch(() => "");
   const next2 = upsertCodexLocalMarketplaceConfig(current2, root2);
   if (next2 !== current2) {
@@ -113106,7 +113122,7 @@ async function ensureCodexLocalMarketplace(root2) {
   }
 }
 async function codexPluginVersion(root2) {
-  const manifestPath = join113(root2, "codex", ".codex-plugin", "plugin.json");
+  const manifestPath = join114(root2, "codex", ".codex-plugin", "plugin.json");
   const manifest = JSON.parse(await readFile95(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}`);
@@ -113114,10 +113130,10 @@ async function codexPluginVersion(root2) {
   return manifest.version;
 }
 function codexPluginCacheDir(version3) {
-  return join113(codexHome(), "plugins", "cache", MARKETPLACE_NAME, PLUGIN_NAME, version3);
+  return join114(codexHome(), "plugins", "cache", MARKETPLACE_NAME, PLUGIN_NAME, version3);
 }
 async function replaceDirectoryFromSource(source2, target) {
-  await mkdir37(dirname48(target), { recursive: true });
+  await mkdir37(dirname47(target), { recursive: true });
   const temporary = `${target}.tmp-${process.pid}-${Date.now()}`;
   const previous3 = `${target}.previous-${process.pid}-${Date.now()}`;
   await rm25(temporary, { recursive: true, force: true });
@@ -113137,7 +113153,7 @@ async function replaceDirectoryFromSource(source2, target) {
   }
 }
 async function materializeCodexPluginCache(root2, version3, dryRun, steps) {
-  const source2 = join113(root2, "codex");
+  const source2 = join114(root2, "codex");
   const target = codexPluginCacheDir(version3);
   steps.push({
     agent: "codex",
@@ -113149,13 +113165,13 @@ async function materializeCodexPluginCache(root2, version3, dryRun, steps) {
   await replaceDirectoryFromSource(source2, target);
 }
 async function bundledProviderSkillNames(root2) {
-  const skillsRoot = join113(root2, "skills");
+  const skillsRoot = join114(root2, "skills");
   const entries2 = await readdir30(skillsRoot, { withFileTypes: true });
   const names = [];
   for (const entry of entries2) {
     if (!entry.isDirectory() || entry.name === "context")
       continue;
-    const skillPath = join113(skillsRoot, entry.name, "SKILL.md");
+    const skillPath = join114(skillsRoot, entry.name, "SKILL.md");
     if (!existsSync34(skillPath))
       continue;
     const skill = await readFile95(skillPath, "utf8");
@@ -113170,10 +113186,10 @@ async function bundledProviderSkillNames(root2) {
   return names;
 }
 async function materializeProviderSkills(root2, targetRoot, agent, dryRun, steps) {
-  const sourceRoot2 = join113(root2, "skills");
+  const sourceRoot2 = join114(root2, "skills");
   for (const name3 of await bundledProviderSkillNames(root2)) {
-    const source2 = join113(sourceRoot2, name3);
-    const target = join113(targetRoot, name3);
+    const source2 = join114(sourceRoot2, name3);
+    const target = join114(targetRoot, name3);
     steps.push({
       agent,
       command: `materialize lifecycle Provider skill: ${shellQuote8(source2)} -> ${shellQuote8(target)}`,
@@ -113184,7 +113200,7 @@ async function materializeProviderSkills(root2, targetRoot, agent, dryRun, steps
   }
 }
 async function installCursor(root2, dryRun, steps) {
-  const source2 = join113(root2, "cursor");
+  const source2 = join114(root2, "cursor");
   const target = cursorPluginRoot();
   steps.push({
     agent: "cursor",
@@ -113239,12 +113255,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(join113(codexHome(), "config.toml"))} registers local marketplace ${shellQuote8(MARKETPLACE_NAME)}`,
+    command: `ensure ${shellQuote8(join114(codexHome(), "config.toml"))} registers local marketplace ${shellQuote8(MARKETPLACE_NAME)}`,
     status: dryRun ? "planned" : "ran"
   });
   steps.push({
     agent: "codex",
-    command: `ensure ${shellQuote8(join113(codexHome(), "config.toml"))} enables ${shellQuote8(PLUGIN_ID)}`,
+    command: `ensure ${shellQuote8(join114(codexHome(), "config.toml"))} enables ${shellQuote8(PLUGIN_ID)}`,
     status: dryRun ? "planned" : "ran"
   });
   if (dryRun) {
@@ -113283,10 +113299,10 @@ function pluginAgentOption(value) {
 }
 function packageCandidateDirs() {
   const dirs = [];
-  let dir = dirname49(fileURLToPath10(import.meta.url));
+  let dir = dirname48(fileURLToPath10(import.meta.url));
   for (let index2 = 0;index2 < 8; index2++) {
     dirs.push(dir);
-    const parent = dirname49(dir);
+    const parent = dirname48(dir);
     if (parent === dir)
       break;
     dir = parent;
@@ -113299,13 +113315,13 @@ function pluginRootCandidates() {
     return [resolve42(envRoot)];
   const candidates = [];
   for (const dir of packageCandidateDirs()) {
-    candidates.push(join114(dir, "plugins"));
-    candidates.push(join114(dir, "dist", "plugins"));
+    candidates.push(join115(dir, "plugins"));
+    candidates.push(join115(dir, "dist", "plugins"));
   }
   return [...new Set(candidates)];
 }
 function isInstallablePluginRoot(root2) {
-  return existsSync35(join114(root2, ".claude-plugin", "marketplace.json")) && existsSync35(join114(root2, ".agents", "plugins", "marketplace.json")) && existsSync35(join114(root2, "claude", ".claude-plugin", "plugin.json")) && existsSync35(join114(root2, "codex", ".codex-plugin", "plugin.json")) && existsSync35(join114(root2, "cursor", ".cursor-plugin", "plugin.json")) && existsSync35(join114(root2, "skills"));
+  return existsSync35(join115(root2, ".claude-plugin", "marketplace.json")) && existsSync35(join115(root2, ".agents", "plugins", "marketplace.json")) && existsSync35(join115(root2, "claude", ".claude-plugin", "plugin.json")) && existsSync35(join115(root2, "codex", ".codex-plugin", "plugin.json")) && existsSync35(join115(root2, "cursor", ".cursor-plugin", "plugin.json")) && existsSync35(join115(root2, "skills"));
 }
 function resolveBundledPluginsRoot() {
   const candidates = pluginRootCandidates();
@@ -113455,14 +113471,14 @@ function registerPluginCommands(program2) {
     const agent = pluginAgentOption(options.agent);
     process.stdout.write(formatPluginStatusResult(await runPluginStatusCommand({ agent })));
   });
-  plugin.command("install").description("Install globally by default, or copy standalone skills with --local <path>").option("--agent <agent>", "agent target: claude | codex | cursor | all", "all").option("--local <path>", "Auto-detect hosts under a repository; with --agent, use the exact host directory").option("--dry-run", "Preview installation without writing files or configuration").action(async (options, command3) => {
+  plugin.command("install").description("Install globally by default, or copy standalone skills with --local <path>").option("--agent <agent>", "agent target: claude | codex | cursor | all; local only: auto-detect | standalone", "all").option("--local <path>", "Repository root; install selected or detected hosts into their corresponding subdirectories").option("--dry-run", "Preview installation without writing files or configuration").action(async (options, command3) => {
     if (options.local !== undefined) {
-      const agent2 = command3.getOptionValueSource("agent") === "cli" ? pluginAgentOption(options.agent) : undefined;
-      if (agent2 === "all") {
-        throw new ContextError(ExitCode.UserError, "--local requires one --agent (claude, cursor or codex), or omit --agent for automatic detection.");
+      if (command3.getOptionValueSource("agent") !== "cli") {
+        throw new ContextError(ExitCode.UserError, "--local requires explicit --agent: claude, cursor, codex, all, auto-detect or standalone.");
       }
+      const agent2 = options.agent === "auto-detect" || options.agent === "standalone" ? options.agent : pluginAgentOption(options.agent);
       const { pluginsRoot } = await runPluginPathCommand();
-      process.stdout.write(agent2 ? await installLocalSkills(pluginsRoot, String(options.local), options.dryRun === true, agent2) : await installAutoLocalSkills(pluginsRoot, String(options.local), options.dryRun === true));
+      process.stdout.write(agent2 === "standalone" ? await installLocalSkills(pluginsRoot, String(options.local), options.dryRun === true) : await installAutoLocalSkills(pluginsRoot, String(options.local), options.dryRun === true, undefined, agent2 === "auto-detect" ? undefined : agent2));
       return;
     }
     const agent = pluginAgentOption(options.agent);
@@ -113550,21 +113566,21 @@ function inferErrorCategory(message) {
 }
 function readQuickstartPath() {
   try {
-    let dir = dirname50(fileURLToPath11(import.meta.url));
+    let dir = dirname49(fileURLToPath11(import.meta.url));
     for (let i2 = 0;i2 < 8; i2++) {
-      const candidate = join115(dir, "docs", "quickstart.md");
+      const candidate = join116(dir, "docs", "quickstart.md");
       if (existsSync36(candidate))
         return candidate;
-      const pkg = join115(dir, "package.json");
+      const pkg = join116(dir, "package.json");
       if (existsSync36(pkg))
         return candidate;
-      const parent = dirname50(dir);
+      const parent = dirname49(dir);
       if (parent === dir)
         break;
       dir = parent;
     }
   } catch {}
-  return join115(dirname50(fileURLToPath11(import.meta.url)), "docs", "quickstart.md");
+  return join116(dirname49(fileURLToPath11(import.meta.url)), "docs", "quickstart.md");
 }
 var GREEN = "\x1B[32m";
 var RESET = "\x1B[0m";