@plumbus/core 0.1.0

package/dist/flows/state-machine.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Flow execution status values and valid transitions.
+ * States: created → running → waiting → running → completed | failed | cancelled
+ */
+export declare const FlowStatus: {
+    readonly Created: "created";
+    readonly Running: "running";
+    readonly Waiting: "waiting";
+    readonly Completed: "completed";
+    readonly Failed: "failed";
+    readonly Cancelled: "cancelled";
+};
+export type FlowStatus = (typeof FlowStatus)[keyof typeof FlowStatus];
+export declare const StepStatus: {
+    readonly Pending: "pending";
+    readonly Running: "running";
+    readonly Completed: "completed";
+    readonly Failed: "failed";
+    readonly Skipped: "skipped";
+};
+export type StepStatus = (typeof StepStatus)[keyof typeof StepStatus];
+export interface StepHistoryEntry {
+    step: string;
+    status: StepStatus;
+    startedAt: string;
+    completedAt?: string;
+    error?: string;
+}
+/**
+ * Check if a status transition is valid.
+ */
+export declare function isValidTransition(from: FlowStatus, to: FlowStatus): boolean;
+/**
+ * Assert a transition is valid, throwing if not.
+ */
+export declare function assertTransition(from: FlowStatus, to: FlowStatus): void;
+/**
+ * Check if a flow is in a terminal state (no further transitions possible).
+ */
+export declare function isTerminal(status: FlowStatus): boolean;
+//# sourceMappingURL=state-machine.d.ts.map

package/dist/flows/state-machine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../../src/flows/state-machine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE,eAAO,MAAM,UAAU;;;;;;CAMb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,OAAO,CAE3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,CAIvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAMtD"}

package/dist/flows/state-machine.js

@@ -0,0 +1,56 @@
+/**
+ * Flow execution status values and valid transitions.
+ * States: created → running → waiting → running → completed | failed | cancelled
+ */
+export const FlowStatus = {
+    Created: 'created',
+    Running: 'running',
+    Waiting: 'waiting',
+    Completed: 'completed',
+    Failed: 'failed',
+    Cancelled: 'cancelled',
+};
+export const StepStatus = {
+    Pending: 'pending',
+    Running: 'running',
+    Completed: 'completed',
+    Failed: 'failed',
+    Skipped: 'skipped',
+};
+/** Valid transitions from each flow status */
+const validTransitions = {
+    [FlowStatus.Created]: [FlowStatus.Running, FlowStatus.Cancelled],
+    [FlowStatus.Running]: [
+        FlowStatus.Waiting,
+        FlowStatus.Completed,
+        FlowStatus.Failed,
+        FlowStatus.Cancelled,
+    ],
+    [FlowStatus.Waiting]: [FlowStatus.Running, FlowStatus.Cancelled, FlowStatus.Failed],
+    [FlowStatus.Completed]: [],
+    [FlowStatus.Failed]: [],
+    [FlowStatus.Cancelled]: [],
+};
+/**
+ * Check if a status transition is valid.
+ */
+export function isValidTransition(from, to) {
+    return validTransitions[from]?.includes(to) ?? false;
+}
+/**
+ * Assert a transition is valid, throwing if not.
+ */
+export function assertTransition(from, to) {
+    if (!isValidTransition(from, to)) {
+        throw new Error(`Invalid flow status transition: "${from}" → "${to}"`);
+    }
+}
+/**
+ * Check if a flow is in a terminal state (no further transitions possible).
+ */
+export function isTerminal(status) {
+    return (status === FlowStatus.Completed ||
+        status === FlowStatus.Failed ||
+        status === FlowStatus.Cancelled);
+}
+//# sourceMappingURL=state-machine.js.map

