@mrpatronz/nexusflow 0.2.12 → 0.2.17

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 (233) hide show
  1. package/.github/dependabot.yml +52 -52
  2. package/.github/workflows/dependabot-merge.yml +53 -0
  3. package/.github/workflows/release.yml +112 -100
  4. package/.vscode/launch.json +17 -17
  5. package/.vscode/tasks.json +17 -17
  6. package/GETTING_STARTED.md +114 -109
  7. package/README.md +336 -311
  8. package/desktop/build-installer.js +228 -0
  9. package/desktop/build.js +118 -0
  10. package/desktop/installer/nexusflow.iss +35 -0
  11. package/desktop/neutralino.config.json +39 -0
  12. package/desktop/package-lock.json +1060 -0
  13. package/desktop/package.json +14 -0
  14. package/dist/commands/add-repo.d.ts.map +1 -1
  15. package/dist/commands/add-repo.js +24 -14
  16. package/dist/commands/add-repo.js.map +1 -1
  17. package/dist/commands/commit.js +1 -1
  18. package/dist/commands/commit.js.map +1 -1
  19. package/dist/commands/desktop.d.ts +12 -0
  20. package/dist/commands/desktop.d.ts.map +1 -0
  21. package/dist/commands/desktop.js +119 -0
  22. package/dist/commands/desktop.js.map +1 -0
  23. package/dist/commands/diff.js +1 -1
  24. package/dist/commands/diff.js.map +1 -1
  25. package/dist/commands/doctor.js +1 -1
  26. package/dist/commands/doctor.js.map +1 -1
  27. package/dist/commands/handoff.js +1 -1
  28. package/dist/commands/handoff.js.map +1 -1
  29. package/dist/commands/logs.js +1 -1
  30. package/dist/commands/logs.js.map +1 -1
  31. package/dist/commands/open.d.ts.map +1 -1
  32. package/dist/commands/open.js +12 -7
  33. package/dist/commands/open.js.map +1 -1
  34. package/dist/commands/pack.js +1 -1
  35. package/dist/commands/pack.js.map +1 -1
  36. package/dist/commands/refresh.js +13 -8
  37. package/dist/commands/refresh.js.map +1 -1
  38. package/dist/commands/remove.d.ts.map +1 -1
  39. package/dist/commands/remove.js +12 -7
  40. package/dist/commands/remove.js.map +1 -1
  41. package/dist/commands/start.js +1 -1
  42. package/dist/commands/start.js.map +1 -1
  43. package/dist/commands/status.js +1 -1
  44. package/dist/commands/status.js.map +1 -1
  45. package/dist/commands/stop.js +1 -1
  46. package/dist/commands/stop.js.map +1 -1
  47. package/dist/commands/sync.d.ts.map +1 -1
  48. package/dist/commands/sync.js +14 -11
  49. package/dist/commands/sync.js.map +1 -1
  50. package/dist/commands/tui.d.ts +8 -0
  51. package/dist/commands/tui.d.ts.map +1 -0
  52. package/dist/commands/tui.js +386 -0
  53. package/dist/commands/tui.js.map +1 -0
  54. package/dist/commands/ui.d.ts +3 -1
  55. package/dist/commands/ui.d.ts.map +1 -1
  56. package/dist/commands/ui.js +76 -19
  57. package/dist/commands/ui.js.map +1 -1
  58. package/dist/core/workspace.d.ts +7 -0
  59. package/dist/core/workspace.d.ts.map +1 -1
  60. package/dist/core/workspace.js +45 -1
  61. package/dist/core/workspace.js.map +1 -1
  62. package/dist/generators/base.d.ts.map +1 -1
  63. package/dist/generators/base.js +78 -66
  64. package/dist/generators/base.js.map +1 -1
  65. package/dist/generators/codex.js +11 -11
  66. package/dist/generators/copilot.js +17 -17
  67. package/dist/generators/cursor.js +5 -5
  68. package/dist/generators/index.d.ts.map +1 -1
  69. package/dist/generators/index.js +64 -50
  70. package/dist/generators/index.js.map +1 -1
  71. package/dist/generators/map-generator.js +14 -14
  72. package/dist/generators/skills-generator.js +28 -28
  73. package/dist/gui/app_logo.png +0 -0
  74. package/dist/gui/assets/index-Ct3qq-X4.js +25 -0
  75. package/dist/gui/assets/index-P_ZrgHXg.css +1 -0
  76. package/dist/gui/icons.svg +24 -24
  77. package/dist/gui/index.html +18 -18
  78. package/dist/index.js +43 -0
  79. package/dist/index.js.map +1 -1
  80. package/dist/orchestration/runner.d.ts +5 -6
  81. package/dist/orchestration/runner.d.ts.map +1 -1
  82. package/dist/orchestration/runner.js +105 -102
  83. package/dist/orchestration/runner.js.map +1 -1
  84. package/dist/server.d.ts.map +1 -1
  85. package/dist/server.js +235 -2
  86. package/dist/server.js.map +1 -1
  87. package/dist/server.test.js +78 -0
  88. package/dist/server.test.js.map +1 -1
  89. package/dist/types.d.ts +4 -0
  90. package/dist/types.d.ts.map +1 -1
  91. package/dist/utils/detect-editors.js +1 -1
  92. package/dist/utils/detect-editors.js.map +1 -1
  93. package/dist/utils/detect-editors.test.js +3 -3
  94. package/dist/utils/detect-editors.test.js.map +1 -1
  95. package/dist/utils/git.d.ts +16 -0
  96. package/dist/utils/git.d.ts.map +1 -1
  97. package/dist/utils/git.js +52 -0
  98. package/dist/utils/git.js.map +1 -1
  99. package/dist/utils/multi-git.d.ts +2 -0
  100. package/dist/utils/multi-git.d.ts.map +1 -1
  101. package/dist/utils/multi-git.js +5 -2
  102. package/dist/utils/multi-git.js.map +1 -1
  103. package/dist/utils/prompts.d.ts +1 -0
  104. package/dist/utils/prompts.d.ts.map +1 -1
  105. package/dist/utils/prompts.js +77 -15
  106. package/dist/utils/prompts.js.map +1 -1
  107. package/dist/utils/update-check.d.ts +3 -1
  108. package/dist/utils/update-check.d.ts.map +1 -1
  109. package/dist/utils/update-check.js +23 -6
  110. package/dist/utils/update-check.js.map +1 -1
  111. package/dist/utils/workflows.d.ts +11 -0
  112. package/dist/utils/workflows.d.ts.map +1 -0
  113. package/dist/utils/workflows.js +156 -0
  114. package/dist/utils/workflows.js.map +1 -0
  115. package/dist/utils/workflows.test.d.ts +2 -0
  116. package/dist/utils/workflows.test.d.ts.map +1 -0
  117. package/dist/utils/workflows.test.js +86 -0
  118. package/dist/utils/workflows.test.js.map +1 -0
  119. package/extension/media/icon.svg +1 -0
  120. package/extension/package-lock.json +2673 -2811
  121. package/extension/package.json +108 -61
  122. package/extension/src/extension.ts +631 -168
  123. package/extension/tsconfig.json +21 -19
  124. package/gui/README.md +73 -73
  125. package/gui/e2e/wizard.spec.ts +346 -327
  126. package/gui/eslint.config.js +26 -22
  127. package/gui/index.html +17 -17
  128. package/gui/package-lock.json +3079 -3118
  129. package/gui/package.json +36 -36
  130. package/gui/playwright.config.ts +41 -41
  131. package/gui/public/app_logo.png +0 -0
  132. package/gui/public/icons.svg +24 -24
  133. package/gui/src/App.css +1 -1
  134. package/gui/src/App.tsx +3407 -2498
  135. package/gui/src/assets/vite.svg +1 -1
  136. package/gui/src/features/changes/ChangesViewer.tsx +388 -212
  137. package/gui/src/features/knowledge/KnowledgeBase.tsx +84 -84
  138. package/gui/src/features/onboarding/OnboardingWizard.tsx +230 -230
  139. package/gui/src/features/plan/ImplementationPlan.tsx +32 -32
  140. package/gui/src/features/services/ServiceConsole.tsx +250 -159
  141. package/gui/src/features/sessions/SessionHistory.tsx +195 -195
  142. package/gui/src/features/workspace/WorkspaceList.tsx +666 -514
  143. package/gui/src/index.css +152 -17
  144. package/gui/src/main.tsx +94 -10
  145. package/gui/src/types.ts +62 -62
  146. package/gui/tsconfig.app.json +25 -25
  147. package/gui/tsconfig.json +7 -7
  148. package/gui/tsconfig.node.json +24 -24
  149. package/gui/vite.config.ts +12 -12
  150. package/package.json +56 -55
  151. package/resources/workflows/plan-implement-review.md +8 -0
  152. package/resources/workflows/research-verify.md +6 -0
  153. package/resources/workflows/solo-developer.md +3 -0
  154. package/scripts/simulate-workspaces.ts +55 -55
  155. package/src/analyzers/detect-apis.ts +290 -290
  156. package/src/analyzers/detect-deps.ts +315 -315
  157. package/src/analyzers/detect-existing.ts +74 -74
  158. package/src/analyzers/detect-ports.ts +110 -110
  159. package/src/analyzers/index.ts +97 -97
  160. package/src/analyzers/messaging-analyzer.ts +254 -254
  161. package/src/analyzers/readme-summarizer.ts +102 -102
  162. package/src/analyzers/run-analyzer.ts +269 -269
  163. package/src/analyzers/tech-stack.ts +283 -283
  164. package/src/commands/add-repo.ts +157 -141
  165. package/src/commands/commands.test.ts +155 -155
  166. package/src/commands/commit.ts +131 -131
  167. package/src/commands/create.ts +207 -207
  168. package/src/commands/desktop.ts +128 -0
  169. package/src/commands/diff.ts +125 -125
  170. package/src/commands/doctor.ts +357 -357
  171. package/src/commands/handoff.ts +266 -266
  172. package/src/commands/init.ts +134 -134
  173. package/src/commands/list.ts +46 -46
  174. package/src/commands/logs.ts +63 -63
  175. package/src/commands/mcp.ts +92 -92
  176. package/src/commands/open.ts +129 -121
  177. package/src/commands/pack.ts +73 -73
  178. package/src/commands/refresh.ts +147 -139
  179. package/src/commands/remove.ts +98 -90
  180. package/src/commands/start.ts +117 -117
  181. package/src/commands/status.ts +54 -54
  182. package/src/commands/stop.ts +55 -55
  183. package/src/commands/sync.ts +151 -145
  184. package/src/commands/tui.ts +424 -0
  185. package/src/commands/ui.ts +111 -47
  186. package/src/core/config.test.ts +96 -96
  187. package/src/core/config.ts +115 -115
  188. package/src/core/graph.ts +344 -344
  189. package/src/core/packer.test.ts +99 -99
  190. package/src/core/packer.ts +107 -107
  191. package/src/core/scanner.test.ts +61 -61
  192. package/src/core/scanner.ts +91 -91
  193. package/src/core/workspace.ts +380 -333
  194. package/src/core/worktree.ts +120 -120
  195. package/src/generators/antigravity.ts +32 -32
  196. package/src/generators/base.ts +240 -227
  197. package/src/generators/claude.ts +34 -34
  198. package/src/generators/codex.ts +48 -48
  199. package/src/generators/copilot.ts +56 -56
  200. package/src/generators/cursor.ts +44 -44
  201. package/src/generators/index.ts +250 -230
  202. package/src/generators/map-generator.test.ts +159 -159
  203. package/src/generators/map-generator.ts +542 -542
  204. package/src/generators/plan-generator.ts +481 -481
  205. package/src/generators/skills-generator.ts +259 -259
  206. package/src/index.ts +426 -382
  207. package/src/mcp/server.ts +294 -294
  208. package/src/orchestration/detect.ts +313 -313
  209. package/src/orchestration/index.ts +7 -7
  210. package/src/orchestration/runner.ts +283 -279
  211. package/src/server.test.ts +555 -464
  212. package/src/server.ts +1308 -1047
  213. package/src/types.ts +408 -403
  214. package/src/utils/detect-ai.test.ts +44 -44
  215. package/src/utils/detect-ai.ts +84 -84
  216. package/src/utils/detect-editors.test.ts +48 -48
  217. package/src/utils/detect-editors.ts +57 -57
  218. package/src/utils/git.test.ts +74 -74
  219. package/src/utils/git.ts +117 -61
  220. package/src/utils/local-ai.test.ts +130 -130
  221. package/src/utils/local-ai.ts +111 -111
  222. package/src/utils/multi-git.ts +313 -306
  223. package/src/utils/prompts.ts +209 -135
  224. package/src/utils/session-finder.ts +483 -483
  225. package/src/utils/system-scanner.test.ts +89 -89
  226. package/src/utils/system-scanner.ts +96 -96
  227. package/src/utils/update-check.ts +309 -275
  228. package/src/utils/workflows.test.ts +114 -0
  229. package/src/utils/workflows.ts +178 -0
  230. package/tsconfig.json +19 -19
  231. package/vitest.config.ts +14 -14
  232. package/dist/gui/assets/index-Ca2VRMrQ.js +0 -22
  233. package/dist/gui/assets/index-fj0RJiOb.css +0 -2
