@generacy-ai/workflow-engine 0.0.0-preview-20260304013206

package/dist/actions/builtin/speckit/index.js

@@ -0,0 +1,347 @@
+/**
+ * SpecKit action handler.
+ * Implements speckit workflow operations for spec-driven development methodology.
+ *
+ * Operations are divided into two categories:
+ * - Deterministic: Direct library calls (create_feature, get_paths, check_prereqs, copy_template)
+ * - AI-dependent: Agent delegation (specify, clarify, plan, tasks, implement)
+ */
+import { BaseAction } from '../../base-action.js';
+// Import operation handlers
+import { executeCreateFeature } from './operations/create-feature.js';
+import { executeGetPaths } from './operations/get-paths.js';
+import { executeCheckPrereqs } from './operations/check-prereqs.js';
+import { executeCopyTemplate } from './operations/copy-template.js';
+import { executeSpecify } from './operations/specify.js';
+import { executeClarify } from './operations/clarify.js';
+import { executePlan } from './operations/plan.js';
+import { executeTasks } from './operations/tasks.js';
+import { executeImplement } from './operations/implement.js';
+import { executeTasksToIssues } from './operations/tasks-to-issues.js';
+/** Valid speckit operations */
+const VALID_OPERATIONS = new Set([
+    'create_feature',
+    'get_paths',
+    'check_prereqs',
+    'copy_template',
+    'specify',
+    'clarify',
+    'plan',
+    'tasks',
+    'implement',
+    'tasks_to_issues',
+]);
+/**
+ * Action handler for speckit workflow operations.
+ * Dispatches to specific operation handlers based on the operation extracted from step.uses/step.action.
+ */
+export class SpecKitAction extends BaseAction {
+    type = 'speckit';
+    /**
+     * Check if this handler can process the given step
+     */
+    canHandle(step) {
+        const uses = step.uses || step.action || '';
+        return uses.startsWith('speckit.') || uses.startsWith('speckit/');
+    }
+    /**
+     * Extract operation name from step definition
+     * @param step Workflow step definition
+     * @returns Operation name (e.g., 'create_feature', 'specify')
+     */
+    extractOperation(step) {
+        const actionString = step.uses || step.action || '';
+        // Match speckit.create_feature or speckit/create_feature
+        const match = actionString.match(/^speckit[./](.+)$/);
+        return match?.[1] || '';
+    }
+    /**
+     * Validate step configuration before execution
+     */
+    validate(step) {
+        const errors = [];
+        const operation = this.extractOperation(step);
+        if (!operation) {
+            errors.push({
+                field: 'uses',
+                message: 'Speckit operation not specified. Use format: speckit.<operation>',
+                code: 'MISSING_OPERATION',
+            });
+            return { valid: false, errors, warnings: [] };
+        }
+        if (!VALID_OPERATIONS.has(operation)) {
+            errors.push({
+                field: 'uses',
+                message: `Unknown speckit operation: ${operation}. Valid operations: ${[...VALID_OPERATIONS].join(', ')}`,
+                code: 'INVALID_OPERATION',
+            });
+            return { valid: false, errors, warnings: [] };
+        }
+        // Operation-specific validation
+        switch (operation) {
+            case 'create_feature': {
+                const description = step.with?.['description'];
+                if (!description) {
+                    errors.push({
+                        field: 'description',
+                        message: 'Description is required for create_feature operation',
+                        code: 'MISSING_DESCRIPTION',
+                    });
+                }
+                break;
+            }
+            case 'specify':
+            case 'plan':
+            case 'tasks':
+            case 'implement': {
+                const featureDir = step.with?.['feature_dir'];
+                if (!featureDir) {
+                    errors.push({
+                        field: 'feature_dir',
+                        message: `feature_dir is required for ${operation} operation`,
+                        code: 'MISSING_FEATURE_DIR',
+                    });
+                }
+                break;
+            }
+            case 'clarify': {
+                const featureDir = step.with?.['feature_dir'];
+                if (!featureDir) {
+                    errors.push({
+                        field: 'feature_dir',
+                        message: 'feature_dir is required for clarify operation',
+                        code: 'MISSING_FEATURE_DIR',
+                    });
+                }
+                break;
+            }
+            case 'copy_template': {
+                const templates = step.with?.['templates'];
+                if (!templates || !Array.isArray(templates) || templates.length === 0) {
+                    errors.push({
+                        field: 'templates',
+                        message: 'templates array is required for copy_template operation',
+                        code: 'MISSING_TEMPLATES',
+                    });
+                }
+                break;
+            }
+            case 'tasks_to_issues': {
+                const featureDir = step.with?.['feature_dir'];
+                if (!featureDir) {
+                    errors.push({
+                        field: 'feature_dir',
+                        message: 'feature_dir is required for tasks_to_issues operation',
+                        code: 'MISSING_FEATURE_DIR',
+                    });
+                }
+                const epicIssueNumber = step.with?.['epic_issue_number'];
+                if (epicIssueNumber == null) {
+                    errors.push({
+                        field: 'epic_issue_number',
+                        message: 'epic_issue_number is required for tasks_to_issues operation',
+                        code: 'MISSING_EPIC_ISSUE_NUMBER',
+                    });
+                }
+                const epicBranch = step.with?.['epic_branch'];
+                if (!epicBranch) {
+                    errors.push({
+                        field: 'epic_branch',
+                        message: 'epic_branch is required for tasks_to_issues operation',
+                        code: 'MISSING_EPIC_BRANCH',
+                    });
+                }
+                break;
+            }
+            // get_paths and check_prereqs have optional inputs
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings: [],
+        };
+    }
+    /**
+     * Execute the speckit operation
+     */
+    async executeInternal(step, context) {
+        const operation = this.extractOperation(step);
+        if (!operation || !VALID_OPERATIONS.has(operation)) {
+            return this.failureResult(`Invalid speckit operation: ${operation}`);
+        }
+        context.logger.info(`Executing speckit.${operation}`);
+        try {
+            switch (operation) {
+                case 'create_feature':
+                    return await this.handleCreateFeature(step, context);
+                case 'get_paths':
+                    return await this.handleGetPaths(step, context);
+                case 'check_prereqs':
+                    return await this.handleCheckPrereqs(step, context);
+                case 'copy_template':
+                    return await this.handleCopyTemplate(step, context);
+                case 'specify':
+                    return await this.handleSpecify(step, context);
+                case 'clarify':
+                    return await this.handleClarify(step, context);
+                case 'plan':
+                    return await this.handlePlan(step, context);
+                case 'tasks':
+                    return await this.handleTasks(step, context);
+                case 'implement':
+                    return await this.handleImplement(step, context);
+                case 'tasks_to_issues':
+                    return await this.handleTasksToIssues(step, context);
+                default:
+                    return this.failureResult(`Unhandled speckit operation: ${operation}`);
+            }
+        }
+        catch (error) {
+            return this.failureResult(error instanceof Error ? error.message : String(error));
+        }
+    }
+    // --- Deterministic Operation Handlers (Library Calls) ---
+    async handleCreateFeature(step, context) {
+        const input = {
+            description: this.getRequiredInput(step, context, 'description'),
+            short_name: this.getInput(step, context, 'short_name'),
+            number: this.getInput(step, context, 'number'),
+            parent_epic_branch: this.getInput(step, context, 'parent_epic_branch'),
+            cwd: this.getInput(step, context, 'cwd', context.workdir),
+        };
+        const result = await executeCreateFeature(input, context.logger);
+        if (result.success) {
+            return this.successResult(result, {
+                filesModified: [result.spec_file],
+            });
+        }
+        return this.failureResult('create_feature operation failed', { output: result });
+    }
+    async handleGetPaths(step, context) {
+        const input = {
+            branch: this.getInput(step, context, 'branch'),
+            cwd: this.getInput(step, context, 'cwd', context.workdir),
+        };
+        const result = await executeGetPaths(input, context.logger);
+        if (result.success) {
+            return this.successResult(result);
+        }
+        return this.failureResult('get_paths operation failed', { output: result });
+    }
+    async handleCheckPrereqs(step, context) {
+        const input = {
+            branch: this.getInput(step, context, 'branch'),
+            require_spec: this.getInput(step, context, 'require_spec', true),
+            require_plan: this.getInput(step, context, 'require_plan', false),
+            require_tasks: this.getInput(step, context, 'require_tasks', false),
+            include_tasks: this.getInput(step, context, 'include_tasks', false),
+            cwd: this.getInput(step, context, 'cwd', context.workdir),
+        };
+        const result = await executeCheckPrereqs(input, context.logger);
+        if (result.valid) {
+            return this.successResult(result);
+        }
+        return this.failureResult(result.error || 'check_prereqs failed', { output: result });
+    }
+    async handleCopyTemplate(step, context) {
+        const input = {
+            templates: this.getRequiredInput(step, context, 'templates'),
+            feature_dir: this.getInput(step, context, 'feature_dir'),
+            dest_filename: this.getInput(step, context, 'dest_filename'),
+            cwd: this.getInput(step, context, 'cwd', context.workdir),
+        };
+        const result = await executeCopyTemplate(input, context.logger);
+        if (result.success) {
+            return this.successResult(result, {
+                filesModified: result.copied.map(c => c.destPath),
+            });
+        }
+        return this.failureResult('copy_template operation failed', { output: result });
+    }
+    // --- AI-Dependent Operation Handlers (Agent Delegation) ---
+    async handleSpecify(step, context) {
+        const input = {
+            feature_dir: this.getRequiredInput(step, context, 'feature_dir'),
+            issue_url: this.getInput(step, context, 'issue_url'),
+            timeout: this.getInput(step, context, 'timeout', 300),
+        };
+        const result = await executeSpecify(input, context);
+        if (result.success) {
+            return this.successResult(result, {
+                filesModified: [result.spec_file],
+            });
+        }
+        return this.failureResult('specify operation failed', { output: result });
+    }
+    async handleClarify(step, context) {
+        const input = {
+            feature_dir: this.getRequiredInput(step, context, 'feature_dir'),
+            issue_number: this.getInput(step, context, 'issue_number'),
+            timeout: this.getInput(step, context, 'timeout', 300),
+        };
+        const result = await executeClarify(input, context);
+        if (result.success) {
+            return this.successResult(result, {
+                filesModified: [result.clarifications_file],
+            });
+        }
+        return this.failureResult('clarify operation failed', { output: result });
+    }
+    async handlePlan(step, context) {
+        const input = {
+            feature_dir: this.getRequiredInput(step, context, 'feature_dir'),
+            timeout: this.getInput(step, context, 'timeout', 600),
+        };
+        const result = await executePlan(input, context);
+        if (result.success) {
+            return this.successResult(result, {
+                filesModified: [result.plan_file, ...result.artifacts_created],
+            });
+        }
+        return this.failureResult('plan operation failed', { output: result });
+    }
+    async handleTasks(step, context) {
+        const input = {
+            feature_dir: this.getRequiredInput(step, context, 'feature_dir'),
+            timeout: this.getInput(step, context, 'timeout', 300),
+        };
+        const result = await executeTasks(input, context);
+        if (result.success) {
+            return this.successResult(result, {
+                filesModified: [result.tasks_file],
+            });
+        }
+        return this.failureResult('tasks operation failed', { output: result });
+    }
+    async handleImplement(step, context) {
+        const input = {
+            feature_dir: this.getRequiredInput(step, context, 'feature_dir'),
+            task_filter: this.getInput(step, context, 'task_filter'),
+            timeout: this.getInput(step, context, 'timeout', 600),
+        };
+        const result = await executeImplement(input, context);
+        if (result.success) {
+            return this.successResult(result, {
+                filesModified: result.files_modified,
+            });
+        }
+        return this.failureResult('implement operation failed', { output: result });
+    }
+    // --- Epic Operation Handlers ---
+    async handleTasksToIssues(step, context) {
+        const input = {
+            feature_dir: this.getRequiredInput(step, context, 'feature_dir'),
+            epic_issue_number: this.getRequiredInput(step, context, 'epic_issue_number'),
+            epic_branch: this.getRequiredInput(step, context, 'epic_branch'),
+            trigger_label: this.getInput(step, context, 'trigger_label'),
+        };
+        const result = await executeTasksToIssues(input, context);
+        if (result.failed_tasks.length > 0 && result.created_issues.length === 0) {
+            return this.failureResult(`tasks_to_issues failed: all ${result.failed_tasks.length} tasks failed to create issues`, { output: result });
+        }
+        return this.successResult(result);
+    }
+}
+// Export types for external use
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/actions/builtin/speckit/index.js.map

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

