chainlesschain 0.81.0 → 0.132.0

package/src/commands/fusion.js

@@ -24,8 +24,49 @@ import {
   detectLanguage,
   getTranslationStats,
   getProtocolFusionStats,
+  BRIDGE_MATURITY_V2,
+  TRANSLATION_RUN_V2,
+  getMaxActiveBridgesPerOperator,
+  setMaxActiveBridgesPerOperator,
+  getMaxRunningTranslationsPerBridge,
+  setMaxRunningTranslationsPerBridge,
+  getBridgeIdleMs,
+  setBridgeIdleMs,
+  getTranslationStuckMs,
+  setTranslationStuckMs,
+  getActiveBridgeCount,
+  getRunningTranslationCount,
+  registerBridgeV2,
+  getBridgeV2,
+  listBridgesV2,
+  setBridgeMaturityV2,
+  activateBridge,
+  degradeBridge,
+  deprecateBridge,
+  retireBridge,
+  touchBridgeUsage,
+  enqueueTranslationV2,
+  getTranslationV2,
+  listTranslationsV2,
+  setTranslationStatusV2,
+  startTranslation,
+  succeedTranslation,
+  failTranslation,
+  cancelTranslation,
+  autoRetireIdleBridges,
+  autoFailStuckRunningTranslations,
+  getProtocolFusionStatsV2,
 } from "../lib/protocol-fusion.js";
 
+function _parseJson(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;
@@ -328,5 +369,222 @@ export function registerFusionCommand(program) {
       );
     });
 
