@mrpatronz/nexusflow 0.2.18 → 1.3.0

package/src/commands/init.ts

@@ -1,134 +0,0 @@
-/**
- * @module commands/init
- * Initializes the NexusFlow configuration.
- */
-
-import chalk from 'chalk';
-import { input, confirm, select } from '@inquirer/prompts';
-import path from 'node:path';
-import os from 'node:os';
-
-import { loadConfig, saveConfig, ensureConfigDir } from '../core/config.js';
-import { scanSystemSpecs } from '../utils/system-scanner.js';
-
-/**
- * Initializes NexusFlow configuration interactively.
- * Creates ~/.nexusflow/config.json with user preferences.
- */
-export async function initCommand(): Promise<void> {
-  console.log(chalk.bold.cyan('\n⚙️  NexusFlow — Initialize\n'));
-
-  await ensureConfigDir();
-  const existing = await loadConfig();
-
-  // ── 1. Basic Directories ──────────────────────────────────────────────
-  const devDir = await input({
-    message: 'Development directory (where your repos live):',
-    default: existing.devDir || path.join(os.homedir(), 'dev'),
-  });
-
-  const workspacesDir = await input({
-    message: 'Workspaces directory (where feature workspaces are created):',
-    default: existing.workspacesDir || path.join(devDir, 'workspaces'),
-  });
-
-  const scanDepth = await input({
-    message: 'How deep to scan for repos (directory levels):',
-    default: String(existing.scanDepth || 2),
-    validate: (value: string) => {
-      const num = parseInt(value, 10);
-      if (isNaN(num) || num < 1 || num > 10) return 'Enter a number between 1 and 10';
-      return true;
-    },
-  });
-
-  // ── 2. Local AI Scanner & Config ──────────────────────────────────────
-  console.log(chalk.cyan('\nProbing system hardware for local AI capabilities...'));
-  let specs;
-  try {
-    specs = await scanSystemSpecs();
-  } catch (error) {
-    specs = {
-      totalRamGb: 8,
-      gpuName: 'Unknown/Integrated',
-      hasHardwareAcceleration: false,
-      recommendedModel: 'qwen2.5-coder:1.5b',
-    };
-  }
-  console.log(chalk.dim(`  RAM Detected: ${specs.totalRamGb} GB`));
-  console.log(chalk.dim(`  GPU Detected: ${specs.gpuName}`));
-  console.log(chalk.dim(`  Recommended model: ${chalk.bold(specs.recommendedModel)}`));
-
-  const enableLlm = await confirm({
-    message: 'Enable Local AI Co-processor (Ollama/LM Studio)?',
-    default: existing.localLlm?.enabled ?? false,
-  });
-
-  let localLlmConfig = existing.localLlm || {
-    enabled: false,
-    provider: 'ollama',
-    endpoint: 'http://localhost:11434',
-    model: specs.recommendedModel,
-  };
-
-  if (enableLlm) {
-    const provider = await select({
-      message: 'Local AI Provider:',
-      choices: [
-        { name: 'Ollama', value: 'ollama' as const },
-        { name: 'OpenAI-Compatible (e.g. LM Studio, Llama.cpp)', value: 'openai-compatible' as const },
-      ],
-      default: existing.localLlm?.provider || 'ollama',
-    });
-
-    const defaultEndpoint = provider === 'ollama' ? 'http://localhost:11434' : 'http://localhost:1234';
-    const endpoint = await input({
-      message: 'Local AI Endpoint URL:',
-      default: existing.localLlm?.endpoint || defaultEndpoint,
-      validate: (value: string) => {
-        const trimmed = value.trim();
-        if (!trimmed.startsWith('http://') && !trimmed.startsWith('https://')) {
-          return 'Endpoint must start with http:// or https://';
-        }
-        try {
-          new URL(trimmed);
-          return true;
-        } catch {
-          return 'Please enter a valid URL';
-        }
-      },
-    });
-
-    const model = await input({
-      message: `Local LLM Model Name (Recommended: ${specs.recommendedModel}):`,
-      default: existing.localLlm?.model || specs.recommendedModel,
-    });
-
-    localLlmConfig = {
-      enabled: true,
-      provider,
-      endpoint: endpoint.trim(),
-      model: model.trim(),
-    };
-  } else {
-    localLlmConfig.enabled = false;
-  }
-
-  const config = {
-    ...existing,
-    devDir: devDir.trim(),
-    workspacesDir: workspacesDir.trim(),
-    scanDepth: parseInt(scanDepth, 10),
-    localLlm: localLlmConfig,
-  };
-
-  await saveConfig(config);
-
-  console.log(chalk.green('\n✅ Configuration saved!\n'));
-  console.log(chalk.dim('  Config file: ~/.nexusflow/config.json'));
-  console.log(chalk.dim(`  Dev dir:     ${config.devDir}`));
-  console.log(chalk.dim(`  Workspaces:  ${config.workspacesDir}`));
-  console.log(chalk.dim(`  Scan depth:  ${config.scanDepth}`));
-  console.log(chalk.dim(`  Local AI:    ${config.localLlm.enabled ? `Enabled (${config.localLlm.provider}, model: ${config.localLlm.model})` : 'Disabled'}`));
-  console.log(chalk.dim('\n  Run "nexusflow create" to create your first workspace.\n'));
-}

