@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,272 @@
1
+ #!/usr/bin/env python3
2
+ """Build the canonical pre-PRD recommendation artifact from a small JSON input."""
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 json
13
+ import os
14
+ import re
15
+ import tempfile
16
+ from pathlib import Path
17
+ from typing import Any
18
+
19
+
20
+ DEFAULT_OUTPUT = Path(_artifact_path("egbe-docs/research/market/pre-prd-recommendations.md"))
21
+ CATALOG_PATH = Path(__file__).resolve().parents[1] / "references" / "catalog.v1.json"
22
+ MAX_EXPLANATION_CHARS = 400
23
+ # The reason renders as one short line under an option in the chat widget.
24
+ MAX_REASON_CHARS = 180
25
+ _MARKDOWN_PATTERN = re.compile(
26
+ r"(?:^\s{0,3}(?:#{1,6}|>|[-+*]|\d+[.)])\s)|"
27
+ r"(?:!?\[[^\]]*\]\([^)]*\)|`|\*\*|__|~~)"
28
+ )
29
+
30
+
31
+ class _DuplicateJsonKeyError(ValueError):
32
+ pass
33
+
34
+
35
+ def _unique_json_object(pairs: list[tuple[str, Any]]) -> dict[str, Any]:
36
+ value: dict[str, Any] = {}
37
+ for key, item in pairs:
38
+ if key in value:
39
+ raise _DuplicateJsonKeyError(f"duplicate JSON key {key!r}")
40
+ value[key] = item
41
+ return value
42
+
43
+
44
+ def _read_json_object(path: Path, *, label: str) -> dict[str, Any]:
45
+ try:
46
+ value = json.loads(
47
+ path.read_text(encoding="utf-8"),
48
+ object_pairs_hook=_unique_json_object,
49
+ )
50
+ except OSError as exc:
51
+ raise ValueError(f"cannot read {label} {path}: {exc}") from exc
52
+ except json.JSONDecodeError as exc:
53
+ raise ValueError(f"{label} must be valid JSON: {exc.msg}") from exc
54
+ except _DuplicateJsonKeyError as exc:
55
+ raise ValueError(f"{label} contains {exc}") from exc
56
+ if not isinstance(value, dict):
57
+ raise ValueError(f"{label} must be a JSON object")
58
+ return value
59
+
60
+
61
+ def _catalog_sections(catalog: dict[str, Any]) -> list[dict[str, Any]]:
62
+ """Return the founder-selectable sections; internal sections are omitted.
63
+
64
+ Internal sections (``"internal": true``) stay in the catalog so a caller
65
+ can still invoke their workflow by ID, but they never appear in the
66
+ founder-facing recommendation artifact.
67
+ """
68
+ if catalog.get("schema_version") != 1:
69
+ raise ValueError("catalog schema_version must be 1")
70
+ raw_sections = catalog.get("sections")
71
+ if not isinstance(raw_sections, list) or not raw_sections:
72
+ raise ValueError("catalog sections must be a non-empty list")
73
+
74
+ sections: list[dict[str, Any]] = []
75
+ seen: set[str] = set()
76
+ for raw in raw_sections:
77
+ if not isinstance(raw, dict):
78
+ raise ValueError("catalog sections must contain objects")
79
+ option_id = str(raw.get("id") or "").strip()
80
+ label = str(raw.get("label") or "").strip()
81
+ description = str(raw.get("description") or "").strip()
82
+ tag = str(raw.get("tag") or "").strip()
83
+ estimated_minutes = raw.get("estimated_minutes")
84
+ if not option_id or not label:
85
+ raise ValueError("catalog sections require non-empty id and label")
86
+ if option_id in seen:
87
+ raise ValueError(f"catalog contains duplicate section id {option_id!r}")
88
+ seen.add(option_id)
89
+ if raw.get("internal") is True:
90
+ continue
91
+ if not description or not tag:
92
+ raise ValueError(
93
+ f"catalog section {option_id!r} requires non-empty description and tag"
94
+ )
95
+ if (
96
+ not isinstance(estimated_minutes, int)
97
+ or isinstance(estimated_minutes, bool)
98
+ or estimated_minutes <= 0
99
+ ):
100
+ raise ValueError(
101
+ f"catalog section {option_id!r} requires a positive integer estimated_minutes"
102
+ )
103
+ sections.append(
104
+ {
105
+ "id": option_id,
106
+ "label": label,
107
+ "description": description,
108
+ "tag": tag,
109
+ "estimated_minutes": estimated_minutes,
110
+ }
111
+ )
112
+ if not sections:
113
+ raise ValueError("catalog contains no founder-selectable sections")
114
+ return sections
115
+
116
+
117
+ def _recommendation_input(value: dict[str, Any]) -> tuple[dict[str, str], str]:
118
+ unknown_fields = set(value) - {"recommendations", "explanation"}
119
+ if unknown_fields:
120
+ raise ValueError(
121
+ "recommendation input contains unsupported fields: "
122
+ + ", ".join(sorted(unknown_fields))
123
+ )
124
+
125
+ raw_recommendations = value.get("recommendations")
126
+ if not isinstance(raw_recommendations, dict):
127
+ raise ValueError("recommendations must be an object of option id to reason")
128
+ recommendations: dict[str, str] = {}
129
+ for raw_id, raw_reason in raw_recommendations.items():
130
+ option_id = str(raw_id).strip()
131
+ if not option_id or not isinstance(raw_reason, str) or not raw_reason.strip():
132
+ raise ValueError("every recommended option requires a non-empty string reason")
133
+ reason = raw_reason.strip()
134
+ if "\n" in reason or "\r" in reason:
135
+ raise ValueError(
136
+ f"reason for {option_id!r} must be a single line"
137
+ )
138
+ if len(reason) > MAX_REASON_CHARS:
139
+ raise ValueError(
140
+ f"reason for {option_id!r} must be one sentence of at most "
141
+ f"{MAX_REASON_CHARS} characters (got {len(reason)})"
142
+ )
143
+ if _MARKDOWN_PATTERN.search(reason):
144
+ raise ValueError(
145
+ f"reason for {option_id!r} must not contain Markdown formatting"
146
+ )
147
+ recommendations[option_id] = reason
148
+
149
+ explanation = value.get("explanation")
150
+ if not isinstance(explanation, str) or not explanation.strip():
151
+ raise ValueError("explanation must be a non-empty plain-text string")
152
+ explanation = explanation.strip()
153
+ if "\n" in explanation or "\r" in explanation:
154
+ raise ValueError("explanation must be one plain-text paragraph")
155
+ if len(explanation) > MAX_EXPLANATION_CHARS:
156
+ raise ValueError(
157
+ f"explanation must be at most {MAX_EXPLANATION_CHARS} characters"
158
+ )
159
+ if _MARKDOWN_PATTERN.search(explanation):
160
+ raise ValueError("explanation must not contain Markdown formatting")
161
+ return recommendations, explanation
162
+
163
+
164
+ def build_recommendation_document(
165
+ catalog: dict[str, Any],
166
+ recommendation_input: dict[str, Any],
167
+ ) -> str:
168
+ """Return the complete canonical artifact without performing I/O."""
169
+
170
+ sections = _catalog_sections(catalog)
171
+ recommendations, explanation = _recommendation_input(recommendation_input)
172
+ known_ids = {section["id"] for section in sections}
173
+ unknown_ids = sorted(set(recommendations) - known_ids)
174
+ if unknown_ids:
175
+ raise ValueError(
176
+ "recommendations contain unknown catalog option ids: "
177
+ + ", ".join(unknown_ids)
178
+ )
179
+
180
+ options: list[dict[str, Any]] = []
181
+ for section in sections:
182
+ option_id = str(section["id"])
183
+ recommended = option_id in recommendations
184
+ item: dict[str, Any] = {
185
+ "id": option_id,
186
+ "label": section["label"],
187
+ "description": section["description"],
188
+ "tag": section["tag"],
189
+ "estimated_minutes": section["estimated_minutes"],
190
+ "recommended": recommended,
191
+ }
192
+ if recommended:
193
+ item["reason"] = recommendations[option_id]
194
+ options.append(item)
195
+
196
+ metadata = {
197
+ "schema_version": 1,
198
+ "explanation_format": "plain_text",
199
+ "options": options,
200
+ }
201
+ # JSON is a strict subset of YAML. Using the standard-library serializer
202
+ # prevents generated reasons, punctuation, or Unicode from breaking the
203
+ # YAML frontmatter consumed by the workflow runtime.
204
+ encoded = json.dumps(metadata, ensure_ascii=False, indent=2)
205
+ document = f"---\n{encoded}\n---\n\n{explanation}\n"
206
+
207
+ # Self-validate the exact bytes before the caller can replace an artifact.
208
+ frontmatter, body = document[4:].split("\n---\n", 1)
209
+ if json.loads(frontmatter) != metadata or body.strip() != explanation:
210
+ raise RuntimeError("generated recommendation artifact failed self-validation")
211
+ return document
212
+
213
+
214
+ def write_recommendation_document(
215
+ output: Path,
216
+ catalog: dict[str, Any],
217
+ recommendation_input: dict[str, Any],
218
+ ) -> str:
219
+ """Atomically replace ``output`` only after the document validates."""
220
+
221
+ document = build_recommendation_document(catalog, recommendation_input)
222
+ output.parent.mkdir(parents=True, exist_ok=True)
223
+ temporary_path: Path | None = None
224
+ try:
225
+ with tempfile.NamedTemporaryFile(
226
+ mode="w",
227
+ encoding="utf-8",
228
+ newline="\n",
229
+ dir=output.parent,
230
+ prefix=f".{output.name}.",
231
+ suffix=".tmp",
232
+ delete=False,
233
+ ) as handle:
234
+ handle.write(document)
235
+ handle.flush()
236
+ os.fsync(handle.fileno())
237
+ temporary_path = Path(handle.name)
238
+ if temporary_path.read_text(encoding="utf-8") != document:
239
+ raise RuntimeError("recommendation artifact changed during atomic write")
240
+ os.chmod(temporary_path, 0o644)
241
+ os.replace(temporary_path, output)
242
+ temporary_path = None
243
+ finally:
244
+ if temporary_path is not None:
245
+ temporary_path.unlink(missing_ok=True)
246
+ return document
247
+
248
+
249
+ def _parser() -> argparse.ArgumentParser:
250
+ parser = argparse.ArgumentParser(description=__doc__)
251
+ parser.add_argument("--input", type=Path, required=True)
252
+ parser.add_argument("--output", type=Path, default=DEFAULT_OUTPUT)
253
+ parser.add_argument("--catalog", type=Path, default=CATALOG_PATH)
254
+ return parser
255
+
256
+
257
+ def main() -> int:
258
+ args = _parser().parse_args()
259
+ try:
260
+ catalog = _read_json_object(args.catalog, label="catalog")
261
+ recommendation_input = _read_json_object(
262
+ args.input,
263
+ label="recommendation input",
264
+ )
265
+ write_recommendation_document(args.output, catalog, recommendation_input)
266
+ except (OSError, RuntimeError, ValueError) as exc:
267
+ raise SystemExit(str(exc)) from exc
268
+ return 0
269
+
270
+
271
+ if __name__ == "__main__":
272
+ raise SystemExit(main())
@@ -0,0 +1,150 @@
1
+ ---
2
+ name: egbe-os-product-report
3
+ description: Package Business Loop results or requested status reviews as concise updates, Markdown and offline HTML.
4
+ metadata:
5
+ egbe-when: "Offer when decisions need a business overview; use for on-demand and scheduled reports."
6
+ egbe-visible: "true"
7
+ egbe-title: "Your product at a glance"
8
+ egbe-description: "See how your product, spending and customer acquisition are doing, what needs attention and what your agent can help improve."
9
+ egbe-category: "Business operations"
10
+ ---
11
+
12
+ <!-- egbe-mcp-connection:v1 -->
13
+ This skill comes with the Egbe plugin. If this project has its own installed copy
14
+ of the skill, use that copy instead. Otherwise make every Egbe API call it
15
+ describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
16
+ PUT, PATCH and DELETE (with `method`). Pass the API path (for example
17
+ `/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
18
+ `egbe-curl.py` and catalog update checks; the connection authenticates and
19
+ identifies the request. Also pass the `business` that `egbe_setup` returned.
20
+ Where this skill sends an `Idempotency-Key` header, pass the same value as
21
+ `idempotency_key` and reuse it when retrying. A result with a `continuation`
22
+ holds one part of a long body; read the next part with `egbe_read`, the same
23
+ `path` and `business`, and that `continuation`.
24
+ Read bundled files beside this `SKILL.md`. For published skill resources on
25
+ Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
26
+
27
+ Publishing works through the connector: commit the app's files with the JSON
28
+ commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
29
+ commit SHA; no git push or workspace setup is needed. A step that needs a local
30
+ project key or a bundled script, such as a local `npx convex deploy`, needs a
31
+ set-up project workspace. In a persistent
32
+ project workspace that is not set up yet, set it up as the `egbe-setup` skill's
33
+ project setup describes.
34
+ Without such a workspace, or if it refuses, tell the founder that this step needs
35
+ an agent with a set-up project folder, and continue with the rest of the work.
36
+
37
+ If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
38
+ available, the plugin's connector is not signed in for this agent. Tell
39
+ the founder how to connect it, as the `egbe-setup` skill describes, rather than
40
+ saying Egbe is unavailable.
41
+
42
+ The connector's tools work even where this environment's shell cannot reach
43
+ Egbe: their calls travel through this agent's connection, not through the
44
+ shell's network. A step that runs in the shell, such as a bundled script, a `git
45
+ push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
46
+ Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
47
+ before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
48
+ the founder: they allow that host in this agent's network settings or continue
49
+ with an agent on their own computer. Code can also be published without the
50
+ shell by committing through the connector (`egbe-os-git`, "Without a terminal").
51
+ Until the shell step or that commit and its deploy succeed, do not report the
52
+ work as published: a preview in this agent or on this computer is not an Egbe
53
+ deployment.
54
+
55
+
56
+ # Product report
57
+
58
+ Help the founder understand what is happening, what matters and what to do next.
59
+ Reporting is read-only with respect to the product and external services; it does
60
+ not authorize fixes, campaign changes, spending or outreach. Use `egbe-os-product-routines`
61
+ to configure or change a schedule, not as a prerequisite for a manual report.
62
+
63
+ ## Establish the context
64
+
65
+ Identify the business from the project's configured Egbe connection and existing
66
+ product records. Reuse local credentials without copying them into artifacts.
67
+ Select `brief` for a status request or agreed short update; select `detailed` for
68
+ the Business Loop result or an explicit request for a full report.
69
+
70
+ Use the requested period and project/user timezone. A status request concerns
71
+ the current state, with today's results where applicable. A Business Loop reports
72
+ its current checkpoint and each measure's actual window; an existing standalone
73
+ daily report retains its agreed previous-calendar-day period. Choosing detailed output does not
74
+ turn a current-state request into a historical review. Keep current balances
75
+ and availability separate from period totals. If the timezone is unknown,
76
+ disclose the harness timezone used.
77
+
78
+ Read [artifact storage](references/artifacts.md), the latest relevant snapshot
79
+ and summary, and the previous detailed report when useful. Use known goals,
80
+ open issues, agreed experiments and founder decisions to interpret the state;
81
+ include them in the report only when relevant to its conclusion or next step.
82
+ When a recommendation depends on an earlier decision, read the relevant plan,
83
+ audit or decision record and distinguish its findings from current evidence.
84
+ When the Business Loop supplies its result, reuse its conclusions, evidence and
85
+ current plan. Check coverage and presentation without starting a second business
86
+ review or inventing another next step. A contradiction or missing material fact
87
+ returns to the caller for resolution; retain useful partial results meanwhile.
88
+ For a standalone report needing product interpretation, read the project's `egbe-docs/playbooks/product.md`
89
+ and `product/evaluate.md`; use `product/diagnose.md` only when a consequential
90
+ question needs it. For market/acquisition interpretation use
91
+ `egbe-docs/playbooks/market-and-acquisition.md`, its `evaluate.md` and the relevant
92
+ channel supplement, together with the concrete plan. Apply local
93
+ adaptations, including how recommendations and decisions are handled. The report
94
+ may reason from fresh observations and recommend a next step without an existing
95
+ results file; it does not change the product, campaign, accepted plan or standing method.
96
+ If these files are inaccessible, disclose that gap and limit dependent judgments
97
+ instead of replacing them with a bundled business strategy.
98
+ Do not reread all history or imply that an unread audit supports the report.
99
+ Establish the product's stage from its records and owned deployed apps, not the
100
+ contents of the local folder: a new connection can belong to an existing product.
101
+
102
+ ## Gather supporting evidence
103
+
104
+ Follow [sources and measurement](references/sources.md). Reuse recent evidence
105
+ only when its scope and time fit this report; fetch what is missing or changed.
106
+ Supplied Business Loop evidence is reusable under the same checks, without
107
+ repeating its collection.
108
+ Save the supporting facts and coverage in `snapshot.json`.
109
+
110
+ Read only the selected reporting guide:
111
+
112
+ - [Brief update](references/brief.md): a compact status and one useful next step.
113
+ - [Detailed result](references/daily.md): a complete `report.md` with the relevant
114
+ findings, work status, decisions and their basis; no fixed business sections.
115
+
116
+ Keep the work proportional to the decision. A routine report is not a mandatory
117
+ full funnel audit, repository review or market study. When a finding needs deeper
118
+ investigation, identify the uncertainty and propose a focused next task.
119
+
120
+ ## Prepare, verify and deliver
121
+
122
+ Write as the founder's partner: use first person for your recommendations and
123
+ offers of help. Explain technical findings by their effect on the product or
124
+ customer journey; keep implementation terms and diagnostic details in the
125
+ supporting evidence unless the founder needs them to decide.
126
+ Name pages and steps by their customer purpose, not internal routes; report
127
+ whether customers can reach them, not HTTP codes or serving revisions.
128
+
129
+ For a detailed run, finish `report.md` first. Derive `summary.md` and use `egbe-os-report-ui`
130
+ to create `report.html` from that report. Visual composition may differ; facts,
131
+ recommendations and material limitations must not. Correct content in Markdown
132
+ first, then update both derived outputs. For a brief run, `summary.md` is the
133
+ complete authored result; no full report or HTML is required.
134
+
135
+ Check arithmetic, links and agreement between formats. For each headline and
136
+ zero/absence claim, verify that the source's ownership, definition, period and
137
+ coverage support the whole claim; narrow it when they do not.
138
+ A failed source can still yield a useful partial report; disclose what
139
+ could not be checked. If HTML rendering fails, deliver the verified Markdown
140
+ and summary, explicitly leaving HTML unfinished.
141
+
142
+ For scheduled output, honor the caller's notification decision: prepare without
143
+ sending when notification is not required. Otherwise send the summary in the
144
+ founder's language with light formatting and links to the actual local
145
+ artifacts. A local path is not a public URL: when the recipient cannot open the
146
+ file, attach it through Egbe mail (`attachments` on `POST /mail/send`, see
147
+ `egbe-os-mail`) or put what they need in the message itself, and say where the
148
+ full report is kept, without publishing it elsewhere by default. Record the result under the artifact contract. For a
149
+ scheduled run, return the artifact path and coverage/delivery outcome to
150
+ `egbe-os-product-routines`; a manual report does not create or advance its schedule.
@@ -0,0 +1,84 @@
1
+ # Report artifacts
2
+
3
+ ## Location and ownership
4
+
5
+ Store reports in the current product's local workspace:
6
+ `egbe-docs/reports/<UTC timestamp>-<mode>/`, for example
7
+ `2026-10-20T090000Z-detailed/`. For several Egbe businesses in one workspace,
8
+ prefix the report ID with the verified business ID. Do not mix their history.
9
+ Use `brief` or `detailed`; append a unique suffix if a separate run collides.
10
+
11
+ Use the existing product repository when present; reporting does not require
12
+ creating a repository, committing, pushing or publishing. Do not use the
13
+ installed skill folder as artifact storage. Keep reports out of public/static
14
+ app directories and exclude all `egbe-docs/` from the build context.
15
+
16
+ Through the Egbe connector without a project folder, keep the same files at the
17
+ same paths in Egbe's artifact store, as `egbe-os-quickstart` →
18
+ `references/artifact-sync.md` ("Through the Egbe connector") describes, and
19
+ render `report.html` there only if `egbe-os-report-ui` can run; otherwise leave
20
+ HTML unfinished as the skill describes.
21
+
22
+ ## Files
23
+
24
+ | File | Brief | Detailed | Purpose |
25
+ |---|---|---|---|
26
+ | `snapshot.json` | Yes | Yes | Facts, provenance, windows and coverage |
27
+ | `summary.md` | Yes | Yes | The message delivered to the founder |
28
+ | `report.md` | No | Yes | Canonical complete findings and proposals |
29
+ | `report.html` | No | Yes | Offline presentation derived from report.md |
30
+
31
+ Markdown owns the interpretation, not `snapshot.json`. For detailed reports,
32
+ change content in `report.md` first and refresh both derived outputs. Do not
33
+ silently overwrite a different completed run.
34
+
35
+ ## Minimal snapshot contract
36
+
37
+ Keep these fields stable; the observations themselves depend on the product:
38
+
39
+ - `project_id`, `run_id`, `mode`, `trigger` (`manual` or `scheduled`).
40
+ - `generated_at`: timestamp with offset; `timezone`: the reporting IANA timezone.
41
+ - `period`: `from` and `to` timestamps, start inclusive and end exclusive.
42
+ - `sources`: entries with a stable `id`, capability/reference, scope,
43
+ `checked_at`, status (`ok`, `partial`, `unavailable`, `not_applicable`) and a
44
+ concise reason when coverage is limited. Record actual data freshness if known.
45
+ - `observations`: entries with an `id`, name/definition, value, unit where
46
+ applicable and `source_ids`. Record `as_of` for point-in-time states or a
47
+ `period` for windowed values; aggregate granularity must be explicit.
48
+ - `result`: `status` (`in_progress`, `complete`, `incomplete`), overall
49
+ `coverage` (`complete`, `partial`, `unavailable`), produced file paths and any
50
+ unfinished output/check. A complete report can have partial source coverage.
51
+
52
+ Assess coverage against the applicable questions, metrics and period of this
53
+ report, not every feature a provider could supply. Mark a missing breakdown
54
+ as a limitation of that analysis, not of otherwise complete totals.
55
+ `not_applicable` sources alone do not make overall coverage partial: a new
56
+ project can have a complete status report without a deployed product or sales.
57
+
58
+ Use `null` for an unavailable value with the reason in its source record, not
59
+ an invented zero. Keep only aggregates and sanitized evidence used by the
60
+ report, not whole API payloads, credentials, customer identities or raw logs.
61
+ The report can cite observation/source IDs and source links or query descriptions;
62
+ do not embed authenticated URLs.
63
+
64
+ ## Continuation and delivery
65
+
66
+ Start with the latest applicable summary/snapshot. Read the prior detailed
67
+ report and older evidence only when they explain an open question or decision.
68
+ Compare only matching scopes, definitions and windows. Keep recommendations
69
+ already accepted, rejected or underway visible in the authored result.
70
+
71
+ On interruption, leave the run incomplete and resume its missing work rather
72
+ than treating partial files as a finished report. Set `result.status` after
73
+ verification, independently of data coverage. If rendering failed, retain the
74
+ valid Markdown and record the missing HTML; the summary can still be delivered.
75
+ Required checks that could not run, including visual HTML verification, also
76
+ leave the result `incomplete` with those checks listed; they do not invalidate
77
+ verified facts or prevent delivery with an explicit limitation.
78
+ Keep the detailed validation ledger here, not in the report narrative. In the
79
+ founder handoff, name only the practical limitation and available alternative.
80
+
81
+ The scheduling owner is `egbe-os-product-routines`. It stores settings and delivery
82
+ checkpoints separately in the versioned `egbe-docs/routines.json`, and advances
83
+ them only after the relevant action is confirmed. Saving a report does not prove
84
+ that a notification was delivered. A manual run does not consume scheduled slots.
@@ -0,0 +1,34 @@
1
+ # Brief founder update
2
+
3
+ Give the founder a useful picture in one short, scannable message. Cover the
4
+ areas below when applicable, combining them rather than making a long checklist:
5
+
6
+ - Available Egbe funds and any material spending or funding constraint.
7
+ - Product availability and confirmed consequential failures.
8
+ - Connected advertising: what is running, blocked or stopped; spend and
9
+ remaining agreed budget where known.
10
+ - Today's visitors, registrations, meaningful activation and purchases/revenue,
11
+ distinguishing unavailable measurements from zero.
12
+ - Important changes since the previous comparable report.
13
+
14
+ Put an urgent problem first. Separate status, results and the next step with
15
+ short headings or bold labels; use bullets for distinct items, not a wall of
16
+ paragraphs. Explain status in founder language rather than API codes, skill
17
+ names or internal IDs. Name the outcome Egbe enables, not the instruction file.
18
+ Name the reporting period and surface coverage gaps that affect a decision.
19
+ For an empty project, state what is actually available and the product's current
20
+ stage; do not fabricate a funnel or suggest repairing nonexistent instrumentation.
21
+ Combine areas with the same status. Prefer a precise label and scope to a
22
+ paragraph of qualifications; keep collection details in the snapshot.
23
+ Give each bullet one main message. Omit explanations of distinctions already
24
+ clear from the label, and empty integrations that do not affect today's decision.
25
+
26
+ End with the next step justified by the current project method and plan: the
27
+ problem or opportunity, proposed improvement, purpose and what I can do with Egbe.
28
+ Keep an agreed continuation as the next step when that is the conclusion; do not
29
+ invent novelty to fill the format. Preserve uncertainty and any decision needed.
30
+
31
+ A scheduled digest is still delivered when nothing changed, proportionately
32
+ short; an alerts-only routine follows its agreed notification condition instead.
33
+ Preserve any delivered message as `summary.md`.
34
+ Do not create `report.md` and HTML just to expand a brief update.
@@ -0,0 +1,76 @@
1
+ # Detailed product result
2
+
3
+ Package the Business Loop's supplied result, or prepare a requested standalone
4
+ review using the method and plan loaded by the entrypoint. Do not recompute the
5
+ loop's priorities as an independent reporting task. Product, advertising and analytics are possible topics,
6
+ not mandatory output sections. Apply the method to current evidence and explain
7
+ the supported conclusions; reporting does not authorize changes or require a
8
+ full audit. Keep existing decisions, observed state and proposed work distinct.
9
+
10
+ ## Write the canonical report
11
+
12
+ Select the useful conclusions before writing `report.md`: what is happening,
13
+ why it matters and what decision or next step follows. For a loop result, make
14
+ the current focus, meaningful changes, progress and any founder decision clear;
15
+ link to the existing work record instead of maintaining another task list.
16
+ Include the facts and
17
+ reasoning needed to support those conclusions. Add depth for genuine tradeoffs
18
+ or contested interpretations, not merely because the requested format is full.
19
+
20
+ Use direct, scoped statements. A precise label or time basis is often enough
21
+ to avoid an overclaim; it does not need a paragraph listing everything the
22
+ number is not. Explain a material limitation once beside the affected claim.
23
+ Other possible interpretations or things that were not checked belong in
24
+ evidence unless they change the decision. Group areas sharing one status.
25
+ Do not teach the reader how every source works or argue against mistakes the
26
+ report never makes. For each area, keep the useful result, its consequence and
27
+ any needed action; put reconciliation detail and secondary measurements in the
28
+ snapshot. A precise metric label can replace a repeated “this does not mean…”
29
+ explanation.
30
+
31
+ Keep source IDs, query details, arithmetic checks and execution/validation
32
+ logs in `snapshot.json`. The Markdown should be useful on its own, with links
33
+ to that evidence, not a narration of the reporting process.
34
+
35
+ Edit the report before deriving other formats. Every block must answer a
36
+ founder question or justify a consequential conclusion. Remove a passage if
37
+ it adds neither a fact needed to understand the situation nor a reason to
38
+ choose an action. Merge repeated qualifications; omit inapplicable metrics and
39
+ sections instead of filling them with explanations of their absence.
40
+ Detailed means adequately explained, not necessarily longer than the brief.
41
+ When little has started or changed, the canonical report may be close to the
42
+ summary in length; do not expand an uneventful status into a catalogue of
43
+ possible concerns.
44
+
45
+ Make the next step actionable: name the concrete result you can produce,
46
+ the founder's necessary input or decision, and how the result determines what
47
+ happens next. Separate work that can start now from work waiting on that input.
48
+ Offer a simple way to continue in chat; distinguish preparation from authorized
49
+ execution. A copyable instruction can help, but does not itself start the work.
50
+
51
+ ## Derive the founder-facing outputs
52
+
53
+ Create `summary.md` from the completed report. Use short titled blocks and
54
+ bullets for distinct facts and proposals, with selective emphasis, so the
55
+ founder can understand the outcome and important decisions in about a minute.
56
+ Length follows useful content, not a word quota. Retain limitations that change
57
+ a decision, preserve the reason behind the main recommendation, and link to
58
+ the relevant sections, not only beside recommendations.
59
+ Explain necessary metric terms in plain language.
60
+ Use a separate bullet for each distinct result or action rather than stacking
61
+ long paragraphs under bold opening sentences. Keep test and rendering logs out
62
+ of this message; mention an output limitation once, briefly, if it affects use.
63
+
64
+ Use `egbe-os-report-ui` for the visual edition of the report. Supply the content's
65
+ relative importance: what the founder should understand at a glance and what
66
+ supports closer reading. Let presentation express those relationships rather
67
+ than map every Markdown heading or paragraph to a screen block.
68
+
69
+ Verify semantic agreement, not identical wording: findings, values, priorities,
70
+ evidence and material limitations must remain accessible. Add working anchors
71
+ for summary links. If HTML is unavailable, link to Markdown and say so.
72
+
73
+ Read the result as the founder: is it clear what to improve first and why,
74
+ what remains a hypothesis, what you will deliver next, and how to ask for it?
75
+ Revise vague investigations or task menus that leave those decisions to the
76
+ reader; do not invent a diagnosis to make the answer sound decisive.