chainlesschain 0.81.0 → 0.132.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/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;
 }