@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,357 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Add opt-in workspace identity to curl requests to the configured Egbe URL.
|
|
3
|
+
|
|
4
|
+
Requests made only to that URL with supported options send the installed catalog
|
|
5
|
+
release. Those with a single destination are also traced: they exit 22 on an HTTP
|
|
6
|
+
status of 400 or above (the body is still printed, as with `curl --fail-with-body`)
|
|
7
|
+
and end with one stderr line
|
|
8
|
+
`egbe-curl: status=<code> request_id=<id> route=<METHOD> <path> catalog=<release>`.
|
|
9
|
+
`--egbe-run <command>` instead starts a bundled client with the saved settings
|
|
10
|
+
from `.env.local` in its environment.
|
|
11
|
+
"""
|
|
12
|
+
import os
|
|
13
|
+
import json
|
|
14
|
+
from pathlib import Path
|
|
15
|
+
import re
|
|
16
|
+
import shlex
|
|
17
|
+
import subprocess
|
|
18
|
+
import sys
|
|
19
|
+
import tempfile
|
|
20
|
+
from urllib.parse import quote, urlsplit
|
|
21
|
+
from uuid import UUID
|
|
22
|
+
|
|
23
|
+
CATALOG_DIGEST = re.compile(r"[a-f0-9]{64}")
|
|
24
|
+
MAX_MANIFEST_BYTES = 8 * 1024 * 1024
|
|
25
|
+
DATA_OPTIONS = {"-d", "--data", "--data-raw", "--data-binary", "--data-urlencode", "-F", "--form", "--form-string"}
|
|
26
|
+
SUPPORTED_VALUE_OPTIONS = DATA_OPTIONS | {"-H", "--header", "-X", "--request", "-o", "--output", "-w", "--write-out",
|
|
27
|
+
"--max-time", "--connect-timeout", "--retry", "--retry-delay",
|
|
28
|
+
"--retry-max-time", "-A", "--user-agent", "--url"}
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
def project_environment(settings_file=None, *, saved_credentials=False):
|
|
32
|
+
values = {}
|
|
33
|
+
path = Path(settings_file) if settings_file else Path.cwd() / ".env.local"
|
|
34
|
+
if path.is_symlink():
|
|
35
|
+
raise ValueError("Load connection settings from a regular project-local .env.local file")
|
|
36
|
+
if path.is_file():
|
|
37
|
+
for line in path.read_text().splitlines():
|
|
38
|
+
match = re.match(r"(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)=(.*)", line.strip())
|
|
39
|
+
if match and (match[1] in {"OS_URL", "OS_API_KEY", "OS_WORKSPACE_NAME"} or match[1].startswith("OS_CONNECTION_ID_")
|
|
40
|
+
or (settings_file and match[1] == "OS_AGENT_NAME")):
|
|
41
|
+
parts = shlex.split(match[2], comments=True)
|
|
42
|
+
if len(parts) <= 1:
|
|
43
|
+
values[match[1]] = parts[0] if parts else ""
|
|
44
|
+
# Saved scheduler snapshots own their agent name. Interactive credential
|
|
45
|
+
# files keep the actual agent shell-local; only that name may fall back.
|
|
46
|
+
# UUIDs, nicknames and destination always belong to the selected file.
|
|
47
|
+
if settings_file:
|
|
48
|
+
values.setdefault("OS_AGENT_NAME", os.environ.get("OS_AGENT_NAME", ""))
|
|
49
|
+
return values
|
|
50
|
+
# Identity belongs to this workspace, never an ambient previous project.
|
|
51
|
+
values.update({key: value for key, value in os.environ.items()
|
|
52
|
+
if not (key.startswith("OS_CONNECTION_ID_") or key == "OS_WORKSPACE_NAME"
|
|
53
|
+
or (saved_credentials and key in {"OS_URL", "OS_API_KEY"}))})
|
|
54
|
+
return values
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
def catalog_release(script=__file__):
|
|
58
|
+
"""The skills catalog release of this installation, or None.
|
|
59
|
+
|
|
60
|
+
`.egbe-catalog/manifest.json` beside the installed skills records the
|
|
61
|
+
published skills archive digest the last refresh reconciled. While a refresh
|
|
62
|
+
kept some skills at an earlier release (local edits or conflicts) it records
|
|
63
|
+
only its target, reported with `+partial`. A helper outside an installed
|
|
64
|
+
catalog, or an unreadable manifest, sends no release.
|
|
65
|
+
"""
|
|
66
|
+
parents = Path(os.path.abspath(script)).parents
|
|
67
|
+
if len(parents) < 3:
|
|
68
|
+
return None # e.g. a pre-install copy saved directly in /tmp
|
|
69
|
+
path = parents[2] / ".egbe-catalog" / "manifest.json"
|
|
70
|
+
try:
|
|
71
|
+
if path.is_symlink() or not path.is_file() or path.stat().st_size > MAX_MANIFEST_BYTES:
|
|
72
|
+
return None
|
|
73
|
+
manifest = json.loads(path.read_text())
|
|
74
|
+
except (OSError, ValueError):
|
|
75
|
+
return None
|
|
76
|
+
if not isinstance(manifest, dict):
|
|
77
|
+
return None
|
|
78
|
+
reconciled, target = manifest.get("reconciled"), manifest.get("target")
|
|
79
|
+
if isinstance(reconciled, str) and CATALOG_DIGEST.fullmatch(reconciled):
|
|
80
|
+
return reconciled
|
|
81
|
+
if isinstance(target, str) and CATALOG_DIGEST.fullmatch(target):
|
|
82
|
+
return target + "+partial"
|
|
83
|
+
return None
|
|
84
|
+
|
|
85
|
+
|
|
86
|
+
def curl_destinations(arguments):
|
|
87
|
+
# Consume curl option values before classifying URLs. Extra known options
|
|
88
|
+
# remain pass-through for other hosts, but are not enabled for identity calls.
|
|
89
|
+
value_options = set("""
|
|
90
|
+
--abstract-unix-socket --alt-svc --aws-sigv4 --cacert --capath --cert --cert-type --ciphers
|
|
91
|
+
--config --connect-timeout --connect-to --continue-at --cookie --cookie-jar
|
|
92
|
+
--create-file-mode --crlfile --curves --data --data-ascii --data-binary --data-raw
|
|
93
|
+
--data-urlencode --delegation --dns-interface --dns-ipv4-addr --dns-ipv6-addr --dns-servers
|
|
94
|
+
--doh-url --dump-header --egd-file --engine --etag-compare --etag-save --expect100-timeout
|
|
95
|
+
--form --form-string --ftp-account --ftp-alternative-to-user --ftp-method --ftp-port
|
|
96
|
+
--ftp-ssl-ccc-mode --happy-eyeballs-timeout-ms --haproxy-clientip --header --help
|
|
97
|
+
--hostpubmd5 --hostpubsha256 --hsts --interface --ipfs-gateway --json --keepalive-time --key
|
|
98
|
+
--key-type --krb --libcurl --limit-rate --local-port --login-options --mail-auth --mail-from
|
|
99
|
+
--mail-rcpt --max-filesize --max-redirs --max-time --netrc-file --noproxy --oauth2-bearer
|
|
100
|
+
--output --output-dir --parallel-max --pass --pinnedpubkey --preproxy --proto
|
|
101
|
+
--proto-default --proto-redir --proxy --proxy-cacert --proxy-capath --proxy-cert
|
|
102
|
+
--proxy-cert-type --proxy-ciphers --proxy-crlfile --proxy-header --proxy-key
|
|
103
|
+
--proxy-key-type --proxy-pass --proxy-pinnedpubkey --proxy-service-name
|
|
104
|
+
--proxy-tls13-ciphers --proxy-tlsauthtype --proxy-tlspassword --proxy-tlsuser --proxy-user
|
|
105
|
+
--pubkey --quote --random-file --range --rate --referer --request --request-target --resolve
|
|
106
|
+
--retry --retry-delay --retry-max-time --sasl-authzid --service-name --socks4 --socks4a
|
|
107
|
+
--socks5 --socks5-gssapi-service --socks5-hostname --speed-limit --speed-time --stderr
|
|
108
|
+
--telnet-option --tftp-blksize --time-cond --tls-max --tls13-ciphers --tlsauthtype
|
|
109
|
+
--tlspassword --tlsuser --trace --trace-ascii --trace-config --unix-socket --upload-file
|
|
110
|
+
--url --url-query --user --user-agent --variable --write-out
|
|
111
|
+
""".split()) | {"-" + char for char in "ACDEFHKPQTUXYbcdehmortuwxyz"}
|
|
112
|
+
flags = {"--disable", "--silent", "--show-error", "--fail", "--fail-with-body", "--include",
|
|
113
|
+
"--head", "--get", "--verbose", "--no-buffer", "--globoff", "--compressed",
|
|
114
|
+
"--http1.1", "--http2", "--no-progress-meter"}
|
|
115
|
+
destinations, unsupported = [], False
|
|
116
|
+
index = 0
|
|
117
|
+
while index < len(arguments):
|
|
118
|
+
arg = arguments[index]
|
|
119
|
+
option, equals, value = arg.partition("=")
|
|
120
|
+
if arg == "--":
|
|
121
|
+
destinations.extend(arguments[index + 1:])
|
|
122
|
+
break
|
|
123
|
+
if option in value_options:
|
|
124
|
+
unsupported |= option not in SUPPORTED_VALUE_OPTIONS
|
|
125
|
+
if not equals:
|
|
126
|
+
index += 1
|
|
127
|
+
if index == len(arguments):
|
|
128
|
+
unsupported = True
|
|
129
|
+
break
|
|
130
|
+
value = arguments[index]
|
|
131
|
+
if option == "--url":
|
|
132
|
+
destinations.append(value)
|
|
133
|
+
elif arg in flags or (arg.startswith("-") and not arg.startswith("--")
|
|
134
|
+
and set(arg[1:]) <= set("sSfIivNgG")):
|
|
135
|
+
pass
|
|
136
|
+
elif arg.startswith("-"):
|
|
137
|
+
unsupported = True
|
|
138
|
+
if not arg.startswith("--"):
|
|
139
|
+
# A value-taking short option consumes the rest of its cluster,
|
|
140
|
+
# or the next argument: e.g. -sdURL and -sd URL.
|
|
141
|
+
for position, char in enumerate(arg[1:], start=1):
|
|
142
|
+
if "-" + char in value_options:
|
|
143
|
+
if position == len(arg) - 1:
|
|
144
|
+
index += 1
|
|
145
|
+
break
|
|
146
|
+
else:
|
|
147
|
+
destinations.append(arg)
|
|
148
|
+
index += 1
|
|
149
|
+
return destinations, unsupported
|
|
150
|
+
|
|
151
|
+
|
|
152
|
+
def egbe_base(environment):
|
|
153
|
+
return urlsplit(environment.get("OS_URL", "https://os.hz.egbe.dev").rstrip("/"))
|
|
154
|
+
|
|
155
|
+
|
|
156
|
+
def is_egbe_url(url, base):
|
|
157
|
+
def origin(value):
|
|
158
|
+
port = value.port if value.port is not None else {"http": 80, "https": 443}.get(value.scheme)
|
|
159
|
+
return value.scheme, value.hostname, port
|
|
160
|
+
try:
|
|
161
|
+
target = urlsplit(url)
|
|
162
|
+
return target.hostname == base.hostname and origin(target) == origin(base) and (
|
|
163
|
+
not base.path or target.path == base.path or target.path.startswith(base.path + "/"))
|
|
164
|
+
except ValueError:
|
|
165
|
+
return False
|
|
166
|
+
|
|
167
|
+
|
|
168
|
+
def egbe_destinations(arguments, environment):
|
|
169
|
+
"""The URLs of a request made only to the Egbe URL with supported options, else []."""
|
|
170
|
+
destinations, unsupported = curl_destinations(arguments)
|
|
171
|
+
base = egbe_base(environment)
|
|
172
|
+
if unsupported or not destinations or not all(is_egbe_url(url, base) for url in destinations):
|
|
173
|
+
return []
|
|
174
|
+
return destinations
|
|
175
|
+
|
|
176
|
+
|
|
177
|
+
def command(arguments, environment):
|
|
178
|
+
result = ["curl"]
|
|
179
|
+
base = egbe_base(environment)
|
|
180
|
+
destinations, unsupported = curl_destinations(arguments)
|
|
181
|
+
matches = [is_egbe_url(url, base) for url in destinations]
|
|
182
|
+
agent = environment.get("OS_AGENT_NAME", "")
|
|
183
|
+
ambiguous_destination = any("://" not in url and is_egbe_url(
|
|
184
|
+
base.scheme + "://" + url, base) for url in destinations)
|
|
185
|
+
if (any(matches) or ambiguous_destination) and agent:
|
|
186
|
+
if unsupported:
|
|
187
|
+
raise ValueError("Use supported explicit curl options for identified Egbe requests")
|
|
188
|
+
if not destinations or not all(is_egbe_url(url, base) for url in destinations):
|
|
189
|
+
raise ValueError("Use separate curl commands for Egbe and other destinations")
|
|
190
|
+
# Ignore ambient curl config only for identified requests: it may add
|
|
191
|
+
# extra destinations or redirects. Other curl commands stay unchanged.
|
|
192
|
+
result.append("--disable")
|
|
193
|
+
slug = re.sub(r"[^A-Z0-9]+", "_", agent.upper()).strip("_")
|
|
194
|
+
connection = environment.get("OS_CONNECTION_ID_" + slug)
|
|
195
|
+
if not connection:
|
|
196
|
+
raise ValueError("Run Egbe quickstart to save this agent's workspace connection ID first")
|
|
197
|
+
connection = str(UUID(connection))
|
|
198
|
+
labels = [("X-Egbe-Agent-Name", agent)]
|
|
199
|
+
workspace = environment.get("OS_WORKSPACE_NAME")
|
|
200
|
+
if workspace:
|
|
201
|
+
labels.append(("X-Egbe-Workspace-Name", workspace))
|
|
202
|
+
for _, label in labels:
|
|
203
|
+
if not re.fullmatch(r"[A-Za-z0-9_ .()+-]{1,80}", label) or not label.strip():
|
|
204
|
+
raise ValueError("Connection labels must be plain ASCII nicknames of 1–80 characters")
|
|
205
|
+
result += ["-H", "X-Egbe-Connection-Id: " + connection]
|
|
206
|
+
for name, label in labels:
|
|
207
|
+
result += ["-H", name + ": " + label]
|
|
208
|
+
release = catalog_release() if egbe_destinations(arguments, environment) else None
|
|
209
|
+
if release:
|
|
210
|
+
if result == ["curl"] and arguments[:1] == ["--disable"]:
|
|
211
|
+
# --disable only works as curl's first option.
|
|
212
|
+
result, arguments = ["curl", "--disable"], arguments[1:]
|
|
213
|
+
result += ["-H", "X-Egbe-Catalog-Release: " + release]
|
|
214
|
+
return result + arguments
|
|
215
|
+
|
|
216
|
+
|
|
217
|
+
def request_method(arguments):
|
|
218
|
+
"""The HTTP method curl uses for these (supported) options."""
|
|
219
|
+
method, head, get, data = None, False, False, False
|
|
220
|
+
index = 0
|
|
221
|
+
while index < len(arguments) and arguments[index] != "--":
|
|
222
|
+
arg = arguments[index]
|
|
223
|
+
option, equals, value = arg.partition("=")
|
|
224
|
+
if option in SUPPORTED_VALUE_OPTIONS:
|
|
225
|
+
if not equals:
|
|
226
|
+
index += 1
|
|
227
|
+
value = arguments[index] if index < len(arguments) else ""
|
|
228
|
+
if option in {"-X", "--request"}:
|
|
229
|
+
method = value.upper()
|
|
230
|
+
data |= option in DATA_OPTIONS
|
|
231
|
+
elif arg == "--head" or (arg.startswith("-") and not arg.startswith("--") and "I" in arg):
|
|
232
|
+
head = True
|
|
233
|
+
elif arg == "--get" or (arg.startswith("-") and not arg.startswith("--") and "G" in arg):
|
|
234
|
+
get = True
|
|
235
|
+
index += 1
|
|
236
|
+
return method or ("HEAD" if head else "GET" if get or not data else "POST")
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
def responses(headers):
|
|
240
|
+
"""(status, request ID) of each final response in a curl header dump."""
|
|
241
|
+
found = []
|
|
242
|
+
for line in headers.splitlines():
|
|
243
|
+
status = re.match(r"HTTP/\S+\s+(\d{3})\b", line)
|
|
244
|
+
if status:
|
|
245
|
+
found.append([status[1], "-"])
|
|
246
|
+
continue
|
|
247
|
+
request_id = re.match(r"(?i)x-egbe-request-id:\s*([A-Za-z0-9-]{1,64})\s*$", line)
|
|
248
|
+
if request_id and found:
|
|
249
|
+
found[-1][1] = request_id[1]
|
|
250
|
+
return [(status, request_id) for status, request_id in found if not status.startswith("1")]
|
|
251
|
+
|
|
252
|
+
|
|
253
|
+
def trailer_release(release):
|
|
254
|
+
"""The short form of a catalog release in the trailer: 12 hex digits, `+partial` kept."""
|
|
255
|
+
if not release:
|
|
256
|
+
return "-"
|
|
257
|
+
digest, partial, _ = release.partition("+")
|
|
258
|
+
return digest[:12] + ("+partial" if partial else "")
|
|
259
|
+
|
|
260
|
+
|
|
261
|
+
def trailer(status, request_id, method, url, release=None):
|
|
262
|
+
path = urlsplit(url).path or "/"
|
|
263
|
+
# Quotes and backslashes are encoded too, so the line reads the same inside a JSON string.
|
|
264
|
+
path = re.sub(r'[^\x21-\x7e]|["\\]', lambda match: quote(match[0]), path)[:200]
|
|
265
|
+
return f"egbe-curl: status={status} request_id={request_id} route={method} {path} catalog={trailer_release(release)}"
|
|
266
|
+
|
|
267
|
+
|
|
268
|
+
def run_traced(args, arguments, url):
|
|
269
|
+
"""Run curl for one destination, then report its response and fail on an HTTP error status."""
|
|
270
|
+
descriptor, dump = tempfile.mkstemp(prefix="egbe-curl-", suffix=".headers")
|
|
271
|
+
os.close(descriptor)
|
|
272
|
+
try:
|
|
273
|
+
start = 2 if args[1:2] == ["--disable"] else 1
|
|
274
|
+
code = subprocess.run(args[:start] + ["-D", dump] + args[start:]).returncode
|
|
275
|
+
with open(dump, errors="replace") as stream:
|
|
276
|
+
final = responses(stream.read())
|
|
277
|
+
finally:
|
|
278
|
+
os.unlink(dump)
|
|
279
|
+
# Retries or a proxy CONNECT add earlier responses; the last one is the answer.
|
|
280
|
+
status, request_id = final[-1] if final else ("000", "-")
|
|
281
|
+
if code == 0 and int(status) >= 400:
|
|
282
|
+
code = 22 # curl's own --fail exit code; the body was still printed.
|
|
283
|
+
try:
|
|
284
|
+
# Keep the trailer on its own line when the body shares the stream.
|
|
285
|
+
separate = not os.path.samestat(os.fstat(1), os.fstat(2))
|
|
286
|
+
except OSError:
|
|
287
|
+
separate = True
|
|
288
|
+
sys.stdout.flush()
|
|
289
|
+
line = trailer(status, request_id, request_method(arguments), url, catalog_release())
|
|
290
|
+
print(("" if separate else "\n") + line, file=sys.stderr)
|
|
291
|
+
return code
|
|
292
|
+
|
|
293
|
+
|
|
294
|
+
def connection_headers(url, settings_file=None):
|
|
295
|
+
try:
|
|
296
|
+
args = command([url], project_environment(settings_file))
|
|
297
|
+
return dict(args[index + 1].split(": ", 1) for index, arg in enumerate(args) if arg == "-H")
|
|
298
|
+
except (ValueError, OSError):
|
|
299
|
+
return {}
|
|
300
|
+
|
|
301
|
+
|
|
302
|
+
def run_with_settings(arguments):
|
|
303
|
+
"""Run a bundled client with the project's saved connection settings in its environment.
|
|
304
|
+
|
|
305
|
+
`.env.local` is read without executing it, as with --egbe-request: its URL, key
|
|
306
|
+
and identity replace ambient ones, and the command's other environment is kept."""
|
|
307
|
+
if not arguments:
|
|
308
|
+
raise ValueError("--egbe-run requires a command")
|
|
309
|
+
environment = project_environment(saved_credentials=True)
|
|
310
|
+
if not environment.get("OS_URL") or not environment.get("OS_API_KEY"):
|
|
311
|
+
raise ValueError("Save OS_URL and OS_API_KEY in the project-local .env.local first")
|
|
312
|
+
return subprocess.run(arguments, env=environment).returncode
|
|
313
|
+
|
|
314
|
+
|
|
315
|
+
def main():
|
|
316
|
+
if len(sys.argv) >= 2 and sys.argv[1] == "--egbe-run":
|
|
317
|
+
try:
|
|
318
|
+
return run_with_settings(sys.argv[2:])
|
|
319
|
+
except (ValueError, OSError):
|
|
320
|
+
print("Could not load valid project connection settings or start the command. Check .env.local and the command.",
|
|
321
|
+
file=sys.stderr)
|
|
322
|
+
return 2
|
|
323
|
+
if len(sys.argv) == 5 and sys.argv[1] == "--identity-headers" and sys.argv[3] == "--env-file":
|
|
324
|
+
print(json.dumps(connection_headers(sys.argv[2], sys.argv[4])))
|
|
325
|
+
return 0
|
|
326
|
+
if len(sys.argv) == 3 and sys.argv[1] == "--identity-headers":
|
|
327
|
+
print(json.dumps(connection_headers(sys.argv[2])))
|
|
328
|
+
return 0
|
|
329
|
+
try:
|
|
330
|
+
arguments = sys.argv[1:]
|
|
331
|
+
saved_request = bool(arguments and arguments[0] == "--egbe-request")
|
|
332
|
+
environment = project_environment(saved_credentials=saved_request)
|
|
333
|
+
if saved_request:
|
|
334
|
+
if len(arguments) < 2 or not arguments[1].startswith('/') or arguments[1].startswith('//'):
|
|
335
|
+
raise ValueError("--egbe-request requires an API path beginning with a single slash")
|
|
336
|
+
endpoint, options = arguments[1], arguments[2:]
|
|
337
|
+
destinations, unsupported = curl_destinations(options)
|
|
338
|
+
if destinations or unsupported:
|
|
339
|
+
raise ValueError("Use supported curl options without destinations or redirects with --egbe-request")
|
|
340
|
+
base, key = environment.get("OS_URL"), environment.get("OS_API_KEY")
|
|
341
|
+
if not base or not key:
|
|
342
|
+
raise ValueError("Save OS_URL and OS_API_KEY in the project-local .env.local first")
|
|
343
|
+
arguments = ["--disable", base.rstrip('/') + endpoint, "-H", "Authorization: Bearer " + key, *options]
|
|
344
|
+
args = command(arguments, environment)
|
|
345
|
+
destinations = egbe_destinations(arguments, environment)
|
|
346
|
+
except (ValueError, OSError):
|
|
347
|
+
print("Could not load valid project connection settings or safely attach identity headers. Check .env.local and the Egbe quickstart.", file=sys.stderr)
|
|
348
|
+
return 2
|
|
349
|
+
if len(destinations) == 1:
|
|
350
|
+
# A dump of several transfers cannot be attributed to their URLs once
|
|
351
|
+
# retries or a proxy add responses, so only single requests are traced.
|
|
352
|
+
return run_traced(args, arguments, destinations[0])
|
|
353
|
+
return subprocess.run(args).returncode
|
|
354
|
+
|
|
355
|
+
|
|
356
|
+
if __name__ == "__main__":
|
|
357
|
+
raise SystemExit(main())
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-quiz-funnel
|
|
3
|
+
description: Implement and verify an accepted interactive quiz, its answer-dependent results, conversion handoffs and measurement.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Use when implementing an agreed quiz or inspecting reference funnels to resolve a specific UX question."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Quiz funnels"
|
|
8
|
+
egbe-description: "Build an interactive quiz with personalized results, booking, signup or payment handoffs and reliable measurement."
|
|
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
|
+
# Quiz Funnel
|
|
68
|
+
|
|
69
|
+
Implement the accepted experience in the product's application. This skill owns
|
|
70
|
+
the executable specification, quiz runtime, integration and technical checks;
|
|
71
|
+
it does not choose whether the product needs a quiz or prescribe its UX method.
|
|
72
|
+
|
|
73
|
+
## Through the Egbe connector
|
|
74
|
+
|
|
75
|
+
Through the connector alone, you can write the specification, keeping
|
|
76
|
+
`quiz.json` in Egbe's artifact store (`egbe-os-quickstart` →
|
|
77
|
+
`references/artifact-sync.md` ("Through the Egbe connector")), and change and
|
|
78
|
+
publish product code with `egbe-os-git` ("Without a terminal") and
|
|
79
|
+
`egbe-os-deploy`.
|
|
80
|
+
|
|
81
|
+
Through the Egbe connector, compile with `POST /quiz/compile {spec}` (step 2): it
|
|
82
|
+
returns the same files `scripts/compile-quiz-spec.py` writes, byte for byte, so
|
|
83
|
+
no workspace is needed for compilation. The runtime checks still need a set-up
|
|
84
|
+
project workspace: in a persistent project workspace not set up yet, call
|
|
85
|
+
`egbe_local_setup`; otherwise tell the founder which step needs it. The runtime
|
|
86
|
+
reads the compiler's output, so an uncompiled quiz is not ready to release.
|
|
87
|
+
|
|
88
|
+
## Start from the task
|
|
89
|
+
|
|
90
|
+
Reuse the request and accepted project decisions for the audience, questions,
|
|
91
|
+
results and intended next action. Resolve only missing or conflicting inputs
|
|
92
|
+
needed for the current work; see [inputs](references/inputs.md). Planning,
|
|
93
|
+
reference research, local implementation and release are distinct scopes, not
|
|
94
|
+
mandatory stages of every request.
|
|
95
|
+
|
|
96
|
+
For a focused reference investigation, use the optional
|
|
97
|
+
[competitor teardown](references/competitor-teardown.md) and its local
|
|
98
|
+
[observation contract](references/walk-mechanics.v2.json). Research is not a
|
|
99
|
+
compiler prerequisite and need not be repeated to correct an existing quiz.
|
|
100
|
+
|
|
101
|
+
## Implement the accepted experience
|
|
102
|
+
|
|
103
|
+
1. Write `egbe-docs/product/quizzes/<quiz-slug>/quiz.json` using the
|
|
104
|
+
[specification contract](references/spec-contract.md). Reuse existing project
|
|
105
|
+
context; no separate approval ledger is required. Check that the bundled
|
|
106
|
+
runtime supports the accepted behavior before choosing it. If it does not,
|
|
107
|
+
explain the mismatch and use the product's implementation path rather than
|
|
108
|
+
silently changing the experience to fit this engine.
|
|
109
|
+
2. Compile the specification:
|
|
110
|
+
|
|
111
|
+
```bash
|
|
112
|
+
python3 <skill-root>/scripts/compile-quiz-spec.py \
|
|
113
|
+
--workspace <workspace-root> --quiz-slug <quiz-slug>
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
The compiler writes `QUIZ.md`, `quiz.public.json` and `validation.json`;
|
|
117
|
+
do not edit these outputs by hand. It checks structure, references and
|
|
118
|
+
configured constraints, not whether a claim is true or an experience is good.
|
|
119
|
+
Read diagnostics, especially reachability that could not be verified.
|
|
120
|
+
|
|
121
|
+
Without a terminal, such as through the Egbe connector (`egbe_write`), send
|
|
122
|
+
the parsed specification to the same compiler:
|
|
123
|
+
|
|
124
|
+
```bash
|
|
125
|
+
POST $OS_URL/quiz/compile
|
|
126
|
+
{"spec": <contents of quiz.json>, "quiz_slug": "<quiz-slug>"}
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
`quiz_slug` defaults to `spec.quiz_slug`. When ready, `response.data.files`
|
|
130
|
+
maps each output name to its exact text, identical to the script's output,
|
|
131
|
+
and `response.data.report` holds the diagnostics. Write each file unchanged
|
|
132
|
+
into `response.data.folder`. A `422` with `status: not_ready` lists
|
|
133
|
+
`problems`, returns only `validation.json` in `files` and names the page
|
|
134
|
+
files in `delete`: remove those, fix `quiz.json` and compile again. Nothing
|
|
135
|
+
is stored or charged.
|
|
136
|
+
3. Bind the runtime to the product's framework following
|
|
137
|
+
[implementation](references/implementation.md). Follow
|
|
138
|
+
[conversion handoffs](references/conversion-handoff.md) for the chosen
|
|
139
|
+
destination and [measurement](references/measurement.md) for event semantics
|
|
140
|
+
and delivery. Keep authentication, checkout and analytics under their existing
|
|
141
|
+
Egbe contracts.
|
|
142
|
+
4. Use [verification](references/verification.md) for the changed behavior.
|
|
143
|
+
Local work does not require a commit or deployment. When release is in scope,
|
|
144
|
+
use the product's established release workflow and `egbe-os-deploy`, then
|
|
145
|
+
verify the live route without creating unintended real conversions or
|
|
146
|
+
polluting production analytics.
|
|
147
|
+
|
|
148
|
+
## Handoff
|
|
149
|
+
|
|
150
|
+
Keep the quiz folder with the product's source. Return what changed, validation
|
|
151
|
+
performed, remaining gaps and the artifact or route the caller can inspect.
|
|
152
|
+
Distinguish a local build, a released route and an observed real conversion.
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
interface:
|
|
2
|
+
display_name: "Quiz Funnel"
|
|
3
|
+
short_description: "Build a quiz page that leads to a call, signup or payment"
|
|
4
|
+
default_prompt: "Use $egbe-os-quiz-funnel to build a quiz page for this product, segment, and offer. The quiz should lead to: <a call, a signup, or a payment>."
|