@mrpatronz/nexusflow 0.2.18 → 1.3.0

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 (236) hide show
  1. package/README.md +27 -3
  2. package/dist/analyzers/index.d.ts +23 -0
  3. package/dist/analyzers/index.d.ts.map +1 -1
  4. package/dist/analyzers/index.js +62 -0
  5. package/dist/analyzers/index.js.map +1 -1
  6. package/dist/commands/commands.test.js +20 -6
  7. package/dist/commands/commands.test.js.map +1 -1
  8. package/dist/commands/commit.d.ts +2 -0
  9. package/dist/commands/commit.d.ts.map +1 -1
  10. package/dist/commands/commit.js +27 -5
  11. package/dist/commands/commit.js.map +1 -1
  12. package/dist/commands/diff.d.ts +9 -2
  13. package/dist/commands/diff.d.ts.map +1 -1
  14. package/dist/commands/diff.js +36 -12
  15. package/dist/commands/diff.js.map +1 -1
  16. package/dist/commands/doctor.js +2 -2
  17. package/dist/commands/doctor.js.map +1 -1
  18. package/dist/commands/handoff.js +2 -2
  19. package/dist/commands/handoff.js.map +1 -1
  20. package/dist/commands/refresh.d.ts +4 -2
  21. package/dist/commands/refresh.d.ts.map +1 -1
  22. package/dist/commands/refresh.js +20 -36
  23. package/dist/commands/refresh.js.map +1 -1
  24. package/dist/commands/schedule.d.ts +35 -0
  25. package/dist/commands/schedule.d.ts.map +1 -0
  26. package/dist/commands/schedule.js +151 -0
  27. package/dist/commands/schedule.js.map +1 -0
  28. package/dist/commands/sync.d.ts.map +1 -1
  29. package/dist/commands/sync.js +58 -50
  30. package/dist/commands/sync.js.map +1 -1
  31. package/dist/core/analysis-cache.d.ts +58 -0
  32. package/dist/core/analysis-cache.d.ts.map +1 -0
  33. package/dist/core/analysis-cache.js +116 -0
  34. package/dist/core/analysis-cache.js.map +1 -0
  35. package/dist/core/analysis-cache.test.d.ts +2 -0
  36. package/dist/core/analysis-cache.test.d.ts.map +1 -0
  37. package/dist/core/analysis-cache.test.js +108 -0
  38. package/dist/core/analysis-cache.test.js.map +1 -0
  39. package/dist/core/refresh.d.ts +41 -0
  40. package/dist/core/refresh.d.ts.map +1 -0
  41. package/dist/core/refresh.js +60 -0
  42. package/dist/core/refresh.js.map +1 -0
  43. package/dist/core/scheduler.d.ts +117 -0
  44. package/dist/core/scheduler.d.ts.map +1 -0
  45. package/dist/core/scheduler.js +247 -0
  46. package/dist/core/scheduler.js.map +1 -0
  47. package/dist/core/scheduler.test.d.ts +2 -0
  48. package/dist/core/scheduler.test.d.ts.map +1 -0
  49. package/dist/core/scheduler.test.js +111 -0
  50. package/dist/core/scheduler.test.js.map +1 -0
  51. package/dist/core/sync.d.ts +50 -0
  52. package/dist/core/sync.d.ts.map +1 -0
  53. package/dist/core/sync.js +92 -0
  54. package/dist/core/sync.js.map +1 -0
  55. package/dist/core/workspace-state.d.ts +51 -0
  56. package/dist/core/workspace-state.d.ts.map +1 -0
  57. package/dist/core/workspace-state.js +108 -0
  58. package/dist/core/workspace-state.js.map +1 -0
  59. package/dist/core/workspace-state.test.d.ts +2 -0
  60. package/dist/core/workspace-state.test.d.ts.map +1 -0
  61. package/dist/core/workspace-state.test.js +84 -0
  62. package/dist/core/workspace-state.test.js.map +1 -0
  63. package/dist/generators/index.d.ts +7 -1
  64. package/dist/generators/index.d.ts.map +1 -1
  65. package/dist/generators/index.js +14 -1
  66. package/dist/generators/index.js.map +1 -1
  67. package/dist/gui/assets/index-Bdbld6yY.css +1 -0
  68. package/dist/gui/assets/index-D8iJPvnk.js +26 -0
  69. package/dist/gui/index.html +2 -2
  70. package/dist/index.js +107 -4
  71. package/dist/index.js.map +1 -1
  72. package/dist/mcp/server.d.ts.map +1 -1
  73. package/dist/mcp/server.js +42 -0
  74. package/dist/mcp/server.js.map +1 -1
  75. package/dist/server.d.ts.map +1 -1
  76. package/dist/server.js +175 -13
  77. package/dist/server.js.map +1 -1
  78. package/dist/server.test.js +66 -0
  79. package/dist/server.test.js.map +1 -1
  80. package/dist/types.d.ts +31 -0
  81. package/dist/types.d.ts.map +1 -1
  82. package/dist/utils/multi-git.d.ts +54 -8
  83. package/dist/utils/multi-git.d.ts.map +1 -1
  84. package/dist/utils/multi-git.js +129 -21
  85. package/dist/utils/multi-git.js.map +1 -1
  86. package/dist/utils/multi-git.test.d.ts +2 -0
  87. package/dist/utils/multi-git.test.d.ts.map +1 -0
  88. package/dist/utils/multi-git.test.js +125 -0
  89. package/dist/utils/multi-git.test.js.map +1 -0
  90. package/package.json +13 -1
  91. package/.agents/skills/ccc/SKILL.md +0 -71
  92. package/.agents/skills/ccc/references/management.md +0 -110
  93. package/.agents/skills/ccc/references/settings.md +0 -126
  94. package/.github/dependabot.yml +0 -52
  95. package/.github/workflows/ci.yml +0 -44
  96. package/.github/workflows/dependabot-merge.yml +0 -53
  97. package/.github/workflows/release-desktop.yml +0 -67
  98. package/.github/workflows/release-npm.yml +0 -65
  99. package/.github/workflows/release-vscode.yml +0 -61
  100. package/.vscode/launch.json +0 -17
  101. package/.vscode/tasks.json +0 -17
  102. package/GETTING_STARTED.md +0 -114
  103. package/desktop/build-installer.js +0 -228
  104. package/desktop/build.js +0 -118
  105. package/desktop/installer/nexusflow.iss +0 -35
  106. package/desktop/neutralino.config.json +0 -39
  107. package/desktop/package-lock.json +0 -1060
  108. package/desktop/package.json +0 -14
  109. package/dist/gui/assets/index-CB-jWded.css +0 -1
  110. package/dist/gui/assets/index-DDXpZZu3.js +0 -25
  111. package/extension/media/icon.svg +0 -1
  112. package/extension/package-lock.json +0 -6044
  113. package/extension/package.json +0 -117
  114. package/extension/src/extension.ts +0 -653
  115. package/extension/tsconfig.json +0 -21
  116. package/gui/README.md +0 -73
  117. package/gui/e2e/wizard.spec.ts +0 -346
  118. package/gui/eslint.config.js +0 -26
  119. package/gui/index.html +0 -17
  120. package/gui/package-lock.json +0 -3079
  121. package/gui/package.json +0 -36
  122. package/gui/playwright.config.ts +0 -41
  123. package/gui/public/app_logo.png +0 -0
  124. package/gui/public/favicon.svg +0 -1
  125. package/gui/public/icons.svg +0 -24
  126. package/gui/src/App.css +0 -1
  127. package/gui/src/App.tsx +0 -3632
  128. package/gui/src/assets/hero.png +0 -0
  129. package/gui/src/assets/react.svg +0 -1
  130. package/gui/src/assets/vite.svg +0 -1
  131. package/gui/src/features/changes/ChangesViewer.tsx +0 -388
  132. package/gui/src/features/knowledge/KnowledgeBase.tsx +0 -84
  133. package/gui/src/features/onboarding/OnboardingWizard.tsx +0 -230
  134. package/gui/src/features/plan/ImplementationPlan.tsx +0 -32
  135. package/gui/src/features/services/ServiceConsole.tsx +0 -250
  136. package/gui/src/features/sessions/SessionHistory.tsx +0 -195
  137. package/gui/src/features/workspace/WorkspaceList.tsx +0 -666
  138. package/gui/src/index.css +0 -152
  139. package/gui/src/main.tsx +0 -94
  140. package/gui/src/types.ts +0 -62
  141. package/gui/tsconfig.app.json +0 -25
  142. package/gui/tsconfig.json +0 -7
  143. package/gui/tsconfig.node.json +0 -24
  144. package/gui/vite.config.ts +0 -12
  145. package/resources/workflows/plan-implement-review.md +0 -8
  146. package/resources/workflows/research-verify.md +0 -6
  147. package/resources/workflows/solo-developer.md +0 -3
  148. package/scripts/simulate-workspaces.ts +0 -55
  149. package/skills-lock.json +0 -11
  150. package/src/analyzers/detect-apis.ts +0 -290
  151. package/src/analyzers/detect-deps.ts +0 -315
  152. package/src/analyzers/detect-existing.ts +0 -74
  153. package/src/analyzers/detect-ports.ts +0 -110
  154. package/src/analyzers/index.ts +0 -97
  155. package/src/analyzers/messaging-analyzer.ts +0 -254
  156. package/src/analyzers/readme-summarizer.ts +0 -102
  157. package/src/analyzers/run-analyzer.ts +0 -269
  158. package/src/analyzers/tech-stack.ts +0 -283
  159. package/src/commands/adapter.ts +0 -348
  160. package/src/commands/add-repo.ts +0 -156
  161. package/src/commands/commands.test.ts +0 -156
  162. package/src/commands/commit.ts +0 -131
  163. package/src/commands/config.ts +0 -52
  164. package/src/commands/create.ts +0 -204
  165. package/src/commands/desktop.ts +0 -128
  166. package/src/commands/diff.ts +0 -125
  167. package/src/commands/doctor.ts +0 -370
  168. package/src/commands/handoff.ts +0 -266
  169. package/src/commands/init.ts +0 -134
  170. package/src/commands/list.ts +0 -46
  171. package/src/commands/logs.ts +0 -63
  172. package/src/commands/mcp.ts +0 -94
  173. package/src/commands/open.ts +0 -129
  174. package/src/commands/refresh.ts +0 -137
  175. package/src/commands/remove.ts +0 -98
  176. package/src/commands/start.ts +0 -117
  177. package/src/commands/status.ts +0 -54
  178. package/src/commands/stop.ts +0 -55
  179. package/src/commands/sync.ts +0 -147
  180. package/src/commands/tui.ts +0 -484
  181. package/src/commands/ui.ts +0 -111
  182. package/src/core/adapters/local-storage.ts +0 -66
  183. package/src/core/adapters/obsidian-storage.ts +0 -151
  184. package/src/core/adapters/registry.ts +0 -44
  185. package/src/core/adapters/storage.test.ts +0 -174
  186. package/src/core/adapters/vault-storage.ts +0 -86
  187. package/src/core/config.test.ts +0 -96
  188. package/src/core/config.ts +0 -140
  189. package/src/core/graph.ts +0 -344
  190. package/src/core/plugins/index.ts +0 -17
  191. package/src/core/plugins/loader.ts +0 -36
  192. package/src/core/ports/storage.ts +0 -71
  193. package/src/core/scanner.test.ts +0 -61
  194. package/src/core/scanner.ts +0 -91
  195. package/src/core/storage.ts +0 -37
  196. package/src/core/workspace.ts +0 -487
  197. package/src/core/worktree.ts +0 -120
  198. package/src/generators/antigravity.ts +0 -32
  199. package/src/generators/base.ts +0 -243
  200. package/src/generators/claude.ts +0 -34
  201. package/src/generators/codex.ts +0 -48
  202. package/src/generators/copilot.ts +0 -56
  203. package/src/generators/cursor.ts +0 -44
  204. package/src/generators/diff-context.ts +0 -75
  205. package/src/generators/index.ts +0 -322
  206. package/src/generators/map-generator.test.ts +0 -159
  207. package/src/generators/map-generator.ts +0 -539
  208. package/src/generators/plan-generator.ts +0 -483
  209. package/src/generators/skills-generator.ts +0 -259
  210. package/src/index.ts +0 -539
  211. package/src/mcp/server.ts +0 -294
  212. package/src/orchestration/detect.ts +0 -313
  213. package/src/orchestration/index.ts +0 -7
  214. package/src/orchestration/runner.ts +0 -283
  215. package/src/server.test.ts +0 -618
  216. package/src/server.ts +0 -1314
  217. package/src/types.ts +0 -415
  218. package/src/utils/detect-ai.test.ts +0 -44
  219. package/src/utils/detect-ai.ts +0 -84
  220. package/src/utils/detect-editors.test.ts +0 -48
  221. package/src/utils/detect-editors.ts +0 -57
  222. package/src/utils/git.test.ts +0 -74
  223. package/src/utils/git.ts +0 -117
  224. package/src/utils/local-ai.test.ts +0 -130
  225. package/src/utils/local-ai.ts +0 -116
  226. package/src/utils/multi-git.ts +0 -313
  227. package/src/utils/prompts.ts +0 -209
  228. package/src/utils/session-finder.ts +0 -483
  229. package/src/utils/system-scanner.test.ts +0 -89
  230. package/src/utils/system-scanner.ts +0 -96
  231. package/src/utils/update-check.ts +0 -286
  232. package/src/utils/workflow-advisor.ts +0 -118
  233. package/src/utils/workflows.test.ts +0 -114
  234. package/src/utils/workflows.ts +0 -178
  235. package/tsconfig.json +0 -19
  236. package/vitest.config.ts +0 -14
