@damper/cli 0.9.4 → 0.9.6

package/dist/services/claude.js

@@ -174,12 +174,14 @@ export async function postTaskFlow(options) {
     let taskStatus;
     let taskTitle;
     let hasCommits = false;
+    let isPublicTask = false;
     try {
         const api = createDamperApi(apiKey);
         const task = await api.getTask(taskId);
         taskStatus = task.status;
         taskTitle = task.title;
         hasCommits = (task.commits?.length ?? 0) > 0;
+        isPublicTask = !!task.publicUrl;
     }
     catch {
         console.log(pc.yellow('Could not fetch task status from Damper.'));
@@ -254,6 +256,10 @@ export async function postTaskFlow(options) {
         console.log(pc.yellow('⚠ Unpushed commits detected'));
     }
     console.log();
+    // Offer to add to changelog if task is completed
+    if (taskStatus === 'done') {
+        await offerChangelogFlow({ taskId, taskTitle, apiKey, isPublic: isPublicTask, confirm, select });
+    }
     // Offer actions based on state
     const hasChanges = hasUnpushedCommits || hasUncommittedChanges;
     let worktreeRemoved = false;
@@ -441,6 +447,67 @@ export async function postTaskFlow(options) {
     }
     console.log();
 }
+/**
+ * Ask user if they want to add the completed task to a changelog
+ */
+async function offerChangelogFlow(options) {
+    const { taskId, taskTitle, apiKey, isPublic, confirm, select } = options;
+    const { input } = await import('@inquirer/prompts');
+    const addToChangelog = await confirm({
+        message: 'Add this task to a changelog?',
+        default: isPublic,
+    });
+    if (!addToChangelog)
+        return;
+    try {
+        const { createDamperApi } = await import('./damper-api.js');
+        const api = createDamperApi(apiKey);
+        // Fetch draft changelogs
+        const { changelogs } = await api.listChangelogs({ status: 'draft', limit: 10 });
+        let changelogId;
+        if (changelogs.length > 0) {
+            const choice = await select({
+                message: 'Which changelog?',
+                choices: [
+                    ...changelogs.map((cl) => ({
+                        name: `${cl.title}${cl.version ? ` (${cl.version})` : ''} — ${cl.roadmapItemCount} item${cl.roadmapItemCount !== 1 ? 's' : ''}`,
+                        value: cl.id,
+                    })),
+                    { name: 'Create new changelog', value: '__new__' },
+                ],
+            });
+            if (choice === '__new__') {
+                const title = await input({
+                    message: 'Changelog title:',
+                    default: `Release ${new Date().toISOString().slice(0, 10)}`,
+                });
+                const result = await api.createChangelog({ title });
+                changelogId = result.id;
+                console.log(pc.green(`✓ Created changelog: ${title}`));
+            }
+            else {
+                changelogId = choice;
+            }
+        }
+        else {
+            // No drafts — create one
+            const title = await input({
+                message: 'No draft changelogs found. Create one — title:',
+                default: `Release ${new Date().toISOString().slice(0, 10)}`,
+            });
+            const result = await api.createChangelog({ title });
+            changelogId = result.id;
+            console.log(pc.green(`✓ Created changelog: ${title}`));
+        }
+        // Add the task
+        const result = await api.addToChangelog(changelogId, [taskId]);
+        console.log(pc.green(`✓ Added "${taskTitle || taskId}" to changelog (${result.roadmapItemCount} total items)\n`));
+    }
+    catch (err) {
+        const error = err;
+        console.log(pc.yellow(`Could not add to changelog: ${error.message}\n`));
+    }
+}
 /**
  * Launch Claude to review and complete a task
  */

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

@@ -37,6 +37,7 @@ export interface TaskDetail extends Task {
     }>;
     lockedBy?: string | null;
     lockedAt?: string | null;
+    publicUrl?: string | null;
 }
 export interface ContextSection {
     section: string;
@@ -76,6 +77,16 @@ export interface Module {
     tags?: string[];
     updatedAt: string;
 }
+export interface Changelog {
+    id: string;
+    title: string;
+    version?: string | null;
+    date?: string | null;
+    status: 'draft' | 'published';
+    publishedAt?: string | null;
+    roadmapItemCount: number;
+    contentPreview: string;
+}
 export interface AgentInstructions {
     format: 'markdown' | 'section';
     content: string;
@@ -182,6 +193,32 @@ export declare class DamperApi {
     }>;
     getModule(name: string): Promise<Module>;
     getAgentInstructions(format?: 'markdown' | 'section'): Promise<AgentInstructions>;
+    listChangelogs(filters?: {
+        status?: 'draft' | 'published';
+        limit?: number;
+        sort?: 'newest' | 'oldest';
+    }): Promise<{
+        changelogs: Changelog[];
+    }>;
+    createChangelog(data: {
+        title: string;
+        content?: string;
+        version?: string;
+        status?: 'draft' | 'published';
+    }): Promise<{
+        id: string;
+        title: string;
+        status: string;
+    }>;
+    addToChangelog(changelogId: string, taskIds: string[]): Promise<{
+        id: string;
+        title: string;
+        roadmapItemCount: number;
+        addedItems: Array<{
+            id: string;
+            title: string;
+        }>;
+    }>;
     createTask(title: string, type?: 'bug' | 'feature' | 'improvement' | 'task', description?: string): Promise<Task>;
     deleteTask(taskId: string): Promise<{
         id: string;

package/dist/services/damper-api.js

@@ -170,6 +170,24 @@ This project uses Damper MCP for task tracking. **You MUST follow this workflow.
             lastModified,
         };
     }
+    // Changelogs
+    async listChangelogs(filters) {
+        const params = new URLSearchParams();
+        if (filters?.status)
+            params.set('status', filters.status);
+        if (filters?.limit)
+            params.set('limit', String(filters.limit));
+        if (filters?.sort)
+            params.set('sort', filters.sort);
+        const query = params.toString();
+        return this.request('GET', `/api/agent/changelogs${query ? `?${query}` : ''}`);
+    }
+    async createChangelog(data) {
+        return this.request('POST', '/api/agent/changelogs', data);
+    }
+    async addToChangelog(changelogId, taskIds) {
+        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 });

