@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,209 +1,209 @@
1
- /**
2
- * @module utils/prompts
3
- * Interactive CLI prompts for NexusFlow using @inquirer/prompts.
4
- */
5
-
6
- import { input, checkbox, confirm, select, search } from '@inquirer/prompts';
7
- import chalk from 'chalk';
8
-
9
- import type { AIAssistant, DetectedAI, DetectedEditor, RepoInfo } from '../types.js';
10
-
11
- /**
12
- * Prompts the user for a feature branch name.
13
- */
14
- export async function promptBranchName(): Promise<string> {
15
- const branchName = await input({
16
- message: 'Feature branch name:',
17
- validate: (value: string) => {
18
- if (!value.trim()) return 'Branch name cannot be empty';
19
- if (/\s/.test(value)) return 'Branch name cannot contain spaces';
20
- return true;
21
- },
22
- });
23
- return branchName.trim();
24
- }
25
-
26
- /**
27
- * Prompts the user for a feature description.
28
- * Accepts plain text or a path to a file.
29
- */
30
- export async function promptDescription(): Promise<string> {
31
- const { readFile } = await import('node:fs/promises');
32
- const { existsSync } = await import('node:fs');
33
-
34
- const descInput = await input({
35
- message: 'Describe the feature (or paste a path to a .md/.txt file):',
36
- validate: (value: string) => {
37
- if (!value.trim()) return 'Description cannot be empty';
38
- return true;
39
- },
40
- });
41
-
42
- const trimmed = descInput.trim();
43
-
44
- // Check if it's a file path
45
- if (existsSync(trimmed)) {
46
- try {
47
- const content = await readFile(trimmed, 'utf-8');
48
- console.log(chalk.dim(` Read description from ${trimmed}`));
49
- return content;
50
- } catch {
51
- // Fall through to use as plain text
52
- }
53
- }
54
-
55
- return trimmed;
56
- }
57
-
58
- /**
59
- * Prompts the user to select repos from a list of discovered repos.
60
- * Supports searching/filtering by term, viewing all, and incremental selection.
61
- */
62
- export async function promptSelectRepos(repos: RepoInfo[]): Promise<RepoInfo[]> {
63
- if (repos.length === 0) {
64
- return [];
65
- }
66
-
67
- const selectedPaths = new Set<string>();
68
-
69
- // If there are only a few repos (e.g. <= 10), we can just show a checkbox prompt directly to save time
70
- if (repos.length <= 10) {
71
- const toggled = await checkbox({
72
- message: 'Select repositories to include in workspace:',
73
- choices: repos.map((repo) => ({
74
- name: `${repo.name} ${chalk.dim(`(${repo.path})`)}`,
75
- value: repo.path,
76
- checked: false,
77
- })),
78
- });
79
- return repos.filter((r) => toggled.includes(r.path));
80
- }
81
-
82
- // Otherwise, use a loop with the search prompt to make it extremely easy to filter and toggle selection
83
- while (true) {
84
- console.log(chalk.bold(`\n๐Ÿ“ Selected Repositories (${selectedPaths.size}/${repos.length}):`));
85
- if (selectedPaths.size === 0) {
86
- console.log(chalk.dim(' (None selected yet)'));
87
- } else {
88
- repos.forEach((r) => {
89
- if (selectedPaths.has(r.path)) {
90
- console.log(` ${chalk.green('โœ“')} ${r.name} ${chalk.dim(`(${r.path})`)}`);
91
- }
92
- });
93
- }
94
- console.log();
95
-
96
- const result = await search({
97
- message: 'Search and select repositories (type to filter, select to toggle, choose Done to finish):',
98
- source: async (input) => {
99
- const query = (input || '').toLowerCase();
100
- const filtered = repos.filter(
101
- (r) =>
102
- r.name.toLowerCase().includes(query) ||
103
- r.path.toLowerCase().includes(query)
104
- );
105
-
106
- const choices = [
107
- {
108
- name: chalk.green(`โœ… Done selecting (${selectedPaths.size} repo(s) selected)`),
109
- value: 'done',
110
- },
111
- ];
112
-
113
- if (selectedPaths.size > 0) {
114
- choices.push({
115
- name: chalk.yellow('๐Ÿงน Clear all selections'),
116
- value: 'clear',
117
- });
118
- }
119
-
120
- filtered.forEach((r) => {
121
- const isSelected = selectedPaths.has(r.path);
122
- choices.push({
123
- name: `${isSelected ? chalk.green('โœ“') : ' '} ${r.name} ${chalk.dim(`(${r.path})`)}`,
124
- value: r.path,
125
- });
126
- });
127
-
128
- return choices;
129
- },
130
- });
131
-
132
- if (result === 'done') {
133
- if (selectedPaths.size === 0) {
134
- console.log(chalk.red(' Please select at least one repository.'));
135
- continue;
136
- }
137
- break;
138
- }
139
-
140
- if (result === 'clear') {
141
- selectedPaths.clear();
142
- continue;
143
- }
144
-
145
- // Toggle selected state
146
- if (selectedPaths.has(result)) {
147
- selectedPaths.delete(result);
148
- } else {
149
- selectedPaths.add(result);
150
- }
151
- }
152
-
153
- return repos.filter((r) => selectedPaths.has(r.path));
154
- }
155
-
156
- /**
157
- * Prompts the user to select AI assistants to generate context for.
158
- */
159
- export async function promptSelectAI(
160
- detected: DetectedAI[],
161
- ): Promise<AIAssistant[]> {
162
- const selected = await checkbox({
163
- message: 'Select AI assistant(s) to generate context for:',
164
- choices: detected.map((ai) => ({
165
- name: `${ai.displayName} ${ai.detected ? chalk.green('โœ“ detected') : chalk.dim('not found')}`,
166
- value: ai.name,
167
- checked: ai.detected,
168
- })),
169
- validate: (items) => {
170
- if (items.length === 0) return 'Please select at least one AI assistant';
171
- return true;
172
- },
173
- });
174
-
175
- return selected as AIAssistant[];
176
- }
177
-
178
- /**
179
- * Prompts the user to select an editor to open the workspace in.
180
- */
181
- export async function promptSelectEditor(
182
- detected: DetectedEditor[],
183
- ): Promise<DetectedEditor | null> {
184
- const shouldOpen = await confirm({
185
- message: 'Open workspace in an editor?',
186
- default: true,
187
- });
188
-
189
- if (!shouldOpen) return null;
190
-
191
- const available = detected.filter((e) => e.detected);
192
-
193
- if (available.length === 0) {
194
- console.log(chalk.yellow(' No editors detected in PATH.'));
195
- return null;
196
- }
197
-
198
- const selected = await checkbox({
199
- message: 'Select editor:',
200
- choices: available.map((editor) => ({
201
- name: editor.name,
202
- value: editor.command,
203
- })),
204
- });
205
-
206
- if (selected.length === 0) return null;
207
-
208
- return available.find((e) => e.command === selected[0]) ?? null;
209
- }
1
+ /**
2
+ * @module utils/prompts
3
+ * Interactive CLI prompts for NexusFlow using @inquirer/prompts.
4
+ */
5
+
6
+ import { input, checkbox, confirm, select, search } from '@inquirer/prompts';
7
+ import chalk from 'chalk';
8
+
9
+ import type { AIAssistant, DetectedAI, DetectedEditor, RepoInfo } from '../types.js';
10
+
11
+ /**
12
+ * Prompts the user for a feature branch name.
13
+ */
14
+ export async function promptBranchName(): Promise<string> {
15
+ const branchName = await input({
16
+ message: 'Feature branch name:',
17
+ validate: (value: string) => {
18
+ if (!value.trim()) return 'Branch name cannot be empty';
19
+ if (/\s/.test(value)) return 'Branch name cannot contain spaces';
20
+ return true;
21
+ },
22
+ });
23
+ return branchName.trim();
24
+ }
25
+
26
+ /**
27
+ * Prompts the user for a feature description.
28
+ * Accepts plain text or a path to a file.
29
+ */
30
+ export async function promptDescription(): Promise<string> {
31
+ const { readFile } = await import('node:fs/promises');
32
+ const { existsSync } = await import('node:fs');
33
+
34
+ const descInput = await input({
35
+ message: 'Describe the feature (or paste a path to a .md/.txt file):',
36
+ validate: (value: string) => {
37
+ if (!value.trim()) return 'Description cannot be empty';
38
+ return true;
39
+ },
40
+ });
41
+
42
+ const trimmed = descInput.trim();
43
+
44
+ // Check if it's a file path
45
+ if (existsSync(trimmed)) {
46
+ try {
47
+ const content = await readFile(trimmed, 'utf-8');
48
+ console.log(chalk.dim(` Read description from ${trimmed}`));
49
+ return content;
50
+ } catch {
51
+ // Fall through to use as plain text
52
+ }
53
+ }
54
+
55
+ return trimmed;
56
+ }
57
+
58
+ /**
59
+ * Prompts the user to select repos from a list of discovered repos.
60
+ * Supports searching/filtering by term, viewing all, and incremental selection.
61
+ */
62
+ export async function promptSelectRepos(repos: RepoInfo[]): Promise<RepoInfo[]> {
63
+ if (repos.length === 0) {
64
+ return [];
65
+ }
66
+
67
+ const selectedPaths = new Set<string>();
68
+
69
+ // If there are only a few repos (e.g. <= 10), we can just show a checkbox prompt directly to save time
70
+ if (repos.length <= 10) {
71
+ const toggled = await checkbox({
72
+ message: 'Select repositories to include in workspace:',
73
+ choices: repos.map((repo) => ({
74
+ name: `${repo.name} ${chalk.dim(`(${repo.path})`)}`,
75
+ value: repo.path,
76
+ checked: false,
77
+ })),
78
+ });
79
+ return repos.filter((r) => toggled.includes(r.path));
80
+ }
81
+
82
+ // Otherwise, use a loop with the search prompt to make it extremely easy to filter and toggle selection
83
+ while (true) {
84
+ console.log(chalk.bold(`\n๐Ÿ“ Selected Repositories (${selectedPaths.size}/${repos.length}):`));
85
+ if (selectedPaths.size === 0) {
86
+ console.log(chalk.dim(' (None selected yet)'));
87
+ } else {
88
+ repos.forEach((r) => {
89
+ if (selectedPaths.has(r.path)) {
90
+ console.log(` ${chalk.green('โœ“')} ${r.name} ${chalk.dim(`(${r.path})`)}`);
91
+ }
92
+ });
93
+ }
94
+ console.log();
95
+
96
+ const result = await search({
97
+ message: 'Search and select repositories (type to filter, select to toggle, choose Done to finish):',
98
+ source: async (input) => {
99
+ const query = (input || '').toLowerCase();
100
+ const filtered = repos.filter(
101
+ (r) =>
102
+ r.name.toLowerCase().includes(query) ||
103
+ r.path.toLowerCase().includes(query)
104
+ );
105
+
106
+ const choices = [
107
+ {
108
+ name: chalk.green(`โœ… Done selecting (${selectedPaths.size} repo(s) selected)`),
109
+ value: 'done',
110
+ },
111
+ ];
112
+
113
+ if (selectedPaths.size > 0) {
114
+ choices.push({
115
+ name: chalk.yellow('๐Ÿงน Clear all selections'),
116
+ value: 'clear',
117
+ });
118
+ }
119
+
120
+ filtered.forEach((r) => {
121
+ const isSelected = selectedPaths.has(r.path);
122
+ choices.push({
123
+ name: `${isSelected ? chalk.green('โœ“') : ' '} ${r.name} ${chalk.dim(`(${r.path})`)}`,
124
+ value: r.path,
125
+ });
126
+ });
127
+
128
+ return choices;
129
+ },
130
+ });
131
+
132
+ if (result === 'done') {
133
+ if (selectedPaths.size === 0) {
134
+ console.log(chalk.red(' Please select at least one repository.'));
135
+ continue;
136
+ }
137
+ break;
138
+ }
139
+
140
+ if (result === 'clear') {
141
+ selectedPaths.clear();
142
+ continue;
143
+ }
144
+
145
+ // Toggle selected state
146
+ if (selectedPaths.has(result)) {
147
+ selectedPaths.delete(result);
148
+ } else {
149
+ selectedPaths.add(result);
150
+ }
151
+ }
152
+
153
+ return repos.filter((r) => selectedPaths.has(r.path));
154
+ }
155
+
156
+ /**
157
+ * Prompts the user to select AI assistants to generate context for.
158
+ */
159
+ export async function promptSelectAI(
160
+ detected: DetectedAI[],
161
+ ): Promise<AIAssistant[]> {
162
+ const selected = await checkbox({
163
+ message: 'Select AI assistant(s) to generate context for:',
164
+ choices: detected.map((ai) => ({
165
+ name: `${ai.displayName} ${ai.detected ? chalk.green('โœ“ detected') : chalk.dim('not found')}`,
166
+ value: ai.name,
167
+ checked: ai.detected,
168
+ })),
169
+ validate: (items) => {
170
+ if (items.length === 0) return 'Please select at least one AI assistant';
171
+ return true;
172
+ },
173
+ });
174
+
175
+ return selected as AIAssistant[];
176
+ }
177
+
178
+ /**
179
+ * Prompts the user to select an editor to open the workspace in.
180
+ */
181
+ export async function promptSelectEditor(
182
+ detected: DetectedEditor[],
183
+ ): Promise<DetectedEditor | null> {
184
+ const shouldOpen = await confirm({
185
+ message: 'Open workspace in an editor?',
186
+ default: true,
187
+ });
188
+
189
+ if (!shouldOpen) return null;
190
+
191
+ const available = detected.filter((e) => e.detected);
192
+
193
+ if (available.length === 0) {
194
+ console.log(chalk.yellow(' No editors detected in PATH.'));
195
+ return null;
196
+ }
197
+
198
+ const selected = await checkbox({
199
+ message: 'Select editor:',
200
+ choices: available.map((editor) => ({
201
+ name: editor.name,
202
+ value: editor.command,
203
+ })),
204
+ });
205
+
206
+ if (selected.length === 0) return null;
207
+
208
+ return available.find((e) => e.command === selected[0]) ?? null;
209
+ }