@iowarp/clio-coder 0.4.2 → 0.4.4

package/dist/{usage-ME5MPXGX.js → usage-NHG6MCJM.js}

@@ -1,14 +1,26 @@
 import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
+import {
+  summarizeFailedCompactionUsage
+} from "./chunk-FEAXX7B6.js";
 import {
   readEvidenceIndex,
-  readOutOfTurnUsageRows
-} from "./chunk-AK5XEFVZ.js";
+  readOutOfTurnUsageRows,
+  summarizeEvidenceIndex
+} from "./chunk-JT2RFCC5.js";
 import {
   loadMemoryRecordsSync
-} from "./chunk-JBCS7CRR.js";
-import "./chunk-I66ZTYNP.js";
-import "./chunk-ZGNYYXQ6.js";
-import "./chunk-B74PXLU7.js";
+} from "./chunk-EL24TAU4.js";
+import "./chunk-RQCKCSRL.js";
+import "./chunk-RZDWV63N.js";
+import "./chunk-7UGL4MB5.js";
+import "./chunk-DR52UMZW.js";
+import "./chunk-NRO2BJRH.js";
+import "./chunk-NXIMQY5W.js";
+import "./chunk-XRZT5WY5.js";
+import "./chunk-QUFRYSWI.js";
+import "./chunk-LTIKRKFL.js";
+import "./chunk-ODGTEFFI.js";
+import "./chunk-CUSRQKPU.js";
 import {
   addResponseModelIdObservationCount,
   emptyResponseModelIdObservationCounts,
@@ -17,109 +29,105 @@ import {
   parseSessionEntries,
   readAuditRows,
   responseModelIdObservationCountsLabel
-} from "./chunk-X7IARSHT.js";
-import "./chunk-KPXDY6QF.js";
-import "./chunk-W6NIE6OW.js";
-import "./chunk-DZAW46HP.js";
-import "./chunk-RVG5JXAL.js";
+} from "./chunk-6UINWWS6.js";
+import "./chunk-FTMGRKEF.js";
+import "./chunk-VIA6RFQZ.js";
+import "./chunk-W6GROXXM.js";
+import "./chunk-I2DWJ4GM.js";
+import "./chunk-OEJSLEPW.js";
+import "./chunk-RKKLTLYB.js";
+import "./chunk-K6T2ZAMZ.js";
+import "./chunk-3UUXNFEX.js";
+import {
+  loadSkills
+} from "./chunk-2ZSONWVL.js";
+import "./chunk-NDDGJUXD.js";
+import "./chunk-YECAMM3D.js";
+import "./chunk-V76WTFTW.js";
 import {
   foldPromptCacheTelemetry,
   hasPromptCacheTelemetry
 } from "./chunk-3DPEIQKN.js";
-import "./chunk-5PFYMY2V.js";
-import "./chunk-VIA6RFQZ.js";
-import "./chunk-T56WDKA5.js";
-import "./chunk-W6GROXXM.js";
-import "./chunk-4JDLP6ZS.js";
-import "./chunk-TXOTCRLG.js";
+import "./chunk-TQAHXW6Y.js";
+import "./chunk-5MEZN6CB.js";
+import "./chunk-3ODX73FK.js";
 import "./chunk-HVDIIIQW.js";
-import "./chunk-ZNT2M6TG.js";
-import "./chunk-P75RZCJW.js";
-import "./chunk-CRFOIAX3.js";
-import "./chunk-DR52UMZW.js";
 import {
-  loadSkills
-} from "./chunk-O3YUNJZ2.js";
-import "./chunk-NDDGJUXD.js";
-import "./chunk-XGDPUNND.js";
-import "./chunk-3F7VUY77.js";
-import "./chunk-RKKLTLYB.js";
-import "./chunk-HLAFFSEK.js";
-import "./chunk-77QIVUZB.js";
-import "./chunk-I66EAJFY.js";
-import "./chunk-IKSLQ4XV.js";
-import "./chunk-HIICAHCJ.js";
-import "./chunk-Q4XWMHX6.js";
-import "./chunk-IDNA72AH.js";
-import "./chunk-FVDGR2ZL.js";
+  formatColumns,
+  printError
+} from "./chunk-JCI2ROMZ.js";
+import "./chunk-2WZ546HR.js";
+import "./chunk-75W7L2E2.js";
+import "./chunk-6QOTUPRG.js";
+import "./chunk-AUPNRN7C.js";
+import "./chunk-6PAZTBPA.js";
+import "./chunk-6Q3CYFD3.js";
 import "./chunk-NEDJ26B5.js";
