chainlesschain 0.81.0 → 0.143.0

package/src/commands/compt.js

@@ -0,0 +1,78 @@
+/**
+ * Compression Telemetry V2 governance commands — `cc compt ...`
+ * 在内存中治理 COMPT profile (pending/active/stale/archived) + sample 生命周期。
+ */
+import {
+  COMPT_PROFILE_MATURITY_V2,
+  COMPT_SAMPLE_LIFECYCLE_V2,
+  registerComptProfileV2,
+  activateComptProfileV2,
+  staleComptProfileV2,
+  archiveComptProfileV2,
+  touchComptProfileV2,
+  getComptProfileV2,
+  listComptProfilesV2,
+  createComptSampleV2,
+  recordingComptSampleV2,
+  recordComptSampleV2,
+  failComptSampleV2,
+  cancelComptSampleV2,
+  getComptSampleV2,
+  listComptSamplesV2,
+  setMaxActiveComptProfilesPerOwnerV2,
+  getMaxActiveComptProfilesPerOwnerV2,
+  setMaxPendingComptSamplesPerProfileV2,
+  getMaxPendingComptSamplesPerProfileV2,
+  setComptProfileIdleMsV2,
+  getComptProfileIdleMsV2,
+  setComptSampleStuckMsV2,
+  getComptSampleStuckMsV2,
+  autoStaleIdleComptProfilesV2,
+  autoFailStuckComptSamplesV2,
+  getCompressionTelemetryGovStatsV2,
+} from "../lib/compression-telemetry.js";
+
+export function registerComptCommand(program) {
+  const c = program
+    .command("compt")
+    .description("Compression Telemetry V2 governance (in-memory, CLI v0.143.0)");
+
+  c.command("enums-v2").action(() => console.log(JSON.stringify({ COMPT_PROFILE_MATURITY_V2, COMPT_SAMPLE_LIFECYCLE_V2 }, null, 2)));
+  c.command("register-profile-v2")
+    .requiredOption("--id <id>")
+    .requiredOption("--owner <owner>")
+    .option("--kind <kind>", "telemetry kind", "default")
+    .action((o) => console.log(JSON.stringify(registerComptProfileV2(o), null, 2)));
+  c.command("activate-profile-v2 <id>").action((id) => console.log(JSON.stringify(activateComptProfileV2(id), null, 2)));
+  c.command("stale-profile-v2 <id>").action((id) => console.log(JSON.stringify(staleComptProfileV2(id), null, 2)));
+  c.command("archive-profile-v2 <id>").action((id) => console.log(JSON.stringify(archiveComptProfileV2(id), null, 2)));
+  c.command("touch-profile-v2 <id>").action((id) => console.log(JSON.stringify(touchComptProfileV2(id), null, 2)));
+  c.command("get-profile-v2 <id>").action((id) => console.log(JSON.stringify(getComptProfileV2(id), null, 2)));
+  c.command("list-profiles-v2").action(() => console.log(JSON.stringify(listComptProfilesV2(), null, 2)));
+
+  c.command("create-sample-v2")
+    .requiredOption("--id <id>")
+    .requiredOption("--profile-id <profileId>")
+    .option("--metric <metric>", "metric name", "")
+    .action((o) => console.log(JSON.stringify(createComptSampleV2(o), null, 2)));
+  c.command("recording-sample-v2 <id>").action((id) => console.log(JSON.stringify(recordingComptSampleV2(id), null, 2)));
+  c.command("record-sample-v2 <id>").action((id) => console.log(JSON.stringify(recordComptSampleV2(id), null, 2)));
+  c.command("fail-sample-v2 <id>").option("--reason <r>").action((id, o) => console.log(JSON.stringify(failComptSampleV2(id, o.reason), null, 2)));
+  c.command("cancel-sample-v2 <id>").option("--reason <r>").action((id, o) => console.log(JSON.stringify(cancelComptSampleV2(id, o.reason), null, 2)));
+  c.command("get-sample-v2 <id>").action((id) => console.log(JSON.stringify(getComptSampleV2(id), null, 2)));
+  c.command("list-samples-v2").action(() => console.log(JSON.stringify(listComptSamplesV2(), null, 2)));
+
+  c.command("config-v2").action(() => console.log(JSON.stringify({
+    maxActiveComptProfilesPerOwner: getMaxActiveComptProfilesPerOwnerV2(),
+    maxPendingComptSamplesPerProfile: getMaxPendingComptSamplesPerProfileV2(),
+    comptProfileIdleMs: getComptProfileIdleMsV2(),
+    comptSampleStuckMs: getComptSampleStuckMsV2(),
+  }, null, 2)));
+  c.command("set-max-active-profiles-v2 <n>").action((n) => { setMaxActiveComptProfilesPerOwnerV2(Number(n)); console.log(JSON.stringify({ maxActiveComptProfilesPerOwner: getMaxActiveComptProfilesPerOwnerV2() }, null, 2)); });
+  c.command("set-max-pending-samples-v2 <n>").action((n) => { setMaxPendingComptSamplesPerProfileV2(Number(n)); console.log(JSON.stringify({ maxPendingComptSamplesPerProfile: getMaxPendingComptSamplesPerProfileV2() }, null, 2)); });
+  c.command("set-profile-idle-ms-v2 <ms>").action((ms) => { setComptProfileIdleMsV2(Number(ms)); console.log(JSON.stringify({ comptProfileIdleMs: getComptProfileIdleMsV2() }, null, 2)); });
+  c.command("set-sample-stuck-ms-v2 <ms>").action((ms) => { setComptSampleStuckMsV2(Number(ms)); console.log(JSON.stringify({ comptSampleStuckMs: getComptSampleStuckMsV2() }, null, 2)); });
+  c.command("auto-stale-idle-v2").action(() => console.log(JSON.stringify(autoStaleIdleComptProfilesV2(), null, 2)));
+  c.command("auto-fail-stuck-v2").action(() => console.log(JSON.stringify(autoFailStuckComptSamplesV2(), null, 2)));
+  c.command("gov-stats-v2").action(() => console.log(JSON.stringify(getCompressionTelemetryGovStatsV2(), null, 2)));
+}

