@mrpatronz/nexusflow 0.2.19 โ†’ 1.3.1

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 (294) hide show
  1. package/README.md +37 -7
  2. package/dist/analyzers/index.d.ts +23 -0
  3. package/dist/analyzers/index.d.ts.map +1 -1
  4. package/dist/analyzers/index.js +62 -0
  5. package/dist/analyzers/index.js.map +1 -1
  6. package/dist/commands/add-repo.d.ts +9 -0
  7. package/dist/commands/add-repo.d.ts.map +1 -1
  8. package/dist/commands/add-repo.js +12 -1
  9. package/dist/commands/add-repo.js.map +1 -1
  10. package/dist/commands/add-repo.test.d.ts +2 -0
  11. package/dist/commands/add-repo.test.d.ts.map +1 -0
  12. package/dist/commands/add-repo.test.js +30 -0
  13. package/dist/commands/add-repo.test.js.map +1 -0
  14. package/dist/commands/commands.test.js +26 -6
  15. package/dist/commands/commands.test.js.map +1 -1
  16. package/dist/commands/commit.d.ts +7 -1
  17. package/dist/commands/commit.d.ts.map +1 -1
  18. package/dist/commands/commit.js +31 -8
  19. package/dist/commands/commit.js.map +1 -1
  20. package/dist/commands/commit.test.d.ts +2 -0
  21. package/dist/commands/commit.test.d.ts.map +1 -0
  22. package/dist/commands/commit.test.js +54 -0
  23. package/dist/commands/commit.test.js.map +1 -0
  24. package/dist/commands/diff.d.ts +9 -2
  25. package/dist/commands/diff.d.ts.map +1 -1
  26. package/dist/commands/diff.js +36 -12
  27. package/dist/commands/diff.js.map +1 -1
  28. package/dist/commands/doctor.d.ts.map +1 -1
  29. package/dist/commands/doctor.js +16 -20
  30. package/dist/commands/doctor.js.map +1 -1
  31. package/dist/commands/handoff.d.ts.map +1 -1
  32. package/dist/commands/handoff.js +11 -15
  33. package/dist/commands/handoff.js.map +1 -1
  34. package/dist/commands/refresh.d.ts +4 -2
  35. package/dist/commands/refresh.d.ts.map +1 -1
  36. package/dist/commands/refresh.js +20 -36
  37. package/dist/commands/refresh.js.map +1 -1
  38. package/dist/commands/schedule.d.ts +35 -0
  39. package/dist/commands/schedule.d.ts.map +1 -0
  40. package/dist/commands/schedule.js +151 -0
  41. package/dist/commands/schedule.js.map +1 -0
  42. package/dist/commands/sync.d.ts.map +1 -1
  43. package/dist/commands/sync.js +28 -7
  44. package/dist/commands/sync.js.map +1 -1
  45. package/dist/commands/tui.js +1 -1
  46. package/dist/commands/tui.js.map +1 -1
  47. package/dist/commands/ui.d.ts +1 -0
  48. package/dist/commands/ui.d.ts.map +1 -1
  49. package/dist/commands/ui.js +5 -2
  50. package/dist/commands/ui.js.map +1 -1
  51. package/dist/core/adapters/local-storage.d.ts +7 -0
  52. package/dist/core/adapters/local-storage.d.ts.map +1 -1
  53. package/dist/core/adapters/local-storage.js +13 -4
  54. package/dist/core/adapters/local-storage.js.map +1 -1
  55. package/dist/core/adapters/storage.test.js +18 -0
  56. package/dist/core/adapters/storage.test.js.map +1 -1
  57. package/dist/core/analysis-cache.d.ts +58 -0
  58. package/dist/core/analysis-cache.d.ts.map +1 -0
  59. package/dist/core/analysis-cache.js +116 -0
  60. package/dist/core/analysis-cache.js.map +1 -0
  61. package/dist/core/analysis-cache.test.d.ts +2 -0
  62. package/dist/core/analysis-cache.test.d.ts.map +1 -0
  63. package/dist/core/analysis-cache.test.js +108 -0
  64. package/dist/core/analysis-cache.test.js.map +1 -0
  65. package/dist/core/refresh.d.ts +41 -0
  66. package/dist/core/refresh.d.ts.map +1 -0
  67. package/dist/core/refresh.js +56 -0
  68. package/dist/core/refresh.js.map +1 -0
  69. package/dist/core/scheduler.d.ts +117 -0
  70. package/dist/core/scheduler.d.ts.map +1 -0
  71. package/dist/core/scheduler.js +361 -0
  72. package/dist/core/scheduler.js.map +1 -0
  73. package/dist/core/scheduler.test.d.ts +2 -0
  74. package/dist/core/scheduler.test.d.ts.map +1 -0
  75. package/dist/core/scheduler.test.js +163 -0
  76. package/dist/core/scheduler.test.js.map +1 -0
  77. package/dist/core/sync.d.ts +6 -0
  78. package/dist/core/sync.d.ts.map +1 -1
  79. package/dist/core/sync.js +17 -12
  80. package/dist/core/sync.js.map +1 -1
  81. package/dist/core/workspace.d.ts +6 -0
  82. package/dist/core/workspace.d.ts.map +1 -1
  83. package/dist/core/workspace.js +32 -15
  84. package/dist/core/workspace.js.map +1 -1
  85. package/dist/core/workspace.test.d.ts +2 -0
  86. package/dist/core/workspace.test.d.ts.map +1 -0
  87. package/dist/core/workspace.test.js +42 -0
  88. package/dist/core/workspace.test.js.map +1 -0
  89. package/dist/generators/index.d.ts +7 -1
  90. package/dist/generators/index.d.ts.map +1 -1
  91. package/dist/generators/index.js +14 -1
  92. package/dist/generators/index.js.map +1 -1
  93. package/dist/generators/map-generator.d.ts.map +1 -1
  94. package/dist/generators/map-generator.js +4 -3
  95. package/dist/generators/map-generator.js.map +1 -1
  96. package/dist/generators/map-generator.test.js +4 -2
  97. package/dist/generators/map-generator.test.js.map +1 -1
  98. package/dist/gui/assets/index-ElroPpSP.js +26 -0
  99. package/dist/gui/index.html +1 -1
  100. package/dist/index.js +108 -4
  101. package/dist/index.js.map +1 -1
  102. package/dist/orchestration/index.d.ts +1 -1
  103. package/dist/orchestration/index.d.ts.map +1 -1
  104. package/dist/orchestration/index.js +1 -1
  105. package/dist/orchestration/index.js.map +1 -1
  106. package/dist/orchestration/runner.d.ts +16 -1
  107. package/dist/orchestration/runner.d.ts.map +1 -1
  108. package/dist/orchestration/runner.js +41 -5
  109. package/dist/orchestration/runner.js.map +1 -1
  110. package/dist/orchestration/runner.test.d.ts +2 -0
  111. package/dist/orchestration/runner.test.d.ts.map +1 -0
  112. package/dist/orchestration/runner.test.js +71 -0
  113. package/dist/orchestration/runner.test.js.map +1 -0
  114. package/dist/server.d.ts +17 -1
  115. package/dist/server.d.ts.map +1 -1
  116. package/dist/server.js +275 -114
  117. package/dist/server.js.map +1 -1
  118. package/dist/server.test.js +158 -1
  119. package/dist/server.test.js.map +1 -1
  120. package/dist/utils/multi-git.d.ts +21 -0
  121. package/dist/utils/multi-git.d.ts.map +1 -1
  122. package/dist/utils/multi-git.js +40 -4
  123. package/dist/utils/multi-git.js.map +1 -1
  124. package/dist/utils/prompts.d.ts.map +1 -1
  125. package/dist/utils/prompts.js +8 -2
  126. package/dist/utils/prompts.js.map +1 -1
  127. package/package.json +13 -1
  128. package/.agents/skills/ccc/SKILL.md +0 -71
  129. package/.agents/skills/ccc/references/management.md +0 -110
  130. package/.agents/skills/ccc/references/settings.md +0 -126
  131. package/.github/dependabot.yml +0 -52
  132. package/.github/workflows/ci.yml +0 -44
  133. package/.github/workflows/dependabot-merge.yml +0 -53
  134. package/.github/workflows/release-desktop.yml +0 -67
  135. package/.github/workflows/release-npm.yml +0 -65
  136. package/.github/workflows/release-vscode.yml +0 -61
  137. package/.vscode/launch.json +0 -17
  138. package/.vscode/tasks.json +0 -17
  139. package/GETTING_STARTED.md +0 -114
  140. package/desktop/build-installer.js +0 -228
  141. package/desktop/build.js +0 -118
  142. package/desktop/installer/nexusflow.iss +0 -35
  143. package/desktop/neutralino.config.json +0 -39
  144. package/desktop/package-lock.json +0 -1060
  145. package/desktop/package.json +0 -14
  146. package/dist/gui/assets/index-D8iJPvnk.js +0 -26
  147. package/extension/media/icon.svg +0 -1
  148. package/extension/package-lock.json +0 -6044
  149. package/extension/package.json +0 -117
  150. package/extension/src/extension.ts +0 -653
  151. package/extension/tsconfig.json +0 -21
  152. package/gui/README.md +0 -73
  153. package/gui/e2e/dashboard.spec.ts +0 -61
  154. package/gui/e2e/wizard.spec.ts +0 -346
  155. package/gui/eslint.config.js +0 -26
  156. package/gui/index.html +0 -17
  157. package/gui/package-lock.json +0 -3137
  158. package/gui/package.json +0 -37
  159. package/gui/playwright.config.ts +0 -41
  160. package/gui/public/app_logo.png +0 -0
  161. package/gui/public/favicon.svg +0 -1
  162. package/gui/public/icons.svg +0 -24
  163. package/gui/src/App.css +0 -1
  164. package/gui/src/App.tsx +0 -3573
  165. package/gui/src/app/AppSidebar.tsx +0 -69
  166. package/gui/src/assets/hero.png +0 -0
  167. package/gui/src/assets/react.svg +0 -1
  168. package/gui/src/assets/vite.svg +0 -1
  169. package/gui/src/components/AddRepoPicker.tsx +0 -81
  170. package/gui/src/components/ui/Button.tsx +0 -40
  171. package/gui/src/components/ui/Card.tsx +0 -6
  172. package/gui/src/components/ui/EmptyState.tsx +0 -22
  173. package/gui/src/components/ui/Input.tsx +0 -21
  174. package/gui/src/components/ui/Menu.tsx +0 -71
  175. package/gui/src/components/ui/Modal.tsx +0 -39
  176. package/gui/src/components/ui/PageHeader.tsx +0 -21
  177. package/gui/src/components/ui/RepoStatusStrip.tsx +0 -33
  178. package/gui/src/components/ui/Skeleton.tsx +0 -5
  179. package/gui/src/components/ui/StatusPill.tsx +0 -36
  180. package/gui/src/components/ui/Tabs.tsx +0 -40
  181. package/gui/src/components/ui/cn.ts +0 -4
  182. package/gui/src/components/ui/index.ts +0 -16
  183. package/gui/src/features/changes/ChangesViewer.tsx +0 -388
  184. package/gui/src/features/knowledge/KnowledgeBase.tsx +0 -84
  185. package/gui/src/features/onboarding/OnboardingWizard.tsx +0 -230
  186. package/gui/src/features/plan/ImplementationPlan.tsx +0 -32
  187. package/gui/src/features/services/ServiceConsole.tsx +0 -215
  188. package/gui/src/features/sessions/SessionHistory.tsx +0 -195
  189. package/gui/src/index.css +0 -167
  190. package/gui/src/lib/status.ts +0 -24
  191. package/gui/src/main.tsx +0 -94
  192. package/gui/src/pages/DashboardPage.tsx +0 -129
  193. package/gui/src/pages/WorkspacesPage.tsx +0 -352
  194. package/gui/src/types.ts +0 -81
  195. package/gui/tsconfig.app.json +0 -25
  196. package/gui/tsconfig.json +0 -7
  197. package/gui/tsconfig.node.json +0 -24
  198. package/gui/vite.config.ts +0 -12
  199. package/resources/workflows/plan-implement-review.md +0 -8
  200. package/resources/workflows/research-verify.md +0 -6
  201. package/resources/workflows/solo-developer.md +0 -3
  202. package/scripts/simulate-workspaces.ts +0 -55
  203. package/skills-lock.json +0 -11
  204. package/src/analyzers/detect-apis.ts +0 -290
  205. package/src/analyzers/detect-deps.ts +0 -315
  206. package/src/analyzers/detect-existing.ts +0 -74
  207. package/src/analyzers/detect-ports.ts +0 -110
  208. package/src/analyzers/index.ts +0 -97
  209. package/src/analyzers/messaging-analyzer.ts +0 -254
  210. package/src/analyzers/readme-summarizer.ts +0 -102
  211. package/src/analyzers/run-analyzer.ts +0 -269
  212. package/src/analyzers/tech-stack.ts +0 -283
  213. package/src/commands/adapter.ts +0 -348
  214. package/src/commands/add-repo.ts +0 -156
  215. package/src/commands/commands.test.ts +0 -156
  216. package/src/commands/commit.ts +0 -131
  217. package/src/commands/config.ts +0 -52
  218. package/src/commands/create.ts +0 -204
  219. package/src/commands/desktop.ts +0 -128
  220. package/src/commands/diff.ts +0 -125
  221. package/src/commands/doctor.ts +0 -370
  222. package/src/commands/handoff.ts +0 -266
  223. package/src/commands/init.ts +0 -134
  224. package/src/commands/list.ts +0 -46
  225. package/src/commands/logs.ts +0 -63
  226. package/src/commands/mcp.ts +0 -94
  227. package/src/commands/open.ts +0 -129
  228. package/src/commands/refresh.ts +0 -137
  229. package/src/commands/remove.ts +0 -98
  230. package/src/commands/start.ts +0 -117
  231. package/src/commands/status.ts +0 -54
  232. package/src/commands/stop.ts +0 -55
  233. package/src/commands/sync.ts +0 -125
  234. package/src/commands/tui.ts +0 -484
  235. package/src/commands/ui.ts +0 -111
  236. package/src/core/adapters/local-storage.ts +0 -66
  237. package/src/core/adapters/obsidian-storage.ts +0 -151
  238. package/src/core/adapters/registry.ts +0 -44
  239. package/src/core/adapters/storage.test.ts +0 -174
  240. package/src/core/adapters/vault-storage.ts +0 -86
  241. package/src/core/config.test.ts +0 -96
  242. package/src/core/config.ts +0 -140
  243. package/src/core/graph.ts +0 -344
  244. package/src/core/plugins/index.ts +0 -17
  245. package/src/core/plugins/loader.ts +0 -36
  246. package/src/core/ports/storage.ts +0 -71
  247. package/src/core/scanner.test.ts +0 -61
  248. package/src/core/scanner.ts +0 -91
  249. package/src/core/storage.ts +0 -37
  250. package/src/core/sync.ts +0 -121
  251. package/src/core/workspace-state.test.ts +0 -108
  252. package/src/core/workspace-state.ts +0 -130
  253. package/src/core/workspace.ts +0 -487
  254. package/src/core/worktree.ts +0 -120
  255. package/src/generators/antigravity.ts +0 -32
  256. package/src/generators/base.ts +0 -243
  257. package/src/generators/claude.ts +0 -34
  258. package/src/generators/codex.ts +0 -48
  259. package/src/generators/copilot.ts +0 -56
  260. package/src/generators/cursor.ts +0 -44
  261. package/src/generators/diff-context.ts +0 -75
  262. package/src/generators/index.ts +0 -322
  263. package/src/generators/map-generator.test.ts +0 -159
  264. package/src/generators/map-generator.ts +0 -539
  265. package/src/generators/plan-generator.ts +0 -483
  266. package/src/generators/skills-generator.ts +0 -259
  267. package/src/index.ts +0 -539
  268. package/src/mcp/server.ts +0 -338
  269. package/src/orchestration/detect.ts +0 -313
  270. package/src/orchestration/index.ts +0 -7
  271. package/src/orchestration/runner.ts +0 -283
  272. package/src/server.test.ts +0 -618
  273. package/src/server.ts +0 -1402
  274. package/src/types.ts +0 -451
  275. package/src/utils/detect-ai.test.ts +0 -44
  276. package/src/utils/detect-ai.ts +0 -84
  277. package/src/utils/detect-editors.test.ts +0 -48
  278. package/src/utils/detect-editors.ts +0 -57
  279. package/src/utils/git.test.ts +0 -74
  280. package/src/utils/git.ts +0 -117
  281. package/src/utils/local-ai.test.ts +0 -130
  282. package/src/utils/local-ai.ts +0 -116
  283. package/src/utils/multi-git.test.ts +0 -158
  284. package/src/utils/multi-git.ts +0 -405
  285. package/src/utils/prompts.ts +0 -209
  286. package/src/utils/session-finder.ts +0 -483
  287. package/src/utils/system-scanner.test.ts +0 -89
  288. package/src/utils/system-scanner.ts +0 -96
  289. package/src/utils/update-check.ts +0 -286
  290. package/src/utils/workflow-advisor.ts +0 -118
  291. package/src/utils/workflows.test.ts +0 -114
  292. package/src/utils/workflows.ts +0 -178
  293. package/tsconfig.json +0 -19
  294. package/vitest.config.ts +0 -14
