@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,116 @@
1
+ # Reply queue and send recovery
2
+
3
+ `reply-worker.js` collects campaign-scoped inbound emails and adds unseen IDs to
4
+ `reply-queue.json` and project `outreach.db`. It never sends.
5
+ The collector requires the matching existing DB run/campaign before provider
6
+ calls; it does not reconstruct missing sending history by initializing an empty DB.
7
+ Read the original message and current run context; `intent_hint` is a keyword heuristic, not a
8
+ confirmed refusal, qualification or business outcome. Content decisions use the
9
+ current task/plan, not a second permission matrix in this tool.
10
+
11
+ ```bash
12
+ node "$SKILL_DIR/scripts/reply-worker.js" --run-dir "$RUN_DIR" --env-file "$RUN_DIR/.env"
13
+ node "$SKILL_DIR/scripts/send-reply.js" --run-dir "$RUN_DIR" --email-id MESSAGE_ID --text-file "$RUN_DIR/replies/draft.txt"
14
+ node "$SKILL_DIR/scripts/send-reply.js" --run-dir "$RUN_DIR" --email-id MESSAGE_ID --mark owner_review
15
+ node "$SKILL_DIR/scripts/send-reply.js" --run-dir "$RUN_DIR" --email-id MESSAGE_ID --mark no_reply
16
+ ```
17
+
18
+ These scripts also accept `--env-file`. Work one queue item at a time; do not run
19
+ concurrent senders. `owner_review` records a handoff but does not itself notify
20
+ the owner or send a draft. Use the agreed channel if a decision is needed.
21
+ `no_reply` closes a message without sending; it does not confirm an opt-out or
22
+ prove provider sends stopped. Automatic and out-of-office messages are not
23
+ interchangeable with explicit refusal.
24
+
25
+ ## Confirmed refusal and stopping
26
+
27
+ After reading a clear opt-out, use:
28
+
29
+ ```bash
30
+ node "$SKILL_DIR/scripts/send-reply.js" --run-dir "$RUN_DIR" --email-id MESSAGE_ID --mark opt_out
31
+ ```
32
+
33
+ For a forwarded/ambiguous reply, inspect the original thread and pass
34
+ `--recipient-email <original-campaign-recipient>` if necessary. The selected
35
+ recipient must be a known member of this campaign. A forwarder's From address
36
+ is not automatically the person who must stop receiving outreach.
37
+
38
+ The command commits an idempotent `opt_out_confirmed` event to the existing
39
+ project `lead_events` before closing the queue as `no_reply`. It records the
40
+ normalized original recipient and source message ID. Failed event persistence
41
+ does not close the queue. Generic `no_reply` and old regex hints are not migrated
42
+ into confirmed refusals.
43
+
44
+ Launch, replenishment and reply sends consult confirmed events. A missing,
45
+ unreadable or incomplete DB after known sending is a recovery blocker, not an
46
+ empty suppression list. A genuinely new project is allowed; known sending runs
47
+ missing from the DB or confirmed queue events missing from it require restoration
48
+ and checking. A new run/upsert or run cleanup does not erase an earlier refusal.
49
+
50
+ Local filtering cannot stop a recipient already imported. The command checks
51
+ all known project campaigns from DB and recovery artifacts through owned gateway
52
+ reads and complete, validated lead pagination. Absence needs no provider write.
53
+ For each retained copy it reads the semantic recipient exclusion resource; a
54
+ confirmed main-sequence result can preserve the lead and history without pausing
55
+ the other recipients. An eligible copy uses only the exact-ID exclusion operation.
56
+ Settings such as stop-on-reply alone do not establish recipient exclusion.
57
+
58
+ The initial supported profile requires no attached or campaign subsequences and
59
+ complete empty workspace automation/webhook collections, checked internally by
60
+ Tools. Nonempty, unreadable or incomplete coverage remains unsupported/unknown.
61
+ The command then preserves the existing scoped campaign pause (readback status 2).
62
+ A pause proves containment, not per-recipient exclusion. No global blocklist,
63
+ email-based interest update, foreign campaign or automatic activation is used.
64
+
65
+ The queue retains `opt_out_confirmed: true` and `opt_out_provider` evidence,
66
+ including per-campaign `recipient_exclusion`. A nonzero exit or `provider.ok: false`
67
+ means local refusal was saved but containment is unresolved. Repeating the same
68
+ `--mark opt_out` rechecks without duplicating the local event; confirmed native
69
+ 3/-1 copies need no write and already-paused campaigns need no repeat pause.
70
+ An uncertain mutation is recovered by GET, never automatically replayed.
71
+
72
+ Before a separately authorized activation, the launcher checks every retained
73
+ confirmed refusal against fresh owned main-sequence evidence. Missing local
74
+ history, partial/invalid pages, unsupported coverage or unknown results block.
75
+ A recovery attempt that had to establish exclusion leaves that launch attempt
76
+ blocked; a later explicit rerun rechecks all gates. The exclusion operation does
77
+ not itself activate a campaign.
78
+
79
+ This covers known local project refusals and the supported native main-sequence
80
+ state only. It does not cancel in-flight mail, qualify active subsequences or
81
+ promise workspace-wide suppression, header/link opt-outs, unsynchronized copies
82
+ or other projects. See [the endpoint contract](instantly-ops.md#recipient-exclusion).
83
+ Keep sensitive client files/credentials out of cold-email replies; use a suitable
84
+ protected product path if those inputs are actually needed.
85
+
86
+ ## Same-thread send and uncertainty
87
+
88
+ A send uses the original message/thread and the mailbox that received it.
89
+ Unknown receiving mailbox blocks the send; do not substitute another sender.
90
+ The script checks campaign scope and known opt-outs, then claims the item as
91
+ `sending` before the external call.
92
+
93
+ - Confirmed success records `sent`.
94
+ - Rejected 4xx returns it to `pending`; inspect the reason before another attempt.
95
+ - Timeout, interrupted process or 5xx leaves `sending`: the message may have
96
+ gone out. The client never blindly repeats a reply.
97
+
98
+ Inspect the provider thread and resolve a `sending` item explicitly:
99
+
100
+ ```bash
101
+ node "$SKILL_DIR/scripts/send-reply.js" --run-dir "$RUN_DIR" --email-id MESSAGE_ID --mark sent
102
+ node "$SKILL_DIR/scripts/send-reply.js" --run-dir "$RUN_DIR" --email-id MESSAGE_ID --mark pending
103
+ ```
104
+
105
+ Those marks are recovery assertions after evidence, not a way to force a resend.
106
+ An opt-out cannot be marked while a send remains uncertain; resolve that state
107
+ first. Keep the queue and DB together across handoff. Direct Unix cron only
108
+ collects; it does not read messages, compose replies or make these decisions.
109
+
110
+ ## Reply formatting
111
+
112
+ Write replies as plain text without markdown emphasis. Line breaks, blank lines
113
+ and `- ` list lines are preserved in both text and HTML. Links may be bare URLs
114
+ or `[text](https://...)`. Hosts linked from the campaign steps receive the run's
115
+ UTMs in the link target, while the visible URL stays clean; other hosts remain
116
+ unchanged. If the steps have no web links, reply links remain unchanged.
@@ -0,0 +1,65 @@
1
+ {
2
+ "run_key": "<new-run-key>",
3
+ "agent_id": "<local-agent-id>",
4
+ "product": {
5
+ "name": "<existing-product-name>"
6
+ },
7
+ "segment": {
8
+ "name": "<chosen-audience>"
9
+ },
10
+ "offer": {
11
+ "headline": "<accepted-offer>"
12
+ },
13
+ "campaign": {
14
+ "name": "<campaign-name>",
15
+ "schedule": {
16
+ "name": "<schedule-label>",
17
+ "timing": {
18
+ "from": "<HH:MM>",
19
+ "to": "<HH:MM>"
20
+ },
21
+ "days": {
22
+ "monday": true,
23
+ "tuesday": true,
24
+ "wednesday": true,
25
+ "thursday": true,
26
+ "friday": true,
27
+ "saturday": false,
28
+ "sunday": false
29
+ },
30
+ "timezone": "<IANA-zone>"
31
+ },
32
+ "daily_limit": null,
33
+ "email_list": [
34
+ "<owned-cold-mailbox>"
35
+ ],
36
+ "activate_on_launch": false,
37
+ "stop_on_reply": true,
38
+ "stop_on_auto_reply": true,
39
+ "insert_unsubscribe_header": true,
40
+ "open_tracking": false,
41
+ "link_tracking": false,
42
+ "verify_leads_on_import": true,
43
+ "wait_for_verification": true,
44
+ "allow_unverified_activation": false
45
+ },
46
+ "sequence": {
47
+ "steps": [
48
+ {
49
+ "delay_days": 0,
50
+ "subject": "<chosen-subject>",
51
+ "body": "<accepted-message>"
52
+ }
53
+ ]
54
+ },
55
+ "monitoring": {
56
+ "autopause_on_risk": true,
57
+ "thresholds": {
58
+ "max_bounce_rate": null
59
+ }
60
+ },
61
+ "lead_replenishment": {
62
+ "enabled": false
63
+ },
64
+ "leads_file": "./leads.json"
65
+ }
@@ -0,0 +1,145 @@
1
+ # Executable run configuration and durable state
2
+
3
+ The canonical directory is
4
+ `egbe-docs/marketing/campaigns/instantly/<run_key>/`.
5
+ Use the existing plan/materials; for a new campaign, `plan.md` can hold its
6
+ chosen scope, decision and result. The tool does not require separate preflight,
7
+ log, lessons or daily-memory copies, or a particular language.
8
+
9
+ The plan records the run's accepted requirements; `run-spec.json` supplies
10
+ supported executable settings. A requirement written in the plan is not thereby
11
+ implemented by the spec. Use the existing operation records below as evidence
12
+ of settings and execution, not a second copy of the business decisions.
13
+
14
+ ## Inputs and identity
15
+
16
+ Start with [run-spec-template.json](run-spec-template.json) when useful.
17
+ It is a non-executable scaffold: replace placeholders/null required choices
18
+ before running. It contains no invented sender, proof, customer result or
19
+ experiment identity.
20
+
21
+ `run-spec.json` needs `run_key`, nonempty `sequence.steps`, `leads_file`,
22
+ an explicit positive `campaign.daily_limit`, schedule and owned sender selection.
23
+ `product`, `segment`, `offer`, reply policy and other context are available
24
+ to the operator; they are not a requirement to repeat research. Campaign name
25
+ may be explicit; otherwise the launcher derives one from the available context.
26
+ Set `activate_on_launch: true` only for the intended activation operation.
27
+ Otherwise the run is prepared without activation.
28
+
29
+ `campaign.daily_max_new_leads` optionally limits new leads contacted per day;
30
+ `campaign.daily_limit` caps all messages for this campaign, including follow-ups,
31
+ across its senders. Neither enforces a project-wide aggregate across campaigns.
32
+ For supported protection fields and their semantics, read
33
+ [configured protection](observation-and-scheduling.md#configured-operational-protection).
34
+
35
+ Use a stable key for this particular run, not a permanent key for every future
36
+ test of the same audience/offer. Preserve available `business_id`,
37
+ `product_id`, `launch_id`, `experiment_id`, and `variant_id` from existing
38
+ project context; leave unknown IDs absent, do not invent them to satisfy a
39
+ report. After the manifest exists, run/GTM identity conflicts fail before
40
+ provider writes. A new test uses a new run rather than rewriting history.
41
+ The first actual launch time is preserved as `first_launched_at`; preparation
42
+ reruns update `last_prepared_at`, and explicit activation updates
43
+ `last_activated_at`. A new preparation timestamp is not a fresh cohort start.
44
+
45
+ Attribution is `provider=instantly`, `utm_source=instantly`,
46
+ `utm_medium=email`, `utm_campaign=<run_key>`, plus
47
+ `provider_campaign_id`. The operational run/UTM key is not a substitute for
48
+ a portable experiment ID. Both are preserved when known.
49
+
50
+ `leads_file` is a JSON array or `{"leads":[...]}`; source metadata may accompany
51
+ it. Leads require email and the values actually used in the sequence. Names,
52
+ company, website and optional scalar custom variables are mapped by the client.
53
+ Keep the file in the run and reference `./leads.json`: relative paths resolve
54
+ from the spec directory (CWD fallback exists with a warning). Known opt-outs
55
+ are filtered independently of source status or cosmetic name review.
56
+
57
+ ## Replenishment is explicit and bounded
58
+
59
+ ```bash
60
+ node "$SKILL_DIR/scripts/replenish-leads.js" --run-dir "$RUN_DIR" --env-file "$RUN_DIR/.env"
61
+ ```
62
+
63
+ Absent configuration or `enabled` other than true does not request sourcing.
64
+ Enabled replenishment requires all these authored values:
65
+
66
+ | Field | Required value |
67
+ | --- | --- |
68
+ | `batch_size` | positive integer |
69
+ | `max_total_leads` | positive integer hard campaign membership cap |
70
+ | `max_replenishments` | nonnegative integer additional-cycle cap |
71
+ | `utilization_threshold` | fraction 0–1 |
72
+ | `cooldown_minutes` | nonnegative number |
73
+ | `apollo_search` | optional compatible Apollo search object when that source is selected |
74
+
75
+ There are no default fifty-lead batches, 250-lead tests, 48-hour cooldowns or
76
+ 80-percent utilization requirements. Initial import is capped by the configured
77
+ batch/total only when replenishment is enabled; surplus remains in carry-over.
78
+ Without it, the selected initial input is not silently reduced to a marketing
79
+ batch size.
80
+
81
+ The replenisher drains carry-over before sourcing, checks complete live
82
+ membership/utilization, deduplicates, filters confirmed opt-outs, validates
83
+ used variables, imports with verification, and records the result. It
84
+ rechecks membership before import so stale local counts cannot exceed the cap.
85
+ `--force` bypasses utilization only: it does not override cooldown, total/cycle
86
+ caps, disabled sourcing or unknown membership.
87
+
88
+ Rejected leads retain full data and reasons in `state/rejected-leads.json`.
89
+ Correct an actual missing/invalid substitution and deliberately return the lead to
90
+ carry-over; do not pay to source it again. Unusual but real names cause warnings.
91
+ Exact title/credential tokens remain invalid names unless explicitly confirmed.
92
+ A rejection/empty result is not permission to widen the audience or spending.
93
+
94
+ Apollo runs with a 90-second client budget inside a 120-second subprocess
95
+ timeout. Its atomic output is read even after incomplete exit or interruption.
96
+ Results/history retain `source_meta` and `source_file`; full pending inputs
97
+ remain in `state/replenish-temp/leads-*.json`. Despite the directory name,
98
+ these source checkpoints are durable and are not automatically deleted.
99
+
100
+ Before another paid Apollo search, the replenisher blocks on a prior
101
+ incomplete/unknown source checkpoint. Carry-over may still be used. Review
102
+ that source explicitly and use Apollo `enrich --input <source_file>` to resume
103
+ only pending inputs if appropriate; a lost response may already have incurred
104
+ cost. Preserve/reconcile usable leads into carry-over as needed. A completed
105
+ source no longer blocks new search. No blind new search or enrichment replay is
106
+ performed merely because the previous sourcing subprocess failed.
107
+ New partial sourcing exits 2 even if usable retained leads were imported;
108
+ an earlier unresolved checkpoint blocks another paid search with exit 1.
109
+ Ordinary configured skips (disabled, cooldown, caps) return exit 0 and a reason.
110
+
111
+ ## Active artifacts and consumers
112
+
113
+ Files appear as operations create them; this is not a checklist to pre-create.
114
+
115
+ | Artifact | Writer / reader and purpose |
116
+ | --- | --- |
117
+ | `run-spec.json`, `leads.json` | Authored inputs / launcher and replenisher |
118
+ | `state/resolved-run-spec.json` | Launcher-derived senders/identity / reply worker; original spec is not rewritten |
119
+ | `manifest.json`, `state/ownership.json` | Launcher / every worker; IDs, fingerprints, tags and run scope |
120
+ | `state/sequence-state.json` | Launcher / rerun; applied rendered-sequence fingerprint |
121
+ | `state/imported-leads.json`, `state/carry-over-leads.json` | Importers / safe dedup and remaining inputs |
122
+ | `state/verification-state.json`, `state/invalid-leads.json`, `state/deleted-leads.json` | Launcher / verification, targeted cleanup and rerun |
123
+ | `state/rejected-leads.json`, `state/replenishment-history.json` | Replenisher / fixes, bounds and actual import evidence |
124
+ | `state/processed-replies.json`, `reply-queue.json` | Collector/sender / checkpoints, locks and pending/uncertain actions |
125
+ | `monitor-summary.json`, `state/analytics-history.json`, `state/monitor-alerts.json` | Monitor / observations and alert/acknowledgment recovery |
126
+ | `launch-summary.json`, `cron-install.json`, manifest scheduler fields | Launch/installer / readback, execution handoff and verified removal |
127
+ | `conclusion.json` | Facts-only collector / existing GTM consumer; no automatic verdict or lifecycle completion |
128
+ | `../outreach.db` | Operational scripts / run, lead, queue and event history across project runs, including confirmed opt-outs |
129
+ | `../tag-cache.json` | Launcher / tag reuse, not proof of tenant access |
130
+ | `.env` | Private credentials and connection identity / launcher and workers |
131
+
132
+ JSON queue/checkpoints and SQLite both have active readers/writers. Neither is
133
+ a disposable legacy mirror. `outreach-report.js` reads the DB, while queue/send
134
+ recovery still depends on the files.
135
+
136
+ Version specs, contacts, messages, queue/history and the SQLite DB in the
137
+ access-controlled project repository, never a public site. Credentials, process
138
+ locks and temporary SQLite journals stay Git-ignored. SQLite uses rollback
139
+ journaling; committed state is in the DB, not a separate WAL archive.
140
+
141
+ For handoff, stop/pause the local workers and synchronize the DB and files as one
142
+ coherent snapshot. Do not merge competing binary DB copies or start a second
143
+ sender from a clone. Reconcile provider state, identity, pending imports and
144
+ `sending` queue items before transferring execution. Missing DB after known
145
+ sending is a recovery task, not permission to initialize empty history.
@@ -0,0 +1,158 @@
1
+ #!/usr/bin/env node
2
+ // Retained filename: conclusion.json is an observation transport, not a verdict.
3
+ const path = require("path");
4
+ const { readJson, writeJson, parseArgs, isoNow, loadRunEnv } = require("./lib/helpers");
5
+ const { reconcileRunIdentity, reconcileInstantlyAttribution } = require("./lib/gtm-identity");
6
+
7
+ function number(value) {
8
+ return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
9
+ }
10
+
11
+ function timestamp(value) {
12
+ return typeof value === "string" && Number.isFinite(Date.parse(value)) ? value : null;
13
+ }
14
+
15
+ function rate(numerator, denominator) {
16
+ return numerator != null && denominator > 0
17
+ ? Math.round((numerator / denominator) * 1000000) / 10000
18
+ : null;
19
+ }
20
+
21
+ function collectFacts({ manifest, spec, launch = {}, history = [], generatedAt = isoNow() }) {
22
+ // Never replace a recent partial observation with an older complete one, nor
23
+ // combine cumulative snapshots. Repackaging does not refresh measurement.
24
+ const latest = history.length ? history[history.length - 1] : null;
25
+ if ((latest?.campaign_id && latest.campaign_id !== manifest.campaign.id)
26
+ || (latest?.run_key && latest.run_key !== manifest.run_key)) {
27
+ throw new Error("Latest analytics snapshot identity does not match the run");
28
+ }
29
+ const metrics = latest?.metrics || {};
30
+ const observedAt = timestamp(latest && Object.hasOwn(latest, "metrics_observed_at")
31
+ ? latest.metrics_observed_at : latest?.generated_at);
32
+ const openTracking = latest?.open_tracking_enabled ?? latest?.open_tracking?.enabled
33
+ ?? spec.campaign?.open_tracking ?? null;
34
+ const partial = metrics._partial === true;
35
+ const workspaceLevel = metrics._possibly_workspace_level === true;
36
+ const source = metrics._source || null;
37
+ const count = (value) => partial && value === 0 ? null : number(value);
38
+ const contacted = count(metrics.contacted_count);
39
+ const replies = count(metrics.reply_count_unique);
40
+ const opens = openTracking === false ? null : count(metrics.open_count_unique);
41
+ const bounces = count(metrics.bounced_count ?? metrics.bounce_count);
42
+ const unsubscribes = count(metrics.unsubscribed_count ?? metrics.unsubscribe_count);
43
+ const spam = count(metrics.spam_complaint_count ?? metrics.spam_count);
44
+ const positive = count(metrics.positive_reply_count);
45
+ // Partial fallback rows are bounded samples, not complete rate denominators.
46
+ const reliableDenominator = partial || workspaceLevel ? null : contacted;
47
+ const reasons = [];
48
+ if (!latest) reasons.push("analytics_unavailable");
49
+ if (!observedAt) reasons.push("observation_time_unavailable");
50
+ if (partial) reasons.push("partial_snapshot");
51
+ if (workspaceLevel) reasons.push("possibly_workspace_level");
52
+ if (!source) reasons.push("source_unavailable");
53
+ if (openTracking === false) reasons.push("open_tracking_disabled");
54
+ const summary = {
55
+ contacted,
56
+ emails_sent: count(metrics.emails_sent_count),
57
+ opens,
58
+ total_replies: replies,
59
+ positive_replies: positive,
60
+ bounces,
61
+ unsubscribes,
62
+ spam_complaints: spam,
63
+ reply_rate_pct: rate(replies, reliableDenominator),
64
+ positive_reply_rate_pct: rate(positive, reliableDenominator),
65
+ bounce_rate_pct: rate(bounces, reliableDenominator),
66
+ unsubscribe_rate_pct: rate(unsubscribes, reliableDenominator),
67
+ spam_rate_pct: rate(spam, reliableDenominator),
68
+ open_rate_pct: rate(opens, reliableDenominator),
69
+ // Provider counters are counts, not rates; no step is assumed to be a breakup.
70
+ step_reply_counts: metrics.step_reply_counts ?? metrics.replies_by_step ?? null,
71
+ };
72
+ const missing = Object.entries(summary).filter(([, value]) => value == null).map(([key]) => key);
73
+ if (missing.length) reasons.push("metrics_missing");
74
+ // last_launch_at was historically overwritten on launcher reruns and is
75
+ // not a trustworthy start for cumulative measurements.
76
+ const launchedAt = timestamp(launch.launched_at ?? launch.started_at
77
+ ?? manifest.campaign?.first_launched_at);
78
+ return {
79
+ business_id: spec.business_id || manifest.business_id || null,
80
+ product_id: spec.product_id || manifest.product_id || null,
81
+ launch_id: spec.launch_id || manifest.launch_id || null,
82
+ experiment_id: spec.experiment_id || manifest.experiment_id || null,
83
+ variant_id: spec.variant_id || manifest.variant_id || null,
84
+ ...reconcileInstantlyAttribution(manifest, {
85
+ runKey: spec.run_key, campaignId: manifest.campaign.id, label: "manifest",
86
+ }),
87
+ run_key: manifest.run_key,
88
+ campaign_id: manifest.campaign.id,
89
+ campaign_name: manifest.campaign.name,
90
+ product: spec.product || { name: spec.product_name || null },
91
+ segment: spec.segment,
92
+ offer: spec.offer,
93
+ launch: { ...launch, launched_at: launchedAt },
94
+ campaign_status: latest?.campaign_status ?? null,
95
+ metrics_observed_at: observedAt,
96
+ metrics_source: source,
97
+ metrics_quality: !latest || !observedAt || !source || source === "unavailable" ? "unknown" : workspaceLevel
98
+ ? "uncertain-scope" : partial ? "partial" : "full",
99
+ metrics_quality_details: {
100
+ partial, possibly_workspace_level: workspaceLevel,
101
+ missing_metrics: missing, reason_codes: reasons,
102
+ ...(metrics._field_sources ? { field_sources: metrics._field_sources } : {}),
103
+ ...(metrics._contacted_count_recovery ? { contacted_count_recovery: {
104
+ ...metrics._contacted_count_recovery, raw_provider_count: metrics._raw_contacted_count,
105
+ } } : {}),
106
+ },
107
+ metrics_window: {
108
+ starts_at: timestamp(latest?.metrics_window?.starts_at) || launchedAt,
109
+ observed_at: observedAt,
110
+ basis: "cumulative_campaign_snapshot",
111
+ },
112
+ open_tracking_enabled: openTracking,
113
+ rate_denominators: { metric: "contacted", value: reliableDenominator },
114
+ metrics_summary: summary,
115
+ generated_at: generatedAt,
116
+ };
117
+ }
118
+
119
+ async function main() {
120
+ const args = parseArgs(process.argv);
121
+ const runDir = args["run-dir"] ? path.resolve(args["run-dir"]) : null;
122
+ if (!runDir) throw new Error("Missing --run-dir");
123
+ loadRunEnv(runDir, args["env-file"]);
124
+ const manifest = readJson(path.join(runDir, "manifest.json"));
125
+ const spec = readJson(path.join(runDir, "run-spec.json"));
126
+ if (!manifest || !spec) throw new Error("manifest.json and run-spec.json are required");
127
+ reconcileRunIdentity(manifest, spec);
128
+ const providerCampaignId = manifest.campaign?.id;
129
+ if (!providerCampaignId) throw new Error("manifest.campaign.id is required to collect an Instantly run");
130
+ reconcileInstantlyAttribution(manifest, {
131
+ runKey: spec.run_key, campaignId: providerCampaignId, label: "manifest",
132
+ });
133
+ const conclusionPath = path.join(runDir, "conclusion.json");
134
+ const existing = readJson(conclusionPath);
135
+ if (existing) {
136
+ reconcileRunIdentity(existing, spec);
137
+ reconcileInstantlyAttribution(existing, {
138
+ runKey: spec.run_key, campaignId: providerCampaignId, label: "existing conclusion",
139
+ });
140
+ }
141
+ const conclusion = collectFacts({
142
+ manifest, spec,
143
+ launch: readJson(path.join(runDir, "launch-summary.json"), {}),
144
+ history: readJson(path.join(runDir, "state", "analytics-history.json"), []),
145
+ });
146
+ // No DB lifecycle mutation. --force is a legacy no-op and cannot promote quality.
147
+ writeJson(conclusionPath, conclusion);
148
+ console.log(JSON.stringify(conclusion, null, 2));
149
+ }
150
+
151
+ if (require.main === module) {
152
+ main().catch((err) => {
153
+ console.error(err.stack || err.message);
154
+ process.exit(1);
155
+ });
156
+ }
157
+
158
+ module.exports = { collectFacts };