@iowarp/clio-coder 0.4.2 → 0.4.3

package/dist/{chunk-ZW55JB7N.js → chunk-PUVDKJ2Y.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-5TSRNF4G.js";
 import {
   authStoragePath
-} from "./chunk-WNP7O5WZ.js";
+} from "./chunk-ID64D7PE.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -35,4 +35,4 @@ export {
   printPlaintextCredentialWarning,
   credentialWriteFailed
 };
-//# sourceMappingURL=chunk-ZW55JB7N.js.map
+//# sourceMappingURL=chunk-PUVDKJ2Y.js.map

package/dist/{chunk-UH347SHR.js → chunk-QWGDJJYJ.js}

@@ -1,13 +1,13 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   migrateSettingsV1Document
-} from "./chunk-3KIPBMUA.js";
+} from "./chunk-5ICU3EUH.js";
 import {
   parseAgentRecipeSchema
-} from "./chunk-CRFOIAX3.js";
+} from "./chunk-RRNP2ANY.js";
 import {
   parseFleetContract
-} from "./chunk-3F7VUY77.js";
+} from "./chunk-2VIKGWFZ.js";
 import {
   parseFrontmatter
 } from "./chunk-RKKLTLYB.js";
@@ -17,17 +17,17 @@ import {
   installExtension,
   listInstalledExtensions,
   loadManifestFromRoot
-} from "./chunk-77QIVUZB.js";
+} from "./chunk-5MEZN6CB.js";
 import {
   assertAgentSpecPolicy,
   normalizeAgentSpec
-} from "./chunk-PGF63K6I.js";
+} from "./chunk-B4OAX3SI.js";
 import {
   readSettings,
   settingsPath,
   updateSettings,
   validateSettings
-} from "./chunk-34BHNEE3.js";
+} from "./chunk-GHS5EBTQ.js";
 import {
   readClioVersion
 } from "./chunk-IWHMRKLL.js";
@@ -37,14 +37,14 @@ import {
 import {
   require_dist
 } from "./chunk-APJ265NV.js";
-import {
-  clioConfigDir,
-  resolveClioDirs
-} from "./chunk-BYP5D4HI.js";
 import {
   safeResourceBackupPath,
   safeResourceWrite
 } from "./chunk-WEPFGWHJ.js";
+import {
+  clioConfigDir,
+  resolveClioDirs
+} from "./chunk-BYP5D4HI.js";
 import {
   __toESM,
   init_esm_shims
@@ -792,4 +792,4 @@ export {
   importShareArchive,
   ShareDomainModule
 };
-//# sourceMappingURL=chunk-UH347SHR.js.map
+//# sourceMappingURL=chunk-QWGDJJYJ.js.map

package/dist/chunk-R6Q67RJH.js

@@ -0,0 +1,134 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
+
+// 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 name = areaSegments(area).join(" ").replace(/[-_]+/g, " ").trim();
+  return name.length > 0 ? name.charAt(0).toUpperCase() + name.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) };
+}
+
+export {
+  WIKI_DEPTH_STRATEGY,
+  areaForPath,
+  classifyDepth,
+  pagePathForArea,
+  buildCandidatePlan,
+  planWikiGeneration
+};
+//# sourceMappingURL=chunk-R6Q67RJH.js.map

package/dist/{chunk-CRFOIAX3.js → chunk-RRNP2ANY.js}

@@ -1,13 +1,13 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  loadSkills
-} from "./chunk-O3YUNJZ2.js";
 import {
   parseFrontmatter
 } from "./chunk-RKKLTLYB.js";
+import {
+  loadSkills
+} from "./chunk-LDJG7DW3.js";
 import {
   enabledExtensionResourceRoots
-} from "./chunk-HLAFFSEK.js";
+} from "./chunk-7DRAWPTZ.js";
 import {
   assertAgentSpecPolicy,
   isAgentAudience,
@@ -19,7 +19,7 @@ import {
   isShadowAgent,
   normalizeAgentSpec,
   parseResultContract
-} from "./chunk-PGF63K6I.js";
+} from "./chunk-B4OAX3SI.js";
 import {
   resolvePackageRoot
 } from "./chunk-IWHMRKLL.js";
@@ -396,4 +396,4 @@ export {
   parseAgentRecipeSchema,
   discoverAgentRecipes
 };
-//# sourceMappingURL=chunk-CRFOIAX3.js.map
+//# sourceMappingURL=chunk-RRNP2ANY.js.map

package/dist/{chunk-IDNA72AH.js → chunk-RSJ25QSL.js}