+  /* ── V2 Surface (Phase 72-73) ─────────────────────────── */
+
+  fu.command("bridge-maturities-v2")
+    .description("List BRIDGE_MATURITY_V2 enum values")
+    .action(() => {
+      for (const v of Object.values(BRIDGE_MATURITY_V2)) console.log(`  ${v}`);
+    });
+
+  fu.command("translation-runs-v2")
+    .description("List TRANSLATION_RUN_V2 enum values")
+    .action(() => {
+      for (const v of Object.values(TRANSLATION_RUN_V2)) console.log(`  ${v}`);
+    });
+
+  fu.command("max-active-bridges-per-operator")
+    .description("Get current max-active-bridges-per-operator cap")
+    .action(() => console.log(getMaxActiveBridgesPerOperator()));
+  fu.command("set-max-active-bridges-per-operator <n>")
+    .description("Set max-active-bridges-per-operator cap")
+    .action((n) => console.log(setMaxActiveBridgesPerOperator(Number(n))));
+
+  fu.command("max-running-translations-per-bridge")
+    .description("Get current max-running-translations-per-bridge cap")
+    .action(() => console.log(getMaxRunningTranslationsPerBridge()));
+  fu.command("set-max-running-translations-per-bridge <n>")
+    .description("Set max-running-translations-per-bridge cap")
+    .action((n) => console.log(setMaxRunningTranslationsPerBridge(Number(n))));
+
+  fu.command("bridge-idle-ms")
+    .description("Get current bridge-idle-ms threshold")
+    .action(() => console.log(getBridgeIdleMs()));
+  fu.command("set-bridge-idle-ms <n>")
+    .description("Set bridge-idle-ms threshold")
+    .action((n) => console.log(setBridgeIdleMs(Number(n))));
+
+  fu.command("translation-stuck-ms")
+    .description("Get current translation-stuck-ms threshold")
+    .action(() => console.log(getTranslationStuckMs()));
+  fu.command("set-translation-stuck-ms <n>")
+    .description("Set translation-stuck-ms threshold")
+    .action((n) => console.log(setTranslationStuckMs(Number(n))));
+
+  fu.command("active-bridge-count")
+    .description(
+      "Count non-retired, non-provisional bridges (optionally by operator)",
+    )
+    .option("-o, --operator <operator>", "scope to operator")
+    .action((opts) => console.log(getActiveBridgeCount(opts.operator)));
+
+  fu.command("running-translation-count")
+    .description("Count RUNNING translations (optionally by bridge)")
+    .option("-b, --bridge <bridge>", "scope to bridge")
+    .action((opts) => console.log(getRunningTranslationCount(opts.bridge)));
+
+  fu.command("register-bridge-v2 <bridge-id>")
+    .description("Register V2 bridge (provisional by default)")
+    .requiredOption("-o, --operator <operator>", "operator id")
+    .requiredOption("-s, --source <protocol>", "source protocol")
+    .requiredOption("-t, --target <protocol>", "target protocol")
+    .option(
+      "-i, --initial <status>",
+      "initial status",
+      BRIDGE_MATURITY_V2.PROVISIONAL,
+    )
+    .option("--metadata <json>", "metadata JSON")
+    .action((id, opts) => {
+      const b = registerBridgeV2({
+        id,
+        operator: opts.operator,
+        sourceProtocol: opts.source,
+        targetProtocol: opts.target,
+        initialStatus: opts.initial,
+        metadata: _parseJson(opts.metadata),
+      });
+      console.log(JSON.stringify(b, null, 2));
+    });
+
+  fu.command("bridge-v2 <bridge-id>")
+    .description("Show V2 bridge state")
+    .action((id) => {
+      const b = getBridgeV2(id);
+      if (!b) return console.error(`bridge ${id} not found`);
+      console.log(JSON.stringify(b, null, 2));
+    });
+
+  fu.command("list-bridges-v2")
+    .description("List V2 bridges")
+    .option("-o, --operator <operator>", "filter by operator")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) => {
+      console.log(JSON.stringify(listBridgesV2(opts), null, 2));
+    });
+
+  fu.command("set-bridge-maturity-v2 <bridge-id> <status>")
+    .description("Transition V2 bridge maturity")
+    .option("-r, --reason <reason>", "transition reason")
+    .option("--metadata <json>", "metadata patch JSON")
+    .action((id, status, opts) => {
+      const b = setBridgeMaturityV2(id, status, {
+        reason: opts.reason,
+        metadata: _parseJson(opts.metadata),
+      });
+      console.log(JSON.stringify(b, null, 2));
+    });
+
+  for (const [name, fn] of [
+    ["activate-bridge", activateBridge],
+    ["degrade-bridge", degradeBridge],
+    ["deprecate-bridge", deprecateBridge],
+    ["retire-bridge", retireBridge],
+  ]) {
+    fu.command(`${name} <bridge-id>`)
+      .description(`Shortcut for ${name.replace("-bridge", "")} transition`)
+      .option("-r, --reason <reason>", "transition reason")
+      .action((id, opts) => {
+        const b = fn(id, { reason: opts.reason });
+        console.log(JSON.stringify(b, null, 2));
+      });
+  }
+
+  fu.command("touch-bridge-usage <bridge-id>")
+    .description("Mark V2 bridge as used now (for idle auto-retire)")
+    .action((id) => {
+      const b = touchBridgeUsage(id);
+      console.log(JSON.stringify(b, null, 2));
+    });
+
+  fu.command("enqueue-translation-v2 <translation-id>")
+    .description("Enqueue a V2 translation run")
+    .requiredOption("-b, --bridge <bridge>", "bridge id")
+    .requiredOption("-t, --target <lang>", "target language")
+    .requiredOption("-x, --text <text>", "text to translate")
+    .option("-s, --source <lang>", "source language", "auto")
+    .option("--metadata <json>", "metadata JSON")
+    .action((id, opts) => {
+      const t = enqueueTranslationV2({
+        id,
+        bridgeId: opts.bridge,
+        targetLang: opts.target,
+        text: opts.text,
+        sourceLang: opts.source,
+        metadata: _parseJson(opts.metadata),
+      });
+      console.log(JSON.stringify(t, null, 2));
+    });
+
+  fu.command("translation-v2 <translation-id>")
+    .description("Show V2 translation state")
+    .action((id) => {
+      const t = getTranslationV2(id);
+      if (!t) return console.error(`translation ${id} not found`);
+      console.log(JSON.stringify(t, null, 2));
+    });
+
+  fu.command("list-translations-v2")
+    .description("List V2 translations")
+    .option("-b, --bridge <bridge>", "filter by bridge")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) => {
+      console.log(JSON.stringify(listTranslationsV2(opts), null, 2));
+    });
+
+  fu.command("set-translation-status-v2 <translation-id> <status>")
+    .description("Transition V2 translation status")
+    .option("-r, --reason <reason>", "transition reason")
+    .option("--metadata <json>", "metadata patch JSON")
+    .option("--result <json>", "result JSON (on success)")
+    .action((id, status, opts) => {
+      const t = setTranslationStatusV2(id, status, {
+        reason: opts.reason,
+        metadata: _parseJson(opts.metadata),
+        result: _parseJson(opts.result),
+      });
+      console.log(JSON.stringify(t, null, 2));
+    });
+
+  for (const [name, fn] of [
+    ["start-translation", startTranslation],
+    ["succeed-translation", succeedTranslation],
+    ["fail-translation", failTranslation],
+    ["cancel-translation", cancelTranslation],
+  ]) {
+    fu.command(`${name} <translation-id>`)
+      .description(
+        `Shortcut for ${name.replace("-translation", "")} transition`,
+      )
+      .option("-r, --reason <reason>", "transition reason")
+      .action((id, opts) => {
+        const t = fn(id, { reason: opts.reason });
+        console.log(JSON.stringify(t, null, 2));
+      });
+  }
+
+  fu.command("auto-retire-idle-bridges")
+    .description(
+      "Bulk-retire ACTIVE/DEGRADED/DEPRECATED bridges whose lastUsedAt is older than bridgeIdleMs",
+    )
+    .action(() => {
+      const flipped = autoRetireIdleBridges();
+      console.log(JSON.stringify({ flipped }, null, 2));
+    });
+
+  fu.command("auto-fail-stuck-running-translations")
+    .description(
+      "Bulk-fail RUNNING translations whose startedAt is older than translationStuckMs",
+    )
+    .action(() => {
+      const flipped = autoFailStuckRunningTranslations();
+      console.log(JSON.stringify({ flipped }, null, 2));
+    });
+
+  fu.command("stats-v2")
+    .description("Show V2 stats with all-enum zero-initialized counters")
+    .action(() => {
+      console.log(JSON.stringify(getProtocolFusionStatsV2(), null, 2));
+    });
+
   program.addCommand(fu);
 }