@@ -1,370 +0,0 @@
1
- import chalk from 'chalk';
2
- import { select } from '@inquirer/prompts';
3
- import * as path from 'node:path';
4
- import * as fs from 'node:fs/promises';
5
- import { execa } from 'execa';
6
-
7
- import { loadConfig } from '../core/config.js';
8
- import { listWorkspaces, loadFeatureConfig } from '../core/workspace.js';
9
- import { getRepoStatus } from '../utils/multi-git.js';
10
- import { analyzeAllRepos } from '../analyzers/index.js';
11
- import { globby } from 'globby';
12
- import { isOllamaModelAvailable, getOpenAiCompatibleUrl } from '../utils/local-ai.js';
13
-
14
- /**
15
- * Runs the doctor command to diagnose workspace state.
16
- *
17
- * @param workspaceArg - Optional workspace path.
18
- */
19
- export async function doctorCommand(workspaceArg?: string): Promise<void> {
20
- console.log(chalk.bold.cyan('\n๐Ÿฉบ NexusFlow โ€” Workspace Doctor\n'));
21
-
22
- const workspacePath = await resolveWorkspace(workspaceArg);
23
- if (!workspacePath) return;
24
-
25
- const feature = await loadFeatureConfig(workspacePath);
26
- if (!feature) {
27
- console.error(chalk.red('โœ– Failed to load workspace configuration. Ensure nexusflow.json exists.'));
28
- return;
29
- }
30
-
31
- const allRepos = await Promise.all(
32
- feature.repos.map(async (r) => {
33
- const repoName = path.basename(r);
34
- return {
35
- name: repoName,
36
- path: r,
37
- defaultBranch: 'main',
38
- };
39
- })
40
- );
41
-
42
- console.log(chalk.cyan('Running diagnostics...\n'));
43
-
44
- const warnings: string[] = [];
45
- const errors: string[] = [];
46
-
47
- // โ”€โ”€ 1. Worktree Paths Check โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
48
- console.log(chalk.bold('๐Ÿ“ Worktree Paths:'));
49
- let worktreeErrors = false;
50
- for (const repo of allRepos) {
51
- try {
52
- const stat = await fs.stat(repo.path);
53
- if (!stat.isDirectory()) {
54
- errors.push(`Worktree path for "${repo.name}" is not a directory.`);
55
- console.log(` ${chalk.red('โœ–')} ${repo.name}: Path is not a directory`);
56
- worktreeErrors = true;
57
- } else {
58
- console.log(` ${chalk.green('โœ”')} ${repo.name}: Directory exists`);
59
- }
60
- } catch {
61
- errors.push(`Worktree path for "${repo.name}" does not exist: ${repo.path}`);
62
- console.log(` ${chalk.red('โœ–')} ${repo.name}: Path does not exist`);
63
- worktreeErrors = true;
64
- }
65
- }
66
- console.log();
67
-
68
- if (worktreeErrors) {
69
- console.error(chalk.red('โœ– Worktree errors detected. Cannot complete diagnostics.\n'));
70
- return;
71
- }
72
-
73
- // โ”€โ”€ 2. Run Analysis for detailed checks โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
74
- const analysis = await analyzeAllRepos(allRepos);
75
- console.log();
76
-
77
- // โ”€โ”€ 3. Branch & Git Status Checks โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
78
- console.log(chalk.bold('๐ŸŒฟ Branch Alignment & Git Status:'));
79
- for (const repo of allRepos) {
80
- let branch = 'unknown';
81
- try {
82
- const { stdout } = await execa('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: repo.path });
83
- branch = stdout.trim();
84
- } catch {}
85
-
86
- if (branch !== feature.branchName) {
87
- warnings.push(`Repository "${repo.name}" is checked out on branch "${branch}", but workspace branch is "${feature.branchName}".`);
88
- console.log(` ${chalk.yellow('โš ')} ${repo.name}: Branch mismatch (${chalk.bold(branch)} vs expected ${chalk.bold(feature.branchName)})`);
89
- } else {
90
- console.log(` ${chalk.green('โœ”')} ${repo.name}: Aligned on branch "${branch}"`);
91
- }
92
-
93
- const status = await getRepoStatus(repo.path);
94
- if (status.hasChanges) {
95
- warnings.push(`Repository "${repo.name}" has uncommitted changes.`);
96
- console.log(` ${chalk.dim(`โ†ณ Has uncommitted changes (${status.summary})`)}`);
97
- }
98
- }
99
- console.log();
100
-
101
- // โ”€โ”€ 4. Package Registry, Local Feeds, and Temporary Local Versions โ”€โ”€โ”€โ”€โ”€
102
- console.log(chalk.bold('๐Ÿ“ฆ Local Package Setup & Reference Versioning:'));
103
- let hasCsharp = false;
104
- let hasNode = false;
105
-
106
- for (const repo of allRepos) {
107
- const a = analysis.get(repo.path);
108
- if (!a) continue;
109
-
110
- if (a.techStack.languages.includes('csharp')) hasCsharp = true;
111
- if (a.techStack.languages.includes('typescript') || a.techStack.languages.includes('javascript')) hasNode = true;
112
-
113
- // Check for temporary/uncommitted versions in C# csproj
114
- if (a.techStack.languages.includes('csharp')) {
115
- try {
116
- const csprojs = await globby('**/*.csproj', {
117
- cwd: repo.path,
118
- absolute: true,
119
- ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/dist/**', '**/out/**', '**/.git/**'],
120
- });
121
-
122
- for (const csproj of csprojs) {
123
- const content = await fs.readFile(csproj, 'utf-8');
124
- if (content.toLowerCase().includes('-local') || content.toLowerCase().includes('-dev')) {
125
- warnings.push(`Temporary package version (e.g. ending in "-local" or "-dev") found in "${path.basename(csproj)}".`);
126
- console.log(` ${chalk.yellow('โš ')} ${repo.name}: Temporary local package version found in "${path.basename(csproj)}"`);
127
- }
128
- }
129
- } catch {}
130
-
131
- // NuGet local feed checks: check if any local NuGet source is defined in local NuGet.configs
132
- if (a.nugetFeeds && a.nugetFeeds.length === 0) {
133
- // Find if there are NuGet.config files
134
- try {
135
- const nugetConfigs = await globby('**/NuGet.config', {
136
- cwd: repo.path,
137
- ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/dist/**', '**/out/**', '**/.git/**'],
138
- });
139
- if (nugetConfigs.length === 0) {
140
- warnings.push(`Repository "${repo.name}" does not have a NuGet.config. It might not resolve local package dependencies.`);
141
- console.log(` ${chalk.yellow('โš ')} ${repo.name}: No NuGet.config found (needed to configure local package feeds)`);
142
- }
143
- } catch {}
144
- }
145
- }
146
-
147
- // Check for relative path/file: dependencies in Node package.json
148
- if (a.techStack.languages.includes('typescript') || a.techStack.languages.includes('javascript')) {
149
- try {
150
- const pjs = await globby('**/package.json', {
151
- cwd: repo.path,
152
- absolute: true,
153
- ignore: ['**/node_modules/**', '**/bin/**', '**/obj/**', '**/dist/**', '**/out/**', '**/.git/**'],
154
- });
155
-
156
- for (const pj of pjs) {
157
- const content = await fs.readFile(pj, 'utf-8');
158
- if (content.includes('"file:') || content.includes('"link:')) {
159
- warnings.push(`Temporary package link/file reference (e.g., "file:../") found in "${path.basename(pj)}".`);
160
- console.log(` ${chalk.yellow('โš ')} ${repo.name}: Temporary local dependency reference ("file:" or "link:") found in "${path.basename(pj)}"`);
161
- }
162
- }
163
- } catch {}
164
- }
165
- }
166
-
167
- if (hasCsharp || hasNode) {
168
- console.log(` ${chalk.green('โœ”')} Local registry feeds/link validation completed.`);
169
- } else {
170
- console.log(` ${chalk.dim('No C# or Node.js repositories to validate.')}`);
171
- }
172
- console.log();
173
-
174
- // โ”€โ”€ 5. Test Commands & Fallbacks โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
175
- console.log(chalk.bold('๐Ÿงช Test Commands:'));
176
- for (const repo of allRepos) {
177
- const a = analysis.get(repo.path);
178
- if (!a) continue;
179
-
180
- const testCommand = getTestCommand(a);
181
- if (testCommand === 'npm test' && !a.techStack.languages.includes('typescript') && !a.techStack.languages.includes('javascript')) {
182
- warnings.push(`Repository "${repo.name}" fell back to default test command "npm test".`);
183
- console.log(` ${chalk.yellow('โš ')} ${repo.name}: Using default fallback test command "npm test"`);
184
- } else {
185
- console.log(` ${chalk.green('โœ”')} ${repo.name}: Test command is "${testCommand}"`);
186
- }
187
- }
188
- console.log();
189
-
190
- // โ”€โ”€ 6. Missing Core Files โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
191
- console.log(chalk.bold('๐Ÿ“„ Core Artifacts:'));
192
- const coreFiles = [
193
- { name: 'WORKSPACE.md', required: true },
194
- { name: 'nexusflow-knowledge.md', required: true },
195
- { name: 'nexusflow-plan.md', required: true },
196
- ];
197
-
198
- // Add expected maps
199
- for (const repo of allRepos) {
200
- coreFiles.push({ name: `nexusflow-map-${repo.name}.md`, required: true });
201
- }
202
-
203
- for (const file of coreFiles) {
204
- const filePath = path.join(workspacePath, file.name);
205
- try {
206
- await fs.access(filePath);
207
- console.log(` ${chalk.green('โœ”')} ${file.name} exists`);
208
- } catch {
209
- warnings.push(`Missing core workspace artifact: "${file.name}".`);
210
- console.log(` ${chalk.yellow('โš ')} ${file.name} is missing`);
211
- }
212
- }
213
-
214
- // Check .code-workspace file exists (required for VS Code SCM to discover worktrees)
215
- const workspaceName = path.basename(workspacePath);
216
- const codeWorkspacePath = path.join(workspacePath, `${workspaceName}.code-workspace`);
217
- try {
218
- await fs.access(codeWorkspacePath);
219
- console.log(` ${chalk.green('โœ”')} ${workspaceName}.code-workspace exists`);
220
- } catch {
221
- warnings.push(
222
- `Missing ${workspaceName}.code-workspace. VS Code SCM will not show changes inside repo sub-folders. Run \`nexusflow refresh\` to regenerate it.`
223
- );
224
- console.log(` ${chalk.yellow('โš ')} ${workspaceName}.code-workspace is missing`);
225
- }
226
-
227
- // Check VS Code Settings for search.useIgnoreFiles: false
228
- const vscodeSettingsPath = path.join(workspacePath, '.vscode', 'settings.json');
229
- try {
230
- const content = await fs.readFile(vscodeSettingsPath, 'utf-8');
231
- const parsed = JSON.parse(content);
232
- if (parsed['search.useIgnoreFiles'] === false) {
233
- console.log(` ${chalk.green('โœ”')} .vscode/settings.json is configured correctly (search.useIgnoreFiles: false)`);
234
- } else {
235
- warnings.push('.vscode/settings.json search.useIgnoreFiles is not set to false. VS Code global search may ignore repository files.');
236
- console.log(` ${chalk.yellow('โš ')} .vscode/settings.json: search.useIgnoreFiles is not set to false`);
237
- }
238
- } catch {
239
- warnings.push('Missing .vscode/settings.json. VS Code search might not work properly inside sub-repos.');
240
- console.log(` ${chalk.yellow('โš ')} .vscode/settings.json is missing or invalid`);
241
- }
242
- console.log();
243
-
244
- // โ”€โ”€ 7. Local AI Agent Connection Check โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
245
- console.log(chalk.bold('๐Ÿค– Local AI Agent:'));
246
- const config = await loadConfig();
247
- if (config.localLlm?.enabled) {
248
- const { provider, endpoint, model } = config.localLlm;
249
- console.log(` Provider: ${provider}`);
250
- console.log(` Endpoint: ${endpoint}`);
251
- console.log(` Model: ${model}`);
252
-
253
- try {
254
- const cleanEndpoint = endpoint.replace(/\/$/, '');
255
- const controller = new AbortController();
256
- const timeout = setTimeout(() => controller.abort(), 5000);
257
-
258
- try {
259
- if (provider === 'ollama') {
260
- const res = await fetch(`${cleanEndpoint}/api/tags`, { signal: controller.signal });
261
- if (!res.ok) {
262
- throw new Error(`Ollama responded with status ${res.status}`);
263
- }
264
- const data: any = await res.json();
265
- const models = data?.models || [];
266
- const isModelLoaded = isOllamaModelAvailable(models, model);
267
-
268
- if (isModelLoaded) {
269
- console.log(` ${chalk.green('โœ”')} Ollama service is active and model "${model}" is ready`);
270
- } else {
271
- const availableList = models.map((m: any) => m.name).join(', ') || 'none';
272
- warnings.push(`Local model "${model}" is not pulled in Ollama. Available: [${availableList}]. Run "ollama pull ${model}" to install it.`);
273
- console.log(` ${chalk.yellow('โš ')} Ollama service is active, but model "${model}" is not pulled`);
274
- }
275
- } else {
276
- // OpenAI-compatible endpoint ping
277
- const testUrl = getOpenAiCompatibleUrl(cleanEndpoint, '/v1/models');
278
- const res = await fetch(testUrl, { signal: controller.signal });
279
- if (!res.ok) {
280
- throw new Error(`OpenAI-compatible server responded with status ${res.status}`);
281
- }
282
- console.log(` ${chalk.green('โœ”')} OpenAI-compatible server at "${endpoint}" is active`);
283
- }
284
- } catch (e: any) {
285
- const errorMsg = e.name === 'AbortError' ? 'Request timed out after 5 seconds' : e.message;
286
- throw new Error(errorMsg);
287
- } finally {
288
- clearTimeout(timeout);
289
- }
290
- } catch (e: any) {
291
- warnings.push(`Local LLM server at "${endpoint}" is offline or unreachable: ${e.message}`);
292
- console.log(` ${chalk.yellow('โš ')} Local LLM server is offline or unreachable (${e.message})`);
293
- }
294
- } else {
295
- console.log(` ${chalk.dim('Local AI agent is disabled in config.')}`);
296
- }
297
- console.log();
298
-
299
- // โ”€โ”€ Summary Report โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
300
- console.log(chalk.bold('๐Ÿ“Š Diagnostic Summary:'));
301
- if (errors.length === 0 && warnings.length === 0) {
302
- console.log(chalk.bold.green(' โœ” All checks passed! Workspace is healthy.\n'));
303
- } else {
304
- if (errors.length > 0) {
305
- console.log(chalk.bold.red(` โœ– ${errors.length} error(s) found. Fix them before proceeding.`));
306
- for (const err of errors) console.log(` - ${err}`);
307
- }
308
- if (warnings.length > 0) {
309
- console.log(chalk.bold.yellow(` โš  ${warnings.length} warning(s) found.`));
310
- for (const warn of warnings) console.log(` - ${warn}`);
311
- }
312
- console.log();
313
- }
314
- }
315
-
316
- /**
317
- * Resolves correct test command candidate.
318
- */
319
- function getTestCommand(analysis: any): string {
320
- if (analysis.techStack.languages.includes('csharp')) {
321
- return 'dotnet test';
322
- }
323
- if (analysis.techStack.languages.includes('typescript') || analysis.techStack.languages.includes('javascript')) {
324
- return 'npm test';
325
- }
326
- if (analysis.techStack.languages.includes('python')) {
327
- return 'pytest';
328
- }
329
- if (analysis.techStack.languages.includes('go')) {
330
- return 'go test ./...';
331
- }
332
- return 'npm test'; // fallback
333
- }
334
-
335
- /**
336
- * Resolves a workspace path.
337
- */
338
- async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
339
- if (workspaceArg) {
340
- const absolutePath = path.resolve(workspaceArg);
341
- try {
342
- await fs.access(path.join(absolutePath, 'nexusflow.json'));
343
- return absolutePath;
344
- } catch {
345
- console.error(chalk.red(`โœ– Invalid workspace: No nexusflow.json found at ${absolutePath}`));
346
- return null;
347
- }
348
- }
349
-
350
- const cwdFeature = await loadFeatureConfig(process.cwd());
351
- if (cwdFeature) return cwdFeature.workspacePath;
352
-
353
- const config = await loadConfig();
354
- const workspaces = await listWorkspaces(config.workspacesDir);
355
-
356
- if (workspaces.length === 0) {
357
- console.log(chalk.yellow('No workspaces found.\n'));
358
- return null;
359
- }
360
-
361
- const selected = await select({
362
- message: 'Select a workspace to diagnose:',
363
- choices: workspaces.map((ws) => ({
364
- name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
365
- value: ws.workspacePath,
366
- })),
367
- });
368
-
369
- return selected;
370
- }
@@ -1,266 +0,0 @@
1
- import chalk from 'chalk';
2
- import { select } from '@inquirer/prompts';
3
- import * as path from 'node:path';
4
- import * as fs from 'node:fs/promises';
5
- import { execa } from 'execa';
6
-
7
- import { loadConfig } from '../core/config.js';
8
- import { listWorkspaces, loadFeatureConfig } from '../core/workspace.js';
9
- import { getWorkspaceRepos, getRepoStatus } from '../utils/multi-git.js';
10
- import { analyzeAllRepos } from '../analyzers/index.js';
11
- import { buildDependencyGraph } from '../generators/plan-generator.js';
12
-
13
- /**
14
- * Runs the handoff command.
15
- * Auto-detects workspace from CWD or prompts user to select one.
16
- *
17
- * @param workspaceArg - Optional workspace path from CLI.
18
- */
19
- export async function handoffCommand(workspaceArg?: string): Promise<void> {
20
- console.log(chalk.bold.cyan('\n๐Ÿค NexusFlow โ€” Handoff Bundle\n'));
21
-
22
- const workspacePath = await resolveWorkspace(workspaceArg);
23
- if (!workspacePath) return;
24
-
25
- const feature = await loadFeatureConfig(workspacePath);
26
- if (!feature) {
27
- console.error(chalk.red('โœ– Failed to load workspace configuration. Ensure nexusflow.json exists.'));
28
- return;
29
- }
30
-
31
- const allRepos = await Promise.all(
32
- feature.repos.map(async (r) => {
33
- const repoName = path.basename(r);
34
- return {
35
- name: repoName,
36
- path: r,
37
- defaultBranch: 'main',
38
- };
39
- })
40
- );
41
-
42
- console.log(chalk.cyan('Retrieving repository statuses and running analysis...'));
43
- const analysis = await analyzeAllRepos(allRepos);
44
-
45
- const reposStatusInfo = await Promise.all(
46
- allRepos.map(async (repo) => {
47
- const status = await getRepoStatus(repo.path);
48
- const branch = await getRepoBranch(repo.path);
49
- const repoAnalysis = analysis.get(repo.path);
50
-
51
- const suggestedFiles = getSuggestedFiles(repo.path, status.changedFiles, repoAnalysis);
52
- const testCommand = getTestCommand(repo.path, repoAnalysis);
53
-
54
- return {
55
- name: repo.name,
56
- path: repo.path,
57
- branch,
58
- dirtySummary: status.summary,
59
- isDirty: status.hasChanges,
60
- changedFiles: status.changedFiles,
61
- suggestedFiles,
62
- testCommand,
63
- };
64
- })
65
- );
66
-
67
- // Parse knowledge from nexusflow-knowledge.md if it exists
68
- const knowledgePath = path.join(workspacePath, 'nexusflow-knowledge.md');
69
- let extractedGotchas = '_None recorded yet._';
70
- let extractedDecisions = '_None recorded yet._';
71
- let extractedQuestions = '_None recorded yet._';
72
-
73
- try {
74
- const knowledgeContent = await fs.readFile(knowledgePath, 'utf-8');
75
- extractedGotchas = extractSection(knowledgeContent, 'Known Gotchas');
76
- extractedDecisions = extractSection(knowledgeContent, 'Architecture Decisions');
77
- extractedQuestions = extractSection(knowledgeContent, 'Clarifying Questions for the User');
78
- } catch {}
79
-
80
- // Build dependency description
81
- let depGraphDescription = '';
82
- try {
83
- const graph = buildDependencyGraph(analysis, allRepos);
84
- const relations: string[] = [];
85
- for (const [name, node] of graph) {
86
- if (node.dependsOn.length > 0) {
87
- relations.push(`- **${name}** depends on: ${node.dependsOn.map(d => `\`${d}\``).join(', ')}`);
88
- }
89
- }
90
- depGraphDescription = relations.length > 0 ? relations.join('\n') : '_No inter-repo package dependencies detected._';
91
- } catch {
92
- depGraphDescription = '_Error generating dependency graph._';
93
- }
94
-
95
- const timestamp = new Date().toISOString();
96
-
97
- // Format handoff bundle
98
- const md: string[] = [];
99
- md.push(`# NexusFlow Handoff Bundle โ€” ${feature.branchName}`);
100
- md.push('');
101
- md.push(`> **Workspace Path:** \`${workspacePath}\``);
102
- md.push(`> **Current Branch:** \`${feature.branchName}\``);
103
- md.push(`> **Generated:** ${timestamp} (UTC)`);
104
- md.push('> **Instruction:** Read this handoff bundle first to resume context immediately.');
105
- md.push('');
106
- md.push('## ๐Ÿ“‹ Repository Statuses');
107
- md.push('');
108
- md.push('| Repository | Branch | Git Status | Suggested Files to Read |');
109
- md.push('|---|---|---|---|');
110
-
111
- for (const r of reposStatusInfo) {
112
- const filesList = r.suggestedFiles.map(f => `\`${f}\``).join(', ') || 'โ€”';
113
- const statusText = r.isDirty ? `โš ๏ธ ${r.dirtySummary}` : 'โœ… Clean';
114
- md.push(`| **${r.name}** | \`${r.branch}\` | ${statusText} | ${filesList} |`);
115
- }
116
- md.push('');
117
-
118
- md.push('## ๐Ÿงช Verification & Run Commands');
119
- md.push('');
120
- for (const r of reposStatusInfo) {
121
- md.push(`- **${r.name}**: \`${r.testCommand}\``);
122
- }
123
- md.push('');
124
-
125
- md.push('## ๐Ÿ—๏ธ Inter-Repo Package Graph');
126
- md.push('');
127
- md.push(depGraphDescription);
128
- md.push('');
129
-
130
- md.push('## ๐Ÿ“ Active Session Context (from nexusflow-knowledge.md)');
131
- md.push('');
132
- md.push('### Open Gotchas & Blockers');
133
- md.push(extractedGotchas);
134
- md.push('');
135
- md.push('### Recent Architecture Decisions');
136
- md.push(extractedDecisions);
137
- md.push('');
138
- md.push('### Outstanding Clarifying Questions');
139
- md.push(extractedQuestions);
140
- md.push('');
141
-
142
- const handoffFilePath = path.join(workspacePath, 'nexusflow-handoff.md');
143
- await fs.writeFile(handoffFilePath, md.join('\n'), 'utf-8');
144
-
145
- console.log(chalk.green(`\nโœ… Generated handoff bundle: ${chalk.bold('nexusflow-handoff.md')}`));
146
- console.log(chalk.dim(` Path: ${handoffFilePath}\n`));
147
- }
148
-
149
- /**
150
- * Gets the current branch name of a repository.
151
- */
152
- async function getRepoBranch(repoPath: string): Promise<string> {
153
- try {
154
- const { stdout } = await execa('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd: repoPath });
155
- return stdout.trim();
156
- } catch {
157
- return 'unknown';
158
- }
159
- }
160
-
161
- /**
162
- * Determines a candidate list of files to read first.
163
- */
164
- function getSuggestedFiles(repoPath: string, dirtyFiles: string[], analysis?: any): string[] {
165
- if (dirtyFiles.length > 0) {
166
- return dirtyFiles.slice(0, 3).map(f => f.replace(/\\/g, '/'));
167
- }
168
-
169
- const suggestions: string[] = [];
170
- if (analysis && analysis.runConfig && analysis.runConfig.entryPoints) {
171
- for (const ep of analysis.runConfig.entryPoints) {
172
- if (ep.projectPath && !suggestions.includes(ep.projectPath)) {
173
- suggestions.push(ep.projectPath);
174
- }
175
- }
176
- }
177
-
178
- suggestions.push('README.md');
179
- return suggestions.slice(0, 3);
180
- }
181
-
182
- /**
183
- * Resolves correct test command.
184
- */
185
- function getTestCommand(repoPath: string, analysis?: any): string {
186
- if (analysis) {
187
- if (analysis.techStack.languages.includes('csharp')) {
188
- return 'dotnet test';
189
- }
190
- if (analysis.techStack.languages.includes('typescript') || analysis.techStack.languages.includes('javascript')) {
191
- return 'npm test';
192
- }
193
- if (analysis.techStack.languages.includes('python')) {
194
- return 'pytest';
195
- }
196
- if (analysis.techStack.languages.includes('go')) {
197
- return 'go test ./...';
198
- }
199
- }
200
- return 'npm test'; // fallback
201
- }
202
-
203
- /**
204
- * Extracts a specific section from the knowledge file.
205
- */
206
- function extractSection(content: string, header: string): string {
207
- const lines = content.split('\n');
208
- const index = lines.findIndex(l => l.trim().startsWith(`## ${header}`));
209
- if (index === -1) return '_None recorded yet._';
210
-
211
- const resultLines: string[] = [];
212
- for (let i = index + 1; i < lines.length; i++) {
213
- if (lines[i]!.trim().startsWith('##')) break;
214
- resultLines.push(lines[i]!);
215
- }
216
-
217
- const sectionContent = resultLines.join('\n').trim();
218
- if (
219
- !sectionContent ||
220
- sectionContent.includes('No assumptions recorded yet') ||
221
- sectionContent.includes('No open questions recorded yet') ||
222
- sectionContent.includes('No decisions recorded yet') ||
223
- sectionContent.includes('No gotchas recorded yet') ||
224
- sectionContent.includes('AI assistant to populate')
225
- ) {
226
- return '_None recorded yet._';
227
- }
228
- return sectionContent;
229
- }
230
-
231
- /**
232
- * Resolves a workspace path.
233
- */
234
- async function resolveWorkspace(workspaceArg?: string): Promise<string | null> {
235
- if (workspaceArg) {
236
- const absolutePath = path.resolve(workspaceArg);
237
- try {
238
- await fs.access(path.join(absolutePath, 'nexusflow.json'));
239
- return absolutePath;
240
- } catch {
241
- console.error(chalk.red(`โœ– Invalid workspace: No nexusflow.json found at ${absolutePath}`));
242
- return null;
243
- }
244
- }
245
-
246
- const cwdFeature = await loadFeatureConfig(process.cwd());
247
- if (cwdFeature) return cwdFeature.workspacePath;
248
-
249
- const config = await loadConfig();
250
- const workspaces = await listWorkspaces(config.workspacesDir);
251
-
252
- if (workspaces.length === 0) {
253
- console.log(chalk.yellow('No workspaces found.\n'));
254
- return null;
255
- }
256
-
257
- const selected = await select({
258
- message: 'Select a workspace:',
259
- choices: workspaces.map((ws) => ({
260
- name: `${ws.branchName} ${chalk.dim(`(${ws.repos.length} repos)`)}`,
261
- value: ws.workspacePath,
262
- })),
263
- });
264
-
265
- return selected;
266
- }