chainlesschain 0.81.0 → 0.143.0

package/src/commands/bm25.js

@@ -0,0 +1,78 @@
+/**
+ * BM25 Search V2 governance commands — `cc bm25 ...`
+ * 在内存中治理 BM25 profile (pending/active/stale/archived) + query 生命周期。
+ */
+import {
+  BM25_PROFILE_MATURITY_V2,
+  BM25_QUERY_LIFECYCLE_V2,
+  registerBm25ProfileV2,
+  activateBm25ProfileV2,
+  staleBm25ProfileV2,
+  archiveBm25ProfileV2,
+  touchBm25ProfileV2,
+  getBm25ProfileV2,
+  listBm25ProfilesV2,
+  createBm25QueryV2,
+  searchingBm25QueryV2,
+  completeBm25QueryV2,
+  failBm25QueryV2,
+  cancelBm25QueryV2,
+  getBm25QueryV2,
+  listBm25QueriesV2,
+  setMaxActiveBm25ProfilesPerOwnerV2,
+  getMaxActiveBm25ProfilesPerOwnerV2,
+  setMaxPendingBm25QueriesPerProfileV2,
+  getMaxPendingBm25QueriesPerProfileV2,
+  setBm25ProfileIdleMsV2,
+  getBm25ProfileIdleMsV2,
+  setBm25QueryStuckMsV2,
+  getBm25QueryStuckMsV2,
+  autoStaleIdleBm25ProfilesV2,
+  autoFailStuckBm25QueriesV2,
+  getBm25SearchGovStatsV2,
+} from "../lib/bm25-search.js";
+
+export function registerBm25Command(program) {
+  const b = program
+    .command("bm25")
+    .description("BM25 Search V2 governance (in-memory, CLI v0.143.0)");
+
+  b.command("enums-v2").action(() => console.log(JSON.stringify({ BM25_PROFILE_MATURITY_V2, BM25_QUERY_LIFECYCLE_V2 }, null, 2)));
+  b.command("register-profile-v2")
+    .requiredOption("--id <id>")
+    .requiredOption("--owner <owner>")
+    .option("--field <field>", "indexed field", "content")
+    .action((o) => console.log(JSON.stringify(registerBm25ProfileV2(o), null, 2)));
+  b.command("activate-profile-v2 <id>").action((id) => console.log(JSON.stringify(activateBm25ProfileV2(id), null, 2)));
+  b.command("stale-profile-v2 <id>").action((id) => console.log(JSON.stringify(staleBm25ProfileV2(id), null, 2)));
+  b.command("archive-profile-v2 <id>").action((id) => console.log(JSON.stringify(archiveBm25ProfileV2(id), null, 2)));
+  b.command("touch-profile-v2 <id>").action((id) => console.log(JSON.stringify(touchBm25ProfileV2(id), null, 2)));
+  b.command("get-profile-v2 <id>").action((id) => console.log(JSON.stringify(getBm25ProfileV2(id), null, 2)));
+  b.command("list-profiles-v2").action(() => console.log(JSON.stringify(listBm25ProfilesV2(), null, 2)));
+
+  b.command("create-query-v2")
+    .requiredOption("--id <id>")
+    .requiredOption("--profile-id <profileId>")
+    .option("--q <q>", "query text", "")
+    .action((o) => console.log(JSON.stringify(createBm25QueryV2(o), null, 2)));
+  b.command("searching-query-v2 <id>").action((id) => console.log(JSON.stringify(searchingBm25QueryV2(id), null, 2)));
+  b.command("complete-query-v2 <id>").action((id) => console.log(JSON.stringify(completeBm25QueryV2(id), null, 2)));
+  b.command("fail-query-v2 <id>").option("--reason <r>").action((id, o) => console.log(JSON.stringify(failBm25QueryV2(id, o.reason), null, 2)));
+  b.command("cancel-query-v2 <id>").option("--reason <r>").action((id, o) => console.log(JSON.stringify(cancelBm25QueryV2(id, o.reason), null, 2)));
+  b.command("get-query-v2 <id>").action((id) => console.log(JSON.stringify(getBm25QueryV2(id), null, 2)));
+  b.command("list-queries-v2").action(() => console.log(JSON.stringify(listBm25QueriesV2(), null, 2)));
+
+  b.command("config-v2").action(() => console.log(JSON.stringify({
+    maxActiveBm25ProfilesPerOwner: getMaxActiveBm25ProfilesPerOwnerV2(),
+    maxPendingBm25QueriesPerProfile: getMaxPendingBm25QueriesPerProfileV2(),
+    bm25ProfileIdleMs: getBm25ProfileIdleMsV2(),
+    bm25QueryStuckMs: getBm25QueryStuckMsV2(),
+  }, null, 2)));
+  b.command("set-max-active-profiles-v2 <n>").action((n) => { setMaxActiveBm25ProfilesPerOwnerV2(Number(n)); console.log(JSON.stringify({ maxActiveBm25ProfilesPerOwner: getMaxActiveBm25ProfilesPerOwnerV2() }, null, 2)); });
+  b.command("set-max-pending-queries-v2 <n>").action((n) => { setMaxPendingBm25QueriesPerProfileV2(Number(n)); console.log(JSON.stringify({ maxPendingBm25QueriesPerProfile: getMaxPendingBm25QueriesPerProfileV2() }, null, 2)); });
+  b.command("set-profile-idle-ms-v2 <ms>").action((ms) => { setBm25ProfileIdleMsV2(Number(ms)); console.log(JSON.stringify({ bm25ProfileIdleMs: getBm25ProfileIdleMsV2() }, null, 2)); });
+  b.command("set-query-stuck-ms-v2 <ms>").action((ms) => { setBm25QueryStuckMsV2(Number(ms)); console.log(JSON.stringify({ bm25QueryStuckMs: getBm25QueryStuckMsV2() }, null, 2)); });
+  b.command("auto-stale-idle-v2").action(() => console.log(JSON.stringify(autoStaleIdleBm25ProfilesV2(), null, 2)));
+  b.command("auto-fail-stuck-v2").action(() => console.log(JSON.stringify(autoFailStuckBm25QueriesV2(), null, 2)));
+  b.command("gov-stats-v2").action(() => console.log(JSON.stringify(getBm25SearchGovStatsV2(), null, 2)));
+}

