@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.
- package/LICENSE +4 -0
- package/README.md +124 -2
- package/index.js +5 -0
- package/package.json +55 -4
- package/plugin.js +230 -0
- package/session-log.js +315 -0
- package/skills/.egbe-catalog/manifest.json +1 -0
- package/skills/egbe-os-analytics/SKILL.md +499 -0
- package/skills/egbe-os-analytics/canonical-events.v1.json +256 -0
- package/skills/egbe-os-analytics/references/session-funnel.md +130 -0
- package/skills/egbe-os-analytics/references/workflows/activation-tracking.md +147 -0
- package/skills/egbe-os-analytics/references/workflows/landing-click-tracking.md +209 -0
- package/skills/egbe-os-analytics/references/workflows/payment-lifecycle-tracking.md +122 -0
- package/skills/egbe-os-analytics/references/workflows/product-funnel-tracking.md +77 -0
- package/skills/egbe-os-analytics/references/workflows/signup-lifecycle-tracking.md +208 -0
- package/skills/egbe-os-analytics/scripts/umami_funnel.py +927 -0
- package/skills/egbe-os-apollo-lead-finder/SKILL.md +135 -0
- package/skills/egbe-os-apollo-lead-finder/references/operations.md +240 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/enrich.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/find-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/apollo-client.js +343 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/helpers.js +127 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/places-filters.js +217 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/lib/sourcing.js +153 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.js +653 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/places-leads.sh +4 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.js +6 -0
- package/skills/egbe-os-apollo-lead-finder/scripts/search.sh +4 -0
- package/skills/egbe-os-campaign-landing-page/SKILL.md +95 -0
- package/skills/egbe-os-campaign-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-campaign-landing-page/references/leads-calendar-and-tracking.md +66 -0
- package/skills/egbe-os-campaign-landing-page/references/os-wiring.md +58 -0
- package/skills/egbe-os-campaign-landing-page/references/qa.md +40 -0
- package/skills/egbe-os-campaign-landing-page/references/routing.md +32 -0
- package/skills/egbe-os-db/SKILL.md +174 -0
- package/skills/egbe-os-deploy/SKILL.md +412 -0
- package/skills/egbe-os-design/SKILL.md +182 -0
- package/skills/egbe-os-design-landing-page/SKILL.md +117 -0
- package/skills/egbe-os-design-landing-page/agents/openai.yaml +4 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/.dockerignore +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/AGENTS.md +31 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/Dockerfile +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/eslint.config.mjs +18 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/next.config.ts +11 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/package.json +36 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/postcss.config.mjs +7 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/public/.gitkeep +1 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.edge.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/sentry.server.config.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/global-error.tsx +19 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/globals.css +22 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/layout.tsx +21 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/page.tsx +3 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/app/privacy/page.tsx +28 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/components/egbe-analytics.tsx +39 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation-client.ts +15 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/instrumentation.ts +13 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/egbe-observability.generated.ts +20 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/src/lib/utils.ts +6 -0
- package/skills/egbe-os-design-landing-page/assets/scaffold/tsconfig.json +34 -0
- package/skills/egbe-os-design-landing-page/references/application-preparation.md +44 -0
- package/skills/egbe-os-design-landing-page/references/page-inputs.md +22 -0
- package/skills/egbe-os-destination-readiness/SKILL.md +132 -0
- package/skills/egbe-os-destination-readiness/references/checks.md +130 -0
- package/skills/egbe-os-destination-readiness/references/network-requirements.md +34 -0
- package/skills/egbe-os-destination-readiness/references/report.md +116 -0
- package/skills/egbe-os-domains/SKILL.md +189 -0
- package/skills/egbe-os-errors/SKILL.md +259 -0
- package/skills/egbe-os-git/SKILL.md +275 -0
- package/skills/egbe-os-git/references/issues.md +33 -0
- package/skills/egbe-os-google-ads/SKILL.md +163 -0
- package/skills/egbe-os-google-ads/references/artifacts.md +133 -0
- package/skills/egbe-os-google-ads/references/campaigns.md +157 -0
- package/skills/egbe-os-google-ads/references/conversions.md +153 -0
- package/skills/egbe-os-google-ads/references/delivery.md +128 -0
- package/skills/egbe-os-google-ads/references/keyword-ideas.md +40 -0
- package/skills/egbe-os-google-ads/references/reporting.md +105 -0
- package/skills/egbe-os-google-ads/references/search-assets.md +219 -0
- package/skills/egbe-os-google-ads/references/server-conversions.md +119 -0
- package/skills/egbe-os-google-auth/SKILL.md +285 -0
- package/skills/egbe-os-google-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-gtm-knowledge/SKILL.md +151 -0
- package/skills/egbe-os-images/SKILL.md +163 -0
- package/skills/egbe-os-images/references/stock-images.md +21 -0
- package/skills/egbe-os-instantly-campaign-launcher/SKILL.md +127 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/instantly-ops.md +260 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/observation-and-scheduling.md +188 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/reply-handling.md +116 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-spec-template.json +65 -0
- package/skills/egbe-os-instantly-campaign-launcher/references/run-state.md +145 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/conclude-campaign.js +158 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/install-crons.js +956 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/launch-campaign.js +2008 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/campaign-metrics.js +124 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/confirmed-opt-outs.js +208 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/connection-identity.js +17 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/create-once.js +23 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/gtm-identity.js +125 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/helpers.js +545 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/html-body.js +266 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/instantly-client.js +328 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/outreach-db.js +370 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/recipient-exclusion/index.js +86 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/replenish-test-harness.js +53 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/reply-queue.js +67 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/run-config.js +103 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/lib/sender-selection.js +105 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/monitor-campaign.js +607 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/outreach-report.js +147 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/replenish-leads.js +619 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/reply-worker.js +258 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/run-cron-job.js +32 -0
- package/skills/egbe-os-instantly-campaign-launcher/scripts/send-reply.js +260 -0
- package/skills/egbe-os-linkedin-ads/SKILL.md +114 -0
- package/skills/egbe-os-linkedin-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/api-reference.md +154 -0
- package/skills/egbe-os-linkedin-ads/references/runtime/artifacts.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/build-paused.md +44 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/conversions.md +88 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/launch-and-pause.md +49 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/monitoring.md +35 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/readiness.md +63 -0
- package/skills/egbe-os-linkedin-ads/references/workflows/targeting-and-creative.md +52 -0
- package/skills/egbe-os-llm/SKILL.md +160 -0
- package/skills/egbe-os-mail/SKILL.md +180 -0
- package/skills/egbe-os-me/SKILL.md +119 -0
- package/skills/egbe-os-meta-ads/SKILL.md +114 -0
- package/skills/egbe-os-meta-ads/references/creative/creative-specs.md +15 -0
- package/skills/egbe-os-meta-ads/references/creative/talking-head.md +35 -0
- package/skills/egbe-os-meta-ads/references/destination-requirements.md +30 -0
- package/skills/egbe-os-meta-ads/references/runtime/api-reference.md +436 -0
- package/skills/egbe-os-meta-ads/references/runtime/artifacts.md +51 -0
- package/skills/egbe-os-meta-ads/references/runtime/insights-reference.md +187 -0
- package/skills/egbe-os-meta-ads/references/runtime/pixel-install.md +196 -0
- package/skills/egbe-os-meta-ads/references/runtime/shared-analytics-attribution.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/build-paused.md +36 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch-ready.md +16 -0
- package/skills/egbe-os-meta-ads/references/workflows/launch.md +23 -0
- package/skills/egbe-os-meta-ads/references/workflows/monitoring.md +72 -0
- package/skills/egbe-os-meta-ads/references/workflows/pause.md +17 -0
- package/skills/egbe-os-meta-ads/references/workflows/recovery.md +23 -0
- package/skills/egbe-os-meta-ads/scripts/check-pixel.py +229 -0
- package/skills/egbe-os-meta-ads/scripts/validate-meta-artifacts.py +187 -0
- package/skills/egbe-os-notifications/SKILL.md +78 -0
- package/skills/egbe-os-openai-ads/SKILL.md +149 -0
- package/skills/egbe-os-openai-ads/references/creative/chat-card.md +51 -0
- package/skills/egbe-os-openai-ads/references/destination-requirements.md +29 -0
- package/skills/egbe-os-openai-ads/references/runtime/api-reference.md +219 -0
- package/skills/egbe-os-openai-ads/references/runtime/artifacts.md +169 -0
- package/skills/egbe-os-openai-ads/references/workflows/build-paused.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/conversions.md +40 -0
- package/skills/egbe-os-openai-ads/references/workflows/creative-assembly.md +24 -0
- package/skills/egbe-os-openai-ads/references/workflows/launch.md +27 -0
- package/skills/egbe-os-openai-ads/references/workflows/monitoring.md +54 -0
- package/skills/egbe-os-openai-ads/references/workflows/pause.md +22 -0
- package/skills/egbe-os-openai-ads/references/workflows/readiness.md +37 -0
- package/skills/egbe-os-openai-ads/references/workflows/tracking.md +32 -0
- package/skills/egbe-os-openai-ads/scripts/validate-openai-artifacts.py +271 -0
- package/skills/egbe-os-organic-trend-watch/SKILL.md +139 -0
- package/skills/egbe-os-organic-trend-watch/agents/openai.yaml +4 -0
- package/skills/egbe-os-organic-trend-watch/references/analysis-and-adaptation.md +54 -0
- package/skills/egbe-os-organic-trend-watch/references/collection-and-analysis.md +117 -0
- package/skills/egbe-os-organic-trend-watch/references/output-contract.md +133 -0
- package/skills/egbe-os-organic-trend-watch/references/provider-contract.md +169 -0
- package/skills/egbe-os-organic-trend-watch/references/runtime-contract.md +204 -0
- package/skills/egbe-os-organic-trend-watch/references/visual-analysis-prompt.md +17 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_analysis.py +612 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_contract.py +1133 -0
- package/skills/egbe-os-organic-trend-watch/scripts/_provider_inputs.py +165 -0
- package/skills/egbe-os-organic-trend-watch/scripts/analyze-visual-evidence.py +315 -0
- package/skills/egbe-os-organic-trend-watch/scripts/build-provider-inputs.py +88 -0
- package/skills/egbe-os-organic-trend-watch/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-organic-trend-watch/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-organic-trend-watch/scripts/finalize-receipt.py +106 -0
- package/skills/egbe-os-organic-trend-watch/scripts/normalize-videos.py +647 -0
- package/skills/egbe-os-organic-trend-watch/scripts/prepare-visual-evidence.py +324 -0
- package/skills/egbe-os-organic-trend-watch/scripts/render-result.py +30 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-apify.py +723 -0
- package/skills/egbe-os-organic-trend-watch/scripts/run-state.py +192 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-context.py +27 -0
- package/skills/egbe-os-organic-trend-watch/scripts/validate-runtime.py +137 -0
- package/skills/egbe-os-payments/SKILL.md +215 -0
- package/skills/egbe-os-payments/agents/openai.yaml +4 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/.egbe/scaffolds/billing-nextjs-subscription.v1.json +5 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/AGENTS.append.md +13 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/db/migrations/1000_egbe_billing.sql +66 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/package.fragment.json +12 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/scripts/billing-sync.mjs +162 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/error.tsx +11 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/loading.tsx +8 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/account/billing/page.tsx +121 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/checkout/route.ts +102 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/portal/route.ts +54 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/billing/status/route.ts +22 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/app/api/payments/webhook/route.ts +65 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/components/egbe-billing/plan-badge.tsx +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/billing-sync.test.mjs +58 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/catalog.ts +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/checkout-payload.ts +47 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/foundation-contract.test.mjs +59 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.d.ts +16 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.mjs +82 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/lifecycle.test.mjs +94 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/os-client.ts +96 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/plans.json +17 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/repository.ts +325 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.d.ts +6 -0
- package/skills/egbe-os-payments/assets/scaffolds/billing-nextjs-subscription/src/lib/egbe-billing/signature.mjs +22 -0
- package/skills/egbe-os-payments/references/contracts/plan-catalog.md +46 -0
- package/skills/egbe-os-payments/references/security/durable-verification.md +64 -0
- package/skills/egbe-os-payments/references/security/server-integration.md +26 -0
- package/skills/egbe-os-payments/references/security/webhook-and-entitlements.md +152 -0
- package/skills/egbe-os-payments/references/ux/billing-experience.md +47 -0
- package/skills/egbe-os-payments/references/workflows/account-billing.md +64 -0
- package/skills/egbe-os-payments/references/workflows/discounts-and-promotion-codes.md +265 -0
- package/skills/egbe-os-payments/references/workflows/one-time-purchase.md +75 -0
- package/skills/egbe-os-payments/references/workflows/product-checkout.md +355 -0
- package/skills/egbe-os-payments/references/workflows/subscription-lifecycle.md +55 -0
- package/skills/egbe-os-playbook/SKILL.md +79 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/email-outreach.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/google-search.md +40 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/linkedin.md +24 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/meta.md +23 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/openai.md +15 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/channels/reddit.md +56 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/choose-test.md +73 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/evaluate.md +91 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/market.md +96 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition/run-test.md +111 -0
- package/skills/egbe-os-playbook/playbooks/market-and-acquisition.md +56 -0
- package/skills/egbe-os-playbook/playbooks/product/business-loop.md +141 -0
- package/skills/egbe-os-playbook/playbooks/product/collaboration.md +26 -0
- package/skills/egbe-os-playbook/playbooks/product/deliver.md +75 -0
- package/skills/egbe-os-playbook/playbooks/product/diagnose.md +80 -0
- package/skills/egbe-os-playbook/playbooks/product/evaluate.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/experience.md +132 -0
- package/skills/egbe-os-playbook/playbooks/product/loop-examples.md +67 -0
- package/skills/egbe-os-playbook/playbooks/product/offer.md +65 -0
- package/skills/egbe-os-playbook/playbooks/product/value.md +91 -0
- package/skills/egbe-os-playbook/playbooks/product.md +67 -0
- package/skills/egbe-os-playbook/references/catalog.md +127 -0
- package/skills/egbe-os-playbook/references/changes.md +167 -0
- package/skills/egbe-os-playbook/scripts/playbook-changes.py +6 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/__init__.py +1 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/cli.py +57 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/operations.py +137 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/protocol.py +132 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/storage.py +180 -0
- package/skills/egbe-os-playbook/scripts/playbook_changes/transport.py +113 -0
- package/skills/egbe-os-product-auth/SKILL.md +151 -0
- package/skills/egbe-os-product-auth/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-auth/assets/db/README.md +102 -0
- package/skills/egbe-os-product-auth/assets/db/create-validation-session.mjs +223 -0
- package/skills/egbe-os-product-auth/assets/db/migrate.mjs +64 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0001_auth.sql +33 -0
- package/skills/egbe-os-product-auth/assets/db/migrations/0002_auth_identities.sql +16 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/AGENTS.append.md +17 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-auth-database/package.fragment.json +10 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/AGENTS.append.md +9 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/package.fragment.json +13 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/db.ts +31 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/identity.ts +94 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/index.ts +3 -0
- package/skills/egbe-os-product-auth/assets/scaffolds/product-nextjs-postgres/src/lib/egbe-product/session.ts +91 -0
- package/skills/egbe-os-product-auth/references/contracts/live-auth-interface.md +108 -0
- package/skills/egbe-os-product-auth/references/frameworks/nextjs.md +34 -0
- package/skills/egbe-os-product-auth/references/security/session-and-credentials.md +73 -0
- package/skills/egbe-os-product-auth/references/ux/auth-experience.md +58 -0
- package/skills/egbe-os-product-auth/references/workflows/account-recovery.md +22 -0
- package/skills/egbe-os-product-auth/references/workflows/build-auth.md +212 -0
- package/skills/egbe-os-product-auth/references/workflows/google.md +34 -0
- package/skills/egbe-os-product-auth/references/workflows/passwordless-email.md +65 -0
- package/skills/egbe-os-product-build/SKILL.md +111 -0
- package/skills/egbe-os-product-build/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-build/references/capabilities.md +25 -0
- package/skills/egbe-os-product-build/references/engineering.md +72 -0
- package/skills/egbe-os-product-build/references/execution.md +55 -0
- package/skills/egbe-os-product-build/references/foundations.md +93 -0
- package/skills/egbe-os-product-build/references/interface-quality.md +32 -0
- package/skills/egbe-os-product-build/references/workflows/private-review-handoff.md +86 -0
- package/skills/egbe-os-product-build/scripts/scaffold.py +296 -0
- package/skills/egbe-os-product-demo-video/SKILL.md +118 -0
- package/skills/egbe-os-product-demo-video/references/recording.md +32 -0
- package/skills/egbe-os-product-market-research/SKILL.md +159 -0
- package/skills/egbe-os-product-market-research/agents/openai.yaml +4 -0
- package/skills/egbe-os-product-market-research/references/catalog.v1.json +177 -0
- package/skills/egbe-os-product-market-research/references/config/channel-footprint-sources.v1.json +99 -0
- package/skills/egbe-os-product-market-research/references/config/creative-taxonomy.v1.json +367 -0
- package/skills/egbe-os-product-market-research/references/contracts/creative-video.md +75 -0
- package/skills/egbe-os-product-market-research/references/contracts/funnel-teardown.md +235 -0
- package/skills/egbe-os-product-market-research/references/contracts/geography-comparison.md +71 -0
- package/skills/egbe-os-product-market-research/references/contracts/lifecycle-capture.md +119 -0
- package/skills/egbe-os-product-market-research/references/contracts/research-artifacts.md +520 -0
- package/skills/egbe-os-product-market-research/references/contracts/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.md +137 -0
- package/skills/egbe-os-product-market-research/references/prompts/acquisition-channels.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.md +118 -0
- package/skills/egbe-os-product-market-research/references/prompts/competitive-landscape.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.md +154 -0
- package/skills/egbe-os-product-market-research/references/prompts/demand-validation.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.md +100 -0
- package/skills/egbe-os-product-market-research/references/prompts/market-size-and-dynamics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.md +126 -0
- package/skills/egbe-os-product-market-research/references/prompts/pricing-and-monetization.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.md +98 -0
- package/skills/egbe-os-product-market-research/references/prompts/target-audience.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.md +217 -0
- package/skills/egbe-os-product-market-research/references/prompts/unit-economics.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.md +113 -0
- package/skills/egbe-os-product-market-research/references/prompts/value-proposition.user.md +4 -0
- package/skills/egbe-os-product-market-research/references/workflows/acquisition-channels.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/channel-footprint.md +163 -0
- package/skills/egbe-os-product-market-research/references/workflows/community-demand.md +100 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitive-landscape.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-ads.md +82 -0
- package/skills/egbe-os-product-market-research/references/workflows/competitor-set.md +300 -0
- package/skills/egbe-os-product-market-research/references/workflows/creative-patterns.md +228 -0
- package/skills/egbe-os-product-market-research/references/workflows/demand-validation.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/fleet-prior.md +80 -0
- package/skills/egbe-os-product-market-research/references/workflows/funnel-teardown.md +184 -0
- package/skills/egbe-os-product-market-research/references/workflows/geography-comparison.md +84 -0
- package/skills/egbe-os-product-market-research/references/workflows/keyword-economics.md +122 -0
- package/skills/egbe-os-product-market-research/references/workflows/lifecycle-capture.md +218 -0
- package/skills/egbe-os-product-market-research/references/workflows/local-research.md +55 -0
- package/skills/egbe-os-product-market-research/references/workflows/market-size-and-dynamics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/preview.md +175 -0
- package/skills/egbe-os-product-market-research/references/workflows/pricing-and-monetization.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/recommendations.md +35 -0
- package/skills/egbe-os-product-market-research/references/workflows/review-mining.md +76 -0
- package/skills/egbe-os-product-market-research/references/workflows/target-audience.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/tiktok-reels-market-trends.md +46 -0
- package/skills/egbe-os-product-market-research/references/workflows/unit-economics.md +27 -0
- package/skills/egbe-os-product-market-research/references/workflows/value-proposition.md +27 -0
- package/skills/egbe-os-product-market-research/scripts/build-organic-trend-context.py +167 -0
- package/skills/egbe-os-product-market-research/scripts/build-preview-context.py +91 -0
- package/skills/egbe-os-product-market-research/scripts/build-research-query.py +225 -0
- package/skills/egbe-os-product-market-research/scripts/channel-footprint-model.py +294 -0
- package/skills/egbe-os-product-market-research/scripts/connection_identity.py +22 -0
- package/skills/egbe-os-product-market-research/scripts/creative-model.py +364 -0
- package/skills/egbe-os-product-market-research/scripts/creative-selection.py +113 -0
- package/skills/egbe-os-product-market-research/scripts/creative-semantics.py +365 -0
- package/skills/egbe-os-product-market-research/scripts/creative-video.py +542 -0
- package/skills/egbe-os-product-market-research/scripts/egbe_artifacts.py +24 -0
- package/skills/egbe-os-product-market-research/scripts/finalize-organic-trend-watch.py +304 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-email-review.py +97 -0
- package/skills/egbe-os-product-market-research/scripts/funnel-model.py +966 -0
- package/skills/egbe-os-product-market-research/scripts/funnel_features.py +50 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison-contract.py +172 -0
- package/skills/egbe-os-product-market-research/scripts/geography-comparison.py +169 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-forecast.py +61 -0
- package/skills/egbe-os-product-market-research/scripts/keyword-locale-publication.py +136 -0
- package/skills/egbe-os-product-market-research/scripts/lifecycle-start.py +190 -0
- package/skills/egbe-os-product-market-research/scripts/persist-research-report.py +63 -0
- package/skills/egbe-os-product-market-research/scripts/research-artifact-io.py +281 -0
- package/skills/egbe-os-product-market-research/scripts/research-evidence.py +496 -0
- package/skills/egbe-os-product-market-research/scripts/research-policy.py +33 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-runtime.py +343 -0
- package/skills/egbe-os-product-market-research/scripts/research-section-workflow.py +288 -0
- package/skills/egbe-os-product-market-research/scripts/research_integrity.py +122 -0
- package/skills/egbe-os-product-market-research/scripts/review-research-completion.py +306 -0
- package/skills/egbe-os-product-market-research/scripts/run-acquisition-channels.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-channel-footprint.py +2258 -0
- package/skills/egbe-os-product-market-research/scripts/run-community-demand.py +1603 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitive-landscape.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-ads.py +1156 -0
- package/skills/egbe-os-product-market-research/scripts/run-competitor-set.py +2514 -0
- package/skills/egbe-os-product-market-research/scripts/run-creative-patterns.py +2042 -0
- package/skills/egbe-os-product-market-research/scripts/run-demand-validation.py +72 -0
- package/skills/egbe-os-product-market-research/scripts/run-fleet-prior.py +652 -0
- package/skills/egbe-os-product-market-research/scripts/run-funnel-teardown.py +493 -0
- package/skills/egbe-os-product-market-research/scripts/run-keyword-economics.py +1443 -0
- package/skills/egbe-os-product-market-research/scripts/run-lifecycle-capture.py +1543 -0
- package/skills/egbe-os-product-market-research/scripts/run-market-size-and-dynamics.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-os-research.py +311 -0
- package/skills/egbe-os-product-market-research/scripts/run-pricing-and-monetization.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-review-mining.py +1051 -0
- package/skills/egbe-os-product-market-research/scripts/run-target-audience.py +66 -0
- package/skills/egbe-os-product-market-research/scripts/run-unit-economics.py +71 -0
- package/skills/egbe-os-product-market-research/scripts/run-value-proposition.py +67 -0
- package/skills/egbe-os-product-market-research/scripts/upsert-markdown-section.py +156 -0
- package/skills/egbe-os-product-market-research/scripts/walk-funnels.py +249 -0
- package/skills/egbe-os-product-market-research/scripts/write-preview.py +710 -0
- package/skills/egbe-os-product-market-research/scripts/write-recommendations.py +272 -0
- package/skills/egbe-os-product-report/SKILL.md +150 -0
- package/skills/egbe-os-product-report/references/artifacts.md +84 -0
- package/skills/egbe-os-product-report/references/brief.md +34 -0
- package/skills/egbe-os-product-report/references/daily.md +76 -0
- package/skills/egbe-os-product-report/references/sources.md +68 -0
- package/skills/egbe-os-product-routines/SKILL.md +166 -0
- package/skills/egbe-os-product-routines/references/catalog.md +22 -0
- package/skills/egbe-os-product-routines/references/continuation-check.md +41 -0
- package/skills/egbe-os-product-routines/references/product-reporting.md +163 -0
- package/skills/egbe-os-product-routines/references/run-preset.md +32 -0
- package/skills/egbe-os-quickstart/scripts/egbe-curl.py +357 -0
- package/skills/egbe-os-quiz-funnel/SKILL.md +152 -0
- package/skills/egbe-os-quiz-funnel/agents/openai.yaml +4 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.d.mts +224 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.mjs +652 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-engine.test.mjs +764 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.d.mts +31 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.mjs +87 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-history.test.mjs +265 -0
- package/skills/egbe-os-quiz-funnel/assets/engine/quiz-reference.test.mjs +254 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/QUIZ.md +195 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.json +421 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/quiz.public.json +369 -0
- package/skills/egbe-os-quiz-funnel/assets/examples/egbe-docs/product/quizzes/books-checkup/validation.json +21 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/index.html +26 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-bootstrap.js +31 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-early-actions.mjs +11 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-first-screen.mjs +32 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz-page.mjs +480 -0
- package/skills/egbe-os-quiz-funnel/assets/reference/quiz.css +264 -0
- package/skills/egbe-os-quiz-funnel/references/competitor-teardown.md +159 -0
- package/skills/egbe-os-quiz-funnel/references/conversion-handoff.md +156 -0
- package/skills/egbe-os-quiz-funnel/references/implementation.md +207 -0
- package/skills/egbe-os-quiz-funnel/references/inputs.md +37 -0
- package/skills/egbe-os-quiz-funnel/references/measurement.md +122 -0
- package/skills/egbe-os-quiz-funnel/references/spec-contract.md +335 -0
- package/skills/egbe-os-quiz-funnel/references/verification.md +101 -0
- package/skills/egbe-os-quiz-funnel/references/walk-mechanics.v2.json +18 -0
- package/skills/egbe-os-quiz-funnel/scripts/compile-quiz-spec.py +1869 -0
- package/skills/egbe-os-quiz-funnel/scripts/prepare-research-identity.py +66 -0
- package/skills/egbe-os-reddit-ads/SKILL.md +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/schema.json +41 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/bold-statement/template.html +106 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/schema.json +61 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/data-proof/template.html +151 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/schema.json +91 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/honest-breakdown/template.html +185 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/schema.json +51 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/question-hook/template.html +121 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/schema.json +87 -0
- package/skills/egbe-os-reddit-ads/assets/static-banners/reddit-post-style/template.html +212 -0
- package/skills/egbe-os-reddit-ads/references/creative/html-to-png-pipeline.md +123 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-qa.md +12 -0
- package/skills/egbe-os-reddit-ads/references/creative/static-banner-system.md +16 -0
- package/skills/egbe-os-reddit-ads/references/destination-requirements.md +36 -0
- package/skills/egbe-os-reddit-ads/references/runtime/api-reference.md +435 -0
- package/skills/egbe-os-reddit-ads/references/runtime/artifacts.md +57 -0
- package/skills/egbe-os-reddit-ads/references/runtime/monitoring.md +64 -0
- package/skills/egbe-os-reddit-ads/references/runtime/pixel-and-tracking.md +49 -0
- package/skills/egbe-os-reddit-ads/references/runtime/policies.md +19 -0
- package/skills/egbe-os-reddit-ads/references/runtime/shared-analytics-attribution.md +14 -0
- package/skills/egbe-os-reddit-ads/references/workflows/build-paused.md +35 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch-ready.md +19 -0
- package/skills/egbe-os-reddit-ads/references/workflows/launch.md +32 -0
- package/skills/egbe-os-reddit-ads/references/workflows/readiness.md +9 -0
- package/skills/egbe-os-reddit-ads/scripts/capture-ad.sh +178 -0
- package/skills/egbe-os-reddit-ads/scripts/validate-reddit-artifacts.py +187 -0
- package/skills/egbe-os-report-ui/SKILL.md +133 -0
- package/skills/egbe-os-report-ui/assets/egbe-wordmark.svg +9 -0
- package/skills/egbe-os-report-ui/assets/examples/components.html +417 -0
- package/skills/egbe-os-report-ui/assets/examples/editorial.html +209 -0
- package/skills/egbe-os-report-ui/assets/scaffold.html +179 -0
- package/skills/egbe-os-report-ui/references/components.md +209 -0
- package/skills/egbe-os-research/SKILL.md +125 -0
- package/skills/egbe-os-saas-unit-economics/SKILL.md +188 -0
- package/skills/egbe-os-scrape/SKILL.md +160 -0
- package/skills/egbe-os-search/SKILL.md +182 -0
- package/skills/egbe-os-search/references/google-places.md +81 -0
- package/skills/egbe-os-support/SKILL.md +149 -0
- package/skills/egbe-os-telemetry/SKILL.md +344 -0
- package/skills/egbe-os-telemetry/references/harnesses/claude-code.md +97 -0
- package/skills/egbe-os-telemetry/references/harnesses/codex.md +22 -0
- package/skills/egbe-os-telemetry/references/harnesses/hermes.md +39 -0
- package/skills/egbe-os-telemetry/references/harnesses/openclaw.md +139 -0
- package/skills/egbe-os-telemetry/references/harnesses/opencode.md +28 -0
- package/skills/egbe-os-tools/SKILL.md +180 -0
- package/skills/egbe-os-tools/references/theona.md +26 -0
- package/skills/egbe-os-wallet/SKILL.md +181 -0
- package/skills/egbe-setup/EGBE.md +484 -0
- package/skills/egbe-setup/SKILL.md +116 -0
- package/skills/egbe-setup/references/project.md +80 -0
- package/state.js +37 -0
- 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
|
+
});
|