@optima-chat/dev-skills 0.16.7 → 0.16.8

package/dist/bin/helpers/verify-health.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
 /**
  * optima-verify-health —— 服务上线健康探针(L1 DNS / L2 TLS / L3-L5 /health)。
  *
@@ -52,8 +53,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
  *
  * 用法:
  *   optima-verify-health user-auth                  # 默认 cn-prod
- *   optima-verify-health user-auth --env prod        # 环境 stage|prod|cn|all
- *   optima-verify-health --all --env all             # stage/prod/cn 三环境矩阵
+ *   optima-verify-health user-auth --env prod        # 环境 stage|prod|cn-prod|cn-stage|all
+ *   optima-verify-health --all --env all             # stage/prod/cn-prod/cn-stage 四环境矩阵
  *   optima-verify-health gateway-core --expect-commit a1b2c3d
  *   optima-verify-health --url https://auth.yzsgo.com/health
  *   optima-verify-health --all --json                # 机器可读,接 CI
@@ -67,16 +68,28 @@ const https = __importStar(require("node:https"));
 // cn-prod 真实 subdomain 抄自 optima-terraform alicloud/stacks/cn-prod-ingress-sae/main.tf。
 // #201 (2026-06-12): yzsgo.com 全量迁移完成,旧 *-cn.optima.chat 路由已下线。
 // cn-stage（阿里云预发）域名 *.stage.optima.chat，抄自 cn-stage-ingress-sae services map。
+// #83 (2026-08-13): AWS stage 是 *.stage.optima.onl（点号），旧的连字符形式 *-stage.optima.onl
+// 已不再路由到服务——三项实测 301 → www.optima.onl，探测恒红并误报成「疑似未部署」。
+// 🔴 别只看 stage 列：agentic-chat 的 prod 也踩同一个坑（见下面那行的注释）。
 const SERVICES = {
-    'user-auth': { path: '/health', stage: 'auth-stage.optima.onl', prod: 'auth.optima.onl', cn: 'auth.yzsgo.com', 'cn-stage': 'auth.stage.optima.chat' },
-    'agentic-chat': { path: '/api/health', stage: 'ai-stage.optima.onl', prod: 'ai.optima.onl', cn: 'app.yzsgo.com', 'cn-stage': 'app.stage.optima.chat' },
-    'commerce-backend': { path: '/health', stage: 'api-stage.optima.onl', prod: 'api.optima.onl', cn: 'commerce.yzsgo.com', cn_path: '/health/live', 'cn-stage': 'commerce.stage.optima.chat', 'cn-stage_path': '/health/live' },
-    'mcp-host': { path: '/health', stage: 'mcp-stage.optima.onl', prod: 'mcp.optima.onl' },
-    'gateway-core': { path: '/health', cn: 'gw.yzsgo.com', 'cn-stage': 'gw.stage.optima.chat' },
-    'optima-scout': { path: '/health', cn: 'scout.yzsgo.com', 'cn-stage': 'scout.stage.optima.chat' },
-    'optima-skills': { path: '/health', cn: 'skills.yzsgo.com', 'cn-stage': 'skills.stage.optima.chat' },
+    'user-auth': { path: '/health', stage: 'auth.stage.optima.onl', prod: 'auth.optima.onl', 'cn-prod': 'auth.yzsgo.com', 'cn-stage': 'auth.stage.optima.chat' },
+    // agentic-chat 的 prod 入口是 www 不是 ai：prod-ecs/variables.tf 里它的 subdomain = "www"，
+    // 且 main.tf 有一条 ai_to_www_redirect(priority 309) 专门把 ai.optima.onl 301 到 www。
+    // 实测 ai.optima.onl/api/health → 301；www.optima.onl/api/health → 200 service=agentic-chat。
+    'agentic-chat': { path: '/api/health', stage: 'ai.stage.optima.onl', prod: 'www.optima.onl', 'cn-prod': 'app.yzsgo.com', 'cn-stage': 'app.stage.optima.chat' },
+    'commerce-backend': { path: '/health', stage: 'api.stage.optima.onl', prod: 'api.optima.onl', 'cn-prod': 'commerce.yzsgo.com', 'cn-prod_path': '/health/live', 'cn-stage': 'commerce.stage.optima.chat', 'cn-stage_path': '/health/live' },
+    // #83: mcp-host 已于 2025-12-18 下线,故不在表内 —— optima-terraform origin/main(f97adbb) 的
+    // stage-ecs/variables.tf:146 与 prod-ecs/variables.tf:508 都写着「MCP 工具服务已移除」,
+    // 两个 ecs stack 的 services map 里均无该条目;实测四个候选主机名全是壳(mcp.stage.optima.onl
+    // 307 → /en-US/health 前端 locale 路由,mcp-stage.optima.onl 与 prod 的 mcp.optima.onl 均
+    // 301 → www)。🔴 别再把它加回来:worstOk 是全局单标志(见 main()),留着它会让 `--all --env stage`
+    // 与 `--all --env prod` 恒 exit 1,而那个退出码正是接 CI 卡口时唯一被读的东西。
+    // 同一约束在 tests/service-matrix-alignment.test.js 里对 show-env 的清单也钉着。
+    'gateway-core': { path: '/health', 'cn-prod': 'gw.yzsgo.com', 'cn-stage': 'gw.stage.optima.chat' },
+    'optima-scout': { path: '/health', 'cn-prod': 'scout.yzsgo.com', 'cn-stage': 'scout.stage.optima.chat' },
+    'optima-skills': { path: '/health', 'cn-prod': 'skills.yzsgo.com', 'cn-stage': 'skills.stage.optima.chat' },
 };
-const ENVS = ['stage', 'prod', 'cn', 'cn-stage'];
+const ENVS = ['stage', 'prod', 'cn-prod', 'cn-stage'];
 const G = '\x1b[32m', R = '\x1b[31m', Y = '\x1b[33m', B = '\x1b[34m', N = '\x1b[0m';
 const MARK = { ok: `${G}✅${N}`, fail: `${R}❌${N}`, warn: `${Y}⚠️ ${N}`, na: `${B}··${N}` };
 const verdict = (ls) => ls.some((l) => l.result === 'fail') ? 'fail' : ls.some((l) => l.result === 'warn') ? 'warn' : 'pass';
@@ -194,21 +207,66 @@ function resolve(svc, e) {
     const path = cfg[`${e}_path`] || cfg.path;
     return [`${svc} [${e}]`, host, path];
 }
+// 🔴 不认识的输入一律报错、绝不静默丢弃（同 query-db.ts 的 parseQueryDbArgs、logs.ts 的 parseArgs）：
+// 此前 `--env=stage` 不认、`--env` 漏写取值、多敲一个位置参数都会被静默无视而回落默认 cn-prod ——
+// 想探 stage，实际探的是阿里云生产，还 exit 0。
+function parseArgs(argv) {
+    const flags = new Set(), vals = {}, positional = [];
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        const eq = arg.startsWith('--') ? arg.indexOf('=') : -1;
+        const name = eq > 0 ? arg.slice(0, eq) : arg;
+        if (['--env', '--expect-commit', '--url'].includes(name)) {
+            const v = eq > 0 ? arg.slice(eq + 1) : argv[++i];
+            if (!v || v.startsWith('-'))
+                throw new Error(`${name} 缺少取值`);
+            vals[name] = v;
+        }
+        else if (['--json', '--strict', '--all', '--help', '-h'].includes(arg))
+            flags.add(arg);
+        else if (arg.startsWith('-'))
+            throw new Error(`未知参数:${arg}`);
+        else
+            positional.push(arg);
+    }
+    // 🔴 必须先校验再转型：不校验的话任何不认识的 env 都会让 resolve() 把每个 SvcCfg 键查成
+    // undefined，于是落到下面的「无目标」分支，把「环境名打错」报成「该服务无部署」——
+    // 一个活着的服务被说成没上线，正是 #83 要根治的那类静默误报。
+    let envArg = vals['--env'] || 'cn-prod';
+    // 'cn' 是本文件的历史叫法，继续放行但不在 usage 里宣传（同 query-db.ts 的 ENV_ALIASES）。
+    if (envArg === 'cn')
+        envArg = 'cn-prod';
+    if (envArg !== 'all' && !ENVS.includes(envArg))
+        throw new Error(`未知环境:${envArg}(可选:${ENVS.join(' | ')} | all)`);
+    if (positional.length > 1)
+        throw new Error(`多余参数:${positional.slice(1).join(' ')}(一次探一个服务;环境用 --env 指定)`);
+    const service = positional[0];
+    if (service && !Object.keys(SERVICES).includes(service))
+        throw new Error(`未知服务:${service}(可选:${Object.keys(SERVICES).join(' | ')})`);
+    const url = vals['--url'], all = flags.has('--all');
+    return { help: flags.has('--help') || flags.has('-h') || !(url || all || service), json: flags.has('--json'), strict: flags.has('--strict'), all, env: envArg, expect: vals['--expect-commit'], url, service };
+}
 async function main() {
-    const argv = process.argv.slice(2);
-    const has = (f) => argv.includes(f);
-    const val = (f) => { const i = argv.indexOf(f); return i >= 0 ? argv[i + 1] : undefined; };
-    const asJson = has('--json'), strict = has('--strict');
-    const expect = val('--expect-commit');
-    const env = (val('--env') || 'cn');
+    let args;
+    try {
+        args = parseArgs(process.argv.slice(2));
+    }
+    catch (e) {
+        console.error(`❌ ${e.message}`);
+        process.exit(2);
+    }
+    const { json: asJson, strict, expect, env } = args;
     const envs = env === 'all' ? ENVS : [env];
-    const positional = argv.filter((x, i) => !x.startsWith('--') && !(i > 0 && argv[i - 1].startsWith('--') && ['--env', '--expect-commit', '--url'].includes(argv[i - 1])));
     let targets = [];
-    if (has('--url')) {
-        const u = new URL(val('--url'));
+    if (args.help) {
+        console.log((require('fs').readFileSync(__filename, 'utf-8').match(/\/\*\*[\s\S]*?\*\//)?.[0] || '').replace(/^\s*\*?/gm, ''));
+        process.exit(2);
+    }
+    else if (args.url) {
+        const u = new URL(args.url);
         targets = [[u.hostname, u.hostname, u.pathname || '/health']];
     }
-    else if (has('--all')) {
+    else if (args.all) {
         for (const e of envs)
             for (const s of Object.keys(SERVICES)) {
                 const t = resolve(s, e);
@@ -216,17 +274,13 @@ async function main() {
                     targets.push(t);
             }
     }
-    else if (positional[0] && SERVICES[positional[0]]) {
+    else if (args.service) {
         for (const e of envs) {
-            const t = resolve(positional[0], e);
+            const t = resolve(args.service, e);
             if (t)
                 targets.push(t);
         }
     }
-    else {
-        console.log((require('fs').readFileSync(__filename, 'utf-8').match(/\/\*\*[\s\S]*?\*\//)?.[0] || '').replace(/^\s*\*?/gm, ''));
-        process.exit(2);
-    }
     if (targets.length === 0) {
         console.log(`(无目标:${env} 环境下该服务无部署)`);
         process.exit(2);
@@ -252,4 +306,6 @@ async function main() {
     // 用 exitCode 而非 process.exit():后者会在管道(--json | jq)未 flush 完就退出而截断输出
     process.exitCode = worstOk ? 0 : 1;
 }
-main();
+if (require.main === module) {
+    main();
+}

package/package.json

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