@optima-chat/dev-skills 0.13.1 → 0.15.0

package/.claude/skills/cn-deploy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cn-deploy
-description: 当用户请求把服务发布/部署/构建到 cn-stage、跑云效流水线、cn-stage 发版、部署某个分支到 cn-stage、触发 cn 构建、yunxiao 部署、"把 xx 发到 cn"时，使用此技能。覆盖 cn-stage 全部 20 个服务（构建→DB迁移→SAE 发布一条龙）。
+description: 当用户请求把服务发布/部署/构建到 cn-stage、跑云效流水线、cn-stage 发版、部署某个分支到 cn-stage、触发 cn 构建、yunxiao 部署、"把 xx 发到 cn"时，使用此技能。覆盖 cn-stage 全部 21 个服务（构建→DB迁移→SAE 发布一条龙；含 build-only 的 agent-runtime）。
 ---
 
 # cn-deploy - 云效 cn-stage 流水线发布
@@ -21,12 +21,13 @@ optima-cn-deploy --list                       # 列出全部可发服务
 
 ## 使用要点
 
-1. **先 `--list` 确认服务名**（20 个服务，含 commerce-backend / optima-scout）。
+1. **先 `--list` 确认服务名**（21 个服务，含 commerce-backend / optima-scout / build-only 的 agent-runtime）。
 2. 全链约 3-8 分钟（agentic-chat 最重）。触发后会输出云效 run 链接，可发给用户自行围观。
 3. **凭证零配置**：构建凭证由云效变量组 `cn-stage-build-credentials`(41970) 供给，不需要注入任何 secret。
 4. 分支构建会把该分支代码部署到 cn-stage（替换现运行版本）——用户明确要求部署分支时才用。
 5. 失败排查：命令输出的 flow.aliyun.com 链接里看具体 step 日志；常见原因是该分支/仓的 Codeup mirror 凭证问题（命令会在 mirror 步就报错并中止，不会构建旧代码）。
 6. 成功标准：最后一行 `✓ SAE ImageUrl tag=<sha>` —— 流水线绿且 SAE 真的钉到了目标 commit。只看流水线绿不算完成。
