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

package/dist/activities/cw02/runPreCheck.js

@@ -0,0 +1,46 @@
+import { execSync } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+const QL_DIR = '.ql';
+const CW02_DIR = 'cw02';
+export async function runPreCheck(input) {
+    const outDir = join(input.workspacePath, QL_DIR, CW02_DIR);
+    mkdirSync(outDir, { recursive: true });
+    const timestamp = Date.now();
+    const reportPath = join(outDir, `${input.gate}-${timestamp}.md`);
+    try {
+        const stdout = execSync(input.command, {
+            cwd: input.workspacePath,
+            encoding: 'utf-8',
+            timeout: 5 * 60 * 1000,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        writeFileSync(reportPath, buildReport(input.gate, true, stdout), 'utf-8');
+        return { passed: true, reportPath };
+    }
+    catch (error) {
+        const output = extractErrorOutput(error);
+        writeFileSync(reportPath, buildReport(input.gate, false, output), 'utf-8');
+        return { passed: false, reportPath };
+    }
+}
+function buildReport(gate, passed, output) {
+    const status = passed ? 'PASS' : 'FAIL';
+    const lines = [
+        `# Pre-Check: ${gate} — ${status}`,
+        '',
+        '```',
+        output.trim().slice(-2000),
+        '```',
+    ];
+    return lines.join('\n');
+}
+function extractErrorOutput(error) {
+    if (error !== null && typeof error === 'object') {
+        const e = error;
+        const parts = [e.stdout ?? '', e.stderr ?? ''].filter(Boolean).join('\n');
+        return parts || e.message || 'Unknown error';
+    }
+    return String(error);
+}
+//# sourceMappingURL=runPreCheck.js.map

package/dist/activities/cw02/runPreCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPreCheck.js","sourceRoot":"","sources":["../../../src/activities/cw02/runPreCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,MAAM,GAAG,KAAK,CAAC;AACrB,MAAM,QAAQ,GAAG,MAAM,CAAC;AAaxB,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAuB;IAEvB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,SAAS,KAAK,CAAC,CAAC;IAEjE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE;YACrC,GAAG,EAAE,KAAK,CAAC,aAAa;YACxB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;YACtB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;QAEH,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QACzC,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;QAC3E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACvC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAc,EAAE,MAAe,EAAE,MAAc;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IACxC,MAAM,KAAK,GAAG;QACZ,gBAAgB,IAAI,MAAM,MAAM,EAAE;QAClC,EAAE;QACF,KAAK;QACL,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;QAC1B,KAAK;KACN,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,CAAC,GAAG,KAA+D,CAAC;QAC1E,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1E,OAAO,KAAK,IAAI,CAAC,CAAC,OAAO,IAAI,eAAe,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/dist/activities/cw02/writePreCheckSummary.d.ts

@@ -0,0 +1,10 @@
+interface WritePreCheckSummaryInput {
+    workspacePath: string;
+    lines: string[];
+}
+interface WritePreCheckSummaryOutput {
+    summaryPath: string;
+}
+export declare function writePreCheckSummary(input: WritePreCheckSummaryInput): Promise<WritePreCheckSummaryOutput>;
+export {};
+//# sourceMappingURL=writePreCheckSummary.d.ts.map

package/dist/activities/cw02/writePreCheckSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writePreCheckSummary.d.ts","sourceRoot":"","sources":["../../../src/activities/cw02/writePreCheckSummary.ts"],"names":[],"mappings":"AAGA,UAAU,yBAAyB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,0BAA0B;IAClC,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CASrC"}

package/dist/activities/cw02/writePreCheckSummary.js

@@ -0,0 +1,14 @@
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+const QL_DIR = '.ql';
+const CW02_DIR = 'cw02';
+const MAX_LINES = 10;
+export async function writePreCheckSummary(input) {
+    const outDir = join(input.workspacePath, QL_DIR, CW02_DIR);
+    mkdirSync(outDir, { recursive: true });
+    const summaryPath = join(outDir, 'pre-check-summary.md');
+    const content = ['# Pre-Check Summary', '', ...input.lines.slice(0, MAX_LINES)].join('\n');
+    writeFileSync(summaryPath, content, 'utf-8');
+    return { summaryPath };
+}
+//# sourceMappingURL=writePreCheckSummary.js.map

package/dist/activities/cw02/writePreCheckSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writePreCheckSummary.js","sourceRoot":"","sources":["../../../src/activities/cw02/writePreCheckSummary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAWjC,MAAM,MAAM,GAAG,KAAK,CAAC;AACrB,MAAM,QAAQ,GAAG,MAAM,CAAC;AACxB,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAgC;IAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,CAAC,qBAAqB,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3F,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAE7C,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC"}

package/dist/activities/cw03/createPhaseCallbacks.d.ts

@@ -0,0 +1,16 @@
+interface PhaseCallbacks {
+    phaseStart: (params: {
+        cw: string;
+        name: string;
+        step?: string;
+        scope?: string;
+    }) => Promise<void>;
+    phaseComplete: (params: {
+        cw: string;
+        summary: string;
+        scope?: string;
+    }) => Promise<void>;
+}
+export declare function createPhaseCallbacks(workspacePath: string): PhaseCallbacks;
+export {};
+//# sourceMappingURL=createPhaseCallbacks.d.ts.map

package/dist/activities/cw03/createPhaseCallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPhaseCallbacks.d.ts","sourceRoot":"","sources":["../../../src/activities/cw03/createPhaseCallbacks.ts"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACtB,UAAU,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnG,aAAa,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3F;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CA0B1E"}

package/dist/activities/cw03/createPhaseCallbacks.js

@@ -0,0 +1,29 @@
+import { appendPhaseEvent } from '@quickstartsoft/ql-registry';
+export function createPhaseCallbacks(workspacePath) {
+    let activeName = '';
+    return {
+        phaseStart: async (p) => {
+            activeName = p.name;
+            const event = {
+                cw: p.cw,
+                name: p.name,
+                scope: p.scope ?? null,
+                status: 'in-progress',
+                startedAt: new Date().toISOString(),
+            };
+            await appendPhaseEvent(workspacePath, event);
+        },
+        phaseComplete: async (p) => {
+            const event = {
+                cw: p.cw,
+                name: activeName,
+                scope: p.scope ?? null,
+                status: 'completed',
+                summary: p.summary,
+                completedAt: new Date().toISOString(),
+            };
+            await appendPhaseEvent(workspacePath, event);
+        },
+    };
+}
+//# sourceMappingURL=createPhaseCallbacks.js.map

package/dist/activities/cw03/createPhaseCallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPhaseCallbacks.js","sourceRoot":"","sources":["../../../src/activities/cw03/createPhaseCallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAQ/D,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,OAAO;QACL,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACtB,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC;YACpB,MAAM,KAAK,GAAe;gBACxB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;gBACtB,MAAM,EAAE,aAAa;gBACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;YACF,MAAM,gBAAgB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACzB,MAAM,KAAK,GAAe;gBACxB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;gBACtB,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;YACF,MAAM,gBAAgB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/activities/cw03/gatherInformation.d.ts

@@ -0,0 +1,15 @@
+interface QaEntry {
+    question: string;
+    answer: string;
+}
+interface GatherInformationInput {
+    rawRequirement: string;
+    qaHistory: QaEntry[];
+    workspacePath: string;
+}
+interface GatherInformationOutput {
+    researchReports: string[];
+}
+export declare function gatherInformation(input: GatherInformationInput): Promise<GatherInformationOutput>;
+export {};
+//# sourceMappingURL=gatherInformation.d.ts.map

package/dist/activities/cw03/gatherInformation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatherInformation.d.ts","sourceRoot":"","sources":["../../../src/activities/cw03/gatherInformation.ts"],"names":[],"mappings":"AAQA,UAAU,OAAO;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,sBAAsB;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,uBAAuB;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAsCD,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAiClC"}

package/dist/activities/cw03/gatherInformation.js

@@ -0,0 +1,63 @@
+import { join } from 'node:path';
+import { queryWithRetry } from '../../llm/queryWithRetry.js';
+import { standardActivityPattern } from '../../patterns/standardActivityPattern.js';
+import { createPhaseCallbacks } from './createPhaseCallbacks.js';
+const CW = 'CW03';
+const NAME = 'gather-information';
+const SYSTEM_PROMPT = [
+    'You are an expert requirements analyst.',
+    'Investigate the workspace codebase to gather information needed to clarify the given requirement.',
+    'Write investigation reports as markdown files under the workspace .ql/cw03/ directory.',
+    'Respond with a JSON object: { "researchReports": ["<file-path>", ...] }',
+    'Output nothing except the JSON object.',
+].join(' ');
+function buildPrompt(input) {
+    const lines = [
+        `Raw requirement:\n${input.rawRequirement}`,
+        '',
+        `Q&A history:\n${JSON.stringify(input.qaHistory, null, 2)}`,
+        '',
+        `Context (essential): ${input.contextPackage.essential.join(', ') || 'none'}`,
+        `Context (reference): ${input.contextPackage.reference.map((r) => r.path).join(', ') || 'none'}`,
+        '',
+        `Workspace: ${input.workspacePath}`,
+        `Output directory: ${join(input.workspacePath, '.ql', 'cw03')}`,
+    ];
+    return lines.join('\n');
+}
+function parseResponse(raw) {
+    const match = raw.match(/\{[\s\S]*\}/);
+    if (!match)
+        return [];
+    const parsed = JSON.parse(match[0]);
+    return Array.isArray(parsed.researchReports) ? parsed.researchReports : [];
+}
+export async function gatherInformation(input) {
+    const callbacks = createPhaseCallbacks(input.workspacePath);
+    return standardActivityPattern({
+        workspacePath: input.workspacePath,
+        cw: CW,
+        name: NAME,
+        activityType: `${CW}.${NAME}`,
+        input: { rawRequirement: input.rawRequirement, qaHistory: input.qaHistory },
+        mainActivity: async (params) => {
+            const prompt = buildPrompt({ ...params, workspacePath: input.workspacePath });
+            const sdkResult = await queryWithRetry({
+                prompt,
+                systemPrompt: [SYSTEM_PROMPT, params.operationalRules].join('\n\n'),
+                cwd: input.workspacePath,
+            });
+            const text = sdkResult.result;
+            const assistantMessages = [{
+                    role: 'assistant',
+                    content: [{ type: 'text', text }],
+                }];
+            return {
+                output: { researchReports: parseResponse(text) },
+                assistantMessages,
+            };
+        },
+        ...callbacks,
+    });
+}
+//# sourceMappingURL=gatherInformation.js.map

package/dist/activities/cw03/gatherInformation.js.map

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

package/dist/activities/cw03/generateQuestions.d.ts

@@ -0,0 +1,21 @@
+interface QaEntry {
+    question: string;
+    answer: string;
+}
+interface ClarificationQuestion {
+    question: string;
+    choices: [string, string, string];
+}
+interface GenerateQuestionsInput {
+    rawRequirement: string;
+    qaHistory: QaEntry[];
+    researchReports: string[];
+    workspacePath: string;
+}
+export interface GenerateQuestionsOutput {
+    needsQuestions: boolean;
+    questions: ClarificationQuestion[];
+}
+export declare function generateQuestions(input: GenerateQuestionsInput): Promise<GenerateQuestionsOutput>;
+export {};
+//# sourceMappingURL=generateQuestions.d.ts.map

package/dist/activities/cw03/generateQuestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateQuestions.d.ts","sourceRoot":"","sources":["../../../src/activities/cw03/generateQuestions.ts"],"names":[],"mappings":"AAOA,UAAU,OAAO;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,UAAU,sBAAsB;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAgDD,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAkClC"}

package/dist/activities/cw03/generateQuestions.js

@@ -0,0 +1,71 @@
+import { queryWithRetry } from '../../llm/queryWithRetry.js';
+import { standardActivityPattern } from '../../patterns/standardActivityPattern.js';
+import { createPhaseCallbacks } from './createPhaseCallbacks.js';
+const CW = 'CW03';
+const NAME = 'generate-questions';
+const MAX_QUESTIONS = 5;
+const SYSTEM_PROMPT = [
+    'You are an expert requirements analyst.',
+    'Based on the raw requirement, Q&A history, and research reports,',
+    'decide whether more clarification questions are needed.',
+    `If yes, generate up to ${MAX_QUESTIONS} questions, each with exactly 3 suggested answer choices.`,
+    'Respond with a JSON object:',
+    '{ "needsQuestions": boolean, "questions": [{ "question": "...", "choices": ["a","b","c"] }] }',
+    'If needsQuestions is false, questions should be an empty array.',
+    'Output nothing except the JSON object.',
+].join(' ');
+function buildPrompt(input, workspacePath) {
+    const lines = [
+        `Raw requirement:\n${input.rawRequirement}`,
+        '',
+        `Q&A history:\n${JSON.stringify(input.qaHistory, null, 2)}`,
+        '',
+        `Research reports: ${input.researchReports.join(', ') || 'none'}`,
+        '',
+        `Context (essential): ${input.contextPackage.essential.join(', ') || 'none'}`,
+        `Context (reference): ${input.contextPackage.reference.map((r) => r.path).join(', ') || 'none'}`,
+        '',
+        `Workspace: ${workspacePath}`,
+    ];
+    return lines.join('\n');
+}
+function parseResponse(raw) {
+    const match = raw.match(/\{[\s\S]*\}/);
+    if (!match)
+        return { needsQuestions: false, questions: [] };
+    const parsed = JSON.parse(match[0]);
+    const questions = Array.isArray(parsed.questions)
+        ? parsed.questions.slice(0, MAX_QUESTIONS)
+        : [];
+    return { needsQuestions: Boolean(parsed.needsQuestions), questions };
+}
+export async function generateQuestions(input) {
+    const callbacks = createPhaseCallbacks(input.workspacePath);
+    return standardActivityPattern({
+        workspacePath: input.workspacePath,
+        cw: CW,
+        name: NAME,
+        activityType: `${CW}.${NAME}`,
+        input: {
+            rawRequirement: input.rawRequirement,
+            qaHistory: input.qaHistory,
+            researchReports: input.researchReports,
+        },
+        mainActivity: async (params) => {
+            const prompt = buildPrompt(params, input.workspacePath);
+            const sdkResult = await queryWithRetry({
+                prompt,
+                systemPrompt: [SYSTEM_PROMPT, params.operationalRules].join('\n\n'),
+                cwd: input.workspacePath,
+            });
+            const text = sdkResult.result;
+            const assistantMessages = [{
+                    role: 'assistant',
+                    content: [{ type: 'text', text }],
+                }];
+            return { output: parseResponse(text), assistantMessages };
+        },
+        ...callbacks,
+    });
+}
+//# sourceMappingURL=generateQuestions.js.map

package/dist/activities/cw03/generateQuestions.js.map

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

package/dist/activities/cw03/index.d.ts

@@ -0,0 +1,4 @@
+export { gatherInformation } from './gatherInformation.js';
+export { generateQuestions } from './generateQuestions.js';
+export { refineRequirement } from './refineRequirement.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/activities/cw03/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/activities/cw03/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/activities/cw03/index.js

@@ -0,0 +1,4 @@
+export { gatherInformation } from './gatherInformation.js';
+export { generateQuestions } from './generateQuestions.js';
+export { refineRequirement } from './refineRequirement.js';
+//# sourceMappingURL=index.js.map

package/dist/activities/cw03/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/activities/cw03/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/activities/cw03/refineRequirement.d.ts

@@ -0,0 +1,15 @@
+interface QaEntry {
+    question: string;
+    answer: string;
+}
+interface RefineRequirementInput {
+    rawRequirement: string;
+    qaHistory: QaEntry[];
+    workspacePath: string;
+}
+interface RefineRequirementOutput {
+    refinedRequirementPath: string;
+}
+export declare function refineRequirement(input: RefineRequirementInput): Promise<RefineRequirementOutput>;
+export {};
+//# sourceMappingURL=refineRequirement.d.ts.map

package/dist/activities/cw03/refineRequirement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refineRequirement.d.ts","sourceRoot":"","sources":["../../../src/activities/cw03/refineRequirement.ts"],"names":[],"mappings":"AAQA,UAAU,OAAO;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,sBAAsB;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,uBAAuB;IAC/B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AA0CD,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAiClC"}

package/dist/activities/cw03/refineRequirement.js

@@ -0,0 +1,66 @@
+import { join } from 'node:path';
+import { queryWithRetry } from '../../llm/queryWithRetry.js';
+import { standardActivityPattern } from '../../patterns/standardActivityPattern.js';
+import { createPhaseCallbacks } from './createPhaseCallbacks.js';
+const CW = 'CW03';
+const NAME = 'refine-requirement';
+const SYSTEM_PROMPT = [
+    'You are an expert requirements analyst.',
+    'Synthesize the raw requirement and all Q&A data into a clear, detailed requirement document.',
+    'Write the refined requirement as a markdown file in the workspace .ql/cw03/ directory.',
+    'Respond with a JSON object: { "refinedRequirementPath": "<file-path>" }',
+    'Output nothing except the JSON object.',
+].join(' ');
+function buildPrompt(input, workspacePath) {
+    const lines = [
+        `Raw requirement:\n${input.rawRequirement}`,
+        '',
+        `Q&A history:\n${JSON.stringify(input.qaHistory, null, 2)}`,
+        '',
+        `Context (essential): ${input.contextPackage.essential.join(', ') || 'none'}`,
+        `Context (reference): ${input.contextPackage.reference.map((r) => r.path).join(', ') || 'none'}`,
+        '',
+        `Workspace: ${workspacePath}`,
+        `Output directory: ${join(workspacePath, '.ql', 'cw03')}`,
+    ];
+    return lines.join('\n');
+}
+function parseResponse(raw) {
+    const match = raw.match(/\{[\s\S]*\}/);
+    if (!match)
+        throw new Error('Failed to parse refined requirement path from LLM response');
+    const parsed = JSON.parse(match[0]);
+    if (!parsed.refinedRequirementPath) {
+        throw new Error('LLM response missing refinedRequirementPath');
+    }
+    return parsed.refinedRequirementPath;
+}
+export async function refineRequirement(input) {
+    const callbacks = createPhaseCallbacks(input.workspacePath);
+    return standardActivityPattern({
+        workspacePath: input.workspacePath,
+        cw: CW,
+        name: NAME,
+        activityType: `${CW}.${NAME}`,
+        input: { rawRequirement: input.rawRequirement, qaHistory: input.qaHistory },
+        mainActivity: async (params) => {
+            const prompt = buildPrompt(params, input.workspacePath);
+            const sdkResult = await queryWithRetry({
+                prompt,
+                systemPrompt: [SYSTEM_PROMPT, params.operationalRules].join('\n\n'),
+                cwd: input.workspacePath,
+            });
+            const text = sdkResult.result;
+            const assistantMessages = [{
+                    role: 'assistant',
+                    content: [{ type: 'text', text }],
+                }];
+            return {
+                output: { refinedRequirementPath: parseResponse(text) },
+                assistantMessages,
+            };
+        },
+        ...callbacks,
+    });
+}
+//# sourceMappingURL=refineRequirement.js.map

package/dist/activities/cw03/refineRequirement.js.map

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

package/dist/activities/cw04/createPhaseCallbacks.d.ts

@@ -0,0 +1,16 @@
+interface PhaseCallbacks {
+    phaseStart: (params: {
+        cw: string;
+        name: string;
+        step?: string;
+        scope?: string;
+    }) => Promise<void>;
+    phaseComplete: (params: {
+        cw: string;
+        summary: string;
+        scope?: string;
+    }) => Promise<void>;
+}
+export declare function createPhaseCallbacks(workspacePath: string): PhaseCallbacks;
+export {};
+//# sourceMappingURL=createPhaseCallbacks.d.ts.map

package/dist/activities/cw04/createPhaseCallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPhaseCallbacks.d.ts","sourceRoot":"","sources":["../../../src/activities/cw04/createPhaseCallbacks.ts"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACtB,UAAU,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnG,aAAa,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3F;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CA0B1E"}

