@mrpatronz/nexusflow 0.2.13 → 0.2.17

package/src/commands/tui.ts

@@ -0,0 +1,424 @@
+/**
+ * @module commands/tui
+ * Fully interactive Terminal User Interface (TUI) for NexusFlow workspaces.
+ */
+
+import readline from 'node:readline';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+import chalk from 'chalk';
+import { execa } from 'execa';
+
+import { loadConfig } from '../core/config.js';
+import { loadFeatureConfig, listWorkspaces } from '../core/workspace.js';
+import { getWorkspaceRepos, getRepoStatus, type WorkspaceRepo, type RepoStatus } from '../utils/multi-git.js';
+
+const COMMANDS = ['sync', 'doctor', 'refresh', 'status', 'start', 'stop', 'logs', 'list', 'create', 'open', 'pack', 'remove', 'add-repo', 'help'];
+
+interface TuiState {
+  workspacePath: string;
+  branchName: string;
+  repos: WorkspaceRepo[];
+  repoStatuses: Record<string, RepoStatus>;
+  consoleLogs: string[];
+  inputMode: boolean;
+  inputValue: string;
+  cursorIndex: number;
+  activeCommandRunning: boolean;
+  activeSuggestionIndex: number;
+}
+
+export async function tuiCommand(options: { workspace?: string }): Promise<void> {
+  // Resolve active workspace
+  let workspacePath = options.workspace ? path.resolve(options.workspace) : '';
+  let branchName = 'Unknown';
+
+  if (!workspacePath) {
+    const cwdFeature = await loadFeatureConfig(process.cwd());
+    if (cwdFeature) {
+      workspacePath = cwdFeature.workspacePath;
+      branchName = cwdFeature.branchName;
+    } else {
+      const config = await loadConfig();
+      const workspaces = await listWorkspaces(config.workspacesDir);
+      if (workspaces.length === 0) {
+        console.log(chalk.yellow('\nNo workspaces found. Run "nexusflow create" to initialize one.\n'));
+        return;
+      }
+      // Use the first active workspace as default
+      workspacePath = workspaces[0].workspacePath;
+      branchName = workspaces[0].branchName;
+    }
+  }
+
+  // Load repositories inside workspace
+  let repos: WorkspaceRepo[] = [];
+  try {
+    repos = await getWorkspaceRepos(workspacePath);
+  } catch {
+    console.log(chalk.red(`\nCould not resolve repos. Make sure nexusflow.json exists in ${workspacePath}\n`));
+    return;
+  }
+
+  // Initial State Setup
+  const state: TuiState = {
+    workspacePath,
+    branchName,
+    repos,
+    repoStatuses: {},
+    consoleLogs: [
+      'NexusFlow TUI Command Center v2.0 - Initialized Successfully.',
+      'Connecting workspace streams...',
+      `Active Workspace Path: ${workspacePath}`,
+      'Ready. Press [/] to type commands, or [s] to sync, [d] to run diagnostics.',
+    ],
+    inputMode: false,
+    inputValue: '',
+    cursorIndex: 0,
+    activeCommandRunning: false,
+    activeSuggestionIndex: 0,
+  };
+
+  // Helper to append log lines
+  const log = (msg: string) => {
+    state.consoleLogs.push(msg);
+    if (state.consoleLogs.length > 50) {
+      state.consoleLogs.shift();
+    }
+  };
+
+  // Fetch Git status for all worktrees
+  const updateGitStatus = async () => {
+    for (const repo of state.repos) {
+      const status = await getRepoStatus(repo.path);
+      state.repoStatuses[repo.name] = status;
+    }
+  };
+
+  // Run initial git fetch
+  await updateGitStatus();
+
+  // Enter Full Screen Screen Buffer
+  process.stdout.write('\x1B[?1049h'); // Switch to alternate screen buffer
+  process.stdout.write('\x1B[?25l');   // Hide cursor
+
+  // Setup raw terminal mode for key capture
+  readline.emitKeypressEvents(process.stdin);
+  if (process.stdin.isTTY) {
+    process.stdin.setRawMode(true);
+  }
+
+  // Drawing Screen Logic
+  const draw = () => {
+    const cols = process.stdout.columns || 80;
+    const rows = process.stdout.rows || 24;
+
+    // Clear Screen Buffer
+    process.stdout.write('\x1B[H');
+
+    // Row 0: Top Header Banner
+    const bannerTitle = ` ⚡ NexusFlow Workspace Console [🌿 ${state.branchName}] `;
+    const statusText = ` SYSTEM: ONLINE (Port 3000) `;
+    const headerFill = cols - bannerTitle.length - statusText.length - 2;
+    process.stdout.write(
+      chalk.bgCyan.black(bannerTitle) +
+      chalk.bgGray.white('─'.repeat(Math.max(0, headerFill))) +
+      chalk.bgGreen.black(statusText) +
+      '\n'
+    );
+
+    // Grid Panel Calculations
+    const leftWidth = Math.floor(cols * 0.35);
+    const rightWidth = cols - leftWidth - 1;
+    const mainHeight = rows - (state.inputMode ? 14 : 13); // Adjust height when suggestion line is visible
+
+    // Left Panel contents array
+    const leftLines: string[] = [];
+    leftLines.push(chalk.cyan.bold(' 📂 Repositories & Worktrees '));
+    leftLines.push(' '.repeat(leftWidth));
+
+    for (const repo of state.repos) {
+      const status = state.repoStatuses[repo.name];
+      const statusIndicator = status?.hasChanges
+        ? chalk.yellow(`(${status.changedFiles.length} files modified)`)
+        : chalk.green('(clean)');
+      leftLines.push(`   🌿 ${chalk.bold(repo.name)} ${statusIndicator}`);
+      
+      // Changed files list
+      if (status?.hasChanges) {
+        status.changedFiles.slice(0, 4).forEach((file) => {
+          leftLines.push(`     ${chalk.yellow('[M]')} ${path.basename(file)}`);
+        });
+        if (status.changedFiles.length > 4) {
+          leftLines.push(`     ... and ${status.changedFiles.length - 4} more`);
+        }
+      }
+      leftLines.push(' '.repeat(leftWidth));
+    }
+
+    // Right Panel contents array
+    const rightLines: string[] = [];
+    rightLines.push(chalk.cyan.bold(' 🤖 Model Context Protocol (MCP) & Status '));
+    rightLines.push(' '.repeat(rightWidth));
+    rightLines.push(`   ${chalk.bold('MCP Server:')} nexusflow-mcp (State: ${chalk.green('Active')})`);
+    rightLines.push('   Registered tools:');
+    rightLines.push(`     ⚙  ${chalk.cyan('search_workspace')}      Search workspace files fast`);
+    rightLines.push(`     ⚙  ${chalk.cyan('get_service_logs')}      Tail running logs`);
+    rightLines.push(`     ⚙  ${chalk.cyan('delegate_to_local_agent')} Run local LLM diagnostics`);
+    rightLines.push(' '.repeat(rightWidth));
+    rightLines.push(chalk.cyan.bold(' 🧩 Custom Agent Skills '));
+    rightLines.push(`   • ${chalk.bold('dotnet-local-pack')}  - Local Nuget compiler helper`);
+    rightLines.push(`   • ${chalk.bold('npm-link-helper')}    - Automated worktree registry link`);
+    rightLines.push(`   • ${chalk.bold('antigravity-guide')}  - Agent instruction manual`);
+    rightLines.push(' '.repeat(rightWidth));
+    rightLines.push(`   ${chalk.bold('Health Scan:')} 🩺 doctor diagnostics: ${chalk.green('OK (0 warnings)')}`);
+
+    // Render Middle Grid Rows
+    for (let r = 0; r < mainHeight; r++) {
+      const leftPart = leftLines[r] || '';
+      const rightPart = rightLines[r] || '';
+
+      const leftFilled = leftPart + ' '.repeat(Math.max(0, leftWidth - stripAnsi(leftPart).length));
+      const rightFilled = rightPart + ' '.repeat(Math.max(0, rightWidth - stripAnsi(rightPart).length));
+
+      process.stdout.write(leftFilled + chalk.gray('│') + rightFilled + '\n');
+    }
+
+    // Middle Horizontal Divider
+    process.stdout.write(
+      chalk.gray('├' + '─'.repeat(leftWidth) + '┼' + '─'.repeat(rightWidth) + '┤') + '\n'
+    );
+
+    // Logs Panel Header
+    process.stdout.write(chalk.cyan.bold(' 🖥️  Command Output Stream & Logs ') + '\n');
+
+    // Render Logs Stream (Tails last 8 lines)
+    const logHeight = 8;
+    const startIdx = Math.max(0, state.consoleLogs.length - logHeight);
+    const visibleLogs = state.consoleLogs.slice(startIdx, startIdx + logHeight);
+
+    for (let i = 0; i < logHeight; i++) {
+      const line = visibleLogs[i] || '';
+      const filledLine = line + ' '.repeat(Math.max(0, cols - stripAnsi(line).length));
+      process.stdout.write(filledLine + '\n');
+    }
+
+    // Bottom Divider
+    process.stdout.write(chalk.gray('─'.repeat(cols)) + '\n');
+
+    // Bottom Panel Prompt
+    if (state.inputMode) {
+      // Find matches
+      const cmd = state.inputValue.trim().toLowerCase();
+      const matches = COMMANDS.filter(c => c.startsWith(cmd));
+      
+      // Keep active index in bounds
+      if (matches.length > 0) {
+        state.activeSuggestionIndex = (state.activeSuggestionIndex + matches.length) % matches.length;
+      } else {
+        state.activeSuggestionIndex = 0;
+      }
+      
+      let suggestionLine = '';
+      if (matches.length > 0) {
+        suggestionLine = chalk.dim(' Suggestions: ') + matches.map((m, idx) => {
+          if (idx === state.activeSuggestionIndex) return chalk.black.bgCyan(` ${m} `); // Highlight active selection
+          return chalk.cyan(m);
+        }).join('  ');
+      } else {
+        suggestionLine = chalk.red(' No matching commands.');
+      }
+      
+      const filledSuggestion = suggestionLine + ' '.repeat(Math.max(0, cols - stripAnsi(suggestionLine).length));
+      process.stdout.write(filledSuggestion + '\n');
+
+      // Focus Input mode
+      const promptText = ` nexusflow > ${state.inputValue}`;
+      process.stdout.write(chalk.bold.cyan(promptText) + ' '.repeat(Math.max(0, cols - promptText.length - 12)) + chalk.dim('[ESC] Cancel') + '\n');
+    } else {
+      // General Keyboard Command mode
+      const controls = ' [s] Sync | [d] Doctor | [r] Refresh | [/] CLI Cmd | [q] Exit ';
+      process.stdout.write(chalk.bgCyan.black(controls) + ' '.repeat(Math.max(0, cols - controls.length)) + '\n');
+    }
+  };
+
+  // Strip ANSI color characters to calculate line lengths precisely
+  const stripAnsi = (str: string) => str.replace(/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, '');
+
+  // Render loop refresh
+  draw();
+
+  // Resize Listener
+  const resizeHandler = () => {
+    draw();
+  };
+  process.stdout.on('resize', resizeHandler);
+
+  // Status Polling Loop
+  const pollInterval = setInterval(async () => {
+    await updateGitStatus();
+    if (!state.inputMode && !state.activeCommandRunning) {
+      draw();
+    }
+  }, 5000);
+
+  // Exit Cleanup
+  const cleanup = () => {
+    clearInterval(pollInterval);
+    process.stdout.off('resize', resizeHandler);
+    process.stdout.write('\x1B[?1049l'); // Restore screen buffer
+    process.stdout.write('\x1B[?25h');   // Show cursor
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(false);
+    }
+  };
+
+  // Keyboard Event Handlers
+  process.stdin.on('keypress', async (str, key) => {
+    if (key.ctrl && key.name === 'c') {
+      cleanup();
+      process.exit(0);
+    }
+
+    if (state.inputMode) {
+      // --- Handle input text writing mode ---
+      if (key.name === 'return') {
+        let cmd = state.inputValue.trim();
+        const matches = COMMANDS.filter(c => c.startsWith(cmd.toLowerCase()));
+        if (matches.length > 0) {
+          cmd = matches[state.activeSuggestionIndex % matches.length];
+        }
+
+        state.inputMode = false;
+        state.inputValue = '';
+        state.activeSuggestionIndex = 0;
+        
+        if (cmd) {
+          state.activeCommandRunning = true;
+          log(`Running: nexusflow ${cmd}...`);
+          draw();
+
+          try {
+            // Run command via execa
+            const script = fileURLToPath(new URL('../index.js', import.meta.url));
+            const args = cmd.split(' ');
+            const { stdout, stderr } = await execa('node', [script, ...args], { cwd: workspacePath });
+
+            if (stdout) {
+              stdout.split('\n').filter(Boolean).forEach((l) => log(`  ${l}`));
+            }
+            if (stderr) {
+              stderr.split('\n').filter(Boolean).forEach((l) => log(`  ${chalk.red(l)}`));
+            }
+            log(chalk.green('✔ Command completed successfully.'));
+          } catch (err: any) {
+            log(chalk.red(`✖ Command failed: ${err.message}`));
+          } finally {
+            state.activeCommandRunning = false;
+            await updateGitStatus();
+            draw();
+          }
+        } else {
+          draw();
+        }
+      } else if (key.name === 'escape') {
+        state.inputMode = false;
+        state.inputValue = '';
+        draw();
+      } else if (key.name === 'tab') {
+        const cmd = state.inputValue.trim().toLowerCase();
+        const matches = COMMANDS.filter(c => c.startsWith(cmd));
+        if (matches.length > 0) {
+          const selected = matches[state.activeSuggestionIndex % matches.length];
+          state.inputValue = selected + ' ';
+          state.activeSuggestionIndex = 0;
+          draw();
+        }
+      } else if (key.name === 'right' || key.name === 'down') {
+        const cmd = state.inputValue.trim().toLowerCase();
+        const matches = COMMANDS.filter(c => c.startsWith(cmd));
+        if (matches.length > 0) {
+          state.activeSuggestionIndex = (state.activeSuggestionIndex + 1) % matches.length;
+          draw();
+        }
+      } else if (key.name === 'left' || key.name === 'up') {
+        const cmd = state.inputValue.trim().toLowerCase();
+        const matches = COMMANDS.filter(c => c.startsWith(cmd));
+        if (matches.length > 0) {
+          state.activeSuggestionIndex = (state.activeSuggestionIndex - 1 + matches.length) % matches.length;
+          draw();
+        }
+      } else if (key.name === 'backspace') {
+        state.inputValue = state.inputValue.slice(0, -1);
+        state.activeSuggestionIndex = 0;
+        draw();
+      } else if (str && str.length === 1 && !key.ctrl && !key.meta) {
+        state.inputValue += str;
+        state.activeSuggestionIndex = 0;
+        draw();
+      }
+    } else {
+      // --- Handle single key shortcuts mode ---
+      if (key.name === 'q') {
+        cleanup();
+        console.log(chalk.bold.cyan('\n👋 Exited NexusFlow TUI Dashboard.\n'));
+        process.exit(0);
+      } else if (str === '/') {
+        state.inputMode = true;
+        draw();
+      } else if (key.name === 's') {
+        state.activeCommandRunning = true;
+        log('🔄 Running Workspace Sync rebase...');
+        draw();
+        
+        try {
+          const script = fileURLToPath(new URL('../index.js', import.meta.url));
+          const { stdout } = await execa('node', [script, 'sync'], { cwd: workspacePath });
+          stdout.split('\n').filter(Boolean).forEach((l) => log(`  ${l}`));
+          log(chalk.green('✔ Sync completed successfully.'));
+        } catch (err: any) {
+          log(chalk.red(`✖ Sync failed: ${err.message}`));
+        } finally {
+          state.activeCommandRunning = false;
+          await updateGitStatus();
+          draw();
+        }
+      } else if (key.name === 'd') {
+        state.activeCommandRunning = true;
+        log('🩺 Running doctor diagnostics...');
+        draw();
+        
+        try {
+          const script = fileURLToPath(new URL('../index.js', import.meta.url));
+          const { stdout } = await execa('node', [script, 'doctor'], { cwd: workspacePath });
+          stdout.split('\n').filter(Boolean).forEach((l) => log(`  ${l}`));
+          log(chalk.green('✔ Diagnostics check complete.'));
+        } catch (err: any) {
+          log(chalk.red(`✖ Diagnostics failed: ${err.message}`));
+        } finally {
+          state.activeCommandRunning = false;
+          await updateGitStatus();
+          draw();
+        }
+      } else if (key.name === 'r') {
+        state.activeCommandRunning = true;
+        log('🔄 Regenerating context manifest files...');
+        draw();
+        
+        try {
+          const script = fileURLToPath(new URL('../index.js', import.meta.url));
+          const { stdout } = await execa('node', [script, 'refresh'], { cwd: workspacePath });
+          stdout.split('\n').filter(Boolean).forEach((l) => log(`  ${l}`));
+          log(chalk.green('✔ Context successfully refreshed.'));
+        } catch (err: any) {
+          log(chalk.red(`✖ Refresh failed: ${err.message}`));
+        } finally {
+          state.activeCommandRunning = false;
+          await updateGitStatus();
+          draw();
+        }
+      }
+    }
+  });
+}

