@principles/core 1.202.0 → 1.204.0

package/dist/runtime-v2/thinking-models/thinking-models-policy.js

@@ -0,0 +1,227 @@
+/**
+ * Thinking Models — Pure Policy (Stage 3 sink from plugin)
+ *
+ * Holds the pure logic for thinking-model detection:
+ *   - BUILTIN_PATTERNS: carefully tuned regexes that match AI output text
+ *   - BUILTIN_PATTERN_MAP: id → entry lookup
+ *   - getFallbackName / getFallbackDescription: delegate to Core Principle Registry
+ *   - deriveThinkingScenarios: pure scenario derivation from context
+ *
+ * I/O (reading THINKING_OS.md from a workspace) stays in the plugin.
+ *
+ * Flow:
+ *   Core Principle Registry (authority) → id, name, description
+ *   BUILTIN_PATTERNS (engine) → detection regexes per model id
+ *   Plugin listThinkingModels() (I/O) → full definitions with patterns from THINKING_OS.md
+ */
+import { CORE_PRINCIPLES } from '../core-principles/core-principle-registry.js';
+export const BUILTIN_PATTERNS = [
+    {
+        id: 'T-01',
+        patterns: [
+            // Thinking process language (AI reasoning output)
+            /let me (first )?(understand|map|outline|survey|review the (structure|architecture|dependencies))/i,
+            /before (changing|editing|touching) anything/i,
+            /让我先(梳理|理解|看看|盘点).*(结构|架构|依赖|全貌)/i,
+            /在执行任何.*/i,
+            // Decision directive language (nocturnal artifact betterDecision)
+            /review (the |)(docs|architecture|structure|requirements|constraints|dependencies|authorization)/i,
+            /read (the |)(docs|architecture|requirements|constraints|logs?|error|stack)/i,
+            /check (the |)(docs|architecture|source|authorization|requirements|error)/i,
+            /understand (the |)(structure|architecture|requirements|constraints|full (context|picture))/i,
+            /first (to|and|,) (verify|check|review|read|understand|confirm|diagnose)/i,
+            /(verify|check|review|read|confirm) .+ first/i,
+        ],
+        baselineScenarios: ['exploration', 'discovery'],
+    },
+    {
+        id: 'T-02',
+        patterns: [
+            // Thinking process language
+            /(type|test|contract|schema|interface) (constraint|requirement|check|validation)/i,
+            /(必须|需要).*(遵守|符合|满足).*(类型|测试|契约|接口|规范)/i,
+            // Decision directive language
+            /(trust|follow|respect|adhere to|meet) (the |)(constraint|requirement|contract|interface|specification|schema|type)/i,
+            /(check|verify|validate|ensure) (the |)(constraint|requirement|contract|interface|specification|type|schema)/i,
+        ],
+        baselineScenarios: ['constraint-check', 'contract-verification'],
+    },
+    {
+        id: 'T-03',
+        patterns: [
+            // Thinking process language
+            /based on (the |this )?(evidence|logs?|output|error|stack trace|test result)/i,
+            /let me (check|verify|confirm|read|look at) (the |)(actual|source|code|file|log)/i,
+            /根据(日志|证据|输出|报错|堆栈|测试结果)/i,
+            // Decision directive language (evidence-based decision)
+            /(verify|check|confirm) (the |)(error|error code|error message|actual|evidence|logs?|output|stack)/i,
+            /(error|failure) (logs?|output|stack trace|message|code) (before|then)/i,
+            /(look at|read) (the |)(error|logs?|output|stack|actual|evidence|file|code)/i,
+        ],
+        baselineScenarios: ['evidence-gathering', 'verification'],
+    },
+    {
+        id: 'T-04',
+        patterns: [
+            // Thinking process language
+            /this (is|would be) (irreversible|destructive|permanent|not easily undone)/i,
+            /(reversible|can be undone|safely roll back)/i,
+            /(不可逆|破坏性|无法回滚|可以回滚|安全撤销)/i,
+            // Decision directive language
+            /(irreversible|destructive|permanent|high impact) (action|change|operation)/i,
+            /(must be|need to be|should be) (reviewed|confirmed|verified|checked) (first|before)/i,
+            /(get|obtain|ask for) (confirmation|authorization|approval|permission) (first|before)/i,
+        ],
+        baselineScenarios: ['risk-management', 'reversibility'],
+    },
+    {
+        id: 'T-05',
+        patterns: [
+            // Thinking process language
+            /we (must|should) (not|never|avoid|prevent|ensure we don't)/i,
+            /(critical|important) (not to|that we don't|to avoid)/i,
+            /(绝不能|必须避免|不可|禁止|确保不会)/i,
+            // Decision directive language
+            /(must|should|need to) (not |never |avoid )?(check|verify|review|read|confirm|ask)/i,
+            /(safety|safe) (check|gate|checklist|guard)/i,
+        ],
+        baselineScenarios: ['guardrails', 'safety-rails'],
+    },
+    {
+        id: 'T-06',
+        patterns: [
+            // Thinking process language
+            /(simpl(er|est|ify)|minimal|straightforward|lean) (approach|solution|fix|implementation)/i,
+            /(simple is better|keep it simple|no need to over)/i,
+            /(最简|更简单|精简|没必要过度设计)/i,
+            // Decision directive language
+            /(minimal|smallest|narrowest) (change|modification|impact|approach)/i,
+            /(only|just) (change|modify|touch|edit|affect) (the |what)/i,
+        ],
+        baselineScenarios: ['simplification', 'pragmatism'],
+    },
+    {
+        id: 'T-07',
+        patterns: [
+            // Thinking process language
+            /(minimal|smallest|narrowest|least) (change|diff|modification|impact)/i,
+            /only (change|modify|touch|edit) (the |what)/i,
+            /(最小改动|最小变更|只改|只动必要部分)/i,
+            // Decision directive language
+            /(limit|narrow) (the |)(change|impact|scope|blast radius)/i,
+        ],
+        baselineScenarios: ['minimal-diff', 'blast-radius-control'],
+    },
+    {
+        id: 'T-08',
+        patterns: [
+            // Thinking process language
+            /this (error|failure|issue) (tells us|indicates|signals|suggests|means)/i,
+            /let me (stop|pause|step back|reconsider|rethink)/i,
+            /这个(错误|失败|问题).*(说明|意味着|提示)/i,
+            /让我(停下|暂停|退一步|重新考虑|重新审视)/i,
+            // Decision directive language
+            /(diagnose|analyze|investigate) (the |)(root |)(cause|reason|error|failure) (first|before)/i,
+            /(understand|diagnose|analyze) (the |)(error|failure|issue|problem) (first|before)/i,
+        ],
+        baselineScenarios: ['reflection', 'pain-response'],
+    },
+    {
+        id: 'T-09',
+        patterns: [
+            // Thinking process language
+            /(break|split|decompose|divide) (this |the task |it )?(into|down)/i,
+            /(step 1|first,? (we|i|let's)|phase 1)/i,
+            /(拆分|分解|分步|分阶段|第一步)/i,
+            // Decision directive language
+            /(break|split|decompose|divide) (the |)(task|problem|action) (into|into steps)/i,
+        ],
+        baselineScenarios: ['decomposition', 'phased-execution'],
+    },
+    {
+        id: 'T-10',
+        patterns: [
+            // Thinking process language
+            /let me (write|save|record|note down|document)/i,
+            /memory.*scratchpad|write.*plan\.md|write.*memory|memory.*persist/i,
+            /(让我.*写入|写入.*memory|记录.*scratchpad)/i,
+            // Decision directive language
+            /(write|save|record|note) (the |)(conclusion|decision|plan|next step) (to|in) (file|plan\.md|scratchpad)/i,
+        ],
+        baselineScenarios: ['memory-persistence', 'state-externalization'],
+    },
+];
+export const BUILTIN_PATTERN_MAP = new Map(BUILTIN_PATTERNS.map((p) => [p.id, p]));
+// ---------------------------------------------------------------------------
+// Fallback name/description lookup — delegates to Core Principle Registry
+// ---------------------------------------------------------------------------
+export function getFallbackName(id) {
+    const entry = CORE_PRINCIPLES.find(p => p.id === id);
+    return entry?.name ?? id;
+}
+export function getFallbackDescription(id) {
+    const entry = CORE_PRINCIPLES.find(p => p.id === id);
+    return entry?.statement ?? '';
+}
+/**
+ * Look up baselineScenarios for a model id from the builtin pattern map.
+ * Returns an empty array if the id is unknown.
+ */
+export function getBuiltinBaselineScenarios(modelId) {
+    return BUILTIN_PATTERN_MAP.get(modelId)?.baselineScenarios ?? [];
+}
+// ---------------------------------------------------------------------------
+// Scenario derivation — pure logic, no I/O
+// ---------------------------------------------------------------------------
+/**
+ * Derive thinking scenarios for a model id given a context.
+ *
+ * baselineScenarios come from BUILTIN_PATTERN_MAP (the source of truth —
+ * even when the plugin loads THINKING_OS.md, baselineScenarios are sourced
+ * from the builtin map, never from the parsed directives).
+ */
+export function deriveThinkingScenarios(modelId, context) {
+    const scenarios = new Set(getBuiltinBaselineScenarios(modelId));
+    if ((context.recentToolCalls ?? []).some((call) => call.outcome === 'failure')) {
+        scenarios.add('after-tool-failure');
+    }
+    // after-recovery: success that follows a failure (not just any success)
+    const calls = context.recentToolCalls ?? [];
+    const hasFailure = calls.some((call) => call.outcome === 'failure');
+    const hasSuccess = calls.some((call) => call.outcome === 'success');
+    if (hasFailure && hasSuccess) {
+        scenarios.add('after-recovery');
+    }
+    if ((context.recentToolCalls ?? []).some((call) => call.outcome === 'blocked')) {
+        scenarios.add('blocked-execution');
+    }
+    if ((context.recentToolCalls ?? []).some((call) => Boolean(call.errorType))) {
+        scenarios.add('incident-response');
+    }
+    if ((context.recentPainEvents ?? []).length > 0) {
+        scenarios.add('user-friction');
+    }
+    if ((context.recentGateBlocks ?? []).length > 0) {
+        scenarios.add('gate-block');
+    }
+    if ((context.recentUserCorrections ?? []).length > 0) {
+        scenarios.add('user-correction');
+    }
+    if ((context.recentPrincipleEvents ?? []).length > 0) {
+        scenarios.add('principle-feedback');
+    }
+    if (modelId === 'T-03') {
+        scenarios.add('root-cause-analysis');
+    }
+    if (modelId === 'T-04' || modelId === 'T-05') {
+        scenarios.add('risk-review');
+    }
+    if (modelId === 'T-08') {
+        scenarios.add('reflection-loop');
+    }
+    if (modelId === 'T-09') {
+        scenarios.add('task-planning');
+    }
+    return Array.from(scenarios);
+}
+//# sourceMappingURL=thinking-models-policy.js.map

package/dist/runtime-v2/thinking-models/thinking-models-policy.js.map

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

package/package.json

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