@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,335 @@
1
+ # Specification Contract
2
+
3
+ One folder holds everything about one quiz:
4
+
5
+ | Path | Author | Meaning |
6
+ |---|---|---|
7
+ | `egbe-docs/product/quizzes/<quiz-slug>/quiz.json` | Agent | The executable specification of the accepted experience. |
8
+ | `egbe-docs/product/quizzes/<quiz-slug>/QUIZ.md` | Compiler | The readable specification for review. |
9
+ | `egbe-docs/product/quizzes/<quiz-slug>/quiz.public.json` | Compiler | The part of the specification the page renders. |
10
+ | `egbe-docs/product/quizzes/<quiz-slug>/validation.json` | Compiler | The receipt of the last compile: status, date, hashes, counts, consent and reachability diagnostics. |
11
+
12
+ Resolve `egbe-docs/` from the product repository root. Keep it with the product source and use the repository's versioning workflow
13
+ when a commit is in scope. Optional research can live beside it; no report is
14
+ required to compile.
15
+
16
+ ## Compile
17
+
18
+ ```bash
19
+ python3 <skill-root>/scripts/compile-quiz-spec.py \
20
+ --workspace <workspace-root> --quiz-slug <quiz-slug>
21
+ ```
22
+
23
+ The compiler reads `quiz.json`. Contract errors block compilation; nonblocking
24
+ diagnostics remain in `validation.json.warnings`. No research age, prescribed
25
+ length, wording limit or deviation justification is required.
26
+
27
+ - When the specification is ready, it writes the three compiled files, with
28
+ `"status": "ready"` in the receipt.
29
+ - When it is not, it removes `QUIZ.md` and `quiz.public.json` of an earlier
30
+ version and writes the receipt with `"status": "not_ready"` and the
31
+ problems, so that nothing stale can be mistaken for current.
32
+ - `--check` validates without writing or removing anything.
33
+ - `--today` fixes the date for reproducible tests. Do not use it to compile a
34
+ quiz.
35
+
36
+ The compiler checks structure and consistency. It does not know whether a
37
+ statement is true.
38
+
39
+ ## General rules
40
+
41
+ - Unknown fields are errors.
42
+ - An id starts with a lowercase letter and contains lowercase letters, digits,
43
+ `-`, and `_`, 40 characters at most. The
44
+ ids of screens and results are unique among both; option ids are unique on
45
+ their screen.
46
+ - The name of a query parameter starts with a lowercase letter and contains
47
+ lowercase letters, digits, and `_`. It cannot be `email`, `mail`, `name`,
48
+ `phone`, or `tel`.
49
+ - A text the visitor reads is one line of plain text without line breaks. It
50
+ contains no claim to avoid.
51
+ - A same-origin path starts with `/` and has no fragment. An address is an
52
+ absolute `https` address without credentials or a fragment. Neither carries
53
+ personal data in its query.
54
+
55
+ ## Specification
56
+
57
+ A complete example is in
58
+ `assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json`. It was compiled with
59
+ `--today 2026-09-28`.
60
+
61
+ ```json
62
+ {
63
+ "contract": "quiz-funnel-spec-v1",
64
+ "quiz_slug": "books-checkup",
65
+ "product_slug": "example-books",
66
+ "route": "/quiz/books-checkup",
67
+ "language": "en",
68
+ "title": "Books checkup",
69
+ "ui": {"back": "Back", "progress": "Step {current} of {total}"},
70
+ "inputs": {},
71
+ "goal": {},
72
+ "proof": [],
73
+ "screens": [],
74
+ "results": []
75
+ }
76
+ ```
77
+
78
+ - `quiz_slug` and `product_slug`: lowercase letters, digits, and `-`.
79
+ `quiz_slug` equals the name of the folder.
80
+ - `route`: a lowercase path without a query or a trailing slash. Its first
81
+ segment cannot be `account`, `admin`, `api`, `auth`, `checkout`,
82
+ `dashboard`, `login`, `logout`, `pricing`, `privacy`, `register`, `signup`,
83
+ or `terms`, and it cannot be the homepage.
84
+ - `language`: a language tag such as `en`, `es`, or `pt-BR`. Add the region
85
+ only when the copy is written for that region.
86
+ - `title`: the title of the page in the browser, in the language of the quiz.
87
+ - `ui.back`: the label of the back control. `ui.progress`: the label of the
88
+ progress indicator with the placeholders `{current}` and `{total}`. `{total}`
89
+ counts every screen before the result, questions and interstitial screens
90
+ alike, so word the label as steps, not as questions.
91
+
92
+ ### `inputs`
93
+
94
+ ```json
95
+ {
96
+ "product": "What the product is and does.",
97
+ "application": {"repository": "example-books", "url": "https://example-books.egbe.app"},
98
+ "segment": {"name": "", "situation": "", "problem": ""},
99
+ "offer": {
100
+ "promise": "",
101
+ "mechanism": "",
102
+ "terms": "",
103
+ "claims_to_avoid": [],
104
+ "not_for": []
105
+ },
106
+ "traffic": {"channels": ["meta_ads"], "geographies": ["US"], "promise": ""},
107
+ "sources": [{"label": "Caller request", "ref": "request"}]
108
+ }
109
+ ```
110
+
111
+ - `offer.claims_to_avoid` and `offer.not_for` may be empty lists.
112
+ - `traffic.channels` names the channels, for example `meta_ads`, `google_ads`,
113
+ `reddit_ads`, `linkedin_ads`, `openai_ads`, `outreach_email`.
114
+ - `traffic.geographies` holds two-letter country codes. The compiler lists
115
+ those that need consent in the receipt.
116
+ - `traffic.promise` is the text of the ad or message. Leave the field out when
117
+ no ad exists yet.
118
+ - `sources[].ref` is `request`, `answer`, or the path or address of a
119
+ document.
120
+ - Proof that exists is recorded under `proof`, not here. A product without
121
+ proof has an empty `proof` list.
122
+
123
+ ### `goal`
124
+
125
+ ```json
126
+ {
127
+ "type": "call",
128
+ "statement": "The quiz should get visitors to book the free books review call.",
129
+ "destination": {"kind": "booking_url", "url": "https://cal.example.com/books-review"}
130
+ }
131
+ ```
132
+
133
+ `statement` is optional context from the accepted project decisions. The
134
+ destination depends on the goal:
135
+
136
+ | Goal | `kind` | Fields |
137
+ |---|---|---|
138
+ | `call` | `booking_url` | `url`; optional `result_param`, `fallback_params` |
139
+ | `call` | `lead_form` | `action` (same-origin path), `fields`, `field_labels`, `submit_label`, `error`, `success` (`headline`, `body`); optional `consent_note` |
140
+ | `signup` | `signup` | `path` (same-origin) |
141
+ | `payment` | `checkout` | `path` (same-origin), `plan_key`, `price`; optional `plan_param` (default `plan`) |
142
+
143
+ - `fields` may contain `name`, `email`, `phone`, and `company`, each once, and
144
+ must contain `email` or `phone`. `field_labels` has one label per field.
145
+ - `result_param` must not already be in the query of `url`.
146
+ - The checkout `path` must not already carry the plan parameter.
147
+ - `price` is the price with its period, exactly as the product's plan catalog
148
+ states it, for example `$95 per month`. Every result that leads to the
149
+ checkout must contain it, character for character, in a text that every
150
+ visitor of that result reads: its headline, its body, the label or the note
151
+ of its call to action, or a point that is never left out. A point that
152
+ quotes a question with an escape option is left out for visitors who chose
153
+ that option, so the price in such a point does not count.
154
+ - See [conversion-handoff.md](conversion-handoff.md) for what each field does.
155
+ - A request form that continues to a scheduling page keeps the kind
156
+ `lead_form`. The scheduling address is not a field of the specification;
157
+ [conversion-handoff.md](conversion-handoff.md) says where it is kept and
158
+ recorded.
159
+
160
+ ### `proof`
161
+
162
+ ```json
163
+ {"id": "review-summary", "kind": "fact", "text": "Shown text.", "source": "Where it can be checked"}
164
+ ```
165
+
166
+ `kind` is `count`, `fact`, `logo`, `statistic`, or `testimonial`. A
167
+ `testimonial` needs `author`; a `statistic` needs `citation`. Every entry must
168
+ be shown on a screen or a result; remove what is not shown.
169
+
170
+ ### `screens`
171
+
172
+ The visitor passes the screens in order, then sees a result. The first screen
173
+ may be a question or an interstitial, including an introduction.
174
+
175
+ ```json
176
+ {
177
+ "id": "worries",
178
+ "type": "question",
179
+ "select": "multi",
180
+ "headline": "What worries you most?",
181
+ "hint": "Choose all that apply.",
182
+ "purpose": "build_case",
183
+ "button": "Continue",
184
+ "options": [
185
+ {"id": "deadline", "label": "Tax deadline", "phrase": "the tax deadline"},
186
+ {"id": "nothing", "label": "None of these", "escape": true}
187
+ ]
188
+ }
189
+ ```
190
+
191
+ - `select` is `single` or `multi`. A `multi` question needs `button` and
192
+ cannot be passed with nothing chosen. A `single` question must not have a
193
+ button. `hint` is optional for either kind.
194
+ - Optional private `purpose` is `personalize`, `qualify`, or `build_case`; it
195
+ explains an answer's use and does not reach the browser. An unused answer is
196
+ a diagnostic, not a compilation failure.
197
+ - `lead` is optional introductory text on a question.
198
+ - `options`: a non-empty list. `label` is the text of the button. `phrase` is the same
199
+ answer worded for the middle of a sentence; tokens use it when it exists.
200
+ - `"escape": true` marks the option for visitors to whom no other option
201
+ applies or who prefer not to answer. A question has at most one and at least
202
+ one option besides it. On a multi-select question it excludes the others.
203
+ - `"sensitive": true` requires an escape option and keeps the chosen option in
204
+ the visitor's browser.
205
+
206
+ ```json
207
+ {
208
+ "id": "halfway",
209
+ "type": "interstitial",
210
+ "kind": "encouragement",
211
+ "headline": "You are halfway there",
212
+ "body": "Three more answers and you will see what your books need first.",
213
+ "button": "Continue",
214
+ "variants": [
215
+ {
216
+ "when": {"all": [{"screen": "behind", "any_of": ["many", "year"]}]},
217
+ "headline": "This is what a catch-up is for",
218
+ "body": "Books that are {{answer:behind}} can be reconciled month by month."
219
+ }
220
+ ]
221
+ }
222
+ ```
223
+
224
+ - `kind` is `encouragement`, `proof`, or `teach`. A `proof` screen needs
225
+ `proof_ids`.
226
+ - `body`, `points`, `media`, and `proof_ids` are optional.
227
+ - `variants` is optional. The first variant whose `when` matches replaces the
228
+ fields it contains; the screen's own fields apply to everyone else. A
229
+ variant changes `headline`, `body`, `points`, `media`, or `proof_ids`, never
230
+ the button. Its conditions may name only questions that come before the
231
+ screen. A variant that no answer can reach, or variants that leave the
232
+ screen's own texts unreachable, are errors.
233
+
234
+ ### `results`
235
+
236
+ Results are tested in order and the first match is shown. The last result has
237
+ no `when` and is the default. A `not_fit` result is shown as soon as the
238
+ answers given decide it, that is, when every answer the remaining questions
239
+ could receive leads to it; the remaining screens are skipped. A `not_fit`
240
+ result whose headline or body quotes a question that is not answered yet
241
+ waits for that question.
242
+
243
+ ```json
244
+ {
245
+ "id": "catch-up",
246
+ "fit": "fit",
247
+ "when": {"all": [{"screen": "behind", "any_of": ["many", "year"]}]},
248
+ "headline": "Your books need a catch-up first",
249
+ "body": "On the free 20-minute review we list the missing months.",
250
+ "points": ["Your books: {{answer:behind}}", "On your mind: {{answer:worries}}"],
251
+ "cta": {"label": "Book the free review", "note": "The call takes 20 minutes."}
252
+ }
253
+ ```
254
+
255
+ - `fit` is `fit`, `partial`, or `not_fit`. A `not_fit` result requires an
256
+ entry in `inputs.offer.not_for`.
257
+ - `cta` has a `label` and an optional `note`. Without a `destination` it leads
258
+ to the destination of the goal. At least one `fit` or `partial` result must
259
+ do so.
260
+ - A `cta` may carry its own `destination`: `{"kind": "link", "path": "/..."}`
261
+ or `{"kind": "link", "url": "https://..."}`. It must not lead to the
262
+ destination of the goal. A `not_fit` result needs its own destination or
263
+ `"cta": null`; only a `not_fit` result may have `"cta": null`.
264
+ - `points`, `media`, and `proof_ids` are optional.
265
+ - A result that no answer can reach is an error: its conditions cannot be met,
266
+ or earlier results catch every answer that meets them.
267
+ - A shared result is supported when the accepted experience records answers
268
+ for a later use rather than personalizing the result in this runtime.
269
+
270
+ ### `media`
271
+
272
+ ```json
273
+ {"src": "/quiz/books-checkup/summary.png", "alt": "A written summary of a review", "source": "Summary sent to a client on 2026-08-12, names removed"}
274
+ ```
275
+
276
+ `src` is a same-origin path or an address. `alt` describes the image to a
277
+ visitor who cannot see it. `source` is for the founder and does not reach the
278
+ page.
279
+
280
+ ### Conditions
281
+
282
+ `when` holds exactly one of `all` or `any`, each a list of conditions. A
283
+ condition names a question `screen` and exactly one of `any_of` or `none_of`,
284
+ each a list of option ids of that question. For a multi-select question,
285
+ `any_of` matches when at least one listed option was chosen and `none_of` when
286
+ none was.
287
+
288
+ The condition of a result must not name a sensitive question.
289
+
290
+ ### Tokens
291
+
292
+ `{{answer:<question id>}}` is replaced by what the visitor chose.
293
+
294
+ Sensitive answers cannot be used in tokens: interstitial and result copy is
295
+ not masked by the question's recording selector. Keep those answers private;
296
+ this runtime has no private result-text rendering mode.
297
+
298
+ | Where | Which questions | What appears |
299
+ |---|---|---|
300
+ | `headline` and `body` of an interstitial screen, a variant, or a result | Single-choice questions without an escape option | The `phrase` of the chosen option, or its `label` |
301
+ | `points` of an interstitial screen, a variant, or a result | Any question | The chosen options separated by commas. The whole point is left out when the visitor chose the escape option, so a point that quotes such a question must not carry what every visitor has to read. |
302
+ | Anywhere else | — | An error |
303
+
304
+ An interstitial screen may quote only questions that come before it. Write
305
+ every sentence so that each possible answer reads well in it, and give options
306
+ a `phrase` when their label does not.
307
+
308
+ ### Diagnostics and bounds
309
+
310
+ `multi_select_escape` flags a multi-select with no declining option;
311
+ `unused_answer` flags a declared personalization/qualification answer with no
312
+ local rule or token. Both are nonblocking: exhaustive choices or an external
313
+ follow-up can make them intentional. A sensitive question still needs a refusal
314
+ option and cannot choose a public result.
315
+
316
+ Exhaustive reachability is bounded to 200,000 combinations, including the work
317
+ needed to construct multi-select answer classes. If skipped, the receipt says
318
+ `reachability: "not_checked"` and identifies affected rules in `warnings`; this
319
+ is not a passing check. Verify relevant paths separately before release. The
320
+ last default result remains required. Runtime early-result inference is separately
321
+ bounded; when it cannot prove an early result it continues the accepted screens
322
+ and resolves the result from the completed answers.
323
+
324
+ The compiler checks configured `claims_to_avoid` (case/accent insensitive) and
325
+ exact configured checkout prices. It does not use matching digits as proof of
326
+ truth. Check claims and source attribution against real evidence separately.
327
+
328
+ ## Hashes
329
+
330
+ The receipt and `quiz.public.json` carry hashes:
331
+
332
+ - `spec_sha256` names the specification and changes with any edit of
333
+ `quiz.json`.
334
+ - `public_sha256` changes only when the page itself changes; a visitor's saved
335
+ progress starts over when it does.
@@ -0,0 +1,101 @@
1
+ # Verification
2
+
3
+ Verify the changed behavior locally. When a release is in scope, repeat the
4
+ relevant checks on the deployed route; do not claim live verification from a build. Create no real booking,
5
+ account, request, or payment, and write no synthetic events into production
6
+ statistics.
7
+
8
+ ## Before deploy
9
+
10
+ - `compile-quiz-spec.py --check` reports the specification as ready and prints
11
+ its hash.
12
+ - The `spec_sha256` of the `quiz.public.json` inside the application equals
13
+ that hash.
14
+ - The application's lint and build pass.
15
+ - Review `validation.json.warnings`. `reachability: "not_checked"` needs
16
+ separate path verification; it is not a passing exhaustive check.
17
+
18
+ ## On the live route
19
+
20
+ Before the first page load of the verification session, set up the browser you
21
+ use so that nothing reaches production statistics: let the analytics tracker
22
+ load but block the requests it sends, and block the session recorder and every
23
+ advertising pixel. Keep this until the session ends. The blocked requests of
24
+ the tracker are the evidence for step 7.
25
+
26
+ Check on a phone-sized viewport of 375 by 667 and on a desktop viewport.
27
+
28
+ 1. **Route.** Opening the address directly shows the accepted first screen, not the
29
+ homepage, a sign-in page, or an empty page. The page title, the language of
30
+ the quiz, and `noindex` are set.
31
+ 2. **First screen.** The accepted first screen and its controls remain usable on
32
+ the target mobile viewport, including when long content needs scrolling. Nothing scrolls sideways on any screen.
33
+ 3. **Movement.** A single-choice option advances without a button. A second
34
+ tap right after the first does not answer the next question. A multi-select
35
+ question does not advance without a choice, and switching an option keeps
36
+ focus and scroll position. An interstitial screen has one button. Refusal and navigation follow the accepted experience. The back control and the browser's own back return to the
37
+ previous screen and keep the answers. Reloading keeps the progress. After a
38
+ reload on the third screen, the back control pressed twice leads to the
39
+ first screen, and the browser's back from there leaves the quiz.
40
+ 4. **Screens.** Every variant of an interstitial screen appears for the
41
+ answers that select it, and the screen's own texts appear for the others.
42
+ 5. **Results.** Walk one path to every result. Each shows its own headline,
43
+ body, points, and image; every token is replaced by the chosen answer; a
44
+ point whose question was declined is absent; the default result appears
45
+ when no rule matches. Every image loads and shows what its `source` says.
46
+ A `not_fit` result appears right after the answer that decides it, without
47
+ the remaining questions; the back control and the browser's back return to
48
+ that question, and another answer to it continues with the next screen.
49
+ 6. **Call to action and destination.** For each result the label, the note
50
+ under the button, and the destination match the specification, and a
51
+ `not_fit` result does not lead to the goal.
52
+ - `booking_url`: the link opens the scheduling page. For a visit that
53
+ arrived with campaign parameters the link carries them; for a visit
54
+ without them it carries the fallback values. Stop there.
55
+ - `lead_form`: labels, consent note, and the failure state appear as
56
+ specified. The endpoint rejects an invalid request and stores nothing.
57
+ Submit a valid request only when the product can mark and remove a test
58
+ record.
59
+ - `lead_form` that continues to a scheduling page: mock malformed contact,
60
+ other rejection, server error, no response and confirmed save. Each follows
61
+ the accepted recovery behavior; navigation alone never reports a saved
62
+ request. The calendar URL carries campaign/result identifiers, never
63
+ contact details. Returning with Back does not resubmit the form.
64
+ - `signup`: the link reaches the signup route. With the private validation
65
+ identity prepared by the product's authentication work, confirm that the
66
+ first page after signup shows the restored result in the same tab, and
67
+ the normal first page when no result is stored.
68
+ - `checkout`: the link reaches the checkout route with the plan. The price
69
+ and period on the result equal those of the plan catalog. Use the
70
+ validation mode of the product's checkout; do not pay.
71
+ 7. **Analytics.** The blocked requests of one complete path carry the event
72
+ names and values that [measurement.md](measurement.md) lists, the first
73
+ answer included, and each event once: an answer that appears twice points
74
+ to a binding that repeats what the runtime had already kept. Where the
75
+ path ends in a link, the click of that link carries its keys in
76
+ kebab-case. The answer to a sensitive question is in none of them.
77
+ 8. **Access.** Complete one path with the keyboard only. Focus is visible and
78
+ moves to each new headline. Text contrast is sufficient. With a
79
+ reduced-motion preference the quiz still works.
80
+ 9. **Weight.** On a throttled mobile connection the first screen can be
81
+ used as soon as it is visible. Where the first screen is part of the
82
+ delivered document, hold back the request for the page's module, tap an
83
+ option, and release the request: the option shows as chosen while the
84
+ module is held back, the second screen appears after the release, and the
85
+ event of the first answer is among the blocked requests, once. For an
86
+ interstitial introduction, test an early continue tap and ensure it advances
87
+ once, also when saved progress exists. The route
88
+ loads no feature of the product's application.
89
+ 10. **Links and consent.** The privacy, terms, and contact links work. The
90
+ consent mechanism appears where [implementation.md](implementation.md)
91
+ requires it.
92
+ 11. **The rest of the product.** The homepage, signup, and checkout respond as
93
+ they did before the change.
94
+
95
+ ## When a check fails
96
+
97
+ Fix the cause, redeploy when release is in scope, and repeat the failed check and the ones that depend
98
+ on it. A failure in the copy or the rules is fixed in `quiz.json` and compiled
99
+ again. When the cause is outside the quiz, such as a scheduling page that does
100
+ not open, report it as an open launch condition with the evidence instead of
101
+ working around it.
@@ -0,0 +1,18 @@
1
+ {
2
+ "schema_version": 2,
3
+ "contract": "funnel-walk.v2",
4
+ "viewport": {"width": 390, "height": 844},
5
+ "min_observed_screens": 1,
6
+ "max_screens_per_attempt": 40,
7
+ "screen_kinds": ["landing", "question", "interstitial", "proof", "loader", "plan choice", "contact request", "teaser", "result", "offer", "booking", "account gate", "payment gate", "verification", "confirmation"],
8
+ "advance_types": ["automatic", "button", "link", "none"],
9
+ "stop_reasons": ["needs_approval", "needs_account", "needs_email", "phone", "sms", "captcha", "payment", "live_sales_call", "technical", "budget", "form_not_submitted", "own_no_submit", "completed"],
10
+ "research_statuses": ["queued", "in_progress", "needs_approval", "needs_account", "needs_email", "blocked", "completed", "boundary"],
11
+ "branch_roles": ["main", "auxiliary"],
12
+ "submission_kinds": ["lead_form", "quiz", "webinar_registration"],
13
+ "email_event_types": ["email_confirmation", "email_result"],
14
+ "approval": "human confirmation of the exact known forms and data; supplements for new forms, fields or data",
15
+ "forbidden": ["agent-created competitor account", "payment", "card entry", "live sales call booking", "CAPTCHA bypass", "random real phone number"],
16
+ "identity": "stable plus alias per funnel from a local research identity registry; no contact data in public evidence",
17
+ "observation": "real screenshot per observed screen; partial length and unseen outcomes remain unknown"
18
+ }