package/dist/activities/cw04/createPhaseCallbacks.js

@@ -0,0 +1,29 @@
+import { appendPhaseEvent } from '@quickstartsoft/ql-registry';
+export function createPhaseCallbacks(workspacePath) {
+    let activeName = '';
+    return {
+        phaseStart: async (p) => {
+            activeName = p.name;
+            const event = {
+                cw: p.cw,
+                name: p.name,
+                scope: p.scope ?? null,
+                status: 'in-progress',
+                startedAt: new Date().toISOString(),
+            };
+            await appendPhaseEvent(workspacePath, event);
+        },
+        phaseComplete: async (p) => {
+            const event = {
+                cw: p.cw,
+                name: activeName,
+                scope: p.scope ?? null,
+                status: 'completed',
+                summary: p.summary,
+                completedAt: new Date().toISOString(),
+            };
+            await appendPhaseEvent(workspacePath, event);
+        },
+    };
+}
+//# sourceMappingURL=createPhaseCallbacks.js.map

package/dist/activities/cw04/createPhaseCallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPhaseCallbacks.js","sourceRoot":"","sources":["../../../src/activities/cw04/createPhaseCallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAQ/D,MAAM,UAAU,oBAAoB,CAAC,aAAqB;IACxD,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,OAAO;QACL,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACtB,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC;YACpB,MAAM,KAAK,GAAe;gBACxB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;gBACtB,MAAM,EAAE,aAAa;gBACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;YACF,MAAM,gBAAgB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACzB,MAAM,KAAK,GAAe;gBACxB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;gBACtB,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;YACF,MAAM,gBAAgB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/activities/cw04/exploreSolutions.d.ts

