chainlesschain 0.81.0 → 0.132.0

package/src/commands/tokens.js

@@ -11,6 +11,37 @@ import {
   getTodayStats,
   getCostBreakdown,
   getRecentUsage,
+  BUDGET_MATURITY_V2,
+  USAGE_RECORD_LIFECYCLE_V2,
+  getMaxActiveBudgetsPerOwnerV2,
+  setMaxActiveBudgetsPerOwnerV2,
+  getMaxPendingRecordsPerBudgetV2,
+  setMaxPendingRecordsPerBudgetV2,
+  getBudgetIdleMsV2,
+  setBudgetIdleMsV2,
+  getRecordStuckMsV2,
+  setRecordStuckMsV2,
+  registerBudgetV2,
+  getBudgetV2,
+  listBudgetsV2,
+  setBudgetStatusV2,
+  activateBudgetV2,
+  suspendBudgetV2,
+  archiveBudgetV2,
+  touchBudgetV2,
+  getActiveBudgetCountV2,
+  createUsageRecordV2,
+  getUsageRecordV2,
+  listUsageRecordsV2,
+  setUsageRecordStatusV2,
+  recordUsageV2,
+  billUsageV2,
+  rejectUsageV2,
+  refundUsageV2,
+  getPendingRecordCountV2,
+  autoSuspendIdleBudgetsV2,
+  autoRejectStaleRecordsV2,
+  getTokenTrackerStatsV2,
 } from "../lib/token-tracker.js";
 import {
   getCacheStats,
@@ -211,4 +242,242 @@ export function registerTokensCommand(program) {
         process.exit(1);
       }
     });
