@mrpatronz/nexusflow 0.2.17 → 0.2.18

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 (274) 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 +0 -5
  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/workspace.d.ts.map +1 -1
  89. package/dist/core/workspace.js +110 -16
  90. package/dist/core/workspace.js.map +1 -1
  91. package/dist/generators/base.d.ts.map +1 -1
  92. package/dist/generators/base.js +80 -79
  93. package/dist/generators/base.js.map +1 -1
  94. package/dist/generators/codex.js +11 -11
  95. package/dist/generators/copilot.js +17 -17
  96. package/dist/generators/cursor.js +5 -5
  97. package/dist/generators/diff-context.d.ts +6 -0
  98. package/dist/generators/diff-context.d.ts.map +1 -0
  99. package/dist/generators/diff-context.js +68 -0
  100. package/dist/generators/diff-context.js.map +1 -0
  101. package/dist/generators/index.d.ts +1 -1
  102. package/dist/generators/index.d.ts.map +1 -1
  103. package/dist/generators/index.js +125 -68
  104. package/dist/generators/index.js.map +1 -1
  105. package/dist/generators/map-generator.d.ts.map +1 -1
  106. package/dist/generators/map-generator.js +21 -25
  107. package/dist/generators/map-generator.js.map +1 -1
  108. package/dist/generators/plan-generator.d.ts.map +1 -1
  109. package/dist/generators/plan-generator.js +3 -5
  110. package/dist/generators/plan-generator.js.map +1 -1
  111. package/dist/generators/skills-generator.js +28 -28
  112. package/dist/gui/assets/index-CB-jWded.css +1 -0
  113. package/dist/gui/assets/index-DDXpZZu3.js +25 -0
  114. package/dist/gui/icons.svg +24 -24
  115. package/dist/gui/index.html +18 -18
  116. package/dist/index.js +131 -20
  117. package/dist/index.js.map +1 -1
  118. package/dist/server.d.ts.map +1 -1
  119. package/dist/server.js +46 -43
  120. package/dist/server.js.map +1 -1
  121. package/dist/server.test.js +105 -48
  122. package/dist/server.test.js.map +1 -1
  123. package/dist/types.d.ts +7 -2
  124. package/dist/types.d.ts.map +1 -1
  125. package/dist/utils/local-ai.d.ts.map +1 -1
  126. package/dist/utils/local-ai.js +7 -3
  127. package/dist/utils/local-ai.js.map +1 -1
  128. package/dist/utils/update-check.d.ts.map +1 -1
  129. package/dist/utils/update-check.js +0 -28
  130. package/dist/utils/update-check.js.map +1 -1
  131. package/dist/utils/workflow-advisor.d.ts +16 -0
  132. package/dist/utils/workflow-advisor.d.ts.map +1 -0
  133. package/dist/utils/workflow-advisor.js +100 -0
  134. package/dist/utils/workflow-advisor.js.map +1 -0
  135. package/extension/package-lock.json +6044 -2673
  136. package/extension/package.json +117 -108
  137. package/extension/src/extension.ts +653 -631
  138. package/extension/tsconfig.json +21 -21
  139. package/gui/README.md +73 -73
  140. package/gui/e2e/wizard.spec.ts +346 -346
  141. package/gui/eslint.config.js +26 -26
  142. package/gui/index.html +17 -17
  143. package/gui/package-lock.json +3079 -3079
  144. package/gui/package.json +36 -36
  145. package/gui/playwright.config.ts +41 -41
  146. package/gui/public/icons.svg +24 -24
  147. package/gui/src/App.css +1 -1
  148. package/gui/src/App.tsx +3632 -3407
  149. package/gui/src/assets/vite.svg +1 -1
  150. package/gui/src/features/changes/ChangesViewer.tsx +388 -388
  151. package/gui/src/features/knowledge/KnowledgeBase.tsx +84 -84
  152. package/gui/src/features/onboarding/OnboardingWizard.tsx +230 -230
  153. package/gui/src/features/plan/ImplementationPlan.tsx +32 -32
  154. package/gui/src/features/services/ServiceConsole.tsx +250 -250
  155. package/gui/src/features/sessions/SessionHistory.tsx +195 -195
  156. package/gui/src/features/workspace/WorkspaceList.tsx +666 -666
  157. package/gui/src/index.css +152 -152
  158. package/gui/src/main.tsx +94 -94
  159. package/gui/src/types.ts +62 -62
  160. package/gui/tsconfig.app.json +25 -25
  161. package/gui/tsconfig.json +7 -7
  162. package/gui/tsconfig.node.json +24 -24
  163. package/gui/vite.config.ts +12 -12
  164. package/package.json +55 -56
  165. package/resources/workflows/plan-implement-review.md +8 -8
  166. package/resources/workflows/research-verify.md +6 -6
  167. package/resources/workflows/solo-developer.md +3 -3
  168. package/scripts/simulate-workspaces.ts +55 -55
  169. package/skills-lock.json +11 -0
  170. package/src/analyzers/detect-apis.ts +290 -290
  171. package/src/analyzers/detect-deps.ts +315 -315
  172. package/src/analyzers/detect-existing.ts +74 -74
  173. package/src/analyzers/detect-ports.ts +110 -110
  174. package/src/analyzers/index.ts +97 -97
  175. package/src/analyzers/messaging-analyzer.ts +254 -254
  176. package/src/analyzers/readme-summarizer.ts +102 -102
  177. package/src/analyzers/run-analyzer.ts +269 -269
  178. package/src/analyzers/tech-stack.ts +283 -283
  179. package/src/commands/adapter.ts +348 -0
  180. package/src/commands/add-repo.ts +156 -157
  181. package/src/commands/commands.test.ts +156 -155
  182. package/src/commands/commit.ts +131 -131
  183. package/src/commands/config.ts +52 -0
  184. package/src/commands/create.ts +204 -207
  185. package/src/commands/desktop.ts +128 -128
  186. package/src/commands/diff.ts +125 -125
  187. package/src/commands/doctor.ts +370 -357
  188. package/src/commands/handoff.ts +266 -266
  189. package/src/commands/init.ts +134 -134
  190. package/src/commands/list.ts +46 -46
  191. package/src/commands/logs.ts +63 -63
  192. package/src/commands/mcp.ts +94 -92
  193. package/src/commands/open.ts +129 -129
  194. package/src/commands/refresh.ts +137 -147
  195. package/src/commands/remove.ts +98 -98
  196. package/src/commands/start.ts +117 -117
  197. package/src/commands/status.ts +54 -54
  198. package/src/commands/stop.ts +55 -55
  199. package/src/commands/sync.ts +147 -151
  200. package/src/commands/tui.ts +484 -424
  201. package/src/commands/ui.ts +111 -111
  202. package/src/core/adapters/local-storage.ts +66 -0
  203. package/src/core/adapters/obsidian-storage.ts +151 -0
  204. package/src/core/adapters/registry.ts +44 -0
  205. package/src/core/adapters/storage.test.ts +174 -0
  206. package/src/core/adapters/vault-storage.ts +86 -0
  207. package/src/core/config.test.ts +96 -96
  208. package/src/core/config.ts +140 -115
  209. package/src/core/graph.ts +344 -344
  210. package/src/core/plugins/index.ts +17 -0
  211. package/src/core/plugins/loader.ts +36 -0
  212. package/src/core/ports/storage.ts +71 -0
  213. package/src/core/scanner.test.ts +61 -61
  214. package/src/core/scanner.ts +91 -91
  215. package/src/core/storage.ts +37 -0
  216. package/src/core/workspace.ts +487 -380
  217. package/src/core/worktree.ts +120 -120
  218. package/src/generators/antigravity.ts +32 -32
  219. package/src/generators/base.ts +243 -240
  220. package/src/generators/claude.ts +34 -34
  221. package/src/generators/codex.ts +48 -48
  222. package/src/generators/copilot.ts +56 -56
  223. package/src/generators/cursor.ts +44 -44
  224. package/src/generators/diff-context.ts +75 -0
  225. package/src/generators/index.ts +322 -250
  226. package/src/generators/map-generator.test.ts +159 -159
  227. package/src/generators/map-generator.ts +539 -542
  228. package/src/generators/plan-generator.ts +483 -481
  229. package/src/generators/skills-generator.ts +259 -259
  230. package/src/index.ts +539 -426
  231. package/src/mcp/server.ts +294 -294
  232. package/src/orchestration/detect.ts +313 -313
  233. package/src/orchestration/index.ts +7 -7
  234. package/src/orchestration/runner.ts +283 -283
  235. package/src/server.test.ts +618 -555
  236. package/src/server.ts +1314 -1308
  237. package/src/types.ts +415 -408
  238. package/src/utils/detect-ai.test.ts +44 -44
  239. package/src/utils/detect-ai.ts +84 -84
  240. package/src/utils/detect-editors.test.ts +48 -48
  241. package/src/utils/detect-editors.ts +57 -57
  242. package/src/utils/git.test.ts +74 -74
  243. package/src/utils/git.ts +117 -117
  244. package/src/utils/local-ai.test.ts +130 -130
  245. package/src/utils/local-ai.ts +116 -111
  246. package/src/utils/multi-git.ts +313 -313
  247. package/src/utils/prompts.ts +209 -209
  248. package/src/utils/session-finder.ts +483 -483
  249. package/src/utils/system-scanner.test.ts +89 -89
  250. package/src/utils/system-scanner.ts +96 -96
  251. package/src/utils/update-check.ts +286 -309
  252. package/src/utils/workflow-advisor.ts +118 -0
  253. package/src/utils/workflows.test.ts +114 -114
  254. package/src/utils/workflows.ts +178 -178
  255. package/tsconfig.json +19 -19
  256. package/vitest.config.ts +14 -14
  257. package/.github/workflows/release.yml +0 -112
  258. package/dist/commands/pack.d.ts +0 -7
  259. package/dist/commands/pack.d.ts.map +0 -1
  260. package/dist/commands/pack.js +0 -64
  261. package/dist/commands/pack.js.map +0 -1
  262. package/dist/core/packer.d.ts +0 -14
  263. package/dist/core/packer.d.ts.map +0 -1
  264. package/dist/core/packer.js +0 -87
  265. package/dist/core/packer.js.map +0 -1
  266. package/dist/core/packer.test.d.ts +0 -2
  267. package/dist/core/packer.test.d.ts.map +0 -1
  268. package/dist/core/packer.test.js +0 -82
  269. package/dist/core/packer.test.js.map +0 -1
  270. package/dist/gui/assets/index-Ct3qq-X4.js +0 -25
  271. package/dist/gui/assets/index-P_ZrgHXg.css +0 -1
  272. package/src/commands/pack.ts +0 -73
  273. package/src/core/packer.test.ts +0 -99
  274. package/src/core/packer.ts +0 -107
