chainlesschain 0.81.0 → 0.143.0

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

package/src/commands/nostr.js

@@ -371,4 +371,66 @@ export function registerNostrCommand(program) {
         process.exit(1);
       }
     });
+
+  registerNostrV2Command(nostr);
+}
+
+
+import {
+  NOSTR_RELAY_MATURITY_V2,
+  NOSTR_EVENT_LIFECYCLE_V2,
+  registerNostrRelayV2,
+  activateNostrRelayV2,
+  offlineNostrRelayV2,
+  retireNostrRelayV2,
+  touchNostrRelayV2,
+  getNostrRelayV2,
+  listNostrRelaysV2,
+  createNostrEventV2,
+  startNostrEventV2,
+  publishNostrEventV2,
+  failNostrEventV2,
+  cancelNostrEventV2,
+  getNostrEventV2,
+  listNostrEventsV2,
+  setMaxActiveNostrRelaysPerOwnerV2,
+  getMaxActiveNostrRelaysPerOwnerV2,
+  setMaxPendingNostrEventsPerRelayV2,
+  getMaxPendingNostrEventsPerRelayV2,
+  setNostrRelayIdleMsV2,
+  getNostrRelayIdleMsV2,
+  setNostrEventStuckMsV2,
+  getNostrEventStuckMsV2,
+  autoOfflineIdleNostrRelaysV2,
+  autoFailStuckNostrEventsV2,
+  getNostrBridgeStatsV2,
+} from "../lib/nostr-bridge.js";
+
+export function registerNostrV2Command(nostr) {
+  nostr.command("enums-v2").description("Show V2 enums").action(() => { console.log(JSON.stringify({ NOSTR_RELAY_MATURITY_V2, NOSTR_EVENT_LIFECYCLE_V2 }, null, 2)); });
+  nostr.command("register-relay-v2").description("Register a nostr relay profile (pending)")
+    .requiredOption("--id <id>").requiredOption("--owner <owner>").option("--url <url>")
+    .action((o) => { console.log(JSON.stringify(registerNostrRelayV2(o), null, 2)); });
+  nostr.command("activate-relay-v2 <id>").description("Activate relay").action((id) => { console.log(JSON.stringify(activateNostrRelayV2(id), null, 2)); });
+  nostr.command("offline-relay-v2 <id>").description("Mark relay offline").action((id) => { console.log(JSON.stringify(offlineNostrRelayV2(id), null, 2)); });
+  nostr.command("retire-relay-v2 <id>").description("Retire relay (terminal)").action((id) => { console.log(JSON.stringify(retireNostrRelayV2(id), null, 2)); });
+  nostr.command("touch-relay-v2 <id>").description("Refresh lastTouchedAt").action((id) => { console.log(JSON.stringify(touchNostrRelayV2(id), null, 2)); });
+  nostr.command("get-relay-v2 <id>").description("Get a relay").action((id) => { console.log(JSON.stringify(getNostrRelayV2(id), null, 2)); });
+  nostr.command("list-relays-v2").description("List relays").action(() => { console.log(JSON.stringify(listNostrRelaysV2(), null, 2)); });
+  nostr.command("create-event-v2").description("Create a nostr event (queued)")
+    .requiredOption("--id <id>").requiredOption("--relay-id <relayId>").option("--kind <kind>", "event kind", (v) => Number(v))
+    .action((o) => { console.log(JSON.stringify(createNostrEventV2({ id: o.id, relayId: o.relayId, kind: o.kind }), null, 2)); });
+  nostr.command("start-event-v2 <id>").description("Transition event to publishing").action((id) => { console.log(JSON.stringify(startNostrEventV2(id), null, 2)); });
+  nostr.command("publish-event-v2 <id>").description("Transition event to published").action((id) => { console.log(JSON.stringify(publishNostrEventV2(id), null, 2)); });
+  nostr.command("fail-event-v2 <id>").description("Fail event").option("--reason <r>").action((id, o) => { console.log(JSON.stringify(failNostrEventV2(id, o.reason), null, 2)); });
+  nostr.command("cancel-event-v2 <id>").description("Cancel event").option("--reason <r>").action((id, o) => { console.log(JSON.stringify(cancelNostrEventV2(id, o.reason), null, 2)); });
+  nostr.command("get-event-v2 <id>").description("Get event").action((id) => { console.log(JSON.stringify(getNostrEventV2(id), null, 2)); });
+  nostr.command("list-events-v2").description("List events").action(() => { console.log(JSON.stringify(listNostrEventsV2(), null, 2)); });
+  nostr.command("set-max-active-relays-v2 <n>").description("Set per-owner active cap").action((n) => { setMaxActiveNostrRelaysPerOwnerV2(Number(n)); console.log(JSON.stringify({ maxActiveNostrRelaysPerOwner: getMaxActiveNostrRelaysPerOwnerV2() }, null, 2)); });
+  nostr.command("set-max-pending-events-v2 <n>").description("Set per-relay pending cap").action((n) => { setMaxPendingNostrEventsPerRelayV2(Number(n)); console.log(JSON.stringify({ maxPendingNostrEventsPerRelay: getMaxPendingNostrEventsPerRelayV2() }, null, 2)); });
+  nostr.command("set-relay-idle-ms-v2 <n>").description("Set idle threshold").action((n) => { setNostrRelayIdleMsV2(Number(n)); console.log(JSON.stringify({ nostrRelayIdleMs: getNostrRelayIdleMsV2() }, null, 2)); });
+  nostr.command("set-event-stuck-ms-v2 <n>").description("Set stuck threshold").action((n) => { setNostrEventStuckMsV2(Number(n)); console.log(JSON.stringify({ nostrEventStuckMs: getNostrEventStuckMsV2() }, null, 2)); });
+  nostr.command("auto-offline-idle-relays-v2").description("Auto-offline idle relays").action(() => { console.log(JSON.stringify(autoOfflineIdleNostrRelaysV2(), null, 2)); });
+  nostr.command("auto-fail-stuck-events-v2").description("Auto-fail stuck publishing events").action(() => { console.log(JSON.stringify(autoFailStuckNostrEventsV2(), null, 2)); });
+  nostr.command("stats-v2").description("V2 aggregate stats").action(() => { console.log(JSON.stringify(getNostrBridgeStatsV2(), null, 2)); });
 }

