maestro-flow 0.1.3 → 0.2.0

package/dashboard/dist-server/dashboard/src/server/requirement/requirement-prompts.js

@@ -0,0 +1,200 @@
+// ---------------------------------------------------------------------------
+// Requirement expansion prompts -- system prompt, user prompt builder, output schema
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// System prompt
+// ---------------------------------------------------------------------------
+export const REQUIREMENT_SYSTEM_PROMPT = `You are a requirements analyst for a software development workflow system.
+
+## Role
+You decompose user requirements into structured, actionable checklist items. Each item should be independently estimable and assignable. You produce ONLY valid JSON — no markdown, no explanation.
+
+## Principles
+- Break requirements down along natural boundaries (feature, module, layer)
+- Each item must have a clear definition of done implied by its title + description
+- Dependencies should be explicit — if item B needs item A done first, list A in deps
+- Estimated effort should be realistic relative to the scope
+- Priority reflects business value and risk, not just implementation order
+- Types: "feature" for new capabilities, "task" for infrastructure/setup, "bug" for defects, "improvement" for enhancements
+`;
+// ---------------------------------------------------------------------------
+// Depth-specific instructions
+// ---------------------------------------------------------------------------
+const DEPTH_INSTRUCTIONS = {
+    'high-level': [
+        '## Depth: High-Level',
+        'Produce 3-7 coarse-grained items. Each item represents a major feature area or epic.',
+        'Focus on business capabilities, not implementation details.',
+        'Estimated effort should be in t-shirt sizes: "small", "medium", "large", "xlarge".',
+    ].join('\n'),
+    'standard': [
+        '## Depth: Standard',
+        'Produce 5-15 items at a user-story level of granularity.',
+        'Each item should be completable by a single developer in 1-3 days.',
+        'Include both functional and non-functional items (testing, docs, config).',
+        'Estimated effort: "small" (~hours), "medium" (~1 day), "large" (~2-3 days).',
+    ].join('\n'),
+    'atomic': [
+        '## Depth: Atomic',
+        'Produce 10-30 fine-grained, atomic tasks.',
+        'Each item should be completable in under 4 hours by a single developer.',
+        'Include specific file paths, function names, or API endpoints where relevant.',
+        'Break down into implementation-level detail: create file, add function, write test, etc.',
+        'Estimated effort: "tiny" (~30min), "small" (~1-2h), "medium" (~2-4h).',
+    ].join('\n'),
+};
+// ---------------------------------------------------------------------------
+// User prompt builder
+// ---------------------------------------------------------------------------
+export function buildExpandPrompt(text, depth) {
+    const lines = [
+        '## User Requirement',
+        text,
+        '',
+        DEPTH_INSTRUCTIONS[depth],
+        '',
+        '## Output',
+        'Return a JSON object with these fields:',
+        '- title: concise name for this requirement set',
+        '- summary: 1-2 sentence overview',
+        '- items: array of checklist items, each with:',
+        '  - title: concise item title',
+        '  - description: detailed description of what needs to be done',
+        '  - type: "feature" | "task" | "bug" | "improvement"',
+        '  - priority: "low" | "medium" | "high" | "urgent"',
+        '  - dependencies: array of item ids this depends on (empty if none)',
+        '  - estimated_effort: effort estimate appropriate for the depth level',
+        '',
+        'Return ONLY valid JSON. No markdown fences, no explanation.',
+    ];
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Refine prompt builder
+// ---------------------------------------------------------------------------
+export function buildRefinePrompt(requirement, feedback) {
+    const existingItems = requirement.items.map((item) => ({
+        id: item.id,
+        title: item.title,
+        description: item.description,
+        type: item.type,
+        priority: item.priority,
+        dependencies: item.dependencies,
+        estimated_effort: item.estimated_effort,
+    }));
+    const lines = [
+        '## Original Requirement',
+        requirement.userInput,
+        '',
+        '## Current Expansion',
+        `Title: ${requirement.title}`,
+        `Summary: ${requirement.summary}`,
+        `Depth: ${requirement.depth}`,
+        '',
+        '### Current Items',
+        JSON.stringify(existingItems, null, 2),
+        '',
+        '## User Feedback',
+        feedback,
+        '',
+        '## Instructions',
+        'Apply the user feedback to modify the existing expansion.',
+        'You may add, remove, reorder, or modify items.',
+        'Preserve item IDs for items that are unchanged or only slightly modified.',
+        'Use new sequential IDs (continuing from the highest existing number) for new items.',
+        'Return the complete updated result in the same JSON format.',
+        '',
+        'Return ONLY valid JSON. No markdown fences, no explanation.',
+    ];
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Continue prompt builder (expand on top of a prior expansion)
+// ---------------------------------------------------------------------------
+export function buildContinuePrompt(text, depth, previousRequirement) {
+    const prevItems = previousRequirement.items.map((item) => ({
+        id: item.id,
+        title: item.title,
+        description: item.description,
+        type: item.type,
+        priority: item.priority,
+        dependencies: item.dependencies,
+        estimated_effort: item.estimated_effort,
+    }));
+    const lines = [
+        '## Previous Expansion (context)',
+        `Title: ${previousRequirement.title}`,
+        `Summary: ${previousRequirement.summary}`,
+        `Depth: ${previousRequirement.depth}`,
+        `Original input: ${previousRequirement.userInput}`,
+        '',
+        '### Previous Items',
+        JSON.stringify(prevItems, null, 2),
+        '',
+        '## New Requirement (continue planning)',
+        text,
+        '',
+        DEPTH_INSTRUCTIONS[depth],
+        '',
+        '## Instructions',
+        'The user wants to continue planning on top of the previous expansion.',
+        'Use the previous expansion as context and foundation.',
+        'You may reference, extend, or build upon the previous items.',
+        'Produce a NEW expansion that incorporates both the previous work and the new requirement.',
+        'Do NOT simply copy the previous items — merge, extend, or restructure as needed.',
+        '',
+        '## Output',
+        'Return a JSON object with these fields:',
+        '- title: concise name for this combined requirement set',
+        '- summary: 1-2 sentence overview covering both previous and new scope',
+        '- items: array of checklist items (merged/extended), each with:',
+        '  - title, description, type, priority, dependencies, estimated_effort',
+        '',
+        'Return ONLY valid JSON. No markdown fences, no explanation.',
+    ];
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Output schema for Agent SDK structured output
+// ---------------------------------------------------------------------------
+export const REQUIREMENT_OUTPUT_SCHEMA = {
+    type: 'json_schema',
+    schema: {
+        type: 'object',
+        properties: {
+            title: { type: 'string', description: 'Concise name for this requirement set' },
+            summary: { type: 'string', description: '1-2 sentence overview' },
+            items: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string', description: 'Short unique id. Only present for existing items during refine.' },
+                        title: { type: 'string', description: 'Concise item title' },
+                        description: { type: 'string', description: 'Detailed description' },
+                        type: {
+                            type: 'string',
+                            enum: ['feature', 'task', 'bug', 'improvement'],
+                        },
+                        priority: {
+                            type: 'string',
+                            enum: ['low', 'medium', 'high', 'urgent'],
+                        },
+                        dependencies: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'IDs of items this depends on',
+                        },
+                        estimated_effort: {
+                            type: 'string',
+                            description: 'Effort estimate appropriate for the depth level',
+                        },
+                    },
+                    required: ['title', 'description', 'type', 'priority', 'dependencies', 'estimated_effort'],
+                },
+            },
+        },
+        required: ['title', 'summary', 'items'],
+    },
+};
+//# sourceMappingURL=requirement-prompts.js.map