package/src/commands/consol.js

@@ -0,0 +1,231 @@
+/**
+ * Session Consolidator V2 governance commands — `cc consol ...`
+ *
+ * V2 surface layered atop session-consolidator.js, independent of
+ * legacy `buildTraceStoreFromJsonl`/`consolidateJsonlSession` helpers.
+ */
+
+import {
+  CONSOL_PROFILE_MATURITY_V2,
+  CONSOL_JOB_LIFECYCLE_V2,
+  registerConsolProfileV2,
+  activateConsolProfileV2,
+  pauseConsolProfileV2,
+  archiveConsolProfileV2,
+  touchConsolProfileV2,
+  getConsolProfileV2,
+  listConsolProfilesV2,
+  createConsolJobV2,
+  startConsolJobV2,
+  completeConsolJobV2,
+  failConsolJobV2,
+  cancelConsolJobV2,
+  getConsolJobV2,
+  listConsolJobsV2,
+  setMaxActiveConsolProfilesPerOwnerV2,
+  getMaxActiveConsolProfilesPerOwnerV2,
+  setMaxPendingConsolJobsPerProfileV2,
+  getMaxPendingConsolJobsPerProfileV2,
+  setConsolProfileIdleMsV2,
+  getConsolProfileIdleMsV2,
+  setConsolJobStuckMsV2,
+  getConsolJobStuckMsV2,
+  autoPauseIdleConsolProfilesV2,
+  autoFailStuckConsolJobsV2,
+  getSessionConsolidatorStatsV2,
+} from "../lib/session-consolidator.js";
+
+export function registerConsolCommand(program) {
+  const consol = program
+    .command("consol")
+    .description(
+      "Session Consolidator V2 governance (in-memory, CLI v0.134.0)",
+    );
+
+  consol
+    .command("enums-v2")
+    .description("Show V2 maturity + lifecycle enums")
+    .action(() => {
+      console.log(
+        JSON.stringify(
+          {
+            CONSOL_PROFILE_MATURITY_V2,
+            CONSOL_JOB_LIFECYCLE_V2,
+          },
+          null,
+          2,
+        ),
+      );
+    });
+
+  consol
+    .command("register-profile-v2")
+    .description("Register a consolidation profile (pending)")
+    .requiredOption("--id <id>")
+    .requiredOption("--owner <owner>")
+    .option("--scope <scope>", "agent|session|global", "agent")
+    .action((o) => {
+      console.log(JSON.stringify(registerConsolProfileV2(o), null, 2));
+    });
+  consol
+    .command("activate-profile-v2 <id>")
+    .description("Transition profile to active")
+    .action((id) => {
+      console.log(JSON.stringify(activateConsolProfileV2(id), null, 2));
+    });
+  consol
+    .command("pause-profile-v2 <id>")
+    .description("Transition profile to paused")
+    .action((id) => {
+      console.log(JSON.stringify(pauseConsolProfileV2(id), null, 2));
+    });
+  consol
+    .command("archive-profile-v2 <id>")
+    .description("Transition profile to archived (terminal)")
+    .action((id) => {
+      console.log(JSON.stringify(archiveConsolProfileV2(id), null, 2));
+    });
+  consol
+    .command("touch-profile-v2 <id>")
+    .description("Refresh lastTouchedAt")
+    .action((id) => {
+      console.log(JSON.stringify(touchConsolProfileV2(id), null, 2));
+    });
+  consol
+    .command("get-profile-v2 <id>")
+    .description("Get a profile by id")
+    .action((id) => {
+      console.log(JSON.stringify(getConsolProfileV2(id), null, 2));
+    });
+  consol
+    .command("list-profiles-v2")
+    .description("List all profiles")
+    .action(() => {
+      console.log(JSON.stringify(listConsolProfilesV2(), null, 2));
+    });
+
+  consol
+    .command("create-job-v2")
+    .description("Create a consolidation job (queued)")
+    .requiredOption("--id <id>")
+    .requiredOption("--profile-id <profileId>")
+    .option("--session-id <sessionId>")
+    .action((o) => {
+      console.log(
+        JSON.stringify(
+          createConsolJobV2({
+            id: o.id,
+            profileId: o.profileId,
+            sessionId: o.sessionId,
+          }),
+          null,
+          2,
+        ),
+      );
+    });
+  consol
+    .command("start-job-v2 <id>")
+    .description("Transition job to running")
+    .action((id) => {
+      console.log(JSON.stringify(startConsolJobV2(id), null, 2));
+    });
+  consol
+    .command("complete-job-v2 <id>")
+    .description("Transition job to completed")
+    .action((id) => {
+      console.log(JSON.stringify(completeConsolJobV2(id), null, 2));
+    });
+  consol
+    .command("fail-job-v2 <id>")
+    .description("Transition job to failed")
+    .option("--reason <reason>")
+    .action((id, o) => {
+      console.log(JSON.stringify(failConsolJobV2(id, o.reason), null, 2));
+    });
+  consol
+    .command("cancel-job-v2 <id>")
+    .description("Transition job to cancelled")
+    .option("--reason <reason>")
+    .action((id, o) => {
+      console.log(JSON.stringify(cancelConsolJobV2(id, o.reason), null, 2));
+    });
+  consol
+    .command("get-job-v2 <id>")
+    .description("Get a job by id")
+    .action((id) => {
+      console.log(JSON.stringify(getConsolJobV2(id), null, 2));
+    });
+  consol
+    .command("list-jobs-v2")
+    .description("List all jobs")
+    .action(() => {
+      console.log(JSON.stringify(listConsolJobsV2(), null, 2));
+    });
+
+  consol
+    .command("set-max-active-profiles-v2 <n>")
+    .description("Set per-owner active profile cap")
+    .action((n) => {
+      setMaxActiveConsolProfilesPerOwnerV2(Number(n));
+      console.log(
+        JSON.stringify(
+          { maxActiveConsolProfilesPerOwner: getMaxActiveConsolProfilesPerOwnerV2() },
+          null,
+          2,
+        ),
+      );
+    });
+  consol
+    .command("set-max-pending-jobs-v2 <n>")
+    .description("Set per-profile pending job cap")
+    .action((n) => {
+      setMaxPendingConsolJobsPerProfileV2(Number(n));
+      console.log(
+        JSON.stringify(
+          { maxPendingConsolJobsPerProfile: getMaxPendingConsolJobsPerProfileV2() },
+          null,
+          2,
+        ),
+      );
+    });
+  consol
+    .command("set-profile-idle-ms-v2 <n>")
+    .description("Set profile idle threshold (ms)")
+    .action((n) => {
+      setConsolProfileIdleMsV2(Number(n));
+      console.log(
+        JSON.stringify(
+          { consolProfileIdleMs: getConsolProfileIdleMsV2() },
+          null,
+          2,
+        ),
+      );
+    });
+  consol
+    .command("set-job-stuck-ms-v2 <n>")
+    .description("Set job stuck threshold (ms)")
+    .action((n) => {
+      setConsolJobStuckMsV2(Number(n));
+      console.log(
+        JSON.stringify({ consolJobStuckMs: getConsolJobStuckMsV2() }, null, 2),
+      );
+    });
+  consol
+    .command("auto-pause-idle-profiles-v2")
+    .description("Auto-pause idle active profiles")
+    .action(() => {
+      console.log(JSON.stringify(autoPauseIdleConsolProfilesV2(), null, 2));
+    });
+  consol
+    .command("auto-fail-stuck-jobs-v2")
+    .description("Auto-fail stuck running jobs")
+    .action(() => {
+      console.log(JSON.stringify(autoFailStuckConsolJobsV2(), null, 2));
+    });
+  consol
+    .command("stats-v2")
+    .description("Show V2 aggregate stats")
+    .action(() => {
+      console.log(JSON.stringify(getSessionConsolidatorStatsV2(), null, 2));
+    });
+}