package/src/commands/note.js

@@ -14,6 +14,35 @@ import {
   simpleDiff,
   formatDiff,
   revertToVersion,
+  NOTE_MATURITY_V2,
+  REVISION_LIFECYCLE_V2,
+  getMaxActiveNotesPerAuthorV2,
+  setMaxActiveNotesPerAuthorV2,
+  getMaxOpenRevsPerNoteV2,
+  setMaxOpenRevsPerNoteV2,
+  getNoteIdleMsV2,
+  setNoteIdleMsV2,
+  getRevStuckMsV2,
+  setRevStuckMsV2,
+  getActiveNoteCountV2,
+  getOpenRevCountV2,
+  registerNoteV2,
+  getNoteV2,
+  listNotesV2,
+  activateNoteV2,
+  lockNoteV2,
+  archiveNoteV2,
+  touchNoteV2,
+  createRevisionV2,
+  getRevisionV2,
+  listRevisionsV2,
+  reviewRevisionV2,
+  applyRevisionV2,
+  supersedeRevisionV2,
+  discardRevisionV2,
+  autoLockIdleNotesV2,
+  autoDiscardStaleRevisionsV2,
+  getNoteVersioningStatsV2,
 } from "../lib/note-versioning.js";
 
 /**
@@ -486,4 +515,219 @@ export function registerNoteCommand(program) {
         process.exit(1);
       }
     });
+
+  // ─── V2 governance surface ─────────────────────────────────
+
+  note
+    .command("note-maturities-v2")
+    .description("List V2 note maturity states")
+    .action(() => {
+      console.log(JSON.stringify(Object.values(NOTE_MATURITY_V2), null, 2));
+    });
+
+  note
+    .command("revision-lifecycles-v2")
+    .description("List V2 revision lifecycle states")
+    .action(() => {
+      console.log(
+        JSON.stringify(Object.values(REVISION_LIFECYCLE_V2), null, 2),
+      );
+    });
+
+  note
+    .command("stats-v2")
+    .description("Show V2 governance stats")
+    .action(() => {
+      console.log(JSON.stringify(getNoteVersioningStatsV2(), null, 2));
+    });
+
+  note
+    .command("get-max-active-notes-v2")
+    .description("Get max active notes per author")
+    .action(() => console.log(getMaxActiveNotesPerAuthorV2()));
+
+  note
+    .command("set-max-active-notes-v2 <n>")
+    .description("Set max active notes per author")
+    .action((n) => {
+      setMaxActiveNotesPerAuthorV2(Number(n));
+      console.log(getMaxActiveNotesPerAuthorV2());
+    });
+
+  note
+    .command("get-max-open-revs-v2")
+    .description("Get max open revisions per note")
+    .action(() => console.log(getMaxOpenRevsPerNoteV2()));
+
+  note
+    .command("set-max-open-revs-v2 <n>")
+    .description("Set max open revisions per note")
+    .action((n) => {
+      setMaxOpenRevsPerNoteV2(Number(n));
+      console.log(getMaxOpenRevsPerNoteV2());
+    });
+
+  note
+    .command("get-note-idle-ms-v2")
+    .description("Get note idle threshold (ms)")
+    .action(() => console.log(getNoteIdleMsV2()));
+
+  note
+    .command("set-note-idle-ms-v2 <n>")
+    .description("Set note idle threshold (ms)")
+    .action((n) => {
+      setNoteIdleMsV2(Number(n));
+      console.log(getNoteIdleMsV2());
+    });
+
+  note
+    .command("get-rev-stuck-ms-v2")
+    .description("Get revision stuck threshold (ms)")
+    .action(() => console.log(getRevStuckMsV2()));
+
+  note
+    .command("set-rev-stuck-ms-v2 <n>")
+    .description("Set revision stuck threshold (ms)")
+    .action((n) => {
+      setRevStuckMsV2(Number(n));
+      console.log(getRevStuckMsV2());
+    });
+
+  note
+    .command("active-note-count-v2 <authorId>")
+    .description("Count active notes for an author")
+    .action((authorId) => console.log(getActiveNoteCountV2(authorId)));
+
+  note
+    .command("open-rev-count-v2 <noteId>")
+    .description("Count open revisions for a note")
+    .action((noteId) => console.log(getOpenRevCountV2(noteId)));
+
+  note
+    .command("register-note-v2 <id>")
+    .description("Register a V2 note")
+    .requiredOption("-a, --author <authorId>", "Author id")
+    .requiredOption("-t, --title <title>", "Title")
+    .action((id, opts) => {
+      const n = registerNoteV2(id, {
+        authorId: opts.author,
+        title: opts.title,
+      });
+      console.log(JSON.stringify(n, null, 2));
+    });
+
+  note
+    .command("get-note-v2 <id>")
+    .description("Get a V2 note")
+    .action((id) => {
+      const n = getNoteV2(id);
+      console.log(n ? JSON.stringify(n, null, 2) : "null");
+    });
+
+  note
+    .command("list-notes-v2")
+    .description("List V2 notes")
+    .option("-a, --author <authorId>", "Filter by author")
+    .option("-s, --status <status>", "Filter by status")
+    .action((opts) => {
+      console.log(
+        JSON.stringify(
+          listNotesV2({ authorId: opts.author, status: opts.status }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  note
+    .command("activate-note-v2 <id>")
+    .description("draft|locked → active")
+    .action((id) => console.log(JSON.stringify(activateNoteV2(id), null, 2)));
+
+  note
+    .command("lock-note-v2 <id>")
+    .description("active → locked")
+    .action((id) => console.log(JSON.stringify(lockNoteV2(id), null, 2)));
+
+  note
+    .command("archive-note-v2 <id>")
+    .description("→ archived (terminal)")
+    .action((id) => console.log(JSON.stringify(archiveNoteV2(id), null, 2)));
+
+  note
+    .command("touch-note-v2 <id>")
+    .description("Update lastSeenAt")
+    .action((id) => console.log(JSON.stringify(touchNoteV2(id), null, 2)));
+
+  note
+    .command("create-revision-v2 <id>")
+    .description("Create a V2 revision")
+    .requiredOption("-n, --note <noteId>", "Note id")
+    .requiredOption("-s, --summary <summary>", "Summary")
+    .action((id, opts) => {
+      const r = createRevisionV2(id, {
+        noteId: opts.note,
+        summary: opts.summary,
+      });
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  note
+    .command("get-revision-v2 <id>")
+    .description("Get a V2 revision")
+    .action((id) => {
+      const r = getRevisionV2(id);
+      console.log(r ? JSON.stringify(r, null, 2) : "null");
+    });
+
+  note
+    .command("list-revisions-v2")
+    .description("List V2 revisions")
+    .option("-n, --note <noteId>", "Filter by note")
+    .option("-s, --status <status>", "Filter by status")
+    .action((opts) => {
+      console.log(
+        JSON.stringify(
+          listRevisionsV2({ noteId: opts.note, status: opts.status }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  note
+    .command("review-revision-v2 <id>")
+    .description("proposed → reviewed")
+    .action((id) => console.log(JSON.stringify(reviewRevisionV2(id), null, 2)));
+
+  note
+    .command("apply-revision-v2 <id>")
+    .description("reviewed → applied (non-terminal)")
+    .action((id) => console.log(JSON.stringify(applyRevisionV2(id), null, 2)));
+
+  note
+    .command("supersede-revision-v2 <id>")
+    .description("reviewed|applied → superseded (terminal)")
+    .action((id) =>
+      console.log(JSON.stringify(supersedeRevisionV2(id), null, 2)),
+    );
+
+  note
+    .command("discard-revision-v2 <id>")
+    .description("→ discarded (terminal)")
+    .action((id) =>
+      console.log(JSON.stringify(discardRevisionV2(id), null, 2)),
+    );
+
+  note
+    .command("auto-lock-idle-notes-v2")
+    .description("Flip idle active notes → locked")
+    .action(() => console.log(JSON.stringify(autoLockIdleNotesV2(), null, 2)));
+
+  note
+    .command("auto-discard-stale-revisions-v2")
+    .description("Flip stale proposed/reviewed → discarded")
+    .action(() =>
+      console.log(JSON.stringify(autoDiscardStaleRevisionsV2(), null, 2)),
+    );
 }