chainlesschain 0.81.0 → 0.143.0

package/src/commands/skill.js

@@ -11,7 +11,41 @@ import ora from "ora";
 import fs from "fs";
 import path from "path";
 import { logger } from "../lib/logger.js";
-import { CLISkillLoader, LAYER_NAMES } from "../lib/skill-loader.js";
+import {
+  CLISkillLoader,
+  LAYER_NAMES,
+  SKILL_MATURITY_V2,
+  EXECUTION_LIFECYCLE_V2,
+  getMaxActiveSkillsPerOwnerV2,
+  setMaxActiveSkillsPerOwnerV2,
+  getMaxPendingExecutionsPerSkillV2,
+  setMaxPendingExecutionsPerSkillV2,
+  getSkillIdleMsV2,
+  setSkillIdleMsV2,
+  getExecStuckMsV2,
+  setExecStuckMsV2,
+  registerSkillV2,
+  getSkillV2,
+  listSkillsV2,
+  setSkillStatusV2,
+  activateSkillV2,
+  deprecateSkillV2,
+  archiveSkillV2,
+  touchSkillV2,
+  getActiveSkillCountV2,
+  createExecutionV2,
+  getExecutionV2,
+  listExecutionsV2,
+  setExecutionStatusV2,
+  startExecutionV2,
+  succeedExecutionV2,
+  failExecutionV2,
+  cancelExecutionV2,
+  getPendingExecutionCountV2,
+  autoDeprecateIdleSkillsV2,
+  autoFailStuckExecutionsV2,
+  getSkillLoaderStatsV2,
+} from "../lib/skill-loader.js";
 import { getElectronUserDataDir } from "../lib/paths.js";
 import { findProjectRoot } from "../lib/project-detector.js";
 import {
@@ -695,4 +729,236 @@ export function registerSkillCommand(program) {
         `  ${chalk.bold("Total:")} ${allSkills.length} skills resolved\n`,
       );
     });