-import "./chunk-42FMPA75.js";
-import "./chunk-H7IXIC72.js";
-import "./chunk-VN3SHNBN.js";
 import "./chunk-OQE5J4C6.js";
-import "./chunk-FSP7CMNU.js";
-import "./chunk-B7HM5Z7T.js";
+import "./chunk-NAI6ZFCY.js";
 import "./chunk-OZNBF4L3.js";
-import "./chunk-4BJ5BYCE.js";
-import "./chunk-6XLNIQDB.js";
-import "./chunk-NMJXSHBJ.js";
-import "./chunk-VAVR4IJY.js";
-import "./chunk-2LEAKD4C.js";
+import "./chunk-QZWQA4DE.js";
+import "./chunk-H7IXIC72.js";
+import "./chunk-KFV5L5SK.js";
+import "./chunk-NXYCB2VD.js";
+import "./chunk-ECH6PKUQ.js";
+import "./chunk-IRXAATOX.js";
+import "./chunk-BJVFZO5U.js";
+import "./chunk-DXKJURES.js";
 import "./chunk-HHV2GANA.js";
-import "./chunk-PGF63K6I.js";
-import "./chunk-IKOZFYBN.js";
+import "./chunk-GYV6VZOC.js";
 import "./chunk-UL3WSD3F.js";
-import "./chunk-ECH6PKUQ.js";
 import "./chunk-5B2AEOW5.js";
-import "./chunk-K6BSR66V.js";
-import "./chunk-XAKHZX5N.js";
-import "./chunk-33YXPOE3.js";
-import "./chunk-7CR24IG7.js";
-import "./chunk-XPLRXC72.js";
-import "./chunk-ZW55JB7N.js";
-import {
-  formatColumns,
-  printError
-} from "./chunk-VPKWYKEY.js";
-import "./chunk-5TSRNF4G.js";
-import "./chunk-BYMNWQ7O.js";
+import "./chunk-VAVR4IJY.js";
+import "./chunk-4BJ5BYCE.js";
+import "./chunk-54X7T7DK.js";
+import "./chunk-I5FWO7L5.js";
+import "./chunk-6XLNIQDB.js";
+import "./chunk-4NSRCOYP.js";
+import "./chunk-JSD46VO2.js";
 import "./chunk-CFGTUFWB.js";
-import "./chunk-72GZI5EV.js";
-import "./chunk-CWVRRIEI.js";
+import "./chunk-NZMNUPZZ.js";
+import "./chunk-2JH2WHGE.js";
+import "./chunk-KXDSS5WJ.js";
+import "./chunk-GHS5EBTQ.js";
+import "./chunk-D7E7WCDF.js";
 import {
   cwdHash
-} from "./chunk-MQXIVJ35.js";
+} from "./chunk-HAXOFFRH.js";
 import "./chunk-R346GLFC.js";
-import "./chunk-PMZVFWSR.js";
 import "./chunk-BTK3SSSK.js";
-import "./chunk-IHXBNWMM.js";
-import "./chunk-34BHNEE3.js";
-import "./chunk-D7E7WCDF.js";
-import "./chunk-HJWWJ6IL.js";
+import "./chunk-W54I7H25.js";
+import "./chunk-PMZVFWSR.js";
 import "./chunk-F4EKGO4N.js";
-import "./chunk-JIEGK6UF.js";
-import "./chunk-EBY63B7G.js";
-import "./chunk-6EJMN2Y3.js";
+import "./chunk-XAKHZX5N.js";
+import "./chunk-33YXPOE3.js";
+import "./chunk-7CR24IG7.js";
+import "./chunk-XPLRXC72.js";
 import "./chunk-IWHMRKLL.js";
