@mrpatronz/nexusflow 0.2.18 → 1.3.0

package/src/commands/commit.ts

@@ -1,131 +0,0 @@
-/**
- * @module commands/commit
- * Commits changes across all repositories in the workspace.
- */
-
-import chalk from 'chalk';
-import { select } 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, getRepoStatus, commitAndPush } from '../utils/multi-git.js';
-
-interface CommitOptions {
-  noPush?: boolean;
-  dryRun?: boolean;
-}
-
-/**
- * Executes the commit command.
- *
- * @param message - The commit message.
- * @param workspaceArg - Optional workspace path.
- * @param options - Optional flags.
- */
-export async function commitCommand(
-  message: string,
-  workspaceArg?: string,
-  options?: CommitOptions,
-): Promise<void> {
-  console.log(chalk.bold.cyan('\n💾 NexusFlow — Committing Workspace Changes\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.'));
-    return;
-  }
-
-  const repos = await getWorkspaceRepos(workspacePath);
-  const changedRepos = [];
-
-  for (const repo of repos) {
-    const status = await getRepoStatus(repo.path);
-    if (status.hasChanges) {
-      changedRepos.push({ repo, status });
-    }
-  }
-
-  if (changedRepos.length === 0) {
-    console.log(chalk.green('✅ No changes to commit across any repositories.\n'));
-    return;
-  }
-
-  console.log(`Found ${chalk.bold(changedRepos.length)} repositor${changedRepos.length === 1 ? 'y' : 'ies'} with changes.`);
-  if (options?.dryRun) {
-    console.log(chalk.yellow('⚠️  Dry run mode enabled. No changes will actually be committed or pushed.'));
-  }
-  console.log();
-
-  for (const { repo, status } of changedRepos) {
-    console.log(`Repository: ${chalk.bold(repo.name)}`);
-    console.log(chalk.dim(`  Changes: ${status.summary}`));
-    for (const file of status.changedFiles) {
-      console.log(`    ${chalk.yellow('M')} ${file}`);
-    }
-
-    if (options?.dryRun) {
-      console.log(chalk.dim('  [Dry Run] Would commit and ' + (options?.noPush ? 'not push' : 'push')));
-      continue;
-    }
-
-    const spinner = chalk.dim('  Committing...');
-    process.stdout.write(spinner);
-
-    const result = await commitAndPush(repo.path, message, repo.branchName, {
-      noPush: options?.noPush,
-    });
-
-    process.stdout.write('\r' + ' '.repeat(spinner.length) + '\r');
-
-    if (result.success) {
-      const action = options?.noPush ? 'Committed' : 'Committed & pushed';
-      console.log(`  ${chalk.green('✅')} ${action} (${chalk.cyan(result.commitHash || 'no hash')})`);
-    } else {
-      console.log(`  ${chalk.red('✖')} Failed: ${result.message}`);
-    }
-  }
-
-  console.log();
-}
-
-/**
- * Resolves 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 select({
-    message: 'Select a workspace to commit:',
-    choices: workspaces.map((ws) => ({
-      name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
-      value: ws.workspacePath,
-    })),
-  });
-
-  return selected;
-}

package/src/commands/config.ts

@@ -1,52 +0,0 @@
-/**
- * @module commands/config
- * CLI command to view and update NexusFlow configuration.
- *
- * Usage:
- *   nexusflow config                           # Show current config
- *   nexusflow config set storageProvider local  # Set a config key
- *   nexusflow config get storageProvider        # Get a specific key
- */
-
-import { loadConfig, saveConfig } from '../core/config.js';
-
-/**
- * Displays the current NexusFlow configuration.
- */
-export async function configShowCommand(): Promise<void> {
-  const config = await loadConfig();
-  console.log('\n⚙️  NexusFlow Configuration\n');
-  console.log(JSON.stringify(config, null, 2));
-  console.log();
-}
-
-/**
- * Gets a specific configuration key.
- */
-export async function configGetCommand(key: string): Promise<void> {
-  const config = await loadConfig();
-  const value = (config as unknown as Record<string, unknown>)[key];
-
-  if (value === undefined) {
-    console.log(`  Key "${key}" is not set.`);
-  } else {
-    console.log(`  ${key} = ${typeof value === 'object' ? JSON.stringify(value, null, 2) : String(value)}`);
-  }
-}
-
-/**
- * Sets a specific configuration key.
- */
-export async function configSetCommand(key: string, value: string): Promise<void> {
-  const config = await loadConfig();
-
-  // Parse booleans and numbers
-  let parsed: unknown = value;
-  if (value === 'true') parsed = true;
-  else if (value === 'false') parsed = false;
-  else if (!isNaN(Number(value)) && value.trim() !== '') parsed = Number(value);
-
-  (config as unknown as Record<string, unknown>)[key] = parsed;
-  await saveConfig(config);
-  console.log(`  ✔ Set ${key} = ${String(parsed)}`);
-}

