@principles/core 1.218.0 → 1.219.0

package/dist/runtime-v2/signal-collector/signal-collector.js

@@ -0,0 +1,71 @@
+import { scanKeywords } from './keyword-stage.js';
+const MAX_EXCERPT = 200;
+export function buildEvidence(text, detectedAt) {
+    const excerpt = text.length > MAX_EXCERPT ? text.slice(0, MAX_EXCERPT) : text;
+    return { excerpt, detectedAt };
+}
+/**
+ * 同步阶段(prompt hook 内调用,绝不阻塞):Stage1 关键词快扫。
+ * - high 精度命中 → 直接返回 final output(needsLlmConfirmation=false)
+ * - ambiguous / 未命中 → 返回 pending output(needsLlmConfirmation 取决于 enableLlmStage)
+ *   由 plugin 层异步调 mapLlmResultToOutput 完成 Stage2。
+ *
+ * 注意:这个函数不调 LLM。LLM 在 plugin 层。
+ */
+// eslint-disable-next-line @typescript-eslint/max-params -- positional API for plugin-layer call sites (text, sessionId, store, config)
+export function collectSync(text, sessionId, store, config, detectedAt) {
+    void sessionId;
+    const scan = scanKeywords(text, store);
+    const evidence = buildEvidence(text, detectedAt);
+    if (scan.matched && scan.matchedPrecision === 'high' && scan.suggestedType) {
+        return {
+            isSignal: true,
+            type: scan.suggestedType,
+            strength: scan.suggestedType === 'correction' ? 'STRONG' : 'WEAK',
+            matchedTerms: scan.matchedTerms,
+            matchedPrecision: 'high',
+            detectionSource: 'keyword',
+            needsLlmConfirmation: false,
+            evidence,
+        };
+    }
+    // CodeRabbit #12: LLM 阶段关闭时,needsLlmConfirmation 应为 false(不会发生二阶段确认)
+    return {
+        isSignal: false,
+        type: null,
+        strength: null,
+        matchedTerms: scan.matchedTerms,
+        matchedPrecision: scan.matchedPrecision,
+        detectionSource: 'none',
+        needsLlmConfirmation: config.enableLlmStage,
+        evidence,
+    };
+}
+/**
+ * Stage2(异步,plugin 层拿到 LLM 结果后调用):把 LLM 分类映射成 final output。
+ */
+// eslint-disable-next-line @typescript-eslint/max-params -- positional API: (llm, text, sessionId, config)
+export function mapLlmResultToOutput(llm, text, _sessionId, _config, detectedAt) {
+    void _sessionId;
+    void _config;
+    const evidence = buildEvidence(text, detectedAt);
+    if (!llm.is_feedback || llm.type === 'none') {
+        return {
+            isSignal: false, type: null, strength: null, matchedTerms: [],
+            matchedPrecision: null, detectionSource: 'llm', needsLlmConfirmation: false,
+            llmReason: llm.reason, evidence,
+        };
+    }
+    return {
+        isSignal: true,
+        type: llm.type,
+        strength: llm.type === 'correction' ? 'STRONG' : 'WEAK',
+        matchedTerms: [],
+        matchedPrecision: null,
+        detectionSource: 'llm',
+        needsLlmConfirmation: false,
+        llmReason: llm.reason,
+        evidence,
+    };
+}
+//# sourceMappingURL=signal-collector.js.map

package/dist/runtime-v2/signal-collector/signal-collector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-collector.js","sourceRoot":"","sources":["../../../src/runtime-v2/signal-collector/signal-collector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMlD,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,UAAkB;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,wIAAwI;AACxI,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,SAAiB,EACjB,KAA0B,EAC1B,MAA6B,EAC7B,UAAkB;IAElB,KAAK,SAAS,CAAC;IACf,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAEjD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,gBAAgB,KAAK,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3E,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,IAAI,CAAC,aAAa;YACxB,QAAQ,EAAE,IAAI,CAAC,aAAa,KAAK,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;YACjE,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,gBAAgB,EAAE,MAAM;YACxB,eAAe,EAAE,SAAS;YAC1B,oBAAoB,EAAE,KAAK;YAC3B,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,qEAAqE;IACrE,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,eAAe,EAAE,MAAM;QACvB,oBAAoB,EAAE,MAAM,CAAC,cAAc;QAC3C,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,2GAA2G;AAC3G,MAAM,UAAU,oBAAoB,CAClC,GAA4B,EAC5B,IAAY,EACZ,UAAkB,EAClB,OAA8B,EAC9B,UAAkB;IAElB,KAAK,UAAU,CAAC;IAChB,KAAK,OAAO,CAAC;IACb,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAEjD,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5C,OAAO;YACL,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE;YAC7D,gBAAgB,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,oBAAoB,EAAE,KAAK;YAC3E,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ;SAChC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;QACvD,YAAY,EAAE,EAAE;QAChB,gBAAgB,EAAE,IAAI;QACtB,eAAe,EAAE,KAAK;QACtB,oBAAoB,EAAE,KAAK;QAC3B,SAAS,EAAE,GAAG,CAAC,MAAM;QACrB,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/runtime-v2/signal-collector/types.d.ts

