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

package/dist/actions/builtin/humancy-review.js

@@ -0,0 +1,250 @@
+/**
+ * HumancyReviewAction - Human-in-the-loop review checkpoint action.
+ * Pauses workflow execution to request human review and waits for response.
+ */
+import { v4 as uuid } from 'uuid';
+import { BaseAction } from '../base-action.js';
+import { parseActionType } from '../../types/action.js';
+import { FilesystemWorkflowStore } from '../../store/filesystem-store.js';
+/** Default timeout for human review: 24 hours */
+const DEFAULT_REVIEW_TIMEOUT = 24 * 60 * 60 * 1000;
+/** Default urgency level */
+const DEFAULT_URGENCY = 'normal';
+/**
+ * HumancyReviewAction implementation.
+ * Handles humancy.request_review workflow steps.
+ */
+export class HumancyReviewAction extends BaseAction {
+    type = 'humancy.request_review';
+    store;
+    humanHandler;
+    /**
+     * Create a new HumancyReviewAction
+     * @param humanHandler Optional human handler for decision routing
+     * @param store Optional workflow store for state persistence
+     */
+    constructor(humanHandler, store) {
+        super();
+        this.humanHandler = humanHandler ?? null;
+        this.store = store ?? new FilesystemWorkflowStore();
+    }
+    /**
+     * Set the human handler for decision routing.
+     * This allows late binding when the handler is created after the action.
+     */
+    setHumanHandler(handler) {
+        this.humanHandler = handler;
+    }
+    /**
+     * Set the workflow store for state persistence.
+     */
+    setStore(store) {
+        this.store = store;
+    }
+    /**
+     * Check if this handler can process the given step
+     */
+    canHandle(step) {
+        return parseActionType(step) === 'humancy.request_review';
+    }
+    /**
+     * Validate step configuration
+     */
+    validate(step) {
+        const errors = [];
+        const warnings = [];
+        const inputs = step.with;
+        // At least artifact or context must be provided
+        if (!inputs?.artifact && !inputs?.context) {
+            errors.push({
+                field: 'with',
+                message: 'Either artifact or context must be provided',
+                code: 'MISSING_REQUIRED_INPUT',
+            });
+        }
+        // Validate urgency if provided
+        if (inputs?.urgency) {
+            const validUrgencies = ['low', 'normal', 'blocking_soon', 'blocking_now'];
+            if (!validUrgencies.includes(inputs.urgency)) {
+                errors.push({
+                    field: 'with.urgency',
+                    message: `Invalid urgency value. Must be one of: ${validUrgencies.join(', ')}`,
+                    code: 'INVALID_URGENCY',
+                });
+            }
+        }
+        // Validate timeout if provided
+        if (inputs?.timeout !== undefined) {
+            if (typeof inputs.timeout !== 'number' || inputs.timeout <= 0) {
+                errors.push({
+                    field: 'with.timeout',
+                    message: 'Timeout must be a positive number',
+                    code: 'INVALID_TIMEOUT',
+                });
+            }
+        }
+        // Warn if no human handler is configured
+        if (!this.humanHandler) {
+            warnings.push({
+                field: 'handler',
+                message: 'No human handler configured - review will simulate approval',
+                suggestion: 'Configure HumanHandler for real human review integration',
+            });
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Execute the humancy review action
+     */
+    async executeInternal(step, context) {
+        // Get input configuration
+        const artifact = this.getInput(step, context, 'artifact') ?? '';
+        const reviewContext = this.getInput(step, context, 'context') ?? '';
+        const urgency = this.getInput(step, context, 'urgency') ?? DEFAULT_URGENCY;
+        const timeout = this.getInput(step, context, 'timeout') ?? DEFAULT_REVIEW_TIMEOUT;
+        // Generate review ID
+        const reviewId = `rev_${uuid()}`;
+        // Get workflow ID from context (use name as ID since ExecutableWorkflow doesn't have id)
+        const workflowId = `wf_${context.workflow.name.replace(/[^a-zA-Z0-9]/g, '_')}_${uuid().slice(0, 8)}`;
+        const stepId = step.name;
+        context.logger.info(`Requesting human review [${reviewId}] for step: ${step.name}`);
+        context.logger.debug(`Artifact: ${artifact.substring(0, 100)}...`);
+        context.logger.debug(`Context: ${reviewContext.substring(0, 100)}...`);
+        context.logger.debug(`Urgency: ${urgency}, Timeout: ${timeout}ms`);
+        try {
+            // Save workflow state for potential resume
+            await this.saveCheckpoint(workflowId, context, step, reviewId, artifact);
+            let response;
+            if (this.humanHandler) {
+                // Real human handler integration
+                const request = {
+                    type: 'review',
+                    title: `Review: ${step.name}`,
+                    description: reviewContext || `Please review the following artifact:\n\n${artifact}`,
+                    options: [
+                        { id: 'approve', label: 'Approve' },
+                        { id: 'reject', label: 'Reject', requiresComment: true },
+                    ],
+                    workflowId,
+                    stepId,
+                    urgency,
+                    artifact,
+                };
+                response = await this.humanHandler.requestDecision(request, timeout);
+            }
+            else {
+                // Simulation mode - auto-approve after a brief delay
+                context.logger.warn('No human handler configured - simulating approval');
+                await new Promise((resolve) => setTimeout(resolve, 100));
+                response = {
+                    approved: true,
+                    respondedBy: 'simulated',
+                    respondedAt: new Date().toISOString(),
+                };
+            }
+            // Check for cancellation
+            this.checkCancellation(context);
+            // Build output
+            const output = {
+                approved: response.approved ?? (response.decision === 'approve'),
+                comments: response.input,
+                respondedBy: response.respondedBy,
+                respondedAt: response.respondedAt,
+                reviewId,
+            };
+            context.logger.info(`Human review [${reviewId}] completed: ${output.approved ? 'APPROVED' : 'REJECTED'}`);
+            // Clear checkpoint on success
+            await this.clearCheckpoint(workflowId);
+            return this.successResult(output, {
+                stdout: JSON.stringify(output, null, 2),
+            });
+        }
+        catch (error) {
+            // Handle timeout error
+            if (error instanceof Error && error.name === 'CorrelationTimeoutError') {
+                context.logger.error(`Human review [${reviewId}] timed out after ${timeout}ms`);
+                return this.failureResult('Human review timed out', {
+                    output: {
+                        reviewId,
+                        error: 'timeout',
+                        timeoutMs: timeout,
+                    },
+                });
+            }
+            // Handle cancellation
+            if (error instanceof Error && error.message === 'Action cancelled') {
+                context.logger.warn(`Human review [${reviewId}] was cancelled`);
+                return this.failureResult('Human review cancelled', {
+                    output: {
+                        reviewId,
+                        error: 'cancelled',
+                    },
+                });
+            }
+            // Handle other errors
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            context.logger.error(`Human review [${reviewId}] failed: ${errorMessage}`);
+            return this.failureResult(`Human review failed: ${errorMessage}`, {
+                output: {
+                    reviewId,
+                    error: errorMessage,
+                },
+            });
+        }
+    }
+    /**
+     * Save workflow checkpoint before waiting for human response
+     */
+    async saveCheckpoint(workflowId, context, step, reviewId, artifact) {
+        // Convert step outputs map to record
+        const stepOutputs = {};
+        for (const [id, output] of context.stepOutputs) {
+            stepOutputs[id] = {
+                raw: output.raw,
+                parsed: output.parsed,
+                exitCode: output.exitCode,
+                completedAt: output.completedAt.toISOString(),
+            };
+        }
+        const state = {
+            version: '1.0',
+            workflowId,
+            workflowFile: 'unknown', // ExecutableWorkflow doesn't track source file
+            currentPhase: context.phase.name,
+            currentStep: step.name,
+            inputs: { ...context.inputs },
+            stepOutputs,
+            pendingReview: {
+                reviewId,
+                artifact,
+                requestedAt: new Date().toISOString(),
+            },
+            startedAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        try {
+            await this.store.save(state);
+            context.logger.debug(`Saved workflow checkpoint for review [${reviewId}]`);
+        }
+        catch (error) {
+            context.logger.warn(`Failed to save workflow checkpoint: ${error instanceof Error ? error.message : String(error)}`);
+            // Non-fatal - continue without checkpoint
+        }
+    }
+    /**
+     * Clear workflow checkpoint after successful completion
+     */
+    async clearCheckpoint(workflowId) {
+        try {
+            await this.store.delete(workflowId);
+        }
+        catch {
+            // Ignore errors when clearing checkpoint
+        }
+    }
+}
+//# sourceMappingURL=humancy-review.js.map

package/dist/actions/builtin/humancy-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"humancy-review.js","sourceRoot":"","sources":["../../../src/actions/builtin/humancy-review.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAY/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E,iDAAiD;AACjD,MAAM,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEnD,4BAA4B;AAC5B,MAAM,eAAe,GAAmB,QAAQ,CAAC;AAmCjD;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACxC,IAAI,GAAe,wBAAwB,CAAC;IAC7C,KAAK,CAAgB;IACrB,YAAY,CAA8B;IAElD;;;;OAIG;IACH,YAAY,YAAmC,EAAE,KAAqB;QACpE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,IAAI,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,uBAAuB,EAAE,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,OAA6B;QAC3C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAoB;QAC3B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,IAAoB;QAC5B,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,wBAAwB,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAoB;QAC3B,MAAM,MAAM,GAA4D,EAAE,CAAC;QAC3E,MAAM,QAAQ,GAAmE,EAAE,CAAC;QAEpF,MAAM,MAAM,GAAG,IAAI,CAAC,IAA+C,CAAC;QAEpE,gDAAgD;QAChD,IAAI,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,6CAA6C;gBACtD,IAAI,EAAE,wBAAwB;aAC/B,CAAC,CAAC;QACL,CAAC;QAED,+BAA+B;QAC/B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,cAAc,GAAqB,CAAC,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;YAC5F,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,cAAc;oBACrB,OAAO,EAAE,0CAA0C,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;oBAC9E,IAAI,EAAE,iBAAiB;iBACxB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,IAAI,MAAM,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;gBAC9D,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,cAAc;oBACrB,OAAO,EAAE,mCAAmC;oBAC5C,IAAI,EAAE,iBAAiB;iBACxB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,yCAAyC;QACzC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,6DAA6D;gBACtE,UAAU,EAAE,0DAA0D;aACvE,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,eAAe,CAC7B,IAAoB,EACpB,OAAsB;QAEtB,0BAA0B;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAS,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;QACxE,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAS,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC;QAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAiB,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,eAAe,CAAC;QAC3F,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAS,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,sBAAsB,CAAC;QAE1F,qBAAqB;QACrB,MAAM,QAAQ,GAAG,OAAO,IAAI,EAAE,EAAE,CAAC;QAEjC,yFAAyF;QACzF,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACrG,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC;QAEzB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,QAAQ,eAAe,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,cAAc,OAAO,IAAI,CAAC,CAAC;QAEnE,IAAI,CAAC;YACH,2CAA2C;YAC3C,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAEzE,IAAI,QAAgC,CAAC;YAErC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,iCAAiC;gBACjC,MAAM,OAAO,GAA0B;oBACrC,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE;oBAC7B,WAAW,EAAE,aAAa,IAAI,4CAA4C,QAAQ,EAAE;oBACpF,OAAO,EAAE;wBACP,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;wBACnC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE;qBACzD;oBACD,UAAU;oBACV,MAAM;oBACN,OAAO;oBACP,QAAQ;iBACT,CAAC;gBAEF,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvE,CAAC;iBAAM,CAAC;gBACN,qDAAqD;gBACrD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;gBACzE,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;gBACzD,QAAQ,GAAG;oBACT,QAAQ,EAAE,IAAI;oBACd,WAAW,EAAE,WAAW;oBACxB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACtC,CAAC;YACJ,CAAC;YAED,yBAAyB;YACzB,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAEhC,eAAe;YACf,MAAM,MAAM,GAAwB;gBAClC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC;gBAChE,QAAQ,EAAE,QAAQ,CAAC,KAAK;gBACxB,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,QAAQ;aACT,CAAC;YAEF,OAAO,CAAC,MAAM,CAAC,IAAI,CACjB,iBAAiB,QAAQ,gBAAgB,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,EAAE,CACrF,CAAC;YAEF,8BAA8B;YAC9B,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YAEvC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE;gBAChC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACxC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,uBAAuB;YACvB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;gBACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,QAAQ,qBAAqB,OAAO,IAAI,CAAC,CAAC;gBAChF,OAAO,IAAI,CAAC,aAAa,CAAC,wBAAwB,EAAE;oBAClD,MAAM,EAAE;wBACN,QAAQ;wBACR,KAAK,EAAE,SAAS;wBAChB,SAAS,EAAE,OAAO;qBACnB;iBACF,CAAC,CAAC;YACL,CAAC;YAED,sBAAsB;YACtB,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,kBAAkB,EAAE,CAAC;gBACnE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,QAAQ,iBAAiB,CAAC,CAAC;gBAChE,OAAO,IAAI,CAAC,aAAa,CAAC,wBAAwB,EAAE;oBAClD,MAAM,EAAE;wBACN,QAAQ;wBACR,KAAK,EAAE,WAAW;qBACnB;iBACF,CAAC,CAAC;YACL,CAAC;YAED,sBAAsB;YACtB,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,QAAQ,aAAa,YAAY,EAAE,CAAC,CAAC;YAE3E,OAAO,IAAI,CAAC,aAAa,CAAC,wBAAwB,YAAY,EAAE,EAAE;gBAChE,MAAM,EAAE;oBACN,QAAQ;oBACR,KAAK,EAAE,YAAY;iBACpB;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAC1B,UAAkB,EAClB,OAAsB,EACtB,IAAoB,EACpB,QAAgB,EAChB,QAAgB;QAEhB,qCAAqC;QACrC,MAAM,WAAW,GAA4F,EAAE,CAAC;QAChH,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAC/C,WAAW,CAAC,EAAE,CAAC,GAAG;gBAChB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,WAAW,EAAE;aAC9C,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAkB;YAC3B,OAAO,EAAE,KAAK;YACd,UAAU;YACV,YAAY,EAAE,SAAS,EAAE,+CAA+C;YACxE,YAAY,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI;YAChC,WAAW,EAAE,IAAI,CAAC,IAAI;YACtB,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE;YAC7B,WAAW;YACX,aAAa,EAAE;gBACb,QAAQ;gBACR,QAAQ;gBACR,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC;YACD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,QAAQ,GAAG,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,CAAC,IAAI,CACjB,uCAAuC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAChG,CAAC;YACF,0CAA0C;QAC5C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,UAAkB;QAC9C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;IACH,CAAC;CACF"}

package/dist/actions/builtin/pr-create.d.ts

@@ -0,0 +1,16 @@
+/**
+ * PR create action handler.
+ * Handles GitHub pull request creation.
+ */
+import { BaseAction } from '../base-action.js';
+import type { ActionContext, ActionResult, ActionType, ValidationResult, StepDefinition } from '../../types/index.js';
+/**
+ * Action handler for GitHub PR creation
+ */
+export declare class PrCreateAction extends BaseAction {
+    readonly type: ActionType;
+    canHandle(step: StepDefinition): boolean;
+    validate(step: StepDefinition): ValidationResult;
+    protected executeInternal(step: StepDefinition, context: ActionContext): Promise<Omit<ActionResult, 'duration'>>;
+}
+//# sourceMappingURL=pr-create.d.ts.map

package/dist/actions/builtin/pr-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-create.d.ts","sourceRoot":"","sources":["../../../src/actions/builtin/pr-create.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,gBAAgB,EAGhB,cAAc,EAGf,MAAM,sBAAsB,CAAC;AAI9B;;GAEG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAe;IAExC,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAIxC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB;cAqBhC,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;CA4F3C"}

package/dist/actions/builtin/pr-create.js

@@ -0,0 +1,110 @@
+/**
+ * PR create action handler.
+ * Handles GitHub pull request creation.
+ */
+import { BaseAction } from '../base-action.js';
+import { parseActionType } from '../../types/action.js';
+import { executeCommand } from '../cli-utils.js';
+/**
+ * Action handler for GitHub PR creation
+ */
+export class PrCreateAction extends BaseAction {
+    type = 'pr.create';
+    canHandle(step) {
+        return parseActionType(step) === 'pr.create';
+    }
+    validate(step) {
+        const errors = [];
+        const warnings = [];
+        const title = step.with?.['title'];
+        if (!title) {
+            errors.push({
+                field: 'title',
+                message: 'Title is required for pr.create action',
+                code: 'MISSING_TITLE',
+            });
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    async executeInternal(step, context) {
+        const input = {
+            title: this.getRequiredInput(step, context, 'title'),
+            body: this.getInput(step, context, 'body'),
+            base: this.getInput(step, context, 'base'),
+            draft: this.getInput(step, context, 'draft', false),
+            labels: this.getInput(step, context, 'labels'),
+            reviewers: this.getInput(step, context, 'reviewers'),
+        };
+        context.logger.info(`Creating PR: ${input.title}`);
+        try {
+            // Build gh pr create command arguments
+            const args = ['pr', 'create', '--title', input.title];
+            if (input.body) {
+                args.push('--body', input.body);
+            }
+            else {
+                args.push('--body', '');
+            }
+            if (input.base) {
+                args.push('--base', input.base);
+            }
+            if (input.draft) {
+                args.push('--draft');
+            }
+            if (input.labels && input.labels.length > 0) {
+                for (const label of input.labels) {
+                    args.push('--label', label);
+                }
+            }
+            if (input.reviewers && input.reviewers.length > 0) {
+                for (const reviewer of input.reviewers) {
+                    args.push('--reviewer', reviewer);
+                }
+            }
+            // Execute gh pr create
+            const result = await executeCommand('gh', args, {
+                cwd: context.workdir,
+                env: this.mergeEnv(context, step.env),
+                timeout: step.timeout ?? 60000, // 1 minute default
+                signal: context.signal,
+            });
+            // Check exit code
+            if (result.exitCode !== 0) {
+                return this.failureResult(`Failed to create PR: ${result.stderr || result.stdout}`, {
+                    exitCode: result.exitCode,
+                    stdout: result.stdout,
+                    stderr: result.stderr,
+                });
+            }
+            // Parse PR URL from output (gh pr create outputs the URL to stdout)
+            const urlMatch = result.stdout.match(/https:\/\/github\.com\/[^\s]+\/pull\/(\d+)/);
+            if (!urlMatch) {
+                return this.failureResult('Failed to parse PR creation output', {
+                    stdout: result.stdout,
+                    stderr: result.stderr,
+                });
+            }
+            const prOutput = {
+                number: parseInt(urlMatch[1], 10),
+                url: urlMatch[0],
+                state: input.draft ? 'draft' : 'open',
+                headBranch: '',
+                baseBranch: input.base ?? 'main',
+            };
+            context.logger.info(`PR created: ${prOutput.url}`);
+            return this.successResult(prOutput, {
+                exitCode: result.exitCode,
+                stdout: result.stdout,
+                stderr: result.stderr,
+            });
+        }
+        catch (error) {
+            return this.failureResult(error instanceof Error ? error.message : String(error));
+        }
+    }
+}
+//# sourceMappingURL=pr-create.js.map

package/dist/actions/builtin/pr-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-create.js","sourceRoot":"","sources":["../../../src/actions/builtin/pr-create.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAY/C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,UAAU;IACnC,IAAI,GAAe,WAAW,CAAC;IAExC,SAAS,CAAC,IAAoB;QAC5B,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC;IAC/C,CAAC;IAED,QAAQ,CAAC,IAAoB;QAC3B,MAAM,MAAM,GAAsB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAwB,EAAE,CAAC;QAEzC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC;QAEnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,CAAC,IAAI,CAAC;gBACV,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,wCAAwC;gBACjD,IAAI,EAAE,eAAe;aACtB,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,eAAe,CAC7B,IAAoB,EACpB,OAAsB;QAEtB,MAAM,KAAK,GAAkB;YAC3B,KAAK,EAAE,IAAI,CAAC,gBAAgB,CAAS,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC;YAC5D,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAS,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;YAClD,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAS,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;YAClD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAU,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC;YAC5D,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAW,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC;YACxD,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAW,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC;SAC/D,CAAC;QAEF,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAEnD,IAAI,CAAC;YACH,uCAAuC;YACvC,MAAM,IAAI,GAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAEhE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC1B,CAAC;YAED,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;YAED,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YAED,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClD,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;oBACvC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;gBACpC,CAAC;YACH,CAAC;YAED,uBAAuB;YACvB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE;gBAC9C,GAAG,EAAE,OAAO,CAAC,OAAO;gBACpB,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC;gBACrC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,KAAK,EAAE,mBAAmB;gBACnD,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC;YAEH,kBAAkB;YAClB,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC,aAAa,CACvB,wBAAwB,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,EACxD;oBACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB,CACF,CAAC;YACJ,CAAC;YAED,oEAAoE;YACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;YACnF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,IAAI,CAAC,aAAa,CAAC,oCAAoC,EAAE;oBAC9D,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB,CAAC,CAAC;YACL,CAAC;YAED,MAAM,QAAQ,GAAmB;gBAC/B,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;gBAClC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAE;gBACjB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;gBACrC,UAAU,EAAE,EAAE;gBACd,UAAU,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM;aACjC,CAAC;YAEF,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;YAEnD,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE;gBAClC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,aAAa,CACvB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/actions/builtin/shell.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Shell action handler.
+ * Handles generic shell command execution as a fallback.
+ */
+import { BaseAction } from '../base-action.js';
+import type { ActionContext, ActionResult, ActionType, ValidationResult, StepDefinition } from '../../types/index.js';
+/**
+ * Action handler for shell commands (fallback handler)
+ */
+export declare class ShellAction extends BaseAction {
+    readonly type: ActionType;
+    canHandle(step: StepDefinition): boolean;
+    validate(step: StepDefinition): ValidationResult;
+    protected executeInternal(step: StepDefinition, context: ActionContext): Promise<Omit<ActionResult, 'duration'>>;
+}
+//# sourceMappingURL=shell.d.ts.map

package/dist/actions/builtin/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/actions/builtin/shell.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,gBAAgB,EAGhB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAI9B;;GAEG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAW;IAEpC,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAIxC,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB;cAsBhC,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;CAwD3C"}

package/dist/actions/builtin/shell.js

@@ -0,0 +1,80 @@
+/**
+ * Shell action handler.
+ * Handles generic shell command execution as a fallback.
+ */
+import { BaseAction } from '../base-action.js';
+import { parseActionType } from '../../types/action.js';
+import { executeShellCommand, extractJSON } from '../cli-utils.js';
+/**
+ * Action handler for shell commands (fallback handler)
+ */
+export class ShellAction extends BaseAction {
+    type = 'shell';
+    canHandle(step) {
+        return parseActionType(step) === 'shell';
+    }
+    validate(step) {
+        const errors = [];
+        const warnings = [];
+        // Get command from step
+        const command = step.command ?? step.script;
+        if (!command) {
+            errors.push({
+                field: 'command',
+                message: 'Command or script is required for shell action',
+                code: 'MISSING_COMMAND',
+            });
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    async executeInternal(step, context) {
+        // Get command from step
+        const command = step.command ?? step.script;
+        if (!command) {
+            return this.failureResult('Command or script is required');
+        }
+        context.logger.info(`Executing shell command: ${command.substring(0, 50)}...`);
+        try {
+            // Execute the shell command
+            const result = await executeShellCommand(command, {
+                cwd: context.workdir,
+                env: this.mergeEnv(context, step.env),
+                timeout: step.timeout ?? 300000, // 5 minute default
+                signal: context.signal,
+            });
+            // Try to parse JSON from output
+            const parsedOutput = extractJSON(result.stdout);
+            // Check exit code
+            if (result.exitCode !== 0) {
+                if (!step.continueOnError) {
+                    return this.failureResult(`Command failed with exit code ${result.exitCode}`, {
+                        output: parsedOutput ?? result.stdout,
+                        exitCode: result.exitCode,
+                        stdout: result.stdout,
+                        stderr: result.stderr,
+                    });
+                }
+                // Log the failure even when continueOnError suppresses it
+                const stderrSnippet = result.stderr?.trim().split('\n').slice(-3).join('\n');
+                context.logger.warn(`Shell command failed with exit code ${result.exitCode} (continueOnError=true)` +
+                    (stderrSnippet ? `\n${stderrSnippet}` : ''));
+            }
+            else {
+                context.logger.info('Shell command completed');
+            }
+            return this.successResult(parsedOutput ?? result.stdout, {
+                exitCode: result.exitCode,
+                stdout: result.stdout,
+                stderr: result.stderr,
+            });
+        }
+        catch (error) {
+            return this.failureResult(error instanceof Error ? error.message : String(error));
+        }
+    }
+}
+//# sourceMappingURL=shell.js.map

package/dist/actions/builtin/shell.js.map

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

package/dist/actions/builtin/speckit/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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 type { ActionContext, ActionResult, ActionType, ValidationResult, StepDefinition } from '../../../types/index.js';
+/**
+ * Action handler for speckit workflow operations.
+ * Dispatches to specific operation handlers based on the operation extracted from step.uses/step.action.
+ */
+export declare class SpecKitAction extends BaseAction {
+    readonly type: ActionType;
+    /**
+     * Check if this handler can process the given step
+     */
+    canHandle(step: StepDefinition): boolean;
+    /**
+     * Extract operation name from step definition
+     * @param step Workflow step definition
+     * @returns Operation name (e.g., 'create_feature', 'specify')
+     */
+    protected extractOperation(step: StepDefinition): string;
+    /**
+     * Validate step configuration before execution
+     */
+    validate(step: StepDefinition): ValidationResult;
+    /**
+     * Execute the speckit operation
+     */
+    protected executeInternal(step: StepDefinition, context: ActionContext): Promise<Omit<ActionResult, 'duration'>>;
+    private handleCreateFeature;
+    private handleGetPaths;
+    private handleCheckPrereqs;
+    private handleCopyTemplate;
+    private handleSpecify;
+    private handleClarify;
+    private handlePlan;
+    private handleTasks;
+    private handleImplement;
+    private handleTasksToIssues;
+}
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/builtin/speckit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/builtin/speckit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,UAAU,EACV,gBAAgB,EAEhB,cAAc,EACf,MAAM,yBAAyB,CAAC;AAmDjC;;;GAGG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAa;IAEtC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAKxC;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAOxD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,gBAAgB;IA6GhD;;OAEG;cACa,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YA2C5B,mBAAmB;YAsBnB,cAAc;YAiBd,kBAAkB;YAqBlB,kBAAkB;YAuBlB,aAAa;YAoBb,aAAa;YAoBb,UAAU;YAmBV,WAAW;YAmBX,eAAe;YAsBf,mBAAmB;CAsBlC;AAGD,cAAc,YAAY,CAAC"}