chainlesschain 0.132.0 → 0.145.0

package/src/commands/seshu.js

@@ -0,0 +1,160 @@
+/**
+ * `cc seshu` — Session Usage V2 governance overlay (in-memory, atop lib/session-usage.js).
+ */
+import {
+  SUSE_BUDGET_MATURITY_V2,
+  SUSE_RECORD_LIFECYCLE_V2,
+  setMaxActiveSuseBudgetsPerOwnerV2,
+  getMaxActiveSuseBudgetsPerOwnerV2,
+  setMaxPendingSuseRecordsPerBudgetV2,
+  getMaxPendingSuseRecordsPerBudgetV2,
+  setSuseBudgetIdleMsV2,
+  getSuseBudgetIdleMsV2,
+  setSuseRecordStuckMsV2,
+  getSuseRecordStuckMsV2,
+  registerSuseBudgetV2,
+  activateSuseBudgetV2,
+  exhaustSuseBudgetV2,
+  archiveSuseBudgetV2,
+  touchSuseBudgetV2,
+  getSuseBudgetV2,
+  listSuseBudgetsV2,
+  createSuseRecordV2,
+  recordingSuseRecordV2,
+  recordSuseRecordV2,
+  rejectSuseRecordV2,
+  cancelSuseRecordV2,
+  getSuseRecordV2,
+  listSuseRecordsV2,
+  autoExhaustIdleSuseBudgetsV2,
+  autoRejectStuckSuseRecordsV2,
+  getSessionUsageGovStatsV2,
+  _resetStateSessionUsageV2,
+} from "../lib/session-usage.js";
+
+export function registerSeshuCommand(program) {
+  const su = program
+    .command("seshu")
+    .description("Session Usage V2 governance");
+  su.command("enums-v2").action(() =>
+    console.log(
+      JSON.stringify(
+        {
+          budgetMaturity: SUSE_BUDGET_MATURITY_V2,
+          recordLifecycle: SUSE_RECORD_LIFECYCLE_V2,
+        },
+        null,
+        2,
+      ),
+    ),
+  );
+  su.command("config-v2").action(() =>
+    console.log(
+      JSON.stringify(
+        {
+          maxActiveSuseBudgetsPerOwner: getMaxActiveSuseBudgetsPerOwnerV2(),
+          maxPendingSuseRecordsPerBudget: getMaxPendingSuseRecordsPerBudgetV2(),
+          suseBudgetIdleMs: getSuseBudgetIdleMsV2(),
+          suseRecordStuckMs: getSuseRecordStuckMsV2(),
+        },
+        null,
+        2,
+      ),
+    ),
+  );
+  su.command("set-max-active-v2 <n>").action((n) => {
+    setMaxActiveSuseBudgetsPerOwnerV2(Number(n));
+    console.log("ok");
+  });
+  su.command("set-max-pending-v2 <n>").action((n) => {
+    setMaxPendingSuseRecordsPerBudgetV2(Number(n));
+    console.log("ok");
+  });
+  su.command("set-idle-ms-v2 <n>").action((n) => {
+    setSuseBudgetIdleMsV2(Number(n));
+    console.log("ok");
+  });
+  su.command("set-stuck-ms-v2 <n>").action((n) => {
+    setSuseRecordStuckMsV2(Number(n));
+    console.log("ok");
+  });
+  su.command("register-budget-v2 <id> <owner>")
+    .option("--limit <n>", "limit")
+    .action((id, owner, o) =>
+      console.log(
+        JSON.stringify(
+          registerSuseBudgetV2({
+            id,
+            owner,
+            limit: o.limit ? Number(o.limit) : undefined,
+          }),
+          null,
+          2,
+        ),
+      ),
+    );
+  su.command("activate-budget-v2 <id>").action((id) =>
+    console.log(JSON.stringify(activateSuseBudgetV2(id), null, 2)),
+  );
+  su.command("exhaust-budget-v2 <id>").action((id) =>
+    console.log(JSON.stringify(exhaustSuseBudgetV2(id), null, 2)),
+  );
+  su.command("archive-budget-v2 <id>").action((id) =>
+    console.log(JSON.stringify(archiveSuseBudgetV2(id), null, 2)),
+  );
+  su.command("touch-budget-v2 <id>").action((id) =>
+    console.log(JSON.stringify(touchSuseBudgetV2(id), null, 2)),
+  );
+  su.command("get-budget-v2 <id>").action((id) =>
+    console.log(JSON.stringify(getSuseBudgetV2(id), null, 2)),
+  );
+  su.command("list-budgets-v2").action(() =>
+    console.log(JSON.stringify(listSuseBudgetsV2(), null, 2)),
+  );
+  su.command("create-record-v2 <id> <budgetId>")
+    .option("--amount <n>", "amount")
+    .action((id, budgetId, o) =>
+      console.log(
+        JSON.stringify(
+          createSuseRecordV2({
+            id,
+            budgetId,
+            amount: o.amount ? Number(o.amount) : undefined,
+          }),
+          null,
+          2,
+        ),
+      ),
+    );
+  su.command("recording-record-v2 <id>").action((id) =>
+    console.log(JSON.stringify(recordingSuseRecordV2(id), null, 2)),
+  );
+  su.command("record-record-v2 <id>").action((id) =>
+    console.log(JSON.stringify(recordSuseRecordV2(id), null, 2)),
+  );
+  su.command("reject-record-v2 <id> [reason]").action((id, reason) =>
+    console.log(JSON.stringify(rejectSuseRecordV2(id, reason), null, 2)),
+  );
+  su.command("cancel-record-v2 <id> [reason]").action((id, reason) =>
+    console.log(JSON.stringify(cancelSuseRecordV2(id, reason), null, 2)),
+  );
+  su.command("get-record-v2 <id>").action((id) =>
+    console.log(JSON.stringify(getSuseRecordV2(id), null, 2)),
+  );
+  su.command("list-records-v2").action(() =>
+    console.log(JSON.stringify(listSuseRecordsV2(), null, 2)),
+  );
+  su.command("auto-exhaust-idle-v2").action(() =>
+    console.log(JSON.stringify(autoExhaustIdleSuseBudgetsV2(), null, 2)),
+  );
+  su.command("auto-reject-stuck-v2").action(() =>
+    console.log(JSON.stringify(autoRejectStuckSuseRecordsV2(), null, 2)),
+  );
+  su.command("gov-stats-v2").action(() =>
+    console.log(JSON.stringify(getSessionUsageGovStatsV2(), null, 2)),
+  );
+  su.command("reset-state-v2").action(() => {
+    _resetStateSessionUsageV2();
+    console.log(JSON.stringify({ ok: true }, null, 2));
+  });
+}

