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