agileflow 2.76.0 → 2.78.0

package/tools/cli/commands/start.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+
+/**
+ * AgileFlow TUI Dashboard
+ *
+ * BETA - Internal use only, not publicly documented
+ *
+ * Usage: npx agileflow start
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+// ANSI color codes
+const colors = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m',
+  orange: '\x1b[38;2;232;104;58m',
+  bgYellow: '\x1b[43m',
+  bgRed: '\x1b[41m',
+};
+
+function showBetaWarning() {
+  console.log('');
+  console.log(`${colors.bgYellow}${colors.bold}  BETA  ${colors.reset} ${colors.yellow}This feature is in beta and not yet stable${colors.reset}`);
+  console.log(`${colors.dim}        Expect bugs and incomplete features${colors.reset}`);
+  console.log('');
+}
+
+function showHeader() {
+  console.log(`${colors.orange}${colors.bold}`);
+  console.log('  ╔═══════════════════════════════════════════╗');
+  console.log('  ║         AgileFlow TUI Dashboard           ║');
+  console.log('  ╚═══════════════════════════════════════════╝');
+  console.log(`${colors.reset}`);
+}
+
+async function loadStatus() {
+  const statusPath = path.join(process.cwd(), 'docs', '09-agents', 'status.json');
+
+  if (!fs.existsSync(statusPath)) {
+    return null;
+  }
+
+  try {
+    const content = fs.readFileSync(statusPath, 'utf8');
+    return JSON.parse(content);
+  } catch (err) {
+    return null;
+  }
+}
+
+function getStatusColor(status) {
+  switch (status) {
+    case 'completed':
+    case 'done':
+      return colors.green;
+    case 'in_progress':
+    case 'in-progress':
+      return colors.yellow;
+    case 'blocked':
+      return colors.red;
+    case 'ready':
+      return colors.cyan;
+    default:
+      return colors.dim;
+  }
+}
+
+function formatStory(story) {
+  const statusColor = getStatusColor(story.status);
+  const id = story.id || story.story_id || 'Unknown';
+  const title = story.title || story.summary || 'Untitled';
+  const status = (story.status || 'unknown').toUpperCase();
+  const owner = story.owner || '-';
+
+  return `  ${colors.bold}${id}${colors.reset} ${title.substring(0, 40)}${title.length > 40 ? '...' : ''}
+           ${statusColor}[${status}]${colors.reset} ${colors.dim}Owner: ${owner}${colors.reset}`;
+}
+
+async function showDashboard() {
+  showBetaWarning();
+  showHeader();
+
+  const status = await loadStatus();
+
+  if (!status) {
+    console.log(`${colors.dim}  No status.json found. Run /agileflow:story to create stories.${colors.reset}`);
+    console.log('');
+    return;
+  }
+
+  // Count stories by status
+  const stories = Object.values(status).filter(s => s && typeof s === 'object' && (s.id || s.story_id));
+  const counts = {
+    in_progress: stories.filter(s => ['in_progress', 'in-progress'].includes(s.status)).length,
+    blocked: stories.filter(s => s.status === 'blocked').length,
+    ready: stories.filter(s => s.status === 'ready').length,
+    completed: stories.filter(s => ['completed', 'done'].includes(s.status)).length,
+  };
+
+  const total = stories.length;
+  const completionPct = total > 0 ? Math.round((counts.completed / total) * 100) : 0;
+
+  // Summary
+  console.log(`${colors.bold}  Summary${colors.reset}`);
+  console.log(`  ────────────────────────────────────────────`);
+  console.log(`  ${colors.yellow}In Progress:${colors.reset} ${counts.in_progress}   ${colors.red}Blocked:${colors.reset} ${counts.blocked}   ${colors.cyan}Ready:${colors.reset} ${counts.ready}   ${colors.green}Done:${colors.reset} ${counts.completed}`);
+  console.log(`  ${colors.dim}Completion: ${completionPct}%${colors.reset}`);
+  console.log('');
+
+  // In Progress Stories
+  const inProgressStories = stories.filter(s => ['in_progress', 'in-progress'].includes(s.status));
+  if (inProgressStories.length > 0) {
+    console.log(`${colors.bold}  ${colors.yellow}In Progress${colors.reset}`);
+    console.log(`  ────────────────────────────────────────────`);
+    inProgressStories.forEach(story => {
+      console.log(formatStory(story));
+    });
+    console.log('');
+  }
+
+  // Blocked Stories
+  const blockedStories = stories.filter(s => s.status === 'blocked');
+  if (blockedStories.length > 0) {
+    console.log(`${colors.bold}  ${colors.red}Blocked${colors.reset}`);
+    console.log(`  ────────────────────────────────────────────`);
+    blockedStories.forEach(story => {
+      console.log(formatStory(story));
+    });
+    console.log('');
+  }
+
+  // Ready Stories (up to 5)
+  const readyStories = stories.filter(s => s.status === 'ready').slice(0, 5);
+  if (readyStories.length > 0) {
+    console.log(`${colors.bold}  ${colors.cyan}Ready for Work${colors.reset} ${colors.dim}(showing ${readyStories.length} of ${counts.ready})${colors.reset}`);
+    console.log(`  ────────────────────────────────────────────`);
+    readyStories.forEach(story => {
+      console.log(formatStory(story));
+    });
+    console.log('');
+  }
+
+  console.log(`${colors.dim}  Use /agileflow:board for interactive kanban view${colors.reset}`);
+  console.log(`${colors.dim}  Use /agileflow:story:list for full story list${colors.reset}`);
+  console.log('');
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  // Check for help flag
+  if (args.includes('--help') || args.includes('-h')) {
+    showBetaWarning();
+    console.log(`${colors.bold}AgileFlow TUI Dashboard${colors.reset}`);
+    console.log('');
+    console.log(`${colors.bold}Usage:${colors.reset}`);
+    console.log('  npx agileflow start           Show dashboard');
+    console.log('  npx agileflow start --help    Show this help');
+    console.log('');
+    console.log(`${colors.dim}This is a beta feature. For stable commands, use Claude Code slash commands.${colors.reset}`);
+    return;
+  }
+
+  await showDashboard();
+}
+
+main().catch(err => {
+  console.error(`${colors.red}Error:${colors.reset}`, err.message);
+  process.exit(1);
+});
+
+module.exports = { main };

package/tools/cli/commands/uninstall.js

@@ -49,10 +49,7 @@ module.exports = {
 
         // Confirm removal
         if (!options.force) {
-          const proceed = await confirm(
-            `Remove ${formatIdeName(ideName)} configuration?`,
-            false
-          );
+          const proceed = await confirm(`Remove ${formatIdeName(ideName)} configuration?`, false);
           if (!proceed) {
             console.log(chalk.dim('\nCancelled\n'));
             process.exit(0);
@@ -91,7 +88,9 @@ module.exports = {
 
         console.log(chalk.green(`\n${formatIdeName(ideName)} has been removed.\n`));
         if (status.ides.length > 1) {
-          console.log(chalk.dim(`Remaining IDEs: ${status.ides.filter(i => i !== ideName).join(', ')}\n`));
+          console.log(
+            chalk.dim(`Remaining IDEs: ${status.ides.filter(i => i !== ideName).join(', ')}\n`)
+          );
         }
 
         process.exit(0);

package/tools/cli/commands/update.js

@@ -107,12 +107,20 @@ module.exports = {
         console.log();
         warning('Your global CLI is outdated!');
         console.log(
-          chalk.dim(`  You have a global installation at v${localCliVersion}, but v${npmLatestVersion} is available.\n`)
+          chalk.dim(
+            `  You have a global installation at v${localCliVersion}, but v${npmLatestVersion} is available.\n`
+          )
         );
         console.log(chalk.dim(`  Options:`));
         console.log(chalk.dim(`  1. Cancel and run: `) + chalk.cyan(`npx agileflow@latest update`));
-        console.log(chalk.dim(`  2. Remove global:  `) + chalk.cyan(`npm uninstall -g agileflow`) + chalk.dim(` (recommended)`));
-        console.log(chalk.dim(`  3. Update global:  `) + chalk.cyan(`npm install -g agileflow@latest\n`));
+        console.log(
+          chalk.dim(`  2. Remove global:  `) +
+            chalk.cyan(`npm uninstall -g agileflow`) +
+            chalk.dim(` (recommended)`)
+        );
+        console.log(
+          chalk.dim(`  3. Update global:  `) + chalk.cyan(`npm install -g agileflow@latest\n`)
+        );
 
         const useOutdated = options.force
           ? true

package/tools/cli/lib/content-injector.js

@@ -26,7 +26,12 @@ const path = require('path');
 
 // Use shared modules
 const { parseFrontmatter, normalizeTools } = require('../../../scripts/lib/frontmatter-parser');
-const { countCommands, countAgents, countSkills, getCounts } = require('../../../scripts/lib/counter');
+const {
+  countCommands,
+  countAgents,
+  countSkills,
+  getCounts,
+} = require('../../../scripts/lib/counter');
 
 // =============================================================================
 // List Generation Functions

package/tools/cli/tui/Dashboard.js

@@ -0,0 +1,66 @@
+/**
+ * Dashboard Component
+ *
+ * BETA - Main TUI dashboard view
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+class Dashboard {
+  constructor(options = {}) {
+    this.statusPath = options.statusPath || path.join(process.cwd(), 'docs', '09-agents', 'status.json');
+    this.data = null;
+  }
+
+  async load() {
+    if (!fs.existsSync(this.statusPath)) {
+      return false;
+    }
+
+    try {
+      const content = fs.readFileSync(this.statusPath, 'utf8');
+      this.data = JSON.parse(content);
+      return true;
+    } catch (err) {
+      return false;
+    }
+  }
+
+  getStories() {
+    if (!this.data) return [];
+    return Object.values(this.data).filter(
+      s => s && typeof s === 'object' && (s.id || s.story_id)
+    );
+  }
+
+  getStats() {
+    const stories = this.getStories();
+    return {
+      total: stories.length,
+      in_progress: stories.filter(s => ['in_progress', 'in-progress'].includes(s.status)).length,
+      blocked: stories.filter(s => s.status === 'blocked').length,
+      ready: stories.filter(s => s.status === 'ready').length,
+      completed: stories.filter(s => ['completed', 'done'].includes(s.status)).length,
+    };
+  }
+
+  getCompletionPercentage() {
+    const stats = this.getStats();
+    if (stats.total === 0) return 0;
+    return Math.round((stats.completed / stats.total) * 100);
+  }
+
+  getStoriesByStatus(status) {
+    const stories = this.getStories();
+    if (status === 'in_progress') {
+      return stories.filter(s => ['in_progress', 'in-progress'].includes(s.status));
+    }
+    if (status === 'completed') {
+      return stories.filter(s => ['completed', 'done'].includes(s.status));
+    }
+    return stories.filter(s => s.status === status);
+  }
+}
+
+module.exports = Dashboard;

package/tools/cli/tui/StoryList.js

@@ -0,0 +1,69 @@
+/**
+ * StoryList Component
+ *
+ * BETA - Story list rendering for TUI
+ */
+
+class StoryList {
+  constructor(stories = []) {
+    this.stories = stories;
+    this.selectedIndex = 0;
+  }
+
+  setStories(stories) {
+    this.stories = stories;
+    this.selectedIndex = 0;
+  }
+
+  selectNext() {
+    if (this.selectedIndex < this.stories.length - 1) {
+      this.selectedIndex++;
+    }
+    return this.getSelected();
+  }
+
+  selectPrev() {
+    if (this.selectedIndex > 0) {
+      this.selectedIndex--;
+    }
+    return this.getSelected();
+  }
+
+  getSelected() {
+    return this.stories[this.selectedIndex] || null;
+  }
+
+  filter(predicate) {
+    return new StoryList(this.stories.filter(predicate));
+  }
+
+  sortByPriority() {
+    const priorityOrder = {
+      blocked: 0,
+      in_progress: 1,
+      'in-progress': 1,
+      ready: 2,
+      draft: 3,
+      completed: 4,
+      done: 4,
+    };
+
+    return new StoryList(
+      [...this.stories].sort((a, b) => {
+        const aPriority = priorityOrder[a.status] ?? 99;
+        const bPriority = priorityOrder[b.status] ?? 99;
+        return aPriority - bPriority;
+      })
+    );
+  }
+
+  toArray() {
+    return [...this.stories];
+  }
+
+  get length() {
+    return this.stories.length;
+  }
+}
+
+module.exports = StoryList;

package/tools/cli/tui/index.js

@@ -0,0 +1,16 @@
+/**
+ * AgileFlow TUI Components
+ *
+ * BETA - Internal use only, not publicly documented
+ *
+ * This module contains TUI components for the AgileFlow dashboard.
+ * Currently in early development.
+ */
+
+const Dashboard = require('./Dashboard');
+const StoryList = require('./StoryList');
+
+module.exports = {
+  Dashboard,
+  StoryList,
+};