package/src/commands/cowork.js

@@ -1181,4 +1181,267 @@ export function registerCoworkCommand(program) {
       );
       logger.log("");
     });
+
+  // ===== V2 governance subcommands (agent-coordinator V2) =====
+  cowork
+    .command("coord-agent-maturities-v2")
+    .description("List coord agent maturity states (V2)")
+    .action(async () => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.COORD_AGENT_MATURITY_V2, null, 2));
+    });
+  cowork
+    .command("coord-assignment-lifecycle-v2")
+    .description("List coord assignment lifecycle states (V2)")
+    .action(async () => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.COORD_ASSIGNMENT_LIFECYCLE_V2, null, 2));
+    });
+  cowork
+    .command("coord-stats-v2")
+    .description("Show agent-coordinator V2 stats")
+    .action(async () => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.getAgentCoordinatorStatsV2(), null, 2));
+    });
+  cowork
+    .command("coord-config-v2")
+    .description("Show agent-coordinator V2 config")
+    .action(async () => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(
+        JSON.stringify(
+          {
+            maxActiveAgentsPerOwner: m.getMaxActiveAgentsPerOwnerCoordV2(),
+            maxPendingAssignmentsPerAgent:
+              m.getMaxPendingAssignmentsPerAgentV2(),
+            agentIdleMs: m.getAgentIdleMsCoordV2(),
+            assignmentStuckMs: m.getAssignmentStuckMsV2(),
+          },
+          null,
+          2,
+        ),
+      );
+    });
+  cowork
+    .command("coord-register-agent-v2 <id> <owner>")
+    .description("Register a coord agent (V2)")
+    .action(async (id, owner) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(
+        JSON.stringify(m.registerCoordAgentV2({ id, owner }), null, 2),
+      );
+    });
+  cowork
+    .command("coord-activate-agent-v2 <id>")
+    .description("Activate a coord agent (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.activateCoordAgentV2(id), null, 2));
+    });
+  cowork
+    .command("coord-idle-agent-v2 <id>")
+    .description("Mark coord agent as idle (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.idleCoordAgentV2(id), null, 2));
+    });
+  cowork
+    .command("coord-retire-agent-v2 <id>")
+    .description("Retire a coord agent (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.retireCoordAgentV2(id), null, 2));
+    });
+  cowork
+    .command("coord-touch-agent-v2 <id>")
+    .description("Touch a coord agent (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.touchCoordAgentV2(id), null, 2));
+    });
+  cowork
+    .command("coord-get-agent-v2 <id>")
+    .description("Get a coord agent (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.getCoordAgentV2(id), null, 2));
+    });
+  cowork
+    .command("coord-list-agents-v2")
+    .description("List coord agents (V2)")
+    .action(async () => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.listCoordAgentsV2(), null, 2));
+    });
+  cowork
+    .command("coord-create-assignment-v2 <id> <agentId>")
+    .description("Create a coord assignment (V2)")
+    .action(async (id, agentId) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(
+        JSON.stringify(m.createAssignmentV2({ id, agentId }), null, 2),
+      );
+    });
+  cowork
+    .command("coord-dispatch-assignment-v2 <id>")
+    .description("Dispatch a coord assignment (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.dispatchAssignmentV2(id), null, 2));
+    });
+  cowork
+    .command("coord-complete-assignment-v2 <id>")
+    .description("Complete a coord assignment (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.completeAssignmentV2(id), null, 2));
+    });
+  cowork
+    .command("coord-fail-assignment-v2 <id> [reason]")
+    .description("Fail a coord assignment (V2)")
+    .action(async (id, reason) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.failAssignmentV2(id, reason), null, 2));
+    });
+  cowork
+    .command("coord-cancel-assignment-v2 <id> [reason]")
+    .description("Cancel a coord assignment (V2)")
+    .action(async (id, reason) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.cancelAssignmentV2(id, reason), null, 2));
+    });
+  cowork
+    .command("coord-get-assignment-v2 <id>")
+    .description("Get a coord assignment (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.getAssignmentV2(id), null, 2));
+    });
+  cowork
+    .command("coord-list-assignments-v2")
+    .description("List coord assignments (V2)")
+    .action(async () => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.listAssignmentsV2(), null, 2));
+    });
+  cowork
+    .command("coord-auto-idle-agents-v2")
+    .description("Auto-idle coord agents (V2)")
+    .action(async () => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.autoIdleCoordAgentsV2(), null, 2));
+    });
+  cowork
+    .command("coord-auto-fail-stuck-assignments-v2")
+    .description("Auto-fail stuck coord assignments (V2)")
+    .action(async () => {
+      const m = await import("../lib/agent-coordinator.js");
+      console.log(JSON.stringify(m.autoFailStuckAssignmentsV2(), null, 2));
+    });
+  cowork
+    .command("coord-set-max-active-agents-v2 <n>")
+    .description("Set max active coord agents per owner (V2)")
+    .action(async (n) => {
+      const m = await import("../lib/agent-coordinator.js");
+      m.setMaxActiveAgentsPerOwnerCoordV2(parseInt(n, 10));
+      console.log(
+        JSON.stringify(
+          { maxActiveAgentsPerOwner: m.getMaxActiveAgentsPerOwnerCoordV2() },
+          null,
+          2,
+        ),
+      );
+    });
+  cowork
+    .command("coord-set-max-pending-assignments-v2 <n>")
+    .description("Set max pending coord assignments per agent (V2)")
+    .action(async (n) => {
+      const m = await import("../lib/agent-coordinator.js");
+      m.setMaxPendingAssignmentsPerAgentV2(parseInt(n, 10));
+      console.log(
+        JSON.stringify(
+          {
+            maxPendingAssignmentsPerAgent:
+              m.getMaxPendingAssignmentsPerAgentV2(),
+          },
+          null,
+          2,
+        ),
+      );
+    });
+  cowork
+    .command("coord-set-agent-idle-ms-v2 <n>")
+    .description("Set coord agent idle timeout ms (V2)")
+    .action(async (n) => {
+      const m = await import("../lib/agent-coordinator.js");
+      m.setAgentIdleMsCoordV2(parseInt(n, 10));
+      console.log(
+        JSON.stringify({ agentIdleMs: m.getAgentIdleMsCoordV2() }, null, 2),
+      );
+    });
+  cowork
+    .command("coord-set-assignment-stuck-ms-v2 <n>")
+    .description("Set coord assignment stuck timeout ms (V2)")
+    .action(async (n) => {
+      const m = await import("../lib/agent-coordinator.js");
+      m.setAssignmentStuckMsV2(parseInt(n, 10));
+      console.log(
+        JSON.stringify(
+          { assignmentStuckMs: m.getAssignmentStuckMsV2() },
+          null,
+          2,
+        ),
+      );
+    });
+  cowork
+    .command("coord-reset-state-v2")
+    .description("Reset agent-coordinator V2 in-memory state")
+    .action(async () => {
+      const m = await import("../lib/agent-coordinator.js");
+      m._resetStateAgentCoordinatorV2();
+      console.log(JSON.stringify({ ok: true }, null, 2));
+    });
+
+  _registerCoworkRunnerV2(cowork);
+}
+
+
+import {
+  RUNNER_PROFILE_MATURITY_V2, RUNNER_EXEC_LIFECYCLE_V2,
+  setMaxActiveRunnerProfilesPerOwnerV2, setMaxPendingRunnerExecsPerProfileV2, setRunnerProfileIdleMsV2, setRunnerExecStuckMsV2,
+  registerRunnerProfileV2, activateRunnerProfileV2, pauseRunnerProfileV2, retireRunnerProfileV2, touchRunnerProfileV2, getRunnerProfileV2, listRunnerProfilesV2,
+  createRunnerExecV2, startRunnerExecV2, succeedRunnerExecV2, failRunnerExecV2, cancelRunnerExecV2, getRunnerExecV2, listRunnerExecsV2,
+  autoPauseIdleRunnerProfilesV2, autoFailStuckRunnerExecsV2, getRunnerGovStatsV2,
+} from "../lib/cowork-task-runner.js";
+
+function _registerCoworkRunnerV2(parent) {
+  parent.command("runner-enums-v2").description("List Runner V2 enums").option("--json", "JSON").action((opts) => {
+    const out = { profileMaturity: RUNNER_PROFILE_MATURITY_V2, execLifecycle: RUNNER_EXEC_LIFECYCLE_V2 };
+    if (opts.json) console.log(JSON.stringify(out, null, 2)); else console.log(out);
+  });
+  parent.command("runner-config-set-v2").description("Set Runner V2 caps/thresholds").option("--max-active <n>", "max active per owner").option("--max-pending <n>", "max pending per profile").option("--idle-ms <n>", "profile idle ms").option("--stuck-ms <n>", "exec stuck ms").action((opts) => {
+    if (opts.maxActive) setMaxActiveRunnerProfilesPerOwnerV2(parseInt(opts.maxActive, 10));
+    if (opts.maxPending) setMaxPendingRunnerExecsPerProfileV2(parseInt(opts.maxPending, 10));
+    if (opts.idleMs) setRunnerProfileIdleMsV2(parseInt(opts.idleMs, 10));
+    if (opts.stuckMs) setRunnerExecStuckMsV2(parseInt(opts.stuckMs, 10));
+    console.log("ok");
+  });
+  parent.command("runner-register-profile-v2 <id>").description("Register Runner V2 profile").requiredOption("--owner <owner>", "owner").option("--template <t>", "template").action((id, opts) => { console.log(registerRunnerProfileV2({ id, owner: opts.owner, template: opts.template })); });
+  parent.command("runner-activate-profile-v2 <id>").description("Activate Runner V2 profile").action((id) => { console.log(activateRunnerProfileV2(id)); });
+  parent.command("runner-pause-profile-v2 <id>").description("Pause Runner V2 profile").action((id) => { console.log(pauseRunnerProfileV2(id)); });
+  parent.command("runner-retire-profile-v2 <id>").description("Retire Runner V2 profile").action((id) => { console.log(retireRunnerProfileV2(id)); });
+  parent.command("runner-touch-profile-v2 <id>").description("Touch Runner V2 profile").action((id) => { console.log(touchRunnerProfileV2(id)); });
+  parent.command("runner-get-profile-v2 <id>").description("Get Runner V2 profile").action((id) => { console.log(getRunnerProfileV2(id)); });
+  parent.command("runner-list-profiles-v2").description("List Runner V2 profiles").action(() => { console.log(listRunnerProfilesV2()); });
+  parent.command("runner-create-exec-v2 <id>").description("Create Runner V2 exec").requiredOption("--profile-id <pid>", "profile id").option("--task-input <t>", "task input").action((id, opts) => { console.log(createRunnerExecV2({ id, profileId: opts.profileId, taskInput: opts.taskInput })); });
+  parent.command("runner-start-exec-v2 <id>").description("Start Runner V2 exec").action((id) => { console.log(startRunnerExecV2(id)); });
+  parent.command("runner-succeed-exec-v2 <id>").description("Succeed Runner V2 exec").action((id) => { console.log(succeedRunnerExecV2(id)); });
+  parent.command("runner-fail-exec-v2 <id>").description("Fail Runner V2 exec").option("--reason <r>", "reason").action((id, opts) => { console.log(failRunnerExecV2(id, opts.reason)); });
+  parent.command("runner-cancel-exec-v2 <id>").description("Cancel Runner V2 exec").option("--reason <r>", "reason").action((id, opts) => { console.log(cancelRunnerExecV2(id, opts.reason)); });
+  parent.command("runner-get-exec-v2 <id>").description("Get Runner V2 exec").action((id) => { console.log(getRunnerExecV2(id)); });
+  parent.command("runner-list-execs-v2").description("List Runner V2 execs").action(() => { console.log(listRunnerExecsV2()); });
+  parent.command("runner-auto-pause-profiles-v2").description("Auto-pause idle Runner V2 profiles").action(() => { console.log(autoPauseIdleRunnerProfilesV2()); });
+  parent.command("runner-auto-fail-execs-v2").description("Auto-fail stuck Runner V2 execs").action(() => { console.log(autoFailStuckRunnerExecsV2()); });
+  parent.command("runner-gov-stats-v2").description("Runner V2 governance stats").option("--json", "JSON").action((opts) => { const s = getRunnerGovStatsV2(); if (opts.json) console.log(JSON.stringify(s, null, 2)); else console.log(s); });
 }

