create-principles-disciple 1.100.0 → 1.102.0

package/console/dist/ui/utils/signal-keywords-types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * signal-keywords-types — 信号关键词前端类型定义
+ *
+ * 镜像后端 UnifiedKeyword / PendingTerm 等类型，供控制台 UI 消费。
+ *
+ * ERR entries:
+ * - rc-1: 纯静态类型定义，无 untrusted 输入
+ * - rc-2: 无 `as` bypass
+ */
+export type KeywordCategory = 'correction' | 'empathy';
+/** 词库来源 — 词库中已有的审定点 */
+export type TermSource = 'seed' | 'migrated' | 'owner_promoted';
+export interface UnifiedKeyword {
+    term: string;
+    category: KeywordCategory;
+    /** 权重 0-1 */
+    weight: number;
+    /** 高精度 vs 歧义词 */
+    precision: 'high' | 'ambiguous';
+    source: TermSource;
+}
+export interface UnifiedKeywordStore {
+    version: number;
+    /** key = term */
+    terms: Record<string, UnifiedKeyword>;
+}
+/** 候选来源 — LLM 新发现的词（待 owner 审批） */
+export type PendingTermSource = 'llm_candidate';
+export interface PendingTerm {
+    term: string;
+    suggestedCategory: KeywordCategory;
+    suggestedPrecision: 'high' | 'ambiguous';
+    /** LLM 给出的发现理由 */
+    reason: string;
+    /** ISO 时间戳 */
+    discoveredAt: string;
+    source: PendingTermSource;
+}
+export interface PendingTermStore {
+    version: number;
+    terms: PendingTerm[];
+}
+/** 更新词库的请求体 */
+export interface UpdateKeywordStoreRequest {
+    version: number;
+    terms: Record<string, Omit<UnifiedKeyword, 'term'>>;
+}
+/** 审批一个 PendingTerm 的请求体 */
+export interface AdmitPendingTermRequest {
+    term: string;
+    category: KeywordCategory;
+    precision: 'high' | 'ambiguous';
+}
+/** SignalKeywordsPage 使用的关键词类型（UnifiedKeyword 的别名） */
+export type SignalKeyword = UnifiedKeyword;
+/** SignalKeywordsPage 使用的待确认信号词类型（PendingTerm 的别名） */
+export type PendingSignalTerm = PendingTerm;

package/console/dist/ui/utils/signal-keywords-types.js

@@ -0,0 +1,10 @@
+/**
+ * signal-keywords-types — 信号关键词前端类型定义
+ *
+ * 镜像后端 UnifiedKeyword / PendingTerm 等类型，供控制台 UI 消费。
+ *
+ * ERR entries:
+ * - rc-1: 纯静态类型定义，无 untrusted 输入
+ * - rc-2: 无 `as` bypass
+ */
+export {};

package/console/dist/ui/utils/signal-keywords-validators.d.ts

@@ -0,0 +1,20 @@
+/**
+ * signal-keywords-validators — 信号关键词 API 响应运行时校验
+ *
+ * 遵循 rc-1 ~ rc-5 运行时契约规则：
+ * - rc-1: 将 parsed JSON 作 unknown 处理
+ * - rc-2: 不用 as bypass，用 typeof / Array.isArray / type guard
+ * - rc-3: 必填字段缺失时 loud fail（返回 null）
+ * - rc-4: 校验数组元素类型
+ * - rc-5: 用 Object.hasOwn 而非 in
+ *
+ * ERR entries:
+ * - ERR-001: unknown 输入 -> runtime validation
+ * - ERR-005: 数组元素逐项校验
+ * - ERR-007: 拒绝非数组 payload
+ * - ERR-009: 必填字段 loud fail
+ * - ERR-013: 用 Object.hasOwn 替代 in
+ */
+import type { UnifiedKeywordStore, PendingTermStore } from './signal-keywords-types.js';
+export declare function validateUnifiedKeywordStore(raw: unknown): UnifiedKeywordStore | null;
+export declare function validatePendingTermStore(raw: unknown): PendingTermStore | null;

package/console/dist/ui/utils/signal-keywords-validators.js

