ctxtop 0.0.0-stage → 4.0.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 (240) hide show
  1. package/.antigravity-plugin/plugin.json +36 -0
  2. package/.claude-plugin/plugin.json +18 -0
  3. package/CHECKSUMS.sha256 +149 -0
  4. package/LICENSE +27 -0
  5. package/README.md +330 -3
  6. package/SECURITY.md +22 -0
  7. package/agents/ah-flash-scout.md +25 -0
  8. package/assets/advanced_view_loaded_420px.png +0 -0
  9. package/assets/hero-demo.svg +188 -0
  10. package/assets/logo.svg +19 -0
  11. package/assets/simple_view_lean_420px.png +0 -0
  12. package/assets/simple_view_loaded_420px.png +0 -0
  13. package/assets/social-preview.svg +72 -0
  14. package/assets/zone_c_step3_shield_full.png +0 -0
  15. package/bin/ah-statusline.mjs +145 -0
  16. package/bin/cli.mjs +3 -0
  17. package/bin/ctxtop.mjs +1474 -0
  18. package/commands/cost-radar.md +11 -0
  19. package/commands/evolve.md +10 -0
  20. package/commands/handoff.md +10 -0
  21. package/commands/horizon.md +10 -0
  22. package/commands/inspect.md +10 -0
  23. package/commands/precheck.md +10 -0
  24. package/config/default_flightcheck.json +114 -0
  25. package/config/modelCatalog.json +620 -0
  26. package/config/platformQuirks.json +19 -0
  27. package/hooks/handlers/compact-lifecycle.mjs +262 -0
  28. package/hooks/handlers/hookIo.mjs +255 -0
  29. package/hooks/handlers/hookIpcClient.mjs +83 -0
  30. package/hooks/handlers/post-tool-use.mjs +265 -0
  31. package/hooks/handlers/pre-model-switch.mjs +249 -0
  32. package/hooks/handlers/pre-tool-use.mjs +365 -0
  33. package/hooks/handlers/stop-gate.mjs +240 -0
  34. package/hooks/handlers/user-prompt-submit.mjs +143 -0
  35. package/hooks/hooks.json +81 -0
  36. package/hooks/post_invocation.mjs +13 -0
  37. package/hooks/post_tool_use.mjs +17 -0
  38. package/hooks/pre_invocation.mjs +14 -0
  39. package/hooks/pre_tool_use.mjs +97 -0
  40. package/hooks/register.js +687 -0
  41. package/hooks/session_start.mjs +14 -0
  42. package/hooks/stop.mjs +13 -0
  43. package/hooks.json +56 -0
  44. package/package.json +103 -4
  45. package/packages/antigravity/package.json +14 -0
  46. package/packages/antigravity/src/index.mjs +1 -0
  47. package/packages/claude-code/package.json +14 -0
  48. package/packages/claude-code/src/index.mjs +2 -0
  49. package/packages/core/package.json +14 -0
  50. package/packages/core/src/index.mjs +1 -0
  51. package/packages/engine-node/package.json +14 -0
  52. package/packages/engine-node/src/index.mjs +1 -0
  53. package/packages/mcp/package.json +17 -0
  54. package/packages/mcp/src/server.mjs +396 -0
  55. package/packages/pro/LICENSE-COMMERCIAL.md +19 -0
  56. package/packages/pro/README-SIGNING.md +30 -0
  57. package/packages/pro/package.json +16 -0
  58. package/packages/pro/src/index.mjs +3 -0
  59. package/packages/pro/src/team_finops_pack.mjs +241 -0
  60. package/packages/pro/workers/polar_webhook_worker.mjs +215 -0
  61. package/plugin.json +36 -0
  62. package/rules/AGENTS.md +10 -0
  63. package/sidecars/horizon-daemon/ipcServer.mjs +24 -0
  64. package/sidecars/horizon-daemon/server.mjs +2002 -0
  65. package/sidecars/horizon-daemon/sidecar.json +19 -0
  66. package/skills/cost-radar/SKILL.md +21 -0
  67. package/skills/evolve/SKILL.md +21 -0
  68. package/skills/handoff/SKILL.md +42 -0
  69. package/skills/horizon/SKILL.md +17 -0
  70. package/skills/inspect/SKILL.md +18 -0
  71. package/skills/precheck/SKILL.md +44 -0
  72. package/src/adapters/antigravity/index.mjs +79 -0
  73. package/src/adapters/claude-code/index.mjs +155 -0
  74. package/src/cli/cost_radar.mjs +70 -0
  75. package/src/cli/doctor.mjs +351 -0
  76. package/src/cli/horizon_hud.mjs +686 -0
  77. package/src/cli/init.mjs +425 -0
  78. package/src/cli/postmortem.mjs +515 -0
  79. package/src/coach/cacheGravityRouter.mjs +12 -0
  80. package/src/config/modelCatalog.json +620 -0
  81. package/src/config/platformQuirks.json +19 -0
  82. package/src/core/action_queue.mjs +264 -0
  83. package/src/core/ag_bridge.mjs +346 -0
  84. package/src/core/atomic_io.mjs +124 -0
  85. package/src/core/baseline.mjs +607 -0
  86. package/src/core/blindspot_sensors.mjs +399 -0
  87. package/src/core/classifier.mjs +1757 -0
  88. package/src/core/coach/circuit_breakers.mjs +650 -0
  89. package/src/core/coach/contradiction_auditor.mjs +239 -0
  90. package/src/core/coach/effort_advisor.mjs +143 -0
  91. package/src/core/coach/handoff_hydrator.mjs +483 -0
  92. package/src/core/coach/progressive_checkpointer.mjs +551 -0
  93. package/src/core/coach/prompt_decomposer_coach.mjs +141 -0
  94. package/src/core/coach/reflector_queue.mjs +505 -0
  95. package/src/core/coach/saved_quota_ledger.mjs +615 -0
  96. package/src/core/coach/subagent_ipi_sanitizer.mjs +200 -0
  97. package/src/core/coach/subagent_phantom_auditor.mjs +261 -0
  98. package/src/core/coach/task_quota_router.mjs +955 -0
  99. package/src/core/coach/turn_zero_gate.mjs +574 -0
  100. package/src/core/compaction_coach.mjs +1126 -0
  101. package/src/core/config.mjs +214 -0
  102. package/src/core/constants.mjs +1800 -0
  103. package/src/core/detectors_det01_to_16.mjs +1474 -0
  104. package/src/core/episodic_memory.mjs +135 -0
  105. package/src/core/fts5_output_compressor.mjs +359 -0
  106. package/src/core/git_ledger.mjs +189 -0
  107. package/src/core/handoff_audit.mjs +558 -0
  108. package/src/core/history.mjs +221 -0
  109. package/src/core/hook_diagnostics.mjs +158 -0
  110. package/src/core/horizon_classifier.mjs +326 -0
  111. package/src/core/horizon_config.mjs +802 -0
  112. package/src/core/host_watchdog.mjs +200 -0
  113. package/src/core/layer5_hygiene.mjs +966 -0
  114. package/src/core/log_resolver.mjs +231 -0
  115. package/src/core/mcp_auditor.mjs +138 -0
  116. package/src/core/micro_skills_store.mjs +91 -0
  117. package/src/core/offenders.mjs +161 -0
  118. package/src/core/parser.mjs +1996 -0
  119. package/src/core/path_canonicalizer.mjs +73 -0
  120. package/src/core/paths.mjs +310 -0
  121. package/src/core/prefix_cache_shield.mjs +386 -0
  122. package/src/core/pro_license.mjs +385 -0
  123. package/src/core/prompt_rubric.mjs +518 -0
  124. package/src/core/pruner.mjs +433 -0
  125. package/src/core/quota.mjs +1860 -0
  126. package/src/core/rsi_instinct_engine.mjs +1197 -0
  127. package/src/core/sanitizer.mjs +121 -0
  128. package/src/core/session_forensics.mjs +303 -0
  129. package/src/core/session_timeline.mjs +358 -0
  130. package/src/core/settings.mjs +99 -0
  131. package/src/core/shared/detectors.mjs +1342 -0
  132. package/src/core/shared/fnv1a64.mjs +85 -0
  133. package/src/core/shared/handoff_schema.mjs +123 -0
  134. package/src/core/shared/index.mjs +5 -0
  135. package/src/core/shared/ipi_sanitizer.mjs +165 -0
  136. package/src/core/shared/micro_skills.mjs +1 -0
  137. package/src/core/shared/plugin_validator.mjs +202 -0
  138. package/src/core/shared/prompt_hygiene_governor.mjs +1 -0
  139. package/src/core/sidecar_store.mjs +302 -0
  140. package/src/core/sprint_metrics.mjs +366 -0
  141. package/src/core/sqlite_client.mjs +283 -0
  142. package/src/core/storage_doctor.mjs +358 -0
  143. package/src/core/subagents.mjs +609 -0
  144. package/src/core/swarm_topology.mjs +360 -0
  145. package/src/core/task_quota_router.mjs +1656 -0
  146. package/src/core/telemetry/cache_ttl_watchdog.mjs +284 -0
  147. package/src/core/telemetry/scope_lock_registry.mjs +578 -0
  148. package/src/core/telemetry/shadow_file_detector.mjs +291 -0
  149. package/src/core/telemetry/trajectory_watcher.mjs +259 -0
  150. package/src/core/timeline_svg.mjs +236 -0
  151. package/src/core/tool_surgeon.mjs +305 -0
  152. package/src/core/trajectory_stitcher.mjs +645 -0
  153. package/src/core/u_shaped_optimizer.mjs +789 -0
  154. package/src/core/wal_hygiene.mjs +233 -0
  155. package/src/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  156. package/src/core-isomorphic/catalog/index.mjs +1 -0
  157. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +720 -0
  158. package/src/core-isomorphic/coach/microSkills.mjs +1 -0
  159. package/src/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  160. package/src/core-isomorphic/coach/repoCalibration.mjs +254 -0
  161. package/src/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  162. package/src/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  163. package/src/core-isomorphic/coach/ttlWatchdog.mjs +457 -0
  164. package/src/core-isomorphic/config/anthropicModelCatalog.json +203 -0
  165. package/src/core-isomorphic/config/catalogLoader.mjs +768 -0
  166. package/src/core-isomorphic/config/horizonConfig.mjs +1009 -0
  167. package/src/core-isomorphic/control/callTree.mjs +338 -0
  168. package/src/core-isomorphic/control/coachLatches.mjs +126 -0
  169. package/src/core-isomorphic/control/controlStateMachine.mjs +205 -0
  170. package/src/core-isomorphic/control/index.mjs +49 -0
  171. package/src/core-isomorphic/control/swarmWorktree.mjs +109 -0
  172. package/src/core-isomorphic/control/toolSuspension.mjs +197 -0
  173. package/src/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  174. package/src/core-isomorphic/diagnostics/index.mjs +9 -0
  175. package/src/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  176. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +622 -0
  177. package/src/core-isomorphic/economics/billingBlocks.mjs +251 -0
  178. package/src/core-isomorphic/economics/cacheGravity.mjs +351 -0
  179. package/src/core-isomorphic/economics/cliffBreaker.mjs +170 -0
  180. package/src/core-isomorphic/economics/driftLatency.mjs +319 -0
  181. package/src/core-isomorphic/economics/dualTtl.mjs +198 -0
  182. package/src/core-isomorphic/economics/index.mjs +47 -0
  183. package/src/core-isomorphic/economics/retentionRadar.mjs +348 -0
  184. package/src/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  185. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +1035 -0
  186. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +480 -0
  187. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +603 -0
  188. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +301 -0
  189. package/src/core-isomorphic/index.js +26 -0
  190. package/src/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  191. package/src/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  192. package/src/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  193. package/src/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  194. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +1132 -0
  195. package/src/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  196. package/src/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  197. package/src/core-isomorphic/ui/horizonGrid.mjs +475 -0
  198. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +1181 -0
  199. package/src/core-isomorphic/ui/modViews.mjs +1478 -0
  200. package/src/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  201. package/src/core-isomorphic/ustf/index.mjs +7 -0
  202. package/src/core-isomorphic/ustf/normalizer.mjs +512 -0
  203. package/src/core-isomorphic/ustf/schema.mjs +186 -0
  204. package/src/core-isomorphic/utils/runtime.mjs +962 -0
  205. package/src/demo/synthetic_states.mjs +661 -0
  206. package/src/diagnostics/bugReportGenerator.mjs +253 -0
  207. package/src/diagnostics/doctorEngine.mjs +203 -0
  208. package/src/engine-node/db/index.mjs +58 -0
  209. package/src/engine-node/db/jsonl_fallback.mjs +184 -0
  210. package/src/engine-node/db/probe.mjs +110 -0
  211. package/src/engine-node/db/sqlite_wrapper.mjs +122 -0
  212. package/src/engine-node/index.mjs +9 -0
  213. package/src/engine-node/ipc/client.mjs +447 -0
  214. package/src/engine-node/ipc/index.mjs +22 -0
  215. package/src/engine-node/ipc/protocol.mjs +177 -0
  216. package/src/engine-node/ipc/server.mjs +445 -0
  217. package/src/engine-node/offloader/index.mjs +6 -0
  218. package/src/engine-node/offloader/tool_offloader.mjs +241 -0
  219. package/src/engine-node/sensors/blindspots.mjs +369 -0
  220. package/src/engine-node/sensors/git_merge_tree.mjs +223 -0
  221. package/src/engine-node/sensors/index.mjs +7 -0
  222. package/src/hooks/portfolio_runtime.mjs +858 -0
  223. package/src/hooks/post_invocation.mjs +419 -0
  224. package/src/hooks/pre_invocation.mjs +1015 -0
  225. package/src/hooks/session_start.mjs +161 -0
  226. package/src/shims/agy_cli_compressor.mjs +705 -0
  227. package/src/shims/agy_git_guard.mjs +749 -0
  228. package/src/shims/ah_log_query.mjs +39 -0
  229. package/src/ui/costRadarSvg.mjs +6 -0
  230. package/src/ui/horizonGrid.mjs +1 -0
  231. package/src/ui/horizonPanelHtml.mjs +1 -0
  232. package/src/ui/horizon_panel.css +167 -0
  233. package/src/ui/horizon_panel.js +212 -0
  234. package/src/ui/modViews.mjs +1 -0
  235. package/src/utils/nodeIo.mjs +59 -0
  236. package/src/utils/runtime.mjs +1 -0
  237. package/src/webview/advanced_view.html +1808 -0
  238. package/src/webview/horizon_panel.html +11389 -0
  239. package/src/webview/registry.mjs +80 -0
  240. package/src/webview/simple_view.html +1370 -0
