@mrpatronz/nexusflow 0.2.13 → 0.2.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (186) hide show
  1. package/.github/dependabot.yml +52 -52
  2. package/.github/workflows/dependabot-merge.yml +53 -0
  3. package/.github/workflows/release.yml +112 -100
  4. package/.vscode/launch.json +17 -17
  5. package/.vscode/tasks.json +17 -17
  6. package/GETTING_STARTED.md +114 -109
  7. package/README.md +336 -311
  8. package/desktop/build-installer.js +228 -0
  9. package/desktop/build.js +118 -0
  10. package/desktop/installer/nexusflow.iss +35 -0
  11. package/desktop/neutralino.config.json +39 -0
  12. package/desktop/package-lock.json +1060 -0
  13. package/desktop/package.json +14 -0
  14. package/dist/commands/desktop.d.ts +12 -0
  15. package/dist/commands/desktop.d.ts.map +1 -0
  16. package/dist/commands/desktop.js +119 -0
  17. package/dist/commands/desktop.js.map +1 -0
  18. package/dist/commands/sync.d.ts.map +1 -1
  19. package/dist/commands/sync.js +1 -3
  20. package/dist/commands/sync.js.map +1 -1
  21. package/dist/commands/tui.d.ts +8 -0
  22. package/dist/commands/tui.d.ts.map +1 -0
  23. package/dist/commands/tui.js +386 -0
  24. package/dist/commands/tui.js.map +1 -0
  25. package/dist/commands/ui.d.ts +3 -1
  26. package/dist/commands/ui.d.ts.map +1 -1
  27. package/dist/commands/ui.js +76 -19
  28. package/dist/commands/ui.js.map +1 -1
  29. package/dist/generators/base.d.ts.map +1 -1
  30. package/dist/generators/base.js +78 -66
  31. package/dist/generators/base.js.map +1 -1
  32. package/dist/generators/codex.js +11 -11
  33. package/dist/generators/copilot.js +17 -17
  34. package/dist/generators/cursor.js +5 -5
  35. package/dist/generators/index.js +50 -50
  36. package/dist/generators/map-generator.js +14 -14
  37. package/dist/generators/skills-generator.js +28 -28
  38. package/dist/gui/app_logo.png +0 -0
  39. package/dist/gui/assets/index-Ct3qq-X4.js +25 -0
  40. package/dist/gui/assets/index-P_ZrgHXg.css +1 -0
  41. package/dist/gui/icons.svg +24 -24
  42. package/dist/gui/index.html +18 -18
  43. package/dist/index.js +43 -0
  44. package/dist/index.js.map +1 -1
  45. package/dist/server.d.ts.map +1 -1
  46. package/dist/server.js +182 -1
  47. package/dist/server.js.map +1 -1
  48. package/dist/server.test.js +78 -0
  49. package/dist/server.test.js.map +1 -1
  50. package/dist/types.d.ts +4 -0
  51. package/dist/types.d.ts.map +1 -1
  52. package/dist/utils/git.d.ts +16 -0
  53. package/dist/utils/git.d.ts.map +1 -1
  54. package/dist/utils/git.js +52 -0
  55. package/dist/utils/git.js.map +1 -1
  56. package/dist/utils/multi-git.d.ts +2 -0
  57. package/dist/utils/multi-git.d.ts.map +1 -1
  58. package/dist/utils/multi-git.js +5 -2
  59. package/dist/utils/multi-git.js.map +1 -1
  60. package/dist/utils/update-check.d.ts +3 -1
  61. package/dist/utils/update-check.d.ts.map +1 -1
  62. package/dist/utils/update-check.js +23 -6
  63. package/dist/utils/update-check.js.map +1 -1
  64. package/dist/utils/workflows.d.ts +11 -0
  65. package/dist/utils/workflows.d.ts.map +1 -0
  66. package/dist/utils/workflows.js +156 -0
  67. package/dist/utils/workflows.js.map +1 -0
  68. package/dist/utils/workflows.test.d.ts +2 -0
  69. package/dist/utils/workflows.test.d.ts.map +1 -0
  70. package/dist/utils/workflows.test.js +86 -0
  71. package/dist/utils/workflows.test.js.map +1 -0
  72. package/extension/media/icon.svg +1 -0
  73. package/extension/package-lock.json +2673 -2811
  74. package/extension/package.json +108 -70
  75. package/extension/src/extension.ts +631 -204
  76. package/extension/tsconfig.json +21 -19
  77. package/gui/README.md +73 -73
  78. package/gui/e2e/wizard.spec.ts +346 -327
  79. package/gui/eslint.config.js +26 -26
  80. package/gui/index.html +17 -17
  81. package/gui/package-lock.json +3079 -3118
  82. package/gui/package.json +36 -36
  83. package/gui/playwright.config.ts +41 -41
  84. package/gui/public/app_logo.png +0 -0
  85. package/gui/public/icons.svg +24 -24
  86. package/gui/src/App.css +1 -1
  87. package/gui/src/App.tsx +3407 -2722
  88. package/gui/src/assets/vite.svg +1 -1
  89. package/gui/src/features/changes/ChangesViewer.tsx +388 -388
  90. package/gui/src/features/knowledge/KnowledgeBase.tsx +84 -84
  91. package/gui/src/features/onboarding/OnboardingWizard.tsx +230 -230
  92. package/gui/src/features/plan/ImplementationPlan.tsx +32 -32
  93. package/gui/src/features/services/ServiceConsole.tsx +250 -250
  94. package/gui/src/features/sessions/SessionHistory.tsx +195 -195
  95. package/gui/src/features/workspace/WorkspaceList.tsx +666 -666
  96. package/gui/src/index.css +152 -110
  97. package/gui/src/main.tsx +94 -10
  98. package/gui/src/types.ts +62 -62
  99. package/gui/tsconfig.app.json +25 -25
  100. package/gui/tsconfig.json +7 -7
  101. package/gui/tsconfig.node.json +24 -24
  102. package/gui/vite.config.ts +12 -12
  103. package/package.json +56 -56
  104. package/resources/workflows/plan-implement-review.md +8 -0
  105. package/resources/workflows/research-verify.md +6 -0
  106. package/resources/workflows/solo-developer.md +3 -0
  107. package/scripts/simulate-workspaces.ts +55 -55
  108. package/src/analyzers/detect-apis.ts +290 -290
  109. package/src/analyzers/detect-deps.ts +315 -315
  110. package/src/analyzers/detect-existing.ts +74 -74
  111. package/src/analyzers/detect-ports.ts +110 -110
  112. package/src/analyzers/index.ts +97 -97
  113. package/src/analyzers/messaging-analyzer.ts +254 -254
  114. package/src/analyzers/readme-summarizer.ts +102 -102
  115. package/src/analyzers/run-analyzer.ts +269 -269
  116. package/src/analyzers/tech-stack.ts +283 -283
  117. package/src/commands/add-repo.ts +157 -157
  118. package/src/commands/commands.test.ts +155 -155
  119. package/src/commands/commit.ts +131 -131
  120. package/src/commands/create.ts +207 -207
  121. package/src/commands/desktop.ts +128 -0
  122. package/src/commands/diff.ts +125 -125
  123. package/src/commands/doctor.ts +357 -357
  124. package/src/commands/handoff.ts +266 -266
  125. package/src/commands/init.ts +134 -134
  126. package/src/commands/list.ts +46 -46
  127. package/src/commands/logs.ts +63 -63
  128. package/src/commands/mcp.ts +92 -92
  129. package/src/commands/open.ts +129 -129
  130. package/src/commands/pack.ts +73 -73
  131. package/src/commands/refresh.ts +147 -147
  132. package/src/commands/remove.ts +98 -98
  133. package/src/commands/start.ts +117 -117
  134. package/src/commands/status.ts +54 -54
  135. package/src/commands/stop.ts +55 -55
  136. package/src/commands/sync.ts +151 -153
  137. package/src/commands/tui.ts +424 -0
  138. package/src/commands/ui.ts +111 -47
  139. package/src/core/config.test.ts +96 -96
  140. package/src/core/config.ts +115 -115
  141. package/src/core/graph.ts +344 -344
  142. package/src/core/packer.test.ts +99 -99
  143. package/src/core/packer.ts +107 -107
  144. package/src/core/scanner.test.ts +61 -61
  145. package/src/core/scanner.ts +91 -91
  146. package/src/core/workspace.ts +380 -380
  147. package/src/core/worktree.ts +120 -120
  148. package/src/generators/antigravity.ts +32 -32
  149. package/src/generators/base.ts +240 -227
  150. package/src/generators/claude.ts +34 -34
  151. package/src/generators/codex.ts +48 -48
  152. package/src/generators/copilot.ts +56 -56
  153. package/src/generators/cursor.ts +44 -44
  154. package/src/generators/index.ts +250 -250
  155. package/src/generators/map-generator.test.ts +159 -159
  156. package/src/generators/map-generator.ts +542 -542
  157. package/src/generators/plan-generator.ts +481 -481
  158. package/src/generators/skills-generator.ts +259 -259
  159. package/src/index.ts +426 -382
  160. package/src/mcp/server.ts +294 -294
  161. package/src/orchestration/detect.ts +313 -313
  162. package/src/orchestration/index.ts +7 -7
  163. package/src/orchestration/runner.ts +283 -283
  164. package/src/server.test.ts +555 -464
  165. package/src/server.ts +1308 -1104
  166. package/src/types.ts +408 -403
  167. package/src/utils/detect-ai.test.ts +44 -44
  168. package/src/utils/detect-ai.ts +84 -84
  169. package/src/utils/detect-editors.test.ts +48 -48
  170. package/src/utils/detect-editors.ts +57 -57
  171. package/src/utils/git.test.ts +74 -74
  172. package/src/utils/git.ts +117 -61
  173. package/src/utils/local-ai.test.ts +130 -130
  174. package/src/utils/local-ai.ts +111 -111
  175. package/src/utils/multi-git.ts +313 -306
  176. package/src/utils/prompts.ts +209 -209
  177. package/src/utils/session-finder.ts +483 -483
  178. package/src/utils/system-scanner.test.ts +89 -89
  179. package/src/utils/system-scanner.ts +96 -96
  180. package/src/utils/update-check.ts +309 -275
  181. package/src/utils/workflows.test.ts +114 -0
  182. package/src/utils/workflows.ts +178 -0
  183. package/tsconfig.json +19 -19
  184. package/vitest.config.ts +14 -14
  185. package/dist/gui/assets/index-CFWwqFux.js +0 -23
  186. package/dist/gui/assets/index-Dvc9QMvl.css +0 -2