package/src/commands/governance.js

@@ -25,6 +25,38 @@ import {
   analyzeImpact,
   predictVote,
   getGovernanceStats,
+  PROPOSER_MATURITY_V2,
+  DELEGATION_LIFECYCLE_V2,
+  getDefaultMaxActiveProposersPerRealmV2,
+  getMaxActiveProposersPerRealmV2,
+  setMaxActiveProposersPerRealmV2,
+  getDefaultMaxActiveDelegationsPerDelegatorV2,
+  getMaxActiveDelegationsPerDelegatorV2,
+  setMaxActiveDelegationsPerDelegatorV2,
+  getDefaultProposerIdleMsV2,
+  getProposerIdleMsV2,
+  setProposerIdleMsV2,
+  getDefaultPendingDelegationMsV2,
+  getPendingDelegationMsV2,
+  setPendingDelegationMsV2,
+  registerProposerV2,
+  getProposerV2,
+  setProposerMaturityV2,
+  activateProposer,
+  suspendProposer,
+  retireProposer,
+  touchProposerActivity,
+  createDelegationV2,
+  getDelegationV2,
+  setDelegationStatusV2,
+  activateDelegation,
+  revokeDelegation,
+  expireDelegation,
+  getActiveProposerCount,
+  getActiveDelegationCount,
+  autoRetireIdleProposers,
+  autoExpireStalePendingDelegations,
+  getGovernanceStatsV2,
 } from "../lib/community-governance.js";
 
 function _dbFromCtx(ctx) {
@@ -502,4 +534,297 @@ export function registerGovernanceCommand(program) {
         process.exit(1);
       }
     });
