@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,122 @@
1
+ """Local, portable checks of the files pinned by measured research receipts."""
2
+ from __future__ import annotations
3
+
4
+ import sys as _artifact_sys
5
+ from pathlib import Path as _ArtifactPath
6
+ _artifact_sys.path.insert(0, str(_ArtifactPath(__file__).resolve().parent))
7
+ from egbe_artifacts import artifact_path as _artifact_path
8
+
9
+ import hashlib
10
+ import json
11
+ from pathlib import Path
12
+
13
+
14
+ def digest(value):
15
+ return hashlib.sha256(json.dumps(value, sort_keys=True, separators=(",", ":"), ensure_ascii=False, allow_nan=False).encode()).hexdigest()
16
+
17
+
18
+ def identity_binding(registry, *, funnel_ids=(), lifecycle_domains=()):
19
+ """Pin the real mappings used by one section, without publishing addresses.
20
+
21
+ The shared registry is append-only across independent research tasks. Its
22
+ serialization and unrelated identities are not inputs to this section.
23
+ """
24
+ selection = {"funnel_ids": sorted(set(funnel_ids)), "lifecycle_domains": sorted(set(lifecycle_domains))}
25
+ if not isinstance(registry, dict) or registry.get("schema_version") != 1 or not isinstance(registry.get("mailbox"), str) or not isinstance(registry.get("identities"), list):
26
+ raise ValueError("Research identity registry needs schema 1, mailbox and identities")
27
+ identities = registry["identities"]
28
+ if any(not isinstance(item, dict) for item in identities):
29
+ raise ValueError("Research identities must be objects")
30
+ selected = []
31
+ for field, values, kind in (("funnel_id", selection["funnel_ids"], "funnel"),
32
+ ("domain", selection["lifecycle_domains"], "lifecycle")):
33
+ for value in values:
34
+ matches = [item for item in identities if item.get(field) == value and item.get("kind") == kind]
35
+ if len(matches) != 1:
36
+ raise ValueError("Used research identity is missing or ambiguous")
37
+ item = matches[0]
38
+ if any(not isinstance(item.get(key), str) or not item[key] for key in ("identity_id", "domain", "alias")):
39
+ raise ValueError("Used research identity mapping is incomplete")
40
+ if kind == "lifecycle" and item.get("funnel_id") is not None:
41
+ raise ValueError("Lifecycle identity cannot be a funnel identity")
42
+ if sum(other.get("alias") == item["alias"] for other in identities) != 1:
43
+ raise ValueError("Used research alias is ambiguous")
44
+ selected.append({key: item.get(key) for key in ("identity_id", "domain", "funnel_id", "alias", "kind")})
45
+ selected.sort(key=lambda item: (item["kind"], item["domain"], item["funnel_id"] or ""))
46
+ return {"schema_version": 1, "selection": selection,
47
+ "sha256": digest({"schema_version": 1, "mailbox": registry["mailbox"], "identities": selected})}
48
+
49
+
50
+ def validate_identity_binding(workspace, binding):
51
+ if not isinstance(binding, dict) or binding.get("schema_version") != 1 or not isinstance(binding.get("selection"), dict):
52
+ raise ValueError("Research identity binding needs a scoped selection")
53
+ selection = binding["selection"]
54
+ if set(selection) != {"funnel_ids", "lifecycle_domains"} or any(not isinstance(selection[key], list) or any(not isinstance(value, str) or not value for value in selection[key]) for key in selection):
55
+ raise ValueError("Research identity selection must contain identity keys")
56
+ try:
57
+ registry = json.loads((Path(workspace) / _artifact_path("egbe-docs/research/market/work/identity-registry.json")).read_text())
58
+ except (OSError, ValueError) as exc:
59
+ raise ValueError("Research identity registry is missing or invalid") from exc
60
+ actual = identity_binding(registry, **selection)
61
+ if actual != binding:
62
+ raise ValueError("Used research identity mapping changed")
63
+
64
+
65
+ def bound_sources(workspace, sources):
66
+ if not isinstance(sources, dict) or not sources:
67
+ raise ValueError("Research source_files must be a nonempty path/hash map")
68
+ root = Path(workspace).resolve()
69
+ for name, expected in sources.items():
70
+ path = Path(name)
71
+ if not isinstance(name, str) or path.is_absolute() or ".." in path.parts:
72
+ raise ValueError("Research source paths must stay inside the workspace")
73
+ actual_path = (root / path).resolve()
74
+ if not actual_path.is_relative_to(root):
75
+ raise ValueError("Research source path escapes the workspace")
76
+ actual = hashlib.sha256(actual_path.read_bytes()).hexdigest() if actual_path.is_file() else None
77
+ if expected != actual:
78
+ raise ValueError(f"Research source changed or is missing: {name}")
79
+
80
+
81
+ def validate_funnel_receipt(workspace, evidence, state):
82
+ if evidence.get("schema_version") != 2:
83
+ return # legacy rows are diagnostic context, never campaign proof
84
+ inputs = evidence.get("inputs") or {}
85
+ sources = inputs.get("source_files")
86
+ if sources != state.get("source_files"):
87
+ raise ValueError("Funnel receipt source_files differs from published evidence")
88
+ bound_sources(workspace, sources)
89
+ required = {_artifact_path("egbe-docs/research/market/work/funnel_teardown/input-context.json"), _artifact_path("egbe-docs/research/market/evidence/creative-patterns.json"),
90
+ _artifact_path("egbe-docs/research/market/evidence/channel-footprint.json"),
91
+ _artifact_path("egbe-docs/research/market/work/creative_patterns/request.json"), _artifact_path("egbe-docs/research/market/work/channel_footprint/request.json")}
92
+ if not required.issubset(sources):
93
+ raise ValueError("Funnel receipt does not pin its upstream research/context")
94
+ policy = inputs.get("effective_policy")
95
+ if not isinstance(policy, dict) or digest(policy) != inputs.get("policy_sha256") or state.get("policy_sha256") != inputs.get("policy_sha256"):
96
+ raise ValueError("Funnel effective policy/receipt hash mismatch")
97
+ resume = inputs.get("resume_inputs")
98
+ if not isinstance(resume, dict) or digest(resume) != inputs.get("inputs_sha256") or state.get("inputs_sha256") != inputs.get("inputs_sha256"):
99
+ raise ValueError("Funnel resume input fingerprint mismatch")
100
+ bound_sources(workspace, resume.get("source_files"))
101
+ binding = inputs.get("identity_registry_binding")
102
+ if any(value is not None for value in (binding, state.get("identity_registry_binding"), resume.get("identity_registry_binding"))):
103
+ if binding != state.get("identity_registry_binding") or binding != resume.get("identity_registry_binding"):
104
+ raise ValueError("Funnel identity binding differs from receipt or resume inputs")
105
+ validate_identity_binding(workspace, binding)
106
+ selection_path = inputs.get("creative_selection_path")
107
+ if not selection_path or not inputs.get("creative_selection_sha256") or sources.get(selection_path) != inputs.get("creative_selection_sha256"):
108
+ raise ValueError("Funnel selected creative manifest is missing or stale")
109
+ for asset in inputs.get("assets", []):
110
+ if not isinstance(asset, dict) or sources.get(asset.get("path")) != asset.get("sha256") or not asset.get("sha256"):
111
+ raise ValueError("Funnel screenshot is missing from the pinned asset map")
112
+
113
+
114
+ def validate_lifecycle_inputs(workspace, state):
115
+ for key, name in (("funnel_handoff_sha256", _artifact_path("egbe-docs/research/market/work/funnel_teardown/lifecycle-handoff.json")),):
116
+ if state.get(key):
117
+ bound_sources(workspace, {name: state[key]})
118
+ if state.get("identity_registry_binding") is not None:
119
+ validate_identity_binding(workspace, state["identity_registry_binding"])
120
+ elif state.get("identity_registry_sha256"):
121
+ # Existing receipts keep their original byte binding until republished.
122
+ bound_sources(workspace, {_artifact_path("egbe-docs/research/market/work/identity-registry.json"): state["identity_registry_sha256"]})
@@ -0,0 +1,306 @@
1
+ #!/usr/bin/env python3
2
+ """Record an agent's bounded review of one cached research response ending."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import sys as _artifact_sys
7
+ from pathlib import Path as _ArtifactPath
8
+ _artifact_sys.path.insert(0, str(_ArtifactPath(__file__).resolve().parent))
9
+ from egbe_artifacts import artifact_path as _artifact_path
10
+
11
+ import argparse
12
+ import hashlib
13
+ import json
14
+ import os
15
+ import re
16
+ import shutil
17
+ import tempfile
18
+ from pathlib import Path
19
+ from typing import Any
20
+
21
+
22
+ SCHEMA_VERSION = 1
23
+ REQUEST_SCHEMA_VERSION = 3
24
+ ACCEPTED_CLASSIFICATIONS = {"complete", "uncertain"}
25
+ CLASSIFICATIONS = (*sorted(ACCEPTED_CLASSIFICATIONS), "definitely_truncated")
26
+ SOURCES_HEADING = "\n### Sources\n"
27
+ MAX_RETRIES = 1
28
+ MIN_EVIDENCE_CHARS = 12
29
+ MAX_EVIDENCE_CHARS = 500
30
+ EVIDENCE_TAIL_CHARS = 2000
31
+
32
+
33
+ class CompletionReviewError(RuntimeError):
34
+ """Raised when completion review cannot be bound to current runtime state."""
35
+
36
+
37
+ def _file_sha256(path: Path) -> str:
38
+ digest = hashlib.sha256()
39
+ with path.open("rb") as handle:
40
+ for chunk in iter(lambda: handle.read(64 * 1024), b""):
41
+ digest.update(chunk)
42
+ return digest.hexdigest()
43
+
44
+
45
+ def _read_object(path: Path, *, label: str) -> dict[str, Any]:
46
+ try:
47
+ value = json.loads(path.read_text(encoding="utf-8"))
48
+ except (OSError, json.JSONDecodeError, UnicodeDecodeError) as exc:
49
+ raise CompletionReviewError(f"cannot read {label}: {path}") from exc
50
+ if not isinstance(value, dict):
51
+ raise CompletionReviewError(f"{label} must be a JSON object: {path}")
52
+ return value
53
+
54
+
55
+ def _write_object(path: Path, payload: dict[str, Any]) -> None:
56
+ path.parent.mkdir(parents=True, exist_ok=True)
57
+ temporary_path: Path | None = None
58
+ try:
59
+ with tempfile.NamedTemporaryFile(
60
+ mode="w",
61
+ encoding="utf-8",
62
+ newline="\n",
63
+ dir=path.parent,
64
+ prefix=f".{path.name}.",
65
+ suffix=".tmp",
66
+ delete=False,
67
+ ) as handle:
68
+ json.dump(payload, handle, ensure_ascii=False, indent=2, sort_keys=True)
69
+ handle.write("\n")
70
+ handle.flush()
71
+ os.fsync(handle.fileno())
72
+ temporary_path = Path(handle.name)
73
+ os.chmod(temporary_path, 0o600)
74
+ os.replace(temporary_path, path)
75
+ temporary_path = None
76
+ finally:
77
+ if temporary_path is not None:
78
+ temporary_path.unlink(missing_ok=True)
79
+
80
+
81
+ def _normalized_text(value: str) -> str:
82
+ return " ".join(value.split())
83
+
84
+
85
+ def _research_answer(markdown: str) -> str:
86
+ """Exclude the deterministic source appendix from the reviewed answer tail."""
87
+
88
+ answer, separator, _ = markdown.rpartition(SOURCES_HEADING)
89
+ return answer.rstrip() if separator and answer.strip() else markdown.rstrip()
90
+
91
+
92
+ def _validated_current_state(
93
+ workspace: Path,
94
+ section_id: str,
95
+ ) -> tuple[Path, Path, Path, dict[str, Any], str]:
96
+ if not re.fullmatch(r"[a-z0-9_]+", section_id):
97
+ raise CompletionReviewError("section id must use lowercase snake_case")
98
+
99
+ runtime_dir = workspace / _artifact_path('egbe-docs/research/market/work') / section_id
100
+ request_path = runtime_dir / "request.json"
101
+ query_path = runtime_dir / "query.md"
102
+ prompt_path = runtime_dir / "system-prompt.md"
103
+ result_path = runtime_dir / "result.md"
104
+ state = _read_object(request_path, label="research request state")
105
+ try:
106
+ result = result_path.read_text(encoding="utf-8")
107
+ except (OSError, UnicodeDecodeError) as exc:
108
+ raise CompletionReviewError(f"cannot read research result: {result_path}") from exc
109
+
110
+ expected_result_path = (
111
+ Path(_artifact_path("egbe-docs/research/market/work")) / section_id / "result.md"
112
+ ).as_posix()
113
+ if (
114
+ state.get("schema_version") != REQUEST_SCHEMA_VERSION
115
+ or state.get("status") != "completed"
116
+ or not str(state.get("job_id") or "").strip()
117
+ or state.get("result_path") != expected_result_path
118
+ or state.get("query_sha256") != _file_sha256(query_path)
119
+ or state.get("system_prompt_sha256") != _file_sha256(prompt_path)
120
+ or state.get("result_sha256") != _file_sha256(result_path)
121
+ or state.get("error") not in (None, "")
122
+ or not result.strip()
123
+ ):
124
+ raise CompletionReviewError(
125
+ "completion review requires a matching completed research result"
126
+ )
127
+ return runtime_dir, request_path, result_path, state, result
128
+
129
+
130
+ def _prior_retry_count(
131
+ review_path: Path,
132
+ *,
133
+ query_sha256: str,
134
+ system_prompt_sha256: str,
135
+ ) -> int:
136
+ try:
137
+ review = _read_object(review_path, label="completion review")
138
+ except CompletionReviewError:
139
+ return 0
140
+ if (
141
+ review.get("schema_version") != SCHEMA_VERSION
142
+ or review.get("query_sha256") != query_sha256
143
+ or review.get("system_prompt_sha256") != system_prompt_sha256
144
+ ):
145
+ return 0
146
+ value = review.get("retry_count")
147
+ return value if isinstance(value, int) and not isinstance(value, bool) else 0
148
+
149
+
150
+ def _archive_attempt(
151
+ runtime_dir: Path,
152
+ *,
153
+ query_sha256: str,
154
+ attempt: int,
155
+ request_path: Path,
156
+ result_path: Path,
157
+ review: dict[str, Any],
158
+ ) -> None:
159
+ archive = (
160
+ runtime_dir
161
+ / "attempts"
162
+ / query_sha256[:16]
163
+ / f"definitely-truncated-{attempt}"
164
+ )
165
+ if archive.exists():
166
+ raise CompletionReviewError(
167
+ f"truncated research attempt archive already exists: {archive}"
168
+ )
169
+ archive.mkdir(parents=True)
170
+ shutil.copy2(request_path, archive / "request.json")
171
+ shutil.copy2(result_path, archive / "result.md")
172
+ _write_object(archive / "completion-review.json", review)
173
+
174
+
175
+ def record_completion_review(
176
+ workspace: Path,
177
+ *,
178
+ section_id: str,
179
+ classification: str,
180
+ evidence: str = "",
181
+ ) -> dict[str, Any]:
182
+ """Bind an agent decision to the current result and prepare one bounded retry."""
183
+
184
+ if classification not in CLASSIFICATIONS:
185
+ raise CompletionReviewError(
186
+ f"classification must be one of: {', '.join(CLASSIFICATIONS)}"
187
+ )
188
+ workspace = workspace.resolve()
189
+ runtime_dir, request_path, result_path, request, markdown = (
190
+ _validated_current_state(workspace, section_id)
191
+ )
192
+ review_path = runtime_dir / "completion-review.json"
193
+ retry_count = _prior_retry_count(
194
+ review_path,
195
+ query_sha256=str(request["query_sha256"]),
196
+ system_prompt_sha256=str(request["system_prompt_sha256"]),
197
+ )
198
+
199
+ clean_evidence = _normalized_text(evidence)
200
+ if classification == "definitely_truncated":
201
+ if not MIN_EVIDENCE_CHARS <= len(clean_evidence) <= MAX_EVIDENCE_CHARS:
202
+ raise CompletionReviewError(
203
+ "definite truncation requires a 12-500 character answer-tail excerpt"
204
+ )
205
+ answer_tail = _normalized_text(_research_answer(markdown)[-EVIDENCE_TAIL_CHARS:])
206
+ if clean_evidence not in answer_tail:
207
+ raise CompletionReviewError(
208
+ "truncation evidence must be an exact excerpt from the research answer tail"
209
+ )
210
+ elif clean_evidence:
211
+ raise CompletionReviewError(
212
+ "evidence is accepted only for definitely_truncated"
213
+ )
214
+
215
+ retry_exhausted = (
216
+ classification == "definitely_truncated" and retry_count >= MAX_RETRIES
217
+ )
218
+ next_retry_count = (
219
+ retry_count + 1
220
+ if classification == "definitely_truncated" and not retry_exhausted
221
+ else retry_count
222
+ )
223
+ review = {
224
+ "schema_version": SCHEMA_VERSION,
225
+ "section_id": section_id,
226
+ "job_id": request["job_id"],
227
+ "query_sha256": request["query_sha256"],
228
+ "system_prompt_sha256": request["system_prompt_sha256"],
229
+ "result_sha256": request["result_sha256"],
230
+ "classification": classification,
231
+ "evidence": clean_evidence or None,
232
+ "retry_count": next_retry_count,
233
+ "retry_exhausted": retry_exhausted,
234
+ }
235
+
236
+ if classification == "definitely_truncated":
237
+ _archive_attempt(
238
+ runtime_dir,
239
+ query_sha256=str(request["query_sha256"]),
240
+ attempt=retry_count + 1,
241
+ request_path=request_path,
242
+ result_path=result_path,
243
+ review=review,
244
+ )
245
+ failed_request = dict(request)
246
+ failed_request.update(
247
+ {
248
+ "status": "failed",
249
+ "error": (
250
+ "research response was definitely truncated after one fresh retry"
251
+ if retry_exhausted
252
+ else "research response was definitely truncated; one fresh retry is required"
253
+ ),
254
+ "resume_safe": False,
255
+ "next_submission_attempt": int(
256
+ request.get("submission_attempt") or 0
257
+ )
258
+ + 1,
259
+ "truncation_retry_exhausted": retry_exhausted,
260
+ }
261
+ )
262
+ _write_object(request_path, failed_request)
263
+
264
+ _write_object(review_path, review)
265
+ if retry_exhausted:
266
+ raise CompletionReviewError(
267
+ "research response was definitely truncated again; retry limit exhausted"
268
+ )
269
+ return review
270
+
271
+
272
+ def _parser() -> argparse.ArgumentParser:
273
+ parser = argparse.ArgumentParser(description=__doc__)
274
+ parser.add_argument("--workspace", type=Path, default=Path("."))
275
+ parser.add_argument("--section-id", required=True)
276
+ parser.add_argument("--classification", choices=CLASSIFICATIONS, required=True)
277
+ parser.add_argument("--evidence-file", type=Path)
278
+ return parser
279
+
280
+
281
+ def main() -> int:
282
+ args = _parser().parse_args()
283
+ try:
284
+ evidence = (
285
+ args.evidence_file.read_text(encoding="utf-8")
286
+ if args.evidence_file is not None
287
+ else ""
288
+ )
289
+ review = record_completion_review(
290
+ args.workspace,
291
+ section_id=args.section_id,
292
+ classification=args.classification,
293
+ evidence=evidence,
294
+ )
295
+ except (CompletionReviewError, OSError, UnicodeError, ValueError) as exc:
296
+ raise SystemExit(str(exc)) from exc
297
+
298
+ if review["classification"] == "definitely_truncated":
299
+ print("Definite truncation recorded; rerun the same section workflow once.")
300
+ else:
301
+ print(f"Research completion recorded as {review['classification']}.")
302
+ return 0
303
+
304
+
305
+ if __name__ == "__main__":
306
+ raise SystemExit(main())
@@ -0,0 +1,72 @@
1
+ #!/usr/bin/env python3
2
+ """Run or resume Acquisition Channels research, then materialize its result."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import importlib.util
7
+ import sys
8
+ from pathlib import Path
9
+ from types import ModuleType
10
+ from typing import Any, Callable
11
+
12
+
13
+ def _load_script(filename: str, module_name: str) -> ModuleType:
14
+ path = Path(__file__).resolve().parent / filename
15
+ spec = importlib.util.spec_from_file_location(module_name, path)
16
+ if spec is None or spec.loader is None:
17
+ raise RuntimeError(f"cannot load bundled script {filename}")
18
+ module = importlib.util.module_from_spec(spec)
19
+ sys.modules[spec.name] = module
20
+ previous = sys.dont_write_bytecode
21
+ sys.dont_write_bytecode = True
22
+ try:
23
+ spec.loader.exec_module(module)
24
+ finally:
25
+ sys.dont_write_bytecode = previous
26
+ return module
27
+
28
+
29
+ workflow = _load_script("research-section-workflow.py", "pmr_section_workflow")
30
+ SPEC = workflow.SectionWorkflowSpec(
31
+ section_id="acquisition_channels",
32
+ section_heading="Acquisition channels",
33
+ display_name="Acquisition Channels",
34
+ system_prompt_filename="acquisition-channels.md",
35
+ user_prompt_filename="acquisition-channels.user.md",
36
+ supporting_section_ids=(
37
+ "target_audience",
38
+ "competitive_landscape",
39
+ "value_proposition",
40
+ "pricing_monetization",
41
+ ),
42
+ )
43
+
44
+
45
+ def run_workflow(
46
+ workspace: Path,
47
+ *,
48
+ assignment: str | None = None,
49
+ context_file: Path | None = None,
50
+ research_run: Callable[..., Any] | None = None,
51
+ materialize: Callable[[Path, str, str], Any] | None = None,
52
+ ) -> dict[str, Any]:
53
+ return workflow.run_section_workflow(
54
+ workspace,
55
+ spec=SPEC,
56
+ assignment=assignment,
57
+ context_file=context_file,
58
+ research_run=research_run,
59
+ materialize=materialize,
60
+ )
61
+
62
+
63
+ def main() -> int:
64
+ return workflow.run_cli(
65
+ description=__doc__ or "",
66
+ display_name=SPEC.display_name,
67
+ runner=run_workflow,
68
+ )
69
+
70
+
71
+ if __name__ == "__main__":
72
+ raise SystemExit(main())