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

package/dist/patterns/standardActivityPattern.js

@@ -0,0 +1,51 @@
+import { buildArtifactStorageRules } from '../activities/buildArtifactStorageRules.js';
+import { buildNoteTakingRules } from '../activities/buildNoteTakingRules.js';
+import { checkFileLineCount } from '../activities/checkFileLineCount.js';
+import { compressAndPromoteTier1 } from '../activities/compressAndPromoteTier1.js';
+import { compressTier2 } from '../activities/compressTier2.js';
+import { contextLoaderActivity } from '../activities/contextLoaderActivity.js';
+import { generatePhaseSummary } from '../llm/generatePhaseSummary.js';
+export async function standardActivityPattern(params) {
+    // 1. phaseStart
+    await params.phaseStart({
+        workspacePath: params.workspacePath,
+        cw: params.cw,
+        name: params.name,
+        step: params.step,
+        scope: params.scope,
+    });
+    // 2. Context Loader (infra LLM)
+    const contextPackage = await contextLoaderActivity({
+        workspacePath: params.workspacePath,
+        nextActivityType: params.activityType,
+    });
+    // 3. Main activity
+    const artifactRules = buildArtifactStorageRules(params.workspacePath, params.cw, params.name, params.scope ?? '');
+    const noteRules = buildNoteTakingRules(params.workspacePath);
+    const operationalRules = [artifactRules, noteRules].join('\n\n');
+    const { output, assistantMessages } = await params.mainActivity({
+        ...params.input,
+        contextPackage,
+        operationalRules,
+    });
+    // 4. Note-taking auto-management (deterministic + infra LLM)
+    const t1Lines = await checkFileLineCount(params.workspacePath, 'scratchpad.md');
+    if (t1Lines > 150) {
+        await compressAndPromoteTier1(params.workspacePath);
+        const t2Lines = await checkFileLineCount(params.workspacePath, 'knowledge.md');
+        if (t2Lines > 150) {
+            await compressTier2(params.workspacePath);
+        }
+    }
+    // 5. Phase summary generation (infra LLM)
+    const summary = await generatePhaseSummary(assistantMessages);
+    // 6. phaseComplete
+    await params.phaseComplete({
+        workspacePath: params.workspacePath,
+        cw: params.cw,
+        summary,
+        scope: params.scope,
+    });
+    return output;
+}
+//# sourceMappingURL=standardActivityPattern.js.map

package/dist/patterns/standardActivityPattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standardActivityPattern.js","sourceRoot":"","sources":["../../src/patterns/standardActivityPattern.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,oBAAoB,EAAyB,MAAM,gCAAgC,CAAC;AAkC7F,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAA+C;IAE/C,gBAAgB;IAChB,MAAM,MAAM,CAAC,UAAU,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IAEH,gCAAgC;IAChC,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC;QACjD,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,gBAAgB,EAAE,MAAM,CAAC,YAAY;KACtC,CAAC,CAAC;IAEH,mBAAmB;IACnB,MAAM,aAAa,GAAG,yBAAyB,CAC7C,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CACjE,CAAC;IACF,MAAM,SAAS,GAAG,oBAAoB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7D,MAAM,gBAAgB,GAAG,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjE,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC;QAC9D,GAAG,MAAM,CAAC,KAAK;QACf,cAAc;QACd,gBAAgB;KACjB,CAAC,CAAC;IAEH,6DAA6D;IAC7D,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IAChF,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;QAClB,MAAM,uBAAuB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAC/E,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;YAClB,MAAM,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,0CAA0C;IAC1C,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;IAE9D,mBAAmB;IACnB,MAAM,MAAM,CAAC,aAAa,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO;QACP,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/patterns/tripleCandidatePattern.d.ts

