@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,133 @@
1
+ # Analysis and output contract
2
+
3
+ ## Normalized source evidence
4
+
5
+ `normalize-videos.py` writes `normalized/videos.json` with schema version 1,
6
+ `analysis_contract_version: "evidence-v5"`, generation time, source manifest hash,
7
+ selection gaps and stable observation IDs. Observations retain canonical URLs,
8
+ account context, publication time, caption, nullable provider metrics, comments,
9
+ sound metadata and media availability. Descriptive comparisons are not causal
10
+ attribution or an eligibility score.
11
+
12
+ `collection_window` records the frozen reference time and lower date;
13
+ `time_window_counts` separates `in_window`, `outside_window` and `unknown_date`.
14
+ Each observation has `time_window_status`. Out-of-window and unknown-date rows
15
+ remain inspectable but do not affect account medians or enter selection and
16
+ enrichment. Unknown dates are not represented as proven dates outside the window.
17
+
18
+ The requested sample is frozen in hash-bound `normalized/selection.json` before
19
+ enrichment. Its account-balanced resource cap is not a best-performing ranking
20
+ and has no minimum number per account. Enrichment may add evidence but cannot
21
+ silently replace selected IDs. Preserve normalized selection gaps in the analysis.
22
+
23
+ Media paths are runtime-relative and confined to that directory. Local video
24
+ and frames have exact `artifact_sha256` entries and `visual_preparation` proof
25
+ from `prepare-visual-evidence.py`. A provider `media_url` is distinct from its
26
+ `cover_url`; a cover cannot establish the video's opening. Validation checks
27
+ file hashes and provider-media provenance, not just path existence.
28
+
29
+ Every comment has a stable `comment_id`, derived from its provider ID or exact
30
+ text hash. Do not hand-edit normalized data or invent identities.
31
+
32
+ ## Analysis evidence-v5
33
+
34
+ Write `analysis.json` using the actual normalized file hash:
35
+
36
+ ```json
37
+ {
38
+ "schema_version": 1,
39
+ "analysis_contract_version": "evidence-v5",
40
+ "source_normalized_sha256": "<sha256>",
41
+ "generated_at": "2026-11-03T12:15:00Z",
42
+ "summary": "Answer to the scoped question, with the main limitation",
43
+ "videos": [
44
+ {
45
+ "observation_id": "tiktok:123",
46
+ "url": "https://www.tiktok.com/@example/video/123",
47
+ "message": {
48
+ "status": "observed",
49
+ "modality": "caption",
50
+ "text": "The caption presents a product workflow",
51
+ "evidence_refs": ["caption"]
52
+ }
53
+ }
54
+ ],
55
+ "synthesis": {
56
+ "findings": [
57
+ {
58
+ "text": "A source-grounded finding, not an inferred performance cause",
59
+ "supporting_evidence_refs": ["tiktok:123#message"]
60
+ }
61
+ ],
62
+ "adaptations": [
63
+ {
64
+ "name": "An adaptation for this product",
65
+ "text": "The proposed treatment, separate from the source observation",
66
+ "reason": "Why the observed mechanism fits the question and available assets",
67
+ "source_observation_ids": ["tiktok:123"]
68
+ }
69
+ ]
70
+ },
71
+ "evidence_gaps": ["Media was unavailable; no visual-opening claim is made"]
72
+ }
73
+ ```
74
+
75
+ `summary`, `videos`, `synthesis` and `evidence_gaps` are required. Findings and
76
+ adaptations may be empty. Include the selected observations actually analyzed;
77
+ omitted selected observations make coverage partial. Unknown or duplicate IDs
78
+ and mismatched URLs/hashes are errors, not evidence gaps.
79
+
80
+ ### Optional analytical fields
81
+
82
+ Use only fields relevant to the question and supported by evidence:
83
+
84
+ | Field | Shape and evidence |
85
+ | --- | --- |
86
+ | `thumb_stop` | `status`, `text`, `evidence_refs`; observed opening requires inspected frames. |
87
+ | `hook` | Same plus `modality: visual|verbal|mixed`; frames for visual, transcript for verbal, both for mixed. |
88
+ | `format`, `message`, `cta` | Same with `modality: visual|verbal|mixed|caption`; describe only what that modality establishes. A caption may describe a format but cannot prove unseen execution. |
89
+ | `proof_reference` | `status`, `claim`, `mechanism`, `evidence_refs`; preserve a source's attributed claim rather than endorsing it. |
90
+ | `sound` | Source `id`, `name`, `author` when present; no age-derived lifecycle label. |
91
+ | `comment_analysis` | Entries with actual `comment_id`, `relevance: relevant|uncertain|irrelevant`, `reason`; nonempty `insight` only for relevant comments. |
92
+
93
+ An unavailable axis has `status: unavailable`, empty text (or claim/mechanism),
94
+ and no refs. Alternatively omit an unused axis. There is no seven-axis quota,
95
+ required comment count, creative count or impact score.
96
+
97
+ When a canonical per-video media receipt exists, attach its
98
+ `multimodal_receipt_sha256` even when using only its source caption. Frame refs
99
+ must appear in it; `transcript` must be available
100
+ and hash-bound. The validator checks the current frames/transcript and rejects
101
+ forged or stale proof. Caption-only analysis does not need a media receipt.
102
+ Preserve the receipt's exact analysis gaps in `evidence_gaps`. The literal
103
+ `caption` reference is valid for a source caption, not speech or visual content.
104
+ A source proof remains independently unverified unless separate
105
+ evidence establishes it.
106
+
107
+ Findings cite `<observation_id>#<axis>` for an observed axis, or the source's
108
+ `metrics`, `caption`, `sound`, or `comment:<comment_id>` evidence. References
109
+ must exist; a convenient reference does not by itself justify a conclusion.
110
+ Adaptations cite real analyzed source IDs and explain the relevance in `reason`.
111
+ Source links and quoted audience comments are resolved from canonical IDs.
112
+
113
+ ## Generated outputs and coverage
114
+
115
+ `render-result.py` produces a readable section body in `result.md`, including
116
+ findings, adaptations, source evidence and limitations. Do not expose provider
117
+ handles, raw receipt internals or model usage as founder-facing explanation.
118
+ PMR supplies its own enclosing heading; direct use can present the same body.
119
+
120
+ `finalize-receipt.py` validates and seals context, raw manifest, normalized data,
121
+ analysis and rendered result with hashes. Its `coverage` contains:
122
+
123
+ - `status: complete|partial|no_data`;
124
+ - `collected_count`, `selected_count`, `analyzed_count`;
125
+ - `gaps`, including sampling and missing evidence.
126
+
127
+ Receipt `status` is respectively `completed`, `partial` or `no_data`. A no-data
128
+ collection can explain that successful collection returned no observations. A partial
129
+ collection can still be useful; neither should be rewritten as full coverage by
130
+ a consumer. Terminal provider failures can be reported alongside valid successful
131
+ datasets with the exact gap `Provider collection <key> ended with <STATUS>.`.
132
+ No successful dataset, corrupt hashes, unsupported claims, and running or
133
+ uncertain provider operations remain validation failures, not no-data evidence.
@@ -0,0 +1,169 @@
1
+ # Provider contract
2
+
3
+ ## Boundary
4
+
5
+ Call Apify only through:
6
+
7
+ ```text
8
+ GET $OS_URL/scrape/apify/actors/{actor_id}
9
+ POST $OS_URL/scrape/apify/run
10
+ GET $OS_URL/scrape/apify/runs/{run_id}
11
+ GET $OS_URL/scrape/apify/datasets/{dataset_id}?limit={bounded_limit}
12
+ ```
13
+
14
+ Authenticate with `Authorization: Bearer $OS_API_KEY`. Use asynchronous runs
15
+ and a stable `Idempotency-Key` derived from the context hash, collection epoch,
16
+ logical run key, actor ID, and actor-input hash. Record the returned run and
17
+ dataset IDs before polling.
18
+
19
+ The idempotency header identifies one logical start but is not a local
20
+ exactly-once guarantee. If the initial POST succeeds upstream and its response
21
+ is lost before `run_id` is persisted, this skill cannot prove locally whether a
22
+ run exists; retry safety then depends on durable gateway/upstream idempotency.
23
+ The runner persists the exact request and attempt before POST. A retry with no
24
+ handle replays only that saved request/key through the gateway's durable
25
+ submission record; pending reconciliation must not be bypassed with a new key.
26
+
27
+ `scripts/build-provider-inputs.py` is the only actor-input adapter. It emits the
28
+ exact keys in `apify-inputs-v1`, which were verified against the current public
29
+ actor contracts. `scripts/run-apify.py` rejects missing or extra keys and saves
30
+ a hash-bound actor-details snapshot before a paid start. Actor-details metadata
31
+ is provenance, not a promise of a machine-readable input schema; when an actor
32
+ contract changes, update and version the adapter rather than asking the agent
33
+ to guess fields.
34
+
35
+ ## Actors and bounded run plan
36
+
37
+ - TikTok: `clockworks/tiktok-scraper`
38
+ - Instagram Reels: `apify/instagram-reel-scraper`
39
+
40
+ Use at most four logical runs:
41
+
42
+ 1. `tiktok-discovery`: the bounded requested TikTok accounts and recent videos.
43
+ 2. `instagram-discovery`: the bounded requested Instagram accounts and recent Reels.
44
+ 3. `tiktok-enrichment`: selected TikTok URLs, with video,
45
+ transcript/subtitles, and up to 20 comments.
46
+ 4. `instagram-enrichment`: selected Reel URLs, with downloaded video,
47
+ transcript, and shares where the actor exposes them.
48
+
49
+ These four keys and actor/platform/kind combinations are enforced by
50
+ `scripts/run-apify.py`; arbitrary keys or actors fail before a paid run starts.
51
+ `raw/manifest.json` and `receipt.json` retain each `logical_key`, allow no more
52
+ than four entries, and reject duplicate logical keys, run IDs, or dataset IDs.
53
+ Discovery is required for every platform with declared accounts. Enrichment is
54
+ optional: request it only when additional evidence is needed for the scoped
55
+ question, within the authorized collection budget. Discovery-only evidence can
56
+ answer a caption or metric question without another paid call. If needed comments,
57
+ transcript or visual evidence remain unavailable, disclose that gap instead of
58
+ claiming complete coverage of the question.
59
+
60
+ A terminal failed run can be disclosed as partial coverage alongside valid
61
+ successful datasets. Missing required discovery, or any running/uncertain saved
62
+ handle, blocks sealing. Once enrichment has started, preserve and settle its
63
+ handle too; optional does not mean it can disappear from the record.
64
+
65
+ The v1 adapter supports at most six account records total, 1–30 discovery results
66
+ per account, and 30 enrichment URLs total across both platforms. These are
67
+ execution limits, not evidence sufficiency rules.
68
+ Set the requested sample to fit the task and paid-call budget; disclose sampling
69
+ gaps. There is no required number of examples per account or quality score.
70
+
71
+ Do not start discovery without declared accounts or enrichment without frozen
72
+ selected observations. Batch the applicable accounts or selected URLs for a
73
+ platform into its one logical run. Cap actor results and dataset reads; enrichment
74
+ uses the frozen selection rather than silently replacing it with new examples.
75
+
76
+ The versioned actor-input builder accepts only the current fields needed for:
77
+
78
+ - TikTok discovery by profile and enrichment by post URL;
79
+ - TikTok video/cover downloads, subtitles or transcript, and comments;
80
+ - Instagram Reels discovery by usernames/profile URLs and enrichment by Reel
81
+ URLs;
82
+ - Instagram transcript, downloaded video, and shares when the actor
83
+ exposes them.
84
+
85
+ The exact input JSON is saved under `raw/`; `run-state.json` binds its path,
86
+ hash, contract version, sorted key list, and actor-metadata snapshot.
87
+
88
+ The context's `collection` parameters default to 30 results per account and a
89
+ 60-day lookback. The builder can revise previews before submission, but the
90
+ runner fixes the actual lower date at the first POST attempt and preserves it
91
+ on resume. Both actors support a lower date; this adapter does not promise an
92
+ identical arbitrary provider start/end interval. See the official
93
+ [TikTok input schema](https://apify.com/clockworks/tiktok-scraper/input-schema) and
94
+ [Reels input schema](https://apify.com/apify/instagram-reel-scraper/input-schema).
95
+ TikTok's date filter is a charged option: changing result count alone is not a
96
+ complete price estimate. Dataset `--dataset-limit` bounds retrieval, not paid
97
+ collection.
98
+
99
+ The current TikTok actor exposes requested comments through each video's
100
+ `commentsDatasetURL`, not necessarily inline. `run-apify.py` resolves those
101
+ dataset IDs, reads them through OS, and stores the exact linked responses in
102
+ `raw/tiktok-enrichment-comments.json`. This is a secondary dataset read under
103
+ the existing TikTok enrichment run, not a fifth actor run. The actor shares one
104
+ comments dataset across all videos of the run, so it is read with the run's
105
+ `--dataset-limit`. The gateway grants that dataset only after the run's own
106
+ video dataset was read through OS. `run-apify.py` reads it before the comments,
107
+ and a retry from saved output reads it again so a failed grant is retried.
108
+ Normalization must not claim TikTok comment coverage unless that hash-bound
109
+ bundle was processed.
110
+
111
+ ## Raw evidence
112
+
113
+ Save every OS response as a raw JSON file before normalization. Preserve actor
114
+ ID, run ID, dataset ID, collection time, input hash, and raw-file hash. Do not
115
+ strip provider fields before the raw file is persisted.
116
+
117
+ Continue polling transitional `READY`, `RUNNING`, `TIMING-OUT`, and `ABORTING`
118
+ states. Treat only final `FAILED`, `ABORTED`, `TIMED-OUT`, or `TIMED_OUT` states
119
+ as terminal failures eligible for the explicit restart flow below.
120
+
121
+ If a run fails, preserve its terminal status. Successful datasets may still
122
+ support a partial result; record the exact gap
123
+ `Provider collection <key> ended with <STATUS>.` in the analysis. If no dataset
124
+ was successfully collected, report a collection failure, not no-data research.
125
+ Do not replace missing evidence with generic web search, another actor, a direct
126
+ provider API, or invented observations. Discovery may use OS web search to
127
+ locate public account handles and canonical profile URLs; it is not substitute
128
+ trend evidence.
129
+
130
+ A normal provider retry keeps the saved terminal failure; it cannot silently
131
+ spend on a replacement run. After inspecting the failure, explicitly
132
+ start a clean collection epoch with the exact failed handle:
133
+
134
+ ```bash
135
+ python3 "$ORGANIC_TREND_SKILL_ROOT/scripts/run-state.py" \
136
+ --runtime-root "$RUNTIME_ROOT" restart-failed-collection \
137
+ --key "$FAILED_LOGICAL_KEY" --run-id "$FAILED_RUN_ID"
138
+ ```
139
+
140
+ The command refuses an active/successful or mismatched handle, archives the
141
+ whole failed collection, and resets every provider-derived step before any new
142
+ paid call.
143
+
144
+ ## Media evidence
145
+
146
+ When audiovisual evidence is needed, run `scripts/prepare-visual-evidence.py` for
147
+ the selected observations to inspect that have a provider `media_url`. It downloads
148
+ the media into the runtime root and extracts dense opening frames at approximately 0.0, 0.5, 1.5,
149
+ 3.0, and 5.0 seconds plus middle, later, and ending samples when duration is
150
+ known. The canonical OS multimodal analyzer inspects those frames before the
151
+ analysis is written. A transcript can support spoken words but cannot establish
152
+ what appeared on screen.
153
+
154
+ Only `prepare-visual-evidence.py` may establish local visual evidence for this
155
+ workflow. It binds the provider media URL, downloaded video, fixed frame
156
+ samples, and their hashes. The default aggregate downloaded-media budget is 1
157
+ GiB across the collection; an individual video remains capped at 250 MiB.
158
+
159
+ If media cannot be retrieved or inspected, set the visual fields to
160
+ `unavailable` and record the evidence gap. Never turn a caption, cover, metric,
161
+ or transcript into an observed visual claim.
162
+
163
+ ## Freshness and cache
164
+
165
+ Reuse matching successful runs on retry without changing collection times.
166
+ Assess whether the evidence is recent enough for the question; age alone does
167
+ not authorize spending on another collection. An explicitly requested refresh
168
+ archives the previous epoch and uses new idempotency keys. `init` never does this
169
+ silently, and active/uncertain starts must be resolved before refresh.
@@ -0,0 +1,204 @@
1
+ # Runtime contract
2
+
3
+ ## Ownership
4
+
5
+ Direct use initializes `context.json` from the assignment; a research caller may
6
+ supply it instead. This skill owns collection, analysis and receipt files.
7
+ PMR additionally owns its combined report and integration receipt.
8
+
9
+ All paths below are relative to the workspace:
10
+
11
+ ```text
12
+ egbe-docs/research/market/work/organic_trend_watch/
13
+ ├── context.json
14
+ ├── run-state.json
15
+ ├── raw/
16
+ │ ├── manifest.json
17
+ │ ├── tiktok-enrichment-comments.json
18
+ │ └── *.json
19
+ ├── media/
20
+ │ └── *.mp4
21
+ ├── frames/
22
+ │ └── *.jpg
23
+ ├── visual-analysis/
24
+ │ └── <observation-id-and-hash>.json
25
+ ├── normalized/
26
+ │ ├── selection.json
27
+ │ └── videos.json
28
+ ├── analysis.json
29
+ ├── result.md
30
+ └── receipt.json
31
+ ```
32
+
33
+ Never write outside this root. Every path stored in JSON is relative to this
34
+ root, uses `/`, and must not contain `..`.
35
+
36
+ Each `visual-analysis/*.json` receipt is bound to the ordered frame paths and
37
+ hashes, optional transcript hash, Organic visual-analysis instructions, OS
38
+ prompt contract, model role, and effective model. A valid completed receipt is
39
+ reused after a task retry or follow-up. A receipt with `status: unavailable` contains
40
+ no claims and records that neither frames nor a transcript were available.
41
+
42
+ ## Context v1
43
+
44
+ ```json
45
+ {
46
+ "schema_version": 1,
47
+ "section_id": "organic_trend_watch",
48
+ "assignment": "What the collected short-video evidence should help answer",
49
+ "product_context": "Relevant product, audience and constraints",
50
+ "collection": {"discovery_limit_per_account": 30, "lookback_days": 60},
51
+ "supporting_sections": [
52
+ {"id": "target_audience", "label": "Target audience", "content": "..."}
53
+ ],
54
+ "sources": {
55
+ "context": {"path": "egbe-docs/research/market/context.md", "source_sha256": "..."},
56
+ "supporting_sections": [
57
+ {"id": "target_audience", "path": "...", "source_sha256": "..."}
58
+ ]
59
+ }
60
+ }
61
+ ```
62
+
63
+ Only `schema_version`, `section_id`, `assignment` and `product_context` are
64
+ required. `supporting_sections` may contain relevant supplied evidence with
65
+ unique IDs; no PMR section is prerequisite. `sources` is optional; supplied
66
+ source paths/hashes identify their provenance, and supporting source IDs must
67
+ match their content entries. PMR verifies those local files/receipts against its
68
+ workspace before publishing; direct callers are responsible for the provenance
69
+ of supplied context. The runtime binds the exact context hash.
70
+ Do not use failed, stale or tampered receipts as completed research.
71
+
72
+ Optional `max_analysis_videos` can lower the default 30-video resource ceiling
73
+ for the v1 enrichment adapter. This is not a research quality threshold.
74
+ Selection records exclusions so a capped sample is not complete coverage.
75
+
76
+ Optional `collection` configures paid discovery: `discovery_limit_per_account`
77
+ is an integer from 1 to 30; `lookback_days` is a positive integer. Omitted fields
78
+ default to 30 and 60. These adjustable adapter defaults are not evidence
79
+ sufficiency criteria. Account/run limits, the total analysis cap and the dataset
80
+ read limit remain independent. Direct and PMR callers use this same context.
81
+
82
+ ## Run state v1
83
+
84
+ Use `scripts/run-state.py` rather than editing this file directly. Steps are:
85
+
86
+ 1. `discovery`
87
+ 2. `collection`
88
+ 3. `normalization`
89
+ 4. `visual_analysis`
90
+ 5. `synthesis`
91
+ 6. `render`
92
+
93
+ Each step is `pending`, `running`, `completed`, or `failed`. Provider runs are
94
+ keyed by a stable logical key such as `tiktok-discovery`; the key and input hash
95
+ identify retry intent. Immediately before the first POST, the runner saves
96
+ `collection_window` (effective parameters, `reference_at`, `oldest_post_date`),
97
+ the exact actor input and each run's `request_json`, `attempted_at`, and stable
98
+ idempotency key. Initialization and input previews do not start collection.
99
+ The date lower bound is UTC midnight `lookback_days` before the first attempt;
100
+ the analytical upper bound is its exact `reference_at`. Both platforms request
101
+ the fixed lower date; local normalization enforces the full analytical window.
102
+
103
+ Persist `run_id` and `dataset_id` immediately after the response, before polling.
104
+ After any attempted submission, the builder preserves its input bytes or rejects
105
+ a conflict. Missing responses/handles retain `SUBMITTING` state. A retry may ask
106
+ the gateway to recover the same saved key/request; it never creates a replacement
107
+ operation. A gateway reconciliation error needs inspection, not a new key. This
108
+ is not an exactly-once guarantee for the external provider.
109
+
110
+ `run-state.py init` never discards existing collection because of age or a
111
+ changed context. Resume unchanged work; use a new study ID for a different
112
+ assignment. When a fresh collection is explicitly needed, `run-state.py refresh`
113
+ archives finished or terminal work and creates a new `collection_epoch` for
114
+ idempotency. It refuses active or uncertain provider starts. The narrower
115
+ `restart-failed-collection --key ... --run-id ...` flow validates the exact
116
+ terminal failure before archiving; see `provider-contract.md`. Preserve original
117
+ collection times so old evidence is not relabeled as fresh.
118
+
119
+ ## Raw manifest v1
120
+
121
+ ```json
122
+ {
123
+ "schema_version": 1,
124
+ "collection_epoch": "opaque-run-epoch",
125
+ "collection_started_at": "2026-07-31T12:00:00Z",
126
+ "collection_completed_at": "2026-07-31T12:10:00Z",
127
+ "accounts": [
128
+ {
129
+ "platform": "tiktok",
130
+ "handle": "example",
131
+ "account_type": "official",
132
+ "product_keywords": ["product"]
133
+ }
134
+ ],
135
+ "accounts_source": {
136
+ "path": "raw/accounts.json",
137
+ "sha256": "..."
138
+ },
139
+ "datasets": [
140
+ {
141
+ "platform": "tiktok",
142
+ "kind": "discovery",
143
+ "path": "raw/tiktok-discovery.json",
144
+ "sha256": "..."
145
+ }
146
+ ],
147
+ "linked_datasets": [
148
+ {
149
+ "kind": "tiktok-comments",
150
+ "parent_logical_key": "tiktok-enrichment",
151
+ "path": "raw/tiktok-enrichment-comments.json",
152
+ "sha256": "..."
153
+ }
154
+ ],
155
+ "provider_runs": [
156
+ {
157
+ "logical_key": "tiktok-discovery",
158
+ "provider": "apify",
159
+ "actor_id": "clockworks/tiktok-scraper",
160
+ "run_id": "...",
161
+ "dataset_id": "...",
162
+ "status": "SUCCEEDED",
163
+ "input_sha256": "...",
164
+ "input_contract_version": "apify-inputs-v1",
165
+ "input_keys": ["oldestPostDateUnified", "profileSorting", "profiles", "resultsPerPage"],
166
+ "actor_metadata": {
167
+ "path": "raw/tiktok-discovery-actor-metadata.json",
168
+ "sha256": "..."
169
+ }
170
+ }
171
+ ]
172
+ }
173
+ ```
174
+
175
+ Allowed account types are `official`, `shadow`, `partner`,
176
+ `shadow-or-partner`, and `viral` (an independent high-performing account in the
177
+ same problem/category space). A dataset file may contain an OS envelope
178
+ (`data.rows`), a provider object with `items`, or a raw JSON array. Its declared
179
+ hash must match.
180
+
181
+ The manifest contains at most six accounts in v1. Its collection epoch and
182
+ provider handles, inputs, actor metadata, and raw hashes must match
183
+ `run-state.json` exactly. Discovery applies to each declared account platform;
184
+ enrichment is optional according to the question's evidence needs. A discovery-only
185
+ result is valid without inventing enrichment receipts. Terminal failures may be
186
+ explicit coverage gaps; no started run may disappear silently. Successful
187
+ TikTok enrichment also requires the hash-bound linked-comments bundle, even
188
+ when the actor exposed no comment dataset URLs.
189
+
190
+ ## Receipt v1
191
+
192
+ `scripts/finalize-receipt.py` creates the receipt only after validating all
193
+ artifacts. It binds the collection epoch and exact context, raw manifest, normalized observations,
194
+ analysis, and rendered Markdown by SHA-256. `collected_at` equals the manifest's
195
+ `collection_completed_at`; `completed_at` cannot precede it. At least one
196
+ successful collected Apify dataset is required. Required discovery and any started
197
+ enrichment must be successful or a recorded terminal failure; running/unknown
198
+ handles block sealing. Needed but unavailable modalities remain coverage gaps,
199
+ not permission to infer them from captions or counts.
200
+
201
+ `status` is `completed`, `partial` or `no_data`. `coverage` records the matching
202
+ `complete`, `partial` or `no_data` status, collected/selected/analyzed counts and
203
+ gaps. Limited or absent usable evidence is a valid result, distinct from a
204
+ corrupt receipt or an unfinished/uncertain provider call. See `output-contract.md`.
@@ -0,0 +1,17 @@
1
+ Inspect the supplied chronological frame samples and optional transcript as
2
+ evidence for short-form video research.
3
+
4
+ - Describe literal visible subjects, actions, composition, cuts represented by
5
+ the samples, and exact on-screen text. Do not infer motion between samples.
6
+ - Identify what the available samples establish in the first 0–1.5 seconds and
7
+ across the 0–5 second opening. Keep visual and spoken evidence distinct.
8
+ - Capture observed format cues, explicit calls to action, paid-amplification
9
+ cues, and concrete source proof such as a demonstration, benchmark, ranking,
10
+ authority statement, or named result.
11
+ - Preserve useful source phrasing as attributed evidence. Do not transfer a
12
+ source's result, dataset, ranking, customer proof, or product capability to
13
+ the founder's product.
14
+ - Use the transcript only for spoken evidence. A caption, metric, cover image,
15
+ or filename is not visual or verbal evidence.
16
+ - State gaps when the samples cannot establish an opening, format, claim,
17
+ sequence, or spoken message.