@quickstartsoft/ql-worker 0.0.260330090824-main.2d073ec

package/dist/llm/classifyError.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect } from 'vitest';
+import { classifyError } from './classifyError.js';
+describe('classifyError', () => {
+    describe('retryable errors', () => {
+        const retryableTags = [
+            'rate_limit',
+            'server_error',
+            'unknown',
+            'process_crash',
+            'timeout',
+            'error_during_execution',
+        ];
+        for (const tag of retryableTags) {
+            it(`classifies string "${tag}" as retryable`, () => {
+                expect(classifyError(tag)).toBe('retryable');
+            });
+            it(`classifies { subtype: "${tag}" } as retryable`, () => {
+                expect(classifyError({ subtype: tag })).toBe('retryable');
+            });
+            it(`classifies { error: "${tag}" } as retryable`, () => {
+                expect(classifyError({ error: tag })).toBe('retryable');
+            });
+        }
+    });
+    describe('non-retryable errors', () => {
+        const nonRetryableTags = [
+            'authentication_failed',
+            'billing_error',
+            'invalid_request',
+            'error_max_budget_usd',
+        ];
+        for (const tag of nonRetryableTags) {
+            it(`classifies string "${tag}" as non-retryable`, () => {
+                expect(classifyError(tag)).toBe('non-retryable');
+            });
+            it(`classifies { subtype: "${tag}" } as non-retryable`, () => {
+                expect(classifyError({ subtype: tag })).toBe('non-retryable');
+            });
+        }
+    });
+    describe('fallback behavior', () => {
+        it('classifies null as retryable', () => {
+            expect(classifyError(null)).toBe('retryable');
+        });
+        it('classifies undefined as retryable', () => {
+            expect(classifyError(undefined)).toBe('retryable');
+        });
+        it('classifies unknown string as retryable', () => {
+            expect(classifyError('something_weird')).toBe('retryable');
+        });
+        it('classifies an Error instance with retryable message', () => {
+            expect(classifyError(new Error('rate_limit'))).toBe('retryable');
+        });
+        it('classifies an Error instance with non-retryable message', () => {
+            expect(classifyError(new Error('billing_error'))).toBe('non-retryable');
+        });
+    });
+});
+//# sourceMappingURL=classifyError.test.js.map

package/dist/llm/classifyError.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifyError.test.js","sourceRoot":"","sources":["../../src/llm/classifyError.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,MAAM,aAAa,GAAG;YACpB,YAAY;YACZ,cAAc;YACd,SAAS;YACT,eAAe;YACf,SAAS;YACT,wBAAwB;SACzB,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,EAAE,CAAC,sBAAsB,GAAG,gBAAgB,EAAE,GAAG,EAAE;gBACjD,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,0BAA0B,GAAG,kBAAkB,EAAE,GAAG,EAAE;gBACvD,MAAM,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC5D,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,wBAAwB,GAAG,kBAAkB,EAAE,GAAG,EAAE;gBACrD,MAAM,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1D,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,MAAM,gBAAgB,GAAG;YACvB,uBAAuB;YACvB,eAAe;YACf,iBAAiB;YACjB,sBAAsB;SACvB,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;YACnC,EAAE,CAAC,sBAAsB,GAAG,oBAAoB,EAAE,GAAG,EAAE;gBACrD,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;YAEH,EAAE,CAAC,0BAA0B,GAAG,sBAAsB,EAAE,GAAG,EAAE;gBAC3D,MAAM,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAChE,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;YACjE,MAAM,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/llm/generatePhaseSummary.d.ts

@@ -0,0 +1,9 @@
+export interface AssistantMessage {
+    role: 'assistant';
+    content: Array<{
+        type: string;
+        text?: string;
+    }>;
+}
+export declare function generatePhaseSummary(assistantMessages: AssistantMessage[]): Promise<string>;
+//# sourceMappingURL=generatePhaseSummary.d.ts.map

