@posthog/agent 1.11.0 → 1.12.0

package/README.md

@@ -1,6 +1,6 @@
 # PostHog Agent SDK
 
-TypeScript agent framework that wraps the Claude Agent SDK for PostHog's Array desktop app. Features a Git-based workflow that stores task artifacts alongside your code.
+TypeScript agent framework that wraps the Claude Agent SDK for PostHog's Array desktop app. Features a Git-based task execution system that stores task artifacts alongside your code.
 
 ## Quick Start
 
@@ -11,9 +11,9 @@ bun run example
 
 ## Key Features
 
-- **Git-Based Workflow**: Plans and artifacts stored in `.posthog/` folders and committed to Git
+- **Git-Based Task Execution**: Plans and artifacts stored in `.posthog/` folders and committed to Git
 - **PostHog Integration**: Fetches existing tasks from PostHog API
-- **Configurable Workflows**: Execute tasks via PostHog-defined or local workflows
+- **3-Phase Execution**: Research → Plan → Build with automatic progression
 - **Branch Management**: Automatic branch creation for planning and implementation
 - **Progress Tracking**: Execution status stored in PostHog `TaskRun` records for easy polling
 
@@ -35,12 +35,14 @@ const agent = new Agent({
     },
 });
 
-// Run by workflow
+// Run a task
 const taskId = "task_abc123";
