@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,520 @@
1
+ # Research Artifact Contract
2
+
3
+ Resolve every path from the current workspace root.
4
+
5
+ The paths below use the default research ID `market`. Before independent work,
6
+ choose a stable slug and set `EGBE_RESEARCH_ID` for every runner and downstream
7
+ consumer; substitute that ID in the documented paths. Resume with the same ID.
8
+ Do not change it between sections or reuse it for a different study. Keep public
9
+ outputs and versioned `work/` state together under `egbe-docs/research/<research-id>/`.
10
+ For substantial research, keep its question, relevant context/evidence, gaps,
11
+ requested result and constraints in `egbe-docs/research/<research-id>/brief.md`.
12
+ A narrow operation can use an existing task record or explicit CLI inputs;
13
+ neither a new document nor fixed Markdown headings are execution prerequisites.
14
+
15
+ `--context-file` selects optional provider-safe additional context. Only this
16
+ explicit content and the operation's declared upstream evidence may enter the
17
+ provider request; unrelated project files and personal details are not inputs.
18
+ The shared IO helper freezes selected text and source hashes in
19
+ `work/<section-id>/input-context.json` before collection. Receipts bind it as
20
+ `research_context: {path, sha256}`. Resume uses the saved snapshot, not a fresh
21
+ search for context. A changed source can limit applicability without corrupting
22
+ the saved result or authorizing a new paid run; retain both evidence and receipts.
23
+ Narrative continuation also verifies and reuses the saved assignment, query,
24
+ system prompt and `input-provenance.json`; its receipt binds the latter with
25
+ `input_provenance_sha256`. Updated installed prompts or upstream evidence do not
26
+ replace an in-flight request. Missing or damaged saved inputs stop continuation
27
+ before provider calls, rather than resetting the request.
28
+
29
+ The table describes supported outputs, not a package required for every task.
30
+ A bounded research operation needs only its own output and recovery evidence.
31
+ Recommendation/preview/synthesis/render artifacts belong only to a requested
32
+ publication. A Product handoff reuses relevant existing findings, sources,
33
+ coverage and unresolved questions; it does not require that publication package.
34
+
35
+ ## Canonical Artifacts
36
+
37
+ | Artifact | Path | Required title |
38
+ | --- | --- | --- |
39
+ | Recommendation selection | `egbe-docs/research/market/pre-prd-recommendations.md` | YAML contract with `explanation_format: plain_text`, followed by one short plain-text explanation |
40
+ | Incremental full report | `egbe-docs/research/market/full-report.md` | `# Market Research Report` |
41
+ | Founder preview | `egbe-docs/research/market/preview.md` | `# Market Research: Findings and Recommendations` |
42
+ | Preview synthesis | `egbe-docs/research/market/preview-synthesis.json` | Strict schema version 1 JSON |
43
+ | Founder summary | `egbe-docs/research/market/summary.md` | Deterministic compact Markdown projection |
44
+ | Preview render receipt | `egbe-docs/research/market/preview-render.json` | Strict schema version 1 JSON |
45
+ | Keyword economics evidence | `egbe-docs/research/market/evidence/keyword-economics.json` | Schema version 2 aggregate; typed rows carry `locale_key` and `locale` |
46
+ | Competitor set evidence | `egbe-docs/research/market/evidence/competitors.json` | Strict schema version 1 JSON |
47
+ | Channel footprint evidence | `egbe-docs/research/market/evidence/channel-footprint.json` | Strict schema version 1 JSON |
48
+ | Creative patterns evidence | `egbe-docs/research/market/evidence/creative-patterns.json` | Strict schema version 1 JSON |
49
+ | Funnel teardown evidence | `egbe-docs/research/market/evidence/funnel-teardown.json` | Strict schema version 1 JSON |
50
+ | Lifecycle capture evidence | `egbe-docs/research/market/evidence/lifecycle-capture.json` | Strict schema version 1 JSON |
51
+ | Competitor ads evidence | `egbe-docs/research/market/evidence/competitor-ads.json` | Strict schema version 1 JSON |
52
+ | Competitor reviews evidence | `egbe-docs/research/market/evidence/review-mining.json` | Strict schema version 1 JSON |
53
+ | Communities analysis evidence | `egbe-docs/research/market/evidence/community-demand.json` | Strict schema version 1 JSON |
54
+ | Fleet benchmarks evidence | `egbe-docs/research/market/evidence/fleet-prior.json` | Strict schema version 1 JSON |
55
+ | Geography comparison analysis | `egbe-docs/research/market/evidence/geography-comparison.json` | Agent-authored schema version 1 comparison; not provider measurements |
56
+
57
+ The recommendation, synthesis, summary, render receipt, and evidence files are
58
+ machine-facing support artifacts. The full report and preview are durable
59
+ founder documents.
60
+
61
+ Section evidence files under `egbe-docs/research/market/evidence/` carry the
62
+ machine-readable rows behind a deterministic section: typed entries (keyword
63
+ metrics, SERP observations, competitor domains, budget simulations) each with
64
+ provenance and an evidence-tier marker. They are written only by the owning
65
+ section runner, verified together with the
66
+ report section they back, and consumed by downstream hypothesis tooling.
67
+ Narrative workflows must not edit them.
68
+
69
+ Geography Comparison is a separate analysis artifact, not one of those measured
70
+ datasets. `scripts/geography-comparison.py` prepares validated prior inputs and
71
+ publishes its structured comparison and exact report section together. Its
72
+ `request.json` binds context, source inputs and published files. It has no OS
73
+ Research job ID or Completion Review. Structural completion can include an
74
+ explicit `not_compared` scope decision or an uncertain comparison; consumers
75
+ must preserve that distinction, not call either a validated market winner.
76
+
77
+ The Preview workflow also reads the execution state at
78
+ `egbe-docs/research/market/work/preview-context.json`. It is the authoritative selected and
79
+ research outcomes projected by the runtime. It is versioned and must
80
+ not be rewritten by the workflow. Its ordered section IDs
81
+ and canonical labels are the immutable execution-plan snapshot; a newer skill
82
+ catalog must not expand work that is already running.
83
+ For standalone work, `scripts/build-preview-context.py` is the producer: it
84
+ freezes explicit selection and derives completion from receipts. See
85
+ `../workflows/local-research.md`; do not hand-author completed statuses.
86
+ Section entries contain `id`, `label`, `status`, optional verified `coverage`,
87
+ and `closed_by_caller: true` only for an explicit `--failed` decision.
88
+ `partial` and `no_data` are distinct outcomes, not manual closures. Their Preview
89
+ meaning and evidence use are defined in `../workflows/preview.md`.
90
+
91
+ ## Section Isolation
92
+
93
+ Use the exact H2 from `references/catalog.v1.json`. A section workflow owns only
94
+ that H2 and its body. It must not create, rewrite, or remove another section.
95
+
96
+ Run `scripts/upsert-markdown-section.py` from this skill bundle to create or
97
+ replace the owned section. The helper preserves all other report content and
98
+ keeps repeated execution idempotent. Supply non-empty content and never edit
99
+ the report with an unconstrained whole-file rewrite.
100
+
101
+ From the workspace root, invoke it as:
102
+
103
+ ```bash
104
+ python <skill-root>/scripts/upsert-markdown-section.py \
105
+ --report egbe-docs/research/market/full-report.md \
106
+ --heading "<exact catalog heading>" \
107
+ --content "<non-empty section content>"
108
+ ```
109
+
110
+ Resolve `<skill-root>` to the extracted directory containing this skill's
111
+ `SKILL.md`. For multiline future content, pass `--content-file` instead of
112
+ `--content`.
113
+
114
+ Market Size And Dynamics, Target Audience, Competitive Landscape, Value
115
+ Proposition, Pricing And Monetization, Acquisition Channels, Demand Validation,
116
+ and Unit Economics write cited research through their section runners. Organic
117
+ Trend Watch delegates provider work and analysis to the dedicated
118
+ `egbe-os-organic-trend-watch` skill while retaining this bundle's report ownership.
119
+ Keyword Economics writes its section and evidence file exclusively through
120
+ `scripts/run-keyword-economics.py`: the runner calls metered OS DataForSEO
121
+ tools, renders deterministic tables, caches every upstream response under
122
+ `egbe-docs/research/market/work/keyword_economics/`, and persists the report and evidence
123
+ in one verified publication. Its completion proof is the runtime state receipt
124
+ (`request.json` with result and evidence SHA-256 hashes); it has no LLM-based
125
+ Research Completion Review.
126
+ Competitor Set (catalog ID `competitor_set`, internal) follows the same
127
+ deterministic contract through `scripts/run-competitor-set.py`: inputs from
128
+ optional typed `egbe-docs/research/market/intake.json` or explicit CLI inputs
129
+ (the supplied offer and distinct founder-named/page-mentioned competitors),
130
+ candidate discovery from the offer via OS tools
131
+ (DataForSEO Google results, SpyFu keyword ad history) and OS search, then the
132
+ keyword overlap and SpyFu PPC competitors of the confirmed direct
133
+ competitors, an ad check (SpyFu domain stats, home-page ad pixels, the
134
+ official Meta Ad Library), the executing agent's listicle reading, profiles,
135
+ classification decisions and optional review recorded in
136
+ `egbe-docs/research/market/work/competitor_set/` (`listicles.json`, `profiles.json`,
137
+ `decisions.json`, `review.json`), cache and receipts in the same directory,
138
+ evidence at `egbe-docs/research/market/evidence/competitors.json`, one verified publication,
139
+ and no Research Completion Review. Until the files cover every domain the
140
+ runner asks for the receipt stays `pending`, never `completed`.
141
+ Channel Footprint (catalog ID `channel_footprint`, internal) follows the
142
+ same deterministic contract through `scripts/run-channel-footprint.py`:
143
+ tracking tags fetched from competitor pages and tag-manager containers,
144
+ ad-library presence via OS scrape actors and the official Meta Ad Library
145
+ endpoint, SpyFu's modeled Google Ads spend via OS tools, the public
146
+ traffic-source split, web search partner signals and Wayback Machine page
147
+ history, cache and receipts under
148
+ `egbe-docs/research/market/work/channel_footprint/`, evidence at
149
+ `egbe-docs/research/market/evidence/channel-footprint.json`, one verified publication, and
150
+ no Research Completion Review. Its v2 evidence preserves competitor tiers,
151
+ normalized advertisements, per-country observations, native delivery date
152
+ scope, sampling limits, coverage and effective shared policy with its hash.
153
+ The agent supplies hashed relevance decisions for the collected candidates;
154
+ missing decisions leave the attempt pending. Finalization validates these
155
+ decisions before materializing the report and evidence. Explicit unknown
156
+ relevance remains a limitation, never program-level proof. Pixel-only or
157
+ undated channels remain candidates independently of campaign proof.
158
+ It takes its competitor domains and tier provenance from the Competitor Set
159
+ and Keyword Economics evidence files like the Ads runner.
160
+ Creative Patterns (catalog ID `creative_patterns`, internal) follows
161
+ the same deterministic contract through `scripts/run-creative-patterns.py`:
162
+ a creative corpus from OS scrape actors, the official Meta Ad Library
163
+ endpoint and SpyFu ad history, classification through OS
164
+ `/v1/media/classify-creative` against `references/config/creative-taxonomy.v1.json`,
165
+ cache, the fixed cutoff (`as-of.json`) and receipts under
166
+ `egbe-docs/research/market/work/creative_patterns/`, evidence at
167
+ `egbe-docs/research/market/evidence/creative-patterns.json`, one verified publication, and
168
+ no Research Completion Review. When completed Channel Footprint v2 is
169
+ available, reuse its relevant ad corpus and per-country observations,
170
+ validate its receipt and shared policy, and retain member-level lineage in
171
+ creative and pattern evidence. A stale/pending v2 input is not silently
172
+ replaced by global scraping. Legacy standalone collection remains unscoped
173
+ and cannot acquire country-specific eligibility without the channel gate.
174
+ It takes its competitor domains from the Competitor Set and Keyword
175
+ Economics evidence files like the Ads runner.
176
+ Competitor Ads follows the same deterministic contract through
177
+ `scripts/run-competitor-ads.py`: ad-transparency data via OS scrape actors
178
+ plus the official Meta Ad Library endpoint, cache and receipts under
179
+ `egbe-docs/research/market/work/competitor_ads/`, evidence at
180
+ `egbe-docs/research/market/evidence/competitor-ads.json`, one verified publication, and no
181
+ Research Completion Review. It consumes the Competitor Set evidence file
182
+ (caller-classified competitors, in stable inspection order) and the Keyword Economics evidence file
183
+ (discovered competitor domains) as optional inputs, never the accumulated full
184
+ report.
185
+ Competitor Reviews follows the same contract through
186
+ `scripts/run-review-mining.py`: G2 and Trustpilot review pulls via OS scrape
187
+ actors, cache and receipts under `egbe-docs/research/market/work/review_mining/`,
188
+ evidence at `egbe-docs/research/market/evidence/review-mining.json`, one verified
189
+ publication, no Research Completion Review, and the same receipt-validated
190
+ Competitor Set and Keyword Economics domain inputs.
191
+ Communities Analysis (catalog ID `community_demand`) follows the same contract through
192
+ `scripts/run-community-demand.py`: Hacker News via the keyless Algolia
193
+ API, fresh Reddit via an OS scrape actor, and best-effort YouTube comments
194
+ via OS tools, cache and receipts under
195
+ `egbe-docs/research/market/work/community_demand/`, evidence at
196
+ `egbe-docs/research/market/evidence/community-demand.json`, one verified publication, no
197
+ Research Completion Review. Its queries come from `--seed-keywords` (seed-
198
+ derived category AND problem phrases, per its workflow) merged with the
199
+ receipt-validated Keyword Economics keyword rows when that section has
200
+ completed; `--product-context` mechanism tokens flag which quotes speak to
201
+ this product's mechanics rather than the bare category.
202
+
203
+ Funnel Teardown (catalog ID `funnel_teardown`, internal) publishes through
204
+ `scripts/run-funnel-teardown.py`. Its v2 inputs are the completed 03 country/channel
205
+ proof, completed 04 creative corpus and the shared
206
+ `egbe-docs/research/market/evidence/creative-selection.v1.json` manifest. The runner prepares
207
+ all distinct selected campaign destinations and finalizes local browser observations;
208
+ it does not replace missing ad destinations with competitor homepages. Verified ad
209
+ CTA/history enrichment has its own lineage and pinned runtime record. Country and
210
+ channel belong to the campaign; a geolocation or language redirect is an observed
211
+ mismatch, not new market proof.
212
+
213
+ The executing agent records phone-viewport screenshots and main/auxiliary branches
214
+ in `egbe-docs/research/market/work/funnel_teardown/walks.json`, following
215
+ `references/contracts/funnel-teardown.md` and the shared `walk-mechanics.v2.json`.
216
+ `research-context.json` records the explicit buyer persona and own-product URLs.
217
+ `approval-plan.json`, `approvals.json` and `submissions.json` bind exact forms/data to
218
+ human chat authorization and submission intent/outcome. New fields require a
219
+ supplement; an unknown submission outcome must be checked before retrying.
220
+ The shared private `egbe-docs/research/market/work/identity-registry.json` allocates stable aliases;
221
+ `lifecycle-handoff.json` transfers approved submissions to 02, whose funnel-mail mode
222
+ captures same-day confirmations/results without claiming lifecycle completion.
223
+ Public evidence redacts private contacts and email verification links.
224
+
225
+ The evidence at `egbe-docs/research/market/evidence/funnel-teardown.json` contains linked
226
+ campaign, landing, path, pattern and coverage rows plus screenshot references/hashes.
227
+ Its receipt pins upstream receipts/evidence, selection, policy, persona, enrichment,
228
+ walks, approval/submission journals, email events and assets. Pending approval/email,
229
+ budget checkpoints and uncertain submissions remain `pending`. Permitted account,
230
+ CAPTCHA, SMS, payment and live-call boundaries can be published with explicit unknown
231
+ downstream. Own-product paths never submit and never enter competitor proof/counts.
232
+ Legacy v1 walks remain diagnostic context and require fresh collection for proof.
233
+ Advertising duration, native activity and observed recurrence are separate
234
+ measurements; none establishes conversion, profitability or permission to copy.
235
+
236
+ Lifecycle Capture (catalog ID `lifecycle_capture`, internal) follows
237
+ the same deterministic contract through `scripts/run-lifecycle-capture.py`:
238
+ research subscriptions at the competitors with plus-addressed aliases of
239
+ the claw mailbox, selected from early reviewed public entry discovery and
240
+ completed by the assigned human with verified access to the planned aliases and
241
+ mailbox, recorded by the executing agent in
242
+ `egbe-docs/research/market/work/lifecycle_capture/subscriptions.json`, the inbox read
243
+ through the OS mail routes by alias and start date, cache and receipts under
244
+ `egbe-docs/research/market/work/lifecycle_capture/`,
245
+ evidence at `egbe-docs/research/market/evidence/lifecycle-capture.json`, one verified
246
+ publication, and no Research Completion Review. It takes its competitor domains
247
+ from the Competitor Set and Keyword Economics evidence files like the Ads
248
+ runner. Until every competitor is subscribed or skipped with a reason the
249
+ start receipt stays `pending`; already recorded subscriptions may be harvested
250
+ explicitly while others await the assigned human. Day-3 partial and day-14 full
251
+ windows retain publication status `completed`, with separate observation and
252
+ coverage metadata. Later harvests replace current evidence and preserve
253
+ immutable private snapshots. The
254
+ sign-up policy of its workflow and exact human-approved Funnel Teardown
255
+ forms are the permitted research submissions on competitor sites.
256
+ Read [the Lifecycle Capture contract](lifecycle-capture.md) for discovery,
257
+ stable mailbox-wide allocation and human signup milestones. The caller supplies
258
+ scheduling and bounded reminders; scheduler ids stay outside domain artifacts.
259
+ Ordinary message bodies and campaign material remain in the versioned cache,
260
+ not in public reports. Before its first cache write, the runner separates
261
+ access-bearing links and credentials into
262
+ `egbe-docs/research/market/.local/lifecycle_capture/mail-cache/` and stores a
263
+ sanitized response in `work/`. Analysis and resume use that portable response;
264
+ authorized confirmation actions may use the local original. Live credentials
265
+ are not transferable through Git, and public-report scrubbing is not a
266
+ substitute for this cache boundary.
267
+
268
+ Keyword Economics is optional for these three runners, and Competitor Set is
269
+ optional for the Ads and Reviews runners: absent, failed, incomplete or
270
+ invalid evidence is omitted, with a warning and the reason in their
271
+ `keyword-inputs.json` or `competitor-set-inputs.json`. Explicit
272
+ domains/queries still work. Without any usable inputs, the runner stops
273
+ rather than treating missing evidence as zero demand.
274
+
275
+ Fleet Benchmarks follows the same contract through
276
+ `scripts/run-fleet-prior.py`: past fleet experiments genuinely comparable
277
+ to this product via the OS GTM knowledge endpoint `POST /gtm/comparables`
278
+ (the whole verified/directional pool reviewed semantically by the OS-side
279
+ `gtm-comparables-judge` LLM — the judge runs in the gateway, never in the
280
+ runner), cache and receipts under `egbe-docs/research/market/work/fleet_prior/`,
281
+ evidence at `egbe-docs/research/market/evidence/fleet-prior.json`, one verified
282
+ publication, no Research Completion Review. Cross-niche aggregate channel
283
+ benchmarks and fleet-CPC-vs-auction comparisons are intentionally excluded
284
+ from this section; an empty comparable result is recorded as a coverage
285
+ fact about our own pool, never invented around, and a partial (bounded)
286
+ review that returned no match is refused rather than recorded as no-match.
287
+
288
+ Value Proposition, Pricing And Monetization, Acquisition Channels, and Demand
289
+ Validation, and Unit Economics may read only the completed supporting results
290
+ declared by their bundled runners. The shared deterministic loader validates
291
+ each section-keyed runtime receipt and file hashes, preserves the declared
292
+ order, omits missing or invalid results, and never reads this accumulated full
293
+ report as provider input.
294
+
295
+ The same receipt reader supplies bounded structured measurements to AI queries.
296
+ Keyword, ad, review and community observations retain locale, source hashes,
297
+ retrieval dates, contrary signals and omitted-row counts. Failed/skipped inputs
298
+ are explicit limitations. Without
299
+ a supplied selection, missing data is unknown, not evidence of absent demand.
300
+ `input-provenance.json` records these inputs. Changed measurements affect current
301
+ applicability; an explicitly authorized new study incorporates them into its new
302
+ query. Continuation retains the original query and inputs. No changed file launches
303
+ a paid rerun by itself. Fleet internals are not sent to external research.
304
+ The caller owns scheduling from its immutable execution order; the
305
+ bundle reports pending measurements without changing that order. Local selection
306
+ defers dependent work until selected measurements finish or are closed explicitly.
307
+
308
+ Organic Trend Watch uses
309
+ `egbe-docs/research/market/work/organic_trend_watch/context.json`, built only by
310
+ `scripts/build-organic-trend-context.py` for this PMR adapter. Its schema-version-1
311
+ manifest requires a scoped `assignment`, contains only explicitly selected
312
+ provider-safe context and may contain full validated
313
+ results for Target Audience, Competitive Landscape, Value Proposition, and
314
+ Acquisition Channels in that fixed order. Missing, skipped, failed, stale, or
315
+ tampered supporting results are omitted. The manifest records the relative
316
+ source path and SHA-256 for selected inputs and every included result; it never reads
317
+ the accumulated full report. The dedicated skill owns the manifest consumer,
318
+ provider runtime, analysis, `result.md`, and receipt contracts.
319
+
320
+ Before report materialization,
321
+ `scripts/finalize-organic-trend-watch.py` invokes the validator shipped in the
322
+ same downloaded `egbe-os-organic-trend-watch` bundle. Product Market Research does not
323
+ duplicate or reinterpret that receipt schema. Only after successful validation
324
+ does the finalizer upsert the exact runtime `result.md` under the canonical
325
+ Organic Trend Watch H2 and invoke the shared report persistence helper.
326
+
327
+ After report materialization and persistence succeed, the finalizer atomically
328
+ writes the PMR-owned
329
+ `egbe-docs/research/market/work/organic_trend_watch/integration-receipt.json`. This stable
330
+ boundary binds the opaque dedicated-skill receipt, exact `result.md`, exact
331
+ materialized report section, collection epoch and timestamps, coverage/status,
332
+ and local publication. It does not require or invent a Git commit SHA.
333
+ `partial` and `no_data` remain limited evidence, not completed coverage.
334
+ Downstream completion consumers validate this integration receipt
335
+ and the published section only; they must not duplicate provider,
336
+ normalization, media, or analysis rules owned by `egbe-os-organic-trend-watch`. A failed
337
+ validation, materialization, or persistence must not publish the integration
338
+ receipt.
339
+
340
+ ## Preview Link
341
+
342
+ The preview links to `full-report.md` beside it by default; no instance ID or
343
+ Dashboard route is needed. Use `--local-report-link` only to override it with a
344
+ safe relative link or an explicit HTTP(S) report URL. The render receipt records
345
+ local materialization and file hashes, not remote publication or Git proof.
346
+
347
+ ## Preview Assembly
348
+
349
+ Run `scripts/write-preview.py` to render the Preview and founder summary from
350
+ the validated synthesis and runtime context. The workflow owns semantic
351
+ synthesis; the writer owns Markdown structure, research coverage, the full
352
+ report link, length limits, and render hashes. When no successful section has
353
+ created the full report, the writer initializes only its canonical H1 so the
354
+ founder still receives an honest failure Preview. Never author the Preview or
355
+ chat summary independently.
356
+
357
+ ## Persistence Boundary
358
+
359
+ Each completed section materializes and verifies its report and evidence in the
360
+ selected research folder. Runners do not commit or push: use the product's normal
361
+ Git workflow for both outputs and `work/`: scope, decisions, raw provider results,
362
+ paid job IDs, receipts and review state must survive handoff. Keep credentials
363
+ and process locks out of Git; report exports still exclude internal/private data.
364
+ No Git repository is required to collect research. Receipts record
365
+ `publication_mode: local` with no invented commit SHA.
366
+ AI publication proof remains in the section's `publication.json`; its accepted
367
+ completion review is still required. Preserve caches and receipts on retry.
368
+
369
+ The Competitor Set, Channel Footprint and Creative Patterns runners store each
370
+ provider cache entry gzip-compressed as `<digest>.json.gz` and read an older
371
+ plain `<digest>.json` as well, so earlier workspaces replay from their cache
372
+ with no new provider call. `python3 scripts/research-artifact-io.py --compact
373
+ "$WS"` compresses an existing workspace's entries of those sections and
374
+ hard-links byte-identical images named by their SHA-256 (cache images and
375
+ `egbe-docs/research/market/assets/`); nothing is re-fetched. Public evidence stays
376
+ plain JSON for every reader.
377
+
378
+ The Competitor Set, Channel Footprint, Creative Patterns, Funnel Teardown, Lifecycle Capture, Ads, Reviews, Communities and Fleet runners mark a new attempt `pending`
379
+ before input validation or collection, and `failed` on error. They retain cached
380
+ responses and collected files for retry, but only successful publication restores
381
+ `completed`; a previous result does not prove that the new attempt succeeded.
382
+
383
+ Recommendation and Preview writers follow the same publication boundary.
384
+ Preserve unrelated local changes. Do not create or modify
385
+ `egbe-docs/product/prd.md` from this skill.
386
+
387
+ Provider queries, job metadata, and completed temporary results under
388
+ `egbe-docs/research/market/work/` are portable execution state, not founder documents
389
+ or public exports. Each OS Research section runner owns its
390
+ section-keyed runtime state and reuses a completed matching result before
391
+ attempting report materialization again.
392
+
393
+ ## Research Completion Review
394
+
395
+ After a OS Research runner succeeds, review the cached
396
+ `egbe-docs/research/market/work/<section-id>/result.md` before finishing the workflow. Review
397
+ only whether the research answer is physically cut off. Ignore the
398
+ final `### Sources` appendix added by the runner.
399
+
400
+ Record exactly one classification with
401
+ `scripts/review-research-completion.py`:
402
+
403
+ - `complete`: the answer ends at a normal semantic boundary;
404
+ - `uncertain`: the ending is abrupt or imperfect, but there is no direct proof
405
+ of a physical cutoff;
406
+ - `definitely_truncated`: the answer ends mid-word or mid-sentence; leaves an
407
+ open Markdown link, fence, table, or equivalent construct; ends with a
408
+ heading, list marker, or colon without its content; or starts an explicitly
409
+ bounded list and is cut off inside the current item.
410
+
411
+ Do not classify a response as definitely truncated merely because it is short,
412
+ misses a requested section, has weak evidence or sources, violates the desired
413
+ format, or ends abruptly after a grammatically complete statement. Those are
414
+ content or compliance problems, not proof of transport truncation. Use
415
+ `uncertain` when the physical cutoff cannot be proven; uncertainty never starts
416
+ another research submission.
417
+
418
+ For an accepted ending, run one of:
419
+
420
+ ```bash
421
+ python <skill-root>/scripts/review-research-completion.py \
422
+ --workspace . \
423
+ --section-id <section-id> \
424
+ --classification complete
425
+ ```
426
+
427
+ ```bash
428
+ python <skill-root>/scripts/review-research-completion.py \
429
+ --workspace . \
430
+ --section-id <section-id> \
431
+ --classification uncertain
432
+ ```
433
+
434
+ For definite truncation, supply a literal 12–500 character excerpt from the
435
+ last 2,000 characters of the provider answer, before the generated Sources
436
+ appendix. Write that excerpt as UTF-8 to
437
+ `egbe-docs/research/market/work/<section-id>/truncation-evidence.txt` with the normal file
438
+ editing tool; do not interpolate provider text into a shell argument. Then run:
439
+
440
+ ```bash
441
+ python <skill-root>/scripts/review-research-completion.py \
442
+ --workspace . \
443
+ --section-id <section-id> \
444
+ --classification definitely_truncated \
445
+ --evidence-file egbe-docs/research/market/work/<section-id>/truncation-evidence.txt
446
+ ```
447
+
448
+ On the first definite truncation, the helper archives the rejected job and
449
+ result, invalidates its completed cache, and authorizes one fresh request. Run
450
+ the same section runner once more, then review and record the replacement
451
+ ending. If the replacement is also definitely truncated, invoke the review
452
+ helper with its exact tail excerpt; it records retry exhaustion and fails. Do
453
+ not start a third request.
454
+
455
+ The review receipt is runtime state bound to the exact query, system prompt,
456
+ request, and result hashes. A missing or stale receipt, or a current
457
+ `definitely_truncated` decision, does not qualify as completed supporting
458
+ research. The helper enforces state integrity and retry count; it does not make
459
+ the classification for the agent.
460
+
461
+
462
+ ## Public media for research consumers
463
+
464
+ Research consumers use current receipt-validated evidence and available public
465
+ media. Section 04 Creative Patterns owns creative extraction and its native
466
+ `publish_previews` output: public files under
467
+ `egbe-docs/research/market/assets/creative-patterns/` and evidence `media_assets` with
468
+ their hashes; a published preview is a hard link to its cached bytes when
469
+ both sit on one filesystem. These native files do not require a `public_exports` wrapper.
470
+ Publication covers the canonical top selection and every creative row a
471
+ consumer may cite: relevant, language-allowed, with its country
472
+ in the evidence `target_countries` and a known channel. When such a preview
473
+ cannot be copied, its asset is marked `publication_status: unavailable` and a
474
+ `preview_publication` `media_gap` coverage row names the creative ID.
475
+ Section 05 Funnel Teardown owns campaign-linked walks, screen content,
476
+ screenshots and their provenance; consume its published native evidence
477
+ and declared media when available. Richer sanitized JSON may optionally be
478
+ declared by an evidence document as `public_exports`:
479
+
480
+ ```json
481
+ {
482
+ "public_exports": [
483
+ {"path": "egbe-docs/research/market/creative-media/export.json", "sha256": "<file SHA-256>", "kind": "creative_media"}
484
+ ]
485
+ }
486
+ ```
487
+
488
+ This is an optional consumer boundary, not an assertion that every producer
489
+ already emits this field and not a new collection algorithm. The owning
490
+ section prepares sanitized JSON and local assets. Consumers use available
491
+ native evidence/media and declared exports; missing extraction stays a visible
492
+ gap. Work needed to supply missing creative or funnel material belongs to
493
+ sections 04/05, not to a report presentation step.
494
+ Export paths are workspace-relative under `egbe-docs/`,
495
+ resolve within it and cannot point into `cache`, `caches`, `snapshots` or
496
+ private runtime. The exact JSON SHA-256 is bound through the evidence and
497
+ its completed receipt. Declare updated hashes when content changes.
498
+
499
+ An export object may contain `rows` (preserving each row's type), `creatives`
500
+ (default type `creative`), `funnels`/`walks` (`funnel_walk`), `sequences`
501
+ (`lifecycle_sequence`) and `gaps` (`extraction_gap`). Keep complete fields,
502
+ including stable IDs, full text, reasons/priority from the founder, channel,
503
+ competitor/domain, format/funnel type, target market or EU-proxy scope,
504
+ observation/verification status and source URLs (`link`, `landing_url`,
505
+ `address`). A funnel has an ordered `screens` array of full screen records,
506
+ with copy, screenshots and walk/source links. Local public media is declared
507
+ in `media` or `assets` as `{role, path, sha256}`. Convenient `image_path`,
508
+ `asset_path`, `preview_path`, `screenshot_path`, `keyframe_path` fields and
509
+ matching `*_sha256` may identify the corresponding media. Use public
510
+ workspace-relative paths with exact hashes; source URLs do not replace local
511
+ media dependencies.
512
+
513
+ Record extraction gaps explicitly with `domain`, `channel`, `status` and
514
+ `reason`/`detail`, or per-record `extraction_status` and `extraction_reason`.
515
+ Missing pictures/screens stay gaps; presentation must not invent replacements.
516
+ Keep lifecycle exports to sanitized public sequence observations and dates.
517
+ Never export mailbox addresses, aliases, raw email bodies, private signup
518
+ plans, credentials or snapshots. No runtime directory is copied wholesale
519
+ into a shared report or ZIP. Existing section collection and publication
520
+ ownership remains unchanged.
@@ -0,0 +1,18 @@
1
+ {
2
+ "schema_version": 2,
3
+ "contract": "funnel-walk.v2",
4
+ "viewport": {"width": 390, "height": 844},
5
+ "min_observed_screens": 1,
6
+ "max_screens_per_attempt": 40,
7
+ "screen_kinds": ["landing", "question", "interstitial", "proof", "loader", "plan choice", "contact request", "teaser", "result", "offer", "booking", "account gate", "payment gate", "verification", "confirmation"],
8
+ "advance_types": ["automatic", "button", "link", "none"],
9
+ "stop_reasons": ["needs_approval", "needs_account", "needs_email", "phone", "sms", "captcha", "payment", "live_sales_call", "technical", "budget", "form_not_submitted", "own_no_submit", "completed"],
10
+ "research_statuses": ["queued", "in_progress", "needs_approval", "needs_account", "needs_email", "blocked", "completed", "boundary"],
11
+ "branch_roles": ["main", "auxiliary"],
12
+ "submission_kinds": ["lead_form", "quiz", "webinar_registration"],
13
+ "email_event_types": ["email_confirmation", "email_result"],
14
+ "approval": "human confirmation of the exact known forms and data; supplements for new forms, fields or data",
15
+ "forbidden": ["agent-created competitor account", "payment", "card entry", "live sales call booking", "CAPTCHA bypass", "random real phone number"],
16
+ "identity": "stable plus alias per funnel from a local research identity registry; no contact data in public evidence",
17
+ "observation": "real screenshot per observed screen; partial length and unseen outcomes remain unknown"
18
+ }