chainlesschain 0.81.0 → 0.143.0

package/src/commands/dao.js

@@ -874,4 +874,66 @@ export function registerDaoCommand(program) {
         }
       }
     });
+  registerDaoV2Command(dao);
 }
+
+
+import {
+  DAO_ORG_MATURITY_V2,
+  DAO_PROPOSAL_LIFECYCLE_V2,
+  registerDaoOrgV2,
+  activateDaoOrgV2,
+  pauseDaoOrgV2,
+  dissolveDaoOrgV2,
+  touchDaoOrgV2,
+  getDaoOrgV2,
+  listDaoOrgsV2,
+  createDaoProposalV2,
+  startDaoProposalV2,
+  passDaoProposalV2,
+  failDaoProposalV2,
+  cancelDaoProposalV2,
+  getDaoProposalV2,
+  listDaoProposalsV2,
+  setMaxActiveDaoOrgsPerOwnerV2,
+  getMaxActiveDaoOrgsPerOwnerV2,
+  setMaxPendingDaoProposalsPerOrgV2,
+  getMaxPendingDaoProposalsPerOrgV2,
+  setDaoOrgIdleMsV2,
+  getDaoOrgIdleMsV2,
+  setDaoProposalStuckMsV2,
+  getDaoProposalStuckMsV2,
+  autoPauseIdleDaoOrgsV2,
+  autoFailStuckDaoProposalsV2,
+  getDaoGovernanceGovStatsV2,
+} from "../lib/dao-governance.js";
+
+export function registerDaoV2Command(dao) {
+  dao.command("enums-v2").description("Show V2 governance enums").action(() => { console.log(JSON.stringify({ DAO_ORG_MATURITY_V2, DAO_PROPOSAL_LIFECYCLE_V2 }, null, 2)); });
+  dao.command("register-org-v2").description("Register a dao org profile (pending)")
+    .requiredOption("--id <id>").requiredOption("--owner <owner>").option("--name <name>")
+    .action((o) => { console.log(JSON.stringify(registerDaoOrgV2({ id: o.id, owner: o.owner, name: o.name }), null, 2)); });
+  dao.command("activate-org-v2 <id>").description("Activate org").action((id) => { console.log(JSON.stringify(activateDaoOrgV2(id), null, 2)); });
+  dao.command("pause-org-v2 <id>").description("Pause org").action((id) => { console.log(JSON.stringify(pauseDaoOrgV2(id), null, 2)); });
+  dao.command("dissolve-org-v2 <id>").description("Dissolve org (terminal)").action((id) => { console.log(JSON.stringify(dissolveDaoOrgV2(id), null, 2)); });
+  dao.command("touch-org-v2 <id>").description("Refresh lastTouchedAt").action((id) => { console.log(JSON.stringify(touchDaoOrgV2(id), null, 2)); });
+  dao.command("get-org-v2 <id>").description("Get org").action((id) => { console.log(JSON.stringify(getDaoOrgV2(id), null, 2)); });
+  dao.command("list-orgs-v2").description("List orgs").action(() => { console.log(JSON.stringify(listDaoOrgsV2(), null, 2)); });
+  dao.command("create-proposal-v2").description("Create a dao proposal (queued)")
+    .requiredOption("--id <id>").requiredOption("--org-id <orgId>").option("--title <title>")
+    .action((o) => { console.log(JSON.stringify(createDaoProposalV2({ id: o.id, orgId: o.orgId, title: o.title }), null, 2)); });
+  dao.command("start-proposal-v2 <id>").description("Transition proposal to voting").action((id) => { console.log(JSON.stringify(startDaoProposalV2(id), null, 2)); });
+  dao.command("pass-proposal-v2 <id>").description("Transition proposal to passed").action((id) => { console.log(JSON.stringify(passDaoProposalV2(id), null, 2)); });
+  dao.command("fail-proposal-v2 <id>").description("Fail proposal").option("--reason <r>").action((id, o) => { console.log(JSON.stringify(failDaoProposalV2(id, o.reason), null, 2)); });
+  dao.command("cancel-proposal-v2 <id>").description("Cancel proposal").option("--reason <r>").action((id, o) => { console.log(JSON.stringify(cancelDaoProposalV2(id, o.reason), null, 2)); });
+  dao.command("get-proposal-v2 <id>").description("Get proposal").action((id) => { console.log(JSON.stringify(getDaoProposalV2(id), null, 2)); });
+  dao.command("list-proposals-v2").description("List proposals").action(() => { console.log(JSON.stringify(listDaoProposalsV2(), null, 2)); });
+  dao.command("set-max-active-orgs-v2 <n>").description("Set per-owner active cap").action((n) => { setMaxActiveDaoOrgsPerOwnerV2(Number(n)); console.log(JSON.stringify({ maxActiveDaoOrgsPerOwner: getMaxActiveDaoOrgsPerOwnerV2() }, null, 2)); });
+  dao.command("set-max-pending-proposals-v2 <n>").description("Set per-org pending cap").action((n) => { setMaxPendingDaoProposalsPerOrgV2(Number(n)); console.log(JSON.stringify({ maxPendingDaoProposalsPerOrg: getMaxPendingDaoProposalsPerOrgV2() }, null, 2)); });
+  dao.command("set-org-idle-ms-v2 <n>").description("Set idle threshold").action((n) => { setDaoOrgIdleMsV2(Number(n)); console.log(JSON.stringify({ daoOrgIdleMs: getDaoOrgIdleMsV2() }, null, 2)); });
+  dao.command("set-proposal-stuck-ms-v2 <n>").description("Set stuck threshold").action((n) => { setDaoProposalStuckMsV2(Number(n)); console.log(JSON.stringify({ daoProposalStuckMs: getDaoProposalStuckMsV2() }, null, 2)); });
+  dao.command("auto-pause-idle-orgs-v2").description("Auto-pause idle orgs").action(() => { console.log(JSON.stringify(autoPauseIdleDaoOrgsV2(), null, 2)); });
+  dao.command("auto-fail-stuck-proposals-v2").description("Auto-fail stuck voting proposals").action(() => { console.log(JSON.stringify(autoFailStuckDaoProposalsV2(), null, 2)); });
+  dao.command("gov-stats-v2").description("V2 governance aggregate stats").action(() => { console.log(JSON.stringify(getDaoGovernanceGovStatsV2(), null, 2)); });
+}
+

