@principles/core 1.73.0

package/dist/runtime-v2/feature-flags/__tests__/feature-flag-contract.test.js

@@ -0,0 +1,298 @@
+import { describe, it, expect } from 'vitest';
+import { validateFeatureFlagRaw, computeEffectiveFlags, DEFAULT_FEATURE_FLAGS, VALID_CATEGORIES, } from '../feature-flag-contract.js';
+describe('validateFeatureFlagRaw', () => {
+    it('accepts valid flag with all fields', () => {
+        const raw = {
+            id: 'gfi',
+            category: 'quiet',
+            enabled: false,
+            since: '2026-05-24',
+            description: 'Global Friction Index session scoring',
+        };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.value.id).toBe('gfi');
+            expect(result.value.category).toBe('quiet');
+            expect(result.value.enabled).toBe(false);
+            expect(result.value.since).toBe('2026-05-24');
+            expect(result.value.description).toBe('Global Friction Index session scoring');
+        }
+    });
+    it('accepts valid flag without description', () => {
+        const raw = {
+            id: 'gfi',
+            category: 'quiet',
+            enabled: false,
+            since: '2026-05-24',
+        };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(true);
+    });
+    it('rejects non-object input', () => {
+        const result = validateFeatureFlagRaw('not an object', 'test');
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.errors.length).toBeGreaterThan(0);
+        }
+    });
+    it('rejects null input', () => {
+        const result = validateFeatureFlagRaw(null, 'test');
+        expect(result.ok).toBe(false);
+    });
+    it('rejects array input', () => {
+        const result = validateFeatureFlagRaw([], 'test');
+        expect(result.ok).toBe(false);
+    });
+    it('rejects missing id', () => {
+        const raw = { category: 'quiet', enabled: false, since: '2026-05-24' };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.errors.some(e => e.includes('id'))).toBe(true);
+        }
+    });
+    it('rejects non-string id', () => {
+        const raw = { id: 42, category: 'quiet', enabled: false, since: '2026-05-24' };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(false);
+    });
+    it('rejects empty id', () => {
+        const raw = { id: '', category: 'quiet', enabled: false, since: '2026-05-24' };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(false);
+    });
+    it('rejects invalid category', () => {
+        const raw = { id: 'gfi', category: 'invalid', enabled: false, since: '2026-05-24' };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(false);
+        if (!result.ok) {
+            expect(result.errors.some(e => e.includes('category'))).toBe(true);
+        }
+    });
+    it('accepts all valid categories', () => {
+        const categories = ['core', 'quiet', 'gone', 'legacy_retire'];
+        for (const category of categories) {
+            const raw = { id: `test-${category}`, category, enabled: true, since: '2026-05-24' };
+            const result = validateFeatureFlagRaw(raw, `test-${category}`);
+            expect(result.ok, `category ${category} should be valid`).toBe(true);
+        }
+    });
+    it('rejects non-boolean enabled', () => {
+        const raw = { id: 'gfi', category: 'quiet', enabled: 'false', since: '2026-05-24' };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(false);
+    });
+    it('rejects missing enabled', () => {
+        const raw = { id: 'gfi', category: 'quiet', since: '2026-05-24' };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(false);
+    });
+    it('rejects missing since', () => {
+        const raw = { id: 'gfi', category: 'quiet', enabled: false };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(false);
+    });
+    it('rejects non-string since', () => {
+        const raw = { id: 'gfi', category: 'quiet', enabled: false, since: 20260524 };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(false);
+    });
+    it('rejects empty since', () => {
+        const raw = { id: 'gfi', category: 'quiet', enabled: false, since: '' };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(false);
+    });
+    it('rejects non-string description when present', () => {
+        const raw = { id: 'gfi', category: 'quiet', enabled: false, since: '2026-05-24', description: 42 };
+        const result = validateFeatureFlagRaw(raw, 'test');
+        expect(result.ok).toBe(false);
+    });
+    it('includes source key in errors for traceability', () => {
+        const result = validateFeatureFlagRaw({ id: 42 }, 'my-flag');
+        if (!result.ok) {
+            expect(result.source).toBe('my-flag');
+        }
+    });
+});
+describe('computeEffectiveFlags', () => {
+    it('returns defaults when no user flags provided', () => {
+        const result = computeEffectiveFlags({}, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        expect(result.source).toBe('defaults');
+        expect(result.configPath).toBe('/test/.pd/feature-flags.yaml');
+        expect(Object.keys(result.flags).length).toBeGreaterThan(0);
+        expect(result.warnings).toEqual([]);
+    });
+    it('returns workspace_file source when user flags are provided', () => {
+        const userFlags = {
+            gfi: { enabled: true, since: '2026-05-24' },
+        };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        expect(result.source).toBe('workspace_file');
+    });
+    it('does not allow enabling quiet flags from malformed input', () => {
+        const userFlags = {
+            gfi: { enabled: 'yes', since: '2026-05-24' },
+        };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        const gfiFlag = result.flags.gfi;
+        expect(gfiFlag).toBeDefined();
+        // Malformed enabled field must NOT enable a quiet flag
+        if (gfiFlag) {
+            expect(gfiFlag.enabled).toBe(false);
+        }
+        expect(result.warnings.length).toBeGreaterThan(0);
+    });
+    it('does not allow enabling unknown flags', () => {
+        const userFlags = {
+            totally_made_up: { category: 'quiet', enabled: true, since: '2026-05-24' },
+        };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        expect(result.flags.totally_made_up).toBeUndefined();
+        expect(result.warnings.some(w => w.includes('totally_made_up'))).toBe(true);
+    });
+    it('preserves core flags as enabled regardless of user config', () => {
+        const promptDefault = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'prompt');
+        if (!promptDefault)
+            return;
+        const userFlags = {
+            prompt: { enabled: false, since: '2026-01-01' },
+        };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        const promptFlag = result.flags.prompt;
+        if (promptFlag) {
+            expect(promptFlag.enabled).toBe(true);
+        }
+        expect(result.warnings.some(w => w.includes('core') || w.includes('prompt'))).toBe(true);
+    });
+    it('allows explicit enable of quiet flag with valid input', () => {
+        const userFlags = {
+            gfi: { enabled: true, since: '2026-05-24' },
+        };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        const gfiFlag = result.flags.gfi;
+        if (gfiFlag) {
+            expect(gfiFlag.enabled).toBe(true);
+        }
+    });
+    it('default-off quiet flags are disabled when no config', () => {
+        const result = computeEffectiveFlags({}, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        const quietFlags = Object.values(result.flags).filter(f => f.category === 'quiet');
+        for (const flag of quietFlags) {
+            expect(flag.enabled, `quiet flag ${flag.id} should default off`).toBe(false);
+        }
+    });
+    it('core flags are enabled by default', () => {
+        const result = computeEffectiveFlags({}, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        const coreFlags = Object.values(result.flags).filter(f => f.category === 'core');
+        for (const flag of coreFlags) {
+            expect(flag.enabled, `core flag ${flag.id} should default on`).toBe(true);
+        }
+    });
+    it('gone flags are always disabled regardless of config', () => {
+        const goneDefault = DEFAULT_FEATURE_FLAGS.find(f => f.category === 'gone');
+        if (!goneDefault)
+            return;
+        const userFlags = {
+            [goneDefault.id]: { enabled: true, since: '2026-05-24' },
+        };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        const goneFlag = result.flags[goneDefault.id];
+        if (goneFlag) {
+            expect(goneFlag.enabled).toBe(false);
+        }
+    });
+});
+describe('DEFAULT_FEATURE_FLAGS', () => {
+    it('contains prompt core flag', () => {
+        const prompt = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'prompt');
+        expect(prompt).toBeDefined();
+        if (prompt) {
+            expect(prompt.category).toBe('core');
+            expect(prompt.enabled).toBe(true);
+        }
+    });
+    it('contains code_tool_hook core flag', () => {
+        const flag = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'code_tool_hook');
+        expect(flag).toBeDefined();
+        if (flag) {
+            expect(flag.category).toBe('core');
+            expect(flag.enabled).toBe(true);
+        }
+    });
+    it('contains defer_archive core flag', () => {
+        const flag = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'defer_archive');
+        expect(flag).toBeDefined();
+        if (flag) {
+            expect(flag.category).toBe('core');
+            expect(flag.enabled).toBe(true);
+        }
+    });
+    it('contains gfi quiet flag (default off)', () => {
+        const flag = DEFAULT_FEATURE_FLAGS.find(f => f.id === 'gfi');
+        expect(flag).toBeDefined();
+        if (flag) {
+            expect(flag.category).toBe('quiet');
+            expect(flag.enabled).toBe(false);
+        }
+    });
+    it('all flags have valid since dates', () => {
+        for (const flag of DEFAULT_FEATURE_FLAGS) {
+            expect(flag.since, `flag ${flag.id} since`).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+        }
+    });
+    it('all flags have valid categories', () => {
+        for (const flag of DEFAULT_FEATURE_FLAGS) {
+            expect(VALID_CATEGORIES).toContain(flag.category);
+        }
+    });
+    it('no duplicate flag ids', () => {
+        const ids = DEFAULT_FEATURE_FLAGS.map(f => f.id);
+        expect(new Set(ids).size).toBe(ids.length);
+    });
+    it('has description for every flag', () => {
+        for (const flag of DEFAULT_FEATURE_FLAGS) {
+            expect(flag.description, `flag ${flag.id} needs description`).toBeDefined();
+            expect(typeof flag.description).toBe('string');
+            if (flag.description) {
+                expect(flag.description.length).toBeGreaterThan(0);
+            }
+        }
+    });
+});
+describe('VALID_CATEGORIES', () => {
+    it('contains exactly core, quiet, gone, legacy_retire', () => {
+        expect(VALID_CATEGORIES).toEqual(['core', 'quiet', 'gone', 'legacy_retire']);
+    });
+});
+describe('prototype pollution defense', () => {
+    it('rejects constructor key in user flags', () => {
+        const userFlags = { constructor: { enabled: true } };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        expect(result.warnings.some(w => w.includes('constructor'))).toBe(true);
+    });
+    it('rejects prototype key in user flags', () => {
+        const userFlags = { prototype: { enabled: true } };
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        expect(result.warnings.some(w => w.includes('prototype'))).toBe(true);
+    });
+    it('rejects __proto__ when passed as explicit enumerable key', () => {
+        const userFlags = {};
+        Object.defineProperty(userFlags, '__proto__', {
+            value: { enabled: true },
+            enumerable: true,
+            writable: true,
+            configurable: true,
+        });
+        const result = computeEffectiveFlags(userFlags, DEFAULT_FEATURE_FLAGS, '/test/.pd/feature-flags.yaml');
+        expect(result.warnings.some(w => w.includes('__proto__'))).toBe(true);
+    });
+    it('Object.hasOwn used for override reads (not in operator)', async () => {
+        const { readFileSync } = await import('node:fs');
+        const { resolve } = await import('node:path');
+        const src = readFileSync(resolve(__dirname, '..', 'feature-flag-contract.ts'), 'utf-8');
+        const overrideReads = src.match(/Object\.hasOwn\(/g);
+        expect(overrideReads && overrideReads.length).toBeGreaterThanOrEqual(4);
+    });
+});
+//# sourceMappingURL=feature-flag-contract.test.js.map

package/dist/runtime-v2/feature-flags/__tests__/feature-flag-contract.test.js.map

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

package/dist/runtime-v2/feature-flags/feature-flag-contract.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Feature Flag Contract — PRI-239
+ *
+ * Pure types and validators for the MVP-Quiet feature flag registry.
+ * No I/O — YAML loading lives in pd-cli.
+ */
+export declare const VALID_CATEGORIES: readonly ["core", "quiet", "gone", "legacy_retire"];
+export type FeatureFlagCategory = (typeof VALID_CATEGORIES)[number];
+export interface FeatureFlagDefinition {
+    id: string;
+    category: FeatureFlagCategory;
+    enabled: boolean;
+    since: string;
+    description?: string;
+}
+export interface EffectiveFeatureFlags {
+    flags: Record<string, FeatureFlagDefinition>;
+    source: 'defaults' | 'workspace_file';
+    configPath: string;
+    warnings: string[];
+}
+export interface ValidationResultOk {
+    ok: true;
+    value: FeatureFlagDefinition;
+}
+export interface ValidationResultErr {
+    ok: false;
+    errors: string[];
+    source: string;
+}
+export type ValidationResult = ValidationResultOk | ValidationResultErr;
+export declare function validateFeatureFlagRaw(raw: unknown, source: string): ValidationResult;
+export declare const DEFAULT_FEATURE_FLAGS: FeatureFlagDefinition[];
+export declare function computeEffectiveFlags(userFlags: Record<string, unknown>, defaults: FeatureFlagDefinition[], configPath: string): EffectiveFeatureFlags;
+//# sourceMappingURL=feature-flag-contract.d.ts.map

package/dist/runtime-v2/feature-flags/feature-flag-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag-contract.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/feature-flags/feature-flag-contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB,qDAAsD,CAAC;AACpF,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIpE,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC7C,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAExE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAkDrF;AAED,eAAO,MAAM,qBAAqB,EAAE,qBAAqB,EAexD,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,EAAE,qBAAqB,EAAE,EACjC,UAAU,EAAE,MAAM,GACjB,qBAAqB,CAqEvB"}

package/dist/runtime-v2/feature-flags/feature-flag-contract.js

@@ -0,0 +1,124 @@
+/**
+ * Feature Flag Contract — PRI-239
+ *
+ * Pure types and validators for the MVP-Quiet feature flag registry.
+ * No I/O — YAML loading lives in pd-cli.
+ */
+export const VALID_CATEGORIES = ['core', 'quiet', 'gone', 'legacy_retire'];
+const DANGEROUS_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+export function validateFeatureFlagRaw(raw, source) {
+    const errors = [];
+    if (raw === null || raw === undefined || typeof raw !== 'object' || Array.isArray(raw)) {
+        return { ok: false, errors: ['input must be a non-null object'], source };
+    }
+    const obj = raw;
+    const id = Object.hasOwn(obj, 'id') ? obj.id : undefined;
+    if (typeof id !== 'string' || id.length === 0) {
+        errors.push('id must be a non-empty string');
+    }
+    const category = Object.hasOwn(obj, 'category') ? obj.category : undefined;
+    if (typeof category !== 'string' || !VALID_CATEGORIES.includes(category)) {
+        errors.push(`category must be one of: ${VALID_CATEGORIES.join(', ')}`);
+    }
+    const enabled = Object.hasOwn(obj, 'enabled') ? obj.enabled : undefined;
+    if (typeof enabled !== 'boolean') {
+        errors.push('enabled must be a boolean');
+    }
+    const since = Object.hasOwn(obj, 'since') ? obj.since : undefined;
+    if (typeof since !== 'string' || since.length === 0) {
+        errors.push('since must be a non-empty string');
+    }
+    const description = Object.hasOwn(obj, 'description') ? obj.description : undefined;
+    if (description !== undefined && typeof description !== 'string') {
+        errors.push('description must be a string when present');
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors, source };
+    }
+    const value = {
+        id: id,
+        category: category,
+        enabled: enabled,
+        since: since,
+    };
+    if (description !== undefined) {
+        value.description = description;
+    }
+    return { ok: true, value };
+}
+export const DEFAULT_FEATURE_FLAGS = [
+    // MVP-Core — always enabled, cannot be disabled
+    { id: 'prompt', category: 'core', enabled: true, since: '2026-05-24', description: 'Prompt injection for principle application' },
+    { id: 'code_tool_hook', category: 'core', enabled: true, since: '2026-05-24', description: 'Code tool hook for rule host enforcement' },
+    { id: 'defer_archive', category: 'core', enabled: true, since: '2026-05-24', description: 'Defer/archive activation writer' },
+    // MVP-Quiet — default disabled, opt-in via config
+    // Only flags with real consumption paths are registered (PRI-239 constraint)
+    { id: 'gfi', category: 'quiet', enabled: false, since: '2026-05-24', description: 'Global Friction Index session scoring' },
+    // MVP-Gone — permanently disabled, cannot be re-enabled
+    { id: 'nocturnal', category: 'gone', enabled: false, since: '2026-05-24', description: 'Nocturnal trinity pipeline (retired)' },
+    { id: 'idle_trigger', category: 'gone', enabled: false, since: '2026-05-24', description: 'Idle trigger for background processing (retired)' },
+    { id: 'model_training', category: 'gone', enabled: false, since: '2026-05-24', description: 'Model training channel (retired)' },
+    { id: 'trainer', category: 'gone', enabled: false, since: '2026-05-24', description: 'Trainer peer runner (retired)' },
+];
+export function computeEffectiveFlags(userFlags, defaults, configPath) {
+    const warnings = [];
+    const flags = {};
+    const safeKeys = Object.keys(userFlags).filter(key => {
+        if (DANGEROUS_KEYS.has(key)) {
+            warnings.push(`flag '${key}': dangerous key rejected`);
+            return false;
+        }
+        return true;
+    });
+    const hasUserFlags = safeKeys.length > 0;
+    for (const def of defaults) {
+        if (!Object.hasOwn(userFlags, def.id) || DANGEROUS_KEYS.has(def.id)) {
+            flags[def.id] = { ...def };
+            continue;
+        }
+        const override = userFlags[def.id];
+        const isPlainObj = override !== null && override !== undefined && typeof override === 'object' && !Array.isArray(override);
+        const enabledValue = isPlainObj && Object.hasOwn(override, 'enabled')
+            ? override.enabled
+            : undefined;
+        if (typeof enabledValue !== 'boolean') {
+            flags[def.id] = { ...def };
+            warnings.push(`flag '${def.id}': malformed override kept default (enabled must be boolean)`);
+            continue;
+        }
+        // Gone flags can never be re-enabled
+        if (def.category === 'gone') {
+            flags[def.id] = { ...def };
+            if (enabledValue) {
+                warnings.push(`flag '${def.id}': gone flag cannot be re-enabled`);
+            }
+            continue;
+        }
+        // Core flags can never be disabled
+        if (def.category === 'core') {
+            flags[def.id] = { ...def };
+            if (!enabledValue) {
+                warnings.push(`flag '${def.id}': core flag cannot be disabled`);
+            }
+            continue;
+        }
+        // Quiet flags: accept valid user override
+        flags[def.id] = {
+            ...def,
+            enabled: enabledValue,
+        };
+    }
+    // Warn about unknown flags
+    for (const key of safeKeys) {
+        if (!Object.hasOwn(flags, key)) {
+            warnings.push(`flag '${key}': unknown flag ignored`);
+        }
+    }
+    return {
+        flags,
+        source: hasUserFlags ? 'workspace_file' : 'defaults',
+        configPath,
+        warnings,
+    };
+}
+//# sourceMappingURL=feature-flag-contract.js.map

