maestro-flow 0.1.0

package/dashboard/dist-server/server/prompt/builders/direct-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-builder.js","sourceRoot":"","sources":["../../../../src/server/prompt/builders/direct-builder.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAI9E,MAAM,OAAO,mBAAmB;IACrB,IAAI,GAAG,QAAQ,CAAC;IAEzB,KAAK,CAAC,KAAK,CAAC,OAAsB;QAChC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAE1B,MAAM,KAAK,GAAa;YACtB,wDAAwD,KAAK,CAAC,IAAI,SAAS;YAC3E,EAAE;YACF,MAAM,KAAK,CAAC,KAAK,EAAE;YACnB,EAAE;YACF,KAAK,CAAC,WAAW;YACjB,EAAE;YACF,iBAAiB,KAAK,CAAC,QAAQ,gBAAgB,KAAK,CAAC,IAAI,kBAAkB,KAAK,CAAC,MAAM,EAAE;SAC1F,CAAC;QAEF,6DAA6D;QAC7D,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CACR,EAAE,EACF,aAAa,EACb,mBAAmB,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,EAC9C,eAAe,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,EACtC,iBAAiB,KAAK,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CACrD,CAAC;YACF,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5C,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,wDAAwD;QACxD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAEnC,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC5D,CAAC;YAED,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;gBAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACrD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACrC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;oBAC5C,IAAI,IAAI,CAAC,MAAM;wBAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;oBAC/D,IAAI,IAAI,CAAC,YAAY;wBAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;gBACzE,CAAC;YACH,CAAC;YAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,iBAAiB,EACjB,gCAAgC,EAChC,4DAA4D,EAC5D,2DAA2D,EAC3D,+DAA+D,CAChE,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CACR,EAAE,EACF,iBAAiB,EACjB,wDAAwD,EACxD,gEAAgE,EAChE,wCAAwC,EACxC,2CAA2C,CAC5C,CAAC;QACJ,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;CACF"}

package/dashboard/dist-server/server/prompt/builders/skill-builder.d.ts

@@ -0,0 +1,5 @@
+import type { PromptBuilder, PromptContext, PromptResult } from '../prompt-builder.js';
+export declare class SkillPromptBuilder implements PromptBuilder {
+    readonly name = "skill";
+    build(context: PromptContext): Promise<PromptResult>;
+}

package/dashboard/dist-server/server/prompt/builders/skill-builder.js

@@ -0,0 +1,30 @@
+// ---------------------------------------------------------------------------
+// SkillPromptBuilder — builds prompt referencing issue metadata for skill mode
+// ---------------------------------------------------------------------------
+// Extracted from ExecutionScheduler.buildPrompt() 'skill' mode branch.
+// ---------------------------------------------------------------------------
+export class SkillPromptBuilder {
+    name = 'skill';
+    async build(context) {
+        const { issue } = context;
+        const lines = [
+            `Execute the following issue:`,
+            '',
+            `Issue ID: ${issue.id}`,
+            `Title: ${issue.title}`,
+            `Type: ${issue.type}`,
+            `Priority: ${issue.priority}`,
+            '',
+            `Description:`,
+            issue.description,
+        ];
+        if (issue.analysis?.suggested_approach) {
+            lines.push('', `Suggested approach: ${issue.analysis.suggested_approach}`);
+        }
+        if (issue.analysis?.related_files && issue.analysis.related_files.length > 0) {
+            lines.push(`Key files: ${issue.analysis.related_files.join(', ')}`);
+        }
+        return { userPrompt: lines.join('\n'), mode: 'skill' };
+    }
+}
+//# sourceMappingURL=skill-builder.js.map

package/dashboard/dist-server/server/prompt/builders/skill-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-builder.js","sourceRoot":"","sources":["../../../../src/server/prompt/builders/skill-builder.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAI9E,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,OAAO,CAAC;IAExB,KAAK,CAAC,KAAK,CAAC,OAAsB;QAChC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAE1B,MAAM,KAAK,GAAG;YACZ,8BAA8B;YAC9B,EAAE;YACF,aAAa,KAAK,CAAC,EAAE,EAAE;YACvB,UAAU,KAAK,CAAC,KAAK,EAAE;YACvB,SAAS,KAAK,CAAC,IAAI,EAAE;YACrB,aAAa,KAAK,CAAC,QAAQ,EAAE;YAC7B,EAAE;YACF,cAAc;YACd,KAAK,CAAC,WAAW;SAClB,CAAC;QAEF,IAAI,KAAK,CAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,uBAAuB,KAAK,CAAC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,EAAE,aAAa,IAAI,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7E,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACzD,CAAC;CACF"}

