jettypod 3.0.2 → 4.0.0

package/features/work-tracking/index.js

@@ -142,7 +142,7 @@ function getTree(includeCompleted = false) {
 
         resolve(rootItems);
       } catch (err) {
-        reject(new Error(`Failed to build work tree: ${err.message}`));
+        reject(new Error(`Failed to build backlog: ${err.message}`));
       }
     });
   });
@@ -499,7 +499,7 @@ function showItem(id) {
                 console.log(`\n⚠️  DISCOVERY REQUIRED: This epic needs architectural decisions`);
                 console.log(``);
                 console.log(`   💬 Talk to Claude Code: "Let's do epic discovery for #${row.id}"`);
-                console.log(`   Or run: jettypod work epic-discover ${row.id}`);
+                console.log(`   Or run: jettypod work epic-planning ${row.id}`);
                 console.log(``);
                 console.log(`   Claude Code will guide you through:`);
                 console.log(`   • Suggesting 3 architectural options`);
@@ -611,7 +611,7 @@ async function main() {
           console.log('  • Identify architectural decisions (if needed)');
           console.log('  • Create features automatically');
           console.log('');
-          console.log('Or run: jettypod work epic-discover ' + newId);
+          console.log('Or run: jettypod work epic-planning ' + newId);
           console.log('');
           console.log('💡 You can also plan later when ready');
         }
@@ -630,7 +630,7 @@ async function main() {
                   console.log('Ask Claude Code:');
                   console.log(`  "Help me plan epic #${parentId}"`);
                   console.log('');
-                  console.log(`Or run: jettypod work epic-discover ${parentId}`);
+                  console.log(`Or run: jettypod work epic-planning ${parentId}`);
                 }
               });
             }