package/src/commands/list.ts

@@ -1,46 +0,0 @@
-/**
- * @module commands/list
- * Lists all existing NexusFlow workspaces.
- */
-
-import chalk from 'chalk';
-
-import { loadConfig } from '../core/config.js';
-import { listWorkspaces } from '../core/workspace.js';
-
-/**
- * Lists all existing workspaces, showing feature name, repos, and status.
- */
-export async function listCommand(): Promise<void> {
-  const config = await loadConfig();
-  const workspaces = await listWorkspaces(config.workspacesDir);
-
-  if (workspaces.length === 0) {
-    console.log(chalk.yellow('\nNo workspaces found.'));
-    console.log(chalk.dim(`  Workspaces directory: ${config.workspacesDir}`));
-    console.log(chalk.dim('  Run "nexusflow create" to create your first workspace.\n'));
-    return;
-  }
-
-  console.log(chalk.bold.cyan(`\n📂 NexusFlow Workspaces (${workspaces.length})\n`));
-
-  for (const ws of workspaces) {
-    const repoCount = ws.repos.length;
-    const aiList = ws.assistants.join(', ');
-    const date = new Date(ws.createdAt).toLocaleDateString();
-
-    console.log(
-      `  ${chalk.bold(ws.branchName)} ${chalk.dim(`(${date})`)}`,
-    );
-    console.log(
-      `    ${chalk.dim('Repos:')}  ${repoCount} project${repoCount !== 1 ? 's' : ''}`,
-    );
-    console.log(
-      `    ${chalk.dim('AI:')}     ${aiList || 'none'}`,
-    );
-    console.log(
-      `    ${chalk.dim('Path:')}   ${ws.workspacePath}`,
-    );
-    console.log();
-  }
-}

package/src/commands/logs.ts

@@ -1,63 +0,0 @@
-/**
- * @module commands/logs
- * Shows aggregated logs from all services in a workspace.
- */
-
-import * as path from 'node:path';
-import chalk from 'chalk';
-import { select } from '@inquirer/prompts';
-
-import { loadConfig } from '../core/config.js';
-import { listWorkspaces, loadFeatureConfig } from '../core/workspace.js';
-import { showLogs, getServiceStatus } from '../orchestration/index.js';
-
-/**
- * Shows logs and status for services in a workspace.
- *
- * @param workspaceArg - Optional workspace path from CLI.
- * @param lines        - Number of log lines to show per service.
- */
-export async function logsCommand(workspaceArg?: string, lines: number = 30): Promise<void> {
-  console.log(chalk.bold.cyan('\n📋 NexusFlow — Service Logs\n'));
-
-  const workspacePath = await resolveWorkspace(workspaceArg);
-  if (!workspacePath) return;
-
-  // Show service status first
-  console.log(chalk.cyan('Service Status:'));
-  await getServiceStatus(workspacePath);
-
-  // Show logs
-  const logDir = path.join(workspacePath, '.nexusflow-logs');
-  await showLogs(workspacePath, logDir, lines);
-
-  console.log();
-}
-
-/**
- * Resolves a workspace path from argument, cwd, or user prompt.
- */
-async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
-  if (workspaceArg) return workspaceArg;
-
-  const cwdFeature = await loadFeatureConfig(process.cwd());
-  if (cwdFeature) return cwdFeature.workspacePath;
-
-  const config = await loadConfig();
-  const workspaces = await listWorkspaces(config.workspacesDir);
-
-  if (workspaces.length === 0) {
-    console.log(chalk.yellow('No workspaces found.\n'));
-    return null;
-  }
-
-  const selected = await select({
-    message: 'Select a workspace to view logs for:',
-    choices: workspaces.map((ws) => ({
-      name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
-      value: ws.workspacePath,
-    })),
-  });
-
-  return selected;
-}