-import "./chunk-IMXMHHMQ.js";
+import "./chunk-6OSVSQL5.js";
 import "./chunk-UXCU4E3T.js";
 import "./chunk-LL4KHSZI.js";
 import "./chunk-S66XZJOF.js";
-import "./chunk-CDNVLKUX.js";
-import "./chunk-WNP7O5WZ.js";
+import "./chunk-TOIVGRUX.js";
+import "./chunk-U6TMQNSI.js";
+import "./chunk-EBY63B7G.js";
+import "./chunk-6EJMN2Y3.js";
+import "./chunk-26QSH3EJ.js";
+import "./chunk-ID64D7PE.js";
 import "./chunk-336NSSKI.js";
 import "./chunk-IKCO5N3L.js";
 import "./chunk-3I7MS7N2.js";
 import "./chunk-APJ265NV.js";
+import "./chunk-WEPFGWHJ.js";
+import "./chunk-NUGM5KR6.js";
+import "./chunk-5OIVVPHF.js";
+import "./chunk-YPC6ZR5L.js";
+import "./chunk-YXLYO42X.js";
+import "./chunk-2LEAKD4C.js";
 import {
   clioDataDir,
   clioStateDir
 } from "./chunk-BYP5D4HI.js";
-import "./chunk-WEPFGWHJ.js";
-import "./chunk-NUGM5KR6.js";
-import "./chunk-O42A54GG.js";
-import "./chunk-VXMFAE2W.js";
-import "./chunk-YXLYO42X.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -169,19 +177,20 @@ function addResponseModelIdObservation(counts, call) {
   addResponseModelIdObservationCount(counts, call.responseModelIdObservation, call.apiCalls ?? 1);
 }
 function emptyCallOrigins() {
-  return { rows: 0, sideQuestions: 0, handoffs: 0, prewarms: 0, backgroundMemory: 0 };
+  return { rows: 0, sideQuestions: 0, handoffs: 0, prewarms: 0, backgroundMemory: 0, failedCompaction: 0 };
 }
 function turnsOf(origins) {
-  return origins.rows - origins.sideQuestions - origins.handoffs - origins.prewarms - origins.backgroundMemory;
+  return origins.rows - origins.sideQuestions - origins.handoffs - origins.prewarms - origins.backgroundMemory - origins.failedCompaction;
 }
 function hasLabelledCall(origins) {
-  return origins.sideQuestions > 0 || origins.handoffs > 0 || origins.prewarms > 0 || origins.backgroundMemory > 0;
+  return origins.sideQuestions > 0 || origins.handoffs > 0 || origins.prewarms > 0 || origins.backgroundMemory > 0 || origins.failedCompaction > 0;
 }
 function addOutOfTurnRow(origins, row) {
   origins.rows += 1;
   if (row.label === "side-question") origins.sideQuestions += 1;
   else if (row.label === "prewarm") origins.prewarms += 1;
   else if (row.label === "background-memory") origins.backgroundMemory += 1;
+  else if (row.label === "failed-compaction") origins.failedCompaction += 1;
   else origins.handoffs += 1;
 }
 function outOfTurnUsageCall(row) {
@@ -190,15 +199,28 @@ function outOfTurnUsageCall(row) {
     attributedModelId: row.attributedModelId,
     requestedModelId: row.attributedModelId,
     responseModelIdObservation: { state: "not-observed" },
-    input: row.usage.input,
-    output: row.usage.output,
-    cacheRead: row.usage.cacheRead,
-    cacheWrite: row.usage.cacheWrite,
-    reasoningTokens: row.usage.reasoning,
-    totalTokens: row.usage.totalTokens,
-    costUsd: row.usage.costUsd
+    input: row.usage.input ?? 0,
+    output: row.usage.output ?? 0,
+    cacheRead: row.usage.cacheRead ?? 0,
+    cacheWrite: row.usage.cacheWrite ?? 0,
+    reasoningTokens: row.usage.reasoning ?? 0,
+    totalTokens: row.usage.totalTokens ?? 0,
+    costUsd: row.usage.costUsd ?? 0
   };
 }
