maestro-flow 0.1.4 → 0.2.1

package/dashboard/dist-server/src/server/agents/tools/issue-mcp-server.test.js

@@ -0,0 +1,286 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { mkdtemp, rm, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+const capturedTools = new Map();
+vi.mock('@anthropic-ai/claude-agent-sdk', () => ({
+    tool: (name, _desc, _schema, handler) => {
+        capturedTools.set(name, handler);
+        return { name, handler };
+    },
+    createSdkMcpServer: (opts) => ({
+        type: 'sdk',
+        name: opts.name,
+        instance: {},
+    }),
+}));
+import { createIssueMcpServer } from './issue-mcp-server.js';
+import { writeIssuesJsonl, readIssuesJsonl } from '../../utils/issue-store.js';
+function makeIssue(overrides = {}) {
+    return {
+        id: overrides.id ?? 'ISS-test-1',
+        title: 'Test issue',
+        description: 'Test description',
+        type: 'bug',
+        priority: 'medium',
+        status: 'open',
+        created_at: '2026-01-01T00:00:00.000Z',
+        updated_at: '2026-01-01T00:00:00.000Z',
+        ...overrides,
+    };
+}
+describe('issue-mcp-server', () => {
+    let tempDir;
+    let jsonlPath;
+    beforeEach(async () => {
+        capturedTools.clear();
+        tempDir = await mkdtemp(join(tmpdir(), 'issue-mcp-'));
+        await mkdir(join(tempDir, 'issues'), { recursive: true });
+        jsonlPath = join(tempDir, 'issues', 'issues.jsonl');
+    });
+    afterEach(async () => {
+        await rm(tempDir, { recursive: true, force: true });
+    });
+    it('creates an MCP server with correct name', () => {
+        const server = createIssueMcpServer(tempDir);
+        expect(server.type).toBe('sdk');
+        expect(server.name).toBe('issue-monitor');
+    });
+    it('registers three tools: get_issue, list_issues, update_issue', () => {
+        createIssueMcpServer(tempDir);
+        expect(capturedTools.has('get_issue')).toBe(true);
+        expect(capturedTools.has('list_issues')).toBe(true);
+        expect(capturedTools.has('update_issue')).toBe(true);
+    });
+    describe('get_issue handler', () => {
+        it('returns issue data when found', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('get_issue');
+            const issue = makeIssue({ id: 'ISS-get-1', title: 'Get Test' });
+            await writeIssuesJsonl(jsonlPath, [issue]);
+            const result = await handler({ issue_id: 'ISS-get-1' });
+            expect(result.isError).toBeUndefined();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.id).toBe('ISS-get-1');
+            expect(parsed.title).toBe('Get Test');
+        });
+        it('returns error when issue not found', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('get_issue');
+            await writeIssuesJsonl(jsonlPath, []);
+            const result = await handler({ issue_id: 'ISS-missing' });
+            expect(result.isError).toBe(true);
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error).toContain('ISS-missing');
+        });
+        it('returns error when JSONL file is empty', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('get_issue');
+            const result = await handler({ issue_id: 'ISS-1' });
+            expect(result.isError).toBe(true);
+        });
+    });
+    describe('list_issues handler', () => {
+        it('returns all issues when no filters', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('list_issues');
+            const issues = [
+                makeIssue({ id: 'ISS-1', status: 'open', type: 'bug', priority: 'high' }),
+                makeIssue({ id: 'ISS-2', status: 'resolved', type: 'feature', priority: 'low' }),
+            ];
+            await writeIssuesJsonl(jsonlPath, issues);
+            const result = await handler({});
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed).toHaveLength(2);
+            expect(parsed[0].id).toBe('ISS-1');
+            expect(parsed[0].has_analysis).toBe(false);
+            expect(parsed[0].has_solution).toBe(false);
+            expect(parsed[0].execution_status).toBe('none');
+        });
+        it('filters by status', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('list_issues');
+            const issues = [
+                makeIssue({ id: 'ISS-1', status: 'open' }),
+                makeIssue({ id: 'ISS-2', status: 'resolved' }),
+                makeIssue({ id: 'ISS-3', status: 'open' }),
+            ];
+            await writeIssuesJsonl(jsonlPath, issues);
+            const result = await handler({ status: 'open' });
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed).toHaveLength(2);
+            expect(parsed.every((i) => i.status === 'open')).toBe(true);
+        });
+        it('filters by type', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('list_issues');
+            const issues = [
+                makeIssue({ id: 'ISS-1', type: 'bug' }),
+                makeIssue({ id: 'ISS-2', type: 'feature' }),
+                makeIssue({ id: 'ISS-3', type: 'bug' }),
+            ];
+            await writeIssuesJsonl(jsonlPath, issues);
+            const result = await handler({ type: 'bug' });
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed).toHaveLength(2);
+        });
+        it('filters by both status and type', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('list_issues');
+            const issues = [
+                makeIssue({ id: 'ISS-1', status: 'open', type: 'bug' }),
+                makeIssue({ id: 'ISS-2', status: 'open', type: 'feature' }),
+                makeIssue({ id: 'ISS-3', status: 'resolved', type: 'bug' }),
+            ];
+            await writeIssuesJsonl(jsonlPath, issues);
+            const result = await handler({ status: 'open', type: 'bug' });
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed).toHaveLength(1);
+            expect(parsed[0].id).toBe('ISS-1');
+        });
+        it('includes analysis and solution presence flags', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('list_issues');
+            const issue = makeIssue({
+                id: 'ISS-1',
+                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: 'fix it' }],
+                    planned_at: '2026-01-01T00:00:00Z',
+                    planned_by: 'test',
+                },
+            });
+            await writeIssuesJsonl(jsonlPath, [issue]);
+            const result = await handler({});
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed[0].has_analysis).toBe(true);
+            expect(parsed[0].has_solution).toBe(true);
+        });
+        it('includes execution status when present', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('list_issues');
+            const issue = makeIssue({
+                id: 'ISS-1',
+                execution: { status: 'running' },
+            });
+            await writeIssuesJsonl(jsonlPath, [issue]);
+            const result = await handler({});
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed[0].execution_status).toBe('running');
+        });
+        it('returns empty array when no issues exist', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('list_issues');
+            const result = await handler({});
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed).toEqual([]);
+        });
+    });
+    describe('update_issue handler', () => {
+        it('updates description field', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('update_issue');
+            await writeIssuesJsonl(jsonlPath, [makeIssue({ id: 'ISS-upd-1', description: 'original' })]);
+            const result = await handler({ issue_id: 'ISS-upd-1', description: 'updated text' });
+            expect(result.isError).toBeUndefined();
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.updated).toBe('ISS-upd-1');
+            const after = await readIssuesJsonl(jsonlPath);
+            expect(after[0].description).toBe('updated text');
+            expect(after[0].updated_at).toBeTruthy();
+        });
+        it('sets analysis fields with timestamps', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('update_issue');
+            await writeIssuesJsonl(jsonlPath, [makeIssue({ id: 'ISS-ana-1' })]);
+            const result = await handler({
+                issue_id: 'ISS-ana-1',
+                analysis: {
+                    root_cause: 'null pointer',
+                    impact: 'crash on load',
+                    related_files: ['src/main.ts'],
+                    confidence: 0.9,
+                    suggested_approach: 'add null check',
+                },
+            });
+            expect(result.isError).toBeUndefined();
+            const after = await readIssuesJsonl(jsonlPath);
+            expect(after[0].analysis?.root_cause).toBe('null pointer');
+            expect(after[0].analysis?.analyzed_at).toBeTruthy();
+            expect(after[0].analysis?.analyzed_by).toBe('agent-sdk');
+        });
+        it('sets solution fields with timestamps', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('update_issue');
+            await writeIssuesJsonl(jsonlPath, [makeIssue({ id: 'ISS-sol-1' })]);
+            const result = await handler({
+                issue_id: 'ISS-sol-1',
+                solution: {
+                    steps: [
+                        { description: 'Add null check', target: 'src/main.ts', verification: 'test passes' },
+                    ],
+                    context: 'crash on startup',
+                },
+            });
+            expect(result.isError).toBeUndefined();
+            const after = await readIssuesJsonl(jsonlPath);
+            expect(after[0].solution?.steps).toHaveLength(1);
+            expect(after[0].solution?.planned_at).toBeTruthy();
+            expect(after[0].solution?.planned_by).toBe('agent-sdk');
+        });
+        it('returns error when issue not found', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('update_issue');
+            await writeIssuesJsonl(jsonlPath, []);
+            const result = await handler({ issue_id: 'ISS-missing', description: 'test' });
+            expect(result.isError).toBe(true);
+            const parsed = JSON.parse(result.content[0].text);
+            expect(parsed.error).toContain('ISS-missing');
+        });
+        it('updates multiple fields at once', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('update_issue');
+            await writeIssuesJsonl(jsonlPath, [makeIssue({ id: 'ISS-multi' })]);
+            await handler({
+                issue_id: 'ISS-multi',
+                description: 'new desc',
+                analysis: {
+                    root_cause: 'rc',
+                    impact: 'imp',
+                    related_files: [],
+                    confidence: 0.5,
+                    suggested_approach: 'approach',
+                },
+                solution: {
+                    steps: [{ description: 'step 1' }],
+                },
+            });
+            const after = await readIssuesJsonl(jsonlPath);
+            expect(after[0].description).toBe('new desc');
+            expect(after[0].analysis?.root_cause).toBe('rc');
+            expect(after[0].solution?.steps).toHaveLength(1);
+        });
+        it('preserves other issues when updating one', async () => {
+            createIssueMcpServer(tempDir);
+            const handler = capturedTools.get('update_issue');
+            await writeIssuesJsonl(jsonlPath, [
+                makeIssue({ id: 'ISS-1', description: 'first' }),
+                makeIssue({ id: 'ISS-2', description: 'second' }),
+            ]);
+            await handler({ issue_id: 'ISS-1', description: 'updated first' });
+            const after = await readIssuesJsonl(jsonlPath);
+            expect(after).toHaveLength(2);
+            expect(after[0].description).toBe('updated first');
+            expect(after[1].description).toBe('second');
+        });
+    });
+});
+//# sourceMappingURL=issue-mcp-server.test.js.map

