@fractary/faber 2.2.1 → 2.3.4

package/dist/workflow/resolver.js

@@ -0,0 +1,351 @@
+/**
+ * @fractary/faber - Workflow Resolver
+ *
+ * Handles workflow inheritance resolution with deterministic merge behavior.
+ * This is the SDK equivalent of plugins/faber/skills/faber-config/scripts/merge-workflows.sh
+ *
+ * Centralized workflow resolution ensures consistent behavior across CLI, MCP, and agents.
+ */
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+// ============================================================================
+// Custom Errors
+// ============================================================================
+export class WorkflowNotFoundError extends Error {
+    workflowId;
+    searchedPaths;
+    constructor(workflowId, searchedPaths) {
+        super(`Workflow not found: ${workflowId}`);
+        this.workflowId = workflowId;
+        this.searchedPaths = searchedPaths;
+        this.name = 'WorkflowNotFoundError';
+    }
+}
+export class CircularInheritanceError extends Error {
+    workflowId;
+    chain;
+    constructor(workflowId, chain) {
+        super(`Circular inheritance detected: ${workflowId} creates inheritance cycle`);
+        this.workflowId = workflowId;
+        this.chain = chain;
+        this.name = 'CircularInheritanceError';
+    }
+}
+export class DuplicateStepIdError extends Error {
+    duplicateIds;
+    constructor(duplicateIds) {
+        super(`Duplicate step IDs found: ${duplicateIds.join(', ')}`);
+        this.duplicateIds = duplicateIds;
+        this.name = 'DuplicateStepIdError';
+    }
+}
+export class InvalidWorkflowError extends Error {
+    workflowId;
+    reason;
+    constructor(workflowId, reason) {
+        super(`Invalid workflow ${workflowId}: ${reason}`);
+        this.workflowId = workflowId;
+        this.reason = reason;
+        this.name = 'InvalidWorkflowError';
+    }
+}
+// ============================================================================
+// Workflow Resolver Class
+// ============================================================================
+/**
+ * Resolves workflow inheritance chains and merges phases.
+ *
+ * Merge algorithm (for each phase):
+ * 1. Pre-steps: Root ancestor first (reversed chain order)
+ * 2. Main steps: Only from child (first in chain)
+ * 3. Post-steps: Child first (chain order)
+ *
+ * Example for default → core:
+ * - chain = ["default", "core"] (child first)
+ * - pre_steps: core.pre_steps, then default.pre_steps
+ * - steps: only default.steps
+ * - post_steps: default.post_steps, then core.post_steps
+ */
+export class WorkflowResolver {
+    marketplaceRoot;
+    projectRoot;
+    workflowCache = new Map();
+    constructor(options = {}) {
+        this.marketplaceRoot =
+            options.marketplaceRoot ||
+                process.env['CLAUDE_MARKETPLACE_ROOT'] ||
+                path.join(process.env['HOME'] || os.homedir(), '.claude/plugins/marketplaces');
+        this.projectRoot = options.projectRoot || process.cwd();
+    }
+    /**
+     * Sanitize a path component to prevent path traversal attacks.
+     * Rejects components containing '..' or absolute path indicators.
+     */
+    sanitizePathComponent(component, context) {
+        // Reject empty components
+        if (!component || component.trim() === '') {
+            throw new InvalidWorkflowError(component, `${context} cannot be empty`);
+        }
+        // Reject path traversal sequences
+        if (component.includes('..')) {
+            throw new InvalidWorkflowError(component, `${context} cannot contain '..' (path traversal attempt)`);
+        }
+        // Reject absolute paths (Unix or Windows style)
+        if (component.startsWith('/') || component.startsWith('\\') || /^[a-zA-Z]:/.test(component)) {
+            throw new InvalidWorkflowError(component, `${context} cannot be an absolute path`);
+        }
+        // Reject null bytes (could bypass checks in some systems)
+        if (component.includes('\0')) {
+            throw new InvalidWorkflowError(component, `${context} contains invalid characters`);
+        }
+        return component;
+    }
+    /**
+     * Resolve a workflow by ID, applying inheritance and merging phases.
+     */
+    async resolveWorkflow(workflowId) {
+        // Build inheritance chain (child first, ancestors last)
+        const chain = await this.buildInheritanceChain(workflowId);
+        // Load child workflow for base metadata
+        const childWorkflow = await this.loadWorkflowFile(chain[0]);
+        const skipSteps = childWorkflow.skip_steps || [];
+        // Merge phases for the entire chain
+        const phases = this.mergePhasesForChain(chain, skipSteps);
+        // Validate unique step IDs across all phases
+        this.validateUniqueStepIds(phases);
+        // Build resolved workflow
+        const resolved = {
+            id: childWorkflow.id,
+            description: childWorkflow.description,
+            inheritance_chain: chain,
+            phases,
+            autonomy: childWorkflow.autonomy,
+            critical_artifacts: childWorkflow.critical_artifacts,
+            integrations: childWorkflow.integrations,
+        };
+        if (skipSteps.length > 0) {
+            resolved.skipped_steps = skipSteps;
+        }
+        return resolved;
+    }
+    /**
+     * Build the inheritance chain from a workflow ID.
+     * Returns array with child first, root ancestor last.
+     */
+    async buildInheritanceChain(workflowId) {
+        const chain = [];
+        const visited = new Set();
+        let currentId = workflowId;
+        while (currentId) {
+            // Check for circular inheritance
+            if (visited.has(currentId)) {
+                throw new CircularInheritanceError(currentId, chain);
+            }
+            visited.add(currentId);
+            chain.push(currentId);
+            // Load workflow and get extends
+            const workflow = await this.loadWorkflowFile(currentId);
+            currentId = workflow.extends;
+        }
+        return chain;
+    }
+    /**
+     * Load a workflow file by ID.
+     * Supports namespace resolution (fractary-faber:, project:, etc.)
+     */
+    async loadWorkflowFile(workflowId) {
+        // Check cache first
+        if (this.workflowCache.has(workflowId)) {
+            return this.workflowCache.get(workflowId);
+        }
+        const filePath = this.resolveWorkflowPath(workflowId);
+        const searchedPaths = [filePath];
+        if (!fs.existsSync(filePath)) {
+            // Fallback: if no explicit namespace, try plugin defaults
+            if (!workflowId.includes(':')) {
+                const fallbackPath = path.join(this.marketplaceRoot, 'fractary-faber/plugins/faber/config/workflows', `${workflowId}.json`);
+                searchedPaths.push(fallbackPath);
+                if (fs.existsSync(fallbackPath)) {
+                    return this.loadAndCacheWorkflow(workflowId, fallbackPath);
+                }
+            }
+            throw new WorkflowNotFoundError(workflowId, searchedPaths);
+        }
+        return this.loadAndCacheWorkflow(workflowId, filePath);
+    }
+    /**
+     * Load and cache a workflow from a file path.
+     */
+    loadAndCacheWorkflow(workflowId, filePath) {
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            const workflow = JSON.parse(content);
+            this.workflowCache.set(workflowId, workflow);
+            return workflow;
+        }
+        catch (error) {
+            if (error instanceof SyntaxError) {
+                throw new InvalidWorkflowError(workflowId, `JSON parse error: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Resolve a workflow ID to a file path based on namespace.
+     * Validates all path components to prevent path traversal attacks.
+     */
+    resolveWorkflowPath(workflowId) {
+        let namespace;
+        let workflowName;
+        if (workflowId.includes(':')) {
+            const parts = workflowId.split(':');
+            namespace = parts[0];
+            workflowName = parts.slice(1).join(':');
+        }
+        else {
+            namespace = 'project';
+            workflowName = workflowId;
+        }
+        // Sanitize namespace and workflow name to prevent path traversal
+        this.sanitizePathComponent(namespace, 'namespace');
+        this.sanitizePathComponent(workflowName, 'workflow name');
+        switch (namespace) {
+            case 'fractary-faber':
+                return path.join(this.marketplaceRoot, 'fractary-faber/plugins/faber/config/workflows', `${workflowName}.json`);
+            case 'fractary-faber-cloud':
+                return path.join(this.marketplaceRoot, 'fractary-faber/plugins/faber-cloud/config/workflows', `${workflowName}.json`);
+            case 'fractary-core': {
+                // Extract plugin name from workflow_name if it contains slash
+                const parts = workflowName.split('/');
+                // Sanitize each part individually
+                const plugin = this.sanitizePathComponent(parts[0], 'plugin name');
+                const workflow = parts.length > 1
+                    ? this.sanitizePathComponent(parts.slice(1).join('/'), 'workflow name')
+                    : plugin;
+                return path.join(this.marketplaceRoot, `fractary-core/plugins/${plugin}/config/workflows`, `${workflow}.json`);
+            }
+            case 'fractary-codex':
+                return path.join(this.marketplaceRoot, 'fractary-codex/plugins/codex/config/workflows', `${workflowName}.json`);
+            case 'project':
+            case '':
+                return path.join(this.projectRoot, '.fractary/faber/workflows', `${workflowName}.json`);
+            default: {
+                // Fallback to old unified marketplace for backward compatibility
+                // Sanitize the derived plugin name as well
+                const pluginName = this.sanitizePathComponent(namespace.replace('fractary-', ''), 'plugin name');
+                return path.join(this.marketplaceRoot, `fractary/plugins/${pluginName}/config/workflows`, `${workflowName}.json`);
+            }
+        }
+    }
+    /**
+     * Merge phases for an entire inheritance chain.
+     */
+    mergePhasesForChain(chain, skipSteps) {
+        const phaseNames = ['frame', 'architect', 'build', 'evaluate', 'release'];
+        const phases = {};
+        for (const phaseName of phaseNames) {
+            const mergedSteps = this.mergePhaseSteps(chain, phaseName);
+            const filteredSteps = this.applySkipSteps(mergedSteps, skipSteps);
+            // Get phase config from child workflow
+            const childWorkflow = this.workflowCache.get(chain[0]);
+            const childPhase = childWorkflow.phases?.[phaseName];
+            phases[phaseName] = {
+                enabled: childPhase?.enabled ?? true,
+                description: childPhase?.description,
+                steps: filteredSteps,
+                require_approval: childPhase?.require_approval,
+                max_retries: phaseName === 'evaluate' ? childPhase?.max_retries ?? 3 : undefined,
+            };
+        }
+        return phases;
+    }
+    /**
+     * Merge steps for a single phase across the inheritance chain.
+     *
+     * Order:
+     * 1. Pre-steps: Root ancestor first (reversed chain - index n-1 to 0)
+     * 2. Main steps: Only from child (index 0)
+     * 3. Post-steps: Child first (chain order - index 0 to n-1)
+     */
+    mergePhaseSteps(chain, phaseName) {
+        const mergedSteps = [];
+        // Pre-steps: iterate from root (last in chain) to child (first) - reversed
+        for (let i = chain.length - 1; i >= 0; i--) {
+            const workflowId = chain[i];
+            const workflow = this.workflowCache.get(workflowId);
+            const phase = workflow.phases?.[phaseName];
+            const preSteps = phase?.pre_steps || [];
+            for (const step of preSteps) {
+                mergedSteps.push({
+                    ...step,
+                    source: workflowId,
+                    position: 'pre_step',
+                });
+            }
+        }
+        // Main steps: only from child (index 0)
+        const childWorkflow = this.workflowCache.get(chain[0]);
+        const childPhase = childWorkflow.phases?.[phaseName];
+        const mainSteps = childPhase?.steps || [];
+        for (const step of mainSteps) {
+            mergedSteps.push({
+                ...step,
+                source: chain[0],
+                position: 'step',
+            });
+        }
+        // Post-steps: iterate from child (first) to root (last) - chain order
+        for (let i = 0; i < chain.length; i++) {
+            const workflowId = chain[i];
+            const workflow = this.workflowCache.get(workflowId);
+            const phase = workflow.phases?.[phaseName];
+            const postSteps = phase?.post_steps || [];
+            for (const step of postSteps) {
+                mergedSteps.push({
+                    ...step,
+                    source: workflowId,
+                    position: 'post_step',
+                });
+            }
+        }
+        return mergedSteps;
+    }
+    /**
+     * Apply skip_steps to filter out specified step IDs.
+     */
+    applySkipSteps(steps, skipSteps) {
+        if (!skipSteps || skipSteps.length === 0) {
+            return steps;
+        }
+        const skipSet = new Set(skipSteps);
+        return steps.filter((step) => !skipSet.has(step.id));
+    }
+    /**
+     * Validate that all step IDs are unique across all phases.
+     */
+    validateUniqueStepIds(phases) {
+        const allIds = new Map(); // id -> phase
+        const duplicates = [];
+        for (const [phaseName, phase] of Object.entries(phases)) {
+            for (const step of phase.steps) {
+                if (allIds.has(step.id)) {
+                    duplicates.push(`${step.id} (in ${allIds.get(step.id)} and ${phaseName})`);
+                }
+                else {
+                    allIds.set(step.id, phaseName);
+                }
+            }
+        }
+        if (duplicates.length > 0) {
+            throw new DuplicateStepIdError(duplicates);
+        }
+    }
+    /**
+     * Clear the workflow cache (useful for testing or reloading)
+     */
+    clearCache() {
+        this.workflowCache.clear();
+    }
+}
+//# sourceMappingURL=resolver.js.map

package/dist/workflow/resolver.js.map

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

package/package.json

@@ -1,106 +1,111 @@
-{
-  "name": "@fractary/faber",
-  "version": "2.2.1",
-  "description": "FABER SDK - Development toolkit for AI-assisted workflows",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    },
-    "./work": {
-      "types": "./dist/work/index.d.ts",
-      "default": "./dist/work/index.js"
-    },
-    "./repo": {
-      "types": "./dist/repo/index.d.ts",
-      "default": "./dist/repo/index.js"
-    },
-    "./spec": {
-      "types": "./dist/spec/index.d.ts",
-      "default": "./dist/spec/index.js"
-    },
-    "./logs": {
-      "types": "./dist/logs/index.d.ts",
-      "default": "./dist/logs/index.js"
-    },
-    "./state": {
-      "types": "./dist/state/index.d.ts",
-      "default": "./dist/state/index.js"
-    },
-    "./workflow": {
-      "types": "./dist/workflow/index.d.ts",
-      "default": "./dist/workflow/index.js"
-    },
-    "./storage": {
-      "types": "./dist/storage/index.d.ts",
-      "default": "./dist/storage/index.js"
-    },
-    "./agents": {
-      "types": "./dist/agents/index.d.ts",
-      "default": "./dist/agents/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "dev": "tsc --watch",
-    "build": "tsc",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "lint": "eslint src --ext .ts",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "faber",
-    "workflow",
-    "sdk",
-    "ai",
-    "development",
-    "automation",
-    "github",
-    "jira",
-    "linear",
-    "git"
-  ],
-  "author": "Fractary Team",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@fractary/forge": "^1.1.4",
-    "commander": "^12.0.0",
-    "js-yaml": "^4.1.1",
-    "zod": "^3.22.4"
-  },
-  "devDependencies": {
-    "@types/jest": "^30.0.0",
-    "@types/js-yaml": "^4.0.9",
-    "@types/node": "^20.19.26",
-    "@typescript-eslint/eslint-plugin": "^6.19.0",
-    "@typescript-eslint/parser": "^6.19.0",
-    "eslint": "^8.56.0",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.1",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.3.3"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/fractary/faber.git"
-  },
-  "bugs": {
-    "url": "https://github.com/fractary/faber/issues"
-  },
-  "homepage": "https://github.com/fractary/faber#readme"
-}
+{
+  "name": "@fractary/faber",
+  "version": "2.3.4",
+  "description": "FABER SDK - Development toolkit for AI-assisted workflows",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./work": {
+      "types": "./dist/work/index.d.ts",
+      "default": "./dist/work/index.js"
+    },
+    "./repo": {
+      "types": "./dist/repo/index.d.ts",
+      "default": "./dist/repo/index.js"
+    },
+    "./spec": {
+      "types": "./dist/spec/index.d.ts",
+      "default": "./dist/spec/index.js"
+    },
+    "./logs": {
+      "types": "./dist/logs/index.d.ts",
+      "default": "./dist/logs/index.js"
+    },
+    "./state": {
+      "types": "./dist/state/index.d.ts",
+      "default": "./dist/state/index.js"
+    },
+    "./workflow": {
+      "types": "./dist/workflow/index.d.ts",
+      "default": "./dist/workflow/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "default": "./dist/storage/index.js"
+    },
+    "./agents": {
+      "types": "./dist/agents/index.d.ts",
+      "default": "./dist/agents/index.js"
+    },
+    "./auth": {
+      "types": "./dist/auth/index.d.ts",
+      "default": "./dist/auth/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "lint": "eslint src --ext .ts",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "faber",
+    "workflow",
+    "sdk",
+    "ai",
+    "development",
+    "automation",
+    "github",
+    "jira",
+    "linear",
+    "git"
+  ],
+  "author": "Fractary Team",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "js-yaml": "^4.1.1",
+    "jsonwebtoken": "^9.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/jsonwebtoken": "^9.0.0",
+    "@types/node": "^20.19.26",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0",
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fractary/faber.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fractary/faber/issues"
+  },
+  "homepage": "https://github.com/fractary/faber#readme"
+}