+function reportedUsageTotals(totals, rows) {
+  const failedCompaction = summarizeFailedCompactionUsage(rows);
+  if (failedCompaction.calls === 0) return totals;
+  const reported = { ...totals, knownSubtotals: true, failedCompaction };
+  for (const [field, missing] of Object.entries(failedCompaction.unobservedUsageCalls)) {
+    const key = field === "reasoning" ? "reasoningTokens" : field;
+    if (missing > 0 && reported[key] === 0) reported[key] = null;
+  }
+  return reported;
+}
+function usageAmount(value) {
+  return typeof value === "number" ? String(value) : "unknown";
+}
 function addUsageCall(totals, call) {
   totals.apiCalls += call.apiCalls ?? 1;
   totals.input += call.input;
@@ -324,6 +346,7 @@ async function runUsageCommand(argv) {
     return decision === "blocked" || decision === "denied";
   });
   const evidenceRows = readEvidenceIndex(stateDir).filter((row) => inWindow(row.generatedAt, windowStart, now));
+  const accountability = summarizeEvidenceIndex(evidenceRows);
   let memoryRecords = [];
   try {
     memoryRecords = loadMemoryRecordsSync(clioDataDir());
@@ -415,6 +438,8 @@ async function runUsageCommand(argv) {
     addOutOfTurnRow(callOrigins, row);
   }
   const usageMeasurable = presence.sessionsPresent || outOfTurnRows.length > 0;
+  const reportedTotals = reportedUsageTotals(usageTotals, outOfTurnRows);
+  const failedCompaction = summarizeFailedCompactionUsage(outOfTurnRows);
   const usageRows = [...usageByModel.values()].sort(
     (a, b) => b.totals.totalTokens - a.totals.totalTokens || a.providerId.localeCompare(b.providerId)
   );
@@ -484,18 +509,21 @@ async function runUsageCommand(argv) {
     else emit({ kind: "fact", fact: "session-store-missing", path: presence.sessionsPath });
     if (presence.receiptsPresent) emit({ kind: "fact", fact: "dispatch-runs", value: receipts.length });
     else emit({ kind: "fact", fact: "receipt-store-missing", path: presence.receiptsPath });
+    emit({ kind: "fact", fact: "unverified-successes", value: accountability.unverifiedSuccesses });
+    emit({ kind: "fact", fact: "ungrounded-claims", value: accountability.ungroundedClaims });
     emit({ kind: "fact", fact: "audit-tool-calls", value: auditToolCalls.length, blocked: auditBlocked.length });
     if (usageMeasurable) {
       emit({
         kind: "fact",
         fact: "tokens",
-        ...usageTotals,
+        ...reportedTotals,
         ...hasLabelledCall(callOrigins) ? {
           turns: turnsOf(callOrigins),
           sideQuestions: callOrigins.sideQuestions,
           handoffs: callOrigins.handoffs,
           prewarms: callOrigins.prewarms,
-          backgroundMemorySteps: callOrigins.backgroundMemory
+          backgroundMemorySteps: callOrigins.backgroundMemory,
+          ...callOrigins.failedCompaction > 0 ? { failedCompactionCalls: callOrigins.failedCompaction } : {}
         } : {}
       });
       for (const row of usageRows) {
@@ -506,7 +534,12 @@ async function runUsageCommand(argv) {
           attributedModelId: row.attributedModelId,
           requestedModelIds: [...row.requestedModelIds].sort(),
           responseModelIdObservationCounts: row.responseModelIdObservationCounts,
-          ...row.totals
+          ...reportedUsageTotals(
+            row.totals,
+            outOfTurnRows.filter(
+              (call) => call.target === row.providerId && call.attributedModelId === row.attributedModelId
+            )
+          )
         });
       }
       for (const session of cacheSessions) {
@@ -566,7 +599,7 @@ async function runUsageCommand(argv) {
   out(`  audited tool calls in window: ${auditToolCalls.length} (${auditBlocked.length} blocked/denied)`);
   if (usageMeasurable) {
     out(
-      `  tokens in window: ${usageTotals.totalTokens} over ${usageTotals.apiCalls} model calls (input ${usageTotals.input}, output ${usageTotals.output}, cache read ${usageTotals.cacheRead}, cache write ${usageTotals.cacheWrite}, reasoning ${usageTotals.reasoningTokens})`
+      `  tokens in window: ${usageAmount(reportedTotals.totalTokens)} over ${usageTotals.apiCalls} model calls (input ${usageAmount(reportedTotals.input)}, output ${usageAmount(reportedTotals.output)}, cache read ${usageAmount(reportedTotals.cacheRead)}, cache write ${usageAmount(reportedTotals.cacheWrite)}, reasoning ${usageAmount(reportedTotals.reasoningTokens)})`
     );
     if (hasLabelledCall(callOrigins)) {
       out(`  turns in window: ${turnsOf(callOrigins)}`);
@@ -577,7 +610,18 @@ async function runUsageCommand(argv) {
         out(`  background memory steps in window: ${callOrigins.backgroundMemory}`);
       }
     }
-    out(`  provider-reported cost in window: $${usageTotals.costUsd.toFixed(4)}`);
+    if (failedCompaction.calls > 0) {
+      out(
+        `  failed-compaction streams: ${failedCompaction.calls} (${failedCompaction.erroredCalls} errored, ${failedCompaction.abortedCalls} aborted, ${failedCompaction.successfulCalls} completed before the attempt failed)`
+      );
+      out("  usage figures are known subtotals; missing compaction usage is not zero or a complete spending bound");
+      out(
+        `  errored compaction known cost: ${failedCompaction.erroredKnownUsage.costUsd === null ? "unknown" : `$${failedCompaction.erroredKnownUsage.costUsd.toFixed(4)}`}`
+      );
+    }
+    out(
+      `  ${failedCompaction.calls > 0 ? "known reported/estimated" : "provider-reported"} cost in window: ${typeof reportedTotals.costUsd === "number" ? `$${reportedTotals.costUsd.toFixed(4)}` : "unknown"}`
+    );
   }
   if (usageRows.length > 0) {
     out("");
@@ -598,19 +642,27 @@ async function runUsageCommand(argv) {
             "tokens",
             "cost"
           ],
-          ...usageRows.map((row) => [
-            row.providerId,
-            row.attributedModelId,
-            [...row.requestedModelIds].sort().join(","),
-            responseModelIdObservationCountsLabel(row.responseModelIdObservationCounts),
-            String(row.totals.apiCalls),
-            String(row.totals.input),
-            String(row.totals.output),
-            String(row.totals.cacheRead),
-            String(row.totals.reasoningTokens),
-            String(row.totals.totalTokens),
-            `$${row.totals.costUsd.toFixed(4)}`
-          ])
+          ...usageRows.map((row) => {
+            const reported = reportedUsageTotals(
+              row.totals,
+              outOfTurnRows.filter(
+                (call) => call.target === row.providerId && call.attributedModelId === row.attributedModelId
+              )
+            );
+            return [
+              row.providerId,
+              row.attributedModelId,
+              [...row.requestedModelIds].sort().join(","),
+              responseModelIdObservationCountsLabel(row.responseModelIdObservationCounts),
+              String(row.totals.apiCalls),
+              usageAmount(reported.input),
+              usageAmount(reported.output),
+              usageAmount(reported.cacheRead),
+              usageAmount(reported.reasoningTokens),
+              usageAmount(reported.totalTokens),
+              typeof reported.costUsd === "number" ? `$${reported.costUsd.toFixed(4)}` : "unknown"
+            ];
+          })
         ])
       )
     );
@@ -695,6 +747,8 @@ async function runUsageCommand(argv) {
       )
     );
   }