+
+  /* ═════════════════════════════════════════════════════════════
+   * Phase 54 V2 — Proposer + Delegation V2 subcommands (in-memory,
+   * no DB bootstrap needed)
+   * ═══════════════════════════════════════════════════════════ */
+
+  gov
+    .command("proposer-maturities-v2")
+    .description("List proposer V2 maturity states")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const s = Object.values(PROPOSER_MATURITY_V2);
+      if (opts.json) console.log(JSON.stringify(s));
+      else s.forEach((v) => console.log(v));
+    });
+
+  gov
+    .command("delegation-lifecycles-v2")
+    .description("List delegation V2 lifecycle states")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const s = Object.values(DELEGATION_LIFECYCLE_V2);
+      if (opts.json) console.log(JSON.stringify(s));
+      else s.forEach((v) => console.log(v));
+    });
+
+  gov
+    .command("default-max-active-proposers-per-realm")
+    .description("Default per-realm active proposer cap")
+    .action(() => console.log(getDefaultMaxActiveProposersPerRealmV2()));
+
+  gov
+    .command("max-active-proposers-per-realm")
+    .description("Current per-realm active proposer cap")
+    .action(() => console.log(getMaxActiveProposersPerRealmV2()));
+
+  gov
+    .command("set-max-active-proposers-per-realm <n>")
+    .description("Set per-realm active proposer cap")
+    .action((n) => console.log(setMaxActiveProposersPerRealmV2(Number(n))));
+
+  gov
+    .command("default-max-active-delegations-per-delegator")
+    .description("Default per-delegator active delegation cap")
+    .action(() => console.log(getDefaultMaxActiveDelegationsPerDelegatorV2()));
+
+  gov
+    .command("max-active-delegations-per-delegator")
+    .description("Current per-delegator active delegation cap")
+    .action(() => console.log(getMaxActiveDelegationsPerDelegatorV2()));
+
+  gov
+    .command("set-max-active-delegations-per-delegator <n>")
+    .description("Set per-delegator active delegation cap")
+    .action((n) =>
+      console.log(setMaxActiveDelegationsPerDelegatorV2(Number(n))),
+    );
+
+  gov
+    .command("default-proposer-idle-ms")
+    .description("Default proposer idle window (ms)")
+    .action(() => console.log(getDefaultProposerIdleMsV2()));
+
+  gov
+    .command("proposer-idle-ms")
+    .description("Current proposer idle window (ms)")
+    .action(() => console.log(getProposerIdleMsV2()));
+
+  gov
+    .command("set-proposer-idle-ms <ms>")
+    .description("Set proposer idle window (ms)")
+    .action((ms) => console.log(setProposerIdleMsV2(Number(ms))));
+
+  gov
+    .command("default-pending-delegation-ms")
+    .description("Default pending delegation window (ms)")
+    .action(() => console.log(getDefaultPendingDelegationMsV2()));
+
+  gov
+    .command("pending-delegation-ms")
+    .description("Current pending delegation window (ms)")
+    .action(() => console.log(getPendingDelegationMsV2()));
+
+  gov
+    .command("set-pending-delegation-ms <ms>")
+    .description("Set pending delegation window (ms)")
+    .action((ms) => console.log(setPendingDelegationMsV2(Number(ms))));
+
+  gov
+    .command("active-proposer-count")
+    .description("Count active V2 proposers (scope by realm)")
+    .option("-r, --realm <realm>", "Realm scope")
+    .action((opts) => console.log(getActiveProposerCount(opts.realm)));
+
+  gov
+    .command("active-delegation-count")
+    .description("Count active V2 delegations (scope by delegator)")
+    .option("-d, --delegator <id>", "Delegator scope")
+    .action((opts) => console.log(getActiveDelegationCount(opts.delegator)));
+
+  gov
+    .command("register-proposer-v2 <proposer-id>")
+    .description("Register a V2 proposer")
+    .requiredOption("-r, --realm <realm>", "Realm")
+    .option("-n, --display-name <name>", "Display name")
+    .option(
+      "-i, --initial-status <status>",
+      "Initial status (default onboarding)",
+    )
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .action((proposerId, opts) => {
+      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);
+      console.log(JSON.stringify(registerProposerV2(null, config), null, 2));
+    });
+
+  gov
+    .command("proposer-v2 <proposer-id>")
+    .description("Get V2 proposer record")
+    .action((proposerId) => {
+      console.log(JSON.stringify(getProposerV2(proposerId), null, 2));
+    });
+
+  gov
+    .command("set-proposer-maturity-v2 <proposer-id> <status>")
+    .description("Set proposer V2 maturity status")
+    .option("-r, --reason <reason>", "Reason")
+    .option("-m, --metadata <json>", "Metadata JSON patch")
+    .action((proposerId, status, opts) => {
+      const patch = {};
+      if (opts.reason !== undefined) patch.reason = opts.reason;
+      if (opts.metadata) patch.metadata = JSON.parse(opts.metadata);
+      console.log(
+        JSON.stringify(
+          setProposerMaturityV2(null, proposerId, status, patch),
+          null,
+          2,
+        ),
+      );
+    });
+
+  gov
+    .command("activate-proposer <proposer-id>")
+    .description("Activate V2 proposer")
+    .option("-r, --reason <reason>", "Reason")
+    .action((proposerId, opts) => {
+      console.log(
+        JSON.stringify(
+          activateProposer(null, proposerId, opts.reason),
+          null,
+          2,
+        ),
+      );
+    });
+
+  gov
+    .command("suspend-proposer <proposer-id>")
+    .description("Suspend V2 proposer")
+    .option("-r, --reason <reason>", "Reason")
+    .action((proposerId, opts) => {
+      console.log(
+        JSON.stringify(suspendProposer(null, proposerId, opts.reason), null, 2),
+      );
+    });
+
+  gov
+    .command("retire-proposer <proposer-id>")
+    .description("Retire V2 proposer (terminal)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((proposerId, opts) => {
+      console.log(
+        JSON.stringify(retireProposer(null, proposerId, opts.reason), null, 2),
+      );
+    });
+
+  gov
+    .command("touch-proposer-activity <proposer-id>")
+    .description("Touch V2 proposer lastActivityAt")
+    .action((proposerId) => {
+      console.log(JSON.stringify(touchProposerActivity(proposerId), null, 2));
+    });
+
+  gov
+    .command("create-delegation-v2 <delegation-id>")
+    .description("Create V2 vote delegation")
+    .requiredOption("-d, --delegator <id>", "Delegator ID")
+    .requiredOption("-t, --delegatee <id>", "Delegatee ID")
+    .requiredOption("-s, --scope <scope>", "Scope")
+    .option("-e, --expires-at <ms>", "Expires-at epoch ms")
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .action((delegationId, opts) => {
+      const config = {
+        delegationId,
+        delegatorId: opts.delegator,
+        delegateeId: opts.delegatee,
+        scope: opts.scope,
+      };
+      if (opts.expiresAt) config.expiresAt = Number(opts.expiresAt);
+      if (opts.metadata) config.metadata = JSON.parse(opts.metadata);
+      console.log(JSON.stringify(createDelegationV2(null, config), null, 2));
+    });
+
+  gov
+    .command("delegation-v2 <delegation-id>")
+    .description("Get V2 delegation record")
+    .action((delegationId) => {
+      console.log(JSON.stringify(getDelegationV2(delegationId), null, 2));
+    });
+
+  gov
+    .command("set-delegation-status-v2 <delegation-id> <status>")
+    .description("Set delegation V2 status")
+    .option("-r, --reason <reason>", "Reason")
+    .option("-m, --metadata <json>", "Metadata JSON patch")
+    .action((delegationId, status, opts) => {
+      const patch = {};
+      if (opts.reason !== undefined) patch.reason = opts.reason;
+      if (opts.metadata) patch.metadata = JSON.parse(opts.metadata);
+      console.log(
+        JSON.stringify(
+          setDelegationStatusV2(null, delegationId, status, patch),
+          null,
+          2,
+        ),
+      );
+    });
+
+  gov
+    .command("activate-delegation <delegation-id>")
+    .description("Activate V2 delegation")
+    .option("-r, --reason <reason>", "Reason")
+    .action((delegationId, opts) => {
+      console.log(
+        JSON.stringify(
+          activateDelegation(null, delegationId, opts.reason),
+          null,
+          2,
+        ),
+      );
+    });
+
+  gov
+    .command("revoke-delegation <delegation-id>")
+    .description("Revoke V2 delegation (terminal)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((delegationId, opts) => {
+      console.log(
+        JSON.stringify(
+          revokeDelegation(null, delegationId, opts.reason),
+          null,
+          2,
+        ),
+      );
+    });
+
+  gov
+    .command("expire-delegation <delegation-id>")
+    .description("Expire V2 delegation (terminal)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((delegationId, opts) => {
+      console.log(
+        JSON.stringify(
+          expireDelegation(null, delegationId, opts.reason),
+          null,
+          2,
+        ),
+      );
+    });
+
+  gov
+    .command("auto-retire-idle-proposers")
+    .description("Auto-retire active/suspended proposers past idle window")
+    .action(() => {
+      console.log(JSON.stringify(autoRetireIdleProposers(null), null, 2));
+    });
+
+  gov
+    .command("auto-expire-stale-pending-delegations")
+    .description("Auto-expire pending delegations past window")
+    .action(() => {
+      console.log(
+        JSON.stringify(autoExpireStalePendingDelegations(null), null, 2),
+      );
+    });
+
+  gov
+    .command("stats-v2")
+    .description("V2 governance statistics")
+    .action(() => {
+      console.log(JSON.stringify(getGovernanceStatsV2(), null, 2));
+    });
 }