@vibecheckai/cli 3.4.0 → 3.5.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 (228) hide show
  1. package/bin/registry.js +154 -338
  2. package/bin/runners/context/generators/mcp.js +13 -15
  3. package/bin/runners/context/proof-context.js +1 -248
  4. package/bin/runners/lib/analysis-core.js +180 -198
  5. package/bin/runners/lib/analyzers.js +223 -1669
  6. package/bin/runners/lib/cli-output.js +210 -242
  7. package/bin/runners/lib/detectors-v2.js +785 -547
  8. package/bin/runners/lib/entitlements-v2.js +458 -96
  9. package/bin/runners/lib/error-handler.js +9 -16
  10. package/bin/runners/lib/global-flags.js +0 -37
  11. package/bin/runners/lib/route-truth.js +322 -1167
  12. package/bin/runners/lib/scan-output.js +469 -448
  13. package/bin/runners/lib/ship-output.js +27 -280
  14. package/bin/runners/lib/terminal-ui.js +733 -231
  15. package/bin/runners/lib/truth.js +321 -1004
  16. package/bin/runners/lib/unified-output.js +158 -162
  17. package/bin/runners/lib/upsell.js +204 -104
  18. package/bin/runners/runAllowlist.js +324 -0
  19. package/bin/runners/runAuth.js +95 -324
  20. package/bin/runners/runCheckpoint.js +21 -39
  21. package/bin/runners/runContext.js +24 -136
  22. package/bin/runners/runDoctor.js +67 -115
  23. package/bin/runners/runEvidencePack.js +219 -0
  24. package/bin/runners/runFix.js +5 -6
  25. package/bin/runners/runGuard.js +118 -212
  26. package/bin/runners/runInit.js +2 -14
  27. package/bin/runners/runInstall.js +281 -0
  28. package/bin/runners/runLabs.js +341 -0
  29. package/bin/runners/runMcp.js +52 -130
  30. package/bin/runners/runPolish.js +20 -43
  31. package/bin/runners/runProve.js +3 -13
  32. package/bin/runners/runReality.js +0 -14
  33. package/bin/runners/runReport.js +2 -3
  34. package/bin/runners/runScan.js +44 -511
  35. package/bin/runners/runShip.js +14 -28
  36. package/bin/runners/runValidate.js +2 -19
  37. package/bin/runners/runWatch.js +54 -118
  38. package/bin/vibecheck.js +41 -148
  39. package/mcp-server/ARCHITECTURE.md +339 -0
  40. package/mcp-server/__tests__/cache.test.ts +313 -0
  41. package/mcp-server/__tests__/executor.test.ts +239 -0
  42. package/mcp-server/__tests__/fixtures/exclusion-test/.cache/webpack/cache.pack +1 -0
  43. package/mcp-server/__tests__/fixtures/exclusion-test/.next/server/chunk.js +3 -0
  44. package/mcp-server/__tests__/fixtures/exclusion-test/.turbo/cache.json +3 -0
  45. package/mcp-server/__tests__/fixtures/exclusion-test/.venv/lib/env.py +3 -0
  46. package/mcp-server/__tests__/fixtures/exclusion-test/dist/bundle.js +3 -0
  47. package/mcp-server/__tests__/fixtures/exclusion-test/package.json +5 -0
  48. package/mcp-server/__tests__/fixtures/exclusion-test/src/app.ts +5 -0
  49. package/mcp-server/__tests__/fixtures/exclusion-test/venv/lib/config.py +4 -0
  50. package/mcp-server/__tests__/ids.test.ts +345 -0
  51. package/mcp-server/__tests__/integration/tools.test.ts +410 -0
  52. package/mcp-server/__tests__/registry.test.ts +365 -0
  53. package/mcp-server/__tests__/sandbox.test.ts +323 -0
  54. package/mcp-server/__tests__/schemas.test.ts +372 -0
  55. package/mcp-server/benchmarks/run-benchmarks.ts +304 -0
  56. package/mcp-server/examples/doctor.request.json +14 -0
  57. package/mcp-server/examples/doctor.response.json +53 -0
  58. package/mcp-server/examples/error.response.json +15 -0
  59. package/mcp-server/examples/scan.request.json +14 -0
  60. package/mcp-server/examples/scan.response.json +108 -0
  61. package/mcp-server/handlers/tool-handler.ts +671 -0
  62. package/mcp-server/index-v3.ts +293 -0
  63. package/mcp-server/index.js +1072 -1573
  64. package/mcp-server/index.old.js +4137 -0
  65. package/mcp-server/lib/cache.ts +341 -0
  66. package/mcp-server/lib/errors.ts +346 -0
  67. package/mcp-server/lib/executor.ts +792 -0
  68. package/mcp-server/lib/ids.ts +238 -0
  69. package/mcp-server/lib/logger.ts +368 -0
  70. package/mcp-server/lib/metrics.ts +365 -0
  71. package/mcp-server/lib/sandbox.ts +337 -0
  72. package/mcp-server/lib/validator.ts +229 -0
  73. package/mcp-server/package-lock.json +165 -0
  74. package/mcp-server/package.json +32 -7
  75. package/mcp-server/premium-tools.js +2 -2
  76. package/mcp-server/registry/tools.json +476 -0
  77. package/mcp-server/schemas/error-envelope.schema.json +125 -0
  78. package/mcp-server/schemas/finding.schema.json +167 -0
  79. package/mcp-server/schemas/report-artifact.schema.json +88 -0
  80. package/mcp-server/schemas/run-request.schema.json +75 -0
  81. package/mcp-server/schemas/verdict.schema.json +168 -0
  82. package/mcp-server/tier-auth.d.ts +71 -0
  83. package/mcp-server/tier-auth.js +371 -183
  84. package/mcp-server/truth-context.js +90 -131
  85. package/mcp-server/truth-firewall-tools.js +1000 -1611
  86. package/mcp-server/tsconfig.json +34 -0
  87. package/mcp-server/vibecheck-tools.js +2 -2
  88. package/mcp-server/vitest.config.ts +16 -0
  89. package/package.json +3 -4
  90. package/bin/runners/lib/agent-firewall/ai/false-positive-analyzer.js +0 -474
  91. package/bin/runners/lib/agent-firewall/change-packet/builder.js +0 -488
  92. package/bin/runners/lib/agent-firewall/change-packet/schema.json +0 -228
  93. package/bin/runners/lib/agent-firewall/change-packet/store.js +0 -200
  94. package/bin/runners/lib/agent-firewall/claims/claim-types.js +0 -21
  95. package/bin/runners/lib/agent-firewall/claims/extractor.js +0 -303
  96. package/bin/runners/lib/agent-firewall/claims/patterns.js +0 -24
  97. package/bin/runners/lib/agent-firewall/critic/index.js +0 -151
  98. package/bin/runners/lib/agent-firewall/critic/judge.js +0 -432
  99. package/bin/runners/lib/agent-firewall/critic/prompts.js +0 -305
  100. package/bin/runners/lib/agent-firewall/evidence/auth-evidence.js +0 -88
  101. package/bin/runners/lib/agent-firewall/evidence/contract-evidence.js +0 -75
  102. package/bin/runners/lib/agent-firewall/evidence/env-evidence.js +0 -127
  103. package/bin/runners/lib/agent-firewall/evidence/resolver.js +0 -102
  104. package/bin/runners/lib/agent-firewall/evidence/route-evidence.js +0 -213
  105. package/bin/runners/lib/agent-firewall/evidence/side-effect-evidence.js +0 -145
  106. package/bin/runners/lib/agent-firewall/fs-hook/daemon.js +0 -19
  107. package/bin/runners/lib/agent-firewall/fs-hook/installer.js +0 -87
  108. package/bin/runners/lib/agent-firewall/fs-hook/watcher.js +0 -184
  109. package/bin/runners/lib/agent-firewall/git-hook/pre-commit.js +0 -163
  110. package/bin/runners/lib/agent-firewall/ide-extension/cursor.js +0 -107
  111. package/bin/runners/lib/agent-firewall/ide-extension/vscode.js +0 -68
  112. package/bin/runners/lib/agent-firewall/ide-extension/windsurf.js +0 -66
  113. package/bin/runners/lib/agent-firewall/interceptor/base.js +0 -304
  114. package/bin/runners/lib/agent-firewall/interceptor/cursor.js +0 -35
  115. package/bin/runners/lib/agent-firewall/interceptor/vscode.js +0 -35
  116. package/bin/runners/lib/agent-firewall/interceptor/windsurf.js +0 -34
  117. package/bin/runners/lib/agent-firewall/lawbook/distributor.js +0 -465
  118. package/bin/runners/lib/agent-firewall/lawbook/evaluator.js +0 -604
  119. package/bin/runners/lib/agent-firewall/lawbook/index.js +0 -304
  120. package/bin/runners/lib/agent-firewall/lawbook/registry.js +0 -514
  121. package/bin/runners/lib/agent-firewall/lawbook/schema.js +0 -420
  122. package/bin/runners/lib/agent-firewall/logger.js +0 -141
  123. package/bin/runners/lib/agent-firewall/policy/default-policy.json +0 -90
  124. package/bin/runners/lib/agent-firewall/policy/engine.js +0 -103
  125. package/bin/runners/lib/agent-firewall/policy/loader.js +0 -451
  126. package/bin/runners/lib/agent-firewall/policy/rules/auth-drift.js +0 -50
  127. package/bin/runners/lib/agent-firewall/policy/rules/contract-drift.js +0 -50
  128. package/bin/runners/lib/agent-firewall/policy/rules/fake-success.js +0 -86
  129. package/bin/runners/lib/agent-firewall/policy/rules/ghost-env.js +0 -162
  130. package/bin/runners/lib/agent-firewall/policy/rules/ghost-route.js +0 -189
  131. package/bin/runners/lib/agent-firewall/policy/rules/scope.js +0 -93
  132. package/bin/runners/lib/agent-firewall/policy/rules/unsafe-side-effect.js +0 -57
  133. package/bin/runners/lib/agent-firewall/policy/schema.json +0 -183
  134. package/bin/runners/lib/agent-firewall/policy/verdict.js +0 -54
  135. package/bin/runners/lib/agent-firewall/proposal/extractor.js +0 -394
  136. package/bin/runners/lib/agent-firewall/proposal/index.js +0 -212
  137. package/bin/runners/lib/agent-firewall/proposal/schema.js +0 -251
  138. package/bin/runners/lib/agent-firewall/proposal/validator.js +0 -386
  139. package/bin/runners/lib/agent-firewall/reality/index.js +0 -332
  140. package/bin/runners/lib/agent-firewall/reality/state.js +0 -625
  141. package/bin/runners/lib/agent-firewall/reality/watcher.js +0 -322
  142. package/bin/runners/lib/agent-firewall/risk/index.js +0 -173
  143. package/bin/runners/lib/agent-firewall/risk/scorer.js +0 -328
  144. package/bin/runners/lib/agent-firewall/risk/thresholds.js +0 -321
  145. package/bin/runners/lib/agent-firewall/risk/vectors.js +0 -421
  146. package/bin/runners/lib/agent-firewall/simulator/diff-simulator.js +0 -472
  147. package/bin/runners/lib/agent-firewall/simulator/import-resolver.js +0 -346
  148. package/bin/runners/lib/agent-firewall/simulator/index.js +0 -181
  149. package/bin/runners/lib/agent-firewall/simulator/route-validator.js +0 -380
  150. package/bin/runners/lib/agent-firewall/time-machine/incident-correlator.js +0 -661
  151. package/bin/runners/lib/agent-firewall/time-machine/index.js +0 -267
  152. package/bin/runners/lib/agent-firewall/time-machine/replay-engine.js +0 -436
  153. package/bin/runners/lib/agent-firewall/time-machine/state-reconstructor.js +0 -490
  154. package/bin/runners/lib/agent-firewall/time-machine/timeline-builder.js +0 -530
  155. package/bin/runners/lib/agent-firewall/truthpack/index.js +0 -67
  156. package/bin/runners/lib/agent-firewall/truthpack/loader.js +0 -137
  157. package/bin/runners/lib/agent-firewall/unblock/planner.js +0 -337
  158. package/bin/runners/lib/agent-firewall/utils/ignore-checker.js +0 -118
  159. package/bin/runners/lib/api-client.js +0 -269
  160. package/bin/runners/lib/authority-badge.js +0 -425
  161. package/bin/runners/lib/engines/accessibility-engine.js +0 -190
  162. package/bin/runners/lib/engines/api-consistency-engine.js +0 -162
  163. package/bin/runners/lib/engines/ast-cache.js +0 -99
  164. package/bin/runners/lib/engines/code-quality-engine.js +0 -255
  165. package/bin/runners/lib/engines/console-logs-engine.js +0 -115
  166. package/bin/runners/lib/engines/cross-file-analysis-engine.js +0 -268
  167. package/bin/runners/lib/engines/dead-code-engine.js +0 -198
  168. package/bin/runners/lib/engines/deprecated-api-engine.js +0 -226
  169. package/bin/runners/lib/engines/empty-catch-engine.js +0 -150
  170. package/bin/runners/lib/engines/file-filter.js +0 -131
  171. package/bin/runners/lib/engines/hardcoded-secrets-engine.js +0 -251
  172. package/bin/runners/lib/engines/mock-data-engine.js +0 -272
  173. package/bin/runners/lib/engines/parallel-processor.js +0 -71
  174. package/bin/runners/lib/engines/performance-issues-engine.js +0 -265
  175. package/bin/runners/lib/engines/security-vulnerabilities-engine.js +0 -243
  176. package/bin/runners/lib/engines/todo-fixme-engine.js +0 -115
  177. package/bin/runners/lib/engines/type-aware-engine.js +0 -152
  178. package/bin/runners/lib/engines/unsafe-regex-engine.js +0 -225
  179. package/bin/runners/lib/engines/vibecheck-engines/README.md +0 -53
  180. package/bin/runners/lib/engines/vibecheck-engines/index.js +0 -15
  181. package/bin/runners/lib/engines/vibecheck-engines/lib/ast-cache.js +0 -164
  182. package/bin/runners/lib/engines/vibecheck-engines/lib/code-quality-engine.js +0 -291
  183. package/bin/runners/lib/engines/vibecheck-engines/lib/console-logs-engine.js +0 -83
  184. package/bin/runners/lib/engines/vibecheck-engines/lib/dead-code-engine.js +0 -198
  185. package/bin/runners/lib/engines/vibecheck-engines/lib/deprecated-api-engine.js +0 -275
  186. package/bin/runners/lib/engines/vibecheck-engines/lib/empty-catch-engine.js +0 -167
  187. package/bin/runners/lib/engines/vibecheck-engines/lib/file-filter.js +0 -217
  188. package/bin/runners/lib/engines/vibecheck-engines/lib/hardcoded-secrets-engine.js +0 -139
  189. package/bin/runners/lib/engines/vibecheck-engines/lib/mock-data-engine.js +0 -140
  190. package/bin/runners/lib/engines/vibecheck-engines/lib/parallel-processor.js +0 -164
  191. package/bin/runners/lib/engines/vibecheck-engines/lib/performance-issues-engine.js +0 -234
  192. package/bin/runners/lib/engines/vibecheck-engines/lib/type-aware-engine.js +0 -217
  193. package/bin/runners/lib/engines/vibecheck-engines/lib/unsafe-regex-engine.js +0 -78
  194. package/bin/runners/lib/engines/vibecheck-engines/package.json +0 -13
  195. package/bin/runners/lib/exit-codes.js +0 -275
  196. package/bin/runners/lib/fingerprint.js +0 -377
  197. package/bin/runners/lib/help-formatter.js +0 -413
  198. package/bin/runners/lib/logger.js +0 -38
  199. package/bin/runners/lib/ship-output-enterprise.js +0 -239
  200. package/bin/runners/lib/unified-cli-output.js +0 -604
  201. package/bin/runners/runAgent.d.ts +0 -5
  202. package/bin/runners/runAgent.js +0 -161
  203. package/bin/runners/runApprove.js +0 -1200
  204. package/bin/runners/runClassify.js +0 -859
  205. package/bin/runners/runContext.d.ts +0 -4
  206. package/bin/runners/runFirewall.d.ts +0 -5
  207. package/bin/runners/runFirewall.js +0 -134
  208. package/bin/runners/runFirewallHook.d.ts +0 -5
  209. package/bin/runners/runFirewallHook.js +0 -56
  210. package/bin/runners/runPolish.d.ts +0 -4
  211. package/bin/runners/runProof.zip +0 -0
  212. package/bin/runners/runTruth.d.ts +0 -5
  213. package/bin/runners/runTruth.js +0 -101
  214. package/mcp-server/HARDENING_SUMMARY.md +0 -299
  215. package/mcp-server/agent-firewall-interceptor.js +0 -500
  216. package/mcp-server/authority-tools.js +0 -569
  217. package/mcp-server/conductor/conflict-resolver.js +0 -588
  218. package/mcp-server/conductor/execution-planner.js +0 -544
  219. package/mcp-server/conductor/index.js +0 -377
  220. package/mcp-server/conductor/lock-manager.js +0 -615
  221. package/mcp-server/conductor/request-queue.js +0 -550
  222. package/mcp-server/conductor/session-manager.js +0 -500
  223. package/mcp-server/conductor/tools.js +0 -510
  224. package/mcp-server/lib/api-client.cjs +0 -13
  225. package/mcp-server/lib/logger.cjs +0 -30
  226. package/mcp-server/logger.js +0 -173
  227. package/mcp-server/tools-v3.js +0 -706
  228. package/mcp-server/vibecheck-mcp-server-3.2.0.tgz +0 -0
