chainlesschain 0.66.0 → 0.132.0

package/src/commands/rcache.js

@@ -0,0 +1,271 @@
+/**
+ * Response Cache V2 commands
+ * `cc rcache ...` — in-memory governance layer for cache profiles
+ * + refresh jobs, independent of SQLite llm_cache table.
+ */
+
+import { logger } from "../lib/logger.js";
+import {
+  PROFILE_MATURITY_V2,
+  REFRESH_JOB_LIFECYCLE_V2,
+  getMaxActiveProfilesPerOwnerV2,
+  setMaxActiveProfilesPerOwnerV2,
+  getMaxPendingRefreshJobsPerProfileV2,
+  setMaxPendingRefreshJobsPerProfileV2,
+  getProfileIdleMsV2,
+  setProfileIdleMsV2,
+  getRefreshStuckMsV2,
+  setRefreshStuckMsV2,
+  registerProfileV2,
+  getProfileV2,
+  listProfilesV2,
+  setProfileStatusV2,
+  activateProfileV2,
+  suspendProfileV2,
+  archiveProfileV2,
+  touchProfileV2,
+  getActiveProfileCountV2,
+  createRefreshJobV2,
+  getRefreshJobV2,
+  listRefreshJobsV2,
+  setRefreshJobStatusV2,
+  startRefreshJobV2,
+  completeRefreshJobV2,
+  failRefreshJobV2,
+  cancelRefreshJobV2,
+  getPendingRefreshJobCountV2,
+  autoSuspendIdleProfilesV2,
+  autoFailStuckRefreshJobsV2,
+  getResponseCacheStatsV2,
+} from "../lib/response-cache.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 registerRCacheCommand(program) {
+  const root = program
+    .command("rcache")
+    .description("Response cache V2 — profile maturity + refresh jobs");
+
+  root
+    .command("profile-maturities-v2")
+    .description("List V2 profile maturity states")
+    .action(() => out(Object.values(PROFILE_MATURITY_V2)));
+
+  root
+    .command("refresh-job-lifecycles-v2")
+    .description("List V2 refresh-job lifecycle states")
+    .action(() => out(Object.values(REFRESH_JOB_LIFECYCLE_V2)));
+
+  root
+    .command("stats-v2")
+    .description("V2 response cache stats")
+    .action(() => out(getResponseCacheStatsV2()));
+
+  root
+    .command("get-max-active-profiles-v2")
+    .description("Get max active profiles per owner (V2)")
+    .action(() =>
+      out({ maxActiveProfilesPerOwner: getMaxActiveProfilesPerOwnerV2() }),
+    );
+
+  root
+    .command("set-max-active-profiles-v2 <n>")
+    .description("Set max active profiles per owner (V2)")
+    .action((n) =>
+      tryRun(() => {
+        setMaxActiveProfilesPerOwnerV2(Number(n));
+        out({ maxActiveProfilesPerOwner: getMaxActiveProfilesPerOwnerV2() });
+      }),
+    );
+
+  root
+    .command("get-max-pending-refresh-jobs-v2")
+    .description("Get max pending refresh jobs per profile (V2)")
+    .action(() =>
+      out({
+        maxPendingRefreshJobsPerProfile: getMaxPendingRefreshJobsPerProfileV2(),
+      }),
+    );
+
+  root
+    .command("set-max-pending-refresh-jobs-v2 <n>")
+    .description("Set max pending refresh jobs per profile (V2)")
+    .action((n) =>
+      tryRun(() => {
+        setMaxPendingRefreshJobsPerProfileV2(Number(n));
+        out({
+          maxPendingRefreshJobsPerProfile:
+            getMaxPendingRefreshJobsPerProfileV2(),
+        });
+      }),
+    );
+
+  root
+    .command("get-profile-idle-ms-v2")
+    .description("Get profile idle threshold (V2)")
+    .action(() => out({ profileIdleMs: getProfileIdleMsV2() }));
+
+  root
+    .command("set-profile-idle-ms-v2 <ms>")
+    .description("Set profile idle threshold (V2)")
+    .action((ms) =>
+      tryRun(() => {
+        setProfileIdleMsV2(Number(ms));
+        out({ profileIdleMs: getProfileIdleMsV2() });
+      }),
+    );
+
+  root
+    .command("get-refresh-stuck-ms-v2")
+    .description("Get refresh-job stuck threshold (V2)")
+    .action(() => out({ refreshStuckMs: getRefreshStuckMsV2() }));
+
+  root
+    .command("set-refresh-stuck-ms-v2 <ms>")
+    .description("Set refresh-job stuck threshold (V2)")
+    .action((ms) =>
+      tryRun(() => {
+        setRefreshStuckMsV2(Number(ms));
+        out({ refreshStuckMs: getRefreshStuckMsV2() });
+      }),
+    );
+
+  root
+    .command("active-profile-count-v2 <ownerId>")
+    .description("Active profile count for owner (V2)")
+    .action((ownerId) =>
+      out({ ownerId, count: getActiveProfileCountV2(ownerId) }),
+    );
+
+  root
+    .command("pending-refresh-job-count-v2 <profileId>")
+    .description("Pending refresh-job count for profile (V2)")
+    .action((profileId) =>
+      out({ profileId, count: getPendingRefreshJobCountV2(profileId) }),
+    );
+
+  root
+    .command("register-profile-v2 <id>")
+    .description("Register a V2 profile")
+    .requiredOption("-o, --owner <id>", "owner id")
+    .requiredOption("-l, --label <label>", "profile label")
+    .action((id, opts) =>
+      tryRun(() =>
+        out(registerProfileV2(id, { ownerId: opts.owner, label: opts.label })),
+      ),
+    );
+
+  root
+    .command("get-profile-v2 <id>")
+    .description("Get a V2 profile")
+    .action((id) => out(getProfileV2(id)));
+
+  root
+    .command("list-profiles-v2")
+    .description("List V2 profiles")
+    .option("-o, --owner <id>", "filter by owner")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) =>
+      out(listProfilesV2({ ownerId: opts.owner, status: opts.status })),
+    );
+
+  root
+    .command("set-profile-status-v2 <id> <next>")
+    .description("Set V2 profile status")
+    .action((id, next) => tryRun(() => out(setProfileStatusV2(id, next))));
+
+  root
+    .command("activate-profile-v2 <id>")
+    .description("Activate a V2 profile")
+    .action((id) => tryRun(() => out(activateProfileV2(id))));
+
+  root
+    .command("suspend-profile-v2 <id>")
+    .description("Suspend a V2 profile")
+    .action((id) => tryRun(() => out(suspendProfileV2(id))));
+
+  root
+    .command("archive-profile-v2 <id>")
+    .description("Archive a V2 profile")
+    .action((id) => tryRun(() => out(archiveProfileV2(id))));
+
+  root
+    .command("touch-profile-v2 <id>")
+    .description("Touch a V2 profile")
+    .action((id) => tryRun(() => out(touchProfileV2(id))));
+
+  root
+    .command("create-refresh-job-v2 <id>")
+    .description("Create a V2 refresh job")
+    .requiredOption("-p, --profile <id>", "profile id")
+    .option("-k, --kind <kind>", "job kind", "warm")
+    .action((id, opts) =>
+      tryRun(() =>
+        out(
+          createRefreshJobV2(id, { profileId: opts.profile, kind: opts.kind }),
+        ),
+      ),
+    );
+
+  root
+    .command("get-refresh-job-v2 <id>")
+    .description("Get a V2 refresh job")
+    .action((id) => out(getRefreshJobV2(id)));
+
+  root
+    .command("list-refresh-jobs-v2")
+    .description("List V2 refresh jobs")
+    .option("-p, --profile <id>", "filter by profile")
+    .option("-s, --status <status>", "filter by status")
+    .action((opts) =>
+      out(
+        listRefreshJobsV2({
+          profileId: opts.profile,
+          status: opts.status,
+        }),
+      ),
+    );
+
+  root
+    .command("set-refresh-job-status-v2 <id> <next>")
+    .description("Set V2 refresh-job status")
+    .action((id, next) => tryRun(() => out(setRefreshJobStatusV2(id, next))));
+
+  root
+    .command("start-refresh-job-v2 <id>")
+    .description("Start a V2 refresh job")
+    .action((id) => tryRun(() => out(startRefreshJobV2(id))));
+
+  root
+    .command("complete-refresh-job-v2 <id>")
+    .description("Complete a V2 refresh job")
+    .action((id) => tryRun(() => out(completeRefreshJobV2(id))));
+
+  root
+    .command("fail-refresh-job-v2 <id>")
+    .description("Fail a V2 refresh job")
+    .action((id) => tryRun(() => out(failRefreshJobV2(id))));
+
+  root
+    .command("cancel-refresh-job-v2 <id>")
+    .description("Cancel a V2 refresh job")
+    .action((id) => tryRun(() => out(cancelRefreshJobV2(id))));
+
+  root
+    .command("auto-suspend-idle-profiles-v2")
+    .description("Auto-suspend idle V2 profiles")
+    .action(() => out(autoSuspendIdleProfilesV2()));
+
+  root
+    .command("auto-fail-stuck-refresh-jobs-v2")
+    .description("Auto-fail stuck V2 refresh jobs")
+    .action(() => out(autoFailStuckRefreshJobsV2()));
+}