package/dist/runtime-v2/feature-flags/feature-flag-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flag-contract.js","sourceRoot":"","sources":["../../../src/runtime-v2/feature-flags/feature-flag-contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,CAAU,CAAC;AAGpF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AA8B1E,MAAM,UAAU,sBAAsB,CAAC,GAAY,EAAE,MAAc;IACjE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,iCAAiC,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5E,CAAC;IAED,MAAM,GAAG,GAAG,GAAG,CAAC;IAEhB,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAE,GAA+B,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAE,GAA+B,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACxG,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAA+B,CAAC,EAAE,CAAC;QAChG,MAAM,CAAC,IAAI,CAAC,4BAA4B,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAE,GAA+B,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACrG,IAAI,OAAO,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAE,GAA+B,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/F,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,CAAE,GAA+B,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACjH,IAAI,WAAW,KAAK,SAAS,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,KAAK,GAA0B;QACnC,EAAE,EAAE,EAAY;QAChB,QAAQ,EAAE,QAA+B;QACzC,OAAO,EAAE,OAAkB;QAC3B,KAAK,EAAE,KAAe;KACvB,CAAC;IAEF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,KAAK,CAAC,WAAW,GAAG,WAAqB,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAA4B;IAC5D,gDAAgD;IAChD,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,4CAA4C,EAAE;IACjI,EAAE,EAAE,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,0CAA0C,EAAE;IACvI,EAAE,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,iCAAiC,EAAE;IAE7H,kDAAkD;IAClD,6EAA6E;IAC7E,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,uCAAuC,EAAE;IAE3H,wDAAwD;IACxD,EAAE,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,sCAAsC,EAAE;IAC/H,EAAE,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kDAAkD,EAAE;IAC9I,EAAE,EAAE,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,kCAAkC,EAAE;IAChI,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,+BAA+B,EAAE;CACvH,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,SAAkC,EAClC,QAAiC,EACjC,UAAkB;IAElB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,KAAK,GAA0C,EAAE,CAAC;IAExD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;QACnD,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,2BAA2B,CAAC,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAEzC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACpE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,UAAU,GAAG,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3H,MAAM,YAAY,GAAG,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC;YACnE,CAAC,CAAE,QAAoC,CAAC,OAAO;YAC/C,CAAC,CAAC,SAAS,CAAC;QAEd,IAAI,OAAO,YAAY,KAAK,SAAS,EAAE,CAAC;YACtC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;YAC3B,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,8DAA8D,CAAC,CAAC;YAC7F,SAAS;QACX,CAAC;QAED,qCAAqC;QACrC,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC5B,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;YAC3B,IAAI,YAAY,EAAE,CAAC;gBACjB,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,mCAAmC,CAAC,CAAC;YACpE,CAAC;YACD,SAAS;QACX,CAAC;QAED,mCAAmC;QACnC,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC5B,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,iCAAiC,CAAC,CAAC;YAClE,CAAC;YACD,SAAS;QACX,CAAC;QAED,0CAA0C;QAC1C,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG;YACd,GAAG,GAAG;YACN,OAAO,EAAE,YAAY;SACtB,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,yBAAyB,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;QACL,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU;QACpD,UAAU;QACV,QAAQ;KACT,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,3 @@
+export { VALID_CATEGORIES, validateFeatureFlagRaw, computeEffectiveFlags, DEFAULT_FEATURE_FLAGS, } from './feature-flag-contract.js';
+export type { FeatureFlagCategory, FeatureFlagDefinition, EffectiveFeatureFlags, ValidationResult, ValidationResultOk, ValidationResultErr, } from './feature-flag-contract.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime-v2/feature-flags/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/feature-flags/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC"}