-const workflowId = "workflow_123";
-await agent.runWorkflow(taskId, workflowId, {
+const task = await agent.getPostHogClient()?.fetchTask(taskId);
+
+await agent.runTask(task, {
   repositoryPath: "/path/to/repo",
   permissionMode: PermissionMode.ACCEPT_EDITS,
+  isCloudMode: false,
   autoProgress: true,
 });
 ```
@@ -54,32 +56,13 @@ const agent = new Agent({
 });
 ```
 
-## Workflow
-
-Each task execution creates Git branches:
-
-1. **Planning**: `posthog/task-{id}-planning` - Contains plan in `.posthog/{id}/plan.md`
-2. **Implementation**: `posthog/task-{id}-implementation` - Contains code changes
-
-## Manual Stages and Resume
-
-- Manual stages (no agent, or `is_manual_only`) are stop-points: the SDK will not auto-advance.
-- On manual stages, a PR is opened by default for human review (configurable per stage with `openPullRequest`).
+## Task Execution
 
-Resume from the current stage:
+Each task execution creates Git branches and follows a 3-phase approach:
 
-```typescript
-await agent.runWorkflow(taskId, workflowId, {
-  repositoryPath: "/path/to/repo",
-  permissionMode: PermissionMode.ACCEPT_EDITS,
-  resumeFromCurrentStage: true,
-  autoProgress: true, // ignored on manual stages
-});
-
-// Or explicitly progress via API then resume
-await agent.progressToNextStage(taskId);
-await agent.runWorkflow(taskId, workflowId, { resumeFromCurrentStage: true });
-```
+1. **Research Phase**: Analyzes the codebase and may generate clarifying questions
+2. **Planning Phase**: Creates an implementation plan in `.posthog/{id}/plan.md` on branch `posthog/task-{id}-planning`
+3. **Build Phase**: Implements code changes on branch `posthog/task-{id}-implementation`
 
 ## File System
 
@@ -90,6 +73,7 @@ your-repo/
 │   ├── .gitignore
 │   └── {task-id}/
 │       ├── plan.md
+│       ├── questions.json (if research phase generated questions)
 │       └── context.md (optional)
 └── (your code)
 ```
@@ -111,12 +95,12 @@ const poller = setInterval(async () => {
     new Date(b.created_at).getTime() - new Date(a.created_at).getTime()
   )[0];
   if (latestRun) {
-    renderProgress(latestRun.status, latestRun.log, latestRun.current_stage);
+    renderProgress(latestRun.status, latestRun.log);
   }
 }, 3000);
 
 try {
-  await agent.runWorkflow(taskId, workflowId, { repositoryPath: repoPath });
+  await agent.runTask(task, { repositoryPath: repoPath });
 } finally {
   clearInterval(poller);
 }
@@ -141,46 +125,23 @@ function handleLiveEvent(event: AgentEvent) {
 ## Requirements
 
 - Bun runtime
-- Git repository 
+- Git repository
 - PostHog API access
 - Claude API access via `@anthropic-ai/claude-agent-sdk`
 
+## Configuration Options
 
-## Stage overrides and query overrides
-
-You can customize behavior per workflow stage using `stageOverrides`, and pass low-level model options using `queryOverrides`.
+You can customize behavior using `TaskExecutionOptions`:
 
 ```ts
-await agent.runWorkflow(taskId, workflowId, {
+await agent.runTask(task, {
   repositoryPath: "/path/to/repo",
-  // Global defaults for this run
-  permissionMode: PermissionMode.ACCEPT_EDITS,
-  queryOverrides: { model: 'claude-3-7-sonnet' },
-
-  // Per-stage overrides (keys must match your workflow's stage keys)
-  stageOverrides: {
-    plan: {
-      permissionMode: PermissionMode.PLAN,
-      createPlanningBranch: true,
-      // Only applied during the planning stage
-      queryOverrides: { temperature: 0.2 }
-    },
-    build: {
-      createImplementationBranch: true,
-      openPullRequest: false,
-      // Inject custom MCP servers or any other query option
-      queryOverrides: {
-        mcpServers: {
-          // example: override or add servers
-        }
-      }
-    },
-    complete: {
-      // ensure a PR is opened at the end regardless of edits
-      openPullRequest: true
-    }
+  permissionMode: PermissionMode.ACCEPT_EDITS, // or PLAN, DEFAULT, BYPASS
+  isCloudMode: false, // local execution with pauses between phases
+  autoProgress: true, // automatically progress through phases
+  queryOverrides: {
+    model: 'claude-sonnet-4-5-20250929',
+    temperature: 0.7
   }
 });
 ```
-
-Precedence for query options: base defaults in the SDK < global `queryOverrides` < per-stage `stageOverrides[stageKey].queryOverrides`.

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 export { Agent, } from './src/agent.js';
 export { PermissionMode, } from './src/types.js';
 export type { Task, TaskRun, SupportingFile, ExecutionResult, AgentConfig, McpServerConfig, AgentEvent } from './src/types.js';
-export type { WorkflowDefinition, WorkflowStage, WorkflowExecutionOptions, AgentDefinition } from './src/workflow-types.js';
 export { Logger, LogLevel, } from './src/utils/logger.js';
 export type { LoggerConfig } from './src/utils/logger.js';
 export type { ExtractedQuestion, ExtractedQuestionWithAnswer, StructuredExtractor } from './src/structured-extraction.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,GACR,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACH,cAAc,GACjB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACR,IAAI,EACJ,OAAO,EACP,cAAc,EACd,eAAe,EACf,WAAW,EACX,eAAe,EACf,UAAU,EACb,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACxB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACH,MAAM,EACN,QAAQ,GACX,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACR,YAAY,EACf,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACR,iBAAiB,EACjB,2BAA2B,EAC3B,mBAAmB,EACtB,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EACR,YAAY,EACZ,UAAU,EACV,aAAa,EAChB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAGxE,YAAY,EACR,IAAI,EACJ,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,GACR,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACH,cAAc,GACjB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACR,IAAI,EACJ,OAAO,EACP,cAAc,EACd,eAAe,EACf,WAAW,EACX,eAAe,EACf,UAAU,EACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACH,MAAM,EACN,QAAQ,GACX,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACR,YAAY,EACf,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACR,iBAAiB,EACjB,2BAA2B,EAC3B,mBAAmB,EACtB,MAAM,gCAAgC,CAAC;AAGxC,YAAY,EACR,YAAY,EACZ,UAAU,EACV,aAAa,EAChB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAGxE,YAAY,EACR,IAAI,EACJ,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/src/adapters/types.d.ts

@@ -16,7 +16,7 @@ export interface ProviderAdapter {
     transform(sdkMessage: unknown): AgentEvent | null;
     /**
      * Create a standardized status event.
-     * Used for workflow stage transitions and other status updates.
+     * Used for task phase transitions and other status updates.
      */
     createStatusEvent(phase: string, additionalData?: any): StatusEvent;
     /**

package/dist/src/agent.d.ts

@@ -1,5 +1,4 @@
 import type { Task, ExecutionResult, AgentConfig } from './types.js';
-import type { WorkflowDefinition, WorkflowStage, WorkflowExecutionOptions } from './workflow-types.js';
 import { PostHogAPIClient } from './posthog-api.js';
 import { type ExtractedQuestion, type ExtractedQuestionWithAnswer } from './structured-extraction.js';
 export declare class Agent {
@@ -12,9 +11,6 @@ export declare class Agent {
     private templateManager;
     private adapter;
     private logger;
-    private agentRegistry;
-    private workflowRegistry;
-    private stageExecutor;
     private progressReporter;
     private promptBuilder;
     private extractor?;
@@ -29,13 +25,7 @@ export declare class Agent {
      * Configure LLM gateway environment variables for Claude Code CLI
      */
     private _configureLlmGateway;
-    runWorkflow(taskOrId: Task | string, workflowId: string, options?: WorkflowExecutionOptions): Promise<{
-        task: Task;
-        workflow: WorkflowDefinition;
-    }>;
-    executeStage(task: Task, stage: WorkflowStage, options?: WorkflowExecutionOptions): Promise<void>;
     runTask(taskOrId: Task | string, options?: import('./types.js').TaskExecutionOptions): Promise<void>;
-    progressToNextStage(taskId: string, currentStageKey?: string): Promise<void>;
     run(prompt: string, options?: {
         repositoryPath?: string;
         permissionMode?: import('./types.js').PermissionMode;
@@ -47,8 +37,6 @@ export declare class Agent {
         repository?: string;
         organization?: string;
         origin_product?: string;
-        workflow?: string;
-        current_stage?: string;
     }): Promise<Task[]>;
     writeTaskFile(taskId: string, fileName: string, content: string, type?: 'plan' | 'context' | 'reference' | 'output'): Promise<void>;
     readTaskFile(taskId: string, fileName: string): Promise<string | null>;
@@ -69,5 +57,4 @@ export declare class Agent {
 }
 export { PermissionMode } from './types.js';
 export type { Task, SupportingFile, ExecutionResult, AgentConfig } from './types.js';
-export type { WorkflowDefinition, WorkflowStage, WorkflowExecutionOptions } from './workflow-types.js';
 //# sourceMappingURL=agent.d.ts.map

package/dist/src/agent.d.ts.map

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

package/dist/src/agent.js

@@ -6,9 +6,6 @@ import { GitManager } from './git-manager.js';
 import { TemplateManager } from './template-manager.js';
 import { ClaudeAdapter } from './adapters/claude/claude-adapter.js';
 import { Logger } from './utils/logger.js';
-import { AgentRegistry } from './agent-registry.js';
-import { WorkflowRegistry } from './workflow-registry.js';
-import { StageExecutor } from './stage-executor.js';
 import { PromptBuilder } from './prompt-builder.js';
 import { TaskProgressReporter } from './task-progress-reporter.js';
 import { OpenAIExtractor } from './structured-extraction.js';
@@ -24,9 +21,6 @@ class Agent {
     templateManager;
     adapter;
     logger;
-    agentRegistry;
-    workflowRegistry;
-    stageExecutor;
     progressReporter;
     promptBuilder;
     extractor;
@@ -68,23 +62,18 @@ class Agent {
             // TODO: Add author config from environment or config
         });
         this.templateManager = new TemplateManager();
-        this.agentRegistry = new AgentRegistry();
         if (config.posthogApiUrl && config.posthogApiKey) {
             this.posthogAPI = new PostHogAPIClient({
                 apiUrl: config.posthogApiUrl,
                 apiKey: config.posthogApiKey,
             });
         }
-        this.workflowRegistry = new WorkflowRegistry(this.posthogAPI);
         this.promptBuilder = new PromptBuilder({
             getTaskFiles: (taskId) => this.getTaskFiles(taskId),
             generatePlanTemplate: (vars) => this.templateManager.generatePlan(vars),
             posthogClient: this.posthogAPI,
             logger: this.logger.child('PromptBuilder')
         });
-        this.stageExecutor = new StageExecutor(this.agentRegistry, this.logger, this.promptBuilder, undefined, // eventHandler set via setEventHandler below
-        this.mcpServers);
-        this.stageExecutor.setEventHandler((event) => this.emitEvent(event));
         this.progressReporter = new TaskProgressReporter(this.posthogAPI, this.logger);
         // Initialize OpenAI extractor if API key is available
         if (process.env.OPENAI_API_KEY) {
@@ -120,186 +109,7 @@ class Agent {
             throw error;
         }
     }
-    // Workflow-based execution
-    async runWorkflow(taskOrId, workflowId, options = {}) {
-        await this._configureLlmGateway();
-        const task = typeof taskOrId === 'string' ? await this.fetchTask(taskOrId) : taskOrId;
-        await this.workflowRegistry.loadWorkflows();
-        const workflow = this.workflowRegistry.getWorkflow(workflowId);
-        if (!workflow) {
-            throw new Error(`Workflow ${workflowId} not found`);
-        }
-        const orderedStages = [...workflow.stages].sort((a, b) => a.position - b.position);
-        // Ensure task is assigned to workflow and positioned at first stage
-        if (this.posthogAPI) {
-            try {
-                if (task.workflow !== workflowId) {
-                    await this.posthogAPI.updateTask(task.id, { workflow: workflowId });
-                    task.workflow = workflowId;
-                }
-            }
-            catch (e) {
-                this.logger.warn('Failed to sync task workflow before execution', { error: e.message });
-            }
-        }
-        const executionId = this.taskManager.generateExecutionId();
-        this.logger.info('Starting workflow execution', { taskId: task.id, workflowId, executionId });
-        this.taskManager.startExecution(task.id, 'plan_and_build', executionId);
-        await this.progressReporter.start(task.id, {
-            totalSteps: orderedStages.length,
-        });
-        // Set initial stage on the newly created run
-        const firstStage = orderedStages[0];
-        if (this.posthogAPI && this.progressReporter.runId && firstStage) {
-            try {
-                await this.posthogAPI.updateTaskRun(task.id, this.progressReporter.runId, {
-                    current_stage: firstStage.id
-                });
-            }
-            catch (e) {
-                this.logger.warn('Failed to set initial stage on run', { error: e.message });
-            }
-        }
-        try {
-            let startIndex = 0;
-            const currentStageId = task.current_stage;
-            // If task is already at the last stage, fail gracefully without progressing
-            if (currentStageId) {
-                const currIdx = orderedStages.findIndex(s => s.id === currentStageId);
-                const atLastStage = currIdx >= 0 && currIdx === orderedStages.length - 1;
-                if (atLastStage) {
-                    const finalStageKey = orderedStages[currIdx]?.key;
-                    this.emitEvent(this.adapter.createStatusEvent('no_next_stage', { stage: finalStageKey }));
-                    await this.progressReporter.noNextStage(finalStageKey);
-                    await this.progressReporter.complete();
-                    this.taskManager.completeExecution(executionId, { task, workflow });
-                    return { task, workflow };
-                }
-            }
-            if (options.resumeFromCurrentStage && currentStageId) {
-                const idx = orderedStages.findIndex(s => s.id === currentStageId);
-                if (idx >= 0)
-                    startIndex = idx;
-            }
-            // Align server-side stage when restarting from a different stage
-            if (this.posthogAPI && this.progressReporter.runId) {
-                const targetStage = orderedStages[startIndex];
-                if (targetStage && targetStage.id !== currentStageId) {
-                    try {
-                        await this.posthogAPI.updateTaskRun(task.id, this.progressReporter.runId, {
-                            current_stage: targetStage.id
-                        });
-                    }
-                    catch (e) {
-                        this.logger.warn('Failed to update run stage', { error: e.message });
-                    }
-                }
-            }
-            for (let i = startIndex; i < orderedStages.length; i++) {
-                const stage = orderedStages[i];
-                await this.progressReporter.stageStarted(stage.key, i);
-                await this.executeStage(task, stage, options);
-                await this.progressReporter.stageCompleted(stage.key, i + 1);
-                if (options.autoProgress) {
-                    const hasNext = i < orderedStages.length - 1;
-                    if (hasNext) {
-                        await this.progressToNextStage(task.id, stage.key);
-                    }
-                }
-            }
-            await this.progressReporter.complete();
-            this.taskManager.completeExecution(executionId, { task, workflow });
-            return { task, workflow };
-        }
-        catch (error) {
-            await this.progressReporter.fail(error);
-            this.taskManager.failExecution(executionId, error);
-            throw error;
-        }
-    }
-    async executeStage(task, stage, options = {}) {
-        this.emitEvent(this.adapter.createStatusEvent('stage_start', { stage: stage.key }));
-        const overrides = options.stageOverrides?.[stage.key];
-        const agentName = stage.agent_name || 'code_generation';
-        const agentDef = this.agentRegistry.getAgent(agentName);
-        const isManual = stage.is_manual_only === true;
-        const stageKeyLower = (stage.key || '').toLowerCase().trim();
-        const isPlanningByKey = stageKeyLower === 'plan' || stageKeyLower.includes('plan');
-        const isPlanning = !isManual && ((agentDef?.agent_type === 'planning') || isPlanningByKey);
-        const shouldCreatePlanningBranch = overrides?.createPlanningBranch !== false; // default true
-        const shouldCreateImplBranch = overrides?.createImplementationBranch !== false; // default true
-        if (isPlanning && shouldCreatePlanningBranch) {
-            const planningBranch = await this.createPlanningBranch(task.id);
-            await this.updateTaskBranch(task.id, planningBranch);
-            this.emitEvent(this.adapter.createStatusEvent('branch_created', { stage: stage.key, branch: planningBranch }));
-            await this.progressReporter.branchCreated(stage.key, planningBranch);
-        }
-        else if (!isPlanning && !isManual && shouldCreateImplBranch) {
-            const implBranch = await this.createImplementationBranch(task.id);
-            await this.updateTaskBranch(task.id, implBranch);
-            this.emitEvent(this.adapter.createStatusEvent('branch_created', { stage: stage.key, branch: implBranch }));
-            await this.progressReporter.branchCreated(stage.key, implBranch);
-        }
-        const result = await this.stageExecutor.execute(task, stage, options);
-        if (result.plan) {
-            await this.writePlan(task.id, result.plan);
-            await this.commitPlan(task.id, task.title);
-            this.emitEvent(this.adapter.createStatusEvent('commit_made', { stage: stage.key, kind: 'plan' }));
-            await this.progressReporter.commitMade(stage.key, 'plan');
-        }
-        if (isManual) {
-            const defaultOpenPR = true; // manual stages default to PR for review
-            const openPR = overrides?.openPullRequest ?? defaultOpenPR;
-            if (openPR) {
-                // Ensure we're on an implementation branch for PRs
-                let branchName = await this.gitManager.getCurrentBranch();
-                const onTaskBranch = branchName.includes(`posthog/task-${task.id}`);
-                if (!onTaskBranch && (overrides?.createImplementationBranch !== false)) {
-                    const implBranch = await this.createImplementationBranch(task.id);
-                    await this.updateTaskBranch(task.id, implBranch);
-                    branchName = implBranch;
-                    this.emitEvent(this.adapter.createStatusEvent('branch_created', { stage: stage.key, branch: implBranch }));
-                    await this.progressReporter.branchCreated(stage.key, implBranch);
-                }
-                try {
-                    const prUrl = await this.createPullRequest(task.id, branchName, task.title, task.description);
-                    await this.updateTaskBranch(task.id, branchName);
-                    await this.attachPullRequestToTask(task.id, prUrl, branchName);
-                    this.emitEvent(this.adapter.createStatusEvent('pr_created', { stage: stage.key, prUrl }));
-                    await this.progressReporter.pullRequestCreated(stage.key, prUrl);
-                }
-                catch { }
-            }
-            // Do not auto-progress on manual stages
-            this.emitEvent(this.adapter.createStatusEvent('stage_complete', { stage: stage.key }));
-            return;
-        }
-        if (result.results) {
-            const existingPlan = await this.readPlan(task.id);
-            const planSummary = existingPlan ? existingPlan.split('\n')[0] : undefined;
-            await this.commitImplementation(task.id, task.title, planSummary);
-            this.emitEvent(this.adapter.createStatusEvent('commit_made', { stage: stage.key, kind: 'implementation' }));
-            await this.progressReporter.commitMade(stage.key, 'implementation');
-        }
-        // PR creation on complete stage (or if explicitly requested), regardless of whether edits occurred
-        {
-            const defaultOpenPR = stage.key.toLowerCase().includes('complete');
-            const openPR = overrides?.openPullRequest ?? defaultOpenPR;
-            if (openPR) {
-                const branchName = await this.gitManager.getCurrentBranch();
-                try {
-                    const prUrl = await this.createPullRequest(task.id, branchName, task.title, task.description);
-                    await this.updateTaskBranch(task.id, branchName);
-                    await this.attachPullRequestToTask(task.id, prUrl, branchName);
-                    this.emitEvent(this.adapter.createStatusEvent('pr_created', { stage: stage.key, prUrl }));
-                    await this.progressReporter.pullRequestCreated(stage.key, prUrl);
-                }
-                catch { }
-            }
-        }
-        this.emitEvent(this.adapter.createStatusEvent('stage_complete', { stage: stage.key }));
-    }
-    // Adaptive task execution - 3-phase workflow (research → plan → build)
+    // Adaptive task execution - 3 phases (research → plan → build)
     async runTask(taskOrId, options = {}) {
         await this._configureLlmGateway();
         const task = typeof taskOrId === 'string' ? await this.fetchTask(taskOrId) : taskOrId;
@@ -601,28 +411,6 @@ class Agent {
         this.logger.info('Task execution complete', { taskId: task.id });
         this.emitEvent(this.adapter.createStatusEvent('task_complete', { taskId: task.id }));
     }
-    async progressToNextStage(taskId, currentStageKey) {
-        if (!this.posthogAPI || !this.progressReporter.runId) {
-            throw new Error('PostHog API not configured or no active run. Cannot progress stage.');
-        }
-        try {
-            await this.posthogAPI.progressTaskRun(taskId, this.progressReporter.runId);
-        }
-        catch (error) {
-            if (error instanceof Error && error.message.includes('No next stage available')) {
-                this.logger.warn('No next stage available when attempting to progress run', {
-                    taskId,
-                    runId: this.progressReporter.runId,
-                    stage: currentStageKey,
-                    error: error.message,
-                });
-                this.emitEvent(this.adapter.createStatusEvent('no_next_stage', { stage: currentStageKey }));
-                await this.progressReporter.noNextStage(currentStageKey);
-                return;
-            }
-            throw error;
-        }
-    }
     // Direct prompt execution - still supported for low-level usage
     async run(prompt, options = {}) {
         await this._configureLlmGateway();
@@ -709,7 +497,7 @@ class Agent {
             return await this.extractor.extractQuestions(researchContent);
         }
     }
-    // Git operations for task workflow
+    // Git operations for task execution
     async createPlanningBranch(taskId) {
         this.logger.info('Creating planning branch', { taskId });
         const branchName = await this.gitManager.createTaskPlanningBranch(taskId);