package/src/commands/crosschain.js

@@ -597,4 +597,66 @@ export function registerCrossChainCommand(program) {
     });
 
   program.addCommand(cc);
+  registerCrossChainV2Command(cc);
 }
+
+
+import {
+  XCHAIN_CHANNEL_MATURITY_V2,
+  XCHAIN_TRANSFER_LIFECYCLE_V2,
+  registerXchainChannelV2,
+  activateXchainChannelV2,
+  pauseXchainChannelV2,
+  decommissionXchainChannelV2,
+  touchXchainChannelV2,
+  getXchainChannelV2,
+  listXchainChannelsV2,
+  createXchainTransferV2,
+  startXchainTransferV2,
+  confirmXchainTransferV2,
+  failXchainTransferV2,
+  cancelXchainTransferV2,
+  getXchainTransferV2,
+  listXchainTransfersV2,
+  setMaxActiveXchainChannelsPerOwnerV2,
+  getMaxActiveXchainChannelsPerOwnerV2,
+  setMaxPendingXchainTransfersPerChannelV2,
+  getMaxPendingXchainTransfersPerChannelV2,
+  setXchainChannelIdleMsV2,
+  getXchainChannelIdleMsV2,
+  setXchainTransferStuckMsV2,
+  getXchainTransferStuckMsV2,
+  autoPauseIdleXchainChannelsV2,
+  autoFailStuckXchainTransfersV2,
+  getCrossChainGovStatsV2,
+} from "../lib/cross-chain.js";
+
+export function registerCrossChainV2Command(cc) {
+  cc.command("enums-v2").description("Show V2 governance enums").action(() => { console.log(JSON.stringify({ XCHAIN_CHANNEL_MATURITY_V2, XCHAIN_TRANSFER_LIFECYCLE_V2 }, null, 2)); });
+  cc.command("register-channel-v2").description("Register an xchain channel profile (pending)")
+    .requiredOption("--id <id>").requiredOption("--owner <owner>").option("--from-chain <fromChain>").option("--to-chain <toChain>")
+    .action((o) => { console.log(JSON.stringify(registerXchainChannelV2({ id: o.id, owner: o.owner, fromChain: o.fromChain, toChain: o.toChain }), null, 2)); });
+  cc.command("activate-channel-v2 <id>").description("Activate channel").action((id) => { console.log(JSON.stringify(activateXchainChannelV2(id), null, 2)); });
+  cc.command("pause-channel-v2 <id>").description("Pause channel").action((id) => { console.log(JSON.stringify(pauseXchainChannelV2(id), null, 2)); });
+  cc.command("decommission-channel-v2 <id>").description("Decommission channel (terminal)").action((id) => { console.log(JSON.stringify(decommissionXchainChannelV2(id), null, 2)); });
+  cc.command("touch-channel-v2 <id>").description("Refresh lastTouchedAt").action((id) => { console.log(JSON.stringify(touchXchainChannelV2(id), null, 2)); });
+  cc.command("get-channel-v2 <id>").description("Get channel").action((id) => { console.log(JSON.stringify(getXchainChannelV2(id), null, 2)); });
+  cc.command("list-channels-v2").description("List channels").action(() => { console.log(JSON.stringify(listXchainChannelsV2(), null, 2)); });
+  cc.command("create-transfer-v2").description("Create an xchain transfer (queued)")
+    .requiredOption("--id <id>").requiredOption("--channel-id <channelId>").option("--amount <amount>")
+    .action((o) => { console.log(JSON.stringify(createXchainTransferV2({ id: o.id, channelId: o.channelId, amount: o.amount }), null, 2)); });
+  cc.command("start-transfer-v2 <id>").description("Transition transfer to relaying").action((id) => { console.log(JSON.stringify(startXchainTransferV2(id), null, 2)); });
+  cc.command("confirm-transfer-v2 <id>").description("Transition transfer to confirmed").action((id) => { console.log(JSON.stringify(confirmXchainTransferV2(id), null, 2)); });
+  cc.command("fail-transfer-v2 <id>").description("Fail transfer").option("--reason <r>").action((id, o) => { console.log(JSON.stringify(failXchainTransferV2(id, o.reason), null, 2)); });
+  cc.command("cancel-transfer-v2 <id>").description("Cancel transfer").option("--reason <r>").action((id, o) => { console.log(JSON.stringify(cancelXchainTransferV2(id, o.reason), null, 2)); });
+  cc.command("get-transfer-v2 <id>").description("Get transfer").action((id) => { console.log(JSON.stringify(getXchainTransferV2(id), null, 2)); });
+  cc.command("list-transfers-v2").description("List transfers").action(() => { console.log(JSON.stringify(listXchainTransfersV2(), null, 2)); });
+  cc.command("set-max-active-channels-v2 <n>").description("Set per-owner active cap").action((n) => { setMaxActiveXchainChannelsPerOwnerV2(Number(n)); console.log(JSON.stringify({ maxActiveXchainChannelsPerOwner: getMaxActiveXchainChannelsPerOwnerV2() }, null, 2)); });
+  cc.command("set-max-pending-transfers-v2 <n>").description("Set per-channel pending cap").action((n) => { setMaxPendingXchainTransfersPerChannelV2(Number(n)); console.log(JSON.stringify({ maxPendingXchainTransfersPerChannel: getMaxPendingXchainTransfersPerChannelV2() }, null, 2)); });
+  cc.command("set-channel-idle-ms-v2 <n>").description("Set idle threshold").action((n) => { setXchainChannelIdleMsV2(Number(n)); console.log(JSON.stringify({ xchainChannelIdleMs: getXchainChannelIdleMsV2() }, null, 2)); });
+  cc.command("set-transfer-stuck-ms-v2 <n>").description("Set stuck threshold").action((n) => { setXchainTransferStuckMsV2(Number(n)); console.log(JSON.stringify({ xchainTransferStuckMs: getXchainTransferStuckMsV2() }, null, 2)); });
+  cc.command("auto-pause-idle-channels-v2").description("Auto-pause idle channels").action(() => { console.log(JSON.stringify(autoPauseIdleXchainChannelsV2(), null, 2)); });
+  cc.command("auto-fail-stuck-transfers-v2").description("Auto-fail stuck relaying transfers").action(() => { console.log(JSON.stringify(autoFailStuckXchainTransfersV2(), null, 2)); });
+  cc.command("gov-stats-v2").description("V2 governance aggregate stats").action(() => { console.log(JSON.stringify(getCrossChainGovStatsV2(), null, 2)); });
+}
+