@iowarp/clio-coder 0.4.2 → 0.4.4

package/dist/{chunk-5KW52TEP.js → chunk-Q4WO54TA.js}

@@ -1,29 +1,36 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   verifyTool
-} from "./chunk-XE3PCIXH.js";
+} from "./chunk-23L32XTI.js";
 import {
   discoverDeclaredChecksAtRoot,
   discoverDeclaredProjectEntriesAtRoot
-} from "./chunk-MCMZMDAC.js";
+} from "./chunk-K6T2ZAMZ.js";
 import {
   parseTomlDocument,
   tomlTableAt
 } from "./chunk-LCGCVYZ4.js";
+import {
+  VALIDATION_CONTRACT_MARKDOWN_PATH,
+  loadValidationContract
+} from "./chunk-V76WTFTW.js";
 import {
   PROJECT_VERIFIER_CATALOG_CAPS,
   PROJECT_VERIFIER_CATALOG_RELATIVE_PATH,
   PROJECT_VERIFIER_CATALOG_VERSION,
-  compareCodepoints,
+  normalizeNumericTolerance,
   parseProjectVerifierCatalogText
-} from "./chunk-VN3SHNBN.js";
+} from "./chunk-DXKJURES.js";
 import {
   isVerificationScriptName
 } from "./chunk-UL3WSD3F.js";
+import {
+  compareCodepoints
+} from "./chunk-I5FWO7L5.js";
 import {
   SAFE_EXEC_DEFAULT_TIMEOUT_MS,
   resolveSafeCwd
-} from "./chunk-HJWWJ6IL.js";
+} from "./chunk-TOIVGRUX.js";
 import {
   require_dist
 } from "./chunk-APJ265NV.js";
@@ -48,12 +55,6 @@ import {
 } from "node:fs";
 import path from "node:path";
 var DECLARED_FILE_CAP_BYTES = 1024 * 1024;
-var VALIDATION_CONTRACT_PATHS = [
-  ".clio-coder/validation.yaml",
-  ".clio-coder/validation.yml",
-  "validation.yaml",
-  "validation.yml"
-];
 function manualEntryInstruction() {
   return 'No unambiguous declared command was found. Add one explicitly with `clio-coder verifiers add --id <id> --description <text> --command \'["executable","arg"]\'`; `--command` is an exact JSON argv array. Review the preview, then rerun with `--yes`.';
 }
@@ -62,9 +63,20 @@ function cloneCheck(check) {
     ...check,
     command: [...check.command],
     tags: [...check.tags],
+    ...check.numeric !== void 0 ? { numeric: structuredClone(check.numeric) } : {},
+    ...check.perf !== void 0 ? { perf: structuredClone(check.perf) } : {},
     provenance: { ...check.provenance }
   };
 }