package/src/commands/recommend.js

@@ -26,6 +26,44 @@ import {
   getRecommendationStats,
   getTopInterests,
   suggestTopics,
+  // V2 (Phase 48 V2)
+  PROFILE_MATURITY_V2,
+  FEED_LIFECYCLE_V2,
+  REC_DEFAULT_MAX_ACTIVE_PROFILES_PER_SEGMENT,
+  REC_DEFAULT_MAX_ACTIVE_FEEDS_PER_CURATOR,
+  REC_DEFAULT_PROFILE_IDLE_MS,
+  REC_DEFAULT_FEED_STALE_MS,
+  getDefaultMaxActiveProfilesPerSegmentV2,
+  getMaxActiveProfilesPerSegmentV2,
+  setMaxActiveProfilesPerSegmentV2,
+  getDefaultMaxActiveFeedsPerCuratorV2,
+  getMaxActiveFeedsPerCuratorV2,
+  setMaxActiveFeedsPerCuratorV2,
+  getDefaultProfileIdleMsV2,
+  getProfileIdleMsV2,
+  setProfileIdleMsV2,
+  getDefaultFeedStaleMsV2,
+  getFeedStaleMsV2,
+  setFeedStaleMsV2,
+  registerProfileV2,
+  getProfileV2,
+  setProfileMaturityV2,
+  activateProfile,
+  dormantProfile,
+  retireProfile,
+  touchProfileActivity,
+  registerFeedV2,
+  getFeedV2,
+  setFeedStatusV2,
+  activateFeed,
+  pauseFeed,
+  archiveFeed,
+  touchFeedPublish,
+  getActiveProfileCount,
+  getActiveFeedCount,
+  autoDormantIdleProfiles,
+  autoArchiveStaleFeeds,
+  getRecommendationStatsV2,
 } from "../lib/content-recommendation.js";
 
 function _dbFromCtx(cmd) {
@@ -332,5 +370,307 @@ export function registerRecommendCommand(program) {
         console.log(`  ${s.action.padEnd(8)} ${s.topic} by ${s.amount}`);
     });
 
