chainlesschain 0.66.0 → 0.132.0

package/src/commands/mcp.js

@@ -804,4 +804,225 @@ export function registerMcpCommand(program) {
         logger.log(`  ${chalk.cyan(c)} ${chalk.dim(`(${count})`)}`);
       }
     });
+
+  // ===== V2 governance subcommands (mcp-registry V2) =====
+  mcp
+    .command("server-maturities-v2")
+    .description("List MCP server maturity states (V2)")
+    .action(async () => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.MCP_SERVER_MATURITY_V2, null, 2));
+    });
+  mcp
+    .command("invocation-lifecycle-v2")
+    .description("List MCP invocation lifecycle states (V2)")
+    .action(async () => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.MCP_INVOCATION_LIFECYCLE_V2, null, 2));
+    });
+  mcp
+    .command("stats-v2")
+    .description("Show MCP registry V2 stats")
+    .action(async () => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.getMcpRegistryStatsV2(), null, 2));
+    });
+  mcp
+    .command("config-v2")
+    .description("Show MCP registry V2 config")
+    .action(async () => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(
+        JSON.stringify(
+          {
+            maxActiveServersPerOwner: m.getMaxActiveServersPerOwnerV2(),
+            maxPendingInvocationsPerServer:
+              m.getMaxPendingInvocationsPerServerV2(),
+            serverIdleMs: m.getServerIdleMsV2(),
+            invocationStuckMs: m.getInvocationStuckMsV2(),
+          },
+          null,
+          2,
+        ),
+      );
+    });
+  mcp
+    .command("register-server-v2 <id> <owner> <endpoint>")
+    .description("Register an MCP server (V2)")
+    .action(async (id, owner, endpoint) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(
+        JSON.stringify(m.registerServerV2({ id, owner, endpoint }), null, 2),
+      );
+    });
+  mcp
+    .command("activate-server-v2 <id>")
+    .description("Activate an MCP server (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.activateServerV2(id), null, 2));
+    });
+  mcp
+    .command("degrade-server-v2 <id>")
+    .description("Degrade an MCP server (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.degradeServerV2(id), null, 2));
+    });
+  mcp
+    .command("retire-server-v2 <id>")
+    .description("Retire an MCP server (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.retireServerV2(id), null, 2));
+    });
+  mcp
+    .command("touch-server-v2 <id>")
+    .description("Touch an MCP server (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.touchServerV2(id), null, 2));
+    });
+  mcp
+    .command("get-server-v2 <id>")
+    .description("Get an MCP server (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.getServerV2(id), null, 2));
+    });
+  mcp
+    .command("list-servers-v2")
+    .description("List MCP servers (V2)")
+    .action(async () => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.listServersV2(), null, 2));
+    });
+  mcp
+    .command("create-invocation-v2 <id> <serverId> <tool>")
+    .description("Create an MCP invocation (V2)")
+    .action(async (id, serverId, tool) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(
+        JSON.stringify(m.createInvocationV2({ id, serverId, tool }), null, 2),
+      );
+    });
+  mcp
+    .command("dispatch-invocation-v2 <id>")
+    .description("Dispatch an MCP invocation (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.dispatchInvocationV2(id), null, 2));
+    });
+  mcp
+    .command("complete-invocation-v2 <id>")
+    .description("Complete an MCP invocation (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.completeInvocationV2(id), null, 2));
+    });
+  mcp
+    .command("fail-invocation-v2 <id> [reason]")
+    .description("Fail an MCP invocation (V2)")
+    .action(async (id, reason) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.failInvocationV2(id, reason), null, 2));
+    });
+  mcp
+    .command("cancel-invocation-v2 <id> [reason]")
+    .description("Cancel an MCP invocation (V2)")
+    .action(async (id, reason) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.cancelInvocationV2(id, reason), null, 2));
+    });
+  mcp
+    .command("get-invocation-v2 <id>")
+    .description("Get an MCP invocation (V2)")
+    .action(async (id) => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.getInvocationV2(id), null, 2));
+    });
+  mcp
+    .command("list-invocations-v2")
+    .description("List MCP invocations (V2)")
+    .action(async () => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.listInvocationsV2(), null, 2));
+    });
+  mcp
+    .command("auto-degrade-idle-servers-v2")
+    .description("Auto-degrade idle MCP servers (V2)")
+    .action(async () => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.autoDegradeIdleServersV2(), null, 2));
+    });
+  mcp
+    .command("auto-fail-stuck-invocations-v2")
+    .description("Auto-fail stuck MCP invocations (V2)")
+    .action(async () => {
+      const m = await import("../lib/mcp-registry.js");
+      console.log(JSON.stringify(m.autoFailStuckInvocationsV2(), null, 2));
+    });
+  mcp
+    .command("set-max-active-servers-v2 <n>")
+    .description("Set max active servers per owner (V2)")
+    .action(async (n) => {
+      const m = await import("../lib/mcp-registry.js");
+      m.setMaxActiveServersPerOwnerV2(parseInt(n, 10));
+      console.log(
+        JSON.stringify(
+          { maxActiveServersPerOwner: m.getMaxActiveServersPerOwnerV2() },
+          null,
+          2,
+        ),
+      );
+    });
+  mcp
+    .command("set-max-pending-invocations-v2 <n>")
+    .description("Set max pending invocations per server (V2)")
+    .action(async (n) => {
+      const m = await import("../lib/mcp-registry.js");
+      m.setMaxPendingInvocationsPerServerV2(parseInt(n, 10));
+      console.log(
+        JSON.stringify(
+          {
+            maxPendingInvocationsPerServer:
+              m.getMaxPendingInvocationsPerServerV2(),
+          },
+          null,
+          2,
+        ),
+      );
+    });
+  mcp
+    .command("set-server-idle-ms-v2 <n>")
+    .description("Set MCP server idle timeout in ms (V2)")
+    .action(async (n) => {
+      const m = await import("../lib/mcp-registry.js");
+      m.setServerIdleMsV2(parseInt(n, 10));
+      console.log(
+        JSON.stringify({ serverIdleMs: m.getServerIdleMsV2() }, null, 2),
+      );
+    });
+  mcp
+    .command("set-invocation-stuck-ms-v2 <n>")
+    .description("Set MCP invocation stuck timeout in ms (V2)")
+    .action(async (n) => {
+      const m = await import("../lib/mcp-registry.js");
+      m.setInvocationStuckMsV2(parseInt(n, 10));
+      console.log(
+        JSON.stringify(
+          { invocationStuckMs: m.getInvocationStuckMsV2() },
+          null,
+          2,
+        ),
+      );
+    });
+  mcp
+    .command("reset-state-v2")
+    .description("Reset MCP registry V2 in-memory state")
+    .action(async () => {
+      const m = await import("../lib/mcp-registry.js");
+      m._resetStateMcpRegistryV2();
+      console.log(JSON.stringify({ ok: true }, null, 2));
+    });
 }

