@mrpatronz/nexusflow 0.2.17 → 0.2.19

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 (320) hide show
  1. package/.agents/skills/ccc/SKILL.md +71 -0
  2. package/.agents/skills/ccc/references/management.md +110 -0
  3. package/.agents/skills/ccc/references/settings.md +126 -0
  4. package/.github/dependabot.yml +52 -52
  5. package/.github/workflows/ci.yml +44 -0
  6. package/.github/workflows/dependabot-merge.yml +53 -53
  7. package/.github/workflows/release-desktop.yml +67 -0
  8. package/.github/workflows/release-npm.yml +65 -0
  9. package/.github/workflows/release-vscode.yml +61 -0
  10. package/.vscode/launch.json +17 -17
  11. package/.vscode/tasks.json +17 -17
  12. package/GETTING_STARTED.md +114 -114
  13. package/README.md +364 -336
  14. package/desktop/build-installer.js +228 -228
  15. package/desktop/build.js +118 -118
  16. package/desktop/installer/nexusflow.iss +35 -35
  17. package/desktop/neutralino.config.json +38 -38
  18. package/desktop/package-lock.json +1060 -1060
  19. package/desktop/package.json +14 -14
  20. package/dist/commands/adapter.d.ts +27 -0
  21. package/dist/commands/adapter.d.ts.map +1 -0
  22. package/dist/commands/adapter.js +318 -0
  23. package/dist/commands/adapter.js.map +1 -0
  24. package/dist/commands/add-repo.d.ts.map +1 -1
  25. package/dist/commands/add-repo.js +0 -1
  26. package/dist/commands/add-repo.js.map +1 -1
  27. package/dist/commands/commands.test.js +2 -2
  28. package/dist/commands/commands.test.js.map +1 -1
  29. package/dist/commands/config.d.ts +22 -0
  30. package/dist/commands/config.d.ts.map +1 -0
  31. package/dist/commands/config.js +50 -0
  32. package/dist/commands/config.js.map +1 -0
  33. package/dist/commands/create.d.ts.map +1 -1
  34. package/dist/commands/create.js +14 -17
  35. package/dist/commands/create.js.map +1 -1
  36. package/dist/commands/doctor.d.ts.map +1 -1
  37. package/dist/commands/doctor.js +11 -0
  38. package/dist/commands/doctor.js.map +1 -1
  39. package/dist/commands/refresh.d.ts +1 -0
  40. package/dist/commands/refresh.d.ts.map +1 -1
  41. package/dist/commands/refresh.js +2 -14
  42. package/dist/commands/refresh.js.map +1 -1
  43. package/dist/commands/sync.d.ts.map +1 -1
  44. package/dist/commands/sync.js +36 -54
  45. package/dist/commands/sync.js.map +1 -1
  46. package/dist/commands/tui.d.ts.map +1 -1
  47. package/dist/commands/tui.js +63 -10
  48. package/dist/commands/tui.js.map +1 -1
  49. package/dist/core/adapters/local-storage.d.ts +14 -0
  50. package/dist/core/adapters/local-storage.d.ts.map +1 -0
  51. package/dist/core/adapters/local-storage.js +58 -0
  52. package/dist/core/adapters/local-storage.js.map +1 -0
  53. package/dist/core/adapters/obsidian-storage.d.ts +28 -0
  54. package/dist/core/adapters/obsidian-storage.d.ts.map +1 -0
  55. package/dist/core/adapters/obsidian-storage.js +135 -0
  56. package/dist/core/adapters/obsidian-storage.js.map +1 -0
  57. package/dist/core/adapters/registry.d.ts +8 -0
  58. package/dist/core/adapters/registry.d.ts.map +1 -0
  59. package/dist/core/adapters/registry.js +37 -0
  60. package/dist/core/adapters/registry.js.map +1 -0
  61. package/dist/core/adapters/storage.test.d.ts +2 -0
  62. package/dist/core/adapters/storage.test.d.ts.map +1 -0
  63. package/dist/core/adapters/storage.test.js +106 -0
  64. package/dist/core/adapters/storage.test.js.map +1 -0
  65. package/dist/core/adapters/vault-storage.d.ts +16 -0
  66. package/dist/core/adapters/vault-storage.d.ts.map +1 -0
  67. package/dist/core/adapters/vault-storage.js +77 -0
  68. package/dist/core/adapters/vault-storage.js.map +1 -0
  69. package/dist/core/config.d.ts.map +1 -1
  70. package/dist/core/config.js +28 -4
  71. package/dist/core/config.js.map +1 -1
  72. package/dist/core/plugins/index.d.ts +14 -0
  73. package/dist/core/plugins/index.d.ts.map +1 -0
  74. package/dist/core/plugins/index.js +2 -0
  75. package/dist/core/plugins/index.js.map +1 -0
  76. package/dist/core/plugins/loader.d.ts +2 -0
  77. package/dist/core/plugins/loader.d.ts.map +1 -0
  78. package/dist/core/plugins/loader.js +34 -0
  79. package/dist/core/plugins/loader.js.map +1 -0
  80. package/dist/core/ports/storage.d.ts +59 -0
  81. package/dist/core/ports/storage.d.ts.map +1 -0
  82. package/dist/core/ports/storage.js +10 -0
  83. package/dist/core/ports/storage.js.map +1 -0
  84. package/dist/core/storage.d.ts +10 -0
  85. package/dist/core/storage.d.ts.map +1 -0
  86. package/dist/core/storage.js +29 -0
  87. package/dist/core/storage.js.map +1 -0
  88. package/dist/core/sync.d.ts +44 -0
  89. package/dist/core/sync.d.ts.map +1 -0
  90. package/dist/core/sync.js +82 -0
  91. package/dist/core/sync.js.map +1 -0
  92. package/dist/core/workspace-state.d.ts +51 -0
  93. package/dist/core/workspace-state.d.ts.map +1 -0
  94. package/dist/core/workspace-state.js +108 -0
  95. package/dist/core/workspace-state.js.map +1 -0
  96. package/dist/core/workspace-state.test.d.ts +2 -0
  97. package/dist/core/workspace-state.test.d.ts.map +1 -0
  98. package/dist/core/workspace-state.test.js +84 -0
  99. package/dist/core/workspace-state.test.js.map +1 -0
  100. package/dist/core/workspace.d.ts.map +1 -1
  101. package/dist/core/workspace.js +110 -16
  102. package/dist/core/workspace.js.map +1 -1
  103. package/dist/generators/base.d.ts.map +1 -1
  104. package/dist/generators/base.js +80 -79
  105. package/dist/generators/base.js.map +1 -1
  106. package/dist/generators/codex.js +11 -11
  107. package/dist/generators/copilot.js +17 -17
  108. package/dist/generators/cursor.js +5 -5
  109. package/dist/generators/diff-context.d.ts +6 -0
  110. package/dist/generators/diff-context.d.ts.map +1 -0
  111. package/dist/generators/diff-context.js +68 -0
  112. package/dist/generators/diff-context.js.map +1 -0
  113. package/dist/generators/index.d.ts +1 -1
  114. package/dist/generators/index.d.ts.map +1 -1
  115. package/dist/generators/index.js +125 -68
  116. package/dist/generators/index.js.map +1 -1
  117. package/dist/generators/map-generator.d.ts.map +1 -1
  118. package/dist/generators/map-generator.js +21 -25
  119. package/dist/generators/map-generator.js.map +1 -1
  120. package/dist/generators/plan-generator.d.ts.map +1 -1
  121. package/dist/generators/plan-generator.js +3 -5
  122. package/dist/generators/plan-generator.js.map +1 -1
  123. package/dist/generators/skills-generator.js +28 -28
  124. package/dist/gui/assets/index-Bdbld6yY.css +1 -0
  125. package/dist/gui/assets/index-D8iJPvnk.js +26 -0
  126. package/dist/gui/icons.svg +24 -24
  127. package/dist/gui/index.html +18 -18
  128. package/dist/index.js +131 -20
  129. package/dist/index.js.map +1 -1
  130. package/dist/mcp/server.d.ts.map +1 -1
  131. package/dist/mcp/server.js +42 -0
  132. package/dist/mcp/server.js.map +1 -1
  133. package/dist/server.d.ts.map +1 -1
  134. package/dist/server.js +140 -56
  135. package/dist/server.js.map +1 -1
  136. package/dist/server.test.js +105 -48
  137. package/dist/server.test.js.map +1 -1
  138. package/dist/types.d.ts +38 -2
  139. package/dist/types.d.ts.map +1 -1
  140. package/dist/utils/local-ai.d.ts.map +1 -1
  141. package/dist/utils/local-ai.js +7 -3
  142. package/dist/utils/local-ai.js.map +1 -1
  143. package/dist/utils/multi-git.d.ts +33 -8
  144. package/dist/utils/multi-git.d.ts.map +1 -1
  145. package/dist/utils/multi-git.js +91 -19
  146. package/dist/utils/multi-git.js.map +1 -1
  147. package/dist/utils/multi-git.test.d.ts +2 -0
  148. package/dist/utils/multi-git.test.d.ts.map +1 -0
  149. package/dist/utils/multi-git.test.js +125 -0
  150. package/dist/utils/multi-git.test.js.map +1 -0
  151. package/dist/utils/update-check.d.ts.map +1 -1
  152. package/dist/utils/update-check.js +0 -28
  153. package/dist/utils/update-check.js.map +1 -1
  154. package/dist/utils/workflow-advisor.d.ts +16 -0
  155. package/dist/utils/workflow-advisor.d.ts.map +1 -0
  156. package/dist/utils/workflow-advisor.js +100 -0
  157. package/dist/utils/workflow-advisor.js.map +1 -0
  158. package/extension/package-lock.json +6044 -2673
  159. package/extension/package.json +117 -108
  160. package/extension/src/extension.ts +653 -631
  161. package/extension/tsconfig.json +21 -21
  162. package/gui/README.md +73 -73
  163. package/gui/e2e/dashboard.spec.ts +61 -0
  164. package/gui/e2e/wizard.spec.ts +346 -346
  165. package/gui/eslint.config.js +26 -26
  166. package/gui/index.html +17 -17
  167. package/gui/package-lock.json +3137 -3079
  168. package/gui/package.json +37 -36
  169. package/gui/playwright.config.ts +41 -41
  170. package/gui/public/icons.svg +24 -24
  171. package/gui/src/App.css +1 -1
  172. package/gui/src/App.tsx +3573 -3407
  173. package/gui/src/app/AppSidebar.tsx +69 -0
  174. package/gui/src/assets/vite.svg +1 -1
  175. package/gui/src/components/AddRepoPicker.tsx +81 -0
  176. package/gui/src/components/ui/Button.tsx +40 -0
  177. package/gui/src/components/ui/Card.tsx +6 -0
  178. package/gui/src/components/ui/EmptyState.tsx +22 -0
  179. package/gui/src/components/ui/Input.tsx +21 -0
  180. package/gui/src/components/ui/Menu.tsx +71 -0
  181. package/gui/src/components/ui/Modal.tsx +39 -0
  182. package/gui/src/components/ui/PageHeader.tsx +21 -0
  183. package/gui/src/components/ui/RepoStatusStrip.tsx +33 -0
  184. package/gui/src/components/ui/Skeleton.tsx +5 -0
  185. package/gui/src/components/ui/StatusPill.tsx +36 -0
  186. package/gui/src/components/ui/Tabs.tsx +40 -0
  187. package/gui/src/components/ui/cn.ts +4 -0
  188. package/gui/src/components/ui/index.ts +16 -0
  189. package/gui/src/features/changes/ChangesViewer.tsx +388 -388
  190. package/gui/src/features/knowledge/KnowledgeBase.tsx +84 -84
  191. package/gui/src/features/onboarding/OnboardingWizard.tsx +230 -230
  192. package/gui/src/features/plan/ImplementationPlan.tsx +32 -32
  193. package/gui/src/features/services/ServiceConsole.tsx +215 -250
  194. package/gui/src/features/sessions/SessionHistory.tsx +195 -195
  195. package/gui/src/index.css +167 -152
  196. package/gui/src/lib/status.ts +24 -0
  197. package/gui/src/main.tsx +94 -94
  198. package/gui/src/pages/DashboardPage.tsx +129 -0
  199. package/gui/src/pages/WorkspacesPage.tsx +352 -0
  200. package/gui/src/types.ts +81 -62
  201. package/gui/tsconfig.app.json +25 -25
  202. package/gui/tsconfig.json +7 -7
  203. package/gui/tsconfig.node.json +24 -24
  204. package/gui/vite.config.ts +12 -12
  205. package/package.json +55 -56
  206. package/resources/workflows/plan-implement-review.md +8 -8
  207. package/resources/workflows/research-verify.md +6 -6
  208. package/resources/workflows/solo-developer.md +3 -3
  209. package/scripts/simulate-workspaces.ts +55 -55
  210. package/skills-lock.json +11 -0
  211. package/src/analyzers/detect-apis.ts +290 -290
  212. package/src/analyzers/detect-deps.ts +315 -315
  213. package/src/analyzers/detect-existing.ts +74 -74
  214. package/src/analyzers/detect-ports.ts +110 -110
  215. package/src/analyzers/index.ts +97 -97
  216. package/src/analyzers/messaging-analyzer.ts +254 -254
  217. package/src/analyzers/readme-summarizer.ts +102 -102
  218. package/src/analyzers/run-analyzer.ts +269 -269
  219. package/src/analyzers/tech-stack.ts +283 -283
  220. package/src/commands/adapter.ts +348 -0
  221. package/src/commands/add-repo.ts +156 -157
  222. package/src/commands/commands.test.ts +156 -155
  223. package/src/commands/commit.ts +131 -131
  224. package/src/commands/config.ts +52 -0
  225. package/src/commands/create.ts +204 -207
  226. package/src/commands/desktop.ts +128 -128
  227. package/src/commands/diff.ts +125 -125
  228. package/src/commands/doctor.ts +370 -357
  229. package/src/commands/handoff.ts +266 -266
  230. package/src/commands/init.ts +134 -134
  231. package/src/commands/list.ts +46 -46
  232. package/src/commands/logs.ts +63 -63
  233. package/src/commands/mcp.ts +94 -92
  234. package/src/commands/open.ts +129 -129
  235. package/src/commands/refresh.ts +137 -147
  236. package/src/commands/remove.ts +98 -98
  237. package/src/commands/start.ts +117 -117
  238. package/src/commands/status.ts +54 -54
  239. package/src/commands/stop.ts +55 -55
  240. package/src/commands/sync.ts +125 -151
  241. package/src/commands/tui.ts +484 -424
  242. package/src/commands/ui.ts +111 -111
  243. package/src/core/adapters/local-storage.ts +66 -0
  244. package/src/core/adapters/obsidian-storage.ts +151 -0
  245. package/src/core/adapters/registry.ts +44 -0
  246. package/src/core/adapters/storage.test.ts +174 -0
  247. package/src/core/adapters/vault-storage.ts +86 -0
  248. package/src/core/config.test.ts +96 -96
  249. package/src/core/config.ts +140 -115
  250. package/src/core/graph.ts +344 -344
  251. package/src/core/plugins/index.ts +17 -0
  252. package/src/core/plugins/loader.ts +36 -0
  253. package/src/core/ports/storage.ts +71 -0
  254. package/src/core/scanner.test.ts +61 -61
  255. package/src/core/scanner.ts +91 -91
  256. package/src/core/storage.ts +37 -0
  257. package/src/core/sync.ts +121 -0
  258. package/src/core/workspace-state.test.ts +108 -0
  259. package/src/core/workspace-state.ts +130 -0
  260. package/src/core/workspace.ts +487 -380
  261. package/src/core/worktree.ts +120 -120
  262. package/src/generators/antigravity.ts +32 -32
  263. package/src/generators/base.ts +243 -240
  264. package/src/generators/claude.ts +34 -34
  265. package/src/generators/codex.ts +48 -48
  266. package/src/generators/copilot.ts +56 -56
  267. package/src/generators/cursor.ts +44 -44
  268. package/src/generators/diff-context.ts +75 -0
  269. package/src/generators/index.ts +322 -250
  270. package/src/generators/map-generator.test.ts +159 -159
  271. package/src/generators/map-generator.ts +539 -542
  272. package/src/generators/plan-generator.ts +483 -481
  273. package/src/generators/skills-generator.ts +259 -259
  274. package/src/index.ts +539 -426
  275. package/src/mcp/server.ts +338 -294
  276. package/src/orchestration/detect.ts +313 -313
  277. package/src/orchestration/index.ts +7 -7
  278. package/src/orchestration/runner.ts +283 -283
  279. package/src/server.test.ts +618 -555
  280. package/src/server.ts +1402 -1308
  281. package/src/types.ts +451 -408
  282. package/src/utils/detect-ai.test.ts +44 -44
  283. package/src/utils/detect-ai.ts +84 -84
  284. package/src/utils/detect-editors.test.ts +48 -48
  285. package/src/utils/detect-editors.ts +57 -57
  286. package/src/utils/git.test.ts +74 -74
  287. package/src/utils/git.ts +117 -117
  288. package/src/utils/local-ai.test.ts +130 -130
  289. package/src/utils/local-ai.ts +116 -111
  290. package/src/utils/multi-git.test.ts +158 -0
  291. package/src/utils/multi-git.ts +405 -313
  292. package/src/utils/prompts.ts +209 -209
  293. package/src/utils/session-finder.ts +483 -483
  294. package/src/utils/system-scanner.test.ts +89 -89
  295. package/src/utils/system-scanner.ts +96 -96
  296. package/src/utils/update-check.ts +286 -309
  297. package/src/utils/workflow-advisor.ts +118 -0
  298. package/src/utils/workflows.test.ts +114 -114
  299. package/src/utils/workflows.ts +178 -178
  300. package/tsconfig.json +19 -19
  301. package/vitest.config.ts +14 -14
  302. package/.github/workflows/release.yml +0 -112
  303. package/dist/commands/pack.d.ts +0 -7
  304. package/dist/commands/pack.d.ts.map +0 -1
  305. package/dist/commands/pack.js +0 -64
  306. package/dist/commands/pack.js.map +0 -1
  307. package/dist/core/packer.d.ts +0 -14
  308. package/dist/core/packer.d.ts.map +0 -1
  309. package/dist/core/packer.js +0 -87
  310. package/dist/core/packer.js.map +0 -1
  311. package/dist/core/packer.test.d.ts +0 -2
  312. package/dist/core/packer.test.d.ts.map +0 -1
  313. package/dist/core/packer.test.js +0 -82
  314. package/dist/core/packer.test.js.map +0 -1
  315. package/dist/gui/assets/index-Ct3qq-X4.js +0 -25
  316. package/dist/gui/assets/index-P_ZrgHXg.css +0 -1
  317. package/gui/src/features/workspace/WorkspaceList.tsx +0 -666
  318. package/src/commands/pack.ts +0 -73
  319. package/src/core/packer.test.ts +0 -99
  320. package/src/core/packer.ts +0 -107
