@principles/core 1.169.0 → 1.171.0

package/dist/runtime-v2/__tests__/barrel-io-cleanup.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * PRI-443 Phase 5: runtime-v2 barrel I/O cleanup
+ *
+ * Verifies that:
+ * 1. runtime-v2/index.ts does NOT re-export I/O functions (loadLedger, saveLedger,
+ *    getLedgerFilePathPublic, updatePrinciple) — these belong in the I/O module
+ * 2. runtime-v2/index.ts does NOT re-export LedgerTreeStore from
+ *    '../principle-tree-ledger.js' — types come from pure modules
+ * 3. package.json exposes "./principle-tree-ledger" subpath for direct I/O access
+ */
+export {};
+//# sourceMappingURL=barrel-io-cleanup.test.d.ts.map

package/dist/runtime-v2/__tests__/barrel-io-cleanup.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrel-io-cleanup.test.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/__tests__/barrel-io-cleanup.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/runtime-v2/__tests__/barrel-io-cleanup.test.js

@@ -0,0 +1,46 @@
+/**
+ * PRI-443 Phase 5: runtime-v2 barrel I/O cleanup
+ *
+ * Verifies that:
+ * 1. runtime-v2/index.ts does NOT re-export I/O functions (loadLedger, saveLedger,
+ *    getLedgerFilePathPublic, updatePrinciple) — these belong in the I/O module
+ * 2. runtime-v2/index.ts does NOT re-export LedgerTreeStore from
+ *    '../principle-tree-ledger.js' — types come from pure modules
+ * 3. package.json exposes "./principle-tree-ledger" subpath for direct I/O access
+ */
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'fs';
+import { resolve } from 'path';
+const CORE_SRC = resolve(__dirname, '..', '..');
+describe('PRI-443 Phase 5: runtime-v2 barrel I/O cleanup', () => {
+    it('runtime-v2/index.ts does NOT re-export I/O functions from principle-tree-ledger', () => {
+        const barrelPath = resolve(CORE_SRC, 'runtime-v2', 'index.ts');
+        const content = readFileSync(barrelPath, 'utf-8');
+        // The I/O functions loadLedger, saveLedger, getLedgerFilePathPublic,
+        // updatePrinciple must NOT be re-exported from the runtime-v2 barrel.
+        // Consumers should import from @principles/core/principle-tree-ledger instead.
+        expect(content).not.toMatch(/export\s*\{[^}]*\bloadLedger\b[^}]*\}\s*from\s*['"]\.\.\/principle-tree-ledger\.js['"]/);
+        expect(content).not.toMatch(/export\s*\{[^}]*\bsaveLedger\b[^}]*\}\s*from\s*['"]\.\.\/principle-tree-ledger\.js['"]/);
+        expect(content).not.toMatch(/export\s*\{[^}]*\bgetLedgerFilePathPublic\b[^}]*\}\s*from\s*['"]\.\.\/principle-tree-ledger\.js['"]/);
+        expect(content).not.toMatch(/export\s*\{[^}]*\bupdatePrinciple\b[^}]*\}\s*from\s*['"]\.\.\/principle-tree-ledger\.js['"]/);
+    });
+    it('runtime-v2/index.ts does NOT re-export LedgerTreeStore from principle-tree-ledger', () => {
+        const barrelPath = resolve(CORE_SRC, 'runtime-v2', 'index.ts');
+        const content = readFileSync(barrelPath, 'utf-8');
+        // LedgerTreeStore type must come from the pure types module, not the I/O module
+        expect(content).not.toMatch(/export\s+type\s*\{[^}]*\bLedgerTreeStore\b[^}]*\}\s*from\s*['"]\.\.\/principle-tree-ledger\.js['"]/);
+    });
+    it('package.json exposes "./principle-tree-ledger" subpath', () => {
+        const pkgPath = resolve(CORE_SRC, '..', 'package.json');
+        const parsed = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        if (!parsed || typeof parsed !== 'object' || !Object.hasOwn(parsed, 'exports')) {
+            throw new Error('package.json 缺少 exports 字段');
+        }
+        const pkgExports = parsed.exports;
+        if (!pkgExports || typeof pkgExports !== 'object') {
+            throw new Error('package.json exports 字段格式非法');
+        }
+        expect(Object.hasOwn(pkgExports, './principle-tree-ledger')).toBe(true);
+    });
+});
+//# sourceMappingURL=barrel-io-cleanup.test.js.map

