@principles/core 1.169.0 → 1.171.0

package/dist/principle-tree-ledger.js

@@ -12,148 +12,64 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
-import { atomicWriteFileSync } from './io.js';
+import { TREE_NAMESPACE } from './runtime-v2/types/ledger-store.js';
+// PRI-443: Pure parse/serialize functions extracted to codec module
+import { uniqueStrings, createEmptyTree, parseHybridLedger, serializeLedger, } from './runtime-v2/principle-tree/ledger-codec.js';
+export { TREE_NAMESPACE };
 const PRINCIPLE_TRAINING_FILE = 'principle_training_state.json';
 // ---------------------------------------------------------------------------
-// Constants
+// Atomic file write (inlined PRI-443 Phase 4)
 // ---------------------------------------------------------------------------
-export const TREE_NAMESPACE = '_tree';
-const VALID_EVALUABILITIES = ['deterministic', 'weak_heuristic', 'manual_only'];
-const VALID_INTERNALIZATION_STATUSES = [
-    'prompt_only', 'needs_training', 'in_training',
-    'deployed_pending_eval', 'internalized', 'regressed',
-];
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function stringArray(value) {
-    return Array.isArray(value) ? value.filter((e) => typeof e === 'string') : [];
-}
-function clampFloat(value, opts) {
-    if (typeof value !== 'number' || !Number.isFinite(value))
-        return opts.fallback;
-    return Math.max(opts.min, Math.min(opts.max, value));
-}
-function clampInt(value, opts) {
-    if (typeof value !== 'number' || !Number.isFinite(value))
-        return opts.fallback;
-    return Math.max(opts.min, Math.min(opts.max, Math.round(value)));
-}
-function uniqueStrings(values) {
-    return Array.from(new Set(values));
-}
-// ---------------------------------------------------------------------------
-// Parsers
-// ---------------------------------------------------------------------------
-function parseLegacyTrainingStore(raw) {
-    if (!isRecord(raw))
-        return {};
-    const result = {};
-    for (const [principleId, candidate] of Object.entries(raw)) {
-        if (principleId === TREE_NAMESPACE || !isRecord(candidate))
-            continue;
-        if (candidate.principleId !== principleId)
-            continue;
-        result[principleId] = {
-            principleId,
-            evaluability: VALID_EVALUABILITIES.includes(candidate.evaluability)
-                ? candidate.evaluability
-                : 'manual_only',
-            applicableOpportunityCount: clampInt(candidate.applicableOpportunityCount, { min: 0, max: Infinity, fallback: 0 }),
-            observedViolationCount: clampInt(candidate.observedViolationCount, { min: 0, max: Infinity, fallback: 0 }),
-            complianceRate: clampFloat(candidate.complianceRate, { min: 0, max: 1, fallback: 0 }),
-            violationTrend: clampFloat(candidate.violationTrend, { min: -1, max: 1, fallback: 0 }),
-            generatedSampleCount: clampInt(candidate.generatedSampleCount, { min: 0, max: Infinity, fallback: 0 }),
-            approvedSampleCount: clampInt(candidate.approvedSampleCount, { min: 0, max: Infinity, fallback: 0 }),
-            includedTrainRunIds: stringArray(candidate.includedTrainRunIds),
-            deployedCheckpointIds: stringArray(candidate.deployedCheckpointIds),
-            lastEvalScore: typeof candidate.lastEvalScore === 'number' && Number.isFinite(candidate.lastEvalScore)
-                ? clampFloat(candidate.lastEvalScore, { min: 0, max: 1, fallback: 0 }) : undefined,
-            internalizationStatus: VALID_INTERNALIZATION_STATUSES.includes(candidate.internalizationStatus)
-                ? candidate.internalizationStatus
-                : 'prompt_only',
-        };
-    }
-    return result;
-}
-function parsePrinciples(raw) {
-    if (!isRecord(raw))
-        return {};
-    const principles = {};
-    for (const [id, value] of Object.entries(raw)) {
-        if (!isRecord(value))
-            continue;
-        principles[id] = {
-            ...value,
-            id,
-            ruleIds: stringArray(value.ruleIds),
-            conflictsWithPrincipleIds: stringArray(value.conflictsWithPrincipleIds),
-            derivedFromPainIds: stringArray(value.derivedFromPainIds),
-        };
-    }
-    return principles;
-}
-function parseRules(raw) {
-    if (!isRecord(raw))
-        return {};
-    const rules = {};
-    for (const [id, value] of Object.entries(raw)) {
-        if (!isRecord(value))
-            continue;
-        rules[id] = {
-            ...value,
-            id,
-            principleId: typeof value.principleId === 'string' ? value.principleId : '',
-            implementationIds: stringArray(value.implementationIds),
-        };
-    }
-    return rules;
-}
-function parseImplementations(raw) {
-    if (!isRecord(raw))
-        return {};
-    const implementations = {};
-    for (const [id, value] of Object.entries(raw)) {
-        if (!isRecord(value) || typeof value.ruleId !== 'string')
-            continue;
-        implementations[id] = { ...value, id, ruleId: value.ruleId };
+//
+// Previously exported from ./io.ts. Inlined here as a private helper because
+// this is the ONLY consumer in principles-core. The openclaw-plugin has its
+// own copy at src/utils/io.ts.
+//
+// Crash-safe: writes to a .tmp file then renames. On Windows, retries with
+// exponential backoff on EPERM/EBUSY/EACCES to handle transient file locks.
+const RENAME_MAX_RETRIES = 3;
+const RENAME_BASE_DELAY_MS = 50;
+function atomicWriteFileSync(filePath, data) {
+    const tmpPath = filePath + '.tmp';
+    fs.writeFileSync(tmpPath, data, 'utf8');
+    let lastError;
+    for (let attempt = 0; attempt < RENAME_MAX_RETRIES; attempt++) {
+        try {
+            fs.renameSync(tmpPath, filePath);
+            return;
+        }
+        catch (err) {
+            lastError = err;
+            const { code } = err;
+            // Only retry on Windows transient lock errors
+            if (code === 'EPERM' || code === 'EBUSY' || code === 'EACCES') {
+                if (attempt < RENAME_MAX_RETRIES - 1) {
+                    const delay = RENAME_BASE_DELAY_MS * Math.pow(2, attempt);
+                    // Synchronous sleep using a tight spin with accessSync yield
+                    const waitUntil = Date.now() + delay;
+                    while (Date.now() < waitUntil) {
+                        try {
+                            fs.accessSync(tmpPath);
+                        }
+                        catch { /* ignore */ }
+                    }
+                }
+                continue;
+            }
+            // Non-retryable error — throw immediately
+            break;
+        }
     }
-    return implementations;
-}
-function parseMetrics(raw) {
-    if (!isRecord(raw))
-        return {};
-    const metrics = {};
-    for (const [id, value] of Object.entries(raw)) {
-        if (!isRecord(value))
-            continue;
-        metrics[id] = { ...value, principleId: typeof value.principleId === 'string' ? value.principleId : id };
+    // Clean up temp file on failure
+    try {
+        fs.unlinkSync(tmpPath);
     }
-    return metrics;
+    catch { /* best effort */ }
+    throw lastError ?? new Error('atomicWriteFileSync: rename failed');
 }
 // ---------------------------------------------------------------------------
-// Store factory
+// Ledger file I/O (the only non-pure part of this module)
 // ---------------------------------------------------------------------------
-function createEmptyTree() {
-    return { principles: {}, rules: {}, implementations: {}, metrics: {}, lastUpdated: new Date(0).toISOString() };
-}
-// ---------------------------------------------------------------------------
-// Parsers
-// ---------------------------------------------------------------------------
-function parseTree(raw) {
-    if (!isRecord(raw))
-        return createEmptyTree();
-    return {
-        principles: parsePrinciples(raw.principles),
-        rules: parseRules(raw.rules),
-        implementations: parseImplementations(raw.implementations),
-        metrics: parseMetrics(raw.metrics),
-        lastUpdated: typeof raw.lastUpdated === 'string' ? raw.lastUpdated : new Date(0).toISOString(),
-    };
-}
 function getLedgerFilePath(stateDir) {
     return path.join(stateDir, PRINCIPLE_TRAINING_FILE);
 }
@@ -167,25 +83,12 @@ function readLedgerFromFile(filePath) {
             return { trainingStore: {}, tree: createEmptyTree() };
         }
         const parsed = JSON.parse(content);
-        if (!isRecord(parsed))
-            return { trainingStore: {}, tree: createEmptyTree() };
-        const trainingStoreRaw = parsed.trainingStore ?? parsed;
-        const treeRaw = parsed[TREE_NAMESPACE] ?? parsed.tree;
-        return {
-            trainingStore: parseLegacyTrainingStore(trainingStoreRaw),
-            tree: parseTree(treeRaw),
-        };
+        return parseHybridLedger(parsed);
     }
     catch {
         return { trainingStore: {}, tree: createEmptyTree() };
     }
 }
-function serializeLedger(store) {
-    return JSON.stringify({
-        ...store.trainingStore,
-        [TREE_NAMESPACE]: { ...store.tree, lastUpdated: new Date().toISOString() },
-    }, null, 2);
-}
 // ---------------------------------------------------------------------------
 // Ledger mutations (synchronous — safe for single-process use)
 // ---------------------------------------------------------------------------

package/dist/principle-tree-ledger.js.map

@@ -1 +1 @@
-{"version":3,"file":"principle-tree-ledger.js","sourceRoot":"","sources":["../src/principle-tree-ledger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"principle-tree-ledger.js","sourceRoot":"","sources":["../src/principle-tree-ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAe7B,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,oEAAoE;AACpE,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,6CAA6C,CAAC;AAgBrD,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,MAAM,uBAAuB,GAAG,+BAA+B,CAAC;AAEhE,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAC9E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,+BAA+B;AAC/B,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAE5E,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAC7B,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,SAAS,mBAAmB,CAAC,QAAgB,EAAE,IAAY;IACzD,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAExC,IAAI,SAA4B,CAAC;IACjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,kBAAkB,EAAE,OAAO,EAAE,EAAE,CAAC;QAC9D,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAY,CAAC;YACzB,MAAM,EAAC,IAAI,EAAC,GAAI,GAAyB,CAAC;YAC1C,8CAA8C;YAC9C,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9D,IAAI,OAAO,GAAG,kBAAkB,GAAG,CAAC,EAAE,CAAC;oBACrC,MAAM,KAAK,GAAG,oBAAoB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;oBAC1D,6DAA6D;oBAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;oBACrC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC;wBAC9B,IAAI,CAAC;4BAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;wBAAC,CAAC;wBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;oBACxD,CAAC;gBACH,CAAC;gBACD,SAAS;YACX,CAAC;YACD,0CAA0C;YAC1C,MAAM;QACR,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI,CAAC;QAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAC3D,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACrE,CAAC;AAED,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;AAE9E,SAAS,iBAAiB,CAAC,QAAgB;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,CAAC;IACxD,CAAC;IACD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACtC,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,CAAC;QACxD,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAC;QAC9C,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,CAAC;IACxD,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,YAAY,CAAI,QAAgB,EAAE,MAAuC;IAChF,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,mBAAmB,CAAC,QAAQ,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,OAAO,kBAAkB,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,KAAwB;IACnE,YAAY,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE;QACjC,OAAO,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QAC5C,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,SAA0B;IAC/E,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QACtC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAClD,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,WAAmB,EAAE,OAAiC;IACtG,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,WAAW,IAAI,CAAC,CAAC;QACpF,MAAM,IAAI,GAAoB;YAC5B,GAAG,QAAQ;YACX,GAAG,OAAO;YACV,EAAE,EAAE,WAAW;YACf,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO;YAC5E,yBAAyB,EAAE,OAAO,CAAC,yBAAyB;gBAC1D,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB;YACzF,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;gBAC5C,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kBAAkB;SAC5E,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,QAAgB,EAAE,WAAmB,EAAE,OAA8B;IAC/G,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;QACtC,MAAM,IAAI,GAA0B,EAAE,GAAG,OAAO,EAAE,WAAW,EAAE,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC"}

package/dist/runtime-v2/__tests__/architecture-regression.test.js

@@ -5,6 +5,8 @@
  * Add entries here whenever a new service/read-model boundary is established.
  */
 import { describe, it, expect, beforeAll } from 'vitest';
+import * as fsSync from 'fs';
+import * as pathSync from 'path';
 // ── Source-file existence ──────────────────────────────────────────────────
 const REQUIRED_SOURCE_FILES = [
     'pain-to-principle-service.ts',
@@ -2427,7 +2429,8 @@ describe('PRI-139 L1 Hard Cap & LRU Eviction', () => {
     it('LedgerPrinciple includes lastTriggeredAt field', async () => {
         const { readFileSync } = await import('node:fs');
         const { resolve } = await import('node:path');
-        const src = readFileSync(resolve(__dirname, '..', '..', 'principle-tree-ledger.ts'), 'utf-8');
+        // PRI-443: type moved to pure module
+        const src = readFileSync(resolve(__dirname, '..', 'types', 'ledger-store.ts'), 'utf-8');
         expect(src).toContain('lastTriggeredAt');
     });
     it('PruningHealthSummary includes activeL1Count and l1Cap fields', async () => {
@@ -3022,11 +3025,18 @@ describe('PRI-416: type single-ownership guards', () => {
     });
     it('HybridLedgerStore is defined exactly once in core/src/', () => {
         const hits = findDefinitions(/export\s+interface\s+HybridLedgerStore\s*\{/);
-        expect(hits).toEqual(['principle-tree-ledger.ts']);
+        expect(hits).toEqual(['runtime-v2/types/ledger-store.ts']);
     });
-    it('atomicWriteFileSync is defined exactly once in core/src/', () => {
+    it('atomicWriteFileSync is NOT exported from any core/src/ file (PRI-443 Phase 4)', () => {
+        // After PRI-443 Phase 4, atomicWriteFileSync is inlined as a PRIVATE helper
+        // inside principle-tree-ledger.ts. It must NOT be exported from core.
         const hits = findDefinitions(/export\s+function\s+atomicWriteFileSync\s*\(/);
-        expect(hits).toEqual(['io.ts']);
+        expect(hits).toEqual([]);
+    });
+    it('atomicWriteFileSync is defined exactly once as a private function in principle-tree-ledger.ts (PRI-443 Phase 4)', () => {
+        // The function is now a private (non-exported) helper inlined in principle-tree-ledger.ts
+        const hits = findDefinitions(/function\s+atomicWriteFileSync\s*\(/);
+        expect(hits).toEqual(['principle-tree-ledger.ts']);
     });
 });
 // ── PRI-416: Barrel Cap Guards ────────────────────────────────────────────────
@@ -3054,4 +3064,168 @@ describe('PRI-416: barrel cap guards', () => {
         expect(exportLines.length).toBeLessThanOrEqual(BARREL_MAX_EXPORT_LINES);
     });
 });
+// ── PRI-443: Pure module boundary guards ──────────────────────────────────────
+//
+// Phases 1-3 extracted pure types/codecs/schema out of I/O modules. These guards
+// ensure those pure modules never regress to importing fs/path, and that the
+// runtime-v2 barrel never re-exports I/O functions from principle-tree-ledger.
+describe('PRI-443: pure module boundary guards', () => {
+    const FORBIDDEN_PURE_IMPORTS = [
+        "from 'fs'",
+        'from "fs"',
+        "from 'node:fs'",
+        'from "node:fs"',
+        "from 'path'",
+        'from "path"',
+        "from 'node:path'",
+        'from "node:path"',
+    ];
+    async function readSrc(relPath) {
+        const fsMod = await import('fs'); // eslint-disable-line @typescript-eslint/consistent-type-imports
+        const pathMod = await import('path'); // eslint-disable-line @typescript-eslint/consistent-type-imports
+        const full = pathMod.resolve(__dirname, '..', relPath);
+        return fsMod.readFileSync(full, 'utf-8');
+    }
+    it('runtime-v2/types/ledger-store.ts has zero fs/path imports (pure types module)', async () => {
+        const src = await readSrc('types/ledger-store.ts');
+        for (const pat of FORBIDDEN_PURE_IMPORTS) {
+            expect(src).not.toContain(pat);
+        }
+    });
+    it('runtime-v2/principle-tree/ledger-codec.ts has zero fs/path imports (pure codec module)', async () => {
+        const src = await readSrc('principle-tree/ledger-codec.ts');
+        for (const pat of FORBIDDEN_PURE_IMPORTS) {
+            expect(src).not.toContain(pat);
+        }
+    });
+    it('runtime-v2/types/pain-signal.ts has zero fs/path imports (pure schema module)', async () => {
+        const src = await readSrc('types/pain-signal.ts');
+        for (const pat of FORBIDDEN_PURE_IMPORTS) {
+            expect(src).not.toContain(pat);
+        }
+    });
+    it('runtime-v2/index.ts barrel does NOT export I/O functions from principle-tree-ledger', async () => {
+        const src = await readSrc('index.ts');
+        // I/O functions must not be re-exported through the pure-types barrel.
+        expect(src).not.toMatch(/export\s+\{[^}]*\bloadLedger\b[^}]*\}\s*from\s*['"]\.\.\/principle-tree-ledger/);
+        expect(src).not.toMatch(/export\s+\{[^}]*\bsaveLedger\b[^}]*\}\s*from\s*['"]\.\.\/principle-tree-ledger/);
+        expect(src).not.toMatch(/export\s+\{[^}]*\bgetLedgerFilePathPublic\b[^}]*\}\s*from\s*['"]\.\.\/principle-tree-ledger/);
+        expect(src).not.toMatch(/export\s+\{[^}]*\bupdatePrinciple\b[^}]*\}\s*from\s*['"]\.\.\/principle-tree-ledger/);
+        expect(src).not.toMatch(/export\s+\{[^}]*\batomicWriteFileSync\b[^}]*\}\s*from\s*['"]\.\.\/principle-tree-ledger/);
+    });
+    it('runtime-v2/index.ts barrel re-exports LedgerTreeStore type from pure types module, not from principle-tree-ledger', async () => {
+        const src = await readSrc('index.ts');
+        // The type must come from the pure types module (./types/ledger-store.js),
+        // NOT from the I/O module (../principle-tree-ledger.js).
+        expect(src).toMatch(/export\s+type\s+\{\s*LedgerTreeStore\s*\}\s*from\s*['"]\.\/types\/ledger-store\.js['"]/);
+        expect(src).not.toMatch(/export\s+type\s+\{\s*LedgerTreeStore\s*\}\s*from\s*['"]\.\.\/principle-tree-ledger\.js['"]/);
+    });
+});
+// ── PRI-450: Core I/O whitelist guard ──────────────────────────────────────────
+//
+// Scans all production (.ts, non-test) files under packages/principles-core/src/
+// for fs/path imports and verifies they match an explicit whitelist. Any new file
+// that needs I/O must be added to ALLOWED_IO_FILES here — otherwise CI fails.
+// This forces developers to explain "why does this file need I/O?" in their PR.
+describe('PRI-450: core I/O whitelist guard', () => {
+    // Whitelist of production files allowed to import fs/path.
+    // Paths are relative to packages/principles-core/src/.
+    const ALLOWED_IO_FILES = new Set([
+        'principle-tree-ledger.ts',
+        'evolution-store.ts',
+        'trajectory-store.ts',
+        'workflow-funnel-loader.ts',
+        'runtime-v2/store/sqlite-connection.ts',
+        'runtime-v2/store/runtime-state-manager.ts',
+        'runtime-v2/adapter/openclaw-cli-runtime-adapter.ts',
+        'runtime-v2/candidate-audit.ts',
+        'runtime-v2/pain-signal-observability.ts',
+        'runtime-v2/internalization-chain-integrity-read-model.ts',
+        'runtime-v2/internalization-integrity-remediation.ts',
+        'runtime-v2/operator-health-read-model.ts',
+        'runtime-v2/pain-chain-read-model.ts',
+        'runtime-v2/pruning-read-model.ts',
+        'runtime-v2/pruning-review-log.ts',
+        'runtime-v2/schema-conformance-read-model.ts',
+    ]);
+    // Extract all import module paths from source code.
+    // Handles: import ... from 'mod', import 'mod' (side-effect), and multiline imports.
+    // Reuses the same pattern proven in the PRI-215 extractImportModulePaths helper.
+    function extractImportPaths(src) {
+        const paths = [];
+        for (const m of src.matchAll(/import\s+[\s\S]*?from\s+['"]([^'"]+)['"]/g)) {
+            if (m[1] != null)
+                paths.push(m[1]);
+        }
+        for (const m of src.matchAll(/import\s+['"]([^'"]+)['"]/g)) {
+            if (m[1] != null && !paths.includes(m[1]))
+                paths.push(m[1]);
+        }
+        return paths;
+    }
+    // Check if any import path references fs or path (including sub-paths like fs/promises).
+    function importsFsOrPath(src) {
+        const paths = extractImportPaths(src);
+        return paths.some((p) => p === 'fs' || p.startsWith('fs/') ||
+            p === 'node:fs' || p.startsWith('node:fs/') ||
+            p === 'path' || p.startsWith('path/') ||
+            p === 'node:path' || p.startsWith('node:path/'));
+    }
+    function collectTsFiles(dir, acc) {
+        const entries = fsSync.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = pathSync.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                collectTsFiles(fullPath, acc);
+            }
+            else if (entry.isFile() &&
+                entry.name.endsWith('.ts') &&
+                !entry.name.endsWith('.test.ts') &&
+                !entry.name.endsWith('.spec.ts')) {
+                acc.push(fullPath);
+            }
+        }
+    }
+    it('core/src/ production files: only whitelisted files import fs/path', () => {
+        const coreSrcDir = pathSync.resolve(__dirname, '..', '..');
+        const allFiles = [];
+        collectTsFiles(coreSrcDir, allFiles);
+        const violations = [];
+        for (const filePath of allFiles) {
+            const content = fsSync.readFileSync(filePath, 'utf-8');
+            if (importsFsOrPath(content)) {
+                const relPath = pathSync.relative(coreSrcDir, filePath).replace(/\\/g, '/');
+                if (!ALLOWED_IO_FILES.has(relPath)) {
+                    violations.push(relPath);
+                }
+            }
+        }
+        expect(violations).toEqual([]);
+    });
+    it('ALLOWED_IO_FILES whitelist entries all exist on disk', () => {
+        const coreSrcDir = pathSync.resolve(__dirname, '..', '..');
+        const missing = [];
+        for (const relPath of ALLOWED_IO_FILES) {
+            const fullPath = pathSync.join(coreSrcDir, ...relPath.split('/'));
+            if (!fsSync.existsSync(fullPath)) {
+                missing.push(relPath);
+            }
+        }
+        expect(missing).toEqual([]);
+    });
+    it('importsFsOrPath detects sub-path imports (fs/promises) and side-effect imports', () => {
+        // Sub-path import
+        expect(importsFsOrPath(`import { mkdir } from 'node:fs/promises';`)).toBe(true);
+        expect(importsFsOrPath(`import { posix } from 'path/posix';`)).toBe(true);
+        // Side-effect import
+        expect(importsFsOrPath(`import 'fs';`)).toBe(true);
+        expect(importsFsOrPath(`import "node:path";`)).toBe(true);
+        // Standard import
+        expect(importsFsOrPath(`import * as fs from 'fs';`)).toBe(true);
+        expect(importsFsOrPath(`import { resolve } from 'node:path';`)).toBe(true);
+        // Non-fs/path imports
+        expect(importsFsOrPath(`import { foo } from 'bar';`)).toBe(false);
+        expect(importsFsOrPath(``)).toBe(false);
+    });
+});
 //# sourceMappingURL=architecture-regression.test.js.map