package/src/commands/browse.js

@@ -181,4 +181,68 @@ export function registerBrowseCommand(program) {
         process.exit(1);
       }
     });
+
+  registerBrowseV2Command(browse);
+}
+
+
+import {
+  BROWSE_TARGET_MATURITY_V2,
+  BROWSE_ACTION_LIFECYCLE_V2,
+  registerBrowseTargetV2,
+  activateBrowseTargetV2,
+  degradeBrowseTargetV2,
+  retireBrowseTargetV2,
+  touchBrowseTargetV2,
+  getBrowseTargetV2,
+  listBrowseTargetsV2,
+  createBrowseActionV2,
+  startBrowseActionV2,
+  completeBrowseActionV2,
+  failBrowseActionV2,
+  cancelBrowseActionV2,
+  getBrowseActionV2,
+  listBrowseActionsV2,
+  setMaxActiveBrowseTargetsPerOwnerV2,
+  getMaxActiveBrowseTargetsPerOwnerV2,
+  setMaxPendingBrowseActionsPerTargetV2,
+  getMaxPendingBrowseActionsPerTargetV2,
+  setBrowseTargetIdleMsV2,
+  getBrowseTargetIdleMsV2,
+  setBrowseActionStuckMsV2,
+  getBrowseActionStuckMsV2,
+  autoDegradeIdleBrowseTargetsV2,
+  autoFailStuckBrowseActionsV2,
+  getBrowserAutomationStatsV2,
+} from "../lib/browser-automation.js";
+
+export function registerBrowseV2Command(browse) {
+  browse.command("enums-v2").description("Show V2 enums").action(() => {
+    console.log(JSON.stringify({ BROWSE_TARGET_MATURITY_V2, BROWSE_ACTION_LIFECYCLE_V2 }, null, 2));
+  });
+  browse.command("register-target-v2").description("Register a browse target (pending)")
+    .requiredOption("--id <id>").requiredOption("--owner <owner>").option("--url <url>")
+    .action((o) => { console.log(JSON.stringify(registerBrowseTargetV2(o), null, 2)); });
+  browse.command("activate-target-v2 <id>").description("Activate target").action((id) => { console.log(JSON.stringify(activateBrowseTargetV2(id), null, 2)); });
+  browse.command("degrade-target-v2 <id>").description("Degrade target").action((id) => { console.log(JSON.stringify(degradeBrowseTargetV2(id), null, 2)); });
+  browse.command("retire-target-v2 <id>").description("Retire target (terminal)").action((id) => { console.log(JSON.stringify(retireBrowseTargetV2(id), null, 2)); });
+  browse.command("touch-target-v2 <id>").description("Refresh lastTouchedAt").action((id) => { console.log(JSON.stringify(touchBrowseTargetV2(id), null, 2)); });
+  browse.command("get-target-v2 <id>").description("Get a target").action((id) => { console.log(JSON.stringify(getBrowseTargetV2(id), null, 2)); });
+  browse.command("list-targets-v2").description("List targets").action(() => { console.log(JSON.stringify(listBrowseTargetsV2(), null, 2)); });
+  browse.command("create-action-v2").description("Create a browse action (queued)")
+    .requiredOption("--id <id>").requiredOption("--target-id <targetId>").option("--kind <kind>", "fetch/scrape/screenshot", "fetch")
+    .action((o) => { console.log(JSON.stringify(createBrowseActionV2({ id: o.id, targetId: o.targetId, kind: o.kind }), null, 2)); });
+  browse.command("start-action-v2 <id>").description("Start action").action((id) => { console.log(JSON.stringify(startBrowseActionV2(id), null, 2)); });
+  browse.command("complete-action-v2 <id>").description("Complete action").action((id) => { console.log(JSON.stringify(completeBrowseActionV2(id), null, 2)); });
+  browse.command("fail-action-v2 <id>").description("Fail action").option("--reason <r>").action((id, o) => { console.log(JSON.stringify(failBrowseActionV2(id, o.reason), null, 2)); });
+  browse.command("cancel-action-v2 <id>").description("Cancel action").option("--reason <r>").action((id, o) => { console.log(JSON.stringify(cancelBrowseActionV2(id, o.reason), null, 2)); });
+  browse.command("get-action-v2 <id>").description("Get action").action((id) => { console.log(JSON.stringify(getBrowseActionV2(id), null, 2)); });
+  browse.command("list-actions-v2").description("List actions").action(() => { console.log(JSON.stringify(listBrowseActionsV2(), null, 2)); });
+  browse.command("set-max-active-targets-v2 <n>").description("Set per-owner active cap").action((n) => { setMaxActiveBrowseTargetsPerOwnerV2(Number(n)); console.log(JSON.stringify({ maxActiveBrowseTargetsPerOwner: getMaxActiveBrowseTargetsPerOwnerV2() }, null, 2)); });
+  browse.command("set-max-pending-actions-v2 <n>").description("Set per-target pending cap").action((n) => { setMaxPendingBrowseActionsPerTargetV2(Number(n)); console.log(JSON.stringify({ maxPendingBrowseActionsPerTarget: getMaxPendingBrowseActionsPerTargetV2() }, null, 2)); });
+  browse.command("set-target-idle-ms-v2 <n>").description("Set idle threshold").action((n) => { setBrowseTargetIdleMsV2(Number(n)); console.log(JSON.stringify({ browseTargetIdleMs: getBrowseTargetIdleMsV2() }, null, 2)); });
+  browse.command("set-action-stuck-ms-v2 <n>").description("Set stuck threshold").action((n) => { setBrowseActionStuckMsV2(Number(n)); console.log(JSON.stringify({ browseActionStuckMs: getBrowseActionStuckMsV2() }, null, 2)); });
+  browse.command("auto-degrade-idle-targets-v2").description("Auto-degrade idle targets").action(() => { console.log(JSON.stringify(autoDegradeIdleBrowseTargetsV2(), null, 2)); });
+  browse.command("auto-fail-stuck-actions-v2").description("Auto-fail stuck actions").action(() => { console.log(JSON.stringify(autoFailStuckBrowseActionsV2(), null, 2)); });
+  browse.command("stats-v2").description("V2 aggregate stats").action(() => { console.log(JSON.stringify(getBrowserAutomationStatsV2(), null, 2)); });
 }