@@ -756,13 +756,176 @@ async function main() {
         console.log('Legend: ⊕ = collapsed  ⊖ = expanded');
         console.log('');
         console.log('Commands:');
-        console.log('  jettypod work tree --expand=1         Show details for item #1');
-        console.log('  jettypod work tree --expand=1,2,3     Show details for multiple items');
-        console.log('  jettypod work tree --expand-all       Show all details');
-        console.log('  jettypod work tree                    Collapse all (default)');
+        console.log('  jettypod backlog --expand=1           Show details for item #1');
+        console.log('  jettypod backlog --expand=1,2,3       Show details for multiple items');
+        console.log('  jettypod backlog --expand-all         Show all details');
+        console.log('  jettypod backlog                      Collapse all (default)');
         console.log('');
       } catch (err) {
-        console.error(`Error displaying work tree: ${err.message}`);
+        console.error(`Error displaying backlog: ${err.message}`);
+        process.exit(1);
+      }
+      break;
+    }
+
+    case 'backlog': {
+      try {
+        const filter = args[0]; // undefined, 'all', or 'completed'
+
+        // For 'all' and 'completed' filters, use old simple display
+        if (filter === 'all' || filter === 'completed') {
+          let items;
+          if (filter === 'all') {
+            items = await getTree(true);
+          } else {
+            items = await new Promise((resolve, reject) => {
+              db.all(`SELECT * FROM work_items WHERE status IN ('done', 'cancelled') ORDER BY parent_id, id`, [], (err, rows) => {
+                if (err) {
+                  return reject(new Error(`Failed to fetch completed items: ${err.message}`));
+                }
+
+                if (!rows || rows.length === 0) {
+                  return resolve([]);
+                }
+
+                const itemsById = {};
+                const rootItems = [];
+
+                rows.forEach(item => {
+                  itemsById[item.id] = item;
+                  item.children = [];
+                });
+
+                rows.forEach(item => {
+                  if (item.parent_id && itemsById[item.parent_id]) {
+                    itemsById[item.parent_id].children.push(item);
+                  } else if (!item.parent_id) {
+                    rootItems.push(item);
+                  }
+                });
+
+                resolve(rootItems);
+              });
+            });
+          }
+
+          if (items.length === 0) {
+            console.log('No items found.');
+          } else {
+            const expandedIds = new Set();
+            items.forEach(item => {
+              if (item.type === 'epic') {
+                expandedIds.add(item.id);
+              }
+            });
+            printTree(items, '', true, expandedIds);
+          }
+          console.log('');
+        } else {
+          // Default: show three-section view (active work, recently completed, backlog)
+          const currentWork = getCurrentWork();
+
+          // Show active work at top if exists
+          if (currentWork) {
+            const emoji = TYPE_EMOJIS[currentWork.type] || '📋';
+            console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            console.log('🎯  ACTIVE WORK');
+            console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            console.log(`${emoji} [#${currentWork.id}] ${currentWork.title}`);
+            if (currentWork.epic_title && currentWork.epic_id !== currentWork.id && currentWork.parent_id === currentWork.epic_id) {
+              console.log(`└─ Epic: 🎯 #${currentWork.epic_id} ${currentWork.epic_title}`);
+            } else if (currentWork.parent_title) {
+              const parentEmoji = TYPE_EMOJIS[currentWork.parent_type] || '📋';
+              console.log(`└─ Part of: ${parentEmoji} #${currentWork.parent_id} ${currentWork.parent_title}`);
+            } else if (currentWork.epic_title && currentWork.epic_id !== currentWork.id) {
+              console.log(`└─ Epic: 🎯 #${currentWork.epic_id} ${currentWork.epic_title}`);
+            }
+            console.log('');
+          }
+
+          // Show recently completed items
+          const recentlyCompleted = await new Promise((resolve, reject) => {
+            db.all(`
+              SELECT w.id, w.title, w.type, w.mode,
+                     p.title as parent_title, p.id as parent_id, p.type as parent_type
+              FROM work_items w
+              LEFT JOIN work_items p ON w.parent_id = p.id
+              WHERE w.status = 'done'
+              ORDER BY w.id DESC
+              LIMIT 3
+            `, [], async (err, rows) => {
+              if (err) reject(err);
+              else {
+                // Add epic info to each item
+                for (const row of rows || []) {
+                  const epic = await findEpic(row.id);
+                  if (epic) {
+                    row.epic_id = epic.id;
+                    row.epic_title = epic.title;
+                  }
+                }
+                resolve(rows || []);
+              }
+            });
+          });
+
+          if (recentlyCompleted.length > 0) {
+            console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            console.log('✅  RECENTLY COMPLETED');
+            console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+            recentlyCompleted.forEach(item => {
+              const emoji = TYPE_EMOJIS[item.type] || '📋';
+              let modeIndicator = '';
+              if (item.type === 'feature') {
+                if (item.phase === 'discovery') {
+                  modeIndicator = ' [🔍 discovery]';
+                } else if (item.mode) {
+                  modeIndicator = ` [${item.mode}]`;
+                }
+              } else if (item.mode) {
+                modeIndicator = ` [${item.mode}]`;
+              }
+              console.log(`${emoji} [${item.id}] ${item.title}${modeIndicator}`);
+              if (item.epic_title && item.epic_id !== item.id && item.parent_id === item.epic_id) {
+                console.log(`   └─ Epic: 🎯 #${item.epic_id} ${item.epic_title}`);
+              } else if (item.parent_title) {
+                const parentEmoji = TYPE_EMOJIS[item.parent_type] || '📋';
+                console.log(`   └─ Part of: ${parentEmoji} #${item.parent_id} ${item.parent_title}`);
+              } else if (item.epic_title && item.epic_id !== item.id) {
+                console.log(`   └─ Epic: 🎯 #${item.epic_id} ${item.epic_title}`);
+              }
+            });
+            console.log('');
+          }
+
+          console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+          console.log('📋  BACKLOG');
+          console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+          const items = await getTree(false);
+
+          // Default: auto-expand all epics
+          const expandedIds = new Set();
+          items.forEach(item => {
+            if (item.type === 'epic') {
+              expandedIds.add(item.id);
+            }
+          });
+
+          printTree(items, '', true, expandedIds);
+
+          // Show legend and commands
+          console.log('');
+          console.log('Legend: ⊕ = collapsed  ⊖ = expanded');
+          console.log('');
+          console.log('Commands:');
+          console.log('  jettypod backlog --expand=1           Show details for item #1');
+          console.log('  jettypod backlog --expand=1,2,3       Show details for multiple items');
+          console.log('  jettypod backlog --expand-all         Show all details');
+          console.log('  jettypod backlog                      Collapse all (default)');
+          console.log('');
+        }
+      } catch (err) {
+        console.error(`Error displaying backlog: ${err.message}`);
         process.exit(1);
       }
       break;
@@ -809,7 +972,7 @@ async function main() {
         console.log('Example:');
         console.log('  jettypod work show 5');
         console.log('');
-        console.log('💡 Tip: Use `jettypod work tree` to see all work items');
+        console.log('💡 Tip: Use `jettypod backlog` to see all work items');
         process.exit(1);
       }
 
@@ -967,12 +1130,12 @@ async function main() {
       break;
     }
 
-    case 'epic-discover': {
+    case 'epic-planning': {
       const epicId = parseInt(args[0]);
 
       if (!epicId || isNaN(epicId)) {
         console.error('Error: Epic ID is required');
-        console.log('Usage: jettypod work epic-discover <epic-id>');
+        console.log('Usage: jettypod work epic-planning <epic-id>');
         process.exit(1);
       }
 
@@ -1038,13 +1201,13 @@ async function main() {
             console.log('💬 Now ask Claude Code:');
             console.log(`   "Help me with epic discovery for #${epicId}"`);
             console.log('');
-            console.log('Claude will use the epic-discover skill to guide you through:');
+            console.log('Claude will use the epic-planning skill to guide you through:');
             console.log('  1. Feature brainstorming');
             console.log('  2. Architectural decisions (if needed)');
             console.log('  3. Prototype validation (optional)');
             console.log('  4. Feature creation');
             console.log('');
-            console.log('📋 The skill is at: .claude/skills/epic-discover/SKILL.md');
+            console.log('📋 The skill is at: .claude/skills/epic-planning/SKILL.md');
           }
         );
       });