package/dashboard/dist-server/server/prompt/builders/template-builder.d.ts

@@ -0,0 +1,5 @@
+import type { PromptBuilder, PromptContext, PromptResult } from '../prompt-builder.js';
+export declare class TemplatePromptBuilder implements PromptBuilder {
+    readonly name = "template";
+    build(context: PromptContext): Promise<PromptResult>;
+}

package/dashboard/dist-server/server/prompt/builders/template-builder.js

@@ -0,0 +1,26 @@
+// ---------------------------------------------------------------------------
+// TemplatePromptBuilder — applies mustache-style variable substitution
+// ---------------------------------------------------------------------------
+// Extracted from ExecutionScheduler.applyTemplate().
+// ---------------------------------------------------------------------------
+export class TemplatePromptBuilder {
+    name = 'template';
+    async build(context) {
+        const { issue, customTemplate } = context;
+        if (!customTemplate) {
+            throw new Error('TemplatePromptBuilder requires customTemplate in context');
+        }
+        const userPrompt = customTemplate
+            .replace(/\{\{\s*issue\.id\s*\}\}/g, issue.id)
+            .replace(/\{\{\s*issue\.title\s*\}\}/g, issue.title)
+            .replace(/\{\{\s*issue\.description\s*\}\}/g, issue.description)
+            .replace(/\{\{\s*issue\.type\s*\}\}/g, issue.type)
+            .replace(/\{\{\s*issue\.priority\s*\}\}/g, issue.priority)
+            .replace(/\{\{\s*issue\.status\s*\}\}/g, issue.status)
+            .replace(/\{\{\s*issue\.root_cause\s*\}\}/g, issue.analysis?.root_cause ?? '')
+            .replace(/\{\{\s*issue\.suggested_approach\s*\}\}/g, issue.analysis?.suggested_approach ?? '')
+            .replace(/\{\{\s*issue\.solution_context\s*\}\}/g, issue.solution?.context ?? '');
+        return { userPrompt, mode: 'template' };
+    }
+}
+//# sourceMappingURL=template-builder.js.map

package/dashboard/dist-server/server/prompt/builders/template-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-builder.js","sourceRoot":"","sources":["../../../../src/server/prompt/builders/template-builder.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAC9E,qDAAqD;AACrD,8EAA8E;AAI9E,MAAM,OAAO,qBAAqB;IACvB,IAAI,GAAG,UAAU,CAAC;IAE3B,KAAK,CAAC,KAAK,CAAC,OAAsB;QAChC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;QAE1C,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,UAAU,GAAG,cAAc;aAC9B,OAAO,CAAC,0BAA0B,EAAE,KAAK,CAAC,EAAE,CAAC;aAC7C,OAAO,CAAC,6BAA6B,EAAE,KAAK,CAAC,KAAK,CAAC;aACnD,OAAO,CAAC,mCAAmC,EAAE,KAAK,CAAC,WAAW,CAAC;aAC/D,OAAO,CAAC,4BAA4B,EAAE,KAAK,CAAC,IAAI,CAAC;aACjD,OAAO,CAAC,gCAAgC,EAAE,KAAK,CAAC,QAAQ,CAAC;aACzD,OAAO,CAAC,8BAA8B,EAAE,KAAK,CAAC,MAAM,CAAC;aACrD,OAAO,CAAC,kCAAkC,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC;aAC7E,OAAO,CAAC,0CAA0C,EAAE,KAAK,CAAC,QAAQ,EAAE,kBAAkB,IAAI,EAAE,CAAC;aAC7F,OAAO,CAAC,wCAAwC,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QAEpF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC1C,CAAC;CACF"}

package/dashboard/dist-server/server/prompt/prompt-builder.d.ts

