@iowarp/clio-coder 0.4.1 → 0.4.2

package/dist/{context-KYQFRVDC.js → context-N6ZE3LGJ.js}

@@ -61,7 +61,7 @@ function formatGenerationStatus(generation) {
   return `generation: ${generation.mode} (${details.join("; ")})`;
 }
 async function printContextStatus() {
-  const context = await import("./context-5HE7ODYK.js");
+  const context = await import("./context-IYEHL3WQ.js");
   const preload = await import("./preload-P6DGH2PZ.js");
   const cwd = process.cwd();
   const clio = context.loadProjectClioMd(cwd);
@@ -111,8 +111,8 @@ async function runRefreshCommand(args) {
     return 2;
   }
   try {
-    const { runContextRefresh } = await import("./context-5HE7ODYK.js");
-    const wikiEntry = updateWiki ? await import("./wiki-generate-4NDZTQ4B.js") : null;
+    const { runContextRefresh } = await import("./context-IYEHL3WQ.js");
+    const wikiEntry = updateWiki ? await import("./wiki-generate-F5W5QTYY.js") : null;
     const result = await runContextRefresh({
       cwd: process.cwd(),
       io: {
@@ -146,7 +146,7 @@ async function runRefreshCommand(args) {
   }
 }
 async function runWikiStatusCommand() {
-  const context = await import("./context-5HE7ODYK.js");
+  const context = await import("./context-IYEHL3WQ.js");
   const cwd = process.cwd();
   const meta = context.readWikiMeta(cwd);
   if (!meta) {
@@ -240,8 +240,8 @@ async function runWikiCommand(args) {
   }
   if (status) return runWikiStatusCommand();
   try {
-    const context = await import("./context-5HE7ODYK.js");
-    const { modelWikiGenerate, resolveDocumenterModelId } = await import("./wiki-generate-4NDZTQ4B.js");
+    const context = await import("./context-IYEHL3WQ.js");
+    const { modelWikiGenerate, resolveDocumenterModelId } = await import("./wiki-generate-F5W5QTYY.js");
     const route = {
       ...target !== void 0 ? { target } : {},
       ...model !== void 0 ? { model } : {},
@@ -283,19 +283,19 @@ async function runContextCommand(args) {
   }
   switch (verb) {
     case "init":
-      return (await import("./init-5XQRBOFV.js")).runInitCommand(rest);
+      return (await import("./init-T2QORQ3Y.js")).runInitCommand(rest);
     case "refresh":
       return runRefreshCommand(rest);
     case "wiki":
       return runWikiCommand(rest);
     case "reset":
-      return (await import("./context-clear-N545L53A.js")).runContextClearCommand(rest);
+      return (await import("./context-clear-G4OGZJDS.js")).runContextClearCommand(rest);
     case "index":
       return (await import("./context-index-HNG3MOME.js")).runContextIndexCommand(rest);
     case "replay":
-      return (await import("./context-working-set-QHKXSV2F.js")).runContextReplayCommand(rest);
+      return (await import("./context-working-set-BWLF6LJP.js")).runContextReplayCommand(rest);
     case "working-set":
-      return (await import("./context-working-set-QHKXSV2F.js")).runContextWorkingSetCommand(rest);
+      return (await import("./context-working-set-BWLF6LJP.js")).runContextWorkingSetCommand(rest);
     default:
       process.stderr.write(`clio-coder context: unknown subcommand ${verb}
 `);
@@ -306,4 +306,4 @@ async function runContextCommand(args) {
 export {
   runContextCommand
 };
-//# sourceMappingURL=context-KYQFRVDC.js.map
+//# sourceMappingURL=context-N6ZE3LGJ.js.map

package/dist/{context-clear-N545L53A.js → context-clear-G4OGZJDS.js}

@@ -1,54 +1,56 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   runContextClear
-} from "./chunk-C537JADH.js";
-import "./chunk-3QSOM6PA.js";
-import "./chunk-74YWRRU5.js";
+} from "./chunk-SSEYRH53.js";
+import "./chunk-AZ4WMN4W.js";
+import "./chunk-JBCS7CRR.js";
 import "./chunk-LCGCVYZ4.js";
 import "./chunk-NDINPTJ4.js";
 import "./chunk-MXHC5QYU.js";
-import "./chunk-XKA2ICR3.js";
-import "./chunk-GPPB3JBE.js";
-import "./chunk-6NJQITNH.js";
-import "./chunk-TVH4ONAM.js";
-import "./chunk-TD3PGPQA.js";
-import "./chunk-THYWACCR.js";
+import "./chunk-I66ZTYNP.js";
+import "./chunk-ZGNYYXQ6.js";
+import "./chunk-B74PXLU7.js";
+import "./chunk-X7IARSHT.js";
+import "./chunk-KPXDY6QF.js";
+import "./chunk-W6NIE6OW.js";
+import "./chunk-DZAW46HP.js";
 import "./chunk-RVG5JXAL.js";
 import "./chunk-3DPEIQKN.js";
-import "./chunk-6CCS4G3W.js";
-import "./chunk-6VC4OV3Z.js";
+import "./chunk-5PFYMY2V.js";
+import "./chunk-VIA6RFQZ.js";
 import "./chunk-T56WDKA5.js";
 import "./chunk-W6GROXXM.js";
 import "./chunk-JVCV3ICN.js";
-import "./chunk-AFKWHWXF.js";
+import "./chunk-4JDLP6ZS.js";
 import "./chunk-TXOTCRLG.js";
 import "./chunk-HVDIIIQW.js";
-import "./chunk-CTJ4RNAA.js";
+import "./chunk-3F7VUY77.js";
 import "./chunk-RKKLTLYB.js";
-import "./chunk-SUW5DORT.js";
+import "./chunk-HLAFFSEK.js";
+import "./chunk-77QIVUZB.js";
 import "./chunk-I66EAJFY.js";
 import "./chunk-VG7TBQIY.js";
-import "./chunk-2VG7KLYV.js";
-import "./chunk-7EPLI7VL.js";
-import "./chunk-6DWBAZ5U.js";
-import "./chunk-PVAMAVBB.js";
-import "./chunk-IXJT6DCX.js";
-import "./chunk-TVHHYFHE.js";
+import "./chunk-IKSLQ4XV.js";
+import "./chunk-HIICAHCJ.js";
+import "./chunk-Q4XWMHX6.js";
+import "./chunk-IDNA72AH.js";
+import "./chunk-FVDGR2ZL.js";
+import "./chunk-NEDJ26B5.js";
 import "./chunk-42FMPA75.js";
 import "./chunk-H7IXIC72.js";
 import "./chunk-VN3SHNBN.js";
 import "./chunk-OQE5J4C6.js";
 import "./chunk-FSP7CMNU.js";
-import "./chunk-R23Z6K6I.js";
+import "./chunk-B7HM5Z7T.js";
 import "./chunk-OZNBF4L3.js";
 import "./chunk-4BJ5BYCE.js";
 import "./chunk-6XLNIQDB.js";
-import "./chunk-U2WB7TZS.js";
+import "./chunk-NMJXSHBJ.js";
 import "./chunk-VAVR4IJY.js";
 import "./chunk-2LEAKD4C.js";
 import "./chunk-HHV2GANA.js";
-import "./chunk-IG7BCQBA.js";
-import "./chunk-GCSMB2KY.js";
+import "./chunk-PGF63K6I.js";
+import "./chunk-IKOZFYBN.js";
 import "./chunk-UL3WSD3F.js";
 import "./chunk-ECH6PKUQ.js";
 import "./chunk-5B2AEOW5.js";
@@ -60,27 +62,27 @@ import "./chunk-XAKHZX5N.js";
 import "./chunk-33YXPOE3.js";
 import "./chunk-7CR24IG7.js";
 import "./chunk-XPLRXC72.js";
-import "./chunk-UEDMSP56.js";
+import "./chunk-BYMNWQ7O.js";
 import "./chunk-CFGTUFWB.js";
 import "./chunk-72GZI5EV.js";
 import "./chunk-CWVRRIEI.js";
 import "./chunk-MQXIVJ35.js";
 import "./chunk-R346GLFC.js";
 import "./chunk-PMZVFWSR.js";
-import "./chunk-HLW2MRKE.js";
 import "./chunk-BTK3SSSK.js";
 import "./chunk-IHXBNWMM.js";
-import "./chunk-EIMVLWB3.js";
+import "./chunk-34BHNEE3.js";
 import "./chunk-D7E7WCDF.js";
 import "./chunk-HJWWJ6IL.js";
+import "./chunk-F4EKGO4N.js";
 import "./chunk-JIEGK6UF.js";
 import "./chunk-EBY63B7G.js";
 import "./chunk-6EJMN2Y3.js";
 import "./chunk-IWHMRKLL.js";
-import "./chunk-QKIFBZKT.js";
-import "./chunk-BWW4HLO4.js";
+import "./chunk-IMXMHHMQ.js";
+import "./chunk-UXCU4E3T.js";
 import "./chunk-LL4KHSZI.js";
-import "./chunk-NLFAQR7Z.js";
+import "./chunk-S66XZJOF.js";
 import "./chunk-CDNVLKUX.js";
 import "./chunk-WNP7O5WZ.js";
 import "./chunk-336NSSKI.js";
@@ -169,4 +171,4 @@ async function runContextClearCommand(args) {
 export {
   runContextClearCommand
 };
-//# sourceMappingURL=context-clear-N545L53A.js.map
+//# sourceMappingURL=context-clear-G4OGZJDS.js.map

package/dist/{context-working-set-QHKXSV2F.js → context-working-set-BWLF6LJP.js}

@@ -10,7 +10,7 @@ import {
   resolveWorkingSetPolicy,
   selectVisibleEntries,
   tokensFreedByEviction
-} from "./chunk-6I5ILFOF.js";
+} from "./chunk-M2WXEHER.js";
 import {
   EMPTY_WORKING_SET_VIEW,
   buildPathIndex,
@@ -19,21 +19,21 @@ import {
   foldWorkingSet,
   isTurnStart,
   protectionCutoffIndex
-} from "./chunk-TZSKNMZG.js";
+} from "./chunk-GTUD2WMY.js";
 import {
   parseSessionEntries
-} from "./chunk-TVH4ONAM.js";
+} from "./chunk-X7IARSHT.js";
 import "./chunk-3DPEIQKN.js";
 import {
   filterEntriesToActivePath
 } from "./chunk-W6GROXXM.js";
 import "./chunk-HVDIIIQW.js";
-import "./chunk-6DWBAZ5U.js";
+import "./chunk-Q4XWMHX6.js";
 import {
   isSessionHeader
 } from "./chunk-FSP7CMNU.js";
 import "./chunk-OZNBF4L3.js";
-import "./chunk-GCSMB2KY.js";
+import "./chunk-IKOZFYBN.js";
 import "./chunk-UL3WSD3F.js";
 import "./chunk-ECH6PKUQ.js";
 import "./chunk-K6BSR66V.js";
@@ -46,8 +46,8 @@ import "./chunk-MQXIVJ35.js";
 import {
   assertSafeId
 } from "./chunk-R346GLFC.js";
-import "./chunk-HLW2MRKE.js";
 import "./chunk-BTK3SSSK.js";
+import "./chunk-F4EKGO4N.js";
 import "./chunk-IWHMRKLL.js";
 import {
   DEFAULT_WORKING_SET_SETTINGS
@@ -1551,4 +1551,4 @@ export {
   runContextReplayCommand,
   runContextWorkingSetCommand
 };
-//# sourceMappingURL=context-working-set-QHKXSV2F.js.map
+//# sourceMappingURL=context-working-set-BWLF6LJP.js.map

package/dist/{dispatch-runner-RGIE5PCT.js → dispatch-runner-2QQAITS3.js}

@@ -1,11 +1,11 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import "./chunk-5YHDIDBP.js";
+import "./chunk-UH632ZYL.js";
 import {
   SPOT_CHECK_GUIDANCE,
   receiptEvidenceLabels,
   workerTextLabel,
   workerTextNonEvidenceNotices
-} from "./chunk-3I5NY75V.js";
+} from "./chunk-E7GT7O5N.js";
 import {
   UNVERIFIABLE_RECEIPT_VERIFICATION,
   closeAgentLedger,
@@ -16,7 +16,7 @@ import {
   provenanceCompactSuffix,
   renderAgentLedgerBoard,
   renderDispatchReviewerTask
-} from "./chunk-XKA2ICR3.js";
+} from "./chunk-I66ZTYNP.js";
 import {
   decideReviewGate,
   finalizePendingGateDecision,
@@ -28,13 +28,14 @@ import {
   resolvePendingGateDecision,
   stagePendingGateDecision,
   stagePendingGateOutput
-} from "./chunk-GPPB3JBE.js";
+} from "./chunk-ZGNYYXQ6.js";
 import {
   adaptRunReceiptTrustStatus,
   summarizeTrustStatus,
   verifyReceiptIntegrity
-} from "./chunk-6NJQITNH.js";
-import "./chunk-TVH4ONAM.js";
+} from "./chunk-B74PXLU7.js";
+import "./chunk-X7IARSHT.js";
+import "./chunk-KPXDY6QF.js";
 import {
   candidateDiffStat,
   claimCompeteGroup,
@@ -53,45 +54,44 @@ import {
   removeCandidateWorktreeMapped,
   settleCompeteGroupRun,
   settleRecoveredCompeteDecision
-} from "./chunk-TD3PGPQA.js";
+} from "./chunk-W6NIE6OW.js";
 import {
   compileExecutionPlan,
   requireAgentSteps
-} from "./chunk-THYWACCR.js";
+} from "./chunk-DZAW46HP.js";
 import "./chunk-RVG5JXAL.js";
 import "./chunk-3DPEIQKN.js";
-import "./chunk-6CCS4G3W.js";
-import "./chunk-6VC4OV3Z.js";
+import "./chunk-5PFYMY2V.js";
+import "./chunk-VIA6RFQZ.js";
 import {
   durableAssistantTextFromEvent
 } from "./chunk-T56WDKA5.js";
 import "./chunk-W6GROXXM.js";
-import "./chunk-AFKWHWXF.js";
+import "./chunk-4JDLP6ZS.js";
 import "./chunk-TXOTCRLG.js";
 import "./chunk-HVDIIIQW.js";
-import "./chunk-CTJ4RNAA.js";
+import "./chunk-3F7VUY77.js";
 import "./chunk-RKKLTLYB.js";
-import "./chunk-SUW5DORT.js";
-import {
-  RESOLVED_DISPATCH_PLAN_ARGUMENT,
-  describeDispatchPlan,
-  withResolvedPlanTaskPin
-} from "./chunk-JZWT5J3Y.js";
+import "./chunk-HLAFFSEK.js";
+import "./chunk-77QIVUZB.js";
 import {
   COMPETE_STANCES,
   COUNCIL_JUDGE_PROMPT,
   JUDGE_GATE_PROMPT,
+  RESOLVED_DISPATCH_PLAN_ARGUMENT,
   REVIEWER_GATE_PROMPT,
+  describeDispatchPlan,
   narrowDispatchIntentToReadOnly,
-  renderCouncilVoteMemberTask
-} from "./chunk-2VG7KLYV.js";
+  renderCouncilVoteMemberTask,
+  withResolvedPlanTaskPin
+} from "./chunk-IKSLQ4XV.js";
 import {
   explainRouteDecision
-} from "./chunk-7EPLI7VL.js";
-import "./chunk-6DWBAZ5U.js";
-import "./chunk-PVAMAVBB.js";
-import "./chunk-IXJT6DCX.js";
-import "./chunk-TVHHYFHE.js";
+} from "./chunk-HIICAHCJ.js";
+import "./chunk-Q4XWMHX6.js";
+import "./chunk-IDNA72AH.js";
+import "./chunk-FVDGR2ZL.js";
+import "./chunk-NEDJ26B5.js";
 import "./chunk-42FMPA75.js";
 import {
   gateDeciderAgentId,
@@ -100,13 +100,13 @@ import {
 import "./chunk-VN3SHNBN.js";
 import "./chunk-OQE5J4C6.js";
 import "./chunk-FSP7CMNU.js";
-import "./chunk-R23Z6K6I.js";
+import "./chunk-B7HM5Z7T.js";
 import "./chunk-OZNBF4L3.js";
 import "./chunk-4BJ5BYCE.js";
 import {
   truncateUtf8
 } from "./chunk-6XLNIQDB.js";
-import "./chunk-U2WB7TZS.js";
+import "./chunk-NMJXSHBJ.js";
 import "./chunk-VAVR4IJY.js";
 import "./chunk-2LEAKD4C.js";
 import "./chunk-HHV2GANA.js";
@@ -114,8 +114,8 @@ import {
   parseJsonObjectPayload,
   parseScoutResult,
   resultContractSourceId
-} from "./chunk-IG7BCQBA.js";
-import "./chunk-GCSMB2KY.js";
+} from "./chunk-PGF63K6I.js";
+import "./chunk-IKOZFYBN.js";
 import "./chunk-UL3WSD3F.js";
 import "./chunk-ECH6PKUQ.js";
 import "./chunk-5B2AEOW5.js";
@@ -124,29 +124,29 @@ import "./chunk-XAKHZX5N.js";
 import "./chunk-33YXPOE3.js";
 import "./chunk-7CR24IG7.js";
 import "./chunk-XPLRXC72.js";
-import "./chunk-UEDMSP56.js";
+import "./chunk-BYMNWQ7O.js";
 import "./chunk-CFGTUFWB.js";
 import "./chunk-72GZI5EV.js";
 import "./chunk-CWVRRIEI.js";
 import "./chunk-MQXIVJ35.js";
 import "./chunk-R346GLFC.js";
 import "./chunk-PMZVFWSR.js";
-import {
-  BusChannels
-} from "./chunk-HLW2MRKE.js";
 import "./chunk-BTK3SSSK.js";
 import "./chunk-IHXBNWMM.js";
-import "./chunk-EIMVLWB3.js";
+import "./chunk-34BHNEE3.js";
 import "./chunk-D7E7WCDF.js";
 import "./chunk-HJWWJ6IL.js";
+import {
+  BusChannels
+} from "./chunk-F4EKGO4N.js";
 import "./chunk-JIEGK6UF.js";
 import "./chunk-EBY63B7G.js";
 import "./chunk-6EJMN2Y3.js";
 import "./chunk-IWHMRKLL.js";
-import "./chunk-QKIFBZKT.js";
-import "./chunk-BWW4HLO4.js";
+import "./chunk-IMXMHHMQ.js";
+import "./chunk-UXCU4E3T.js";
 import "./chunk-LL4KHSZI.js";
-import "./chunk-NLFAQR7Z.js";
+import "./chunk-S66XZJOF.js";
 import "./chunk-CDNVLKUX.js";
 import "./chunk-WNP7O5WZ.js";
 import "./chunk-336NSSKI.js";
@@ -2335,4 +2335,4 @@ async function runWriterLimitedBatch(deps, requests, timeoutMs, signal) {
 export {
   runDispatchTool
 };
-//# sourceMappingURL=dispatch-runner-RGIE5PCT.js.map
+//# sourceMappingURL=dispatch-runner-2QQAITS3.js.map

package/dist/{docs-5NAF6AU7.js → docs-PD3EXDKU.js}

@@ -1,5 +1,4 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import "./chunk-ZW55JB7N.js";
 import {
   printError,
   printHeader
@@ -10,14 +9,6 @@ import {
 import {
   resolvePackageRoot
 } from "./chunk-IWHMRKLL.js";
-import "./chunk-WNP7O5WZ.js";
-import "./chunk-336NSSKI.js";
-import "./chunk-IKCO5N3L.js";
-import "./chunk-3I7MS7N2.js";
-import "./chunk-APJ265NV.js";
-import "./chunk-BYP5D4HI.js";
-import "./chunk-WEPFGWHJ.js";
-import "./chunk-YXLYO42X.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -25,7 +16,7 @@ import {
 // src/cli/docs.ts
 init_esm_shims();
 import { spawn } from "node:child_process";
-import { createReadStream, readdirSync, statSync } from "node:fs";
+import { createReadStream, readdirSync, realpathSync, statSync } from "node:fs";
 import { createServer } from "node:http";
 import { relative, resolve } from "node:path";
 var HOST = "127.0.0.1";
@@ -33,7 +24,8 @@ var HELP = `clio-coder docs [topic] [--no-open]
 
 Serve Clio Coder's interactive HTML documentation locally and open it in a
 browser. The blueprints live in docs/html of a source checkout; the npm package
-ships the Markdown guides in docs/ only. The server binds an ephemeral port on
+ships the categorized Markdown reference tree under docs/ and excludes HTML.
+The server binds an ephemeral port on
 127.0.0.1, keeps no state, runs no daemon, and reaches no external network.
 Press Ctrl+C to stop it.
 
@@ -125,7 +117,7 @@ function listHtmlFiles(htmlDir) {
   }
 }
 function createDocsRequestHandler(htmlDir) {
-  const root = resolve(htmlDir);
+  const root = realpathSync(resolve(htmlDir));
   return (req, res) => {
     if (req.method !== "GET" && req.method !== "HEAD") {
       res.writeHead(405, { "content-type": "text/plain; charset=utf-8", allow: "GET, HEAD" });
@@ -139,20 +131,27 @@ function createDocsRequestHandler(htmlDir) {
       res.end(resolved.reason);
       return;
     }
-    const target = resolve(root, resolved.relative);
-    if (!isWithin(target, root)) {
+    const requestedTarget = resolve(root, resolved.relative);
+    if (!isWithin(requestedTarget, root)) {
       res.writeHead(403, { "content-type": "text/plain; charset=utf-8" });
       res.end("forbidden");
       return;
     }
     let size = null;
+    let target = null;
     try {
+      target = realpathSync(requestedTarget);
+      if (!isWithin(target, root)) {
+        res.writeHead(403, { "content-type": "text/plain; charset=utf-8" });
+        res.end("forbidden");
+        return;
+      }
       const stat = statSync(target);
       if (stat.isFile()) size = stat.size;
     } catch {
       size = null;
     }
-    if (size === null) {
+    if (size === null || target === null) {
       res.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
       res.end("not found");
       return;
@@ -246,14 +245,14 @@ async function runDocsCommand(args = []) {
   try {
     htmlDir = resolveDocsHtmlDir();
   } catch (err) {
-    printError(`could not resolve bundled docs: ${err instanceof Error ? err.message : String(err)}`);
+    printError(`could not resolve the docs HTML root: ${err instanceof Error ? err.message : String(err)}`);
     return 1;
   }
   const files = listHtmlFiles(htmlDir);
   if (files.length === 0) {
     printError(`no HTML docs at ${htmlDir}`);
     process.stdout.write(
-      `  the npm package ships the Markdown guides only: ${resolve(resolvePackageRoot(), "docs")}
+      `  the npm package ships only the categorized Markdown reference tree: ${resolve(resolvePackageRoot(), "docs")}
   the interactive blueprints are in a source checkout and at https://github.com/iowarp/clio-coder/tree/main/docs/html
 `
     );
@@ -275,7 +274,7 @@ async function runDocsCommand(args = []) {
   const handle = await startDocsServer({ htmlDir });
   const landingUrl = landing === "index.html" ? handle.url : `${handle.url}${landing}`;
   printHeader("Clio docs viewer");
-  process.stdout.write(`  serving ${htmlDir}
+  process.stdout.write(`  serving HTML root ${htmlDir}
 `);
   process.stdout.write(`  open ${source_default.cyan(landingUrl)}
 `);
@@ -288,6 +287,8 @@ async function runDocsCommand(args = []) {
   return 0;
 }
 export {
-  runDocsCommand
+  createDocsRequestHandler,
+  runDocsCommand,
+  waitForShutdown
 };
-//# sourceMappingURL=docs-5NAF6AU7.js.map
+//# sourceMappingURL=docs-PD3EXDKU.js.map