@iowarp/clio-coder 0.4.4 → 0.4.5

package/dist/{chunk-Q4WO54TA.js → chunk-ZMZQEBKI.js}

@@ -1,43 +1,43 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   verifyTool
-} from "./chunk-23L32XTI.js";
+} from "./chunk-UXAC2FX4.js";
 import {
   discoverDeclaredChecksAtRoot,
   discoverDeclaredProjectEntriesAtRoot
-} from "./chunk-K6T2ZAMZ.js";
-import {
-  parseTomlDocument,
-  tomlTableAt
-} from "./chunk-LCGCVYZ4.js";
+} from "./chunk-HGSLRG33.js";
 import {
   VALIDATION_CONTRACT_MARKDOWN_PATH,
   loadValidationContract
-} from "./chunk-V76WTFTW.js";
+} from "./chunk-T52TPHYC.js";
+import {
+  parseTomlDocument,
+  tomlTableAt
+} from "./chunk-LQTKDAUO.js";
 import {
   PROJECT_VERIFIER_CATALOG_CAPS,
   PROJECT_VERIFIER_CATALOG_RELATIVE_PATH,
   PROJECT_VERIFIER_CATALOG_VERSION,
   normalizeNumericTolerance,
   parseProjectVerifierCatalogText
-} from "./chunk-DXKJURES.js";
+} from "./chunk-MDU3C27C.js";
 import {
   isVerificationScriptName
-} from "./chunk-UL3WSD3F.js";
+} from "./chunk-M4KFUXS7.js";
 import {
   compareCodepoints
-} from "./chunk-I5FWO7L5.js";
+} from "./chunk-B6UM3OZC.js";
 import {
   SAFE_EXEC_DEFAULT_TIMEOUT_MS,
   resolveSafeCwd
-} from "./chunk-TOIVGRUX.js";
+} from "./chunk-GJ24ODAX.js";
 import {
   require_dist
-} from "./chunk-APJ265NV.js";
+} from "./chunk-B5GGDIHT.js";
 import {
   __toESM,
   init_esm_shims
-} from "./chunk-3R73A4XB.js";
+} from "./chunk-ECBHH7LU.js";
 
 // src/tools/verify/authoring.ts
 init_esm_shims();
@@ -1015,4 +1015,4 @@ export {
   previewVerifierDraft,
   runVerifierAuthoringWorkflow
 };
-//# sourceMappingURL=chunk-Q4WO54TA.js.map
+//# sourceMappingURL=chunk-ZMZQEBKI.js.map

package/dist/{chunk-6EJMN2Y3.js → chunk-ZTNFYMIO.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/agent-environment.ts
 init_esm_shims();
@@ -14,4 +14,4 @@ export {
   AI_AGENT_NAME,
   withClioAgentEnvironment
 };
-//# sourceMappingURL=chunk-6EJMN2Y3.js.map
+//# sourceMappingURL=chunk-ZTNFYMIO.js.map

package/dist/{chunk-WEPFGWHJ.js → chunk-ZZFWWYLX.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/safe-resource-write.ts
 init_esm_shims();
@@ -120,4 +120,4 @@ export {
   fsyncDirectory,
   safeResourceWrite
 };
-//# sourceMappingURL=chunk-WEPFGWHJ.js.map
+//# sourceMappingURL=chunk-ZZFWWYLX.js.map

package/dist/cli/index.js

@@ -2,22 +2,22 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   traceBoot
-} from "../chunk-ZTJUVLTU.js";
+} from "../chunk-FXFVDPWY.js";
 import {
   extractGlobalFlags,
   parseFlags,
   printError
-} from "../chunk-JCI2ROMZ.js";
+} from "../chunk-3T4DXWP6.js";
 import {
   incompleteInstallationAdvice
-} from "../chunk-65DEGPJ6.js";
-import "../chunk-IWHMRKLL.js";
+} from "../chunk-3A3CUMKA.js";
+import "../chunk-E3LEPLQ2.js";
 import {
   AI_AGENT_NAME
-} from "../chunk-6EJMN2Y3.js";
+} from "../chunk-ZTNFYMIO.js";
 import {
   init_esm_shims
-} from "../chunk-3R73A4XB.js";
+} from "../chunk-ECBHH7LU.js";
 
 // src/cli/index.ts
 init_esm_shims();
