create-principles-disciple 1.95.0 → 1.97.0

package/plugin/dist/core/thinking-models.js

@@ -1,163 +1,20 @@
 /**
- * Thinking Models — Detection Engine
+ * Thinking Models — Plugin I/O Adapter (Stage 3 slim)
  *
- * Core principle metadata (id, name, description) comes from the
- * Core Principle Registry in @principles/core/runtime-v2.
- * Detection patterns are carefully tuned regexes that match AI output text.
+ * Pure logic (BUILTIN_PATTERNS, BUILTIN_PATTERN_MAP, getFallbackName,
+ * getFallbackDescription, deriveThinkingScenarios, types) lives in
+ * @principles/core/runtime-v2/thinking-models.
  *
- * Flow:
- *   Core Principle Registry (authority) → id, name, description
- *   BUILTIN_PATTERNS (engine) → detection regexes per model id
- *   THINKING_MODELS (merged) → full definitions with patterns
+ * This file owns only the I/O boundary: reading THINKING_OS.md from a
+ * workspace dir and merging it with the builtin patterns. It re-exports
+ * the pure functions and types so existing relative imports
+ * (../core/thinking-models.js) continue to resolve.
  */
 import { loadThinkingOsFromWorkspace, generateDetectionPatterns } from './thinking-os-parser.js';
-import { CORE_PRINCIPLES } from '@principles/core/runtime-v2';
-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'],
-    },
-];
-const BUILTIN_PATTERN_MAP = new Map(BUILTIN_PATTERNS.map((p) => [p.id, p]));
-// Fallback name/description lookup — delegates to Core Principle Registry
-function getFallbackName(id) {
-    const entry = CORE_PRINCIPLES.find(p => p.id === id);
-    return entry?.name ?? id;
-}
-function getFallbackDescription(id) {
-    const entry = CORE_PRINCIPLES.find(p => p.id === id);
-    return entry?.statement ?? '';
-}
+import { BUILTIN_PATTERN_MAP, getFallbackName, getFallbackDescription, } from '@principles/core/runtime-v2';
+// Re-export pure logic + types so existing imports from this module keep working.
+export { BUILTIN_PATTERN_MAP, getFallbackName, getFallbackDescription, } from '@principles/core/runtime-v2';
+export { deriveThinkingScenarios } from '@principles/core/runtime-v2';
 // ---------------------------------------------------------------------------
 // Runtime model definitions — merged from THINKING_OS.md + builtin patterns
 // ---------------------------------------------------------------------------
@@ -200,27 +57,19 @@ export function listThinkingModels(workspaceDir) {
         }
     }
     // Fallback: built-in definitions
-    for (const bp of BUILTIN_PATTERNS) {
+    for (const [id, builtin] of BUILTIN_PATTERN_MAP) {
         models.push({
-            id: bp.id,
-            name: getFallbackName(bp.id),
-            description: getFallbackDescription(bp.id),
-            patterns: bp.patterns,
-            baselineScenarios: bp.baselineScenarios,
+            id,
+            name: getFallbackName(id),
+            description: getFallbackDescription(id),
+            patterns: builtin.patterns,
+            baselineScenarios: builtin.baselineScenarios,
         });
     }
     _cachedDefinitions = models;
     _cachedWorkspace = cacheKey;
     return models.slice();
 }
-/**
- * Clear the cached model definitions.
- * Call this when THINKING_OS.md changes.
- */
-export function clearThinkingModelCache() {
-    _cachedDefinitions = null;
-    _cachedWorkspace = null;
-}
 export function getThinkingModel(modelId, workspaceDir) {
     const models = listThinkingModels(workspaceDir);
     return models.find(m => m.id === modelId);
@@ -243,58 +92,3 @@ export function detectThinkingModelMatches(text, workspaceDir) {
     }
     return matches;
 }
-/**
- * Get all model definitions for display purposes (no patterns).
- */
-export function getThinkingModelDefinitions(workspaceDir) {
-    return listThinkingModels(workspaceDir).map(m => ({
-        modelId: m.id,
-        name: m.id + ': ' + m.name,
-        description: m.description,
-        antiPattern: m.antiPattern,
-    }));
-}
-export function deriveThinkingScenarios(modelId, context) {
-    const scenarios = new Set(getThinkingModel(modelId)?.baselineScenarios ?? []);
-    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);
-}

package/plugin/dist/core/trajectory-types.d.ts