package/src/commands/memory.js

@@ -17,6 +17,35 @@ import {
   listDailyNotes,
   getMemoryFile,
   updateMemoryFile,
+  ENTRY_MATURITY_V2,
+  CONSOLIDATION_LIFECYCLE_V2,
+  getMaxActiveEntriesPerCategoryV2,
+  setMaxActiveEntriesPerCategoryV2,
+  getMaxRunningJobsPerSourceV2,
+  setMaxRunningJobsPerSourceV2,
+  getEntryIdleMsV2,
+  setEntryIdleMsV2,
+  getJobStuckMsV2,
+  setJobStuckMsV2,
+  getActiveEntryCountV2,
+  getRunningJobCountV2,
+  registerEntryV2,
+  getEntryV2,
+  listEntriesV2,
+  activateEntryV2,
+  parkEntryV2,
+  archiveEntryV2,
+  touchEntryV2,
+  createConsolidationJobV2,
+  getConsolidationJobV2,
+  listConsolidationJobsV2,
+  startConsolidationJobV2,
+  succeedConsolidationJobV2,
+  failConsolidationJobV2,
+  cancelConsolidationJobV2,
+  autoParkIdleEntriesV2,
+  autoFailStuckJobsV2,
+  getMemoryManagerStatsV2,
 } from "../lib/memory-manager.js";
 
 export function registerMemoryCommand(program) {
@@ -454,4 +483,223 @@ export function registerMemoryCommand(program) {
         process.exit(1);
       }
     });
