chainlesschain 0.162.101 → 0.162.103

package/src/commands/__tests__/hub-health.test.js

@@ -0,0 +1,105 @@
+/**
+ * `cc hub health` — focused unit tests for the --quick (minimal hub) path.
+ *
+ * Why this test exists: `cc hub health` defaults to the FULL hub because its
+ * job is to verify hub init wired every component (llm / kgSink / ragSink) —
+ * a minimal hub leaves those null on purpose, so reporting them as down would
+ * be a false negative, not a faster check. `--quick` opts into a vault-only
+ * probe on the minimal hub (skips the 77-adapter registry + sink wiring) and
+ * must mark the other components "not probed" rather than failing them. If
+ * that distinction regresses, `--quick` would either go slow again or start
+ * lying about component health. This suite is the canary.
+ *
+ * Uses the `_getHub` injection seam — no real vault / no spinner side effects.
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { _internal } from "../hub.js";
+
+const { cmdHealth } = _internal;
+
+let exitSpy, logSpy, out;
+
+beforeEach(() => {
+  exitSpy = vi.spyOn(process, "exit").mockImplementation(() => {});
+  out = [];
+  logSpy = vi.spyOn(console, "log").mockImplementation((...args) => {
+    out.push(args.join(" "));
+  });
+});
+
+afterEach(() => {
+  exitSpy.mockRestore();
+  logSpy.mockRestore();
+});
+
+function fullHub() {
+  return {
+    minimal: false,
+    vault: { db: {}, schemaVersion: () => 4 },
+    llm: { name: "ollama:qwen2.5", isLocal: true },
+    kgSink: {},
+    ragSink: {},
+  };
+}
+
+function minimalHub() {
+  return {
+    minimal: true,
+    vault: { db: {}, schemaVersion: () => 4 },
+    llm: null,
+    kgSink: null,
+    ragSink: null,
+  };
+}
+
+function parseJson() {
+  return JSON.parse(out.join("\n"));
+}
+
+describe("cc hub health — default (full) vs --quick (minimal)", () => {
+  it("default probes all four components with real ok states", async () => {
+    const stub = vi.fn(async () => fullHub());
+    await cmdHealth({ json: true, _getHub: stub });
+    const o = parseJson();
+    expect(stub).toHaveBeenCalledTimes(1);
+    expect(o.quick).toBe(false);
+    expect(o.vault.ok).toBe(true);
+    expect(o.vault.schemaVersion).toBe(4);
+    expect(o.llm).toEqual({ ok: true, isLocal: true, name: "ollama:qwen2.5" });
+    expect(o.kgSink).toEqual({ ok: true });
+    expect(o.ragSink).toEqual({ ok: true });
+  });
+
+  it("--quick reports vault only; llm/kgSink/ragSink marked not probed (NOT down)", async () => {
+    await cmdHealth({
+      json: true,
+      quick: true,
+      _getHub: async () => minimalHub(),
+    });
+    const o = parseJson();
+    expect(o.quick).toBe(true);
+    expect(o.vault.ok).toBe(true);
+    // The key correctness property: not-probed, never { ok: false }.
+    expect(o.llm).toEqual({ probed: false });
+    expect(o.kgSink).toEqual({ probed: false });
+    expect(o.ragSink).toEqual({ probed: false });
+    expect(o.llm.ok).toBeUndefined();
+  });
+
+  it("--quick human output notes the skipped components", async () => {
+    await cmdHealth({ quick: true, _getHub: async () => minimalHub() });
+    const text = out.join("\n");
+    expect(text).toMatch(/vault\s+schema=4/);
+    expect(text).toContain("not probed");
+    expect(text).toContain("--quick");
+  });
+
+  it("default human output lists llm/kgSink/ragSink", async () => {
+    await cmdHealth({ _getHub: async () => fullHub() });
+    const text = out.join("\n");
+    expect(text).toContain("llm");
+    expect(text).toContain("kgSink");
+    expect(text).toContain("ragSink");
+  });
+});

package/src/commands/__tests__/hub-stats.test.js

@@ -0,0 +1,106 @@
+/**
+ * `cc hub stats` — focused unit tests for the minimal-vs-full hub selection.
+ *
+ * Why this test exists: `cc hub stats` defaults to the MINIMAL hub so a quick
+ * "how many rows do I have" check doesn't pay to instantiate the full
+ * 77-adapter registry + KG/RAG sinks + email-account auto-load. The adapter
+ * list + resolved LLM are only built when the caller passes `--full` (or via
+ * the standalone `cc hub list-adapters`). If that wiring regresses, every
+ * `cc hub stats` call silently goes back to a slow full-hub init. This suite
+ * is the canary.
+ *
+ * Uses the `_getHub` injection seam — no real vault / no spinner side effects.
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { _internal } from "../hub.js";
+
+const { cmdStats } = _internal;
+
+let exitSpy, logSpy, jsonOut;
+
+beforeEach(() => {
+  exitSpy = vi.spyOn(process, "exit").mockImplementation(() => {});
+  jsonOut = [];
+  logSpy = vi.spyOn(console, "log").mockImplementation((...args) => {
+    jsonOut.push(args.join(" "));
+  });
+});
+
+afterEach(() => {
+  exitSpy.mockRestore();
+  logSpy.mockRestore();
+});
+
+function minimalHub() {
+  return {
+    minimal: true,
+    hubDir: "/tmp/hub",
+    vault: {
+      stats: () => ({ events: 3, persons: 1, places: 0, items: 6, topics: 2 }),
+    },
+    registry: null,
+    llm: null,
+  };
+}
+
+function fullHub() {
+  return {
+    minimal: false,
+    hubDir: "/tmp/hub",
+    vault: {
+      stats: () => ({ events: 3, persons: 1, places: 0, items: 6, topics: 2 }),
+    },
+    registry: {
+      list: () => [
+        { name: "wechat", version: "0.1.0" },
+        { name: "email-imap", version: "0.2.0" },
+      ],
+    },
+    llm: { name: "ollama:qwen2.5", isLocal: true },
+  };
+}
+
+function parseJson() {
+  return JSON.parse(jsonOut.join("\n"));
+}
+
+describe("cc hub stats — minimal vs full hub selection", () => {
+  it("default (no --full) builds the MINIMAL hub: null adapters, minimal flag", async () => {
+    const stub = vi.fn(async () => minimalHub());
+    await cmdStats({ json: true, _getHub: stub });
+    const out = parseJson();
+    expect(stub).toHaveBeenCalledTimes(1);
+    expect(out.minimal).toBe(true);
+    expect(out.adapters).toBeNull();
+    expect(out.llm).toBeNull();
+    expect(out.vault.items).toBe(6);
+    expect(out.hubDir).toBe("/tmp/hub");
+  });
+
+  it("--full builds the full hub: adapters listed, llm resolved, minimal false", async () => {
+    const stub = vi.fn(async () => fullHub());
+    await cmdStats({ json: true, full: true, _getHub: stub });
+    const out = parseJson();
+    expect(out.minimal).toBe(false);
+    expect(Array.isArray(out.adapters)).toBe(true);
+    expect(out.adapters).toHaveLength(2);
+    expect(out.llm).toEqual({ name: "ollama:qwen2.5", isLocal: true });
+  });
+
+  it("human (non-JSON) minimal output points to --full / list-adapters", async () => {
+    await cmdStats({ _getHub: async () => minimalHub() });
+    const text = jsonOut.join("\n");
+    expect(text).toMatch(/events:\s+3/);
+    expect(text).toContain("cc hub list-adapters");
+    expect(text).toContain("cc hub stats --full");
+  });
+
+  it("human full output lists adapter names + versions", async () => {
+    await cmdStats({ full: true, _getHub: async () => fullHub() });
+    const text = jsonOut.join("\n");
+    expect(text).toContain("adapters (2)");
+    expect(text).toContain("wechat");
+    expect(text).toContain("email-imap");
+  });
+});

package/src/commands/a2a.js

@@ -4,6 +4,7 @@
  */
 
 import chalk from "chalk";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 import ora from "ora";
 import { logger } from "../lib/logger.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