@@ -4,7 +4,7 @@ import {
   extractCommandDeleteTargets,
   extractCommandWriteTargets,
   toolMutationPaths
-} from "./chunk-IKOZFYBN.js";
+} from "./chunk-I7ZPNEJM.js";
 import {
   isProjectVerifierCheckId,
   isVerificationScriptName
@@ -489,4 +489,4 @@ export {
   assessFinishContract,
   typedValidationSummary
 };
-//# sourceMappingURL=chunk-IDNA72AH.js.map
+//# sourceMappingURL=chunk-RSJ25QSL.js.map

package/dist/chunk-SKHCAU7K.js

@@ -0,0 +1,385 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  terminalColumns,
+  wrapPlain
+} from "./chunk-2IR2NMPA.js";
+import {
+  source_default
+} from "./chunk-5TSRNF4G.js";
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
+
+// src/cli/lifecycle-presenter.ts
+init_esm_shims();
+import { lstatSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { stdin as defaultInput, stdout as defaultOutput } from "node:process";
+import { createInterface } from "node:readline/promises";
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  const units = ["KB", "MB", "GB", "TB"];
+  let value = bytes / 1024;
+  let unitIndex = 0;
+  while (value >= 1024 && unitIndex < units.length - 1) {
+    value /= 1024;
+    unitIndex += 1;
+  }
+  return `${value.toFixed(1)} ${units[unitIndex]}`;
+}
+function measurePath(targetPath) {
+  let stats;
+  try {
+    stats = lstatSync(targetPath);
+  } catch {
+    return { bytes: 0, exists: false, isDirectory: false, isSymbolicLink: false };
+  }
+  if (stats.isSymbolicLink()) {
+    return { bytes: stats.size, exists: true, isDirectory: false, isSymbolicLink: true };
+  }
+  if (!stats.isDirectory()) {
+    return { bytes: stats.size, exists: true, isDirectory: false, isSymbolicLink: false };
+  }
+  let total = 0;
+  function walk(dir) {
+    let entries;
+    try {
+      entries = readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      const full = join(dir, entry.name);
+      try {
+        if (entry.isDirectory()) walk(full);
+        else total += lstatSync(full).size;
+      } catch {
+      }
+    }
+  }
+  walk(targetPath);
+  return { bytes: total, exists: true, isDirectory: true, isSymbolicLink: false };
+}
+function shortenPath(targetPath, home = homedir()) {
+  if (!targetPath) return targetPath;
+  if (targetPath === home) return "~";
+  if (targetPath.startsWith(`${home}/`) || targetPath.startsWith(`${home}\\`)) {
+    return `~/${targetPath.slice(home.length + 1)}`;
+  }
+  return targetPath;
+}
+var LifecyclePresenter = class {
+  json;
+  plain;
+  out;
+  in;
+  columns;
+  report;
+  lastBlock = null;
+  emitted = false;
+  constructor(options = {}) {
+    this.json = Boolean(options.json);
+    const stream = options.stream ?? defaultOutput;
+    const isTty = Boolean(stream.isTTY);
+    this.plain = options.plain ?? (!isTty || Boolean(process.env.NO_COLOR));
+    this.out = stream;
+    this.in = options.inputStream ?? defaultInput;
+    this.columns = options.columns ?? terminalColumns(stream);
+    this.report = {
+      command: "",
+      title: "",
+      status: "success",
+      items: [],
+      steps: [],
+      warnings: [],
+      errors: [],
+      advice: []
+    };
+  }
+  isJson() {
+    return this.json;
+  }
+  isPlain() {
+    return this.plain;
+  }
+  getReport() {
+    return this.report;
+  }
+  setMethod(method) {
+    this.report.method = method;
+  }
+  /** Open a block, writing the one separator that belongs before it. */
+  open(block) {
+    if (this.lastBlock !== null && this.lastBlock !== block) this.separator();
+    this.lastBlock = block;
+  }
+  separator() {
+    this.out.write(this.plain ? "\n" : `${source_default.cyan("\u2502")}
+`);
+  }
+  /**
+   * Close the current block, for a caller that is about to draw its own lines
+   * on the rail. `configure` hands the rail to the arrow-key selector after
+   * rendering a screen's values, and the selector cannot know what came before
+   * it.
+   */
+  blank() {
+    if (this.json) return;
+    this.separator();
+    this.lastBlock = null;
+  }
+  /** Rail-level prose, wrapped to the terminal so the rail survives a narrow window. */
+  prose(text) {
+    const prefix = this.plain ? "  " : `${source_default.cyan("\u2502")}  `;
+    for (const line of wrapPlain(text, this.columns - 3)) this.out.write(`${prefix}${line}
+`);
+  }
+  header(title, command = "") {
+    this.report.title = title;
+    this.report.command = command;
+    if (this.json) return;
+    if (this.plain) {
+      this.out.write(`
+${title}
+`);
+    } else {
+      this.out.write(`
+${source_default.cyan("\u250C")}  ${source_default.bold(title)}
+`);
+    }
+    this.lastBlock = "header";
+  }
+  /** One detected fact. Consecutive facts group into a single block. */
+  step(text) {
+    this.report.steps.push({ type: "step", message: text });
+    if (this.json) return;
+    this.open("step");
+    if (this.plain) this.out.write(`  ${text}
+`);
+    else this.out.write(`${source_default.blue("\u25CF")}  ${text}
+`);
+  }
+  /** A line of prose on the rail, not a detected fact. */
+  note(text) {
+    this.report.steps.push({ type: "note", message: text });
+    if (this.json) return;
+    this.open("note");
+    this.prose(text);
+  }
+  /**
+   * Aligned label/value rows for a settings screen. Not `note()`, because
+   * these must not reflow: the column is what makes eight values scannable,
+   * and a wrap would put the value under the wrong label.
+   */
+  fields(rows) {
+    for (const [label, value] of rows) this.report.steps.push({ type: "field", message: `${label}: ${value}` });
+    if (this.json || rows.length === 0) return;
+    this.open("step");
+    const width = Math.max(...rows.map(([label]) => label.length));
+    for (const [label, value] of rows) {
+      const padded = `${label}${" ".repeat(width - label.length)}`;
+      if (this.plain) this.out.write(`  ${padded}  ${value}
+`);
+      else this.out.write(`${source_default.blue("\u25CF")}  ${source_default.dim(padded)}  ${value}
+`);
+    }
+  }
+  substep(text, glyph = "\u2713") {
+    this.report.steps.push({ type: "substep", message: text });
+    if (this.json) return;
+    this.open("list");
+    if (this.plain) {
+      this.out.write(`    ${glyph} ${text}
+`);
+      return;
+    }
+    const coloredGlyph = glyph === "\u2713" ? source_default.green(glyph) : source_default.dim(glyph);
+    this.out.write(`${source_default.blue("\u25CF")}    ${coloredGlyph} ${text}
+`);
+  }
+  listItems(header, items) {
+    for (const item of items) {
+      this.report.items.push(item);
+    }
+    if (this.json) return;
+    this.open("note");
+    this.prose(`${header}:`);
+    this.open("list");
+    for (const item of items) {
+      const sizeStr = item.status !== "absent" && item.bytes !== void 0 && item.bytes !== null ? ` (${formatBytes(item.bytes)})` : "";
+      const removes = item.status === void 0 || item.status === "remove";
+      let suffix = "";
+      if (item.status === "keep") suffix = item.detail ? ` (${item.detail})` : " (kept)";
+      else if (item.status === "absent") suffix = item.detail ? ` (${item.detail})` : " (absent)";
+      else if (item.status === "skip") suffix = item.detail ? ` (${item.detail})` : " (skipped)";
+      else if (item.status === "clean") suffix = item.detail ? ` (${item.detail})` : " (nothing to remove)";
+      else if (item.detail) suffix = ` (${item.detail})`;
+      const body = `${item.label}: ${shortenPath(item.path)}${sizeStr}`;
+      if (this.plain) {
+        this.out.write(`    ${removes ? "\u2713" : "\u2013"} ${body}${suffix}
+`);
+        continue;
+      }
+      const glyph = removes ? source_default.green("\u2713") : item.status === "skip" ? source_default.yellow("\u2013") : source_default.dim("\u2013");
+      const tail = suffix.length === 0 ? "" : item.status === "skip" ? source_default.yellow(suffix) : source_default.dim(suffix);
+      this.out.write(
+        `${source_default.blue("\u25CF")}    ${glyph} ${source_default.bold(item.label)}: ${shortenPath(item.path)}${sizeStr}${tail}
+`
+      );
+    }
+  }
+  /** One action that has already happened. Consecutive results group together. */
+  completedStep(text) {
+    this.report.steps.push({ type: "completed", message: text });
+    if (this.json) return;
+    this.open("completed");
+    if (this.plain) this.out.write(`  \u2713 ${text}
+`);
+    else this.out.write(`${source_default.green("\u25C7")}  ${text}
+`);
+  }
+  warn(text) {
+    this.report.warnings.push(text);
+    if (this.json) return;
+    this.open("warn");
+    if (this.plain) {
+      for (const line of wrapPlain(text, this.columns - 3)) this.out.write(`  ${line}
+`);
+      return;
+    }
+    const prefix = `${source_default.yellow("\u25B2")}  `;
+    const continuation = `${source_default.cyan("\u2502")}  `;
+    wrapPlain(text, this.columns - 3).forEach((line, index) => {
+      this.out.write(`${index === 0 ? prefix : continuation}${source_default.yellow(line)}
+`);
+    });
+  }
+  /**
+   * Record a failure and say it once on stderr. The JSON report is not written
+   * here: a command that fails still has advice to add, and emitting mid-flight
+   * either dropped it or put a second document on stdout. Callers end on
+   * `finish()`.
+   */
+  fail(message, detail) {
+    this.report.status = "error";
+    this.report.errors.push(detail ? `${message}: ${detail}` : message);
+    if (this.json) return;
+    if (this.plain) {
+      process.stderr.write(`error: ${message}
+`);
+      if (detail) process.stderr.write(`  ${detail}
+`);
+      return;
+    }
+    process.stderr.write(`${source_default.red("\u2716")}  ${source_default.red(message)}
+`);
+    if (detail) process.stderr.write(`${source_default.cyan("\u2502")}  ${source_default.dim(detail)}
+`);
+  }
+  commandAdvice(lead, command) {
+    this.report.advice.push({ lead, command });
+    if (this.json) return;
+    this.open("advice");
+    this.prose(lead);
+    for (const line of command.split("\n")) {
+      if (this.plain) this.out.write(`    ${line}
+`);
+      else this.out.write(`${source_default.blue("\u25CF")}    ${source_default.cyan(line)}
+`);
+    }
+  }
+  message(text) {
+    this.report.steps.push({ type: "message", message: text });
+    if (this.json) return;
+    this.open("message");
+    if (this.plain) this.out.write(`  ${text}
+`);
+    else this.out.write(`${source_default.cyan("\u25C6")}  ${source_default.bold(text)}
+`);
+  }
+  /**
+   * Ask once, and treat a closed input as a refusal.
+   *
+   * `rl.question()` from readline/promises settles on an answer and on an abort
+   * signal, but not on the input ending: at EOF the interface emits `close` and
+   * the promise is simply never resolved. Every caller here guards a delete, so
+   * the failure mode was a `clio-coder uninstall` that printed its prompt and
+   * then hung forever on Ctrl-D. Racing the `close` event settles that case as
+   * "no", which is the only safe reading of an input that stopped talking.
+   */
+  async confirm(question, defaultYes = false) {
+    if (this.json) return false;
+    const hint = defaultYes ? "Y/n" : "y/N";
+    this.open("confirm");
+    const rl = createInterface({ input: this.in, output: this.out });
+    try {
+      const promptStr = this.plain ? `  ${question} [${hint}]: ` : `${source_default.cyan("\u25C7")}  ${source_default.bold(question)} [${hint}]
+${source_default.cyan("\u2502")}  `;
+      const answer = await new Promise((resolve) => {
+        let settled = false;
+        const settle = (value) => {
+          if (settled) return;
+          settled = true;
+          resolve(value);
+        };
+        rl.once("close", () => settle(null));
+        rl.question(promptStr).then(
+          (value) => settle(value),
+          () => settle(null)
+        );
+      });
+      if (answer === null) return false;
+      const normalized = answer.trim().toLowerCase();
+      const confirmed = normalized.length === 0 ? defaultYes : normalized === "y" || normalized === "yes";
+      this.out.write(this.plain ? `  ${confirmed ? "Yes" : "No"}
+` : `${source_default.cyan("\u2502")}  ${confirmed ? "Yes" : "No"}
+`);
+      return confirmed;
+    } finally {
+      rl.close();
+    }
+  }
+  /**
+   * Close the transcript. Every command ends here, on success and on failure,
+   * so `--json` emits exactly one document containing everything that was
+   * recorded, including advice added after a failure.
+   */
+  done(summary = "Done") {
+    this.report.summary = summary;
+    if (this.json) {
+      this.emit();
+      return;
+    }
+    if (this.plain) {
+      this.out.write(`
+${summary}
+`);
+      return;
+    }
+    this.separator();
+    this.out.write(`${source_default.cyan("\u2514")}  ${source_default.bold(summary)}
+
+`);
+  }
+  /** Emit the JSON report without a closing line, for paths that ended in an error. */
+  finish() {
+    if (this.json) this.emit();
+  }
+  emit() {
+    if (this.emitted) return;
+    this.emitted = true;
+    this.out.write(`${JSON.stringify(this.report, null, 2)}
+`);
+  }
+};
+function createLifecyclePresenter(options = {}) {
+  return new LifecyclePresenter(options);
+}
+
+export {
+  measurePath,
+  shortenPath,
+  createLifecyclePresenter
+};
+//# sourceMappingURL=chunk-SKHCAU7K.js.map