package/src/commands/create.ts

@@ -1,204 +0,0 @@
-/**
- * @module commands/create
- * The main "create workspace" command — the core NexusFlow workflow.
- * Mirrors and enhances the user's existing Create-Workspace.ps1 script.
- */
-
-import chalk from 'chalk';
-import ora from 'ora';
-import path from 'node:path';
-import { execa } from 'execa';
-
-import { confirm } from '@inquirer/prompts';
-
-import { loadConfig } from '../core/config.js';
-import { scanForRepos } from '../core/scanner.js';
-import { createWorkspace } from '../core/workspace.js';
-import { generateContextFiles } from '../generators/index.js';
-import { analyzeAllRepos } from '../analyzers/index.js';
-import { detectAIAssistants } from '../utils/detect-ai.js';
-import { detectEditors } from '../utils/detect-editors.js';
-import {
-  promptBranchName,
-  promptDescription,
-  promptSelectRepos,
-  promptSelectAI,
-  promptSelectEditor,
-} from '../utils/prompts.js';
-import type { Feature, WorkspaceContext } from '../types.js';
-import { suggestWorkflow } from '../utils/workflow-advisor.js';
-
-/**
- * Executes the full "create workspace" flow:
- * 1. Prompt for branch name
- * 2. Prompt for feature description
- * 3. Scan for repos and let user pick
- * 4. Detect AI assistants and let user pick
- * 5. Create workspace with git worktrees
- * 6. Generate AI context files
- * 7. Optionally open in editor
- */
-export async function createCommand(): Promise<void> {
-  console.log(
-    chalk.bold.cyan('\n🚀 NexusFlow — Create Feature Workspace\n'),
-  );
-
-  // ── 1. Branch name ──────────────────────────────────────────────────
-  const branchName = await promptBranchName();
-
-  // ── 2. Feature description ──────────────────────────────────────────
-  const description = await promptDescription();
-
-  // ── 3. Scan for repos ───────────────────────────────────────────────
-  const config = await loadConfig();
-  const spinner = ora('Scanning for projects...').start();
-
-  let repos;
-  try {
-    repos = await scanForRepos(config.devDir, config.scanDepth);
-    spinner.succeed(`Found ${chalk.bold(repos.length)} projects in ${config.devDir}`);
-  } catch (error) {
-    spinner.fail('Failed to scan for projects');
-    throw error;
-  }
-
-  if (repos.length === 0) {
-    console.log(chalk.yellow('No git projects found. Check your devDir setting.'));
-    return;
-  }
-
-  // ── 4. Select repos ────────────────────────────────────────────────
-  const selectedRepos = await promptSelectRepos(repos);
-  if (selectedRepos.length === 0) {
-    console.log(chalk.yellow('No projects selected. Exiting.'));
-    return;
-  }
-
-  console.log(
-    chalk.dim(`  Selected: ${selectedRepos.map((r) => r.name).join(', ')}`),
-  );
-
-  // ── 5. Detect and select AI assistants ──────────────────────────────
-  const detectedAI = await detectAIAssistants();
-  const selectedAI = await promptSelectAI(detectedAI);
-
-  const localLlmEnabled = config.localLlm?.enabled
-    ? await confirm({ message: 'Enable Local AI Co-processor in this workspace context?', default: true })
-    : false;
-
-  // ── 5.5. Suggest workflow strategy ───────────────────────────────
-  const workflowSpinner = ora('Suggesting teamwork collaboration strategy...').start();
-  let teamworkInstructions = '';
-  try {
-    const suggestion = await suggestWorkflow(description, selectedRepos, config.localLlm);
-    teamworkInstructions = suggestion.customInstructions;
-    workflowSpinner.succeed(`Auto-selected strategy for ${chalk.bold(suggestion.difficulty)} difficulty task`);
-  } catch (err) {
-    workflowSpinner.fail('Failed to suggest teamwork strategy');
-  }
-
-  // ── 6. Create workspace ─────────────────────────────────────────────
-  const workspacePath = path.join(config.workspacesDir, branchName);
-  const feature: Feature = {
-    id: branchName,
-    branchName,
-    description,
-    repos: selectedRepos.map((r) => path.join(workspacePath, r.name)),
-    originalRepos: selectedRepos.map((r) => r.path),
-    assistants: selectedAI,
-    workspacePath,
-    createdAt: new Date().toISOString(),
-    localLlmEnabled,
-    teamworkInstructions,
-  };
-
-  const wsSpinner = ora('Creating workspace with git worktrees...').start();
-  try {
-    await createWorkspace(feature, selectedRepos);
-    wsSpinner.succeed(`Workspace created at ${chalk.bold(workspacePath)}`);
-  } catch (error) {
-    wsSpinner.fail('Failed to create workspace');
-    const message = error instanceof Error ? error.message : String(error);
-    console.error(chalk.red(`  ${message}`));
-    return;
-  }
-
-  // ── 7. Analyze projects ─────────────────────────────────────────────
-  console.log(chalk.cyan('\nAnalyzing projects...'));
-  const workspaceRepos = selectedRepos.map((repo) => ({
-    ...repo,
-    path: path.join(workspacePath, repo.name),
-  }));
-  const analysis = await analyzeAllRepos(workspaceRepos);
-
-  // ── 8. Generate AI context files ────────────────────────────────────
-  const ctx: WorkspaceContext = { feature, repos: workspaceRepos, analysis, localLlm: config.localLlm };
-  console.log(chalk.cyan('\nGenerating AI context files...'));
-  await generateContextFiles(ctx, selectedAI, workspacePath);
-
-  // Monolithic XML context packing removed.
-
-  // ── 8. Open in editor ───────────────────────────────────────────────
-  const detectedEditors = await detectEditors();
-  const editor = await promptSelectEditor(detectedEditors);
-
-  if (editor) {
-    const editorSpinner = ora(`Opening in ${editor.name}...`).start();
-    try {
-      await execa(editor.command, [workspacePath], {
-        stdio: 'ignore',
-        shell: process.platform === 'win32',
-      });
-      editorSpinner.succeed(`Opened in ${editor.name}`);
-    } catch {
-      editorSpinner.warn(
-        `Could not open ${editor.name}. Open manually:\n  ${chalk.dim(`cd "${workspacePath}"`)}`,
-      );
-    }
-  }
-
-  // ── Done ────────────────────────────────────────────────────────────
-  console.log(
-    chalk.bold.green('\n✅ Workspace ready!\n'),
-  );
-  console.log(`  ${chalk.dim('Path:')}  ${workspacePath}`);
-  console.log(`  ${chalk.dim('Branch:')} ${branchName}`);
-  console.log(`  ${chalk.dim('Repos:')}  ${selectedRepos.map((r) => r.name).join(', ')}`);
-  console.log(`  ${chalk.dim('AI:')}     ${selectedAI.join(', ')}`);
-  console.log(`  ${chalk.dim('Local AI:')} ${localLlmEnabled ? 'Enabled' : 'Disabled'}`);
-  console.log(
-    `\n  ${chalk.dim('To navigate:')} cd "${workspacePath}"`,
-  );
-  console.log();
-
-  // ── 9. Start AI Assistant Session ───────────────────────────────────
-  if (selectedAI.length > 0) {
-    const assistant = selectedAI[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`));
-
-      let cmd = 'agy';
-      if (assistant === 'claude') cmd = 'claude';
-      else if (assistant === 'codex') cmd = 'codex';
-      else if (assistant === 'copilot') cmd = 'copilot';
-
-      try {
-        await execa(cmd, [], {
-          cwd: workspacePath,
-          stdio: 'inherit',
-          shell: process.platform === 'win32',
-        });
-        console.log(chalk.green(`\n👋 Exited ${assistant} session.`));
-      } catch {
-        console.log(
-          chalk.yellow(`\n⚠️  Could not start ${assistant}. Please start it manually:\n  ${chalk.dim(`cd "${workspacePath}" && ${cmd}`)}`)
-        );
-      }
-    }
-  }
-}

package/src/commands/desktop.ts

@@ -1,128 +0,0 @@
-/**
- * @module commands/desktop
- * Launches the NexusFlow desktop application (Neutralinojs).
- */
-
-import { spawn } from 'node:child_process';
-import { existsSync } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import chalk from 'chalk';
-
-/**
- * Resolves the workspace root directory.
- *
- * Assumes the standard NexusFlow workspace layout where the `desktop/`
- * project is a sibling of the `NexusFlow/` project under the same
- * workspace root:
- *
- *   <workspace-root>/
- *     NexusFlow/          ← this CLI project
- *     desktop/            ← Neutralinojs desktop app
- *       dist/nexusflow-desktop/<platform-binary>
- *
- * At runtime this file is compiled to `NexusFlow/dist/commands/desktop.js`,
- * so the workspace root is three levels up.
- */
-function resolveWorkspaceRoot(): string {
-  const thisDir = path.dirname(fileURLToPath(import.meta.url));
-  return path.resolve(thisDir, '..', '..', '..');
-}
-
-/**
- * Returns the desktop dist directory path.
- */
-function getDesktopDistDir(): string {
-  return path.join(resolveWorkspaceRoot(), 'desktop', 'dist', 'nexusflow-desktop');
-}
-
-/**
- * Resolves the platform-specific binary path for the desktop app.
- *
- * On macOS the architecture is taken into account:
- * - arm64 → `nexusflow-desktop-mac_arm64`
- * - x64   → prefers `nexusflow-desktop-mac_x64`, falls back to universal
- */
-function findDesktopBinary(): string | null {
-  const desktopDistDir = getDesktopDistDir();
-  const platform = process.platform;
-  const arch = process.arch;
-  let binaryName: string;
-
-  if (platform === 'win32') {
-    binaryName = 'nexusflow-desktop-win_x64.exe';
-  } else if (platform === 'darwin') {
-    if (arch === 'arm64') {
-      binaryName = 'nexusflow-desktop-mac_arm64';
-    } else {
-      // Prefer smaller x64 binary, fall back to universal
-      const x64Path = path.join(desktopDistDir, 'nexusflow-desktop-mac_x64');
-      binaryName = existsSync(x64Path) ? 'nexusflow-desktop-mac_x64' : 'nexusflow-desktop-mac_universal';
-    }
-  } else {
-    // Linux — detect ARM architectures
-    if (arch === 'arm64') {
-      binaryName = 'nexusflow-desktop-linux_arm64';
-    } else if (arch === 'arm') {
-      binaryName = 'nexusflow-desktop-linux_armhf';
-    } else {
-      binaryName = 'nexusflow-desktop-linux_x64';
-    }
-  }
-
-  const fullPath = path.join(desktopDistDir, binaryName);
-  return existsSync(fullPath) ? fullPath : null;
-}
-
-/**
- * Returns the expected binary path for display in the "not found" message.
- */
-function getExpectedBinaryPath(): string {
-  const desktopDistDir = getDesktopDistDir();
-  switch (process.platform) {
-    case 'win32':
-      return path.join(desktopDistDir, 'nexusflow-desktop-win_x64.exe');
-    case 'darwin':
-      return path.join(desktopDistDir, 'nexusflow-desktop-mac_*');
-    case 'linux':
-    default:
-      return path.join(desktopDistDir, 'nexusflow-desktop-linux_x64');
-  }
-}
-
-/**
- * Launches the NexusFlow desktop application.
- *
- * Spawns the process detached and unrefs it so the CLI exits immediately
- * while the desktop app keeps running.
- */
-export async function desktopCommand(): Promise<void> {
-  console.log(chalk.bold.cyan('\n🖥️  NexusFlow — Desktop App\n'));
-
-  const binaryPath = findDesktopBinary();
-
-  if (!binaryPath) {
-    const expectedPath = getExpectedBinaryPath();
-    console.log(chalk.yellow('Desktop binary not found at:'));
-    console.log(chalk.dim(`  ${expectedPath}\n`));
-    console.log(chalk.white('To build it, run:\n'));
-    console.log(chalk.green('  cd desktop && npm install && npm run build\n'));
-    return;
-  }
-
-  console.log(chalk.dim(`Launching ${path.basename(binaryPath)}…`));
-
-  const child = spawn(binaryPath, [], {
-    detached: true,
-    stdio: 'ignore',
-    cwd: path.dirname(binaryPath), // Required: Neutralino looks for resources.neu in cwd
-  });
-
-  child.on('error', (err) => {
-    console.error(chalk.red(`  ✖ Desktop app process error: ${err.message}`));
-  });
-
-  child.unref();
-
-  console.log(chalk.green('Desktop app launched successfully.\n'));
-}

package/src/commands/diff.ts

@@ -1,125 +0,0 @@
-/**
- * @module commands/diff
- * Displays diff summaries across all repositories in a workspace.
- */
-
-import chalk from 'chalk';
-import { select } 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, getRepoStatus, getDiffSummary } from '../utils/multi-git.js';
-
-/**
- * Executes the diff command.
- *
- * @param workspaceArg - Optional workspace path.
- */
-export async function diffCommand(workspaceArg?: string): Promise<void> {
-  console.log(chalk.bold.cyan('\n🔍 NexusFlow — Workspace Diff Summary\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.'));
-    return;
-  }
-
-  const repos = await getWorkspaceRepos(workspacePath);
-  let cleanCount = 0;
-
-  const results: Array<{
-    name: string;
-    filesChanged: number;
-    additions: number;
-    deletions: number;
-    summary: string;
-  }> = [];
-
-  for (const repo of repos) {
-    const status = await getRepoStatus(repo.path);
-    if (!status.hasChanges) {
-      cleanCount++;
-      continue;
-    }
-
-    const diff = await getDiffSummary(repo.path);
-    results.push({
-      name: repo.name,
-      filesChanged: status.changedFiles.length,
-      additions: diff.additions,
-      deletions: diff.deletions,
-      summary: diff.summary,
-    });
-  }
-
-  if (results.length === 0) {
-    console.log(chalk.green('✅ All repositories are clean.\n'));
-    return;
-  }
-
-  // Print unified table
-  console.log(chalk.bold('Repository'.padEnd(25) + ' | ' + 'Files'.padEnd(6) + ' | ' + 'Additions'.padEnd(10) + ' | ' + 'Deletions'.padEnd(10)));
-  console.log(chalk.dim('─'.repeat(61)));
-
-  for (const res of results) {
-    const fileStr = res.filesChanged.toString().padEnd(6);
-    const addStr = `+${res.additions}`.padEnd(10);
-    const delStr = `-${res.deletions}`.padEnd(10);
-    console.log(
-      chalk.bold(res.name.padEnd(25)) + ' | ' +
-      fileStr + ' | ' +
-      chalk.green(addStr) + ' | ' +
-      chalk.red(delStr)
-    );
-  }
-
-  console.log('\n' + chalk.bold('Detailed Diff Stats:'));
-  for (const res of results) {
-    console.log(`\n📂 ${chalk.bold.cyan(res.name)}:`);
-    console.log(chalk.dim(res.summary.split('\n').map(l => `  ${l}`).join('\n')));
-  }
-
-  console.log();
-}
-
-/**
- * Resolves 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 select({
-    message: 'Select a workspace to view diff:',
-    choices: workspaces.map((ws) => ({
-      name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
-      value: ws.workspacePath,
-    })),
-  });
-
-  return selected;
-}