@iowarp/clio-coder 0.4.2 → 0.4.4

package/dist/{chunk-SSEYRH53.js → chunk-IZXGRF7P.js}

@@ -1,15 +1,14 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  planWikiGeneration
+} from "./chunk-R6Q67RJH.js";
 import {
   loadFragments,
   renderCodewikiDigest
-} from "./chunk-AZ4WMN4W.js";
+} from "./chunk-V6HJFQZE.js";
 import {
   loadMemoryRecordsSync
-} from "./chunk-JBCS7CRR.js";
-import {
-  createTomlFileReader,
-  tomlTableAt
-} from "./chunk-LCGCVYZ4.js";
+} from "./chunk-EL24TAU4.js";
 import {
   WIKI_INDEX,
   WIKI_PLAN_FILE,
@@ -35,7 +34,7 @@ import {
   wikiStaleness,
   writeWikiMeta,
   writeWikiPlanFile
-} from "./chunk-NDINPTJ4.js";
+} from "./chunk-ELZVTCGV.js";
 import {
   buildCodewikiCandidate,
   coordinateCodewikiExclusive,
@@ -45,6 +44,23 @@ import {
   statePath,
   writeClioState
 } from "./chunk-MXHC5QYU.js";
+import {
+  readSessionEntriesForId
+} from "./chunk-6UINWWS6.js";
+import {
+  filterEntriesToActivePath
+} from "./chunk-W6GROXXM.js";
+import {
+  foldDecisionBoard
+} from "./chunk-I2DWJ4GM.js";
+import {
+  createTomlFileReader,
+  tomlTableAt
+} from "./chunk-LCGCVYZ4.js";
+import {
+  describeValidationContract,
+  loadValidationContract
+} from "./chunk-V76WTFTW.js";
 import {
   classifyProjectPreload
 } from "./chunk-JVCV3ICN.js";
@@ -52,6 +68,18 @@ import {
   compileGlobRegex,
   normalizeGlobInput
 } from "./chunk-VG7TBQIY.js";
+import {
+  decisionRef
+} from "./chunk-54X7T7DK.js";
+import {
+  ceilChars
+} from "./chunk-NZMNUPZZ.js";
+import {
+  INTEROP_AGENT_KINDS
+} from "./chunk-KXDSS5WJ.js";
+import {
+  BusChannels
+} from "./chunk-F4EKGO4N.js";
 import {
   computeFingerprintCached,
   isStale
@@ -66,20 +94,12 @@ import {
 import {
   enumerateWorkspaceFiles
 } from "./chunk-33YXPOE3.js";
-import {
-  ceilChars
-} from "./chunk-CWVRRIEI.js";
-import {
-  INTEROP_AGENT_KINDS
-} from "./chunk-IHXBNWMM.js";
-import {
-  BusChannels
-} from "./chunk-F4EKGO4N.js";
 import {
   require_dist
 } from "./chunk-APJ265NV.js";
 import {
   clioDataDir,
+  clioStateDir,
   resolveClioDirs
 } from "./chunk-BYP5D4HI.js";
 import {
@@ -2998,126 +3018,6 @@ function normalizeRepoPath(sourceRoot, candidate) {
   return rel.split("\\").join("/");
 }
 
-// src/domains/context/wiki/plan.ts
-init_esm_shims();
-var WIKI_DEPTH_STRATEGY = {
-  simple: { areaDepth: 1, areaShare: 0.08, minAreaLines: 400 },
-  medium: { areaDepth: 2, areaShare: 0.03, minAreaLines: 250 },
-  detailed: { areaDepth: 3, areaShare: 8e-3, minAreaLines: 150 }
-};
-var MAX_PAGE_SOURCES = 8;
-function areaForPath(path, maxDepth) {
-  const directories = path.split("/").filter(Boolean).slice(0, -1);
-  if (directories.length === 0) return ".";
-  return directories.slice(0, Math.max(1, maxDepth)).join("/");
-}
-function classifyDepth(sourceFiles, sourceLines) {
-  if (sourceFiles <= 150 && sourceLines <= 3e4) return "simple";
-  if (sourceFiles <= 800 && sourceLines <= 15e4) return "medium";
-  return "detailed";
-}
-function slugSegment(segment) {
-  const slug = segment.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
-  return slug.length > 0 ? slug : "section";
-}
-function areaSegments(area) {
-  const parts = area.split("/").filter((part) => part.length > 0 && part !== ".");
-  if (parts.length === 0) return ["root"];
-  if (parts[0] !== "src") return parts;
-  return parts.length === 1 ? ["source"] : parts.slice(1);
-}
-function pagePathForArea(area) {
-  return `${areaSegments(area).map(slugSegment).join("/")}.md`;
-}
-function titleForArea(area) {
-  const name2 = areaSegments(area).join(" ").replace(/[-_]+/g, " ").trim();
-  return name2.length > 0 ? name2.charAt(0).toUpperCase() + name2.slice(1) : "Overview";
-}
-function rankedSources(files) {
-  return [...files].sort((a, b) => {
-    const roleRank = (file) => file.role === "entry" ? 0 : file.role === "test" ? 2 : 1;
-    return roleRank(a) - roleRank(b) || b.loc - a.loc || a.path.localeCompare(b.path);
-  }).slice(0, MAX_PAGE_SOURCES).map((file) => file.path);
-}
-function collectAreas(source, areaDepth) {
-  const byKey = /* @__PURE__ */ new Map();
-  for (const file of source) {
-    const key = areaForPath(file.path, areaDepth);
-    const area = byKey.get(key) ?? { key, files: [], lines: 0 };
-    area.files.push(file);
-    area.lines += Math.max(0, file.loc);
-    byKey.set(key, area);
-  }
-  return [...byKey.values()].sort((a, b) => b.lines - a.lines || a.key.localeCompare(b.key));
-}
-function overviewPage(source) {
-  const entries = source.filter((file) => file.role === "entry");
-  return {
-    path: "architecture.md",
-    title: "Architecture",
-    intent: "Explain what this repository is, its top-level composition, how a request or command flows through it, and where the boundaries between its major areas are.",
-    sources: rankedSources(entries.length > 0 ? entries : source),
-    status: "pending",
-    attempts: 0
-  };
-}
-function buildCandidatePlan(codewiki, depth) {
-  const source = codewiki.files.filter((file) => file.lang !== "config");
-  const totalLines = source.reduce((total, file) => total + Math.max(0, file.loc), 0);
-  const { areaDepth, areaShare, minAreaLines } = WIKI_DEPTH_STRATEGY[depth];
-  const threshold = Math.max(minAreaLines, Math.floor(totalLines * areaShare));
-  const areas = collectAreas(source, areaDepth);
-  const included = areas.filter((area) => area.lines >= threshold);
-  const selected = included.length > 0 ? included : areas.slice(0, 1);
-  const selectedKeys = new Set(selected.map((area) => area.key));
-  const extras = /* @__PURE__ */ new Map();
-  for (const area of areas) {
-    if (selectedKeys.has(area.key)) continue;
-    const ancestor = selected.find((candidate) => area.key.startsWith(`${candidate.key}/`));
-    const host = ancestor?.key ?? selected[0]?.key;
-    if (host === void 0) continue;
-    extras.set(host, [...extras.get(host) ?? [], ...area.files]);
-  }
-  const pages = selected.map((area) => {
-    const files = [...area.files, ...extras.get(area.key) ?? []];
-    return {
-      path: pagePathForArea(area.key),
-      title: titleForArea(area.key),
-      intent: `Document ${area.key} (${area.files.length} indexed files, ${area.lines} lines): what it owns, its entry points and important symbols, the state and lifecycle invariants it enforces, an upstream caller and a downstream dependency, the focused tests that prove its behavior, and what to watch when editing it.`,
-      sources: rankedSources(files),
-      status: "pending",
-      attempts: 0
-    };
-  });
-  return dedupePagePaths({
-    version: 1,
-    overview: "",
-    pages: [overviewPage(source), ...pages]
-  });
-}
-function dedupePagePaths(plan) {
-  const seen = /* @__PURE__ */ new Set();
-  const pages = [];
-  for (const page of plan.pages) {
-    let path = page.path;
-    let suffix = 2;
-    while (seen.has(path)) {
-      path = page.path.replace(/\.md$/, `-${suffix}.md`);
-      suffix += 1;
-    }
-    seen.add(path);
-    pages.push({ ...page, path });
-  }
-  return { ...plan, pages };
-}
-function planWikiGeneration(codewiki, requestedDepth = "auto") {
-  const source = codewiki.files.filter((file) => file.lang !== "config");
-  const sourceFiles = source.length;
-  const sourceLines = source.reduce((total, file) => total + Math.max(0, file.loc), 0);
-  const depth = requestedDepth === "auto" ? classifyDepth(sourceFiles, sourceLines) : requestedDepth;
-  return { requestedDepth, depth, sourceFiles, sourceLines, plan: buildCandidatePlan(codewiki, depth) };
-}
-
 // src/domains/context/wiki/generate.ts
 function progress2(input, event) {
   input.onProgress?.(event);
@@ -3399,6 +3299,7 @@ async function runWikiGenerate(input = { model: "configured-clio-target" }) {
         plan: resolved.plan,
         resumed: resolved.resumed,
         unclaimedAreas: resolved.unclaimedAreas,
+        ...input.decisions ? { decisions: input.decisions } : {},
         gitHead: existingMeta?.gitHead ?? null,
         ...input.onProgress ? { progress: input.onProgress } : {}
       });
@@ -3573,6 +3474,7 @@ async function runContextRefresh(input = {}) {
     wikiResult = await runWikiGenerate({
       cwd,
       mode: "update",
+      ...input.decisions ? { decisions: input.decisions } : {},
       model: input.wikiModel ?? "unresolved-documenter-target",
       ...input.wikiGenerate ? { generate: input.wikiGenerate } : {},
       ...input.onProgress ? { onProgress: input.onProgress } : {}
@@ -3691,6 +3593,10 @@ function collectStartupHints(cwd, options = {}) {
   for (const issue of clio.errors) {
     hints.push(`clio-coder: malformed ${issue.path} ignored: ${issue.error}`);
   }
+  const contract = loadValidationContract(cwd);
+  if (!contract.ok) {
+    hints.push(`clio-coder: validation contract ignored, rigor stays normal: ${describeValidationContract(contract)}`);
+  }
   const state = readClioState(cwd);
   if (!state) return hints;
   if (state.contextSources !== void 0 && adoptionSourcesChanged(state.contextSources, { cwd })) {
@@ -3806,9 +3712,11 @@ function createContextBundle(_context, options = {}) {
         input?.onProgress?.(event);
       };
       try {
-        const result = await runContextRefresh(
-          input ? { ...input, onProgress: emitProgress } : { onProgress: emitProgress }
-        );
+        const result = await runContextRefresh({
+          ...input,
+          ...input?.wiki ? { decisions: input.decisions ?? await currentDecisions(_context) } : {},
+          onProgress: emitProgress
+        });
         const cwd = input?.cwd ?? process.cwd();
         contextState.invalidate(cwd);
         if (cwd === lastCwd) startupHints = collectStartupHints(cwd, options);
@@ -3829,9 +3737,11 @@ function createContextBundle(_context, options = {}) {
         input?.onProgress?.(event);
       };
       try {
-        return await runWikiGenerate(
-          input ? { ...input, onProgress: emitProgress } : { model: "configured-clio-target", onProgress: emitProgress }
-        );
+        return await runWikiGenerate({
+          ...input ?? { model: "configured-clio-target" },
+          decisions: input?.decisions ?? await currentDecisions(_context),
+          onProgress: emitProgress
+        });
       } catch (err) {
         emitProgress({
           phase: "done",
@@ -3860,6 +3770,14 @@ function createContextBundle(_context, options = {}) {
   };
   return { extension, contract };
 }
+async function currentDecisions(context) {
+  const session = context.getContract("session");
+  const current = session?.current();
+  if (!session || !current) return [];
+  session.flushAppends?.();
+  const read = await readSessionEntriesForId(clioStateDir(), current.id);
+  return foldDecisionBoard(filterEntriesToActivePath(read.entries, session.tree(current.id).leafId ?? void 0));
+}
 
 // src/domains/context/manifest.ts
 init_esm_shims();
@@ -4060,6 +3978,8 @@ ${page.sources.map((source) => `- ${source}`).join("\n")}` : "No anchor sources
     "## Repository guidance",
     repositoryGuidance(input.cwd)
   ];
+  const decisions = recordedDecisions(input);
+  if (decisions.length > 0) sections.push("# Recorded decisions", "```json", JSON.stringify(decisions, null, 2), "```");
   if (input.seeded) {
     sections.push(
       "## Revision",
@@ -4069,6 +3989,35 @@ ${page.sources.map((source) => `- ${source}`).join("\n")}` : "No anchor sources
   return `${sections.join("\n\n")}
 `;
 }
+function underSource(path, source) {
+  const root = source.replace(/^\.\//, "").replace(/\/$/, "");
+  const candidate = path.replace(/^\.\//, "");
+  return candidate === root || candidate.startsWith(`${root}/`);
+}
+function recordedDecisions(input) {
+  const files = new Set(
+    input.codewiki.files.filter((file) => input.page.sources.some((source) => underSource(file.path, source))).map((file) => file.id)
+  );
+  const symbols = new Set(
+    input.codewiki.symbols.filter((symbol) => files.has(symbol.fileId)).map((symbol) => symbol.name)
+  );
+  return (input.decisions ?? []).flatMap(
+    (entry) => entry.decisions.filter((record) => {
+      if (record.status !== "active") return false;
+      if (symbols.has(record.key)) return true;
+      const paths = [record.rationale ?? "", ...record.alternatives ?? []].join(" ").match(/[\w@./-]+/g) ?? [];
+      return paths.some((path) => input.page.sources.some((source) => underSource(path.replace(/\.$/, ""), source)));
+    }).map((record) => ({
+      ref: decisionRef(entry.interviewId, record.key),
+      key: record.key,
+      value: record.value,
+      alternatives: record.alternatives ?? [],
+      rationale: record.rationale ?? record.source_question ?? "",
+      decidedAt: record.decidedAt,
+      source: record.source ?? (entry.origin === "agent" ? "agent" : "operator")
+    }))
+  ).slice(0, 12);
+}
 
 export {
   adoptionSnapshotsHash,
@@ -4089,10 +4038,6 @@ export {
   loadProjectRules,
   selectActiveRules,
   assembleWikiTree,
-  WIKI_DEPTH_STRATEGY,
-  pagePathForArea,
-  buildCandidatePlan,
-  planWikiGeneration,
   runWikiGenerate,
   runContextRefresh,
   ContextDomainModule,
@@ -4100,4 +4045,4 @@ export {
   buildWikiPlanPrompt,
   buildWikiPagePrompt
 };
-//# sourceMappingURL=chunk-SSEYRH53.js.map
+//# sourceMappingURL=chunk-IZXGRF7P.js.map

package/dist/{chunk-5TSRNF4G.js → chunk-JCI2ROMZ.js}

@@ -195,16 +195,16 @@ var ansi_styles_default = ansiStyles;
 
 // node_modules/chalk/source/vendor/supports-color/index.js
 init_esm_shims();
-import process from "node:process";
+import process2 from "node:process";
 import os from "node:os";
 import tty from "node:tty";
-function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : process.argv) {
+function hasFlag(flag, argv = globalThis.Deno ? globalThis.Deno.args : process2.argv) {
   const prefix = flag.startsWith("-") ? "" : flag.length === 1 ? "-" : "--";
   const position = argv.indexOf(prefix + flag);
   const terminatorPosition = argv.indexOf("--");
   return position !== -1 && (terminatorPosition === -1 || position < terminatorPosition);
 }
-var { env } = process;
+var { env } = process2;
 var flagForceColor;
 if (hasFlag("no-color") || hasFlag("no-colors") || hasFlag("color=false") || hasFlag("color=never")) {
   flagForceColor = 0;
@@ -260,7 +260,7 @@ function _supportsColor(haveStream, { streamIsTTY, sniffFlags = true } = {}) {
   if (env.TERM === "dumb") {
     return min;
   }
-  if (process.platform === "win32") {
+  if (process2.platform === "win32") {
     const osRelease = os.release().split(".");
     if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
       return Number(osRelease[2]) >= 14931 ? 3 : 2;
@@ -504,7 +504,165 @@ var chalk = createChalk();
 var chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
 var source_default = chalk;
 
+// src/cli/argv.ts
+init_esm_shims();
+function printError(message, detail) {
+  const head = source_default.red("error:");
+  process.stderr.write(`${head} ${message}
+`);
+  if (detail) process.stderr.write(`  ${detail}
+`);
+}
+function printNote(message) {
+  process.stderr.write(`${source_default.yellow("note:")} ${message}
+`);
+}
+function printOk(message) {
+  process.stdout.write(`${source_default.green("ok:")} ${message}
+`);
+}
+function printHeader(message) {
+  process.stdout.write(`${source_default.cyan(message)}
+`);
+}
+function columnWidths(rows) {
+  const widths = [];
+  for (const row of rows) {
+    for (let i = 0; i < row.length; i += 1) {
+      widths[i] = Math.max(widths[i] ?? 0, row[i]?.length ?? 0);
+    }
+  }
+  return widths;
+}
+function formatColumnRow(row, widths, gap = 2) {
+  return row.map((cell, index) => {
+    if (index === row.length - 1) return cell;
+    return cell.padEnd((widths[index] ?? cell.length) + gap);
+  }).join("").trimEnd();
+}
+function formatColumns(rows, gap = 2) {
+  if (rows.length === 0) return "";
+  const widths = columnWidths(rows);
+  return `${rows.map((row) => formatColumnRow(row, widths, gap)).join("\n")}
+`;
+}
+function parseFlags(argv) {
+  const flags = /* @__PURE__ */ new Set();
+  const positional = [];
+  for (const arg of argv) {
+    if (arg.startsWith("--")) flags.add(arg.slice(2));
+    else if (arg.startsWith("-") && arg.length > 1) flags.add(arg.slice(1));
+    else positional.push(arg);
+  }
+  return { flags, positional };
+}
+var ROOT_FLAG_TOKENS = /* @__PURE__ */ new Set(["--help", "-h", "--all", "--version", "-v"]);
+var GLOBAL_ONLY_FLAGS = /* @__PURE__ */ new Map([
+  ["--api-key", "--api-key <key>"],
+  ["--no-context-files", "--no-context-files"],
+  ["-nc", "-nc"],
+  ["--with-panes", "--with-panes"],
+  ["--no-panes", "--no-panes"]
+]);
+function globalFlagPositionHint(arg, command) {
+  const usage = GLOBAL_ONLY_FLAGS.get(arg);
+  if (usage === void 0) return null;
+  return `${arg} is a global option and must come before the subcommand: clio-coder ${usage} ${command} ...`;
+}
+function unknownGlobalOptionError(arg) {
+  const bare = arg.replace(/=.*$/u, "");
+  if (bare === "--resume" || bare === "--continue" || bare === "-r" || bare === "-c") {
+    return `unknown global option: ${arg}. Sessions are resumed from inside the app: start clio-coder, then type /resume to pick one.`;
+  }
+  return `unknown global option: ${arg}`;
+}
+function extractGlobalFlags(argv, isSubcommand = () => false) {
+  const rest = [];
+  let apiKey;
+  let noContextFiles = false;
+  let noSkills = false;
+  let panes;
+  const skillPaths = [];
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === void 0) continue;
+    if (arg === "--") {
+      rest.push(...argv.slice(i + 1));
+      break;
+    }
+    if (!arg.startsWith("-")) {
+      rest.push(...argv.slice(i));
+      break;
+    }
+    if (arg === "--acp") {
+      rest.push("acp", ...argv.slice(i + 1));
+      break;
+    }
+    if (ROOT_FLAG_TOKENS.has(arg)) {
+      rest.push(arg);
+      continue;
+    }
+    if (arg === "--no-context-files" || arg === "-nc") {
+      noContextFiles = true;
+      continue;
+    }
+    if (arg === "--no-skills") {
+      noSkills = true;
+      continue;
+    }
+    if (arg === "--with-panes" || arg === "--no-panes") {
+      panes = arg === "--with-panes" ? "with" : "without";
+      continue;
+    }
+    if (arg === "--api-key" || arg === "--skill") {
+      const value = argv[i + 1];
+      if (value === void 0 || value.startsWith("-") || isSubcommand(value)) {
+        return {
+          noContextFiles,
+          noSkills,
+          skillPaths,
+          rest,
+          error: `${arg} requires a value`,
+          ...apiKey === void 0 ? {} : { apiKey },
+          ...panes === void 0 ? {} : { panes }
+        };
+      }
+      if (arg === "--api-key") apiKey = value;
+      else skillPaths.push(value);
+      i += 1;
+      continue;
+    }
+    return {
+      noContextFiles,
+      noSkills,
+      skillPaths,
+      rest,
+      error: unknownGlobalOptionError(arg),
+      ...apiKey === void 0 ? {} : { apiKey },
+      ...panes === void 0 ? {} : { panes }
+    };
+  }
+  return {
+    noContextFiles,
+    noSkills,
+    skillPaths,
+    rest,
+    ...apiKey === void 0 ? {} : { apiKey },
+    ...panes === void 0 ? {} : { panes }
+  };
+}
+
 export {
-  source_default
+  source_default,
+  printError,
+  printNote,
+  printOk,
+  printHeader,
+  columnWidths,
+  formatColumnRow,
+  formatColumns,
+  parseFlags,
+  globalFlagPositionHint,
+  extractGlobalFlags
 };
-//# sourceMappingURL=chunk-5TSRNF4G.js.map
+//# sourceMappingURL=chunk-JCI2ROMZ.js.map

package/dist/{chunk-JWJGP5DQ.js → chunk-JEIYHLOR.js}

@@ -2,26 +2,26 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   INTEROP_AGENT_KINDS,
   interopAgentKind
-} from "./chunk-IHXBNWMM.js";
+} from "./chunk-KXDSS5WJ.js";
 import {
   readSettings,
   updateSettings
-} from "./chunk-34BHNEE3.js";
+} from "./chunk-GHS5EBTQ.js";
 import {
   runCommandVector
-} from "./chunk-HJWWJ6IL.js";
+} from "./chunk-TOIVGRUX.js";
 import {
   withStateFileLockSync
 } from "./chunk-IKCO5N3L.js";
 import {
   require_dist
 } from "./chunk-APJ265NV.js";
-import {
-  clioStateDir
-} from "./chunk-BYP5D4HI.js";
 import {
   safeResourceWrite
 } from "./chunk-WEPFGWHJ.js";
+import {
+  clioStateDir
+} from "./chunk-BYP5D4HI.js";
 import {
   __toESM,
   init_esm_shims
@@ -430,4 +430,4 @@ export {
   detectInteropAgents,
   InteropDomainModule
 };
-//# sourceMappingURL=chunk-JWJGP5DQ.js.map
+//# sourceMappingURL=chunk-JEIYHLOR.js.map

package/dist/{chunk-F2I26BDK.js → chunk-JQLNNIKT.js}

@@ -1,13 +1,13 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   runPending
-} from "./chunk-DYHAXKHD.js";
+} from "./chunk-GWZNEVM2.js";
 import {
   runDoctor
-} from "./chunk-QQLGQY2A.js";
+} from "./chunk-2ASED4PZ.js";
 import {
   readStateInfo
-} from "./chunk-XQRY4DTA.js";
+} from "./chunk-IGLP3ODT.js";
 import {
   getVersionInfo
 } from "./chunk-XPLRXC72.js";
@@ -63,4 +63,4 @@ export {
   describeUpgradeNotice,
   LifecycleDomainModule
 };
-//# sourceMappingURL=chunk-F2I26BDK.js.map
+//# sourceMappingURL=chunk-JQLNNIKT.js.map