@egbe-ai/opencode 0.0.0-stage → 0.1.8

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 (479) hide show
  1. package/LICENSE +4 -0
  2. package/README.md +124 -2
  3. package/index.js +5 -0
  4. package/package.json +55 -4
  5. package/plugin.js +230 -0
  6. package/session-log.js +315 -0
  7. package/skills/.egbe-catalog/manifest.json +1 -0
  8. package/skills/egbe-os-analytics/SKILL.md +499 -0
  9. package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
  10. package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
  11. package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
  12. package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
  13. package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
  14. package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
  15. package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
  16. package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
  17. package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
  18. package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
  19. package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
  20. package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
  21. package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
  22. package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
  23. package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
  24. package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
  25. package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
  26. package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
  27. package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
  28. package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
  29. package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
  30. package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
  31. package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
  32. package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
  33. package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
  34. package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
  35. package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
  36. package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
  37. package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
  38. package/skills/egbe-os-db/SKILL.md +174 -0
  39. package/skills/egbe-os-deploy/SKILL.md +412 -0
  40. package/skills/egbe-os-design/SKILL.md +182 -0
  41. package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
  42. package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
  43. package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
  44. package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
  45. package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
  46. package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
  47. package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
  48. package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
  49. package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
  50. package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
  51. package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
  52. package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
  53. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
  54. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
  55. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
  56. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
  57. package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
  58. package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
  59. package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
  60. package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
  61. package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
  62. package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
  63. package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
  64. package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
  65. package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
  66. package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
  67. package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
  68. package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
  69. package/skills/egbe-os-destination-readiness/references/report.md +116 -0
  70. package/skills/egbe-os-domains/SKILL.md +189 -0
  71. package/skills/egbe-os-errors/SKILL.md +259 -0
  72. package/skills/egbe-os-git/SKILL.md +275 -0
  73. package/skills/egbe-os-git/references/issues.md +33 -0
  74. package/skills/egbe-os-google-ads/SKILL.md +163 -0
  75. package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
  76. package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
  77. package/skills/egbe-os-google-ads/references/conversions.md +153 -0
  78. package/skills/egbe-os-google-ads/references/delivery.md +128 -0
  79. package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
  80. package/skills/egbe-os-google-ads/references/reporting.md +105 -0
  81. package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
  82. package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
  83. package/skills/egbe-os-google-auth/SKILL.md +285 -0
  84. package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
  85. package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
  86. package/skills/egbe-os-images/SKILL.md +163 -0
  87. package/skills/egbe-os-images/references/stock-images.md +21 -0
  88. package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
  89. package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
  90. package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
  91. package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
  92. package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
  93. package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
  94. package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
  95. package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
  96. package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
  97. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
  98. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
  99. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
  100. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
  101. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
  102. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
  103. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
  104. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
  105. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
  106. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
  107. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
  108. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
  109. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
  110. package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
  111. package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
  112. package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
  113. package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
  114. package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
  115. package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
  116. package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
  117. package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
  118. package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
  119. package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
  120. package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
  121. package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
  122. package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
  123. package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
  124. package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
  125. package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
  126. package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
  127. package/skills/egbe-os-llm/SKILL.md +160 -0
  128. package/skills/egbe-os-mail/SKILL.md +180 -0
  129. package/skills/egbe-os-me/SKILL.md +119 -0
  130. package/skills/egbe-os-meta-ads/SKILL.md +114 -0
  131. package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
  132. package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
  133. package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
  134. package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
  135. package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
  136. package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
  137. package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
  138. package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
  139. package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
  140. package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
  141. package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
  142. package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
  143. package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
  144. package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
  145. package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
  146. package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
  147. package/skills/egbe-os-notifications/SKILL.md +78 -0
  148. package/skills/egbe-os-openai-ads/SKILL.md +149 -0
  149. package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
  150. package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
  151. package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
  152. package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
  153. package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
  154. package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
  155. package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
  156. package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
  157. package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
  158. package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
  159. package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
  160. package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
  161. package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
  162. package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
  163. package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
  164. package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
  165. package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
  166. package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
  167. package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
  168. package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
  169. package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
  170. package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
  171. package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
  172. package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
  173. package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
  174. package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
  175. package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
  176. package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
  177. package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
  178. package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
  179. package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
  180. package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
  181. package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
  182. package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
  183. package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
  184. package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
  185. package/skills/egbe-os-payments/SKILL.md +215 -0
  186. package/skills/egbe-os-payments/agents/openai.yaml +4 -0
  187. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
  188. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
  189. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
  190. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
  191. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
  192. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
  193. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
  194. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
  195. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
  196. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
  197. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
  198. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
  199. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
  200. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
  201. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
  202. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
  203. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
  204. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
  205. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
  206. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
  207. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
  208. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
  209. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
  210. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
  211. package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
  212. package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
  213. package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
  214. package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
  215. package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
  216. package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
  217. package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
  218. package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
  219. package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
  220. package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
  221. package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
  222. package/skills/egbe-os-playbook/SKILL.md +79 -0
  223. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
  224. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
  225. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
  226. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
  227. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
  228. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
  229. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
  230. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
  231. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
  232. package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
  233. package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
  234. package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
  235. package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
  236. package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
  237. package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
  238. package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
  239. package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
  240. package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
  241. package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
  242. package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
  243. package/skills/egbe-os-playbook/playbooks/product.md +67 -0
  244. package/skills/egbe-os-playbook/references/catalog.md +127 -0
  245. package/skills/egbe-os-playbook/references/changes.md +167 -0
  246. package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
  247. package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
  248. package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
  249. package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
  250. package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
  251. package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
  252. package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
  253. package/skills/egbe-os-product-auth/SKILL.md +151 -0
  254. package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
  255. package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
  256. package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
  257. package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
  258. package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
  259. package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
  260. package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
  261. package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
  262. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
  263. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
  264. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
  265. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
  266. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
  267. package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
  268. package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
  269. package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
  270. package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
  271. package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
  272. package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
  273. package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
  274. package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
  275. package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
  276. package/skills/egbe-os-product-build/SKILL.md +111 -0
  277. package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
  278. package/skills/egbe-os-product-build/references/capabilities.md +25 -0
  279. package/skills/egbe-os-product-build/references/engineering.md +72 -0
  280. package/skills/egbe-os-product-build/references/execution.md +55 -0
  281. package/skills/egbe-os-product-build/references/foundations.md +93 -0
  282. package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
  283. package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
  284. package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
  285. package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
  286. package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
  287. package/skills/egbe-os-product-market-research/SKILL.md +159 -0
  288. package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
  289. package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
  290. package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
  291. package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
  292. package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
  293. package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
  294. package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
  295. package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
  296. package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
  297. package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
  298. package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
  299. package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
  300. package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
  301. package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
  302. package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
  303. package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
  304. package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
  305. package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
  306. package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
  307. package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
  308. package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
  309. package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
  310. package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
  311. package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
  312. package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
  313. package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
  314. package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
  315. package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
  316. package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
  317. package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
  318. package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
  319. package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
  320. package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
  321. package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
  322. package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
  323. package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
  324. package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
  325. package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
  326. package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
  327. package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
  328. package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
  329. package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
  330. package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
  331. package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
  332. package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
  333. package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
  334. package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
  335. package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
  336. package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
  337. package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
  338. package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
  339. package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
  340. package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
  341. package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
  342. package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
  343. package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
  344. package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
  345. package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
  346. package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
  347. package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
  348. package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
  349. package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
  350. package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
  351. package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
  352. package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
  353. package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
  354. package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
  355. package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
  356. package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
  357. package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
  358. package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
  359. package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
  360. package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
  361. package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
  362. package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
  363. package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
  364. package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
  365. package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
  366. package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
  367. package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
  368. package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
  369. package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
  370. package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
  371. package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
  372. package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
  373. package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
  374. package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
  375. package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
  376. package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
  377. package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
  378. package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
  379. package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
  380. package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
  381. package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
  382. package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
  383. package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
  384. package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
  385. package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
  386. package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
  387. package/skills/egbe-os-product-report/SKILL.md +150 -0
  388. package/skills/egbe-os-product-report/references/artifacts.md +84 -0
  389. package/skills/egbe-os-product-report/references/brief.md +34 -0
  390. package/skills/egbe-os-product-report/references/daily.md +76 -0
  391. package/skills/egbe-os-product-report/references/sources.md +68 -0
  392. package/skills/egbe-os-product-routines/SKILL.md +166 -0
  393. package/skills/egbe-os-product-routines/references/catalog.md +22 -0
  394. package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
  395. package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
  396. package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
  397. package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
  398. package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
  399. package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
  400. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
  401. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
  402. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
  403. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
  404. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
  405. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
  406. package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
  407. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
  408. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
  409. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
  410. package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
  411. package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
  412. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
  413. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
  414. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
  415. package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
  416. package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
  417. package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
  418. package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
  419. package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
  420. package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
  421. package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
  422. package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
  423. package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
  424. package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
  425. package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
  426. package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
  427. package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
  428. package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
  429. package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
  430. package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
  431. package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
  432. package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
  433. package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
  434. package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
  435. package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
  436. package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
  437. package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
  438. package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
  439. package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
  440. package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
  441. package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
  442. package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
  443. package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
  444. package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
  445. package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
  446. package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
  447. package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
  448. package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
  449. package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
  450. package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
  451. package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
  452. package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
  453. package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
  454. package/skills/egbe-os-report-ui/SKILL.md +133 -0
  455. package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
  456. package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
  457. package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
  458. package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
  459. package/skills/egbe-os-report-ui/references/components.md +209 -0
  460. package/skills/egbe-os-research/SKILL.md +125 -0
  461. package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
  462. package/skills/egbe-os-scrape/SKILL.md +160 -0
  463. package/skills/egbe-os-search/SKILL.md +182 -0
  464. package/skills/egbe-os-search/references/google-places.md +81 -0
  465. package/skills/egbe-os-support/SKILL.md +149 -0
  466. package/skills/egbe-os-telemetry/SKILL.md +344 -0
  467. package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
  468. package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
  469. package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
  470. package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
  471. package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
  472. package/skills/egbe-os-tools/SKILL.md +180 -0
  473. package/skills/egbe-os-tools/references/theona.md +26 -0
  474. package/skills/egbe-os-wallet/SKILL.md +181 -0
  475. package/skills/egbe-setup/EGBE.md +484 -0
  476. package/skills/egbe-setup/SKILL.md +116 -0
  477. package/skills/egbe-setup/references/project.md +80 -0
  478. package/state.js +37 -0
  479. package/update.js +361 -0