@@ -1,604 +0,0 @@
1
- /**
2
- * Unified CLI Output - Enterprise-Grade Terminal Experience
3
- *
4
- * ═══════════════════════════════════════════════════════════════════════════════
5
- * VIBECHECK DESIGN SYSTEM
6
- * ═══════════════════════════════════════════════════════════════════════════════
7
- *
8
- * This module provides consistent, professional output formatting for all CLI
9
- * commands. Use these functions to ensure a unified enterprise-grade experience.
10
- */
11
-
12
- "use strict";
13
-
14
- const { getApiKey } = require("./auth");
15
-
16
- // ═══════════════════════════════════════════════════════════════════════════════
17
- // CONSTANTS
18
- // ═══════════════════════════════════════════════════════════════════════════════
19
-
20
- const WIDTH = 72;
21
- const SUPPORTS_COLOR = process.stdout.isTTY && !process.env.NO_COLOR;
22
- const SUPPORTS_UNICODE = !process.env.NO_UNICODE && process.platform !== "win32" || process.env.WT_SESSION;
23
-
24
- // ═══════════════════════════════════════════════════════════════════════════════
25
- // ANSI CODES
26
- // ═══════════════════════════════════════════════════════════════════════════════
27
-
28
- const ESC = "\x1b";
29
- const ansi = SUPPORTS_COLOR ? {
30
- reset: `${ESC}[0m`,
31
- bold: `${ESC}[1m`,
32
- dim: `${ESC}[2m`,
33
- italic: `${ESC}[3m`,
34
- underline: `${ESC}[4m`,
35
- red: `${ESC}[31m`,
36
- green: `${ESC}[32m`,
37
- yellow: `${ESC}[33m`,
38
- blue: `${ESC}[34m`,
39
- magenta: `${ESC}[35m`,
40
- cyan: `${ESC}[36m`,
41
- white: `${ESC}[37m`,
42
- gray: `${ESC}[90m`,
43
- bgGreen: `${ESC}[42m`,
44
- bgRed: `${ESC}[41m`,
45
- bgYellow: `${ESC}[43m`,
46
- bgCyan: `${ESC}[46m`,
47
- bgMagenta: `${ESC}[45m`,
48
- } : Object.fromEntries([
49
- "reset", "bold", "dim", "italic", "underline",
50
- "red", "green", "yellow", "blue", "magenta", "cyan", "white", "gray",
51
- "bgGreen", "bgRed", "bgYellow", "bgCyan", "bgMagenta"
52
- ].map(k => [k, ""]));
53
-
54
- // ═══════════════════════════════════════════════════════════════════════════════
55
- // SYMBOLS
56
- // ═══════════════════════════════════════════════════════════════════════════════
57
-
58
- const sym = SUPPORTS_UNICODE ? {
59
- check: "✓",
60
- cross: "✗",
61
- warning: "⚠",
62
- info: "ℹ",
63
- arrow: "→",
64
- bullet: "•",
65
- star: "★",
66
- rocket: "🚀",
67
- shield: "🛡️",
68
- lock: "🔒",
69
- key: "🔑",
70
- gear: "⚙",
71
- search: "🔍",
72
- chart: "📊",
73
- file: "📄",
74
- folder: "📁",
75
- clock: "⏱",
76
- lightning: "⚡",
77
- sparkle: "✨",
78
- fire: "🔥",
79
- target: "🎯",
80
- trophy: "🏆",
81
- box: {
82
- tl: "╔", tr: "╗", bl: "╚", br: "╝", h: "═", v: "║",
83
- ltl: "┌", ltr: "┐", lbl: "└", lbr: "┘", lh: "─", lv: "│",
84
- lt: "┬", lb: "┴", lx: "┼", ltrT: "├", ltlT: "┤",
85
- },
86
- } : {
87
- check: "+",
88
- cross: "x",
89
- warning: "!",
90
- info: "i",
91
- arrow: "->",
92
- bullet: "*",
93
- star: "*",
94
- rocket: ">",
95
- shield: "[S]",
96
- lock: "[L]",
97
- key: "[K]",
98
- gear: "[G]",
99
- search: "[?]",
100
- chart: "[C]",
101
- file: "[F]",
102
- folder: "[D]",
103
- clock: "[T]",
104
- lightning: "[!]",
105
- sparkle: "*",
106
- fire: "(!)",
107
- target: "(>)",
108
- trophy: "[W]",
109
- box: {
110
- tl: "+", tr: "+", bl: "+", br: "+", h: "-", v: "|",
111
- ltl: "+", ltr: "+", lbl: "+", lbr: "+", lh: "-", lv: "|",
112
- lt: "+", lb: "+", lx: "+", ltrT: "+", ltlT: "+",
113
- },
114
- };
115
-
116
- // ═══════════════════════════════════════════════════════════════════════════════
117
- // TIER BADGES
118
- // ═══════════════════════════════════════════════════════════════════════════════
119
-
120
- const TIER = {
121
- free: { label: "FREE", color: ansi.green, bg: ansi.bgGreen },
122
- starter: { label: "STARTER", color: ansi.cyan, bg: ansi.bgCyan },
123
- pro: { label: "PRO", color: ansi.magenta, bg: ansi.bgMagenta },
124
- complete: { label: "COMPLETE", color: ansi.yellow, bg: ansi.bgYellow },
125
- };
126
-
127
- function getTierBadge(tier) {
128
- const t = TIER[tier] || TIER.free;
129
- return `${t.color}[${t.label}]${ansi.reset}`;
130
- }
131
-
132
- function getTierFromKey() {
133
- const { key } = getApiKey();
134
- if (!key) return "free";
135
- // Simplified tier detection - in real app would check entitlements
136
- return "starter";
137
- }
138
-
139
- // ═══════════════════════════════════════════════════════════════════════════════
140
- // UTILITY FUNCTIONS
141
- // ═══════════════════════════════════════════════════════════════════════════════
142
-
143
- function stripAnsi(str) {
144
- return str.replace(/\x1b\[\d+m/g, "").replace(/\x1b\[38;2;\d+;\d+;\d+m/g, "");
145
- }
146
-
147
- function padCenter(str, width = WIDTH) {
148
- const len = stripAnsi(str).length;
149
- const padding = Math.max(0, width - len);
150
- const left = Math.floor(padding / 2);
151
- return " ".repeat(left) + str + " ".repeat(padding - left);
152
- }
153
-
154
- function padRight(str, width) {
155
- const len = stripAnsi(str).length;
156
- return str + " ".repeat(Math.max(0, width - len));
157
- }
158
-
159
- function truncate(str, maxLen) {
160
- const clean = stripAnsi(str);
161
- if (clean.length <= maxLen) return str;
162
- return clean.slice(0, maxLen - 3) + "...";
163
- }
164
-
165
- function formatDuration(ms) {
166
- if (ms < 1000) return `${ms}ms`;
167
- if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
168
- return `${Math.floor(ms / 60000)}m ${Math.floor((ms % 60000) / 1000)}s`;
169
- }
170
-
171
- // ═══════════════════════════════════════════════════════════════════════════════
172
- // HEADER / BANNER
173
- // ═══════════════════════════════════════════════════════════════════════════════
174
-
175
- /**
176
- * Render a compact enterprise header for any command
177
- * @param {object} opts - Header options
178
- * @param {string} opts.command - Command name (e.g., "scan", "ship")
179
- * @param {string} opts.title - Title text
180
- * @param {string} opts.tier - Tier requirement (free, starter, pro)
181
- * @param {string} [opts.subtitle] - Optional subtitle
182
- */
183
- function renderHeader(opts) {
184
- const { command, title, tier = "free", subtitle } = opts;
185
- const tierBadge = getTierBadge(tier);
186
- const b = sym.box;
187
-
188
- const lines = [];
189
-
190
- // Top border
191
- lines.push(`${ansi.gray}${b.tl}${b.h.repeat(WIDTH - 2)}${b.tr}${ansi.reset}`);
192
-
193
- // Title line
194
- const titleStr = `${ansi.bold}${title}${ansi.reset} ${tierBadge}`;
195
- lines.push(`${ansi.gray}${b.v}${ansi.reset}${padCenter(titleStr, WIDTH - 2)}${ansi.gray}${b.v}${ansi.reset}`);
196
-
197
- // Subtitle if provided
198
- if (subtitle) {
199
- const subStr = `${ansi.dim}${subtitle}${ansi.reset}`;
200
- lines.push(`${ansi.gray}${b.v}${ansi.reset}${padCenter(subStr, WIDTH - 2)}${ansi.gray}${b.v}${ansi.reset}`);
201
- }
202
-
203
- // Bottom border
204
- lines.push(`${ansi.gray}${b.bl}${b.h.repeat(WIDTH - 2)}${b.br}${ansi.reset}`);
205
-
206
- console.log(lines.join("\n"));
207
- }
208
-
209
- /**
210
- * Render a minimal header (single line)
211
- */
212
- function renderMinimalHeader(command, tier = "free") {
213
- const tierBadge = getTierBadge(tier);
214
- console.log(`\n ${ansi.bold}vibecheck ${command}${ansi.reset} ${tierBadge}\n`);
215
- }
216
-
217
- // ═══════════════════════════════════════════════════════════════════════════════
218
- // SECTION DIVIDERS
219
- // ═══════════════════════════════════════════════════════════════════════════════
220
-
221
- function renderDivider(style = "single") {
222
- const char = style === "double" ? sym.box.h : sym.box.lh;
223
- console.log(` ${ansi.gray}${char.repeat(WIDTH - 4)}${ansi.reset}`);
224
- }
225
-
226
- function renderSectionHeader(title, icon = sym.bullet) {
227
- console.log(`\n ${ansi.cyan}${icon}${ansi.reset} ${ansi.bold}${title}${ansi.reset}`);
228
- console.log(` ${ansi.gray}${sym.box.lh.repeat(WIDTH - 4)}${ansi.reset}`);
229
- }
230
-
231
- // ═══════════════════════════════════════════════════════════════════════════════
232
- // STATUS INDICATORS
233
- // ═══════════════════════════════════════════════════════════════════════════════
234
-
235
- function renderSuccess(message) {
236
- console.log(` ${ansi.green}${sym.check}${ansi.reset} ${message}`);
237
- }
238
-
239
- function renderError(message) {
240
- console.log(` ${ansi.red}${sym.cross}${ansi.reset} ${message}`);
241
- }
242
-
243
- function renderWarning(message) {
244
- console.log(` ${ansi.yellow}${sym.warning}${ansi.reset} ${message}`);
245
- }
246
-
247
- function renderInfo(message) {
248
- console.log(` ${ansi.cyan}${sym.info}${ansi.reset} ${message}`);
249
- }
250
-
251
- function renderBullet(message, indent = 2) {
252
- console.log(`${" ".repeat(indent)}${ansi.gray}${sym.bullet}${ansi.reset} ${message}`);
253
- }
254
-
255
- function renderStep(number, message, status = "pending") {
256
- const statusIcon = status === "done" ? `${ansi.green}${sym.check}${ansi.reset}` :
257
- status === "error" ? `${ansi.red}${sym.cross}${ansi.reset}` :
258
- status === "running" ? `${ansi.cyan}${sym.gear}${ansi.reset}` :
259
- `${ansi.gray}${number}${ansi.reset}`;
260
- console.log(` ${statusIcon} ${message}`);
261
- }
262
-
263
- // ═══════════════════════════════════════════════════════════════════════════════
264
- // VERDICT / RESULT BOX
265
- // ═══════════════════════════════════════════════════════════════════════════════
266
-
267
- /**
268
- * Render a verdict box (SHIP/WARN/BLOCK)
269
- * @param {string} verdict - SHIP, WARN, or BLOCK
270
- * @param {object} [stats] - Optional statistics
271
- */
272
- function renderVerdict(verdict, stats = {}) {
273
- const b = sym.box;
274
- const v = String(verdict).toUpperCase();
275
-
276
- let bg, icon, label;
277
- switch (v) {
278
- case "SHIP":
279
- case "PASS":
280
- case "SUCCESS":
281
- bg = ansi.bgGreen;
282
- icon = sym.rocket;
283
- label = "SHIP";
284
- break;
285
- case "WARN":
286
- case "WARNING":
287
- bg = ansi.bgYellow;
288
- icon = sym.warning;
289
- label = "WARN";
290
- break;
291
- case "BLOCK":
292
- case "FAIL":
293
- case "ERROR":
294
- bg = ansi.bgRed;
295
- icon = sym.cross;
296
- label = "BLOCK";
297
- break;
298
- default:
299
- bg = ansi.bgCyan;
300
- icon = sym.info;
301
- label = v;
302
- }
303
-
304
- console.log();
305
- console.log(` ${ansi.gray}${b.tl}${b.h.repeat(WIDTH - 6)}${b.tr}${ansi.reset}`);
306
-
307
- // Verdict line
308
- const verdictStr = `${bg}${ansi.bold}${ansi.white} ${icon} ${label} ${ansi.reset}`;
309
- console.log(` ${ansi.gray}${b.v}${ansi.reset}${padCenter(verdictStr, WIDTH - 4)}${ansi.gray}${b.v}${ansi.reset}`);
310
-
311
- // Stats line if provided
312
- if (stats.findings !== undefined || stats.duration !== undefined) {
313
- const parts = [];
314
- if (stats.critical !== undefined) parts.push(`${ansi.red}${stats.critical} critical${ansi.reset}`);
315
- if (stats.warnings !== undefined) parts.push(`${ansi.yellow}${stats.warnings} warnings${ansi.reset}`);
316
- if (stats.findings !== undefined && stats.critical === undefined) parts.push(`${stats.findings} findings`);
317
- if (stats.duration !== undefined) parts.push(`${ansi.dim}${formatDuration(stats.duration)}${ansi.reset}`);
318
-
319
- const statsStr = parts.join(` ${ansi.gray}${sym.bullet}${ansi.reset} `);
320
- console.log(` ${ansi.gray}${b.v}${ansi.reset}${padCenter(statsStr, WIDTH - 4)}${ansi.gray}${b.v}${ansi.reset}`);
321
- }
322
-
323
- console.log(` ${ansi.gray}${b.bl}${b.h.repeat(WIDTH - 6)}${b.br}${ansi.reset}`);
324
- console.log();
325
- }
326
-
327
- // ═══════════════════════════════════════════════════════════════════════════════
328
- // FINDINGS TABLE
329
- // ═══════════════════════════════════════════════════════════════════════════════
330
-
331
- /**
332
- * Render a findings table
333
- * @param {Array} findings - Array of finding objects
334
- * @param {object} opts - Options
335
- * @param {number} [opts.limit=5] - Max findings to show
336
- */
337
- function renderFindingsTable(findings, opts = {}) {
338
- const { limit = 5 } = opts;
339
- const b = sym.box;
340
-
341
- if (!findings || findings.length === 0) {
342
- console.log(` ${ansi.green}${sym.check}${ansi.reset} ${ansi.dim}No issues found${ansi.reset}`);
343
- return;
344
- }
345
-
346
- const COL1 = 10; // Severity
347
- const COL2 = 18; // Category
348
- const COL3 = WIDTH - COL1 - COL2 - 12; // Message
349
-
350
- // Header
351
- console.log(` ${ansi.gray}${b.ltl}${b.lh.repeat(COL1)}${b.lt}${b.lh.repeat(COL2)}${b.lt}${b.lh.repeat(COL3)}${b.ltr}${ansi.reset}`);
352
- console.log(` ${ansi.gray}${b.lv}${ansi.reset}${ansi.bold}${padRight(" SEVERITY", COL1)}${ansi.reset}${ansi.gray}${b.lv}${ansi.reset}${ansi.bold}${padRight(" CATEGORY", COL2)}${ansi.reset}${ansi.gray}${b.lv}${ansi.reset}${ansi.bold}${padRight(" MESSAGE", COL3)}${ansi.reset}${ansi.gray}${b.lv}${ansi.reset}`);
353
- console.log(` ${ansi.gray}${b.ltrT}${b.lh.repeat(COL1)}${b.lx}${b.lh.repeat(COL2)}${b.lx}${b.lh.repeat(COL3)}${b.ltlT}${ansi.reset}`);
354
-
355
- // Rows
356
- const shown = findings.slice(0, limit);
357
- for (const f of shown) {
358
- const sev = f.severity?.toUpperCase() || "INFO";
359
- let sevStr;
360
- switch (sev) {
361
- case "BLOCK":
362
- case "CRITICAL":
363
- sevStr = `${ansi.red} ${sym.cross} BLOCK${ansi.reset}`;
364
- break;
365
- case "WARN":
366
- case "WARNING":
367
- case "HIGH":
368
- sevStr = `${ansi.yellow} ${sym.warning} WARN${ansi.reset}`;
369
- break;
370
- default:
371
- sevStr = `${ansi.gray} ${sym.info} INFO${ansi.reset}`;
372
- }
373
-
374
- const cat = truncate(f.category || f.type || "General", COL2 - 1);
375
- const msg = truncate(f.message || f.title || f.id || "", COL3 - 1);
376
-
377
- console.log(` ${ansi.gray}${b.lv}${ansi.reset}${padRight(sevStr, COL1 + 9)}${ansi.gray}${b.lv}${ansi.reset}${padRight(" " + cat, COL2)}${ansi.gray}${b.lv}${ansi.reset}${padRight(" " + msg, COL3)}${ansi.gray}${b.lv}${ansi.reset}`);
378
- }
379
-
380
- // Footer
381
- console.log(` ${ansi.gray}${b.lbl}${b.lh.repeat(COL1)}${b.lb}${b.lh.repeat(COL2)}${b.lb}${b.lh.repeat(COL3)}${b.lbr}${ansi.reset}`);
382
-
383
- // More indicator
384
- if (findings.length > limit) {
385
- console.log(` ${ansi.dim}... and ${findings.length - limit} more findings${ansi.reset}`);
386
- }
387
- }
388
-
389
- // ═══════════════════════════════════════════════════════════════════════════════
390
- // KEY-VALUE LIST
391
- // ═══════════════════════════════════════════════════════════════════════════════
392
-
393
- /**
394
- * Render a key-value list
395
- * @param {Array<{label: string, value: string}>} items
396
- */
397
- function renderKeyValue(items) {
398
- const maxLabel = Math.max(...items.map(i => stripAnsi(i.label).length));
399
-
400
- for (const item of items) {
401
- const label = padRight(item.label, maxLabel);
402
- console.log(` ${ansi.dim}${label}${ansi.reset} ${item.value}`);
403
- }
404
- }
405
-
406
- // ═══════════════════════════════════════════════════════════════════════════════
407
- // PROGRESS BAR
408
- // ═══════════════════════════════════════════════════════════════════════════════
409
-
410
- function renderProgressBar(percent, width = 20) {
411
- const filled = Math.round((percent / 100) * width);
412
- const empty = width - filled;
413
-
414
- let color = ansi.green;
415
- if (percent < 50) color = ansi.red;
416
- else if (percent < 80) color = ansi.yellow;
417
-
418
- return `${color}${"█".repeat(filled)}${ansi.gray}${"░".repeat(empty)}${ansi.reset}`;
419
- }
420
-
421
- function renderScore(score, label = "Score") {
422
- const bar = renderProgressBar(score);
423
- console.log(` ${ansi.dim}${label}:${ansi.reset} [${bar}] ${score}/100`);
424
- }
425
-
426
- // ═══════════════════════════════════════════════════════════════════════════════
427
- // FOOTER / NEXT STEPS
428
- // ═══════════════════════════════════════════════════════════════════════════════
429
-
430
- /**
431
- * Render footer with next steps and optional upsell
432
- * @param {object} opts
433
- * @param {Array<{cmd: string, desc: string}>} [opts.nextSteps]
434
- * @param {string} [opts.docsUrl]
435
- * @param {boolean} [opts.showUpsell]
436
- */
437
- function renderFooter(opts = {}) {
438
- const { nextSteps = [], docsUrl, showUpsell = true } = opts;
439
- const currentTier = getTierFromKey();
440
-
441
- console.log();
442
- renderDivider();
443
-
444
- // Next steps
445
- if (nextSteps.length > 0) {
446
- console.log(`\n ${ansi.bold}${sym.arrow} Next steps${ansi.reset}`);
447
- for (const step of nextSteps) {
448
- console.log(` ${ansi.cyan}${step.cmd}${ansi.reset} ${ansi.dim}${step.desc}${ansi.reset}`);
449
- }
450
- }
451
-
452
- // Upsell for free tier
453
- if (showUpsell && currentTier === "free") {
454
- console.log();
455
- console.log(` ${ansi.dim}${sym.star}${ansi.reset} ${ansi.cyan}STARTER${ansi.reset}${ansi.dim}: dashboard sync + auto-fix + team features${ansi.reset}`);
456
- console.log(` ${ansi.dim} Upgrade ${sym.arrow} https://vibecheckai.dev${ansi.reset}`);
457
- }
458
-
459
- // Docs link
460
- if (docsUrl) {
461
- console.log();
462
- console.log(` ${ansi.dim}Docs: ${docsUrl}${ansi.reset}`);
463
- }
464
-
465
- console.log();
466
- }
467
-
468
- // ═══════════════════════════════════════════════════════════════════════════════
469
- // SPINNER
470
- // ═══════════════════════════════════════════════════════════════════════════════
471
-
472
- const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
473
-
474
- class Spinner {
475
- constructor(text = "") {
476
- this.text = text;
477
- this.timer = null;
478
- this.frame = 0;
479
- }
480
-
481
- start(text) {
482
- if (text) this.text = text;
483
- if (!process.stdout.isTTY) {
484
- console.log(` ${ansi.cyan}${sym.gear}${ansi.reset} ${this.text}...`);
485
- return this;
486
- }
487
-
488
- process.stdout.write("\x1b[?25l"); // Hide cursor
489
- this.timer = setInterval(() => {
490
- const f = SPINNER_FRAMES[this.frame % SPINNER_FRAMES.length];
491
- process.stdout.write(`\r ${ansi.cyan}${f}${ansi.reset} ${this.text}`);
492
- this.frame++;
493
- }, 80);
494
- return this;
495
- }
496
-
497
- stop(finalIcon, finalColor, finalText) {
498
- if (this.timer) {
499
- clearInterval(this.timer);
500
- this.timer = null;
501
- }
502
-
503
- if (process.stdout.isTTY) {
504
- process.stdout.write("\r\x1b[2K"); // Clear line
505
- process.stdout.write("\x1b[?25h"); // Show cursor
506
- }
507
-
508
- if (finalText !== null) {
509
- const icon = finalIcon || sym.check;
510
- const color = finalColor || ansi.green;
511
- console.log(` ${color}${icon}${ansi.reset} ${finalText || this.text}`);
512
- }
513
- return this;
514
- }
515
-
516
- succeed(text) { return this.stop(sym.check, ansi.green, text); }
517
- fail(text) { return this.stop(sym.cross, ansi.red, text); }
518
- warn(text) { return this.stop(sym.warning, ansi.yellow, text); }
519
- info(text) { return this.stop(sym.info, ansi.cyan, text); }
520
- }
521
-
522
- // ═══════════════════════════════════════════════════════════════════════════════
523
- // COMMAND TEMPLATES
524
- // ═══════════════════════════════════════════════════════════════════════════════
525
-
526
- /**
527
- * Standard command wrapper for consistent output
528
- * @param {object} opts
529
- * @param {string} opts.command - Command name
530
- * @param {string} opts.title - Title for header
531
- * @param {string} [opts.tier] - Required tier
532
- * @param {boolean} [opts.quiet] - Suppress non-essential output
533
- * @param {boolean} [opts.json] - JSON output mode
534
- * @param {Function} opts.run - The command's main logic
535
- */
536
- async function runCommand(opts) {
537
- const { command, title, tier = "free", quiet = false, json = false, run } = opts;
538
-
539
- if (json) {
540
- // JSON mode - run silently, output only JSON
541
- return await run();
542
- }
543
-
544
- if (!quiet) {
545
- renderMinimalHeader(command, tier);
546
- }
547
-
548
- const result = await run();
549
-
550
- return result;
551
- }
552
-
553
- // ═══════════════════════════════════════════════════════════════════════════════
554
- // EXPORTS
555
- // ═══════════════════════════════════════════════════════════════════════════════
556
-
557
- module.exports = {
558
- // Constants
559
- WIDTH,
560
- ansi,
561
- sym,
562
- TIER,
563
-
564
- // Utilities
565
- stripAnsi,
566
- padCenter,
567
- padRight,
568
- truncate,
569
- formatDuration,
570
- getTierBadge,
571
- getTierFromKey,
572
-
573
- // Headers
574
- renderHeader,
575
- renderMinimalHeader,
576
-
577
- // Dividers
578
- renderDivider,
579
- renderSectionHeader,
580
-
581
- // Status
582
- renderSuccess,
583
- renderError,
584
- renderWarning,
585
- renderInfo,
586
- renderBullet,
587
- renderStep,
588
-
589
- // Results
590
- renderVerdict,
591
- renderFindingsTable,
592
- renderKeyValue,
593
- renderProgressBar,
594
- renderScore,
595
-
596
- // Footer
597
- renderFooter,
598
-
599
- // Components
600
- Spinner,
601
-
602
- // Templates
603
- runCommand,
604
- };
@@ -1,5 +0,0 @@
1
- export interface AgentOptions {
2
- action?: 'install' | 'status' | 'lock' | 'unlock';
3
- projectRoot?: string;
4
- }
5
- export function runAgent(options?: AgentOptions): Promise<void>;