package/src/commands/mcp.ts

@@ -1,94 +0,0 @@
-import * as os from 'node:os';
-import * as path from 'node:path';
-import * as fs from 'node:fs/promises';
-import chalk from 'chalk';
-import { startMcpServer } from '../mcp/server.js';
-
-export async function mcpRunCommand(workspace?: string) {
-  // If not provided, it attempts to use process.cwd() or waits for workspaceId in MCP calls.
-  // The startMcpServer function handles this.
-  await startMcpServer(workspace);
-}
-
-export async function mcpSetupCommand() {
-  console.log(chalk.blue.bold('\nSetting up NexusFlow MCP Server for AI Assistants...'));
-  
-  const isWin = os.platform() === 'win32';
-  const isMac = os.platform() === 'darwin';
-  const home = os.homedir();
-
-  const configPaths = [
-    // Cursor
-    path.join(home, '.cursor', 'mcp.json'),
-    // VS Code Insiders (for Antigravity/Copilot)
-    isWin 
-      ? path.join(home, 'AppData', 'Roaming', 'Code - Insiders', 'User', 'mcp.json')
-      : isMac 
-        ? path.join(home, 'Library', 'Application Support', 'Code - Insiders', 'User', 'mcp.json')
-        : path.join(home, '.config', 'Code - Insiders', 'User', 'mcp.json'),
-    // VS Code (Stable)
-    isWin 
-      ? path.join(home, 'AppData', 'Roaming', 'Code', 'User', 'mcp.json')
-      : isMac 
-        ? path.join(home, 'Library', 'Application Support', 'Code', 'User', 'mcp.json')
-        : path.join(home, '.config', 'Code', 'User', 'mcp.json'),
-    // Claude Desktop
-    isWin
-      ? path.join(home, 'AppData', 'Roaming', 'Claude', 'claude_desktop_config.json')
-      : isMac
-        ? path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json')
-        : ''
-  ].filter(Boolean);
-
-  const mcpConfig = {
-    command: 'npx',
-    args: ['-y', '@mrpatronz/nexusflow', 'mcp', 'run']
-  };
-
-  let updatedCount = 0;
-
-  for (const configPath of configPaths) {
-    if (!configPath) continue;
-    try {
-      let configData: any = { mcpServers: {} };
-      
-      try {
-        await fs.access(configPath);
-        const raw = await fs.readFile(configPath, 'utf8');
-        // Handle empty or invalid files gracefully
-        if (raw.trim()) {
-            configData = JSON.parse(raw);
-        }
-        if (!configData.mcpServers) configData.mcpServers = {};
-      } catch (e) {
-        // File doesn't exist, we will create it if the directory exists
-        const dir = path.dirname(configPath);
-        try {
-          await fs.access(dir);
-        } catch {
-          // Directory doesn't exist, skip this environment
-          continue;
-        }
-      }
-
-      configData.mcpServers['nexusflow'] = mcpConfig;
-
-      await fs.writeFile(configPath, JSON.stringify(configData, null, 2), 'utf8');
-      console.log(chalk.green(`  ✓ Configured MCP in: ${configPath}`));
-      updatedCount++;
-    } catch (e: any) {
-      console.log(chalk.gray(`  - Skipped ${configPath} (${e.message})`));
-    }
-  }
-
-  if (updatedCount > 0) {
-    console.log(chalk.green.bold(`\nSuccessfully configured ${updatedCount} AI environments!`));
-    console.log(chalk.white('You may need to restart your editor or Claude Desktop for the changes to take effect.'));
-  } else {
-    console.log(chalk.yellow('\nCould not find any standard configuration files to update.'));
-    console.log('You can manually add this configuration to your mcp.json:');
-    console.log(JSON.stringify({ mcpServers: { nexusflow: mcpConfig } }, null, 2));
-  }
-}
-
-

package/src/commands/open.ts

