@vibecheckai/cli 3.0.10 → 3.1.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 (162) hide show
  1. package/bin/.generated +25 -0
  2. package/bin/dev/run-v2-torture.js +30 -30
  3. package/bin/registry.js +105 -0
  4. package/bin/runners/lib/__tests__/entitlements-v2.test.js +295 -295
  5. package/bin/runners/lib/analysis-core.js +271 -271
  6. package/bin/runners/lib/analyzers.js +579 -579
  7. package/bin/runners/lib/auth-truth.js +193 -193
  8. package/bin/runners/lib/backup.js +62 -62
  9. package/bin/runners/lib/billing.js +107 -107
  10. package/bin/runners/lib/claims.js +118 -118
  11. package/bin/runners/lib/cli-output.js +368 -0
  12. package/bin/runners/lib/cli-ui.js +540 -540
  13. package/bin/runners/lib/contracts/auth-contract.js +202 -202
  14. package/bin/runners/lib/contracts/env-contract.js +181 -181
  15. package/bin/runners/lib/contracts/external-contract.js +206 -206
  16. package/bin/runners/lib/contracts/guard.js +168 -168
  17. package/bin/runners/lib/contracts/index.js +89 -89
  18. package/bin/runners/lib/contracts/plan-validator.js +311 -311
  19. package/bin/runners/lib/contracts/route-contract.js +199 -199
  20. package/bin/runners/lib/contracts.js +804 -804
  21. package/bin/runners/lib/detect.js +89 -89
  22. package/bin/runners/lib/detectors-v2.js +703 -703
  23. package/bin/runners/lib/doctor/autofix.js +254 -254
  24. package/bin/runners/lib/doctor/index.js +37 -37
  25. package/bin/runners/lib/doctor/modules/dependencies.js +325 -325
  26. package/bin/runners/lib/doctor/modules/index.js +46 -46
  27. package/bin/runners/lib/doctor/modules/network.js +250 -250
  28. package/bin/runners/lib/doctor/modules/project.js +312 -312
  29. package/bin/runners/lib/doctor/modules/runtime.js +224 -224
  30. package/bin/runners/lib/doctor/modules/security.js +348 -348
  31. package/bin/runners/lib/doctor/modules/system.js +213 -213
  32. package/bin/runners/lib/doctor/modules/vibecheck.js +394 -394
  33. package/bin/runners/lib/doctor/reporter.js +262 -262
  34. package/bin/runners/lib/doctor/service.js +262 -262
  35. package/bin/runners/lib/doctor/types.js +113 -113
  36. package/bin/runners/lib/doctor/ui.js +263 -263
  37. package/bin/runners/lib/doctor-v2.js +608 -608
  38. package/bin/runners/lib/drift.js +425 -425
  39. package/bin/runners/lib/enforcement.js +72 -72
  40. package/bin/runners/lib/enterprise-detect.js +603 -603
  41. package/bin/runners/lib/enterprise-init.js +942 -942
  42. package/bin/runners/lib/entitlements-v2.js +490 -493
  43. package/bin/runners/lib/env-resolver.js +417 -417
  44. package/bin/runners/lib/env-template.js +66 -66
  45. package/bin/runners/lib/env.js +189 -189
  46. package/bin/runners/lib/extractors/client-calls.js +990 -990
  47. package/bin/runners/lib/extractors/fastify-route-dump.js +573 -573
  48. package/bin/runners/lib/extractors/fastify-routes.js +426 -426
  49. package/bin/runners/lib/extractors/index.js +363 -363
  50. package/bin/runners/lib/extractors/next-routes.js +524 -524
  51. package/bin/runners/lib/extractors/proof-graph.js +431 -431
  52. package/bin/runners/lib/extractors/route-matcher.js +451 -451
  53. package/bin/runners/lib/extractors/truthpack-v2.js +377 -377
  54. package/bin/runners/lib/extractors/ui-bindings.js +547 -547
  55. package/bin/runners/lib/findings-schema.js +281 -281
  56. package/bin/runners/lib/firewall-prompt.js +50 -50
  57. package/bin/runners/lib/graph/graph-builder.js +265 -265
  58. package/bin/runners/lib/graph/html-renderer.js +413 -413
  59. package/bin/runners/lib/graph/index.js +32 -32
  60. package/bin/runners/lib/graph/runtime-collector.js +215 -215
  61. package/bin/runners/lib/graph/static-extractor.js +518 -518
  62. package/bin/runners/lib/html-report.js +650 -650
  63. package/bin/runners/lib/init-wizard.js +308 -308
  64. package/bin/runners/lib/llm.js +75 -75
  65. package/bin/runners/lib/meter.js +61 -61
  66. package/bin/runners/lib/missions/evidence.js +126 -126
  67. package/bin/runners/lib/missions/plan.js +69 -69
  68. package/bin/runners/lib/missions/templates.js +192 -192
  69. package/bin/runners/lib/patch.js +40 -40
  70. package/bin/runners/lib/permissions/auth-model.js +213 -213
  71. package/bin/runners/lib/permissions/idor-prover.js +205 -205
  72. package/bin/runners/lib/permissions/index.js +45 -45
  73. package/bin/runners/lib/permissions/matrix-builder.js +198 -198
  74. package/bin/runners/lib/pkgjson.js +28 -28
  75. package/bin/runners/lib/policy.js +295 -295
  76. package/bin/runners/lib/preflight.js +142 -142
  77. package/bin/runners/lib/reality/correlation-detectors.js +359 -359
  78. package/bin/runners/lib/reality/index.js +318 -318
  79. package/bin/runners/lib/reality/request-hashing.js +416 -416
  80. package/bin/runners/lib/reality/request-mapper.js +453 -453
  81. package/bin/runners/lib/reality/safety-rails.js +463 -463
  82. package/bin/runners/lib/reality/semantic-snapshot.js +408 -408
  83. package/bin/runners/lib/reality/toast-detector.js +393 -393
  84. package/bin/runners/lib/reality-findings.js +84 -84
  85. package/bin/runners/lib/receipts.js +179 -0
  86. package/bin/runners/lib/redact.js +29 -29
  87. package/bin/runners/lib/replay/capsule-manager.js +154 -154
  88. package/bin/runners/lib/replay/index.js +263 -263
  89. package/bin/runners/lib/replay/player.js +348 -348
  90. package/bin/runners/lib/replay/recorder.js +331 -331
  91. package/bin/runners/lib/report-engine.js +447 -447
  92. package/bin/runners/lib/report-html.js +1499 -1499
  93. package/bin/runners/lib/report-templates.js +969 -969
  94. package/bin/runners/lib/report.js +135 -135
  95. package/bin/runners/lib/route-detection.js +1140 -1140
  96. package/bin/runners/lib/route-truth.js +477 -477
  97. package/bin/runners/lib/sandbox/index.js +59 -59
  98. package/bin/runners/lib/sandbox/proof-chain.js +399 -399
  99. package/bin/runners/lib/sandbox/sandbox-runner.js +205 -205
  100. package/bin/runners/lib/sandbox/worktree.js +174 -174
  101. package/bin/runners/lib/schema-validator.js +350 -350
  102. package/bin/runners/lib/schemas/contracts.schema.json +160 -160
  103. package/bin/runners/lib/schemas/finding.schema.json +100 -100
  104. package/bin/runners/lib/schemas/mission-pack.schema.json +206 -206
  105. package/bin/runners/lib/schemas/proof-graph.schema.json +176 -176
  106. package/bin/runners/lib/schemas/reality-report.schema.json +162 -162
  107. package/bin/runners/lib/schemas/share-pack.schema.json +180 -180
  108. package/bin/runners/lib/schemas/ship-report.schema.json +117 -117
  109. package/bin/runners/lib/schemas/truthpack-v2.schema.json +303 -303
  110. package/bin/runners/lib/schemas/validator.js +438 -438
  111. package/bin/runners/lib/score-history.js +282 -282
  112. package/bin/runners/lib/share-pack.js +239 -239
  113. package/bin/runners/lib/snippets.js +67 -67
  114. package/bin/runners/lib/truth.js +667 -667
  115. package/bin/runners/lib/upsell.js +510 -0
  116. package/bin/runners/lib/usage.js +153 -0
  117. package/bin/runners/lib/validate-patch.js +156 -156
  118. package/bin/runners/lib/verdict-engine.js +628 -628
  119. package/bin/runners/reality/engine.js +917 -917
  120. package/bin/runners/reality/flows.js +122 -122
  121. package/bin/runners/reality/report.js +378 -378
  122. package/bin/runners/reality/session.js +193 -193
  123. package/bin/runners/runAuth.js +51 -0
  124. package/bin/runners/runBadge.js +31 -4
  125. package/bin/runners/runClaimVerifier.js +483 -483
  126. package/bin/runners/runContext.js +56 -56
  127. package/bin/runners/runContextCompiler.js +385 -385
  128. package/bin/runners/runCtx.js +674 -674
  129. package/bin/runners/runCtxDiff.js +301 -301
  130. package/bin/runners/runCtxGuard.js +176 -176
  131. package/bin/runners/runCtxSync.js +116 -116
  132. package/bin/runners/runDoctor.js +72 -3
  133. package/bin/runners/runFix.js +13 -0
  134. package/bin/runners/runGate.js +17 -17
  135. package/bin/runners/runGraph.js +454 -440
  136. package/bin/runners/runGuard.js +168 -168
  137. package/bin/runners/runInitGha.js +164 -164
  138. package/bin/runners/runInstall.js +277 -277
  139. package/bin/runners/runInteractive.js +388 -388
  140. package/bin/runners/runLabs.js +340 -340
  141. package/bin/runners/runMcp.js +865 -42
  142. package/bin/runners/runMissionGenerator.js +282 -282
  143. package/bin/runners/runPR.js +255 -255
  144. package/bin/runners/runPermissions.js +304 -290
  145. package/bin/runners/runPreflight.js +580 -0
  146. package/bin/runners/runProve.js +1252 -1193
  147. package/bin/runners/runReality.js +1328 -1328
  148. package/bin/runners/runReplay.js +499 -499
  149. package/bin/runners/runReport.js +584 -584
  150. package/bin/runners/runShare.js +212 -212
  151. package/bin/runners/runShip.js +98 -19
  152. package/bin/runners/runStatus.js +138 -138
  153. package/bin/runners/runTruthpack.js +636 -636
  154. package/bin/runners/runVerify.js +272 -0
  155. package/bin/runners/runWatch.js +407 -407
  156. package/bin/vibecheck.js +110 -95
  157. package/mcp-server/consolidated-tools.js +804 -804
  158. package/mcp-server/tools/index.js +72 -72
  159. package/mcp-server/truth-context.js +581 -581
  160. package/mcp-server/truth-firewall-tools.js +1500 -1500
  161. package/package.json +1 -1
  162. package/bin/runners/runProof.zip +0 -0