package/src/commands/ccron.js

@@ -0,0 +1,78 @@
+/**
+ * Cowork Cron V2 governance commands — `cc ccron ...`
+ * 在内存中治理 CCRON profile (pending/active/paused/archived) + tick 生命周期。
+ */
+import {
+  CCRON_PROFILE_MATURITY_V2,
+  CCRON_TICK_LIFECYCLE_V2,
+  registerCcronProfileV2,
+  activateCcronProfileV2,
+  pauseCcronProfileV2,
+  archiveCcronProfileV2,
+  touchCcronProfileV2,
+  getCcronProfileV2,
+  listCcronProfilesV2,
+  createCcronTickV2,
+  runningCcronTickV2,
+  completeCcronTickV2,
+  failCcronTickV2,
+  cancelCcronTickV2,
+  getCcronTickV2,
+  listCcronTicksV2,
+  setMaxActiveCcronProfilesPerOwnerV2,
+  getMaxActiveCcronProfilesPerOwnerV2,
+  setMaxPendingCcronTicksPerProfileV2,
+  getMaxPendingCcronTicksPerProfileV2,
+  setCcronProfileIdleMsV2,
+  getCcronProfileIdleMsV2,
+  setCcronTickStuckMsV2,
+  getCcronTickStuckMsV2,
+  autoPauseIdleCcronProfilesV2,
+  autoFailStuckCcronTicksV2,
+  getCoworkCronGovStatsV2,
+} from "../lib/cowork-cron.js";
+
+export function registerCcronCommand(program) {
+  const c = program
+    .command("ccron")
+    .description("Cowork Cron V2 governance (in-memory, CLI v0.143.0)");
+
+  c.command("enums-v2").action(() => console.log(JSON.stringify({ CCRON_PROFILE_MATURITY_V2, CCRON_TICK_LIFECYCLE_V2 }, null, 2)));
+  c.command("register-profile-v2")
+    .requiredOption("--id <id>")
+    .requiredOption("--owner <owner>")
+    .option("--expr <expr>", "cron expression", "0 0 * * *")
+    .action((o) => console.log(JSON.stringify(registerCcronProfileV2(o), null, 2)));
+  c.command("activate-profile-v2 <id>").action((id) => console.log(JSON.stringify(activateCcronProfileV2(id), null, 2)));
+  c.command("pause-profile-v2 <id>").action((id) => console.log(JSON.stringify(pauseCcronProfileV2(id), null, 2)));
+  c.command("archive-profile-v2 <id>").action((id) => console.log(JSON.stringify(archiveCcronProfileV2(id), null, 2)));
+  c.command("touch-profile-v2 <id>").action((id) => console.log(JSON.stringify(touchCcronProfileV2(id), null, 2)));
+  c.command("get-profile-v2 <id>").action((id) => console.log(JSON.stringify(getCcronProfileV2(id), null, 2)));
+  c.command("list-profiles-v2").action(() => console.log(JSON.stringify(listCcronProfilesV2(), null, 2)));
+
+  c.command("create-tick-v2")
+    .requiredOption("--id <id>")
+    .requiredOption("--profile-id <profileId>")
+    .option("--tick-at <ts>", "tick timestamp", "")
+    .action((o) => console.log(JSON.stringify(createCcronTickV2({ id: o.id, profileId: o.profileId, tickAt: o.tickAt }), null, 2)));
+  c.command("running-tick-v2 <id>").action((id) => console.log(JSON.stringify(runningCcronTickV2(id), null, 2)));
+  c.command("complete-tick-v2 <id>").action((id) => console.log(JSON.stringify(completeCcronTickV2(id), null, 2)));
+  c.command("fail-tick-v2 <id>").option("--reason <r>").action((id, o) => console.log(JSON.stringify(failCcronTickV2(id, o.reason), null, 2)));
+  c.command("cancel-tick-v2 <id>").option("--reason <r>").action((id, o) => console.log(JSON.stringify(cancelCcronTickV2(id, o.reason), null, 2)));
+  c.command("get-tick-v2 <id>").action((id) => console.log(JSON.stringify(getCcronTickV2(id), null, 2)));
+  c.command("list-ticks-v2").action(() => console.log(JSON.stringify(listCcronTicksV2(), null, 2)));
+
+  c.command("config-v2").action(() => console.log(JSON.stringify({
+    maxActiveCcronProfilesPerOwner: getMaxActiveCcronProfilesPerOwnerV2(),
+    maxPendingCcronTicksPerProfile: getMaxPendingCcronTicksPerProfileV2(),
+    ccronProfileIdleMs: getCcronProfileIdleMsV2(),
+    ccronTickStuckMs: getCcronTickStuckMsV2(),
+  }, null, 2)));
+  c.command("set-max-active-profiles-v2 <n>").action((n) => { setMaxActiveCcronProfilesPerOwnerV2(Number(n)); console.log(JSON.stringify({ maxActiveCcronProfilesPerOwner: getMaxActiveCcronProfilesPerOwnerV2() }, null, 2)); });
+  c.command("set-max-pending-ticks-v2 <n>").action((n) => { setMaxPendingCcronTicksPerProfileV2(Number(n)); console.log(JSON.stringify({ maxPendingCcronTicksPerProfile: getMaxPendingCcronTicksPerProfileV2() }, null, 2)); });
+  c.command("set-profile-idle-ms-v2 <ms>").action((ms) => { setCcronProfileIdleMsV2(Number(ms)); console.log(JSON.stringify({ ccronProfileIdleMs: getCcronProfileIdleMsV2() }, null, 2)); });
+  c.command("set-tick-stuck-ms-v2 <ms>").action((ms) => { setCcronTickStuckMsV2(Number(ms)); console.log(JSON.stringify({ ccronTickStuckMs: getCcronTickStuckMsV2() }, null, 2)); });
+  c.command("auto-pause-idle-v2").action(() => console.log(JSON.stringify(autoPauseIdleCcronProfilesV2(), null, 2)));
+  c.command("auto-fail-stuck-v2").action(() => console.log(JSON.stringify(autoFailStuckCcronTicksV2(), null, 2)));
+  c.command("gov-stats-v2").action(() => console.log(JSON.stringify(getCoworkCronGovStatsV2(), null, 2)));
+}