package/dist/flows/state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.js","sourceRoot":"","sources":["../../src/flows/state-machine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CACd,CAAC;AAIX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACV,CAAC;AAYX,8CAA8C;AAC9C,MAAM,gBAAgB,GAAqC;IACzD,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;IAChE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;QACpB,UAAU,CAAC,OAAO;QAClB,UAAU,CAAC,SAAS;QACpB,UAAU,CAAC,MAAM;QACjB,UAAU,CAAC,SAAS;KACrB;IACD,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC;IACnF,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE;IAC1B,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE;IACvB,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,EAAE;CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAgB,EAAE,EAAc;IAChE,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAgB,EAAE,EAAc;IAC/D,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,OAAO,CACL,MAAM,KAAK,UAAU,CAAC,SAAS;QAC/B,MAAM,KAAK,UAAU,CAAC,MAAM;QAC5B,MAAM,KAAK,UAAU,CAAC,SAAS,CAChC,CAAC;AACJ,CAAC"}

package/dist/flows/step-executor.d.ts

@@ -0,0 +1,36 @@
+import type { ExecutionContext } from '../types/context.js';
+import type { FlowStep } from '../types/flow.js';
+import { StepStatus, type StepHistoryEntry } from './state-machine.js';
+export interface StepResult {
+    status: StepStatus;
+    /** For condition steps: the chosen branch step name */
+    nextStep?: string;
+    /** For wait steps: the event we're waiting for */
+    waitEvent?: string;
+    /** For delay steps: the delay duration string */
+    delayDuration?: string;
+    /** For parallel steps: the branch names to execute concurrently */
+    parallelBranches?: string[];
+    /** Error message if the step failed */
+    error?: string;
+}
+export interface StepExecutorDeps {
+    /** Execute a named capability and return its output */
+    executeCapability: (capabilityName: string, ctx: ExecutionContext, input: unknown) => Promise<{
+        success: boolean;
+        data?: unknown;
+        error?: unknown;
+    }>;
+    /** Evaluate a condition expression against the flow state */
+    evaluateCondition: (expression: string, state: unknown) => boolean;
+}
+/**
+ * Execute a single flow step. Returns a StepResult describing what happened
+ * and what should happen next (next step, wait, delay, parallel branches).
+ */
+export declare function executeStep(step: FlowStep, ctx: ExecutionContext, state: unknown, deps: StepExecutorDeps): Promise<StepResult>;
+/**
+ * Build a StepHistoryEntry for audit/persistence.
+ */
+export declare function buildHistoryEntry(stepName: string, result: StepResult, startedAt: Date, completedAt: Date): StepHistoryEntry;
+//# sourceMappingURL=step-executor.d.ts.map

package/dist/flows/step-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-executor.d.ts","sourceRoot":"","sources":["../../src/flows/step-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,KAAK,EAKV,QAAQ,EAGT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEvE,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uDAAuD;IACvD,iBAAiB,EAAE,CACjB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,OAAO,KACX,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpE,6DAA6D;IAC7D,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACpE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CAoBrB;AAwFD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,IAAI,EACf,WAAW,EAAE,IAAI,GAChB,gBAAgB,CAQlB"}

package/dist/flows/step-executor.js