@@ -0,0 +1,21 @@
+import type { Issue } from '../../shared/issue-types.js';
+import type { SchedulerConfig, PromptMode } from '../../shared/execution-types.js';
+export interface PromptContext {
+    issue: Issue;
+    config: SchedulerConfig;
+    promptMode: PromptMode;
+    customTemplate?: string;
+    workflowRoot?: string;
+    /** Additional context for specialized builders */
+    extra?: Record<string, unknown>;
+}
+export interface PromptResult {
+    systemPrompt?: string;
+    userPrompt: string;
+    /** Original prompt mode that produced this result */
+    mode: string;
+}
+export interface PromptBuilder {
+    readonly name: string;
+    build(context: PromptContext): Promise<PromptResult>;
+}

package/dashboard/dist-server/server/prompt/prompt-builder.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// PromptBuilder — unified interface for prompt construction
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=prompt-builder.js.map

package/dashboard/dist-server/server/prompt/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../../src/server/prompt/prompt-builder.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E"}

package/dashboard/dist-server/server/prompt/prompt-registry.d.ts

@@ -0,0 +1,8 @@
+import type { PromptBuilder } from './prompt-builder.js';
+export declare class PromptRegistry {
+    private readonly builders;
+    register(builder: PromptBuilder): void;
+    get(name: string): PromptBuilder | undefined;
+    list(): string[];
+    static createDefault(): PromptRegistry;
+}

package/dashboard/dist-server/server/prompt/prompt-registry.js

@@ -0,0 +1,30 @@
+// ---------------------------------------------------------------------------
+// PromptRegistry — central registry for prompt builders
+// ---------------------------------------------------------------------------
+import { DirectPromptBuilder } from './builders/direct-builder.js';
+import { SkillPromptBuilder } from './builders/skill-builder.js';
+import { TemplatePromptBuilder } from './builders/template-builder.js';
+import { DecomposePromptBuilder } from './builders/decompose-builder.js';
+import { AssessmentPromptBuilder } from './builders/assessment-builder.js';
+export class PromptRegistry {
+    builders = new Map();
+    register(builder) {
+        this.builders.set(builder.name, builder);
+    }
+    get(name) {
+        return this.builders.get(name);
+    }
+    list() {
+        return Array.from(this.builders.keys());
+    }
+    static createDefault() {
+        const registry = new PromptRegistry();
+        registry.register(new DirectPromptBuilder());
+        registry.register(new SkillPromptBuilder());
+        registry.register(new TemplatePromptBuilder());
+        registry.register(new DecomposePromptBuilder());
+        registry.register(new AssessmentPromptBuilder());
+        return registry;
+    }
+}
+//# sourceMappingURL=prompt-registry.js.map

package/dashboard/dist-server/server/prompt/prompt-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-registry.js","sourceRoot":"","sources":["../../../src/server/prompt/prompt-registry.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wDAAwD;AACxD,8EAA8E;AAG9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,MAAM,OAAO,cAAc;IACR,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE7D,QAAQ,CAAC,OAAsB;QAC7B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,CAAC,aAAa;QAClB,MAAM,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QACtC,QAAQ,CAAC,QAAQ,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;QAC7C,QAAQ,CAAC,QAAQ,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;QAC5C,QAAQ,CAAC,QAAQ,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;QAC/C,QAAQ,CAAC,QAAQ,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAAC;QAChD,QAAQ,CAAC,QAAQ,CAAC,IAAI,uBAAuB,EAAE,CAAC,CAAC;QACjD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dashboard/dist-server/server/requirement/requirement-expander.d.ts