package/src/commands/codegen.js

@@ -20,8 +20,52 @@ import {
   getScaffold,
   listScaffolds,
   getCodeAgentStats,
+
+  // Phase 86 V2
+  AGENT_MATURITY_V2,
+  GEN_JOB_V2,
+  getDefaultMaxActiveAgentsPerOwnerV2,
+  getMaxActiveAgentsPerOwnerV2,
+  setMaxActiveAgentsPerOwnerV2,
+  getDefaultMaxRunningJobsPerOwnerV2,
+  getMaxRunningJobsPerOwnerV2,
+  setMaxRunningJobsPerOwnerV2,
+  getDefaultAgentIdleMsV2,
+  getAgentIdleMsV2,
+  setAgentIdleMsV2,
+  getDefaultJobStuckMsV2,
+  getJobStuckMsV2,
+  setJobStuckMsV2,
+  registerAgentV2,
+  getAgentV2,
+  setAgentMaturityV2,
+  activateAgent,
+  deprecateAgent,
+  retireAgent,
+  touchAgentInvocation,
+  enqueueGenJobV2,
+  getGenJobV2,
+  setGenJobStatusV2,
+  startGenJob,
+  succeedGenJob,
+  failGenJob,
+  cancelGenJob,
+  getActiveAgentCount,
+  getRunningJobCount,
+  autoRetireIdleAgents,
+  autoFailStuckGenJobs,
+  getCodeAgentStatsV2,
 } from "../lib/code-agent.js";
 
