raptor-aios 0.1.0

package/dist/_core/dist/workflows/sdd-flow.js

@@ -0,0 +1,269 @@
+/**
+ * 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)"
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { executeHooks, allHooksPassed } from "../hooks/runtime.js";
+import { isValidTransition, readFeatureState, writeFeatureState, checkArtifactPresence, } from "../prompts/resumption.js";
+import { logPhaseTransition, logGateEvent, } from "../prompts/audit-log.js";
+// ---------------------------------------------------------------------------
+// Workflow parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parse a workflow YAML file into a WorkflowDefinition.
+ *
+ * Uses a lightweight line-based parser (no YAML dependency).
+ */
+export function parseSDDWorkflow(yamlContent) {
+    const lines = yamlContent.split("\n");
+    const def = { steps: [] };
+    let currentStep = null;
+    let inSteps = false;
+    let inGate = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Top-level fields
+        if (!inSteps) {
+            if (trimmed.startsWith("schema:")) {
+                def.schema = extractValue(trimmed);
+            }
+            else if (trimmed.startsWith("id:")) {
+                def.id = extractValue(trimmed);
+            }
+            else if (trimmed.startsWith("name:")) {
+                def.name = extractValue(trimmed);
+            }
+            else if (trimmed.startsWith("description:")) {
+                def.description = extractValue(trimmed);
+            }
+            else if (trimmed.startsWith("version:")) {
+                def.version = extractValue(trimmed);
+            }
+            else if (trimmed === "steps:") {
+                inSteps = true;
+            }
+            continue;
+        }
+        // Steps section
+        if (trimmed.startsWith("- id:")) {
+            // Save previous step
+            if (currentStep?.id) {
+                def.steps.push(currentStep);
+            }
+            currentStep = { id: extractValue(trimmed.replace("- ", "")) };
+            inGate = false;
+            continue;
+        }
+        if (currentStep) {
+            if (trimmed.startsWith("command:")) {
+                currentStep.command = extractValue(trimmed);
+            }
+            else if (trimmed.startsWith("description:")) {
+                currentStep.description = extractValue(trimmed);
+            }
+            else if (trimmed.startsWith("on_reject:")) {
+                currentStep.on_reject = extractValue(trimmed);
+            }
+            else if (trimmed.startsWith("on_failure:")) {
+                currentStep.on_failure = extractValue(trimmed);
+            }
+            else if (trimmed === "gate:") {
+                currentStep.gate = { type: "none" };
+                inGate = true;
+            }
+            else if (inGate) {
+                if (trimmed.startsWith("type:")) {
+                    currentStep.gate.type = extractValue(trimmed);
+                }
+                else if (trimmed.startsWith("message:")) {
+                    currentStep.gate.message = extractValue(trimmed);
+                }
+                else if (trimmed.startsWith("condition:")) {
+                    currentStep.gate.condition = extractValue(trimmed);
+                }
+            }
+            // End of steps section detection
+            if (!line.startsWith(" ") && !line.startsWith("\t") && trimmed !== "" && !trimmed.startsWith("-") && !trimmed.startsWith("#")) {
+                inSteps = false;
+                inGate = false;
+            }
+        }
+    }
+    // Save last step
+    if (currentStep?.id) {
+        def.steps.push(currentStep);
+    }
+    return def;
+}
+function extractValue(field) {
+    const colonIdx = field.indexOf(":");
+    if (colonIdx === -1)
+        return field;
+    let val = field.slice(colonIdx + 1).trim();
+    if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+        val = val.slice(1, -1);
+    }
+    return val;
+}
+// ---------------------------------------------------------------------------
+// Workflow execution
+// ---------------------------------------------------------------------------
+/**
+ * Load the default workflow from the project.
+ */
+export function loadDefaultWorkflow(projectRoot) {
+    const paths = [
+        join(projectRoot, ".raptor", "workflows", "raptor", "workflow.yml"),
+        join(projectRoot, "workflows", "raptor", "workflow.yml"),
+    ];
+    for (const p of paths) {
+        if (existsSync(p)) {
+            return parseSDDWorkflow(readFileSync(p, "utf-8"));
+        }
+    }
+    return undefined;
+}
+/**
+ * Validate prerequisites for a workflow step.
+ *
+ * Returns missing artifacts that block the step.
+ */
+export function validateStepPrerequisites(projectRoot, step, featureDirectory) {
+    const phaseId = step.id;
+    const presence = checkArtifactPresence(projectRoot, featureDirectory);
+    return presence.missingForPhase[phaseId] ?? [];
+}
+/**
+ * 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 function executeStep(projectRoot, step, featureDirectory, options) {
+    const start = Date.now();
+    const phaseId = step.id;
+    // 1. Pre-hooks
+    const preHooks = executeHooks(projectRoot, `pre-${phaseId}`, {
+        dryRun: options?.dryRun,
+    });
+    if (!allHooksPassed(preHooks)) {
+        return {
+            stepId: step.id,
+            phase: phaseId,
+            status: "failed",
+            hookResults: {
+                pre: { success: false, count: preHooks.length },
+                post: { success: true, count: 0 },
+            },
+            error: `Pre-hook failed for ${phaseId}`,
+            duration_ms: Date.now() - start,
+        };
+    }
+    // 2. Validate prerequisites
+    const missing = validateStepPrerequisites(projectRoot, step, featureDirectory);
+    if (missing.length > 0) {
+        return {
+            stepId: step.id,
+            phase: phaseId,
+            status: "blocked",
+            error: `Missing prerequisites: ${missing.join(", ")}`,
+            duration_ms: Date.now() - start,
+        };
+    }
+    // 3. Validate phase transition
+    const currentState = readFeatureState(projectRoot);
+    const currentPhase = currentState?.current_phase;
+    if (currentPhase && !isValidTransition(currentPhase, phaseId)) {
+        return {
+            stepId: step.id,
+            phase: phaseId,
+            status: "failed",
+            error: `Invalid transition: ${currentPhase} → ${phaseId}`,
+            duration_ms: Date.now() - start,
+        };
+    }
+    // 4. Update state (transition to new phase)
+    if (!options?.dryRun) {
+        const writeResult = writeFeatureState(projectRoot, {
+            feature_directory: featureDirectory,
+            current_phase: phaseId,
+        });
+        if (!writeResult.success) {
+            return {
+                stepId: step.id,
+                phase: phaseId,
+                status: "failed",
+                error: writeResult.error,
+                duration_ms: Date.now() - start,
+            };
+        }
+        // Log the transition
+        logPhaseTransition(projectRoot, {
+            from: currentPhase,
+            to: phaseId,
+            feature: featureDirectory,
+        });
+    }
+    // 5. Evaluate gate
+    let gateResult;
+    if (step.gate && step.gate.type !== "none") {
+        gateResult = {
+            type: step.gate.type,
+            passed: false, // Will be resolved by the calling command
+            message: step.gate.message,
+        };
+        // Log gate event
+        if (!options?.dryRun) {
+            logGateEvent(projectRoot, {
+                gateId: `${phaseId}-gate`,
+                passed: false, // Pending approval
+                feature: featureDirectory,
+                phase: phaseId,
+            });
+        }
+        return {
+            stepId: step.id,
+            phase: phaseId,
+            status: "pending_approval",
+            hookResults: {
+                pre: { success: true, count: preHooks.length },
+                post: { success: true, count: 0 },
+            },
+            gateResult,
+            duration_ms: Date.now() - start,
+        };
+    }
+    // 6. Post-hooks
+    const postHooks = executeHooks(projectRoot, `post-${phaseId}`, {
+        dryRun: options?.dryRun,
+    });
+    return {
+        stepId: step.id,
+        phase: phaseId,
+        status: "completed",
+        hookResults: {
+            pre: { success: true, count: preHooks.length },
+            post: {
+                success: allHooksPassed(postHooks),
+                count: postHooks.length,
+            },
+        },
+        gateResult: step.gate
+            ? { type: step.gate.type, passed: true }
+            : undefined,
+        duration_ms: Date.now() - start,
+    };
+}
+//# sourceMappingURL=sdd-flow.js.map

package/dist/_core/dist/workflows/sdd-flow.js.map

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

package/dist/_core/dist/workflows/types.d.ts

@@ -0,0 +1,285 @@
+/**
+ * Workflow Engine — Type definitions.
+ *
+ * Declarative workflow schema for SDD orchestration.
+ * Schema: raptor.workflow/v1.
+ *
+ * Blueprint ref: 05 — "Engine de Workflows".
+ */
+export declare const WORKFLOW_SCHEMA_V1: "raptor.workflow/v1";
+export interface WorkflowMeta {
+    /** Unique workflow identifier. */
+    id: string;
+    /** Human-readable name. */
+    name: string;
+    /** Semver version string. */
+    version: string;
+    /** Author or organization. */
+    author?: string;
+    /** Description of the workflow. */
+    description?: string;
+}
+export interface WorkflowRequires {
+    /** Minimum raptor version (semver range). */
+    raptorVersion?: string;
+    /** Required agent integrations. */
+    agents?: {
+        /** Any of these agents must be available. */
+        any?: string[];
+        /** All of these agents must be available. */
+        all?: string[];
+    };
+}
+export type WorkflowInputType = "string" | "number" | "boolean" | "choice";
+export interface WorkflowInput {
+    /** Input variable name (used in expressions as `inputs.<name>`). */
+    name: string;
+    /** Type of input value. */
+    type: WorkflowInputType;
+    /** Whether the input is required. */
+    required: boolean;
+    /** Default value if not provided. */
+    default?: unknown;
+    /** Human-readable prompt for interactive collection. */
+    prompt?: string;
+    /** Valid choices (for type: choice). */
+    choices?: string[];
+}
+export type StepType = "command" | "prompt" | "shell" | "gate" | "if" | "switch" | "while" | "do_while" | "fan_out" | "fan_in";
+export type StepStatus = "pending" | "running" | "completed" | "failed" | "skipped" | "waiting" | "aborted";
+export interface BaseStep {
+    /** Unique step identifier within this workflow. */
+    id: string;
+    /** Step type. */
+    type: StepType;
+    /** Optional human-readable title. */
+    title?: string;
+    /** Conditional: only run when expression evaluates truthy. */
+    when?: string;
+    /** Timeout in milliseconds (default: none). */
+    timeout?: number;
+    /** What to do on failure: continue, abort, retry. */
+    onError?: "continue" | "abort" | "retry";
+    /** Max retries (when onError = "retry"). */
+    maxRetries?: number;
+}
+export interface CommandStep extends BaseStep {
+    type: "command";
+    /** Raptor command to execute (e.g. "raptor.new", "raptor.plan"). */
+    command: string;
+    /** Agent to use (expression or literal). */
+    agent?: string;
+    /** Input arguments (expression or literal). */
+    input?: Record<string, string>;
+}
+export interface PromptStep extends BaseStep {
+    type: "prompt";
+    /** Message to display to the user. */
+    message: string;
+    /** Variable name to store the response in. */
+    resultVar: string;
+}
+export interface ShellStep extends BaseStep {
+    type: "shell";
+    /** Shell command to execute (expressions are resolved). */
+    run: string;
+    /** Working directory (default: project root). */
+    cwd?: string;
+    /** Additional environment variables injected into the shell process. */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds (overrides the engine default of 30s). */
+    timeout?: number;
+}
+export interface GateStep extends BaseStep {
+    type: "gate";
+    /** Message displayed to the human reviewer. */
+    message: string;
+    /** Available options (e.g. ["approve", "reject", "revise"]). */
+    options: string[];
+    /** Action when rejected. */
+    onReject: "abort" | "goto";
+    /** Step ID to jump to on reject (when onReject = "goto"). */
+    gotoStep?: string;
+    /** Artifacts to review (expressions resolved to paths). */
+    artifacts?: string[];
+}
+export interface IfStep extends BaseStep {
+    type: "if";
+    /** Condition expression. */
+    condition: string;
+    /** Steps to run when condition is truthy. */
+    then: WorkflowStep[];
+    /** Steps to run when condition is falsy. */
+    else?: WorkflowStep[];
+}
+export interface SwitchCase {
+    /** Value to match against. */
+    value: string;
+    /** Steps to execute for this case. */
+    steps: WorkflowStep[];
+}
+export interface SwitchStep extends BaseStep {
+    type: "switch";
+    /** Expression to evaluate. */
+    expression: string;
+    /** Cases to match. */
+    cases: SwitchCase[];
+    /** Default steps if no case matches. */
+    default?: WorkflowStep[];
+}
+export interface WhileStep extends BaseStep {
+    type: "while";
+    /** Loop condition expression. */
+    condition: string;
+    /** Steps to execute each iteration. */
+    do: WorkflowStep[];
+    /** Safety: max iterations (default: 10). */
+    maxIterations?: number;
+}
+export interface DoWhileStep extends BaseStep {
+    type: "do_while";
+    /** Loop condition (evaluated after each iteration). */
+    condition: string;
+    /** Steps to execute each iteration. */
+    do: WorkflowStep[];
+    /** Safety: max iterations (default: 10). */
+    maxIterations?: number;
+}
+export interface FanOutStep extends BaseStep {
+    type: "fan_out";
+    /** Expression that resolves to a list. */
+    over: string;
+    /** Variable name for each item (default: "item"). */
+    as: string;
+    /** Steps to execute per item. */
+    do: WorkflowStep[];
+}
+export interface FanInStep extends BaseStep {
+    type: "fan_in";
+    /** Aggregation strategy. */
+    strategy: "all" | "any" | "merge";
+    /** Fan-out step ID to aggregate from. */
+    from: string;
+}
+export type WorkflowStep = CommandStep | PromptStep | ShellStep | GateStep | IfStep | SwitchStep | WhileStep | DoWhileStep | FanOutStep | FanInStep;
+export interface WorkflowDefinition {
+    /** Schema version. */
+    schema: typeof WORKFLOW_SCHEMA_V1;
+    /** Workflow metadata. */
+    workflow: WorkflowMeta;
+    /** Runtime requirements. */
+    requires?: WorkflowRequires;
+    /** Input variable definitions. */
+    inputs: WorkflowInput[];
+    /** Ordered list of steps. */
+    steps: WorkflowStep[];
+}
+export interface StepState {
+    /** Step id. */
+    id: string;
+    /** Current status. */
+    status: StepStatus;
+    /** Output captured from this step. */
+    output?: unknown;
+    /** Error message if failed. */
+    error?: string;
+    /** Timestamp when step started. */
+    startedAt?: string;
+    /** Timestamp when step completed/failed. */
+    completedAt?: string;
+    /** Gate response (for gate steps). */
+    gateResponse?: string;
+    /** Number of retries attempted. */
+    retries?: number;
+}
+export interface WorkflowRunState {
+    /** Unique run ID. */
+    runId: string;
+    /** Workflow definition ID. */
+    workflowId: string;
+    /** Schema version. */
+    schema: typeof WORKFLOW_SCHEMA_V1;
+    /** Run status. */
+    status: "running" | "completed" | "failed" | "paused" | "aborted";
+    /** Resolved input values. */
+    inputs: Record<string, unknown>;
+    /** State of each step (keyed by step.id). */
+    steps: Record<string, StepState>;
+    /** Current step index in the top-level steps array. */
+    currentStepIndex: number;
+    /** Timestamp when run started. */
+    startedAt: string;
+    /** Timestamp when run completed/paused. */
+    updatedAt: string;
+    /** Feature slug (for SDD workflows). */
+    feature?: string;
+    /** Project root path. */
+    projectRoot?: string;
+}
+export interface WorkflowContext {
+    /** Resolved input values. */
+    inputs: Record<string, unknown>;
+    /** Step outputs (keyed by step.id). */
+    steps: Record<string, {
+        output: unknown;
+        status: StepStatus;
+    }>;
+    /** Environment variables (read-only snapshot). */
+    env: Record<string, string>;
+    /** Workflow metadata. */
+    workflow: WorkflowMeta;
+    /** Current feature slug. */
+    feature?: string;
+}
+export type WorkflowEventType = "workflow.started" | "workflow.completed" | "workflow.failed" | "workflow.paused" | "workflow.resumed" | "step.started" | "step.completed" | "step.failed" | "step.skipped" | "gate.waiting" | "gate.responded";
+export interface WorkflowEvent {
+    type: WorkflowEventType;
+    runId: string;
+    workflowId: string;
+    stepId?: string;
+    timestamp: string;
+    data?: Record<string, unknown>;
+}
+export type WorkflowEventHandler = (event: WorkflowEvent) => void;
+/**
+ * Structured result from a `command:` step executor.
+ * Both the default executor and the CLI executor must conform to this shape.
+ */
+export interface CommandExecutorResult {
+    /** The command that was executed (e.g. "raptor.plan"). */
+    command: string;
+    /** Whether the command succeeded or failed. */
+    status: "success" | "failed" | "delegated";
+    /** Process exit code (0 = success). */
+    exitCode: number;
+    /** Captured stdout (may be empty). */
+    stdout?: string;
+    /** Captured stderr (may be empty). */
+    stderr?: string;
+    /** Duration in milliseconds. */
+    durationMs?: number;
+    /** Error message if status is "failed". */
+    error?: string;
+    /** Feature slug if available from context. */
+    feature?: string;
+    /** The argv passed to the command (for auditability). */
+    argv?: string[];
+}
+/**
+ * Options for the async shell executor.
+ */
+export interface ShellExecOptions {
+    /** Additional environment variables. */
+    env?: Record<string, string>;
+    /** Timeout in milliseconds (default: 30_000). */
+    timeoutMs?: number;
+}
+/**
+ * Result from a shell step execution.
+ */
+export interface ShellExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/_core/dist/workflows/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workflows/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,eAAO,MAAM,kBAAkB,EAAG,oBAA6B,CAAC;AAMhE,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,MAAM,CAAC,EAAE;QACP,6CAA6C;QAC7C,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QACf,6CAA6C;QAC7C,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;CACH;AAMD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,IAAI,EAAE,iBAAiB,CAAC;IACxB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,QAAQ,GACR,OAAO,GACP,MAAM,GACN,IAAI,GACJ,QAAQ,GACR,OAAO,GACP,UAAU,GACV,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,SAAS,GACT,SAAS,CAAC;AAMd,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IACzC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,IAAI,EAAE,SAAS,CAAC;IAChB,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAS,SAAQ,QAAQ;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,MAAO,SAAQ,QAAQ;IACtC,IAAI,EAAE,IAAI,CAAC;IACX,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,wCAAwC;IACxC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,EAAE,EAAE,YAAY,EAAE,CAAC;IACnB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ;IAC3C,IAAI,EAAE,UAAU,CAAC;IACjB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,EAAE,EAAE,YAAY,EAAE,CAAC;IACnB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,IAAI,EAAE,SAAS,CAAC;IAChB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,EAAE,EAAE,YAAY,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAU,SAAQ,QAAQ;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,4BAA4B;IAC5B,QAAQ,EAAE,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;IAClC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,UAAU,GACV,SAAS,GACT,QAAQ,GACR,MAAM,GACN,UAAU,GACV,SAAS,GACT,WAAW,GACX,UAAU,GACV,SAAS,CAAC;AAMd,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAClC,yBAAyB;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,kCAAkC;IAClC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,6BAA6B;IAC7B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAMD,MAAM,WAAW,SAAS;IACxB,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,sCAAsC;IACtC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,MAAM,EAAE,OAAO,kBAAkB,CAAC;IAClC,kBAAkB;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClE,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACjC,uDAAuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IAC/D,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,GACjB,iBAAiB,GACjB,kBAAkB,GAClB,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAMlE;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC3C,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/_core/dist/workflows/types.js

