@principles/core 1.73.0

package/dist/runtime-v2/store/lifecycle/recovery-sweep.test.js

@@ -0,0 +1,318 @@
+/**
+ * DefaultRecoverySweep integration tests.
+ *
+ * Uses an in-memory SQLite tmpdir for isolation.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { SqliteConnection } from '../sqlite-connection.js';
+import { SqliteTaskStore } from '../task/sqlite-task-store.js';
+import { DefaultLeaseManager } from './lease-manager.js';
+import { DefaultRetryPolicy } from './retry-policy.js';
+import { DefaultRecoverySweep } from './recovery-sweep.js';
+function makeTaskInput(taskId, overrides = {}) {
+    return {
+        taskId,
+        taskKind: 'diagnostician',
+        status: 'pending',
+        attemptCount: 0,
+        maxAttempts: 3,
+        ...overrides,
+    };
+}
+describe('DefaultRecoverySweep', () => {
+    const tmpDir = path.join(os.tmpdir(), `pd-test-${process.pid}-${Date.now()}`);
+    /* eslint-disable @typescript-eslint/init-declarations */
+    let conn;
+    let taskStore;
+    let leaseManager;
+    let retryPolicy;
+    let recoverySweep;
+    /* eslint-enable @typescript-eslint/init-declarations */
+    beforeEach(() => {
+        const testDir = path.join(tmpDir, `test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        fs.mkdirSync(testDir, { recursive: true });
+        conn = new SqliteConnection(testDir);
+        taskStore = new SqliteTaskStore(conn);
+        // LeaseManager needs a runStore; we pass a minimal mock
+        const runStore = {
+            createRun: async () => { throw new Error('not implemented'); },
+            getRun: async () => null,
+            updateRun: async () => { throw new Error('not implemented'); },
+            listRunsByTask: async () => [],
+            deleteRun: async () => false,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        };
+        leaseManager = new DefaultLeaseManager(taskStore, runStore, conn);
+        retryPolicy = new DefaultRetryPolicy({
+            baseDelayMs: 30_000,
+            maxDelayMs: 60_000,
+            multiplier: 2,
+        });
+        recoverySweep = new DefaultRecoverySweep(taskStore, leaseManager, retryPolicy, conn);
+    });
+    afterEach(() => {
+        conn.close();
+        try {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+        catch {
+            // ignore cleanup errors on Windows
+        }
+    });
+    describe('detectExpiredLeases', () => {
+        it('returns empty when no tasks exist', async () => {
+            const result = await recoverySweep.detectExpiredLeases();
+            expect(result).toEqual([]);
+        });
+        it('returns empty when no expired leases', async () => {
+            await taskStore.createTask(makeTaskInput('no-expire'));
+            const result = await recoverySweep.detectExpiredLeases();
+            expect(result).toEqual([]);
+        });
+        it('returns empty for active lease (future expiry)', async () => {
+            await taskStore.createTask(makeTaskInput('active-lease', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() + 60_000).toISOString(),
+            }));
+            const result = await recoverySweep.detectExpiredLeases();
+            expect(result).toEqual([]);
+        });
+        it('detects expired lease', async () => {
+            await taskStore.createTask(makeTaskInput('expired-task'));
+            await taskStore.updateTask('expired-task', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+            });
+            const result = await recoverySweep.detectExpiredLeases();
+            expect(result).toContain('expired-task');
+        });
+        it('does not detect non-leased tasks as expired', async () => {
+            await taskStore.createTask(makeTaskInput('pending-task', { status: 'pending' }));
+            await taskStore.createTask(makeTaskInput('failed-task', { status: 'failed' }));
+            const result = await recoverySweep.detectExpiredLeases();
+            expect(result).not.toContain('pending-task');
+            expect(result).not.toContain('failed-task');
+        });
+    });
+    describe('recoverTask', () => {
+        it('returns null for non-existent task', async () => {
+            const result = await recoverySweep.recoverTask('non-existent');
+            expect(result).toBeNull();
+        });
+        it('returns null for non-leased task', async () => {
+            await taskStore.createTask(makeTaskInput('not-leased'));
+            const result = await recoverySweep.recoverTask('not-leased');
+            expect(result).toBeNull();
+        });
+        it('returns null for non-expired lease', async () => {
+            await taskStore.createTask(makeTaskInput('not-expired', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() + 60_000).toISOString(),
+            }));
+            const result = await recoverySweep.recoverTask('not-expired');
+            expect(result).toBeNull();
+        });
+        it('recovers expired lease to retry_wait when attempts remain', async () => {
+            await taskStore.createTask(makeTaskInput('retry-task', { attemptCount: 1, maxAttempts: 3 }));
+            await taskStore.updateTask('retry-task', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+            });
+            const result = await recoverySweep.recoverTask('retry-task');
+            expect(result).not.toBeNull();
+            if (!result)
+                return;
+            expect(result.newStatus).toBe('retry_wait');
+            expect(result.wasLeaseExpired).toBe(true);
+            const updated = await taskStore.getTask('retry-task');
+            if (!updated)
+                return;
+            expect(updated.status).toBe('retry_wait');
+        });
+        it('recovers to failed when maxAttempts exceeded', async () => {
+            await taskStore.createTask(makeTaskInput('fail-task', { attemptCount: 3, maxAttempts: 3 }));
+            await taskStore.updateTask('fail-task', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+            });
+            const result = await recoverySweep.recoverTask('fail-task');
+            expect(result).not.toBeNull();
+            if (!result)
+                return;
+            expect(result.newStatus).toBe('failed');
+            expect(result.wasLeaseExpired).toBe(true);
+        });
+        it('clears leaseOwner and sets retry_wait expiry on recovery', async () => {
+            await taskStore.createTask(makeTaskInput('clear-lease-task', { attemptCount: 1, maxAttempts: 3 }));
+            await taskStore.updateTask('clear-lease-task', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+            });
+            await recoverySweep.recoverTask('clear-lease-task');
+            const updated = await taskStore.getTask('clear-lease-task');
+            if (!updated)
+                return;
+            expect(updated.leaseOwner).toBeUndefined();
+            expect(updated.leaseExpiresAt).toBeTruthy();
+            expect(updated.status).toBe('retry_wait');
+        });
+    });
+    describe('recoverAll', () => {
+        it('recovers all expired tasks', async () => {
+            await taskStore.createTask(makeTaskInput('multi-expire-1'));
+            await taskStore.updateTask('multi-expire-1', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+            });
+            await taskStore.createTask(makeTaskInput('multi-expire-2'));
+            await taskStore.updateTask('multi-expire-2', {
+                status: 'leased',
+                leaseOwner: 'agent-2',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+            });
+            const { recovered, errors } = await recoverySweep.recoverAll();
+            expect(recovered).toBe(2);
+            expect(errors).toEqual([]);
+        });
+        it('handles mixed expired and non-expired tasks', async () => {
+            await taskStore.createTask(makeTaskInput('mixed-expired'));
+            await taskStore.updateTask('mixed-expired', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+            });
+            await taskStore.createTask(makeTaskInput('mixed-active'));
+            await taskStore.updateTask('mixed-active', {
+                status: 'leased',
+                leaseOwner: 'agent-2',
+                leaseExpiresAt: new Date(Date.now() + 60_000).toISOString(),
+            });
+            const { recovered, errors } = await recoverySweep.recoverAll();
+            expect(recovered).toBe(1);
+            expect(errors).toEqual([]);
+        });
+        it('is idempotent', async () => {
+            await taskStore.createTask(makeTaskInput('idempotent-task'));
+            await taskStore.updateTask('idempotent-task', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+            });
+            const first = await recoverySweep.recoverAll();
+            const second = await recoverySweep.recoverAll();
+            expect(first.recovered).toBe(1);
+            expect(second.recovered).toBe(0);
+        });
+    });
+    describe('dirty workspace handling', () => {
+        it('stalled attempt leaves dirty workspace -> no automatic retry is scheduled', async () => {
+            // Simulate a task that stalled with dirty workspace (lastError = workspace_dirty)
+            await taskStore.createTask(makeTaskInput('dirty-stalled-task', {
+                attemptCount: 1,
+                maxAttempts: 3,
+                lastError: 'workspace_dirty',
+            }));
+            await taskStore.updateTask('dirty-stalled-task', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+                diagnosticJson: JSON.stringify({
+                    workspaceDir: 'D:/code/test-workspace',
+                    dirtyFiles: [
+                        'packages/pd-cli/src/commands/runtime-canary.ts',
+                        'packages/pd-cli/tests/commands/runtime-canary.test.ts',
+                    ],
+                }),
+            });
+            // Recovery should NOT schedule a retry — task should go to needs_human_review
+            const result = await recoverySweep.recoverTask('dirty-stalled-task');
+            expect(result).not.toBeNull();
+            if (!result)
+                return;
+            expect(result.newStatus).toBe('needs_human_review');
+            expect(result.wasLeaseExpired).toBe(true);
+            const updated = await taskStore.getTask('dirty-stalled-task');
+            if (!updated)
+                return;
+            expect(updated.status).toBe('needs_human_review');
+            expect(updated.leaseOwner).toBeUndefined();
+            expect(updated.leaseExpiresAt).toBeUndefined();
+        });
+        it('clean stalled attempt (no workspace_dirty) -> follows existing retry behavior', async () => {
+            // A task that stalled without a dirty workspace should still go to retry_wait
+            await taskStore.createTask(makeTaskInput('clean-stalled-task', {
+                attemptCount: 1,
+                maxAttempts: 3,
+                lastError: 'timeout',
+            }));
+            await taskStore.updateTask('clean-stalled-task', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+                diagnosticJson: JSON.stringify({ workspaceDir: 'D:/code/test-workspace' }),
+            });
+            const result = await recoverySweep.recoverTask('clean-stalled-task');
+            expect(result).not.toBeNull();
+            if (!result)
+                return;
+            expect(result.newStatus).toBe('retry_wait');
+            const updated = await taskStore.getTask('clean-stalled-task');
+            if (!updated)
+                return;
+            expect(updated.status).toBe('retry_wait');
+        });
+        it('dirty workspace with maxAttempts exceeded -> goes to failed not retry_wait', async () => {
+            await taskStore.createTask(makeTaskInput('dirty-max-task', {
+                attemptCount: 3,
+                maxAttempts: 3,
+                lastError: 'workspace_dirty',
+            }));
+            await taskStore.updateTask('dirty-max-task', {
+                status: 'leased',
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+                diagnosticJson: JSON.stringify({
+                    workspaceDir: 'D:/code/test-workspace',
+                    dirtyFiles: ['some/file.ts'],
+                }),
+            });
+            const result = await recoverySweep.recoverTask('dirty-max-task');
+            expect(result).not.toBeNull();
+            if (!result)
+                return;
+            expect(result.newStatus).toBe('failed');
+        });
+        it('needs_human_review task is not recovered by recoverAll (idempotent)', async () => {
+            // A task already in needs_human_review should not be touched
+            await taskStore.createTask(makeTaskInput('already-review-task', {
+                attemptCount: 2,
+                maxAttempts: 3,
+                status: 'needs_human_review',
+                lastError: 'workspace_dirty',
+            }));
+            await taskStore.updateTask('already-review-task', {
+                leaseOwner: 'agent-1',
+                leaseExpiresAt: new Date(Date.now() - 1000).toISOString(),
+            });
+            const result = await recoverySweep.recoverTask('already-review-task');
+            // Non-leased or non-expired tasks return null
+            expect(result).toBeNull();
+            // Task should remain in needs_human_review
+            const updated = await taskStore.getTask('already-review-task');
+            if (!updated)
+                return;
+            expect(updated.status).toBe('needs_human_review');
+        });
+    });
+});
+//# sourceMappingURL=recovery-sweep.test.js.map

package/dist/runtime-v2/store/lifecycle/recovery-sweep.test.js.map

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

package/dist/runtime-v2/store/lifecycle/retry-policy.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Retry Policy — exponential backoff with jitter and maxAttempts enforcement.
+ *
+ * Provides:
+ *   - calculateBackoff: compute delay for a given attempt number
+ *   - shouldRetry: check if a task has attempts remaining
+ *   - markRetryWait: transition a task to retry_wait (caller applies via TaskStore)
+ *   - markFailed: transition a task to failed (caller applies via TaskStore)
+ *
+ * The actual task state transitions (markRetryWait, markFailed) are applied by the
+ * caller via TaskStore — RetryPolicy provides the calculation logic only.
+ *
+ * Source: PD Runtime Protocol SPEC v1, Section 19 (Error categories and retry)
+ * Source: Diagnostician v2 Detailed Design, Section 20 (Retry and backoff)
+ */
+import type { TaskRecord } from '../../task-status.js';
+import type { PDErrorCategory } from '../../error-categories.js';
+export interface RetryPolicyConfig {
+    /** Initial base delay in ms (default: 30_000 = 30 seconds) */
+    baseDelayMs?: number;
+    /** Maximum delay cap in ms (default: 60_000 = 60 seconds) */
+    maxDelayMs?: number;
+    /** Exponential multiplier (default: 2) */
+    multiplier?: number;
+    /** Jitter factor (default: 0.2 = +/- 10% of delay) */
+    jitterFactor?: number;
+}
+export interface RetryPolicy {
+    /**
+     * Calculate backoff delay for a given attempt number.
+     *
+     * Formula: cap(min(baseDelay * multiplier^(attempt-1), maxDelay), jitter)
+     *   where jitter = +/- (jitterFactor / 2) * cappedDelay
+     *
+     * @param attemptNumber - 1-based attempt number
+     * @returns Delay in milliseconds
+     */
+    calculateBackoff(attemptNumber: number): number;
+    /**
+     * Check whether a task should be retried based on attempt count vs maxAttempts.
+     *
+     * @param task - The task record to evaluate
+     * @returns true if attemptCount < maxAttempts, false otherwise
+     */
+    shouldRetry(task: TaskRecord): boolean;
+    /**
+     * Mark a task as waiting for retry (transition to retry_wait state).
+     *
+     * The caller is responsible for actually updating the task via TaskStore.
+     * This method returns the error category for the caller to use.
+     *
+     * @param taskId - The task to mark
+     * @param errorCategory - The error category that triggered the retry
+     * @returns The taskId and errorCategory for the caller to apply
+     */
+    markRetryWait(taskId: string, errorCategory: PDErrorCategory): Promise<{
+        taskId: string;
+        errorCategory: PDErrorCategory;
+    }>;
+    /**
+     * Mark a task as permanently failed (transition to failed state).
+     *
+     * The caller is responsible for actually updating the task via TaskStore.
+     * This method returns the error category for the caller to use.
+     *
+     * @param taskId - The task to mark
+     * @param errorCategory - The error category that caused the failure
+     * @returns The taskId and errorCategory for the caller to apply
+     */
+    markFailed(taskId: string, errorCategory: PDErrorCategory): Promise<{
+        taskId: string;
+        errorCategory: PDErrorCategory;
+    }>;
+}
+export declare class DefaultRetryPolicy implements RetryPolicy {
+    private readonly baseDelayMs;
+    private readonly maxDelayMs;
+    private readonly multiplier;
+    private readonly jitterFactor;
+    constructor(config?: RetryPolicyConfig);
+    /**
+     * Exponential backoff with jitter.
+     *
+     * Examples with defaults (base=30s, max=60s, multiplier=2, jitter=0.2):
+     *   attempt 1: raw=30000, capped=30000, jitter=3000 → 28500-31500 ms
+     *   attempt 2: raw=60000, capped=60000, jitter=6000 → 54000-66000 ms
+     *   attempt 3: raw=120000, capped=60000, jitter=6000 → 54000-66000 ms (capped)
+     */
+    calculateBackoff(attemptNumber: number): number;
+    /**
+     * Returns true if the task has attempts remaining.
+     *
+     * Fails safe: if maxAttempts is not set or is invalid, defaults to allowing retry.
+     */
+    shouldRetry(task: TaskRecord): boolean;
+    markRetryWait(taskId: string, errorCategory: PDErrorCategory): Promise<{
+        taskId: string;
+        errorCategory: PDErrorCategory;
+    }>;
+    markFailed(taskId: string, errorCategory: PDErrorCategory): Promise<{
+        taskId: string;
+        errorCategory: PDErrorCategory;
+    }>;
+}
+//# sourceMappingURL=retry-policy.d.ts.map

package/dist/runtime-v2/store/lifecycle/retry-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/lifecycle/retry-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAIjE,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,WAAW;IAC1B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhD;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAEvC;;;;;;;;;OASG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;IAE3H;;;;;;;;;OASG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;CACzH;AAID,qBAAa,kBAAmB,YAAW,WAAW;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,MAAM,GAAE,iBAAsB;IAO1C;;;;;;;OAOG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAO/C;;;;OAIG;IAEH,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAOhC,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,eAAe,GAC7B,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,eAAe,CAAA;KAAE,CAAC;IAKxD,UAAU,CACd,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,eAAe,GAC7B,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,eAAe,CAAA;KAAE,CAAC;CAG/D"}

package/dist/runtime-v2/store/lifecycle/retry-policy.js

@@ -0,0 +1,48 @@
+// ── DefaultRetryPolicy implementation ───────────────────────────────────────
+export class DefaultRetryPolicy {
+    baseDelayMs;
+    maxDelayMs;
+    multiplier;
+    jitterFactor;
+    constructor(config = {}) {
+        this.baseDelayMs = config.baseDelayMs ?? 30_000;
+        this.maxDelayMs = config.maxDelayMs ?? 60_000;
+        this.multiplier = config.multiplier ?? 2;
+        this.jitterFactor = config.jitterFactor ?? 0.2;
+    }
+    /**
+     * Exponential backoff with jitter.
+     *
+     * Examples with defaults (base=30s, max=60s, multiplier=2, jitter=0.2):
+     *   attempt 1: raw=30000, capped=30000, jitter=3000 → 28500-31500 ms
+     *   attempt 2: raw=60000, capped=60000, jitter=6000 → 54000-66000 ms
+     *   attempt 3: raw=120000, capped=60000, jitter=6000 → 54000-66000 ms (capped)
+     */
+    calculateBackoff(attemptNumber) {
+        const rawDelay = this.baseDelayMs * Math.pow(this.multiplier, attemptNumber - 1);
+        const cappedDelay = Math.min(rawDelay, this.maxDelayMs);
+        const jitter = cappedDelay * this.jitterFactor;
+        return Math.floor(cappedDelay - jitter / 2 + Math.random() * jitter);
+    }
+    /**
+     * Returns true if the task has attempts remaining.
+     *
+     * Fails safe: if maxAttempts is not set or is invalid, defaults to allowing retry.
+     */
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    shouldRetry(task) {
+        const max = task.maxAttempts;
+        if (typeof max !== 'number' || !Number.isFinite(max) || max <= 0)
+            return true; // fail-safe: allow retry
+        return task.attemptCount < max;
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    async markRetryWait(taskId, errorCategory) {
+        return { taskId, errorCategory };
+    }
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    async markFailed(taskId, errorCategory) {
+        return { taskId, errorCategory };
+    }
+}
+//# sourceMappingURL=retry-policy.js.map

package/dist/runtime-v2/store/lifecycle/retry-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-policy.js","sourceRoot":"","sources":["../../../../src/runtime-v2/store/lifecycle/retry-policy.ts"],"names":[],"mappings":"AA8EA,+EAA+E;AAE/E,MAAM,OAAO,kBAAkB;IACZ,WAAW,CAAS;IACpB,UAAU,CAAS;IACnB,UAAU,CAAS;IACnB,YAAY,CAAS;IAEtC,YAAY,SAA4B,EAAE;QACxC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC;QAChD,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC;IACjD,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,aAAqB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC;QACjF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACH,qEAAqE;IACrE,WAAW,CAAC,IAAgB;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC;QAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,yBAAyB;QACxG,OAAO,IAAI,CAAC,YAAY,GAAG,GAAG,CAAC;IACjC,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,aAAa,CACjB,MAAc,EACd,aAA8B;QAE9B,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACnC,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,UAAU,CACd,MAAc,EACd,aAA8B;QAE9B,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACnC,CAAC;CACF"}

package/dist/runtime-v2/store/lifecycle/retry-policy.test.d.ts

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

package/dist/runtime-v2/store/lifecycle/retry-policy.test.d.ts.map

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

package/dist/runtime-v2/store/lifecycle/retry-policy.test.js

@@ -0,0 +1,86 @@
+/**
+ * DefaultRetryPolicy unit tests.
+ *
+ * Pure unit tests — no I/O, no database.
+ */
+import { describe, it, expect } from 'vitest';
+import { DefaultRetryPolicy } from './retry-policy.js';
+describe('DefaultRetryPolicy', () => {
+    const policy = new DefaultRetryPolicy({
+        baseDelayMs: 30_000,
+        maxDelayMs: 60_000,
+        multiplier: 2,
+        jitterFactor: 0.2,
+    });
+    describe('calculateBackoff', () => {
+        it('returns base delay for first attempt', () => {
+            const delay = policy.calculateBackoff(1);
+            // With jitter of 0.2, range is 0.9x to 1.1x of 30000
+            expect(delay).toBeGreaterThanOrEqual(27_000);
+            expect(delay).toBeLessThanOrEqual(33_000);
+        });
+        it('doubles for second attempt', () => {
+            const delay1 = policy.calculateBackoff(1);
+            const delay2 = policy.calculateBackoff(2);
+            expect(delay2).toBeGreaterThan(delay1);
+        });
+        it('caps at maxDelayMs', () => {
+            const delay = policy.calculateBackoff(10);
+            expect(delay).toBeLessThanOrEqual(66_000); // maxDelay + jitter
+        });
+        it('returns consistent-ish values (deterministic within jitter)', () => {
+            // Multiple calls should all be within the jitter range
+            for (let i = 0; i < 5; i++) {
+                const delay = policy.calculateBackoff(1);
+                expect(delay).toBeGreaterThanOrEqual(27_000);
+                expect(delay).toBeLessThanOrEqual(33_000);
+            }
+        });
+    });
+    describe('shouldRetry', () => {
+        function makeTask(attemptCount, maxAttempts) {
+            return {
+                taskId: 'test-task',
+                taskKind: 'diagnostician',
+                status: 'retry_wait',
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                attemptCount,
+                maxAttempts,
+            };
+        }
+        it('returns true when attempts remain', () => {
+            expect(policy.shouldRetry(makeTask(1, 3))).toBe(true);
+            expect(policy.shouldRetry(makeTask(2, 3))).toBe(true);
+        });
+        it('returns false when maxAttempts reached', () => {
+            expect(policy.shouldRetry(makeTask(3, 3))).toBe(false);
+            expect(policy.shouldRetry(makeTask(4, 3))).toBe(false);
+        });
+        it('fails safe when maxAttempts is invalid', () => {
+            expect(policy.shouldRetry({ ...makeTask(0, 0), maxAttempts: 0 })).toBe(true);
+            expect(policy.shouldRetry({ ...makeTask(0, -1), maxAttempts: -1 })).toBe(true);
+            // NaN is not a valid number, but shouldRetry safely returns true (allow retry)
+            // JavaScript: typeof NaN === 'number' is true, but NaN comparisons are all false
+            // so task.attemptCount < NaN is false... but our guard handles this
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const nanTask = { ...makeTask(0, 1), maxAttempts: NaN };
+            expect(policy.shouldRetry(nanTask)).toBe(true);
+        });
+    });
+    describe('markRetryWait', () => {
+        it('returns taskId and errorCategory', async () => {
+            const result = await policy.markRetryWait('task-1', 'lease_expired');
+            expect(result.taskId).toBe('task-1');
+            expect(result.errorCategory).toBe('lease_expired');
+        });
+    });
+    describe('markFailed', () => {
+        it('returns taskId and errorCategory', async () => {
+            const result = await policy.markFailed('task-2', 'max_attempts_exceeded');
+            expect(result.taskId).toBe('task-2');
+            expect(result.errorCategory).toBe('max_attempts_exceeded');
+        });
+    });
+});
+//# sourceMappingURL=retry-policy.test.js.map

package/dist/runtime-v2/store/lifecycle/retry-policy.test.js.map

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

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

@@ -0,0 +1,4 @@
+export type { RunRecord, RunStore } from './run-store.js';
+export { SqliteRunStore } from './sqlite-run-store.js';
+export { MemoryRunStore } from './memory-run-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime-v2/store/run/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/run/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/runtime-v2/store/run/index.js

@@ -0,0 +1,3 @@
+export { SqliteRunStore } from './sqlite-run-store.js';
+export { MemoryRunStore } from './memory-run-store.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime-v2/store/run/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime-v2/store/run/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/runtime-v2/store/run/memory-run-store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * RunStore — in-memory test double using a Map.
+ */
+import type { RunRecord, RunStore } from './run-store.js';
+export declare class MemoryRunStore implements RunStore {
+    private readonly runs;
+    createRun(record: Omit<RunRecord, 'createdAt' | 'updatedAt'>): Promise<RunRecord>;
+    listRunsByTask(taskId: string): Promise<RunRecord[]>;
+    getRun(runId: string): Promise<RunRecord | null>;
+    updateRun(runId: string, patch: Partial<Pick<RunRecord, 'endedAt' | 'reason' | 'outputRef' | 'outputPayload' | 'errorCategory' | 'executionStatus'>>): Promise<RunRecord>;
+    deleteRun(runId: string): Promise<boolean>;
+    insert(record: RunRecord): void;
+    clear(): void;
+}
+//# sourceMappingURL=memory-run-store.d.ts.map

package/dist/runtime-v2/store/run/memory-run-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-run-store.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/run/memory-run-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1D,qBAAa,cAAe,YAAW,QAAQ;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgC;IAE/C,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC;IAOjF,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAIpD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAIhD,SAAS,CACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,eAAe,GAAG,eAAe,GAAG,iBAAiB,CAAC,CAAC,GAC1H,OAAO,CAAC,SAAS,CAAC;IAQf,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAI/B,KAAK,IAAI,IAAI;CAGd"}