+
+  // ── V2 Surface ──
+
+  const out = (json, obj) => {
+    if (json) console.log(JSON.stringify(obj, null, 2));
+    else console.log(JSON.stringify(obj, null, 2));
+  };
+  const tryRun = (fn) => {
+    try {
+      fn();
+    } catch (err) {
+      logger.error(err.message);
+      process.exit(1);
+    }
+  };
+
+  tokens
+    .command("budget-maturities-v2")
+    .description("List V2 budget maturity states")
+    .action(() => out(true, Object.values(BUDGET_MATURITY_V2)));
+
+  tokens
+    .command("usage-record-lifecycles-v2")
+    .description("List V2 usage record lifecycle states")
+    .action(() => out(true, Object.values(USAGE_RECORD_LIFECYCLE_V2)));
+
+  tokens
+    .command("stats-v2")
+    .description("V2 token-tracker stats")
+    .action(() => out(true, getTokenTrackerStatsV2()));
+
+  tokens
+    .command("get-max-active-budgets-v2")
+    .description("Get max active budgets per owner (V2)")
+    .action(() =>
+      out(true, { maxActiveBudgetsPerOwner: getMaxActiveBudgetsPerOwnerV2() }),
+    );
+
+  tokens
+    .command("set-max-active-budgets-v2 <n>")
+    .description("Set max active budgets per owner (V2)")
+    .action((n) =>
+      tryRun(() => {
+        setMaxActiveBudgetsPerOwnerV2(Number(n));
+        out(true, {
+          maxActiveBudgetsPerOwner: getMaxActiveBudgetsPerOwnerV2(),
+        });
+      }),
+    );
+
+  tokens
+    .command("get-max-pending-records-v2")
+    .description("Get max pending records per budget (V2)")
+    .action(() =>
+      out(true, {
+        maxPendingRecordsPerBudget: getMaxPendingRecordsPerBudgetV2(),
+      }),
+    );
+
+  tokens
+    .command("set-max-pending-records-v2 <n>")
+    .description("Set max pending records per budget (V2)")
+    .action((n) =>
+      tryRun(() => {
+        setMaxPendingRecordsPerBudgetV2(Number(n));
+        out(true, {
+          maxPendingRecordsPerBudget: getMaxPendingRecordsPerBudgetV2(),
+        });
+      }),
+    );
+
+  tokens
+    .command("get-budget-idle-ms-v2")
+    .description("Get budget idle threshold (V2)")
+    .action(() => out(true, { budgetIdleMs: getBudgetIdleMsV2() }));
+
+  tokens
+    .command("set-budget-idle-ms-v2 <ms>")
+    .description("Set budget idle threshold (V2)")
+    .action((ms) =>
+      tryRun(() => {
+        setBudgetIdleMsV2(Number(ms));
+        out(true, { budgetIdleMs: getBudgetIdleMsV2() });
+      }),
+    );
+
+  tokens
+    .command("get-record-stuck-ms-v2")
+    .description("Get record stuck threshold (V2)")
+    .action(() => out(true, { recordStuckMs: getRecordStuckMsV2() }));
+
+  tokens
+    .command("set-record-stuck-ms-v2 <ms>")
+    .description("Set record stuck threshold (V2)")
+    .action((ms) =>
+      tryRun(() => {
+        setRecordStuckMsV2(Number(ms));
+        out(true, { recordStuckMs: getRecordStuckMsV2() });
+      }),
+    );
+
+  tokens
+    .command("active-budget-count-v2 <ownerId>")
+    .description("Active budget count for owner (V2)")
+    .action((ownerId) =>
+      out(true, { ownerId, count: getActiveBudgetCountV2(ownerId) }),
+    );
+
+  tokens
+    .command("pending-record-count-v2 <budgetId>")
+    .description("Pending record count for budget (V2)")
+    .action((budgetId) =>
+      out(true, { budgetId, count: getPendingRecordCountV2(budgetId) }),
+    );
+
+  tokens
+    .command("register-budget-v2 <id>")
+    .description("Register a V2 budget")
+    .requiredOption("-o, --owner <id>", "owner id")
+    .requiredOption("-l, --label <label>", "budget label")
+    .action((id, opts) =>
+      tryRun(() =>
+        out(
+          true,
+          registerBudgetV2(id, { ownerId: opts.owner, label: opts.label }),
+        ),
+      ),
+    );
+
+  tokens
+    .command("get-budget-v2 <id>")
+    .description("Get a V2 budget")
+    .action((id) => out(true, getBudgetV2(id)));
+
+  tokens
+    .command("list-budgets-v2")
+    .description("List V2 budgets")
+    .option("-o, --owner <id>", "filter by owner")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) =>
+      out(true, listBudgetsV2({ ownerId: opts.owner, status: opts.status })),
+    );
+
+  tokens
+    .command("set-budget-status-v2 <id> <next>")
+    .description("Set V2 budget status")
+    .action((id, next) => tryRun(() => out(true, setBudgetStatusV2(id, next))));
+
+  tokens
+    .command("activate-budget-v2 <id>")
+    .description("Activate a V2 budget")
+    .action((id) => tryRun(() => out(true, activateBudgetV2(id))));
+
+  tokens
+    .command("suspend-budget-v2 <id>")
+    .description("Suspend a V2 budget")
+    .action((id) => tryRun(() => out(true, suspendBudgetV2(id))));
+
+  tokens
+    .command("archive-budget-v2 <id>")
+    .description("Archive a V2 budget")
+    .action((id) => tryRun(() => out(true, archiveBudgetV2(id))));
+
+  tokens
+    .command("touch-budget-v2 <id>")
+    .description("Touch a V2 budget")
+    .action((id) => tryRun(() => out(true, touchBudgetV2(id))));
+
+  tokens
+    .command("create-usage-record-v2 <id>")
+    .description("Create a V2 usage record")
+    .requiredOption("-b, --budget <id>", "budget id")
+    .requiredOption("-u, --units <n>", "usage units")
+    .action((id, opts) =>
+      tryRun(() =>
+        out(
+          true,
+          createUsageRecordV2(id, {
+            budgetId: opts.budget,
+            units: Number(opts.units),
+          }),
+        ),
+      ),
+    );
+
+  tokens
+    .command("get-usage-record-v2 <id>")
+    .description("Get a V2 usage record")
+    .action((id) => out(true, getUsageRecordV2(id)));
+
+  tokens
+    .command("list-usage-records-v2")
+    .description("List V2 usage records")
+    .option("-b, --budget <id>", "filter by budget")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) =>
+      out(
+        true,
+        listUsageRecordsV2({ budgetId: opts.budget, status: opts.status }),
+      ),
+    );
+
+  tokens
+    .command("set-usage-record-status-v2 <id> <next>")
+    .description("Set V2 usage record status")
+    .action((id, next) =>
+      tryRun(() => out(true, setUsageRecordStatusV2(id, next))),
+    );
+
+  tokens
+    .command("record-usage-v2 <id>")
+    .description("Mark V2 usage record recorded")
+    .action((id) => tryRun(() => out(true, recordUsageV2(id))));
+
+  tokens
+    .command("bill-usage-v2 <id>")
+    .description("Bill V2 usage record")
+    .action((id) => tryRun(() => out(true, billUsageV2(id))));
+
+  tokens
+    .command("reject-usage-v2 <id>")
+    .description("Reject V2 usage record")
+    .action((id) => tryRun(() => out(true, rejectUsageV2(id))));
+
+  tokens
+    .command("refund-usage-v2 <id>")
+    .description("Refund V2 usage record")
+    .action((id) => tryRun(() => out(true, refundUsageV2(id))));
+
+  tokens
+    .command("auto-suspend-idle-budgets-v2")
+    .description("Auto-suspend idle V2 budgets")
+    .action(() => out(true, autoSuspendIdleBudgetsV2()));
+
+  tokens
+    .command("auto-reject-stale-records-v2")
+    .description("Auto-reject stale V2 records")
+    .action(() => out(true, autoRejectStaleRecordsV2()));
 }

