chainlesschain 0.66.0 → 0.132.0

package/src/commands/multimodal.js

@@ -35,6 +35,40 @@ import {
   getOutputFormats,
   listArtifacts,
   getMultimodalStats,
+  // V2 (Phase 27 V2)
+  SESSION_MATURITY_V2,
+  ARTIFACT_LIFECYCLE_V2,
+  getDefaultMaxActiveSessionsPerOwnerV2,
+  getMaxActiveSessionsPerOwnerV2,
+  setMaxActiveSessionsPerOwnerV2,
+  getDefaultMaxArtifactsPerSessionV2,
+  getMaxArtifactsPerSessionV2,
+  setMaxArtifactsPerSessionV2,
+  getDefaultSessionIdleMsV2,
+  getSessionIdleMsV2,
+  setSessionIdleMsV2,
+  getDefaultArtifactStaleMsV2,
+  getArtifactStaleMsV2,
+  setArtifactStaleMsV2,
+  registerSessionV2,
+  getSessionV2,
+  setSessionMaturityV2,
+  activateSession,
+  pauseSession,
+  completeSessionV2,
+  archiveSession,
+  touchSessionActivity,
+  registerArtifactV2,
+  getArtifactV2,
+  setArtifactStatusV2,
+  markArtifactReady,
+  purgeArtifact,
+  touchArtifactAccess,
+  getActiveSessionCount,
+  getArtifactCount,
+  autoArchiveIdleSessions,
+  autoPurgeStaleArtifacts,
+  getMultimodalStatsV2,
 } from "../lib/multimodal.js";
 
 function _dbFromCtx(cmd) {
@@ -400,5 +434,267 @@ export function registerMultimodalCommand(program) {
         console.log(`  ${k}: ${v}`);
     });
 