@@ -0,0 +1,38 @@
+import type { ExpandedRequirement, ExpansionDepth, RequirementProgressPayload } from '../../shared/requirement-types.js';
+import type { WorkflowCoordinator } from '../coordinator/workflow-coordinator.js';
+export type RequirementProgressListener = (payload: RequirementProgressPayload) => void;
+export type ExpansionMethod = 'sdk' | 'cli';
+export declare class RequirementExpander {
+    private readonly store;
+    private readonly coordinateRunner;
+    private readonly issueJsonlPath;
+    private readonly requirementDir;
+    private readonly progressListeners;
+    constructor(coordinateRunner: WorkflowCoordinator, issueJsonlPath: string, requirementDir?: string);
+    /** Subscribe to progress events (used by WS handler to forward to clients) */
+    onProgress(listener: RequirementProgressListener): void;
+    /** Unsubscribe from progress events */
+    offProgress(listener: RequirementProgressListener): void;
+    /** Get an expanded requirement by ID */
+    get(id: string): ExpandedRequirement | undefined;
+    /** Get all expanded requirements */
+    getAll(): ExpandedRequirement[];
+    /** Expand user text into a structured requirement checklist */
+    expand(text: string, depth?: ExpansionDepth, method?: ExpansionMethod, previousRequirementId?: string): Promise<ExpandedRequirement>;
+    /** Refine an existing expansion with user feedback */
+    refine(id: string, feedback: string): Promise<ExpandedRequirement>;
+    /** Convert each checklist item to an Issue and append to issues.jsonl */
+    commitAsIssues(id: string): Promise<string[]>;
+    /** Build intent from requirement and start a WorkflowCoordinator session */
+    commitAsCoordinate(id: string): Promise<string>;
+    /** Run an Agent SDK query with structured output and retry on parse failure */
+    private runExpansionQuery;
+    /** Map status to stage name and progress percentage */
+    private static readonly STATUS_PROGRESS;
+    /** Emit a progress event to all registered listeners */
+    private emitProgress;
+    /** Persist an ExpandedRequirement to a JSON file */
+    private persistRequirement;
+    /** Load all persisted requirements from the requirement directory */
+    private loadPersistedRequirements;
+}

package/dashboard/dist-server/server/requirement/requirement-expander.js

