maestro-flow 0.1.0

package/dist/coordinator/graph-loader.js

@@ -0,0 +1,190 @@
+// ---------------------------------------------------------------------------
+// Graph Loader — loads, validates, and caches ChainGraph JSON files.
+// ---------------------------------------------------------------------------
+import { readFileSync, statSync, readdirSync } from 'node:fs';
+import { readFile, stat } from 'node:fs/promises';
+import { join, relative, sep } from 'node:path';
+// ---------------------------------------------------------------------------
+// Error
+// ---------------------------------------------------------------------------
+export class GraphValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GraphValidationError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Validation helpers
+// ---------------------------------------------------------------------------
+const REQUIRED_FIELDS = ['id', 'name', 'version', 'entry', 'nodes'];
+function validateGraph(raw, filePath) {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new GraphValidationError(`Invalid graph structure in ${filePath}: expected an object`);
+    }
+    const obj = raw;
+    for (const field of REQUIRED_FIELDS) {
+        if (!(field in obj) || obj[field] === undefined) {
+            throw new GraphValidationError(`Missing required field "${field}" in ${filePath}`);
+        }
+    }
+    if (typeof obj.nodes !== 'object' || obj.nodes === null || Array.isArray(obj.nodes)) {
+        throw new GraphValidationError(`"nodes" must be an object in ${filePath}`);
+    }
+    const nodes = obj.nodes;
+    const nodeIds = new Set(Object.keys(nodes));
+    // entry must exist
+    const entry = obj.entry;
+    if (!nodeIds.has(entry)) {
+        throw new GraphValidationError(`Entry node "${entry}" not found in nodes of ${filePath}`);
+    }
+    // Validate all node references
+    for (const [nodeId, node] of Object.entries(nodes)) {
+        if (node === null || typeof node !== 'object')
+            continue;
+        const n = node;
+        validateNodeRefs(nodeId, n, nodeIds, filePath);
+    }
+    return raw;
+}
+function validateNodeRefs(nodeId, node, nodeIds, filePath) {
+    const check = (field, target) => {
+        if (!nodeIds.has(target)) {
+            throw new GraphValidationError(`Node "${nodeId}" references non-existent node "${target}" via "${field}" in ${filePath}`);
+        }
+    };
+    // next (command, join, eval)
+    if (typeof node.next === 'string')
+        check('next', node.next);
+    // on_failure (command)
+    if (typeof node.on_failure === 'string')
+        check('on_failure', node.on_failure);
+    // on_pass / on_fail (gate)
+    if (typeof node.on_pass === 'string')
+        check('on_pass', node.on_pass);
+    if (typeof node.on_fail === 'string')
+        check('on_fail', node.on_fail);
+    // edges[].target (decision)
+    if (Array.isArray(node.edges)) {
+        for (const edge of node.edges) {
+            if (edge && typeof edge === 'object' && typeof edge.target === 'string') {
+                check('edges[].target', edge.target);
+            }
+        }
+    }
+    // branches + join (fork)
+    if (Array.isArray(node.branches)) {
+        for (const branch of node.branches) {
+            if (typeof branch === 'string')
+                check('branches[]', branch);
+        }
+    }
+    if (node.type === 'fork' && typeof node.join === 'string') {
+        check('join', node.join);
+    }
+}
+// ---------------------------------------------------------------------------
+// GraphLoader
+// ---------------------------------------------------------------------------
+export class GraphLoader {
+    chainsRoot;
+    cache = new Map();
+    constructor(chainsRoot) {
+        this.chainsRoot = chainsRoot;
+    }
+    async load(graphId) {
+        const filePath = this.resolvePath(graphId);
+        // Check mtime for cache
+        let fileStat;
+        try {
+            fileStat = await stat(filePath);
+        }
+        catch {
+            throw new GraphValidationError(`Graph file not found: ${filePath}`);
+        }
+        const mtime = fileStat.mtimeMs;
+        const cached = this.cache.get(filePath);
+        if (cached && cached.mtime === mtime) {
+            return cached.graph;
+        }
+        let content;
+        try {
+            content = await readFile(filePath, 'utf-8');
+        }
+        catch {
+            throw new GraphValidationError(`Failed to read graph file: ${filePath}`);
+        }
+        const graph = this.parseAndValidate(content, filePath);
+        this.cache.set(filePath, { graph, mtime });
+        return graph;
+    }
+    loadSync(graphId) {
+        const filePath = this.resolvePath(graphId);
+        let fileStat;
+        try {
+            fileStat = statSync(filePath);
+        }
+        catch {
+            throw new GraphValidationError(`Graph file not found: ${filePath}`);
+        }
+        const mtime = fileStat.mtimeMs;
+        const cached = this.cache.get(filePath);
+        if (cached && cached.mtime === mtime) {
+            return cached.graph;
+        }
+        let content;
+        try {
+            content = readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            throw new GraphValidationError(`Failed to read graph file: ${filePath}`);
+        }
+        const graph = this.parseAndValidate(content, filePath);
+        this.cache.set(filePath, { graph, mtime });
+        return graph;
+    }
+    listAll() {
+        const results = [];
+        this.walkDir(this.chainsRoot, results);
+        return results.sort();
+    }
+    // -------------------------------------------------------------------------
+    // Private
+    // -------------------------------------------------------------------------
+    resolvePath(graphId) {
+        return join(this.chainsRoot, `${graphId}.json`);
+    }
+    parseAndValidate(content, filePath) {
+        let raw;
+        try {
+            raw = JSON.parse(content);
+        }
+        catch {
+            throw new GraphValidationError(`Invalid JSON in ${filePath}`);
+        }
+        return validateGraph(raw, filePath);
+    }
+    walkDir(dir, results) {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.name.startsWith('_'))
+                continue;
+            const fullPath = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                this.walkDir(fullPath, results);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.json')) {
+                const rel = relative(this.chainsRoot, fullPath);
+                // Convert to forward-slash graph ID without .json
+                const graphId = rel.replace(/\.json$/, '').split(sep).join('/');
+                results.push(graphId);
+            }
+        }
+    }
+}
+//# sourceMappingURL=graph-loader.js.map

