@optima-chat/dev-skills 0.13.1 → 0.14.0

package/AGENTS.md

@@ -14,7 +14,7 @@ Prefer the installed CLI tools over reimplementing long shell workflows:
 - `optima-product <create|update|add-channel|toggle-channel|show> [options]` — manage paid-plugin marketplace Products + Stripe channels (Wave 1.5 admin endpoints; stage default)
 - `optima-entitlement <grant|revoke|list> [options]` — admin-grant / revoke / list paid-plugin entitlements (refuses revoke of PAYMENT / PARTNER source)
 - `optima-cn-deploy <service> [--branch feat/xxx] [--no-wait]` — 云效 Flow 发布到 cn-stage(mirror 同步→构建→DB 迁移→SAE 发布→sha 校验;20 服务,凭证由云效变量组供给零配置)
-- `optima-plugin <show|set-paid|set-default> [options]` — flip a plugin's skills-side paid/free state (isPaid) + defaultForUser (the user-facing gate; pairs with optima-product for the billing side)
+- `optima-plugin <show|set-paid|set-default|set-status> [options]` — flip a plugin's skills-side paid/free state (isPaid) + defaultForUser (the user-facing gate; pairs with optima-product for the billing side) + lifecycle status (ACTIVE|BETA|DEPRECATED — retire/restore a marketplace plugin)
 
 For code-reading tasks across Optima repositories, use `gh` commands against `Optima-Chat/<repo>`.
 

package/bin/helpers/plugin/set-status.ts

@@ -0,0 +1,90 @@
+import { callSkills, validateEnvCnProd } from '../billing-http';
+import { confirmIfProd } from '../confirm-prompt';
+
+export const VALID_PLUGIN_STATUSES = ['ACTIVE', 'BETA', 'DEPRECATED'] as const;
+export type PluginStatus = (typeof VALID_PLUGIN_STATUSES)[number];
+
+// Aligned with agent-runtime skill-sync-handler's isValidSlug (and the
+// deprecate-plugin workflow guard in optima-default-skills#40).
+const SLUG_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/;
+
+export interface SetStatusArgs {
+  slug: string;
+  status: PluginStatus;
+  yes: boolean;
+  env: string;
+}
+
+export function parseSetStatusArgs(argv: string[]): SetStatusArgs {
+  if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+    console.log(`Usage: optima-plugin set-status --slug <slug> --status ACTIVE|BETA|DEPRECATED [options]
+
+Required:
+  --slug <slug>
+  --status <status>    Sets Plugin.status (marketplace lifecycle gate).
+                       DEPRECATED retires the plugin: registry sync stops
+                       serving it and agents unload it on their next sync
+                       (in-flight sessions keep it until then). ACTIVE
+                       restores it. Fully reversible.
+
+Optional:
+  --yes                Skip prod confirmation prompt (no-op on stage)
+  --env <env>          stage|prod|cn-prod|cn-stage (default: stage)
+
+Note: this PATCH's 404 is the authoritative "slug has no marketplace row in
+this env" signal. Don't use 'optima-plugin show' to check existence — it reads
+the public endpoint, which also 404s for non-ACTIVE (e.g. already-DEPRECATED)
+plugins.`);
+    process.exit(0);
+  }
+  const out: Partial<SetStatusArgs> = { env: 'stage', yes: false };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    const next = argv[i + 1];
+    switch (a) {
+      case '--slug': out.slug = next; i++; break;
+      case '--status': {
+        const upper = (next ?? '').toUpperCase();
+        if (!(VALID_PLUGIN_STATUSES as readonly string[]).includes(upper)) {
+          throw new Error(`--status must be one of: ${VALID_PLUGIN_STATUSES.join('|')}`);
+        }
+        out.status = upper as PluginStatus; i++; break;
+      }
+      case '--yes': out.yes = true; break;
+      case '--env': out.env = next; i++; break;
+      default: throw new Error(`Unknown arg: ${a}`);
+    }
+  }
+  if (!out.slug) throw new Error('--slug required');
+  if (!SLUG_RE.test(out.slug)) throw new Error(`--slug must match ${SLUG_RE} (lowercase slug, e.g. onboarding-research)`);
+  if (!out.status) throw new Error(`--status required (${VALID_PLUGIN_STATUSES.join('|')})`);
+  return out as SetStatusArgs;
+}
+
+export async function runSetStatus(argv: string[]): Promise<void> {
+  const args = parseSetStatusArgs(argv);
+  validateEnvCnProd(args.env);
+
+  await confirmIfProd(
+    args.env,
+    `Action: set status=${args.status} on plugin '${args.slug}' (${args.env.toUpperCase()})`,
+    args.yes,
+  );
+
+  console.log(`\n🚦 Setting status=${args.status} on ${args.slug} (${args.env.toUpperCase()})...`);
+  const res = await callSkills(
+    args.env,
+    'PATCH',
+    `/api/admin/plugins/${encodeURIComponent(args.slug)}`,
+    { status: args.status },
+  );
+  console.log(`✓ Updated plugin (HTTP ${res.status}):`);
+  console.log(JSON.stringify(res.body, null, 2));
+  if (args.status === 'DEPRECATED') {
+    console.log(`\nℹ️  Takes effect on each user's next skill sync (new session / billing event): registry stops serving the plugin and agents unload its skills. In-flight sessions keep it until then. Restore anytime with --status ACTIVE. Verify retirement end-to-end by confirming an agent session no longer loads the plugin's skills.`);
+  } else if (args.status === 'ACTIVE') {
+    console.log(`\nℹ️  Plugin restored: registry serves it again on each user's next skill sync.`);
+  } else if (args.status === 'BETA') {
+    console.log(`\n⚠️  BETA is NOT served either: registry sync / system load / user install all filter status='ACTIVE' (optima-skills internal.ts & user-plugins.ts). Users lose the plugin on their next sync, same as DEPRECATED — it's a pre-GA gate, not a soft-launch channel.`);
+  }
+}

