chainlesschain 0.162.78 → 0.162.80

package/src/commands/dao.js

@@ -5,6 +5,8 @@
 
 import chalk from "chalk";
 import { logger } from "../lib/logger.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
+import { parseNumberOption } from "../lib/parse-number-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
   ensureDAOv2Tables,
@@ -109,7 +111,7 @@ export function registerDaoCommand(program) {
           proposalId,
           options.voter,
           direction,
-          parseFloat(options.weight),
+          parseNumberOption(options.weight, "--weight", 1),
         );
         logger.success("Vote recorded");
         logger.log(
@@ -144,7 +146,7 @@ export function registerDaoCommand(program) {
           db,
           delegator,
           delegateTo,
-          parseFloat(options.weight),
+          parseNumberOption(options.weight, "--weight", 1),
         );
         logger.success("Delegation set");
         logger.log(`  ${chalk.bold("From:")}   ${result.delegator}`);
@@ -383,7 +385,7 @@ export function registerDaoCommand(program) {
           description: options.description,
           proposerDid: options.proposerDid || "did:cli:user",
           type: options.type,
-          actions: JSON.parse(options.actions),
+          actions: parseJsonOption(options.actions, "--actions"),
           votingDurationMs: options.votingDuration
             ? parseInt(options.votingDuration)
             : undefined,
@@ -489,7 +491,7 @@ export function registerDaoCommand(program) {
         const d = delegateVotingPower(db, {
           fromDid,
           toDid,
-          weight: parseFloat(options.weight),
+          weight: parseNumberOption(options.weight, "--weight", 1),
           expiresAt: options.expiresAt || null,
         });
         logger.success(`Delegated ${fromDid} → ${toDid}`);
@@ -663,7 +665,7 @@ export function registerDaoCommand(program) {
         const tx = allocateFundsV2(db, {
           proposalId,
           recipient: options.recipient,
-          amount: parseFloat(options.amount),
+          amount: parseNumberOption(options.amount, "--amount"),
           asset: options.asset,
           memo: options.memo,
         });
@@ -705,7 +707,7 @@ export function registerDaoCommand(program) {
         ensureDAOv2Tables(db);
 
         const tx = depositToTreasuryV2(db, {
-          amount: parseFloat(options.amount),
+          amount: parseNumberOption(options.amount, "--amount"),
           asset: options.asset,
           depositorDid: options.depositorDid,
           memo: options.memo,

package/src/commands/dbevo.js

@@ -64,15 +64,7 @@ import {
   autoFailStuckMigrationRuns,
   getDbEvoStatsV2,
 } from "../lib/dbevo.js";
-
-function _parseMetaV2(raw) {
-  if (!raw) return undefined;
-  try {
-    return JSON.parse(raw);
-  } catch {
-    throw new Error("--metadata must be valid JSON");
-  }
-}
+import { parseJsonOption } from "../lib/parse-json-option.js";
 
 function _dbFromCtx(cmd) {
   const root = cmd?.parent?.parent ?? cmd?.parent;
@@ -272,7 +264,14 @@ export function registerDbEvoCommand(program) {
     .option("--json", "JSON output")
     .action((sql, durationMs, opts) => {
       const db = _dbFromCtx(dbevo);
-      const params = opts.params ? JSON.parse(opts.params) : undefined;
+      let params;
+      try {
+        params = parseJsonOption(opts.params, "--params");
+      } catch (e) {
+        console.error(e.message);
+        process.exitCode = 1;
+        return;
+      }
       const result = logQuery(db, sql, parseFloat(durationMs), {
         params,
         source: opts.source,
@@ -532,7 +531,7 @@ export function registerDbEvoCommand(program) {
         databaseId: opts.database,
         version: opts.version,
         initialStatus: opts.initialStatus,
-        metadata: _parseMetaV2(opts.metadata),
+        metadata: parseJsonOption(opts.metadata, "--metadata"),
       });
       console.log(JSON.stringify(r, null, 2));
     });
@@ -558,7 +557,7 @@ export function registerDbEvoCommand(program) {
     .action((id, status, opts) => {
       const r = setBaselineStatusV2(null, id, status, {
         reason: opts.reason,
-        metadata: _parseMetaV2(opts.metadata),
+        metadata: parseJsonOption(opts.metadata, "--metadata"),
       });
       console.log(JSON.stringify(r, null, 2));
     });
@@ -602,7 +601,7 @@ export function registerDbEvoCommand(program) {
         databaseId: opts.database,
         migrationId: opts.migration,
         direction: opts.direction,
-        metadata: _parseMetaV2(opts.metadata),
+        metadata: parseJsonOption(opts.metadata, "--metadata"),
       });
       console.log(JSON.stringify(r, null, 2));
     });
@@ -628,7 +627,7 @@ export function registerDbEvoCommand(program) {
     .action((id, status, opts) => {
       const r = setMigrationRunStatusV2(null, id, status, {
         reason: opts.reason,
-        metadata: _parseMetaV2(opts.metadata),
+        metadata: parseJsonOption(opts.metadata, "--metadata"),
       });
       console.log(JSON.stringify(r, null, 2));
     });

package/src/commands/economy.js

@@ -5,6 +5,7 @@
 
 import chalk from "chalk";
 import { logger } from "../lib/logger.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
   ensureEconomyTables,
@@ -324,7 +325,7 @@ export function registerEconomyCommand(program) {
         const db = ctx.db.getDatabase();
         ensureEconomyTables(db);
 
-        const metadata = options.metadata ? JSON.parse(options.metadata) : {};
+        const metadata = parseJsonOption(options.metadata, "--metadata", {});
         const nftObj = mintNFT(db, owner, type, metadata);
         logger.success("NFT minted");
         logger.log(`  ${chalk.bold("ID:")}    ${chalk.cyan(nftObj.id)}`);
@@ -722,7 +723,7 @@ export function registerEconomyCommand(program) {
           owner,
           assetType,
           royaltyPercent: options.royalty,
-          metadata: options.metadata ? JSON.parse(options.metadata) : {},
+          metadata: parseJsonOption(options.metadata, "--metadata", {}),
         });
         if (options.json) console.log(JSON.stringify(n, null, 2));
         else

package/src/commands/evolution.js

@@ -6,6 +6,7 @@
 import chalk from "chalk";
 import ora from "ora";
 import { logger } from "../lib/logger.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
   assessCapability,
@@ -469,7 +470,7 @@ export function registerEvolutionCommand(program) {
     .option("--json", "Output as JSON")
     .action((dimension, score, options) => {
       try {
-        const metadata = JSON.parse(options.metadata);
+        const metadata = parseJsonOption(options.metadata, "--metadata");
         const r = assessCapabilityV2({
           dimension,
           score: parseFloat(score),
@@ -673,7 +674,7 @@ export function registerEvolutionCommand(program) {
     .option("--json", "Output as JSON")
     .action((type, options) => {
       try {
-        const details = JSON.parse(options.details);
+        const details = parseJsonOption(options.details, "--details");
         const r = recordMilestone({
           type,
           description: options.description,

package/src/commands/federation.js

@@ -52,6 +52,7 @@ import {
   autoIsolateUnhealthyNodes,
   getFederationHardeningStatsV2,
 } from "../lib/federation-hardening.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 
 function _dbFromCtx(cmd) {
   const root = cmd?.parent?.parent ?? cmd?.parent;
@@ -598,7 +599,7 @@ export function registerFederationCommand(program) {
     .option("--json", "JSON output")
     .action((nodeId, opts) => {
       const db = _dbFromCtx(fed);
-      const metadata = opts.metadata ? JSON.parse(opts.metadata) : undefined;
+      const metadata = parseJsonOption(opts.metadata, "--metadata");
       const r = registerNodeV2(db, { nodeId, metadata });
       if (opts.json) return console.log(JSON.stringify(r, null, 2));
       console.log(`Registered ${nodeId} (status: ${r.status})`);
@@ -626,7 +627,7 @@ export function registerFederationCommand(program) {
       const patch = {};
       if (opts.reason !== undefined) patch.reason = opts.reason;
       if (opts.metadata !== undefined)
-        patch.metadata = JSON.parse(opts.metadata);
+        patch.metadata = parseJsonOption(opts.metadata, "--metadata");
       const r = setNodeStatusV2(db, nodeId, status, patch);
       if (opts.json) return console.log(JSON.stringify(r, null, 2));
       console.log(`${nodeId} → ${r.status}`);
@@ -649,7 +650,7 @@ export function registerFederationCommand(program) {
     .option("--json", "JSON output")
     .action((nodeId, opts) => {
       const db = _dbFromCtx(fed);
-      const metrics = opts.metrics ? JSON.parse(opts.metrics) : undefined;
+      const metrics = parseJsonOption(opts.metrics, "--metrics");
       const r = recordHealthCheckV2(db, {
         nodeId,
         checkType: opts.type,

package/src/commands/governance.js

@@ -7,6 +7,7 @@
 
 import chalk from "chalk";
 import { logger } from "../lib/logger.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
   ensureGovernanceTables,
@@ -648,7 +649,8 @@ export function registerGovernanceCommand(program) {
       const config = { proposerId, realm: opts.realm };
       if (opts.displayName) config.displayName = opts.displayName;
       if (opts.initialStatus) config.initialStatus = opts.initialStatus;
-      if (opts.metadata) config.metadata = JSON.parse(opts.metadata);
+      if (opts.metadata)
+        config.metadata = parseJsonOption(opts.metadata, "--metadata");
       console.log(JSON.stringify(registerProposerV2(null, config), null, 2));
     });
 
@@ -667,7 +669,8 @@ export function registerGovernanceCommand(program) {
     .action((proposerId, status, opts) => {
       const patch = {};
       if (opts.reason !== undefined) patch.reason = opts.reason;
-      if (opts.metadata) patch.metadata = JSON.parse(opts.metadata);
+      if (opts.metadata)
+        patch.metadata = parseJsonOption(opts.metadata, "--metadata");
       console.log(
         JSON.stringify(
           setProposerMaturityV2(null, proposerId, status, patch),
@@ -734,7 +737,8 @@ export function registerGovernanceCommand(program) {
         scope: opts.scope,
       };
       if (opts.expiresAt) config.expiresAt = Number(opts.expiresAt);
-      if (opts.metadata) config.metadata = JSON.parse(opts.metadata);
+      if (opts.metadata)
+        config.metadata = parseJsonOption(opts.metadata, "--metadata");
       console.log(JSON.stringify(createDelegationV2(null, config), null, 2));
     });
 
@@ -753,7 +757,8 @@ export function registerGovernanceCommand(program) {
     .action((delegationId, status, opts) => {
       const patch = {};
       if (opts.reason !== undefined) patch.reason = opts.reason;
-      if (opts.metadata) patch.metadata = JSON.parse(opts.metadata);
+      if (opts.metadata)
+        patch.metadata = parseJsonOption(opts.metadata, "--metadata");
       console.log(
         JSON.stringify(
           setDelegationStatusV2(null, delegationId, status, patch),

package/src/commands/hardening.js

@@ -5,6 +5,7 @@
 
 import chalk from "chalk";
 import { logger } from "../lib/logger.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
   ensureHardeningTables,
@@ -518,7 +519,7 @@ export function registerHardeningCommand(program) {
       try {
         const { db } = await bootstrap();
         ensureHardeningTables(db);
-        const metadata = opts.metadata ? JSON.parse(opts.metadata) : undefined;
+        const metadata = parseJsonOption(opts.metadata, "--metadata");
         const r = registerAuditV2(db, {
           name,
           type: opts.type,
@@ -594,7 +595,7 @@ export function registerHardeningCommand(program) {
         if (opts.errorMessage !== undefined)
           patch.errorMessage = opts.errorMessage;
         if (opts.metadata !== undefined)
-          patch.metadata = JSON.parse(opts.metadata);
+          patch.metadata = parseJsonOption(opts.metadata, "--metadata");
         const r = setAuditStatusV2(db, auditId, status, patch);
         if (opts.json) console.log(JSON.stringify(r, null, 2));
         else console.log(`${auditId} → ${r.status}`);
@@ -644,7 +645,7 @@ export function registerHardeningCommand(program) {
       try {
         const { db } = await bootstrap();
         ensureHardeningTables(db);
-        const metadata = opts.metadata ? JSON.parse(opts.metadata) : undefined;
+        const metadata = parseJsonOption(opts.metadata, "--metadata");
         const r = createBaselineV2(db, {
           name,
           version: opts.version,
@@ -690,7 +691,7 @@ export function registerHardeningCommand(program) {
         const patch = {};
         if (opts.reason !== undefined) patch.reason = opts.reason;
         if (opts.metadata !== undefined)
-          patch.metadata = JSON.parse(opts.metadata);
+          patch.metadata = parseJsonOption(opts.metadata, "--metadata");
         const r = setBaselineStatusV2(db, baselineId, status, patch);
         if (opts.json) console.log(JSON.stringify(r, null, 2));
         else console.log(`${baselineId} → ${r.status}`);

package/src/commands/incentive.js

@@ -6,6 +6,7 @@
 
 import chalk from "chalk";
 import { logger } from "../lib/logger.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
   ensureTokenTables,
@@ -267,7 +268,7 @@ export function registerIncentiveCommand(program) {
       try {
         const ctx = await bootstrap({ verbose: program.opts().verbose });
         const db = _dbFromCtx(ctx);
-        const metadata = options.metadata ? JSON.parse(options.metadata) : null;
+        const metadata = parseJsonOption(options.metadata, "--metadata", null);
         const contribution = recordContribution(db, {
           userId,
           type,
@@ -485,7 +486,7 @@ export function registerIncentiveCommand(program) {
       const ctx = bootstrap();
       try {
         const db = _dbFromCtx(ctx);
-        const metadata = opts.metadata ? JSON.parse(opts.metadata) : undefined;
+        const metadata = parseJsonOption(opts.metadata, "--metadata");
         const entry = registerAccountV2(db, { accountId, metadata });
         logger.log(JSON.stringify(entry, null, 2));
       } finally {
@@ -514,7 +515,7 @@ export function registerIncentiveCommand(program) {
       const ctx = bootstrap();
       try {
         const db = _dbFromCtx(ctx);
-        const metadata = opts.metadata ? JSON.parse(opts.metadata) : undefined;
+        const metadata = parseJsonOption(opts.metadata, "--metadata");
         const entry = setAccountStatusV2(db, accountId, status, {
           reason: opts.reason,
           metadata,
@@ -581,7 +582,7 @@ export function registerIncentiveCommand(program) {
       const ctx = bootstrap();
       try {
         const db = _dbFromCtx(ctx);
-        const metadata = opts.metadata ? JSON.parse(opts.metadata) : undefined;
+        const metadata = parseJsonOption(opts.metadata, "--metadata");
         const entry = submitClaimV2(db, {
           claimId,
           userId: opts.user,
@@ -616,7 +617,7 @@ export function registerIncentiveCommand(program) {
       const ctx = bootstrap();
       try {
         const db = _dbFromCtx(ctx);
-        const metadata = opts.metadata ? JSON.parse(opts.metadata) : undefined;
+        const metadata = parseJsonOption(opts.metadata, "--metadata");
         const entry = setClaimStatusV2(db, claimId, status, {
           reason: opts.reason,
           metadata,

package/src/commands/kg.js

@@ -7,6 +7,7 @@
 import fs from "fs";
 import chalk from "chalk";
 import { logger } from "../lib/logger.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
   ensureKnowledgeGraphTables,
@@ -111,9 +112,11 @@ export function registerKgCommand(program) {
       try {
         const ctx = await bootstrap({ verbose: program.opts().verbose });
         const db = _dbFromCtx(ctx);
-        const properties = options.properties
-          ? JSON.parse(options.properties)
-          : null;
+        const properties = parseJsonOption(
+          options.properties,
+          "--properties",
+          null,
+        );
         const tags = options.tags
           ? options.tags
               .split(",")
@@ -221,9 +224,11 @@ export function registerKgCommand(program) {
       try {
         const ctx = await bootstrap({ verbose: program.opts().verbose });
         const db = _dbFromCtx(ctx);
-        const properties = options.properties
-          ? JSON.parse(options.properties)
-          : null;
+        const properties = parseJsonOption(
+          options.properties,
+          "--properties",
+          null,
+        );
         const relation = addRelation(db, {
           sourceId,
           targetId,
@@ -492,7 +497,7 @@ export function registerKgCommand(program) {
     .option("--json", "Output as JSON")
     .action((entityId, opts) => {
       try {
-        const metadata = opts.metadata ? JSON.parse(opts.metadata) : undefined;
+        const metadata = parseJsonOption(opts.metadata, "--metadata");
         const rec = registerEntityV2(null, {
           entityId,
           ownerId: opts.owner,
@@ -533,7 +538,8 @@ export function registerKgCommand(program) {
       try {
         const patch = {};
         if (opts.reason) patch.reason = opts.reason;
-        if (opts.metadata) patch.metadata = JSON.parse(opts.metadata);
+        if (opts.metadata)
+          patch.metadata = parseJsonOption(opts.metadata, "--metadata");
         const rec = setEntityStatusV2(null, entityId, status, patch);
         logger.success(`Entity ${entityId} → ${rec.status}`);
       } catch (err) {
@@ -615,7 +621,7 @@ export function registerKgCommand(program) {
     .option("--json", "Output as JSON")
     .action((relationId, opts) => {
       try {
-        const metadata = opts.metadata ? JSON.parse(opts.metadata) : undefined;
+        const metadata = parseJsonOption(opts.metadata, "--metadata");
         const rec = registerRelationV2(null, {
           relationId,
           sourceEntityId: opts.source,
@@ -659,7 +665,8 @@ export function registerKgCommand(program) {
       try {
         const patch = {};
         if (opts.reason) patch.reason = opts.reason;
-        if (opts.metadata) patch.metadata = JSON.parse(opts.metadata);
+        if (opts.metadata)
+          patch.metadata = parseJsonOption(opts.metadata, "--metadata");
         const rec = setRelationStatusV2(null, relationId, status, patch);
         logger.success(`Relation ${relationId} → ${rec.status}`);
       } catch (err) {

package/src/commands/lowcode.js

@@ -226,12 +226,18 @@ export function registerLowcodeCommand(program) {
         const db = ctx.db.getDatabase();
         ensureLowcodeTables(db);
 
-        let config;
-        try {
-          config = JSON.parse(options.config);
-        } catch (_err) {
-          // Intentionally ignore parse error — use empty config
-          config = {};
+        let config = {};
+        if (options.config) {
+          try {
+            config = JSON.parse(options.config);
+          } catch (err) {
+            // Non-fatal by design (fall back to empty config), but surface the
+            // problem instead of swallowing it — a typo'd --config was silently
+            // dropped before, so the data source looked configured but wasn't.
+            logger.warn(
+              `Ignoring invalid --config JSON (using empty config): ${err.message}`,
+            );
+          }
         }
 
         const result = addDataSource(db, appId, name, type, config);
@@ -413,11 +419,17 @@ export function registerLowcodeCommand(program) {
         const db = ctx.db.getDatabase();
         ensureLowcodeTables(db);
 
-        let config;
-        try {
-          config = JSON.parse(options.config);
-        } catch (_err) {
-          config = {};
+        let config = {};
+        if (options.config) {
+          try {
+            config = JSON.parse(options.config);
+          } catch (err) {
+            // Non-fatal by design (fall back to empty config), but surface the
+            // problem instead of swallowing it silently.
+            logger.warn(
+              `Ignoring invalid --config JSON (using empty config): ${err.message}`,
+            );
+          }
         }
 
         const result = registerDataSourceV2(db, {

package/src/commands/marketplace.js

@@ -6,6 +6,7 @@
 
 import chalk from "chalk";
 import { logger } from "../lib/logger.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
 import {
   ensureMarketplaceTables,
@@ -122,7 +123,7 @@ export function registerMarketplaceCommand(program) {
       try {
         const ctx = await bootstrap({ verbose: program.opts().verbose });
         const db = _dbFromCtx(ctx);
-        const pricing = options.pricing ? JSON.parse(options.pricing) : null;
+        const pricing = parseJsonOption(options.pricing, "--pricing", null);
         const service = publishService(db, {
           name,
           version: options.version,
@@ -246,8 +247,8 @@ export function registerMarketplaceCommand(program) {
       try {
         const ctx = await bootstrap({ verbose: program.opts().verbose });
         const db = _dbFromCtx(ctx);
-        const input = options.input ? JSON.parse(options.input) : null;
-        const output = options.output ? JSON.parse(options.output) : null;
+        const input = parseJsonOption(options.input, "--input", null);
+        const output = parseJsonOption(options.output, "--output", null);
         const inv = recordInvocation(db, {
           serviceId,
           callerId: options.caller,

package/src/commands/mcp.js

@@ -22,6 +22,7 @@ import {
   generateMcpServerScaffold,
   SUPPORTED_TRANSPORTS,
 } from "../lib/mcp-scaffold.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 import {
   CATALOG as REGISTRY_CATALOG,
   CATEGORIES as REGISTRY_CATEGORIES,
@@ -236,7 +237,9 @@ export function registerMcpCommand(program) {
         });
         logger.log(chalk.bold("MCP server ready (Streamable-HTTP)"));
         logger.log(`  URL:   ${chalk.cyan(handle.url)}`);
-        logger.log(`  Root:  ${handle.root}${handle.readOnly ? "  (read-only)" : ""}`);
+        logger.log(
+          `  Root:  ${handle.root}${handle.readOnly ? "  (read-only)" : ""}`,
+        );
         if (handle.token) {
           logger.log(`  Auth:  Bearer ${handle.token}`);
         } else {
@@ -555,8 +558,17 @@ export function registerMcpCommand(program) {
         if (options.json) {
           console.log(JSON.stringify(result, null, 2));
         } else {
-          logger.success(`Connected to ${chalk.cyan(name)}`);
-          logger.log(`  ${chalk.gray("Tools:")} ${result.tools.length}`);
+          // initialize succeeded but tools/list failed → connected, yet the
+          // tool list is unreliable. Surface it rather than a misleading
+          // "Tools: 0" (Claude-Code 2.1.181 parity).
+          if (result.toolsError) {
+            logger.warn(
+              `${chalk.yellow("!")} Connected to ${chalk.cyan(name)} ${chalk.gray("·")} tools fetch failed: ${result.toolsError}`,
+            );
+          } else {
+            logger.success(`Connected to ${chalk.cyan(name)}`);
+            logger.log(`  ${chalk.gray("Tools:")} ${result.tools.length}`);
+          }
           logger.log(
             `  ${chalk.gray("Resources:")} ${result.resources.length}`,
           );
@@ -650,7 +662,7 @@ export function registerMcpCommand(program) {
           serverName = match.server;
         }
 
-        const args = options.args ? JSON.parse(options.args) : {};
+        const args = parseJsonOption(options.args, "--args", {});
         const spinner = ora(`Calling ${tool}...`).start();
 
         const result = await client.callTool(serverName, tool, args);
@@ -822,7 +834,7 @@ export function registerMcpCommand(program) {
           }
           server = match.server;
         }
-        const args = options.args ? JSON.parse(options.args) : {};
+        const args = parseJsonOption(options.args, "--args", {});
         const result = await client.getPrompt(server, name, args);
         if (options.json) {
           console.log(JSON.stringify(result, null, 2));

package/src/commands/ops.js

@@ -61,6 +61,7 @@ import {
   autoTimeoutStuckRemediations,
   getAiOpsStatsV2,
 } from "../lib/aiops.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 
 function _dbFromCtx(cmd) {
   const root = cmd?.parent?.parent ?? cmd?.parent;
@@ -549,7 +550,8 @@ export function registerOpsCommand(program) {
       const config = { playbookId, ownerId: opts.owner };
       if (opts.name) config.name = opts.name;
       if (opts.initialStatus) config.initialStatus = opts.initialStatus;
-      if (opts.metadata) config.metadata = JSON.parse(opts.metadata);
+      if (opts.metadata)
+        config.metadata = parseJsonOption(opts.metadata, "--metadata");
       console.log(JSON.stringify(registerPlaybookV2(db, config), null, 2));
     });
 
@@ -570,7 +572,8 @@ export function registerOpsCommand(program) {
       const db = _dbFromCtx(cmd);
       const patch = {};
       if (opts.reason !== undefined) patch.reason = opts.reason;
-      if (opts.metadata) patch.metadata = JSON.parse(opts.metadata);
+      if (opts.metadata)
+        patch.metadata = parseJsonOption(opts.metadata, "--metadata");
       console.log(
         JSON.stringify(
           setPlaybookMaturityV2(db, playbookId, status, patch),
@@ -639,7 +642,8 @@ export function registerOpsCommand(program) {
         playbookId: opts.playbook,
       };
       if (opts.incident) config.incidentId = opts.incident;
-      if (opts.metadata) config.metadata = JSON.parse(opts.metadata);
+      if (opts.metadata)
+        config.metadata = parseJsonOption(opts.metadata, "--metadata");
       console.log(JSON.stringify(submitRemediationV2(db, config), null, 2));
     });
 
@@ -660,7 +664,8 @@ export function registerOpsCommand(program) {
       const db = _dbFromCtx(cmd);
       const patch = {};
       if (opts.reason !== undefined) patch.reason = opts.reason;
-      if (opts.metadata) patch.metadata = JSON.parse(opts.metadata);
+      if (opts.metadata)
+        patch.metadata = parseJsonOption(opts.metadata, "--metadata");
       console.log(
         JSON.stringify(
           setRemediationStatusV2(db, remediationId, status, patch),

package/src/commands/recommend.js

@@ -65,6 +65,7 @@ import {
   autoArchiveStaleFeeds,
   getRecommendationStatsV2,
 } from "../lib/content-recommendation.js";
+import { parseJsonOption } from "../lib/parse-json-option.js";
 
 function _dbFromCtx(cmd) {
   const root = cmd?.parent?.parent ?? cmd?.parent;
@@ -140,8 +141,8 @@ export function registerRecommendCommand(program) {
     .option("--json", "JSON output")
     .action((userId, opts) => {
       const db = _dbFromCtx(rec);
-      const topics = opts.topics ? JSON.parse(opts.topics) : {};
-      const interactionWeights = opts.weights ? JSON.parse(opts.weights) : {};
+      const topics = parseJsonOption(opts.topics, "--topics", {});
+      const interactionWeights = parseJsonOption(opts.weights, "--weights", {});
       const result = createProfile(db, userId, { topics, interactionWeights });
       if (opts.json) return console.log(JSON.stringify(result, null, 2));
       if (result.profileId) console.log(`Profile created: ${result.profileId}`);
@@ -158,8 +159,9 @@ export function registerRecommendCommand(program) {
     .action((userId, opts) => {
       const db = _dbFromCtx(rec);
       const params = {};
-      if (opts.topics) params.topics = JSON.parse(opts.topics);
-      if (opts.weights) params.interactionWeights = JSON.parse(opts.weights);
+      if (opts.topics) params.topics = parseJsonOption(opts.topics, "--topics");
+      if (opts.weights)
+        params.interactionWeights = parseJsonOption(opts.weights, "--weights");
       if (opts.decay !== undefined) params.decayFactor = opts.decay;
       const result = updateProfile(db, userId, params);
       if (opts.json) return console.log(JSON.stringify(result, null, 2));
@@ -228,7 +230,7 @@ export function registerRecommendCommand(program) {
       if (!opts.pool) {
         return console.log("Provide --pool as JSON array of content items.");
       }
-      const pool = JSON.parse(opts.pool);
+      const pool = parseJsonOption(opts.pool, "--pool");
       const result = generateRecommendations(db, userId, pool, {
         limit: opts.limit,
         minScore: opts.minScore,