maestro-flow 0.1.4 → 0.2.1

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

@@ -0,0 +1,139 @@
+// ---------------------------------------------------------------------------
+// Commander Agent prompts — system prompt, assessment builder, output schema
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// System prompt — defines Commander's role and behavior
+// ---------------------------------------------------------------------------
+export const COMMANDER_SYSTEM_PROMPT = `You are the Commander Agent for the Maestro workflow orchestration system.
+
+## Role
+You are a strategic decision-maker that assesses project state and recommends actions. You NEVER execute changes directly — you only assess and recommend. Worker agents execute your recommendations.
+
+## Your Data Sources
+Read these files to understand current state:
+- .workflow/state.json — project status, current milestone, phase progress
+- .workflow/issues/issues.jsonl — issue queue (one JSON per line)
+- .workflow/phases/<slug>/index.json — phase details, tasks, execution state
+
+## Output Format
+ALWAYS return a single JSON object (no markdown, no explanation):
+
+{
+  "priority_actions": [
+    {
+      "type": "execute_issue" | "analyze_issue" | "plan_issue" | "create_issue" | "advance_phase" | "flag_blocker",
+      "target": "ISS-xxx" | "phase-slug",
+      "reason": "concise rationale",
+      "risk": "low" | "medium" | "high",
+      "executor": "claude-code" | "gemini" | "codex"
+    }
+  ],
+  "observations": ["what you noticed about project state"],
+  "risks": ["potential problems or blockers"]
+}
+
+## Decision Rules
+1. Prefer issues that already have a .solution planned (solution.steps exists)
+2. Urgent/high priority issues take precedence
+3. If current phase has incomplete tasks, focus on those before advancing
+4. Flag blockers immediately — don't try to resolve them yourself
+5. If nothing actionable, return empty priority_actions (it's OK to do nothing)
+6. Never recommend more actions than the worker capacity allows
+7. Assign executor based on task complexity:
+   - Simple file edits, docs -> gemini (fast, cost-effective)
+   - Code implementation, debugging -> claude-code (thorough)
+   - Code review, analysis -> codex (strong reasoning)
+8. Issue closed-loop progression:
+   - Open issue WITHOUT analysis and WITHOUT solution -> analyze_issue
+   - Open issue WITH analysis but WITHOUT solution -> plan_issue
+   - Open issue WITH solution -> execute_issue
+   - Prefer depth over breadth (complete one issue's chain before starting next)
+
+## Risk Assessment Guidelines
+- LOW: Read-only operations, documentation, simple config changes
+- MEDIUM: Code modifications with existing tests, refactoring
+- HIGH: API changes, database migrations, security-sensitive changes, no test coverage
+`;
+// ---------------------------------------------------------------------------
+// Assessment prompt builder
+// ---------------------------------------------------------------------------
+export function buildAssessmentPrompt(context) {
+    const phaseStatus = context.currentPhase?.status ?? 'unknown';
+    const issueList = context.openIssues.length > 0
+        ? context.openIssues.map((i) => {
+            const state = i.solution ? '[READY]' : i.analysis ? '[ANALYZED]' : '[NEW]';
+            return `- [${i.id}] ${state} ${i.priority.toUpperCase()} ${i.type}: ${i.title}${i.solution ? ' (has solution)' : ''}`;
+        }).join('\n')
+        : '(none)';
+    const decisionList = context.recentDecisions.length > 0
+        ? context.recentDecisions.map((d) => `- [${d.timestamp}] ${d.trigger}: ${d.actions.length} actions dispatched`).join('\n')
+        : '(none)';
+    const blockerList = context.project.accumulated_context.blockers.length > 0
+        ? context.project.accumulated_context.blockers.map((b) => `- ${b}`).join('\n')
+        : '(none)';
+    return `## Current Project State
+Project: ${context.project.project_name}
+Status: ${context.project.status}
+Milestone: ${context.project.current_milestone}
+Phase: ${context.project.current_phase} (${phaseStatus})
+
+## Worker Capacity
+Running: ${context.runningWorkers}/${context.maxWorkers}
+Available slots: ${context.maxWorkers - context.runningWorkers}
+
+## Open Issues (${context.openIssues.length})
+${issueList}
+
+## Recent Decisions (last 5)
+${decisionList}
+
+## Blockers
+${blockerList}
+
+## Task
+Assess the current state and recommend priority actions. Consider:
+1. Are there open issues that should be executed now?
+2. Is the current phase progressing well or stalled?
+3. Are there risks or blockers that need attention?
+4. Should any phase transitions be triggered?
+
+Return your assessment as JSON.`;
+}
+// ---------------------------------------------------------------------------
+// Structured output schema — Agent SDK outputFormat
+// ---------------------------------------------------------------------------
+export const COMMANDER_OUTPUT_SCHEMA = {
+    type: 'json_schema',
+    schema: {
+        type: 'object',
+        properties: {
+            priority_actions: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        type: {
+                            type: 'string',
+                            enum: ['execute_issue', 'analyze_issue', 'plan_issue', 'create_issue', 'advance_phase', 'flag_blocker'],
+                        },
+                        target: { type: 'string', description: 'ISS-xxx or phase-slug' },
+                        reason: { type: 'string' },
+                        risk: { type: 'string', enum: ['low', 'medium', 'high'] },
+                        executor: { type: 'string', enum: ['claude-code', 'gemini', 'codex'] },
+                    },
+                    required: ['type', 'target', 'reason', 'risk', 'executor'],
+                },
+            },
+            observations: {
+                type: 'array',
+                items: { type: 'string' },
+            },
+            risks: {
+                type: 'array',
+                items: { type: 'string' },
+            },
+        },
+        required: ['priority_actions', 'observations', 'risks'],
+    },
+};
+//# sourceMappingURL=commander-prompts.js.map

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

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

