@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,652 @@
1
+ #!/usr/bin/env python3
2
+ """Run the deterministic Fleet Benchmarks section against fleet GTM knowledge.
3
+
4
+ The fleet's own launches are the one dataset no competitor has: real spend,
5
+ clicks, sessions, and verdicts from campaigns we ran ourselves. This runner
6
+ projects ONLY the launches relevant to the product under research into the
7
+ report, via one OS endpoint:
8
+
9
+ - `POST /gtm/comparables` — the OS gateway shows the whole agent-visible
10
+ fleet pool (verified/directional records, PII-redacted at the source) to
11
+ a server-side LLM judge (`gtm-comparables-judge` role) that keeps only
12
+ experiments whose audience, problem, or product category genuinely
13
+ matches the product context. Matching is semantic: differently-worded
14
+ records still match, and keyword overlap alone is not enough.
15
+
16
+ Cross-niche aggregates are deliberately absent: pooled all-niche channel
17
+ medians and fleet-CPC-vs-auction comparisons said nothing about THIS product
18
+ and invited wrong conclusions, so this section renders comparable
19
+ experiments or an explicit "none relevant in our pool" statement — nothing
20
+ else.
21
+
22
+ No agent-side LLM: the semantic judgment runs inside the OS gateway and is
23
+ billed to the claw's own LLM key. Every response is cached in the runtime
24
+ directory for byte-stable replays; synthesis into decisions is a downstream
25
+ concern.
26
+ """
27
+
28
+ from __future__ import annotations
29
+
30
+ import sys as _artifact_sys
31
+ from pathlib import Path as _ArtifactPath
32
+ _artifact_sys.path.insert(0, str(_ArtifactPath(__file__).resolve().parent))
33
+ from egbe_artifacts import artifact_path as _artifact_path
34
+
35
+ import runpy as _egbe_runpy
36
+ from pathlib import Path as _EgbePath
37
+ _egbe_adapter = _EgbePath(__file__).with_name("connection_identity.py")
38
+ _connection_headers = _egbe_runpy.run_path(str(_egbe_adapter))["connection_headers"] if _egbe_adapter.is_file() else lambda _url: {}
39
+
40
+ import argparse
41
+ import hashlib
42
+ import importlib.util
43
+ import json
44
+ import os
45
+ import re
46
+ import sys
47
+ import time
48
+ import urllib.error
49
+ import urllib.request
50
+ from dataclasses import dataclass
51
+ from datetime import date
52
+ from pathlib import Path
53
+ from types import ModuleType
54
+ from typing import Any, Callable
55
+
56
+ SCHEMA_VERSION = 1
57
+ SECTION_ID = "fleet_prior"
58
+ SECTION_HEADING = "Fleet benchmarks"
59
+ DISPLAY_NAME = "Fleet Benchmarks"
60
+
61
+ DEFAULT_OS_URL = "https://os.hz.egbe.dev"
62
+ RUNTIME_REL = Path(_artifact_path("egbe-docs/research/market/work")) / SECTION_ID
63
+ EVIDENCE_REL = Path(_artifact_path("egbe-docs/research/market/evidence/fleet-prior.json"))
64
+ REPORT_REL = Path(_artifact_path("egbe-docs/research/market/full-report.md"))
65
+
66
+ MAX_GTM_CALLS_PER_ATTEMPT = 4
67
+ MAX_QUERY_CHARS = 300
68
+ SEARCH_LIMIT = 10
69
+ STORED_CASES_CAP = 10
70
+ LEARNING_TRUNCATE = 400
71
+ RELEVANCE_TRUNCATE = 240
72
+ GTM_RETRY_DELAY_SECONDS = 5.0
73
+
74
+
75
+ class FleetPriorError(RuntimeError):
76
+ """Terminal runner failure; runtime state is preserved for resume."""
77
+
78
+
79
+ def _load_script(filename: str, module_name: str) -> ModuleType:
80
+ path = Path(__file__).resolve().parent / filename
81
+ spec = importlib.util.spec_from_file_location(module_name, path)
82
+ if spec is None or spec.loader is None:
83
+ raise FleetPriorError(f"cannot load bundled script {filename}")
84
+ module = importlib.util.module_from_spec(spec)
85
+ sys.modules[spec.name] = module
86
+ previous = sys.dont_write_bytecode
87
+ sys.dont_write_bytecode = True
88
+ try:
89
+ spec.loader.exec_module(module)
90
+ finally:
91
+ sys.dont_write_bytecode = previous
92
+ return module
93
+
94
+
95
+ # ── OS client: bounded GTM reads with byte-stable replay cache ─────────────
96
+
97
+ @dataclass
98
+ class OsClient:
99
+ os_url: str
100
+ api_key: str
101
+ cache_dir: Path
102
+ max_gtm_calls: int = MAX_GTM_CALLS_PER_ATTEMPT
103
+ gtm_calls: int = 0
104
+ cache_hits: int = 0
105
+ touched: set[str] = None # type: ignore[assignment] # set in __post_init__
106
+ request: Callable[..., dict[str, Any]] | None = None
107
+ sleep: Callable[[float], None] | None = None
108
+
109
+ def __post_init__(self) -> None:
110
+ if self.touched is None:
111
+ self.touched = set()
112
+
113
+ def _http(self, method: str, path: str, payload: dict[str, Any] | None, timeout: float) -> dict[str, Any]:
114
+ url = f"{self.os_url.rstrip('/')}{path}"
115
+ headers = {
116
+ "Authorization": f"Bearer {self.api_key}",
117
+ "Accept": "application/json",
118
+ }
119
+ data = None
120
+ if payload is not None:
121
+ headers["Content-Type"] = "application/json"
122
+ data = json.dumps(payload).encode("utf-8")
123
+ req = urllib.request.Request(url, data=data, headers=headers, method=method)
124
+ try:
125
+ for _name, _value in _connection_headers(req.full_url).items():
126
+ req.add_unredirected_header(_name, _value)
127
+ with urllib.request.urlopen(req, timeout=timeout) as resp:
128
+ envelope = json.loads(resp.read().decode("utf-8"))
129
+ except urllib.error.HTTPError as exc:
130
+ detail = exc.read().decode("utf-8", errors="replace")[:500]
131
+ raise FleetPriorError(f"OS {path} failed: HTTP {exc.code} {detail}") from exc
132
+ except urllib.error.URLError as exc:
133
+ raise FleetPriorError(f"OS {path} unreachable: {exc.reason}") from exc
134
+ data_obj = envelope.get("data")
135
+ if envelope.get("code") not in (None, 200) or not isinstance(data_obj, dict):
136
+ raise FleetPriorError(f"OS {path} returned no data: {str(envelope)[:300]}")
137
+ return data_obj
138
+
139
+ def gtm_call(
140
+ self,
141
+ method: str,
142
+ path: str,
143
+ payload: dict[str, Any] | None,
144
+ should_cache: Callable[[dict[str, Any]], bool] | None = None,
145
+ ) -> tuple[dict[str, Any], str]:
146
+ key_raw = json.dumps(
147
+ {"kind": "gtm", "method": method, "path": path, "payload": payload},
148
+ sort_keys=True,
149
+ )
150
+ digest = hashlib.sha256(key_raw.encode("utf-8")).hexdigest()
151
+ cache_file = self.cache_dir / f"{digest}.json"
152
+ self.touched.add(digest)
153
+ if cache_file.is_file():
154
+ try:
155
+ entry = json.loads(cache_file.read_text(encoding="utf-8"))
156
+ except (OSError, json.JSONDecodeError):
157
+ cache_file.unlink(missing_ok=True)
158
+ entry = None
159
+ if entry is not None:
160
+ self.cache_hits += 1
161
+ response = entry["response"]
162
+ return (
163
+ response if isinstance(response, dict) else {}
164
+ ), entry.get("retrieved_on") or date.today().isoformat()
165
+
166
+ transport = self.request or self._http
167
+ attempts = 0
168
+ while True:
169
+ # The judged read is metered against the claw's own LLM key, and
170
+ # even free reads are bounded: a broken loop must not hammer the
171
+ # gateway.
172
+ if self.gtm_calls >= self.max_gtm_calls:
173
+ raise FleetPriorError(
174
+ f"GTM call budget exhausted ({self.max_gtm_calls} per attempt)"
175
+ )
176
+ self.gtm_calls += 1
177
+ try:
178
+ response = transport(method, path, payload, 180.0)
179
+ break
180
+ except FleetPriorError as exc:
181
+ if attempts >= 1 or not re.search(r"HTTP 5\d\d", str(exc)):
182
+ raise
183
+ attempts += 1
184
+ (self.sleep or time.sleep)(GTM_RETRY_DELAY_SECONDS)
185
+ retrieved_on = date.today().isoformat()
186
+ normalized = response if isinstance(response, dict) else {}
187
+ # A provisional state must not be frozen into the replay cache.
188
+ if should_cache is not None and not should_cache(normalized):
189
+ self.touched.discard(digest)
190
+ return normalized, retrieved_on
191
+ self.cache_dir.mkdir(parents=True, exist_ok=True)
192
+ tmp_file = cache_file.with_suffix(".json.tmp")
193
+ tmp_file.write_text(
194
+ json.dumps(
195
+ {
196
+ "kind": "gtm",
197
+ "method": method,
198
+ "path": path,
199
+ "payload": payload,
200
+ "response": response,
201
+ "retrieved_on": retrieved_on,
202
+ }
203
+ ),
204
+ encoding="utf-8",
205
+ )
206
+ tmp_file.replace(cache_file)
207
+ return normalized, retrieved_on
208
+
209
+ def ledger_totals(self) -> dict[str, Any]:
210
+ """Durable provenance over entries THIS execution touched."""
211
+ gtm_entries = 0
212
+ dates: list[str] = []
213
+ if self.cache_dir.is_dir():
214
+ for digest in sorted(self.touched):
215
+ entry_path = self.cache_dir / f"{digest}.json"
216
+ try:
217
+ entry = json.loads(entry_path.read_text(encoding="utf-8"))
218
+ except (OSError, json.JSONDecodeError):
219
+ continue
220
+ gtm_entries += 1
221
+ if isinstance(entry.get("retrieved_on"), str):
222
+ dates.append(entry["retrieved_on"])
223
+ today = date.today().isoformat()
224
+ return {
225
+ "gtm_calls": gtm_entries,
226
+ "first_retrieved_on": min(dates) if dates else today,
227
+ "last_retrieved_on": max(dates) if dates else today,
228
+ }
229
+
230
+
231
+ # ── deterministic helpers ──────────────────────────────────────────────────
232
+
233
+ def parse_terms(raw: str, cap: int) -> list[str]:
234
+ seen: dict[str, None] = {}
235
+ for part in re.split(r"[,;\n]", raw or ""):
236
+ term = " ".join(part.strip().lower().split())
237
+ if term and term not in seen:
238
+ seen[term] = None
239
+ return list(seen)[:cap]
240
+
241
+
242
+ def build_search_query(seed_terms: list[str]) -> str:
243
+ query = ", ".join(seed_terms)[:MAX_QUERY_CHARS].strip().rstrip(",")
244
+ return query
245
+
246
+
247
+ def _truncate(text: str, cap: int) -> str:
248
+ text = " ".join(str(text or "").split())
249
+ if len(text) <= cap:
250
+ return text
251
+ cut = text[:cap].rsplit(" ", 1)[0].rstrip()
252
+ return (cut or text[:cap].rstrip()) + "…"
253
+
254
+
255
+ def _cents_to_usd(value: Any) -> str:
256
+ try:
257
+ return f"${float(value) / 100:.2f}"
258
+ except (TypeError, ValueError):
259
+ return "—"
260
+
261
+
262
+ def _scalar_or_field(value: Any, field: str) -> Any:
263
+ """The GTM contract serves both structured objects and plain scalars for
264
+ channel/segment/learning — normalize both, never assume."""
265
+ if isinstance(value, dict):
266
+ return value.get(field)
267
+ if value is None:
268
+ return None
269
+ text = str(value).strip()
270
+ return text or None
271
+
272
+
273
+ def _metric_value(entry: Any) -> Any:
274
+ """Metrics arrive either as {value, unit, ...} objects or as flat
275
+ numbers; bool is an int subclass and is not a metric."""
276
+ if isinstance(entry, dict):
277
+ entry = entry.get("value")
278
+ if isinstance(entry, bool) or not isinstance(entry, (int, float)):
279
+ return None
280
+ return entry
281
+
282
+
283
+ def normalize_fleet_case(result: dict[str, Any]) -> dict[str, Any] | None:
284
+ """Trim one /gtm/comparables result into a bounded evidence row. The
285
+ endpoint already redacts PII and hides inconclusive records."""
286
+ if not isinstance(result, dict):
287
+ return None
288
+ metrics = result.get("metrics")
289
+ metrics = metrics if isinstance(metrics, dict) else {}
290
+ metric_values: dict[str, Any] = {}
291
+ for key in ("cpc_cents", "ctr_percent", "cpm_cents", "cost_per_session_cents", "spend_cents", "clicks", "impressions", "attributed_sessions"):
292
+ value = _metric_value(metrics.get(key))
293
+ if value is not None:
294
+ metric_values[key] = value
295
+ snapshot = result.get("product_snapshot")
296
+ snapshot = snapshot if isinstance(snapshot, dict) else {}
297
+ case = {
298
+ "type": "fleet_case",
299
+ "record_id": result.get("record_id"),
300
+ "experiment_id": result.get("experiment_id"),
301
+ "product": snapshot.get("name") or result.get("product_id"),
302
+ "channel_id": _scalar_or_field(result.get("channel"), "channel_id"),
303
+ "verdict": result.get("verdict"),
304
+ "trust_tier": result.get("trust_tier"),
305
+ "window_days": result.get("window_days"),
306
+ "sample_size": result.get("sample_size"),
307
+ "started_at": str(result.get("started_at") or "")[:10] or None,
308
+ "segment": _truncate(
309
+ _scalar_or_field(result.get("segment"), "description") or "", 200
310
+ )
311
+ or None,
312
+ "metrics": metric_values,
313
+ "learning": _truncate(
314
+ _scalar_or_field(result.get("learning"), "claim") or "",
315
+ LEARNING_TRUNCATE,
316
+ )
317
+ or None,
318
+ "relevance": _truncate(
319
+ str(result.get("relevance_reason") or ""), RELEVANCE_TRUNCATE
320
+ )
321
+ or None,
322
+ "tier": "A" if result.get("trust_tier") == "verified" else "B",
323
+ }
324
+ if not case["experiment_id"] or not case["channel_id"]:
325
+ return None
326
+ return case
327
+
328
+
329
+ # ── rendering ──────────────────────────────────────────────────────────────
330
+
331
+ def render_section(
332
+ *,
333
+ query: str,
334
+ geo: str | None,
335
+ cases: list[dict[str, Any]],
336
+ coverage: dict[str, Any],
337
+ totals: dict[str, Any],
338
+ retrieved_on: str,
339
+ ) -> str:
340
+ lines: list[str] = []
341
+ add = lines.append
342
+
343
+ add(
344
+ f"The fleet's own launch evidence retrieved {retrieved_on} from the "
345
+ "GTM knowledge projection: past experiments judged genuinely "
346
+ "comparable to THIS product (`/gtm/comparables` — the whole "
347
+ "verified/directional pool, PII-redacted at the source, filtered "
348
+ "semantically by an LLM judge, not by keyword overlap). These are "
349
+ "OUR measured numbers, not industry averages: check n, dates, and "
350
+ "windows before leaning on any figure — small-n results are "
351
+ "directional. This section deliberately carries no cross-niche "
352
+ "aggregate channel benchmarks: pooled all-niche medians say nothing "
353
+ "about this product."
354
+ )
355
+ add("")
356
+ context_line = f"Product context given to the judge: `{query}`"
357
+ if geo:
358
+ context_line += f"; launch geography `{geo}`"
359
+ add(context_line + ".")
360
+ add("")
361
+
362
+ add("### Comparable fleet experiments")
363
+ add("")
364
+ if cases:
365
+ add("| Product | Channel | Verdict | Trust | Key metrics | Started | Why comparable | Learning |")
366
+ add("| --- | --- | --- | --- | --- | --- | --- | --- |")
367
+ for case in cases:
368
+ metrics = case.get("metrics") or {}
369
+ parts = []
370
+ if metrics.get("cpc_cents") is not None:
371
+ parts.append(f"CPC {_cents_to_usd(metrics['cpc_cents'])}")
372
+ if metrics.get("ctr_percent") is not None:
373
+ parts.append(f"CTR {float(metrics['ctr_percent']):.1f}%")
374
+ if metrics.get("spend_cents") is not None:
375
+ parts.append(f"spend {_cents_to_usd(metrics['spend_cents'])}")
376
+ learning = (case.get("learning") or "").replace("|", "/")
377
+ relevance = (case.get("relevance") or "").replace("|", "/")
378
+ add(
379
+ f"| {case.get('product') or '—'} | {case['channel_id']} | "
380
+ f"{case.get('verdict') or '—'} | {case.get('trust_tier') or '—'} | "
381
+ f"{'; '.join(parts) or '—'} | {case.get('started_at') or '—'} | "
382
+ f"{_truncate(relevance, 160) or '—'} | "
383
+ f"{_truncate(learning, 160) or '—'} |"
384
+ )
385
+ else:
386
+ pool_size = coverage.get("pool_size") or 0
387
+ judged = coverage.get("judged") or 0
388
+ if pool_size == 0:
389
+ add(
390
+ "No relevant comparable experiment exists yet: our fleet "
391
+ "pool holds no verified or directional experiment records at "
392
+ "all. This is a coverage fact about our own launches, not "
393
+ "evidence against the idea."
394
+ )
395
+ else:
396
+ add(
397
+ f"No relevant comparable experiment was found in our fleet "
398
+ f"pool ({judged} of {pool_size} experiment(s) reviewed by "
399
+ "the judge). The pool covers only what WE have launched, and "
400
+ "the judge is instructed to exclude when unsure, so this is "
401
+ "a coverage fact — not evidence against the idea."
402
+ )
403
+ add("")
404
+
405
+ add("### Method and coverage")
406
+ add("")
407
+ add(
408
+ f"- Reads recorded: {totals['gtm_calls']} OS GTM call(s), "
409
+ "accumulated across attempts; cached replays add no new reads."
410
+ )
411
+ selection_line = (
412
+ f"- Selection: the OS-side `{coverage.get('model_role') or 'gtm-comparables-judge'}` "
413
+ f"LLM judge reviewed {coverage.get('judged') or 0} of "
414
+ f"{coverage.get('pool_size') or 0} pool experiment(s) against the "
415
+ f"product context and kept {coverage['agent_records_returned']} "
416
+ f"(limit {SEARCH_LIMIT}); matching is semantic, conservative by "
417
+ "instruction, and never invents records."
418
+ )
419
+ if coverage.get("partial"):
420
+ selection_line += (
421
+ " REVIEW INCOMPLETE: the judge did not see the whole pool, so "
422
+ "unlisted comparable experiments may exist."
423
+ )
424
+ add(selection_line)
425
+ add(
426
+ "- The fleet prior is evidence of what WE measured, biased toward "
427
+ "the niches and budgets we tried; it complements — never replaces "
428
+ "— the external market sections. Aggregate cross-niche channel "
429
+ "benchmarks and pooled-CPC comparisons are intentionally excluded."
430
+ )
431
+ add("")
432
+ add("### Sources")
433
+ add("")
434
+ add(
435
+ "- OS `/gtm/comparables` over the fleet GTM knowledge projection — "
436
+ f"retrieved {retrieved_on}; the rows in "
437
+ f"`{EVIDENCE_REL.as_posix()}` are exactly the set the table above "
438
+ "is computed from."
439
+ )
440
+ return "\n".join(lines).strip() + "\n"
441
+
442
+
443
+ # ── orchestration ──────────────────────────────────────────────────────────
444
+
445
+ @dataclass
446
+ class RunInputs:
447
+ seed_terms: list[str]
448
+ geo: str | None
449
+
450
+
451
+ def run_pipeline(client: OsClient, inputs: RunInputs, workspace: Path) -> dict[str, Any]:
452
+ if not inputs.seed_terms:
453
+ raise FleetPriorError(
454
+ "no seed terms available: pass --seed-keywords with 1-5 category "
455
+ "or problem phrases derived from the research assignment (see the workflow doc)"
456
+ )
457
+ query = build_search_query(inputs.seed_terms)
458
+
459
+ payload: dict[str, Any] = {"query": query, "limit": SEARCH_LIMIT}
460
+ if inputs.geo:
461
+ payload["geo"] = inputs.geo
462
+ # A partial review (the judge saw only part of the pool) must never be
463
+ # frozen into the replay cache: the next attempt has to re-ask.
464
+ data, _ = client.gtm_call(
465
+ "POST",
466
+ "/gtm/comparables",
467
+ payload,
468
+ should_cache=lambda response: not response.get("partial"),
469
+ )
470
+ results = data.get("results")
471
+ results = results if isinstance(results, list) else []
472
+ cases = [c for c in (normalize_fleet_case(r) for r in results) if c]
473
+ cases = cases[:STORED_CASES_CAP]
474
+
475
+ partial = bool(data.get("partial"))
476
+ if partial and not cases:
477
+ # "Nothing relevant" is only a safe conclusion over the WHOLE pool.
478
+ raise FleetPriorError(
479
+ "comparables review was partial (the judge saw only part of the "
480
+ "fleet pool) and returned no match; refusing to record a no-match "
481
+ "conclusion — rerun later"
482
+ )
483
+
484
+ def _count(value: Any) -> int:
485
+ return value if isinstance(value, int) and not isinstance(value, bool) else 0
486
+
487
+ coverage = {
488
+ "type": "coverage",
489
+ "agent_records_returned": len(cases),
490
+ "pool_size": _count(data.get("pool_size")),
491
+ "judged": _count(data.get("judged")),
492
+ "partial": partial,
493
+ "selection": "llm_judged",
494
+ "model_role": str(data.get("model_role") or "") or None,
495
+ "search_query": query,
496
+ "geo": inputs.geo,
497
+ "tier": "A",
498
+ }
499
+
500
+ totals = client.ledger_totals()
501
+ retrieved_on = (
502
+ totals["first_retrieved_on"]
503
+ if totals["first_retrieved_on"] == totals["last_retrieved_on"]
504
+ else f"{totals['first_retrieved_on']}..{totals['last_retrieved_on']}"
505
+ )
506
+
507
+ evidence = {
508
+ "schema_version": SCHEMA_VERSION,
509
+ "section_id": SECTION_ID,
510
+ "generated_by": Path(__file__).name,
511
+ "retrieved_on": retrieved_on,
512
+ "inputs": {
513
+ "seed_terms": inputs.seed_terms,
514
+ "geo": inputs.geo,
515
+ "search_query": query,
516
+ },
517
+ "rows": cases + [coverage],
518
+ "totals": {"gtm_calls": totals["gtm_calls"]},
519
+ }
520
+
521
+ section_markdown = render_section(
522
+ query=query,
523
+ geo=inputs.geo,
524
+ cases=cases,
525
+ coverage=coverage,
526
+ totals=totals,
527
+ retrieved_on=retrieved_on,
528
+ )
529
+ return {
530
+ "evidence": evidence,
531
+ "section_markdown": section_markdown,
532
+ "totals": totals,
533
+ "attempt": {
534
+ "gtm_calls": client.gtm_calls,
535
+ "cache_hits": client.cache_hits,
536
+ },
537
+ }
538
+
539
+
540
+ def _write_atomic(path: Path, content: str) -> None:
541
+ path.parent.mkdir(parents=True, exist_ok=True)
542
+ tmp = path.with_suffix(path.suffix + ".tmp")
543
+ tmp.write_text(content, encoding="utf-8")
544
+ tmp.replace(path)
545
+
546
+
547
+ def run(workspace: Path, args: argparse.Namespace) -> dict[str, Any]:
548
+ workspace = workspace.resolve()
549
+ io = _load_script("research-artifact-io.py", "pmr_artifact_io")
550
+ with io.section_attempt(workspace, SECTION_ID, context_file=getattr(args, "context_file", None)):
551
+ return _run(workspace, args)
552
+
553
+
554
+ def _run(workspace: Path, args: argparse.Namespace) -> dict[str, Any]:
555
+ workspace = workspace.resolve()
556
+ runtime = workspace / RUNTIME_REL
557
+ cache_dir = runtime / "cache"
558
+ runtime.mkdir(parents=True, exist_ok=True)
559
+
560
+ api_key = (os.environ.get("OS_API_KEY") or "").strip()
561
+ if not api_key:
562
+ raise FleetPriorError("OS_API_KEY is required")
563
+ os_url = (os.environ.get("OS_URL") or DEFAULT_OS_URL).strip() or DEFAULT_OS_URL
564
+
565
+ inputs = RunInputs(
566
+ seed_terms=parse_terms(args.seed_keywords or "", 5),
567
+ geo=(args.geo or "").strip() or None,
568
+ )
569
+ client = OsClient(
570
+ os_url=os_url,
571
+ api_key=api_key,
572
+ cache_dir=cache_dir,
573
+ max_gtm_calls=args.max_gtm_calls,
574
+ )
575
+
576
+ outcome = run_pipeline(client, inputs, workspace)
577
+
578
+ evidence_path = workspace / EVIDENCE_REL
579
+ evidence_json = json.dumps(outcome["evidence"], indent=1, ensure_ascii=False)
580
+ _write_atomic(evidence_path, evidence_json)
581
+
582
+ section_file = runtime / "result.md"
583
+ _write_atomic(section_file, outcome["section_markdown"])
584
+
585
+ upsert = _load_script("upsert-markdown-section.py", "pmr_upsert_markdown_section")
586
+ report_path = workspace / REPORT_REL
587
+ report_path.parent.mkdir(parents=True, exist_ok=True)
588
+ upsert.upsert_markdown_section(report_path, SECTION_HEADING, outcome["section_markdown"])
589
+
590
+ persist = _load_script("persist-research-report.py", "pmr_persist_research_report")
591
+ persistence = persist.persist_research_report(
592
+ workspace,
593
+ commit_message=f"research: update {SECTION_HEADING.lower()} section",
594
+ extra_paths=(Path(_artifact_path("egbe-docs/research/market/evidence/fleet-prior.json")),),
595
+ )
596
+
597
+ state = {
598
+ "schema_version": SCHEMA_VERSION,
599
+ "section_id": SECTION_ID,
600
+ "status": "completed",
601
+ "seed_terms": inputs.seed_terms,
602
+ "geo": inputs.geo,
603
+ "evidence_path": EVIDENCE_REL.as_posix(),
604
+ "evidence_sha256": hashlib.sha256(evidence_json.encode("utf-8")).hexdigest(),
605
+ "result_path": (RUNTIME_REL / "result.md").as_posix(),
606
+ "result_sha256": hashlib.sha256(outcome["section_markdown"].encode("utf-8")).hexdigest(),
607
+ "gtm_calls": outcome["totals"]["gtm_calls"],
608
+ "attempt_gtm_calls": outcome["attempt"]["gtm_calls"],
609
+ "attempt_cache_hits": outcome["attempt"]["cache_hits"],
610
+ "report_commit_sha": persistence.commit_sha,
611
+ "publication_mode": persistence.publication_mode,
612
+ "research_context": _load_script("research-artifact-io.py", "pmr_input_io").context_binding(workspace, SECTION_ID),
613
+ "error": None,
614
+ }
615
+ _write_atomic(runtime / "request.json", json.dumps(state, indent=1))
616
+ return state
617
+
618
+
619
+ def main() -> int:
620
+ parser = argparse.ArgumentParser(description=__doc__)
621
+ parser.add_argument("--context-file", type=Path, help="Explicit context for this study; no project files are discovered implicitly.")
622
+ parser.add_argument("--workspace", type=Path, required=True)
623
+ parser.add_argument(
624
+ "--seed-keywords",
625
+ default="",
626
+ help="Comma-separated category and problem phrases derived from "
627
+ "the research assignment; they are the product context the comparables judge "
628
+ "matches experiments against.",
629
+ )
630
+ parser.add_argument(
631
+ "--geo",
632
+ default="",
633
+ help="Optional launch geography given to the judge as context (e.g. US).",
634
+ )
635
+ parser.add_argument("--max-gtm-calls", type=int, default=MAX_GTM_CALLS_PER_ATTEMPT)
636
+ args = parser.parse_args()
637
+
638
+ try:
639
+ state = run(args.workspace, args)
640
+ except FleetPriorError as exc:
641
+ print(f"{DISPLAY_NAME}: {exc}", file=sys.stderr)
642
+ return 1
643
+ print(
644
+ f"{DISPLAY_NAME}: completed — {state['gtm_calls']} GTM call(s), "
645
+ f"evidence at {state['evidence_path']}, report commit "
646
+ f"{state['report_commit_sha'][:12]}"
647
+ )
648
+ return 0
649
+
650
+
651
+ if __name__ == "__main__":
652
+ raise SystemExit(main())