@@ -222,4 +222,22 @@ export interface TrajectoryDatabaseOptions {
     busyTimeoutMs?: number;
     orphanBlobGraceDays?: number;
 }
+/**
+ * Raw row from tool_calls for RuleContext v2 history assembly.
+ * Fields are raw strings from SQLite — the assembler validates them as unknown.
+ */
+export interface RuleHostContextRow {
+    readonly id: number;
+    readonly toolName: string;
+    readonly outcome: string;
+    readonly paramsJson: string;
+}
+/**
+ * Result of getRuleHostContextRows: FIFO-ordered rows + truncated flag.
+ * truncated=true when more than `limit` rows existed (limit+1 read trick).
+ */
+export interface RuleHostContextResult {
+    readonly rows: readonly RuleHostContextRow[];
+    readonly truncated: boolean;
+}
 export type { DailyMetricRow };

package/plugin/dist/core/trajectory.d.ts

@@ -1,5 +1,5 @@
-import type { CorrectionSampleReviewStatus, CorrectionExportMode, TrajectoryDataStats, TrajectoryAssistantTurnInput, TrajectoryUserTurnInput, TrajectoryToolCallInput, TrajectoryPainEventInput, TrajectoryGateBlockInput, TrajectoryTrustChangeInput, TrajectoryPrincipleEventInput, TrajectoryTaskOutcomeInput, TrajectorySessionInput, EvolutionTaskInput, EvolutionEventInput, EvolutionTaskRecord, EvolutionEventRecord, EvolutionTaskFilters, AssistantTurnRecord, CorrectionSampleRecord, TrajectoryExportResult, TrajectoryDatabaseOptions } from './trajectory-types.js';
-export type { CorrectionSampleReviewStatus, CorrectionExportMode, TrajectoryDataStats, TrajectoryAssistantTurnInput, TrajectoryUserTurnInput, TrajectoryToolCallInput, TrajectoryPainEventInput, TrajectoryGateBlockInput, DailyMetricRow, TrajectoryTrustChangeInput, TrajectoryPrincipleEventInput, TrajectoryTaskOutcomeInput, TrajectorySessionInput, TaskKind, TaskPriority, EvolutionTaskInput, EvolutionEventInput, EvolutionTaskRecord, EvolutionEventRecord, EvolutionTaskFilters, AssistantTurnRecord, CorrectionSampleRecord, TrajectoryExportResult, TrajectoryDatabaseOptions, } from './trajectory-types.js';
+import type { CorrectionSampleReviewStatus, CorrectionExportMode, TrajectoryDataStats, TrajectoryAssistantTurnInput, TrajectoryUserTurnInput, TrajectoryToolCallInput, TrajectoryPainEventInput, TrajectoryGateBlockInput, TrajectoryTrustChangeInput, TrajectoryPrincipleEventInput, TrajectoryTaskOutcomeInput, TrajectorySessionInput, EvolutionTaskInput, EvolutionEventInput, EvolutionTaskRecord, EvolutionEventRecord, EvolutionTaskFilters, AssistantTurnRecord, CorrectionSampleRecord, TrajectoryExportResult, TrajectoryDatabaseOptions, RuleHostContextResult } from './trajectory-types.js';
+export type { CorrectionSampleReviewStatus, CorrectionExportMode, TrajectoryDataStats, TrajectoryAssistantTurnInput, TrajectoryUserTurnInput, TrajectoryToolCallInput, TrajectoryPainEventInput, TrajectoryGateBlockInput, DailyMetricRow, TrajectoryTrustChangeInput, TrajectoryPrincipleEventInput, TrajectoryTaskOutcomeInput, TrajectorySessionInput, TaskKind, TaskPriority, EvolutionTaskInput, EvolutionEventInput, EvolutionTaskRecord, EvolutionEventRecord, EvolutionTaskFilters, AssistantTurnRecord, CorrectionSampleRecord, TrajectoryExportResult, TrajectoryDatabaseOptions, RuleHostContextRow, RuleHostContextResult, } from './trajectory-types.js';
 /**
  * Initialize trajectory.db schema at the given workspace directory.
  *
@@ -121,6 +121,15 @@ export declare class TrajectoryDatabase {
         resultPreview: string | null;
         createdAt: string;
     }[];
+    /**
+     * PRI-482 Phase 3: Query tool_calls for RuleContext v2 history assembly.
+     *
+     * Reads limit+1 rows (DESC by id) to compute truncated, then reverses to FIFO.
+     * Returns raw rows — the assembler (rule-context-assembler.ts) validates them.
+     *
+     * Spec: §5.1, §5.2. ERR-026: reuses production schema (no hand-written DDL).
+     */
+    getRuleHostContextRows(sessionId: string, limit?: number): RuleHostContextResult;
     /**
      * List pain events for a session.
      *
@@ -137,6 +146,29 @@ export declare class TrajectoryDatabase {
         confidence: number | null;
         createdAt: string;
     }[];
+    /**
+     * PRI-484 Phase 5 — Look up a single pain event by canonical_pain_id.
+     *
+     * Used by BehaviorExamplePackAssembler to anchor a pain lineage without
+     * already knowing the session_id. Returns null when not found.
+     *
+     * ERR-001 (rc-1, rc-2): row fields validated as unknown — no `as` bypass.
+     * Uses a type-guard predicate to narrow the DB row structurally.
+     */
+    getPainEventByCanonicalId(canonicalPainId: string): {
+        id: number;
+        sessionId: string;
+        source: string;
+        score: number;
+        reason: string | null;
+        severity: string | null;
+        origin: string | null;
+        confidence: number | null;
+        text: string | null;
+        canonicalPainId: string;
+        runtimeTaskId: string | null;
+        createdAt: string;
+    } | null;
     /**
      * List user turns for a session.
      * Returns sanitized/reduced fields for nocturnal use — NO raw text.

package/plugin/dist/core/trajectory.js

@@ -26,6 +26,34 @@ const SCHEMA_VERSION = 1;
 function hasNameField(row) {
     return Object.hasOwn(row, 'name');
 }
+/**
+ * Pure structural narrowing from `unknown` to `Record<string, unknown>` with
+ * no `as` cast (ERR-001 / rc-2). The returned type allows indexed access in
+ * subsequent code without further casts.
+ */
+function isStringRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isPainEventRow(value) {
+    if (!isStringRecord(value))
+        return false;
+    if (typeof value.id !== 'number')
+        return false;
+    if (typeof value.session_id !== 'string')
+        return false;
+    // The remaining fields are accessed via String()/Number() which tolerate any
+    // primitive; presence check only (rc-5: Object.hasOwn over `in`).
+    return (Object.hasOwn(value, 'source')
+        && Object.hasOwn(value, 'score')
+        && Object.hasOwn(value, 'reason')
+        && Object.hasOwn(value, 'severity')
+        && Object.hasOwn(value, 'origin')
+        && Object.hasOwn(value, 'confidence')
+        && Object.hasOwn(value, 'text')
+        && Object.hasOwn(value, 'canonical_pain_id')
+        && Object.hasOwn(value, 'runtime_task_id')
+        && Object.hasOwn(value, 'created_at'));
+}
 /**
  * Apply the full trajectory.db schema (tables + indexes + views + migrations) to an open
  * Database handle. Used by TrajectoryDatabase.initSchema() and exported via
@@ -69,6 +97,8 @@ function applyTrajectorySchema(db) {
       empathy_signal_json TEXT NOT NULL,
       blob_ref TEXT,
       raw_excerpt TEXT,
+      stop_reason TEXT,
+      thinking_blocks_count INTEGER,
       created_at TEXT NOT NULL
     );
     CREATE TABLE IF NOT EXISTS user_turns (
@@ -95,6 +125,7 @@ function applyTrajectorySchema(db) {
       gfi_before REAL,
       gfi_after REAL,
       params_json TEXT NOT NULL,
+      result_preview TEXT,
       created_at TEXT NOT NULL
     );
     CREATE TABLE IF NOT EXISTS pain_events (
@@ -107,6 +138,8 @@ function applyTrajectorySchema(db) {
       origin TEXT,
       confidence REAL,
       text TEXT,
+      canonical_pain_id TEXT,
+      runtime_task_id TEXT,
       created_at TEXT NOT NULL
     );
     CREATE TABLE IF NOT EXISTS gate_blocks (
@@ -185,6 +218,12 @@ function applyTrajectorySchema(db) {
       started_at TEXT,
       completed_at TEXT,
       resolution TEXT,
+      task_kind TEXT,
+      priority TEXT,
+      retry_count INTEGER,
+      max_retries INTEGER,
+      last_error TEXT,
+      result_ref TEXT,
       created_at TEXT NOT NULL,
       updated_at TEXT NOT NULL
     );
@@ -892,6 +931,36 @@ export class TrajectoryDatabase {
             };
         });
     }
+    /**
+     * PRI-482 Phase 3: Query tool_calls for RuleContext v2 history assembly.
+     *
+     * Reads limit+1 rows (DESC by id) to compute truncated, then reverses to FIFO.
+     * Returns raw rows — the assembler (rule-context-assembler.ts) validates them.
+     *
+     * Spec: §5.1, §5.2. ERR-026: reuses production schema (no hand-written DDL).
+     */
+    getRuleHostContextRows(sessionId, limit = 20) {
+        const cappedLimit = Math.max(1, Math.floor(limit));
+        const rows = this.db.prepare(`
+      SELECT id, tool_name, outcome, params_json
+      FROM tool_calls
+      WHERE session_id = ?
+      ORDER BY id DESC
+      LIMIT ?
+    `).all(sessionId, cappedLimit + 1);
+        const truncated = rows.length > cappedLimit;
+        const output = truncated ? rows.slice(0, cappedLimit) : rows;
+        output.reverse(); // DESC → FIFO (oldest first)
+        return {
+            rows: output.map((row) => ({
+                id: Number(row.id),
+                toolName: String(row.tool_name),
+                outcome: String(row.outcome),
+                paramsJson: String(row.params_json),
+            })),
+            truncated,
+        };
+    }
     /**
      * List pain events for a session.
      *
@@ -916,6 +985,40 @@ export class TrajectoryDatabase {
             createdAt: String(row.created_at),
         }));
     }
+    /**
+     * PRI-484 Phase 5 — Look up a single pain event by canonical_pain_id.
+     *
+     * Used by BehaviorExamplePackAssembler to anchor a pain lineage without
+     * already knowing the session_id. Returns null when not found.
+     *
+     * ERR-001 (rc-1, rc-2): row fields validated as unknown — no `as` bypass.
+     * Uses a type-guard predicate to narrow the DB row structurally.
+     */
+    getPainEventByCanonicalId(canonicalPainId) {
+        const rawRow = this.db.prepare(`
+      SELECT id, session_id, source, score, reason, severity, origin, confidence,
+             text, canonical_pain_id, runtime_task_id, created_at
+      FROM pain_events
+      WHERE canonical_pain_id = ?
+      LIMIT 1
+    `).get(canonicalPainId);
+        if (!isPainEventRow(rawRow))
+            return null;
+        return {
+            id: rawRow.id,
+            sessionId: rawRow.session_id,
+            source: String(rawRow.source),
+            score: Number(rawRow.score),
+            reason: rawRow.reason ? String(rawRow.reason) : null,
+            severity: rawRow.severity ? String(rawRow.severity) : null,
+            origin: rawRow.origin ? String(rawRow.origin) : null,
+            confidence: rawRow.confidence != null ? Number(rawRow.confidence) : null,
+            text: rawRow.text ? String(rawRow.text) : null,
+            canonicalPainId: String(rawRow.canonical_pain_id),
+            runtimeTaskId: rawRow.runtime_task_id ? String(rawRow.runtime_task_id) : null,
+            createdAt: String(rawRow.created_at),
+        };
+    }
     /**
      * List user turns for a session.
      * Returns sanitized/reduced fields for nocturnal use — NO raw text.

package/plugin/dist/hooks/gate.js

@@ -12,12 +12,14 @@ import { normalizePath } from '../utils/io.js';
 import { WorkspaceContext } from '../core/workspace-context.js';
 import { recordGateBlockAndReturn } from './gate-block-helper.js';
 import { RuleHost } from '../core/rule-host.js';
-import { validateCorrectionProposal, validateProposedPathBounds } from '@principles/core/runtime-v2';
+import { validateCorrectionProposal, validateProposedPathBounds, computeFeatureFlagsFromConfig, UNAVAILABLE_RULE_CONTEXT } from '@principles/core/runtime-v2';
 import { AGENT_TOOLS, BASH_TOOLS_SET, WRITE_TOOLS } from '../constants/tools.js';
 import { getSession, hasRecentThinking } from '../core/session-tracker.js';
 import { getEvolutionEngine } from '../core/evolution-engine.js';
 import { EventLogService } from '../core/event-log.js';
-import { estimateLineChanges } from '../core/risk-calculator.js';
+import { estimateLineChanges } from '@principles/core/runtime-v2';
+import { loadPdConfigForPlugin } from '../core/pd-config-loader.js';
+import { buildProductionRuleContext } from '../core/rule-context-assembler.js';
 export function handleBeforeToolCall(event, ctx) {
     const logger = ctx.logger || console;
     // 1. Identify tool type
@@ -53,6 +55,10 @@ export function handleBeforeToolCall(event, ctx) {
     // 3. Rule Host Evaluation — sole gate
     try {
         const ruleHost = new RuleHost(wctx.stateDir, logger, { workspaceDir: ctx.workspaceDir });
+        // PRI-483 Phase 4: assemble RuleContextV2 when `rulecode_context_v2` flag is ON.
+        // flag OFF → undefined (v1 zero-change, no trajectory access).
+        // flag ON  → RuleContextV2 (available or unavailable). Never throws (ERR-024).
+        const ruleContext = _buildRuleContextIfEnabled(wctx, relPath, ctx.sessionId, logger);
         const hostInput = {
             action: {
                 toolName: event.toolName,
@@ -80,6 +86,7 @@ export function handleBeforeToolCall(event, ctx) {
                 estimatedLineChanges: estimateLineChanges({ toolName: event.toolName, params: event.params ?? {} }),
                 bashRisk: _getBashRisk(event),
             },
+            context: ruleContext,
         };
         const hostResult = ruleHost.evaluate(hostInput);
         // Always emit rulehost_evaluated
@@ -379,3 +386,53 @@ function _getBashRisk(event) {
         return 'unknown';
     }
 }
+/**
+ * PRI-483 Phase 4 — Build RuleContextV2 for RuleHost.evaluate when the
+ * `rulecode_context_v2` feature flag is ON. Returns `undefined` when the flag
+ * is OFF (v1 zero-change — does NOT touch trajectory) or when config loading
+ * fails (conservative fail-soft: can't determine flag state → v1-style).
+ *
+ * ERR-024 prevention: context assembly failures never skip RuleHost.evaluate.
+ * - loadPdConfigForPlugin throws → return undefined (v1-style)
+ * - buildProductionRuleContext throws → return UNAVAILABLE_RULE_CONTEXT
+ *   (structured unavailable so v2 rules see "context unavailable" and allow)
+ *
+ * Spec: docs/superpowers/specs/2026-06-27-rulecode-context-vision-design.md §5.3
+ */
+function _buildRuleContextIfEnabled(wctx, targetPath, sessionId, logger) {
+    // Step 1: load PD config (flag-gated). If this throws, we can't safely
+    // determine whether v2 context is required — fall back to v1 (undefined).
+    let configResult;
+    try {
+        configResult = loadPdConfigForPlugin(wctx.workspaceDir);
+    }
+    catch (err) {
+        logger?.warn?.(`[PD_GATE] RuleContext v2: config load failed, skipping context assembly: ${String(err)}`);
+        return undefined;
+    }
+    // Step 2: compute effective flags and check rulecode_context_v2.
+    // Explicit ok:false guard (rc-9-no-silent-fallback): when config is malformed,
+    // do NOT silently fall through to flag computation on defaults — log and
+    // return v1-style undefined so config issues surface to the operator.
+    if (!configResult.ok) {
+        const reasons = configResult.errors.map(e => e.reason).join('; ');
+        logger?.warn?.(`[PD_GATE] RuleContext v2: config load returned malformed result, skipping context assembly: ${reasons}`);
+        return undefined;
+    }
+    const flagsResult = computeFeatureFlagsFromConfig(configResult.effective);
+    const v2Flag = flagsResult.flags.rulecode_context_v2;
+    if (!v2Flag?.enabled) {
+        // Flag OFF → v1 zero-change. Do NOT access trajectory (spec §10.1).
+        return undefined;
+    }
+    // Step 3: flag ON → assemble context via production data source.
+    // buildProductionRuleContext is fail-soft internally (returns unavailable),
+    // but wrap in try/catch as defense-in-depth (ERR-024).
+    try {
+        return buildProductionRuleContext(sessionId, targetPath, wctx.trajectory, wctx.workspaceDir);
+    }
+    catch (err) {
+        logger?.warn?.(`[PD_GATE] RuleContext v2: buildProductionRuleContext threw unexpectedly, using unavailable context: ${String(err)}`);
+        return UNAVAILABLE_RULE_CONTEXT;
+    }
+}

