@mrpatronz/nexusflow 0.2.17 → 0.2.18

package/src/commands/commands.test.ts

@@ -1,155 +1,156 @@
-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',
+        undefined
+      );
+    });
+  });
+
+  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); // covers .code-workspace + artifact checks
+      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();
+    });
+  });
+});

package/src/commands/commit.ts

@@ -1,131 +1,131 @@
-/**
- * @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;
-}
+/**
+ * @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

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