@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,259 @@
1
+ ---
2
+ name: egbe-os-errors
3
+ description: Set up Sentry error reporting and inspect project-scoped issues, exception traces and event diagnostics.
4
+ metadata:
5
+ egbe-when: "Use when a product has errors to investigate or needs its error reporting connected or checked."
6
+ egbe-visible: "true"
7
+ egbe-title: "Error monitoring"
8
+ egbe-description: "Connect your app to error monitoring so your agent can investigate real browser and server errors."
9
+ egbe-category: "Development & hosting"
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
+ # Error tracking (Sentry)
57
+
58
+ Use OS `errors` to connect an app to Sentry and inspect its failures. The gateway
59
+ resolves ownership from the project key; no provider token is needed. Preserve
60
+ an existing working SDK, DSN and event tags rather than installing them again.
61
+ For an existing error, start with [issue diagnostics](#read-issue-diagnostics).
62
+
63
+ Authenticate with `Authorization: Bearer $OS_API_KEY`.
64
+ Base URL: `https://os.hz.egbe.dev`.
65
+
66
+ ## Get a DSN
67
+
68
+ ```bash
69
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>" -s -X POST \
70
+ -H 'Content-Type: application/json' \
71
+ -d '{"target":"api","platform":"node-express"}'
72
+ ```
73
+
74
+ `platform` must be one of these values; without it the project gets
75
+ `javascript-nextjs`:
76
+
77
+ | `platform` | Use it for |
78
+ |---|---|
79
+ | `javascript-nextjs` | Next.js apps, browser and server (the default) |
80
+ | `javascript-react` | React or Vite browser apps and other static browser pages, including a Vite SPA served from Convex |
81
+ | `node-express` | Node.js or Express servers, APIs, and workers |
82
+ | `python` | Other Python services |
83
+ | `python-django` | Django |
84
+ | `python-fastapi` | FastAPI |
85
+ | `python-flask` | Flask |
86
+
87
+ Any other value, such as `javascript` or `browser`, fails with 400
88
+ `invalid_platform`, and the error lists `supported_platforms`. The gateway also
89
+ maps a few short aliases (`next`, `react`, `vite`, `node`, `express`) to these
90
+ names, but send the full value.
91
+
92
+ The response carries `project.dsn`. Fetch it again later with:
93
+
94
+ ```bash
95
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>" -s
96
+ ```
97
+
98
+ Use one product slug and separate targets when the product has multiple runtime
99
+ services:
100
+
101
+ - `web` - public frontend or a combined full-stack Next app.
102
+ - `api` - separate backend/API service.
103
+ - `worker` - background jobs.
104
+ - `admin` - separate admin/control surface.
105
+
106
+ For a single full-stack Next app, `target:"web"` is enough if both browser and
107
+ server Sentry are initialized from the same codebase. For separate frontend and
108
+ backend services, provision the same product slug with targets such as `web` and
109
+ `api`.
110
+
111
+ ## Read issue diagnostics
112
+
113
+ Use the provisioned product slug and target. The reads below work with ordinary
114
+ project credentials and read-only credentials carrying `errors:read` or
115
+ `project:read`. They do not grant permission to modify or resolve an issue.
116
+
117
+ List recent issues (defaults to unresolved, most frequent first):
118
+
119
+ ```bash
120
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>/<target>/issues?status=unresolved&limit=10" -s
121
+ ```
122
+
123
+ Query params: `status` (`unresolved` | `resolved` | `ignored` | `all`), `limit`
124
+ (1-50), `query` (raw Sentry search, overrides `status`), `sort` (`freq` | `date`
125
+ | `new`), `statsPeriod` (`24h` | `14d`). `<target>` is the project target
126
+ you provisioned (`web`, `api`, `worker`, `admin`).
127
+
128
+ Take the numeric `id` from the list, not the display `short_id` or a Sentry URL:
129
+
130
+ ```bash
131
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>/<target>/issues/<issue_id>" -s
132
+
133
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>/<target>/issues/<issue_id>/events/latest" -s
134
+ ```
135
+
136
+ The issue response includes its summary, platform and available first/last
137
+ release. The event response contains `issue` and `event`: the event ID and time,
138
+ release/environment, exception stack frames and breadcrumbs when Sentry captured
139
+ them. To inspect the same occurrence again, replace `latest` with its 32-character
140
+ hexadecimal event ID. The gateway verifies that both issue and event belong to
141
+ the requested product and target.
142
+
143
+ Diagnostics are a bounded, redacted projection, not a raw Sentry export. User
144
+ records, request headers/bodies, frame locals and source context are excluded;
145
+ URL credentials and query strings are removed. Inspect truncation markers and
146
+ treat missing fields as unavailable, not as evidence that nothing failed.
147
+ An inaccessible event does not mean the issue is resolved.
148
+
149
+ Use the event's timestamp, release, failing frame and breadcrumbs to inspect the
150
+ matching product code and reproduce the affected path. Compare the release with
151
+ the serving revision through `egbe-os-deploy`; an older event is not proof of a
152
+ failure in a later release. Keep the issue/event IDs with the existing repair
153
+ evidence so a later run can resume the same investigation.
154
+
155
+ ## Resolve a verified repair
156
+
157
+ After the affected behavior is verified in the intended release, use the
158
+ numeric issue ID to mark it resolved. Resolving the Sentry record does not
159
+ repair the app or verify deployment, and the absence of a new event alone does
160
+ not prove a fix. A read-only key cannot perform this operation.
161
+
162
+ ```bash
163
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/errors/<your-app-slug>/<target>/issues/<issue_id>/resolve" -s -X POST
164
+ ```
165
+
166
+ ## Wire Env
167
+
168
+ Set the DSN as `SENTRY_DSN` in server/API/worker runtime env. The same DSN is
169
+ public-safe and may also be exposed to browser code when the framework needs a
170
+ public build-time variable such as `NEXT_PUBLIC_SENTRY_DSN`.
171
+
172
+ ```bash
173
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/deploy" -s -X POST \
174
+ -H 'Content-Type: application/json' \
175
+ -d '{"slug":"my-app","repo":"my-app","env":{"SENTRY_DSN":"<dsn>","NEXT_PUBLIC_SENTRY_DSN":"<dsn>"}}'
176
+ ```
177
+
178
+ Do not put Sentry auth tokens in product env. Product code only needs the DSN.
179
+
180
+ ## Initialize SDK
181
+
182
+ ### Next / full-stack app
183
+
184
+ Use `@sentry/nextjs` and initialize both client and server sides from the same
185
+ DSN when the app is full-stack. Detect the installed Next.js/Sentry versions
186
+ and follow their bundled/current file conventions instead of assuming a
187
+ training-era filename. Current Next.js with Turbopack uses
188
+ `instrumentation-client.ts` for browser initialization and `instrumentation.ts`
189
+ for server registration; export `captureRouterTransitionStart` and
190
+ `captureRequestError` hooks when the installed SDK exposes them.
191
+
192
+ ```js
193
+ // instrumentation-client.ts (current Next.js/Turbopack)
194
+ import * as Sentry from "@sentry/nextjs";
195
+
196
+ Sentry.init({
197
+ dsn: process.env.NEXT_PUBLIC_SENTRY_DSN || process.env.SENTRY_DSN,
198
+ tracesSampleRate: 0,
199
+ });
200
+ ```
201
+
202
+ ```js
203
+ // sentry.server.config.js
204
+ import * as Sentry from "@sentry/nextjs";
205
+
206
+ Sentry.init({
207
+ dsn: process.env.SENTRY_DSN,
208
+ tracesSampleRate: 0,
209
+ });
210
+ ```
211
+
212
+ ### Node / API service
213
+
214
+ ```js
215
+ import * as Sentry from "@sentry/node";
216
+
217
+ if (process.env.SENTRY_DSN) {
218
+ Sentry.init({
219
+ dsn: process.env.SENTRY_DSN,
220
+ tracesSampleRate: 0,
221
+ });
222
+ }
223
+ ```
224
+
225
+ ### Browser-only app
226
+
227
+ ```js
228
+ import * as Sentry from "@sentry/browser";
229
+
230
+ Sentry.init({
231
+ dsn: process.env.NEXT_PUBLIC_SENTRY_DSN || process.env.SENTRY_DSN,
232
+ tracesSampleRate: 0,
233
+ });
234
+ ```
235
+
236
+ ## Required Tags
237
+
238
+ Set these tags before capturing product exceptions:
239
+
240
+ - `product_slug` - the deployed product slug.
241
+ - `openclaw_instance` - the Egbe project identity, under its retained compatibility tag name; it does not require OpenClaw or a hosted agent.
242
+ - `runtime_target` - `web`, `api`, `worker`, or `admin`.
243
+
244
+ Example:
245
+
246
+ ```js
247
+ Sentry.setTag("product_slug", process.env.PRODUCT_SLUG || "my-app");
248
+ Sentry.setTag("openclaw_instance", process.env.EGBE_INSTANCE_ID || process.env.OPENCLAW_INSTANCE || "unknown");
249
+ Sentry.setTag("runtime_target", "web");
250
+ ```
251
+
252
+ ## Controlled Smoke
253
+
254
+ For manual verification, you may trigger one controlled test exception and flush
255
+ the SDK before returning a response. Do not leave public debug routes enabled in
256
+ production, and do not use synthetic Sentry issues as the only proof that product
257
+ monitoring is ready. First verify setup and wiring:
258
+ Sentry project/DSN exists, deploy env carries the DSN, and product source
259
+ initializes the SDK with the required tags.
@@ -0,0 +1,275 @@
1
+ ---
2
+ name: egbe-os-git
3
+ description: Create an Egbe repository, push local code or commit files without a terminal, and read code back.
4
+ metadata:
5
+ egbe-when: "Use when code needs versioning or a repository for publication."
6
+ egbe-visible: "true"
7
+ egbe-title: "Code repositories"
8
+ egbe-description: "Create an Egbe-hosted repository to store, version and publish your app's code."
9
+ egbe-category: "Development & hosting"
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
+ # Git
57
+
58
+ Native Git can push, fetch and clone through `https://os.hz.egbe.dev/git/http/<repo>.git`
59
+ using `Authorization: Bearer $OS_API_KEY` with the `git` scope. OS resolves your
60
+ account's Forgejo owner and credential internally. The remote contains no secret;
61
+ no Forgejo token export or credential helper is required for this transport.
62
+ Git and Forgejo handle commits, history, branch protection and push conflicts.
63
+
64
+ ## Start from your local project
65
+
66
+ A local branch such as `master`, uncommitted changes, a missing remote or absent
67
+ Vercel/Netlify files are normal setup, not evidence Egbe deployment is blocked.
68
+ Within the founder's existing publishing/deployment authorization:
69
+
70
+ 1. Inspect `git status`, the current branch and remote names with `git remote`. Preserve existing
71
+ history and remotes. Do not print remote URLs or Git config: older remotes may
72
+ contain credentials. Initialize Git only if absent. Read `/deploy/skill` for the
73
+ Dockerfile/build requirements; configure `.gitignore` and `.dockerignore` before
74
+ staging so `.env.local`, credentials, dependencies and build output stay private.
75
+ 2. List repositories with `GET /git/repos`; reuse the intended repository or create
76
+ an empty private one with `POST /git/repos`. Paginate with `page` and `limit`
77
+ (1–50, default 50) until a page has fewer than `limit` items; match the exact
78
+ `owner`/`name` or `full_name`, not a substring. Check HTTP success before proceeding.
79
+ Both operations return clean metadata and `os_http_url`. This URL is available
80
+ for the authenticated account’s own namespace; it is null for collaborator-owned
81
+ repositories, whose issues remain accessible according to repository permissions.
82
+ Do not substitute a same-named repository from another owner.
83
+ 3. Check author and committer identities with `git var GIT_AUTHOR_IDENT` and
84
+ `git var GIT_COMMITTER_IDENT`. If missing, choose identities approved for this
85
+ project and save them with `git config --local user.name` / `user.email`.
86
+ Preserve existing identities. These are commit metadata, never API credentials.
87
+ 4. Review and commit the intended files, then push the current branch through the
88
+ OS HTTP remote. Use the exact full pushed SHA from `git rev-parse HEAD` as the
89
+ `ref` in `POST /deploy`. No branch rename or force push is needed.
90
+ 5. Verify deployment status, deployed revision and public URL per `/deploy/skill`.
91
+
92
+ ```bash
93
+ # OS_URL and OS_API_KEY come from the existing quickstart connection.
94
+ # List first; create only if the intended repository is absent.
95
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/git/repos" -fsS
96
+ OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/git/repos" -fsS -X POST \
97
+ -H 'Content-Type: application/json' \
98
+ -d '{"name":"my-app","private":true}' \
99
+ | python3 -c 'import json,sys; print(json.load(sys.stdin)["data"]["os_http_url"])'
100
+ # No Forgejo credentials or direct transport addresses are returned.
101
+
102
+ # Add a dedicated remote without replacing an existing origin.
103
+ REMOTE="$OS_URL/git/http/my-app.git"
104
+ # Replace all fetch and push targets on this dedicated remote. A legacy pushurl
105
+ # otherwise overrides url and can silently push directly to Forgejo.
106
+ git config --local --replace-all remote.egbe.url "$REMOTE"
107
+ git config --local --replace-all remote.egbe.pushurl "$REMOTE"
108
+ git config --local --replace-all remote.egbe.fetch '+refs/heads/*:refs/remotes/egbe/*'
109
+ git var GIT_AUTHOR_IDENT
110
+ git var GIT_COMMITTER_IDENT
111
+ # Review git status/diff, stage intended source files, and commit before pushing.
112
+
113
+ # Pass the key via a temporary environment variable, scoped to this remote.
114
+ # Do not enable shell tracing, store this header in Git config, or print it.
115
+ REMOTE="$OS_URL/git/http/my-app.git"
116
+ export OS_GIT_AUTH="Authorization: Bearer $OS_API_KEY"
117
+ git --config-env="http.$REMOTE.extraHeader=OS_GIT_AUTH" push -u egbe HEAD
118
+ unset OS_GIT_AUTH
119
+ git rev-parse HEAD
120
+ ```
121
+
122
+ For an existing project with a legacy Forgejo origin, select the same repository
123
+ from the paginated list and use its OS URL on the dedicated `egbe` remote above.
124
+ Keep `origin` unchanged; use `egbe` explicitly for push/fetch. Never expose a legacy
125
+ URL while comparing remotes, and do not rotate keys or recreate the repository.
126
+ Preserve the current branch name. For an intentional differently named remote
127
+ branch use `HEAD:<approved-branch>`; do not overwrite unrelated history. On a
128
+ rejected push, fetch and inspect the remote changes or publish a new branch.
129
+ After a timeout/disconnect, inspect remote refs before deciding whether to retry;
130
+ a lost response does not prove the push failed.
131
+
132
+ ## Clone or fetch
133
+
134
+ Use the same temporary, remote-scoped header with every authenticated Git call:
135
+
136
+ ```bash
137
+ REMOTE="$OS_URL/git/http/my-app.git"
138
+ export OS_GIT_AUTH="Authorization: Bearer $OS_API_KEY"
139
+ git --config-env="http.$REMOTE.extraHeader=OS_GIT_AUTH" clone "$REMOTE"
140
+ # Inside an existing clone whose egbe remote matches REMOTE:
141
+ # git --config-env="http.$REMOTE.extraHeader=OS_GIT_AUTH" fetch egbe
142
+ unset OS_GIT_AUTH
143
+ ```
144
+
145
+ This requires Git with `--config-env` support (2.31+). Git smart HTTP uses raw
146
+ protocol responses, while repository management APIs use the normal OS envelope.
147
+ The adapter supports discovery, upload-pack and receive-pack only; Git LFS and
148
+ dumb HTTP are outside this transport. OS keys are valid here, not as direct
149
+ Forgejo passwords.
150
+
151
+ ## One OS contract
152
+
153
+ Repository management, issues and comments use the same OS API and authentication
154
+ in REST and MCP. `GET /git/credentials` returns 410 and no credentials. Refresh
155
+ this skill and use the OS operations; do not request a Forgejo token, construct
156
+ a direct Forgejo URL or send the OS key to Forgejo. Internal credentials stay on
157
+ the server. Existing repositories and saved remotes are not deleted or revoked.
158
+
159
+ If a shell network policy blocks OS, follow quickstart’s environment recovery for
160
+ `os.hz.egbe.dev` (or the configured OS host), or commit through the API below.
161
+ Direct Forgejo access is not required and is not the recovery path. MCP cannot
162
+ carry Git smart HTTP bytes, but it carries every repository, issue and commit
163
+ operation in this skill.
164
+
165
+ Escalate the actual redacted authorization/provisioning/network/build error,
166
+ not missing configuration. When the OS key cannot reach a Git process, commit
167
+ through the API below instead of reporting publication as blocked.
168
+
169
+ ## Without a terminal: commit through the Egbe connector
170
+
171
+ Use this when the agent has no shell or Git, or its shell cannot reach Egbe (for
172
+ example a chat in claude.ai, Cowork or ChatGPT). Every step is a JSON request,
173
+ so it works through `egbe_read`/`egbe_write`; nothing contains `.git`. A
174
+ workspace with Git can keep using the push flow above.
175
+
176
+ 1. Pick the repository from `GET /git/repos` (one with a non-null `os_http_url`,
177
+ your own namespace) or create it with `POST /git/repos`.
178
+ 2. Read what is there. `GET /git/repos/<owner>/<repo>/tree` with `ref` (default:
179
+ the default branch) returns `commit`, the branch head's full SHA, and
180
+ `entries` (`path`, `type`, `mode`, `size`, `sha`); request `page=<next_page>`
181
+ until `next_page` is null. A repository without commits answers 404 with
182
+ `data.empty: true`: its base is `""`. Read a file with
183
+ `GET /git/repos/<owner>/<repo>/file` and `path`, `ref=<commit>`: `content` is
184
+ UTF-8 text or, with `encoding: "base64"`, binary. Repeat with
185
+ `offset=<next_offset>` until `next_offset` is null. Files over 10 MB are not
186
+ readable here.
187
+ 3. Commit. A small change is one request:
188
+
189
+ ```json
190
+ POST /git/repos/<owner>/<repo>/commits
191
+ {"base": "<commit>", "message": "Add pricing page",
192
+ "files": [{"path": "src/pricing.html", "content": "<h1>Pricing</h1>\n"}],
193
+ "delete": ["src/old.html"]}
194
+ ```
195
+
196
+ For more files, send the same request without `message` to open a session
197
+ (response `session_id`), add batches with
198
+ `POST /git/commit-sessions/<session_id>/files` (`files`, `delete`), then
199
+ `POST /git/commit-sessions/<session_id>/commit` with `{"message": "..."}`.
200
+ Nothing reaches the branch until that call, which makes one commit.
201
+ - `base` is required: the branch head SHA you read, or `""` for an empty
202
+ repository or a new branch. `branch` defaults to the repository's default
203
+ branch. With `"base": ""` and `from_branch`, a new branch starts from that
204
+ branch's head.
205
+ - `encoding` is `utf-8` (default) or `base64` for images, fonts and other
206
+ binary files. `executable: true` marks scripts; an existing file keeps its
207
+ mode otherwise. `delete` removes files or whole folders of the base.
208
+ - Paths are relative and `/`-separated, without `..` or `.git`. Send source
209
+ files only: never `.env*` with real values, `node_modules/` or build output.
210
+ - Keep each request under 700,000 bytes (base64 grows content by a third; aim
211
+ for about 450 KB of file content per batch). For a larger file, send its
212
+ first part, then the rest in later batches with `"append": true` on the same
213
+ path. A later batch replaces a path staged earlier.
214
+ - Optional `author: {"name", "email"}` on the commit uses an identity approved
215
+ for this project; the default is Egbe OS.
216
+ - A template or other file bundled with an Egbe skill is copied on the server
217
+ instead of sent: give the entry `from_skill` in place of `content`, such as
218
+ `{"path": "src/quiz/quiz-engine.mjs", "from_skill": {"skill": "egbe-os-quiz-funnel",
219
+ "path": "assets/engine/quiz-engine.mjs"}}`. A `from_skill.path` ending in `/`
220
+ copies every file of that skill folder into the folder `path` names (`""`
221
+ for the repository root), each counting as one batch entry. The connector's
222
+ `egbe_skill` with `resource: ""` (or a folder ending in `/`) lists a skill's
223
+ files with their size and SHA-256; copies are byte-exact, keep a script's
224
+ executable mode and count toward the same limits.
225
+ - Product Build's shipped application and account foundations install into a
226
+ session with `POST /git/commit-sessions/<session_id>/scaffold`; see its
227
+ `references/foundations.md`.
228
+ 4. The result's `sha` is the full commit SHA: pass it as `ref` to `POST /deploy`
229
+ (see `/deploy/skill`). `changed: false` means the files matched the base and
230
+ no commit was made.
231
+
232
+ Limits: 10 MB per file, 50 MB and 2,000 paths per commit, 500 entries per batch,
233
+ 3 open sessions per business. A session expires 30 minutes after its last request
234
+ (2 hours at most); `GET /git/commit-sessions/<session_id>` shows its state, staged
235
+ paths and result, and `DELETE` discards it.
236
+
237
+ A failed commit call names its cause in `data.reason`, with `data.retryable`
238
+ saying whether repeating the same request later can succeed. Act on the reason,
239
+ not the HTTP status (a 403 with `data.reason` is a Git refusal, not a missing key
240
+ scope). Unless the reason says otherwise, nothing was written; a session's commit
241
+ call leaves the session open (discard it with `DELETE` if you will not retry it),
242
+ and a refused one-shot request keeps no session, so send it again in full.
243
+
244
+ - `moved` (409, `data.head` differs from your `base`): the branch moved. Read
245
+ the changed files at `data.head`, reapply your edits where needed, then repeat
246
+ the commit call with `"base": "<data.head>"`: the staged files replace those
247
+ paths at that head. Egbe never force-pushes.
248
+ - `source_moved` (409, retryable): the `from_branch` you started a new branch
249
+ from moved while committing. Repeat the same commit call; nothing was written.
250
+ - `protected_branch` (403): the branch is protected. Do not retry or work
251
+ around it; ask the founder to allow the push or name another branch, then
252
+ commit there with `"base": ""` and `from_branch`.
253
+ - `permission_denied` (403): the Git server denied Egbe access. Do not retry;
254
+ contact Egbe support.
255
+ - `too_large` (422): the push was too large. Commit the change in smaller parts.
256
+ - `rejected` (409, `data.head` equals your base): a server hook or ref check
257
+ declined the update. Read the branch head, retry once with it as base, and ask
258
+ the founder if it is refused again.
259
+ - `unreachable` (502) or `git_unavailable` (503): the Git server or Egbe's Git
260
+ could not be reached. Retry later. When the response has no `data.head`, the
261
+ push outcome may be unknown: read the tree and check whether your change is
262
+ already there before committing again. Contact Egbe support if it persists.
263
+ - `timeout` (504): the outcome is unknown. Repeat the same session's commit
264
+ call: a finished session returns its commit again with `replayed: true`. For a
265
+ one-shot request, read the tree first; if its `commit` differs from your base,
266
+ check whether your change is already there before committing again.
267
+ - `refused` (502): an unrecognized refusal. Retry once later, then contact Egbe
268
+ support with the time and repository.
269
+ - `internal` (500) or `configuration` (502): an Egbe-side fault. Do not retry;
270
+ contact Egbe support with the time and repository.
271
+
272
+ ## Product backlog
273
+
274
+ To read or update issues in this project's repository, follow
275
+ [Repository issues](references/issues.md). It uses the same OS connection; no direct Forgejo access is needed.
@@ -0,0 +1,33 @@
1
+ # Repository issues and comments through OS
2
+
3
+ Use the project's existing repository for its backlog. Find its exact `owner` and
4
+ `name` in paginated `GET /git/repos`, retaining `full_name` to distinguish same-named
5
+ repositories. Never print a legacy remote URL: it may contain credentials.
6
+ Use the configured OS host and `Authorization: Bearer $OS_API_KEY`, as for repository
7
+ creation. Through MCP use `egbe_read`/`egbe_write` with the selected business.
8
+ The server resolves the upstream credential and applies the caller's repository
9
+ permissions. A repository shared with this account may support issues even when
10
+ its `os_http_url` is null; native OS Git transport covers the account's own namespace.
11
+
12
+ The OS prefix is `/git/repos/<owner>/<repo>/issues`:
13
+
14
+ | Operation | Method and relative path | JSON body / query |
15
+ |---|---|---|
16
+ | List | `GET` prefix | `state=open` (or `closed`, `all`), `page=1&limit=50` |
17
+ | Read | `GET /<number>` | — |
18
+ | Create | `POST` prefix | `{"title":"...","body":"..."}` |
19
+ | Edit or close | `PATCH /<number>` | Changed `title`, `body`, `state`; `{"state":"closed"}` to close |
20
+ | Read comments | `GET /<number>/comments` | `page=1&limit=50` |
21
+ | Comment | `POST /<number>/comments` | `{"body":"..."}` |
22
+
23
+ Responses use the normal OS envelope. Issue lists exclude pull requests. Use the
24
+ repository-local issue `number`, never its global database `id`. Comment `id` is
25
+ returned as metadata; these operations do not edit/delete comments. For repository,
26
+ issue and comment lists, increment `page` until fewer than `limit` items are returned
27
+ (`limit` 1–50, default 50). Search/read before creating to avoid duplicates.
28
+
29
+ Only make changes required by the founder's task. For a failed or disconnected
30
+ write, read back before retrying: the write may already have succeeded. A 401/403
31
+ is an access failure; a 404 may mean missing data or inaccessible private data.
32
+ Do not switch identity or create a different project's backlog to bypass it.
33
+ No Forgejo URL or token is required; the retired `/git/credentials` returns 410.