raptor-aios 0.1.0

package/dist/_core/dist/workflows/parser.js

@@ -0,0 +1,386 @@
+/**
+ * Workflow Parser — loads and validates workflow.yml files.
+ *
+ * Parses the declarative YAML into a strongly-typed WorkflowDefinition.
+ * Uses the same minimal YAML approach as agents.yml (no external deps).
+ *
+ * Blueprint ref: 05 §2 — "Forma canônica: workflow.yml".
+ */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { join, basename, dirname } from "node:path";
+import { WORKFLOW_SCHEMA_V1 } from "./types.js";
+// ---------------------------------------------------------------------------
+// Parser errors
+// ---------------------------------------------------------------------------
+export class WorkflowParseError extends Error {
+    path;
+    constructor(message, path) {
+        super(path ? `[${path}] ${message}` : message);
+        this.path = path;
+        this.name = "WorkflowParseError";
+    }
+}
+function parseYamlLines(raw) {
+    const lines = raw.split("\n");
+    const roots = [];
+    const stack = [];
+    for (const rawLine of lines) {
+        const line = rawLine.replace(/\r$/, "");
+        if (line.trim() === "" || line.trim().startsWith("#"))
+            continue;
+        const indent = line.length - line.trimStart().length;
+        const trimmed = line.trim();
+        const isList = trimmed.startsWith("- ");
+        const content = isList ? trimmed.slice(2) : trimmed;
+        let key = "";
+        let value = "";
+        const colonIdx = content.indexOf(":");
+        if (colonIdx !== -1) {
+            key = content.slice(0, colonIdx).trim();
+            value = content
+                .slice(colonIdx + 1)
+                .trim()
+                .replace(/^["']|["']$/g, "");
+        }
+        else {
+            value = content.replace(/^["']|["']$/g, "");
+        }
+        const node = { indent, key, value, children: [], isList };
+        // Find parent
+        while (stack.length > 0 && stack[stack.length - 1].indent >= indent) {
+            stack.pop();
+        }
+        if (stack.length > 0) {
+            stack[stack.length - 1].node.children.push(node);
+        }
+        else {
+            roots.push(node);
+        }
+        stack.push({ node, indent });
+    }
+    return roots;
+}
+function findNode(nodes, key) {
+    return nodes.find((n) => n.key === key);
+}
+function getScalar(nodes, key, fallback = "") {
+    const node = findNode(nodes, key);
+    return node?.value ?? fallback;
+}
+function getList(nodes, key) {
+    const node = findNode(nodes, key);
+    if (!node)
+        return [];
+    if (node.value.startsWith("[")) {
+        return node.value
+            .replace(/[\[\]]/g, "")
+            .split(",")
+            .map((s) => s.trim().replace(/^["']|["']$/g, ""))
+            .filter(Boolean);
+    }
+    return node.children
+        .filter((c) => c.isList)
+        .map((c) => (c.key || c.value).replace(/^["']|["']$/g, ""));
+}
+// ---------------------------------------------------------------------------
+// Step parsing
+// ---------------------------------------------------------------------------
+function parseStep(node) {
+    const children = [node, ...node.children];
+    const allNodes = node.children;
+    const id = getScalar(children, "id") || node.key || "";
+    const rawType = getScalar(allNodes, "type") || "";
+    const command = getScalar(allNodes, "command");
+    const when = getScalar(allNodes, "when") || undefined;
+    const title = getScalar(allNodes, "title") || undefined;
+    // Infer type from fields
+    let type = rawType || "command";
+    if (!rawType && command)
+        type = "command";
+    if (rawType === "gate")
+        type = "gate";
+    if (rawType === "shell")
+        type = "shell";
+    if (rawType === "prompt")
+        type = "prompt";
+    if (rawType === "if")
+        type = "if";
+    if (rawType === "while")
+        type = "while";
+    const base = { id, type, when, title };
+    switch (type) {
+        case "command": {
+            const step = {
+                ...base,
+                type: "command",
+                command: command || getScalar(allNodes, "command"),
+                agent: getScalar(allNodes, "agent") || undefined,
+            };
+            const inputNode = findNode(allNodes, "input");
+            if (inputNode && inputNode.children.length > 0) {
+                step.input = {};
+                for (const c of inputNode.children) {
+                    if (c.key)
+                        step.input[c.key] = c.value;
+                }
+            }
+            return step;
+        }
+        case "gate": {
+            const step = {
+                ...base,
+                type: "gate",
+                message: getScalar(allNodes, "message"),
+                options: getList(allNodes, "options"),
+                onReject: (getScalar(allNodes, "on_reject") || "abort"),
+                gotoStep: getScalar(allNodes, "goto_step") || undefined,
+                artifacts: getList(allNodes, "artifacts"),
+            };
+            if (step.artifacts?.length === 0)
+                step.artifacts = undefined;
+            return step;
+        }
+        case "shell": {
+            const step = {
+                ...base,
+                type: "shell",
+                run: getScalar(allNodes, "run"),
+                cwd: getScalar(allNodes, "cwd") || undefined,
+            };
+            return step;
+        }
+        case "prompt": {
+            const step = {
+                ...base,
+                type: "prompt",
+                message: getScalar(allNodes, "message"),
+                resultVar: getScalar(allNodes, "result_var") || getScalar(allNodes, "resultVar"),
+            };
+            return step;
+        }
+        case "if": {
+            const step = {
+                ...base,
+                type: "if",
+                condition: getScalar(allNodes, "condition"),
+                then: [],
+                else: undefined,
+            };
+            const thenNode = findNode(allNodes, "then");
+            if (thenNode) {
+                step.then = thenNode.children.filter((c) => c.isList).map(parseStep);
+            }
+            const elseNode = findNode(allNodes, "else");
+            if (elseNode) {
+                step.else = elseNode.children.filter((c) => c.isList).map(parseStep);
+            }
+            return step;
+        }
+        case "while": {
+            const step = {
+                ...base,
+                type: "while",
+                condition: getScalar(allNodes, "condition"),
+                do: [],
+                maxIterations: Number(getScalar(allNodes, "max_iterations")) || 10,
+            };
+            const doNode = findNode(allNodes, "do");
+            if (doNode) {
+                step.do = doNode.children.filter((c) => c.isList).map(parseStep);
+            }
+            return step;
+        }
+        default:
+            return { ...base, type };
+    }
+}
+// ---------------------------------------------------------------------------
+// Input parsing
+// ---------------------------------------------------------------------------
+function parseInput(node) {
+    const allNodes = node.children;
+    const name = node.key || getScalar(allNodes, "name") || getScalar([node], "name");
+    return {
+        name: name || getScalar(allNodes, "id") || "",
+        type: (getScalar(allNodes, "type") || "string"),
+        required: getScalar(allNodes, "required") === "true",
+        default: getScalar(allNodes, "default") || undefined,
+        prompt: getScalar(allNodes, "prompt") || undefined,
+        choices: getList(allNodes, "choices"),
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Parse a workflow YAML string into a WorkflowDefinition.
+ */
+export function parseWorkflow(raw, sourcePath) {
+    const roots = parseYamlLines(raw);
+    // Schema
+    const schema = getScalar(roots, "schema") ||
+        getScalar(roots, "schema_version") ||
+        WORKFLOW_SCHEMA_V1;
+    // Workflow metadata
+    const wfNode = findNode(roots, "workflow");
+    const wfChildren = wfNode?.children ?? [];
+    const workflow = {
+        id: getScalar(wfChildren, "id") || basename(dirname(sourcePath ?? "unknown")),
+        name: getScalar(wfChildren, "name") || "Unnamed Workflow",
+        version: getScalar(wfChildren, "version") || "1.0.0",
+        author: getScalar(wfChildren, "author") || undefined,
+        description: getScalar(wfChildren, "description") || undefined,
+    };
+    // Requires
+    const reqNode = findNode(roots, "requires");
+    let requires;
+    if (reqNode) {
+        requires = {
+            raptorVersion: getScalar(reqNode.children, "raptor_version") || undefined,
+        };
+        const agentsNode = findNode(reqNode.children, "agents");
+        if (agentsNode) {
+            requires.agents = {
+                any: getList(agentsNode.children, "any"),
+                all: getList(agentsNode.children, "all"),
+            };
+        }
+    }
+    // Inputs
+    const inputsNode = findNode(roots, "inputs");
+    const inputs = [];
+    if (inputsNode) {
+        for (const child of inputsNode.children) {
+            inputs.push(parseInput(child));
+        }
+    }
+    // Steps
+    const stepsNode = findNode(roots, "steps");
+    const steps = [];
+    if (stepsNode) {
+        for (const child of stepsNode.children) {
+            if (child.isList) {
+                steps.push(parseStep(child));
+            }
+        }
+    }
+    return {
+        schema: schema,
+        workflow,
+        requires,
+        inputs,
+        steps,
+    };
+}
+/**
+ * Load a workflow from disk.
+ */
+export function loadWorkflow(path) {
+    if (!existsSync(path)) {
+        throw new WorkflowParseError(`Workflow file not found: ${path}`, path);
+    }
+    const raw = readFileSync(path, "utf8");
+    return parseWorkflow(raw, path);
+}
+/**
+ * Discover all workflows in a directory.
+ * Scans for `workflow.yml` files in subdirectories.
+ */
+export function discoverWorkflows(dir) {
+    if (!existsSync(dir))
+        return [];
+    const results = [];
+    try {
+        for (const entry of readdirSync(dir, { withFileTypes: true })) {
+            if (!entry.isDirectory()) {
+                // Top-level .yml files
+                if (entry.name.endsWith(".yml") || entry.name.endsWith(".yaml")) {
+                    results.push({
+                        id: entry.name.replace(/\.ya?ml$/, ""),
+                        path: join(dir, entry.name),
+                    });
+                }
+                continue;
+            }
+            const candidate = join(dir, entry.name, "workflow.yml");
+            if (existsSync(candidate)) {
+                results.push({ id: entry.name, path: candidate });
+            }
+        }
+    }
+    catch {
+        // Directory not readable
+    }
+    return results;
+}
+/**
+ * Validate a parsed WorkflowDefinition for semantic correctness.
+ */
+export function validateWorkflow(def) {
+    const errors = [];
+    // Workflow metadata
+    if (!def.workflow.id) {
+        errors.push({ field: "workflow.id", message: "Workflow ID is required." });
+    }
+    if (!def.workflow.name) {
+        errors.push({
+            field: "workflow.name",
+            message: "Workflow name is required.",
+        });
+    }
+    // Steps
+    if (def.steps.length === 0) {
+        errors.push({ field: "steps", message: "At least one step is required." });
+    }
+    // Unique step IDs
+    const stepIds = new Set();
+    for (const step of def.steps) {
+        if (!step.id) {
+            errors.push({ field: "steps", message: "Every step must have an id." });
+            continue;
+        }
+        if (stepIds.has(step.id)) {
+            errors.push({
+                field: `steps.${step.id}`,
+                message: `Duplicate step id "${step.id}".`,
+            });
+        }
+        stepIds.add(step.id);
+        // Type-specific validation
+        if (step.type === "command") {
+            const cs = step;
+            if (!cs.command) {
+                errors.push({
+                    field: `steps.${step.id}.command`,
+                    message: "Command step requires a command.",
+                });
+            }
+        }
+        if (step.type === "gate") {
+            const gs = step;
+            if (!gs.message) {
+                errors.push({
+                    field: `steps.${step.id}.message`,
+                    message: "Gate step requires a message.",
+                });
+            }
+            if (!gs.options || gs.options.length === 0) {
+                errors.push({
+                    field: `steps.${step.id}.options`,
+                    message: "Gate step requires at least one option.",
+                });
+            }
+        }
+        if (step.type === "shell") {
+            const ss = step;
+            if (!ss.run) {
+                errors.push({
+                    field: `steps.${step.id}.run`,
+                    message: "Shell step requires a run command.",
+                });
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=parser.js.map

package/dist/_core/dist/workflows/parser.js.map

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

package/dist/_core/dist/workflows/sdd-flow.d.ts

@@ -0,0 +1,85 @@
+/**
+ * SDD Flow Runtime — Executes the end-to-end artifact chain.
+ *
+ * Provides the runtime engine that orchestrates the SDD lifecycle
+ * steps (specify → plan → tasks → implement) with hook execution
+ * and gate enforcement.
+ *
+ * Spec Kit ref: E09 — "Fluxo completo SDD (runtime)"
+ */
+export type SDDPhase = "specify" | "clarify" | "plan" | "tasks" | "implement" | "done";
+export interface SDDWorkflowStep {
+    id: string;
+    command: string;
+    description?: string;
+    gate?: {
+        type: "none" | "approval" | "conditional";
+        message?: string;
+        condition?: string;
+        options?: string[];
+    };
+    on_reject?: "retry" | "abort";
+    on_failure?: "abort" | "skip";
+}
+export interface SDDWorkflowDefinition {
+    schema: string;
+    id: string;
+    name: string;
+    description?: string;
+    version?: string;
+    steps: SDDWorkflowStep[];
+}
+export interface StepResult {
+    stepId: string;
+    phase: string;
+    status: "completed" | "skipped" | "failed" | "blocked" | "pending_approval";
+    hookResults?: {
+        pre: {
+            success: boolean;
+            count: number;
+        };
+        post: {
+            success: boolean;
+            count: number;
+        };
+    };
+    gateResult?: {
+        type: string;
+        passed: boolean;
+        message?: string;
+    };
+    error?: string;
+    duration_ms: number;
+}
+/**
+ * Parse a workflow YAML file into a WorkflowDefinition.
+ *
+ * Uses a lightweight line-based parser (no YAML dependency).
+ */
+export declare function parseSDDWorkflow(yamlContent: string): SDDWorkflowDefinition;
+/**
+ * Load the default workflow from the project.
+ */
+export declare function loadDefaultWorkflow(projectRoot: string): SDDWorkflowDefinition | undefined;
+/**
+ * Validate prerequisites for a workflow step.
+ *
+ * Returns missing artifacts that block the step.
+ */
+export declare function validateStepPrerequisites(projectRoot: string, step: SDDWorkflowStep, featureDirectory: string): string[];
+/**
+ * Execute a single workflow step with hooks and gate enforcement.
+ *
+ * This does NOT run the actual agent command — that's done by the agent.
+ * Instead, it:
+ *   1. Runs pre-hooks
+ *   2. Checks prerequisites
+ *   3. Validates phase transition
+ *   4. Updates state
+ *   5. Runs post-hooks
+ *   6. Returns the step result for gate evaluation
+ */
+export declare function executeStep(projectRoot: string, step: SDDWorkflowStep, featureDirectory: string, options?: {
+    dryRun?: boolean;
+}): StepResult;
+//# sourceMappingURL=sdd-flow.d.ts.map

package/dist/_core/dist/workflows/sdd-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdd-flow.d.ts","sourceRoot":"","sources":["../../src/workflows/sdd-flow.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqBH,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,SAAS,GACT,MAAM,GACN,OAAO,GACP,WAAW,GACX,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;QAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,kBAAkB,CAAC;IAC5E,WAAW,CAAC,EAAE;QACZ,GAAG,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;QACzC,IAAI,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3C,CAAC;IACF,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,qBAAqB,CA2E3E;AAgBD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,GAClB,qBAAqB,GAAG,SAAS,CAanC;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,eAAe,EACrB,gBAAgB,EAAE,MAAM,GACvB,MAAM,EAAE,CAIV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,eAAe,EACrB,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,UAAU,CA+HZ"}