@@ -1,159 +1,159 @@
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 { fileURLToPath } from 'node:url';
5
- import { generateRepoMap } from './map-generator.js';
6
- import type { Language, Framework, ProjectAnalysis } from '../types.js';
7
- import * as globby from 'globby';
8
-
9
- const __filename = fileURLToPath(import.meta.url);
10
- const __dirname = path.dirname(__filename);
11
-
12
- vi.mock('node:fs/promises');
13
- vi.mock('globby');
14
-
15
- describe('generateRepoMap', () => {
16
- const workspacePath = path.join(__dirname, '..', '..', 'temp-test-workspace');
17
-
18
- beforeEach(() => {
19
- vi.clearAllMocks();
20
- });
21
-
22
- it('should generate a markdown map file with correct structure and links', async () => {
23
- // 1. Mock inputs
24
- const mockRepo = {
25
- name: 'test-repo',
26
- path: '/original/path/test-repo',
27
- defaultBranch: 'main',
28
- };
29
-
30
- const mockAnalysis: ProjectAnalysis = {
31
- name: 'test-repo',
32
- path: '/original/path/test-repo',
33
- techStack: {
34
- languages: ['typescript' as Language],
35
- frameworks: ['react' as Framework],
36
- buildTools: ['vite'],
37
- projectType: 'frontend' as const,
38
- },
39
- endpoints: [
40
- { method: 'GET', path: '/api/v1/users', source: 'src/controllers/users.ts' }
41
- ],
42
- dependencies: [
43
- { name: 'react', type: 'npm' as const }
44
- ],
45
- ports: [],
46
- readmeSummary: 'A test repository.',
47
- existingAIConfigs: [],
48
- };
49
-
50
- // Mock globby returns
51
- vi.spyOn(globby, 'globby').mockImplementation(async (pattern: any) => {
52
- const pat = typeof pattern === 'string' ? pattern : (pattern[0] || '');
53
- if (pat.includes('**/*.sln')) return [];
54
- if (pat.includes('**/*.csproj')) return [];
55
- if (pat.includes('package.json')) return ['package.json'];
56
- if (pat.includes('SKILL.md')) return ['skills/my-skill/SKILL.md'];
57
- return [];
58
- });
59
-
60
- const writtenFiles: Record<string, string> = {};
61
- vi.spyOn(fs, 'writeFile').mockImplementation(async (filePath: any, content: any) => {
62
- writtenFiles[filePath as string] = content as string;
63
- return Promise.resolve();
64
- });
65
-
66
- // 2. Run generator
67
- await generateRepoMap(mockRepo, mockAnalysis, workspacePath);
68
-
69
- // 3. Assertions
70
- const expectedOutPath = path.join(workspacePath, 'nexusflow-map-test-repo.md');
71
- expect(fs.writeFile).toHaveBeenCalledTimes(1);
72
- expect(writtenFiles[expectedOutPath]).toBeDefined();
73
-
74
- const content = writtenFiles[expectedOutPath]!;
75
- expect(content).toContain('# Repository Architecture Map — test-repo');
76
- expect(content).toContain('package.json');
77
- expect(content).toContain('my-skill');
78
- expect(content).toContain('GET');
79
- expect(content).toContain('/api/v1/users');
80
- });
81
-
82
- it('should render messaging topology, run config, and group endpoints by module', async () => {
83
- const mockRepo = {
84
- name: 'test-repo',
85
- path: '/original/path/test-repo',
86
- defaultBranch: 'main',
87
- };
88
-
89
- const mockAnalysis: ProjectAnalysis = {
90
- name: 'test-repo',
91
- path: '/original/path/test-repo',
92
- techStack: {
93
- languages: ['typescript' as Language],
94
- frameworks: ['react' as Framework],
95
- buildTools: ['vite'],
96
- projectType: 'frontend' as const,
97
- },
98
- endpoints: [
99
- { method: 'GET', path: '/api/v1/users', source: 'src/routes/users.ts' },
100
- { method: 'POST', path: '/api/v1/users', source: 'src/routes/users.ts' }
101
- ],
102
- dependencies: [
103
- { name: 'my-internal-package', type: 'npm' as const },
104
- { name: 'eslint', type: 'npm' as const }
105
- ],
106
- ports: [],
107
- readmeSummary: 'A test repository.',
108
- existingAIConfigs: [],
109
- messaging: {
110
- publishers: [
111
- { contractType: 'OrderCreated', topicOrQueue: 'order-events', publisherFile: 'src/services/order.ts' }
112
- ],
113
- subscribers: [
114
- { contractType: 'OrderCreated', handlerFile: 'src/handlers/order.ts', registrationFile: 'src/index.ts' }
115
- ]
116
- },
117
- runConfig: {
118
- entryPoints: [
119
- { projectPath: 'package.json', type: 'node', command: 'npm run dev' }
120
- ],
121
- databases: [
122
- { provider: 'PostgreSQL', host: 'localhost', configFile: '.env' }
123
- ],
124
- sharedInfraWarnings: [
125
- { resource: 'Database', host: 'staging-db.org', configFile: '.env', warning: '⚠️ SHARED INFRA warning' }
126
- ],
127
- committedSecrets: [
128
- { file: '.env', lineHint: 'DATABASE_PASSWORD' }
129
- ],
130
- externalDependencies: []
131
- }
132
- };
133
-
134
- vi.spyOn(globby, 'globby').mockImplementation(async () => []);
135
-
136
- const writtenFiles: Record<string, string> = {};
137
- vi.spyOn(fs, 'writeFile').mockImplementation(async (filePath: any, content: any) => {
138
- writtenFiles[filePath as string] = content as string;
139
- return Promise.resolve();
140
- });
141
- vi.spyOn(fs, 'readFile').mockImplementation(async () => '## custom rule here');
142
-
143
- await generateRepoMap(mockRepo, mockAnalysis, workspacePath, new Set(['my-internal-package']));
144
-
145
- const expectedOutPath = path.join(workspacePath, 'nexusflow-map-test-repo.md');
146
- const content = writtenFiles[expectedOutPath]!;
147
-
148
- expect(content).toContain('## 📨 Messaging Topology');
149
- expect(content).toContain('OrderCreated');
150
- expect(content).toContain('order-events');
151
- expect(content).toContain('## ▶️ Running Locally');
152
- expect(content).toContain('### Entry Points');
153
- expect(content).toContain('### ⚠️ Shared Infrastructure Warnings');
154
- expect(content).toContain('my-internal-package');
155
- expect(content).not.toContain('eslint');
156
- expect(content).toContain('Endpoint Group (Router/Module/File)');
157
- expect(content).toContain('users');
158
- });
159
- });
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 { fileURLToPath } from 'node:url';
5
+ import { generateRepoMap } from './map-generator.js';
6
+ import type { Language, Framework, ProjectAnalysis } from '../types.js';
7
+ import * as globby from 'globby';
8
+
9
+ const __filename = fileURLToPath(import.meta.url);
10
+ const __dirname = path.dirname(__filename);
11
+
12
+ vi.mock('node:fs/promises');
13
+ vi.mock('globby');
14
+
15
+ describe('generateRepoMap', () => {
16
+ const workspacePath = path.join(__dirname, '..', '..', 'temp-test-workspace');
17
+
18
+ beforeEach(() => {
19
+ vi.clearAllMocks();
20
+ });
21
+
22
+ it('should generate a markdown map file with correct structure and links', async () => {
23
+ // 1. Mock inputs
24
+ const mockRepo = {
25
+ name: 'test-repo',
26
+ path: '/original/path/test-repo',
27
+ defaultBranch: 'main',
28
+ };
29
+
30
+ const mockAnalysis: ProjectAnalysis = {
31
+ name: 'test-repo',
32
+ path: '/original/path/test-repo',
33
+ techStack: {
34
+ languages: ['typescript' as Language],
35
+ frameworks: ['react' as Framework],
36
+ buildTools: ['vite'],
37
+ projectType: 'frontend' as const,
38
+ },
39
+ endpoints: [
40
+ { method: 'GET', path: '/api/v1/users', source: 'src/controllers/users.ts' }
41
+ ],
42
+ dependencies: [
43
+ { name: 'react', type: 'npm' as const }
44
+ ],
45
+ ports: [],
46
+ readmeSummary: 'A test repository.',
47
+ existingAIConfigs: [],
48
+ };
49
+
50
+ // Mock globby returns
51
+ vi.spyOn(globby, 'globby').mockImplementation(async (pattern: any) => {
52
+ const pat = typeof pattern === 'string' ? pattern : (pattern[0] || '');
53
+ if (pat.includes('**/*.sln')) return [];
54
+ if (pat.includes('**/*.csproj')) return [];
55
+ if (pat.includes('package.json')) return ['package.json'];
56
+ if (pat.includes('SKILL.md')) return ['skills/my-skill/SKILL.md'];
57
+ return [];
58
+ });
59
+
60
+ const writtenFiles: Record<string, string> = {};
61
+ vi.spyOn(fs, 'writeFile').mockImplementation(async (filePath: any, content: any) => {
62
+ writtenFiles[filePath as string] = content as string;
63
+ return Promise.resolve();
64
+ });
65
+
66
+ // 2. Run generator
67
+ await generateRepoMap(mockRepo, mockAnalysis, workspacePath);
68
+
69
+ // 3. Assertions
70
+ const expectedOutPath = path.join(workspacePath, 'nexusflow-map-test-repo.md');
71
+ expect(fs.writeFile).toHaveBeenCalledTimes(1);
72
+ expect(writtenFiles[expectedOutPath]).toBeDefined();
73
+
74
+ const content = writtenFiles[expectedOutPath]!;
75
+ expect(content).toContain('# Repository Architecture Map — test-repo');
76
+ expect(content).toContain('package.json');
77
+ expect(content).toContain('my-skill');
78
+ expect(content).toContain('GET');
79
+ expect(content).toContain('/api/v1/users');
80
+ });
81
+
82
+ it('should render messaging topology, run config, and group endpoints by module', async () => {
83
+ const mockRepo = {
84
+ name: 'test-repo',
85
+ path: '/original/path/test-repo',
86
+ defaultBranch: 'main',
87
+ };
88
+
89
+ const mockAnalysis: ProjectAnalysis = {
90
+ name: 'test-repo',
91
+ path: '/original/path/test-repo',
92
+ techStack: {
93
+ languages: ['typescript' as Language],
94
+ frameworks: ['react' as Framework],
95
+ buildTools: ['vite'],
96
+ projectType: 'frontend' as const,
97
+ },
98
+ endpoints: [
99
+ { method: 'GET', path: '/api/v1/users', source: 'src/routes/users.ts' },
100
+ { method: 'POST', path: '/api/v1/users', source: 'src/routes/users.ts' }
101
+ ],
102
+ dependencies: [
103
+ { name: 'my-internal-package', type: 'npm' as const },
104
+ { name: 'eslint', type: 'npm' as const }
105
+ ],
106
+ ports: [],
107
+ readmeSummary: 'A test repository.',
108
+ existingAIConfigs: [],
109
+ messaging: {
110
+ publishers: [
111
+ { contractType: 'OrderCreated', topicOrQueue: 'order-events', publisherFile: 'src/services/order.ts' }
112
+ ],
113
+ subscribers: [
114
+ { contractType: 'OrderCreated', handlerFile: 'src/handlers/order.ts', registrationFile: 'src/index.ts' }
115
+ ]
116
+ },
117
+ runConfig: {
118
+ entryPoints: [
119
+ { projectPath: 'package.json', type: 'node', command: 'npm run dev' }
120
+ ],
121
+ databases: [
122
+ { provider: 'PostgreSQL', host: 'localhost', configFile: '.env' }
123
+ ],
124
+ sharedInfraWarnings: [
125
+ { resource: 'Database', host: 'staging-db.org', configFile: '.env', warning: '⚠️ SHARED INFRA warning' }
126
+ ],
127
+ committedSecrets: [
128
+ { file: '.env', lineHint: 'DATABASE_PASSWORD' }
129
+ ],
130
+ externalDependencies: []
131
+ }
132
+ };
133
+
134
+ vi.spyOn(globby, 'globby').mockImplementation(async () => []);
135
+
136
+ const writtenFiles: Record<string, string> = {};
137
+ vi.spyOn(fs, 'writeFile').mockImplementation(async (filePath: any, content: any) => {
138
+ writtenFiles[filePath as string] = content as string;
139
+ return Promise.resolve();
140
+ });
141
+ vi.spyOn(fs, 'readFile').mockImplementation(async () => '## custom rule here');
142
+
143
+ await generateRepoMap(mockRepo, mockAnalysis, workspacePath, new Set(['my-internal-package']));
144
+
145
+ const expectedOutPath = path.join(workspacePath, 'nexusflow-map-test-repo.md');
146
+ const content = writtenFiles[expectedOutPath]!;
147
+
148
+ expect(content).toContain('## 📨 Messaging Topology');
149
+ expect(content).toContain('OrderCreated');
150
+ expect(content).toContain('order-events');
151
+ expect(content).toContain('## ▶️ Running Locally');
152
+ expect(content).toContain('### Entry Points');
153
+ expect(content).toContain('### ⚠️ Shared Infrastructure Warnings');
154
+ expect(content).toContain('my-internal-package');
155
+ expect(content).not.toContain('eslint');
156
+ expect(content).toContain('Endpoint Group (Router/Module/File)');
157
+ expect(content).toContain('users');
158
+ });
159
+ });