@iowarp/clio-coder 0.4.3 → 0.4.4

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

@@ -5,10 +5,10 @@ import {
 import {
   loadFragments,
   renderCodewikiDigest
-} from "./chunk-Y3CBHOR6.js";
+} from "./chunk-V6HJFQZE.js";
 import {
   loadMemoryRecordsSync
-} from "./chunk-BEPZRGGU.js";
+} from "./chunk-EL24TAU4.js";
 import {
   WIKI_INDEX,
   WIKI_PLAN_FILE,
@@ -34,7 +34,7 @@ import {
   wikiStaleness,
   writeWikiMeta,
   writeWikiPlanFile
-} from "./chunk-NDINPTJ4.js";
+} from "./chunk-ELZVTCGV.js";
 import {
   buildCodewikiCandidate,
   coordinateCodewikiExclusive,
@@ -44,10 +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";
@@ -55,6 +68,9 @@ import {
   compileGlobRegex,
   normalizeGlobInput
 } from "./chunk-VG7TBQIY.js";
+import {
+  decisionRef
+} from "./chunk-54X7T7DK.js";
 import {
   ceilChars
 } from "./chunk-NZMNUPZZ.js";
@@ -83,6 +99,7 @@ import {
 } from "./chunk-APJ265NV.js";
 import {
   clioDataDir,
+  clioStateDir,
   resolveClioDirs
 } from "./chunk-BYP5D4HI.js";
 import {
@@ -3282,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 } : {}
       });
@@ -3456,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 } : {}
@@ -3574,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 })) {
@@ -3689,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);
@@ -3712,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",
@@ -3743,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();
@@ -3943,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",
@@ -3952,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,
@@ -3979,4 +4045,4 @@ export {
   buildWikiPlanPrompt,
   buildWikiPagePrompt
 };
-//# sourceMappingURL=chunk-KK4JZPBQ.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-INY6HTFL.js → chunk-JEIYHLOR.js}

@@ -9,7 +9,7 @@ import {
 } from "./chunk-GHS5EBTQ.js";
 import {
   runCommandVector
-} from "./chunk-JSC3U7TI.js";
+} from "./chunk-TOIVGRUX.js";
 import {
   withStateFileLockSync
 } from "./chunk-IKCO5N3L.js";
@@ -430,4 +430,4 @@ export {
   detectInteropAgents,
   InteropDomainModule
 };
-//# sourceMappingURL=chunk-INY6HTFL.js.map
+//# sourceMappingURL=chunk-JEIYHLOR.js.map

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

@@ -4,7 +4,7 @@ import {
 } from "./chunk-GWZNEVM2.js";
 import {
   runDoctor
-} from "./chunk-N2Z7HLVY.js";
+} from "./chunk-2ASED4PZ.js";
 import {
   readStateInfo
 } from "./chunk-IGLP3ODT.js";
@@ -63,4 +63,4 @@ export {
   describeUpgradeNotice,
   LifecycleDomainModule
 };
-//# sourceMappingURL=chunk-MUW2BDDH.js.map
+//# sourceMappingURL=chunk-JQLNNIKT.js.map

package/dist/{chunk-XPWWI35G.js → chunk-JSD46VO2.js}

