@c4a/context-cli 0.7.35 → 0.7.37

package/cli.js

@@ -79425,6 +79425,33 @@ var init_productionStage = __esm(() => {
   terminal = new Set(["accepted", "excluded", "replaced"]);
 });
 
+// src/project/productionSourceSummary.ts
+function productionSourceSummary(stage) {
+  const pending = new Set(stage.pending_scopes);
+  const unavailable = new Set(stage.gaps.map((gap) => gap.scope));
+  return {
+    stage_source_count: new Set(stage.scopes.map((source2) => source2.scope)).size,
+    pending_scope_count: pending.size,
+    unavailable_source_count: unavailable.size,
+    pending_without_read_failure_count: [...pending].filter((scope2) => !unavailable.has(scope2)).length,
+    planned_article_count: new Set(stage.tasks.filter((task) => !["excluded", "replaced"].includes(task.status)).map((task) => task.path)).size,
+    unavailable_sources: stage.gaps,
+    meaning: "Pending scopes are remaining investigation, not missing knowledge or failed captures. Unavailable sources have current material/baseline read failures; inspect their reasons. Counts can overlap and must not be added. Restore required code dependencies even for document-led work."
+  };
+}
+function productionSourceSummaryMarkdown(stage) {
+  const summary = productionSourceSummary(stage);
+  return [
+    "## Source availability and progress",
+    "",
+    `Stage sources: ${summary.stage_source_count}; pending investigation scopes: ${summary.pending_scope_count}; sources with read failures: ${summary.unavailable_source_count}; pending scopes without read failures: ${summary.pending_without_read_failure_count}; planned articles: ${summary.planned_article_count}.`,
+    summary.meaning,
+    "",
+    ...summary.unavailable_sources.map((gap) => `- ${gap.scope}: ${gap.reason}`),
+    ""
+  ];
+}
+
 // src/project/productionStageStore.ts
 var exports_productionStageStore = {};
 __export(exports_productionStageStore, {
@@ -79544,8 +79571,7 @@ function productionPlanMarkdown(stage) {
       "Then present the updated report and apply context.gate.work_start_scope; an old decision does not approve changed article goals.",
       ""
     ] : [],
-    ...stage.gaps.map((gap) => `- ${gap.scope}: ${gap.reason}`),
-    ""
+    ...productionSourceSummaryMarkdown(stage)
   ].join(`
 `);
 }
