chainlesschain 0.81.0 → 0.143.0

package/src/commands/permmem.js

@@ -0,0 +1,251 @@
+/**
+ * Permanent Memory V2 commands
+ * `cc permmem ...` — in-memory governance layer for cross-session
+ * pinned knowledge entries + retention jobs.
+ */
+
+import { logger } from "../lib/logger.js";
+import {
+  PIN_MATURITY_V2,
+  RETENTION_JOB_LIFECYCLE_V2,
+  getMaxActivePinsPerOwnerV2,
+  setMaxActivePinsPerOwnerV2,
+  getMaxPendingJobsPerPinV2,
+  setMaxPendingJobsPerPinV2,
+  getPinIdleMsV2,
+  setPinIdleMsV2,
+  getJobStuckMsV2,
+  setJobStuckMsV2,
+  registerPinV2,
+  getPinV2,
+  listPinsV2,
+  setPinStatusV2,
+  activatePinV2,
+  dormantPinV2,
+  archivePinV2,
+  touchPinV2,
+  getActivePinCountV2,
+  createRetentionJobV2,
+  getRetentionJobV2,
+  listRetentionJobsV2,
+  setRetentionJobStatusV2,
+  startRetentionJobV2,
+  completeRetentionJobV2,
+  failRetentionJobV2,
+  cancelRetentionJobV2,
+  getPendingJobCountV2,
+  autoDormantIdlePinsV2,
+  autoFailStuckJobsV2,
+  getPermanentMemoryStatsV2,
+} from "../lib/permanent-memory.js";
+
+const out = (obj) => console.log(JSON.stringify(obj, null, 2));
+const tryRun = (fn) => {
+  try {
+    fn();
+  } catch (err) {
+    logger.error(err.message);
+    process.exit(1);
+  }
+};
+
+export function registerPermMemCommand(program) {
+  const root = program
+    .command("permmem")
+    .description("Permanent memory V2 — pin maturity + retention jobs");
+
+  root
+    .command("pin-maturities-v2")
+    .description("List V2 pin maturity states")
+    .action(() => out(Object.values(PIN_MATURITY_V2)));
+
+  root
+    .command("retention-job-lifecycles-v2")
+    .description("List V2 retention job lifecycle states")
+    .action(() => out(Object.values(RETENTION_JOB_LIFECYCLE_V2)));
+
+  root
+    .command("stats-v2")
+    .description("V2 permanent memory stats")
+    .action(() => out(getPermanentMemoryStatsV2()));
+
+  root
+    .command("get-max-active-pins-v2")
+    .description("Get max active pins per owner (V2)")
+    .action(() => out({ maxActivePinsPerOwner: getMaxActivePinsPerOwnerV2() }));
+
+  root
+    .command("set-max-active-pins-v2 <n>")
+    .description("Set max active pins per owner (V2)")
+    .action((n) =>
+      tryRun(() => {
+        setMaxActivePinsPerOwnerV2(Number(n));
+        out({ maxActivePinsPerOwner: getMaxActivePinsPerOwnerV2() });
+      }),
+    );
+
+  root
+    .command("get-max-pending-jobs-v2")
+    .description("Get max pending jobs per pin (V2)")
+    .action(() => out({ maxPendingJobsPerPin: getMaxPendingJobsPerPinV2() }));
+
+  root
+    .command("set-max-pending-jobs-v2 <n>")
+    .description("Set max pending jobs per pin (V2)")
+    .action((n) =>
+      tryRun(() => {
+        setMaxPendingJobsPerPinV2(Number(n));
+        out({ maxPendingJobsPerPin: getMaxPendingJobsPerPinV2() });
+      }),
+    );
+
+  root
+    .command("get-pin-idle-ms-v2")
+    .description("Get pin idle threshold (V2)")
+    .action(() => out({ pinIdleMs: getPinIdleMsV2() }));
+
+  root
+    .command("set-pin-idle-ms-v2 <ms>")
+    .description("Set pin idle threshold (V2)")
+    .action((ms) =>
+      tryRun(() => {
+        setPinIdleMsV2(Number(ms));
+        out({ pinIdleMs: getPinIdleMsV2() });
+      }),
+    );
+
+  root
+    .command("get-job-stuck-ms-v2")
+    .description("Get retention-job stuck threshold (V2)")
+    .action(() => out({ jobStuckMs: getJobStuckMsV2() }));
+
+  root
+    .command("set-job-stuck-ms-v2 <ms>")
+    .description("Set retention-job stuck threshold (V2)")
+    .action((ms) =>
+      tryRun(() => {
+        setJobStuckMsV2(Number(ms));
+        out({ jobStuckMs: getJobStuckMsV2() });
+      }),
+    );
+
+  root
+    .command("active-pin-count-v2 <ownerId>")
+    .description("Active pin count for owner (V2)")
+    .action((ownerId) => out({ ownerId, count: getActivePinCountV2(ownerId) }));
+
+  root
+    .command("pending-job-count-v2 <pinId>")
+    .description("Pending retention-job count for pin (V2)")
+    .action((pinId) => out({ pinId, count: getPendingJobCountV2(pinId) }));
+
+  root
+    .command("register-pin-v2 <id>")
+    .description("Register a V2 pin")
+    .requiredOption("-o, --owner <id>", "owner id")
+    .requiredOption("-l, --label <label>", "pin label")
+    .action((id, opts) =>
+      tryRun(() =>
+        out(registerPinV2(id, { ownerId: opts.owner, label: opts.label })),
+      ),
+    );
+
+  root
+    .command("get-pin-v2 <id>")
+    .description("Get a V2 pin")
+    .action((id) => out(getPinV2(id)));
+
+  root
+    .command("list-pins-v2")
+    .description("List V2 pins")
+    .option("-o, --owner <id>", "filter by owner")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) =>
+      out(listPinsV2({ ownerId: opts.owner, status: opts.status })),
+    );
+
+  root
+    .command("set-pin-status-v2 <id> <next>")
+    .description("Set V2 pin status")
+    .action((id, next) => tryRun(() => out(setPinStatusV2(id, next))));
+
+  root
+    .command("activate-pin-v2 <id>")
+    .description("Activate a V2 pin")
+    .action((id) => tryRun(() => out(activatePinV2(id))));
+
+  root
+    .command("dormant-pin-v2 <id>")
+    .description("Mark V2 pin dormant")
+    .action((id) => tryRun(() => out(dormantPinV2(id))));
+
+  root
+    .command("archive-pin-v2 <id>")
+    .description("Archive a V2 pin")
+    .action((id) => tryRun(() => out(archivePinV2(id))));
+
+  root
+    .command("touch-pin-v2 <id>")
+    .description("Touch a V2 pin")
+    .action((id) => tryRun(() => out(touchPinV2(id))));
+
+  root
+    .command("create-retention-job-v2 <id>")
+    .description("Create a V2 retention job")
+    .requiredOption("-p, --pin <id>", "pin id")
+    .option("-k, --kind <kind>", "job kind", "review")
+    .action((id, opts) =>
+      tryRun(() =>
+        out(createRetentionJobV2(id, { pinId: opts.pin, kind: opts.kind })),
+      ),
+    );
+
+  root
+    .command("get-retention-job-v2 <id>")
+    .description("Get a V2 retention job")
+    .action((id) => out(getRetentionJobV2(id)));
+
+  root
+    .command("list-retention-jobs-v2")
+    .description("List V2 retention jobs")
+    .option("-p, --pin <id>", "filter by pin")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) =>
+      out(listRetentionJobsV2({ pinId: opts.pin, status: opts.status })),
+    );
+
+  root
+    .command("set-retention-job-status-v2 <id> <next>")
+    .description("Set V2 retention job status")
+    .action((id, next) => tryRun(() => out(setRetentionJobStatusV2(id, next))));
+
+  root
+    .command("start-retention-job-v2 <id>")
+    .description("Start a V2 retention job")
+    .action((id) => tryRun(() => out(startRetentionJobV2(id))));
+
+  root
+    .command("complete-retention-job-v2 <id>")
+    .description("Complete a V2 retention job")
+    .action((id) => tryRun(() => out(completeRetentionJobV2(id))));
+
+  root
+    .command("fail-retention-job-v2 <id>")
+    .description("Fail a V2 retention job")
+    .action((id) => tryRun(() => out(failRetentionJobV2(id))));
+
+  root
+    .command("cancel-retention-job-v2 <id>")
+    .description("Cancel a V2 retention job")
+    .action((id) => tryRun(() => out(cancelRetentionJobV2(id))));
+
+  root
+    .command("auto-dormant-idle-pins-v2")
+    .description("Auto-mark dormant idle V2 pins")
+    .action(() => out(autoDormantIdlePinsV2()));
+
+  root
+    .command("auto-fail-stuck-jobs-v2")
+    .description("Auto-fail stuck V2 retention jobs")
+    .action(() => out(autoFailStuckJobsV2()));
+}