+
+  // ─── V2 Governance Layer ──────────────────────────────────────────
+  const out = (obj) => console.log(JSON.stringify(obj, null, 2));
+  const tryRun = (fn) => {
+    try {
+      fn();
+    } catch (err) {
+      logger.error(err.message);
+      process.exit(1);
+    }
+  };
+
+  skill
+    .command("skill-maturities-v2")
+    .description("List V2 skill maturity states")
+    .action(() => out(Object.values(SKILL_MATURITY_V2)));
+
+  skill
+    .command("execution-lifecycles-v2")
+    .description("List V2 execution lifecycle states")
+    .action(() => out(Object.values(EXECUTION_LIFECYCLE_V2)));
+
+  skill
+    .command("stats-v2")
+    .description("V2 skill-loader stats")
+    .action(() => out(getSkillLoaderStatsV2()));
+
+  skill
+    .command("get-max-active-skills-v2")
+    .description("Get max active skills per owner (V2)")
+    .action(() =>
+      out({ maxActiveSkillsPerOwner: getMaxActiveSkillsPerOwnerV2() }),
+    );
+
+  skill
+    .command("set-max-active-skills-v2 <n>")
+    .description("Set max active skills per owner (V2)")
+    .action((n) =>
+      tryRun(() => {
+        setMaxActiveSkillsPerOwnerV2(Number(n));
+        out({ maxActiveSkillsPerOwner: getMaxActiveSkillsPerOwnerV2() });
+      }),
+    );
+
+  skill
+    .command("get-max-pending-executions-v2")
+    .description("Get max pending executions per skill (V2)")
+    .action(() =>
+      out({
+        maxPendingExecutionsPerSkill: getMaxPendingExecutionsPerSkillV2(),
+      }),
+    );
+
+  skill
+    .command("set-max-pending-executions-v2 <n>")
+    .description("Set max pending executions per skill (V2)")
+    .action((n) =>
+      tryRun(() => {
+        setMaxPendingExecutionsPerSkillV2(Number(n));
+        out({
+          maxPendingExecutionsPerSkill: getMaxPendingExecutionsPerSkillV2(),
+        });
+      }),
+    );
+
+  skill
+    .command("get-skill-idle-ms-v2")
+    .description("Get skill idle threshold (V2)")
+    .action(() => out({ skillIdleMs: getSkillIdleMsV2() }));
+
+  skill
+    .command("set-skill-idle-ms-v2 <ms>")
+    .description("Set skill idle threshold (V2)")
+    .action((ms) =>
+      tryRun(() => {
+        setSkillIdleMsV2(Number(ms));
+        out({ skillIdleMs: getSkillIdleMsV2() });
+      }),
+    );
+
+  skill
+    .command("get-exec-stuck-ms-v2")
+    .description("Get execution stuck threshold (V2)")
+    .action(() => out({ execStuckMs: getExecStuckMsV2() }));
+
+  skill
+    .command("set-exec-stuck-ms-v2 <ms>")
+    .description("Set execution stuck threshold (V2)")
+    .action((ms) =>
+      tryRun(() => {
+        setExecStuckMsV2(Number(ms));
+        out({ execStuckMs: getExecStuckMsV2() });
+      }),
+    );
+
+  skill
+    .command("active-skill-count-v2 <ownerId>")
+    .description("Active skill count for owner (V2)")
+    .action((ownerId) =>
+      out({ ownerId, count: getActiveSkillCountV2(ownerId) }),
+    );
+
+  skill
+    .command("pending-execution-count-v2 <skillId>")
+    .description("Pending execution count for skill (V2)")
+    .action((skillId) =>
+      out({ skillId, count: getPendingExecutionCountV2(skillId) }),
+    );
+
+  skill
+    .command("register-skill-v2 <id>")
+    .description("Register a V2 skill")
+    .requiredOption("-o, --owner <id>", "owner id")
+    .requiredOption("-n, --name <name>", "skill name")
+    .option("-l, --layer <layer>", "skill layer", "workspace")
+    .action((id, opts) =>
+      tryRun(() =>
+        out(
+          registerSkillV2(id, {
+            ownerId: opts.owner,
+            name: opts.name,
+            layer: opts.layer,
+          }),
+        ),
+      ),
+    );
+
+  skill
+    .command("get-skill-v2 <id>")
+    .description("Get a V2 skill")
+    .action((id) => out(getSkillV2(id)));
+
+  skill
+    .command("list-skills-v2")
+    .description("List V2 skills")
+    .option("-o, --owner <id>", "filter by owner")
+    .option("-s, --status <status>", "filter by status")
+    .option("-l, --layer <layer>", "filter by layer")
+    .action((opts) =>
+      out(
+        listSkillsV2({
+          ownerId: opts.owner,
+          status: opts.status,
+          layer: opts.layer,
+        }),
+      ),
+    );
+
+  skill
+    .command("set-skill-status-v2 <id> <next>")
+    .description("Set V2 skill status")
+    .action((id, next) => tryRun(() => out(setSkillStatusV2(id, next))));
+
+  skill
+    .command("activate-skill-v2 <id>")
+    .description("Activate a V2 skill")
+    .action((id) => tryRun(() => out(activateSkillV2(id))));
+
+  skill
+    .command("deprecate-skill-v2 <id>")
+    .description("Deprecate a V2 skill")
+    .action((id) => tryRun(() => out(deprecateSkillV2(id))));
+
+  skill
+    .command("archive-skill-v2 <id>")
+    .description("Archive a V2 skill")
+    .action((id) => tryRun(() => out(archiveSkillV2(id))));
+
+  skill
+    .command("touch-skill-v2 <id>")
+    .description("Touch a V2 skill")
+    .action((id) => tryRun(() => out(touchSkillV2(id))));
+
+  skill
+    .command("create-execution-v2 <id>")
+    .description("Create a V2 execution")
+    .requiredOption("-s, --skill <id>", "skill id")
+    .option("-k, --kind <kind>", "execution kind", "invoke")
+    .action((id, opts) =>
+      tryRun(() =>
+        out(createExecutionV2(id, { skillId: opts.skill, kind: opts.kind })),
+      ),
+    );
+
+  skill
+    .command("get-execution-v2 <id>")
+    .description("Get a V2 execution")
+    .action((id) => out(getExecutionV2(id)));
+
+  skill
+    .command("list-executions-v2")
+    .description("List V2 executions")
+    .option("-s, --skill <id>", "filter by skill")
+    .option("-t, --status <status>", "filter by status")
+    .action((opts) =>
+      out(listExecutionsV2({ skillId: opts.skill, status: opts.status })),
+    );
+
+  skill
+    .command("set-execution-status-v2 <id> <next>")
+    .description("Set V2 execution status")
+    .action((id, next) => tryRun(() => out(setExecutionStatusV2(id, next))));
+
+  skill
+    .command("start-execution-v2 <id>")
+    .description("Start a V2 execution")
+    .action((id) => tryRun(() => out(startExecutionV2(id))));
+
+  skill
+    .command("succeed-execution-v2 <id>")
+    .description("Succeed a V2 execution")
+    .action((id) => tryRun(() => out(succeedExecutionV2(id))));
+
+  skill
+    .command("fail-execution-v2 <id>")
+    .description("Fail a V2 execution")
+    .action((id) => tryRun(() => out(failExecutionV2(id))));
+
+  skill
+    .command("cancel-execution-v2 <id>")
+    .description("Cancel a V2 execution")
+    .action((id) => tryRun(() => out(cancelExecutionV2(id))));
+
+  skill
+    .command("auto-deprecate-idle-skills-v2")
+    .description("Auto-deprecate idle V2 skills")
+    .action(() => out(autoDeprecateIdleSkillsV2()));
+
+  skill
+    .command("auto-fail-stuck-executions-v2")
+    .description("Auto-fail stuck V2 executions")
+    .action(() => out(autoFailStuckExecutionsV2()));
 }

