chainlesschain 0.162.101 → 0.162.103

package/src/commands/learning.js

@@ -109,6 +109,72 @@ export function registerLearningCommand(program) {
       }
     });
 
+  // learning export — §8.3 cross-device backup: full dump of learning_trajectories
+  learning
+    .command("export")
+    .description("Export all learning trajectories as JSON (module 101 §8.3 backup)")
+    .option("--output <file>", "Write JSON array to file (default: stdout)")
+    .option("--json", "Output JSON ({ok,count} with --output; array otherwise)")
+    .action(async (options) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const { exportTrajectories } = await import("../lib/learning/learning-tables.js");
+        const rows = exportTrajectories(ctx.db.getDatabase());
+        if (options.output) {
+          const fs = await import("fs");
+          fs.writeFileSync(options.output, JSON.stringify(rows), "utf-8");
+          if (options.json) {
+            console.log(JSON.stringify({ ok: true, count: rows.length, output: options.output }));
+          } else {
+            logger.log(`exported ${rows.length} trajectories → ${options.output}`);
+          }
+        } else {
+          console.log(JSON.stringify(rows));
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`learning export failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // learning import — §8.3 restore: idempotent upsert by id from a JSON-array file
+  learning
+    .command("import")
+    .description("Import learning trajectories from a JSON array file (idempotent upsert by id; §8.3)")
+    .requiredOption("--input <file>", "JSON array of trajectories to import")
+    .option("--json", "Output JSON result")
+    .action(async (options) => {
+      try {
+        const fs = await import("fs");
+        const rows = JSON.parse(fs.readFileSync(options.input, "utf-8"));
+        if (!Array.isArray(rows)) {
+          throw new Error("import: expected a JSON array of trajectories");
+        }
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const { importTrajectories } = await import("../lib/learning/learning-tables.js");
+        const result = importTrajectories(ctx.db.getDatabase(), rows);
+        if (options.json) {
+          console.log(JSON.stringify(result));
+        } else {
+          logger.log(`imported ${result.imported}, failed ${result.failed}`);
+        }
+        await shutdown();
+        if (!result.ok) process.exitCode = 1;
+      } catch (err) {
+        logger.error(`learning import failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
   // learning reflect
   learning
     .command("reflect")

package/src/commands/marketplace.js

@@ -5,6 +5,7 @@
  */
 
 import chalk from "chalk";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 import { logger } from "../lib/logger.js";
 import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
@@ -240,7 +241,7 @@ export function registerMarketplaceCommand(program) {
       "Status (pending|running|success|failed|timeout)",
       "success",
     )
-    .option("-d, --duration-ms <n>", "Duration in ms", parseInt)
+    .option("-d, --duration-ms <n>", "Duration in ms", intArg("--duration-ms"))
     .option("-e, --error <text>", "Error message when failed")
     .option("--json", "Output as JSON")
     .action(async (serviceId, options) => {
@@ -466,7 +467,7 @@ export function registerMarketplaceCommand(program) {
   mp.command("complete-invocation <invocation-id>")
     .description("Complete a V2 invocation (RUNNING → SUCCESS)")
     .option("-o, --output <json>", "JSON-encoded output")
-    .option("-d, --duration-ms <n>", "Duration in milliseconds", parseInt)
+    .option("-d, --duration-ms <n>", "Duration in milliseconds", intArg("--duration-ms"))
     .option("--json", "Output as JSON")
     .action(async (invocationId, options) => {
       try {
@@ -496,7 +497,7 @@ export function registerMarketplaceCommand(program) {
   mp.command("fail-invocation <invocation-id>")
     .description("Fail a V2 invocation")
     .option("-m, --message <msg>", "Error message")
-    .option("-d, --duration-ms <n>", "Duration in milliseconds", parseInt)
+    .option("-d, --duration-ms <n>", "Duration in milliseconds", intArg("--duration-ms"))
     .action(async (invocationId, options) => {
       try {
         const ctx = await bootstrap({ verbose: program.opts().verbose });
@@ -515,7 +516,7 @@ export function registerMarketplaceCommand(program) {
 
   mp.command("timeout-invocation <invocation-id>")
     .description("Timeout a V2 invocation")
-    .option("-d, --duration-ms <n>", "Duration in milliseconds", parseInt)
+    .option("-d, --duration-ms <n>", "Duration in milliseconds", intArg("--duration-ms"))
     .action(async (invocationId, options) => {
       try {
         const ctx = await bootstrap({ verbose: program.opts().verbose });

package/src/commands/matrix.js

@@ -4,6 +4,7 @@
  */
 
 import chalk from "chalk";
+import { numericOption } from "../lib/cli-numeric.js";
 import { logger } from "../lib/logger.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
@@ -134,7 +135,7 @@ export function registerMatrixCommand(program) {
         ensureMatrixTables(db);
 
         const messages = getMessages(roomId, {
-          limit: parseInt(options.limit),
+          limit: numericOption(options.limit, { name: "--limit", integer: true, min: 1, fallback: 50 }),
         });
         if (options.json) {
           console.log(JSON.stringify(messages, null, 2));

package/src/commands/memory.js

@@ -11,6 +11,8 @@ import {
   addMemory,
   searchMemory,
   listMemory,
+  exportMemory,
+  importMemory,
   deleteMemory,
   appendDailyNote,
   getDailyNote,
@@ -160,6 +162,70 @@ export function registerMemoryCommand(program) {
       }
     });
 
+  // memory export — §8.3 cross-device backup: full dump of memory_entries
+  memory
+    .command("export")
+    .description("Export all memory entries as JSON (module 101 §8.3 backup)")
+    .option("--output <file>", "Write JSON array to file (default: stdout)")
+    .option("--json", "Output JSON ({ok,count} with --output; array otherwise)")
+    .action(async (options) => {
+      try {
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const entries = exportMemory(ctx.db.getDatabase());
+        if (options.output) {
+          const fs = await import("fs");
+          fs.writeFileSync(options.output, JSON.stringify(entries), "utf-8");
+          if (options.json) {
+            console.log(JSON.stringify({ ok: true, count: entries.length, output: options.output }));
+          } else {
+            logger.log(`exported ${entries.length} memory entries → ${options.output}`);
+          }
+        } else {
+          console.log(JSON.stringify(entries)); // data command: emit the array
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`memory export failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // memory import — §8.3 restore: idempotent upsert by id from a JSON-array file
+  memory
+    .command("import")
+    .description("Import memory entries from a JSON array file (idempotent upsert by id; §8.3)")
+    .requiredOption("--input <file>", "JSON array of memory entries to import")
+    .option("--json", "Output JSON result")
+    .action(async (options) => {
+      try {
+        const fs = await import("fs");
+        const entries = JSON.parse(fs.readFileSync(options.input, "utf-8"));
+        if (!Array.isArray(entries)) {
+          throw new Error("import: expected a JSON array of memory entries");
+        }
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const result = importMemory(ctx.db.getDatabase(), entries);
+        if (options.json) {
+          console.log(JSON.stringify(result));
+        } else {
+          logger.log(`imported ${result.imported}, failed ${result.failed}`);
+        }
+        await shutdown();
+        if (!result.ok) process.exitCode = 1;
+      } catch (err) {
+        logger.error(`memory import failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
   // memory add
   memory
     .command("add")

package/src/commands/nlprog.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   INTENT,
@@ -214,7 +215,7 @@ export function registerNlProgCommand(program) {
     .description("List translations")
     .option("-i, --intent <intent>", "Filter by intent")
     .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 = _requireDb(nlp);
@@ -289,7 +290,7 @@ export function registerNlProgCommand(program) {
     )
     .requiredOption("-p, --pattern <text>", "Pattern description")
     .option("-e, --examples <json>", "Examples JSON")
-    .option("-f, --confidence <n>", "Confidence (0-1)", parseFloat)
+    .option("-f, --confidence <n>", "Confidence (0-1)", floatArg("--confidence"))
     .option("-s, --source-files <json>", "Source files JSON")
     .option("--json", "JSON output")
     .action((opts) => {
@@ -326,7 +327,7 @@ export function registerNlProgCommand(program) {
     .command("conventions")
     .description("List project conventions")
     .option("-c, --category <cat>", "Filter by category")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _requireDb(nlp);

package/src/commands/nostr.js

@@ -4,6 +4,7 @@
  */
 
 import chalk from "chalk";
+import { numericOption } from "../lib/cli-numeric.js";
 import { logger } from "../lib/logger.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
@@ -103,7 +104,7 @@ export function registerNostrCommand(program) {
 
         const result = publishEvent(
           db,
-          parseInt(options.kind),
+          numericOption(options.kind, { name: "--kind", integer: true, min: 0 }),
           content,
           options.pubkey,
           [],
@@ -140,8 +141,8 @@ export function registerNostrCommand(program) {
         const db = ctx.db.getDatabase();
         ensureNostrTables(db);
 
-        const filter = { limit: parseInt(options.limit) };
-        if (options.kind) filter.kinds = [parseInt(options.kind)];
+        const filter = { limit: numericOption(options.limit, { name: "--limit", integer: true, min: 1, fallback: 50 }) };
+        if (options.kind) filter.kinds = [numericOption(options.kind, { name: "--kind", integer: true, min: 0 })];
         const events = getEvents(filter);
         if (options.json) {
           console.log(JSON.stringify(events, null, 2));

package/src/commands/note.js

@@ -4,6 +4,7 @@
  */
 
 import chalk from "chalk";
+import { numericOption } from "../lib/cli-numeric.js";
 import { logger } from "../lib/logger.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
@@ -151,7 +152,7 @@ export function registerNoteCommand(program) {
         }
 
         sql += " ORDER BY created_at DESC LIMIT ?";
-        params.push(parseInt(options.limit));
+        params.push(numericOption(options.limit, { name: "--limit", integer: true, min: 1, fallback: 20 }));
 
         let notes = rawDb.prepare(sql).all(...params);
 

package/src/commands/ops.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   SEVERITY,
@@ -288,7 +289,7 @@ export function registerOpsCommand(program) {
     .description("List incidents")
     .option("-s, --severity <P0-P3>", "Filter by severity")
     .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(ops);
@@ -380,7 +381,7 @@ export function registerOpsCommand(program) {
     .description("List playbooks")
     .option("-e, --enabled", "Only enabled")
     .option("-d, --disabled", "Only disabled")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(ops);

package/src/commands/perception.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   MODALITY,
@@ -131,7 +132,7 @@ export function registerPerceptionCommand(program) {
     )
     .option("-i, --input <source>", "Input source (file path or session id)")
     .option("-r, --result <json>", "Result data JSON")
-    .option("-c, --confidence <n>", "Confidence score (0-1)", parseFloat)
+    .option("-c, --confidence <n>", "Confidence score (0-1)", floatArg("--confidence"))
     .option("--metadata <json>", "Metadata JSON")
     .option("--json", "JSON output")
     .action((opts) => {
@@ -173,7 +174,7 @@ export function registerPerceptionCommand(program) {
     .description("List perception results")
     .option("-m, --modality <type>", "Filter by modality")
     .option("-a, --analysis <type>", "Filter by analysis type")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(perc);
@@ -262,7 +263,7 @@ export function registerPerceptionCommand(program) {
     .description("List voice sessions")
     .option("-s, --status <status>", "Filter by status")
     .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(perc);
@@ -329,7 +330,7 @@ export function registerPerceptionCommand(program) {
     .command("index-list")
     .description("List index entries")
     .option("-m, --modality <type>", "Filter by modality")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(perc);
@@ -365,7 +366,7 @@ export function registerPerceptionCommand(program) {
     .command("query <text>")
     .description("Cross-modal search across index entries")
     .option("-m, --modalities <csv>", "Filter modalities (comma-separated)")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((text, opts) => {
       const db = _dbFromCtx(perc);

package/src/commands/privacy.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   FL_STATUS,
@@ -117,9 +118,9 @@ export function registerPrivacyCommand(program) {
     .description("Create federated learning model")
     .option("-t, --type <type>", "Model type", "neural_network")
     .option("-a, --arch <architecture>", "Architecture", "mlp")
-    .option("-r, --rounds <n>", "Total training rounds", parseInt)
-    .option("-l, --lr <rate>", "Learning rate", parseFloat)
-    .option("-p, --participants <n>", "Participant count", parseInt)
+    .option("-r, --rounds <n>", "Total training rounds", intArg("--rounds"))
+    .option("-l, --lr <rate>", "Learning rate", floatArg("--lr"))
+    .option("-p, --participants <n>", "Participant count", intArg("--participants"))
     .option("--json", "JSON output")
     .action((name, opts) => {
       const db = _dbFromCtx(pc);
@@ -183,7 +184,7 @@ export function registerPrivacyCommand(program) {
   pc.command("models")
     .description("List federated learning models")
     .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(pc);
@@ -206,7 +207,7 @@ export function registerPrivacyCommand(program) {
     .description("Create MPC computation")
     .option("-p, --protocol <proto>", "Protocol (shamir/beaver/gmw)", "shamir")
     .option("-i, --participants <ids>", "Comma-separated participant IDs")
-    .option("-t, --threshold <n>", "Shares required", parseInt)
+    .option("-t, --threshold <n>", "Shares required", intArg("--threshold"))
     .option("--json", "JSON output")
     .action((type, opts) => {
       const db = _dbFromCtx(pc);
@@ -258,7 +259,7 @@ export function registerPrivacyCommand(program) {
     .description("List MPC computations")
     .option("-p, --protocol <proto>", "Filter by protocol")
     .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(pc);
@@ -281,13 +282,13 @@ export function registerPrivacyCommand(program) {
   pc.command("dp-publish")
     .description("Publish data with differential privacy noise")
     .option("-d, --data <json>", "Data (number or JSON array)")
-    .option("-e, --epsilon <n>", "Privacy parameter epsilon", parseFloat)
-    .option("--delta <n>", "Privacy parameter delta", parseFloat)
+    .option("-e, --epsilon <n>", "Privacy parameter epsilon", floatArg("--epsilon"))
+    .option("--delta <n>", "Privacy parameter delta", floatArg("--delta"))
     .option(
       "-m, --mechanism <type>",
       "Noise mechanism (laplace/gaussian/exponential)",
     )
-    .option("-s, --sensitivity <n>", "Sensitivity", parseFloat)
+    .option("-s, --sensitivity <n>", "Sensitivity", floatArg("--sensitivity"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(pc);
@@ -598,10 +599,10 @@ export function registerPrivacyCommand(program) {
   pc.command("dp-publish-v2")
     .description("V2 DP publish (throws on invalid input / exceeded budget)")
     .requiredOption("-d, --data <n>", "Data value", Number)
-    .option("-e, --epsilon <n>", "Epsilon", Number)
-    .option("--delta <n>", "Delta", Number)
+    .option("-e, --epsilon <n>", "Epsilon", floatArg("--epsilon"))
+    .option("--delta <n>", "Delta", floatArg("--delta"))
     .option("-m, --mechanism <mech>", "Mechanism")
-    .option("-s, --sensitivity <n>", "Sensitivity", Number)
+    .option("-s, --sensitivity <n>", "Sensitivity", floatArg("--sensitivity"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(pc);

package/src/commands/quantization.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   JOB_STATUS,
@@ -190,7 +191,7 @@ export function registerQuantizationCommand(program) {
     .command("complete <id>")
     .description("Mark a running job as completed")
     .option("-o, --output <path>", "Output file path")
-    .option("-s, --size <bytes>", "Output file size in bytes", parseInt)
+    .option("-s, --size <bytes>", "Output file size in bytes", intArg("--size"))
     .option("--json", "JSON output")
     .action((id, opts) => {
       const db = _dbFromCtx(quant);
@@ -271,7 +272,7 @@ export function registerQuantizationCommand(program) {
     .description("List quantization jobs")
     .option("-s, --status <status>", "Filter by status")
     .option("-t, --type <type>", "Filter by quant type (gguf/gptq)")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(quant);

package/src/commands/recommend.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   CONTENT_TYPES,
@@ -154,7 +155,7 @@ export function registerRecommendCommand(program) {
     .description("Update interest profile")
     .option("-t, --topics <json>", "Topic weights JSON")
     .option("-w, --weights <json>", "Interaction weights JSON")
-    .option("-d, --decay <factor>", "Decay factor", parseFloat)
+    .option("-d, --decay <factor>", "Decay factor", floatArg("--decay"))
     .option("--json", "JSON output")
     .action((userId, opts) => {
       const db = _dbFromCtx(rec);
@@ -186,7 +187,7 @@ export function registerRecommendCommand(program) {
   rec
     .command("profiles")
     .description("List all interest profiles")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(rec);
@@ -222,8 +223,8 @@ export function registerRecommendCommand(program) {
       "Generate recommendations from content pool (JSON stdin or --pool)",
     )
     .option("-p, --pool <json>", "Content pool as JSON array")
-    .option("-l, --limit <n>", "Max recommendations", parseInt)
-    .option("-m, --min-score <n>", "Minimum score", parseFloat)
+    .option("-l, --limit <n>", "Max recommendations", intArg("--limit"))
+    .option("-m, --min-score <n>", "Minimum score", floatArg("--min-score"))
     .option("--json", "JSON output")
     .action((userId, opts) => {
       const db = _dbFromCtx(rec);
@@ -266,8 +267,8 @@ export function registerRecommendCommand(program) {
     .description("List recommendations for a user")
     .option("-s, --status <status>", "Filter by status")
     .option("-t, --type <type>", "Filter by content type")
-    .option("-m, --min-score <n>", "Minimum score", parseFloat)
-    .option("--limit <n>", "Max results", parseInt)
+    .option("-m, --min-score <n>", "Minimum score", floatArg("--min-score"))
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((userId, opts) => {
       const db = _dbFromCtx(rec);
@@ -347,7 +348,7 @@ export function registerRecommendCommand(program) {
   rec
     .command("top-interests <user-id>")
     .description("Show top interests from profile")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((userId, opts) => {
       const db = _dbFromCtx(rec);

package/src/commands/reputation.js

@@ -4,6 +4,7 @@
  */
 
 import chalk from "chalk";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 import { logger } from "../lib/logger.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
@@ -95,8 +96,8 @@ export function registerReputationCommand(program) {
       "Decay model (none|exponential|linear|step)",
       "none",
     )
-    .option("--lambda <n>", "Exponential decay lambda", parseFloat)
-    .option("--alpha <n>", "Linear decay alpha", parseFloat)
+    .option("--lambda <n>", "Exponential decay lambda", floatArg("--lambda"))
+    .option("--alpha <n>", "Linear decay alpha", floatArg("--alpha"))
     .option("--json", "Output as JSON")
     .action(async (did, options) => {
       try {
@@ -164,7 +165,7 @@ export function registerReputationCommand(program) {
       "Detection method (z_score|iqr)",
       "z_score",
     )
-    .option("-t, --threshold <n>", "Detection threshold", parseFloat)
+    .option("-t, --threshold <n>", "Detection threshold", floatArg("--threshold"))
     .option(
       "-d, --decay <model>",
       "Decay model applied before detection",

package/src/commands/runtime.js

@@ -6,6 +6,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   PLUGIN_STATUS,
@@ -222,7 +223,7 @@ export function registerRuntimeCommand(program) {
     .command("plugins")
     .description("List plugins")
     .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(runtime);
@@ -282,7 +283,7 @@ export function registerRuntimeCommand(program) {
     .command("updates")
     .description("List updates")
     .option("-p, --plugin <id>", "Filter by plugin id")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(runtime);
@@ -305,7 +306,7 @@ export function registerRuntimeCommand(program) {
     .command("profile")
     .description("Take a runtime profile sample")
     .option("-t, --type <type>", "Profile type (cpu/memory/flamegraph)", "cpu")
-    .option("-d, --duration <ms>", "Duration in ms", parseInt)
+    .option("-d, --duration <ms>", "Duration in ms", intArg("--duration"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(runtime);
@@ -344,7 +345,7 @@ export function registerRuntimeCommand(program) {
     .command("profiles")
     .description("List profiles")
     .option("-t, --type <type>", "Filter by profile type")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(runtime);
@@ -391,7 +392,7 @@ export function registerRuntimeCommand(program) {
   runtime
     .command("state-list")
     .description("List synced state keys")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(runtime);

package/src/commands/sandbox.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";
@@ -252,7 +253,7 @@ export function registerSandboxCommand(program) {
     .description("Show audit log for sandboxes")
     .argument("[sandbox-id]", "Optional sandbox ID to filter")
     .option("--action <name>", "Filter by action type")
-    .option("--limit <n>", "Limit entries", parseInt)
+    .option("--limit <n>", "Limit entries", intArg("--limit"))
     .option("--json", "Output as JSON")
     .action(async (sandboxId, options) => {
       try {
@@ -293,8 +294,8 @@ export function registerSandboxCommand(program) {
     .command("quota")
     .description("Show or set sandbox quota")
     .argument("<sandbox-id>", "Sandbox ID")
-    .option("--cpu <n>", "Set CPU quota", parseInt)
-    .option("--memory <n>", "Set memory quota in MB", parseInt)
+    .option("--cpu <n>", "Set CPU quota", intArg("--cpu"))
+    .option("--memory <n>", "Set memory quota in MB", intArg("--memory"))
     .option("--json", "Output as JSON")
     .action(async (sandboxId, options) => {
       try {
@@ -780,7 +781,7 @@ export function registerSandboxCommand(program) {
     .option("-e, --events <types>", "Comma-separated event types")
     .option("--from <iso>", "ISO timestamp lower bound")
     .option("--to <iso>", "ISO timestamp upper bound")
-    .option("-l, --limit <n>", "Max entries to return", parseInt)
+    .option("-l, --limit <n>", "Max entries to return", intArg("--limit"))
     .option("--json", "Output as JSON")
     .action(async (id, options) => {
       try {