package/src/commands/pipeline.js

@@ -445,5 +445,61 @@ export function registerPipelineCommand(program) {
       _json(getStats(db));
     });
 
-  program.addCommand(pipeline);
+  
+  _registerPipelineV2Commands(pipeline);
+program.addCommand(pipeline);
+}
+function _registerPipelineV2Commands(parent) {
+  const L = async () => await import("../lib/pipeline-orchestrator.js");
+
+  parent.command("enums-v2").description("Show V2 enums (pipeline maturity + run lifecycle)")
+    .action(async () => { const m = await L(); console.log(JSON.stringify({ pipelineMaturity: m.PIPELINE_MATURITY_V2, runLifecycle: m.PIPELINE_RUN_LIFECYCLE_V2 }, null, 2)); });
+  parent.command("config-v2").description("Show V2 config thresholds")
+    .action(async () => { const m = await L(); console.log(JSON.stringify({ maxActivePipelinesPerOwner: m.getMaxActivePipelinesPerOwnerV2(), maxPendingPipelineRunsPerPipeline: m.getMaxPendingPipelineRunsPerPipelineV2(), pipelineIdleMs: m.getPipelineIdleMsV2(), pipelineRunStuckMs: m.getPipelineRunStuckMsV2() }, null, 2)); });
+  parent.command("set-max-active-pipelines-v2 <n>").description("Set max active pipelines per owner")
+    .action(async (n) => { const m = await L(); m.setMaxActivePipelinesPerOwnerV2(Number(n)); console.log("ok"); });
+  parent.command("set-max-pending-runs-v2 <n>").description("Set max pending runs per pipeline")
+    .action(async (n) => { const m = await L(); m.setMaxPendingPipelineRunsPerPipelineV2(Number(n)); console.log("ok"); });
+  parent.command("set-pipeline-idle-ms-v2 <n>").description("Set pipeline idle threshold (ms)")
+    .action(async (n) => { const m = await L(); m.setPipelineIdleMsV2(Number(n)); console.log("ok"); });
+  parent.command("set-run-stuck-ms-v2 <n>").description("Set run stuck threshold (ms)")
+    .action(async (n) => { const m = await L(); m.setPipelineRunStuckMsV2(Number(n)); console.log("ok"); });
+
+  parent.command("register-pipeline-v2 <id> <owner>").description("Register V2 pipeline")
+    .option("--name <n>", "Pipeline name").action(async (id, owner, o) => { const m = await L(); console.log(JSON.stringify(m.registerPipelineV2({ id, owner, name: o.name }), null, 2)); });
+  parent.command("activate-pipeline-v2 <id>").description("Activate pipeline")
+    .action(async (id) => { const m = await L(); console.log(JSON.stringify(m.activatePipelineV2(id), null, 2)); });
+  parent.command("pause-pipeline-v2 <id>").description("Pause pipeline")
+    .action(async (id) => { const m = await L(); console.log(JSON.stringify(m.pausePipelineV2(id), null, 2)); });
+  parent.command("archive-pipeline-v2 <id>").description("Archive pipeline (terminal)")
+    .action(async (id) => { const m = await L(); console.log(JSON.stringify(m.archivePipelineV2(id), null, 2)); });
+  parent.command("touch-pipeline-v2 <id>").description("Touch pipeline lastTouchedAt")
+    .action(async (id) => { const m = await L(); console.log(JSON.stringify(m.touchPipelineV2(id), null, 2)); });
+  parent.command("get-pipeline-v2 <id>").description("Get V2 pipeline")
+    .action(async (id) => { const m = await L(); console.log(JSON.stringify(m.getPipelineV2(id), null, 2)); });
+  parent.command("list-pipelines-v2").description("List all V2 pipelines")
+    .action(async () => { const m = await L(); console.log(JSON.stringify(m.listPipelinesV2(), null, 2)); });
+
+  parent.command("create-run-v2 <id> <pipelineId>").description("Create V2 pipeline run (queued)")
+    .option("--trigger <t>", "Trigger", "manual").action(async (id, pipelineId, o) => { const m = await L(); console.log(JSON.stringify(m.createPipelineRunV2({ id, pipelineId, trigger: o.trigger }), null, 2)); });
+  parent.command("start-run-v2 <id>").description("Start run (queued→running)")
+    .action(async (id) => { const m = await L(); console.log(JSON.stringify(m.startPipelineRunV2(id), null, 2)); });
+  parent.command("complete-run-v2 <id>").description("Complete run (running→completed)")
+    .action(async (id) => { const m = await L(); console.log(JSON.stringify(m.completePipelineRunV2(id), null, 2)); });
+  parent.command("fail-run-v2 <id> [reason]").description("Fail run")
+    .action(async (id, reason) => { const m = await L(); console.log(JSON.stringify(m.failPipelineRunV2(id, reason), null, 2)); });
+  parent.command("cancel-run-v2 <id> [reason]").description("Cancel run")
+    .action(async (id, reason) => { const m = await L(); console.log(JSON.stringify(m.cancelPipelineRunV2(id, reason), null, 2)); });
+  parent.command("get-run-v2 <id>").description("Get V2 run")
+    .action(async (id) => { const m = await L(); console.log(JSON.stringify(m.getPipelineRunV2(id), null, 2)); });
+  parent.command("list-runs-v2").description("List all V2 runs")
+    .action(async () => { const m = await L(); console.log(JSON.stringify(m.listPipelineRunsV2(), null, 2)); });
+
+  parent.command("auto-pause-idle-v2").description("Auto-pause idle active pipelines")
+    .action(async () => { const m = await L(); console.log(JSON.stringify(m.autoPauseIdlePipelinesV2(), null, 2)); });
+  parent.command("auto-fail-stuck-v2").description("Auto-fail stuck running runs")
+    .action(async () => { const m = await L(); console.log(JSON.stringify(m.autoFailStuckPipelineRunsV2(), null, 2)); });
+
+  parent.command("gov-stats-v2").description("V2 governance aggregate stats")
+    .action(async () => { const m = await L(); console.log(JSON.stringify(m.getPipelineOrchestratorGovStatsV2(), null, 2)); });
 }