package/src/commands/sganal.js

@@ -0,0 +1,172 @@
+/**
+ * Social Graph Analytics V2 governance commands — `cc sganal ...`
+ * 在内存中治理 SGAN profile (pending/active/stale/archived) + run 生命周期。
+ */
+import {
+  SGAN_PROFILE_MATURITY_V2,
+  SGAN_RUN_LIFECYCLE_V2,
+  registerSganProfileV2,
+  activateSganProfileV2,
+  staleSganProfileV2,
+  archiveSganProfileV2,
+  touchSganProfileV2,
+  getSganProfileV2,
+  listSganProfilesV2,
+  createSganRunV2,
+  runningSganRunV2,
+  completeSganRunV2,
+  failSganRunV2,
+  cancelSganRunV2,
+  getSganRunV2,
+  listSganRunsV2,
+  setMaxActiveSganProfilesPerOwnerV2,
+  getMaxActiveSganProfilesPerOwnerV2,
+  setMaxPendingSganRunsPerProfileV2,
+  getMaxPendingSganRunsPerProfileV2,
+  setSganProfileIdleMsV2,
+  getSganProfileIdleMsV2,
+  setSganRunStuckMsV2,
+  getSganRunStuckMsV2,
+  autoStaleIdleSganProfilesV2,
+  autoFailStuckSganRunsV2,
+  getSocialGraphAnalyticsGovStatsV2,
+} from "../lib/social-graph-analytics.js";
+
+export function registerSganalCommand(program) {
+  const s = program
+    .command("sganal")
+    .description(
+      "Social Graph Analytics V2 governance (in-memory, CLI v0.143.0)",
+    );
+
+  s.command("enums-v2").action(() =>
+    console.log(
+      JSON.stringify(
+        { SGAN_PROFILE_MATURITY_V2, SGAN_RUN_LIFECYCLE_V2 },
+        null,
+        2,
+      ),
+    ),
+  );
+  s.command("register-profile-v2")
+    .requiredOption("--id <id>")
+    .requiredOption("--owner <owner>")
+    .option("--algorithm <algorithm>", "graph algorithm", "centrality")
+    .action((o) =>
+      console.log(JSON.stringify(registerSganProfileV2(o), null, 2)),
+    );
+  s.command("activate-profile-v2 <id>").action((id) =>
+    console.log(JSON.stringify(activateSganProfileV2(id), null, 2)),
+  );
+  s.command("stale-profile-v2 <id>").action((id) =>
+    console.log(JSON.stringify(staleSganProfileV2(id), null, 2)),
+  );
+  s.command("archive-profile-v2 <id>").action((id) =>
+    console.log(JSON.stringify(archiveSganProfileV2(id), null, 2)),
+  );
+  s.command("touch-profile-v2 <id>").action((id) =>
+    console.log(JSON.stringify(touchSganProfileV2(id), null, 2)),
+  );
+  s.command("get-profile-v2 <id>").action((id) =>
+    console.log(JSON.stringify(getSganProfileV2(id), null, 2)),
+  );
+  s.command("list-profiles-v2").action(() =>
+    console.log(JSON.stringify(listSganProfilesV2(), null, 2)),
+  );
+
+  s.command("create-run-v2")
+    .requiredOption("--id <id>")
+    .requiredOption("--profile-id <profileId>")
+    .option("--snapshot-id <sid>", "graph snapshot id", "")
+    .action((o) =>
+      console.log(
+        JSON.stringify(
+          createSganRunV2({
+            id: o.id,
+            profileId: o.profileId,
+            snapshotId: o.snapshotId,
+          }),
+          null,
+          2,
+        ),
+      ),
+    );
+  s.command("running-run-v2 <id>").action((id) =>
+    console.log(JSON.stringify(runningSganRunV2(id), null, 2)),
+  );
+  s.command("complete-run-v2 <id>").action((id) =>
+    console.log(JSON.stringify(completeSganRunV2(id), null, 2)),
+  );
+  s.command("fail-run-v2 <id>")
+    .option("--reason <r>")
+    .action((id, o) =>
+      console.log(JSON.stringify(failSganRunV2(id, o.reason), null, 2)),
+    );
+  s.command("cancel-run-v2 <id>")
+    .option("--reason <r>")
+    .action((id, o) =>
+      console.log(JSON.stringify(cancelSganRunV2(id, o.reason), null, 2)),
+    );
+  s.command("get-run-v2 <id>").action((id) =>
+    console.log(JSON.stringify(getSganRunV2(id), null, 2)),
+  );
+  s.command("list-runs-v2").action(() =>
+    console.log(JSON.stringify(listSganRunsV2(), null, 2)),
+  );
+
+  s.command("config-v2").action(() =>
+    console.log(
+      JSON.stringify(
+        {
+          maxActiveSganProfilesPerOwner: getMaxActiveSganProfilesPerOwnerV2(),
+          maxPendingSganRunsPerProfile: getMaxPendingSganRunsPerProfileV2(),
+          sganProfileIdleMs: getSganProfileIdleMsV2(),
+          sganRunStuckMs: getSganRunStuckMsV2(),
+        },
+        null,
+        2,
+      ),
+    ),
+  );
+  s.command("set-max-active-profiles-v2 <n>").action((n) => {
+    setMaxActiveSganProfilesPerOwnerV2(Number(n));
+    console.log(
+      JSON.stringify(
+        { maxActiveSganProfilesPerOwner: getMaxActiveSganProfilesPerOwnerV2() },
+        null,
+        2,
+      ),
+    );
+  });
+  s.command("set-max-pending-runs-v2 <n>").action((n) => {
+    setMaxPendingSganRunsPerProfileV2(Number(n));
+    console.log(
+      JSON.stringify(
+        { maxPendingSganRunsPerProfile: getMaxPendingSganRunsPerProfileV2() },
+        null,
+        2,
+      ),
+    );
+  });
+  s.command("set-profile-idle-ms-v2 <ms>").action((ms) => {
+    setSganProfileIdleMsV2(Number(ms));
+    console.log(
+      JSON.stringify({ sganProfileIdleMs: getSganProfileIdleMsV2() }, null, 2),
+    );
+  });
+  s.command("set-run-stuck-ms-v2 <ms>").action((ms) => {
+    setSganRunStuckMsV2(Number(ms));
+    console.log(
+      JSON.stringify({ sganRunStuckMs: getSganRunStuckMsV2() }, null, 2),
+    );
+  });
+  s.command("auto-stale-idle-v2").action(() =>
+    console.log(JSON.stringify(autoStaleIdleSganProfilesV2(), null, 2)),
+  );
+  s.command("auto-fail-stuck-v2").action(() =>
+    console.log(JSON.stringify(autoFailStuckSganRunsV2(), null, 2)),
+  );
+  s.command("gov-stats-v2").action(() =>
+    console.log(JSON.stringify(getSocialGraphAnalyticsGovStatsV2(), null, 2)),
+  );
+}

