@damper/cli 0.9.9 → 0.9.11

package/dist/services/claude.js

@@ -4,7 +4,7 @@ import * as os from 'node:os';
 import { spawn } from 'node:child_process';
 import { execa } from 'execa';
 import pc from 'picocolors';
-import { shortIdRaw } from '../ui/format.js';
+import { shortIdRaw, setTerminalTitle, clearTerminalTitle, TerminalStatusBar } from '../ui/format.js';
 const CLAUDE_SETTINGS_DIR = path.join(os.homedir(), '.claude');
 const CLAUDE_SETTINGS_FILE = path.join(CLAUDE_SETTINGS_DIR, 'settings.json');
 /**
@@ -136,6 +136,11 @@ export async function launchClaude(options) {
         args = yolo ? ['--dangerously-skip-permissions', initialPrompt] : [initialPrompt];
         console.log(pc.dim(`Launching Claude in ${cwd}...`));
     }
+    // Set terminal title and bottom status bar
+    const taskLabel = `#${shortIdRaw(taskId)}: ${taskTitle}`;
+    setTerminalTitle(taskLabel);
+    const statusBar = new TerminalStatusBar(taskLabel);
+    statusBar.show();
     // Launch Claude Code
     // Use spawn with stdio: 'inherit' for proper TTY passthrough
     // Signals (Ctrl+C, Escape) are handled naturally since child inherits the terminal
@@ -158,6 +163,9 @@ export async function launchClaude(options) {
         });
         child.on('close', () => resolve());
     });
+    // Clean up status bar and terminal title
+    statusBar.hide();
+    clearTerminalTitle();
     console.log(pc.dim('\n─────────────────────────────────────────\n'));
     return { cwd, taskId, apiKey };
 }
@@ -539,6 +547,10 @@ export async function launchClaudeForReview(options) {
         '',
         'IMPORTANT: Do NOT make any code changes. This is a review-only session.',
     ].join('\n');
+    const reviewLabel = `Review #${shortIdRaw(taskId)}`;
+    setTerminalTitle(reviewLabel);
+    const statusBar = new TerminalStatusBar(reviewLabel);
+    statusBar.show();
     await new Promise((resolve) => {
         const child = spawn('claude', [prompt], {
             cwd,
@@ -548,6 +560,8 @@ export async function launchClaudeForReview(options) {
         child.on('error', () => resolve());
         child.on('close', () => resolve());
     });
+    statusBar.hide();
+    clearTerminalTitle();
 }
 /**
  * Launch Claude to resolve merge conflicts
@@ -557,6 +571,10 @@ export async function launchClaudeForReview(options) {
 async function launchClaudeForMerge(options) {
     const { cwd, apiKey } = options;
     const prompt = 'IMPORTANT: Your ONLY job is to resolve merge conflicts. Do NOT read TASK_CONTEXT.md or work on any task. Run: git merge origin/main --no-edit. If there are conflicts, resolve them, stage, and commit. Do not use any MCP tools.';
+    const mergeLabel = 'Resolving merge conflicts';
+    setTerminalTitle(mergeLabel);
+    const statusBar = new TerminalStatusBar(mergeLabel);
+    statusBar.show();
     await new Promise((resolve) => {
         const child = spawn('claude', ['--allowedTools', 'Bash,Read,Write,Edit,Glob,Grep', prompt], {
             cwd,
@@ -566,6 +584,8 @@ async function launchClaudeForMerge(options) {
         child.on('error', () => resolve());
         child.on('close', () => resolve());
     });
+    statusBar.hide();
+    clearTerminalTitle();
 }
 /**
  * Check if Claude Code CLI is installed

package/dist/services/damper-api.d.ts

@@ -219,7 +219,7 @@ export declare class DamperApi {
             title: string;
         }>;
     }>;
-    createTask(title: string, type?: 'bug' | 'feature' | 'improvement' | 'task', description?: string): Promise<Task>;
+    createTask(title: string, type?: 'bug' | 'feature' | 'improvement' | 'task', description?: string, isPublic?: boolean): Promise<Task>;
     deleteTask(taskId: string): Promise<{
         id: string;
         deleted: boolean;

package/dist/services/damper-api.js

@@ -189,8 +189,8 @@ This project uses Damper MCP for task tracking. **You MUST follow this workflow.
         return this.request('POST', `/api/agent/changelogs/${changelogId}/items`, { taskIds });
     }
     // Create task
-    async createTask(title, type = 'task', description) {
-        return this.request('POST', '/api/agent/tasks', { title, type, status: 'planned', description });
+    async createTask(title, type = 'task', description, isPublic) {
+        return this.request('POST', '/api/agent/tasks', { title, type, status: 'planned', description, isPublic });
     }
     // Delete task (only planned, no commits)
     async deleteTask(taskId) {

package/dist/templates/CLAUDE_APPEND.md.js

@@ -27,7 +27,7 @@ ${planSection}
 1. **Do NOT commit or complete tasks without explicit user confirmation** - Always ask the user before running \`git commit\` or calling \`complete_task\`
 2. Use \`add_commit\` after each git commit
 3. Use \`add_note\` ONLY for non-obvious approach decisions (e.g. "Decision: chose X because Y")
-4. When user confirms: call \`complete_task\` with a one-line summary
+4. When user confirms: call \`complete_task\` with summary and \`reviewInstructions\` (what to test/verify)
 5. If stopping early: call \`abandon_task\` with what remains and blockers
 
 The CLI just bootstrapped this environment - YOU handle the task lifecycle.

package/dist/ui/format.d.ts

@@ -35,6 +35,23 @@ export declare function formatSubtaskProgress(progress: {
 export declare function relativeTime(date: string | Date | null | undefined): string;
 /** Returns a picocolors function for the given status */
 export declare function statusColor(status: string): (s: string) => string;