package/src/commands/planmode.js

@@ -0,0 +1,45 @@
+/**
+ * `cc planmode` — Plan Mode V2 governance overlay.
+ *
+ * In-memory governance for plan profiles + step lifecycle, layered atop
+ * `lib/plan-mode.js`. Independent of any legacy plan invocation.
+ */
+
+import {
+  PLAN_PROFILE_MATURITY_V2, PLAN_STEP_LIFECYCLE_V2,
+  setMaxActivePlanProfilesPerOwnerV2, getMaxActivePlanProfilesPerOwnerV2,
+  setMaxPendingPlanStepsPerProfileV2, getMaxPendingPlanStepsPerProfileV2,
+  setPlanProfileIdleMsV2, getPlanProfileIdleMsV2,
+  setPlanStepStuckMsV2, getPlanStepStuckMsV2,
+  registerPlanProfileV2, activatePlanProfileV2, pausePlanProfileV2, archivePlanProfileV2, touchPlanProfileV2, getPlanProfileV2, listPlanProfilesV2,
+  createPlanStepV2, startPlanStepV2, completePlanStepV2, failPlanStepV2, cancelPlanStepV2, getPlanStepV2, listPlanStepsV2,
+  autoPauseIdlePlanProfilesV2, autoFailStuckPlanStepsV2, getPlanModeGovStatsV2, _resetStatePlanModeV2,
+} from "../lib/plan-mode.js";
+
+export function registerPlanModeCommand(program) {
+  const pm = program.command("planmode").description("Plan Mode V2 governance");
+  pm.command("enums-v2").action(() => console.log(JSON.stringify({ profileMaturity: PLAN_PROFILE_MATURITY_V2, stepLifecycle: PLAN_STEP_LIFECYCLE_V2 }, null, 2)));
+  pm.command("config-v2").action(() => console.log(JSON.stringify({ maxActivePlanProfilesPerOwner: getMaxActivePlanProfilesPerOwnerV2(), maxPendingPlanStepsPerProfile: getMaxPendingPlanStepsPerProfileV2(), planProfileIdleMs: getPlanProfileIdleMsV2(), planStepStuckMs: getPlanStepStuckMsV2() }, null, 2)));
+  pm.command("set-max-active-v2 <n>").action((n) => { setMaxActivePlanProfilesPerOwnerV2(Number(n)); console.log("ok"); });
+  pm.command("set-max-pending-v2 <n>").action((n) => { setMaxPendingPlanStepsPerProfileV2(Number(n)); console.log("ok"); });
+  pm.command("set-idle-ms-v2 <n>").action((n) => { setPlanProfileIdleMsV2(Number(n)); console.log("ok"); });
+  pm.command("set-stuck-ms-v2 <n>").action((n) => { setPlanStepStuckMsV2(Number(n)); console.log("ok"); });
+  pm.command("register-profile-v2 <id> <owner>").option("--goal <g>", "goal").action((id, owner, o) => console.log(JSON.stringify(registerPlanProfileV2({ id, owner, goal: o.goal }), null, 2)));
+  pm.command("activate-profile-v2 <id>").action((id) => console.log(JSON.stringify(activatePlanProfileV2(id), null, 2)));
+  pm.command("pause-profile-v2 <id>").action((id) => console.log(JSON.stringify(pausePlanProfileV2(id), null, 2)));
+  pm.command("archive-profile-v2 <id>").action((id) => console.log(JSON.stringify(archivePlanProfileV2(id), null, 2)));
+  pm.command("touch-profile-v2 <id>").action((id) => console.log(JSON.stringify(touchPlanProfileV2(id), null, 2)));
+  pm.command("get-profile-v2 <id>").action((id) => console.log(JSON.stringify(getPlanProfileV2(id), null, 2)));
+  pm.command("list-profiles-v2").action(() => console.log(JSON.stringify(listPlanProfilesV2(), null, 2)));
+  pm.command("create-step-v2 <id> <profileId>").option("--action <a>", "action").action((id, profileId, o) => console.log(JSON.stringify(createPlanStepV2({ id, profileId, action: o.action }), null, 2)));
+  pm.command("start-step-v2 <id>").action((id) => console.log(JSON.stringify(startPlanStepV2(id), null, 2)));
+  pm.command("complete-step-v2 <id>").action((id) => console.log(JSON.stringify(completePlanStepV2(id), null, 2)));
+  pm.command("fail-step-v2 <id> [reason]").action((id, reason) => console.log(JSON.stringify(failPlanStepV2(id, reason), null, 2)));
+  pm.command("cancel-step-v2 <id> [reason]").action((id, reason) => console.log(JSON.stringify(cancelPlanStepV2(id, reason), null, 2)));
+  pm.command("get-step-v2 <id>").action((id) => console.log(JSON.stringify(getPlanStepV2(id), null, 2)));
+  pm.command("list-steps-v2").action(() => console.log(JSON.stringify(listPlanStepsV2(), null, 2)));
+  pm.command("auto-pause-idle-v2").action(() => console.log(JSON.stringify(autoPauseIdlePlanProfilesV2(), null, 2)));
+  pm.command("auto-fail-stuck-v2").action(() => console.log(JSON.stringify(autoFailStuckPlanStepsV2(), null, 2)));
+  pm.command("gov-stats-v2").action(() => console.log(JSON.stringify(getPlanModeGovStatsV2(), null, 2)));
+  pm.command("reset-state-v2").action(() => { _resetStatePlanModeV2(); console.log(JSON.stringify({ ok: true }, null, 2)); });
+}