@@ -0,0 +1,384 @@
+// ---------------------------------------------------------------------------
+// RequirementExpander -- expand user requirements into structured checklists
+// ---------------------------------------------------------------------------
+// Uses Agent SDK query() with outputFormat for structured expansion.
+// Supports expand, refine, and dual-mode commit (Issues or Coordinate).
+// ---------------------------------------------------------------------------
+import { randomUUID } from 'node:crypto';
+import { writeFile, readFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { appendIssueJsonl, withIssueWriteLock, generateIssueId, } from '../utils/issue-store.js';
+import { REQUIREMENT_SYSTEM_PROMPT, buildExpandPrompt, buildRefinePrompt, buildContinuePrompt, } from './requirement-prompts.js';
+// ---------------------------------------------------------------------------
+// JSON extraction helper
+// ---------------------------------------------------------------------------
+/** Extract a JSON object from text that may contain markdown fences or preamble */
+function extractJson(text) {
+    // Try 1: Strip markdown fences
+    const fenced = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/i);
+    if (fenced)
+        return fenced[1].trim();
+    // Try 2: Find outermost { ... } pair
+    const first = text.indexOf('{');
+    const last = text.lastIndexOf('}');
+    if (first !== -1 && last > first)
+        return text.slice(first, last + 1);
+    // Try 3: Raw text might already be valid JSON
+    const trimmed = text.trim();
+    if (trimmed.startsWith('{'))
+        return trimmed;
+    return null;
+}
+export class RequirementExpander {
+    store = new Map();
+    coordinateRunner;
+    issueJsonlPath;
+    requirementDir;
+    progressListeners = new Set();
+    constructor(coordinateRunner, issueJsonlPath, requirementDir) {
+        this.coordinateRunner = coordinateRunner;
+        this.issueJsonlPath = issueJsonlPath;
+        this.requirementDir = requirementDir ?? join(dirname(issueJsonlPath), 'requirements');
+        void this.loadPersistedRequirements();
+    }
+    /** Subscribe to progress events (used by WS handler to forward to clients) */
+    onProgress(listener) {
+        this.progressListeners.add(listener);
+    }
+    /** Unsubscribe from progress events */
+    offProgress(listener) {
+        this.progressListeners.delete(listener);
+    }
+    // -------------------------------------------------------------------------
+    // Read access
+    // -------------------------------------------------------------------------
+    /** Get an expanded requirement by ID */
+    get(id) {
+        return this.store.get(id);
+    }
+    /** Get all expanded requirements */
+    getAll() {
+        return Array.from(this.store.values());
+    }
+    // -------------------------------------------------------------------------
+    // Expand
+    // -------------------------------------------------------------------------
+    /** Expand user text into a structured requirement checklist */
+    async expand(text, depth = 'standard', method = 'sdk', previousRequirementId) {
+        const id = `REQ-${Date.now().toString(36)}-${randomUUID().slice(0, 8)}`;
+        const now = new Date().toISOString();
+        const requirement = {
+            id,
+            status: 'expanding',
+            userInput: text,
+            title: '',
+            summary: '',
+            items: [],
+            depth,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.store.set(id, requirement);
+        this.emitProgress(id, 'expanding', 'Expanding requirement...');
+        try {
+            // Build prompt — use continue prompt if building on a previous expansion
+            const previousReq = previousRequirementId ? this.store.get(previousRequirementId) : undefined;
+            const prompt = previousReq
+                ? buildContinuePrompt(text, depth, previousReq)
+                : buildExpandPrompt(text, depth);
+            const result = await this.runExpansionQuery(prompt);
+            requirement.title = result.title;
+            requirement.summary = result.summary;
+            requirement.items = result.items.map((item, index) => ({
+                ...item,
+                id: item.id || `item-${index}`,
+            }));
+            requirement.status = 'reviewing';
+            requirement.updatedAt = new Date().toISOString();
+            this.store.set(id, requirement);
+            void this.persistRequirement(requirement);
+            this.emitProgress(id, 'reviewing', 'Expansion complete. Ready for review.');
+            return requirement;
+        }
+        catch (err) {
+            requirement.status = 'failed';
+            requirement.error = err instanceof Error ? err.message : String(err);
+            requirement.updatedAt = new Date().toISOString();
+            this.store.set(id, requirement);
+            void this.persistRequirement(requirement);
+            this.emitProgress(id, 'failed', requirement.error);
+            throw err;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Refine
+    // -------------------------------------------------------------------------
+    /** Refine an existing expansion with user feedback */
+    async refine(id, feedback) {
+        const requirement = this.store.get(id);
+        if (!requirement) {
+            throw new Error(`Requirement ${id} not found`);
+        }
+        if (requirement.status !== 'reviewing') {
+            throw new Error(`Requirement ${id} is in state "${requirement.status}", expected "reviewing"`);
+        }
+        requirement.status = 'expanding';
+        requirement.updatedAt = new Date().toISOString();
+        this.store.set(id, requirement);
+        this.emitProgress(id, 'expanding', 'Refining requirement...');
+        try {
+            const result = await this.runExpansionQuery(buildRefinePrompt(requirement, feedback));
+            requirement.title = result.title;
+            requirement.summary = result.summary;
+            requirement.items = result.items.map((item, index) => ({
+                ...item,
+                id: item.id || `new-item-${index}`,
+            }));
+            requirement.status = 'reviewing';
+            requirement.updatedAt = new Date().toISOString();
+            this.store.set(id, requirement);
+            void this.persistRequirement(requirement);
+            this.emitProgress(id, 'reviewing', 'Refinement complete. Ready for review.');
+            return requirement;
+        }
+        catch (err) {
+            requirement.status = 'failed';
+            requirement.error = err instanceof Error ? err.message : String(err);
+            requirement.updatedAt = new Date().toISOString();
+            this.store.set(id, requirement);
+            void this.persistRequirement(requirement);
+            this.emitProgress(id, 'failed', requirement.error);
+            throw err;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Commit as Issues
+    // -------------------------------------------------------------------------
+    /** Convert each checklist item to an Issue and append to issues.jsonl */
+    async commitAsIssues(id) {
+        const requirement = this.store.get(id);
+        if (!requirement) {
+            throw new Error(`Requirement ${id} not found`);
+        }
+        if (requirement.status !== 'reviewing') {
+            throw new Error(`Requirement ${id} is in state "${requirement.status}", expected "reviewing"`);
+        }
+        requirement.status = 'committing';
+        requirement.updatedAt = new Date().toISOString();
+        this.store.set(id, requirement);
+        this.emitProgress(id, 'committing', 'Creating issues...');
+        try {
+            const issueIds = [];
+            for (const item of requirement.items) {
+                const issueId = generateIssueId();
+                const now = new Date().toISOString();
+                const issue = {
+                    id: issueId,
+                    title: item.title,
+                    description: item.description,
+                    type: item.type,
+                    priority: item.priority,
+                    status: 'open',
+                    solution: {
+                        steps: [{
+                                description: item.description,
+                            }],
+                        context: `From requirement expansion: ${requirement.title} (${requirement.id})`,
+                        planned_at: now,
+                        planned_by: 'requirement-expander',
+                    },
+                    created_at: now,
+                    updated_at: now,
+                };
+                await withIssueWriteLock(() => appendIssueJsonl(this.issueJsonlPath, issue));
+                issueIds.push(issueId);
+            }
+            requirement.status = 'done';
+            requirement.updatedAt = new Date().toISOString();
+            this.store.set(id, requirement);
+            void this.persistRequirement(requirement);
+            this.emitProgress(id, 'done', `Created ${issueIds.length} issues.`);
+            return issueIds;
+        }
+        catch (err) {
+            requirement.status = 'failed';
+            requirement.error = err instanceof Error ? err.message : String(err);
+            requirement.updatedAt = new Date().toISOString();
+            this.store.set(id, requirement);
+            this.emitProgress(id, 'failed', requirement.error);
+            throw err;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Commit as Coordinate session
+    // -------------------------------------------------------------------------
+    /** Build intent from requirement and start a WorkflowCoordinator session */
+    async commitAsCoordinate(id) {
+        const requirement = this.store.get(id);
+        if (!requirement) {
+            throw new Error(`Requirement ${id} not found`);
+        }
+        if (requirement.status !== 'reviewing') {
+            throw new Error(`Requirement ${id} is in state "${requirement.status}", expected "reviewing"`);
+        }
+        requirement.status = 'committing';
+        requirement.updatedAt = new Date().toISOString();
+        this.store.set(id, requirement);
+        this.emitProgress(id, 'committing', 'Starting coordinate session...');
+        try {
+            // Build intent string from the expanded requirement
+            const itemSummary = requirement.items
+                .map((item, i) => `${i + 1}. [${item.priority}] ${item.title}: ${item.description}`)
+                .join('\n');
+            const intent = [
+                requirement.title,
+                '',
+                requirement.summary,
+                '',
+                'Checklist:',
+                itemSummary,
+            ].join('\n');
+            const opts = {
+                tool: 'claude',
+                autoMode: true,
+            };
+            const session = await this.coordinateRunner.start(intent, opts);
+            requirement.status = 'done';
+            requirement.updatedAt = new Date().toISOString();
+            this.store.set(id, requirement);
+            void this.persistRequirement(requirement);
+            this.emitProgress(id, 'done', `Coordinate session started: ${session.sessionId}`);
+            return session.sessionId;
+        }
+        catch (err) {
+            requirement.status = 'failed';
+            requirement.error = err instanceof Error ? err.message : String(err);
+            requirement.updatedAt = new Date().toISOString();
+            this.store.set(id, requirement);
+            this.emitProgress(id, 'failed', requirement.error);
+            throw err;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internal helpers
+    // -------------------------------------------------------------------------
+    /** Run an Agent SDK query with structured output and retry on parse failure */
+    async runExpansionQuery(prompt, retries = 2) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+            try {
+                let resultText = '';
+                for await (const message of query({
+                    prompt,
+                    options: {
+                        tools: [],
+                        allowedTools: [],
+                        permissionMode: 'dontAsk',
+                        systemPrompt: REQUIREMENT_SYSTEM_PROMPT,
+                        maxTurns: 3,
+                        persistSession: false,
+                    },
+                })) {
+                    const msg = message;
+                    if (msg.type === 'result' && msg.subtype === 'success') {
+                        const successMsg = message;
+                        resultText = successMsg.result;
+                    }
+                }
+                if (!resultText) {
+                    throw new Error('Expansion query succeeded but returned an empty result from the model.');
+                }
+                // Extract JSON from response — model may wrap in markdown fences or add preamble text
+                const jsonStr = extractJson(resultText);
+                if (!jsonStr) {
+                    throw new Error(`Could not extract JSON from model response: ${resultText.substring(0, 100)}...`);
+                }
+                const parsed = JSON.parse(jsonStr);
+                // Validate parsed result
+                if (!parsed || typeof parsed !== 'object') {
+                    throw new Error('Invalid expansion result: result is not an object.');
+                }
+                if (typeof parsed.title !== 'string' || !parsed.title) {
+                    throw new Error('Invalid expansion result: "title" must be a non-empty string.');
+                }
+                if (typeof parsed.summary !== 'string' || !parsed.summary) {
+                    throw new Error('Invalid expansion result: "summary" must be a non-empty string.');
+                }
+                if (!Array.isArray(parsed.items)) {
+                    throw new Error('Invalid expansion result: "items" must be an array.');
+                }
+                return parsed;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                if (attempt < retries) {
+                    // Retry on parse/validation errors
+                    continue;
+                }
+            }
+        }
+        throw lastError ?? new Error('Expansion query failed');
+    }
+    /** Map status to stage name and progress percentage */
+    static STATUS_PROGRESS = {
+        draft: { stage: 'initialized', progress: 0 },
+        expanding: { stage: 'expanding', progress: 30 },
+        reviewing: { stage: 'review', progress: 70 },
+        committing: { stage: 'committing', progress: 90 },
+        done: { stage: 'complete', progress: 100 },
+        failed: { stage: 'failed', progress: 0 },
+    };
+    /** Emit a progress event to all registered listeners */
+    emitProgress(requirementId, status, message) {
+        const { stage, progress } = RequirementExpander.STATUS_PROGRESS[status];
+        const payload = { requirementId, status, stage, progress, message };
+        for (const listener of this.progressListeners) {
+            try {
+                listener(payload);
+            }
+            catch {
+                // Listener errors must not break the expansion flow
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // File persistence
+    // -------------------------------------------------------------------------
+    /** Persist an ExpandedRequirement to a JSON file */
+    async persistRequirement(requirement) {
+        try {
+            await mkdir(this.requirementDir, { recursive: true });
+            const filePath = join(this.requirementDir, `${requirement.id}.json`);
+            await writeFile(filePath, JSON.stringify(requirement, null, 2), 'utf-8');
+        }
+        catch {
+            // Persistence failures are non-fatal
+        }
+    }
+    /** Load all persisted requirements from the requirement directory */
+    async loadPersistedRequirements() {
+        try {
+            await mkdir(this.requirementDir, { recursive: true });
+            const { readdir } = await import('node:fs/promises');
+            const files = await readdir(this.requirementDir);
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const data = await readFile(join(this.requirementDir, file), 'utf-8');
+                    const req = JSON.parse(data);
+                    if (req.id)
+                        this.store.set(req.id, req);
+                }
+                catch {
+                    // Skip malformed files
+                }
+            }
+        }
+        catch {
+            // Directory may not exist yet — that's fine
+        }
+    }
+}
+//# sourceMappingURL=requirement-expander.js.map

package/dashboard/dist-server/server/requirement/requirement-expander.js.map

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

package/dashboard/dist-server/server/requirement/requirement-prompts.d.ts

@@ -0,0 +1,7 @@
+import type { OutputFormat } from '@anthropic-ai/claude-agent-sdk';
+import type { ExpansionDepth, ExpandedRequirement } from '../../shared/requirement-types.js';
+export declare const REQUIREMENT_SYSTEM_PROMPT = "You are a requirements analyst for a software development workflow system.\n\n## Role\nYou decompose user requirements into structured, actionable checklist items. Each item should be independently estimable and assignable. You produce ONLY valid JSON \u2014 no markdown, no explanation.\n\n## Principles\n- Break requirements down along natural boundaries (feature, module, layer)\n- Each item must have a clear definition of done implied by its title + description\n- Dependencies should be explicit \u2014 if item B needs item A done first, list A in deps\n- Estimated effort should be realistic relative to the scope\n- Priority reflects business value and risk, not just implementation order\n- Types: \"feature\" for new capabilities, \"task\" for infrastructure/setup, \"bug\" for defects, \"improvement\" for enhancements\n";
+export declare function buildExpandPrompt(text: string, depth: ExpansionDepth): string;
+export declare function buildRefinePrompt(requirement: ExpandedRequirement, feedback: string): string;
+export declare function buildContinuePrompt(text: string, depth: ExpansionDepth, previousRequirement: ExpandedRequirement): string;
+export declare const REQUIREMENT_OUTPUT_SCHEMA: OutputFormat;