@@ -1,129 +0,0 @@
-/**
- * @module commands/open
- * Re-opens an existing NexusFlow workspace in an editor.
- */
-
-import chalk from 'chalk';
-import { execa } from 'execa';
-import { select, confirm, search } from '@inquirer/prompts';
-
-import { loadConfig } from '../core/config.js';
-import { listWorkspaces } from '../core/workspace.js';
-import { detectEditors } from '../utils/detect-editors.js';
-import { promptSelectEditor } from '../utils/prompts.js';
-import { findSessions } from '../utils/session-finder.js';
-
-/**
- * Lets the user pick an existing workspace and open it in an editor.
- */
-export async function openCommand(): Promise<void> {
-  const config = await loadConfig();
-  const workspaces = await listWorkspaces(config.workspacesDir);
-
-  if (workspaces.length === 0) {
-    console.log(chalk.yellow('\nNo workspaces found.'));
-    console.log(chalk.dim('  Run "nexusflow create" to create your first workspace.\n'));
-    return;
-  }
-
-  console.log(chalk.bold.cyan('\n📂 Open Workspace\n'));
-
-  // Let user pick a workspace
-  const selected = await search({
-    message: 'Search and select a workspace to open:',
-    source: async (input) => {
-      const query = (input || '').toLowerCase();
-      const filtered = workspaces.filter(
-        (ws) =>
-          ws.branchName.toLowerCase().includes(query) ||
-          ws.workspacePath.toLowerCase().includes(query)
-      );
-      return filtered.map((ws) => ({
-        name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos, ${ws.assistants.join(', ')})`)}`,
-        value: ws.workspacePath,
-      }));
-    },
-  });
-
-  // Let user pick an editor
-  const detectedEditors = await detectEditors();
-  const editor = await promptSelectEditor(detectedEditors);
-
-  if (editor) {
-    try {
-      await execa(editor.command, [selected], {
-        stdio: 'ignore',
-        shell: process.platform === 'win32',
-      });
-      console.log(chalk.green(`\n✅ Opened ${selected} in ${editor.name}\n`));
-    } catch {
-      console.log(chalk.yellow(`\n⚠️  Could not open editor. Navigate manually:`));
-      console.log(chalk.dim(`  cd "${selected}"\n`));
-    }
-  } else {
-    console.log(chalk.dim(`\n  To navigate: cd "${selected}"\n`));
-  }
-
-  // ── Start AI Assistant Session ──────────────────────────────────────
-  const loadedFeature = workspaces.find((ws) => ws.workspacePath === selected);
-  if (loadedFeature && loadedFeature.assistants.length > 0) {
-    const assistant = loadedFeature.assistants[0];
-    const confirmStart = await confirm({
-      message: `Do you want to start a session with ${assistant} inside the workspace now?`,
-      default: true,
-    });
-
-    if (confirmStart) {
-      console.log(chalk.cyan(`\n🚀 Starting ${assistant} session inside workspace...\n`));
-
-      const sessions = await findSessions(selected, loadedFeature.repos);
-      let cmdName = 'agy';
-      let cmdArgs: string[] = [];
-
-      if (assistant === 'claude') {
-        cmdName = 'claude';
-      } else if (assistant === 'codex') {
-        cmdName = 'codex';
-      } else if (assistant === 'copilot') {
-        cmdName = 'copilot';
-      }
-
-      if (sessions.length > 0 && sessions[0].assistant === assistant) {
-        const latestSessionId = sessions[0].id;
-        if (assistant === 'antigravity') {
-          cmdArgs = ['--conversation', latestSessionId];
-        } else if (assistant === 'claude') {
-          cmdArgs = ['--resume', latestSessionId];
-        } else if (assistant === 'codex') {
-          cmdArgs = ['resume', latestSessionId];
-        } else if (assistant === 'copilot') {
-          cmdArgs = ['--resume', latestSessionId];
-        }
-      } else {
-        if (assistant === 'antigravity') {
-          cmdArgs = ['--continue'];
-        } else if (assistant === 'claude') {
-          cmdArgs = ['--resume'];
-        } else if (assistant === 'codex') {
-          cmdArgs = ['resume'];
-        } else if (assistant === 'copilot') {
-          cmdArgs = ['--resume'];
-        }
-      }
-
-      try {
-        await execa(cmdName, cmdArgs, {
-          cwd: selected,
-          stdio: 'inherit',
-          shell: process.platform === 'win32',
-        });
-        console.log(chalk.green(`\n👋 Exited ${assistant} session.`));
-      } catch {
-        const fullCmd = [cmdName, ...cmdArgs].join(' ');
-        console.log(
-          chalk.yellow(`\n⚠️  Could not start ${assistant}. Please start it manually:\n  ${chalk.dim(`cd "${selected}" && ${fullCmd}`)}`)
-        );
-      }
-    }
-  }
-}

package/src/commands/refresh.ts