+function kindFields(check) {
+  const kind = check.kind ?? "command";
+  if (kind === "command") return {};
+  return {
+    kind,
+    ...check.numeric !== void 0 ? { numeric: structuredClone(check.numeric) } : {},
+    ...check.perf !== void 0 ? { perf: structuredClone(check.perf) } : {}
+  };
+}
 function relativePath(workspaceRoot, filePath) {
   const relative = path.relative(workspaceRoot, filePath);
   return relative.length === 0 ? "." : relative.split(path.sep).join("/");
@@ -139,6 +151,7 @@ function projectedCheck(workspaceRoot, check) {
     cwd: check.cwd,
     timeoutMs: check.timeoutMs,
     tags: [...check.tags],
+    ...kindFields(check),
     provenance: sourceProvenance(workspaceRoot, check),
     state: check.source.kind === "package.json" ? "active" : "existing",
     ...check.source.kind === "package.json" ? {} : { catalogId: check.id }
@@ -469,13 +482,6 @@ function shellLikeArgv(command) {
   if ((argv[0] ?? "").includes("=")) return new Error("environment assignments are not argv executables");
   return argv;
 }
-function validatorArgv(value) {
-  if (typeof value === "string") return shellLikeArgv(value);
-  if (!Array.isArray(value) || value.length === 0 || value.some((entry) => typeof entry !== "string" || entry.length === 0)) {
-    return new Error("validator must be a command string or a non-empty argv string array");
-  }
-  return [...value];
-}
 function validationPreferredId(argv) {
   const executable = path.basename(argv[0] ?? "check").replace(/\.[^.]+$/u, "");
   const script = argv.find((entry, index) => index > 0 && /\.(?:py|js|mjs|sh)$/u.test(entry));
@@ -484,80 +490,64 @@ function validationPreferredId(argv) {
 }
 function validationContractProposals(workspaceRoot, diagnostics) {
   const proposals = [];
-  for (const relative of VALIDATION_CONTRACT_PATHS) {
-    const text = regularFileText(path.join(workspaceRoot, relative), workspaceRoot);
-    if (text === null) continue;
-    if (text instanceof Error) {
-      diagnostics.push(`${relative}: ${text.message}; validation command discovery skipped.`);
-      continue;
-    }
-    const document = (0, import_yaml.parseDocument)(text, { prettyErrors: false, strict: true, uniqueKeys: true });
-    if (document.errors.length > 0) {
-      diagnostics.push(`${relative}: invalid YAML; validation command discovery skipped.`);
-      continue;
-    }
-    let parsed;
-    try {
-      parsed = document.toJS({ maxAliasCount: 0 });
-    } catch (error) {
-      diagnostics.push(`${relative}: invalid YAML (${error instanceof Error ? error.message : String(error)}).`);
-      continue;
-    }
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) continue;
-    const validators = parsed.validators;
-    if (!Array.isArray(validators)) continue;
-    for (const [index, validator] of validators.entries()) {
-      const record = validator !== null && typeof validator === "object" && !Array.isArray(validator) ? validator : null;
-      if (record !== null) {
-        const typedFields = [
-          ["id", (value) => typeof value === "string"],
-          ["description", (value) => typeof value === "string"],
-          ["cwd", (value) => typeof value === "string"],
-          ["timeoutMs", (value) => typeof value === "number"],
-          ["tags", (value) => Array.isArray(value) && value.every((tag) => typeof tag === "string")]
-        ];
-        const invalidField = typedFields.find(([field, valid]) => Object.hasOwn(record, field) && !valid(record[field]));
-        if (invalidField !== void 0) {
-          diagnostics.push(
-            `${relative}: validators[${index}].${String(invalidField[0])} has an ambiguous type; use manual argv entry.`
-          );
-          continue;
-        }
-      }
-      const commandValue = record === null ? validator : record.command;
-      const argv = validatorArgv(commandValue);
+  const loaded = loadValidationContract(workspaceRoot);
+  if (!loaded.ok) {
+    diagnostics.push(`${loaded.path}: ${loaded.reason}; validation command discovery skipped.`);
+  } else if (loaded.contract !== null) {
+    for (const [index, validator] of (loaded.contract.validators ?? []).entries()) {
+      const argv = shellLikeArgv(validator);
       if (argv instanceof Error) {
-        diagnostics.push(`${relative}: validators[${index}] is ambiguous (${argv.message}); use manual argv entry.`);
+        diagnostics.push(`${loaded.path}: validators[${index}] is ambiguous (${argv.message}); use manual argv entry.`);
         continue;
       }
-      const declaredId = typeof record?.id === "string" ? record.id : validationPreferredId(argv);
-      const description = typeof record?.description === "string" ? record.description : `Run validation contract command ${JSON.stringify(argv)}`;
-      const cwd = typeof record?.cwd === "string" ? record.cwd : ".";
-      const timeoutMs = typeof record?.timeoutMs === "number" ? record.timeoutMs : SAFE_EXEC_DEFAULT_TIMEOUT_MS;
-      const tags = Array.isArray(record?.tags) ? record.tags.filter((tag) => typeof tag === "string") : [];
       proposals.push({
-        preferredId: declaredId,
-        description,
+        preferredId: validationPreferredId(argv),
+        description: `Run validation contract command ${JSON.stringify(argv)}`,
         command: argv,
-        cwd,
-        timeoutMs,
-        tags: tags.length > 0 ? tags : ["scientific", "validation"],
+        cwd: ".",
+        timeoutMs: SAFE_EXEC_DEFAULT_TIMEOUT_MS,
+        tags: ["scientific", "validation"],
         provenance: {
           kind: "validation-contract",
-          path: relative,
+          path: loaded.path,
           detail: `validators[${index}]`,
           authority: "project-declared"
         }
       });
     }
   }
-  if (existsSync(path.join(workspaceRoot, "VALIDATION.md"))) {
+  if (existsSync(path.join(workspaceRoot, VALIDATION_CONTRACT_MARKDOWN_PATH))) {
     diagnostics.push(
-      "VALIDATION.md is advisory prose; enter an exact argv vector manually instead of inferring a command."
+      `${VALIDATION_CONTRACT_MARKDOWN_PATH} is advisory prose; enter an exact argv vector manually instead of inferring a command.`
     );
   }
   return proposals;
 }
+function numericContractProposals(workspaceRoot) {
+  const loaded = loadValidationContract(workspaceRoot);
+  if (!loaded.ok || loaded.contract === null) return [];
+  const proposals = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const artifact of loaded.contract.artifacts ?? []) {
+    if (artifact.numerical_tolerances === void 0) continue;
+    const tolerance = normalizeNumericTolerance(artifact.numerical_tolerances);
+    if (tolerance instanceof Error) continue;
+    const base = slug(path.basename(artifact.path).replace(/\.[^.]+$/u, ""), "artifact");
+    const preferred = boundedId(`numeric-${base}`);
+    let id = preferred;
+    for (let suffix = 2; seen.has(id); suffix += 1) id = `${boundedId(preferred, `-${suffix}`)}-${suffix}`;
+    seen.add(id);
+    const reference = `${artifact.path}.reference.json`;
+    proposals.push({
+      id,
+      artifactPath: artifact.path,
+      reference,
+      tolerance,
+      addCommand: `clio-coder verifiers add --id ${id} --kind numeric-compare --reference ${JSON.stringify(reference)} --tolerance '${JSON.stringify(tolerance)}' --description ${JSON.stringify(`Compare ${artifact.path} against its reference within tolerance`)} --command '["<executable>","<arg>"]'`
+    });
+  }
+  return proposals;
+}
 function deduplicatedRawProposals(proposals, diagnostics) {
   const seen = /* @__PURE__ */ new Map();
   for (const proposal of proposals.sort(rawProposalSort)) {
@@ -652,6 +642,7 @@ function discoverVerifierAuthoring(workspaceRoot = process.cwd()) {
     activeChecks,
     existingChecks,
     proposals,
+    numericProposals: numericContractProposals(workspaceRoot),
     diagnostics,
     manualEntry,
     ...typeof catalogText === "string" ? { catalogText } : {}
@@ -663,13 +654,28 @@ function createVerifierDraft(discovery, options = {}) {
     catalogPath: discovery.catalogPath,
     activeChecks: discovery.activeChecks.map(cloneCheck),
     checks: [...discovery.existingChecks, ...options.includeProposals === false ? [] : discovery.proposals].map(cloneCheck).sort((left, right) => compareCodepoints(left.id, right.id)),
+    numericProposals: options.includeProposals === false ? [] : discovery.numericProposals.map((proposal) => ({ ...proposal })),
     diagnostics: [...discovery.diagnostics],
     manualEntry: discovery.manualEntry,
     ...discovery.catalogText === void 0 ? {} : { catalogText: discovery.catalogText }
   };
 }
-function catalogEntry({ id, description, command, cwd, timeoutMs, tags }) {
-  return { id, description, command: [...command], cwd, timeoutMs, tags: [...tags] };
+function catalogEntry(check) {
+  const { id, description, command, cwd, timeoutMs, tags } = check;
+  const entry = { id, description, command: [...command], cwd, timeoutMs, tags: [...tags] };
+  const kind = check.kind ?? "command";
+  if (kind === "command") return entry;
+  entry.kind = kind;
+  if (check.numeric !== void 0) {
+    entry.reference = check.numeric.reference;
+    entry.tolerance = { ...check.numeric.tolerance };
+  }
+  if (check.perf !== void 0) {
+    if (check.perf.budget !== void 0) entry.budget = structuredClone(check.perf.budget);
+    if (check.perf.baseline !== void 0) entry.baseline = check.perf.baseline;
+    if (check.perf.tolerance !== void 0) entry.tolerance = { ...check.perf.tolerance };
+  }
+  return entry;
 }
 function serializeVerifierDraft(draft) {
   const checks = [...draft.checks].sort((left, right) => compareCodepoints(left.id, right.id));
@@ -697,8 +703,17 @@ function serializeVerifierDraft(draft) {
       node.set(field, value);
       changed = true;
     }
+    for (const field of ["kind", "reference", "tolerance", "budget", "baseline"]) {
+      if (Object.hasOwn(current, field) && !Object.hasOwn(entry, field)) {
+        node.delete(field);
+        changed = true;
+      }
+    }
   }
   if (!changed && appended.length === 0 && kept.size === sequence.items.length) return draft.catalogText;
+  if (document.get("version") !== PROJECT_VERIFIER_CATALOG_VERSION) {
+    document.set("version", PROJECT_VERIFIER_CATALOG_VERSION);
+  }
   sequence.items = [...sequence.items.filter((node) => (0, import_yaml.isMap)(node) && kept.has(node)), ...appended];
   return document.toString({ lineWidth: 0 });
 }
@@ -727,6 +742,7 @@ function validateVerifierDraft(draft) {
       cwd: check.cwd,
       timeoutMs: check.timeoutMs,
       tags: [...check.tags],
+      ...kindFields(check),
       provenance: original?.provenance ?? {
         kind: "manual-entry",
         path: PROJECT_VERIFIER_CATALOG_RELATIVE_PATH,
@@ -744,6 +760,7 @@ function cloneDraft(draft) {
     ...draft,
     activeChecks: draft.activeChecks.map(cloneCheck),
     checks: draft.checks.map(cloneCheck),
+    numericProposals: draft.numericProposals.map((proposal) => ({ ...proposal })),
     diagnostics: [...draft.diagnostics]
   };
 }
@@ -806,6 +823,17 @@ function reviseVerifierDraft(draft, revisions) {
     if (revision.changes.cwd !== void 0) check.cwd = revision.changes.cwd;
     if (revision.changes.timeoutMs !== void 0) check.timeoutMs = revision.changes.timeoutMs;
     if (revision.changes.tags !== void 0) check.tags = [...revision.changes.tags];
+    if (revision.changes.kind !== void 0) {
+      const next2 = kindFields({
+        kind: revision.changes.kind,
+        ...revision.changes.numeric !== void 0 ? { numeric: revision.changes.numeric } : {},
+        ...revision.changes.perf !== void 0 ? { perf: revision.changes.perf } : {}
+      });
+      delete check.kind;
+      delete check.numeric;
+      delete check.perf;
+      Object.assign(check, next2);
+    }
     diagnostics.push(`Edited check '${revision.id}' without changing its deterministic ID.`);
   }
   next.checks.sort((left, right) => compareCodepoints(left.id, right.id));
@@ -830,9 +858,24 @@ function renderCheck(check, destinationPath) {
     `  cwd: ${check.cwd}`,
     `  timeoutMs: ${check.timeoutMs}`,
     `  tags: ${JSON.stringify(check.tags)}`,
+    ...renderKind(check),
     `  effective execution authority: ${authorityDescription(check)}`
   ];
 }
+function renderKind(check) {
+  const kind = check.kind ?? "command";
+  if (kind === "command") return [];
+  const lines = [`  kind: ${kind}`];
+  if (check.numeric !== void 0) {
+    lines.push(`  reference: ${check.numeric.reference}`, `  tolerance: ${JSON.stringify(check.numeric.tolerance)}`);
+  }
+  if (check.perf !== void 0) {
+    if (check.perf.budget !== void 0) lines.push(`  budget: ${JSON.stringify(check.perf.budget)}`);
+    if (check.perf.baseline !== void 0) lines.push(`  baseline: ${check.perf.baseline}`);
+    if (check.perf.tolerance !== void 0) lines.push(`  tolerance: ${JSON.stringify(check.perf.tolerance)}`);
+  }
+  return lines;
+}
 function previewVerifierDraft(draft, options = {}) {
   const validation = validateVerifierDraft(draft);
   const lines = [
@@ -847,6 +890,18 @@ function previewVerifierDraft(draft, options = {}) {
   lines.push("", "Catalog checks after confirmation:");
   if (draft.checks.length === 0) lines.push("(none)");
   else for (const check of draft.checks) lines.push(...renderCheck(check, draft.catalogPath));
+  if (draft.numericProposals.length > 0) {
+    lines.push("", "Numeric-compare checks the validation contract implies (command required before they can be added):");
+    for (const proposal of draft.numericProposals) {
+      lines.push(
+        `- ${proposal.id}`,
+        `  artifact: ${proposal.artifactPath}`,
+        `  reference: ${proposal.reference}`,
+        `  tolerance: ${JSON.stringify(proposal.tolerance)}`,
+        `  add with: ${proposal.addCommand}`
+      );
+    }
+  }
   if (draft.diagnostics.length > 0) {
     lines.push("", "Diagnostics:");
     for (const diagnostic of draft.diagnostics) lines.push(`- ${diagnostic}`);
@@ -960,4 +1015,4 @@ export {
   previewVerifierDraft,
   runVerifierAuthoringWorkflow
 };
-//# sourceMappingURL=chunk-5KW52TEP.js.map
+//# sourceMappingURL=chunk-Q4WO54TA.js.map

package/dist/{chunk-W6NIE6OW.js → chunk-QUFRYSWI.js}

@@ -4,14 +4,14 @@ import {
   normalizeWriteBoundary,
   normalizeWriteBoundaryEntry,
   writeBoundaryCovers
-} from "./chunk-3F7VUY77.js";
+} from "./chunk-OEJSLEPW.js";
 import {
   asDirectoryPathBoundary,
   pathBoundaryEntryCovers
 } from "./chunk-HHV2GANA.js";
 import {
   atomicWrite
-} from "./chunk-MQXIVJ35.js";
+} from "./chunk-HAXOFFRH.js";
 import {
   clioStateDir
 } from "./chunk-BYP5D4HI.js";
@@ -75,9 +75,12 @@ function isCanonicalWorktreePathInside(parent, candidate) {
   const rel = relative(canonicalParent, canonicalCandidate);
   return rel.length > 0 && rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
 }
-function commitWorktreePath(path, identity, message) {
-  git(path, ["add", "-A"]);
-  if (git(path, ["status", "--porcelain"]).length === 0) return false;
+function commitWorktreePath(path, identity, message, excludedPaths = []) {
+  if (excludedPaths.length > 0) {
+    git(path, ["reset", "-q", "HEAD", "--", ...excludedPaths.map((entry) => `:(top,literal)${entry}`)]);
+  }
+  git(path, ["add", "-A", "--", ".", ...excludedPaths.map((entry) => `:(top,exclude,literal)${entry}`)]);
+  if (git(path, ["diff", "--cached", "--name-only", "-z"]).length === 0) return false;
   git(path, [
     "-c",
     `user.name=${identity}`,
@@ -593,7 +596,10 @@ async function createCandidateWorktreeMapped(ownership, index, baseline, mux) {
   return { ...native, provenance: { backend: "native", path, branch, fallback } };
 }
 function commitCandidateWork(worktree, message) {
-  return commitWorktreePath(worktree.path, COMPETE_COMMIT_IDENTITY, message);
+  return commitWorktreePath(worktree.path, COMPETE_COMMIT_IDENTITY, message, [
+    ".clio-coder/codewiki.json",
+    ".clio-coder/state.json"
+  ]);
 }
 function candidateDiffStat(root, branch) {
   return worktreeBranchDiffStat(root, branch);
@@ -1199,4 +1205,4 @@ export {
   preflightWriteBoundaries,
   createWriteBoundaryEnforcer
 };
-//# sourceMappingURL=chunk-W6NIE6OW.js.map
+//# sourceMappingURL=chunk-QUFRYSWI.js.map

package/dist/{chunk-42FMPA75.js → chunk-QZWQA4DE.js}

@@ -2,7 +2,7 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   ToolNames,
   isBuiltinToolName
-} from "./chunk-K6BSR66V.js";
+} from "./chunk-4NSRCOYP.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -98,4 +98,4 @@ export {
   assertToolProfileEnforceable,
   applyToolProfile
 };
-//# sourceMappingURL=chunk-42FMPA75.js.map
+//# sourceMappingURL=chunk-QZWQA4DE.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-W4YEMFBX.js → chunk-RAY4OVGZ.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-5B2AEOW5.js";
 import {
   ToolNames
-} from "./chunk-K6BSR66V.js";
+} from "./chunk-4NSRCOYP.js";
 import {
   StringEnum
-} from "./chunk-VXMFAE2W.js";
+} from "./chunk-YPC6ZR5L.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -29,4 +29,4 @@ var steerToolSurface = {
 export {
   steerToolSurface
 };
-//# sourceMappingURL=chunk-W4YEMFBX.js.map
+//# sourceMappingURL=chunk-RAY4OVGZ.js.map

package/dist/{chunk-ZNT2M6TG.js → chunk-RQCKCSRL.js}

@@ -1,7 +1,13 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
   parseAgentRecipeSchema
-} from "./chunk-CRFOIAX3.js";
+} from "./chunk-7UGL4MB5.js";
+import {
+  parseFleetContract
+} from "./chunk-OEJSLEPW.js";
+import {
+  parseFrontmatter
+} from "./chunk-RKKLTLYB.js";
 import {
   discoverMarketplaceSkills,
   expandSkillInvocationInput,
@@ -9,7 +15,7 @@ import {
   loadSkills,
   parsePendingSkillRequests,
   projectCompatTrusted
-} from "./chunk-O3YUNJZ2.js";
+} from "./chunk-2ZSONWVL.js";
 import {
   normalizedSkillHash
 } from "./chunk-NDDGJUXD.js";
@@ -19,39 +25,33 @@ import {
   sourceInfoForRoot,
   splitYamlFrontmatter,
   stringField
-} from "./chunk-XGDPUNND.js";
-import {
-  parseFleetContract
-} from "./chunk-3F7VUY77.js";
-import {
-  parseFrontmatter
-} from "./chunk-RKKLTLYB.js";
+} from "./chunk-YECAMM3D.js";
 import {
   assertAgentSpecPolicy,
   normalizeAgentSpec
-} from "./chunk-PGF63K6I.js";
+} from "./chunk-KFV5L5SK.js";
 import {
   INTEROP_AGENT_KINDS
-} 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 {
   expandConfigPath
 } from "./chunk-336NSSKI.js";
 import {
   require_dist
 } from "./chunk-APJ265NV.js";
-import {
-  clioConfigDir
-} from "./chunk-BYP5D4HI.js";
 import {
   safeResourceWrite
 } from "./chunk-WEPFGWHJ.js";
+import {
+  clioConfigDir
+} from "./chunk-BYP5D4HI.js";
 import {
   __toESM,
   init_esm_shims
@@ -908,4 +908,4 @@ export {
   ResourcesDomainModule,
   createResourcesDomainModule
 };
-//# sourceMappingURL=chunk-ZNT2M6TG.js.map
+//# sourceMappingURL=chunk-RQCKCSRL.js.map

package/dist/{chunk-LJID3DYZ.js → chunk-RXTN6AKH.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-5B2AEOW5.js";
 import {
   ToolNames
-} from "./chunk-K6BSR66V.js";
+} from "./chunk-4NSRCOYP.js";
 import {
   StringEnum
-} from "./chunk-VXMFAE2W.js";
+} from "./chunk-YPC6ZR5L.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -49,4 +49,4 @@ export {
   CODE_NAV_MAX_LIMIT,
   codeNavToolSurface
 };
-//# sourceMappingURL=chunk-LJID3DYZ.js.map
+//# sourceMappingURL=chunk-RXTN6AKH.js.map