@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,309 +1,286 @@
1
- /**
2
- * @module utils/update-check
3
- * Checks for updates to the NexusFlow package on the NPM registry.
4
- */
5
-
6
- import { fileURLToPath } from 'node:url';
7
- import * as fs from 'node:fs';
8
- import * as path from 'node:path';
9
- import chalk from 'chalk';
10
-
11
- import { loadConfig, saveConfig } from '../core/config.js';
12
-
13
- export interface UpdateStatus {
14
- currentVersion: string;
15
- latestVersion: string;
16
- updateAvailable: boolean;
17
- downloadUrl?: string | null;
18
- releaseNotes?: string;
19
- }
20
-
21
- interface GitHubAsset {
22
- name: string;
23
- browser_download_url: string;
24
- size: number;
25
- }
26
-
27
- interface GitHubRelease {
28
- tag_name: string;
29
- html_url: string;
30
- body: string;
31
- assets: GitHubAsset[];
32
- }
33
-
34
- /**
35
- * Resolves the current package version by searching for package.json upward
36
- * from the directory of the executing code.
37
- */
38
- export function getCurrentVersion(): string {
39
- try {
40
- const __filename = fileURLToPath(import.meta.url);
41
- const __dirname = path.dirname(__filename);
42
-
43
- let currentDir = __dirname;
44
- for (let i = 0; i < 5; i++) {
45
- const packageJsonPath = path.join(currentDir, 'package.json');
46
- if (fs.existsSync(packageJsonPath)) {
47
- const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
48
- return pkg.version;
49
- }
50
- const parentDir = path.dirname(currentDir);
51
- if (parentDir === currentDir) break;
52
- currentDir = parentDir;
53
- }
54
- } catch {
55
- // Fallback if filesystem access fails
56
- }
57
- return '0.1.5'; // Sensible fallback (active release)
58
- }
59
-
60
- /**
61
- * Checks for updates from the GitHub Releases API (antan87/NexusFlow).
62
- * Employs a 24-hour cache unless forced.
63
- *
64
- * @param force - If true, ignores the 24-hour cache and fetches immediately.
65
- * @returns The update status, or null if the check fails (e.g. offline).
66
- */
67
- export async function checkForUpdates(force = false): Promise<UpdateStatus | null> {
68
- const currentVersion = getCurrentVersion();
69
- const config = await loadConfig();
70
-
71
- const now = Date.now();
72
- const lastCheck = config.lastUpdateCheck ? new Date(config.lastUpdateCheck).getTime() : 0;
73
- const ONE_DAY_MS = 24 * 60 * 60 * 1000;
74
-
75
- // Use cached result if within 24 hours and not forced
76
- if (!force && lastCheck && (now - lastCheck < ONE_DAY_MS) && config.latestVersion) {
77
- return {
78
- currentVersion,
79
- latestVersion: config.latestVersion,
80
- updateAvailable: isNewerVersion(currentVersion, config.latestVersion),
81
- downloadUrl: config.latestDownloadUrl,
82
- releaseNotes: config.latestReleaseNotes,
83
- };
84
- }
85
-
86
- try {
87
- const response = await fetch('https://api.github.com/repos/antan87/NexusFlow/releases/latest', {
88
- headers: { 'User-Agent': 'NexusFlow-Updater' },
89
- signal: AbortSignal.timeout(4000),
90
- });
91
-
92
- if (!response.ok) {
93
- throw new Error(`GitHub API returned status ${response.status}`);
94
- }
95
-
96
- const data = await response.json() as GitHubRelease;
97
- const latestVersion = data.tag_name.replace(/^v/, '');
98
-
99
- // Resolve platform-matching asset (e.g. Setup.exe for Windows)
100
- let downloadUrl: string | null = null;
101
- const targetAsset = data.assets.find(asset => {
102
- return asset.name.endsWith('.exe') && asset.name.toLowerCase().includes('setup');
103
- });
104
- if (targetAsset) {
105
- downloadUrl = targetAsset.browser_download_url;
106
- }
107
-
108
- const releaseNotes = data.body || '';
109
-
110
- // Cache results
111
- config.lastUpdateCheck = new Date().toISOString();
112
- config.latestVersion = latestVersion;
113
- config.latestDownloadUrl = downloadUrl;
114
- config.latestReleaseNotes = releaseNotes;
115
- await saveConfig(config);
116
-
117
- return {
118
- currentVersion,
119
- latestVersion,
120
- updateAvailable: isNewerVersion(currentVersion, latestVersion),
121
- downloadUrl,
122
- releaseNotes,
123
- };
124
- } catch {
125
- // Fallback: If offline or check fails, return cached version status if available
126
- if (config.latestVersion) {
127
- return {
128
- currentVersion,
129
- latestVersion: config.latestVersion,
130
- updateAvailable: isNewerVersion(currentVersion, config.latestVersion),
131
- downloadUrl: config.latestDownloadUrl,
132
- releaseNotes: config.latestReleaseNotes,
133
- };
134
- }
135
- return null;
136
- }
137
- }
138
-
139
- /**
140
- * Simple semver comparison (checks major.minor.patch).
141
- */
142
- function isNewerVersion(current: string, latest: string): boolean {
143
- if (current === latest) return false;
144
-
145
- const currentParts = current.split('.').map(Number);
146
- const latestParts = latest.split('.').map(Number);
147
-
148
- for (let i = 0; i < 3; i++) {
149
- const curr = currentParts[i] || 0;
150
- const lat = latestParts[i] || 0;
151
- if (lat > curr) return true;
152
- if (curr > lat) return false;
153
- }
154
-
155
- return false;
156
- }
157
-
158
- /**
159
- * Prints a clean, premium terminal notification banner if an update is available.
160
- */
161
- export function printUpdateBanner(status: UpdateStatus): void {
162
- if (!status.updateAvailable) return;
163
-
164
- const msg = `Update available: ${chalk.red(status.currentVersion)} → ${chalk.green(status.latestVersion)}`;
165
- const runMsg = `Run ${chalk.cyan('npm install -g @mrpatronz/nexusflow')} to update!`;
166
-
167
- const cleanMsg = `Update available: ${status.currentVersion} → ${status.latestVersion}`;
168
- const cleanRunMsg = `Run npm install -g @mrpatronz/nexusflow to update!`;
169
- const width = Math.max(cleanMsg.length, cleanRunMsg.length) + 2;
170
-
171
- const padMsg = ' '.repeat(width - cleanMsg.length);
172
- const padRunMsg = ' '.repeat(width - cleanRunMsg.length);
173
-
174
- const border = '─'.repeat(width);
175
- console.log();
176
- console.log(chalk.yellow(`┌${border}┐`));
177
- console.log(chalk.yellow(`│ ${msg}${padMsg} │`));
178
- console.log(chalk.yellow(`│ ${runMsg}${padRunMsg} │`));
179
- console.log(chalk.yellow(`└${border}┘`));
180
- console.log();
181
- }
182
-
183
- import { execa } from 'execa';
184
-
185
- export interface ToolUpdateStatus {
186
- id: string;
187
- name: string;
188
- command: string;
189
- installed: boolean;
190
- currentVersion: string;
191
- latestVersion: string;
192
- updateAvailable: boolean;
193
- updateCmd: string;
194
- }
195
-
196
- export async function getToolsStatus(force = false): Promise<ToolUpdateStatus[]> {
197
- const currentVersion = getCurrentVersion();
198
- const tools = [
199
- {
200
- id: 'nexusflow',
201
- name: 'NexusFlow Engine',
202
- command: 'nexusflow',
203
- npmPackage: '@mrpatronz/nexusflow',
204
- updateCmd: 'npm install -g @mrpatronz/nexusflow',
205
- getCurrent: async () => currentVersion,
206
- },
207
- {
208
- id: 'repomix',
209
- name: 'Repomix (Codebase Packer)',
210
- command: 'repomix',
211
- npmPackage: 'repomix',
212
- updateCmd: 'npm install -g repomix',
213
- getCurrent: async () => {
214
- try {
215
- const res = await execa('repomix', ['--version'], {
216
- reject: false,
217
- shell: process.platform === 'win32',
218
- });
219
- if (res.exitCode === 0) return res.stdout.trim();
220
- } catch {}
221
- try {
222
- const res = await execa('npx', ['repomix', '--version'], {
223
- reject: false,
224
- shell: process.platform === 'win32',
225
- });
226
- if (res.exitCode === 0) return res.stdout.trim();
227
- } catch {}
228
- return '';
229
- }
230
- },
231
- {
232
- id: 'antigravity',
233
- name: 'Antigravity CLI',
234
- command: 'agy',
235
- npmPackage: '',
236
- updateCmd: 'agy update',
237
- getCurrent: async () => {
238
- try {
239
- const res = await execa('agy', ['--version'], {
240
- reject: false,
241
- shell: process.platform === 'win32',
242
- });
243
- if (res.exitCode === 0) return res.stdout.trim();
244
- } catch {}
245
- return '';
246
- }
247
- },
248
- {
249
- id: 'claude',
250
- name: 'Claude Code CLI',
251
- command: 'claude',
252
- npmPackage: '@anthropic-ai/claude-code',
253
- updateCmd: 'npm install -g @anthropic-ai/claude-code',
254
- getCurrent: async () => {
255
- try {
256
- const res = await execa('claude', ['--version'], {
257
- reject: false,
258
- shell: process.platform === 'win32',
259
- });
260
- if (res.exitCode === 0) return res.stdout.trim();
261
- } catch {}
262
- return '';
263
- }
264
- }
265
- ];
266
-
267
- const results: ToolUpdateStatus[] = [];
268
-
269
- for (const t of tools) {
270
- let installed = false;
271
- let currentVal = '';
272
- let latestVal = '';
273
-
274
- try {
275
- currentVal = await t.getCurrent();
276
- installed = currentVal !== '';
277
- } catch {}
278
-
279
- if (installed && t.npmPackage) {
280
- try {
281
- const response = await fetch(`https://registry.npmjs.org/${t.npmPackage}/latest`, {
282
- signal: AbortSignal.timeout(2000),
283
- });
284
- if (response.ok) {
285
- const data = await response.json() as { version: string };
286
- latestVal = data.version;
287
- }
288
- } catch {}
289
- }
290
-
291
- if (!latestVal) {
292
- latestVal = currentVal || '1.0.0';
293
- }
294
-
295
- results.push({
296
- id: t.id,
297
- name: t.name,
298
- command: t.command,
299
- installed,
300
- currentVersion: currentVal || 'Not Installed',
301
- latestVersion: latestVal,
302
- updateAvailable: installed && isNewerVersion(currentVal, latestVal),
303
- updateCmd: t.updateCmd,
304
- });
305
- }
306
-
307
- return results;
308
- }
309
-
1
+ /**
2
+ * @module utils/update-check
3
+ * Checks for updates to the NexusFlow package on the NPM registry.
4
+ */
5
+
6
+ import { fileURLToPath } from 'node:url';
7
+ import * as fs from 'node:fs';
8
+ import * as path from 'node:path';
9
+ import chalk from 'chalk';
10
+
11
+ import { loadConfig, saveConfig } from '../core/config.js';
12
+
13
+ export interface UpdateStatus {
14
+ currentVersion: string;
15
+ latestVersion: string;
16
+ updateAvailable: boolean;
17
+ downloadUrl?: string | null;
18
+ releaseNotes?: string;
19
+ }
20
+
21
+ interface GitHubAsset {
22
+ name: string;
23
+ browser_download_url: string;
24
+ size: number;
25
+ }
26
+
27
+ interface GitHubRelease {
28
+ tag_name: string;
29
+ html_url: string;
30
+ body: string;
31
+ assets: GitHubAsset[];
32
+ }
33
+
34
+ /**
35
+ * Resolves the current package version by searching for package.json upward
36
+ * from the directory of the executing code.
37
+ */
38
+ export function getCurrentVersion(): string {
39
+ try {
40
+ const __filename = fileURLToPath(import.meta.url);
41
+ const __dirname = path.dirname(__filename);
42
+
43
+ let currentDir = __dirname;
44
+ for (let i = 0; i < 5; i++) {
45
+ const packageJsonPath = path.join(currentDir, 'package.json');
46
+ if (fs.existsSync(packageJsonPath)) {
47
+ const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
48
+ return pkg.version;
49
+ }
50
+ const parentDir = path.dirname(currentDir);
51
+ if (parentDir === currentDir) break;
52
+ currentDir = parentDir;
53
+ }
54
+ } catch {
55
+ // Fallback if filesystem access fails
56
+ }
57
+ return '0.1.5'; // Sensible fallback (active release)
58
+ }
59
+
60
+ /**
61
+ * Checks for updates from the GitHub Releases API (antan87/NexusFlow).
62
+ * Employs a 24-hour cache unless forced.
63
+ *
64
+ * @param force - If true, ignores the 24-hour cache and fetches immediately.
65
+ * @returns The update status, or null if the check fails (e.g. offline).
66
+ */
67
+ export async function checkForUpdates(force = false): Promise<UpdateStatus | null> {
68
+ const currentVersion = getCurrentVersion();
69
+ const config = await loadConfig();
70
+
71
+ const now = Date.now();
72
+ const lastCheck = config.lastUpdateCheck ? new Date(config.lastUpdateCheck).getTime() : 0;
73
+ const ONE_DAY_MS = 24 * 60 * 60 * 1000;
74
+
75
+ // Use cached result if within 24 hours and not forced
76
+ if (!force && lastCheck && (now - lastCheck < ONE_DAY_MS) && config.latestVersion) {
77
+ return {
78
+ currentVersion,
79
+ latestVersion: config.latestVersion,
80
+ updateAvailable: isNewerVersion(currentVersion, config.latestVersion),
81
+ downloadUrl: config.latestDownloadUrl,
82
+ releaseNotes: config.latestReleaseNotes,
83
+ };
84
+ }
85
+
86
+ try {
87
+ const response = await fetch('https://api.github.com/repos/antan87/NexusFlow/releases/latest', {
88
+ headers: { 'User-Agent': 'NexusFlow-Updater' },
89
+ signal: AbortSignal.timeout(4000),
90
+ });
91
+
92
+ if (!response.ok) {
93
+ throw new Error(`GitHub API returned status ${response.status}`);
94
+ }
95
+
96
+ const data = await response.json() as GitHubRelease;
97
+ const latestVersion = data.tag_name.replace(/^v/, '');
98
+
99
+ // Resolve platform-matching asset (e.g. Setup.exe for Windows)
100
+ let downloadUrl: string | null = null;
101
+ const targetAsset = data.assets.find(asset => {
102
+ return asset.name.endsWith('.exe') && asset.name.toLowerCase().includes('setup');
103
+ });
104
+ if (targetAsset) {
105
+ downloadUrl = targetAsset.browser_download_url;
106
+ }
107
+
108
+ const releaseNotes = data.body || '';
109
+
110
+ // Cache results
111
+ config.lastUpdateCheck = new Date().toISOString();
112
+ config.latestVersion = latestVersion;
113
+ config.latestDownloadUrl = downloadUrl;
114
+ config.latestReleaseNotes = releaseNotes;
115
+ await saveConfig(config);
116
+
117
+ return {
118
+ currentVersion,
119
+ latestVersion,
120
+ updateAvailable: isNewerVersion(currentVersion, latestVersion),
121
+ downloadUrl,
122
+ releaseNotes,
123
+ };
124
+ } catch {
125
+ // Fallback: If offline or check fails, return cached version status if available
126
+ if (config.latestVersion) {
127
+ return {
128
+ currentVersion,
129
+ latestVersion: config.latestVersion,
130
+ updateAvailable: isNewerVersion(currentVersion, config.latestVersion),
131
+ downloadUrl: config.latestDownloadUrl,
132
+ releaseNotes: config.latestReleaseNotes,
133
+ };
134
+ }
135
+ return null;
136
+ }
137
+ }
138
+
139
+ /**
140
+ * Simple semver comparison (checks major.minor.patch).
141
+ */
142
+ function isNewerVersion(current: string, latest: string): boolean {
143
+ if (current === latest) return false;
144
+
145
+ const currentParts = current.split('.').map(Number);
146
+ const latestParts = latest.split('.').map(Number);
147
+
148
+ for (let i = 0; i < 3; i++) {
149
+ const curr = currentParts[i] || 0;
150
+ const lat = latestParts[i] || 0;
151
+ if (lat > curr) return true;
152
+ if (curr > lat) return false;
153
+ }
154
+
155
+ return false;
156
+ }
157
+
158
+ /**
159
+ * Prints a clean, premium terminal notification banner if an update is available.
160
+ */
161
+ export function printUpdateBanner(status: UpdateStatus): void {
162
+ if (!status.updateAvailable) return;
163
+
164
+ const msg = `Update available: ${chalk.red(status.currentVersion)} → ${chalk.green(status.latestVersion)}`;
165
+ const runMsg = `Run ${chalk.cyan('npm install -g @mrpatronz/nexusflow')} to update!`;
166
+
167
+ const cleanMsg = `Update available: ${status.currentVersion} → ${status.latestVersion}`;
168
+ const cleanRunMsg = `Run npm install -g @mrpatronz/nexusflow to update!`;
169
+ const width = Math.max(cleanMsg.length, cleanRunMsg.length) + 2;
170
+
171
+ const padMsg = ' '.repeat(width - cleanMsg.length);
172
+ const padRunMsg = ' '.repeat(width - cleanRunMsg.length);
173
+
174
+ const border = '─'.repeat(width);
175
+ console.log();
176
+ console.log(chalk.yellow(`┌${border}┐`));
177
+ console.log(chalk.yellow(`│ ${msg}${padMsg} │`));
178
+ console.log(chalk.yellow(`│ ${runMsg}${padRunMsg} │`));
179
+ console.log(chalk.yellow(`└${border}┘`));
180
+ console.log();
181
+ }
182
+
183
+ import { execa } from 'execa';
184
+
185
+ export interface ToolUpdateStatus {
186
+ id: string;
187
+ name: string;
188
+ command: string;
189
+ installed: boolean;
190
+ currentVersion: string;
191
+ latestVersion: string;
192
+ updateAvailable: boolean;
193
+ updateCmd: string;
194
+ }
195
+
196
+ export async function getToolsStatus(force = false): Promise<ToolUpdateStatus[]> {
197
+ const currentVersion = getCurrentVersion();
198
+ const tools = [
199
+ {
200
+ id: 'nexusflow',
201
+ name: 'NexusFlow Engine',
202
+ command: 'nexusflow',
203
+ npmPackage: '@mrpatronz/nexusflow',
204
+ updateCmd: 'npm install -g @mrpatronz/nexusflow',
205
+ getCurrent: async () => currentVersion,
206
+ },
207
+
208
+ {
209
+ id: 'antigravity',
210
+ name: 'Antigravity CLI',
211
+ command: 'agy',
212
+ npmPackage: '',
213
+ updateCmd: 'agy update',
214
+ getCurrent: async () => {
215
+ try {
216
+ const res = await execa('agy', ['--version'], {
217
+ reject: false,
218
+ shell: process.platform === 'win32',
219
+ });
220
+ if (res.exitCode === 0) return res.stdout.trim();
221
+ } catch {}
222
+ return '';
223
+ }
224
+ },
225
+ {
226
+ id: 'claude',
227
+ name: 'Claude Code CLI',
228
+ command: 'claude',
229
+ npmPackage: '@anthropic-ai/claude-code',
230
+ updateCmd: 'npm install -g @anthropic-ai/claude-code',
231
+ getCurrent: async () => {
232
+ try {
233
+ const res = await execa('claude', ['--version'], {
234
+ reject: false,
235
+ shell: process.platform === 'win32',
236
+ });
237
+ if (res.exitCode === 0) return res.stdout.trim();
238
+ } catch {}
239
+ return '';
240
+ }
241
+ }
242
+ ];
243
+
244
+ const results: ToolUpdateStatus[] = [];
245
+
246
+ for (const t of tools) {
247
+ let installed = false;
248
+ let currentVal = '';
249
+ let latestVal = '';
250
+
251
+ try {
252
+ currentVal = await t.getCurrent();
253
+ installed = currentVal !== '';
254
+ } catch {}
255
+
256
+ if (installed && t.npmPackage) {
257
+ try {
258
+ const response = await fetch(`https://registry.npmjs.org/${t.npmPackage}/latest`, {
259
+ signal: AbortSignal.timeout(2000),
260
+ });
261
+ if (response.ok) {
262
+ const data = await response.json() as { version: string };
263
+ latestVal = data.version;
264
+ }
265
+ } catch {}
266
+ }
267
+
268
+ if (!latestVal) {
269
+ latestVal = currentVal || '1.0.0';
270
+ }
271
+
272
+ results.push({
273
+ id: t.id,
274
+ name: t.name,
275
+ command: t.command,
276
+ installed,
277
+ currentVersion: currentVal || 'Not Installed',
278
+ latestVersion: latestVal,
279
+ updateAvailable: installed && isNewerVersion(currentVal, latestVal),
280
+ updateCmd: t.updateCmd,
281
+ });
282
+ }
283
+
284
+ return results;
285
+ }
286
+