@@ -0,0 +1,13 @@
+/**
+ * Workflow Engine — Type definitions.
+ *
+ * Declarative workflow schema for SDD orchestration.
+ * Schema: raptor.workflow/v1.
+ *
+ * Blueprint ref: 05 — "Engine de Workflows".
+ */
+// ---------------------------------------------------------------------------
+// Schema envelope
+// ---------------------------------------------------------------------------
+export const WORKFLOW_SCHEMA_V1 = "raptor.workflow/v1";
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflows/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAA6B,CAAC"}

package/dist/_core/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@raptor/core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js"
+}

package/dist/_core/templates/constitution.md.hbs

@@ -0,0 +1,46 @@
+# {{projectName}} — Constitution
+
+> This constitution governs how {{projectName}} uses Raptor for Spec-Driven Development.
+> The block labeled **RAPTOR-CORE** is immutable and enforced by the framework.
+> Edits outside that block are the project's own extension of the constitution.
+
+## Immutable Core (Raptor Framework)
+
+{{coreBlock}}
+
+---
+
+## Project Extensions
+{{#if preset}}
+
+### Preset in effect: `{{preset}}`
+
+The articles below come from the `{{preset}}` preset and are intended as opinionated defaults.
+To override any of them, replace the article in place and record the change in `.raptor/memory/amendments.log`.
+
+{{presetArticles}}
+
+---
+{{/if}}
+
+<!--
+Add project-specific articles here (P1, P2, ...).
+Each article SHOULD follow the canonical format: Statement / Rationale / Enforcement / Violation Consequence.
+-->
+
+### P1 — [Your first project article]
+
+*Statement.* [NEEDS CLARIFICATION: what does this article determine?]
+
+*Rationale.* [NEEDS CLARIFICATION: why does the project need this?]
+
+*Enforcement.* [NEEDS CLARIFICATION: which command, gate, or hook enforces it?]
+
+*Violation Consequence.* [NEEDS CLARIFICATION: level (`required` | `advisory`) and behavior when violated]
+
+---
+
+## Amendments
+
+All changes to this constitution are recorded append-only in `.raptor/memory/amendments.log`.
+Run `raptor verify constitution` to validate the RAPTOR-CORE block integrity.