package/dashboard/dist-server/dashboard/src/server/requirement/requirement-prompts.js.map

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

package/dashboard/dist-server/dashboard/src/server/routes/agents.d.ts

@@ -0,0 +1,13 @@
+import { Hono } from 'hono';
+import type { AgentManager } from '../agents/agent-manager.js';
+/**
+ * Agent routes following the Hono factory pattern.
+ *
+ * POST /api/agents/spawn           - spawn a new agent process
+ * POST /api/agents/:id/stop        - stop an agent process
+ * POST /api/agents/:id/message     - send message to agent
+ * POST /api/approvals/:id/respond  - respond to approval request
+ * GET  /api/agents                 - list all active processes
+ * GET  /api/agents/:id/entries     - get entry history for a process
+ */
+export declare function createAgentRoutes(agentManager: AgentManager): Hono;

package/dashboard/dist-server/dashboard/src/server/routes/agents.js

@@ -0,0 +1,124 @@
+// ---------------------------------------------------------------------------
+// Agent REST API routes
+// ---------------------------------------------------------------------------
+import { Hono } from 'hono';
+const VALID_AGENT_TYPES = new Set(['claude-code', 'codex', 'gemini', 'qwen', 'opencode']);
+/**
+ * Agent routes following the Hono factory pattern.
+ *
+ * POST /api/agents/spawn           - spawn a new agent process
+ * POST /api/agents/:id/stop        - stop an agent process
+ * POST /api/agents/:id/message     - send message to agent
+ * POST /api/approvals/:id/respond  - respond to approval request
+ * GET  /api/agents                 - list all active processes
+ * GET  /api/agents/:id/entries     - get entry history for a process
+ */
+export function createAgentRoutes(agentManager) {
+    const app = new Hono();
+    // POST /api/agents/spawn
+    app.post('/api/agents/spawn', async (c) => {
+        try {
+            const body = await c.req.json();
+            if (!body.type || typeof body.type !== 'string') {
+                return c.json({ error: 'Missing or invalid "type" field' }, 400);
+            }
+            if (!VALID_AGENT_TYPES.has(body.type)) {
+                return c.json({ error: `Unsupported agent type: ${body.type}` }, 400);
+            }
+            if (!body.prompt || typeof body.prompt !== 'string') {
+                return c.json({ error: 'Missing or invalid "prompt" field' }, 400);
+            }
+            if (!body.workDir || typeof body.workDir !== 'string') {
+                return c.json({ error: 'Missing or invalid "workDir" field' }, 400);
+            }
+            const config = {
+                type: body.type,
+                prompt: body.prompt,
+                workDir: body.workDir,
+                env: body.env,
+                model: body.model,
+                approvalMode: body.approvalMode,
+            };
+            const process = await agentManager.spawn(config.type, config);
+            return c.json(process, 201);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes('No adapter registered')) {
+                return c.json({ error: message }, 400);
+            }
+            return c.json({ error: message }, 500);
+        }
+    });
+    // POST /api/agents/:id/stop
+    app.post('/api/agents/:id/stop', async (c) => {
+        try {
+            const id = c.req.param('id');
+            await agentManager.stop(id);
+            return c.json({ ok: true });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes('No process found')) {
+                return c.json({ error: message }, 404);
+            }
+            return c.json({ error: message }, 500);
+        }
+    });
+    // POST /api/agents/:id/message
+    app.post('/api/agents/:id/message', async (c) => {
+        try {
+            const id = c.req.param('id');
+            const body = await c.req.json();
+            if (!body.content || typeof body.content !== 'string') {
+                return c.json({ error: 'Missing or invalid "content" field' }, 400);
+            }
+            await agentManager.sendMessage(id, body.content);
+            return c.json({ ok: true });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes('No process found')) {
+                return c.json({ error: message }, 404);
+            }
+            return c.json({ error: message }, 500);
+        }
+    });
+    // POST /api/approvals/:id/respond
+    app.post('/api/approvals/:id/respond', async (c) => {
+        try {
+            const id = c.req.param('id');
+            const body = await c.req.json();
+            if (typeof body.allow !== 'boolean') {
+                return c.json({ error: 'Missing or invalid "allow" field (must be boolean)' }, 400);
+            }
+            if (!body.processId || typeof body.processId !== 'string') {
+                return c.json({ error: 'Missing or invalid "processId" field' }, 400);
+            }
+            await agentManager.respondApproval({
+                id,
+                allow: body.allow,
+                processId: body.processId,
+            });
+            return c.json({ ok: true });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes('No process found')) {
+                return c.json({ error: message }, 404);
+            }
+            return c.json({ error: message }, 500);
+        }
+    });
+    // GET /api/agents
+    app.get('/api/agents', (c) => {
+        return c.json(agentManager.listProcesses());
+    });
+    // GET /api/agents/:id/entries
+    app.get('/api/agents/:id/entries', (c) => {
+        const id = c.req.param('id');
+        return c.json(agentManager.getEntries(id));
+    });
+    return app;
+}
+//# sourceMappingURL=agents.js.map

