@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,300 @@
1
+ # Competitor Set
2
+
3
+ Read `../contracts/research-artifacts.md`. This section uses NO OS Research
4
+ job: the bundled deterministic runner discovers candidates from measured
5
+ sources, you enrich and tier them in four bounded files, and the runner
6
+ validates the files, checks who buys ads, composes the list and renders the
7
+ section plus a machine-readable evidence file. Do not write or edit section
8
+ prose, tables, or the evidence file by hand. The caller supplies the comparison scope and criteria. Choose this operation
9
+ when the assignment needs a sourced, bounded comparison sample.
10
+
11
+ Source the offer identity carefully: a product page can live on the domain of a
12
+ different product. Provider domain-wide traffic must not be attributed to a
13
+ seller or a small feature merely because they share a host.
14
+
15
+ ## 1. Inputs
16
+
17
+ Use explicit CLI inputs or optional typed
18
+ `egbe-docs/research/market/intake.json` (`--intake` selects another path). The agent
19
+ can write or edit that JSON directly from the relevant evidence; there is no
20
+ required intake interview, separate offer file or prose-heading parser. Include
21
+ only fields useful to the assignment:
22
+
23
+ - the offer card: job (the pain it solves), buyer, offer class (what kind of
24
+ purchase it is) and the classes that count as comparable, duration, price
25
+ (`price_usd`, the cost to the result), the comparable price floor
26
+ (`price_floor_usd`, only when supplied; descriptive, not an eligibility gate) and 1-3
27
+ category phrases a buyer would search. Three is this adapter's paid-query
28
+ ceiling, not an evidence-sufficiency rule;
29
+ - `operator_named`: competitors the caller named (explicit scope: always
30
+ profiled, always kept in the final list, the only seeds of alternatives
31
+ queries);
32
+ - `page_mentioned`: competitors the product page mentions (comparison tables,
33
+ "vs" sections). They are ordinary candidates: no bonus, no default tier,
34
+ never a query seed;
35
+ - `product_domain` (excluded from the candidates, never a search seed),
36
+ `markets` (country codes, primary first), and explicit `languages` or
37
+ `market_languages` when needed by later selected operations;
38
+ - `ltv_usd`, with explicit `ltv_provenance` (`given`, `estimated` or `unknown`)
39
+ and `ltv_basis` when relevant. An absent source is unknown, not an estimate.
40
+
41
+ For example, a selected comparison can use:
42
+
43
+ ```json
44
+ {
45
+ "schema_version": 1,
46
+ "offer": {
47
+ "job": "Run remote workshops", "buyer": "Facilitators",
48
+ "offer_class": "Whiteboard software", "category_phrases": ["online whiteboard"],
49
+ "confirmed_by_operator": true, "basis": "Founder confirmed the current offer in this task."
50
+ },
51
+ "operator_named": [], "operator_named_asked": true,
52
+ "page_mentioned": ["comparison.example"],
53
+ "markets": ["US", "GB"], "languages": ["en"],
54
+ "market_languages": {"US": ["en", "es"]}
55
+ }
56
+ ```
57
+
58
+ An empty named list with `operator_named_asked: true` means explicitly none;
59
+ omitted/false means unknown. Mark an offer `confirmed_by_operator` only from
60
+ actual confirmation, or `inferred: true` for an explicit inference, retaining
61
+ the supporting `basis`. Without a basis neither status is established. Do not
62
+ infer these labels from prose or invent an offer/amount to fill optional fields.
63
+ The validator checks supplied types and conflicts before any provider call.
64
+
65
+ Flags override the intake for manual runs: `--domains` (competitors named by the founder),
66
+ `--page-domains`, `--seed-keywords` (category phrases), `--price-floor-usd`,
67
+ `--product-domain`, `--country`. Domains from a completed Keyword Economics
68
+ section join as ordinary candidates. Without category phrases and without
69
+ competitors named by the founder the runner stops rather than inventing a market.
70
+ Pass `--context-file` only for relevant provider-safe background beyond these
71
+ inputs. The operation freezes effective inputs in `work/competitor_set/inputs.json`
72
+ before collection and records their hash. Resume uses the same input; changing
73
+ the question or collection inputs requires separately scoped work under another
74
+ research ID, not an automatic paid rerun. The local `--max-competitors` output
75
+ limit may change without recollecting. A clone retains the frozen inputs even
76
+ when an original external source path is unavailable.
77
+
78
+ ## 2. Round 1: discovery from the offer
79
+
80
+ From the workspace root, resolve `<skill-root>` to the extracted directory
81
+ containing this skill's `SKILL.md`, then run:
82
+
83
+ ```bash
84
+ python3 <skill-root>/scripts/run-competitor-set.py --workspace .
85
+ ```
86
+
87
+ The runner needs `OS_API_KEY` (and optional `OS_URL`). It runs, each with its
88
+ own budget:
89
+
90
+ - Google results, paid and organic (DataForSEO `serp`), for every category
91
+ phrase and its "best" list: who pays for and ranks on the offer's own
92
+ search, and the listicle pages that compare such offers;
93
+ - SpyFu's keyword ad history for every category phrase: the domains that
94
+ bought Google ads on it within the last 12 months (older advertisers do not
95
+ count);
96
+ - Brave web search for the same queries as a second engine;
97
+ - "<brand> alternatives" for up to three competitors named by the founder.
98
+
99
+ There is no keyword-overlap or PPC lookup in this round: relationships come
100
+ from confirmed competitors in round 2. Review and listing directories are
101
+ recorded, never promoted; listicle pages are recorded for reading.
102
+
103
+ The run exits with code 2 and writes
104
+ `egbe-docs/research/market/work/competitor_set/candidates.json`: the pool with its
105
+ sources and signal strength, `profile_required.round1`, `listicles_to_read`
106
+ and `missing` (what the runner still needs). Each candidate carries up to
107
+ three `pages` where it ranked or advertised: start profiling there, because
108
+ a reseller's or a host's page shows what the domain really sells.
109
+
110
+ A seller's own subdomain on a course or creator host (thinkific.com,
111
+ teachable.com, kajabi.com, substack.com and the like) is a candidate of its
112
+ own, named by that subdomain, never the host. When the seller also has its
113
+ own site, profile that domain with `found_in` and fold the subdomain into it
114
+ with `same_as`. Such a subdomain is never a round-2 seed, and the ad check
115
+ does not read the host's Google spend as the seller's.
116
+
117
+ - The profiling list holds every named and page-mentioned competitor, then
118
+ every domain worth profiling, up to 25: the ones that pay on Google for the
119
+ offer's own search (paid results or SpyFu ad history) first, then the
120
+ strongest of the rest. Worth profiling means it ranks or pays on Google for
121
+ a category query, or shows up in two independent places
122
+ (two queries, two engines, an advertised phrase plus a listicle, two
123
+ listicle pages). A single second-engine result, a single advertised phrase
124
+ or a single listicle mention is a weak hit. Signals are counted per query
125
+ and engine, never per result row, so a site with many pages gets no extra
126
+ weight. A domain you decide `excluded` costs no profile and frees its place
127
+ for the next one, so rerun after excluding the obvious non-competitors.
128
+ - The reading list holds up to 12 listicle pages, "best" lists first, at most
129
+ two pages per site, never a site's own search results.
130
+
131
+ Candidates outside the profiling list are recorded with the reason they were
132
+ not profiled.
133
+
134
+ ## 3. Enrich: listicles, profiles, decisions, review
135
+
136
+ Write four files next to `candidates.json`. Keep the work bounded: the pages
137
+ listed, up to three pages per profiled site (home, offer, pricing), the
138
+ profiling list, at most 5 domains of your own (a domain round 2 also
139
+ records is a discovery, even with `found_in`). Profile in parallel batches
140
+ when your environment can run sub-agents, and decide obvious non-competitors
141
+ (publishers, job boards, Q&A sites, cloud vendors without paid training)
142
+ `excluded` without a profile: that frees their place on the list. These file formats are needed only by this chosen collection adapter, not by every research assignment. Review is optional.
143
+
144
+ **`listicles.json`.** Read every page in `listicles_to_read` (and only those)
145
+ and record each program it lists:
146
+
147
+ ```json
148
+ {"schema_version": 1, "read_on": "2026-10-06", "pages": [
149
+ {"url": "<address from listicles_to_read>", "status": "read", "entries": [
150
+ {"name": "Program or product", "domain": "seller.com", "offer": "...", "format": "...", "price_text": "...", "duration": "...", "audience": "..."}]},
151
+ {"url": "<address>", "status": "unreadable", "reason": "HTTP 404"}]}
152
+ ```
153
+
154
+ A listed domain no source recorded joins the pool with provenance
155
+ `agent_research` and the page as `found_in`; a domain on two or more pages
156
+ joins the profiling list on the next run.
157
+
158
+ **`profiles.json`.** Profile every domain on the profiling list, and any
159
+ other domain you want to propose, on its own site: what it sells for this
160
+ job, in which format, at which price, to whom, and whether it still sells:
161
+
162
+ ```json
163
+ {"schema_version": 1, "profiled_on": "2026-10-06", "profiles": [
164
+ {"domain": "seller.com", "name": "Seller", "operating": true,
165
+ "offer": "Closest offer to ours", "offer_url": "https://seller.com/program",
166
+ "offer_class": "live online cohort", "offer_match": "same",
167
+ "price_text": "$2,200 one-time", "price_usd": 2200, "duration": "8 weeks",
168
+ "buyer": "...", "same_buyer": true, "job": "...", "same_job": true,
169
+ "marketplace": false, "focused": true, "main_business": "...", "markets": "US, EU",
170
+ "evidence_urls": ["https://seller.com/program", "https://seller.com/pricing"],
171
+ "found_in": null}]}
172
+ ```
173
+
174
+ - `offer_match`: `same` (our offer class), `comparable` (one of the classes
175
+ the offer card lists as comparable), `different`, or `none` (nothing for
176
+ this job).
177
+ - `price_usd` is the cost to the result: a one-time price, or a subscription
178
+ times the time it takes to finish; `null` when the price is not public.
179
+ - `evidence_urls` are the pages you read (at least one).
180
+ - `focused: false` when the offer is a side line of a big multi-product
181
+ domain (a university, a large platform, a company that sells mostly
182
+ something else); such a domain is never a round-2 seed, and its ad check
183
+ counts only ads on the offer's own phrases. Leave it out or `true` when
184
+ the domain is mainly about offers like this one.
185
+ - `found_in` is required for a domain no source recorded: the page where you
186
+ found it (a listicle, a marketplace listing, a search result). These
187
+ additions carry provenance `agent_research`, never `operator_named`. Never
188
+ pass them with `--domains`.
189
+ - Marketplaces: a marketplace whose catalog for this job is offers of our
190
+ class for our buyer, and which buys traffic for them, is one competitor
191
+ (its domain), profiled like any other. A seller on it with its own site and
192
+ its own advertising is a separate candidate. That the product itself is
193
+ also sold there is never a reason to exclude it. A marketplace of a
194
+ different class (cheap self-paced video, for example) is profiled by its
195
+ typical offer.
196
+
197
+ **`decisions.json`** (schema version 2). One decision per profiled or listed
198
+ domain:
199
+
200
+ ```json
201
+ {"schema_version": 2, "decided_on": "2026-10-06", "decisions": [
202
+ {"domain": "seller.com", "name": "Seller", "competitor_tier": "direct", "reason": "Same buyer, same job, same format and price band."},
203
+ {"domain": "library.example", "competitor_tier": "indirect", "reason": "Self-paced subscription for the same buyer."}]}
204
+ ```
205
+
206
+ Use `direct`, `indirect`, `substitute` or `excluded` for the caller's
207
+ comparison roles and explain the role using sourced profile facts. No fixed
208
+ buyer/job/price formula overrides that judgment. Substitutes may be relevant
209
+ when the question asks about alternatives; low price is an observation, not an
210
+ automatic exclusion. Explicit exclusions need a reason; named domains still
211
+ need a profile so the exclusion is inspectable.
212
+
213
+ A second domain of the same offer (a redirect, an academy domain, a
214
+ university brand on a program a partner runs and sells elsewhere) is folded
215
+ into the canonical one with `"same_as": "canonical.com"` on an `excluded`
216
+ decision: its discovery facts, ads on the offer's phrases included, count for
217
+ the canonical domain, and one program never takes two places in the list.
218
+
219
+ **Optional `review.json`.** Record an additional review if it is useful for the
220
+ assignment. It does not gate the operation or require a separate agent. Retain
221
+ the checked domains, objections and resolutions when provided:
222
+
223
+ ```json
224
+ {"schema_version": 1, "rounds": [
225
+ {"reviewer": "separate agent", "reviewed_on": "2026-10-06",
226
+ "discovery_round": 1, "checked": ["seller.com", "library.example"],
227
+ "objections": [{"domain": "library.example", "objection": "...", "resolution": "accepted", "note": "..."}],
228
+ "missing": [{"domain": "rival.com", "why": "...", "resolution": "added", "note": "..."}]}]}
229
+ ```
230
+
231
+ Resolve every objection (`accepted` or `rejected`; a rejection needs a note)
232
+ and every missing rival (`added` means profiled and decided; `rejected` needs
233
+ a note), then rerun the same command.
234
+
235
+ ## 4. Round 2: relationships of the confirmed direct competitors
236
+
237
+ When round 1 is complete, the runner takes up to three confirmed direct
238
+ competitors whose domain is focused on such offers (those named by the founder first,
239
+ then those that advertise on the offer's phrases), tops them up with comparable indirect ones when there are
240
+ fewer, and runs the DataForSEO keyword-overlap report and SpyFu's PPC
241
+ competitors for each. A stable-domain sample of new related domains forms
242
+ `profile_required.round2` (up to 10); single hits are eligible. Record sourced
243
+ profiles and decisions for the chosen sample, or explicit exclusions for
244
+ out-of-scope hits. There is no third automatic collection round and no mandatory
245
+ review gate.
246
+
247
+ ## 5. Ad check, composition and publication
248
+
249
+ With everything decided, the runner checks every domain that can enter the
250
+ list (up to 25): the round-1 ad facts (Google ads on the offer's phrases,
251
+ paid results on its queries), SpyFu's modeled Google spend over six months in
252
+ the primary market and, when it shows none, up to two more target markets,
253
+ ad pixels on the home page (a free fetch) and, when nothing on Google shows,
254
+ the official Meta Ad Library for EU delivery. Each competitor gets
255
+ `ads_seen`, `pixels_only`, `unknown` (the lookups failed) or
256
+ `none_detected`. For an offer that is a side line of a multi-product domain
257
+ (`focused: false`) only the ads on the offer's own phrases count, and
258
+ without them the verdict is `unknown`: the domain's overall spend, pixels and
259
+ Meta ads promote the rest of its business. Channel Footprint measures the
260
+ channels in depth later; these observations do not choose the sample or a business priority.
261
+
262
+ The output preserves explicitly named scope, then takes a stable-domain sample
263
+ of caller-classified non-excluded candidates. Direct, indirect and substitute
264
+ roles remain visible. Ad activity, modeled spend and price do not determine
265
+ which business opportunity is best. The `rank` field records this
266
+ inspection order.
267
+
268
+ Up to `--max-competitors` (default 10); a shorter list stays short. The
269
+ runner then:
270
+
271
+ - writes evidence rows to `egbe-docs/research/market/evidence/competitors.json`:
272
+ every competitor with its provenance (`operator_named`, `product_page`,
273
+ `discovered`, `keyword_economics` or `agent_research` with the page),
274
+ offer, format, price against the floor, ad activity with its facts and why
275
+ it is in the list; every other candidate with the reason it is not;
276
+ - materializes the exact section under `## Competitor set` in
277
+ `egbe-docs/research/market/full-report.md`;
278
+ - verifies the report and evidence together; Git remains caller-owned;
279
+ - records the completed state receipt under
280
+ `egbe-docs/research/market/work/competitor_set/`, with the hashes of the intake and the
281
+ provided enrichment files.
282
+
283
+ Rerunning with the same files replays the cache and changes nothing.
284
+
285
+ ## 6. Known limits and failure handling
286
+
287
+ Discovery covers the primary market; the ad check looks at up to two more
288
+ target markets. SpyFu covers Google search only, and the Meta check sees EU
289
+ delivery only: an advertiser that runs Meta outside the EU and no Google ads
290
+ shows as `pixels_only` at best. A provider failure on the core Google results
291
+ stops the attempt with the query that failed and the budget already spent;
292
+ rerunning continues from the cache. A query the provider rejects is cached
293
+ as unavailable and never retried unchanged; it is reported in
294
+ `rejected_calls`, apart from the answered calls in `provider_calls`. SpyFu,
295
+ Brave and the Meta check are best effort: an unavailable provider is
296
+ recorded and the run continues, but exhausting any per-attempt budget stops
297
+ the attempt so the next one resumes. When no discovery query answered at
298
+ all, the attempt stops `failed`: an unsearched market never becomes a
299
+ completed section. A `decisions.json` with schema version 1 is rejected: it
300
+ predates these rules, so profile and decide again.
@@ -0,0 +1,228 @@
1
+ # Creative Patterns
2
+
3
+ Internal competitor research section: what competitors advertise,
4
+ where, in which form, and which comparable selling messages they keep using.
5
+ Longevity, active delivery, variants and library reach show observed use; they do
6
+ not establish conversion performance. Use it when the bounded assignment needs
7
+ creative evidence; the user need not name its internal catalog ID.
8
+
9
+ ## Inputs and collection
10
+
11
+ Use the completed Competitor Set and Channel Footprint, retaining competitor tiers,
12
+ observed channels, source ad IDs, relevance decisions, markets and evidence-policy
13
+ hashes. Relevance uses the optional typed offer and explicitly selected
14
+ provider-safe `--context-file` text frozen by the shared input helper, not an
15
+ automatic scan of project files. Accepted languages come from explicit flags or
16
+ typed `intake.json` fields `languages` and `market_languages`; no headings or
17
+ country names imply a language. `--languages` overrides the typed global list
18
+ and suppresses typed per-market overrides unless `--market-languages` is also
19
+ supplied. Otherwise explicit per-market flags override the typed mapping.
20
+ Native dates and activity keep their source scope; the runner does not classify
21
+ creative success from age or recent sightings.
22
+
23
+ ```bash
24
+ python3 scripts/run-creative-patterns.py \
25
+ --workspace . \
26
+ --product-domain product.com
27
+ ```
28
+
29
+ The runner needs `OS_API_KEY` and optionally `OS_URL`. Read its `--help` for
30
+ attempt limits, section limits, accepted-language and video-cap options. Reuse
31
+ compatible Channel Footprint observations first, then enrich them through the
32
+ source that supports each assigned channel.
33
+ Maintain explicit channel × competitor × market coverage, including channels
34
+ without a collector. `no_data`, unavailable media, unsupported source, unknown
35
+ format, sample limits and `budget_deferred` remain distinct outcomes. A tracking
36
+ tag or traffic estimate alone does not become an observed creative.
37
+
38
+ `--max-channels N` limits the deep work to the express scope: in each market,
39
+ a stable-name sample of N observed comparable channels per market. This is
40
+ an execution bound, not a recommendation. Other cells get a
41
+ `not_deepened` coverage row; the evidence records `deepened_cells`. 0 (the
42
+ default) deepens every cell.
43
+
44
+ Keep strict advertiser identity. Destination plus advertiser identity can verify
45
+ the competitor; third-party advertisers pointing to its site remain excluded and
46
+ reported. A legal-entity match needs the source's supported identity evidence.
47
+ Do not treat affiliate creatives as the competitor's direct advertising.
48
+
49
+ Each native ad ID is an independent creative. Repeated observations of that ID
50
+ retain provenance and market scope, while different IDs with identical copy or
51
+ different images remain separate. Dynamic/carousel assets retain their actual
52
+ cards, texts and media associations; never synthesize a cartesian set of variants.
53
+ Similar-copy and media relationships describe variations without merging ads or
54
+ borrowing the oldest variant's serving history.
55
+
56
+ Download available images and video immediately after collection. Signed URLs
57
+ may expire; content hashes and local cached files preserve evidence for retries.
58
+ Do not silently convert a media download failure into a successful visual analysis.
59
+
60
+ ## Video and classification
61
+
62
+ YouTube creatives resolve the native video ID from the Transparency creative
63
+ page when possible, then use YouTube metadata and available captions. Meta video
64
+ files can supply preview frames and extracted audio. Detailed analysis defaults
65
+ to five unique videos per competitor in each channel × market, with a configurable
66
+ cap. The cap limits detailed video analysis, not the number of collected ads.
67
+
68
+ Use captions first and OS `/v1/media/transcribe` for uncaptained speech when that
69
+ capability is configured. Supply extracted audio bytes and their hash; do not
70
+ send an arbitrary remote URL to the transcription endpoint. Send frames and
71
+ available transcript to `/v1/media/analyze`. Record the opening hook, visible
72
+ text, visible speaker treatment, visual approach and their frame/transcript
73
+ references. Missing captions, speech capability, video files or frames remain
74
+ explicit gaps. Official EU Meta rows with no assets can support their observed
75
+ text and scoped reach, not a visual format inferred from another market's ad.
76
+
77
+ Restore native text, legible OCR and available speech before judging relevance.
78
+ Relevance compares buyer, job and offer with the researched product; a shared
79
+ brand or keyword is insufficient. Unknown means unresolved, not irrelevant.
80
+ Retain previously grounded Footprint decisions; a grounded new disagreement
81
+ keeps both decisions and the supporting excerpt. Foreign-language exclusions
82
+ follow the intake policy for that ad's market.
83
+
84
+ Classify every relevant ad in the collected sample within the section budget;
85
+ there is no twelve-ad competitor/platform cap. The bounded collection interleaves observed groups before deepening one
86
+ large group; this is coverage sampling, not a recommendation ranking. Unknown relevance can be resolved through classification but does
87
+ not enter relevant tops or convergence until resolved. Unknown format remains
88
+ unknown. A missing URL does not establish a landing type or conversion path.
89
+
90
+ `POST /v1/media/classify-creative` retains `creative-taxonomy.v1` and adds optional
91
+ `semantic_context` under `creative-semantics.v1`. The generic taxonomy stays
92
+ category-independent. `scripts/creative-semantics.py` builds and validates the
93
+ full context and accepted languages. Compatible cutoffs reuse a frozen base
94
+ context; validated cached and earlier-batch meanings anchor subsequent requests.
95
+ The per-ad cache binds that base, market-language policy and full source/media
96
+ hashes; each batch receipt additionally binds its actual request-anchor hash. The classifier returns full available verbatim
97
+ `observed_text` with extraction provenance and category semantics:
98
+
99
+ - relevance and language with supporting ad excerpts;
100
+ - category angles on buyer/context, job, mechanism, outcome, proof, price/terms
101
+ and action, with concrete meanings drawn from the offer and competitor text;
102
+ - a canonical message-family meaning with buyer, job, offer/mechanism, outcome
103
+ and conversion details, plus a verbatim example.
104
+
105
+ Reuse known canonical meanings across batches only when they match. The helper
106
+ freezes angle/family IDs and dictionary hashes from validated observations,
107
+ retains their supporting ad IDs, and reports unclassified IDs as incomplete
108
+ dictionary discovery. Families group selling meaning, not exact headline text.
109
+ Generic labels such as “desired outcome” do not constitute a semantic family.
110
+ Different offers, guarantees, audiences or conversion paths remain distinguishable.
111
+ Stack names, cohorts and course duration are possible category data, not universal
112
+ requirements. SaaS and consumer-product categories use the same contract.
113
+
114
+ ## Evidence, patterns and report
115
+
116
+ Retain native duration, source scope and date basis. Capture/listing history
117
+ is not serving duration; missing activity is not stopped activity. Compute
118
+ patterns within market, channel, creative type and format. Counts describe
119
+ distinct observed competitors, not successful campaigns; preserve direct/indirect
120
+ roles, relevance, language and source-member lineage. Active/stopped/unknown
121
+ statuses describe provider observations and do not predict performance.
122
+
123
+ The report has two views:
124
+
125
+ 1. Market → channel → creative type → competitor, up to three examples in each
126
+ cell. Show complete available ad text, image or video preview, confirmed age
127
+ and its basis, running status, library link, market scope and media gaps.
128
+ Types are text, static image and video; carousel/dynamic format stays noted
129
+ within static image when supported by source evidence. Unknown format/type
130
+ stays visible. Same-text ads with different images can occupy separate slots.
131
+ 2. Patterns by channel, type and format within each market, including description,
132
+ semantic families, angles, observed recurrence, dated competitors and concrete ads.
133
+ A top channel with no extractable creatives states the reason explicitly.
134
+
135
+ The published inspection sample uses stable creative IDs within each cell;
136
+ it does not select winners from age, variants or source availability. Compare
137
+ reach only within compatible market/source scope when the assignment calls for it.
138
+
139
+ Show all observed prices, financing, discounts, guarantees and outcome/salary
140
+ promises per competitor, using whole sentences and source links. Preserve the
141
+ original image alongside OCR text where applicable. Label competitor promises
142
+ as information, not verified claims that a proposed campaign may repeat.
143
+ UI limits may paginate or expand details but must not discard promises silently.
144
+
145
+ Keep observed landing URLs. Funnel Teardown may later add a validated conversion
146
+ path (webinar, quiz, call, checkout, etc.); this section does not launch section 05.
147
+ The evidence index and downstream consumers retain creative/classification pairs, market scope,
148
+ dictionary meanings and exact `source_ad_ref` lineage. Verify actual Meta and
149
+ YouTube references through the consumers, not only platform-name presence.
150
+
151
+ ## Cache, budgets and completion
152
+
153
+ The first attempt fixes the cutoff in `as-of.json`. Retries replay that cutoff's
154
+ raw provider responses and shared content cache; `--refresh` starts a new cutoff
155
+ after completion. Snapshots retain native identity and observation provenance.
156
+ Compatible source responses can survive changes to semantic policy, while
157
+ derived labels depend on full offer context, accepted languages, taxonomy,
158
+ semantic context/dictionary, policy and media hashes.
159
+
160
+ Detailed video analysis defaults to five unique videos per competitor/channel/
161
+ market. The cumulative ceiling defaults to 240 paid starts; classification and
162
+ media-call attempt limits default to 40 and 100. These are resource counts, not
163
+ a monetary estimate; actual provider tariffs determine cost. The rich semantic
164
+ classifier batches up to four ads and separates long text/speech into smaller
165
+ requests. Public input text bounds remain explicit coverage gaps when exceeded;
166
+ complete native text stays in the corpus and report.
167
+
168
+ Separate per-attempt limits from a persisted cumulative section ceiling. On a
169
+ ceiling, save the partial result, consumed resources and remaining tasks as
170
+ `budget_deferred`; a rerun cannot reset cumulative spend. Downloaded assets,
171
+ classification answers and unique video analyses are cached by their content.
172
+ Account refusals, exhausted upstream budgets and unavailable required endpoints
173
+ stop dependent paid calls; invalid batch answers get bounded retries and a
174
+ visible gap. Cached replays incur no new charge.
175
+
176
+ Legacy merged evidence cannot recover vanished visual variants. Rebuild from
177
+ compatible raw provider caches where available; otherwise mark legacy coverage
178
+ explicitly and collect missing raw evidence within budget. Do not relabel the
179
+ single merged row as a recovered set of independent ads.
180
+
181
+ On completion, the runner writes evidence to
182
+ `egbe-docs/research/market/evidence/creative-patterns.json`, materializes
183
+ `## Creative patterns` in `egbe-docs/research/market/full-report.md`, and records the receipt
184
+ under `egbe-docs/research/market/work/creative_patterns/`. Materialization verifies
185
+ local files; the caller owns their normal Git workflow. Hash-verified
186
+ previews are copied to `egbe-docs/research/market/assets/creative-patterns/` and
187
+ published with the Markdown; report refs resolve inside the project repository.
188
+ Partial
189
+ evidence remains distinguishable from complete coverage of the collected sample.
190
+
191
+ Preview publication covers two sets of creative rows:
192
+
193
+ 1. The canonical top selection below, which the report shows.
194
+ 2. Every citable original creative row, selected or not: it is
195
+ relevant, its language is allowed (`language_status: allowed` and
196
+ `language_allowed: true`), and it
197
+ belongs to a researched market × channel cell (its country is one of the
198
+ evidence `target_countries` and its channel is known).
199
+ `creative-selection.py` `citable()` owns this rule, so a cited original
200
+ never stays under the private runtime cache.
201
+
202
+ Each row publishes its image or video-preview assets, or else its first key
203
+ frame. The copy uses the same checks for both sets: the source must be inside
204
+ the workspace, 5 MiB or less, and match its recorded hash, and its bytes must
205
+ be JPEG, PNG or WebP. The file is named by its SHA-256. The evidence asset
206
+ then points at the `egbe-docs/` asset path and keeps the cache path as `source_path`.
207
+ A failed copy marks the asset `publication_status: unavailable` and adds a
208
+ `preview_publication` `media_gap` coverage row with the creative ID; the
209
+ section is then partial. Only collected public ad-library media is copied.
210
+ Rows outside both sets, such as irrelevant,
211
+ excluded-language or out-of-market rows, keep their cache paths. Rows are visited in evidence order and files are
212
+ content-addressed, so a replay produces the same evidence bytes.
213
+
214
+
215
+ ## Published inspection sample for Funnel Teardown
216
+
217
+ The canonical selector in `scripts/creative-selection.py` owns the existing
218
+ three-example resource-bounded inspection sample and stable ID order. The report and
219
+ preview publication use that same choice; publication also covers the
220
+ citable rows described above. The runner publishes
221
+ `egbe-docs/research/market/evidence/creative-selection.v1.json` and embeds the same
222
+ manifest in evidence v2 as `selection`. Its cells and flattened
223
+ `selected_creatives` preserve market/channel/type/competitor, rank, landing
224
+ URL and source ad lineage. Source hashes pin the corpus, classifications,
225
+ angle dictionary, policy, input scope and completed competitor/channel files.
226
+ Both the evidence inputs and receipt pin its path and byte hash. Downstream
227
+ Funnel Teardown consumes these concrete selected IDs; it does not reconstruct
228
+ the choice from Markdown or introduce another ranking.
@@ -0,0 +1,27 @@
1
+ # Demand validation
2
+
3
+ Read `../contracts/research-artifacts.md` and `../prompts/demand-validation.md`
4
+ for evidence checks and output mechanics. The current assignment, not the
5
+ bundled topic brief, defines the question and depth.
6
+
7
+ ```bash
8
+ python <skill-root>/scripts/run-demand-validation.py --workspace . \
9
+ --assignment "The bounded question, scope and comparison criteria from the current task"
10
+ ```
11
+
12
+ Use `--assignment-file` for existing task text when convenient; no new format
13
+ is required. The runner keeps provider-safe product context and includes only
14
+ valid completed supporting results/measurements. Missing optional inputs are
15
+ limitations, not reasons to collect unrequested sections. A selected unfinished
16
+ measurement used by this section must finish or be closed before it can be cited.
17
+
18
+ The actual assignment, query, system prompt, job state and result live under
19
+ `egbe-docs/research/<id>/work/demand_validation/`. The result materializes under
20
+ `## Demand validation` in the existing incremental report. Retrying unchanged inputs
21
+ resumes/reuses the job before publication; changed inputs preserve that work
22
+ and require a separate research ID, not a silent new provider call.
23
+
24
+ After success, complete the shared Research Completion Review for
25
+ `demand_validation`. Preserve failed/uncertain state; do not replace a provider response
26
+ with invented output. The caller owns Git publication and may continue the
27
+ surrounding task when this operation finishes.
@@ -0,0 +1,80 @@
1
+ # Fleet Benchmarks
2
+
3
+ Read `../contracts/research-artifacts.md`. This section uses NO OS Research
4
+ job and no free-form web research: the bundled deterministic runner asks one
5
+ OS GTM knowledge endpoint — `POST /gtm/comparables` — for the fleet's own
6
+ past experiments that are genuinely comparable to THIS product, and renders
7
+ the section body plus a machine-readable evidence file itself. On the OS
8
+ side the whole verified/directional pool (PII-redacted at the source) is
9
+ reviewed by a server-side LLM judge (`gtm-comparables-judge` role) that
10
+ matches semantically — differently-worded launches still match, keyword
11
+ overlap alone does not. Do not write or edit section prose, tables, or the
12
+ evidence file by hand.
13
+
14
+ The section deliberately contains ONLY comparable experiments. Aggregate
15
+ cross-niche channel benchmarks (`GET /gtm/benchmarks`) and fleet-CPC-vs-
16
+ auction comparisons were removed from it: pooled all-niche medians say
17
+ nothing about the product under research and invite wrong conclusions. When
18
+ no comparable experiment exists, the section states that explicitly as a
19
+ coverage fact about our own pool — never as evidence against the idea.
20
+
21
+ ## 1. Inputs
22
+
23
+ - `--seed-keywords "phrase one, phrase two"` — up to 5 category or problem
24
+ phrases selected from the assignment and relevant evidence (lowercase, no
25
+ boolean operators or own-product brand names). They are
26
+ the product context the judge matches experiments against.
27
+ - `--geo "US"` — optional launch geography, passed to the judge as context
28
+ (not a hard filter: an otherwise comparable experiment from another geo
29
+ is kept, with the mismatch noted); pass the geography supplied for this question.
30
+
31
+ ## 2. Run the deterministic runner
32
+
33
+ From the workspace root, resolve `<skill-root>` to the extracted directory
34
+ containing this skill's `SKILL.md`, then run:
35
+
36
+ ```bash
37
+ python3 <skill-root>/scripts/run-fleet-prior.py --workspace . \
38
+ --seed-keywords "<category phrase>, <problem phrase>"
39
+ ```
40
+
41
+ The runner needs `OS_API_KEY` (and optional `OS_URL`) in the environment.
42
+ It requests the judged comparable experiments and:
43
+
44
+ - writes fleet_case and coverage rows to
45
+ `egbe-docs/research/market/evidence/fleet-prior.json`;
46
+ - materializes the exact section under `## Fleet benchmarks` in
47
+ `egbe-docs/research/market/full-report.md`;
48
+ - verifies the report and evidence together; Git remains caller-owned;
49
+ - records the completed state receipt under
50
+ `egbe-docs/research/market/work/fleet_prior/`.
51
+
52
+ The judge call runs inside the OS gateway and is billed to the claw's own
53
+ LLM key; the runner itself calls no LLM. Every response is cached in the
54
+ runtime directory, so re-running the same command replays cached data with
55
+ zero new reads.
56
+
57
+ ## 3. Known limits and failure handling
58
+
59
+ The fleet prior is evidence of what WE measured — biased toward the niches
60
+ and budgets the fleet has tried. Small-n results are directional. An empty
61
+ comparable-experiment result is a coverage fact about our own pool, never
62
+ evidence against the idea, and the section says so explicitly. The judge is
63
+ instructed to be conservative (exclude when unsure) and the runner never
64
+ invents fleet records: only record ids that exist in the pool can be
65
+ returned. Large pools are judged in bounded chunks server-side; if the
66
+ review was partial (the judge did not see the whole pool) and returned no
67
+ match, the runner refuses to record a no-match conclusion and stops — rerun
68
+ later. A partial review that did return matches renders them and names the
69
+ gap explicitly.
70
+
71
+ If the runner reports no seed terms, supply `--seed-keywords` from the assignment
72
+ and relevant evidence. If no suitable category or problem phrase is known,
73
+ record the section as could-not-complete with that reason.
74
+ For any other failure (including an unconfigured judge model or an
75
+ unavailable LLM upstream), preserve the runtime state and stop; a later
76
+ attempt resumes from cache. Do not substitute web search, generic OS
77
+ Research, `POST /gtm/search`, or an agent-written result, and do not edit
78
+ `egbe-docs/research/market/full-report.md` or the evidence file manually. Completion is
79
+ validated deterministically from the runtime receipt; this section has no
80
+ LLM-based Research Completion Review step.