package/dist/runtime-v2/feature-flags/index.js

@@ -0,0 +1,2 @@
+export { VALID_CATEGORIES, validateFeatureFlagRaw, computeEffectiveFlags, DEFAULT_FEATURE_FLAGS, } from './feature-flag-contract.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime-v2/feature-flags/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime-v2/feature-flags/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC"}

package/dist/runtime-v2/full-trace-contract.d.ts

@@ -0,0 +1,79 @@
+/**
+ * FullTrace quality contract and schema hardening (PRI-190).
+ *
+ * Defines the structured payload contract for source execution traces
+ * consumed by Diagnostician and downstream L2 components (TraceRefiner).
+ *
+ * Key invariants:
+ *   - sourceTaskId / sourcePainId / sourceRunIds provide traceability
+ *   - timeline is a structured array, not a string blob
+ *   - sourceRefs explicitly record task/run/artifact/event references
+ *   - ambiguityNotes preserves PRI-189 missing/mismatch/ambiguous diagnostics
+ *   - sanitizationNotes records every redaction action
+ *   - capturedAt is an ISO timestamp
+ *   - All unknown input is runtime-validated (no `as` casts on untrusted JSON)
+ *
+ * This module is pure logic — zero I/O, no filesystem/path/process imports, no plugin deps.
+ */
+import { type Static } from '@sinclair/typebox';
+export declare const TRACE_EVENT_KINDS: readonly ["tool_call", "tool_result", "assistant_message", "user_message", "system_event", "unknown"];
+export type TraceEventKind = (typeof TRACE_EVENT_KINDS)[number];
+export declare const TraceEventKindSchema: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"unknown" | "tool_call" | "tool_result" | "assistant_message" | "user_message" | "system_event">[]>;
+export declare const SOURCE_REF_KINDS: readonly ["task", "run", "artifact", "event"];
+export type SourceRefKind = (typeof SOURCE_REF_KINDS)[number];
+export declare const SourceRefKindSchema: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"run" | "task" | "artifact" | "event">[]>;
+export declare const TraceSourceRefSchema: import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"run" | "task" | "artifact" | "event">[]>;
+    id: import("@sinclair/typebox").TString;
+}>;
+export type TraceSourceRef = Static<typeof TraceSourceRefSchema>;
+export declare const TraceTimelineEntrySchema: import("@sinclair/typebox").TObject<{
+    at: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    kind: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"unknown" | "tool_call" | "tool_result" | "assistant_message" | "user_message" | "system_event">[]>;
+    summary: import("@sinclair/typebox").TString;
+    rawPreview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+}>;
+export type TraceTimelineEntry = Static<typeof TraceTimelineEntrySchema>;
+export declare const FullTracePayloadV2Schema: import("@sinclair/typebox").TObject<{
+    sourceTaskId: import("@sinclair/typebox").TString;
+    sourcePainId: import("@sinclair/typebox").TString;
+    sourceRunIds: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    capturedAt: import("@sinclair/typebox").TString;
+    sourceRefs: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        kind: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"run" | "task" | "artifact" | "event">[]>;
+        id: import("@sinclair/typebox").TString;
+    }>>;
+    timeline: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        at: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        kind: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<"unknown" | "tool_call" | "tool_result" | "assistant_message" | "user_message" | "system_event">[]>;
+        summary: import("@sinclair/typebox").TString;
+        rawPreview: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        metadata: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    }>>;
+    ambiguityNotes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    sanitizationNotes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+}>;
+export type FullTracePayloadV2 = Static<typeof FullTracePayloadV2Schema>;
+export interface FullTraceValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateFullTracePayload(input: unknown): FullTraceValidationResult;
+export interface SanitizeFullTraceResult {
+    payload: FullTracePayloadV2;
+    sanitizationNotes: string[];
+}
+export declare function sanitizeFullTracePayload(input: FullTracePayloadV2): SanitizeFullTraceResult;
+export interface RunRecordLike {
+    runId: string;
+    inputPayload?: string;
+    outputPayload?: string;
+    startedAt: string;
+    endedAt?: string;
+    executionStatus: string;
+}
+export declare function buildFullTraceTimeline(runs: readonly RunRecordLike[]): TraceTimelineEntry[];
+export declare function buildSourceRefs(sourceTaskId: string, sourceRunIds: string[]): TraceSourceRef[];
+export declare function checkFullTracePayloadSchema(input: unknown): boolean;
+//# sourceMappingURL=full-trace-contract.d.ts.map

package/dist/runtime-v2/full-trace-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"full-trace-contract.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/full-trace-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAKtD,eAAO,MAAM,iBAAiB,uGAOpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,eAAO,MAAM,oBAAoB,6KAEhC,CAAC;AAIF,eAAO,MAAM,gBAAgB,+CAKnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,mBAAmB,mHAE/B,CAAC;AAIF,eAAO,MAAM,oBAAoB;;;EAG/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAIjE,eAAO,MAAM,wBAAwB;;;;;;EAMnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAIzE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;EASnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAIzE,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA2DD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAuFlF;AAkED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,GAAG,uBAAuB,CAuC3F;AAID,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AA+CD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,kBAAkB,EAAE,CAuI3F;AAID,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EAAE,GACrB,cAAc,EAAE,CAQlB;AAID,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEnE"}