@apollo-music/dsh-sidecar-terms 0.1.2 → 0.1.4

package/README.md

@@ -9,16 +9,16 @@
 5. request 尚未固定时 inject，step 已开始或已有候选回答时 steer；
 6. steer 修订后不再审计同一 turn 的后续 assistant 输出，避免规则回执自我触发；下一 turn 自动恢复；
 7. 最终答案前只 steer 尚未交付的 canonical term / Rule delta。
-8. Catalog 或 Resolver 暂不可用时启用内置 P0 快照；高风险核心词仍受控，其余无法确认的候选词保留原文并标记复核。
+8. Catalog、Resolver、鉴权或网络不可用时失败关闭，不生成离线替代规则。
 
-内置快照只承担故障降级，不替代线上全量 102 术语目录。降级消息带 `degraded` 语义并写入 Harness warning 日志；远程目录恢复后按 `catalogRefreshMs` 自动重试。
+插件固定只读 `https://apollomusic-poc1.fde0.com/kb/terminology`。`apiUrl` 不再是运行时配置项，线上服务返回 `degraded` 也会按错误处理；插件不包含本地术语表或 P0 fallback。
 
 ## 安装
 
 在 DeepSeek Harness 项目中安装：
 
 ```bash
-npm install @apollo-music/dsh-sidecar-terms
+npm install @apollo-music/dsh-sidecar-terms@0.1.4
 ```
 
 ## 配置
@@ -29,7 +29,7 @@ npm install @apollo-music/dsh-sidecar-terms
 export APOLLO_TERMINOLOGY_READ_API_KEY='<READ_ONLY_API_KEY>'
 ```
 
-本地调试与未来公网部署使用同一个 HTTP 契约，只需切换 `apiUrl`。本地服务默认可运行在 `http://localhost:3092`；公网部署后改为 HTTPS 域名，插件代码和 Agent 配置无需变化。
+只需把线上服务的只读凭据注入 Harness 进程。服务地址由插件版本锁定，不能通过环境变量或 Composition 改写。
 
 在 DeepSeek Harness 的 `cordis.yml` 插件列表中加入。Cordis 的 `name` 支持 npm 包名：
 
@@ -37,7 +37,6 @@ export APOLLO_TERMINOLOGY_READ_API_KEY='<READ_ONLY_API_KEY>'
 - id: apollo-terminology-rules
   name: '@apollo-music/dsh-sidecar-terms'
   config:
-    apiUrl: 'http://localhost:3092'
     apiKeyEnv: 'APOLLO_TERMINOLOGY_READ_API_KEY'
     queryIntervalMs: 0
     catalogRefreshMs: 60000
@@ -55,17 +54,13 @@ npm ci
 npm run build:harness-plugin
 ```
 
-本地与公网示例：
+凭据示例：
 
 ```bash
