chainlesschain 0.162.101 → 0.162.102

package/src/commands/inference.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   NODE_STATUS,
@@ -95,7 +96,7 @@ export function registerInferenceCommand(program) {
     .description("Register inference node")
     .option("-e, --endpoint <url>", "Node endpoint URL")
     .option("-c, --capabilities <list>", "Comma-separated capabilities")
-    .option("-g, --gpu <mb>", "GPU memory in MB", parseInt)
+    .option("-g, --gpu <mb>", "GPU memory in MB", intArg("--gpu"))
     .option("--json", "JSON output")
     .action((nodeId, opts) => {
       const db = _dbFromCtx(inf);
@@ -176,7 +177,7 @@ export function registerInferenceCommand(program) {
     .description("List inference nodes")
     .option("-s, --status <status>", "Filter by status")
     .option("-c, --capability <cap>", "Filter by capability")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(inf);
@@ -200,7 +201,7 @@ export function registerInferenceCommand(program) {
     .command("submit <model>")
     .description("Submit inference task")
     .option("-i, --input <text>", "Input data")
-    .option("-p, --priority <n>", "Priority (1-10)", parseInt)
+    .option("-p, --priority <n>", "Priority (1-10)", intArg("--priority"))
     .option("-m, --mode <mode>", "Privacy mode (standard/encrypted/federated)")
     .option("--json", "JSON output")
     .action((model, opts) => {
@@ -223,7 +224,7 @@ export function registerInferenceCommand(program) {
     .command("complete <task-id>")
     .description("Mark task as complete")
     .option("-o, --output <text>", "Task output")
-    .option("-d, --duration <ms>", "Duration in ms", parseInt)
+    .option("-d, --duration <ms>", "Duration in ms", intArg("--duration"))
     .option("--json", "JSON output")
     .action((taskId, opts) => {
       const db = _dbFromCtx(inf);
@@ -279,7 +280,7 @@ export function registerInferenceCommand(program) {
     .option("-s, --status <status>", "Filter by status")
     .option("-m, --model <model>", "Filter by model")
     .option("-p, --privacy <mode>", "Filter by privacy mode")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(inf);
@@ -437,7 +438,7 @@ export function registerInferenceCommand(program) {
     .command("submit-v2 <model>")
     .description("Submit task (V2, creates queued no assignment)")
     .option("-i, --input <text>", "Input data")
-    .option("-p, --priority <n>", "Priority (1-10)", parseInt)
+    .option("-p, --priority <n>", "Priority (1-10)", intArg("--priority"))
     .option("-m, --mode <mode>", "Privacy mode")
     .option("--json", "JSON output")
     .action((model, opts) => {
@@ -501,7 +502,7 @@ export function registerInferenceCommand(program) {
     .command("complete-v2 <task-id>")
     .description("Complete running task (running → complete)")
     .option("-o, --output <text>", "Task output")
-    .option("-d, --duration <ms>", "Duration in ms", parseInt)
+    .option("-d, --duration <ms>", "Duration in ms", intArg("--duration"))
     .option("--json", "JSON output")
     .action((taskId, opts) => {
       const db = _dbFromCtx(inf);
@@ -543,7 +544,7 @@ export function registerInferenceCommand(program) {
     .command("set-task-status <task-id> <status>")
     .description("Generic state-machine-guarded task status setter")
     .option("-o, --output <text>", "Patch: output")
-    .option("-d, --duration <ms>", "Patch: durationMs", parseInt)
+    .option("-d, --duration <ms>", "Patch: durationMs", intArg("--duration"))
     .option("-e, --error <text>", "Patch: errorMessage")
     .option("--json", "JSON output")
     .action((taskId, status, opts) => {

package/src/commands/infra.js

@@ -3,6 +3,7 @@
  */
 
 import { Command } from "commander";
+import { intArg, floatArg } from "../lib/cli-arg.js";
 
 import {
   DEAL_STATUS,
@@ -115,8 +116,8 @@ export function registerInfraCommand(program) {
     .requiredOption("-c, --cid <cid>", "Content CID")
     .requiredOption("-s, --size <bytes>", "Size in bytes", parseInt)
     .option("-m, --miner <id>", "Miner ID")
-    .option("-p, --price <fil>", "Price in FIL", parseFloat)
-    .option("-d, --duration <epochs>", "Duration in epochs", parseInt)
+    .option("-p, --price <fil>", "Price in FIL", floatArg("--price"))
+    .option("-d, --duration <epochs>", "Duration in epochs", intArg("--duration"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(inf);
@@ -180,7 +181,7 @@ export function registerInfraCommand(program) {
     .command("deals")
     .description("List storage deals")
     .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(inf);
@@ -205,7 +206,7 @@ export function registerInfraCommand(program) {
     .requiredOption("-c, --cid <cid>", "Content CID")
     .option("-p, --parent <cid>", "Parent CID")
     .option("-d, --dag <json>", "DAG structure")
-    .option("-n, --peers <n>", "Peer count", parseInt)
+    .option("-n, --peers <n>", "Peer count", intArg("--peers"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(inf);
@@ -242,7 +243,7 @@ export function registerInfraCommand(program) {
     .command("versions")
     .description("List content versions")
     .option("-c, --cid <cid>", "Filter by content CID")
-    .option("--limit <n>", "Max results", parseInt)
+    .option("--limit <n>", "Max results", intArg("--limit"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(inf);
@@ -282,8 +283,8 @@ export function registerInfraCommand(program) {
       "Route type (tor/domain_front/mesh_ble/mesh_wifi/direct)",
     )
     .option("-e, --endpoint <url>", "Endpoint URL")
-    .option("-l, --latency <ms>", "Latency in ms", parseInt)
-    .option("-r, --reliability <0-1>", "Reliability score", parseFloat)
+    .option("-l, --latency <ms>", "Latency in ms", intArg("--latency"))
+    .option("-r, --reliability <0-1>", "Reliability score", floatArg("--reliability"))
     .option("--json", "JSON output")
     .action((opts) => {
       const db = _dbFromCtx(inf);
@@ -346,7 +347,7 @@ export function registerInfraCommand(program) {
     .description("List anti-censorship routes")
     .option("-t, --type <type>", "Filter by route 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(inf);

package/src/commands/instinct.js

@@ -9,6 +9,8 @@ import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
   getInstincts,
   getStrongInstincts,
+  exportInstincts,
+  importInstincts,
   resetInstincts,
   deleteInstinct,
   decayInstincts,
@@ -104,6 +106,70 @@ export function registerInstinctCommand(program) {
       }
     });
 
+  // instinct export — §8.3 cross-device backup: full dump of the instincts table
+  instinct
+    .command("export")
+    .description("Export all instincts 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 rows = exportInstincts(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} instincts → ${options.output}`);
+          }
+        } else {
+          console.log(JSON.stringify(rows));
+        }
+        await shutdown();
+      } catch (err) {
+        logger.error(`instinct export failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
+  // instinct import — §8.3 restore: idempotent upsert by id from a JSON-array file
+  instinct
+    .command("import")
+    .description("Import instincts from a JSON array file (idempotent upsert by id; §8.3)")
+    .requiredOption("--input <file>", "JSON array of instincts 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 instincts");
+        }
+        const ctx = await bootstrap({ verbose: program.opts().verbose });
+        if (!ctx.db) {
+          logger.error("Database not available");
+          process.exit(1);
+        }
+        const result = importInstincts(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(`instinct import failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+
   // instinct categories
   instinct
     .command("categories")

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);