package/dist/llm/generatePhaseSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generatePhaseSummary.d.ts","sourceRoot":"","sources":["../../src/llm/generatePhaseSummary.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACjD;AAED,wBAAsB,oBAAoB,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAajG"}

package/dist/llm/generatePhaseSummary.js

@@ -0,0 +1,47 @@
+import { query } from '@anthropic-ai/claude-agent-sdk';
+const FALLBACK = '(summary generation failed)';
+const EMPTY = '(no assistant output to summarize)';
+export async function generatePhaseSummary(assistantMessages) {
+    const texts = extractTexts(assistantMessages);
+    if (!texts.trim())
+        return EMPTY;
+    try {
+        const result = await runSummaryQuery(texts);
+        return result.subtype === 'success' && result.result.trim()
+            ? result.result.trim()
+            : FALLBACK;
+    }
+    catch {
+        return FALLBACK;
+    }
+}
+function extractTexts(messages) {
+    return messages
+        .flatMap((m) => m.content)
+        .filter((c) => c.type === 'text' && typeof c.text === 'string')
+        .map((c) => c.text)
+        .join('\n\n');
+}
+async function runSummaryQuery(texts) {
+    const q = query({
+        prompt: `Summarize the following work output in 1-2 sentences:\n\n${texts}`,
+        options: {
+            systemPrompt: 'You are a concise summarizer. Output 1-2 sentences only.',
+            model: 'claude-sonnet-4-6',
+            maxTurns: 1,
+            permissionMode: 'bypassPermissions',
+            allowDangerouslySkipPermissions: true,
+        },
+    });
+    let result;
+    for await (const message of q) {
+        if (message.type === 'result') {
+            result = message;
+        }
+    }
+    if (result === undefined) {
+        throw new Error('Summary query completed without a result message');
+    }
+    return result;
+}
+//# sourceMappingURL=generatePhaseSummary.js.map

package/dist/llm/generatePhaseSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generatePhaseSummary.js","sourceRoot":"","sources":["../../src/llm/generatePhaseSummary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAyB,MAAM,gCAAgC,CAAC;AAE9E,MAAM,QAAQ,GAAG,6BAA6B,CAAC;AAC/C,MAAM,KAAK,GAAG,oCAAoC,CAAC;AAOnD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,iBAAqC;IAC9E,MAAM,KAAK,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAE9C,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YACzD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YACtB,CAAC,CAAC,QAAQ,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,QAA4B;IAChD,OAAO,QAAQ;SACZ,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAuC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;SACnG,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,KAAa;IAC1C,MAAM,CAAC,GAAG,KAAK,CAAC;QACd,MAAM,EAAE,4DAA4D,KAAK,EAAE;QAC3E,OAAO,EAAE;YACP,YAAY,EAAE,0DAA0D;YACxE,KAAK,EAAE,mBAAmB;YAC1B,QAAQ,EAAE,CAAC;YACX,cAAc,EAAE,mBAAmB;YACnC,+BAA+B,EAAE,IAAI;SACtC;KACF,CAAC,CAAC;IAEH,IAAI,MAAoC,CAAC;IAEzC,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,CAAC,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,GAAG,OAA2B,CAAC;QACvC,CAAC;IACH,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/llm/getActivityHeartbeat.d.ts

@@ -0,0 +1,2 @@
+export declare function getActivityHeartbeat(): (() => void) | undefined;
+//# sourceMappingURL=getActivityHeartbeat.d.ts.map

package/dist/llm/getActivityHeartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getActivityHeartbeat.d.ts","sourceRoot":"","sources":["../../src/llm/getActivityHeartbeat.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAO/D"}

package/dist/llm/getActivityHeartbeat.js