package/dashboard/dist-server/dashboard/src/server/routes/agents.js.map

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

package/dashboard/dist-server/dashboard/src/server/routes/artifacts.d.ts

@@ -0,0 +1,2 @@
+import { Hono } from 'hono';
+export declare function createArtifactRoutes(workflowRoot: string | (() => string)): Hono;

package/dashboard/dist-server/dashboard/src/server/routes/artifacts.js

@@ -0,0 +1,109 @@
+import { readFile, readdir } from 'node:fs/promises';
+import { resolve, extname, relative, sep } from 'node:path';
+import { Hono } from 'hono';
+import { toForwardSlash } from '../../shared/utils.js';
+/**
+ * Artifact routes.
+ *
+ * GET /api/artifacts?tree=true  - directory tree of .workflow/
+ * GET /api/artifacts/*path      - serve a single file from .workflow/
+ *
+ * Security: path traversal prevention + file type allowlist.
+ */
+const ALLOWED_EXTENSIONS = new Set(['.md', '.json', '.ndjson']);
+const CONTENT_TYPES = {
+    '.md': 'text/markdown; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.ndjson': 'application/x-ndjson; charset=utf-8',
+};
+export function createArtifactRoutes(workflowRoot) {
+    const app = new Hono();
+    const getRoot = () => resolve(typeof workflowRoot === 'function' ? workflowRoot() : workflowRoot);
+    // GET /api/artifacts?tree=true — directory tree
+    // GET /api/artifacts/*path    — serve file
+    app.get('/api/artifacts/*', async (c) => {
+        const resolvedRoot = getRoot();
+        const tree = c.req.query('tree');
+        // Extract file path from the URL (Hono wildcard param may be empty in v4)
+        const prefix = '/api/artifacts/';
+        const urlPath = decodeURIComponent(new URL(c.req.url).pathname);
+        const rawPath = urlPath.startsWith(prefix) ? urlPath.slice(prefix.length) : (c.req.param('*') ?? '');
+        if (tree === 'true' && !rawPath) {
+            const treeData = await buildTree(resolvedRoot, resolvedRoot);
+            return c.json(treeData);
+        }
+        if (!rawPath) {
+            return c.json({ error: 'No artifact path specified' }, 400);
+        }
+        // Resolve and validate the requested path
+        const requested = resolve(resolvedRoot, rawPath);
+        // Path traversal prevention: resolved path must start with workflow root
+        if (!requested.startsWith(resolvedRoot + sep) && requested !== resolvedRoot) {
+            return c.json({ error: 'Forbidden' }, 403);
+        }
+        // Check file extension allowlist
+        const ext = extname(requested).toLowerCase();
+        if (!ALLOWED_EXTENSIONS.has(ext)) {
+            return c.json({ error: `Unsupported file type: ${ext}` }, 415);
+        }
+        // Read and serve the file
+        try {
+            const content = await readFile(requested, 'utf-8');
+            const contentType = CONTENT_TYPES[ext] ?? 'text/plain; charset=utf-8';
+            return c.text(content, 200, { 'Content-Type': contentType });
+        }
+        catch {
+            return c.json({ error: 'File not found' }, 404);
+        }
+    });
+    return app;
+}
+// ---------------------------------------------------------------------------
+// Tree builder
+// ---------------------------------------------------------------------------
+async function buildTree(dir, root) {
+    const nodes = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return nodes;
+    }
+    // Sort entries: directories first, then files, both alphabetically
+    entries.sort((a, b) => {
+        if (a.isDirectory() && !b.isDirectory())
+            return -1;
+        if (!a.isDirectory() && b.isDirectory())
+            return 1;
+        return a.name.localeCompare(b.name);
+    });
+    for (const entry of entries) {
+        const fullPath = resolve(dir, entry.name);
+        const relPath = toForwardSlash(relative(root, fullPath));
+        if (entry.isDirectory()) {
+            // Skip hidden dirs that are not relevant (e.g. node_modules)
+            if (entry.name === 'node_modules')
+                continue;
+            const children = await buildTree(fullPath, root);
+            nodes.push({
+                name: entry.name,
+                path: relPath,
+                type: 'directory',
+                children,
+            });
+        }
+        else {
+            const ext = extname(entry.name).toLowerCase();
+            if (ALLOWED_EXTENSIONS.has(ext)) {
+                nodes.push({
+                    name: entry.name,
+                    path: relPath,
+                    type: 'file',
+                });
+            }
+        }
+    }
+    return nodes;
+}
+//# sourceMappingURL=artifacts.js.map

package/dashboard/dist-server/dashboard/src/server/routes/artifacts.js.map

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

package/dashboard/dist-server/dashboard/src/server/routes/board-state.integration.test.d.ts

@@ -0,0 +1 @@
+export {};