@@ -1,96 +1,96 @@
1
- import { describe, it, expect, vi, beforeEach } from 'vitest';
2
- import * as fs from 'node:fs/promises';
3
- import * as os from 'node:os';
4
- import { getConfigDir, getDefaultConfig, ensureConfigDir, loadConfig, saveConfig } from './config.js';
5
-
6
- vi.mock('node:fs/promises');
7
- vi.mock('node:os', async () => {
8
- const actual = await vi.importActual<typeof import('node:os')>('node:os');
9
- return {
10
- ...actual,
11
- homedir: vi.fn(),
12
- };
13
- });
14
-
15
- describe('config core module', () => {
16
- beforeEach(() => {
17
- vi.clearAllMocks();
18
- vi.mocked(os.homedir).mockReturnValue('/mock/home');
19
- });
20
-
21
- describe('getConfigDir', () => {
22
- it('should return path based on home directory', () => {
23
- const dir = getConfigDir();
24
- expect(dir).toContain('.nexusflow');
25
- });
26
- });
27
-
28
- describe('getDefaultConfig', () => {
29
- it('should return config with defaults populated', () => {
30
- const config = getDefaultConfig();
31
- expect(config.version).toBe('1.0.0');
32
- expect(config.scanDepth).toBe(2);
33
- expect(config.localLlm?.enabled).toBe(false);
34
- });
35
- });
36
-
37
- describe('ensureConfigDir', () => {
38
- it('should invoke fs.mkdir with correct options', async () => {
39
- vi.mocked(fs.mkdir).mockResolvedValue(undefined);
40
-
41
- await ensureConfigDir();
42
-
43
- expect(fs.mkdir).toHaveBeenCalledWith(expect.stringContaining('.nexusflow'), { recursive: true });
44
- });
45
- });
46
-
47
- describe('loadConfig', () => {
48
- it('should load config if file exists', async () => {
49
- const savedConfig = {
50
- devDir: '/custom/dev',
51
- localLlm: {
52
- enabled: true,
53
- model: 'custom-model'
54
- }
55
- };
56
-
57
- vi.mocked(fs.readFile).mockResolvedValue(JSON.stringify(savedConfig));
58
-
59
- const config = await loadConfig();
60
-
61
- expect(config.devDir).toBe('/custom/dev');
62
- expect(config.localLlm?.enabled).toBe(true);
63
- expect(config.localLlm?.model).toBe('custom-model');
64
- // Should merge with defaults
65
- expect(config.scanDepth).toBe(2);
66
- });
67
-
68
- it('should return default config if read fails', async () => {
69
- vi.mocked(fs.readFile).mockRejectedValue(new Error('ENOENT'));
70
-
71
- const config = await loadConfig();
72
-
73
- expect(config.version).toBe('1.0.0');
74
- expect(config.localLlm?.enabled).toBe(false);
75
- });
76
- });
77
-
78
- describe('saveConfig', () => {
79
- it('should create directory and save configuration', async () => {
80
- vi.mocked(fs.mkdir).mockResolvedValue(undefined);
81
- vi.mocked(fs.writeFile).mockResolvedValue(undefined);
82
-
83
- const config = getDefaultConfig();
84
- config.devDir = '/custom/saved/dev';
85
-
86
- await saveConfig(config);
87
-
88
- expect(fs.mkdir).toHaveBeenCalled();
89
- expect(fs.writeFile).toHaveBeenCalledWith(
90
- expect.stringContaining('config.json'),
91
- expect.stringContaining('/custom/saved/dev'),
92
- 'utf-8'
93
- );
94
- });
95
- });
96
- });
1
+ import { describe, it, expect, vi, beforeEach } from 'vitest';
2
+ import * as fs from 'node:fs/promises';
3
+ import * as os from 'node:os';
4
+ import { getConfigDir, getDefaultConfig, ensureConfigDir, loadConfig, saveConfig } from './config.js';
5
+
6
+ vi.mock('node:fs/promises');
7
+ vi.mock('node:os', async () => {
8
+ const actual = await vi.importActual<typeof import('node:os')>('node:os');
9
+ return {
10
+ ...actual,
11
+ homedir: vi.fn(),
12
+ };
13
+ });
14
+
15
+ describe('config core module', () => {
16
+ beforeEach(() => {
17
+ vi.clearAllMocks();
18
+ vi.mocked(os.homedir).mockReturnValue('/mock/home');
19
+ });
20
+
21
+ describe('getConfigDir', () => {
22
+ it('should return path based on home directory', () => {
23
+ const dir = getConfigDir();
24
+ expect(dir).toContain('.nexusflow');
25
+ });
26
+ });
27
+
28
+ describe('getDefaultConfig', () => {
29
+ it('should return config with defaults populated', () => {
30
+ const config = getDefaultConfig();
31
+ expect(config.version).toBe('1.0.0');
32
+ expect(config.scanDepth).toBe(2);
33
+ expect(config.localLlm?.enabled).toBe(false);
34
+ });
35
+ });
36
+
37
+ describe('ensureConfigDir', () => {
38
+ it('should invoke fs.mkdir with correct options', async () => {
39
+ vi.mocked(fs.mkdir).mockResolvedValue(undefined);
40
+
41
+ await ensureConfigDir();
42
+
43
+ expect(fs.mkdir).toHaveBeenCalledWith(expect.stringContaining('.nexusflow'), { recursive: true });
44
+ });
45
+ });
46
+
47
+ describe('loadConfig', () => {
48
+ it('should load config if file exists', async () => {
49
+ const savedConfig = {
50
+ devDir: '/custom/dev',
51
+ localLlm: {
52
+ enabled: true,
53
+ model: 'custom-model'
54
+ }
55
+ };
56
+
57
+ vi.mocked(fs.readFile).mockResolvedValue(JSON.stringify(savedConfig));
58
+
59
+ const config = await loadConfig();
60
+
61
+ expect(config.devDir).toBe('/custom/dev');
62
+ expect(config.localLlm?.enabled).toBe(true);
63
+ expect(config.localLlm?.model).toBe('custom-model');
64
+ // Should merge with defaults
65
+ expect(config.scanDepth).toBe(2);
66
+ });
67
+
68
+ it('should return default config if read fails', async () => {
69
+ vi.mocked(fs.readFile).mockRejectedValue(new Error('ENOENT'));
70
+
71
+ const config = await loadConfig();
72
+
73
+ expect(config.version).toBe('1.0.0');
74
+ expect(config.localLlm?.enabled).toBe(false);
75
+ });
76
+ });
77
+
78
+ describe('saveConfig', () => {
79
+ it('should create directory and save configuration', async () => {
80
+ vi.mocked(fs.mkdir).mockResolvedValue(undefined);
81
+ vi.mocked(fs.writeFile).mockResolvedValue(undefined);
82
+
83
+ const config = getDefaultConfig();
84
+ config.devDir = '/custom/saved/dev';
85
+
86
+ await saveConfig(config);
87
+
88
+ expect(fs.mkdir).toHaveBeenCalled();
89
+ expect(fs.writeFile).toHaveBeenCalledWith(
90
+ expect.stringContaining('config.json'),
91
+ expect.stringContaining('/custom/saved/dev'),
92
+ 'utf-8'
93
+ );
94
+ });
95
+ });
96
+ });
@@ -1,115 +1,115 @@
1
- /**
2
- * @module core/config
3
- * Manages NexusFlow configuration stored at ~/.nexusflow/config.json.
4
- */
5
-
6
- import * as fs from 'node:fs/promises';
7
- import * as path from 'node:path';
8
- import * as os from 'node:os';
9
-
10
- import type { NexusFlowConfig } from '../types.js';
11
-
12
- /** Name of the config directory under the user's home folder. */
13
- const CONFIG_DIR_NAME = '.nexusflow';
14
-
15
- /** Name of the config file. */
16
- const CONFIG_FILE_NAME = 'config.json';
17
-
18
- /**
19
- * Returns the absolute path to the NexusFlow config directory (~/.nexusflow).
20
- */
21
- export function getConfigDir(): string {
22
- return path.join(os.homedir(), CONFIG_DIR_NAME);
23
- }
24
-
25
- /**
26
- * Returns a NexusFlowConfig populated with sensible defaults.
27
- */
28
- export function getDefaultConfig(): NexusFlowConfig {
29
- return {
30
- version: '1.0.0',
31
- devDir: path.join(os.homedir(), 'dev'),
32
- workspacesDir: path.join(os.homedir(), 'dev', 'workspaces'),
33
- defaultAssistant: null,
34
- defaultEditor: null,
35
- scanDepth: 2,
36
- packContextXml: false,
37
- excludePatterns: [
38
- '**/node_modules/**',
39
- '**/bin/**',
40
- '**/obj/**',
41
- '**/dist/**',
42
- '**/out/**',
43
- '**/.git/**',
44
- '**/*.lock',
45
- '**/package-lock.json',
46
- '**/pnpm-lock.yaml',
47
- '**/yarn.lock',
48
- '**/*.png',
49
- '**/*.jpg',
50
- '**/*.jpeg',
51
- '**/*.gif',
52
- '**/*.svg',
53
- '**/*.ico',
54
- '**/*.pdf',
55
- '**/*.zip',
56
- '**/*.tar.gz',
57
- '**/.vs/**',
58
- '**/.vscode/**',
59
- '**/.idea/**',
60
- ],
61
- localLlm: {
62
- enabled: false,
63
- provider: 'ollama',
64
- endpoint: 'http://localhost:11434',
65
- model: 'qwen2.5-coder:1.5b',
66
- },
67
- };
68
- }
69
-
70
- /**
71
- * Ensures the ~/.nexusflow directory exists, creating it if necessary.
72
- */
73
- export async function ensureConfigDir(): Promise<void> {
74
- const configDir = getConfigDir();
75
- await fs.mkdir(configDir, { recursive: true });
76
- }
77
-
78
- /**
79
- * Loads the NexusFlow config from disk.
80
- * Returns default values when the config file does not exist yet.
81
- *
82
- * @returns The loaded or default configuration.
83
- */
84
- export async function loadConfig(): Promise<NexusFlowConfig> {
85
- const configPath = path.join(getConfigDir(), CONFIG_FILE_NAME);
86
-
87
- try {
88
- const raw = await fs.readFile(configPath, 'utf-8');
89
- const parsed = JSON.parse(raw) as Partial<NexusFlowConfig>;
90
-
91
- // Merge with defaults so newly-added keys are always present.
92
- const merged = { ...getDefaultConfig(), ...parsed };
93
- if (parsed.localLlm) {
94
- merged.localLlm = { ...getDefaultConfig().localLlm, ...parsed.localLlm };
95
- }
96
- return merged;
97
- } catch {
98
- // File doesn't exist or is unreadable — return defaults.
99
- return getDefaultConfig();
100
- }
101
- }
102
-
103
- /**
104
- * Persists the given configuration to ~/.nexusflow/config.json.
105
- * Creates the config directory if it doesn't exist.
106
- *
107
- * @param config - The configuration to save.
108
- */
109
- export async function saveConfig(config: NexusFlowConfig): Promise<void> {
110
- await ensureConfigDir();
111
-
112
- const configPath = path.join(getConfigDir(), CONFIG_FILE_NAME);
113
- const data = JSON.stringify(config, null, 2) + '\n';
114
- await fs.writeFile(configPath, data, 'utf-8');
115
- }
1
+ /**
2
+ * @module core/config
3
+ * Manages NexusFlow configuration stored at ~/.nexusflow/config.json.
4
+ */
5
+
6
+ import * as fs from 'node:fs/promises';
7
+ import * as path from 'node:path';
8
+ import * as os from 'node:os';
9
+
10
+ import type { NexusFlowConfig } from '../types.js';
11
+
12
+ /** Name of the config directory under the user's home folder. */
13
+ const CONFIG_DIR_NAME = '.nexusflow';
14
+
15
+ /** Name of the config file. */
16
+ const CONFIG_FILE_NAME = 'config.json';
17
+
18
+ /**
19
+ * Returns the absolute path to the NexusFlow config directory (~/.nexusflow).
20
+ */
21
+ export function getConfigDir(): string {
22
+ return path.join(os.homedir(), CONFIG_DIR_NAME);
23
+ }
24
+
25
+ /**
26
+ * Returns a NexusFlowConfig populated with sensible defaults.
27
+ */
28
+ export function getDefaultConfig(): NexusFlowConfig {
29
+ return {
30
+ version: '1.0.0',
31
+ devDir: path.join(os.homedir(), 'dev'),
32
+ workspacesDir: path.join(os.homedir(), 'dev', 'workspaces'),
33
+ defaultAssistant: null,
34
+ defaultEditor: null,
35
+ scanDepth: 2,
36
+ packContextXml: false,
37
+ excludePatterns: [
38
+ '**/node_modules/**',
39
+ '**/bin/**',
40
+ '**/obj/**',
41
+ '**/dist/**',
42
+ '**/out/**',
43
+ '**/.git/**',
44
+ '**/*.lock',
45
+ '**/package-lock.json',
46
+ '**/pnpm-lock.yaml',
47
+ '**/yarn.lock',
48
+ '**/*.png',
49
+ '**/*.jpg',
50
+ '**/*.jpeg',
51
+ '**/*.gif',
52
+ '**/*.svg',
53
+ '**/*.ico',
54
+ '**/*.pdf',
55
+ '**/*.zip',
56
+ '**/*.tar.gz',
57
+ '**/.vs/**',
58
+ '**/.vscode/**',
59
+ '**/.idea/**',
60
+ ],
61
+ localLlm: {
62
+ enabled: false,
63
+ provider: 'ollama',
64
+ endpoint: 'http://localhost:11434',
65
+ model: 'qwen2.5-coder:1.5b',
66
+ },
67
+ };
68
+ }
69
+
70
+ /**
71
+ * Ensures the ~/.nexusflow directory exists, creating it if necessary.
72
+ */
73
+ export async function ensureConfigDir(): Promise<void> {
74
+ const configDir = getConfigDir();
75
+ await fs.mkdir(configDir, { recursive: true });
76
+ }
77
+
78
+ /**
79
+ * Loads the NexusFlow config from disk.
80
+ * Returns default values when the config file does not exist yet.
81
+ *
82
+ * @returns The loaded or default configuration.
83
+ */
84
+ export async function loadConfig(): Promise<NexusFlowConfig> {
85
+ const configPath = path.join(getConfigDir(), CONFIG_FILE_NAME);
86
+
87
+ try {
88
+ const raw = await fs.readFile(configPath, 'utf-8');
89
+ const parsed = JSON.parse(raw) as Partial<NexusFlowConfig>;
90
+
91
+ // Merge with defaults so newly-added keys are always present.
92
+ const merged = { ...getDefaultConfig(), ...parsed };
93
+ if (parsed.localLlm) {
94
+ merged.localLlm = { ...getDefaultConfig().localLlm, ...parsed.localLlm };
95
+ }
96
+ return merged;
97
+ } catch {
98
+ // File doesn't exist or is unreadable — return defaults.
99
+ return getDefaultConfig();
100
+ }
101
+ }
102
+
103
+ /**
104
+ * Persists the given configuration to ~/.nexusflow/config.json.
105
+ * Creates the config directory if it doesn't exist.
106
+ *
107
+ * @param config - The configuration to save.
108
+ */
109
+ export async function saveConfig(config: NexusFlowConfig): Promise<void> {
110
+ await ensureConfigDir();
111
+
112
+ const configPath = path.join(getConfigDir(), CONFIG_FILE_NAME);
113
+ const data = JSON.stringify(config, null, 2) + '\n';
114
+ await fs.writeFile(configPath, data, 'utf-8');
115
+ }