+  /* ── V2 (Phase 27 V2) ────────────────────────────── */
+
+  function _parseJsonFlag(value, label) {
+    if (value === undefined) return undefined;
+    try {
+      return JSON.parse(value);
+    } catch {
+      throw new Error(`Invalid JSON for ${label}`);
+    }
+  }
+
+  mm.command("session-maturities-v2")
+    .option("--json", "JSON output")
+    .description("List V2 session maturity states")
+    .action((opts) => {
+      const out = Object.values(SESSION_MATURITY_V2);
+      if (opts.json) return console.log(JSON.stringify(out, null, 2));
+      for (const s of out) console.log(`  ${s}`);
+    });
+
+  mm.command("artifact-lifecycles-v2")
+    .option("--json", "JSON output")
+    .description("List V2 artifact lifecycle states")
+    .action((opts) => {
+      const out = Object.values(ARTIFACT_LIFECYCLE_V2);
+      if (opts.json) return console.log(JSON.stringify(out, null, 2));
+      for (const s of out) console.log(`  ${s}`);
+    });
+
+  mm.command("default-max-active-sessions-per-owner")
+    .description("Show V2 default per-owner active-session cap")
+    .action(() => console.log(String(getDefaultMaxActiveSessionsPerOwnerV2())));
+  mm.command("max-active-sessions-per-owner")
+    .description("Show current V2 per-owner active-session cap")
+    .action(() => console.log(String(getMaxActiveSessionsPerOwnerV2())));
+  mm.command("set-max-active-sessions-per-owner <n>")
+    .description("Set V2 per-owner active-session cap")
+    .action((n) =>
+      console.log(String(setMaxActiveSessionsPerOwnerV2(Number(n)))),
+    );
+
+  mm.command("default-max-artifacts-per-session")
+    .description("Show V2 default per-session artifact cap")
+    .action(() => console.log(String(getDefaultMaxArtifactsPerSessionV2())));
+  mm.command("max-artifacts-per-session")
+    .description("Show current V2 per-session artifact cap")
+    .action(() => console.log(String(getMaxArtifactsPerSessionV2())));
+  mm.command("set-max-artifacts-per-session <n>")
+    .description("Set V2 per-session artifact cap")
+    .action((n) => console.log(String(setMaxArtifactsPerSessionV2(Number(n)))));
+
+  mm.command("default-session-idle-ms")
+    .description("Show V2 default session-idle window (ms)")
+    .action(() => console.log(String(getDefaultSessionIdleMsV2())));
+  mm.command("session-idle-ms")
+    .description("Show current V2 session-idle window (ms)")
+    .action(() => console.log(String(getSessionIdleMsV2())));
+  mm.command("set-session-idle-ms <ms>")
+    .description("Set V2 session-idle window (ms)")
+    .action((ms) => console.log(String(setSessionIdleMsV2(Number(ms)))));
+
+  mm.command("default-artifact-stale-ms")
+    .description("Show V2 default artifact-stale window (ms)")
+    .action(() => console.log(String(getDefaultArtifactStaleMsV2())));
+  mm.command("artifact-stale-ms")
+    .description("Show current V2 artifact-stale window (ms)")
+    .action(() => console.log(String(getArtifactStaleMsV2())));
+  mm.command("set-artifact-stale-ms <ms>")
+    .description("Set V2 artifact-stale window (ms)")
+    .action((ms) => console.log(String(setArtifactStaleMsV2(Number(ms)))));
+
+  mm.command("active-session-count")
+    .description("Count active V2 sessions (optionally scoped by owner)")
+    .option("-o, --owner <owner>", "Scope by owner")
+    .action((opts) => console.log(String(getActiveSessionCount(opts.owner))));
+
+  mm.command("artifact-count")
+    .description("Count open V2 artifacts (optionally scoped by session)")
+    .option("-s, --session <session>", "Scope by session")
+    .action((opts) => console.log(String(getArtifactCount(opts.session))));
+
+  mm.command("register-session-v2 <session-id>")
+    .description("Register a V2 session")
+    .requiredOption("-o, --owner-id <owner>", "Owner id")
+    .option("-t, --title <title>", "Title")
+    .option("-i, --initial-status <status>", "Initial maturity status")
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .action((sessionId, opts) => {
+      const db = _dbFromCtx(mm);
+      const metadata = _parseJsonFlag(opts.metadata, "--metadata");
+      console.log(
+        JSON.stringify(
+          registerSessionV2(db, {
+            sessionId,
+            ownerId: opts.ownerId,
+            title: opts.title,
+            initialStatus: opts.initialStatus,
+            metadata,
+          }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  mm.command("session-v2 <session-id>")
+    .description("Show a V2 session")
+    .action((sessionId) => {
+      const out = getSessionV2(sessionId);
+      console.log(out ? JSON.stringify(out, null, 2) : "null");
+    });
+
+  mm.command("set-session-maturity-v2 <session-id> <status>")
+    .description("Set V2 session maturity status")
+    .option("-r, --reason <reason>", "Reason")
+    .option("-m, --metadata <json>", "Metadata JSON (merged)")
+    .action((sessionId, status, opts) => {
+      const db = _dbFromCtx(mm);
+      const metadata = _parseJsonFlag(opts.metadata, "--metadata");
+      console.log(
+        JSON.stringify(
+          setSessionMaturityV2(db, sessionId, status, {
+            reason: opts.reason,
+            metadata,
+          }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  mm.command("activate-session <session-id>")
+    .option("-r, --reason <reason>")
+    .description("Activate a V2 session")
+    .action((id, opts) => {
+      const db = _dbFromCtx(mm);
+      console.log(
+        JSON.stringify(activateSession(db, id, opts.reason), null, 2),
+      );
+    });
+  mm.command("pause-session <session-id>")
+    .option("-r, --reason <reason>")
+    .description("Pause a V2 session")
+    .action((id, opts) => {
+      const db = _dbFromCtx(mm);
+      console.log(JSON.stringify(pauseSession(db, id, opts.reason), null, 2));
+    });
+  mm.command("complete-session-v2 <session-id>")
+    .option("-r, --reason <reason>")
+    .description("Complete a V2 session")
+    .action((id, opts) => {
+      const db = _dbFromCtx(mm);
+      console.log(
+        JSON.stringify(completeSessionV2(db, id, opts.reason), null, 2),
+      );
+    });
+  mm.command("archive-session <session-id>")
+    .option("-r, --reason <reason>")
+    .description("Archive a V2 session")
+    .action((id, opts) => {
+      const db = _dbFromCtx(mm);
+      console.log(JSON.stringify(archiveSession(db, id, opts.reason), null, 2));
+    });
+  mm.command("touch-session-activity <session-id>")
+    .description("Bump lastActivityAt on a V2 session")
+    .action((id) =>
+      console.log(JSON.stringify(touchSessionActivity(id), null, 2)),
+    );
+
+  mm.command("register-artifact-v2 <artifact-id>")
+    .description("Register a V2 artifact")
+    .requiredOption("-s, --session-id <session>", "Session id")
+    .requiredOption(
+      "-M, --modality <modality>",
+      "Modality (text/document/image/audio/screen)",
+    )
+    .option("-z, --size <bytes>", "Size in bytes", (v) => Number(v))
+    .option("-i, --initial-status <status>", "Initial lifecycle status")
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .action((artifactId, opts) => {
+      const db = _dbFromCtx(mm);
+      const metadata = _parseJsonFlag(opts.metadata, "--metadata");
+      console.log(
+        JSON.stringify(
+          registerArtifactV2(db, {
+            artifactId,
+            sessionId: opts.sessionId,
+            modality: opts.modality,
+            size: opts.size,
+            initialStatus: opts.initialStatus,
+            metadata,
+          }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  mm.command("artifact-v2 <artifact-id>")
+    .description("Show a V2 artifact")
+    .action((id) => {
+      const out = getArtifactV2(id);
+      console.log(out ? JSON.stringify(out, null, 2) : "null");
+    });
+
+  mm.command("set-artifact-status-v2 <artifact-id> <status>")
+    .option("-r, --reason <reason>")
+    .option("-m, --metadata <json>")
+    .description("Set V2 artifact lifecycle status")
+    .action((id, status, opts) => {
+      const db = _dbFromCtx(mm);
+      const metadata = _parseJsonFlag(opts.metadata, "--metadata");
+      console.log(
+        JSON.stringify(
+          setArtifactStatusV2(db, id, status, {
+            reason: opts.reason,
+            metadata,
+          }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  mm.command("mark-artifact-ready <artifact-id>")
+    .option("-r, --reason <reason>")
+    .description("Mark V2 artifact ready")
+    .action((id, opts) => {
+      const db = _dbFromCtx(mm);
+      console.log(
+        JSON.stringify(markArtifactReady(db, id, opts.reason), null, 2),
+      );
+    });
+  mm.command("purge-artifact <artifact-id>")
+    .option("-r, --reason <reason>")
+    .description("Purge a V2 artifact")
+    .action((id, opts) => {
+      const db = _dbFromCtx(mm);
+      console.log(JSON.stringify(purgeArtifact(db, id, opts.reason), null, 2));
+    });
+  mm.command("touch-artifact-access <artifact-id>")
+    .description("Bump lastAccessAt on a V2 artifact")
+    .action((id) =>
+      console.log(JSON.stringify(touchArtifactAccess(id), null, 2)),
+    );
+
+  mm.command("auto-archive-idle-sessions")
+    .description("Auto-flip idle V2 sessions to ARCHIVED")
+    .action(() => {
+      const db = _dbFromCtx(mm);
+      console.log(JSON.stringify(autoArchiveIdleSessions(db), null, 2));
+    });
+  mm.command("auto-purge-stale-artifacts")
+    .description("Auto-flip stale READY V2 artifacts to PURGED")
+    .action(() => {
+      const db = _dbFromCtx(mm);
+      console.log(JSON.stringify(autoPurgeStaleArtifacts(db), null, 2));
+    });
+  mm.command("stats-v2")
+    .description("V2 multimodal stats (counts by state + config)")
+    .action(() => console.log(JSON.stringify(getMultimodalStatsV2(), null, 2)));
+
   program.addCommand(mm);
 }

package/src/commands/nlprog.js

@@ -24,8 +24,51 @@ import {
   listConventions,
   removeConvention,
   getNlProgrammingStats,
+  /* V2 (Phase 28) */
+  SPEC_MATURITY_V2,
+  DIALOGUE_TURN_V2,
+  getDefaultMaxActiveSpecsPerAuthorV2,
+  getMaxActiveSpecsPerAuthorV2,
+  setMaxActiveSpecsPerAuthorV2,
+  getDefaultMaxPendingTurnsPerSpecV2,
+  getMaxPendingTurnsPerSpecV2,
+  setMaxPendingTurnsPerSpecV2,
+  getDefaultSpecIdleMsV2,
+  getSpecIdleMsV2,
+  setSpecIdleMsV2,
+  getDefaultTurnPendingMsV2,
+  getTurnPendingMsV2,
+  setTurnPendingMsV2,
+  registerSpecV2,
+  getSpecV2,
+  setSpecMaturityV2,
+  refineSpec,
+  approveSpec,
+  implementSpec,
+  archiveSpec,
+  touchSpecActivity,
+  registerDialogueTurnV2,
+  getDialogueTurnV2,
+  setDialogueTurnStatusV2,
+  answerTurn,
+  dismissTurn,
+  escalateTurn,
+  getActiveSpecCount,
+  getPendingTurnCount,
+  autoArchiveIdleSpecs,
+  autoDismissStalePendingTurns,
+  getNlProgrammingStatsV2,
 } from "../lib/nl-programming.js";
 
+function _parseMetaV2(s) {
+  if (!s) return undefined;
+  try {
+    return JSON.parse(s);
+  } catch {
+    throw new Error(`--metadata must be valid JSON`);
+  }
+}
+
 function _dbFromCtx(cmd) {
   const root = cmd?.parent?.parent ?? cmd?.parent;
   return root?._db;
@@ -325,5 +368,318 @@ export function registerNlProgCommand(program) {
       }
     });
 
+  /* ═════════════════════════════════════════════════════ *
+   *  Phase 28 V2 — Spec Maturity + Dialogue Lifecycle
+   * ═════════════════════════════════════════════════════ */
+
+  nlp
+    .command("spec-maturities-v2")
+    .description("List Phase 28 V2 spec maturity states")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const v = Object.values(SPEC_MATURITY_V2);
+      if (opts.json) return console.log(JSON.stringify(v, null, 2));
+      for (const s of v) console.log(s);
+    });
+
+  nlp
+    .command("dialogue-turn-lifecycles-v2")
+    .description("List Phase 28 V2 dialogue-turn lifecycle states")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const v = Object.values(DIALOGUE_TURN_V2);
+      if (opts.json) return console.log(JSON.stringify(v, null, 2));
+      for (const s of v) console.log(s);
+    });
+
+  nlp
+    .command("default-max-active-specs-per-author")
+    .description("Show default V2 per-author active-spec cap")
+    .action(() => console.log(getDefaultMaxActiveSpecsPerAuthorV2()));
+
+  nlp
+    .command("max-active-specs-per-author")
+    .description("Show current V2 per-author active-spec cap")
+    .action(() => console.log(getMaxActiveSpecsPerAuthorV2()));
+
+  nlp
+    .command("set-max-active-specs-per-author <n>")
+    .description("Set V2 per-author active-spec cap")
+    .action((n) => console.log(setMaxActiveSpecsPerAuthorV2(n)));
+
+  nlp
+    .command("default-max-pending-turns-per-spec")
+    .description("Show default V2 per-spec pending-turn cap")
+    .action(() => console.log(getDefaultMaxPendingTurnsPerSpecV2()));
+
+  nlp
+    .command("max-pending-turns-per-spec")
+    .description("Show current V2 per-spec pending-turn cap")
+    .action(() => console.log(getMaxPendingTurnsPerSpecV2()));
+
+  nlp
+    .command("set-max-pending-turns-per-spec <n>")
+    .description("Set V2 per-spec pending-turn cap")
+    .action((n) => console.log(setMaxPendingTurnsPerSpecV2(n)));
+
+  nlp
+    .command("default-spec-idle-ms")
+    .description("Show default V2 spec idle threshold")
+    .action(() => console.log(getDefaultSpecIdleMsV2()));
+
+  nlp
+    .command("spec-idle-ms")
+    .description("Show current V2 spec idle threshold")
+    .action(() => console.log(getSpecIdleMsV2()));
+
+  nlp
+    .command("set-spec-idle-ms <ms>")
+    .description("Set V2 spec idle threshold (ms)")
+    .action((ms) => console.log(setSpecIdleMsV2(ms)));
+
+  nlp
+    .command("default-turn-pending-ms")
+    .description("Show default V2 turn-pending threshold")
+    .action(() => console.log(getDefaultTurnPendingMsV2()));
+
+  nlp
+    .command("turn-pending-ms")
+    .description("Show current V2 turn-pending threshold")
+    .action(() => console.log(getTurnPendingMsV2()));
+
+  nlp
+    .command("set-turn-pending-ms <ms>")
+    .description("Set V2 turn-pending threshold (ms)")
+    .action((ms) => console.log(setTurnPendingMsV2(ms)));
+
+  nlp
+    .command("active-spec-count")
+    .description("Count active V2 specs (optionally scoped by author)")
+    .option("-a, --author <id>", "Author ID")
+    .action((opts) => console.log(getActiveSpecCount(opts.author)));
+
+  nlp
+    .command("pending-turn-count")
+    .description("Count pending V2 turns (optionally scoped by spec)")
+    .option("-s, --spec <id>", "Spec ID")
+    .action((opts) => console.log(getPendingTurnCount(opts.spec)));
+
+  nlp
+    .command("register-spec-v2 <spec-id>")
+    .description("Register a V2 spec")
+    .requiredOption("-a, --author <id>", "Author ID")
+    .option("-t, --title <text>", "Title")
+    .option("-i, --initial-status <status>", "Initial status")
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .option("--json", "JSON output")
+    .action((specId, opts) => {
+      const db = _dbFromCtx(nlp);
+      const rec = registerSpecV2(db, {
+        specId,
+        authorId: opts.author,
+        title: opts.title,
+        initialStatus: opts.initialStatus,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      if (opts.json) return console.log(JSON.stringify(rec, null, 2));
+      console.log(`Registered spec ${specId} (${rec.status})`);
+    });
+
+  nlp
+    .command("spec-v2 <spec-id>")
+    .description("Show a V2 spec")
+    .option("--json", "JSON output")
+    .action((id, opts) => {
+      const rec = getSpecV2(id);
+      if (!rec) {
+        console.error(`Unknown spec: ${id}`);
+        process.exitCode = 1;
+        return;
+      }
+      if (opts.json) return console.log(JSON.stringify(rec, null, 2));
+      console.log(`${rec.specId} [${rec.status}] author=${rec.authorId}`);
+    });
+
+  nlp
+    .command("set-spec-maturity-v2 <spec-id> <status>")
+    .description("Transition V2 spec maturity")
+    .option("-r, --reason <text>", "Reason")
+    .option("-m, --metadata <json>", "Metadata patch (JSON)")
+    .action((id, status, opts) => {
+      const db = _dbFromCtx(nlp);
+      const rec = setSpecMaturityV2(db, id, status, {
+        reason: opts.reason,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      console.log(`${id} → ${rec.status}`);
+    });
+
+  nlp
+    .command("refine-spec <spec-id>")
+    .description("Transition a V2 spec to REFINING")
+    .option("-r, --reason <text>", "Reason")
+    .action((id, opts) => {
+      const rec = refineSpec(_dbFromCtx(nlp), id, opts.reason);
+      console.log(`${id} → ${rec.status}`);
+    });
+
+  nlp
+    .command("approve-spec <spec-id>")
+    .description("Transition a V2 spec to APPROVED")
+    .option("-r, --reason <text>", "Reason")
+    .action((id, opts) => {
+      const rec = approveSpec(_dbFromCtx(nlp), id, opts.reason);
+      console.log(`${id} → ${rec.status}`);
+    });
+
+  nlp
+    .command("implement-spec <spec-id>")
+    .description("Transition a V2 spec to IMPLEMENTED")
+    .option("-r, --reason <text>", "Reason")
+    .action((id, opts) => {
+      const rec = implementSpec(_dbFromCtx(nlp), id, opts.reason);
+      console.log(`${id} → ${rec.status}`);
+    });
+
+  nlp
+    .command("archive-spec <spec-id>")
+    .description("Transition a V2 spec to ARCHIVED")
+    .option("-r, --reason <text>", "Reason")
+    .action((id, opts) => {
+      const rec = archiveSpec(_dbFromCtx(nlp), id, opts.reason);
+      console.log(`${id} → ${rec.status}`);
+    });
+
+  nlp
+    .command("touch-spec-activity <spec-id>")
+    .description("Bump lastActivityAt for a V2 spec")
+    .action((id) => {
+      const rec = touchSpecActivity(id);
+      console.log(`${id} lastActivityAt=${rec.lastActivityAt}`);
+    });
+
+  nlp
+    .command("register-dialogue-turn-v2 <turn-id>")
+    .description("Register a V2 dialogue turn")
+    .requiredOption("-s, --spec <id>", "Spec ID")
+    .option("-R, --role <role>", "Role (user/assistant)")
+    .option("-q, --question <text>", "Question text")
+    .option("-i, --initial-status <status>", "Initial status")
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .option("--json", "JSON output")
+    .action((turnId, opts) => {
+      const db = _dbFromCtx(nlp);
+      const rec = registerDialogueTurnV2(db, {
+        turnId,
+        specId: opts.spec,
+        role: opts.role,
+        question: opts.question,
+        initialStatus: opts.initialStatus,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      if (opts.json) return console.log(JSON.stringify(rec, null, 2));
+      console.log(`Registered turn ${turnId} (${rec.status})`);
+    });
+
+  nlp
+    .command("dialogue-turn-v2 <turn-id>")
+    .description("Show a V2 dialogue turn")
+    .option("--json", "JSON output")
+    .action((id, opts) => {
+      const rec = getDialogueTurnV2(id);
+      if (!rec) {
+        console.error(`Unknown turn: ${id}`);
+        process.exitCode = 1;
+        return;
+      }
+      if (opts.json) return console.log(JSON.stringify(rec, null, 2));
+      console.log(`${rec.turnId} [${rec.status}] spec=${rec.specId}`);
+    });
+
+  nlp
+    .command("set-dialogue-turn-status-v2 <turn-id> <status>")
+    .description("Transition V2 dialogue turn status")
+    .option("-a, --answer <text>", "Answer text")
+    .option("-r, --reason <text>", "Reason")
+    .option("-m, --metadata <json>", "Metadata patch (JSON)")
+    .action((id, status, opts) => {
+      const db = _dbFromCtx(nlp);
+      const rec = setDialogueTurnStatusV2(db, id, status, {
+        answer: opts.answer,
+        reason: opts.reason,
+        metadata: _parseMetaV2(opts.metadata),
+      });
+      console.log(`${id} → ${rec.status}`);
+    });
+
+  nlp
+    .command("answer-turn <turn-id>")
+    .description("Transition a V2 turn to ANSWERED (with answer)")
+    .requiredOption("-a, --answer <text>", "Answer text")
+    .option("-r, --reason <text>", "Reason")
+    .action((id, opts) => {
+      const rec = answerTurn(_dbFromCtx(nlp), id, opts.answer, opts.reason);
+      console.log(`${id} → ${rec.status}`);
+    });
+
+  nlp
+    .command("dismiss-turn <turn-id>")
+    .description("Transition a V2 turn to DISMISSED")
+    .option("-r, --reason <text>", "Reason")
+    .action((id, opts) => {
+      const rec = dismissTurn(_dbFromCtx(nlp), id, opts.reason);
+      console.log(`${id} → ${rec.status}`);
+    });
+
+  nlp
+    .command("escalate-turn <turn-id>")
+    .description("Transition a V2 turn to ESCALATED")
+    .option("-r, --reason <text>", "Reason")
+    .action((id, opts) => {
+      const rec = escalateTurn(_dbFromCtx(nlp), id, opts.reason);
+      console.log(`${id} → ${rec.status}`);
+    });
+
+  nlp
+    .command("auto-archive-idle-specs")
+    .description(
+      "Flip idle V2 specs (draft/refining/approved/implemented) → ARCHIVED",
+    )
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const r = autoArchiveIdleSpecs(_dbFromCtx(nlp));
+      if (opts.json) return console.log(JSON.stringify(r, null, 2));
+      console.log(`Archived ${r.count} idle spec(s)`);
+    });
+
+  nlp
+    .command("auto-dismiss-stale-pending-turns")
+    .description("Flip stale PENDING V2 turns → DISMISSED")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const r = autoDismissStalePendingTurns(_dbFromCtx(nlp));
+      if (opts.json) return console.log(JSON.stringify(r, null, 2));
+      console.log(`Dismissed ${r.count} stale turn(s)`);
+    });
+
+  nlp
+    .command("stats-v2")
+    .description("Phase 28 V2 statistics")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const s = getNlProgrammingStatsV2();
+      if (opts.json) return console.log(JSON.stringify(s, null, 2));
+      console.log(
+        `Specs(V2)=${s.totalSpecsV2} Turns(V2)=${s.totalTurnsV2} ` +
+          `caps: active-specs/author=${s.maxActiveSpecsPerAuthor} pending-turns/spec=${s.maxPendingTurnsPerSpec}`,
+      );
+      console.log("specs-by-status:");
+      for (const [k, v] of Object.entries(s.specsByStatus))
+        console.log(`  ${k.padEnd(12)} ${v}`);
+      console.log("turns-by-status:");
+      for (const [k, v] of Object.entries(s.turnsByStatus))
+        console.log(`  ${k.padEnd(12)} ${v}`);
+    });
+
   program.addCommand(nlp);
 }