@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,607 @@
1
+ #!/usr/bin/env node
2
+ const path = require("path");
3
+ const {
4
+ InstantlyClient,
5
+ contactedForUtilization,
6
+ } = require("./lib/instantly-client");
7
+ const {
8
+ readJson,
9
+ writeJson,
10
+ parseArgs,
11
+ isoNow,
12
+ loadRunEnv,
13
+ getOsConfig,
14
+ assertCampaignNotForeign,
15
+ } = require("./lib/helpers");
16
+ const { initDb, upsertRun } = require("./lib/outreach-db");
17
+ const { collectCampaignMetrics } = require("./lib/campaign-metrics");
18
+ const { readOptOutHistory } = require("./lib/confirmed-opt-outs");
19
+ const { evaluateProtection, metricNumber, numberIn, replenishmentConfig } = require("./lib/run-config");
20
+
21
+ function pct(n, d) {
22
+ return metricNumber(n) != null && d > 0 ? (n / d) * 100 : null;
23
+ }
24
+
25
+ async function readOrUnavailable(operation) {
26
+ try { return await operation(); }
27
+ catch { return { status: 0, body: null }; }
28
+ }
29
+
30
+ // Instantly campaign status codes: 0 draft, 1 active, 2 paused, 3 completed.
31
+ const INSTANTLY_STATUS_DRAFT = 0;
32
+ const INSTANTLY_STATUS_ACTIVE = 1;
33
+ const INSTANTLY_STATUS_PAUSED = 2;
34
+ const INSTANTLY_STATUS_COMPLETED = 3;
35
+
36
+ // Statuses where Instantly sends nothing: gates are recorded but are not news
37
+ // and there is nothing to pause. Unknown/null is NOT here (fail safe).
38
+ const NOT_SENDING_STATUS = {
39
+ [INSTANTLY_STATUS_DRAFT]: "draft",
40
+ [INSTANTLY_STATUS_PAUSED]: "paused",
41
+ [INSTANTLY_STATUS_COMPLETED]: "completed",
42
+ };
43
+
44
+ // Relative change that turns an already-reported item into a fresh alert.
45
+ const MATERIAL_WORSENING = 0.5;
46
+
47
+ // The live campaign is what Instantly actually does, so its boolean wins; the
48
+ // run spec decides only when the live object does not carry the field.
49
+ // Launch defaults open_tracking to false when the spec omits it.
50
+ function openTrackingState(spec, campaignBody) {
51
+ const live = campaignBody?.open_tracking;
52
+ if (typeof live === "boolean") {
53
+ return {
54
+ enabled: live,
55
+ source: "live campaign",
56
+ reason: `live campaign open_tracking=${live}`,
57
+ };
58
+ }
59
+ if (typeof spec.campaign?.open_tracking === "boolean") {
60
+ return {
61
+ enabled: spec.campaign.open_tracking,
62
+ source: "run spec",
63
+ reason: `run spec campaign.open_tracking=${spec.campaign.open_tracking} (live campaign has no open_tracking field)`,
64
+ };
65
+ }
66
+ return {
67
+ enabled: false,
68
+ source: "default",
69
+ reason: "open_tracking unset in run spec and live campaign (launch default: off)",
70
+ };
71
+ }
72
+
73
+ function worsenedMaterially(item, alertedValue) {
74
+ if (typeof alertedValue !== "number" || typeof item.value !== "number") {
75
+ return false;
76
+ }
77
+ if (item.worse === "lower") {
78
+ return alertedValue > 0 && item.value <= alertedValue * (1 - MATERIAL_WORSENING);
79
+ }
80
+ return item.value >= alertedValue * (1 + MATERIAL_WORSENING) && item.value > alertedValue;
81
+ }
82
+
83
+ function expectedDailyCapacity(spec) {
84
+ return metricNumber(spec.campaign?.daily_limit);
85
+ }
86
+
87
+ function snapshotNearHoursAgo(history, hoursAgo) {
88
+ if (!Array.isArray(history) || history.length === 0) return null;
89
+ const target = Date.now() - hoursAgo * 3600 * 1000;
90
+ let best = null;
91
+ let bestDelta = Infinity;
92
+ for (const snap of history) {
93
+ const t = Date.parse(snap?.metrics_observed_at ?? snap?.generated_at ?? "");
94
+ if (Number.isNaN(t)) continue;
95
+ const delta = Math.abs(t - target);
96
+ if (delta < bestDelta) {
97
+ best = snap;
98
+ bestDelta = delta;
99
+ }
100
+ }
101
+ // Reject if the closest snapshot is too far from the target window (>50% drift).
102
+ if (best && bestDelta > hoursAgo * 0.5 * 3600 * 1000) return null;
103
+ return best;
104
+ }
105
+
106
+ function diagnoseThroughputAnomaly({
107
+ campaignBody,
108
+ contactedDelta,
109
+ utilization,
110
+ utilizationThreshold,
111
+ totalLeads,
112
+ leadCountsUnavailable,
113
+ }) {
114
+ const causes = [];
115
+ const status = campaignBody?.status;
116
+ if (status === 0 || status === 2 || status === 3) {
117
+ causes.push("campaign appears paused or not active in Instantly");
118
+ }
119
+ const liveEmailList = campaignBody?.email_list || [];
120
+ if (!liveEmailList.length) {
121
+ causes.push("campaign has no sending accounts assigned");
122
+ }
123
+ if (totalLeads === 0 || totalLeads == null) {
124
+ causes.push(
125
+ leadCountsUnavailable
126
+ ? "lead totals unreadable (leads read surface degraded, #3790) — zero-leads diagnosis unavailable"
127
+ : "campaign has zero leads loaded",
128
+ );
129
+ } else if (utilizationThreshold != null && utilization != null && utilization >= utilizationThreshold && contactedDelta === 0) {
130
+ causes.push(
131
+ "lead utilization reached the configured threshold with no new sends; inspect existing lead availability",
132
+ );
133
+ }
134
+ if (causes.length === 0) {
135
+ causes.push(
136
+ "no obvious cause; check mailbox health (per-account daily_limit may be reduced) and Instantly workspace warmup state",
137
+ );
138
+ }
139
+ return causes;
140
+ }
141
+
142
+ async function main() {
143
+ const args = parseArgs(process.argv);
144
+ const runDir = args["run-dir"] ? path.resolve(args["run-dir"]) : null;
145
+ if (!runDir) throw new Error("Missing --run-dir");
146
+ const connectionEnvFile = loadRunEnv(runDir, args["env-file"]);
147
+ const manifest = readJson(path.join(runDir, "manifest.json"));
148
+ const spec = readJson(path.join(runDir, "run-spec.json"));
149
+ const ownership = readJson(
150
+ path.join(runDir, "state", "ownership.json"),
151
+ manifest?.ownership || {},
152
+ );
153
+ if (!manifest?.campaign?.id)
154
+ throw new Error("Run manifest missing campaign ID");
155
+ const os = getOsConfig();
156
+ if (os.missing.length)
157
+ throw new Error(`Missing ${os.missing.join(" and ")}`);
158
+ const client = new InstantlyClient({
159
+ connectionEnvFile,
160
+ osApiKey: os.osApiKey,
161
+ osUrl: os.osUrl,
162
+ verbose: !!args.verbose,
163
+ });
164
+ const campaign = await client.getCampaign(manifest.campaign.id);
165
+ if (!(campaign.status >= 200 && campaign.status < 300)) {
166
+ throw new Error(
167
+ `Campaign lookup failed: ${campaign.status} ${JSON.stringify(campaign.body)}`,
168
+ );
169
+ }
170
+ assertCampaignNotForeign(
171
+ campaign.body,
172
+ ownership,
173
+ `campaign ${manifest.campaign.id}`,
174
+ );
175
+ const liveStatus =
176
+ typeof campaign.body?.status === "number" ? campaign.body.status : null;
177
+ // Observation must not turn lost opt-out history into a valid empty DB.
178
+ // Keep fail-safe provider pause available even when local recovery is needed.
179
+ let dbPath = null;
180
+ let historyError = null;
181
+ try {
182
+ readOptOutHistory(runDir);
183
+ dbPath = initDb(runDir);
184
+ } catch (error) {
185
+ historyError = error.message;
186
+ }
187
+
188
+ const launch = readJson(path.join(runDir, "launch-summary.json"), {});
189
+ const observation = await collectCampaignMetrics(client, manifest.campaign.id, campaign.body);
190
+ const metrics = observation.metrics;
191
+ const hasMetricObservation = ["contacted_count", "emails_sent_count", "reply_count_unique",
192
+ "bounced_count", "open_count_unique", "spam_complaint_count", "spam_count"]
193
+ .some(key => metricNumber(metrics[key]) != null);
194
+ const metricsObservedAt = hasMetricObservation ? isoNow() : null;
195
+ const status = await readOrUnavailable(() => client.sendingStatus(manifest.campaign.id));
196
+ const contacted = metricNumber(metrics.contacted_count);
197
+ const denominator = metrics._partial || metrics._possibly_workspace_level ? null : contacted;
198
+ const replyRate = pct(metrics.reply_count_unique, denominator);
199
+ const bounceRate = pct(metrics.bounced_count, denominator);
200
+ const unsubRate = pct(metrics.unsubscribed_count, denominator);
201
+ const spamCount = metricNumber(metrics.spam_complaint_count ?? metrics.spam_count);
202
+ const spamRate = pct(spamCount, denominator);
203
+ const openTracking = openTrackingState(spec, campaign.body);
204
+ if (!openTracking.enabled) metrics.open_count_unique = null;
205
+ const openRate = openTracking.enabled ? pct(metrics.open_count_unique, denominator) : null;
206
+
207
+ const protection = evaluateProtection(spec, metrics);
208
+ const thresholds = protection.thresholds;
209
+ const triggeredGates = protection.triggered;
210
+ if (historyError) triggeredGates.push({ gate: "history_unavailable", value: null,
211
+ threshold: null, reason: historyError });
212
+ const skippedGates = protection.skipped;
213
+ const pauseSuggested = triggeredGates.length > 0;
214
+ const recommendations = triggeredGates.map(g => g.reason
215
+ ? `Protection ${g.gate}: ${g.reason}.`
216
+ : `Protection ${g.gate}: ${g.value.toFixed(3)}% exceeds configured ${g.threshold}%.`);
217
+ if (!(status.status >= 200 && status.status < 300)) recommendations.push(
218
+ "Sending status endpoint returned an error. Inspect sending health."
219
+ );
220
+
221
+ // --- Lead utilization tracking ---
222
+ const leadStats = campaign.body?.lead_stats || {};
223
+ let totalLeads = metricNumber(leadStats.total);
224
+ let contactedLeads = denominator;
225
+ let leadCountsSource = "lead_stats";
226
+ let leadCountsUnavailable = false;
227
+ if (totalLeads == null) {
228
+ // lead_stats can be null while the campaign is healthy (#3790); count
229
+ // through the leads API before concluding "zero leads loaded".
230
+ const counts = observation.leadCounts || await client.countLeads(manifest.campaign.id).catch(() => ({ ok: false }));
231
+ if (counts.ok && counts.partial) {
232
+ // A partial count is only a lower bound — using it as a utilization
233
+ // denominator inflates the ratio (90 contacted of a truncated 90-lead
234
+ // page reads as 100% on a 1000-lead campaign). Treat as unreadable,
235
+ // matching replenish-leads.
236
+ leadCountsSource = "unavailable";
237
+ leadCountsUnavailable = true;
238
+ } else if (counts.ok) {
239
+ totalLeads = counts.total;
240
+ contactedLeads = contactedForUtilization(contactedLeads, counts);
241
+ leadCountsSource = "leads-api";
242
+ } else if (!counts.ok) {
243
+ leadCountsSource = "unavailable";
244
+ leadCountsUnavailable = true;
245
+ }
246
+ }
247
+ const leadUtilization = totalLeads > 0 && contactedLeads != null ? contactedLeads / totalLeads : null;
248
+ let replenishConfig = null;
249
+ try {
250
+ replenishConfig = replenishmentConfig(spec);
251
+ } catch (error) {
252
+ recommendations.push(error.message);
253
+ }
254
+ const utilizationThreshold = replenishConfig?.utilization_threshold ?? null;
255
+ const needsReplenishment = !!replenishConfig && leadUtilization != null
256
+ && leadUtilization >= utilizationThreshold;
257
+ if (needsReplenishment) recommendations.push(
258
+ `Lead utilization is ${(leadUtilization * 100).toFixed(0)}% at configured ${(utilizationThreshold * 100).toFixed(0)}% threshold. Replenishment is enabled; job execution has not been verified by this observation.`
259
+ );
260
+
261
+ // Throughput is observable only against an explicitly configured capacity
262
+ // floor and comparable complete cumulative snapshots.
263
+ const snapshotsPathExisting = path.join(
264
+ runDir,
265
+ "state",
266
+ "analytics-history.json",
267
+ );
268
+ const priorHistory = readJson(snapshotsPathExisting, []);
269
+ const expectedDaily = expectedDailyCapacity(spec);
270
+ const throughputFloorPct = numberIn(spec.monitoring?.min_daily_capacity_pct, 0, 100)
271
+ ? spec.monitoring.min_daily_capacity_pct : null;
272
+ const referenceSnap = snapshotNearHoursAgo(priorHistory, 24);
273
+ let throughputHealth = {
274
+ expected_daily_sends: expectedDaily,
275
+ floor_pct: throughputFloorPct,
276
+ measurable: false,
277
+ };
278
+ // Emails-fallback snapshots cap counts at ~100 rows — comparing one
279
+ // against a full analytics snapshot produces phantom deltas in either
280
+ // direction, so the throughput gate requires two same-quality snapshots.
281
+ if (throughputFloorPct == null) {
282
+ throughputHealth.skipped_reason = "not_configured";
283
+ } else if (metrics._partial || referenceSnap?.metrics?._partial
284
+ || metrics._possibly_workspace_level || referenceSnap?.metrics?._possibly_workspace_level) {
285
+ throughputHealth.skipped_reason = "partial-metrics";
286
+ } else if (expectedDaily > 0 && referenceSnap
287
+ && metricNumber(referenceSnap.metrics?.emails_sent_count) != null
288
+ && metricNumber(metrics.emails_sent_count) != null
289
+ && metrics.emails_sent_count >= referenceSnap.metrics.emails_sent_count) {
290
+ const refSent = referenceSnap.metrics.emails_sent_count;
291
+ const curSent = metrics.emails_sent_count;
292
+ const refTime = Date.parse(referenceSnap.metrics_observed_at ?? referenceSnap.generated_at ?? "");
293
+ const curTime = Date.now();
294
+ const hoursElapsed = Math.max(1, (curTime - refTime) / (3600 * 1000));
295
+ const sendsDelta = Math.max(0, curSent - refSent);
296
+ const actualDailyRate = (sendsDelta / hoursElapsed) * 24;
297
+ const actualPctOfExpected = pct(actualDailyRate, expectedDaily);
298
+ const anomaly = actualPctOfExpected < throughputFloorPct;
299
+ throughputHealth = {
300
+ ...throughputHealth,
301
+ measurable: true,
302
+ hours_elapsed: Math.round(hoursElapsed * 10) / 10,
303
+ sends_delta: sendsDelta,
304
+ actual_daily_rate: Math.round(actualDailyRate * 10) / 10,
305
+ actual_pct_of_expected: Math.round(actualPctOfExpected),
306
+ anomaly,
307
+ };
308
+ if (anomaly) {
309
+ const causes = diagnoseThroughputAnomaly({
310
+ campaignBody: campaign.body,
311
+ contactedDelta: sendsDelta,
312
+ utilization: leadUtilization,
313
+ utilizationThreshold,
314
+ totalLeads,
315
+ leadCountsUnavailable,
316
+ });
317
+ throughputHealth.probable_causes = causes;
318
+ recommendations.push(
319
+ `Throughput anomaly: actual ${actualDailyRate.toFixed(1)} sends/day vs expected ${expectedDaily} (${actualPctOfExpected.toFixed(0)}% < ${throughputFloorPct}% floor). Probable causes: ${causes.join("; ")}.`,
320
+ );
321
+ }
322
+ }
323
+
324
+ // --- Alert de-duplication ---
325
+ // The monitor runs hourly; a tripped gate stays tripped until someone acts.
326
+ // Mark each tripped item "new" only the first time (or when it worsens
327
+ // materially) so the cron agent reports it once instead of every hour.
328
+ const alertStatePath = path.join(runDir, "state", "monitor-alerts.json");
329
+ const alertState = readJson(alertStatePath, {});
330
+ const alertItems = triggeredGates.map((g) => ({
331
+ key: `protection:${g.gate}`,
332
+ kind: "protection_gate",
333
+ gate: g.gate,
334
+ value: g.value,
335
+ threshold: g.threshold,
336
+ ...(g.gate === "spam" ? { count: spamCount } : {}),
337
+ worse: "higher",
338
+ }));
339
+ // A paused, completed or draft campaign sends nothing, so its throughput
340
+ // "anomaly" is expected and not a separate incident.
341
+ const notSendingState =
342
+ liveStatus != null ? NOT_SENDING_STATUS[liveStatus] || null : null;
343
+ // Completed/draft: nothing to pause and nothing the owner must act on.
344
+ const finishedOrDraft =
345
+ liveStatus === INSTANTLY_STATUS_COMPLETED || liveStatus === INSTANTLY_STATUS_DRAFT;
346
+ const throughputAlertable = throughputHealth.anomaly && !notSendingState;
347
+ if (throughputHealth.anomaly && !throughputAlertable) {
348
+ throughputHealth.alert = "suppressed";
349
+ throughputHealth.alert_suppressed_reason = `campaign is ${notSendingState} (Instantly status ${liveStatus})`;
350
+ }
351
+ if (throughputAlertable) {
352
+ alertItems.push({
353
+ key: "throughput",
354
+ kind: "throughput_anomaly",
355
+ value: throughputHealth.actual_pct_of_expected,
356
+ threshold: throughputFloorPct,
357
+ worse: "lower",
358
+ });
359
+ }
360
+ // Keys evaluated this poll: a gate that was checked and did not trip is
361
+ // cleared, so a later trip is "new" again. Gates that were not evaluated
362
+ // (unreadable metrics) keep their state until an evaluated recovery.
363
+ const evaluatedKeys = new Set(["protection:configuration", "protection:history_unavailable"]);
364
+ for (const gate of ["bounce", "spam"]) {
365
+ if (protection.evaluated.includes(gate)
366
+ || protection.skipped.some(item => item.gate === gate)) {
367
+ evaluatedKeys.add(`protection:${gate}`);
368
+ evaluatedKeys.add(`protection:${gate}_unavailable`);
369
+ }
370
+ }
371
+ if (throughputHealth.measurable && !notSendingState) {
372
+ evaluatedKeys.add("throughput");
373
+ }
374
+ const nowIso = isoNow();
375
+ // Migrate operational alert acknowledgements, not the retired stage model.
376
+ const nextGates = Object.fromEntries(Object.entries(alertState.gates || {})
377
+ .map(([key, value]) => [key.replace(/^c1:/, "protection:"), value]));
378
+ delete nextGates["protection:open_rate"];
379
+ for (const key of Object.keys(nextGates)) {
380
+ if (evaluatedKeys.has(key) && !alertItems.some((a) => a.key === key)) {
381
+ delete nextGates[key];
382
+ }
383
+ }
384
+
385
+ // Operator acknowledgement: the monitor paused for a gate and the campaign
386
+ // is active again, so someone resumed it on purpose. Do not pause or alert
387
+ // again for that gate unless it worsens materially against the value at the
388
+ // pause (for spam: any new complaint), or another gate trips.
389
+ // Only an explicit "active" counts as a resume. A failed read (null),
390
+ // completed (3) or any other status leaves the gate un-acknowledged, so the
391
+ // monitor keeps trying to pause and keeps reporting (fail safe).
392
+ const resumedByOperator = liveStatus === INSTANTLY_STATUS_ACTIVE;
393
+ const needsPause = new Set();
394
+ const alerts = alertItems.map((item) => {
395
+ const prior = nextGates[item.key];
396
+ const resumedAfterPause =
397
+ item.kind === "protection_gate" && typeof item.value === "number"
398
+ && !!prior?.paused_at && resumedByOperator;
399
+ let isNew;
400
+ let acknowledged = false;
401
+ if (resumedAfterPause) {
402
+ const worse =
403
+ worsenedMaterially(item, prior.paused_value) ||
404
+ (item.count != null && item.count > (prior.paused_count ?? 0));
405
+ acknowledged = !worse;
406
+ isNew = worse;
407
+ } else if (finishedOrDraft) {
408
+ // Recorded, never news: nothing is sending. alerted_at stays unset if
409
+ // it was never reported, so a later send (draft activated) alerts.
410
+ isNew = false;
411
+ } else {
412
+ isNew = !prior?.alerted_at || worsenedMaterially(item, prior.alerted_value);
413
+ }
414
+ if (item.kind === "protection_gate" && !acknowledged) needsPause.add(item.key);
415
+ nextGates[item.key] = {
416
+ first_tripped_at: prior?.first_tripped_at || nowIso,
417
+ alerted_at: isNew ? nowIso : prior?.alerted_at || null,
418
+ alerted_value: isNew ? item.value : prior?.alerted_value ?? null,
419
+ last_value: item.value,
420
+ ...(item.count != null ? { last_count: item.count } : {}),
421
+ last_seen_at: nowIso,
422
+ paused_at: prior?.paused_at || null,
423
+ paused_value: prior?.paused_value ?? null,
424
+ paused_count: prior?.paused_count ?? null,
425
+ acknowledged_at: acknowledged ? prior.acknowledged_at || nowIso : null,
426
+ };
427
+ const { worse, ...rest } = item;
428
+ return {
429
+ ...rest,
430
+ alert: isNew ? "new" : "repeat",
431
+ first_tripped_at: nextGates[item.key].first_tripped_at,
432
+ ...(finishedOrDraft
433
+ ? { not_news_reason: `campaign is ${notSendingState} in Instantly; nothing is sending` }
434
+ : {}),
435
+ ...(acknowledged
436
+ ? {
437
+ acknowledged_at: nextGates[item.key].acknowledged_at,
438
+ acknowledged_reason: "campaign resumed after the monitor paused it for this gate",
439
+ }
440
+ : {}),
441
+ };
442
+ });
443
+ for (const gate of triggeredGates) {
444
+ const match = alerts.find((a) => a.key === `protection:${gate.gate}`);
445
+ if (match) gate.alert = match.alert;
446
+ }
447
+ if (throughputAlertable) {
448
+ throughputHealth.alert = alerts.find((a) => a.key === "throughput").alert;
449
+ }
450
+
451
+ const snapshot = {
452
+ run_key: manifest.run_key,
453
+ campaign_id: manifest.campaign.id,
454
+ metrics,
455
+ sending_status: status.body,
456
+ derived: {
457
+ reply_rate: replyRate,
458
+ bounce_rate: bounceRate,
459
+ unsubscribe_rate: unsubRate,
460
+ spam_complaint_rate: spamRate,
461
+ open_rate: openRate,
462
+ },
463
+ protection: {
464
+ active: protection.valid,
465
+ contacted,
466
+ thresholds,
467
+ triggered_gates: triggeredGates,
468
+ skipped_gates: skippedGates,
469
+ },
470
+ open_tracking: openTracking,
471
+ open_tracking_enabled: openTracking.enabled,
472
+ metrics_observed_at: metricsObservedAt,
473
+ metrics_window: {
474
+ starts_at: manifest.campaign?.first_launched_at ?? launch.launched_at ?? launch.started_at ?? null,
475
+ observed_at: metricsObservedAt,
476
+ basis: "cumulative_campaign_snapshot",
477
+ },
478
+ campaign_status: liveStatus,
479
+ outreach_history_available: !historyError,
480
+ lead_utilization: {
481
+ total_leads: totalLeads,
482
+ contacted: contactedLeads,
483
+ source: leadCountsSource,
484
+ utilization_pct: leadUtilization != null ? Math.round(leadUtilization * 1000) / 10 : null,
485
+ threshold_pct: utilizationThreshold != null ? utilizationThreshold * 100 : null,
486
+ needs_replenishment: needsReplenishment,
487
+ },
488
+ throughput_health: throughputHealth,
489
+ recommendations,
490
+ pause_suggested: pauseSuggested,
491
+ alerts,
492
+ // "new": at least one item needs the owner this run; "repeat": items are
493
+ // still tripped but were already reported; "none": nothing tripped.
494
+ alert: alerts.some((a) => a.alert === "new")
495
+ ? "new"
496
+ : alerts.length
497
+ ? "repeat"
498
+ : "none",
499
+ generated_at: nowIso,
500
+ };
501
+
502
+ priorHistory.push(snapshot);
503
+ writeJson(snapshotsPathExisting, priorHistory);
504
+ writeJson(path.join(runDir, "monitor-summary.json"), snapshot);
505
+
506
+ let pausedThisRun = false;
507
+ const autopause = protection.autopause;
508
+ if (pauseSuggested && autopause && needsPause.size === 0) {
509
+ snapshot.pause_suppressed = {
510
+ reason: "operator resumed the campaign after a monitor pause; tripped gates are acknowledged",
511
+ gates: alerts.filter((a) => a.acknowledged_at).map((a) => a.gate),
512
+ };
513
+ } else if (pauseSuggested && autopause) {
514
+ if (finishedOrDraft) {
515
+ snapshot.pause_skipped = {
516
+ reason: `campaign is ${notSendingState} in Instantly; nothing is sending`,
517
+ };
518
+ } else if (liveStatus === INSTANTLY_STATUS_PAUSED) {
519
+ // Already paused (by an earlier tick or the operator): pausing again
520
+ // changes nothing and would read as a fresh incident.
521
+ snapshot.pause_skipped = {
522
+ reason: "campaign already paused in Instantly (status 2)",
523
+ paused_by_monitor_at: alertState.paused_by_monitor_at || null,
524
+ };
525
+ } else {
526
+ const pause = await readOrUnavailable(() => client.pauseCampaign(manifest.campaign.id));
527
+ const at = isoNow();
528
+ snapshot.pause_action = { status: pause.status, body: pause.body, at };
529
+ if (pause.status >= 200 && pause.status < 300) {
530
+ const readback = await readOrUnavailable(() => client.getCampaign(manifest.campaign.id));
531
+ if (readback.status >= 200 && readback.status < 300) {
532
+ assertCampaignNotForeign(readback.body, ownership, `campaign ${manifest.campaign.id}`);
533
+ }
534
+ snapshot.pause_readback = { status: readback.status, campaign_status: readback.body?.status ?? null };
535
+ pausedThisRun = readback.status >= 200 && readback.status < 300
536
+ && readback.body?.status === INSTANTLY_STATUS_PAUSED;
537
+ }
538
+ if (pausedThisRun) {
539
+ for (const item of alerts) {
540
+ if (item.kind !== "protection_gate") continue;
541
+ Object.assign(nextGates[item.key], {
542
+ paused_at: at,
543
+ paused_value: item.value,
544
+ paused_count: item.count ?? null,
545
+ acknowledged_at: null,
546
+ });
547
+ }
548
+ } else {
549
+ // A campaign that should be paused but cannot be is never a repeat:
550
+ // every tick says so until a pause succeeds or it is paused by hand.
551
+ snapshot.pause_failed = true;
552
+ snapshot.pause_http_status = pause.status;
553
+ snapshot.recommendations.push(
554
+ `Auto-pause FAILED (HTTP ${pause.status}). Pause was not confirmed by provider readback; check the campaign and pause it in Instantly.`,
555
+ );
556
+ for (const item of alerts) {
557
+ if (needsPause.has(item.key)) item.alert = "new";
558
+ }
559
+ }
560
+ // A pause (or a failed pause) is always news for the owner.
561
+ snapshot.alert = "new";
562
+ }
563
+ }
564
+ for (const gate of triggeredGates) {
565
+ const match = alerts.find((a) => a.key === `protection:${gate.gate}`);
566
+ if (match) gate.alert = match.alert;
567
+ }
568
+ // The history entry is the same object: rewrite it with the pause outcome.
569
+ writeJson(snapshotsPathExisting, priorHistory);
570
+ writeJson(path.join(runDir, "monitor-summary.json"), snapshot);
571
+
572
+ writeJson(alertStatePath, {
573
+ gates: nextGates,
574
+ paused_by_monitor_at: pausedThisRun
575
+ ? snapshot.pause_action.at
576
+ : alertState.paused_by_monitor_at || null,
577
+ updated_at: nowIso,
578
+ });
579
+
580
+ if (dbPath) upsertRun(dbPath, {
581
+ run_key: manifest.run_key,
582
+ product_name: spec.product?.name || spec.product_name,
583
+ segment_name:
584
+ spec.segment?.name || spec.segment?.description || spec.segment,
585
+ offer_headline:
586
+ spec.offer?.headline ||
587
+ spec.offer?.name ||
588
+ spec.offer?.description ||
589
+ spec.offer,
590
+ campaign_id: manifest.campaign.id,
591
+ campaign_name: manifest.campaign?.name || spec.campaign?.name,
592
+ // Reflect what Instantly is doing: paused when this tick's pause call
593
+ // succeeded or the live campaign is already paused, never on a failed call.
594
+ status:
595
+ pausedThisRun || liveStatus === INSTANTLY_STATUS_PAUSED
596
+ ? "paused"
597
+ : "launched",
598
+ created_at: manifest.created_at || spec.created_at || isoNow(),
599
+ });
600
+
601
+ console.log(JSON.stringify(snapshot, null, 2));
602
+ }
603
+
604
+ main().catch((err) => {
605
+ console.error(err.stack || err.message);
606
+ process.exit(1);
607
+ });