package/src/index.ts DELETED
@@ -1,539 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * @module index
5
- * NexusFlow CLI entry point.
6
- *
7
- * Combines multiple repositories into a workspace with rich AI assistant
8
- * context files so tools like Claude, Codex, Copilot, and Cursor understand
9
- * your entire project.
10
- */
11
-
12
- import { Command } from 'commander';
13
-
14
- import { createCommand } from './commands/create.js';
15
- import { listCommand } from './commands/list.js';
16
- import { openCommand } from './commands/open.js';
17
- import { initCommand } from './commands/init.js';
18
- import { startCommand } from './commands/start.js';
19
- import { stopCommand } from './commands/stop.js';
20
- import { logsCommand } from './commands/logs.js';
21
- import { statusCommand } from './commands/status.js';
22
- import { uiCommand } from './commands/ui.js';
23
- import { tuiCommand } from './commands/tui.js';
24
- import { syncCommand } from './commands/sync.js';
25
- import { commitCommand } from './commands/commit.js';
26
- import { diffCommand } from './commands/diff.js';
27
- import { removeCommand } from './commands/remove.js';
28
- import { loadConfig } from './core/config.js';
29
- import { loadPlugins } from './core/plugins/loader.js';
30
- import { addRepoCommand } from './commands/add-repo.js';
31
- import { mcpRunCommand, mcpSetupCommand } from './commands/mcp.js';
32
- import { handoffCommand } from './commands/handoff.js';
33
- import { refreshCommand } from './commands/refresh.js';
34
- import { doctorCommand } from './commands/doctor.js';
35
- import { desktopCommand } from './commands/desktop.js';
36
- import { configShowCommand, configGetCommand, configSetCommand } from './commands/config.js';
37
- import { adapterListCommand, adapterUseCommand, adapterInfoCommand, adapterInitCommand } from './commands/adapter.js';
38
- import { getCurrentVersion, checkForUpdates, printUpdateBanner } from './utils/update-check.js';
39
-
40
- const program = new Command();
41
-
42
- program
43
- .name('nexusflow')
44
- .description(
45
- 'Combine multiple repos into a workspace with rich AI assistant context',
46
- )
47
- .version(getCurrentVersion());
48
-
49
- program
50
- .command('create')
51
- .description(
52
- 'Create a new feature workspace — pick repos, pick AI assistants, generate context',
53
- )
54
- .action(async () => {
55
- try {
56
- await createCommand();
57
- } catch (error) {
58
- if (error instanceof Error && error.message.includes('User force closed')) {
59
- console.log('\nCancelled.');
60
- process.exit(0);
61
- }
62
- console.error(error);
63
- process.exit(1);
64
- }
65
- });
66
-
67
- program
68
- .command('list')
69
- .alias('ls')
70
- .description('List all existing workspaces')
71
- .action(async () => {
72
- try {
73
- await listCommand();
74
- } catch (error) {
75
- console.error(error);
76
- process.exit(1);
77
- }
78
- });
79
-
80
- program
81
- .command('open')
82
- .description('Re-open an existing workspace in an editor')
83
- .action(async () => {
84
- try {
85
- await openCommand();
86
- } catch (error) {
87
- if (error instanceof Error && error.message.includes('User force closed')) {
88
- console.log('\nCancelled.');
89
- process.exit(0);
90
- }
91
- console.error(error);
92
- process.exit(1);
93
- }
94
- });
95
-
96
- program
97
- .command('init')
98
- .description('Initialize NexusFlow configuration')
99
- .action(async () => {
100
- try {
101
- await initCommand();
102
- } catch (error) {
103
- if (error instanceof Error && error.message.includes('User force closed')) {
104
- console.log('\nCancelled.');
105
- process.exit(0);
106
- }
107
- console.error(error);
108
- process.exit(1);
109
- }
110
- });
111
-
112
- program
113
- .command('start')
114
- .description('Start all services in a workspace')
115
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
116
- .action(async (workspace?: string) => {
117
- try {
118
- await startCommand(workspace);
119
- } catch (error) {
120
- if (error instanceof Error && error.message.includes('User force closed')) {
121
- console.log('\nCancelled.');
122
- process.exit(0);
123
- }
124
- console.error(error);
125
- process.exit(1);
126
- }
127
- });
128
-
129
- program
130
- .command('stop')
131
- .description('Stop all running services in a workspace')
132
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
133
- .action(async (workspace?: string) => {
134
- try {
135
- await stopCommand(workspace);
136
- } catch (error) {
137
- if (error instanceof Error && error.message.includes('User force closed')) {
138
- console.log('\nCancelled.');
139
- process.exit(0);
140
- }
141
- console.error(error);
142
- process.exit(1);
143
- }
144
- });
145
-
146
- program
147
- .command('logs')
148
- .description('Show logs from running services')
149
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
150
- .option('-n, --lines <number>', 'Number of lines per service', '30')
151
- .action(async (workspace: string | undefined, options: { lines: string }) => {
152
- try {
153
- await logsCommand(workspace, parseInt(options.lines, 10));
154
- } catch (error) {
155
- if (error instanceof Error && error.message.includes('User force closed')) {
156
- console.log('\nCancelled.');
157
- process.exit(0);
158
- }
159
- console.error(error);
160
- process.exit(1);
161
- }
162
- });
163
-
164
- program
165
- .command('status')
166
- .description('Show status of running services')
167
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
168
- .action(async (workspace?: string) => {
169
- try {
170
- await statusCommand(workspace);
171
- } catch (error) {
172
- if (error instanceof Error && error.message.includes('User force closed')) {
173
- console.log('\nCancelled.');
174
- process.exit(0);
175
- }
176
- console.error(error);
177
- process.exit(1);
178
- }
179
- });
180
-
181
- program
182
- .command('ui')
183
- .description('Open the web GUI dashboard for NexusFlow')
184
- .option('-p, --port <number>', 'Port to run the dashboard server on', '3000')
185
- .option('-d, --daemon', 'Run the dashboard server in the background (daemon mode)')
186
- .option('--server-only', 'Start the dashboard server without opening the browser')
187
- .action(async (options: { port?: string; daemon?: boolean; serverOnly?: boolean }) => {
188
- try {
189
- await uiCommand(options);
190
- } catch (error) {
191
- console.error(error);
192
- process.exit(1);
193
- }
194
- });
195
-
196
- program
197
- .command('dashboard')
198
- .alias('dash')
199
- .description('Instantly open the web GUI dashboard in your default browser')
200
- .option('-p, --port <number>', 'Port to run the dashboard server on', '3000')
201
- .action(async (options: { port?: string }) => {
202
- try {
203
- await uiCommand({ ...options, daemon: true });
204
- } catch (error) {
205
- console.error(error);
206
- process.exit(1);
207
- }
208
- });
209
-
210
-
211
- program
212
- .command('tui')
213
- .description('Open the interactive terminal GUI (TUI) dashboard')
214
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
215
- .action(async (workspace?: string) => {
216
- try {
217
- await tuiCommand({ workspace });
218
- } catch (error) {
219
- console.error(error);
220
- process.exit(1);
221
- }
222
- });
223
-
224
- program
225
- .command('sync')
226
- .description('Sync all repositories in a workspace')
227
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
228
- .action(async (workspace?: string) => {
229
- try {
230
- await syncCommand(workspace);
231
- } catch (error) {
232
- if (error instanceof Error && error.message.includes('User force closed')) {
233
- console.log('\nCancelled.');
234
- process.exit(0);
235
- }
236
- console.error(error);
237
- process.exit(1);
238
- }
239
- });
240
-
241
- program
242
- .command('commit')
243
- .description('Commit changes across all repositories in a workspace')
244
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
245
- .requiredOption('-m, --message <msg>', 'Commit message')
246
- .option('--no-push', 'Stage and commit changes without pushing to remote')
247
- .option('--dry-run', 'Preview changes without committing')
248
- .action(async (workspace: string | undefined, options: { message: string; noPush?: boolean; dryRun?: boolean }) => {
249
- try {
250
- await commitCommand(options.message, workspace, options);
251
- } catch (error) {
252
- if (error instanceof Error && error.message.includes('User force closed')) {
253
- console.log('\nCancelled.');
254
- process.exit(0);
255
- }
256
- console.error(error);
257
- process.exit(1);
258
- }
259
- });
260
-
261
- program
262
- .command('diff')
263
- .description('Display a unified summary of changes across all repositories')
264
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
265
- .action(async (workspace?: string) => {
266
- try {
267
- await diffCommand(workspace);
268
- } catch (error) {
269
- if (error instanceof Error && error.message.includes('User force closed')) {
270
- console.log('\nCancelled.');
271
- process.exit(0);
272
- }
273
- console.error(error);
274
- process.exit(1);
275
- }
276
- });
277
-
278
- // Pack command removed.
279
-
280
- program
281
- .command('remove')
282
- .alias('rm')
283
- .description('Delete a workspace and cleanly prune/remove its git worktrees')
284
- .argument('[workspace]', 'Workspace name or path')
285
- .action(async (workspace?: string) => {
286
- try {
287
- await removeCommand(workspace);
288
- } catch (error) {
289
- if (error instanceof Error && error.message.includes('User force closed')) {
290
- console.log('\nCancelled.');
291
- process.exit(0);
292
- }
293
- console.error(error);
294
- process.exit(1);
295
- }
296
- });
297
-
298
- program
299
- .command('add-repo')
300
- .alias('add')
301
- .description('Add a repository to an existing workspace and update configurations')
302
- .argument('[repo-path]', 'Path to the repository to add')
303
- .argument('[workspace]', 'Workspace name or path')
304
- .action(async (repoPath?: string, workspace?: string) => {
305
- try {
306
- await addRepoCommand(repoPath, workspace);
307
- } catch (error) {
308
- if (error instanceof Error && error.message.includes('User force closed')) {
309
- console.log('\nCancelled.');
310
- process.exit(0);
311
- }
312
- console.error(error);
313
- process.exit(1);
314
- }
315
- });
316
-
317
- program
318
- .command('handoff')
319
- .description('Generate a compact handoff bundle (nexusflow-handoff.md) for session resumption')
320
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
321
- .action(async (workspace?: string) => {
322
- try {
323
- await handoffCommand(workspace);
324
- } catch (error) {
325
- console.error(error);
326
- process.exit(1);
327
- }
328
- });
329
-
330
- program
331
- .command('refresh')
332
- .description('Refresh workspace context, maps, plans and handoff files')
333
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
334
- .option('-r, --repo <repo>', 'Only refresh the map for a specific repository')
335
- .option('-b, --base', 'Only refresh base-layer maps and codebase knowledge from main')
336
- .action(async (workspace: string | undefined, options: { repo?: string; base?: boolean }) => {
337
- try {
338
- await refreshCommand(options, workspace);
339
- } catch (error) {
340
- console.error(error);
341
- process.exit(1);
342
- }
343
- });
344
-
345
- program
346
- .command('doctor')
347
- .description('Run diagnostics to verify workspace health and check for local loop issues')
348
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
349
- .action(async (workspace?: string) => {
350
- try {
351
- await doctorCommand(workspace);
352
- } catch (error) {
353
- console.error(error);
354
- process.exit(1);
355
- }
356
- });
357
-
358
- program
359
- .command('desktop')
360
- .description('Launch the NexusFlow desktop application')
361
- .action(async () => {
362
- try {
363
- await desktopCommand();
364
- } catch (error) {
365
- console.error(error);
366
- process.exit(1);
367
- }
368
- });
369
- // Config command group
370
- const configCmd = program.command('config').description('View and update NexusFlow configuration');
371
-
372
- configCmd
373
- .command('show')
374
- .description('Display the current configuration')
375
- .action(async () => {
376
- try {
377
- await configShowCommand();
378
- } catch (error) {
379
- console.error(error);
380
- process.exit(1);
381
- }
382
- });
383
-
384
- configCmd
385
- .command('get')
386
- .description('Get a specific configuration key')
387
- .argument('<key>', 'Configuration key to read')
388
- .action(async (key: string) => {
389
- try {
390
- await configGetCommand(key);
391
- } catch (error) {
392
- console.error(error);
393
- process.exit(1);
394
- }
395
- });
396
-
397
- configCmd
398
- .command('set')
399
- .description('Set a configuration key to a value')
400
- .argument('<key>', 'Configuration key to set')
401
- .argument('<value>', 'Value to assign')
402
- .action(async (key: string, value: string) => {
403
- try {
404
- await configSetCommand(key, value);
405
- } catch (error) {
406
- console.error(error);
407
- process.exit(1);
408
- }
409
- });
410
-
411
- // Default action when 'nexusflow config' is run without a subcommand
412
- configCmd.action(async () => {
413
- try {
414
- await configShowCommand();
415
- } catch (error) {
416
- console.error(error);
417
- process.exit(1);
418
- }
419
- });
420
-
421
- // Adapter command group
422
- const adapterCmd = program.command('adapter').description('Manage storage adapters — list, switch, configure, or create new ones');
423
-
424
- adapterCmd
425
- .command('list')
426
- .description('List all available storage adapters')
427
- .action(async () => {
428
- try {
429
- await adapterListCommand();
430
- } catch (error) {
431
- console.error(error);
432
- process.exit(1);
433
- }
434
- });
435
-
436
- adapterCmd
437
- .command('use')
438
- .description('Switch to a different storage adapter (prompts for config if needed)')
439
- .argument('<name>', 'Adapter name to activate')
440
- .action(async (name: string) => {
441
- try {
442
- await adapterUseCommand(name);
443
- } catch (error) {
444
- console.error(error);
445
- process.exit(1);
446
- }
447
- });
448
-
449
- adapterCmd
450
- .command('info')
451
- .description('Show detailed information about an adapter')
452
- .argument('<name>', 'Adapter name to inspect')
453
- .action(async (name: string) => {
454
- try {
455
- await adapterInfoCommand(name);
456
- } catch (error) {
457
- console.error(error);
458
- process.exit(1);
459
- }
460
- });
461
-
462
- adapterCmd
463
- .command('init')
464
- .description('Scaffold a new adapter plugin project')
465
- .argument('<name>', 'Name for the new adapter')
466
- .action(async (name: string) => {
467
- try {
468
- await adapterInitCommand(name);
469
- } catch (error) {
470
- console.error(error);
471
- process.exit(1);
472
- }
473
- });
474
-
475
- // Default action when 'nexusflow adapter' is run without a subcommand
476
- adapterCmd.action(async () => {
477
- try {
478
- await adapterListCommand();
479
- } catch (error) {
480
- console.error(error);
481
- process.exit(1);
482
- }
483
- });
484
-
485
- const mcp = program.command('mcp').description('Manage the NexusFlow MCP Server for AI assistants');
486
-
487
- mcp
488
- .command('run')
489
- .description('Start the NexusFlow MCP Server (typically called automatically by AI assistants)')
490
- .argument('[workspace]', 'Path to workspace (auto-detects from CWD)')
491
- .action(async (workspace?: string) => {
492
- try {
493
- await mcpRunCommand(workspace);
494
- } catch (error) {
495
- console.error(error);
496
- process.exit(1);
497
- }
498
- });
499
-
500
- mcp
501
- .command('setup')
502
- .description('Automatically configure your AI environments (Claude Desktop, Cursor, VS Code) to use the NexusFlow MCP Server')
503
- .action(async () => {
504
- try {
505
- await mcpSetupCommand();
506
- } catch (error) {
507
- console.error(error);
508
- process.exit(1);
509
- }
510
- });
511
-
512
- program.hook('postAction', async (thisCommand, actionCommand) => {
513
- // Skip update check for MCP run to prevent contaminating stdout stream
514
- if (actionCommand.name() === 'run' && actionCommand.parent?.name() === 'mcp') {
515
- return;
516
- }
517
-
518
- try {
519
- const status = await checkForUpdates();
520
- if (status) {
521
- printUpdateBanner(status);
522
- }
523
- } catch {
524
- // Silently ignore to prevent crashing CLI
525
- }
526
- });
527
-
528
- async function bootstrap() {
529
- try {
530
- const config = await loadConfig();
531
- if (config.plugins && config.plugins.length > 0) {
532
- await loadPlugins(program, config.plugins);
533
- }
534
- } catch {}
535
- await program.parseAsync(process.argv);
536
- }
537
-
538
- bootstrap();
539
-