@@ -1,137 +0,0 @@
-import chalk from 'chalk';
-import { select, search } from '@inquirer/prompts';
-import * as path from 'node:path';
-import * as fs from 'node:fs/promises';
-
-import { loadConfig } from '../core/config.js';
-import { listWorkspaces, loadFeatureConfig } from '../core/workspace.js';
-import { getWorkspaceRepos } from '../utils/multi-git.js';
-import { analyzeAllRepos } from '../analyzers/index.js';
-import { generateContextFiles } from '../generators/index.js';
-import type { WorkspaceContext } from '../types.js';
-
-/**
- * Runs the refresh command.
- * Updates context files, maps, and plans.
- *
- * @param options - CLI options, e.g. { repo: 'API_CoworkerFacade' }.
- * @param workspaceArg - Optional workspace path.
- */
-export async function refreshCommand(
-  options: { repo?: string; base?: boolean },
-  workspaceArg?: string,
-): Promise<void> {
-  console.log(chalk.bold.cyan('\n🔄 NexusFlow — Refresh Workspace Context\n'));
-
-  const workspacePath = await resolveWorkspace(workspaceArg);
-  if (!workspacePath) return;
-
-  const feature = await loadFeatureConfig(workspacePath);
-  if (!feature) {
-    console.error(chalk.red('✖ Failed to load workspace configuration. Ensure nexusflow.json exists.'));
-    return;
-  }
-
-  const onlyRepo = options.repo;
-  if (onlyRepo) {
-    const hasRepo = feature.repos.some(r => path.basename(r) === onlyRepo);
-    if (!hasRepo) {
-      console.error(chalk.red(`✖ Repository "${onlyRepo}" is not part of this workspace.`));
-      console.log(chalk.dim(`  Available repos: ${feature.repos.map(r => path.basename(r)).join(', ')}`));
-      return;
-    }
-    console.log(`Refreshing context for repository: ${chalk.bold(onlyRepo)}`);
-  } else {
-    console.log('Refreshing context for all repositories...');
-  }
-
-  const allRepos = await Promise.all(
-    feature.repos.map(async (r) => {
-      const repoName = path.basename(r);
-      return {
-        name: repoName,
-        path: r,
-        defaultBranch: 'main',
-      };
-    })
-  );
-
-  console.log(chalk.cyan('Running project analysis...'));
-  const analysis = await analyzeAllRepos(allRepos);
-
-  const ctx: WorkspaceContext = {
-    feature,
-    repos: allRepos,
-    analysis,
-  };
-
-  console.log(chalk.cyan('Regenerating context files and maps...'));
-  await generateContextFiles(ctx, feature.assistants, workspacePath, onlyRepo, options.base);
-
-
-
-  // If handoff file exists, refresh it automatically too!
-  const handoffPath = path.join(workspacePath, 'nexusflow-handoff.md');
-  let hasHandoff = false;
-  try {
-    await fs.access(handoffPath);
-    hasHandoff = true;
-  } catch {}
-
-  if (!options.base && hasHandoff) {
-    console.log(chalk.cyan('Refreshing handoff bundle...'));
-    try {
-      const { handoffCommand } = await import('./handoff.js');
-      await handoffCommand(workspacePath);
-    } catch (error) {
-      console.warn(chalk.yellow(`  ⚠ Failed to refresh handoff bundle: ${error}`));
-    }
-  }
-
-  console.log(chalk.bold.green('\n✅ Workspace context successfully refreshed!\n'));
-}
-
-/**
- * Resolves a workspace path.
- */
-async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
-  if (workspaceArg) {
-    const absolutePath = path.resolve(workspaceArg);
-    try {
-      await fs.access(path.join(absolutePath, 'nexusflow.json'));
-      return absolutePath;
-    } catch {
-      console.error(chalk.red(`✖ Invalid workspace: No nexusflow.json found at ${absolutePath}`));
-      return null;
-    }
-  }
-
-  const cwdFeature = await loadFeatureConfig(process.cwd());
-  if (cwdFeature) return cwdFeature.workspacePath;
-
-  const config = await loadConfig();
-  const workspaces = await listWorkspaces(config.workspacesDir);
-
-  if (workspaces.length === 0) {
-    console.log(chalk.yellow('No workspaces found.\n'));
-    return null;
-  }
-
-  const selected = await search({
-    message: 'Search and select a workspace to refresh:',
-    source: async (input) => {
-      const query = (input || '').toLowerCase();
-      const filtered = workspaces.filter(
-        (ws) =>
-          ws.branchName.toLowerCase().includes(query) ||
-          ws.workspacePath.toLowerCase().includes(query)
-      );
-      return filtered.map((ws) => ({
-        name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
-        value: ws.workspacePath,
-      }));
-    },
-  });
-
-  return selected;
-}