+  out(`  unverified successes: ${accountability.unverifiedSuccesses}`);
+  out(`  ungrounded claims: ${accountability.ungroundedClaims}`);
   if (tagCounts.size > 0) {
     out("");
     out("  failure tags (from evidence index)");
@@ -963,4 +1017,4 @@ function isRecord(value) {
 export {
   runUsageCommand
 };
-//# sourceMappingURL=usage-ME5MPXGX.js.map
+//# sourceMappingURL=usage-NHG6MCJM.js.map

package/dist/{verifiers-BVZ7IWOO.js → verifiers-7AUNVXDY.js}

@@ -4,41 +4,47 @@ import {
   discoverVerifierAuthoring,
   previewVerifierDraft,
   runVerifierAuthoringWorkflow
-} from "./chunk-5KW52TEP.js";
+} from "./chunk-Q4WO54TA.js";
 import {
   verifyTool
-} from "./chunk-XE3PCIXH.js";
-import "./chunk-MCMZMDAC.js";
+} from "./chunk-23L32XTI.js";
+import {
+  recordPerfBaseline
+} from "./chunk-K6T2ZAMZ.js";
 import "./chunk-LCGCVYZ4.js";
-import "./chunk-7BHIY2MW.js";
+import "./chunk-V76WTFTW.js";
+import {
+  printError,
+  printOk
+} from "./chunk-JCI2ROMZ.js";
+import "./chunk-GX5WYQO4.js";
 import "./chunk-VG7TBQIY.js";
