@thejrsoft/subway-protocol 1.4.14 → 1.6.0

package/CHANGELOG.md

@@ -1,5 +1,217 @@
 # Changelog
 
+## [1.6.0] - 2026-05-13
+
+### ⚠️ BREAKING CHANGES — 硬切，零兼容（系统未上线）
+
+#### 1. CodeMeta 单一信息源 — status / level 由 report.code 派生
+
+新设计：所有协议消息的 `status` 和 `level` 字段由 `report.code` 通过 `CodeMeta` 表自动派生。
+集成方收到消息后调用 `resolveCodeMeta(code)` 查表得到 `semantic` / `requiresErrorBlock` 等元数据。
+
+```typescript
+import { resolveCodeMeta } from '@thejrsoft/subway-protocol';
+
+const meta = resolveCodeMeta(msg.report.code);
+// meta: { isTerminal, status, level, semantic, requiresErrorBlock }
+switch (meta.semantic) {
+  case 'success': /* ALL_SUCCESS / ALL_ONLINE 等 */ break;
+  case 'partial': /* PARTIAL_SUCCESS / PARTIAL_ONLINE */ break;
+  case 'failure': /* ALL_FAILED / UPLOAD_FAILED */    break;
+  case 'busy':    /* BUSY 并发拒绝 */                break;
+  case 'cancel':  /* CANCELLED */                    break;
+  case 'no-op':   /* NO_PROGRAMS */                  break;
+  // 进度语义: phase_start / phase_end / phase_failed / step_success ...
+}
+```
+
+#### 2. MessageStatus 单一 enum 取代 CommandStatus / ProgressStatus
+
+```typescript
+// v1.5.0 (已删)
+enum CommandStatus  { COMPLETED, FAILED, TIMEOUT, CANCELLED, IN_PROGRESS }  ← 删
+enum ProgressStatus { PENDING, IN_PROGRESS, PAUSED, COMPLETED, FAILED, CANCELLED } ← 删
+
+// v1.6.0 (新)
+enum MessageStatus { IN_PROGRESS, COMPLETED, FAILED, CANCELLED }
+```
+
+**删除的死代码值**:
+- `ProgressStatus.PENDING` / `PAUSED`（v1.5.0 内 0 引用）
+- `CommandStatus.TIMEOUT` 语义迁移到 `status=FAILED + data.error.category='TIMEOUT'`
+
+#### 3. dispatchMessage 统一发消息接口
+
+替代旧 `MessageFactory.createCommandResponseMessage` / `createProgramResponseMessage` /
+`createProgressUpdateMessage`：
+
+```typescript
+MessageFactory.dispatchMessage({
+  clientId, requestRef,
+  code: 'PROGRAM_COMPLETED',  // 单一信息源
+  message: 'Program upload completed',
+  data: { totalPrograms: 5, successCount: 5 },
+  // status / level / 消息类型由 CodeMeta 自动推导
+});
+```
+
+设备端只填 `code` 和业务字段，违反 META 决策矩阵的风险归零。
+
+#### 4. 拆分歧义 code — 一码一义原则
+
+`PROGRAM_UPLOAD_FAILED` v1.5.0 既表 FAILED 又表 BUSY → v1.6.0 拆分：
+- `PROGRAM_UPLOAD_FAILED`：仅表异常中断（status=FAILED + level=ERROR）
+- `PROGRAM_UPLOAD_BUSY`：独立 code，表并发拒绝（status=FAILED + level=WARNING）
+
+### 新增
+
+- `MessageStatus` enum（4 值）
+- `CodeMeta` interface（5 字段）
+- `CodeSemantic` 联合类型（15 值，覆盖终态 + 进度）
+- `EXPLICIT_META` 终态显式表（~14 entries）
+- `SUFFIX_RULES` 进度后缀规则（9 条）
+- `resolveCodeMeta(code)` / `isKnownCode(code)` 工具函数
+- `MessageFactory.dispatchMessage(params)` 统一发消息接口
+
+### 删除
+
+- ✂️ `enum CommandStatus`（v1.5.0 5 值）
+- ✂️ `enum ProgressStatus`（v1.5.0 6 值）
+- ✂️ `CommandStatus.TIMEOUT`（合并到 data.error.category）
+- ✂️ `ProgressStatus.PENDING` / `PAUSED`（0 引用死代码）
+
+### Migration
+
+```typescript
+// v1.5.0
+import { CommandStatus, ProgressStatus, MessageFactory } from '@thejrsoft/subway-protocol';
+const msg = MessageFactory.createCommandResponseMessage(
+  clientId, requestRef, CommandStatus.COMPLETED, result, message,
+);
+
+// v1.6.0
+import { MessageStatus, MessageFactory } from '@thejrsoft/subway-protocol';
+const msg = MessageFactory.dispatchMessage({
+  clientId, requestRef,
+  code: 'SYNC_FUNCTIONS_SWITCH_WRITE_SUCCESS',  // 单一信息源
+  message: 'Switch set to On',
+  result,
+});
+// status (COMPLETED) + level (INFO) 自动从 code 派生
+```
+
+### 协议设计依据
+
+完整设计原则、决策回放（CodeMeta 设计奇点、status 合并理由、为什么 semantic 不进消息等）
+见 `claude-docs/protocol-upgrade-proposal-v1.6.0.md`。
+
+---
+
+## [1.5.0] - 2026-05-12
+
+### ⚠️ BREAKING CHANGES — 无兼容、无 fallback（系统未上线）
+
+#### 1. 统一失败信号 schema（`data.error` 嵌套对象）
+
+所有失败上报（`level=ERROR` / `status=FAILED`）必须使用新 schema：
+
+```json
+{
+  "report": {
+    "code": "PROGRAM_UPLOAD_FAILED",
+    "level": "ERROR",
+    "message": "Program download timed out",
+    "messageEn": "Program download timed out",
+    "data": {
+      "error": {
+        "phase": "PROGRAM_FETCH",
+        "step": "Download",
+        "category": "TIMEOUT",
+        "detail": "HTTP 504 from CDN after 30s, 3/3 attempts"
+      }
+    }
+  }
+}
+```
+
+#### 2. 新增 / 移除字段
+
+**新增**:
+- `ReportMessage.messageEn?: string` — 英文文本（与 message 同义，便于 i18n 兼容）
+- `ReportData` 接口（含 `error?: ErrorInfo` + 业务字段 index signature）
+- `ErrorInfo` 接口（`phase` / `step` / `category` / `detail` 4 字段全必填）
+- `ErrorPhase` 类型（15 个值，与 ProgressPhase 对齐）
+- `ErrorStep` 类型（21 个值的 closed enum）
+- `ErrorCategory` 类型（**7 类**：在 v1.4.14 的 4 类基础上加 `CONFIGURATION` / `PROTOCOL` / `AUTHORIZATION`）
+- `ERROR_STEP_BY_PHASE` 映射常量（强校验 step ↔ phase 归属）
+- 工具函数：`VALID_ERROR_CATEGORIES` / `isValidErrorCategory()` / `normalizeErrorCategory()` / `isValidErrorStepForPhase()`
+- `ProgressPhase` 枚举新增 2 个值：`PROGRAM_INIT`（任务初始化）/ `PROGRAM_COMPLETE`（终态边界）
+
+**删除**:
+- `ReportMessage.category` 顶层字段（下沉到 `data.error.category`）
+- `ReportCategory` 类型（重命名为 `ErrorCategory`，并扩到 7 类）
+- `VALID_REPORT_CATEGORIES` / `isValidReportCategory()` / `normalizeReportCategory()`（重命名为 `VALID_ERROR_CATEGORIES` 等）
+- `data.failedPhase` / `data.failedSubStage` / `data.failedReason` 平铺字段（合并到 `data.error.*`）
+- PROGRAM 命令 6 个独立失败 code（统一为 `PROGRAM_UPLOAD_FAILED` + `data.error.*`）：
+  - `PROGRAM_DOWNLOAD_FAILED`
+  - `PROGRAM_CHECKSUM_MISMATCH`
+  - `PROGRAM_COMPILE_FAILED`
+  - `PROGRAM_COMPILE_ERROR`
+  - `PROGRAM_DEPLOY_NOT_INITIALIZED`
+  - `PROGRAM_DEPLOY_ERROR`
+- `failedReason` 6 值枚举（合并到 `category` + `step` + `detail`）
+
+#### 3. COMPLEX 命令统一生命周期
+
+所有 COMPLEX 命令统一为 `{CMD}_INIT (progress=0%) → 业务 phase → {CMD}_COMPLETE (progress=100%)`：
+
+- PROGRAM 命令新增 `PROGRAM_INIT` / `PROGRAM_COMPLETE` phase（8 phase 序列）
+- 终态决策矩阵在 `PROGRAM_COMPLETE` 触发（唯一收尾点）
+- BUSY 并发拒绝场景从"特例"变成 `PROGRAM_INIT.CheckConcurrency` 阶段正常失败
+
+#### 4. PROGRAM phase 序列重排（6 → 8）
+
+| 序号 | phase | progress |
+|---|---|---|
+| 0 | `PROGRAM_INIT` | 0% |
+| 1 | `PROGRAM_FETCH` | 1~15% |
+| 2 | `PROGRAM_EXTRACT` | 16~25% |
+| 3 | `PROGRAM_PREPROCESS` | 26~50% |
+| 4 | `PROGRAM_COMPILE` | 51~70% |
+| 5 | `PROGRAM_UPLOAD` | 71~95% |
+| 6 | `PROGRAM_STATS` | 96~99% |
+| 7 | `PROGRAM_COMPLETE` | 100% |
+
+### Migration
+
+设备端 (C#):
+1. 新增 `ErrorPhase` / `ErrorStep` / `ErrorCategory` 强类型 enum
+2. `ReportMessage` 移除 `Category` 顶层，新增 `ReportData.Error`
+3. 新建 `ErrorClassifier` 集中归类异常 → (phase, step, category) 三元组
+4. PROGRAM 编排器 6 处独立失败 code 调用改用 `ErrorClassifier.Classify(...)` 生成 `ErrorInfo`
+5. 新增 `PROGRAM_INIT` / `PROGRAM_COMPLETE` phase 上报
+
+第三方 (TypeScript/JS):
+```javascript
+function parseFailureMessage(msg) {
+  if (msg.report.level !== 'ERROR' && msg.status !== 'FAILED') return null;
+  const err = msg.report.data?.error;
+  if (!err) return null;
+  return {
+    category: err.category,                              // 粗分类（告警/聚合）
+    location: `${err.phase}.${err.step}`,                // 细位置（诊断/UI）
+    i18nKey: `${err.phase}.${err.step}.${err.category}`, // i18n key
+    diagnostic: err.detail,                              // 日志/调试
+  };
+}
+```
+
+### 协议设计依据
+
+完整设计原则、决策回放（11 个关键技术选择记录）、归类决策树、错误映射表见 `claude-docs/protocol-upgrade-proposal-v1.5.0.md`。
+
+---
+
 ## [1.4.14] - 2026-05-11
 
 ### Added (零破坏 / minor bump)

package/dist/asyncapi-sync.js

@@ -15,7 +15,7 @@ function generateAsyncApiEnums() {
         ClientType: Object.values(index_1.ClientType),
         OperationType: Object.values(index_1.OperationType),
         Priority: Object.values(index_1.Priority),
-        CommandStatus: Object.values(index_1.CommandStatus)
+        MessageStatus: Object.values(index_1.MessageStatus)
     };
     return `
 # AsyncAPI Enum Definitions
@@ -39,9 +39,9 @@ components:
       type: string
       enum: ${JSON.stringify(enums.Priority)}
     
-    CommandStatus:
+    MessageStatus:
       type: string
-      enum: ${JSON.stringify(enums.CommandStatus)}
+      enum: ${JSON.stringify(enums.MessageStatus)}
   `;
 }
 /**

package/dist/code-meta.d.ts

@@ -0,0 +1,57 @@
+/**
+ * CodeMeta — v1.6.0 协议核心
+ *
+ * report.code 是业务命运的单一信息源；status / level / semantic 全部由此派生。
+ *
+ * 设备端调用 dispatchMessage(code, data) 时，协议层自动按 code 推导 status / level，
+ * 集成方接收消息后调用 resolveCodeMeta(code) 查表得到 semantic / requiresErrorBlock 等。
+ *
+ * 设计依据：claude-docs/protocol-upgrade-proposal-v1.6.0.md
+ */
+import type { ReportLevel } from './index';
+/** v1.6.0：单一 status enum，合并 v1.5.0 的 CommandStatus + ProgressStatus */
+export declare enum MessageStatus {
+    IN_PROGRESS = "IN_PROGRESS",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    CANCELLED = "CANCELLED"
+}
+/** 业务语义分类——终态语义 + 进度语义 */
+export type CodeSemantic = 'success' | 'partial' | 'failure' | 'no-op' | 'cancel' | 'busy' | 'phase_start' | 'phase_end' | 'phase_failed' | 'step_success' | 'step_skipped' | 'step_progress' | 'retry' | 'retry_pending' | 'warning';
+/**
+ * 单一 code 的元数据描述符
+ *
+ * 派生字段（status / level）会序列化进消息；
+ * 客户端字段（semantic / requiresErrorBlock / isTerminal）仅供查表，不进消息。
+ */
+export interface CodeMeta {
+    isTerminal: boolean;
+    status: MessageStatus;
+    level: ReportLevel;
+    semantic: CodeSemantic;
+    requiresErrorBlock: boolean;
+}
+/**
+ * 终态 code 显式 META 表
+ *
+ * 这些 code 是业务命运决断点，每个语义都是独特的，**不能用后缀规则推导**。
+ * 设备端发送终态消息时，dispatchMessage 在此表查询，自动填充消息字段。
+ */
+export declare const EXPLICIT_META: Record<string, CodeMeta>;
+/**
+ * 单一 code 解析入口
+ *
+ * 解析顺序：
+ *   1. 终态显式表（EXPLICIT_META） — 30 个 closed enum
+ *   2. 后缀规则（SUFFIX_RULES） — 9 条规则覆盖数百个进度 code
+ *   3. 兜底（FALLBACK_META） — 未知 code 降级
+ *
+ * @param code report.code 字符串
+ * @returns CodeMeta — status / level / semantic / requiresErrorBlock / isTerminal
+ */
+export declare function resolveCodeMeta(code: string): CodeMeta;
+/**
+ * 判断 code 是否已知（命中显式表或后缀规则，不走兜底）
+ */
+export declare function isKnownCode(code: string): boolean;
+//# sourceMappingURL=code-meta.d.ts.map

