@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,256 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "product_analytics_events.v1",
|
|
3
|
+
"status": "active",
|
|
4
|
+
"owner": "egbe-os-analytics",
|
|
5
|
+
"purpose": "Canonical product analytics event contract for OpenClaw-developed products.",
|
|
6
|
+
"naming_policy": {
|
|
7
|
+
"product_events": "Use stable snake_case event names.",
|
|
8
|
+
"system_exception": "campaign-visit remains hyphenated because analytics-gateway campaign reporting is built around this system event.",
|
|
9
|
+
"product_specificity": "Do not encode product, page, or button identity in the event name. Put those details in payload fields."
|
|
10
|
+
},
|
|
11
|
+
"applicability_policy": {
|
|
12
|
+
"required_when_applicable": true,
|
|
13
|
+
"do_not_fake_events": true,
|
|
14
|
+
"selection_rule": "Evaluate every event's required_when against the supplied product requirements and real behavior. Applicable acquisition, interaction, activation, signup, verification, and payment events compose additively; no single product profile is a complete checklist.",
|
|
15
|
+
"pageview_rule": "Use the shared Umami snippet's native pageviews for required page-view measurement; do not invent a custom page-view event.",
|
|
16
|
+
"interaction_rule": "Require cta_click for each primary conversion placement and button_click only for analytically meaningful secondary actions, never every incidental control.",
|
|
17
|
+
"not_applicable_marker": "Mark missing lifecycle areas as not_applicable or pending in product metadata instead of emitting fake events."
|
|
18
|
+
},
|
|
19
|
+
"common_payload": {
|
|
20
|
+
"required": ["product_slug", "path"],
|
|
21
|
+
"recommended": ["surface", "visitor_id", "visit_id", "first_utm_source", "first_utm_medium", "first_utm_campaign"],
|
|
22
|
+
"optional": [
|
|
23
|
+
"first_utm_content",
|
|
24
|
+
"first_utm_term",
|
|
25
|
+
"first_gclid",
|
|
26
|
+
"first_fbclid",
|
|
27
|
+
"first_msclkid",
|
|
28
|
+
"first_ttclid",
|
|
29
|
+
"first_landing_path",
|
|
30
|
+
"first_referrer",
|
|
31
|
+
"first_seen_at",
|
|
32
|
+
"experiment_id",
|
|
33
|
+
"variant_id",
|
|
34
|
+
"activation_id",
|
|
35
|
+
"account_id",
|
|
36
|
+
"user_id"
|
|
37
|
+
],
|
|
38
|
+
"privacy": {
|
|
39
|
+
"no_raw_emails": true,
|
|
40
|
+
"no_secret_values": true,
|
|
41
|
+
"direct_identifiers": "Avoid raw personal identifiers in Umami payloads. Use non-sensitive internal IDs only when needed."
|
|
42
|
+
}
|
|
43
|
+
},
|
|
44
|
+
"attribution_payload": {
|
|
45
|
+
"source": "Frontend reads window.__egbeAttribution.read(); backend persists the same first-touch fields with durable signup/payment metadata for later backend joins. Signup rows use canonical first_utm_* columns (or their camelCase ORM equivalents) so Site Gateway can discover them automatically.",
|
|
46
|
+
"first_touch_fields": [
|
|
47
|
+
"visitor_id",
|
|
48
|
+
"visit_id",
|
|
49
|
+
"first_utm_source",
|
|
50
|
+
"first_utm_medium",
|
|
51
|
+
"first_utm_campaign",
|
|
52
|
+
"first_utm_content",
|
|
53
|
+
"first_utm_term",
|
|
54
|
+
"first_gclid",
|
|
55
|
+
"first_fbclid",
|
|
56
|
+
"first_msclkid",
|
|
57
|
+
"first_ttclid",
|
|
58
|
+
"first_landing_path",
|
|
59
|
+
"first_referrer",
|
|
60
|
+
"first_seen_at"
|
|
61
|
+
],
|
|
62
|
+
"rule": "First-touch fields remain stable for the visitor. Later touch data may be stored separately, but channel reports use first-touch by default."
|
|
63
|
+
},
|
|
64
|
+
"delivery_policy": {
|
|
65
|
+
"source_model": "Separate lifecycle confirmation from Umami delivery. Backend can be the source of truth for a durable fact while the browser emits the canonical Umami event so it stays attached to the user's session timeline.",
|
|
66
|
+
"browser_session_rule": "Events that occur during an active user flow must be emitted with the Umami browser tracker (`window.umami.track`) after any required backend confirmation. Do not use direct backend `/api/send` as the primary delivery path for these user-session funnel events.",
|
|
67
|
+
"browser_after_backend_confirmation": {
|
|
68
|
+
"events": ["activated", "signup_completed", "email_verified", "checkout_started", "purchase"],
|
|
69
|
+
"rule": "The backend confirms the durable state change and returns an analytics descriptor. The browser then sends the canonical event immediately or stores it in a short-lived pending queue (for example sessionStorage) and flushes it after redirect."
|
|
70
|
+
},
|
|
71
|
+
"backend_direct": {
|
|
72
|
+
"allowed_when": "Use direct backend delivery only for webhook, renewal, refund, admin/system, or other out-of-session lifecycle events that have no active browser session timeline to join.",
|
|
73
|
+
"events": ["subscription_renewed", "subscription_canceled", "refund"],
|
|
74
|
+
"rule": "Persist first-touch attribution with account/payment metadata so backend direct events can still be joined for channel reporting. Treat Umami {\"beep\":\"boop\"} as filtered delivery when a backend collector send is used."
|
|
75
|
+
},
|
|
76
|
+
"forbidden_primary_backend_collector_events": ["activated", "signup_completed", "checkout_started", "purchase"],
|
|
77
|
+
"umami_session_note": "Umami server-side sends can write aggregate events, but they may receive a different `session_id` from browser events. Use browser delivery for user-session funnel timelines."
|
|
78
|
+
},
|
|
79
|
+
"optional_telemetry_policy": {
|
|
80
|
+
"non_funnel_events": ["engagement-click", "engagement-scroll", "engagement-time"],
|
|
81
|
+
"rule": "Optional engagement telemetry is not part of the canonical product funnel and must not satisfy `cta_click`, `button_click`, or lifecycle event guardrails."
|
|
82
|
+
},
|
|
83
|
+
"events": [
|
|
84
|
+
{
|
|
85
|
+
"name": "campaign-visit",
|
|
86
|
+
"category": "acquisition",
|
|
87
|
+
"source": "frontend_system",
|
|
88
|
+
"confirmation_source": "frontend_system",
|
|
89
|
+
"umami_delivery": "browser",
|
|
90
|
+
"required_when": "A public product page has the shared analytics tracking snippet and the visitor arrives with UTM, click-id, or other explicit campaign attribution. Referrer-only traffic does not trigger this event by itself.",
|
|
91
|
+
"firing_rule": "The shared tracking snippet emits once per attributed visit signature.",
|
|
92
|
+
"required_payload": ["visitor_id", "visit_id"],
|
|
93
|
+
"required_one_of_payload": [
|
|
94
|
+
"utm_source",
|
|
95
|
+
"utm_medium",
|
|
96
|
+
"utm_campaign",
|
|
97
|
+
"utm_content",
|
|
98
|
+
"utm_term",
|
|
99
|
+
"gclid",
|
|
100
|
+
"fbclid",
|
|
101
|
+
"msclkid",
|
|
102
|
+
"ttclid"
|
|
103
|
+
],
|
|
104
|
+
"recommended_payload": ["landing_path", "referrer", "first_seen_at"]
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
"name": "cta_click",
|
|
108
|
+
"category": "landing",
|
|
109
|
+
"source": "frontend",
|
|
110
|
+
"confirmation_source": "frontend",
|
|
111
|
+
"umami_delivery": "browser",
|
|
112
|
+
"required_when": "A primary conversion-driving CTA exists on a public page.",
|
|
113
|
+
"firing_rule": "Fire when the visitor clicks a primary CTA that moves them toward activation, signup, pricing, checkout, or a channel handoff.",
|
|
114
|
+
"required_payload": ["product_slug", "path", "surface", "cta_id", "cta_role"],
|
|
115
|
+
"recommended_payload": ["label", "destination", "position", "visitor_id", "visit_id"]
|
|
116
|
+
},
|
|
117
|
+
{
|
|
118
|
+
"name": "button_click",
|
|
119
|
+
"category": "interaction",
|
|
120
|
+
"source": "frontend",
|
|
121
|
+
"confirmation_source": "frontend",
|
|
122
|
+
"umami_delivery": "browser",
|
|
123
|
+
"required_when": "A non-primary but analytically meaningful button exists.",
|
|
124
|
+
"firing_rule": "Fire for important product or landing buttons. Do not fire for every incidental UI control.",
|
|
125
|
+
"required_payload": ["product_slug", "path", "surface", "button_id", "button_role"],
|
|
126
|
+
"recommended_payload": ["label", "destination", "position", "state", "visitor_id", "visit_id"]
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"name": "activated",
|
|
130
|
+
"category": "activation",
|
|
131
|
+
"source": "frontend_or_backend",
|
|
132
|
+
"confirmation_source": "frontend_or_backend",
|
|
133
|
+
"umami_delivery": "browser_after_backend_confirmation",
|
|
134
|
+
"required_when": "The product has a real first-value moment or core action completion before or after signup.",
|
|
135
|
+
"firing_rule": "Fire when the visitor receives real product value or completes a caller-required core outcome, not when they merely click a button. Use a stable activation_type for each measured outcome and identify one type as the product's primary activation. If the outcome is created by a backend action, return a confirmed analytics descriptor and emit from the browser after success.",
|
|
136
|
+
"required_payload": ["product_slug", "path", "activation_type"],
|
|
137
|
+
"recommended_payload": ["activation_id", "surface", "input_type", "result_type", "duration_ms", "visitor_id", "visit_id"]
|
|
138
|
+
},
|
|
139
|
+
{
|
|
140
|
+
"name": "signup_started",
|
|
141
|
+
"category": "signup",
|
|
142
|
+
"source": "frontend",
|
|
143
|
+
"confirmation_source": "frontend",
|
|
144
|
+
"umami_delivery": "browser",
|
|
145
|
+
"required_when": "A signup, registration, account creation, or lead-capture form exists.",
|
|
146
|
+
"firing_rule": "Fire when a visitor intentionally enters the signup flow.",
|
|
147
|
+
"required_payload": ["product_slug", "path", "surface"],
|
|
148
|
+
"recommended_payload": ["entrypoint", "activation_id", "visitor_id", "visit_id"]
|
|
149
|
+
},
|
|
150
|
+
{
|
|
151
|
+
"name": "signup_submitted",
|
|
152
|
+
"category": "signup",
|
|
153
|
+
"source": "frontend",
|
|
154
|
+
"confirmation_source": "frontend",
|
|
155
|
+
"umami_delivery": "browser",
|
|
156
|
+
"required_when": "A signup form can be submitted.",
|
|
157
|
+
"firing_rule": "Fire immediately before or at form submit after client-side validation passes.",
|
|
158
|
+
"required_payload": ["product_slug", "path", "surface"],
|
|
159
|
+
"recommended_payload": ["activation_id", "visitor_id", "visit_id"]
|
|
160
|
+
},
|
|
161
|
+
{
|
|
162
|
+
"name": "signup_completed",
|
|
163
|
+
"category": "signup",
|
|
164
|
+
"source": "backend_confirmed",
|
|
165
|
+
"confirmation_source": "backend",
|
|
166
|
+
"umami_delivery": "browser_after_backend_confirmation",
|
|
167
|
+
"required_when": "Signup creates a durable account, registration row, subscriber row, or accepted lead-capture row.",
|
|
168
|
+
"firing_rule": "Confirm only after the durable write succeeds. The backend is the source of truth for completion, then the browser emits the Umami event so it joins the signup session timeline.",
|
|
169
|
+
"required_payload": ["product_slug", "path", "surface"],
|
|
170
|
+
"recommended_payload": ["account_id", "activation_id", "duplicate", "visitor_id", "visit_id"]
|
|
171
|
+
},
|
|
172
|
+
{
|
|
173
|
+
"name": "email_verified",
|
|
174
|
+
"category": "email",
|
|
175
|
+
"source": "backend",
|
|
176
|
+
"confirmation_source": "backend",
|
|
177
|
+
"umami_delivery": "browser_after_backend_confirmation_or_backend_direct",
|
|
178
|
+
"required_when": "The product requires email verification or magic-link confirmation.",
|
|
179
|
+
"firing_rule": "Fire when a verification token is accepted and the account/email state becomes verified. Prefer browser delivery on the verification result page; use backend direct only for out-of-session verification handling.",
|
|
180
|
+
"required_payload": ["product_slug", "path"],
|
|
181
|
+
"recommended_payload": ["account_id", "verification_method", "visitor_id", "visit_id"]
|
|
182
|
+
},
|
|
183
|
+
{
|
|
184
|
+
"name": "paywall_view",
|
|
185
|
+
"category": "monetization",
|
|
186
|
+
"source": "frontend",
|
|
187
|
+
"confirmation_source": "frontend",
|
|
188
|
+
"umami_delivery": "browser",
|
|
189
|
+
"required_when": "The product has a paywall, pricing gate, upgrade gate, or paid-plan prompt.",
|
|
190
|
+
"firing_rule": "Fire when the paywall or paid prompt becomes visible.",
|
|
191
|
+
"required_payload": ["product_slug", "path", "surface", "paywall_id"],
|
|
192
|
+
"recommended_payload": ["plan_name", "price_cents", "currency", "activation_id", "visitor_id", "visit_id"]
|
|
193
|
+
},
|
|
194
|
+
{
|
|
195
|
+
"name": "checkout_started",
|
|
196
|
+
"category": "monetization",
|
|
197
|
+
"source": "backend_confirmed",
|
|
198
|
+
"confirmation_source": "backend",
|
|
199
|
+
"umami_delivery": "browser_after_backend_confirmation",
|
|
200
|
+
"required_when": "A real checkout session, payment link redirect, deposit, or paid-pilot checkout starts.",
|
|
201
|
+
"firing_rule": "Confirm when the product successfully creates a dynamic checkout session or real checkout URL. Emit the Umami event from the browser before redirect or queue it and flush before navigation.",
|
|
202
|
+
"required_payload": ["product_slug", "path", "checkout_type"],
|
|
203
|
+
"recommended_payload": ["checkout_session_id", "price_id", "plan_name", "amount_cents", "currency", "activation_id", "visitor_id", "visit_id"]
|
|
204
|
+
},
|
|
205
|
+
{
|
|
206
|
+
"name": "purchase",
|
|
207
|
+
"category": "revenue",
|
|
208
|
+
"source": "backend_confirmed",
|
|
209
|
+
"confirmation_source": "webhook_or_backend",
|
|
210
|
+
"umami_delivery": "browser_after_backend_confirmation",
|
|
211
|
+
"required_when": "A Stripe checkout/payment event confirms successful payment for the product.",
|
|
212
|
+
"firing_rule": "Confirm from the payment webhook or backend status check after idempotently accepting a paid Stripe event. Expose a pending descriptor to the owning checkout-success browser and emit the canonical Umami event there. Use Stripe/OS payment metrics, not server-only Umami delivery, for complete financial totals.",
|
|
213
|
+
"required_payload": ["product_slug", "stripe_event_id", "amount_cents", "currency"],
|
|
214
|
+
"recommended_payload": ["checkout_session_id", "payment_intent_id", "subscription_id", "customer_id", "plan_name", "visitor_id", "visit_id"]
|
|
215
|
+
},
|
|
216
|
+
{
|
|
217
|
+
"name": "subscription_renewed",
|
|
218
|
+
"category": "revenue",
|
|
219
|
+
"source": "backend",
|
|
220
|
+
"confirmation_source": "webhook",
|
|
221
|
+
"umami_delivery": "backend_direct",
|
|
222
|
+
"required_when": "The product supports subscriptions and receives renewal/payment lifecycle events.",
|
|
223
|
+
"firing_rule": "Fire when a subscription renewal invoice is paid and applied idempotently.",
|
|
224
|
+
"required_payload": ["product_slug", "stripe_event_id", "subscription_id", "amount_cents", "currency"],
|
|
225
|
+
"recommended_payload": ["invoice_id", "customer_id", "plan_name", "billing_interval"]
|
|
226
|
+
},
|
|
227
|
+
{
|
|
228
|
+
"name": "subscription_canceled",
|
|
229
|
+
"category": "retention",
|
|
230
|
+
"source": "backend",
|
|
231
|
+
"confirmation_source": "backend_or_webhook",
|
|
232
|
+
"umami_delivery": "browser_after_backend_confirmation_or_backend_direct",
|
|
233
|
+
"required_when": "The product supports subscriptions and receives cancellation/deletion lifecycle events.",
|
|
234
|
+
"firing_rule": "Fire when a cancellation is accepted and entitlement state changes or is scheduled to end. Use browser delivery for user-initiated cancel flows; use backend direct for webhook/admin/system cancellations.",
|
|
235
|
+
"required_payload": ["product_slug", "stripe_event_id", "subscription_id"],
|
|
236
|
+
"recommended_payload": ["customer_id", "plan_name", "cancel_at_period_end", "canceled_at"]
|
|
237
|
+
},
|
|
238
|
+
{
|
|
239
|
+
"name": "refund",
|
|
240
|
+
"category": "revenue_adjustment",
|
|
241
|
+
"source": "backend",
|
|
242
|
+
"confirmation_source": "webhook_or_backend",
|
|
243
|
+
"umami_delivery": "backend_direct",
|
|
244
|
+
"required_when": "The product and payment gateway support refund lifecycle events.",
|
|
245
|
+
"firing_rule": "Fire only when a refund is confirmed and applied idempotently.",
|
|
246
|
+
"required_payload": ["product_slug", "stripe_event_id", "refund_id", "amount_cents", "currency"],
|
|
247
|
+
"recommended_payload": ["payment_intent_id", "checkout_session_id", "customer_id", "reason"]
|
|
248
|
+
}
|
|
249
|
+
],
|
|
250
|
+
"validation_policy": {
|
|
251
|
+
"setup": "Verify the analytics site exists and OS tracking config is available.",
|
|
252
|
+
"wiring": "Verify the app shell contains the tracking snippet or public analytics env wiring.",
|
|
253
|
+
"behavior": "Drive real product flows and intercept/mock analytics delivery to verify canonical event names and payloads without writing synthetic product events to production stats.",
|
|
254
|
+
"observed": "Use real stats from real users for reporting and channel-level iteration decisions."
|
|
255
|
+
}
|
|
256
|
+
}
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
# Collect and replay session evidence
|
|
2
|
+
|
|
3
|
+
Use this for a requested cohort/window analysis. The helper collects scoped Umami
|
|
4
|
+
events and counts per-session stage observations, not ordered conversion or
|
|
5
|
+
causal business impact. Select event names and property filters from the current
|
|
6
|
+
product emitters and `GET /analytics/events`; one canonical event name may cover
|
|
7
|
+
several different actions.
|
|
8
|
+
|
|
9
|
+
## Collection
|
|
10
|
+
|
|
11
|
+
Run from the product root. The helper loads `.env.local` through the installed
|
|
12
|
+
quickstart connection helper and includes the current agent identity; otherwise
|
|
13
|
+
it uses `OS_URL` and `OS_API_KEY`. Keep credentials out of artifacts.
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
python3 <analytics-skill>/scripts/umami_funnel.py --site <unique-domain-or-name> \
|
|
17
|
+
--since <YYYY-MM-DD> --until <YYYY-MM-DD> \
|
|
18
|
+
--act-start-event <core-start> --act-event <core-complete> \
|
|
19
|
+
--events-json <work>/evidence/umami-events.json --json <work>/analysis/umami.json
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
Create the output parent directories in the caller's existing work folder first.
|
|
23
|
+
Both outputs refuse overwrite. Dates are UTC; `--until` is exclusive. Omit dates
|
|
24
|
+
for all history. Exact name/domain/id wins over a unique substring; ambiguous
|
|
25
|
+
sites and incomplete base-event downloads fail rather than silently truncate.
|
|
26
|
+
Record the resolved window/config and inspect enrichment/coverage status.
|
|
27
|
+
|
|
28
|
+
The event snapshot retains every downloaded row, including excluded sessions,
|
|
29
|
+
with safe properties and pseudonymous joins. It preserves safe UTM labels, not
|
|
30
|
+
arbitrary query values, free text or private identifiers. It is not a raw backup;
|
|
31
|
+
redaction limits later analyses needing omitted fields. Preserve source dates,
|
|
32
|
+
queries, exclusions and coverage alongside any derived result.
|
|
33
|
+
|
|
34
|
+
## Reconcile independent evidence
|
|
35
|
+
|
|
36
|
+
For supplied trackers/exports, read relevant notes and history with the values:
|
|
37
|
+
retain source row/range, definition, reporting window and last update. A blank
|
|
38
|
+
is not zero; old status and source-author advice are not current observed state.
|
|
39
|
+
Preserve the inspected inputs and helper version needed to reproduce material
|
|
40
|
+
calculations. Corrected evidence gets a distinct version, not a silent overwrite.
|
|
41
|
+
|
|
42
|
+
For accounts, jobs and results, inspect the product's actual data-access code.
|
|
43
|
+
Use `egbe-os-db` for scoped read-only SQL and paginated exports, following its
|
|
44
|
+
current response/limit contract. For Convex, use that skill's backend discovery
|
|
45
|
+
and an existing deployed query whose filters and limits you have inspected, not
|
|
46
|
+
a mutation or action. Reading evidence does not authorize provisioning, creating
|
|
47
|
+
jobs or contacting customers. Keep credentials in memory.
|
|
48
|
+
|
|
49
|
+
Inspect only authorized customer evidence. Select necessary fields and redact
|
|
50
|
+
credentials, personal data and signed URLs before the first write; use consistent
|
|
51
|
+
pseudonymous joins. Do not persist raw private media or session replays in the
|
|
52
|
+
analysis. Remove temporary inspection copies after use, retaining anonymous
|
|
53
|
+
observations, access/selection limits and reproducible calculations.
|
|
54
|
+
|
|
55
|
+
## Offline replay and custom calculations
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
python3 <analytics-skill>/scripts/umami_funnel.py \
|
|
59
|
+
--from-events <work>/evidence/umami-events.json --json <work>/analysis/replay.json
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
The saved configuration is replayed without a network request. Other event types
|
|
63
|
+
remain in the snapshot, but only pageviews (1) and custom events (2) supply stage
|
|
64
|
+
observations and timelines. Filter **before** grouping, counting or taking time
|
|
65
|
+
extrema, with the same window/internal-activity exclusions:
|
|
66
|
+
|
|
67
|
+
```python
|
|
68
|
+
funnel_rows = [r for r in snapshot["rows"] if r["eventType"] in (1, 2)]
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
For fields absent from this snapshot, use authorized source queries and sanitize
|
|
72
|
+
before retaining them. Base events use
|
|
73
|
+
`GET /analytics/<appSlug>/events?startAt=<ms>&endAt=<ms>&page=N&pageSize=500`:
|
|
74
|
+
both bounds are inclusive UTC milliseconds; paginate from 1 through `.data.count`,
|
|
75
|
+
reading `.data.data[]`. Event-data uses the same window/pagination; join event
|
|
76
|
+
`id` to `eventId` and read `eventProperties[]`. Its count is events with properties,
|
|
77
|
+
not property count. The helper converts its exclusive CLI end into the API window.
|
|
78
|
+
|
|
79
|
+
## Through the Egbe connector
|
|
80
|
+
|
|
81
|
+
Without the helper, collect the same pages with `egbe_read`. Pick the site's
|
|
82
|
+
`appSlug` from `GET /analytics`, then read `/analytics/<appSlug>/events` with
|
|
83
|
+
`query` `startAt` and `endAt` (inclusive UTC milliseconds), `page` from 1 and
|
|
84
|
+
`pageSize` (at most 500; 100 keeps a page in one result). A result with
|
|
85
|
+
`continuation` holds part of that page: read every part with the same `path` and
|
|
86
|
+
`continuation` and join them before parsing; never parse or count a partial
|
|
87
|
+
page. Continue to the next `page` until you have `.data.count` rows. Stop and
|
|
88
|
+
report the coverage as incomplete on an empty page before `count` or a page that
|
|
89
|
+
repeats earlier event `id`s, and narrow the window when `count` is too large to
|
|
90
|
+
read. Read `/analytics/<appSlug>/event-data` the same way and join `eventId` to
|
|
91
|
+
event `id`. Then count per `sessionId` with the counting rules below, applying
|
|
92
|
+
the same exclusions.
|
|
93
|
+
|
|
94
|
+
Keep the window, event names, filters, coverage and derived counts with the
|
|
95
|
+
analysis, without credentials, raw private paths or identifiers (in Egbe's
|
|
96
|
+
artifact store without a project folder). Such a count has no replayable event
|
|
97
|
+
snapshot; say so, and use a set-up project workspace for an analysis that must
|
|
98
|
+
be reproduced offline.
|
|
99
|
+
|
|
100
|
+
## Counting and coverage
|
|
101
|
+
|
|
102
|
+
- A session may span visits. Per-session observations are unordered; cross-visit
|
|
103
|
+
purchases require appropriate identity. Completion is a technical proxy, not
|
|
104
|
+
proof of useful quality. Reconcile signup with account records and payments
|
|
105
|
+
with provider-confirmed records using the owning capabilities.
|
|
106
|
+
- Only signup-completion events count as signup proxies; account-page visits and
|
|
107
|
+
signup-page visits without intent events are separate. Keep users, attempts,
|
|
108
|
+
transactions, test payments, renewals and refunds distinct in derived analyses.
|
|
109
|
+
- `included_sessions` means not excluded, not verified customers. Engagement/bounce
|
|
110
|
+
are activity proxies: a different page, non-ambient custom event, or scroll+time
|
|
111
|
+
beacons. Section/scroll alone does not count. Check actual emitter wiring;
|
|
112
|
+
mount-fired events cannot establish intent. Sparse events and their observed
|
|
113
|
+
span do not establish total attention or why a person left.
|
|
114
|
+
- Event-only sessions are not arrivals. For an arrival/click ratio, use pageview-
|
|
115
|
+
backed `arrivals_by_source`, not `mix`, and match source, identity and window.
|
|
116
|
+
A source aggregate cannot identify a winning creative. `cta_click` and
|
|
117
|
+
`button_click` remain separate; secondary navigation is not automatically intent.
|
|
118
|
+
- Confirmed synthetic sources (`--internal-sources`, default `smoke`) and verified
|
|
119
|
+
internal countries (`--internal-country`, no default) are excluded. Geography
|
|
120
|
+
alone is not proof of internal activity. Direct desktop DE/FI and debug/admin
|
|
121
|
+
paths are suspect, not automatically excluded; keep uncertainty visible.
|
|
122
|
+
- Reconcile test accounts/jobs with product records and verified testing context.
|
|
123
|
+
Do not infer a customer from a missing test flag. Preserve unknown coverage;
|
|
124
|
+
truncated recent payment readbacks cannot establish lifetime totals.
|
|
125
|
+
|
|
126
|
+
Fleet `product-metrics` uses different definitions: it can infer starts from
|
|
127
|
+
completions, exclude sessions this helper only flags, and include legacy signup-
|
|
128
|
+
submission events excluded here. Reconcile definitions before comparing totals;
|
|
129
|
+
do not change either counter to force agreement or interpret a fleet stage as
|
|
130
|
+
the product's goal.
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
# Activation Tracking
|
|
2
|
+
|
|
3
|
+
Use this workflow when a product has a real first-value moment or core action
|
|
4
|
+
completion.
|
|
5
|
+
|
|
6
|
+
## Applicability
|
|
7
|
+
|
|
8
|
+
Read the accepted Core Value/CAP result and its confirmation from the current
|
|
9
|
+
product requirements, including `First-value signal` when a PRD exists. For
|
|
10
|
+
bounded maintenance, use the task's accepted behavior and authoritative product
|
|
11
|
+
records. Confirm the actual success branch in implementation before instrumenting.
|
|
12
|
+
|
|
13
|
+
`Public preview` controls only public sampling; `no` does not disable measurement
|
|
14
|
+
of real value after login, payment or processing. Observe that result, not merely
|
|
15
|
+
its prerequisites. If the outcome is unknown or conflicting, identify the missing
|
|
16
|
+
definition and leave it unresolved rather than declaring it inapplicable.
|
|
17
|
+
An informational/static product need not have a discrete activation event:
|
|
18
|
+
use its meaningful existing observations without inventing a form, result or
|
|
19
|
+
synthetic completion. Existing event names or routes alone do not prove value.
|
|
20
|
+
|
|
21
|
+
## Source Of Truth
|
|
22
|
+
|
|
23
|
+
Always read the live event contract first:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/events" -s
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
`canonical-events.v1.json` remains the source of truth for the activation event
|
|
30
|
+
name, required payload fields, recommended attribution fields, and delivery
|
|
31
|
+
policy.
|
|
32
|
+
|
|
33
|
+
## Event
|
|
34
|
+
|
|
35
|
+
Use the canonical `activated` event when the visitor receives real product
|
|
36
|
+
value. Do not fire it for merely clicking a CTA or landing on a dashboard.
|
|
37
|
+
|
|
38
|
+
Use `activation_type` for the product-specific value shape instead of inventing
|
|
39
|
+
product-specific event names:
|
|
40
|
+
|
|
41
|
+
```js
|
|
42
|
+
window.umami?.track("activated", {
|
|
43
|
+
product_slug: "my-product",
|
|
44
|
+
path: "/dashboard",
|
|
45
|
+
activation_type: "report_generated",
|
|
46
|
+
});
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Browser Payload
|
|
50
|
+
|
|
51
|
+
Read first-touch attribution from the shared snippet when the browser starts the
|
|
52
|
+
core action:
|
|
53
|
+
|
|
54
|
+
```js
|
|
55
|
+
const attribution = window.__egbeAttribution?.read?.() || {};
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
Include the required payload from the event contract and useful attribution
|
|
59
|
+
fields:
|
|
60
|
+
|
|
61
|
+
```js
|
|
62
|
+
const activationPayload = {
|
|
63
|
+
product_slug: "my-product",
|
|
64
|
+
path: "/dashboard",
|
|
65
|
+
activation_type: "report_generated",
|
|
66
|
+
visitor_id: attribution.visitor_id,
|
|
67
|
+
visit_id: attribution.visit_id,
|
|
68
|
+
first_utm_source: attribution.first_utm_source,
|
|
69
|
+
first_utm_medium: attribution.first_utm_medium,
|
|
70
|
+
first_utm_campaign: attribution.first_utm_campaign,
|
|
71
|
+
};
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## Backend-Confirmed Activation
|
|
75
|
+
|
|
76
|
+
If first value is created by a backend/API action, separate the durable
|
|
77
|
+
confirmation source from Umami delivery:
|
|
78
|
+
|
|
79
|
+
1. Browser sends attribution with the core-action request.
|
|
80
|
+
2. Backend performs the durable first-value write or confirms the real result.
|
|
81
|
+
3. Backend returns an analytics descriptor only after success.
|
|
82
|
+
4. Browser emits that descriptor with `window.umami.track(...)`.
|
|
83
|
+
|
|
84
|
+
Backend response shape:
|
|
85
|
+
|
|
86
|
+
```json
|
|
87
|
+
{
|
|
88
|
+
"ok": true,
|
|
89
|
+
"analytics": {
|
|
90
|
+
"name": "activated",
|
|
91
|
+
"data": {
|
|
92
|
+
"product_slug": "my-product",
|
|
93
|
+
"path": "/dashboard",
|
|
94
|
+
"activation_type": "report_generated",
|
|
95
|
+
"activation_id": "report_123",
|
|
96
|
+
"visitor_id": "visitor_123",
|
|
97
|
+
"visit_id": "visit_123",
|
|
98
|
+
"first_utm_source": "reddit"
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
Browser delivery:
|
|
105
|
+
|
|
106
|
+
```js
|
|
107
|
+
const result = await response.json();
|
|
108
|
+
|
|
109
|
+
if (result.analytics?.name && window.umami?.track) {
|
|
110
|
+
window.umami.track(result.analytics.name, result.analytics.data || {});
|
|
111
|
+
}
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
If the activation flow redirects immediately, store the descriptor in a
|
|
115
|
+
short-lived `sessionStorage` pending queue, navigate, then flush it from the next
|
|
116
|
+
browser page with `window.umami.track(...)`.
|
|
117
|
+
|
|
118
|
+
Do not use direct backend Umami `/api/send` or `trackServerEvent` as the primary
|
|
119
|
+
delivery path for `activated`; it can attach the event to a different Umami
|
|
120
|
+
session than the visitor's browser session.
|
|
121
|
+
|
|
122
|
+
## Practical Rules
|
|
123
|
+
|
|
124
|
+
- Preserve the existing product feature behavior.
|
|
125
|
+
- Emit activation once per real first-value moment or use payload state such as
|
|
126
|
+
`activation_id` to make repeat behavior explainable.
|
|
127
|
+
- Put no raw emails, secrets, input documents, tokens, or payment details in
|
|
128
|
+
Umami payloads.
|
|
129
|
+
- Persist first-touch attribution with durable user/account/value metadata when
|
|
130
|
+
a backend exists, so later revenue and retention reporting can join back to
|
|
131
|
+
acquisition channel.
|
|
132
|
+
|
|
133
|
+
## Bounded Verification
|
|
134
|
+
|
|
135
|
+
When activation is applicable, prove the authoritative first-value branch with
|
|
136
|
+
the smallest existing helper, handler, route, or component test. For a
|
|
137
|
+
backend-confirmed outcome, verify that the success branch returns the canonical
|
|
138
|
+
descriptor only after the real result or durable write succeeds, and that error,
|
|
139
|
+
placeholder, and no-result branches omit it. Verify browser delivery through the
|
|
140
|
+
existing descriptor consumer or one focused test around it. Test a pending
|
|
141
|
+
redirect queue only when the product uses one.
|
|
142
|
+
|
|
143
|
+
Do not replay the whole product journey, build a new browser harness, emit a
|
|
144
|
+
synthetic activation into production stats, or deploy solely to prove logic
|
|
145
|
+
already covered by focused evidence. If the accepted behavior has no discrete
|
|
146
|
+
first-value event and no misleading instrumentation needs repair, no code or
|
|
147
|
+
deployment change is required; report that bounded conclusion, not absent value.
|