@mrpatronz/nexusflow 0.2.19 → 1.3.1

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 (294) hide show
  1. package/README.md +37 -7
  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/add-repo.d.ts +9 -0
  7. package/dist/commands/add-repo.d.ts.map +1 -1
  8. package/dist/commands/add-repo.js +12 -1
  9. package/dist/commands/add-repo.js.map +1 -1
  10. package/dist/commands/add-repo.test.d.ts +2 -0
  11. package/dist/commands/add-repo.test.d.ts.map +1 -0
  12. package/dist/commands/add-repo.test.js +30 -0
  13. package/dist/commands/add-repo.test.js.map +1 -0
  14. package/dist/commands/commands.test.js +26 -6
  15. package/dist/commands/commands.test.js.map +1 -1
  16. package/dist/commands/commit.d.ts +7 -1
  17. package/dist/commands/commit.d.ts.map +1 -1
  18. package/dist/commands/commit.js +31 -8
  19. package/dist/commands/commit.js.map +1 -1
  20. package/dist/commands/commit.test.d.ts +2 -0
  21. package/dist/commands/commit.test.d.ts.map +1 -0
  22. package/dist/commands/commit.test.js +54 -0
  23. package/dist/commands/commit.test.js.map +1 -0
  24. package/dist/commands/diff.d.ts +9 -2
  25. package/dist/commands/diff.d.ts.map +1 -1
  26. package/dist/commands/diff.js +36 -12
  27. package/dist/commands/diff.js.map +1 -1
  28. package/dist/commands/doctor.d.ts.map +1 -1
  29. package/dist/commands/doctor.js +16 -20
  30. package/dist/commands/doctor.js.map +1 -1
  31. package/dist/commands/handoff.d.ts.map +1 -1
  32. package/dist/commands/handoff.js +11 -15
  33. package/dist/commands/handoff.js.map +1 -1
  34. package/dist/commands/refresh.d.ts +4 -2
  35. package/dist/commands/refresh.d.ts.map +1 -1
  36. package/dist/commands/refresh.js +20 -36
  37. package/dist/commands/refresh.js.map +1 -1
  38. package/dist/commands/schedule.d.ts +35 -0
  39. package/dist/commands/schedule.d.ts.map +1 -0
  40. package/dist/commands/schedule.js +151 -0
  41. package/dist/commands/schedule.js.map +1 -0
  42. package/dist/commands/sync.d.ts.map +1 -1
  43. package/dist/commands/sync.js +28 -7
  44. package/dist/commands/sync.js.map +1 -1
  45. package/dist/commands/tui.js +1 -1
  46. package/dist/commands/tui.js.map +1 -1
  47. package/dist/commands/ui.d.ts +1 -0
  48. package/dist/commands/ui.d.ts.map +1 -1
  49. package/dist/commands/ui.js +5 -2
  50. package/dist/commands/ui.js.map +1 -1
  51. package/dist/core/adapters/local-storage.d.ts +7 -0
  52. package/dist/core/adapters/local-storage.d.ts.map +1 -1
  53. package/dist/core/adapters/local-storage.js +13 -4
  54. package/dist/core/adapters/local-storage.js.map +1 -1
  55. package/dist/core/adapters/storage.test.js +18 -0
  56. package/dist/core/adapters/storage.test.js.map +1 -1
  57. package/dist/core/analysis-cache.d.ts +58 -0
  58. package/dist/core/analysis-cache.d.ts.map +1 -0
  59. package/dist/core/analysis-cache.js +116 -0
  60. package/dist/core/analysis-cache.js.map +1 -0
  61. package/dist/core/analysis-cache.test.d.ts +2 -0
  62. package/dist/core/analysis-cache.test.d.ts.map +1 -0
  63. package/dist/core/analysis-cache.test.js +108 -0
  64. package/dist/core/analysis-cache.test.js.map +1 -0
  65. package/dist/core/refresh.d.ts +41 -0
  66. package/dist/core/refresh.d.ts.map +1 -0
  67. package/dist/core/refresh.js +56 -0
  68. package/dist/core/refresh.js.map +1 -0
  69. package/dist/core/scheduler.d.ts +117 -0
  70. package/dist/core/scheduler.d.ts.map +1 -0
  71. package/dist/core/scheduler.js +361 -0
  72. package/dist/core/scheduler.js.map +1 -0
  73. package/dist/core/scheduler.test.d.ts +2 -0
  74. package/dist/core/scheduler.test.d.ts.map +1 -0
  75. package/dist/core/scheduler.test.js +163 -0
  76. package/dist/core/scheduler.test.js.map +1 -0
  77. package/dist/core/sync.d.ts +6 -0
  78. package/dist/core/sync.d.ts.map +1 -1
  79. package/dist/core/sync.js +17 -12
  80. package/dist/core/sync.js.map +1 -1
  81. package/dist/core/workspace.d.ts +6 -0
  82. package/dist/core/workspace.d.ts.map +1 -1
  83. package/dist/core/workspace.js +32 -15
  84. package/dist/core/workspace.js.map +1 -1
  85. package/dist/core/workspace.test.d.ts +2 -0
  86. package/dist/core/workspace.test.d.ts.map +1 -0
  87. package/dist/core/workspace.test.js +42 -0
  88. package/dist/core/workspace.test.js.map +1 -0
  89. package/dist/generators/index.d.ts +7 -1
  90. package/dist/generators/index.d.ts.map +1 -1
  91. package/dist/generators/index.js +14 -1
  92. package/dist/generators/index.js.map +1 -1
  93. package/dist/generators/map-generator.d.ts.map +1 -1
  94. package/dist/generators/map-generator.js +4 -3
  95. package/dist/generators/map-generator.js.map +1 -1
  96. package/dist/generators/map-generator.test.js +4 -2
  97. package/dist/generators/map-generator.test.js.map +1 -1
  98. package/dist/gui/assets/index-ElroPpSP.js +26 -0
  99. package/dist/gui/index.html +1 -1
  100. package/dist/index.js +108 -4
  101. package/dist/index.js.map +1 -1
  102. package/dist/orchestration/index.d.ts +1 -1
  103. package/dist/orchestration/index.d.ts.map +1 -1
  104. package/dist/orchestration/index.js +1 -1
  105. package/dist/orchestration/index.js.map +1 -1
  106. package/dist/orchestration/runner.d.ts +16 -1
  107. package/dist/orchestration/runner.d.ts.map +1 -1
  108. package/dist/orchestration/runner.js +41 -5
  109. package/dist/orchestration/runner.js.map +1 -1
  110. package/dist/orchestration/runner.test.d.ts +2 -0
  111. package/dist/orchestration/runner.test.d.ts.map +1 -0
  112. package/dist/orchestration/runner.test.js +71 -0
  113. package/dist/orchestration/runner.test.js.map +1 -0
  114. package/dist/server.d.ts +17 -1
  115. package/dist/server.d.ts.map +1 -1
  116. package/dist/server.js +275 -114
  117. package/dist/server.js.map +1 -1
  118. package/dist/server.test.js +158 -1
  119. package/dist/server.test.js.map +1 -1
  120. package/dist/utils/multi-git.d.ts +21 -0
  121. package/dist/utils/multi-git.d.ts.map +1 -1
  122. package/dist/utils/multi-git.js +40 -4
  123. package/dist/utils/multi-git.js.map +1 -1
  124. package/dist/utils/prompts.d.ts.map +1 -1
  125. package/dist/utils/prompts.js +8 -2
  126. package/dist/utils/prompts.js.map +1 -1
  127. package/package.json +13 -1
  128. package/.agents/skills/ccc/SKILL.md +0 -71
  129. package/.agents/skills/ccc/references/management.md +0 -110
  130. package/.agents/skills/ccc/references/settings.md +0 -126
  131. package/.github/dependabot.yml +0 -52
  132. package/.github/workflows/ci.yml +0 -44
  133. package/.github/workflows/dependabot-merge.yml +0 -53
  134. package/.github/workflows/release-desktop.yml +0 -67
  135. package/.github/workflows/release-npm.yml +0 -65
  136. package/.github/workflows/release-vscode.yml +0 -61
  137. package/.vscode/launch.json +0 -17
  138. package/.vscode/tasks.json +0 -17
  139. package/GETTING_STARTED.md +0 -114
  140. package/desktop/build-installer.js +0 -228
  141. package/desktop/build.js +0 -118
  142. package/desktop/installer/nexusflow.iss +0 -35
  143. package/desktop/neutralino.config.json +0 -39
  144. package/desktop/package-lock.json +0 -1060
  145. package/desktop/package.json +0 -14
  146. package/dist/gui/assets/index-D8iJPvnk.js +0 -26
  147. package/extension/media/icon.svg +0 -1
  148. package/extension/package-lock.json +0 -6044
  149. package/extension/package.json +0 -117
  150. package/extension/src/extension.ts +0 -653
  151. package/extension/tsconfig.json +0 -21
  152. package/gui/README.md +0 -73
  153. package/gui/e2e/dashboard.spec.ts +0 -61
  154. package/gui/e2e/wizard.spec.ts +0 -346
  155. package/gui/eslint.config.js +0 -26
  156. package/gui/index.html +0 -17
  157. package/gui/package-lock.json +0 -3137
  158. package/gui/package.json +0 -37
  159. package/gui/playwright.config.ts +0 -41
  160. package/gui/public/app_logo.png +0 -0
  161. package/gui/public/favicon.svg +0 -1
  162. package/gui/public/icons.svg +0 -24
  163. package/gui/src/App.css +0 -1
  164. package/gui/src/App.tsx +0 -3573
  165. package/gui/src/app/AppSidebar.tsx +0 -69
  166. package/gui/src/assets/hero.png +0 -0
  167. package/gui/src/assets/react.svg +0 -1
  168. package/gui/src/assets/vite.svg +0 -1
  169. package/gui/src/components/AddRepoPicker.tsx +0 -81
  170. package/gui/src/components/ui/Button.tsx +0 -40
  171. package/gui/src/components/ui/Card.tsx +0 -6
  172. package/gui/src/components/ui/EmptyState.tsx +0 -22
  173. package/gui/src/components/ui/Input.tsx +0 -21
  174. package/gui/src/components/ui/Menu.tsx +0 -71
  175. package/gui/src/components/ui/Modal.tsx +0 -39
  176. package/gui/src/components/ui/PageHeader.tsx +0 -21
  177. package/gui/src/components/ui/RepoStatusStrip.tsx +0 -33
  178. package/gui/src/components/ui/Skeleton.tsx +0 -5
  179. package/gui/src/components/ui/StatusPill.tsx +0 -36
  180. package/gui/src/components/ui/Tabs.tsx +0 -40
  181. package/gui/src/components/ui/cn.ts +0 -4
  182. package/gui/src/components/ui/index.ts +0 -16
  183. package/gui/src/features/changes/ChangesViewer.tsx +0 -388
  184. package/gui/src/features/knowledge/KnowledgeBase.tsx +0 -84
  185. package/gui/src/features/onboarding/OnboardingWizard.tsx +0 -230
  186. package/gui/src/features/plan/ImplementationPlan.tsx +0 -32
  187. package/gui/src/features/services/ServiceConsole.tsx +0 -215
  188. package/gui/src/features/sessions/SessionHistory.tsx +0 -195
  189. package/gui/src/index.css +0 -167
  190. package/gui/src/lib/status.ts +0 -24
  191. package/gui/src/main.tsx +0 -94
  192. package/gui/src/pages/DashboardPage.tsx +0 -129
  193. package/gui/src/pages/WorkspacesPage.tsx +0 -352
  194. package/gui/src/types.ts +0 -81
  195. package/gui/tsconfig.app.json +0 -25
  196. package/gui/tsconfig.json +0 -7
  197. package/gui/tsconfig.node.json +0 -24
  198. package/gui/vite.config.ts +0 -12
  199. package/resources/workflows/plan-implement-review.md +0 -8
  200. package/resources/workflows/research-verify.md +0 -6
  201. package/resources/workflows/solo-developer.md +0 -3
  202. package/scripts/simulate-workspaces.ts +0 -55
  203. package/skills-lock.json +0 -11
  204. package/src/analyzers/detect-apis.ts +0 -290
  205. package/src/analyzers/detect-deps.ts +0 -315
  206. package/src/analyzers/detect-existing.ts +0 -74
  207. package/src/analyzers/detect-ports.ts +0 -110
  208. package/src/analyzers/index.ts +0 -97
  209. package/src/analyzers/messaging-analyzer.ts +0 -254
  210. package/src/analyzers/readme-summarizer.ts +0 -102
  211. package/src/analyzers/run-analyzer.ts +0 -269
  212. package/src/analyzers/tech-stack.ts +0 -283
  213. package/src/commands/adapter.ts +0 -348
  214. package/src/commands/add-repo.ts +0 -156
  215. package/src/commands/commands.test.ts +0 -156
  216. package/src/commands/commit.ts +0 -131
  217. package/src/commands/config.ts +0 -52
  218. package/src/commands/create.ts +0 -204
  219. package/src/commands/desktop.ts +0 -128
  220. package/src/commands/diff.ts +0 -125
  221. package/src/commands/doctor.ts +0 -370
  222. package/src/commands/handoff.ts +0 -266
  223. package/src/commands/init.ts +0 -134
  224. package/src/commands/list.ts +0 -46
  225. package/src/commands/logs.ts +0 -63
  226. package/src/commands/mcp.ts +0 -94
  227. package/src/commands/open.ts +0 -129
  228. package/src/commands/refresh.ts +0 -137
  229. package/src/commands/remove.ts +0 -98
  230. package/src/commands/start.ts +0 -117
  231. package/src/commands/status.ts +0 -54
  232. package/src/commands/stop.ts +0 -55
  233. package/src/commands/sync.ts +0 -125
  234. package/src/commands/tui.ts +0 -484
  235. package/src/commands/ui.ts +0 -111
  236. package/src/core/adapters/local-storage.ts +0 -66
  237. package/src/core/adapters/obsidian-storage.ts +0 -151
  238. package/src/core/adapters/registry.ts +0 -44
  239. package/src/core/adapters/storage.test.ts +0 -174
  240. package/src/core/adapters/vault-storage.ts +0 -86
  241. package/src/core/config.test.ts +0 -96
  242. package/src/core/config.ts +0 -140
  243. package/src/core/graph.ts +0 -344
  244. package/src/core/plugins/index.ts +0 -17
  245. package/src/core/plugins/loader.ts +0 -36
  246. package/src/core/ports/storage.ts +0 -71
  247. package/src/core/scanner.test.ts +0 -61
  248. package/src/core/scanner.ts +0 -91
  249. package/src/core/storage.ts +0 -37
  250. package/src/core/sync.ts +0 -121
  251. package/src/core/workspace-state.test.ts +0 -108
  252. package/src/core/workspace-state.ts +0 -130
  253. package/src/core/workspace.ts +0 -487
  254. package/src/core/worktree.ts +0 -120
  255. package/src/generators/antigravity.ts +0 -32
  256. package/src/generators/base.ts +0 -243
  257. package/src/generators/claude.ts +0 -34
  258. package/src/generators/codex.ts +0 -48
  259. package/src/generators/copilot.ts +0 -56
  260. package/src/generators/cursor.ts +0 -44
  261. package/src/generators/diff-context.ts +0 -75
  262. package/src/generators/index.ts +0 -322
  263. package/src/generators/map-generator.test.ts +0 -159
  264. package/src/generators/map-generator.ts +0 -539
  265. package/src/generators/plan-generator.ts +0 -483
  266. package/src/generators/skills-generator.ts +0 -259
  267. package/src/index.ts +0 -539
  268. package/src/mcp/server.ts +0 -338
  269. package/src/orchestration/detect.ts +0 -313
  270. package/src/orchestration/index.ts +0 -7
  271. package/src/orchestration/runner.ts +0 -283
  272. package/src/server.test.ts +0 -618
  273. package/src/server.ts +0 -1402
  274. package/src/types.ts +0 -451
  275. package/src/utils/detect-ai.test.ts +0 -44
  276. package/src/utils/detect-ai.ts +0 -84
  277. package/src/utils/detect-editors.test.ts +0 -48
  278. package/src/utils/detect-editors.ts +0 -57
  279. package/src/utils/git.test.ts +0 -74
  280. package/src/utils/git.ts +0 -117
  281. package/src/utils/local-ai.test.ts +0 -130
  282. package/src/utils/local-ai.ts +0 -116
  283. package/src/utils/multi-git.test.ts +0 -158
  284. package/src/utils/multi-git.ts +0 -405
  285. package/src/utils/prompts.ts +0 -209
  286. package/src/utils/session-finder.ts +0 -483
  287. package/src/utils/system-scanner.test.ts +0 -89
  288. package/src/utils/system-scanner.ts +0 -96
  289. package/src/utils/update-check.ts +0 -286
  290. package/src/utils/workflow-advisor.ts +0 -118
  291. package/src/utils/workflows.test.ts +0 -114
  292. package/src/utils/workflows.ts +0 -178
  293. package/tsconfig.json +0 -19
  294. 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
-