@mrpatronz/nexusflow 0.2.13 → 0.2.17

package/src/commands/add-repo.ts

@@ -1,157 +1,157 @@
-/**
- * @module commands/add-repo
- * Adds a repository to an existing NexusFlow workspace.
- */
-
-import chalk from 'chalk';
-import ora from 'ora';
-import { select, search } from '@inquirer/prompts';
-import * as path from 'node:path';
-
-import { loadConfig } from '../core/config.js';
-import { scanForRepos } from '../core/scanner.js';
-import { listWorkspaces, loadFeatureConfig, addRepoToWorkspace } from '../core/workspace.js';
-
-/**
- * Executes the add-repo command.
- *
- * @param repoPathArg - Optional repository path to add.
- * @param workspaceArg - Optional workspace path or name.
- */
-export async function addRepoCommand(
-  repoPathArg?: string,
-  workspaceArg?: string,
-): Promise<void> {
-  console.log(chalk.bold.cyan('\n➕ NexusFlow — Adding Repository to Workspace\n'));
-
-  const config = await loadConfig();
-
-  // 1. Resolve workspace
-  let workspacePath: string | null = null;
-  let workspaceName = '';
-
-  if (workspaceArg) {
-    const resolvedPath = path.isAbsolute(workspaceArg)
-      ? workspaceArg
-      : path.resolve(config.workspacesDir, workspaceArg);
-
-    try {
-      const manifest = await loadFeatureConfig(resolvedPath);
-      if (manifest) {
-        workspacePath = resolvedPath;
-        workspaceName = manifest.branchName;
-      }
-    } catch {}
-
-    if (!workspacePath) {
-      const directPath = path.join(config.workspacesDir, workspaceArg);
-      const manifest = await loadFeatureConfig(directPath);
-      if (manifest) {
-        workspacePath = directPath;
-        workspaceName = manifest.branchName;
-      } else {
-        console.error(chalk.red(`✖ Invalid workspace: No nexusflow.json found at ${workspaceArg}`));
-        return;
-      }
-    }
-  } else {
-    const cwdFeature = await loadFeatureConfig(process.cwd());
-    if (cwdFeature) {
-      workspacePath = cwdFeature.workspacePath;
-      workspaceName = cwdFeature.branchName;
-    } else {
-      const workspaces = await listWorkspaces(config.workspacesDir);
-      if (workspaces.length === 0) {
-        console.log(chalk.yellow('No workspaces found.\n'));
-        return;
-      }
-
-      const selected = await search({
-        message: 'Search and select a workspace to add a repository to:',
-        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 = selected.workspacePath;
-      workspaceName = selected.branchName;
-    }
-  }
-
-  if (!workspacePath) return;
-
-  const feature = await loadFeatureConfig(workspacePath);
-  if (!feature) {
-    console.error(chalk.red('✖ Failed to load workspace configuration.'));
-    return;
-  }
-
-  // 2. Resolve repository to add
-  let repoPathToAdd = '';
-
-  if (repoPathArg) {
-    repoPathToAdd = path.resolve(repoPathArg);
-  } else {
-    const scanSpinner = ora('Scanning for projects...').start();
-    let repos = [];
-    try {
-      repos = await scanForRepos(config.devDir, config.scanDepth);
-      scanSpinner.succeed(`Found ${chalk.bold(repos.length)} projects in ${config.devDir}`);
-    } catch (error) {
-      scanSpinner.fail('Failed to scan for projects');
-      console.error(error);
-      return;
-    }
-
-    const availableRepos = repos.filter(
-      (r) => !feature.repos.includes(r.path)
-    );
-
-    if (availableRepos.length === 0) {
-      console.log(chalk.yellow('All scanned repositories are already in the workspace.\n'));
-      return;
-    }
-
-    repoPathToAdd = await search({
-      message: 'Search and select a repository to add:',
-      source: async (input) => {
-        const query = (input || '').toLowerCase();
-        const filtered = availableRepos.filter(
-          (r) =>
-            r.name.toLowerCase().includes(query) ||
-            r.path.toLowerCase().includes(query)
-        );
-        return filtered.map((r) => ({
-          name: `${r.name} ${chalk.dim(`(${r.path})`)}`,
-          value: r.path,
-        }));
-      },
-    });
-  }
-
-  const repoName = path.basename(repoPathToAdd);
-  const spinner = ora(`Adding ${repoName} to workspace ${workspaceName}...`).start();
-
-  try {
-    await addRepoToWorkspace(workspacePath, repoPathToAdd);
-    spinner.succeed(`Successfully added ${chalk.bold(repoName)} to workspace ${chalk.bold(workspaceName)}`);
-    console.log(chalk.dim('  - Checked out git worktree'));
-    console.log(chalk.dim('  - Updated nexusflow.json and .gitignore'));
-    console.log(chalk.dim('  - Re-analyzed workspace codebases'));
-    console.log(chalk.dim('  - Regenerated LLM instruction context files'));
-    console.log(chalk.dim('  - Repacked codebase context using Repomix'));
-    console.log();
-  } catch (error) {
-    spinner.fail(`Failed to add repository: ${error instanceof Error ? error.message : String(error)}`);
-    console.log();
-  }
-}
+/**
+ * @module commands/add-repo
+ * Adds a repository to an existing NexusFlow workspace.
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+import { select, search } from '@inquirer/prompts';
+import * as path from 'node:path';
+
+import { loadConfig } from '../core/config.js';
+import { scanForRepos } from '../core/scanner.js';
+import { listWorkspaces, loadFeatureConfig, addRepoToWorkspace } from '../core/workspace.js';
+
+/**
+ * Executes the add-repo command.
+ *
+ * @param repoPathArg - Optional repository path to add.
+ * @param workspaceArg - Optional workspace path or name.
+ */
+export async function addRepoCommand(
+  repoPathArg?: string,
+  workspaceArg?: string,
+): Promise<void> {
+  console.log(chalk.bold.cyan('\n➕ NexusFlow — Adding Repository to Workspace\n'));
+
+  const config = await loadConfig();
+
+  // 1. Resolve workspace
+  let workspacePath: string | null = null;
+  let workspaceName = '';
+
+  if (workspaceArg) {
+    const resolvedPath = path.isAbsolute(workspaceArg)
+      ? workspaceArg
+      : path.resolve(config.workspacesDir, workspaceArg);
+
+    try {
+      const manifest = await loadFeatureConfig(resolvedPath);
+      if (manifest) {
+        workspacePath = resolvedPath;
+        workspaceName = manifest.branchName;
+      }
+    } catch {}
+
+    if (!workspacePath) {
+      const directPath = path.join(config.workspacesDir, workspaceArg);
+      const manifest = await loadFeatureConfig(directPath);
+      if (manifest) {
+        workspacePath = directPath;
+        workspaceName = manifest.branchName;
+      } else {
+        console.error(chalk.red(`✖ Invalid workspace: No nexusflow.json found at ${workspaceArg}`));
+        return;
+      }
+    }
+  } else {
+    const cwdFeature = await loadFeatureConfig(process.cwd());
+    if (cwdFeature) {
+      workspacePath = cwdFeature.workspacePath;
+      workspaceName = cwdFeature.branchName;
+    } else {
+      const workspaces = await listWorkspaces(config.workspacesDir);
+      if (workspaces.length === 0) {
+        console.log(chalk.yellow('No workspaces found.\n'));
+        return;
+      }
+
+      const selected = await search({
+        message: 'Search and select a workspace to add a repository to:',
+        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 = selected.workspacePath;
+      workspaceName = selected.branchName;
+    }
+  }
+
+  if (!workspacePath) return;
+
+  const feature = await loadFeatureConfig(workspacePath);
+  if (!feature) {
+    console.error(chalk.red('✖ Failed to load workspace configuration.'));
+    return;
+  }
+
+  // 2. Resolve repository to add
+  let repoPathToAdd = '';
+
+  if (repoPathArg) {
+    repoPathToAdd = path.resolve(repoPathArg);
+  } else {
+    const scanSpinner = ora('Scanning for projects...').start();
+    let repos = [];
+    try {
+      repos = await scanForRepos(config.devDir, config.scanDepth);
+      scanSpinner.succeed(`Found ${chalk.bold(repos.length)} projects in ${config.devDir}`);
+    } catch (error) {
+      scanSpinner.fail('Failed to scan for projects');
+      console.error(error);
+      return;
+    }
+
+    const availableRepos = repos.filter(
+      (r) => !feature.repos.includes(r.path)
+    );
+
+    if (availableRepos.length === 0) {
+      console.log(chalk.yellow('All scanned repositories are already in the workspace.\n'));
+      return;
+    }
+
+    repoPathToAdd = await search({
+      message: 'Search and select a repository to add:',
+      source: async (input) => {
+        const query = (input || '').toLowerCase();
+        const filtered = availableRepos.filter(
+          (r) =>
+            r.name.toLowerCase().includes(query) ||
+            r.path.toLowerCase().includes(query)
+        );
+        return filtered.map((r) => ({
+          name: `${r.name} ${chalk.dim(`(${r.path})`)}`,
+          value: r.path,
+        }));
+      },
+    });
+  }
+
+  const repoName = path.basename(repoPathToAdd);
+  const spinner = ora(`Adding ${repoName} to workspace ${workspaceName}...`).start();
+
+  try {
+    await addRepoToWorkspace(workspacePath, repoPathToAdd);
+    spinner.succeed(`Successfully added ${chalk.bold(repoName)} to workspace ${chalk.bold(workspaceName)}`);
+    console.log(chalk.dim('  - Checked out git worktree'));
+    console.log(chalk.dim('  - Updated nexusflow.json and .gitignore'));
+    console.log(chalk.dim('  - Re-analyzed workspace codebases'));
+    console.log(chalk.dim('  - Regenerated LLM instruction context files'));
+    console.log(chalk.dim('  - Repacked codebase context using Repomix'));
+    console.log();
+  } catch (error) {
+    spinner.fail(`Failed to add repository: ${error instanceof Error ? error.message : String(error)}`);
+    console.log();
+  }
+}

package/src/commands/commands.test.ts

@@ -1,155 +1,155 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import * as fs from 'node:fs/promises';
-import * as path from 'node:path';
-import { handoffCommand } from './handoff.js';
-import { refreshCommand } from './refresh.js';
-import { doctorCommand } from './doctor.js';
-import * as workspace from '../core/workspace.js';
-import * as multiGit from '../utils/multi-git.js';
-import * as analyzers from '../analyzers/index.js';
-import * as generators from '../generators/index.js';
-
-vi.mock('node:fs/promises');
-vi.mock('execa');
-vi.mock('../core/workspace.js');
-vi.mock('../utils/multi-git.js');
-vi.mock('../analyzers/index.js');
-vi.mock('../generators/index.js');
-
-describe('NexusFlow CLI New Commands unit tests', () => {
-  const mockWorkspacePath = path.resolve('/mock/workspace');
-  const repo1Path = path.join(mockWorkspacePath, 'repo-1');
-
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  describe('handoffCommand', () => {
-    it('should generate a handoff bundle with repository status, branch and suggested files', async () => {
-      const mockFeature = {
-        id: 'test-feature',
-        branchName: 'test-feature-branch',
-        description: 'Test Feature description',
-        repos: [repo1Path],
-        originalRepos: [path.resolve('/mock/repo-1')],
-        assistants: ['claude' as const],
-        workspacePath: mockWorkspacePath,
-        createdAt: new Date().toISOString(),
-      };
-
-      vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(mockFeature);
-      vi.spyOn(multiGit, 'getRepoStatus').mockResolvedValue({
-        hasChanges: true,
-        changedFiles: ['src/file1.ts'],
-        summary: '1 file changed',
-      });
-      
-      const mockAnalysis = new Map();
-      mockAnalysis.set(repo1Path, {
-        name: 'repo-1',
-        path: repo1Path,
-        techStack: { languages: ['typescript'], frameworks: [], buildTools: [], projectType: 'backend' },
-        endpoints: [],
-        dependencies: [],
-        ports: [],
-        readmeSummary: 'README summary',
-        existingAIConfigs: [],
-      });
-      vi.spyOn(analyzers, 'analyzeAllRepos').mockResolvedValue(mockAnalysis);
-
-      const writtenFiles: Record<string, string> = {};
-      vi.spyOn(fs, 'writeFile').mockImplementation(async (filePath: any, content: any) => {
-        writtenFiles[path.resolve(filePath as string)] = content as string;
-        return Promise.resolve();
-      });
-
-      // Run handoff command
-      await handoffCommand(mockWorkspacePath);
-
-      const expectedHandoffPath = path.resolve(path.join(mockWorkspacePath, 'nexusflow-handoff.md'));
-      expect(fs.writeFile).toHaveBeenCalled();
-      expect(writtenFiles[expectedHandoffPath]).toBeDefined();
-
-      const content = writtenFiles[expectedHandoffPath]!;
-      expect(content).toContain('# NexusFlow Handoff Bundle — test-feature-branch');
-      expect(content).toContain('repo-1');
-      expect(content).toContain('1 file changed');
-      expect(content).toContain('src/file1.ts');
-    });
-  });
-
-  describe('refreshCommand', () => {
-    it('should trigger context regeneration and optional repack', async () => {
-      const mockFeature = {
-        id: 'test-feature',
-        branchName: 'test-feature-branch',
-        description: 'Test Feature description',
-        repos: [repo1Path],
-        originalRepos: [path.resolve('/mock/repo-1')],
-        assistants: ['claude' as const],
-        workspacePath: mockWorkspacePath,
-        createdAt: new Date().toISOString(),
-      };
-
-      vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(mockFeature);
-      vi.spyOn(analyzers, 'analyzeAllRepos').mockResolvedValue(new Map());
-      vi.spyOn(generators, 'generateContextFiles').mockResolvedValue(undefined);
-
-      // Run refresh command with repo filter
-      await refreshCommand({ repo: 'repo-1' }, mockWorkspacePath);
-
-      expect(analyzers.analyzeAllRepos).toHaveBeenCalled();
-      expect(generators.generateContextFiles).toHaveBeenCalledWith(
-        expect.any(Object),
-        expect.any(Array),
-        mockWorkspacePath,
-        'repo-1'
-      );
-    });
-  });
-
-  describe('doctorCommand', () => {
-    it('should complete health check successfully', async () => {
-      const mockFeature = {
-        id: 'test-feature',
-        branchName: 'test-feature-branch',
-        description: 'Test Feature description',
-        repos: [repo1Path],
-        originalRepos: [path.resolve('/mock/repo-1')],
-        assistants: ['claude' as const],
-        workspacePath: mockWorkspacePath,
-        createdAt: new Date().toISOString(),
-      };
-
-      vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(mockFeature);
-      vi.spyOn(fs, 'stat').mockResolvedValue({ isDirectory: () => true } as any);
-      vi.spyOn(multiGit, 'getRepoStatus').mockResolvedValue({
-        hasChanges: false,
-        changedFiles: [],
-        summary: 'Clean',
-      });
-
-      const mockAnalysis = new Map();
-      mockAnalysis.set(repo1Path, {
-        name: 'repo-1',
-        path: repo1Path,
-        techStack: { languages: ['typescript'], frameworks: [], buildTools: [], projectType: 'backend' },
-        endpoints: [],
-        dependencies: [],
-        ports: [],
-        readmeSummary: 'README summary',
-        existingAIConfigs: [],
-      });
-      vi.spyOn(analyzers, 'analyzeAllRepos').mockResolvedValue(mockAnalysis);
-      vi.spyOn(fs, 'access').mockResolvedValue(undefined);
-      vi.spyOn(fs, 'readFile').mockResolvedValue(JSON.stringify({ "search.useIgnoreFiles": false }));
-
-      // Run doctor command
-      await doctorCommand(mockWorkspacePath);
-
-      expect(workspace.loadFeatureConfig).toHaveBeenCalledWith(mockWorkspacePath);
-      expect(fs.stat).toHaveBeenCalledWith(repo1Path);
-      expect(analyzers.analyzeAllRepos).toHaveBeenCalled();
-    });
-  });
-});
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { handoffCommand } from './handoff.js';
+import { refreshCommand } from './refresh.js';
+import { doctorCommand } from './doctor.js';
+import * as workspace from '../core/workspace.js';
+import * as multiGit from '../utils/multi-git.js';
+import * as analyzers from '../analyzers/index.js';
+import * as generators from '../generators/index.js';
+
+vi.mock('node:fs/promises');
+vi.mock('execa');
+vi.mock('../core/workspace.js');
+vi.mock('../utils/multi-git.js');
+vi.mock('../analyzers/index.js');
+vi.mock('../generators/index.js');
+
+describe('NexusFlow CLI New Commands unit tests', () => {
+  const mockWorkspacePath = path.resolve('/mock/workspace');
+  const repo1Path = path.join(mockWorkspacePath, 'repo-1');
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  describe('handoffCommand', () => {
+    it('should generate a handoff bundle with repository status, branch and suggested files', async () => {
+      const mockFeature = {
+        id: 'test-feature',
+        branchName: 'test-feature-branch',
+        description: 'Test Feature description',
+        repos: [repo1Path],
+        originalRepos: [path.resolve('/mock/repo-1')],
+        assistants: ['claude' as const],
+        workspacePath: mockWorkspacePath,
+        createdAt: new Date().toISOString(),
+      };
+
+      vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(mockFeature);
+      vi.spyOn(multiGit, 'getRepoStatus').mockResolvedValue({
+        hasChanges: true,
+        changedFiles: ['src/file1.ts'],
+        summary: '1 file changed',
+      });
+      
+      const mockAnalysis = new Map();
+      mockAnalysis.set(repo1Path, {
+        name: 'repo-1',
+        path: repo1Path,
+        techStack: { languages: ['typescript'], frameworks: [], buildTools: [], projectType: 'backend' },
+        endpoints: [],
+        dependencies: [],
+        ports: [],
+        readmeSummary: 'README summary',
+        existingAIConfigs: [],
+      });
+      vi.spyOn(analyzers, 'analyzeAllRepos').mockResolvedValue(mockAnalysis);
+
+      const writtenFiles: Record<string, string> = {};
+      vi.spyOn(fs, 'writeFile').mockImplementation(async (filePath: any, content: any) => {
+        writtenFiles[path.resolve(filePath as string)] = content as string;
+        return Promise.resolve();
+      });
+
+      // Run handoff command
+      await handoffCommand(mockWorkspacePath);
+
+      const expectedHandoffPath = path.resolve(path.join(mockWorkspacePath, 'nexusflow-handoff.md'));
+      expect(fs.writeFile).toHaveBeenCalled();
+      expect(writtenFiles[expectedHandoffPath]).toBeDefined();
+
+      const content = writtenFiles[expectedHandoffPath]!;
+      expect(content).toContain('# NexusFlow Handoff Bundle — test-feature-branch');
+      expect(content).toContain('repo-1');
+      expect(content).toContain('1 file changed');
+      expect(content).toContain('src/file1.ts');
+    });
+  });
+
+  describe('refreshCommand', () => {
+    it('should trigger context regeneration and optional repack', async () => {
+      const mockFeature = {
+        id: 'test-feature',
+        branchName: 'test-feature-branch',
+        description: 'Test Feature description',
+        repos: [repo1Path],
+        originalRepos: [path.resolve('/mock/repo-1')],
+        assistants: ['claude' as const],
+        workspacePath: mockWorkspacePath,
+        createdAt: new Date().toISOString(),
+      };
+
+      vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(mockFeature);
+      vi.spyOn(analyzers, 'analyzeAllRepos').mockResolvedValue(new Map());
+      vi.spyOn(generators, 'generateContextFiles').mockResolvedValue(undefined);
+
+      // Run refresh command with repo filter
+      await refreshCommand({ repo: 'repo-1' }, mockWorkspacePath);
+
+      expect(analyzers.analyzeAllRepos).toHaveBeenCalled();
+      expect(generators.generateContextFiles).toHaveBeenCalledWith(
+        expect.any(Object),
+        expect.any(Array),
+        mockWorkspacePath,
+        'repo-1'
+      );
+    });
+  });
+
+  describe('doctorCommand', () => {
+    it('should complete health check successfully', async () => {
+      const mockFeature = {
+        id: 'test-feature',
+        branchName: 'test-feature-branch',
+        description: 'Test Feature description',
+        repos: [repo1Path],
+        originalRepos: [path.resolve('/mock/repo-1')],
+        assistants: ['claude' as const],
+        workspacePath: mockWorkspacePath,
+        createdAt: new Date().toISOString(),
+      };
+
+      vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(mockFeature);
+      vi.spyOn(fs, 'stat').mockResolvedValue({ isDirectory: () => true } as any);
+      vi.spyOn(multiGit, 'getRepoStatus').mockResolvedValue({
+        hasChanges: false,
+        changedFiles: [],
+        summary: 'Clean',
+      });
+
+      const mockAnalysis = new Map();
+      mockAnalysis.set(repo1Path, {
+        name: 'repo-1',
+        path: repo1Path,
+        techStack: { languages: ['typescript'], frameworks: [], buildTools: [], projectType: 'backend' },
+        endpoints: [],
+        dependencies: [],
+        ports: [],
+        readmeSummary: 'README summary',
+        existingAIConfigs: [],
+      });
+      vi.spyOn(analyzers, 'analyzeAllRepos').mockResolvedValue(mockAnalysis);
+      vi.spyOn(fs, 'access').mockResolvedValue(undefined);
+      vi.spyOn(fs, 'readFile').mockResolvedValue(JSON.stringify({ "search.useIgnoreFiles": false }));
+
+      // Run doctor command
+      await doctorCommand(mockWorkspacePath);
+
+      expect(workspace.loadFeatureConfig).toHaveBeenCalledWith(mockWorkspacePath);
+      expect(fs.stat).toHaveBeenCalledWith(repo1Path);
+      expect(analyzers.analyzeAllRepos).toHaveBeenCalled();
+    });
+  });
+});