+import "./chunk-OQE5J4C6.js";
+import "./chunk-ECH6PKUQ.js";
+import "./chunk-BJVFZO5U.js";
 import {
+  DECLARED_CHECK_KINDS,
   PROJECT_VERIFIER_CATALOG_RELATIVE_PATH,
-  loadProjectVerifierCatalog
-} from "./chunk-VN3SHNBN.js";
-import "./chunk-OQE5J4C6.js";
-import "./chunk-6XLNIQDB.js";
+  loadProjectVerifierCatalog,
+  normalizeNumericTolerance
+} from "./chunk-DXKJURES.js";
 import {
   isProjectVerifierCheckId
 } from "./chunk-UL3WSD3F.js";
-import "./chunk-ECH6PKUQ.js";
 import "./chunk-5B2AEOW5.js";
-import "./chunk-K6BSR66V.js";
-import {
-  printError,
-  printOk
-} from "./chunk-VPKWYKEY.js";
-import "./chunk-5TSRNF4G.js";
+import "./chunk-I5FWO7L5.js";
+import "./chunk-6XLNIQDB.js";
+import "./chunk-4NSRCOYP.js";
 import {
   SAFE_EXEC_DEFAULT_TIMEOUT_MS
-} from "./chunk-HJWWJ6IL.js";
-import "./chunk-JIEGK6UF.js";
+} from "./chunk-TOIVGRUX.js";
+import "./chunk-U6TMQNSI.js";
 import "./chunk-EBY63B7G.js";
 import "./chunk-6EJMN2Y3.js";
 import "./chunk-APJ265NV.js";
-import "./chunk-BYP5D4HI.js";
-import "./chunk-VXMFAE2W.js";
+import "./chunk-YPC6ZR5L.js";
 import "./chunk-YXLYO42X.js";
+import "./chunk-BYP5D4HI.js";
 import {
   init_esm_shims
 } from "./chunk-3R73A4XB.js";
@@ -208,11 +214,22 @@ Usage:
   clio-coder verifiers edit <id> [--description <text>] [--command <json-argv>] [fields] [--yes]
   clio-coder verifiers rename <old> <new> [--yes]
   clio-coder verifiers remove <id> [--yes]
+  clio-coder verifiers baseline <id>
 
 Fields:
   --cwd <path>            repository-relative working directory (default .)
   --timeout-ms <number>   bounded timeout in milliseconds (default 120000)
   --tags <a,b>            comma-separated catalog tags
+  --kind <kind>           command (default), numeric-compare, or perf-budget
+  --reference <path>      numeric-compare: repository-relative reference JSON of string -> number | number[]
+  --tolerance <json>      numeric-compare: {"relative"?,"absolute"?,"ulp"?}, at least one;
+                          perf-budget with --baseline: {"relative"} headroom over the baseline
+  --budget-ms <number>    perf-budget: wall-time bound in milliseconds
+  --budget-relative <r>   perf-budget with --budget-ms: fractional headroom over the bound
+  --baseline <path>       perf-budget: repository-relative baseline JSON written by 'verifiers baseline <id>'
+
+baseline runs a perf-budget check once and records its wall time at the check's
+baseline path; a failing or timed-out command records nothing.
 
 Discovery and every preview are read-only. Mutating commands write only with
 --yes after printing the exact argv, cwd, timeout, tags, source provenance, and
