splithub 0.2.0 → 0.2.2

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 (104) hide show
  1. package/README.md +20 -1
  2. package/dist/chunk-5VFCW4FI.js +75 -0
  3. package/dist/chunk-5VFCW4FI.js.map +1 -0
  4. package/dist/{chunk-3VY5CP3E.js → chunk-6OXCLYOI.js} +3 -2
  5. package/dist/chunk-6OXCLYOI.js.map +1 -0
  6. package/dist/{chunk-HSH4ZI2V.js → chunk-7EB5WOYE.js} +4 -4
  7. package/dist/{chunk-3VACHXWE.js → chunk-AZJEZFOB.js} +14 -7
  8. package/dist/chunk-AZJEZFOB.js.map +1 -0
  9. package/dist/{chunk-3DUWIEHB.js → chunk-BQAWJPIK.js} +10 -4
  10. package/dist/chunk-BQAWJPIK.js.map +1 -0
  11. package/dist/{chunk-PWSRKABE.js → chunk-BSWCWCYP.js} +3 -3
  12. package/dist/{chunk-GVARYUL3.js → chunk-D7KVM4L7.js} +2 -2
  13. package/dist/{chunk-C5S7RPYM.js → chunk-ECV5QR6H.js} +5 -5
  14. package/dist/{chunk-V3DLUVOE.js → chunk-EJC4E3VD.js} +7 -2
  15. package/dist/{chunk-V3DLUVOE.js.map → chunk-EJC4E3VD.js.map} +1 -1
  16. package/dist/chunk-IFCSJYXN.js +264 -0
  17. package/dist/chunk-IFCSJYXN.js.map +1 -0
  18. package/dist/{chunk-YSXW2HN6.js → chunk-IGYK7N2F.js} +21 -6
  19. package/dist/chunk-IGYK7N2F.js.map +1 -0
  20. package/dist/{chunk-QOXGIB3R.js → chunk-LK3NRAHA.js} +14 -13
  21. package/dist/chunk-LK3NRAHA.js.map +1 -0
  22. package/dist/{chunk-EYYLDI5J.js → chunk-NTAIRQP6.js} +3 -3
  23. package/dist/{chunk-PLXDG4B5.js → chunk-PLZRB3VX.js} +2 -2
  24. package/dist/{chunk-UUTLLC54.js → chunk-VKLZJRYW.js} +57 -56
  25. package/dist/chunk-VKLZJRYW.js.map +1 -0
  26. package/dist/{chunk-AJO3C4BS.js → chunk-X5AV7YBR.js} +27 -10
  27. package/dist/chunk-X5AV7YBR.js.map +1 -0
  28. package/dist/{chunk-A2RCSPG6.js → chunk-XVWJZJSF.js} +6 -5
  29. package/dist/chunk-XVWJZJSF.js.map +1 -0
  30. package/dist/{chunk-EUF75FUC.js → chunk-ZND3T67D.js} +31 -10
  31. package/dist/chunk-ZND3T67D.js.map +1 -0
  32. package/dist/{ci-ZQZ6RBUJ.js → ci-4OC23DTI.js} +4 -4
  33. package/dist/create-NCBDS2YG.js +18 -0
  34. package/dist/dev-7FXVGFL6.js +11 -0
  35. package/dist/doctor-E4KLPZZI.js +14 -0
  36. package/dist/{holdout-PECSNGAD.js → holdout-OKHR2CKW.js} +4 -4
  37. package/dist/index.js +37 -28
  38. package/dist/index.js.map +1 -1
  39. package/dist/init-PFNPS6XO.js +15 -0
  40. package/dist/lifecycle-G7OAC4ZZ.js +12 -0
  41. package/dist/{login-TTWSQ7XS.js → login-ZEIH7KIH.js} +4 -4
  42. package/dist/{menu-UQX3K5QR.js → menu-4X5S37OK.js} +23 -22
  43. package/dist/{menu-UQX3K5QR.js.map → menu-4X5S37OK.js.map} +1 -1
  44. package/dist/plan-QLYHRYCV.js +71 -0
  45. package/dist/plan-QLYHRYCV.js.map +1 -0
  46. package/dist/push-3NDLL7US.js +16 -0
  47. package/dist/{refs-ZDNH6NRK.js → refs-IWZ5GP7Q.js} +5 -5
  48. package/dist/{remove-KFQUK367.js → remove-YDJ7JTPR.js} +6 -6
  49. package/dist/report-JS7Z42FD.js +58 -0
  50. package/dist/report-JS7Z42FD.js.map +1 -0
  51. package/dist/results-HCXQH7IY.js +17 -0
  52. package/dist/{review-EIZDOGDC.js → review-BGGNVL6L.js} +3 -3
  53. package/dist/{ship-4YX2WCBP.js → ship-C22SGFUD.js} +6 -6
  54. package/dist/skills-UBPQOTDQ.js +18 -0
  55. package/dist/status-6IODQYHV.js +12 -0
  56. package/dist/update-SAHMBHIZ.js +37 -0
  57. package/dist/update-SAHMBHIZ.js.map +1 -0
  58. package/package.json +4 -5
  59. package/dist/chunk-3DUWIEHB.js.map +0 -1
  60. package/dist/chunk-3VACHXWE.js.map +0 -1
  61. package/dist/chunk-3VY5CP3E.js.map +0 -1
  62. package/dist/chunk-74NI7BED.js +0 -58
  63. package/dist/chunk-74NI7BED.js.map +0 -1
  64. package/dist/chunk-A2RCSPG6.js.map +0 -1
  65. package/dist/chunk-AJO3C4BS.js.map +0 -1
  66. package/dist/chunk-EUF75FUC.js.map +0 -1
  67. package/dist/chunk-QOXGIB3R.js.map +0 -1
  68. package/dist/chunk-UUTLLC54.js.map +0 -1
  69. package/dist/chunk-YSXW2HN6.js.map +0 -1
  70. package/dist/create-K75OY6XK.js +0 -18
  71. package/dist/dev-WQWFEA6I.js +0 -11
  72. package/dist/doctor-MFYBZUKO.js +0 -13
  73. package/dist/init-QAAM2GQ7.js +0 -15
  74. package/dist/lifecycle-56HM7ITG.js +0 -12
  75. package/dist/plan-BSFSMKTU.js +0 -135
  76. package/dist/plan-BSFSMKTU.js.map +0 -1
  77. package/dist/push-YVS25VVD.js +0 -16
  78. package/dist/report-TF2BLJMC.js +0 -64
  79. package/dist/report-TF2BLJMC.js.map +0 -1
  80. package/dist/results-TLV5KJWO.js +0 -17
  81. package/dist/skills-HWQT3DTJ.js +0 -13
  82. package/dist/status-CWI7ZCYJ.js +0 -11
  83. /package/dist/{chunk-HSH4ZI2V.js.map → chunk-7EB5WOYE.js.map} +0 -0
  84. /package/dist/{chunk-PWSRKABE.js.map → chunk-BSWCWCYP.js.map} +0 -0
  85. /package/dist/{chunk-GVARYUL3.js.map → chunk-D7KVM4L7.js.map} +0 -0
  86. /package/dist/{chunk-C5S7RPYM.js.map → chunk-ECV5QR6H.js.map} +0 -0
  87. /package/dist/{chunk-EYYLDI5J.js.map → chunk-NTAIRQP6.js.map} +0 -0
  88. /package/dist/{chunk-PLXDG4B5.js.map → chunk-PLZRB3VX.js.map} +0 -0
  89. /package/dist/{ci-ZQZ6RBUJ.js.map → ci-4OC23DTI.js.map} +0 -0
  90. /package/dist/{create-K75OY6XK.js.map → create-NCBDS2YG.js.map} +0 -0
  91. /package/dist/{dev-WQWFEA6I.js.map → dev-7FXVGFL6.js.map} +0 -0
  92. /package/dist/{doctor-MFYBZUKO.js.map → doctor-E4KLPZZI.js.map} +0 -0
  93. /package/dist/{holdout-PECSNGAD.js.map → holdout-OKHR2CKW.js.map} +0 -0
  94. /package/dist/{init-QAAM2GQ7.js.map → init-PFNPS6XO.js.map} +0 -0
  95. /package/dist/{lifecycle-56HM7ITG.js.map → lifecycle-G7OAC4ZZ.js.map} +0 -0
  96. /package/dist/{login-TTWSQ7XS.js.map → login-ZEIH7KIH.js.map} +0 -0
  97. /package/dist/{push-YVS25VVD.js.map → push-3NDLL7US.js.map} +0 -0
  98. /package/dist/{refs-ZDNH6NRK.js.map → refs-IWZ5GP7Q.js.map} +0 -0
  99. /package/dist/{remove-KFQUK367.js.map → remove-YDJ7JTPR.js.map} +0 -0
  100. /package/dist/{results-TLV5KJWO.js.map → results-HCXQH7IY.js.map} +0 -0
  101. /package/dist/{review-EIZDOGDC.js.map → review-BGGNVL6L.js.map} +0 -0
  102. /package/dist/{ship-4YX2WCBP.js.map → ship-C22SGFUD.js.map} +0 -0
  103. /package/dist/{skills-HWQT3DTJ.js.map → skills-UBPQOTDQ.js.map} +0 -0
  104. /package/dist/{status-CWI7ZCYJ.js.map → status-6IODQYHV.js.map} +0 -0
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/commands/push.ts"],"sourcesContent":["import type { SplitHubConfig } from '@splithub/core';\nimport { relative } from 'node:path';\nimport { apiError, cloudTarget, requireCloudToken } from '../api';\nimport { hasExperiment, insertExperiment, loadConfig, readSource, writeConfigChecked } from '../config-file';\nimport { fail, printJson } from '../errors';\nimport { detectProject, requireConfig } from '../project';\nimport { c } from '../ui';\nimport type { Flags } from './init';\n\ninterface CloudExperiment {\n key: string;\n kind: 'component' | 'value' | 'redirect' | 'mvt';\n status: 'draft' | 'running' | 'paused' | 'finished';\n goal: string | null;\n match: string | null;\n description: string | null;\n variants: Array<{ key: string; weight: number; value?: unknown; to?: string; levels?: Record<string, string> }>;\n /** Multivariate: the factors whose combinations the variants are. */\n factors?: Array<{ key: string; levels: string[] }>;\n flow?: unknown;\n traffic?: number;\n maxExposures?: number | null;\n minDays?: number | null;\n schedule?: { startAt?: string | null; endAt?: string | null } | null;\n}\n\ninterface PushResponse {\n ok: boolean;\n project: string;\n version: number;\n pushedAt: string;\n publicKey: string;\n experiments: number;\n /** Experiments created in the dashboard that the local file does not have yet. */\n cloudOnly?: CloudExperiment[];\n}\n\n/** Write dashboard-created experiments into the local config file. Returns the keys written. */\n/** Factor → level → value, read back from the combinations the cloud generated. */\nfunction factorsOf(e: CloudExperiment): Record<string, Record<string, string>> {\n const out: Record<string, Record<string, string>> = {};\n for (const f of e.factors ?? []) {\n out[f.key] = {};\n for (const level of f.levels) {\n const combo = e.variants.find((v) => v.levels?.[f.key] === level);\n const value = (combo?.value as Record<string, unknown> | undefined)?.[f.key];\n out[f.key]![level] = typeof value === 'string' ? value : value === undefined ? level : JSON.stringify(value);\n }\n }\n return out;\n}\n\nasync function adoptCloudExperiments(file: string, cloudOnly: CloudExperiment[] | undefined): Promise<string[]> {\n if (!cloudOnly || cloudOnly.length === 0) return [];\n const original = readSource(file);\n let source = original;\n const written: string[] = [];\n for (const e of cloudOnly) {\n if (hasExperiment(source, e.key)) continue;\n const total = e.variants.reduce((s, v) => s + v.weight, 0) || 1;\n source = insertExperiment(source, {\n key: e.key,\n kind: e.kind,\n status: e.status,\n goal: e.goal ?? undefined,\n match: e.match ?? undefined,\n description: e.description ?? undefined,\n flow: e.flow ?? undefined,\n traffic: e.traffic,\n maxExposures: e.maxExposures ?? undefined,\n minDays: e.minDays ?? undefined,\n schedule: e.schedule ?? undefined,\n variants: e.variants.map((v) => ({ key: v.key, weight: Math.round((v.weight / total) * 100), value: typeof v.value === 'string' ? v.value : v.value === undefined ? undefined : JSON.stringify(v.value), to: v.to })),\n ...(e.kind === 'mvt' && e.factors ? { factors: factorsOf(e) } : {}),\n });\n written.push(e.key);\n }\n if (written.length) {\n await writeConfigChecked(file, original, source, (config) => {\n const missing = written.filter((k) => !config.experiments.some((x) => x.key === k));\n return missing.length ? `${missing.join(', ')} did not load back` : null;\n });\n }\n return written;\n}\n\ntype LocalExperiment = SplitHubConfig['experiments'][number];\n\nexport interface ConfigDiff {\n added: string[];\n removed: string[];\n changed: Array<{ experiment: string; fields: string[] }>;\n}\n\n/** What a push would change in the cloud, by experiment key. */\nexport function configDiff(local: LocalExperiment[], cloud: Array<CloudExperiment & { origin?: string }>): ConfigDiff {\n const added = local.filter((e) => !cloud.some((x) => x.key === e.key)).map((e) => e.key);\n const removed = cloud.filter((x) => x.origin !== 'dashboard' && !local.some((e) => e.key === x.key)).map((x) => x.key);\n const changed: ConfigDiff['changed'] = [];\n for (const e of local) {\n const x = cloud.find((y) => y.key === e.key);\n if (!x) continue;\n const fields: string[] = [];\n if (x.status !== e.status) fields.push('status');\n if ((x.goal ?? null) !== (e.goal ?? null)) fields.push('goal');\n if (x.kind !== e.kind) fields.push('kind');\n if (x.variants.map((v) => `${v.key}:${v.weight}`).join() !== e.variants.map((v) => `${v.key}:${v.weight}`).join()) fields.push('variants');\n if ((x.traffic ?? 1) !== (e.traffic ?? 1)) fields.push('traffic');\n if (fields.length) changed.push({ experiment: e.key, fields });\n }\n return { added, removed, changed };\n}\n\nasync function cloudFetch(url: string, init: RequestInit): Promise<Response> {\n try {\n return await fetch(url, init);\n } catch (error) {\n fail('UNREACHABLE', `Can't reach ${url}: ${error instanceof Error ? error.message : String(error)}.`, 'Check your connection, or --api / SPLITHUB_API.');\n }\n}\n\n/**\n * `splithub push`: upload the normalized splithub.config.ts to SplitHub Cloud.\n * Needs a project API key (sk_...) via --token or SPLITHUB_API_KEY. The first\n * push returns the public key (pk_...) which is written into the config's\n * `storage.key` when it is still empty. `--dry-run` only checks and compares.\n */\nexport async function push(flags: Flags): Promise<void> {\n const project = requireConfig();\n const config = await loadConfig(project.configFile);\n if (flags['dry-run']) return dryRun(flags, config);\n if (config.storage.mode !== 'cloud') {\n fail('NOT_CLOUD', `This project stores events itself (storage.mode is \"${config.storage.mode}\"), so there's nothing to push.`, \"Set storage: { mode: 'cloud' } in splithub.config.ts to use SplitHub Cloud.\");\n }\n const target = requireCloudToken(flags);\n\n const res = await cloudFetch(`${target.url}/config`, {\n method: 'PUT',\n headers: { authorization: `Bearer ${target.token}`, 'content-type': 'application/json' },\n body: JSON.stringify({ config }),\n });\n const body = (await res.json().catch(() => ({}))) as Partial<PushResponse> & { error?: string };\n if (!res.ok) throw apiError(res.status, body, `${target.url}/config responded ${res.status}`);\n\n // Write the public key into the config when it is missing.\n let keyWritten = false;\n if (body.publicKey && !config.storage.key) {\n const source = readSource(project.configFile);\n const updated = source.replace(/(mode\\s*:\\s*['\"]cloud['\"]\\s*)(,?)(\\s*\\})/, (_m, a: string, _comma: string, b: string) => `${a}, key: '${body.publicKey}'${b}`);\n if (updated !== source) {\n await writeConfigChecked(project.configFile, source, updated, (loaded) => (loaded.storage.mode === 'cloud' && loaded.storage.key === body.publicKey ? null : 'storage.key did not load back'));\n keyWritten = true;\n }\n }\n\n const adopted = await adoptCloudExperiments(project.configFile, body.cloudOnly);\n const out = { ...body, configFile: relative(project.root, project.configFile), keyWritten, adopted };\n if (flags.json) {\n printJson(out);\n return;\n }\n console.log(`${c.green('✔')} pushed ${c.bold(String(body.project))} v${body.version} · ${body.experiments} experiment(s) → ${target.url}`);\n if (adopted.length) console.log(`${c.green('✔')} written into ${out.configFile} from the dashboard: ${adopted.join(', ')} (wire them in code if they are value/component experiments)`);\n if (body.publicKey) {\n console.log(keyWritten ? `${c.green('✔')} public key written to ${out.configFile}` : `${c.dim('public key:')} ${body.publicKey}`);\n if (!keyWritten && !config.storage.key) console.log(c.yellow(`Add it to splithub.config.ts: storage: { mode: 'cloud', key: '${body.publicKey}' }`));\n }\n}\n\n/** `push --dry-run`: the config loads; when connected, what a push would change. Writes nothing. */\nasync function dryRun(flags: Flags, config: SplitHubConfig): Promise<void> {\n const experiments = config.experiments.map((e) => ({ experiment: e.key, kind: e.kind, status: e.status, goal: e.goal ?? null }));\n let diff: ConfigDiff | null = null;\n let cloud: 'compared' | 'not connected' | 'self mode' = config.storage.mode === 'cloud' ? 'not connected' : 'self mode';\n if (config.storage.mode === 'cloud') {\n const target = cloudTarget(flags);\n if (target.token) {\n const res = await cloudFetch(`${target.url}/config`, { headers: { authorization: `Bearer ${target.token}` } });\n const body = (await res.json().catch(() => ({}))) as { config?: { experiments?: CloudExperiment[] } };\n if (res.status === 404 || res.status === 409) diff = configDiff(config.experiments, []);\n else if (!res.ok) throw apiError(res.status, body, `${target.url}/config responded ${res.status}`);\n else diff = configDiff(config.experiments, body.config?.experiments ?? []);\n cloud = 'compared';\n }\n }\n const out = { ok: true, dryRun: true, mode: config.storage.mode, project: config.project, experiments, cloud, diff };\n if (flags.json) {\n printJson(out);\n return;\n }\n console.log(`${c.green('✔')} config loads · ${experiments.length} experiment(s) · ${config.storage.mode} mode`);\n if (!diff) console.log(c.dim(cloud === 'self mode' ? 'Self mode: nothing to push.' : 'Not connected, so nothing to compare. Run npx splithub login.'));\n else if (!diff.added.length && !diff.removed.length && !diff.changed.length) console.log(c.dim('The cloud already has this config.'));\n else {\n for (const k of diff.added) console.log(`${c.green('+')} ${k}`);\n for (const k of diff.removed) console.log(`${c.red('-')} ${k}`);\n for (const ch of diff.changed) console.log(`${c.yellow('~')} ${ch.experiment} ${c.dim(`(${ch.fields.join(', ')})`)}`);\n }\n}\n\n/** `splithub pull`: print the config stored in the cloud (for inspection or recovery). */\nexport async function pull(flags: Flags): Promise<void> {\n const target = requireCloudToken(flags);\n const res = await cloudFetch(`${target.url}/config`, { headers: { authorization: `Bearer ${target.token}` } });\n const body = (await res.json().catch(() => ({}))) as { error?: string; config?: { experiments?: Array<CloudExperiment & { origin?: string }> }; version?: number; pushedAt?: string; publicKey?: string };\n if (!res.ok) throw apiError(res.status, body, `${target.url}/config responded ${res.status}`);\n const project = detectProject();\n const dashboardOnes = (body.config?.experiments ?? []).filter((e) => e.origin === 'dashboard');\n const adopted = project.configFile ? await adoptCloudExperiments(project.configFile, dashboardOnes) : [];\n if (flags.json) {\n printJson({ ...body, adopted });\n return;\n }\n console.log(`${c.bold('cloud config')} v${body.version} ${c.dim(`pushed ${body.pushedAt}`)} · public key ${body.publicKey}`);\n if (adopted.length) console.log(`${c.green('✔')} written into ${relative(project.root, project.configFile ?? '')}: ${adopted.join(', ')}`);\n else if (dashboardOnes.length) console.log(c.dim(`dashboard experiments already present locally: ${dashboardOnes.map((e) => e.key).join(', ')}`));\n else console.log(c.dim('no dashboard-created experiments to pull'));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AACA,SAAS,gBAAgB;AAsCzB,SAAS,UAAU,GAA4D;AAC7E,QAAM,MAA8C,CAAC;AACrD,aAAW,KAAK,EAAE,WAAW,CAAC,GAAG;AAC/B,QAAI,EAAE,GAAG,IAAI,CAAC;AACd,eAAW,SAAS,EAAE,QAAQ;AAC5B,YAAM,QAAQ,EAAE,SAAS,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,KAAK;AAChE,YAAM,QAAS,OAAO,QAAgD,EAAE,GAAG;AAC3E,UAAI,EAAE,GAAG,EAAG,KAAK,IAAI,OAAO,UAAU,WAAW,QAAQ,UAAU,SAAY,QAAQ,KAAK,UAAU,KAAK;AAAA,IAC7G;AAAA,EACF;AACA,SAAO;AACT;AAEA,eAAe,sBAAsB,MAAc,WAA6D;AAC9G,MAAI,CAAC,aAAa,UAAU,WAAW,EAAG,QAAO,CAAC;AAClD,QAAM,WAAW,WAAW,IAAI;AAChC,MAAI,SAAS;AACb,QAAM,UAAoB,CAAC;AAC3B,aAAW,KAAK,WAAW;AACzB,QAAI,cAAc,QAAQ,EAAE,GAAG,EAAG;AAClC,UAAM,QAAQ,EAAE,SAAS,OAAO,CAAC,GAAG,MAAM,IAAI,EAAE,QAAQ,CAAC,KAAK;AAC9D,aAAS,iBAAiB,QAAQ;AAAA,MAChC,KAAK,EAAE;AAAA,MACP,MAAM,EAAE;AAAA,MACR,QAAQ,EAAE;AAAA,MACV,MAAM,EAAE,QAAQ;AAAA,MAChB,OAAO,EAAE,SAAS;AAAA,MAClB,aAAa,EAAE,eAAe;AAAA,MAC9B,MAAM,EAAE,QAAQ;AAAA,MAChB,SAAS,EAAE;AAAA,MACX,cAAc,EAAE,gBAAgB;AAAA,MAChC,SAAS,EAAE,WAAW;AAAA,MACtB,UAAU,EAAE,YAAY;AAAA,MACxB,UAAU,EAAE,SAAS,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,QAAQ,KAAK,MAAO,EAAE,SAAS,QAAS,GAAG,GAAG,OAAO,OAAO,EAAE,UAAU,WAAW,EAAE,QAAQ,EAAE,UAAU,SAAY,SAAY,KAAK,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE;AAAA,MACpN,GAAI,EAAE,SAAS,SAAS,EAAE,UAAU,EAAE,SAAS,UAAU,CAAC,EAAE,IAAI,CAAC;AAAA,IACnE,CAAC;AACD,YAAQ,KAAK,EAAE,GAAG;AAAA,EACpB;AACA,MAAI,QAAQ,QAAQ;AAClB,UAAM,mBAAmB,MAAM,UAAU,QAAQ,CAAC,WAAW;AAC3D,YAAM,UAAU,QAAQ,OAAO,CAAC,MAAM,CAAC,OAAO,YAAY,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAClF,aAAO,QAAQ,SAAS,GAAG,QAAQ,KAAK,IAAI,CAAC,uBAAuB;AAAA,IACtE,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAWO,SAAS,WAAW,OAA0B,OAAiE;AACpH,QAAM,QAAQ,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG;AACvF,QAAM,UAAU,MAAM,OAAO,CAAC,MAAM,EAAE,WAAW,eAAe,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG;AACrH,QAAM,UAAiC,CAAC;AACxC,aAAW,KAAK,OAAO;AACrB,UAAM,IAAI,MAAM,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG;AAC3C,QAAI,CAAC,EAAG;AACR,UAAM,SAAmB,CAAC;AAC1B,QAAI,EAAE,WAAW,EAAE,OAAQ,QAAO,KAAK,QAAQ;AAC/C,SAAK,EAAE,QAAQ,WAAW,EAAE,QAAQ,MAAO,QAAO,KAAK,MAAM;AAC7D,QAAI,EAAE,SAAS,EAAE,KAAM,QAAO,KAAK,MAAM;AACzC,QAAI,EAAE,SAAS,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,MAAM,EAAE,SAAS,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAG,QAAO,KAAK,UAAU;AACzI,SAAK,EAAE,WAAW,QAAQ,EAAE,WAAW,GAAI,QAAO,KAAK,SAAS;AAChE,QAAI,OAAO,OAAQ,SAAQ,KAAK,EAAE,YAAY,EAAE,KAAK,OAAO,CAAC;AAAA,EAC/D;AACA,SAAO,EAAE,OAAO,SAAS,QAAQ;AACnC;AAEA,eAAe,WAAW,KAAa,MAAsC;AAC3E,MAAI;AACF,WAAO,MAAM,MAAM,KAAK,IAAI;AAAA,EAC9B,SAAS,OAAO;AACd,SAAK,eAAe,eAAe,GAAG,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC,KAAK,iDAAiD;AAAA,EACzJ;AACF;AAQA,eAAsB,KAAK,OAA6B;AACtD,QAAM,UAAU,cAAc;AAC9B,QAAM,SAAS,MAAM,WAAW,QAAQ,UAAU;AAClD,MAAI,MAAM,SAAS,EAAG,QAAO,OAAO,OAAO,MAAM;AACjD,MAAI,OAAO,QAAQ,SAAS,SAAS;AACnC,SAAK,aAAa,uDAAuD,OAAO,QAAQ,IAAI,mCAAmC,6EAA6E;AAAA,EAC9M;AACA,QAAM,SAAS,kBAAkB,KAAK;AAEtC,QAAM,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW;AAAA,IACnD,QAAQ;AAAA,IACR,SAAS,EAAE,eAAe,UAAU,OAAO,KAAK,IAAI,gBAAgB,mBAAmB;AAAA,IACvF,MAAM,KAAK,UAAU,EAAE,OAAO,CAAC;AAAA,EACjC,CAAC;AACD,QAAM,OAAQ,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAC/C,MAAI,CAAC,IAAI,GAAI,OAAM,SAAS,IAAI,QAAQ,MAAM,GAAG,OAAO,GAAG,qBAAqB,IAAI,MAAM,EAAE;AAG5F,MAAI,aAAa;AACjB,MAAI,KAAK,aAAa,CAAC,OAAO,QAAQ,KAAK;AACzC,UAAM,SAAS,WAAW,QAAQ,UAAU;AAC5C,UAAM,UAAU,OAAO,QAAQ,4CAA4C,CAAC,IAAI,GAAW,QAAgB,MAAc,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,EAAE;AAC7J,QAAI,YAAY,QAAQ;AACtB,YAAM,mBAAmB,QAAQ,YAAY,QAAQ,SAAS,CAAC,WAAY,OAAO,QAAQ,SAAS,WAAW,OAAO,QAAQ,QAAQ,KAAK,YAAY,OAAO,+BAAgC;AAC7L,mBAAa;AAAA,IACf;AAAA,EACF;AAEA,QAAM,UAAU,MAAM,sBAAsB,QAAQ,YAAY,KAAK,SAAS;AAC9E,QAAM,MAAM,EAAE,GAAG,MAAM,YAAY,SAAS,QAAQ,MAAM,QAAQ,UAAU,GAAG,YAAY,QAAQ;AACnG,MAAI,MAAM,MAAM;AACd,cAAU,GAAG;AACb;AAAA,EACF;AACA,UAAQ,IAAI,GAAG,EAAE,MAAM,QAAG,CAAC,WAAW,EAAE,KAAK,OAAO,KAAK,OAAO,CAAC,CAAC,KAAK,KAAK,OAAO,SAAM,KAAK,WAAW,yBAAoB,OAAO,GAAG,EAAE;AACzI,MAAI,QAAQ,OAAQ,SAAQ,IAAI,GAAG,EAAE,MAAM,QAAG,CAAC,iBAAiB,IAAI,UAAU,wBAAwB,QAAQ,KAAK,IAAI,CAAC,8DAA8D;AACtL,MAAI,KAAK,WAAW;AAClB,YAAQ,IAAI,aAAa,GAAG,EAAE,MAAM,QAAG,CAAC,0BAA0B,IAAI,UAAU,KAAK,GAAG,EAAE,IAAI,aAAa,CAAC,IAAI,KAAK,SAAS,EAAE;AAChI,QAAI,CAAC,cAAc,CAAC,OAAO,QAAQ,IAAK,SAAQ,IAAI,EAAE,OAAO,iEAAiE,KAAK,SAAS,KAAK,CAAC;AAAA,EACpJ;AACF;AAGA,eAAe,OAAO,OAAc,QAAuC;AACzE,QAAM,cAAc,OAAO,YAAY,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,QAAQ,EAAE,QAAQ,MAAM,EAAE,QAAQ,KAAK,EAAE;AAC/H,MAAI,OAA0B;AAC9B,MAAI,QAAoD,OAAO,QAAQ,SAAS,UAAU,kBAAkB;AAC5G,MAAI,OAAO,QAAQ,SAAS,SAAS;AACnC,UAAM,SAAS,YAAY,KAAK;AAChC,QAAI,OAAO,OAAO;AAChB,YAAM,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,EAAE,SAAS,EAAE,eAAe,UAAU,OAAO,KAAK,GAAG,EAAE,CAAC;AAC7G,YAAM,OAAQ,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAC/C,UAAI,IAAI,WAAW,OAAO,IAAI,WAAW,IAAK,QAAO,WAAW,OAAO,aAAa,CAAC,CAAC;AAAA,eAC7E,CAAC,IAAI,GAAI,OAAM,SAAS,IAAI,QAAQ,MAAM,GAAG,OAAO,GAAG,qBAAqB,IAAI,MAAM,EAAE;AAAA,UAC5F,QAAO,WAAW,OAAO,aAAa,KAAK,QAAQ,eAAe,CAAC,CAAC;AACzE,cAAQ;AAAA,IACV;AAAA,EACF;AACA,QAAM,MAAM,EAAE,IAAI,MAAM,QAAQ,MAAM,MAAM,OAAO,QAAQ,MAAM,SAAS,OAAO,SAAS,aAAa,OAAO,KAAK;AACnH,MAAI,MAAM,MAAM;AACd,cAAU,GAAG;AACb;AAAA,EACF;AACA,UAAQ,IAAI,GAAG,EAAE,MAAM,QAAG,CAAC,sBAAmB,YAAY,MAAM,uBAAoB,OAAO,QAAQ,IAAI,OAAO;AAC9G,MAAI,CAAC,KAAM,SAAQ,IAAI,EAAE,IAAI,UAAU,cAAc,gCAAgC,+DAA+D,CAAC;AAAA,WAC5I,CAAC,KAAK,MAAM,UAAU,CAAC,KAAK,QAAQ,UAAU,CAAC,KAAK,QAAQ,OAAQ,SAAQ,IAAI,EAAE,IAAI,oCAAoC,CAAC;AAAA,OAC/H;AACH,eAAW,KAAK,KAAK,MAAO,SAAQ,IAAI,GAAG,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE;AAC9D,eAAW,KAAK,KAAK,QAAS,SAAQ,IAAI,GAAG,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE;AAC9D,eAAW,MAAM,KAAK,QAAS,SAAQ,IAAI,GAAG,EAAE,OAAO,GAAG,CAAC,IAAI,GAAG,UAAU,IAAI,EAAE,IAAI,IAAI,GAAG,OAAO,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE;AAAA,EACtH;AACF;AAGA,eAAsB,KAAK,OAA6B;AACtD,QAAM,SAAS,kBAAkB,KAAK;AACtC,QAAM,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,WAAW,EAAE,SAAS,EAAE,eAAe,UAAU,OAAO,KAAK,GAAG,EAAE,CAAC;AAC7G,QAAM,OAAQ,MAAM,IAAI,KAAK,EAAE,MAAM,OAAO,CAAC,EAAE;AAC/C,MAAI,CAAC,IAAI,GAAI,OAAM,SAAS,IAAI,QAAQ,MAAM,GAAG,OAAO,GAAG,qBAAqB,IAAI,MAAM,EAAE;AAC5F,QAAM,UAAU,cAAc;AAC9B,QAAM,iBAAiB,KAAK,QAAQ,eAAe,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,WAAW,WAAW;AAC7F,QAAM,UAAU,QAAQ,aAAa,MAAM,sBAAsB,QAAQ,YAAY,aAAa,IAAI,CAAC;AACvG,MAAI,MAAM,MAAM;AACd,cAAU,EAAE,GAAG,MAAM,QAAQ,CAAC;AAC9B;AAAA,EACF;AACA,UAAQ,IAAI,GAAG,EAAE,KAAK,cAAc,CAAC,KAAK,KAAK,OAAO,IAAI,EAAE,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC,oBAAiB,KAAK,SAAS,EAAE;AAC3H,MAAI,QAAQ,OAAQ,SAAQ,IAAI,GAAG,EAAE,MAAM,QAAG,CAAC,iBAAiB,SAAS,QAAQ,MAAM,QAAQ,cAAc,EAAE,CAAC,KAAK,QAAQ,KAAK,IAAI,CAAC,EAAE;AAAA,WAChI,cAAc,OAAQ,SAAQ,IAAI,EAAE,IAAI,kDAAkD,cAAc,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;AAAA,MAC3I,SAAQ,IAAI,EAAE,IAAI,0CAA0C,CAAC;AACpE;","names":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/commands/skills.ts"],"sourcesContent":["// `splithub skills [--mcp] [--force]`: install or refresh the agent skills in\n// this project (.claude/skills/<name>/SKILL.md, .cursor/rules/splithub.mdc,\n// an AGENTS.md section) and, with --mcp, register the SplitHub MCP server in\n// .mcp.json (Claude Code) and .cursor/mcp.json (Cursor). `init` calls this too.\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { dirname, join, relative } from 'node:path';\nimport { detectProject } from '../project';\nimport { AGENTS_SECTION, CURSOR_RULE } from '../templates';\nimport { MCP_SERVER_ENTRY, SKILLS } from '../skills';\nimport { c } from '../ui';\nimport type { Flags } from './init';\n\nexport interface SkillsResult {\n written: string[];\n skipped: string[];\n mcp: string[];\n}\n\nfunction writeFile(file: string, content: string, force: boolean, out: SkillsResult): void {\n if (existsSync(file) && !force) {\n const current = readFileSync(file, 'utf8');\n if (current === content) {\n out.skipped.push(file);\n return;\n }\n // Skills we wrote earlier get refreshed; a user-edited file is left alone unless --force.\n if (!/SplitHub|splithub/.test(current)) {\n out.skipped.push(file);\n return;\n }\n }\n mkdirSync(dirname(file), { recursive: true });\n writeFileSync(file, content, 'utf8');\n out.written.push(file);\n}\n\n/** Merge our server into an MCP config file ({ mcpServers: {...} }) without touching other entries. */\nfunction registerMcp(file: string, out: SkillsResult): void {\n let json: { mcpServers?: Record<string, unknown> } = {};\n if (existsSync(file)) {\n try {\n json = JSON.parse(readFileSync(file, 'utf8')) as typeof json;\n } catch {\n out.skipped.push(`${file} (not valid JSON, left untouched)`);\n return;\n }\n }\n const servers = json.mcpServers ?? {};\n if (JSON.stringify(servers.splithub) === JSON.stringify(MCP_SERVER_ENTRY)) {\n out.skipped.push(file);\n return;\n }\n json.mcpServers = { ...servers, splithub: MCP_SERVER_ENTRY };\n mkdirSync(dirname(file), { recursive: true });\n writeFileSync(file, JSON.stringify(json, null, 2) + '\\n', 'utf8');\n out.mcp.push(file);\n}\n\nexport function installSkills(root: string, options: { mcp?: boolean; force?: boolean } = {}): SkillsResult {\n const out: SkillsResult = { written: [], skipped: [], mcp: [] };\n for (const s of SKILLS) writeFile(join(root, '.claude', 'skills', s.dir, 'SKILL.md'), s.body, Boolean(options.force), out);\n writeFile(join(root, '.cursor', 'rules', 'splithub.mdc'), CURSOR_RULE, Boolean(options.force), out);\n\n const agentsFile = ['AGENTS.md', 'CLAUDE.md'].map((f) => join(root, f)).find((f) => existsSync(f)) ?? join(root, 'AGENTS.md');\n if (!existsSync(agentsFile)) {\n writeFileSync(agentsFile, `# ${detectProject(root).name}\\n${AGENTS_SECTION}`, 'utf8');\n out.written.push(agentsFile);\n } else if (!/SplitHub/.test(readFileSync(agentsFile, 'utf8'))) {\n writeFileSync(agentsFile, readFileSync(agentsFile, 'utf8') + `\\n${AGENTS_SECTION}`, 'utf8');\n out.written.push(`${agentsFile} (section appended)`);\n } else {\n out.skipped.push(agentsFile);\n }\n\n if (options.mcp) {\n registerMcp(join(root, '.mcp.json'), out);\n registerMcp(join(root, '.cursor', 'mcp.json'), out);\n }\n return out;\n}\n\nexport async function skills(flags: Flags): Promise<void> {\n const project = detectProject();\n const result = installSkills(project.root, { mcp: Boolean(flags.mcp), force: Boolean(flags.force) });\n if (flags.json) {\n console.log(JSON.stringify(result));\n return;\n }\n const rel = (f: string) => relative(project.root, f) || f;\n if (result.written.length) console.log(`${c.green('✔')} wrote\\n ${result.written.map(rel).join('\\n ')}`);\n if (result.mcp.length) console.log(`${c.green('✔')} MCP server registered in\\n ${result.mcp.map(rel).join('\\n ')}`);\n if (result.skipped.length) console.log(c.dim(`unchanged: ${result.skipped.map(rel).join(', ')}`));\n if (!flags.mcp) console.log(c.dim(`add --mcp to register the SplitHub MCP server (Claude Code .mcp.json, Cursor .cursor/mcp.json; Codex and Copilot read AGENTS.md)`));\n console.log(c.dim('skills: splithub (library + CLI), ab-testing (how to test well), splithub-api (HTTP API), splithub-mcp (MCP tools), splithub-self-hosted (your own database), splithub-ship (keep the winner, remove the test), splithub-loop (the whole loop, tool by tool)'));\n}\n"],"mappings":"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","names":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/credentials.ts","../src/api.ts"],"sourcesContent":["// Credentials saved by `splithub login`: ~/.config/splithub/credentials.json\n// { \"<api base>\": { \"<project root>\": { apiKey, projectId, projectName, savedAt } } }\n// `cloudTarget` falls back to the entry for the current directory when neither\n// --token nor SPLITHUB_API_KEY is set.\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join, resolve } from 'node:path';\n\nexport interface SavedCredential {\n apiKey: string;\n projectId: string | null;\n projectName: string | null;\n /** Public key of the project (pk_...), written into splithub.config.ts by init. */\n publicKey?: string | null;\n savedAt: string;\n}\n\ntype Store = Record<string, Record<string, SavedCredential>>;\n\nexport function credentialsFile(): string {\n const base = process.env.XDG_CONFIG_HOME || (process.platform === 'win32' ? process.env.APPDATA || join(homedir(), 'AppData', 'Roaming') : join(homedir(), '.config'));\n return join(base, 'splithub', 'credentials.json');\n}\n\nfunction read(): Store {\n const file = credentialsFile();\n if (!existsSync(file)) return {};\n try {\n return JSON.parse(readFileSync(file, 'utf8')) as Store;\n } catch {\n return {};\n }\n}\n\nexport function loadCredential(api: string, root = process.cwd()): SavedCredential | null {\n return read()[api]?.[resolve(root)] ?? null;\n}\n\nexport function saveCredential(api: string, root: string, cred: SavedCredential): string {\n const file = credentialsFile();\n const store = read();\n store[api] = { ...(store[api] ?? {}), [resolve(root)]: cred };\n mkdirSync(join(file, '..'), { recursive: true });\n writeFileSync(file, JSON.stringify(store, null, 2) + '\\n', { mode: 0o600 });\n return file;\n}\n\n/** Every saved credential on this machine: which directory is connected to which project. */\nexport function listCredentials(api?: string): Array<{ api: string; root: string; cred: SavedCredential }> {\n const store = read();\n const out: Array<{ api: string; root: string; cred: SavedCredential }> = [];\n for (const [a, dirs] of Object.entries(store)) {\n if (api && a !== api) continue;\n for (const [root, cred] of Object.entries(dirs)) out.push({ api: a, root, cred });\n }\n return out.sort((x, y) => y.cred.savedAt.localeCompare(x.cred.savedAt));\n}\n\nexport function removeCredential(api: string, root = process.cwd()): boolean {\n const store = read();\n const key = resolve(root);\n if (!store[api]?.[key]) return false;\n delete store[api][key];\n writeFileSync(credentialsFile(), JSON.stringify(store, null, 2) + '\\n', { mode: 0o600 });\n return true;\n}\n","import type { ExperimentResults, StatusRow } from '@splithub/node';\nimport { readFileSync } from 'node:fs';\nimport { loadCredential } from './credentials';\nimport { CliError, fail } from './errors';\nimport type { ProjectInfo } from './project';\n\nexport interface Target {\n url: string;\n token?: string;\n}\n\nexport const CLOUD_API = 'https://go.splithub.io/v1';\n\n/** Storage settings from splithub.config.ts, read textually to avoid loading the config. */\nfunction storageFromConfig(project?: ProjectInfo): { mode: 'self' | 'cloud'; endpoint: string } {\n const fallback = { mode: 'self' as const, endpoint: '/api/splithub' };\n if (!project?.configFile) return fallback;\n try {\n const src = readFileSync(project.configFile, 'utf8');\n const mode = /mode\\s*:\\s*['\"](cloud|self)['\"]/.exec(src)?.[1] as 'self' | 'cloud' | undefined;\n const endpoint = /endpoint\\s*:\\s*['\"]([^'\"]+)['\"]/.exec(src)?.[1];\n return { mode: mode ?? 'self', endpoint: endpoint ?? '/api/splithub' };\n } catch {\n return fallback;\n }\n}\n\n/** Cloud API base + project API key (sk_...). */\nexport function cloudTarget(flags: Record<string, unknown>): Target {\n const url = (typeof flags.api === 'string' && flags.api) || process.env.SPLITHUB_API || CLOUD_API;\n const base = url.replace(/\\/+$/, '');\n const token = (typeof flags.token === 'string' && flags.token) || process.env.SPLITHUB_API_KEY || loadCredential(base)?.apiKey || undefined;\n return { url: base, token };\n}\n\n/**\n * Where to read results from:\n * - --url / SPLITHUB_URL always win;\n * - cloud mode → the cloud API with the project API key;\n * - self mode → the local dev server (3000 for Next.js, 5173 for Vite) + the endpoint from the config.\n */\nexport function resolveTarget(flags: Record<string, unknown>, project?: ProjectInfo): Target {\n const explicit = (typeof flags.url === 'string' && flags.url) || process.env.SPLITHUB_URL;\n const storage = storageFromConfig(project);\n if (!explicit && storage.mode === 'cloud') return cloudTarget(flags);\n const port = project?.framework === 'next' ? 3000 : 5173;\n const url = explicit || `http://localhost:${port}${storage.endpoint}`;\n const token = (typeof flags.token === 'string' && flags.token) || process.env.SPLITHUB_ADMIN_TOKEN || undefined;\n return { url: url.replace(/\\/+$/, ''), token };\n}\n\n/**\n * Readable message from an API error body. Most routes answer `{ error: 'text' }`; the auth layer\n * answers `{ success: false, error: { code, message } }`. Without this the CLI printed \"[object Object]\".\n */\nexport function apiErrorMessage(status: number, body: unknown, fallback: string): string {\n const error = (body as { error?: unknown } | null)?.error;\n const text = typeof error === 'string' ? error : typeof (error as { message?: unknown } | undefined)?.message === 'string' ? (error as { message: string }).message : fallback;\n return status === 401 ? `${text} This folder is not signed in: run npx splithub login (or set SPLITHUB_API_KEY).` : text;\n}\n\n/** CliError for a failed API response: 401 → NOT_LOGGED_IN, 404 on an experiment → EXPERIMENT_NOT_FOUND. */\nexport function apiError(status: number, body: unknown, fallback: string, experiment?: string): CliError {\n const message = apiErrorMessage(status, body, fallback);\n if (status === 401) return new CliError('NOT_LOGGED_IN', message, 'Run npx splithub login (or set SPLITHUB_API_KEY), then retry.');\n const b = body as { code?: unknown; needed?: unknown } | null;\n if (status === 403 && b?.code === 'insufficient_scope') return new CliError('INSUFFICIENT_SCOPE', message, `This API key lacks the \"${typeof b.needed === 'string' ? b.needed : 'write'}\" scope. Create one with it in the dashboard (Settings, API keys) or run npx splithub login --yes.`);\n if (status === 404 && experiment) return new CliError('EXPERIMENT_NOT_FOUND', message, `Check the id with npx splithub status. In cloud mode, push the config first.`);\n return new CliError('API_ERROR', message);\n}\n\nasync function request<T>(target: Target, path: string, init: RequestInit = {}, experiment?: string): Promise<T> {\n const headers: Record<string, string> = { ...((init.headers as Record<string, string> | undefined) ?? {}) };\n if (target.token) headers.authorization = `Bearer ${target.token}`;\n if (init.body) headers['content-type'] = 'application/json';\n let res: Response;\n try {\n res = await fetch(`${target.url}${path}`, { ...init, headers });\n } catch (error) {\n throw new CliError('UNREACHABLE', `Can't reach ${target.url}: ${error instanceof Error ? error.message : String(error)}.`, 'Is your app running? Set --url or SPLITHUB_URL.');\n }\n const body: unknown = await res.json().catch(() => ({}));\n if (!res.ok) throw apiError(res.status, body, `${target.url}${path} responded ${res.status}`, experiment);\n return body as T;\n}\n\n/** Cloud target that must carry an API key. */\nexport function requireCloudToken(flags: Record<string, unknown>): Target & { token: string } {\n const target = cloudTarget(flags);\n if (!target.token) fail('NOT_LOGGED_IN', 'This folder is not connected to SplitHub Cloud.', 'Run npx splithub login, or pass --token sk_... / SPLITHUB_API_KEY.');\n return target as Target & { token: string };\n}\n\n/** PUT /overrides/<experiment>: live status, traffic or weights without a deploy. */\nexport function putOverride(target: Target, experiment: string, body: Record<string, unknown>): Promise<unknown> {\n return request<unknown>(target, `/overrides/${encodeURIComponent(experiment)}`, { method: 'PUT', body: JSON.stringify(body) }, experiment);\n}\n\n/**\n * Apply a status live in cloud mode. Never throws: the config file already changed,\n * so a refused or unreachable cloud is reported, not fatal.\n */\nexport async function applyLiveStatus(flags: Record<string, unknown>, experiment: string, status: string): Promise<string> {\n const target = cloudTarget(flags);\n if (!target.token) return 'no API key (run npx splithub login or set SPLITHUB_API_KEY to apply it without a deploy)';\n try {\n await putOverride(target, experiment, { status });\n return 'applied';\n } catch (error) {\n return `cloud refused: ${error instanceof Error ? error.message : String(error)}`;\n }\n}\n\n/** daysToVerdict: days until a verdict at the current traffic; null when unknown (older servers omit it). */\n/**\n * Archive an experiment in the cloud (PUT /archive/<id>): it stops, keeps its numbers and leaves the\n * active list. Older servers without the route get it finished instead. Never throws.\n */\nexport async function archiveLive(flags: Record<string, unknown>, experiment: string): Promise<string> {\n const target = cloudTarget(flags);\n if (!target.token) return 'no API key (run npx splithub login or set SPLITHUB_API_KEY to archive it in the cloud)';\n try {\n await request<unknown>(target, `/archive/${encodeURIComponent(experiment)}`, { method: 'PUT', body: '{}' });\n return 'archived';\n } catch (error) {\n // 404 from a server without the route (or any non-auth refusal): finishing still stops the test.\n if (error instanceof CliError && (error.code === 'EXPERIMENT_NOT_FOUND' || error.code === 'API_ERROR')) {\n const finished = await applyLiveStatus(flags, experiment, 'finished');\n return finished === 'applied' ? 'finished' : finished;\n }\n return `cloud refused: ${error instanceof Error ? error.message : String(error)}`;\n }\n}\n\nexport type ResultsWithPlan = ExperimentResults & { daysToVerdict?: number | null; visitorsPerDay?: number | null };\nexport type StatusRowWithPlan = StatusRow & { daysToVerdict?: number | null };\n\nexport const fetchStatus = (t: Target) => request<{ project: string; experiments: StatusRowWithPlan[] }>(t, '/status');\nexport const fetchResults = (t: Target, key: string) => request<ResultsWithPlan>(t, `/results/${encodeURIComponent(key)}`, {}, key);\n"],"mappings":"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","names":["readFileSync","readFileSync"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/commands/init.ts","../src/templates-store.ts"],"sourcesContent":["import * as p from '@clack/prompts';\nimport { execSync } from 'node:child_process';\nimport { existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { dirname, join, relative } from 'node:path';\nimport { cloudTarget } from '../api';\nimport { loadCredential } from '../credentials';\nimport { detectProject, installCommand } from '../project';\nimport { deviceLogin } from './login';\nimport { configTemplate, nextMiddlewareTemplate, nextRouteTemplate } from '../templates';\nimport { DB_KINDS, runtimePackages, storeTemplate, storeUsage, type DbKind } from '../templates-store';\nimport { installSkills } from './skills';\nimport { writeWorkflow } from './ci';\nimport { c } from '../ui';\n\nexport type Flags = Record<string, string | boolean | string[] | undefined>;\n\nfunction str(v: unknown): string | undefined {\n return typeof v === 'string' ? v : undefined;\n}\n\nfunction writeIfMissing(file: string, content: string, created: string[], skipped: string[]): void {\n if (existsSync(file)) {\n skipped.push(file);\n return;\n }\n mkdirSync(dirname(file), { recursive: true });\n writeFileSync(file, content, 'utf8');\n created.push(file);\n}\n\nfunction importPath(fromFile: string, toFile: string): string {\n let rel = relative(dirname(fromFile), toFile).replace(/\\\\/g, '/').replace(/\\.(ts|mts|js|mjs)$/, '');\n if (!rel.startsWith('.')) rel = `./${rel}`;\n return rel;\n}\n\n// Vite apps run the SDK in the browser; this plugin prints what each experiment does in the dev server's terminal.\nconst VITE_PLUGIN_HINT = `// vite.config.ts\nimport { splithub } from '@splithub/core/vite';\n\nexport default defineConfig({ plugins: [react(), splithub()] });`;\n\nexport async function init(flags: Flags): Promise<void> {\n const yes = Boolean(flags.yes);\n const json = Boolean(flags.json);\n const project = detectProject();\n const created: string[] = [];\n const skipped: string[] = [];\n\n if (!json) p.intro(c.bold('splithub init'));\n\n let mode = str(flags.mode) as 'self' | 'cloud' | undefined;\n if (!mode) {\n if (yes) mode = 'self';\n else {\n const picked = await p.select({\n message: 'Where should events be stored?',\n options: [\n { value: 'self', label: 'My own database (self-hosted)', hint: 'free forever, nothing leaves your infra' },\n { value: 'cloud', label: 'SplitHub Cloud', hint: 'hosted dashboard, no server code' },\n ],\n });\n if (p.isCancel(picked)) return cancel();\n mode = picked as 'self' | 'cloud';\n }\n }\n\n // Cloud: connect this directory to a project. A saved login or SPLITHUB_API_KEY\n // is enough; otherwise run the device flow — print a link, the human signs in\n // and picks (or creates) the project, the CLI gets the keys. Works when an\n // agent runs init: it relays the link, the user clicks it.\n // Self mode: which database keeps the events. sqlite needs nothing; postgres / mysql\n // get a ready Store in splithub/store.ts; custom gets a documented stub.\n let db: DbKind = (DB_KINDS as string[]).includes(str(flags.db) ?? '') ? (str(flags.db) as DbKind) : 'sqlite';\n if (mode === 'self' && !flags.db && !yes) {\n const picked = await p.select({\n message: 'Where should events be stored?',\n options: [\n { value: 'sqlite', label: 'SQLite file (zero setup)', hint: './splithub.db via node:sqlite' },\n { value: 'postgres', label: 'Postgres', hint: 'pg + DATABASE_URL, table splithub_events' },\n { value: 'mysql', label: 'MySQL / MariaDB / PlanetScale', hint: 'mysql2 + DATABASE_URL' },\n { value: 'custom', label: 'My own store (Prisma, Drizzle, Supabase, Mongo…)', hint: 'a stub with the three methods to fill in' },\n ],\n });\n if (p.isCancel(picked)) return cancel();\n db = picked as DbKind;\n }\n\n let key = str(flags.key);\n let connected: { projectName: string | null; projectId: string | null } | null = null;\n if (mode === 'cloud') {\n const api = cloudTarget(flags).url;\n const saved = loadCredential(api, project.root);\n if (saved) {\n key ??= saved.publicKey ?? undefined;\n connected = { projectName: saved.projectName, projectId: saved.projectId };\n } else if (!process.env.SPLITHUB_API_KEY && !flags['no-login']) {\n if (!json) p.log.step('Connect to SplitHub Cloud');\n try {\n const cred = await deviceLogin({\n api,\n root: project.root,\n json,\n onCode: json\n ? (s) => console.log(JSON.stringify({ step: 'approve', verifyUrl: s.verifyUrl, userCode: s.userCode, expiresIn: s.expiresIn, hint: 'Show this link to the user and wait; init continues once approved.' }))\n : (s) => p.note(`${c.cyan(s.verifyUrl)}\\n\\nCode ${c.green(s.userCode)} · sign in, pick or create the project, approve.`, 'Open this link'),\n });\n key ??= cred.publicKey ?? undefined;\n connected = { projectName: cred.projectName, projectId: cred.projectId };\n if (!json) p.log.success(`connected to ${c.cyan(cred.projectName ?? cred.projectId ?? 'project')}`);\n } catch (error) {\n if (!json) p.log.warn(`not connected: ${error instanceof Error ? error.message : String(error)}. Run ${c.cyan('npx splithub login')} later.`);\n }\n }\n // An API key in the environment (CI, agents) identifies the project: ask the cloud for its public key.\n if (!key && process.env.SPLITHUB_API_KEY) {\n try {\n const res = await fetch(`${api}/config`, { headers: { authorization: `Bearer ${process.env.SPLITHUB_API_KEY}` } });\n const body = (await res.json().catch(() => ({}))) as { publicKey?: string };\n if (typeof body.publicKey === 'string' && body.publicKey.startsWith('pk_')) {\n key = body.publicKey;\n connected ??= { projectName: null, projectId: null };\n }\n } catch {\n // offline: the first push writes the key into the config anyway\n }\n }\n if (!key && !yes) {\n const k = await p.text({ message: 'Cloud public key (pk_...), leave empty to set later via NEXT_PUBLIC_SPLITHUB_KEY', placeholder: 'pk_' });\n if (p.isCancel(k)) return cancel();\n key = k || undefined;\n }\n }\n\n // 1. config\n const configFile = project.configFile ?? join(project.root, 'splithub.config.ts');\n writeIfMissing(configFile, configTemplate(project.name, mode, key), created, skipped);\n\n // 2a. store for self mode (postgres / mysql / custom); sqlite needs no file.\n const storeBody = mode === 'self' ? storeTemplate(db) : null;\n const storeFile = storeBody ? join(project.root, 'splithub', 'store.ts') : null;\n if (storeFile && storeBody) writeIfMissing(storeFile, storeBody, created, skipped);\n\n // 2. framework files\n if (project.framework === 'next') {\n const mwFile = join(project.root, project.hasSrc ? 'src/middleware.ts' : 'middleware.ts');\n writeIfMissing(mwFile, nextMiddlewareTemplate(importPath(mwFile, configFile)), created, skipped);\n if (mode === 'self' && project.appDir) {\n const routeFile = join(project.root, project.appDir, 'api/splithub/[[...path]]/route.ts');\n writeIfMissing(routeFile, nextRouteTemplate(importPath(routeFile, configFile), storeUsage(db, storeFile ? importPath(routeFile, storeFile) : '')), created, skipped);\n }\n }\n\n // 3. agent skills (+ MCP server registration): the agent learns the library, how to test\n // well, the API and the MCP tools from .claude/skills/*; Cursor gets the rule file.\n let mcp = !flags['no-mcp'];\n if (!yes && !json && mcp) {\n const want = await p.confirm({ message: 'Register the SplitHub MCP server for Claude Code / Cursor (.mcp.json, .cursor/mcp.json)?', initialValue: true });\n if (p.isCancel(want)) return cancel();\n mcp = want;\n }\n const skillsResult = installSkills(project.root, { mcp });\n created.push(...skillsResult.written, ...skillsResult.mcp.map((f) => `${f} (MCP server)`));\n skipped.push(...skillsResult.skipped);\n\n // 3b. GitHub workflow: checks on PRs, results comment on a schedule.\n if (flags['github-action']) {\n const wf = writeWorkflow(project.root, Boolean(flags.force));\n (wf.written ? created : skipped).push(join(project.root, wf.file));\n }\n\n // 4. dependencies\n const runtime = ['@splithub/react', '@splithub/core'];\n if (project.framework === 'next') runtime.push('@splithub/next');\n if (mode === 'self') runtime.push('@splithub/node', ...runtimePackages(db));\n const installRuntime = installCommand(project.packageManager, runtime);\n const installDev = installCommand(project.packageManager, ['splithub'], true);\n let installed = false;\n if (!flags['no-install']) {\n const go = yes ? true : await p.confirm({ message: `Install packages now? (${installRuntime})` });\n if (p.isCancel(go)) return cancel();\n if (go) {\n const s = json ? null : p.spinner();\n s?.start('Installing');\n try {\n execSync(installRuntime, { cwd: project.root, stdio: json ? 'ignore' : 'inherit' });\n execSync(installDev, { cwd: project.root, stdio: json ? 'ignore' : 'inherit' });\n installed = true;\n s?.stop('Installed');\n } catch (error) {\n s?.stop('Install failed; run it manually');\n if (!json) p.log.error(error instanceof Error ? error.message : String(error));\n }\n }\n }\n\n const providerHint =\n project.framework === 'next'\n ? `// ${project.appDir ?? 'app'}/layout.tsx\\nimport { SplitHubNextProvider } from '@splithub/next/client';\\nimport { getSplitHub } from '@splithub/next/server';\\nimport config from '${importPath(join(project.root, project.appDir ?? 'app', 'layout.tsx'), configFile)}';\\n\\nexport default async function RootLayout({ children }) {\\n const sh = await getSplitHub(config);\\n return <html><body><SplitHubNextProvider config={config} visitorId={sh.visitorId ?? undefined} remoteOverrides={sh.overrides}>{children}</SplitHubNextProvider></body></html>;\\n}`\n : `// main.tsx\\nimport { SplitHubProvider } from '@splithub/react';\\nimport config from './splithub.config';\\n\\n<SplitHubProvider config={config}><App /></SplitHubProvider>`;\n\n const warning = mode === 'cloud' && !key ? 'No public key yet: storage.key falls back to process.env.NEXT_PUBLIC_SPLITHUB_KEY. It is written into the config by the first `npx splithub push`, by `npx splithub login` (saved with the credentials), or pass --key pk_… (dashboard → Setup); SPLITHUB_API_KEY in the environment also resolves it.' : null;\n const summary = { project: project.name, framework: project.framework, mode, db: mode === 'self' ? db : null, connected, publicKey: key ?? null, warning, created, skipped, installed, installCommands: installed ? [] : [installRuntime, installDev], nextStep: providerHint, ...(project.framework === 'vite' ? { vitePlugin: VITE_PLUGIN_HINT } : {}) };\n\n if (json) {\n console.log(JSON.stringify(summary));\n return;\n }\n if (warning) p.log.warn(warning);\n if (mode === 'self' && db !== 'sqlite') p.note(db === 'custom' ? 'Fill in the three methods in splithub/store.ts (the comments say what each must return).' : `Set DATABASE_URL and run the SCHEMA_SQL from splithub/store.ts once (or add it to your migrations).`, `Database: ${db}`);\n if (created.length) p.note(created.map((f) => relative(project.root, f) || f).join('\\n'), 'Created');\n if (skipped.length) p.note(skipped.map((f) => relative(project.root, f)).join('\\n'), 'Already present, left untouched');\n if (!installed) p.note(`${installRuntime}\\n${installDev}`, 'Install');\n p.note(providerHint, 'Wrap your app once');\n if (project.framework === 'vite') p.note(VITE_PLUGIN_HINT, 'Notes in your dev terminal');\n p.outro(`Next: ${c.cyan('npx splithub create')} to add your first experiment, ${c.cyan('npx splithub push')} to sync it, ${c.cyan('npx splithub doctor')} to verify.`);\n}\n\n\nfunction cancel(): void {\n p.cancel('Cancelled.');\n process.exit(0);\n}\n","// Store templates for self-hosted mode: `splithub init --mode self --db postgres|mysql|custom`\n// writes splithub/store.ts from one of these. Each implements the Store interface\n// from @splithub/node (insertEvents, variantCounts, summaries) with the same\n// attribution rule as the cloud, through variantCountsSql from @splithub/node.\n\nexport type DbKind = 'sqlite' | 'postgres' | 'mysql' | 'custom';\nexport const DB_KINDS: DbKind[] = ['sqlite', 'postgres', 'mysql', 'custom'];\n\nexport const PG_STORE = `import { countsFromRow, variantCountsSql, type ExperimentSummary, type Store, type StoredEvent, type StoreVariantCounts } from '@splithub/node';\nimport { Pool } from 'pg';\n\n// SplitHub events in your Postgres. Run once (or add to your migrations):\nexport const SCHEMA_SQL = \\`\nCREATE TABLE IF NOT EXISTS splithub_events (\n id text PRIMARY KEY,\n type text NOT NULL, -- exposure | goal\n experiment text,\n variant text,\n goal text,\n visitor_id text NOT NULL,\n session_id text NOT NULL,\n ts bigint NOT NULL, -- client clock, unix ms\n url text,\n props jsonb,\n received_at bigint NOT NULL, -- server clock, unix ms\n host text,\n country text,\n device text,\n browser text\n);\nCREATE INDEX IF NOT EXISTS splithub_events_exp ON splithub_events (type, experiment, visitor_id, ts);\nCREATE INDEX IF NOT EXISTS splithub_events_goal ON splithub_events (type, goal, visitor_id, ts);\n\\`;\n\n// The attribution rule shared by every SplitHub store (first exposure, 60 s clock skew, 50 goals per visitor and day).\nconst counts = variantCountsSql({ dialect: 'postgres', table: 'splithub_events' });\n\nexport function pgStore(pool: Pool = new Pool({ connectionString: process.env.DATABASE_URL })): Store {\n return {\n async insertEvents(events: StoredEvent[]) {\n if (events.length === 0) return 0;\n const cols = 15;\n const values: unknown[] = [];\n const rows = events.map((e, i) => {\n values.push(e.id, e.type, e.experiment, e.variant, e.goal, e.visitorId, e.sessionId, e.ts, e.url, e.props ? JSON.stringify(e.props) : null, e.receivedAt, e.host ?? null, e.country ?? null, e.device ?? null, e.browser ?? null);\n return '(' + Array.from({ length: cols }, (_, j) => '$' + (i * cols + j + 1)).join(', ') + ')';\n });\n const r = await pool.query(\n 'INSERT INTO splithub_events (id, type, experiment, variant, goal, visitor_id, session_id, ts, url, props, received_at, host, country, device, browser) VALUES ' + rows.join(', ') + ' ON CONFLICT (id) DO NOTHING',\n values\n );\n return r.rowCount ?? 0;\n },\n async variantCounts(experiment: string, goal: string): Promise<StoreVariantCounts[]> {\n const r = await pool.query(counts.sql, counts.bind({ experiment, goal }));\n return r.rows.map(countsFromRow);\n },\n async summaries(): Promise<ExperimentSummary[]> {\n const r = await pool.query(\n \\`SELECT experiment, COUNT(*)::int AS exposures, COUNT(DISTINCT visitor_id)::int AS visitors, MIN(ts)::bigint AS first_ts, MAX(ts)::bigint AS last_ts\n FROM splithub_events WHERE type = 'exposure' GROUP BY experiment\\`\n );\n return r.rows.map((x) => ({ experiment: String(x.experiment), exposures: Number(x.exposures), visitors: Number(x.visitors), firstExposureAt: x.first_ts == null ? null : Number(x.first_ts), lastExposureAt: x.last_ts == null ? null : Number(x.last_ts) }));\n },\n close: () => pool.end(),\n };\n}\n`;\n\nexport const MYSQL_STORE = `import { countsFromRow, variantCountsSql, type ExperimentSummary, type Store, type StoredEvent, type StoreVariantCounts } from '@splithub/node';\nimport mysql, { type Pool } from 'mysql2/promise';\n\n// SplitHub events in your MySQL / MariaDB / PlanetScale. Run once (or add to your migrations):\nexport const SCHEMA_SQL = \\`\nCREATE TABLE IF NOT EXISTS splithub_events (\n id VARCHAR(64) PRIMARY KEY,\n type VARCHAR(16) NOT NULL,\n experiment VARCHAR(64) NULL,\n variant VARCHAR(64) NULL,\n goal VARCHAR(64) NULL,\n visitor_id VARCHAR(64) NOT NULL,\n session_id VARCHAR(64) NOT NULL,\n ts BIGINT NOT NULL,\n url VARCHAR(512) NULL,\n props JSON NULL,\n received_at BIGINT NOT NULL,\n host VARCHAR(255) NULL,\n country VARCHAR(8) NULL,\n device VARCHAR(16) NULL,\n browser VARCHAR(32) NULL,\n INDEX splithub_events_exp (type, experiment, visitor_id, ts),\n INDEX splithub_events_goal (type, goal, visitor_id, ts)\n);\n\\`;\n\n// The attribution rule shared by every SplitHub store (first exposure, 60 s clock skew, 50 goals per visitor and day).\nconst counts = variantCountsSql({ dialect: 'mysql', table: 'splithub_events' });\n\nexport function mysqlStore(pool: Pool = mysql.createPool(process.env.DATABASE_URL ?? '')): Store {\n return {\n async insertEvents(events: StoredEvent[]) {\n if (events.length === 0) return 0;\n const values = events.map((e) => [e.id, e.type, e.experiment, e.variant, e.goal, e.visitorId, e.sessionId, e.ts, e.url, e.props ? JSON.stringify(e.props) : null, e.receivedAt, e.host ?? null, e.country ?? null, e.device ?? null, e.browser ?? null]);\n const [r] = await pool.query(\n 'INSERT IGNORE INTO splithub_events (id, type, experiment, variant, goal, visitor_id, session_id, ts, url, props, received_at, host, country, device, browser) VALUES ?',\n [values]\n );\n return (r as { affectedRows: number }).affectedRows;\n },\n async variantCounts(experiment: string, goal: string): Promise<StoreVariantCounts[]> {\n const [rows] = await pool.query(counts.sql, counts.bind({ experiment, goal }));\n return (rows as Array<Record<string, unknown>>).map(countsFromRow);\n },\n async summaries(): Promise<ExperimentSummary[]> {\n const [rows] = await pool.query(\n \\`SELECT experiment, COUNT(*) AS exposures, COUNT(DISTINCT visitor_id) AS visitors, MIN(ts) AS first_ts, MAX(ts) AS last_ts\n FROM splithub_events WHERE type = 'exposure' GROUP BY experiment\\`\n );\n return (rows as Array<Record<string, unknown>>).map((x) => ({ experiment: String(x.experiment), exposures: Number(x.exposures), visitors: Number(x.visitors), firstExposureAt: x.first_ts == null ? null : Number(x.first_ts), lastExposureAt: x.last_ts == null ? null : Number(x.last_ts) }));\n },\n close: () => pool.end(),\n };\n}\n`;\n\nexport const CUSTOM_STORE = `import { attributeVariants, type ExperimentSummary, type Store, type StoredEvent, type StoreVariantCounts } from '@splithub/node';\n\n/**\n * Your own store (Prisma, Drizzle, Supabase, Mongo, anything). Three methods.\n * Attribution rule (keep it, so results match the dashboard):\n * a visitor counts once per experiment, in the variant of their earliest\n * exposure (same ts: smallest variant key), and converts when they sent the\n * goal at or after that exposure (60 s of clock skew allowed); only the first\n * 50 events of one goal per visitor and UTC day count; count unique visitors.\n * SQL database: run variantCountsSql({ dialect }) from @splithub/node.\n * Anything else: load the experiment's exposures and the goal's events and\n * return attributeVariants(events, experiment, goal).\n * Columns worth keeping: id (unique, dedupe on it), type, experiment, variant,\n * goal, visitor_id, session_id, ts, url, props (json), received_at, host,\n * country, device, browser.\n */\nexport function customStore(): Store {\n return {\n async insertEvents(events: StoredEvent[]): Promise<number> {\n // Insert, skipping ids that already exist. Return how many were inserted.\n throw new Error('implement insertEvents ' + events.length);\n },\n async variantCounts(experiment: string, goal: string): Promise<StoreVariantCounts[]> {\n // Per variant: exposures, conversions, revenueSum and revenueSumSq (per-visitor revenue).\n // Load the exposures of this experiment and the events of this goal, then apply the shared rule.\n const events: StoredEvent[] = [];\n if (events.length === 0) throw new Error('implement variantCounts ' + experiment + ' ' + goal);\n return attributeVariants(events, experiment, goal);\n },\n async summaries(): Promise<ExperimentSummary[]> {\n // Per experiment: exposures, unique visitors, first and last exposure ts (unix ms).\n throw new Error('implement summaries');\n },\n };\n}\n`;\n\nexport function storeTemplate(db: DbKind): string | null {\n return db === 'postgres' ? PG_STORE : db === 'mysql' ? MYSQL_STORE : db === 'custom' ? CUSTOM_STORE : null;\n}\n\n/** Import line + factory call used by the route template. */\nexport function storeUsage(db: DbKind, storeImport: string): { imports: string; factory: string } {\n switch (db) {\n case 'postgres':\n return { imports: `import { pgStore } from '${storeImport}';`, factory: 'pgStore()' };\n case 'mysql':\n return { imports: `import { mysqlStore } from '${storeImport}';`, factory: 'mysqlStore()' };\n case 'custom':\n return { imports: `import { customStore } from '${storeImport}';`, factory: 'customStore()' };\n default:\n return { imports: `import { sqliteStore } from '@splithub/adapter-sqlite';`, factory: `sqliteStore({ file: process.env.SPLITHUB_DB ?? './splithub.db' })` };\n }\n}\n\nexport function runtimePackages(db: DbKind): string[] {\n return db === 'postgres' ? ['pg'] : db === 'mysql' ? ['mysql2'] : db === 'sqlite' ? ['@splithub/adapter-sqlite'] : [];\n}\n"],"mappings":"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","names":["cancel"]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/commands/results.ts"],"sourcesContent":["import type { ExperimentResults } from '@splithub/node';\nimport { fetchResults, resolveTarget } from '../api';\nimport { fail, printJson } from '../errors';\nimport { detectProject } from '../project';\nimport { bar, c, pct, statusColor, table, verdictColor, verdictIcon } from '../ui';\n\nexport async function results(key: string | undefined, flags: Record<string, unknown>): Promise<void> {\n if (!key) fail('USAGE', 'Which experiment? npx splithub results <id>');\n const target = resolveTarget(flags, detectProject());\n const r = await fetchResults(target, key);\n if (flags.json) {\n printJson({ ...r, daysToVerdict: r.daysToVerdict ?? null, ...(r.status === 'finished' ? { next: FINISHED_NEXT } : {}) });\n return;\n }\n const v = r.verdict;\n const title = r.experiment === HOLDOUT ? 'Holdout: long-term impact' : r.experiment;\n console.log(`${c.bold(title)} ${c.dim(`· ${r.kind} · `)}${statusColor(r.status)} ${c.dim(`· goal: ${r.goal ?? 'none'}`)}`);\n if (r.description) console.log(c.dim(r.description));\n console.log();\n console.log(verdictColor(v.status, `${label(v.status)} ${v.message}`));\n const eta = daysLeft(r.daysToVerdict);\n if (eta && r.status === 'running') console.log(c.dim(eta));\n for (const note of v.notes ?? []) console.log(c.dim(`· ${note}`));\n console.log();\n\n const rates = new Map<string, number>();\n for (const cnt of v.sample.variants) rates.set(cnt.variant, cnt.exposures > 0 ? cnt.conversions / cnt.exposures : 0);\n\n console.log(\n table(\n ['VARIANT', 'VISITORS', 'CONV', 'RATE', 'LIFT', 'P(BEAT)', 'P-VALUE', '95% CI'],\n // Always-valid (sequential) p-value and interval: the ones the verdict uses, safe to read any day.\n v.sample.variants.map((cnt, i) => {\n const cmp = v.comparisons.find((x) => x.variant === cnt.variant);\n const name = i === 0 ? `${cnt.variant} ${c.dim('(control)')}` : cnt.variant;\n const marked = v.winner === cnt.variant ? c.green(`★ ${name}`) : name;\n return [\n marked,\n String(cnt.exposures),\n String(cnt.conversions),\n pct(rates.get(cnt.variant)),\n cmp ? pct(cmp.relativeLift, true) : '–',\n cmp ? pct(cmp.probabilityToBeat) : '–',\n cmp ? (cmp.sequential?.pValue ?? cmp.pValue).toFixed(4) : '–',\n cmp ? `${pct((cmp.sequential?.ci ?? cmp.ci).low, true)} … ${pct((cmp.sequential?.ci ?? cmp.ci).high, true)}` : '–',\n ];\n })\n )\n );\n // Rates as bars, lift next to them; P(beat) as a second bar. Reads at a glance in a terminal.\n const maxRate = Math.max(0.0001, ...v.sample.variants.map((cnt) => rates.get(cnt.variant) ?? 0));\n const nameWidth = Math.max(...v.sample.variants.map((cnt) => cnt.variant.length));\n console.log();\n console.log(c.dim('RATE'));\n for (const cnt of v.sample.variants) {\n const cmp = v.comparisons.find((x) => x.variant === cnt.variant);\n const paint = v.winner === cnt.variant ? c.green : cmp && (cmp.relativeLift ?? 0) < 0 ? c.red : c.cyan;\n const lift = cmp ? (cmp.relativeLift ?? 0) >= 0 ? c.green(`▲ ${pct(cmp.relativeLift, true)}`) : c.red(`▼ ${pct(cmp.relativeLift, true)}`) : c.dim('baseline');\n console.log(`${cnt.variant.padEnd(nameWidth)} ${bar(rates.get(cnt.variant) ?? 0, maxRate, 24, paint)} ${pct(rates.get(cnt.variant)).padStart(6)} ${lift}`);\n }\n if (v.comparisons.length) {\n console.log();\n console.log(c.dim('CHANCE TO BEAT THE CONTROL'));\n for (const cmp of v.comparisons) {\n const paint = cmp.probabilityToBeat >= 0.95 ? c.green : cmp.probabilityToBeat <= 0.05 ? c.red : c.yellow;\n console.log(`${cmp.variant.padEnd(nameWidth)} ${bar(cmp.probabilityToBeat, 1, 24, paint)} ${pct(cmp.probabilityToBeat).padStart(6)}`);\n }\n }\n if (v.srm) {\n console.log();\n console.log(c.dim(`SRM check: chi²=${v.srm.chiSquare.toFixed(2)} p=${v.srm.pValue.toExponential(2)} ${v.srm.detected ? c.red('DETECTED') : 'ok'}`));\n }\n if (v.status === 'insufficient_sample' && v.sample.neededPerVariant) {\n console.log(c.dim(`Estimated ${v.sample.neededPerVariant} visitors per variant needed to confirm the current lift.`));\n }\n if (r.factors?.length) {\n console.log();\n console.log(c.bold('Each factor on its own') + c.dim(' (a level sums every combination that uses it, compared with the first level)'));\n for (const f of r.factors) {\n console.log(\n table(\n [f.key.toUpperCase(), 'VISITORS', 'CONV.', 'RATE', 'LIFT', 'P-VALUE'],\n f.levels.map((l) => [l.level + (f.best === l.level ? c.green(' ✔') : ''), String(l.exposures), String(l.conversions), pct(l.rate), l.relativeLift === null ? '–' : pct(l.relativeLift, true), l.pValue === null ? '–' : l.pValue.toFixed(3)])\n )\n );\n }\n }\n if (v.metrics?.length) {\n console.log();\n console.log(metricsText(v));\n }\n if (r.status === 'finished' && r.experiment !== HOLDOUT) {\n console.log();\n console.log(c.dim(FINISHED_NEXT));\n }\n}\n\n/** Printed for finished tests, so a human or an agent knows the code still carries every variant. */\nconst FINISHED_NEXT = 'This test is finished but its variants are still in the code. Decide which variant to keep, then run npx splithub ship <id> --keep <variant> (agents: the splithub-ship skill).';\n\n/** \"About 6 more days\" for a verdict ETA; null when unknown or already there. */\nexport function daysLeft(days: number | null | undefined): string | null {\n if (days === null || days === undefined || !Number.isFinite(days) || days <= 0) return null;\n const d = Math.ceil(days);\n return d === 1 ? 'About 1 more day to a verdict at this traffic.' : `About ${d} more days to a verdict at this traffic.`;\n}\n\nfunction label(status: string): string {\n const icon = verdictIcon(status);\n switch (status) {\n case 'winner_found':\n return `${icon} WINNER`;\n case 'srm_detected':\n return `${icon} SRM`;\n case 'insufficient_sample':\n return `${icon} TOO EARLY`;\n case 'no_significant_difference':\n return `${icon} NO DIFFERENCE`;\n case 'guardrail_breached':\n return `${icon} DON'T SHIP`;\n default:\n return `${icon} NO DATA`;\n }\n}\n\nexport const HOLDOUT = '__holdout';\n\ntype V = ExperimentResults['verdict'];\n\n/** Secondary metrics and guardrails, one small table each. A breached guardrail is marked. */\nexport function metricsText(v: V): string {\n const out: string[] = [];\n for (const m of v.metrics ?? []) {\n const head = m.role === 'guardrail' ? `GUARDRAIL ${m.metric}${m.worse === 'higher' ? ' (a rise is bad)' : ''}` : `ALSO ${m.metric}`;\n out.push(c.dim(head));\n out.push(\n table(\n ['VARIANT', 'CONV', 'RATE', 'LIFT', 'P-VALUE', ''],\n m.variants.map((cnt) => {\n const cmp = m.comparisons.find((x) => x.variant === cnt.variant);\n const breach = v.guardrailBreached?.find((b) => b.metric === m.metric && b.variant === cnt.variant);\n return [cnt.variant, String(cnt.conversions), pct(cnt.exposures ? cnt.conversions / cnt.exposures : 0), cmp ? pct(cmp.relativeLift, true) : '–', cmp ? (cmp.sequential?.pValue ?? cmp.pValue).toFixed(4) : '–', breach ? c.red('✖ worse') : ''];\n })\n )\n );\n }\n return out.join('\\n');\n}\n"],"mappings":"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","names":[]}
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/commands/doctor.ts"],"sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join, relative } from 'node:path';\nimport { resolveTarget } from '../api';\nimport { loadConfig } from '../config-file';\nimport { printJson } from '../errors';\nimport { detectProject, grepFiles, listSourceFiles } from '../project';\nimport { findRefs } from '../refs';\nimport { c } from '../ui';\nimport type { Flags } from './init';\n\ntype Level = 'ok' | 'warn' | 'error';\ninterface Check {\n level: Level;\n message: string;\n}\n\nexport async function doctor(flags: Flags): Promise<void> {\n const checks: Check[] = [];\n const add = (level: Level, message: string) => checks.push({ level, message });\n const project = detectProject();\n\n add('ok', `project \"${project.name}\" · ${project.framework} · ${project.packageManager}`);\n\n if (!project.configFile) {\n add('error', 'splithub.config.ts not found. Run `npx splithub init`.');\n return report(checks, flags);\n }\n add('ok', `config: ${relative(project.root, project.configFile)}`);\n\n let config;\n try {\n config = await loadConfig(project.configFile);\n add('ok', `config loads · ${config.experiments.length} experiment(s) · storage ${config.storage.mode}`);\n } catch (error) {\n add('error', `config does not load: ${error instanceof Error ? error.message : String(error)}`);\n return report(checks, flags);\n }\n\n const files = listSourceFiles(project.root);\n const providerHits = grepFiles(files, 'SplitHubProvider').concat(grepFiles(files, 'SplitHubNextProvider'));\n if (providerHits.length === 0) add('error', 'no <SplitHubProvider> found in source. Wrap your app once.');\n else add('ok', `provider in ${relative(project.root, providerHits[0]!)}`);\n\n if (project.framework === 'next') {\n const mw = ['middleware.ts', 'src/middleware.ts', 'middleware.js', 'src/middleware.js'].map((f) => join(project.root, f)).find((f) => existsSync(f));\n const hasRedirects = config.experiments.some((e) => e.kind === 'redirect');\n if (!mw) add(hasRedirects ? 'error' : 'warn', 'no middleware.ts: visitor cookie is not set on the server (SSR may flicker)' + (hasRedirects ? '; redirect experiments will not run' : ''));\n else if (!readFileSync(mw, 'utf8').includes('splithubMiddleware')) add('warn', `${relative(project.root, mw)} does not call splithubMiddleware()`);\n else add('ok', `middleware: ${relative(project.root, mw)}`);\n if (config.storage.mode === 'self' && project.appDir) {\n const catchAll = join(project.root, project.appDir, 'api/splithub/[[...path]]/route.ts');\n const plain = join(project.root, project.appDir, 'api/splithub/route.ts');\n if (existsSync(catchAll)) add('ok', `ingest route: ${relative(project.root, catchAll)}`);\n else if (existsSync(plain)) add('error', `${relative(project.root, plain)} only serves POST /api/splithub; move it to api/splithub/[[...path]]/route.ts so /status and /results work`);\n else add('error', `self mode but ${relative(project.root, catchAll)} is missing (ingest endpoint)`);\n }\n }\n\n for (const exp of config.experiments) {\n const label = `${exp.key} (${exp.kind}, ${exp.status})`;\n if (!exp.goal) add(exp.status === 'running' ? 'error' : 'warn', `${label}: no goal; the verdict cannot be computed`);\n if (exp.kind !== 'redirect') {\n const used = findRefs(project.root, config, exp.key, files).refs.filter((r) => r.match === 'experiment').length;\n if (used === 0) add(exp.status === 'running' ? 'error' : 'warn', `${label}: not referenced in code (useValue/useVariant/<Experiment id>)`);\n }\n if (exp.status === 'running' && exp.variants.every((v) => v.weight === 0)) add('error', `${label}: all weights are 0`);\n }\n for (const goal of config.goals) {\n if (goal.type === 'event' && grepFiles(files, `'${goal.key}'`).length + grepFiles(files, `\"${goal.key}\"`).length === 0) {\n add('warn', `goal \"${goal.key}\": track('${goal.key}') is never called`);\n }\n }\n\n const target = resolveTarget(flags, project);\n try {\n const ctrl = new AbortController();\n const t = setTimeout(() => ctrl.abort(), 2500);\n const res = await fetch(`${target.url}/health`, { signal: ctrl.signal });\n clearTimeout(t);\n add(res.ok ? 'ok' : 'warn', `endpoint ${target.url}/health → ${res.status}`);\n } catch {\n add('warn', `endpoint ${target.url} not reachable (is the dev server running?)`);\n }\n\n return report(checks, flags);\n}\n\nfunction report(checks: Check[], flags: Flags): void {\n const errors = checks.filter((x) => x.level === 'error').length;\n if (flags.json) {\n printJson({ ok: errors === 0, errors, warnings: checks.filter((x) => x.level === 'warn').length, checks });\n } else {\n for (const x of checks) {\n const icon = x.level === 'ok' ? c.green('✔') : x.level === 'warn' ? c.yellow('!') : c.red('✖');\n console.log(`${icon} ${x.message}`);\n }\n console.log();\n console.log(errors === 0 ? c.green('All good.') : c.red(`${errors} problem(s) to fix.`));\n }\n if (errors > 0) process.exitCode = 1;\n}\n"],"mappings":"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","names":[]}
@@ -1,18 +0,0 @@
1
- #!/usr/bin/env node
2
- import {
3
- create,
4
- parseExtras,
5
- parseLimits,
6
- parseWeights
7
- } from "./chunk-3VACHXWE.js";
8
- import "./chunk-3VY5CP3E.js";
9
- import "./chunk-3DUWIEHB.js";
10
- import "./chunk-PLXDG4B5.js";
11
- import "./chunk-V3DLUVOE.js";
12
- export {
13
- create,
14
- parseExtras,
15
- parseLimits,
16
- parseWeights
17
- };
18
- //# sourceMappingURL=create-K75OY6XK.js.map
@@ -1,11 +0,0 @@
1
- #!/usr/bin/env node
2
- import {
3
- dev
4
- } from "./chunk-HSH4ZI2V.js";
5
- import "./chunk-EUF75FUC.js";
6
- import "./chunk-PLXDG4B5.js";
7
- import "./chunk-V3DLUVOE.js";
8
- export {
9
- dev
10
- };
11
- //# sourceMappingURL=dev-WQWFEA6I.js.map
@@ -1,13 +0,0 @@
1
- #!/usr/bin/env node
2
- import {
3
- doctor
4
- } from "./chunk-YSXW2HN6.js";
5
- import "./chunk-GVARYUL3.js";
6
- import "./chunk-3VY5CP3E.js";
7
- import "./chunk-EUF75FUC.js";
8
- import "./chunk-PLXDG4B5.js";
9
- import "./chunk-V3DLUVOE.js";
10
- export {
11
- doctor
12
- };
13
- //# sourceMappingURL=doctor-MFYBZUKO.js.map
@@ -1,15 +0,0 @@
1
- #!/usr/bin/env node
2
- import {
3
- init
4
- } from "./chunk-QOXGIB3R.js";
5
- import "./chunk-PWSRKABE.js";
6
- import "./chunk-EUF75FUC.js";
7
- import "./chunk-AJO3C4BS.js";
8
- import "./chunk-3DUWIEHB.js";
9
- import "./chunk-EYYLDI5J.js";
10
- import "./chunk-PLXDG4B5.js";
11
- import "./chunk-V3DLUVOE.js";
12
- export {
13
- init
14
- };
15
- //# sourceMappingURL=init-QAAM2GQ7.js.map
@@ -1,12 +0,0 @@
1
- #!/usr/bin/env node
2
- import {
3
- lifecycle
4
- } from "./chunk-C5S7RPYM.js";
5
- import "./chunk-3VY5CP3E.js";
6
- import "./chunk-EUF75FUC.js";
7
- import "./chunk-PLXDG4B5.js";
8
- import "./chunk-V3DLUVOE.js";
9
- export {
10
- lifecycle
11
- };
12
- //# sourceMappingURL=lifecycle-56HM7ITG.js.map
@@ -1,135 +0,0 @@
1
- #!/usr/bin/env node
2
- import {
3
- fetchStatus,
4
- resolveTarget
5
- } from "./chunk-EUF75FUC.js";
6
- import {
7
- detectProject
8
- } from "./chunk-PLXDG4B5.js";
9
- import {
10
- c,
11
- fail,
12
- printJson
13
- } from "./chunk-V3DLUVOE.js";
14
-
15
- // ../stats/dist/index.js
16
- function inverseNormalCdf(p) {
17
- if (p <= 0) return -Infinity;
18
- if (p >= 1) return Infinity;
19
- const a = [-39.69683028665376, 220.9460984245205, -275.9285104469687, 138.357751867269, -30.66479806614716, 2.506628277459239];
20
- const b = [-54.47609879822406, 161.5858368580409, -155.6989798598866, 66.80131188771972, -13.28068155288572];
21
- const c2 = [-0.007784894002430293, -0.3223964580411365, -2.400758277161838, -2.549732539343734, 4.374664141464968, 2.938163982698783];
22
- const d = [0.007784695709041462, 0.3224671290700398, 2.445134137142996, 3.754408661907416];
23
- const pLow = 0.02425;
24
- let q;
25
- if (p < pLow) {
26
- q = Math.sqrt(-2 * Math.log(p));
27
- return (((((c2[0] * q + c2[1]) * q + c2[2]) * q + c2[3]) * q + c2[4]) * q + c2[5]) / ((((d[0] * q + d[1]) * q + d[2]) * q + d[3]) * q + 1);
28
- }
29
- if (p > 1 - pLow) {
30
- q = Math.sqrt(-2 * Math.log(1 - p));
31
- return -(((((c2[0] * q + c2[1]) * q + c2[2]) * q + c2[3]) * q + c2[4]) * q + c2[5]) / ((((d[0] * q + d[1]) * q + d[2]) * q + d[3]) * q + 1);
32
- }
33
- q = p - 0.5;
34
- const r = q * q;
35
- return (((((a[0] * r + a[1]) * r + a[2]) * r + a[3]) * r + a[4]) * r + a[5]) * q / (((((b[0] * r + b[1]) * r + b[2]) * r + b[3]) * r + b[4]) * r + 1);
36
- }
37
- function requiredExposuresPerVariant(baselineRate, relativeLift, confidence = 0.95, power = 0.8) {
38
- if (baselineRate <= 0 || baselineRate >= 1 || !Number.isFinite(relativeLift) || relativeLift === 0) return null;
39
- const p1 = baselineRate;
40
- const p2 = Math.min(0.999, Math.max(1e-3, p1 * (1 + relativeLift)));
41
- const zA = inverseNormalCdf(1 - (1 - confidence) / 2);
42
- const zB = inverseNormalCdf(power);
43
- const pBar = (p1 + p2) / 2;
44
- const n = Math.pow(zA * Math.sqrt(2 * pBar * (1 - pBar)) + zB * Math.sqrt(p1 * (1 - p1) + p2 * (1 - p2)), 2) / Math.pow(p2 - p1, 2);
45
- return Math.ceil(n);
46
- }
47
- function boundary(variance, tau2, alpha) {
48
- const total = variance + tau2;
49
- return Math.sqrt(variance * total / tau2 * (Math.log(total / variance) - 2 * Math.log(alpha)));
50
- }
51
- var DEFAULT_MIXTURE = 0.2;
52
- function proportionTau2(pooledRate, mixture) {
53
- return Math.pow(mixture * pooledRate, 2);
54
- }
55
- function sequentialExposuresPerVariant({ baselineRate, relativeLift, alpha = 0.05, power = 0.8, mixture = DEFAULT_MIXTURE }) {
56
- if (baselineRate <= 0 || baselineRate >= 1 || !Number.isFinite(relativeLift) || relativeLift === 0) return null;
57
- const p1 = baselineRate;
58
- const p2 = Math.min(0.999, Math.max(1e-3, p1 * (1 + relativeLift)));
59
- const theta = Math.abs(p2 - p1);
60
- const unit = p1 * (1 - p1) + p2 * (1 - p2);
61
- const tau2 = proportionTau2((p1 + p2) / 2, mixture);
62
- const zB = inverseNormalCdf(power);
63
- const enough = (n) => {
64
- const v = unit / n;
65
- return theta >= boundary(v, tau2, alpha) + zB * Math.sqrt(v);
66
- };
67
- let lo = Math.max(1, (requiredExposuresPerVariant(p1, relativeLift, 1 - alpha, power) ?? 2) - 1);
68
- if (enough(lo)) return Math.ceil(lo);
69
- let hi = lo * 2;
70
- while (!enough(hi)) {
71
- lo = hi;
72
- hi *= 2;
73
- if (hi > 1e12) return null;
74
- }
75
- while (hi - lo > 1) {
76
- const mid = Math.floor((lo + hi) / 2);
77
- if (enough(mid)) hi = mid;
78
- else lo = mid;
79
- }
80
- return hi;
81
- }
82
- function planSample({ baselineRate, mde, alpha = 0.05, power = 0.8, variants = 2, sequential = true, mixture }) {
83
- const comparisons = Math.max(1, Math.floor(variants) - 1);
84
- const a = alpha / comparisons;
85
- if (!sequential) return requiredExposuresPerVariant(baselineRate, mde, 1 - a, power);
86
- return sequentialExposuresPerVariant({ baselineRate, relativeLift: mde, alpha: a, power, mixture: mixture ?? DEFAULT_MIXTURE });
87
- }
88
-
89
- // src/commands/plan.ts
90
- function num(flags, name) {
91
- const v = flags[name];
92
- if (typeof v !== "string" || v === "") return void 0;
93
- const n = Number(v.replace(/%$/, "")) / (v.endsWith("%") ? 100 : 1);
94
- if (!Number.isFinite(n)) fail("INVALID_FLAG", `--${name} "${v}" isn't a number.`);
95
- return n;
96
- }
97
- function planSample2(baseline, mde, variants = 2, confidence = 0.95) {
98
- if (!(baseline > 0 && baseline < 1)) fail("INVALID_FLAG", `--baseline ${baseline} must be a rate between 0 and 1.`, "For example --baseline 0.05 for 5% of visitors converting today.");
99
- if (!(mde > 0)) fail("INVALID_FLAG", `--mde ${mde} must be above 0.`, "The smallest relative lift worth finding, e.g. --mde 0.1 for +10%.");
100
- if (!Number.isInteger(variants) || variants < 2) fail("INVALID_FLAG", "--variants must be a whole number of 2 or more.");
101
- const perVariant = planSample({ baselineRate: baseline, mde, alpha: 1 - confidence, variants });
102
- if (perVariant === null) fail("INVALID_FLAG", "Those numbers don't give a sample size.", "Check --baseline and --mde.");
103
- return { baseline, mde, variants, confidence, perVariant, total: perVariant * variants };
104
- }
105
- async function plan(id, flags) {
106
- const baseline = num(flags, "baseline");
107
- const mde = num(flags, "mde");
108
- if (baseline === void 0 || mde === void 0) fail("USAGE", "Pass --baseline (conversion rate today) and --mde (smallest lift worth finding).", "For example: npx splithub plan --baseline 0.05 --mde 0.1");
109
- const variants = num(flags, "variants") ?? 2;
110
- const p = planSample2(baseline, mde, variants);
111
- let traffic = null;
112
- if (id) {
113
- const data = await fetchStatus(resolveTarget(flags, detectProject()));
114
- const row = data.experiments.find((e) => e.experiment === id);
115
- if (!row) fail("EXPERIMENT_NOT_FOUND", `There's no experiment "${id}" in the results.`, "See the ids with npx splithub status.");
116
- const perDay = row.days > 0 ? row.visitors / row.days : 0;
117
- traffic = { experiment: id, visitors: row.visitors, days: row.days, perDay: Math.round(perDay), daysLeft: perDay > 0 ? Math.max(0, Math.ceil((p.total - row.visitors) / perDay)) : null };
118
- }
119
- if (flags.json) {
120
- printJson({ ...p, traffic });
121
- return;
122
- }
123
- console.log(`${c.bold(p.perVariant.toLocaleString("en-US"))} visitors per variant, ${p.total.toLocaleString("en-US")} in all`);
124
- console.log(c.dim(`to find a ${(mde * 100).toFixed(0)}% lift on a ${(baseline * 100).toFixed(1)}% rate (95% confidence, 80% power, safe to check daily)`));
125
- if (traffic) {
126
- if (traffic.daysLeft === null) console.log(c.yellow(`${id} has no visitors yet, so there's no pace to go by.`));
127
- else if (traffic.daysLeft === 0) console.log(c.green(`${id} already has enough visitors (${traffic.visitors.toLocaleString("en-US")}).`));
128
- else console.log(`About ${traffic.daysLeft} more days for ${id} at ${traffic.perDay.toLocaleString("en-US")} visitors a day.`);
129
- }
130
- }
131
- export {
132
- plan,
133
- planSample2 as planSample
134
- };
135
- //# sourceMappingURL=plan-BSFSMKTU.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../stats/src/math.ts","../../stats/src/plan.ts","../../stats/src/sequential.ts","../../stats/src/metrics.ts","../../stats/src/verdict.ts","../../stats/src/revenue.ts","../src/commands/plan.ts"],"sourcesContent":["/** Lanczos approximation of ln Γ(x). */\nexport function logGamma(x: number): number {\n const g = [\n 676.5203621218851, -1259.1392167224028, 771.32342877765313, -176.61502916214059,\n 12.507343278686905, -0.13857109526572012, 9.9843695780195716e-6, 1.5056327351493116e-7,\n ];\n if (x < 0.5) return Math.log(Math.PI / Math.sin(Math.PI * x)) - logGamma(1 - x);\n const z = x - 1;\n let a = 0.99999999999980993;\n const t = z + 7.5;\n for (let i = 0; i < g.length; i++) a += g[i]! / (z + i + 1);\n return 0.5 * Math.log(2 * Math.PI) + (z + 0.5) * Math.log(t) - t + Math.log(a);\n}\n\n/** Regularized lower incomplete gamma P(a, x). */\nexport function regularizedGammaP(a: number, x: number): number {\n if (x <= 0) return 0;\n if (x < a + 1) {\n let sum = 1 / a;\n let term = sum;\n for (let n = 1; n < 200; n++) {\n term *= x / (a + n);\n sum += term;\n if (Math.abs(term) < Math.abs(sum) * 1e-14) break;\n }\n return sum * Math.exp(-x + a * Math.log(x) - logGamma(a));\n }\n const tiny = 1e-30;\n let b = x + 1 - a;\n let c = 1 / tiny;\n let d = 1 / b;\n let h = d;\n for (let i = 1; i < 200; i++) {\n const an = -i * (i - a);\n b += 2;\n d = an * d + b;\n if (Math.abs(d) < tiny) d = tiny;\n c = b + an / c;\n if (Math.abs(c) < tiny) c = tiny;\n d = 1 / d;\n const del = d * c;\n h *= del;\n if (Math.abs(del - 1) < 1e-14) break;\n }\n return 1 - Math.exp(-x + a * Math.log(x) - logGamma(a)) * h;\n}\n\n/** Chi-square upper-tail p-value. */\nexport function chiSquarePValue(chi2: number, df: number): number {\n if (df <= 0 || chi2 <= 0) return 1;\n return 1 - regularizedGammaP(df / 2, chi2 / 2);\n}\n\nexport function erf(x: number): number {\n const sign = x < 0 ? -1 : 1;\n return sign * regularizedGammaP(0.5, x * x);\n}\n\n/** Standard normal CDF. */\nexport function normalCdf(z: number): number {\n return 0.5 * (1 + erf(z / Math.SQRT2));\n}\n\n/** Inverse standard normal CDF (Acklam). */\nexport function inverseNormalCdf(p: number): number {\n if (p <= 0) return -Infinity;\n if (p >= 1) return Infinity;\n const a = [-3.969683028665376e1, 2.209460984245205e2, -2.759285104469687e2, 1.38357751867269e2, -3.066479806614716e1, 2.506628277459239];\n const b = [-5.447609879822406e1, 1.615858368580409e2, -1.556989798598866e2, 6.680131188771972e1, -1.328068155288572e1];\n const c = [-7.784894002430293e-3, -3.223964580411365e-1, -2.400758277161838, -2.549732539343734, 4.374664141464968, 2.938163982698783];\n const d = [7.784695709041462e-3, 3.224671290700398e-1, 2.445134137142996, 3.754408661907416];\n const pLow = 0.02425;\n let q: number;\n if (p < pLow) {\n q = Math.sqrt(-2 * Math.log(p));\n return (((((c[0]! * q + c[1]!) * q + c[2]!) * q + c[3]!) * q + c[4]!) * q + c[5]!) / ((((d[0]! * q + d[1]!) * q + d[2]!) * q + d[3]!) * q + 1);\n }\n if (p > 1 - pLow) {\n q = Math.sqrt(-2 * Math.log(1 - p));\n return -(((((c[0]! * q + c[1]!) * q + c[2]!) * q + c[3]!) * q + c[4]!) * q + c[5]!) / ((((d[0]! * q + d[1]!) * q + d[2]!) * q + d[3]!) * q + 1);\n }\n q = p - 0.5;\n const r = q * q;\n return ((((((a[0]! * r + a[1]!) * r + a[2]!) * r + a[3]!) * r + a[4]!) * r + a[5]!) * q) / (((((b[0]! * r + b[1]!) * r + b[2]!) * r + b[3]!) * r + b[4]!) * r + 1);\n}\n\n/** Continued fraction for the regularized incomplete beta (Numerical Recipes betacf). */\nfunction betaContinuedFraction(x: number, a: number, b: number): number {\n const tiny = 1e-30;\n const qab = a + b;\n const qap = a + 1;\n const qam = a - 1;\n let c = 1;\n let d = 1 - (qab * x) / qap;\n if (Math.abs(d) < tiny) d = tiny;\n d = 1 / d;\n let h = d;\n for (let m = 1; m <= 300; m++) {\n const m2 = 2 * m;\n let aa = (m * (b - m) * x) / ((qam + m2) * (a + m2));\n d = 1 + aa * d;\n if (Math.abs(d) < tiny) d = tiny;\n c = 1 + aa / c;\n if (Math.abs(c) < tiny) c = tiny;\n d = 1 / d;\n h *= d * c;\n aa = (-(a + m) * (qab + m) * x) / ((a + m2) * (qap + m2));\n d = 1 + aa * d;\n if (Math.abs(d) < tiny) d = tiny;\n c = 1 + aa / c;\n if (Math.abs(c) < tiny) c = tiny;\n d = 1 / d;\n const del = d * c;\n h *= del;\n if (Math.abs(del - 1) < 1e-14) break;\n }\n return h;\n}\n\n/** Regularized incomplete beta I_x(a, b). */\nexport function regularizedBeta(x: number, a: number, b: number): number {\n if (x <= 0) return 0;\n if (x >= 1) return 1;\n const front = Math.exp(logGamma(a + b) - logGamma(a) - logGamma(b) + a * Math.log(x) + b * Math.log(1 - x));\n return x < (a + 1) / (a + b + 2) ? (front * betaContinuedFraction(x, a, b)) / a : 1 - (front * betaContinuedFraction(1 - x, b, a)) / b;\n}\n\n/** Student t CDF with `df` degrees of freedom (any positive real df, as Welch needs). */\nexport function studentTCdf(t: number, df: number): number {\n if (!Number.isFinite(df) || df > 1e7) return normalCdf(t);\n const tail = 0.5 * regularizedBeta(df / (df + t * t), df / 2, 0.5);\n return t >= 0 ? 1 - tail : tail;\n}\n\n/** Inverse Student t CDF by bisection on the CDF (monotone); fine for CI widths. */\nexport function inverseStudentT(p: number, df: number): number {\n if (p <= 0) return -Infinity;\n if (p >= 1) return Infinity;\n if (!Number.isFinite(df) || df > 1e7) return inverseNormalCdf(p);\n let lo = -1;\n let hi = 1;\n while (studentTCdf(lo, df) > p) lo *= 2;\n while (studentTCdf(hi, df) < p) hi *= 2;\n for (let i = 0; i < 100; i++) {\n const mid = (lo + hi) / 2;\n if (studentTCdf(mid, df) < p) lo = mid;\n else hi = mid;\n if (hi - lo < 1e-10) break;\n }\n return (lo + hi) / 2;\n}\n","import { inverseNormalCdf } from './math';\n\n/**\n * Classic fixed-horizon sample size per variant to detect a relative lift at\n * the given confidence and power (two-sided, equal split). Null when not estimable.\n */\nexport function requiredExposuresPerVariant(baselineRate: number, relativeLift: number, confidence = 0.95, power = 0.8): number | null {\n if (baselineRate <= 0 || baselineRate >= 1 || !Number.isFinite(relativeLift) || relativeLift === 0) return null;\n const p1 = baselineRate;\n const p2 = Math.min(0.999, Math.max(0.001, p1 * (1 + relativeLift)));\n const zA = inverseNormalCdf(1 - (1 - confidence) / 2);\n const zB = inverseNormalCdf(power);\n const pBar = (p1 + p2) / 2;\n const n = Math.pow(zA * Math.sqrt(2 * pBar * (1 - pBar)) + zB * Math.sqrt(p1 * (1 - p1) + p2 * (1 - p2)), 2) / Math.pow(p2 - p1, 2);\n return Math.ceil(n);\n}\n","import { inverseNormalCdf } from './math';\nimport { requiredExposuresPerVariant } from './plan';\n\n/**\n * Always-valid inference (mixture SPRT, Johari et al. 2017, the method behind\n * Optimizely's Stats Engine). Agents poll results all the time; a fixed-horizon\n * p-value checked on every poll inflates false positives far beyond 5%. The\n * mixture likelihood ratio Λ is a martingale under \"no difference\", so\n * P(Λ ever exceeds 1/α) ≤ α however often you look.\n *\n * With an estimate θ̂ (variance V) and a N(0, τ²) prior on the true effect:\n * Λ = sqrt(V / (V + τ²)) · exp(θ̂² τ² / (2 V (V + τ²)))\n * p = min(1, 1/Λ) and the confidence sequence is every θ0 whose Λ stays < 1/α.\n */\nexport interface SequentialEstimate {\n /** Always-valid p-value: safe to read at any time. */\n pValue: number;\n /** Always-valid (1 - alpha) confidence interval of the effect. */\n ci: { low: number; high: number };\n}\n\nexport function mixtureSPRT(estimate: number, variance: number, tau2: number, alpha: number): SequentialEstimate {\n if (!(variance > 0) || !(tau2 > 0) || !Number.isFinite(estimate)) return { pValue: 1, ci: { low: estimate, high: estimate } };\n const total = variance + tau2;\n const logLambda = 0.5 * Math.log(variance / total) + (estimate * estimate * tau2) / (2 * variance * total);\n const pValue = Math.min(1, Math.exp(-logLambda));\n const half = Math.sqrt(((variance * total) / tau2) * (Math.log(total / variance) - 2 * Math.log(alpha)));\n return { pValue, ci: { low: estimate - half, high: estimate + half } };\n}\n\n/** Half-width of the always-valid interval at a given variance. */\nfunction boundary(variance: number, tau2: number, alpha: number): number {\n const total = variance + tau2;\n return Math.sqrt(((variance * total) / tau2) * (Math.log(total / variance) - 2 * Math.log(alpha)));\n}\n\n/**\n * Holm-Bonferroni step-down: which hypotheses to reject at family-wise `alpha`.\n * Uniformly more powerful than plain Bonferroni, same guarantee.\n */\nexport function holm(pValues: number[], alpha: number): boolean[] {\n const m = pValues.length;\n const order = pValues.map((p, i) => ({ p, i })).sort((a, b) => a.p - b.p);\n const out = new Array<boolean>(m).fill(false);\n for (let k = 0; k < m; k++) {\n const { p, i } = order[k]!;\n if (!(p < alpha / (m - k))) break;\n out[i] = true;\n }\n return out;\n}\n\n/**\n * Prior scale of the mixture for a two-proportion test: the mixture expects\n * effects around `mixture` (relative) of the pooled rate. Tuned to the minimum\n * effect worth detecting, so small real effects are not drowned out.\n */\n/**\n * Default relative effect scale of the mixing prior. Simulated plans show the\n * sample needed is flat between 0.1 and 0.3 for lifts of 5%–100%, about twice\n * the fixed-horizon figure; 0.2 sits in the middle.\n */\nexport const DEFAULT_MIXTURE = 0.2;\n\nexport function proportionTau2(pooledRate: number, mixture: number): number {\n return Math.pow(mixture * pooledRate, 2);\n}\n\nexport interface SequentialPlanInput {\n baselineRate: number;\n /** Relative lift to detect (0.1 = +10%). */\n relativeLift: number;\n /** Per-comparison alpha (already divided by the number of comparisons). */\n alpha?: number;\n power?: number;\n /** Relative effect scale of the mixing prior. */\n mixture?: number;\n}\n\n/**\n * Visitors per variant at which the always-valid test reaches `power` for the\n * given lift (the mixture boundary is wider than the fixed z = 1.96, so this is\n * larger than the classic figure). Null when not estimable.\n */\nexport function sequentialExposuresPerVariant({ baselineRate, relativeLift, alpha = 0.05, power = 0.8, mixture = DEFAULT_MIXTURE }: SequentialPlanInput): number | null {\n if (baselineRate <= 0 || baselineRate >= 1 || !Number.isFinite(relativeLift) || relativeLift === 0) return null;\n const p1 = baselineRate;\n const p2 = Math.min(0.999, Math.max(0.001, p1 * (1 + relativeLift)));\n const theta = Math.abs(p2 - p1);\n const unit = p1 * (1 - p1) + p2 * (1 - p2);\n const tau2 = proportionTau2((p1 + p2) / 2, mixture);\n const zB = inverseNormalCdf(power);\n const enough = (n: number) => {\n const v = unit / n;\n return theta >= boundary(v, tau2, alpha) + zB * Math.sqrt(v);\n };\n let lo = Math.max(1, (requiredExposuresPerVariant(p1, relativeLift, 1 - alpha, power) ?? 2) - 1);\n if (enough(lo)) return Math.ceil(lo);\n let hi = lo * 2;\n while (!enough(hi)) {\n lo = hi;\n hi *= 2;\n if (hi > 1e12) return null;\n }\n while (hi - lo > 1) {\n const mid = Math.floor((lo + hi) / 2);\n if (enough(mid)) hi = mid;\n else lo = mid;\n }\n return hi;\n}\n\nexport interface PlanSampleInput {\n /** Control conversion rate, 0..1. */\n baselineRate: number;\n /** Minimum detectable effect, relative (0.1 = +10%). */\n mde: number;\n /** Family-wise false positive rate. Default 0.05. */\n alpha?: number;\n /** Default 0.8. */\n power?: number;\n /** Number of variants including the control. Default 2. Alpha is split over the comparisons. */\n variants?: number;\n /**\n * true (default): visitors SplitHub's always-valid verdict needs, the number\n * that matches `computeVerdict`. false: the classic fixed-horizon figure.\n */\n sequential?: boolean;\n /** Relative effect scale of the mixing prior; defaults to the verdict's. */\n mixture?: number;\n}\n\n/** Visitors per variant to plan for. Null when not estimable (rate outside 0..1, mde 0). */\nexport function planSample({ baselineRate, mde, alpha = 0.05, power = 0.8, variants = 2, sequential = true, mixture }: PlanSampleInput): number | null {\n const comparisons = Math.max(1, Math.floor(variants) - 1);\n const a = alpha / comparisons;\n if (!sequential) return requiredExposuresPerVariant(baselineRate, mde, 1 - a, power);\n return sequentialExposuresPerVariant({ baselineRate, relativeLift: mde, alpha: a, power, mixture: mixture ?? DEFAULT_MIXTURE });\n}\n","import { normalCdf } from './math';\nimport { holm } from './sequential';\nimport { compareVariants, VERDICT_DEFAULTS, type Comparison, type VariantCounts } from './verdict';\n\n/** A goal read beside the primary one. */\nexport interface MetricInput {\n metric: string;\n role: 'secondary' | 'guardrail';\n /** Guardrails: which direction is bad. Default `lower`. */\n worse?: 'lower' | 'higher';\n /** Per-variant counts for this goal, control first, same variants as the primary goal. */\n counts: VariantCounts[];\n}\n\nexport interface MetricComparison extends Comparison {\n /**\n * Guardrails only: always-valid one-sided p-value that this variant is worse than\n * the control in the guardrail's bad direction. `significant` is decided on it.\n * Absent while either side is below the minimum sample: not judged yet.\n */\n harmPValue?: number;\n}\n\nexport interface MetricResult {\n metric: string;\n role: 'secondary' | 'guardrail';\n /** Guardrails: the bad direction. */\n worse?: 'lower' | 'higher';\n variants: VariantCounts[];\n /**\n * Secondary: two-sided, Holm-corrected across every secondary comparison of the experiment\n * (informational, never changes the verdict). Guardrail: `significant` means significantly\n * worse (one-sided), Holm-corrected across every guardrail comparison.\n */\n comparisons: MetricComparison[];\n}\n\n/** A variant that is significantly worse than the control on a guardrail. */\nexport interface GuardrailBreach {\n metric: string;\n variant: string;\n /** Relative change of the guardrail's conversion rate vs the control (negative = fewer conversions). */\n lift: number | null;\n /** One-sided always-valid p-value of the harm. */\n pValue: number;\n}\n\n/**\n * One-sided always-valid p-value from the two-sided mixture SPRT. With a N(0, τ²)\n * mixing prior, the half-normal mixture over effects in the bad direction is its\n * own test martingale: Λ₋ = 2Λ·P(θ in the bad direction | data), the posterior\n * being N(θ̂τ²/(V+τ²), Vτ²/(V+τ²)). So p₋ = min(1, p / (2·Φ(z))) with z the\n * posterior mean over its sd, signed towards harm.\n */\nexport function oneSidedPValue(twoSided: number, estimate: number, variance: number, tau2: number, bad: 'lower' | 'higher'): number {\n if (!(variance > 0) || !(tau2 > 0)) return 1;\n const z = (estimate * Math.sqrt(tau2)) / Math.sqrt(variance * (variance + tau2));\n const towardsHarm = bad === 'lower' ? -z : z;\n const share = normalCdf(towardsHarm);\n return share > 0 ? Math.min(1, twoSided / (2 * share)) : 1;\n}\n\nexport interface MetricOptions {\n confidence?: number;\n mixture?: number;\n /** Below this many visitors in the control or the variant, a guardrail is not judged. */\n minExposuresPerVariant?: number;\n}\n\n/**\n * Secondary metrics and guardrails, each compared with the control by the same\n * always-valid test as the primary goal. Two Holm families: all secondary\n * comparisons (two-sided), all guardrail comparisons (one-sided, harm only). The\n * primary goal's family is left alone, so adding metrics never weakens the verdict.\n */\nexport function compareMetrics(metrics: MetricInput[], options: MetricOptions = {}): { metrics: MetricResult[]; guardrailBreached: GuardrailBreach[] } {\n const confidence = options.confidence ?? VERDICT_DEFAULTS.confidence;\n const mixture = options.mixture ?? VERDICT_DEFAULTS.mixture;\n const minExposures = options.minExposuresPerVariant ?? VERDICT_DEFAULTS.minExposuresPerVariant;\n const alpha = 1 - confidence;\n\n const results: MetricResult[] = metrics.map((m) => {\n const comparisons: MetricComparison[] = compareVariants(m.counts, confidence, { mixture });\n if (m.role === 'guardrail') {\n const bad = m.worse ?? 'lower';\n for (const c of comparisons) {\n const p1 = c.baselineRate;\n const p2 = c.rate;\n const variance = (p1 * (1 - p1)) / Math.max(1, c.baselineExposures) + (p2 * (1 - p2)) / Math.max(1, c.exposures);\n const pooled = (c.baselineConversions + c.conversions) / Math.max(1, c.baselineExposures + c.exposures);\n const tau2 = Math.pow(mixture * pooled, 2);\n const enough = c.exposures >= minExposures && c.baselineExposures >= minExposures;\n if (enough) c.harmPValue = oneSidedPValue(c.sequential.pValue, c.absoluteLift, variance, tau2, bad);\n }\n }\n return { metric: m.metric, role: m.role, ...(m.role === 'guardrail' ? { worse: m.worse ?? 'lower' } : {}), variants: m.counts, comparisons };\n });\n\n // Holm within each family.\n for (const role of ['secondary', 'guardrail'] as const) {\n const family = results.filter((r) => r.role === role).flatMap((r) => r.comparisons);\n const rejected = holm(family.map((c) => (role === 'guardrail' ? (c.harmPValue ?? 1) : c.sequential.pValue)), alpha);\n family.forEach((c, i) => (c.significant = rejected[i]!));\n }\n\n const guardrailBreached: GuardrailBreach[] = [];\n for (const r of results) {\n if (r.role !== 'guardrail') continue;\n for (const c of r.comparisons) if (c.significant) guardrailBreached.push({ metric: r.metric, variant: c.variant, lift: c.relativeLift, pValue: c.harmPValue ?? 1 });\n }\n return { metrics: results, guardrailBreached };\n}\n","import { chiSquarePValue, inverseNormalCdf, normalCdf } from './math';\nimport { requiredExposuresPerVariant } from './plan';\nimport { compareMetrics, type GuardrailBreach, type MetricInput, type MetricResult } from './metrics';\nimport { DEFAULT_MIXTURE, holm, mixtureSPRT, proportionTau2, sequentialExposuresPerVariant, type SequentialEstimate } from './sequential';\n\nexport { requiredExposuresPerVariant };\n\n/** Per-variant counts. Unit is the visitor: unique exposed, unique converted. */\nexport interface VariantCounts {\n variant: string;\n exposures: number;\n conversions: number;\n /** Optional revenue sum for the goal. */\n revenue?: number;\n /** Revenue summed per visitor over the variant's visitors (same as `revenue` when both are present). */\n revenueSum?: number;\n /** Sum over visitors of (that visitor's revenue)². With `revenueSum`, enables the revenue-per-visitor test. */\n revenueSumSq?: number;\n}\n\nexport interface Comparison {\n variant: string;\n baseline: string;\n exposures: number;\n conversions: number;\n baselineExposures: number;\n baselineConversions: number;\n rate: number;\n baselineRate: number;\n absoluteLift: number;\n relativeLift: number | null;\n zScore: number;\n /** Fixed-horizon p-value (z-test). Shown for reference; only valid if read once at a planned sample. */\n pValue: number;\n /**\n * Significant on the always-valid p-value (`sequential.pValue`), Holm-corrected\n * across every comparison of the experiment. This is what decisions use.\n */\n significant: boolean;\n /** The fixed-horizon test would call it significant (Holm on `pValue`). Reference only. */\n fixedSignificant: boolean;\n /** Fixed-horizon confidence interval of the absolute lift. */\n ci: { low: number; high: number };\n /** Always-valid p-value and confidence interval of the absolute lift: safe to read on every poll. */\n sequential: SequentialEstimate;\n /** Probability that this variant beats the baseline (normal approximation, flat prior). */\n probabilityToBeat: number;\n}\n\nexport interface SRM {\n chiSquare: number;\n df: number;\n pValue: number;\n threshold: number;\n detected: boolean;\n}\n\nexport type VerdictStatus =\n | 'no_data'\n | 'srm_detected'\n | 'insufficient_sample'\n | 'winner_found'\n | 'no_significant_difference'\n /** A variant is significantly worse on a guardrail metric: do not ship it. */\n | 'guardrail_breached';\n\nexport interface Verdict {\n experiment: string;\n status: VerdictStatus;\n /** One-sentence recommendation for a human or an agent. */\n message: string;\n computedAt: string;\n confidence: number;\n /** How decisions are made: always-valid (mixture SPRT) inference, safe under continuous monitoring. */\n method: 'sequential';\n /** Relative minimum detectable effect the plan is built on. */\n mde: number;\n /** Days of data so far, when known. */\n days: number | null;\n /** A verdict needs at least this many days (24-hour periods) of data. */\n minDays: number;\n sample: {\n totalExposures: number;\n totalConversions: number;\n variants: VariantCounts[];\n minExposuresPerVariant: number;\n minTotalConversions: number;\n /** Visitors per variant needed to reach a verdict (total, not additional), when insufficient. */\n neededPerVariant: number | null;\n /** Visitors per variant at which the test can rule out effects of `mde` (the planned horizon). */\n horizonPerVariant: number | null;\n };\n srm: SRM | null;\n comparisons: Comparison[];\n winner: string | null;\n /** Caveats, e.g. why the split check was skipped. */\n notes: string[];\n /** Secondary and guardrail metrics, when the experiment declares any. */\n metrics?: MetricResult[];\n /** Variants significantly worse than the control on a guardrail (empty when none; absent without guardrails). */\n guardrailBreached?: GuardrailBreach[];\n}\n\nexport const VERDICT_DEFAULTS = {\n minExposuresPerVariant: 100,\n minTotalConversions: 50,\n /**\n * One full day (24 hours since the first exposure), so the daily cycle is in the data.\n * Peeking safety comes from the sequential test, not from waiting; a verdict reached\n * in under a week carries a note about weekly cycles instead.\n */\n minDays: 1,\n /** Relative effect worth detecting; sets the horizon for \"no difference\". */\n mde: 0.1,\n mixture: DEFAULT_MIXTURE,\n srmAlpha: 0.001,\n confidence: 0.95,\n} as const;\n\nexport interface VerdictOptions {\n minExposuresPerVariant?: number;\n minTotalConversions?: number;\n confidence?: number;\n /** Expected traffic shares (any scale). Defaults to an equal split. */\n expectedWeights?: number[];\n /** Skip the SRM check and record this reason in `notes` (e.g. targeting decides the split). */\n skipSrm?: string;\n /** Days the experiment has collected data, fractional (36 hours = 1.5). Unknown → the minimum runtime is not enforced. */\n days?: number;\n /** Minimum runtime in days before a verdict. Default 1; 0 = none. */\n minDays?: number;\n /** Relative minimum detectable effect. Default 0.1. */\n mde?: number;\n /** Relative effect scale of the mixing prior. Default 0.2. */\n mixture?: number;\n /** Always-valid p-values of other hypotheses in the same family (e.g. MVT factor effects), for Holm. */\n familyPValues?: number[];\n /** Secondary and guardrail goals, same variants as `counts`. A guardrail breach keeps a variant from being shipped. */\n metrics?: MetricInput[];\n now?: Date;\n}\n\nexport interface CompareOptions {\n mixture?: number;\n /** Always-valid p-values of other hypotheses tested alongside, included in the Holm correction. */\n familyPValues?: number[];\n}\n\n/** Chi-square goodness-of-fit of observed exposures vs expected shares. */\nexport function computeSRM(counts: VariantCounts[], expectedWeights?: number[], alpha: number = VERDICT_DEFAULTS.srmAlpha): SRM | null {\n const k = counts.length;\n if (k < 2) return null;\n let weights = expectedWeights && expectedWeights.length === k ? expectedWeights : new Array<number>(k).fill(1);\n const totalWeight = weights.reduce((s, w) => s + w, 0);\n if (totalWeight <= 0) return null;\n weights = weights.map((w) => w / totalWeight);\n\n const total = counts.reduce((s, c) => s + c.exposures, 0);\n if (total === 0) return null;\n\n let chi2 = 0;\n for (let i = 0; i < k; i++) {\n const expected = total * weights[i]!;\n if (expected === 0) continue;\n chi2 += Math.pow(counts[i]!.exposures - expected, 2) / expected;\n }\n const df = k - 1;\n const pValue = chiSquarePValue(chi2, df);\n return { chiSquare: chi2, df, pValue, threshold: alpha, detected: pValue < alpha };\n}\n\n/**\n * Each variant against the first one: fixed-horizon z-test (for display) and\n * always-valid mixture SPRT (for decisions), Holm-corrected across comparisons.\n */\nexport function compareVariants(counts: VariantCounts[], confidence: number = VERDICT_DEFAULTS.confidence, options: CompareOptions = {}): Comparison[] {\n const baseline = counts[0];\n if (!baseline || baseline.exposures === 0) return [];\n const alpha = 1 - confidence;\n const zCrit = inverseNormalCdf(1 - alpha / 2);\n const mixture = options.mixture ?? VERDICT_DEFAULTS.mixture;\n\n const comparisons = counts.slice(1).map((variant): Comparison => {\n const p1 = baseline.conversions / baseline.exposures;\n const p2 = variant.exposures > 0 ? variant.conversions / variant.exposures : 0;\n const pooled = (baseline.conversions + variant.conversions) / (baseline.exposures + variant.exposures);\n const sePooled = Math.sqrt(pooled * (1 - pooled) * (1 / baseline.exposures + 1 / Math.max(1, variant.exposures)));\n const z = sePooled > 0 ? (p2 - p1) / sePooled : 0;\n const pValue = 2 * (1 - normalCdf(Math.abs(z)));\n const varUnpooled = (p1 * (1 - p1)) / baseline.exposures + (p2 * (1 - p2)) / Math.max(1, variant.exposures);\n const seUnpooled = Math.sqrt(varUnpooled);\n // Plug-in (unpooled) variance so the always-valid p-value and interval always agree.\n const sequential = variant.exposures > 0 ? mixtureSPRT(p2 - p1, varUnpooled, proportionTau2(pooled, mixture), alpha) : { pValue: 1, ci: { low: -1, high: 1 } };\n return {\n variant: variant.variant,\n baseline: baseline.variant,\n exposures: variant.exposures,\n conversions: variant.conversions,\n baselineExposures: baseline.exposures,\n baselineConversions: baseline.conversions,\n rate: p2,\n baselineRate: p1,\n absoluteLift: p2 - p1,\n relativeLift: p1 > 0 ? (p2 - p1) / p1 : null,\n zScore: z,\n pValue,\n significant: false,\n fixedSignificant: false,\n ci: { low: p2 - p1 - zCrit * seUnpooled, high: p2 - p1 + zCrit * seUnpooled },\n sequential: { pValue: sequential.pValue, ci: { low: Math.max(-1, sequential.ci.low), high: Math.min(1, sequential.ci.high) } },\n probabilityToBeat: seUnpooled > 0 ? normalCdf((p2 - p1) / seUnpooled) : 0.5,\n };\n });\n\n const family = options.familyPValues ?? [];\n const seq = holm([...comparisons.map((c) => c.sequential.pValue), ...family], alpha);\n const fixed = holm(comparisons.map((c) => c.pValue), alpha);\n comparisons.forEach((c, i) => {\n c.significant = seq[i]!;\n c.fixedSignificant = fixed[i]!;\n });\n return comparisons;\n}\n\nfunction pct(x: number | null): string {\n return x === null ? 'n/a' : `${x >= 0 ? '+' : ''}${(x * 100).toFixed(1)}%`;\n}\n\nfunction plural(n: number, word: string): string {\n return `${n} ${word}${n === 1 ? '' : 's'}`;\n}\n\n/** Days a verdict reached before this many days of data gets the weekly-cycle note. */\nconst FULL_WEEK = 7;\nconst UNDER_A_WEEK = 'Ran under a week. Weekend visitors may behave differently; keep it running a few more days if that matters.';\n\n/** \"5 more hours\" under a day, \"2 more days\" above. */\nfunction waitFor(daysLeft: number): string {\n return daysLeft < 1 ? plural(Math.max(1, Math.ceil(daysLeft * 24)), 'more hour') : plural(Math.ceil(daysLeft), 'more day');\n}\n\nfunction fullDays(minDays: number): string {\n return minDays === 1 ? 'a full day of visitors is in' : `${minDays} full days of visitors are in`;\n}\n\n/**\n * Verdict from per-variant counts. Order of checks:\n * data present → SRM → minimum sample → always-valid significance → minimum runtime.\n *\n * Decisions are peeking-safe: a winner needs the always-valid p-value (mixture\n * SPRT, Holm across comparisons) below 1 - confidence; \"no difference\" needs the\n * always-valid interval of every comparison inside ±mde of the control rate, or\n * every variant past the horizon where the test has 80% power for `mde`. When\n * `days` is known, neither is announced before `minDays` (default one full day),\n * and a decision reached in under a week carries a note about weekly cycles.\n */\nexport function computeVerdict(experiment: string, counts: VariantCounts[], options: VerdictOptions = {}): Verdict {\n const verdict = primaryVerdict(experiment, counts, options);\n if (!options.metrics?.length) return verdict;\n const { metrics, guardrailBreached } = compareMetrics(options.metrics, {\n confidence: options.confidence,\n mixture: options.mixture,\n minExposuresPerVariant: options.minExposuresPerVariant,\n });\n const out: Verdict = { ...verdict, metrics, guardrailBreached };\n if (verdict.status === 'no_data' || verdict.status === 'srm_detected' || guardrailBreached.length === 0) return out;\n\n const control = counts[0]?.variant;\n const harm = (b: GuardrailBreach) => `hurts ${b.metric} (${pct(b.lift)}, always-valid p=${b.pValue.toFixed(4)})`;\n const winnerHurts = verdict.winner && verdict.winner !== control ? guardrailBreached.find((b) => b.variant === verdict.winner) : undefined;\n if (winnerHurts) {\n const w = verdict.comparisons.find((c) => c.variant === winnerHurts.variant);\n return {\n ...out,\n status: 'guardrail_breached',\n winner: null,\n message: `\"${winnerHurts.variant}\" wins (${pct(w?.relativeLift ?? null)}) but ${harm(winnerHurts)}. Don't ship it yet; find out what broke first.`,\n };\n }\n if (verdict.status === 'winner_found') {\n // The decided winner is clean (or it is the control): the call stands, the harm is a caveat.\n return { ...out, notes: [...out.notes, ...guardrailBreached.map((b) => `\"${b.variant}\" ${harm(b)}.`)] };\n }\n const first = guardrailBreached[0]!;\n return {\n ...out,\n status: 'guardrail_breached',\n winner: null,\n message: `Don't ship \"${first.variant}\": it ${harm(first)}. Finish the test or fix what broke.`,\n notes: [...out.notes, ...guardrailBreached.slice(1).map((b) => `\"${b.variant}\" ${harm(b)}.`)],\n };\n}\n\nfunction primaryVerdict(experiment: string, counts: VariantCounts[], options: VerdictOptions): Verdict {\n const minExposures = options.minExposuresPerVariant ?? VERDICT_DEFAULTS.minExposuresPerVariant;\n const minConversions = options.minTotalConversions ?? VERDICT_DEFAULTS.minTotalConversions;\n const confidence = options.confidence ?? VERDICT_DEFAULTS.confidence;\n const minDays = options.minDays ?? VERDICT_DEFAULTS.minDays;\n const mde = Math.abs(options.mde ?? VERDICT_DEFAULTS.mde);\n const mixture = options.mixture ?? VERDICT_DEFAULTS.mixture;\n const days = options.days ?? null;\n const alpha = 1 - confidence;\n const notes: string[] = [];\n\n const totalExposures = counts.reduce((s, c) => s + c.exposures, 0);\n const totalConversions = counts.reduce((s, c) => s + c.conversions, 0);\n const base = {\n experiment,\n computedAt: (options.now ?? new Date()).toISOString(),\n confidence,\n method: 'sequential' as const,\n mde,\n days,\n minDays,\n sample: {\n totalExposures,\n totalConversions,\n variants: counts,\n minExposuresPerVariant: minExposures,\n minTotalConversions: minConversions,\n neededPerVariant: null as number | null,\n horizonPerVariant: null as number | null,\n },\n notes,\n };\n\n if (counts.length < 2 || totalExposures === 0) {\n return { ...base, status: 'no_data', message: 'No data yet. Check that the SDK is installed and the experiment is running.', srm: null, comparisons: [], winner: null };\n }\n\n let srm: SRM | null = null;\n if (options.skipSrm) notes.push(options.skipSrm);\n else srm = computeSRM(counts, options.expectedWeights);\n if (srm?.detected) {\n return {\n ...base,\n status: 'srm_detected',\n message: `Sample ratio mismatch (p=${srm.pValue.toExponential(1)}): variants receive traffic that does not match the configured weights. Results cannot be trusted; run \\`splithub doctor\\`.`,\n srm,\n comparisons: [],\n winner: null,\n };\n }\n\n const comparisons = compareVariants(counts, confidence, { mixture, familyPValues: options.familyPValues });\n const family = comparisons.length + (options.familyPValues?.length ?? 0);\n const perTestAlpha = alpha / Math.max(1, family);\n const control = counts[0]!;\n const controlRate = control.exposures > 0 ? control.conversions / control.exposures : 0;\n const horizon = sequentialExposuresPerVariant({ baselineRate: controlRate, relativeLift: mde, alpha: perTestAlpha, mixture });\n // Visitors needed to settle the experiment: confirm the current leader, or reach the horizon, whichever comes first.\n const leader = comparisons.slice().sort((a, b) => Math.abs(b.relativeLift ?? 0) - Math.abs(a.relativeLift ?? 0))[0];\n const forLeader = leader && leader.relativeLift ? sequentialExposuresPerVariant({ baselineRate: controlRate, relativeLift: leader.relativeLift, alpha: perTestAlpha, mixture }) : null;\n const neededRaw = forLeader !== null && horizon !== null ? Math.min(forLeader, horizon) : (forLeader ?? horizon);\n const needed = neededRaw === null ? null : Math.max(neededRaw, minExposures);\n const sample = { ...base.sample, horizonPerVariant: horizon };\n // Fractional: one day means 24 hours elapsed, not a calendar date change.\n const daysLeft = days !== null && days < minDays ? minDays - days : 0;\n const underAWeek = () => {\n if (days !== null && days < FULL_WEEK) notes.push(UNDER_A_WEEK);\n };\n\n if (counts.some((c) => c.exposures < minExposures) || totalConversions < minConversions) {\n return {\n ...base,\n sample: { ...sample, neededPerVariant: needed },\n status: 'insufficient_sample',\n message: `Too early: need at least ${minExposures} visitors per variant and ${minConversions} conversions in total${needed ? ` (about ${needed} visitors per variant for a verdict)` : ''}. Keep it running.`,\n srm,\n comparisons,\n winner: null,\n };\n }\n\n const winners = comparisons.filter((c) => c.significant && c.absoluteLift > 0).sort((a, b) => b.absoluteLift - a.absoluteLift);\n const losses = comparisons.filter((c) => c.significant && c.absoluteLift < 0).sort((a, b) => a.absoluteLift - b.absoluteLift);\n const decided = winners[0] ?? losses[0];\n if (decided && daysLeft > 0) {\n const lead = winners[0] ? `\"${decided.variant}\" leads (${pct(decided.relativeLift)})` : `\"${decided.variant}\" trails the control (${pct(decided.relativeLift)})`;\n return {\n ...base,\n sample: { ...sample, neededPerVariant: null },\n status: 'insufficient_sample',\n message: `${lead} and the gap is already significant, but wait ${waitFor(daysLeft)} so ${fullDays(minDays)}. Keep it running.`,\n srm,\n comparisons,\n winner: null,\n };\n }\n if (winners[0]) {\n const w = winners[0];\n underAWeek();\n return {\n ...base,\n sample,\n status: 'winner_found',\n message: `Stop: \"${w.variant}\" beats \"${w.baseline}\" (${pct(w.relativeLift)}, always-valid p=${w.sequential.pValue.toFixed(4)}). Ship \"${w.variant}\".`,\n srm,\n comparisons,\n winner: w.variant,\n };\n }\n if (losses[0]) {\n const l = losses[0];\n underAWeek();\n return {\n ...base,\n sample,\n status: 'winner_found',\n message: `Stop: \"${l.baseline}\" wins. \"${l.variant}\" is significantly worse (${pct(l.relativeLift)}, always-valid p=${l.sequential.pValue.toFixed(4)}). Keep \"${l.baseline}\".`,\n srm,\n comparisons,\n winner: l.baseline,\n };\n }\n\n // \"No difference\" must be earned too: every interval rules out an mde-sized effect, or the horizon is reached.\n const bound = mde * controlRate;\n const equivalent = controlRate > 0 && comparisons.every((c) => c.sequential.ci.low > -bound && c.sequential.ci.high < bound);\n const pastHorizon = horizon !== null && counts.every((c) => c.exposures >= horizon);\n if ((equivalent || pastHorizon) && daysLeft === 0) {\n underAWeek();\n return {\n ...base,\n sample,\n status: 'no_significant_difference',\n message: `No difference of ${pct(mde).slice(1)} or more. Stop and keep the control, or test a bolder change.`,\n srm,\n comparisons,\n winner: null,\n };\n }\n\n const wait = equivalent || pastHorizon ? `wait ${waitFor(daysLeft)} so ${fullDays(minDays)}` : `${needed ? `about ${needed} visitors per variant` : 'more visitors'} will settle it`;\n return {\n ...base,\n sample: { ...sample, neededPerVariant: equivalent || pastHorizon ? null : needed },\n status: 'insufficient_sample',\n message: `No clear difference yet; ${wait}. Keep it running.`,\n srm,\n comparisons,\n winner: null,\n };\n}\n\n/**\n * Days until `computeVerdict` can decide at the current traffic. 0 when it has\n * decided, null when there is no estimate (no data, SRM, no traffic, no plan).\n */\nexport function estimateDaysToVerdict(verdict: Verdict, visitorsPerDay: number | null | undefined): number | null {\n if (verdict.status === 'winner_found' || verdict.status === 'no_significant_difference' || verdict.status === 'guardrail_breached') return 0;\n if (verdict.status !== 'insufficient_sample') return null;\n const daysLeft = verdict.days !== null && verdict.days < verdict.minDays ? verdict.minDays - verdict.days : 0;\n const needed = verdict.sample.neededPerVariant;\n if (needed === null) return daysLeft > 0 ? Math.ceil(daysLeft) : null;\n if (!visitorsPerDay || !(visitorsPerDay > 0)) return null;\n const total = verdict.sample.totalExposures;\n const variants = verdict.sample.variants;\n // Each variant fills at its observed share of the traffic; the slowest one sets the pace.\n let bySample = 0;\n for (const v of variants) {\n const share = total > 0 && v.exposures > 0 ? v.exposures / total : 1 / variants.length;\n bySample = Math.max(bySample, Math.max(0, needed - v.exposures) / (visitorsPerDay * share));\n }\n return Math.ceil(Math.max(bySample, daysLeft));\n}\n","import { inverseStudentT, normalCdf, studentTCdf } from './math';\nimport { DEFAULT_MIXTURE, holm, mixtureSPRT, type SequentialEstimate } from './sequential';\n\n/** Sufficient statistics of a per-visitor metric (e.g. revenue, 0 for visitors who did not buy). */\nexport interface MetricMoments {\n /** Visitors. */\n n: number;\n /** Sum of the metric over visitors. */\n sum: number;\n /** Sum of the squared per-visitor metric. */\n sumSq: number;\n}\n\nexport interface WelchResult {\n meanA: number;\n meanB: number;\n /** meanB - meanA. */\n difference: number;\n relativeLift: number | null;\n t: number;\n /** Welch–Satterthwaite degrees of freedom. */\n df: number;\n /** Fixed-horizon two-sided p-value. */\n pValue: number;\n /** Fixed-horizon CI of the difference. */\n ci: { low: number; high: number };\n /** Probability that B's mean beats A's (normal approximation). */\n probabilityToBeat: number;\n /** Always-valid p-value and CI of the difference (mixture SPRT). */\n sequential: SequentialEstimate;\n}\n\nfunction moments(m: MetricMoments): { mean: number; variance: number } {\n const mean = m.n > 0 ? m.sum / m.n : 0;\n const variance = m.n > 1 ? Math.max(0, (m.sumSq - m.n * mean * mean) / (m.n - 1)) : 0;\n return { mean, variance };\n}\n\n/**\n * Welch's unequal-variance t-test of mean(B) - mean(A), plus its always-valid\n * counterpart. Null with fewer than two visitors on either side.\n */\nexport function welchTest(a: MetricMoments, b: MetricMoments, confidence = 0.95, mixture = DEFAULT_MIXTURE): WelchResult | null {\n if (a.n < 2 || b.n < 2) return null;\n const ma = moments(a);\n const mb = moments(b);\n const va = ma.variance / a.n;\n const vb = mb.variance / b.n;\n const v = va + vb;\n const diff = mb.mean - ma.mean;\n const alpha = 1 - confidence;\n const df = v > 0 ? (v * v) / ((va * va) / (a.n - 1) + (vb * vb) / (b.n - 1)) : a.n + b.n - 2;\n const se = Math.sqrt(v);\n const t = se > 0 ? diff / se : 0;\n const pValue = se > 0 ? 2 * (1 - studentTCdf(Math.abs(t), df)) : 1;\n const tCrit = inverseStudentT(1 - alpha / 2, df);\n const pooledMean = (a.sum + b.sum) / (a.n + b.n);\n return {\n meanA: ma.mean,\n meanB: mb.mean,\n difference: diff,\n relativeLift: ma.mean !== 0 ? diff / Math.abs(ma.mean) : null,\n t,\n df,\n pValue,\n ci: { low: diff - tCrit * se, high: diff + tCrit * se },\n probabilityToBeat: se > 0 ? normalCdf(diff / se) : 0.5,\n sequential: mixtureSPRT(diff, v, Math.pow(mixture * pooledMean, 2), alpha),\n };\n}\n\nexport interface MeanComparison extends WelchResult {\n variant: string;\n baseline: string;\n /** Significant on the always-valid p-value, Holm-corrected across comparisons. */\n significant: boolean;\n}\n\n/**\n * Every variant's per-visitor mean against the first one (the control).\n * Rows with fewer than two visitors are left out.\n */\nexport function compareMeans(rows: Array<MetricMoments & { variant: string }>, confidence = 0.95, mixture = DEFAULT_MIXTURE): MeanComparison[] {\n const base = rows[0];\n if (!base) return [];\n const out: MeanComparison[] = [];\n for (const row of rows.slice(1)) {\n const r = welchTest(base, row, confidence, mixture);\n if (r) out.push({ ...r, variant: row.variant, baseline: base.variant, significant: false });\n }\n const sig = holm(out.map((c) => c.sequential.pValue), 1 - confidence);\n out.forEach((c, i) => (c.significant = sig[i]!));\n return out;\n}\n","import { planSample as statsPlan } from '@splithub/stats';\nimport { fetchStatus, resolveTarget } from '../api';\nimport { fail, printJson } from '../errors';\nimport { detectProject } from '../project';\nimport { c } from '../ui';\nimport type { Flags } from './init';\n\nfunction num(flags: Flags, name: string): number | undefined {\n const v = flags[name];\n if (typeof v !== 'string' || v === '') return undefined;\n const n = Number(v.replace(/%$/, '')) / (v.endsWith('%') ? 100 : 1);\n if (!Number.isFinite(n)) fail('INVALID_FLAG', `--${name} \"${v}\" isn't a number.`);\n return n;\n}\n\nexport interface Plan {\n baseline: number;\n mde: number;\n variants: number;\n confidence: number;\n perVariant: number;\n total: number;\n}\n\n/**\n * Visitors per variant to detect a relative lift `mde` on a `baseline` rate with 80% power, sized for\n * the sequential test the verdict uses (safe to check any day). More variants split the error across comparisons.\n */\nexport function planSample(baseline: number, mde: number, variants = 2, confidence = 0.95): Plan {\n if (!(baseline > 0 && baseline < 1)) fail('INVALID_FLAG', `--baseline ${baseline} must be a rate between 0 and 1.`, 'For example --baseline 0.05 for 5% of visitors converting today.');\n if (!(mde > 0)) fail('INVALID_FLAG', `--mde ${mde} must be above 0.`, 'The smallest relative lift worth finding, e.g. --mde 0.1 for +10%.');\n if (!Number.isInteger(variants) || variants < 2) fail('INVALID_FLAG', '--variants must be a whole number of 2 or more.');\n const perVariant = statsPlan({ baselineRate: baseline, mde, alpha: 1 - confidence, variants });\n if (perVariant === null) fail('INVALID_FLAG', \"Those numbers don't give a sample size.\", 'Check --baseline and --mde.');\n return { baseline, mde, variants, confidence, perVariant, total: perVariant * variants };\n}\n\n/** `splithub plan --baseline 0.05 --mde 0.1 [--variants 2] [<id>]` */\nexport async function plan(id: string | undefined, flags: Flags): Promise<void> {\n const baseline = num(flags, 'baseline');\n const mde = num(flags, 'mde');\n if (baseline === undefined || mde === undefined) fail('USAGE', 'Pass --baseline (conversion rate today) and --mde (smallest lift worth finding).', 'For example: npx splithub plan --baseline 0.05 --mde 0.1');\n const variants = num(flags, 'variants') ?? 2;\n const p = planSample(baseline, mde, variants);\n\n // With an experiment id: days at its current traffic.\n let traffic: { experiment: string; visitors: number; days: number; perDay: number; daysLeft: number | null } | null = null;\n if (id) {\n const data = await fetchStatus(resolveTarget(flags, detectProject()));\n const row = data.experiments.find((e) => e.experiment === id);\n if (!row) fail('EXPERIMENT_NOT_FOUND', `There's no experiment \"${id}\" in the results.`, 'See the ids with npx splithub status.');\n const perDay = row.days > 0 ? row.visitors / row.days : 0;\n traffic = { experiment: id, visitors: row.visitors, days: row.days, perDay: Math.round(perDay), daysLeft: perDay > 0 ? Math.max(0, Math.ceil((p.total - row.visitors) / perDay)) : null };\n }\n\n if (flags.json) {\n printJson({ ...p, traffic });\n return;\n }\n console.log(`${c.bold(p.perVariant.toLocaleString('en-US'))} visitors per variant, ${p.total.toLocaleString('en-US')} in all`);\n console.log(c.dim(`to find a ${(mde * 100).toFixed(0)}% lift on a ${(baseline * 100).toFixed(1)}% rate (95% confidence, 80% power, safe to check daily)`));\n if (traffic) {\n if (traffic.daysLeft === null) console.log(c.yellow(`${id} has no visitors yet, so there's no pace to go by.`));\n else if (traffic.daysLeft === 0) console.log(c.green(`${id} already has enough visitors (${traffic.visitors.toLocaleString('en-US')}).`));\n else console.log(`About ${traffic.daysLeft} more days for ${id} at ${traffic.perDay.toLocaleString('en-US')} visitors a day.`);\n }\n}\n"],"mappings":"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","names":["c","planSample"]}
@@ -1,16 +0,0 @@
1
- #!/usr/bin/env node
2
- import {
3
- configDiff,
4
- pull,
5
- push
6
- } from "./chunk-A2RCSPG6.js";
7
- import "./chunk-3VY5CP3E.js";
8
- import "./chunk-EUF75FUC.js";
9
- import "./chunk-PLXDG4B5.js";
10
- import "./chunk-V3DLUVOE.js";
11
- export {
12
- configDiff,
13
- pull,
14
- push
15
- };
16
- //# sourceMappingURL=push-YVS25VVD.js.map