@principles/core 1.273.1 → 1.274.0

package/dist/pain-signal-adapter.d.ts

@@ -1,37 +0,0 @@
-/**
- * PainSignalAdapter interface for the Evolution SDK.
- *
- * This interface decouples the evolution engine from specific AI agent
- * frameworks (OpenClaw, Claude Code, etc.). All modules that need to
- * capture pain signals from tool failures should depend on this interface
- * rather than importing framework-specific event types directly.
- *
- * The interface uses a generic type parameter for the raw framework event,
- * so each framework implementation provides its own concrete type.
- */
-import type { PainSignal } from './pain-signal.js';
-/**
- * Framework-agnostic adapter for capturing pain signals.
- *
- * @typeParam TRawEvent - The framework-specific event type
- * (e.g., PluginHookAfterToolCallEvent for OpenClaw)
- */
-export interface PainSignalAdapter<TRawEvent> {
-    /**
-     * Translate a framework-specific event into a universal PainSignal.
-     *
-     * Returns null when the event does not constitute a pain signal:
-     *  - "Not applicable": event type is not a failure (e.g., tool succeeded)
-     *  - "Malformed": required fields are missing or invalid (e.g., no sessionId)
-     *
-     * In both cases null is returned -- callers do not need to distinguish.
-     * This method performs pure translation only. Trigger decision logic
-     * (e.g., GFI threshold checks, tool name filtering) stays in the
-     * framework-side hook logic. Per D-02, capture() only translates.
-     *
-     * @param rawEvent - The framework-specific event to translate
-     * @returns A valid PainSignal, or null if the event does not produce one
-     */
-    capture(rawEvent: TRawEvent): PainSignal | null;
-}
-//# sourceMappingURL=pain-signal-adapter.d.ts.map

package/dist/pain-signal-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pain-signal-adapter.d.ts","sourceRoot":"","sources":["../src/pain-signal-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB,CAAC,SAAS;IAC1C;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,QAAQ,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAAC;CACjD"}

package/dist/pain-signal-adapter.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=pain-signal-adapter.js.map

package/dist/pain-signal-adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pain-signal-adapter.js","sourceRoot":"","sources":["../src/pain-signal-adapter.ts"],"names":[],"mappings":""}

package/dist/pain-signal.d.ts

@@ -1,16 +0,0 @@
-/**
- * Pain signal schema — re-exported from runtime-v2/types/pain-signal.ts.
- *
- * This file exists for backward compatibility with imports from
- * @principles/core (top-level barrel). The canonical definition
- * lives in runtime-v2/types/pain-signal.ts (PRI-443).
- *
- * The unified schema merges the stricter validations from both versions:
- * - ISO 8601 timestamp format check
- * - Context size limit (10KB)
- * - version field with default
- * - isStringRecord type guard (no `as` bypass)
- */
-export { PainSeverity, PainSignalSchema, deriveSeverity, validatePainSignal, } from './runtime-v2/types/pain-signal.js';
-export type { PainSignal, PainSignalValidationResult, } from './runtime-v2/types/pain-signal.js';
-//# sourceMappingURL=pain-signal.d.ts.map

package/dist/pain-signal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pain-signal.d.ts","sourceRoot":"","sources":["../src/pain-signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EACV,UAAU,EACV,0BAA0B,GAC3B,MAAM,mCAAmC,CAAC"}

package/dist/pain-signal.js

@@ -1,15 +0,0 @@
-/**
- * Pain signal schema — re-exported from runtime-v2/types/pain-signal.ts.
- *
- * This file exists for backward compatibility with imports from
- * @principles/core (top-level barrel). The canonical definition
- * lives in runtime-v2/types/pain-signal.ts (PRI-443).
- *
- * The unified schema merges the stricter validations from both versions:
- * - ISO 8601 timestamp format check
- * - Context size limit (10KB)
- * - version field with default
- * - isStringRecord type guard (no `as` bypass)
- */
-export { PainSeverity, PainSignalSchema, deriveSeverity, validatePainSignal, } from './runtime-v2/types/pain-signal.js';
-//# sourceMappingURL=pain-signal.js.map

package/dist/pain-signal.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pain-signal.js","sourceRoot":"","sources":["../src/pain-signal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,kBAAkB,GACnB,MAAM,mCAAmC,CAAC"}

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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,150 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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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"}