package/src/commands/siem.js

@@ -399,4 +399,211 @@ export function registerSiemCommand(program) {
         process.exit(1);
       }
     });
+
+  _registerSiemExporterV2Commands(siem);
+}
+
+function _registerSiemExporterV2Commands(parent) {
+  const L = async () => await import("../lib/siem-exporter.js");
+  parent
+    .command("enums-v2")
+    .description("Show V2 enums (target maturity + export lifecycle)")
+    .action(async () => {
+      const m = await L();
+      console.log(
+        JSON.stringify(
+          {
+            targetMaturity: m.SIEM_TARGET_MATURITY_V2,
+            exportLifecycle: m.SIEM_EXPORT_LIFECYCLE_V2,
+          },
+          null,
+          2,
+        ),
+      );
+    });
+  parent
+    .command("config-v2")
+    .description("Show V2 config thresholds")
+    .action(async () => {
+      const m = await L();
+      console.log(
+        JSON.stringify(
+          {
+            maxActiveSiemTargetsPerOperator:
+              m.getMaxActiveSiemTargetsPerOperatorV2(),
+            maxPendingSiemExportsPerTarget:
+              m.getMaxPendingSiemExportsPerTargetV2(),
+            siemTargetIdleMs: m.getSiemTargetIdleMsV2(),
+            siemExportStuckMs: m.getSiemExportStuckMsV2(),
+          },
+          null,
+          2,
+        ),
+      );
+    });
+  parent
+    .command("set-max-active-targets-v2 <n>")
+    .description("Set max active targets per operator")
+    .action(async (n) => {
+      const m = await L();
+      m.setMaxActiveSiemTargetsPerOperatorV2(Number(n));
+      console.log("ok");
+    });
+  parent
+    .command("set-max-pending-exports-v2 <n>")
+    .description("Set max pending exports per target")
+    .action(async (n) => {
+      const m = await L();
+      m.setMaxPendingSiemExportsPerTargetV2(Number(n));
+      console.log("ok");
+    });
+  parent
+    .command("set-target-idle-ms-v2 <n>")
+    .description("Set target idle threshold (ms)")
+    .action(async (n) => {
+      const m = await L();
+      m.setSiemTargetIdleMsV2(Number(n));
+      console.log("ok");
+    });
+  parent
+    .command("set-export-stuck-ms-v2 <n>")
+    .description("Set export stuck threshold (ms)")
+    .action(async (n) => {
+      const m = await L();
+      m.setSiemExportStuckMsV2(Number(n));
+      console.log("ok");
+    });
+  parent
+    .command("register-target-v2 <id> <operator>")
+    .description("Register V2 SIEM target")
+    .option("--kind <k>", "Target kind")
+    .action(async (id, operator, o) => {
+      const m = await L();
+      console.log(
+        JSON.stringify(
+          m.registerSiemTargetV2({ id, operator, kind: o.kind }),
+          null,
+          2,
+        ),
+      );
+    });
+  parent
+    .command("activate-target-v2 <id>")
+    .description("Activate target")
+    .action(async (id) => {
+      const m = await L();
+      console.log(JSON.stringify(m.activateSiemTargetV2(id), null, 2));
+    });
+  parent
+    .command("degrade-target-v2 <id>")
+    .description("Degrade target")
+    .action(async (id) => {
+      const m = await L();
+      console.log(JSON.stringify(m.degradeSiemTargetV2(id), null, 2));
+    });
+  parent
+    .command("retire-target-v2 <id>")
+    .description("Retire target (terminal)")
+    .action(async (id) => {
+      const m = await L();
+      console.log(JSON.stringify(m.retireSiemTargetV2(id), null, 2));
+    });
+  parent
+    .command("touch-target-v2 <id>")
+    .description("Touch target lastTouchedAt")
+    .action(async (id) => {
+      const m = await L();
+      console.log(JSON.stringify(m.touchSiemTargetV2(id), null, 2));
+    });
+  parent
+    .command("get-target-v2 <id>")
+    .description("Get V2 target")
+    .action(async (id) => {
+      const m = await L();
+      console.log(JSON.stringify(m.getSiemTargetV2(id), null, 2));
+    });
+  parent
+    .command("list-targets-v2")
+    .description("List V2 targets")
+    .action(async () => {
+      const m = await L();
+      console.log(JSON.stringify(m.listSiemTargetsV2(), null, 2));
+    });
+  parent
+    .command("create-export-v2 <id> <targetId>")
+    .description("Create V2 export (queued)")
+    .option("--format <f>", "Format", "json")
+    .action(async (id, targetId, o) => {
+      const m = await L();
+      console.log(
+        JSON.stringify(
+          m.createSiemExportV2({ id, targetId, format: o.format }),
+          null,
+          2,
+        ),
+      );
+    });
+  parent
+    .command("start-export-v2 <id>")
+    .description("Start export")
+    .action(async (id) => {
+      const m = await L();
+      console.log(JSON.stringify(m.startSiemExportV2(id), null, 2));
+    });
+  parent
+    .command("deliver-export-v2 <id>")
+    .description("Deliver export")
+    .action(async (id) => {
+      const m = await L();
+      console.log(JSON.stringify(m.deliverSiemExportV2(id), null, 2));
+    });
+  parent
+    .command("fail-export-v2 <id> [reason]")
+    .description("Fail export")
+    .action(async (id, reason) => {
+      const m = await L();
+      console.log(JSON.stringify(m.failSiemExportV2(id, reason), null, 2));
+    });
+  parent
+    .command("cancel-export-v2 <id> [reason]")
+    .description("Cancel export")
+    .action(async (id, reason) => {
+      const m = await L();
+      console.log(JSON.stringify(m.cancelSiemExportV2(id, reason), null, 2));
+    });
+  parent
+    .command("get-export-v2 <id>")
+    .description("Get V2 export")
+    .action(async (id) => {
+      const m = await L();
+      console.log(JSON.stringify(m.getSiemExportV2(id), null, 2));
+    });
+  parent
+    .command("list-exports-v2")
+    .description("List V2 exports")
+    .action(async () => {
+      const m = await L();
+      console.log(JSON.stringify(m.listSiemExportsV2(), null, 2));
+    });
+  parent
+    .command("auto-degrade-idle-v2")
+    .description("Auto-degrade idle targets")
+    .action(async () => {
+      const m = await L();
+      console.log(JSON.stringify(m.autoDegradeIdleSiemTargetsV2(), null, 2));
+    });
+  parent
+    .command("auto-fail-stuck-v2")
+    .description("Auto-fail stuck sending exports")
+    .action(async () => {
+      const m = await L();
+      console.log(JSON.stringify(m.autoFailStuckSiemExportsV2(), null, 2));
+    });
+  parent
+    .command("gov-stats-v2")
+    .description("V2 governance aggregate stats")
+    .action(async () => {
+      const m = await L();
+      console.log(JSON.stringify(m.getSiemExporterGovStatsV2(), null, 2));
+    });
 }