package/src/commands/plugin-ecosystem.js

@@ -40,6 +40,41 @@ import {
   recommend,
   getConfig,
   getStats,
+  // V2
+  PLUGIN_MATURITY_V2,
+  INSTALL_LIFECYCLE_V2,
+  PLUGIN_DEFAULT_MAX_ACTIVE_PER_DEVELOPER,
+  PLUGIN_DEFAULT_MAX_PENDING_INSTALLS_PER_USER,
+  PLUGIN_DEFAULT_AUTO_DEPRECATE_AFTER_MS,
+  PLUGIN_DEFAULT_AUTO_ARCHIVE_AFTER_MS,
+  setMaxActivePluginsPerDeveloper,
+  setMaxPendingInstallsPerUser,
+  setAutoDeprecateAfterMs,
+  setAutoArchiveAfterMs,
+  getMaxActivePluginsPerDeveloper,
+  getMaxPendingInstallsPerUser,
+  getAutoDeprecateAfterMs,
+  getAutoArchiveAfterMs,
+  getActivePluginCount,
+  getPendingInstallCount,
+  registerPluginV2,
+  getMaturityV2,
+  setPluginMaturityV2,
+  deprecatePlugin,
+  archivePluginV2,
+  removePluginV2,
+  touchPluginActivity,
+  submitInstallV2,
+  getInstallStatusV2,
+  setInstallStatusV2,
+  resolveInstall,
+  completeInstall,
+  failInstall,
+  uninstallInstallV2,
+  retryFailedInstall,
+  autoDeprecateStalePlugins,
+  autoArchiveLongDeprecated,
+  getEcosystemStatsV2,
 } from "../lib/plugin-ecosystem.js";
 
 function _dbFromCtx(cmd) {
@@ -512,6 +547,244 @@ export function registerPluginEcosystemCommand(program) {
       _json(getStats(db));
     });
 
