@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,184 @@
1
+ # Funnel Teardown
2
+
3
+ Internal section 05 inspects the creative sample selected in 04. Its unit is
4
+ creative + channel + market + verified destination + observed buyer path.
5
+ Never run a separate weight ranking or use accessible homepages to fill
6
+ unknown ad destinations. Every distinct selected funnel is investigated;
7
+ unfinished work is resumed, not silently capped.
8
+
9
+ ## 1. Prepare the inputs
10
+
11
+ Require completed current 01/03/04 publications and the canonical 04
12
+ `creative-selection.v1.json` manifest. Use buyer/offer-card context from 01,
13
+ explicit own destination URLs from intake/product context and the shared
14
+ research mailbox identity registry. Keep concrete product routes, persona names
15
+ and mailbox values in runtime, not in this skill.
16
+
17
+ Write `egbe-docs/research/market/work/funnel_teardown/research-context.json`, for example:
18
+
19
+ ```json
20
+ {
21
+ "persona": {"id": "buyer", "name": "Sam Researcher", "buyer_context": "The agreed buyer and offer card"},
22
+ "own_destinations": [{"url": "https://product.example/start", "country": "US"}],
23
+ "mailbox": "research@example.org"
24
+ }
25
+ ```
26
+
27
+ ```bash
28
+ BUNDLE=/path/to/product-market-research
29
+ WS=/path/to/product-workspace
30
+ python3 "$BUNDLE/scripts/run-funnel-teardown.py" --workspace "$WS" --phase prepare
31
+ ```
32
+
33
+ Prepare is deterministic and makes no provider calls or plain fetches. It pins
34
+ 04, policy, manifest and context, writes `candidates.json`, allocates stable
35
+ per-funnel aliases under the shared registry lock, creates empty private form
36
+ journals and exits 2. Missing persona/own destinations remain explicit pending
37
+ inputs; the runner does not infer `/backend` or a competitor's generic page.
38
+ The campaign cutoff is inherited from 04 and does not advance with browser or
39
+ email observation time.
40
+
41
+ For selected creatives missing destination, perform a bounded source lookup:
42
+ open the native ad and its visible CTA or read native destination metadata;
43
+ use Google/SpyFu ad-history rows attributable to that selected ad. Follow the assigned
44
+ scope and preserve channel/market identity. Record attempts,
45
+ source availability and candidate URLs in `destinations.json`; promote only a
46
+ verified ad-to-URL relation under the contract. YouTube description and LinkedIn
47
+ site links remain candidates until that relation is established. If bounded
48
+ lookup fails, keep `destination_unknown` with the actual reason and source refs.
49
+ Reprepare after enrichment; enrichment may fill URLs, not change the selected
50
+ campaigns or their upstream sample.
51
+
52
+ ## 2. Scout, list forms and obtain human confirmation
53
+
54
+ Open entries in a real browser at 390×844 without sending contact forms.
55
+ Identify the main CTA implied by the creative and scout available steps. Capture
56
+ real screenshots and page content, including lower-page proof/price blocks.
57
+ Keep consent and optional discount popups separate from the main route.
58
+ Preserve HTTP(S) ad entries and record an observed redirect chain when the
59
+ browser opens another URL; a redirect is not permission to merge destinations.
60
+
61
+ Prepare one combined list of known forms with exact fields, data, aliases,
62
+ competitor/campaign/funnel/path, purpose and screenshot reference. Populate
63
+ `approval-plan.json` following the v2 contract. Present that concrete list to
64
+ the founder and wait for actual confirmation. Record the human chat reference
65
+ and exact fingerprints in `approvals.json`. A JSON file you wrote is not human
66
+ confirmation. New forms, fields or data require a supplement and new approval.
67
+
68
+ A caller that sends no forms skips the list and
69
+ the approval: each walk captures the first contact screen with its fields and
70
+ stops there as `boundary` / `form_not_submitted`. Nothing is submitted, so no
71
+ mail check follows.
72
+
73
+ ## 3. Walk deeply and preserve progress
74
+
75
+ The bundled driver keeps one mobile Chrome (390×844) open for the whole walk
76
+ and records each screen where the report can publish it:
77
+
78
+ ```bash
79
+ python3 "$BUNDLE/scripts/walk-funnels.py" serve --workspace "$WS" &
80
+ python3 "$BUNDLE/scripts/walk-funnels.py" call open '{"funnel_id": "<id>", "url": "<address>"}'
81
+ python3 "$BUNDLE/scripts/walk-funnels.py" call screen '{"funnel_id": "<id>", "screen_id": "s01-landing", "kind": "landing", "slices": 2,
82
+ "fields": {"headline": "...", "cta": "...", "offer": "...", "amounts": [], "notes": "..."}}'
83
+ python3 "$BUNDLE/scripts/walk-funnels.py" call click '{"funnel_id": "<id>", "text": "Get started"}'
84
+ python3 "$BUNDLE/scripts/walk-funnels.py" call finish '{"funnel_id": "<id>", "status": "boundary", "stop_reason": "form_not_submitted", "unknown": ["..."]}'
85
+ python3 "$BUNDLE/scripts/walk-funnels.py" build --workspace "$WS"
86
+ ```
87
+
88
+ Every answer returns the page's text, inputs and buttons for the next
89
+ decision. Screenshots land under `egbe-docs/research/market/assets/funnel-teardown/`,
90
+ records under the runtime's `records/`; `build` writes `walks.json` from them.
91
+
92
+ Read [`funnel-teardown.md`](../contracts/funnel-teardown.md) and the shared
93
+ mechanics JSON. Answer as the agreed buyer; record the actual answers per screen
94
+ and visible branch points. Investigate additional relevant paths only where the
95
+ offer, final result, price or conversion changes. Capture screenshots of every
96
+ logical screen, not fabricated placeholders. One real immediate gate is valid.
97
+ Review every screenshot for visible contact values, personalized names/phones
98
+ and private verification URLs. Capture before filling where possible. If a
99
+ later screen echoes private data, keep the original in private runtime and
100
+ declare a real privacy-redacted display derivative with source hash and
101
+ derivation; never treat a file hash as pixel sanitization or invent an observed
102
+ screen. Include lower-page captures in the same privacy review.
103
+
104
+ Before sending an approved lead/quiz/webinar form, append a submission intent.
105
+ Then submit exactly the approved data and record the browser response. Continue
106
+ after contact requests. If a crash leaves outcome unknown, inspect existing
107
+ state before any retry; preserve uncertainty until resolved. Resume must never
108
+ re-register automatically or allocate another alias for that funnel.
109
+ Keep all prior form revisions, approvals and submission events append-only.
110
+ An observed failed attempt needs a new human approval before a retry.
111
+
112
+ Complete permitted registrations and quizzes. Stop before creating an account,
113
+ payment/card entry, CAPTCHA/bot verification, required SMS, or booking a live
114
+ sales rep. Record account gate as `needs_account`; continue only after the
115
+ authorized account holder supplies access, recorded with a human chat reference.
116
+ A fictional full US phone ending 555-0100–0199 is used only if approved and
117
+ accepted; otherwise record a phone block. Own destinations
118
+ are walked under the same contract, with no sending or booking.
119
+
120
+ After 40 captured screens in an attempt, save a budget checkpoint and resume
121
+ under a new attempt ID. Persist full `walks.json` paths and journals. Do not
122
+ reinterpret a checkpoint or the contact screen as the funnel's terminal outcome.
123
+ Unknown, absent and not applicable differ; a teaser role/result example does
124
+ not count as the final personalized quiz result.
125
+
126
+ Read confirmation/result email through 02's same-day handoff, using the same
127
+ alias and funnel/campaign refs. Confirmation links can be followed only within
128
+ the approved registration's purpose. Do not expose private tokenized email URLs.
129
+ A received mail is a separate evidence event, not a website screenshot. Mail
130
+ waiting and terminal coverage gaps do not change the advertising cutoff or
131
+ the observed browser result.
132
+ Record `email_expectations` on the submitted path: `confirmation` and `result`
133
+ are true, false or unknown, with an actual `browser:<screen_id>` source for
134
+ known expectations. Finalize once to write the private handoff, then run:
135
+
136
+ ```bash
137
+ python3 "$BUNDLE/scripts/run-lifecycle-capture.py" --workspace "$WS" --funnel-mail --refresh
138
+ ```
139
+
140
+ Each new approved registration needs a successful attributable inbox check
141
+ after its latest submission on the same recorded local day. An earlier cached
142
+ snapshot does not satisfy it. Received confirmation is not confirmed; unknown
143
+ expectations remain visible as unknown. A successful attributable query closes
144
+ unknown expectations as `email_expectation_undetermined`. If the submission day
145
+ has already passed without its first check, record `same_day_check_missed`;
146
+ do not repeat the submission. Expected mail remains pending until its observed
147
+ `email_expectations.wait_until` (aware timestamp with the browser promise
148
+ source), otherwise the existing 14-day Lifecycle Capture boundary. Refresh the
149
+ inbox at that boundary before recording missing mail as a terminal coverage
150
+ gap. This does not complete an unseen final result or confirmation. Explicit
151
+ no-email expectations still require the inbox check and then record that review.
152
+
153
+ ## 4. Validate and finalize
154
+
155
+ ```bash
156
+ python3 "$BUNDLE/scripts/run-funnel-teardown.py" --workspace "$WS" --phase finalize
157
+ ```
158
+
159
+ The runner validates hashes, mobile observations, exact approvals/data, intent
160
+ and outcome ordering, permitted boundaries, own no-submit, persona paths and
161
+ market scope. Queue/budget/approval/email/uncertain-submit states exit 2 and
162
+ retain all progress. A generic shortfall sentence cannot waive missing selected
163
+ paths. Legacy v1 is reported explicitly and requires fresh browser evidence.
164
+
165
+ Evidence v2 contains campaign lineage, browser page/screens, per-path walks,
166
+ country/channel patterns and specific coverage. Native delivery durations and
167
+ observed current activity remain separate; neither is a success verdict or a
168
+ copy recommendation. Shares count unique campaigns with known features and
169
+ show unknown counts; recurrence counts competitors, never paths. Own observations
170
+ and market mismatches remain visible but do not enter competitor aggregates.
171
+
172
+ The report renders both A (selected creative → campaign → every observed screen)
173
+ and B (per-channel/market funnel types, structure and category-angle links),
174
+ with screenshots, reached outcomes, boundaries, gaps and own comparison.
175
+ The runner writes the canonical evidence and report, pins all used sources and
176
+ assets, and persists the docs publication only when no active research remains.
177
+ Managed publication uses the established docs persistence; local workspaces
178
+ remain local. When sharing research, include its declared public assets and
179
+ preserve source references and gaps.
180
+
181
+ Replicate the observed structure and conversion sequence, never competitor
182
+ copy, claims or numbers. Advertising persistence does not establish measured
183
+ conversion or causal effectiveness. Borrowing another channel's structure must
184
+ be explicit in the planner and cannot prove a destination in the target channel.
@@ -0,0 +1,84 @@
1
+ # Geography comparison
2
+
3
+ Read `../contracts/research-artifacts.md`, the prepared assignment, and the recommendation
4
+ reason when present. This selected workflow compares plausible markets for the
5
+ **next test**; it does not change the founder's chosen market, PRD or campaigns.
6
+ It can also run standalone after launch. Do not start another research section.
7
+
8
+ ## Assignment and source scope
9
+
10
+ Use the question, country scope and criteria from the project method/current
11
+ task. Comparison and conditional recommendations are allowed; do not choose
12
+ a new business goal or assume authority to change a launch market. Preserve
13
+ explicit founder constraints separately from preferences or evidence.
14
+
15
+ ## Reuse evidence, then fill assigned gaps
16
+
17
+ From the workspace root, resolve `<skill-root>` to this extracted bundle:
18
+
19
+ ```bash
20
+ python <skill-root>/scripts/geography-comparison.py --workspace . --prepare
21
+ ```
22
+
23
+ Pass `--context-file <selected-context>` when the comparison needs provider-safe
24
+ background beyond the explicit assignment; do not pass unrelated project material.
25
+
26
+ Read `egbe-docs/research/market/work/geography_comparison/context.json`. The command returns
27
+ its SHA-256 for the comparison input. It includes only receipt-validated public
28
+ research as usable evidence; failed and unavailable sections remain explicit
29
+ gaps. Valid prior research can be reused even if it is not selected for new
30
+ collection. It makes no provider calls. Re-running refreshes changed inputs
31
+ and invalidates old completion; unchanged context resumes without recollection.
32
+ Keep prior search results/notes under this section's runtime directory for reuse.
33
+
34
+ Compare the assigned criteria using compatible measurement definitions and
35
+ reference periods. Unknown cells stay unknown. Do not combine overlapping
36
+ populations, incomparable CPCs or independent budget scenarios.
37
+
38
+ For gaps relevant to the assigned question, read the live OS `/search/skill` and
39
+ use targeted `POST /search/web/brave` queries per country and question, including
40
+ local-language queries and relevant official domains. Read original pages before
41
+ using decisive facts; snippets are discovery leads. Use available page-reading
42
+ tools; where extraction needs OS, discover `/scrape/skill` and use a bounded
43
+ actor only within the authorized budget. Do not invent a fetch endpoint or
44
+ use direct provider keys. Save source links, dates/periods and material excerpts.
45
+
46
+ Agree with or stay within the caller's research budget. Search the narrowest
47
+ decisive gaps first and stop when another query is unlikely to change the next
48
+ test, or the budget is reached. If budget/sources are insufficient, publish an
49
+ uncertain comparison with a concrete next check. Do not run every PMR section
50
+ for every country or send one giant "compare 12 markets" OS Research request.
51
+ This workflow is agent-led synthesis, not another OS Research job; do not create
52
+ a fake job ID or perform the OS Research Completion Review.
53
+
54
+ Brave search regions are not arbitrary ISO countries; follow the search skill's
55
+ country guidance. Places is optional discovery of local companies, never a
56
+ complete company count. Perplexity is not a prerequisite or an automatic fallback.
57
+ Provider failures are limitations, not evidence against a country; preserve
58
+ successful work and do not repeatedly spend to fill every cell.
59
+
60
+ ## Compare and publish
61
+
62
+ Write a temporary input JSON using
63
+ [`../contracts/geography-comparison.md`](../contracts/geography-comparison.md).
64
+ Keep claims and interpretation separate. Prefer original regulators/registries,
65
+ transparent datasets and product outcomes; vendor material is interested
66
+ evidence. Preserve the same measurement definitions and reference periods.
67
+
68
+ When the assignment asks for a recommendation, explain it conditionally and
69
+ what could change it. Otherwise keep both recommendation country fields null
70
+ and report the comparison. Do not claim approval or rewrite launch geography.
71
+
72
+ ```bash
73
+ python <skill-root>/scripts/geography-comparison.py --workspace . \
74
+ --input <temporary-comparison.json>
75
+ ```
76
+
77
+ The helper validates structure/references, renders only `## Geography comparison`
78
+ in `egbe-docs/research/market/full-report.md`, and publishes the accompanying analysis at
79
+ `egbe-docs/research/market/evidence/geography-comparison.json`. It marks completion only
80
+ after publication; it cannot establish whether the agent's judgment is correct.
81
+ Publication materializes and verifies local files; Git belongs to the caller's
82
+ normal project workflow. A receipt does not claim a commit or remote publication.
83
+ Retry a failed publication with the same input; do not repeat searches. If inputs
84
+ changed, prepare again and review the comparison against the refreshed context.
@@ -0,0 +1,122 @@
1
+ # Keyword Economics
2
+
3
+ Read `../contracts/research-artifacts.md` and the prepared assignment (plus the
4
+ recommendation artifact when relevant). This section uses NO OS Research job
5
+ and no free-form web research: every number comes from metered DataForSEO
6
+ calls made by the bundled deterministic runner, and the section body plus its
7
+ machine-readable evidence file are rendered by that runner. Do not write or
8
+ edit section prose, tables, or the evidence file by hand.
9
+
10
+ ## 1. Use the assigned search scope
11
+
12
+ Supply the nonempty phrase list relevant to the caller's question, using the
13
+ assignment's evidence and explicitly supplied scope as context. There is no required
14
+ number of phrases or mix of category/problem/purchase language. The runner
15
+ measures each candidate and records exclusions and coverage; observed search
16
+ volume is not by itself product-fit or willingness-to-pay evidence. Named
17
+ competitor domains may be supplied as seed domains.
18
+
19
+ Translate the assignment's geography and language to Google Ads location and
20
+ language codes and pass them explicitly. If locale is unresolved, establish the
21
+ scope before a paid query; the runner's US/en defaults are not a market choice.
22
+ For several countries, invoke the runner once per country. Locale files live at
23
+ `egbe-docs/research/market/evidence/keyword-economics/<location>-<language>.json`;
24
+ the stable aggregate and report retain all current locales. Rerunning one locale
25
+ does not replace another. Compare locale inputs before combining them; changed
26
+ selected context does not authorize new collection or make old observations
27
+ false. Preserve saved evidence and review applicability rather than blending
28
+ different research scopes or silently refreshing paid data.
29
+
30
+ ## 2. Run the deterministic runner
31
+
32
+ From the workspace root, resolve `<skill-root>` to the extracted directory
33
+ containing this skill's `SKILL.md`, then run:
34
+
35
+ ```bash
36
+ python3 <skill-root>/scripts/run-keyword-economics.py \
37
+ --workspace . \
38
+ --seed-keywords "<phrase one>, <phrase two>, <phrase three>, ..." \
39
+ --seed-domains "<competitor.com, other.com — omit flag when none>" \
40
+ --location-code 2840 \
41
+ --language-code en
42
+ ```
43
+
44
+ The runner needs `OS_API_KEY` (and optional `OS_URL`) in the environment. It
45
+ expands seeds through Google Ads keyword data, probes the results page for the
46
+ top head keywords (who ranks organically, who pays in the ads block), confirms
47
+ candidate competitors from that demand surface, confirms only those with
48
+ category-relevant SERP evidence (or preserves founder-named domains as
49
+ hypotheses), pulls each confirmed domain's ranked-keyword footprint,
50
+ reports provider forecast estimates, optionally scales them to a supplied
51
+ `--test-budget-usd` scenario, and then:
52
+
53
+ - writes evidence rows to `egbe-docs/research/market/evidence/keyword-economics.json`;
54
+ - materializes the exact section under `## Keyword economics` in
55
+ `egbe-docs/research/market/full-report.md`;
56
+ - verifies the report and evidence together; Git remains caller-owned;
57
+ - records the completed state receipt under
58
+ `egbe-docs/research/market/work/keyword_economics/`.
59
+
60
+ Every upstream response is cached in the runtime directory, so re-running the
61
+ same command replays cached data instead of spending the metered budget again.
62
+ The default forecast covers all eligible seed/expansion candidates up to 1000,
63
+ not a fixed five keywords. Coverage records requested/submitted keywords,
64
+ exclusions and cap omissions. It is an exploratory exact-match scenario, not an
65
+ approved campaign, total reachable demand or a live starting bid. Aggregate
66
+ provider responses describe the set once. US/UK budgets are alternative
67
+ comparisons, not additive allocations. Null/empty forecasts are unavailable,
68
+ not zero demand; budget-scaled clicks are conditional arithmetic.
69
+
70
+ The DataForSEO forecast endpoint requires whole-dollar bids. For the automatic
71
+ exploratory forecast, the runner rounds its observed CPC assumption up to the
72
+ next whole USD before the first request (within 1–500), and records the actual
73
+ bid in the evidence and report. Observed CPC measurements remain unchanged.
74
+
75
+ For an explicitly chosen homogeneous scenario, pass `--scenario <file.json>`:
76
+
77
+ ```json
78
+ {"keywords":["example service","example pricing"],"location_code":2840,"language_code":"en","match":"phrase","bid":3,"rationale":"Bounded exploratory bid assumption","source":"Caller-selected scenario"}
79
+ ```
80
+
81
+ The locale must match the run; one match type and one whole-dollar bid (1–500)
82
+ apply to at most 1000 unique keywords. Mixed per-keyword bids/matches cannot be
83
+ represented faithfully by this endpoint; do not silently flatten campaign
84
+ assets into a forecast. The scenario never changes a live campaign.
85
+ Fractional explicit bids fail validation before any paid calls. Choose and record
86
+ a whole-dollar scenario; do not silently round a caller-specified bid.
87
+ The evidence adds a bounded `intent_signal` to keyword and SERP rows. It is a
88
+ lexical clue (`vendor_seeking`, `tool_seeking`, `informational`, `job_seeking`,
89
+ `free_intent`, or `unknown`), not an offer-fit or campaign-selection verdict.
90
+ Google Ads must compare it with the actual product offer before selecting paid
91
+ keywords. An ambiguous AEO/GEO query cannot alone confirm a competitor.
92
+
93
+ ## 3. On failure
94
+
95
+ Provider rate limits and recognized internal DataForSEO errors explicitly
96
+ confirmed as unpaid are handled inside the runner: it logs the failure and
97
+ retries the unchanged request with bounded backoff. Do not add manual waits or
98
+ retry wrappers around it. An internal error is not proof of valid input or a
99
+ guarantee of recovery. Validation errors need corrected input; unknown billing
100
+ status is not safe to retry automatically.
101
+ `50301` with `Request contains an invalid argument` is an input rejection, not
102
+ a rate limit; the runner stops rather than repeating it unchanged.
103
+
104
+ If the runner reports exhausted retries, the section is blocked, not completed.
105
+ Preserve the workspace and report the failed operation, provider code and task
106
+ ID (when available), and that automatic retries were exhausted. Do not hide the
107
+ failure by skipping evidence or declaring the research complete. A later
108
+ recovery attempt can rerun the same command using its cached successful
109
+ responses; use the caller's recovery mechanism rather than starting an
110
+ unbounded manual loop.
111
+
112
+ If the runner
113
+ reports that no seed survived volume validation, report the measured coverage. Expand or change the assigned phrase list only
114
+ when that remains within the caller's requested scope and collection budget. For
115
+ any other failure, preserve the runtime state and stop; a later attempt
116
+ resumes from cache. Do not substitute Brave search, generic OS Research,
117
+ Apify, direct provider access, or an agent-written result, and do not edit
118
+ `egbe-docs/research/market/full-report.md` or the evidence file manually. Completion is
119
+ validated deterministically from the runtime receipt; this section has no
120
+ LLM-based Research Completion Review step.
121
+ Old single-locale evidence is not silently migrated. Preserve it and use a new
122
+ workspace with the current bundle when the runner reports an unsupported format.
@@ -0,0 +1,218 @@
1
+ # Lifecycle Capture
2
+
3
+ Internal research of the email portion of competitors' conversion journeys.
4
+ Start immediately after Competitor Set so observation runs alongside other
5
+ research. Read the [input and observation contract](../contracts/lifecycle-capture.md).
6
+ Replicate plans do not consume lifecycle evidence.
7
+
8
+ ## Policy
9
+
10
+ Assign registration, double opt-in and unsubscribe to a human with verified
11
+ access to the planned aliases and assigned mailbox. Any authorized human with
12
+ that verified access is eligible, regardless of role. If nobody with that access
13
+ is available, leave the actions pending and
14
+ continue other research. The agent inspects entry points without submitting
15
+ forms, records actual results, and
16
+ reads the assigned mailbox. Never pay, enter card details, supply a required
17
+ phone, bypass a CAPTCHA or bot check, or use a real third-party identity.
18
+ Leave optional phone fields empty. Never reply to sales representatives.
19
+ A rejected plus address or unavailable form needs a verified fallback or a skip.
20
+
21
+ Use one planned alias per competitor per capture: `<local>+NN@<domain>`, where
22
+ NN is random from 10–99. OS reserves numbers uniquely across captures sharing
23
+ the mailbox. A fresh research workspace creates a new capture; refresh retains
24
+ its UUID and mapping. Active legacy captures retain their existing aliases.
25
+ Exhaustion stops clearly; numbers are never silently reassigned.
26
+ The shared operational mailbox stays. Neutral tags do not conceal its address.
27
+ Attribution uses exact full To/Delivered-To matches, never sender or a prefix.
28
+
29
+ Bodies, mailbox addresses, aliases, message ids and personal links stay in the
30
+ private runtime. Every published string is scrubbed at one boundary: planned
31
+ addresses and the mailbox, plain or percent-encoded, become `[address]`;
32
+ message references become “a message”; unreadable messages disclose HTTP status
33
+ only. Published entry URLs lose query/fragment. Evidence carries subjects and
34
+ extracted facts, never bodies or excerpts. The list of signup actions also stays private.
35
+
36
+ ## 1. Plan and discover entries
37
+
38
+ ```bash
39
+ python3 scripts/run-lifecycle-capture.py --workspace . --product-domain product.com
40
+ ```
41
+
42
+ Requires OS_API_KEY, optional OS_URL, and the deployed OS alias-reservation
43
+ endpoint. Domains come from --domains, receipt-backed Competitor Set, then
44
+ Keyword Economics excluding rejected domains; default maximum 10. This section
45
+ accepts the upstream selection as given.
46
+
47
+ The first call persists a capture id before reserving aliases, writes private
48
+ `egbe-docs/research/market/work/lifecycle_capture/plan.json`, and exits 2. URLs before review
49
+ are discovery seeds, not sign-up recommendations. Completed Funnel Teardown
50
+ may supply seeds but is not a prerequisite.
51
+
52
+ Inspect each competitor's comparable offer and public conversion path with the
53
+ available browser/source tools. Prefer details/materials, webinar/info session,
54
+ quiz/assessment, waitlist, free account or card-free trial, then newsletter.
55
+ Relevance to the current buyer and purchase matters: explain when a lower-ranked
56
+ entry is the closest usable path. A generic account or newsletter is not the
57
+ same sales journey without evidence.
58
+
59
+ Record selected and verified fallback entries in private entry-points.json
60
+ using the contract: fields, consent, phone/card requirements, instructions,
61
+ stopping point, sources and verification date. Unknown requirements stay
62
+ unknown. Hosted forms need the competitor's source/CTA, actual destination and
63
+ link/embed evidence. Record silent-waitlist risk rather than promising nurture.
64
+ Rerun: the runner validates discovery, incorporates it into plan.json and
65
+ renders private lifecycle-signups.md. Hand over that list early; do not rewrite
66
+ its choices independently.
67
+
68
+ ## 2. Record signup results and continue research
69
+
70
+ The assigned human reports results in ordinary chat. Update subscriptions.json with
71
+ actual dates and the planned selected/fallback entry. Unknown phone/card needs
72
+ require verification by that human. Fallback use needs a reason; unavailable entries
73
+ go in skipped. Rerun to validate aliases, dates and entry binding, then publish
74
+ started when all competitors are accounted for. Pending sign-ups do not block
75
+ other research. An explicit harvest can read recorded
76
+ subscriptions while preserving outstanding ones as coverage limitations.
77
+
78
+ The runner writes private operator-actions.json with signup, confirmation and
79
+ unsubscribe actions plus day-3/day-14 harvest deadlines per actual subscription.
80
+ Unknown confirmation status does not imply double opt-in. If a confirmation
81
+ arrives, ask the assigned human to confirm through their authorized mailbox
82
+ access and record confirmed:false until they report success. Never expose
83
+ private confirmation links in published research.
84
+ Use the scheduling/runtime mechanism supplied by the caller to reconcile dates,
85
+ install harvest follow-ups and bounded reminders. Scheduler ids stay outside
86
+ domain artifacts. A manual caller without scheduling discloses that limitation
87
+ and hands over due dates: writing the file alone does not install reminders.
88
+ Cancel obsolete jobs when actions finish or captures change. Unsubscribe
89
+ reminders become actionable only after the full harvest.
90
+
91
+ ## 3. Early and full harvest
92
+
93
+ ```bash
94
+ python3 scripts/run-lifecycle-capture.py --workspace . --product-domain product.com --harvest
95
+ ```
96
+
97
+ Run day 3 for early evidence and day 14 for the full window, separately from
98
+ each competitor's subscription date. Earlier confirmation reads are allowed.
99
+ The command derives partial/full from duration; successful publication is a
100
+ separate fact. Later snapshots replace current evidence/report and preserve
101
+ immutable private provenance for previously shared research.
102
+
103
+ List by full alias from the day before subscription through GET /mail/inbox
104
+ with to, since and limit=50; retain exact recipient hits. Read each message once
105
+ through GET /mail/message/{uid}. Record UTC arrival, subject, sender domain,
106
+ confirmation/welcome/nudge/offer/content signals, prices, discounts, deadlines
107
+ and unsubscribe availability. Nothing after cutoff/unsubscribe enters the data.
108
+ Bodies remain cached privately.
109
+ The cache stores portable message content without access-bearing links or
110
+ credentials; originals requiring those values stay under the research
111
+ `.local/lifecycle_capture/mail-cache/` boundary described in the artifact contract.
112
+
113
+ Observed positive behavior at two or more competitors may inform standalone
114
+ future email sequences with a partial badge and stated window; it does not
115
+ authorize a replicate option.
116
+ No offer by day 3 does not mean none in the
117
+ first week or full capture. Weekly cadence needs at least seven days; a welcome
118
+ burst is not a sustained schedule. Extracted structure/timing can inform future
119
+ email sequences while respecting current product claims and explicit limits.
120
+
121
+ Duration, dates and coverage remain visible. Fourteen days is a target duration,
122
+ not proof no mail was missed. A full 50-message page, missing body, failed listing,
123
+ unconfirmed opt-in or pending signup remains a limitation. Zero messages applies
124
+ only to its observed window, not a claim that the competitor does no email.
125
+ Budgets: 30 inbox listings and 60 message reads per invocation. Cached bodies
126
+ are reused; same-cutoff listings replay and the next day refreshes. --as-of is
127
+ never before the first subscription or after today, and cannot replace a newer
128
+ publication. Refused keys, rate limits and unreachable OS stop. No successful
129
+ listing means failure rather than an empty published harvest.
130
+
131
+ ## 4. Publish
132
+
133
+ Write egbe-docs/research/market/evidence/lifecycle-capture.json with subscription,
134
+ lifecycle_sequence, lifecycle_message, lifecycle_pattern and coverage rows;
135
+ materialize Lifecycle capture in egbe-docs/research/market/full-report.md and record a
136
+ hash-backed receipt. The runner verifies report and evidence together; Git belongs to the caller. completed means publication succeeded;
137
+ phase and observation metadata determine whether the window was harvested.
138
+
139
+ A caller that indexes lifecycle evidence rebuilds its evidence index after
140
+ each harvest and carries the windows and coverage through.
141
+
142
+ ## 5. Funnel handoff and same-day mail
143
+
144
+ 05 reserves one numeric plus alias per funnel in the shared runtime registry
145
+ `egbe-docs/research/market/work/identity-registry.json` (schema 1, mailbox, identities with
146
+ identity_id, domain, funnel_id, alias and kind). Ordinary 02 capture aliases, including active legacy aliases, remain
147
+ reserved too; their OS reservation policy is unchanged. The registry is private, stable across resume and protected by
148
+ `identity-registry.json.lock`; never allocate a different alias on a retry.
149
+ Receipts use a canonical `identity_registry_binding` for only the identities
150
+ that section uses, including the real private mappings in its digest. Adding
151
+ unrelated identities or reformatting the shared file preserves those receipts;
152
+ changing a used mapping invalidates them.
153
+
154
+ 05 writes `egbe-docs/research/market/work/funnel_teardown/lifecycle-handoff.json`, schema 1:
155
+ subscriptions and events. Each imported subscription names domain, alias,
156
+ funnel_id, campaign_refs, path_refs, entry_url, kind (`lead_form`, `quiz` or
157
+ `webinar_registration`), subscribed_on, confirmed, submission_ref and approval_ref.
158
+ `email_expectations` records confirmation and result as true, false or null,
159
+ with `source_ref: browser:<screen_id>` for a determined expectation. False means
160
+ the browser observation explicitly established that no such mail is expected;
161
+ null preserves uncertainty. Do not infer false from an empty inbox.
162
+ An observed delivery promise may supply `email_expectations.wait_until` as an
163
+ aware timestamp with the same browser source. Private `submission_checks`
164
+ preserve each submission's time, path and original campaign refs.
165
+ Only registrations already submitted with the exact data approved by the human
166
+ approver are imported. They account for that competitor without requiring another 02 sign-up.
167
+ Several funnels from one competitor remain separate subscriptions. Their later
168
+ messages retain funnel/campaign/path attribution; lifecycle recurrence counts
169
+ unique competitors, never aliases.
170
+
171
+ Read the mailbox on the day of the walk, before the normal capture window:
172
+
173
+ ```bash
174
+ python3 scripts/run-lifecycle-capture.py --workspace . --funnel-mail
175
+ python3 scripts/run-lifecycle-capture.py --workspace . --funnel-mail --refresh
176
+ ```
177
+
178
+ This mode works even when ordinary 02 subscriptions are still missing. It lists
179
+ only reserved funnel aliases and writes runtime
180
+ `egbe-docs/research/market/work/lifecycle_capture/funnel-events.json` (schema 1, events,
181
+ checks, pending, coverage, checked_at). It neither publishes 02 nor marks capture complete.
182
+ `--refresh` takes a new inbox snapshot within the same day; already read bodies
183
+ stay cached. Use it after an expected confirmation/result has not arrived yet.
184
+ Each check attributes funnel_id, path_refs, campaign_refs and alias, with
185
+ checked_at, inbox_since, query_succeeded and an inbox_snapshot source_ref.
186
+ The timestamp retains the actual query time and local timezone, including when
187
+ replaying a cached snapshot. A new approved submission needs a check after that
188
+ submission; refresh an earlier snapshot. The check history is retained across
189
+ refreshes and days. Equivalent campaign refs added to an already checked
190
+ physical funnel do not require a second submission or cancel its original
191
+ attributed check. Old caches without a query timestamp
192
+ remain pending until refreshed. No expected mail after an explicit false/false
193
+ browser observation still needs an attributable successful same-day check.
194
+
195
+ Events carry event_id, type (`email_confirmation` or `email_result`), funnel_id,
196
+ path_id (null when multiple paths share the alias), campaign_refs, alias,
197
+ occurred_at, source_ref, message_ref and verification_status. A result has a short
198
+ runtime subject/excerpt; the body stays in the cached message. Automatic result
199
+ classification is a candidate observation: verify the message content before
200
+ claiming a final result. Receiving a confirmation sets `received`, never
201
+ `confirmed`. The browser agent uses the locally retained original confirmation
202
+ link only within the approved continuation, then records its observed outcome
203
+ in the handoff events. If that local original is unavailable after a clone, use
204
+ authorized mailbox access; do not recreate a signup to recover credentials.
205
+
206
+ While the submission day is open, its first same-day check remains required.
207
+ A missed day closes as terminal `same_day_check_missed`; unknown expectations
208
+ close as `email_expectation_undetermined` after an attributable successful
209
+ query, retaining their unknown values. Promised mail continues pending
210
+ (`email_not_received` or `confirmation_required`) until an observed delivery
211
+ deadline, otherwise the existing 14-day capture boundary. A fresh successful
212
+ query at or after that boundary can close missing mail as
213
+ `expected_email_not_received` or `confirmation_unverified`. These gaps preserve the unseen browser result and unverified confirmation. Failed or
214
+ undated queries cannot establish absence. Never repeat a lead submission to
215
+ repair coverage. Email receipt time stays separate from campaign
216
+ cutoff and walk time. The imported aliases use the existing capture/unsubscribe
217
+ procedure when the capture ends. Public evidence keeps attribution and scrubbed
218
+ facts; exact aliases, receipt refs, message IDs and recipient links stay runtime.