chainlesschain 0.81.0 → 0.143.0

package/src/commands/export.js

@@ -8,7 +8,41 @@ import ora from "ora";
 import { resolve } from "path";
 import { logger } from "../lib/logger.js";
 import { bootstrap, shutdown } from "../runtime/bootstrap.js";
-import { exportToMarkdown, exportToSite } from "../lib/knowledge-exporter.js";
+import {
+  exportToMarkdown,
+  exportToSite,
+  TARGET_MATURITY_V2,
+  EXPORT_JOB_LIFECYCLE_V2,
+  getMaxActiveTargetsPerOwnerV2,
+  setMaxActiveTargetsPerOwnerV2,
+  getMaxPendingJobsPerTargetV2,
+  setMaxPendingJobsPerTargetV2,
+  getTargetIdleMsV2,
+  setTargetIdleMsV2,
+  getJobStuckMsV2,
+  setJobStuckMsV2,
+  registerTargetV2,
+  getTargetV2,
+  listTargetsV2,
+  setTargetStatusV2,
+  activateTargetV2,
+  pauseTargetV2,
+  archiveTargetV2,
+  touchTargetV2,
+  getActiveTargetCountV2,
+  createExportJobV2,
+  getExportJobV2,
+  listExportJobsV2,
+  setExportJobStatusV2,
+  startExportJobV2,
+  completeExportJobV2,
+  failExportJobV2,
+  cancelExportJobV2,
+  getPendingJobCountV2,
+  autoPauseIdleTargetsV2,
+  autoFailStuckExportJobsV2,
+  getKnowledgeExporterStatsV2,
+} from "../lib/knowledge-exporter.js";
 
 export function registerExportCommand(program) {
   const exp = program
@@ -122,4 +156,225 @@ export function registerExportCommand(program) {
         process.exit(1);
       }
     });
