@mrpatronz/nexusflow 0.2.12 → 0.2.17

package/src/commands/create.ts

@@ -1,207 +1,207 @@
-/**
- * @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 { packWorkspace } from '../core/packer.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';
-
-/**
- * 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;
-
-  // ── 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,
-  };
-
-  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);
-
-  // ── 8.5. Pack codebase context ──────────────────────────────────────
-  if (config.packContextXml) {
-    const packSpinner = ora('Packing codebase context with Repomix...').start();
-    try {
-      const packResult = await packWorkspace(workspacePath);
-      const filesCount = packResult.outputPaths?.length || 1;
-      packSpinner.succeed(
-        `Packed codebase context into ${filesCount} file(s) (${packResult.totalFiles} files total, ${(packResult.fileSize / 1024).toFixed(2)} KB)`
-      );
-    } catch (error) {
-      packSpinner.fail('Failed to pack codebase context');
-      console.error(chalk.red(`  ${error}`));
-    }
-  } else {
-    console.log(chalk.gray('\n  ○ Skipping codebase context packing (packContextXml is disabled)'));
-  }
-
-  // ── 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}`)}`)
-        );
-      }
-    }
-  }
-}
+/**
+ * @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 { packWorkspace } from '../core/packer.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';
+
+/**
+ * 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;
+
+  // ── 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,
+  };
+
+  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);
+
+  // ── 8.5. Pack codebase context ──────────────────────────────────────
+  if (config.packContextXml) {
+    const packSpinner = ora('Packing codebase context with Repomix...').start();
+    try {
+      const packResult = await packWorkspace(workspacePath);
+      const filesCount = packResult.outputPaths?.length || 1;
+      packSpinner.succeed(
+        `Packed codebase context into ${filesCount} file(s) (${packResult.totalFiles} files total, ${(packResult.fileSize / 1024).toFixed(2)} KB)`
+      );
+    } catch (error) {
+      packSpinner.fail('Failed to pack codebase context');
+      console.error(chalk.red(`  ${error}`));
+    }
+  } else {
+    console.log(chalk.gray('\n  ○ Skipping codebase context packing (packContextXml is disabled)'));
+  }
+
+  // ── 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

@@ -0,0 +1,128 @@
+/**
+ * @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'));
+}