@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,66 @@
1
+ #!/usr/bin/env python3
2
+ """Run or resume Target Audience research, then materialize its cached result."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import importlib.util
7
+ import sys
8
+ from pathlib import Path
9
+ from types import ModuleType
10
+ from typing import Any, Callable
11
+
12
+
13
+ def _load_script(filename: str, module_name: str) -> ModuleType:
14
+ path = Path(__file__).resolve().parent / filename
15
+ spec = importlib.util.spec_from_file_location(module_name, path)
16
+ if spec is None or spec.loader is None:
17
+ raise RuntimeError(f"cannot load bundled script {filename}")
18
+ module = importlib.util.module_from_spec(spec)
19
+ sys.modules[spec.name] = module
20
+ previous = sys.dont_write_bytecode
21
+ sys.dont_write_bytecode = True
22
+ try:
23
+ spec.loader.exec_module(module)
24
+ finally:
25
+ sys.dont_write_bytecode = previous
26
+ return module
27
+
28
+
29
+ workflow = _load_script("research-section-workflow.py", "pmr_section_workflow")
30
+ SPEC = workflow.SectionWorkflowSpec(
31
+ section_id="target_audience",
32
+ section_heading="Target audience",
33
+ display_name="Target Audience",
34
+ system_prompt_filename="target-audience.md",
35
+ user_prompt_filename="target-audience.user.md",
36
+ )
37
+
38
+
39
+ def run_workflow(
40
+ workspace: Path,
41
+ *,
42
+ assignment: str | None = None,
43
+ context_file: Path | None = None,
44
+ research_run: Callable[..., Any] | None = None,
45
+ materialize: Callable[[Path, str, str], Any] | None = None,
46
+ ) -> dict[str, Any]:
47
+ return workflow.run_section_workflow(
48
+ workspace,
49
+ spec=SPEC,
50
+ assignment=assignment,
51
+ context_file=context_file,
52
+ research_run=research_run,
53
+ materialize=materialize,
54
+ )
55
+
56
+
57
+ def main() -> int:
58
+ return workflow.run_cli(
59
+ description=__doc__ or "",
60
+ display_name=SPEC.display_name,
61
+ runner=run_workflow,
62
+ )
63
+
64
+
65
+ if __name__ == "__main__":
66
+ raise SystemExit(main())
@@ -0,0 +1,71 @@
1
+ #!/usr/bin/env python3
2
+ """Run or resume Unit Economics research, then materialize its result."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import importlib.util
7
+ import sys
8
+ from pathlib import Path
9
+ from types import ModuleType
10
+ from typing import Any, Callable
11
+
12
+
13
+ def _load_script(filename: str, module_name: str) -> ModuleType:
14
+ path = Path(__file__).resolve().parent / filename
15
+ spec = importlib.util.spec_from_file_location(module_name, path)
16
+ if spec is None or spec.loader is None:
17
+ raise RuntimeError(f"cannot load bundled script {filename}")
18
+ module = importlib.util.module_from_spec(spec)
19
+ sys.modules[spec.name] = module
20
+ previous = sys.dont_write_bytecode
21
+ sys.dont_write_bytecode = True
22
+ try:
23
+ spec.loader.exec_module(module)
24
+ finally:
25
+ sys.dont_write_bytecode = previous
26
+ return module
27
+
28
+
29
+ workflow = _load_script("research-section-workflow.py", "pmr_section_workflow")
30
+ SPEC = workflow.SectionWorkflowSpec(
31
+ section_id="unit_economics",
32
+ section_heading="Unit economics",
33
+ display_name="Unit Economics",
34
+ system_prompt_filename="unit-economics.md",
35
+ user_prompt_filename="unit-economics.user.md",
36
+ supporting_section_ids=(
37
+ "pricing_monetization",
38
+ "acquisition_channels",
39
+ "demand_validation",
40
+ ),
41
+ )
42
+
43
+
44
+ def run_workflow(
45
+ workspace: Path,
46
+ *,
47
+ assignment: str | None = None,
48
+ context_file: Path | None = None,
49
+ research_run: Callable[..., Any] | None = None,
50
+ materialize: Callable[[Path, str, str], Any] | None = None,
51
+ ) -> dict[str, Any]:
52
+ return workflow.run_section_workflow(
53
+ workspace,
54
+ spec=SPEC,
55
+ assignment=assignment,
56
+ context_file=context_file,
57
+ research_run=research_run,
58
+ materialize=materialize,
59
+ )
60
+
61
+
62
+ def main() -> int:
63
+ return workflow.run_cli(
64
+ description=__doc__ or "",
65
+ display_name=SPEC.display_name,
66
+ runner=run_workflow,
67
+ )
68
+
69
+
70
+ if __name__ == "__main__":
71
+ raise SystemExit(main())
@@ -0,0 +1,67 @@
1
+ #!/usr/bin/env python3
2
+ """Run or resume Value Proposition research, then materialize its result."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import importlib.util
7
+ import sys
8
+ from pathlib import Path
9
+ from types import ModuleType
10
+ from typing import Any, Callable
11
+
12
+
13
+ def _load_script(filename: str, module_name: str) -> ModuleType:
14
+ path = Path(__file__).resolve().parent / filename
15
+ spec = importlib.util.spec_from_file_location(module_name, path)
16
+ if spec is None or spec.loader is None:
17
+ raise RuntimeError(f"cannot load bundled script {filename}")
18
+ module = importlib.util.module_from_spec(spec)
19
+ sys.modules[spec.name] = module
20
+ previous = sys.dont_write_bytecode
21
+ sys.dont_write_bytecode = True
22
+ try:
23
+ spec.loader.exec_module(module)
24
+ finally:
25
+ sys.dont_write_bytecode = previous
26
+ return module
27
+
28
+
29
+ workflow = _load_script("research-section-workflow.py", "pmr_section_workflow")
30
+ SPEC = workflow.SectionWorkflowSpec(
31
+ section_id="value_proposition",
32
+ section_heading="Value proposition",
33
+ display_name="Value Proposition",
34
+ system_prompt_filename="value-proposition.md",
35
+ user_prompt_filename="value-proposition.user.md",
36
+ supporting_section_ids=("target_audience", "competitive_landscape"),
37
+ )
38
+
39
+
40
+ def run_workflow(
41
+ workspace: Path,
42
+ *,
43
+ assignment: str | None = None,
44
+ context_file: Path | None = None,
45
+ research_run: Callable[..., Any] | None = None,
46
+ materialize: Callable[[Path, str, str], Any] | None = None,
47
+ ) -> dict[str, Any]:
48
+ return workflow.run_section_workflow(
49
+ workspace,
50
+ spec=SPEC,
51
+ assignment=assignment,
52
+ context_file=context_file,
53
+ research_run=research_run,
54
+ materialize=materialize,
55
+ )
56
+
57
+
58
+ def main() -> int:
59
+ return workflow.run_cli(
60
+ description=__doc__ or "",
61
+ display_name=SPEC.display_name,
62
+ runner=run_workflow,
63
+ )
64
+
65
+
66
+ if __name__ == "__main__":
67
+ raise SystemExit(main())
@@ -0,0 +1,156 @@
1
+ #!/usr/bin/env python3
2
+ """Create or replace one canonical H2 in the market research report."""
3
+
4
+ from __future__ import annotations
5
+
6
+ import argparse
7
+ import importlib.util
8
+ import os
9
+ import tempfile
10
+ from pathlib import Path
11
+
12
+
13
+ REPORT_TITLE = "# Market Research Report"
14
+
15
+
16
+ def _write_atomic(path: Path, content: str) -> None:
17
+ path.parent.mkdir(parents=True, exist_ok=True)
18
+ temporary_path: Path | None = None
19
+ try:
20
+ with tempfile.NamedTemporaryFile(
21
+ mode="w",
22
+ encoding="utf-8",
23
+ newline="\n",
24
+ dir=path.parent,
25
+ prefix=f".{path.name}.",
26
+ suffix=".tmp",
27
+ delete=False,
28
+ ) as handle:
29
+ handle.write(content)
30
+ handle.flush()
31
+ os.fsync(handle.fileno())
32
+ temporary_path = Path(handle.name)
33
+ os.chmod(temporary_path, 0o644)
34
+ os.replace(temporary_path, path)
35
+ temporary_path = None
36
+ finally:
37
+ if temporary_path is not None:
38
+ temporary_path.unlink(missing_ok=True)
39
+
40
+
41
+ def _canonical_content(content: str) -> str:
42
+ normalized = content.replace("\r\n", "\n").replace("\r", "\n").strip()
43
+ if not normalized:
44
+ raise ValueError("section content must not be empty")
45
+ return normalized
46
+
47
+
48
+ def _validate_heading(heading: str) -> str:
49
+ value = heading.strip()
50
+ if not value or "\n" in value or "\r" in value or value.startswith("#"):
51
+ raise ValueError("heading must be a non-empty H2 title without Markdown markers")
52
+ return value
53
+
54
+
55
+ def _h2_offsets(text: str) -> list[tuple[str, int]]:
56
+ """Return exact column-zero H2 headings outside fenced code blocks."""
57
+
58
+ offsets: list[tuple[str, int]] = []
59
+ offset = 0
60
+ fence_char: str | None = None
61
+ fence_size = 0
62
+
63
+ for line in text.splitlines(keepends=True):
64
+ raw = line.rstrip("\r\n")
65
+ stripped = raw.lstrip(" ")
66
+ indent = len(raw) - len(stripped)
67
+ if indent <= 3 and stripped.startswith(("```", "~~~")):
68
+ marker = stripped.split(maxsplit=1)[0]
69
+ char = marker[0]
70
+ size = len(marker) - len(marker.lstrip(char))
71
+ if size >= 3:
72
+ if fence_char is None:
73
+ fence_char, fence_size = char, size
74
+ elif char == fence_char and size >= fence_size:
75
+ fence_char, fence_size = None, 0
76
+ elif fence_char is None and raw.startswith("## ") and raw[3:].strip():
77
+ offsets.append((raw[3:].strip(), offset))
78
+ offset += len(line)
79
+
80
+ return offsets
81
+
82
+
83
+ def upsert_markdown_section(report: Path, heading: str, content: str) -> str:
84
+ """Upsert one H2 and return the resulting report text."""
85
+
86
+ spec = importlib.util.spec_from_file_location("pmr_artifact_io", Path(__file__).with_name("research-artifact-io.py"))
87
+ module = importlib.util.module_from_spec(spec)
88
+ spec.loader.exec_module(module)
89
+ with module.publication_lock(report):
90
+ return _upsert_markdown_section(report, heading, content)
91
+
92
+
93
+ def _upsert_markdown_section(report: Path, heading: str, content: str) -> str:
94
+
95
+ title = _validate_heading(heading)
96
+ body = _canonical_content(content)
97
+
98
+ if report.exists():
99
+ text = report.read_text(encoding="utf-8")
100
+ if text != REPORT_TITLE and not text.startswith(f"{REPORT_TITLE}\n"):
101
+ raise ValueError(f"existing report must start with exact H1 `{REPORT_TITLE}`")
102
+ else:
103
+ text = REPORT_TITLE
104
+
105
+ headings = _h2_offsets(text)
106
+ matches = [(index, offset) for index, (name, offset) in enumerate(headings) if name == title]
107
+ if len(matches) > 1:
108
+ raise ValueError(f"report contains duplicate H2 `## {title}`")
109
+
110
+ if matches:
111
+ index, start = matches[0]
112
+ end = headings[index + 1][1] if index + 1 < len(headings) else len(text)
113
+ suffix = text[end:]
114
+ block = f"## {title}\n\n{body}\n"
115
+ if suffix:
116
+ block += "\n"
117
+ updated = text[:start] + block + suffix
118
+ else:
119
+ if text.endswith("\n\n"):
120
+ prefix = text
121
+ elif text.endswith("\n"):
122
+ prefix = text + "\n"
123
+ else:
124
+ prefix = text + "\n\n"
125
+ updated = f"{prefix}## {title}\n\n{body}\n"
126
+
127
+ _write_atomic(report, updated)
128
+ return updated
129
+
130
+
131
+ def _parser() -> argparse.ArgumentParser:
132
+ parser = argparse.ArgumentParser(description=__doc__)
133
+ parser.add_argument("--report", type=Path, required=True)
134
+ parser.add_argument("--heading", required=True)
135
+ source = parser.add_mutually_exclusive_group(required=True)
136
+ source.add_argument("--content")
137
+ source.add_argument("--content-file", type=Path)
138
+ return parser
139
+
140
+
141
+ def main() -> int:
142
+ args = _parser().parse_args()
143
+ content = (
144
+ args.content_file.read_text(encoding="utf-8")
145
+ if args.content_file is not None
146
+ else args.content
147
+ )
148
+ try:
149
+ upsert_markdown_section(args.report, args.heading, content)
150
+ except (OSError, ValueError) as exc:
151
+ raise SystemExit(str(exc)) from exc
152
+ return 0
153
+
154
+
155
+ if __name__ == "__main__":
156
+ raise SystemExit(main())
@@ -0,0 +1,249 @@
1
+ #!/usr/bin/env python3
2
+ """Walk the selected funnels in a real mobile browser and assemble walks.json.
3
+
4
+ serve one local mobile Chrome (390x844) behind 127.0.0.1:9417, a page per
5
+ funnel. Actions, POSTed as JSON: open {funnel_id, url},
6
+ screen {funnel_id, screen_id, kind, slices?, fields?},
7
+ click {funnel_id, text | selector}, fill {funnel_id, selector, value},
8
+ dom {funnel_id}, scroll {funnel_id, y}, eval {funnel_id, js},
9
+ finish {funnel_id, status, stop_reason, unknown, observed_market?}.
10
+ call send one action: walk-funnels.py call screen '{"funnel_id": "...", ...}'
11
+ build write egbe-docs/research/market/work/funnel_teardown/walks.json from the records.
12
+
13
+ Screens are recorded under egbe-docs/research/market/work/funnel_teardown/records/ and
14
+ their screenshots under egbe-docs/research/market/assets/funnel-teardown/, so the decision
15
+ site can publish them. The agent decides every click and writes what it saw
16
+ (headline, cta, offer, proof, amounts, lead_fields, notes) in `fields`, with
17
+ the funnel-walk.v2 screen fields that apply (branch_role, submission_required,
18
+ completion_observed; contains_private_data with a redacted display_screenshot);
19
+ a walk stops at the first form it would have to send (`form_not_submitted`).
20
+ """
21
+ from __future__ import annotations
22
+
23
+ import sys as _artifact_sys
24
+ from pathlib import Path as _ArtifactPath
25
+ _artifact_sys.path.insert(0, str(_ArtifactPath(__file__).resolve().parent))
26
+ from egbe_artifacts import artifact_path as _artifact_path
27
+
28
+ import argparse
29
+ import hashlib
30
+ import json
31
+ import re
32
+ import sys
33
+ import urllib.request
34
+ from datetime import date, datetime, timezone
35
+ from http.server import BaseHTTPRequestHandler, HTTPServer
36
+ from pathlib import Path
37
+ from typing import Any
38
+
39
+ RUNTIME_REL = Path(_artifact_path("egbe-docs/research/market/work/funnel_teardown"))
40
+ SHOTS_REL = Path(_artifact_path("egbe-docs/research/market/assets/funnel-teardown"))
41
+ ADDRESS = ("127.0.0.1", 9417)
42
+ VIEWPORT = {"width": 390, "height": 844}
43
+ IPHONE = "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1"
44
+ # funnel-walk.v2 screen fields the agent may record; build() adds defaults only where they are absent.
45
+ SCREEN_FIELDS = ("branch_role", "advance", "options", "words_per_option", "notes", "answer", "cta", "offer", "proof", "lead_fields", "amounts",
46
+ "result_type", "conversion_kind", "progress_indicator", "booking_kind", "captured_before_fill", "submission_required",
47
+ "completion_observed", "display_screenshot")
48
+ DOM_SUMMARY = """() => {
49
+ const visible = el => { const r = el.getBoundingClientRect(), s = getComputedStyle(el);
50
+ return r.width > 0 && r.height > 0 && s.visibility !== 'hidden' && s.display !== 'none' && r.bottom > 0 && r.top < innerHeight * 3; };
51
+ const label = el => ((el.labels && el.labels[0] && el.labels[0].innerText) || el.getAttribute('aria-label') || el.placeholder || el.name || el.id || '').trim().slice(0, 100);
52
+ return { url: location.href, title: document.title, text: document.body.innerText.replace(/\\n{2,}/g, '\\n').slice(0, 5000),
53
+ inputs: [...document.querySelectorAll('input,select,textarea')].filter(x => x.type !== 'hidden' && visible(x))
54
+ .map(x => ({ tag: x.tagName.toLowerCase(), type: x.type, name: x.name || null, required: x.required, label: label(x) })),
55
+ buttons: [...document.querySelectorAll('a,button,[role=button],input[type=submit]')].filter(visible)
56
+ .map(b => (b.innerText || b.value || b.getAttribute('aria-label') || '').trim().replace(/\\s+/g, ' ').slice(0, 70)).filter(Boolean).slice(0, 40) };
57
+ }"""
58
+
59
+
60
+ def record_path(workspace: Path, funnel_id: str) -> Path:
61
+ return workspace / RUNTIME_REL / "records" / f"{funnel_id}.json"
62
+
63
+
64
+ def load_record(workspace: Path, funnel_id: str) -> dict[str, Any]:
65
+ path = record_path(workspace, funnel_id)
66
+ return json.loads(path.read_text()) if path.is_file() else {"funnel_id": funnel_id, "screens": [], "redirects": []}
67
+
68
+
69
+ def save_record(workspace: Path, record: dict[str, Any]) -> None:
70
+ path = record_path(workspace, record["funnel_id"])
71
+ path.parent.mkdir(parents=True, exist_ok=True)
72
+ path.write_text(json.dumps(record, indent=1, ensure_ascii=False))
73
+
74
+
75
+ def note_navigation(workspace: Path, funnel_id: str, url: str) -> None:
76
+ """A main-frame navigation, saved at once: screen and finish reload the record from disk."""
77
+ record = load_record(workspace, funnel_id)
78
+ record["redirects"].append(url)
79
+ save_record(workspace, record)
80
+
81
+
82
+ def record_screen(workspace: Path, funnel_id: str, screen_id: str, kind: str, shots: list[Path], summary: dict[str, Any],
83
+ fields: dict[str, Any]) -> dict[str, Any]:
84
+ """One observed screen: its screenshots, what the page shows and what the agent read on it."""
85
+ record = load_record(workspace, funnel_id)
86
+ entry = {"screen_id": screen_id, "kind": kind, "url": summary.get("url"), "captured_at": datetime.now(timezone.utc).isoformat(),
87
+ "shots": [{"path": shot.relative_to(workspace).as_posix(), "sha256": hashlib.sha256(shot.read_bytes()).hexdigest()} for shot in shots],
88
+ "title": summary.get("title"), "text": summary.get("text"), "inputs": summary.get("inputs"), "buttons": summary.get("buttons"), **fields}
89
+ record["screens"] = [s for s in record["screens"] if s["screen_id"] != screen_id] + [entry]
90
+ save_record(workspace, record)
91
+ return entry
92
+
93
+
94
+ def build(workspace: Path) -> dict[str, Any]:
95
+ runtime = workspace / RUNTIME_REL
96
+ candidates = json.loads((runtime / "candidates.json").read_text())
97
+ context = runtime / "research-context.json"
98
+ persona = (json.loads(context.read_text()).get("persona") or {}).get("id", "buyer") if context.is_file() else "buyer"
99
+ by_id = {c["funnel_id"]: c for c in candidates["candidates"]}
100
+ walks = []
101
+ for path in sorted((runtime / "records").glob("*.json")):
102
+ record = json.loads(path.read_text())
103
+ candidate, walk = by_id[record["funnel_id"]], record.get("walk") or {}
104
+ screens = []
105
+ for n, s in enumerate(record["screens"], 1):
106
+ # The agent declares private pixels; the validator then publishes its redacted `display_screenshot`.
107
+ shots = [{**shot, "contains_private_data": s.get("contains_private_data") is True} for shot in s["shots"]]
108
+ screen = {"screen_id": s["screen_id"], "attempt_id": record["attempt_id"], "url": s["url"], "kind": s["kind"], "branch_role": "main",
109
+ "advance": "none" if n == len(record["screens"]) else "button", "headline": s.get("headline") or s.get("title") or "",
110
+ "options": "none", "notes": "", "lead_fields": [], "amounts": [], "screenshot": shots[0], "screenshots": shots[1:],
111
+ "observed_at": s["captured_at"], "source": "browser", **({"submission_required": True} if s["kind"] == "contact request" else {}),
112
+ **{key: s[key] for key in SCREEN_FIELDS if key in s}}
113
+ screen["headline_words"] = len(re.findall(r"\w+", screen["headline"]))
114
+ screens.append(screen)
115
+ item = {"funnel_id": record["funnel_id"], "campaign_ids": candidate["campaign_ids"], "path_id": "buyer", "address": candidate["address"],
116
+ "role": candidate["role"], "persona_id": persona, "walked_on": record["walked_on"], "viewport": "390x844",
117
+ "observed_market": walk.get("observed_market") or {"language": None, "country": None, "currency": None},
118
+ "status": walk.get("status", "boundary"), "stop_reason": walk.get("stop_reason", "form_not_submitted"),
119
+ "observed_outcome": walk.get("observed_outcome", "not_observed"), "unknown": walk.get("unknown", []), "screens": screens, "branch_points": []}
120
+ hops = [hop for hop in record.get("redirects") or [] if hop != candidate["address"]]
121
+ if screens and screens[0]["url"] != candidate["address"] and hops:
122
+ chain, previous = [], candidate["address"]
123
+ for hop in hops:
124
+ chain.append({"from": previous, "to": hop, "source_ref": f"browser:{screens[0]['screen_id']}"})
125
+ previous = hop
126
+ item["redirect_chain"] = chain
127
+ walks.append(item)
128
+ document = {"schema_version": 2, "contract": "funnel-walk.v2", "inputs_sha256": candidates["inputs_sha256"], "walks": walks}
129
+ (runtime / "walks.json").write_text(json.dumps(document, indent=1, ensure_ascii=False))
130
+ return document
131
+
132
+
133
+ def serve(workspace: Path) -> None: # pragma: no cover - drives a real browser
134
+ from playwright.sync_api import sync_playwright
135
+
136
+ pages: dict[str, Any] = {}
137
+ with sync_playwright() as playwright:
138
+ browser = playwright.chromium.launch(channel="chrome", headless=True)
139
+
140
+ def settle(page) -> None:
141
+ try:
142
+ page.wait_for_load_state("networkidle", timeout=12000)
143
+ except Exception:
144
+ pass
145
+ page.wait_for_timeout(1500)
146
+
147
+ def summary(page) -> dict[str, Any]:
148
+ return page.evaluate(DOM_SUMMARY)
149
+
150
+ def page_of(funnel_id: str):
151
+ return pages[funnel_id]["page"]
152
+
153
+ def open_(funnel_id: str, url: str) -> dict[str, Any]:
154
+ if funnel_id in pages:
155
+ pages[funnel_id]["context"].close()
156
+ context = browser.new_context(viewport=VIEWPORT, is_mobile=True, has_touch=True, device_scale_factor=2, user_agent=IPHONE, locale="en-US")
157
+ page = context.new_page()
158
+ record = load_record(workspace, funnel_id)
159
+ record.update(address=url, walked_on=date.today().isoformat(), attempt_id=f"{funnel_id}-a1", redirects=[])
160
+ save_record(workspace, record)
161
+ page.on("framenavigated", lambda frame: frame == page.main_frame and note_navigation(workspace, funnel_id, frame.url))
162
+ pages[funnel_id] = {"context": context, "page": page}
163
+ response = page.goto(url, wait_until="domcontentloaded", timeout=60000)
164
+ settle(page)
165
+ return {"status": response.status if response else None, **summary(page)}
166
+
167
+ def screen(funnel_id: str, screen_id: str, kind: str, slices: int = 0, fields: dict | None = None) -> dict[str, Any]:
168
+ page, directory = page_of(funnel_id), workspace / SHOTS_REL / funnel_id
169
+ directory.mkdir(parents=True, exist_ok=True)
170
+ shots = [directory / f"{screen_id}.png"]
171
+ page.screenshot(path=str(shots[0]))
172
+ top = page.evaluate("scrollY")
173
+ for n in range(1, slices + 1):
174
+ page.evaluate(f"scrollTo(0, {top + n * VIEWPORT['height']})")
175
+ page.wait_for_timeout(500)
176
+ shots.append(directory / f"{screen_id}-lower-{n:02d}.png")
177
+ page.screenshot(path=str(shots[-1]))
178
+ page.evaluate(f"scrollTo(0, {top})")
179
+ return record_screen(workspace, funnel_id, screen_id, kind, shots, summary(page), fields or {})
180
+
181
+ def click(funnel_id: str, text: str | None = None, selector: str | None = None) -> dict[str, Any]:
182
+ page = page_of(funnel_id)
183
+ target = page.locator(selector).first if selector else page.get_by_text(text).first
184
+ target.click(timeout=8000, force=True)
185
+ settle(page)
186
+ return summary(page)
187
+
188
+ def finish(funnel_id: str, **walk: Any) -> dict[str, Any]:
189
+ record = load_record(workspace, funnel_id)
190
+ record["walk"] = walk
191
+ save_record(workspace, record)
192
+ return {"finished": funnel_id, "screens": len(record["screens"])}
193
+
194
+ actions = {
195
+ "open": open_, "screen": screen, "click": click, "finish": finish,
196
+ "fill": lambda funnel_id, selector, value: page_of(funnel_id).locator(selector).first.fill(value, timeout=8000) or {"filled": selector},
197
+ "dom": lambda funnel_id: summary(page_of(funnel_id)),
198
+ "scroll": lambda funnel_id, y: page_of(funnel_id).evaluate(f"scrollTo(0, {int(y)})") or summary(page_of(funnel_id)),
199
+ "eval": lambda funnel_id, js: {"result": page_of(funnel_id).evaluate(js)},
200
+ "close": lambda funnel_id: pages.pop(funnel_id)["context"].close() or {"closed": funnel_id},
201
+ }
202
+
203
+ class Handler(BaseHTTPRequestHandler):
204
+ def do_POST(self) -> None:
205
+ try:
206
+ body = json.loads(self.rfile.read(int(self.headers.get("Content-Length") or 0)) or b"{}")
207
+ out = actions[self.path.strip("/")](**body)
208
+ except Exception as exc: # the agent reads the error and decides
209
+ out = {"error": str(exc)[:600]}
210
+ data = json.dumps(out, ensure_ascii=False, default=str).encode()
211
+ self.send_response(200)
212
+ self.send_header("Content-Type", "application/json")
213
+ self.send_header("Content-Length", str(len(data)))
214
+ self.end_headers()
215
+ self.wfile.write(data)
216
+
217
+ def log_message(self, *args: Any) -> None:
218
+ pass
219
+
220
+ print(f"walk driver ready on http://{ADDRESS[0]}:{ADDRESS[1]}", flush=True)
221
+ HTTPServer(ADDRESS, Handler).serve_forever()
222
+
223
+
224
+ def call(action: str, payload: str) -> dict[str, Any]:
225
+ request = urllib.request.Request(f"http://{ADDRESS[0]}:{ADDRESS[1]}/{action}", data=payload.encode(), method="POST",
226
+ headers={"Content-Type": "application/json"})
227
+ with urllib.request.urlopen(request, timeout=180) as response:
228
+ return json.loads(response.read())
229
+
230
+
231
+ def main() -> int:
232
+ parser = argparse.ArgumentParser(description=__doc__.splitlines()[0])
233
+ parser.add_argument("command", choices=("serve", "call", "build"))
234
+ parser.add_argument("action", nargs="?")
235
+ parser.add_argument("payload", nargs="?", default="{}")
236
+ parser.add_argument("--workspace", type=Path, default=Path("."))
237
+ args = parser.parse_args()
238
+ if args.command == "serve":
239
+ serve(args.workspace.resolve())
240
+ elif args.command == "call":
241
+ print(json.dumps(call(args.action, args.payload), ensure_ascii=False)[:4000])
242
+ else:
243
+ document = build(args.workspace.resolve())
244
+ print(f"{len(document['walks'])} walks, {sum(len(w['screens']) for w in document['walks'])} screens")
245
+ return 0
246
+
247
+
248
+ if __name__ == "__main__":
249
+ sys.exit(main())