@@ -0,0 +1,14 @@
+import type { ValidationResult, UserSelectionResult } from '@quickstartsoft/ql-shared-types';
+interface TripleCandidateConfig<TExploreOut, TCandidate, TFinal> {
+    explore: () => Promise<TExploreOut>;
+    generate: (exploreResult: TExploreOut) => Promise<TCandidate[]>;
+    validate: (candidates: TCandidate[]) => Promise<ValidationResult>;
+    regenerate: (exploreResult: TExploreOut, validationReport: ValidationResult) => Promise<TCandidate[]>;
+    select: (candidates: TCandidate[]) => Promise<UserSelectionResult>;
+    refine: (selectedCandidate: TCandidate, userComment?: string) => Promise<TFinal>;
+    maxValidationRetries?: number;
+    currentStep: string;
+}
+export declare function tripleCandidatePattern<TExploreOut, TCandidate, TFinal>(config: TripleCandidateConfig<TExploreOut, TCandidate, TFinal>): Promise<TFinal>;
+export {};
+//# sourceMappingURL=tripleCandidatePattern.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tripleCandidatePattern.d.ts","sourceRoot":"","sources":["../../src/patterns/tripleCandidatePattern.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAI7F,UAAU,qBAAqB,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM;IAC7D,OAAO,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,QAAQ,EAAE,CAAC,aAAa,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAChE,QAAQ,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,UAAU,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACtG,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACnE,MAAM,EAAE,CAAC,iBAAiB,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjF,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,EAC1E,MAAM,EAAE,qBAAqB,CAAC,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,GAC7D,OAAO,CAAC,MAAM,CAAC,CAyCjB"}

package/dist/patterns/tripleCandidatePattern.js

@@ -0,0 +1,39 @@
+import { WorkflowAbortError } from '@quickstartsoft/ql-shared-types';
+import { userApprovalActivity } from '../activities/userApprovalActivity.js';
+const DEFAULT_MAX_RETRIES = 10;
+export async function tripleCandidatePattern(config) {
+    const maxRetries = config.maxValidationRetries ?? DEFAULT_MAX_RETRIES;
+    // 1. Explore
+    const exploreResult = await config.explore();
+    // 2. Generate 3 candidates
+    let candidates = await config.generate(exploreResult);
+    // 3. Validation loop
+    let validated = false;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const result = await config.validate(candidates);
+        if (result.passed) {
+            validated = true;
+            break;
+        }
+        candidates = await config.regenerate(exploreResult, result);
+    }
+    // Loop exhausted: present to user with warning
+    if (!validated) {
+        const choice = await userApprovalActivity({
+            title: `Candidate validation failed after ${maxRetries} attempts`,
+            content: `The candidates have not passed validation after ${maxRetries} attempts. Would you like to continue with the current candidates or abort?`,
+            options: ['continue', 'abort'],
+        });
+        if (choice.decision === 'abort') {
+            throw new WorkflowAbortError({
+                step: config.currentStep,
+                cause: `User aborted after ${maxRetries} candidate validation attempts`,
+            });
+        }
+    }
+    // 4. User selection
+    const selection = await config.select(candidates);
+    // 5. Refine selected candidate
+    return config.refine(candidates[selection.selectedIndex], selection.comment);
+}
+//# sourceMappingURL=tripleCandidatePattern.js.map

package/dist/patterns/tripleCandidatePattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tripleCandidatePattern.js","sourceRoot":"","sources":["../../src/patterns/tripleCandidatePattern.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAa7E,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAA8D;IAE9D,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,IAAI,mBAAmB,CAAC;IAEtE,aAAa;IACb,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IAE7C,2BAA2B;IAC3B,IAAI,UAAU,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IAEtD,qBAAqB;IACrB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;QACD,UAAU,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,+CAA+C;IAC/C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;YACxC,KAAK,EAAE,qCAAqC,UAAU,WAAW;YACjE,OAAO,EAAE,mDAAmD,UAAU,6EAA6E;YACnJ,OAAO,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;SAC/B,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAChC,MAAM,IAAI,kBAAkB,CAAC;gBAC3B,IAAI,EAAE,MAAM,CAAC,WAAW;gBACxB,KAAK,EAAE,sBAAsB,UAAU,gCAAgC;aACxE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAElD,+BAA+B;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;AAC/E,CAAC"}

package/dist/runWorker.d.ts

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

package/dist/runWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runWorker.d.ts","sourceRoot":"","sources":["../src/runWorker.ts"],"names":[],"mappings":"AAYA,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA2B/C"}