package/src/commands/slotfill.js

@@ -0,0 +1,41 @@
+/**
+ * `cc slotfill` — Slot Filler V2 governance overlay (in-memory, atop lib/slot-filler.js).
+ */
+import {
+  SLOTF_PROFILE_MATURITY_V2, SLOTF_FILL_LIFECYCLE_V2,
+  setMaxActiveSlotfTemplatesPerOwnerV2, getMaxActiveSlotfTemplatesPerOwnerV2,
+  setMaxPendingSlotfFillsPerTemplateV2, getMaxPendingSlotfFillsPerTemplateV2,
+  setSlotfTemplateIdleMsV2, getSlotfTemplateIdleMsV2,
+  setSlotfFillStuckMsV2, getSlotfFillStuckMsV2,
+  registerSlotfTemplateV2, activateSlotfTemplateV2, staleSlotfTemplateV2, archiveSlotfTemplateV2, touchSlotfTemplateV2, getSlotfTemplateV2, listSlotfTemplatesV2,
+  createSlotfFillV2, fillingSlotfFillV2, fillSlotfFillV2, failSlotfFillV2, cancelSlotfFillV2, getSlotfFillV2, listSlotfFillsV2,
+  autoStaleIdleSlotfTemplatesV2, autoFailStuckSlotfFillsV2, getSlotFillerGovStatsV2, _resetStateSlotFillerV2,
+} from "../lib/slot-filler.js";
+
+export function registerSlotfillCommand(program) {
+  const sf = program.command("slotfill").description("Slot Filler V2 governance");
+  sf.command("enums-v2").action(() => console.log(JSON.stringify({ profileMaturity: SLOTF_PROFILE_MATURITY_V2, fillLifecycle: SLOTF_FILL_LIFECYCLE_V2 }, null, 2)));
+  sf.command("config-v2").action(() => console.log(JSON.stringify({ maxActiveSlotfTemplatesPerOwner: getMaxActiveSlotfTemplatesPerOwnerV2(), maxPendingSlotfFillsPerTemplate: getMaxPendingSlotfFillsPerTemplateV2(), slotfTemplateIdleMs: getSlotfTemplateIdleMsV2(), slotfFillStuckMs: getSlotfFillStuckMsV2() }, null, 2)));
+  sf.command("set-max-active-v2 <n>").action((n) => { setMaxActiveSlotfTemplatesPerOwnerV2(Number(n)); console.log("ok"); });
+  sf.command("set-max-pending-v2 <n>").action((n) => { setMaxPendingSlotfFillsPerTemplateV2(Number(n)); console.log("ok"); });
+  sf.command("set-idle-ms-v2 <n>").action((n) => { setSlotfTemplateIdleMsV2(Number(n)); console.log("ok"); });
+  sf.command("set-stuck-ms-v2 <n>").action((n) => { setSlotfFillStuckMsV2(Number(n)); console.log("ok"); });
+  sf.command("register-template-v2 <id> <owner>").option("--schema <s>", "schema").action((id, owner, o) => console.log(JSON.stringify(registerSlotfTemplateV2({ id, owner, schema: o.schema }), null, 2)));
+  sf.command("activate-template-v2 <id>").action((id) => console.log(JSON.stringify(activateSlotfTemplateV2(id), null, 2)));
+  sf.command("stale-template-v2 <id>").action((id) => console.log(JSON.stringify(staleSlotfTemplateV2(id), null, 2)));
+  sf.command("archive-template-v2 <id>").action((id) => console.log(JSON.stringify(archiveSlotfTemplateV2(id), null, 2)));
+  sf.command("touch-template-v2 <id>").action((id) => console.log(JSON.stringify(touchSlotfTemplateV2(id), null, 2)));
+  sf.command("get-template-v2 <id>").action((id) => console.log(JSON.stringify(getSlotfTemplateV2(id), null, 2)));
+  sf.command("list-templates-v2").action(() => console.log(JSON.stringify(listSlotfTemplatesV2(), null, 2)));
+  sf.command("create-fill-v2 <id> <templateId>").option("--input <s>", "input").action((id, templateId, o) => console.log(JSON.stringify(createSlotfFillV2({ id, templateId, input: o.input }), null, 2)));
+  sf.command("filling-fill-v2 <id>").action((id) => console.log(JSON.stringify(fillingSlotfFillV2(id), null, 2)));
+  sf.command("fill-fill-v2 <id>").action((id) => console.log(JSON.stringify(fillSlotfFillV2(id), null, 2)));
+  sf.command("fail-fill-v2 <id> [reason]").action((id, reason) => console.log(JSON.stringify(failSlotfFillV2(id, reason), null, 2)));
+  sf.command("cancel-fill-v2 <id> [reason]").action((id, reason) => console.log(JSON.stringify(cancelSlotfFillV2(id, reason), null, 2)));
+  sf.command("get-fill-v2 <id>").action((id) => console.log(JSON.stringify(getSlotfFillV2(id), null, 2)));
+  sf.command("list-fills-v2").action(() => console.log(JSON.stringify(listSlotfFillsV2(), null, 2)));
+  sf.command("auto-stale-idle-v2").action(() => console.log(JSON.stringify(autoStaleIdleSlotfTemplatesV2(), null, 2)));
+  sf.command("auto-fail-stuck-v2").action(() => console.log(JSON.stringify(autoFailStuckSlotfFillsV2(), null, 2)));
+  sf.command("gov-stats-v2").action(() => console.log(JSON.stringify(getSlotFillerGovStatsV2(), null, 2)));
+  sf.command("reset-state-v2").action(() => { _resetStateSlotFillerV2(); console.log(JSON.stringify({ ok: true }, null, 2)); });
+}

