@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,256 @@
1
+ {
2
+ "schema_version": "product_analytics_events.v1",
3
+ "status": "active",
4
+ "owner": "egbe-os-analytics",
5
+ "purpose": "Canonical product analytics event contract for OpenClaw-developed products.",
6
+ "naming_policy": {
7
+ "product_events": "Use stable snake_case event names.",
8
+ "system_exception": "campaign-visit remains hyphenated because analytics-gateway campaign reporting is built around this system event.",
9
+ "product_specificity": "Do not encode product, page, or button identity in the event name. Put those details in payload fields."
10
+ },
11
+ "applicability_policy": {
12
+ "required_when_applicable": true,
13
+ "do_not_fake_events": true,
14
+ "selection_rule": "Evaluate every event's required_when against the supplied product requirements and real behavior. Applicable acquisition, interaction, activation, signup, verification, and payment events compose additively; no single product profile is a complete checklist.",
15
+ "pageview_rule": "Use the shared Umami snippet's native pageviews for required page-view measurement; do not invent a custom page-view event.",
16
+ "interaction_rule": "Require cta_click for each primary conversion placement and button_click only for analytically meaningful secondary actions, never every incidental control.",
17
+ "not_applicable_marker": "Mark missing lifecycle areas as not_applicable or pending in product metadata instead of emitting fake events."
18
+ },
19
+ "common_payload": {
20
+ "required": ["product_slug", "path"],
21
+ "recommended": ["surface", "visitor_id", "visit_id", "first_utm_source", "first_utm_medium", "first_utm_campaign"],
22
+ "optional": [
23
+ "first_utm_content",
24
+ "first_utm_term",
25
+ "first_gclid",
26
+ "first_fbclid",
27
+ "first_msclkid",
28
+ "first_ttclid",
29
+ "first_landing_path",
30
+ "first_referrer",
31
+ "first_seen_at",
32
+ "experiment_id",
33
+ "variant_id",
34
+ "activation_id",
35
+ "account_id",
36
+ "user_id"
37
+ ],
38
+ "privacy": {
39
+ "no_raw_emails": true,
40
+ "no_secret_values": true,
41
+ "direct_identifiers": "Avoid raw personal identifiers in Umami payloads. Use non-sensitive internal IDs only when needed."
42
+ }
43
+ },
44
+ "attribution_payload": {
45
+ "source": "Frontend reads window.__egbeAttribution.read(); backend persists the same first-touch fields with durable signup/payment metadata for later backend joins. Signup rows use canonical first_utm_* columns (or their camelCase ORM equivalents) so Site Gateway can discover them automatically.",
46
+ "first_touch_fields": [
47
+ "visitor_id",
48
+ "visit_id",
49
+ "first_utm_source",
50
+ "first_utm_medium",
51
+ "first_utm_campaign",
52
+ "first_utm_content",
53
+ "first_utm_term",
54
+ "first_gclid",
55
+ "first_fbclid",
56
+ "first_msclkid",
57
+ "first_ttclid",
58
+ "first_landing_path",
59
+ "first_referrer",
60
+ "first_seen_at"
61
+ ],
62
+ "rule": "First-touch fields remain stable for the visitor. Later touch data may be stored separately, but channel reports use first-touch by default."
63
+ },
64
+ "delivery_policy": {
65
+ "source_model": "Separate lifecycle confirmation from Umami delivery. Backend can be the source of truth for a durable fact while the browser emits the canonical Umami event so it stays attached to the user's session timeline.",
66
+ "browser_session_rule": "Events that occur during an active user flow must be emitted with the Umami browser tracker (`window.umami.track`) after any required backend confirmation. Do not use direct backend `/api/send` as the primary delivery path for these user-session funnel events.",
67
+ "browser_after_backend_confirmation": {
68
+ "events": ["activated", "signup_completed", "email_verified", "checkout_started", "purchase"],
69
+ "rule": "The backend confirms the durable state change and returns an analytics descriptor. The browser then sends the canonical event immediately or stores it in a short-lived pending queue (for example sessionStorage) and flushes it after redirect."
70
+ },
71
+ "backend_direct": {
72
+ "allowed_when": "Use direct backend delivery only for webhook, renewal, refund, admin/system, or other out-of-session lifecycle events that have no active browser session timeline to join.",
73
+ "events": ["subscription_renewed", "subscription_canceled", "refund"],
74
+ "rule": "Persist first-touch attribution with account/payment metadata so backend direct events can still be joined for channel reporting. Treat Umami {\"beep\":\"boop\"} as filtered delivery when a backend collector send is used."
75
+ },
76
+ "forbidden_primary_backend_collector_events": ["activated", "signup_completed", "checkout_started", "purchase"],
77
+ "umami_session_note": "Umami server-side sends can write aggregate events, but they may receive a different `session_id` from browser events. Use browser delivery for user-session funnel timelines."
78
+ },
79
+ "optional_telemetry_policy": {
80
+ "non_funnel_events": ["engagement-click", "engagement-scroll", "engagement-time"],
81
+ "rule": "Optional engagement telemetry is not part of the canonical product funnel and must not satisfy `cta_click`, `button_click`, or lifecycle event guardrails."
82
+ },
83
+ "events": [
84
+ {
85
+ "name": "campaign-visit",
86
+ "category": "acquisition",
87
+ "source": "frontend_system",
88
+ "confirmation_source": "frontend_system",
89
+ "umami_delivery": "browser",
90
+ "required_when": "A public product page has the shared analytics tracking snippet and the visitor arrives with UTM, click-id, or other explicit campaign attribution. Referrer-only traffic does not trigger this event by itself.",
91
+ "firing_rule": "The shared tracking snippet emits once per attributed visit signature.",
92
+ "required_payload": ["visitor_id", "visit_id"],
93
+ "required_one_of_payload": [
94
+ "utm_source",
95
+ "utm_medium",
96
+ "utm_campaign",
97
+ "utm_content",
98
+ "utm_term",
99
+ "gclid",
100
+ "fbclid",
101
+ "msclkid",
102
+ "ttclid"
103
+ ],
104
+ "recommended_payload": ["landing_path", "referrer", "first_seen_at"]
105
+ },
106
+ {
107
+ "name": "cta_click",
108
+ "category": "landing",
109
+ "source": "frontend",
110
+ "confirmation_source": "frontend",
111
+ "umami_delivery": "browser",
112
+ "required_when": "A primary conversion-driving CTA exists on a public page.",
113
+ "firing_rule": "Fire when the visitor clicks a primary CTA that moves them toward activation, signup, pricing, checkout, or a channel handoff.",
114
+ "required_payload": ["product_slug", "path", "surface", "cta_id", "cta_role"],
115
+ "recommended_payload": ["label", "destination", "position", "visitor_id", "visit_id"]
116
+ },
117
+ {
118
+ "name": "button_click",
119
+ "category": "interaction",
120
+ "source": "frontend",
121
+ "confirmation_source": "frontend",
122
+ "umami_delivery": "browser",
123
+ "required_when": "A non-primary but analytically meaningful button exists.",
124
+ "firing_rule": "Fire for important product or landing buttons. Do not fire for every incidental UI control.",
125
+ "required_payload": ["product_slug", "path", "surface", "button_id", "button_role"],
126
+ "recommended_payload": ["label", "destination", "position", "state", "visitor_id", "visit_id"]
127
+ },
128
+ {
129
+ "name": "activated",
130
+ "category": "activation",
131
+ "source": "frontend_or_backend",
132
+ "confirmation_source": "frontend_or_backend",
133
+ "umami_delivery": "browser_after_backend_confirmation",
134
+ "required_when": "The product has a real first-value moment or core action completion before or after signup.",
135
+ "firing_rule": "Fire when the visitor receives real product value or completes a caller-required core outcome, not when they merely click a button. Use a stable activation_type for each measured outcome and identify one type as the product's primary activation. If the outcome is created by a backend action, return a confirmed analytics descriptor and emit from the browser after success.",
136
+ "required_payload": ["product_slug", "path", "activation_type"],
137
+ "recommended_payload": ["activation_id", "surface", "input_type", "result_type", "duration_ms", "visitor_id", "visit_id"]
138
+ },
139
+ {
140
+ "name": "signup_started",
141
+ "category": "signup",
142
+ "source": "frontend",
143
+ "confirmation_source": "frontend",
144
+ "umami_delivery": "browser",
145
+ "required_when": "A signup, registration, account creation, or lead-capture form exists.",
146
+ "firing_rule": "Fire when a visitor intentionally enters the signup flow.",
147
+ "required_payload": ["product_slug", "path", "surface"],
148
+ "recommended_payload": ["entrypoint", "activation_id", "visitor_id", "visit_id"]
149
+ },
150
+ {
151
+ "name": "signup_submitted",
152
+ "category": "signup",
153
+ "source": "frontend",
154
+ "confirmation_source": "frontend",
155
+ "umami_delivery": "browser",
156
+ "required_when": "A signup form can be submitted.",
157
+ "firing_rule": "Fire immediately before or at form submit after client-side validation passes.",
158
+ "required_payload": ["product_slug", "path", "surface"],
159
+ "recommended_payload": ["activation_id", "visitor_id", "visit_id"]
160
+ },
161
+ {
162
+ "name": "signup_completed",
163
+ "category": "signup",
164
+ "source": "backend_confirmed",
165
+ "confirmation_source": "backend",
166
+ "umami_delivery": "browser_after_backend_confirmation",
167
+ "required_when": "Signup creates a durable account, registration row, subscriber row, or accepted lead-capture row.",
168
+ "firing_rule": "Confirm only after the durable write succeeds. The backend is the source of truth for completion, then the browser emits the Umami event so it joins the signup session timeline.",
169
+ "required_payload": ["product_slug", "path", "surface"],
170
+ "recommended_payload": ["account_id", "activation_id", "duplicate", "visitor_id", "visit_id"]
171
+ },
172
+ {
173
+ "name": "email_verified",
174
+ "category": "email",
175
+ "source": "backend",
176
+ "confirmation_source": "backend",
177
+ "umami_delivery": "browser_after_backend_confirmation_or_backend_direct",
178
+ "required_when": "The product requires email verification or magic-link confirmation.",
179
+ "firing_rule": "Fire when a verification token is accepted and the account/email state becomes verified. Prefer browser delivery on the verification result page; use backend direct only for out-of-session verification handling.",
180
+ "required_payload": ["product_slug", "path"],
181
+ "recommended_payload": ["account_id", "verification_method", "visitor_id", "visit_id"]
182
+ },
183
+ {
184
+ "name": "paywall_view",
185
+ "category": "monetization",
186
+ "source": "frontend",
187
+ "confirmation_source": "frontend",
188
+ "umami_delivery": "browser",
189
+ "required_when": "The product has a paywall, pricing gate, upgrade gate, or paid-plan prompt.",
190
+ "firing_rule": "Fire when the paywall or paid prompt becomes visible.",
191
+ "required_payload": ["product_slug", "path", "surface", "paywall_id"],
192
+ "recommended_payload": ["plan_name", "price_cents", "currency", "activation_id", "visitor_id", "visit_id"]
193
+ },
194
+ {
195
+ "name": "checkout_started",
196
+ "category": "monetization",
197
+ "source": "backend_confirmed",
198
+ "confirmation_source": "backend",
199
+ "umami_delivery": "browser_after_backend_confirmation",
200
+ "required_when": "A real checkout session, payment link redirect, deposit, or paid-pilot checkout starts.",
201
+ "firing_rule": "Confirm when the product successfully creates a dynamic checkout session or real checkout URL. Emit the Umami event from the browser before redirect or queue it and flush before navigation.",
202
+ "required_payload": ["product_slug", "path", "checkout_type"],
203
+ "recommended_payload": ["checkout_session_id", "price_id", "plan_name", "amount_cents", "currency", "activation_id", "visitor_id", "visit_id"]
204
+ },
205
+ {
206
+ "name": "purchase",
207
+ "category": "revenue",
208
+ "source": "backend_confirmed",
209
+ "confirmation_source": "webhook_or_backend",
210
+ "umami_delivery": "browser_after_backend_confirmation",
211
+ "required_when": "A Stripe checkout/payment event confirms successful payment for the product.",
212
+ "firing_rule": "Confirm from the payment webhook or backend status check after idempotently accepting a paid Stripe event. Expose a pending descriptor to the owning checkout-success browser and emit the canonical Umami event there. Use Stripe/OS payment metrics, not server-only Umami delivery, for complete financial totals.",
213
+ "required_payload": ["product_slug", "stripe_event_id", "amount_cents", "currency"],
214
+ "recommended_payload": ["checkout_session_id", "payment_intent_id", "subscription_id", "customer_id", "plan_name", "visitor_id", "visit_id"]
215
+ },
216
+ {
217
+ "name": "subscription_renewed",
218
+ "category": "revenue",
219
+ "source": "backend",
220
+ "confirmation_source": "webhook",
221
+ "umami_delivery": "backend_direct",
222
+ "required_when": "The product supports subscriptions and receives renewal/payment lifecycle events.",
223
+ "firing_rule": "Fire when a subscription renewal invoice is paid and applied idempotently.",
224
+ "required_payload": ["product_slug", "stripe_event_id", "subscription_id", "amount_cents", "currency"],
225
+ "recommended_payload": ["invoice_id", "customer_id", "plan_name", "billing_interval"]
226
+ },
227
+ {
228
+ "name": "subscription_canceled",
229
+ "category": "retention",
230
+ "source": "backend",
231
+ "confirmation_source": "backend_or_webhook",
232
+ "umami_delivery": "browser_after_backend_confirmation_or_backend_direct",
233
+ "required_when": "The product supports subscriptions and receives cancellation/deletion lifecycle events.",
234
+ "firing_rule": "Fire when a cancellation is accepted and entitlement state changes or is scheduled to end. Use browser delivery for user-initiated cancel flows; use backend direct for webhook/admin/system cancellations.",
235
+ "required_payload": ["product_slug", "stripe_event_id", "subscription_id"],
236
+ "recommended_payload": ["customer_id", "plan_name", "cancel_at_period_end", "canceled_at"]
237
+ },
238
+ {
239
+ "name": "refund",
240
+ "category": "revenue_adjustment",
241
+ "source": "backend",
242
+ "confirmation_source": "webhook_or_backend",
243
+ "umami_delivery": "backend_direct",
244
+ "required_when": "The product and payment gateway support refund lifecycle events.",
245
+ "firing_rule": "Fire only when a refund is confirmed and applied idempotently.",
246
+ "required_payload": ["product_slug", "stripe_event_id", "refund_id", "amount_cents", "currency"],
247
+ "recommended_payload": ["payment_intent_id", "checkout_session_id", "customer_id", "reason"]
248
+ }
249
+ ],
250
+ "validation_policy": {
251
+ "setup": "Verify the analytics site exists and OS tracking config is available.",
252
+ "wiring": "Verify the app shell contains the tracking snippet or public analytics env wiring.",
253
+ "behavior": "Drive real product flows and intercept/mock analytics delivery to verify canonical event names and payloads without writing synthetic product events to production stats.",
254
+ "observed": "Use real stats from real users for reporting and channel-level iteration decisions."
255
+ }
256
+ }
@@ -0,0 +1,130 @@
1
+ # Collect and replay session evidence
2
+
3
+ Use this for a requested cohort/window analysis. The helper collects scoped Umami
4
+ events and counts per-session stage observations, not ordered conversion or
5
+ causal business impact. Select event names and property filters from the current
6
+ product emitters and `GET /analytics/events`; one canonical event name may cover
7
+ several different actions.
8
+
9
+ ## Collection
10
+
11
+ Run from the product root. The helper loads `.env.local` through the installed
12
+ quickstart connection helper and includes the current agent identity; otherwise
13
+ it uses `OS_URL` and `OS_API_KEY`. Keep credentials out of artifacts.
14
+
15
+ ```bash
16
+ python3 <analytics-skill>/scripts/umami_funnel.py --site <unique-domain-or-name> \
17
+ --since <YYYY-MM-DD> --until <YYYY-MM-DD> \
18
+ --act-start-event <core-start> --act-event <core-complete> \
19
+ --events-json <work>/evidence/umami-events.json --json <work>/analysis/umami.json
20
+ ```
21
+
22
+ Create the output parent directories in the caller's existing work folder first.
23
+ Both outputs refuse overwrite. Dates are UTC; `--until` is exclusive. Omit dates
24
+ for all history. Exact name/domain/id wins over a unique substring; ambiguous
25
+ sites and incomplete base-event downloads fail rather than silently truncate.
26
+ Record the resolved window/config and inspect enrichment/coverage status.
27
+
28
+ The event snapshot retains every downloaded row, including excluded sessions,
29
+ with safe properties and pseudonymous joins. It preserves safe UTM labels, not
30
+ arbitrary query values, free text or private identifiers. It is not a raw backup;
31
+ redaction limits later analyses needing omitted fields. Preserve source dates,
32
+ queries, exclusions and coverage alongside any derived result.
33
+
34
+ ## Reconcile independent evidence
35
+
36
+ For supplied trackers/exports, read relevant notes and history with the values:
37
+ retain source row/range, definition, reporting window and last update. A blank
38
+ is not zero; old status and source-author advice are not current observed state.
39
+ Preserve the inspected inputs and helper version needed to reproduce material
40
+ calculations. Corrected evidence gets a distinct version, not a silent overwrite.
41
+
42
+ For accounts, jobs and results, inspect the product's actual data-access code.
43
+ Use `egbe-os-db` for scoped read-only SQL and paginated exports, following its
44
+ current response/limit contract. For Convex, use that skill's backend discovery
45
+ and an existing deployed query whose filters and limits you have inspected, not
46
+ a mutation or action. Reading evidence does not authorize provisioning, creating
47
+ jobs or contacting customers. Keep credentials in memory.
48
+
49
+ Inspect only authorized customer evidence. Select necessary fields and redact
50
+ credentials, personal data and signed URLs before the first write; use consistent
51
+ pseudonymous joins. Do not persist raw private media or session replays in the
52
+ analysis. Remove temporary inspection copies after use, retaining anonymous
53
+ observations, access/selection limits and reproducible calculations.
54
+
55
+ ## Offline replay and custom calculations
56
+
57
+ ```bash
58
+ python3 <analytics-skill>/scripts/umami_funnel.py \
59
+ --from-events <work>/evidence/umami-events.json --json <work>/analysis/replay.json
60
+ ```
61
+
62
+ The saved configuration is replayed without a network request. Other event types
63
+ remain in the snapshot, but only pageviews (1) and custom events (2) supply stage
64
+ observations and timelines. Filter **before** grouping, counting or taking time
65
+ extrema, with the same window/internal-activity exclusions:
66
+
67
+ ```python
68
+ funnel_rows = [r for r in snapshot["rows"] if r["eventType"] in (1, 2)]
69
+ ```
70
+
71
+ For fields absent from this snapshot, use authorized source queries and sanitize
72
+ before retaining them. Base events use
73
+ `GET /analytics/<appSlug>/events?startAt=<ms>&endAt=<ms>&page=N&pageSize=500`:
74
+ both bounds are inclusive UTC milliseconds; paginate from 1 through `.data.count`,
75
+ reading `.data.data[]`. Event-data uses the same window/pagination; join event
76
+ `id` to `eventId` and read `eventProperties[]`. Its count is events with properties,
77
+ not property count. The helper converts its exclusive CLI end into the API window.
78
+
79
+ ## Through the Egbe connector
80
+
81
+ Without the helper, collect the same pages with `egbe_read`. Pick the site's
82
+ `appSlug` from `GET /analytics`, then read `/analytics/<appSlug>/events` with
83
+ `query` `startAt` and `endAt` (inclusive UTC milliseconds), `page` from 1 and
84
+ `pageSize` (at most 500; 100 keeps a page in one result). A result with
85
+ `continuation` holds part of that page: read every part with the same `path` and
86
+ `continuation` and join them before parsing; never parse or count a partial
87
+ page. Continue to the next `page` until you have `.data.count` rows. Stop and
88
+ report the coverage as incomplete on an empty page before `count` or a page that
89
+ repeats earlier event `id`s, and narrow the window when `count` is too large to
90
+ read. Read `/analytics/<appSlug>/event-data` the same way and join `eventId` to
91
+ event `id`. Then count per `sessionId` with the counting rules below, applying
92
+ the same exclusions.
93
+
94
+ Keep the window, event names, filters, coverage and derived counts with the
95
+ analysis, without credentials, raw private paths or identifiers (in Egbe's
96
+ artifact store without a project folder). Such a count has no replayable event
97
+ snapshot; say so, and use a set-up project workspace for an analysis that must
98
+ be reproduced offline.
99
+
100
+ ## Counting and coverage
101
+
102
+ - A session may span visits. Per-session observations are unordered; cross-visit
103
+ purchases require appropriate identity. Completion is a technical proxy, not
104
+ proof of useful quality. Reconcile signup with account records and payments
105
+ with provider-confirmed records using the owning capabilities.
106
+ - Only signup-completion events count as signup proxies; account-page visits and
107
+ signup-page visits without intent events are separate. Keep users, attempts,
108
+ transactions, test payments, renewals and refunds distinct in derived analyses.
109
+ - `included_sessions` means not excluded, not verified customers. Engagement/bounce
110
+ are activity proxies: a different page, non-ambient custom event, or scroll+time
111
+ beacons. Section/scroll alone does not count. Check actual emitter wiring;
112
+ mount-fired events cannot establish intent. Sparse events and their observed
113
+ span do not establish total attention or why a person left.
114
+ - Event-only sessions are not arrivals. For an arrival/click ratio, use pageview-
115
+ backed `arrivals_by_source`, not `mix`, and match source, identity and window.
116
+ A source aggregate cannot identify a winning creative. `cta_click` and
117
+ `button_click` remain separate; secondary navigation is not automatically intent.
118
+ - Confirmed synthetic sources (`--internal-sources`, default `smoke`) and verified
119
+ internal countries (`--internal-country`, no default) are excluded. Geography
120
+ alone is not proof of internal activity. Direct desktop DE/FI and debug/admin
121
+ paths are suspect, not automatically excluded; keep uncertainty visible.
122
+ - Reconcile test accounts/jobs with product records and verified testing context.
123
+ Do not infer a customer from a missing test flag. Preserve unknown coverage;
124
+ truncated recent payment readbacks cannot establish lifetime totals.
125
+
126
+ Fleet `product-metrics` uses different definitions: it can infer starts from
127
+ completions, exclude sessions this helper only flags, and include legacy signup-
128
+ submission events excluded here. Reconcile definitions before comparing totals;
129
+ do not change either counter to force agreement or interpret a fleet stage as
130
+ the product's goal.
@@ -0,0 +1,147 @@
1
+ # Activation Tracking
2
+
3
+ Use this workflow when a product has a real first-value moment or core action
4
+ completion.
5
+
6
+ ## Applicability
7
+
8
+ Read the accepted Core Value/CAP result and its confirmation from the current
9
+ product requirements, including `First-value signal` when a PRD exists. For
10
+ bounded maintenance, use the task's accepted behavior and authoritative product
11
+ records. Confirm the actual success branch in implementation before instrumenting.
12
+
13
+ `Public preview` controls only public sampling; `no` does not disable measurement
14
+ of real value after login, payment or processing. Observe that result, not merely
15
+ its prerequisites. If the outcome is unknown or conflicting, identify the missing
16
+ definition and leave it unresolved rather than declaring it inapplicable.
17
+ An informational/static product need not have a discrete activation event:
18
+ use its meaningful existing observations without inventing a form, result or
19
+ synthetic completion. Existing event names or routes alone do not prove value.
20
+
21
+ ## Source Of Truth
22
+
23
+ Always read the live event contract first:
24
+
25
+ ```bash
26
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/events" -s
27
+ ```
28
+
29
+ `canonical-events.v1.json` remains the source of truth for the activation event
30
+ name, required payload fields, recommended attribution fields, and delivery
31
+ policy.
32
+
33
+ ## Event
34
+
35
+ Use the canonical `activated` event when the visitor receives real product
36
+ value. Do not fire it for merely clicking a CTA or landing on a dashboard.
37
+
38
+ Use `activation_type` for the product-specific value shape instead of inventing
39
+ product-specific event names:
40
+
41
+ ```js
42
+ window.umami?.track("activated", {
43
+ product_slug: "my-product",
44
+ path: "/dashboard",
45
+ activation_type: "report_generated",
46
+ });
47
+ ```
48
+
49
+ ## Browser Payload
50
+
51
+ Read first-touch attribution from the shared snippet when the browser starts the
52
+ core action:
53
+
54
+ ```js
55
+ const attribution = window.__egbeAttribution?.read?.() || {};
56
+ ```
57
+
58
+ Include the required payload from the event contract and useful attribution
59
+ fields:
60
+
61
+ ```js
62
+ const activationPayload = {
63
+ product_slug: "my-product",
64
+ path: "/dashboard",
65
+ activation_type: "report_generated",
66
+ visitor_id: attribution.visitor_id,
67
+ visit_id: attribution.visit_id,
68
+ first_utm_source: attribution.first_utm_source,
69
+ first_utm_medium: attribution.first_utm_medium,
70
+ first_utm_campaign: attribution.first_utm_campaign,
71
+ };
72
+ ```
73
+
74
+ ## Backend-Confirmed Activation
75
+
76
+ If first value is created by a backend/API action, separate the durable
77
+ confirmation source from Umami delivery:
78
+
79
+ 1. Browser sends attribution with the core-action request.
80
+ 2. Backend performs the durable first-value write or confirms the real result.
81
+ 3. Backend returns an analytics descriptor only after success.
82
+ 4. Browser emits that descriptor with `window.umami.track(...)`.
83
+
84
+ Backend response shape:
85
+
86
+ ```json
87
+ {
88
+ "ok": true,
89
+ "analytics": {
90
+ "name": "activated",
91
+ "data": {
92
+ "product_slug": "my-product",
93
+ "path": "/dashboard",
94
+ "activation_type": "report_generated",
95
+ "activation_id": "report_123",
96
+ "visitor_id": "visitor_123",
97
+ "visit_id": "visit_123",
98
+ "first_utm_source": "reddit"
99
+ }
100
+ }
101
+ }
102
+ ```
103
+
104
+ Browser delivery:
105
+
106
+ ```js
107
+ const result = await response.json();
108
+
109
+ if (result.analytics?.name && window.umami?.track) {
110
+ window.umami.track(result.analytics.name, result.analytics.data || {});
111
+ }
112
+ ```
113
+
114
+ If the activation flow redirects immediately, store the descriptor in a
115
+ short-lived `sessionStorage` pending queue, navigate, then flush it from the next
116
+ browser page with `window.umami.track(...)`.
117
+
118
+ Do not use direct backend Umami `/api/send` or `trackServerEvent` as the primary
119
+ delivery path for `activated`; it can attach the event to a different Umami
120
+ session than the visitor's browser session.
121
+
122
+ ## Practical Rules
123
+
124
+ - Preserve the existing product feature behavior.
125
+ - Emit activation once per real first-value moment or use payload state such as
126
+ `activation_id` to make repeat behavior explainable.
127
+ - Put no raw emails, secrets, input documents, tokens, or payment details in
128
+ Umami payloads.
129
+ - Persist first-touch attribution with durable user/account/value metadata when
130
+ a backend exists, so later revenue and retention reporting can join back to
131
+ acquisition channel.
132
+
133
+ ## Bounded Verification
134
+
135
+ When activation is applicable, prove the authoritative first-value branch with
136
+ the smallest existing helper, handler, route, or component test. For a
137
+ backend-confirmed outcome, verify that the success branch returns the canonical
138
+ descriptor only after the real result or durable write succeeds, and that error,
139
+ placeholder, and no-result branches omit it. Verify browser delivery through the
140
+ existing descriptor consumer or one focused test around it. Test a pending
141
+ redirect queue only when the product uses one.
142
+
143
+ Do not replay the whole product journey, build a new browser harness, emit a
144
+ synthetic activation into production stats, or deploy solely to prove logic
145
+ already covered by focused evidence. If the accepted behavior has no discrete
146
+ first-value event and no misleading instrumentation needs repair, no code or
147
+ deployment change is required; report that bounded conclusion, not absent value.