@slope-dev/slope 1.35.0 → 1.36.0

package/dist/core/workflow-loader.js.map

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

package/dist/core/workflow-validator.d.ts

@@ -0,0 +1,19 @@
+import type { WorkflowDefinition } from './workflow.js';
+/** A single validation error or warning */
+export interface ValidationIssue {
+    message: string;
+    /** Dot-path to the problematic element (e.g., "phases[0].steps[1]") */
+    path?: string;
+}
+/** Result of validating a workflow definition */
+export interface WorkflowValidationResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+}
+/**
+ * Validate a parsed WorkflowDefinition for structural issues.
+ * Does NOT re-validate YAML parsing — assumes parseWorkflow() already succeeded.
+ */
+export declare function validateWorkflow(def: WorkflowDefinition): WorkflowValidationResult;
+//# sourceMappingURL=workflow-validator.d.ts.map

package/dist/core/workflow-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-validator.d.ts","sourceRoot":"","sources":["../../src/core/workflow-validator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,eAAe,CAAC;AAGtE,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iDAAiD;AACjD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,GAAG,wBAAwB,CA6HlF"}

package/dist/core/workflow-validator.js

@@ -0,0 +1,166 @@
+// SLOPE — Workflow Validator
+// Validates WorkflowDefinitions for structural correctness before execution.
+import { VALID_STEP_TYPES } from './workflow.js';
+/**
+ * Validate a parsed WorkflowDefinition for structural issues.
+ * Does NOT re-validate YAML parsing — assumes parseWorkflow() already succeeded.
+ */
+export function validateWorkflow(def) {
+    const errors = [];
+    const warnings = [];
+    // Version check
+    if (def.version !== '1') {
+        errors.push({ message: `Unsupported workflow version: "${def.version}" (expected "1")` });
+    }
+    // Name check
+    if (!def.name || def.name.trim().length === 0) {
+        errors.push({ message: 'Workflow name must be a non-empty string' });
+    }
+    // Collect all step IDs for uniqueness check
+    const allStepIds = new Map(); // step_id → phase_id
+    // Collect all variable references found in steps
+    const referencedVars = new Set();
+    const definedVars = new Set(Object.keys(def.variables ?? {}));
+    if (def.phases.length === 0) {
+        warnings.push({ message: 'Workflow has no phases' });
+    }
+    // Phase-level checks
+    const phaseIds = new Set();
+    for (let pi = 0; pi < def.phases.length; pi++) {
+        const phase = def.phases[pi];
+        const pPath = `phases[${pi}]`;
+        // Duplicate phase ID
+        if (phaseIds.has(phase.id)) {
+            errors.push({ message: `Duplicate phase ID: "${phase.id}"`, path: pPath });
+        }
+        phaseIds.add(phase.id);
+        // Empty steps
+        if (phase.steps.length === 0) {
+            warnings.push({ message: `Phase "${phase.id}" has no steps`, path: pPath });
+        }
+        // repeat_for variable reference
+        if (phase.repeat_for) {
+            referencedVars.add(phase.repeat_for);
+            if (definedVars.size > 0 && !definedVars.has(phase.repeat_for)) {
+                warnings.push({
+                    message: `Phase "${phase.id}" references variable "${phase.repeat_for}" in repeat_for, but it is not defined in variables`,
+                    path: `${pPath}.repeat_for`,
+                });
+            }
+            // on_timeout only makes sense with repeat_for
+            if (phase.timeout_per_item && !phase.on_timeout) {
+                warnings.push({
+                    message: `Phase "${phase.id}" has timeout_per_item but no on_timeout behavior`,
+                    path: `${pPath}.on_timeout`,
+                });
+            }
+        }
+        else {
+            // on_timeout without repeat_for
+            if (phase.on_timeout) {
+                warnings.push({
+                    message: `Phase "${phase.id}" has on_timeout but no repeat_for — on_timeout is ignored`,
+                    path: `${pPath}.on_timeout`,
+                });
+            }
+        }
+        // Step-level checks
+        for (let si = 0; si < phase.steps.length; si++) {
+            const step = phase.steps[si];
+            const sPath = `${pPath}.steps[${si}]`;
+            // Duplicate step ID across all phases
+            if (allStepIds.has(step.id)) {
+                errors.push({
+                    message: `Duplicate step ID: "${step.id}" (also in phase "${allStepIds.get(step.id)}")`,
+                    path: sPath,
+                });
+            }
+            allStepIds.set(step.id, phase.id);
+            // Valid step type
+            if (!VALID_STEP_TYPES.has(step.type)) {
+                errors.push({
+                    message: `Invalid step type: "${step.type}"`,
+                    path: `${sPath}.type`,
+                });
+            }
+            // Type-specific validation
+            validateStepByType(step, sPath, errors, warnings);
+            // blocks_next on terminal step is redundant
+            if (step.blocks_next && si === phase.steps.length - 1) {
+                warnings.push({
+                    message: `Step "${step.id}" has blocks_next but is the last step in its phase — this is redundant`,
+                    path: `${sPath}.blocks_next`,
+                });
+            }
+            // Collect variable references from string fields
+            collectVarRefs(step.command, referencedVars);
+            collectVarRefs(step.prompt, referencedVars);
+            if (step.rules)
+                step.rules.forEach(r => collectVarRefs(r, referencedVars));
+            if (step.conditions)
+                step.conditions.forEach(c => collectVarRefs(c, referencedVars));
+        }
+    }
+    // Warn about unreferenced variables
+    for (const varName of definedVars) {
+        if (!referencedVars.has(varName)) {
+            warnings.push({
+                message: `Variable "${varName}" is defined but never referenced`,
+                path: `variables.${varName}`,
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/** Validate type-specific step requirements */
+function validateStepByType(step, path, errors, warnings) {
+    switch (step.type) {
+        case 'command':
+            if (!step.command) {
+                errors.push({
+                    message: `Command step "${step.id}" must have a "command" field`,
+                    path: `${path}.command`,
+                });
+            }
+            break;
+        case 'validation':
+            if (!step.conditions?.length && !step.command) {
+                warnings.push({
+                    message: `Validation step "${step.id}" has no conditions or command — it will always pass`,
+                    path,
+                });
+            }
+            break;
+        case 'agent_input':
+            if (!step.required_fields?.length && !step.prompt) {
+                warnings.push({
+                    message: `Agent input step "${step.id}" has no required_fields or prompt`,
+                    path,
+                });
+            }
+            break;
+        case 'agent_work':
+            if (!step.prompt && !step.rules?.length) {
+                warnings.push({
+                    message: `Agent work step "${step.id}" has no prompt or rules — agent has no guidance`,
+                    path,
+                });
+            }
+            break;
+    }
+}
+/** Extract ${varName} references from a string */
+function collectVarRefs(str, refs) {
+    if (!str)
+        return;
+    const pattern = /\$\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g;
+    let match;
+    while ((match = pattern.exec(str)) !== null) {
+        refs.add(match[1]);
+    }
+}
+//# sourceMappingURL=workflow-validator.js.map

package/dist/core/workflow-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-validator.js","sourceRoot":"","sources":["../../src/core/workflow-validator.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,6EAA6E;AAG7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAgBjD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAuB;IACtD,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAsB,EAAE,CAAC;IAEvC,gBAAgB;IAChB,IAAI,GAAG,CAAC,OAAO,KAAK,GAAG,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,kCAAkC,GAAG,CAAC,OAAO,kBAAkB,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,aAAa;IACb,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,4CAA4C;IAC5C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,qBAAqB;IAEnE,iDAAiD;IACjD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IAE9D,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,qBAAqB;IACrB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,UAAU,EAAE,GAAG,CAAC;QAE9B,qBAAqB;QACrB,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,wBAAwB,KAAK,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAEvB,cAAc;QACd,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,KAAK,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9E,CAAC;QAED,gCAAgC;QAChC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACrB,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACrC,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/D,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,UAAU,KAAK,CAAC,EAAE,0BAA0B,KAAK,CAAC,UAAU,qDAAqD;oBAC1H,IAAI,EAAE,GAAG,KAAK,aAAa;iBAC5B,CAAC,CAAC;YACL,CAAC;YAED,8CAA8C;YAC9C,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;gBAChD,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,UAAU,KAAK,CAAC,EAAE,mDAAmD;oBAC9E,IAAI,EAAE,GAAG,KAAK,aAAa;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,CAAC;YACN,gCAAgC;YAChC,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,UAAU,KAAK,CAAC,EAAE,4DAA4D;oBACvF,IAAI,EAAE,GAAG,KAAK,aAAa;iBAC5B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7B,MAAM,KAAK,GAAG,GAAG,KAAK,UAAU,EAAE,GAAG,CAAC;YAEtC,sCAAsC;YACtC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,uBAAuB,IAAI,CAAC,EAAE,qBAAqB,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI;oBACvF,IAAI,EAAE,KAAK;iBACZ,CAAC,CAAC;YACL,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAElC,kBAAkB;YAClB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,uBAAuB,IAAI,CAAC,IAAI,GAAG;oBAC5C,IAAI,EAAE,GAAG,KAAK,OAAO;iBACtB,CAAC,CAAC;YACL,CAAC;YAED,2BAA2B;YAC3B,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;YAElD,4CAA4C;YAC5C,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtD,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,SAAS,IAAI,CAAC,EAAE,yEAAyE;oBAClG,IAAI,EAAE,GAAG,KAAK,cAAc;iBAC7B,CAAC,CAAC;YACL,CAAC;YAED,iDAAiD;YACjD,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YAC7C,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YAC5C,IAAI,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;YAC3E,IAAI,IAAI,CAAC,UAAU;gBAAE,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,KAAK,MAAM,OAAO,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,QAAQ,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,aAAa,OAAO,mCAAmC;gBAChE,IAAI,EAAE,aAAa,OAAO,EAAE;aAC7B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QAC1B,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,SAAS,kBAAkB,CACzB,IAAkB,EAClB,IAAY,EACZ,MAAyB,EACzB,QAA2B;IAE3B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,SAAS;YACZ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,iBAAiB,IAAI,CAAC,EAAE,+BAA+B;oBAChE,IAAI,EAAE,GAAG,IAAI,UAAU;iBACxB,CAAC,CAAC;YACL,CAAC;YACD,MAAM;QAER,KAAK,YAAY;YACf,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,oBAAoB,IAAI,CAAC,EAAE,sDAAsD;oBAC1F,IAAI;iBACL,CAAC,CAAC;YACL,CAAC;YACD,MAAM;QAER,KAAK,aAAa;YAChB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAClD,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,qBAAqB,IAAI,CAAC,EAAE,oCAAoC;oBACzE,IAAI;iBACL,CAAC,CAAC;YACL,CAAC;YACD,MAAM;QAER,KAAK,YAAY;YACf,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,oBAAoB,IAAI,CAAC,EAAE,kDAAkD;oBACtF,IAAI;iBACL,CAAC,CAAC;YACL,CAAC;YACD,MAAM;IACV,CAAC;AACH,CAAC;AAED,kDAAkD;AAClD,SAAS,cAAc,CAAC,GAAuB,EAAE,IAAiB;IAChE,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,MAAM,OAAO,GAAG,iCAAiC,CAAC;IAClD,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/core/workflow.d.ts

@@ -0,0 +1,51 @@
+/** Variable definition for workflow parameterization */
+export interface WorkflowVariable {
+    required?: boolean;
+    type?: 'string' | 'integer' | 'array';
+    pattern?: string;
+    default?: string;
+}
+/** A single step within a workflow phase */
+export interface WorkflowStep {
+    id: string;
+    type: 'command' | 'validation' | 'agent_input' | 'agent_work';
+    prompt?: string;
+    command?: string;
+    checkpoint?: string;
+    blocks_next?: boolean;
+    rules?: string[];
+    required_fields?: string[];
+    /** Validation conditions (for type=validation) */
+    conditions?: string[];
+}
+/** A phase containing ordered steps */
+export interface WorkflowPhase {
+    id: string;
+    steps: WorkflowStep[];
+    /** Variable name containing array to iterate over */
+    repeat_for?: string;
+    /** Timeout in seconds for each repeated item */
+    timeout_per_item?: number;
+    /** Behavior when a repeated item times out */
+    on_timeout?: 'fail' | 'log_blocker_and_skip';
+}
+/** Top-level workflow definition */
+export interface WorkflowDefinition {
+    name: string;
+    version: string;
+    description?: string;
+    variables?: Record<string, WorkflowVariable>;
+    phases: WorkflowPhase[];
+}
+/** Parse a YAML string into a WorkflowDefinition. Throws on invalid structure. */
+export declare function parseWorkflow(yaml: string): WorkflowDefinition;
+/** Valid step types for workflow definitions. Shared with the validator. */
+export declare const VALID_STEP_TYPES: Set<string>;
+/**
+ * Resolve `${varName}` references in all string values of a workflow definition.
+ * - Top-level string keys only (no nesting like `${x.y}`)
+ * - Missing variable at resolve time → error
+ * - Escaped `\${literal}` → `${literal}`
+ */
+export declare function resolveVariables(def: WorkflowDefinition, vars: Record<string, string>): WorkflowDefinition;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/core/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/core/workflow.ts"],"names":[],"mappings":"AAOA,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;CAC9C;AAED,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAID,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA0C9D;AAuBD,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,aAAkE,CAAC;AAoEhG;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,kBAAkB,CA0CpB"}

package/dist/core/workflow.js

@@ -0,0 +1,190 @@
+// SLOPE — Workflow Definition Types & YAML Parser
+// Parses YAML 1.2 workflow definitions into typed structures for the workflow engine.
+import { parseDocument } from 'yaml';
+// --- Parser ---
+/** Parse a YAML string into a WorkflowDefinition. Throws on invalid structure. */
+export function parseWorkflow(yaml) {
+    const doc = parseDocument(yaml, { schema: 'core' });
+    if (doc.errors.length > 0) {
+        throw new Error(`YAML parse error: ${doc.errors[0].message}`);
+    }
+    const raw = doc.toJS();
+    if (!raw || typeof raw !== 'object') {
+        throw new Error('Workflow must be a YAML mapping');
+    }
+    // Required fields
+    if (!raw.name || typeof raw.name !== 'string') {
+        throw new Error('Workflow must have a string "name" field');
+    }
+    if (!raw.version || typeof raw.version !== 'string') {
+        throw new Error('Workflow must have a string "version" field');
+    }
+    if (!Array.isArray(raw.phases)) {
+        throw new Error('Workflow must have a "phases" array');
+    }
+    // Parse variables
+    const variables = raw.variables && typeof raw.variables === 'object' && !Array.isArray(raw.variables)
+        ? parseVariables(raw.variables)
+        : undefined;
+    // Parse phases
+    const phases = raw.phases.map((p, i) => parsePhase(p, i));
+    return {
+        name: raw.name,
+        version: raw.version,
+        description: typeof raw.description === 'string' ? raw.description : undefined,
+        variables,
+        phases,
+    };
+}
+function parseVariables(raw) {
+    const result = {};
+    for (const [key, val] of Object.entries(raw)) {
+        if (typeof val !== 'object' || val === null || Array.isArray(val)) {
+            throw new Error(`Variable "${key}" must be a mapping`);
+        }
+        const v = val;
+        result[key] = {
+            required: typeof v.required === 'boolean' ? v.required : undefined,
+            type: isVariableType(v.type) ? v.type : undefined,
+            pattern: typeof v.pattern === 'string' ? v.pattern : undefined,
+            default: v.default !== undefined ? String(v.default) : undefined,
+        };
+    }
+    return result;
+}
+function isVariableType(val) {
+    return val === 'string' || val === 'integer' || val === 'array';
+}
+/** Valid step types for workflow definitions. Shared with the validator. */
+export const VALID_STEP_TYPES = new Set(['command', 'validation', 'agent_input', 'agent_work']);
+function parsePhase(raw, index) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error(`Phase at index ${index} must be a mapping`);
+    }
+    const p = raw;
+    if (!p.id || typeof p.id !== 'string') {
+        throw new Error(`Phase at index ${index} must have a string "id"`);
+    }
+    if (!Array.isArray(p.steps)) {
+        throw new Error(`Phase "${p.id}" must have a "steps" array`);
+    }
+    const steps = p.steps.map((s, si) => parseStep(s, p.id, si));
+    return {
+        id: p.id,
+        steps,
+        repeat_for: typeof p.repeat_for === 'string' ? p.repeat_for : undefined,
+        timeout_per_item: typeof p.timeout_per_item === 'number' ? p.timeout_per_item : undefined,
+        on_timeout: p.on_timeout === 'fail' || p.on_timeout === 'log_blocker_and_skip'
+            ? p.on_timeout
+            : undefined,
+    };
+}
+function parseStep(raw, phaseId, index) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new Error(`Step at index ${index} in phase "${phaseId}" must be a mapping`);
+    }
+    const s = raw;
+    if (!s.id || typeof s.id !== 'string') {
+        throw new Error(`Step at index ${index} in phase "${phaseId}" must have a string "id"`);
+    }
+    if (!s.type || typeof s.type !== 'string' || !VALID_STEP_TYPES.has(s.type)) {
+        throw new Error(`Step "${s.id}" in phase "${phaseId}" must have a valid "type" (command|validation|agent_input|agent_work)`);
+    }
+    return {
+        id: s.id,
+        type: s.type,
+        prompt: typeof s.prompt === 'string' ? s.prompt : undefined,
+        command: typeof s.command === 'string' ? s.command : undefined,
+        checkpoint: typeof s.checkpoint === 'string' ? s.checkpoint : undefined,
+        blocks_next: typeof s.blocks_next === 'boolean' ? s.blocks_next : undefined,
+        rules: Array.isArray(s.rules) ? s.rules.map(r => String(r)) : undefined,
+        required_fields: Array.isArray(s.required_fields)
+            ? s.required_fields.map(r => String(r))
+            : undefined,
+        conditions: Array.isArray(s.conditions)
+            ? s.conditions.map(c => String(c))
+            : undefined,
+    };
+}
+// --- Variable Interpolation ---
+/**
+ * Resolve `${varName}` references in all string values of a workflow definition.
+ * - Top-level string keys only (no nesting like `${x.y}`)
+ * - Missing variable at resolve time → error
+ * - Escaped `\${literal}` → `${literal}`
+ */
+export function resolveVariables(def, vars) {
+    // Validate all required variables are provided
+    if (def.variables) {
+        for (const [name, spec] of Object.entries(def.variables)) {
+            if (spec.required && !(name in vars) && spec.default === undefined) {
+                throw new Error(`Required variable "${name}" not provided`);
+            }
+        }
+    }
+    // Build resolved vars: provided values + defaults
+    const resolved = {};
+    if (def.variables) {
+        for (const [name, spec] of Object.entries(def.variables)) {
+            if (name in vars) {
+                resolved[name] = vars[name];
+            }
+            else if (spec.default !== undefined) {
+                resolved[name] = spec.default;
+            }
+        }
+    }
+    // Also include any extra vars not in the schema
+    for (const [name, val] of Object.entries(vars)) {
+        if (!(name in resolved)) {
+            resolved[name] = val;
+        }
+    }
+    // Validate patterns
+    if (def.variables) {
+        for (const [name, spec] of Object.entries(def.variables)) {
+            if (spec.pattern && name in resolved) {
+                const re = new RegExp(spec.pattern);
+                if (!re.test(resolved[name])) {
+                    throw new Error(`Variable "${name}" value "${resolved[name]}" does not match pattern "${spec.pattern}"`);
+                }
+            }
+        }
+    }
+    // Deep-clone and interpolate all string values (avoids JSON.stringify escape issues)
+    return deepInterpolate(def, resolved);
+}
+/** Recursively walk a value, interpolating ${var} in all strings. */
+function deepInterpolate(value, vars) {
+    if (typeof value === 'string') {
+        return interpolateString(value, vars);
+    }
+    if (Array.isArray(value)) {
+        return value.map(item => deepInterpolate(item, vars));
+    }
+    if (value !== null && typeof value === 'object') {
+        const result = {};
+        for (const [key, val] of Object.entries(value)) {
+            result[key] = deepInterpolate(val, vars);
+        }
+        return result;
+    }
+    return value;
+}
+/** Interpolate ${var} references in a string. Throws on unresolved variables. */
+function interpolateString(str, vars) {
+    // Replace escaped \${ with a placeholder, then restore after interpolation
+    const PLACEHOLDER = '\x00ESCAPED_DOLLAR\x00';
+    let result = str.replace(/\\\$\{/g, PLACEHOLDER);
+    // Find and replace ${varName} references
+    result = result.replace(/\$\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g, (_match, name) => {
+        if (!(name in vars)) {
+            throw new Error(`Unresolved variable reference: \${${name}}`);
+        }
+        return vars[name];
+    });
+    // Restore escaped references as literal ${
+    result = result.replaceAll(PLACEHOLDER, '${');
+    return result;
+}
+//# sourceMappingURL=workflow.js.map

package/dist/core/workflow.js.map

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

package/dist/mcp/index.d.ts

@@ -2,7 +2,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { SlopeStore, SlopeConfig } from '../core/index.js';
 /** Tool names exposed by this MCP server (for tests and tool discovery). */
-export declare const SLOPE_MCP_TOOL_NAMES: readonly ["search", "execute", "context_search", "session_status", "acquire_claim", "check_conflicts", "store_status", "testing_session_start", "testing_session_finding", "testing_session_end", "testing_session_status", "testing_plan_status"];
+export declare const SLOPE_MCP_TOOL_NAMES: readonly ["search", "execute", "context_search", "session_status", "acquire_claim", "check_conflicts", "store_status", "testing_session_start", "testing_session_finding", "testing_session_end", "testing_session_status", "testing_plan_status", "workflow_next", "workflow_complete", "workflow_status"];
 /** Detection results for hook/settings activation status. */
 export interface SetupHints {
     guardsInstalled: boolean;

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAwBA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMhE,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,oPAAqP,CAAC;AAEvR,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,uBAAuB,EAAE,OAAO,CAAC;IACjC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAkChE;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CA+B/D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CA+nBvI"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAwBA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMhE,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,6SAA8S,CAAC;AAEhV,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,uBAAuB,EAAE,OAAO,CAAC;IACjC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAkChE;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CA+B/D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CA6yBvI"}

package/dist/mcp/index.js

@@ -27,10 +27,10 @@ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
 import { z } from 'zod';
 import { SLOPE_REGISTRY, SLOPE_TYPES } from './registry.js';
 import { runInSandbox } from './sandbox.js';
-import { checkConflicts, loadFlows, checkFlowStaleness, checkStoreHealth, METAPHOR_SCHEMA, listMetaphors, buildInterviewContext, generateInterviewSteps, loadConfig, parseTestPlan, getAreasNeedingTest, hasEmbeddingSupport, embed, deduplicateByFile, formatContextForAgent } from '../core/index.js';
+import { checkConflicts, loadFlows, checkFlowStaleness, checkStoreHealth, METAPHOR_SCHEMA, listMetaphors, buildInterviewContext, generateInterviewSteps, loadConfig, parseTestPlan, getAreasNeedingTest, hasEmbeddingSupport, embed, deduplicateByFile, formatContextForAgent, WorkflowEngine, loadWorkflow, resolveVariables } from '../core/index.js';
 import { gaming } from '../core/metaphors/gaming.js';
 /** Tool names exposed by this MCP server (for tests and tool discovery). */
-export const SLOPE_MCP_TOOL_NAMES = ['search', 'execute', 'context_search', 'session_status', 'acquire_claim', 'check_conflicts', 'store_status', 'testing_session_start', 'testing_session_finding', 'testing_session_end', 'testing_session_status', 'testing_plan_status'];
+export const SLOPE_MCP_TOOL_NAMES = ['search', 'execute', 'context_search', 'session_status', 'acquire_claim', 'check_conflicts', 'store_status', 'testing_session_start', 'testing_session_finding', 'testing_session_end', 'testing_session_status', 'testing_plan_status', 'workflow_next', 'workflow_complete', 'workflow_status'];
 /** Detect which SLOPE hooks and settings are activated in the project. */
 export function detectSetupHints(projectRoot) {
     const hints = {
@@ -614,6 +614,142 @@ export function createSlopeToolsServer(store, setupHints, storeType, config) {
             };
             return { content: [{ type: 'text', text: JSON.stringify(response, null, 2) }] };
         });
+        // --- Workflow Tools ---
+        /** Resolve project root, falling back to cwd */
+        function safeProjectRoot() {
+            try {
+                return findProjectRoot(process.cwd());
+            }
+            catch {
+                return process.cwd();
+            }
+        }
+        const workflowEngine = new WorkflowEngine();
+        server.tool('workflow_next', 'Get the next step in a workflow execution. Returns the current step to execute, or signals completion.', {
+            execution_id: z.string().optional().describe('Workflow execution ID'),
+            session_id: z.string().optional().describe('Session ID to find active execution'),
+        }, async ({ execution_id, session_id }) => {
+            try {
+                let execId = execution_id;
+                // Fallback: find execution by session
+                if (!execId && session_id) {
+                    const executions = await store.listExecutions({ status: 'running' });
+                    const match = executions.find(e => e.session_id === session_id);
+                    if (!match) {
+                        return { content: [{ type: 'text', text: JSON.stringify({ error: `No active workflow execution found for session "${session_id}"` }) }], isError: true };
+                    }
+                    execId = match.id;
+                }
+                if (!execId) {
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: 'Either execution_id or session_id is required' }) }], isError: true };
+                }
+                const execution = await store.getExecution(execId);
+                if (!execution) {
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: `Execution "${execId}" not found` }) }], isError: true };
+                }
+                // Load and resolve the workflow definition
+                const def = resolveVariables(loadWorkflow(execution.workflow_name, safeProjectRoot()), execution.variables);
+                const next = await workflowEngine.next(execId, def, store);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                execution_id: execId,
+                                ...next,
+                            }, null, 2),
+                        }],
+                };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
+        server.tool('workflow_complete', 'Complete the current step in a workflow execution and advance to the next step.', {
+            execution_id: z.string().describe('Workflow execution ID'),
+            step_id: z.string().describe('Step ID being completed'),
+            output: z.record(z.unknown()).optional().describe('Step output data'),
+            exit_code: z.number().optional().describe('Exit code for command steps'),
+        }, async ({ execution_id, step_id, output, exit_code }) => {
+            try {
+                const execution = await store.getExecution(execution_id);
+                if (!execution) {
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: `Execution "${execution_id}" not found` }) }], isError: true };
+                }
+                const def = resolveVariables(loadWorkflow(execution.workflow_name, safeProjectRoot()), execution.variables);
+                const result = await workflowEngine.complete(execution_id, step_id, { output: output, exit_code }, def, store);
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                execution_id,
+                                ...result,
+                            }, null, 2),
+                        }],
+                };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
+        server.tool('workflow_status', 'Show the status of a workflow execution with progress summary.', {
+            execution_id: z.string().optional().describe('Specific execution ID, or omit for all active executions'),
+        }, async ({ execution_id }) => {
+            try {
+                if (execution_id) {
+                    const execution = await store.getExecution(execution_id);
+                    if (!execution) {
+                        return { content: [{ type: 'text', text: JSON.stringify({ error: `Execution "${execution_id}" not found` }) }], isError: true };
+                    }
+                    // Load def to compute total steps (accounting for repeat_for multiplier)
+                    let totalSteps = 0;
+                    try {
+                        const def = resolveVariables(loadWorkflow(execution.workflow_name, safeProjectRoot()), execution.variables);
+                        totalSteps = def.phases.reduce((sum, p) => {
+                            const stepCount = p.steps.length;
+                            if (p.repeat_for && execution.variables[p.repeat_for]) {
+                                const items = execution.variables[p.repeat_for].split(',').filter(Boolean);
+                                return sum + stepCount * items.length;
+                            }
+                            return sum + stepCount;
+                        }, 0);
+                    }
+                    catch { /* def not available — ok */ }
+                    return {
+                        content: [{
+                                type: 'text',
+                                text: JSON.stringify({
+                                    ...execution,
+                                    progress: {
+                                        completed_steps: execution.completed_steps.length,
+                                        total_steps: totalSteps || undefined,
+                                    },
+                                }, null, 2),
+                            }],
+                    };
+                }
+                // List all active executions
+                const active = await store.listExecutions({ status: 'running' });
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({
+                                active_executions: active.map(e => ({
+                                    id: e.id,
+                                    workflow_name: e.workflow_name,
+                                    sprint_id: e.sprint_id,
+                                    current_phase: e.current_phase,
+                                    current_step: e.current_step,
+                                    completed_steps: e.completed_steps.length,
+                                    started_at: e.started_at,
+                                })),
+                            }, null, 2),
+                        }],
+                };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }], isError: true };
+            }
+        });
     }
     return server;
 }