+
+  // ─── 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);
+    }
+  };
+
+  exp
+    .command("target-maturities-v2")
+    .description("List V2 target maturity states")
+    .action(() => out(Object.values(TARGET_MATURITY_V2)));
+
+  exp
+    .command("export-job-lifecycles-v2")
+    .description("List V2 export-job lifecycle states")
+    .action(() => out(Object.values(EXPORT_JOB_LIFECYCLE_V2)));
+
+  exp
+    .command("stats-v2")
+    .description("V2 knowledge-exporter stats")
+    .action(() => out(getKnowledgeExporterStatsV2()));
+
+  exp
+    .command("get-max-active-targets-v2")
+    .description("Get max active targets per owner (V2)")
+    .action(() =>
+      out({ maxActiveTargetsPerOwner: getMaxActiveTargetsPerOwnerV2() }),
+    );
+
+  exp
+    .command("set-max-active-targets-v2 <n>")
+    .description("Set max active targets per owner (V2)")
+    .action((n) =>
+      tryRun(() => {
+        setMaxActiveTargetsPerOwnerV2(Number(n));
+        out({ maxActiveTargetsPerOwner: getMaxActiveTargetsPerOwnerV2() });
+      }),
+    );
+
+  exp
+    .command("get-max-pending-jobs-v2")
+    .description("Get max pending jobs per target (V2)")
+    .action(() =>
+      out({ maxPendingJobsPerTarget: getMaxPendingJobsPerTargetV2() }),
+    );
+
+  exp
+    .command("set-max-pending-jobs-v2 <n>")
+    .description("Set max pending jobs per target (V2)")
+    .action((n) =>
+      tryRun(() => {
+        setMaxPendingJobsPerTargetV2(Number(n));
+        out({ maxPendingJobsPerTarget: getMaxPendingJobsPerTargetV2() });
+      }),
+    );
+
+  exp
+    .command("get-target-idle-ms-v2")
+    .description("Get target idle threshold (V2)")
+    .action(() => out({ targetIdleMs: getTargetIdleMsV2() }));
+
+  exp
+    .command("set-target-idle-ms-v2 <ms>")
+    .description("Set target idle threshold (V2)")
+    .action((ms) =>
+      tryRun(() => {
+        setTargetIdleMsV2(Number(ms));
+        out({ targetIdleMs: getTargetIdleMsV2() });
+      }),
+    );
+
+  exp
+    .command("get-job-stuck-ms-v2")
+    .description("Get export-job stuck threshold (V2)")
+    .action(() => out({ jobStuckMs: getJobStuckMsV2() }));
+
+  exp
+    .command("set-job-stuck-ms-v2 <ms>")
+    .description("Set export-job stuck threshold (V2)")
+    .action((ms) =>
+      tryRun(() => {
+        setJobStuckMsV2(Number(ms));
+        out({ jobStuckMs: getJobStuckMsV2() });
+      }),
+    );
+
+  exp
+    .command("active-target-count-v2 <ownerId>")
+    .description("Active target count for owner (V2)")
+    .action((ownerId) =>
+      out({ ownerId, count: getActiveTargetCountV2(ownerId) }),
+    );
+
+  exp
+    .command("pending-job-count-v2 <targetId>")
+    .description("Pending export-job count for target (V2)")
+    .action((targetId) =>
+      out({ targetId, count: getPendingJobCountV2(targetId) }),
+    );
+
+  exp
+    .command("register-target-v2 <id>")
+    .description("Register a V2 export target")
+    .requiredOption("-o, --owner <id>", "owner id")
+    .requiredOption("-l, --label <label>", "target label")
+    .option("-f, --format <format>", "target format", "markdown")
+    .action((id, opts) =>
+      tryRun(() =>
+        out(
+          registerTargetV2(id, {
+            ownerId: opts.owner,
+            label: opts.label,
+            format: opts.format,
+          }),
+        ),
+      ),
+    );
+
+  exp
+    .command("get-target-v2 <id>")
+    .description("Get a V2 target")
+    .action((id) => out(getTargetV2(id)));
+
+  exp
+    .command("list-targets-v2")
+    .description("List V2 targets")
+    .option("-o, --owner <id>", "filter by owner")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) =>
+      out(listTargetsV2({ ownerId: opts.owner, status: opts.status })),
+    );
+
+  exp
+    .command("set-target-status-v2 <id> <next>")
+    .description("Set V2 target status")
+    .action((id, next) => tryRun(() => out(setTargetStatusV2(id, next))));
+
+  exp
+    .command("activate-target-v2 <id>")
+    .description("Activate a V2 target")
+    .action((id) => tryRun(() => out(activateTargetV2(id))));
+
+  exp
+    .command("pause-target-v2 <id>")
+    .description("Pause a V2 target")
+    .action((id) => tryRun(() => out(pauseTargetV2(id))));
+
+  exp
+    .command("archive-target-v2 <id>")
+    .description("Archive a V2 target")
+    .action((id) => tryRun(() => out(archiveTargetV2(id))));
+
+  exp
+    .command("touch-target-v2 <id>")
+    .description("Touch a V2 target")
+    .action((id) => tryRun(() => out(touchTargetV2(id))));
+
+  exp
+    .command("create-export-job-v2 <id>")
+    .description("Create a V2 export job")
+    .requiredOption("-t, --target <id>", "target id")
+    .option("-k, --kind <kind>", "job kind", "snapshot")
+    .action((id, opts) =>
+      tryRun(() =>
+        out(createExportJobV2(id, { targetId: opts.target, kind: opts.kind })),
+      ),
+    );
+
+  exp
+    .command("get-export-job-v2 <id>")
+    .description("Get a V2 export job")
+    .action((id) => out(getExportJobV2(id)));
+
+  exp
+    .command("list-export-jobs-v2")
+    .description("List V2 export jobs")
+    .option("-t, --target <id>", "filter by target")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) =>
+      out(listExportJobsV2({ targetId: opts.target, status: opts.status })),
+    );
+
+  exp
+    .command("set-export-job-status-v2 <id> <next>")
+    .description("Set V2 export-job status")
+    .action((id, next) => tryRun(() => out(setExportJobStatusV2(id, next))));
+
+  exp
+    .command("start-export-job-v2 <id>")
+    .description("Start a V2 export job")
+    .action((id) => tryRun(() => out(startExportJobV2(id))));
+
+  exp
+    .command("complete-export-job-v2 <id>")
+    .description("Complete a V2 export job")
+    .action((id) => tryRun(() => out(completeExportJobV2(id))));
+
+  exp
+    .command("fail-export-job-v2 <id>")
+    .description("Fail a V2 export job")
+    .action((id) => tryRun(() => out(failExportJobV2(id))));
+
+  exp
+    .command("cancel-export-job-v2 <id>")
+    .description("Cancel a V2 export job")
+    .action((id) => tryRun(() => out(cancelExportJobV2(id))));
+
+  exp
+    .command("auto-pause-idle-targets-v2")
+    .description("Auto-pause idle V2 targets")
+    .action(() => out(autoPauseIdleTargetsV2()));
+
+  exp
+    .command("auto-fail-stuck-export-jobs-v2")
+    .description("Auto-fail stuck V2 export jobs")
+    .action(() => out(autoFailStuckExportJobsV2()));
 }

