@damper/cli 0.3.4 → 0.4.0

package/dist/commands/start.js

@@ -4,7 +4,7 @@ import { createDamperApi } from '../services/damper-api.js';
 import { createWorktree, getGitRoot } from '../services/worktree.js';
 import { bootstrapContext, refreshContext } from '../services/context-bootstrap.js';
 import { pickTask } from '../ui/task-picker.js';
-import { launchClaude, isClaudeInstalled, isDamperMcpConfigured, configureDamperMcp } from '../services/claude.js';
+import { launchClaude, postTaskFlow, isClaudeInstalled, isDamperMcpConfigured, configureDamperMcp } from '../services/claude.js';
 import { getWorktreesForProject, cleanupStaleWorktrees } from '../services/state.js';
 import { getApiKey, isProjectConfigured, getProjectConfigPath } from '../services/config.js';
 export async function startCommand(options) {
@@ -148,11 +148,18 @@ export async function startCommand(options) {
         }
     }
     // Launch Claude with project's API key
-    await launchClaude({
+    const result = await launchClaude({
         cwd: worktreePath,
         taskId,
         taskTitle,
         apiKey,
         yolo: options.yolo,
     });
+    // Post-task flow: push, PR, cleanup
+    await postTaskFlow({
+        cwd: result.cwd,
+        taskId: result.taskId,
+        apiKey: result.apiKey,
+        projectRoot,
+    });
 }

package/dist/index.js

@@ -4,7 +4,7 @@ import { startCommand } from './commands/start.js';
 import { statusCommand } from './commands/status.js';
 import { cleanupCommand } from './commands/cleanup.js';
 import { setupCommand } from './commands/setup.js';
-const VERSION = '0.3.4';
+const VERSION = '0.4.0';
 function showHelp() {
     console.log(`
 ${pc.bold('@damper/cli')} - Agent orchestration for Damper tasks

package/dist/services/claude.d.ts

@@ -31,6 +31,19 @@ export declare function launchClaude(options: {
     taskTitle: string;
     apiKey: string;
     yolo?: boolean;
+}): Promise<{
+    cwd: string;
+    taskId: string;
+    apiKey: string;
+}>;
+/**
+ * Post-task actions after Claude exits
+ */
+export declare function postTaskFlow(options: {
+    cwd: string;
+    taskId: string;
+    apiKey: string;
+    projectRoot: string;
 }): Promise<void>;
 /**
  * Check if Claude Code CLI is installed

package/dist/services/claude.js

@@ -85,13 +85,29 @@ export function configureDamperMcp() {
 export async function launchClaude(options) {
     const { cwd, taskId, taskTitle, apiKey, yolo } = options;
     console.log(pc.green(`\nStarting Claude Code for task #${taskId}: ${taskTitle}`));
+    console.log(pc.dim(`Directory: ${cwd}`));
+    console.log();
+    // Show workflow explanation
+    console.log(pc.bold('Workflow:'));
+    console.log(pc.dim('  1. Claude reads TASK_CONTEXT.md and creates a plan'));
+    if (!yolo) {
+        console.log(pc.dim('  2. You approve the plan before Claude makes changes'));
+    }
+    console.log(pc.dim(`  ${yolo ? '2' : '3'}. Claude implements the task, logging progress to Damper`));
+    console.log(pc.dim(`  ${yolo ? '3' : '4'}. Claude calls complete_task (or abandon_task) when done`));
+    console.log();
+    console.log(pc.bold('When finished:'));
+    console.log(pc.dim('  • Push your branch and create a PR if needed'));
+    console.log(pc.dim('  • Run: npx @damper/cli cleanup'));
+    console.log(pc.dim('    (removes worktree and branch)'));
+    console.log();
     if (yolo) {
-        console.log(pc.yellow('Mode: YOLO (accepting edits without confirmation)'));
+        console.log(pc.yellow('Mode: YOLO (auto-accepting edits)'));
     }
     else {
-        console.log(pc.dim('Mode: Plan (will ask for approval before making changes)'));
+        console.log(pc.cyan('Mode: Plan (will ask for approval)'));
     }
-    console.log(pc.dim(`Directory: ${cwd}\n`));
+    console.log();
     // Build initial prompt
     const planModeNote = yolo ? '' : `
 You're in PLAN MODE. First, read TASK_CONTEXT.md and create an implementation plan.
@@ -146,7 +162,129 @@ Once approved, switch to implementation and start logging your work.
             console.log(pc.dim('Install it with: npm install -g @anthropic-ai/claude-code\n'));
             process.exit(1);
         }
-        throw err;
+        // Claude exited with error - still continue to post-task flow
+    }
+    // Post-task flow
+    console.log(pc.dim('\n─────────────────────────────────────────'));
+    console.log(pc.bold('\nClaude session ended.\n'));
+    return { cwd, taskId, apiKey };
+}
+/**
+ * Post-task actions after Claude exits
+ */
+export async function postTaskFlow(options) {
+    const { cwd, taskId, apiKey, projectRoot } = options;
+    const { confirm, select } = await import('@inquirer/prompts');
+    const { createDamperApi } = await import('./damper-api.js');
+    const { removeWorktreeDir } = await import('./worktree.js');
+    const { removeWorktree } = await import('./state.js');
+    // Check task status from Damper
+    let taskStatus;
+    let taskTitle;
+    try {
+        const api = createDamperApi(apiKey);
+        const task = await api.getTask(taskId);
+        taskStatus = task.status;
+        taskTitle = task.title;
+    }
+    catch {
+        console.log(pc.yellow('Could not fetch task status from Damper.'));
+    }
+    // Check git status
+    let hasUnpushedCommits = false;
+    let hasUncommittedChanges = false;
+    let currentBranch = '';
+    try {
+        const { execa } = await import('execa');
+        // Get current branch
+        const { stdout: branch } = await execa('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd, stdio: 'pipe' });
+        currentBranch = branch.trim();
+        // Check for uncommitted changes
+        const { stdout: status } = await execa('git', ['status', '--porcelain'], { cwd, stdio: 'pipe' });
+        hasUncommittedChanges = status.trim().length > 0;
+        // Check for unpushed commits
+        try {
+            const { stdout: unpushed } = await execa('git', ['log', '@{u}..HEAD', '--oneline'], { cwd, stdio: 'pipe' });
+            hasUnpushedCommits = unpushed.trim().length > 0;
+        }
+        catch {
+            // No upstream branch - assume all commits are unpushed
+            const { stdout: commits } = await execa('git', ['log', 'main..HEAD', '--oneline'], { cwd, stdio: 'pipe' });
+            hasUnpushedCommits = commits.trim().length > 0;
+        }
+    }
+    catch {
+        // Ignore git errors
+    }
+    // Show status
+    if (taskStatus) {
+        const statusColor = taskStatus === 'done' ? pc.green : taskStatus === 'in_progress' ? pc.yellow : pc.dim;
+        console.log(`Task status: ${statusColor(taskStatus)}`);
+    }
+    if (currentBranch) {
+        console.log(`Branch: ${pc.cyan(currentBranch)}`);
+    }
+    if (hasUncommittedChanges) {
+        console.log(pc.yellow('⚠ Uncommitted changes detected'));
+    }
+    if (hasUnpushedCommits) {
+        console.log(pc.yellow('⚠ Unpushed commits detected'));
+    }
+    console.log();
+    // Offer actions based on state
+    if (hasUncommittedChanges) {
+        console.log(pc.dim('You have uncommitted changes. Commit them before pushing.\n'));
+    }
+    if (hasUnpushedCommits && !hasUncommittedChanges) {
+        const shouldPush = await confirm({
+            message: 'Push commits to remote?',
+            default: true,
+        });
+        if (shouldPush) {
+            try {
+                const { execa } = await import('execa');
+                await execa('git', ['push', '-u', 'origin', currentBranch], { cwd, stdio: 'inherit' });
+                console.log(pc.green('✓ Pushed to remote\n'));
+                // Offer to create PR
+                const shouldCreatePR = await confirm({
+                    message: 'Create a pull request?',
+                    default: true,
+                });
+                if (shouldCreatePR) {
+                    try {
+                        await execa('gh', ['pr', 'create', '--fill'], { cwd, stdio: 'inherit' });
+                    }
+                    catch {
+                        console.log(pc.yellow('Could not create PR. You can create it manually on GitHub.\n'));
+                    }
+                }
+            }
+            catch {
+                console.log(pc.red('Failed to push. You can push manually.\n'));
+            }
+        }
+    }
+    // Offer cleanup if task is done or abandoned
+    if (taskStatus === 'done' || taskStatus === 'planned') {
+        const statusText = taskStatus === 'done' ? 'completed' : 'not started/abandoned';
+        const shouldCleanup = await confirm({
+            message: `Task is ${statusText}. Remove worktree and branch?`,
+            default: taskStatus === 'done',
+        });
+        if (shouldCleanup) {
+            try {
+                await removeWorktreeDir(cwd, projectRoot);
+                console.log(pc.green('✓ Worktree and branch removed\n'));
+            }
+            catch (err) {
+                const error = err;
+                console.log(pc.red(`Failed to remove worktree: ${error.message}\n`));
+            }
+        }
+    }
+    else if (taskStatus === 'in_progress') {
+        console.log(pc.dim('Task is still in progress. Run `npx @damper/cli` to resume later.'));
+        console.log(pc.dim('Run `npx @damper/cli cleanup` when ready to remove the worktree.\n'));
     }
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damper/cli",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "CLI tool for orchestrating Damper task workflows with Claude Code",
   "author": "Damper <hello@usedamper.com>",
   "repository": {