@@ -39,13 +39,13 @@ import {
   registerBuiltinRuntimes,
   requestLmStudioJson,
   resolveLmStudioInstance
-} from "./chunk-VW6DOEDG.js";
+} from "./chunk-6OSVSQL5.js";
 import {
   sleep
 } from "./chunk-EBY63B7G.js";
 import {
   listKnownModelsForRuntime
-} from "./chunk-LLDJM5XK.js";
+} from "./chunk-26QSH3EJ.js";
 import {
   authNotRequiredStatus,
   openAuthStorage,
@@ -760,9 +760,6 @@ function runOverrides(env = process.env) {
   if (typeof maxContextTokens === "number" && Number.isInteger(maxContextTokens) && maxContextTokens > 0) {
     out.maxContextTokens = maxContextTokens;
   }
-  if (typeof record.kvCacheMode === "string" && record.kvCacheMode.length > 0) {
-    out.kvCacheMode = record.kvCacheMode;
-  }
   const sampling = record.sampling;
   if (sampling !== null && typeof sampling === "object" && !Array.isArray(sampling)) {
     const numeric = {};
@@ -1549,8 +1546,7 @@ function modelResidencyForStatus(status, modelId) {
   }
 }
 function hasLiveModelCatalog(status) {
-  if (status.discoveredModelsSource === "probe" || status.discoveredModelsSource === "cache") return true;
-  return status.discoveredModelsSource === void 0 && status.discoveredModels.length > 0;
+  return status.discoveredModelsSource === "probe" || status.discoveredModelsSource === "cache";
 }
 function modelCandidatesForStatus(status) {
   const configured = uniqueModels(status.target.wireModels ?? []);
@@ -2443,6 +2439,7 @@ function mergeSamplingOverride(profile, override = runSamplingOverrides()) {
 
 // src/engine/apis/ollama-native.ts
 var REASONING_CHARS_PER_TOKEN = 4;
+var ownedModelsByTarget = /* @__PURE__ */ new Map();
 function clioQuirks(model) {
   return model.clioCoder?.quirks;
 }
@@ -2608,7 +2605,10 @@ async function listResidentOllamaModels(client) {
   });
 }
 async function unloadOllamaModel(baseUrl, modelId, headers) {
+  const owned = ownedModelsByTarget.get(residencyTargetKey("ollama-native", baseUrl));
+  if (!owned?.has(modelId)) return;
   await ollamaEvictClient(baseUrl, headers).generate({ model: modelId, prompt: "", keep_alive: 0, stream: false });
+  owned.delete(modelId);
 }
 function mapStopReason(reason, hadToolCall) {
   if (hadToolCall) return "toolUse";
@@ -2764,8 +2764,19 @@ function runStream(model, context, options, thinkingLevel) {
           else emitText(segment.content);
         }
       };
+      let recordedOwnership = false;
       for await (const chunk of iterator) {
         const response = chunk;
+        if (!recordedOwnership && model.baseUrl) {
+          const targetKey = residencyTargetKey("ollama-native", model.baseUrl);
+          let owned = ownedModelsByTarget.get(targetKey);
+          if (!owned) {
+            owned = /* @__PURE__ */ new Set();
+            ownedModelsByTarget.set(targetKey, owned);
+          }
+          owned.add(response.model || model.id);
+          recordedOwnership = true;
+        }
         const msg = response.message;
         if (msg?.thinking && msg.thinking.length > 0) {
           emitThinking(msg.thinking);
@@ -5031,4 +5042,4 @@ export {
   resolveCostProvenance2 as resolveCostProvenance,
   ProvidersDomainModule
 };
-//# sourceMappingURL=chunk-XPWWI35G.js.map
+//# sourceMappingURL=chunk-JSD46VO2.js.map

package/dist/{chunk-VA5FNYMT.js → chunk-JT2RFCC5.js}

@@ -1,4 +1,7 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  FAILURE_CAUSE_TAGS
+} from "./chunk-NRO2BJRH.js";
 import {
   withStateFileLock,
   withStateFileLockSync
@@ -23,7 +26,7 @@ function indexPath(stateDir) {
 function isEvidenceIndexRow(value) {
   if (typeof value !== "object" || value === null) return false;
   const row = value;
-  return typeof row.runId === "string" && typeof row.evidenceId === "string" && Array.isArray(row.tags) && row.tags.every((tag) => typeof tag === "string") && typeof row.firstPassSuccess === "boolean" && typeof row.findingCount === "number" && typeof row.generatedAt === "string";
+  return typeof row.runId === "string" && typeof row.evidenceId === "string" && Array.isArray(row.tags) && row.tags.every((tag) => typeof tag === "string") && typeof row.firstPassSuccess === "boolean" && typeof row.findingCount === "number" && (row.succeeded === void 0 || typeof row.succeeded === "boolean") && (row.completionEvidenceWarning === void 0 || typeof row.completionEvidenceWarning === "boolean") && (row.ungroundedClaims === void 0 || typeof row.ungroundedClaims === "number" && Number.isSafeInteger(row.ungroundedClaims) && row.ungroundedClaims >= 0) && typeof row.generatedAt === "string";
 }
 function readEvidenceIndex(stateDir) {
   let raw;
@@ -62,6 +65,38 @@ async function writeEvidenceIndexRowQueued(stateDir, row) {
   return written;
 }
 
+// src/domains/observability/accountability.ts
+init_esm_shims();
+function summarizeEvidenceIndex(rows) {
+  const totalRuns = rows.length;
+  let firstPassRuns = 0;
+  let unverifiedSuccesses = 0;
+  let ungroundedClaims = 0;
+  const counts = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (row.firstPassSuccess) firstPassRuns += 1;
+    if (row.succeeded === true && (row.tags.includes("no-validation") || row.tags.includes("proxy-validation") || row.completionEvidenceWarning === true))
+      unverifiedSuccesses += 1;
+    ungroundedClaims += row.ungroundedClaims ?? 0;
+    for (const tag of row.tags) {
+      if (!FAILURE_CAUSE_TAGS.has(tag)) continue;
+      counts.set(tag, (counts.get(tag) ?? 0) + 1);
+    }
+  }
+  const failureCauses = [...counts.entries()].map(([tag, count]) => ({ tag, count })).sort((a, b) => b.count !== a.count ? b.count - a.count : a.tag.localeCompare(b.tag));
+  return {
+    totalRuns,
+    firstPassRuns,
+    firstPassRate: totalRuns === 0 ? 0 : firstPassRuns / totalRuns,
+    unverifiedSuccesses,
+    ungroundedClaims,
+    failureCauses
+  };
+}
+function readAccountabilitySummary(stateDir) {
+  return summarizeEvidenceIndex(readEvidenceIndex(stateDir));
+}
+
 // src/domains/observability/out-of-turn-usage.ts
 init_esm_shims();
 import { closeSync, fsyncSync, mkdirSync, openSync, readFileSync as readFileSync2, writeSync } from "node:fs";
@@ -223,7 +258,9 @@ function messageOf(error) {
 export {
   readEvidenceIndex,
   writeEvidenceIndexRowQueued,
+  summarizeEvidenceIndex,
+  readAccountabilitySummary,
   appendOutOfTurnUsageRow,
   readOutOfTurnUsageRows
 };
-//# sourceMappingURL=chunk-VA5FNYMT.js.map
+//# sourceMappingURL=chunk-JT2RFCC5.js.map