@iowarp/clio-coder 0.4.4 → 0.4.5

package/dist/{chunk-ELZVTCGV.js → chunk-LVFANMOH.js}

@@ -1,18 +1,22 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
-  computeFingerprint,
-  computeFingerprintAsync
-} from "./chunk-UUVG37B4.js";
+  createSlicer
+} from "./chunk-KPRLAMP4.js";
+import {
+  WORKSPACE_EXCLUDED_DIRS,
+  enumerateWorkspaceFiles,
+  enumerateWorkspaceFilesAsync
+} from "./chunk-PPEZJWUG.js";
 import {
   require_dist
-} from "./chunk-APJ265NV.js";
+} from "./chunk-B5GGDIHT.js";
 import {
   safeResourceWrite
-} from "./chunk-WEPFGWHJ.js";
+} from "./chunk-ZZFWWYLX.js";
 import {
   __toESM,
   init_esm_shims
-} from "./chunk-3R73A4XB.js";
+} from "./chunk-ECBHH7LU.js";
 
 // src/domains/context/wiki/frontmatter.ts
 init_esm_shims();
@@ -195,7 +199,91 @@ function listWikiPages(cwd) {
 // src/domains/context/wiki/plan-store.ts
 init_esm_shims();
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { join as join4 } from "node:path";
+
+// src/domains/context/wiki/source-content.ts
+init_esm_shims();
+import { createHash } from "node:crypto";
+import { closeSync, constants, fstatSync, openSync, readSync } from "node:fs";
 import { join as join3 } from "node:path";
+var MAX_FILES = 2e4;
+var MAX_BYTES = 128 * 1024 * 1024;
+function parseWikiSourceContent(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const entries = Object.entries(value);
+  if (entries.length > MAX_FILES) return void 0;
+  if (entries.some(([path, hash]) => !path || hash !== null && (typeof hash !== "string" || !/^[a-f0-9]{64}$/.test(hash))))
+    return void 0;
+  return Object.fromEntries(entries);
+}
+function capture(cwd, files) {
+  const content = /* @__PURE__ */ Object.create(null);
+  let remainingBytes = MAX_BYTES;
+  const buffer = Buffer.alloc(64 * 1024);
+  return {
+    content,
+    add(path) {
+      if (files.length > MAX_FILES) return;
+      let fd;
+      content[path] = null;
+      try {
+        fd = openSync(join3(cwd, path), constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+        const before = fstatSync(fd);
+        if (!before.isFile() || before.size > remainingBytes) return;
+        remainingBytes -= before.size;
+        const hash = createHash("sha256");
+        let remaining = before.size;
+        while (remaining > 0) {
+          const count = readSync(fd, buffer, 0, Math.min(buffer.length, remaining), null);
+          if (count === 0) return;
+          hash.update(buffer.subarray(0, count));
+          remaining -= count;
+        }
+        const after = fstatSync(fd);
+        if (after.size === before.size && after.mtimeMs === before.mtimeMs && after.ctimeMs === before.ctimeMs)
+          content[path] = hash.digest("hex");
+      } catch {
+      } finally {
+        if (fd !== void 0) closeSync(fd);
+      }
+    }
+  };
+}
+function captureWikiSourceContent(cwd) {
+  try {
+    const files = enumerateWorkspaceFiles(cwd, WORKSPACE_EXCLUDED_DIRS);
+    const snapshot = capture(cwd, files);
+    for (const path of files) snapshot.add(path);
+    return snapshot.content;
+  } catch {
+    return {};
+  }
+}
+async function captureWikiSourceContentAsync(cwd) {
+  try {
+    const slicer = createSlicer();
+    const files = await enumerateWorkspaceFilesAsync(cwd, WORKSPACE_EXCLUDED_DIRS, void 0, slicer);
+    const snapshot = capture(cwd, files);
+    for (const path of files) {
+      snapshot.add(path);
+      await slicer.tick();
+    }
+    return snapshot.content;
+  } catch {
+    return {};
+  }
+}
+function wikiSourcesMatch(previous, current, sources) {
+  if (!previous || Object.keys(previous).length === 0 || Object.keys(current).length === 0) return false;
+  const claimed = sources?.map((path) => path.replace(/\\/g, "/").replace(/^\.\//, "").replace(/\/$/, ""));
+  const paths = [.../* @__PURE__ */ new Set([...Object.keys(previous), ...Object.keys(current)])].filter(
+    (path) => !claimed || claimed.some((source) => path === source || path.startsWith(`${source}/`))
+  );
+  if (claimed?.some((source) => !paths.some((path) => path === source || path.startsWith(`${source}/`)))) return false;
+  return paths.length > 0 && paths.every((path) => previous[path] != null && previous[path] === current[path]);
+}
+
+// src/domains/context/wiki/plan-store.ts
 var MAX_PAGE_ATTEMPTS = 3;
 var MAX_INTENT_CHARS = 600;
 var MAX_PLAN_PAGES = 200;
@@ -228,7 +316,7 @@ function sanitizePagePath(value) {
   return normalized;
 }
 function wikiPlanPath(dir) {
-  return join3(dir, WIKI_PLAN_FILE);
+  return join4(dir, WIKI_PLAN_FILE);
 }
 function parsedStatus(value) {
   return value === "written" || value === "pending" ? value : null;
@@ -236,6 +324,15 @@ function parsedStatus(value) {
 function parsedAttempts(value) {
   return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : null;
 }
+function parsedFailure(value) {
+  if (!isRecord2(value)) return void 0;
+  const phase = value.phase;
+  if (phase !== "admission" && phase !== "writer" && phase !== "validation") return void 0;
+  const detail = usableString2(value.detail)?.replace(/\s+/gu, " ").slice(0, 500);
+  if (!detail) return void 0;
+  const runId = usableString2(value.runId)?.slice(0, 120);
+  return { phase, detail, ...runId ? { runId } : {} };
+}
 function sanitizeWikiPlan(value, previous, options = { trustStatus: true }) {
   if (!isRecord2(value) || !Array.isArray(value.pages)) return null;
   const priorByPath = new Map((previous?.pages ?? []).map((page) => [page.path, page]));
@@ -246,22 +343,50 @@ function sanitizeWikiPlan(value, previous, options = { trustStatus: true }) {
     if (!isRecord2(entry)) continue;
     const path = sanitizePagePath(entry.path);
     if (path === null || seen.has(path)) continue;
-    const intent = usableString2(entry.intent);
+    const intent = (usableString2(entry.intent) ?? "").slice(0, MAX_INTENT_CHARS);
+    const title = usableString2(entry.title) ?? path.replace(/\.md$/, "");
+    const sources = stringList2(entry.sources, 16);
     const prior = priorByPath.get(path);
+    const changedSpec = prior !== void 0 && (prior.title !== title || prior.intent !== intent || JSON.stringify([...prior.sources].sort()) !== JSON.stringify([...sources].sort()));
     const recorded = options.trustStatus ? parsedStatus(entry.status) : null;
     const recordedAttempts = options.trustStatus ? parsedAttempts(entry.attempts) : null;
+    const lastFailure = prior?.lastFailure ?? (options.trustStatus ? parsedFailure(entry.lastFailure) : void 0);
+    const dependencies = prior?.dependencies ?? (options.trustStatus ? stringList2(entry.dependencies, Number.POSITIVE_INFINITY) : []);
     seen.add(path);
     pages.push({
       path,
-      title: usableString2(entry.title) ?? path.replace(/\.md$/, ""),
-      intent: intent === null ? "" : intent.slice(0, MAX_INTENT_CHARS),
-      sources: stringList2(entry.sources, 16),
-      status: prior?.status ?? recorded ?? "pending",
-      attempts: prior?.attempts ?? recordedAttempts ?? 0
+      title,
+      intent,
+      sources,
+      ...dependencies.length > 0 ? { dependencies } : {},
+      status: changedSpec ? "pending" : prior?.status ?? recorded ?? "pending",
+      attempts: changedSpec ? 0 : prior?.attempts ?? recordedAttempts ?? 0,
+      ...!changedSpec && (prior?.status ?? recorded) !== "written" && lastFailure ? { lastFailure } : {}
     });
   }
   if (pages.length === 0) return null;
-  return { version: 1, overview: usableString2(value.overview) ?? previous?.overview ?? "", pages };
+  const retiredPages = [
+    .../* @__PURE__ */ new Set([
+      ...previous?.retiredPages ?? (options.trustStatus ? stringList2(value.retiredPages, MAX_PLAN_PAGES) : []),
+      ...previous?.pages.filter((page) => !seen.has(page.path)).map((page) => page.path) ?? []
+    ])
+  ].map(sanitizePagePath).filter((path) => path !== null && !seen.has(path));
+  const sourceContent = previous?.sourceContent ?? (options.trustStatus ? parseWikiSourceContent(value.sourceContent) : void 0);
+  const sourceTreeHash = previous?.sourceTreeHash ?? (options.trustStatus ? value.sourceTreeHash : void 0);
+  const sourceGitHead = previous?.sourceGitHead ?? (options.trustStatus ? value.sourceGitHead : void 0);
+  const depth = previous?.depth ?? (options.trustStatus ? value.depth : void 0);
+  const requestedDepth = previous?.requestedDepth ?? (options.trustStatus ? value.requestedDepth : void 0);
+  return {
+    version: 1,
+    ...depth === "simple" || depth === "medium" || depth === "detailed" ? { depth } : {},
+    ...requestedDepth === "auto" || requestedDepth === "simple" || requestedDepth === "medium" || requestedDepth === "detailed" ? { requestedDepth } : {},
+    ...sourceContent ? { sourceContent } : {},
+    ...retiredPages.length ? { retiredPages } : {},
+    ...typeof sourceTreeHash === "string" && /^[a-f0-9]{64}$/.test(sourceTreeHash) ? { sourceTreeHash } : {},
+    ...typeof sourceGitHead === "string" && /^(?:[a-f0-9]{40}|[a-f0-9]{64})$/.test(sourceGitHead) ? { sourceGitHead } : {},
+    overview: usableString2(value.overview) ?? previous?.overview ?? "",
+    pages
+  };
 }
 function readPlanDocument(dir) {
   const filePath = wikiPlanPath(dir);
@@ -288,7 +413,8 @@ function unclaimedCandidates(plan, candidate, pageSources = /* @__PURE__ */ new
   const knownPaths = new Set(plan.pages.map((page) => page.path));
   const claimed = /* @__PURE__ */ new Set();
   for (const page of plan.pages) {
-    for (const source of [...page.sources, ...pageSources.get(page.path) ?? []]) claimed.add(source);
+    for (const source of [...page.sources, ...page.dependencies ?? [], ...pageSources.get(page.path) ?? []])
+      claimed.add(source);
   }
   return candidate.pages.filter(
     (page) => !knownPaths.has(page.path) && !page.sources.some((source) => claimed.has(source))
@@ -297,8 +423,9 @@ function unclaimedCandidates(plan, candidate, pageSources = /* @__PURE__ */ new
 function scopePlanForUpdate(input) {
   const changedPrefixes = [...input.changedPaths];
   const pages = input.plan.pages.map((page) => {
+    if (page.status !== "written") return page;
     if (!input.existingPages.has(page.path)) return { ...page, status: "pending", attempts: 0 };
-    const claimed = [...input.pageSources.get(page.path) ?? [], ...page.sources];
+    const claimed = [...input.pageSources.get(page.path) ?? [], ...page.sources, ...page.dependencies ?? []];
     const touched = claimed.some(
       (source) => changedPrefixes.some((changed) => changed === source || changed.startsWith(`${source}/`))
     );
@@ -306,305 +433,12 @@ function scopePlanForUpdate(input) {
   });
   return { ...input.plan, pages };
 }
-function pendingPages(plan) {
-  return plan.pages.filter((page) => page.status !== "written" && page.attempts < MAX_PAGE_ATTEMPTS);
-}
-
-// src/domains/context/wiki/meta.ts
-init_esm_shims();
-import { execFileSync } from "node:child_process";
-import { createHash } from "node:crypto";
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
-import { join as join4 } from "node:path";
-function compareStrings2(a, b) {
-  return a.localeCompare(b);
-}
-function isRecord3(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function stringValue(value) {
-  return typeof value === "string" && value.trim().length > 0 ? value : null;
-}
-function nonNegativeSafeInteger(value) {
-  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
-}
-var REQUESTED_DEPTHS = ["auto", "simple", "medium", "detailed"];
-var RESOLVED_DEPTHS = ["simple", "medium", "detailed"];
-function parseGeneration(value) {
-  if (!isRecord3(value)) return void 0;
-  const { requestedDepth, depth, sourceFiles, sourceLines, pagesPlanned, pagesWritten } = value;
-  if (!REQUESTED_DEPTHS.includes(requestedDepth) || !RESOLVED_DEPTHS.includes(depth) || !nonNegativeSafeInteger(sourceFiles) || !nonNegativeSafeInteger(sourceLines) || !nonNegativeSafeInteger(pagesPlanned) || !nonNegativeSafeInteger(pagesWritten)) {
-    return void 0;
-  }
-  return {
-    requestedDepth,
-    depth,
-    sourceFiles,
-    sourceLines,
-    pagesPlanned,
-    pagesWritten
-  };
-}
-function normalizePages(pages) {
-  return pages.map((page) => ({ path: page.path, title: page.title, ...page.summary ? { summary: page.summary } : {} })).sort((a, b) => a.path.localeCompare(b.path));
-}
-function wikiMetaPath(cwd) {
-  return join4(wikiDir(cwd), "meta.json");
-}
-function currentWikiGitHead(cwd) {
-  try {
-    return execFileSync("git", ["rev-parse", "--verify", "HEAD"], {
-      cwd,
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"]
-    }).trim();
-  } catch {
-    return null;
-  }
-}
-function validateWikiMeta(value) {
-  const problems = [];
-  if (!isRecord3(value)) {
-    return { ok: false, problems: ["meta must be a JSON object"] };
-  }
-  if (value.version !== 1) problems.push("version must be 1");
-  const updatedAt = stringValue(value.updatedAt);
-  if (!updatedAt) problems.push("updatedAt must be a non-empty string");
-  const gitHead = value.gitHead;
-  if (gitHead !== null && typeof gitHead !== "string") problems.push("gitHead must be a string or null");
-  const sourceTreeHash = value.sourceTreeHash;
-  if (sourceTreeHash !== void 0 && (typeof sourceTreeHash !== "string" || !/^[a-f0-9]{64}$/.test(sourceTreeHash))) {
-    problems.push("sourceTreeHash must be a sha256 hex string when present");
-  }
-  const model = stringValue(value.model);
-  if (!model) problems.push("model must be a non-empty string");
-  const contentHash = stringValue(value.contentHash);
-  if (!contentHash || !/^[a-f0-9]{64}$/.test(contentHash)) {
-    problems.push("contentHash must be a sha256 hex string");
-  }
-  if (!Array.isArray(value.pages)) {
-    problems.push("pages must be an array");
-  } else {
-    for (const [index, page] of value.pages.entries()) {
-      if (!isRecord3(page)) {
-        problems.push(`pages[${index}] must be an object`);
-        continue;
-      }
-      if (!stringValue(page.path)) problems.push(`pages[${index}].path must be a non-empty string`);
-      if (!stringValue(page.title)) problems.push(`pages[${index}].title must be a non-empty string`);
-    }
-  }
-  if (problems.length > 0) return { ok: false, problems };
-  const generation = parseGeneration(value.generation);
-  const plan = sanitizeWikiPlan(value.plan, void 0, { trustStatus: true });
-  return {
-    ok: true,
-    value: {
-      version: 1,
-      updatedAt,
-      gitHead,
-      ...sourceTreeHash !== void 0 ? { sourceTreeHash } : {},
-      model,
-      contentHash,
-      pages: normalizePages(value.pages),
-      ...generation !== void 0 ? { generation } : {},
-      ...plan !== null ? { plan } : {}
-    }
-  };
-}
-function isWikiMeta(value) {
-  return validateWikiMeta(value).ok;
-}
-function readWikiMeta(cwd) {
-  const filePath = wikiMetaPath(cwd);
-  if (!existsSync3(filePath)) return null;
-  let parsed;
-  try {
-    parsed = JSON.parse(readFileSync3(filePath, "utf8"));
-  } catch {
-    return null;
-  }
-  const validation = validateWikiMeta(parsed);
-  return validation.ok ? validation.value : null;
-}
-function writeWikiMeta(cwd, meta) {
-  const normalized = {
-    version: 1,
-    updatedAt: meta.updatedAt,
-    gitHead: meta.gitHead,
-    ...meta.sourceTreeHash ? { sourceTreeHash: meta.sourceTreeHash } : {},
-    model: meta.model,
-    contentHash: meta.contentHash,
-    pages: normalizePages(meta.pages),
-    ...meta.generation !== void 0 ? { generation: { ...meta.generation } } : {},
-    ...meta.plan !== void 0 ? { plan: meta.plan } : {}
-  };
-  safeResourceWrite(wikiMetaPath(cwd), `${JSON.stringify(normalized)}
-`, { encoding: "utf8" });
-}
-function computeWikiContentHashOfDir(dir) {
-  const hash = createHash("sha256");
-  for (const relPath of wikiMarkdownFilesInDir(dir).sort(compareStrings2)) {
-    let text = "";
-    try {
-      text = readFileSync3(join4(dir, relPath), "utf8");
-    } catch {
-      text = "";
-    }
-    hash.update(`${relPath}\0${text.length}\0`);
-    hash.update(text);
-    hash.update("\0");
-  }
-  return hash.digest("hex");
-}
-function computeWikiContentHash(cwd) {
-  return computeWikiContentHashOfDir(wikiDir(cwd));
-}
-
-// src/domains/context/wiki/staleness.ts
-init_esm_shims();
-import { execFile, execFileSync as execFileSync2 } from "node:child_process";
-import { promisify } from "node:util";
-var execFileAsync = promisify(execFile);
-var GIT_DIFF_LINE_CAP = 200;
-function splitNullTerminatedPaths(output) {
-  return output.split("\0").filter((path) => path.length > 0);
-}
-function currentGitHead(cwd) {
-  try {
-    const out = execFileSync2("git", ["rev-parse", "--verify", "HEAD"], {
-      cwd,
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"]
-    }).trim();
-    return out.length > 0 ? out : null;
-  } catch {
-    return null;
-  }
-}
-async function currentGitHeadAsync(cwd) {
-  try {
-    const { stdout } = await execFileAsync("git", ["rev-parse", "--verify", "HEAD"], { cwd, encoding: "utf8" });
-    const out = stdout.trim();
-    return out.length > 0 ? out : null;
-  } catch {
-    return null;
-  }
-}
-function collectChangedPaths(cwd, gitHead) {
-  const committed = execFileSync2("git", ["diff", "--name-only", "-z", `${gitHead}..HEAD`], {
-    cwd,
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "ignore"]
-  });
-  const trackedWorking = execFileSync2("git", ["diff", "--name-only", "-z", "HEAD"], {
-    cwd,
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "ignore"]
-  });
-  const untracked = execFileSync2("git", ["ls-files", "--others", "--exclude-standard", "-z"], {
-    cwd,
-    encoding: "utf8",
-    stdio: ["ignore", "pipe", "ignore"]
-  });
-  return /* @__PURE__ */ new Set([
-    ...splitNullTerminatedPaths(committed),
-    ...splitNullTerminatedPaths(trackedWorking),
-    ...splitNullTerminatedPaths(untracked)
-  ]);
-}
-function changedPathsSince(cwd, gitHead) {
-  if (!gitHead) return [];
-  try {
-    return [...collectChangedPaths(cwd, gitHead)];
-  } catch {
-    return [];
-  }
-}
-async function collectChangedPathsAsync(cwd, gitHead) {
-  const run = async (args) => {
-    const { stdout } = await execFileAsync("git", args, { cwd, encoding: "utf8" });
-    return stdout;
-  };
-  const [committed, trackedWorking, untracked] = await Promise.all([
-    run(["diff", "--name-only", "-z", `${gitHead}..HEAD`]),
-    run(["diff", "--name-only", "-z", "HEAD"]),
-    run(["ls-files", "--others", "--exclude-standard", "-z"])
-  ]);
-  return /* @__PURE__ */ new Set([
-    ...splitNullTerminatedPaths(committed),
-    ...splitNullTerminatedPaths(trackedWorking),
-    ...splitNullTerminatedPaths(untracked)
-  ]);
-}
-function capChangedPaths(paths) {
-  const capped = [...paths].slice(0, GIT_DIFF_LINE_CAP);
-  return {
-    count: capped.length,
-    ...paths.size > capped.length ? { warning: `changed file count capped at ${GIT_DIFF_LINE_CAP}` } : {}
-  };
-}
-var CHANGED_COUNT_FAILURE = "wiki staleness unavailable: git diff failed for the recorded wiki gitHead";
-function changedFileCount(cwd, gitHead) {
-  try {
-    return capChangedPaths(collectChangedPaths(cwd, gitHead));
-  } catch {
-    return { warning: CHANGED_COUNT_FAILURE };
-  }
-}
-async function changedFileCountAsync(cwd, gitHead) {
-  try {
-    return capChangedPaths(await collectChangedPathsAsync(cwd, gitHead));
-  } catch {
-    return { warning: CHANGED_COUNT_FAILURE };
-  }
-}
-function wikiCompletenessFromMeta(meta) {
-  const generation = meta?.generation;
-  if (!generation) return null;
-  return {
-    pagesPlanned: generation.pagesPlanned,
-    pagesWritten: generation.pagesWritten,
-    owed: Math.max(0, generation.pagesPlanned - generation.pagesWritten)
-  };
-}
-function wikiCompleteness(cwd) {
-  return wikiCompletenessFromMeta(readWikiMeta(cwd));
-}
-var MISSING_RECORDED_HEAD = "wiki staleness unavailable: recorded gitHead is missing";
-var MISSING_CURRENT_HEAD = "wiki staleness unavailable: current git HEAD is missing";
-function wikiStaleness(cwd) {
-  const meta = readWikiMeta(cwd);
-  if (!meta) return { state: "absent" };
-  if (!meta.gitHead) return { state: "fresh", warning: MISSING_RECORDED_HEAD };
-  const head = currentGitHead(cwd);
-  if (!head) return { state: "fresh", warning: MISSING_CURRENT_HEAD };
-  if (meta.sourceTreeHash && computeFingerprint(cwd).treeHash === meta.sourceTreeHash && head === meta.gitHead) {
-    return { state: "fresh" };
-  }
-  if (!meta.sourceTreeHash && head === meta.gitHead) return { state: "fresh" };
-  const diff = changedFileCount(cwd, meta.gitHead);
-  if (!("count" in diff)) return { state: "fresh", warning: diff.warning };
-  return { state: "stale", changedFiles: diff.count, ...diff.warning ? { warning: diff.warning } : {} };
-}
-async function wikiStalenessAsync(cwd) {
-  const meta = readWikiMeta(cwd);
-  if (!meta) return { state: "absent" };
-  if (!meta.gitHead) return { state: "fresh", warning: MISSING_RECORDED_HEAD };
-  const head = await currentGitHeadAsync(cwd);
-  if (!head) return { state: "fresh", warning: MISSING_CURRENT_HEAD };
-  if (meta.sourceTreeHash) {
-    const fingerprint = await computeFingerprintAsync(cwd);
-    if (fingerprint.treeHash === meta.sourceTreeHash && head === meta.gitHead) return { state: "fresh" };
-  } else if (head === meta.gitHead) {
-    return { state: "fresh" };
-  }
-  const diff = await changedFileCountAsync(cwd, meta.gitHead);
-  if (!("count" in diff)) return { state: "fresh", warning: diff.warning };
-  return { state: "stale", changedFiles: diff.count, ...diff.warning ? { warning: diff.warning } : {} };
+function pendingPages(plan, retryExhausted = false) {
+  return plan.pages.filter((page) => page.status !== "written" && (retryExhausted || page.attempts < MAX_PAGE_ATTEMPTS));
 }
 
 export {
+  stripFrontmatter,
   resolveSourcePath,
   readWikiPage,
   renderWikiPage,
@@ -616,6 +450,9 @@ export {
   isGeneratedWikiFile,
   listWikiPagesInDir,
   listWikiPages,
+  captureWikiSourceContent,
+  captureWikiSourceContentAsync,
+  wikiSourcesMatch,
   MAX_PAGE_ATTEMPTS,
   sanitizePagePath,
   sanitizeWikiPlan,
@@ -624,19 +461,6 @@ export {
   writeWikiPlanFile,
   unclaimedCandidates,
   scopePlanForUpdate,
-  pendingPages,
-  wikiMetaPath,
-  currentWikiGitHead,
-  validateWikiMeta,
-  isWikiMeta,
-  readWikiMeta,
-  writeWikiMeta,
-  computeWikiContentHashOfDir,
-  computeWikiContentHash,
-  changedPathsSince,
-  wikiCompletenessFromMeta,
-  wikiCompleteness,
-  wikiStaleness,
-  wikiStalenessAsync
+  pendingPages
 };
-//# sourceMappingURL=chunk-ELZVTCGV.js.map
+//# sourceMappingURL=chunk-LVFANMOH.js.map

package/dist/{chunk-H7IXIC72.js → chunk-LY4N4TTL.js}

@@ -1,7 +1,10 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  withResultSummaryAllowance
+} from "./chunk-OQM5IVJY.js";
 import {
   init_esm_shims
-} from "./chunk-3R73A4XB.js";
+} from "./chunk-ECBHH7LU.js";
 
 // src/domains/dispatch/execution-role.ts
 init_esm_shims();
@@ -53,6 +56,17 @@ function gateDeciderAgentId(requested) {
 function appliesRecipeResultContract(gateRole) {
   return gateRole !== "reviewer" && gateRole !== "judge" && gateRole !== "synthesis";
 }
+function dispatchResultContract(req, recipe) {
+  if (!appliesRecipeResultContract(req.gate?.role)) return void 0;
+  const base = req.resultContractOverride ?? recipe?.resultContract;
+  const allowance = req.resultSummary;
+  if (allowance === void 0) return base;
+  if (base?.kind === "mutation-report") return withResultSummaryAllowance(base, allowance.maxBytes);
+  if (req.resultContractOverride !== void 0 || allowance.scope === "batch") return base;
+  throw new Error(
+    `dispatch: result_summary_max_bytes applies only to a mutation-report result contract; agent '${req.agentId}' declares ${base === void 0 ? "no result contract" : base.kind}`
+  );
+}
 function routeCorrelationFactsForRun(run) {
   return {
     agentId: run.agentId,
@@ -96,8 +110,8 @@ export {
   requestExecutionRole,
   withAttemptRole,
   gateDeciderAgentId,
-  appliesRecipeResultContract,
+  dispatchResultContract,
   routeCorrelationFactsForRun,
   gateRouteCorrelation
 };
-//# sourceMappingURL=chunk-H7IXIC72.js.map
+//# sourceMappingURL=chunk-LY4N4TTL.js.map

package/dist/{chunk-VKPAQYEB.js → chunk-LZBMXNLP.js}

@@ -2,17 +2,17 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   createRedactionTally,
   redactSecretsText
-} from "./chunk-4BJ5BYCE.js";
+} from "./chunk-O3VV6IVK.js";
 import {
   normalizeClioCoderEventType
-} from "./chunk-BTK3SSSK.js";
+} from "./chunk-KMF54VH3.js";
 import {
   processAlive,
   processBirthToken
-} from "./chunk-3I7MS7N2.js";
+} from "./chunk-TK2BMCBZ.js";
 import {
   init_esm_shims
-} from "./chunk-3R73A4XB.js";
+} from "./chunk-ECBHH7LU.js";
 
 // src/domains/observability/trace-store.ts
 init_esm_shims();
@@ -1193,4 +1193,4 @@ export {
   createDispatchTraceMirror,
   assertTraceSelectOnly
 };
-//# sourceMappingURL=chunk-VKPAQYEB.js.map
+//# sourceMappingURL=chunk-LZBMXNLP.js.map

package/dist/{chunk-UL3WSD3F.js → chunk-M4KFUXS7.js}

@@ -1,7 +1,7 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   init_esm_shims
-} from "./chunk-3R73A4XB.js";
+} from "./chunk-ECBHH7LU.js";
 
 // src/core/verification-scripts.ts
 init_esm_shims();
@@ -24,4 +24,4 @@ export {
   isProjectVerifierCheckId,
   declaredVerificationScripts
 };
-//# sourceMappingURL=chunk-UL3WSD3F.js.map
+//# sourceMappingURL=chunk-M4KFUXS7.js.map

package/dist/{chunk-NXYCB2VD.js → chunk-M6TAYK66.js}

@@ -1,19 +1,19 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   canonicalizeExistingPath
-} from "./chunk-ECH6PKUQ.js";
+} from "./chunk-KQ6IDQIB.js";
 import {
   artifactDefaultPath
-} from "./chunk-GYV6VZOC.js";
+} from "./chunk-NTTS3O53.js";
 import {
   isVerificationScriptName
-} from "./chunk-UL3WSD3F.js";
+} from "./chunk-M4KFUXS7.js";
 import {
   ToolNames
-} from "./chunk-4NSRCOYP.js";
+} from "./chunk-EHOSNVVM.js";
 import {
   init_esm_shims
-} from "./chunk-3R73A4XB.js";
+} from "./chunk-ECBHH7LU.js";
 
 // src/domains/safety/protected-artifacts.ts
 init_esm_shims();
@@ -804,4 +804,4 @@ export {
   commandArgumentSegments,
   scanShellLike
 };
-//# sourceMappingURL=chunk-NXYCB2VD.js.map
+//# sourceMappingURL=chunk-M6TAYK66.js.map