+  /* ── Phase 64 V2 ──────────────────────────────────── */
+
+  eco
+    .command("maturity-statuses-v2")
+    .description("List V2 plugin maturity statuses")
+    .action(() => _json(Object.values(PLUGIN_MATURITY_V2)));
+
+  eco
+    .command("install-lifecycle-v2")
+    .description("List V2 install lifecycle statuses")
+    .action(() => _json(Object.values(INSTALL_LIFECYCLE_V2)));
+
+  eco
+    .command("default-max-active-plugins-per-developer")
+    .description("Show V2 default max active plugins per developer")
+    .action(() => _json(PLUGIN_DEFAULT_MAX_ACTIVE_PER_DEVELOPER));
+
+  eco
+    .command("max-active-plugins-per-developer")
+    .description("Show current V2 max active plugins per developer")
+    .action(() => _json(getMaxActivePluginsPerDeveloper()));
+
+  eco
+    .command("set-max-active-plugins-per-developer <n>")
+    .description("Set V2 max active plugins per developer")
+    .action((n) => _json(setMaxActivePluginsPerDeveloper(Number(n))));
+
+  eco
+    .command("default-max-pending-installs-per-user")
+    .description("Show V2 default max pending installs per user")
+    .action(() => _json(PLUGIN_DEFAULT_MAX_PENDING_INSTALLS_PER_USER));
+
+  eco
+    .command("max-pending-installs-per-user")
+    .description("Show current V2 max pending installs per user")
+    .action(() => _json(getMaxPendingInstallsPerUser()));
+
+  eco
+    .command("set-max-pending-installs-per-user <n>")
+    .description("Set V2 max pending installs per user")
+    .action((n) => _json(setMaxPendingInstallsPerUser(Number(n))));
+
+  eco
+    .command("default-auto-deprecate-after-ms")
+    .description("Show V2 default auto-deprecate threshold (ms)")
+    .action(() => _json(PLUGIN_DEFAULT_AUTO_DEPRECATE_AFTER_MS));
+
+  eco
+    .command("auto-deprecate-after-ms")
+    .description("Show current V2 auto-deprecate threshold (ms)")
+    .action(() => _json(getAutoDeprecateAfterMs()));
+
+  eco
+    .command("set-auto-deprecate-after-ms <ms>")
+    .description("Set V2 auto-deprecate threshold (ms)")
+    .action((ms) => _json(setAutoDeprecateAfterMs(Number(ms))));
+
+  eco
+    .command("default-auto-archive-after-ms")
+    .description("Show V2 default auto-archive threshold (ms)")
+    .action(() => _json(PLUGIN_DEFAULT_AUTO_ARCHIVE_AFTER_MS));
+
+  eco
+    .command("auto-archive-after-ms")
+    .description("Show current V2 auto-archive threshold (ms)")
+    .action(() => _json(getAutoArchiveAfterMs()));
+
+  eco
+    .command("set-auto-archive-after-ms <ms>")
+    .description("Set V2 auto-archive threshold (ms)")
+    .action((ms) => _json(setAutoArchiveAfterMs(Number(ms))));
+
+  eco
+    .command("active-plugin-count")
+    .description("Count V2 active plugins (optionally scoped)")
+    .option("-d, --developer <id>", "Filter by developer ID")
+    .action((opts) => _json(getActivePluginCount(opts.developer)));
+
+  eco
+    .command("pending-install-count")
+    .description("Count V2 pending+resolving installs (optionally scoped)")
+    .option("-u, --user <id>", "Filter by user ID")
+    .action((opts) => _json(getPendingInstallCount(opts.user)));
+
+  eco
+    .command("register-plugin-v2 <plugin-id>")
+    .description("Register V2 plugin (status=active)")
+    .requiredOption("-d, --developer <id>", "Developer ID")
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .action((pluginId, opts) => {
+      _json(
+        registerPluginV2(null, {
+          pluginId,
+          developerId: opts.developer,
+          metadata: _parseJsonArg(opts.metadata, undefined),
+        }),
+      );
+    });
+
+  eco
+    .command("maturity-v2 <plugin-id>")
+    .description("Show V2 plugin maturity")
+    .action((pluginId) => _json(getMaturityV2(pluginId)));
+
+  eco
+    .command("set-maturity-v2 <plugin-id> <status>")
+    .description("Transition V2 plugin maturity")
+    .option("-r, --reason <text>", "Reason")
+    .option("-m, --metadata <json>", "Metadata JSON to merge")
+    .action((pluginId, status, opts) => {
+      _json(
+        setPluginMaturityV2(null, pluginId, status, {
+          reason: opts.reason,
+          metadata: _parseJsonArg(opts.metadata, undefined),
+        }),
+      );
+    });
+
+  eco
+    .command("deprecate-plugin <plugin-id>")
+    .description("Deprecate V2 plugin")
+    .option("-r, --reason <text>", "Reason")
+    .action((pluginId, opts) =>
+      _json(deprecatePlugin(null, pluginId, opts.reason)),
+    );
+
+  eco
+    .command("archive-plugin-v2 <plugin-id>")
+    .description("Archive V2 plugin")
+    .option("-r, --reason <text>", "Reason")
+    .action((pluginId, opts) =>
+      _json(archivePluginV2(null, pluginId, opts.reason)),
+    );
+
+  eco
+    .command("remove-plugin-v2 <plugin-id>")
+    .description("Remove V2 plugin (terminal)")
+    .option("-r, --reason <text>", "Reason")
+    .action((pluginId, opts) =>
+      _json(removePluginV2(null, pluginId, opts.reason)),
+    );
+
+  eco
+    .command("touch-plugin-activity <plugin-id>")
+    .description("Bump lastActivityAt for V2 plugin")
+    .action((pluginId) => _json(touchPluginActivity(pluginId)));
+
+  eco
+    .command("submit-install-v2 <install-id>")
+    .description("Submit V2 install (status=pending)")
+    .requiredOption("-u, --user <id>", "User ID")
+    .requiredOption("-p, --plugin <id>", "Plugin ID")
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .action((installId, opts) => {
+      _json(
+        submitInstallV2(null, {
+          installId,
+          userId: opts.user,
+          pluginId: opts.plugin,
+          metadata: _parseJsonArg(opts.metadata, undefined),
+        }),
+      );
+    });
+
+  eco
+    .command("install-status-v2 <install-id>")
+    .description("Show V2 install status")
+    .action((installId) => _json(getInstallStatusV2(installId)));
+
+  eco
+    .command("set-install-status-v2 <install-id> <status>")
+    .description("Transition V2 install status")
+    .option("-r, --reason <text>", "Reason")
+    .option("-m, --metadata <json>", "Metadata JSON to merge")
+    .action((installId, status, opts) => {
+      _json(
+        setInstallStatusV2(null, installId, status, {
+          reason: opts.reason,
+          metadata: _parseJsonArg(opts.metadata, undefined),
+        }),
+      );
+    });
+
+  eco
+    .command("resolve-install <install-id>")
+    .description("Mark V2 install as resolving")
+    .option("-r, --reason <text>", "Reason")
+    .action((installId, opts) =>
+      _json(resolveInstall(null, installId, opts.reason)),
+    );
+
+  eco
+    .command("complete-install <install-id>")
+    .description("Mark V2 install as installed")
+    .option("-r, --reason <text>", "Reason")
+    .action((installId, opts) =>
+      _json(completeInstall(null, installId, opts.reason)),
+    );
+
+  eco
+    .command("fail-install <install-id>")
+    .description("Mark V2 install as failed")
+    .option("-r, --reason <text>", "Reason")
+    .action((installId, opts) =>
+      _json(failInstall(null, installId, opts.reason)),
+    );
+
+  eco
+    .command("uninstall-install-v2 <install-id>")
+    .description("Mark V2 install as uninstalled (terminal)")
+    .option("-r, --reason <text>", "Reason")
+    .action((installId, opts) =>
+      _json(uninstallInstallV2(null, installId, opts.reason)),
+    );
+
+  eco
+    .command("retry-failed-install <install-id>")
+    .description("Retry a failed V2 install (failed → pending)")
+    .option("-r, --reason <text>", "Reason")
+    .action((installId, opts) =>
+      _json(retryFailedInstall(null, installId, opts.reason)),
+    );
+
+  eco
+    .command("auto-deprecate-stale-plugins")
+    .description("Bulk-flip stale V2 ACTIVE plugins to DEPRECATED")
+    .action(() => _json(autoDeprecateStalePlugins(null)));
+
+  eco
+    .command("auto-archive-long-deprecated")
+    .description("Bulk-flip long-deprecated V2 plugins to ARCHIVED")
+    .action(() => _json(autoArchiveLongDeprecated(null)));
+
+  eco
+    .command("stats-v2")
+    .description("Show V2 ecosystem stats (maturity + install)")
+    .action(() => _json(getEcosystemStatsV2()));
+
   program.addCommand(eco);
   return eco;
 }