package/dashboard/dist-server/src/server/agents/tools/issue-mcp-server.test.js.map

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

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

@@ -0,0 +1,49 @@
+import type { CommanderConfig, CommanderState } from '../../shared/commander-types.js';
+import type { DashboardEventBus } from '../state/event-bus.js';
+import type { StateManager } from '../state/state-manager.js';
+import type { ExecutionScheduler } from '../execution/execution-scheduler.js';
+import type { AgentManager } from '../agents/agent-manager.js';
+export declare class CommanderAgent {
+    private readonly eventBus;
+    private readonly stateManager;
+    private readonly executionScheduler;
+    private readonly agentManager;
+    private readonly workflowRoot;
+    private config;
+    private state;
+    private recentDecisions;
+    private consecutiveFailures;
+    private ticksThisHour;
+    private hourResetTimer;
+    private previousStrategyName;
+    constructor(eventBus: DashboardEventBus, stateManager: StateManager, executionScheduler: ExecutionScheduler, agentManager: AgentManager, workflowRoot: string, config?: Partial<CommanderConfig>);
+    /** Start the Commander — registers CommanderStrategy with the scheduler. */
+    start(): Promise<void>;
+    /** Stop the Commander — reverts scheduler to previous strategy. */
+    stop(): void;
+    /** Pause — keep timer running but skip ticks. */
+    pause(): void;
+    /** Resume from paused state. */
+    resume(): void;
+    /** Update config at runtime. */
+    updateConfig(partial: Partial<CommanderConfig>): void;
+    /** Get current state snapshot. */
+    getState(): CommanderState;
+    /** Get current config snapshot. */
+    getConfig(): CommanderConfig;
+    /**
+     * Single tick of the Commander loop:
+     *   1. Gather context
+     *   2. Assess (Agent SDK query, read-only)
+     *   3. Decide (deterministic filtering)
+     *   4. Dispatch (execute approved actions)
+     *   5. Emit events
+     */
+    tick(trigger?: string): Promise<void>;
+    private gatherContext;
+    private assess;
+    private decide;
+    private dispatch;
+    private persistDecision;
+    private emitStatus;
+}