+7. **build-only 服务（`agent-runtime`）**：非 SAE 常驻（gateway-core 按 session 拉起的镜像）。成功标准不是 SAE ImageUrl，而是流水线绿即可——release 段自动把 ACR digest 回写 Infisical `/services/gateway-core/ALIYUN_AGENT_RUNTIME_IMAGE`(#807) 并滚动重启 gateway-core（任一步失败即 exit 非 0）。工具最后一行为 `✓ 流水线 SUCCESS(build-only)…` —— CLI 以流水线终态为准，未独立校验 Infisical/gateway-core（digest 与重启变更单见 run『发版』段日志）。
 
 
 ## cn-prod vtag 发版（⚠️ 待 svenyang 首次验证通过后再日常使用）

package/.codex/skills/cn-deploy/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cn-deploy
-description: 当用户请求把服务发布/部署/构建到 cn-stage、跑云效流水线、cn-stage 发版、部署某个分支到 cn-stage、触发 cn 构建、yunxiao 部署、"把 xx 发到 cn"时，使用此技能。覆盖 cn-stage 全部 20 个服务（构建→DB迁移→SAE 发布一条龙）。
+description: 当用户请求把服务发布/部署/构建到 cn-stage、跑云效流水线、cn-stage 发版、部署某个分支到 cn-stage、触发 cn 构建、yunxiao 部署、"把 xx 发到 cn"时，使用此技能。覆盖 cn-stage 全部 21 个服务（构建→DB迁移→SAE 发布一条龙；含 build-only 的 agent-runtime）。
 ---
 
 # cn-deploy - 云效 cn-stage 流水线发布
@@ -21,12 +21,13 @@ optima-cn-deploy --list                       # 列出全部可发服务
 
 ## 使用要点
 
-1. **先 `--list` 确认服务名**（20 个服务，含 commerce-backend / optima-scout）。
+1. **先 `--list` 确认服务名**（21 个服务，含 commerce-backend / optima-scout / build-only 的 agent-runtime）。
 2. 全链约 3-8 分钟（agentic-chat 最重）。触发后会输出云效 run 链接，可发给用户自行围观。
 3. **凭证零配置**：构建凭证由云效变量组 `cn-stage-build-credentials`(41970) 供给，不需要注入任何 secret。
 4. 分支构建会把该分支代码部署到 cn-stage（替换现运行版本）——用户明确要求部署分支时才用。
 5. 失败排查：命令输出的 flow.aliyun.com 链接里看具体 step 日志；常见原因是该分支/仓的 Codeup mirror 凭证问题（命令会在 mirror 步就报错并中止，不会构建旧代码）。
 6. 成功标准：最后一行 `✓ SAE ImageUrl tag=<sha>` —— 流水线绿且 SAE 真的钉到了目标 commit。只看流水线绿不算完成。
+7. **build-only 服务（`agent-runtime`）**：非 SAE 常驻（gateway-core 按 session 拉起的镜像）。成功标准不是 SAE ImageUrl，而是流水线绿即可——release 段自动把 ACR digest 回写 Infisical `/services/gateway-core/ALIYUN_AGENT_RUNTIME_IMAGE`(#807) 并滚动重启 gateway-core（任一步失败即 exit 非 0）。工具最后一行为 `✓ 流水线 SUCCESS(build-only)…` —— CLI 以流水线终态为准，未独立校验 Infisical/gateway-core（digest 与重启变更单见 run『发版』段日志）。
 
 
 ## cn-prod vtag 发版（⚠️ 待 svenyang 首次验证通过后再日常使用）

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/cn-deploy.ts

@@ -34,9 +34,13 @@ const PROFILE = process.env.OPTIMA_ALIYUN_PROFILE || 'aliyun-optima';
 const CODEUP_BASE = `https://codeup.aliyun.com/${ORG}`;
 
 // 服务注册表(快照自 optima-terraform services.stage.env + gen-pipelines.py,2026-07-13)
-interface Svc { pipelineId: number; repo: string; saeAppId?: string; prodSaeAppId?: string; }
+interface Svc { pipelineId: number; repo: string; saeAppId?: string; prodSaeAppId?: string; buildOnly?: boolean; }
 const SERVICES: Record<string, Svc> = {
   'agent-portal':             { pipelineId: 5118519, repo: 'optima-portals',     saeAppId: 'fe757f78-d18d-4480-9402-fe59d4721055', prodSaeAppId: '9211db38-a255-4393-ae92-7a7bb41b583d' },
+  // build-only:非 SAE 常驻(gateway-core 按 session 拉起的镜像)。release 段=解析 ACR digest
+  // → 回写 Infisical /services/gateway-core/ALIYUN_AGENT_RUNTIME_IMAGE(#807)→ 滚动重启 gateway-core。
+  // 无自身 saeAppId;prod 流水线(agent-runtime-cn-prod,5124970)按名实时解析(见下方 ListPipelines 逻辑)。
+  'agent-runtime':            { pipelineId: 5124962, repo: 'optima-gateway',     buildOnly: true },
   'agentic-chat':             { pipelineId: 5118520, repo: 'agentic-chat',       saeAppId: '6aea1ce1-f813-4e1c-8e97-d1ecb5398e37', prodSaeAppId: '6e290c73-a646-43ef-9da5-ad0b2e7eff73' },
   'billing':                  { pipelineId: 5118521, repo: 'optima-billing',     saeAppId: '09d8e292-dc64-4af8-bce5-0a56cb666921', prodSaeAppId: '6c31cf82-8802-4d45-b6a2-e9d7c83ccce9' },
   'browser-backend':          { pipelineId: 5118522, repo: 'optima-browser-use', saeAppId: '1fced3f6-a80a-41a4-8f23-e4d5a467f8eb', prodSaeAppId: 'eb782ed9-c468-4e81-a0fe-87e5b4264192' },
@@ -161,7 +165,17 @@ async function main() {
   console.log(`${status === 'SUCCESS' ? '✅' : '❌'} ${svcName} run#${runId}: ${status}`);
   if (status !== 'SUCCESS') process.exit(1);
 
-  // 4. SAE ImageUrl 校验(空返回重试守卫)。prod 是 digest 寻址,校验含 @sha256 即部署成功。
+  // 4. 成功标准。build-only(agent-runtime)无自身 SAE app 可查:digest 回写 Infisical +
+  //    滚动重启 gateway-core 都在流水线 release 段内完成(任一步失败即 exit 非 0)。CLI 不碰
+  //    Infisical 凭证,只以流水线终态为准、不独立校验回写是否真落地——故措辞用「应已」而非「已」;
+  //    真实 digest / 重启变更单在 run『发版』段日志里(见上方链接)。
+  if (svc.buildOnly) {
+    const infEnv = envName === 'prod' ? 'prod' : 'staging';
+    console.log(`✓ 流水线 SUCCESS(build-only)。release 段应已回写 ${infEnv} Infisical ALIYUN_AGENT_RUNTIME_IMAGE(@sha256 digest)并滚动重启 gateway-core;CLI 未独立校验,digest 见上方 run『发版』段日志`);
+    return;
+  }
+
+  // SAE ImageUrl 校验(空返回重试守卫)。prod 是 digest 寻址,校验含 @sha256 即部署成功。
   const appId = envName === 'prod' ? svc.prodSaeAppId : svc.saeAppId;
   if (appId) {
     let img = '';

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/cn-deploy.js

@@ -35,6 +35,10 @@ const PROFILE = process.env.OPTIMA_ALIYUN_PROFILE || 'aliyun-optima';
 const CODEUP_BASE = `https://codeup.aliyun.com/${ORG}`;
 const SERVICES = {
     'agent-portal': { pipelineId: 5118519, repo: 'optima-portals', saeAppId: 'fe757f78-d18d-4480-9402-fe59d4721055', prodSaeAppId: '9211db38-a255-4393-ae92-7a7bb41b583d' },
+    // build-only:非 SAE 常驻(gateway-core 按 session 拉起的镜像)。release 段=解析 ACR digest
+    // → 回写 Infisical /services/gateway-core/ALIYUN_AGENT_RUNTIME_IMAGE(#807)→ 滚动重启 gateway-core。
+    // 无自身 saeAppId;prod 流水线(agent-runtime-cn-prod,5124970)按名实时解析(见下方 ListPipelines 逻辑)。
+    'agent-runtime': { pipelineId: 5124962, repo: 'optima-gateway', buildOnly: true },
     'agentic-chat': { pipelineId: 5118520, repo: 'agentic-chat', saeAppId: '6aea1ce1-f813-4e1c-8e97-d1ecb5398e37', prodSaeAppId: '6e290c73-a646-43ef-9da5-ad0b2e7eff73' },
     'billing': { pipelineId: 5118521, repo: 'optima-billing', saeAppId: '09d8e292-dc64-4af8-bce5-0a56cb666921', prodSaeAppId: '6c31cf82-8802-4d45-b6a2-e9d7c83ccce9' },
     'browser-backend': { pipelineId: 5118522, repo: 'optima-browser-use', saeAppId: '1fced3f6-a80a-41a4-8f23-e4d5a467f8eb', prodSaeAppId: 'eb782ed9-c468-4e81-a0fe-87e5b4264192' },
@@ -191,7 +195,16 @@ async function main() {
     console.log(`${status === 'SUCCESS' ? '✅' : '❌'} ${svcName} run#${runId}: ${status}`);
     if (status !== 'SUCCESS')
         process.exit(1);
-    // 4. SAE ImageUrl 校验(空返回重试守卫)。prod 是 digest 寻址,校验含 @sha256 即部署成功。
+    // 4. 成功标准。build-only(agent-runtime)无自身 SAE app 可查:digest 回写 Infisical +
+    //    滚动重启 gateway-core 都在流水线 release 段内完成(任一步失败即 exit 非 0)。CLI 不碰
+    //    Infisical 凭证,只以流水线终态为准、不独立校验回写是否真落地——故措辞用「应已」而非「已」;
+    //    真实 digest / 重启变更单在 run『发版』段日志里(见上方链接)。
+    if (svc.buildOnly) {
+        const infEnv = envName === 'prod' ? 'prod' : 'staging';
+        console.log(`✓ 流水线 SUCCESS(build-only)。release 段应已回写 ${infEnv} Infisical ALIYUN_AGENT_RUNTIME_IMAGE(@sha256 digest)并滚动重启 gateway-core;CLI 未独立校验,digest 见上方 run『发版』段日志`);
+        return;
+    }
+    // SAE ImageUrl 校验(空返回重试守卫)。prod 是 digest 寻址,校验含 @sha256 即部署成功。
     const appId = envName === 'prod' ? svc.prodSaeAppId : svc.saeAppId;
     if (appId) {
         let img = '';

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.15.0",
   "description": "Claude Code Skills for Optima development team - cross-environment collaboration tools",
   "main": "index.js",
   "bin": {