@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,235 @@
1
+ # Funnel walk contract v2
2
+
3
+ `funnel-walk.v2` is the shared mechanics version. The closed values live in
4
+ [`walk-mechanics.v2.json`](walk-mechanics.v2.json); egbe-os-quiz-funnel ships an identical
5
+ copy and retains its standalone selection task. This contract describes the
6
+ 05 JSON artifacts. Legacy v1 observations stay legacy; missing screenshots and
7
+ post-contact screens cannot be reconstructed by schema migration.
8
+
9
+ ## Identities and scope
10
+
11
+ A campaign is one competitor + channel + country + verified semantic ad
12
+ destination. It is a research grouping, not an ad-account campaign ID. Prepare
13
+ inherits the exact ordered `creative_selection.v1` list published by 04, without
14
+ its own landing ranking or cap. `campaign_id`, `funnel_id`, `path_id` and
15
+ `walk_id` are separate identities; extra persona paths do not add competitors
16
+ or campaign votes. Own destinations have `role: own`, no campaign refs and no
17
+ submissions. Unknown ad destinations remain per-channel coverage gaps.
18
+
19
+ Original ad URLs, opened URLs, redirects and semantic query/fragment values
20
+ are retained. HTTP and HTTPS schemes remain distinct; when the initial browser
21
+ URL differs, `redirect_chain` records continuous `{from,to,source_ref}` browser
22
+ observations from the ad entry to that opened URL. Even UTM may change the offer.
23
+ No tracking removal or shared walk
24
+ across campaigns is assumed without browser evidence of equivalent country,
25
+ content and route. Destination recovery in runtime `destinations.json` requires
26
+ schema 1 records `{creative_id,status,url,relation,source_ref,verified_on}`;
27
+ `relation` is `native_ad_destination`, `observed_ad_cta` or
28
+ `provider_ad_history`. A generic program URL or YouTube-description link is a
29
+ candidate, not verification of a particular ad's destination.
30
+
31
+ Runtime `equivalences.json`, schema 1, may reuse a walk only within the same
32
+ competitor, country and channel. Each `equivalences` record has `equivalence_id`,
33
+ all original `campaign_ids` and `addresses`, `verified_on`, `source_ref`, explicit
34
+ `verification: {country:true,content:true,route:true}` and real hashed
35
+ `screenshots` covering those entries. Campaign IDs, original URLs and counts
36
+ remain distinct; `equivalence_ref` records the verified reuse. Private-data
37
+ captures cannot be exported as equivalence assets.
38
+
39
+ ## walks.json
40
+
41
+ The root has `schema_version: 2`, `contract: funnel-walk.v2`, the current
42
+ `inputs_sha256` from candidates.json, and `walks`. A walk names exactly its
43
+ selected `funnel_id`, the candidate's `campaign_ids`, `path_id` (primary path
44
+ `buyer`), `address`, `role`, `persona_id`, `walked_on`, `viewport: 390x844`,
45
+ `observed_market`, `status`, `stop_reason`, `observed_outcome`, `unknown` and
46
+ `screens`.
47
+ The primary path uses `research-context.json`'s persona ID. Additional personas
48
+ must be declared in `additional_personas` and used only for meaningful branches.
49
+
50
+ `walked_on` is the actual recent browser date, independent of the frozen
51
+ `campaign_as_of`. Record country as unknown if the site does not establish it;
52
+ currency alone does not establish country. `observed_market` includes language,
53
+ currency, country selector and consent/banner choice when visible. A mismatch
54
+ is reported and excluded from target-country patterns.
55
+
56
+ Closed research statuses: `queued`, `in_progress`, `needs_approval`,
57
+ `needs_account`, `needs_email`, `blocked`, `completed`, `boundary`.
58
+ Closed stop reasons are in the mechanics JSON. Only observed permitted outcomes
59
+ are accepted: `lead_submitted`, `webinar_registered`, `quiz_completed`,
60
+ `result_observed`, `public_content_end`, `not_observed`. A boundary is not a
61
+ reached registration. Full length of every partial path stays unknown; the
62
+ runner records the number of observed main steps and the last observed screen.
63
+
64
+ Each logical screen has:
65
+
66
+ - unique `screen_id`, `attempt_id`, page/state `url`, `kind`, `branch_role`
67
+ (`main` or `auxiliary`) and `advance`;
68
+ - actual observed `headline`, `headline_words`, `options`, `words_per_option`,
69
+ `notes`, available options, selected `answer`, `cta`, `offer`, `proof`,
70
+ `lead_fields`, progress/skip controls and relevant other content;
71
+ - `screenshot: {path,sha256}`, an existing raster file within the workspace,
72
+ with its verified SHA-256. Optional `screenshots` add full-page or significant
73
+ lower-page blocks without increasing logical step count;
74
+ - typed `amounts` with `kind: price|discount|financing|salary_claim|other` and
75
+ actual visible `text` and `context`, never a mixed bag of regex numbers;
76
+ - `result_type: teaser|final|not_observed|absent|not_applicable` where relevant.
77
+ A `teaser` screen is an intermediate example, not the final quiz result.
78
+
79
+ Screens use browser observations, not page-source configuration or email
80
+ content. Long pages need captures covering headline, offer, proof, price and
81
+ CTA. Save forms before filling (`captured_before_fill: true` when submitted).
82
+ Review screenshot pixels before publication. If the primary capture has
83
+ `contains_private_data: true`, supply a real `display_screenshot` with `path`,
84
+ `sha256`, the original `source_sha256` and `derivation: privacy_redaction`.
85
+ The raw capture stays private; the public `screenshot` is that display derivative.
86
+ Additional captures with private data must be recaptured safely. Hash validation
87
+ confirms file identity, not pixel privacy. Never fabricate a browser observation.
88
+ One real screen is valid, including an immediate account or technical gate.
89
+ Each attempt records at most 40 screens; an explicit budget stop remains
90
+ pending and can resume under a new attempt ID. Do not invent extra screens.
91
+
92
+ A discount popup or consent state is auxiliary and cannot replace the main
93
+ route implied by the selected creative. A required contact screen continuing
94
+ onwards has `submission_required: true` and
95
+ `action: {type: submit, submission_ref: <intent event id>}`. Account-gated
96
+ continuation requires `operator_access_ref: chat:<human access reference>`;
97
+ the agent never creates an account. Stop before payment/card entry, CAPTCHA,
98
+ required SMS verification and live-sales-call booking. Capture the booking
99
+ tool, questions and visible slots without submitting a booking. A walk that
100
+ sends no forms ends at the first contact screen with status `boundary` and
101
+ stop reason `form_not_submitted`, after capturing that screen and its fields.
102
+ `completed` cannot end at a contact/account/payment/verification gate, loader or
103
+ booking. `quiz_completed` requires a final result or an approved submitted
104
+ completion with browser confirmation; `lead_submitted` and `webinar_registered`
105
+ require both a submitted journal outcome and observed confirmation/result.
106
+ `public_content_end` requires explicit `completion_observed: true` on its last
107
+ main screen. An account continuation requires access provided by an authorized account holder.
108
+
109
+ `branch_points` records a screen, reason, `meaningful_change` and
110
+ `alternate_path_id`. A relevant alternate branch changing offer, result, price
111
+ or conversion must be observed; a missing required path keeps research pending.
112
+ Cosmetic personalization does not require another full path. Reusing a known
113
+ post-form outcome must carry observation refs and must not repeat a lead
114
+ submission automatically.
115
+
116
+ ## Approval and submission journals (private runtime only)
117
+
118
+ Before any sending, prepare the combined known form list in
119
+ `approval-plan.json`, schema 2, `forms`. Each immutable form revision has
120
+ `form_id`, integer `revision`, `funnel_id`, `path_id`, `campaign_ids`, `screen_id`,
121
+ `url`, `purpose: lead_form|quiz|webinar_registration`, stable `alias` and the
122
+ exact `fields` map. The fingerprint covers these exact values via
123
+ `funnel-model.form_fingerprint`. New forms, fields or values require a new
124
+ revision and supplement human approval; no broad approval authorizes them.
125
+
126
+ `approvals.json`, schema 2, contains `approvals` with `approval_id`,
127
+ `confirmed_by: human_operator`, `source_ref: chat:<actual confirmation>`,
128
+ `approved_at` ISO timestamp with timezone and exact `forms` references
129
+ `{form_id,revision,form_sha256}`. The runner never writes human approvals;
130
+ an agent-authored approval file alone is not human confirmation.
131
+
132
+ `submissions.json`, schema 2, is a chronological `events` journal:
133
+
134
+ 1. Before sending: `type: intent`, unique `event_id`, `form_id`, `revision`,
135
+ `approval_id`, `form_sha256`, exact `fields`, `occurred_at`.
136
+ 2. After observing the response: `type: outcome`, unique `event_id`,
137
+ `submission_ref` to the intent, `outcome: submitted|not_submitted|unknown`,
138
+ `source_ref` to the browser observation and `occurred_at`.
139
+ 3. After uncertainty: inspect without sending, then append `type: resolution`
140
+ with the observed outcome and source. An unresolved intent stays pending.
141
+ Retry is permitted only after observed `not_submitted` and an explicit
142
+ `retry_authorization_ref` with a new human approval ID; never automatically
143
+ on resume. Form revisions, approvals and events are append-only against
144
+ `journal-checkpoint.json`; an interrupted attempt cannot be erased.
145
+
146
+ Email equals the stable per-funnel alias; names follow the approved persona.
147
+ An accepted phone uses a full US fiction number ending `555-0100`–`555-0199`.
148
+ A rejected format is `blocked: phone`, never a random real number. This rule
149
+ applies only to 05; Lifecycle Capture's own phone rule is unchanged. Password,
150
+ card and payment fields cannot be planned. Own forms cannot be planned/sent.
151
+
152
+ The shared `egbe-docs/research/market/work/identity-registry.json` is schema 1 with mailbox
153
+ and identities (`identity_id,domain,funnel_id,alias,kind`). Numeric +NN aliases
154
+ are stable, reserved once under the shared `.lock`, and coexist with 02 aliases.
155
+ Each receipt pins `identity_registry_binding`: schema 1, selection of used
156
+ `funnel_ids` and `lifecycle_domains`, and a canonical SHA-256 of those actual
157
+ mappings plus the mailbox. Only the digest and selection are public. Unrelated
158
+ allocations or JSON formatting do not invalidate a receipt; changing a used
159
+ alias, identity ID, domain, funnel mapping or mailbox does.
160
+ `lifecycle-handoff.json` exports private completed registrations and references
161
+ to 02. Same-day email events return through
162
+ `egbe-docs/research/market/work/lifecycle_capture/funnel-events.json`; received confirmation
163
+ is not confirmed, and received result does not invent browser completion.
164
+ Mail/browser/ad times stay separate; a closed mail coverage gap never changes
165
+ the observed browser outcome, partial path or feature measurements.
166
+ One handoff subscription per funnel merges all campaign/path/submission refs
167
+ and keeps its stable alias. A submitted path declares
168
+ `email_expectations: {confirmation: boolean|null,result: boolean|null,source_ref}`;
169
+ known expectations cite an actual `browser:<screen_id>`.
170
+ An observed promise can additionally specify an aware `wait_until` timestamp
171
+ with that browser source. Each private `submission_checks` entry retains
172
+ `submission_ref`, `submitted_at`, `path_id` and the originally submitted
173
+ `campaign_refs`, plus that path's observed `email_expectations` and confirmation
174
+ state; new submissions need their own post-submission check. Expected mail and
175
+ verification events must match that path and occur after its submission.
176
+ When a shared alias gives a mail event `path_id: null`, its timestamp must
177
+ still follow each submission whose expectation it is used to satisfy.
178
+ The returned file includes `checks` with `funnel_id`, `path_refs`,
179
+ `campaign_refs`, `alias`, `checked_at`, `inbox_since`, `query_succeeded` and
180
+ `source_ref`. A successful check must cover that subscription, occur after
181
+ the actual submitted path, occur after that intent and on the same date in the
182
+ recorded check timezone. The check history survives later refreshes. Widening
183
+ equivalent campaign refs for the same physical funnel does not erase a valid
184
+ check with the original campaign attribution.
185
+ While the submission day is open, a missing first check keeps 05 pending.
186
+ Afterward, record terminal `same_day_check_missed`; never resubmit to repair
187
+ that gap. Unknown expectations close as `email_expectation_undetermined` after
188
+ a successful attributable check and remain explicitly unknown. Required mail
189
+ continues pending until the observed `wait_until`, or the existing 14-day
190
+ Lifecycle Capture observation boundary when no delivery time was observed.
191
+ Closing missing mail requires a fresh successful query at or after that
192
+ boundary and records `expected_email_not_received` or
193
+ `confirmation_unverified`, never an observed final result. Explicit false/false
194
+ expectations still need a check and record `reviewed_no_expected_email`.
195
+
196
+ ## Evidence, proof and publication
197
+
198
+ Evidence schema 2 rows: `campaign`, `landing_page`, `funnel_walk`,
199
+ `funnel_pattern`, `coverage`. Campaign and walk refs survive into planner and
200
+ report. Private exact approval/contact fields, aliases and email verification
201
+ URLs remain runtime; screenshot forms before filling and sanitize any additional
202
+ assets before publication. Exact approved names/phones, encoded contact values,
203
+ private mail IDs and tokenized verification URLs are removed from public text.
204
+ Public business-route query parameters retain their meaning.
205
+ Redaction applies to observed prose with whole-value word boundaries; it never
206
+ substring-rewrites IDs, row types, destinations, hashes or asset paths. Ordinary
207
+ `/activate` or `/confirm` business routes remain intact outside mail context.
208
+ If a pinned reference or source filename actually contains a known research
209
+ email/phone, use a safely named capture/public reference before publication;
210
+ validation rejects it rather than silently changing the bound provenance.
211
+
212
+ Campaign `observation_status` describes native activity. `dated_refs` preserve
213
+ native delivery intervals and `running_refs` preserve current scoped observations;
214
+ these are independent facts, not proof of business performance. Comparability
215
+ uses the assigned evidence scope, not an indirect-fallback threshold or copying
216
+ permission. Missing dates or activity stay unknown.
217
+
218
+ Patterns are scoped by country/channel and distinguish funnel types, structural
219
+ features and 04 category-angle → observed-funnel links. Each campaign votes
220
+ once. `known_campaigns_total` excludes undetermined observations;
221
+ `unknown_campaigns` and `selected_campaigns_total` remain visible. Extra paths
222
+ and creatives do not inflate shares or convergence. `observed_convergence`
223
+ counts competitors where the feature was seen; `dated_convergence` counts
224
+ those whose observed campaigns also expose native delivery dates. Own and mismatched-market observations
225
+ are excluded. Teaser is not final result; optional popups do not set main-flow
226
+ automatic advance; partial length does not prove short/full length.
227
+
228
+ Publication pins source files and screenshot hashes in `inputs.source_files`
229
+ and the receipt. `inputs.resume_inputs` hashes stable upstream/context inputs;
230
+ mutable observation/journal files are pinned separately to avoid circular
231
+ hashes. Changes invalidate dependent evidence, without repeating submissions.
232
+ All selected paths need observation to a permitted boundary or an explicit
233
+ per-campaign gap. Queued work, approval, email, budget and unknown submission
234
+ outcomes remain pending; an account boundary can be published as limited
235
+ observation and resumed after access is supplied.
@@ -0,0 +1,71 @@
1
+ # Geography comparison input
2
+
3
+ Agent-authored analysis, not direct provider measurements. The helper validates
4
+ structure and reference integrity, not the truth of claims or the best market.
5
+ Use these exact fields; free-text values below explain their purpose.
6
+
7
+ ```json
8
+ {
9
+ "schema_version": 1,
10
+ "section_id": "geography_comparison",
11
+ "context_sha256": "<SHA-256 returned by --prepare>",
12
+ "decision": "compare",
13
+ "geography_basis": "preference",
14
+ "reason": "Why geography can change the next decision; what the founder actually constrained.",
15
+ "countries": [
16
+ {"code": "GB", "reason": "Why this market belongs in the shortlist."},
17
+ {"code": "DE", "reason": "Why this is a credible alternative for the same buyer/problem."}
18
+ ],
19
+ "criteria": ["Reachable buyers"],
20
+ "sources": [],
21
+ "rows": [
22
+ {"type": "geography_finding", "country": "GB", "criterion": "Reachable buyers", "classification": "unknown", "statement": "The relevant reachable population has not been measured.", "source_ids": [], "limitation": "No comparable count for this buyer definition."},
23
+ {"type": "geography_finding", "country": "DE", "criterion": "Reachable buyers", "classification": "unknown", "statement": "The relevant reachable population has not been measured.", "source_ids": [], "limitation": "No comparable count for this buyer definition."}
24
+ ],
25
+ "recommendation": {
26
+ "primary_country": null,
27
+ "runner_up_country": null,
28
+ "rationale": "Insufficient evidence to rank these markets.",
29
+ "changes_choice_when": "A comparable reachable-buyer estimate materially favors one country.",
30
+ "next_step": "A specific bounded check of that difference, with cost/time assumptions."
31
+ },
32
+ "limitations": ["What was unavailable, not collected, stale or not comparable."]
33
+ }
34
+ ```
35
+
36
+ The example represents missing evidence, not a recommended country pair or a
37
+ sufficient research effort. Choose relevant criteria and countries for the product.
38
+
39
+ - `geography_basis`: `founder_constraint`, `preference`, `open` or
40
+ `evidence_supported`. Explain the basis in `reason`; founder preference is
41
+ not independent market evidence.
42
+ - `decision: compare` needs at least two unique uppercase two-letter country codes and
43
+ one row for each country × chosen criterion. Cells may be unknown; do not
44
+ manufacture equal coverage or fill gaps with unsourced certainty.
45
+ - Each row is `observation`, `estimate`, `hypothesis` or `unknown`. Observations
46
+ need sources. Estimates explain calculations/assumptions in the statement
47
+ and limitation; hypotheses/unknowns are not measured facts.
48
+ - Sources have exactly `id` (`S1`, `S2`, …), `reference`, `accessed_on`
49
+ (`YYYY-MM-DD`), `period` and `limitation`. `reference` is a direct public
50
+ HTTP(S) URL or `research:<section_id>` completed in the prepared context.
51
+ For actual product outcomes or source excerpts saved locally, use
52
+ `artifact:egbe-docs/research/market/evidence/geography-comparison-sources/<name>.md`
53
+ (also `.json`/`.txt`). Record anonymous counts, cohort, dates and origin, never
54
+ customer identities, credentials or raw private records. The helper binds
55
+ these files by hash and publishes them with the comparison. This is optional;
56
+ unavailable product outcomes remain unknown, not invented zeros.
57
+ An unknown original publication date/period must be stated, not replaced by
58
+ today's access date. Reused research does not become independent new evidence.
59
+ - `source_ids` cites declared IDs. Read sources and preserve notes/excerpts;
60
+ never cite an uninspected URL as proof. Refer to available product outcomes
61
+ anonymously; missing outcomes may remain unknown rather than uploading PII.
62
+ - `primary_country` and `runner_up_country` name shortlisted countries or null.
63
+ A runner-up needs a distinct primary. No scores or mandatory winner.
64
+ - `decision: not_compared` is a reasoned scope assessment: retain the relevant
65
+ countries, leave `criteria`/`rows` empty and both recommended countries null.
66
+ Explain the actual constraint or why new comparison has no decision value,
67
+ the supporting evidence if available and when to reopen it. Completion then
68
+ means the scope was assessed, **not** that comparative market research occurred.
69
+
70
+ The canonical JSON and report are projections of this single input. Do not
71
+ hand-edit the report, generated JSON or completion receipt after publication.
@@ -0,0 +1,119 @@
1
+ # Lifecycle Capture contracts
2
+
3
+ Files live in private egbe-docs/research/market/work/lifecycle_capture/ unless explicitly
4
+ published. plan.json is the canonical signup plan. entry-points.json is
5
+ agent-reviewed discovery input; the runner validates it and renders the private
6
+ lifecycle-signups.md from the final plan.
7
+
8
+ ## Reviewed entry points
9
+
10
+ ```json
11
+ {
12
+ "schema_version": 1,
13
+ "competitors": [{
14
+ "domain": "competitor.com",
15
+ "selected": {
16
+ "id": "product-details",
17
+ "comparable_offer": "Software for the same buyer and job",
18
+ "source_url": "https://competitor.com/product",
19
+ "entry_url": "https://forms.example.com/product-details",
20
+ "handoff_evidence": "The source page Request details CTA opens this form.",
21
+ "kind": "lead_form",
22
+ "entry_type": "details",
23
+ "fields": [{"name": "email", "required": true}],
24
+ "needs_phone": false,
25
+ "needs_card": false,
26
+ "reason": "Product-specific sales entry without phone or payment.",
27
+ "instructions": ["Choose the comparable product", "Submit the planned email"],
28
+ "stop_condition": "Stop at required phone, card, payment or CAPTCHA bypass.",
29
+ "evidence": [{"url": "https://competitor.com/product", "observed_on": "2026-10-06", "detail": "Browser inspection of CTA and required fields."}]
30
+ },
31
+ "fallback": null,
32
+ "skip_reason": null
33
+ }]
34
+ }
35
+ ```
36
+
37
+ Selected/fallback have the same shape and distinct ids. selected:null requires
38
+ skip_reason. Each competitor occurs once. source_url belongs to the competitor;
39
+ an external entry_url additionally needs handoff_evidence of the link/embed.
40
+ Evidence has URL, detail and non-future observed_on. Full URLs stay private.
41
+ needs_phone/needs_card are boolean or null (unknown). Fields have name and
42
+ boolean required; instructions include consent choices and the stopping point.
43
+ Phone/card-required entries cannot be subscribed to.
44
+ kind: newsletter, account, trial, waitlist, lead_form.
45
+ entry_type: details, materials, webinar, quiz, waitlist, account, trial, newsletter.
46
+
47
+ ## Plan and subscriptions
48
+
49
+ plan.json contains schema_version:1, section_id, stable UUID capture_id, mailbox,
50
+ product_domain, subscriptions_path, day-3/day-14 targets and competitor entries
51
+ with domain, alias, selected, fallback, skip_reason, discovery_status, entry_points.
52
+ Before review, entry_points are search seeds only. Fresh workspace = new capture;
53
+ refresh preserves its id. OS POST /mail/lifecycle-aliases/reserve receives
54
+ capture_id/domains, resolves the authenticated mailbox, and returns mailbox and
55
+ aliases (domain-to-full-address mapping). Registry atomically reserves random
56
+ 10–99 numbers uniquely per mailbox across products/hosts. Same capture/domain
57
+ is idempotent. HTTP409 means the pool cannot satisfy the batch. No Mailu accounts
58
+ are created. Already active legacy plans retain their existing aliases.
59
+
60
+ ```json
61
+ {
62
+ "schema_version": 1,
63
+ "subscriptions": [{
64
+ "domain": "competitor.com",
65
+ "alias": "claw.name+98@egbe.app",
66
+ "subscribed_on": "2026-10-06",
67
+ "entry_id": "product-details",
68
+ "entry_url": "https://forms.example.com/product-details",
69
+ "kind": "lead_form",
70
+ "confirmed": null,
71
+ "notes": "The assigned human reported successful submission."
72
+ }],
73
+ "skipped": [{"domain": "other.com", "reason": "Relevant forms require a phone."}]
74
+ }
75
+ ```
76
+
77
+ Alias matches the plan exactly. entry_url/kind match one selected/fallback;
78
+ entry_id can disambiguate. Fallback use needs fallback_reason. Unknown phone/card
79
+ needs require requirements_verified:true from the assigned human, whose access
80
+ to the planned aliases and mailbox has been verified. confirmed is
81
+ true/false/null (unknown or not observed). Optional unsubscribed_on falls between
82
+ subscription and today. Duplicate domains/aliases are invalid; a competitor
83
+ cannot be subscribed and skipped. Domains outside this capture are ignored.
84
+
85
+ ## Human signup actions and portable milestones
86
+
87
+ operator-actions.json has schema_version:1, section_id, capture_id, product_domain,
88
+ actions and harvests. Each item has id, domain, kind, status
89
+ (pending/completed/skipped), due_on YYYY-MM-DD. Action kinds: signup, confirm,
90
+ unsubscribe. Harvest kinds: early, full. Stable ids: <domain>:<kind>.
91
+ No scheduler ids belong here.
92
+
93
+ Signup is due one day after reviewed handoff, preserving its deadline on rerun.
94
+ Confirmation action exists only when recorded as required/confirmed. Harvest
95
+ is due subscription date+3/+14. Successful per-domain listings at the due cutoff
96
+ complete milestones, including reported body/page gaps; failed listings leave
97
+ them pending. Unsubscribing before a target skips that later target.
98
+ Unsubscribe actions carry blocked_by:<domain>:full; reminders wait for the full
99
+ harvest. The caller installs bounded reminders and follow-ups. The file alone
100
+ is not proof they were installed.
101
+
102
+ ## Published observations
103
+
104
+ Publication receipt status stays completed, phase started/harvested. Evidence
105
+ inputs/receipts add capture_id, observation_status (pending/partial/full),
106
+ target_days:14, observed_from, observed_through, days_covered, coverage_complete,
107
+ early_harvest_due_on and full_harvest_due_on. Sequences carry their own windows,
108
+ dates, listing_succeeded, listing_truncated and coverage_complete. Patterns carry
109
+ supporting windows/minimum days_covered, observation_status, coverage_complete
110
+ and eligible; recurring requires two distinct competitors. Eligible early
111
+ positive patterns can inform standalone future email sequences inside their
112
+ window; cadence needs at least seven days. They are not sources for the
113
+ replicate planner.
114
+
115
+ Full means the target duration was reached; coverage is separate. Skipped,
116
+ unsubscribed, awaiting signup and failed reads remain visible. Later harvests
117
+ replace current public evidence/report. Private immutable snapshots under
118
+ snapshots/<cutoff>/<evidence-sha256>/ retain evidence.json, result.md and
119
+ request.json for provenance of previously shared research.