@lovelybunch/cli 1.0.75-alpha.9 → 1.0.76-alpha.0

package/dist/commands/task.js

@@ -5,11 +5,11 @@ import inquirer from 'inquirer';
 import { promises as fs } from 'fs';
 import { table } from 'table';
 import os from 'os';
-import { listProposals, getProposal, createProposal, updateProposal, deleteProposal, addPlanStep, addComment, } from '@lovelybunch/core';
+import { listTasks, getTask, createTask, updateTask, deleteTask, addPlanStep, updatePlanStep, addComment, } from '@lovelybunch/core';
 // ============================================================================
 // Constants & Helpers
 // ============================================================================
-const VALID_STATUSES = ['draft', 'backlog', 'ready', 'queued', 'active', 'blocked', 'review', 'done', 'canceled', 'duplicate'];
+const VALID_STATUSES = ['draft', 'backlog', 'ready', 'queued', 'active', 'blocked', 'review', 'revision', 'done', 'canceled', 'duplicate'];
 const VALID_PRIORITIES = ['low', 'medium', 'high', 'critical'];
 function parseTags(tagsString) {
     if (!tagsString)
@@ -38,6 +38,15 @@ function validateStatus(status) {
     }
     return normalized;
 }
+function validateReadiness(value) {
+    if (value == null)
+        return undefined;
+    const n = parseInt(value, 10);
+    if (Number.isNaN(n) || n < 0 || n > 100) {
+        throw new Error(`Invalid readiness "${value}". Must be an integer between 0 and 100.`);
+    }
+    return n;
+}
 function interpretEscapeSequences(str) {
     return str
         .replace(/\\n/g, '\n')
@@ -54,6 +63,7 @@ function getStatusColor(status) {
         active: chalk.yellow,
         blocked: chalk.red,
         review: chalk.cyan,
+        revision: chalk.magenta,
         done: chalk.green,
         canceled: chalk.gray,
         duplicate: chalk.gray,
@@ -72,9 +82,10 @@ function getPriorityColor(priority) {
 function getStepStatusIcon(status) {
     const icons = {
         pending: chalk.gray('○'),
-        'in-progress': chalk.yellow('◐'),
-        completed: chalk.green('●'),
+        active: chalk.yellow('◐'),
+        done: chalk.green('●'),
         failed: chalk.red('✗'),
+        skipped: chalk.dim('⊘'),
     };
     return icons[status] || chalk.gray('○');
 }
@@ -82,8 +93,7 @@ function getStepStatusIcon(status) {
 // Parent Command
 // ============================================================================
 export const taskCommand = new Command('task')
-    .description('Manage tasks (change proposals)')
-    .alias('proposal')
+    .description('Manage tasks')
     .addHelpText('after', `
 Examples:
   ${chalk.gray('# List all tasks')}
@@ -119,7 +129,7 @@ Examples:
 taskCommand
     .command('list')
     .description('List all tasks')
-    .option('-s, --status <status>', 'Filter by status (draft|backlog|ready|queued|active|blocked|review|done|canceled|duplicate)')
+    .option('-s, --status <status>', 'Filter by status (draft|backlog|ready|queued|active|blocked|review|revision|done|canceled|duplicate)')
     .option('-a, --author <author>', 'Filter by author name or email')
     .option('-p, --priority <priority>', 'Filter by priority (low|medium|high|critical)')
     .option('-q, --search <query>', 'Search tasks by content (fuzzy search)')
@@ -145,9 +155,10 @@ taskCommand
         if (options.search) {
             filters.search = options.search;
         }
-        const proposals = await listProposals(filters);
         const limit = parseInt(options.limit, 10) || 20;
-        const limited = proposals.slice(0, limit);
+        filters.limit = limit;
+        const tasks = await listTasks(filters);
+        const limited = tasks.slice(0, limit);
         spinner.stop();
         if (options.json) {
             console.log(JSON.stringify(limited, null, 2));
@@ -167,26 +178,32 @@ taskCommand
         const tableData = [
             [
                 chalk.bold('ID'),
-                chalk.bold('Intent'),
+                chalk.bold('Title'),
                 chalk.bold('Author'),
                 chalk.bold('Status'),
                 chalk.bold('Priority'),
+                chalk.bold('Steps'),
                 chalk.bold('Created'),
             ],
         ];
-        for (const proposal of limited) {
-            const titleText = proposal.title || proposal.intent || '';
+        for (const task of limited) {
+            const titleText = task.title || task.intent || '';
             const displayTitle = titleText.length > 35
                 ? titleText.substring(0, 32) + '...'
                 : titleText;
-            const priority = proposal.metadata?.priority || 'medium';
+            const priority = task.metadata?.priority || 'medium';
+            const steps = task.planSteps || [];
+            const stepsDisplay = steps.length > 0
+                ? chalk.dim(`${steps.filter(s => s.status === 'done').length}/${steps.length}`)
+                : chalk.dim('-');
             tableData.push([
-                chalk.cyan(proposal.id),
+                chalk.cyan(task.id),
                 displayTitle,
-                proposal.author.name,
-                getStatusColor(proposal.status)(proposal.status),
+                task.author.name,
+                getStatusColor(task.status)(task.status),
                 getPriorityColor(priority)(priority),
-                chalk.gray(new Date(proposal.metadata?.createdAt || '').toLocaleDateString()),
+                stepsDisplay,
+                chalk.gray(new Date(task.metadata?.createdAt || '').toLocaleDateString()),
             ]);
         }
         // Display table
@@ -211,7 +228,7 @@ taskCommand
         };
         console.log('\n' + chalk.bold.underline('Tasks'));
         console.log(table(tableData, tableConfig));
-        console.log(chalk.gray(`Showing ${limited.length} of ${proposals.length} tasks`));
+        console.log(chalk.gray(`Showing ${limited.length} of ${tasks.length} tasks`));
     }
     catch (error) {
         spinner.fail('Failed to list tasks');
@@ -231,19 +248,19 @@ taskCommand
     .action(async (id, options) => {
     const spinner = ora('Loading task...').start();
     try {
-        const proposal = await getProposal(id);
+        const task = await getTask(id);
         spinner.stop();
-        if (!proposal) {
+        if (!task) {
             console.error(chalk.red(`Task '${id}' not found.`));
             console.log(chalk.gray('Use "nut task list" to see all tasks.'));
             process.exit(1);
         }
         if (options.json) {
-            console.log(JSON.stringify(proposal, null, 2));
+            console.log(JSON.stringify(task, null, 2));
             return;
         }
-        if (options.raw && proposal.content) {
-            console.log(proposal.content);
+        if (options.raw && task.content) {
+            console.log(task.content);
             return;
         }
         // Display formatted output
@@ -251,55 +268,75 @@ taskCommand
         console.log();
         // Basic Information
         console.log(chalk.cyan('Basic Information:'));
-        console.log('  ID:          ' + chalk.white(proposal.id));
-        console.log('  Title:       ' + chalk.white(proposal.title || proposal.intent));
-        console.log('  Status:      ' + getStatusColor(proposal.status)(proposal.status.toUpperCase()));
-        if (proposal.metadata?.priority) {
-            console.log('  Priority:    ' + getPriorityColor(proposal.metadata.priority)(proposal.metadata.priority.toUpperCase()));
-        }
-        console.log('  Created:     ' + chalk.white(new Date(proposal.metadata?.createdAt || '').toLocaleString()));
-        console.log('  Updated:     ' + chalk.white(new Date(proposal.metadata?.updatedAt || '').toLocaleString()));
+        console.log('  ID:          ' + chalk.white(task.id));
+        console.log('  Title:       ' + chalk.white(task.title || task.intent));
+        console.log('  Status:      ' + getStatusColor(task.status)(task.status.toUpperCase()));
+        if (task.metadata?.priority) {
+            console.log('  Priority:    ' + getPriorityColor(task.metadata.priority)(task.metadata.priority.toUpperCase()));
+        }
+        if (task.metadata?.readiness != null) {
+            console.log('  Readiness:   ' + chalk.white(`${task.metadata.readiness}%`));
+        }
+        console.log('  Created:     ' + chalk.white(new Date(task.metadata?.createdAt || '').toLocaleString()));
+        console.log('  Updated:     ' + chalk.white(new Date(task.metadata?.updatedAt || '').toLocaleString()));
         // Author Information
         console.log('\n' + chalk.cyan('Author:'));
-        console.log('  Name:        ' + chalk.white(proposal.author.name));
-        console.log('  Type:        ' + chalk.white(proposal.author.type));
-        if (proposal.author.email) {
-            console.log('  Email:       ' + chalk.white(proposal.author.email));
+        console.log('  Name:        ' + chalk.white(task.author.name));
+        console.log('  Type:        ' + chalk.white(task.author.type));
+        if (task.author.email) {
+            console.log('  Email:       ' + chalk.white(task.author.email));
         }
         // Product Spec Reference
-        if (proposal.productSpecRef) {
+        if (task.productSpecRef) {
             console.log('\n' + chalk.cyan('Product Specification:'));
-            console.log('  Reference:   ' + chalk.white(proposal.productSpecRef));
+            console.log('  Reference:   ' + chalk.white(task.productSpecRef));
         }
         // Content
-        if (proposal.content) {
+        if (task.content) {
             console.log('\n' + chalk.cyan('Content:'));
-            const contentLines = proposal.content.split('\n').slice(0, 10);
-            contentLines.forEach(line => console.log('  ' + chalk.gray(line)));
-            if (proposal.content.split('\n').length > 10) {
-                console.log('  ' + chalk.gray('... (truncated)'));
-            }
+            task.content.split('\n').forEach(line => console.log('  ' + chalk.gray(line)));
+        }
+        // Comments
+        if (task.comments && task.comments.length > 0) {
+            console.log('\n' + chalk.cyan('Comments:'));
+            task.comments.forEach((comment) => {
+                const date = new Date(comment.createdAt).toLocaleString();
+                console.log('  ' + chalk.white(comment.author) + ' ' + chalk.dim(`(${date})`));
+                console.log('  ' + chalk.gray(comment.content));
+                console.log();
+            });
         }
         // Plan Steps
-        if (proposal.planSteps && proposal.planSteps.length > 0) {
-            console.log('\n' + chalk.cyan('Plan Steps:'));
-            proposal.planSteps.forEach((step, index) => {
+        if (task.planSteps && task.planSteps.length > 0) {
+            const doneCount = task.planSteps.filter(s => s.status === 'done').length;
+            const total = task.planSteps.length;
+            console.log('\n' + chalk.cyan('Plan Steps:') + ' ' + chalk.dim(`(${doneCount}/${total} done)`));
+            task.planSteps.forEach((step, index) => {
                 const statusIcon = getStepStatusIcon(step.status);
-                console.log(`  ${index + 1}. ${statusIcon} ${step.description}`);
+                console.log(`  ${index + 1}. ${statusIcon} ${chalk.dim(`[${step.id}]`)} ${step.description}`);
                 if (step.command) {
                     console.log('     Command: ' + chalk.gray(step.command));
                 }
             });
         }
+        // Reviewers
+        if (task.metadata?.reviewers && task.metadata.reviewers.length > 0) {
+            console.log('\n' + chalk.cyan('Reviewers:'));
+            console.log('  ' + task.metadata.reviewers.map(r => chalk.white(r)).join(', '));
+        }
         // Tags
-        if (proposal.metadata?.tags && proposal.metadata.tags.length > 0) {
+        if (task.metadata?.tags && task.metadata.tags.length > 0) {
             console.log('\n' + chalk.cyan('Tags:'));
-            console.log('  ' + proposal.metadata.tags.map(tag => chalk.magenta(`#${tag}`)).join(' '));
+            console.log('  ' + task.metadata.tags.map(tag => chalk.magenta(`#${tag}`)).join(' '));
         }
         // Actions
         console.log('\n' + chalk.cyan('Actions:'));
-        console.log('  • Update task:  ' + chalk.yellow(`nut task update ${proposal.id} --status <status>`));
-        console.log('  • Delete task:  ' + chalk.yellow(`nut task delete ${proposal.id}`));
+        console.log('  • Update status:       ' + chalk.yellow(`nut task update ${task.id} --status <status>`));
+        console.log('                         ' + chalk.gray(`statuses: ${VALID_STATUSES.join(', ')}`));
+        console.log('  • Add step:            ' + chalk.yellow(`nut task step ${task.id} "Description"`));
+        console.log('  • Update step:         ' + chalk.yellow(`nut task step-update ${task.id} <stepId> --status <status>`));
+        console.log('                         ' + chalk.gray('statuses: pending, active, done, failed, skipped'));
+        console.log('  • Add comment:         ' + chalk.yellow(`nut task comment ${task.id} "Comment"`));
     }
     catch (error) {
         spinner.fail('Failed to load task');
@@ -321,7 +358,8 @@ taskCommand
     .option('-f, --file <path>', 'Read content from a file')
     .option('-t, --tags <tags>', 'Comma-separated tags')
     .option('-p, --priority <level>', 'Priority (low|medium|high|critical)')
-    .option('-s, --status <status>', 'Initial status (draft|backlog|ready|queued|active|blocked|review|done|canceled|duplicate, default: draft)')
+    .option('-r, --readiness <score>', 'Readiness score (0-100)')
+    .option('-s, --status <status>', 'Initial status (draft|backlog|ready|queued|active|blocked|review|revision|done|canceled|duplicate, default: draft)')
     .option('--spec <ref>', 'Product specification reference')
     .option('--json', 'Output as JSON')
     .option('-y, --yes', 'Skip confirmation prompts')
@@ -369,7 +407,7 @@ taskCommand
             content = interpretEscapeSequences(options.content);
         }
         const spinner = ora('Creating task...').start();
-        const proposal = await createProposal({
+        const task = await createTask({
             intent: title,
             content: content || title, // Use title as content if no content provided
             author: {
@@ -382,28 +420,32 @@ taskCommand
             metadata: {
                 tags: parseTags(options.tags),
                 priority: validatePriority(options.priority),
+                readiness: validateReadiness(options.readiness),
             },
             productSpecRef: options.spec,
         });
-        spinner.succeed(`Task created: ${chalk.cyan(proposal.id)}`);
+        spinner.succeed(`Task created: ${chalk.cyan(task.id)}`);
         if (options.json) {
-            console.log(JSON.stringify(proposal, null, 2));
+            console.log(JSON.stringify(task, null, 2));
             return;
         }
         console.log('\n' + chalk.bold('Task Details:'));
-        console.log('  ID:       ' + chalk.cyan(proposal.id));
-        console.log('  Title:    ' + chalk.white(proposal.title || proposal.intent));
-        console.log('  Author:   ' + chalk.white(`${proposal.author.name} (${proposal.author.type})`));
-        console.log('  Status:   ' + getStatusColor(proposal.status)(proposal.status));
-        if (proposal.metadata?.priority) {
-            console.log('  Priority: ' + getPriorityColor(proposal.metadata.priority)(proposal.metadata.priority));
+        console.log('  ID:       ' + chalk.cyan(task.id));
+        console.log('  Title:    ' + chalk.white(task.title || task.intent));
+        console.log('  Author:   ' + chalk.white(`${task.author.name} (${task.author.type})`));
+        console.log('  Status:   ' + getStatusColor(task.status)(task.status));
+        if (task.metadata?.priority) {
+            console.log('  Priority: ' + getPriorityColor(task.metadata.priority)(task.metadata.priority));
+        }
+        if (task.metadata?.readiness != null) {
+            console.log('  Readiness: ' + chalk.white(`${task.metadata.readiness}%`));
         }
-        if (proposal.metadata?.tags && proposal.metadata.tags.length > 0) {
-            console.log('  Tags:     ' + chalk.gray(proposal.metadata.tags.join(', ')));
+        if (task.metadata?.tags && task.metadata.tags.length > 0) {
+            console.log('  Tags:     ' + chalk.gray(task.metadata.tags.join(', ')));
         }
         console.log('\n' + chalk.cyan('Next steps:'));
-        console.log('  • View task:    ' + chalk.yellow(`nut task get ${proposal.id}`));
-        console.log('  • Update task:  ' + chalk.yellow(`nut task update ${proposal.id} --status proposed`));
+        console.log('  • View task:    ' + chalk.yellow(`nut task get ${task.id}`));
+        console.log('  • Update task:  ' + chalk.yellow(`nut task update ${task.id} --status ready`));
         console.log('  • List tasks:   ' + chalk.yellow('nut task list'));
     }
     catch (error) {
@@ -421,9 +463,11 @@ taskCommand
     .option('-t, -i, --title, --intent <text>', 'Update title (aliases: -i, --intent)')
     .option('-c, --content <text>', 'Update content')
     .option('-f, --file <path>', 'Read new content from a file')
-    .option('-s, --status <status>', 'Update status (draft|backlog|ready|queued|active|blocked|review|done|canceled|duplicate)')
+    .option('-s, --status <status>', 'Update status (draft|backlog|ready|queued|active|blocked|review|revision|done|canceled|duplicate)')
     .option('-p, --priority <level>', 'Update priority (low|medium|high|critical)')
+    .option('-r, --readiness <score>', 'Update readiness score (0-100)')
     .option('--tags <tags>', 'Update tags (comma-separated)')
+    .option('--reviewers <reviewers>', 'Update reviewers (comma-separated names or emails)')
     .option('--spec <ref>', 'Update product specification reference')
     .option('--json', 'Output as JSON')
     .action(async (id, options) => {
@@ -431,10 +475,10 @@ taskCommand
         // Check if any update option is provided
         const titleValue = options.title || options.intent;
         const hasUpdates = titleValue || options.content || options.file ||
-            options.status || options.priority || options.tags || options.spec;
+            options.status || options.priority || options.readiness || options.tags || options.reviewers || options.spec;
         if (!hasUpdates) {
             console.error(chalk.red('No updates specified.'));
-            console.log(chalk.gray('Use --title, --content, --status, --priority, --tags, or --spec to update.'));
+            console.log(chalk.gray('Use --title, --content, --status, --priority, --readiness, --tags, --reviewers, or --spec to update.'));
             process.exit(1);
         }
         // Read content from file if specified
@@ -465,14 +509,18 @@ taskCommand
         if (options.spec !== undefined)
             updates.productSpecRef = options.spec;
         // Handle metadata updates
-        if (options.priority || options.tags) {
+        if (options.priority || options.readiness || options.tags || options.reviewers) {
             updates.metadata = {};
             if (options.priority)
                 updates.metadata.priority = validatePriority(options.priority);
+            if (options.readiness)
+                updates.metadata.readiness = validateReadiness(options.readiness);
             if (options.tags)
                 updates.metadata.tags = parseTags(options.tags);
+            if (options.reviewers)
+                updates.metadata.reviewers = options.reviewers.split(',').map((r) => r.trim()).filter((r) => r.length > 0);
         }
-        const updated = await updateProposal(id, updates);
+        const updated = await updateTask(id, updates);
         spinner.succeed(`Task updated: ${chalk.cyan(id)}`);
         if (options.json) {
             console.log(JSON.stringify(updated, null, 2));
@@ -485,6 +533,9 @@ taskCommand
         if (updated.metadata?.priority) {
             console.log('  Priority: ' + getPriorityColor(updated.metadata.priority)(updated.metadata.priority));
         }
+        if (updated.metadata?.readiness != null) {
+            console.log('  Readiness: ' + chalk.white(`${updated.metadata.readiness}%`));
+        }
     }
     catch (error) {
         console.error(chalk.red('Failed to update task:'), error.message);
@@ -503,18 +554,18 @@ taskCommand
     try {
         // Verify task exists first
         const spinner = ora('Loading task...').start();
-        const proposal = await getProposal(id);
+        const task = await getTask(id);
         spinner.stop();
-        if (!proposal) {
+        if (!task) {
             console.error(chalk.red(`Task '${id}' not found.`));
             process.exit(1);
         }
         // Confirm deletion
         if (!options.yes) {
             console.log('\n' + chalk.bold('Task to delete:'));
-            console.log('  ID:     ' + chalk.cyan(proposal.id));
-            console.log('  Title:  ' + chalk.white(proposal.title || proposal.intent));
-            console.log('  Status: ' + getStatusColor(proposal.status)(proposal.status));
+            console.log('  ID:     ' + chalk.cyan(task.id));
+            console.log('  Title:  ' + chalk.white(task.title || task.intent));
+            console.log('  Status: ' + getStatusColor(task.status)(task.status));
             console.log();
             const { confirm } = await inquirer.prompt([
                 {
@@ -530,7 +581,7 @@ taskCommand
             }
         }
         const deleteSpinner = ora('Deleting task...').start();
-        const deleted = await deleteProposal(id);
+        const deleted = await deleteTask(id);
         if (deleted) {
             deleteSpinner.succeed(`Task deleted: ${chalk.cyan(id)}`);
         }
@@ -552,14 +603,14 @@ taskCommand
     .description('Add a plan step to a task')
     .argument('<id>', 'Task ID to add step to')
     .argument('<description>', 'Description of the step')
-    .option('-s, --status <status>', 'Initial status (pending/in-progress/completed/failed)', 'pending')
+    .option('-s, --status <status>', 'Initial status (pending/active/done/failed/skipped)', 'pending')
     .option('-c, --command <cmd>', 'Command to execute for this step')
     .option('-e, --expected <outcome>', 'Expected outcome of this step')
     .option('--json', 'Output as JSON')
     .action(async (id, description, options) => {
     try {
         const spinner = ora('Adding plan step...').start();
-        const validStepStatuses = ['pending', 'in-progress', 'completed', 'failed'];
+        const validStepStatuses = ['pending', 'active', 'done', 'failed', 'skipped'];
         const status = options.status?.toLowerCase();
         if (status && !validStepStatuses.includes(status)) {
             spinner.fail(`Invalid step status: ${options.status}`);
@@ -588,8 +639,9 @@ taskCommand
             console.log('  Expected:    ' + chalk.gray(step.expectedOutcome));
         }
         console.log('\n' + chalk.cyan('Next steps:'));
-        console.log('  • View task:    ' + chalk.yellow(`nut task get ${id}`));
-        console.log('  • Add more:     ' + chalk.yellow(`nut task step ${id} "Next step"`));
+        console.log('  • View task:      ' + chalk.yellow(`nut task get ${id}`));
+        console.log('  • Add more:       ' + chalk.yellow(`nut task step ${id} "Next step"`));
+        console.log('  • Update status:  ' + chalk.yellow(`nut task step-update ${id} ${step.id} --status <status>`));
     }
     catch (error) {
         console.error(chalk.red('Failed to add plan step:'), error.message);
@@ -597,6 +649,81 @@ taskCommand
     }
 });
 // ============================================================================
+// task step-update (update existing plan step)
+// ============================================================================
+taskCommand
+    .command('step-update')
+    .description('Update an existing plan step on a task')
+    .argument('<id>', 'Task ID containing the step')
+    .argument('<stepId>', 'Step ID to update (e.g. step-01)')
+    .option('-s, --status <status>', 'New status (pending/active/done/failed/skipped)')
+    .option('-d, --description <desc>', 'Update description')
+    .option('-c, --command <cmd>', 'Update command')
+    .option('-e, --expected <outcome>', 'Update expected outcome')
+    .option('--output <output>', 'Set output')
+    .option('--error <error>', 'Set error message')
+    .option('--json', 'Output as JSON')
+    .action(async (id, stepId, options) => {
+    try {
+        const spinner = ora('Updating plan step...').start();
+        const validStepStatuses = ['pending', 'active', 'done', 'failed', 'skipped'];
+        if (options.status) {
+            const status = options.status.toLowerCase();
+            if (!validStepStatuses.includes(status)) {
+                spinner.fail(`Invalid step status: ${options.status}`);
+                console.log(chalk.gray(`Valid statuses: ${validStepStatuses.join(', ')}`));
+                process.exit(1);
+            }
+        }
+        const updates = {};
+        if (options.status)
+            updates.status = options.status.toLowerCase();
+        if (options.description)
+            updates.description = options.description;
+        if (options.command)
+            updates.command = options.command;
+        if (options.expected)
+            updates.expectedOutcome = options.expected;
+        if (options.output)
+            updates.output = options.output;
+        if (options.error)
+            updates.error = options.error;
+        if (Object.keys(updates).length === 0) {
+            spinner.fail('No updates provided');
+            console.log(chalk.gray('Use --status, --description, --command, --expected, --output, or --error'));
+            process.exit(1);
+        }
+        const step = await updatePlanStep(id, stepId, updates);
+        spinner.succeed(`Plan step updated: ${chalk.cyan(step.id)}`);
+        if (options.json) {
+            console.log(JSON.stringify(step, null, 2));
+            return;
+        }
+        console.log('\n' + chalk.bold('Step Details:'));
+        console.log('  ID:          ' + chalk.cyan(step.id));
+        console.log('  Description: ' + chalk.white(step.description));
+        console.log('  Status:      ' + getStepStatusIcon(step.status) + ' ' + step.status);
+        if (step.command) {
+            console.log('  Command:     ' + chalk.gray(step.command));
+        }
+        if (step.expectedOutcome) {
+            console.log('  Expected:    ' + chalk.gray(step.expectedOutcome));
+        }
+        if (step.output) {
+            console.log('  Output:      ' + chalk.gray(step.output));
+        }
+        if (step.error) {
+            console.log('  Error:       ' + chalk.red(step.error));
+        }
+        console.log('\n' + chalk.cyan('Next steps:'));
+        console.log('  • View task:    ' + chalk.yellow(`nut task get ${id}`));
+    }
+    catch (error) {
+        console.error(chalk.red('Failed to update plan step:'), error.message);
+        process.exit(1);
+    }
+});
+// ============================================================================
 // task comment (add comment)
 // ============================================================================
 taskCommand