chainlesschain 0.66.0 → 0.132.0

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)),
+    );
 }