@@ -142,7 +142,7 @@ async function main(argv) {
     return 0;
   }
   if (flags.has("version") || flags.has("v")) {
-    const { runVersionCommand } = await import("../version-KGEG7EPO.js");
+    const { runVersionCommand } = await import("../version-RFPKO6T7.js");
     return runVersionCommand();
   }
   const subArgs = subcommandIndex === -1 ? [] : rest.slice(subcommandIndex + 1);
@@ -155,38 +155,38 @@ async function main(argv) {
   };
   if (!subcommand) {
     await enableBootCompileCache();
-    const { runClioCommand } = await import("../clio-QLICPCF5.js");
+    const { runClioCommand } = await import("../clio-5I2IBFYL.js");
     return runClioCommand(bootOptions);
   }
   return dispatch(subcommand, subArgs, bootOptions);
 }
 async function enableBootCompileCache(subArgs = []) {
   if (subArgs.includes("--help") || subArgs.includes("-h")) return;
-  const { enableClioCompileCache } = await import("../compile-cache-OQAVB7Y5.js");
+  const { enableClioCompileCache } = await import("../compile-cache-WJEPUZEJ.js");
   enableClioCompileCache();
 }
-var extensionsCommand = async (subArgs) => (await import("../extensions-G7MFLYHT.js")).runExtensionsCommand(subArgs);
+var extensionsCommand = async (subArgs) => (await import("../extensions-YVRHX6ZI.js")).runExtensionsCommand(subArgs);
 var COMMAND_HANDLERS = /* @__PURE__ */ new Map([
   [
     "acp",
     async (subArgs, bootOptions) => {
       await enableBootCompileCache(subArgs);
-      return (await import("../acp-WNAYYF4F.js")).runAcpCommand(subArgs, bootOptions);
+      return (await import("../acp-H3CU2HBQ.js")).runAcpCommand(subArgs, bootOptions);
     }
   ],
-  ["auth", async (subArgs) => (await import("../auth-VKNNMGPU.js")).runAuthCommand(subArgs)],
-  ["config", async (subArgs) => (await import("../config-IUA6OYNS.js")).runConfigCommand(subArgs)],
-  ["configure", async (subArgs) => (await import("../configure-VEPX4NMX.js")).runConfigureCommand(subArgs)],
-  ["targets", async (subArgs) => (await import("../targets-OMH2XCSN.js")).runTargetsCommand(subArgs)],
-  ["models", async (subArgs) => (await import("../models-GERTU3YI.js")).runModelsCommand(subArgs)],
-  ["agents", async (subArgs) => (await import("../agents-3OKXHLOI.js")).runAgentsCommand(subArgs)],
-  ["components", async (subArgs) => (await import("../components-2TGAI2RC.js")).runComponentsCommand(subArgs)],
-  ["evidence", async (subArgs) => (await import("../evidence-4DQ25GUQ.js")).runEvidenceCommand(subArgs)],
-  ["eval", async (subArgs) => (await import("../eval-OQOQUDHK.js")).runEvalCommand(subArgs)],
-  ["memory", async (subArgs) => (await import("../memory-YCANYS5A.js")).runMemoryCommand(subArgs)],
-  ["usage", async (subArgs) => (await import("../usage-NHG6MCJM.js")).runUsageCommand(subArgs)],
-  ["trace", async (subArgs) => (await import("../trace-FXMXUZUF.js")).runTraceCommand(subArgs)],
-  ["evolve", async (subArgs) => (await import("../evolve-GSS52E5J.js")).runEvolveCommand(subArgs)],
+  ["auth", async (subArgs) => (await import("../auth-R7KYF7N3.js")).runAuthCommand(subArgs)],
+  ["config", async (subArgs) => (await import("../config-Y2JDJ3JJ.js")).runConfigCommand(subArgs)],
+  ["configure", async (subArgs) => (await import("../configure-SML6UBZ5.js")).runConfigureCommand(subArgs)],
+  ["targets", async (subArgs) => (await import("../targets-N5REUETU.js")).runTargetsCommand(subArgs)],
+  ["models", async (subArgs) => (await import("../models-3IK2Y5WE.js")).runModelsCommand(subArgs)],
+  ["agents", async (subArgs) => (await import("../agents-IXQQZ7BD.js")).runAgentsCommand(subArgs)],
+  ["components", async (subArgs) => (await import("../components-TNIKXCBH.js")).runComponentsCommand(subArgs)],
+  ["evidence", async (subArgs) => (await import("../evidence-SQ5DNFEN.js")).runEvidenceCommand(subArgs)],
+  ["eval", async (subArgs) => (await import("../eval-BUU3ZOUZ.js")).runEvalCommand(subArgs)],
+  ["memory", async (subArgs) => (await import("../memory-OQOXQGYD.js")).runMemoryCommand(subArgs)],
+  ["usage", async (subArgs) => (await import("../usage-4GWM2WWP.js")).runUsageCommand(subArgs)],
+  ["trace", async (subArgs) => (await import("../trace-JHLXWUMN.js")).runTraceCommand(subArgs)],
+  ["evolve", async (subArgs) => (await import("../evolve-IJNUFZDS.js")).runEvolveCommand(subArgs)],
   [
     "dev",
     async (subArgs, bootOptions) => {
@@ -205,32 +205,32 @@ var COMMAND_HANDLERS = /* @__PURE__ */ new Map([
   ],
   ["extensions", extensionsCommand],
   ["ext", extensionsCommand],
-  ["fleet", async (subArgs) => (await import("../fleet-Q37YHHAQ.js")).runFleetCommand(subArgs)],
-  ["skills", async (subArgs) => (await import("../skills-KR7WON5G.js")).runSkillsCommand(subArgs)],
-  ["library", async (subArgs) => (await import("../library-B2W4N74O.js")).runLibraryCommand(subArgs)],
-  ["tasks", async (subArgs) => (await import("../tasks-IPAGMEIX.js")).runTasksCommand(subArgs)],
-  ["verifiers", async (subArgs) => (await import("../verifiers-7AUNVXDY.js")).runVerifiersCommand(subArgs)],
-  ["docs", async (subArgs) => (await import("../docs-SPOV3BAN.js")).runDocsCommand(subArgs)],
-  ["share", async (subArgs) => (await import("../share-2NWMJJEE.js")).runShareCommand(subArgs)],
-  ["export", async (subArgs) => (await import("../share-2NWMJJEE.js")).runExportCommand(subArgs)],
-  ["import", async (subArgs) => (await import("../share-2NWMJJEE.js")).runImportCommand(subArgs)],
-  ["context", async (subArgs) => (await import("../context-BOYF5EJM.js")).runContextCommand(subArgs)],
+  ["fleet", async (subArgs) => (await import("../fleet-ZNNVSYFO.js")).runFleetCommand(subArgs)],
+  ["skills", async (subArgs) => (await import("../skills-S36AAJHU.js")).runSkillsCommand(subArgs)],
+  ["library", async (subArgs) => (await import("../library-GJI6W6OK.js")).runLibraryCommand(subArgs)],
+  ["tasks", async (subArgs) => (await import("../tasks-6BVY5YZF.js")).runTasksCommand(subArgs)],
+  ["verifiers", async (subArgs) => (await import("../verifiers-GSKWKWVG.js")).runVerifiersCommand(subArgs)],
+  ["docs", async (subArgs) => (await import("../docs-BL7ROUFN.js")).runDocsCommand(subArgs)],
+  ["share", async (subArgs) => (await import("../share-4JUB4BL7.js")).runShareCommand(subArgs)],
+  ["export", async (subArgs) => (await import("../share-4JUB4BL7.js")).runExportCommand(subArgs)],
+  ["import", async (subArgs) => (await import("../share-4JUB4BL7.js")).runImportCommand(subArgs)],
+  ["context", async (subArgs) => (await import("../context-S2EEC3EJ.js")).runContextCommand(subArgs)],
   [
     "run",
     async (subArgs, bootOptions) => {
       await enableBootCompileCache(subArgs);
-      return (await import("../run-D6XJ34CN.js")).runClioRun(subArgs, bootOptions);
+      return (await import("../run-3VFZQ33N.js")).runClioRun(subArgs, bootOptions);
     }
   ],
-  ["tools", async (subArgs) => (await import("../tools-EFFEAIDP.js")).runToolsCommand(subArgs)],
-  ["interop", async (subArgs) => (await import("../interop-ZG5T62U3.js")).runInteropCommand(subArgs)],
-  ["panes", async (subArgs) => (await import("../panes-NXSLDQZ2.js")).runPanesCommand(subArgs)],
-  ["doctor", async (subArgs) => (await import("../doctor-DKICC2SN.js")).runDoctorCommand(subArgs)],
-  ["paths", async (subArgs) => (await import("../paths-VSUWNC22.js")).runPathsCommand(subArgs)],
-  ["reset", async (subArgs) => (await import("../reset-TNWTB5LU.js")).runResetCommand(subArgs)],
-  ["uninstall", async (subArgs) => (await import("../uninstall-HALS6BLF.js")).runUninstallCommand(subArgs)],
-  ["upgrade", async (subArgs) => (await import("../upgrade-MS72RJEP.js")).runUpgradeCommand(subArgs)],
-  ["version", async () => (await import("../version-KGEG7EPO.js")).runVersionCommand()],
+  ["tools", async (subArgs) => (await import("../tools-6OCQ6SVB.js")).runToolsCommand(subArgs)],
+  ["interop", async (subArgs) => (await import("../interop-YOTGXFJM.js")).runInteropCommand(subArgs)],
+  ["panes", async (subArgs) => (await import("../panes-WPOMEMRH.js")).runPanesCommand(subArgs)],
+  ["doctor", async (subArgs) => (await import("../doctor-N3LCM2LG.js")).runDoctorCommand(subArgs)],
+  ["paths", async (subArgs) => (await import("../paths-J3KN7UAO.js")).runPathsCommand(subArgs)],
+  ["reset", async (subArgs) => (await import("../reset-MUVQDLNL.js")).runResetCommand(subArgs)],
+  ["uninstall", async (subArgs) => (await import("../uninstall-FXYMFFRT.js")).runUninstallCommand(subArgs)],
+  ["upgrade", async (subArgs) => (await import("../upgrade-4HD5HAIV.js")).runUpgradeCommand(subArgs)],
+  ["version", async () => (await import("../version-RFPKO6T7.js")).runVersionCommand()],
   [
     "worker",
     async () => {

package/dist/clio-5I2IBFYL.js

@@ -0,0 +1,26 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  runClioCommand
+} from "./chunk-SBZX6ARC.js";
+import "./chunk-YYB3MC65.js";
+import "./chunk-T53XI6I7.js";
+import "./chunk-FXFVDPWY.js";
+import "./chunk-NTK3WTHM.js";
+import "./chunk-FKIOX6DS.js";
+import "./chunk-DVNAPPXU.js";
+import "./chunk-E3LEPLQ2.js";
+import "./chunk-SE4ZKILO.js";
+import "./chunk-U2MSJ57E.js";
+import "./chunk-C27U2TYG.js";
+import "./chunk-6EXUUOSN.js";
+import "./chunk-2QPI3TR3.js";
+import "./chunk-TK2BMCBZ.js";
+import "./chunk-B5GGDIHT.js";
+import "./chunk-ZZFWWYLX.js";
+import "./chunk-DXVMLM3Z.js";
+import "./chunk-CTTI7G3T.js";
+import "./chunk-ECBHH7LU.js";
+export {
+  runClioCommand
+};
+//# sourceMappingURL=clio-5I2IBFYL.js.map

package/dist/{code-nav-IJR2DBPR.js → code-nav-YXIAEZVS.js}

@@ -1,60 +1,79 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
-  listWikiPages,
   readWikiMeta,
   wikiCompletenessFromMeta,
   wikiStaleness
-} from "./chunk-ELZVTCGV.js";
+} from "./chunk-USZA7GWL.js";
+import {
+  listWikiPages,
+  readWikiPage
+} from "./chunk-LVFANMOH.js";
 import {
-  coordinateCodewikiWrite,
   readClioState,
   writeClioState
-} from "./chunk-MXHC5QYU.js";
+} from "./chunk-WTQGRBHV.js";
+import {
+  coordinateCodewikiWrite
+} from "./chunk-7WUZEB2M.js";
 import {
   CODE_NAV_DEFAULT_ENTRY_LIMIT,
   CODE_NAV_DEFAULT_LIMIT,
   CODE_NAV_MAX_LIMIT,
   codeNavToolSurface
-} from "./chunk-RXTN6AKH.js";
+} from "./chunk-PWWSIB2A.js";
 import {
   compileGlobRegex
-} from "./chunk-VG7TBQIY.js";
-import "./chunk-OQE5J4C6.js";
+} from "./chunk-V552WL53.js";
 import {
   OBSERVE_SELF_CAPS,
   finalizeObservation,
   observationBudgetExhausted,
   reserveObservation
-} from "./chunk-NAI6ZFCY.js";
-import "./chunk-OZNBF4L3.js";
-import "./chunk-ECH6PKUQ.js";
-import "./chunk-5B2AEOW5.js";
-import "./chunk-4BJ5BYCE.js";
-import "./chunk-6XLNIQDB.js";
+} from "./chunk-RLTT5GVY.js";
+import "./chunk-KECNXMDE.js";
+import "./chunk-4SVIVOMC.js";
+import "./chunk-NTK3WTHM.js";
+import "./chunk-WXA2CFJO.js";
+import "./chunk-LUL5Z66S.js";
+import "./chunk-M6TAYK66.js";
+import "./chunk-KQ6IDQIB.js";
+import "./chunk-MDU3C27C.js";
+import "./chunk-R2P2U3ZS.js";
+import "./chunk-NTTS3O53.js";
+import "./chunk-M4KFUXS7.js";
+import "./chunk-GH5ZR6JP.js";
+import "./chunk-O3VV6IVK.js";
+import "./chunk-B6UM3OZC.js";
+import "./chunk-MYI32N4R.js";
 import {
   ToolNames
-} from "./chunk-4NSRCOYP.js";
-import "./chunk-UUVG37B4.js";
+} from "./chunk-EHOSNVVM.js";
+import "./chunk-5CY4Q6QI.js";
+import "./chunk-KPRLAMP4.js";
 import {
   codewikiPath,
   parseCodewikiRaw,
   readCodewiki
-} from "./chunk-LBMZMYH2.js";
-import "./chunk-33YXPOE3.js";
+} from "./chunk-W2RJEH6Q.js";
+import "./chunk-PPEZJWUG.js";
 import {
   resolvePackageRoot
-} from "./chunk-IWHMRKLL.js";
-import "./chunk-S66XZJOF.js";
-import "./chunk-IKCO5N3L.js";
-import "./chunk-3I7MS7N2.js";
-import "./chunk-APJ265NV.js";
-import "./chunk-WEPFGWHJ.js";
-import "./chunk-YPC6ZR5L.js";
-import "./chunk-YXLYO42X.js";
-import "./chunk-BYP5D4HI.js";
+} from "./chunk-E3LEPLQ2.js";
+import "./chunk-C27U2TYG.js";
+import "./chunk-GJ24ODAX.js";
+import "./chunk-LTR5QCLS.js";
+import "./chunk-6EXUUOSN.js";
+import "./chunk-ZTNFYMIO.js";
+import "./chunk-2QPI3TR3.js";
+import "./chunk-TK2BMCBZ.js";
+import "./chunk-B5GGDIHT.js";
+import "./chunk-ZZFWWYLX.js";
+import "./chunk-5CMARGPF.js";
+import "./chunk-DXVMLM3Z.js";
+import "./chunk-CTTI7G3T.js";
 import {
   init_esm_shims
-} from "./chunk-3R73A4XB.js";
+} from "./chunk-ECBHH7LU.js";
 
 // src/tools/codewiki/code-nav.ts
 init_esm_shims();
