@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,178 +1,178 @@
1
- import * as fs from 'node:fs/promises';
2
- import * as path from 'node:path';
3
- import * as os from 'node:os';
4
- import { fileURLToPath } from 'node:url';
5
-
6
- const __filename = fileURLToPath(import.meta.url);
7
- const __dirname = path.dirname(__filename);
8
-
9
- export interface WorkflowTemplate {
10
- id: string;
11
- name: string;
12
- description: string;
13
- content: string;
14
- custom: boolean;
15
- }
16
-
17
- function parseMarkdownTemplate(id: string, content: string): Omit<WorkflowTemplate, 'id' | 'custom'> {
18
- const lines = content.split('\n');
19
- let name = id.split('-').map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(' ');
20
- let description = '';
21
-
22
- // Extract name from the first H1 header (# Name)
23
- for (const line of lines) {
24
- if (line.startsWith('# ')) {
25
- name = line.substring(2).trim();
26
- break;
27
- }
28
- }
29
-
30
- // Extract description from the first non-empty text paragraph below the H1 header
31
- let foundHeader = false;
32
- for (const line of lines) {
33
- const trimmed = line.trim();
34
- if (trimmed.startsWith('# ')) {
35
- foundHeader = true;
36
- continue;
37
- }
38
- if (foundHeader && trimmed.length > 0 && !trimmed.startsWith('#') && !trimmed.startsWith('>')) {
39
- description = trimmed;
40
- // Truncate to first sentence or 120 chars
41
- const sentenceEnd = description.indexOf('.');
42
- if (sentenceEnd !== -1) {
43
- description = description.substring(0, sentenceEnd + 1);
44
- }
45
- if (description.length > 120) {
46
- description = description.substring(0, 117) + '...';
47
- }
48
- break;
49
- }
50
- }
51
-
52
- // Fallbacks for built-in templates if none extracted
53
- if (!description) {
54
- if (id === 'plan-implement-review') {
55
- description = 'Lead planner designs, Code Implementer subagent writes edits, and Code Reviewer subagent tests & reviews in a loop.';
56
- } else if (id === 'research-verify') {
57
- description = 'Research specialist subagent analyzes codebase, followed by test-driven developer subagent implementation.';
58
- } else if (id === 'solo-developer') {
59
- description = 'Direct coding and verification by the primary agent without subagent delegation overhead.';
60
- } else {
61
- description = 'Custom user-defined teamwork strategy.';
62
- }
63
- }
64
-
65
- return { name, description, content };
66
- }
67
-
68
- async function loadTemplatesFromDir(dirPath: string, custom: boolean): Promise<WorkflowTemplate[]> {
69
- const templates: WorkflowTemplate[] = [];
70
- try {
71
- const files = await fs.readdir(dirPath);
72
- for (const file of files) {
73
- if (!file.endsWith('.md')) continue;
74
- const id = path.basename(file, '.md');
75
- const content = await fs.readFile(path.join(dirPath, file), 'utf-8');
76
- const parsed = parseMarkdownTemplate(id, content);
77
- templates.push({
78
- id,
79
- custom,
80
- ...parsed,
81
- });
82
- }
83
- } catch (error) {
84
- // Only log if directory exists (ignoring non-existent custom folder log spam)
85
- if ((error as any).code !== 'ENOENT') {
86
- console.error(`Failed to read templates from ${dirPath}:`, error);
87
- }
88
- }
89
- return templates;
90
- }
91
-
92
- export async function getWorkflowTemplates(): Promise<WorkflowTemplate[]> {
93
- const builtInDir = path.resolve(__dirname, '../resources/workflows');
94
- const userDir = path.join(os.homedir(), '.nexusflow', 'workflows');
95
-
96
- // Ensure user custom workflows directory exists so they can find it easily
97
- try {
98
- await fs.mkdir(userDir, { recursive: true });
99
- } catch {}
100
-
101
- const [builtInTemplates, userTemplates] = await Promise.all([
102
- loadTemplatesFromDir(builtInDir, false),
103
- loadTemplatesFromDir(userDir, true)
104
- ]);
105
-
106
- // Merge templates (user custom templates override built-in if they share the same ID)
107
- const templateMap = new Map<string, WorkflowTemplate>();
108
-
109
- for (const t of builtInTemplates) {
110
- templateMap.set(t.id, t);
111
- }
112
- for (const t of userTemplates) {
113
- templateMap.set(t.id, t);
114
- }
115
-
116
- return Array.from(templateMap.values());
117
- }
118
-
119
- export async function saveWorkflowTemplate(name: string, content: string, originalId?: string): Promise<WorkflowTemplate> {
120
- const userDir = path.join(os.homedir(), '.nexusflow', 'workflows');
121
- await fs.mkdir(userDir, { recursive: true });
122
-
123
- // Extract name from the first H1 header (# Name) in content if present
124
- let parsedName = name;
125
- const lines = content.split('\n');
126
- for (const line of lines) {
127
- if (line.trim().startsWith('# ')) {
128
- parsedName = line.trim().substring(2).trim();
129
- break;
130
- }
131
- }
132
-
133
- const id = parsedName
134
- .toLowerCase()
135
- .replace(/[^a-z0-9]+/g, '-')
136
- .replace(/(^-|-$)/g, '');
137
-
138
- if (!id) {
139
- throw new Error('Invalid template name');
140
- }
141
-
142
- // Ensure content starts with "# <Name>" header so it parses correctly next time
143
- let fileContent = content.trim();
144
- if (!fileContent.startsWith('# ')) {
145
- fileContent = `# ${parsedName}\n\n${fileContent}`;
146
- }
147
-
148
- const filePath = path.join(userDir, `${id}.md`);
149
- await fs.writeFile(filePath, fileContent, 'utf-8');
150
-
151
- // If we are editing an existing custom template and the ID changed, delete the old file
152
- if (originalId && originalId !== id) {
153
- const oldPath = path.join(userDir, `${originalId}.md`);
154
- try {
155
- await fs.unlink(oldPath);
156
- } catch {}
157
- }
158
-
159
- const parsed = parseMarkdownTemplate(id, fileContent);
160
- return {
161
- id,
162
- custom: true,
163
- ...parsed,
164
- };
165
- }
166
-
167
- export async function deleteWorkflowTemplate(id: string): Promise<void> {
168
- const userDir = path.join(os.homedir(), '.nexusflow', 'workflows');
169
- const filePath = path.join(userDir, `${id}.md`);
170
-
171
- try {
172
- await fs.unlink(filePath);
173
- } catch (error) {
174
- if ((error as any).code !== 'ENOENT') {
175
- throw error;
176
- }
177
- }
178
- }
1
+ import * as fs from 'node:fs/promises';
2
+ import * as path from 'node:path';
3
+ import * as os from 'node:os';
4
+ import { fileURLToPath } from 'node:url';
5
+
6
+ const __filename = fileURLToPath(import.meta.url);
7
+ const __dirname = path.dirname(__filename);
8
+
9
+ export interface WorkflowTemplate {
10
+ id: string;
11
+ name: string;
12
+ description: string;
13
+ content: string;
14
+ custom: boolean;
15
+ }
16
+
17
+ function parseMarkdownTemplate(id: string, content: string): Omit<WorkflowTemplate, 'id' | 'custom'> {
18
+ const lines = content.split('\n');
19
+ let name = id.split('-').map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(' ');
20
+ let description = '';
21
+
22
+ // Extract name from the first H1 header (# Name)
23
+ for (const line of lines) {
24
+ if (line.startsWith('# ')) {
25
+ name = line.substring(2).trim();
26
+ break;
27
+ }
28
+ }
29
+
30
+ // Extract description from the first non-empty text paragraph below the H1 header
31
+ let foundHeader = false;
32
+ for (const line of lines) {
33
+ const trimmed = line.trim();
34
+ if (trimmed.startsWith('# ')) {
35
+ foundHeader = true;
36
+ continue;
37
+ }
38
+ if (foundHeader && trimmed.length > 0 && !trimmed.startsWith('#') && !trimmed.startsWith('>')) {
39
+ description = trimmed;
40
+ // Truncate to first sentence or 120 chars
41
+ const sentenceEnd = description.indexOf('.');
42
+ if (sentenceEnd !== -1) {
43
+ description = description.substring(0, sentenceEnd + 1);
44
+ }
45
+ if (description.length > 120) {
46
+ description = description.substring(0, 117) + '...';
47
+ }
48
+ break;
49
+ }
50
+ }
51
+
52
+ // Fallbacks for built-in templates if none extracted
53
+ if (!description) {
54
+ if (id === 'plan-implement-review') {
55
+ description = 'Lead planner designs, Code Implementer subagent writes edits, and Code Reviewer subagent tests & reviews in a loop.';
56
+ } else if (id === 'research-verify') {
57
+ description = 'Research specialist subagent analyzes codebase, followed by test-driven developer subagent implementation.';
58
+ } else if (id === 'solo-developer') {
59
+ description = 'Direct coding and verification by the primary agent without subagent delegation overhead.';
60
+ } else {
61
+ description = 'Custom user-defined teamwork strategy.';
62
+ }
63
+ }
64
+
65
+ return { name, description, content };
66
+ }
67
+
68
+ async function loadTemplatesFromDir(dirPath: string, custom: boolean): Promise<WorkflowTemplate[]> {
69
+ const templates: WorkflowTemplate[] = [];
70
+ try {
71
+ const files = await fs.readdir(dirPath);
72
+ for (const file of files) {
73
+ if (!file.endsWith('.md')) continue;
74
+ const id = path.basename(file, '.md');
75
+ const content = await fs.readFile(path.join(dirPath, file), 'utf-8');
76
+ const parsed = parseMarkdownTemplate(id, content);
77
+ templates.push({
78
+ id,
79
+ custom,
80
+ ...parsed,
81
+ });
82
+ }
83
+ } catch (error) {
84
+ // Only log if directory exists (ignoring non-existent custom folder log spam)
85
+ if ((error as any).code !== 'ENOENT') {
86
+ console.error(`Failed to read templates from ${dirPath}:`, error);
87
+ }
88
+ }
89
+ return templates;
90
+ }
91
+
92
+ export async function getWorkflowTemplates(): Promise<WorkflowTemplate[]> {
93
+ const builtInDir = path.resolve(__dirname, '../resources/workflows');
94
+ const userDir = path.join(os.homedir(), '.nexusflow', 'workflows');
95
+
96
+ // Ensure user custom workflows directory exists so they can find it easily
97
+ try {
98
+ await fs.mkdir(userDir, { recursive: true });
99
+ } catch {}
100
+
101
+ const [builtInTemplates, userTemplates] = await Promise.all([
102
+ loadTemplatesFromDir(builtInDir, false),
103
+ loadTemplatesFromDir(userDir, true)
104
+ ]);
105
+
106
+ // Merge templates (user custom templates override built-in if they share the same ID)
107
+ const templateMap = new Map<string, WorkflowTemplate>();
108
+
109
+ for (const t of builtInTemplates) {
110
+ templateMap.set(t.id, t);
111
+ }
112
+ for (const t of userTemplates) {
113
+ templateMap.set(t.id, t);
114
+ }
115
+
116
+ return Array.from(templateMap.values());
117
+ }
118
+
119
+ export async function saveWorkflowTemplate(name: string, content: string, originalId?: string): Promise<WorkflowTemplate> {
120
+ const userDir = path.join(os.homedir(), '.nexusflow', 'workflows');
121
+ await fs.mkdir(userDir, { recursive: true });
122
+
123
+ // Extract name from the first H1 header (# Name) in content if present
124
+ let parsedName = name;
125
+ const lines = content.split('\n');
126
+ for (const line of lines) {
127
+ if (line.trim().startsWith('# ')) {
128
+ parsedName = line.trim().substring(2).trim();
129
+ break;
130
+ }
131
+ }
132
+
133
+ const id = parsedName
134
+ .toLowerCase()
135
+ .replace(/[^a-z0-9]+/g, '-')
136
+ .replace(/(^-|-$)/g, '');
137
+
138
+ if (!id) {
139
+ throw new Error('Invalid template name');
140
+ }
141
+
142
+ // Ensure content starts with "# <Name>" header so it parses correctly next time
143
+ let fileContent = content.trim();
144
+ if (!fileContent.startsWith('# ')) {
145
+ fileContent = `# ${parsedName}\n\n${fileContent}`;
146
+ }
147
+
148
+ const filePath = path.join(userDir, `${id}.md`);
149
+ await fs.writeFile(filePath, fileContent, 'utf-8');
150
+
151
+ // If we are editing an existing custom template and the ID changed, delete the old file
152
+ if (originalId && originalId !== id) {
153
+ const oldPath = path.join(userDir, `${originalId}.md`);
154
+ try {
155
+ await fs.unlink(oldPath);
156
+ } catch {}
157
+ }
158
+
159
+ const parsed = parseMarkdownTemplate(id, fileContent);
160
+ return {
161
+ id,
162
+ custom: true,
163
+ ...parsed,
164
+ };
165
+ }
166
+
167
+ export async function deleteWorkflowTemplate(id: string): Promise<void> {
168
+ const userDir = path.join(os.homedir(), '.nexusflow', 'workflows');
169
+ const filePath = path.join(userDir, `${id}.md`);
170
+
171
+ try {
172
+ await fs.unlink(filePath);
173
+ } catch (error) {
174
+ if ((error as any).code !== 'ENOENT') {
175
+ throw error;
176
+ }
177
+ }
178
+ }
package/tsconfig.json CHANGED
@@ -1,19 +1,19 @@
1
- {
2
- "compilerOptions": {
3
- "target": "ES2022",
4
- "module": "Node16",
5
- "moduleResolution": "Node16",
6
- "outDir": "dist",
7
- "rootDir": "src",
8
- "strict": true,
9
- "esModuleInterop": true,
10
- "skipLibCheck": true,
11
- "forceConsistentCasingInFileNames": true,
12
- "resolveJsonModule": true,
13
- "declaration": true,
14
- "declarationMap": true,
15
- "sourceMap": true
16
- },
17
- "include": ["src/**/*"],
18
- "exclude": ["node_modules", "dist", "tests"]
19
- }
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "module": "Node16",
5
+ "moduleResolution": "Node16",
6
+ "outDir": "dist",
7
+ "rootDir": "src",
8
+ "strict": true,
9
+ "esModuleInterop": true,
10
+ "skipLibCheck": true,
11
+ "forceConsistentCasingInFileNames": true,
12
+ "resolveJsonModule": true,
13
+ "declaration": true,
14
+ "declarationMap": true,
15
+ "sourceMap": true
16
+ },
17
+ "include": ["src/**/*"],
18
+ "exclude": ["node_modules", "dist", "tests"]
19
+ }
package/vitest.config.ts CHANGED
@@ -1,14 +1,14 @@
1
- import { defineConfig } from 'vitest/config';
2
-
3
- export default defineConfig({
4
- test: {
5
- exclude: [
6
- '**/node_modules/**',
7
- '**/dist/**',
8
- '**/cypress/**',
9
- '**/.{idea,git,cache,output,temp}/**',
10
- '**/scratch/**',
11
- '**/gui/**'
12
- ]
13
- }
14
- });
1
+ import { defineConfig } from 'vitest/config';
2
+
3
+ export default defineConfig({
4
+ test: {
5
+ exclude: [
6
+ '**/node_modules/**',
7
+ '**/dist/**',
8
+ '**/cypress/**',
9
+ '**/.{idea,git,cache,output,temp}/**',
10
+ '**/scratch/**',
11
+ '**/gui/**'
12
+ ]
13
+ }
14
+ });
@@ -1,112 +0,0 @@
1
- name: Release & Publish
2
-
3
- on:
4
- push:
5
- branches: [main]
6
- pull_request:
7
- branches: [main]
8
-
9
- permissions:
10
- contents: write
11
-
12
- jobs:
13
- build-and-test:
14
- runs-on: ubuntu-latest
15
- steps:
16
- - name: Checkout Repository
17
- uses: actions/checkout@v4
18
-
19
- - name: Setup Node.js
20
- uses: actions/setup-node@v4
21
- with:
22
- node-version: 20
23
-
24
- - name: Install Dependencies
25
- run: npm ci
26
-
27
- - name: Install GUI Dependencies
28
- run: npm ci --prefix gui
29
-
30
- - name: Install Extension Dependencies
31
- run: npm ci --prefix extension
32
-
33
- - name: Build Project
34
- run: npm run build
35
-
36
- - name: Run Tests
37
- run: npm test
38
-
39
- - name: Install Playwright Browsers
40
- run: npx playwright install chromium --with-deps
41
- working-directory: gui
42
-
43
- - name: Run GUI E2E Tests
44
- run: npm run test:gui
45
-
46
- publish:
47
- needs: build-and-test
48
- runs-on: windows-latest
49
- if: github.event_name == 'push' && github.ref == 'refs/heads/main'
50
- steps:
51
- - name: Checkout Repository
52
- uses: actions/checkout@v4
53
-
54
- - name: Setup Node.js
55
- uses: actions/setup-node@v4
56
- with:
57
- node-version: 20
58
- registry-url: 'https://registry.npmjs.org/'
59
-
60
- - name: Install Dependencies
61
- run: npm ci
62
-
63
- - name: Install GUI Dependencies
64
- run: npm ci --prefix gui
65
-
66
- - name: Install Extension Dependencies
67
- run: npm ci --prefix extension
68
-
69
- - name: Install Desktop Dependencies
70
- run: npm ci --prefix desktop
71
-
72
- - name: Build Project
73
- run: npm run build
74
-
75
- - name: Build Desktop GUI & Binaries
76
- run: npm run build --prefix desktop
77
-
78
- - name: Build Standalone Installer
79
- run: npm run build:installer --prefix desktop
80
-
81
- - name: Check version and NPM
82
- id: check-version
83
- shell: bash
84
- run: |
85
- CURRENT_VERSION=$(node -e "console.log(JSON.parse(require('fs').readFileSync('./package.json', 'utf8')).version)")
86
- echo "version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
87
- if npm info @mrpatronz/nexusflow@$CURRENT_VERSION --json >/dev/null 2>&1; then
88
- echo "is_new=false" >> $GITHUB_OUTPUT
89
- echo "Version $CURRENT_VERSION is already published on NPM. Skipping publish."
90
- else
91
- echo "is_new=true" >> $GITHUB_OUTPUT
92
- echo "Version $CURRENT_VERSION is new."
93
- fi
94
- env:
95
- NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
96
-
97
- - name: Publish to NPM
98
- if: steps.check-version.outputs.is_new == 'true'
99
- run: npm publish --access public
100
- env:
101
- NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
102
-
103
- - name: Create GitHub Release
104
- if: steps.check-version.outputs.is_new == 'true'
105
- uses: softprops/action-gh-release@v2
106
- with:
107
- tag_name: v${{ steps.check-version.outputs.version }}
108
- name: Release v${{ steps.check-version.outputs.version }}
109
- generate_release_notes: true
110
- target_commitish: ${{ github.sha }}
111
- files: |
112
- desktop/dist-installer-output/NexusFlowSetup.exe
@@ -1,7 +0,0 @@
1
- /**
2
- * Packs the workspace codebase into a single token-efficient XML file.
3
- */
4
- export declare function packCommand(workspaceArg?: string, options?: {
5
- compress?: boolean;
6
- }): Promise<void>;
7
- //# sourceMappingURL=pack.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"pack.d.ts","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,wBAAsB,WAAW,CAC/B,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,OAAO,CAAC,IAAI,CAAC,CAmBf"}
@@ -1,64 +0,0 @@
1
- import chalk from 'chalk';
2
- import ora from 'ora';
3
- import * as path from 'node:path';
4
- import * as fs from 'node:fs/promises';
5
- import { select } from '@inquirer/prompts';
6
- import { loadConfig } from '../core/config.js';
7
- import { listWorkspaces, loadFeatureConfig } from '../core/workspace.js';
8
- import { packWorkspace } from '../core/packer.js';
9
- /**
10
- * Packs the workspace codebase into a single token-efficient XML file.
11
- */
12
- export async function packCommand(workspaceArg, options = {}) {
13
- console.log(chalk.bold.cyan('\nšŸ“¦ NexusFlow — Codebase Context Packing\n'));
14
- const workspacePath = await resolveWorkspace(workspaceArg);
15
- if (!workspacePath)
16
- return;
17
- const spinner = ora('Packing workspace repositories using Repomix...').start();
18
- try {
19
- const result = await packWorkspace(workspacePath, { compress: options.compress });
20
- spinner.succeed('Workspace packed successfully!');
21
- console.log(`\nšŸ“„ ${chalk.bold('Packed Output File:')} ${chalk.green(result.outputPath)}`);
22
- console.log(`šŸ“Š ${chalk.bold('Total Files:')} ${result.totalFiles}`);
23
- console.log(`šŸ”  ${chalk.bold('Total Characters:')} ${result.totalCharacters}`);
24
- console.log(`šŸ’¾ ${chalk.bold('File Size:')} ${(result.fileSize / 1024).toFixed(2)} KB\n`);
25
- }
26
- catch (error) {
27
- spinner.fail('Failed to pack workspace');
28
- console.error(chalk.red(` Error: ${error.message}`));
29
- }
30
- }
31
- /**
32
- * Resolves the workspace path from argument, cwd, or list.
33
- */
34
- async function resolveWorkspace(workspaceArg) {
35
- if (workspaceArg) {
36
- const absolutePath = path.resolve(workspaceArg);
37
- try {
38
- await fs.access(path.join(absolutePath, 'nexusflow.json'));
39
- return absolutePath;
40
- }
41
- catch {
42
- console.error(chalk.red(`āœ– Invalid workspace: No nexusflow.json found at ${absolutePath}`));
43
- return null;
44
- }
45
- }
46
- const cwdFeature = await loadFeatureConfig(process.cwd());
47
- if (cwdFeature)
48
- return cwdFeature.workspacePath;
49
- const config = await loadConfig();
50
- const workspaces = await listWorkspaces(config.workspacesDir);
51
- if (workspaces.length === 0) {
52
- console.log(chalk.yellow('No workspaces found.\n'));
53
- return null;
54
- }
55
- const selected = await select({
56
- message: 'Select a workspace to pack:',
57
- choices: workspaces.map((ws) => ({
58
- name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
59
- value: ws.workspacePath,
60
- })),
61
- });
62
- return selected;
63
- }
64
- //# sourceMappingURL=pack.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"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"}
@@ -1,14 +0,0 @@
1
- export interface PackResult {
2
- outputPath: string;
3
- outputPaths?: string[];
4
- totalFiles: number;
5
- totalCharacters: number;
6
- fileSize: number;
7
- }
8
- /**
9
- * Packs all repositories in a workspace into individual XML files using Repomix.
10
- */
11
- export declare function packWorkspace(workspacePath: string, options?: {
12
- compress?: boolean;
13
- }): Promise<PackResult>;
14
- //# sourceMappingURL=packer.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"packer.d.ts","sourceRoot":"","sources":["../../src/core/packer.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,OAAO,CAAC,UAAU,CAAC,CAsFrB"}