@@ -1,99 +1,99 @@
1
- import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
2
- import * as fs from 'node:fs/promises';
3
- import * as path from 'node:path';
4
- import { fileURLToPath } from 'node:url';
5
- import { packWorkspace } from './packer.js';
6
- import * as workspace from './workspace.js';
7
- import * as repomix from 'repomix';
8
-
9
- const __filename = fileURLToPath(import.meta.url);
10
- const __dirname = path.dirname(__filename);
11
-
12
- // Mock dependencies
13
- vi.mock('./workspace.js');
14
- vi.mock('repomix');
15
-
16
- describe('packWorkspace', () => {
17
- const workspacePath = path.join(__dirname, '..', '..', 'temp-test-workspace');
18
-
19
- beforeEach(async () => {
20
- await fs.mkdir(workspacePath, { recursive: true });
21
- });
22
-
23
- afterEach(async () => {
24
- await fs.rm(workspacePath, { recursive: true, force: true });
25
- vi.clearAllMocks();
26
- });
27
-
28
- it('should successfully pack a workspace and stream repomix output', async () => {
29
- // 1. Mock the workspace config
30
- const mockFeature = {
31
- id: 'test-feature',
32
- description: 'Test description',
33
- repos: [path.join(workspacePath, 'repo-a')]
34
- };
35
- vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(mockFeature as any);
36
-
37
- // Create fake repo directory so fs.access passes
38
- await fs.mkdir(path.join(workspacePath, 'repo-a'), { recursive: true });
39
-
40
- // 2. Mock repomix runCli
41
- vi.spyOn(repomix, 'runCli').mockImplementation(async (dirs, cwd, options) => {
42
- // Create the expected output file to simulate repomix success
43
- if (options && options.output) {
44
- await fs.writeFile(options.output as string, '<file path="test.txt">mock repomix content</file>\n', 'utf-8');
45
- }
46
- return {
47
- packResult: {
48
- totalFiles: 42,
49
- totalCharacters: 9001,
50
- totalTokens: 100,
51
- fileCharCounts: {},
52
- fileTokenCounts: {}
53
- },
54
- suspiciousFilesResults: [],
55
- config: {} as any
56
- } as any;
57
- });
58
-
59
- // 3. Run the packer
60
- const result = await packWorkspace(workspacePath);
61
-
62
- // 4. Assertions
63
- expect(result.totalFiles).toBe(42);
64
- expect(result.totalCharacters).toBe(9001);
65
- expect(result.fileSize).toBeGreaterThan(0);
66
-
67
- // Read the generated output file and verify
68
- const outputContent = await fs.readFile(result.outputPath, 'utf-8');
69
- expect(outputContent).toContain('<file path="test.txt">mock repomix content</file>');
70
- expect(result.outputPaths).toContain(result.outputPath);
71
-
72
- // Verify repomix was called correctly
73
- expect(repomix.runCli).toHaveBeenCalledTimes(1);
74
- });
75
-
76
- it('should skip repos that do not exist', async () => {
77
- const mockFeature = {
78
- id: 'test-feature',
79
- description: 'Test description',
80
- repos: [path.join(workspacePath, 'non-existent-repo')]
81
- };
82
- vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(mockFeature as any);
83
-
84
- // We intentionally don't create the directory 'non-existent-repo'
85
-
86
- const result = await packWorkspace(workspacePath);
87
-
88
- expect(result.totalFiles).toBe(0);
89
- expect(result.totalCharacters).toBe(0);
90
- expect(result.outputPath).toBe('');
91
- expect(result.outputPaths?.length).toBe(0);
92
- });
93
-
94
- it('should throw if workspace feature config is not found', async () => {
95
- vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(null);
96
-
97
- await expect(packWorkspace(workspacePath)).rejects.toThrow(/Workspace not found/);
98
- });
99
- });
1
+ import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
2
+ import * as fs from 'node:fs/promises';
3
+ import * as path from 'node:path';
4
+ import { fileURLToPath } from 'node:url';
5
+ import { packWorkspace } from './packer.js';
6
+ import * as workspace from './workspace.js';
7
+ import * as repomix from 'repomix';
8
+
9
+ const __filename = fileURLToPath(import.meta.url);
10
+ const __dirname = path.dirname(__filename);
11
+
12
+ // Mock dependencies
13
+ vi.mock('./workspace.js');
14
+ vi.mock('repomix');
15
+
16
+ describe('packWorkspace', () => {
17
+ const workspacePath = path.join(__dirname, '..', '..', 'temp-test-workspace');
18
+
19
+ beforeEach(async () => {
20
+ await fs.mkdir(workspacePath, { recursive: true });
21
+ });
22
+
23
+ afterEach(async () => {
24
+ await fs.rm(workspacePath, { recursive: true, force: true });
25
+ vi.clearAllMocks();
26
+ });
27
+
28
+ it('should successfully pack a workspace and stream repomix output', async () => {
29
+ // 1. Mock the workspace config
30
+ const mockFeature = {
31
+ id: 'test-feature',
32
+ description: 'Test description',
33
+ repos: [path.join(workspacePath, 'repo-a')]
34
+ };
35
+ vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(mockFeature as any);
36
+
37
+ // Create fake repo directory so fs.access passes
38
+ await fs.mkdir(path.join(workspacePath, 'repo-a'), { recursive: true });
39
+
40
+ // 2. Mock repomix runCli
41
+ vi.spyOn(repomix, 'runCli').mockImplementation(async (dirs, cwd, options) => {
42
+ // Create the expected output file to simulate repomix success
43
+ if (options && options.output) {
44
+ await fs.writeFile(options.output as string, '<file path="test.txt">mock repomix content</file>\n', 'utf-8');
45
+ }
46
+ return {
47
+ packResult: {
48
+ totalFiles: 42,
49
+ totalCharacters: 9001,
50
+ totalTokens: 100,
51
+ fileCharCounts: {},
52
+ fileTokenCounts: {}
53
+ },
54
+ suspiciousFilesResults: [],
55
+ config: {} as any
56
+ } as any;
57
+ });
58
+
59
+ // 3. Run the packer
60
+ const result = await packWorkspace(workspacePath);
61
+
62
+ // 4. Assertions
63
+ expect(result.totalFiles).toBe(42);
64
+ expect(result.totalCharacters).toBe(9001);
65
+ expect(result.fileSize).toBeGreaterThan(0);
66
+
67
+ // Read the generated output file and verify
68
+ const outputContent = await fs.readFile(result.outputPath, 'utf-8');
69
+ expect(outputContent).toContain('<file path="test.txt">mock repomix content</file>');
70
+ expect(result.outputPaths).toContain(result.outputPath);
71
+
72
+ // Verify repomix was called correctly
73
+ expect(repomix.runCli).toHaveBeenCalledTimes(1);
74
+ });
75
+
76
+ it('should skip repos that do not exist', async () => {
77
+ const mockFeature = {
78
+ id: 'test-feature',
79
+ description: 'Test description',
80
+ repos: [path.join(workspacePath, 'non-existent-repo')]
81
+ };
82
+ vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(mockFeature as any);
83
+
84
+ // We intentionally don't create the directory 'non-existent-repo'
85
+
86
+ const result = await packWorkspace(workspacePath);
87
+
88
+ expect(result.totalFiles).toBe(0);
89
+ expect(result.totalCharacters).toBe(0);
90
+ expect(result.outputPath).toBe('');
91
+ expect(result.outputPaths?.length).toBe(0);
92
+ });
93
+
94
+ it('should throw if workspace feature config is not found', async () => {
95
+ vi.spyOn(workspace, 'loadFeatureConfig').mockResolvedValue(null);
96
+
97
+ await expect(packWorkspace(workspacePath)).rejects.toThrow(/Workspace not found/);
98
+ });
99
+ });
@@ -1,107 +1,107 @@
1
- import * as fs from 'node:fs/promises';
2
- import * as path from 'node:path';
3
- import { runCli } from 'repomix';
4
- import { loadFeatureConfig } from './workspace.js';
5
- import { loadConfig } from './config.js';
6
-
7
- export interface PackResult {
8
- outputPath: string;
9
- outputPaths?: string[];
10
- totalFiles: number;
11
- totalCharacters: number;
12
- fileSize: number;
13
- }
14
-
15
- /**
16
- * Packs all repositories in a workspace into individual XML files using Repomix.
17
- */
18
- export async function packWorkspace(
19
- workspacePath: string,
20
- options: { compress?: boolean } = {}
21
- ): Promise<PackResult> {
22
- const feature = await loadFeatureConfig(workspacePath);
23
- if (!feature) {
24
- throw new Error(`Workspace not found at ${workspacePath}`);
25
- }
26
-
27
- const config = await loadConfig();
28
- const ignorePatterns = (config.excludePatterns || []).join(',');
29
- const compress = options.compress !== false; // default true
30
-
31
- let totalFilesCount = 0;
32
- let totalCharsCount = 0;
33
- let totalFileSize = 0;
34
- const outputPaths: string[] = [];
35
-
36
- for (const repoPath of feature.repos) {
37
- const repoName = path.basename(repoPath);
38
- const worktreePath = path.join(workspacePath, repoName);
39
-
40
- try {
41
- await fs.access(worktreePath);
42
- } catch {
43
- continue;
44
- }
45
-
46
- const outputXmlPath = path.join(workspacePath, `nexusflow-context-${repoName}.xml`);
47
- const instructionsPath = path.join(worktreePath, 'repomix-instruction.md');
48
-
49
- // Generate dynamic repomix-instruction.md for this repo
50
- const mapPath = path.join(workspacePath, `nexusflow-map-${repoName}.md`).replace(/\\/g, '/');
51
- const planPath = path.join(workspacePath, `nexusflow-plan.md`).replace(/\\/g, '/');
52
-
53
- const instructionsContent = [
54
- `# AI Assistant Instructions for ${repoName}`,
55
- '',
56
- `This XML file contains the packed codebase for the repository \`${repoName}\` in the workspace \`${feature.id}\`.`,
57
- '',
58
- `When working with this code, you MUST follow these guidelines:`,
59
- `1. **Explore Locally**: Do not rely on this XML snapshot as the source of truth for edits. Always use your native search, grep, and view tools on the live files in: \`${worktreePath.replace(/\\/g, '/')}\`.`,
60
- `2. **Read the Architecture Map**: Before implementing any changes, read the generated map file at: [nexusflow-map-${repoName}.md](file:///${mapPath}) to understand its layout, API endpoints, test commands, and detected usage patterns.`,
61
- `3. **Follow the Implementation Order**: See the phased plan at: [nexusflow-plan.md](file:///${planPath}) to avoid cross-repo dependency build ordering issues.`,
62
- `4. **Git Operations**: Run git commands (status, add, commit) strictly inside the repository subdirectories (e.g. \`cd ${repoName} && git commit -m "..."\`), NOT in the workspace root.`,
63
- '',
64
- ].join('\n');
65
-
66
- try {
67
- // Write instructions to repo worktree root so Repomix picks it up and appends it at the end
68
- await fs.writeFile(instructionsPath, instructionsContent, 'utf-8');
69
-
70
- // Run repomix programmatically
71
- const result = await runCli(['.'], worktreePath, {
72
- style: 'xml',
73
- output: outputXmlPath,
74
- compress,
75
- quiet: true,
76
- ignore: ignorePatterns,
77
- });
78
-
79
- if (result && result.packResult) {
80
- totalFilesCount += result.packResult.totalFiles;
81
- totalCharsCount += result.packResult.totalCharacters;
82
- }
83
-
84
- const stats = await fs.stat(outputXmlPath);
85
- totalFileSize += stats.size;
86
- outputPaths.push(outputXmlPath);
87
-
88
- } catch (error: any) {
89
- console.error(`Error packing repository ${repoName}:`, error.message);
90
- } finally {
91
- // Clean up the temporary instruction file from the repo's worktree
92
- try {
93
- await fs.unlink(instructionsPath);
94
- } catch {
95
- // ignore
96
- }
97
- }
98
- }
99
-
100
- return {
101
- outputPath: outputPaths[0] || '',
102
- outputPaths,
103
- totalFiles: totalFilesCount,
104
- totalCharacters: totalCharsCount,
105
- fileSize: totalFileSize,
106
- };
107
- }
1
+ import * as fs from 'node:fs/promises';
2
+ import * as path from 'node:path';
3
+ import { runCli } from 'repomix';
4
+ import { loadFeatureConfig } from './workspace.js';
5
+ import { loadConfig } from './config.js';
6
+
7
+ export interface PackResult {
8
+ outputPath: string;
9
+ outputPaths?: string[];
10
+ totalFiles: number;
11
+ totalCharacters: number;
12
+ fileSize: number;
13
+ }
14
+
15
+ /**
16
+ * Packs all repositories in a workspace into individual XML files using Repomix.
17
+ */
18
+ export async function packWorkspace(
19
+ workspacePath: string,
20
+ options: { compress?: boolean } = {}
21
+ ): Promise<PackResult> {
22
+ const feature = await loadFeatureConfig(workspacePath);
23
+ if (!feature) {
24
+ throw new Error(`Workspace not found at ${workspacePath}`);
25
+ }
26
+
27
+ const config = await loadConfig();
28
+ const ignorePatterns = (config.excludePatterns || []).join(',');
29
+ const compress = options.compress !== false; // default true
30
+
31
+ let totalFilesCount = 0;
32
+ let totalCharsCount = 0;
33
+ let totalFileSize = 0;
34
+ const outputPaths: string[] = [];
35
+
36
+ for (const repoPath of feature.repos) {
37
+ const repoName = path.basename(repoPath);
38
+ const worktreePath = path.join(workspacePath, repoName);
39
+
40
+ try {
41
+ await fs.access(worktreePath);
42
+ } catch {
43
+ continue;
44
+ }
45
+
46
+ const outputXmlPath = path.join(workspacePath, `nexusflow-context-${repoName}.xml`);
47
+ const instructionsPath = path.join(worktreePath, 'repomix-instruction.md');
48
+
49
+ // Generate dynamic repomix-instruction.md for this repo
50
+ const mapPath = path.join(workspacePath, `nexusflow-map-${repoName}.md`).replace(/\\/g, '/');
51
+ const planPath = path.join(workspacePath, `nexusflow-plan.md`).replace(/\\/g, '/');
52
+
53
+ const instructionsContent = [
54
+ `# AI Assistant Instructions for ${repoName}`,
55
+ '',
56
+ `This XML file contains the packed codebase for the repository \`${repoName}\` in the workspace \`${feature.id}\`.`,
57
+ '',
58
+ `When working with this code, you MUST follow these guidelines:`,
59
+ `1. **Explore Locally**: Do not rely on this XML snapshot as the source of truth for edits. Always use your native search, grep, and view tools on the live files in: \`${worktreePath.replace(/\\/g, '/')}\`.`,
60
+ `2. **Read the Architecture Map**: Before implementing any changes, read the generated map file at: [nexusflow-map-${repoName}.md](file:///${mapPath}) to understand its layout, API endpoints, test commands, and detected usage patterns.`,
61
+ `3. **Follow the Implementation Order**: See the phased plan at: [nexusflow-plan.md](file:///${planPath}) to avoid cross-repo dependency build ordering issues.`,
62
+ `4. **Git Operations**: Run git commands (status, add, commit) strictly inside the repository subdirectories (e.g. \`cd ${repoName} && git commit -m "..."\`), NOT in the workspace root.`,
63
+ '',
64
+ ].join('\n');
65
+
66
+ try {
67
+ // Write instructions to repo worktree root so Repomix picks it up and appends it at the end
68
+ await fs.writeFile(instructionsPath, instructionsContent, 'utf-8');
69
+
70
+ // Run repomix programmatically
71
+ const result = await runCli(['.'], worktreePath, {
72
+ style: 'xml',
73
+ output: outputXmlPath,
74
+ compress,
75
+ quiet: true,
76
+ ignore: ignorePatterns,
77
+ });
78
+
79
+ if (result && result.packResult) {
80
+ totalFilesCount += result.packResult.totalFiles;
81
+ totalCharsCount += result.packResult.totalCharacters;
82
+ }
83
+
84
+ const stats = await fs.stat(outputXmlPath);
85
+ totalFileSize += stats.size;
86
+ outputPaths.push(outputXmlPath);
87
+
88
+ } catch (error: any) {
89
+ console.error(`Error packing repository ${repoName}:`, error.message);
90
+ } finally {
91
+ // Clean up the temporary instruction file from the repo's worktree
92
+ try {
93
+ await fs.unlink(instructionsPath);
94
+ } catch {
95
+ // ignore
96
+ }
97
+ }
98
+ }
99
+
100
+ return {
101
+ outputPath: outputPaths[0] || '',
102
+ outputPaths,
103
+ totalFiles: totalFilesCount,
104
+ totalCharacters: totalCharsCount,
105
+ fileSize: totalFileSize,
106
+ };
107
+ }
@@ -1,61 +1,61 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import * as fs from 'node:fs/promises';
3
- import * as path from 'node:path';
4
- import { scanForRepos } from './scanner.js';
5
- import * as gitUtils from '../utils/git.js';
6
-
7
- vi.mock('node:fs/promises');
8
- vi.mock('../utils/git.js');
9
-
10
- describe('scanner core module', () => {
11
- beforeEach(() => {
12
- vi.clearAllMocks();
13
- });
14
-
15
- it('should return repository info if the root dir is a git repo', async () => {
16
- vi.mocked(gitUtils.isGitRepo).mockResolvedValue(true);
17
- vi.mocked(gitUtils.detectDefaultBranch).mockResolvedValue('main');
18
-
19
- const result = await scanForRepos('/mock/dev', 2);
20
-
21
- expect(result).toEqual([
22
- { name: 'dev', path: '/mock/dev', defaultBranch: 'main' }
23
- ]);
24
- expect(gitUtils.isGitRepo).toHaveBeenCalledWith('/mock/dev');
25
- });
26
-
27
- it('should recursively scan subdirectories up to limit and return repos found', async () => {
28
- // Root is not a git repo
29
- vi.mocked(gitUtils.isGitRepo).mockImplementation(async (dir) => {
30
- const normalized = dir.replace(/\\/g, '/');
31
- return normalized === '/mock/dev/repo1' || normalized === '/mock/dev/sub/repo2';
32
- });
33
- vi.mocked(gitUtils.detectDefaultBranch).mockResolvedValue('main');
34
-
35
- // Root directory entries
36
- vi.mocked(fs.readdir).mockImplementation(async (dir: any) => {
37
- const normalized = dir.replace(/\\/g, '/');
38
- if (normalized === '/mock/dev') {
39
- return [
40
- { name: 'repo1', isDirectory: () => true },
41
- { name: 'sub', isDirectory: () => true },
42
- { name: 'ignored_file.txt', isDirectory: () => false },
43
- { name: 'node_modules', isDirectory: () => true },
44
- ] as any[];
45
- }
46
- if (normalized === '/mock/dev/sub') {
47
- return [
48
- { name: 'repo2', isDirectory: () => true },
49
- ] as any[];
50
- }
51
- return [];
52
- });
53
-
54
- const result = await scanForRepos('/mock/dev', 2);
55
-
56
- expect(result).toEqual([
57
- { name: 'repo1', path: path.join('/mock/dev', 'repo1'), defaultBranch: 'main' },
58
- { name: 'repo2', path: path.join('/mock/dev', 'sub', 'repo2'), defaultBranch: 'main' }
59
- ]);
60
- });
61
- });
1
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
2
+ import * as fs from 'node:fs/promises';
3
+ import * as path from 'node:path';
4
+ import { scanForRepos } from './scanner.js';
5
+ import * as gitUtils from '../utils/git.js';
6
+
7
+ vi.mock('node:fs/promises');
8
+ vi.mock('../utils/git.js');
9
+
10
+ describe('scanner core module', () => {
11
+ beforeEach(() => {
12
+ vi.clearAllMocks();
13
+ });
14
+
15
+ it('should return repository info if the root dir is a git repo', async () => {
16
+ vi.mocked(gitUtils.isGitRepo).mockResolvedValue(true);
17
+ vi.mocked(gitUtils.detectDefaultBranch).mockResolvedValue('main');
18
+
19
+ const result = await scanForRepos('/mock/dev', 2);
20
+
21
+ expect(result).toEqual([
22
+ { name: 'dev', path: '/mock/dev', defaultBranch: 'main' }
23
+ ]);
24
+ expect(gitUtils.isGitRepo).toHaveBeenCalledWith('/mock/dev');
25
+ });
26
+
27
+ it('should recursively scan subdirectories up to limit and return repos found', async () => {
28
+ // Root is not a git repo
29
+ vi.mocked(gitUtils.isGitRepo).mockImplementation(async (dir) => {
30
+ const normalized = dir.replace(/\\/g, '/');
31
+ return normalized === '/mock/dev/repo1' || normalized === '/mock/dev/sub/repo2';
32
+ });
33
+ vi.mocked(gitUtils.detectDefaultBranch).mockResolvedValue('main');
34
+
35
+ // Root directory entries
36
+ vi.mocked(fs.readdir).mockImplementation(async (dir: any) => {
37
+ const normalized = dir.replace(/\\/g, '/');
38
+ if (normalized === '/mock/dev') {
39
+ return [
40
+ { name: 'repo1', isDirectory: () => true },
41
+ { name: 'sub', isDirectory: () => true },
42
+ { name: 'ignored_file.txt', isDirectory: () => false },
43
+ { name: 'node_modules', isDirectory: () => true },
44
+ ] as any[];
45
+ }
46
+ if (normalized === '/mock/dev/sub') {
47
+ return [
48
+ { name: 'repo2', isDirectory: () => true },
49
+ ] as any[];
50
+ }
51
+ return [];
52
+ });
53
+
54
+ const result = await scanForRepos('/mock/dev', 2);
55
+
56
+ expect(result).toEqual([
57
+ { name: 'repo1', path: path.join('/mock/dev', 'repo1'), defaultBranch: 'main' },
58
+ { name: 'repo2', path: path.join('/mock/dev', 'sub', 'repo2'), defaultBranch: 'main' }
59
+ ]);
60
+ });
61
+ });