@@ -484,7 +503,6 @@ function runDependents(index, query, limit) {
   };
 }
 var WIKI_UPDATE_COMMAND = "clio-coder context wiki --update";
-var WIKI_SUMMARY_MAX_CHARS = 240;
 function wikiPageId(path) {
   return path.replace(/\.md$/i, "");
 }
@@ -495,9 +513,7 @@ function wikiPageSummary(cwd, path) {
   } catch {
     return "Summary unavailable; read the page for details.";
   }
-  const paragraphs = text.replace(/^#\s+.*$/m, "").split(/\r?\n\s*\r?\n/).map((paragraph) => paragraph.replace(/\s+/g, " ").trim()).filter((paragraph) => paragraph.length > 0 && !paragraph.startsWith("#"));
-  const summary = paragraphs[0] ?? "Read the page for details.";
-  return summary.length <= WIKI_SUMMARY_MAX_CHARS ? summary : `${summary.slice(0, WIKI_SUMMARY_MAX_CHARS - 1).trimEnd()}\u2026`;
+  return readWikiPage({ pagePath: path, content: text, sourceRoot: cwd }).metadata.summary || "Read the page for details.";
 }
 function wikiPageCatalog(pages) {
   return pages.map((page) => `${wikiPageId(page.path)} (${page.title})`).join(", ");
@@ -667,4 +683,4 @@ var codeNavTool = {
 export {
   codeNavTool
 };
-//# sourceMappingURL=code-nav-IJR2DBPR.js.map
+//# sourceMappingURL=code-nav-YXIAEZVS.js.map

package/dist/codewiki/build-worker.js

@@ -1,54 +1,101 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   buildCodewiki,
+  computeFingerprint,
+  isStale,
   syncCodewiki,
   updateCodewikiPaths
-} from "../chunk-BWH6N36D.js";
-import {
-  computeFingerprint,
-  isStale
-} from "../chunk-UUVG37B4.js";
+} from "../chunk-VHKTOLEW.js";
+import "../chunk-KPRLAMP4.js";
 import {
-  codewikiNeedsBackfill
-} from "../chunk-LBMZMYH2.js";
+  codewikiNeedsBackfill,
+  readCodewiki
+} from "../chunk-W2RJEH6Q.js";
 import {
   detectProjectType
-} from "../chunk-XAKHZX5N.js";
-import "../chunk-33YXPOE3.js";
-import "../chunk-7CR24IG7.js";
-import "../chunk-WEPFGWHJ.js";
+} from "../chunk-CVDAFGPW.js";
+import "../chunk-PPEZJWUG.js";
+import "../chunk-WDV62RKY.js";
+import "../chunk-ZZFWWYLX.js";
 import {
   init_esm_shims
-} from "../chunk-3R73A4XB.js";
+} from "../chunk-ECBHH7LU.js";
 
 // src/domains/context/codewiki/build-worker.ts
 init_esm_shims();
 import { parentPort, workerData } from "node:worker_threads";