+  /* ── V2 (Phase 48 V2) ────────────────────────────── */
+
+  function _parseJsonFlag(value, label) {
+    if (value === undefined) return undefined;
+    try {
+      return JSON.parse(value);
+    } catch {
+      throw new Error(`Invalid JSON for ${label}`);
+    }
+  }
+
+  rec
+    .command("profile-maturities-v2")
+    .description("List V2 profile maturity states")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const out = Object.values(PROFILE_MATURITY_V2);
+      if (opts.json) return console.log(JSON.stringify(out, null, 2));
+      for (const s of out) console.log(`  ${s}`);
+    });
+
+  rec
+    .command("feed-lifecycles-v2")
+    .description("List V2 feed lifecycle states")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const out = Object.values(FEED_LIFECYCLE_V2);
+      if (opts.json) return console.log(JSON.stringify(out, null, 2));
+      for (const s of out) console.log(`  ${s}`);
+    });
+
+  rec
+    .command("default-max-active-profiles-per-segment")
+    .description("Show V2 default per-segment active-profile cap")
+    .action(() =>
+      console.log(String(getDefaultMaxActiveProfilesPerSegmentV2())),
+    );
+
+  rec
+    .command("max-active-profiles-per-segment")
+    .description("Show current V2 per-segment active-profile cap")
+    .action(() => console.log(String(getMaxActiveProfilesPerSegmentV2())));
+
+  rec
+    .command("set-max-active-profiles-per-segment <n>")
+    .description("Set V2 per-segment active-profile cap")
+    .action((n) =>
+      console.log(String(setMaxActiveProfilesPerSegmentV2(Number(n)))),
+    );
+
+  rec
+    .command("default-max-active-feeds-per-curator")
+    .description("Show V2 default per-curator active-feed cap")
+    .action(() => console.log(String(getDefaultMaxActiveFeedsPerCuratorV2())));
+
+  rec
+    .command("max-active-feeds-per-curator")
+    .description("Show current V2 per-curator active-feed cap")
+    .action(() => console.log(String(getMaxActiveFeedsPerCuratorV2())));
+
+  rec
+    .command("set-max-active-feeds-per-curator <n>")
+    .description("Set V2 per-curator active-feed cap")
+    .action((n) =>
+      console.log(String(setMaxActiveFeedsPerCuratorV2(Number(n)))),
+    );
+
+  rec
+    .command("default-profile-idle-ms")
+    .description("Show V2 default profile-idle window (ms)")
+    .action(() => console.log(String(getDefaultProfileIdleMsV2())));
+
+  rec
+    .command("profile-idle-ms")
+    .description("Show current V2 profile-idle window (ms)")
+    .action(() => console.log(String(getProfileIdleMsV2())));
+
+  rec
+    .command("set-profile-idle-ms <ms>")
+    .description("Set V2 profile-idle window (ms)")
+    .action((ms) => console.log(String(setProfileIdleMsV2(Number(ms)))));
+
+  rec
+    .command("default-feed-stale-ms")
+    .description("Show V2 default feed-stale window (ms)")
+    .action(() => console.log(String(getDefaultFeedStaleMsV2())));
+
+  rec
+    .command("feed-stale-ms")
+    .description("Show current V2 feed-stale window (ms)")
+    .action(() => console.log(String(getFeedStaleMsV2())));
+
+  rec
+    .command("set-feed-stale-ms <ms>")
+    .description("Set V2 feed-stale window (ms)")
+    .action((ms) => console.log(String(setFeedStaleMsV2(Number(ms)))));
+
+  rec
+    .command("active-profile-count")
+    .description("Count active V2 profiles (optionally scoped by segment)")
+    .option("-s, --segment <segment>", "Scope by segment")
+    .action((opts) => console.log(String(getActiveProfileCount(opts.segment))));
+
+  rec
+    .command("active-feed-count")
+    .description("Count active V2 feeds (optionally scoped by curator)")
+    .option("-c, --curator <curator>", "Scope by curator")
+    .action((opts) => console.log(String(getActiveFeedCount(opts.curator))));
+
+  rec
+    .command("register-profile-v2 <profile-id>")
+    .description("Register a V2 profile")
+    .requiredOption("-s, --segment <segment>", "Segment bucket")
+    .option("-u, --user-id <user-id>", "User id")
+    .option("-i, --initial-status <status>", "Initial maturity status")
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .action((profileId, opts) => {
+      const db = _dbFromCtx(rec);
+      const metadata = _parseJsonFlag(opts.metadata, "--metadata");
+      const out = registerProfileV2(db, {
+        profileId,
+        segment: opts.segment,
+        userId: opts.userId,
+        initialStatus: opts.initialStatus,
+        metadata,
+      });
+      console.log(JSON.stringify(out, null, 2));
+    });
+
+  rec
+    .command("profile-v2 <profile-id>")
+    .description("Show a V2 profile")
+    .action((profileId) => {
+      const out = getProfileV2(profileId);
+      console.log(out ? JSON.stringify(out, null, 2) : "null");
+    });
+
+  rec
+    .command("set-profile-maturity-v2 <profile-id> <status>")
+    .description("Set V2 profile maturity status")
+    .option("-r, --reason <reason>", "Reason")
+    .option("-m, --metadata <json>", "Metadata JSON (merged)")
+    .action((profileId, status, opts) => {
+      const db = _dbFromCtx(rec);
+      const metadata = _parseJsonFlag(opts.metadata, "--metadata");
+      const out = setProfileMaturityV2(db, profileId, status, {
+        reason: opts.reason,
+        metadata,
+      });
+      console.log(JSON.stringify(out, null, 2));
+    });
+
+  rec
+    .command("activate-profile <profile-id>")
+    .description("Activate a V2 profile")
+    .option("-r, --reason <reason>", "Reason")
+    .action((profileId, opts) => {
+      const db = _dbFromCtx(rec);
+      console.log(
+        JSON.stringify(activateProfile(db, profileId, opts.reason), null, 2),
+      );
+    });
+
+  rec
+    .command("dormant-profile <profile-id>")
+    .description("Mark a V2 profile dormant")
+    .option("-r, --reason <reason>", "Reason")
+    .action((profileId, opts) => {
+      const db = _dbFromCtx(rec);
+      console.log(
+        JSON.stringify(dormantProfile(db, profileId, opts.reason), null, 2),
+      );
+    });
+
+  rec
+    .command("retire-profile <profile-id>")
+    .description("Retire a V2 profile")
+    .option("-r, --reason <reason>", "Reason")
+    .action((profileId, opts) => {
+      const db = _dbFromCtx(rec);
+      console.log(
+        JSON.stringify(retireProfile(db, profileId, opts.reason), null, 2),
+      );
+    });
+
+  rec
+    .command("touch-profile-activity <profile-id>")
+    .description("Bump lastActivityAt on a V2 profile")
+    .action((profileId) => {
+      console.log(JSON.stringify(touchProfileActivity(profileId), null, 2));
+    });
+
+  rec
+    .command("register-feed-v2 <feed-id>")
+    .description("Register a V2 feed")
+    .requiredOption("-c, --curator-id <curator>", "Curator id")
+    .option("-t, --topics <csv>", "Comma-separated topics")
+    .option("-i, --initial-status <status>", "Initial lifecycle status")
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .action((feedId, opts) => {
+      const db = _dbFromCtx(rec);
+      const metadata = _parseJsonFlag(opts.metadata, "--metadata");
+      const topics = opts.topics
+        ? opts.topics
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : [];
+      const out = registerFeedV2(db, {
+        feedId,
+        curatorId: opts.curatorId,
+        topics,
+        initialStatus: opts.initialStatus,
+        metadata,
+      });
+      console.log(JSON.stringify(out, null, 2));
+    });
+
+  rec
+    .command("feed-v2 <feed-id>")
+    .description("Show a V2 feed")
+    .action((feedId) => {
+      const out = getFeedV2(feedId);
+      console.log(out ? JSON.stringify(out, null, 2) : "null");
+    });
+
+  rec
+    .command("set-feed-status-v2 <feed-id> <status>")
+    .description("Set V2 feed lifecycle status")
+    .option("-r, --reason <reason>", "Reason")
+    .option("-m, --metadata <json>", "Metadata JSON (merged)")
+    .action((feedId, status, opts) => {
+      const db = _dbFromCtx(rec);
+      const metadata = _parseJsonFlag(opts.metadata, "--metadata");
+      const out = setFeedStatusV2(db, feedId, status, {
+        reason: opts.reason,
+        metadata,
+      });
+      console.log(JSON.stringify(out, null, 2));
+    });
+
+  rec
+    .command("activate-feed <feed-id>")
+    .description("Activate a V2 feed")
+    .option("-r, --reason <reason>", "Reason")
+    .action((feedId, opts) => {
+      const db = _dbFromCtx(rec);
+      console.log(
+        JSON.stringify(activateFeed(db, feedId, opts.reason), null, 2),
+      );
+    });
+
+  rec
+    .command("pause-feed <feed-id>")
+    .description("Pause a V2 feed")
+    .option("-r, --reason <reason>", "Reason")
+    .action((feedId, opts) => {
+      const db = _dbFromCtx(rec);
+      console.log(JSON.stringify(pauseFeed(db, feedId, opts.reason), null, 2));
+    });
+
+  rec
+    .command("archive-feed <feed-id>")
+    .description("Archive a V2 feed")
+    .option("-r, --reason <reason>", "Reason")
+    .action((feedId, opts) => {
+      const db = _dbFromCtx(rec);
+      console.log(
+        JSON.stringify(archiveFeed(db, feedId, opts.reason), null, 2),
+      );
+    });
+
+  rec
+    .command("touch-feed-publish <feed-id>")
+    .description("Bump lastPublishAt on a V2 feed")
+    .action((feedId) => {
+      console.log(JSON.stringify(touchFeedPublish(feedId), null, 2));
+    });
+
+  rec
+    .command("auto-dormant-idle-profiles")
+    .description("Auto-flip idle ACTIVE V2 profiles to DORMANT")
+    .action(() => {
+      const db = _dbFromCtx(rec);
+      console.log(JSON.stringify(autoDormantIdleProfiles(db), null, 2));
+    });
+
+  rec
+    .command("auto-archive-stale-feeds")
+    .description("Auto-flip stale ACTIVE/PAUSED V2 feeds to ARCHIVED")
+    .action(() => {
+      const db = _dbFromCtx(rec);
+      console.log(JSON.stringify(autoArchiveStaleFeeds(db), null, 2));
+    });
+
+  rec
+    .command("stats-v2")
+    .description("V2 recommendation stats (counts by state + config)")
+    .action(() => {
+      console.log(JSON.stringify(getRecommendationStatsV2(), null, 2));
+    });
+
   program.addCommand(rec);
 }