@vibecheckai/cli 3.2.5 → 3.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 (197) hide show
  1. package/bin/.generated +25 -25
  2. package/bin/dev/run-v2-torture.js +30 -30
  3. package/bin/registry.js +192 -5
  4. package/bin/runners/lib/__tests__/entitlements-v2.test.js +295 -295
  5. package/bin/runners/lib/agent-firewall/change-packet/builder.js +280 -6
  6. package/bin/runners/lib/agent-firewall/critic/index.js +151 -0
  7. package/bin/runners/lib/agent-firewall/critic/judge.js +432 -0
  8. package/bin/runners/lib/agent-firewall/critic/prompts.js +305 -0
  9. package/bin/runners/lib/agent-firewall/lawbook/distributor.js +465 -0
  10. package/bin/runners/lib/agent-firewall/lawbook/evaluator.js +604 -0
  11. package/bin/runners/lib/agent-firewall/lawbook/index.js +304 -0
  12. package/bin/runners/lib/agent-firewall/lawbook/registry.js +514 -0
  13. package/bin/runners/lib/agent-firewall/lawbook/schema.js +420 -0
  14. package/bin/runners/lib/agent-firewall/logger.js +141 -0
  15. package/bin/runners/lib/agent-firewall/policy/loader.js +312 -4
  16. package/bin/runners/lib/agent-firewall/policy/rules/ghost-env.js +113 -1
  17. package/bin/runners/lib/agent-firewall/policy/rules/ghost-route.js +133 -6
  18. package/bin/runners/lib/agent-firewall/proposal/extractor.js +394 -0
  19. package/bin/runners/lib/agent-firewall/proposal/index.js +212 -0
  20. package/bin/runners/lib/agent-firewall/proposal/schema.js +251 -0
  21. package/bin/runners/lib/agent-firewall/proposal/validator.js +386 -0
  22. package/bin/runners/lib/agent-firewall/reality/index.js +332 -0
  23. package/bin/runners/lib/agent-firewall/reality/state.js +625 -0
  24. package/bin/runners/lib/agent-firewall/reality/watcher.js +322 -0
  25. package/bin/runners/lib/agent-firewall/risk/index.js +173 -0
  26. package/bin/runners/lib/agent-firewall/risk/scorer.js +328 -0
  27. package/bin/runners/lib/agent-firewall/risk/thresholds.js +321 -0
  28. package/bin/runners/lib/agent-firewall/risk/vectors.js +421 -0
  29. package/bin/runners/lib/agent-firewall/simulator/diff-simulator.js +472 -0
  30. package/bin/runners/lib/agent-firewall/simulator/import-resolver.js +346 -0
  31. package/bin/runners/lib/agent-firewall/simulator/index.js +181 -0
  32. package/bin/runners/lib/agent-firewall/simulator/route-validator.js +380 -0
  33. package/bin/runners/lib/agent-firewall/time-machine/incident-correlator.js +661 -0
  34. package/bin/runners/lib/agent-firewall/time-machine/index.js +267 -0
  35. package/bin/runners/lib/agent-firewall/time-machine/replay-engine.js +436 -0
  36. package/bin/runners/lib/agent-firewall/time-machine/state-reconstructor.js +490 -0
  37. package/bin/runners/lib/agent-firewall/time-machine/timeline-builder.js +530 -0
  38. package/bin/runners/lib/analyzers.js +81 -18
  39. package/bin/runners/lib/api-client.js +269 -0
  40. package/bin/runners/lib/auth-truth.js +193 -193
  41. package/bin/runners/lib/authority-badge.js +425 -0
  42. package/bin/runners/lib/backup.js +62 -62
  43. package/bin/runners/lib/billing.js +107 -107
  44. package/bin/runners/lib/claims.js +118 -118
  45. package/bin/runners/lib/cli-output.js +7 -1
  46. package/bin/runners/lib/cli-ui.js +540 -540
  47. package/bin/runners/lib/contracts/auth-contract.js +202 -202
  48. package/bin/runners/lib/contracts/env-contract.js +181 -181
  49. package/bin/runners/lib/contracts/external-contract.js +206 -206
  50. package/bin/runners/lib/contracts/guard.js +168 -168
  51. package/bin/runners/lib/contracts/index.js +89 -89
  52. package/bin/runners/lib/contracts/plan-validator.js +311 -311
  53. package/bin/runners/lib/contracts/route-contract.js +199 -199
  54. package/bin/runners/lib/contracts.js +804 -804
  55. package/bin/runners/lib/detect.js +89 -89
  56. package/bin/runners/lib/doctor/autofix.js +254 -254
  57. package/bin/runners/lib/doctor/index.js +37 -37
  58. package/bin/runners/lib/doctor/modules/dependencies.js +325 -325
  59. package/bin/runners/lib/doctor/modules/index.js +46 -46
  60. package/bin/runners/lib/doctor/modules/network.js +250 -250
  61. package/bin/runners/lib/doctor/modules/project.js +312 -312
  62. package/bin/runners/lib/doctor/modules/runtime.js +224 -224
  63. package/bin/runners/lib/doctor/modules/security.js +348 -348
  64. package/bin/runners/lib/doctor/modules/system.js +213 -213
  65. package/bin/runners/lib/doctor/modules/vibecheck.js +394 -394
  66. package/bin/runners/lib/doctor/reporter.js +262 -262
  67. package/bin/runners/lib/doctor/service.js +262 -262
  68. package/bin/runners/lib/doctor/types.js +113 -113
  69. package/bin/runners/lib/doctor/ui.js +263 -263
  70. package/bin/runners/lib/doctor-v2.js +608 -608
  71. package/bin/runners/lib/drift.js +425 -425
  72. package/bin/runners/lib/enforcement.js +72 -72
  73. package/bin/runners/lib/enterprise-detect.js +603 -603
  74. package/bin/runners/lib/enterprise-init.js +942 -942
  75. package/bin/runners/lib/env-resolver.js +417 -417
  76. package/bin/runners/lib/env-template.js +66 -66
  77. package/bin/runners/lib/env.js +189 -189
  78. package/bin/runners/lib/error-handler.js +16 -9
  79. package/bin/runners/lib/exit-codes.js +275 -0
  80. package/bin/runners/lib/extractors/client-calls.js +990 -990
  81. package/bin/runners/lib/extractors/fastify-route-dump.js +573 -573
  82. package/bin/runners/lib/extractors/fastify-routes.js +426 -426
  83. package/bin/runners/lib/extractors/index.js +363 -363
  84. package/bin/runners/lib/extractors/next-routes.js +524 -524
  85. package/bin/runners/lib/extractors/proof-graph.js +431 -431
  86. package/bin/runners/lib/extractors/route-matcher.js +451 -451
  87. package/bin/runners/lib/extractors/truthpack-v2.js +377 -377
  88. package/bin/runners/lib/extractors/ui-bindings.js +547 -547
  89. package/bin/runners/lib/findings-schema.js +281 -281
  90. package/bin/runners/lib/firewall-prompt.js +50 -50
  91. package/bin/runners/lib/global-flags.js +37 -0
  92. package/bin/runners/lib/graph/graph-builder.js +265 -265
  93. package/bin/runners/lib/graph/html-renderer.js +413 -413
  94. package/bin/runners/lib/graph/index.js +32 -32
  95. package/bin/runners/lib/graph/runtime-collector.js +215 -215
  96. package/bin/runners/lib/graph/static-extractor.js +518 -518
  97. package/bin/runners/lib/help-formatter.js +413 -0
  98. package/bin/runners/lib/html-report.js +650 -650
  99. package/bin/runners/lib/llm.js +75 -75
  100. package/bin/runners/lib/logger.js +38 -0
  101. package/bin/runners/lib/meter.js +61 -61
  102. package/bin/runners/lib/missions/evidence.js +126 -126
  103. package/bin/runners/lib/patch.js +40 -40
  104. package/bin/runners/lib/permissions/auth-model.js +213 -213
  105. package/bin/runners/lib/permissions/idor-prover.js +205 -205
  106. package/bin/runners/lib/permissions/index.js +45 -45
  107. package/bin/runners/lib/permissions/matrix-builder.js +198 -198
  108. package/bin/runners/lib/pkgjson.js +28 -28
  109. package/bin/runners/lib/policy.js +295 -295
  110. package/bin/runners/lib/preflight.js +142 -142
  111. package/bin/runners/lib/reality/correlation-detectors.js +359 -359
  112. package/bin/runners/lib/reality/index.js +318 -318
  113. package/bin/runners/lib/reality/request-hashing.js +416 -416
  114. package/bin/runners/lib/reality/request-mapper.js +453 -453
  115. package/bin/runners/lib/reality/safety-rails.js +463 -463
  116. package/bin/runners/lib/reality/semantic-snapshot.js +408 -408
  117. package/bin/runners/lib/reality/toast-detector.js +393 -393
  118. package/bin/runners/lib/reality-findings.js +84 -84
  119. package/bin/runners/lib/receipts.js +179 -179
  120. package/bin/runners/lib/redact.js +29 -29
  121. package/bin/runners/lib/replay/capsule-manager.js +154 -154
  122. package/bin/runners/lib/replay/index.js +263 -263
  123. package/bin/runners/lib/replay/player.js +348 -348
  124. package/bin/runners/lib/replay/recorder.js +331 -331
  125. package/bin/runners/lib/report.js +135 -135
  126. package/bin/runners/lib/route-detection.js +1140 -1140
  127. package/bin/runners/lib/sandbox/index.js +59 -59
  128. package/bin/runners/lib/sandbox/proof-chain.js +399 -399
  129. package/bin/runners/lib/sandbox/sandbox-runner.js +205 -205
  130. package/bin/runners/lib/sandbox/worktree.js +174 -174
  131. package/bin/runners/lib/schema-validator.js +350 -350
  132. package/bin/runners/lib/schemas/contracts.schema.json +160 -160
  133. package/bin/runners/lib/schemas/finding.schema.json +100 -100
  134. package/bin/runners/lib/schemas/mission-pack.schema.json +206 -206
  135. package/bin/runners/lib/schemas/proof-graph.schema.json +176 -176
  136. package/bin/runners/lib/schemas/reality-report.schema.json +162 -162
  137. package/bin/runners/lib/schemas/share-pack.schema.json +180 -180
  138. package/bin/runners/lib/schemas/ship-report.schema.json +117 -117
  139. package/bin/runners/lib/schemas/truthpack-v2.schema.json +303 -303
  140. package/bin/runners/lib/schemas/validator.js +438 -438
  141. package/bin/runners/lib/score-history.js +282 -282
  142. package/bin/runners/lib/share-pack.js +239 -239
  143. package/bin/runners/lib/snippets.js +67 -67
  144. package/bin/runners/lib/unified-cli-output.js +604 -0
  145. package/bin/runners/lib/upsell.js +658 -510
  146. package/bin/runners/lib/usage.js +153 -153
  147. package/bin/runners/lib/validate-patch.js +156 -156
  148. package/bin/runners/lib/verdict-engine.js +628 -628
  149. package/bin/runners/reality/engine.js +917 -917
  150. package/bin/runners/reality/flows.js +122 -122
  151. package/bin/runners/reality/report.js +378 -378
  152. package/bin/runners/reality/session.js +193 -193
  153. package/bin/runners/runAgent.d.ts +5 -0
  154. package/bin/runners/runApprove.js +1200 -0
  155. package/bin/runners/runAuth.js +324 -95
  156. package/bin/runners/runCheckpoint.js +39 -21
  157. package/bin/runners/runClassify.js +859 -0
  158. package/bin/runners/runContext.js +136 -24
  159. package/bin/runners/runDoctor.js +108 -68
  160. package/bin/runners/runFirewall.d.ts +5 -0
  161. package/bin/runners/runFirewallHook.d.ts +5 -0
  162. package/bin/runners/runFix.js +6 -5
  163. package/bin/runners/runGuard.js +262 -168
  164. package/bin/runners/runInit.js +3 -2
  165. package/bin/runners/runMcp.js +130 -52
  166. package/bin/runners/runPolish.js +43 -20
  167. package/bin/runners/runProve.js +1 -2
  168. package/bin/runners/runReport.js +3 -2
  169. package/bin/runners/runScan.js +145 -44
  170. package/bin/runners/runShip.js +3 -4
  171. package/bin/runners/runTruth.d.ts +5 -0
  172. package/bin/runners/runValidate.js +19 -2
  173. package/bin/runners/runWatch.js +104 -53
  174. package/bin/vibecheck.js +106 -19
  175. package/mcp-server/HARDENING_SUMMARY.md +299 -0
  176. package/mcp-server/agent-firewall-interceptor.js +367 -31
  177. package/mcp-server/authority-tools.js +569 -0
  178. package/mcp-server/conductor/conflict-resolver.js +588 -0
  179. package/mcp-server/conductor/execution-planner.js +544 -0
  180. package/mcp-server/conductor/index.js +377 -0
  181. package/mcp-server/conductor/lock-manager.js +615 -0
  182. package/mcp-server/conductor/request-queue.js +550 -0
  183. package/mcp-server/conductor/session-manager.js +500 -0
  184. package/mcp-server/conductor/tools.js +510 -0
  185. package/mcp-server/index.js +1199 -208
  186. package/mcp-server/lib/api-client.cjs +305 -0
  187. package/mcp-server/lib/logger.cjs +30 -0
  188. package/mcp-server/logger.js +173 -0
  189. package/mcp-server/package.json +2 -2
  190. package/mcp-server/premium-tools.js +2 -2
  191. package/mcp-server/tier-auth.js +351 -136
  192. package/mcp-server/tools/index.js +72 -72
  193. package/mcp-server/truth-firewall-tools.js +145 -15
  194. package/mcp-server/vibecheck-tools.js +2 -2
  195. package/package.json +2 -3
  196. package/mcp-server/index.old.js +0 -4137
  197. package/mcp-server/package-lock.json +0 -165
