@iowarp/clio-coder 0.3.6 → 0.3.8

package/dist/{chunk-WR67VIZY.js → chunk-GN57SG4G.js}

@@ -1,12 +1,26 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  parseAgentRecipeSchema
+} from "./chunk-FBVTI2TJ.js";
+import {
+  parseFleetContract,
+  parseFrontmatter
+} from "./chunk-E77JEWSD.js";
+import {
+  assertAgentSpecPolicy,
+  normalizeAgentSpec
+} from "./chunk-AOCYTWAV.js";
 import {
   readSettings,
   settingsPath,
   updateSettings
-} from "./chunk-AD2SYQYC.js";
+} from "./chunk-IJ7RPIYJ.js";
+import {
+  readClioVersion
+} from "./chunk-IWHMRKLL.js";
 import {
   DEFAULT_SETTINGS
-} from "./chunk-4OC57DA6.js";
+} from "./chunk-4DGYLA73.js";
 import {
   require_dist
 } from "./chunk-APJ265NV.js";
@@ -18,9 +32,6 @@ import {
   safeResourceBackupPath,
   safeResourceWrite
 } from "./chunk-WEPFGWHJ.js";
-import {
-  readClioVersion
-} from "./chunk-IWHMRKLL.js";
 import {
   __toESM,
   init_esm_shims
@@ -113,11 +124,13 @@ function requestedScopes(scope) {
   return [scope ?? "project"];
 }
 function defaultedIncludes(options) {
-  const hasExplicitInclude = options.includeContext !== void 0 || options.includePrompts !== void 0 || options.includeSkills !== void 0 || options.includeSettings !== void 0 || options.includeExtensions !== void 0;
+  const hasExplicitInclude = options.includeContext !== void 0 || options.includePrompts !== void 0 || options.includeSkills !== void 0 || options.includeAgents !== void 0 || options.includeFleets !== void 0 || options.includeSettings !== void 0 || options.includeExtensions !== void 0;
   return {
     includeContext: hasExplicitInclude ? options.includeContext === true : true,
     includePrompts: hasExplicitInclude ? options.includePrompts === true : true,
     includeSkills: hasExplicitInclude ? options.includeSkills === true : true,
+    includeAgents: hasExplicitInclude ? options.includeAgents === true : true,
+    includeFleets: hasExplicitInclude ? options.includeFleets === true : true,
     includeSettings: hasExplicitInclude ? options.includeSettings === true : true,
     includeExtensions: hasExplicitInclude ? options.includeExtensions === true : true
   };
@@ -155,6 +168,18 @@ function createShareArchive(options = {}) {
       addTree(files, "skill", scope, root, `${scope}/skills`);
     }
   }
+  if (includes.includeAgents) {
+    for (const scope of scopes) {
+      const root = scope === "user" ? path.join(clioConfigDir(), "agents") : path.join(cwd, ".clio-coder", "agents");
+      addTree(files, "agent", scope, root, `${scope}/agents`);
+    }
+  }
+  if (includes.includeFleets) {
+    for (const scope of scopes) {
+      const root = scope === "user" ? path.join(clioConfigDir(), "fleets") : path.join(cwd, ".clio-coder", "fleets");
+      addTree(files, "fleet", scope, root, `${scope}/fleets`);
+    }
+  }
   if (includes.includeExtensions) {
     for (const scope of scopes) {
       const root = scope === "user" ? path.join(clioConfigDir(), "extensions") : path.join(cwd, ".clio-coder", "extensions");
@@ -201,8 +226,17 @@ function parseArchive(raw) {
     throw new Error("share archive manifest is malformed");
   }
   const archive = raw;
+  const allowedTypes = /* @__PURE__ */ new Set([
+    "project-context",
+    "prompt",
+    "skill",
+    "agent",
+    "fleet",
+    "settings",
+    "extension"
+  ]);
   for (const file of archive.files) {
-    if (!isRecord(file) || typeof file.archivePath !== "string" || typeof file.relativePath !== "string" || typeof file.sha256 !== "string" || file.encoding !== "base64" || typeof file.data !== "string") {
+    if (!isRecord(file) || !allowedTypes.has(file.type) || typeof file.archivePath !== "string" || typeof file.relativePath !== "string" || typeof file.sha256 !== "string" || file.encoding !== "base64" || typeof file.data !== "string") {
       throw new Error("share archive file entry is malformed");
     }
     const actual = sha256(decodeArchiveFile(file));
@@ -244,6 +278,10 @@ function targetRootForFile(entry, options) {
       return scope === "user" ? { root: path.join(config, "prompts"), containmentRoot: config, scope } : { root: path.join(cwd, ".clio-coder", "prompts"), containmentRoot: cwd, scope };
     case "skill":
       return scope === "user" ? { root: path.join(config, "skills"), containmentRoot: config, scope } : { root: path.join(cwd, ".clio-coder", "skills"), containmentRoot: cwd, scope };
+    case "agent":
+      return { root: path.join(config, "agents"), containmentRoot: config, scope: "user" };
+    case "fleet":
+      return { root: path.join(config, "fleets"), containmentRoot: config, scope: "user" };
     case "extension":
       return scope === "user" ? { root: path.join(config, "extensions"), containmentRoot: config, scope } : { root: path.join(cwd, ".clio-coder", "extensions"), containmentRoot: cwd, scope };
     case "settings":
@@ -393,6 +431,26 @@ function prepareShareImport(filePath, options = {}) {
   }
   for (const targetInfo of preflight.targets) {
     const { entry, target, scope, buffer } = targetInfo;
+    if (entry.type === "fleet") {
+      try {
+        parseFleetContract(buffer.toString("utf8"), target);
+      } catch (error) {
+        diagnostics.push({ type: "error", message: error instanceof Error ? error.message : String(error), path: target });
+        continue;
+      }
+    }
+    if (entry.type === "agent") {
+      try {
+        const parsed = parseFrontmatter(buffer.toString("utf8"), target);
+        const id = path.basename(target, ".md");
+        assertAgentSpecPolicy(
+          normalizeAgentSpec(parseAgentRecipeSchema({ id, source: "user", filepath: target, ...parsed }))
+        );
+      } catch (error) {
+        diagnostics.push({ type: "error", message: error instanceof Error ? error.message : String(error), path: target });
+        continue;
+      }
+    }
     if (entry.type === "settings") {
       diagnostics.push(...settingsPlan(buffer, options));
       actions.push({ action: "settings", type: entry.type, scope, path: target });
@@ -552,4 +610,4 @@ export {
   importShareArchive,
   ShareDomainModule
 };
-//# sourceMappingURL=chunk-WR67VIZY.js.map
+//# sourceMappingURL=chunk-GN57SG4G.js.map

package/dist/{chunk-RD5U66HV.js → chunk-GPIEI3LY.js}

@@ -1,18 +1,18 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
 import {
-  readSettings,
-  updateSettings
-} from "./chunk-AD2SYQYC.js";
+  INTEROP_AGENT_KINDS,
+  interopAgentKind
+} from "./chunk-IHXBNWMM.js";
 import {
   runCommandVector
-} from "./chunk-VEZEGCGW.js";
+} from "./chunk-B5CSFE7B.js";
+import {
+  readSettings,
+  updateSettings
+} from "./chunk-IJ7RPIYJ.js";
 import {
   withStateFileLockSync
 } from "./chunk-IKCO5N3L.js";
-import {
-  INTEROP_AGENT_KINDS,
-  interopAgentKind
-} from "./chunk-IHXBNWMM.js";
 import {
   require_dist
 } from "./chunk-APJ265NV.js";
@@ -478,4 +478,4 @@ export {
   detectInteropAgents,
   InteropDomainModule
 };
-//# sourceMappingURL=chunk-RD5U66HV.js.map
+//# sourceMappingURL=chunk-GPIEI3LY.js.map

package/dist/{chunk-PCZJO5TI.js → chunk-GU2UIAFZ.js}

@@ -1,37 +1,34 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  discoverDeclaredChecks,
+  listChecks,
+  runProjectCheck,
+  runScriptCheck
+} from "./chunk-VAWNZU7Z.js";
 import {
   BROWSER_MODES,
   maxOutputArg,
   prepareVerifyArguments,
-  runVectorTool,
   timeoutArg,
   verifyToolSurface
-} from "./chunk-NILBFAPG.js";
-import {
-  PROJECT_VERIFIER_CATALOG_RELATIVE_PATH,
-  loadProjectVerifierCatalog,
-  packageDeclaredCheck,
-  resolveProjectVerifierExecutionCwd
-} from "./chunk-FYYLNIL5.js";
-import {
-  VERIFICATION_SCRIPT_FAMILY_HINT,
-  declaredVerificationScripts,
-  isVerificationScriptName
-} from "./chunk-UL3WSD3F.js";
+} from "./chunk-PMDBGQSJ.js";
 import {
   escapeRegExp
 } from "./chunk-VG7TBQIY.js";
 import {
   resolveReadPath
 } from "./chunk-OQE5J4C6.js";
+import {
+  VERIFICATION_SCRIPT_FAMILY_HINT,
+  isVerificationScriptName
+} from "./chunk-UL3WSD3F.js";
 import {
   truncateUtf8
 } from "./chunk-6XLNIQDB.js";
 import {
   combineSafeOutput,
-  resolveSafeCwd,
   runCommandVector
-} from "./chunk-VEZEGCGW.js";
+} from "./chunk-B5CSFE7B.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -609,167 +606,6 @@ function lineAt(text, index) {
   return line;
 }
 
-// src/tools/verify/scripts.ts
-init_esm_shims();
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import path2 from "node:path";
-function repositoryRelativeCwd(workspaceRoot, resolved) {
-  const relative = path2.relative(workspaceRoot, resolved);
-  return relative.length === 0 ? "." : relative.split(path2.sep).join("/");
-}
-function packageTag(id) {
-  const separator = id.search(/[:.-]/u);
-  return [separator === -1 ? id : id.slice(0, separator)];
-}
-function packageCheckSource(packageRoot, workspaceRoot) {
-  const packagePath = path2.join(packageRoot, "package.json");
-  if (!existsSync2(packagePath)) return null;
-  const pkg = parsePackageJson(packagePath);
-  if (!pkg.ok) return null;
-  const cwd = repositoryRelativeCwd(workspaceRoot, packageRoot);
-  const checks = declaredVerificationScripts(pkg.scripts).map(
-    (id) => packageDeclaredCheck(id, packagePath, cwd, packageTag(id))
-  );
-  return { kind: "package.json", path: packagePath, checks };
-}
-function providerCollision(sources) {
-  const seen = /* @__PURE__ */ new Map();
-  for (const source of sources) {
-    for (const check of source.checks) {
-      const prior = seen.get(check.id);
-      if (prior !== void 0) {
-        return `duplicate declared check id '${check.id}' from ${prior.source.kind} (${prior.source.path}) and ${check.source.kind} (${check.source.path})`;
-      }
-      seen.set(check.id, check);
-    }
-  }
-  return null;
-}
-function discoverDeclaredChecksAtRoot(workspaceRoot, cwdArg) {
-  let packageRoot;
-  try {
-    packageRoot = resolveSafeCwd(cwdArg, workspaceRoot);
-  } catch (error) {
-    return { ok: false, reason: error instanceof Error ? error.message : String(error) };
-  }
-  const sources = [];
-  const packageSource = packageCheckSource(packageRoot, workspaceRoot);
-  if (packageSource !== null) sources.push(packageSource);
-  const projectCatalog = loadProjectVerifierCatalog(workspaceRoot);
-  if (!projectCatalog.ok) return projectCatalog;
-  if (projectCatalog.source !== null) sources.push(projectCatalog.source);
-  const collision = providerCollision(sources);
-  if (collision !== null) return { ok: false, reason: collision };
-  return { ok: true, sources };
-}
-function discoverDeclaredChecks(cwdArg) {
-  return discoverDeclaredChecksAtRoot(process.cwd(), cwdArg);
-}
-function clonedSources(sources) {
-  return sources.map((source) => ({
-    kind: source.kind,
-    path: source.path,
-    checks: source.checks.map((check) => ({
-      ...check,
-      command: [...check.command],
-      tags: [...check.tags],
-      source: { ...check.source }
-    }))
-  }));
-}
-function listChecks(cwdArg) {
-  const discovery = discoverDeclaredChecks(cwdArg);
-  if (!discovery.ok) return { kind: "error", message: `verify: ${discovery.reason}` };
-  const lines = [];
-  if (discovery.sources.length === 0 || discovery.sources.every((source) => source.checks.length === 0)) {
-    lines.push(
-      `No declared verification checks found (no package.json verification scripts or ${PROJECT_VERIFIER_CATALOG_RELATIVE_PATH} entries).`,
-      "Run `clio-coder verifiers author` to inspect declared project tooling, preview exact argv checks, and create the catalog after confirmation."
-    );
-  } else {
-    lines.push("Declared verification checks:");
-    for (const source of discovery.sources) {
-      lines.push(source.kind === "package.json" ? "package.json:" : `${PROJECT_VERIFIER_CATALOG_RELATIVE_PATH}:`);
-      for (const check of source.checks) {
-        const tags = check.tags.length > 0 ? ` [${check.tags.join(", ")}]` : "";
-        lines.push(`- ${check.id}${tags}: ${check.description}`);
-      }
-    }
-  }
-  lines.push(
-    "",
-    'Run one with verify(check="<id>"). verify(check="frontend", path=<file>) validates an HTML/CSS/JS artifact.'
-  );
-  return {
-    kind: "ok",
-    output: lines.join("\n"),
-    details: { sources: clonedSources(discovery.sources) }
-  };
-}
-function withDeclaredEvidence(result, check) {
-  return {
-    ...result,
-    details: {
-      ...result.details,
-      action: "verify",
-      check: check.id,
-      source: { ...check.source },
-      description: check.description,
-      declaredCommand: [...check.command],
-      declaredCwd: check.cwd,
-      declaredTimeoutMs: check.timeoutMs,
-      tags: [...check.tags]
-    }
-  };
-}
-async function runProjectCheck(check, options) {
-  const [file, ...vector] = check.command;
-  if (file === void 0) return { kind: "error", message: `verify: declared check '${check.id}' has empty argv` };
-  const cwd = resolveProjectVerifierExecutionCwd(check.cwd, process.cwd());
-  if (cwd instanceof Error) return { kind: "error", message: `verify: ${cwd.message}` };
-  const result = await runVectorTool("verify", file, vector, { cwd, timeout_ms: check.timeoutMs }, options);
-  return withDeclaredEvidence(result, check);
-}
-async function runScriptCheck(check, args, options) {
-  let cwd;
-  try {
-    cwd = resolveSafeCwd(typeof args.cwd === "string" && args.cwd.length > 0 ? args.cwd : void 0, process.cwd());
-  } catch (error) {
-    return { kind: "error", message: `verify: ${error instanceof Error ? error.message : String(error)}` };
-  }
-  const packagePath = path2.join(cwd, "package.json");
-  if (!existsSync2(packagePath)) return { kind: "error", message: `verify: package.json not found in ${cwd}` };
-  const pkg = parsePackageJson(packagePath);
-  if (!pkg.ok) return { kind: "error", message: `verify: ${pkg.reason}` };
-  if (!Object.hasOwn(pkg.scripts, check)) {
-    const declared = declaredVerificationScripts(pkg.scripts);
-    const list = declared.length > 0 ? declared.join(", ") : "(none)";
-    return {
-      kind: "error",
-      message: `verify: package.json has no '${check}' script. Declared verification checks: ${list}.`
-    };
-  }
-  const extraArgs = Array.isArray(args.args) ? args.args.filter((entry) => typeof entry === "string") : [];
-  const vector = ["run", check];
-  if (extraArgs.length > 0) vector.push("--", ...extraArgs);
-  return runVectorTool("verify", "npm", vector, { ...args, cwd }, options);
-}
-function parsePackageJson(packagePath) {
-  try {
-    const parsed = JSON.parse(readFileSync2(packagePath, "utf8"));
-    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-      return { ok: false, reason: "package.json root must be an object" };
-    }
-    const scripts = parsed.scripts;
-    if (!scripts || typeof scripts !== "object" || Array.isArray(scripts)) {
-      return { ok: false, reason: "package.json has no scripts object" };
-    }
-    return { ok: true, scripts };
-  } catch (error) {
-    return { ok: false, reason: error instanceof Error ? error.message : String(error) };
-  }
-}
-
 // src/tools/verify/index.ts
 var verifyTool = {
   ...verifyToolSurface,
@@ -795,7 +631,6 @@ var verifyTool = {
 };
 
 export {
-  discoverDeclaredChecksAtRoot,
   verifyTool
 };
-//# sourceMappingURL=chunk-PCZJO5TI.js.map
+//# sourceMappingURL=chunk-GU2UIAFZ.js.map

package/dist/chunk-GWS3VEIW.js

@@ -0,0 +1,195 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  withStateFileLock,
+  withStateFileLockSync
+} from "./chunk-IKCO5N3L.js";
+import {
+  safeResourceWrite
+} from "./chunk-WEPFGWHJ.js";
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
+
+// src/domains/observability/evidence-index.ts
+init_esm_shims();
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+var MAX_EVIDENCE_INDEX_ROWS = 1e3;
+var EVIDENCE_INDEX_FILE = "evidence-index.json";
+var evidenceIndexWriteQueue = Promise.resolve();
+function indexPath(stateDir) {
+  return join(stateDir, EVIDENCE_INDEX_FILE);
+}
+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";
+}
+function readEvidenceIndex(stateDir) {
+  let raw;
+  try {
+    raw = readFileSync(indexPath(stateDir), "utf8");
+  } catch {
+    return [];
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return [];
+  }
+  if (!Array.isArray(parsed)) return [];
+  return parsed.filter(isEvidenceIndexRow);
+}
+async function writeEvidenceIndexRow(stateDir, row) {
+  let bounded = [];
+  await withStateFileLock(indexPath(stateDir), () => {
+    const existing = readEvidenceIndex(stateDir).filter((entry) => entry.runId !== row.runId);
+    existing.push(row);
+    bounded = existing.length > MAX_EVIDENCE_INDEX_ROWS ? existing.slice(-MAX_EVIDENCE_INDEX_ROWS) : existing;
+    safeResourceWrite(indexPath(stateDir), `${JSON.stringify(bounded, null, 2)}
+`, { encoding: "utf8" });
+  });
+  return bounded;
+}
+async function writeEvidenceIndexRowQueued(stateDir, row) {
+  let written = [];
+  const write = evidenceIndexWriteQueue.then(async () => {
+    written = await writeEvidenceIndexRow(stateDir, row);
+  });
+  evidenceIndexWriteQueue = write.catch(() => void 0);
+  await write;
+  return written;
+}
+
+// src/domains/observability/out-of-turn-usage.ts
+init_esm_shims();
+import { closeSync, mkdirSync, openSync, readFileSync as readFileSync2, writeSync } from "node:fs";
+import { dirname, join as join2 } from "node:path";
+var OUT_OF_TURN_USAGE_DIR = "usage";
+var OUT_OF_TURN_USAGE_FILE = "out-of-turn.jsonl";
+var MAX_OUT_OF_TURN_USAGE_ROWS = 1e3;
+var BOUND_CHECK_INTERVAL = 64;
+function outOfTurnUsagePath(stateDir) {
+  return join2(stateDir, OUT_OF_TURN_USAGE_DIR, OUT_OF_TURN_USAGE_FILE);
+}
+var appendsSinceBoundCheck = BOUND_CHECK_INTERVAL;
+function appendOutOfTurnUsageRow(stateDir, row) {
+  const path = outOfTurnUsagePath(stateDir);
+  try {
+    mkdirSync(dirname(path), { recursive: true });
+    const fd = openSync(path, "a");
+    try {
+      writeSync(fd, `${JSON.stringify(row)}
+`);
+    } finally {
+      closeSync(fd);
+    }
+  } catch (error) {
+    process.stderr.write(`[clio:usage] out-of-turn usage row not written: ${messageOf(error)}
+`);
+    return;
+  }
+  appendsSinceBoundCheck += 1;
+  if (appendsSinceBoundCheck < BOUND_CHECK_INTERVAL) return;
+  appendsSinceBoundCheck = 0;
+  try {
+    boundOutOfTurnUsageFile(path);
+  } catch (error) {
+    process.stderr.write(`[clio:usage] out-of-turn usage ring not bounded: ${messageOf(error)}
+`);
+  }
+}
+function boundOutOfTurnUsageFile(path) {
+  withStateFileLockSync(path, () => {
+    let raw;
+    try {
+      raw = readFileSync2(path, "utf8");
+    } catch {
+      return;
+    }
+    const lines = raw.split("\n").filter((line) => line.trim().length > 0);
+    if (lines.length <= MAX_OUT_OF_TURN_USAGE_ROWS) return;
+    const kept = lines.slice(-MAX_OUT_OF_TURN_USAGE_ROWS);
+    safeResourceWrite(path, `${kept.join("\n")}
+`, { encoding: "utf8" });
+  });
+}
+function readOutOfTurnUsageRows(stateDir) {
+  const path = outOfTurnUsagePath(stateDir);
+  let raw;
+  try {
+    raw = readFileSync2(path, "utf8");
+  } catch (error) {
+    const err = error;
+    if (err.code === "ENOENT" || err.code === "ENOTDIR") return { rows: [], errors: [] };
+    return { rows: [], errors: [`out-of-turn usage store unreadable: ${messageOf(error)}`] };
+  }
+  const rows = [];
+  const errors = [];
+  const lines = raw.split("\n");
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index];
+    if (line === void 0 || line.trim().length === 0) continue;
+    let parsed;
+    try {
+      parsed = JSON.parse(line);
+    } catch (error) {
+      errors.push(`${path}:${index + 1}: invalid JSON: ${messageOf(error)}`);
+      continue;
+    }
+    const row = asOutOfTurnUsageRow(parsed);
+    if (row === null) {
+      errors.push(`${path}:${index + 1}: not an out-of-turn usage row`);
+      continue;
+    }
+    rows.push(row);
+  }
+  return { rows, errors };
+}
+function asOutOfTurnUsageRow(value) {
+  if (!isRecord(value)) return null;
+  const label = value.label;
+  if (label !== "side-question" && label !== "handoff") return null;
+  if (typeof value.timestamp !== "string" || value.timestamp.length === 0) return null;
+  if (!isRecord(value.usage)) return null;
+  const usage = value.usage;
+  return {
+    label,
+    sessionId: typeof value.sessionId === "string" ? value.sessionId : null,
+    repoIdentity: typeof value.repoIdentity === "string" ? value.repoIdentity : null,
+    timestamp: value.timestamp,
+    target: typeof value.target === "string" && value.target.length > 0 ? value.target : "unknown",
+    attributedModelId: typeof value.attributedModelId === "string" && value.attributedModelId.length > 0 ? value.attributedModelId : "unknown",
+    usage: {
+      input: numberOr0(usage.input),
+      output: numberOr0(usage.output),
+      cacheRead: numberOr0(usage.cacheRead),
+      cacheWrite: numberOr0(usage.cacheWrite),
+      reasoning: numberOr0(usage.reasoning),
+      totalTokens: numberOr0(usage.totalTokens),
+      costUsd: numberOr0(usage.costUsd),
+      costProvenance: asCostProvenance(usage.costProvenance)
+    }
+  };
+}
+function asCostProvenance(value) {
+  return value === "known" || value === "known_free" || value === "estimated" ? value : "unknown";
+}
+function numberOr0(value) {
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : 0;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function messageOf(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+export {
+  readEvidenceIndex,
+  writeEvidenceIndexRowQueued,
+  appendOutOfTurnUsageRow,
+  readOutOfTurnUsageRows
+};
+//# sourceMappingURL=chunk-GWS3VEIW.js.map

package/dist/chunk-H7IXIC72.js

@@ -0,0 +1,103 @@
+import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  init_esm_shims
+} from "./chunk-3R73A4XB.js";
+
+// src/domains/dispatch/execution-role.ts
+init_esm_shims();
+var EXECUTION_ROLES = [
+  "builder",
+  "reviewer",
+  "judge",
+  "researcher",
+  "verifier",
+  "recovery"
+];
+function isExecutionRole(value) {
+  return typeof value === "string" && EXECUTION_ROLES.includes(value);
+}
+function deriveExecutionRole(input) {
+  if (input.attempt > 0) return "recovery";
+  if (input.gateRole === "reviewer") return "reviewer";
+  if (input.gateRole === "judge") return "judge";
+  if (input.gateRole === "synthesis") return "judge";
+  if (input.gateRole === "member") return "researcher";
+  if (input.gateRole === "builder" || input.gateRole === "candidate") return "builder";
+  if (input.resultContractKind === "verifier-report") return "verifier";
+  if (input.capabilityClass === "read-only") return "researcher";
+  return "builder";
+}
+function agentRoleFactsResolver(getSpec) {
+  return (agentId) => {
+    const spec = getSpec(agentId);
+    return spec === null ? null : { capabilityClass: spec.capabilityClass, resultContractKind: spec.resultContract.kind };
+  };
+}
+function requestExecutionRole(input) {
+  const facts = input.resolveFacts?.(input.agentId) ?? null;
+  return deriveExecutionRole({
+    attempt: 0,
+    ...input.gateRole !== void 0 ? { gateRole: input.gateRole } : {},
+    capabilityClass: facts?.capabilityClass ?? "workspace-edit",
+    resultContractKind: facts?.resultContractKind ?? null
+  });
+}
+function withAttemptRole(requestRole, attempt) {
+  return attempt > 0 ? "recovery" : requestRole;
+}
+var DEFAULT_GATE_DECIDER_AGENT_ID = "verifier";
+function gateDeciderAgentId(requested) {
+  const trimmed = requested?.trim() ?? "";
+  return trimmed.length > 0 ? trimmed : DEFAULT_GATE_DECIDER_AGENT_ID;
+}
+function appliesRecipeResultContract(gateRole) {
+  return gateRole !== "reviewer" && gateRole !== "judge" && gateRole !== "synthesis";
+}
+function routeCorrelationFactsForRun(run) {
+  return {
+    agentId: run.agentId,
+    targetId: run.targetId,
+    wireModelId: run.wireModelId,
+    runtimeId: run.runtimeId,
+    nodeId: run.node?.id ?? "local"
+  };
+}
+function modelFamily(model) {
+  return model.trim().toLowerCase().replace(/[-_:]?\d{4}[-_]?\d{2}[-_]?\d{2}$/u, "");
+}
+function gateRouteCorrelation(subject, decider) {
+  const agent = subject.agentId === decider.agentId;
+  const target = subject.targetId === decider.targetId;
+  const sameModelFamily = modelFamily(subject.wireModelId) === modelFamily(decider.wireModelId);
+  const runtime = subject.runtimeId === decider.runtimeId;
+  const node = subject.nodeId === decider.nodeId;
+  const dimensions = [
+    ...agent ? ["agent"] : [],
+    ...target ? ["target"] : [],
+    ...sameModelFamily ? ["model-family"] : [],
+    ...runtime ? ["runtime"] : [],
+    ...node ? ["node"] : []
+  ].sort();
+  return {
+    agent,
+    target,
+    modelFamily: sameModelFamily,
+    runtime,
+    node,
+    independent: !agent && !sameModelFamily,
+    dimensions
+  };
+}
+
+export {
+  isExecutionRole,
+  deriveExecutionRole,
+  agentRoleFactsResolver,
+  requestExecutionRole,
+  withAttemptRole,
+  gateDeciderAgentId,
+  appliesRecipeResultContract,
+  routeCorrelationFactsForRun,
+  gateRouteCorrelation
+};
+//# sourceMappingURL=chunk-H7IXIC72.js.map