@@ -514,7 +515,7 @@ export function registerA2aCommand(program) {
     .description("Submit a V2 task (in-memory, with optional timeout)")
     .argument("<agentId>", "Agent ID")
     .argument("<input>", "Task input")
-    .option("--timeout-ms <ms>", "Timeout in ms", parseInt)
+    .option("--timeout-ms <ms>", "Timeout in ms", intArg("--timeout-ms"))
     .option("--json", "Output as JSON")
     .action((agentId, input, options) => {
       const res = sendTaskV2(null, {

package/src/commands/bi.js

@@ -4,6 +4,7 @@
  */
 
 import chalk from "chalk";
+import { numericOption } from "../lib/cli-numeric.js";
 import { logger } from "../lib/logger.js";
 import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
@@ -180,7 +181,7 @@ export function registerBiCommand(program) {
       try {
         const data = parseJsonOption(options.data, "--data", []);
         const result = detectAnomaly(data, {
-          threshold: parseFloat(options.threshold),
+          threshold: numericOption(options.threshold, { name: "--threshold", fallback: 2 }),
         });
 
         if (options.json) {
@@ -213,7 +214,7 @@ export function registerBiCommand(program) {
     .action(async (options) => {
       try {
         const data = parseJsonOption(options.data, "--data", []);
-        const result = predictTrend(data, parseInt(options.periods));
+        const result = predictTrend(data, numericOption(options.periods, { name: "--periods", integer: true, min: 1, fallback: 3 }));
 
         if (options.json) {
           console.log(JSON.stringify(result, null, 2));
@@ -343,7 +344,7 @@ export function registerBiCommand(program) {
         const data = parseJsonOption(options.data, "--data", []);
         const threshold =
           options.threshold !== undefined
-            ? parseFloat(options.threshold)
+            ? numericOption(options.threshold, { name: "--threshold" })
             : undefined;
         const result = detectAnomalyV2({
           data,

package/src/commands/browse.js

@@ -4,6 +4,7 @@
  */
 
 import chalk from "chalk";
+import { numericOption } from "../lib/cli-numeric.js";
 import ora from "ora";
 import { logger } from "../lib/logger.js";
 import {
@@ -162,8 +163,8 @@ export function registerBrowseCommand(program) {
       try {
         const spinner = ora(`Taking screenshot of ${url}...`).start();
         const result = await takeScreenshot(url, options.output, {
-          width: parseInt(options.width),
-          height: parseInt(options.height),
+          width: numericOption(options.width, { name: "--width", integer: true, min: 1, fallback: 1280 }),
+          height: numericOption(options.height, { name: "--height", integer: true, min: 1, fallback: 720 }),
           fullPage: !!options.fullPage,
         });
         spinner.stop();

package/src/commands/codegen.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   SCAFFOLD_TEMPLATE,
@@ -117,8 +118,8 @@ export function registerCodegenCommand(program) {
     .option("-l, --language <lang>", "Programming language")
     .option("-f, --framework <fw>", "Framework used")
     .option("--code <code>", "Generated code")
-    .option("--files <n>", "Files generated", parseInt)
-    .option("--tokens <n>", "Tokens consumed", parseInt)
+    .option("--files <n>", "Files generated", intArg("--files"))
+    .option("--tokens <n>", "Tokens consumed", intArg("--tokens"))
     .option("-m, --metadata <json>", "Metadata JSON")
     .option("--json", "JSON output")
     .action((opts) => {
@@ -158,7 +159,7 @@ export function registerCodegenCommand(program) {
     .description("List code generations")
     .option("-l, --language <lang>", "Filter by language")
     .option("-f, --framework <fw>", "Filter by framework")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(cg);
@@ -233,7 +234,7 @@ export function registerCodegenCommand(program) {
   cg.command("reviews")
     .description("List code reviews")
     .option("-l, --language <lang>", "Filter by language")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(cg);
@@ -260,7 +261,7 @@ export function registerCodegenCommand(program) {
     )
     .requiredOption("-n, --name <name>", "Project name")
     .option("-o, --options <json>", "Options JSON")
-    .option("--files <n>", "Files generated", parseInt)
+    .option("--files <n>", "Files generated", intArg("--files"))
     .option("--output <path>", "Output path")
     .option("--json", "JSON output")
     .action((opts) => {
@@ -297,7 +298,7 @@ export function registerCodegenCommand(program) {
   cg.command("scaffolds")
     .description("List scaffolds")
     .option("-t, --template <type>", "Filter by template")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(cg);

package/src/commands/collab.js

@@ -6,6 +6,7 @@
  */
 
 import fs from "fs";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 import chalk from "chalk";
 import { logger } from "../lib/logger.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
@@ -421,7 +422,7 @@ export function registerCollabCommand(program) {
   collab
     .command("agents")
     .description("List agents with autonomy levels")
-    .option("-l, --level <n>", "Filter by level 0..4", parseInt)
+    .option("-l, --level <n>", "Filter by level 0..4", intArg("--level"))
     .option("--limit <n>", "Maximum entries", parseInt, 50)
     .option("--json", "Output as JSON")
     .action(async (options) => {

package/src/commands/crosschain.js

@@ -8,6 +8,7 @@
  */
 
 import fs from "node:fs";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import { Command } from "commander";
 
@@ -651,7 +652,7 @@ export function registerCrossChainCommand(program) {
     .option("-f, --from <chain>", "Filter by source chain")
     .option("-t, --to <chain>", "Filter by destination chain")
     .option("-s, --status <status>", "Filter by status")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(cc);
@@ -677,7 +678,7 @@ export function registerCrossChainCommand(program) {
     .option("-a, --from-asset <asset>", "Source asset", "native")
     .option("-b, --to-asset <asset>", "Target asset", "native")
     .option("-c, --counterparty <address>", "Counterparty address")
-    .option("-t, --timeout <ms>", "Timeout in ms", parseInt)
+    .option("-t, --timeout <ms>", "Timeout in ms", intArg("--timeout"))
     .option("--mtc", "On success, stage an MTC swap-init envelope")
     .option("--mtc-config-dir <dir>", "Override MTC config root")
     .option("--json", "JSON output")
@@ -779,7 +780,7 @@ export function registerCrossChainCommand(program) {
     .description("List swaps")
     .option("-f, --from <chain>", "Filter by source chain")
     .option("-s, --status <status>", "Filter by status")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(cc);
@@ -871,7 +872,7 @@ export function registerCrossChainCommand(program) {
     .option("-f, --from <chain>", "Filter by source chain")
     .option("-t, --to <chain>", "Filter by destination chain")
     .option("-s, --status <status>", "Filter by status")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(cc);

package/src/commands/dao.js

@@ -388,7 +388,7 @@ export function registerDaoCommand(program) {
           type: options.type,
           actions: parseJsonOption(options.actions, "--actions"),
           votingDurationMs: options.votingDuration
-            ? parseInt(options.votingDuration)
+            ? numericOption(options.votingDuration, { name: "--voting-duration", integer: true, min: 0 })
             : undefined,
         });
 
@@ -457,8 +457,8 @@ export function registerDaoCommand(program) {
           proposalId,
           voterDid: options.voter,
           voteType: options.type,
-          voteCount: parseInt(options.count),
-          balance: options.balance ? parseFloat(options.balance) : undefined,
+          voteCount: numericOption(options.count, { name: "--count", integer: true, min: 1 }),
+          balance: options.balance ? numericOption(options.balance, { name: "--balance", min: 0 }) : undefined,
         });
 
         logger.success("Vote cast");
@@ -779,7 +779,7 @@ export function registerDaoCommand(program) {
         const db = ctx.db.getDatabase();
         ensureDAOv2Tables(db);
 
-        const s = getGovernanceStatsV2(parseInt(options.members));
+        const s = getGovernanceStatsV2(numericOption(options.members, { name: "--members", integer: true, min: 0, fallback: 0 }));
         if (options.json) {
           console.log(JSON.stringify(s, null, 2));
         } else {
@@ -833,19 +833,19 @@ export function registerDaoCommand(program) {
       try {
         const updates = {};
         if (options.votingDuration)
-          updates.votingDurationMs = parseInt(options.votingDuration);
+          updates.votingDurationMs = numericOption(options.votingDuration, { name: "--voting-duration", integer: true, min: 0 });
         if (options.quorumPercentage)
-          updates.quorumPercentage = parseFloat(options.quorumPercentage);
+          updates.quorumPercentage = numericOption(options.quorumPercentage, { name: "--quorum-percentage", min: 0, max: 100 });
         if (options.timelockMs)
-          updates.timelockMs = parseInt(options.timelockMs);
+          updates.timelockMs = numericOption(options.timelockMs, { name: "--timelock-ms", integer: true, min: 0 });
         if (options.quadraticEnabled !== undefined)
           updates.quadraticEnabled = options.quadraticEnabled === "true";
         if (options.maxDelegationDepth)
-          updates.maxDelegationDepth = parseInt(options.maxDelegationDepth);
+          updates.maxDelegationDepth = numericOption(options.maxDelegationDepth, { name: "--max-delegation-depth", integer: true, min: 0 });
         if (options.proposalThreshold)
-          updates.proposalThreshold = parseFloat(options.proposalThreshold);
+          updates.proposalThreshold = numericOption(options.proposalThreshold, { name: "--proposal-threshold", min: 0 });
         if (options.maxSingleAllocation)
-          updates.maxSingleAllocation = parseFloat(options.maxSingleAllocation);
+          updates.maxSingleAllocation = numericOption(options.maxSingleAllocation, { name: "--max-single-allocation", min: 0 });
 
         const cfg = configureV2(updates);
         if (options.json) {

package/src/commands/dbevo.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   MIGRATION_STATUS,
@@ -239,7 +240,7 @@ export function registerDbEvoCommand(program) {
   dbevo
     .command("history")
     .description("Show migration history")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(dbevo);
@@ -340,7 +341,7 @@ export function registerDbEvoCommand(program) {
   dbevo
     .command("analyze")
     .description("Analyze slow queries and generate index suggestions")
-    .option("--min-count <n>", "Min query count for suggestion", parseInt)
+    .option("--min-count <n>", "Min query count for suggestion", intArg("--min-count"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(dbevo);

package/src/commands/economy.js

@@ -4,6 +4,8 @@
  */
 
 import chalk from "chalk";
+import { intArg, floatArg } from "../lib/cli-arg.js";
+import { numericOption } from "../lib/cli-numeric.js";
 import { logger } from "../lib/logger.js";
 import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
@@ -166,7 +168,7 @@ export function registerEconomyCommand(program) {
         const db = ctx.db.getDatabase();
         ensureEconomyTables(db);
 
-        const ch = openChannel(db, partyA, partyB, parseFloat(options.deposit));
+        const ch = openChannel(db, partyA, partyB, numericOption(options.deposit, { name: "--deposit", min: 0 }));
         logger.success("Channel opened");
         logger.log(`  ${chalk.bold("ID:")}      ${chalk.cyan(ch.id)}`);
         logger.log(`  ${chalk.bold("Party A:")} ${ch.partyA} (${ch.balanceA})`);
@@ -501,9 +503,9 @@ export function registerEconomyCommand(program) {
     .argument("<from>", "From agent ID")
     .argument("<to>", "To agent ID")
     .argument("<service-id>", "Service ID")
-    .option("--tokens <n>", "Token count (for per_token)", parseInt)
-    .option("--minutes <n>", "Minute count (for per_minute)", parseFloat)
-    .option("--calls <n>", "Call count (for per_call)", parseInt)
+    .option("--tokens <n>", "Token count (for per_token)", intArg("--tokens"))
+    .option("--minutes <n>", "Minute count (for per_minute)", floatArg("--minutes"))
+    .option("--calls <n>", "Call count (for per_call)", intArg("--calls"))
     .option("--json", "Output as JSON")
     .action(async (from, to, serviceId, options) => {
       try {
@@ -534,8 +536,8 @@ export function registerEconomyCommand(program) {
     .description("Open a two-sided channel (Phase 85)")
     .argument("<party-a>", "Party A ID")
     .argument("<party-b>", "Party B ID")
-    .option("--deposit-a <n>", "Deposit from party A", parseFloat)
-    .option("--deposit-b <n>", "Deposit from party B", parseFloat)
+    .option("--deposit-a <n>", "Deposit from party A", floatArg("--deposit-a"))
+    .option("--deposit-b <n>", "Deposit from party B", floatArg("--deposit-b"))
     .option("--json", "Output as JSON")
     .action(async (a, b, options) => {
       try {

package/src/commands/evolution.js

@@ -4,6 +4,8 @@
  */
 
 import chalk from "chalk";
+import { intArg, floatArg } from "../lib/cli-arg.js";
+import { numericOption } from "../lib/cli-numeric.js";
 import ora from "ora";
 import { logger } from "../lib/logger.js";
 import { parseJsonOption } from "../lib/parse-json-option.js";
@@ -291,7 +293,7 @@ export function registerEvolutionCommand(program) {
     .command("growth")
     .description("Show growth log")
     .option("--type <filter>", "Filter by event type")
-    .option("--limit <n>", "Limit entries", parseInt)
+    .option("--limit <n>", "Limit entries", intArg("--limit"))
     .option("--json", "Output as JSON")
     .action(async (options) => {
       try {
@@ -523,10 +525,10 @@ export function registerEvolutionCommand(program) {
       try {
         const r = trainIncrementalV2({
           strategy: options.strategy,
-          dataSize: parseFloat(options.dataSize),
-          lossBefore: parseFloat(options.lossBefore),
-          lossAfter: parseFloat(options.lossAfter),
-          durationMs: parseFloat(options.durationMs),
+          dataSize: numericOption(options.dataSize, { name: "--data-size", min: 0 }),
+          lossBefore: numericOption(options.lossBefore, { name: "--loss-before" }),
+          lossAfter: numericOption(options.lossAfter, { name: "--loss-after" }),
+          durationMs: numericOption(options.durationMs, { name: "--duration-ms", min: 0, fallback: 0 }),
         });
         if (options.json) console.log(JSON.stringify(r, null, 2));
         else {
@@ -650,7 +652,7 @@ export function registerEvolutionCommand(program) {
     .option("--json", "Output as JSON")
     .action((options) => {
       const horizon = options.horizonMs
-        ? parseFloat(options.horizonMs)
+        ? numericOption(options.horizonMs, { name: "--horizon-ms", min: 0 })
         : undefined;
       const r = predictBehaviorV2({ timeHorizonMs: horizon });
       if (options.json) console.log(JSON.stringify(r, null, 2));
@@ -703,8 +705,8 @@ export function registerEvolutionCommand(program) {
     .option("--json", "Output as JSON")
     .action((options) => {
       const period = {};
-      if (options.from) period.fromMs = parseFloat(options.from);
-      if (options.to) period.toMs = parseFloat(options.to);
+      if (options.from) period.fromMs = numericOption(options.from, { name: "--from", min: 0 });
+      if (options.to) period.toMs = numericOption(options.to, { name: "--to", min: 0 });
       const list = getGrowthLogV2({
         milestoneType: options.type,
         period: Object.keys(period).length ? period : undefined,

package/src/commands/export.js

@@ -4,6 +4,7 @@
  */
 
 import chalk from "chalk";
+import { numericOption } from "../lib/cli-numeric.js";
 import ora from "ora";
 import { resolve } from "path";
 import { logger } from "../lib/logger.js";
@@ -72,7 +73,7 @@ export function registerExportCommand(program) {
         const exported = exportToMarkdown(db, outputDir, {
           category: options.category,
           tag: options.tag,
-          limit: options.limit ? parseInt(options.limit) : undefined,
+          limit: options.limit ? numericOption(options.limit, { name: "--limit", integer: true, min: 1 }) : undefined,
         });
         spinner.stop();
 

package/src/commands/federation.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   CIRCUIT_STATE,
@@ -109,8 +110,8 @@ export function registerFederationCommand(program) {
       "Failure threshold before tripping",
       parseInt,
     )
-    .option("-s, --success-threshold <n>", "Success probes to close", parseInt)
-    .option("-t, --open-timeout <ms>", "Open timeout in ms", parseInt)
+    .option("-s, --success-threshold <n>", "Success probes to close", intArg("--success-threshold"))
+    .option("-t, --open-timeout <ms>", "Open timeout in ms", intArg("--open-timeout"))
     .option("-m, --metadata <json>", "Metadata JSON")
     .option("--json", "JSON output")
     .action((nodeId, opts) => {
@@ -165,7 +166,7 @@ export function registerFederationCommand(program) {
     .command("breakers")
     .description("List circuit breakers")
     .option("-s, --state <state>", "Filter by state (closed/open/half_open)")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(fed);
@@ -295,7 +296,7 @@ export function registerFederationCommand(program) {
     .option("-n, --node <id>", "Filter by node ID")
     .option("-t, --type <type>", "Filter by check type")
     .option("-s, --status <status>", "Filter by status")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(fed);
@@ -337,9 +338,9 @@ export function registerFederationCommand(program) {
   fed
     .command("pool-init <node-id>")
     .description("Initialize a connection pool for a node")
-    .option("--min <n>", "Min connections", parseInt)
-    .option("--max <n>", "Max connections", parseInt)
-    .option("--idle-timeout <ms>", "Idle timeout in ms", parseInt)
+    .option("--min <n>", "Min connections", intArg("--min"))
+    .option("--max <n>", "Max connections", intArg("--max"))
+    .option("--idle-timeout <ms>", "Idle timeout in ms", intArg("--idle-timeout"))
     .option("--json", "JSON output")
     .action((nodeId, opts) => {
       const result = initPool(nodeId, {