package/src/commands/social.js

@@ -23,6 +23,35 @@ import {
   getChatMessages,
   getChatThreads,
   getSocialStats,
+  RELATIONSHIP_MATURITY_V2,
+  THREAD_LIFECYCLE_V2,
+  getMaxConnectedPerUserV2,
+  setMaxConnectedPerUserV2,
+  getMaxOpenThreadsPerUserV2,
+  setMaxOpenThreadsPerUserV2,
+  getRelationshipIdleMsV2,
+  setRelationshipIdleMsV2,
+  getThreadStuckMsV2,
+  setThreadStuckMsV2,
+  getConnectedCountV2,
+  getOpenThreadCountV2,
+  registerRelationshipV2,
+  getRelationshipV2,
+  listRelationshipsV2,
+  connectRelationshipV2,
+  muteRelationshipV2,
+  blockRelationshipV2,
+  touchRelationshipV2,
+  createThreadV2,
+  getThreadV2,
+  listThreadsV2,
+  engageThreadV2,
+  resolveThreadV2,
+  abandonThreadV2,
+  reportThreadV2,
+  autoMuteIdleRelationshipsV2,
+  autoAbandonStuckThreadsV2,
+  getSocialManagerStatsV2,
 } from "../lib/social-manager.js";
 import { classifyTopic, detectLanguage } from "../lib/topic-classifier.js";
 import {
@@ -34,6 +63,14 @@ import {
   loadFromDb as graphLoadFromDb,
   subscribe as graphSubscribe,
   EDGE_TYPES,
+  SG_NODE_MATURITY_V2, SG_EDGE_LIFECYCLE_V2,
+  setMaxActiveSgNodesPerOwnerV2, getMaxActiveSgNodesPerOwnerV2,
+  setMaxPendingSgEdgesPerNodeV2, getMaxPendingSgEdgesPerNodeV2,
+  setSgNodeIdleMsV2, getSgNodeIdleMsV2,
+  setSgEdgeStuckMsV2, getSgEdgeStuckMsV2,
+  registerSgNodeV2, activateSgNodeV2, deactivateSgNodeV2, removeSgNodeV2, touchSgNodeV2, getSgNodeV2, listSgNodesV2,
+  createSgEdgeV2, establishSgEdgeV2, severSgEdgeV2, expireSgEdgeV2, cancelSgEdgeV2, getSgEdgeV2, listSgEdgesV2,
+  autoDeactivateIdleSgNodesV2, autoExpireStaleSgEdgesV2, getSocialGraphGovStatsV2, _resetStateSocialGraphV2,
 } from "../lib/social-graph.js";
 import {
   METRICS as ANALYTICS_METRICS,
@@ -1053,4 +1090,257 @@ export function registerSocialCommand(program) {
         process.exit(1);
       }
     });