package/dist/ui/task-picker.js

@@ -260,6 +260,34 @@ 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?',
@@ -274,16 +302,23 @@ async function handleCreateNewTask(api) {
             { name: 'Task', value: 'task' },
         ],
     });
-    // Use instructions as description; derive a placeholder title
     const trimmed = instructions.trim();
-    const maxTitleLen = 60;
-    const placeholderTitle = trimmed.length <= maxTitleLen
-        ? trimmed
-        : trimmed.slice(0, trimmed.lastIndexOf(' ', maxTitleLen) || maxTitleLen) + '…';
-    console.log(pc.dim('\nCreating task in Damper...'));
-    const task = await api.createTask(placeholderTitle, type, trimmed);
+    // Generate title with Claude, fall back to truncation
+    console.log(pc.dim('\nGenerating title...'));
+    const generatedTitle = await generateTaskTitle(trimmed, type);
+    let title;
+    if (generatedTitle) {
+        title = generatedTitle;
+    }
+    else {
+        const maxTitleLen = 60;
+        title = trimmed.length <= maxTitleLen
+            ? trimmed
+            : trimmed.slice(0, trimmed.lastIndexOf(' ', maxTitleLen) || maxTitleLen) + '…';
+    }
+    console.log(pc.dim('Creating task in Damper...'));
+    const task = await api.createTask(title, type, trimmed);
     console.log(pc.green(`✓ Created task #${shortIdRaw(task.id)}: ${task.title}`));
-    console.log(pc.dim('  The agent will refine the title after planning.'));
     return {
         task,
         isResume: false,

package/package.json

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