@@ -0,0 +1,61 @@
+export type KeywordCategory = 'correction' | 'empathy';
+export type TermSource = 'seed' | 'migrated' | 'owner_promoted';
+export interface UnifiedKeyword {
+    term: string;
+    category: KeywordCategory;
+    weight: number;
+    precision: 'high' | 'ambiguous';
+    source: TermSource;
+}
+export interface UnifiedKeywordStore {
+    version: number;
+    terms: Record<string, UnifiedKeyword>;
+}
+export interface PendingTerm {
+    term: string;
+    suggestedCategory: KeywordCategory;
+    suggestedPrecision: 'high' | 'ambiguous';
+    reason: string;
+    discoveredAt: string;
+    source: 'llm_candidate';
+}
+export interface PendingTermStore {
+    version: number;
+    terms: PendingTerm[];
+}
+export interface SignalCollectorConfig {
+    enableLlmStage: boolean;
+    llmTimeoutMs: number;
+    promptTemplate: string;
+    strongPainScore: number;
+    strongRateLimitPerHour: number;
+}
+export type SignalStrength = 'STRONG' | 'WEAK';
+export type DetectionSource = 'keyword' | 'llm' | 'none';
+export type MatchedPrecision = 'high' | 'ambiguous' | null;
+export interface SignalEvidence {
+    excerpt: string;
+    detectedAt: string;
+}
+export interface SignalCollectorOutput {
+    isSignal: boolean;
+    type: 'correction' | 'empathy' | null;
+    strength: SignalStrength | null;
+    matchedTerms: string[];
+    matchedPrecision: MatchedPrecision;
+    detectionSource: DetectionSource;
+    needsLlmConfirmation: boolean;
+    llmReason?: string;
+    evidence: SignalEvidence;
+}
+export declare const SignalCollectorOutputSchema: {
+    validate(value: unknown): value is SignalCollectorOutput;
+};
+export interface LlmClassificationResult {
+    is_feedback: boolean;
+    type: 'correction' | 'empathy' | 'none';
+    confidence: number;
+    reason: string;
+}
+export declare function validateLlmClassification(value: unknown): value is LlmClassificationResult;
+//# sourceMappingURL=types.d.ts.map

package/dist/runtime-v2/signal-collector/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/signal-collector/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,SAAS,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAEhE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC;IAChC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACvC;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,eAAe,CAAC;IACnC,kBAAkB,EAAE,MAAM,GAAG,WAAW,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAID,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC/C,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AACzD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAAC;IACtC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,eAAe,EAAE,eAAe,CAAC;IACjC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAID,eAAO,MAAM,2BAA2B;oBACtB,OAAO,GAAG,KAAK,IAAI,qBAAqB;CAgBzD,CAAC;AAIF,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAQ1F"}

package/dist/runtime-v2/signal-collector/types.js

@@ -0,0 +1,45 @@
+// ── Unified Keyword Store (合并后的统一词库,纯数据) ──
+// ── TypeBox Schema (用于校验, ERR-001 防御) ──
+export const SignalCollectorOutputSchema = {
+    validate(value) {
+        if (typeof value !== 'object' || value === null)
+            return false;
+        const v = value;
+        if (typeof v.isSignal !== 'boolean')
+            return false;
+        if (v.type !== null && v.type !== 'correction' && v.type !== 'empathy')
+            return false;
+        if (v.strength !== null && v.strength !== 'STRONG' && v.strength !== 'WEAK')
+            return false;
+        if (!Array.isArray(v.matchedTerms))
+            return false;
+        if (v.matchedPrecision !== null && v.matchedPrecision !== 'high' && v.matchedPrecision !== 'ambiguous')
+            return false;
+        if (v.detectionSource !== 'keyword' && v.detectionSource !== 'llm' && v.detectionSource !== 'none')
+            return false;
+        if (typeof v.needsLlmConfirmation !== 'boolean')
+            return false;
+        const ev = v.evidence;
+        if (typeof ev !== 'object' || ev === null)
+            return false;
+        const e = ev;
+        if (typeof e.excerpt !== 'string' || typeof e.detectedAt !== 'string')
+            return false;
+        return true;
+    },
+};
+export function validateLlmClassification(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const v = value;
+    if (typeof v.is_feedback !== 'boolean')
+        return false;
+    if (v.type !== 'correction' && v.type !== 'empathy' && v.type !== 'none')
+        return false;
+    if (typeof v.confidence !== 'number' || v.confidence < 0 || v.confidence > 1)
+        return false;
+    if (typeof v.reason !== 'string')
+        return false;
+    return true;
+}
+//# sourceMappingURL=types.js.map

package/dist/runtime-v2/signal-collector/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime-v2/signal-collector/types.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAiE7C,0CAA0C;AAE1C,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,QAAQ,CAAC,KAAc;QACrB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;QAC3C,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAClD,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACrF,IAAI,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QAC1F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;YAAE,OAAO,KAAK,CAAC;QACjD,IAAI,CAAC,CAAC,gBAAgB,KAAK,IAAI,IAAI,CAAC,CAAC,gBAAgB,KAAK,MAAM,IAAI,CAAC,CAAC,gBAAgB,KAAK,WAAW;YAAE,OAAO,KAAK,CAAC;QACrH,IAAI,CAAC,CAAC,eAAe,KAAK,SAAS,IAAI,CAAC,CAAC,eAAe,KAAK,KAAK,IAAI,CAAC,CAAC,eAAe,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QACjH,IAAI,OAAO,CAAC,CAAC,oBAAoB,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC;QACtB,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACxD,MAAM,CAAC,GAAG,EAA6B,CAAC;QACxC,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACpF,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC;AAWF,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACtD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACvF,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3F,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/core",
-  "version": "1.218.0",
+  "version": "1.219.0",
   "description": "Universal Evolution SDK - framework-agnostic pain signal capture and principle injection",
   "type": "module",
   "main": "./dist/index.js",