@@ -0,0 +1,11 @@
+import { Context } from '@temporalio/activity';
+export function getActivityHeartbeat() {
+    try {
+        const ctx = Context.current();
+        return () => ctx.heartbeat();
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=getActivityHeartbeat.js.map

package/dist/llm/getActivityHeartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getActivityHeartbeat.js","sourceRoot":"","sources":["../../src/llm/getActivityHeartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAC9B,OAAO,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/llm/queryWithRetry.d.ts

@@ -0,0 +1,9 @@
+import { type SDKResultMessage } from '@anthropic-ai/claude-agent-sdk';
+export interface QueryWithRetryParams {
+    prompt: string;
+    systemPrompt: string;
+    cwd: string;
+    heartbeat?: () => void;
+}
+export declare function queryWithRetry(params: QueryWithRetryParams): Promise<SDKResultMessage>;
+//# sourceMappingURL=queryWithRetry.d.ts.map

package/dist/llm/queryWithRetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryWithRetry.d.ts","sourceRoot":"","sources":["../../src/llm/queryWithRetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAS/F,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyB5F"}

package/dist/llm/queryWithRetry.js

@@ -0,0 +1,72 @@
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { captureSessionId } from './captureSessionId.js';
+import { classifyError } from './classifyError.js';
+import { getActivityHeartbeat } from './getActivityHeartbeat.js';
+const RETRY_INTERVAL_MS = 5 * 60 * 1000;
+const MAX_RETRY_DURATION_MS = 5 * 60 * 60 * 1000;
+const HEARTBEAT_INTERVAL_MS = 60 * 1000;
+export async function queryWithRetry(params) {
+    const heartbeat = params.heartbeat ?? getActivityHeartbeat();
+    const startTime = Date.now();
+    let sessionId;
+    while (true) {
+        const { result, messages } = await executeQuery(params, sessionId);
+        sessionId ??= captureSessionId(messages);
+        if (result.subtype === 'success') {
+            return result;
+        }
+        const classification = classifyError(result);
+        if (classification === 'non-retryable') {
+            throw new Error(`Non-retryable error: ${result.subtype} - ${formatErrors(result)}`);
+        }
+        const elapsed = Date.now() - startTime;
+        if (elapsed + RETRY_INTERVAL_MS > MAX_RETRY_DURATION_MS) {
+            throw new Error(`Max retry duration exceeded after ${elapsed}ms: ${result.subtype}`);
+        }
+        await waitWithHeartbeat(RETRY_INTERVAL_MS, heartbeat);
+    }
+}
+async function executeQuery(params, sessionId) {
+    const messages = [];
+    let result;
+    const q = query({
+        prompt: params.prompt,
+        options: {
+            systemPrompt: params.systemPrompt,
+            model: 'claude-opus-4-6',
+            cwd: params.cwd,
+            permissionMode: 'bypassPermissions',
+            allowDangerouslySkipPermissions: true,
+            ...(sessionId !== undefined ? { resume: sessionId } : {}),
+        },
+    });
+    for await (const message of q) {
+        messages.push(message);
+        if (message.type === 'result') {
+            result = message;
+        }
+    }
+    if (result === undefined) {
+        throw new Error('Query completed without a result message');
+    }
+    return { result, messages };
+}
+function formatErrors(result) {
+    if ('errors' in result && result.errors.length > 0) {
+        return result.errors.join('; ');
+    }
+    return result.subtype;
+}
+async function waitWithHeartbeat(durationMs, heartbeat) {
+    let remaining = durationMs;
+    while (remaining > 0) {
+        const sleepTime = Math.min(HEARTBEAT_INTERVAL_MS, remaining);
+        await sleep(sleepTime);
+        remaining -= sleepTime;
+        heartbeat?.();
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => { setTimeout(resolve, ms); });
+}
+//# sourceMappingURL=queryWithRetry.js.map

package/dist/llm/queryWithRetry.js.map

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

package/dist/patterns/__tests__/adversarialValidationLoop.test.d.ts

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

package/dist/patterns/__tests__/adversarialValidationLoop.test.d.ts.map

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

package/dist/patterns/__tests__/adversarialValidationLoop.test.js

@@ -0,0 +1,65 @@
+import { describe, it, expect, vi } from 'vitest';
+import { WorkflowAbortError } from '@quickstartsoft/ql-shared-types';
+vi.mock('../../activities/userApprovalActivity.js', () => ({
+    userApprovalActivity: vi.fn(),
+}));
+import { adversarialValidationLoop } from '../adversarialValidationLoop.js';
+import { userApprovalActivity } from '../../activities/userApprovalActivity.js';
+const mockApproval = vi.mocked(userApprovalActivity);
+function makeConfig(overrides) {
+    return {
+        maxRetries: overrides.maxRetries ?? 3,
+        validate: overrides.validate ?? vi.fn(),
+        revise: overrides.revise ?? vi.fn(),
+        subjectLabel: 'test-subject',
+        currentStep: 'CW05.validate',
+    };
+}
+describe('adversarialValidationLoop', () => {
+    it('returns subject when validation passes on first attempt', async () => {
+        const validate = vi.fn()
+            .mockResolvedValue({ passed: true, reportPath: '/r.json' });
+        const revise = vi.fn();
+        const config = makeConfig({ validate, revise });
+        const result = await adversarialValidationLoop('initial', config);
+        expect(result).toBe('initial');
+        expect(validate).toHaveBeenCalledOnce();
+        expect(revise).not.toHaveBeenCalled();
+    });
+    it('retries and returns revised subject when later attempt passes', async () => {
+        const validate = vi.fn()
+            .mockResolvedValueOnce({ passed: false, reportPath: '/r1.json' })
+            .mockResolvedValueOnce({ passed: true, reportPath: '/r2.json' });
+        const revise = vi.fn()
+            .mockResolvedValue('revised');
+        const config = makeConfig({ maxRetries: 3, validate, revise });
+        const result = await adversarialValidationLoop('initial', config);
+        expect(result).toBe('revised');
+        expect(revise).toHaveBeenCalledOnce();
+    });
+    it('escalates to user when max retries exhausted, user continues', async () => {
+        const fail = { passed: false, reportPath: '/fail.json' };
+        const validate = vi.fn()
+            .mockResolvedValue(fail);
+        const revise = vi.fn()
+            .mockResolvedValue('last-revised');
+        mockApproval.mockResolvedValue({ decision: 'continue' });
+        const config = makeConfig({ maxRetries: 2, validate, revise });
+        const result = await adversarialValidationLoop('initial', config);
+        expect(result).toBe('last-revised');
+        expect(validate).toHaveBeenCalledTimes(2);
+        expect(mockApproval).toHaveBeenCalledOnce();
+    });
+    it('throws WorkflowAbortError when user aborts', async () => {
+        const fail = { passed: false, reportPath: '/fail.json' };
+        const validate = vi.fn()
+            .mockResolvedValue(fail);
+        const revise = vi.fn()
+            .mockResolvedValue('revised');
+        mockApproval.mockResolvedValue({ decision: 'abort' });
+        const config = makeConfig({ maxRetries: 1, validate, revise });
+        await expect(adversarialValidationLoop('initial', config))
+            .rejects.toThrow(WorkflowAbortError);
+    });
+});
+//# sourceMappingURL=adversarialValidationLoop.test.js.map

package/dist/patterns/__tests__/adversarialValidationLoop.test.js.map

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

package/dist/patterns/__tests__/standardActivityPattern.test.d.ts

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

package/dist/patterns/__tests__/standardActivityPattern.test.d.ts.map

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

package/dist/patterns/__tests__/standardActivityPattern.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect, vi } from 'vitest';
+const mockContextLoader = vi.fn();
+const mockGenerateSummary = vi.fn();
+vi.mock('../../activities/contextLoaderActivity.js', () => ({
+    contextLoaderActivity: (input) => mockContextLoader(input),
+}));
+vi.mock('../../llm/generatePhaseSummary.js', () => ({
+    generatePhaseSummary: (msgs) => mockGenerateSummary(msgs),
+}));
+import { standardActivityPattern } from '../standardActivityPattern.js';
+describe('standardActivityPattern', () => {
+    it('calls all five steps in order', async () => {
+        const callOrder = [];
+        const ctxPkg = { essential: ['/a.ts'], reference: [] };
+        mockContextLoader.mockImplementation(async () => {
+            callOrder.push('contextLoader');
+            return ctxPkg;
+        });
+        mockGenerateSummary.mockImplementation(async () => {
+            callOrder.push('phaseSummary');
+            return 'summary text';
+        });
+        const phaseStart = vi.fn(async () => { callOrder.push('phaseStart'); });
+        const phaseComplete = vi.fn(async () => { callOrder.push('phaseComplete'); });
+        const mainActivity = vi.fn(async () => {
+            callOrder.push('mainActivity');
+            return {
+                output: { data: 42 },
+                assistantMessages: [{ role: 'assistant', content: [{ type: 'text', text: 'hi' }] }],
+            };
+        });
+        const result = await standardActivityPattern({
+            workspacePath: '/ws',
+            cw: 'CW03',
+            name: 'generate-questions',
+            step: 'step-1',
+            scope: 'scope-a',
+            activityType: 'CW03.generate-questions',
+            mainActivity,
+            input: { foo: 'bar' },
+            phaseStart,
+            phaseComplete,
+        });
+        expect(callOrder).toEqual([
+            'phaseStart', 'contextLoader', 'mainActivity', 'phaseSummary', 'phaseComplete',
+        ]);
+        expect(result).toEqual({ data: 42 });
+        expect(phaseStart).toHaveBeenCalledWith({
+            workspacePath: '/ws', cw: 'CW03', name: 'generate-questions',
+            step: 'step-1', scope: 'scope-a',
+        });
+        expect(phaseComplete).toHaveBeenCalledWith({
+            workspacePath: '/ws', cw: 'CW03', summary: 'summary text', scope: 'scope-a',
+        });
+    });
+    it('passes contextPackage merged with input to mainActivity', async () => {
+        const ctxPkg = { essential: [], reference: [] };
+        mockContextLoader.mockResolvedValue(ctxPkg);
+        mockGenerateSummary.mockResolvedValue('s');
+        const mainActivity = vi.fn(async () => ({
+            output: null,
+            assistantMessages: [],
+        }));
+        await standardActivityPattern({
+            workspacePath: '/ws', cw: 'CW03', name: 'n', activityType: 'CW03.n',
+            mainActivity, input: { x: 1 }, phaseStart: vi.fn(), phaseComplete: vi.fn(),
+        });
+        expect(mainActivity).toHaveBeenCalledWith(expect.objectContaining({ x: 1, contextPackage: ctxPkg }));
+        const callArg = mainActivity.mock.calls[0][0];
+        expect(callArg).toHaveProperty('operationalRules');
+        expect(typeof callArg.operationalRules).toBe('string');
+    });
+});
+//# sourceMappingURL=standardActivityPattern.test.js.map

package/dist/patterns/__tests__/standardActivityPattern.test.js.map

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

package/dist/patterns/__tests__/tripleCandidatePattern.test.d.ts

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

package/dist/patterns/__tests__/tripleCandidatePattern.test.d.ts.map

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

package/dist/patterns/__tests__/tripleCandidatePattern.test.js

@@ -0,0 +1,69 @@
+import { describe, it, expect, vi } from 'vitest';
+import { WorkflowAbortError } from '@quickstartsoft/ql-shared-types';
+vi.mock('../../activities/userApprovalActivity.js', () => ({
+    userApprovalActivity: vi.fn(),
+}));
+import { tripleCandidatePattern } from '../tripleCandidatePattern.js';
+import { userApprovalActivity } from '../../activities/userApprovalActivity.js';
+const mockApproval = vi.mocked(userApprovalActivity);
+function buildConfig(overrides = {}) {
+    return {
+        explore: overrides.explore ?? vi.fn().mockResolvedValue('context'),
+        generate: overrides.generate ?? vi.fn().mockResolvedValue(['A', 'B', 'C']),
+        validate: overrides.validate ?? vi.fn()
+            .mockResolvedValue({ passed: true, reportPath: '/ok.json' }),
+        regenerate: overrides.regenerate ?? vi.fn(),
+        select: overrides.select ?? vi.fn()
+            .mockResolvedValue({ selectedIndex: 1 }),
+        refine: overrides.refine ?? vi.fn().mockImplementation((c) => Promise.resolve(`refined-${c}`)),
+        currentStep: 'CW05.plan',
+        maxValidationRetries: overrides.maxValidationRetries,
+    };
+}
+describe('tripleCandidatePattern', () => {
+    it('completes full success flow', async () => {
+        const config = buildConfig();
+        const result = await tripleCandidatePattern(config);
+        expect(config.explore).toHaveBeenCalledOnce();
+        expect(config.generate).toHaveBeenCalledWith('context');
+        expect(config.validate).toHaveBeenCalledOnce();
+        expect(config.select).toHaveBeenCalledOnce();
+        expect(result).toBe('refined-B');
+    });
+    it('regenerates candidates on validation failure', async () => {
+        const validate = vi.fn()
+            .mockResolvedValueOnce({ passed: false, reportPath: '/f.json' })
+            .mockResolvedValueOnce({ passed: true, reportPath: '/ok.json' });
+        const regenerate = vi.fn().mockResolvedValue(['D', 'E', 'F']);
+        const config = buildConfig({ validate, regenerate });
+        const result = await tripleCandidatePattern(config);
+        expect(regenerate).toHaveBeenCalledOnce();
+        expect(result).toBe('refined-E');
+    });
+    it('escalates to user when retries exhausted, abort throws', async () => {
+        const validate = vi.fn()
+            .mockResolvedValue({ passed: false, reportPath: '/f.json' });
+        const regenerate = vi.fn().mockResolvedValue(['X', 'Y', 'Z']);
+        mockApproval.mockResolvedValue({ decision: 'abort' });
+        const config = buildConfig({
+            validate, regenerate, maxValidationRetries: 1,
+        });
+        await expect(tripleCandidatePattern(config)).rejects.toThrow(WorkflowAbortError);
+    });
+    it('continues with current candidates when user approves after retries', async () => {
+        const validate = vi.fn()
+            .mockResolvedValue({ passed: false, reportPath: '/f.json' });
+        const regenerate = vi.fn().mockResolvedValue(['X', 'Y', 'Z']);
+        mockApproval.mockResolvedValue({ decision: 'continue' });
+        const select = vi.fn()
+            .mockResolvedValue({ selectedIndex: 0, comment: 'ok' });
+        const refine = vi.fn().mockResolvedValue('final');
+        const config = buildConfig({
+            validate, regenerate, select, refine, maxValidationRetries: 1,
+        });
+        const result = await tripleCandidatePattern(config);
+        expect(result).toBe('final');
+        expect(refine).toHaveBeenCalledWith('X', 'ok');
+    });
+});
+//# sourceMappingURL=tripleCandidatePattern.test.js.map

package/dist/patterns/__tests__/tripleCandidatePattern.test.js.map

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

package/dist/patterns/adversarialValidationLoop.d.ts

@@ -0,0 +1,11 @@
+import type { ValidationResult } from '@quickstartsoft/ql-shared-types';
+interface AdversarialLoopConfig<T> {
+    maxRetries: number;
+    validate: (subject: T) => Promise<ValidationResult>;
+    revise: (subject: T, report: ValidationResult) => Promise<T>;
+    subjectLabel: string;
+    currentStep: string;
+}
+export declare function adversarialValidationLoop<T>(initialSubject: T, config: AdversarialLoopConfig<T>): Promise<T>;
+export {};
+//# sourceMappingURL=adversarialValidationLoop.d.ts.map

package/dist/patterns/adversarialValidationLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adversarialValidationLoop.d.ts","sourceRoot":"","sources":["../../src/patterns/adversarialValidationLoop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAIxE,UAAU,qBAAqB,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpD,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAC7D,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,cAAc,EAAE,CAAC,EACjB,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CAuBZ"}

package/dist/patterns/adversarialValidationLoop.js

@@ -0,0 +1,24 @@
+import { WorkflowAbortError } from '@quickstartsoft/ql-shared-types';
+import { userApprovalActivity } from '../activities/userApprovalActivity.js';
+export async function adversarialValidationLoop(initialSubject, config) {
+    let subject = initialSubject;
+    for (let attempt = 0; attempt < config.maxRetries; attempt++) {
+        const result = await config.validate(subject);
+        if (result.passed)
+            return subject;
+        subject = await config.revise(subject, result);
+    }
+    const choice = await userApprovalActivity({
+        title: `Adversarial validation failed after ${config.maxRetries} attempts`,
+        content: `The ${config.subjectLabel} has not passed adversarial validation after ${config.maxRetries} attempts. Would you like to continue with the current version or abort?`,
+        options: ['continue', 'abort'],
+    });
+    if (choice.decision === 'abort') {
+        throw new WorkflowAbortError({
+            step: config.currentStep,
+            cause: `User aborted after ${config.maxRetries} adversarial validation attempts`,
+        });
+    }
+    return subject;
+}
+//# sourceMappingURL=adversarialValidationLoop.js.map

package/dist/patterns/adversarialValidationLoop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adversarialValidationLoop.js","sourceRoot":"","sources":["../../src/patterns/adversarialValidationLoop.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAU7E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,cAAiB,EACjB,MAAgC;IAEhC,IAAI,OAAO,GAAG,cAAc,CAAC;IAE7B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,MAAM,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC;QAClC,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;QACxC,KAAK,EAAE,uCAAuC,MAAM,CAAC,UAAU,WAAW;QAC1E,OAAO,EAAE,OAAO,MAAM,CAAC,YAAY,gDAAgD,MAAM,CAAC,UAAU,0EAA0E;QAC9K,OAAO,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;KAC/B,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAChC,MAAM,IAAI,kBAAkB,CAAC;YAC3B,IAAI,EAAE,MAAM,CAAC,WAAW;YACxB,KAAK,EAAE,sBAAsB,MAAM,CAAC,UAAU,kCAAkC;SACjF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/patterns/standardActivityPattern.d.ts

@@ -0,0 +1,36 @@
+import { type AssistantMessage } from '../llm/generatePhaseSummary.js';
+import type { ContextPackage } from '@quickstartsoft/ql-shared-types';
+interface PhaseStartParams {
+    workspacePath: string;
+    cw: string;
+    name: string;
+    step?: string;
+    scope?: string;
+}
+interface PhaseCompleteParams {
+    workspacePath: string;
+    cw: string;
+    summary: string;
+    scope?: string;
+}
+interface StandardActivityParams<TInput, TOutput> {
+    workspacePath: string;
+    cw: string;
+    name: string;
+    step?: string;
+    scope?: string;
+    activityType: string;
+    mainActivity: (input: TInput & {
+        contextPackage: ContextPackage;
+        operationalRules: string;
+    }) => Promise<{
+        output: TOutput;
+        assistantMessages: AssistantMessage[];
+    }>;
+    input: TInput;
+    phaseStart: (params: PhaseStartParams) => Promise<void>;
+    phaseComplete: (params: PhaseCompleteParams) => Promise<void>;
+}
+export declare function standardActivityPattern<TInput, TOutput>(params: StandardActivityParams<TInput, TOutput>): Promise<TOutput>;
+export {};
+//# sourceMappingURL=standardActivityPattern.d.ts.map

package/dist/patterns/standardActivityPattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standardActivityPattern.d.ts","sourceRoot":"","sources":["../../src/patterns/standardActivityPattern.ts"],"names":[],"mappings":"AAMA,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,UAAU,gBAAgB;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,mBAAmB;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,sBAAsB,CAAC,MAAM,EAAE,OAAO;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,cAAc,EAAE,cAAc,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC;QACtG,MAAM,EAAE,OAAO,CAAC;QAChB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;KACvC,CAAC,CAAC;IACH,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,aAAa,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/D;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,OAAO,EAC3D,MAAM,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9C,OAAO,CAAC,OAAO,CAAC,CAmDlB"}