package/bin/helpers/plugin.ts

@@ -3,6 +3,7 @@
 import { runShow } from './plugin/show';
 import { runSetPaid } from './plugin/set-paid';
 import { runSetDefault } from './plugin/set-default';
+import { runSetStatus } from './plugin/set-status';
 
 function printHelp() {
   console.log(`Usage: optima-plugin <subcommand> [options]
@@ -11,6 +12,7 @@ Subcommands:
   show          Show a plugin's marketplace state (isPaid, salesUrl, ... ACTIVE plugins only)
   set-paid      Flip a plugin's isPaid flag (the user-facing paid/free gate)
   set-default   Flip a plugin's defaultForUser flag
+  set-status    Set a plugin's lifecycle status (ACTIVE|BETA|DEPRECATED — retire/restore)
 
 Run 'optima-plugin <subcommand> --help' for subcommand-specific options.`);
 }
@@ -22,6 +24,7 @@ async function main() {
     case 'show': await runShow(rest); break;
     case 'set-paid': await runSetPaid(rest); break;
     case 'set-default': await runSetDefault(rest); break;
+    case 'set-status': await runSetStatus(rest); break;
     default:
       console.error(`Unknown subcommand: ${subcommand}`);
       printHelp();

package/dist/bin/helpers/plugin/set-status.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALID_PLUGIN_STATUSES = void 0;
+exports.parseSetStatusArgs = parseSetStatusArgs;
+exports.runSetStatus = runSetStatus;
+const billing_http_1 = require("../billing-http");
+const confirm_prompt_1 = require("../confirm-prompt");
+exports.VALID_PLUGIN_STATUSES = ['ACTIVE', 'BETA', 'DEPRECATED'];
+// Aligned with agent-runtime skill-sync-handler's isValidSlug (and the
+// deprecate-plugin workflow guard in optima-default-skills#40).
+const SLUG_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/;
+function parseSetStatusArgs(argv) {
+    if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help') {
+        console.log(`Usage: optima-plugin set-status --slug <slug> --status ACTIVE|BETA|DEPRECATED [options]
+
+Required:
+  --slug <slug>
+  --status <status>    Sets Plugin.status (marketplace lifecycle gate).
+                       DEPRECATED retires the plugin: registry sync stops
+                       serving it and agents unload it on their next sync
+                       (in-flight sessions keep it until then). ACTIVE
+                       restores it. Fully reversible.
+
+Optional:
+  --yes                Skip prod confirmation prompt (no-op on stage)
+  --env <env>          stage|prod|cn-prod|cn-stage (default: stage)
+
+Note: this PATCH's 404 is the authoritative "slug has no marketplace row in
+this env" signal. Don't use 'optima-plugin show' to check existence — it reads
+the public endpoint, which also 404s for non-ACTIVE (e.g. already-DEPRECATED)
+plugins.`);
+        process.exit(0);
+    }
+    const out = { env: 'stage', yes: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        const next = argv[i + 1];
+        switch (a) {
+            case '--slug':
+                out.slug = next;
+                i++;
+                break;
+            case '--status': {
+                const upper = (next ?? '').toUpperCase();
+                if (!exports.VALID_PLUGIN_STATUSES.includes(upper)) {
+                    throw new Error(`--status must be one of: ${exports.VALID_PLUGIN_STATUSES.join('|')}`);
+                }
+                out.status = upper;
+                i++;
+                break;
+            }
+            case '--yes':
+                out.yes = true;
+                break;
+            case '--env':
+                out.env = next;
+                i++;
+                break;
+            default: throw new Error(`Unknown arg: ${a}`);
+        }
+    }
+    if (!out.slug)
+        throw new Error('--slug required');
+    if (!SLUG_RE.test(out.slug))
+        throw new Error(`--slug must match ${SLUG_RE} (lowercase slug, e.g. onboarding-research)`);
+    if (!out.status)
+        throw new Error(`--status required (${exports.VALID_PLUGIN_STATUSES.join('|')})`);
+    return out;
+}
+async function runSetStatus(argv) {
+    const args = parseSetStatusArgs(argv);
+    (0, billing_http_1.validateEnvCnProd)(args.env);
+    await (0, confirm_prompt_1.confirmIfProd)(args.env, `Action: set status=${args.status} on plugin '${args.slug}' (${args.env.toUpperCase()})`, args.yes);
+    console.log(`\n🚦 Setting status=${args.status} on ${args.slug} (${args.env.toUpperCase()})...`);
+    const res = await (0, billing_http_1.callSkills)(args.env, 'PATCH', `/api/admin/plugins/${encodeURIComponent(args.slug)}`, { status: args.status });
+    console.log(`✓ Updated plugin (HTTP ${res.status}):`);
+    console.log(JSON.stringify(res.body, null, 2));
+    if (args.status === 'DEPRECATED') {
+        console.log(`\nℹ️  Takes effect on each user's next skill sync (new session / billing event): registry stops serving the plugin and agents unload its skills. In-flight sessions keep it until then. Restore anytime with --status ACTIVE. Verify retirement end-to-end by confirming an agent session no longer loads the plugin's skills.`);
+    }
+    else if (args.status === 'ACTIVE') {
+        console.log(`\nℹ️  Plugin restored: registry serves it again on each user's next skill sync.`);
+    }
+    else if (args.status === 'BETA') {
+        console.log(`\n⚠️  BETA is NOT served either: registry sync / system load / user install all filter status='ACTIVE' (optima-skills internal.ts & user-plugins.ts). Users lose the plugin on their next sync, same as DEPRECATED — it's a pre-GA gate, not a soft-launch channel.`);
+    }
+}