@@ -0,0 +1,114 @@
+/**
+ * signal-keywords-validators — 信号关键词 API 响应运行时校验
+ *
+ * 遵循 rc-1 ~ rc-5 运行时契约规则：
+ * - rc-1: 将 parsed JSON 作 unknown 处理
+ * - rc-2: 不用 as bypass，用 typeof / Array.isArray / type guard
+ * - rc-3: 必填字段缺失时 loud fail（返回 null）
+ * - rc-4: 校验数组元素类型
+ * - rc-5: 用 Object.hasOwn 而非 in
+ *
+ * ERR entries:
+ * - ERR-001: unknown 输入 -> runtime validation
+ * - ERR-005: 数组元素逐项校验
+ * - ERR-007: 拒绝非数组 payload
+ * - ERR-009: 必填字段 loud fail
+ * - ERR-013: 用 Object.hasOwn 替代 in
+ */
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+// ── UnifiedKeywordStore ───────────────────────────────────────────────────────
+export function validateUnifiedKeywordStore(raw) {
+    if (!isRecord(raw))
+        return null;
+    if (!Object.hasOwn(raw, 'version') || !Object.hasOwn(raw, 'terms')) {
+        return null;
+    }
+    const { version } = raw;
+    const { terms } = raw;
+    if (typeof version !== 'number')
+        return null;
+    if (!isRecord(terms))
+        return null;
+    // rc-4: 校验每个 term 条目
+    const validatedTerms = {};
+    for (const [termKey, termRaw] of Object.entries(terms)) {
+        if (!isRecord(termRaw))
+            return null;
+        if (!Object.hasOwn(termRaw, 'term') ||
+            !Object.hasOwn(termRaw, 'category') ||
+            !Object.hasOwn(termRaw, 'weight') ||
+            !Object.hasOwn(termRaw, 'precision') ||
+            !Object.hasOwn(termRaw, 'source')) {
+            return null;
+        }
+        const t = termRaw;
+        if (typeof t.term !== 'string' ||
+            t.term.length === 0 ||
+            (t.category !== 'correction' && t.category !== 'empathy') ||
+            typeof t.weight !== 'number' ||
+            Number.isNaN(t.weight) ||
+            t.weight < 0 ||
+            t.weight > 1 ||
+            (t.precision !== 'high' && t.precision !== 'ambiguous') ||
+            (t.source !== 'seed' && t.source !== 'migrated' && t.source !== 'owner_promoted')) {
+            return null;
+        }
+        validatedTerms[termKey] = {
+            term: t.term,
+            category: t.category,
+            weight: t.weight,
+            precision: t.precision,
+            source: t.source,
+        };
+    }
+    return { version, terms: validatedTerms };
+}
+// ── PendingTermStore ──────────────────────────────────────────────────────────
+export function validatePendingTermStore(raw) {
+    if (!isRecord(raw))
+        return null;
+    if (!Object.hasOwn(raw, 'version') || !Object.hasOwn(raw, 'terms')) {
+        return null;
+    }
+    const { version } = raw;
+    const { terms } = raw;
+    if (typeof version !== 'number')
+        return null;
+    if (!Array.isArray(terms))
+        return null;
+    // rc-4: 校验每个 pending term
+    const validatedTerms = [];
+    for (const itemRaw of terms) {
+        if (!isRecord(itemRaw))
+            return null;
+        if (!Object.hasOwn(itemRaw, 'term') ||
+            !Object.hasOwn(itemRaw, 'suggestedCategory') ||
+            !Object.hasOwn(itemRaw, 'suggestedPrecision') ||
+            !Object.hasOwn(itemRaw, 'reason') ||
+            !Object.hasOwn(itemRaw, 'discoveredAt')) {
+            return null;
+        }
+        const t = itemRaw;
+        if (typeof t.term !== 'string' ||
+            t.term.length === 0 ||
+            (t.suggestedCategory !== 'correction' && t.suggestedCategory !== 'empathy') ||
+            (t.suggestedPrecision !== 'high' && t.suggestedPrecision !== 'ambiguous') ||
+            typeof t.reason !== 'string' ||
+            typeof t.discoveredAt !== 'string') {
+            return null;
+        }
+        validatedTerms.push({
+            term: t.term,
+            suggestedCategory: t.suggestedCategory,
+            suggestedPrecision: t.suggestedPrecision,
+            reason: t.reason,
+            discoveredAt: t.discoveredAt,
+            // source 总是 'llm_candidate'
+            source: 'llm_candidate',
+        });
+    }
+    return { version, terms: validatedTerms };
+}