@@ -81069,8 +81095,9 @@ async function resolveProductionExclusions(requirements, readBaseline) {
 import { randomUUID as randomUUID3 } from "node:crypto";
 import { readFile as readFile34, access as access3 } from "node:fs/promises";
 import { join as join39 } from "node:path";
-function refreshRequired(stage, message) {
+function refreshRequired(stage, message, detail = {}) {
   return new ContextError(ExitCode.UserError, message, {
+    ...detail,
     category: ErrorCategory.UserInputInvalid,
     reason_code: "production-planning-refresh-required",
     next_action: { command: `context action prepare-current --revision ${stage} --format json` }
@@ -81169,6 +81196,7 @@ Restore the authorized source and retry preparation.
       `Existing reader topics: ${join39(directory, "guidance/existing-articles.md")}`,
       `Stage: ${stage.id}`,
       "",
+      ...productionSourceSummaryMarkdown(stage),
       ...scopes.map((scope2) => `- ${scope2.scope}: ${join39(directory, productionSourceFile(scope2.scope))}`),
       "",
       "Use code skeletons and document outlines to identify the authorized capability families and document tasks, then selectively read full material to decide reader topics. Navigation is not a complete feature inventory. Keep unchecked scope pending; do not parse all code or maintain per-symbol disposition just to plan.",
@@ -81192,7 +81220,7 @@ Restore the authorized source and retry preparation.
       capabilities: productionCapabilitiesSchema.parse({}),
       materials: { ...prepared.materials, sources: sourceMaterials, guidance }
     });
-    return { stage_state: "active", next: { directory, mode: "single-agent" } };
+    return { stage_state: "active", source_summary: productionSourceSummary(stage), next: { directory, mode: "single-agent" } };
   });
 }
 async function submitProductionPlan(input) {
@@ -81220,9 +81248,12 @@ async function submitProductionPlan(input) {
       throw new TypeError("Pending investigation must name unique authorized stage scopes");
     }
     if (stage.gaps.some((gap) => !pendingScopes.includes(gap.scope)))
-      throw refreshRequired(stage.id, "Keep unresolved material gaps in pending_scopes; restore the source if unavailable, then prepare the current stage to refresh its material snapshot");
+      throw refreshRequired(stage.id, "Keep unresolved material gaps in pending_scopes. These are current material/baseline read failures, not evidence that knowledge was never captured. Restore required dependencies before preparing their snapshots; do not label every pending source as unavailable.", {
+        source_summary: productionSourceSummary(stage),
+        missing_pending_scopes: [...new Set(stage.gaps.filter((gap) => !pendingScopes.includes(gap.scope)).map((gap) => gap.scope))]
+      });
     if (plan.articles.some((article) => article.sources.some((scope2) => stage.gaps.some((gap) => gap.scope === scope2)))) {
-      throw refreshRequired(stage.id, "An article requires unavailable material in the captured stage. Restore the source if needed, then prepare the current stage; independent source plans may proceed");
+      throw refreshRequired(stage.id, "An article requires unavailable material in the captured stage. Restore the required source, including code dependencies of document-led work, then prepare the current stage; independent source plans may proceed.", { source_summary: productionSourceSummary(stage) });
     }
     for (const source2 of stage.scopes)
       if (!stage.gaps.some((gap) => gap.scope === source2.scope) && await productionSourceBaseline(input.projectRoot, source2.scope) !== source2.baseline) {
@@ -92313,11 +92344,11 @@ function reviewApproveCommand(observation) {
   }
   return "context review apply '<review-decisions-file>' --format json";
 }
-function reviewForceApproveCommand(observation) {
+function reviewConfirmedApproveCommand(observation) {
   if (observation.draftCandidates <= 0 || observation.draftCollections.length === 0) {
     return;
   }
-  return observation.draftCollections.length === 1 ? `context review approve-all ${observation.draftCollections[0]} --force --format json` : "context review approve-all --all --force --format json";
+  return observation.draftCollections.length === 1 ? `context review approve-all ${observation.draftCollections[0]} --confirmed --format json` : "context review approve-all --all --confirmed --format json";
 }
 function workspaceRepairPlan(observation) {
   return { commands: [command("context verify --format json --compact", "read")] };
@@ -92441,8 +92472,8 @@ var init_workflowHostPlans = __esm(() => {
         commands: next === undefined ? [] : [command(next, "write", "agent-required")]
       };
     },
-    "context.review.force-approve-current": (observation) => {
-      const next = reviewForceApproveCommand(observation);
+    "context.review.confirm-current": (observation) => {
+      const next = reviewConfirmedApproveCommand(observation);
       return {
         commands: next === undefined ? [] : [command(next, "write")]
       };
@@ -98100,7 +98131,7 @@ var init_larkResourceCommand = __esm(() => {
 
 // src/lib/larkMediaDownload.ts
 import { readdir as readdir21, rm as rm20 } from "node:fs/promises";
-import { join as join94 } from "node:path";
+import { join as join95 } from "node:path";
 async function downloadLarkMedia(input) {
   const shared = ["--as", input.identity, "--token", input.token, "--output", "./resource", "--format", "json"];
   try {
@@ -98110,7 +98141,7 @@ async function downloadLarkMedia(input) {
     if (!input.allowPreview || !isLarkResourcePermissionDenied(error))
       throw error;
     for (const entry of await readdir21(input.cwd))
-      await rm20(join94(input.cwd, entry), { recursive: true, force: true });
+      await rm20(join95(input.cwd, entry), { recursive: true, force: true });
     await runLarkResourceCommand(input.runner, ["docs", "+media-preview", ...shared], { cwd: input.cwd });
     return "preview";
   }
@@ -98120,9 +98151,9 @@ var init_larkMediaDownload = __esm(() => {
 });
 
 // src/lib/larkWhiteboardExport.ts
-import { mkdtemp as mkdtemp4, readFile as readFile74, rm as rm21 } from "node:fs/promises";
+import { mkdtemp as mkdtemp4, readFile as readFile75, rm as rm21 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join as join95 } from "node:path";
+import { join as join96 } from "node:path";
 function stableJson2(value) {
   if (value === undefined)
     return "null";
@@ -98152,7 +98183,7 @@ function canonicalWhiteboardPayload(value) {
   };
 }
 async function exportLarkWhiteboardRaw(runner2, identity2, token) {
-  const tempRoot = await mkdtemp4(join95(tmpdir(), "context-lark-whiteboard-"));
+  const tempRoot = await mkdtemp4(join96(tmpdir(), "context-lark-whiteboard-"));
   try {
     await runLarkResourceCommand(runner2, [
       "whiteboard",
@@ -98169,7 +98200,7 @@ async function exportLarkWhiteboardRaw(runner2, identity2, token) {
       "--format",
       "json"
     ], { cwd: tempRoot });
-    const rawPayload = JSON.parse(await readFile74(join95(tempRoot, "raw.json"), "utf8"));
+    const rawPayload = JSON.parse(await readFile75(join96(tempRoot, "raw.json"), "utf8"));
     return Buffer.from(`${stableJson2(canonicalWhiteboardPayload(rawPayload))}
 `, "utf8");
   } finally {
@@ -98208,8 +98239,8 @@ var init_larkImagePolicy = __esm(() => {
 
 // src/lib/larkResourceMaterialization.ts
 import { createHash as createHash28 } from "node:crypto";
-import { mkdtemp as mkdtemp5, readFile as readFile75, readdir as readdir22, rm as rm22 } from "node:fs/promises";
-import { extname as extname13, join as join96 } from "node:path";
+import { mkdtemp as mkdtemp5, readFile as readFile76, readdir as readdir22, rm as rm22 } from "node:fs/promises";
+import { extname as extname13, join as join97 } from "node:path";
 import { tmpdir as tmpdir2 } from "node:os";
 function countByKind(items, status) {
   const counts2 = new Map;
@@ -98314,17 +98345,17 @@ function findBooleanField(value, name3) {
 }
 async function downloadedFile(input) {
   if (input.localPath !== undefined) {
-    const bytes = await readFile75(input.localPath);
+    const bytes = await readFile76(input.localPath);
     return { path: input.localPath, bytes, mediaType: mediaTypeFor(input.localPath, bytes), representation: "original" };
   }
-  const tempRoot = await mkdtemp5(join96(tmpdir2(), "context-lark-resource-"));
+  const tempRoot = await mkdtemp5(join97(tmpdir2(), "context-lark-resource-"));
   try {
     const representation = await downloadLarkMedia({ ...input, cwd: tempRoot });
     const entries2 = (await readdir22(tempRoot, { withFileTypes: true })).filter((entry) => entry.isFile());
     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 readFile75(join96(tempRoot, path3));
+    const bytes = await readFile76(join97(tempRoot, path3));
     return { path: path3, bytes, mediaType: mediaTypeFor(path3, bytes), representation };
   } finally {
     await rm22(tempRoot, { recursive: true, force: true });
@@ -98396,9 +98427,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 mkdtemp5(join96(tmpdir2(), "context-lark-sheet-"));
+  const tempRoot = await mkdtemp5(join97(tmpdir2(), "context-lark-sheet-"));
   try {
-    const outputPath = join96(tempRoot, "sheet.json");
+    const outputPath = join97(tempRoot, "sheet.json");
     const stdout = await runLarkResourceCommand(runner2, [
       "sheets",
       "+csv-get",
@@ -98418,7 +98449,7 @@ async function sheetMaterialization(resource, runner2, identity2) {
     if (findBooleanField(receipt2, "truncated") === true || findBooleanField(receipt2, "complete") === false) {
       throw new Error("embedded Sheet read was truncated");
     }
-    const payload = JSON.parse(await readFile75(outputPath, "utf8"));
+    const payload = JSON.parse(await readFile76(outputPath, "utf8"));
     const csv = findStringField(payload, new Set(["annotated_csv", "csv", "content", "text"]));
     if (csv === undefined)
       throw new Error("embedded Sheet response has no CSV payload");
@@ -99533,8 +99564,8 @@ var init_sensitiveSourceLiteral = __esm(() => {
 
 // src/project/larkSnapshotBundle.ts
 import { createHash as createHash29 } from "node:crypto";
-import { lstat as lstat10, mkdir as mkdir33, readFile as readFile76, realpath as realpath10, rename as rename8, writeFile as writeFile26 } from "node:fs/promises";
-import { basename as basename10, dirname as dirname39, isAbsolute as isAbsolute17, join as join97, relative as relative24, resolve as resolve30, sep as sep8 } from "node:path";
+import { lstat as lstat10, mkdir as mkdir33, readFile as readFile77, realpath as realpath10, rename as rename8, writeFile as writeFile26 } from "node:fs/promises";
+import { basename as basename10, dirname as dirname39, isAbsolute as isAbsolute17, join as join98, relative as relative24, resolve as resolve30, sep as sep8 } from "node:path";
 import { isDeepStrictEqual as isDeepStrictEqual2 } from "node:util";
 function normalizedSnapshotResourcePolicy(policy) {
   return { ...policy, images: policy.images ?? "bundle", gifs: policy.gifs ?? "bundle" };
@@ -99575,13 +99606,13 @@ async function readFileEntry(root2, entry) {
   const parts = safePath(entry.path).split("/");
   let current2 = root2;
   for (const [index2, part] of parts.entries()) {
-    current2 = join97(current2, part);
+    current2 = join98(current2, part);
     const stat11 = await lstat10(current2);
     if (stat11.isSymbolicLink() || (index2 === parts.length - 1 ? !stat11.isFile() : !stat11.isDirectory())) {
       throw larkSnapshotError(`Snapshot entry is not a regular file: ${entry.path}`, "path-invalid");
     }
   }
-  const bytes = await readFile76(current2);
+  const bytes = await readFile77(current2);
   if (digest6(bytes) !== entry.sha256)
     throw larkSnapshotError(`Snapshot content changed: ${entry.path}`, "digest-mismatch");
   return bytes;
@@ -99644,13 +99675,13 @@ async function writeLarkSnapshotBundle(input) {
   };
   schema2.parse(manifest);
   for (const [path3, bytes] of files) {
-    await mkdir33(dirname39(join97(root2, path3)), { recursive: true });
-    await writeFile26(join97(root2, path3), bytes, { flag: "wx", mode: 384 });
+    await mkdir33(dirname39(join98(root2, path3)), { recursive: true });
+    await writeFile26(join98(root2, path3), bytes, { flag: "wx", mode: 384 });
   }
   await validateBundle(root2, manifest);
-  await writeFile26(join97(root2, `${FILE2}.pending`), `${JSON.stringify(manifest, null, 2)}
+  await writeFile26(join98(root2, `${FILE2}.pending`), `${JSON.stringify(manifest, null, 2)}
 `, { flag: "wx", mode: 384 });
-  await rename8(join97(root2, `${FILE2}.pending`), join97(root2, FILE2));
+  await rename8(join98(root2, `${FILE2}.pending`), join98(root2, FILE2));
   return manifest;
 }
 async function validateBundle(root2, manifest) {
@@ -99723,11 +99754,11 @@ async function validateBundle(root2, manifest) {
 async function readLarkSnapshotBundle(directory, target) {
   try {
     const root2 = await assertSnapshotDirectory(directory);
-    const path3 = join97(root2, FILE2);
+    const path3 = join98(root2, FILE2);
     const stat11 = await lstat10(path3);
     if (stat11.isSymbolicLink() || !stat11.isFile())
       throw larkSnapshotError("Snapshot receipt must be a regular file", "path-invalid");
-    const manifest = schema2.parse(JSON.parse(await readFile76(path3, "utf8")));
+    const manifest = schema2.parse(JSON.parse(await readFile77(path3, "utf8")));
     assertTarget(manifest.url, target);
     return await validateBundle(root2, manifest);
   } catch (error) {
@@ -99751,8 +99782,8 @@ async function reserveSnapshotDirectory(directory, workspaceRoot) {
       ancestor = dirname39(ancestor);
     }
   }
-  const parent = join97(ancestor, ...missing);
-  const output = join97(parent, basename10(requested));
+  const parent = join98(ancestor, ...missing);
+  const output = join98(parent, basename10(requested));
   const { findContextProjectRoot: findContextProjectRoot2 } = await Promise.resolve().then(() => (init_workspace(), exports_workspace));
   const owner = findContextProjectRoot2(parent)?.projectRoot ?? workspaceRoot;
   if (owner !== undefined) {
@@ -99825,8 +99856,8 @@ var init_larkSnapshotBundle = __esm(() => {
 });
 
 // src/project/documentCaptureLark.ts
-import { readdir as readdir23, readFile as readFile77 } from "node:fs/promises";
-import { basename as basename11, extname as extname14, join as join98 } from "node:path";
+import { readdir as readdir23, readFile as readFile78 } from "node:fs/promises";
+import { basename as basename11, extname as extname14, join as join99 } from "node:path";
 function titleFromMarkdown2(markdown, fallbackPath) {
   const heading2 = markdown.split(`
 `).find((line) => /^#\s+\S/u.test(line));
@@ -99845,7 +99876,7 @@ function countLines3(markdown) {
 }
 async function fileContentMatches(path3, content3) {
   try {
-    const current2 = await readFile77(path3);
+    const current2 = await readFile78(path3);
     const expected = typeof content3 === "string" ? Buffer.from(content3, "utf8") : Buffer.from(content3);
     return current2.equals(expected);
   } catch {
@@ -99853,7 +99884,7 @@ async function fileContentMatches(path3, content3) {
   }
 }
 function sourceManifestPath2(entry) {
-  return entry.snapshot?.manifest ?? join98(entry.materializedAt, "manifest.json");
+  return entry.snapshot?.manifest ?? join99(entry.materializedAt, "manifest.json");
 }
 function larkRuntimeError(message, detail) {
   return new ContextError(ExitCode.ExternalToolError, message, {
@@ -99980,7 +100011,7 @@ function assetManifestEntry(asset, assetRoot) {
   };
 }
 async function listSnapshotAssetFiles(root2, assetRoot) {
-  const assetsRoot = join98(root2, assetRoot);
+  const assetsRoot = join99(root2, assetRoot);
   const files = [];
   const visit4 = async (dir, prefix = assetRoot) => {
     let entries2;
@@ -99993,7 +100024,7 @@ async function listSnapshotAssetFiles(root2, assetRoot) {
     }
     for (const entry of entries2) {
       const relPath = `${prefix}/${entry.name}`;
-      const absolutePath = join98(dir, entry.name);
+      const absolutePath = join99(dir, entry.name);
       if (entry.isDirectory()) {
         await visit4(absolutePath, relPath);
         continue;
@@ -100008,7 +100039,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) => join98(input.materializedAtAbsPath, path3));
+  return existingPaths.filter((path3) => !input.currentPaths.has(path3)).map((path3) => join99(input.materializedAtAbsPath, path3));
 }
 function normalizeLarkError(error, sourceName) {
   if (error instanceof ContextError)
@@ -100129,9 +100160,9 @@ async function runCaptureLarkPhaseUnlocked(input) {
     locator
   }];
   const manifestPath = sourceManifestPath2(entry);
-  const manifestAbsPath = join98(input.projectRoot, manifestPath);
+  const manifestAbsPath = join99(input.projectRoot, manifestPath);
   const materializedAt = entry.materializedAt;
-  const materializedAtAbsPath = join98(input.projectRoot, materializedAt);
+  const materializedAtAbsPath = join99(input.projectRoot, materializedAt);
   const manifest = createDocumentSnapshotManifest({
     sourceType: "lark",
     sourceName: resolved.sourceName,
@@ -100165,13 +100196,13 @@ async function runCaptureLarkPhaseUnlocked(input) {
   }));
   try {
     const requestedWrites = [{
-      path: join98(materializedAtAbsPath, documentPath),
+      path: join99(materializedAtAbsPath, documentPath),
       bytes: normalized
     }];
     for (const asset of assets) {
       if (asset.bytes !== undefined) {
         requestedWrites.push({
-          path: join98(materializedAtAbsPath, asset.entry.path),
+          path: join99(materializedAtAbsPath, asset.entry.path),
           bytes: asset.bytes
         });
       }
@@ -100188,7 +100219,7 @@ async function runCaptureLarkPhaseUnlocked(input) {
       currentPaths: new Set(assets.filter((asset) => asset.bytes !== undefined).map((asset) => asset.entry.path))
     });
     await applyAtomicFileBatch({
-      transactionRoot: join98(input.projectRoot, ".tmp", "context-runtime", "capture-transactions"),
+      transactionRoot: join99(input.projectRoot, ".tmp", "context-runtime", "capture-transactions"),
       writes,
       removals
     });
@@ -100338,7 +100369,7 @@ __export(exports_articleRetirement, {
   retireArticles: () => retireArticles,
   articleRetirementSchema: () => articleRetirementSchema
 });
-import { readFile as readFile83, readdir as readdir24 } from "node:fs/promises";
+import { readFile as readFile84, readdir as readdir24 } from "node:fs/promises";
 import { posix as posix10 } from "node:path";
 function rebuildInput(revision) {
   return JSON.stringify({ id: `retirement-${revision.slice(7)}`, operation: "rebuild", timing: "priority", targets: [] });
@@ -100359,7 +100390,7 @@ function invalid2(reason, message, details = {}) {
 }
 async function text9(root2, path3) {
   try {
-    return await readFile83(await safeProjectTarget(root2, path3), "utf8");
+    return await readFile84(await safeProjectTarget(root2, path3), "utf8");
   } catch (error) {
     if (error.code === "ENOENT")
       return;
@@ -100621,8 +100652,8 @@ __export(exports_writeLockRecovery, {
   recoverWriterLock: () => recoverWriterLock,
   inspectWriterLock: () => inspectWriterLock
 });
-import { lstat as lstat11, mkdir as mkdir35, readFile as readFile84, readdir as readdir25, rename as rename9, rmdir as rmdir2 } from "node:fs/promises";
-import { join as join103 } from "node:path";
+import { lstat as lstat11, mkdir as mkdir35, readFile as readFile85, readdir as readdir25, rename as rename9, rmdir as rmdir2 } from "node:fs/promises";
+import { join as join104 } from "node:path";
 import { createHash as createHash31, randomUUID as randomUUID7 } from "node:crypto";
 async function inspectWriterLock(root2) {
   const path3 = await safeProjectTarget(root2, lockRelative);
@@ -100637,7 +100668,7 @@ async function inspectWriterLock(root2) {
   if (!stat11.isDirectory() || stat11.isSymbolicLink())
     throw new Error("Writer lock must be a real directory.");
   const ownerPath = await safeProjectTarget(root2, `${lockRelative}/owner.json`);
-  const bytes = await readFile84(ownerPath, "utf8");
+  const bytes = await readFile85(ownerPath, "utf8");
   const owner = JSON.parse(bytes);
   if (owner.protocol !== "context.project-write-lock.v1" || !Number.isSafeInteger(owner.pid) || owner.pid <= 0) {
     throw new Error("Writer lock owner is invalid; preserve the lock for diagnosis.");
@@ -100669,8 +100700,8 @@ async function recoverWriterLock(input) {
     };
   if (input.plan_digest !== before.digest)
     throw new Error("Writer lock changed; preview recovery again.");
-  const path3 = join103(input.projectRoot, lockRelative);
-  const guard = join103(path3, ".recovery");
+  const path3 = join104(input.projectRoot, lockRelative);
+  const guard = join104(path3, ".recovery");
   await mkdir35(guard);
   let archived = false;
   try {
@@ -100681,7 +100712,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 rename9(path3, join103(input.projectRoot, archive));
+    await rename9(path3, join104(input.projectRoot, archive));
     archived = true;
     return { action: "writer-lock-recovered", archived_lock: archive, next: "context task recover --format json" };
   } finally {
@@ -100705,12 +100736,12 @@ __export(exports_taskRecovery, {
   RECOVERY_COMMAND: () => RECOVERY_COMMAND
 });
 import { existsSync as existsSync26 } from "node:fs";
-import { dirname as dirname42, join as join104 } from "node:path";
-import { lstat as lstat12, readdir as readdir26, readFile as readFile85 } from "node:fs/promises";
+import { dirname as dirname42, join as join105 } from "node:path";
+import { lstat as lstat12, readdir as readdir26, readFile as readFile86 } from "node:fs/promises";
 async function recoveryText(root2, path3) {
   const target = await safeProjectTarget(root2, path3);
   try {
-    return await readFile85(target, "utf8");
+    return await readFile86(target, "utf8");
   } catch (error) {
     if (error.code === "ENOENT")
       return;
@@ -100723,7 +100754,7 @@ async function recoveryJournals(root2) {
     await safeProjectTarget(root2, path3);
     let stat11;
     try {
-      stat11 = await lstat12(join104(root2, path3));
+      stat11 = await lstat12(join105(root2, path3));
     } catch (error) {
       if (error.code === "ENOENT")
         return;
@@ -100734,7 +100765,7 @@ async function recoveryJournals(root2) {
     if (stat11.isDirectory()) {
       if (depth > 3)
         throw new TypeError("Unexpected transaction directory depth; preserve it for diagnosis.");
-      for (const name3 of (await readdir26(join104(root2, path3))).sort())
+      for (const name3 of (await readdir26(join105(root2, path3))).sort())
         await visit4(`${path3}/${name3}`, depth + 1);
     } else if (stat11.isFile())
       entries2.push({ path: path3, digest: indexerProtocolDigest(await recoveryText(root2, path3)) });
@@ -100746,8 +100777,8 @@ function recoveryResources() {
   try {
     const root2 = dirname42(contextWorkflowProviderPath());
     const resources = {
-      skill: join104(root2, "skills/recover-workspace/SKILL.md"),
-      issue_template: join104(root2, "resources/templates/recovery-issue.md")
+      skill: join105(root2, "skills/recover-workspace/SKILL.md"),
+      issue_template: join105(root2, "resources/templates/recovery-issue.md")
     };
     if (!Object.values(resources).every((path3) => existsSync26(path3)))
       throw new Error("Recovery resources are absent from this Provider.");
@@ -100832,8 +100863,8 @@ var exports_taskLocalSourceAdjustment = {};
 __export(exports_taskLocalSourceAdjustment, {
   adjustLocalRevisionSources: () => adjustLocalRevisionSources
 });
-import { readFile as readFile86 } from "node:fs/promises";
-import { join as join105 } from "node:path";
+import { readFile as readFile87 } from "node:fs/promises";
+import { join as join106 } 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))
@@ -100876,7 +100907,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 readFile86(join105(root2, await revisionStoragePath(root2)), "utf8");
+  const raw = await readFile87(join106(root2, await revisionStoragePath(root2)), "utf8");
   let next2;
   const discardIds = new Set;
   if (!input.refresh) {
@@ -100979,7 +101010,7 @@ ${input.instruction}` : revision.instruction
     content: content3
   }];
   if (discardIds.size > 0) {
-    const ledger = await readFile86(join105(root2, CANDIDATE_LEDGER_FILE), "utf8").catch((error) => {
+    const ledger = await readFile87(join106(root2, CANDIDATE_LEDGER_FILE), "utf8").catch((error) => {
       if (error.code === "ENOENT")
         return;
       throw error;
@@ -101104,7 +101135,7 @@ var init_taskSourceAdjustment = __esm(() => {
 });
 
 // src/project/managedDocumentImport.ts
-import { readFile as readFile95 } from "node:fs/promises";
+import { readFile as readFile96 } from "node:fs/promises";
 async function importManagedDocument(projectRoot, value) {
   const input = inputSchema.parse(value);
   if (input.type !== "sessions" && input.changes !== undefined)
@@ -101113,7 +101144,7 @@ async function importManagedDocument(projectRoot, value) {
     const path3 = await assertManagedDocumentPath(projectRoot, input.type, input.name);
     let previous3;
     try {
-      previous3 = await readFile95(path3, "utf8");
+      previous3 = await readFile96(path3, "utf8");
     } catch (error) {
       if (!(error && typeof error === "object" && ("code" in error) && error.code === "ENOENT"))
         throw error;
@@ -101160,7 +101191,7 @@ var init_managedDocumentImport = __esm(() => {
 });
 
 // src/project/larkDocumentImport.ts
-import { readFile as readFile96 } from "node:fs/promises";
+import { readFile as readFile97 } from "node:fs/promises";
 import { resolve as resolve40 } from "node:path";
 async function importLarkDocument(projectRoot, value) {
   const input = schema4.parse(value);
@@ -101177,7 +101208,7 @@ async function importLarkDocument(projectRoot, value) {
   const responsePages = [];
   for (const path3 of input.response_files) {
     assertActionInputWorkspace(projectRoot, path3);
-    responsePages.push(await readFile96(resolve40(projectRoot, path3), "utf8"));
+    responsePages.push(await readFile97(resolve40(projectRoot, path3), "utf8"));
   }
   const mediaFiles = {};
   for (const [token, path3] of Object.entries(input.media_files ?? {})) {
@@ -101244,11 +101275,11 @@ var exports_managedDocumentRename = {};
 __export(exports_managedDocumentRename, {
   renameManagedDocument: () => renameManagedDocument
 });
-import { readFile as readFile97 } from "node:fs/promises";
-import { join as join117, posix as posix11 } from "node:path";
+import { readFile as readFile98 } from "node:fs/promises";
+import { join as join118, posix as posix11 } from "node:path";
 async function optionalText2(path3) {
   try {
-    return await readFile97(path3, "utf8");
+    return await readFile98(path3, "utf8");
   } catch (error) {
     if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
       return;
@@ -101332,7 +101363,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(join117(input.projectRoot, path3));
+      const before = await optionalText2(join118(input.projectRoot, path3));
       if (before === undefined)
         continue;
       let after;
@@ -101421,7 +101452,7 @@ var init_managedDocumentRename = __esm(() => {
 
 // src/cli.ts
 import { existsSync as existsSync36, realpathSync as realpathSync3 } from "node:fs";
-import { dirname as dirname50, join as join123 } from "node:path";
+import { dirname as dirname50, join as join124 } 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
@@ -101476,7 +101507,7 @@ init_dist();
 init_cliFeedback();
 init_errors3();
 init_exitCode();
-import { join as join92 } from "node:path";
+import { join as join93 } from "node:path";
 
 // src/project/documentCaptureAvailability.ts
 init_atomicFileBatch();
@@ -102470,6 +102501,7 @@ async function projectStatusSummary(status, projectRoot) {
       packages: status.packages.map((item) => ({ name: item.name, state: item.state })),
       meaning: status.evidenceStatus === "not-checked" ? "Progress only: workspace verification and delivery freshness were not checked. Delivery actions validate their inputs; context verify performs an explicit audit." : "Approved pages may not yet be built. Package freshness describes dist; task completion describes the current stage only."
     },
+    counts_scope: "Workspace inventory, not this request’s additions or article workload. Captured documents, approved articles, pending investigation and source-read failures are different measures; source ready counts alone do not explain failure causes.",
     counts: {
       sources: status.sourceSummary,
       draftCandidates: status.draftCandidates,
@@ -102556,9 +102588,9 @@ init_workflowTypes();
 // src/project/reviewHtml.ts
 init_candidateLedger();
 init_reviewShared();
-import { mkdir as mkdir31, readFile as readFile71, writeFile as writeFile25 } from "node:fs/promises";
+import { mkdir as mkdir31, readFile as readFile72, writeFile as writeFile25 } from "node:fs/promises";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
-import { dirname as dirname38, isAbsolute as isAbsolute15, join as join90, resolve as resolve28 } from "node:path";
+import { dirname as dirname38, isAbsolute as isAbsolute15, join as join91, resolve as resolve28 } from "node:path";
 
 // src/project/reviewSiteModel.ts
 init_siteTheme2();
@@ -105760,6 +105792,7 @@ async function collectReviewSiteModel(root2, candidates) {
       html: old === undefined ? renderReviewMarkdown(next.replace(/^# [^\n]+\n*/u, "")) : reviewBodyDiff(body(old).replace(/^# [^\n]+\n*/u, ""), next.replace(/^# [^\n]+\n*/u, "")),
       sources: [...r.source_refs, ...r.indexer_candidate.sections.flatMap((s) => s.references.map((ref2) => JSON.stringify(ref2)))]
     };
+    page.readVersion = hash3(JSON.stringify([page.id, page.title, page.path, page.html, page.sources]));
     if (found)
       pages.splice(pages.indexOf(found), 1, page);
     else
@@ -105800,146 +105833,394 @@ async function collectReviewSiteModel(root2, candidates) {
   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));
-  return { themeCss, title: siteTitle ?? pkg.name ?? "Knowledge review", baselineHash: await reviewSiteBaselineHash(root2, candidates.map((c) => c.record.approved_revision?.previous_path ?? c.record.path)), nodes, pages, navigationBaseline };
+  return { storageScope: hash3(root2), themeCss, title: siteTitle ?? pkg.name ?? "Knowledge reading report", baselineHash: await reviewSiteBaselineHash(root2, candidates.map((c) => c.record.approved_revision?.previous_path ?? c.record.path)), nodes, pages, navigationBaseline };
 }
 var reviewHtmlJson = (value) => JSON.stringify(value).replace(/</gu, "\\u003c").replace(/\u2028/gu, "\\u2028").replace(/\u2029/gu, "\\u2029");
 
-// src/project/reviewFeedbackCode.ts
-function createReviewFeedbackCodec() {
-  const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
-  function checksum(text9) {
-    let crc = 4294967295;
-    for (let i2 = 0;i2 < text9.length; i2++) {
-      crc ^= text9.charCodeAt(i2);
-      for (let j = 0;j < 8; j++)
-        crc = crc >>> 1 ^ (crc & 1 ? 3988292384 : 0);
+// src/project/reviewReportScope.ts
+init_atomicWrite();
+init_errors3();
+init_cliFeedback();
+init_exitCode();
+init_reviewShared();
+import { readFile as readFile71 } from "node:fs/promises";
+import { join as join90 } from "node:path";
+var scopePath = (root2, scope2) => join90(root2, ".tmp/context-runtime/review", `${scope2}.scope.json`);
+async function saveReviewReportScope(root2, scope2, candidates, baselineHash) {
+  const ids = candidates.map((candidate) => candidate.record.candidate_id).sort();
+  const value = {
+    baseline_hash: baselineHash,
+    scope: {
+      kind: scope2 === "all" ? "all" : "collection",
+      ...scope2 === "all" ? {} : { collection: scope2 },
+      count: ids.length,
+      ids_sha256: candidateIdsHash(ids),
+      candidates_sha256: candidateSetHash(candidates.map((candidate) => candidate.record)),
+      visible_candidate_ids: ids
     }
-    return ((crc ^ 4294967295) >>> 0).toString(16).padStart(8, "0");
-  }
-  function validate(value) {
-    if (!value || !/^[a-z][a-z0-9-]*$/.test(value.scope) || ![value.idsHash, value.contentHash, value.baselineHash].every((h) => typeof h === "string" && /^[a-f0-9]{64}$/.test(h)) || !Array.isArray(value.statuses) || !value.statuses.length || value.statuses.length > 1e5 || value.statuses.some((s) => !["approved", "rejected", "pending", "revised"].includes(s)) || value.statuses.every((s) => s === "pending") || !Array.isArray(value.repairs))
-      throw new Error("Invalid review feedback scope or decisions");
-    const seen = new Set;
-    for (const repair of value.repairs) {
-      if (!repair || !Number.isInteger(repair.index) || seen.has(repair.index) || value.statuses[repair.index] !== "revised" || typeof repair.instruction !== "string" || !repair.instruction.trim() || repair.instruction.length > 20000)
-        throw new Error("Invalid or conflicting revision instruction");
-      seen.add(repair.index);
+  };
+  await atomicWriteFile(scopePath(root2, scope2), JSON.stringify(value, null, 2) + `
+`);
+}
+async function readConfirmedReviewScope(root2, scope2) {
+  try {
+    const value = JSON.parse(await readFile71(scopePath(root2, scope2), "utf8"));
+    if (!value || typeof value !== "object" || !("scope" in value) || !("baseline_hash" in value))
+      throw new Error("Missing report scope");
+    const parsed = value;
+    if (typeof parsed.baseline_hash !== "string" || !/^[a-f0-9]{64}$/u.test(parsed.baseline_hash) || !parsed.scope || !Number.isInteger(parsed.scope.count) || parsed.scope.count < 0 || typeof parsed.scope.ids_sha256 !== "string" || typeof parsed.scope.candidates_sha256 !== "string" || !Array.isArray(parsed.scope.visible_candidate_ids) || parsed.scope.visible_candidate_ids.some((id3) => typeof id3 !== "string") || (scope2 === "all" ? parsed.scope.kind !== "all" : parsed.scope.kind !== "collection" || parsed.scope.collection !== scope2)) {
+      throw new Error("Invalid report scope");
     }
-    if (value.statuses.filter((s) => s === "revised").length !== seen.size)
-      throw new Error("Missing revision instruction");
-    return value;
+    return parsed;
+  } catch (error) {
+    throw new ContextError(ExitCode.UserError, "A current report scope is required for user confirmation", {
+      category: ErrorCategory.UserInputInvalid,
+      reason: error instanceof Error ? error.message : String(error),
+      next: `context review html ${scope2 === "all" ? "--all" : scope2} --format json`
+    });
   }
-  function encode(value) {
-    validate(value);
-    const bytes = new TextEncoder().encode(JSON.stringify({ scope: value.scope, idsHash: value.idsHash, contentHash: value.contentHash, baselineHash: value.baselineHash, statuses: value.statuses }));
-    let bits = 0, carry = 0, data2 = "";
-    for (const byte of bytes) {
-      carry = carry << 8 | byte;
-      bits += 8;
-      while (bits >= 6) {
-        bits -= 6;
-        data2 += alphabet[carry >>> bits & 63];
-      }
-    }
-    if (bits)
-      data2 += alphabet[carry << 6 - bits & 63];
-    const body2 = `CR2.${data2}`;
-    const repairs = value.repairs.map((r) => JSON.stringify([r.index, r.instruction])).join(`
-`);
-    const trailer = repairs ? `
-${repairs}` : "";
-    const code3 = `${body2}.${checksum(body2 + trailer)}${trailer}`;
-    if (code3.length > 250000)
-      throw new Error("Review feedback is too large; shorten instructions or review a smaller scope");
-    return code3;
+}
+
+// src/project/reviewSiteClient.ts
+var REVIEW_SITE_CLIENT = `
+const $ = id => document.getElementById(id);
+const escape = value => String(value).replace(/[&<>"']/g, char => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[char]));
+const words = {
+  read: ['已读', 'Read'], revisions: ['修订', 'Revisions'], total: ['总', 'Total'], unit: ['篇', ''],
+  copy: ['复制修订意见', 'Copy revision notes'], home: ['本次内容', 'This update'],
+  homeHint: ['阅读文章，可在正文下方填写修订意见。完成后返回会话确认或反馈。', 'Read the articles and add revision notes below. Return to the conversation to confirm or share feedback.'],
+  navigate: ['目录与文章', 'Directories and articles'], files: ['预期工作区变化', 'Expected workspace changes'],
+  note: ['输入本篇修订意见……', 'Enter revision notes for this article…'], clear: ['清空本条修订', 'Clear this note'],
+  revisionTitle: ['修订意见', 'Revision notes'], revisionHint: ['点击文章标题返回正文，继续编辑修订意见。', 'Select an article title to return to the article and edit its notes.'],
+  empty: ['暂无修订意见', 'No revision notes yet'], emptyHint: ['可在文章正文下方填写修订意见。', 'Add revision notes below an article.'],
+  emptyCopy: ['暂无修订意见，可返回会话确认。', 'No revision notes. You can confirm in the conversation.'],
+  copied: ['已复制修订意见，可粘贴到会话中。', 'Revision notes copied. Paste them into the conversation.'],
+  manualCopy: ['请手动复制修订意见', 'Copy revision notes manually'], manualHint: ['自动复制不可用，请复制下方文本并回复到会话中。', 'Automatic copy is unavailable. Copy the text below and reply in the conversation.'],
+  close: ['关闭', 'Close'], baseline: ['无 Git 导航基线，目录沿用当前工作区；未推断历史目录变化。', 'No Git navigation baseline. The current workspace navigation is shown.'],
+  approvedContext: ['既有正文，仅供对照。', 'Existing content, shown for reference.'], unchanged: ['本次未变更内容略。', 'Unchanged content omitted.'],
+  previous: ['查看旧文本', 'Previous text'], removed: ['移除或替换的旧内容', 'Removed or replaced content'],
+  removedNav: ['移除的目录条目', 'Removed navigation entries'], unplaced: ['待落位文章', 'Unplaced articles'],
+  sources: ['来源引用', 'Sources'], feedbackTag: ['修订', 'Notes'],
+};
+let language = 'zh';
+const t = key => words[key]?.[language === 'zh' ? 0 : 1] || key;
+const candidates = DATA.pages.filter(page => page.candidate_id);
+const pagesById = new Map(DATA.pages.map(page => [page.id, page]));
+const read = new Set();
+const notes = new Map();
+const expanded = new Set();
+let selected = null;
+let active = null;
+let view = 'home';
+let toastTimer;
+let copyTimer;
+const storageKey = 'context-reading-v1:' + DATA.storageScope;
+
+function restore() {
+  for (const page of candidates) {
+    if (page.revisionInstruction?.trim()) notes.set(page.id, page.revisionInstruction);
   }
-  function decode2(raw) {
-    const code3 = raw.trim();
-    if (code3.length > 250000)
-      throw new Error("Review feedback exceeds supported size");
-    const [header, ...lines] = code3.split(`
-`);
-    const trailer = lines.length ? `
-${lines.join(`
-`)}` : "";
-    const match = /^CR2\.([A-Za-z0-9_-]+)\.([a-f0-9]{8})$/.exec(header);
-    if (!match || checksum(`CR2.${match[1]}` + trailer) !== match[2])
-      throw new Error("Review feedback is damaged or incomplete; copy the full code again");
-    let bits = 0, carry = 0;
-    const bytes = [];
-    for (const char of match[1]) {
-      carry = carry << 6 | alphabet.indexOf(char);
-      bits += 6;
-      if (bits >= 8) {
-        bits -= 8;
-        bytes.push(carry >>> bits & 255);
+  try {
+    const saved = JSON.parse(localStorage.getItem(storageKey) || '{}');
+    language = saved.language === 'en' ? 'en' : 'zh';
+    document.body.classList.toggle('dark', saved.dark === true);
+    for (const page of candidates) {
+      const entry = saved.pages?.[page.id];
+      if (entry?.version !== page.readVersion) continue;
+      if (entry.read === true) read.add(page.id);
+      if (typeof entry.note === 'string') {
+        if (entry.note.trim()) notes.set(page.id, entry.note);
+        else notes.delete(page.id);
       }
     }
-    const headerValue = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(new Uint8Array(bytes)));
-    const value = validate({ ...headerValue, repairs: lines.map((line) => {
-      const row = JSON.parse(line);
-      if (!Array.isArray(row) || row.length !== 2)
-        throw new Error("Invalid revision instruction line");
-      return { index: row[0], instruction: row[1] };
-    }) });
-    if (encode(value) !== code3)
-      throw new Error("Noncanonical review feedback encoding");
-    return value;
-  }
-  return { encode, decode: decode2 };
+  } catch { /* The report remains usable when local storage is unavailable. */ }
 }
 
-// src/project/reviewSiteClient.ts
-var REVIEW_SITE_CLIENT = String.raw`
-const $=id=>document.getElementById(id);
-let language=(navigator.languages?.[0]||navigator.language||'en').startsWith('zh')?'zh':'en';
-const words={approvedContext:['已入库正文，供核对目录；本轮无需再次审核。','Approved content shown for navigation review; no new approval required.'],newRoots:['新增一级目录','New top-level categories'],ackRoots:['我已知晓本次新增一级目录','I acknowledge the new top-level categories'],home:['待审核内容','Pages to review'],unchanged:['本次未变更内容略。','Unchanged content omitted.'],previous:['查看旧文本','Previous text'],removed:['移除或替换的旧内容','Removed or replaced content'],removedNav:['移除的目录条目','Removed navigation entries'],unplaced:['待落位文章','Unplaced articles'],approve:['批准这篇','Approve page'],reject:['拒绝这篇','Reject page'],revise:['修订','Revise'],approved:['已批准','Approved'],rejected:['已拒绝','Rejected'],revised:['已修订','Revision requested'],cancel:['取消','Cancel'],copy:['复制审核码','Copy review code'],allApprove:['全部批准','Approve all'],allReject:['全部拒绝','Reject all'],note:['输入修订意见','Enter revision instructions'],guide:['逐篇阅读并批准或拒绝后，复制审核码回复给 Agent。需要修改的文章请填写修订意见。','Read each page, approve or reject, then copy the review code back to your Agent. Enter instructions for pages needing revision.'],known:['知道了','Got it'],close:['关闭','Close'],notReviewed:['尚未完成审核','Not yet reviewed'],confirmAll:['建议逐篇阅读并确认。除非已读完所有待审核文章，否则请勿一次性全部批准。已有拒绝和修订意见将保留。','Read and confirm each page. Approve all only after reading every pending page. Existing rejections and revisions are preserved.'],confirm:['已阅读，全部批准','Read all, approve'],copied:['审核码已复制','Review code copied'],failed:['复制失败，请手动复制下方完整内容','Copy failed. Copy the complete text below manually.'],instructions:['请回到和 Agent 的会话窗口粘贴已复制内容进行回复即可继续~','Return to your conversation with the Agent and reply with the copied content to continue.'],long:['超过 1000 字符，飞书表单可能不接受。飞书场景下建议 @Bot 后粘贴回复。','Over 1,000 characters: a Feishu form may reject it. Mention @Bot and paste it in a reply instead.'],files:['预期工作区变化','Expected workspace changes'],navigate:['目录与文章','Directories and articles'],pendingNew:['未审批的新增文章','Pending new pages'],pendingModify:['未审批的修改文章','Pending modified pages'],processed:['已经审核和修订的文章','Reviewed or revision requested'],noSelection:['请先选择审核结果或填写修订意见','Select a decision or enter revision instructions first'],baseline:['无 Git 导航基线，目录沿用当前工作区；未推断历史目录变化。','No Git navigation baseline. Current navigation is shown without inferred historic changes.'],placement:['待落位文章不是新的站点栏目；请先按既有分类完成导航规划。','Unplaced articles are not a new site category. Finish their placement in the existing navigation first.']};
-const t=k=>words[k]?.[language==='zh'?0:1]||k;
-const escape=s=>String(s).replace(/[&<>"']/g,c=>({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
-const decisions=new Map(),notes=new Map(),expanded=new Set();let selected=null,active=null;
-const candidates=DATA.pages.filter(p=>p.candidate_id),ordered=[...candidates].sort((a,b)=>a.candidate_id<b.candidate_id?-1:1);
-for(const p of candidates)if(p.revisionInstruction){decisions.set(p.candidate_id,'revised');notes.set(p.candidate_id,p.revisionInstruction)}
-const badge=change=>change==='unchanged'?'':'<span class="badge '+change+'">'+(change==='new'?'New':change==='modify'?'Modify':change==='removed'?'Remove':t(change))+'</span>';
-const state=p=>decisions.get(p.candidate_id)||'pending';
-function descendants(key,seen=new Set()){if(seen.has(key))return[];seen.add(key);return DATA.nodes.filter(n=>n.parent===key).flatMap(n=>[n,...descendants(n.key,seen)])}
-function nodeChange(n){if(n.removed)return 'removed';const changes=[n.change,...[n,...descendants(n.key)].flatMap(v=>{const p=DATA.pages.find(p=>p.id===v.page);return p?[p.change]:[]}),...descendants(n.key).map(v=>v.change)];return descendants(n.key).some(v=>v.removed)||changes.includes('modify')?'modify':changes.includes('new')?'new':'unchanged'}
-function nodeTitle(n){return n.key==='review-unplaced'?t('unplaced'):n.title}
-function nodeLabel(n){return (n.removed?'<del>':'')+escape(nodeTitle(n))+(n.removed?'</del>':'')+(n.oldTitle?'<small class="old-title"> ← '+escape(n.oldTitle)+'</small>':'')}
-function totals(){const result={new:0,modify:0,approved:0,rejected:0,revised:0,pending:0};for(const p of candidates){const s=state(p);result[s]++;if(s==='pending')result[p.change==='new'?'new':'modify']++}return result}
-function updateCounts(){const c=totals();$('counts').textContent=c.new+' New / '+c.modify+' Modify / '+(c.approved+c.rejected+c.revised)+' Confirm';$('counter-pop').innerHTML='<div class="counter-grid"><div><b>'+c.new+'</b>'+t('pendingNew')+'</div><div><b>'+c.modify+'</b>'+t('pendingModify')+'</div></div><p>'+t('processed')+': '+(c.approved+c.rejected+c.revised)+'</p><small>'+t('approved')+' '+c.approved+' · '+t('rejected')+' '+c.rejected+' · '+t('revised')+' '+c.revised+'</small>'}
-function button(n,depth){const change=nodeChange(n),page=DATA.pages.find(p=>p.id===n.page);return '<button data-node="'+escape(n.key)+'" class="node '+(DATA.nodes.some(c=>c.parent===n.key)?'directory ':'')+change+(selected===n.page?' selected':'')+'" style="padding-left:'+(26+14*depth)+'px">'+nodeLabel(n)+badge(change)+(page&&page.candidate_id&&state(page)!=='pending'?badge(state(page)):'')+(DATA.nodes.some(c=>c.parent===n.key)?'<span class="caret">›</span>':'')+'</button>'}
-function renderNav(){const roots=DATA.nodes.filter(n=>!n.parent).sort((a,b)=>a.order-b.order);$('top').innerHTML=roots.map(n=>'<button data-root="'+escape(n.key)+'" class="'+nodeChange(n)+(active===n.key?' active':'')+'">'+nodeLabel(n)+badge(nodeChange(n))+'</button>').join('');let html='';function walk(key,depth,seen=new Set()){if(seen.has(key))return;seen.add(key);for(const n of DATA.nodes.filter(n=>n.parent===key).sort((a,b)=>a.order-b.order)){html+=button(n,depth);if(expanded.has(n.key)||n.page===selected||descendants(n.key).some(d=>d.page===selected))walk(n.key,depth+1,seen)}}if(active)walk(active,0);else html=roots.map(n=>button(n,0)).join('');$('tree').innerHTML=html}
-function rootFor(page){let node=DATA.nodes.find(n=>n.page===page);const seen=new Set();while(node?.parent&&!seen.has(node.key)){seen.add(node.key);node=DATA.nodes.find(n=>n.key===node.parent)}return node?.key||null}
-function showPage(id){selected=id;active=rootFor(id)||active;render()}
-function localizeBody(){document.querySelectorAll('[data-label]').forEach(el=>{el.textContent=t(el.dataset.label)})}
-function workspaceTree(){const tree={};for(const p of candidates){let node=tree;for(const part of ('knowledge/'+p.path).split('/'))node=node[part]??=( {} );node.$page=p}function lines(node,level=0){return Object.entries(node).filter(([k])=>k!=='$page').sort(([a],[b])=>a.localeCompare(b)).map(([k,v])=>'<div style="padding-left:'+level*18+'px">'+(v.$page?'<button data-page="'+escape(v.$page.id)+'">'+escape(k)+'</button>'+badge(v.$page.change)+(state(v.$page)!=='pending'?badge(state(v.$page)):''):escape(k)+'/')+'</div>'+lines(v,level+1)).join('')}return '<div class="workspace-tree">'+lines(tree)+'</div>'}
-function renderHome(){const c=totals();$('article').innerHTML='<h1>'+t('home')+'</h1><p class="stats">'+candidates.length+' '+(language==='zh'?'篇候选正文':'candidate pages')+' · '+c.approved+' '+t('approved')+' '+badge('new')+' '+badge('modify')+' '+badge('removed')+'</p>'+(DATA.navigationBaseline==='current'?'<p class="note">'+t('baseline')+'</p>':'')+(DATA.nodes.some(n=>n.key==='review-unplaced')?'<p class="note">'+t('placement')+'</p>':'')+'<h2>'+t('navigate')+'</h2>'+DATA.nodes.filter(n=>!n.parent).map(n=>{const ids=new Set([n,...descendants(n.key)].map(x=>x.page));const pages=candidates.filter(p=>ids.has(p.id));return pages.length?'<section class="home-group"><h3>'+nodeLabel(n)+badge(nodeChange(n))+'</h3><div class="cards">'+pages.map(p=>'<button data-page="'+escape(p.id)+'">'+escape(p.title)+badge(p.change)+(state(p)!=='pending'?badge(state(p)):'')+'</button>').join('')+'</div></section>':''}).join('')+(DATA.nodes.some(n=>n.removed)?'<h2>'+t('removedNav')+'</h2><ul>'+DATA.nodes.filter(n=>n.removed).map(n=>'<li class="removed">'+nodeLabel(n)+badge('removed')+'</li>').join('')+'</ul>':'')+'<h2>'+t('files')+'</h2>'+workspaceTree()}
-function controls(){const p=DATA.pages.find(p=>p.id===selected),s=p?state(p):'pending';$('footer').hidden=!p?.candidate_id;if(!p?.candidate_id)return;$('revision-note').value=notes.get(p.candidate_id)||'';$('revision-note').placeholder=t('note');$('revision-note').disabled=s==='approved'||s==='rejected';for(const [id,v,label]of[['revise-btn','revised','revise'],['reject-btn','rejected','reject'],['approve-btn','approved','approve']]){const b=$(id);b.disabled=s!=='pending'&&s!==v;b.className='btn '+(s===v?'chosen':v==='approved'?'primary':'');b.innerHTML=s===v?'<span class="normal">'+t(v)+'</span><span class="hover-label">'+t('cancel')+'</span>':t(label);b.title=s===v?t('cancel'):''}}
-function render(){document.body.classList.toggle('home',selected===null);$('article').classList.toggle('review-new-page',DATA.pages.some(p=>p.id===selected&&p.change==='new'));renderNav();updateCounts();if(selected===null)renderHome();else{const p=DATA.pages.find(p=>p.id===selected);$('article').innerHTML=p?'<h1>'+escape(p.title)+badge(p.change)+(p.candidate_id&&state(p)!=='pending'?badge(state(p)):'')+'</h1>'+(p.previousPath?'<p class="note">'+escape(p.previousPath)+' → '+escape(p.path)+'</p>':'')+(p.candidate_id?p.html:p.html?'<p class="note">'+t('approvedContext')+'</p>'+p.html:'<div class="review-omitted">'+t('unchanged')+'</div>')+(p.sources.length?'<details><summary>'+(language==='zh'?'来源引用':'Sources')+'</summary><ul>'+p.sources.map(s=>'<li>'+escape(s)+'</li>').join('')+'</ul></details>':''):''}controls();localizeBody();globalThis.contextDiagramViewer?.render($('article'),{dark:document.body.classList.contains('dark'),language})}
-function setDecision(id,value){const current=decisions.get(id);if(current===value){decisions.delete(id);notes.delete(id)}else if(!current){if(value==='revised'){$('revision-note').focus();return}decisions.set(id,value)}render()}
-function setAllDecision(value){for(const p of candidates)if(!decisions.has(p.candidate_id))decisions.set(p.candidate_id,value);render()}
-function payloadText(){const statuses=ordered.map(p=>state(p));return feedbackCodec.encode({scope:SCOPE.label,idsHash:SCOPE.ids_sha256,contentHash:SCOPE.candidates_sha256,baselineHash:DATA.baselineHash,statuses,repairs:ordered.flatMap((p,index)=>state(p)==='revised'?[{index,instruction:notes.get(p.candidate_id)}]:[])})}
-async function copyPayload(){dismissGuide();const c=totals();$('copy-warning').textContent='';$('payload').value='';if(c.pending===candidates.length){$('copy-title').textContent=t('noSelection');$('payload').value=''}else{try{const text=payloadText();$('payload').value=text;await navigator.clipboard.writeText(text);$('copy-title').textContent=t('copied')}catch(e){$('copy-title').textContent=t('failed');if(!$('payload').value)$('payload').value=String(e.message)}}$('copy-summary').textContent=t('approved')+' '+c.approved+' · '+t('rejected')+' '+c.rejected+' · '+t('revised')+' '+c.revised+' · '+t('notReviewed')+' '+c.pending;$('copy-instructions').textContent=t('instructions');$('copy-warning').textContent=Array.from($('payload').value).length>1000?t('long'):'';$('copy-dialog').showModal()}
-let guideTimer;function dismissGuide(){clearInterval(guideTimer);$('copy-guide').hidden=true}
-function labels(){$('all-approved').textContent=t('allApprove');$('all-rejected').textContent=t('allReject');$('payload-open').textContent=t('copy');$('guide-text').textContent=t('guide');$('guide-close').textContent=t('known');$('bulk-title').textContent=t('allApprove');$('bulk-message').textContent=t('confirmAll');$('bulk-cancel').textContent=t('cancel');$('bulk-confirm').textContent=t('confirm');$('payload-close').textContent=t('close');$('language').textContent=language==='zh'?'EN':'中文'}
-document.addEventListener('click',e=>{const b=e.target.closest('button');if(!b)return;if(b.dataset.page){showPage(b.dataset.page);window.scrollTo(0,0)}if(b.dataset.root){active=b.dataset.root;const n=DATA.nodes.find(n=>n.key===active);selected=n?.page||[...descendants(active)].find(d=>d.page)?.page||null;render()}if(b.dataset.node){const n=DATA.nodes.find(n=>n.key===b.dataset.node);if(n.page)showPage(n.page);else{expanded.has(n.key)?expanded.delete(n.key):expanded.add(n.key);renderNav()}}});
-$('home').onclick=()=>{selected=null;active=null;render();window.scrollTo(0,0)};
-$('revision-note').oninput=e=>{const p=DATA.pages.find(p=>p.id===selected);if(!p?.candidate_id)return;const value=e.target.value;notes.set(p.candidate_id,value);if(value.trim())decisions.set(p.candidate_id,'revised');else decisions.delete(p.candidate_id);controls();renderNav();updateCounts();$('article').querySelectorAll('h1 > .approved,h1 > .revised,h1 > .rejected').forEach(e=>e.remove());$('article').querySelector('h1')?.insertAdjacentHTML('beforeend',value.trim()?badge('revised'):'')};
-for(const [id,value]of[['revise-btn','revised'],['reject-btn','rejected'],['approve-btn','approved']])$(id).onclick=()=>{const p=DATA.pages.find(p=>p.id===selected);if(p?.candidate_id)setDecision(p.candidate_id,value)};
-const addedRoots=DATA.nodes.filter(n=>!n.parent&&n.change==='new'&&!n.removed&&n.key!=='review-unplaced');
-let bulkTimer,bulkDeadline=0;
-function updateBulkConfirmation(){const remaining=addedRoots.length?Math.max(0,Math.ceil((bulkDeadline-Date.now())/1000)):0;$('bulk-confirm').disabled=addedRoots.length>0&&(!$('bulk-ack').checked||remaining>0);$('bulk-confirm').textContent=t('confirm')+(remaining?' ('+remaining+'s)':'');return remaining}
-function openBulkConfirmation(){clearInterval(bulkTimer);$('bulk-ack').checked=false;$('bulk-roots').hidden=!addedRoots.length;$('bulk-roots-title').textContent=t('newRoots');$('bulk-roots-list').innerHTML=addedRoots.map(n=>'<li>'+escape(nodeTitle(n))+'</li>').join('');$('bulk-ack-label').textContent=t('ackRoots');bulkDeadline=Date.now()+8000;updateBulkConfirmation();$('bulk-dialog').showModal();if(addedRoots.length)bulkTimer=setInterval(()=>{if(!updateBulkConfirmation())clearInterval(bulkTimer)},200)}
-$('bulk-ack').onchange=updateBulkConfirmation;
-$('bulk-dialog').onclose=()=>clearInterval(bulkTimer);
-$('all-approved').onclick=openBulkConfirmation;$('bulk-confirm').onclick=()=>{updateBulkConfirmation();if(!$('bulk-dialog').open||$('bulk-confirm').disabled)return;setAllDecision('approved');clearInterval(bulkTimer);$('bulk-dialog').close()};$('bulk-cancel').onclick=()=>{clearInterval(bulkTimer);$('bulk-dialog').close()};$('all-rejected').onclick=()=>setAllDecision('rejected');$('payload-open').onclick=copyPayload;$('payload-close').onclick=()=>$('copy-dialog').close();$('guide-close').onclick=dismissGuide;$('theme').onclick=()=>{document.body.classList.toggle('dark');globalThis.contextDiagramViewer?.render($('article'),{dark:document.body.classList.contains('dark'),language})};$('language').onclick=()=>{language=language==='zh'?'en':'zh';labels();render()};
-labels();render();const deadline=Date.now()+10000;guideTimer=setInterval(()=>{const left=Math.max(0,Math.ceil((deadline-Date.now())/1000));$('guide-countdown').textContent=left+'s';if(!left)dismissGuide()},250);
+function persist() {
+  try {
+    localStorage.setItem(storageKey, JSON.stringify({
+      language, dark: document.body.classList.contains('dark'),
+      pages: Object.fromEntries(candidates.map(page => [page.id, {
+        version: page.readVersion, read: read.has(page.id), note: notes.get(page.id) || '',
+      }])),
+    }));
+  } catch { /* Reading and copying still work without storage access. */ }
+}
+
+function revisedPages() { return candidates.filter(page => (notes.get(page.id) || '').trim()); }
+function countText(label, count) { return \`\${label} <b>\${count}</b>\${language === 'zh' ? ' 篇' : ''}\`; }
+function badges(page) {
+  if (!page?.candidate_id) return '';
+  return (read.has(page.id) ? '<span class="badge read">READ</span>' : '')
+    + ((notes.get(page.id) || '').trim() ? \`<span class="badge has-feedback">\${t('feedbackTag')}</span>\` : '');
+}
+function badge(change) {
+  if (!change || change === 'unchanged') return '';
+  const label = { new: 'New', modify: 'Modify', removed: 'Remove' }[change] || change;
+  return \`<span class="badge \${escape(change)}">\${escape(label)}</span>\`;
+}
+function descendants(key, seen = new Set()) {
+  if (seen.has(key)) return [];
+  seen.add(key);
+  return DATA.nodes.filter(node => node.parent === key).flatMap(node => [node, ...descendants(node.key, seen)]);
+}
+function nodeChange(node) {
+  if (node.removed) return 'removed';
+  const nested = descendants(node.key);
+  const changes = [node.change, ...nested.map(child => child.change),
+    ...[node, ...nested].map(child => pagesById.get(child.page)?.change)];
+  return nested.some(child => child.removed) || changes.includes('modify') ? 'modify' : changes.includes('new') ? 'new' : 'unchanged';
+}
+function nodeTitle(node) { return node.key === 'review-unplaced' ? t('unplaced') : node.title; }
+function nodeLabel(node) {
+  const title = escape(nodeTitle(node));
+  return (node.removed ? \`<del>\${title}</del>\` : title)
+    + (node.oldTitle ? \`<small class="old-title"> ← \${escape(node.oldTitle)}</small>\` : '');
+}
+function rootFor(pageId) {
+  let node = DATA.nodes.find(item => item.page === pageId);
+  const seen = new Set();
+  while (node?.parent && !seen.has(node.key)) { seen.add(node.key); node = DATA.nodes.find(item => item.key === node.parent); }
+  return node?.key || null;
+}
+
+function updateCounts() {
+  const revised = revisedPages().length;
+  $('counts').innerHTML = \`<span>\${countText(t('read'), read.size)}</span><span class="separator">/</span>\`
+    + \`<button id="revisions-link" class="\${revised ? 'has-notes' : ''}" aria-pressed="\${view === 'revisions'}">\${countText(t('revisions'), revised)}</button>\`
+    + \`<span class="separator">/</span><span>\${countText(t('total'), candidates.length)}</span>\`;
+  $('revisions-link').onclick = () => { view = 'revisions'; selected = null; location.hash = 'revisions'; render(); window.scrollTo(0, 0); };
+  $('read-fill').style.width = (candidates.length ? read.size / candidates.length * 100 : 0) + '%';
+  const track = document.querySelector('.read-track');
+  track.setAttribute('aria-valuenow', String(read.size));
+  track.setAttribute('aria-valuemax', String(candidates.length));
+}
+
+function renderNav() {
+  const roots = DATA.nodes.filter(node => !node.parent).sort((a, b) => a.order - b.order);
+  $('top').innerHTML = roots.map(node => \`<button data-root="\${escape(node.key)}" class="\${nodeChange(node)}\${active === node.key ? ' active' : ''}">\${nodeLabel(node)}</button>\`).join('');
+  function nodeButton(node, depth) {
+    const page = pagesById.get(node.page);
+    const isDirectory = DATA.nodes.some(child => child.parent === node.key);
+    return \`<button data-node="\${escape(node.key)}" title="\${escape(nodeTitle(node))}" class="node \${isDirectory ? 'directory ' : ''}\${nodeChange(node)}\${selected === node.page ? ' selected' : ''}" style="padding-left:\${26 + 14 * depth}px">\`
+      + \`<span class="node-content"><span class="node-title">\${nodeLabel(node)}</span>\`
+      + \`<span class="node-status">\${badges(page)}</span>\${isDirectory ? '<span class="caret">›</span>' : ''}</span></button>\`;
+  }
+  let content = '';
+  function walk(key, depth, seen = new Set()) {
+    if (seen.has(key)) return;
+    seen.add(key);
+    for (const node of DATA.nodes.filter(item => item.parent === key).sort((a, b) => a.order - b.order)) {
+      content += nodeButton(node, depth);
+      if (expanded.has(node.key) || node.page === selected || descendants(node.key).some(child => child.page === selected)) walk(node.key, depth + 1, seen);
+    }
+  }
+  if (active) walk(active, 0);
+  else content = roots.map(node => nodeButton(node, 0)).join('');
+  $('tree').innerHTML = content;
+}
+
+function workspaceTree() {
+  const root = {};
+  for (const page of candidates) {
+    let node = root;
+    for (const part of ('knowledge/' + page.path).split('/')) node = node[part] ??= {};
+    node.$page = page;
+  }
+  function lines(node, depth = 0) {
+    return Object.entries(node).filter(([key]) => key !== '$page').sort(([a], [b]) => a.localeCompare(b)).map(([key, child]) => {
+      const label = child.$page ? \`<button data-page="\${escape(child.$page.id)}">\${escape(key)}</button>\${badge(child.$page.change)}\${badges(child.$page)}\` : escape(key) + '/';
+      return \`<div style="padding-left:\${depth * 18}px">\${label}</div>\${lines(child, depth + 1)}\`;
+    }).join('');
+  }
+  return \`<div class="workspace-tree">\${lines(root)}</div>\`;
+}
+
+function renderHome() {
+  $('article').innerHTML = \`<h1>\${t('home')}</h1><p class="stats">\${t('homeHint')}</p>\`
+    + (DATA.navigationBaseline === 'current' ? \`<p class="note">\${t('baseline')}</p>\` : '')
+    + \`<h2>\${t('navigate')}</h2>\`
+    + DATA.nodes.filter(node => !node.parent).map(node => {
+      const ids = new Set([node, ...descendants(node.key)].map(item => item.page));
+      const pages = candidates.filter(page => ids.has(page.id));
+      if (!pages.length) return '';
+      return \`<section class="home-group"><h3>\${nodeLabel(node)}\${badge(nodeChange(node))}</h3><div class="cards">\`
+        + pages.map(page => \`<button data-page="\${escape(page.id)}">\${escape(page.title)}\${badge(page.change)}<span data-status-for="\${escape(page.id)}">\${badges(page)}</span></button>\`).join('') + '</div></section>';
+    }).join('')
+    + (DATA.nodes.some(node => node.removed) ? \`<h2>\${t('removedNav')}</h2><ul>\${DATA.nodes.filter(node => node.removed).map(node => \`<li class="removed">\${nodeLabel(node)}</li>\`).join('')}</ul>\` : '')
+    + \`<h2>\${t('files')}</h2>\${workspaceTree()}\`;
+}
+
+function renderRevisions() {
+  const pages = revisedPages();
+  $('article').innerHTML = \`<h1>\${t('revisionTitle')} <span class="revision-count">· \${pages.length}</span></h1><p class="stats">\${t('revisionHint')}</p>\`
+    + (pages.length ? pages.map(page => \`<section class="revision-card"><h2><button class="revision-title" data-page="\${escape(page.id)}">\${escape(page.title)}<span class="arrow" aria-hidden="true">↗</span></button></h2>\`
+      + \`<p class="revision-path">\${escape(page.path)}</p><p class="revision-body">\${escape(notes.get(page.id))}</p></section>\`).join('')
+      : \`<div class="empty-notes">\${t('empty')}<br><span class="note">\${t('emptyHint')}</span></div>\`);
+}
+
+function resizeInput() {
+  const input = $('revision-note');
+  input.style.height = '42px';
+  input.style.height = Math.min(112, Math.max(42, input.scrollHeight + 2)) + 'px';
+}
+
+function render() {
+  document.documentElement.lang = language === 'zh' ? 'zh-CN' : 'en';
+  document.body.classList.toggle('home', view === 'home');
+  document.body.classList.toggle('revision-index', view === 'revisions');
+  const page = pagesById.get(selected);
+  $('article').classList.toggle('review-new-page', view === 'article' && page?.change === 'new');
+  renderNav();
+  updateCounts();
+  if (view === 'home') renderHome();
+  else if (view === 'revisions') renderRevisions();
+  else if (page) {
+    $('article').innerHTML = \`<h1>\${escape(page.title)}\${badge(page.change)}<span id="article-status">\${badges(page)}</span></h1>\`
+      + (page.previousPath ? \`<p class="note">\${escape(page.previousPath)} → \${escape(page.path)}</p>\` : '')
+      + (page.candidate_id ? page.html : page.html ? \`<p class="note">\${t('approvedContext')}</p>\${page.html}\` : \`<div class="review-omitted">\${t('unchanged')}</div>\`)
+      + (page.sources.length ? \`<details><summary>\${t('sources')}</summary><ul>\${page.sources.map(source => \`<li>\${escape(source)}</li>\`).join('')}</ul></details>\` : '');
+  }
+  document.querySelectorAll('[data-label]').forEach(element => { element.textContent = t(element.dataset.label); });
+  $('footer').hidden = !(view === 'article' && page?.candidate_id);
+  $('revision-note').value = page ? notes.get(page.id) || '' : '';
+  $('revision-note').placeholder = t('note');
+  $('clear-note').textContent = t('clear');
+  $('clear-note').disabled = !page || !(notes.get(page.id) || '').trim();
+  $('copy-notes').textContent = t('copy');
+  $('copy-close').textContent = t('close');
+  $('language').textContent = language === 'zh' ? 'EN' : '中文';
+  if (!$('footer').hidden) resizeInput();
+  globalThis.contextDiagramViewer?.render($('article'), { dark: document.body.classList.contains('dark'), language });
+}
+
+function showPage(id, updateHash = true) {
+  const page = pagesById.get(id);
+  if (!page) return;
+  selected = id;
+  active = rootFor(id) || active;
+  view = 'article';
+  if (page.candidate_id) { read.add(page.id); persist(); }
+  if (updateHash) history.replaceState(null, '', '#article=' + encodeURIComponent(id));
+  render();
+  window.scrollTo(0, 0);
+  const currentNode = $('tree').querySelector('.selected');
+  if (currentNode) $('tree').scrollTop = Math.max(0, currentNode.offsetTop - $('tree').offsetTop - $('tree').clientHeight / 3);
+}
+
+function showToast(message) {
+  clearTimeout(toastTimer);
+  $('toast').textContent = message;
+  $('toast').hidden = false;
+  toastTimer = setTimeout(() => { $('toast').hidden = true; }, 3000);
+}
+
+function feedbackText() {
+  return t('revisionTitle') + '\\n\\n' + revisedPages().map(page =>
+    \`《\${page.title}》\\n\${language === 'zh' ? '文章 ID' : 'Article ID'}：\${page.id}\\n\${language === 'zh' ? '修订意见' : 'Revision notes'}：\${notes.get(page.id)}\`
+  ).join('\\n\\n');
+}
+
+async function copyNotes() {
+  if (!revisedPages().length) { showToast(t('emptyCopy')); return; }
+  const text = feedbackText();
+  try {
+    if (!navigator.clipboard?.writeText) throw new Error('Clipboard unavailable');
+    await navigator.clipboard.writeText(text);
+    showCopyDialog(text, true);
+  } catch {
+    showCopyDialog(text, false);
+  }
+}
+
+function showCopyDialog(text, copied) {
+  clearInterval(copyTimer);
+  $('copy-title').textContent = copied ? (language === 'zh' ? '✓ 已复制修订意见' : '✓ Revision notes copied') : t('manualCopy');
+  $('copy-title').classList.toggle('copy-success', copied);
+  $('copy-summary').textContent = copied ? (language === 'zh' ? '可返回会话粘贴以下修订意见。' : 'Paste these revision notes into the conversation.') : t('manualHint');
+  $('copy-preview').hidden = !copied;
+  $('copy-preview').classList.remove('has-overflow');
+  $('copy-preview-text').textContent = text;
+  $('copied-notes').hidden = copied;
+  $('copied-notes').value = text;
+  $('copy-close').parentElement.hidden = copied;
+  $('copy-countdown').hidden = !copied;
+  $('copy-countdown').textContent = language === 'zh' ? '5 秒后关闭' : 'Closes in 5s';
+  if (!$('copy-dialog').open) $('copy-dialog').showModal();
+  if (!copied) {
+    $('copied-notes').focus();
+    $('copied-notes').select();
+    return;
+  }
+  const preview = $('copy-preview');
+  preview.classList.toggle('has-overflow', preview.scrollHeight > preview.clientHeight);
+  const deadline = performance.now() + 5000;
+  copyTimer = setInterval(() => {
+    const remaining = Math.max(0, Math.ceil((deadline - performance.now()) / 1000));
+    $('copy-countdown').textContent = language === 'zh' ? \`\${remaining} 秒后关闭\` : \`Closes in \${remaining}s\`;
+    if (!remaining) { clearInterval(copyTimer); $('copy-dialog').close(); }
+  }, 100);
+}
+
+document.addEventListener('click', event => {
+  const button = event.target.closest('button');
+  if (!button) return;
+  if (button.dataset.page) showPage(button.dataset.page);
+  else if (button.dataset.root) {
+    active = button.dataset.root;
+    const node = DATA.nodes.find(item => item.key === active);
+    const children = descendants(active);
+    const preferred = candidates.find(page => [node, ...children].some(item => item?.page === page.id));
+    const pageId = preferred?.id || node?.page || children.find(child => child.page)?.page;
+    if (pageId) showPage(pageId);
+    else render();
+  } else if (button.dataset.node) {
+    const node = DATA.nodes.find(item => item.key === button.dataset.node);
+    if (node.page) showPage(node.page);
+    else { expanded.has(node.key) ? expanded.delete(node.key) : expanded.add(node.key); renderNav(); }
+  }
+});
+
+$('revision-note').addEventListener('input', event => {
+  const page = pagesById.get(selected);
+  if (!page?.candidate_id) return;
+  const value = event.target.value;
+  if (value.trim()) notes.set(page.id, value);
+  else notes.delete(page.id);
+  $('clear-note').disabled = !value.trim();
+  persist();
+  updateCounts();
+  renderNav();
+  $('article-status').innerHTML = badges(page);
+  resizeInput();
+});
+$('clear-note').onclick = () => {
+  notes.delete(selected);
+  persist();
+  $('revision-note').value = '';
+  $('revision-note').dispatchEvent(new Event('input', { bubbles: true }));
+  $('revision-note').focus();
+};
+$('home').onclick = () => { selected = null; active = null; view = 'home'; history.replaceState(null, '', location.pathname + location.search); render(); window.scrollTo(0, 0); };
+$('theme').onclick = () => { document.body.classList.toggle('dark'); persist(); render(); };
+$('language').onclick = () => { language = language === 'zh' ? 'en' : 'zh'; persist(); render(); };
+$('copy-notes').onclick = copyNotes;
+$('copy-close').onclick = () => $('copy-dialog').close();
+$('copy-dialog').onclose = () => clearInterval(copyTimer);
+window.addEventListener('hashchange', () => {
+  if (location.hash.startsWith('#article=')) showPage(decodeURIComponent(location.hash.slice(9)), false);
+  else { selected = null; view = location.hash === '#revisions' ? 'revisions' : 'home'; render(); }
+});
+new ResizeObserver(() => { document.documentElement.style.setProperty('--header-height', document.querySelector('header').offsetHeight + 'px'); }).observe(document.querySelector('header'));
+restore();
+if (location.hash.startsWith('#article=')) showPage(decodeURIComponent(location.hash.slice(9)), false);
+else { if (location.hash === '#revisions') view = 'revisions'; render(); }
 `;
 
 // src/project/reviewSiteStyles.ts
 init_diagramStyles();
 var REVIEW_SITE_STYLES = String.raw`
-:root{--blue:#2563eb;--text:#161e2e;--muted:#646b7c;--line:#e7e9ef;--bg:#fff;--side:#f8f9fc;--green:#28734f;--red:#b7444c;--amber:#93651d}*{box-sizing:border-box}body{margin:0;color:var(--text);background:var(--bg);font:14px/1.75 -apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",sans-serif}button,input,textarea{font:inherit}button{cursor:pointer}button:disabled{opacity:.35;cursor:not-allowed}[hidden]{display:none!important}header{height:64px;padding:0 24px;display:flex;align-items:center;border-bottom:1px solid var(--line);position:sticky;top:0;background:var(--bg);z-index:5}#home{border:0;background:none;color:var(--text);width:280px;flex-shrink:0;text-align:left;font-size:15px;font-weight:650;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}nav{display:flex;flex:1;min-width:0;overflow:auto;align-self:stretch}nav button{border:0;background:none;color:var(--text);padding:0 16px;font-size:13px;font-weight:550;white-space:nowrap}nav .active{color:var(--blue);box-shadow:inset 0 -2px var(--blue)}.new,nav .new{color:var(--green)}.modify,nav .modify{color:var(--amber)}.badge{display:inline-block;margin-left:7px;padding:1px 6px;font-size:10px;line-height:18px;vertical-align:middle;border-radius:4px;font-weight:600;letter-spacing:0}.badge.new,.badge.approved{color:var(--green);background:color-mix(in srgb,var(--green) 10%,var(--bg))}.badge.modify,.badge.revised{color:var(--amber);background:color-mix(in srgb,var(--amber) 10%,var(--bg))}.badge.removed,.badge.rejected{color:var(--red);background:color-mix(in srgb,var(--red) 10%,var(--bg))}.removed,nav .removed,.node.removed{color:var(--red)}.badge{border:1px solid color-mix(in srgb,currentColor 18%,transparent)}.tools{display:flex;align-items:center;gap:8px;position:relative;margin-left:12px}.btn{border:1px solid var(--line);border-radius:6px;background:var(--bg);color:var(--text);padding:5px 10px;font-size:12px;line-height:22px;white-space:nowrap}.primary{color:var(--bg);background:var(--blue);border-color:var(--blue)}#theme,#language{margin-left:8px;flex-shrink:0}.counter{position:relative;padding:8px;white-space:nowrap;font-size:12px;font-weight:700;color:var(--blue)}.counter-pop{display:none;position:absolute;top:100%;right:0;min-width:320px;padding:15px;background:var(--bg);border:1px solid var(--line);border-radius:10px;box-shadow:0 8px 30px #17244220;color:var(--text);font-weight:400}.counter:hover .counter-pop,.counter:focus .counter-pop{display:block}.counter-grid{display:grid;grid-template-columns:1fr 1fr;gap:16px;font-size:11px}.counter-grid b{display:block;font-size:20px}.counter-pop p{border-top:1px solid var(--line);padding-top:10px}.layout{display:grid;grid-template-columns:280px minmax(0,1fr)}aside{height:calc(100vh - 64px);position:sticky;top:64px;overflow:auto;background:var(--side);border-right:1px solid var(--line);padding:12px 0 80px}.node{display:block;width:100%;text-align:left;border:0;background:none;height:38px;min-height:38px;padding:9px 16px 9px 26px;font-size:13px;font-weight:450;line-height:20px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;color:var(--muted)}.node.directory{color:var(--text)}.node.selected.unchanged{color:var(--blue);font-weight:550}.node.new{color:var(--green)}.node.modify{color:var(--amber)}.node.selected{background:color-mix(in srgb,var(--blue) 8%,transparent)}.caret{float:right}.node:hover{background:#8e96aa1a}main{min-width:0;padding:44px 60px 100px 36px}h1{font-size:36px;line-height:1.3;letter-spacing:-.025em;margin:0 0 28px}h2{font-size:25px;line-height:1.4;font-weight:650;margin:46px 0 22px;border-bottom:1px solid var(--line);padding-bottom:14px}h3{font-size:19px;font-weight:600;line-height:1.5;margin:30px 0 14px}article{font-size:16px;line-height:1.8}article>h1>.badge{margin-left:12px}article a{color:inherit}article a:hover{color:var(--blue)}article table{border-collapse:collapse;font-size:14px;display:block;overflow:auto}article th,article td{border:1px solid var(--line);padding:11px 14px}article th{background:var(--side)}pre{overflow:auto;background:var(--side);padding:16px}blockquote{padding:16px 20px;margin:24px 0;border-left:3px solid var(--context-accent);background:color-mix(in srgb,var(--blue) 8%,transparent);color:var(--muted)}.home .layout{display:block}.home aside{display:none}.home main{width:1120px;max-width:calc(100% - 280px);margin-left:280px;padding-top:32px}.home article{font-size:14px}.home h1{font-size:28px;margin-bottom:12px}.home h2{font-size:19px;margin:24px 0 12px;padding-bottom:10px}.home h3{font-size:15px;margin:16px 0 10px}.stats{font-size:12px;color:var(--muted)}.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(270px,1fr));gap:8px}.cards button{border:1px solid var(--line);border-radius:7px;background:var(--bg);color:var(--text);text-align:left;font-size:13px;line-height:20px;padding:10px 14px}.cards button:hover{border-color:var(--blue)}.review-unchanged-heading{color:var(--muted)}.review-omitted{margin:20px 0;padding:18px 20px;border:1px dashed var(--line);border-radius:8px;color:var(--muted);font-size:13px}.changed{position:relative;display:flow-root;color:var(--amber);padding:0 76px 0 0;margin:20px 0}.changed>.badge{position:absolute;right:0;top:4px}.changed>:nth-child(2){margin-top:0}.changed>:last-child{margin-bottom:0}.changed details{color:inherit}.changed.removed{color:var(--red)}.workspace-tree{font:12px/1.9 ui-monospace,monospace;border:1px solid var(--line);border-radius:8px;padding:16px;background:var(--side);overflow:auto}.workspace-tree button{border:0;background:none;color:var(--text);padding:0;font:inherit;white-space:nowrap}.note{font-size:12px;color:var(--muted)}footer{position:fixed;bottom:0;left:280px;right:0;background:var(--bg);border-top:1px solid var(--line);padding:12px 35px;display:flex;gap:10px;z-index:4}footer input{flex:1;min-width:0;border:0;outline:0;background:transparent;color:var(--text);font-size:14px;padding:8px 0}footer .btn{min-width:76px}.chosen{color:var(--blue);border-color:var(--blue);background:var(--bg)}.hover-label{display:none}.chosen:hover .normal{display:none}.chosen:hover .hover-label{display:inline}dialog{width:560px;max-width:90vw;background:var(--bg);color:var(--text);border:1px solid var(--line);border-radius:10px;padding:20px;font-size:13px;line-height:1.65}dialog::backdrop{background:#131b3255}dialog h2{font-size:17px;margin:0 0 12px;border:0;padding:0}dialog textarea{width:100%;height:130px;border:1px solid var(--line);border-radius:6px;padding:10px;font:11px/1.6 monospace;background:var(--side);color:var(--text)}#copy-warning{color:var(--amber)}.bulk-ack{display:flex;align-items:center;gap:8px;font-size:13px}.bulk-ack input{accent-color:var(--blue)}#bulk-roots-list{margin:8px 0 12px;padding-left:22px;color:var(--red)}.dialog-actions{display:flex;justify-content:flex-end;gap:8px;margin-top:18px}.guide{position:absolute;right:0;top:calc(100% + 18px);width:300px;background:var(--bg);border:1px solid var(--line);border-radius:10px;padding:15px;box-shadow:0 10px 35px #17244224;font-size:12px}.guide:before{content:'';position:absolute;top:-7px;right:42px;width:12px;height:12px;background:var(--bg);border-top:1px solid var(--line);border-left:1px solid var(--line);transform:rotate(45deg)}#guide-countdown{float:right;color:var(--muted);font-size:11px}.dark{--bg:#171b24;--side:#1b1d24;--text:#e2e4ed;--muted:#a1a6b7;--line:#303440;--blue:#8eb7ff;--green:#83c9a0;--amber:#dab779;--red:#e49a9e}@media(min-width:1600px){main,.home main{padding-left:52px}}@media(max-width:1279px){#home{width:220px}nav button{padding:0 9px}.tools{gap:4px}}@media(max-width:1050px){header{height:auto;flex-wrap:wrap;min-height:64px}nav{order:3;flex-basis:100%;height:44px}.tools{margin-left:auto}}@media(max-width:700px){.layout{display:block}aside{position:relative;top:0;height:200px}main,.home main{width:100%;max-width:100%;margin:0;padding:24px 20px 90px}footer{left:0;padding:10px;flex-wrap:wrap}footer input{flex-basis:100%}.tools{flex-wrap:wrap}h1{font-size:28px}}
+:root{--blue:#2563eb;--text:#161e2e;--muted:#646b7c;--line:#e7e9ef;--bg:#fff;--side:#f8f9fc;--green:#28734f;--red:#b7444c;--amber:#93651d}*{box-sizing:border-box}body{margin:0;color:var(--text);background:var(--bg);font:14px/1.75 -apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",sans-serif}button,input,textarea{font:inherit}button{cursor:pointer}button:disabled{opacity:.35;cursor:not-allowed}[hidden]{display:none!important}header{height:64px;padding:0 24px;display:flex;align-items:center;border-bottom:1px solid var(--line);position:sticky;top:0;background:var(--bg);z-index:5}#home{border:0;background:none;color:var(--text);width:280px;flex-shrink:0;text-align:left;font-size:15px;font-weight:650;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}nav{display:flex;flex:1;min-width:0;overflow:auto;align-self:stretch}nav button{border:0;background:none;color:var(--text);padding:0 16px;font-size:13px;font-weight:550;white-space:nowrap}nav .active{color:var(--blue);box-shadow:inset 0 -2px var(--blue)}.new,nav .new{color:var(--green)}.modify,nav .modify{color:var(--amber)}.badge{display:inline-block;margin-left:7px;padding:1px 6px;font-size:10px;line-height:18px;vertical-align:middle;border-radius:4px;font-weight:600;letter-spacing:0}.badge.new{color:var(--green);background:color-mix(in srgb,var(--green) 10%,var(--bg))}.badge.modify{color:var(--amber);background:color-mix(in srgb,var(--amber) 10%,var(--bg))}.badge.removed{color:var(--red);background:color-mix(in srgb,var(--red) 10%,var(--bg))}.removed,nav .removed,.node.removed{color:var(--red)}.badge{border:1px solid color-mix(in srgb,currentColor 18%,transparent)}.tools{display:flex;align-items:center;gap:8px;position:relative;margin-left:12px}.btn{border:1px solid var(--line);border-radius:6px;background:var(--bg);color:var(--text);padding:5px 10px;font-size:12px;line-height:22px;white-space:nowrap}.primary{color:var(--bg);background:var(--blue);border-color:var(--blue)}#theme,#language{margin-left:8px;flex-shrink:0}.layout{display:grid;grid-template-columns:280px minmax(0,1fr)}aside{height:calc(100vh - 64px);position:sticky;top:64px;overflow:auto;background:var(--side);border-right:1px solid var(--line);padding:12px 0 80px}.node{display:block;width:100%;text-align:left;border:0;background:none;height:38px;min-height:38px;padding:9px 16px 9px 26px;font-size:13px;font-weight:450;line-height:20px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;color:var(--muted)}.node.directory{color:var(--text)}.node.selected.unchanged{color:var(--blue);font-weight:550}.node.new{color:var(--green)}.node.modify{color:var(--amber)}.node.selected{background:color-mix(in srgb,var(--blue) 8%,transparent)}.caret{float:right}.node:hover{background:#8e96aa1a}main{min-width:0;padding:44px 60px 100px 36px}h1{font-size:36px;line-height:1.3;letter-spacing:-.025em;margin:0 0 28px}h2{font-size:25px;line-height:1.4;font-weight:650;margin:46px 0 22px;border-bottom:1px solid var(--line);padding-bottom:14px}h3{font-size:19px;font-weight:600;line-height:1.5;margin:30px 0 14px}article{font-size:16px;line-height:1.8}article>h1>.badge{margin-left:12px}article a{color:inherit}article a:hover{color:var(--blue)}article table{border-collapse:collapse;font-size:14px;display:block;overflow:auto}article th,article td{border:1px solid var(--line);padding:11px 14px}article th{background:var(--side)}pre{overflow:auto;background:var(--side);padding:16px}blockquote{padding:16px 20px;margin:24px 0;border-left:3px solid var(--context-accent);background:color-mix(in srgb,var(--blue) 8%,transparent);color:var(--muted)}.home .layout{display:block}.home aside{display:none}.home main{width:1120px;max-width:calc(100% - 280px);margin-left:280px;padding-top:32px}.home article{font-size:14px}.home h1{font-size:28px;margin-bottom:12px}.home h2{font-size:19px;margin:24px 0 12px;padding-bottom:10px}.home h3{font-size:15px;margin:16px 0 10px}.stats{font-size:12px;color:var(--muted)}.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(270px,1fr));gap:8px}.cards button{border:1px solid var(--line);border-radius:7px;background:var(--bg);color:var(--text);text-align:left;font-size:13px;line-height:20px;padding:10px 14px}.cards button:hover{border-color:var(--blue)}.review-unchanged-heading{color:var(--muted)}.review-omitted{margin:20px 0;padding:18px 20px;border:1px dashed var(--line);border-radius:8px;color:var(--muted);font-size:13px}.changed{position:relative;display:flow-root;color:var(--amber);padding:0 76px 0 0;margin:20px 0}.changed>.badge{position:absolute;right:0;top:4px}.changed>:nth-child(2){margin-top:0}.changed>:last-child{margin-bottom:0}.changed details{color:inherit}.changed.removed{color:var(--red)}.workspace-tree{font:12px/1.9 ui-monospace,monospace;border:1px solid var(--line);border-radius:8px;padding:16px;background:var(--side);overflow:auto}.workspace-tree button{border:0;background:none;color:var(--text);padding:0;font:inherit;white-space:nowrap}.note{font-size:12px;color:var(--muted)}footer{position:fixed;bottom:0;left:280px;right:0;background:var(--bg);border-top:1px solid var(--line);padding:12px 35px;display:flex;gap:10px;z-index:4}footer .btn{min-width:76px}dialog{width:560px;max-width:90vw;background:var(--bg);color:var(--text);border:1px solid var(--line);border-radius:10px;padding:20px;font-size:13px;line-height:1.65}dialog::backdrop{background:#131b3255}dialog h2{font-size:17px;margin:0 0 12px;border:0;padding:0}dialog textarea{width:100%;height:130px;border:1px solid var(--line);border-radius:6px;padding:10px;font:11px/1.6 monospace;background:var(--side);color:var(--text)}.dialog-actions{display:flex;justify-content:flex-end;gap:8px;margin-top:18px}.dark{--bg:#171b24;--side:#1b1d24;--text:#e2e4ed;--muted:#a1a6b7;--line:#303440;--blue:#8eb7ff;--green:#83c9a0;--amber:#dab779;--red:#e49a9e}@media(min-width:1600px){main,.home main{padding-left:52px}}@media(max-width:1279px){#home{width:220px}nav button{padding:0 9px}.tools{gap:4px}}@media(max-width:1050px){header{height:auto;flex-wrap:wrap;min-height:64px}nav{order:3;flex-basis:100%;height:44px}.tools{margin-left:auto}}@media(max-width:700px){.layout{display:block}aside{position:relative;top:0;height:200px}main,.home main{width:100%;max-width:100%;margin:0;padding:24px 20px 90px}footer{left:0;padding:10px;flex-wrap:wrap}footer input{flex-basis:100%}.tools{flex-wrap:wrap}h1{font-size:28px}}
 ${readerContentStyles("article")}
 article code{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
 article :not(pre)>code{padding:3px 6px;overflow-wrap:break-word}
@@ -105962,10 +106243,85 @@ article.review-new-page .language-mermaid{--context-text:var(--green);--context-
 article .changed .language-mermaid{--context-text:var(--amber);--context-muted-text:var(--amber)}
 article .changed.removed .language-mermaid{--context-text:var(--red);--context-muted-text:var(--red)}
 article.review-new-page .context-diagram-shell,article .changed .context-diagram-shell{--diagram-text:var(--context-text)}
+header { gap: 0; }
+header #home { width: 242px; }
+header nav { scrollbar-width: none; }
+header nav::-webkit-scrollbar { display: none; }
+header nav button { padding: 0 11px; }
+.tools { flex-shrink: 0; gap: 16px; }
+.reading-progress { min-width: 225px; }
+#counts { display: flex; align-items: center; justify-content: space-between; gap: 8px; white-space: nowrap; font-size: 12px; color: var(--muted); }
+#counts b { font-weight: 650; color: var(--text); font-variant-numeric: tabular-nums; }
+#counts .separator { color: var(--line); }
+#revisions-link { border: 0; padding: 0; background: transparent; color: var(--muted); font-size: inherit; }
+#revisions-link.has-notes, #revisions-link.has-notes b { color: var(--amber); }
+#revisions-link:hover, #revisions-link[aria-pressed="true"] { color: var(--blue); text-decoration: none; }
+.read-track { height: 2px; margin-top: 5px; background: var(--line); border-radius: 2px; overflow: hidden; }
+#read-fill { display: block; height: 100%; width: 0; background: var(--blue); transition: width .2s ease; }
+.badge.read { color: var(--blue); background: color-mix(in srgb,var(--blue) 8%,var(--bg)); font-size: 9px; letter-spacing: .03em; }
+.badge.has-feedback { color: var(--amber); background: color-mix(in srgb,var(--amber) 8%,var(--bg)); }
+aside { top: var(--header-height,64px); height: calc(100vh - var(--header-height,64px)); }
+.node { height: auto; min-height: 38px; }
+.node .node-content { display: flex; align-items: center; min-width: 0; gap: 5px; }
+.node .node-title { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; min-width: 0; }
+.node .node-status { margin-left: auto; display: inline-flex; gap: 3px; flex-shrink: 0; }
+.node .badge { margin: 0; padding: 0 4px; line-height: 17px; }
+.node .caret { margin-left: auto; }
+main { padding-bottom: 160px; }
+.home main { max-width: 1100px; width: calc(100% - 280px); }
+.home h1 { font-size: 28px; }
+.revision-index main { max-width: 1060px; }
+.revision-index h1 { font-size: 28px; margin-bottom: 12px; }
+.revision-index .revision-card { margin: 18px 0; padding: 22px 24px; border: 1px solid var(--line); background: var(--bg); border-radius: 9px; }
+.revision-card h2 { border: 0; padding: 0; margin: 0 0 8px; font-size: 17px; line-height: 1.5; }
+.revision-title { border: 0; padding: 0; background: transparent; color: var(--text); text-align: left; font-size: inherit; font-weight: 600; }
+.revision-title:hover { color: var(--blue); }
+.revision-title .arrow { color: var(--muted); font-size: 14px; margin-left: 5px; }
+.revision-path { color: var(--muted); font-size: 11px; margin: 0 0 15px; overflow-wrap: anywhere; }
+.revision-body { font-size: 14px; line-height: 1.85; white-space: pre-wrap; overflow-wrap: anywhere; margin: 0; }
+.empty-notes { padding: 38px 24px; margin: 24px 0; border: 1px dashed var(--line); border-radius: 9px; color: var(--muted); text-align: center; }
+footer { align-items: center; flex-wrap: nowrap; padding: 12px 35px; gap: 12px; }
+#revision-note { display: block; flex: 1 1 0%; min-width: 0; height: 42px; max-height: 112px; resize: none; overflow-y: auto; border: 1px solid var(--line); border-radius: 6px; padding: 9px 12px; background: var(--side); color: var(--text); font: inherit; font-size: 14px; line-height: 22px; }
+#revision-note::placeholder { color: var(--muted); opacity: .85; }
+#revision-note:focus { outline: 2px solid color-mix(in srgb,var(--blue) 25%,transparent); outline-offset: 0; border-color: var(--blue); }
+#clear-note { flex-shrink: 0; min-width: 108px; height: 36px; }
+#clear-note:disabled { opacity: .4; }
+#toast { position: fixed; bottom: 100px; left: 50%; transform: translateX(-50%); z-index: 20; max-width: calc(100vw - 32px); border: 1px solid var(--line); border-radius: 8px; padding: 10px 18px; color: var(--text); background: var(--bg); box-shadow: 0 5px 24px #17244222; font-size: 13px; }
+#copied-notes { height: 240px; font: 13px/1.8 inherit; resize: vertical; }
+.copy-heading { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
+.copy-heading h2 { margin: 0; }
+.copy-heading h2.copy-success { color: var(--green); }
+#copy-countdown { color: var(--muted); font-size: 12px; font-variant-numeric: tabular-nums; white-space: nowrap; }
+#copy-preview { position: relative; max-height: min(400px, calc(100dvh - 180px)); overflow: hidden; border: 1px solid var(--line); border-radius: 7px; background: var(--side); }
+#copy-preview-text { padding: 14px 16px; white-space: pre-wrap; overflow-wrap: anywhere; font-size: 13px; line-height: 1.85; }
+.copy-ellipsis { display: none; position: absolute; bottom: 0; left: 0; right: 0; height: 40px; padding: 13px 16px 2px; background: linear-gradient(transparent, var(--side) 35%); color: var(--muted); font-size: 16px; }
+#copy-preview.has-overflow .copy-ellipsis { display: block; }
+button:focus-visible { outline: 2px solid var(--blue); outline-offset: 3px; }
+@media (min-width: 1600px) { .home main { max-width: 1100px; } }
+@media (max-width: 1200px) { header #home { width: 205px; } .tools { gap: 10px; } header nav button { padding: 0 8px; } }
+@media (max-width: 1050px) { header { padding: 10px 20px 0; } header nav { order: 3; flex-basis: 100%; height: 42px; } header #home { flex: 1; width: auto; } .tools { margin-left: 8px; } }
+@media (max-width: 700px) {
+  header { padding: 10px 14px 0; gap: 6px 0; }
+  header #home { flex: 1 1 auto; font-size: 14px; }
+  header .tools { order: 2; width: 100%; margin-left: 0; justify-content: space-between; flex-wrap: nowrap; padding: 4px 0; }
+  header .reading-progress { flex: 1; min-width: 0; max-width: 260px; }
+  header #theme, header #language { margin-left: 6px; }
+  header nav { order: 3; margin-top: 2px; }
+  aside { top: 0; position: relative; height: 180px; }
+  main, .home main { width: 100%; max-width: 100%; margin: 0; padding: 24px 20px 150px; }
+  .home h1 { font-size: 26px; }
+  footer { left: 0; flex-wrap: nowrap; gap: 8px; padding: 10px 12px; }
+  #revision-note { flex: 1 1 0%; font-size: 14px; }
+  #clear-note { min-width: 96px; padding: 5px 8px; }
+  .revision-index .revision-card { padding: 18px; }
+  .changed { padding-right: 0; }
+  .changed > .badge { position: static; margin: 0 0 10px; }
+}
+
 `;
 
 // src/project/reviewHtml.ts
-var REVIEW_HTML_ROOT = join90(".tmp", "context-runtime", "review");
+var REVIEW_HTML_ROOT = join91(".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");
@@ -105982,23 +106338,39 @@ async function collectAllReviewCandidates(projectRoot) {
     snapshot: await readReviewCandidateSnapshot(projectRoot, record4)
   })));
 }
-function renderReviewHtml(candidates, reviewScope, model, diagramScript) {
-  const scope2 = {
-    label: reviewScope,
-    ids_sha256: candidateIdsHash(candidates.map((c) => c.record.candidate_id).sort()),
-    candidates_sha256: candidateSetHash(candidates.map((c) => c.record))
-  };
-  return `<!doctype html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapeReviewHtml(model.title)} · Review</title><style>${REVIEW_SITE_STYLES}${model.themeCss ?? ""}</style></head><body>
-<header><button id="home">${escapeReviewHtml(model.title)}</button><nav id="top"></nav><div class="tools"><div class="counter" tabindex="0"><span id="counts"></span><div class="counter-pop" id="counter-pop"></div></div><button class="btn" id="all-approved"></button><button class="btn" id="all-rejected"></button><button class="btn primary" id="payload-open"></button><div class="guide" id="copy-guide"><span id="guide-countdown">10s</span><p id="guide-text"></p><button class="btn" id="guide-close"></button></div></div><button class="btn" id="theme" aria-label="Theme">◐</button><button class="btn" id="language"></button></header>
-<div class="layout"><aside id="tree"></aside><main><article id="article"></article></main></div>
-<footer id="footer" hidden><input id="revision-note" aria-label="Revision instructions"><button class="btn" id="revise-btn"></button><button class="btn" id="reject-btn"></button><button class="btn primary" id="approve-btn"></button></footer>
-<dialog id="bulk-dialog"><h2 id="bulk-title"></h2><p id="bulk-message"></p><div id="bulk-roots" hidden><strong id="bulk-roots-title"></strong><ul id="bulk-roots-list"></ul><label class="bulk-ack"><input type="checkbox" id="bulk-ack"><span id="bulk-ack-label"></span></label></div><div class="dialog-actions"><button class="btn" id="bulk-cancel"></button><button class="btn primary" id="bulk-confirm"></button></div></dialog>
-<dialog id="copy-dialog"><h2 id="copy-title"></h2><p id="copy-summary"></p><p id="copy-instructions"></p><textarea id="payload" readonly aria-label="Review code"></textarea><p id="copy-warning"></p><button class="btn" id="payload-close"></button></dialog>
-${diagramScript ? `<script>${diagramScript}</script>` : ""}<script>const DATA=${reviewHtmlJson(model)};const SCOPE=${reviewHtmlJson(scope2)};const feedbackCodec=(${createReviewFeedbackCodec.toString()})();${REVIEW_SITE_CLIENT}</script></body></html>`;
+function renderReviewHtml(model, diagramScript) {
+  return `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${escapeReviewHtml(model.title)} · Reading report</title><style>${REVIEW_SITE_STYLES}${model.themeCss ?? ""}</style></head><body>
+  <header>
+    <button id="home" aria-label="返回本次内容">${escapeReviewHtml(model.title)}</button>
+    <nav id="top" aria-label="知识分类"></nav>
+    <div class="tools">
+      <div class="reading-progress">
+        <div id="counts" aria-label="阅读进度"></div>
+        <div class="read-track" role="progressbar" aria-label="本轮阅读进度" aria-valuemin="0" aria-valuenow="0"><span id="read-fill"></span></div>
+      </div>
+      <button class="btn primary" id="copy-notes">复制修订意见</button>
+    </div>
+    <button class="btn" id="theme" aria-label="切换深色主题" title="切换深色主题">◐</button>
+    <button class="btn" id="language" aria-label="Switch language">EN</button>
+  </header>
+  <div class="layout"><aside id="tree" aria-label="文章目录"></aside><main><article id="article"></article></main></div>
+  <footer id="footer" hidden>
+    <textarea id="revision-note" rows="1" placeholder="输入本篇修订意见……" aria-label="本篇修订意见"></textarea>
+    <button class="btn" id="clear-note" disabled>清空本条修订</button>
+  </footer>
+  <dialog id="copy-dialog" aria-labelledby="copy-title">
+    <div class="copy-heading"><h2 id="copy-title"></h2><span id="copy-countdown" hidden></span></div>
+    <p id="copy-summary"></p>
+    <div id="copy-preview" hidden><div id="copy-preview-text"></div><span class="copy-ellipsis" aria-hidden="true">...</span></div>
+    <textarea id="copied-notes" readonly aria-label="修订意见文本"></textarea>
+    <div class="dialog-actions"><button class="btn" id="copy-close">关闭</button></div>
+  </dialog>
+  <div id="toast" role="status" aria-live="polite" hidden></div>
+${diagramScript ? `<script>${diagramScript}</script>` : ""}<script>const DATA=${reviewHtmlJson(model)};${REVIEW_SITE_CLIENT}</script></body></html>`;
 }
 function resolveOutputPath(projectRoot, outPath, reviewScope) {
   if (outPath === undefined)
-    return join90(projectRoot, REVIEW_HTML_ROOT, `${reviewScope}.html`);
+    return join91(projectRoot, REVIEW_HTML_ROOT, `${reviewScope}.html`);
   return isAbsolute15(outPath) ? outPath : resolve28(projectRoot, outPath);
 }
 async function writeReviewHtml(input) {
@@ -106014,14 +106386,15 @@ 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(join90(here, "browser/diagrams.js"), "utf8");
+      diagramScript = await readFile72(join91(here, "browser/diagrams.js"), "utf8");
     } catch (error) {
       if (error.code !== "ENOENT")
         throw error;
-      diagramScript = await readFile71(resolve28(here, "../../dist/browser/diagrams.js"), "utf8");
+      diagramScript = await readFile72(resolve28(here, "../../dist/browser/diagrams.js"), "utf8");
     }
   }
-  await writeFile25(outPath, renderReviewHtml(candidates, reviewScope, model, diagramScript), "utf8");
+  await writeFile25(outPath, renderReviewHtml(model, diagramScript), "utf8");
+  await saveReviewReportScope(input.projectRoot, reviewScope, candidates, model.baselineHash);
   const unplaced = model.pages.filter((page) => page.candidate_id && !model.nodes.some((node3) => node3.page === page.id && node3.parent !== "review-unplaced" && !node3.removed)).map((page) => ({ article_id: page.id, candidate_id: page.candidate_id, path: page.path, title: page.title }));
   return {
     navigation: { ready: unplaced.length === 0, unplaced_count: unplaced.length, unplaced },
@@ -106041,8 +106414,8 @@ init_productionRequirements();
 init_dist();
 init_atomicWrite();
 init_reviewShared();
-import { mkdir as mkdir32, readFile as readFile72 } from "node:fs/promises";
-import { join as join91 } from "node:path";
+import { mkdir as mkdir32, readFile as readFile73 } from "node:fs/promises";
+import { join as join92 } from "node:path";
 var REVIEW_BATCH_MAX_CANDIDATES = 6;
 var REVIEW_BATCH_MAX_BYTES = 512 * 1024;
 async function readerPurposes(projectRoot, sources) {
@@ -106122,12 +106495,12 @@ async function materializeCurrentReviewBatchSet(input) {
   const batches = buildCurrentReviewBatchDocuments(input.candidates);
   const setDigest = digestText(batches.map((batch) => `${batch.task_key}:${batch.digest}`).join(`
 `));
-  const root2 = join91(input.projectRoot, ".tmp", "context-runtime", "review", `current-${setDigest.slice("sha256:".length)}`);
+  const root2 = join92(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 = join91(input.projectRoot, ".tmp", "context-runtime", "review", `${batch.task_key}-${batch.digest.slice("sha256:".length)}.md`);
-    const existing = await readFile72(path4, "utf8").catch((error) => {
+    const path4 = join92(input.projectRoot, ".tmp", "context-runtime", "review", `${batch.task_key}-${batch.digest.slice("sha256:".length)}.md`);
+    const existing = await readFile73(path4, "utf8").catch((error) => {
       if (error.code === "ENOENT")
         return;
       throw error;
@@ -106155,7 +106528,7 @@ async function materializeCurrentReviewBatchSet(input) {
     "Apply only decisions for pages actually reviewed. Keep undecided or repair pages out of decisions; do not set default unless every page has that decision. Omit remains a durable exclusion, never a request to repair.",
     "Save the following current scope in a temporary JSON input file and add decisions as {candidate_id, status: approved|rejected}; use that file in the Route command. Applied pages survive later repairs of other pages.",
     "```json",
-    JSON.stringify({ schema: REVIEW_PAYLOAD_SCHEMA, scope: {
+    JSON.stringify({ schema: REVIEW_PAYLOAD_SCHEMA, baseline_hash: await reviewSiteBaselineHash(input.projectRoot, input.candidates.map((c) => c.record.approved_revision?.previous_path ?? c.record.path)), scope: {
       kind: "all",
       count: input.candidates.length,
       ids_sha256: candidateIdsHash(input.candidates.map((item) => item.record.candidate_id).sort()),
@@ -106180,7 +106553,7 @@ async function materializeCurrentReviewBatchSet(input) {
   ].join(`
 `);
   const digest6 = digestText(content3);
-  const path3 = join91(root2, "index.md");
+  const path3 = join92(root2, "index.md");
   await atomicWriteFile(path3, `${content3}
 `);
   return {
@@ -106213,11 +106586,11 @@ function shellQuote6(value) {
 }
 function receiptSetPath(receipts) {
   const token = digestText(JSON.stringify(receipts)).slice("sha256:".length);
-  return join92(".tmp", "context-runtime", "workflow", "read-receipts", `${token}.json`);
+  return join93(".tmp", "context-runtime", "workflow", "read-receipts", `${token}.json`);
 }
 async function writeReceiptContinuation(input) {
   const path3 = receiptSetPath(input.receipts);
-  const absolutePath = join92(input.projectRoot, path3);
+  const absolutePath = join93(input.projectRoot, path3);
   await writeJsonAtomic(absolutePath, input.receipts);
   const contextCommand = input.managed ? [
     "context",
@@ -106312,7 +106685,7 @@ async function materializeContextWorkflowResource(input) {
   const resourceId = workflowResourceId(input.resourceId);
   const content3 = renderContextWorkflowResource(resourceId, status);
   const location = await materializeResource(await loadContextWorkflowProvider(), resourceId, {
-    cache: join92(found.projectRoot, ".tmp", "context-runtime", "workflow", "resources"),
+    cache: join93(found.projectRoot, ".tmp", "context-runtime", "workflow", "resources"),
     workspace: found.projectRoot,
     revision: input.revision,
     input: {
@@ -106344,7 +106717,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(`@${join92(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(`@${join93(found.projectRoot, continuation.path)}`)} --format json`;
   return {
     protocol: "context.workflow.resource.v1",
     id: resourceId,
@@ -106405,14 +106778,15 @@ async function acknowledgeCurrentWorkflowResources(input) {
   const reevaluated = await reevaluateProjectStatusWorkflow({
     snapshot,
     resourceReceipts: normalizedReceipts,
-    resourceReceiptsReference: `@${join92(found.projectRoot, continuation.path)}`
+    resourceReceiptsReference: `@${join93(found.projectRoot, continuation.path)}`
   });
   return {
     ...reevaluated,
     resourceAcknowledgement: {
       protocol: "context.workflow.resource-receipts.v1",
       acknowledged: directResources.length,
-      receiptReference: `@${join92(found.projectRoot, continuation.path)}`
+      receiptReference: `@${join93(found.projectRoot, continuation.path)}`,
+      message: "Read the returned workflow and follow its selected command unchanged, including revision and resource-receipt arguments. Do not pre-chain an earlier write command or replace this result with status without receipts. Acknowledgement does not necessarily change the revision; reread only changed or unavailable required content."
     }
   };
 }
@@ -106458,9 +106832,9 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 init_workspace();
-import { readFile as readFile73 } from "node:fs/promises";
-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");
+import { readFile as readFile74 } from "node:fs/promises";
+import { isAbsolute as isAbsolute16, join as join94, sep as sep6, resolve as resolve29 } from "node:path";
+var RECEIPT_DIRECTORY = join94(".tmp", "context-runtime", "workflow", "read-receipts");
 function workflowResourceReceiptCwd(value, cwd) {
   if (value === undefined || !value.startsWith("@"))
     return cwd;
@@ -106478,7 +106852,7 @@ async function receiptDocument(value, cwd) {
   let source2 = value;
   if (value.startsWith("@")) {
     try {
-      source2 = await readFile73(resolve29(cwd, value.slice(1)), "utf8");
+      source2 = await readFile74(resolve29(cwd, value.slice(1)), "utf8");
     } catch (error) {
       const ioCode = error !== null && typeof error === "object" && "code" in error && typeof error.code === "string" ? error.code : undefined;
       throw new ContextError(ExitCode.UserError, "resource read receipt file is unavailable", {
@@ -106737,14 +107111,14 @@ function compactJsonResult(result, verbose) {
 // src/project/runLog.ts
 import { randomUUID as randomUUID5 } from "node:crypto";
 import { mkdir as mkdir34, writeFile as writeFile27 } from "node:fs/promises";
-import { dirname as dirname40, join as join99 } from "node:path";
+import { dirname as dirname40, join as join100 } 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 = join99(".tmp", "context-runtime", "runs", `${input.runId}.json`);
-  const absPath = join99(input.projectRoot, relPath);
+  const relPath = join100(".tmp", "context-runtime", "runs", `${input.runId}.json`);
+  const absPath = join100(input.projectRoot, relPath);
   await mkdir34(dirname40(absPath), { recursive: true });
   await writeFile27(absPath, `${JSON.stringify({
     run_id: input.runId,
@@ -107687,6 +108061,9 @@ execution scope cleanup failed`, true)
 // src/project/workflow/workflowInProcessActions.ts
 init_workflowFacts();
 
+// src/project/reviewLegacy.ts
+init_candidateLedger();
+
 // src/project/reviewCode.ts
 function createReviewCodeCodec() {
   const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
@@ -107826,11 +108203,140 @@ function createReviewCodeCodec() {
   return { encode, decode: decode2 };
 }
 
+// src/project/reviewFeedbackCode.ts
+function createReviewFeedbackCodec() {
+  const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+  function checksum(text9) {
+    let crc = 4294967295;
+    for (let i2 = 0;i2 < text9.length; i2++) {
+      crc ^= text9.charCodeAt(i2);
+      for (let j = 0;j < 8; j++)
+        crc = crc >>> 1 ^ (crc & 1 ? 3988292384 : 0);
+    }
+    return ((crc ^ 4294967295) >>> 0).toString(16).padStart(8, "0");
+  }
+  function validate2(value) {
+    if (!value || !/^[a-z][a-z0-9-]*$/.test(value.scope) || ![value.idsHash, value.contentHash, value.baselineHash].every((h) => typeof h === "string" && /^[a-f0-9]{64}$/.test(h)) || !Array.isArray(value.statuses) || !value.statuses.length || value.statuses.length > 1e5 || value.statuses.some((s) => !["approved", "rejected", "pending", "revised"].includes(s)) || value.statuses.every((s) => s === "pending") || !Array.isArray(value.repairs))
+      throw new Error("Invalid review feedback scope or decisions");
+    const seen = new Set;
+    for (const repair of value.repairs) {
+      if (!repair || !Number.isInteger(repair.index) || seen.has(repair.index) || value.statuses[repair.index] !== "revised" || typeof repair.instruction !== "string" || !repair.instruction.trim() || repair.instruction.length > 20000)
+        throw new Error("Invalid or conflicting revision instruction");
+      seen.add(repair.index);
+    }
+    if (value.statuses.filter((s) => s === "revised").length !== seen.size)
+      throw new Error("Missing revision instruction");
+    return value;
+  }
+  function encode(value) {
+    validate2(value);
+    const bytes = new TextEncoder().encode(JSON.stringify({ scope: value.scope, idsHash: value.idsHash, contentHash: value.contentHash, baselineHash: value.baselineHash, statuses: value.statuses }));
+    let bits = 0, carry = 0, data2 = "";
+    for (const byte of bytes) {
+      carry = carry << 8 | byte;
+      bits += 8;
+      while (bits >= 6) {
+        bits -= 6;
+        data2 += alphabet[carry >>> bits & 63];
+      }
+    }
+    if (bits)
+      data2 += alphabet[carry << 6 - bits & 63];
+    const body2 = `CR2.${data2}`;
+    const repairs = value.repairs.map((r) => JSON.stringify([r.index, r.instruction])).join(`
+`);
+    const trailer = repairs ? `
+${repairs}` : "";
+    const code3 = `${body2}.${checksum(body2 + trailer)}${trailer}`;
+    if (code3.length > 250000)
+      throw new Error("Review feedback is too large; shorten instructions or review a smaller scope");
+    return code3;
+  }
+  function decode2(raw) {
+    const code3 = raw.trim();
+    if (code3.length > 250000)
+      throw new Error("Review feedback exceeds supported size");
+    const [header, ...lines] = code3.split(`
+`);
+    const trailer = lines.length ? `
+${lines.join(`
+`)}` : "";
+    const match = /^CR2\.([A-Za-z0-9_-]+)\.([a-f0-9]{8})$/.exec(header);
+    if (!match || checksum(`CR2.${match[1]}` + trailer) !== match[2])
+      throw new Error("Review feedback is damaged or incomplete; copy the full code again");
+    let bits = 0, carry = 0;
+    const bytes = [];
+    for (const char of match[1]) {
+      carry = carry << 6 | alphabet.indexOf(char);
+      bits += 6;
+      if (bits >= 8) {
+        bits -= 8;
+        bytes.push(carry >>> bits & 255);
+      }
+    }
+    const headerValue = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(new Uint8Array(bytes)));
+    const value = validate2({ ...headerValue, repairs: lines.map((line) => {
+      const row = JSON.parse(line);
+      if (!Array.isArray(row) || row.length !== 2)
+        throw new Error("Invalid revision instruction line");
+      return { index: row[0], instruction: row[1] };
+    }) });
+    if (encode(value) !== code3)
+      throw new Error("Noncanonical review feedback encoding");
+    return value;
+  }
+  return { encode, decode: decode2 };
+}
+
+// src/project/reviewLegacy.ts
+init_reviewShared();
+init_errors3();
+init_cliFeedback();
+init_exitCode();
+function warnLegacyReview(entry) {
+  process.stderr.write(`[context] ${entry} is accepted for compatibility. 新版审核页无需审核码；直接回复确认或修订意见。Agent 在用户确认后使用 context review approve-all [collection] --confirmed（跨集合加 --all）；修订意见通过当前范围 JSON 提交。
+`);
+}
+async function readLegacyReviewPayload(raw, projectRoot) {
+  warnLegacyReview("Legacy review input");
+  try {
+    const feedback = raw.trim().startsWith("CR2.") ? createReviewFeedbackCodec().decode(raw) : undefined;
+    const decoded = feedback ?? createReviewCodeCodec().decode(raw);
+    const collection = decoded.scope === "all" ? undefined : assertCollection(decoded.scope);
+    const rows = (await readCandidateRecords(projectRoot)).filter((row) => row.status === "draft" && (collection === undefined || row.collection === collection)).sort((a, b) => a.candidate_id < b.candidate_id ? -1 : a.candidate_id > b.candidate_id ? 1 : 0);
+    return {
+      ...collection === undefined ? {} : { collection },
+      ...feedback === undefined ? {} : { baseline_hash: feedback.baselineHash },
+      scope: {
+        kind: collection === undefined ? "all" : "collection",
+        ...collection === undefined ? {} : { collection },
+        count: decoded.statuses.length,
+        ids_sha256: decoded.idsHash,
+        candidates_sha256: decoded.contentHash,
+        visible_candidate_ids: rows.map((row) => row.candidate_id)
+      },
+      decisions: rows.flatMap((row, index2) => {
+        const status = decoded.statuses[index2];
+        return status === "approved" || status === "rejected" ? [{ candidate_id: row.candidate_id, status }] : [];
+      }),
+      repairs: (feedback?.repairs ?? []).map((repair) => ({
+        candidate_id: rows[repair.index]?.candidate_id ?? "legacy-stale-candidate",
+        instruction: repair.instruction
+      }))
+    };
+  } catch (error) {
+    throw new ContextError(ExitCode.UserError, error instanceof Error ? error.message : String(error), {
+      category: ErrorCategory.UserInputInvalid,
+      next: "No new code is needed. Return confirmation or revision notes in the conversation; use the current report scope."
+    });
+  }
+}
+
 // src/project/review.ts
 init_cliFeedback();
 init_errors3();
 init_exitCode();
-import { readFile as readFile80 } from "node:fs/promises";
+import { readFile as readFile81 } from "node:fs/promises";
 import { isAbsolute as isAbsolute19, resolve as resolve31 } from "node:path";
 
 // src/project/reviewApply.ts
@@ -107847,8 +108353,8 @@ init_durableMultiFileTransaction();
 init_durableSingleFileTransaction();
 init_reviewShared();
 import { existsSync as existsSync25 } from "node:fs";
-import { readFile as readFile78 } from "node:fs/promises";
-import { join as join100 } from "node:path";
+import { readFile as readFile79 } from "node:fs/promises";
+import { join as join101 } from "node:path";
 function existingTimestamp(markdown) {
   if (markdown === undefined)
     return;
@@ -107875,7 +108381,7 @@ async function prepareApprovedPage(input) {
       next: "Refresh the current production or article revision, then reopen Review before approval."
     });
   }
-  const relPath = join100("knowledge", input.record.path);
+  const relPath = join101("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("\\")))
@@ -107890,13 +108396,13 @@ async function prepareApprovedPage(input) {
       next: "Resolve the approved page path migration explicitly before approving this candidate."
     });
   }
-  const absPath = join100(input.projectRoot, relPath);
-  const existing = existsSync25(absPath) ? await readFile78(absPath, "utf8") : undefined;
+  const absPath = join101(input.projectRoot, relPath);
+  const existing = existsSync25(absPath) ? await readFile79(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 readFile78(join100(input.projectRoot, "knowledge", previousPath), "utf8") };
+    previous3 = { path: `knowledge/${previousPath}`, content: await readFile79(join101(input.projectRoot, "knowledge", previousPath), "utf8") };
   }
   if (input.record.approved_revision !== undefined) {
     const base = previous3?.content ?? existing;
@@ -107943,7 +108449,7 @@ async function prepareApprovedPage(input) {
 }
 async function readProjectFileMaybe(projectRoot, relPath) {
   try {
-    return await readFile78(join100(projectRoot, relPath), "utf8");
+    return await readFile79(join101(projectRoot, relPath), "utf8");
   } catch (error) {
     if (error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT") {
       return;
@@ -107972,31 +108478,19 @@ function reviewFileTarget(input) {
     content: input.targetContent
   };
 }
-function expandEncodedReviewDecisions(payload, scopedIds) {
-  if (payload.scope?.candidates_sha256 === undefined || payload.encoded_statuses.length !== scopedIds.length || payload.decisions.length !== 0 || payload.default !== undefined || payload.encoded_statuses.some((status) => status !== "approved" && status !== "rejected" && status !== "pending")) {
-    throw new ContextError(ExitCode.UserError, "Invalid scoped review code decisions", {
-      category: ErrorCategory.UserInputInvalid,
-      next: "Copy a fresh complete review code from the current HTML report."
-    });
-  }
-  return scopedIds.flatMap((candidate_id, index2) => {
-    const status = payload.encoded_statuses[index2];
-    return status === "pending" ? [] : [{ candidate_id, status }];
-  });
-}
 function expandReviewPayload(payload, rows) {
   const scopedRows = payload.scope?.kind === "all" ? rows.filter((row) => row.status === "draft") : payload.collection !== undefined ? rows.filter((row) => row.collection === payload.collection && row.status === "draft") : [];
   const scopedIds = scopedRows.map((row) => row.candidate_id).sort();
   if (payload.scope === undefined) {
     throw new ContextError(ExitCode.UserError, "review payload requires an explicit scope from the current review gate", {
       category: ErrorCategory.UserInputInvalid,
-      next: payload.collection === undefined ? "Rerun context review html --all --format json and copy a fresh scoped payload." : `Rerun context review html ${payload.collection} --format json and copy a fresh scoped payload.`
+      next: payload.collection === undefined ? "Rerun context review html --all --format json and use its current scope template." : `Rerun context review html ${payload.collection} --format json and use its current scope template.`
     });
   }
   const actualHash = candidateIdsHash(scopedIds);
   const actualCandidatesHash = candidateSetHash(scopedRows);
   const visibleIds = payload.scope.visible_candidate_ids;
-  if (payload.scope.kind === "all" && visibleIds === undefined && payload.encoded_statuses === undefined) {
+  if (payload.scope.kind === "all" && visibleIds === undefined) {
     throw new ContextError(ExitCode.UserError, "all-scope review payload requires scope.visible_candidate_ids", {
       category: ErrorCategory.UserInputInvalid,
       expected: {
@@ -108004,7 +108498,7 @@ function expandReviewPayload(payload, rows) {
         ids_sha256: actualHash,
         visible_candidate_ids: scopedIds
       },
-      next: "Rerun context review html --all --format json and copy a fresh scoped payload."
+      next: "Rerun context review html --all --format json and use its current scope template."
     });
   }
   const visibleMismatch = visibleIds !== undefined && (visibleIds.length !== scopedIds.length || visibleIds.some((id3, index2) => id3 !== scopedIds[index2]));
@@ -108020,11 +108514,9 @@ function expandReviewPayload(payload, rows) {
         candidates_sha256: actualCandidatesHash,
         visible_candidate_ids: scopedIds
       },
-      next: `Rerun context review html ${scopeLabel} and copy a fresh payload.`
+      next: `Rerun context review html ${scopeLabel} and use its current scope template.`
     });
   }
-  if (payload.encoded_statuses !== undefined)
-    return expandEncodedReviewDecisions(payload, scopedIds);
   if (payload.default === undefined) {
     const scopedSet = new Set(scopedIds);
     for (const decision of payload.decisions) {
@@ -108074,6 +108566,14 @@ async function applyReviewDecisions(input) {
     const nextRows = [...rows];
     const decisions = expandReviewPayload(input.payload, rows);
     const scoped = rows.filter((r) => r.status === "draft" && (input.payload.scope?.kind === "all" || r.collection === input.payload.collection)).sort((a, b) => a.candidate_id < b.candidate_id ? -1 : 1);
+    const pendingFeedback = await readPendingReviewFeedback(input.projectRoot, scoped.map((record4) => ({ record: record4, snapshot: undefined })));
+    const unresolved = pendingFeedback.filter((repair) => decisions.some((decision) => decision.candidate_id === repair.candidate_id && decision.status === "approved"));
+    if (unresolved.length) {
+      throw new ContextError(ExitCode.UserError, "Pending revision instructions must be resolved before approval", {
+        category: ErrorCategory.UserInputInvalid,
+        repairs: unresolved
+      });
+    }
     if (input.payload.baseline_hash && input.payload.baseline_hash !== await reviewSiteBaselineHash(input.projectRoot, scoped.map((r) => r.approved_revision?.previous_path ?? r.path))) {
       throw new ContextError(ExitCode.WorkspaceStateError, "Review navigation or approved baseline changed; generate a fresh report", {
         category: ErrorCategory.WorkspaceStateInvalid,
@@ -108082,11 +108582,15 @@ async function applyReviewDecisions(input) {
       });
     }
     const repairIds = new Set;
-    const repairs = (input.payload.feedback_repairs ?? []).map((repair) => {
-      const row = scoped[repair.index];
-      if (!Number.isInteger(repair.index) || !row || repairIds.has(repair.index) || !repair.instruction.trim() || input.payload.encoded_statuses?.[repair.index] !== "pending")
-        throw new Error("Invalid review revision request");
-      repairIds.add(repair.index);
+    const repairs = (input.payload.repairs ?? []).map((repair) => {
+      const row = scoped.find((candidate) => candidate.candidate_id === repair.candidate_id);
+      if (!row || repairIds.has(repair.candidate_id) || !repair.instruction.trim() || decisions.some((decision) => decision.candidate_id === repair.candidate_id)) {
+        throw new ContextError(ExitCode.UserError, "Revision requests must be unique, scoped and separate from decisions", {
+          category: ErrorCategory.UserInputInvalid,
+          candidate_id: repair.candidate_id
+        });
+      }
+      repairIds.add(repair.candidate_id);
       const quote = (value) => "'" + value.replace(/'/gu, "'\\''") + "'";
       return {
         candidate_id: row.candidate_id,
@@ -108166,7 +108670,7 @@ async function applyReviewDecisions(input) {
           });
         }
         seenApprovedIds.set(approvedRef, row.candidate_id);
-        const approvedPath = join100("knowledge", row.path);
+        const approvedPath = join101("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}`, {
@@ -108216,7 +108720,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 readFile78(join100(input.projectRoot, path3), "utf8");
+        const before = await readFile79(join101(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 }));
@@ -108275,11 +108779,11 @@ async function applyReviewDecisions(input) {
 init_reviewShared();
 init_writeLock();
 init_verifyFrontmatter();
-import { readFile as readFile79, writeFile as writeFile28 } from "node:fs/promises";
+import { readFile as readFile80, writeFile as writeFile28 } from "node:fs/promises";
 function deprecateApprovedPage(input) {
   return withProjectWriteLock(input.projectRoot, "deprecate-article", async () => {
     const page = await approvedPageForArticleId(input.projectRoot, input.viewRef);
-    const original = await readFile79(page.path, "utf8");
+    const original = await readFile80(page.path, "utf8");
     const content3 = parseFrontmatterLoose(original).deprecated === true ? original : updateFrontmatter(original, (metadata) => ({ ...metadata, deprecated: true, timestamp: new Date().toISOString() }));
     const changed = content3 !== original;
     if (changed)
@@ -108300,12 +108804,12 @@ init_candidateLedger();
 
 // src/project/localHtmlReport.ts
 import { execFile as execFile11 } from "node:child_process";
-import { isAbsolute as isAbsolute18, join as join101 } from "node:path";
+import { isAbsolute as isAbsolute18, join as join102 } 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 = isAbsolute18(input.path) ? input.path : join101(input.projectRoot, input.path);
+  const absolutePath = isAbsolute18(input.path) ? input.path : join102(input.projectRoot, input.path);
   return {
     format: "html",
     path: input.path,
@@ -108409,7 +108913,7 @@ function parsePayloadValues(parsed) {
   if (first.schema !== REVIEW_PAYLOAD_SCHEMA) {
     throw new ContextError(ExitCode.UserError, `review payload header schema must be ${REVIEW_PAYLOAD_SCHEMA}`, {
       category: ErrorCategory.UserInputInvalid,
-      next: "Copy a fresh review payload from context review html <collection>."
+      next: "Use the current scope template from the review resource."
     });
   }
   const scope2 = parsePayloadScope(first.scope);
@@ -108437,7 +108941,18 @@ function parsePayloadValues(parsed) {
   }
   const decisions = first.decisions ?? parsed.slice(1);
   const validatedDecisions = decisions.map((item, index2) => parsePayloadLineDecision(item, index2 + 2));
+  const repairs = first.repairs;
+  if (repairs !== undefined && (!Array.isArray(repairs) || repairs.some((item) => !isRecord14(item) || typeof item.candidate_id !== "string" || !item.candidate_id.trim() || typeof item.instruction !== "string" || !item.instruction.trim()))) {
+    throw new ContextError(ExitCode.UserError, "review repairs require candidate_id and nonempty instruction", {
+      category: ErrorCategory.UserInputInvalid
+    });
+  }
+  if (first.baseline_hash !== undefined && (typeof first.baseline_hash !== "string" || !/^[a-f0-9]{64}$/iu.test(first.baseline_hash))) {
+    throw new ContextError(ExitCode.UserError, "review baseline_hash must be a SHA-256 digest", { category: ErrorCategory.UserInputInvalid });
+  }
   return {
+    ...Array.isArray(repairs) ? { repairs } : {},
+    ...typeof first.baseline_hash === "string" ? { baseline_hash: first.baseline_hash.toLowerCase() } : {},
     decisions: validatedDecisions,
     ...typeof first.note === "string" ? { note: first.note } : {},
     ...collection !== undefined ? { collection } : {},
@@ -108474,59 +108989,21 @@ function parseReviewPayloadText(raw) {
     throw error;
   }
 }
-async function readReviewPayloadFile(filePath2) {
+async function readReviewPayloadFile(filePath2, projectRoot) {
   let raw;
   try {
-    raw = await readFile80(filePath2, "utf8");
+    raw = await readFile81(filePath2, "utf8");
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new ContextError(ExitCode.UserError, `review payload file cannot be read: ${filePath2}`, {
       category: ErrorCategory.UserInputInvalid,
       path: filePath2,
       reason: message,
-      next: "Pass the JSON or JSONL review Payload copied from the review HTML page."
+      next: "Pass the scoped JSON or JSONL decisions prepared from the current review resource."
     });
   }
-  if (raw.trim().startsWith("CR")) {
-    try {
-      if (raw.trim().startsWith("CR2.")) {
-        const feedback = createReviewFeedbackCodec().decode(raw);
-        const collection2 = feedback.scope === "all" ? undefined : assertCollection(feedback.scope);
-        return {
-          decisions: [],
-          encoded_statuses: feedback.statuses.map((s) => s === "revised" ? "pending" : s),
-          feedback_repairs: feedback.repairs,
-          baseline_hash: feedback.baselineHash,
-          ...collection2 === undefined ? {} : { collection: collection2 },
-          scope: {
-            kind: collection2 === undefined ? "all" : "collection",
-            ...collection2 === undefined ? {} : { collection: collection2 },
-            count: feedback.statuses.length,
-            ids_sha256: feedback.idsHash,
-            candidates_sha256: feedback.contentHash
-          }
-        };
-      }
-      const decoded = createReviewCodeCodec().decode(raw);
-      const collection = decoded.scope === "all" ? undefined : assertCollection(decoded.scope);
-      return {
-        decisions: [],
-        encoded_statuses: decoded.statuses,
-        ...collection === undefined ? {} : { collection },
-        scope: {
-          kind: collection === undefined ? "all" : "collection",
-          ...collection === undefined ? {} : { collection },
-          count: decoded.count,
-          ids_sha256: decoded.idsHash,
-          candidates_sha256: decoded.contentHash
-        }
-      };
-    } catch (error) {
-      throw new ContextError(ExitCode.UserError, error instanceof Error ? error.message : String(error), {
-        category: ErrorCategory.UserInputInvalid,
-        next: "Copy the complete review code and all following revision instruction lines unchanged from the current report into one input file. Older segmented codes require every segment."
-      });
-    }
+  if (/^CR(?:[12]|P1)\./u.test(raw.trim())) {
+    return readLegacyReviewPayload(raw, projectRoot ?? projectRootFromCwd(process.cwd()));
   }
   return parseReviewPayloadText(raw);
 }
@@ -108664,7 +109141,7 @@ async function runReviewHtmlCommand(input) {
         ...openResult.error !== undefined ? [`open_error: ${openResult.error}`] : []
       ] : []
     ],
-    next: result.next_action ? `${result.next_action.message} ${result.next_action.command}` : "Apply the exact decision Payload returned by this report."
+    next: result.next_action ? `${result.next_action.message} ${result.next_action.command}` : "Return to the conversation to confirm or provide revision notes."
   }));
 }
 async function runReviewListCommand(input) {
@@ -108717,41 +109194,45 @@ async function runReviewListCommand(input) {
 async function runReviewApplyCommand(input) {
   const projectRoot = projectRootFromCwd(input.cwd);
   const payloadPath = isAbsolute19(input.payloadInput) ? input.payloadInput : resolve31(input.cwd, input.payloadInput);
-  const payload = await readReviewPayloadFile(payloadPath);
+  const payload = await readReviewPayloadFile(payloadPath, projectRoot);
   const result = await applyReviewDecisions({ projectRoot, payload });
   const continuation = await input.afterApply?.(projectRoot);
   process.stdout.write(formatApplyResult({ ...result, ...continuation === undefined ? {} : { continuation } }, input.format ?? "text"));
 }
 async function runReviewApproveAllCommand(input) {
-  if (input.managed === true && input.force === true) {
-    throw new ContextError(ExitCode.UserError, "review approve-all accepts either --managed or --force, not both", {
+  if (input.managed === true && (input.confirmed === true || input.force === true)) {
+    throw new ContextError(ExitCode.UserError, "review approve-all accepts either --managed or --confirmed, not both", {
       category: ErrorCategory.UserInputInvalid,
       code: "review-approval-authority-conflict",
       next: "context status --format json"
     });
   }
-  if (input.managed !== true && input.force !== true) {
-    throw new ContextError(ExitCode.UserError, "review approve-all requires explicit --managed authority or --force user confirmation", {
+  if (input.managed !== true && input.confirmed !== true && input.force !== true) {
+    throw new ContextError(ExitCode.UserError, "review approve-all requires explicit --managed authority or --confirmed user confirmation", {
       category: ErrorCategory.UserInputInvalid,
       code: "review-approval-authority-required",
       next: "context status --format json"
     });
   }
-  const decisionSource = input.managed === true ? "managed-session" : "explicit-user-force-approval";
+  if (input.force === true)
+    warnLegacyReview("--force");
+  const decisionSource = input.managed === true ? "managed-session" : "explicit-user-confirmation";
   const projectRoot = projectRootFromCwd(input.cwd);
   const scoped = await reviewCommandScope({
     projectRoot,
     ...input.collection !== undefined ? { collection: input.collection } : {},
     ...input.all === true ? { all: true } : {}
   });
+  const confirmedScope = input.confirmed === true ? await readConfirmedReviewScope(projectRoot, scoped.collection ?? "all") : undefined;
   const result = await applyReviewDecisions({
     projectRoot,
     payload: {
+      ...confirmedScope === undefined ? {} : { baseline_hash: confirmedScope.baseline_hash },
       decisions: [],
       default: "approved",
-      note: input.managed === true ? "managed-session auto approval" : "explicit user force approval",
+      note: input.managed === true ? "managed-session auto approval" : "explicit user confirmation",
       ...scoped.collection !== undefined ? { collection: scoped.collection } : {},
-      scope: scoped.scope
+      scope: confirmedScope?.scope ?? scoped.scope
     }
   });
   const continuation = await input.afterApply?.(projectRoot);
@@ -108785,7 +109266,7 @@ async function runReviewApproveAllCommand(input) {
   process.stdout.write(formatFeedback({
     symbol: "✓",
     action: "approved",
-    subject: input.managed === true ? "managed review batch" : "force-approved review batch",
+    subject: input.managed === true ? "managed review batch" : "confirmed review batch",
     headline: `${result.approved} candidate(s) approved`,
     body: [
       `decision source: ${decisionSource}`,
@@ -108954,7 +109435,7 @@ function supportsCommand(command2) {
     return options !== undefined && options.positionals.length === 0 && outputFormat(options) !== undefined;
   }
   if (topLevel === "review" && subcommand === "approve-all") {
-    const options = parseOptions(command2.slice(2), new Set(["--format"]), new Set(["--all", "--managed", "--force", "--verbose"]));
+    const options = parseOptions(command2.slice(2), new Set(["--format"]), new Set(["--all", "--managed", "--confirmed", "--verbose"]));
     return options !== undefined && options.positionals.length <= 1 && !(options.flags.has("--all") && options.positionals.length === 1) && outputFormat(options) !== undefined;
   }
   if (topLevel === "package" && subcommand === "template" && command2[2] === "accept") {
@@ -108993,7 +109474,7 @@ async function executeBuild(cwd, command2) {
   });
 }
 async function executeReviewApproveAll(cwd, invocation) {
-  const options = parseOptions(invocation.command.slice(2), new Set(["--format"]), new Set(["--all", "--managed", "--force", "--verbose"]));
+  const options = parseOptions(invocation.command.slice(2), new Set(["--format"]), new Set(["--all", "--managed", "--confirmed", "--verbose"]));
   if (options === undefined || options.positionals.length > 1)
     throw new Error("unsupported review approve-all command");
   await runReviewApproveAllCommand({
@@ -109001,7 +109482,7 @@ async function executeReviewApproveAll(cwd, invocation) {
     ...options.positionals[0] === undefined ? {} : { collection: options.positionals[0] },
     ...options.flags.has("--all") ? { all: true } : {},
     managed: invocation.managed || options.flags.has("--managed"),
-    force: options.flags.has("--force"),
+    confirmed: options.flags.has("--confirmed"),
     verbose: options.flags.has("--verbose"),
     format: outputFormat(options) ?? "text"
   });
@@ -109329,8 +109810,8 @@ init_exitCode();
 init_maintenanceStorage();
 init_productionFeedback();
 import { randomUUID as randomUUID6 } from "node:crypto";
-import { readFile as readFile81 } from "node:fs/promises";
-import { join as join102 } from "node:path";
+import { readFile as readFile82 } from "node:fs/promises";
+import { join as join103 } from "node:path";
 async function beginProductionRevision(input) {
   return withProductionFeedback({ operation: "revision" }, () => withProjectWriteLock(input.projectRoot, "production-revision", async () => {
     await recoverDurableMultiFileTransactions(input.projectRoot);
@@ -109369,7 +109850,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 readFile81(await safeProjectTarget(input.projectRoot, join102("knowledge", path3)), "utf8");
+      const markdown = prior?.body ?? await readFile82(await safeProjectTarget(input.projectRoot, join103("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) {
@@ -109546,7 +110027,7 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 var import_yaml41 = __toESM(require_dist(), 1);
-import { readFile as readFile82 } from "node:fs/promises";
+import { readFile as readFile83 } from "node:fs/promises";
 function userInputError2(message, detail = {}) {
   return new ContextError(ExitCode.UserError, message, {
     category: ErrorCategory.UserInputInvalid,
@@ -109615,7 +110096,7 @@ async function readPayloadTextFromStdin(stdin) {
 }
 async function readPayloadText(path3) {
   if (path3 !== "-")
-    return readFile82(path3, "utf8");
+    return readFile83(path3, "utf8");
   return readPayloadTextFromStdin(process.stdin);
 }
 async function readYamlOrJsonInput(input) {
@@ -110009,7 +110490,7 @@ init_atomicWrite();
 var import_yaml44 = __toESM(require_dist(), 1);
 import { Buffer as Buffer5 } from "node:buffer";
 import { createHash as createHash32 } from "node:crypto";
-import { join as join106 } from "node:path";
+import { join as join107 } from "node:path";
 var INLINE_LIMIT = 16 * 1024;
 function record4(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
@@ -110035,8 +110516,8 @@ async function prepareActionCompletionOutput(input) {
   if (production && Buffer5.byteLength(full) <= INLINE_LIMIT)
     return input.result;
   const digest7 = createHash32("sha256").update(full).digest("hex");
-  const root2 = join106(input.projectRoot, ".tmp/context-runtime/action-results");
-  const resultFile = join106(root2, `${digest7}.json`);
+  const root2 = join107(input.projectRoot, ".tmp/context-runtime/action-results");
+  const resultFile = join107(root2, `${digest7}.json`);
   await atomicWriteFile(resultFile, full);
   if (production)
     return {
@@ -110455,7 +110936,7 @@ init_cliFeedback();
 import { existsSync as existsSync27 } from "node:fs";
 import { readdir as readdir27, rm as rm23 } from "node:fs/promises";
 import { homedir } from "node:os";
-import { join as join107 } from "node:path";
+import { join as join108 } 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";
@@ -110472,19 +110953,19 @@ async function cleanClaudePluginCache(opts = {}) {
   for (const mp of marketplaces) {
     if (!mp.isDirectory())
       continue;
-    const mpDir = join107(cacheRoot, mp.name);
+    const mpDir = join108(cacheRoot, mp.name);
     const plugins = await readdir27(mpDir, { withFileTypes: true });
     for (const pl of plugins) {
       if (!pl.isDirectory())
         continue;
-      const plDir = join107(mpDir, pl.name);
+      const plDir = join108(mpDir, pl.name);
       const versions = await readdir27(plDir, { withFileTypes: true });
       for (const ver of versions) {
         if (!ver.isDirectory())
           continue;
         scanned += 1;
-        const verDir = join107(plDir, ver.name);
-        const markerPath = join107(verDir, ORPHAN_MARKER);
+        const verDir = join108(plDir, ver.name);
+        const markerPath = join108(verDir, ORPHAN_MARKER);
         if (!existsSync27(markerPath))
           continue;
         const label2 = `${mp.name}/${pl.name}/${ver.name}`;
@@ -110516,7 +110997,7 @@ function resolveClaudePluginCacheRoot(opts) {
   if (explicitRoot)
     return explicitRoot;
   const home = opts.home ?? process.env[CLAUDE_PLUGIN_CACHE_HOME_ENV] ?? homedir();
-  return join107(home, ".claude", "plugins", "cache");
+  return join108(home, ".claude", "plugins", "cache");
 }
 async function isEmptyDir(dir) {
   try {
@@ -110548,13 +111029,13 @@ init_exitCode();
 
 // src/lib/packageVersion.ts
 import { existsSync as existsSync28, readFileSync as readFileSync9 } from "node:fs";
-import { dirname as dirname43, join as join108 } from "node:path";
+import { dirname as dirname43, join as join109 } from "node:path";
 import { fileURLToPath as fileURLToPath8 } from "node:url";
 function readPackageVersion() {
   try {
     let dir = dirname43(fileURLToPath8(import.meta.url));
     for (let depth = 0;depth < 8; depth += 1) {
-      const packagePath = join108(dir, "package.json");
+      const packagePath = join109(dir, "package.json");
       if (existsSync28(packagePath)) {
         const parsed = JSON.parse(readFileSync9(packagePath, "utf8"));
         if (typeof parsed.version === "string" && parsed.version.length > 0) {
@@ -110577,7 +111058,7 @@ function readPackageVersion() {
 
 // src/project/sourceCommands.ts
 init_src2();
-import { readFile as readFile98 } from "node:fs/promises";
+import { readFile as readFile99 } from "node:fs/promises";
 import { isAbsolute as isAbsolute23, resolve as resolve41 } from "node:path";
 init_cliFeedback();
 init_errors3();
@@ -110940,15 +111421,15 @@ async function restoreRepositorySources(input) {
 init_src2();
 init_documentCapture();
 import { existsSync as existsSync30 } from "node:fs";
-import { readFile as readFile88 } from "node:fs/promises";
-import { join as join110 } from "node:path";
+import { readFile as readFile89 } from "node:fs/promises";
+import { join as join111 } from "node:path";
 
 // src/project/sourceCommandViews.ts
 init_documentSiteDetection();
 init_workspace();
 init_documentBatchManifest();
-import { readFile as readFile87 } from "node:fs/promises";
-import { join as join109 } from "node:path";
+import { readFile as readFile88 } from "node:fs/promises";
+import { join as join110 } from "node:path";
 function repoSourceAgentView(source2) {
   return {
     id: source2.id ?? source2.name,
@@ -111009,7 +111490,7 @@ async function fileSourceAgentViewWithNextAction(input) {
   };
 }
 function documentSourceManifestPath(source2) {
-  return source2.snapshot?.manifest ?? join109(source2.materializedAt, "manifest.json");
+  return source2.snapshot?.manifest ?? join110(source2.materializedAt, "manifest.json");
 }
 async function fileSourceDocumentSiteHint(input) {
   const detection = await detectDocumentSiteFiles({
@@ -111019,7 +111500,7 @@ async function fileSourceDocumentSiteHint(input) {
   let snapshotConfigured = false;
   const manifest = documentSourceManifestPath(input.source);
   try {
-    const parsed = parseDocumentSnapshotForSource(JSON.parse(await readFile87(join109(input.projectRoot, manifest), "utf8")), input.source.name);
+    const parsed = parseDocumentSnapshotForSource(JSON.parse(await readFile88(join110(input.projectRoot, manifest), "utf8")), input.source.name);
     snapshotConfigured = manifestUsesMdxJsonDocs(parsed);
   } catch {
     snapshotConfigured = false;
@@ -111052,11 +111533,11 @@ async function larkSourceAgentViewWithNextAction(input) {
 init_documentBatchManifest();
 init_documentSnapshotFidelity();
 function documentSourceManifestPath2(source2) {
-  return source2.snapshot?.manifest ?? join110(source2.materializedAt, "manifest.json");
+  return source2.snapshot?.manifest ?? join111(source2.materializedAt, "manifest.json");
 }
 async function documentSnapshotState(input) {
   const manifest = documentSourceManifestPath2(input.source);
-  const manifestPath = join110(input.projectRoot, manifest);
+  const manifestPath = join111(input.projectRoot, manifest);
   if (!existsSync30(manifestPath)) {
     return {
       snapshotReady: false,
@@ -111067,7 +111548,7 @@ async function documentSnapshotState(input) {
     };
   }
   try {
-    const parsed = findDocumentSnapshotForSource(JSON.parse(await readFile88(manifestPath, "utf8")), input.source.name);
+    const parsed = findDocumentSnapshotForSource(JSON.parse(await readFile89(manifestPath, "utf8")), input.source.name);
     if (parsed === null) {
       return {
         snapshotReady: false,
@@ -111135,7 +111616,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(join110(input.projectRoot, input.source.materializedAt, path3)));
+    ].find((path3) => !existsSync30(join111(input.projectRoot, input.source.materializedAt, path3)));
     if (missing !== undefined) {
       return {
         snapshotReady: false,
@@ -111236,8 +111717,8 @@ init_errors3();
 init_exitCode();
 var import_yaml47 = __toESM(require_dist(), 1);
 import { createHash as createHash33 } from "node:crypto";
-import { readFile as readFile89, realpath as realpath12 } from "node:fs/promises";
-import { basename as basename13, extname as extname15, isAbsolute as isAbsolute21, join as join111, relative as relative28, resolve as resolve36 } from "node:path";
+import { readFile as readFile90, realpath as realpath12 } from "node:fs/promises";
+import { basename as basename13, extname as extname15, isAbsolute as isAbsolute21, join as join112, relative as relative28, resolve as resolve36 } from "node:path";
 init_writeLock();
 var SOURCE_NAME_PATTERN3 = /^[a-z0-9][a-z0-9._-]*$/u;
 function isDateSourceNamespace(value) {
@@ -111333,7 +111814,7 @@ function assertSafeFileInclude(value) {
 }
 async function readRegistryDocument(projectRoot, registryPath2) {
   try {
-    const content3 = await readFile89(join111(projectRoot, registryPath2), "utf8");
+    const content3 = await readFile90(join112(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")
@@ -111451,7 +111932,7 @@ async function addFileSourceUnlocked(input) {
     const record6 = entry2;
     return record6.name !== input.name && record6.id !== input.name;
   }), nextEntry];
-  await atomicWriteFile(join111(input.projectRoot, DEFAULT_FILE_SOURCES_REGISTRY_PATH), import_yaml47.default.stringify({ sources: nextSources }));
+  await atomicWriteFile(join112(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) {
@@ -111510,7 +111991,7 @@ async function addLarkSourceUnlocked(input) {
     const record6 = entry2;
     return record6.name !== input.name && record6.id !== input.name;
   }), nextEntry];
-  await atomicWriteFile(join111(input.projectRoot, DEFAULT_LARK_SOURCES_REGISTRY_PATH), import_yaml47.default.stringify({ sources: nextSources }));
+  await atomicWriteFile(join112(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) {
@@ -111542,18 +112023,18 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 var import_yaml48 = __toESM(require_dist(), 1);
-import { readFile as readFile90 } from "node:fs/promises";
-import { join as join112 } from "node:path";
+import { readFile as readFile91 } from "node:fs/promises";
+import { join as join113 } from "node:path";
 import { isDeepStrictEqual as isDeepStrictEqual3 } from "node:util";
 function identityKeys(entry) {
   return new Set([entry.name, entry.id]);
 }
 async function createLarkBatchRegistration(projectRoot, namespace) {
   const registry2 = await loadSourcesRegistry({ rootDir: projectRoot });
-  const registryPath2 = join112(projectRoot, DEFAULT_LARK_SOURCES_REGISTRY_PATH);
+  const registryPath2 = join113(projectRoot, DEFAULT_LARK_SOURCES_REGISTRY_PATH);
   let committedSources;
   try {
-    const text10 = await readFile90(registryPath2, "utf8");
+    const text10 = await readFile91(registryPath2, "utf8");
     committedSources = text10.trim().length === 0 ? [] : import_yaml48.default.parse(text10).sources ?? [];
   } catch (error) {
     if (!(error instanceof Error && ("code" in error) && error.code === "ENOENT"))
@@ -111671,8 +112152,8 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 import { createHash as createHash34 } from "node:crypto";
-import { lstat as lstat14, readFile as readFile91 } from "node:fs/promises";
-import { join as join113, resolve as resolve37 } from "node:path";
+import { lstat as lstat14, readFile as readFile92 } from "node:fs/promises";
+import { join as join114, resolve as resolve37 } from "node:path";
 var INPUT_SCHEMA = "context.source-batch.input.v1";
 var STATE_SCHEMA = "context.source-batch.state.v1";
 var RUNTIME_PARTS = [".tmp", "context-runtime", "source-batches"];
@@ -111723,14 +112204,14 @@ function paths(projectRoot, jobId) {
     throw journalError("source-batch-id-invalid", "Source batch checkpoint ID must contain exactly 32 lowercase hexadecimal characters.");
   }
   const directory = resolve37(projectRoot, ...RUNTIME_PARTS, jobId);
-  return { inputPath: join113(directory, "input.json"), statePath: join113(directory, "state.json") };
+  return { inputPath: join114(directory, "input.json"), statePath: join114(directory, "state.json") };
 }
 async function assertJournalPath(projectRoot, jobId, filename) {
   paths(projectRoot, jobId);
   let current2 = resolve37(projectRoot);
   const parts = [...RUNTIME_PARTS, jobId, filename];
   for (const [index2, part] of parts.entries()) {
-    current2 = join113(current2, part);
+    current2 = join114(current2, part);
     let stat11;
     try {
       stat11 = await lstat14(current2);
@@ -111761,7 +112242,7 @@ async function loadSourceBatchJournal(input) {
   const { inputPath } = paths(input.projectRoot, input.jobId);
   try {
     await assertJournalPath(input.projectRoot, input.jobId, "input.json");
-    const stored = JSON.parse(await readFile91(inputPath, "utf8"));
+    const stored = JSON.parse(await readFile92(inputPath, "utf8"));
     if (stored === null || typeof stored !== "object" || Array.isArray(stored)) {
       throw journalError("source-batch-input-invalid", "Source batch checkpoint input must be an object.");
     }
@@ -111864,7 +112345,7 @@ async function readSourceBatchJournalStatus(input) {
   let warning;
   try {
     await assertJournalPath(journal.projectRoot, journal.jobId, "state.json");
-    const parsed = JSON.parse(await readFile91(journal.statePath, "utf8"));
+    const parsed = JSON.parse(await readFile92(journal.statePath, "utf8"));
     if (parsed.schema !== STATE_SCHEMA || parsed.job_id !== journal.jobId || parsed.input_digest !== journal.inputDigest || parsed.total !== journal.items.length || !Number.isSafeInteger(parsed.pid) || parsed.pid <= 0 || typeof parsed.updated_at !== "string" || !Number.isFinite(Date.parse(parsed.updated_at))) {
       throw journalError("source-batch-state-invalid", "Source batch checkpoint progress is invalid.");
     }
@@ -112455,13 +112936,13 @@ init_exitCode();
 
 // src/project/wikiDiscovery.ts
 import { mkdir as mkdir38 } from "node:fs/promises";
-import { join as join115, relative as relative30 } from "node:path";
+import { join as join116, relative as relative30 } from "node:path";
 
 // src/project/wikiDiscoveryStore.ts
 init_atomicWrite();
 import { createHash as createHash35, randomUUID as randomUUID8 } from "node:crypto";
-import { link as link2, lstat as lstat15, mkdir as mkdir37, readFile as readFile92, readdir as readdir28, rm as rm25, writeFile as writeFile29 } from "node:fs/promises";
-import { join as join114, relative as relative29, resolve as resolve38, sep as sep9 } from "node:path";
+import { link as link2, lstat as lstat15, mkdir as mkdir37, readFile as readFile93, readdir as readdir28, rm as rm25, writeFile as writeFile29 } from "node:fs/promises";
+import { join as join115, relative as relative29, resolve as resolve38, sep as sep9 } from "node:path";
 function wikiDiscoveryDigest(value) {
   return createHash35("sha256").update(value).digest("hex");
 }
@@ -112475,7 +112956,7 @@ async function assertWikiDiscoveryPath(root2, path3) {
     throw new WikiDiscoveryError("unsafe-checkpoint-path", false, "Discovery checkpoint must stay inside its workspace");
   let current2 = base;
   for (const part of parts) {
-    current2 = join114(current2, part);
+    current2 = join115(current2, part);
     try {
       if ((await lstat15(current2)).isSymbolicLink()) {
         throw new WikiDiscoveryError("unsafe-checkpoint-path", false, "Discovery checkpoint paths must not contain symbolic links");
@@ -112491,7 +112972,7 @@ async function readWikiDiscoveryJson(path3) {
   try {
     if ((await lstat15(path3)).isSymbolicLink())
       throw new WikiDiscoveryError("unsafe-checkpoint-path", false, "Discovery checkpoint must not be a symbolic link");
-    return JSON.parse(await readFile92(path3, "utf8"));
+    return JSON.parse(await readFile93(path3, "utf8"));
   } catch (error) {
     if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
       return;
@@ -112504,12 +112985,12 @@ async function saveWikiDiscoveryJson(path3, value) {
 }
 async function loadWikiDiscoveryReceipts(directory) {
   const result = new Map;
-  await assertWikiDiscoveryPath(directory, join114(directory, "pages"));
-  await mkdir37(join114(directory, "pages"), { recursive: true });
-  for (const file of await readdir28(join114(directory, "pages"))) {
+  await assertWikiDiscoveryPath(directory, join115(directory, "pages"));
+  await mkdir37(join115(directory, "pages"), { recursive: true });
+  for (const file of await readdir28(join115(directory, "pages"))) {
     if (!/^[a-f0-9]{64}\.json$/u.test(file))
       continue;
-    const value = await readWikiDiscoveryJson(join114(directory, "pages", file));
+    const value = await readWikiDiscoveryJson(join115(directory, "pages", file));
     if (!value || typeof value.parent_node_token !== "string" || value.page_token !== undefined && typeof value.page_token !== "string" || !["completed", "failed"].includes(value.status) || value.status === "completed" && (!value.page || !Array.isArray(value.page.nodes) || value.page.next_page_token !== undefined && typeof value.page.next_page_token !== "string") || value.status === "failed" && (!value.failure || typeof value.failure.retryable !== "boolean" || typeof value.failure.reason !== "string" || typeof value.failure.message !== "string") || `${wikiDiscoveryPageKey(value)}.json` !== file) {
       throw new WikiDiscoveryError("checkpoint-invalid", false, "Discovery page checkpoint is invalid; preserve it for inspection");
     }
@@ -112528,14 +113009,14 @@ function ownerRunning(pid) {
   }
 }
 async function acquireWikiDiscoveryLease(directory) {
-  const leases = join114(directory, "leases");
+  const leases = join115(directory, "leases");
   await assertWikiDiscoveryPath(directory, leases);
   await mkdir37(leases, { recursive: true });
   for (let attempt = 0;attempt < 8; attempt++) {
     const files = (await readdir28(leases)).filter((file) => /^\d{12}\.json$/u.test(file)).sort();
     const latest = files.at(-1);
     if (latest) {
-      const current2 = await readWikiDiscoveryJson(join114(leases, latest));
+      const current2 = await readWikiDiscoveryJson(join115(leases, latest));
       if (!current2 || !Number.isSafeInteger(current2.pid) || current2.pid <= 0 || typeof current2.token !== "string" || typeof current2.released !== "boolean") {
         throw new WikiDiscoveryError("checkpoint-invalid", false, "Discovery lease is invalid; preserve it for inspection");
       }
@@ -112544,9 +113025,9 @@ async function acquireWikiDiscoveryLease(directory) {
       }
     }
     const sequence = latest ? Number(latest.slice(0, 12)) + 1 : 1;
-    const path3 = join114(leases, `${String(sequence).padStart(12, "0")}.json`);
+    const path3 = join115(leases, `${String(sequence).padStart(12, "0")}.json`);
     const owner = { pid: process.pid, token: randomUUID8(), released: false };
-    const temporary = join114(leases, `.lease-${owner.token}`);
+    const temporary = join115(leases, `.lease-${owner.token}`);
     await writeFile29(temporary, JSON.stringify(owner), { flag: "wx", mode: 384 });
     try {
       await link2(temporary, path3);
@@ -112671,7 +113152,7 @@ async function discoverLarkWiki(input) {
     throw new WikiDiscoveryError("invalid-concurrency", false, "Wiki concurrency must be an integer from 1 to 4");
   }
   const jobId = wikiDiscoveryDigest(url);
-  const directory = join115(input.projectRoot, ".tmp", "context-runtime", "wiki-discovery", jobId);
+  const directory = join116(input.projectRoot, ".tmp", "context-runtime", "wiki-discovery", jobId);
   await assertWikiDiscoveryPath(input.projectRoot, directory);
   await mkdir38(directory, { recursive: true });
   const release = await acquireWikiDiscoveryLease(directory);
@@ -112683,7 +113164,7 @@ async function discoverLarkWiki(input) {
 }
 async function runDiscovery(input, job) {
   const { directory, url, identity: identity2 } = job;
-  const metadataPath = join115(directory, "job.json");
+  const metadataPath = join116(directory, "job.json");
   let metadata = await readWikiDiscoveryJson(metadataPath);
   if (metadata && (metadata.protocol !== "context.wiki-discovery.v1" || metadata.url !== url || metadata.identity !== identity2)) {
     throw new WikiDiscoveryError("job-identity-mismatch", false, "Resume must preserve the discovery's original URL and identity");
@@ -112732,7 +113213,7 @@ async function runDiscovery(input, job) {
       }
       const key = wikiDiscoveryPageKey(cursor);
       try {
-        await saveWikiDiscoveryJson(join115(directory, "pages", `${key}.json`), receipt2);
+        await saveWikiDiscoveryJson(join116(directory, "pages", `${key}.json`), receipt2);
         receipts.set(key, receipt2);
       } catch {
         checkpointError = "A discovery page could not be checkpointed; saved pages remain reusable and unsaved pages must be requested again";
@@ -112750,7 +113231,7 @@ async function finishDiscovery(input, state) {
   const { directory, url, identity: identity2, jobId, metadata, view } = state;
   let checkpointError = state.checkpointError;
   let status = input.signal?.aborted ? "paused" : checkpointError || view.pending.length || view.failed.length || !metadata.root ? "partial" : "completed";
-  const manifestPath = join115(directory, "manifest.json");
+  const manifestPath = join116(directory, "manifest.json");
   try {
     await saveWikiDiscoveryJson(manifestPath, {
       protocol: "context.wiki-discovery.manifest.v1",
@@ -112930,8 +113411,8 @@ init_writeLock();
 var import_yaml51 = __toESM(require_dist(), 1);
 import { existsSync as existsSync31 } from "node:fs";
 import { createHash as createHash36 } from "node:crypto";
-import { readFile as readFile93, readdir as readdir29, rm as rm26 } from "node:fs/promises";
-import { isAbsolute as isAbsolute22, join as join116, relative as relative31, resolve as resolve39, sep as sep10 } from "node:path";
+import { readFile as readFile94, readdir as readdir29, rm as rm26 } from "node:fs/promises";
+import { isAbsolute as isAbsolute22, join as join117, relative as relative31, resolve as resolve39, sep as sep10 } from "node:path";
 function sourceIdentity(source2) {
   if (source2.kind === "source.collection")
     return;
@@ -112963,10 +113444,10 @@ function collectStrings(value, output) {
   }
 }
 async function yamlReferences(input) {
-  const absolutePath = join116(input.projectRoot, input.path);
+  const absolutePath = join117(input.projectRoot, input.path);
   if (!existsSync31(absolutePath))
     return false;
-  const parsed = import_yaml51.default.parse(await readFile93(absolutePath, "utf8"));
+  const parsed = import_yaml51.default.parse(await readFile94(absolutePath, "utf8"));
   const strings = [];
   collectStrings(parsed, strings);
   return strings.some((value) => stringReferencesSource(value, input.source));
@@ -113092,8 +113573,8 @@ async function registryRemovalWrite(projectRoot, source2) {
   const path3 = registryPath2(source2.type);
   if (path3 === null)
     return;
-  const absolutePath = join116(projectRoot, path3);
-  const document4 = existsSync31(absolutePath) ? import_yaml51.default.parse(await readFile93(absolutePath, "utf8")) : { sources: [] };
+  const absolutePath = join117(projectRoot, path3);
+  const document4 = existsSync31(absolutePath) ? import_yaml51.default.parse(await readFile94(absolutePath, "utf8")) : { sources: [] };
   return {
     path: absolutePath,
     bytes: import_yaml51.default.stringify(removeDocumentEntry(document4, source2))
@@ -113111,7 +113592,7 @@ function safeManagedMaterializedPath(projectRoot, source2) {
   return absolute;
 }
 function safeManagedManifestPath(projectRoot, source2) {
-  const manifest = source2.manifest ?? join116(source2.materializedAt, "manifest.json");
+  const manifest = source2.manifest ?? join117(source2.materializedAt, "manifest.json");
   if (isAbsolute22(manifest))
     throw unsafeOwnership(source2, manifest);
   const absolute = resolve39(projectRoot, manifest);
@@ -113240,7 +113721,7 @@ async function createRemovalPlan(projectRoot, selector) {
     source: source2,
     registry: registryPath2(source2.type),
     registryBytes: registryWrite?.bytes ?? null,
-    managedBytes: source2.type === "note" || source2.type === "sessions" ? await readFile93(absoluteRemovals[0], "utf8") : null,
+    managedBytes: source2.type === "note" || source2.type === "sessions" ? await readFile94(absoluteRemovals[0], "utf8") : null,
     references,
     cleanup,
     manifestBytes: manifestWrite?.bytes ?? null
@@ -113273,10 +113754,10 @@ function publicRemovalResult(plan, action) {
   };
 }
 async function pruneExtractRuntime(projectRoot, source2) {
-  const fingerprintPath = join116(projectRoot, ".tmp/context-runtime/extract/source-fingerprints.json");
+  const fingerprintPath = join117(projectRoot, ".tmp/context-runtime/extract/source-fingerprints.json");
   const removedPhaseIds = new Set;
   if (existsSync31(fingerprintPath)) {
-    const parsed = JSON.parse(await readFile93(fingerprintPath, "utf8"));
+    const parsed = JSON.parse(await readFile94(fingerprintPath, "utf8"));
     const phases = parsed.phases ?? {};
     const next2 = Object.fromEntries(Object.entries(phases).filter(([phaseId, raw]) => {
       if (raw === null || typeof raw !== "object" || Array.isArray(raw))
@@ -113290,27 +113771,27 @@ async function pruneExtractRuntime(projectRoot, source2) {
     await atomicWriteFile(fingerprintPath, `${JSON.stringify({ ...parsed, phases: next2 }, null, 2)}
 `);
   }
-  const phaseOwnershipPath = join116(projectRoot, ".tmp/context-runtime/extract/custom-phase-candidates.json");
+  const phaseOwnershipPath = join117(projectRoot, ".tmp/context-runtime/extract/custom-phase-candidates.json");
   if (existsSync31(phaseOwnershipPath) && removedPhaseIds.size > 0) {
-    const parsed = JSON.parse(await readFile93(phaseOwnershipPath, "utf8"));
+    const parsed = JSON.parse(await readFile94(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 = join116(projectRoot, ".tmp/context-runtime/extract/source-symbols.json");
+  const symbolPath = join117(projectRoot, ".tmp/context-runtime/extract/source-symbols.json");
   if (existsSync31(symbolPath)) {
-    const parsed = JSON.parse(await readFile93(symbolPath, "utf8"));
+    const parsed = JSON.parse(await readFile94(symbolPath, "utf8"));
     const symbols = Array.isArray(parsed.symbols) ? parsed.symbols.filter((entry) => entry === null || typeof entry !== "object" || Array.isArray(entry) || entry.source !== source2.name) : [];
     const phaseFingerprints = Object.fromEntries(Object.entries(parsed.phaseFingerprints ?? {}).filter(([phaseId]) => !removedPhaseIds.has(phaseId)));
     await atomicWriteFile(symbolPath, `${JSON.stringify({ ...parsed, phaseFingerprints, symbols }, null, 2)}
 `);
   }
-  const snapshotRoot = join116(projectRoot, ".tmp/context-runtime/extract/candidates");
+  const snapshotRoot = join117(projectRoot, ".tmp/context-runtime/extract/candidates");
   const visit4 = async (directory) => {
     if (!existsSync31(directory))
       return;
     for (const entry of await readdir29(directory, { withFileTypes: true })) {
-      const path3 = join116(directory, entry.name);
+      const path3 = join117(directory, entry.name);
       if (entry.isDirectory()) {
         await visit4(path3);
         continue;
@@ -113318,7 +113799,7 @@ async function pruneExtractRuntime(projectRoot, source2) {
       if (!entry.isFile() || !entry.name.endsWith(".json"))
         continue;
       try {
-        const parsed = JSON.parse(await readFile93(path3, "utf8"));
+        const parsed = JSON.parse(await readFile94(path3, "utf8"));
         const refs = Array.isArray(parsed.source_refs) ? parsed.source_refs : [];
         if (parsed.source === source2.name || refs.some((ref2) => typeof ref2 === "string" && stringReferencesSource(ref2, source2))) {
           await rm26(path3, { force: true });
@@ -113360,7 +113841,7 @@ async function removeProjectSource(input) {
       });
     }
     await applyAtomicFileBatch({
-      transactionRoot: join116(input.projectRoot, ".tmp", "context-runtime", "source-remove-transactions"),
+      transactionRoot: join117(input.projectRoot, ".tmp", "context-runtime", "source-remove-transactions"),
       writes: [...plan.registryWrite === undefined ? [] : [plan.registryWrite], ...plan.manifestWrite !== undefined ? [plan.manifestWrite] : []],
       removals: plan.absoluteRemovals
     });
@@ -113376,7 +113857,7 @@ init_workspace();
 init_writeLock();
 init_durableMultiFileTransaction();
 init_durableSingleFileTransaction();
-import { readFile as readFile94 } from "node:fs/promises";
+import { readFile as readFile95 } from "node:fs/promises";
 import ts from "typescript";
 function generateSourceConfiguration(text10, selected) {
   const file = ts.createSourceFile("index.ts", text10, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
@@ -113516,7 +113997,7 @@ function generateSourceConfiguration(text10, selected) {
 async function configureRegisteredSources(projectRoot, selected) {
   return withProjectWriteLock(projectRoot, "source-project-configuration", async () => {
     const path3 = "src/index.ts";
-    const config = JSON.parse(await readFile94(await safeProjectTarget(projectRoot, "package.json"), "utf8"));
+    const config = JSON.parse(await readFile95(await safeProjectTarget(projectRoot, "package.json"), "utf8"));
     if (config.context?.entry !== path3)
       return {
         status: "manual",
@@ -113525,7 +114006,7 @@ async function configureRegisteredSources(projectRoot, selected) {
         sources: selected
       };
     const target = await safeProjectTarget(projectRoot, path3);
-    const text10 = await readFile94(target, "utf8");
+    const text10 = await readFile95(target, "utf8");
     const updated = generateSourceConfiguration(text10, selected);
     if (updated === undefined)
       return {
@@ -113605,7 +114086,7 @@ async function readIncludeList(projectRoot, path3) {
   }
   let content3;
   try {
-    content3 = await readFile98(isAbsolute23(trimmed) ? resolve41(trimmed) : resolve41(projectRoot, trimmed), "utf8");
+    content3 = await readFile99(isAbsolute23(trimmed) ? resolve41(trimmed) : resolve41(projectRoot, trimmed), "utf8");
   } catch (error) {
     throw new ContextError(ExitCode.UserError, `cannot read include list: ${trimmed}`, {
       category: ErrorCategory.UserInputInvalid,
@@ -114027,7 +114508,7 @@ init_exitCode();
 var import_yaml54 = __toESM(require_dist(), 1);
 import { constants as constants6, existsSync as existsSync32 } from "node:fs";
 import { lstat as lstat16, open as open5, readdir as readdir30 } from "node:fs/promises";
-import { dirname as dirname45, join as join118, resolve as resolve42 } from "node:path";
+import { dirname as dirname45, join as join119, resolve as resolve42 } from "node:path";
 import { fileURLToPath as fileURLToPath9 } from "node:url";
 function bundledSkillRoot() {
   const directory = dirname45(fileURLToPath9(import.meta.url));
@@ -114057,7 +114538,7 @@ async function readProductionSkills(root2) {
   const entries2 = (await readdir30(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 = join118(root2, directory.name, "SKILL.md");
+    const entry = join119(root2, directory.name, "SKILL.md");
     if (!(await lstat16(entry)).isFile())
       throw new TypeError(`Skill entry must be a regular file: ${entry}`);
     const handle3 = await open5(entry, constants6.O_RDONLY | constants6.O_NOFOLLOW | constants6.O_NONBLOCK);
@@ -114465,8 +114946,8 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 import { createHash as createHash37 } from "node:crypto";
-import { cp as cp2, lstat as lstat17, mkdir as mkdir39, mkdtemp as mkdtemp6, readFile as readFile99, readdir as readdir31, rename as rename10, rm as rm27, writeFile as writeFile30 } from "node:fs/promises";
-import { dirname as dirname47, join as join119, resolve as resolve44 } from "node:path";
+import { cp as cp2, lstat as lstat17, mkdir as mkdir39, mkdtemp as mkdtemp6, readFile as readFile100, readdir as readdir31, rename as rename10, rm as rm27, writeFile as writeFile30 } from "node:fs/promises";
+import { dirname as dirname47, join as join120, resolve as resolve44 } from "node:path";
 var MARKER = ".context-skill-install.json";
 function conflict(path3) {
   throw new ContextError(ExitCode.UserError, `Local skill install conflict: ${path3}`, {
@@ -114497,7 +114978,7 @@ async function digest8(root2) {
     for (const name3 of (await readdir31(dir)).sort()) {
       if (!prefix && name3 === MARKER)
         continue;
-      const path3 = join119(dir, name3);
+      const path3 = join120(dir, name3);
       const entry = await lstat17(path3);
       if (entry.isSymbolicLink())
         conflict(path3);
@@ -114505,7 +114986,7 @@ async function digest8(root2) {
       if (entry.isDirectory())
         await visit4(path3, `${prefix}${name3}/`);
       else if (entry.isFile())
-        hash4.update(await readFile99(path3));
+        hash4.update(await readFile100(path3));
       else
         conflict(path3);
     }
@@ -114517,31 +114998,31 @@ async function installLocalSkills(root2, path3, dryRun, agent) {
   if (!path3.trim())
     conflict("--local requires a non-empty path");
   const targetRoot = resolve44(path3);
-  const skillsRoot = join119(targetRoot, "skills");
+  const skillsRoot = join120(targetRoot, "skills");
   await checkParents(skillsRoot);
-  const sourceRoot2 = join119(root2, "skills");
+  const sourceRoot2 = join120(root2, "skills");
   const commandPlans = [];
   const commandEntries = new Set;
   if (agent === "claude" || agent === "cursor") {
-    for (const name3 of await readdir31(join119(root2, "claude", "commands"))) {
+    for (const name3 of await readdir31(join120(root2, "claude", "commands"))) {
       if (name3.endsWith(".md"))
         commandEntries.add(name3.slice(0, -3));
     }
-    const commandsRoot = join119(targetRoot, "commands");
+    const commandsRoot = join120(targetRoot, "commands");
     await checkParents(commandsRoot);
-    for (const entry of await readdir31(join119(root2, agent, "commands"), { withFileTypes: true })) {
+    for (const entry of await readdir31(join120(root2, agent, "commands"), { withFileTypes: true })) {
       if (!entry.isFile() || !entry.name.endsWith(".md"))
         continue;
-      let content3 = await readFile99(join119(root2, agent, "commands", entry.name), "utf8");
+      let content3 = await readFile100(join120(root2, agent, "commands", entry.name), "utf8");
       if (agent === "claude" && entry.name !== "context-plan.md") {
         const frontmatter2 = /^(---\r?\n)([\s\S]*?)(\r?\n---(?:\r?\n|$))/.exec(content3);
         if (!frontmatter2)
-          conflict(join119(root2, agent, "commands", entry.name));
+          conflict(join120(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 = join119(commandsRoot, entry.name);
-      const marker = join119(commandsRoot, `.context-${entry.name}.json`);
+      const target = join120(commandsRoot, entry.name);
+      const marker = join120(commandsRoot, `.context-${entry.name}.json`);
       for (const file of [target, marker]) {
         const existing = await stat11(file);
         if (existing && (!existing.isFile() || existing.isSymbolicLink()))
@@ -114550,11 +115031,11 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
       if (await stat11(target)) {
         let previous3;
         try {
-          previous3 = JSON.parse(await readFile99(marker, "utf8"));
+          previous3 = JSON.parse(await readFile100(marker, "utf8"));
         } catch {
           conflict(target);
         }
-        const current2 = createHash37("sha256").update(await readFile99(target)).digest("hex");
+        const current2 = createHash37("sha256").update(await readFile100(target)).digest("hex");
         if (previous3?.owner !== "context-plugin-local" || previous3.digest !== current2)
           conflict(target);
       } else if (await stat11(marker))
@@ -114562,14 +115043,14 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
       commandPlans.push({ name: entry.name, target, marker, content: content3, hash: createHash37("sha256").update(content3).digest("hex") });
     }
     if (!commandPlans.length)
-      conflict(join119(root2, agent, "commands"));
+      conflict(join120(root2, agent, "commands"));
   }
   const plans = [];
   for (const entry of (await readdir31(sourceRoot2, { withFileTypes: true })).sort((a, b) => a.name.localeCompare(b.name))) {
-    if (!entry.isDirectory() || !await stat11(join119(sourceRoot2, entry.name, "SKILL.md")))
+    if (!entry.isDirectory() || !await stat11(join120(sourceRoot2, entry.name, "SKILL.md")))
       continue;
-    const source2 = join119(sourceRoot2, entry.name);
-    const target = join119(skillsRoot, entry.name);
+    const source2 = join120(sourceRoot2, entry.name);
+    const target = join120(skillsRoot, entry.name);
     if (commandEntries.has(entry.name) && entry.name !== "context-plan") {
       if (await stat11(target))
         conflict(`${target} (use a fresh host directory to avoid duplicate command/skill entries)`);
@@ -114579,12 +115060,12 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
     if (existing) {
       if (!existing.isDirectory() || existing.isSymbolicLink())
         conflict(target);
-      const markerPath = join119(target, MARKER);
+      const markerPath = join120(target, MARKER);
       if (!(await stat11(markerPath))?.isFile())
         conflict(target);
       let marker;
       try {
-        marker = JSON.parse(await readFile99(markerPath, "utf8"));
+        marker = JSON.parse(await readFile100(markerPath, "utf8"));
       } catch {
         conflict(target);
       }
@@ -114598,15 +115079,15 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
   if (!dryRun) {
     await mkdir39(skillsRoot, { recursive: true });
     for (const plan of plans) {
-      const staging = await mkdtemp6(join119(skillsRoot, ".context-install-"));
-      const candidate = join119(staging, "candidate");
-      const previous3 = join119(staging, "previous");
+      const staging = await mkdtemp6(join120(skillsRoot, ".context-install-"));
+      const candidate = join120(staging, "candidate");
+      const previous3 = join120(staging, "previous");
       let moved = false;
       try {
         await cp2(plan.source, candidate, { recursive: true });
         if (agent === "claude" || agent === "cursor" && plan.name === "context-plan") {
-          const skillFile = join119(candidate, "SKILL.md");
-          const content3 = await readFile99(skillFile, "utf8");
+          const skillFile = join120(candidate, "SKILL.md");
+          const content3 = await readFile100(skillFile, "utf8");
           const parts = /^(---\r?\n)([\s\S]*?)(\r?\n---(?:\r?\n|$))/.exec(content3);
           if (parts && (plan.name === "context-plan" || /^\s*context-public-entry:\s*["']?false["']?\s*$/mu.test(parts[2]))) {
             const frontmatter2 = parts[2].replace(/^user-invocable:.*\r?\n?/mu, "");
@@ -114614,7 +115095,7 @@ ${frontmatter2[2].replace(/^disable-model-invocation:.*\r?\n?/mu, "")}${frontmat
 ${frontmatter2}${parts[3]}${content3.slice(parts[0].length)}`);
           }
         }
-        await writeFile30(join119(candidate, MARKER), JSON.stringify({ owner: "context-plugin-local", digest: await digest8(candidate) }) + `
+        await writeFile30(join120(candidate, MARKER), JSON.stringify({ owner: "context-plugin-local", digest: await digest8(candidate) }) + `
 `);
         if (plan.exists) {
           await rename10(plan.target, previous3);
@@ -114638,12 +115119,12 @@ ${frontmatter2}${parts[3]}${content3.slice(parts[0].length)}`);
     }
     for (const command3 of commandPlans) {
       await mkdir39(dirname47(command3.target), { recursive: true });
-      const staging = await mkdtemp6(join119(dirname47(command3.target), ".context-install-"));
-      await writeFile30(join119(staging, "command"), command3.content);
-      await writeFile30(join119(staging, "marker"), JSON.stringify({ owner: "context-plugin-local", digest: command3.hash }) + `
+      const staging = await mkdtemp6(join120(dirname47(command3.target), ".context-install-"));
+      await writeFile30(join120(staging, "command"), command3.content);
+      await writeFile30(join120(staging, "marker"), JSON.stringify({ owner: "context-plugin-local", digest: command3.hash }) + `
 `);
-      await rename10(join119(staging, "command"), command3.target);
-      await rename10(join119(staging, "marker"), command3.marker);
+      await rename10(join120(staging, "command"), command3.target);
+      await rename10(join120(staging, "marker"), command3.marker);
       await rm27(staging, { recursive: true, force: true });
     }
   }
@@ -114667,10 +115148,10 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 import { lstat as lstat18 } from "node:fs/promises";
-import { join as join120, resolve as resolve45 } from "node:path";
+import { join as join121, resolve as resolve45 } from "node:path";
 var HOST_DIRS = { claude: ".claude", cursor: ".cursor", codex: ".agents" };
 async function detectLocalAgent(agent, repo) {
-  const path3 = join120(repo, HOST_DIRS[agent]);
+  const path3 = join121(repo, HOST_DIRS[agent]);
   try {
     const entry = await lstat18(path3);
     if (!entry.isDirectory() || entry.isSymbolicLink()) {
@@ -114695,7 +115176,7 @@ async function installAutoLocalSkills(root2, path3, dryRun, detect = detectLocal
     if (selectedAgent ? selectedAgent === "all" || agent === selectedAgent : await detect(agent, repo))
       agents.push(agent);
   }
-  const targets = agents.length ? agents.map((agent) => ({ agent, path: join120(repo, HOST_DIRS[agent]) })) : [{ path: join120(repo, ".agents") }];
+  const targets = agents.length ? agents.map((agent) => ({ agent, path: join121(repo, HOST_DIRS[agent]) })) : [{ path: join121(repo, ".agents") }];
   const previews = [];
   for (const target of targets)
     previews.push(await installLocalSkills(root2, target.path, true, target.agent));
@@ -114728,7 +115209,7 @@ init_cliFeedback();
 init_errors3();
 init_exitCode();
 import { existsSync as existsSync35 } from "node:fs";
-import { dirname as dirname49, join as join122, resolve as resolve46 } from "node:path";
+import { dirname as dirname49, join as join123, resolve as resolve46 } from "node:path";
 import { fileURLToPath as fileURLToPath10 } from "node:url";
 
 // src/project/pluginInstallTargets.ts
@@ -114737,9 +115218,9 @@ init_errors3();
 init_exitCode();
 import { execFile as execFile13 } from "node:child_process";
 import { existsSync as existsSync34 } from "node:fs";
-import { cp as cp3, mkdir as mkdir40, readdir as readdir32, readFile as readFile100, rename as rename11, rm as rm28, writeFile as writeFile31 } from "node:fs/promises";
+import { cp as cp3, mkdir as mkdir40, readdir as readdir32, readFile as readFile101, rename as rename11, rm as rm28, writeFile as writeFile31 } from "node:fs/promises";
 import { homedir as homedir2 } from "node:os";
-import { dirname as dirname48, join as join121 } from "node:path";
+import { dirname as dirname48, join as join122 } from "node:path";
 import { promisify as promisify13 } from "node:util";
 var execFileAsync7 = promisify13(execFile13);
 var MARKETPLACE_NAME = "c4a";
@@ -114793,23 +115274,23 @@ async function claudePluginInstalled(pluginId) {
   }
 }
 function codexHome() {
-  return process.env.CODEX_HOME?.trim() || join121(homedir2(), ".codex");
+  return process.env.CODEX_HOME?.trim() || join122(homedir2(), ".codex");
 }
 function claudePluginCacheRoot() {
   const explicitRoot = process.env[CLAUDE_PLUGIN_CACHE_ROOT_ENV2]?.trim();
   if (explicitRoot)
     return explicitRoot;
   const home = process.env[CLAUDE_PLUGIN_CACHE_HOME_ENV2]?.trim() || homedir2();
-  return join121(home, ".claude", "plugins", "cache");
+  return join122(home, ".claude", "plugins", "cache");
 }
 function sharedSkillsRoot() {
-  return process.env[SHARED_SKILLS_ROOT_ENV]?.trim() || join121(homedir2(), ".agents", "skills");
+  return process.env[SHARED_SKILLS_ROOT_ENV]?.trim() || join122(homedir2(), ".agents", "skills");
 }
 function claudeSkillsRoot() {
-  return process.env[CLAUDE_SKILLS_ROOT_ENV]?.trim() || join121(homedir2(), ".claude", "skills");
+  return process.env[CLAUDE_SKILLS_ROOT_ENV]?.trim() || join122(homedir2(), ".claude", "skills");
 }
 function cursorPluginRoot() {
-  return process.env[CURSOR_PLUGIN_ROOT_ENV]?.trim() || join121(homedir2(), ".cursor", "plugins", "local", PLUGIN_NAME);
+  return process.env[CURSOR_PLUGIN_ROOT_ENV]?.trim() || join122(homedir2(), ".cursor", "plugins", "local", PLUGIN_NAME);
 }
 function blockHeader(line) {
   const match = line.match(/^\s*\[([^\]]+)\]\s*$/u);
@@ -114860,8 +115341,8 @@ function pruneLegacyCodexConfigContent(content3) {
 `), removed };
 }
 async function pruneLegacyCodexConfig(dryRun, steps) {
-  const configPath = join121(codexHome(), "config.toml");
-  const current2 = await readFile100(configPath, "utf8").catch(() => "");
+  const configPath = join122(codexHome(), "config.toml");
+  const current2 = await readFile101(configPath, "utf8").catch(() => "");
   if (!current2)
     return;
   const next2 = pruneLegacyCodexConfigContent(current2);
@@ -114877,7 +115358,7 @@ async function pruneLegacyCodexConfig(dryRun, steps) {
   }
 }
 async function pruneCodexPluginCacheForName(pluginName, keepVersion, dryRun, steps) {
-  const cacheRoot = join121(codexHome(), "plugins", "cache", MARKETPLACE_NAME, pluginName);
+  const cacheRoot = join122(codexHome(), "plugins", "cache", MARKETPLACE_NAME, pluginName);
   if (!existsSync34(cacheRoot))
     return;
   const versions = (await readdir32(cacheRoot, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory() && entry.name !== keepVersion).map((entry) => entry.name).sort();
@@ -114889,7 +115370,7 @@ async function pruneCodexPluginCacheForName(pluginName, keepVersion, dryRun, ste
     status: dryRun ? "planned" : "ran"
   });
   if (!dryRun)
-    await Promise.all(versions.map((version3) => rm28(join121(cacheRoot, version3), { recursive: true, force: true })));
+    await Promise.all(versions.map((version3) => rm28(join122(cacheRoot, version3), { recursive: true, force: true })));
 }
 async function pruneCodexPluginCache(currentVersion, dryRun, steps) {
   await pruneCodexPluginCacheForName(PLUGIN_NAME, currentVersion, dryRun, steps);
@@ -114913,15 +115394,15 @@ async function pruneClaudeOrphanContextCache(dryRun, steps) {
   for (const marketplace of marketplaces) {
     if (!marketplace.isDirectory())
       continue;
-    const pluginDir = join121(cacheRoot, marketplace.name, PLUGIN_NAME);
+    const pluginDir = join122(cacheRoot, marketplace.name, PLUGIN_NAME);
     if (!existsSync34(pluginDir))
       continue;
     const versions = await readdir32(pluginDir, { withFileTypes: true }).catch(() => []);
     for (const version3 of versions) {
       if (!version3.isDirectory())
         continue;
-      const versionDir = join121(pluginDir, version3.name);
-      if (!existsSync34(join121(versionDir, ORPHAN_MARKER2)))
+      const versionDir = join122(pluginDir, version3.name);
+      if (!existsSync34(join122(versionDir, ORPHAN_MARKER2)))
         continue;
       removed.push(`${marketplace.name}/${PLUGIN_NAME}/${version3.name}`);
       if (!dryRun) {
@@ -114931,7 +115412,7 @@ async function pruneClaudeOrphanContextCache(dryRun, steps) {
     if (!dryRun && await isEmptyDir2(pluginDir)) {
       await rm28(pluginDir, { recursive: true, force: true });
     }
-    const marketplaceDir = join121(cacheRoot, marketplace.name);
+    const marketplaceDir = join122(cacheRoot, marketplace.name);
     if (!dryRun && await isEmptyDir2(marketplaceDir)) {
       await rm28(marketplaceDir, { recursive: true, force: true });
     }
@@ -114952,7 +115433,7 @@ async function pruneClaudeLegacyPluginCache(dryRun, steps) {
     return;
   const removed = [];
   for (const pluginName of LEGACY_PLUGIN_NAMES) {
-    const pluginDir = join121(cacheRoot, MARKETPLACE_NAME, pluginName);
+    const pluginDir = join122(cacheRoot, MARKETPLACE_NAME, pluginName);
     if (!existsSync34(pluginDir))
       continue;
     removed.push(`${MARKETPLACE_NAME}/${pluginName}`);
@@ -114969,11 +115450,11 @@ async function pruneClaudeLegacyPluginCache(dryRun, steps) {
   }
 }
 async function pruneClaudeSupersededContextCache(root2, dryRun, steps) {
-  const manifest = await readFile100(join121(root2, "claude", ".claude-plugin", "plugin.json"), "utf8").then((content3) => JSON.parse(content3)).catch(() => null);
+  const manifest = await readFile101(join122(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 = join121(claudePluginCacheRoot(), MARKETPLACE_NAME, PLUGIN_NAME);
+  const pluginDir = join122(claudePluginCacheRoot(), MARKETPLACE_NAME, PLUGIN_NAME);
   const staleVersions = (await readdir32(pluginDir, { withFileTypes: true }).catch(() => [])).filter((entry) => entry.isDirectory() && entry.name !== currentVersion).map((entry) => entry.name);
   if (staleVersions.length === 0)
     return;
@@ -114983,7 +115464,7 @@ async function pruneClaudeSupersededContextCache(root2, dryRun, steps) {
     status: dryRun ? "planned" : "ran"
   });
   if (!dryRun) {
-    await Promise.all(staleVersions.map((version3) => rm28(join121(pluginDir, version3), { recursive: true, force: true })));
+    await Promise.all(staleVersions.map((version3) => rm28(join122(pluginDir, version3), { recursive: true, force: true })));
   }
 }
 function enableCodexPluginConfig(content3) {
@@ -115047,33 +115528,33 @@ source = ${JSON.stringify(root2)}
 `;
 }
 async function ensureCodexPluginEnabled() {
-  const configPath = join121(codexHome(), "config.toml");
+  const configPath = join122(codexHome(), "config.toml");
   await mkdir40(dirname48(configPath), { recursive: true });
-  const current2 = await readFile100(configPath, "utf8").catch(() => "");
+  const current2 = await readFile101(configPath, "utf8").catch(() => "");
   const next2 = enableCodexPluginConfig(current2);
   if (next2 !== current2) {
     await writeFile31(configPath, next2, "utf8");
   }
 }
 async function ensureCodexLocalMarketplace(root2) {
-  const configPath = join121(codexHome(), "config.toml");
+  const configPath = join122(codexHome(), "config.toml");
   await mkdir40(dirname48(configPath), { recursive: true });
-  const current2 = await readFile100(configPath, "utf8").catch(() => "");
+  const current2 = await readFile101(configPath, "utf8").catch(() => "");
   const next2 = upsertCodexLocalMarketplaceConfig(current2, root2);
   if (next2 !== current2) {
     await writeFile31(configPath, next2, "utf8");
   }
 }
 async function codexPluginVersion(root2) {
-  const manifestPath = join121(root2, "codex", ".codex-plugin", "plugin.json");
-  const manifest = JSON.parse(await readFile100(manifestPath, "utf8"));
+  const manifestPath = join122(root2, "codex", ".codex-plugin", "plugin.json");
+  const manifest = JSON.parse(await readFile101(manifestPath, "utf8"));
   if (typeof manifest.version !== "string" || !/^[A-Za-z0-9][A-Za-z0-9._-]*$/u.test(manifest.version)) {
     throw new Error(`Codex plugin manifest has an invalid version: ${manifestPath}`);
   }
   return manifest.version;
 }
 function codexPluginCacheDir(version3) {
-  return join121(codexHome(), "plugins", "cache", MARKETPLACE_NAME, PLUGIN_NAME, version3);
+  return join122(codexHome(), "plugins", "cache", MARKETPLACE_NAME, PLUGIN_NAME, version3);
 }
 async function replaceDirectoryFromSource(source2, target) {
   await mkdir40(dirname48(target), { recursive: true });
@@ -115096,7 +115577,7 @@ async function replaceDirectoryFromSource(source2, target) {
   }
 }
 async function materializeCodexPluginCache(root2, version3, dryRun, steps) {
-  const source2 = join121(root2, "codex");
+  const source2 = join122(root2, "codex");
   const target = codexPluginCacheDir(version3);
   steps.push({
     agent: "codex",
@@ -115108,16 +115589,16 @@ async function materializeCodexPluginCache(root2, version3, dryRun, steps) {
   await replaceDirectoryFromSource(source2, target);
 }
 async function bundledProviderSkillNames(root2) {
-  const skillsRoot = join121(root2, "skills");
+  const skillsRoot = join122(root2, "skills");
   const entries2 = await readdir32(skillsRoot, { withFileTypes: true });
   const names = [];
   for (const entry of entries2) {
     if (!entry.isDirectory() || entry.name === "context")
       continue;
-    const skillPath = join121(skillsRoot, entry.name, "SKILL.md");
+    const skillPath = join122(skillsRoot, entry.name, "SKILL.md");
     if (!existsSync34(skillPath))
       continue;
-    const skill = await readFile100(skillPath, "utf8");
+    const skill = await readFile101(skillPath, "utf8");
     if (!/^\s*context-role:\s*["']?indexer-provider["']?\s*$/mu.test(skill))
       continue;
     names.push(entry.name);
@@ -115129,10 +115610,10 @@ async function bundledProviderSkillNames(root2) {
   return names;
 }
 async function materializeProviderSkills(root2, targetRoot, agent, dryRun, steps) {
-  const sourceRoot2 = join121(root2, "skills");
+  const sourceRoot2 = join122(root2, "skills");
   for (const name3 of await bundledProviderSkillNames(root2)) {
-    const source2 = join121(sourceRoot2, name3);
-    const target = join121(targetRoot, name3);
+    const source2 = join122(sourceRoot2, name3);
+    const target = join122(targetRoot, name3);
     steps.push({
       agent,
       command: `materialize lifecycle Provider skill: ${shellQuote8(source2)} -> ${shellQuote8(target)}`,
@@ -115143,7 +115624,7 @@ async function materializeProviderSkills(root2, targetRoot, agent, dryRun, steps
   }
 }
 async function installCursor(root2, dryRun, steps) {
-  const source2 = join121(root2, "cursor");
+  const source2 = join122(root2, "cursor");
   const target = cursorPluginRoot();
   steps.push({
     agent: "cursor",
@@ -115198,12 +115679,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(join121(codexHome(), "config.toml"))} registers local marketplace ${shellQuote8(MARKETPLACE_NAME)}`,
+    command: `ensure ${shellQuote8(join122(codexHome(), "config.toml"))} registers local marketplace ${shellQuote8(MARKETPLACE_NAME)}`,
     status: dryRun ? "planned" : "ran"
   });
   steps.push({
     agent: "codex",
-    command: `ensure ${shellQuote8(join121(codexHome(), "config.toml"))} enables ${shellQuote8(PLUGIN_ID)}`,
+    command: `ensure ${shellQuote8(join122(codexHome(), "config.toml"))} enables ${shellQuote8(PLUGIN_ID)}`,
     status: dryRun ? "planned" : "ran"
   });
   if (dryRun) {
@@ -115258,13 +115739,13 @@ function pluginRootCandidates() {
     return [resolve46(envRoot)];
   const candidates = [];
   for (const dir of packageCandidateDirs()) {
-    candidates.push(join122(dir, "plugins"));
-    candidates.push(join122(dir, "dist", "plugins"));
+    candidates.push(join123(dir, "plugins"));
+    candidates.push(join123(dir, "dist", "plugins"));
   }
   return [...new Set(candidates)];
 }
 function isInstallablePluginRoot(root2) {
-  return existsSync35(join122(root2, ".claude-plugin", "marketplace.json")) && existsSync35(join122(root2, ".agents", "plugins", "marketplace.json")) && existsSync35(join122(root2, "claude", ".claude-plugin", "plugin.json")) && existsSync35(join122(root2, "codex", ".codex-plugin", "plugin.json")) && existsSync35(join122(root2, "cursor", ".cursor-plugin", "plugin.json")) && existsSync35(join122(root2, "skills"));
+  return existsSync35(join123(root2, ".claude-plugin", "marketplace.json")) && existsSync35(join123(root2, ".agents", "plugins", "marketplace.json")) && existsSync35(join123(root2, "claude", ".claude-plugin", "plugin.json")) && existsSync35(join123(root2, "codex", ".codex-plugin", "plugin.json")) && existsSync35(join123(root2, "cursor", ".cursor-plugin", "plugin.json")) && existsSync35(join123(root2, "skills"));
 }
 function resolveBundledPluginsRoot() {
   const candidates = pluginRootCandidates();
@@ -115511,10 +115992,10 @@ function readQuickstartPath() {
   try {
     let dir = dirname50(fileURLToPath11(import.meta.url));
     for (let i2 = 0;i2 < 8; i2++) {
-      const candidate = join123(dir, "docs", "quickstart.md");
+      const candidate = join124(dir, "docs", "quickstart.md");
       if (existsSync36(candidate))
         return candidate;
-      const pkg = join123(dir, "package.json");
+      const pkg = join124(dir, "package.json");
       if (existsSync36(pkg))
         return candidate;
       const parent = dirname50(dir);
@@ -115523,7 +116004,7 @@ function readQuickstartPath() {
       dir = parent;
     }
   } catch {}
-  return join123(dirname50(fileURLToPath11(import.meta.url)), "docs", "quickstart.md");
+  return join124(dirname50(fileURLToPath11(import.meta.url)), "docs", "quickstart.md");
 }
 var GREEN = "\x1B[32m";
 var RESET = "\x1B[0m";
@@ -115653,7 +116134,7 @@ function createCliProgram() {
       format: options.format === "json" ? "json" : "text"
     });
   });
-  review.command("apply <payload-file>").description("Apply a copied review code (all segments in one file) or JSON/JSONL decisions").option("--format <format>", "output format: text | json", "text").action(async (payloadInput, options) => {
+  review.command("apply <payload-file>").description("Apply scoped JSON/JSONL decisions and revision instructions").option("--format <format>", "output format: text | json", "text").action(async (payloadInput, options) => {
     if (options.format !== "text" && options.format !== "json") {
       throw new ContextError(ExitCode.UserError, "--format must be text or json", {
         category: ErrorCategory.UserInputInvalid
@@ -115674,7 +116155,7 @@ function createCliProgram() {
       })
     });
   });
-  review.command("approve-all [collection]").description("Approve the complete current review scope under explicit managed or user force authority").option("--all", "approve all current draft candidates across internal collections").option("--managed", "assert explicit current-conversation managed approval").option("--force", "assert the user's explicit current-conversation force approval").option("--verbose", "include candidate ids and materialized page paths in JSON output").option("--format <format>", "output format: text | json", "text").action(async (collection, options) => {
+  review.command("approve-all [collection]").description("Approve the complete current review scope under explicit managed authority or user confirmation").option("--all", "approve all current draft candidates across internal collections").option("--managed", "assert explicit current-conversation managed approval").option("--force", "deprecated compatibility flag; use --confirmed for user approval").option("--confirmed", "apply explicit user confirmation to the current report scope").option("--verbose", "include candidate ids and materialized page paths in JSON output").option("--format <format>", "output format: text | json", "text").action(async (collection, options) => {
     if (options.format !== "text" && options.format !== "json") {
       throw new ContextError(ExitCode.UserError, "--format must be text or json", {
         category: ErrorCategory.UserInputInvalid
@@ -115685,6 +116166,7 @@ function createCliProgram() {
       ...collection !== undefined ? { collection } : {},
       ...options.all === true ? { all: true } : {},
       managed: options.managed === true,
+      confirmed: options.confirmed === true,
       force: options.force === true,
       verbose: options.verbose === true,
       format: options.format === "json" ? "json" : "text",