package/src/commands/trust.js

@@ -27,8 +27,48 @@ import {
   listHsmDevices,
   signWithHsm,
   getTrustSecurityStats,
+  HSM_MATURITY_V2,
+  TRANSMISSION_V2,
+  getMaxActiveDevicesPerOperator,
+  setMaxActiveDevicesPerOperator,
+  getMaxPendingTransmissionsPerDevice,
+  setMaxPendingTransmissionsPerDevice,
+  getDeviceIdleMs,
+  setDeviceIdleMs,
+  getTransmissionStuckMs,
+  setTransmissionStuckMs,
+  getActiveDeviceCount,
+  getPendingTransmissionCount,
+  registerDeviceV2,
+  getDeviceV2,
+  listDevicesV2,
+  setDeviceMaturityV2,
+  activateDevice,
+  degradeDevice,
+  retireDevice,
+  touchDeviceUsage,
+  enqueueTransmissionV2,
+  getTransmissionV2,
+  listTransmissionsV2,
+  setTransmissionStatusV2,
+  startTransmission,
+  confirmTransmission,
+  failTransmission,
+  cancelTransmission,
+  autoRetireIdleDevices,
+  autoFailStuckTransmissions,
+  getTrustSecurityStatsV2,
 } from "../lib/trust-security.js";
 
+function _parseJsonV2(s) {
+  if (!s) return undefined;
+  try {
+    return JSON.parse(s);
+  } catch {
+    throw new Error(`invalid JSON: ${s}`);
+  }
+}
+
 function _dbFromCtx(cmd) {
   const root = cmd?.parent?.parent ?? cmd?.parent;
   return root?._db;
@@ -362,5 +402,214 @@ export function registerTrustCommand(program) {
       console.log(`HSM Devices:  ${s.hsm.total}`);
     });
 