package/dist/runtime-v2/__tests__/barrel-io-cleanup.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"barrel-io-cleanup.test.js","sourceRoot":"","sources":["../../../src/runtime-v2/__tests__/barrel-io-cleanup.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEhD,QAAQ,CAAC,gDAAgD,EAAE,GAAG,EAAE;IAC9D,EAAE,CAAC,iFAAiF,EAAE,GAAG,EAAE;QACzF,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAElD,qEAAqE;QACrE,sEAAsE;QACtE,+EAA+E;QAC/E,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,wFAAwF,CAAC,CAAC;QACtH,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,wFAAwF,CAAC,CAAC;QACtH,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,qGAAqG,CAAC,CAAC;QACnI,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,6FAA6F,CAAC,CAAC;IAC7H,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QAC3F,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAElD,gFAAgF;QAChF,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,oGAAoG,CAAC,CAAC;IACpI,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACxD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QACD,MAAM,UAAU,GAAI,MAA+B,CAAC,OAAO,CAAC;QAC5D,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/runtime-v2/__tests__/io-deletion.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * PRI-443 Phase 4: io.ts deletion guard
+ *
+ * Verifies that:
+ * 1. `src/io.ts` no longer exists in principles-core
+ * 2. `atomicWriteFileSync` is NOT re-exported from the top-level barrel
+ * 3. `principle-tree-ledger.ts` still performs atomic write+read roundtrips
+ *    (the inlined private atomicWriteFileSync preserves crash-safe semantics)
+ * 4. `package.json` no longer exposes `"./io"` subpath
+ */
+export {};
+//# sourceMappingURL=io-deletion.test.d.ts.map

package/dist/runtime-v2/__tests__/io-deletion.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io-deletion.test.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/__tests__/io-deletion.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/runtime-v2/__tests__/io-deletion.test.js

@@ -0,0 +1,92 @@
+/**
+ * PRI-443 Phase 4: io.ts deletion guard
+ *
+ * Verifies that:
+ * 1. `src/io.ts` no longer exists in principles-core
+ * 2. `atomicWriteFileSync` is NOT re-exported from the top-level barrel
+ * 3. `principle-tree-ledger.ts` still performs atomic write+read roundtrips
+ *    (the inlined private atomicWriteFileSync preserves crash-safe semantics)
+ * 4. `package.json` no longer exposes `"./io"` subpath
+ */
+import { describe, it, expect } from 'vitest';
+import { existsSync, readFileSync, mkdtempSync, rmSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { resolve } from 'path';
+const CORE_SRC = resolve(__dirname, '..', '..');
+describe('PRI-443 Phase 4: io.ts deletion', () => {
+    it('src/io.ts does NOT exist in principles-core', () => {
+        const ioPath = join(CORE_SRC, 'io.ts');
+        expect(existsSync(ioPath)).toBe(false);
+    });
+    it('index.ts barrel does NOT re-export atomicWriteFileSync', () => {
+        const barrelPath = join(CORE_SRC, 'index.ts');
+        const content = readFileSync(barrelPath, 'utf-8');
+        expect(content).not.toMatch(/export\s*\{[^}]*\batomicWriteFileSync\b[^}]*\}/);
+        expect(content).not.toMatch(/from\s+['"]\.\/io\.js['"]/);
+    });
+    it('package.json does NOT expose "./io" subpath', () => {
+        const pkgPath = resolve(CORE_SRC, '..', 'package.json');
+        const parsed = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        if (!parsed || typeof parsed !== 'object' || !Object.hasOwn(parsed, 'exports')) {
+            throw new Error('package.json 缺少 exports 字段');
+        }
+        const pkgExports = parsed.exports;
+        if (!pkgExports || typeof pkgExports !== 'object') {
+            throw new Error('package.json exports 字段格式非法');
+        }
+        expect(Object.hasOwn(pkgExports, './io')).toBe(false);
+    });
+    it('principle-tree-ledger.ts inlines atomicWriteFileSync as a private (non-exported) helper', () => {
+        const ledgerPath = join(CORE_SRC, 'principle-tree-ledger.ts');
+        const content = readFileSync(ledgerPath, 'utf-8');
+        // The function must be defined locally (not imported)
+        expect(content).not.toMatch(/from\s+['"]\.\/io\.js['"]/);
+        // The function must NOT be re-exported (private to the module)
+        expect(content).not.toMatch(/export\s*\{[^}]*\batomicWriteFileSync\b[^}]*\}/);
+        expect(content).not.toMatch(/export\s+function\s+atomicWriteFileSync/);
+        // The function body must be present locally
+        expect(content).toMatch(/function\s+atomicWriteFileSync/);
+        expect(content).toMatch(/fs\.renameSync/);
+    });
+});
+describe('PRI-443 Phase 4: principle-tree-ledger atomic roundtrip', () => {
+    it('saveLedger → loadLedger roundtrip preserves data atomically', async () => {
+        // Dynamic import to avoid importing io.ts (which should not exist)
+        const { loadLedger, addPrincipleToLedger } = await import('../../principle-tree-ledger.js');
+        const tmpDir = mkdtempSync(join(tmpdir(), 'pri443-phase4-'));
+        try {
+            const principle = {
+                id: 'pri-test-001',
+                version: 1,
+                text: 'Always validate user input before processing',
+                triggerPattern: 'user_input_received',
+                action: 'validate_input',
+                status: 'active',
+                priority: 'P1',
+                scope: 'domain',
+                evaluability: 'deterministic',
+                valueScore: 0.8,
+                adherenceRate: 0.95,
+                painPreventedCount: 3,
+                derivedFromPainIds: ['pain-1'],
+                ruleIds: ['rule-1'],
+                conflictsWithPrincipleIds: [],
+                createdAt: '2026-06-22T00:00:00.000Z',
+                updatedAt: '2026-06-22T00:00:00.000Z',
+            };
+            addPrincipleToLedger(tmpDir, principle);
+            const loaded = loadLedger(tmpDir);
+            expect(loaded.tree.principles['pri-test-001']).toBeDefined();
+            expect(loaded.tree.principles['pri-test-001']?.text).toBe('Always validate user input before processing');
+            expect(loaded.tree.principles['pri-test-001']?.status).toBe('active');
+            // Verify the .tmp file was cleaned up (atomic write completed)
+            const tmpFile = join(tmpDir, 'principle_training_state.json.tmp');
+            expect(existsSync(tmpFile)).toBe(false);
+        }
+        finally {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=io-deletion.test.js.map

package/dist/runtime-v2/__tests__/io-deletion.test.js.map

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

package/dist/runtime-v2/__tests__/ledger-codec.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ledger-codec.test.d.ts.map

package/dist/runtime-v2/__tests__/ledger-codec.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-codec.test.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/__tests__/ledger-codec.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/__tests__/ledger-codec.test.js

@@ -0,0 +1,133 @@
+/**
+ * PRI-443: Ledger codec — pure parse/serialize functions, zero I/O.
+ *
+ * Tests verify:
+ * 1. parseHybridLedger correctly parses a valid ledger JSON
+ * 2. parseHybridLedger handles missing/malformed data gracefully
+ * 3. serializeLedger produces correct JSON output
+ * 4. createEmptyTree returns a valid empty tree
+ * 5. The module has zero fs/path imports
+ */
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseHybridLedger, serializeLedger, createEmptyTree, isRecord, stringArray, clampFloat, clampInt, uniqueStrings, } from '../principle-tree/ledger-codec.js';
+describe('PRI-443: ledger-codec.ts pure parse/serialize module', () => {
+    it('createEmptyTree returns valid empty tree', () => {
+        const tree = createEmptyTree();
+        expect(tree.principles).toEqual({});
+        expect(tree.rules).toEqual({});
+        expect(tree.implementations).toEqual({});
+        expect(tree.metrics).toEqual({});
+        expect(tree.lastUpdated).toBe(new Date(0).toISOString());
+    });
+    it('parseHybridLedger parses valid hybrid ledger', () => {
+        const raw = {
+            trainingStore: {
+                'pri-001': {
+                    principleId: 'pri-001',
+                    evaluability: 'manual_only',
+                    applicableOpportunityCount: 5,
+                    observedViolationCount: 2,
+                    complianceRate: 0.6,
+                    violationTrend: 0.1,
+                    generatedSampleCount: 3,
+                    approvedSampleCount: 1,
+                    includedTrainRunIds: ['run-1'],
+                    deployedCheckpointIds: ['ckpt-1'],
+                    internalizationStatus: 'prompt_only',
+                },
+            },
+            _tree: {
+                principles: {
+                    'pri-001': {
+                        id: 'pri-001',
+                        version: 1,
+                        text: 'Test',
+                        triggerPattern: 'test',
+                        action: 'test',
+                        status: 'active',
+                        priority: 'P0',
+                        scope: 'general',
+                        evaluability: 'manual_only',
+                        valueScore: 0.5,
+                        adherenceRate: 0.8,
+                        painPreventedCount: 0,
+                        derivedFromPainIds: [],
+                        ruleIds: [],
+                        conflictsWithPrincipleIds: [],
+                        createdAt: '2026-01-01T00:00:00Z',
+                        updatedAt: '2026-01-01T00:00:00Z',
+                    },
+                },
+                rules: {},
+                implementations: {},
+                metrics: {},
+                lastUpdated: '2026-01-01T00:00:00Z',
+            },
+        };
+        const result = parseHybridLedger(raw);
+        expect(result.trainingStore['pri-001']).toBeDefined();
+        expect(result.trainingStore['pri-001']?.evaluability).toBe('manual_only');
+        expect(result.tree.principles['pri-001']?.id).toBe('pri-001');
+    });
+    it('parseHybridLedger handles null input', () => {
+        const result = parseHybridLedger(null);
+        expect(result.trainingStore).toEqual({});
+        expect(result.tree.principles).toEqual({});
+    });
+    it('parseHybridLedger handles non-object input', () => {
+        const result = parseHybridLedger('not an object');
+        expect(result.trainingStore).toEqual({});
+        expect(result.tree.principles).toEqual({});
+    });
+    it('serializeLedger produces correct JSON with TREE_NAMESPACE', () => {
+        const store = {
+            trainingStore: {},
+            tree: {
+                principles: {},
+                rules: {},
+                implementations: {},
+                metrics: {},
+                lastUpdated: '2026-01-01T00:00:00Z',
+            },
+        };
+        const json = serializeLedger(store);
+        const parsed = JSON.parse(json);
+        expect(parsed._tree).toBeDefined();
+        expect(parsed._tree.lastUpdated).toBeDefined();
+    });
+    it('isRecord correctly identifies records', () => {
+        expect(isRecord({})).toBe(true);
+        expect(isRecord(null)).toBe(false);
+        expect(isRecord(undefined)).toBe(false);
+        expect(isRecord([])).toBe(false);
+        expect(isRecord('string')).toBe(false);
+    });
+    it('stringArray filters non-strings from array', () => {
+        expect(stringArray(['a', 1, 'b', null, 'c'])).toEqual(['a', 'b', 'c']);
+        expect(stringArray('not array')).toEqual([]);
+    });
+    it('clampFloat clamps to range with fallback', () => {
+        expect(clampFloat(0.5, { min: 0, max: 1, fallback: 0 })).toBe(0.5);
+        expect(clampFloat(1.5, { min: 0, max: 1, fallback: 0 })).toBe(1);
+        expect(clampFloat(-0.5, { min: 0, max: 1, fallback: 0 })).toBe(0);
+        expect(clampFloat(NaN, { min: 0, max: 1, fallback: 0.5 })).toBe(0.5);
+    });
+    it('clampInt clamps and rounds to range with fallback', () => {
+        expect(clampInt(5.7, { min: 0, max: 10, fallback: 0 })).toBe(6);
+        expect(clampInt(15, { min: 0, max: 10, fallback: 0 })).toBe(10);
+        expect(clampInt('x', { min: 0, max: 10, fallback: 3 })).toBe(3);
+    });
+    it('uniqueStrings deduplicates', () => {
+        expect(uniqueStrings(['a', 'b', 'a', 'c', 'b'])).toEqual(['a', 'b', 'c']);
+    });
+    it('ledger-codec.ts has zero fs/path imports (pure module)', () => {
+        const src = readFileSync(resolve(__dirname, '..', 'principle-tree', 'ledger-codec.ts'), 'utf-8');
+        expect(src).not.toMatch(/from\s+['"]fs['"]/);
+        expect(src).not.toMatch(/from\s+['"]path['"]/);
+        expect(src).not.toMatch(/from\s+['"]node:fs/);
+        expect(src).not.toMatch(/from\s+['"]node:path/);
+    });
+});
+//# sourceMappingURL=ledger-codec.test.js.map

package/dist/runtime-v2/__tests__/ledger-codec.test.js.map

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

package/dist/runtime-v2/__tests__/ledger-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ledger-store.test.d.ts.map

package/dist/runtime-v2/__tests__/ledger-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-store.test.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/__tests__/ledger-store.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/__tests__/ledger-store.test.js

@@ -0,0 +1,65 @@
+/**
+ * PRI-443: Ledger store types module — pure type definitions, zero I/O.
+ *
+ * Tests verify:
+ * 1. All types are importable from the new pure module
+ * 2. The module has zero fs/path imports
+ * 3. TREE_NAMESPACE constant is available
+ */
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { TREE_NAMESPACE } from '../types/ledger-store.js';
+describe('PRI-443: ledger-store.ts pure types module', () => {
+    it('TREE_NAMESPACE constant is exported and equals _tree', () => {
+        expect(TREE_NAMESPACE).toBe('_tree');
+    });
+    it('LedgerPrinciple extends Principle with optional fields', () => {
+        const principle = {
+            id: 'pri-001',
+            version: 1,
+            text: 'Test principle',
+            triggerPattern: 'test',
+            action: 'test',
+            status: 'active',
+            priority: 'P0',
+            scope: 'general',
+            evaluability: 'manual_only',
+            valueScore: 0.5,
+            adherenceRate: 0.8,
+            painPreventedCount: 0,
+            derivedFromPainIds: [],
+            ruleIds: [],
+            conflictsWithPrincipleIds: [],
+            createdAt: '2026-01-01T00:00:00Z',
+            updatedAt: '2026-01-01T00:00:00Z',
+            suggestedRules: ['rule-1'],
+            lastTriggeredAt: '2026-01-02T00:00:00Z',
+        };
+        expect(principle.id).toBe('pri-001');
+        expect(principle.suggestedRules).toEqual(['rule-1']);
+        expect(principle.lastTriggeredAt).toBe('2026-01-02T00:00:00Z');
+    });
+    it('HybridLedgerStore has trainingStore and tree', () => {
+        const store = {
+            trainingStore: {},
+            tree: {
+                principles: {},
+                rules: {},
+                implementations: {},
+                metrics: {},
+                lastUpdated: '2026-01-01T00:00:00Z',
+            },
+        };
+        expect(store.trainingStore).toEqual({});
+        expect(store.tree.principles).toEqual({});
+    });
+    it('ledger-store.ts has zero fs/path imports (pure module)', () => {
+        const src = readFileSync(resolve(__dirname, '..', 'types', 'ledger-store.ts'), 'utf-8');
+        expect(src).not.toMatch(/from\s+['"]fs['"]/);
+        expect(src).not.toMatch(/from\s+['"]path['"]/);
+        expect(src).not.toMatch(/from\s+['"]node:fs/);
+        expect(src).not.toMatch(/from\s+['"]node:path/);
+    });
+});
+//# sourceMappingURL=ledger-store.test.js.map

package/dist/runtime-v2/__tests__/ledger-store.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger-store.test.js","sourceRoot":"","sources":["../../../src/runtime-v2/__tests__/ledger-store.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,QAAQ,CAAC,4CAA4C,EAAE,GAAG,EAAE;IAC1D,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,SAAS,GAAoB;YACjC,EAAE,EAAE,SAAS;YACb,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,gBAAgB;YACtB,cAAc,EAAE,MAAM;YACtB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,aAAa;YAC3B,UAAU,EAAE,GAAG;YACf,aAAa,EAAE,GAAG;YAClB,kBAAkB,EAAE,CAAC;YACrB,kBAAkB,EAAE,EAAE;YACtB,OAAO,EAAE,EAAE;YACX,yBAAyB,EAAE,EAAE;YAC7B,SAAS,EAAE,sBAAsB;YACjC,SAAS,EAAE,sBAAsB;YACjC,cAAc,EAAE,CAAC,QAAQ,CAAC;YAC1B,eAAe,EAAE,sBAAsB;SACxC,CAAC;QACF,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,KAAK,GAAsB;YAC/B,aAAa,EAAE,EAAE;YACjB,IAAI,EAAE;gBACJ,UAAU,EAAE,EAAE;gBACd,KAAK,EAAE,EAAE;gBACT,eAAe,EAAE,EAAE;gBACnB,OAAO,EAAE,EAAE;gBACX,WAAW,EAAE,sBAAsB;aACpC;SACF,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,GAAG,GAAG,YAAY,CACtB,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,CAAC,EACpD,OAAO,CACR,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC7C,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/runtime-v2/__tests__/pain-signal-unification.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pain-signal-unification.test.d.ts.map

package/dist/runtime-v2/__tests__/pain-signal-unification.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pain-signal-unification.test.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/__tests__/pain-signal-unification.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/__tests__/pain-signal-unification.test.js

@@ -0,0 +1,150 @@
+/**
+ * PRI-443: Pain signal unification tests.
+ *
+ * Verifies that the top-level pain-signal.ts re-exports from
+ * runtime-v2/types/pain-signal.ts and that the unified schema
+ * includes the stricter validations from both versions:
+ * - ISO 8601 timestamp format check (from top-level)
+ * - Context size limit (from top-level)
+ * - version field (from top-level)
+ * - isStringRecord type guard instead of `as` (from runtime-v2)
+ */
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { validatePainSignal, deriveSeverity, PainSignalSchema } from '../../pain-signal.js';
+// Import from runtime-v2 (the canonical source)
+import { validatePainSignal as validatePainSignalV2, PainSignalSchema as PainSignalSchemaV2, } from '../types/pain-signal.js';
+describe('PRI-443: pain-signal.ts unification', () => {
+    it('top-level pain-signal.ts re-exports from runtime-v2 (no duplicate code)', () => {
+        const src = readFileSync(resolve(__dirname, '..', '..', '..', 'src', 'pain-signal.ts'), 'utf-8');
+        // Should NOT contain schema definition — only re-export
+        expect(src).not.toMatch(/export\s+const\s+PainSignalSchema\s*=/);
+        expect(src).not.toMatch(/export\s+function\s+validatePainSignal\s*\(/);
+        // Should contain re-export
+        expect(src).toMatch(/from\s+['"]\.\/runtime-v2\/types\/pain-signal\.js['"]/);
+    });
+    it('top-level and runtime-v2 validatePainSignal are the same function', () => {
+        expect(validatePainSignal).toBe(validatePainSignalV2);
+    });
+    it('top-level and runtime-v2 PainSignalSchema are the same object', () => {
+        expect(PainSignalSchema).toBe(PainSignalSchemaV2);
+    });
+    it('rejects invalid ISO 8601 timestamp', () => {
+        const signal = {
+            source: 'tool_failure',
+            score: 75,
+            timestamp: 'not-a-date',
+            reason: 'Test',
+            sessionId: 'sess-123',
+            agentId: 'main',
+            traceId: 'trace-abc',
+            triggerTextPreview: 'test',
+            domain: 'coding',
+            severity: 'high',
+            context: {},
+        };
+        const result = validatePainSignal(signal);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.includes('timestamp'))).toBe(true);
+    });
+    it('rejects context exceeding 10KB size limit', () => {
+        const largeContext = {};
+        const bigString = 'x'.repeat(11_000);
+        largeContext.big = bigString;
+        const signal = {
+            source: 'tool_failure',
+            score: 75,
+            timestamp: '2026-01-01T00:00:00Z',
+            reason: 'Test',
+            sessionId: 'sess-123',
+            agentId: 'main',
+            traceId: 'trace-abc',
+            triggerTextPreview: 'test',
+            domain: 'coding',
+            severity: 'high',
+            context: largeContext,
+        };
+        const result = validatePainSignal(signal);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.includes('Context'))).toBe(true);
+    });
+    it('rejects context with circular references without crashing (PR review fix)', () => {
+        const circularContext = {};
+        circularContext.self = circularContext;
+        const signal = {
+            source: 'tool_failure',
+            score: 75,
+            timestamp: '2026-01-01T00:00:00Z',
+            reason: 'Test',
+            sessionId: 'sess-123',
+            agentId: 'main',
+            traceId: 'trace-abc',
+            triggerTextPreview: 'test',
+            domain: 'coding',
+            severity: 'high',
+            context: circularContext,
+        };
+        const result = validatePainSignal(signal);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.includes('JSON-serializable'))).toBe(true);
+    });
+    it('rejects context with BigInt values without crashing (PR review fix)', () => {
+        const signal = {
+            source: 'tool_failure',
+            score: 75,
+            timestamp: '2026-01-01T00:00:00Z',
+            reason: 'Test',
+            sessionId: 'sess-123',
+            agentId: 'main',
+            traceId: 'trace-abc',
+            triggerTextPreview: 'test',
+            domain: 'coding',
+            severity: 'high',
+            context: { bigNum: BigInt(123) },
+        };
+        const result = validatePainSignal(signal);
+        expect(result.valid).toBe(false);
+        expect(result.errors.some((e) => e.includes('JSON-serializable'))).toBe(true);
+    });
+    it('accepts signal with optional sessionId/agentId/traceId missing', () => {
+        const signal = {
+            source: 'tool_failure',
+            score: 75,
+            timestamp: '2026-01-01T00:00:00Z',
+            reason: 'Test',
+            triggerTextPreview: 'test',
+            domain: 'coding',
+            severity: 'high',
+            context: {},
+        };
+        const result = validatePainSignal(signal);
+        expect(result.valid).toBe(true);
+    });
+    it('includes version field in validated signal', () => {
+        const signal = {
+            source: 'tool_failure',
+            score: 75,
+            timestamp: '2026-01-01T00:00:00Z',
+            reason: 'Test',
+            sessionId: 'sess-123',
+            agentId: 'main',
+            traceId: 'trace-abc',
+            triggerTextPreview: 'test',
+            domain: 'coding',
+            severity: 'high',
+            context: {},
+        };
+        const result = validatePainSignal(signal);
+        expect(result.valid).toBe(true);
+        expect(result.signal?.version).toBe('0.1.0');
+    });
+    it('PainSeverity type is exported', () => {
+        const s = 'low';
+        expect(s).toBe('low');
+    });
+    it('deriveSeverity is exported and works', () => {
+        expect(deriveSeverity(95)).toBe('critical');
+    });
+});
+//# sourceMappingURL=pain-signal-unification.test.js.map

package/dist/runtime-v2/__tests__/pain-signal-unification.test.js.map

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

package/dist/runtime-v2/index.d.ts

@@ -134,7 +134,6 @@ export type { PainChainTrace, PainChainTraceLatencyMs, PainChainReadModelOptions
 export { EvolutionQueueItemMigrator } from './store/task-migration.js';
 export { migrateWorkspaceGuidance, containsStalePlanMdGuidance, STALE_PLAN_MD_PATTERNS } from './workspace-guidance-migration.js';
 export type { MigrationResult as WorkspaceGuidanceMigrationResult } from './workspace-guidance-migration.js';
-export { loadLedger, saveLedger, getLedgerFilePathPublic, updatePrinciple } from '../principle-tree-ledger.js';
 export { PruningReadModel, removeOrphanReferencesFromLedger } from './pruning-read-model.js';
 export type { PrinciplePruningSignal, PruningHealthSummary, PruningReadModelOptions, PruningRiskLevel, OrphanDerivedCandidate, OrphanDetectionResult, RemovedOrphanReference } from './pruning-read-model.js';
 export { appendPruningReview, listPruningReviews } from './pruning-review-log.js';
@@ -195,7 +194,7 @@ export type { LifecycleRoute, LifecycleRouteEvidenceSummary, LifecycleRouteRecom
 export { recommendLifecycleRoute } from './internalization/routing-policy.js';
 export type { LifecycleDatasource } from './internalization/lifecycle-datasource.js';
 export { buildLifecycleReadModel } from './internalization/lifecycle-read-model.js';
-export type { LedgerTreeStore } from '../principle-tree-ledger.js';
+export type { LedgerTreeStore } from './types/ledger-store.js';
 export type { InternalizationChannel, PeerRunnerKind, DiagnosticianStageKind, RunnerKind, PIArtifactKind, PIArtifactValidationStatus, ArtifactRef, LineageRef, PIArtifact, PITaskRecord, } from './internalization/peer-runner-contracts.js';
 export { PEER_RUNNER_KINDS, DIAGNOSTICIAN_STAGE_KINDS, INTERNALIZATION_CHANNELS, PI_ARTIFACT_KINDS, isPeerRunnerKind, isDiagnosticianStageKind, isRunnerKind, isInternalizationChannel, isPIArtifactKind, isTerminalTaskStatus, isValidPITaskRecord, createMinimalPITaskRecord, } from './internalization/peer-runner-contracts.js';
 export { ALLOWED_EDGES, DIAGNOSTICIAN_EDGES, validateEdge, validateDiagEdge, getDiagSuccessors, isAcyclic, getAllowedSuccessors, getAllowedPredecessors, } from './internalization/internalization-job-graph.js';