@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,294 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Pure, scoped normalization and decisions for Channel Footprint v2.
|
|
3
|
+
|
|
4
|
+
Dates describe delivery only when the provider supplies native delivery
|
|
5
|
+
scope. Listing observations never supply delivery duration.
|
|
6
|
+
"""
|
|
7
|
+
from __future__ import annotations
|
|
8
|
+
|
|
9
|
+
import sys as _artifact_sys
|
|
10
|
+
from pathlib import Path as _ArtifactPath
|
|
11
|
+
_artifact_sys.path.insert(0, str(_ArtifactPath(__file__).resolve().parent))
|
|
12
|
+
from egbe_artifacts import artifact_path as _artifact_path
|
|
13
|
+
import hashlib
|
|
14
|
+
import json
|
|
15
|
+
from datetime import date, timedelta
|
|
16
|
+
from typing import Any
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def digest(value: Any) -> str:
|
|
20
|
+
return hashlib.sha256(json.dumps(value, sort_keys=True, separators=(",", ":"), ensure_ascii=False).encode()).hexdigest()
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def countries(values: Any) -> list[str]:
|
|
24
|
+
if isinstance(values, str):
|
|
25
|
+
values = values.replace(";", ",").split(",")
|
|
26
|
+
result = []
|
|
27
|
+
aliases = {"UK": "GB", "UNITED KINGDOM": "GB", "UNITED STATES": "US", "GERMANY": "DE", "FRANCE": "FR", "CANADA": "CA", "AUSTRALIA": "AU"}
|
|
28
|
+
iso = set("AD AE AF AG AI AL AM AO AQ AR AS AT AU AW AX AZ BA BB BD BE BF BG BH BI BJ BL BM BN BO BQ BR BS BT BV BW BY BZ CA CC CD CF CG CH CI CK CL CM CN CO CR CU CV CW CX CY CZ DE DJ DK DM DO DZ EC EE EG EH ER ES ET FI FJ FK FM FO FR GA GB GD GE GF GG GH GI GL GM GN GP GQ GR GS GT GU GW GY HK HM HN HR HT HU ID IE IL IM IN IO IQ IR IS IT JE JM JO JP KE KG KH KI KM KN KP KR KW KY KZ LA LB LC LI LK LR LS LT LU LV LY MA MC MD ME MF MG MH MK ML MM MN MO MP MQ MR MS MT MU MV MW MX MY MZ NA NC NE NF NG NI NL NO NP NR NU NZ OM PA PE PF PG PH PK PL PM PN PR PS PT PW PY QA RE RO RS RU RW SA SB SC SD SE SG SH SI SJ SK SL SM SN SO SR SS ST SV SX SY SZ TC TD TF TG TH TJ TK TL TM TN TO TR TT TV TW TZ UA UG UM US UY UZ VA VC VE VG VI VN VU WF WS YE YT ZA ZM ZW".split())
|
|
29
|
+
for value in values or []:
|
|
30
|
+
code = aliases.get(str(value).strip().upper(), str(value).strip().upper())
|
|
31
|
+
if code in {"EU", "EUROPE", "EEA"}:
|
|
32
|
+
raise ValueError("EU/EEA requires an explicit country list in intake; no proxy country is chosen")
|
|
33
|
+
if code not in iso:
|
|
34
|
+
raise ValueError(f"country must be an ISO alpha-2 code: {value}")
|
|
35
|
+
if code not in result:
|
|
36
|
+
result.append(code)
|
|
37
|
+
return result
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
def days(start, end):
|
|
41
|
+
try:
|
|
42
|
+
return max(0, (date.fromisoformat(str(end)[:10]) - date.fromisoformat(str(start)[:10])).days)
|
|
43
|
+
except (ValueError, TypeError):
|
|
44
|
+
return None
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
def valid_date(value):
|
|
48
|
+
try:
|
|
49
|
+
return date.fromisoformat(str(value)[:10]).isoformat()
|
|
50
|
+
except (ValueError, TypeError):
|
|
51
|
+
return None
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
def text_value(value):
|
|
55
|
+
if isinstance(value, dict):
|
|
56
|
+
return str(value.get("text") or value.get("value") or "")
|
|
57
|
+
if isinstance(value, list):
|
|
58
|
+
return "\n".join(text_value(x) for x in value if x)
|
|
59
|
+
return str(value or "")
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
def ad_fields(raw):
|
|
63
|
+
snapshot = raw.get("snapshot") if isinstance(raw.get("snapshot"), dict) else {}
|
|
64
|
+
cards = snapshot.get("cards") or []
|
|
65
|
+
card = cards[0] if cards and isinstance(cards[0], dict) else {}
|
|
66
|
+
images = snapshot.get("images") or []
|
|
67
|
+
videos = snapshot.get("videos") or []
|
|
68
|
+
image = images[0] if images and isinstance(images[0], dict) else {}
|
|
69
|
+
video = videos[0] if videos and isinstance(videos[0], dict) else {}
|
|
70
|
+
return {
|
|
71
|
+
"native_ad_id": str(raw.get("ad_archive_id") or raw.get("creativeId") or raw.get("adId") or raw.get("ad_id") or raw.get("id") or ""),
|
|
72
|
+
"advertiser": text_value(raw.get("advertiserName") or raw.get("advertiser_name") or raw.get("page_name") or raw.get("pageName")),
|
|
73
|
+
"landing_url": text_value(raw.get("destinationUrl") or raw.get("destination_url") or raw.get("landingUrl") or raw.get("landing_url") or raw.get("destination") or raw.get("clickUrl") or snapshot.get("link_url") or card.get("link_url") or raw.get("ad_creative_link_captions")),
|
|
74
|
+
"source_url": text_value(raw.get("adUrl") or raw.get("ad_url") or raw.get("url") or raw.get("ad_snapshot_url")),
|
|
75
|
+
"ad_text": text_value(raw.get("adText") or raw.get("text") or raw.get("ad_text") or raw.get("creativeText") or raw.get("ad_creative_bodies") or snapshot.get("body") or card.get("body") or snapshot.get("title") or raw.get("title")),
|
|
76
|
+
"image_url": text_value(raw.get("imageUrl") or raw.get("image_url") or image.get("original_image_url") or image.get("resized_image_url") or video.get("video_preview_image_url") or card.get("original_image_url") or card.get("resized_image_url")),
|
|
77
|
+
"video_url": text_value(raw.get("videoUrl") or raw.get("video_url") or video.get("video_hd_url") or video.get("video_sd_url")),
|
|
78
|
+
"cta": text_value(raw.get("cta") or snapshot.get("cta_text") or card.get("cta_text") or snapshot.get("cta_type")),
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
def observation(ad, source, country, market_scope, today, policy, date_scope="global", activity_scope="global"):
|
|
83
|
+
# Only an explicit native delivery scope can narrow global provider dates.
|
|
84
|
+
raw = ad.get("raw") or {}
|
|
85
|
+
native_scope = raw.get("native_date_scope") or raw.get("date_scope")
|
|
86
|
+
native_country = raw.get("delivery_country") or raw.get("date_country")
|
|
87
|
+
if native_scope == "country" and native_country:
|
|
88
|
+
date_scope, date_country = "country", str(native_country).upper().replace("UK", "GB")
|
|
89
|
+
else:
|
|
90
|
+
date_country = country if date_scope == "country" else None
|
|
91
|
+
first, last = valid_date(ad.get("first_seen")), valid_date(ad.get("last_seen"))
|
|
92
|
+
explicit = ad.get("is_active")
|
|
93
|
+
listing = source in {"linkedin_library_actor", "reddit_inspiration_actor"}
|
|
94
|
+
if listing:
|
|
95
|
+
first_shown = last_shown = None
|
|
96
|
+
status = "unknown"
|
|
97
|
+
else:
|
|
98
|
+
first_shown, last_shown = first, last
|
|
99
|
+
stop_value = raw.get("end_date") or raw.get("endDate") or raw.get("ad_delivery_stop_time")
|
|
100
|
+
stop = valid_date(stop_value) or last if stop_value else None
|
|
101
|
+
# The Meta page-search actor reports the capture day as the end date of
|
|
102
|
+
# an ad that is still active; only an end before capture is a stop.
|
|
103
|
+
# That day is Pacific time, so an explicitly active ad may carry the
|
|
104
|
+
# day before a capture made east of it.
|
|
105
|
+
grace = timedelta(days=1) if explicit is True else timedelta(0)
|
|
106
|
+
ended = bool(stop and date.fromisoformat(stop) < today - grace)
|
|
107
|
+
if explicit is False or ended:
|
|
108
|
+
status = "stopped"
|
|
109
|
+
elif explicit is True:
|
|
110
|
+
status = "active"
|
|
111
|
+
else:
|
|
112
|
+
status = "unknown"
|
|
113
|
+
activity_scope = raw.get("native_activity_scope") or activity_scope
|
|
114
|
+
activity_country = str(raw.get("activity_country") or country or "").upper().replace("UK", "GB") or None
|
|
115
|
+
endpoint = last_shown if last_shown and date.fromisoformat(last_shown) <= today else None
|
|
116
|
+
# A native last-delivery date wins even if an ad is globally active.
|
|
117
|
+
# Extending country duration to capture requires that same country's
|
|
118
|
+
# native active delivery; a global flag cannot extend a country span.
|
|
119
|
+
same_delivery_scope = (date_scope == "global" and activity_scope == "global") or (date_scope == "country" and activity_scope == "country" and date_country == activity_country)
|
|
120
|
+
if endpoint is None and status == "active" and same_delivery_scope:
|
|
121
|
+
endpoint = today.isoformat()
|
|
122
|
+
placement = str(raw.get("placement") or raw.get("platform") or "").lower() or None
|
|
123
|
+
return {
|
|
124
|
+
"source": source, "country": country, "market_scope": market_scope, "observed_on": today.isoformat(), "placement": placement,
|
|
125
|
+
"date_scope": date_scope if not listing else "unknown", "date_country": date_country if not listing else None,
|
|
126
|
+
"activity_scope": activity_scope,
|
|
127
|
+
"activity_country": activity_country,
|
|
128
|
+
"first_shown": first_shown, "last_shown": last_shown, "status": status,
|
|
129
|
+
"first_observed": first if listing and source == "linkedin_library_actor" else today.isoformat(),
|
|
130
|
+
"last_observed": last if listing and source == "linkedin_library_actor" else today.isoformat(),
|
|
131
|
+
"served_days": days(first_shown, endpoint),
|
|
132
|
+
"days_since_last_delivery": days(last_shown, today.isoformat()) if last_shown and last_shown <= today.isoformat() else None,
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
def build_corpus(presences, context_hash, policy):
|
|
137
|
+
corpus = {}
|
|
138
|
+
for presence_index, presence in enumerate(presences):
|
|
139
|
+
refs = []
|
|
140
|
+
for ad_index, ad in enumerate(presence.get("ads") or []):
|
|
141
|
+
fields = ad_fields(ad.get("raw") or {})
|
|
142
|
+
family = "meta" if presence["platform"] == "meta_ads" else presence["platform"]
|
|
143
|
+
native = fields["native_ad_id"]
|
|
144
|
+
# No native id: scope the fingerprint to this observation. Equal
|
|
145
|
+
# copy is not proof that two listings are a single continuous ad.
|
|
146
|
+
identity = (family, presence["domain"], native) if native else (family, presence["domain"], fields, presence["source"], presence.get("country"), ad.get("first_seen"))
|
|
147
|
+
ad_id = family + ":" + digest(identity)[:24]
|
|
148
|
+
refs.append(ad_id)
|
|
149
|
+
obs = observation(ad, presence["source"], presence.get("country"), presence["market_scope"], date.fromisoformat(presence["observed_on"]), policy, presence.get("native_date_scope", "global"), presence.get("native_activity_scope", "global"))
|
|
150
|
+
item = corpus.setdefault(ad_id, {"type": "channel_ad", "ad_id": ad_id, "domain": presence["domain"], "platform": presence["platform"], "format": str(ad.get("format") or "unknown").lower(), **fields, "identity_method": "native_id" if native else "observation_fingerprint", "observations": [], "provider_observation_refs": [], "relevance": "unknown", "relevance_reason": "awaiting a context-bound relevance decision", "product_context_sha256": context_hash})
|
|
151
|
+
item["provider_observation_refs"].append(_artifact_path(f"egbe-docs/research/market/work/channel_footprint/collected.json#/raw/presences/{presence_index}/ads/{ad_index}"))
|
|
152
|
+
for key, value in fields.items():
|
|
153
|
+
if value and not item.get(key):
|
|
154
|
+
item[key] = value
|
|
155
|
+
if obs not in item["observations"]:
|
|
156
|
+
item["observations"].append(obs)
|
|
157
|
+
# Placements belong to each native observation, not the ad's
|
|
158
|
+
# identity across all countries and provider results.
|
|
159
|
+
placements = {o["placement"] for o in item["observations"] if o.get("placement")}
|
|
160
|
+
item["placements"] = sorted(placements)
|
|
161
|
+
item["placement"] = next(iter(placements)) if len(placements) == 1 else None
|
|
162
|
+
presence["ad_ids"] = sorted(set(refs))
|
|
163
|
+
for item in corpus.values():
|
|
164
|
+
item["candidate_sha256"] = digest({k: item[k] for k in ("ad_id", "domain", "platform", "format", "advertiser", "landing_url", "source_url", "ad_text", "image_url", "cta", "product_context_sha256")})
|
|
165
|
+
return sorted(corpus.values(), key=lambda x: x["ad_id"])
|
|
166
|
+
|
|
167
|
+
|
|
168
|
+
def apply_decisions(corpus, decisions, context_hash, stale="raise"):
|
|
169
|
+
# A sample expansion can fill empty fields of an ad decided earlier, so
|
|
170
|
+
# one ad has two candidate hashes within a collect. `stale` sets what a
|
|
171
|
+
# decision for the other version does: "raise" (finalize), "accept" by
|
|
172
|
+
# ad_id (pre-expansion gate) or "pending" (the ad goes back to review).
|
|
173
|
+
if stale not in {"raise", "accept", "pending"}:
|
|
174
|
+
raise ValueError(f"unknown stale decision mode: {stale}")
|
|
175
|
+
if decisions and decisions.get("product_context_sha256") != context_hash:
|
|
176
|
+
raise ValueError("relevance decisions belong to a different product/intake context")
|
|
177
|
+
entries = decisions.get("decisions", []) if decisions else []
|
|
178
|
+
if not isinstance(entries, list):
|
|
179
|
+
raise ValueError("relevance decisions must be an array")
|
|
180
|
+
by_id = {}
|
|
181
|
+
for decision in entries:
|
|
182
|
+
ad_id = decision.get("ad_id")
|
|
183
|
+
if ad_id in by_id:
|
|
184
|
+
raise ValueError(f"duplicate relevance decision: {ad_id}")
|
|
185
|
+
by_id[ad_id] = decision
|
|
186
|
+
pending = []
|
|
187
|
+
for ad in corpus:
|
|
188
|
+
decision = by_id.get(ad["ad_id"])
|
|
189
|
+
if decision is None:
|
|
190
|
+
pending.append(ad["ad_id"])
|
|
191
|
+
continue
|
|
192
|
+
if decision.get("candidate_sha256") != ad["candidate_sha256"]:
|
|
193
|
+
if stale == "raise":
|
|
194
|
+
raise ValueError(f"stale relevance decision for {ad['ad_id']}")
|
|
195
|
+
if stale == "pending":
|
|
196
|
+
ad["relevance_reason"] = "the ad changed after its relevance decision; review this version again"
|
|
197
|
+
pending.append(ad["ad_id"])
|
|
198
|
+
continue
|
|
199
|
+
value = decision.get("relevance")
|
|
200
|
+
reason = str(decision.get("reason") or "").strip()
|
|
201
|
+
refs = decision.get("evidence_refs")
|
|
202
|
+
if value not in {"relevant", "irrelevant", "unknown"} or not reason or not isinstance(refs, list) or any(not isinstance(ref, str) or not ref.strip() for ref in refs) or (value != "unknown" and not refs):
|
|
203
|
+
raise ValueError(f"invalid relevance decision for {ad['ad_id']}: require relevance, reason and evidence_refs")
|
|
204
|
+
ad.update(relevance=value, relevance_reason=reason, relevance_evidence_refs=refs, relevance_decision_sha256=digest(decision))
|
|
205
|
+
return pending
|
|
206
|
+
|
|
207
|
+
|
|
208
|
+
def summarize_presences(presences, corpus, competitor_context, policy, context_hash, placement_filter=None):
|
|
209
|
+
by_id = {a["ad_id"]: a for a in corpus}
|
|
210
|
+
# Merge provider observations into one competitor/channel/country row.
|
|
211
|
+
grouped = {}
|
|
212
|
+
for raw in presences:
|
|
213
|
+
key = (raw["domain"], raw["platform"], raw.get("country"))
|
|
214
|
+
row = grouped.setdefault(key, {**{k: v for k, v in raw.items() if k != "ads"}, "ad_ids": [], "sources": [], "sampling": []})
|
|
215
|
+
row["ad_ids"] = sorted(set(row["ad_ids"] + raw.get("ad_ids", [])))
|
|
216
|
+
if raw["source"] not in row["sources"]:
|
|
217
|
+
row["sources"].append(raw["source"])
|
|
218
|
+
row["sampling"].append(raw.get("sampling") or {})
|
|
219
|
+
result = []
|
|
220
|
+
for row in grouped.values():
|
|
221
|
+
country = row.get("country")
|
|
222
|
+
selected = [by_id[x] for x in row["ad_ids"] if x in by_id and by_id[x]["relevance"] == "relevant" and (not placement_filter or any(o.get("country") == country and o.get("placement") == placement_filter for o in by_id[x]["observations"]))]
|
|
223
|
+
current, historical, statuses = set(), set(), []
|
|
224
|
+
max_duration, country_duration, formats, relevant_observed, scopes = None, None, {}, [], set()
|
|
225
|
+
active, activity_scopes = set(), set()
|
|
226
|
+
for ad in selected:
|
|
227
|
+
matching = [o for o in ad["observations"] if o.get("country") == country and (not placement_filter or o.get("placement") == placement_filter)]
|
|
228
|
+
local_current, local_historical = [], []
|
|
229
|
+
for obs in matching:
|
|
230
|
+
statuses.append(obs["status"])
|
|
231
|
+
activity_scopes.add(obs["activity_scope"])
|
|
232
|
+
if obs["status"] == "active":
|
|
233
|
+
active.add(ad["ad_id"])
|
|
234
|
+
# Current use is activity observed in this country's query
|
|
235
|
+
# (or native country delivery); global ad-level dates are accepted.
|
|
236
|
+
if country and obs.get("activity_country") == country and (obs["status"] == "active" or obs["date_scope"] == "global" or (obs["date_scope"] == "country" and obs["date_country"] == country)):
|
|
237
|
+
local_current.append(obs)
|
|
238
|
+
duration = obs.get("served_days")
|
|
239
|
+
if duration is not None:
|
|
240
|
+
max_duration = duration if max_duration is None else max(max_duration, duration)
|
|
241
|
+
scopes.add(obs["date_scope"])
|
|
242
|
+
if obs["date_scope"] == "country" and obs["date_country"] == country:
|
|
243
|
+
country_duration = duration if country_duration is None else max(country_duration, duration)
|
|
244
|
+
# A native delivery span counts with global or this country's dates;
|
|
245
|
+
# listing history (date scope unknown) never supplies a duration.
|
|
246
|
+
if country and (obs["date_scope"] == "global" or (obs["date_scope"] == "country" and obs["date_country"] == country)) and duration is not None:
|
|
247
|
+
local_historical.append(obs)
|
|
248
|
+
# Conflicting current statuses for the same market fail closed.
|
|
249
|
+
if any(o["status"] == "stopped" for o in matching) and any(o["status"] in {"active", "recent"} for o in matching):
|
|
250
|
+
local_current = []
|
|
251
|
+
if local_current:
|
|
252
|
+
current.add(ad["ad_id"])
|
|
253
|
+
if local_historical:
|
|
254
|
+
historical.add(ad["ad_id"])
|
|
255
|
+
if any(o["status"] != "stopped" for o in matching):
|
|
256
|
+
relevant_observed.append(ad["ad_id"])
|
|
257
|
+
formats[ad["format"]] = formats.get(ad["format"], 0) + 1
|
|
258
|
+
tier = (competitor_context.get(row["domain"]) or {}).get("competitor_tier", "unknown")
|
|
259
|
+
row.update(competitor_tier=tier, product_context_sha256=context_hash, policy=policy, policy_sha256=digest(policy),
|
|
260
|
+
matched_ads=len(row["ad_ids"]), relevant_ads=len(selected), active_ads=len(active), formats=formats,
|
|
261
|
+
oldest_days=max_duration, max_observed_duration_days=max_duration, max_country_duration_days=country_duration,
|
|
262
|
+
activity_scopes=sorted(activity_scopes), placement=placement_filter,
|
|
263
|
+
current_ad_ids=sorted(current), historical_ad_ids=sorted(historical), relevant_ad_ids=[a["ad_id"] for a in selected],
|
|
264
|
+
observed_ad_ids=sorted(relevant_observed), current_presence=bool(current), native_duration_available=bool(historical),
|
|
265
|
+
present=bool(relevant_observed), relevance="relevant" if selected else "unknown",
|
|
266
|
+
relevance_reason="context-bound ad decisions" if selected else "no comparable ads confirmed in the available sample",
|
|
267
|
+
duration_scope=next(iter(scopes)) if len(scopes) == 1 else ("mixed" if scopes else "unknown"), target_country=country,
|
|
268
|
+
status="observed" if selected else "not_verifiable",
|
|
269
|
+
evidence_refs=sorted(a["ad_id"] for a in selected),
|
|
270
|
+
unknown_relevance_ads=sum(by_id[x]["relevance"] == "unknown" for x in row["ad_ids"] if x in by_id),
|
|
271
|
+
stopped_ads=sum(any(o["status"] == "stopped" for o in a["observations"] if o.get("country") == country) for a in selected),
|
|
272
|
+
unknown_activity_ads=sum(all(o["status"] == "unknown" for o in a["observations"] if o.get("country") == country) for a in selected),
|
|
273
|
+
activity_known=bool(active) or bool(statuses and all(s == "stopped" for s in statuses)))
|
|
274
|
+
result.append(row)
|
|
275
|
+
return result
|
|
276
|
+
|
|
277
|
+
|
|
278
|
+
def country_rows(presences, scans, target_countries, competitor_context, policy, channels):
|
|
279
|
+
"""Summarize scoped observations without eligibility or channel selection."""
|
|
280
|
+
result = []
|
|
281
|
+
for channel in channels:
|
|
282
|
+
for country in target_countries:
|
|
283
|
+
matched = [r for r in presences if r["platform"] == channel and r.get("country") == country]
|
|
284
|
+
roles = {role: sorted({r["domain"] for r in matched if r["competitor_tier"] == role and r["relevant_ads"]})
|
|
285
|
+
for role in ("direct", "indirect", "substitute", "unknown")}
|
|
286
|
+
signals = sorted({s["domain"] for s in scans if channel in s.get("channels_detected", [])})
|
|
287
|
+
result.append({"type": "channel_country", "platform": channel, "channel": channel, "country": country,
|
|
288
|
+
"observed_domains_by_role": roles,
|
|
289
|
+
"active_domains": sorted({r["domain"] for r in matched if r["current_presence"]}),
|
|
290
|
+
"evidence_refs": sorted({ref for r in matched for ref in r["evidence_refs"]}),
|
|
291
|
+
"status": "observed" if any(roles.values()) else "not_verifiable",
|
|
292
|
+
"signal_domains": signals, "signal_scope": "domain_global_or_unknown",
|
|
293
|
+
"policy": policy, "policy_sha256": digest(policy)})
|
|
294
|
+
return result
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
"""Load opt-in identity from this catalog's shared project-local request helper."""
|
|
2
|
+
import importlib.util
|
|
3
|
+
from functools import lru_cache
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
@lru_cache(maxsize=1)
|
|
8
|
+
def _helper():
|
|
9
|
+
root = Path(__file__).resolve().parents[1]
|
|
10
|
+
quickstart = "egbe-os-quickstart" if root.name.startswith("egbe-os-") else "quickstart"
|
|
11
|
+
path = root.parent / quickstart / "scripts/egbe-curl.py"
|
|
12
|
+
if not path.is_file():
|
|
13
|
+
return None
|
|
14
|
+
spec = importlib.util.spec_from_file_location("egbe_connection_request", path)
|
|
15
|
+
module = importlib.util.module_from_spec(spec)
|
|
16
|
+
spec.loader.exec_module(module)
|
|
17
|
+
return module
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
def connection_headers(url):
|
|
21
|
+
helper = _helper()
|
|
22
|
+
return helper.connection_headers(url) if helper else {}
|