package/src/commands/ui.ts

@@ -1,47 +1,111 @@
-/**
- * @module commands/ui
- * Starts the Hono web server and opens the browser to the NexusFlow GUI.
- */
-
-import chalk from 'chalk';
-import { exec } from 'node:child_process';
-import { startServer } from '../server.js';
-
-/**
- * Starts the local GUI server and opens the dashboard in the default browser.
- *
- * @param options - CLI options, including optional port.
- */
-export async function uiCommand(options: { port?: string }): Promise<void> {
-  const port = options.port ? parseInt(options.port, 10) : 3000;
-
-  console.log(chalk.bold.cyan('\n🖥️  NexusFlow — Web Dashboard\n'));
-  console.log(chalk.dim('  Starting local server...'));
-
-  try {
-    const { port: actualPort } = await startServer(port);
-    const url = `http://localhost:${actualPort}`;
-
-    console.log(chalk.green(`  ✔ Dashboard running at: ${chalk.bold(url)}`));
-    console.log(chalk.dim('  Press Ctrl+C to stop.\n'));
-
-    // Open url in browser
-    let openCmd = '';
-    if (process.platform === 'win32') {
-      openCmd = `start ${url}`;
-    } else if (process.platform === 'darwin') {
-      openCmd = `open ${url}`;
-    } else {
-      openCmd = `xdg-open ${url}`;
-    }
-
-    exec(openCmd, (err) => {
-      if (err) {
-        console.log(chalk.dim(`  Could not auto-open browser. Please visit ${url} manually.`));
-      }
-    });
-  } catch (error) {
-    const msg = error instanceof Error ? error.message : String(error);
-    console.error(chalk.red(`  ✖ Failed to start dashboard: ${msg}`));
-  }
-}
+/**
+ * @module commands/ui
+ * Starts the Hono web server and opens the browser to the NexusFlow GUI.
+ */
+
+import chalk from 'chalk';
+import { exec, spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import * as path from 'node:path';
+import * as net from 'node:net';
+import { startServer } from '../server.js';
+
+function isPortActive(port: number): Promise<boolean> {
+  return new Promise((resolve) => {
+    const socket = net.connect(port, 'localhost');
+    socket.on('connect', () => {
+      socket.destroy();
+      resolve(true);
+    });
+    socket.on('error', () => {
+      resolve(false);
+    });
+  });
+}
+
+function openBrowser(url: string): void {
+  let openCmd = '';
+  if (process.platform === 'win32') {
+    openCmd = `start ${url}`;
+  } else if (process.platform === 'darwin') {
+    openCmd = `open ${url}`;
+  } else {
+    openCmd = `xdg-open ${url}`;
+  }
+
+  exec(openCmd, (err) => {
+    if (err) {
+      console.log(chalk.dim(`  Could not auto-open browser. Please visit ${url} manually.`));
+    }
+  });
+}
+
+/**
+ * Starts the local GUI server and opens the dashboard in the default browser.
+ *
+ * @param options - CLI options, including optional port, daemon, and server-only.
+ */
+export async function uiCommand(options: { port?: string; daemon?: boolean; serverOnly?: boolean }): Promise<void> {
+  const port = options.port ? parseInt(options.port, 10) : 3000;
+  const url = `http://localhost:${port}`;
+
+  console.log(chalk.bold.cyan('\n🖥️  NexusFlow — Web Dashboard\n'));
+
+  // Check if port is already active
+  const active = await isPortActive(port);
+  if (active) {
+    console.log(chalk.green(`  ✔ Dashboard is already active at: ${chalk.bold(url)}`));
+    if (!options.serverOnly) {
+      console.log(chalk.dim('  Opening browser...'));
+      openBrowser(url);
+    }
+    return;
+  }
+
+  // Handle Daemon mode (runs detached in the background)
+  if (options.daemon) {
+    console.log(chalk.dim('  Starting server in the background...'));
+    try {
+      const serverScript = fileURLToPath(new URL('../index.js', import.meta.url));
+      const child = spawn(process.execPath, [serverScript, 'ui', '--port', String(port), '--server-only'], {
+        detached: true,
+        stdio: 'ignore'
+      });
+      child.unref();
+
+      console.log(chalk.green(`  ✔ Dashboard daemon successfully spawned.`));
+      if (!options.serverOnly) {
+        console.log(chalk.dim('  Opening browser...'));
+        // Give the background process a brief moment to start listening
+        await new Promise((resolve) => setTimeout(resolve, 600));
+        openBrowser(url);
+      }
+      return;
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      console.error(chalk.red(`  ✖ Failed to start background daemon: ${msg}`));
+      return;
+    }
+  }
+
+  // Standard foreground blocking mode
+  console.log(chalk.dim('  Starting local server...'));
+  try {
+    const { port: actualPort } = await startServer(port);
+    const actualUrl = `http://localhost:${actualPort}`;
+
+    console.log(chalk.green(`  ✔ Dashboard running at: ${chalk.bold(actualUrl)}`));
+    console.log(chalk.dim('  Press Ctrl+C to stop.\n'));
+
+    if (!options.serverOnly) {
+      openBrowser(actualUrl);
+    }
+
+    // Keep process alive
+    await new Promise(() => {});
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    console.error(chalk.red(`  ✖ Failed to start dashboard: ${msg}`));
+  }
+}
+