@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,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
+