@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,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
+ });