package/dist/actions/builtin/speckit/lib/feature.d.ts

@@ -0,0 +1,17 @@
+import { type SimpleGit } from 'simple-git';
+import type { CreateFeatureInput, CreateFeatureOutput } from '../types.js';
+/** Pattern for valid feature names: \d+-short-name (flexible number padding) */
+export declare const FEATURE_NAME_PATTERN: RegExp;
+/** Maximum branch name length (GitHub limit) */
+export declare const MAX_BRANCH_LENGTH = 244;
+/**
+ * Resolve the default branch name from the remote's HEAD reference.
+ * Falls back to 'develop' if the symbolic-ref cannot be read (e.g. shallow clone, detached HEAD).
+ */
+export declare function getDefaultBranch(git: SimpleGit): Promise<string>;
+/**
+ * Create a new feature branch and initialize the spec directory with template files.
+ * Ported from speckit MCP create_feature tool.
+ */
+export declare function createFeature(input: CreateFeatureInput): Promise<CreateFeatureOutput>;
+//# sourceMappingURL=feature.d.ts.map

package/dist/actions/builtin/speckit/lib/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../../../../src/actions/builtin/speckit/lib/feature.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAUvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE3E,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,QAAmC,CAAC;AAErE,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAsOrC;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAStE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqO3F"}