-# 本地
-export APOLLO_TERMINOLOGY_API_URL='http://localhost:3092'
-
-# 未来公网
-export APOLLO_TERMINOLOGY_API_URL='https://terminology.example.com'
+export APOLLO_TERMINOLOGY_READ_API_KEY='<READ_ONLY_API_KEY>'
 ```
 
-插件不会注册模型可见 Tool，也不拦截或改写最终答案。命中后注入的内容以 `[阿波罗术语库：原文增量]` 开头，仅包含 API 返回的新增 term/rule 数据；知识库版本、revision 或降级状态没有变化时也不重复。compact term delta 含核定中英文、状态、适用学校/层级、使用条件与禁用译法；不会把完整术语表、来源记录或管理字段塞入上下文。`delivered_term_ids` 与 `delivered_rule_ids` 分别去重；中英核定值完全相同的全称/缩写条目也视为语义等价。
+插件不会注册模型可见 Tool，也不拦截或改写最终答案。命中后注入的内容以 `[阿波罗术语库：原文增量]` 开头，仅包含 API 返回的新增 term/rule 数据；知识库版本或 revision 没有变化时也不重复。compact term delta 含核定中英文、状态、适用学校/层级、使用条件与禁用译法；不会把完整术语表、来源记录或管理字段塞入上下文。`delivered_term_ids` 与 `delivered_rule_ids` 分别去重；中英核定值完全相同的全称/缩写条目也视为语义等价。
 
 由于 Harness 的运行时 context 与 steer 消息使用 user role，宿主 persona 必须在 **system prompt** 中预先声明执行协议；不要把协议文字重复放进每批 Delta。使用 `complete: true` 的 persona 时，协议必须直接写入该完整 persona，例如：
 
@@ -79,9 +74,9 @@ export APOLLO_TERMINOLOGY_API_URL='https://terminology.example.com'
 
 `auditReasoning: true` 只匹配每个 step 已提交的完整 reasoning block；流式 `reasoning-delta` 不参与匹配。thinking 原文只发送给 Resolver 做瞬时匹配，不会回注给模型。若部署边界不允许 thinking 离开 Harness 进程，可设为 `false`。
 
-该插件声明依赖 `agents`、`sessions` 与 `tools`；Cordis 会等相关服务存在后再加载。官方 Harness 目前仍处于 Developer Preview，本项目锁定并测试 `0.1.0-rc.8` 的公开 `Agent`、`session/event`、`tools/post-execute`、`agent/pre-step`、`agent/turn-stopping` 接口。
+该插件声明依赖 `agents`、`sessions` 与 `tools`；Cordis 会等相关服务存在后再加载。官方 Harness 目前仍处于 Developer Preview，本项目锁定并测试 `0.1.1-rc.2` 的公开 `Agent`、`session/event`、`tools/post-execute`、`agent/pre-step`、`agent/turn-stopping` 接口。包清单显式声明这一组接口的完整 DSH peer 闭包，避免依赖宿主包管理器自动补齐隐式 peer。
 
-在线验证（本地 API 已启动时）：
+配置线上只读凭据后验证：
 
 ```bash
 npm run test:api

package/dist/api.d.ts

@@ -1,4 +1,5 @@
 import type { CatalogResponse, PluginConfig, ResolveResponse } from "./types.js";
+export declare const APOLLO_TERMINOLOGY_API_URL = "https://apollomusic-poc1.fde0.com/kb/terminology";
 export declare class TerminologyApi {
     private readonly config;
     private readonly apiKey;

package/dist/api.js

@@ -1,4 +1,4 @@
-import { FALLBACK_CATALOG, resolveWithP0Fallback } from "./fallback.js";
+export const APOLLO_TERMINOLOGY_API_URL = "https://apollomusic-poc1.fde0.com/kb/terminology";
 export class TerminologyApi {
     config;
     apiKey;
@@ -18,35 +18,30 @@ export class TerminologyApi {
             if (!Array.isArray(value.entries) || typeof value.catalog_revision !== "number") {
                 throw new Error("Terminology catalog response is malformed");
             }
+            if (value.degraded) {
+                throw new Error(`Terminology catalog returned a degraded response: ${value.fallback_reason ?? "reason unavailable"}`);
+            }
             this.catalog = { value, fetchedAt: Date.now() };
             return value;
-        }).catch((error) => {
-            const fallback = this.catalog?.value ?? {
-                ...FALLBACK_CATALOG,
-                fallback_reason: errorMessage(error),
-            };
-            const degraded = {
-                ...fallback,
-                degraded: true,
-                fallback_reason: `live catalog unavailable: ${errorMessage(error)}`,
-            };
-            this.catalog = { value: degraded, fetchedAt: Date.now() };
-            return degraded;
         }).finally(() => {
             this.catalogRequest = undefined;
         });
         return this.catalogRequest;
     }