package/plugin/dist/hooks/pain.js

@@ -25,7 +25,7 @@ import { resolveWorkspaceDirForRuntimeV2 } from '../utils/workspace-resolver.js'
 import { PainToPrincipleService, PrincipleTreeLedgerAdapter } from '@principles/core/runtime-v2';
 import { evaluatePainDiagnosticGate } from '../core/pain-diagnostic-gate.js';
 import { loadPdConfigForPlugin, loadFeatureFlagFromConfig } from '../core/pd-config-loader.js';
-import { createIntentDocReader } from '../core/intent-doc-reader-adapter.js';
+import { createIntentDocReader, resolveIntentLang } from '../core/intent-doc-reader-adapter.js';
 import { evaluateTriggerController } from '@principles/core/runtime-v2';
 import { isSharedCooldownActive, markSharedEpisodeAsDiagnosed } from './trigger-cooldown-tracker.js';
 import { buildManualPainObservation, resolveSourceKind } from './raw-observation-adapter.js';
@@ -48,7 +48,7 @@ function createPainToPrincipleService(wctx) {
         // PRI-468: wire INTENT.md reader so Stage A can produce intentTension
         // when intent_engineering flag is on. Adapter performs no I/O beyond
         // delegating to safeReadIntentDoc (which owns the flag-first check).
-        intentDocReader: createIntentDocReader(wctx.workspaceDir),
+        intentDocReader: createIntentDocReader(wctx.workspaceDir, resolveIntentLang(wctx.workspaceDir)),
     });
 }
 // buildTrajectoryEvidence is in ./trajectory-evidence.ts (re-exported above)