@@ -1,84 +1,84 @@
1
- import React from 'react';
2
- import { BookOpen, RefreshCw, Save, Edit } from 'lucide-react';
3
- import type { Feature } from '../../types.js';
4
-
5
- interface KnowledgeBaseProps {
6
- ws: Feature;
7
- knowledgeContent: string;
8
- knowledgeLoading: boolean;
9
- isEditingKnowledge: boolean;
10
- editedKnowledge: string;
11
- saveKnowledgeLoading: boolean;
12
- setEditedKnowledge: (val: string) => void;
13
- setIsEditingKnowledge: (val: boolean) => void;
14
- handleSaveKnowledge: (wsId: string) => Promise<void>;
15
- }
16
-
17
- export const KnowledgeBase: React.FC<KnowledgeBaseProps> = ({
18
- ws,
19
- knowledgeContent,
20
- knowledgeLoading,
21
- isEditingKnowledge,
22
- editedKnowledge,
23
- saveKnowledgeLoading,
24
- setEditedKnowledge,
25
- setIsEditingKnowledge,
26
- handleSaveKnowledge,
27
- }) => {
28
- return (
29
- <div className="bg-[#090d1a]/20 border border-gray-800/60 rounded-xl p-4">
30
- <header className="flex justify-between items-center mb-4">
31
- <h4 className="text-sm font-bold text-white flex items-center gap-2">
32
- <BookOpen size={16} className="text-cyan-400" /> Persistent Knowledge Memory (nexusflow-knowledge.md)
33
- </h4>
34
- <div className="flex gap-2">
35
- {isEditingKnowledge ? (
36
- <>
37
- <button
38
- className="px-2.5 py-1.5 bg-gray-900 border border-gray-800 hover:bg-gray-850 rounded-lg text-[10px] font-semibold transition-all cursor-pointer text-gray-400"
39
- onClick={() => {
40
- setEditedKnowledge(knowledgeContent);
41
- setIsEditingKnowledge(false);
42
- }}
43
- disabled={saveKnowledgeLoading}
44
- >
45
- Cancel
46
- </button>
47
- <button
48
- className="inline-flex items-center gap-1.5 px-2.5 py-1.5 bg-indigo-650 hover:bg-indigo-600 text-white rounded-lg text-[10px] font-semibold transition-all cursor-pointer"
49
- onClick={() => handleSaveKnowledge(ws.branchName)}
50
- disabled={saveKnowledgeLoading}
51
- >
52
- {saveKnowledgeLoading ? <RefreshCw className="animate-spin" size={10} /> : <Save size={10} />} Save
53
- </button>
54
- </>
55
- ) : (
56
- <button
57
- className="inline-flex items-center gap-1.5 px-2.5 py-1.5 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-gray-700 rounded-lg text-[10px] font-semibold transition-all cursor-pointer text-gray-350"
58
- onClick={() => setIsEditingKnowledge(true)}
59
- disabled={knowledgeLoading}
60
- >
61
- <Edit size={10} /> Edit Knowledge
62
- </button>
63
- )}
64
- </div>
65
- </header>
66
-
67
- {knowledgeLoading ? (
68
- <div className="flex justify-center py-10">
69
- <RefreshCw className="animate-spin text-indigo-400" size={20} />
70
- </div>
71
- ) : isEditingKnowledge ? (
72
- <textarea
73
- className="w-full h-96 bg-gray-950/60 border border-gray-800/80 rounded-xl p-4 text-xs font-mono text-gray-305 focus:outline-none focus:border-indigo-500/80 resize-y"
74
- value={editedKnowledge}
75
- onChange={(e) => setEditedKnowledge(e.target.value)}
76
- />
77
- ) : (
78
- <div className="bg-gray-950/40 border border-gray-800/30 rounded-xl p-4 text-gray-350 text-xs leading-relaxed overflow-auto font-mono whitespace-pre-wrap max-h-96">
79
- {knowledgeContent || "No knowledge file generated yet."}
80
- </div>
81
- )}
82
- </div>
83
- );
84
- };
1
+ import React from 'react';
2
+ import { BookOpen, RefreshCw, Save, Edit } from 'lucide-react';
3
+ import type { Feature } from '../../types.js';
4
+
5
+ interface KnowledgeBaseProps {
6
+ ws: Feature;
7
+ knowledgeContent: string;
8
+ knowledgeLoading: boolean;
9
+ isEditingKnowledge: boolean;
10
+ editedKnowledge: string;
11
+ saveKnowledgeLoading: boolean;
12
+ setEditedKnowledge: (val: string) => void;
13
+ setIsEditingKnowledge: (val: boolean) => void;
14
+ handleSaveKnowledge: (wsId: string) => Promise<void>;
15
+ }
16
+
17
+ export const KnowledgeBase: React.FC<KnowledgeBaseProps> = ({
18
+ ws,
19
+ knowledgeContent,
20
+ knowledgeLoading,
21
+ isEditingKnowledge,
22
+ editedKnowledge,
23
+ saveKnowledgeLoading,
24
+ setEditedKnowledge,
25
+ setIsEditingKnowledge,
26
+ handleSaveKnowledge,
27
+ }) => {
28
+ return (
29
+ <div className="bg-[#090d1a]/20 border border-gray-800/60 rounded-xl p-4">
30
+ <header className="flex justify-between items-center mb-4">
31
+ <h4 className="text-sm font-bold text-white flex items-center gap-2">
32
+ <BookOpen size={16} className="text-cyan-400" /> Persistent Knowledge Memory (nexusflow-knowledge.md)
33
+ </h4>
34
+ <div className="flex gap-2">
35
+ {isEditingKnowledge ? (
36
+ <>
37
+ <button
38
+ className="px-2.5 py-1.5 bg-gray-900 border border-gray-800 hover:bg-gray-850 rounded-lg text-[10px] font-semibold transition-all cursor-pointer text-gray-400"
39
+ onClick={() => {
40
+ setEditedKnowledge(knowledgeContent);
41
+ setIsEditingKnowledge(false);
42
+ }}
43
+ disabled={saveKnowledgeLoading}
44
+ >
45
+ Cancel
46
+ </button>
47
+ <button
48
+ className="inline-flex items-center gap-1.5 px-2.5 py-1.5 bg-indigo-650 hover:bg-indigo-600 text-white rounded-lg text-[10px] font-semibold transition-all cursor-pointer"
49
+ onClick={() => handleSaveKnowledge(ws.branchName)}
50
+ disabled={saveKnowledgeLoading}
51
+ >
52
+ {saveKnowledgeLoading ? <RefreshCw className="animate-spin" size={10} /> : <Save size={10} />} Save
53
+ </button>
54
+ </>
55
+ ) : (
56
+ <button
57
+ className="inline-flex items-center gap-1.5 px-2.5 py-1.5 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-gray-700 rounded-lg text-[10px] font-semibold transition-all cursor-pointer text-gray-350"
58
+ onClick={() => setIsEditingKnowledge(true)}
59
+ disabled={knowledgeLoading}
60
+ >
61
+ <Edit size={10} /> Edit Knowledge
62
+ </button>
63
+ )}
64
+ </div>
65
+ </header>
66
+
67
+ {knowledgeLoading ? (
68
+ <div className="flex justify-center py-10">
69
+ <RefreshCw className="animate-spin text-indigo-400" size={20} />
70
+ </div>
71
+ ) : isEditingKnowledge ? (
72
+ <textarea
73
+ className="w-full h-96 bg-gray-950/60 border border-gray-800/80 rounded-xl p-4 text-xs font-mono text-gray-305 focus:outline-none focus:border-indigo-500/80 resize-y"
74
+ value={editedKnowledge}
75
+ onChange={(e) => setEditedKnowledge(e.target.value)}
76
+ />
77
+ ) : (
78
+ <div className="bg-gray-950/40 border border-gray-800/30 rounded-xl p-4 text-gray-350 text-xs leading-relaxed overflow-auto font-mono whitespace-pre-wrap max-h-96">
79
+ {knowledgeContent || "No knowledge file generated yet."}
80
+ </div>
81
+ )}
82
+ </div>
83
+ );
84
+ };
@@ -1,230 +1,230 @@
1
- import React from 'react';
2
- import { Sparkles, Settings as SettingsIcon, ArrowRight } from 'lucide-react';
3
- import type { NexusFlowConfig } from '../../types.js';
4
-
5
- interface OnboardingWizardProps {
6
- config: NexusFlowConfig;
7
- defaultPaths: { devDir: string; workspacesDir: string } | null;
8
- setConfig: (cfg: NexusFlowConfig) => void;
9
- saveAppConfig: (cfg: NexusFlowConfig) => Promise<void>;
10
- }
11
-
12
- export const OnboardingWizard: React.FC<OnboardingWizardProps> = ({
13
- config,
14
- defaultPaths,
15
- setConfig,
16
- saveAppConfig,
17
- }) => {
18
- const isFormValid = config.devDir.trim() !== '' && config.workspacesDir.trim() !== '';
19
-
20
- return (
21
- <div className="flex min-h-screen bg-[#070913] text-gray-100 font-sans items-center justify-center p-6 bg-gradient-to-br from-[#0c0f24] via-[#070913] to-[#04050b]">
22
- {/* Onboarding Box */}
23
- <div className="max-w-6xl w-full bg-[#111827]/40 border border-gray-800/80 rounded-2xl p-8 backdrop-blur-md shadow-2xl grid grid-cols-1 lg:grid-cols-12 gap-10">
24
-
25
- {/* Left Column: Onboarding Guide & Concepts */}
26
- <div className="lg:col-span-7 flex flex-col justify-between">
27
- <div>
28
- <div className="inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-indigo-500/10 text-indigo-400 border border-indigo-500/20 text-xs font-semibold uppercase tracking-wider mb-4">
29
- <Sparkles size={12} className="text-cyan-400 animate-pulse" /> Onboarding Guide
30
- </div>
31
- <h1 className="text-3xl font-extrabold tracking-tight text-white mb-2 bg-gradient-to-r from-white via-gray-200 to-indigo-300 bg-clip-text text-transparent">
32
- Welcome to NexusFlow
33
- </h1>
34
- <p className="text-sm text-gray-400 mb-8 max-w-xl">
35
- NexusFlow orchestrates multi-repository developer environments. It combines isolated Git worktrees, automatic code analyzer sweeps, and background process running into a single dashboard.
36
- </p>
37
-
38
- {/* Onboarding Steps */}
39
- <div className="space-y-6">
40
- <div className="flex gap-4">
41
- <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
42
- 1
43
- </div>
44
- <div>
45
- <h3 className="text-sm font-semibold text-white">Configure Development Folders</h3>
46
- <p className="text-xs text-gray-400 mt-1">
47
- Specify your local code path and target workspaces path. For the first setup, these paths start empty so you can explicitly configure them.
48
- </p>
49
- </div>
50
- </div>
51
-
52
- <div className="flex gap-4">
53
- <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
54
- 2
55
- </div>
56
- <div>
57
- <h3 className="text-sm font-semibold text-white">Build Isolated Branch Workspaces</h3>
58
- <p className="text-xs text-gray-400 mt-1">
59
- Choose repositories and input your feature branch. NexusFlow runs <code>git worktree</code> to checkout dependencies under a unified folder structure, leaving your primary repository directories clean.
60
- </p>
61
- </div>
62
- </div>
63
-
64
- <div className="flex gap-4">
65
- <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
66
- 3
67
- </div>
68
- <div>
69
- <h3 className="text-sm font-semibold text-white">Align AI Coding Contexts</h3>
70
- <p className="text-xs text-gray-400 mt-1">
71
- NexusFlow automatically generates configuration files (<code>CLAUDE.md</code>, <code>.cursorrules</code>, <code>AGENTS.md</code>) that instruct the AI assistant to analyze project inter-dependencies, document its assumptions in <code>nexusflow-overview.md</code>, and highlight clarifying questions.
72
- </p>
73
- </div>
74
- </div>
75
-
76
- <div className="flex gap-4">
77
- <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
78
- 4
79
- </div>
80
- <div>
81
- <h3 className="text-sm font-semibold text-white">Orchestrate Background Services</h3>
82
- <p className="text-xs text-gray-400 mt-1">
83
- Run APIs, database scripts, and frontend watch tasks concurrently from the web portal. Monitor real-time logs inside a unified terminal pane.
84
- </p>
85
- </div>
86
- </div>
87
- </div>
88
- </div>
89
-
90
- {/* Comparison Dashboard */}
91
- <div className="mt-8 pt-6 border-t border-gray-800/80">
92
- <h4 className="text-xs font-semibold uppercase tracking-wider text-gray-500 mb-3">Industry Comparison</h4>
93
- <div className="overflow-x-auto font-sans">
94
- <table className="w-full text-[10px] text-gray-400 text-left border-collapse">
95
- <thead>
96
- <tr className="border-b border-gray-800 text-gray-500">
97
- <th className="py-2 pr-4 font-semibold">Orchestrator</th>
98
- <th className="py-2 px-4 font-semibold">Multi-Repo</th>
99
- <th className="py-2 px-4 font-semibold">AI Rules Integration</th>
100
- <th className="py-2 pl-4 font-semibold">Weight</th>
101
- </tr>
102
- </thead>
103
- <tbody>
104
- <tr className="border-b border-gray-800/40">
105
- <td className="py-2 pr-4 font-semibold text-white">Docker Compose</td>
106
- <td className="py-2 px-4">Yes (Containers only)</td>
107
- <td className="py-2 px-4">No</td>
108
- <td className="py-2 pl-4">Medium (VM overhead)</td>
109
- </tr>
110
- <tr className="border-b border-gray-800/40">
111
- <td className="py-2 pr-4 font-semibold text-white">Lerna / Turborepo</td>
112
- <td className="py-2 px-4">Monorepo only</td>
113
- <td className="py-2 px-4">No</td>
114
- <td className="py-2 pl-4">Light</td>
115
- </tr>
116
- <tr className="border-b border-gray-800/40">
117
- <td className="py-2 pr-4 font-semibold text-white">DevPod / Gitpod</td>
118
- <td className="py-2 px-4">Yes (Complex config)</td>
119
- <td className="py-2 px-4">No</td>
120
- <td className="py-2 pl-4">Heavy (Full virtual VM)</td>
121
- </tr>
122
- <tr>
123
- <td className="py-2 pr-4 font-semibold text-indigo-400">NexusFlow</td>
124
- <td className="py-2 px-4 text-indigo-300">Yes (Native Worktrees)</td>
125
- <td className="py-2 px-4 text-indigo-300">Yes (CLAUDE.md/MDC rules)</td>
126
- <td className="py-2 pl-4 text-indigo-300">Extremely Light (Native processes)</td>
127
- </tr>
128
- </tbody>
129
- </table>
130
- </div>
131
- </div>
132
- </div>
133
-
134
- {/* Right Column: Configuration Form */}
135
- <div className="lg:col-span-5 flex flex-col justify-center">
136
- <div className="bg-gray-950/40 border border-gray-800/80 rounded-2xl p-6 shadow-lg">
137
- <h2 className="text-xl font-bold text-white mb-1 flex items-center gap-2">
138
- <SettingsIcon className="text-indigo-400 animate-spin-slow" size={20} /> Initialize Config
139
- </h2>
140
- <p className="text-xs text-gray-500 mb-6">
141
- Define the directories on your machine. The fields are empty so you can provide your paths.
142
- </p>
143
-
144
- {/* Form Input fields */}
145
- <div className="space-y-5">
146
- <div>
147
- <label className="block text-[11px] font-semibold text-gray-400 uppercase tracking-wider mb-2">Development Directory</label>
148
- <input
149
- type="text"
150
- className="w-full bg-[#111827] border border-gray-800 focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500 rounded-lg px-4 py-3 text-white placeholder-gray-600 transition-all outline-none text-xs shadow-inner"
151
- placeholder="e.g. C:\Users\username\dev"
152
- value={config.devDir}
153
- onChange={(e) => setConfig({ ...config, devDir: e.target.value })}
154
- />
155
- {defaultPaths && (
156
- <div className="text-[10px] text-gray-500 mt-1.5 flex justify-between items-center">
157
- <span>Suggested: <code>{defaultPaths.devDir}</code></span>
158
- </div>
159
- )}
160
- </div>
161
-
162
- <div>
163
- <label className="block text-[11px] font-semibold text-gray-400 uppercase tracking-wider mb-2">Workspaces Directory</label>
164
- <input
165
- type="text"
166
- className="w-full bg-[#111827] border border-gray-800 focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500 rounded-lg px-4 py-3 text-white placeholder-gray-600 transition-all outline-none text-xs shadow-inner"
167
- placeholder="e.g. C:\Users\username\dev\workspaces"
168
- value={config.workspacesDir}
169
- onChange={(e) => setConfig({ ...config, workspacesDir: e.target.value })}
170
- />
171
- {defaultPaths && (
172
- <div className="text-[10px] text-gray-500 mt-1.5 flex justify-between items-center">
173
- <span>Suggested: <code>{defaultPaths.workspacesDir}</code></span>
174
- </div>
175
- )}
176
- </div>
177
-
178
- {/* Form Buttons */}
179
- <div className="flex gap-2 pt-2">
180
- <button
181
- type="button"
182
- className="flex-1 inline-flex items-center justify-center gap-1.5 px-3 py-2 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-gray-700 rounded-lg text-xs font-semibold transition-all cursor-pointer"
183
- onClick={() => {
184
- if (defaultPaths) {
185
- setConfig({
186
- ...config,
187
- devDir: defaultPaths.devDir,
188
- workspacesDir: defaultPaths.workspacesDir,
189
- });
190
- }
191
- }}
192
- >
193
- Suggest Defaults
194
- </button>
195
- <button
196
- type="button"
197
- className="px-3 py-2 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-rose-900/60 hover:text-rose-400 rounded-lg text-xs font-semibold transition-all cursor-pointer"
198
- onClick={() => {
199
- setConfig({
200
- ...config,
201
- devDir: '',
202
- workspacesDir: '',
203
- version: config.version,
204
- defaultAssistant: config.defaultAssistant,
205
- scanDepth: config.scanDepth,
206
- });
207
- }}
208
- >
209
- Clear
210
- </button>
211
- </div>
212
-
213
- {/* Save Button */}
214
- <div className="pt-4">
215
- <button
216
- type="button"
217
- className="w-full inline-flex items-center justify-center gap-2 px-5 py-3 rounded-lg text-sm font-semibold bg-gradient-to-r from-indigo-500 to-indigo-600 hover:from-indigo-600 hover:to-indigo-700 text-white shadow-lg shadow-indigo-500/20 hover:-translate-y-0.5 active:translate-y-0 disabled:opacity-40 disabled:cursor-not-allowed disabled:hover:translate-y-0 transition-all cursor-pointer"
218
- disabled={!isFormValid}
219
- onClick={() => saveAppConfig(config)}
220
- >
221
- Save & Get Started <ArrowRight size={16} />
222
- </button>
223
- </div>
224
- </div>
225
- </div>
226
- </div>
227
- </div>
228
- </div>
229
- );
230
- };
1
+ import React from 'react';
2
+ import { Sparkles, Settings as SettingsIcon, ArrowRight } from 'lucide-react';
3
+ import type { NexusFlowConfig } from '../../types.js';
4
+
5
+ interface OnboardingWizardProps {
6
+ config: NexusFlowConfig;
7
+ defaultPaths: { devDir: string; workspacesDir: string } | null;
8
+ setConfig: (cfg: NexusFlowConfig) => void;
9
+ saveAppConfig: (cfg: NexusFlowConfig) => Promise<void>;
10
+ }
11
+
12
+ export const OnboardingWizard: React.FC<OnboardingWizardProps> = ({
13
+ config,
14
+ defaultPaths,
15
+ setConfig,
16
+ saveAppConfig,
17
+ }) => {
18
+ const isFormValid = config.devDir.trim() !== '' && config.workspacesDir.trim() !== '';
19
+
20
+ return (
21
+ <div className="flex min-h-screen bg-[#070913] text-gray-100 font-sans items-center justify-center p-6 bg-gradient-to-br from-[#0c0f24] via-[#070913] to-[#04050b]">
22
+ {/* Onboarding Box */}
23
+ <div className="max-w-6xl w-full bg-[#111827]/40 border border-gray-800/80 rounded-2xl p-8 backdrop-blur-md shadow-2xl grid grid-cols-1 lg:grid-cols-12 gap-10">
24
+
25
+ {/* Left Column: Onboarding Guide & Concepts */}
26
+ <div className="lg:col-span-7 flex flex-col justify-between">
27
+ <div>
28
+ <div className="inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-indigo-500/10 text-indigo-400 border border-indigo-500/20 text-xs font-semibold uppercase tracking-wider mb-4">
29
+ <Sparkles size={12} className="text-cyan-400 animate-pulse" /> Onboarding Guide
30
+ </div>
31
+ <h1 className="text-3xl font-extrabold tracking-tight text-white mb-2 bg-gradient-to-r from-white via-gray-200 to-indigo-300 bg-clip-text text-transparent">
32
+ Welcome to NexusFlow
33
+ </h1>
34
+ <p className="text-sm text-gray-400 mb-8 max-w-xl">
35
+ NexusFlow orchestrates multi-repository developer environments. It combines isolated Git worktrees, automatic code analyzer sweeps, and background process running into a single dashboard.
36
+ </p>
37
+
38
+ {/* Onboarding Steps */}
39
+ <div className="space-y-6">
40
+ <div className="flex gap-4">
41
+ <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
42
+ 1
43
+ </div>
44
+ <div>
45
+ <h3 className="text-sm font-semibold text-white">Configure Development Folders</h3>
46
+ <p className="text-xs text-gray-400 mt-1">
47
+ Specify your local code path and target workspaces path. For the first setup, these paths start empty so you can explicitly configure them.
48
+ </p>
49
+ </div>
50
+ </div>
51
+
52
+ <div className="flex gap-4">
53
+ <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
54
+ 2
55
+ </div>
56
+ <div>
57
+ <h3 className="text-sm font-semibold text-white">Build Isolated Branch Workspaces</h3>
58
+ <p className="text-xs text-gray-400 mt-1">
59
+ Choose repositories and input your feature branch. NexusFlow runs <code>git worktree</code> to checkout dependencies under a unified folder structure, leaving your primary repository directories clean.
60
+ </p>
61
+ </div>
62
+ </div>
63
+
64
+ <div className="flex gap-4">
65
+ <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
66
+ 3
67
+ </div>
68
+ <div>
69
+ <h3 className="text-sm font-semibold text-white">Align AI Coding Contexts</h3>
70
+ <p className="text-xs text-gray-400 mt-1">
71
+ NexusFlow automatically generates configuration files (<code>CLAUDE.md</code>, <code>.cursorrules</code>, <code>AGENTS.md</code>) that instruct the AI assistant to analyze project inter-dependencies, document its assumptions in <code>nexusflow-overview.md</code>, and highlight clarifying questions.
72
+ </p>
73
+ </div>
74
+ </div>
75
+
76
+ <div className="flex gap-4">
77
+ <div className="w-8 h-8 rounded-full bg-indigo-500/10 border border-indigo-500/20 text-indigo-400 flex items-center justify-center font-bold text-sm shrink-0">
78
+ 4
79
+ </div>
80
+ <div>
81
+ <h3 className="text-sm font-semibold text-white">Orchestrate Background Services</h3>
82
+ <p className="text-xs text-gray-400 mt-1">
83
+ Run APIs, database scripts, and frontend watch tasks concurrently from the web portal. Monitor real-time logs inside a unified terminal pane.
84
+ </p>
85
+ </div>
86
+ </div>
87
+ </div>
88
+ </div>
89
+
90
+ {/* Comparison Dashboard */}
91
+ <div className="mt-8 pt-6 border-t border-gray-800/80">
92
+ <h4 className="text-xs font-semibold uppercase tracking-wider text-gray-500 mb-3">Industry Comparison</h4>
93
+ <div className="overflow-x-auto font-sans">
94
+ <table className="w-full text-[10px] text-gray-400 text-left border-collapse">
95
+ <thead>
96
+ <tr className="border-b border-gray-800 text-gray-500">
97
+ <th className="py-2 pr-4 font-semibold">Orchestrator</th>
98
+ <th className="py-2 px-4 font-semibold">Multi-Repo</th>
99
+ <th className="py-2 px-4 font-semibold">AI Rules Integration</th>
100
+ <th className="py-2 pl-4 font-semibold">Weight</th>
101
+ </tr>
102
+ </thead>
103
+ <tbody>
104
+ <tr className="border-b border-gray-800/40">
105
+ <td className="py-2 pr-4 font-semibold text-white">Docker Compose</td>
106
+ <td className="py-2 px-4">Yes (Containers only)</td>
107
+ <td className="py-2 px-4">No</td>
108
+ <td className="py-2 pl-4">Medium (VM overhead)</td>
109
+ </tr>
110
+ <tr className="border-b border-gray-800/40">
111
+ <td className="py-2 pr-4 font-semibold text-white">Lerna / Turborepo</td>
112
+ <td className="py-2 px-4">Monorepo only</td>
113
+ <td className="py-2 px-4">No</td>
114
+ <td className="py-2 pl-4">Light</td>
115
+ </tr>
116
+ <tr className="border-b border-gray-800/40">
117
+ <td className="py-2 pr-4 font-semibold text-white">DevPod / Gitpod</td>
118
+ <td className="py-2 px-4">Yes (Complex config)</td>
119
+ <td className="py-2 px-4">No</td>
120
+ <td className="py-2 pl-4">Heavy (Full virtual VM)</td>
121
+ </tr>
122
+ <tr>
123
+ <td className="py-2 pr-4 font-semibold text-indigo-400">NexusFlow</td>
124
+ <td className="py-2 px-4 text-indigo-300">Yes (Native Worktrees)</td>
125
+ <td className="py-2 px-4 text-indigo-300">Yes (CLAUDE.md/MDC rules)</td>
126
+ <td className="py-2 pl-4 text-indigo-300">Extremely Light (Native processes)</td>
127
+ </tr>
128
+ </tbody>
129
+ </table>
130
+ </div>
131
+ </div>
132
+ </div>
133
+
134
+ {/* Right Column: Configuration Form */}
135
+ <div className="lg:col-span-5 flex flex-col justify-center">
136
+ <div className="bg-gray-950/40 border border-gray-800/80 rounded-2xl p-6 shadow-lg">
137
+ <h2 className="text-xl font-bold text-white mb-1 flex items-center gap-2">
138
+ <SettingsIcon className="text-indigo-400 animate-spin-slow" size={20} /> Initialize Config
139
+ </h2>
140
+ <p className="text-xs text-gray-500 mb-6">
141
+ Define the directories on your machine. The fields are empty so you can provide your paths.
142
+ </p>
143
+
144
+ {/* Form Input fields */}
145
+ <div className="space-y-5">
146
+ <div>
147
+ <label className="block text-[11px] font-semibold text-gray-400 uppercase tracking-wider mb-2">Development Directory</label>
148
+ <input
149
+ type="text"
150
+ className="w-full bg-[#111827] border border-gray-800 focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500 rounded-lg px-4 py-3 text-white placeholder-gray-600 transition-all outline-none text-xs shadow-inner"
151
+ placeholder="e.g. C:\Users\username\dev"
152
+ value={config.devDir}
153
+ onChange={(e) => setConfig({ ...config, devDir: e.target.value })}
154
+ />
155
+ {defaultPaths && (
156
+ <div className="text-[10px] text-gray-500 mt-1.5 flex justify-between items-center">
157
+ <span>Suggested: <code>{defaultPaths.devDir}</code></span>
158
+ </div>
159
+ )}
160
+ </div>
161
+
162
+ <div>
163
+ <label className="block text-[11px] font-semibold text-gray-400 uppercase tracking-wider mb-2">Workspaces Directory</label>
164
+ <input
165
+ type="text"
166
+ className="w-full bg-[#111827] border border-gray-800 focus:border-indigo-500 focus:ring-1 focus:ring-indigo-500 rounded-lg px-4 py-3 text-white placeholder-gray-600 transition-all outline-none text-xs shadow-inner"
167
+ placeholder="e.g. C:\Users\username\dev\workspaces"
168
+ value={config.workspacesDir}
169
+ onChange={(e) => setConfig({ ...config, workspacesDir: e.target.value })}
170
+ />
171
+ {defaultPaths && (
172
+ <div className="text-[10px] text-gray-500 mt-1.5 flex justify-between items-center">
173
+ <span>Suggested: <code>{defaultPaths.workspacesDir}</code></span>
174
+ </div>
175
+ )}
176
+ </div>
177
+
178
+ {/* Form Buttons */}
179
+ <div className="flex gap-2 pt-2">
180
+ <button
181
+ type="button"
182
+ className="flex-1 inline-flex items-center justify-center gap-1.5 px-3 py-2 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-gray-700 rounded-lg text-xs font-semibold transition-all cursor-pointer"
183
+ onClick={() => {
184
+ if (defaultPaths) {
185
+ setConfig({
186
+ ...config,
187
+ devDir: defaultPaths.devDir,
188
+ workspacesDir: defaultPaths.workspacesDir,
189
+ });
190
+ }
191
+ }}
192
+ >
193
+ Suggest Defaults
194
+ </button>
195
+ <button
196
+ type="button"
197
+ className="px-3 py-2 bg-gray-900 border border-gray-800 hover:bg-gray-800 hover:border-rose-900/60 hover:text-rose-400 rounded-lg text-xs font-semibold transition-all cursor-pointer"
198
+ onClick={() => {
199
+ setConfig({
200
+ ...config,
201
+ devDir: '',
202
+ workspacesDir: '',
203
+ version: config.version,
204
+ defaultAssistant: config.defaultAssistant,
205
+ scanDepth: config.scanDepth,
206
+ });
207
+ }}
208
+ >
209
+ Clear
210
+ </button>
211
+ </div>
212
+
213
+ {/* Save Button */}
214
+ <div className="pt-4">
215
+ <button
216
+ type="button"
217
+ className="w-full inline-flex items-center justify-center gap-2 px-5 py-3 rounded-lg text-sm font-semibold bg-gradient-to-r from-indigo-500 to-indigo-600 hover:from-indigo-600 hover:to-indigo-700 text-white shadow-lg shadow-indigo-500/20 hover:-translate-y-0.5 active:translate-y-0 disabled:opacity-40 disabled:cursor-not-allowed disabled:hover:translate-y-0 transition-all cursor-pointer"
218
+ disabled={!isFormValid}
219
+ onClick={() => saveAppConfig(config)}
220
+ >
221
+ Save & Get Started <ArrowRight size={16} />
222
+ </button>
223
+ </div>
224
+ </div>
225
+ </div>
226
+ </div>
227
+ </div>
228
+ </div>
229
+ );
230
+ };