+/** Set terminal tab/window title via ANSI escape sequence (OSC 0) */
+export declare function setTerminalTitle(title: string): void;
+/** Clear terminal title (restore default behavior) */
+export declare function clearTerminalTitle(): void;
+/**
+ * Persistent bottom status bar using ANSI scroll region (DECSTBM).
+ * Reserves the last terminal row for a fixed label while the child process
+ * operates inside the scroll region above it.
+ */
+export declare class TerminalStatusBar {
+    private title;
+    private handleResize;
+    constructor(title: string);
+    show(): void;
+    hide(): void;
+    private draw;
+}
 /** Terminal width (min 80) */
 export declare function getTerminalWidth(): number;
 /** Section header spanning terminal width: `── Label ───────────` */

package/dist/ui/format.js

@@ -144,6 +144,62 @@ export function statusColor(status) {
         default: return pc.dim;
     }
 }
+/** Set terminal tab/window title via ANSI escape sequence (OSC 0) */
+export function setTerminalTitle(title) {
+    if (process.stdout.isTTY) {
+        process.stdout.write(`\x1b]0;${title}\x07`);
+    }
+}
+/** Clear terminal title (restore default behavior) */
+export function clearTerminalTitle() {
+    if (process.stdout.isTTY) {
+        process.stdout.write(`\x1b]0;\x07`);
+    }
+}
+/**
+ * Persistent bottom status bar using ANSI scroll region (DECSTBM).
+ * Reserves the last terminal row for a fixed label while the child process
+ * operates inside the scroll region above it.
+ */
+export class TerminalStatusBar {
+    title;
+    handleResize = null;
+    constructor(title) {
+        this.title = title;
+    }
+    show() {
+        if (!process.stdout.isTTY)
+            return;
+        this.draw();
+        this.handleResize = () => this.draw();
+        process.stdout.on('resize', this.handleResize);
+    }
+    hide() {
+        if (!process.stdout.isTTY)
+            return;
+        if (this.handleResize) {
+            process.stdout.off('resize', this.handleResize);
+            this.handleResize = null;
+        }
+        const rows = process.stdout.rows || 24;
+        process.stdout.write('\x1b[r' + // Reset scroll region to full terminal
+            `\x1b[${rows};1H` + // Move to the status bar row
+            '\x1b[2K' // Clear the line
+        );
+    }
+    draw() {
+        const rows = process.stdout.rows || 24;
+        const cols = process.stdout.columns || 80;
+        const bar = ` ${this.title}`.padEnd(cols).slice(0, cols);
+        process.stdout.write('\x1b7' + // Save cursor position
+            `\x1b[${rows};1H` + // Move to last row
+            '\x1b[2K' + // Clear the line
+            '\x1b[7m' + bar + '\x1b[0m' + // Draw bar in inverse video
+            `\x1b[1;${rows - 1}r` + // Set scroll region above bar
+            '\x1b8' // Restore cursor position
+        );
+    }
+}
 /** Terminal width (min 80) */
 export function getTerminalWidth() {
     return Math.max(80, process.stdout.columns || 80);

package/dist/ui/task-picker.js

@@ -174,11 +174,19 @@ export async function pickTask(options) {
         }
     }
     console.log(pc.bold(`\nProject: ${project}`));
