chainlesschain 0.66.0 → 0.132.0

package/src/commands/tech.js

@@ -17,6 +17,37 @@ import {
   TECH_TYPES,
   PRACTICE_LEVELS,
   ANTI_PATTERNS,
+  PROFILE_MATURITY_V2,
+  LEARNING_RUN_V2,
+  getMaxActiveProfilesPerOwnerV2,
+  setMaxActiveProfilesPerOwnerV2,
+  getMaxStudyingRunsPerLearnerV2,
+  setMaxStudyingRunsPerLearnerV2,
+  getProfileStaleMsV2,
+  setProfileStaleMsV2,
+  getRunStuckMsV2,
+  setRunStuckMsV2,
+  getActiveProfileCountV2,
+  getStudyingRunCountV2,
+  createProfileV2,
+  getProfileV2,
+  listProfilesV2,
+  setProfileMaturityV2,
+  activateProfileV2,
+  markProfileStaleV2,
+  archiveProfileV2,
+  touchProfileV2,
+  enqueueRunV2,
+  getRunV2,
+  listRunsV2,
+  setRunStatusV2,
+  startRunV2,
+  completeRunV2,
+  abandonRunV2,
+  failRunV2,
+  autoMarkStaleProfilesV2,
+  autoFailStuckRunsV2,
+  getTechLearningStatsV2,
 } from "../lib/tech-learning-engine.js";
 
 function _dbFromCtx(ctx) {
@@ -265,4 +296,311 @@ export function registerTechCommand(program) {
         process.exit(1);
       }
     });