@@ -0,0 +1,31 @@
1
+ /** The part of `window.history` that the quiz uses. */
2
+ export interface QuizHistoryTarget {
3
+ readonly state: unknown;
4
+ pushState(data: unknown, unused: string, url?: string | URL | null): void;
5
+ replaceState(data: unknown, unused: string, url?: string | URL | null): void;
6
+ back(): void;
7
+ }
8
+
9
+ export interface QuizHistory {
10
+ /** Call once when the page shows the quiz, with the index the engine starts on. */
11
+ mount(index: number): void;
12
+ /** Call when the visitor has moved forward to the screen with this index. */
13
+ forward(index: number): void;
14
+ /**
15
+ * Call when the visitor presses the back control. True: the browser steps
16
+ * back and `follow` reports the screen. False: go back in the page, then
17
+ * call `replace`.
18
+ */
19
+ back(): boolean;
20
+ /** Call after the page went back by itself, with the index it shows now. */
21
+ replace(index: number): void;
22
+ /** The index of the screen of a history entry, or null when it is not of this quiz. */
23
+ follow(state: unknown): number | null;
24
+ /** How many entries of this quiz lie behind the current one. */
25
+ readonly depth: number;
26
+ }
27
+
28
+ export declare function createQuizHistory(
29
+ history: QuizHistoryTarget,
30
+ quizSlug: string,
31
+ ): QuizHistory;
@@ -0,0 +1,87 @@
1
+ /**
2
+ * History of a quiz in the browser.
3
+ *
4
+ * Every screen the visitor moves forward to gets its own history entry, so the
5
+ * browser's back returns to the previous screen instead of leaving the quiz.
6
+ * This module keeps the entries consistent. It never touches the DOM: the page
7
+ * passes `window.history` and reports what the visitor and the browser do.
8
+ *
9
+ * An entry records the quiz it belongs to, the index of its screen, and its
10
+ * depth: how many entries of this quiz lie behind it. The address never
11
+ * changes, so an analytics tracker counts no page view.
12
+ */
13
+
14
+ /**
15
+ * @param {{state: unknown, pushState: Function, replaceState: Function, back: Function}} history
16
+ * @param {string} quizSlug
17
+ */
18
+ export function createQuizHistory(history, quizSlug) {
19
+ let depth = 0;
20
+
21
+ function entry(index) {
22
+ // What the application's router keeps in the entry stays in it.
23
+ const kept = history.state && typeof history.state === "object" ? history.state : {};
24
+ return { ...kept, quizSlug, quizIndex: index, quizDepth: depth };
25
+ }
26
+
27
+ function read(state) {
28
+ if (!state || typeof state !== "object" || state.quizSlug !== quizSlug) return null;
29
+ const { quizIndex, quizDepth } = state;
30
+ if (!Number.isInteger(quizIndex) || quizIndex < 0) return null;
31
+ const recorded = Number.isInteger(quizDepth) && quizDepth >= 0 ? quizDepth : 0;
32
+ // One entry is added per step forward, so no entry lies deeper than its index.
33
+ return { index: quizIndex, depth: Math.min(recorded, quizIndex) };
34
+ }
35
+
36
+ return {
37
+ /**
38
+ * Call once when the page shows the quiz, with the index of the screen the
39
+ * engine starts on. After a reload the visitor is still on the entry they
40
+ * were on, and the entries behind it belong to the quiz as before.
41
+ */
42
+ mount(index) {
43
+ const current = read(history.state);
44
+ depth = current && current.index === index ? current.depth : 0;
45
+ history.replaceState(entry(index), "");
46
+ },
47
+
48
+ /** Call when the visitor has moved forward to the screen with this index. */
49
+ forward(index) {
50
+ depth += 1;
51
+ history.pushState(entry(index), "");
52
+ },
53
+
54
+ /**
55
+ * Call when the visitor presses the back control of the quiz. Returns true
56
+ * when the browser steps back and `follow` will report the screen. Returns
57
+ * false when no entry of the quiz lies behind this one: the page then goes
58
+ * back by itself and calls `replace`.
59
+ */
60
+ back() {
61
+ if (depth === 0) return false;
62
+ history.back();
63
+ return true;
64
+ },
65
+
66
+ /** Call after the page went back by itself, with the index it shows now. */
67
+ replace(index) {
68
+ history.replaceState(entry(index), "");
69
+ },
70
+
71
+ /**
72
+ * Call with the state of the entry the browser moved to. Returns the index
73
+ * of the screen to show, or null when the entry is not of this quiz.
74
+ */
75
+ follow(state) {
76
+ const target = read(state);
77
+ if (!target) return null;
78
+ depth = target.depth;
79
+ return target.index;
80
+ },
81
+
82
+ /** How many entries of this quiz lie behind the current one. */
83
+ get depth() {
84
+ return depth;
85
+ },
86
+ };
87
+ }
@@ -0,0 +1,265 @@
1
+ import assert from "node:assert/strict";
2
+ import { readFile } from "node:fs/promises";
3
+ import test from "node:test";
4
+
5
+ import { createQuiz } from "./quiz-engine.mjs";
6
+ import { createQuizHistory } from "./quiz-history.mjs";
7
+
8
+ const spec = JSON.parse(
9
+ await readFile(
10
+ new URL("../examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json", import.meta.url),
11
+ "utf8",
12
+ ),
13
+ );
14
+ const SLUG = spec.quiz_slug;
15
+
16
+ /** The history of one browser tab: entries, a position, and a listener for moves. */
17
+ function browserTab(entries = [{ page: "before the quiz", state: null }]) {
18
+ let position = entries.length - 1;
19
+ let listener = () => {};
20
+ return {
21
+ get state() {
22
+ return entries[position].state;
23
+ },
24
+ pushState(state) {
25
+ entries.splice(position + 1, entries.length, { page: entries[position].page, state });
26
+ position += 1;
27
+ },
28
+ replaceState(state) {
29
+ entries[position] = { ...entries[position], state };
30
+ },
31
+ back() {
32
+ if (position === 0) return;
33
+ position -= 1;
34
+ listener(entries[position].state);
35
+ },
36
+ forward() {
37
+ if (position === entries.length - 1) return;
38
+ position += 1;
39
+ listener(entries[position].state);
40
+ },
41
+ /** The visitor opens another document, such as the page of the quiz. */
42
+ open(page) {
43
+ entries.splice(position + 1, entries.length, { page, state: null });
44
+ position += 1;
45
+ },
46
+ onMove(callback) {
47
+ listener = callback;
48
+ },
49
+ get page() {
50
+ return entries[position].page;
51
+ },
52
+ get entries() {
53
+ return entries.map((entry) => entry.state);
54
+ },
55
+ };
56
+ }
57
+
58
+ function memoryStorage() {
59
+ const items = new Map();
60
+ return {
61
+ getItem: (key) => (items.has(key) ? items.get(key) : null),
62
+ setItem: (key, value) => items.set(key, String(value)),
63
+ removeItem: (key) => items.delete(key),
64
+ };
65
+ }
66
+
67
+ /**
68
+ * The page of the quiz as the reference binding wires it: the engine, the
69
+ * history of the quiz, and the listener for the browser's own moves.
70
+ */
71
+ function openQuiz(tab, storage, quizSpec = spec) {
72
+ const quiz = createQuiz(quizSpec, { storage });
73
+ const history = createQuizHistory(tab, quizSpec.quiz_slug);
74
+ tab.onMove((state) => {
75
+ const index = history.follow(state);
76
+ if (index !== null) quiz.goTo(index);
77
+ });
78
+ history.mount(quiz.snapshot().index);
79
+ return {
80
+ quiz,
81
+ history,
82
+ screen: () => quiz.snapshot().screen?.id ?? "result",
83
+ answer(optionId) {
84
+ history.forward(quiz.select(optionId).index);
85
+ },
86
+ pressBack() {
87
+ if (history.back()) return;
88
+ history.replace(quiz.back().index);
89
+ },
90
+ };
91
+ }
92
+
93
+ function quizPage() {
94
+ const tab = browserTab();
95
+ tab.open("quiz");
96
+ return tab;
97
+ }
98
+
99
+ test("intro-first history restores and returns to the introduction", () => {
100
+ const introduced = structuredClone(spec);
101
+ introduced.screens.unshift({ id: "intro", type: "interstitial", kind: "teach", headline: "Welcome", button: "Start" });
102
+ const tab = quizPage();
103
+ const storage = memoryStorage();
104
+ let page = openQuiz(tab, storage, introduced);
105
+ assert.equal(page.screen(), "intro");
106
+ page.history.forward(page.quiz.advance("intro").index);
107
+ page.answer("studio");
108
+ page = openQuiz(tab, storage, introduced);
109
+ assert.equal(page.screen(), "behind");
110
+ page.pressBack();
111
+ assert.equal(page.screen(), "role");
112
+ page.pressBack();
113
+ assert.equal(page.screen(), "intro");
114
+ tab.back();
115
+ assert.equal(tab.page, "before the quiz");
116
+ });
117
+
118
+ test("every step forward adds an entry and the browser's back follows them", () => {
119
+ const tab = quizPage();
120
+ const page = openQuiz(tab, memoryStorage());
121
+ page.answer("studio");
122
+ page.answer("year");
123
+
124
+ assert.deepEqual(tab.entries, [
125
+ null,
126
+ { quizSlug: SLUG, quizIndex: 0, quizDepth: 0 },
127
+ { quizSlug: SLUG, quizIndex: 1, quizDepth: 1 },
128
+ { quizSlug: SLUG, quizIndex: 2, quizDepth: 2 },
129
+ ]);
130
+
131
+ tab.back();
132
+ assert.equal(page.screen(), "behind");
133
+ assert.equal(page.history.depth, 1);
134
+ tab.forward();
135
+ assert.equal(page.screen(), "tracking");
136
+ assert.equal(page.history.depth, 2);
137
+ });
138
+
139
+ test("the back control of the quiz steps through the same entries", () => {
140
+ const tab = quizPage();
141
+ const page = openQuiz(tab, memoryStorage());
142
+ page.answer("studio");
143
+ page.answer("year");
144
+
145
+ page.pressBack();
146
+ assert.equal(page.screen(), "behind");
147
+ page.pressBack();
148
+ assert.equal(page.screen(), "role");
149
+ assert.equal(page.history.depth, 0);
150
+
151
+ tab.back();
152
+ assert.equal(tab.page, "before the quiz", "back from the first question leaves the quiz");
153
+ });
154
+
155
+ test("after a reload the back control still steps through the entries", () => {
156
+ const tab = quizPage();
157
+ const storage = memoryStorage();
158
+ const before = openQuiz(tab, storage);
159
+ before.answer("studio");
160
+ before.answer("year");
161
+
162
+ // The reload keeps the tab's history and the session storage, not the page.
163
+ const page = openQuiz(tab, storage);
164
+ assert.equal(page.screen(), "tracking");
165
+ assert.equal(page.history.depth, 2);
166
+ assert.deepEqual(tab.state, { quizSlug: SLUG, quizIndex: 2, quizDepth: 2 });
167
+
168
+ page.pressBack();
169
+ assert.equal(page.screen(), "behind");
170
+ page.pressBack();
171
+ assert.equal(page.screen(), "role");
172
+
173
+ tab.back();
174
+ assert.equal(tab.page, "before the quiz", "back from the first question leaves the quiz");
175
+ });
176
+
177
+ test("a reload in the middle of the entries keeps the ones ahead and behind", () => {
178
+ const tab = quizPage();
179
+ const storage = memoryStorage();
180
+ const before = openQuiz(tab, storage);
181
+ before.answer("studio");
182
+ before.answer("year");
183
+ tab.back();
184
+
185
+ const page = openQuiz(tab, storage);
186
+ assert.equal(page.screen(), "behind");
187
+ assert.equal(page.history.depth, 1);
188
+ tab.forward();
189
+ assert.equal(page.screen(), "tracking");
190
+ page.pressBack();
191
+ page.pressBack();
192
+ assert.equal(page.screen(), "role");
193
+ tab.back();
194
+ assert.equal(tab.page, "before the quiz");
195
+ });
196
+
197
+ test("progress restored without entries of the quiz goes back inside the page", () => {
198
+ const storage = memoryStorage();
199
+ const earlier = openQuiz(quizPage(), storage);
200
+ earlier.answer("studio");
201
+ earlier.answer("year");
202
+
203
+ // The visitor comes back to the quiz through a link: a new entry, the same tab.
204
+ const tab = quizPage();
205
+ const page = openQuiz(tab, storage);
206
+ assert.equal(page.screen(), "tracking");
207
+ assert.equal(page.history.depth, 0);
208
+
209
+ page.pressBack();
210
+ assert.equal(page.screen(), "behind");
211
+ assert.deepEqual(tab.state, { quizSlug: SLUG, quizIndex: 1, quizDepth: 0 });
212
+ page.pressBack();
213
+ assert.equal(page.screen(), "role");
214
+ assert.equal(tab.entries.length, 2, "going back inside the page adds no entry");
215
+
216
+ tab.back();
217
+ assert.equal(tab.page, "before the quiz");
218
+ });
219
+
220
+ test("an entry that does not match the screen of the engine is not trusted", () => {
221
+ const tab = quizPage();
222
+ const before = openQuiz(tab, memoryStorage());
223
+ before.answer("studio");
224
+ before.answer("year");
225
+
226
+ // The saved progress is gone, for example because the page changed.
227
+ const page = openQuiz(tab, memoryStorage());
228
+ assert.equal(page.screen(), "role");
229
+ assert.equal(page.history.depth, 0);
230
+ assert.deepEqual(tab.state, { quizSlug: SLUG, quizIndex: 0, quizDepth: 0 });
231
+
232
+ // Entries of the earlier progress name screens the visitor cannot reach now.
233
+ tab.back();
234
+ assert.equal(page.screen(), "role");
235
+ });
236
+
237
+ test("entries of another quiz and of the application are left alone", () => {
238
+ const tab = browserTab([{ page: "quiz", state: { router: "kept" } }]);
239
+ const history = createQuizHistory(tab, SLUG);
240
+ history.mount(0);
241
+ assert.deepEqual(tab.state, { router: "kept", quizSlug: SLUG, quizIndex: 0, quizDepth: 0 });
242
+ history.forward(1);
243
+ assert.deepEqual(tab.state, { router: "kept", quizSlug: SLUG, quizIndex: 1, quizDepth: 1 });
244
+
245
+ assert.equal(history.follow({ quizSlug: "another-quiz", quizIndex: 3, quizDepth: 3 }), null);
246
+ assert.equal(history.follow({ router: "only" }), null);
247
+ assert.equal(history.follow(null), null);
248
+ assert.equal(history.follow("text"), null);
249
+ assert.equal(history.follow({ quizSlug: SLUG, quizIndex: "2", quizDepth: 2 }), null);
250
+ assert.equal(history.follow({ quizSlug: SLUG, quizIndex: -1, quizDepth: 0 }), null);
251
+ assert.equal(history.depth, 1, "an entry that is not followed changes nothing");
252
+ });
253
+
254
+ test("a damaged depth never exceeds what the screen allows", () => {
255
+ const tab = browserTab([
256
+ { page: "quiz", state: { quizSlug: SLUG, quizIndex: 2, quizDepth: 40 } },
257
+ ]);
258
+ const history = createQuizHistory(tab, SLUG);
259
+ history.mount(2);
260
+ assert.equal(history.depth, 2);
261
+
262
+ assert.equal(history.follow({ quizSlug: SLUG, quizIndex: 1, quizDepth: "deep" }), 1);
263
+ assert.equal(history.depth, 0);
264
+ assert.equal(history.back(), false);
265
+ });
@@ -0,0 +1,254 @@
1
+ import assert from "node:assert/strict";
2
+ import { readFile } from "node:fs/promises";
3
+ import test from "node:test";
4
+ import vm from "node:vm";
5
+ import { createQuiz } from "./quiz-engine.mjs";
6
+ import { renderFirstScreen } from "../reference/quiz-first-screen.mjs";
7
+ import { replayEarlyActions } from "../reference/quiz-early-actions.mjs";
8
+ import { mountQuiz } from "../reference/quiz-page.mjs";
9
+
10
+ const example = JSON.parse(await readFile(new URL("../examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json", import.meta.url), "utf8"));
11
+ const intro = { id: "intro", type: "interstitial", kind: "teach", headline: '<Welcome & "hello">', body: "Here is the process.", button: "Begin" };
12
+ const withIntro = () => ({ ...structuredClone(example), screens: [intro, ...structuredClone(example.screens)] });
13
+
14
+ // Exercise the actual binding, including event handlers, focus and its clock.
15
+ // No browser dependency is needed for these DOM operations.
16
+ function mountedQuiz(t, spec, actions = [], { storage, reducedMotion = false, focusedOptionId } = {}) {
17
+ let now = 100;
18
+ let activeElement = null;
19
+ const timers = [];
20
+ class Element {
21
+ constructor() { this.attributes = {}; this.children = []; this.handlers = {}; }
22
+ setAttribute(name, value) { this.attributes[name] = value; }
23
+ get dataset() {
24
+ return Object.fromEntries(Object.entries(this.attributes).filter(([name]) => name.startsWith("data-"))
25
+ .map(([name, value]) => [name.slice(5).replace(/-([a-z])/g, (_, letter) => letter.toUpperCase()), value]));
26
+ }
27
+ append(...children) {
28
+ for (const child of children) { child.parentNode = this; this.children.push(child); }
29
+ }
30
+ replaceChildren(...children) {
31
+ if (this.contains(activeElement)) activeElement = null;
32
+ for (const child of this.children) child.parentNode = null;
33
+ this.children = []; this.append(...children);
34
+ }
35
+ contains(node) { return this === node || this.children.some((child) => child.contains(node)); }
36
+ closest(selector) {
37
+ return Object.hasOwn(this.attributes, selector.slice(1, -1)) ? this : this.parentNode?.closest(selector);
38
+ }
39
+ addEventListener(name, handler) { this.handlers[name] = handler; }
40
+ querySelectorAll(selector) {
41
+ const matches = (node) => selector.startsWith("#")
42
+ ? node.attributes.id === selector.slice(1)
43
+ : Object.hasOwn(node.attributes, selector.slice(1, -1));
44
+ return this.children.flatMap((child) => [
45
+ ...(matches(child) ? [child] : []), ...child.querySelectorAll(selector),
46
+ ]);
47
+ }
48
+ querySelector(selector) { return this.querySelectorAll(selector)[0] ?? null; }
49
+ focus() { activeElement = this; }
50
+ }
51
+ const globals = {
52
+ document: { createElement: () => new Element(), title: "", get activeElement() { return activeElement; } },
53
+ window: {
54
+ history: {
55
+ state: null,
56
+ replaceState(state) { this.state = state; },
57
+ pushState(state) { this.state = state; },
58
+ },
59
+ sessionStorage: storage,
60
+ matchMedia: () => ({ matches: reducedMotion }),
61
+ addEventListener() {}, removeEventListener() {},
62
+ setTimeout(callback, delay) { timers.push({ callback, at: now + delay }); },
63
+ umami: { track() {} },
64
+ },
65
+ performance: { now: () => now },
66
+ };
67
+ for (const [name, value] of Object.entries(globals)) {
68
+ const previous = Object.getOwnPropertyDescriptor(globalThis, name);
69
+ Object.defineProperty(globalThis, name, { value, configurable: true });
70
+ t.after(() => {
71
+ if (previous) Object.defineProperty(globalThis, name, previous);
72
+ else delete globalThis[name];
73
+ });
74
+ }
75
+ const root = new Element();
76
+ root.__quizEarlyActions = actions;
77
+ if (focusedOptionId) {
78
+ const screen = new Element();
79
+ screen.setAttribute("data-quiz-screen", spec.screens[0].id);
80
+ const option = new Element();
81
+ option.setAttribute("data-option-id", focusedOptionId);
82
+ screen.append(option);
83
+ root.append(screen);
84
+ option.focus();
85
+ }
86
+ const { quiz } = mountQuiz(root, spec);
87
+ return {
88
+ root, quiz,
89
+ get focused() { return activeElement; },
90
+ clickOption(optionId) {
91
+ const button = optionId
92
+ ? root.querySelectorAll("[data-option-id]").find((item) => item.dataset.optionId === optionId)
93
+ : root.querySelector("[data-option-id]");
94
+ button.handlers.click({ currentTarget: button });
95
+ },
96
+ tick(milliseconds) {
97
+ const until = now + milliseconds;
98
+ timers.sort((a, b) => a.at - b.at);
99
+ while (timers.length && timers[0].at <= until) {
100
+ const timer = timers.shift();
101
+ now = timer.at;
102
+ timer.callback();
103
+ timers.sort((a, b) => a.at - b.at);
104
+ }
105
+ now = until;
106
+ },
107
+ };
108
+ }
109
+
110
+ for (const toggled of [false, true]) {
111
+ test(`multi-select mount preserves the SSR-focused option (early toggle: ${toggled})`, (t) => {
112
+ const spec = structuredClone(example);
113
+ const question = spec.screens.find((screen) => screen.id === "worries");
114
+ spec.screens = [question, ...spec.screens.filter((screen) => screen !== question)];
115
+ const actions = toggled ? [{ kind: "toggle", screenId: "worries", optionId: "deadline" }] : [];
116
+ const page = mountedQuiz(t, spec, actions, { focusedOptionId: "deadline" });
117
+ const option = page.root.querySelectorAll("[data-option-id]").find((item) => item.dataset.optionId === "deadline");
118
+ assert.equal(page.focused, option);
119
+ assert.deepEqual(page.quiz.snapshot().selected, toggled ? ["deadline"] : []);
120
+ page.clickOption("deadline");
121
+ assert.deepEqual(page.quiz.snapshot().selected, toggled ? [] : ["deadline"]);
122
+ assert.equal(page.focused, option, "subsequent keyboard toggles keep focus in place");
123
+ });
124
+ }
125
+
126
+ for (const reducedMotion of [false, true]) {
127
+ for (const firstScreen of ["question", "intro"]) {
128
+ test(`early ${firstScreen} transition guards the next tap and moves focus (reduced motion: ${reducedMotion})`, (t) => {
129
+ const spec = firstScreen === "intro" ? withIntro() : example;
130
+ const action = firstScreen === "intro"
131
+ ? { kind: "advance", screenId: "intro" }
132
+ : { kind: "select", screenId: "role", optionId: "studio" };
133
+ const page = mountedQuiz(t, spec, [action], { reducedMotion });
134
+ assert.equal(page.quiz.snapshot().index, 1);
135
+ assert.equal(page.focused, page.root.querySelector("#quiz-headline"));
136
+ page.clickOption();
137
+ page.tick(180);
138
+ assert.equal(page.quiz.snapshot().index, 1, "the tail of the early tap must not answer another question");
139
+ page.tick(171);
140
+ page.clickOption();
141
+ page.tick(180);
142
+ assert.equal(page.quiz.snapshot().index, 2, "a deliberate later tap must still work");
143
+ });
144
+ }
145
+ }
146
+
147
+ test("plain mount neither steals focus nor delays the first choice", (t) => {
148
+ const page = mountedQuiz(t, example);
149
+ assert.equal(page.focused, null);
150
+ page.clickOption();
151
+ page.tick(180);
152
+ assert.equal(page.quiz.snapshot().screen.id, "behind");
153
+ assert.equal(page.focused, page.root.querySelector("#quiz-headline"));
154
+ page.clickOption();
155
+ page.tick(180);
156
+ assert.equal(page.quiz.snapshot().screen.id, "behind", "ordinary transitions remain guarded");
157
+ });
158
+
159
+ test("an ignored early action does not guard or refocus a restored screen", (t) => {
160
+ const values = new Map();
161
+ const storage = { getItem: (key) => values.get(key) ?? null, setItem: (key, value) => values.set(key, value), removeItem: (key) => values.delete(key) };
162
+ createQuiz(example, { storage }).select("studio", "role");
163
+ const page = mountedQuiz(t, example, [{ kind: "select", screenId: "role", optionId: "studio" }], { storage });
164
+ assert.equal(page.quiz.snapshot().screen.id, "behind");
165
+ assert.equal(page.focused, null);
166
+ page.clickOption();
167
+ page.tick(180);
168
+ assert.equal(page.quiz.snapshot().screen.id, "tracking");
169
+ });
170
+
171
+ test("SSR renders an accepted intro safely without browser globals", async () => {
172
+ const html = renderFirstScreen(withIntro());
173
+ assert.ok(html.includes('&lt;Welcome &amp; &quot;hello&quot;&gt;'));
174
+ assert.ok(html.includes('data-quiz-screen="intro"'));
175
+ assert.ok(html.includes('data-quiz-advance>Begin</button>'));
176
+ assert.ok(!html.includes("data-option-id"));
177
+ // Importing the binding on the server does not mount or need document/window.
178
+ const { mountQuiz } = await import("../reference/quiz-page.mjs");
179
+ assert.equal(typeof mountQuiz, "function");
180
+ });
181
+
182
+ test("an early intro continue advances once and reports its event once", () => {
183
+ const events = [];
184
+ const quiz = createQuiz(withIntro(), { onEvent: (event) => events.push(event) });
185
+ const action = { kind: "advance", screenId: "intro" };
186
+ const view = replayEarlyActions(quiz, [action, action]);
187
+ assert.equal(view.screen.id, "role");
188
+ assert.equal(events.length, 1);
189
+ assert.equal(events[0].data.button_role, "quiz_continue");
190
+ assert.equal(quiz.back().screen.id, "intro");
191
+ });
192
+
193
+ test("early actions never apply to a restored later screen", () => {
194
+ const values = new Map();
195
+ const storage = { getItem: (key) => values.get(key) ?? null, setItem: (key, value) => values.set(key, value), removeItem: (key) => values.delete(key) };
196
+ const spec = withIntro();
197
+ const first = createQuiz(spec, { storage });
198
+ first.advance("intro");
199
+ first.select("studio", "role");
200
+ const events = [];
201
+ const restored = createQuiz(spec, { storage, onEvent: (event) => events.push(event) });
202
+ assert.equal(replayEarlyActions(restored, [{ kind: "advance", screenId: "intro" }]).screen.id, "behind");
203
+ assert.equal(events.length, 0);
204
+ });
205
+
206
+ test("early single and multi selections preserve accepted answers and privacy", () => {
207
+ const quiz = createQuiz(example);
208
+ assert.equal(replayEarlyActions(quiz, [{ kind: "select", screenId: "role", optionId: "studio" }]).screen.id, "behind");
209
+ const spec = structuredClone(example);
210
+ const question = spec.screens.find((screen) => screen.id === "worries");
211
+ spec.screens = [question, ...spec.screens.filter((screen) => screen !== question)];
212
+ const multi = createQuiz(spec);
213
+ const view = replayEarlyActions(multi, [
214
+ { kind: "toggle", screenId: "worries", optionId: "deadline" },
215
+ { kind: "toggle", screenId: "worries", optionId: "audit" },
216
+ ]);
217
+ assert.deepEqual(view.selected, ["deadline", "audit"]);
218
+ assert.equal(view.screen.id, "worries");
219
+ const sensitive = structuredClone(example);
220
+ sensitive.screens = [sensitive.screens.find((screen) => screen.id === "penalty")];
221
+ assert.ok(renderFirstScreen(sensitive).includes("data-quiz-private"));
222
+ });
223
+
224
+ test("bootstrap captures an intro tap before module loading and stops after mount", async () => {
225
+ let handler;
226
+ const screen = { dataset: { quizScreen: "intro", quizSelect: "interstitial" } };
227
+ const button = { disabled: false, dataset: {}, closest: () => screen };
228
+ const root = {
229
+ addEventListener: (_, callback) => { handler = callback; },
230
+ removeEventListener: (_, callback) => { assert.equal(callback, handler); handler = null; },
231
+ contains: (node) => node === button,
232
+ };
233
+ vm.runInNewContext(await readFile(new URL("../reference/quiz-bootstrap.js", import.meta.url), "utf8"), { document: { querySelectorAll: () => [root] } });
234
+ const event = { target: { closest: () => button }, preventDefault() {} };
235
+ handler(event);
236
+ handler(event);
237
+ assert.equal(root.__quizEarlyActions.length, 1);
238
+ assert.equal(root.__quizEarlyActions[0].kind, "advance");
239
+ root.__quizStopCapture();
240
+ assert.equal(handler, null);
241
+ });
242
+
243
+ test("large multi-select does not enumerate a powerset to prove an early result", () => {
244
+ const spec = structuredClone(example);
245
+ const worries = spec.screens.find((screen) => screen.id === "worries");
246
+ worries.options = Array.from({ length: 60 }, (_, index) => ({ id: `choice-${index}`, label: `Choice ${index}` }));
247
+ spec.results[0].when = { any: [{ screen: "worries", any_of: ["choice-0"] }] };
248
+ const quiz = createQuiz(spec);
249
+ assert.equal(quiz.select("studio", "role").screen.id, "behind");
250
+ quiz.select("few", "behind"); quiz.select("app", "tracking"); quiz.advance("halfway");
251
+ quiz.toggle("choice-0", "worries");
252
+ assert.equal(quiz.advance("worries").atResult, true);
253
+ assert.equal(quiz.result().id, "in-shape");
254
+ });