create-principles-disciple 1.101.0 → 1.103.0

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

@@ -0,0 +1,121 @@
+/**
+ * signal-keywords-api — 信号关键词 API 层
+ *
+ * 调用 OpenClaw 插件的信号关键词管理端点。
+ * 功能分阶段交付：
+ * - Phase 1：只读（fetch keywords + pending）
+ * - Phase 2：读写（update / admit / reject）
+ *
+ * 当前 Phase 1 实现；写方法为 stub，返回"未实现"错误。
+ *
+ * ERR entries:
+ * - rc-1: 所有响应经 validator 校验
+ * - rc-2: 无 `as` bypass
+ * - rc-9: 降级/失败路径含 reason
+ */
+// ── 端点路径（当 plugin I/O 模块实现后启用） ──────────────────────────────────
+// const KEYWORDS_BASE = '/api/plugins/principles/signal-keywords';
+// ── SignalKeywordsPage 直接调用的列表函数 ──────────────────────────────────────
+/**
+ * 获取所有活跃关键词列表（SignalKeywordsPage 使用）
+ *
+ * 当前 Phase 1: 端点未实现，返回 stub 错误。
+ * Phase 2 需对接 /api/plugins/principles/signal-keywords 端点。
+ */
+export async function listActiveSignalKeywords(_signal) {
+    void _signal;
+    return {
+        success: false,
+        error: '信号关键词管理端点在当前版本中尚未实现（server-side plugin I/O 模块未部署）',
+        reason: 'endpoint_not_implemented',
+        nextAction: '请等待后续版本更新后再使用此功能',
+    };
+}
+/**
+ * 获取待确认信号词列表（SignalKeywordsPage 使用）
+ *
+ * 当前 Phase 1: 端点未实现，返回 stub 错误。
+ * Phase 2 需对接 /api/plugins/principles/signal-keywords/pending 端点。
+ */
+export async function listPendingSignalTerms(_signal) {
+    void _signal;
+    return {
+        success: false,
+        error: '信号关键词管理端点在当前版本中尚未实现（server-side plugin I/O 模块未部署）',
+        reason: 'endpoint_not_implemented',
+        nextAction: '请等待后续版本更新后再使用此功能',
+    };
+}
+// ── Phase 1 读取词库（category 分类读取） ──────────────────────────────────────
+/**
+ * 获取指定分类的信号词库
+ *
+ * @param category - 分类（correction | empathy）
+ * @param signal - 允许外部中止
+ */
+export async function fetchKeywordStore(category, signal) {
+    // Phase 1: 端点未实现，返回可识别的降级错误（rc-9）
+    // 见 Task 4 实施说明：server-side 端点不在本 PR 范围内
+    void category;
+    void signal;
+    return {
+        success: false,
+        error: '信号关键词管理端点在当前版本中尚未实现（server-side plugin I/O 模块未部署）',
+        reason: 'endpoint_not_implemented',
+        nextAction: '请等待后续版本更新后再使用此功能',
+    };
+}
+/**
+ * 获取 PendingTerm 候选池
+ *
+ * @param signal - 允许外部中止
+ */
+export async function fetchPendingTerms(signal) {
+    void signal;
+    return {
+        success: false,
+        error: '信号关键词管理端点在当前版本中尚未实现（server-side plugin I/O 模块未部署）',
+        reason: 'endpoint_not_implemented',
+        nextAction: '请等待后续版本更新后再使用此功能',
+    };
+}
+// ── 写操作（Phase 2 stubs） ───────────────────────────────────────────────────
+/**
+ * 更新信号词库
+ *
+ * Phase 2 实现，当前返回"未实现"。
+ */
+export async function updateKeywordStore(_req, _signal) {
+    return {
+        success: false,
+        error: '写操作在当前版本中尚未实现',
+        reason: 'endpoint_not_implemented',
+        nextAction: '请等待后续版本更新后再使用此功能',
+    };
+}
+/**
+ * 审批一个 PendingTerm（移入词库）
+ *
+ * Phase 2 实现，当前返回"未实现"。
+ */
+export async function admitPendingTerm(_req, _signal) {
+    return {
+        success: false,
+        error: '写操作在当前版本中尚未实现',
+        reason: 'endpoint_not_implemented',
+        nextAction: '请等待后续版本更新后再使用此功能',
+    };
+}
+/**
+ * 拒绝一个 PendingTerm（从候选池移除）
+ *
+ * Phase 2 实现，当前返回"未实现"。
+ */
+export async function rejectPendingTerm(_term, _signal) {
+    return {
+        success: false,
+        error: '写操作在当前版本中尚未实现',
+        reason: 'endpoint_not_implemented',
+        nextAction: '请等待后续版本更新后再使用此功能',
+    };
+}

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 };
+}

package/console/dist/ui/utils/validators.d.ts