+function _parseMetaV2(raw) {
+  if (!raw) return undefined;
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error("--metadata must be valid JSON");
+  }
+}
+
 function _dbFromCtx(cmd) {
   const root = cmd?.parent?.parent ?? cmd?.parent;
   return root?._db;
@@ -299,5 +343,185 @@ export function registerCodegenCommand(program) {
       }
     });
 
+  /* ═══════════════════════════════════════════════════ *
+   *  Phase 86 V2
+   * ═══════════════════════════════════════════════════ */
+
+  cg.command("agent-maturities-v2")
+    .description("List V2 agent maturity states")
+    .option("--json", "JSON")
+    .action((opts) => {
+      const xs = Object.values(AGENT_MATURITY_V2);
+      if (opts.json) return console.log(JSON.stringify(xs, null, 2));
+      for (const x of xs) console.log(`  ${x}`);
+    });
+
+  cg.command("gen-jobs-v2")
+    .description("List V2 generation-job states")
+    .option("--json", "JSON")
+    .action((opts) => {
+      const xs = Object.values(GEN_JOB_V2);
+      if (opts.json) return console.log(JSON.stringify(xs, null, 2));
+      for (const x of xs) console.log(`  ${x}`);
+    });
+
+  cg.command("default-max-active-agents-per-owner").action(() =>
+    console.log(getDefaultMaxActiveAgentsPerOwnerV2()),
+  );
+  cg.command("max-active-agents-per-owner").action(() =>
+    console.log(getMaxActiveAgentsPerOwnerV2()),
+  );
+  cg.command("set-max-active-agents-per-owner <n>").action((n) =>
+    console.log(setMaxActiveAgentsPerOwnerV2(n)),
+  );
+
+  cg.command("default-max-running-jobs-per-owner").action(() =>
+    console.log(getDefaultMaxRunningJobsPerOwnerV2()),
+  );
+  cg.command("max-running-jobs-per-owner").action(() =>
+    console.log(getMaxRunningJobsPerOwnerV2()),
+  );
+  cg.command("set-max-running-jobs-per-owner <n>").action((n) =>
+    console.log(setMaxRunningJobsPerOwnerV2(n)),
+  );
+
+  cg.command("default-agent-idle-ms").action(() =>
+    console.log(getDefaultAgentIdleMsV2()),
+  );
+  cg.command("agent-idle-ms").action(() => console.log(getAgentIdleMsV2()));
+  cg.command("set-agent-idle-ms <ms>").action((ms) =>
+    console.log(setAgentIdleMsV2(ms)),
+  );
+
+  cg.command("default-job-stuck-ms").action(() =>
+    console.log(getDefaultJobStuckMsV2()),
+  );
+  cg.command("job-stuck-ms").action(() => console.log(getJobStuckMsV2()));
+  cg.command("set-job-stuck-ms <ms>").action((ms) =>
+    console.log(setJobStuckMsV2(ms)),
+  );
+
+  cg.command("active-agent-count")
+    .option("-o, --owner <id>")
+    .action((opts) => console.log(getActiveAgentCount(opts.owner)));
+  cg.command("running-job-count")
+    .option("-o, --owner <id>")
+    .action((opts) => console.log(getRunningJobCount(opts.owner)));
+
+  cg.command("register-agent-v2 <agent-id>")
+    .requiredOption("-o, --owner <id>")
+    .option("-n, --name <name>")
+    .option("-i, --initial-status <s>")
+    .option("--metadata <json>")
+    .action((id, opts) => {
+      const r = registerAgentV2(null, {
+        agentId: id,
+        ownerId: opts.owner,
+        name: opts.name,
+        initialStatus: opts.initialStatus,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  cg.command("agent-v2 <agent-id>").action((id) => {
+    const r = getAgentV2(id);
+    if (!r) {
+      console.error(`Unknown agent: ${id}`);
+      process.exitCode = 1;
+      return;
+    }
+    console.log(JSON.stringify(r, null, 2));
+  });
+
+  cg.command("set-agent-maturity-v2 <agent-id> <status>")
+    .option("-r, --reason <text>")
+    .option("--metadata <json>")
+    .action((id, status, opts) => {
+      const r = setAgentMaturityV2(null, id, status, {
+        reason: opts.reason,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  for (const [name, fn] of [
+    ["activate-agent", activateAgent],
+    ["deprecate-agent", deprecateAgent],
+    ["retire-agent", retireAgent],
+  ]) {
+    cg.command(`${name} <agent-id>`)
+      .option("-r, --reason <text>")
+      .action((id, opts) => {
+        const r = fn(null, id, opts.reason);
+        console.log(JSON.stringify(r, null, 2));
+      });
+  }
+
+  cg.command("touch-agent-invocation <agent-id>").action((id) =>
+    console.log(JSON.stringify(touchAgentInvocation(id), null, 2)),
+  );
+
+  cg.command("enqueue-gen-job-v2 <job-id>")
+    .requiredOption("-o, --owner <id>")
+    .requiredOption("-a, --agent <id>")
+    .requiredOption("-p, --prompt <text>")
+    .option("--metadata <json>")
+    .action((id, opts) => {
+      const r = enqueueGenJobV2(null, {
+        jobId: id,
+        ownerId: opts.owner,
+        agentId: opts.agent,
+        prompt: opts.prompt,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  cg.command("gen-job-v2 <job-id>").action((id) => {
+    const r = getGenJobV2(id);
+    if (!r) {
+      console.error(`Unknown job: ${id}`);
+      process.exitCode = 1;
+      return;
+    }
+    console.log(JSON.stringify(r, null, 2));
+  });
+
+  cg.command("set-gen-job-status-v2 <job-id> <status>")
+    .option("-r, --reason <text>")
+    .option("--metadata <json>")
+    .action((id, status, opts) => {
+      const r = setGenJobStatusV2(null, id, status, {
+        reason: opts.reason,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  for (const [name, fn] of [
+    ["start-gen-job", startGenJob],
+    ["succeed-gen-job", succeedGenJob],
+    ["fail-gen-job", failGenJob],
+    ["cancel-gen-job", cancelGenJob],
+  ]) {
+    cg.command(`${name} <job-id>`)
+      .option("-r, --reason <text>")
+      .action((id, opts) => {
+        const r = fn(null, id, opts.reason);
+        console.log(JSON.stringify(r, null, 2));
+      });
+  }
+
+  cg.command("auto-retire-idle-agents").action(() =>
+    console.log(JSON.stringify(autoRetireIdleAgents(null), null, 2)),
+  );
+  cg.command("auto-fail-stuck-gen-jobs").action(() =>
+    console.log(JSON.stringify(autoFailStuckGenJobs(null), null, 2)),
+  );
+  cg.command("stats-v2").action(() =>
+    console.log(JSON.stringify(getCodeAgentStatsV2(), null, 2)),
+  );
+
   program.addCommand(cg);
 }