+  /* ── V2 Surface (Phase 68-71) ─────────────────────────── */
+
+  tr.command("hsm-maturities-v2")
+    .description("List HSM_MATURITY_V2 enum")
+    .action(() => {
+      for (const v of Object.values(HSM_MATURITY_V2)) console.log(`  ${v}`);
+    });
+
+  tr.command("transmissions-v2")
+    .description("List TRANSMISSION_V2 enum")
+    .action(() => {
+      for (const v of Object.values(TRANSMISSION_V2)) console.log(`  ${v}`);
+    });
+
+  tr.command("max-active-devices-per-operator")
+    .description("Get current max-active-devices-per-operator cap")
+    .action(() => console.log(getMaxActiveDevicesPerOperator()));
+  tr.command("set-max-active-devices-per-operator <n>").action((n) =>
+    console.log(setMaxActiveDevicesPerOperator(Number(n))),
+  );
+
+  tr.command("max-pending-transmissions-per-device")
+    .description("Get current max-pending-transmissions-per-device cap")
+    .action(() => console.log(getMaxPendingTransmissionsPerDevice()));
+  tr.command("set-max-pending-transmissions-per-device <n>").action((n) =>
+    console.log(setMaxPendingTransmissionsPerDevice(Number(n))),
+  );
+
+  tr.command("device-idle-ms")
+    .description("Get current device-idle-ms threshold")
+    .action(() => console.log(getDeviceIdleMs()));
+  tr.command("set-device-idle-ms <n>").action((n) =>
+    console.log(setDeviceIdleMs(Number(n))),
+  );
+
+  tr.command("transmission-stuck-ms")
+    .description("Get current transmission-stuck-ms threshold")
+    .action(() => console.log(getTransmissionStuckMs()));
+  tr.command("set-transmission-stuck-ms <n>").action((n) =>
+    console.log(setTransmissionStuckMs(Number(n))),
+  );
+
+  tr.command("active-device-count")
+    .description("Count active+degraded devices (optionally by operator)")
+    .option("-o, --operator <operator>", "scope to operator")
+    .action((opts) => console.log(getActiveDeviceCount(opts.operator)));
+
+  tr.command("pending-transmission-count")
+    .description("Count non-terminal transmissions (optionally by device)")
+    .option("-d, --device <device>", "scope to device")
+    .action((opts) => console.log(getPendingTransmissionCount(opts.device)));
+
+  tr.command("register-device-v2 <device-id>")
+    .description("Register V2 HSM device")
+    .requiredOption("-o, --operator <operator>", "operator id")
+    .requiredOption("-v, --vendor <vendor>", "HSM vendor")
+    .option(
+      "-i, --initial <status>",
+      "initial status",
+      HSM_MATURITY_V2.PROVISIONAL,
+    )
+    .option("--metadata <json>", "metadata JSON")
+    .action((id, opts) => {
+      const d = registerDeviceV2({
+        id,
+        operator: opts.operator,
+        vendor: opts.vendor,
+        initialStatus: opts.initial,
+        metadata: _parseJsonV2(opts.metadata),
+      });
+      console.log(JSON.stringify(d, null, 2));
+    });
+
+  tr.command("device-v2 <device-id>")
+    .description("Show V2 device")
+    .action((id) => {
+      const d = getDeviceV2(id);
+      if (!d) return console.error(`device ${id} not found`);
+      console.log(JSON.stringify(d, null, 2));
+    });
+
+  tr.command("list-devices-v2")
+    .description("List V2 devices")
+    .option("-o, --operator <operator>", "filter by operator")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) =>
+      console.log(JSON.stringify(listDevicesV2(opts), null, 2)),
+    );
+
+  tr.command("set-device-maturity-v2 <device-id> <status>")
+    .description("Transition V2 device maturity")
+    .option("-r, --reason <reason>", "transition reason")
+    .option("--metadata <json>", "metadata patch JSON")
+    .action((id, status, opts) => {
+      const d = setDeviceMaturityV2(id, status, {
+        reason: opts.reason,
+        metadata: _parseJsonV2(opts.metadata),
+      });
+      console.log(JSON.stringify(d, null, 2));
+    });
+
+  for (const [name, fn] of [
+    ["activate-device", activateDevice],
+    ["degrade-device", degradeDevice],
+    ["retire-device", retireDevice],
+  ]) {
+    tr.command(`${name} <device-id>`)
+      .description(`Shortcut for ${name.replace("-device", "")} transition`)
+      .option("-r, --reason <reason>", "transition reason")
+      .action((id, opts) => {
+        const d = fn(id, { reason: opts.reason });
+        console.log(JSON.stringify(d, null, 2));
+      });
+  }
+
+  tr.command("touch-device-usage <device-id>")
+    .description("Mark V2 device as used now")
+    .action((id) => {
+      const d = touchDeviceUsage(id);
+      console.log(JSON.stringify(d, null, 2));
+    });
+
+  tr.command("enqueue-transmission-v2 <transmission-id>")
+    .description("Enqueue V2 satellite transmission")
+    .requiredOption("-d, --device <device>", "device id")
+    .requiredOption("-p, --provider <provider>", "satellite provider")
+    .requiredOption("-x, --payload <payload>", "message payload")
+    .option("--metadata <json>", "metadata JSON")
+    .action((id, opts) => {
+      const t = enqueueTransmissionV2({
+        id,
+        deviceId: opts.device,
+        provider: opts.provider,
+        payload: opts.payload,
+        metadata: _parseJsonV2(opts.metadata),
+      });
+      console.log(JSON.stringify(t, null, 2));
+    });
+
+  tr.command("transmission-v2 <transmission-id>")
+    .description("Show V2 transmission")
+    .action((id) => {
+      const t = getTransmissionV2(id);
+      if (!t) return console.error(`transmission ${id} not found`);
+      console.log(JSON.stringify(t, null, 2));
+    });
+
+  tr.command("list-transmissions-v2")
+    .description("List V2 transmissions")
+    .option("-d, --device <device>", "filter by device")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) =>
+      console.log(JSON.stringify(listTransmissionsV2(opts), null, 2)),
+    );
+
+  tr.command("set-transmission-status-v2 <transmission-id> <status>")
+    .option("-r, --reason <reason>", "transition reason")
+    .option("--metadata <json>", "metadata patch JSON")
+    .action((id, status, opts) => {
+      const t = setTransmissionStatusV2(id, status, {
+        reason: opts.reason,
+        metadata: _parseJsonV2(opts.metadata),
+      });
+      console.log(JSON.stringify(t, null, 2));
+    });
+
+  for (const [name, fn] of [
+    ["start-transmission", startTransmission],
+    ["confirm-transmission", confirmTransmission],
+    ["fail-transmission", failTransmission],
+    ["cancel-transmission", cancelTransmission],
+  ]) {
+    tr.command(`${name} <transmission-id>`)
+      .description(
+        `Shortcut for ${name.replace("-transmission", "")} transition`,
+      )
+      .option("-r, --reason <reason>", "transition reason")
+      .action((id, opts) => {
+        const t = fn(id, { reason: opts.reason });
+        console.log(JSON.stringify(t, null, 2));
+      });
+  }
+
+  tr.command("auto-retire-idle-devices")
+    .description(
+      "Bulk-retire ACTIVE/DEGRADED devices whose lastUsedAt is older than deviceIdleMs",
+    )
+    .action(() =>
+      console.log(
+        JSON.stringify({ flipped: autoRetireIdleDevices() }, null, 2),
+      ),
+    );
+
+  tr.command("auto-fail-stuck-transmissions")
+    .description(
+      "Bulk-fail SENDING transmissions whose startedAt is older than transmissionStuckMs",
+    )
+    .action(() =>
+      console.log(
+        JSON.stringify({ flipped: autoFailStuckTransmissions() }, null, 2),
+      ),
+    );
+
+  tr.command("stats-v2")
+    .description("Show V2 trust/security stats")
+    .action(() =>
+      console.log(JSON.stringify(getTrustSecurityStatsV2(), null, 2)),
+    );
+
   program.addCommand(tr);
 }