+
+  // ─────────────────────────────────────────────────────────────
+  // V2 Surface — relationship + thread lifecycle (in-memory, throwing)
+  // ─────────────────────────────────────────────────────────────
+
+  social
+    .command("relationship-maturities-v2")
+    .description("List V2 relationship maturity states")
+    .option("--json", "Output as JSON")
+    .action((options) => {
+      const v = Object.values(RELATIONSHIP_MATURITY_V2);
+      if (options.json) console.log(JSON.stringify(v));
+      else logger.log(v.join(", "));
+    });
+
+  social
+    .command("thread-lifecycles-v2")
+    .description("List V2 thread lifecycle states")
+    .option("--json", "Output as JSON")
+    .action((options) => {
+      const v = Object.values(THREAD_LIFECYCLE_V2);
+      if (options.json) console.log(JSON.stringify(v));
+      else logger.log(v.join(", "));
+    });
+
+  social
+    .command("stats-v2")
+    .description("Show V2 social stats")
+    .option("--json", "Output as JSON")
+    .action((options) => {
+      const stats = getSocialManagerStatsV2();
+      if (options.json) console.log(JSON.stringify(stats, null, 2));
+      else logger.log(JSON.stringify(stats, null, 2));
+    });
+
+  social
+    .command("get-max-connected-v2")
+    .description("Get max connected per user")
+    .action(() => logger.log(String(getMaxConnectedPerUserV2())));
+  social
+    .command("set-max-connected-v2 <n>")
+    .description("Set max connected per user")
+    .action((n) => {
+      setMaxConnectedPerUserV2(Number(n));
+      logger.log(String(getMaxConnectedPerUserV2()));
+    });
+  social
+    .command("get-max-open-threads-v2")
+    .description("Get max open threads per user")
+    .action(() => logger.log(String(getMaxOpenThreadsPerUserV2())));
+  social
+    .command("set-max-open-threads-v2 <n>")
+    .description("Set max open threads per user")
+    .action((n) => {
+      setMaxOpenThreadsPerUserV2(Number(n));
+      logger.log(String(getMaxOpenThreadsPerUserV2()));
+    });
+  social
+    .command("get-relationship-idle-ms-v2")
+    .description("Get relationship idle ms")
+    .action(() => logger.log(String(getRelationshipIdleMsV2())));
+  social
+    .command("set-relationship-idle-ms-v2 <ms>")
+    .description("Set relationship idle ms")
+    .action((ms) => {
+      setRelationshipIdleMsV2(Number(ms));
+      logger.log(String(getRelationshipIdleMsV2()));
+    });
+  social
+    .command("get-thread-stuck-ms-v2")
+    .description("Get thread stuck ms")
+    .action(() => logger.log(String(getThreadStuckMsV2())));
+  social
+    .command("set-thread-stuck-ms-v2 <ms>")
+    .description("Set thread stuck ms")
+    .action((ms) => {
+      setThreadStuckMsV2(Number(ms));
+      logger.log(String(getThreadStuckMsV2()));
+    });
+
+  social
+    .command("connected-count-v2 <userId>")
+    .description("Count connected relationships for user")
+    .action((userId) => logger.log(String(getConnectedCountV2(userId))));
+  social
+    .command("open-thread-count-v2 <userId>")
+    .description("Count open+engaged threads for user")
+    .action((userId) => logger.log(String(getOpenThreadCountV2(userId))));
+
+  social
+    .command("register-relationship-v2 <id>")
+    .description("Register V2 relationship (initial=pending)")
+    .requiredOption("-u, --user <userId>", "user id")
+    .requiredOption("-p, --peer <peerId>", "peer id")
+    .option("-m, --metadata <json>", "metadata JSON", "{}")
+    .action((id, opts) => {
+      const meta = JSON.parse(opts.metadata);
+      const r = registerRelationshipV2(id, {
+        userId: opts.user,
+        peerId: opts.peer,
+        metadata: meta,
+      });
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  social
+    .command("get-relationship-v2 <id>")
+    .description("Get V2 relationship by id")
+    .action((id) => {
+      const r = getRelationshipV2(id);
+      if (!r) {
+        logger.error(`relationship ${id} not found`);
+        process.exit(1);
+      }
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  social
+    .command("list-relationships-v2")
+    .description("List V2 relationships")
+    .option("-u, --user <userId>", "filter by user")
+    .option("-s, --status <state>", "filter by status")
+    .action((opts) => {
+      const out = listRelationshipsV2({
+        userId: opts.user,
+        status: opts.status,
+      });
+      console.log(JSON.stringify(out, null, 2));
+    });
+
+  social
+    .command("connect-relationship-v2 <id>")
+    .description("Transition relationship → connected")
+    .action((id) =>
+      console.log(JSON.stringify(connectRelationshipV2(id), null, 2)),
+    );
+  social
+    .command("mute-relationship-v2 <id>")
+    .description("Transition relationship → muted")
+    .action((id) =>
+      console.log(JSON.stringify(muteRelationshipV2(id), null, 2)),
+    );
+  social
+    .command("block-relationship-v2 <id>")
+    .description("Transition relationship → blocked (terminal)")
+    .action((id) =>
+      console.log(JSON.stringify(blockRelationshipV2(id), null, 2)),
+    );
+  social
+    .command("touch-relationship-v2 <id>")
+    .description("Update relationship lastSeenAt")
+    .action((id) =>
+      console.log(JSON.stringify(touchRelationshipV2(id), null, 2)),
+    );
+
+  social
+    .command("create-thread-v2 <id>")
+    .description("Create V2 thread (initial=open)")
+    .requiredOption("-u, --user <userId>", "user id")
+    .requiredOption("-t, --topic <topic>", "topic")
+    .option("-m, --metadata <json>", "metadata JSON", "{}")
+    .action((id, opts) => {
+      const meta = JSON.parse(opts.metadata);
+      const t = createThreadV2(id, {
+        userId: opts.user,
+        topic: opts.topic,
+        metadata: meta,
+      });
+      console.log(JSON.stringify(t, null, 2));
+    });
+
+  social
+    .command("get-thread-v2 <id>")
+    .description("Get V2 thread by id")
+    .action((id) => {
+      const t = getThreadV2(id);
+      if (!t) {
+        logger.error(`thread ${id} not found`);
+        process.exit(1);
+      }
+      console.log(JSON.stringify(t, null, 2));
+    });
+
+  social
+    .command("list-threads-v2")
+    .description("List V2 threads")
+    .option("-u, --user <userId>", "filter by user")
+    .option("-s, --status <state>", "filter by status")
+    .action((opts) => {
+      const out = listThreadsV2({
+        userId: opts.user,
+        status: opts.status,
+      });
+      console.log(JSON.stringify(out, null, 2));
+    });
+
+  social
+    .command("engage-thread-v2 <id>")
+    .description("Transition thread → engaged")
+    .action((id) => console.log(JSON.stringify(engageThreadV2(id), null, 2)));
+  social
+    .command("resolve-thread-v2 <id>")
+    .description("Transition thread → resolved (terminal)")
+    .action((id) => console.log(JSON.stringify(resolveThreadV2(id), null, 2)));
+  social
+    .command("abandon-thread-v2 <id>")
+    .description("Transition thread → abandoned (terminal)")
+    .action((id) => console.log(JSON.stringify(abandonThreadV2(id), null, 2)));
+  social
+    .command("report-thread-v2 <id>")
+    .description("Transition thread → reported (terminal)")
+    .action((id) => console.log(JSON.stringify(reportThreadV2(id), null, 2)));
+
+  social
+    .command("auto-mute-idle-rel-v2")
+    .description("Auto-mute idle connected relationships; output flipped")
+    .action(() => {
+      const flipped = autoMuteIdleRelationshipsV2();
+      console.log(JSON.stringify(flipped, null, 2));
+    });
+  social
+    .command("auto-abandon-stuck-threads-v2")
+    .description("Auto-abandon stuck threads; output flipped")
+    .action(() => {
+      const flipped = autoAbandonStuckThreadsV2();
+      console.log(JSON.stringify(flipped, null, 2));
+    });
+
+  // ===== Social Graph V2 governance overlay (sg-*-v2 prefix) =====
+  social.command("sg-enums-v2").action(() => console.log(JSON.stringify({ nodeMaturity: SG_NODE_MATURITY_V2, edgeLifecycle: SG_EDGE_LIFECYCLE_V2 }, null, 2)));
+  social.command("sg-config-v2").action(() => console.log(JSON.stringify({ maxActiveSgNodesPerOwner: getMaxActiveSgNodesPerOwnerV2(), maxPendingSgEdgesPerNode: getMaxPendingSgEdgesPerNodeV2(), sgNodeIdleMs: getSgNodeIdleMsV2(), sgEdgeStuckMs: getSgEdgeStuckMsV2() }, null, 2)));
+  social.command("sg-set-max-active-v2 <n>").action((n) => { setMaxActiveSgNodesPerOwnerV2(Number(n)); console.log("ok"); });
+  social.command("sg-set-max-pending-v2 <n>").action((n) => { setMaxPendingSgEdgesPerNodeV2(Number(n)); console.log("ok"); });
+  social.command("sg-set-idle-ms-v2 <n>").action((n) => { setSgNodeIdleMsV2(Number(n)); console.log("ok"); });
+  social.command("sg-set-stuck-ms-v2 <n>").action((n) => { setSgEdgeStuckMsV2(Number(n)); console.log("ok"); });
+  social.command("sg-register-node-v2 <id> <owner>").option("--handle <h>", "handle").action((id, owner, o) => console.log(JSON.stringify(registerSgNodeV2({ id, owner, handle: o.handle }), null, 2)));
+  social.command("sg-activate-node-v2 <id>").action((id) => console.log(JSON.stringify(activateSgNodeV2(id), null, 2)));
+  social.command("sg-deactivate-node-v2 <id>").action((id) => console.log(JSON.stringify(deactivateSgNodeV2(id), null, 2)));
+  social.command("sg-remove-node-v2 <id>").action((id) => console.log(JSON.stringify(removeSgNodeV2(id), null, 2)));
+  social.command("sg-touch-node-v2 <id>").action((id) => console.log(JSON.stringify(touchSgNodeV2(id), null, 2)));
+  social.command("sg-get-node-v2 <id>").action((id) => console.log(JSON.stringify(getSgNodeV2(id), null, 2)));
+  social.command("sg-list-nodes-v2").action(() => console.log(JSON.stringify(listSgNodesV2(), null, 2)));
+  social.command("sg-create-edge-v2 <id> <nodeId>").option("--target <t>", "targetId").action((id, nodeId, o) => console.log(JSON.stringify(createSgEdgeV2({ id, nodeId, targetId: o.target }), null, 2)));
+  social.command("sg-establish-edge-v2 <id>").action((id) => console.log(JSON.stringify(establishSgEdgeV2(id), null, 2)));
+  social.command("sg-sever-edge-v2 <id> [reason]").action((id, reason) => console.log(JSON.stringify(severSgEdgeV2(id, reason), null, 2)));
+  social.command("sg-expire-edge-v2 <id>").action((id) => console.log(JSON.stringify(expireSgEdgeV2(id), null, 2)));
+  social.command("sg-cancel-edge-v2 <id> [reason]").action((id, reason) => console.log(JSON.stringify(cancelSgEdgeV2(id, reason), null, 2)));
+  social.command("sg-get-edge-v2 <id>").action((id) => console.log(JSON.stringify(getSgEdgeV2(id), null, 2)));
+  social.command("sg-list-edges-v2").action(() => console.log(JSON.stringify(listSgEdgesV2(), null, 2)));
+  social.command("sg-auto-deactivate-idle-v2").action(() => console.log(JSON.stringify(autoDeactivateIdleSgNodesV2(), null, 2)));
+  social.command("sg-auto-expire-stale-v2").action(() => console.log(JSON.stringify(autoExpireStaleSgEdgesV2(), null, 2)));
+  social.command("sg-gov-stats-v2").action(() => console.log(JSON.stringify(getSocialGraphGovStatsV2(), null, 2)));
+  social.command("sg-reset-state-v2").action(() => { _resetStateSocialGraphV2(); console.log(JSON.stringify({ ok: true }, null, 2)); });
 }