@@ -146,6 +146,28 @@ export interface DefaultRuntimeUpdateData {
     defaultRuntime: string;
 }
 export declare function validateDefaultRuntimeUpdate(v: unknown): DefaultRuntimeUpdateData | null;
+/**
+ * Response shape for create/update/delete runtime profile endpoints.
+ *
+ * Server returns `{ profileId: string, profile: { type, provider?, model?, ... } }`.
+ * We validate the contract fields (profileId + profile.type) loudly and accept
+ * the rest of the profile object as a string-indexed record, since the patch
+ * surface is open (timeoutMs, maxRetries, baseUrl, source, etc.). The page only
+ * needs profileId to confirm the target; it re-fetches the catalog for display.
+ *
+ * rc-1: input treated as unknown.
+ * rc-2: no `as` bypass — uses Object.hasOwn + typeof guards.
+ * rc-3: profileId + profile.type are required and fail loud.
+ * rc-5: Object.hasOwn for untrusted keys.
+ */
+export interface RuntimeProfileMutationData {
+    profileId: string;
+    profile: {
+        type: string;
+        [key: string]: unknown;
+    };
+}
+export declare function validateRuntimeProfileMutation(v: unknown): RuntimeProfileMutationData | null;
 interface HealthCheckItemData {
     id: string;
     name: string;
@@ -188,7 +210,7 @@ export interface GovernanceQueueData {
 }
 export declare function validateGovernanceQueue(v: unknown): GovernanceQueueData | null;
 export interface ActivationRecordData {
-    id: string;
+    activationId: string;
     artifactId: string;
     principleId: string;
     channel: string;
@@ -199,8 +221,9 @@ export interface ActivationRecordData {
 }
 export interface ActivationsData {
     activations: ActivationRecordData[];
-    generatedAt: string;
-    note?: string;
+    status: string;
+    reason?: string;
+    nextAction?: string;
 }
 export declare function validateActivations(v: unknown): ActivationsData | null;
 export interface DisableActivationData {

package/console/dist/ui/utils/validators.js

@@ -402,6 +402,21 @@ export function validateDefaultRuntimeUpdate(v) {
         return null;
     return { defaultRuntime: v.defaultRuntime };
 }
+export function validateRuntimeProfileMutation(v) {
+    if (!isObject(v))
+        return null;
+    if (!Object.hasOwn(v, 'profileId') || !isString(v.profileId))
+        return null;
+    if (!Object.hasOwn(v, 'profile') || !isObject(v.profile))
+        return null;
+    const { profile } = v;
+    if (!Object.hasOwn(profile, 'type') || !isString(profile.type))
+        return null;
+    // Bind narrowed string to a local so the return literal keeps `type: string`
+    // (spreading a Record<string, unknown> alone would widen `type` back to unknown).
+    const profileType = profile.type;
+    return { profileId: v.profileId, profile: { ...profile, type: profileType } };
+}
 function validateHealthCheckItem(v) {
     if (!isObject(v))
         return null;
@@ -557,7 +572,7 @@ export function validateGovernanceQueue(v) {
 function validateActivationRecord(v) {
     if (!isObject(v))
         return null;
-    if (!Object.hasOwn(v, 'id') || !isString(v.id))
+    if (!Object.hasOwn(v, 'activationId') || !isString(v.activationId))
         return null;
     if (!Object.hasOwn(v, 'artifactId') || !isString(v.artifactId))
         return null;
@@ -575,7 +590,7 @@ function validateActivationRecord(v) {
     if (!Object.hasOwn(v, 'status') || !isString(v.status))
         return null;
     return {
-        id: v.id, artifactId: v.artifactId, principleId: v.principleId,
+        activationId: v.activationId, artifactId: v.artifactId, principleId: v.principleId,
         channel: v.channel, action: v.action, targetRef: v.targetRef,
         activatedAt: activatedAt.value,
         status: v.status,
@@ -586,14 +601,16 @@ export function validateActivations(v) {
         return null;
     if (!Object.hasOwn(v, 'activations') || !Array.isArray(v.activations))
         return null;
-    if (!Object.hasOwn(v, 'generatedAt') || !isString(v.generatedAt))
+    if (!Object.hasOwn(v, 'status') || !isString(v.status))
         return null;
     const activations = validateArray(v.activations, validateActivationRecord);
     if (activations === null)
         return null;
-    const result = { activations, generatedAt: v.generatedAt };
-    if (Object.hasOwn(v, 'note') && isString(v.note))
-        result.note = v.note;
+    const result = { activations, status: v.status };
+    if (Object.hasOwn(v, 'reason') && isString(v.reason))
+        result.reason = v.reason;
+    if (Object.hasOwn(v, 'nextAction') && isString(v.nextAction))
+        result.nextAction = v.nextAction;
     return result;
 }
 export function validateDisableActivation(v) {