package/src/commands/fflag.js

@@ -0,0 +1,178 @@
+/**
+ * Feature Flags V2 governance commands — `cc fflag ...`
+ * 在内存中治理 FF profile（pending/active/paused/archived）+ eval 生命周期。
+ */
+import {
+  FFLAG_PROFILE_MATURITY_V2,
+  FFLAG_EVAL_LIFECYCLE_V2,
+  registerFflagProfileV2,
+  activateFflagProfileV2,
+  pauseFflagProfileV2,
+  archiveFflagProfileV2,
+  touchFflagProfileV2,
+  getFflagProfileV2,
+  listFflagProfilesV2,
+  createFflagEvalV2,
+  evaluatingFflagEvalV2,
+  evaluateFflagEvalV2,
+  failFflagEvalV2,
+  cancelFflagEvalV2,
+  getFflagEvalV2,
+  listFflagEvalsV2,
+  setMaxActiveFflagProfilesPerOwnerV2,
+  getMaxActiveFflagProfilesPerOwnerV2,
+  setMaxPendingFflagEvalsPerProfileV2,
+  getMaxPendingFflagEvalsPerProfileV2,
+  setFflagProfileIdleMsV2,
+  getFflagProfileIdleMsV2,
+  setFflagEvalStuckMsV2,
+  getFflagEvalStuckMsV2,
+  autoPauseIdleFflagProfilesV2,
+  autoFailStuckFflagEvalsV2,
+  getFeatureFlagsGovStatsV2,
+} from "../lib/feature-flags.js";
+
+export function registerFflagCommand(program) {
+  const fflag = program
+    .command("fflag")
+    .description("Feature Flags V2 governance (in-memory, CLI v0.143.0)");
+
+  fflag
+    .command("enums-v2")
+    .description("Show V2 maturity + lifecycle enums")
+    .action(() => {
+      console.log(
+        JSON.stringify(
+          { FFLAG_PROFILE_MATURITY_V2, FFLAG_EVAL_LIFECYCLE_V2 },
+          null,
+          2,
+        ),
+      );
+    });
+
+  fflag
+    .command("register-profile-v2")
+    .description("Register a feature flag profile (pending)")
+    .requiredOption("--id <id>")
+    .requiredOption("--owner <owner>")
+    .option("--scope <scope>", "scope tag", "*")
+    .action((o) => console.log(JSON.stringify(registerFflagProfileV2(o), null, 2)));
+  fflag
+    .command("activate-profile-v2 <id>")
+    .description("Transition profile to active")
+    .action((id) => console.log(JSON.stringify(activateFflagProfileV2(id), null, 2)));
+  fflag
+    .command("pause-profile-v2 <id>")
+    .description("Transition profile to paused")
+    .action((id) => console.log(JSON.stringify(pauseFflagProfileV2(id), null, 2)));
+  fflag
+    .command("archive-profile-v2 <id>")
+    .description("Transition profile to archived (terminal)")
+    .action((id) => console.log(JSON.stringify(archiveFflagProfileV2(id), null, 2)));
+  fflag
+    .command("touch-profile-v2 <id>")
+    .description("Refresh lastTouchedAt")
+    .action((id) => console.log(JSON.stringify(touchFflagProfileV2(id), null, 2)));
+  fflag
+    .command("get-profile-v2 <id>")
+    .description("Get a profile by id")
+    .action((id) => console.log(JSON.stringify(getFflagProfileV2(id), null, 2)));
+  fflag
+    .command("list-profiles-v2")
+    .description("List all profiles")
+    .action(() => console.log(JSON.stringify(listFflagProfilesV2(), null, 2)));
+
+  fflag
+    .command("create-eval-v2")
+    .description("Create an eval (queued)")
+    .requiredOption("--id <id>")
+    .requiredOption("--profile-id <profileId>")
+    .option("--key <key>", "flag key", "")
+    .action((o) =>
+      console.log(JSON.stringify(createFflagEvalV2(o), null, 2)),
+    );
+  fflag
+    .command("evaluating-eval-v2 <id>")
+    .description("Mark eval as evaluating")
+    .action((id) => console.log(JSON.stringify(evaluatingFflagEvalV2(id), null, 2)));
+  fflag
+    .command("evaluate-eval-v2 <id>")
+    .description("Mark eval as evaluated (terminal)")
+    .action((id) => console.log(JSON.stringify(evaluateFflagEvalV2(id), null, 2)));
+  fflag
+    .command("fail-eval-v2 <id>")
+    .description("Mark eval as failed (terminal)")
+    .option("--reason <reason>")
+    .action((id, o) => console.log(JSON.stringify(failFflagEvalV2(id, o.reason), null, 2)));
+  fflag
+    .command("cancel-eval-v2 <id>")
+    .description("Mark eval as cancelled (terminal)")
+    .option("--reason <reason>")
+    .action((id, o) => console.log(JSON.stringify(cancelFflagEvalV2(id, o.reason), null, 2)));
+  fflag
+    .command("get-eval-v2 <id>")
+    .description("Get an eval by id")
+    .action((id) => console.log(JSON.stringify(getFflagEvalV2(id), null, 2)));
+  fflag
+    .command("list-evals-v2")
+    .description("List all evals")
+    .action(() => console.log(JSON.stringify(listFflagEvalsV2(), null, 2)));
+
+  fflag
+    .command("config-v2")
+    .description("Show V2 config (caps + idle/stuck windows)")
+    .action(() => {
+      console.log(
+        JSON.stringify(
+          {
+            maxActiveFflagProfilesPerOwner: getMaxActiveFflagProfilesPerOwnerV2(),
+            maxPendingFflagEvalsPerProfile: getMaxPendingFflagEvalsPerProfileV2(),
+            fflagProfileIdleMs: getFflagProfileIdleMsV2(),
+            fflagEvalStuckMs: getFflagEvalStuckMsV2(),
+          },
+          null,
+          2,
+        ),
+      );
+    });
+  fflag
+    .command("set-max-active-profiles-v2 <n>")
+    .description("Set max active profiles per owner")
+    .action((n) => {
+      setMaxActiveFflagProfilesPerOwnerV2(Number(n));
+      console.log(JSON.stringify({ maxActiveFflagProfilesPerOwner: getMaxActiveFflagProfilesPerOwnerV2() }, null, 2));
+    });
+  fflag
+    .command("set-max-pending-evals-v2 <n>")
+    .description("Set max pending evals per profile")
+    .action((n) => {
+      setMaxPendingFflagEvalsPerProfileV2(Number(n));
+      console.log(JSON.stringify({ maxPendingFflagEvalsPerProfile: getMaxPendingFflagEvalsPerProfileV2() }, null, 2));
+    });
+  fflag
+    .command("set-profile-idle-ms-v2 <ms>")
+    .description("Set profile idle window")
+    .action((ms) => {
+      setFflagProfileIdleMsV2(Number(ms));
+      console.log(JSON.stringify({ fflagProfileIdleMs: getFflagProfileIdleMsV2() }, null, 2));
+    });
+  fflag
+    .command("set-eval-stuck-ms-v2 <ms>")
+    .description("Set eval stuck window")
+    .action((ms) => {
+      setFflagEvalStuckMsV2(Number(ms));
+      console.log(JSON.stringify({ fflagEvalStuckMs: getFflagEvalStuckMsV2() }, null, 2));
+    });
+  fflag
+    .command("auto-pause-idle-v2")
+    .description("Auto-pause idle active profiles")
+    .action(() => console.log(JSON.stringify(autoPauseIdleFflagProfilesV2(), null, 2)));
+  fflag
+    .command("auto-fail-stuck-v2")
+    .description("Auto-fail stuck evaluating evals")
+    .action(() => console.log(JSON.stringify(autoFailStuckFflagEvalsV2(), null, 2)));
+  fflag
+    .command("gov-stats-v2")
+    .description("Show V2 governance stats")
+    .action(() => console.log(JSON.stringify(getFeatureFlagsGovStatsV2(), null, 2)));
+}