@@ -231,7 +248,13 @@ var VALUE_OPTIONS = /* @__PURE__ */ new Set([
   "--tags",
   "--exclude",
   "--rename",
-  "--dry-run"
+  "--dry-run",
+  "--kind",
+  "--reference",
+  "--tolerance",
+  "--budget-ms",
+  "--budget-relative",
+  "--baseline"
 ]);
 function parseAuthoringArgs(argv) {
   const positional = [];
@@ -289,6 +312,82 @@ function parseTimeout(value) {
 function tags(value) {
   return value === void 0 ? [] : value.split(",").map((tag) => tag.trim()).filter((tag) => tag.length > 0);
 }
+function parseJsonObject(value, option) {
+  try {
+    const parsed = JSON.parse(value);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return new Error(`${option} must be a JSON object`);
+    }
+    return parsed;
+  } catch (error) {
+    return new Error(`${option} must be valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+  }
+}
+function kindFieldsFromArgs(parsed) {
+  const kindValue = oneValue(parsed, "--kind") ?? "command";
+  if (!DECLARED_CHECK_KINDS.includes(kindValue)) {
+    return new Error(`--kind must be one of ${DECLARED_CHECK_KINDS.join(", ")}`);
+  }
+  const kind = kindValue;
+  const reference = oneValue(parsed, "--reference");
+  const toleranceValue = oneValue(parsed, "--tolerance");
+  const budgetMs = oneValue(parsed, "--budget-ms");
+  const budgetRelative = oneValue(parsed, "--budget-relative");
+  const baseline = oneValue(parsed, "--baseline");
+  if (kind === "command") {
+    const stray = [
+      ["--reference", reference],
+      ["--tolerance", toleranceValue],
+      ["--budget-ms", budgetMs],
+      ["--budget-relative", budgetRelative],
+      ["--baseline", baseline]
+    ].filter(([, value]) => value !== void 0);
+    if (stray.length > 0)
+      return new Error(`${stray.map(([name]) => name).join(", ")} require --kind numeric-compare or perf-budget`);
+    return {};
+  }
+  if (kind === "numeric-compare") {
+    if (budgetMs !== void 0 || budgetRelative !== void 0 || baseline !== void 0) {
+      return new Error("--budget-ms, --budget-relative, and --baseline belong to --kind perf-budget");
+    }
+    if (reference === void 0) return new Error("--reference is required for --kind numeric-compare");
+    if (toleranceValue === void 0) return new Error("--tolerance is required for --kind numeric-compare");
+    const toleranceJson = parseJsonObject(toleranceValue, "--tolerance");
+    if (toleranceJson instanceof Error) return toleranceJson;
+    const tolerance = normalizeNumericTolerance(toleranceJson);
+    if (tolerance instanceof Error) return new Error(`--tolerance ${tolerance.message}`);
+    return { kind, numeric: { reference, tolerance } };
+  }
+  if (reference !== void 0) return new Error("--reference belongs to --kind numeric-compare");
+  if (budgetMs === void 0 === (baseline === void 0)) {
+    return new Error("--kind perf-budget requires exactly one of --budget-ms or --baseline");
+  }
+  if (budgetMs !== void 0) {
+    if (toleranceValue !== void 0) return new Error("use --budget-relative for headroom over --budget-ms");
+    const wallTimeMs = Number(budgetMs);
+    if (!Number.isFinite(wallTimeMs) || wallTimeMs <= 0) return new Error("--budget-ms must be a positive number");
+    const budget = { wallTimeMs };
+    if (budgetRelative !== void 0) {
+      const relative = Number(budgetRelative);
+      if (!Number.isFinite(relative) || relative < 0) return new Error("--budget-relative must be a non-negative number");
+      budget.tolerance = { relative };
+    }
+    return { kind, perf: { budget } };
+  }
+  if (budgetRelative !== void 0)
+    return new Error("--budget-relative belongs with --budget-ms; use --tolerance with --baseline");
+  const perf = { baseline };
+  if (toleranceValue !== void 0) {
+    const toleranceJson = parseJsonObject(toleranceValue, "--tolerance");
+    if (toleranceJson instanceof Error) return toleranceJson;
+    const relative = toleranceJson.relative;
+    if (typeof relative !== "number" || !Number.isFinite(relative) || relative < 0) {
+      return new Error('--tolerance for a baseline must be {"relative": <non-negative number>}');
+    }
+    perf.tolerance = { relative };
+  }
+  return { kind, perf };
+}
 function requiredValue(parsed, option) {
   const value = oneValue(parsed, option);
   return value === void 0 || value.length === 0 ? new Error(`${option} is required`) : value;
@@ -314,6 +413,8 @@ function addRevision(parsed) {
   if (command instanceof Error) return command;
   const timeoutMs = parseTimeout(oneValue(parsed, "--timeout-ms"));
   if (timeoutMs instanceof Error) return timeoutMs;
+  const kindFields = kindFieldsFromArgs(parsed);
+  if (kindFields instanceof Error) return kindFields;
   return {
     kind: "add",
     check: {
@@ -322,7 +423,8 @@ function addRevision(parsed) {
       command,
       cwd: oneValue(parsed, "--cwd") ?? ".",
       timeoutMs,
-      tags: tags(oneValue(parsed, "--tags"))
+      tags: tags(oneValue(parsed, "--tags")),
+      ...kindFields
     }
   };
 }
@@ -348,6 +450,13 @@ function editRevision(parsed) {
   }
   const tagValue = oneValue(parsed, "--tags");
   if (tagValue !== void 0) changes.tags = tags(tagValue);
+  if (oneValue(parsed, "--kind") !== void 0) {
+    const kindFields = kindFieldsFromArgs(parsed);
+    if (kindFields instanceof Error) return kindFields;
+    changes.kind = kindFields.kind ?? "command";
+    if (kindFields.numeric !== void 0) changes.numeric = kindFields.numeric;
+    if (kindFields.perf !== void 0) changes.perf = kindFields.perf;
+  }
   if (Object.keys(changes).length === 0) return new Error("edit requires at least one changed field");
   return { kind: "edit", id, changes };
 }
@@ -419,6 +528,29 @@ async function executeWorkflow(parsed, options) {
   for (const dryRun of result.dryRuns) code = Math.max(code, printDryRun(dryRun.id, dryRun.result));
   return code;
 }
+async function baselineCommand(id) {
+  if (id === void 0) {
+    printError("baseline requires a check ID");
+    return 2;
+  }
+  const loaded = loadProjectVerifierCatalog(process.cwd());
+  if (!loaded.ok) {
+    printError(`production catalog parser rejected ${loaded.reason}`);
+    return 1;
+  }
+  const check = loaded.source?.checks.find((candidate) => candidate.id === id);
+  if (check === void 0) {
+    printError(`no catalog check '${id}' in ${PROJECT_VERIFIER_CATALOG_RELATIVE_PATH}`);
+    return 1;
+  }
+  const recorded = await recordPerfBaseline(check);
+  if (!recorded.ok) {
+    printError(`baseline '${id}' not recorded: ${recorded.message}`);
+    return 1;
+  }
+  printOk(`recorded baseline for '${id}': ${Math.round(recorded.wallTimeMs)}ms at ${recorded.path}`);
+  return 0;
+}
 async function discoverCommand() {
   const discovery = discoverVerifierAuthoring();
   if (!discovery.ok) {
@@ -462,6 +594,7 @@ async function runVerifiersCommand(argv) {
   const command = parsed.positional[0];
   if (command === "discover") return discoverCommand();
   if (command === "validate") return validateCommand();
+  if (command === "baseline") return baselineCommand(parsed.positional[1]);
   if (command === "dry-run") {
     const id = parsed.positional[1];
     if (id === void 0) {
@@ -493,4 +626,4 @@ async function runVerifiersCommand(argv) {
 export {
   runVerifiersCommand
 };
-//# sourceMappingURL=verifiers-BVZ7IWOO.js.map
+//# sourceMappingURL=verifiers-7AUNVXDY.js.map