-    resolve(body) {
-        return this.request("resolve", {
+    async resolve(body) {
+        const value = await this.request("resolve", {
             method: "POST",
             body: JSON.stringify(body),
-        }).catch((error) => resolveWithP0Fallback(body, `resolver unavailable: ${errorMessage(error)}`));
+        });
+        if (value.degraded) {
+            throw new Error(`Terminology resolver returned a degraded response: ${value.fallback_reason ?? "reason unavailable"}`);
+        }
+        return value;
     }
     async request(path, init = {}) {
-        const baseUrl = this.config.apiUrl.replace(/\/+$/, "");
-        const response = await this.fetchImpl(`${baseUrl}/api/v1/${path}`, {
+        const response = await this.fetchImpl(`${APOLLO_TERMINOLOGY_API_URL}/api/v1/${path}`, {
             ...init,
+            redirect: "error",
             headers: {
                 Accept: "application/json",
                 "X-API-Key": this.apiKey,
@@ -64,6 +59,3 @@ export class TerminologyApi {
         return value;
     }
 }
-function errorMessage(error) {
-    return error instanceof Error ? error.message : String(error);
-}

package/dist/coordinator.js

@@ -177,9 +177,6 @@ export class TerminologyCoordinator {
                 delivered_rule_ids: this.knownRuleIds(state),
                 delivered_term_ids: this.knownTermIds(state),
             });
-            if (response.degraded) {
-                this.logger.warn("terminology resolver degraded through seq %d: %s", throughSeq, response.fallback_reason ?? "bundled P0 snapshot");
-            }
             const checkpoint = {
                 throughSeq,
                 complete: response.rule_delta.length === 0 && (response.term_delta?.length ?? 0) === 0,
@@ -295,9 +292,6 @@ export function renderDelta(response, metadataUpdate = "initial") {
     else if (metadataUpdate === "changed") {
         lines.push(`知识库状态更新：版本 ${response.kb_version}，catalog revision ${response.catalog_revision}。`);
     }
-    if (response.degraded && metadataUpdate !== "unchanged") {
-        lines.push("远程术语库暂不可用；当前使用内置 P0 保守规则。");
-    }
     for (const term of response.term_delta ?? [])
         lines.push(...renderTerm(term));
     for (const rule of response.rule_delta)
@@ -308,7 +302,6 @@ function metadataSnapshot(response) {
     return {
         kbVersion: response.kb_version,
         catalogRevision: response.catalog_revision,
-        degraded: response.degraded === true,
     };
 }
 function metadataDelta(current, response) {
@@ -316,7 +309,6 @@ function metadataDelta(current, response) {
         return "initial";
     return current.kbVersion !== response.kb_version
         || current.catalogRevision !== response.catalog_revision
-        || current.degraded !== (response.degraded === true)
         ? "changed"
         : "unchanged";
 }

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export type Config = PluginConfig;
 export declare const Config: Schema<Config>;
 export declare function apply(ctx: Context, config: Config): void;
 export declare function messageText(message: Message, auditReasoning?: boolean): string;
-export { TerminologyApi } from "./api.js";
+export { APOLLO_TERMINOLOGY_API_URL, TerminologyApi } from "./api.js";
 export { TerminologyCoordinator } from "./coordinator.js";
 export { findCatalogMatches, normalizeMatchKey } from "./matcher.js";
 export type { AgentPort, CatalogEntry, CatalogResponse, ResolveResponse } from "./types.js";

package/dist/index.js

@@ -4,7 +4,6 @@ import { isOwnPluginMessage, TerminologyCoordinator } from "./coordinator.js";
 export const name = "apollo-terminology-rules";
 export const inject = ["agents", "sessions", "tools"];
 export const Config = Schema.object({
-    apiUrl: Schema.string().required().description("阿波罗术语库 API 根地址"),
     apiKeyEnv: Schema.string().default("APOLLO_TERMINOLOGY_READ_API_KEY").description("只读 API Key 所在环境变量名"),
     queryIntervalMs: Schema.natural().min(0).max(60_000).default(0).description("常规增量查询的最小间隔（毫秒）；默认即时查询"),
     catalogRefreshMs: Schema.natural().min(1_000).max(3_600_000).default(60_000).description("本地 matcher catalog 缓存时间"),
@@ -165,6 +164,6 @@ function blockText(block, auditReasoning) {
         return block.content.flatMap((item) => blockText(item, auditReasoning));
     return [];
 }
-export { TerminologyApi } from "./api.js";
+export { APOLLO_TERMINOLOGY_API_URL, TerminologyApi } from "./api.js";
 export { TerminologyCoordinator } from "./coordinator.js";
 export { findCatalogMatches, normalizeMatchKey } from "./matcher.js";

package/dist/types.d.ts

@@ -1,6 +1,5 @@
 import type { UserMessage } from "@deepseek-ai/dsh-llm";
 export interface PluginConfig {
-    apiUrl: string;
     apiKeyEnv: string;
     queryIntervalMs: number;
     catalogRefreshMs: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apollo-music/dsh-sidecar-terms",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "DeepSeek Harness sidecar plugin for incremental Apollo terminology and rule injection",
   "type": "module",
   "main": "dist/index.js",
@@ -36,14 +36,24 @@
     "sidecar"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json"
+    "build": "rm -rf dist && tsc -p tsconfig.json",
+    "prepack": "npm run build"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.8",
-    "@deepseek-ai/dsh-tools": "0.1.0-rc.8",
+    "@deepseek-ai/dsh-agent": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-brand": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-code-runtime": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-scope": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-timeout": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-user-approval": "0.1.1-rc.2",
     "@deepseek-ai/schemastery": "^3.18.1"
   }
 }

package/dist/fallback.d.ts

@@ -1,3 +0,0 @@
-import type { CatalogResponse, ResolveResponse } from "./types.js";
-export declare const FALLBACK_CATALOG: CatalogResponse;
-export declare function resolveWithP0Fallback(body: Record<string, unknown>, reason: string): ResolveResponse;

package/dist/fallback.js

@@ -1,169 +0,0 @@
-import { findCatalogMatches, normalizeMatchKey } from "./matcher.js";
-const VERSION = "0.1.0-p0-fallback";
-const P0_RULES = [
-    {
-        rule_id: "RULE-001",
-        priority: "P0",
-        trigger: "命中已锁定术语",
-        instruction: "严格使用知识库核定译法；当前离线快照不含完整译值时保留德文，不得自行改写。",
-        bad_example: "Musiktheater→音乐剧",
-        good_example: "Musiktheater→歌剧",
-    },
-    {
-        rule_id: "RULE-002",
-        priority: "P0",
-        trigger: "Musiktheater 与 Musical",
-        instruction: "先判断原词：Musiktheater 在音乐学院专业语境译歌剧；Musical 才译音乐剧。",
-        bad_example: "Gesang/Musiktheater→声乐/音乐剧",
-        good_example: "Gesang/Musiktheater→声乐/歌剧",
-    },
-    {
-        rule_id: "RULE-003",
-        priority: "P0",
-        trigger: "缩写 CoPeCo/KMM/KPA/EUJAM/EMP",
-        instruction: "首次出现必须输出中文全称＋规范缩写；缩写大小写按 canonical term。",
-        bad_example: "CopeCo；只写 KMM",
-        good_example: "当代表演与作曲联合硕士（CoPeCo）；文化与媒体管理（KMM）",
-    },
-    {
-        rule_id: "RULE-004",
-        priority: "P0",
-        trigger: "语境型术语但缺少学校/专业/学位上下文",
-        instruction: "保留德文原词，并返回 needs_review=true；不得猜译。",
-        bad_example: "Diplom 一律译硕士",
-        good_example: "Diplom（层级待逐校确认）",
-    },
-    {
-        rule_id: "RULE-005",
-        priority: "P0",
-        trigger: "离线快照不能确认术语",
-        instruction: "保留官方德文全称，标记 pending；禁止只保留未知缩写或自动生成中文名。",
-        bad_example: "未知项目自动生成中文名",
-        good_example: "保留德文＋中文译名待确认",
-    },
-    {
-        rule_id: "RULE-013",
-        priority: "P0",
-        trigger: "Solistenexamen/Solistenklasse/Solistenstudium 与 Konzertexamen",
-        instruction: "按官方原词分别保存，逐校核对层级；不得自动建立等价映射。",
-        bad_example: "Solistenexamen 一律译演奏家文凭",
-        good_example: "Solistenexamen（层级逐校确认）",
-    },
-];
-const FALLBACK_TERMS = {
-    "TERM-001": term("TERM-001", "Musiktheater", "歌剧", "Opera", "locked", "contextual", [], "仅限德国音乐学院专业语境；与 Musical 严格区分。", ["音乐剧", "Musical Theatre", "Musical Theater"]),
-    "TERM-002": term("TERM-002", "Musical", "音乐剧", "Musical Theatre", "locked", "generic", [], "与 Musiktheater 严格区分。", ["歌剧"]),
-    "TERM-016": term("TERM-016", "CoPeCo", "当代表演与作曲联合硕士（CoPeCo）", "Master’s in Contemporary Performance and Composition (CoPeCo)", "locked", "school_specific", ["hfmt-hamburg"], "首次出现必须写中文全称与规范缩写。", ["只写CoPeCo", "CopeCo", "不翻译"], "Contemporary Performance & Composition", "Master"),
-    "TERM-017": term("TERM-017", "Contemporary Performance & Composition", "当代表演与作曲联合硕士（CoPeCo）", "Master’s in Contemporary Performance and Composition (CoPeCo)", "locked", "school_specific", ["hfmt-hamburg"], "首次出现必须写中文全称与规范缩写。", ["不翻译"], "", "Master"),
-    "TERM-018": term("TERM-018", "KMM", "文化与媒体管理（KMM）", "Culture and Media Management (KMM)", "locked", "school_specific", ["hfmt-hamburg"], "首次出现必须写中文全称与规范缩写。", ["只写KMM", "艺术管理"]),
-    "TERM-019": term("TERM-019", "Kultur- und Medienmanagement", "文化与媒体管理（KMM）", "Culture and Media Management (KMM)", "locked", "school_specific", ["hfmt-hamburg"], "使用知识库核定中文名。", ["艺术管理"]),
-    "TERM-020": term("TERM-020", "EUJAM", "欧洲爵士硕士（EUJAM）", "European Jazz Master (EUJAM)", "locked", "school_specific", ["hfmt-hamburg"], "首次出现必须写中文全称与规范缩写。", ["只写EUJAM"]),
-    "TERM-021": term("TERM-021", "European Jazz Master", "欧洲爵士硕士（EUJAM）", "European Jazz Master (EUJAM)", "locked", "school_specific", ["hfmt-hamburg"], "使用知识库核定中文名。", []),
-    "TERM-026": term("TERM-026", "Konzertexamen", "演奏家文凭", "Advanced Performance Diploma (Konzertexamen)", "locked", "generic", [], "保留德文可用于院校差异追溯。", ["音乐会考试", "演奏考试"]),
-    "TERM-027": term("TERM-027", "Solistenexamen", "独奏家考试（Solistenexamen，层级逐校确认）", "Soloist Examination (level to be verified)", "contextual", "contextual", [], "与 Konzertexamen 相关但不等同，必须逐校确认。", ["一律等同Konzertexamen", "一律译演奏家文凭", "硕士", "博士"]),
-    "TERM-036": term("TERM-036", "Künstlerisch-Pädagogische Ausbildung (KPA)", "音乐教育（KPA）", "Artistic-Pedagogical Music Education (KPA)", "locked", "school_specific", ["udk-berlin"], "UdK 语境固定译音乐教育，学位层级另列。", ["只写KPA", "艺术与教育训练"]),
-    "TERM-063": term("TERM-063", "Elementare Musikpädagogik (EMP)", "基础音乐教育（EMP）", "Elementary Music Pedagogy (EMP)", "locked", "generic", [], "首次出现保留 EMP。", ["初级音乐教育"]),
-};
-const rawEntries = [
-    ["Künstlerisch-Pädagogische Ausbildung (KPA)", ["TERM-036"], ["RULE-001", "RULE-003"]],
-    ["Contemporary Performance & Composition", ["TERM-016", "TERM-017"], ["RULE-001", "RULE-003"]],
-    ["Elementare Musikpädagogik (EMP)", ["TERM-063"], ["RULE-001", "RULE-003"]],
-    ["Kultur- und Medienmanagement", ["TERM-018", "TERM-019"], ["RULE-001", "RULE-003"]],
-    ["European Jazz Master", ["TERM-020", "TERM-021"], ["RULE-001", "RULE-003"]],
-    ["Musiktheaterstudium", ["TERM-001"], ["RULE-001", "RULE-002"]],
-    ["Solistenstudium", [], ["RULE-013"]],
-    ["Solistenexamen", ["TERM-027"], ["RULE-004", "RULE-013"]],
-    ["Solistenklasse", [], ["RULE-013"]],
-    ["Konzertexamen", ["TERM-026"], ["RULE-001", "RULE-013"]],
-    ["Musiktheater", ["TERM-001"], ["RULE-001", "RULE-002"]],
-    ["European Jazz Master (EUJAM)", ["TERM-020"], ["RULE-001", "RULE-003"]],
-    ["Kultur- und Medienmanagement (KMM)", ["TERM-018"], ["RULE-001", "RULE-003"]],
-    ["Contemporary Performance & Composition (CoPeCo)", ["TERM-016"], ["RULE-001", "RULE-003"]],
-    ["Musical", ["TERM-002"], ["RULE-001", "RULE-002"]],
-    ["CoPeCo", ["TERM-016"], ["RULE-001", "RULE-003"]],
-    ["EUJAM", ["TERM-020"], ["RULE-001", "RULE-003"]],
-    ["KMM", ["TERM-018"], ["RULE-001", "RULE-003"]],
-    ["KPA", ["TERM-036"], ["RULE-001", "RULE-003"]],
-    ["EMP", ["TERM-063"], ["RULE-001", "RULE-003"]],
-];
-const entries = rawEntries
-    .map(([display, term_ids, rule_ids]) => ({ match_key: normalizeMatchKey(display), display, term_ids, rule_ids }))
-    .sort((a, b) => b.match_key.length - a.match_key.length || a.match_key.localeCompare(b.match_key));
-export const FALLBACK_CATALOG = {
-    kb_version: VERSION,
-    catalog_revision: 0,
-    generated_at: "2026-08-14T00:00:00.000Z",
-    entries,
-    degraded: true,
-    fallback_reason: "bundled P0 snapshot",
-};
-export function resolveWithP0Fallback(body, reason) {
-    const segments = Array.isArray(body.segments)
-        ? body.segments.filter(isSegment)
-        : [];
-    const delivered = new Set(Array.isArray(body.delivered_rule_ids)
-        ? body.delivered_rule_ids.filter((value) => typeof value === "string")
-        : []);
-    const deliveredTerms = new Set(Array.isArray(body.delivered_term_ids)
-        ? body.delivered_term_ids.filter((value) => typeof value === "string")
-        : []);
-    const ruleIds = new Set();
-    const hits = [];
-    for (const segment of segments) {
-        for (const entry of findCatalogMatches(segment.text, entries)) {
-            entry.rule_ids.forEach((ruleId) => ruleIds.add(ruleId));
-            entry.term_ids.forEach((termId) => hits.push({ term_id: termId, matched_text: entry.display }));
-        }
-    }
-    const candidates = Array.isArray(body.candidate_terms)
-        ? body.candidate_terms.filter((value) => typeof value === "string")
-        : [];
-    const unresolved = candidates
-        .filter((candidate) => !entries.some((entry) => entry.match_key === normalizeMatchKey(candidate)))
-        .map((matched_text) => ({ matched_text, reason: "unknown", candidate_term_ids: [] }));
-    if (unresolved.length)
-        ruleIds.add("RULE-005");
-    const dedupedHits = dedupeHits(hits);
-    return {
-        kb_version: VERSION,
-        catalog_revision: 0,
-        ...(typeof body.audit_through_seq === "number" ? { audit_through_seq: body.audit_through_seq } : {}),
-        hits: dedupedHits,
-        term_delta: [...new Set(dedupedHits.map((hit) => hit.term_id))]
-            .filter((termId) => !deliveredTerms.has(termId))
-            .flatMap((termId) => FALLBACK_TERMS[termId] ? [FALLBACK_TERMS[termId]] : []),
-        rule_delta: P0_RULES.filter((rule) => ruleIds.has(rule.rule_id) && !delivered.has(rule.rule_id)),
-        unresolved,
-        degraded: true,
-        fallback_reason: reason,
-    };
-}
-function term(term_id, source_term, preferred_zh, preferred_en, status, scope_type, school_ids, context_rule, forbidden_translations, full_form = "", degree_level = "") {
-    return {
-        term_id,
-        source_term,
-        full_form,
-        preferred_zh,
-        preferred_en,
-        official_en: "",
-        status,
-        scope_type,
-        school_ids,
-        degree_level,
-        context_rule,
-        forbidden_translations,
-    };
-}
-function isSegment(value) {
-    return Boolean(value && typeof value === "object" && "text" in value && typeof value.text === "string");
-}
-function dedupeHits(hits) {
-    const seen = new Set();
-    return hits.filter((hit) => {
-        const key = `${hit.term_id}:${hit.matched_text}`;
-        if (seen.has(key))
-            return false;
-        seen.add(key);
-        return true;
-    });
-}