package/dist/code-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-meta.d.ts","sourceRoot":"","sources":["../src/code-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,uEAAuE;AACvE,oBAAY,aAAa;IACvB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED,0BAA0B;AAC1B,MAAM,MAAM,YAAY,GAEpB,SAAS,GACT,SAAS,GACT,SAAS,GACT,OAAO,GACP,QAAQ,GACR,MAAM,GAEN,aAAa,GACb,WAAW,GACX,cAAc,GACd,cAAc,GACd,cAAc,GACd,eAAe,GACf,OAAO,GACP,eAAe,GACf,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAwGlD,CAAC;AAoHF;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAatD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOjD"}

package/dist/code-meta.js

@@ -0,0 +1,268 @@
+"use strict";
+/**
+ * CodeMeta — v1.6.0 协议核心
+ *
+ * report.code 是业务命运的单一信息源；status / level / semantic 全部由此派生。
+ *
+ * 设备端调用 dispatchMessage(code, data) 时，协议层自动按 code 推导 status / level，
+ * 集成方接收消息后调用 resolveCodeMeta(code) 查表得到 semantic / requiresErrorBlock 等。
+ *
+ * 设计依据：claude-docs/protocol-upgrade-proposal-v1.6.0.md
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXPLICIT_META = exports.MessageStatus = void 0;
+exports.resolveCodeMeta = resolveCodeMeta;
+exports.isKnownCode = isKnownCode;
+/** v1.6.0：单一 status enum，合并 v1.5.0 的 CommandStatus + ProgressStatus */
+var MessageStatus;
+(function (MessageStatus) {
+    MessageStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    MessageStatus["COMPLETED"] = "COMPLETED";
+    MessageStatus["FAILED"] = "FAILED";
+    MessageStatus["CANCELLED"] = "CANCELLED";
+})(MessageStatus || (exports.MessageStatus = MessageStatus = {}));
+/**
+ * 终态 code 显式 META 表
+ *
+ * 这些 code 是业务命运决断点，每个语义都是独特的，**不能用后缀规则推导**。
+ * 设备端发送终态消息时，dispatchMessage 在此表查询，自动填充消息字段。
+ */
+exports.EXPLICIT_META = {
+    // ═══════════ PROGRAM 节目部署 ═══════════
+    PROGRAM_COMPLETED: {
+        isTerminal: true,
+        status: MessageStatus.COMPLETED,
+        level: 'INFO',
+        semantic: 'success',
+        requiresErrorBlock: false,
+    },
+    PROGRAM_PARTIALLY_SUCCEEDED: {
+        isTerminal: true,
+        status: MessageStatus.COMPLETED,
+        level: 'WARNING',
+        semantic: 'partial',
+        requiresErrorBlock: false,
+    },
+    PROGRAM_ALL_FAILED: {
+        isTerminal: true,
+        status: MessageStatus.FAILED,
+        level: 'ERROR',
+        semantic: 'failure',
+        requiresErrorBlock: true,
+    },
+    PROGRAM_NO_PROGRAMS: {
+        isTerminal: true,
+        status: MessageStatus.COMPLETED,
+        level: 'INFO',
+        semantic: 'no-op',
+        requiresErrorBlock: false,
+    },
+    PROGRAM_UPLOAD_FAILED: {
+        isTerminal: true,
+        status: MessageStatus.FAILED,
+        level: 'ERROR',
+        semantic: 'failure',
+        requiresErrorBlock: true,
+    },
+    PROGRAM_UPLOAD_BUSY: {
+        isTerminal: true,
+        status: MessageStatus.FAILED,
+        level: 'WARNING',
+        semantic: 'busy',
+        requiresErrorBlock: true,
+    },
+    PROGRAM_UPLOAD_CANCELLED: {
+        isTerminal: true,
+        status: MessageStatus.CANCELLED,
+        level: 'WARNING',
+        semantic: 'cancel',
+        requiresErrorBlock: true,
+    },
+    // ═══════════ QUICKLY_DETECTION 一键检测 ═══════════
+    QUICK_DETECTION_ALL_ONLINE: {
+        isTerminal: true,
+        status: MessageStatus.COMPLETED,
+        level: 'INFO',
+        semantic: 'success',
+        requiresErrorBlock: false,
+    },
+    QUICK_DETECTION_PARTIAL_ONLINE: {
+        isTerminal: true,
+        status: MessageStatus.COMPLETED,
+        level: 'WARNING',
+        semantic: 'partial',
+        requiresErrorBlock: false,
+    },
+    QUICK_DETECTION_ALL_OFFLINE: {
+        isTerminal: true,
+        status: MessageStatus.COMPLETED,
+        level: 'ERROR',
+        semantic: 'failure',
+        requiresErrorBlock: true,
+    },
+    QUICK_DETECTION_FAILED: {
+        isTerminal: true,
+        status: MessageStatus.FAILED,
+        level: 'ERROR',
+        semantic: 'failure',
+        requiresErrorBlock: true,
+    },
+    QUICK_DETECTION_BUSY: {
+        isTerminal: true,
+        status: MessageStatus.FAILED,
+        level: 'WARNING',
+        semantic: 'busy',
+        requiresErrorBlock: true,
+    },
+    // ═══════════ SYNC_MONITORING_TABLE 监播导出 ═══════════
+    SYNC_MONITORING_TABLE_READ_SUCCESS: {
+        isTerminal: true,
+        status: MessageStatus.COMPLETED,
+        level: 'INFO',
+        semantic: 'success',
+        requiresErrorBlock: false,
+    },
+    SYNC_MONITORING_TABLE_READ_FAILED: {
+        isTerminal: true,
+        status: MessageStatus.FAILED,
+        level: 'ERROR',
+        semantic: 'failure',
+        requiresErrorBlock: true,
+    },
+};
+const SUFFIX_RULES = [
+    {
+        suffix: '_FAILED',
+        meta: {
+            status: MessageStatus.IN_PROGRESS,
+            level: 'ERROR',
+            semantic: 'phase_failed',
+            requiresErrorBlock: true,
+        },
+    },
+    {
+        suffix: '_RETRY_PENDING',
+        meta: {
+            status: MessageStatus.IN_PROGRESS,
+            level: 'WARNING',
+            semantic: 'retry_pending',
+            requiresErrorBlock: false,
+        },
+    },
+    {
+        suffix: '_RETRY',
+        meta: {
+            status: MessageStatus.IN_PROGRESS,
+            level: 'WARNING',
+            semantic: 'retry',
+            requiresErrorBlock: false,
+        },
+    },
+    {
+        // 后缀或中缀都命中：例 PROGRAM_UPLOAD_WARN_CAN_BUS_ALARM
+        infix: '_WARN',
+        meta: {
+            status: MessageStatus.IN_PROGRESS,
+            level: 'WARNING',
+            semantic: 'warning',
+            requiresErrorBlock: false,
+        },
+    },
+    {
+        suffix: '_SKIPPED',
+        meta: {
+            status: MessageStatus.IN_PROGRESS,
+            level: 'INFO',
+            semantic: 'step_skipped',
+            requiresErrorBlock: false,
+        },
+    },
+    {
+        suffix: '_COMPLETED',
+        meta: {
+            status: MessageStatus.IN_PROGRESS,
+            level: 'INFO',
+            semantic: 'phase_end',
+            requiresErrorBlock: false,
+        },
+    },
+    {
+        suffix: '_START',
+        meta: {
+            status: MessageStatus.IN_PROGRESS,
+            level: 'INFO',
+            semantic: 'phase_start',
+            requiresErrorBlock: false,
+        },
+    },
+    {
+        suffix: '_PROGRESS',
+        meta: {
+            status: MessageStatus.IN_PROGRESS,
+            level: 'INFO',
+            semantic: 'step_progress',
+            requiresErrorBlock: false,
+        },
+    },
+    {
+        suffix: '_SUCCESS',
+        meta: {
+            status: MessageStatus.IN_PROGRESS,
+            level: 'INFO',
+            semantic: 'step_success',
+            requiresErrorBlock: false,
+        },
+    },
+];
+/**
+ * 兜底 META（未知 code 时返回）
+ *
+ * 接收方收到未知 code 时降级到 step_progress，避免阻塞协议处理。
+ */
+const FALLBACK_META = {
+    isTerminal: false,
+    status: MessageStatus.IN_PROGRESS,
+    level: 'INFO',
+    semantic: 'step_progress',
+    requiresErrorBlock: false,
+};
+/**
+ * 单一 code 解析入口
+ *
+ * 解析顺序：
+ *   1. 终态显式表（EXPLICIT_META） — 30 个 closed enum
+ *   2. 后缀规则（SUFFIX_RULES） — 9 条规则覆盖数百个进度 code
+ *   3. 兜底（FALLBACK_META） — 未知 code 降级
+ *
+ * @param code report.code 字符串
+ * @returns CodeMeta — status / level / semantic / requiresErrorBlock / isTerminal
+ */
+function resolveCodeMeta(code) {
+    if (exports.EXPLICIT_META[code]) {
+        return exports.EXPLICIT_META[code];
+    }
+    for (const rule of SUFFIX_RULES) {
+        if (rule.suffix && code.endsWith(rule.suffix)) {
+            return { isTerminal: false, ...rule.meta };
+        }
+        if (rule.infix && code.includes(rule.infix)) {
+            return { isTerminal: false, ...rule.meta };
+        }
+    }
+    return FALLBACK_META;
+}
+/**
+ * 判断 code 是否已知（命中显式表或后缀规则，不走兜底）
+ */
+function isKnownCode(code) {
+    if (exports.EXPLICIT_META[code])
+        return true;
+    for (const rule of SUFFIX_RULES) {
+        if (rule.suffix && code.endsWith(rule.suffix))
+            return true;
+        if (rule.infix && code.includes(rule.infix))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=code-meta.js.map

package/dist/code-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-meta.js","sourceRoot":"","sources":["../src/code-meta.ts"],"names":[],"mappings":"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"}