package/dashboard/dist-server/src/server/commander/commander-prompts.test.d.ts

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

package/dashboard/dist-server/src/server/commander/commander-prompts.test.js

@@ -0,0 +1,183 @@
+import { describe, it, expect } from 'vitest';
+import { buildAssessmentPrompt, COMMANDER_SYSTEM_PROMPT, COMMANDER_OUTPUT_SCHEMA, } from './commander-prompts.js';
+function makeProject(overrides = {}) {
+    return {
+        version: '1.0',
+        project_name: 'test-project',
+        current_milestone: 'M1',
+        current_phase: 1,
+        status: 'executing',
+        phases_summary: { total: 2, completed: 0, in_progress: 1, pending: 1 },
+        last_updated: '2026-01-01T00:00:00Z',
+        accumulated_context: { key_decisions: [], blockers: [], deferred: [] },
+        ...overrides,
+    };
+}
+function makeContext(overrides = {}) {
+    return {
+        project: makeProject(),
+        openIssues: [],
+        runningWorkers: 0,
+        maxWorkers: 3,
+        recentDecisions: [],
+        workDir: '/tmp/test',
+        ...overrides,
+    };
+}
+describe('commander-prompts', () => {
+    describe('COMMANDER_SYSTEM_PROMPT', () => {
+        it('is a non-empty string', () => {
+            expect(typeof COMMANDER_SYSTEM_PROMPT).toBe('string');
+            expect(COMMANDER_SYSTEM_PROMPT.length).toBeGreaterThan(100);
+        });
+        it('contains key role instructions', () => {
+            expect(COMMANDER_SYSTEM_PROMPT).toContain('Commander Agent');
+            expect(COMMANDER_SYSTEM_PROMPT).toContain('priority_actions');
+            expect(COMMANDER_SYSTEM_PROMPT).toContain('execute_issue');
+        });
+    });
+    describe('COMMANDER_OUTPUT_SCHEMA', () => {
+        it('has json_schema type', () => {
+            expect(COMMANDER_OUTPUT_SCHEMA.type).toBe('json_schema');
+        });
+        it('schema requires priority_actions, observations, risks', () => {
+            const schema = COMMANDER_OUTPUT_SCHEMA.schema;
+            expect(schema.required).toContain('priority_actions');
+            expect(schema.required).toContain('observations');
+            expect(schema.required).toContain('risks');
+        });
+    });
+    describe('buildAssessmentPrompt', () => {
+        it('includes project name and status', () => {
+            const prompt = buildAssessmentPrompt(makeContext());
+            expect(prompt).toContain('test-project');
+            expect(prompt).toContain('executing');
+        });
+        it('includes worker capacity info', () => {
+            const prompt = buildAssessmentPrompt(makeContext({ runningWorkers: 1, maxWorkers: 3 }));
+            expect(prompt).toContain('Running: 1/3');
+            expect(prompt).toContain('Available slots: 2');
+        });
+        it('shows (none) when no open issues', () => {
+            const prompt = buildAssessmentPrompt(makeContext({ openIssues: [] }));
+            expect(prompt).toContain('(none)');
+        });
+        it('lists open issues with state markers', () => {
+            const context = makeContext({
+                openIssues: [
+                    {
+                        id: 'ISS-1',
+                        title: 'Bug in auth',
+                        description: 'Auth fails',
+                        type: 'bug',
+                        priority: 'high',
+                        status: 'open',
+                        created_at: '2026-01-01T00:00:00Z',
+                        updated_at: '2026-01-01T00:00:00Z',
+                    },
+                    {
+                        id: 'ISS-2',
+                        title: 'Add feature',
+                        description: 'New feature',
+                        type: 'feature',
+                        priority: 'medium',
+                        status: 'open',
+                        analysis: {
+                            root_cause: 'missing',
+                            impact: 'low',
+                            related_files: [],
+                            confidence: 0.8,
+                            suggested_approach: 'add it',
+                            analyzed_at: '2026-01-01T00:00:00Z',
+                            analyzed_by: 'test',
+                        },
+                        created_at: '2026-01-01T00:00:00Z',
+                        updated_at: '2026-01-01T00:00:00Z',
+                    },
+                    {
+                        id: 'ISS-3',
+                        title: 'Ready issue',
+                        description: 'Has solution',
+                        type: 'task',
+                        priority: 'low',
+                        status: 'open',
+                        analysis: {
+                            root_cause: 'x',
+                            impact: 'y',
+                            related_files: [],
+                            confidence: 0.9,
+                            suggested_approach: 'z',
+                            analyzed_at: '2026-01-01T00:00:00Z',
+                            analyzed_by: 'test',
+                        },
+                        solution: {
+                            steps: [{ description: 'do it' }],
+                            planned_at: '2026-01-01T00:00:00Z',
+                            planned_by: 'test',
+                        },
+                        created_at: '2026-01-01T00:00:00Z',
+                        updated_at: '2026-01-01T00:00:00Z',
+                    },
+                ],
+            });
+            const prompt = buildAssessmentPrompt(context);
+            expect(prompt).toContain('[NEW]');
+            expect(prompt).toContain('[ANALYZED]');
+            expect(prompt).toContain('[READY]');
+            expect(prompt).toContain('(has solution)');
+            expect(prompt).toContain('HIGH');
+            expect(prompt).toContain('ISS-1');
+            expect(prompt).toContain('ISS-2');
+            expect(prompt).toContain('ISS-3');
+        });
+        it('lists recent decisions', () => {
+            const context = makeContext({
+                recentDecisions: [
+                    {
+                        id: 'dec-1',
+                        timestamp: '2026-01-01T12:00:00Z',
+                        trigger: 'scheduled_tick',
+                        assessment: { priority_actions: [], observations: [], risks: [] },
+                        actions: [
+                            { type: 'execute_issue', target: 'ISS-1', reason: 'Fix', risk: 'low', executor: 'claude-code' },
+                        ],
+                        deferred: [],
+                    },
+                ],
+            });
+            const prompt = buildAssessmentPrompt(context);
+            expect(prompt).toContain('scheduled_tick');
+            expect(prompt).toContain('1 actions dispatched');
+        });
+        it('lists blockers from project context', () => {
+            const project = makeProject({
+                accumulated_context: {
+                    key_decisions: [],
+                    blockers: ['Database migration pending', 'API key expired'],
+                    deferred: [],
+                },
+            });
+            const prompt = buildAssessmentPrompt(makeContext({ project }));
+            expect(prompt).toContain('Database migration pending');
+            expect(prompt).toContain('API key expired');
+        });
+        it('shows current phase status', () => {
+            const context = makeContext({
+                currentPhase: {
+                    phase: 1,
+                    name: 'Setup',
+                    slug: 'phase-1-setup',
+                    status: 'executing',
+                    tasks_summary: { total: 2, completed: 1, in_progress: 1, pending: 0, failed: 0 },
+                },
+            });
+            const prompt = buildAssessmentPrompt(context);
+            expect(prompt).toContain('executing');
+        });
+        it('shows unknown phase status when no current phase', () => {
+            const prompt = buildAssessmentPrompt(makeContext({ currentPhase: undefined }));
+            expect(prompt).toContain('unknown');
+        });
+    });
+});
+//# sourceMappingURL=commander-prompts.test.js.map

