@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,499 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-analytics
|
|
3
|
+
description: Set up tracking and report visits, registrations, purchases, revenue and funnel performance.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use for traffic/conversion evidence; offer when tracking gaps prevent measuring progress."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Product analytics"
|
|
8
|
+
egbe-description: "Connect web analytics and see how people use your product, where they drop off and which channels bring signups and purchases."
|
|
9
|
+
egbe-category: "Marketing & growth"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
13
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
14
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
15
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
16
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
17
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
18
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
19
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
20
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
21
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
22
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
23
|
+
`path` and `business`, and that `continuation`.
|
|
24
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
25
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
26
|
+
|
|
27
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
28
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
29
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
30
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
31
|
+
set-up project workspace. In a persistent
|
|
32
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
33
|
+
project setup describes.
|
|
34
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
35
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
36
|
+
|
|
37
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
38
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
39
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
40
|
+
saying Egbe is unavailable.
|
|
41
|
+
|
|
42
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
43
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
44
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
45
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
46
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
47
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
48
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
49
|
+
with an agent on their own computer. Code can also be published without the
|
|
50
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
51
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
52
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
53
|
+
deployment.
|
|
54
|
+
|
|
55
|
+
Run a script bundled with this skill from the root of a project folder set up
|
|
56
|
+
for Egbe, with `OS_AGENT_NAME="<your agent name>"` set inline, such as `OpenCode`.
|
|
57
|
+
A script that calls Egbe reads `OS_URL`, `OS_API_KEY` and this agent's connection
|
|
58
|
+
ID from `.env.local` through Egbe's request helper, which comes with the plugin at
|
|
59
|
+
`../egbe-os-quickstart/scripts/egbe-curl.py` from this skill's folder. Where this
|
|
60
|
+
skill says a script needs `OS_URL` or `OS_API_KEY` in its environment, start it
|
|
61
|
+
through the helper, which loads `.env.local` without executing it:
|
|
62
|
+
`python3 <helper> --egbe-run <command>`, with the helper's absolute path. Where
|
|
63
|
+
this skill writes `<skills-directory>`, use the plugin's `skills` folder, which
|
|
64
|
+
holds this skill's folder.
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
# Analytics
|
|
68
|
+
|
|
69
|
+
Privacy-friendly product analytics through the egbe OS analytics capability.
|
|
70
|
+
Authenticate with `Authorization: Bearer $OS_API_KEY`. Base URL:
|
|
71
|
+
`https://os.hz.egbe.dev`.
|
|
72
|
+
|
|
73
|
+
This skill is the source of truth for product analytics event names, attribution,
|
|
74
|
+
and validation rules. Product workflows reference this
|
|
75
|
+
contract instead of inventing event names, UTM fields, or attribution payloads.
|
|
76
|
+
|
|
77
|
+
The canonical contract defines valid event semantics and delivery, not the
|
|
78
|
+
complete measurement inventory for every product. Derive applicable coverage
|
|
79
|
+
additively from the caller-supplied product requirements and real behavior.
|
|
80
|
+
Never select one product-type minimum as a substitute for that inventory.
|
|
81
|
+
|
|
82
|
+
## Canonical Event Contract
|
|
83
|
+
|
|
84
|
+
Read the machine-readable event config:
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/events" -s
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
Canonical product events:
|
|
91
|
+
|
|
92
|
+
- `campaign-visit` - system first-touch acquisition event emitted by the shared
|
|
93
|
+
tracking snippet for explicit UTM/click-id campaign attribution. Keep this
|
|
94
|
+
exact name; analytics-gateway campaign reports are built around it.
|
|
95
|
+
- `cta_click` - primary conversion-driving CTA click.
|
|
96
|
+
- `button_click` - meaningful non-primary button click.
|
|
97
|
+
- `activated` - real first-value/core-action completion.
|
|
98
|
+
- `signup_started`
|
|
99
|
+
- `signup_submitted`
|
|
100
|
+
- `signup_completed`
|
|
101
|
+
- `email_verified`
|
|
102
|
+
- `paywall_view`
|
|
103
|
+
- `checkout_started`
|
|
104
|
+
- `purchase`
|
|
105
|
+
- `subscription_renewed`
|
|
106
|
+
- `subscription_canceled`
|
|
107
|
+
- `refund`
|
|
108
|
+
|
|
109
|
+
Use event payload fields for product-specific details. Do not encode page,
|
|
110
|
+
product, button, or activation details in the event name. For example, use
|
|
111
|
+
`activated` with `activation_type: "audit_generated"` rather than
|
|
112
|
+
`activation:audit_generated`.
|
|
113
|
+
|
|
114
|
+
## Complete Product Funnel
|
|
115
|
+
|
|
116
|
+
When planning or implementing analytics across a complete Product journey,
|
|
117
|
+
read:
|
|
118
|
+
|
|
119
|
+
```text
|
|
120
|
+
references/workflows/product-funnel-tracking.md
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
Use it to account for every caller-required measurement moment, map applicable
|
|
124
|
+
pageviews, meaningful interactions, core outcomes, signup, and verification to
|
|
125
|
+
the live canonical contract, reuse existing analytics wiring, and select only
|
|
126
|
+
the focused workflows the product needs.
|
|
127
|
+
|
|
128
|
+
## Landing Click Tracking
|
|
129
|
+
|
|
130
|
+
When instrumenting public landing, pricing, demo, or pre-auth product surfaces,
|
|
131
|
+
use this installed skill and read:
|
|
132
|
+
|
|
133
|
+
```text
|
|
134
|
+
references/workflows/landing-click-tracking.md
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
That workflow explains how the canonical click payload fields map to HTML
|
|
138
|
+
`data-umami-event-*` attributes and includes complete `cta_click` and
|
|
139
|
+
`button_click` examples. It distinguishes ordinary navigation from
|
|
140
|
+
JavaScript-handled links: use a button for an in-page action or emit once from
|
|
141
|
+
the existing link handler without a declarative trigger. It also owns bounded
|
|
142
|
+
verification: inspect declarative attributes, and check JavaScript-owned CTA
|
|
143
|
+
behavior with a real click while the tracker is loaded and collection is isolated.
|
|
144
|
+
|
|
145
|
+
Use `cta_click` for the page's primary conversion or evaluation action. It is
|
|
146
|
+
not limited to `/signup`; a product demo, generated sample, waitlist, checkout,
|
|
147
|
+
contact-sales, or install action can be a CTA when that is the primary next
|
|
148
|
+
step. Use `button_click` for meaningful secondary interactions only.
|
|
149
|
+
|
|
150
|
+
## Signup Lifecycle Tracking
|
|
151
|
+
|
|
152
|
+
When instrumenting signup, registration, account creation, or lead-capture
|
|
153
|
+
flows, use this installed skill and read:
|
|
154
|
+
|
|
155
|
+
```text
|
|
156
|
+
references/workflows/signup-lifecycle-tracking.md
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
That workflow explains browser `signup_started` / `signup_submitted` delivery,
|
|
160
|
+
backend-confirmed `signup_completed`, conditional `email_verified`, first-touch
|
|
161
|
+
attribution handoff, the short-lived pending queue pattern for redirecting
|
|
162
|
+
signup flows, and how an app declares an account table other than `users` so
|
|
163
|
+
Dashboard Analytics can count its registrations.
|
|
164
|
+
|
|
165
|
+
## Activation Tracking
|
|
166
|
+
|
|
167
|
+
When instrumenting a product's real first-value moment or core action
|
|
168
|
+
completion, use this installed skill and read:
|
|
169
|
+
|
|
170
|
+
```text
|
|
171
|
+
references/workflows/activation-tracking.md
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
That workflow explains when to emit canonical `activated`, how to use
|
|
175
|
+
`activation_type`, how to preserve first-touch attribution, and how to deliver a
|
|
176
|
+
backend-confirmed activation descriptor from the browser session.
|
|
177
|
+
|
|
178
|
+
## Payment Lifecycle Tracking
|
|
179
|
+
|
|
180
|
+
When instrumenting paywalls, checkout, purchases, subscriptions, cancellation,
|
|
181
|
+
or refunds, use this installed skill and read:
|
|
182
|
+
|
|
183
|
+
```text
|
|
184
|
+
references/workflows/payment-lifecycle-tracking.md
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
That workflow separates browser-session payment events from signed
|
|
188
|
+
out-of-session lifecycle events and defines how checkout attribution reaches
|
|
189
|
+
durable payment state. The machine-readable event contract remains authoritative
|
|
190
|
+
for required payload fields.
|
|
191
|
+
|
|
192
|
+
## Attribution
|
|
193
|
+
|
|
194
|
+
The shared tracking snippet stores first-touch attribution in the browser and
|
|
195
|
+
exposes it as:
|
|
196
|
+
|
|
197
|
+
```js
|
|
198
|
+
window.__egbeAttribution.read()
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
The snippet emits `campaign-visit` only when the visitor has explicit campaign
|
|
202
|
+
or click-id attribution such as `utm_*`, `gclid`, `fbclid`, `msclkid`, or
|
|
203
|
+
`ttclid`. Referrer-only visits do not fire `campaign-visit` by themselves; use
|
|
204
|
+
Umami's native referrer fields for organic/referral reporting. When
|
|
205
|
+
`campaign-visit` does fire, include `referrer` as an optional payload field if
|
|
206
|
+
the browser provides one.
|
|
207
|
+
|
|
208
|
+
Forward that payload into signup and checkout requests when the product has a
|
|
209
|
+
backend flow. Persist the first-touch fields with the durable signup, user, or
|
|
210
|
+
payment metadata so later revenue reporting can join back to the original
|
|
211
|
+
channel.
|
|
212
|
+
|
|
213
|
+
Recommended attribution fields:
|
|
214
|
+
|
|
215
|
+
- `visitor_id`
|
|
216
|
+
- `visit_id`
|
|
217
|
+
- `first_utm_source`
|
|
218
|
+
- `first_utm_medium`
|
|
219
|
+
- `first_utm_campaign`
|
|
220
|
+
- `first_utm_content`
|
|
221
|
+
- `first_utm_term`
|
|
222
|
+
- `first_gclid`
|
|
223
|
+
- `first_fbclid`
|
|
224
|
+
- `first_msclkid`
|
|
225
|
+
- `first_ttclid`
|
|
226
|
+
- `first_landing_path`
|
|
227
|
+
- `first_referrer`
|
|
228
|
+
- `first_seen_at`
|
|
229
|
+
|
|
230
|
+
First-touch fields should remain stable for the visitor. Later touch data may
|
|
231
|
+
be stored separately, but channel-level reports use first-touch by default.
|
|
232
|
+
|
|
233
|
+
## Lifecycle Event Delivery
|
|
234
|
+
|
|
235
|
+
Separate two responsibilities:
|
|
236
|
+
|
|
237
|
+
- **confirmation source**: the code that knows the durable lifecycle fact is
|
|
238
|
+
true;
|
|
239
|
+
- **Umami delivery**: the code that sends the canonical event to Umami.
|
|
240
|
+
|
|
241
|
+
For user-session funnel events, the backend may confirm the fact, but the
|
|
242
|
+
browser must deliver the Umami event with `window.umami.track(...)`. Direct
|
|
243
|
+
backend `/api/send` calls can appear in aggregate charts but may receive a
|
|
244
|
+
different Umami `session_id`, so they do not reliably appear in the user's
|
|
245
|
+
session timeline.
|
|
246
|
+
|
|
247
|
+
Use this pattern for browser-session lifecycle events:
|
|
248
|
+
|
|
249
|
+
1. Browser sends first-touch attribution from `window.__egbeAttribution.read()`
|
|
250
|
+
with the product request.
|
|
251
|
+
2. Backend performs the durable state change.
|
|
252
|
+
3. Backend returns an analytics descriptor only after success:
|
|
253
|
+
|
|
254
|
+
```json
|
|
255
|
+
{
|
|
256
|
+
"ok": true,
|
|
257
|
+
"analytics": {
|
|
258
|
+
"name": "signup_completed",
|
|
259
|
+
"data": {
|
|
260
|
+
"product_slug": "my-app",
|
|
261
|
+
"path": "/signup",
|
|
262
|
+
"surface": "signup_form",
|
|
263
|
+
"account_id": "123",
|
|
264
|
+
"visitor_id": "...",
|
|
265
|
+
"visit_id": "...",
|
|
266
|
+
"first_utm_source": "meta"
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
4. Browser sends the descriptor with the loaded Umami tracker:
|
|
273
|
+
|
|
274
|
+
```js
|
|
275
|
+
if (data.analytics?.name && window.umami?.track) {
|
|
276
|
+
window.umami.track(data.analytics.name, data.analytics.data || {});
|
|
277
|
+
}
|
|
278
|
+
```
|
|
279
|
+
|
|
280
|
+
If the success flow redirects immediately, put the descriptor in a short-lived
|
|
281
|
+
`sessionStorage` pending queue, navigate, then flush it from the next page with
|
|
282
|
+
`window.umami.track(...)`.
|
|
283
|
+
|
|
284
|
+
Use server-confirmed browser delivery for:
|
|
285
|
+
|
|
286
|
+
- `activated` when first value is created by an API/server action;
|
|
287
|
+
- `signup_completed`;
|
|
288
|
+
- `email_verified` when the verification completes in a browser return page;
|
|
289
|
+
- `checkout_started` before redirecting to checkout;
|
|
290
|
+
- `purchase` when a checkout success page can confirm paid state with the
|
|
291
|
+
backend.
|
|
292
|
+
|
|
293
|
+
Backend direct delivery is only for webhook, renewal, refund, admin/system, or
|
|
294
|
+
other out-of-session events with no browser session to join:
|
|
295
|
+
|
|
296
|
+
- subscription renewals;
|
|
297
|
+
- refunds;
|
|
298
|
+
- webhook-only purchases where no success return can emit from the browser;
|
|
299
|
+
- admin/system subscription cancellations.
|
|
300
|
+
|
|
301
|
+
When backend direct delivery is used, persist first-touch attribution with the
|
|
302
|
+
account/payment metadata so revenue and retention reporting can still join back
|
|
303
|
+
to the acquisition channel. Treat Umami `{"beep":"boop"}` as filtered delivery,
|
|
304
|
+
not success, if a backend collector send is used.
|
|
305
|
+
|
|
306
|
+
Do not use optional `engagement-click`, `engagement-scroll`, or
|
|
307
|
+
`engagement-time` telemetry as canonical funnel coverage. Those events are not
|
|
308
|
+
aliases for `cta_click`, `button_click`, or lifecycle events.
|
|
309
|
+
|
|
310
|
+
## Register a Site and Get Tracking
|
|
311
|
+
|
|
312
|
+
```bash
|
|
313
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics" -s -X POST \
|
|
314
|
+
-H "Content-Type: application/json" \
|
|
315
|
+
-d '{"app":"my-app","domain":"my-app-abc1234.n.egbe.app"}'
|
|
316
|
+
|
|
317
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/my-app/tracking" -s
|
|
318
|
+
```
|
|
319
|
+
|
|
320
|
+
**Always pass `domain` = your deployed public host.** Umami only counts pageviews
|
|
321
|
+
whose hostname matches the site's registered `domain`; if you omit it the domain
|
|
322
|
+
stays null and every event is dropped, so stats read 0 no matter how much real
|
|
323
|
+
traffic arrives. Use the `host` the deploy returned (`<slug>-<public_id>.n.egbe.app`),
|
|
324
|
+
not the bare slug. You can re-POST with an updated `domain` any time.
|
|
325
|
+
|
|
326
|
+
Embed the returned `trackingSnippet` once in the app shell/layout and complete
|
|
327
|
+
the required Session Replay setup below. Prefer the shared snippet over
|
|
328
|
+
hand-building a raw Umami `<script>` because it includes first-touch campaign
|
|
329
|
+
attribution and `campaign-visit` support.
|
|
330
|
+
|
|
331
|
+
## Session Replay
|
|
332
|
+
|
|
333
|
+
Session recording is required when setting up analytics for a new product,
|
|
334
|
+
including local-agent work without a preset or scaffold. The standard scaffold
|
|
335
|
+
already performs this setup; preserve its tracker, recorder, and configuration.
|
|
336
|
+
|
|
337
|
+
Sites are provisioned with session replay enabled, but the base `trackingSnippet`
|
|
338
|
+
(`script.js`) does **not** load the recorder by itself. Replay stays silently at
|
|
339
|
+
zero sessions until you embed a **second** tag.
|
|
340
|
+
|
|
341
|
+
### Set up recording without a scaffold
|
|
342
|
+
|
|
343
|
+
1. Register the site with its public hostname as described above.
|
|
344
|
+
2. Explicitly enable recording and save the product settings: `sampleRate: 1.0`
|
|
345
|
+
(100% of sessions), `maskLevel: "moderate"`, and `maxDuration: 1800000`
|
|
346
|
+
(30 minutes). Do not rely on the gateway's older sampling/duration defaults.
|
|
347
|
+
|
|
348
|
+
```bash
|
|
349
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/my-app/replay" -fsS -X POST \
|
|
350
|
+
-H "Content-Type: application/json" \
|
|
351
|
+
-d '{"enabled":true,"replayConfig":{"sampleRate":1.0,"maskLevel":"moderate","maxDuration":1800000}}'
|
|
352
|
+
|
|
353
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/my-app/tracking" -fsS
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
3. Read `data` from the tracking response. It contains a ready-to-paste
|
|
357
|
+
`recorderSnippet` alongside `trackingSnippet`:
|
|
358
|
+
|
|
359
|
+
```json
|
|
360
|
+
{
|
|
361
|
+
"trackingSnippet": "<script defer src=\".../script.js\" data-website-id=...></script>",
|
|
362
|
+
"replayEnabled": true,
|
|
363
|
+
"replayConfig": {"sampleRate": 1, "maskLevel": "moderate", "maxDuration": 1800000},
|
|
364
|
+
"recorderScriptUrl": "https://analytics.hz.egbe.dev/recorder.js",
|
|
365
|
+
"recorderSnippet": "<script defer src=\".../recorder.js\" data-website-id=... data-sample-rate=... data-mask-level=... data-max-duration=...></script>"
|
|
366
|
+
}
|
|
367
|
+
```
|
|
368
|
+
|
|
369
|
+
4. Embed **both** tags once in the shared app shell/layout — `trackingSnippet`
|
|
370
|
+
for pageviews and events, `recorderSnippet` for session replay on all pages.
|
|
371
|
+
Keep the recorder's returned `src`, `defer`, `data-website-id`,
|
|
372
|
+
`data-sample-rate="1"`, `data-mask-level="moderate"`, and
|
|
373
|
+
`data-max-duration="1800000"`. In Next.js, use `next/script` with stable IDs
|
|
374
|
+
and `strategy="afterInteractive"` in the root layout, preserving the same
|
|
375
|
+
attributes. Keep the tracker and its attribution script as well.
|
|
376
|
+
|
|
377
|
+
If replay is disabled or the recorder snippet is missing after setup, resolve
|
|
378
|
+
the configuration error before considering analytics setup complete. A site
|
|
379
|
+
with only the base tracker does not have session recording.
|
|
380
|
+
|
|
381
|
+
5. Add a privacy-page disclosure that the product uses masked session recordings
|
|
382
|
+
of page interactions to improve usability, with recording enabled for all
|
|
383
|
+
sessions and capped at 30 minutes. Preserve the scaffold's disclosure when
|
|
384
|
+
using it, and link the page from the product footer. Exclude sensitive displayed
|
|
385
|
+
content using `blockSelector` in `replayConfig` (returned as
|
|
386
|
+
`data-block-selector`); input masking alone does not hide all page text.
|
|
387
|
+
|
|
388
|
+
Verify the wiring and attributes locally. After publication, confirm the Replays
|
|
389
|
+
list in the site's Umami dashboard (or its share link) fills as real sessions
|
|
390
|
+
arrive. Do not send synthetic production events for this check.
|
|
391
|
+
|
|
392
|
+
## Read Stats and Campaigns
|
|
393
|
+
|
|
394
|
+
```bash
|
|
395
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/my-app/stats?period=7d" -s
|
|
396
|
+
|
|
397
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/my-app/campaigns?period=all" -s
|
|
398
|
+
```
|
|
399
|
+
|
|
400
|
+
`period` is `1h | 24h | 7d | 30d | all` (default `24h` for stats, `all` for
|
|
401
|
+
campaigns). For a calendar day or another exact interval, supply both `from`
|
|
402
|
+
and `to` as ISO 8601 timestamps with a timezone (`Z` or an explicit UTC offset).
|
|
403
|
+
The interval is start-inclusive and end-exclusive: `[from, to)`. These bounds
|
|
404
|
+
override `period`; `to` must be later than `from`. Timestamps are normalized to
|
|
405
|
+
UTC at millisecond precision; date-only or timezone-less values are rejected.
|
|
406
|
+
|
|
407
|
+
For example, the full day 20 October 2026 in Europe/Lisbon is:
|
|
408
|
+
|
|
409
|
+
```bash
|
|
410
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/my-app/stats" -sG \
|
|
411
|
+
--data-urlencode 'from=2026-10-20T00:00:00+01:00' \
|
|
412
|
+
--data-urlencode 'to=2026-10-21T00:00:00+01:00'
|
|
413
|
+
```
|
|
414
|
+
|
|
415
|
+
Use the same bounds with `/campaigns`. Derive each boundary in the report's
|
|
416
|
+
timezone, including its offset at that instant: a calendar day can be 23 or 25
|
|
417
|
+
hours across daylight-saving changes. For today so far, use local midnight to
|
|
418
|
+
the report cutoff; for the previous complete day, use consecutive local
|
|
419
|
+
midnights. A rolling `period=24h` is not either calendar-day window.
|
|
420
|
+
|
|
421
|
+
Stats are for reporting and real channel iteration decisions. Do not send
|
|
422
|
+
synthetic product events just to make stats pass a readiness check.
|
|
423
|
+
|
|
424
|
+
For individual event rows, read `/analytics/<appSlug>/events` and
|
|
425
|
+
`/analytics/<appSlug>/event-data` with `startAt` / `endAt` (inclusive UTC Unix
|
|
426
|
+
milliseconds), `page` (from 1) and `pageSize` (up to 500). Each envelope's `data`
|
|
427
|
+
contains `{data: [...], count, page, pageSize}`. Join event `id` to property
|
|
428
|
+
row `eventId`; paginate both through `count` with the same window. For a funnel
|
|
429
|
+
analysis, use the [session evidence collector](references/session-funnel.md)
|
|
430
|
+
to retain sanitized inputs and reproduce the calculation offline; through the
|
|
431
|
+
Egbe connector alone, follow its
|
|
432
|
+
[connector recipe](references/session-funnel.md#through-the-egbe-connector).
|
|
433
|
+
|
|
434
|
+
## Reporting customer metrics
|
|
435
|
+
|
|
436
|
+
When reporting registrations, buyers, purchases, or revenue, exclude known
|
|
437
|
+
synthetic activity from customer totals. Check the available account/payment
|
|
438
|
+
records and product verification history for validation identities, agent or
|
|
439
|
+
smoke/E2E runs, and explicit test markers such as `livemode=false` or
|
|
440
|
+
`metadata.egbe_test`. A live-mode payment can still be a documented test.
|
|
441
|
+
|
|
442
|
+
Use evidence tied to the account or transaction, not suspicious email spelling
|
|
443
|
+
alone. Separate unresolved records from confirmed tests and qualify totals when
|
|
444
|
+
their customer status is uncertain. Apply the same exclusions to related
|
|
445
|
+
registration, buyer, purchase, and revenue calculations; count distinct accounts
|
|
446
|
+
or buyers separately from payment/event counts. A pending checkout is not a
|
|
447
|
+
purchase.
|
|
448
|
+
|
|
449
|
+
Prefer the product's account records for registrations and confirmed payment
|
|
450
|
+
records for purchases. If only aggregate analytics is available and test activity
|
|
451
|
+
cannot be isolated, label it as unfiltered events, not verified customer totals.
|
|
452
|
+
Do not estimate exclusions from unrelated periods or incomplete samples.
|
|
453
|
+
|
|
454
|
+
Briefly state the source, reporting period, excluded test counts and evidence,
|
|
455
|
+
and any unresolved activity or coverage gaps. Filter the report, not the source
|
|
456
|
+
records; use existing data rather than adding instrumentation for this answer.
|
|
457
|
+
|
|
458
|
+
## Public Dashboard Share Link
|
|
459
|
+
|
|
460
|
+
```bash
|
|
461
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/my-app/share" -s -X POST
|
|
462
|
+
```
|
|
463
|
+
|
|
464
|
+
The response carries `shareUrl`.
|
|
465
|
+
|
|
466
|
+
## List and Inspect Sites
|
|
467
|
+
|
|
468
|
+
```bash
|
|
469
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics" -s
|
|
470
|
+
|
|
471
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/my-app" -s
|
|
472
|
+
```
|
|
473
|
+
|
|
474
|
+
## Validation Policy
|
|
475
|
+
|
|
476
|
+
Verify instrumentation proportionally. Do not use synthetic product events as
|
|
477
|
+
funnel-readiness proof.
|
|
478
|
+
|
|
479
|
+
- Setup: the analytics site exists and tracking config is available.
|
|
480
|
+
- Wiring: the tracking snippet or public analytics env is present in the app
|
|
481
|
+
shell and live app wiring.
|
|
482
|
+
- Declarative interaction tracking: inspect the built or rendered clickable
|
|
483
|
+
element and its canonical `data-umami-event-*` attributes. Static attributes
|
|
484
|
+
do not require a browser journey or network interception proof.
|
|
485
|
+
- Imperative behavior: when event delivery depends on a runtime branch or an
|
|
486
|
+
authoritative success boundary, drive the smallest relevant flow and
|
|
487
|
+
intercept/mock analytics delivery without writing test events into production
|
|
488
|
+
stats.
|
|
489
|
+
- Observation: read real stats from real users for reports and channel-level
|
|
490
|
+
decisions.
|
|
491
|
+
|
|
492
|
+
Do not fake non-existent lifecycle events. If a product has no signup, payment,
|
|
493
|
+
subscription, or refund lifecycle yet, mark that area as not applicable or
|
|
494
|
+
pending in product metadata instead of emitting fake events.
|
|
495
|
+
|
|
496
|
+
## Privacy
|
|
497
|
+
|
|
498
|
+
Do not put raw emails, secrets, tokens, direct personal identifiers, or payment
|
|
499
|
+
details into Umami payloads. Use non-sensitive internal IDs only when needed.
|