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

package/dist/actions/github/get-context.js

@@ -0,0 +1,109 @@
+/**
+ * github.get_context action - retrieves spec artifacts for context.
+ * Loads spec.md, plan.md, tasks.md and determines current phase.
+ */
+import { BaseAction } from '../base-action.js';
+import { isNamespacedAction } from '../../types/action.js';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Determine current phase from tasks.md content
+ */
+function determinePhaseFromTasks(tasks) {
+    // Check if all tasks are complete
+    const incompleteTasks = tasks.match(/- \[ \]/g);
+    const completeTasks = tasks.match(/- \[x\]/gi);
+    if (!incompleteTasks || incompleteTasks.length === 0) {
+        return 'validate'; // All done
+    }
+    if (!completeTasks || completeTasks.length === 0) {
+        return 'implement'; // Starting implementation
+    }
+    return 'implement'; // In progress
+}
+/**
+ * github.get_context action handler
+ */
+export class GetContextAction extends BaseAction {
+    type = 'github.get_context';
+    canHandle(step) {
+        const uses = step.uses ?? step.action;
+        if (!uses)
+            return false;
+        return uses === 'github.get_context' ||
+            (isNamespacedAction(uses) && uses === this.type);
+    }
+    async executeInternal(step, context) {
+        // Get inputs
+        const issueNumber = this.getRequiredInput(step, context, 'issue_number');
+        const parentEpicNumber = this.getInput(step, context, 'parent_epic_number');
+        const issueBody = this.getInput(step, context, 'issue_body');
+        context.logger.info(`Getting context for issue #${issueNumber}`);
+        try {
+            // Find feature directory
+            const specsDir = join(context.workdir, 'specs');
+            const featureDir = this.findFeatureDir(specsDir, issueNumber);
+            if (!featureDir) {
+                return this.failureResult(`No spec directory found for issue #${issueNumber}`);
+            }
+            const featurePath = join(specsDir, featureDir);
+            // Read artifacts
+            const spec = this.readArtifact(featurePath, 'spec.md');
+            const plan = this.readArtifact(featurePath, 'plan.md');
+            const tasks = this.readArtifact(featurePath, 'tasks.md');
+            // Determine phase
+            let phase = 'specify';
+            if (spec && !plan)
+                phase = 'plan';
+            else if (plan && !tasks)
+                phase = 'tasks';
+            else if (tasks)
+                phase = determinePhaseFromTasks(tasks);
+            // Build output
+            const output = {
+                spec,
+                plan,
+                tasks,
+                phase,
+                feature_dir: featurePath,
+            };
+            // If this is an epic child, load parent context
+            if (parentEpicNumber) {
+                const parentDir = this.findFeatureDir(specsDir, parentEpicNumber);
+                if (parentDir) {
+                    const parentPath = join(specsDir, parentDir);
+                    output.epic_context = {
+                        parent_spec: this.readArtifact(parentPath, 'spec.md'),
+                        parent_plan: this.readArtifact(parentPath, 'plan.md'),
+                        parent_tasks: this.readArtifact(parentPath, 'tasks.md'),
+                    };
+                }
+            }
+            return this.successResult(output);
+        }
+        catch (error) {
+            return this.failureResult(error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Find the feature directory for an issue number
+     */
+    findFeatureDir(specsDir, issueNumber) {
+        if (!existsSync(specsDir)) {
+            return undefined;
+        }
+        const dirs = readdirSync(specsDir);
+        return dirs.find(d => d.startsWith(`${issueNumber}-`));
+    }
+    /**
+     * Read an artifact file, returning undefined if it doesn't exist
+     */
+    readArtifact(featurePath, filename) {
+        const filepath = join(featurePath, filename);
+        if (!existsSync(filepath)) {
+            return undefined;
+        }
+        return readFileSync(filepath, 'utf-8');
+    }
+}
+//# sourceMappingURL=get-context.js.map

package/dist/actions/github/get-context.js.map

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

package/dist/actions/github/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * GitHub action namespace registration.
+ * Exports all github.* actions and provides namespace registration.
+ */
+import type { ActionNamespace, ActionHandler } from '../../types/index.js';
+export { PreflightAction } from './preflight.js';
+export { GetContextAction } from './get-context.js';
+export { ReviewChangesAction } from './review-changes.js';
+export { CommitAndPushAction } from './commit-and-push.js';
+export { MergeFromBaseAction } from './merge-from-base.js';
+export { CreateDraftPRAction } from './create-draft-pr.js';
+export { MarkPRReadyAction } from './mark-pr-ready.js';
+export { UpdatePRAction } from './update-pr.js';
+export { ReadPRFeedbackAction } from './read-pr-feedback.js';
+export { RespondPRFeedbackAction } from './respond-pr-feedback.js';
+export { AddCommentAction } from './add-comment.js';
+export { SyncLabelsAction } from './sync-labels.js';
+export * from './client/index.js';
+export { parseGitHubIssueUrl } from './preflight.js';
+/**
+ * All GitHub action handlers
+ */
+export declare const githubActionHandlers: ActionHandler[];
+/**
+ * GitHub action namespace definition
+ */
+export declare const githubNamespace: ActionNamespace;
+/**
+ * Get all GitHub action handlers
+ */
+export declare function getGitHubActionHandlers(): ActionHandler[];
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/github/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/github/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAqB3E,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,cAAc,mBAAmB,CAAC;AAGlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,aAAa,EAgB/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,eAI7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,EAAE,CAEzD"}

package/dist/actions/github/index.js

@@ -0,0 +1,67 @@
+// Core GitHub actions
+import { PreflightAction } from './preflight.js';
+import { GetContextAction } from './get-context.js';
+import { ReviewChangesAction } from './review-changes.js';
+import { CommitAndPushAction } from './commit-and-push.js';
+import { MergeFromBaseAction } from './merge-from-base.js';
+// PR management actions
+import { CreateDraftPRAction } from './create-draft-pr.js';
+import { MarkPRReadyAction } from './mark-pr-ready.js';
+import { UpdatePRAction } from './update-pr.js';
+import { ReadPRFeedbackAction } from './read-pr-feedback.js';
+import { RespondPRFeedbackAction } from './respond-pr-feedback.js';
+import { AddCommentAction } from './add-comment.js';
+// Infrastructure actions
+import { SyncLabelsAction } from './sync-labels.js';
+// Re-export action classes
+export { PreflightAction } from './preflight.js';
+export { GetContextAction } from './get-context.js';
+export { ReviewChangesAction } from './review-changes.js';
+export { CommitAndPushAction } from './commit-and-push.js';
+export { MergeFromBaseAction } from './merge-from-base.js';
+export { CreateDraftPRAction } from './create-draft-pr.js';
+export { MarkPRReadyAction } from './mark-pr-ready.js';
+export { UpdatePRAction } from './update-pr.js';
+export { ReadPRFeedbackAction } from './read-pr-feedback.js';
+export { RespondPRFeedbackAction } from './respond-pr-feedback.js';
+export { AddCommentAction } from './add-comment.js';
+export { SyncLabelsAction } from './sync-labels.js';
+// Re-export client
+export * from './client/index.js';
+// Re-export URL parser utility
+export { parseGitHubIssueUrl } from './preflight.js';
+/**
+ * All GitHub action handlers
+ */
+export const githubActionHandlers = [
+    // Core actions
+    new PreflightAction(),
+    new GetContextAction(),
+    new ReviewChangesAction(),
+    new CommitAndPushAction(),
+    new MergeFromBaseAction(),
+    // PR management actions
+    new CreateDraftPRAction(),
+    new MarkPRReadyAction(),
+    new UpdatePRAction(),
+    new ReadPRFeedbackAction(),
+    new RespondPRFeedbackAction(),
+    new AddCommentAction(),
+    // Infrastructure actions
+    new SyncLabelsAction(),
+];
+/**
+ * GitHub action namespace definition
+ */
+export const githubNamespace = {
+    namespace: 'github',
+    description: 'GitHub API and git operations for workflow automation',
+    handlers: githubActionHandlers,
+};
+/**
+ * Get all GitHub action handlers
+ */
+export function getGitHubActionHandlers() {
+    return [...githubActionHandlers];
+}
+//# sourceMappingURL=index.js.map

package/dist/actions/github/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/github/index.ts"],"names":[],"mappings":"AAMA,sBAAsB;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,yBAAyB;AACzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,2BAA2B;AAC3B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,mBAAmB;AACnB,cAAc,mBAAmB,CAAC;AAElC,+BAA+B;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAoB;IACnD,eAAe;IACf,IAAI,eAAe,EAAE;IACrB,IAAI,gBAAgB,EAAE;IACtB,IAAI,mBAAmB,EAAE;IACzB,IAAI,mBAAmB,EAAE;IACzB,IAAI,mBAAmB,EAAE;IACzB,wBAAwB;IACxB,IAAI,mBAAmB,EAAE;IACzB,IAAI,iBAAiB,EAAE;IACvB,IAAI,cAAc,EAAE;IACpB,IAAI,oBAAoB,EAAE;IAC1B,IAAI,uBAAuB,EAAE;IAC7B,IAAI,gBAAgB,EAAE;IACtB,yBAAyB;IACzB,IAAI,gBAAgB,EAAE;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,SAAS,EAAE,QAAQ;IACnB,WAAW,EAAE,uDAAuD;IACpE,QAAQ,EAAE,oBAAoB;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,CAAC,GAAG,oBAAoB,CAAC,CAAC;AACnC,CAAC"}

package/dist/actions/github/label-definitions.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared label definitions for workflow management.
+ *
+ * These labels are used by sync-labels action and can be imported
+ * by other modules that need to reference the canonical label set.
+ */
+/**
+ * Label definition with required fields for workflow labels.
+ */
+export interface LabelDefinition {
+    name: string;
+    color: string;
+    description: string;
+}
+/**
+ * Canonical set of workflow labels managed by the label sync utility.
+ */
+export declare const WORKFLOW_LABELS: LabelDefinition[];
+//# sourceMappingURL=label-definitions.d.ts.map

package/dist/actions/github/label-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-definitions.d.ts","sourceRoot":"","sources":["../../../src/actions/github/label-definitions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,eAAe,EAoE5C,CAAC"}

package/dist/actions/github/label-definitions.js

@@ -0,0 +1,71 @@
+/**
+ * Shared label definitions for workflow management.
+ *
+ * These labels are used by sync-labels action and can be imported
+ * by other modules that need to reference the canonical label set.
+ */
+/**
+ * Canonical set of workflow labels managed by the label sync utility.
+ */
+export const WORKFLOW_LABELS = [
+    // Phase labels
+    { name: 'phase:specify', color: '0052CC', description: 'Specification phase' },
+    { name: 'phase:clarify', color: '0052CC', description: 'Clarification phase' },
+    { name: 'phase:plan', color: '0052CC', description: 'Planning phase' },
+    { name: 'phase:tasks', color: '0052CC', description: 'Task generation phase' },
+    { name: 'phase:implement', color: '0052CC', description: 'Implementation phase' },
+    { name: 'phase:validate', color: '0052CC', description: 'Validation phase' },
+    // Waiting-for labels (review gates)
+    { name: 'waiting-for:spec-review', color: 'FBCA04', description: 'Waiting for spec review' },
+    { name: 'waiting-for:clarification', color: 'FBCA04', description: 'Waiting for clarification answers' },
+    { name: 'waiting-for:clarification-review', color: 'FBCA04', description: 'Waiting for clarification review' },
+    { name: 'waiting-for:plan-review', color: 'FBCA04', description: 'Waiting for plan review' },
+    { name: 'waiting-for:tasks-review', color: 'FBCA04', description: 'Waiting for tasks review' },
+    { name: 'waiting-for:implementation-review', color: 'FBCA04', description: 'Waiting for implementation review' },
+    { name: 'waiting-for:manual-validation', color: 'FBCA04', description: 'Waiting for manual validation' },
+    { name: 'waiting-for:pr-feedback', color: 'FBCA04', description: 'Waiting to address PR feedback' },
+    { name: 'waiting-for:address-pr-feedback', color: 'FBCA04', description: 'Agent is addressing PR review feedback' },
+    { name: 'waiting-for:children-complete', color: 'FBCA04', description: 'Waiting for child issues to complete' },
+    { name: 'waiting-for:epic-approval', color: 'FBCA04', description: 'Epic rollup PR awaiting approval' },
+    { name: 'waiting-for:dependencies', color: 'FBCA04', description: 'Waiting for blocking issues' },
+    // Completed labels
+    { name: 'completed:spec-review', color: '0E8A16', description: 'Spec review completed' },
+    { name: 'completed:clarification', color: '0E8A16', description: 'Clarification completed' },
+    { name: 'completed:clarification-review', color: '0E8A16', description: 'Clarification review completed' },
+    { name: 'completed:plan-review', color: '0E8A16', description: 'Plan review completed' },
+    { name: 'completed:tasks-review', color: '0E8A16', description: 'Tasks review completed' },
+    { name: 'completed:implementation-review', color: '0E8A16', description: 'Implementation review completed' },
+    { name: 'completed:manual-validation', color: '0E8A16', description: 'Manual validation completed' },
+    { name: 'completed:setup', color: '0E8A16', description: 'Setup phase completed' },
+    { name: 'completed:specify', color: '0E8A16', description: 'Specification phase completed' },
+    { name: 'completed:clarify', color: '0E8A16', description: 'Clarification phase completed' },
+    { name: 'completed:plan', color: '0E8A16', description: 'Planning phase completed' },
+    { name: 'completed:tasks', color: '0E8A16', description: 'Task generation completed' },
+    { name: 'completed:implement', color: '0E8A16', description: 'Implementation completed' },
+    { name: 'completed:validate', color: '0E8A16', description: 'Validation completed' },
+    { name: 'completed:children-complete', color: '0E8A16', description: 'All epic children completed' },
+    { name: 'completed:epic-approval', color: '0E8A16', description: 'Epic rollup PR approved and merged' },
+    // Issue type labels
+    { name: 'type:feature', color: '1D76DB', description: 'Feature request' },
+    { name: 'type:bug', color: 'D73A4A', description: 'Bug report' },
+    { name: 'type:epic', color: '5319E7', description: 'Epic issue with children' },
+    // Agent labels
+    { name: 'agent:dispatched', color: 'C5DEF5', description: 'Dispatched to agent queue' },
+    { name: 'agent:in-progress', color: '0366D6', description: 'Agent is actively working' },
+    { name: 'agent:paused', color: 'F9D0C4', description: 'Agent work is paused' },
+    { name: 'agent:error', color: 'D73A4A', description: 'Agent encountered an error' },
+    // Needs labels
+    { name: 'needs:epic-approval', color: 'D93F0B', description: 'Epic PR needs approval' },
+    { name: 'needs:human-review', color: 'D93F0B', description: 'Requires human review' },
+    // Process trigger labels
+    { name: 'process:speckit-feature', color: 'D876E3', description: 'Speckit feature process trigger' },
+    { name: 'process:speckit-bugfix', color: 'D876E3', description: 'Speckit bugfix process trigger' },
+    { name: 'process:speckit-epic', color: 'D876E3', description: 'Speckit epic process trigger' },
+    // Workflow identity labels (persist for issue lifetime)
+    { name: 'workflow:speckit-feature', color: '6F42C1', description: 'Speckit feature workflow' },
+    { name: 'workflow:speckit-bugfix', color: '6F42C1', description: 'Speckit bugfix workflow' },
+    { name: 'workflow:speckit-epic', color: '6F42C1', description: 'Speckit epic workflow' },
+    // Relationship labels
+    { name: 'epic-child', color: 'bfd4f2', description: 'Child issue of an epic' },
+];
+//# sourceMappingURL=label-definitions.js.map

package/dist/actions/github/label-definitions.js.map

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

package/dist/actions/github/mark-pr-ready.d.ts

@@ -0,0 +1,14 @@
+/**
+ * github.mark_pr_ready action - converts a draft PR to ready for review.
+ */
+import { BaseAction } from '../base-action.js';
+import type { ActionContext, ActionResult, ActionIdentifier, StepDefinition } from '../../types/index.js';
+/**
+ * github.mark_pr_ready action handler
+ */
+export declare class MarkPRReadyAction extends BaseAction {
+    readonly type: ActionIdentifier;
+    canHandle(step: StepDefinition): boolean;
+    protected executeInternal(step: StepDefinition, context: ActionContext): Promise<Omit<ActionResult, 'duration'>>;
+}
+//# sourceMappingURL=mark-pr-ready.d.ts.map

package/dist/actions/github/mark-pr-ready.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-pr-ready.d.ts","sourceRoot":"","sources":["../../../src/actions/github/mark-pr-ready.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,cAAc,EAGf,MAAM,sBAAsB,CAAC;AAK9B;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAA0B;IAEzD,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;cAOxB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;CA+B3C"}

package/dist/actions/github/mark-pr-ready.js

@@ -0,0 +1,43 @@
+/**
+ * github.mark_pr_ready action - converts a draft PR to ready for review.
+ */
+import { BaseAction } from '../base-action.js';
+import { isNamespacedAction } from '../../types/action.js';
+import { createGitHubClient } from './client/index.js';
+/**
+ * github.mark_pr_ready action handler
+ */
+export class MarkPRReadyAction extends BaseAction {
+    type = 'github.mark_pr_ready';
+    canHandle(step) {
+        const uses = step.uses ?? step.action;
+        if (!uses)
+            return false;
+        return uses === 'github.mark_pr_ready' ||
+            (isNamespacedAction(uses) && uses === this.type);
+    }
+    async executeInternal(step, context) {
+        // Get inputs
+        const prNumber = this.getRequiredInput(step, context, 'pr_number');
+        context.logger.info(`Marking PR #${prNumber} as ready for review`);
+        try {
+            // Get GitHub client
+            const client = createGitHubClient(context.workdir);
+            // Get repo info
+            const repoInfo = await client.getRepoInfo();
+            // Mark PR as ready
+            await client.markPRReady(repoInfo.owner, repoInfo.repo, prNumber);
+            context.logger.info(`PR #${prNumber} is now ready for review`);
+            const output = {
+                success: true,
+                pr_number: prNumber,
+                pr_url: `https://github.com/${repoInfo.owner}/${repoInfo.repo}/pull/${prNumber}`,
+            };
+            return this.successResult(output);
+        }
+        catch (error) {
+            return this.failureResult(error instanceof Error ? error.message : String(error));
+        }
+    }
+}
+//# sourceMappingURL=mark-pr-ready.js.map

package/dist/actions/github/mark-pr-ready.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-pr-ready.js","sourceRoot":"","sources":["../../../src/actions/github/mark-pr-ready.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAS/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IACtC,IAAI,GAAqB,sBAAsB,CAAC;IAEzD,SAAS,CAAC,IAAoB;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,OAAO,IAAI,KAAK,sBAAsB;YAC/B,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IAES,KAAK,CAAC,eAAe,CAC7B,IAAoB,EACpB,OAAsB;QAEtB,aAAa;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAS,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;QAE3E,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,QAAQ,sBAAsB,CAAC,CAAC;QAEnE,IAAI,CAAC;YACH,oBAAoB;YACpB,MAAM,MAAM,GAAiB,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAEjE,gBAAgB;YAChB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC;YAE5C,mBAAmB;YACnB,MAAM,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAElE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,QAAQ,0BAA0B,CAAC,CAAC;YAE/D,MAAM,MAAM,GAAsB;gBAChC,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,QAAQ;gBACnB,MAAM,EAAE,sBAAsB,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,SAAS,QAAQ,EAAE;aACjF,CAAC;YAEF,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACpC,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/github/merge-from-base.d.ts

@@ -0,0 +1,15 @@
+/**
+ * github.merge_from_base action - merges from base branch with conflict detection.
+ * Fetches latest changes and merges, reporting any conflicts.
+ */
+import { BaseAction } from '../base-action.js';
+import type { ActionContext, ActionResult, ActionIdentifier, StepDefinition } from '../../types/index.js';
+/**
+ * github.merge_from_base action handler
+ */
+export declare class MergeFromBaseAction extends BaseAction {
+    readonly type: ActionIdentifier;
+    canHandle(step: StepDefinition): boolean;
+    protected executeInternal(step: StepDefinition, context: ActionContext): Promise<Omit<ActionResult, 'duration'>>;
+}
+//# sourceMappingURL=merge-from-base.d.ts.map

package/dist/actions/github/merge-from-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-from-base.d.ts","sourceRoot":"","sources":["../../../src/actions/github/merge-from-base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,cAAc,EAIf,MAAM,sBAAsB,CAAC;AAK9B;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAA4B;IAE3D,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;cAOxB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;CAwH3C"}

package/dist/actions/github/merge-from-base.js

@@ -0,0 +1,120 @@
+/**
+ * github.merge_from_base action - merges from base branch with conflict detection.
+ * Fetches latest changes and merges, reporting any conflicts.
+ */
+import { BaseAction } from '../base-action.js';
+import { isNamespacedAction } from '../../types/action.js';
+import { createGitHubClient } from './client/index.js';
+/**
+ * github.merge_from_base action handler
+ */
+export class MergeFromBaseAction extends BaseAction {
+    type = 'github.merge_from_base';
+    canHandle(step) {
+        const uses = step.uses ?? step.action;
+        if (!uses)
+            return false;
+        return uses === 'github.merge_from_base' ||
+            (isNamespacedAction(uses) && uses === this.type);
+    }
+    async executeInternal(step, context) {
+        // Get inputs
+        const abortOnConflict = this.getInput(step, context, 'abort_on_conflict', false);
+        const autoResolve = this.getInput(step, context, 'auto_resolve', true);
+        const parentEpicNumber = this.getInput(step, context, 'parent_epic_number');
+        context.logger.info('Merging from base branch');
+        try {
+            // Get GitHub client
+            const client = createGitHubClient(context.workdir);
+            // Check for uncommitted changes first
+            const status = await client.getStatus();
+            let stashCreated = false;
+            if (status.has_changes) {
+                // Stash changes before merge
+                stashCreated = await client.stash('autodev: pre-merge stash');
+                context.logger.info('Stashed uncommitted changes');
+            }
+            // Fetch latest from remote
+            await client.fetch('origin', true);
+            // Determine base branch
+            let baseBranch;
+            let mergedFromEpic = false;
+            if (parentEpicNumber) {
+                // Try to find epic branch
+                const epicBranch = `${parentEpicNumber}-`;
+                const currentBranch = await client.getCurrentBranch();
+                // Epic branches would be like: epic/123-feature or 123-feature
+                baseBranch = `origin/${epicBranch}`;
+                // Check if exists, otherwise fall back to default
+                const exists = await client.branchExists(epicBranch, true);
+                if (!exists) {
+                    baseBranch = `origin/${await client.getDefaultBranch()}`;
+                }
+                else {
+                    mergedFromEpic = true;
+                }
+            }
+            else {
+                // Use default branch
+                const defaultBranch = await client.getDefaultBranch();
+                baseBranch = `origin/${defaultBranch}`;
+            }
+            context.logger.info(`Merging from ${baseBranch}`);
+            // Perform merge
+            const mergeResult = await client.merge(baseBranch);
+            // Handle conflicts
+            let conflictsRemaining = [];
+            const conflictsResolved = 0;
+            if (!mergeResult.success && mergeResult.conflicts.length > 0) {
+                if (abortOnConflict) {
+                    // Abort merge and restore stash
+                    await client.mergeAbort();
+                    if (stashCreated) {
+                        await client.stashPop();
+                    }
+                    return this.failureResult(`Merge conflict detected in ${mergeResult.conflicts.length} file(s). Aborted.`, {
+                        output: {
+                            success: false,
+                            base_branch: baseBranch,
+                            merged_from_epic: mergedFromEpic,
+                            commits_merged: 0,
+                            already_up_to_date: false,
+                            conflicts_resolved: 0,
+                            conflicts_remaining: mergeResult.conflicts,
+                            stash_created: stashCreated,
+                            summary: `Merge aborted due to ${mergeResult.conflicts.length} conflict(s)`,
+                        },
+                    });
+                }
+                // Return conflicts for agent resolution
+                conflictsRemaining = mergeResult.conflicts;
+            }
+            // Restore stash if created
+            if (stashCreated) {
+                const stashResult = await client.stashPop();
+                if (!stashResult.success && stashResult.conflicts) {
+                    context.logger.warn('Stash pop resulted in conflicts');
+                }
+            }
+            const output = {
+                success: mergeResult.success || conflictsRemaining.length === 0,
+                base_branch: baseBranch.replace('origin/', ''),
+                merged_from_epic: mergedFromEpic,
+                commits_merged: mergeResult.commits_merged,
+                already_up_to_date: mergeResult.already_up_to_date,
+                conflicts_resolved: conflictsResolved,
+                conflicts_remaining: conflictsRemaining,
+                stash_created: stashCreated,
+                summary: mergeResult.summary,
+            };
+            if (conflictsRemaining.length > 0) {
+                return this.failureResult(`Merge completed with ${conflictsRemaining.length} conflict(s) requiring resolution`, { output });
+            }
+            return this.successResult(output);
+        }
+        catch (error) {
+            return this.failureResult(error instanceof Error ? error.message : String(error));
+        }
+    }
+}
+//# sourceMappingURL=merge-from-base.js.map

package/dist/actions/github/merge-from-base.js.map

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

package/dist/actions/github/preflight.d.ts

@@ -0,0 +1,36 @@
+/**
+ * github.preflight action - validates environment before workflow execution.
+ * Parses issue URL, detects branch state, analyzes labels, and checks prerequisites.
+ */
+import { BaseAction } from '../base-action.js';
+import type { ActionContext, ActionResult, ActionIdentifier, StepDefinition, ParsedIssueUrl } from '../../types/index.js';
+/**
+ * Parse a GitHub issue URL into owner, repo, and number
+ */
+export declare function parseGitHubIssueUrl(url: string): ParsedIssueUrl;
+/**
+ * github.preflight action handler
+ */
+export declare class PreflightAction extends BaseAction {
+    readonly type: ActionIdentifier;
+    private client;
+    canHandle(step: StepDefinition): boolean;
+    protected executeInternal(step: StepDefinition, context: ActionContext): Promise<Omit<ActionResult, 'duration'>>;
+    /**
+     * Generate expected branch name from issue number and title
+     */
+    private generateExpectedBranch;
+    /**
+     * Check speckit artifact status
+     */
+    private checkSpeckitStatus;
+    /**
+     * Detect epic context from issue body and labels
+     */
+    private detectEpicContext;
+    /**
+     * Find existing branches for an issue number
+     */
+    private findExistingBranches;
+}
+//# sourceMappingURL=preflight.d.ts.map

package/dist/actions/github/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../src/actions/github/preflight.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,cAAc,EAOd,cAAc,EAGf,MAAM,sBAAsB,CAAC;AAO9B;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAU/D;AA8GD;;GAEG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAsB;IAErD,OAAO,CAAC,MAAM,CAA2B;IAEzC,SAAS,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;cAOxB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAsG1C;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;OAEG;YACW,kBAAkB;IAwBhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;OAEG;YACW,oBAAoB;CAsBnC"}