jettypod 4.4.19 → 4.4.22

package/jettypod.js

@@ -166,7 +166,7 @@ const claude = {
     let currentWork = null;
     let currentWorkSection = '';
     try {
-      const workTracking = require('./features/work-tracking/index.js');
+      const workTracking = require('./lib/work-tracking/index.js');
       currentWork = await workTracking.getCurrentWork();
 
       if (currentWork) {
@@ -674,7 +674,7 @@ async function generateClaude(options = {}) {
 
 // Initialize project (used by both 'jettypod init' and 'jettypod' with no args)
 async function initializeProject() {
-  const { showLogo } = require('./features/terminal-logo');
+  const { showLogo } = require('./lib/terminal-logo');
   showLogo();
 
   if (!fs.existsSync('.jettypod')) {
@@ -740,7 +740,7 @@ async function initializeProject() {
   await generateClaude();
 
   // Install git hooks
-  const gitHooks = require('./features/git-hooks/index.js');
+  const gitHooks = require('./lib/git-hooks/index.js');
   gitHooks.installHooks();
 
   // Install Claude Code hooks
@@ -1082,7 +1082,7 @@ const [,, command, ...args] = process.argv;
 switch (command) {
   case 'update': {
     // Update jettypod to latest version
-    const updateCommand = require('./features/update-command');
+    const updateCommand = require('./lib/update-command');
     const success = await updateCommand.runUpdate();
 
     // Always refresh skills in current project after update attempt
@@ -1189,7 +1189,7 @@ switch (command) {
     const subcommand = args[0];
 
     if (subcommand === 'start') {
-      const workCommands = require('./features/work-commands/index.js');
+      const workCommands = require('./lib/work-commands/index.js');
       const id = parseInt(args[1]);
       try {
         await workCommands.startWork(id);
@@ -1210,7 +1210,7 @@ switch (command) {
         process.exit(1);
       }
 
-      const workCommands = require('./features/work-commands/index.js');
+      const workCommands = require('./lib/work-commands/index.js');
 
       // Check if status was provided as argument: work stop <id> <status>
       const statusArg = args[1]; // args[0] is the id (optional), args[1] is status
@@ -1244,7 +1244,7 @@ switch (command) {
         });
       }
     } else if (subcommand === 'cleanup') {
-      const workCommands = require('./features/work-commands/index.js');
+      const workCommands = require('./lib/work-commands/index.js');
       const dryRun = args[0] === '--dry-run';
 
       try {
@@ -1264,7 +1264,7 @@ switch (command) {
         process.exit(1);
       }
     } else if (subcommand === 'merge') {
-      const workCommands = require('./features/work-commands/index.js');
+      const workCommands = require('./lib/work-commands/index.js');
       try {
         // Parse merge flags and optional work item ID from args
         const withTransition = args.includes('--with-transition');
@@ -1291,7 +1291,7 @@ switch (command) {
       }
 
       // Delegate to work tracking module
-      const workTracking = require('./features/work-tracking/index.js');
+      const workTracking = require('./lib/work-tracking/index.js');
       process.argv = ['node', 'work', ...args];
       workTracking.main();
     }
@@ -1299,7 +1299,7 @@ switch (command) {
 
   case 'backlog':
     // Backlog viewing - delegates to work tracking module
-    const workTracking = require('./features/work-tracking/index.js');
+    const workTracking = require('./lib/work-tracking/index.js');
     process.argv = ['node', 'work-tracking', 'backlog', ...args];
     workTracking.main();
     break;
@@ -1343,7 +1343,7 @@ switch (command) {
     break;
 
   case 'decisions': {
-    const decisions = require('./features/decisions');
+    const decisions = require('./lib/decisions');
 
     // Check for command-line flags
     const hasFlag = args.some(arg => arg.startsWith('--'));
@@ -1420,7 +1420,7 @@ switch (command) {
         }
 
         // Create Infrastructure Readiness epic with features and chores
-        const { create } = require('./features/work-tracking');
+        const { create } = require('./lib/work-tracking');
         const { readStandards } = require('./lib/production-standards-reader');
         const { generateInfrastructureChores } = require('./lib/production-chore-generator');
 

package/lib/decisions/index.js

@@ -0,0 +1,490 @@
+// Stable Mode: decisions command with error handling and edge cases
+const readline = require('readline');
+const { getDb } = require('../../lib/database');
+const config = require('../../lib/config');
+
+let db;
+try {
+  db = getDb();
+} catch (err) {
+  console.error('❌ Database initialization failed');
+  console.error(`Error: ${err.message}`);
+  console.log('');
+  console.log('This could mean:');
+  console.log('  - JettyPod is not initialized (run jettypod init)');
+  console.log('  - Database file is corrupted');
+  console.log('  - Insufficient permissions');
+  process.exit(1);
+}
+
+/**
+ * Show interactive decisions menu
+ */
+async function showDecisionsMenu() {
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('📋 DECISIONS');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('');
+  console.log('What would you like to see?');
+  console.log('');
+  console.log('  1. All decisions (chronological)');
+  console.log('  2. Project-level decisions (UX, tech stack)');
+  console.log('  3. Epic-level decisions (architecture, patterns)');
+  console.log('  4. Decisions for a specific epic');
+  console.log('  5. View DECISIONS.md');
+  console.log('');
+
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+
+    rl.question('Enter your choice (1-5): ', async (answer) => {
+      rl.close();
+
+      const trimmed = answer.trim();
+
+      // Handle empty input
+      if (!trimmed) {
+        console.log('');
+        console.log('❌ No choice entered');
+        console.log('Please run the command again and enter a number between 1-5');
+        console.log('');
+        process.exit(1);
+      }
+
+      const choice = parseInt(trimmed);
+
+      // Handle non-numeric input
+      if (isNaN(choice)) {
+        console.log('');
+        console.log(`❌ Invalid input: "${trimmed}"`);
+        console.log('Please enter a number between 1-5');
+        console.log('');
+        process.exit(1);
+      }
+
+      // Handle out of range
+      if (choice < 1 || choice > 5) {
+        console.log('');
+        console.log(`❌ Choice ${choice} is not valid`);
+        console.log('Please enter a number between 1-5:');
+        console.log('  1 = All decisions');
+        console.log('  2 = Project-level decisions');
+        console.log('  3 = Epic-level decisions');
+        console.log('  4 = Decisions for specific epic');
+        console.log('  5 = View DECISIONS.md');
+        console.log('');
+        process.exit(1);
+      }
+
+      try {
+        switch (choice) {
+          case 1:
+            await showAllDecisions();
+            break;
+          case 2:
+            showProjectDecisions();
+            break;
+          case 3:
+            await showEpicDecisions();
+            break;
+          case 4:
+            await promptForEpicId();
+            break;
+          case 5:
+            viewDecisionsFile();
+            break;
+        }
+        resolve();
+      } catch (err) {
+        console.error('');
+        console.error('❌ An error occurred while displaying decisions');
+        console.error(`Error: ${err.message}`);
+        console.error('');
+        reject(err);
+      }
+    });
+  });
+}
+
+/**
+ * Show all decisions chronologically
+ */
+async function showAllDecisions() {
+  console.log('');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('📋 ALL DECISIONS (Chronological)');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('');
+
+  // Show project decisions first
+  let projectConfig;
+  try {
+    projectConfig = config.read();
+  } catch (err) {
+    console.error('⚠️  Unable to read project configuration');
+    console.error(`Error: ${err.message}`);
+    console.log('');
+    console.log('Skipping project-level decisions...');
+    console.log('');
+  }
+
+  if (projectConfig && projectConfig.project_discovery && projectConfig.project_discovery.winner) {
+    console.log('🎯 PROJECT DECISIONS');
+    console.log('');
+    console.log(`Winner: ${projectConfig.project_discovery.winner}`);
+    if (projectConfig.project_discovery.rationale) {
+      console.log(`Rationale: ${projectConfig.project_discovery.rationale}`);
+    }
+    if (projectConfig.project_discovery.started_date) {
+      try {
+        console.log(`Decided: ${new Date(projectConfig.project_discovery.started_date).toLocaleDateString()}`);
+      } catch (err) {
+        console.log(`Decided: ${projectConfig.project_discovery.started_date}`);
+      }
+    }
+    console.log('');
+  }
+
+  // Show epic decisions
+  return new Promise((resolve, reject) => {
+    db.all(`
+      SELECT dd.*, w.title as epic_title
+      FROM discovery_decisions dd
+      JOIN work_items w ON dd.work_item_id = w.id
+      ORDER BY dd.created_at ASC
+    `, [], (err, rows) => {
+      if (err) {
+        console.error('❌ Database error while retrieving epic decisions');
+        console.error(`Error: ${err.message}`);
+        console.log('');
+        console.log('This could mean:');
+        console.log('  - Database schema is out of date (run migrations)');
+        console.log('  - Database is corrupted');
+        console.log('  - Table discovery_decisions or work_items does not exist');
+        console.log('');
+        return reject(err);
+      }
+
+      if (rows && rows.length > 0) {
+        console.log('🎯 EPIC DECISIONS');
+        console.log('');
+
+        rows.forEach(row => {
+          console.log(`Epic #${row.work_item_id}: ${row.epic_title}`);
+          console.log(`├─ ${row.aspect}: ${row.decision}`);
+          console.log(`├─ Rationale: ${row.rationale || 'No rationale provided'}`);
+          try {
+            console.log(`└─ Decided: ${new Date(row.created_at).toLocaleDateString()}`);
+          } catch (err) {
+            console.log(`└─ Decided: ${row.created_at}`);
+          }
+          console.log('');
+        });
+      } else {
+        console.log('No epic decisions yet.');
+        console.log('');
+        console.log('💡 Tip: Make architectural decisions during epic planning:');
+        console.log('   jettypod work epic-planning <epic-id>');
+        console.log('');
+      }
+
+      resolve();
+    });
+  });
+}
+
+/**
+ * Show project-level decisions
+ */
+function showProjectDecisions() {
+  console.log('');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('📋 PROJECT-LEVEL DECISIONS');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('');
+
+  let projectConfig;
+  try {
+    projectConfig = config.read();
+  } catch (err) {
+    console.error('❌ Unable to read project configuration');
+    console.error(`Error: ${err.message}`);
+    console.log('');
+    console.log('This could mean:');
+    console.log('  - .jettypod/config.json is missing or corrupted');
+    console.log('  - JettyPod is not initialized (run jettypod init)');
+    console.log('  - Insufficient permissions to read config file');
+    console.log('');
+    return;
+  }
+
+  if (projectConfig && projectConfig.project_discovery && projectConfig.project_discovery.winner) {
+    console.log(`Winner: ${projectConfig.project_discovery.winner}`);
+    if (projectConfig.project_discovery.rationale) {
+      console.log(`Rationale: ${projectConfig.project_discovery.rationale}`);
+    }
+    if (projectConfig.project_discovery.started_date) {
+      try {
+        console.log(`Decided: ${new Date(projectConfig.project_discovery.started_date).toLocaleDateString()}`);
+      } catch (err) {
+        console.log(`Decided: ${projectConfig.project_discovery.started_date}`);
+      }
+    }
+  } else {
+    console.log('No project-level decisions yet.');
+    console.log('');
+    console.log('💡 Tip: Start project discovery to make UX and tech stack decisions:');
+    console.log('   Talk to Claude Code about what you want to build');
+    console.log('');
+  }
+
+  console.log('');
+}
+
+/**
+ * Show epic-level decisions
+ */
+async function showEpicDecisions() {
+  console.log('');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('📋 EPIC-LEVEL DECISIONS');
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('');
+
+  return new Promise((resolve, reject) => {
+    db.all(`
+      SELECT dd.*, w.title as epic_title
+      FROM discovery_decisions dd
+      JOIN work_items w ON dd.work_item_id = w.id
+      ORDER BY dd.created_at DESC
+    `, [], (err, rows) => {
+      if (err) {
+        console.error('❌ Database error while retrieving epic decisions');
+        console.error(`Error: ${err.message}`);
+        console.log('');
+        console.log('This could mean:');
+        console.log('  - Database schema is out of date (run migrations)');
+        console.log('  - Database is corrupted');
+        console.log('  - Table discovery_decisions or work_items does not exist');
+        console.log('');
+        return reject(err);
+      }
+
+      if (rows && rows.length > 0) {
+        rows.forEach(row => {
+          console.log(`Epic #${row.work_item_id}: ${row.epic_title}`);
+          console.log(`├─ ${row.aspect}: ${row.decision}`);
+          console.log(`├─ Rationale: ${row.rationale || 'No rationale provided'}`);
+          try {
+            console.log(`└─ Decided: ${new Date(row.created_at).toLocaleDateString()}`);
+          } catch (err) {
+            console.log(`└─ Decided: ${row.created_at}`);
+          }
+          console.log('');
+        });
+      } else {
+        console.log('No epic decisions yet.');
+        console.log('');
+        console.log('💡 Tip: Make architectural decisions during epic planning:');
+        console.log('   jettypod work epic-planning <epic-id>');
+        console.log('');
+      }
+
+      resolve();
+    });
+  });
+}
+
+/**
+ * Prompt for epic ID and show its decisions
+ */
+async function promptForEpicId() {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+
+    rl.question('Which epic? (enter ID): ', async (answer) => {
+      rl.close();
+
+      const trimmed = answer.trim();
+
+      // Handle empty input
+      if (!trimmed) {
+        console.log('');
+        console.log('❌ No epic ID entered');
+        console.log('Please run the command again and enter an epic ID');
+        console.log('');
+        console.log('💡 Tip: See your epics with: jettypod backlog');
+        console.log('');
+        process.exit(1);
+      }
+
+      const epicId = parseInt(trimmed);
+
+      // Handle non-numeric input
+      if (isNaN(epicId)) {
+        console.log('');
+        console.log(`❌ Invalid epic ID: "${trimmed}"`);
+        console.log('Please enter a numeric epic ID');
+        console.log('');
+        console.log('💡 Tip: See your epics with: jettypod backlog');
+        console.log('');
+        process.exit(1);
+      }
+
+      // Handle negative/zero IDs
+      if (epicId <= 0) {
+        console.log('');
+        console.log(`❌ Invalid epic ID: ${epicId}`);
+        console.log('Epic IDs must be positive numbers');
+        console.log('');
+        process.exit(1);
+      }
+
+      try {
+        await showDecisionsForEpic(epicId);
+        resolve();
+      } catch (err) {
+        console.error('');
+        console.error('❌ An error occurred while displaying decisions');
+        console.error(`Error: ${err.message}`);
+        console.error('');
+        process.exit(1);
+      }
+    });
+  });
+}
+
+/**
+ * Show decisions for a specific epic
+ */
+async function showDecisionsForEpic(epicId) {
+  return new Promise((resolve, reject) => {
+    // First get the epic title
+    db.get('SELECT title FROM work_items WHERE id = ? AND type = ?', [epicId, 'epic'], (err, epic) => {
+      if (err) {
+        console.error('❌ Database error while looking up epic');
+        console.error(`Error: ${err.message}`);
+        console.log('');
+        console.log('This could mean:');
+        console.log('  - Database is corrupted');
+        console.log('  - Table work_items does not exist');
+        console.log('');
+        return reject(err);
+      }
+
+      if (!epic) {
+        console.log('');
+        console.log(`❌ Epic #${epicId} not found`);
+        console.log('');
+        console.log('This could mean:');
+        console.log(`  - Epic #${epicId} does not exist`);
+        console.log(`  - Work item #${epicId} is not an epic`);
+        console.log('');
+        console.log('💡 Tip: See your epics with: jettypod backlog');
+        console.log('');
+        return resolve();
+      }
+
+      console.log('');
+      console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+      console.log(`📋 DECISIONS FOR EPIC #${epicId}`);
+      console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+      console.log('');
+      console.log(`Epic: ${epic.title}`);
+      console.log('');
+
+      db.all('SELECT * FROM discovery_decisions WHERE work_item_id = ? ORDER BY created_at DESC', [epicId], (err, rows) => {
+        if (err) {
+          console.error('❌ Database error while retrieving decisions');
+          console.error(`Error: ${err.message}`);
+          console.log('');
+          console.log('This could mean:');
+          console.log('  - Database is corrupted');
+          console.log('  - Table discovery_decisions does not exist');
+          console.log('');
+          return reject(err);
+        }
+
+        if (rows && rows.length > 0) {
+          rows.forEach(row => {
+            console.log(`${row.aspect}: ${row.decision}`);
+            console.log(`├─ Rationale: ${row.rationale || 'No rationale provided'}`);
+            try {
+              console.log(`└─ Decided: ${new Date(row.created_at).toLocaleDateString()}`);
+            } catch (err) {
+              console.log(`└─ Decided: ${row.created_at}`);
+            }
+            console.log('');
+          });
+        } else {
+          console.log('No decisions for this epic yet.');
+          console.log('');
+          console.log('💡 Tip: Make architectural decisions during epic planning:');
+          console.log(`   jettypod work epic-planning ${epicId}`);
+          console.log('');
+        }
+
+        resolve();
+      });
+    });
+  });
+}
+
+/**
+ * View DECISIONS.md file
+ */
+function viewDecisionsFile() {
+  const fs = require('fs');
+  const path = require('path');
+
+  const decisionsPath = path.join(process.cwd(), 'docs', 'DECISIONS.md');
+
+  try {
+    if (fs.existsSync(decisionsPath)) {
+      try {
+        const content = fs.readFileSync(decisionsPath, 'utf8');
+        console.log('');
+        console.log(content);
+      } catch (readErr) {
+        console.error('❌ Unable to read DECISIONS.md');
+        console.error(`Error: ${readErr.message}`);
+        console.log('');
+        console.log('This could mean:');
+        console.log('  - File is corrupted');
+        console.log('  - Insufficient permissions to read file');
+        console.log('  - File is locked by another process');
+        console.log('');
+      }
+    } else {
+      console.log('');
+      console.log('docs/DECISIONS.md not found.');
+      console.log('');
+      console.log('💡 This file will be created automatically when:');
+      console.log('   - You complete project discovery');
+      console.log('   - You make epic architectural decisions');
+      console.log('');
+      console.log('To make decisions:');
+      console.log('   jettypod work epic-planning <epic-id>');
+      console.log('');
+    }
+  } catch (err) {
+    console.error('❌ Error checking for DECISIONS.md');
+    console.error(`Error: ${err.message}`);
+    console.log('');
+  }
+}
+
+module.exports = {
+  showDecisionsMenu,
+  showAllDecisions,
+  showProjectDecisions,
+  showEpicDecisions,
+  showDecisionsForEpic,
+  viewDecisionsFile
+};

package/lib/git-hooks/git-hooks.feature

@@ -0,0 +1,30 @@
+Feature: Git Hook Integration
+  As a developer
+  I want work item status to update automatically on git operations
+  So that I don't have to manually track progress
+
+  Scenario: First commit updates status to in_progress
+    Given I have a work item with status "todo"
+    And the work item is set as current work
+    When I make my first commit
+    Then the work item status should be "in_progress"
+
+  Scenario: Merge to main updates status to done
+    Given I have a work item with status "in_progress"
+    And the work item is set as current work
+    And I am on a feature branch
+    When I merge to main
+    Then the work item status should be "done"
+
+  Scenario: No current work item - hooks do nothing
+    Given no work item is set as current
+    When I make a commit
+    Then no errors occur
+
+  Scenario: Integration - hooks work with existing work commands
+    Given I have initialized jettypod with git
+    And I create a work item via work commands
+    And I start work on the item
+    When I commit changes
+    Then the work item status updates automatically
+    And the current work file still exists