@@ -0,0 +1,385 @@
1
+ /**
2
+ * @file src/core/pro_license.mjs
3
+ * Highbeam Pro (`@ctxtop/pro`) — Zero-Network Offline Ed25519 License Verifier & Cross-Harness Entitlement Store.
4
+ *
5
+ * Uses Node.js built-in `node:crypto` Ed25519 signature verification (`CTXP1.<payloadB64Url>.<sigB64Url>`).
6
+ * Stores verified license state at `~/.ctxtop/license.json` shared across Google Antigravity and Claude Code.
7
+ */
8
+
9
+ import crypto from 'node:crypto';
10
+ import fs from 'node:fs';
11
+ import path from 'node:path';
12
+ import os from 'node:os';
13
+
14
+ /**
15
+ * Default embedded Ed25519 public key (SPKI PEM) for Polar.sh / `@ctxtop/pro` offline license verification.
16
+ * Can be overridden in tests or enterprise deployments via `options.publicKeyPem` or `CTXTOP_ED25519_PUBLIC_KEY_PEM`.
17
+ */
18
+ export const DEFAULT_PRO_PUBLIC_KEY_PEM = [
19
+ '-----BEGIN PUBLIC KEY-----',
20
+ 'MCowBQYDK2VwAyEAz6vC7wF1m2r8nK9pQ4tL3xY5vW0jH8gD2sB6eR1cA4o=',
21
+ '-----END PUBLIC KEY-----'
22
+ ].join('\n');
23
+
24
+ export const PRO_PRICING_TIERS = Object.freeze({
25
+ free: { id: 'free', label: 'Free Core (MIT)', priceUSD: 0, billing: 'forever' },
26
+ pro_monthly: { id: 'pro', label: 'Highbeam Pro (Monthly)', priceUSD: 15, priceRangeUSD: [12, 19], billing: 'month' },
27
+ pro_annual: { id: 'pro', label: 'Highbeam Pro (Annual)', priceUSD: 149, effectiveMonthlyUSD: 12.42, billing: 'year' },
28
+ pro_ltd: { id: 'ltd', label: 'Highbeam Pro (Founder Lifetime)', priceUSD: 199, billing: 'lifetime' },
29
+ team: { id: 'team', label: 'Highbeam Team (Annual 5-Seat Starter + OTel)', priceUSD: 299, seatMonthlyUSD: 39, billing: 'year' }
30
+ });
31
+
32
+ /**
33
+ * Three-Tier "Self-Expensing" PLG Funnel Matrix (VC Playbook Step 5).
34
+ */
35
+ export const PLG_TIER_MATRIX = Object.freeze({
36
+ free: Object.freeze({
37
+ id: 'free',
38
+ name: 'Free Tier (Community Core)',
39
+ priceMonthlyUSD: 0,
40
+ installCommand: 'npx attention-horizon',
41
+ features: Object.freeze([
42
+ 'Simple View HUD & 4-Rank Tufte Verdict Bar',
43
+ '40-Cell Parabolic U-Curve Context Map',
44
+ '5m/1h Live Prompt Cache TTL Countdown',
45
+ 'HOLD_COMPACT Warm Cache Warning',
46
+ '6 Core Auditable Guards (32 rules)'
47
+ ])
48
+ }),
49
+ pro: Object.freeze({
50
+ id: 'pro',
51
+ name: 'Pro Tier (Self-Expensing Solo Developer)',
52
+ priceMonthlyUSD: 15,
53
+ priceRangeMonthlyUSD: Object.freeze([12, 19]),
54
+ features: Object.freeze([
55
+ 'Automated PreToolUse Delta-Read & AST Signature Stub Interception',
56
+ 'Cross-Session Chronic Offender Memory',
57
+ '30-Day Workspace Savings Ledger (#tufteBaselineStrip)',
58
+ 'Signed Corporate PDF 1.4 Expense Receipt (/api/receipt/export?format=pdf)',
59
+ 'AUTO_PILOT Hysteresis Lock & Algebraic C* Model Switch Hold'
60
+ ])
61
+ }),
62
+ team: Object.freeze({
63
+ id: 'team',
64
+ name: 'Team / Enterprise Tier (Zero-Cloud FinOps)',
65
+ pricePerSeatMonthlyUSD: 39,
66
+ features: Object.freeze([
67
+ 'Shared .agents/rules/ Primacy-Band Governance',
68
+ 'Sanitized Cross-Developer Bloat Analytics (/api/export/sanitized)',
69
+ 'Repo-Wide MCP Lazy-Loading Enforcement',
70
+ 'BYO-Grafana OpenTelemetry & Prometheus Alerting Pack (ctxtop team-pack)'
71
+ ])
72
+ })
73
+ });
74
+
75
+ export function resolveLicenseFilePath(options = {}) {
76
+ if (typeof options.licensePath === 'string' && options.licensePath.trim()) {
77
+ return path.resolve(options.licensePath.trim());
78
+ }
79
+ const homeDir = options.homeDir || process.env.USERPROFILE || process.env.HOME || os.homedir();
80
+ return path.join(homeDir, '.ctxtop', 'license.json');
81
+ }
82
+
83
+ /**
84
+ * Generates an Ed25519 keypair (PEM) for signing offline `CTXP1` Pro license keys.
85
+ */
86
+ export function generateProKeyPair() {
87
+ const { publicKey, privateKey } = crypto.generateKeyPairSync('ed25519', {
88
+ publicKeyEncoding: { type: 'spki', format: 'pem' },
89
+ privateKeyEncoding: { type: 'pkcs8', format: 'pem' }
90
+ });
91
+ return { publicKeyPem: publicKey, privateKeyPem: privateKey };
92
+ }
93
+
94
+ /**
95
+ * Signs a Pro license payload using an Ed25519 private key PEM and returns a `CTXP1.<payload>.<sig>` string.
96
+ *
97
+ * @param {object} payload
98
+ * @param {string} privateKeyPem
99
+ * @returns {string}
100
+ */
101
+ export function signProLicensePayload(payload = {}, privateKeyPem = '') {
102
+ if (!privateKeyPem) {
103
+ throw new Error('signProLicensePayload requires an Ed25519 privateKeyPem');
104
+ }
105
+ const nowIso = new Date().toISOString();
106
+ const normalizedPayload = {
107
+ v: 1,
108
+ tier: payload.tier || 'pro',
109
+ email: payload.email || 'developer@local',
110
+ seats: Number(payload.seats || 1),
111
+ issuedAt: payload.issuedAt || nowIso,
112
+ expiresAt: payload.expiresAt || null,
113
+ source: payload.source || 'polar.sh',
114
+ features: Array.isArray(payload.features)
115
+ ? payload.features
116
+ : ['auto_pilot_locks', 'cross_harness_scope_locks', 'corporate_expense_receipts', 'otel_team_bundle']
117
+ };
118
+ const payloadB64 = Buffer.from(JSON.stringify(normalizedPayload), 'utf8').toString('base64url');
119
+ const sigBuf = crypto.sign(null, Buffer.from(payloadB64, 'utf8'), privateKeyPem);
120
+ const sigB64 = sigBuf.toString('base64url');
121
+ return `CTXP1.${payloadB64}.${sigB64}`;
122
+ }
123
+
124
+ /**
125
+ * Strictly verifies a `CTXP1.<payloadB64Url>.<sigB64Url>` license key offline via `node:crypto` Ed25519.
126
+ *
127
+ * @param {string} licenseKey
128
+ * @param {object} [options={}]
129
+ * @returns {{ valid: boolean, reason: string | null, payload: object | null }}
130
+ */
131
+ export function verifyProLicenseKey(licenseKey = '', options = {}) {
132
+ const raw = String(licenseKey || '').trim();
133
+ if (!raw) {
134
+ return { valid: false, reason: 'EMPTY_KEY', payload: null };
135
+ }
136
+ const parts = raw.split('.');
137
+ if (parts.length !== 3 || parts[0] !== 'CTXP1') {
138
+ return { valid: false, reason: 'INVALID_FORMAT', payload: null };
139
+ }
140
+ const [, payloadB64, sigB64] = parts;
141
+ if (!payloadB64 || !sigB64) {
142
+ return { valid: false, reason: 'MALFORMED_SEGMENTS', payload: null };
143
+ }
144
+
145
+ const publicKeyPem =
146
+ options.publicKeyPem ||
147
+ process.env.CTXTOP_ED25519_PUBLIC_KEY_PEM ||
148
+ DEFAULT_PRO_PUBLIC_KEY_PEM;
149
+
150
+ try {
151
+ const isVerified = crypto.verify(
152
+ null,
153
+ Buffer.from(payloadB64, 'utf8'),
154
+ publicKeyPem,
155
+ Buffer.from(sigB64, 'base64url')
156
+ );
157
+ if (!isVerified) {
158
+ return { valid: false, reason: 'INVALID_SIGNATURE', payload: null };
159
+ }
160
+ } catch (err) {
161
+ return { valid: false, reason: `CRYPTO_VERIFY_ERROR: ${err.message}`, payload: null };
162
+ }
163
+
164
+ let payload = null;
165
+ try {
166
+ payload = JSON.parse(Buffer.from(payloadB64, 'base64url').toString('utf8'));
167
+ } catch {
168
+ return { valid: false, reason: 'INVALID_PAYLOAD_JSON', payload: null };
169
+ }
170
+
171
+ const nowMs = Number(options.nowMs || Date.now());
172
+ if (payload.expiresAt) {
173
+ const expMs = Date.parse(payload.expiresAt);
174
+ if (Number.isFinite(expMs) && nowMs > expMs) {
175
+ return { valid: false, reason: 'LICENSE_EXPIRED', payload };
176
+ }
177
+ }
178
+
179
+ return { valid: true, reason: null, payload };
180
+ }
181
+
182
+ /**
183
+ * Activates and persists a verified `CTXP1` license key into `~/.ctxtop/license.json`.
184
+ */
185
+ export function activateProLicense(licenseKey = '', options = {}) {
186
+ const check = verifyProLicenseKey(licenseKey, options);
187
+ if (!check.valid) {
188
+ return { ok: false, ...check, licensePath: resolveLicenseFilePath(options) };
189
+ }
190
+ const licensePath = resolveLicenseFilePath(options);
191
+ fs.mkdirSync(path.dirname(licensePath), { recursive: true });
192
+ const record = {
193
+ version: 1,
194
+ licenseKey: String(licenseKey).trim(),
195
+ activatedAt: new Date(options.nowMs || Date.now()).toISOString(),
196
+ payload: check.payload
197
+ };
198
+ fs.writeFileSync(licensePath, JSON.stringify(record, null, 2) + '\n', 'utf8');
199
+ return {
200
+ ok: true,
201
+ valid: true,
202
+ tier: check.payload.tier || 'pro',
203
+ payload: check.payload,
204
+ licensePath
205
+ };
206
+ }
207
+
208
+ /**
209
+ * Starts a 14-day zero-network local trial stored in `~/.ctxtop/license.json`.
210
+ */
211
+ export function activateLocalTrial(options = {}) {
212
+ const licensePath = resolveLicenseFilePath(options);
213
+ const nowMs = Number(options.nowMs || Date.now());
214
+ const expiresAt = new Date(nowMs + 14 * 86400 * 1000).toISOString();
215
+ fs.mkdirSync(path.dirname(licensePath), { recursive: true });
216
+ const record = {
217
+ version: 1,
218
+ trial: true,
219
+ activatedAt: new Date(nowMs).toISOString(),
220
+ expiresAt,
221
+ payload: {
222
+ v: 1,
223
+ tier: 'trial',
224
+ email: 'trial@local',
225
+ seats: 1,
226
+ issuedAt: new Date(nowMs).toISOString(),
227
+ expiresAt,
228
+ source: 'local_trial'
229
+ }
230
+ };
231
+ fs.writeFileSync(licensePath, JSON.stringify(record, null, 2) + '\n', 'utf8');
232
+ return {
233
+ ok: true,
234
+ tier: 'trial',
235
+ expiresAt,
236
+ licensePath
237
+ };
238
+ }
239
+
240
+ export function deactivateProLicense(options = {}) {
241
+ const licensePath = resolveLicenseFilePath(options);
242
+ const existed = fs.existsSync(licensePath);
243
+ if (existed) {
244
+ try {
245
+ fs.unlinkSync(licensePath);
246
+ } catch (_err) {
247
+ void _err;
248
+ }
249
+ }
250
+ return { ok: true, removed: existed, licensePath };
251
+ }
252
+
253
+ /**
254
+ * Evaluates current Pro entitlement across both Antigravity and Claude Code.
255
+ * Supports automatic dev/test bypass unless `options.strict === true`.
256
+ */
257
+ export function getProEntitlementStatus(options = {}) {
258
+ const licensePath = resolveLicenseFilePath(options);
259
+ const nowMs = Number(options.nowMs || Date.now());
260
+ const isDevOrTest =
261
+ !options.strict &&
262
+ Boolean(
263
+ process.env.CTXTOP_PRO_DEV === '1' ||
264
+ process.env.NODE_ENV === 'test' ||
265
+ process.env.NODE_TEST_CONTEXT ||
266
+ process.execArgv?.includes('--test')
267
+ );
268
+
269
+ if (isDevOrTest && !options.licensePath) {
270
+ return {
271
+ entitled: true,
272
+ tier: 'pro_dev_bypass',
273
+ source: 'dev_or_test_bypass',
274
+ isDevOrTestBypass: true,
275
+ licensePath,
276
+ pricing: PRO_PRICING_TIERS
277
+ };
278
+ }
279
+
280
+ if (fs.existsSync(licensePath)) {
281
+ try {
282
+ const stored = JSON.parse(fs.readFileSync(licensePath, 'utf8'));
283
+ if (stored.licenseKey) {
284
+ const verified = verifyProLicenseKey(stored.licenseKey, options);
285
+ if (verified.valid) {
286
+ return {
287
+ entitled: true,
288
+ tier: verified.payload.tier || 'pro',
289
+ source: 'ed25519_license',
290
+ email: verified.payload.email || null,
291
+ expiresAt: verified.payload.expiresAt || null,
292
+ licensePath,
293
+ pricing: PRO_PRICING_TIERS
294
+ };
295
+ }
296
+ return {
297
+ entitled: false,
298
+ tier: 'free',
299
+ source: 'invalid_or_expired_license',
300
+ reason: verified.reason,
301
+ licensePath,
302
+ pricing: PRO_PRICING_TIERS
303
+ };
304
+ }
305
+ if (stored.trial && stored.expiresAt) {
306
+ const expMs = Date.parse(stored.expiresAt);
307
+ if (Number.isFinite(expMs) && nowMs <= expMs) {
308
+ return {
309
+ entitled: true,
310
+ tier: 'trial',
311
+ source: 'local_trial',
312
+ expiresAt: stored.expiresAt,
313
+ daysRemaining: Math.max(1, Math.ceil((expMs - nowMs) / 86400000)),
314
+ licensePath,
315
+ pricing: PRO_PRICING_TIERS
316
+ };
317
+ }
318
+ }
319
+ } catch (_err) {
320
+ void _err;
321
+ }
322
+ }
323
+
324
+ if (isDevOrTest) {
325
+ return {
326
+ entitled: true,
327
+ tier: 'pro_dev_bypass',
328
+ source: 'dev_or_test_bypass',
329
+ isDevOrTestBypass: true,
330
+ licensePath,
331
+ pricing: PRO_PRICING_TIERS
332
+ };
333
+ }
334
+
335
+ return {
336
+ entitled: false,
337
+ tier: 'free',
338
+ source: 'free_core',
339
+ licensePath,
340
+ pricing: PRO_PRICING_TIERS
341
+ };
342
+ }
343
+
344
+ /**
345
+ * Evaluates whether a specific commercial Pro or Team feature is permitted.
346
+ * Preserves automatic dev/test bypass unless `options.strict === true`.
347
+ *
348
+ * @param {string} [featureId='pro_feature']
349
+ * @param {object} [options={}]
350
+ */
351
+ export function requireProFeature(featureId = 'pro_feature', options = {}) {
352
+ const status = getProEntitlementStatus(options);
353
+ const needsTeamTier = featureId === 'team_finops_pack';
354
+ const isDevOrTest =
355
+ !options.strict &&
356
+ Boolean(
357
+ process.env.CTXTOP_PRO_DEV === '1' ||
358
+ process.env.NODE_ENV === 'test' ||
359
+ process.env.NODE_TEST_CONTEXT ||
360
+ process.execArgv?.includes('--test')
361
+ );
362
+
363
+ const allowed = needsTeamTier
364
+ ? Boolean(
365
+ isDevOrTest ||
366
+ (status.entitled &&
367
+ (status.tier === 'team' ||
368
+ status.tier === 'trial' ||
369
+ status.tier === 'pro_dev_bypass' ||
370
+ status.tier === 'ltd'))
371
+ )
372
+ : Boolean(status.entitled);
373
+
374
+ return {
375
+ allowed,
376
+ featureId,
377
+ entitled: status.entitled,
378
+ tier: status.tier,
379
+ source: status.source,
380
+ status,
381
+ upgradeHint: needsTeamTier
382
+ ? 'Requires Highbeam Team ($299/yr for 5 seats) or an active 14-day trial (`npx ctxtop license trial`).'
383
+ : 'Requires Highbeam Pro ($9/mo · $79/yr · $119 LTD) or an active 14-day trial (`npx ctxtop license trial`).'
384
+ };
385
+ }