package/dist/runWorker.js

@@ -0,0 +1,34 @@
+import { NativeConnection, Worker } from '@temporalio/worker';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import * as activities from './activities/index.js';
+const TASK_QUEUE = 'quick-workflow';
+const TEMPORAL_ADDRESS = 'localhost:7233';
+const SHUTDOWN_GRACE_TIME = '30 seconds';
+const currentDir = path.dirname(fileURLToPath(import.meta.url));
+const workflowsPath = path.resolve(currentDir, './workflows.js');
+export async function runWorker() {
+    const connection = await NativeConnection.connect({
+        address: TEMPORAL_ADDRESS,
+    });
+    let worker;
+    try {
+        worker = await Worker.create({
+            connection,
+            taskQueue: TASK_QUEUE,
+            workflowsPath,
+            activities,
+            shutdownGraceTime: SHUTDOWN_GRACE_TIME,
+        });
+        const shutdown = () => {
+            worker?.shutdown();
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        await worker.run();
+    }
+    finally {
+        await connection.close();
+    }
+}
+//# sourceMappingURL=runWorker.js.map

package/dist/runWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runWorker.js","sourceRoot":"","sources":["../src/runWorker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AAEpD,MAAM,UAAU,GAAG,gBAAgB,CAAC;AACpC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAC1C,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAChE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;AAEjE,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC;QAChD,OAAO,EAAE,gBAAgB;KAC1B,CAAC,CAAC;IAEH,IAAI,MAA0B,CAAC;IAE/B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YAC3B,UAAU;YACV,SAAS,EAAE,UAAU;YACrB,aAAa;YACb,UAAU;YACV,iBAAiB,EAAE,mBAAmB;SACvC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,GAAS,EAAE;YAC1B,MAAM,EAAE,QAAQ,EAAE,CAAC;QACrB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEhC,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;IACrB,CAAC;YAAS,CAAC;QACT,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/utils/generateFinalReport-sections.test.d.ts

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

package/dist/utils/generateFinalReport-sections.test.d.ts.map

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

package/dist/utils/generateFinalReport-sections.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { generateFinalReport } from './generateFinalReport.js';
+function makeTmpDir() {
+    return mkdtempSync(join(tmpdir(), 'report-test-'));
+}
+describe('generateFinalReport sections', () => {
+    const dirs = [];
+    afterEach(() => {
+        for (const d of dirs) {
+            rmSync(d, { recursive: true, force: true });
+        }
+        dirs.length = 0;
+    });
+    it('includes completed steps with artifact paths', () => {
+        const ws = makeTmpDir();
+        dirs.push(ws);
+        const report = {
+            result: 'success',
+            completedSteps: [
+                { name: 'Workspace Init', artifactPaths: ['/ws/plan.md'] },
+                { name: 'Pre-check', artifactPaths: [] },
+            ],
+            workspacePath: ws,
+            branchName: 'main',
+            commitPointers: [],
+        };
+        const md = readFileSync(generateFinalReport(ws, report), 'utf-8');
+        expect(md).toContain('**Workspace Init**');
+        expect(md).toContain('/ws/plan.md');
+        expect(md).toContain('(no artifacts)');
+    });
+    it('includes failure section when present', () => {
+        const ws = makeTmpDir();
+        dirs.push(ws);
+        const report = {
+            result: 'partial-failure',
+            completedSteps: [],
+            failure: { step: 'cw07', cause: 'compile error', logOrReportPath: '/log.txt' },
+            workspacePath: ws,
+            branchName: 'main',
+            commitPointers: [],
+        };
+        const md = readFileSync(generateFinalReport(ws, report), 'utf-8');
+        expect(md).toContain('## Failure');
+        expect(md).toContain('cw07');
+        expect(md).toContain('compile error');
+        expect(md).toContain('/log.txt');
+    });
+    it('includes commit pointers', () => {
+        const ws = makeTmpDir();
+        dirs.push(ws);
+        const report = {
+            result: 'success',
+            completedSteps: [],
+            workspacePath: ws,
+            branchName: 'main',
+            commitPointers: ['abc1234', 'def5678'],
+        };
+        const md = readFileSync(generateFinalReport(ws, report), 'utf-8');
+        expect(md).toContain('abc1234');
+        expect(md).toContain('def5678');
+    });
+    it('includes pending steps and continuation guide', () => {
+        const ws = makeTmpDir();
+        dirs.push(ws);
+        const report = {
+            result: 'partial-failure',
+            completedSteps: [],
+            pendingSteps: ['cw09', 'cw10'],
+            manualContinuationGuide: 'Run tests manually.',
+            workspacePath: ws,
+            branchName: 'main',
+            commitPointers: [],
+        };
+        const md = readFileSync(generateFinalReport(ws, report), 'utf-8');
+        expect(md).toContain('## Pending Steps');
+        expect(md).toContain('cw09');
+        expect(md).toContain('## Manual Continuation Guide');
+        expect(md).toContain('Run tests manually.');
+    });
+});
+//# sourceMappingURL=generateFinalReport-sections.test.js.map

package/dist/utils/generateFinalReport-sections.test.js.map

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

package/dist/utils/generateFinalReport.d.ts

@@ -0,0 +1,3 @@
+import type { FinalReport } from '@quickstartsoft/ql-shared-types';
+export declare function generateFinalReport(workspacePath: string, report: FinalReport): string;
+//# sourceMappingURL=generateFinalReport.d.ts.map

package/dist/utils/generateFinalReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateFinalReport.d.ts","sourceRoot":"","sources":["../../src/utils/generateFinalReport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAInE,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,WAAW,GAClB,MAAM,CAMR"}

package/dist/utils/generateFinalReport.js

@@ -0,0 +1,80 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+export function generateFinalReport(workspacePath, report) {
+    const md = buildMarkdown(report);
+    const reportPath = join(workspacePath, '.ql', 'final-report.md');
+    mkdirSync(dirname(reportPath), { recursive: true });
+    writeFileSync(reportPath, md, 'utf-8');
+    return reportPath;
+}
+function buildMarkdown(report) {
+    const sections = [
+        `# Workflow Final Report`,
+        buildResultSection(report.result),
+        buildWorkspaceSection(report.workspacePath, report.branchName),
+        buildCommitPointersSection(report.commitPointers),
+        buildCompletedStepsSection(report.completedSteps),
+        buildWarningsSection(report.warnings),
+        buildFailureSection(report.failure),
+        buildPendingStepsSection(report.pendingSteps),
+        buildContinuationGuideSection(report.manualContinuationGuide),
+    ];
+    return sections.filter(Boolean).join('\n\n') + '\n';
+}
+function buildResultSection(result) {
+    const emoji = result === 'success' ? 'SUCCESS' : 'PARTIAL FAILURE';
+    return `## Result: ${emoji}`;
+}
+function buildWorkspaceSection(workspacePath, branchName) {
+    return [
+        `## Workspace`,
+        `- **Path:** \`${workspacePath}\``,
+        `- **Branch:** \`${branchName}\``,
+    ].join('\n');
+}
+function buildCommitPointersSection(commitPointers) {
+    if (commitPointers.length === 0)
+        return '';
+    const items = commitPointers.map((c) => `- \`${c}\``).join('\n');
+    return `## Commit Pointers\n${items}`;
+}
+function buildCompletedStepsSection(steps) {
+    if (steps.length === 0)
+        return '';
+    const items = steps.map((s) => formatCompletedStep(s)).join('\n');
+    return `## Completed Steps\n${items}`;
+}
+function formatCompletedStep(step) {
+    const artifacts = step.artifactPaths.length > 0
+        ? step.artifactPaths.map((p) => `  - \`${p}\``).join('\n')
+        : '  - (no artifacts)';
+    return `- **${step.name}**\n${artifacts}`;
+}
+function buildWarningsSection(warnings) {
+    if (!warnings || warnings.length === 0)
+        return '';
+    const items = warnings.map((w) => `- ${w}`).join('\n');
+    return `## Warnings\n${items}`;
+}
+function buildFailureSection(failure) {
+    if (!failure)
+        return '';
+    return [
+        `## Failure`,
+        `- **Step:** ${failure.step}`,
+        `- **Cause:** ${failure.cause}`,
+        `- **Log:** \`${failure.logOrReportPath}\``,
+    ].join('\n');
+}
+function buildPendingStepsSection(pendingSteps) {
+    if (!pendingSteps || pendingSteps.length === 0)
+        return '';
+    const items = pendingSteps.map((s) => `- ${s}`).join('\n');
+    return `## Pending Steps\n${items}`;
+}
+function buildContinuationGuideSection(guide) {
+    if (!guide)
+        return '';
+    return `## Manual Continuation Guide\n${guide}`;
+}
+//# sourceMappingURL=generateFinalReport.js.map

package/dist/utils/generateFinalReport.js.map

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

package/dist/utils/generateFinalReport.test.d.ts

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

package/dist/utils/generateFinalReport.test.d.ts.map

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

package/dist/utils/generateFinalReport.test.js

@@ -0,0 +1,76 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { generateFinalReport } from './generateFinalReport.js';
+function makeTmpDir() {
+    return mkdtempSync(join(tmpdir(), 'report-test-'));
+}
+describe('generateFinalReport', () => {
+    const dirs = [];
+    afterEach(() => {
+        for (const d of dirs) {
+            rmSync(d, { recursive: true, force: true });
+        }
+        dirs.length = 0;
+    });
+    it('writes a report file and returns its path', () => {
+        const ws = makeTmpDir();
+        dirs.push(ws);
+        const report = {
+            result: 'success',
+            completedSteps: [],
+            workspacePath: ws,
+            branchName: 'feat/test',
+            commitPointers: [],
+        };
+        const path = generateFinalReport(ws, report);
+        expect(path).toBe(join(ws, '.ql', 'final-report.md'));
+        const content = readFileSync(path, 'utf-8');
+        expect(content).toContain('# Workflow Final Report');
+    });
+    it('marks success result correctly', () => {
+        const ws = makeTmpDir();
+        dirs.push(ws);
+        const report = {
+            result: 'success',
+            completedSteps: [],
+            workspacePath: ws,
+            branchName: 'main',
+            commitPointers: [],
+        };
+        const path = generateFinalReport(ws, report);
+        const content = readFileSync(path, 'utf-8');
+        expect(content).toContain('SUCCESS');
+    });
+    it('marks partial-failure result correctly', () => {
+        const ws = makeTmpDir();
+        dirs.push(ws);
+        const report = {
+            result: 'partial-failure',
+            completedSteps: [],
+            workspacePath: ws,
+            branchName: 'main',
+            commitPointers: [],
+        };
+        const path = generateFinalReport(ws, report);
+        const content = readFileSync(path, 'utf-8');
+        expect(content).toContain('PARTIAL FAILURE');
+    });
+    it('includes workspace and branch info', () => {
+        const ws = makeTmpDir();
+        dirs.push(ws);
+        const report = {
+            result: 'success',
+            completedSteps: [],
+            workspacePath: ws,
+            branchName: 'feat/branch-name',
+            commitPointers: [],
+        };
+        const path = generateFinalReport(ws, report);
+        const md = readFileSync(path, 'utf-8');
+        expect(md).toContain(ws);
+        expect(md).toContain('feat/branch-name');
+    });
+});
+//# sourceMappingURL=generateFinalReport.test.js.map

package/dist/utils/generateFinalReport.test.js.map

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

package/dist/workflows/cw01-workspace-init/workspaceInitWorkflow.d.ts

@@ -0,0 +1,3 @@
+import type { Cw01Input, Cw01Output } from '@quickstartsoft/ql-shared-types';
+export declare function workspaceInitWorkflow(input: Cw01Input): Promise<Cw01Output>;
+//# sourceMappingURL=workspaceInitWorkflow.d.ts.map

package/dist/workflows/cw01-workspace-init/workspaceInitWorkflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceInitWorkflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/cw01-workspace-init/workspaceInitWorkflow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAwB7E,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,UAAU,CAAC,CA2BrB"}

package/dist/workflows/cw01-workspace-init/workspaceInitWorkflow.js

@@ -0,0 +1,30 @@
+import { proxyActivities } from '@temporalio/workflow';
+import { DETERMINISTIC_TIMEOUT } from '../workflowTimeouts.js';
+const { createWorkspace: createWorkspaceActivity, cloneRepository: cloneRepositoryActivity, createBranch: createBranchActivity, initializeRegistry: initializeRegistryActivity, } = proxyActivities({
+    startToCloseTimeout: DETERMINISTIC_TIMEOUT,
+});
+export async function workspaceInitWorkflow(input) {
+    const { workspacePath } = await createWorkspaceActivity({
+        workflowRunId: input.workflowRunId,
+    });
+    const { confirmedBaseBranch } = await cloneRepositoryActivity({
+        repoUrl: input.repoUrl,
+        baseBranch: input.baseBranch,
+        workspacePath,
+    });
+    const { branchName } = await createBranchActivity({
+        workspacePath,
+        workflowType: input.workflowType,
+        workflowRunId: input.workflowRunId,
+    });
+    await initializeRegistryActivity({
+        workspacePath,
+        repoUrl: input.repoUrl,
+        baseBranch: confirmedBaseBranch,
+        branchName,
+        workflowType: input.workflowType,
+        workflowRunId: input.workflowRunId,
+    });
+    return { workspacePath, branchName, confirmedBaseBranch };
+}
+//# sourceMappingURL=workspaceInitWorkflow.js.map

package/dist/workflows/cw01-workspace-init/workspaceInitWorkflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceInitWorkflow.js","sourceRoot":"","sources":["../../../src/workflows/cw01-workspace-init/workspaceInitWorkflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AASvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,EACJ,eAAe,EAAE,uBAAuB,EACxC,eAAe,EAAE,uBAAuB,EACxC,YAAY,EAAE,oBAAoB,EAClC,kBAAkB,EAAE,0BAA0B,GAC/C,GAAG,eAAe,CAKhB;IACD,mBAAmB,EAAE,qBAAqB;CAC3C,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAAgB;IAEhB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,uBAAuB,CAAC;QACtD,aAAa,EAAE,KAAK,CAAC,aAAa;KACnC,CAAC,CAAC;IAEH,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,uBAAuB,CAAC;QAC5D,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,aAAa;KACd,CAAC,CAAC;IAEH,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,oBAAoB,CAAC;QAChD,aAAa;QACb,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;KACnC,CAAC,CAAC;IAEH,MAAM,0BAA0B,CAAC;QAC/B,aAAa;QACb,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,mBAAmB;QAC/B,UAAU;QACV,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;KACnC,CAAC,CAAC;IAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC;AAC5D,CAAC"}

package/dist/workflows/cw02-pre-check/preCheckWorkflow.d.ts

@@ -0,0 +1,3 @@
+import type { Cw02Input, Cw02Output } from '@quickstartsoft/ql-shared-types';
+export declare function preCheckWorkflow(input: Cw02Input): Promise<Cw02Output>;
+//# sourceMappingURL=preCheckWorkflow.d.ts.map

package/dist/workflows/cw02-pre-check/preCheckWorkflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preCheckWorkflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/cw02-pre-check/preCheckWorkflow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAA4B,MAAM,iCAAiC,CAAC;AA+BvG,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAe5E"}

package/dist/workflows/cw02-pre-check/preCheckWorkflow.js

@@ -0,0 +1,71 @@
+import { executeChild, proxyActivities } from '@temporalio/workflow';
+import { GATE_ORDER, WorkflowAbortError } from '@quickstartsoft/ql-shared-types';
+import { gateCommandResolutionWorkflow } from '../cw15-gate-command-resolution/gateCommandResolutionWorkflow.js';
+import { DETERMINISTIC_TIMEOUT, LLM_TIMEOUT, SHELL_EXEC_TIMEOUT, USER_TIMEOUT } from '../workflowTimeouts.js';
+const MAX_FIX_ATTEMPTS = 10;
+const { runPreCheck: runPreCheckActivity } = proxyActivities({ startToCloseTimeout: SHELL_EXEC_TIMEOUT });
+const { writePreCheckSummary: writeSummaryActivity } = proxyActivities({ startToCloseTimeout: DETERMINISTIC_TIMEOUT });
+const { fixPreCheckFailure: fixPreCheckFailureActivity, reviewPreCheckFix: reviewPreCheckFixActivity, } = proxyActivities({ startToCloseTimeout: LLM_TIMEOUT });
+const { userApprovalActivity: approveActivity } = proxyActivities({ startToCloseTimeout: USER_TIMEOUT });
+export async function preCheckWorkflow(input) {
+    const { gateCommandMap } = await executeChild(gateCommandResolutionWorkflow, {
+        args: [{ workspacePath: input.workspacePath }],
+    });
+    const summaryLines = [];
+    for (const gate of GATE_ORDER) {
+        summaryLines.push(await processGate(input.workspacePath, gate, gateCommandMap));
+    }
+    const { summaryPath } = await writeSummaryActivity({
+        workspacePath: input.workspacePath,
+        lines: summaryLines,
+    });
+    return { summaryPath };
+}
+async function processGate(workspacePath, gate, gateCommandMap) {
+    const command = gateCommandMap[gate];
+    if (command === 'skip')
+        return `${gate}: SKIP`;
+    const initial = await runPreCheckActivity({ workspacePath, gate, command });
+    if (initial.passed)
+        return `${gate}: PASS`;
+    let lastReportPath = initial.reportPath;
+    for (let attempt = 1; attempt <= MAX_FIX_ATTEMPTS; attempt++) {
+        const fix = await fixPreCheckFailureActivity({
+            workspacePath, gate, reportPath: lastReportPath, attempt,
+        });
+        const review = await reviewPreCheckFixActivity({
+            workspacePath, gate,
+            fixReportPath: fix.reportPath,
+            failureReportPath: lastReportPath,
+            attempt,
+        });
+        if (!review.passed)
+            continue;
+        const recheck = await runPreCheckActivity({ workspacePath, gate, command });
+        if (recheck.passed)
+            return `${gate}: PASS (fixed at attempt ${attempt})`;
+        lastReportPath = recheck.reportPath;
+    }
+    return await escalateToUser(gate, lastReportPath);
+}
+async function escalateToUser(gate, reportPath) {
+    const choice = await approveActivity({
+        title: `Pre-check "${gate}" failed after ${MAX_FIX_ATTEMPTS} fix attempts`,
+        content: [
+            `Gate "${gate}" could not be fixed automatically.`,
+            `Last failure report: ${reportPath}`,
+            '',
+            'Continue = skip this gate and proceed.',
+            'Abort = terminate the workflow.',
+        ].join('\n'),
+        options: ['continue', 'abort'],
+    });
+    if (choice.decision === 'abort') {
+        throw new WorkflowAbortError({
+            step: `CW02.pre-check.${gate}`,
+            cause: `User aborted after ${MAX_FIX_ATTEMPTS} fix attempts`,
+        });
+    }
+    return `${gate}: SKIP (user escalation)`;
+}
+//# sourceMappingURL=preCheckWorkflow.js.map

package/dist/workflows/cw02-pre-check/preCheckWorkflow.js.map

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

package/dist/workflows/cw03-requirement-clarification/requirementClarificationWorkflow.d.ts

@@ -0,0 +1,3 @@
+import type { Cw03Input, Cw03Output } from '@quickstartsoft/ql-shared-types';
+export declare function requirementClarificationWorkflow(input: Cw03Input): Promise<Cw03Output>;
+//# sourceMappingURL=requirementClarificationWorkflow.d.ts.map

package/dist/workflows/cw03-requirement-clarification/requirementClarificationWorkflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirementClarificationWorkflow.d.ts","sourceRoot":"","sources":["../../../src/workflows/cw03-requirement-clarification/requirementClarificationWorkflow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AA+C7E,wBAAsB,gCAAgC,CACpD,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,UAAU,CAAC,CAqDrB"}