@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,364 @@
|
|
|
1
|
+
"""Individual ad records, scoped pattern proof and faithful report projections."""
|
|
2
|
+
from __future__ import annotations
|
|
3
|
+
|
|
4
|
+
import sys as _artifact_sys
|
|
5
|
+
from pathlib import Path as _ArtifactPath
|
|
6
|
+
_artifact_sys.path.insert(0, str(_ArtifactPath(__file__).resolve().parent))
|
|
7
|
+
from egbe_artifacts import artifact_path as _artifact_path
|
|
8
|
+
|
|
9
|
+
import hashlib
|
|
10
|
+
import importlib.util
|
|
11
|
+
from pathlib import Path
|
|
12
|
+
import html
|
|
13
|
+
import json
|
|
14
|
+
import posixpath
|
|
15
|
+
import re
|
|
16
|
+
import urllib.parse
|
|
17
|
+
from collections import defaultdict
|
|
18
|
+
from typing import Any
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
_spec = importlib.util.spec_from_file_location("pmr_creative_selection", Path(__file__).with_name("creative-selection.py"))
|
|
22
|
+
SELECTION = importlib.util.module_from_spec(_spec)
|
|
23
|
+
_spec.loader.exec_module(SELECTION)
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
def digest(value: Any) -> str:
|
|
27
|
+
return hashlib.sha256(json.dumps(value, sort_keys=True, ensure_ascii=False).encode()).hexdigest()[:20]
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
def creative_type(row: dict) -> str:
|
|
31
|
+
form = row.get('format_kind')
|
|
32
|
+
if form == 'text_only':
|
|
33
|
+
return 'text'
|
|
34
|
+
if form == 'video':
|
|
35
|
+
return 'video'
|
|
36
|
+
if form in {'static_image', 'carousel', 'dynamic', 'meme'}:
|
|
37
|
+
return 'static_image'
|
|
38
|
+
return 'unknown'
|
|
39
|
+
|
|
40
|
+
|
|
41
|
+
def duration_proven(row: dict, days=None) -> bool:
|
|
42
|
+
"""Whether a native, scoped delivery duration is actually available."""
|
|
43
|
+
value = row.get("served_days")
|
|
44
|
+
return (type(value) is int and value >= 0 and row.get("age_basis") == "platform_dates"
|
|
45
|
+
and bool(row.get("country")) and row.get("duration_scope") in ("country", "global")
|
|
46
|
+
and ("date_scope" not in row or row.get("date_scope") == "global"
|
|
47
|
+
or (row.get("date_scope") == "country" and row.get("date_country") == row["country"])))
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
def status(row: dict, days: int) -> str:
|
|
51
|
+
active = row.get('running_at_capture')
|
|
52
|
+
return 'active' if active is True else 'stopped' if active is False else 'unknown'
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
def individual_ads(rows: list[dict], days: int) -> list[dict]:
|
|
56
|
+
"""One native ad per market and channel, retaining delivery observations."""
|
|
57
|
+
groups: dict[tuple, list[dict]] = defaultdict(list)
|
|
58
|
+
for source in rows:
|
|
59
|
+
row = dict(source)
|
|
60
|
+
row['native_ad_id'] = str(row.get('native_ad_id') or row.get('ad_id') or row['creative_id'])
|
|
61
|
+
key = (row.get('domain'), row.get('platform'), row.get('channel'), row['native_ad_id'], row.get('country'))
|
|
62
|
+
groups[key].append(row)
|
|
63
|
+
|
|
64
|
+
def observed_key(row):
|
|
65
|
+
return (str(row.get('last_observed') or row.get('retrieved_on') or row.get('last_seen') or ''),
|
|
66
|
+
str(row.get('last_seen') or ''), row.get('running_at_capture') is True, digest(row))
|
|
67
|
+
|
|
68
|
+
fields = ('source', 'headline', 'body', 'image_url', 'media_urls', 'video_url', 'first_seen', 'last_seen',
|
|
69
|
+
'served_days', 'running_at_capture', 'age_basis', 'duration_scope', 'country',
|
|
70
|
+
'first_observed', 'last_observed', 'retrieved_on', 'date_scope', 'date_country',
|
|
71
|
+
'activity_scope', 'activity_country', 'native_activity_status', 'placement')
|
|
72
|
+
out = []
|
|
73
|
+
variants: dict[tuple, set] = defaultdict(set)
|
|
74
|
+
variant_keys = {}
|
|
75
|
+
for key, observations in groups.items():
|
|
76
|
+
# A listing or global date cannot overwrite a country delivery record.
|
|
77
|
+
# Choose one coherent native observation; never add durations or borrow
|
|
78
|
+
# activity from another scope to complete its proof.
|
|
79
|
+
scoped = [row for row in observations if row.get('duration_scope') == 'country'
|
|
80
|
+
and row.get('age_basis') == 'platform_dates' and type(row.get('served_days')) is int]
|
|
81
|
+
native = [row for row in observations if row.get('age_basis') == 'platform_dates'
|
|
82
|
+
and row.get('duration_scope') in ('country', 'global')]
|
|
83
|
+
# A qualifying native run is kept even when a shorter country record
|
|
84
|
+
# exists: a qualifying country run first (its dates and activity stay
|
|
85
|
+
# together), otherwise the longest qualifying global run. Spans are
|
|
86
|
+
# never added.
|
|
87
|
+
qualifying = [row for row in native if duration_proven(row, days)]
|
|
88
|
+
if qualifying:
|
|
89
|
+
row = dict(max(qualifying, key=lambda r: (r.get('duration_scope') == 'country', r['served_days'], observed_key(r))))
|
|
90
|
+
else:
|
|
91
|
+
row = dict(max(scoped or native or observations, key=observed_key))
|
|
92
|
+
row['creative_id'] = f"{row.get('platform')}:{row['native_ad_id']}:{row.get('country') or 'unscoped'}:{digest(row.get('domain'))}"
|
|
93
|
+
# Display and search may share Google's native ID in one market.
|
|
94
|
+
# Keep primary-channel IDs stable, distinguishing other placements.
|
|
95
|
+
channel = row.get('channel')
|
|
96
|
+
if channel and channel not in {row.get('platform'), f"{row.get('platform')}_ads"}:
|
|
97
|
+
row['creative_id'] += f":{channel}"
|
|
98
|
+
row['observations'] = []
|
|
99
|
+
row['media_assets'], row['source_members'] = [], []
|
|
100
|
+
for observation in sorted(observations, key=observed_key):
|
|
101
|
+
for version in observation.get('observations') or [{name: observation.get(name) for name in fields}]:
|
|
102
|
+
if version not in row['observations']:
|
|
103
|
+
row['observations'].append(version)
|
|
104
|
+
for name in ('media_assets', 'source_members'):
|
|
105
|
+
for value in observation.get(name) or []:
|
|
106
|
+
if value not in row[name]:
|
|
107
|
+
row[name].append(value)
|
|
108
|
+
# Match the Footprint policy: contradictory country-native activity is
|
|
109
|
+
# unresolved. An active tie-break or activity in another scope cannot
|
|
110
|
+
# turn this ad into current-use proof.
|
|
111
|
+
native_activity = set()
|
|
112
|
+
for observation in observations:
|
|
113
|
+
for version in observation.get('observations') or [observation]:
|
|
114
|
+
if version.get('country') == row.get('country'):
|
|
115
|
+
activity = version.get('native_activity_status') or version.get('activity_status') or version.get('status')
|
|
116
|
+
if activity:
|
|
117
|
+
native_activity.add(activity)
|
|
118
|
+
if native_activity & {'active', 'recent', 'recent_delivery'} and native_activity & {'stopped', 'inactive', 'ended', 'archived'}:
|
|
119
|
+
row['running_at_capture'] = None
|
|
120
|
+
row['activity_status'] = 'mixed'
|
|
121
|
+
row['current_activity_conflict'] = sorted(native_activity)
|
|
122
|
+
row['creative_type'] = creative_type(row)
|
|
123
|
+
row['longevity_status'] = status(row, days)
|
|
124
|
+
row['native_global_duration_available'] = any(
|
|
125
|
+
type(item.get('served_days')) is int and item['served_days'] >= 0
|
|
126
|
+
and item.get('age_basis') == 'platform_dates' and item.get('duration_scope') == 'global'
|
|
127
|
+
for item in observations)
|
|
128
|
+
row['relaunched'], row['fingerprint_span_days'] = False, None
|
|
129
|
+
copy = ' '.join(str(row.get(name) or '') for name in ('headline', 'body')).strip().casefold()
|
|
130
|
+
group = (row.get('domain'), row.get('channel'), row.get('country'), copy or row['creative_id'])
|
|
131
|
+
row['variant_group_id'] = digest(group)
|
|
132
|
+
variant_keys[row['creative_id']] = group
|
|
133
|
+
variants[group].add(row['native_ad_id'])
|
|
134
|
+
out.append(row)
|
|
135
|
+
for row in out:
|
|
136
|
+
row['variants'] = len(variants[variant_keys[row['creative_id']]])
|
|
137
|
+
row['strength_components'] = {'running': row.get('running_at_capture'), 'served_days': row.get('served_days'),
|
|
138
|
+
'duration_scope': row.get('duration_scope'), 'variants': row['variants'],
|
|
139
|
+
'reach': row.get('eu_total_reach'), 'reach_source': row.get('source'),
|
|
140
|
+
'reach_country': row.get('country')}
|
|
141
|
+
return out
|
|
142
|
+
|
|
143
|
+
|
|
144
|
+
def strength_key(row: dict) -> tuple:
|
|
145
|
+
return SELECTION.strength_key(row)
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
def eligible(row: dict) -> bool:
|
|
149
|
+
return SELECTION.eligible(row)
|
|
150
|
+
|
|
151
|
+
|
|
152
|
+
def patterns(creatives: list[dict], labels: list[dict], taxonomy: dict, days: int, dictionary: dict | None = None) -> list[dict]:
|
|
153
|
+
by_id = {row['creative_id']: row for row in creatives}
|
|
154
|
+
dictionary = dictionary or {}
|
|
155
|
+
families = {row['message_family_id']: row for row in dictionary.get('message_families', [])}
|
|
156
|
+
angles = {row['angle_id']: row for row in dictionary.get('angles', [])}
|
|
157
|
+
groups: dict[tuple, list] = defaultdict(list)
|
|
158
|
+
for label in labels:
|
|
159
|
+
row = by_id.get(label.get('creative_id'))
|
|
160
|
+
if not row or not eligible(row) or row.get('creative_type') == 'unknown':
|
|
161
|
+
continue
|
|
162
|
+
scope = (row.get('country'), row['channel'], row['creative_type'], (row.get('format_kind'), row.get('format_detail') or 'unspecified'))
|
|
163
|
+
family = row.get('message_family_id')
|
|
164
|
+
if family:
|
|
165
|
+
groups[scope + ('message_family', family)].append((row, label))
|
|
166
|
+
for angle in row.get('category_angle_ids') or []:
|
|
167
|
+
if not family:
|
|
168
|
+
continue
|
|
169
|
+
# An angle is paired with offer and family, rather than collapsing
|
|
170
|
+
# unrelated offers into a broad buyer or benefit label.
|
|
171
|
+
groups[scope + ('angle', angle, (label.get('labels') or {}).get('offer_kind'), family)].append((row, label))
|
|
172
|
+
results = []
|
|
173
|
+
for key, members in groups.items():
|
|
174
|
+
country, channel, ctype, form, level, identity = key[:6]
|
|
175
|
+
by_domain: dict[str, list] = defaultdict(list)
|
|
176
|
+
for creative, label in members:
|
|
177
|
+
by_domain[creative['domain']].append(creative)
|
|
178
|
+
proving = {domain for domain, items in by_domain.items() if any(duration_proven(c, days) for c in items)}
|
|
179
|
+
running = {domain for domain, items in by_domain.items() if any(c.get('running_at_capture') is True for c in items)}
|
|
180
|
+
stopped = any(c.get('running_at_capture') is False for c, _ in members)
|
|
181
|
+
pattern_status = 'active' if running else 'stopped' if stopped else 'observed'
|
|
182
|
+
definition = families.get(identity, {}) if level == 'message_family' else angles.get(identity, {})
|
|
183
|
+
definition = {k: v for k, v in definition.items() if k not in ('members', 'support')}
|
|
184
|
+
description = definition.get('meaning') or definition.get('label') or identity
|
|
185
|
+
direct = {d for d in by_domain if any(c.get('competitor_tier') == 'direct' for c in by_domain[d])}
|
|
186
|
+
indirect = {d for d in by_domain if any(c.get('competitor_tier') == 'indirect' for c in by_domain[d])}
|
|
187
|
+
lineage = []
|
|
188
|
+
for c, _ in sorted(members, key=lambda m: strength_key(m[0])):
|
|
189
|
+
lineage.append({k: c.get(k) for k in ('creative_id', 'native_ad_id', 'domain', 'country', 'countries',
|
|
190
|
+
'channel', 'competitor_tier', 'relevance', 'duration_scope', 'served_days', 'running_at_capture',
|
|
191
|
+
'first_seen', 'last_seen', 'longevity_status', 'footprint_ad_id', 'source_members')})
|
|
192
|
+
results.append({'type': 'pattern_score', 'pattern_id': digest(key), 'pattern_level': level,
|
|
193
|
+
'pattern_key': {'message_family_id': identity} if level == 'message_family' else {'angle_id': identity, 'offer_kind': key[6], 'message_family_id': key[7]},
|
|
194
|
+
'country': country, 'channel': channel, 'creative_type': ctype, 'format_kind': form[0], 'format_detail': form[1],
|
|
195
|
+
'description': description, 'message_family': definition if level == 'message_family' else {k:v for k,v in families.get(key[7], {}).items() if k not in ('members','support')},
|
|
196
|
+
'angles': [{k:v for k,v in angles[a].items() if k not in ('members','support')} for a in sorted({a for c, _ in members for a in c.get('category_angle_ids', [])}) if a in angles],
|
|
197
|
+
'pattern_status': pattern_status, 'convergence': len(by_domain), 'direct_convergence': len(direct),
|
|
198
|
+
'indirect_convergence': len(indirect), 'recurring': len(by_domain) > 1,
|
|
199
|
+
'competitors': sorted(by_domain), 'dated_competitors': sorted(proving), 'running_competitors': sorted(running),
|
|
200
|
+
'creatives': len(members), 'members': lineage, 'source_members': [source for c, _ in members for source in (c.get('source_members') or [{k:c.get(k) for k in ('creative_id','domain','country','countries','channel','competitor_tier','relevance','language_allowed','language_status','duration_scope','served_days','running_at_capture','footprint_ad_id')}])], 'relevance': 'relevant', 'language_status': 'allowed', 'language_allowed': True,
|
|
201
|
+
'max_served_days': max((c.get('served_days') or 0 for c, _ in members), default=0) or None,
|
|
202
|
+
'examples': {'hook_text': list(dict.fromkeys((cl.get('texts') or {}).get('hook_text') for _, cl in members if (cl.get('texts') or {}).get('hook_text')))[:3]},
|
|
203
|
+
'market_scope': members[0][0].get('market_scope'),
|
|
204
|
+
'category_dictionary_sha256': dictionary.get('dictionary_sha256'), 'tier': 'B'})
|
|
205
|
+
return sorted(results, key=lambda row: (str(row['country']), row['channel'], row['creative_type'], row['pattern_id']))
|
|
206
|
+
|
|
207
|
+
|
|
208
|
+
_COMMERCIAL = re.compile(r'[$€£]\s*\d|\d\s*(?:USD|EUR|GBP)|\d+\s?%\s?off|\bsalar(?:y|ies)\b|\bearn\b|\bguarantee\b', re.I)
|
|
209
|
+
|
|
210
|
+
|
|
211
|
+
def promises(creatives: list[dict], classifications: list[dict] | None = None) -> list[dict]:
|
|
212
|
+
"""Whole source sentences for commercial terms and grounded outcome promises.
|
|
213
|
+
|
|
214
|
+
The taxonomy's promise excerpt locates a claim; it is never used as the
|
|
215
|
+
report text when the corresponding complete sentence is available.
|
|
216
|
+
"""
|
|
217
|
+
rows: dict[tuple, dict] = {}
|
|
218
|
+
by_id = {row.get('creative_id'): row for row in classifications or []}
|
|
219
|
+
for creative in creatives:
|
|
220
|
+
texts = [(creative.get(k), k, 'native_ad_copy', []) for k in ('headline', 'body')]
|
|
221
|
+
texts += [(creative.get('transcript'), 'transcript', 'transcript', [])]
|
|
222
|
+
snippets = creative.get('observed_text_sources') or []
|
|
223
|
+
if snippets:
|
|
224
|
+
texts += [(item.get('text'), 'observed_text', item.get('excerpt_source') or 'unknown_extraction',
|
|
225
|
+
item.get('frame_refs') or []) for item in snippets if isinstance(item, dict)]
|
|
226
|
+
else:
|
|
227
|
+
origin = creative.get('observed_text_source')
|
|
228
|
+
excerpt_source = 'native_ad_copy' if origin == 'native_text' else 'frame_extraction' if origin == 'frame_extraction' else 'unknown_extraction'
|
|
229
|
+
texts += [(creative.get('observed_text'), 'observed_text', excerpt_source,
|
|
230
|
+
creative.get('observed_text_frame_refs') or [])]
|
|
231
|
+
for index, text in enumerate(creative.get('extra_texts') or []):
|
|
232
|
+
origins = creative.get('extra_text_sources') or []
|
|
233
|
+
origin = origins[index] if index < len(origins) and isinstance(origins[index], dict) else {'kind': 'ad_text'}
|
|
234
|
+
kind = origin.get('kind')
|
|
235
|
+
source = ('frame_extraction' if kind == 'video_frame_ocr' else 'video_metadata'
|
|
236
|
+
if str(kind).startswith('video_metadata') else 'native_ad_copy' if kind == 'ad_text' else 'unknown_extraction')
|
|
237
|
+
refs = [origin['ref']] if source == 'frame_extraction' and origin.get('ref') else []
|
|
238
|
+
texts.append((text, 'extra_texts', source, refs))
|
|
239
|
+
texts += [(observation.get(k), 'native_observation', 'native_ad_copy', [])
|
|
240
|
+
for observation in creative.get('observations') or [] for k in ('headline', 'body')]
|
|
241
|
+
texts += [(observation.get(k), 'native_observation', 'native_ad_copy', [])
|
|
242
|
+
for observation in creative.get('source_observations') or [] for k in ('title', 'body')]
|
|
243
|
+
metadata = creative.get('video_metadata') or {}
|
|
244
|
+
texts += [(metadata.get(k), 'video_metadata_' + k, 'video_metadata', []) for k in ('title', 'description')]
|
|
245
|
+
analysis = creative.get('media_analysis') or {}
|
|
246
|
+
analysis = analysis.get('analysis') or analysis
|
|
247
|
+
for frame in analysis.get('frames') or []:
|
|
248
|
+
ref = frame.get('ref') or frame.get('frame_ref')
|
|
249
|
+
refs = [ref] if ref else []
|
|
250
|
+
texts += [(text, 'video_frame', 'frame_extraction', refs) for text in frame.get('visible_text') or []]
|
|
251
|
+
label = by_id.get(creative['creative_id']) or {}
|
|
252
|
+
extracted = (label.get('texts') or {}).get('promise_text')
|
|
253
|
+
extracts = [(extracted, 'outcome_promise')] if isinstance(extracted, str) and extracted.strip() else []
|
|
254
|
+
for promise in (label.get('semantics') or {}).get('promises') or []:
|
|
255
|
+
if isinstance(promise, dict) and isinstance(promise.get('excerpt'), str):
|
|
256
|
+
extracts.append((promise['excerpt'], promise.get('kind') or 'outcome_promise'))
|
|
257
|
+
|
|
258
|
+
def normalized(value: str) -> str:
|
|
259
|
+
return re.sub(r'\s+', ' ', value).strip().casefold()
|
|
260
|
+
|
|
261
|
+
for text, source, excerpt_source, frame_refs in texts:
|
|
262
|
+
if not isinstance(text, str):
|
|
263
|
+
continue
|
|
264
|
+
# OCR/speech line wraps do not constitute sentence boundaries.
|
|
265
|
+
sentences = [part.strip() for part in re.split(r'(?<=[!?])\s+|(?<=\.)\s+(?=[A-ZА-Я])',
|
|
266
|
+
re.sub(r'\s+', ' ', text).strip()) if part.strip()]
|
|
267
|
+
claims = [(sentence, 'commercial_terms') for sentence in sentences if _COMMERCIAL.search(sentence)
|
|
268
|
+
or re.search(r'\b(?:save|discount)\s+\d+(?:\.\d+)?\s*%', sentence, re.I)]
|
|
269
|
+
for extracted, kind in extracts:
|
|
270
|
+
if not extracted.strip() or normalized(extracted) not in normalized(text):
|
|
271
|
+
continue
|
|
272
|
+
candidates = []
|
|
273
|
+
# An excerpt can span punctuation; expand to complete source
|
|
274
|
+
# sentences rather than cropping a fixed context window.
|
|
275
|
+
for start in range(len(sentences)):
|
|
276
|
+
for end in range(start + 1, min(len(sentences), start + 3) + 1):
|
|
277
|
+
candidate = ' '.join(sentences[start:end])
|
|
278
|
+
if normalized(extracted) in normalized(candidate):
|
|
279
|
+
candidates.append(candidate)
|
|
280
|
+
if candidates:
|
|
281
|
+
claims.append((min(candidates, key=len), kind))
|
|
282
|
+
else:
|
|
283
|
+
claims.append((re.sub(r'\s+', ' ', text).strip(), kind))
|
|
284
|
+
for sentence, kind in claims:
|
|
285
|
+
key = (creative['domain'], re.sub(r'\s+', ' ', sentence).casefold())
|
|
286
|
+
row = rows.setdefault(key, {'type': 'price_anchor', 'domain': creative['domain'], 'platform': creative['platform'],
|
|
287
|
+
'creative_id': creative['creative_id'], 'excerpt': sentence, 'promise_kind': 'competitor_claim',
|
|
288
|
+
'claim_kinds': [],
|
|
289
|
+
'source_refs': [], 'country': creative.get('country'), 'relevance': creative.get('relevance'),
|
|
290
|
+
'market_scope': creative.get('market_scope'), 'usage': 'information_only', 'tier': 'B'})
|
|
291
|
+
if kind not in row['claim_kinds']:
|
|
292
|
+
row['claim_kinds'].append(kind)
|
|
293
|
+
ref = {'creative_id': creative['creative_id'], 'source_kind': source, 'country': creative.get('country'),
|
|
294
|
+
'excerpt_source': excerpt_source, 'frame_refs': frame_refs}
|
|
295
|
+
if ref not in row['source_refs']:
|
|
296
|
+
row['source_refs'].append(ref)
|
|
297
|
+
return sorted(rows.values(), key=lambda row: (row['domain'], row['excerpt']))
|
|
298
|
+
|
|
299
|
+
|
|
300
|
+
def markdown_literal(value: Any, *, inline: bool = False) -> str:
|
|
301
|
+
text = str(value or '')
|
|
302
|
+
if inline:
|
|
303
|
+
text = ' '.join(text.split())
|
|
304
|
+
text = html.escape(text, quote=False)
|
|
305
|
+
return re.sub(r'([\\`*_{}\[\]()#+|~])', lambda match: '\\' + match.group(0), text)
|
|
306
|
+
|
|
307
|
+
|
|
308
|
+
def markdown_quote(value: Any) -> str:
|
|
309
|
+
return '\n'.join('> ' + markdown_literal(line) for line in str(value or '').splitlines())
|
|
310
|
+
|
|
311
|
+
|
|
312
|
+
def markdown_link(label: Any, url: Any) -> str:
|
|
313
|
+
label = markdown_literal(label, inline=True)
|
|
314
|
+
url = str(url or '')
|
|
315
|
+
try:
|
|
316
|
+
parsed = urllib.parse.urlsplit(url)
|
|
317
|
+
if parsed.scheme not in ('http', 'https') or not parsed.hostname or any(ord(char) < 33 for char in url):
|
|
318
|
+
return label + ' (link unavailable)'
|
|
319
|
+
except ValueError:
|
|
320
|
+
return label + ' (link unavailable)'
|
|
321
|
+
return f"[{label}]({urllib.parse.quote(url, safe=':/?=&%+@;,-._~#')})"
|
|
322
|
+
|
|
323
|
+
|
|
324
|
+
def section(creatives: list[dict], patterns: list[dict], claims: list[dict], coverage: list[dict], days: int, selection: dict | None = None) -> str:
|
|
325
|
+
lines = ['### Creative inspection sample by market, channel and type', '',
|
|
326
|
+
'Stable-ID inspection sample of comparable creatives. Dates, native activity and variants are observations, not measured conversions, return on spend or selection advice.', '']
|
|
327
|
+
by_id = {row['creative_id']: row for row in creatives}
|
|
328
|
+
for cell in selection["cells"] if selection is not None else SELECTION.top_cells(creatives):
|
|
329
|
+
country, channel, ctype, domain = (cell.get(key) or 'unscoped' for key in ('country', 'channel', 'creative_type', 'domain'))
|
|
330
|
+
lookup = {row['creative_id']: row for row in creatives if row.get('country') == cell['country'] and row.get('channel') == cell['channel'] and row.get('domain') == cell['domain'] and row.get('creative_type', 'unknown') == cell['creative_type']}
|
|
331
|
+
items = [lookup[cid] for cid in cell['creative_ids']]
|
|
332
|
+
lines += [f'#### {country} / {channel} / {ctype} / {domain}', '']
|
|
333
|
+
for row in items:
|
|
334
|
+
available = [row.get(k) for k in ('headline', 'body', 'observed_text', 'transcript')] + (row.get('extra_texts') or [])
|
|
335
|
+
text = '\n\n'.join(dict.fromkeys(str(value) for value in available if value))
|
|
336
|
+
lines += [f"- {markdown_link(row['creative_id'], row.get('link'))}: {row.get('served_days') if row.get('served_days') is not None else 'unknown'} days ({row.get('age_basis') or 'unknown'}, {row.get('duration_scope') or 'unscoped'}); running: {row.get('running_at_capture')}; format: {row.get('format_kind') or 'unknown'} / {row.get('format_detail') or 'unspecified'}.", '', markdown_quote(text or 'No readable text extracted.'), '']
|
|
337
|
+
assets = [a for a in row.get('media_assets') or [] if a.get('publication_status') != 'unavailable']
|
|
338
|
+
previews = [a for a in assets if a.get('kind') in ('image', 'preview')]
|
|
339
|
+
if not previews:
|
|
340
|
+
previews = [a for a in assets if a.get('kind') == 'frame'][:1]
|
|
341
|
+
for asset in previews:
|
|
342
|
+
# Materialized report is egbe-docs/research/market/full-report.md.
|
|
343
|
+
ref = posixpath.relpath(asset['path'], _artifact_path('egbe-docs/research/market'))
|
|
344
|
+
lines += [f"", '']
|
|
345
|
+
if row.get('video_gaps'):
|
|
346
|
+
lines += ['Video gaps: ' + markdown_literal('; '.join(row['video_gaps']), inline=True), '']
|
|
347
|
+
lines += ['### Patterns by market, channel, creative type and format', '']
|
|
348
|
+
for row in patterns:
|
|
349
|
+
lines += [f"- {row.get('country') or 'unscoped'} / {row['channel']} / {row['creative_type']} / {row['format_kind']} / {row.get('format_detail') or 'unspecified'}: **{markdown_literal(row['description'], inline=True)}**. {row['pattern_status']}; convergence {row['convergence']} (direct {row['direct_convergence']}); competitors: {', '.join(row['competitors'])}."]
|
|
350
|
+
for member in row['members'][:3]:
|
|
351
|
+
creative = by_id.get(member['creative_id'], {})
|
|
352
|
+
lines.append(f" - Example: {markdown_link(member['creative_id'], creative.get('link'))}")
|
|
353
|
+
lines += ['', '### Competitor promises and price anchors', '', 'Observed competitor claims are information only.', '']
|
|
354
|
+
previous_domain = None
|
|
355
|
+
for claim in claims:
|
|
356
|
+
if claim['domain'] != previous_domain:
|
|
357
|
+
lines += [f"#### {claim['domain']}", '']
|
|
358
|
+
previous_domain = claim['domain']
|
|
359
|
+
sources = ', '.join(f"{markdown_link(ref['creative_id'], by_id.get(ref['creative_id'], {}).get('link'))} ({ref.get('country') or 'unscoped'}; {markdown_literal(ref.get('excerpt_source') or ref.get('source_kind') or 'unknown', inline=True)})" for ref in claim.get('source_refs') or [])
|
|
360
|
+
lines += [f"- {markdown_literal(claim['excerpt'], inline=True)} ({claim.get('relevance') or 'unknown'}). Sources: {sources}"]
|
|
361
|
+
lines += ['', '### Method and coverage', '', 'Native delivery intervals retain their source scope. Separate launches and listing sightings do not establish continuous delivery or commercial success.', '']
|
|
362
|
+
for gap in coverage:
|
|
363
|
+
lines.append(f"- {gap.get('country') or 'unscoped'} / {gap.get('channel') or gap.get('source')} / {gap.get('domain', 'all')}: {gap.get('status')}; {markdown_literal(gap.get('detail'), inline=True)}")
|
|
364
|
+
return '\n'.join(lines) + '\n'
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
"""Canonical bounded creative inspection sample for portable readers."""
|
|
2
|
+
from __future__ import annotations
|
|
3
|
+
|
|
4
|
+
import sys as _artifact_sys
|
|
5
|
+
from pathlib import Path as _ArtifactPath
|
|
6
|
+
_artifact_sys.path.insert(0, str(_ArtifactPath(__file__).resolve().parent))
|
|
7
|
+
from egbe_artifacts import artifact_path as _artifact_path
|
|
8
|
+
|
|
9
|
+
import hashlib
|
|
10
|
+
import json
|
|
11
|
+
from collections import defaultdict
|
|
12
|
+
from pathlib import Path
|
|
13
|
+
|
|
14
|
+
SELECTION_REL = Path(_artifact_path("egbe-docs/research/market/evidence/creative-selection.v1.json"))
|
|
15
|
+
TYPE_ORDER = {"text": 0, "static_image": 1, "video": 2, "unknown": 3}
|
|
16
|
+
ROLE_ORDER = {"direct": 0, "indirect": 1, "unknown": 2}
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def digest(value):
|
|
20
|
+
return hashlib.sha256(json.dumps(value, sort_keys=True, separators=(",", ":"), ensure_ascii=False, allow_nan=False).encode()).hexdigest()
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def eligible(row):
|
|
24
|
+
return row.get("relevance") == "relevant" and row.get("language_status") == "allowed" and row.get("language_allowed") is True
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def citable(row, countries=None):
|
|
28
|
+
"""A comparable source row in a researched market, not proof of performance."""
|
|
29
|
+
country = row.get("country")
|
|
30
|
+
return (eligible(row) and bool(country) and bool(row.get("channel"))
|
|
31
|
+
and (not countries or country in countries))
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
def strength_key(row):
|
|
35
|
+
# Stable bounded inspection sample, not a recommendation or success score.
|
|
36
|
+
return (str(row.get("creative_id") or ""),)
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
def top_cells(creatives, countries=None, limit=3):
|
|
40
|
+
groups = defaultdict(list)
|
|
41
|
+
for row in creatives:
|
|
42
|
+
groups[(row.get("country"), row.get("channel"), row.get("creative_type", "unknown"), row.get("domain"))].append(row)
|
|
43
|
+
country_order = {country: pos for pos, country in enumerate(countries or [])}
|
|
44
|
+
def key(pair):
|
|
45
|
+
(country, channel, typ, domain), members = pair
|
|
46
|
+
role = members[0].get("competitor_tier", "unknown")
|
|
47
|
+
return (country_order.get(country, 999), str(country or ""), str(channel or ""), TYPE_ORDER.get(typ, 3), ROLE_ORDER.get(role, 2), str(domain or ""))
|
|
48
|
+
cells = []
|
|
49
|
+
for scope, members in sorted(groups.items(), key=key):
|
|
50
|
+
country, channel, typ, domain = scope
|
|
51
|
+
candidates = [r for r in members if eligible(r)]
|
|
52
|
+
selected = sorted(candidates, key=strength_key)[:limit]
|
|
53
|
+
cells.append({"country": country, "channel": channel, "creative_type": typ, "domain": domain,
|
|
54
|
+
"competitor_tier": members[0].get("competitor_tier", "unknown"), "total": len(members),
|
|
55
|
+
"eligible_total": len(candidates), "selected_count": len(selected),
|
|
56
|
+
"creative_ids": [r["creative_id"] for r in selected]})
|
|
57
|
+
return cells
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
def build_selection(evidence, workspace=None):
|
|
61
|
+
rows = evidence.get("rows") or []
|
|
62
|
+
creatives = [r for r in rows if r.get("type") == "creative"]
|
|
63
|
+
inputs = {k: v for k, v in (evidence.get("inputs") or {}).items() if k not in ("creative_selection_path", "creative_selection_sha256")}
|
|
64
|
+
cells = top_cells(creatives, inputs.get("target_countries"))
|
|
65
|
+
lookup = {(r.get("country"), r.get("channel"), r.get("creative_type", "unknown"), r.get("domain"), r.get("creative_id")): r for r in creatives}
|
|
66
|
+
selected = []
|
|
67
|
+
for cell_rank, cell in enumerate(cells, 1):
|
|
68
|
+
for rank, cid in enumerate(cell["creative_ids"], 1):
|
|
69
|
+
row = lookup[(cell["country"], cell["channel"], cell["creative_type"], cell["domain"], cid)]
|
|
70
|
+
selected.append({**{k: row.get(k) for k in ("creative_id", "country", "channel", "creative_type", "domain", "competitor_tier", "landing_url", "footprint_ad_id", "source_members", "longevity_status", "running_at_capture", "served_days", "strength_components")},
|
|
71
|
+
"rank": rank, "cell_rank": cell_rank})
|
|
72
|
+
hashes = {"corpus_sha256": digest(creatives),
|
|
73
|
+
"classifications_sha256": digest([r for r in rows if r.get("type") == "creative_classification"]),
|
|
74
|
+
"angle_dictionary_sha256": digest(evidence.get("angle_dictionary") or {}),
|
|
75
|
+
"inputs_sha256": digest(inputs), "policy_sha256": inputs.get("policy_sha256"),
|
|
76
|
+
"competitor_set_sha256": None, "channel_footprint_sha256": None}
|
|
77
|
+
if workspace is not None:
|
|
78
|
+
for key, filename in (("competitor_set_sha256", "competitors.json"), ("channel_footprint_sha256", "channel-footprint.json")):
|
|
79
|
+
path = Path(workspace) / SELECTION_REL.parent / filename
|
|
80
|
+
if path.is_file():
|
|
81
|
+
hashes[key] = hashlib.sha256(path.read_bytes()).hexdigest()
|
|
82
|
+
return {"schema_version": 1, "artifact": "creative_selection.v1", "cells": cells,
|
|
83
|
+
"selection_basis": "stable_id_inspection_sample", "selected_creatives": selected, "source_hashes": hashes}
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
def validate_selection(evidence, manifest, workspace=None):
|
|
87
|
+
if not isinstance(manifest, dict) or manifest.get("schema_version") != 1 or manifest.get("artifact") != "creative_selection.v1":
|
|
88
|
+
raise ValueError("unsupported creative selection manifest")
|
|
89
|
+
expected = build_selection(evidence, workspace)
|
|
90
|
+
for field in ("cells", "selected_creatives"):
|
|
91
|
+
if manifest.get(field) != expected[field]:
|
|
92
|
+
raise ValueError(f"creative selection {field} differs from the canonical inspection sample")
|
|
93
|
+
hashes = manifest.get("source_hashes") or {}
|
|
94
|
+
for key, value in expected["source_hashes"].items():
|
|
95
|
+
if key in ("competitor_set_sha256", "channel_footprint_sha256") and workspace is None:
|
|
96
|
+
continue
|
|
97
|
+
if hashes.get(key) != value:
|
|
98
|
+
raise ValueError(f"creative selection {key} is stale")
|
|
99
|
+
if evidence.get("selection") is not None and evidence["selection"] != manifest:
|
|
100
|
+
raise ValueError("embedded creative selection differs from its published manifest")
|
|
101
|
+
return manifest
|
|
102
|
+
|
|
103
|
+
|
|
104
|
+
def read_selection(workspace, evidence):
|
|
105
|
+
inputs = evidence.get("inputs") or {}
|
|
106
|
+
rel = inputs.get("creative_selection_path")
|
|
107
|
+
if rel != SELECTION_REL.as_posix():
|
|
108
|
+
raise ValueError("creative selection path is missing or noncanonical; rerun Creative Patterns")
|
|
109
|
+
path = Path(workspace) / SELECTION_REL
|
|
110
|
+
raw = path.read_bytes()
|
|
111
|
+
if hashlib.sha256(raw).hexdigest() != inputs.get("creative_selection_sha256"):
|
|
112
|
+
raise ValueError("creative selection hash changed; rerun Creative Patterns")
|
|
113
|
+
return validate_selection(evidence, json.loads(raw), workspace)
|