package/dist/bin/helpers/plugin.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const show_1 = require("./plugin/show");
 const set_paid_1 = require("./plugin/set-paid");
 const set_default_1 = require("./plugin/set-default");
+const set_status_1 = require("./plugin/set-status");
 function printHelp() {
     console.log(`Usage: optima-plugin <subcommand> [options]
 
@@ -11,6 +12,7 @@ Subcommands:
   show          Show a plugin's marketplace state (isPaid, salesUrl, ... ACTIVE plugins only)
   set-paid      Flip a plugin's isPaid flag (the user-facing paid/free gate)
   set-default   Flip a plugin's defaultForUser flag
+  set-status    Set a plugin's lifecycle status (ACTIVE|BETA|DEPRECATED — retire/restore)
 
 Run 'optima-plugin <subcommand> --help' for subcommand-specific options.`);
 }
@@ -30,6 +32,9 @@ async function main() {
         case 'set-default':
             await (0, set_default_1.runSetDefault)(rest);
             break;
+        case 'set-status':
+            await (0, set_status_1.runSetStatus)(rest);
+            break;
         default:
             console.error(`Unknown subcommand: ${subcommand}`);
             printHelp();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/dev-skills",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "Claude Code Skills for Optima development team - cross-environment collaboration tools",
   "main": "index.js",
   "bin": {