@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,137 @@
1
+ """Capture/finalize state transitions and bounded, explicitly resumed delivery."""
2
+ import time
3
+ from uuid import uuid4
4
+
5
+ from . import protocol, transport
6
+
7
+
8
+ def capture(store, paths, *, unknown=False):
9
+ selected = protocol.method_paths(store.root, paths)
10
+ for record in store.records():
11
+ if record["status"] == "captured" and set(paths) & {item["path"] for item in record["files"]}:
12
+ raise ValueError("An unfinished capture already includes this file; resume or explicitly discard it")
13
+ base, key = transport.connection(store.root)
14
+ project_id = transport.identity(base, key)
15
+ files = [{"path": name, "before": protocol.snapshot(store.root, name, before=True, unknown=unknown)}
16
+ for name, _ in selected]
17
+ value = {"version": 1, "change_id": str(uuid4()), "origin": base,
18
+ "expected_project_id": project_id, "files": files, "status": "captured",
19
+ "created_at": protocol.now(), "attempts": 0, "next_retry_at": 0}
20
+ if len(protocol.canonical(files)) > protocol.MAX_PACKET:
21
+ raise ValueError("Selected before snapshots exceed the 2 MiB packet budget")
22
+ store.save(value, new=True)
23
+ return {"change_id": value["change_id"], "status": value["status"], "files": len(files)}
24
+
25
+
26
+ def finalize(store, identity, *, reason, expected_effect, initiator):
27
+ value = store.load(identity)
28
+ if value["status"] != "captured":
29
+ raise ValueError("This capture is already finalized; send its existing packet")
30
+ reason = protocol.metadata(reason, "reason", 4000)
31
+ effect = protocol.metadata(expected_effect, "expected_effect", 4000)
32
+ initiator = protocol.metadata(initiator, "initiator", 256)
33
+ paths = protocol.method_paths(store.root, [item["path"] for item in value["files"]])
34
+ changed = []
35
+ for item, (name, _) in zip(value["files"], paths):
36
+ before, after = item["before"], protocol.snapshot(store.root, name)
37
+ same = before["state"] == after["state"] and before["text"] == after["text"]
38
+ same = same or before["state"] == "absent" and after["state"] == "deleted"
39
+ if not same:
40
+ changed.append({**item, "after": after})
41
+ if not changed:
42
+ # Retain a compact local disposition; no server event and no private text.
43
+ value.pop("files")
44
+ value["status"] = "no_change"
45
+ store.save(value)
46
+ return {"change_id": identity, "status": "no_change"}
47
+ packet = {"client_change_id": identity, "expected_project_id": value["expected_project_id"],
48
+ "reason": reason, "expected_effect": effect, "initiator": initiator, "files": changed}
49
+ if len(protocol.canonical(packet)) > protocol.MAX_PACKET:
50
+ raise ValueError("Change packet exceeds 2 MiB; capture is preserved, do not truncate the text")
51
+ value.pop("files")
52
+ value.update(status="pending", packet=packet, content_hash=protocol.digest(packet))
53
+ store.save(value)
54
+ return {"change_id": identity, "status": "pending", "files": len(changed)}
55
+
56
+
57
+ def failure(store, value, error):
58
+ value["attempts"] += 1
59
+ value["error_code"] = error.code
60
+ if error.transient:
61
+ value["status"] = "pending"
62
+ value["next_retry_at"] = time.time() + max(error.retry_after, min(60 * 2 ** min(value["attempts"] - 1, 10), 3600))
63
+ else:
64
+ value["status"] = "held"
65
+ value["next_retry_at"] = 0
66
+ store.save(value)
67
+
68
+
69
+ def send(store, *, retry_held=None, max_packets=5, budget_seconds=30):
70
+ if not 1 <= max_packets <= 5 or not 1 <= budget_seconds <= 30:
71
+ raise ValueError("Send is limited to five packets and thirty seconds")
72
+ if retry_held:
73
+ protocol.change_id(retry_held)
74
+ target = store.load(retry_held)
75
+ if target["status"] != "held":
76
+ raise ValueError("Explicit retry expects a held record")
77
+ # An explicit recovery request must not be starved by unrelated due packets.
78
+ records = [target] if retry_held else [value for value in store.records() if
79
+ value["status"] == "pending" and value["next_retry_at"] <= time.time()]
80
+ records = records[:max_packets]
81
+ if not records:
82
+ return {"attempted": 0, "delivered": 0, "pending": 0, "held": 0}
83
+ base, key = transport.connection(store.root)
84
+ deadline = time.monotonic() + budget_seconds
85
+ result = {"attempted": 0, "delivered": 0, "pending": 0, "held": 0}
86
+ project = None
87
+ identity_error = None
88
+ for value in records:
89
+ if time.monotonic() >= deadline:
90
+ break
91
+ result["attempted"] += 1
92
+ try:
93
+ if value["origin"] != base:
94
+ raise transport.DeliveryError("origin_mismatch")
95
+ if (protocol.digest(value["packet"]) != value["content_hash"]
96
+ or value["packet"].get("client_change_id") != value["change_id"]
97
+ or value["packet"].get("expected_project_id") != value["expected_project_id"]):
98
+ raise transport.DeliveryError("frozen_packet_changed")
99
+ if identity_error:
100
+ raise identity_error
101
+ if project is None:
102
+ try:
103
+ project = transport.identity(base, key, timeout=max(0.1, min(10, deadline - time.monotonic())))
104
+ except transport.DeliveryError as error:
105
+ identity_error = error
106
+ raise
107
+ if project != value["expected_project_id"]:
108
+ raise transport.DeliveryError("project_mismatch")
109
+ remaining = deadline - time.monotonic()
110
+ if remaining <= 0:
111
+ raise transport.DeliveryError("delivery_budget_exhausted", transient=True)
112
+ received = transport.request(base, key, "/playbooks/changes", packet=value["packet"], timeout=min(10, remaining))
113
+ try:
114
+ receipt = protocol.receipt(received, value["content_hash"])
115
+ except (ValueError, TypeError, AttributeError):
116
+ raise transport.DeliveryError("unverified_receipt", transient=True) from None
117
+ value.update(status="delivered", receipt=receipt, next_retry_at=0)
118
+ value.pop("error_code", None)
119
+ # The server confirmed the immutable packet: keep only the receipt
120
+ # locally, not an unbounded second archive of method snapshots.
121
+ value.pop("packet")
122
+ store.save(value)
123
+ except transport.DeliveryError as error:
124
+ failure(store, value, error)
125
+ result[value["status"]] += 1
126
+ return result
127
+
128
+
129
+ def status(store, identity=None):
130
+ values = [store.load(identity)] if identity else [value for value in store.records()
131
+ if value["status"] in {"captured", "pending", "held"}]
132
+ return [{"change_id": value["change_id"], "status": value["status"],
133
+ "project_id": value["expected_project_id"], "created_at": value["created_at"],
134
+ **({"error_code": value["error_code"]} if value.get("error_code") else {}),
135
+ **({"next_retry_at": value["next_retry_at"]} if value.get("next_retry_at") else {}),
136
+ **({"receipt": value["receipt"]} if value.get("receipt") else {})}
137
+ for value in values]
@@ -0,0 +1,132 @@
1
+ """Wire representation and path/content checks, without transport or persistence."""
2
+ from datetime import datetime, timezone
3
+ import hashlib
4
+ import json
5
+ import os
6
+ from pathlib import Path, PurePosixPath
7
+ import stat
8
+ from uuid import UUID
9
+
10
+ MAX_FILES = 16
11
+ MAX_TEXT = 256 * 1024
12
+ MAX_PACKET = 2 * 1024 * 1024
13
+
14
+
15
+ def now():
16
+ return datetime.now(timezone.utc).isoformat()
17
+
18
+
19
+ def canonical(value):
20
+ return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":")).encode("utf-8")
21
+
22
+
23
+ def digest(value):
24
+ return hashlib.sha256(canonical(value)).hexdigest()
25
+
26
+
27
+ def change_id(value):
28
+ try:
29
+ normalized = str(UUID(value))
30
+ except (ValueError, TypeError, AttributeError):
31
+ raise ValueError("Invalid change ID") from None
32
+ if normalized != value:
33
+ raise ValueError("Use the canonical change ID returned by capture")
34
+ return normalized
35
+
36
+
37
+ def valid_path(value):
38
+ parts = value.split("/")
39
+ if (len(parts) < 3 or parts[:2] != ["egbe-docs", "playbooks"]
40
+ or any(part in {"", ".", ".."} or part.startswith(".") for part in parts)
41
+ or any(char in value for char in "\\%?#:\x00")
42
+ or any(ord(char) < 32 or ord(char) == 127 for char in value) or len(value) > 512
43
+ or PurePosixPath(value).suffix != ".md"):
44
+ raise ValueError("Choose relative Markdown files under egbe-docs/playbooks")
45
+ return value
46
+
47
+
48
+ def method_paths(root, paths):
49
+ if not 1 <= len(paths) <= MAX_FILES:
50
+ raise ValueError("Choose between 1 and 16 method files")
51
+ seen_names, seen_files = set(), set()
52
+ result = []
53
+ for name in paths:
54
+ valid_path(name)
55
+ target = root / name
56
+ current = root
57
+ for part in Path(name).parts:
58
+ current = current / part
59
+ if current.is_symlink():
60
+ raise ValueError("Method files and their parent directories must not be symlinks")
61
+ if target.exists() and not target.is_file():
62
+ raise ValueError("A selected method path is not a regular file")
63
+ resolved = target.resolve()
64
+ if not resolved.is_relative_to(root / "egbe-docs/playbooks") or resolved in seen_names:
65
+ raise ValueError("Duplicate or escaping method path")
66
+ seen_names.add(resolved)
67
+ if target.exists():
68
+ stat = target.stat()
69
+ inode = (stat.st_dev, stat.st_ino)
70
+ if inode in seen_files or stat.st_nlink != 1:
71
+ raise ValueError("Method aliases and hard links are not supported")
72
+ seen_files.add(inode)
73
+ result.append((name, target))
74
+ return result
75
+
76
+
77
+ def open_method(root, name):
78
+ """Walk from an opened workspace directory, rejecting symlink swaps too."""
79
+ flags = os.O_RDONLY | getattr(os, "O_NOFOLLOW", 0)
80
+ directory = os.open(root, flags | getattr(os, "O_DIRECTORY", 0))
81
+ try:
82
+ parts = Path(name).parts
83
+ for part in parts[:-1]:
84
+ child = os.open(part, flags | getattr(os, "O_DIRECTORY", 0), dir_fd=directory)
85
+ os.close(directory)
86
+ directory = child
87
+ return os.open(parts[-1], flags | getattr(os, "O_NONBLOCK", 0), dir_fd=directory)
88
+ finally:
89
+ os.close(directory)
90
+
91
+
92
+ def snapshot(root, name, *, before=False, unknown=False):
93
+ if unknown:
94
+ return {"state": "unknown", "text": None, "captured_at": now()}
95
+ try:
96
+ descriptor = open_method(root, name)
97
+ except FileNotFoundError:
98
+ return {"state": "absent" if before else "deleted", "text": None, "captured_at": now()}
99
+ # Decode bytes explicitly: text-mode reads would normalize CRLF.
100
+ with os.fdopen(descriptor, "rb") as stream:
101
+ initial = os.fstat(stream.fileno())
102
+ if not stat.S_ISREG(initial.st_mode) or initial.st_nlink != 1:
103
+ raise ValueError("Method snapshots require regular files without hard links")
104
+ raw = stream.read(MAX_TEXT + 1)
105
+ final = os.fstat(stream.fileno())
106
+ if (initial.st_size, initial.st_mtime_ns) != (final.st_size, final.st_mtime_ns):
107
+ raise ValueError("Method file changed during capture; retry after editing stops")
108
+ if len(raw) > MAX_TEXT:
109
+ raise ValueError("A method snapshot exceeds 256 KiB")
110
+ try:
111
+ text = raw.decode("utf-8")
112
+ except UnicodeDecodeError:
113
+ raise ValueError("Method files must be UTF-8") from None
114
+ if "\x00" in text:
115
+ raise ValueError("Method files must not contain NUL")
116
+ return {"state": "captured", "text": text, "captured_at": now()}
117
+
118
+
119
+ def metadata(value, field, maximum):
120
+ if not isinstance(value, str) or not value.strip() or len(value) > maximum or "\x00" in value:
121
+ raise ValueError(f"{field} must contain 1–{maximum} characters without NUL")
122
+ return value
123
+
124
+
125
+ def receipt(value, expected_hash):
126
+ if not isinstance(value, dict) or value.get("content_hash") != expected_hash:
127
+ raise ValueError("Delivery returned an unverified receipt")
128
+ change_id(value.get("id"))
129
+ stamp = datetime.fromisoformat(value.get("received_at", "").replace("Z", "+00:00"))
130
+ if stamp.tzinfo is None:
131
+ raise ValueError("Receipt time must include timezone")
132
+ return {key: value[key] for key in ("id", "content_hash", "received_at")}
@@ -0,0 +1,180 @@
1
+ """Private, locked, atomic local records; never persist credentials."""
2
+ from contextlib import contextmanager
3
+ import json
4
+ import os
5
+ from pathlib import Path
6
+ import subprocess
7
+ import tempfile
8
+
9
+ from .protocol import canonical, change_id
10
+
11
+ MAX_ACTIVE = 100
12
+ MAX_STORAGE = 64 * 1024 * 1024
13
+ MAX_RECORD = 5 * 1024 * 1024
14
+ ACTIVE = {"captured", "pending", "held"}
15
+
16
+
17
+ def regular(path):
18
+ if path.is_symlink() or (path.exists() and not path.is_file()):
19
+ raise ValueError("Transport and exclusion files must be regular files")
20
+
21
+
22
+ def atomic_write(path, value):
23
+ regular(path)
24
+ raw = canonical(value)
25
+ descriptor, temp = tempfile.mkstemp(prefix=".write-", dir=path.parent)
26
+ try:
27
+ with os.fdopen(descriptor, "wb") as stream:
28
+ stream.write(raw)
29
+ stream.flush()
30
+ os.fsync(stream.fileno())
31
+ os.replace(temp, path)
32
+ if os.name != "nt":
33
+ directory = os.open(path.parent, os.O_RDONLY)
34
+ try:
35
+ os.fsync(directory)
36
+ finally:
37
+ os.close(directory)
38
+ finally:
39
+ if os.path.exists(temp):
40
+ os.unlink(temp)
41
+
42
+
43
+ class Store:
44
+ def __init__(self, root):
45
+ self.root = Path(root).resolve(strict=True)
46
+ self.path = self.root / "egbe-docs/.local/playbook-changes"
47
+
48
+ def require_inspectable_checkout(self):
49
+ markers = (folder / ".git" for folder in (self.root, *self.root.parents))
50
+ if any(path.exists() or path.is_symlink() for path in markers) or os.environ.get("GIT_DIR") or os.environ.get("GIT_WORK_TREE"):
51
+ raise ValueError("Existing Git checkout cannot be inspected; resolve Git access before recording")
52
+
53
+ def prepare(self):
54
+ for name, rule in ((".gitignore", "/egbe-docs/.local/"),
55
+ (".dockerignore", "/egbe-docs/")):
56
+ path = self.root / name
57
+ regular(path)
58
+ text = path.read_text(encoding="utf-8") if path.exists() else ""
59
+ # Last match wins; append after any existing negations.
60
+ if not text.splitlines() or text.splitlines()[-1] != rule:
61
+ with path.open("a", encoding="utf-8") as stream:
62
+ stream.write(("\n" if text and not text.endswith("\n") else "") + rule + "\n")
63
+ # An ignore rule cannot make an already tracked file private.
64
+ try:
65
+ tracked = subprocess.run(
66
+ ["git", "-C", str(self.root), "ls-files", "--", "egbe-docs/.local"],
67
+ capture_output=True, timeout=5, check=False,
68
+ )
69
+ except (FileNotFoundError, subprocess.TimeoutExpired):
70
+ self.require_inspectable_checkout()
71
+ tracked = None
72
+ if tracked and tracked.returncode != 0:
73
+ self.require_inspectable_checkout()
74
+ if tracked and tracked.returncode == 0 and tracked.stdout.strip():
75
+ raise ValueError("Private egbe-docs/.local files are tracked by Git; resolve before capture")
76
+ current = self.root
77
+ for part in self.path.relative_to(self.root).parts:
78
+ current /= part
79
+ if current.is_symlink() or (current.exists() and not current.is_dir()):
80
+ raise ValueError("Transport directories must not be symlinks or files")
81
+ current.mkdir(mode=0o700, exist_ok=True)
82
+ # A deeper egbe-docs/.gitignore can negate the root exclusion. Keep the
83
+ # transport's own rule closest to its files, and verify each real write.
84
+ exclusion = self.path / ".gitignore"
85
+ regular(exclusion)
86
+ text = exclusion.read_text(encoding="utf-8") if exclusion.exists() else ""
87
+ if not text.splitlines() or text.splitlines()[-1] != "*":
88
+ with exclusion.open("a", encoding="utf-8") as stream:
89
+ stream.write(("\n" if text and not text.endswith("\n") else "") + "*\n")
90
+
91
+ def verify_ignored(self, path):
92
+ try:
93
+ repository = subprocess.run(["git", "-C", str(self.root), "rev-parse", "--is-inside-work-tree"],
94
+ capture_output=True, timeout=5, check=False)
95
+ if repository.returncode != 0:
96
+ self.require_inspectable_checkout()
97
+ return # No repository yet; the local ignore rule applies after init.
98
+ ignored = subprocess.run(["git", "-C", str(self.root), "check-ignore", "--quiet", "--",
99
+ str(path.relative_to(self.root))],
100
+ capture_output=True, timeout=5, check=False)
101
+ except (FileNotFoundError, subprocess.TimeoutExpired):
102
+ self.require_inspectable_checkout()
103
+ return
104
+ if ignored.returncode != 0:
105
+ raise ValueError("Private transport path is not Git-ignored; resolve exclusions before recording")
106
+
107
+ @contextmanager
108
+ def locked(self):
109
+ self.prepare()
110
+ lock = self.path / ".lock"
111
+ regular(lock)
112
+ descriptor = os.open(lock, os.O_RDWR | os.O_CREAT | getattr(os, "O_NOFOLLOW", 0), 0o600)
113
+ with os.fdopen(descriptor, "r+b") as stream:
114
+ if os.name == "nt":
115
+ import msvcrt
116
+ stream.write(b"0")
117
+ stream.flush()
118
+ stream.seek(0)
119
+ msvcrt.locking(stream.fileno(), msvcrt.LK_NBLCK, 1)
120
+ else:
121
+ import fcntl
122
+ fcntl.flock(stream.fileno(), fcntl.LOCK_EX | fcntl.LOCK_NB)
123
+ try:
124
+ yield self
125
+ finally:
126
+ if os.name == "nt":
127
+ stream.seek(0)
128
+ msvcrt.locking(stream.fileno(), msvcrt.LK_UNLCK, 1)
129
+ else:
130
+ fcntl.flock(stream.fileno(), fcntl.LOCK_UN)
131
+
132
+ def load(self, identity):
133
+ path = self.path / (change_id(identity) + ".json")
134
+ regular(path)
135
+ if path.stat().st_size > MAX_RECORD:
136
+ raise ValueError("A local transport record exceeds its size limit")
137
+ try:
138
+ value = json.loads(path.read_bytes())
139
+ except (ValueError, UnicodeDecodeError):
140
+ raise ValueError("A local transport record is invalid; preserve it for inspection") from None
141
+ if (not isinstance(value, dict) or value.get("version") != 1 or value.get("change_id") != identity
142
+ or value.get("status") not in ACTIVE | {"delivered", "no_change"}
143
+ or type(value.get("expected_project_id")) is not int or value["expected_project_id"] <= 0
144
+ or not isinstance(value.get("origin"), str) or not isinstance(value.get("created_at"), str)
145
+ or type(value.get("attempts")) is not int or value["attempts"] < 0
146
+ or not isinstance(value.get("next_retry_at"), (int, float))):
147
+ raise ValueError("A local transport record has an unknown format or identity")
148
+ if value["status"] == "captured" and not isinstance(value.get("files"), list):
149
+ raise ValueError("Local capture contents are invalid; preserve the file for inspection")
150
+ if value["status"] in {"pending", "held"} and (not isinstance(value.get("packet"), dict)
151
+ or not isinstance(value.get("content_hash"), str)):
152
+ raise ValueError("Local packet contents are invalid; preserve the file for inspection")
153
+ return value
154
+
155
+ def records(self):
156
+ return [self.load(path.stem) for path in sorted(self.path.glob("*.json"))]
157
+
158
+ def save(self, value, *, new=False):
159
+ path = self.path / (change_id(value["change_id"]) + ".json")
160
+ self.verify_ignored(path)
161
+ if new and path.exists():
162
+ raise ValueError("Refusing to overwrite an existing capture")
163
+ raw = canonical(value)
164
+ if len(raw) > MAX_RECORD:
165
+ raise ValueError("Local capture exceeds its size limit; existing data was preserved")
166
+ size = 0
167
+ for item in self.path.iterdir():
168
+ regular(item)
169
+ size += item.stat().st_size
170
+ if size - (path.stat().st_size if path.exists() else 0) + len(raw) > MAX_STORAGE:
171
+ raise ValueError("Local journal is full; preserve pending records and inspect storage")
172
+ if new and sum(record["status"] in ACTIVE for record in self.records()) >= MAX_ACTIVE:
173
+ raise ValueError("100 unfinished records already exist; resolve delivery before new capture")
174
+ atomic_write(path, value)
175
+
176
+ def discard(self, identity):
177
+ value = self.load(identity)
178
+ if value["status"] != "captured":
179
+ raise ValueError("Only an unfinished, unfinalized capture can be explicitly discarded")
180
+ (self.path / (identity + ".json")).unlink()
@@ -0,0 +1,113 @@
1
+ """Origin-pinned HTTP with no redirects or provider/error-body disclosure."""
2
+ import json
3
+ import os
4
+ import re
5
+ import shlex
6
+ import time
7
+ from urllib.error import HTTPError, URLError
8
+ from urllib.parse import urlsplit
9
+ from urllib.request import HTTPRedirectHandler, Request, build_opener
10
+
11
+ MAX_RESPONSE = 128 * 1024
12
+
13
+
14
+ class DeliveryError(Exception):
15
+ def __init__(self, code, *, transient=False, retry_after=0):
16
+ self.code = code
17
+ self.transient = transient
18
+ self.retry_after = retry_after
19
+ super().__init__(code)
20
+
21
+
22
+ def origin(value):
23
+ parsed = urlsplit(value)
24
+ if (parsed.scheme not in {"https", "http"} or not parsed.hostname
25
+ or parsed.username or parsed.password or parsed.query or parsed.fragment
26
+ or parsed.path not in {"", "/"}
27
+ or (parsed.scheme == "http" and parsed.hostname not in {"localhost", "127.0.0.1", "::1"})):
28
+ raise ValueError("OS_URL must be an HTTPS origin (HTTP is allowed only for loopback tests)")
29
+ if any(ord(char) < 33 for char in value):
30
+ raise ValueError("OS_URL contains invalid characters")
31
+ port = parsed.port
32
+ host = "[" + parsed.hostname + "]" if ":" in parsed.hostname else parsed.hostname
33
+ return parsed.scheme + "://" + host + (f":{port}" if port and port != {"http": 80, "https": 443}[parsed.scheme] else "")
34
+
35
+
36
+ def connection(root):
37
+ path = root / ".env.local"
38
+ if path.is_symlink() or (path.exists() and not path.is_file()):
39
+ raise ValueError("Connection settings must be a regular project-local .env.local file")
40
+ if path.exists():
41
+ if path.stat().st_size > 1024 * 1024:
42
+ raise ValueError("Connection settings file is unexpectedly large")
43
+ values = {}
44
+ for line in path.read_text(encoding="utf-8").splitlines():
45
+ match = re.match(r"(?:export\s+)?(OS_URL|OS_API_KEY)\s*=(.*)$", line.strip())
46
+ if match:
47
+ try:
48
+ pieces = shlex.split(match[2], comments=True)
49
+ except ValueError:
50
+ raise ValueError("Invalid quoting in connection settings") from None
51
+ if len(pieces) != 1:
52
+ raise ValueError("Connection settings must be literal values")
53
+ values[match[1]] = pieces[0]
54
+ else:
55
+ values = {name: os.environ.get(name, "") for name in ("OS_URL", "OS_API_KEY")}
56
+ if not values.get("OS_URL") or not values.get("OS_API_KEY"):
57
+ raise ValueError("Set OS_URL and OS_API_KEY in this project's .env.local first")
58
+ key = values["OS_API_KEY"]
59
+ if len(key) > 4096 or any(ord(char) < 33 or ord(char) > 126 for char in key):
60
+ raise ValueError("Invalid project credential format")
61
+ return origin(values["OS_URL"]), key
62
+
63
+
64
+ class NoRedirects(HTTPRedirectHandler):
65
+ def redirect_request(self, req, fp, code, msg, headers, newurl):
66
+ return None
67
+
68
+
69
+ def request(base, key, path, *, packet=None, timeout=10):
70
+ from .protocol import canonical
71
+ req = Request(base + path, data=canonical(packet) if packet is not None else None,
72
+ headers={"Authorization": "Bearer " + key, "Accept": "application/json",
73
+ "Content-Type": "application/json", "User-Agent": "egbe-playbook-changes/1"},
74
+ method="POST" if packet is not None else "GET")
75
+ try:
76
+ deadline = time.monotonic() + timeout
77
+ with build_opener(NoRedirects()).open(req, timeout=timeout) as response:
78
+ raw = bytearray()
79
+ while True:
80
+ remaining = deadline - time.monotonic()
81
+ if remaining <= 0:
82
+ raise DeliveryError("network_timeout", transient=True)
83
+ # urllib's timeout is per socket operation. Tighten it to the
84
+ # remaining request budget so a slow stream cannot prolong it.
85
+ sock = getattr(getattr(response.fp, "raw", None), "_sock", None)
86
+ if sock is not None:
87
+ sock.settimeout(remaining)
88
+ chunk = response.read1(min(8192, MAX_RESPONSE + 1 - len(raw)))
89
+ if not chunk:
90
+ break
91
+ raw.extend(chunk)
92
+ if len(raw) > MAX_RESPONSE:
93
+ raise DeliveryError("unverified_response", transient=True)
94
+ value = json.loads(raw)
95
+ except HTTPError as error:
96
+ retry = error.headers.get("Retry-After", "0")
97
+ retry = min(int(retry), 86400) if retry.isdigit() else 0
98
+ error.close()
99
+ raise DeliveryError("http_" + str(error.code), transient=(error.code == 429 or 500 <= error.code < 600 and error.code != 507), retry_after=retry) from None
100
+ except (URLError, TimeoutError, ConnectionError, OSError):
101
+ raise DeliveryError("network_unavailable", transient=True) from None
102
+ except (ValueError, UnicodeDecodeError):
103
+ raise DeliveryError("unverified_response", transient=True) from None
104
+ if not isinstance(value, dict) or value.get("code") != 200 or not isinstance(value.get("data"), dict):
105
+ raise DeliveryError("unverified_response", transient=True)
106
+ return value["data"]
107
+
108
+
109
+ def identity(base, key, *, timeout=10):
110
+ project = request(base, key, "/me/limits", timeout=timeout).get("instance_id")
111
+ if type(project) is not int or project <= 0:
112
+ raise DeliveryError("unverified_project", transient=True)
113
+ return project