package/plugin/dist/hooks/prompt.js

@@ -21,6 +21,7 @@ import { buildEmpathyObservation, resolveSourceKind } from './raw-observation-ad
 import { evaluateEvidenceTriage } from './triage-adapter.js';
 import { loadFeatureFlagFromConfig } from '../core/pd-config-loader.js';
 import { safeReadIntentDoc, resetIntentDocCacheForTest } from '../core/intent-doc-reader.js';
+import { resolveIntentLang } from '../core/intent-doc-reader-adapter.js';
 import { buildIntentFrictionBlock } from '@principles/core/runtime-v2';
 import { CorrectionCueLearner } from '../core/correction-cue-learner.js';
 import { detectCorrectionCue as coreDetectCorrectionCue, escapeXml, extractMessageContent, isMinimalTrigger, } from '@principles/core/prompt-builder';
@@ -909,7 +910,7 @@ export async function handleBeforePromptBuild(event, ctx) {
     try {
         const intentFlag = loadFeatureFlagFromConfig(workspaceDir, 'intent_engineering', logger);
         if (intentFlag.enabled) {
-            const intentResult = safeReadIntentDoc(workspaceDir, { logger });
+            const intentResult = safeReadIntentDoc(workspaceDir, resolveIntentLang(workspaceDir), { logger });
             if (intentResult.ok && intentResult.doc) {
                 const block = buildIntentFrictionBlock({ rawIntentMd: intentResult.doc.raw });
                 if (block.length > 0) {

package/plugin/dist/index.js

@@ -38,7 +38,7 @@ import { SystemLogger } from './core/system-logger.js';
 import { PathResolver } from './core/path-resolver.js';
 import { resolveCommandWorkspaceDir, resolveToolHookWorkspaceDirSafe, resolveHookWorkspaceDir } from './utils/workspace-resolver.js';
 import { validateWorkspaceDir } from './core/workspace-dir-validation.js';
-import { checkSurfaceGuard, guardHook, guardService } from './core/surface-guard.js';
+import { checkSurfaceGuard, guardHook, guardService } from '@principles/core/runtime-v2';
 // Track started workspaces — one-time init + evolution worker per workspace
 const startedWorkspaces = new Set();
 // ── Conversation Access Health Check (PRI-343) ────────────────────────────

package/plugin/package.json

@@ -62,7 +62,7 @@
     "@typescript-eslint/eslint-plugin": "^8.61.0",
     "@typescript-eslint/parser": "^8.58.0",
     "@vitest/coverage-v8": "^4.1.9",
-    "esbuild": "^0.28.0",
+    "esbuild": "^0.28.1",
     "eslint": "^10.5.0",
     "jsdom": "^29.1.1",
     "typescript": "^6.0.3",

package/plugin/dist/core/evolution-migration.d.ts

@@ -1,5 +0,0 @@
-export interface MigrationResult {
-    importedEvents: number;
-    streamPath: string;
-}
-export declare function migrateLegacyEvolutionData(workspaceDir: string): MigrationResult;