@mrpatronz/nexusflow 0.2.13 → 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 (186) 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/desktop.d.ts +12 -0
  15. package/dist/commands/desktop.d.ts.map +1 -0
  16. package/dist/commands/desktop.js +119 -0
  17. package/dist/commands/desktop.js.map +1 -0
  18. package/dist/commands/sync.d.ts.map +1 -1
  19. package/dist/commands/sync.js +1 -3
  20. package/dist/commands/sync.js.map +1 -1
  21. package/dist/commands/tui.d.ts +8 -0
  22. package/dist/commands/tui.d.ts.map +1 -0
  23. package/dist/commands/tui.js +386 -0
  24. package/dist/commands/tui.js.map +1 -0
  25. package/dist/commands/ui.d.ts +3 -1
  26. package/dist/commands/ui.d.ts.map +1 -1
  27. package/dist/commands/ui.js +76 -19
  28. package/dist/commands/ui.js.map +1 -1
  29. package/dist/generators/base.d.ts.map +1 -1
  30. package/dist/generators/base.js +78 -66
  31. package/dist/generators/base.js.map +1 -1
  32. package/dist/generators/codex.js +11 -11
  33. package/dist/generators/copilot.js +17 -17
  34. package/dist/generators/cursor.js +5 -5
  35. package/dist/generators/index.js +50 -50
  36. package/dist/generators/map-generator.js +14 -14
  37. package/dist/generators/skills-generator.js +28 -28
  38. package/dist/gui/app_logo.png +0 -0
  39. package/dist/gui/assets/index-Ct3qq-X4.js +25 -0
  40. package/dist/gui/assets/index-P_ZrgHXg.css +1 -0
  41. package/dist/gui/icons.svg +24 -24
  42. package/dist/gui/index.html +18 -18
  43. package/dist/index.js +43 -0
  44. package/dist/index.js.map +1 -1
  45. package/dist/server.d.ts.map +1 -1
  46. package/dist/server.js +182 -1
  47. package/dist/server.js.map +1 -1
  48. package/dist/server.test.js +78 -0
  49. package/dist/server.test.js.map +1 -1
  50. package/dist/types.d.ts +4 -0
  51. package/dist/types.d.ts.map +1 -1
  52. package/dist/utils/git.d.ts +16 -0
  53. package/dist/utils/git.d.ts.map +1 -1
  54. package/dist/utils/git.js +52 -0
  55. package/dist/utils/git.js.map +1 -1
  56. package/dist/utils/multi-git.d.ts +2 -0
  57. package/dist/utils/multi-git.d.ts.map +1 -1
  58. package/dist/utils/multi-git.js +5 -2
  59. package/dist/utils/multi-git.js.map +1 -1
  60. package/dist/utils/update-check.d.ts +3 -1
  61. package/dist/utils/update-check.d.ts.map +1 -1
  62. package/dist/utils/update-check.js +23 -6
  63. package/dist/utils/update-check.js.map +1 -1
  64. package/dist/utils/workflows.d.ts +11 -0
  65. package/dist/utils/workflows.d.ts.map +1 -0
  66. package/dist/utils/workflows.js +156 -0
  67. package/dist/utils/workflows.js.map +1 -0
  68. package/dist/utils/workflows.test.d.ts +2 -0
  69. package/dist/utils/workflows.test.d.ts.map +1 -0
  70. package/dist/utils/workflows.test.js +86 -0
  71. package/dist/utils/workflows.test.js.map +1 -0
  72. package/extension/media/icon.svg +1 -0
  73. package/extension/package-lock.json +2673 -2811
  74. package/extension/package.json +108 -70
  75. package/extension/src/extension.ts +631 -204
  76. package/extension/tsconfig.json +21 -19
  77. package/gui/README.md +73 -73
  78. package/gui/e2e/wizard.spec.ts +346 -327
  79. package/gui/eslint.config.js +26 -26
  80. package/gui/index.html +17 -17
  81. package/gui/package-lock.json +3079 -3118
  82. package/gui/package.json +36 -36
  83. package/gui/playwright.config.ts +41 -41
  84. package/gui/public/app_logo.png +0 -0
  85. package/gui/public/icons.svg +24 -24
  86. package/gui/src/App.css +1 -1
  87. package/gui/src/App.tsx +3407 -2722
  88. package/gui/src/assets/vite.svg +1 -1
  89. package/gui/src/features/changes/ChangesViewer.tsx +388 -388
  90. package/gui/src/features/knowledge/KnowledgeBase.tsx +84 -84
  91. package/gui/src/features/onboarding/OnboardingWizard.tsx +230 -230
  92. package/gui/src/features/plan/ImplementationPlan.tsx +32 -32
  93. package/gui/src/features/services/ServiceConsole.tsx +250 -250
  94. package/gui/src/features/sessions/SessionHistory.tsx +195 -195
  95. package/gui/src/features/workspace/WorkspaceList.tsx +666 -666
  96. package/gui/src/index.css +152 -110
  97. package/gui/src/main.tsx +94 -10
  98. package/gui/src/types.ts +62 -62
  99. package/gui/tsconfig.app.json +25 -25
  100. package/gui/tsconfig.json +7 -7
  101. package/gui/tsconfig.node.json +24 -24
  102. package/gui/vite.config.ts +12 -12
  103. package/package.json +56 -56
  104. package/resources/workflows/plan-implement-review.md +8 -0
  105. package/resources/workflows/research-verify.md +6 -0
  106. package/resources/workflows/solo-developer.md +3 -0
  107. package/scripts/simulate-workspaces.ts +55 -55
  108. package/src/analyzers/detect-apis.ts +290 -290
  109. package/src/analyzers/detect-deps.ts +315 -315
  110. package/src/analyzers/detect-existing.ts +74 -74
  111. package/src/analyzers/detect-ports.ts +110 -110
  112. package/src/analyzers/index.ts +97 -97
  113. package/src/analyzers/messaging-analyzer.ts +254 -254
  114. package/src/analyzers/readme-summarizer.ts +102 -102
  115. package/src/analyzers/run-analyzer.ts +269 -269
  116. package/src/analyzers/tech-stack.ts +283 -283
  117. package/src/commands/add-repo.ts +157 -157
  118. package/src/commands/commands.test.ts +155 -155
  119. package/src/commands/commit.ts +131 -131
  120. package/src/commands/create.ts +207 -207
  121. package/src/commands/desktop.ts +128 -0
  122. package/src/commands/diff.ts +125 -125
  123. package/src/commands/doctor.ts +357 -357
  124. package/src/commands/handoff.ts +266 -266
  125. package/src/commands/init.ts +134 -134
  126. package/src/commands/list.ts +46 -46
  127. package/src/commands/logs.ts +63 -63
  128. package/src/commands/mcp.ts +92 -92
  129. package/src/commands/open.ts +129 -129
  130. package/src/commands/pack.ts +73 -73
  131. package/src/commands/refresh.ts +147 -147
  132. package/src/commands/remove.ts +98 -98
  133. package/src/commands/start.ts +117 -117
  134. package/src/commands/status.ts +54 -54
  135. package/src/commands/stop.ts +55 -55
  136. package/src/commands/sync.ts +151 -153
  137. package/src/commands/tui.ts +424 -0
  138. package/src/commands/ui.ts +111 -47
  139. package/src/core/config.test.ts +96 -96
  140. package/src/core/config.ts +115 -115
  141. package/src/core/graph.ts +344 -344
  142. package/src/core/packer.test.ts +99 -99
  143. package/src/core/packer.ts +107 -107
  144. package/src/core/scanner.test.ts +61 -61
  145. package/src/core/scanner.ts +91 -91
  146. package/src/core/workspace.ts +380 -380
  147. package/src/core/worktree.ts +120 -120
  148. package/src/generators/antigravity.ts +32 -32
  149. package/src/generators/base.ts +240 -227
  150. package/src/generators/claude.ts +34 -34
  151. package/src/generators/codex.ts +48 -48
  152. package/src/generators/copilot.ts +56 -56
  153. package/src/generators/cursor.ts +44 -44
  154. package/src/generators/index.ts +250 -250
  155. package/src/generators/map-generator.test.ts +159 -159
  156. package/src/generators/map-generator.ts +542 -542
  157. package/src/generators/plan-generator.ts +481 -481
  158. package/src/generators/skills-generator.ts +259 -259
  159. package/src/index.ts +426 -382
  160. package/src/mcp/server.ts +294 -294
  161. package/src/orchestration/detect.ts +313 -313
  162. package/src/orchestration/index.ts +7 -7
  163. package/src/orchestration/runner.ts +283 -283
  164. package/src/server.test.ts +555 -464
  165. package/src/server.ts +1308 -1104
  166. package/src/types.ts +408 -403
  167. package/src/utils/detect-ai.test.ts +44 -44
  168. package/src/utils/detect-ai.ts +84 -84
  169. package/src/utils/detect-editors.test.ts +48 -48
  170. package/src/utils/detect-editors.ts +57 -57
  171. package/src/utils/git.test.ts +74 -74
  172. package/src/utils/git.ts +117 -61
  173. package/src/utils/local-ai.test.ts +130 -130
  174. package/src/utils/local-ai.ts +111 -111
  175. package/src/utils/multi-git.ts +313 -306
  176. package/src/utils/prompts.ts +209 -209
  177. package/src/utils/session-finder.ts +483 -483
  178. package/src/utils/system-scanner.test.ts +89 -89
  179. package/src/utils/system-scanner.ts +96 -96
  180. package/src/utils/update-check.ts +309 -275
  181. package/src/utils/workflows.test.ts +114 -0
  182. package/src/utils/workflows.ts +178 -0
  183. package/tsconfig.json +19 -19
  184. package/vitest.config.ts +14 -14
  185. package/dist/gui/assets/index-CFWwqFux.js +0 -23
  186. package/dist/gui/assets/index-Dvc9QMvl.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
+ }