package/src/commands/dbevo.js

@@ -27,8 +27,53 @@ import {
   getSuggestion,
   applySuggestion,
   getDbEvoStats,
+
+  // Phase 80 V2
+  SCHEMA_BASELINE_V2,
+  MIGRATION_RUN_V2,
+  getDefaultMaxActiveBaselinesPerDbV2,
+  getMaxActiveBaselinesPerDbV2,
+  setMaxActiveBaselinesPerDbV2,
+  getDefaultMaxRunningMigrationsPerDbV2,
+  getMaxRunningMigrationsPerDbV2,
+  setMaxRunningMigrationsPerDbV2,
+  getDefaultBaselineIdleMsV2,
+  getBaselineIdleMsV2,
+  setBaselineIdleMsV2,
+  getDefaultMigrationStuckMsV2,
+  getMigrationStuckMsV2,
+  setMigrationStuckMsV2,
+  registerBaselineV2,
+  getBaselineV2,
+  setBaselineStatusV2,
+  validateBaseline,
+  activateBaseline,
+  deprecateBaseline,
+  retireBaseline,
+  touchBaselineActivity,
+  enqueueMigrationRunV2,
+  getMigrationRunV2,
+  setMigrationRunStatusV2,
+  startMigrationRun,
+  applyMigrationRun,
+  failMigrationRun,
+  rollbackMigrationRun,
+  getActiveBaselineCount,
+  getRunningMigrationCount,
+  autoRetireIdleBaselines,
+  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");
+  }
+}
+
 function _dbFromCtx(cmd) {
   const root = cmd?.parent?.parent ?? cmd?.parent;
   return root?._db;
@@ -384,5 +429,244 @@ export function registerDbEvoCommand(program) {
       );
     });
 