@@ -1220,13 +1383,14 @@ async function main() {
 
       if (!featureId || isNaN(featureId)) {
         console.error('Error: Feature ID is required');
-        console.log('Usage: jettypod work implement <feature-id> [--prototypes="file1,file2"] [--winner="file.js"]');
+        console.log('Usage: jettypod work implement <feature-id> [--prototypes="file1,file2"] [--winner="file.js"] [--rationale="why this approach"]');
         process.exit(1);
       }
 
-      // Parse optional --prototypes and --winner flags
+      // Parse optional --prototypes, --winner, and --rationale flags
       const prototypesIndex = args.findIndex(a => a.startsWith('--prototypes='));
       const winnerIndex = args.findIndex(a => a.startsWith('--winner='));
+      const rationaleIndex = args.findIndex(a => a.startsWith('--rationale='));
 
       const prototypes = prototypesIndex !== -1
         ? args[prototypesIndex].split('=')[1].replace(/^["']|["']$/g, '').split(',').map(p => p.trim())
@@ -1234,6 +1398,9 @@ async function main() {
       const winner = winnerIndex !== -1
         ? args[winnerIndex].split('=')[1].replace(/^["']|["']$/g, '')
         : null;
+      const rationale = rationaleIndex !== -1
+        ? args[rationaleIndex].split('=')[1].replace(/^["']|["']$/g, '')
+        : null;
 
       db.get(`SELECT * FROM work_items WHERE id = ?`, [featureId], (err, feature) => {
         if (err) {
@@ -1254,21 +1421,14 @@ async function main() {
           process.exit(1);
         }
 
-        if (feature.phase !== 'discovery') {
-          console.error(`Error: Feature #${featureId} is not in discovery phase (current phase: ${feature.phase || 'implementation'})`);
-          console.log('');
-          console.log('Features can only be transitioned to implementation from discovery phase.');
-          process.exit(1);
-        }
-
-        // Validate that BDD scenarios exist before transitioning
+        // Validate that BDD scenarios exist
         if (!feature.scenario_file) {
           console.error(`Error: Feature #${featureId} has no BDD scenarios`);
           console.log('');
           console.log('Discovery is not complete without BDD scenarios.');
           console.log('');
           console.log('To complete discovery:');
-          console.log('  1. Generate scenarios using feature-discover skill');
+          console.log('  1. Generate scenarios using feature-planning skill');
           console.log('  2. Or manually create scenarios at features/[feature-name].feature');
           console.log('  3. Then run: jettypod work implement');
           console.log('');
@@ -1294,13 +1454,30 @@ async function main() {
           process.exit(1);
         }
 
-        // Transition to implementation phase, set mode to speed
+        // Determine if this is a transition or an update
+        const isTransition = feature.phase === 'discovery';
+        const isUpdate = feature.phase === 'implementation';
+
+        if (!isTransition && !isUpdate) {
+          console.error(`Error: Feature #${featureId} has invalid phase: ${feature.phase}`);
+          console.log('');
+          console.log('Expected phase to be either "discovery" or "implementation"');
+          process.exit(1);
+        }
+
+        // Prepare values
         const prototypeFilesValue = prototypes.length > 0 ? JSON.stringify(prototypes) : null;
         const winnerValue = winner || null;
+        const rationaleValue = rationale || null;
+
+        // Update query: if transitioning, set phase and mode; if updating, just update decision fields
+        const updateSql = isTransition
+          ? `UPDATE work_items SET phase = 'implementation', mode = 'speed', prototype_files = ?, discovery_winner = ?, discovery_rationale = ? WHERE id = ?`
+          : `UPDATE work_items SET prototype_files = ?, discovery_winner = ?, discovery_rationale = ? WHERE id = ?`;
 
         db.run(
-          `UPDATE work_items SET phase = 'implementation', mode = 'speed', prototype_files = ?, discovery_winner = ? WHERE id = ?`,
-          [prototypeFilesValue, winnerValue, featureId],
+          updateSql,
+          [prototypeFilesValue, winnerValue, rationaleValue, featureId],
           (err) => {
             if (err) {
               console.error(`Error: ${err.message}`);
@@ -1309,7 +1486,11 @@ async function main() {
 
             console.log('');
             console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
-            console.log(`✅ Feature #${featureId} transitioned to Implementation Phase`);
+            if (isTransition) {
+              console.log(`✅ Feature #${featureId} transitioned to Implementation Phase`);
+            } else {
+              console.log(`✅ Feature #${featureId} discovery decision updated`);
+            }
             console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
             console.log('');
             console.log(`Title: ${feature.title}`);
@@ -1321,6 +1502,9 @@ async function main() {
             if (winner) {
               console.log(`Winner: ${winner}`);
             }
+            if (rationale) {
+              console.log(`Rationale: ${rationale}`);
+            }
             console.log('');
             console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
             console.log('🚀 Speed Mode: Prove It Works');
@@ -1414,14 +1598,14 @@ async function main() {
                 console.log('💬 Now ask Claude Code:');
                 console.log(`   "Help me with feature discovery for #${featureId}"`);
                 console.log('');
-                console.log('Claude will use the feature-discover skill to guide you through:');
+                console.log('Claude will use the feature-planning skill to guide you through:');
                 console.log('  1. Suggesting 3 UX approaches');
                 console.log('  2. Optional prototyping');
                 console.log('  3. Choosing the winner');
                 console.log('  4. Generating BDD scenarios');
                 console.log('  5. Transitioning to implementation');
                 console.log('');
-                console.log('📋 The skill is at: .claude/skills/feature-discover/SKILL.md');
+                console.log('📋 The skill is at: .claude/skills/feature-planning/SKILL.md');
               }
             );
           } else {
@@ -1439,14 +1623,14 @@ async function main() {
             console.log('💬 Now ask Claude Code:');
             console.log(`   "Help me with feature discovery for #${featureId}"`);
             console.log('');
-            console.log('Claude will use the feature-discover skill to guide you through:');
+            console.log('Claude will use the feature-planning skill to guide you through:');
             console.log('  1. Suggesting 3 UX approaches');
             console.log('  2. Optional prototyping');
             console.log('  3. Choosing the winner');
             console.log('  4. Generating BDD scenarios');
             console.log('  5. Transitioning to implementation');
             console.log('');
-            console.log('📋 The skill is at: .claude/skills/feature-discover/SKILL.md');
+            console.log('📋 The skill is at: .claude/skills/feature-planning/SKILL.md');
           }
         });
       });
@@ -1461,11 +1645,9 @@ Commands:
   jettypod work create <type> <title> [desc] [--parent=ID]
     Types: epic, feature, bug, chore
 
-  jettypod work tree
-    Show hierarchical view (active items only)
-
-  jettypod work completed
-    Show all completed work items
+  jettypod backlog [filter]
+    Show work items (active by default)
+    Filters: all, completed
 
   jettypod work show <id>
     Show work item details

package/features/work-tracking/mode-required.feature

@@ -82,7 +82,7 @@ Feature: Mode defaults to discovery on work item creation
     And I create a feature "Speed Feature" with mode "speed" and parent epic
     And I create a bug "Stable Bug" with mode "stable" and parent epic
     And I create a chore "Test Chore" without mode and parent epic
-    When I view the work tree
+    When I view the backlog
     Then I see the epic without mode indicator
     And I see the feature with mode "speed"
     And I see the bug with mode "stable"

package/jettypod.js

@@ -138,7 +138,7 @@ Status: ${currentWork.status}
 Use JettyPod commands to track work:
 - jettypod work create <type> <title> [desc] [--parent=ID]
 - jettypod work start <id>
-- jettypod work tree
+- jettypod backlog
 - jettypod decisions (view architectural and technical decisions)
 
 EPIC DISCOVERY DETECTION:
@@ -194,7 +194,7 @@ CONFIRMATION REQUIRED BEFORE TRANSITION:
 When user expresses intent to: prepare for production, launch to customers, accept external users, go live, deploy publicly, make it production-ready, or similar - you MUST:
 
 1. **STOP - First, check what will be created**:
-   - Run \`jettypod work tree\` to count stable mode features
+   - Run \`jettypod backlog\` to count stable mode features
    - Each stable feature will get 3 production chores (Security, Scale, Compliance)
 
 2. **Ask for confirmation with specific impact**:
@@ -476,7 +476,7 @@ This splits your terminal so you can see both at once:
   │  terminal  │  terminal  │
   └────────────┴────────────┘
 
-In the right terminal, type \`jettypod work tree\` and press Enter - you'll see a visual tree of all your work."
+In the right terminal, type \`jettypod backlog\` and press Enter - you'll see a visual tree of all your work."
 
 **CRITICAL: After creating all epics, save checkpoint by running:**
 try {
@@ -577,8 +577,8 @@ I'll help you:
 
 **Which epic should we start with?**"
 
-**CRITICAL: After user picks an epic, immediately invoke the epic-discover skill:**
-Use the Skill tool to invoke: epic-discover
+**CRITICAL: After user picks an epic, immediately invoke the epic-planning skill:**
+Use the Skill tool to invoke: epic-planning
 
 This ensures consistent epic planning workflow. DO NOT manually guide them - let the skill handle it.
 
@@ -1053,6 +1053,13 @@ switch (command) {
     }
     break;
 
+  case 'backlog':
+    // Backlog viewing - delegates to work tracking module
+    const workTracking = require('./features/work-tracking/index.js');
+    process.argv = ['node', 'work-tracking', 'backlog', ...args];
+    workTracking.main();
+    break;
+
   case 'docs':
     const docsSubcommand = args[0];
 
@@ -1340,7 +1347,7 @@ switch (command) {
         }
 
         console.log(`✅ Created ${choresCreated} chores for external readiness`);
-        console.log(`\nRun 'jettypod work tree' to see all items`);
+        console.log(`\nRun 'jettypod backlog' to see all items`);
         console.log(`Run 'jettypod work start <id>' to begin work`);
 
       } catch (err) {
@@ -1508,7 +1515,7 @@ switch (command) {
           console.log('  jettypod work create epic "Your First Epic" "Description"');
           console.log('');
           console.log('Then plan the features for that epic:');
-          console.log('  jettypod work epic-discover <epic-id>');
+          console.log('  jettypod work epic-planning <epic-id>');
           console.log('');
           console.log('💡 Tip: Claude Code will help you brainstorm features for each epic');
 
@@ -1576,7 +1583,7 @@ CLAUDE.md has been generated with your current project context.
 Open Claude Code to start working.
 
 Quick commands:
-  jettypod work tree       Show all work items
+  jettypod backlog       Show all work items
   jettypod project info    Show project status
 `);
       }

package/lib/migrations/009-discovery-rationale-field.js

@@ -0,0 +1,24 @@
+// Migration: Add discovery_rationale field for feature discovery decisions
+// Created: 2025-01-06
+// Purpose: Track rationale for UX approach chosen during feature discovery
+// Related: Feature-discover skill - records why an approach was selected
+
+module.exports = {
+  id: '009-discovery-rationale-field',
+  description: 'Add discovery_rationale field for feature discovery decisions',
+
+  up: (db) => {
+    return new Promise((resolve, reject) => {
+      db.run(
+        `ALTER TABLE work_items ADD COLUMN discovery_rationale TEXT`,
+        (err) => {
+          if (err && !err.message.includes('duplicate column')) {
+            return reject(err);
+          }
+          console.log('Added discovery_rationale column to work_items');
+          resolve();
+        }
+      );
+    });
+  }
+};