@mrpatronz/nexusflow 0.2.18 โ†’ 1.3.0

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 (236) hide show
  1. package/README.md +27 -3
  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/commands.test.js +20 -6
  7. package/dist/commands/commands.test.js.map +1 -1
  8. package/dist/commands/commit.d.ts +2 -0
  9. package/dist/commands/commit.d.ts.map +1 -1
  10. package/dist/commands/commit.js +27 -5
  11. package/dist/commands/commit.js.map +1 -1
  12. package/dist/commands/diff.d.ts +9 -2
  13. package/dist/commands/diff.d.ts.map +1 -1
  14. package/dist/commands/diff.js +36 -12
  15. package/dist/commands/diff.js.map +1 -1
  16. package/dist/commands/doctor.js +2 -2
  17. package/dist/commands/doctor.js.map +1 -1
  18. package/dist/commands/handoff.js +2 -2
  19. package/dist/commands/handoff.js.map +1 -1
  20. package/dist/commands/refresh.d.ts +4 -2
  21. package/dist/commands/refresh.d.ts.map +1 -1
  22. package/dist/commands/refresh.js +20 -36
  23. package/dist/commands/refresh.js.map +1 -1
  24. package/dist/commands/schedule.d.ts +35 -0
  25. package/dist/commands/schedule.d.ts.map +1 -0
  26. package/dist/commands/schedule.js +151 -0
  27. package/dist/commands/schedule.js.map +1 -0
  28. package/dist/commands/sync.d.ts.map +1 -1
  29. package/dist/commands/sync.js +58 -50
  30. package/dist/commands/sync.js.map +1 -1
  31. package/dist/core/analysis-cache.d.ts +58 -0
  32. package/dist/core/analysis-cache.d.ts.map +1 -0
  33. package/dist/core/analysis-cache.js +116 -0
  34. package/dist/core/analysis-cache.js.map +1 -0
  35. package/dist/core/analysis-cache.test.d.ts +2 -0
  36. package/dist/core/analysis-cache.test.d.ts.map +1 -0
  37. package/dist/core/analysis-cache.test.js +108 -0
  38. package/dist/core/analysis-cache.test.js.map +1 -0
  39. package/dist/core/refresh.d.ts +41 -0
  40. package/dist/core/refresh.d.ts.map +1 -0
  41. package/dist/core/refresh.js +60 -0
  42. package/dist/core/refresh.js.map +1 -0
  43. package/dist/core/scheduler.d.ts +117 -0
  44. package/dist/core/scheduler.d.ts.map +1 -0
  45. package/dist/core/scheduler.js +247 -0
  46. package/dist/core/scheduler.js.map +1 -0
  47. package/dist/core/scheduler.test.d.ts +2 -0
  48. package/dist/core/scheduler.test.d.ts.map +1 -0
  49. package/dist/core/scheduler.test.js +111 -0
  50. package/dist/core/scheduler.test.js.map +1 -0
  51. package/dist/core/sync.d.ts +50 -0
  52. package/dist/core/sync.d.ts.map +1 -0
  53. package/dist/core/sync.js +92 -0
  54. package/dist/core/sync.js.map +1 -0
  55. package/dist/core/workspace-state.d.ts +51 -0
  56. package/dist/core/workspace-state.d.ts.map +1 -0
  57. package/dist/core/workspace-state.js +108 -0
  58. package/dist/core/workspace-state.js.map +1 -0
  59. package/dist/core/workspace-state.test.d.ts +2 -0
  60. package/dist/core/workspace-state.test.d.ts.map +1 -0
  61. package/dist/core/workspace-state.test.js +84 -0
  62. package/dist/core/workspace-state.test.js.map +1 -0
  63. package/dist/generators/index.d.ts +7 -1
  64. package/dist/generators/index.d.ts.map +1 -1
  65. package/dist/generators/index.js +14 -1
  66. package/dist/generators/index.js.map +1 -1
  67. package/dist/gui/assets/index-Bdbld6yY.css +1 -0
  68. package/dist/gui/assets/index-D8iJPvnk.js +26 -0
  69. package/dist/gui/index.html +2 -2
  70. package/dist/index.js +107 -4
  71. package/dist/index.js.map +1 -1
  72. package/dist/mcp/server.d.ts.map +1 -1
  73. package/dist/mcp/server.js +42 -0
  74. package/dist/mcp/server.js.map +1 -1
  75. package/dist/server.d.ts.map +1 -1
  76. package/dist/server.js +175 -13
  77. package/dist/server.js.map +1 -1
  78. package/dist/server.test.js +66 -0
  79. package/dist/server.test.js.map +1 -1
  80. package/dist/types.d.ts +31 -0
  81. package/dist/types.d.ts.map +1 -1
  82. package/dist/utils/multi-git.d.ts +54 -8
  83. package/dist/utils/multi-git.d.ts.map +1 -1
  84. package/dist/utils/multi-git.js +129 -21
  85. package/dist/utils/multi-git.js.map +1 -1
  86. package/dist/utils/multi-git.test.d.ts +2 -0
  87. package/dist/utils/multi-git.test.d.ts.map +1 -0
  88. package/dist/utils/multi-git.test.js +125 -0
  89. package/dist/utils/multi-git.test.js.map +1 -0
  90. package/package.json +13 -1
  91. package/.agents/skills/ccc/SKILL.md +0 -71
  92. package/.agents/skills/ccc/references/management.md +0 -110
  93. package/.agents/skills/ccc/references/settings.md +0 -126
  94. package/.github/dependabot.yml +0 -52
  95. package/.github/workflows/ci.yml +0 -44
  96. package/.github/workflows/dependabot-merge.yml +0 -53
  97. package/.github/workflows/release-desktop.yml +0 -67
  98. package/.github/workflows/release-npm.yml +0 -65
  99. package/.github/workflows/release-vscode.yml +0 -61
  100. package/.vscode/launch.json +0 -17
  101. package/.vscode/tasks.json +0 -17
  102. package/GETTING_STARTED.md +0 -114
  103. package/desktop/build-installer.js +0 -228
  104. package/desktop/build.js +0 -118
  105. package/desktop/installer/nexusflow.iss +0 -35
  106. package/desktop/neutralino.config.json +0 -39
  107. package/desktop/package-lock.json +0 -1060
  108. package/desktop/package.json +0 -14
  109. package/dist/gui/assets/index-CB-jWded.css +0 -1
  110. package/dist/gui/assets/index-DDXpZZu3.js +0 -25
  111. package/extension/media/icon.svg +0 -1
  112. package/extension/package-lock.json +0 -6044
  113. package/extension/package.json +0 -117
  114. package/extension/src/extension.ts +0 -653
  115. package/extension/tsconfig.json +0 -21
  116. package/gui/README.md +0 -73
  117. package/gui/e2e/wizard.spec.ts +0 -346
  118. package/gui/eslint.config.js +0 -26
  119. package/gui/index.html +0 -17
  120. package/gui/package-lock.json +0 -3079
  121. package/gui/package.json +0 -36
  122. package/gui/playwright.config.ts +0 -41
  123. package/gui/public/app_logo.png +0 -0
  124. package/gui/public/favicon.svg +0 -1
  125. package/gui/public/icons.svg +0 -24
  126. package/gui/src/App.css +0 -1
  127. package/gui/src/App.tsx +0 -3632
  128. package/gui/src/assets/hero.png +0 -0
  129. package/gui/src/assets/react.svg +0 -1
  130. package/gui/src/assets/vite.svg +0 -1
  131. package/gui/src/features/changes/ChangesViewer.tsx +0 -388
  132. package/gui/src/features/knowledge/KnowledgeBase.tsx +0 -84
  133. package/gui/src/features/onboarding/OnboardingWizard.tsx +0 -230
  134. package/gui/src/features/plan/ImplementationPlan.tsx +0 -32
  135. package/gui/src/features/services/ServiceConsole.tsx +0 -250
  136. package/gui/src/features/sessions/SessionHistory.tsx +0 -195
  137. package/gui/src/features/workspace/WorkspaceList.tsx +0 -666
  138. package/gui/src/index.css +0 -152
  139. package/gui/src/main.tsx +0 -94
  140. package/gui/src/types.ts +0 -62
  141. package/gui/tsconfig.app.json +0 -25
  142. package/gui/tsconfig.json +0 -7
  143. package/gui/tsconfig.node.json +0 -24
  144. package/gui/vite.config.ts +0 -12
  145. package/resources/workflows/plan-implement-review.md +0 -8
  146. package/resources/workflows/research-verify.md +0 -6
  147. package/resources/workflows/solo-developer.md +0 -3
  148. package/scripts/simulate-workspaces.ts +0 -55
  149. package/skills-lock.json +0 -11
  150. package/src/analyzers/detect-apis.ts +0 -290
  151. package/src/analyzers/detect-deps.ts +0 -315
  152. package/src/analyzers/detect-existing.ts +0 -74
  153. package/src/analyzers/detect-ports.ts +0 -110
  154. package/src/analyzers/index.ts +0 -97
  155. package/src/analyzers/messaging-analyzer.ts +0 -254
  156. package/src/analyzers/readme-summarizer.ts +0 -102
  157. package/src/analyzers/run-analyzer.ts +0 -269
  158. package/src/analyzers/tech-stack.ts +0 -283
  159. package/src/commands/adapter.ts +0 -348
  160. package/src/commands/add-repo.ts +0 -156
  161. package/src/commands/commands.test.ts +0 -156
  162. package/src/commands/commit.ts +0 -131
  163. package/src/commands/config.ts +0 -52
  164. package/src/commands/create.ts +0 -204
  165. package/src/commands/desktop.ts +0 -128
  166. package/src/commands/diff.ts +0 -125
  167. package/src/commands/doctor.ts +0 -370
  168. package/src/commands/handoff.ts +0 -266
  169. package/src/commands/init.ts +0 -134
  170. package/src/commands/list.ts +0 -46
  171. package/src/commands/logs.ts +0 -63
  172. package/src/commands/mcp.ts +0 -94
  173. package/src/commands/open.ts +0 -129
  174. package/src/commands/refresh.ts +0 -137
  175. package/src/commands/remove.ts +0 -98
  176. package/src/commands/start.ts +0 -117
  177. package/src/commands/status.ts +0 -54
  178. package/src/commands/stop.ts +0 -55
  179. package/src/commands/sync.ts +0 -147
  180. package/src/commands/tui.ts +0 -484
  181. package/src/commands/ui.ts +0 -111
  182. package/src/core/adapters/local-storage.ts +0 -66
  183. package/src/core/adapters/obsidian-storage.ts +0 -151
  184. package/src/core/adapters/registry.ts +0 -44
  185. package/src/core/adapters/storage.test.ts +0 -174
  186. package/src/core/adapters/vault-storage.ts +0 -86
  187. package/src/core/config.test.ts +0 -96
  188. package/src/core/config.ts +0 -140
  189. package/src/core/graph.ts +0 -344
  190. package/src/core/plugins/index.ts +0 -17
  191. package/src/core/plugins/loader.ts +0 -36
  192. package/src/core/ports/storage.ts +0 -71
  193. package/src/core/scanner.test.ts +0 -61
  194. package/src/core/scanner.ts +0 -91
  195. package/src/core/storage.ts +0 -37
  196. package/src/core/workspace.ts +0 -487
  197. package/src/core/worktree.ts +0 -120
  198. package/src/generators/antigravity.ts +0 -32
  199. package/src/generators/base.ts +0 -243
  200. package/src/generators/claude.ts +0 -34
  201. package/src/generators/codex.ts +0 -48
  202. package/src/generators/copilot.ts +0 -56
  203. package/src/generators/cursor.ts +0 -44
  204. package/src/generators/diff-context.ts +0 -75
  205. package/src/generators/index.ts +0 -322
  206. package/src/generators/map-generator.test.ts +0 -159
  207. package/src/generators/map-generator.ts +0 -539
  208. package/src/generators/plan-generator.ts +0 -483
  209. package/src/generators/skills-generator.ts +0 -259
  210. package/src/index.ts +0 -539
  211. package/src/mcp/server.ts +0 -294
  212. package/src/orchestration/detect.ts +0 -313
  213. package/src/orchestration/index.ts +0 -7
  214. package/src/orchestration/runner.ts +0 -283
  215. package/src/server.test.ts +0 -618
  216. package/src/server.ts +0 -1314
  217. package/src/types.ts +0 -415
  218. package/src/utils/detect-ai.test.ts +0 -44
  219. package/src/utils/detect-ai.ts +0 -84
  220. package/src/utils/detect-editors.test.ts +0 -48
  221. package/src/utils/detect-editors.ts +0 -57
  222. package/src/utils/git.test.ts +0 -74
  223. package/src/utils/git.ts +0 -117
  224. package/src/utils/local-ai.test.ts +0 -130
  225. package/src/utils/local-ai.ts +0 -116
  226. package/src/utils/multi-git.ts +0 -313
  227. package/src/utils/prompts.ts +0 -209
  228. package/src/utils/session-finder.ts +0 -483
  229. package/src/utils/system-scanner.test.ts +0 -89
  230. package/src/utils/system-scanner.ts +0 -96
  231. package/src/utils/update-check.ts +0 -286
  232. package/src/utils/workflow-advisor.ts +0 -118
  233. package/src/utils/workflows.test.ts +0 -114
  234. package/src/utils/workflows.ts +0 -178
  235. package/tsconfig.json +0 -19
  236. 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
- }