-async function execute(request) {
-  if (request.kind === "build") {
-    const codewiki2 = await buildCodewiki({ cwd: request.cwd, language: request.language });
-    return { codewiki: codewiki2, fingerprint: computeFingerprint(request.cwd, codewiki2), changed: true };
+
+// src/domains/context/codewiki/build-operation.ts
+init_esm_shims();
+import { readFileSync } from "node:fs";
+function isArtifactRef(value) {
+  return value !== null && "source" in value && value.source === "artifact";
+}
+async function executeCodewikiBuildOutcome(request, options = {}) {
+  const handed = request.kind === "build" ? null : request.current;
+  let resolved = isArtifactRef(handed) ? void 0 : handed;
+  const resolveCurrent = () => {
+    if (resolved === void 0) resolved = readCodewiki(request.cwd);
+    return resolved;
+  };
+  const requireCurrent = () => {
+    const current2 = resolveCurrent();
+    if (!current2) throw new Error("codewiki artifact referenced by the coordinator is unreadable; rebuild it");
+    return current2;
+  };
+  let unreadable = false;
+  const buildOptions = {
+    ...options,
+    readFile: (path) => {
+      try {
+        const text = options.readFile ? options.readFile(path) : readFileSync(path, "utf8");
+        if (text === null) unreadable = true;
+        return text;
+      } catch {
+        unreadable = true;
+        return null;
+      }
+    }
+  };
+  if (request.kind === "ensure" && handed !== null) {
+    const needsBackfill = isArtifactRef(handed) ? handed.needsBackfill : codewikiNeedsBackfill(handed);
+    if (!needsBackfill) {
+      const fingerprint = isArtifactRef(handed) ? computeFingerprint(request.cwd, null, { artifactLoc: handed.loc }) : computeFingerprint(request.cwd, handed);
+      if (request.previous && !isStale(request.previous, fingerprint)) {
+        return { codewiki: isArtifactRef(handed) ? null : handed, fingerprint, changed: false };
+      }
+    }
   }
+  let current = handed === null ? null : resolveCurrent();
   if (request.kind === "incremental") {
-    const codewiki2 = await updateCodewikiPaths(request.cwd, request.current, request.paths);
-    return {
-      codewiki: codewiki2,
-      fingerprint: computeFingerprint(request.cwd, codewiki2),
-      changed: codewiki2 !== request.current
-    };
+    const base = requireCurrent();
+    current = await updateCodewikiPaths(request.cwd, base, request.paths, buildOptions);
+    if (current === base && request.previous && !unreadable) {
+      return { codewiki: isArtifactRef(handed) ? null : base, fingerprint: request.previous, changed: false };
+    }
   }
-  if (request.current && !codewikiNeedsBackfill(request.current)) {
-    const currentFingerprint = computeFingerprint(request.cwd, request.current);
-    if (request.previous && !isStale(request.previous, currentFingerprint)) {
-      return { codewiki: request.current, fingerprint: currentFingerprint, changed: false };
+  for (let attempt = 0; attempt < 3; attempt += 1) {
+    const before = computeFingerprint(request.cwd, current);
+    unreadable = false;
+    current = current ? await syncCodewiki(request.cwd, current, buildOptions) : await buildCodewiki(
+      {
+        cwd: request.cwd,
+        language: (request.kind === "incremental" ? requireCurrent().language : request.language) ?? detectProjectType(request.cwd)
+      },
+      buildOptions
+    );
+    const after = computeFingerprint(request.cwd, current);
+    if (!isStale(before, after) && !unreadable) {
+      return { codewiki: current, fingerprint: after, changed: true };
     }
   }
-  const codewiki = request.current ? await syncCodewiki(request.cwd, request.current) : await buildCodewiki({ cwd: request.cwd, language: request.language ?? detectProjectType(request.cwd) });
-  return { codewiki, fingerprint: computeFingerprint(request.cwd, codewiki), changed: true };
+  throw new Error("codewiki source snapshot did not stabilize after 3 attempts; previous index preserved");
 }
+
+// src/domains/context/codewiki/build-worker.ts
 var port = parentPort;
 if (!port) throw new Error("codewiki build worker requires a worker_threads parent");
-execute(workerData).then(
+executeCodewikiBuildOutcome(workerData).then(
   (result) => {
     port.postMessage({ ok: true, result });
     port.close();

package/dist/{compile-cache-OQAVB7Y5.js → compile-cache-WJEPUZEJ.js}

@@ -4,13 +4,13 @@ import {
   deleteInjectedCompileCacheFrom,
   enableClioCompileCache,
   workerCompileCacheEnvironment
-} from "./chunk-2LEAKD4C.js";
-import "./chunk-BYP5D4HI.js";
-import "./chunk-3R73A4XB.js";
+} from "./chunk-CKK25WN3.js";
+import "./chunk-CTTI7G3T.js";
+import "./chunk-ECBHH7LU.js";
 export {
   INJECTED_COMPILE_CACHE_ENV,
   deleteInjectedCompileCacheFrom,
   enableClioCompileCache,
   workerCompileCacheEnvironment
 };
-//# sourceMappingURL=compile-cache-OQAVB7Y5.js.map
+//# sourceMappingURL=compile-cache-WJEPUZEJ.js.map

package/dist/{components-2TGAI2RC.js → components-TNIKXCBH.js}

@@ -1,26 +1,26 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import "./chunk-3ODX73FK.js";
+import "./chunk-5VTJP36Q.js";
 import {
   printError,
   printOk
-} from "./chunk-JCI2ROMZ.js";
+} from "./chunk-3T4DXWP6.js";
 import {
   resolvePackageRoot
-} from "./chunk-IWHMRKLL.js";
-import "./chunk-ID64D7PE.js";
-import "./chunk-336NSSKI.js";
-import "./chunk-IKCO5N3L.js";
-import "./chunk-3I7MS7N2.js";
+} from "./chunk-E3LEPLQ2.js";
+import "./chunk-HXHFDHB6.js";
+import "./chunk-VNBICSS2.js";
+import "./chunk-2QPI3TR3.js";
+import "./chunk-TK2BMCBZ.js";
 import {
   require_dist
-} from "./chunk-APJ265NV.js";
-import "./chunk-WEPFGWHJ.js";
-import "./chunk-YXLYO42X.js";
-import "./chunk-BYP5D4HI.js";
+} from "./chunk-B5GGDIHT.js";
+import "./chunk-ZZFWWYLX.js";
+import "./chunk-DXVMLM3Z.js";
+import "./chunk-CTTI7G3T.js";
 import {
   __toESM,
   init_esm_shims
-} from "./chunk-3R73A4XB.js";
+} from "./chunk-ECBHH7LU.js";
 
 // src/cli/components.ts
 init_esm_shims();
@@ -671,4 +671,4 @@ function formatDiffLine(marker, component) {
 export {
   runComponentsCommand
 };
-//# sourceMappingURL=components-2TGAI2RC.js.map
+//# sourceMappingURL=components-TNIKXCBH.js.map