@@ -1,312 +1,312 @@
1
- /**
2
- * Project Diagnostics Module
3
- *
4
- * Checks project structure, configuration, and build capability
5
- */
6
-
7
- const fs = require('fs');
8
- const path = require('path');
9
- const { execSync } = require('child_process');
10
- const { SEVERITY, CATEGORY, FIX_TYPE } = require('../types');
11
-
12
- const MODULE_ID = 'project';
13
-
14
- function createDiagnostics(projectPath) {
15
- return [
16
- {
17
- id: `${MODULE_ID}.package_json`,
18
- name: 'package.json',
19
- category: CATEGORY.PROJECT,
20
- parallel: true,
21
- check: async () => {
22
- const pkgPath = path.join(projectPath, 'package.json');
23
-
24
- if (!fs.existsSync(pkgPath)) {
25
- return {
26
- severity: SEVERITY.ERROR,
27
- message: 'Not found',
28
- detail: 'This doesn\'t appear to be a Node.js project',
29
- fixes: [
30
- {
31
- type: FIX_TYPE.COMMAND,
32
- description: 'Initialize a new Node.js project',
33
- command: 'npm init -y',
34
- autoFixable: true,
35
- },
36
- ],
37
- };
38
- }
39
-
40
- try {
41
- const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
42
- const metadata = {
43
- name: pkg.name,
44
- version: pkg.version,
45
- hasScripts: !!pkg.scripts,
46
- hasDeps: !!(pkg.dependencies || pkg.devDependencies),
47
- };
48
-
49
- return {
50
- severity: SEVERITY.PASS,
51
- message: `${pkg.name || 'unnamed'}@${pkg.version || '0.0.0'}`,
52
- metadata,
53
- };
54
- } catch (err) {
55
- return {
56
- severity: SEVERITY.ERROR,
57
- message: 'Invalid JSON',
58
- detail: err.message,
59
- fixes: [{
60
- type: FIX_TYPE.MANUAL,
61
- description: 'Fix JSON syntax errors in package.json',
62
- autoFixable: false,
63
- }],
64
- };
65
- }
66
- },
67
- },
68
- {
69
- id: `${MODULE_ID}.node_modules`,
70
- name: 'Dependencies Installed',
71
- category: CATEGORY.PROJECT,
72
- parallel: true,
73
- dependsOn: [`${MODULE_ID}.package_json`],
74
- check: async () => {
75
- const nodeModulesPath = path.join(projectPath, 'node_modules');
76
-
77
- if (!fs.existsSync(nodeModulesPath)) {
78
- return {
79
- severity: SEVERITY.WARNING,
80
- message: 'node_modules not found',
81
- detail: 'Run your package manager install command',
82
- fixes: [
83
- {
84
- type: FIX_TYPE.COMMAND,
85
- description: 'Install dependencies with pnpm',
86
- command: 'pnpm install',
87
- autoFixable: true,
88
- },
89
- {
90
- type: FIX_TYPE.COMMAND,
91
- description: 'Install dependencies with npm',
92
- command: 'npm install',
93
- autoFixable: true,
94
- },
95
- ],
96
- };
97
- }
98
-
99
- try {
100
- const entries = fs.readdirSync(nodeModulesPath).filter(f => !f.startsWith('.'));
101
- const count = entries.length;
102
-
103
- // Check for common issues
104
- const lockFiles = ['pnpm-lock.yaml', 'package-lock.json', 'yarn.lock']
105
- .filter(f => fs.existsSync(path.join(projectPath, f)));
106
-
107
- const metadata = { packageCount: count, lockFiles };
108
-
109
- if (lockFiles.length > 1) {
110
- return {
111
- severity: SEVERITY.WARNING,
112
- message: `${count} packages (multiple lock files detected)`,
113
- detail: `Found: ${lockFiles.join(', ')}`,
114
- metadata,
115
- fixes: [{
116
- type: FIX_TYPE.MANUAL,
117
- description: 'Remove extra lock files to avoid conflicts',
118
- autoFixable: false,
119
- }],
120
- };
121
- }
122
-
123
- return {
124
- severity: SEVERITY.PASS,
125
- message: `${count} packages installed`,
126
- metadata,
127
- };
128
- } catch {
129
- return {
130
- severity: SEVERITY.WARNING,
131
- message: 'Cannot read node_modules',
132
- };
133
- }
134
- },
135
- },
136
- {
137
- id: `${MODULE_ID}.typescript`,
138
- name: 'TypeScript',
139
- category: CATEGORY.PROJECT,
140
- parallel: true,
141
- check: async () => {
142
- const tsConfigPath = path.join(projectPath, 'tsconfig.json');
143
-
144
- if (!fs.existsSync(tsConfigPath)) {
145
- return {
146
- severity: SEVERITY.INFO,
147
- message: 'Not configured (JavaScript project)',
148
- };
149
- }
150
-
151
- try {
152
- const tsConfig = JSON.parse(fs.readFileSync(tsConfigPath, 'utf8'));
153
- const strict = tsConfig.compilerOptions?.strict === true;
154
-
155
- const metadata = {
156
- strict,
157
- target: tsConfig.compilerOptions?.target,
158
- module: tsConfig.compilerOptions?.module,
159
- };
160
-
161
- if (!strict) {
162
- return {
163
- severity: SEVERITY.INFO,
164
- message: 'Configured (strict mode disabled)',
165
- metadata,
166
- };
167
- }
168
-
169
- return {
170
- severity: SEVERITY.PASS,
171
- message: 'Configured with strict mode',
172
- metadata,
173
- };
174
- } catch {
175
- return {
176
- severity: SEVERITY.WARNING,
177
- message: 'Invalid tsconfig.json',
178
- fixes: [{
179
- type: FIX_TYPE.COMMAND,
180
- description: 'Regenerate TypeScript config',
181
- command: 'npx tsc --init',
182
- autoFixable: false,
183
- }],
184
- };
185
- }
186
- },
187
- },
188
- {
189
- id: `${MODULE_ID}.source_structure`,
190
- name: 'Source Structure',
191
- category: CATEGORY.PROJECT,
192
- parallel: true,
193
- check: async () => {
194
- const structures = [
195
- { dir: 'src', type: 'standard' },
196
- { dir: 'app', type: 'next-app-router' },
197
- { dir: 'pages', type: 'next-pages-router' },
198
- { dir: 'lib', type: 'library' },
199
- { dir: 'packages', type: 'monorepo' },
200
- ];
201
-
202
- const found = structures.filter(s =>
203
- fs.existsSync(path.join(projectPath, s.dir))
204
- );
205
-
206
- if (found.length === 0) {
207
- return {
208
- severity: SEVERITY.INFO,
209
- message: 'No standard source directory detected',
210
- detail: 'Consider organizing code in src/, app/, or pages/',
211
- };
212
- }
213
-
214
- const metadata = { structures: found.map(f => f.type) };
215
- const primary = found[0];
216
-
217
- return {
218
- severity: SEVERITY.PASS,
219
- message: `${primary.dir}/ (${primary.type})`,
220
- metadata,
221
- };
222
- },
223
- },
224
- {
225
- id: `${MODULE_ID}.framework`,
226
- name: 'Framework Detection',
227
- category: CATEGORY.PROJECT,
228
- parallel: true,
229
- dependsOn: [`${MODULE_ID}.package_json`],
230
- check: async () => {
231
- const pkgPath = path.join(projectPath, 'package.json');
232
-
233
- try {
234
- const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
235
- const deps = { ...pkg.dependencies, ...pkg.devDependencies };
236
-
237
- const frameworks = [
238
- { name: 'Next.js', packages: ['next'] },
239
- { name: 'Remix', packages: ['@remix-run/node', '@remix-run/react'] },
240
- { name: 'Fastify', packages: ['fastify'] },
241
- { name: 'Express', packages: ['express'] },
242
- { name: 'Hono', packages: ['hono'] },
243
- { name: 'NestJS', packages: ['@nestjs/core'] },
244
- { name: 'React', packages: ['react'] },
245
- { name: 'Vue', packages: ['vue'] },
246
- { name: 'Svelte', packages: ['svelte'] },
247
- ];
248
-
249
- const detected = frameworks.filter(fw =>
250
- fw.packages.some(p => deps[p])
251
- );
252
-
253
- if (detected.length === 0) {
254
- return {
255
- severity: SEVERITY.INFO,
256
- message: 'No known framework detected',
257
- };
258
- }
259
-
260
- const metadata = { frameworks: detected.map(f => f.name) };
261
-
262
- return {
263
- severity: SEVERITY.PASS,
264
- message: detected.map(f => f.name).join(' + '),
265
- metadata,
266
- };
267
- } catch {
268
- return {
269
- severity: SEVERITY.INFO,
270
- message: 'Could not detect framework',
271
- };
272
- }
273
- },
274
- },
275
- {
276
- id: `${MODULE_ID}.build`,
277
- name: 'Build Script',
278
- category: CATEGORY.PROJECT,
279
- parallel: true,
280
- dependsOn: [`${MODULE_ID}.package_json`],
281
- check: async () => {
282
- const pkgPath = path.join(projectPath, 'package.json');
283
-
284
- try {
285
- const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
286
-
287
- if (!pkg.scripts?.build) {
288
- return {
289
- severity: SEVERITY.INFO,
290
- message: 'No build script defined',
291
- };
292
- }
293
-
294
- const metadata = { buildCommand: pkg.scripts.build };
295
-
296
- return {
297
- severity: SEVERITY.PASS,
298
- message: `Defined: ${pkg.scripts.build.substring(0, 40)}${pkg.scripts.build.length > 40 ? '...' : ''}`,
299
- metadata,
300
- };
301
- } catch {
302
- return {
303
- severity: SEVERITY.INFO,
304
- message: 'Could not check build script',
305
- };
306
- }
307
- },
308
- },
309
- ];
310
- }
311
-
312
- module.exports = { MODULE_ID, createDiagnostics };
1
+ /**
2
+ * Project Diagnostics Module
3
+ *
4
+ * Checks project structure, configuration, and build capability
5
+ */
6
+
7
+ const fs = require('fs');
8
+ const path = require('path');
9
+ const { execSync } = require('child_process');
10
+ const { SEVERITY, CATEGORY, FIX_TYPE } = require('../types');
11
+
12
+ const MODULE_ID = 'project';
13
+
14
+ function createDiagnostics(projectPath) {
15
+ return [
16
+ {
17
+ id: `${MODULE_ID}.package_json`,
18
+ name: 'package.json',
19
+ category: CATEGORY.PROJECT,
20
+ parallel: true,
21
+ check: async () => {
22
+ const pkgPath = path.join(projectPath, 'package.json');
23
+
24
+ if (!fs.existsSync(pkgPath)) {
25
+ return {
26
+ severity: SEVERITY.ERROR,
27
+ message: 'Not found',
28
+ detail: 'This doesn\'t appear to be a Node.js project',
29
+ fixes: [
30
+ {
31
+ type: FIX_TYPE.COMMAND,
32
+ description: 'Initialize a new Node.js project',
33
+ command: 'npm init -y',
34
+ autoFixable: true,
35
+ },
36
+ ],
37
+ };
38
+ }
39
+
40
+ try {
41
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
42
+ const metadata = {
43
+ name: pkg.name,
44
+ version: pkg.version,
45
+ hasScripts: !!pkg.scripts,
46
+ hasDeps: !!(pkg.dependencies || pkg.devDependencies),
47
+ };
48
+
49
+ return {
50
+ severity: SEVERITY.PASS,
51
+ message: `${pkg.name || 'unnamed'}@${pkg.version || '0.0.0'}`,
52
+ metadata,
53
+ };
54
+ } catch (err) {
55
+ return {
56
+ severity: SEVERITY.ERROR,
57
+ message: 'Invalid JSON',
58
+ detail: err.message,
59
+ fixes: [{
60
+ type: FIX_TYPE.MANUAL,
61
+ description: 'Fix JSON syntax errors in package.json',
62
+ autoFixable: false,
63
+ }],
64
+ };
65
+ }
66
+ },
67
+ },
68
+ {
69
+ id: `${MODULE_ID}.node_modules`,
70
+ name: 'Dependencies Installed',
71
+ category: CATEGORY.PROJECT,
72
+ parallel: true,
73
+ dependsOn: [`${MODULE_ID}.package_json`],
74
+ check: async () => {
75
+ const nodeModulesPath = path.join(projectPath, 'node_modules');
76
+
77
+ if (!fs.existsSync(nodeModulesPath)) {
78
+ return {
79
+ severity: SEVERITY.WARNING,
80
+ message: 'node_modules not found',
81
+ detail: 'Run your package manager install command',
82
+ fixes: [
83
+ {
84
+ type: FIX_TYPE.COMMAND,
85
+ description: 'Install dependencies with pnpm',
86
+ command: 'pnpm install',
87
+ autoFixable: true,
88
+ },
89
+ {
90
+ type: FIX_TYPE.COMMAND,
91
+ description: 'Install dependencies with npm',
92
+ command: 'npm install',
93
+ autoFixable: true,
94
+ },
95
+ ],
96
+ };
97
+ }
98
+
99
+ try {
100
+ const entries = fs.readdirSync(nodeModulesPath).filter(f => !f.startsWith('.'));
101
+ const count = entries.length;
102
+
103
+ // Check for common issues
104
+ const lockFiles = ['pnpm-lock.yaml', 'package-lock.json', 'yarn.lock']
105
+ .filter(f => fs.existsSync(path.join(projectPath, f)));
106
+
107
+ const metadata = { packageCount: count, lockFiles };
108
+
109
+ if (lockFiles.length > 1) {
110
+ return {
111
+ severity: SEVERITY.WARNING,
112
+ message: `${count} packages (multiple lock files detected)`,
113
+ detail: `Found: ${lockFiles.join(', ')}`,
114
+ metadata,
115
+ fixes: [{
116
+ type: FIX_TYPE.MANUAL,
117
+ description: 'Remove extra lock files to avoid conflicts',
118
+ autoFixable: false,
119
+ }],
120
+ };
121
+ }
122
+
123
+ return {
124
+ severity: SEVERITY.PASS,
125
+ message: `${count} packages installed`,
126
+ metadata,
127
+ };
128
+ } catch {
129
+ return {
130
+ severity: SEVERITY.WARNING,
131
+ message: 'Cannot read node_modules',
132
+ };
133
+ }
134
+ },
135
+ },
136
+ {
137
+ id: `${MODULE_ID}.typescript`,
138
+ name: 'TypeScript',
139
+ category: CATEGORY.PROJECT,
140
+ parallel: true,
141
+ check: async () => {
142
+ const tsConfigPath = path.join(projectPath, 'tsconfig.json');
143
+
144
+ if (!fs.existsSync(tsConfigPath)) {
145
+ return {
146
+ severity: SEVERITY.INFO,
147
+ message: 'Not configured (JavaScript project)',
148
+ };
149
+ }
150
+
151
+ try {
152
+ const tsConfig = JSON.parse(fs.readFileSync(tsConfigPath, 'utf8'));
153
+ const strict = tsConfig.compilerOptions?.strict === true;
154
+
155
+ const metadata = {
156
+ strict,
157
+ target: tsConfig.compilerOptions?.target,
158
+ module: tsConfig.compilerOptions?.module,
159
+ };
160
+
161
+ if (!strict) {
162
+ return {
163
+ severity: SEVERITY.INFO,
164
+ message: 'Configured (strict mode disabled)',
165
+ metadata,
166
+ };
167
+ }
168
+
169
+ return {
170
+ severity: SEVERITY.PASS,
171
+ message: 'Configured with strict mode',
172
+ metadata,
173
+ };
174
+ } catch {
175
+ return {
176
+ severity: SEVERITY.WARNING,
177
+ message: 'Invalid tsconfig.json',
178
+ fixes: [{
179
+ type: FIX_TYPE.COMMAND,
180
+ description: 'Regenerate TypeScript config',
181
+ command: 'npx tsc --init',
182
+ autoFixable: false,
183
+ }],
184
+ };
185
+ }
186
+ },
187
+ },
188
+ {
189
+ id: `${MODULE_ID}.source_structure`,
190
+ name: 'Source Structure',
191
+ category: CATEGORY.PROJECT,
192
+ parallel: true,
193
+ check: async () => {
194
+ const structures = [
195
+ { dir: 'src', type: 'standard' },
196
+ { dir: 'app', type: 'next-app-router' },
197
+ { dir: 'pages', type: 'next-pages-router' },
198
+ { dir: 'lib', type: 'library' },
199
+ { dir: 'packages', type: 'monorepo' },
200
+ ];
201
+
202
+ const found = structures.filter(s =>
203
+ fs.existsSync(path.join(projectPath, s.dir))
204
+ );
205
+
206
+ if (found.length === 0) {
207
+ return {
208
+ severity: SEVERITY.INFO,
209
+ message: 'No standard source directory detected',
210
+ detail: 'Consider organizing code in src/, app/, or pages/',
211
+ };
212
+ }
213
+
214
+ const metadata = { structures: found.map(f => f.type) };
215
+ const primary = found[0];
216
+
217
+ return {
218
+ severity: SEVERITY.PASS,
219
+ message: `${primary.dir}/ (${primary.type})`,
220
+ metadata,
221
+ };
222
+ },
223
+ },
224
+ {
225
+ id: `${MODULE_ID}.framework`,
226
+ name: 'Framework Detection',
227
+ category: CATEGORY.PROJECT,
228
+ parallel: true,
229
+ dependsOn: [`${MODULE_ID}.package_json`],
230
+ check: async () => {
231
+ const pkgPath = path.join(projectPath, 'package.json');
232
+
233
+ try {
234
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
235
+ const deps = { ...pkg.dependencies, ...pkg.devDependencies };
236
+
237
+ const frameworks = [
238
+ { name: 'Next.js', packages: ['next'] },
239
+ { name: 'Remix', packages: ['@remix-run/node', '@remix-run/react'] },
240
+ { name: 'Fastify', packages: ['fastify'] },
241
+ { name: 'Express', packages: ['express'] },
242
+ { name: 'Hono', packages: ['hono'] },
243
+ { name: 'NestJS', packages: ['@nestjs/core'] },
244
+ { name: 'React', packages: ['react'] },
245
+ { name: 'Vue', packages: ['vue'] },
246
+ { name: 'Svelte', packages: ['svelte'] },
247
+ ];
248
+
249
+ const detected = frameworks.filter(fw =>
250
+ fw.packages.some(p => deps[p])
251
+ );
252
+
253
+ if (detected.length === 0) {
254
+ return {
255
+ severity: SEVERITY.INFO,
256
+ message: 'No known framework detected',
257
+ };
258
+ }
259
+
260
+ const metadata = { frameworks: detected.map(f => f.name) };
261
+
262
+ return {
263
+ severity: SEVERITY.PASS,
264
+ message: detected.map(f => f.name).join(' + '),
265
+ metadata,
266
+ };
267
+ } catch {
268
+ return {
269
+ severity: SEVERITY.INFO,
270
+ message: 'Could not detect framework',
271
+ };
272
+ }
273
+ },
274
+ },
275
+ {
276
+ id: `${MODULE_ID}.build`,
277
+ name: 'Build Script',
278
+ category: CATEGORY.PROJECT,
279
+ parallel: true,
280
+ dependsOn: [`${MODULE_ID}.package_json`],
281
+ check: async () => {
282
+ const pkgPath = path.join(projectPath, 'package.json');
283
+
284
+ try {
285
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
286
+
287
+ if (!pkg.scripts?.build) {
288
+ return {
289
+ severity: SEVERITY.INFO,
290
+ message: 'No build script defined',
291
+ };
292
+ }
293
+
294
+ const metadata = { buildCommand: pkg.scripts.build };
295
+
296
+ return {
297
+ severity: SEVERITY.PASS,
298
+ message: `Defined: ${pkg.scripts.build.substring(0, 40)}${pkg.scripts.build.length > 40 ? '...' : ''}`,
299
+ metadata,
300
+ };
301
+ } catch {
302
+ return {
303
+ severity: SEVERITY.INFO,
304
+ message: 'Could not check build script',
305
+ };
306
+ }
307
+ },
308
+ },
309
+ ];
310
+ }
311
+
312
+ module.exports = { MODULE_ID, createDiagnostics };