@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,493 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Prepare every selected 04 funnel, validate mobile-browser research, publish v2.
|
|
3
|
+
|
|
4
|
+
The runner makes no network requests or form submissions. The executing agent
|
|
5
|
+
walks real browser screens using explicit human approval and an intent journal.
|
|
6
|
+
Resume preserves aliases, observations and already attempted submissions.
|
|
7
|
+
"""
|
|
8
|
+
from __future__ import annotations
|
|
9
|
+
|
|
10
|
+
import sys as _artifact_sys
|
|
11
|
+
from pathlib import Path as _ArtifactPath
|
|
12
|
+
_artifact_sys.path.insert(0, str(_ArtifactPath(__file__).resolve().parent))
|
|
13
|
+
from egbe_artifacts import artifact_path as _artifact_path
|
|
14
|
+
import argparse
|
|
15
|
+
import importlib.util
|
|
16
|
+
import json
|
|
17
|
+
import re
|
|
18
|
+
import sys
|
|
19
|
+
from datetime import date
|
|
20
|
+
from pathlib import Path
|
|
21
|
+
from urllib.parse import urlsplit
|
|
22
|
+
|
|
23
|
+
SCHEMA_VERSION = 2
|
|
24
|
+
SECTION_ID = "funnel_teardown"
|
|
25
|
+
SECTION_HEADING = "Funnel teardown"
|
|
26
|
+
DISPLAY_NAME = "Funnel Teardown"
|
|
27
|
+
RUNTIME_REL = Path(_artifact_path("egbe-docs/research/market/work/funnel_teardown"))
|
|
28
|
+
EVIDENCE_REL = Path(_artifact_path("egbe-docs/research/market/evidence/funnel-teardown.json"))
|
|
29
|
+
CREATIVE_PATTERNS_EVIDENCE_REL = Path(_artifact_path("egbe-docs/research/market/evidence/creative-patterns.json"))
|
|
30
|
+
REPORT_REL = Path(_artifact_path("egbe-docs/research/market/full-report.md"))
|
|
31
|
+
WALKS_FILENAME = "walks.json"
|
|
32
|
+
CANDIDATES_FILENAME = "candidates.json"
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
def _load_script(filename, name):
|
|
36
|
+
spec = importlib.util.spec_from_file_location(name, Path(__file__).with_name(filename))
|
|
37
|
+
module = importlib.util.module_from_spec(spec)
|
|
38
|
+
sys.modules[name] = module
|
|
39
|
+
spec.loader.exec_module(module)
|
|
40
|
+
return module
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
MODEL = _load_script("funnel-model.py", "pmr_funnel_model")
|
|
44
|
+
IO = _load_script("research-artifact-io.py", "pmr_funnel_io")
|
|
45
|
+
POLICY = _load_script("research-policy.py", "pmr_funnel_policy")
|
|
46
|
+
INTEGRITY = _load_script("research_integrity.py", "pmr_funnel_integrity")
|
|
47
|
+
EMAIL = _load_script("funnel-email-review.py", "pmr_funnel_email")
|
|
48
|
+
FunnelTeardownError = MODEL.FunnelError
|
|
49
|
+
WALK_VIEWPORT = MODEL.VIEWPORT
|
|
50
|
+
SCREEN_KINDS = MODEL.SCREEN_KINDS
|
|
51
|
+
ADVANCE_KINDS = MODEL.ADVANCE_KINDS
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
class UpstreamPending(FunnelTeardownError):
|
|
55
|
+
pass
|
|
56
|
+
|
|
57
|
+
|
|
58
|
+
def _arg(args, key, default=None):
|
|
59
|
+
value = getattr(args, key, None)
|
|
60
|
+
return default if value is None else value
|
|
61
|
+
|
|
62
|
+
|
|
63
|
+
def _read(path, default=None):
|
|
64
|
+
if not path.exists():
|
|
65
|
+
return default
|
|
66
|
+
try:
|
|
67
|
+
data = json.loads(path.read_text())
|
|
68
|
+
except (OSError, json.JSONDecodeError) as exc:
|
|
69
|
+
raise FunnelTeardownError(f"invalid JSON artifact: {path.name}") from exc
|
|
70
|
+
if not isinstance(data, dict):
|
|
71
|
+
raise FunnelTeardownError(f"{path.name} must contain a JSON object")
|
|
72
|
+
return data
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
def _path(workspace, value, default):
|
|
76
|
+
path = Path(value or default)
|
|
77
|
+
return path if path.is_absolute() else workspace / path
|
|
78
|
+
|
|
79
|
+
|
|
80
|
+
def load_upstream(workspace):
|
|
81
|
+
reader = _load_script("research-evidence.py", "pmr_funnel_upstream")
|
|
82
|
+
inspected = reader.inspect_section(workspace, "creative_patterns")
|
|
83
|
+
if inspected.get("status") != "completed":
|
|
84
|
+
raise UpstreamPending("04 is pending, stale or unverified: " + str(inspected.get("reason") or "refresh publication"))
|
|
85
|
+
document = inspected.get("data") or _read(workspace / CREATIVE_PATTERNS_EVIDENCE_REL)
|
|
86
|
+
selector = _load_script("creative-selection.py", "pmr_funnel_selection")
|
|
87
|
+
selection = selector.read_selection(workspace, document)
|
|
88
|
+
policy, digest = POLICY.load_policy()
|
|
89
|
+
inputs = document.get("inputs") or {}
|
|
90
|
+
if document.get("schema_version") != 2 or inputs.get("policy_sha256") != digest or inputs.get("effective_policy") != policy:
|
|
91
|
+
raise FunnelTeardownError("04 policy or contract changed; refresh 04 before funnel research")
|
|
92
|
+
return document, selection, policy
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
def build_candidates(campaigns, context):
|
|
96
|
+
candidates = []
|
|
97
|
+
by_funnel = {}
|
|
98
|
+
for c in campaigns:
|
|
99
|
+
if c["funnel_id"] in by_funnel:
|
|
100
|
+
existing = by_funnel[c["funnel_id"]]
|
|
101
|
+
existing["campaign_ids"].append(c["campaign_id"])
|
|
102
|
+
existing["creative_ids"].extend(c["creative_ids"])
|
|
103
|
+
existing["original_urls"].extend(c["original_urls"])
|
|
104
|
+
continue
|
|
105
|
+
row = {k: c.get(k) for k in ("funnel_id", "domain", "address", "country", "channel", "competitor_tier", "role", "original_urls", "rank")}
|
|
106
|
+
row.update(campaign_ids=[c["campaign_id"]], creative_ids=c["creative_ids"], observation_status=c["observation_status"], primary_path_id="buyer")
|
|
107
|
+
row["original_urls"] = list(row["original_urls"])
|
|
108
|
+
row["creative_ids"] = list(row["creative_ids"])
|
|
109
|
+
if c.get("equivalence_ref"):
|
|
110
|
+
row["equivalence_ref"] = c["equivalence_ref"]
|
|
111
|
+
candidates.append(row)
|
|
112
|
+
by_funnel[c["funnel_id"]] = row
|
|
113
|
+
seen = set()
|
|
114
|
+
for entry in context.get("own_destinations", []):
|
|
115
|
+
if isinstance(entry, str):
|
|
116
|
+
entry = {"url": entry, "country": context.get("target_market")}
|
|
117
|
+
address = MODEL.url_identity(entry.get("url"))
|
|
118
|
+
key = (address, entry.get("country"))
|
|
119
|
+
if key in seen:
|
|
120
|
+
continue
|
|
121
|
+
seen.add(key)
|
|
122
|
+
candidates.append({"funnel_id": MODEL.identity("own", key), "domain": urlsplit(address).hostname,
|
|
123
|
+
"address": address, "country": entry.get("country"), "channel": "own", "role": "own",
|
|
124
|
+
"competitor_tier": "own", "campaign_ids": [], "creative_ids": [], "observation_status": "not_applicable",
|
|
125
|
+
"original_urls": [entry["url"]], "primary_path_id": "buyer", "rank": len(candidates) + 1})
|
|
126
|
+
return candidates
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
def landing_rows(walks):
|
|
130
|
+
rows = []
|
|
131
|
+
for walk in walks:
|
|
132
|
+
for screen in walk["screens"]:
|
|
133
|
+
row = {k: walk.get(k) for k in ("funnel_id", "path_id", "walk_id", "domain", "role", "country", "channel", "campaign_ids", "creative_ids")}
|
|
134
|
+
row.update(type="landing_page", page_id=MODEL.identity("page", [walk["walk_id"], screen["screen_id"]]),
|
|
135
|
+
screen_id=screen["screen_id"], address=screen["url"], page_type=screen.get("page_type", "unknown"),
|
|
136
|
+
headline=screen["headline"], primary_cta=screen.get("cta"), offer=screen.get("offer"),
|
|
137
|
+
proof=screen.get("proof", []), amounts=screen.get("amounts", []), lead_fields=screen.get("lead_fields", []),
|
|
138
|
+
screenshot=screen["screenshot"], screenshots=screen.get("screenshots", []),
|
|
139
|
+
retrieved_on=walk["walked_on"], source="browser", tier="A")
|
|
140
|
+
rows.append(row)
|
|
141
|
+
return rows
|
|
142
|
+
|
|
143
|
+
|
|
144
|
+
def _cell(value):
|
|
145
|
+
return str(value if value is not None else "not observed").replace("|", "\\|").replace("\n", " ")
|
|
146
|
+
|
|
147
|
+
|
|
148
|
+
def private_contact_values(context, registry, mailbox, plans):
|
|
149
|
+
"""Collect identities, not contact preferences such as 'Email'."""
|
|
150
|
+
private = [r.get("alias", "") for r in registry.get("identities", [])] + [mailbox or ""]
|
|
151
|
+
private += [p.get("name") or "" for p in [context.get("persona", {}), *context.get("additional_personas", [])]]
|
|
152
|
+
names = {"name", "first_name", "last_name", "full_name", "given_name", "family_name", "contact_name"}
|
|
153
|
+
for form in plans.get("forms", []):
|
|
154
|
+
for key, value in form.get("fields", {}).items():
|
|
155
|
+
if not isinstance(value, (str, int)) or isinstance(value, bool):
|
|
156
|
+
continue
|
|
157
|
+
normalized = re.sub(r"(?<!^)(?=[A-Z])", "_", key).lower().replace("-", "_").replace(" ", "_")
|
|
158
|
+
identifier = normalized in {"email", "email_address", "phone", "phone_number", "telephone", "mobile", "mobile_number"} or normalized.endswith(("_email", "_email_address", "_phone", "_phone_number", "_telephone", "_mobile"))
|
|
159
|
+
if normalized in names or identifier:
|
|
160
|
+
private.append(str(value))
|
|
161
|
+
return list(dict.fromkeys(value for value in private if value))
|
|
162
|
+
|
|
163
|
+
|
|
164
|
+
def render_section(*, campaigns, walks, patterns, coverage, as_of):
|
|
165
|
+
lines = [f"Selected creative → funnel combinations; campaign cutoff {as_of}. Browser dates are separate.", "", "### A. Selected campaigns and funnel screens", ""]
|
|
166
|
+
by_campaign = {c["campaign_id"]: c for c in campaigns}
|
|
167
|
+
for walk in walks:
|
|
168
|
+
lines += [f"#### {walk['country'] or 'unknown market'} · {walk['channel']} · {walk['domain']} · {walk['path_id']}", "",
|
|
169
|
+
f"Status: {walk['status']}; observed outcome: {walk.get('observed_outcome') or 'not observed'}; stop: {walk['stop_reason']}.",
|
|
170
|
+
f"Observed main screens: {walk['observed_screens_count']}; full length: {walk['full_screens_count'] or 'unknown'}; advertising observation: {walk['observation_status']}.",
|
|
171
|
+
f"Unknown: {', '.join(walk['unknown']) or 'none recorded'}.", ""]
|
|
172
|
+
for cid in walk["campaign_ids"]:
|
|
173
|
+
for creative in by_campaign[cid]["creatives"]:
|
|
174
|
+
lines.append(f"Creative {creative['creative_id']}: {_cell(creative.get('headline'))} — {_cell(creative.get('body'))}")
|
|
175
|
+
for asset in creative.get("media_assets", []):
|
|
176
|
+
if asset.get("path"):
|
|
177
|
+
lines.append(f"")
|
|
178
|
+
lines += ["", "| # | Screen | Headline | Advance | Answer | Offer / price / result | Screenshot |", "| --- | --- | --- | --- | --- | --- | --- |"]
|
|
179
|
+
for screen in walk["screens"]:
|
|
180
|
+
detail = {k: screen.get(k) for k in ("offer", "amounts", "result_type") if screen.get(k)}
|
|
181
|
+
lines.append(f"| {screen['n']} | {_cell(screen['kind'])} ({screen['branch_role']}) | {_cell(screen['headline'])} | {screen['advance']} | {_cell(screen.get('answer'))} | {_cell(detail)} | [screen]({screen['screenshot']['path']}) |")
|
|
182
|
+
lines.append("")
|
|
183
|
+
for screen in walk["screens"]:
|
|
184
|
+
lines += [f"![{walk['domain']} {screen['screen_id']}]({screen['screenshot']['path']})", ""]
|
|
185
|
+
lines += ["### B. Patterns by channel and market", "", "| Market | Channel | Pattern | Campaigns / known | Unknown | Observed / dated convergence | Activity |", "| --- | --- | --- | --- | --- | --- | --- |"]
|
|
186
|
+
for p in patterns:
|
|
187
|
+
lines.append(f"| {p.get('country') or 'unknown'} | {p['channel']} | {_cell(p['pattern'])} | {p['campaigns_with']} / {p['known_campaigns_total']} | {p['unknown_campaigns']} | {p['observed_convergence']} / {p['dated_convergence']} | {p['observation_status']} |")
|
|
188
|
+
lines += ["", "### Coverage and continuation", ""]
|
|
189
|
+
for gap in coverage:
|
|
190
|
+
lines.append(f"- {gap.get('country') or 'unknown'} / {gap.get('channel') or 'own'} / {gap.get('domain') or 'all'}: {gap['status']} — {_cell(gap['detail'])}")
|
|
191
|
+
lines += ["", "Proof is the shared advertising-duration proxy, not measured conversion. Replicate observed structure; never copy competitor claims or figures.", ""]
|
|
192
|
+
return "\n".join(lines)
|
|
193
|
+
|
|
194
|
+
|
|
195
|
+
def lifecycle_handoff(intents, outcomes, existing, candidates, walks=()):
|
|
196
|
+
by_funnel = {c["funnel_id"]: c for c in candidates}
|
|
197
|
+
handoff = {"schema_version": 1, "subscriptions": [], "events": (existing or {}).get("events", [])}
|
|
198
|
+
subscriptions = {}
|
|
199
|
+
for eid, intent in intents.items():
|
|
200
|
+
if outcomes.get(eid, {}).get("outcome") != "submitted":
|
|
201
|
+
continue
|
|
202
|
+
f = intent["form"]
|
|
203
|
+
observed_path = next((w for w in walks if w["funnel_id"] == f["funnel_id"] and w["path_id"] == f["path_id"]), {})
|
|
204
|
+
expectations = observed_path.get("email_expectations", {"confirmation": None, "result": None, "source_ref": None})
|
|
205
|
+
if not isinstance(expectations, dict) or any(type(expectations.get(key)) not in (bool, type(None)) for key in ("confirmation", "result")):
|
|
206
|
+
raise FunnelTeardownError("email expectations must be explicit booleans or unknown")
|
|
207
|
+
if any(expectations.get(key) is not None for key in ("confirmation", "result")):
|
|
208
|
+
source = expectations.get("source_ref")
|
|
209
|
+
screen_ids = {s["screen_id"] for s in observed_path.get("screens", [])}
|
|
210
|
+
if not isinstance(source, str) or not source.startswith("browser:") or source[8:] not in screen_ids:
|
|
211
|
+
raise FunnelTeardownError("known email expectations require the actual browser screen reference")
|
|
212
|
+
if expectations.get("wait_until") is not None:
|
|
213
|
+
deadline = EMAIL.timestamp(expectations["wait_until"])
|
|
214
|
+
if deadline is None or deadline < EMAIL.timestamp(intent["occurred_at"]) or not any(expectations.get(key) is True for key in ("confirmation", "result")):
|
|
215
|
+
raise FunnelTeardownError("expected email wait_until must be an observed future timestamp")
|
|
216
|
+
entry = {"domain": by_funnel[f["funnel_id"]]["domain"], "alias": f["alias"], "funnel_id": f["funnel_id"],
|
|
217
|
+
"campaign_refs": f["campaign_ids"], "path_refs": [f["path_id"]], "entry_url": f["url"], "kind": f["purpose"],
|
|
218
|
+
"subscribed_on": intent["occurred_at"][:10], "confirmed": outcomes[eid].get("confirmed") is True,
|
|
219
|
+
"submission_ref": eid, "submission_refs": [eid], "approval_ref": intent["approval_id"],
|
|
220
|
+
"submission_checks": [{"submission_ref": eid, "submitted_at": intent["occurred_at"],
|
|
221
|
+
"path_id": f["path_id"], "campaign_refs": f["campaign_ids"],
|
|
222
|
+
"confirmed": outcomes[eid].get("confirmed") is True, "email_expectations": dict(expectations)}],
|
|
223
|
+
"email_expectations": dict(expectations)}
|
|
224
|
+
prior = subscriptions.get(f["funnel_id"])
|
|
225
|
+
if prior:
|
|
226
|
+
if prior["alias"] != entry["alias"]:
|
|
227
|
+
raise FunnelTeardownError("one physical funnel cannot use different research aliases")
|
|
228
|
+
prior["campaign_refs"] = list(dict.fromkeys(prior["campaign_refs"] + entry["campaign_refs"]))
|
|
229
|
+
prior["path_refs"] = list(dict.fromkeys(prior["path_refs"] + entry["path_refs"]))
|
|
230
|
+
prior["submission_refs"].append(eid)
|
|
231
|
+
prior["submission_checks"].extend(entry["submission_checks"])
|
|
232
|
+
prior["confirmed"] = prior["confirmed"] or entry["confirmed"]
|
|
233
|
+
for key in ("confirmation", "result"):
|
|
234
|
+
values = (prior["email_expectations"].get(key), expectations.get(key))
|
|
235
|
+
prior["email_expectations"][key] = True if True in values else False if all(value is False for value in values) else None
|
|
236
|
+
if expectations.get("wait_until") and EMAIL.timestamp(expectations["wait_until"]) > (EMAIL.timestamp(prior["email_expectations"].get("wait_until")) or EMAIL.timestamp(intent["occurred_at"])):
|
|
237
|
+
prior["email_expectations"]["wait_until"] = expectations["wait_until"]
|
|
238
|
+
else:
|
|
239
|
+
subscriptions[f["funnel_id"]] = entry
|
|
240
|
+
handoff["subscriptions"] = list(subscriptions.values())
|
|
241
|
+
return handoff
|
|
242
|
+
|
|
243
|
+
|
|
244
|
+
def _source_files(workspace, paths):
|
|
245
|
+
result = {}
|
|
246
|
+
for path in paths:
|
|
247
|
+
path = Path(path)
|
|
248
|
+
path = path if path.is_absolute() else workspace / path
|
|
249
|
+
try:
|
|
250
|
+
relative = path.resolve().relative_to(workspace.resolve()).as_posix()
|
|
251
|
+
except ValueError as exc:
|
|
252
|
+
raise FunnelTeardownError("research inputs must be inside the workspace") from exc
|
|
253
|
+
result[relative] = IO.sha256(path) if path.is_file() else None
|
|
254
|
+
return result
|
|
255
|
+
|
|
256
|
+
|
|
257
|
+
def _run(workspace, args):
|
|
258
|
+
runtime = workspace / RUNTIME_REL
|
|
259
|
+
runtime.mkdir(parents=True, exist_ok=True)
|
|
260
|
+
context_path = _path(workspace, _arg(args, "context"), RUNTIME_REL / "research-context.json")
|
|
261
|
+
context = _read(context_path, {})
|
|
262
|
+
if _arg(args, "own_destinations", ""):
|
|
263
|
+
context["own_destinations"] = [url.strip() for url in args.own_destinations.split(",") if url.strip()]
|
|
264
|
+
if _arg(args, "mailbox"):
|
|
265
|
+
context["mailbox"] = args.mailbox
|
|
266
|
+
if _arg(args, "own_destinations", "") or _arg(args, "mailbox"):
|
|
267
|
+
IO.write_json(context_path, context)
|
|
268
|
+
creative_doc, selection, policy = load_upstream(workspace)
|
|
269
|
+
creative_inputs = creative_doc.get("inputs") or {}
|
|
270
|
+
as_of = _arg(args, "as_of", "") or creative_inputs.get("as_of") or creative_doc.get("as_of")
|
|
271
|
+
try:
|
|
272
|
+
date.fromisoformat(as_of)
|
|
273
|
+
except (TypeError, ValueError) as exc:
|
|
274
|
+
raise FunnelTeardownError("04 must publish its campaign cutoff date") from exc
|
|
275
|
+
if _arg(args, "as_of", "") and args.as_of != (creative_inputs.get("as_of") or creative_doc.get("as_of")):
|
|
276
|
+
raise FunnelTeardownError("05 cannot move the pinned 04 campaign cutoff")
|
|
277
|
+
enrichment_path = runtime / "destinations.json"
|
|
278
|
+
enrichment = _read(enrichment_path, {})
|
|
279
|
+
campaigns, gaps = MODEL.prepare_campaigns(selection, creative_doc, policy, as_of, enrichment)
|
|
280
|
+
footprint = _read(workspace / _artifact_path("egbe-docs/research/market/evidence/channel-footprint.json"), {})
|
|
281
|
+
MODEL.bind_activity_provenance(campaigns, footprint, policy)
|
|
282
|
+
MODEL.apply_copy_policy(campaigns, footprint)
|
|
283
|
+
selected_scopes = {(r.get("country"), r.get("channel")) for r in selection.get("selected_creatives", [])}
|
|
284
|
+
countries = (footprint.get("inputs") or {}).get("target_countries", [])
|
|
285
|
+
for observation in footprint.get("rows", []):
|
|
286
|
+
if observation.get("type") != "channel_observation":
|
|
287
|
+
continue
|
|
288
|
+
for country in countries:
|
|
289
|
+
scope = (country, observation.get("channel"))
|
|
290
|
+
if scope not in selected_scopes and not any(g.get("country") == country and g.get("channel") == observation.get("channel") for g in gaps):
|
|
291
|
+
gaps.append({"type": "coverage", "country": country, "channel": observation.get("channel"), "status": "no_selected_campaign",
|
|
292
|
+
"detail": "Observed 03 channel has no selected 04 creative in this market; campaign/destination not extracted",
|
|
293
|
+
"source": "channel_footprint_observation", "tier": "C"})
|
|
294
|
+
equivalence_path = runtime / "equivalences.json"
|
|
295
|
+
equivalence_assets = MODEL.apply_equivalences(campaigns, _read(equivalence_path, {}), workspace)
|
|
296
|
+
candidates = build_candidates(campaigns, context)
|
|
297
|
+
registry_path = workspace / _artifact_path("egbe-docs/research/market/work/identity-registry.json")
|
|
298
|
+
registry = _read(registry_path, {})
|
|
299
|
+
identity_binding = None
|
|
300
|
+
mailbox = context.get("mailbox") or registry.get("mailbox")
|
|
301
|
+
if mailbox:
|
|
302
|
+
with IO.file_lock(registry_path.with_name(registry_path.name + ".lock")):
|
|
303
|
+
registry = MODEL.allocate_identities(_read(registry_path), mailbox, campaigns)
|
|
304
|
+
IO.write_json(registry_path, registry)
|
|
305
|
+
aliases = {r["funnel_id"]: r["alias"] for r in registry["identities"] if r.get("funnel_id")}
|
|
306
|
+
for campaign in campaigns:
|
|
307
|
+
if not any(row.get("funnel_id") == campaign["funnel_id"] and row.get("domain") == campaign["domain"] for row in registry["identities"]):
|
|
308
|
+
raise FunnelTeardownError("stable funnel identity conflicts with its competitor domain")
|
|
309
|
+
identity_binding = INTEGRITY.identity_binding(registry, funnel_ids=[c["funnel_id"] for c in campaigns])
|
|
310
|
+
for c in candidates:
|
|
311
|
+
if c["role"] != "own":
|
|
312
|
+
c["planned_alias"] = aliases[c["funnel_id"]]
|
|
313
|
+
source_paths = [CREATIVE_PATTERNS_EVIDENCE_REL, creative_inputs.get("creative_selection_path") or _artifact_path("egbe-docs/research/market/evidence/creative-selection.v1.json"),
|
|
314
|
+
_artifact_path("egbe-docs/research/market/evidence/channel-footprint.json"), _artifact_path("egbe-docs/research/market/evidence/competitors.json"),
|
|
315
|
+
_artifact_path("egbe-docs/research/market/work/creative_patterns/request.json"), _artifact_path("egbe-docs/research/market/work/channel_footprint/request.json"),
|
|
316
|
+
_artifact_path("egbe-docs/research/market/work/competitor_set/request.json"), IO.context_path(SECTION_ID), context_path, enrichment_path, equivalence_path]
|
|
317
|
+
resume_inputs = {"source_files": _source_files(workspace, source_paths), "research_context_sha256": MODEL.canonical_hash(context),
|
|
318
|
+
"creative_patterns_sha256": IO.sha256(workspace / CREATIVE_PATTERNS_EVIDENCE_REL),
|
|
319
|
+
"creative_selection_sha256": creative_inputs.get("creative_selection_sha256"), "effective_policy": policy,
|
|
320
|
+
"policy_sha256": MODEL.canonical_hash(policy), "campaign_as_of": as_of, "walk_contract": MODEL.CONTRACT,
|
|
321
|
+
"angle_dictionary_sha256": (creative_doc.get("angle_dictionary") or {}).get("dictionary_sha256")}
|
|
322
|
+
if identity_binding is not None:
|
|
323
|
+
resume_inputs["identity_registry_binding"] = identity_binding
|
|
324
|
+
inputs_sha = MODEL.canonical_hash(resume_inputs)
|
|
325
|
+
inputs = {k: v for k, v in resume_inputs.items() if k != "source_files"}
|
|
326
|
+
inputs.update(resume_inputs=resume_inputs, inputs_sha256=inputs_sha, research_context=IO.context_binding(workspace, SECTION_ID),
|
|
327
|
+
creative_selection_path=creative_inputs.get("creative_selection_path"), research_context_sha256=MODEL.canonical_hash(context), viewport=WALK_VIEWPORT)
|
|
328
|
+
walks_path = _path(workspace, _arg(args, "walks"), RUNTIME_REL / WALKS_FILENAME)
|
|
329
|
+
IO.write_json(runtime / CANDIDATES_FILENAME, {"schema_version": 2, "section_id": SECTION_ID, "contract": MODEL.CONTRACT,
|
|
330
|
+
"inputs_sha256": inputs_sha, "campaign_as_of": as_of, "walks_path": walks_path.as_posix(), "viewport": WALK_VIEWPORT,
|
|
331
|
+
"candidates": candidates, "campaigns": campaigns, "coverage": gaps,
|
|
332
|
+
"rules": ["Walk every selected distinct funnel; preserve unfinished work for resume.",
|
|
333
|
+
"Real mobile screenshots and hashes per screen. Main route and auxiliary popups are separate.",
|
|
334
|
+
"Review pixels for contacts and private verification URLs; keep raw captures private and declare real privacy-redacted display derivatives where needed. Hashes do not sanitize pixels.",
|
|
335
|
+
"Exact forms/data require human chat confirmation; supplements for new fields. Journal intent before sending.",
|
|
336
|
+
"No account creation, payment/card entry, CAPTCHA bypass or live sales call booking. Own funnels never submit.",
|
|
337
|
+
"Stable aliases; same-day email capture; explicit pending and unknown downstream."]})
|
|
338
|
+
defaults = {"approval-plan.json": {"schema_version": 2, "forms": []}, "approvals.json": {"schema_version": 2, "approvals": []}, "submissions.json": {"schema_version": 2, "events": []}}
|
|
339
|
+
for name, value in defaults.items():
|
|
340
|
+
if not (runtime / name).exists():
|
|
341
|
+
IO.write_json(runtime / name, value)
|
|
342
|
+
state = {"schema_version": 1, "section_id": SECTION_ID, "status": "pending", "error": None, "as_of": as_of,
|
|
343
|
+
"inputs_sha256": inputs_sha, "policy_sha256": inputs["policy_sha256"], "research_context": inputs["research_context"],
|
|
344
|
+
"candidates_path": (RUNTIME_REL / CANDIDATES_FILENAME).as_posix(), "walks_path": walks_path.as_posix(),
|
|
345
|
+
"unwalked": [c["funnel_id"] for c in candidates], "provider_calls": 0, "documents": 0,
|
|
346
|
+
"domains": list(dict.fromkeys(c["domain"] for c in campaigns))}
|
|
347
|
+
if identity_binding is not None:
|
|
348
|
+
state["identity_registry_binding"] = identity_binding
|
|
349
|
+
missing = []
|
|
350
|
+
if not context.get("persona", {}).get("id") or not context.get("persona", {}).get("name"):
|
|
351
|
+
missing.append("explicit buyer persona from offer card")
|
|
352
|
+
if not context.get("own_destinations"):
|
|
353
|
+
missing.append("own destination URLs from intake/product context")
|
|
354
|
+
walks_doc = _read(walks_path)
|
|
355
|
+
if missing or walks_doc is None or _arg(args, "phase", "auto") == "prepare":
|
|
356
|
+
state["reason"] = "Missing " + ", ".join(missing) if missing else "Browser observations required; read candidates and the v2 walk contract"
|
|
357
|
+
IO.write_json(runtime / "request.json", state)
|
|
358
|
+
return state
|
|
359
|
+
if walks_doc.get("schema_version") != 2:
|
|
360
|
+
state.update(reason="Legacy walks: preserve raw evidence, collect fresh screenshots and deep paths", legacy=True)
|
|
361
|
+
IO.write_json(runtime / "request.json", state)
|
|
362
|
+
return state
|
|
363
|
+
plans, approvals, journal = (_read(runtime / name) for name in defaults)
|
|
364
|
+
checkpoint_path = runtime / "journal-checkpoint.json"
|
|
365
|
+
checkpoint = MODEL.validate_append_only(_read(checkpoint_path, {}), plans, approvals, journal)
|
|
366
|
+
intents, outcomes = MODEL.validate_journals(plans, approvals, journal, candidates, registry)
|
|
367
|
+
IO.write_json(checkpoint_path, checkpoint)
|
|
368
|
+
walks = MODEL.attach_campaigns(MODEL.validate_walks(walks_doc, candidates, workspace, inputs_sha, intents, outcomes), campaigns)
|
|
369
|
+
allowed_personas = {context["persona"]["id"], *(p.get("id") for p in context.get("additional_personas", []))}
|
|
370
|
+
for walk in walks:
|
|
371
|
+
if walk["path_id"] == "buyer" and walk["persona_id"] != context["persona"]["id"]:
|
|
372
|
+
raise FunnelTeardownError("primary path persona must match the agreed buyer context")
|
|
373
|
+
if walk["persona_id"] not in allowed_personas:
|
|
374
|
+
raise FunnelTeardownError("additional persona must be explicitly declared in research context")
|
|
375
|
+
email_path = workspace / _artifact_path("egbe-docs/research/market/work/lifecycle_capture/funnel-events.json")
|
|
376
|
+
email_doc = _read(email_path, {"events": [], "pending": []})
|
|
377
|
+
for w in walks:
|
|
378
|
+
w["email_events"] = [e for e in email_doc.get("events", []) if e.get("funnel_id") == w["funnel_id"] and e.get("path_id") in (None, w["path_id"])]
|
|
379
|
+
handoff = lifecycle_handoff(intents, outcomes, _read(runtime / "lifecycle-handoff.json"), candidates, walks)
|
|
380
|
+
IO.write_json(runtime / "lifecycle-handoff.json", handoff)
|
|
381
|
+
email_coverage = []
|
|
382
|
+
for subscription in handoff["subscriptions"]:
|
|
383
|
+
review = EMAIL.review(subscription, email_doc)
|
|
384
|
+
for w in walks:
|
|
385
|
+
if w["funnel_id"] == subscription["funnel_id"]:
|
|
386
|
+
w["email_review"] = review
|
|
387
|
+
if review["pending"] or review["gaps"]:
|
|
388
|
+
email_coverage.append({"type": "coverage", "funnel_id": subscription["funnel_id"],
|
|
389
|
+
"campaign_ids": subscription["campaign_refs"], "status": "needs_email" if review["pending"] else "email_coverage_gap",
|
|
390
|
+
"detail": review["detail"], "gaps": review["gaps"], "unknown": review["unknown"],
|
|
391
|
+
"terminal": not review["pending"], "source": "same_day_lifecycle_handoff", "tier": "C"})
|
|
392
|
+
by_funnel = {}
|
|
393
|
+
for w in walks:
|
|
394
|
+
by_funnel.setdefault(w["funnel_id"], []).append(w)
|
|
395
|
+
pending, coverage = [item["funnel_id"] for item in email_coverage if not item["terminal"]], list(gaps) + email_coverage
|
|
396
|
+
for c in candidates:
|
|
397
|
+
paths = by_funnel.get(c["funnel_id"], [])
|
|
398
|
+
main = next((w for w in paths if w["path_id"] == c["primary_path_id"]), None)
|
|
399
|
+
if not main:
|
|
400
|
+
pending.append(c["funnel_id"])
|
|
401
|
+
status, detail = "queued", "Selected primary buyer path has not been observed"
|
|
402
|
+
elif any((w["status"] in MODEL.PENDING_STATUSES and
|
|
403
|
+
(w["status"] != "needs_email" or w.get("email_review", {}).get("pending", True)))
|
|
404
|
+
or w["stop_reason"] == "budget" for w in paths):
|
|
405
|
+
pending.append(c["funnel_id"])
|
|
406
|
+
status, detail = main["status"], "; ".join(main["unknown"]) or main["stop_reason"]
|
|
407
|
+
else:
|
|
408
|
+
status, detail = main["status"], main["stop_reason"]
|
|
409
|
+
missing_paths = [point.get("alternate_path_id") for w in paths for point in w.get("branch_points", [])
|
|
410
|
+
if point.get("meaningful_change") is True and not any(other["path_id"] == point.get("alternate_path_id") for other in paths)]
|
|
411
|
+
if missing_paths:
|
|
412
|
+
pending.append(c["funnel_id"])
|
|
413
|
+
status, detail = "queued", "Additional relevant offer/result/conversion branches need observation: " + ", ".join(str(x) for x in missing_paths)
|
|
414
|
+
coverage.append({"type": "coverage", "funnel_id": c["funnel_id"], "campaign_ids": c["campaign_ids"], "creative_ids": c["creative_ids"],
|
|
415
|
+
"domain": c["domain"], "role": c["role"], "country": c.get("country"), "channel": c["channel"], "source": "browser_walk",
|
|
416
|
+
"status": status, "detail": detail, "tier": "C" if status != "completed" else "A"})
|
|
417
|
+
uncertain = [eid for eid in intents if outcomes.get(eid, {}).get("outcome") in (None, "unknown")]
|
|
418
|
+
if uncertain:
|
|
419
|
+
pending += [intents[eid]["form"]["funnel_id"] for eid in uncertain]
|
|
420
|
+
coverage.append({"type": "coverage", "status": "submission_outcome_unknown", "detail": "Inspect already attempted submission before retry",
|
|
421
|
+
"submission_refs": uncertain, "source": "submission_journal", "tier": "C"})
|
|
422
|
+
patterns, pages = MODEL.aggregate_patterns(campaigns, walks), landing_rows(walks)
|
|
423
|
+
assets = equivalence_assets + [asset for w in walks for s in w["screens"] for asset in [s["screenshot"], *s.get("screenshots", [])]]
|
|
424
|
+
source_files = _source_files(workspace, source_paths + [walks_path, email_path, runtime / "lifecycle-handoff.json",
|
|
425
|
+
checkpoint_path, *(runtime / name for name in defaults), *(a["path"] for a in assets),
|
|
426
|
+
*(s["source_screenshot"]["path"] for w in walks for s in w["screens"] if s.get("source_screenshot"))])
|
|
427
|
+
inputs.update(source_files=source_files, assets=assets)
|
|
428
|
+
inputs["resume_inputs"] = resume_inputs
|
|
429
|
+
private = private_contact_values(context, registry, mailbox, plans)
|
|
430
|
+
if any(MODEL.private_identifier_in_reference(path, private) for path in inputs["source_files"]):
|
|
431
|
+
raise FunnelTeardownError("private contact identifier in a pinned source filename; use a safely named capture before publication")
|
|
432
|
+
rows = MODEL.redact(campaigns + pages + walks + patterns + coverage, private)
|
|
433
|
+
document = {"schema_version": 2, "section_id": SECTION_ID, "generated_by": "run-funnel-teardown.py", "retrieved_on": date.today().isoformat(),
|
|
434
|
+
"inputs": inputs, "rows": rows, "totals": {"campaigns": len(campaigns), "selected_funnels": len(candidates), "landing_pages": len(pages),
|
|
435
|
+
"walks": len(walks), "patterns": len(patterns), "pending": len(set(pending)), "observations": sum(len(w["screens"]) for w in walks), "documents": 0, "provider_calls": 0}}
|
|
436
|
+
IO.write_json(workspace / EVIDENCE_REL, document)
|
|
437
|
+
section = render_section(campaigns=[r for r in rows if r["type"] == "campaign"], walks=[r for r in rows if r["type"] == "funnel_walk"],
|
|
438
|
+
patterns=[r for r in rows if r["type"] == "funnel_pattern"], coverage=[r for r in rows if r["type"] == "coverage"], as_of=as_of)
|
|
439
|
+
IO.write_atomic(runtime / "result.md", section)
|
|
440
|
+
report = workspace / REPORT_REL
|
|
441
|
+
report.parent.mkdir(parents=True, exist_ok=True)
|
|
442
|
+
_load_script("upsert-markdown-section.py", "pmr_funnel_upsert").upsert_markdown_section(report, SECTION_HEADING, section)
|
|
443
|
+
state.update(unwalked=sorted(set(pending)), walks=len(walks), patterns=len(patterns), landing_pages=len(pages), pages_read=len(pages),
|
|
444
|
+
observations=document["totals"]["observations"], source_files=source_files, assets=assets,
|
|
445
|
+
evidence_path=EVIDENCE_REL.as_posix(), evidence_sha256=IO.sha256(workspace / EVIDENCE_REL), result_path=(RUNTIME_REL / "result.md").as_posix(),
|
|
446
|
+
result_sha256=IO.sha256(runtime / "result.md"), walks_sha256=IO.sha256(walks_path))
|
|
447
|
+
if pending:
|
|
448
|
+
state["reason"] = "Selected paths need continuation, approval, email or submission-outcome verification"
|
|
449
|
+
else:
|
|
450
|
+
persistence = _load_script("persist-research-report.py", "pmr_funnel_persist").persist_research_report(workspace,
|
|
451
|
+
commit_message="research: update funnel teardown section", extra_paths=(Path(_artifact_path("egbe-docs/research/market/evidence/funnel-teardown.json")),))
|
|
452
|
+
state.update(status="completed", reason=None, publication_mode=persistence.publication_mode, report_commit_sha=persistence.commit_sha)
|
|
453
|
+
IO.write_json(runtime / "as-of.json", {"as_of": as_of, "completed": True})
|
|
454
|
+
IO.write_json(runtime / "request.json", state)
|
|
455
|
+
return state
|
|
456
|
+
|
|
457
|
+
|
|
458
|
+
def run(workspace, args):
|
|
459
|
+
workspace = Path(workspace).resolve()
|
|
460
|
+
with IO.section_attempt(workspace, SECTION_ID, context_file=getattr(args, "context_file", None)):
|
|
461
|
+
try:
|
|
462
|
+
return _run(workspace, args)
|
|
463
|
+
except UpstreamPending as exc:
|
|
464
|
+
state = {"schema_version": 1, "section_id": SECTION_ID, "status": "pending", "error": None,
|
|
465
|
+
"research_context": IO.context_binding(workspace, SECTION_ID),
|
|
466
|
+
"reason": str(exc), "unwalked": [], "provider_calls": 0}
|
|
467
|
+
IO.write_json(workspace / RUNTIME_REL / "request.json", state)
|
|
468
|
+
return state
|
|
469
|
+
|
|
470
|
+
|
|
471
|
+
def main():
|
|
472
|
+
parser = argparse.ArgumentParser(description=__doc__)
|
|
473
|
+
parser.add_argument("--workspace", required=True, type=Path)
|
|
474
|
+
parser.add_argument("--context-file", type=Path, help="Explicit additional research context; optional for this operation.")
|
|
475
|
+
parser.add_argument("--phase", choices=("auto", "prepare", "finalize"), default="auto")
|
|
476
|
+
parser.add_argument("--context", default="", help="Private context with persona and own destinations")
|
|
477
|
+
parser.add_argument("--own-destinations", default="", help="Explicit comma-separated own HTTP(S) URLs")
|
|
478
|
+
parser.add_argument("--mailbox", default="", help="Base research mailbox, otherwise use identity registry")
|
|
479
|
+
parser.add_argument("--walks", default="")
|
|
480
|
+
parser.add_argument("--as-of", default="", help="Must equal the pinned 04 cutoff")
|
|
481
|
+
parser.add_argument("--product-domain", default="", help="Invocation compatibility; own destinations must be explicit")
|
|
482
|
+
args = parser.parse_args()
|
|
483
|
+
try:
|
|
484
|
+
state = run(args.workspace, args)
|
|
485
|
+
except (FunnelTeardownError, ValueError, OSError) as exc:
|
|
486
|
+
print(f"{DISPLAY_NAME}: {exc}", file=sys.stderr)
|
|
487
|
+
return 1
|
|
488
|
+
print(json.dumps({k: state.get(k) for k in ("status", "reason", "unwalked", "walks", "patterns")}, indent=2))
|
|
489
|
+
return 2 if state["status"] == "pending" else 0
|
|
490
|
+
|
|
491
|
+
|
|
492
|
+
if __name__ == "__main__":
|
|
493
|
+
raise SystemExit(main())
|