package/dashboard/dist-server/src/server/commander/commander-prompts.test.js.map

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

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

@@ -0,0 +1,12 @@
+import { Hono } from 'hono';
+import type { CommanderAgent } from './commander-agent.js';
+/**
+ * Commander routes following the Hono factory pattern.
+ *
+ * POST  /api/commander/start   start the commander tick loop
+ * POST  /api/commander/stop    stop the commander tick loop
+ * POST  /api/commander/pause   pause/resume the commander
+ * GET   /api/commander/status  current commander state
+ * PUT   /api/commander/config  update commander config
+ */
+export declare function createCommanderRoutes(commanderAgent: CommanderAgent, workflowRoot?: string): Hono;

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

@@ -0,0 +1,116 @@
+// ---------------------------------------------------------------------------
+// Commander REST API routes — start, stop, pause, status, config
+// ---------------------------------------------------------------------------
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { Hono } from 'hono';
+/**
+ * Commander routes following the Hono factory pattern.
+ *
+ * POST  /api/commander/start   start the commander tick loop
+ * POST  /api/commander/stop    stop the commander tick loop
+ * POST  /api/commander/pause   pause/resume the commander
+ * GET   /api/commander/status  current commander state
+ * PUT   /api/commander/config  update commander config
+ */
+export function createCommanderRoutes(commanderAgent, workflowRoot) {
+    const app = new Hono();
+    // POST /api/commander/start — start the commander tick loop
+    app.post('/api/commander/start', async (c) => {
+        try {
+            await commanderAgent.start();
+            return c.json({ ok: true, state: commanderAgent.getState() });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return c.json({ error: message }, 500);
+        }
+    });
+    // POST /api/commander/stop — stop the commander tick loop
+    app.post('/api/commander/stop', (c) => {
+        try {
+            commanderAgent.stop();
+            return c.json({ ok: true });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return c.json({ error: message }, 500);
+        }
+    });
+    // POST /api/commander/pause — toggle pause/resume
+    app.post('/api/commander/pause', (c) => {
+        try {
+            const state = commanderAgent.getState();
+            if (state.status === 'paused') {
+                commanderAgent.resume();
+            }
+            else {
+                commanderAgent.pause();
+            }
+            return c.json({ ok: true, state: commanderAgent.getState() });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return c.json({ error: message }, 500);
+        }
+    });
+    // GET /api/commander/status — current state snapshot
+    app.get('/api/commander/status', (c) => {
+        return c.json(commanderAgent.getState());
+    });
+    // PUT /api/commander/config — update commander config
+    app.put('/api/commander/config', async (c) => {
+        try {
+            const body = await c.req.json();
+            commanderAgent.updateConfig(body);
+            return c.json({ ok: true, config: commanderAgent.getConfig() });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return c.json({ error: message }, 500);
+        }
+    });
+    // GET /api/commander/config — read current config
+    app.get('/api/commander/config', (c) => {
+        return c.json(commanderAgent.getConfig());
+    });
+    // POST /api/commander/tick — trigger a single manual tick
+    app.post('/api/commander/tick', async (c) => {
+        try {
+            await commanderAgent.tick('manual');
+            return c.json({ ok: true, state: commanderAgent.getState() });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return c.json({ error: message }, 500);
+        }
+    });
+    // GET /api/commander/decisions — read persisted decision history
+    app.get('/api/commander/decisions', async (c) => {
+        const limit = Number(c.req.query('limit')) || 50;
+        if (!workflowRoot) {
+            return c.json({ decisions: [] });
+        }
+        const filePath = join(workflowRoot, '.commander', 'decisions.jsonl');
+        let raw;
+        try {
+            raw = await readFile(filePath, 'utf-8');
+        }
+        catch {
+            return c.json({ decisions: [] });
+        }
+        const lines = raw.split('\n').filter((l) => l.trim());
+        const decisions = lines
+            .slice(-limit)
+            .map((line) => { try {
+            return JSON.parse(line);
+        }
+        catch {
+            return null;
+        } })
+            .filter(Boolean);
+        return c.json({ decisions });
+    });
+    return app;
+}
+//# sourceMappingURL=commander-routes.js.map

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

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

package/dashboard/dist-server/src/server/commander/commander-routes.test.d.ts

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