@@ -0,0 +1,109 @@
+import { FlowStepType } from '../types/enums.js';
+import { StepStatus } from './state-machine.js';
+/**
+ * Execute a single flow step. Returns a StepResult describing what happened
+ * and what should happen next (next step, wait, delay, parallel branches).
+ */
+export async function executeStep(step, ctx, state, deps) {
+    switch (step.type) {
+        case FlowStepType.Capability:
+            return executeCapabilityStep(step, ctx, state, deps);
+        case FlowStepType.Conditional:
+            return executeConditionalStep(step, state, deps);
+        case FlowStepType.Wait:
+            return executeWaitStep(step);
+        case FlowStepType.Delay:
+            return executeDelayStep(step);
+        case FlowStepType.Parallel:
+            return executeParallelStep(step);
+        case FlowStepType.EventEmit:
+            return executeEventEmitStep(step, ctx, state);
+        default:
+            return {
+                status: StepStatus.Failed,
+                error: `Unknown step type: ${step.type}`,
+            };
+    }
+}
+async function executeCapabilityStep(step, ctx, state, deps) {
+    try {
+        const result = await deps.executeCapability(step.name, ctx, state);
+        if (result.success) {
+            return { status: StepStatus.Completed };
+        }
+        return {
+            status: StepStatus.Failed,
+            error: typeof result.error === 'object' && result.error !== null
+                ? JSON.stringify(result.error)
+                : String(result.error),
+        };
+    }
+    catch (err) {
+        return {
+            status: StepStatus.Failed,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+function executeConditionalStep(step, state, deps) {
+    try {
+        const conditionMet = deps.evaluateCondition(step.if, state);
+        return Promise.resolve({
+            status: StepStatus.Completed,
+            nextStep: conditionMet ? step.then : step.else,
+        });
+    }
+    catch (err) {
+        return Promise.resolve({
+            status: StepStatus.Failed,
+            error: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+function executeWaitStep(step) {
+    // Wait steps pause the flow — the engine will set status to "waiting"
+    // and resume when the specified event arrives.
+    return Promise.resolve({
+        status: StepStatus.Completed,
+        waitEvent: step.event,
+    });
+}
+function executeDelayStep(step) {
+    // Delay steps schedule the next step after a duration.
+    return Promise.resolve({
+        status: StepStatus.Completed,
+        delayDuration: step.duration,
+    });
+}
+function executeParallelStep(step) {
+    // Parallel steps enqueue multiple branches concurrently.
+    return Promise.resolve({
+        status: StepStatus.Completed,
+        parallelBranches: step.branches,
+    });
+}
+async function executeEventEmitStep(step, ctx, state) {
+    try {
+        await ctx.events.emit(step.event, state);
+        return { status: StepStatus.Completed };
+    }
+    catch (err) {
+        return {
+            status: StepStatus.Failed,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Build a StepHistoryEntry for audit/persistence.
+ */
+export function buildHistoryEntry(stepName, result, startedAt, completedAt) {
+    return {
+        step: stepName,
+        status: result.status,
+        startedAt: startedAt.toISOString(),
+        completedAt: completedAt.toISOString(),
+        error: result.error,
+    };
+}
+//# sourceMappingURL=step-executor.js.map

package/dist/flows/step-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-executor.js","sourceRoot":"","sources":["../../src/flows/step-executor.ts"],"names":[],"mappings":"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"}

package/dist/flows/triggers.d.ts

@@ -0,0 +1,15 @@
+import type { EventEnvelope } from '../types/event.js';
+import type { createFlowEngine } from './engine.js';
+import type { FlowRegistry } from './registry.js';
+/**
+ * Creates event-to-flow trigger integration.
+ * When an event arrives, checks if any registered flows have a matching trigger
+ * and starts new flow executions with the event payload as input.
+ */
+export declare function createFlowTriggerHandler(config: {
+    registry: FlowRegistry;
+    engine: ReturnType<typeof createFlowEngine>;
+}): {
+    handleEvent: (envelope: EventEnvelope) => Promise<number>;
+};
+//# sourceMappingURL=triggers.d.ts.map

package/dist/flows/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../../src/flows/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;CAC7C;4BAOsC,aAAa,KAAG,OAAO,CAAC,MAAM,CAAC;EA0BrE"}

package/dist/flows/triggers.js

@@ -0,0 +1,36 @@
+/**
+ * Creates event-to-flow trigger integration.
+ * When an event arrives, checks if any registered flows have a matching trigger
+ * and starts new flow executions with the event payload as input.
+ */
+export function createFlowTriggerHandler(config) {
+    const { registry, engine } = config;
+    /**
+     * Process an incoming event and start any triggered flows.
+     * Returns the number of flows started.
+     */
+    async function handleEvent(envelope) {
+        const matchingFlows = registry.getByTriggerEvent(envelope.eventType);
+        if (matchingFlows.length === 0)
+            return 0;
+        const auth = {
+            userId: envelope.actor,
+            tenantId: envelope.tenantId,
+            roles: [],
+            scopes: [],
+            provider: 'event-trigger',
+        };
+        let started = 0;
+        for (const flow of matchingFlows) {
+            await engine.start(flow.name, envelope.payload, auth, {
+                correlationId: envelope.correlationId,
+                triggerEventId: envelope.id,
+            });
+            started++;
+        }
+        const resumed = await engine.resumeWaitingByEvent(envelope.eventType, envelope.payload);
+        return started + resumed;
+    }
+    return { handleEvent };
+}
+//# sourceMappingURL=triggers.js.map

package/dist/flows/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../../src/flows/triggers.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAGxC;IACC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEpC;;;OAGG;IACH,KAAK,UAAU,WAAW,CAAC,QAAuB;QAChD,MAAM,aAAa,GAAG,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAEzC,MAAM,IAAI,GAAgB;YACxB,MAAM,EAAE,QAAQ,CAAC,KAAK;YACtB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,eAAe;SAC1B,CAAC;QAEF,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE;gBACpD,aAAa,EAAE,QAAQ,CAAC,aAAa;gBACrC,cAAc,EAAE,QAAQ,CAAC,EAAE;aAC5B,CAAC,CAAC;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxF,OAAO,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC"}

package/dist/governance/__tests__/overrides.test.d.ts

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

package/dist/governance/__tests__/overrides.test.d.ts.map

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

package/dist/governance/__tests__/overrides.test.js

@@ -0,0 +1,123 @@
+import { describe, expect, it } from 'vitest';
+import { GovernanceSeverity } from '../../types/enums.js';
+import { applyOverrides, createOverrideStore } from '../overrides.js';
+describe('OverrideStore', () => {
+    it('creates an empty store', () => {
+        const store = createOverrideStore();
+        expect(store.getOverrides()).toHaveLength(0);
+    });
+    it('loads entries from constructor', () => {
+        const store = createOverrideStore([
+            { rule: 'test', justification: 'ok', author: 'dev', timestamp: new Date().toISOString() },
+        ]);
+        expect(store.getOverrides()).toHaveLength(1);
+    });
+    it('adds overrides', () => {
+        const store = createOverrideStore();
+        store.addOverride({
+            rule: 'my-rule',
+            justification: 'needed',
+            author: 'dev',
+            timestamp: new Date().toISOString(),
+        });
+        expect(store.getOverrides()).toHaveLength(1);
+        expect(store.hasOverride('my-rule')).toBe(true);
+    });
+    it('removes overrides', () => {
+        const store = createOverrideStore([
+            { rule: 'test', justification: 'ok', author: 'dev', timestamp: new Date().toISOString() },
+        ]);
+        expect(store.removeOverride('test')).toBe(true);
+        expect(store.getOverrides()).toHaveLength(0);
+    });
+    it('returns false when removing non-existent override', () => {
+        const store = createOverrideStore();
+        expect(store.removeOverride('nothing')).toBe(false);
+    });
+    it('filters expired overrides from getOverrides()', () => {
+        const past = new Date(Date.now() - 60_000).toISOString();
+        const store = createOverrideStore([
+            { rule: 'expired', justification: 'old', author: 'dev', timestamp: past, expiresAt: past },
+        ]);
+        expect(store.getOverrides()).toHaveLength(0);
+    });
+    it('returns expired overrides via getExpired()', () => {
+        const past = new Date(Date.now() - 60_000).toISOString();
+        const store = createOverrideStore([
+            { rule: 'expired', justification: 'old', author: 'dev', timestamp: past, expiresAt: past },
+        ]);
+        expect(store.getExpired()).toHaveLength(1);
+    });
+    it('includes non-expired overrides', () => {
+        const future = new Date(Date.now() + 86_400_000).toISOString();
+        const store = createOverrideStore([
+            {
+                rule: 'valid',
+                justification: 'ok',
+                author: 'dev',
+                timestamp: new Date().toISOString(),
+                expiresAt: future,
+            },
+        ]);
+        expect(store.getOverrides()).toHaveLength(1);
+        expect(store.getExpired()).toHaveLength(0);
+    });
+    it('serializes back to entries', () => {
+        const store = createOverrideStore([
+            { rule: 'test', justification: 'ok', author: 'dev', timestamp: '2024-01-01T00:00:00.000Z' },
+        ]);
+        const serialized = store.serialize();
+        expect(serialized).toHaveLength(1);
+        expect(serialized[0]?.rule).toBe('test');
+        expect(serialized[0]?.timestamp).toBe('2024-01-01T00:00:00.000Z');
+    });
+    it('hasOverride checks scope', () => {
+        const store = createOverrideStore([
+            {
+                rule: 'test',
+                justification: 'ok',
+                author: 'dev',
+                timestamp: new Date().toISOString(),
+                scope: 'entity:User',
+            },
+        ]);
+        expect(store.hasOverride('test', 'entity:User')).toBe(true);
+        expect(store.hasOverride('test')).toBe(true); // no scope = matches unscoped
+        expect(store.hasOverride('test', 'entity:Order')).toBe(false);
+    });
+});
+describe('applyOverrides', () => {
+    const signals = [
+        { severity: GovernanceSeverity.High, rule: 'rule-a', description: 'A', affectedComponent: 'x' },
+        {
+            severity: GovernanceSeverity.Warning,
+            rule: 'rule-b',
+            description: 'B',
+            affectedComponent: 'y',
+        },
+        { severity: GovernanceSeverity.Info, rule: 'rule-c', description: 'C', affectedComponent: 'z' },
+    ];
+    it('returns all signals as effective with no overrides', () => {
+        const { effective, overridden } = applyOverrides(signals, []);
+        expect(effective).toHaveLength(3);
+        expect(overridden).toHaveLength(0);
+    });
+    it('moves overridden signals out of effective', () => {
+        const { effective, overridden } = applyOverrides(signals, [
+            { rule: 'rule-a', justification: 'ok', author: 'dev', timestamp: new Date() },
+        ]);
+        expect(effective).toHaveLength(2);
+        expect(overridden).toHaveLength(1);
+        expect(overridden[0]?.rule).toBe('rule-a');
+    });
+    it('handles multiple overrides', () => {
+        const { effective, overridden } = applyOverrides(signals, [
+            { rule: 'rule-a', justification: 'ok', author: 'dev', timestamp: new Date() },
+            { rule: 'rule-c', justification: 'ok', author: 'dev', timestamp: new Date() },
+        ]);
+        expect(effective).toHaveLength(1);
+        expect(overridden).toHaveLength(2);
+        expect(effective[0]?.rule).toBe('rule-b');
+    });
+});
+//# sourceMappingURL=overrides.test.js.map

package/dist/governance/__tests__/overrides.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides.test.js","sourceRoot":"","sources":["../../../src/governance/__tests__/overrides.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAChC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;SAC1F,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gBAAgB,EAAE,GAAG,EAAE;QACxB,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACpC,KAAK,CAAC,WAAW,CAAC;YAChB,IAAI,EAAE,SAAS;YACf,aAAa,EAAE,QAAQ;YACvB,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC3B,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAChC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;SAC1F,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,KAAK,GAAG,mBAAmB,EAAE,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAChC,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;SAC3F,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAChC,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;SAC3F,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/D,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAChC;gBACE,IAAI,EAAE,OAAO;gBACb,aAAa,EAAE,IAAI;gBACnB,MAAM,EAAE,KAAK;gBACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,SAAS,EAAE,MAAM;aAClB;SACF,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAChC,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,0BAA0B,EAAE;SAC5F,CAAC,CAAC;QACH,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;QACrC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,KAAK,GAAG,mBAAmB,CAAC;YAChC;gBACE,IAAI,EAAE,MAAM;gBACZ,aAAa,EAAE,IAAI;gBACnB,MAAM,EAAE,KAAK;gBACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,KAAK,EAAE,aAAa;aACrB;SACF,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,8BAA8B;QAC5E,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,MAAM,OAAO,GAAuB;QAClC,EAAE,QAAQ,EAAE,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE;QAC/F;YACE,QAAQ,EAAE,kBAAkB,CAAC,OAAO;YACpC,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,GAAG;YAChB,iBAAiB,EAAE,GAAG;SACvB;QACD,EAAE,QAAQ,EAAE,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE;KAChG,CAAC;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE;YACxD,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE;SAC9E,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE;YACxD,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE;YAC7E,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE;SAC9E,CAAC,CAAC;QACH,MAAM,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,CAAC,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/governance/__tests__/policies.test.d.ts

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

package/dist/governance/__tests__/policies.test.d.ts.map

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