@davidorex/pi-workflows 0.5.0 → 0.9.0

package/dist/step-block.js

@@ -0,0 +1,204 @@
+/**
+ * Block step executor — performs validated, in-process block I/O.
+ * No LLM call, no subprocess — calls the block API directly.
+ *
+ * Operations:
+ * - read: single or multi-block read via readBlock()
+ * - readDir: directory enumeration for .project/ subdirectories
+ * - write: validated write via writeBlock()
+ * - append: array append via appendToBlock()
+ * - update: item update via updateItemInBlock()
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { appendToBlock, readBlock, updateItemInBlock, writeBlock } from "@davidorex/pi-project/block-api";
+import { PROJECT_DIR } from "@davidorex/pi-project/project-dir";
+import { validateFromFile } from "@davidorex/pi-project/schema-validator";
+import { resolveExpressions } from "./expression.js";
+import { persistStepOutput } from "./output.js";
+import { zeroUsage } from "./step-shared.js";
+/**
+ * Execute a block step: performs block I/O using the block API.
+ * All block names and values are expression-resolved before API calls.
+ */
+export function executeBlock(blockSpec, stepName, scope, cwd, runDir, outputPath) {
+    const startTime = Date.now();
+    try {
+        // Resolve expressions in the block spec
+        const resolved = resolveExpressions(blockSpec, scope);
+        let output;
+        if ("read" in resolved) {
+            output = executeRead(resolved.read, resolved.optional, cwd);
+        }
+        else if ("readDir" in resolved) {
+            output = executeReadDir(resolved.readDir, cwd);
+        }
+        else if ("write" in resolved) {
+            output = executeWrite(resolved.write, cwd);
+        }
+        else if ("append" in resolved) {
+            output = executeAppend(resolved.append, cwd);
+        }
+        else if ("update" in resolved) {
+            output = executeUpdate(resolved.update, cwd);
+        }
+        else {
+            throw new Error("Block spec must have one of: read, readDir, write, append, update");
+        }
+        const result = {
+            step: stepName,
+            agent: "block",
+            status: "completed",
+            output,
+            textOutput: JSON.stringify(output, null, 2),
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+        };
+        if (runDir) {
+            result.outputPath = persistStepOutput(runDir, stepName, output, undefined, outputPath);
+        }
+        return result;
+    }
+    catch (err) {
+        return {
+            step: stepName,
+            agent: "block",
+            status: "failed",
+            usage: zeroUsage(),
+            durationMs: Date.now() - startTime,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Read one or more blocks. Single string → single block content.
+ * Array → object keyed by block name.
+ */
+function executeRead(read, optional, cwd) {
+    const optionalSet = new Set(optional ?? []);
+    if (typeof read === "string") {
+        // Single block read
+        try {
+            return readBlock(cwd, read);
+        }
+        catch (err) {
+            if (optionalSet.has(read))
+                return null;
+            throw err;
+        }
+    }
+    // Multi-block read
+    const result = {};
+    for (const name of read) {
+        try {
+            result[name] = readBlock(cwd, name);
+        }
+        catch (err) {
+            if (optionalSet.has(name)) {
+                result[name] = null;
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Read all JSON files in a .project/ subdirectory.
+ * Returns sorted array of parsed contents.
+ * Missing directories return [] (on-demand subdirectories).
+ */
+function executeReadDir(subdir, cwd) {
+    const dirPath = path.join(cwd, PROJECT_DIR, subdir);
+    let entries;
+    try {
+        entries = fs
+            .readdirSync(dirPath)
+            .filter((f) => f.endsWith(".json"))
+            .sort();
+    }
+    catch {
+        // Missing directory = "no items yet" for on-demand .project/ subdirectories
+        return [];
+    }
+    const results = [];
+    for (const filename of entries) {
+        const filePath = path.join(dirPath, filename);
+        let content;
+        try {
+            content = fs.readFileSync(filePath, "utf-8");
+        }
+        catch {
+            throw new Error(`Cannot read file: ${PROJECT_DIR}/${subdir}/${filename}`);
+        }
+        try {
+            results.push(JSON.parse(content));
+        }
+        catch {
+            throw new Error(`Invalid JSON in: ${PROJECT_DIR}/${subdir}/${filename}`);
+        }
+    }
+    return results;
+}
+/**
+ * Write a block via writeBlock (schema validation + atomic write).
+ * Supports optional path override for subdirectory writes.
+ */
+function executeWrite(spec, cwd) {
+    if (spec.path) {
+        return executeSubdirWrite(spec.name, spec.data, spec.path, cwd);
+    }
+    writeBlock(cwd, spec.name, spec.data);
+    return { written: spec.name, path: `${PROJECT_DIR}/${spec.name}.json` };
+}
+/**
+ * Write to a subdirectory path (.project/{path}.json) with schema
+ * validation from `name`. Provides atomic writes and directory creation.
+ */
+function executeSubdirWrite(schemaName, data, subPath, cwd) {
+    const filePath = path.join(cwd, PROJECT_DIR, `${subPath}.json`);
+    const schemaFile = path.join(cwd, PROJECT_DIR, "schemas", `${schemaName}.schema.json`);
+    // Validate against schema if it exists
+    if (fs.existsSync(schemaFile)) {
+        validateFromFile(schemaFile, data, `block file '${subPath}.json'`);
+    }
+    // Ensure parent directory exists
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    // Atomic write
+    const tmpPath = `${filePath}.block-step-${process.pid}.tmp`;
+    try {
+        fs.writeFileSync(tmpPath, JSON.stringify(data, null, 2), "utf-8");
+        fs.renameSync(tmpPath, filePath);
+    }
+    catch (err) {
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch {
+            /* cleanup best-effort */
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Failed to write ${PROJECT_DIR}/${subPath}.json: ${msg}`);
+    }
+    return { written: schemaName, path: `${PROJECT_DIR}/${subPath}.json` };
+}
+/**
+ * Append an item to a block array via appendToBlock.
+ */
+function executeAppend(spec, cwd) {
+    appendToBlock(cwd, spec.name, spec.key, spec.item);
+    return { appended: spec.name, key: spec.key };
+}
+/**
+ * Update an item in a block array via updateItemInBlock.
+ * The `match` object is converted to a predicate.
+ */
+function executeUpdate(spec, cwd) {
+    const predicate = (item) => {
+        return Object.entries(spec.match).every(([k, v]) => item[k] === v);
+    };
+    updateItemInBlock(cwd, spec.name, spec.key, predicate, spec.set);
+    return { updated: spec.name, key: spec.key, matched: spec.match };
+}
+//# sourceMappingURL=step-block.js.map

package/dist/step-block.js.map

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

package/dist/template-validation.d.ts

@@ -0,0 +1,25 @@
+import type { WorkflowSpec } from "./types.js";
+import type { ValidationIssue } from "./workflow-sdk.js";
+export interface TemplateVariable {
+    root: string;
+    path: string;
+    guarded: boolean;
+    usage: "output" | "loop" | "conditional";
+}
+export interface SchemaFields {
+    properties: Record<string, {
+        type: string;
+    }>;
+    required: string[];
+}
+/**
+ * Extract all Nunjucks variable references from a template string.
+ * Returns structured entries with full dotted paths and usage context.
+ */
+export declare function extractTemplateVariables(content: string): TemplateVariable[];
+/**
+ * Validate template-input alignment for all agent steps in a workflow.
+ * Returns validation issues for field mismatches, missing inputs, and naming errors.
+ */
+export declare function validateTemplateAlignment(spec: WorkflowSpec, cwd: string, builtinDir?: string): ValidationIssue[];
+//# sourceMappingURL=template-validation.d.ts.map

package/dist/template-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-validation.d.ts","sourceRoot":"","sources":["../src/template-validation.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAmE5E;AA4ID;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CA4HjH"}

package/dist/template-validation.js

@@ -0,0 +1,341 @@
+/**
+ * Template-input alignment validation for workflow agent steps.
+ *
+ * Traces the full chain: workflow step → input expressions → source schemas → template field references.
+ * Catches field name mismatches, missing inputs, and forEach variable naming errors that cause
+ * Nunjucks to silently render empty strings.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { createAgentLoader } from "./agent-spec.js";
+import { resolveSchemaPath } from "./step-shared.js";
+// Variables injected by the execution engine, not from workflow inputs
+const INJECTED_VARIABLES = new Set(["output_schema", "loop"]);
+/**
+ * Extract all Nunjucks variable references from a template string.
+ * Returns structured entries with full dotted paths and usage context.
+ */
+export function extractTemplateVariables(content) {
+    const variables = [];
+    const seen = new Set();
+    // Track which lines are inside {% if var %} guards
+    const guardedRoots = new Set();
+    const ifStack = [];
+    let depth = 0;
+    const lines = content.split("\n");
+    for (const line of lines) {
+        // Track {% if var.field %} blocks
+        const ifMatch = line.match(/\{%[-\s]*if\s+([\w.]+)/);
+        if (ifMatch) {
+            depth++;
+            const root = ifMatch[1].split(".")[0];
+            ifStack.push({ root, depth });
+            guardedRoots.add(root);
+        }
+        const endifMatch = line.match(/\{%[-\s]*endif/);
+        if (endifMatch) {
+            while (ifStack.length > 0 && ifStack[ifStack.length - 1].depth === depth) {
+                const popped = ifStack.pop();
+                if (popped)
+                    guardedRoots.delete(popped.root);
+            }
+            depth--;
+        }
+        // Extract {{ var.field }} output expressions
+        const outputPattern = /\{\{\s*([\w]+(?:\.[\w]+)*)\s*(?:\|[^}]*)?\}\}/g;
+        let match;
+        match = outputPattern.exec(line);
+        while (match !== null) {
+            const fullPath = match[1];
+            const root = fullPath.split(".")[0];
+            if (!INJECTED_VARIABLES.has(root) && fullPath.includes(".") && !seen.has(fullPath)) {
+                seen.add(fullPath);
+                variables.push({
+                    root,
+                    path: fullPath,
+                    guarded: guardedRoots.has(root),
+                    usage: "output",
+                });
+            }
+            match = outputPattern.exec(line);
+        }
+        // Extract {% for x in var.field %} loop sources
+        const forPattern = /\{%[-\s]*for\s+\w+\s+in\s+([\w]+(?:\.[\w]+)*)\s*%\}/g;
+        match = forPattern.exec(line);
+        while (match !== null) {
+            const fullPath = match[1];
+            const root = fullPath.split(".")[0];
+            if (!INJECTED_VARIABLES.has(root) && fullPath.includes(".") && !seen.has(fullPath)) {
+                seen.add(fullPath);
+                variables.push({
+                    root,
+                    path: fullPath,
+                    guarded: guardedRoots.has(root),
+                    usage: "loop",
+                });
+            }
+            match = forPattern.exec(line);
+        }
+    }
+    return variables;
+}
+/**
+ * Given a step's input expression and the workflow spec, trace to a source schema
+ * and return its field definitions. Returns null if unverifiable.
+ */
+function traceInputSchema(inputExpr, stepSpec, spec, cwd) {
+    // Extract the expression content from ${{ ... }}
+    const exprMatch = inputExpr.match(/\$\{\{\s*(.+?)\s*\}\}/);
+    if (!exprMatch)
+        return null;
+    const expr = exprMatch[1];
+    // Case 1: forEach `as` variable — trace to the forEach source array's item schema
+    if (stepSpec.forEach && stepSpec.as && expr === stepSpec.as) {
+        return traceForEachItemSchema(stepSpec.forEach, spec, cwd);
+    }
+    // Case 2: ${{ steps.X.output }} or ${{ steps.X.output.field }}
+    const stepsMatch = expr.match(/^steps\.([\w-]+)\.output(?:\.([\w]+))?$/);
+    if (stepsMatch) {
+        const [, stepName, subField] = stepsMatch;
+        const sourceStep = spec.steps[stepName];
+        if (!sourceStep?.output?.schema)
+            return null;
+        return loadSchemaFields(sourceStep.output.schema, spec.filePath, cwd, subField);
+    }
+    return null;
+}
+/**
+ * Trace a forEach expression to the schema of each array item.
+ * E.g. ${{ steps.decompose.output.specs }} → decomposition-specs schema → specs.items.properties
+ */
+function traceForEachItemSchema(forEachExpr, spec, cwd) {
+    const exprMatch = forEachExpr.match(/\$\{\{\s*(.+?)\s*\}\}/);
+    if (!exprMatch)
+        return null;
+    const expr = exprMatch[1];
+    // Match steps.X.output.arrayField
+    const match = expr.match(/^steps\.([\w-]+)\.output\.([\w]+)$/);
+    if (!match)
+        return null;
+    const [, stepName, arrayField] = match;
+    const sourceStep = spec.steps[stepName];
+    if (!sourceStep?.output?.schema)
+        return null;
+    const schemaPath = resolveSchemaPath(sourceStep.output.schema, spec.filePath, cwd);
+    try {
+        const schema = JSON.parse(fs.readFileSync(schemaPath, "utf-8"));
+        const arrayProp = schema.properties?.[arrayField];
+        if (!arrayProp)
+            return null;
+        // Navigate to items schema
+        const itemSchema = arrayProp.items;
+        if (!itemSchema?.properties)
+            return null;
+        const properties = {};
+        for (const [key, value] of Object.entries(itemSchema.properties)) {
+            properties[key] = { type: value.type };
+        }
+        return {
+            properties,
+            required: itemSchema.required ?? [],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Load a schema file and return its field definitions.
+ * If subField is provided, navigates into that property's sub-schema.
+ */
+function loadSchemaFields(schemaRef, specFilePath, cwd, subField) {
+    const schemaPath = resolveSchemaPath(schemaRef, specFilePath, cwd);
+    try {
+        const schema = JSON.parse(fs.readFileSync(schemaPath, "utf-8"));
+        let target = schema;
+        if (subField) {
+            target = schema.properties?.[subField];
+            if (!target)
+                return null;
+        }
+        if (!target.properties)
+            return null;
+        const properties = {};
+        for (const [key, value] of Object.entries(target.properties)) {
+            properties[key] = { type: value.type };
+        }
+        return {
+            properties,
+            required: target.required ?? [],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Find the closest matching field name from a schema for a mismatched template reference.
+ */
+function suggestClosest(field, schemaFields) {
+    // Simple heuristic: check if one contains the other or shares a stem
+    for (const sf of schemaFields) {
+        if (sf.includes(field) || field.includes(sf))
+            return sf;
+    }
+    // Check common renames: underscore/camelCase, pluralization
+    const normalized = field.toLowerCase().replace(/_/g, "");
+    for (const sf of schemaFields) {
+        const sfNorm = sf.toLowerCase().replace(/_/g, "");
+        if (sfNorm === normalized)
+            return sf;
+        // Check if one is a prefix of the other
+        if (sfNorm.startsWith(normalized) || normalized.startsWith(sfNorm))
+            return sf;
+    }
+    return undefined;
+}
+/**
+ * Walk all agent steps in a workflow spec, including nested loop/parallel/forEach steps.
+ * Yields [stepName, stepSpec, parentPrefix] tuples.
+ */
+function* walkAgentSteps(steps, prefix = "") {
+    for (const [name, step] of Object.entries(steps)) {
+        const fullName = prefix ? `${prefix}.${name}` : name;
+        if (step.agent) {
+            yield [fullName, step, fullName];
+        }
+        if (step.loop?.steps) {
+            yield* walkAgentSteps(step.loop.steps, `${fullName}.loop`);
+        }
+        if (step.parallel) {
+            yield* walkAgentSteps(step.parallel, `${fullName}.parallel`);
+        }
+    }
+}
+/**
+ * Validate template-input alignment for all agent steps in a workflow.
+ * Returns validation issues for field mismatches, missing inputs, and naming errors.
+ */
+export function validateTemplateAlignment(spec, cwd, builtinDir) {
+    const issues = [];
+    let loadAgent;
+    try {
+        loadAgent = createAgentLoader(cwd, builtinDir);
+    }
+    catch {
+        return issues; // can't load agents — agent resolution check already handles this
+    }
+    // Template search mirrors createTemplateEnv() — project, user, builtin
+    const builtinTemplateDir = builtinDir
+        ? path.resolve(builtinDir, "..", "templates")
+        : path.resolve(import.meta.dirname, "..", "templates");
+    const templateSearchPaths = [
+        path.join(cwd, ".pi", "templates"),
+        path.join(process.env.HOME ?? "", ".pi", "agent", "templates"),
+        builtinTemplateDir,
+    ];
+    for (const [stepName, stepSpec] of walkAgentSteps(spec.steps)) {
+        if (!stepSpec.agent)
+            continue;
+        // Load agent spec
+        let agentSpec;
+        try {
+            agentSpec = loadAgent(stepSpec.agent);
+        }
+        catch {
+            continue; // agent resolution check handles this
+        }
+        if (!agentSpec.taskTemplate)
+            continue;
+        // Resolve and read template file
+        let templateContent = null;
+        for (const searchPath of templateSearchPaths) {
+            const fullPath = path.join(searchPath, agentSpec.taskTemplate);
+            try {
+                templateContent = fs.readFileSync(fullPath, "utf-8");
+                break;
+            }
+            catch {
+                // try next path
+            }
+        }
+        if (!templateContent)
+            continue;
+        const templateVars = extractTemplateVariables(templateContent);
+        if (templateVars.length === 0)
+            continue;
+        const inputKeys = stepSpec.input ? new Set(Object.keys(stepSpec.input)) : new Set();
+        // Check 1: forEach `as` variable matches template root variables
+        if (stepSpec.forEach && stepSpec.as) {
+            const forEachRoots = new Set(templateVars.map((v) => v.root));
+            // The `as` name should appear as a root in the template, OR a root that IS in the input
+            // The common bug: template uses `spec.*` but forEach says `as: plan`
+            if (!forEachRoots.has(stepSpec.as) && !inputKeys.has(stepSpec.as)) {
+                // forEach variable is never referenced — find what the template uses instead
+                const nonInputRoots = [...forEachRoots].filter((r) => !inputKeys.has(r) && !INJECTED_VARIABLES.has(r));
+                if (nonInputRoots.length > 0) {
+                    issues.push({
+                        severity: "error",
+                        message: `Template '${agentSpec.taskTemplate}' uses '${nonInputRoots[0]}.*' but forEach binds as '${stepSpec.as}'. Template variables will be undefined.`,
+                        field: `steps.${stepName}.as`,
+                    });
+                }
+            }
+        }
+        // Check 2: Root variables exist in step inputs (or are injected)
+        const uniqueRoots = new Set(templateVars.map((v) => v.root));
+        for (const root of uniqueRoots) {
+            if (INJECTED_VARIABLES.has(root))
+                continue;
+            if (inputKeys.has(root))
+                continue;
+            // forEach `as` variable counts as an input
+            if (stepSpec.forEach && stepSpec.as === root)
+                continue;
+            // Find if any template var with this root is guarded
+            const allGuarded = templateVars.filter((v) => v.root === root).every((v) => v.guarded);
+            issues.push({
+                severity: allGuarded ? "warning" : "error",
+                message: `Template '${agentSpec.taskTemplate}' references '${root}' but step '${stepName}' does not declare it in input.${allGuarded ? " (guarded with conditional)" : ""}`,
+                field: `steps.${stepName}.input`,
+            });
+        }
+        // Check 3: Field-level alignment against source schemas
+        for (const tv of templateVars) {
+            if (INJECTED_VARIABLES.has(tv.root))
+                continue;
+            const fieldParts = tv.path.split(".");
+            if (fieldParts.length < 2)
+                continue;
+            const field = fieldParts[1]; // first-level field access on the root variable
+            // Find the input expression for this root
+            const inputExpr = stepSpec.input?.[tv.root];
+            // Also check if this is the forEach `as` variable
+            const isForEachVar = stepSpec.forEach && stepSpec.as === tv.root;
+            let exprToTrace;
+            if (isForEachVar) {
+                exprToTrace = `\${{ ${stepSpec.as} }}`;
+            }
+            else if (typeof inputExpr === "string") {
+                exprToTrace = inputExpr;
+            }
+            if (!exprToTrace)
+                continue;
+            const schemaFields = traceInputSchema(exprToTrace, stepSpec, spec, cwd);
+            if (!schemaFields)
+                continue; // unverifiable
+            if (!(field in schemaFields.properties)) {
+                const closest = suggestClosest(field, Object.keys(schemaFields.properties));
+                const suggestion = closest ? ` Did you mean '${closest}'?` : "";
+                const available = Object.keys(schemaFields.properties).join(", ");
+                issues.push({
+                    severity: tv.guarded ? "warning" : "error",
+                    message: `Template '${agentSpec.taskTemplate}' references '${tv.path}' but schema has no field '${field}'.${suggestion} Available: [${available}]`,
+                    field: `steps.${stepName}.input.${tv.root}`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=template-validation.js.map

package/dist/template-validation.js.map

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

package/dist/types.d.ts

@@ -39,6 +39,7 @@ export interface StepSpec {
     pause?: string | boolean;
     monitor?: string;
     command?: string;
+    block?: BlockSpec;
     forEach?: string;
     as?: string;
     color?: string;
@@ -63,6 +64,36 @@ export interface TransformSpec {
      */
     mapping: Record<string, unknown>;
 }
+export interface BlockReadSpec {
+    read: string | string[];
+    optional?: string[];
+}
+export interface BlockReadDirSpec {
+    readDir: string;
+}
+export interface BlockWriteSpec {
+    write: {
+        name: string;
+        data: unknown;
+        path?: string;
+    };
+}
+export interface BlockAppendSpec {
+    append: {
+        name: string;
+        key: string;
+        item: unknown;
+    };
+}
+export interface BlockUpdateSpec {
+    update: {
+        name: string;
+        key: string;
+        match: Record<string, unknown>;
+        set: Record<string, unknown>;
+    };
+}
+export type BlockSpec = BlockReadSpec | BlockReadDirSpec | BlockWriteSpec | BlockAppendSpec | BlockUpdateSpec;
 export interface StepOutputSpec {
     format?: "json" | "text";
     schema?: string;