+
+  /* ═══ V2 Surface ═══ */
+
+  function _parseMeta(s) {
+    if (!s) return undefined;
+    try {
+      return JSON.parse(s);
+    } catch {
+      throw new Error("--metadata must be valid JSON");
+    }
+  }
+
+  tech
+    .command("profile-maturities-v2")
+    .description("List profile maturity states (V2)")
+    .action(() => {
+      for (const v of Object.values(PROFILE_MATURITY_V2)) logger.log(`  ${v}`);
+    });
+
+  tech
+    .command("learning-runs-v2")
+    .description("List learning run states (V2)")
+    .action(() => {
+      for (const v of Object.values(LEARNING_RUN_V2)) logger.log(`  ${v}`);
+    });
+
+  tech
+    .command("stats-v2")
+    .description("Tech Learning V2 stats")
+    .action(() => {
+      console.log(JSON.stringify(getTechLearningStatsV2(), null, 2));
+    });
+
+  tech
+    .command("max-active-profiles-per-owner")
+    .description("Get/set max active profiles per owner (V2)")
+    .option("-s, --set <n>", "Set value", (v) => parseInt(v, 10))
+    .action((o) => {
+      if (typeof o.set === "number")
+        console.log(setMaxActiveProfilesPerOwnerV2(o.set));
+      else console.log(getMaxActiveProfilesPerOwnerV2());
+    });
+
+  tech
+    .command("max-studying-runs-per-learner")
+    .description("Get/set max studying runs per learner (V2)")
+    .option("-s, --set <n>", "Set value", (v) => parseInt(v, 10))
+    .action((o) => {
+      if (typeof o.set === "number")
+        console.log(setMaxStudyingRunsPerLearnerV2(o.set));
+      else console.log(getMaxStudyingRunsPerLearnerV2());
+    });
+
+  tech
+    .command("profile-stale-ms")
+    .description("Get/set profile stale threshold ms (V2)")
+    .option("-s, --set <n>", "Set value", (v) => parseInt(v, 10))
+    .action((o) => {
+      if (typeof o.set === "number") console.log(setProfileStaleMsV2(o.set));
+      else console.log(getProfileStaleMsV2());
+    });
+
+  tech
+    .command("run-stuck-ms")
+    .description("Get/set run stuck threshold ms (V2)")
+    .option("-s, --set <n>", "Set value", (v) => parseInt(v, 10))
+    .action((o) => {
+      if (typeof o.set === "number") console.log(setRunStuckMsV2(o.set));
+      else console.log(getRunStuckMsV2());
+    });
+
+  tech
+    .command("active-profile-count")
+    .description("Count active+stale profiles for owner (V2)")
+    .requiredOption("-o, --owner <owner>", "Owner")
+    .action((o) => {
+      console.log(getActiveProfileCountV2(o.owner));
+    });
+
+  tech
+    .command("studying-run-count")
+    .description("Count studying runs for learner (V2)")
+    .requiredOption("-l, --learner <learner>", "Learner")
+    .action((o) => {
+      console.log(getStudyingRunCountV2(o.learner));
+    });
+
+  tech
+    .command("create-profile-v2 <id>")
+    .description("Create a profile V2 (draft)")
+    .requiredOption("-o, --owner <owner>", "Owner")
+    .requiredOption("-s, --stack <stack>", "Stack name")
+    .option("-m, --metadata <json>", "JSON metadata")
+    .action((id, o) => {
+      console.log(
+        JSON.stringify(
+          createProfileV2({
+            id,
+            owner: o.owner,
+            stackName: o.stack,
+            metadata: _parseMeta(o.metadata),
+          }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  tech
+    .command("profile-v2 <id>")
+    .description("Show profile V2")
+    .action((id) => {
+      const p = getProfileV2(id);
+      if (!p) {
+        logger.error(`profile ${id} not found`);
+        process.exit(1);
+      }
+      console.log(JSON.stringify(p, null, 2));
+    });
+
+  tech
+    .command("list-profiles-v2")
+    .description("List profiles V2")
+    .option("-o, --owner <owner>", "Filter by owner")
+    .option("-s, --status <status>", "Filter by status")
+    .action((o) => {
+      console.log(
+        JSON.stringify(
+          listProfilesV2({ owner: o.owner, status: o.status }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  tech
+    .command("set-profile-maturity-v2 <id> <status>")
+    .description("Transition profile V2 to status")
+    .option("-r, --reason <reason>", "Reason")
+    .option("-m, --metadata <json>", "JSON metadata patch")
+    .action((id, status, o) => {
+      console.log(
+        JSON.stringify(
+          setProfileMaturityV2(id, status, {
+            reason: o.reason,
+            metadata: _parseMeta(o.metadata),
+          }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  tech
+    .command("activate-profile <id>")
+    .description("Transition profile → active (V2)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((id, o) => {
+      console.log(
+        JSON.stringify(activateProfileV2(id, { reason: o.reason }), null, 2),
+      );
+    });
+
+  tech
+    .command("mark-profile-stale <id>")
+    .description("Transition profile → stale (V2)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((id, o) => {
+      console.log(
+        JSON.stringify(markProfileStaleV2(id, { reason: o.reason }), null, 2),
+      );
+    });
+
+  tech
+    .command("archive-profile <id>")
+    .description("Transition profile → archived (V2)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((id, o) => {
+      console.log(
+        JSON.stringify(archiveProfileV2(id, { reason: o.reason }), null, 2),
+      );
+    });
+
+  tech
+    .command("touch-profile <id>")
+    .description("Update lastTouchedAt (V2)")
+    .action((id) => {
+      console.log(JSON.stringify(touchProfileV2(id), null, 2));
+    });
+
+  tech
+    .command("enqueue-run-v2 <id>")
+    .description("Enqueue a learning run (V2)")
+    .requiredOption("-l, --learner <learner>", "Learner")
+    .requiredOption("-t, --topic <topic>", "Topic")
+    .option("-m, --metadata <json>", "JSON metadata")
+    .action((id, o) => {
+      console.log(
+        JSON.stringify(
+          enqueueRunV2({
+            id,
+            learner: o.learner,
+            topic: o.topic,
+            metadata: _parseMeta(o.metadata),
+          }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  tech
+    .command("run-v2 <id>")
+    .description("Show learning run V2")
+    .action((id) => {
+      const r = getRunV2(id);
+      if (!r) {
+        logger.error(`run ${id} not found`);
+        process.exit(1);
+      }
+      console.log(JSON.stringify(r, null, 2));
+    });
+
+  tech
+    .command("list-runs-v2")
+    .description("List learning runs V2")
+    .option("-l, --learner <learner>", "Filter by learner")
+    .option("-s, --status <status>", "Filter by status")
+    .action((o) => {
+      console.log(
+        JSON.stringify(
+          listRunsV2({ learner: o.learner, status: o.status }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  tech
+    .command("set-run-status-v2 <id> <status>")
+    .description("Transition run V2 to status")
+    .option("-r, --reason <reason>", "Reason")
+    .option("-m, --metadata <json>", "JSON metadata patch")
+    .action((id, status, o) => {
+      console.log(
+        JSON.stringify(
+          setRunStatusV2(id, status, {
+            reason: o.reason,
+            metadata: _parseMeta(o.metadata),
+          }),
+          null,
+          2,
+        ),
+      );
+    });
+
+  tech
+    .command("start-run-v2 <id>")
+    .description("Transition run → studying (V2)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((id, o) => {
+      console.log(
+        JSON.stringify(startRunV2(id, { reason: o.reason }), null, 2),
+      );
+    });
+
+  tech
+    .command("complete-run-v2 <id>")
+    .description("Transition run → completed (V2)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((id, o) => {
+      console.log(
+        JSON.stringify(completeRunV2(id, { reason: o.reason }), null, 2),
+      );
+    });
+
+  tech
+    .command("fail-run-v2 <id>")
+    .description("Transition run → failed (V2)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((id, o) => {
+      console.log(JSON.stringify(failRunV2(id, { reason: o.reason }), null, 2));
+    });
+
+  tech
+    .command("abandon-run-v2 <id>")
+    .description("Transition run → abandoned (V2)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((id, o) => {
+      console.log(
+        JSON.stringify(abandonRunV2(id, { reason: o.reason }), null, 2),
+      );
+    });
+
+  tech
+    .command("auto-mark-stale-profiles")
+    .description("Bulk auto-flip active→stale past threshold (V2)")
+    .action(() => {
+      console.log(JSON.stringify(autoMarkStaleProfilesV2(), null, 2));
+    });
+
+  tech
+    .command("auto-fail-stuck-runs")
+    .description("Bulk auto-fail studying runs past threshold (V2)")
+    .action(() => {
+      console.log(JSON.stringify(autoFailStuckRunsV2(), null, 2));
+    });
 }

package/src/commands/tenant.js

@@ -28,6 +28,40 @@ import {
   getSaasStats,
   exportTenant,
   importTenant,
+  TENANT_MATURITY_V2,
+  SUBSCRIPTION_LIFECYCLE_V2,
+  getDefaultMaxActiveTenantsPerPlanV2,
+  getMaxActiveTenantsPerPlanV2,
+  setMaxActiveTenantsPerPlanV2,
+  getDefaultMaxSubscriptionsPerTenantV2,
+  getMaxSubscriptionsPerTenantV2,
+  setMaxSubscriptionsPerTenantV2,
+  getDefaultTenantIdleMsV2,
+  getTenantIdleMsV2,
+  setTenantIdleMsV2,
+  getDefaultPastDueGraceMsV2,
+  getPastDueGraceMsV2,
+  setPastDueGraceMsV2,
+  registerTenantV2,
+  getTenantV2,
+  setTenantMaturityV2,
+  activateTenant,
+  suspendTenant,
+  archiveTenantV2,
+  cancelTenant,
+  touchTenantActivity,
+  registerSubscriptionV2,
+  getSubscriptionV2,
+  setSubscriptionStatusV2,
+  activateSubscription,
+  markSubscriptionPastDue,
+  cancelSubscriptionV2,
+  expireSubscription,
+  getActiveTenantCount,
+  getOpenSubscriptionCount,
+  autoArchiveIdleTenants,
+  autoExpirePastDueSubscriptions,
+  getSaasStatsV2,
 } from "../lib/tenant-saas.js";
 
 function _dbFromCtx(ctx) {
@@ -573,4 +607,321 @@ export function registerTenantCommand(program) {
         process.exit(1);
       }
     });
+
+  /* ── V2: Tenant Maturity + Subscription Lifecycle ─────────── */
+
+  tenant
+    .command("maturities-v2")
+    .description("List tenant V2 maturity states")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const s = Object.values(TENANT_MATURITY_V2);
+      if (opts.json) console.log(JSON.stringify(s));
+      else s.forEach((v) => console.log(v));
+    });
+
+  tenant
+    .command("subscription-lifecycles-v2")
+    .description("List subscription V2 lifecycle states")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const s = Object.values(SUBSCRIPTION_LIFECYCLE_V2);
+      if (opts.json) console.log(JSON.stringify(s));
+      else s.forEach((v) => console.log(v));
+    });
+
+  tenant
+    .command("default-max-active-tenants-per-plan")
+    .description("Show default max-active-tenants-per-plan")
+    .action(() => console.log(getDefaultMaxActiveTenantsPerPlanV2()));
+  tenant
+    .command("max-active-tenants-per-plan")
+    .description("Show current max-active-tenants-per-plan")
+    .action(() => console.log(getMaxActiveTenantsPerPlanV2()));
+  tenant
+    .command("set-max-active-tenants-per-plan <n>")
+    .description("Set max-active-tenants-per-plan")
+    .action((n) => {
+      setMaxActiveTenantsPerPlanV2(n);
+      console.log(getMaxActiveTenantsPerPlanV2());
+    });
+
+  tenant
+    .command("default-max-subscriptions-per-tenant")
+    .description("Show default max-subscriptions-per-tenant")
+    .action(() => console.log(getDefaultMaxSubscriptionsPerTenantV2()));
+  tenant
+    .command("max-subscriptions-per-tenant")
+    .description("Show current max-subscriptions-per-tenant")
+    .action(() => console.log(getMaxSubscriptionsPerTenantV2()));
+  tenant
+    .command("set-max-subscriptions-per-tenant <n>")
+    .description("Set max-subscriptions-per-tenant")
+    .action((n) => {
+      setMaxSubscriptionsPerTenantV2(n);
+      console.log(getMaxSubscriptionsPerTenantV2());
+    });
+
+  tenant
+    .command("default-tenant-idle-ms")
+    .description("Show default tenant-idle-ms")
+    .action(() => console.log(getDefaultTenantIdleMsV2()));
+  tenant
+    .command("tenant-idle-ms")
+    .description("Show current tenant-idle-ms")
+    .action(() => console.log(getTenantIdleMsV2()));
+  tenant
+    .command("set-tenant-idle-ms <ms>")
+    .description("Set tenant-idle-ms")
+    .action((ms) => {
+      setTenantIdleMsV2(ms);
+      console.log(getTenantIdleMsV2());
+    });
+
+  tenant
+    .command("default-past-due-grace-ms")
+    .description("Show default past-due-grace-ms")
+    .action(() => console.log(getDefaultPastDueGraceMsV2()));
+  tenant
+    .command("past-due-grace-ms")
+    .description("Show current past-due-grace-ms")
+    .action(() => console.log(getPastDueGraceMsV2()));
+  tenant
+    .command("set-past-due-grace-ms <ms>")
+    .description("Set past-due-grace-ms")
+    .action((ms) => {
+      setPastDueGraceMsV2(ms);
+      console.log(getPastDueGraceMsV2());
+    });
+
+  tenant
+    .command("active-tenant-count")
+    .description("Active tenant count (optionally scoped by plan)")
+    .option("-p, --plan <plan>", "Plan ID")
+    .action((opts) => console.log(getActiveTenantCount(opts.plan)));
+
+  tenant
+    .command("open-subscription-count")
+    .description("Open subscription count (optionally scoped by tenant)")
+    .option("-t, --tenant <id>", "Tenant ID")
+    .action((opts) => console.log(getOpenSubscriptionCount(opts.tenant)));
+
+  tenant
+    .command("register-v2 <tenant-id>")
+    .description("Register a V2 tenant")
+    .requiredOption("-p, --plan <plan>", "Plan")
+    .option("-o, --owner <id>", "Owner ID")
+    .option(
+      "-i, --initial-status <status>",
+      "Initial status (default provisioning)",
+    )
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .action((tenantId, opts) => {
+      const config = { tenantId, plan: opts.plan };
+      if (opts.owner) config.ownerId = opts.owner;
+      if (opts.initialStatus) config.initialStatus = opts.initialStatus;
+      if (opts.metadata) config.metadata = JSON.parse(opts.metadata);
+      console.log(JSON.stringify(registerTenantV2(null, config), null, 2));
+    });
+
+  tenant
+    .command("tenant-v2 <tenant-id>")
+    .description("Get V2 tenant record")
+    .action((tenantId) => {
+      const rec = getTenantV2(tenantId);
+      console.log(rec ? JSON.stringify(rec, null, 2) : "null");
+    });
+
+  tenant
+    .command("set-maturity-v2 <tenant-id> <status>")
+    .description("Set tenant V2 maturity status")
+    .option("-r, --reason <reason>", "Reason")
+    .option("-m, --metadata <json>", "Metadata JSON patch")
+    .action((tenantId, status, opts) => {
+      const patch = {};
+      if (opts.reason !== undefined) patch.reason = opts.reason;
+      if (opts.metadata) patch.metadata = JSON.parse(opts.metadata);
+      console.log(
+        JSON.stringify(
+          setTenantMaturityV2(null, tenantId, status, patch),
+          null,
+          2,
+        ),
+      );
+    });
+
+  tenant
+    .command("activate <tenant-id>")
+    .description("Transition tenant → active")
+    .option("-r, --reason <reason>", "Reason")
+    .action((tenantId, opts) =>
+      console.log(
+        JSON.stringify(activateTenant(null, tenantId, opts.reason), null, 2),
+      ),
+    );
+
+  tenant
+    .command("suspend <tenant-id>")
+    .description("Transition tenant → suspended")
+    .option("-r, --reason <reason>", "Reason")
+    .action((tenantId, opts) =>
+      console.log(
+        JSON.stringify(suspendTenant(null, tenantId, opts.reason), null, 2),
+      ),
+    );
+
+  tenant
+    .command("archive-v2 <tenant-id>")
+    .description("Transition tenant → archived")
+    .option("-r, --reason <reason>", "Reason")
+    .action((tenantId, opts) =>
+      console.log(
+        JSON.stringify(archiveTenantV2(null, tenantId, opts.reason), null, 2),
+      ),
+    );
+
+  tenant
+    .command("cancel-tenant <tenant-id>")
+    .description("Transition tenant → cancelled (terminal)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((tenantId, opts) =>
+      console.log(
+        JSON.stringify(cancelTenant(null, tenantId, opts.reason), null, 2),
+      ),
+    );
+
+  tenant
+    .command("touch-activity <tenant-id>")
+    .description("Bump lastActivityAt for a tenant")
+    .action((tenantId) =>
+      console.log(JSON.stringify(touchTenantActivity(tenantId), null, 2)),
+    );
+
+  tenant
+    .command("subscription-register-v2 <subscription-id>")
+    .description("Register a V2 subscription")
+    .requiredOption("-t, --tenant <id>", "Tenant ID")
+    .requiredOption("-p, --plan <plan>", "Plan")
+    .option("-e, --expires-at <ms>", "Expires at (epoch ms)")
+    .option("-m, --metadata <json>", "Metadata JSON")
+    .action((subscriptionId, opts) => {
+      const config = {
+        subscriptionId,
+        tenantId: opts.tenant,
+        plan: opts.plan,
+      };
+      if (opts.expiresAt) config.expiresAt = Number(opts.expiresAt);
+      if (opts.metadata) config.metadata = JSON.parse(opts.metadata);
+      console.log(
+        JSON.stringify(registerSubscriptionV2(null, config), null, 2),
+      );
+    });
+
+  tenant
+    .command("subscription-v2 <subscription-id>")
+    .description("Get V2 subscription record")
+    .action((subscriptionId) => {
+      const rec = getSubscriptionV2(subscriptionId);
+      console.log(rec ? JSON.stringify(rec, null, 2) : "null");
+    });
+
+  tenant
+    .command("set-subscription-status-v2 <subscription-id> <status>")
+    .description("Set subscription V2 status")
+    .option("-r, --reason <reason>", "Reason")
+    .option("-m, --metadata <json>", "Metadata JSON patch")
+    .action((subscriptionId, status, opts) => {
+      const patch = {};
+      if (opts.reason !== undefined) patch.reason = opts.reason;
+      if (opts.metadata) patch.metadata = JSON.parse(opts.metadata);
+      console.log(
+        JSON.stringify(
+          setSubscriptionStatusV2(null, subscriptionId, status, patch),
+          null,
+          2,
+        ),
+      );
+    });
+
+  tenant
+    .command("activate-subscription <subscription-id>")
+    .description("Transition subscription → active")
+    .option("-r, --reason <reason>", "Reason")
+    .action((subscriptionId, opts) =>
+      console.log(
+        JSON.stringify(
+          activateSubscription(null, subscriptionId, opts.reason),
+          null,
+          2,
+        ),
+      ),
+    );
+
+  tenant
+    .command("mark-past-due <subscription-id>")
+    .description("Transition subscription → past_due")
+    .option("-r, --reason <reason>", "Reason")
+    .action((subscriptionId, opts) =>
+      console.log(
+        JSON.stringify(
+          markSubscriptionPastDue(null, subscriptionId, opts.reason),
+          null,
+          2,
+        ),
+      ),
+    );
+
+  tenant
+    .command("cancel-subscription-v2 <subscription-id>")
+    .description("Transition subscription → cancelled (terminal)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((subscriptionId, opts) =>
+      console.log(
+        JSON.stringify(
+          cancelSubscriptionV2(null, subscriptionId, opts.reason),
+          null,
+          2,
+        ),
+      ),
+    );
+
+  tenant
+    .command("expire-subscription <subscription-id>")
+    .description("Transition subscription → expired (terminal)")
+    .option("-r, --reason <reason>", "Reason")
+    .action((subscriptionId, opts) =>
+      console.log(
+        JSON.stringify(
+          expireSubscription(null, subscriptionId, opts.reason),
+          null,
+          2,
+        ),
+      ),
+    );
+
+  tenant
+    .command("auto-archive-idle-tenants")
+    .description("Bulk-flip idle tenants → archived")
+    .action(() => {
+      const flipped = autoArchiveIdleTenants(null);
+      console.log(JSON.stringify(flipped));
+    });
+
+  tenant
+    .command("auto-expire-past-due-subscriptions")
+    .description("Bulk-flip past-due subscriptions past grace → expired")
+    .action(() => {
+      const flipped = autoExpirePastDueSubscriptions(null);
+      console.log(JSON.stringify(flipped));
+    });
+
+  tenant
+    .command("stats-v2")
+    .description("Show V2 SaaS stats (all-enum-key)")
+    .option("--json", "JSON output")
+    .action((opts) => {
+      const s = getSaasStatsV2();
+      if (opts.json) console.log(JSON.stringify(s));
+      else console.log(JSON.stringify(s, null, 2));
+    });
 }