+  /* ═══════════════════════════════════════════════════ *
+   *  Phase 80 V2 — Schema Baseline + Migration Run
+   * ═══════════════════════════════════════════════════ */
+
+  dbevo
+    .command("schema-baselines-v2")
+    .description("List V2 baseline states")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const xs = Object.values(SCHEMA_BASELINE_V2);
+      if (opts.json) return console.log(JSON.stringify(xs, null, 2));
+      for (const x of xs) console.log(`  ${x}`);
+    });
+
+  dbevo
+    .command("migration-runs-v2")
+    .description("List V2 migration-run states")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const xs = Object.values(MIGRATION_RUN_V2);
+      if (opts.json) return console.log(JSON.stringify(xs, null, 2));
+      for (const x of xs) console.log(`  ${x}`);
+    });
+
+  dbevo
+    .command("default-max-active-baselines-per-db")
+    .description("Default active-baseline cap")
+    .action(() => console.log(getDefaultMaxActiveBaselinesPerDbV2()));
+  dbevo
+    .command("max-active-baselines-per-db")
+    .description("Current active-baseline cap")
+    .action(() => console.log(getMaxActiveBaselinesPerDbV2()));
+  dbevo
+    .command("set-max-active-baselines-per-db <n>")
+    .description("Set active-baseline cap")
+    .action((n) => console.log(setMaxActiveBaselinesPerDbV2(n)));
+
+  dbevo
+    .command("default-max-running-migrations-per-db")
+    .description("Default running-migration cap")
+    .action(() => console.log(getDefaultMaxRunningMigrationsPerDbV2()));
+  dbevo
+    .command("max-running-migrations-per-db")
+    .description("Current running-migration cap")
+    .action(() => console.log(getMaxRunningMigrationsPerDbV2()));
+  dbevo
+    .command("set-max-running-migrations-per-db <n>")
+    .description("Set running-migration cap")
+    .action((n) => console.log(setMaxRunningMigrationsPerDbV2(n)));
+
+  dbevo
+    .command("default-baseline-idle-ms")
+    .description("Default baseline idle ms")
+    .action(() => console.log(getDefaultBaselineIdleMsV2()));
+  dbevo
+    .command("baseline-idle-ms")
+    .description("Current baseline idle ms")
+    .action(() => console.log(getBaselineIdleMsV2()));
+  dbevo
+    .command("set-baseline-idle-ms <ms>")
+    .description("Set baseline idle ms")
+    .action((ms) => console.log(setBaselineIdleMsV2(ms)));
+
+  dbevo
+    .command("default-migration-stuck-ms")
+    .description("Default migration stuck ms")
+    .action(() => console.log(getDefaultMigrationStuckMsV2()));
+  dbevo
+    .command("migration-stuck-ms")
+    .description("Current migration stuck ms")
+    .action(() => console.log(getMigrationStuckMsV2()));
+  dbevo
+    .command("set-migration-stuck-ms <ms>")
+    .description("Set migration stuck ms")
+    .action((ms) => console.log(setMigrationStuckMsV2(ms)));
+
+  dbevo
+    .command("active-baseline-count")
+    .description("Count of ACTIVE baselines")
+    .option("-d, --database <id>", "filter by database")
+    .action((opts) => console.log(getActiveBaselineCount(opts.database)));
+
+  dbevo
+    .command("running-migration-count")
+    .description("Count of RUNNING migration runs")
+    .option("-d, --database <id>", "filter by database")
+    .action((opts) => console.log(getRunningMigrationCount(opts.database)));
+
+  // ── Baseline CRUD ──────────────────────────────────
+
+  dbevo
+    .command("register-baseline-v2 <baseline-id>")
+    .description("Register a V2 baseline")
+    .requiredOption("-d, --database <id>", "database id")
+    .requiredOption("-v, --version <ver>", "schema version")
+    .option("-i, --initial-status <s>", "initial status")
+    .option("--metadata <json>", "metadata JSON")
+    .action((id, opts) => {
+      const r = registerBaselineV2(null, {
+        baselineId: id,
+        databaseId: opts.database,
+        version: opts.version,
+        initialStatus: opts.initialStatus,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  dbevo
+    .command("baseline-v2 <baseline-id>")
+    .description("Get a V2 baseline")
+    .action((id) => {
+      const r = getBaselineV2(id);
+      if (!r) {
+        console.error(`Unknown baseline: ${id}`);
+        process.exitCode = 1;
+        return;
+      }
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  dbevo
+    .command("set-baseline-status-v2 <baseline-id> <status>")
+    .description("Transition baseline status")
+    .option("-r, --reason <text>", "reason")
+    .option("--metadata <json>", "metadata JSON")
+    .action((id, status, opts) => {
+      const r = setBaselineStatusV2(null, id, status, {
+        reason: opts.reason,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  for (const [name, fn] of [
+    ["validate-baseline", validateBaseline],
+    ["activate-baseline", activateBaseline],
+    ["deprecate-baseline", deprecateBaseline],
+    ["retire-baseline", retireBaseline],
+  ]) {
+    dbevo
+      .command(`${name} <baseline-id>`)
+      .description(`Transition baseline (${name})`)
+      .option("-r, --reason <text>", "reason")
+      .action((id, opts) => {
+        const r = fn(null, id, opts.reason);
+        console.log(JSON.stringify(r, null, 2));
+      });
+  }
+
+  dbevo
+    .command("touch-baseline-activity <baseline-id>")
+    .description("Bump lastTouchedAt")
+    .action((id) => {
+      const r = touchBaselineActivity(id);
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  // ── Migration Run CRUD ─────────────────────────────
+
+  dbevo
+    .command("enqueue-migration-run-v2 <run-id>")
+    .description("Enqueue a V2 migration run")
+    .requiredOption("-d, --database <id>", "database id")
+    .requiredOption("-m, --migration <id>", "migration id")
+    .requiredOption("--direction <up|down>", "direction")
+    .option("--metadata <json>", "metadata JSON")
+    .action((id, opts) => {
+      const r = enqueueMigrationRunV2(null, {
+        runId: id,
+        databaseId: opts.database,
+        migrationId: opts.migration,
+        direction: opts.direction,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  dbevo
+    .command("migration-run-v2 <run-id>")
+    .description("Get a V2 migration run")
+    .action((id) => {
+      const r = getMigrationRunV2(id);
+      if (!r) {
+        console.error(`Unknown run: ${id}`);
+        process.exitCode = 1;
+        return;
+      }
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  dbevo
+    .command("set-migration-run-status-v2 <run-id> <status>")
+    .description("Transition migration-run status")
+    .option("-r, --reason <text>", "reason")
+    .option("--metadata <json>", "metadata JSON")
+    .action((id, status, opts) => {
+      const r = setMigrationRunStatusV2(null, id, status, {
+        reason: opts.reason,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  for (const [name, fn] of [
+    ["start-migration-run", startMigrationRun],
+    ["apply-migration-run", applyMigrationRun],
+    ["fail-migration-run", failMigrationRun],
+    ["rollback-migration-run", rollbackMigrationRun],
+  ]) {
+    dbevo
+      .command(`${name} <run-id>`)
+      .description(`Transition migration run (${name})`)
+      .option("-r, --reason <text>", "reason")
+      .action((id, opts) => {
+        const r = fn(null, id, opts.reason);
+        console.log(JSON.stringify(r, null, 2));
+      });
+  }
+
+  dbevo
+    .command("auto-retire-idle-baselines")
+    .description("Flip idle draft/validated/deprecated → RETIRED")
+    .action(() =>
+      console.log(JSON.stringify(autoRetireIdleBaselines(null), null, 2)),
+    );
+
+  dbevo
+    .command("auto-fail-stuck-migration-runs")
+    .description("Flip stuck RUNNING → FAILED")
+    .action(() =>
+      console.log(JSON.stringify(autoFailStuckMigrationRuns(null), null, 2)),
+    );
+
+  dbevo
+    .command("stats-v2")
+    .description("V2 stats snapshot")
+    .action(() => console.log(JSON.stringify(getDbEvoStatsV2(), null, 2)));
+
   program.addCommand(dbevo);
 }

package/src/commands/dev.js

@@ -25,8 +25,47 @@ import {
   listADRs,
   renderADR,
   AUTONOMY_LEVELS,
+  ADR_MATURITY_V2,
+  DEV_SESSION_V2,
+  getMaxActiveAdrsPerAuthor,
+  setMaxActiveAdrsPerAuthor,
+  getMaxRunningSessionsPerDeveloper,
+  setMaxRunningSessionsPerDeveloper,
+  getAdrStaleMs,
+  setAdrStaleMs,
+  getSessionStuckMs,
+  setSessionStuckMs,
+  getActiveAdrCount,
+  getRunningSessionCount,
+  createAdrV2,
+  getAdrV2,
+  listAdrsV2,
+  setAdrMaturityV2,
+  acceptAdr,
+  deprecateAdr,
+  supersedeAdr,
+  enqueueSessionV2,
+  getSessionV2,
+  listSessionsV2,
+  setSessionStatusV2,
+  startSessionV2,
+  completeSessionV2,
+  failSessionV2,
+  cancelSessionV2,
+  autoSupersedeStaleDrafts,
+  autoFailStuckSessions,
+  getAutonomousDeveloperStatsV2,
 } from "../lib/autonomous-developer.js";
 
+function _parseJsonV2(s) {
+  if (!s) return undefined;
+  try {
+    return JSON.parse(s);
+  } catch {
+    throw new Error(`invalid JSON: ${s}`);
+  }
+}
+
 function _dbFromCtx(ctx) {
   if (!ctx.db) {
     logger.error("Database not available");
@@ -408,4 +447,217 @@ export function registerDevCommand(program) {
 
   // silence unused import lints (AUTONOMY_LEVELS re-exported for consumers)
   void AUTONOMY_LEVELS;
+
+  /* ── V2 Surface (Autonomous Developer) ─────────────────── */
+
+  dev
+    .command("adr-maturities-v2")
+    .description("List ADR_MATURITY_V2 enum")
+    .action(() => {
+      for (const v of Object.values(ADR_MATURITY_V2)) console.log(`  ${v}`);
+    });
+
+  dev
+    .command("dev-sessions-v2")
+    .description("List DEV_SESSION_V2 enum")
+    .action(() => {
+      for (const v of Object.values(DEV_SESSION_V2)) console.log(`  ${v}`);
+    });
+
+  dev
+    .command("max-active-adrs-per-author")
+    .description("Get max-active-adrs-per-author cap")
+    .action(() => console.log(getMaxActiveAdrsPerAuthor()));
+  dev
+    .command("set-max-active-adrs-per-author <n>")
+    .action((n) => console.log(setMaxActiveAdrsPerAuthor(Number(n))));
+
+  dev
+    .command("max-running-sessions-per-developer")
+    .description("Get max-running-sessions-per-developer cap")
+    .action(() => console.log(getMaxRunningSessionsPerDeveloper()));
+  dev
+    .command("set-max-running-sessions-per-developer <n>")
+    .action((n) => console.log(setMaxRunningSessionsPerDeveloper(Number(n))));
+
+  dev
+    .command("adr-stale-ms")
+    .description("Get adr-stale-ms threshold")
+    .action(() => console.log(getAdrStaleMs()));
+  dev
+    .command("set-adr-stale-ms <n>")
+    .action((n) => console.log(setAdrStaleMs(Number(n))));
+
+  dev
+    .command("session-stuck-ms")
+    .description("Get session-stuck-ms threshold")
+    .action(() => console.log(getSessionStuckMs()));
+  dev
+    .command("set-session-stuck-ms <n>")
+    .action((n) => console.log(setSessionStuckMs(Number(n))));
+
+  dev
+    .command("active-adr-count")
+    .description("Count non-superseded ADRs (optionally by author)")
+    .option("-a, --author <author>")
+    .action((opts) => console.log(getActiveAdrCount(opts.author)));
+
+  dev
+    .command("running-session-count")
+    .description("Count RUNNING sessions (optionally by developer)")
+    .option("-d, --developer <developer>")
+    .action((opts) => console.log(getRunningSessionCount(opts.developer)));
+
+  dev
+    .command("create-adr-v2 <adr-id>")
+    .description("Create V2 ADR")
+    .requiredOption("-a, --author <author>", "author")
+    .requiredOption("-t, --title <title>", "title")
+    .option("-i, --initial <status>", "initial status", ADR_MATURITY_V2.DRAFT)
+    .option("--metadata <json>", "metadata JSON")
+    .action((id, opts) => {
+      const a = createAdrV2({
+        id,
+        author: opts.author,
+        title: opts.title,
+        initialStatus: opts.initial,
+        metadata: _parseJsonV2(opts.metadata),
+      });
+      console.log(JSON.stringify(a, null, 2));
+    });
+
+  dev
+    .command("adr-v2 <adr-id>")
+    .description("Show V2 ADR")
+    .action((id) => {
+      const a = getAdrV2(id);
+      if (!a) return console.error(`ADR ${id} not found`);
+      console.log(JSON.stringify(a, null, 2));
+    });
+
+  dev
+    .command("list-adrs-v2")
+    .description("List V2 ADRs")
+    .option("-a, --author <author>")
+    .option("-s, --status <status>")
+    .action((opts) => console.log(JSON.stringify(listAdrsV2(opts), null, 2)));
+
+  dev
+    .command("set-adr-maturity-v2 <adr-id> <status>")
+    .description("Transition V2 ADR maturity")
+    .option("-r, --reason <reason>")
+    .option("--metadata <json>")
+    .action((id, status, opts) => {
+      const a = setAdrMaturityV2(id, status, {
+        reason: opts.reason,
+        metadata: _parseJsonV2(opts.metadata),
+      });
+      console.log(JSON.stringify(a, null, 2));
+    });
+
+  for (const [name, fn] of [
+    ["accept-adr", acceptAdr],
+    ["deprecate-adr", deprecateAdr],
+    ["supersede-adr", supersedeAdr],
+  ]) {
+    dev
+      .command(`${name} <adr-id>`)
+      .description(`Shortcut for ${name.replace("-adr", "")} transition`)
+      .option("-r, --reason <reason>")
+      .action((id, opts) => {
+        const a = fn(id, { reason: opts.reason });
+        console.log(JSON.stringify(a, null, 2));
+      });
+  }
+
+  dev
+    .command("enqueue-session-v2 <session-id>")
+    .description("Enqueue V2 dev session")
+    .requiredOption("-d, --developer <developer>")
+    .requiredOption("-g, --goal <goal>")
+    .option("--metadata <json>")
+    .action((id, opts) => {
+      const s = enqueueSessionV2({
+        id,
+        developer: opts.developer,
+        goal: opts.goal,
+        metadata: _parseJsonV2(opts.metadata),
+      });
+      console.log(JSON.stringify(s, null, 2));
+    });
+
+  dev
+    .command("session-v2 <session-id>")
+    .description("Show V2 session")
+    .action((id) => {
+      const s = getSessionV2(id);
+      if (!s) return console.error(`session ${id} not found`);
+      console.log(JSON.stringify(s, null, 2));
+    });
+
+  dev
+    .command("list-sessions-v2")
+    .description("List V2 sessions")
+    .option("-d, --developer <developer>")
+    .option("-s, --status <status>")
+    .action((opts) =>
+      console.log(JSON.stringify(listSessionsV2(opts), null, 2)),
+    );
+
+  dev
+    .command("set-session-status-v2 <session-id> <status>")
+    .option("-r, --reason <reason>")
+    .option("--metadata <json>")
+    .action((id, status, opts) => {
+      const s = setSessionStatusV2(id, status, {
+        reason: opts.reason,
+        metadata: _parseJsonV2(opts.metadata),
+      });
+      console.log(JSON.stringify(s, null, 2));
+    });
+
+  for (const [name, fn] of [
+    ["start-session-v2", startSessionV2],
+    ["complete-session-v2", completeSessionV2],
+    ["fail-session-v2", failSessionV2],
+    ["cancel-session-v2", cancelSessionV2],
+  ]) {
+    dev
+      .command(`${name} <session-id>`)
+      .description(`Shortcut for ${name.replace("-session-v2", "")} transition`)
+      .option("-r, --reason <reason>")
+      .action((id, opts) => {
+        const s = fn(id, { reason: opts.reason });
+        console.log(JSON.stringify(s, null, 2));
+      });
+  }
+
+  dev
+    .command("auto-supersede-stale-drafts")
+    .description(
+      "Bulk-supersede DRAFT ADRs whose updatedAt is older than adrStaleMs",
+    )
+    .action(() =>
+      console.log(
+        JSON.stringify({ flipped: autoSupersedeStaleDrafts() }, null, 2),
+      ),
+    );
+
+  dev
+    .command("auto-fail-stuck-sessions")
+    .description(
+      "Bulk-fail RUNNING sessions whose startedAt is older than sessionStuckMs",
+    )
+    .action(() =>
+      console.log(
+        JSON.stringify({ flipped: autoFailStuckSessions() }, null, 2),
+      ),
+    );
+
+  dev
+    .command("stats-v2")
+    .description("Show V2 autonomous-developer stats")
+    .action(() =>
+      console.log(JSON.stringify(getAutonomousDeveloperStatsV2(), null, 2)),
+    );
 }