+    // Track last search term for passing to create flow
+    let lastSearchTerm = '';
     // Build choices with search filtering support
     const buildChoices = (term) => {
         const lowerTerm = term?.toLowerCase().trim() || '';
+        lastSearchTerm = term?.trim() || '';
         const matches = (task) => !lowerTerm || task.title.toLowerCase().includes(lowerTerm) || task.id.includes(lowerTerm);
         const filtered = [];
+        // Always show "Create new task" at the top
+        const createLabel = lastSearchTerm
+            ? pc.green(`+ New task: "${lastSearchTerm}"`)
+            : pc.green('+ Create new task');
+        filtered.push({ name: createLabel, value: { type: 'create_new' } });
         const filteredInProgress = inProgressChoices.filter(c => matches(c.task));
         if (filteredInProgress.length > 0) {
             filtered.push(new Separator(`\n${sectionHeader(`In Progress (${filteredInProgress.length})`)}`));
@@ -200,9 +208,6 @@ export async function pickTask(options) {
                 filtered.push({ name: formatTaskChoice(choice, titleWidth, layout), value: choice });
             }
         }
-        // Always show "Create new task"
-        filtered.push(new Separator(''));
-        filtered.push({ name: pc.green('+ Create new task'), value: { type: 'create_new' } });
         return filtered;
     };
     const selected = await search({
@@ -211,7 +216,7 @@ export async function pickTask(options) {
         pageSize: 20,
     });
     if (selected.type === 'create_new') {
-        return handleCreateNewTask(api);
+        return handleCreateNewTask(api, lastSearchTerm);
     }
     if (selected.type === 'in_progress') {
         const action = await select({
@@ -260,41 +265,14 @@ export async function pickTask(options) {
         action,
     };
 }
-async function generateTaskTitle(instructions, type) {
-    try {
-        const { execa } = await import('execa');
-        const prompt = [
-            `Generate a task title for a ${type} task.`,
-            'Rules:',
-            '- Max 60 characters, sentence case, no trailing period',
-            '- Verb prefix matching type: bug → "Fix …", feature → "Add …", improvement → "Improve …", task → "Set up …" / "Update …"',
-            '- Specific enough to understand without reading a description',
-            '- Examples: "Add dark mode support", "Fix login timeout on slow connections", "Improve search result ranking"',
-            'Return ONLY the title, nothing else.',
-            '',
-            `User input: ${instructions}`,
-        ].join('\n');
-        const { stdout } = await execa('claude', ['--print', '--model', 'haiku', prompt], {
-            stdio: 'pipe',
-            timeout: 15000,
-        });
-        const title = stdout.trim();
-        if (title && title.length <= 80 && !title.includes('\n')) {
-            return title;
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}
-async function handleCreateNewTask(api) {
-    const instructions = await input({
-        message: 'What needs to be done?',
-        validate: (value) => value.trim().length > 0 || 'Instructions are required',
+async function handleCreateNewTask(api, searchTerm) {
+    const title = await input({
+        message: 'Task title:',
+        default: searchTerm || undefined,
+        validate: (value) => value.trim().length > 0 || 'Title is required',
     });
-    const details = await input({
-        message: 'Additional details (optional, press Enter to skip):',
+    const description = await input({
+        message: 'Description (optional, press Enter to skip):',
     });
     const type = await select({
         message: 'Task type:',
@@ -305,24 +283,17 @@ async function handleCreateNewTask(api) {
             { name: 'Task', value: 'task' },
         ],
     });
-    const trimmed = instructions.trim();
-    const trimmedDetails = details.trim();
-    const fullInput = trimmedDetails ? `${trimmed}\n\n${trimmedDetails}` : trimmed;
-    // Generate title with Claude, fall back to truncation
-    console.log(pc.dim('\nGenerating title...'));
-    const generatedTitle = await generateTaskTitle(fullInput, type);
-    let title;
-    if (generatedTitle) {
-        title = generatedTitle;
-    }
-    else {
-        const maxTitleLen = 60;
-        title = trimmed.length <= maxTitleLen
-            ? trimmed
-            : trimmed.slice(0, trimmed.lastIndexOf(' ', maxTitleLen) || maxTitleLen) + '…';
-    }
+    const isPublic = await select({
+        message: 'Visibility:',
+        choices: [
+            { name: 'Public', value: true },
+            { name: 'Private', value: false },
+        ],
+    });
+    const trimmedTitle = title.trim();
+    const trimmedDescription = description.trim() || undefined;
     console.log(pc.dim('Creating task in Damper...'));
-    const task = await api.createTask(title, type, fullInput);
+    const task = await api.createTask(trimmedTitle, type, trimmedDescription, isPublic);
     console.log(pc.green(`✓ Created task #${shortIdRaw(task.id)}: ${task.title}`));
     return {
         task,

package/package.json

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