@@ -0,0 +1,11 @@
+interface ExploreSolutionsInput {
+    contextDocPaths: string[];
+    preCheckSummaryPath: string;
+    workspacePath: string;
+}
+interface ExploreSolutionsOutput {
+    investigationReportPath: string;
+}
+export declare function exploreSolutions(input: ExploreSolutionsInput): Promise<ExploreSolutionsOutput>;
+export {};
+//# sourceMappingURL=exploreSolutions.d.ts.map

package/dist/activities/cw04/exploreSolutions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exploreSolutions.d.ts","sourceRoot":"","sources":["../../../src/activities/cw04/exploreSolutions.ts"],"names":[],"mappings":"AAQA,UAAU,qBAAqB;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,sBAAsB;IAC9B,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAsCD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAkCjC"}

package/dist/activities/cw04/exploreSolutions.js

@@ -0,0 +1,67 @@
+import { join } from 'node:path';
+import { queryWithRetry } from '../../llm/queryWithRetry.js';
+import { standardActivityPattern } from '../../patterns/standardActivityPattern.js';
+import { createPhaseCallbacks } from './createPhaseCallbacks.js';
+const CW = 'CW04';
+const NAME = 'explore-solutions';
+const SYSTEM_PROMPT = [
+    'You are an expert software architect.',
+    'Investigate the workspace codebase to understand architecture, patterns, and constraints',
+    'relevant to solving the given requirement.',
+    'Write an investigation report as a markdown file under .ql/cw04/.',
+    'Respond with JSON: { "investigationReportPath": "<file-path>" }',
+    'Output nothing except the JSON object.',
+].join(' ');
+function buildPrompt(input, workspacePath) {
+    return [
+        `Context documents: ${input.contextDocPaths.join(', ')}`,
+        `Pre-check summary: ${input.preCheckSummaryPath}`,
+        '',
+        `Context (essential): ${input.contextPackage.essential.join(', ') || 'none'}`,
+        `Context (reference): ${input.contextPackage.reference.map((r) => r.path).join(', ') || 'none'}`,
+        '',
+        `Workspace: ${workspacePath}`,
+        `Output directory: ${join(workspacePath, '.ql', 'cw04')}`,
+    ].join('\n');
+}
+function parseResponse(raw) {
+    const match = raw.match(/\{[\s\S]*\}/);
+    if (!match)
+        throw new Error('Failed to parse investigation report path from LLM response');
+    const parsed = JSON.parse(match[0]);
+    if (!parsed.investigationReportPath)
+        throw new Error('LLM response missing investigationReportPath');
+    return parsed.investigationReportPath;
+}
+export async function exploreSolutions(input) {
+    const callbacks = createPhaseCallbacks(input.workspacePath);
+    return standardActivityPattern({
+        workspacePath: input.workspacePath,
+        cw: CW,
+        name: NAME,
+        activityType: `${CW}.${NAME}`,
+        input: {
+            contextDocPaths: input.contextDocPaths,
+            preCheckSummaryPath: input.preCheckSummaryPath,
+        },
+        mainActivity: async (params) => {
+            const prompt = buildPrompt(params, input.workspacePath);
+            const sdkResult = await queryWithRetry({
+                prompt,
+                systemPrompt: [SYSTEM_PROMPT, params.operationalRules].join('\n\n'),
+                cwd: input.workspacePath,
+            });
+            const text = sdkResult.result;
+            const assistantMessages = [{
+                    role: 'assistant',
+                    content: [{ type: 'text', text }],
+                }];
+            return {
+                output: { investigationReportPath: parseResponse(text) },
+                assistantMessages,
+            };
+        },
+        ...callbacks,
+    });
+}
+//# sourceMappingURL=exploreSolutions.js.map

package/dist/activities/cw04/exploreSolutions.js.map

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

package/dist/activities/cw04/generateCandidates.d.ts

@@ -0,0 +1,18 @@
+import type { ValidationResult } from '@quickstartsoft/ql-shared-types';
+export interface SolutionCandidate {
+    candidateDocPath: string;
+    summary: string;
+    content: string;
+}
+interface GenerateCandidatesInput {
+    contextDocPaths: string[];
+    investigationReportPath: string;
+    workspacePath: string;
+    validationReport?: ValidationResult;
+}
+interface GenerateCandidatesOutput {
+    candidates: SolutionCandidate[];
+}
+export declare function generateCandidates(input: GenerateCandidatesInput): Promise<GenerateCandidatesOutput>;
+export {};
+//# sourceMappingURL=generateCandidates.d.ts.map

package/dist/activities/cw04/generateCandidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateCandidates.d.ts","sourceRoot":"","sources":["../../../src/activities/cw04/generateCandidates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAMxF,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,uBAAuB;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,UAAU,wBAAwB;IAChC,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAgDD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CAmCnC"}