package/dist/coordinator/graph-loader.js.map

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

package/dist/coordinator/graph-types.d.ts

@@ -0,0 +1,287 @@
+export interface ChainGraph {
+    $schema?: string;
+    id: string;
+    name: string;
+    description?: string;
+    version: string;
+    tags?: string[];
+    entry: string;
+    inputs?: Record<string, GraphInput>;
+    nodes: Record<string, GraphNode>;
+    defaults?: GraphDefaults;
+}
+export interface GraphInput {
+    type: 'string' | 'number' | 'boolean';
+    required?: boolean;
+    default?: string | number | boolean;
+    description?: string;
+}
+export interface GraphDefaults {
+    timeout_ms?: number;
+    analyze?: boolean;
+    max_visits?: number;
+    auto_flag?: string;
+}
+export type GraphNode = CommandNode | DecisionNode | GateNode | ForkNode | JoinNode | EvalNode | TerminalNode;
+export interface CommandNode {
+    type: 'command';
+    cmd: string;
+    args?: string;
+    description?: string;
+    auto_flag?: string;
+    next: string;
+    on_failure?: string;
+    max_visits?: number;
+    timeout_ms?: number;
+    analyze?: boolean;
+    extract?: Record<string, ExtractionRule>;
+}
+export interface ExtractionRule {
+    strategy: 'regex' | 'json_path' | 'line_match';
+    pattern: string;
+    target: string;
+}
+export interface DecisionNode {
+    type: 'decision';
+    strategy?: 'expr' | 'llm';
+    eval?: string;
+    prompt?: string;
+    context_keys?: string[];
+    edges: DecisionEdge[];
+}
+export interface DecisionEdge {
+    value?: string | number | boolean;
+    match?: string;
+    label?: string;
+    default?: boolean;
+    target: string;
+    description?: string;
+}
+export interface GateNode {
+    type: 'gate';
+    condition: string;
+    on_pass: string;
+    on_fail: string;
+    wait?: boolean;
+    wait_message?: string;
+}
+export interface ForkNode {
+    type: 'fork';
+    branches: string[];
+    join: string;
+}
+export interface JoinNode {
+    type: 'join';
+    strategy: 'all' | 'any' | 'majority';
+    next: string;
+    merge?: 'concat' | 'last' | 'best_score';
+}
+export interface EvalNode {
+    type: 'eval';
+    set: Record<string, string>;
+    next: string;
+}
+export interface TerminalNode {
+    type: 'terminal';
+    status: 'success' | 'failure' | 'paused' | 'delegate';
+    delegate_graph?: string;
+    delegate_inputs?: Record<string, string>;
+    summary?: string;
+}
+export type WalkerStatus = 'running' | 'waiting_command' | 'waiting_gate' | 'waiting_fork' | 'step_paused' | 'paused' | 'completed' | 'failed';
+export interface WalkerState {
+    session_id: string;
+    graph_id: string;
+    current_node: string;
+    status: WalkerStatus;
+    context: WalkerContext;
+    history: HistoryEntry[];
+    fork_state: Record<string, ForkBranchState> | null;
+    delegate_stack: DelegateFrame[];
+    created_at: string;
+    updated_at: string;
+    tool: string;
+    auto_mode: boolean;
+    step_mode: boolean;
+    intent: string;
+}
+export interface WalkerContext {
+    inputs: Record<string, unknown>;
+    project: ProjectSnapshot;
+    result: Record<string, unknown> | null;
+    analysis: Record<string, unknown> | null;
+    visits: Record<string, number>;
+    var: Record<string, unknown>;
+}
+export interface ProjectSnapshot {
+    initialized: boolean;
+    current_phase: number | null;
+    phase_status: string;
+    artifacts: Record<string, boolean>;
+    execution: {
+        tasks_completed: number;
+        tasks_total: number;
+    };
+    verification_status: string;
+    review_verdict: string | null;
+    uat_status: string;
+    phases_total: number;
+    phases_completed: number;
+    accumulated_context: unknown | null;
+}
+export interface HistoryEntry {
+    node_id: string;
+    node_type: string;
+    entered_at: string;
+    exited_at?: string;
+    outcome?: 'success' | 'failure' | 'skipped';
+    exec_id?: string;
+    quality_score?: number;
+    summary?: string;
+}
+export interface ForkBranchState {
+    branches: Record<string, 'pending' | 'running' | 'completed' | 'failed'>;
+    join_node: string;
+    results: Record<string, unknown>;
+}
+export interface DelegateFrame {
+    parent_graph_id: string;
+    parent_node_id: string;
+    return_inputs: Record<string, unknown>;
+}
+export type AgentType = 'claude-code' | 'claude' | 'codex' | 'gemini' | 'qwen' | 'opencode';
+export interface ExecuteRequest {
+    prompt: string;
+    agent_type: AgentType;
+    work_dir: string;
+    approval_mode: 'suggest' | 'auto';
+    timeout_ms: number;
+    node_id: string;
+    cmd: string;
+}
+export interface ExecuteResult {
+    success: boolean;
+    raw_output: string;
+    exec_id: string;
+    duration_ms: number;
+    process_id?: string;
+}
+export interface CommandExecutor {
+    execute(request: ExecuteRequest): Promise<ExecuteResult>;
+    abort(): Promise<void>;
+}
+export interface AssembleRequest {
+    node: CommandNode;
+    node_id: string;
+    context: WalkerContext;
+    graph: {
+        id: string;
+        name: string;
+    };
+    command_index: number;
+    command_total: number;
+    auto_mode: boolean;
+    previous_command?: {
+        node_id: string;
+        cmd: string;
+        outcome: 'success' | 'failure';
+        summary?: string;
+    };
+}
+export interface PromptAssembler {
+    assemble(request: AssembleRequest): Promise<string>;
+}
+export interface ExprEvaluator {
+    resolve(expr: string, ctx: WalkerContext): unknown;
+    evaluate(expr: string, ctx: WalkerContext): boolean;
+    match(edge: DecisionEdge, resolvedValue: unknown, ctx: WalkerContext): boolean;
+}
+export interface ParsedResult {
+    structured: {
+        status: 'SUCCESS' | 'FAILURE';
+        phase: string | null;
+        verification_status: string | null;
+        review_verdict: string | null;
+        uat_status: string | null;
+        artifacts: string[];
+        summary: string;
+        [key: string]: unknown;
+    };
+}
+export interface OutputParser {
+    parse(rawOutput: string, node: CommandNode): ParsedResult;
+}
+export interface AnalysisResult {
+    quality_score: number;
+    issues: string[];
+    next_step_hints: {
+        prompt_additions?: string;
+        cautions?: string[];
+        context_to_carry?: string;
+    };
+}
+export interface StepAnalyzer {
+    analyze(node: CommandNode, rawOutput: string, ctx: WalkerContext, prevCmd?: AssembleRequest['previous_command']): Promise<AnalysisResult>;
+}
+export type CoordinateEvent = {
+    type: 'walker:started';
+    session_id: string;
+    graph_id: string;
+    intent: string;
+} | {
+    type: 'walker:node_enter';
+    session_id: string;
+    node_id: string;
+    node_type: string;
+} | {
+    type: 'walker:node_exit';
+    session_id: string;
+    node_id: string;
+    outcome: string;
+} | {
+    type: 'walker:decision';
+    session_id: string;
+    node_id: string;
+    resolved_value: unknown;
+    target: string;
+} | {
+    type: 'walker:command';
+    session_id: string;
+    node_id: string;
+    cmd: string;
+    status: 'spawned' | 'completed' | 'failed';
+} | {
+    type: 'walker:delegate';
+    session_id: string;
+    from_graph: string;
+    to_graph: string;
+} | {
+    type: 'walker:completed';
+    session_id: string;
+    status: 'success' | 'failure';
+    history_summary: string[];
+} | {
+    type: 'walker:error';
+    session_id: string;
+    error: string;
+};
+export interface WalkerEventEmitter {
+    emit(event: CoordinateEvent): void;
+}
+export interface IntentPattern {
+    type: string;
+    regex: string;
+    flags?: string;
+    route: IntentRoute;
+}
+export interface IntentRoute {
+    graph?: string;
+    strategy?: 'state_router';
+}
+export interface IntentMap {
+    $schema?: string;
+    version: string;
+    patterns: IntentPattern[];
+    fallback: IntentRoute;
+}
+//# sourceMappingURL=graph-types.d.ts.map