@@ -1,295 +1,295 @@
1
- /**
2
- * Entitlements v2 Tests - Tier Enforcement Verification
3
- *
4
- * These tests verify:
5
- * 1. No bypass via env vars (VIBECHECK_SKIP_AUTH, VIBECHECK_OWNER, etc.)
6
- * 2. Correct tier gating for each command/feature
7
- * 3. Proper exit codes (3 = feature not allowed)
8
- * 4. Downgrade behaviors work correctly
9
- * 5. Help output shows correct tier labels
10
- */
11
-
12
- const {
13
- getTier,
14
- getLimits,
15
- enforce,
16
- checkCommand,
17
- tierMeetsMinimum,
18
- getMinTierForFeature,
19
- tierHasFeature,
20
- TIERS,
21
- ENTITLEMENTS,
22
- LIMITS,
23
- EXIT_FEATURE_NOT_ALLOWED,
24
- EXIT_MISCONFIG,
25
- } = require("../entitlements-v2");
26
-
27
- describe("Entitlements v2 - Tier Enforcement", () => {
28
- // Store original env
29
- const originalEnv = { ...process.env };
30
-
31
- beforeEach(() => {
32
- // Reset env before each test
33
- process.env = { ...originalEnv };
34
- // Clear any env vars that might bypass
35
- delete process.env.VIBECHECK_SKIP_AUTH;
36
- delete process.env.VIBECHECK_OWNER;
37
- delete process.env.VIBECHECK_DEMO;
38
- delete process.env.OWNER_MODE;
39
- });
40
-
41
- afterAll(() => {
42
- process.env = originalEnv;
43
- });
44
-
45
- describe("No Bypass Tests", () => {
46
- test("VIBECHECK_SKIP_AUTH does NOT grant paid features", async () => {
47
- process.env.VIBECHECK_SKIP_AUTH = "1";
48
-
49
- // prove is PRO-only
50
- const result = await enforce("prove", { silent: true });
51
- expect(result.allowed).toBe(false);
52
- expect(result.exitCode).toBe(EXIT_FEATURE_NOT_ALLOWED);
53
- });
54
-
55
- test("VIBECHECK_OWNER does NOT grant paid features", async () => {
56
- process.env.VIBECHECK_OWNER = "1";
57
-
58
- const result = await enforce("prove", { silent: true });
59
- expect(result.allowed).toBe(false);
60
- });
61
-
62
- test("VIBECHECK_DEMO does NOT grant paid features", async () => {
63
- process.env.VIBECHECK_DEMO = "1";
64
-
65
- const result = await enforce("ai-test", { silent: true });
66
- expect(result.allowed).toBe(false);
67
- });
68
-
69
- test("OWNER_MODE does NOT grant paid features", async () => {
70
- process.env.OWNER_MODE = "true";
71
-
72
- const result = await enforce("share", { silent: true });
73
- expect(result.allowed).toBe(false);
74
- });
75
-
76
- test("Offline mode defaults to FREE tier (no escalation)", async () => {
77
- // Without API key, should be FREE
78
- const tier = await getTier({});
79
- expect(tier).toBe("free");
80
- });
81
- });
82
-
83
- describe("Tier Matrix Compliance", () => {
84
- describe("FREE tier commands", () => {
85
- const freeCommands = [
86
- "scan", "ship", "install", "init", "doctor", "status", "watch",
87
- "ctx", "guard", "context", "mdc", "login", "logout", "whoami", "labs"
88
- ];
89
-
90
- test.each(freeCommands)("%s is allowed on FREE tier", async (cmd) => {
91
- const result = await enforce(cmd, { silent: true });
92
- expect(result.allowed).toBe(true);
93
- });
94
- });
95
-
96
- describe("STARTER tier commands", () => {
97
- const starterCommands = ["gate", "launch", "pr", "badge", "mcp"];
98
-
99
- test.each(starterCommands)("%s requires STARTER+ (blocked on FREE)", async (cmd) => {
100
- const result = await enforce(cmd, { silent: true });
101
- // Without API key = FREE tier = should be blocked
102
- expect(result.allowed).toBe(false);
103
- expect(result.requiredTier).toBe("starter");
104
- expect(result.exitCode).toBe(EXIT_FEATURE_NOT_ALLOWED);
105
- });
106
- });
107
-
108
- describe("PRO tier commands", () => {
109
- const proCommands = ["prove", "share", "ai-test"];
110
-
111
- test.each(proCommands)("%s requires PRO (blocked on FREE/STARTER)", async (cmd) => {
112
- const result = await enforce(cmd, { silent: true });
113
- expect(result.allowed).toBe(false);
114
- expect(result.requiredTier).toBe("pro");
115
- expect(result.exitCode).toBe(EXIT_FEATURE_NOT_ALLOWED);
116
- });
117
- });
118
-
119
- describe("Subfeature gating", () => {
120
- test("fix.plan_only is FREE", async () => {
121
- const result = await enforce("fix.plan_only", { silent: true });
122
- expect(result.allowed).toBe(true);
123
- });
124
-
125
- test("fix.apply_patches requires PRO", async () => {
126
- const result = await enforce("fix.apply_patches", { silent: true });
127
- expect(result.allowed).toBe(false);
128
- expect(result.requiredTier).toBe("pro");
129
- });
130
-
131
- test("reality.preview is FREE", async () => {
132
- const result = await enforce("reality.preview", { silent: true });
133
- expect(result.allowed).toBe(true);
134
- });
135
-
136
- test("reality.full requires STARTER", async () => {
137
- const result = await enforce("reality.full", { silent: true });
138
- expect(result.allowed).toBe(false);
139
- expect(result.requiredTier).toBe("starter");
140
- });
141
-
142
- test("reality.advanced_auth_boundary requires PRO", async () => {
143
- const result = await enforce("reality.advanced_auth_boundary", { silent: true });
144
- expect(result.allowed).toBe(false);
145
- expect(result.requiredTier).toBe("pro");
146
- });
147
-
148
- test("report.html_md is FREE", async () => {
149
- const result = await enforce("report.html_md", { silent: true });
150
- expect(result.allowed).toBe(true);
151
- });
152
-
153
- test("report.sarif_csv requires STARTER", async () => {
154
- const result = await enforce("report.sarif_csv", { silent: true });
155
- expect(result.allowed).toBe(false);
156
- expect(result.requiredTier).toBe("starter");
157
- });
158
-
159
- test("report.compliance_packs requires PRO", async () => {
160
- const result = await enforce("report.compliance_packs", { silent: true });
161
- expect(result.allowed).toBe(false);
162
- expect(result.requiredTier).toBe("pro");
163
- });
164
- });
165
- });
166
-
167
- describe("Downgrade Behaviors", () => {
168
- test("reality downgrades to reality.preview on FREE", async () => {
169
- const result = await enforce("reality", { silent: true });
170
- expect(result.allowed).toBe(true);
171
- expect(result.downgrade).toBe("reality.preview");
172
- expect(result.caps).toBeDefined();
173
- });
174
-
175
- test("fix downgrades to fix.plan_only on FREE", async () => {
176
- const result = await enforce("fix", { silent: true });
177
- expect(result.allowed).toBe(true);
178
- expect(result.downgrade).toBe("fix.plan_only");
179
- });
180
-
181
- test("report downgrades to report.html_md on FREE", async () => {
182
- const result = await enforce("report", { silent: true });
183
- expect(result.allowed).toBe(true);
184
- expect(result.downgrade).toBe("report.html_md");
185
- });
186
- });
187
-
188
- describe("Exit Codes", () => {
189
- test("Returns EXIT_FEATURE_NOT_ALLOWED (3) for blocked features", async () => {
190
- const result = await enforce("prove", { silent: true });
191
- expect(result.exitCode).toBe(3);
192
- expect(result.exitCode).toBe(EXIT_FEATURE_NOT_ALLOWED);
193
- });
194
-
195
- test("Returns EXIT_MISCONFIG (4) for unknown features", async () => {
196
- const result = await enforce("nonexistent_feature", { silent: true });
197
- expect(result.exitCode).toBe(4);
198
- expect(result.exitCode).toBe(EXIT_MISCONFIG);
199
- });
200
- });
201
-
202
- describe("Limits by Tier", () => {
203
- test("FREE tier has correct limits", () => {
204
- const limits = getLimits("free");
205
- expect(limits.realityMaxPages).toBe(5);
206
- expect(limits.realityMaxClicks).toBe(20);
207
- expect(limits.realityAuthBoundary).toBe(false);
208
- expect(limits.reportFormats).toEqual(["html", "md"]);
209
- expect(limits.fixApplyPatches).toBe(false);
210
- });
211
-
212
- test("STARTER tier has expanded limits", () => {
213
- const limits = getLimits("starter");
214
- expect(limits.realityMaxPages).toBe(50);
215
- expect(limits.realityAuthBoundary).toBe(true);
216
- expect(limits.reportFormats).toContain("sarif");
217
- expect(limits.reportFormats).toContain("csv");
218
- expect(limits.fixApplyPatches).toBe(false);
219
- });
220
-
221
- test("PRO tier has full access", () => {
222
- const limits = getLimits("pro");
223
- expect(limits.realityMaxPages).toBe(-1); // unlimited
224
- expect(limits.realityAdvancedAuth).toBe(true);
225
- expect(limits.reportFormats).toContain("compliance");
226
- expect(limits.fixApplyPatches).toBe(true);
227
- });
228
- });
229
-
230
- describe("Tier Comparison Helpers", () => {
231
- test("tierMeetsMinimum works correctly", () => {
232
- expect(tierMeetsMinimum("free", "free")).toBe(true);
233
- expect(tierMeetsMinimum("free", "starter")).toBe(false);
234
- expect(tierMeetsMinimum("starter", "free")).toBe(true);
235
- expect(tierMeetsMinimum("starter", "starter")).toBe(true);
236
- expect(tierMeetsMinimum("starter", "pro")).toBe(false);
237
- expect(tierMeetsMinimum("pro", "starter")).toBe(true);
238
- expect(tierMeetsMinimum("pro", "pro")).toBe(true);
239
- expect(tierMeetsMinimum("enterprise", "pro")).toBe(true);
240
- });
241
-
242
- test("getMinTierForFeature returns correct tier", () => {
243
- expect(getMinTierForFeature("scan")).toBe("free");
244
- expect(getMinTierForFeature("gate")).toBe("starter");
245
- expect(getMinTierForFeature("prove")).toBe("pro");
246
- expect(getMinTierForFeature("unknown")).toBe("enterprise");
247
- });
248
-
249
- test("tierHasFeature returns correct boolean", () => {
250
- expect(tierHasFeature("free", "scan")).toBe(true);
251
- expect(tierHasFeature("free", "gate")).toBe(false);
252
- expect(tierHasFeature("starter", "gate")).toBe(true);
253
- expect(tierHasFeature("starter", "prove")).toBe(false);
254
- expect(tierHasFeature("pro", "prove")).toBe(true);
255
- });
256
- });
257
-
258
- describe("ENTITLEMENTS Matrix Validation", () => {
259
- test("All required commands are defined", () => {
260
- const requiredCommands = [
261
- "scan", "ship", "reality", "prove", "fix", "report",
262
- "install", "init", "doctor", "status", "watch", "launch",
263
- "ctx", "guard", "context", "mdc",
264
- "gate", "pr", "badge", "mcp", "share", "ai-test",
265
- "login", "logout", "whoami", "labs"
266
- ];
267
-
268
- for (const cmd of requiredCommands) {
269
- expect(ENTITLEMENTS[cmd]).toBeDefined();
270
- expect(ENTITLEMENTS[cmd].minTier).toBeDefined();
271
- }
272
- });
273
-
274
- test("All tiers are valid", () => {
275
- for (const [feature, def] of Object.entries(ENTITLEMENTS)) {
276
- expect(TIERS[def.minTier]).toBeDefined();
277
- }
278
- });
279
- });
280
- });
281
-
282
- describe("CLI Help Tier Labels", () => {
283
- test("TIERS constant has correct pricing", () => {
284
- expect(TIERS.free.price).toBe(0);
285
- expect(TIERS.starter.price).toBe(29);
286
- expect(TIERS.pro.price).toBe(99);
287
- expect(TIERS.enterprise.price).toBe(499);
288
- });
289
-
290
- test("TIERS constant has correct order", () => {
291
- expect(TIERS.free.order).toBeLessThan(TIERS.starter.order);
292
- expect(TIERS.starter.order).toBeLessThan(TIERS.pro.order);
293
- expect(TIERS.pro.order).toBeLessThan(TIERS.enterprise.order);
294
- });
295
- });
1
+ /**
2
+ * Entitlements v2 Tests - Tier Enforcement Verification
3
+ *
4
+ * These tests verify:
5
+ * 1. No bypass via env vars (VIBECHECK_SKIP_AUTH, VIBECHECK_OWNER, etc.)
6
+ * 2. Correct tier gating for each command/feature
7
+ * 3. Proper exit codes (3 = feature not allowed)
8
+ * 4. Downgrade behaviors work correctly
9
+ * 5. Help output shows correct tier labels
10
+ */
11
+
12
+ const {
13
+ getTier,
14
+ getLimits,
15
+ enforce,
16
+ checkCommand,
17
+ tierMeetsMinimum,
18
+ getMinTierForFeature,
19
+ tierHasFeature,
20
+ TIERS,
21
+ ENTITLEMENTS,
22
+ LIMITS,
23
+ EXIT_FEATURE_NOT_ALLOWED,
24
+ EXIT_MISCONFIG,
25
+ } = require("../entitlements-v2");
26
+
27
+ describe("Entitlements v2 - Tier Enforcement", () => {
28
+ // Store original env
29
+ const originalEnv = { ...process.env };
30
+
31
+ beforeEach(() => {
32
+ // Reset env before each test
33
+ process.env = { ...originalEnv };
34
+ // Clear any env vars that might bypass
35
+ delete process.env.VIBECHECK_SKIP_AUTH;
36
+ delete process.env.VIBECHECK_OWNER;
37
+ delete process.env.VIBECHECK_DEMO;
38
+ delete process.env.OWNER_MODE;
39
+ });
40
+
41
+ afterAll(() => {
42
+ process.env = originalEnv;
43
+ });
44
+
45
+ describe("No Bypass Tests", () => {
46
+ test("VIBECHECK_SKIP_AUTH does NOT grant paid features", async () => {
47
+ process.env.VIBECHECK_SKIP_AUTH = "1";
48
+
49
+ // prove is PRO-only
50
+ const result = await enforce("prove", { silent: true });
51
+ expect(result.allowed).toBe(false);
52
+ expect(result.exitCode).toBe(EXIT_FEATURE_NOT_ALLOWED);
53
+ });
54
+
55
+ test("VIBECHECK_OWNER does NOT grant paid features", async () => {
56
+ process.env.VIBECHECK_OWNER = "1";
57
+
58
+ const result = await enforce("prove", { silent: true });
59
+ expect(result.allowed).toBe(false);
60
+ });
61
+
62
+ test("VIBECHECK_DEMO does NOT grant paid features", async () => {
63
+ process.env.VIBECHECK_DEMO = "1";
64
+
65
+ const result = await enforce("ai-test", { silent: true });
66
+ expect(result.allowed).toBe(false);
67
+ });
68
+
69
+ test("OWNER_MODE does NOT grant paid features", async () => {
70
+ process.env.OWNER_MODE = "true";
71
+
72
+ const result = await enforce("share", { silent: true });
73
+ expect(result.allowed).toBe(false);
74
+ });
75
+
76
+ test("Offline mode defaults to FREE tier (no escalation)", async () => {
77
+ // Without API key, should be FREE
78
+ const tier = await getTier({});
79
+ expect(tier).toBe("free");
80
+ });
81
+ });
82
+
83
+ describe("Tier Matrix Compliance", () => {
84
+ describe("FREE tier commands", () => {
85
+ const freeCommands = [
86
+ "scan", "ship", "install", "init", "doctor", "status", "watch",
87
+ "ctx", "guard", "context", "mdc", "login", "logout", "whoami", "labs"
88
+ ];
89
+
90
+ test.each(freeCommands)("%s is allowed on FREE tier", async (cmd) => {
91
+ const result = await enforce(cmd, { silent: true });
92
+ expect(result.allowed).toBe(true);
93
+ });
94
+ });
95
+
96
+ describe("STARTER tier commands", () => {
97
+ const starterCommands = ["gate", "launch", "pr", "badge", "mcp"];
98
+
99
+ test.each(starterCommands)("%s requires STARTER+ (blocked on FREE)", async (cmd) => {
100
+ const result = await enforce(cmd, { silent: true });
101
+ // Without API key = FREE tier = should be blocked
102
+ expect(result.allowed).toBe(false);
103
+ expect(result.requiredTier).toBe("starter");
104
+ expect(result.exitCode).toBe(EXIT_FEATURE_NOT_ALLOWED);
105
+ });
106
+ });
107
+
108
+ describe("PRO tier commands", () => {
109
+ const proCommands = ["prove", "share", "ai-test"];
110
+
111
+ test.each(proCommands)("%s requires PRO (blocked on FREE/STARTER)", async (cmd) => {
112
+ const result = await enforce(cmd, { silent: true });
113
+ expect(result.allowed).toBe(false);
114
+ expect(result.requiredTier).toBe("pro");
115
+ expect(result.exitCode).toBe(EXIT_FEATURE_NOT_ALLOWED);
116
+ });
117
+ });
118
+
119
+ describe("Subfeature gating", () => {
120
+ test("fix.plan_only is FREE", async () => {
121
+ const result = await enforce("fix.plan_only", { silent: true });
122
+ expect(result.allowed).toBe(true);
123
+ });
124
+
125
+ test("fix.apply_patches requires PRO", async () => {
126
+ const result = await enforce("fix.apply_patches", { silent: true });
127
+ expect(result.allowed).toBe(false);
128
+ expect(result.requiredTier).toBe("pro");
129
+ });
130
+
131
+ test("reality.preview is FREE", async () => {
132
+ const result = await enforce("reality.preview", { silent: true });
133
+ expect(result.allowed).toBe(true);
134
+ });
135
+
136
+ test("reality.full requires STARTER", async () => {
137
+ const result = await enforce("reality.full", { silent: true });
138
+ expect(result.allowed).toBe(false);
139
+ expect(result.requiredTier).toBe("starter");
140
+ });
141
+
142
+ test("reality.advanced_auth_boundary requires PRO", async () => {
143
+ const result = await enforce("reality.advanced_auth_boundary", { silent: true });
144
+ expect(result.allowed).toBe(false);
145
+ expect(result.requiredTier).toBe("pro");
146
+ });
147
+
148
+ test("report.html_md is FREE", async () => {
149
+ const result = await enforce("report.html_md", { silent: true });
150
+ expect(result.allowed).toBe(true);
151
+ });
152
+
153
+ test("report.sarif_csv requires STARTER", async () => {
154
+ const result = await enforce("report.sarif_csv", { silent: true });
155
+ expect(result.allowed).toBe(false);
156
+ expect(result.requiredTier).toBe("starter");
157
+ });
158
+
159
+ test("report.compliance_packs requires PRO", async () => {
160
+ const result = await enforce("report.compliance_packs", { silent: true });
161
+ expect(result.allowed).toBe(false);
162
+ expect(result.requiredTier).toBe("pro");
163
+ });
164
+ });
165
+ });
166
+
167
+ describe("Downgrade Behaviors", () => {
168
+ test("reality downgrades to reality.preview on FREE", async () => {
169
+ const result = await enforce("reality", { silent: true });
170
+ expect(result.allowed).toBe(true);
171
+ expect(result.downgrade).toBe("reality.preview");
172
+ expect(result.caps).toBeDefined();
173
+ });
174
+
175
+ test("fix downgrades to fix.plan_only on FREE", async () => {
176
+ const result = await enforce("fix", { silent: true });
177
+ expect(result.allowed).toBe(true);
178
+ expect(result.downgrade).toBe("fix.plan_only");
179
+ });
180
+
181
+ test("report downgrades to report.html_md on FREE", async () => {
182
+ const result = await enforce("report", { silent: true });
183
+ expect(result.allowed).toBe(true);
184
+ expect(result.downgrade).toBe("report.html_md");
185
+ });
186
+ });
187
+
188
+ describe("Exit Codes", () => {
189
+ test("Returns EXIT_FEATURE_NOT_ALLOWED (3) for blocked features", async () => {
190
+ const result = await enforce("prove", { silent: true });
191
+ expect(result.exitCode).toBe(3);
192
+ expect(result.exitCode).toBe(EXIT_FEATURE_NOT_ALLOWED);
193
+ });
194
+
195
+ test("Returns EXIT_MISCONFIG (4) for unknown features", async () => {
196
+ const result = await enforce("nonexistent_feature", { silent: true });
197
+ expect(result.exitCode).toBe(4);
198
+ expect(result.exitCode).toBe(EXIT_MISCONFIG);
199
+ });
200
+ });
201
+
202
+ describe("Limits by Tier", () => {
203
+ test("FREE tier has correct limits", () => {
204
+ const limits = getLimits("free");
205
+ expect(limits.realityMaxPages).toBe(5);
206
+ expect(limits.realityMaxClicks).toBe(20);
207
+ expect(limits.realityAuthBoundary).toBe(false);
208
+ expect(limits.reportFormats).toEqual(["html", "md"]);
209
+ expect(limits.fixApplyPatches).toBe(false);
210
+ });
211
+
212
+ test("STARTER tier has expanded limits", () => {
213
+ const limits = getLimits("starter");
214
+ expect(limits.realityMaxPages).toBe(50);
215
+ expect(limits.realityAuthBoundary).toBe(true);
216
+ expect(limits.reportFormats).toContain("sarif");
217
+ expect(limits.reportFormats).toContain("csv");
218
+ expect(limits.fixApplyPatches).toBe(false);
219
+ });
220
+
221
+ test("PRO tier has full access", () => {
222
+ const limits = getLimits("pro");
223
+ expect(limits.realityMaxPages).toBe(-1); // unlimited
224
+ expect(limits.realityAdvancedAuth).toBe(true);
225
+ expect(limits.reportFormats).toContain("compliance");
226
+ expect(limits.fixApplyPatches).toBe(true);
227
+ });
228
+ });
229
+
230
+ describe("Tier Comparison Helpers", () => {
231
+ test("tierMeetsMinimum works correctly", () => {
232
+ expect(tierMeetsMinimum("free", "free")).toBe(true);
233
+ expect(tierMeetsMinimum("free", "starter")).toBe(false);
234
+ expect(tierMeetsMinimum("starter", "free")).toBe(true);
235
+ expect(tierMeetsMinimum("starter", "starter")).toBe(true);
236
+ expect(tierMeetsMinimum("starter", "pro")).toBe(false);
237
+ expect(tierMeetsMinimum("pro", "starter")).toBe(true);
238
+ expect(tierMeetsMinimum("pro", "pro")).toBe(true);
239
+ expect(tierMeetsMinimum("enterprise", "pro")).toBe(true);
240
+ });
241
+
242
+ test("getMinTierForFeature returns correct tier", () => {
243
+ expect(getMinTierForFeature("scan")).toBe("free");
244
+ expect(getMinTierForFeature("gate")).toBe("starter");
245
+ expect(getMinTierForFeature("prove")).toBe("pro");
246
+ expect(getMinTierForFeature("unknown")).toBe("enterprise");
247
+ });
248
+
249
+ test("tierHasFeature returns correct boolean", () => {
250
+ expect(tierHasFeature("free", "scan")).toBe(true);
251
+ expect(tierHasFeature("free", "gate")).toBe(false);
252
+ expect(tierHasFeature("starter", "gate")).toBe(true);
253
+ expect(tierHasFeature("starter", "prove")).toBe(false);
254
+ expect(tierHasFeature("pro", "prove")).toBe(true);
255
+ });
256
+ });
257
+
258
+ describe("ENTITLEMENTS Matrix Validation", () => {
259
+ test("All required commands are defined", () => {
260
+ const requiredCommands = [
261
+ "scan", "ship", "reality", "prove", "fix", "report",
262
+ "install", "init", "doctor", "status", "watch", "launch",
263
+ "ctx", "guard", "context", "mdc",
264
+ "gate", "pr", "badge", "mcp", "share", "ai-test",
265
+ "login", "logout", "whoami", "labs"
266
+ ];
267
+
268
+ for (const cmd of requiredCommands) {
269
+ expect(ENTITLEMENTS[cmd]).toBeDefined();
270
+ expect(ENTITLEMENTS[cmd].minTier).toBeDefined();
271
+ }
272
+ });
273
+
274
+ test("All tiers are valid", () => {
275
+ for (const [feature, def] of Object.entries(ENTITLEMENTS)) {
276
+ expect(TIERS[def.minTier]).toBeDefined();
277
+ }
278
+ });
279
+ });
280
+ });
281
+
282
+ describe("CLI Help Tier Labels", () => {
283
+ test("TIERS constant has correct pricing", () => {
284
+ expect(TIERS.free.price).toBe(0);
285
+ expect(TIERS.starter.price).toBe(29);
286
+ expect(TIERS.pro.price).toBe(99);
287
+ expect(TIERS.enterprise.price).toBe(499);
288
+ });
289
+
290
+ test("TIERS constant has correct order", () => {
291
+ expect(TIERS.free.order).toBeLessThan(TIERS.starter.order);
292
+ expect(TIERS.starter.order).toBeLessThan(TIERS.pro.order);
293
+ expect(TIERS.pro.order).toBeLessThan(TIERS.enterprise.order);
294
+ });
295
+ });