maestro-flow 0.1.3 → 0.2.0

package/dashboard/dist-server/dashboard/src/server/docs/frontmatter-util.js

@@ -0,0 +1,52 @@
+// Frontmatter parser extracted verbatim from routes/specs.ts so both routes
+// share a single source of truth. Matches spec-index-builder.ts behavior.
+export function parseFrontmatter(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith('---')) {
+        return { data: {}, content: raw };
+    }
+    const endIdx = trimmed.indexOf('\n---', 3);
+    if (endIdx === -1) {
+        return { data: {}, content: raw };
+    }
+    const yamlBlock = trimmed.substring(3, endIdx).trim();
+    const content = trimmed.substring(endIdx + 4);
+    const data = {};
+    let currentKey = '';
+    let arrayItems = null;
+    for (const line of yamlBlock.split('\n')) {
+        const trimLine = line.trim();
+        if (trimLine.startsWith('- ') && arrayItems !== null) {
+            arrayItems.push(trimLine.substring(2).trim());
+            continue;
+        }
+        if (arrayItems !== null && currentKey) {
+            data[currentKey] = arrayItems;
+            arrayItems = null;
+        }
+        const colonIdx = trimLine.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = trimLine.substring(0, colonIdx).trim();
+        const value = trimLine.substring(colonIdx + 1).trim();
+        currentKey = key;
+        if (value === '' || value === '[]') {
+            arrayItems = [];
+        }
+        else if (value.startsWith('[') && value.endsWith(']')) {
+            data[key] = value
+                .slice(1, -1)
+                .split(',')
+                .map((s) => s.trim().replace(/^["']|["']$/g, ''))
+                .filter((s) => s.length > 0);
+        }
+        else {
+            data[key] = value.replace(/^["']|["']$/g, '');
+        }
+    }
+    if (arrayItems !== null && currentKey) {
+        data[currentKey] = arrayItems;
+    }
+    return { data, content };
+}
+//# sourceMappingURL=frontmatter-util.js.map

package/dashboard/dist-server/dashboard/src/server/docs/frontmatter-util.js.map

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

package/dashboard/dist-server/dashboard/src/server/docs/virtual-doc-adapters.d.ts

@@ -0,0 +1,4 @@
+import type { DocEntry } from './doc-types.js';
+export declare function adaptIssueRow(row: unknown, sourcePath: string, line: number): DocEntry | null;
+export declare function adaptLessonRow(row: unknown, sourcePath: string, line: number): DocEntry | null;
+export declare function loadVirtualDocs(absPath: string, kind: 'issue' | 'lesson', relPath: string): Promise<DocEntry[]>;

package/dashboard/dist-server/dashboard/src/server/docs/virtual-doc-adapters.js

@@ -0,0 +1,153 @@
+import { readFile } from 'node:fs/promises';
+/**
+ * Virtual doc adapters: read-only reflections of JSONL rows as DocEntries.
+ * Never mutate the source files. Return null on schema violation (logged once
+ * per process) so a malformed row cannot break the whole scan.
+ */
+const warnOnce = new Set();
+function warn(key, message) {
+    if (warnOnce.has(key))
+        return;
+    warnOnce.add(key);
+    // eslint-disable-next-line no-console
+    console.warn(`[doc-scanner] ${message}`);
+}
+function asString(value) {
+    return typeof value === 'string' ? value : '';
+}
+function toIso(value) {
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return new Date(value).toISOString();
+    }
+    return new Date(0).toISOString();
+}
+function mapIssueStatus(raw) {
+    switch (raw) {
+        case 'resolved':
+        case 'closed':
+            return 'completed';
+        case 'deferred':
+            return 'archived';
+        case 'in_progress':
+            return 'active';
+        default:
+            return 'draft';
+    }
+}
+export function adaptIssueRow(row, sourcePath, line) {
+    if (!row || typeof row !== 'object')
+        return null;
+    const r = row;
+    const id = asString(r.id);
+    if (!id) {
+        warn(`issue-no-id:${sourcePath}`, `issue row at ${sourcePath}:${line} missing id`);
+        return null;
+    }
+    const title = asString(r.title) || `Issue ${id}`;
+    const description = asString(r.description);
+    const issueType = asString(r.type);
+    const priority = asString(r.priority);
+    const tags = [];
+    if (issueType)
+        tags.push(issueType);
+    if (priority)
+        tags.push(priority);
+    return {
+        id: `issue-${id}`,
+        type: 'issue',
+        title,
+        summary: description.slice(0, 240),
+        tags,
+        status: mapIssueStatus(r.status),
+        created: toIso(r.created_at),
+        updated: toIso(r.updated_at),
+        phaseRef: null,
+        related: [],
+        source: { kind: 'virtual', path: sourcePath, line },
+        body: '',
+        raw: row,
+        ext: {
+            issueType,
+            priority,
+            rawStatus: r.status,
+            execution: r.execution,
+        },
+    };
+}
+export function adaptLessonRow(row, sourcePath, line) {
+    if (!row || typeof row !== 'object')
+        return null;
+    const r = row;
+    // patterns.jsonl shape: { command, frequency, successRate, avgDuration, lastUsed, contexts[] }
+    const command = asString(r.command);
+    if (!command) {
+        warn(`lesson-no-command:${sourcePath}`, `lesson row at ${sourcePath}:${line} missing command`);
+        return null;
+    }
+    const frequency = typeof r.frequency === 'number' ? r.frequency : 0;
+    const successRate = typeof r.successRate === 'number' ? r.successRate : 0;
+    const avgDuration = typeof r.avgDuration === 'number' ? r.avgDuration : 0;
+    const contexts = Array.isArray(r.contexts) ? r.contexts.map(String) : [];
+    const successPct = Math.round(successRate * 100);
+    const durationSec = Math.round(avgDuration / 1000);
+    const title = `Pattern: ${command}`;
+    const summary = `Used ${frequency}× • ${successPct}% success • ~${durationSec}s avg` +
+        (contexts.length ? ` • ${contexts.length} context(s)` : '');
+    const slug = command.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-|-$/g, '');
+    const lastUsed = toIso(r.lastUsed);
+    return {
+        id: `lesson-${slug || `row${line}`}`,
+        type: 'lesson',
+        title,
+        summary,
+        tags: ['pattern', command],
+        status: 'active',
+        created: lastUsed,
+        updated: lastUsed,
+        phaseRef: null,
+        related: [],
+        source: { kind: 'virtual', path: sourcePath, line },
+        body: '',
+        raw: row,
+        ext: {
+            command,
+            frequency,
+            successRate,
+            avgDuration,
+            contexts,
+        },
+    };
+}
+export async function loadVirtualDocs(absPath, kind, relPath) {
+    let raw;
+    try {
+        raw = await readFile(absPath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    const lines = raw.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (!line.trim())
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            warn(`bad-json:${absPath}:${i + 1}`, `invalid JSON at ${absPath}:${i + 1}`);
+            continue;
+        }
+        const entry = kind === 'issue'
+            ? adaptIssueRow(parsed, relPath, i + 1)
+            : adaptLessonRow(parsed, relPath, i + 1);
+        if (entry)
+            out.push(entry);
+    }
+    return out;
+}
+//# sourceMappingURL=virtual-doc-adapters.js.map

package/dashboard/dist-server/dashboard/src/server/docs/virtual-doc-adapters.js.map

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

package/dashboard/dist-server/dashboard/src/server/execution/dispatch-strategy.d.ts

@@ -0,0 +1,33 @@
+import type { Issue } from '../../shared/issue-types.js';
+import type { ExecutionSlot, SchedulerConfig } from '../../shared/execution-types.js';
+import type { LearningSuggestion } from '../../shared/learning-types.js';
+export interface DispatchContext {
+    /** All issues from JSONL */
+    issues: Issue[];
+    /** Currently running slots */
+    runningSlots: ReadonlyMap<string, ExecutionSlot>;
+    /** Issues already claimed/queued */
+    claimed: ReadonlySet<string>;
+    /** Current scheduler config */
+    config: SchedulerConfig;
+    /** Available capacity (maxConcurrent - running) */
+    availableSlots: number;
+    /** Optional: learning suggestions from SelfLearningService */
+    learningSuggestions?: LearningSuggestion[];
+}
+export interface DispatchDecision {
+    issueId: string;
+    /** Optional: override executor for this issue */
+    executor?: string;
+    /** Optional: override prompt mode */
+    promptMode?: string;
+    /** Reason for selection (for logging) */
+    reason?: string;
+    /** Optional: 'dispatch' (default) auto-executes, 'suggest' is recommendation only */
+    mode?: 'dispatch' | 'suggest';
+}
+export interface DispatchStrategy {
+    readonly name: string;
+    /** Select issues to dispatch given current context. Return empty array to skip. */
+    selectIssues(context: DispatchContext): Promise<DispatchDecision[]>;
+}

package/dashboard/dist-server/dashboard/src/server/execution/dispatch-strategy.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// DispatchStrategy — pluggable interface for issue selection in tick loop
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=dispatch-strategy.js.map

package/dashboard/dist-server/dashboard/src/server/execution/dispatch-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-strategy.js","sourceRoot":"","sources":["../../../../../src/server/execution/dispatch-strategy.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E"}

package/dashboard/dist-server/dashboard/src/server/execution/execution-journal.d.ts

@@ -0,0 +1,16 @@
+import type { JournalEvent, RecoveryAction } from '../../shared/journal-types.js';
+export declare class ExecutionJournal {
+    private readonly journalPath;
+    private readonly maxSizeBytes;
+    constructor(workflowRoot: string, maxSizeBytes?: number);
+    /** Append a single event atomically (single-line JSON + appendFile) */
+    append(event: JournalEvent): Promise<void>;
+    /** Read all events from the journal */
+    readAll(): Promise<JournalEvent[]>;
+    /** Get events for a specific issue */
+    getEventsForIssue(issueId: string): Promise<JournalEvent[]>;
+    /** Analyze journal and determine recovery actions for interrupted executions */
+    recover(): Promise<RecoveryAction[]>;
+    /** Rotate journal when it exceeds maxSizeBytes */
+    rotate(): Promise<void>;
+}

package/dashboard/dist-server/dashboard/src/server/execution/execution-journal.js

@@ -0,0 +1,100 @@
+// ---------------------------------------------------------------------------
+// ExecutionJournal — append-only JSONL event log for crash recovery
+// ---------------------------------------------------------------------------
+import { appendFile, readFile, rename, mkdir, stat } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+export class ExecutionJournal {
+    journalPath;
+    maxSizeBytes;
+    constructor(workflowRoot, maxSizeBytes = 10 * 1024 * 1024) {
+        this.journalPath = join(workflowRoot, 'execution', 'journal.jsonl');
+        this.maxSizeBytes = maxSizeBytes;
+    }
+    /** Append a single event atomically (single-line JSON + appendFile) */
+    async append(event) {
+        await mkdir(dirname(this.journalPath), { recursive: true });
+        const record = { ...event, timestamp: event.timestamp || new Date().toISOString() };
+        const line = JSON.stringify(record) + '\n';
+        await appendFile(this.journalPath, line, 'utf-8');
+    }
+    /** Read all events from the journal */
+    async readAll() {
+        let raw;
+        try {
+            raw = await readFile(this.journalPath, 'utf-8');
+        }
+        catch {
+            return [];
+        }
+        const events = [];
+        for (const line of raw.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                events.push(JSON.parse(trimmed));
+            }
+            catch {
+                // Skip malformed lines — journal must be resilient to partial writes
+            }
+        }
+        return events;
+    }
+    /** Get events for a specific issue */
+    async getEventsForIssue(issueId) {
+        const all = await this.readAll();
+        return all.filter((e) => e.issueId === issueId);
+    }
+    /** Analyze journal and determine recovery actions for interrupted executions */
+    async recover() {
+        const events = await this.readAll();
+        const actions = [];
+        // Group by issueId
+        const byIssue = new Map();
+        for (const event of events) {
+            const list = byIssue.get(event.issueId) || [];
+            list.push(event);
+            byIssue.set(event.issueId, list);
+        }
+        for (const [issueId, issueEvents] of byIssue) {
+            const sorted = issueEvents.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+            const last = sorted[sorted.length - 1];
+            if (last.type === 'issue:dispatched') {
+                // Dispatched but no completion/failure — server crashed during execution
+                actions.push({
+                    issueId,
+                    action: 'retry',
+                    reason: 'Dispatched but no completion event — server crashed',
+                });
+            }
+            else if (last.type === 'wave:started' || last.type === 'wave:task_completed') {
+                // Wave in progress — find completed tasks for resume
+                const completedTaskIds = sorted
+                    .filter((e) => e.type === 'wave:task_completed')
+                    .map((e) => e.taskId);
+                actions.push({
+                    issueId,
+                    action: 'resume-wave',
+                    reason: `Wave interrupted with ${completedTaskIds.length} completed tasks`,
+                    completedTaskIds,
+                });
+            }
+            // issue:completed or issue:failed — terminal states, no action needed
+        }
+        return actions;
+    }
+    /** Rotate journal when it exceeds maxSizeBytes */
+    async rotate() {
+        try {
+            const info = await stat(this.journalPath);
+            if (info.size > this.maxSizeBytes) {
+                const archivePath = this.journalPath.replace('.jsonl', `-${Date.now()}.jsonl`);
+                await rename(this.journalPath, archivePath);
+            }
+        }
+        catch {
+            // File doesn't exist yet — nothing to rotate
+        }
+    }
+}
+//# sourceMappingURL=execution-journal.js.map

package/dashboard/dist-server/dashboard/src/server/execution/execution-journal.js.map

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

package/dashboard/dist-server/dashboard/src/server/execution/execution-scheduler.d.ts

@@ -0,0 +1,126 @@
+import type { AgentType } from '../../shared/agent-types.js';
+import type { ExecutionSlot, SchedulerConfig, SchedulerStatus } from '../../shared/execution-types.js';
+import type { AgentManager } from '../agents/agent-manager.js';
+import type { DashboardEventBus } from '../state/event-bus.js';
+import { PromptRegistry } from '../prompt/prompt-registry.js';
+import type { ExecutionJournal } from './execution-journal.js';
+import type { DispatchStrategy } from './dispatch-strategy.js';
+import type { SelfLearningService } from '../supervisor/self-learning-service.js';
+export declare class ExecutionScheduler {
+    private readonly agentManager;
+    private readonly eventBus;
+    private readonly jsonlPath;
+    private readonly journal?;
+    private readonly runningSlots;
+    private readonly queue;
+    private readonly retryQueue;
+    private readonly claimed;
+    private config;
+    private readonly workspaceManager;
+    private readonly promptRegistry;
+    private tickTimer;
+    private lastTickAt;
+    private stats;
+    private tokenUsage;
+    private readonly strategies;
+    private activeStrategy;
+    private selfLearningService?;
+    private isDispatching;
+    isCommanderActive: boolean;
+    private readonly factory;
+    constructor(agentManager: AgentManager, eventBus: DashboardEventBus, jsonlPath: string, config?: Partial<SchedulerConfig>, promptRegistry?: PromptRegistry, journal?: ExecutionJournal | undefined, selfLearningService?: SelfLearningService);
+    /** Dispatch a single issue for execution */
+    executeIssue(issueId: string, executor?: AgentType): Promise<void>;
+    /** Enqueue multiple issues for batch execution */
+    executeBatch(issueIds: string[], executor?: AgentType, maxConcurrency?: number): Promise<void>;
+    /** Cancel a running or queued issue */
+    cancelIssue(issueId: string): Promise<void>;
+    /** Start the automatic dispatch tick loop */
+    enableAutoDispatch(): void;
+    /** @deprecated Use enableAutoDispatch() */
+    startSupervisor(): void;
+    /** Stop automatic dispatch */
+    disableAutoDispatch(): void;
+    /** @deprecated Use disableAutoDispatch() */
+    stopSupervisor(): void;
+    /** Update scheduler config */
+    updateConfig(partial: Partial<SchedulerConfig>): void;
+    /** Get a snapshot of current scheduler state */
+    getStatus(): SchedulerStatus;
+    /** Get config */
+    getConfig(): SchedulerConfig;
+    /** Get the execution slot for a given issue */
+    getSlotForIssue(issueId: string): ExecutionSlot | undefined;
+    /** Register a dispatch strategy (overwrites if name already exists). */
+    registerStrategy(strategy: DispatchStrategy): void;
+    /** Switch the active dispatch strategy by name. Throws if not registered. */
+    setStrategy(name: string): void;
+    /** Get the name of the active dispatch strategy. */
+    getActiveStrategyName(): string;
+    /** Acquire a slot for external use (e.g., WaveExecutor subtasks). Returns false if no capacity. */
+    acquireSlot(issueId: string, processId: string, executor: AgentType): boolean;
+    /** Release a slot after external use */
+    releaseSlot(processId: string): void;
+    /** Wait for a slot to become available, with timeout. Resolves true if acquired, false on timeout. */
+    waitForSlot(issueId: string, processId: string, executor: AgentType, timeoutMs?: number): Promise<boolean>;
+    /** Clean shutdown */
+    destroy(): Promise<void>;
+    /** Atomically claim an issue. Returns true if successfully claimed. */
+    private claim;
+    /** Recover in-memory state from persisted JSONL on startup */
+    private recoverState;
+    private dispatch;
+    /**
+     * Chain-based dispatch — routes issue execution through a GraphWalker chain.
+     * The chain (e.g., 'issue-lifecycle') defines the multi-step execution flow.
+     */
+    private dispatchViaChain;
+    private buildPrompt;
+    /** Inline fallback — preserves original logic for backward compatibility */
+    private buildPromptFallback;
+    /** Simple variable substitution for custom prompt templates */
+    private applyTemplate;
+    private subscribeToAgentEvents;
+    private handleAgentStopped;
+    /**
+     * Handle turn/completed notification from a codex-server agent.
+     * The process is still alive — attempt continuation or complete.
+     */
+    private handleTurnCompleted;
+    private handleCompletion;
+    /** Extract structured result from agent entry history */
+    private extractResult;
+    private handleFailure;
+    /**
+     * Attempt to continue a codex-server agent for another turn.
+     * Returns true if continuation was initiated; false if normal completion should proceed.
+     */
+    private attemptContinuation;
+    /** Build a continuation prompt for multi-turn execution */
+    private buildContinuationPrompt;
+    private tick;
+    /** Delegate issue selection to the active strategy and execute returned decisions. */
+    private dispatchViaStrategy;
+    /**
+     * Reconcile running slots against persisted issue state.
+     * If an issue was externally resolved or closed, stop its agent.
+     */
+    private reconcileRunningIssues;
+    private detectStalls;
+    private processRetries;
+    /** @deprecated Superseded by PriorityStrategy via dispatchViaStrategy(). Kept for reference. */
+    private autoDispatchByPriority;
+    /**
+     * @deprecated Superseded by SmartStrategy via dispatchViaStrategy(). Kept for reference.
+     *
+     * Smart strategy: priority + executor affinity + failure avoidance.
+     * - Prioritize issues matching idle executor types (spread load across agents)
+     * - Deprioritize issue types that have recently failed
+     */
+    private autoDispatchSmart;
+    private dispatchNext;
+    private findIssue;
+    /** Atomically update multiple fields on an issue in a single read-modify-write */
+    private updateIssueFields;
+    private emitStatus;
+}