@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,343 @@
1
+ #!/usr/bin/env python3
2
+ """Persist, resume, and materialize one OS Research section."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import hashlib
7
+ import json
8
+ import os
9
+ import tempfile
10
+ from pathlib import Path
11
+ from typing import Any, Callable
12
+
13
+
14
+ def _sha256(value: str) -> str:
15
+ return hashlib.sha256(value.encode("utf-8")).hexdigest()
16
+
17
+
18
+ def _file_sha256(path: Path) -> str:
19
+ digest = hashlib.sha256()
20
+ with path.open("rb") as handle:
21
+ for chunk in iter(lambda: handle.read(64 * 1024), b""):
22
+ digest.update(chunk)
23
+ return digest.hexdigest()
24
+
25
+
26
+ def _relative(path: Path, workspace: Path) -> str:
27
+ try:
28
+ return path.resolve().relative_to(workspace.resolve()).as_posix()
29
+ except ValueError as exc:
30
+ raise ValueError(f"runtime path must be inside workspace: {path}") from exc
31
+
32
+
33
+ def _read_state(path: Path) -> dict[str, Any] | None:
34
+ try:
35
+ value = json.loads(path.read_text(encoding="utf-8"))
36
+ except (OSError, json.JSONDecodeError, UnicodeDecodeError):
37
+ return None
38
+ return value if isinstance(value, dict) else None
39
+
40
+
41
+ def _write_state(path: Path, payload: dict[str, Any]) -> None:
42
+ path.parent.mkdir(parents=True, exist_ok=True)
43
+ temporary_path: Path | None = None
44
+ try:
45
+ with tempfile.NamedTemporaryFile(
46
+ mode="w",
47
+ encoding="utf-8",
48
+ newline="\n",
49
+ dir=path.parent,
50
+ prefix=f".{path.name}.",
51
+ suffix=".tmp",
52
+ delete=False,
53
+ ) as handle:
54
+ json.dump(payload, handle, indent=2, sort_keys=True)
55
+ handle.write("\n")
56
+ handle.flush()
57
+ os.fsync(handle.fileno())
58
+ temporary_path = Path(handle.name)
59
+ os.chmod(temporary_path, 0o600)
60
+ os.replace(temporary_path, path)
61
+ temporary_path = None
62
+ finally:
63
+ if temporary_path is not None:
64
+ temporary_path.unlink(missing_ok=True)
65
+
66
+
67
+ def _state_payload(
68
+ *,
69
+ schema_version: int,
70
+ status: str,
71
+ query_sha256: str,
72
+ system_prompt_sha256: str,
73
+ result_path: str,
74
+ job_id: str = "",
75
+ submission_attempt: int = 0,
76
+ next_submission_attempt: int | None = None,
77
+ result_sha256: str = "",
78
+ execution_revision: str = "",
79
+ error: str = "",
80
+ resume_safe: bool | None = None,
81
+ input_provenance_sha256: str = "",
82
+ ) -> dict[str, Any]:
83
+ payload: dict[str, Any] = {
84
+ "schema_version": schema_version,
85
+ "status": status,
86
+ "job_id": job_id or None,
87
+ "submission_attempt": submission_attempt,
88
+ "query_sha256": query_sha256,
89
+ "system_prompt_sha256": system_prompt_sha256,
90
+ "result_path": result_path,
91
+ "result_sha256": result_sha256 or None,
92
+ "execution_revision": execution_revision or None,
93
+ "error": error or None,
94
+ }
95
+ if next_submission_attempt is not None:
96
+ payload["next_submission_attempt"] = next_submission_attempt
97
+ if resume_safe is not None:
98
+ payload["resume_safe"] = resume_safe
99
+ if input_provenance_sha256:
100
+ payload["input_provenance_sha256"] = input_provenance_sha256
101
+ return payload
102
+
103
+
104
+ def _matches_inputs(
105
+ state: dict[str, Any] | None,
106
+ *,
107
+ schema_version: int,
108
+ query_sha256: str,
109
+ system_prompt_sha256: str,
110
+ result_path: str,
111
+ ) -> bool:
112
+ return bool(
113
+ state
114
+ and state.get("schema_version") == schema_version
115
+ and state.get("query_sha256") == query_sha256
116
+ and state.get("system_prompt_sha256") == system_prompt_sha256
117
+ and state.get("result_path") == result_path
118
+ )
119
+
120
+
121
+ def _completed_result_available(
122
+ state: dict[str, Any] | None,
123
+ *,
124
+ result_file: Path,
125
+ schema_version: int,
126
+ query_sha256: str,
127
+ system_prompt_sha256: str,
128
+ result_path: str,
129
+ ) -> bool:
130
+ if not _matches_inputs(
131
+ state,
132
+ schema_version=schema_version,
133
+ query_sha256=query_sha256,
134
+ system_prompt_sha256=system_prompt_sha256,
135
+ result_path=result_path,
136
+ ) or state.get("status") != "completed":
137
+ return False
138
+ if not str(state.get("job_id") or "").strip():
139
+ return False
140
+ expected_hash = str(state.get("result_sha256") or "")
141
+ try:
142
+ return bool(expected_hash) and _file_sha256(result_file) == expected_hash
143
+ except OSError:
144
+ return False
145
+
146
+
147
+ def require_matching_inputs(request_file: Path, *, query: str, system_prompt: str,
148
+ schema_version: int, result_path: str,
149
+ input_provenance_sha256: str = "") -> None:
150
+ """Preserve prior requests/evidence rather than silently replacing paid work."""
151
+ state = _read_state(request_file)
152
+ if request_file.exists() and state is None:
153
+ raise ValueError("research request state is unreadable; preserve and inspect it before retrying")
154
+ if state and not _matches_inputs(state, schema_version=schema_version,
155
+ query_sha256=_sha256(query), system_prompt_sha256=_sha256(system_prompt),
156
+ result_path=result_path):
157
+ raise ValueError("research inputs changed; existing evidence is preserved. Use a new research ID for a new assignment; do not automatically repeat paid work")
158
+ if state and input_provenance_sha256 and state.get("input_provenance_sha256") != input_provenance_sha256:
159
+ raise ValueError("Saved research input provenance is missing or damaged; do not start new paid work")
160
+
161
+
162
+ def _attempt_for_state(state: dict[str, Any] | None, *, matching: bool) -> int:
163
+ if not matching or state is None:
164
+ return 0
165
+ if state.get("status") == "failed" and state.get("resume_safe") is not True:
166
+ value = state.get("next_submission_attempt")
167
+ if isinstance(value, int) and not isinstance(value, bool) and value >= 0:
168
+ return value
169
+ current = state.get("submission_attempt")
170
+ return (
171
+ current + 1
172
+ if isinstance(current, int)
173
+ and not isinstance(current, bool)
174
+ and current >= 0
175
+ else 1
176
+ )
177
+ current = state.get("submission_attempt")
178
+ return (
179
+ current
180
+ if isinstance(current, int)
181
+ and not isinstance(current, bool)
182
+ and current >= 0
183
+ else 0
184
+ )
185
+
186
+
187
+ def run_resumable_section(
188
+ workspace: Path,
189
+ *,
190
+ query: str,
191
+ system_prompt: str,
192
+ section_heading: str,
193
+ request_file: Path,
194
+ result_file: Path,
195
+ report_file: Path,
196
+ schema_version: int,
197
+ execute_research: Callable[..., Any],
198
+ materialize: Callable[[Path, str, str], Any],
199
+ input_provenance_sha256: str = "",
200
+ ) -> dict[str, Any]:
201
+ """Run one section or reuse its matching completed OS Research result."""
202
+
203
+ workspace = workspace.resolve()
204
+ relative_result = _relative(result_file, workspace)
205
+ require_matching_inputs(request_file, query=query, system_prompt=system_prompt,
206
+ schema_version=schema_version, result_path=relative_result,
207
+ input_provenance_sha256=input_provenance_sha256)
208
+ query_hash = _sha256(query)
209
+ prompt_hash = _sha256(system_prompt)
210
+ state = _read_state(request_file)
211
+ matching = _matches_inputs(
212
+ state,
213
+ schema_version=schema_version,
214
+ query_sha256=query_hash,
215
+ system_prompt_sha256=prompt_hash,
216
+ result_path=relative_result,
217
+ )
218
+ reused = _completed_result_available(
219
+ state,
220
+ result_file=result_file,
221
+ schema_version=schema_version,
222
+ query_sha256=query_hash,
223
+ system_prompt_sha256=prompt_hash,
224
+ result_path=relative_result,
225
+ )
226
+
227
+ if (
228
+ not reused
229
+ and matching
230
+ and (state or {}).get("status") == "failed"
231
+ and (state or {}).get("truncation_retry_exhausted") is True
232
+ ):
233
+ raise ValueError(
234
+ "research response truncation retry limit is exhausted for these inputs"
235
+ )
236
+
237
+ if not reused:
238
+ resume_job_id = ""
239
+ if matching and (
240
+ state.get("status") == "running"
241
+ or (
242
+ state.get("status") == "failed"
243
+ and state.get("resume_safe") is True
244
+ )
245
+ ):
246
+ resume_job_id = str(state.get("job_id") or "").strip()
247
+
248
+ submission_attempt = _attempt_for_state(state, matching=matching)
249
+ job_id = resume_job_id
250
+
251
+ def mark_running(value: str) -> None:
252
+ nonlocal job_id
253
+ job_id = value
254
+ _write_state(
255
+ request_file,
256
+ _state_payload(
257
+ schema_version=schema_version,
258
+ status="running",
259
+ query_sha256=query_hash,
260
+ system_prompt_sha256=prompt_hash,
261
+ result_path=relative_result,
262
+ job_id=value,
263
+ submission_attempt=submission_attempt,
264
+ input_provenance_sha256=input_provenance_sha256,
265
+ ),
266
+ )
267
+
268
+ _write_state(
269
+ request_file,
270
+ _state_payload(
271
+ schema_version=schema_version,
272
+ status="running" if resume_job_id else "submitting",
273
+ query_sha256=query_hash,
274
+ system_prompt_sha256=prompt_hash,
275
+ result_path=relative_result,
276
+ job_id=resume_job_id,
277
+ submission_attempt=submission_attempt,
278
+ input_provenance_sha256=input_provenance_sha256,
279
+ ),
280
+ )
281
+ try:
282
+ result = execute_research(
283
+ output=result_file,
284
+ on_submitted=mark_running,
285
+ resume_job_id=resume_job_id,
286
+ submission_attempt=submission_attempt,
287
+ )
288
+ job_id = str(result.job_id or job_id).strip()
289
+ if not job_id:
290
+ raise ValueError("OS Research returned no job id")
291
+ result_hash = _file_sha256(result_file)
292
+ execution_revision = str(
293
+ getattr(result, "model_roles_revision", "") or ""
294
+ ).strip()
295
+ except (OSError, RuntimeError, UnicodeError, ValueError) as exc:
296
+ declared_resume_safe = getattr(exc, "resume_safe", None)
297
+ # An uncertain POST may have been accepted without returning its ID.
298
+ # Preserve its attempt/key so a repeated POST recovers that same job.
299
+ resume_safe = bool(job_id) if declared_resume_safe is None else bool(declared_resume_safe)
300
+ _write_state(
301
+ request_file,
302
+ _state_payload(
303
+ schema_version=schema_version,
304
+ status="failed",
305
+ query_sha256=query_hash,
306
+ system_prompt_sha256=prompt_hash,
307
+ result_path=relative_result,
308
+ job_id=job_id,
309
+ submission_attempt=submission_attempt,
310
+ next_submission_attempt=(
311
+ submission_attempt if resume_safe else submission_attempt + 1
312
+ ),
313
+ error=str(exc),
314
+ resume_safe=resume_safe,
315
+ input_provenance_sha256=input_provenance_sha256,
316
+ ),
317
+ )
318
+ raise
319
+ _write_state(
320
+ request_file,
321
+ _state_payload(
322
+ schema_version=schema_version,
323
+ status="completed",
324
+ query_sha256=query_hash,
325
+ system_prompt_sha256=prompt_hash,
326
+ result_path=relative_result,
327
+ job_id=job_id,
328
+ submission_attempt=submission_attempt,
329
+ result_sha256=result_hash,
330
+ execution_revision=execution_revision,
331
+ input_provenance_sha256=input_provenance_sha256,
332
+ ),
333
+ )
334
+ state = _read_state(request_file)
335
+
336
+ content = result_file.read_text(encoding="utf-8")
337
+ materialize(report_file, section_heading, content)
338
+ return {
339
+ "job_id": str((state or {}).get("job_id") or ""),
340
+ "result_path": relative_result,
341
+ "report_path": _relative(report_file, workspace),
342
+ "reused": reused,
343
+ }
@@ -0,0 +1,288 @@
1
+ #!/usr/bin/env python3
2
+ """Build and execute one configured OS Research section workflow."""
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 importlib.util
14
+ import json
15
+ import os
16
+ import re
17
+ import sys
18
+ from dataclasses import dataclass
19
+ from pathlib import Path
20
+ from types import ModuleType
21
+ from typing import Any, Callable
22
+
23
+
24
+ SCHEMA_VERSION = 3
25
+ REPORT_PATH = Path(_artifact_path("egbe-docs/research/market/full-report.md"))
26
+
27
+
28
+ @dataclass(frozen=True)
29
+ class SectionWorkflowSpec:
30
+ section_id: str
31
+ section_heading: str
32
+ display_name: str
33
+ system_prompt_filename: str
34
+ user_prompt_filename: str
35
+ supporting_section_ids: tuple[str, ...] = ()
36
+
37
+ def validate(self) -> None:
38
+ if not re.fullmatch(r"[a-z0-9_]+", self.section_id):
39
+ raise ValueError("research section id must use lowercase snake_case")
40
+ if not self.section_heading.strip() or not self.display_name.strip():
41
+ raise ValueError("research section heading and display name are required")
42
+ for prompt_kind, prompt_filename in (
43
+ ("system", self.system_prompt_filename),
44
+ ("user", self.user_prompt_filename),
45
+ ):
46
+ prompt_path = Path(prompt_filename)
47
+ if prompt_path.name != prompt_filename or prompt_path.suffix != ".md":
48
+ raise ValueError(
49
+ f"research {prompt_kind} prompt must be one Markdown filename"
50
+ )
51
+ if self.user_prompt_filename == self.system_prompt_filename:
52
+ raise ValueError("research user and system prompts must be different files")
53
+ if len(set(self.supporting_section_ids)) != len(self.supporting_section_ids):
54
+ raise ValueError("supporting research section ids must be unique")
55
+ for section_id in self.supporting_section_ids:
56
+ if not re.fullmatch(r"[a-z0-9_]+", section_id):
57
+ raise ValueError(
58
+ "supporting research section ids must use lowercase snake_case"
59
+ )
60
+ if section_id == self.section_id:
61
+ raise ValueError("a research section cannot support itself")
62
+
63
+
64
+ def _file_sha256(path: Path) -> str:
65
+ digest = hashlib.sha256()
66
+ with path.open("rb") as handle:
67
+ for chunk in iter(lambda: handle.read(64 * 1024), b""):
68
+ digest.update(chunk)
69
+ return digest.hexdigest()
70
+
71
+
72
+ def _completed_supporting_result(workspace: Path, section_id: str) -> str | None:
73
+ evidence = _load_script("research-evidence.py", "pmr_evidence")
74
+ outcome = evidence.inspect_section(workspace, section_id, require_materialized=False)
75
+ return outcome.get("body") if outcome["status"] == "completed" else None
76
+
77
+
78
+ def _load_script(filename: str, module_name: str) -> ModuleType:
79
+ path = Path(__file__).resolve().parent / filename
80
+ spec = importlib.util.spec_from_file_location(module_name, path)
81
+ if spec is None or spec.loader is None:
82
+ raise RuntimeError(f"cannot load bundled script {filename}")
83
+ module = importlib.util.module_from_spec(spec)
84
+ sys.modules[spec.name] = module
85
+ previous = sys.dont_write_bytecode
86
+ sys.dont_write_bytecode = True
87
+ try:
88
+ spec.loader.exec_module(module)
89
+ finally:
90
+ sys.dont_write_bytecode = previous
91
+ return module
92
+
93
+
94
+ def _saved_inputs(workspace: Path, runtime_dir: Path, spec: SectionWorkflowSpec,
95
+ assignment: str | None, runtime, io) -> tuple[str, str, str]:
96
+ """Recover the paid request's bytes, never rebuild them from current sources."""
97
+ try:
98
+ query = (runtime_dir / "query.md").read_text(encoding="utf-8")
99
+ system_prompt = (runtime_dir / "system-prompt.md").read_text(encoding="utf-8")
100
+ assignment_text = (runtime_dir / "assignment.md").read_text(encoding="utf-8")
101
+ saved_assignment = assignment_text.removesuffix("\n")
102
+ provenance_path = runtime_dir / "input-provenance.json"
103
+ provenance = json.loads(provenance_path.read_text(encoding="utf-8"))
104
+ state = runtime._read_state(runtime_dir / "request.json")
105
+ if (not query.strip() or not system_prompt.strip() or not saved_assignment.strip()
106
+ or assignment_text != saved_assignment.strip() + "\n"
107
+ or not isinstance(provenance, dict) or provenance.get("schema_version") != 1
108
+ or provenance.get("section_id") != spec.section_id
109
+ or provenance.get("query_sha256") != hashlib.sha256(query.encode()).hexdigest()
110
+ or provenance.get("assignment_sha256") != hashlib.sha256(saved_assignment.encode()).hexdigest()
111
+ or provenance.get("research_context") != io.context_binding(workspace, spec.section_id)
112
+ or not isinstance(provenance.get("measured_inputs"), dict)
113
+ or not isinstance(state, dict)
114
+ or state.get("status") not in {"submitting", "running", "failed", "completed"}
115
+ or type(state.get("submission_attempt")) is not int or state["submission_attempt"] < 0
116
+ or (state.get("status") in {"running", "completed"} and not state.get("job_id"))
117
+ or state.get("input_provenance_sha256") != _file_sha256(provenance_path)):
118
+ raise ValueError("Saved research input provenance is missing or damaged")
119
+ runtime.require_matching_inputs(
120
+ runtime_dir / "request.json", query=query, system_prompt=system_prompt,
121
+ schema_version=SCHEMA_VERSION,
122
+ result_path=runtime._relative(runtime_dir / "result.md", workspace),
123
+ input_provenance_sha256=_file_sha256(provenance_path),
124
+ )
125
+ if state.get("status") == "completed" and (
126
+ not state.get("job_id")
127
+ or state.get("result_sha256") != _file_sha256(runtime_dir / "result.md")
128
+ ):
129
+ raise ValueError("Saved research result is missing or damaged; do not start new paid work")
130
+ except (OSError, UnicodeError, json.JSONDecodeError) as exc:
131
+ raise ValueError("Saved research inputs or result are missing or damaged; preserve evidence before retrying") from exc
132
+ if assignment is not None and assignment.strip() != saved_assignment:
133
+ raise ValueError("research inputs changed; existing evidence is preserved. Use a new research ID for a new assignment; do not automatically repeat paid work")
134
+ return query, system_prompt, saved_assignment
135
+
136
+
137
+ def run_section_workflow(
138
+ workspace: Path,
139
+ *,
140
+ spec: SectionWorkflowSpec,
141
+ assignment: str | None = None,
142
+ context_file: Path | None = None,
143
+ research_run: Callable[..., Any] | None = None,
144
+ materialize: Callable[[Path, str, str], Any] | None = None,
145
+ ) -> dict[str, Any]:
146
+ """Serialize preparation and execution for one narrative section."""
147
+ spec.validate()
148
+ if assignment is not None and not assignment.strip():
149
+ raise ValueError("research assignment must not be empty")
150
+ workspace = workspace.resolve()
151
+ io = _load_script("research-artifact-io.py", "pmr_input_io")
152
+ runtime_dir = workspace / _artifact_path('egbe-docs/research/market/work') / spec.section_id
153
+ with io.file_lock(runtime_dir / ".run.lock", timeout=1):
154
+ return _run_section_workflow(
155
+ workspace, spec=spec, assignment=assignment, context_file=context_file,
156
+ research_run=research_run, materialize=materialize,
157
+ )
158
+
159
+
160
+ def _run_section_workflow(
161
+ workspace: Path, *, spec: SectionWorkflowSpec, assignment: str | None,
162
+ context_file: Path | None, research_run: Callable[..., Any] | None,
163
+ materialize: Callable[[Path, str, str], Any] | None,
164
+ ) -> dict[str, Any]:
165
+ """Build canonical inputs once, then delegate saved execution to the runtime."""
166
+ scripts_dir = Path(__file__).resolve().parent
167
+ skill_root = scripts_dir.parent
168
+ builder = _load_script("build-research-query.py", "pmr_query_builder")
169
+ research = _load_script("run-os-research.py", "pmr_os_research")
170
+ runtime = _load_script("research-section-runtime.py", "pmr_section_runtime")
171
+ upsert = _load_script("upsert-markdown-section.py", "pmr_section_upsert")
172
+
173
+ runtime_dir = workspace / _artifact_path('egbe-docs/research/market/work') / spec.section_id
174
+ query_file = runtime_dir / "query.md"
175
+ request_file = runtime_dir / "request.json"
176
+ result_file = runtime_dir / "result.md"
177
+ report_file = workspace / REPORT_PATH
178
+ system_prompt_file = skill_root / "references" / "prompts" / spec.system_prompt_filename
179
+ user_prompt_file = skill_root / "references" / "prompts" / spec.user_prompt_filename
180
+
181
+ io = _load_script("research-artifact-io.py", "pmr_input_io")
182
+ selected_context = io.bind_context(workspace, spec.section_id, context_file=context_file)
183
+ provenance_path = runtime_dir / "input-provenance.json"
184
+ if request_file.exists():
185
+ query, system_prompt, assignment = _saved_inputs(
186
+ workspace, runtime_dir, spec, assignment, runtime, io,
187
+ )
188
+ else:
189
+ catalog = builder._read_json_object(
190
+ skill_root / "references/catalog.v1.json", label="catalog",
191
+ )
192
+ supporting_evidence = tuple(
193
+ (builder._catalog_label(catalog, section_id), body)
194
+ for section_id in spec.supporting_section_ids
195
+ if (body := _completed_supporting_result(workspace, section_id)) is not None
196
+ )
197
+ measured = _load_script("research-evidence.py", "pmr_evidence")
198
+ measured_inputs, measured_manifest = measured.measured_context(workspace, spec.section_id)
199
+ supporting_evidence += measured_inputs
200
+ # The bundled brief is only a scope default for API callers on first use.
201
+ assignment = (builder._read_text(user_prompt_file, label=f"{spec.display_name} user prompt")
202
+ if assignment is None else assignment.strip())
203
+ if not assignment:
204
+ raise ValueError("research assignment must not be empty")
205
+ query = builder.build_query(
206
+ context=selected_context["text"], section_label=builder._catalog_label(catalog, spec.section_id),
207
+ reason=None, assignment=assignment, supporting_evidence=supporting_evidence,
208
+ )
209
+ system_prompt = system_prompt_file.read_text(encoding="utf-8").strip()
210
+ if not system_prompt:
211
+ raise ValueError(f"{spec.display_name} system prompt must not be empty")
212
+ builder.write_atomic(query_file, query)
213
+ builder.write_atomic(runtime_dir / "assignment.md", assignment + "\n")
214
+ builder.write_atomic(provenance_path, json.dumps({
215
+ "schema_version": 1, "section_id": spec.section_id,
216
+ "research_context": io.context_binding(workspace, spec.section_id),
217
+ "query_sha256": hashlib.sha256(query.encode()).hexdigest(),
218
+ "assignment_sha256": hashlib.sha256(assignment.encode()).hexdigest(),
219
+ "measured_inputs": measured_manifest,
220
+ }, indent=2, sort_keys=True) + "\n")
221
+ builder.write_atomic(runtime_dir / "system-prompt.md", system_prompt)
222
+
223
+ run_research = research_run or research.run_research_to_file
224
+
225
+ def execute_research(**kwargs: Any) -> Any:
226
+ return run_research(
227
+ **kwargs,
228
+ query=query,
229
+ system_prompt=system_prompt,
230
+ base_url=os.environ.get("OS_URL") or research.DEFAULT_OS_URL,
231
+ api_key=os.environ.get("OS_API_KEY", ""),
232
+ )
233
+
234
+ materializer = materialize or (
235
+ lambda path, heading, body: upsert.upsert_markdown_section(path, heading, body)
236
+ )
237
+ return runtime.run_resumable_section(
238
+ workspace,
239
+ query=query,
240
+ system_prompt=system_prompt,
241
+ section_heading=spec.section_heading,
242
+ request_file=request_file,
243
+ result_file=result_file,
244
+ report_file=report_file,
245
+ schema_version=SCHEMA_VERSION,
246
+ input_provenance_sha256=_file_sha256(provenance_path),
247
+ execute_research=execute_research,
248
+ materialize=materializer,
249
+ )
250
+
251
+
252
+ def run_cli(
253
+ *,
254
+ description: str,
255
+ display_name: str,
256
+ runner: Callable[[Path], dict[str, Any]],
257
+ ) -> int:
258
+ parser = argparse.ArgumentParser(description=description)
259
+ parser.add_argument("--workspace", type=Path, default=Path("."))
260
+ task = parser.add_mutually_exclusive_group(required=True)
261
+ task.add_argument("--assignment", help="Bounded research question and scope from the project method/current task.")
262
+ task.add_argument("--assignment-file", type=Path, help="Existing UTF-8 task text; no special format required.")
263
+ parser.add_argument("--context-file", type=Path, help="Explicit additional context safe to send to the research provider.")
264
+ args = parser.parse_args()
265
+ try:
266
+ assignment_path = args.assignment_file if not args.assignment_file or args.assignment_file.is_absolute() else args.workspace / args.assignment_file
267
+ assignment = assignment_path.read_text(encoding="utf-8") if assignment_path else args.assignment
268
+ result = runner(args.workspace, assignment=assignment, context_file=args.context_file)
269
+ persistence = _load_script(
270
+ "persist-research-report.py",
271
+ "pmr_report_persistence",
272
+ )
273
+ persisted = persistence.persist_research_report(args.workspace)
274
+ result_path = args.workspace.resolve() / result["result_path"]
275
+ state = json.loads((result_path.parent / "request.json").read_text())
276
+ io = _load_script("research-artifact-io.py", "pmr_artifact_io")
277
+ io.write_json(result_path.parent / "publication.json", {
278
+ "schema_version": 1, "result_sha256": state["result_sha256"],
279
+ "report_commit_sha": persisted.commit_sha, "publication_mode": persisted.publication_mode,
280
+ })
281
+ except (OSError, RuntimeError, UnicodeError, ValueError) as exc:
282
+ raise SystemExit(str(exc)) from exc
283
+ mode = "reused" if result["reused"] else "completed"
284
+ print(
285
+ f"{display_name} research {mode}; materialized {result['report_path']}; "
286
+ "local files written; caller owns git publication"
287
+ )
288
+ return 0