+
+  // ─── V2 governance surface ─────────────────────────────────
+
+  memory
+    .command("entry-maturities-v2")
+    .description("List V2 entry maturity states")
+    .action(() => {
+      console.log(JSON.stringify(Object.values(ENTRY_MATURITY_V2), null, 2));
+    });
+
+  memory
+    .command("consolidation-lifecycles-v2")
+    .description("List V2 consolidation job lifecycle states")
+    .action(() => {
+      console.log(
+        JSON.stringify(Object.values(CONSOLIDATION_LIFECYCLE_V2), null, 2),
+      );
+    });
+
+  memory
+    .command("stats-v2")
+    .description("Show V2 governance stats")
+    .action(() => {
+      console.log(JSON.stringify(getMemoryManagerStatsV2(), null, 2));
+    });
+
+  memory
+    .command("get-max-active-entries-v2")
+    .description("Get max active entries per category")
+    .action(() => console.log(getMaxActiveEntriesPerCategoryV2()));
+
+  memory
+    .command("set-max-active-entries-v2 <n>")
+    .description("Set max active entries per category")
+    .action((n) => {
+      setMaxActiveEntriesPerCategoryV2(Number(n));
+      console.log(getMaxActiveEntriesPerCategoryV2());
+    });
+
+  memory
+    .command("get-max-running-jobs-v2")
+    .description("Get max running jobs per source")
+    .action(() => console.log(getMaxRunningJobsPerSourceV2()));
+
+  memory
+    .command("set-max-running-jobs-v2 <n>")
+    .description("Set max running jobs per source")
+    .action((n) => {
+      setMaxRunningJobsPerSourceV2(Number(n));
+      console.log(getMaxRunningJobsPerSourceV2());
+    });
+
+  memory
+    .command("get-entry-idle-ms-v2")
+    .description("Get entry idle threshold (ms)")
+    .action(() => console.log(getEntryIdleMsV2()));
+
+  memory
+    .command("set-entry-idle-ms-v2 <n>")
+    .description("Set entry idle threshold (ms)")
+    .action((n) => {
+      setEntryIdleMsV2(Number(n));
+      console.log(getEntryIdleMsV2());
+    });
+
+  memory
+    .command("get-job-stuck-ms-v2")
+    .description("Get job stuck threshold (ms)")
+    .action(() => console.log(getJobStuckMsV2()));
+
+  memory
+    .command("set-job-stuck-ms-v2 <n>")
+    .description("Set job stuck threshold (ms)")
+    .action((n) => {
+      setJobStuckMsV2(Number(n));
+      console.log(getJobStuckMsV2());
+    });
+
+  memory
+    .command("active-entry-count-v2 <category>")
+    .description("Count active entries for a category")
+    .action((category) => console.log(getActiveEntryCountV2(category)));
+
+  memory
+    .command("running-job-count-v2 <source>")
+    .description("Count running jobs for a source")
+    .action((source) => console.log(getRunningJobCountV2(source)));
+
+  memory
+    .command("register-entry-v2 <id>")
+    .description("Register a V2 entry")
+    .requiredOption("-c, --category <category>", "Category")
+    .requiredOption("-s, --summary <summary>", "Summary")
+    .action((id, opts) => {
+      const e = registerEntryV2(id, {
+        category: opts.category,
+        summary: opts.summary,
+      });
+      console.log(JSON.stringify(e, null, 2));
+    });
+
+  memory
+    .command("get-entry-v2 <id>")
+    .description("Get a V2 entry")
+    .action((id) => {
+      const e = getEntryV2(id);
+      console.log(e ? JSON.stringify(e, null, 2) : "null");
+    });
+
+  memory
+    .command("list-entries-v2")
+    .description("List V2 entries")
+    .option("-c, --category <category>", "Filter by category")
+    .option("-s, --status <status>", "Filter by status")
+    .action((opts) => {
+      console.log(
+        JSON.stringify(
+          listEntriesV2({ category: opts.category, status: opts.status }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  memory
+    .command("activate-entry-v2 <id>")
+    .description("pending|parked → active")
+    .action((id) => console.log(JSON.stringify(activateEntryV2(id), null, 2)));
+
+  memory
+    .command("park-entry-v2 <id>")
+    .description("active → parked")
+    .action((id) => console.log(JSON.stringify(parkEntryV2(id), null, 2)));
+
+  memory
+    .command("archive-entry-v2 <id>")
+    .description("→ archived (terminal)")
+    .action((id) => console.log(JSON.stringify(archiveEntryV2(id), null, 2)));
+
+  memory
+    .command("touch-entry-v2 <id>")
+    .description("Update lastSeenAt")
+    .action((id) => console.log(JSON.stringify(touchEntryV2(id), null, 2)));
+
+  memory
+    .command("create-job-v2 <id>")
+    .description("Create a V2 consolidation job")
+    .requiredOption("-s, --source <source>", "Source")
+    .requiredOption("-c, --scope <scope>", "Scope")
+    .action((id, opts) => {
+      const j = createConsolidationJobV2(id, {
+        source: opts.source,
+        scope: opts.scope,
+      });
+      console.log(JSON.stringify(j, null, 2));
+    });
+
+  memory
+    .command("get-job-v2 <id>")
+    .description("Get a V2 consolidation job")
+    .action((id) => {
+      const j = getConsolidationJobV2(id);
+      console.log(j ? JSON.stringify(j, null, 2) : "null");
+    });
+
+  memory
+    .command("list-jobs-v2")
+    .description("List V2 consolidation jobs")
+    .option("-s, --source <source>", "Filter by source")
+    .option("--status <status>", "Filter by status")
+    .action((opts) => {
+      console.log(
+        JSON.stringify(
+          listConsolidationJobsV2({ source: opts.source, status: opts.status }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  memory
+    .command("start-job-v2 <id>")
+    .description("queued → running")
+    .action((id) =>
+      console.log(JSON.stringify(startConsolidationJobV2(id), null, 2)),
+    );
+
+  memory
+    .command("succeed-job-v2 <id>")
+    .description("running → succeeded (terminal)")
+    .action((id) =>
+      console.log(JSON.stringify(succeedConsolidationJobV2(id), null, 2)),
+    );
+
+  memory
+    .command("fail-job-v2 <id>")
+    .description("running → failed (terminal)")
+    .action((id) =>
+      console.log(JSON.stringify(failConsolidationJobV2(id), null, 2)),
+    );
+
+  memory
+    .command("cancel-job-v2 <id>")
+    .description("queued|running → cancelled (terminal)")
+    .action((id) =>
+      console.log(JSON.stringify(cancelConsolidationJobV2(id), null, 2)),
+    );
+
+  memory
+    .command("auto-park-idle-entries-v2")
+    .description("Flip idle active entries → parked")
+    .action(() =>
+      console.log(JSON.stringify(autoParkIdleEntriesV2(), null, 2)),
+    );
+
+  memory
+    .command("auto-fail-stuck-jobs-v2")
+    .description("Flip stuck running jobs → failed")
+    .action(() => console.log(JSON.stringify(autoFailStuckJobsV2(), null, 2)));
 }