package/dist/coordinator/graph-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.d.ts","sourceRoot":"","sources":["../../src/coordinator/graph-types.ts"],"names":[],"mappings":"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"}

package/dist/coordinator/graph-types.js

@@ -0,0 +1,6 @@
+// ---------------------------------------------------------------------------
+// Graph Coordinator — Type Definitions
+// Pure types, zero runtime. All graph/walker/executor/assembler interfaces.
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=graph-types.js.map

package/dist/coordinator/graph-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-types.js","sourceRoot":"","sources":["../../src/coordinator/graph-types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uCAAuC;AACvC,4EAA4E;AAC5E,8EAA8E"}

package/dist/coordinator/graph-walker.d.ts

@@ -0,0 +1,49 @@
+import type { ChainGraph, WalkerState, CommandExecutor, PromptAssembler, ExprEvaluator, OutputParser, StepAnalyzer, WalkerEventEmitter } from './graph-types.js';
+import type { GraphLoader } from './graph-loader.js';
+export interface StartOptions {
+    tool: string;
+    autoMode: boolean;
+    dryRun?: boolean;
+    stepMode?: boolean;
+    workflowRoot: string;
+    inputs?: Record<string, unknown>;
+}
+export declare class GraphWalker {
+    private readonly loader;
+    private readonly assembler;
+    private readonly executor;
+    private readonly analyzer;
+    private readonly outputParser;
+    private readonly evaluator;
+    private readonly emitter?;
+    private readonly sessionDir?;
+    private activeState;
+    constructor(loader: GraphLoader, assembler: PromptAssembler, executor: CommandExecutor, analyzer: StepAnalyzer | null, outputParser: OutputParser, evaluator: ExprEvaluator, emitter?: WalkerEventEmitter | undefined, sessionDir?: string | undefined);
+    start(graphId: string, intent: string, options: StartOptions): Promise<WalkerState>;
+    resume(sessionId?: string): Promise<WalkerState>;
+    /** Load session state without executing — for status queries. */
+    getState(sessionId?: string): WalkerState;
+    /** Continue a step_paused session — execute next command node, then pause again. */
+    next(sessionId?: string): Promise<WalkerState>;
+    stop(): Promise<void>;
+    walkGraph(state: WalkerState, graph: ChainGraph): Promise<WalkerState>;
+    private walk;
+    private handleCommand;
+    private handleDecision;
+    private handleGate;
+    private handleEval;
+    private handleFork;
+    private handleJoin;
+    private handleTerminal;
+    private countCommandNodes;
+    private countCommandsBefore;
+    private findPreviousCommand;
+    private setContextValue;
+    private resolveTemplate;
+    private buildInitialContext;
+    private save;
+    private loadState;
+    private dryRunWalk;
+    private emit;
+}
+//# sourceMappingURL=graph-walker.d.ts.map

package/dist/coordinator/graph-walker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-walker.d.ts","sourceRoot":"","sources":["../../src/coordinator/graph-walker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,UAAU,EACwB,WAAW,EACd,eAAe,EAAE,eAAe,EAC/D,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAE9D,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAV9B,OAAO,CAAC,WAAW,CAA4B;gBAG5B,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,eAAe,EAC1B,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE,kBAAkB,YAAA,EAC5B,UAAU,CAAC,EAAE,MAAM,YAAA;IAGhC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA+BnF,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQtD,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW;IAIzC,oFAAoF;IAC9E,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAW9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;YAM9D,IAAI;YA6EJ,aAAa;IAyE3B,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,UAAU;YAQJ,UAAU;IAaxB,OAAO,CAAC,UAAU;YAKJ,cAAc;IA+D5B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,eAAe;IA4BvB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,SAAS;IA8BjB,OAAO,CAAC,UAAU;IA4BlB,OAAO,CAAC,IAAI;CAGb"}