@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,184 @@
|
|
|
1
|
+
# Funnel Teardown
|
|
2
|
+
|
|
3
|
+
Internal section 05 inspects the creative sample selected in 04. Its unit is
|
|
4
|
+
creative + channel + market + verified destination + observed buyer path.
|
|
5
|
+
Never run a separate weight ranking or use accessible homepages to fill
|
|
6
|
+
unknown ad destinations. Every distinct selected funnel is investigated;
|
|
7
|
+
unfinished work is resumed, not silently capped.
|
|
8
|
+
|
|
9
|
+
## 1. Prepare the inputs
|
|
10
|
+
|
|
11
|
+
Require completed current 01/03/04 publications and the canonical 04
|
|
12
|
+
`creative-selection.v1.json` manifest. Use buyer/offer-card context from 01,
|
|
13
|
+
explicit own destination URLs from intake/product context and the shared
|
|
14
|
+
research mailbox identity registry. Keep concrete product routes, persona names
|
|
15
|
+
and mailbox values in runtime, not in this skill.
|
|
16
|
+
|
|
17
|
+
Write `egbe-docs/research/market/work/funnel_teardown/research-context.json`, for example:
|
|
18
|
+
|
|
19
|
+
```json
|
|
20
|
+
{
|
|
21
|
+
"persona": {"id": "buyer", "name": "Sam Researcher", "buyer_context": "The agreed buyer and offer card"},
|
|
22
|
+
"own_destinations": [{"url": "https://product.example/start", "country": "US"}],
|
|
23
|
+
"mailbox": "research@example.org"
|
|
24
|
+
}
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
BUNDLE=/path/to/product-market-research
|
|
29
|
+
WS=/path/to/product-workspace
|
|
30
|
+
python3 "$BUNDLE/scripts/run-funnel-teardown.py" --workspace "$WS" --phase prepare
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Prepare is deterministic and makes no provider calls or plain fetches. It pins
|
|
34
|
+
04, policy, manifest and context, writes `candidates.json`, allocates stable
|
|
35
|
+
per-funnel aliases under the shared registry lock, creates empty private form
|
|
36
|
+
journals and exits 2. Missing persona/own destinations remain explicit pending
|
|
37
|
+
inputs; the runner does not infer `/backend` or a competitor's generic page.
|
|
38
|
+
The campaign cutoff is inherited from 04 and does not advance with browser or
|
|
39
|
+
email observation time.
|
|
40
|
+
|
|
41
|
+
For selected creatives missing destination, perform a bounded source lookup:
|
|
42
|
+
open the native ad and its visible CTA or read native destination metadata;
|
|
43
|
+
use Google/SpyFu ad-history rows attributable to that selected ad. Follow the assigned
|
|
44
|
+
scope and preserve channel/market identity. Record attempts,
|
|
45
|
+
source availability and candidate URLs in `destinations.json`; promote only a
|
|
46
|
+
verified ad-to-URL relation under the contract. YouTube description and LinkedIn
|
|
47
|
+
site links remain candidates until that relation is established. If bounded
|
|
48
|
+
lookup fails, keep `destination_unknown` with the actual reason and source refs.
|
|
49
|
+
Reprepare after enrichment; enrichment may fill URLs, not change the selected
|
|
50
|
+
campaigns or their upstream sample.
|
|
51
|
+
|
|
52
|
+
## 2. Scout, list forms and obtain human confirmation
|
|
53
|
+
|
|
54
|
+
Open entries in a real browser at 390×844 without sending contact forms.
|
|
55
|
+
Identify the main CTA implied by the creative and scout available steps. Capture
|
|
56
|
+
real screenshots and page content, including lower-page proof/price blocks.
|
|
57
|
+
Keep consent and optional discount popups separate from the main route.
|
|
58
|
+
Preserve HTTP(S) ad entries and record an observed redirect chain when the
|
|
59
|
+
browser opens another URL; a redirect is not permission to merge destinations.
|
|
60
|
+
|
|
61
|
+
Prepare one combined list of known forms with exact fields, data, aliases,
|
|
62
|
+
competitor/campaign/funnel/path, purpose and screenshot reference. Populate
|
|
63
|
+
`approval-plan.json` following the v2 contract. Present that concrete list to
|
|
64
|
+
the founder and wait for actual confirmation. Record the human chat reference
|
|
65
|
+
and exact fingerprints in `approvals.json`. A JSON file you wrote is not human
|
|
66
|
+
confirmation. New forms, fields or data require a supplement and new approval.
|
|
67
|
+
|
|
68
|
+
A caller that sends no forms skips the list and
|
|
69
|
+
the approval: each walk captures the first contact screen with its fields and
|
|
70
|
+
stops there as `boundary` / `form_not_submitted`. Nothing is submitted, so no
|
|
71
|
+
mail check follows.
|
|
72
|
+
|
|
73
|
+
## 3. Walk deeply and preserve progress
|
|
74
|
+
|
|
75
|
+
The bundled driver keeps one mobile Chrome (390×844) open for the whole walk
|
|
76
|
+
and records each screen where the report can publish it:
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
python3 "$BUNDLE/scripts/walk-funnels.py" serve --workspace "$WS" &
|
|
80
|
+
python3 "$BUNDLE/scripts/walk-funnels.py" call open '{"funnel_id": "<id>", "url": "<address>"}'
|
|
81
|
+
python3 "$BUNDLE/scripts/walk-funnels.py" call screen '{"funnel_id": "<id>", "screen_id": "s01-landing", "kind": "landing", "slices": 2,
|
|
82
|
+
"fields": {"headline": "...", "cta": "...", "offer": "...", "amounts": [], "notes": "..."}}'
|
|
83
|
+
python3 "$BUNDLE/scripts/walk-funnels.py" call click '{"funnel_id": "<id>", "text": "Get started"}'
|
|
84
|
+
python3 "$BUNDLE/scripts/walk-funnels.py" call finish '{"funnel_id": "<id>", "status": "boundary", "stop_reason": "form_not_submitted", "unknown": ["..."]}'
|
|
85
|
+
python3 "$BUNDLE/scripts/walk-funnels.py" build --workspace "$WS"
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
Every answer returns the page's text, inputs and buttons for the next
|
|
89
|
+
decision. Screenshots land under `egbe-docs/research/market/assets/funnel-teardown/`,
|
|
90
|
+
records under the runtime's `records/`; `build` writes `walks.json` from them.
|
|
91
|
+
|
|
92
|
+
Read [`funnel-teardown.md`](../contracts/funnel-teardown.md) and the shared
|
|
93
|
+
mechanics JSON. Answer as the agreed buyer; record the actual answers per screen
|
|
94
|
+
and visible branch points. Investigate additional relevant paths only where the
|
|
95
|
+
offer, final result, price or conversion changes. Capture screenshots of every
|
|
96
|
+
logical screen, not fabricated placeholders. One real immediate gate is valid.
|
|
97
|
+
Review every screenshot for visible contact values, personalized names/phones
|
|
98
|
+
and private verification URLs. Capture before filling where possible. If a
|
|
99
|
+
later screen echoes private data, keep the original in private runtime and
|
|
100
|
+
declare a real privacy-redacted display derivative with source hash and
|
|
101
|
+
derivation; never treat a file hash as pixel sanitization or invent an observed
|
|
102
|
+
screen. Include lower-page captures in the same privacy review.
|
|
103
|
+
|
|
104
|
+
Before sending an approved lead/quiz/webinar form, append a submission intent.
|
|
105
|
+
Then submit exactly the approved data and record the browser response. Continue
|
|
106
|
+
after contact requests. If a crash leaves outcome unknown, inspect existing
|
|
107
|
+
state before any retry; preserve uncertainty until resolved. Resume must never
|
|
108
|
+
re-register automatically or allocate another alias for that funnel.
|
|
109
|
+
Keep all prior form revisions, approvals and submission events append-only.
|
|
110
|
+
An observed failed attempt needs a new human approval before a retry.
|
|
111
|
+
|
|
112
|
+
Complete permitted registrations and quizzes. Stop before creating an account,
|
|
113
|
+
payment/card entry, CAPTCHA/bot verification, required SMS, or booking a live
|
|
114
|
+
sales rep. Record account gate as `needs_account`; continue only after the
|
|
115
|
+
authorized account holder supplies access, recorded with a human chat reference.
|
|
116
|
+
A fictional full US phone ending 555-0100–0199 is used only if approved and
|
|
117
|
+
accepted; otherwise record a phone block. Own destinations
|
|
118
|
+
are walked under the same contract, with no sending or booking.
|
|
119
|
+
|
|
120
|
+
After 40 captured screens in an attempt, save a budget checkpoint and resume
|
|
121
|
+
under a new attempt ID. Persist full `walks.json` paths and journals. Do not
|
|
122
|
+
reinterpret a checkpoint or the contact screen as the funnel's terminal outcome.
|
|
123
|
+
Unknown, absent and not applicable differ; a teaser role/result example does
|
|
124
|
+
not count as the final personalized quiz result.
|
|
125
|
+
|
|
126
|
+
Read confirmation/result email through 02's same-day handoff, using the same
|
|
127
|
+
alias and funnel/campaign refs. Confirmation links can be followed only within
|
|
128
|
+
the approved registration's purpose. Do not expose private tokenized email URLs.
|
|
129
|
+
A received mail is a separate evidence event, not a website screenshot. Mail
|
|
130
|
+
waiting and terminal coverage gaps do not change the advertising cutoff or
|
|
131
|
+
the observed browser result.
|
|
132
|
+
Record `email_expectations` on the submitted path: `confirmation` and `result`
|
|
133
|
+
are true, false or unknown, with an actual `browser:<screen_id>` source for
|
|
134
|
+
known expectations. Finalize once to write the private handoff, then run:
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
python3 "$BUNDLE/scripts/run-lifecycle-capture.py" --workspace "$WS" --funnel-mail --refresh
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
Each new approved registration needs a successful attributable inbox check
|
|
141
|
+
after its latest submission on the same recorded local day. An earlier cached
|
|
142
|
+
snapshot does not satisfy it. Received confirmation is not confirmed; unknown
|
|
143
|
+
expectations remain visible as unknown. A successful attributable query closes
|
|
144
|
+
unknown expectations as `email_expectation_undetermined`. If the submission day
|
|
145
|
+
has already passed without its first check, record `same_day_check_missed`;
|
|
146
|
+
do not repeat the submission. Expected mail remains pending until its observed
|
|
147
|
+
`email_expectations.wait_until` (aware timestamp with the browser promise
|
|
148
|
+
source), otherwise the existing 14-day Lifecycle Capture boundary. Refresh the
|
|
149
|
+
inbox at that boundary before recording missing mail as a terminal coverage
|
|
150
|
+
gap. This does not complete an unseen final result or confirmation. Explicit
|
|
151
|
+
no-email expectations still require the inbox check and then record that review.
|
|
152
|
+
|
|
153
|
+
## 4. Validate and finalize
|
|
154
|
+
|
|
155
|
+
```bash
|
|
156
|
+
python3 "$BUNDLE/scripts/run-funnel-teardown.py" --workspace "$WS" --phase finalize
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
The runner validates hashes, mobile observations, exact approvals/data, intent
|
|
160
|
+
and outcome ordering, permitted boundaries, own no-submit, persona paths and
|
|
161
|
+
market scope. Queue/budget/approval/email/uncertain-submit states exit 2 and
|
|
162
|
+
retain all progress. A generic shortfall sentence cannot waive missing selected
|
|
163
|
+
paths. Legacy v1 is reported explicitly and requires fresh browser evidence.
|
|
164
|
+
|
|
165
|
+
Evidence v2 contains campaign lineage, browser page/screens, per-path walks,
|
|
166
|
+
country/channel patterns and specific coverage. Native delivery durations and
|
|
167
|
+
observed current activity remain separate; neither is a success verdict or a
|
|
168
|
+
copy recommendation. Shares count unique campaigns with known features and
|
|
169
|
+
show unknown counts; recurrence counts competitors, never paths. Own observations
|
|
170
|
+
and market mismatches remain visible but do not enter competitor aggregates.
|
|
171
|
+
|
|
172
|
+
The report renders both A (selected creative → campaign → every observed screen)
|
|
173
|
+
and B (per-channel/market funnel types, structure and category-angle links),
|
|
174
|
+
with screenshots, reached outcomes, boundaries, gaps and own comparison.
|
|
175
|
+
The runner writes the canonical evidence and report, pins all used sources and
|
|
176
|
+
assets, and persists the docs publication only when no active research remains.
|
|
177
|
+
Managed publication uses the established docs persistence; local workspaces
|
|
178
|
+
remain local. When sharing research, include its declared public assets and
|
|
179
|
+
preserve source references and gaps.
|
|
180
|
+
|
|
181
|
+
Replicate the observed structure and conversion sequence, never competitor
|
|
182
|
+
copy, claims or numbers. Advertising persistence does not establish measured
|
|
183
|
+
conversion or causal effectiveness. Borrowing another channel's structure must
|
|
184
|
+
be explicit in the planner and cannot prove a destination in the target channel.
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# Geography comparison
|
|
2
|
+
|
|
3
|
+
Read `../contracts/research-artifacts.md`, the prepared assignment, and the recommendation
|
|
4
|
+
reason when present. This selected workflow compares plausible markets for the
|
|
5
|
+
**next test**; it does not change the founder's chosen market, PRD or campaigns.
|
|
6
|
+
It can also run standalone after launch. Do not start another research section.
|
|
7
|
+
|
|
8
|
+
## Assignment and source scope
|
|
9
|
+
|
|
10
|
+
Use the question, country scope and criteria from the project method/current
|
|
11
|
+
task. Comparison and conditional recommendations are allowed; do not choose
|
|
12
|
+
a new business goal or assume authority to change a launch market. Preserve
|
|
13
|
+
explicit founder constraints separately from preferences or evidence.
|
|
14
|
+
|
|
15
|
+
## Reuse evidence, then fill assigned gaps
|
|
16
|
+
|
|
17
|
+
From the workspace root, resolve `<skill-root>` to this extracted bundle:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
python <skill-root>/scripts/geography-comparison.py --workspace . --prepare
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Pass `--context-file <selected-context>` when the comparison needs provider-safe
|
|
24
|
+
background beyond the explicit assignment; do not pass unrelated project material.
|
|
25
|
+
|
|
26
|
+
Read `egbe-docs/research/market/work/geography_comparison/context.json`. The command returns
|
|
27
|
+
its SHA-256 for the comparison input. It includes only receipt-validated public
|
|
28
|
+
research as usable evidence; failed and unavailable sections remain explicit
|
|
29
|
+
gaps. Valid prior research can be reused even if it is not selected for new
|
|
30
|
+
collection. It makes no provider calls. Re-running refreshes changed inputs
|
|
31
|
+
and invalidates old completion; unchanged context resumes without recollection.
|
|
32
|
+
Keep prior search results/notes under this section's runtime directory for reuse.
|
|
33
|
+
|
|
34
|
+
Compare the assigned criteria using compatible measurement definitions and
|
|
35
|
+
reference periods. Unknown cells stay unknown. Do not combine overlapping
|
|
36
|
+
populations, incomparable CPCs or independent budget scenarios.
|
|
37
|
+
|
|
38
|
+
For gaps relevant to the assigned question, read the live OS `/search/skill` and
|
|
39
|
+
use targeted `POST /search/web/brave` queries per country and question, including
|
|
40
|
+
local-language queries and relevant official domains. Read original pages before
|
|
41
|
+
using decisive facts; snippets are discovery leads. Use available page-reading
|
|
42
|
+
tools; where extraction needs OS, discover `/scrape/skill` and use a bounded
|
|
43
|
+
actor only within the authorized budget. Do not invent a fetch endpoint or
|
|
44
|
+
use direct provider keys. Save source links, dates/periods and material excerpts.
|
|
45
|
+
|
|
46
|
+
Agree with or stay within the caller's research budget. Search the narrowest
|
|
47
|
+
decisive gaps first and stop when another query is unlikely to change the next
|
|
48
|
+
test, or the budget is reached. If budget/sources are insufficient, publish an
|
|
49
|
+
uncertain comparison with a concrete next check. Do not run every PMR section
|
|
50
|
+
for every country or send one giant "compare 12 markets" OS Research request.
|
|
51
|
+
This workflow is agent-led synthesis, not another OS Research job; do not create
|
|
52
|
+
a fake job ID or perform the OS Research Completion Review.
|
|
53
|
+
|
|
54
|
+
Brave search regions are not arbitrary ISO countries; follow the search skill's
|
|
55
|
+
country guidance. Places is optional discovery of local companies, never a
|
|
56
|
+
complete company count. Perplexity is not a prerequisite or an automatic fallback.
|
|
57
|
+
Provider failures are limitations, not evidence against a country; preserve
|
|
58
|
+
successful work and do not repeatedly spend to fill every cell.
|
|
59
|
+
|
|
60
|
+
## Compare and publish
|
|
61
|
+
|
|
62
|
+
Write a temporary input JSON using
|
|
63
|
+
[`../contracts/geography-comparison.md`](../contracts/geography-comparison.md).
|
|
64
|
+
Keep claims and interpretation separate. Prefer original regulators/registries,
|
|
65
|
+
transparent datasets and product outcomes; vendor material is interested
|
|
66
|
+
evidence. Preserve the same measurement definitions and reference periods.
|
|
67
|
+
|
|
68
|
+
When the assignment asks for a recommendation, explain it conditionally and
|
|
69
|
+
what could change it. Otherwise keep both recommendation country fields null
|
|
70
|
+
and report the comparison. Do not claim approval or rewrite launch geography.
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
python <skill-root>/scripts/geography-comparison.py --workspace . \
|
|
74
|
+
--input <temporary-comparison.json>
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
The helper validates structure/references, renders only `## Geography comparison`
|
|
78
|
+
in `egbe-docs/research/market/full-report.md`, and publishes the accompanying analysis at
|
|
79
|
+
`egbe-docs/research/market/evidence/geography-comparison.json`. It marks completion only
|
|
80
|
+
after publication; it cannot establish whether the agent's judgment is correct.
|
|
81
|
+
Publication materializes and verifies local files; Git belongs to the caller's
|
|
82
|
+
normal project workflow. A receipt does not claim a commit or remote publication.
|
|
83
|
+
Retry a failed publication with the same input; do not repeat searches. If inputs
|
|
84
|
+
changed, prepare again and review the comparison against the refreshed context.
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# Keyword Economics
|
|
2
|
+
|
|
3
|
+
Read `../contracts/research-artifacts.md` and the prepared assignment (plus the
|
|
4
|
+
recommendation artifact when relevant). This section uses NO OS Research job
|
|
5
|
+
and no free-form web research: every number comes from metered DataForSEO
|
|
6
|
+
calls made by the bundled deterministic runner, and the section body plus its
|
|
7
|
+
machine-readable evidence file are rendered by that runner. Do not write or
|
|
8
|
+
edit section prose, tables, or the evidence file by hand.
|
|
9
|
+
|
|
10
|
+
## 1. Use the assigned search scope
|
|
11
|
+
|
|
12
|
+
Supply the nonempty phrase list relevant to the caller's question, using the
|
|
13
|
+
assignment's evidence and explicitly supplied scope as context. There is no required
|
|
14
|
+
number of phrases or mix of category/problem/purchase language. The runner
|
|
15
|
+
measures each candidate and records exclusions and coverage; observed search
|
|
16
|
+
volume is not by itself product-fit or willingness-to-pay evidence. Named
|
|
17
|
+
competitor domains may be supplied as seed domains.
|
|
18
|
+
|
|
19
|
+
Translate the assignment's geography and language to Google Ads location and
|
|
20
|
+
language codes and pass them explicitly. If locale is unresolved, establish the
|
|
21
|
+
scope before a paid query; the runner's US/en defaults are not a market choice.
|
|
22
|
+
For several countries, invoke the runner once per country. Locale files live at
|
|
23
|
+
`egbe-docs/research/market/evidence/keyword-economics/<location>-<language>.json`;
|
|
24
|
+
the stable aggregate and report retain all current locales. Rerunning one locale
|
|
25
|
+
does not replace another. Compare locale inputs before combining them; changed
|
|
26
|
+
selected context does not authorize new collection or make old observations
|
|
27
|
+
false. Preserve saved evidence and review applicability rather than blending
|
|
28
|
+
different research scopes or silently refreshing paid data.
|
|
29
|
+
|
|
30
|
+
## 2. Run the deterministic runner
|
|
31
|
+
|
|
32
|
+
From the workspace root, resolve `<skill-root>` to the extracted directory
|
|
33
|
+
containing this skill's `SKILL.md`, then run:
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
python3 <skill-root>/scripts/run-keyword-economics.py \
|
|
37
|
+
--workspace . \
|
|
38
|
+
--seed-keywords "<phrase one>, <phrase two>, <phrase three>, ..." \
|
|
39
|
+
--seed-domains "<competitor.com, other.com — omit flag when none>" \
|
|
40
|
+
--location-code 2840 \
|
|
41
|
+
--language-code en
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
The runner needs `OS_API_KEY` (and optional `OS_URL`) in the environment. It
|
|
45
|
+
expands seeds through Google Ads keyword data, probes the results page for the
|
|
46
|
+
top head keywords (who ranks organically, who pays in the ads block), confirms
|
|
47
|
+
candidate competitors from that demand surface, confirms only those with
|
|
48
|
+
category-relevant SERP evidence (or preserves founder-named domains as
|
|
49
|
+
hypotheses), pulls each confirmed domain's ranked-keyword footprint,
|
|
50
|
+
reports provider forecast estimates, optionally scales them to a supplied
|
|
51
|
+
`--test-budget-usd` scenario, and then:
|
|
52
|
+
|
|
53
|
+
- writes evidence rows to `egbe-docs/research/market/evidence/keyword-economics.json`;
|
|
54
|
+
- materializes the exact section under `## Keyword economics` in
|
|
55
|
+
`egbe-docs/research/market/full-report.md`;
|
|
56
|
+
- verifies the report and evidence together; Git remains caller-owned;
|
|
57
|
+
- records the completed state receipt under
|
|
58
|
+
`egbe-docs/research/market/work/keyword_economics/`.
|
|
59
|
+
|
|
60
|
+
Every upstream response is cached in the runtime directory, so re-running the
|
|
61
|
+
same command replays cached data instead of spending the metered budget again.
|
|
62
|
+
The default forecast covers all eligible seed/expansion candidates up to 1000,
|
|
63
|
+
not a fixed five keywords. Coverage records requested/submitted keywords,
|
|
64
|
+
exclusions and cap omissions. It is an exploratory exact-match scenario, not an
|
|
65
|
+
approved campaign, total reachable demand or a live starting bid. Aggregate
|
|
66
|
+
provider responses describe the set once. US/UK budgets are alternative
|
|
67
|
+
comparisons, not additive allocations. Null/empty forecasts are unavailable,
|
|
68
|
+
not zero demand; budget-scaled clicks are conditional arithmetic.
|
|
69
|
+
|
|
70
|
+
The DataForSEO forecast endpoint requires whole-dollar bids. For the automatic
|
|
71
|
+
exploratory forecast, the runner rounds its observed CPC assumption up to the
|
|
72
|
+
next whole USD before the first request (within 1–500), and records the actual
|
|
73
|
+
bid in the evidence and report. Observed CPC measurements remain unchanged.
|
|
74
|
+
|
|
75
|
+
For an explicitly chosen homogeneous scenario, pass `--scenario <file.json>`:
|
|
76
|
+
|
|
77
|
+
```json
|
|
78
|
+
{"keywords":["example service","example pricing"],"location_code":2840,"language_code":"en","match":"phrase","bid":3,"rationale":"Bounded exploratory bid assumption","source":"Caller-selected scenario"}
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
The locale must match the run; one match type and one whole-dollar bid (1–500)
|
|
82
|
+
apply to at most 1000 unique keywords. Mixed per-keyword bids/matches cannot be
|
|
83
|
+
represented faithfully by this endpoint; do not silently flatten campaign
|
|
84
|
+
assets into a forecast. The scenario never changes a live campaign.
|
|
85
|
+
Fractional explicit bids fail validation before any paid calls. Choose and record
|
|
86
|
+
a whole-dollar scenario; do not silently round a caller-specified bid.
|
|
87
|
+
The evidence adds a bounded `intent_signal` to keyword and SERP rows. It is a
|
|
88
|
+
lexical clue (`vendor_seeking`, `tool_seeking`, `informational`, `job_seeking`,
|
|
89
|
+
`free_intent`, or `unknown`), not an offer-fit or campaign-selection verdict.
|
|
90
|
+
Google Ads must compare it with the actual product offer before selecting paid
|
|
91
|
+
keywords. An ambiguous AEO/GEO query cannot alone confirm a competitor.
|
|
92
|
+
|
|
93
|
+
## 3. On failure
|
|
94
|
+
|
|
95
|
+
Provider rate limits and recognized internal DataForSEO errors explicitly
|
|
96
|
+
confirmed as unpaid are handled inside the runner: it logs the failure and
|
|
97
|
+
retries the unchanged request with bounded backoff. Do not add manual waits or
|
|
98
|
+
retry wrappers around it. An internal error is not proof of valid input or a
|
|
99
|
+
guarantee of recovery. Validation errors need corrected input; unknown billing
|
|
100
|
+
status is not safe to retry automatically.
|
|
101
|
+
`50301` with `Request contains an invalid argument` is an input rejection, not
|
|
102
|
+
a rate limit; the runner stops rather than repeating it unchanged.
|
|
103
|
+
|
|
104
|
+
If the runner reports exhausted retries, the section is blocked, not completed.
|
|
105
|
+
Preserve the workspace and report the failed operation, provider code and task
|
|
106
|
+
ID (when available), and that automatic retries were exhausted. Do not hide the
|
|
107
|
+
failure by skipping evidence or declaring the research complete. A later
|
|
108
|
+
recovery attempt can rerun the same command using its cached successful
|
|
109
|
+
responses; use the caller's recovery mechanism rather than starting an
|
|
110
|
+
unbounded manual loop.
|
|
111
|
+
|
|
112
|
+
If the runner
|
|
113
|
+
reports that no seed survived volume validation, report the measured coverage. Expand or change the assigned phrase list only
|
|
114
|
+
when that remains within the caller's requested scope and collection budget. For
|
|
115
|
+
any other failure, preserve the runtime state and stop; a later attempt
|
|
116
|
+
resumes from cache. Do not substitute Brave search, generic OS Research,
|
|
117
|
+
Apify, direct provider access, or an agent-written result, and do not edit
|
|
118
|
+
`egbe-docs/research/market/full-report.md` or the evidence file manually. Completion is
|
|
119
|
+
validated deterministically from the runtime receipt; this section has no
|
|
120
|
+
LLM-based Research Completion Review step.
|
|
121
|
+
Old single-locale evidence is not silently migrated. Preserve it and use a new
|
|
122
|
+
workspace with the current bundle when the runner reports an unsupported format.
|
|
@@ -0,0 +1,218 @@
|
|
|
1
|
+
# Lifecycle Capture
|
|
2
|
+
|
|
3
|
+
Internal research of the email portion of competitors' conversion journeys.
|
|
4
|
+
Start immediately after Competitor Set so observation runs alongside other
|
|
5
|
+
research. Read the [input and observation contract](../contracts/lifecycle-capture.md).
|
|
6
|
+
Replicate plans do not consume lifecycle evidence.
|
|
7
|
+
|
|
8
|
+
## Policy
|
|
9
|
+
|
|
10
|
+
Assign registration, double opt-in and unsubscribe to a human with verified
|
|
11
|
+
access to the planned aliases and assigned mailbox. Any authorized human with
|
|
12
|
+
that verified access is eligible, regardless of role. If nobody with that access
|
|
13
|
+
is available, leave the actions pending and
|
|
14
|
+
continue other research. The agent inspects entry points without submitting
|
|
15
|
+
forms, records actual results, and
|
|
16
|
+
reads the assigned mailbox. Never pay, enter card details, supply a required
|
|
17
|
+
phone, bypass a CAPTCHA or bot check, or use a real third-party identity.
|
|
18
|
+
Leave optional phone fields empty. Never reply to sales representatives.
|
|
19
|
+
A rejected plus address or unavailable form needs a verified fallback or a skip.
|
|
20
|
+
|
|
21
|
+
Use one planned alias per competitor per capture: `<local>+NN@<domain>`, where
|
|
22
|
+
NN is random from 10–99. OS reserves numbers uniquely across captures sharing
|
|
23
|
+
the mailbox. A fresh research workspace creates a new capture; refresh retains
|
|
24
|
+
its UUID and mapping. Active legacy captures retain their existing aliases.
|
|
25
|
+
Exhaustion stops clearly; numbers are never silently reassigned.
|
|
26
|
+
The shared operational mailbox stays. Neutral tags do not conceal its address.
|
|
27
|
+
Attribution uses exact full To/Delivered-To matches, never sender or a prefix.
|
|
28
|
+
|
|
29
|
+
Bodies, mailbox addresses, aliases, message ids and personal links stay in the
|
|
30
|
+
private runtime. Every published string is scrubbed at one boundary: planned
|
|
31
|
+
addresses and the mailbox, plain or percent-encoded, become `[address]`;
|
|
32
|
+
message references become “a message”; unreadable messages disclose HTTP status
|
|
33
|
+
only. Published entry URLs lose query/fragment. Evidence carries subjects and
|
|
34
|
+
extracted facts, never bodies or excerpts. The list of signup actions also stays private.
|
|
35
|
+
|
|
36
|
+
## 1. Plan and discover entries
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
python3 scripts/run-lifecycle-capture.py --workspace . --product-domain product.com
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Requires OS_API_KEY, optional OS_URL, and the deployed OS alias-reservation
|
|
43
|
+
endpoint. Domains come from --domains, receipt-backed Competitor Set, then
|
|
44
|
+
Keyword Economics excluding rejected domains; default maximum 10. This section
|
|
45
|
+
accepts the upstream selection as given.
|
|
46
|
+
|
|
47
|
+
The first call persists a capture id before reserving aliases, writes private
|
|
48
|
+
`egbe-docs/research/market/work/lifecycle_capture/plan.json`, and exits 2. URLs before review
|
|
49
|
+
are discovery seeds, not sign-up recommendations. Completed Funnel Teardown
|
|
50
|
+
may supply seeds but is not a prerequisite.
|
|
51
|
+
|
|
52
|
+
Inspect each competitor's comparable offer and public conversion path with the
|
|
53
|
+
available browser/source tools. Prefer details/materials, webinar/info session,
|
|
54
|
+
quiz/assessment, waitlist, free account or card-free trial, then newsletter.
|
|
55
|
+
Relevance to the current buyer and purchase matters: explain when a lower-ranked
|
|
56
|
+
entry is the closest usable path. A generic account or newsletter is not the
|
|
57
|
+
same sales journey without evidence.
|
|
58
|
+
|
|
59
|
+
Record selected and verified fallback entries in private entry-points.json
|
|
60
|
+
using the contract: fields, consent, phone/card requirements, instructions,
|
|
61
|
+
stopping point, sources and verification date. Unknown requirements stay
|
|
62
|
+
unknown. Hosted forms need the competitor's source/CTA, actual destination and
|
|
63
|
+
link/embed evidence. Record silent-waitlist risk rather than promising nurture.
|
|
64
|
+
Rerun: the runner validates discovery, incorporates it into plan.json and
|
|
65
|
+
renders private lifecycle-signups.md. Hand over that list early; do not rewrite
|
|
66
|
+
its choices independently.
|
|
67
|
+
|
|
68
|
+
## 2. Record signup results and continue research
|
|
69
|
+
|
|
70
|
+
The assigned human reports results in ordinary chat. Update subscriptions.json with
|
|
71
|
+
actual dates and the planned selected/fallback entry. Unknown phone/card needs
|
|
72
|
+
require verification by that human. Fallback use needs a reason; unavailable entries
|
|
73
|
+
go in skipped. Rerun to validate aliases, dates and entry binding, then publish
|
|
74
|
+
started when all competitors are accounted for. Pending sign-ups do not block
|
|
75
|
+
other research. An explicit harvest can read recorded
|
|
76
|
+
subscriptions while preserving outstanding ones as coverage limitations.
|
|
77
|
+
|
|
78
|
+
The runner writes private operator-actions.json with signup, confirmation and
|
|
79
|
+
unsubscribe actions plus day-3/day-14 harvest deadlines per actual subscription.
|
|
80
|
+
Unknown confirmation status does not imply double opt-in. If a confirmation
|
|
81
|
+
arrives, ask the assigned human to confirm through their authorized mailbox
|
|
82
|
+
access and record confirmed:false until they report success. Never expose
|
|
83
|
+
private confirmation links in published research.
|
|
84
|
+
Use the scheduling/runtime mechanism supplied by the caller to reconcile dates,
|
|
85
|
+
install harvest follow-ups and bounded reminders. Scheduler ids stay outside
|
|
86
|
+
domain artifacts. A manual caller without scheduling discloses that limitation
|
|
87
|
+
and hands over due dates: writing the file alone does not install reminders.
|
|
88
|
+
Cancel obsolete jobs when actions finish or captures change. Unsubscribe
|
|
89
|
+
reminders become actionable only after the full harvest.
|
|
90
|
+
|
|
91
|
+
## 3. Early and full harvest
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
python3 scripts/run-lifecycle-capture.py --workspace . --product-domain product.com --harvest
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Run day 3 for early evidence and day 14 for the full window, separately from
|
|
98
|
+
each competitor's subscription date. Earlier confirmation reads are allowed.
|
|
99
|
+
The command derives partial/full from duration; successful publication is a
|
|
100
|
+
separate fact. Later snapshots replace current evidence/report and preserve
|
|
101
|
+
immutable private provenance for previously shared research.
|
|
102
|
+
|
|
103
|
+
List by full alias from the day before subscription through GET /mail/inbox
|
|
104
|
+
with to, since and limit=50; retain exact recipient hits. Read each message once
|
|
105
|
+
through GET /mail/message/{uid}. Record UTC arrival, subject, sender domain,
|
|
106
|
+
confirmation/welcome/nudge/offer/content signals, prices, discounts, deadlines
|
|
107
|
+
and unsubscribe availability. Nothing after cutoff/unsubscribe enters the data.
|
|
108
|
+
Bodies remain cached privately.
|
|
109
|
+
The cache stores portable message content without access-bearing links or
|
|
110
|
+
credentials; originals requiring those values stay under the research
|
|
111
|
+
`.local/lifecycle_capture/mail-cache/` boundary described in the artifact contract.
|
|
112
|
+
|
|
113
|
+
Observed positive behavior at two or more competitors may inform standalone
|
|
114
|
+
future email sequences with a partial badge and stated window; it does not
|
|
115
|
+
authorize a replicate option.
|
|
116
|
+
No offer by day 3 does not mean none in the
|
|
117
|
+
first week or full capture. Weekly cadence needs at least seven days; a welcome
|
|
118
|
+
burst is not a sustained schedule. Extracted structure/timing can inform future
|
|
119
|
+
email sequences while respecting current product claims and explicit limits.
|
|
120
|
+
|
|
121
|
+
Duration, dates and coverage remain visible. Fourteen days is a target duration,
|
|
122
|
+
not proof no mail was missed. A full 50-message page, missing body, failed listing,
|
|
123
|
+
unconfirmed opt-in or pending signup remains a limitation. Zero messages applies
|
|
124
|
+
only to its observed window, not a claim that the competitor does no email.
|
|
125
|
+
Budgets: 30 inbox listings and 60 message reads per invocation. Cached bodies
|
|
126
|
+
are reused; same-cutoff listings replay and the next day refreshes. --as-of is
|
|
127
|
+
never before the first subscription or after today, and cannot replace a newer
|
|
128
|
+
publication. Refused keys, rate limits and unreachable OS stop. No successful
|
|
129
|
+
listing means failure rather than an empty published harvest.
|
|
130
|
+
|
|
131
|
+
## 4. Publish
|
|
132
|
+
|
|
133
|
+
Write egbe-docs/research/market/evidence/lifecycle-capture.json with subscription,
|
|
134
|
+
lifecycle_sequence, lifecycle_message, lifecycle_pattern and coverage rows;
|
|
135
|
+
materialize Lifecycle capture in egbe-docs/research/market/full-report.md and record a
|
|
136
|
+
hash-backed receipt. The runner verifies report and evidence together; Git belongs to the caller. completed means publication succeeded;
|
|
137
|
+
phase and observation metadata determine whether the window was harvested.
|
|
138
|
+
|
|
139
|
+
A caller that indexes lifecycle evidence rebuilds its evidence index after
|
|
140
|
+
each harvest and carries the windows and coverage through.
|
|
141
|
+
|
|
142
|
+
## 5. Funnel handoff and same-day mail
|
|
143
|
+
|
|
144
|
+
05 reserves one numeric plus alias per funnel in the shared runtime registry
|
|
145
|
+
`egbe-docs/research/market/work/identity-registry.json` (schema 1, mailbox, identities with
|
|
146
|
+
identity_id, domain, funnel_id, alias and kind). Ordinary 02 capture aliases, including active legacy aliases, remain
|
|
147
|
+
reserved too; their OS reservation policy is unchanged. The registry is private, stable across resume and protected by
|
|
148
|
+
`identity-registry.json.lock`; never allocate a different alias on a retry.
|
|
149
|
+
Receipts use a canonical `identity_registry_binding` for only the identities
|
|
150
|
+
that section uses, including the real private mappings in its digest. Adding
|
|
151
|
+
unrelated identities or reformatting the shared file preserves those receipts;
|
|
152
|
+
changing a used mapping invalidates them.
|
|
153
|
+
|
|
154
|
+
05 writes `egbe-docs/research/market/work/funnel_teardown/lifecycle-handoff.json`, schema 1:
|
|
155
|
+
subscriptions and events. Each imported subscription names domain, alias,
|
|
156
|
+
funnel_id, campaign_refs, path_refs, entry_url, kind (`lead_form`, `quiz` or
|
|
157
|
+
`webinar_registration`), subscribed_on, confirmed, submission_ref and approval_ref.
|
|
158
|
+
`email_expectations` records confirmation and result as true, false or null,
|
|
159
|
+
with `source_ref: browser:<screen_id>` for a determined expectation. False means
|
|
160
|
+
the browser observation explicitly established that no such mail is expected;
|
|
161
|
+
null preserves uncertainty. Do not infer false from an empty inbox.
|
|
162
|
+
An observed delivery promise may supply `email_expectations.wait_until` as an
|
|
163
|
+
aware timestamp with the same browser source. Private `submission_checks`
|
|
164
|
+
preserve each submission's time, path and original campaign refs.
|
|
165
|
+
Only registrations already submitted with the exact data approved by the human
|
|
166
|
+
approver are imported. They account for that competitor without requiring another 02 sign-up.
|
|
167
|
+
Several funnels from one competitor remain separate subscriptions. Their later
|
|
168
|
+
messages retain funnel/campaign/path attribution; lifecycle recurrence counts
|
|
169
|
+
unique competitors, never aliases.
|
|
170
|
+
|
|
171
|
+
Read the mailbox on the day of the walk, before the normal capture window:
|
|
172
|
+
|
|
173
|
+
```bash
|
|
174
|
+
python3 scripts/run-lifecycle-capture.py --workspace . --funnel-mail
|
|
175
|
+
python3 scripts/run-lifecycle-capture.py --workspace . --funnel-mail --refresh
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
This mode works even when ordinary 02 subscriptions are still missing. It lists
|
|
179
|
+
only reserved funnel aliases and writes runtime
|
|
180
|
+
`egbe-docs/research/market/work/lifecycle_capture/funnel-events.json` (schema 1, events,
|
|
181
|
+
checks, pending, coverage, checked_at). It neither publishes 02 nor marks capture complete.
|
|
182
|
+
`--refresh` takes a new inbox snapshot within the same day; already read bodies
|
|
183
|
+
stay cached. Use it after an expected confirmation/result has not arrived yet.
|
|
184
|
+
Each check attributes funnel_id, path_refs, campaign_refs and alias, with
|
|
185
|
+
checked_at, inbox_since, query_succeeded and an inbox_snapshot source_ref.
|
|
186
|
+
The timestamp retains the actual query time and local timezone, including when
|
|
187
|
+
replaying a cached snapshot. A new approved submission needs a check after that
|
|
188
|
+
submission; refresh an earlier snapshot. The check history is retained across
|
|
189
|
+
refreshes and days. Equivalent campaign refs added to an already checked
|
|
190
|
+
physical funnel do not require a second submission or cancel its original
|
|
191
|
+
attributed check. Old caches without a query timestamp
|
|
192
|
+
remain pending until refreshed. No expected mail after an explicit false/false
|
|
193
|
+
browser observation still needs an attributable successful same-day check.
|
|
194
|
+
|
|
195
|
+
Events carry event_id, type (`email_confirmation` or `email_result`), funnel_id,
|
|
196
|
+
path_id (null when multiple paths share the alias), campaign_refs, alias,
|
|
197
|
+
occurred_at, source_ref, message_ref and verification_status. A result has a short
|
|
198
|
+
runtime subject/excerpt; the body stays in the cached message. Automatic result
|
|
199
|
+
classification is a candidate observation: verify the message content before
|
|
200
|
+
claiming a final result. Receiving a confirmation sets `received`, never
|
|
201
|
+
`confirmed`. The browser agent uses the locally retained original confirmation
|
|
202
|
+
link only within the approved continuation, then records its observed outcome
|
|
203
|
+
in the handoff events. If that local original is unavailable after a clone, use
|
|
204
|
+
authorized mailbox access; do not recreate a signup to recover credentials.
|
|
205
|
+
|
|
206
|
+
While the submission day is open, its first same-day check remains required.
|
|
207
|
+
A missed day closes as terminal `same_day_check_missed`; unknown expectations
|
|
208
|
+
close as `email_expectation_undetermined` after an attributable successful
|
|
209
|
+
query, retaining their unknown values. Promised mail continues pending
|
|
210
|
+
(`email_not_received` or `confirmation_required`) until an observed delivery
|
|
211
|
+
deadline, otherwise the existing 14-day capture boundary. A fresh successful
|
|
212
|
+
query at or after that boundary can close missing mail as
|
|
213
|
+
`expected_email_not_received` or `confirmation_unverified`. These gaps preserve the unseen browser result and unverified confirmation. Failed or
|
|
214
|
+
undated queries cannot establish absence. Never repeat a lead submission to
|
|
215
|
+
repair coverage. Email receipt time stays separate from campaign
|
|
216
|
+
cutoff and walk time. The imported aliases use the existing capture/unsubscribe
|
|
217
|
+
procedure when the capture ends. Public evidence keeps attribution and scrubbed
|
|
218
|
+
facts; exact aliases, receipt refs, message IDs and recipient links stay runtime.
|