@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,207 @@
|
|
|
1
|
+
# Implementation
|
|
2
|
+
|
|
3
|
+
Build the quiz as one new route of the product's existing application. Keep
|
|
4
|
+
the product's framework, package manager, lockfile, Dockerfile, monitoring,
|
|
5
|
+
analytics, and deploy configuration.
|
|
6
|
+
|
|
7
|
+
## 1. Inspect the application
|
|
8
|
+
|
|
9
|
+
Before writing code, find:
|
|
10
|
+
|
|
11
|
+
- the framework and how it declares routes;
|
|
12
|
+
- the design in use: `egbe-docs/product/design.md` when it exists, and the styles, fonts,
|
|
13
|
+
and components of the current pages;
|
|
14
|
+
- the analytics wiring: the shared tracker and the session recorder in the
|
|
15
|
+
application shell, and how the product's own pages hand their events over,
|
|
16
|
+
through `window.umami.track` or through `window.__egbeAttribution.track`;
|
|
17
|
+
- the legal pages and the consent mechanism, if any;
|
|
18
|
+
- the routes of signup and checkout when the goal needs them.
|
|
19
|
+
|
|
20
|
+
## 2. Add the engine and the specification
|
|
21
|
+
|
|
22
|
+
- Copy `assets/engine/quiz-engine.mjs`, `quiz-history.mjs`, and their
|
|
23
|
+
`.d.mts` files into the application source unchanged. The engine holds the
|
|
24
|
+
state, resolves what each screen and the result say, builds the destination,
|
|
25
|
+
and describes the analytics events. The history module keeps the entries of
|
|
26
|
+
the browser's history consistent. Neither has dependencies or touches the
|
|
27
|
+
page.
|
|
28
|
+
- Copy the compiled `quiz.public.json` into the application source and import
|
|
29
|
+
it, so that it is delivered with the page. Do not fetch it after the page
|
|
30
|
+
has loaded, do not retype copy into components, and do not edit the copy of
|
|
31
|
+
the file; change `quiz.json` and compile again.
|
|
32
|
+
- Create the quiz with `createQuiz(spec, { storage, onEvent })`. `onEvent`
|
|
33
|
+
receives the analytics descriptors that [measurement.md](measurement.md)
|
|
34
|
+
explains. `storage` is the session storage of the browser: read
|
|
35
|
+
`window.sessionStorage` inside a `try` block, and pass `null` when it is
|
|
36
|
+
blocked and wherever the code runs on the server. The engine works without
|
|
37
|
+
storage.
|
|
38
|
+
- Where the page is rendered before the browser runs its module, on the server
|
|
39
|
+
or at build time, render the accepted first screen there and show saved progress
|
|
40
|
+
once the module has started in the browser, so that both renderings agree.
|
|
41
|
+
`assets/reference/quiz-first-screen.mjs` provides a dependency-free escaped
|
|
42
|
+
renderer for that first screen. Load `quiz-bootstrap.js` as a small classic
|
|
43
|
+
script after that markup and before the page module to capture early actions.
|
|
44
|
+
The reference binding drains them through `quiz-early-actions.mjs` once,
|
|
45
|
+
against the restored screen; port the same behavior to the product framework.
|
|
46
|
+
|
|
47
|
+
## 3. Bind the engine to the page
|
|
48
|
+
|
|
49
|
+
`assets/reference/quiz-page.mjs` is a complete binding for a plain page. It
|
|
50
|
+
shows which engine call belongs to which interaction. Port its behavior to the
|
|
51
|
+
product's framework; do not ship its styling.
|
|
52
|
+
|
|
53
|
+
| Interaction | Engine call |
|
|
54
|
+
|---|---|
|
|
55
|
+
| Render the current screen | `snapshot()` |
|
|
56
|
+
| Visitor chooses an option of a single-choice question | `select(optionId, screenId)` |
|
|
57
|
+
| Visitor switches an option of a multi-select question | `toggle(optionId, screenId)` |
|
|
58
|
+
| Visitor presses the button of a multi-select or interstitial screen | `advance(screenId)` |
|
|
59
|
+
| Render the result | `result()` and `cta(attribution)` |
|
|
60
|
+
|
|
61
|
+
`screenId` is the id of the screen the visitor acted on. The engine ignores an
|
|
62
|
+
action that arrives after the screen has changed. An interstitial screen in a
|
|
63
|
+
snapshot already carries the texts, points, image, and proof for the answers
|
|
64
|
+
given. Render the note of a call to action directly under its button.
|
|
65
|
+
|
|
66
|
+
`onEvent` hands each descriptor to analytics exactly once, in the way the
|
|
67
|
+
product's own pages do. The reference binding sends through
|
|
68
|
+
`window.umami.track` and keeps its own queue while the tracker loads. Where
|
|
69
|
+
the product hands events to `window.__egbeAttribution.track(name, data)`, do
|
|
70
|
+
not repeat an event when that call returns `false`: while the tracker is
|
|
71
|
+
loading, the runtime has kept the event, and a second hand-over counts the
|
|
72
|
+
answer twice. [measurement.md](measurement.md) describes both under Delivery.
|
|
73
|
+
|
|
74
|
+
Going back belongs to the engine and to the history together. Create the
|
|
75
|
+
history with `createQuizHistory(window.history, spec.quiz_slug)`:
|
|
76
|
+
|
|
77
|
+
| Moment | Calls |
|
|
78
|
+
|---|---|
|
|
79
|
+
| The page shows the quiz | `history.mount(index)` with the index the engine starts on |
|
|
80
|
+
| The visitor has moved forward to a screen | `history.forward(index)` |
|
|
81
|
+
| The visitor presses the back control | `history.back()`; when it returns `false`, `quiz.back()` and then `history.replace(index)` |
|
|
82
|
+
| The browser reports a move (`popstate`) | `history.follow(event.state)`; when it returns an index, `quiz.goTo(index)` |
|
|
83
|
+
|
|
84
|
+
## 4. Required behavior
|
|
85
|
+
|
|
86
|
+
- The accepted first screen is present when the page loads: a question or an
|
|
87
|
+
interstitial introduction. Do not insert an unrequested loading step.
|
|
88
|
+
- `select` and `advance` return the result at once when the answers decide a
|
|
89
|
+
`not_fit` result. Render it like any result: `history.forward(index)` adds
|
|
90
|
+
one entry for the jump, and the back control returns to the deciding
|
|
91
|
+
question through the history.
|
|
92
|
+
- Where the first screen is part of the delivered document, a visitor can
|
|
93
|
+
tap an option before the page's module is ready. That tap must not be lost.
|
|
94
|
+
Until the module starts, a few lines of script in the document keep the
|
|
95
|
+
tap in a variable of the page, as the ids of its screen and its option, and
|
|
96
|
+
show the option as chosen. For a single-choice question the last tap
|
|
97
|
+
counts. For a multi-select question every tap is kept in order, and the
|
|
98
|
+
button stays disabled until the module has started. When the module starts,
|
|
99
|
+
it applies the kept tap through the same path as a tap it receives itself:
|
|
100
|
+
the answer to a single-choice question is stored and reported, and the next
|
|
101
|
+
screen appears. It applies the tap only when the quiz starts on the screen
|
|
102
|
+
that was tapped: a visitor with saved progress starts further on. For an
|
|
103
|
+
introductory interstitial, preserve its continue action once, using its
|
|
104
|
+
screen ID; do not replay it against a restored later screen.
|
|
105
|
+
- A single-choice option shows its selected state for a moment, 150 to 250
|
|
106
|
+
milliseconds, and the next screen appears. During that moment every other
|
|
107
|
+
control is ignored. Under a reduced-motion preference the next screen
|
|
108
|
+
appears at once.
|
|
109
|
+
- For about a third of a second after a new screen appears, taps are ignored:
|
|
110
|
+
the second tap of a double tap must not answer the next question.
|
|
111
|
+
- Switching an option of a multi-select question changes that option in
|
|
112
|
+
place. The screen is not rendered again, and focus and scroll position stay
|
|
113
|
+
where they are.
|
|
114
|
+
- The button of a multi-select question is disabled until an option is chosen.
|
|
115
|
+
- A back control and a progress indicator are present from the second screen
|
|
116
|
+
on. The engine has no skip operation; represent an accepted refusal as an
|
|
117
|
+
escape option or choose another implementation when the UX requires skipping.
|
|
118
|
+
- The browser's own back returns to the previous screen instead of leaving the
|
|
119
|
+
quiz, and from the first screen it leaves the quiz. The history module
|
|
120
|
+
adds an entry for each screen the visitor moves forward to, without changing
|
|
121
|
+
the address, and keeps what the application's router stores in an entry.
|
|
122
|
+
Stop listening to the browser when the quiz is removed from the page.
|
|
123
|
+
- While the browser steps back, a second press of the back control is
|
|
124
|
+
ignored.
|
|
125
|
+
- Reloading the page keeps the progress and the history: the back control and
|
|
126
|
+
the browser's back step through the same screens as before the reload.
|
|
127
|
+
- Verify responsive layout and keyboard/touch access on the target viewport,
|
|
128
|
+
including long accepted option lists. No content or controls may be clipped
|
|
129
|
+
or made unreachable; vertical scrolling is supported.
|
|
130
|
+
- Options are real buttons at least 48 pixels high; the whole row responds to
|
|
131
|
+
a tap.
|
|
132
|
+
- Focus moves to the headline of each new screen, and to the confirmation
|
|
133
|
+
after a request form is sent. Focus is visible and contrast is sufficient.
|
|
134
|
+
- The element that contains the quiz declares the language of the quiz, also
|
|
135
|
+
when the application declares another one for the page.
|
|
136
|
+
- Preserve the accepted navigation and the product's privacy, terms and contact
|
|
137
|
+
links. Do not remove unrelated navigation as a default quiz convention.
|
|
138
|
+
|
|
139
|
+
## 5. Design
|
|
140
|
+
|
|
141
|
+
Use the product's design: its type, color, shape, and tone. A visitor who
|
|
142
|
+
later opens the homepage must recognize the same product.
|
|
143
|
+
|
|
144
|
+
An image that says something about the product or the offer is content: it is
|
|
145
|
+
the `media` of a screen or a result in the specification. Decoration, such as
|
|
146
|
+
an icon on an option, is design and stays in the code. For decoration use the
|
|
147
|
+
product's own material or the Egbe OS `images` capability.
|
|
148
|
+
|
|
149
|
+
## 6. Weight
|
|
150
|
+
|
|
151
|
+
Visitors arrive from ads on phones and mobile networks.
|
|
152
|
+
|
|
153
|
+
- Opening the address of the quiz directly shows the accepted first screen. It does
|
|
154
|
+
not show the homepage, a sign-in page, or an empty page that fills in later.
|
|
155
|
+
- The route imports the engine, the specification, and the product's shared
|
|
156
|
+
shell and styles. It imports no feature of the product's application, such
|
|
157
|
+
as its dashboard or editor.
|
|
158
|
+
- Where the framework renders on the server, the first screen is part of the
|
|
159
|
+
delivered page. A page built for static hosting can deliver it as well; see
|
|
160
|
+
the framework notes.
|
|
161
|
+
- Images are sized and compressed; images of later screens load when they are
|
|
162
|
+
needed.
|
|
163
|
+
|
|
164
|
+
## 7. Indexing, privacy, consent
|
|
165
|
+
|
|
166
|
+
- Mark the route `noindex` unless the caller wants it found through search.
|
|
167
|
+
- Mark the options of a sensitive question, as the reference does with
|
|
168
|
+
`data-quiz-private`, and add that selector to the recording block selector
|
|
169
|
+
of the product's analytics, as the Egbe OS `egbe-os-analytics` skill describes.
|
|
170
|
+
- `validation.json` lists under `consent_geographies` the planned countries
|
|
171
|
+
where tracking beyond what is strictly necessary needs consent. When the
|
|
172
|
+
list is not empty, the route uses the product's consent mechanism for
|
|
173
|
+
advertising pixels and session recording. When the product has none, add no
|
|
174
|
+
pixel and report an open launch condition that names what runs on the
|
|
175
|
+
route. A consent notice must leave the first screen and its controls
|
|
176
|
+
usable.
|
|
177
|
+
- Install a channel's pixel only by following the Egbe OS skill of that
|
|
178
|
+
channel.
|
|
179
|
+
|
|
180
|
+
## 8. Framework notes
|
|
181
|
+
|
|
182
|
+
- **Next.js App Router.** Add `src/app/<route>/page.tsx` as a server component
|
|
183
|
+
that sets the page title and `robots`, and renders one client component that
|
|
184
|
+
binds the engine. Import `quiz.public.json` and pass it to `createQuiz`; the
|
|
185
|
+
types accept it without a cast.
|
|
186
|
+
- **Applications with their own server and a fallback to the application
|
|
187
|
+
shell.** The fallback also answers the address of the quiz. Register the
|
|
188
|
+
route explicitly and confirm that the deployed address shows the quiz.
|
|
189
|
+
- **Static hosting.** Publish the quiz as its own document at the route and
|
|
190
|
+
confirm the host serves it at the address without a file extension. The
|
|
191
|
+
first screen can be rendered into that document at build time from
|
|
192
|
+
`quiz.public.json`, with the code that renders it in the browser; without
|
|
193
|
+
that, the page stays empty until its module has loaded. One way is a module
|
|
194
|
+
that describes a screen as a tree of tags, attributes, and texts: the
|
|
195
|
+
browser turns the tree into elements, the build turns it into the text of
|
|
196
|
+
the document. The rule for a tap before the module is ready applies then.
|
|
197
|
+
|
|
198
|
+
## 9. Boundaries
|
|
199
|
+
|
|
200
|
+
Do not change the homepage, pricing, navigation, signup, checkout, or product
|
|
201
|
+
behavior. Outside the route this workflow adds only what
|
|
202
|
+
[conversion-handoff.md](conversion-handoff.md) names: the endpoint of a request
|
|
203
|
+
form and the continuation after signup.
|
|
204
|
+
|
|
205
|
+
Run the application's relevant checks and build. Commit or deploy only when
|
|
206
|
+
that action is in scope, using the product's established release workflow and
|
|
207
|
+
`egbe-os-deploy`. A local implementation is not a claim of live verification.
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# Integration Inputs
|
|
2
|
+
|
|
3
|
+
Reuse accepted project context, including the request, product requirements,
|
|
4
|
+
UX decisions and existing research. A goal already settled there does not need
|
|
5
|
+
to be asked again. Clarify ambiguity that changes the implementation; do not
|
|
6
|
+
invent an offer, disqualification or conversion goal.
|
|
7
|
+
|
|
8
|
+
Before implementing the route identify the product repository, framework,
|
|
9
|
+
existing design and analytics wiring. Keep the quiz in the product application;
|
|
10
|
+
do not create a separate app just to host it. A deployed application and working
|
|
11
|
+
destination are release prerequisites, not prerequisites for discussion,
|
|
12
|
+
reference research or a local implementation.
|
|
13
|
+
|
|
14
|
+
## Destination contract
|
|
15
|
+
|
|
16
|
+
| Accepted goal | Resolve before wiring the handoff |
|
|
17
|
+
|---|---|
|
|
18
|
+
| `call` → `booking_url` | HTTPS scheduling URL and supported attribution/result parameters. Check it opens the intended calendar, without booking. |
|
|
19
|
+
| `call` → `lead_form` | Same-origin endpoint, accepted contact fields, durable storage and notification path; intended behavior on save failure and any onward navigation. |
|
|
20
|
+
| `signup` | Working signup route and what, if anything, the product persists from the quiz. |
|
|
21
|
+
| `payment` | Checkout route, real plan key, exact price and billing period from the plan catalog, and signup continuation when required. Inspect without creating a checkout session. |
|
|
22
|
+
|
|
23
|
+
Booking directly, collecting contact first, and handling a failed save are
|
|
24
|
+
experience decisions. Implement the accepted choice; this skill does not select
|
|
25
|
+
one by default. Missing authentication, database or payment work blocks only
|
|
26
|
+
the dependent integration: describe what remains and use the relevant Egbe
|
|
27
|
+
capability when that work is in scope.
|
|
28
|
+
|
|
29
|
+
## Specification context
|
|
30
|
+
|
|
31
|
+
Record product, audience, offer, traffic geography and source references in
|
|
32
|
+
`quiz.json`. `goal.statement` may summarize the accepted intent; no special
|
|
33
|
+
approval provenance field is needed. Slugs and IDs are stable technical keys,
|
|
34
|
+
not sensitive answers. `inputs.offer.not_for` records actual exclusions, and
|
|
35
|
+
`claims_to_avoid` records known forbidden claims in the visitor's language.
|
|
36
|
+
Verify proof against its attributable source, including the founder's own
|
|
37
|
+
records where available. Unknown is not permission to invent evidence.
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# Measurement
|
|
2
|
+
|
|
3
|
+
The Egbe OS `egbe-os-analytics` skill owns event names, payload fields, attribution,
|
|
4
|
+
and delivery. Read the live contract first:
|
|
5
|
+
|
|
6
|
+
```bash
|
|
7
|
+
OS_AGENT_NAME="<your agent name>" python3 "<skills-directory>/egbe-os-quickstart/scripts/egbe-curl.py" --egbe-request "/analytics/events" -s
|
|
8
|
+
```
|
|
9
|
+
|
|
10
|
+
Reuse the product's registered analytics site and the tracker already in the
|
|
11
|
+
application shell. Do not register another site and do not invent event names.
|
|
12
|
+
|
|
13
|
+
## What the engine reports
|
|
14
|
+
|
|
15
|
+
The engine uses two canonical events of that contract and fills them with
|
|
16
|
+
values of the quiz. When the live contract no longer defines one of them with
|
|
17
|
+
these fields, stop and report the difference; do not rename events yourself.
|
|
18
|
+
|
|
19
|
+
| Moment | Event | Values of the quiz |
|
|
20
|
+
|---|---|---|
|
|
21
|
+
| An option of a single-choice question is chosen | `button_click` | `surface: "quiz"`, `button_id: "<screen>.<option>"`, `button_role: "quiz_answer"`, `position` |
|
|
22
|
+
| A multi-select question is confirmed | `button_click` | `button_id: "<screen>.continue"`, `button_role: "quiz_answer"`, `state: "<option>+<option>"`, `position` |
|
|
23
|
+
| An interstitial screen is passed | `button_click` | `button_id: "<screen>.continue"`, `button_role: "quiz_continue"`, `position` |
|
|
24
|
+
| The call to action of a result is pressed | `cta_click` | `surface: "quiz_result"`, `cta_id: "<result>"`, `cta_role`, `label`, `destination` |
|
|
25
|
+
|
|
26
|
+
- Every event carries `product_slug` and `path`, the route of the quiz.
|
|
27
|
+
- `position` is the number of the screen that was passed, starting at 1.
|
|
28
|
+
- `cta_role` is `call_primary`, `signup_primary`, or `checkout_primary` for
|
|
29
|
+
the goal and `alternative` for a result with its own destination.
|
|
30
|
+
- For a sensitive question the chosen option is left out: a single-choice
|
|
31
|
+
question reports `"<screen>.answered"`, a multi-select question reports no
|
|
32
|
+
`state`.
|
|
33
|
+
|
|
34
|
+
The opening of the quiz is the native page view of the route. Going back,
|
|
35
|
+
switching an option of a multi-select question, and viewing a screen are not
|
|
36
|
+
events.
|
|
37
|
+
|
|
38
|
+
A request form follows the signup and lead capture workflow of the `egbe-os-analytics`
|
|
39
|
+
skill, with `surface: "quiz_lead_form"`. Signup, checkout, and purchase keep
|
|
40
|
+
the events of the product's own flows.
|
|
41
|
+
|
|
42
|
+
Emit the activation event of the contract only when the product requirements
|
|
43
|
+
define the quiz result as the product's first useful output; then follow the
|
|
44
|
+
activation workflow of the `egbe-os-analytics` skill.
|
|
45
|
+
|
|
46
|
+
## Delivery
|
|
47
|
+
|
|
48
|
+
The engine describes the events and passes them to `onEvent`, the function
|
|
49
|
+
given to `createQuiz`; it does not send them. The page delivers each
|
|
50
|
+
descriptor with the browser tracker and adds
|
|
51
|
+
`visitor_id`, `visit_id`, and the first-touch campaign fields from
|
|
52
|
+
`window.__egbeAttribution.read()`.
|
|
53
|
+
|
|
54
|
+
- The tracker loads after the page. The first answer of a fast visitor must
|
|
55
|
+
not be lost, and no answer may be counted twice: hand each event over
|
|
56
|
+
exactly once. How an event waits for the tracker depends on what the
|
|
57
|
+
product's pages send through.
|
|
58
|
+
- Through `window.umami.track`, as the reference binding does: keep the
|
|
59
|
+
events that occur before the tracker is ready in a queue of your own, and
|
|
60
|
+
send each of them when it is.
|
|
61
|
+
- Through `window.__egbeAttribution.track(name, data)`, the runtime of the
|
|
62
|
+
shared tracking snippet: hand the event over and leave the waiting to the
|
|
63
|
+
runtime. While the tracker is still loading, that call returns `false`,
|
|
64
|
+
but it has kept the event and sends it when the tracker is ready, with
|
|
65
|
+
the campaign fields that it adds itself. A binding that repeats an event
|
|
66
|
+
after `false` counts one answer twice. Keep a queue of your own only
|
|
67
|
+
while neither `window.__egbeAttribution` nor `window.umami` exists, and
|
|
68
|
+
hand its events over as soon as one of them does.
|
|
69
|
+
- A call to action that is a link leaves the page. Render its descriptor as
|
|
70
|
+
attributes on the link, as the landing click workflow of the `egbe-os-analytics`
|
|
71
|
+
skill describes, so the tracker delivers the event before the navigation.
|
|
72
|
+
Do not also send it from code. A result's own destination and the
|
|
73
|
+
destinations `booking_url`, `signup`, and `checkout` are links. The button
|
|
74
|
+
that opens a request form is not, and its click is handed over from code.
|
|
75
|
+
- The tracker sends the click of a link as the attributes spell it and adds
|
|
76
|
+
nothing to it. Its keys arrive in kebab-case: `cta-id`, `cta-role`,
|
|
77
|
+
`product-slug`, `visitor-id`. An event handed over from code arrives in
|
|
78
|
+
snake_case: `cta_id`. The first-touch campaign fields reach the click of a
|
|
79
|
+
link only when the page wrote them as attributes, as the reference binding
|
|
80
|
+
does; the runtime adds them to the events it is handed and to nothing else.
|
|
81
|
+
Verified live on 2026-09-29: the click of a link arrived with kebab-case
|
|
82
|
+
keys and, on a page that left the campaign to the runtime, without the
|
|
83
|
+
campaign fields that its events from code carried.
|
|
84
|
+
- The completion of a request is confirmed by the product's endpoint after the
|
|
85
|
+
request is stored, and delivered by the browser from the descriptor in the
|
|
86
|
+
response.
|
|
87
|
+
|
|
88
|
+
Never put contact details, names, or free text into an event.
|
|
89
|
+
|
|
90
|
+
## Reading the quiz
|
|
91
|
+
|
|
92
|
+
Count sessions, not events. An event at position N means that screen N was
|
|
93
|
+
passed. Give these readings to the caller with the report: whoever reads the
|
|
94
|
+
statistics has not read this file.
|
|
95
|
+
|
|
96
|
+
- **Reach of screen 1**: the page views of the route.
|
|
97
|
+
- **Completion of screen N**: sessions with an event at position N.
|
|
98
|
+
- **Reach of screen N**, for N of 2 or more: the completion of screen N − 1.
|
|
99
|
+
- **Loss at screen N**: its reach minus its completion.
|
|
100
|
+
- **Answers**: sessions by `button_id` of one screen.
|
|
101
|
+
- **Result reached**: the completion of the last screen, and the sessions
|
|
102
|
+
whose answers decided a `not_fit` result earlier. Such a session ends its
|
|
103
|
+
events at the position of the deciding answer, so the sessions that reach
|
|
104
|
+
a result early are counted by that answer, not as a loss at the next
|
|
105
|
+
screen. Count them by the answers that decide each `not_fit` result, as
|
|
106
|
+
`QUIZ.md` lists them.
|
|
107
|
+
- **Call to action**: sessions with `cta_click` by `cta_id`, against the
|
|
108
|
+
sessions that reached the result. Read both spellings of every key of
|
|
109
|
+
`cta_click`: the click of a link carries `cta-id` and `cta-role`, the click
|
|
110
|
+
of a button carries `cta_id` and `cta_role`. A report that reads one
|
|
111
|
+
spelling counts only a part of the clicks. Where the click of a link
|
|
112
|
+
carries no campaign field, take the campaign from the other events of the
|
|
113
|
+
same visit.
|
|
114
|
+
- **Conversion**: the records of the destination. Bookings come from the
|
|
115
|
+
scheduling tool, requests from the rows the product stored, accounts and
|
|
116
|
+
payments from the product's own records.
|
|
117
|
+
|
|
118
|
+
## Advertising pixels
|
|
119
|
+
|
|
120
|
+
The conversion event of an advertising channel is set up by the Egbe OS skill
|
|
121
|
+
of that channel and fires where the conversion happens, not on quiz screens.
|
|
122
|
+
The quiz adds no pixel code of its own.
|