@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,93 @@
|
|
|
1
|
+
# Reuse shipped product foundations
|
|
2
|
+
|
|
3
|
+
Inspect the existing application and accepted behavior first. These optional
|
|
4
|
+
application and account/session foundations fit the bundled Next.js/Postgres
|
|
5
|
+
stack. The shared auth database assets also support custom Node/Postgres apps.
|
|
6
|
+
Another stack or working integration should keep its established implementation.
|
|
7
|
+
Installing code does not select an offer, account-entry method or commercial model.
|
|
8
|
+
|
|
9
|
+
The complete skill catalog includes a local helper at
|
|
10
|
+
`<skills-directory>/egbe-os-product-build/scripts/scaffold.py`. It locates sibling
|
|
11
|
+
bundles by their published names; no checkout, network call or credentials are
|
|
12
|
+
needed. Discover the choices and preview a compatible new application:
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
python3 <skills-directory>/egbe-os-product-build/scripts/scaffold.py list
|
|
16
|
+
python3 <skills-directory>/egbe-os-product-build/scripts/scaffold.py plan --target <product-directory> --nextjs
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Select only the required pieces:
|
|
20
|
+
|
|
21
|
+
| Option | Installs | Still needs implementation/configuration |
|
|
22
|
+
| --- | --- | --- |
|
|
23
|
+
| `--nextjs` | Blank application from Design landing page | Product UI/behavior, real public observability bindings |
|
|
24
|
+
| `--auth-db` | Shared Node/Postgres auth schema, migration runner and private validation-session helper | Application's account-entry/session resolver, protected access, real attached database and controlled migration step; preserves framework/start command |
|
|
25
|
+
| `--accounts` | Product Auth's Postgres schema, migrations, server account/session helpers and validation-session helper | Selected account-entry/recovery UX, real attached database and protected product paths |
|
|
26
|
+
| `--subscriptions` | Payments' subscription foundation plus its required account foundation | Accepted plan catalog, real provider bindings, account-entry, product entitlements, navigation and verification |
|
|
27
|
+
|
|
28
|
+
For a compatible new app requiring subscriptions, preview with
|
|
29
|
+
`plan --target <product-directory> --nextjs --subscriptions`. For a compatible
|
|
30
|
+
existing Next.js app, omit `--nextjs` and select only the absent foundation.
|
|
31
|
+
The subscription foundation is **not** a one-time purchase engine: use Payments'
|
|
32
|
+
one-time-purchase workflow for that offer instead. A stateless product need not
|
|
33
|
+
add accounts or payments.
|
|
34
|
+
|
|
35
|
+
For a custom Node/Postgres app with a `package.json`, use
|
|
36
|
+
`plan --target <product-directory> --auth-db`. This reuses the existing raw-SQL
|
|
37
|
+
assets without installing Next.js modules or changing the app's start command.
|
|
38
|
+
It adds `pg`, `db:migrate` and `auth:validation-session`; it does not supply a
|
|
39
|
+
complete auth implementation. Preserve an established ORM/auth library's schema
|
|
40
|
+
and migration ledger instead of installing parallel raw-SQL tables. The full
|
|
41
|
+
`--accounts` and `--subscriptions` options include these same database assets.
|
|
42
|
+
Read the [shared auth database contract](../../egbe-os-product-auth/assets/db/README.md)
|
|
43
|
+
for the schema, session-token contract and private validation-session lifecycle.
|
|
44
|
+
|
|
45
|
+
Review the preview, then repeat the same arguments with `apply` instead of
|
|
46
|
+
`plan`. The helper merges required package entries, copies missing foundation
|
|
47
|
+
files and appends the installed foundation's marked ownership guidance to
|
|
48
|
+
`AGENTS.md`, preserving existing project guidance and credentials. The Next.js
|
|
49
|
+
starter appends its build/secret ignore rules to `.gitignore`, preserving existing
|
|
50
|
+
rules; review their order in the resulting file. Different
|
|
51
|
+
existing files, dependency versions, scripts or marked guidance stop the whole
|
|
52
|
+
plan before writes; resolve the integration deliberately rather than deleting
|
|
53
|
+
working code. Symlinks within the destination are rejected. Repeating the same
|
|
54
|
+
installation without intervening edits makes no changes. Edited foundations
|
|
55
|
+
remain a manual review, not an update/overwrite target.
|
|
56
|
+
|
|
57
|
+
## Without a terminal
|
|
58
|
+
|
|
59
|
+
Through the Egbe connector, or wherever the local helper cannot run, Egbe runs
|
|
60
|
+
the same helper against a repository. Open a commit session on the product's
|
|
61
|
+
repository and branch as `egbe-os-git` describes ("Without a terminal"), then:
|
|
62
|
+
|
|
63
|
+
```json
|
|
64
|
+
POST /git/commit-sessions/<session_id>/scaffold
|
|
65
|
+
{"foundations": ["nextjs", "subscriptions"], "directory": ""}
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
`foundations` takes the options above without dashes in front (`nextjs`,
|
|
69
|
+
`auth-db`, `accounts`, `subscriptions`); `directory` is the product's folder in
|
|
70
|
+
the repository (empty for its root). The plan is made against the session's base
|
|
71
|
+
commit and anything already staged in the session, with the same merging and
|
|
72
|
+
refusals as the local helper; a refusal (409) stages nothing. The result lists
|
|
73
|
+
`changes` (`path`, `action`, `size`); review them, then repeat the same request
|
|
74
|
+
with `"apply": true` to stage those files and commit the session with a message.
|
|
75
|
+
Repeating an installation that is already staged or committed returns no changes.
|
|
76
|
+
|
|
77
|
+
`lockfile_current: true` means the resulting `package-lock.json` lists the
|
|
78
|
+
package's dependencies, so the starter Dockerfile's `npm ci` works. `false`
|
|
79
|
+
means it does not, because the app's dependencies or lockfile differ from the
|
|
80
|
+
shipped ones; regenerate the lockfile with `npm install --include=dev` where
|
|
81
|
+
npm can run before deploying, or report that dependency as remaining work.
|
|
82
|
+
|
|
83
|
+
## After installation
|
|
84
|
+
|
|
85
|
+
Both paths keep an unedited shipped `package-lock.json` (the starter's or a
|
|
86
|
+
previous installation's) in step: when a foundation adds dependencies, they
|
|
87
|
+
install the matching prebuilt lockfile from Design landing page's
|
|
88
|
+
`assets/lockfiles/`. An edited lockfile is left as it is; then refresh it with
|
|
89
|
+
the project's package manager (`npm install --include=dev` for the bundled npm
|
|
90
|
+
starter), as after any other dependency change. The helper
|
|
91
|
+
does not install packages, migrate a database, create provider objects, deploy
|
|
92
|
+
or verify an integration. Read the selected Auth/Payments contract, implement
|
|
93
|
+
the accepted behavior and verify the resulting customer journey before publishing.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Interface implementation and verification
|
|
2
|
+
|
|
3
|
+
Implement accepted content, behavior and visual direction within their stated scope.
|
|
4
|
+
Unspecified routine details can be completed coherently; an omitted choice is not
|
|
5
|
+
a prohibition or permission to alter a product promise. Metadata such as plan IDs
|
|
6
|
+
or destinations belongs in behavior, not visible copy.
|
|
7
|
+
|
|
8
|
+
Verify the rendered interface, not only CSS declarations or screenshots:
|
|
9
|
+
|
|
10
|
+
- Use semantic controls, labels and meaningful errors; keyboard navigation, visible
|
|
11
|
+
focus, dialog focus/return, Esc and accessible close controls must work. Touch
|
|
12
|
+
targets should be comfortably usable (44px is a useful target); never hide a
|
|
13
|
+
necessary control behind a hover-only interaction.
|
|
14
|
+
- Check text contrast: at least 4.5:1 for normal text, 3:1 for large text (24px,
|
|
15
|
+
or about 18.7px bold). Keep body text readable; 16px form text avoids iOS input
|
|
16
|
+
zoom. Verify the fonts actually loaded and that fallback layouts remain usable.
|
|
17
|
+
- Inspect narrow/mobile and desktop layouts, including tables, long content,
|
|
18
|
+
large numbers and dialogs. Avoid clipping and accidental horizontal page scroll;
|
|
19
|
+
use intentional accessible overflow where content genuinely needs it.
|
|
20
|
+
- Respect reduced motion; moving content must not make layout jump or remove the
|
|
21
|
+
usable state. Show progress for pending work and preserve input on recoverable
|
|
22
|
+
failures. Test empty, partial and error states that occur on this path.
|
|
23
|
+
- Exercise every distinct changed action and route, including selected-plan and
|
|
24
|
+
return context. A dead destination, fake submit or misleading disabled feature
|
|
25
|
+
is not completed implementation. Do not fabricate proof, screenshots or testimonials.
|
|
26
|
+
|
|
27
|
+
Use browser inspection and proportionate screenshots to verify the affected path
|
|
28
|
+
at realistic widths (for example 375 and 1440px, plus any failing breakpoint).
|
|
29
|
+
Computed styles and overflow checks complement visual inspection; neither replaces
|
|
30
|
+
the other. Check the project's lint/build and relevant tests. Preserve technical
|
|
31
|
+
evidence with the work, excluding credentials and private customer captures from
|
|
32
|
+
public output. No fixed palette, image count or report-per-section is required.
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
# Private review after handoff
|
|
2
|
+
|
|
3
|
+
Use this when the founder or another authorized reviewer needs to try the
|
|
4
|
+
customer journey or proposed paid result after implementation stops. Keep the
|
|
5
|
+
business, delivery format and implementation choices open. This workflow adds
|
|
6
|
+
no authority to spend, contact customers, accept agreements or expand access.
|
|
7
|
+
|
|
8
|
+
When the caller explicitly authorizes synthetic account testing, use that
|
|
9
|
+
permission within its named products and review window: generate fresh private
|
|
10
|
+
test credentials, create marked test accounts through normal signup, and
|
|
11
|
+
exercise the product's own non-binding test acknowledgments. Keep account and
|
|
12
|
+
terms-version observations in private test evidence and exclude synthetic
|
|
13
|
+
activity from real customer and revenue metrics. This does not authorize
|
|
14
|
+
changes to human accounts, third-party agreements or financial commitments.
|
|
15
|
+
Mandatory tool confirmations still govern credential operations and binding
|
|
16
|
+
agreements, even on an owner-controlled product. Do not relabel real terms or
|
|
17
|
+
switch tools to evade a required confirmation. A missing browser-policy
|
|
18
|
+
capability remains an explicit dependency, not permission supplied by this
|
|
19
|
+
workflow. Preserve actual Auth and consent proof as separate outcomes.
|
|
20
|
+
|
|
21
|
+
## Establish usable access
|
|
22
|
+
|
|
23
|
+
Before choosing the review method, establish the reviewer's available devices,
|
|
24
|
+
browser sign-ins, supported interactions and essential file capabilities. Account
|
|
25
|
+
for any required human action for credentials, consent or email verification.
|
|
26
|
+
Connected-service read access does not establish a signed-in browser session.
|
|
27
|
+
Use these facts in the existing plan and handoff; no separate intake form is
|
|
28
|
+
needed. Resolve routine choices within existing delegation.
|
|
29
|
+
|
|
30
|
+
Use normal account entry for Auth proof. After that proof, dependent work may
|
|
31
|
+
reuse Auth's private validation identity through the normal session authority.
|
|
32
|
+
A session created for testing does not prove signup, login or consent. A raw
|
|
33
|
+
cookie file is not a usable handoff when the reviewer's tools cannot load it.
|
|
34
|
+
Never introduce a public test-login route, copy an owner's browser cookies or
|
|
35
|
+
weaken authentication to make a review possible.
|
|
36
|
+
|
|
37
|
+
Keep the minimum authorized review access usable for the agreed review window,
|
|
38
|
+
within the caller's time and resource limits. Record its expiry and cleanup
|
|
39
|
+
owner; preserve the founder's ordinary access. When the reviewer can read the
|
|
40
|
+
shared project folder, a private Git-ignored file there, such as one under
|
|
41
|
+
`.local/`, is a supported credential handoff; keep it out of commits, public
|
|
42
|
+
pages and reports. Prefer expiry the product enforces itself, such as review
|
|
43
|
+
accounts or sessions it rejects after the deadline, so cleanup does not depend
|
|
44
|
+
on a process running after you stop. If an essential human step or
|
|
45
|
+
capability remains unavailable, state the precise gap and continue independent
|
|
46
|
+
authorized preparation. Do not report the missing check as passed.
|
|
47
|
+
|
|
48
|
+
## Leave a repeatable customer journey
|
|
49
|
+
|
|
50
|
+
Use the current serving product and the focused Auth, Payments and Analytics
|
|
51
|
+
workflows. Leave a supported way for the reviewer to repeat the relevant checks
|
|
52
|
+
with their actual access after the builder finishes. A written walkthrough,
|
|
53
|
+
local test output or old payment receipt alone does not provide that ability.
|
|
54
|
+
|
|
55
|
+
Payments owns validate-only requests and receipt verification. Repeat validation
|
|
56
|
+
to obtain fresh short-lived receipts when needed; do not extend receipt validity,
|
|
57
|
+
persist receipts as reusable credentials or create real charges as probes.
|
|
58
|
+
Keep no-charge checkout validation separate from signed lifecycle, durable
|
|
59
|
+
entitlement and delivery verification. Exercise those through supported isolated
|
|
60
|
+
synthetic checks; do not grant production paid access merely to claim a pass.
|
|
61
|
+
|
|
62
|
+
Trace the offer's complete applicable journey from entry and offer selection
|
|
63
|
+
through authenticated continuation, payment handling, access enforcement, the
|
|
64
|
+
actual promised result, saved-work recovery, support and measurement. Reuse
|
|
65
|
+
existing authoritative state rather than building parallel test logic. Check
|
|
66
|
+
account boundaries and duplicate processing where relevant. Label synthetic
|
|
67
|
+
identities and events and exclude them from customer and revenue claims.
|
|
68
|
+
|
|
69
|
+
For a file-based result, verify that the intended recipient can obtain, open,
|
|
70
|
+
use and recover the actual deliverable using the agreed tools. For a hosted
|
|
71
|
+
result, verify its corresponding return and recovery behavior. State narrower
|
|
72
|
+
coverage honestly; opening a preview is not proof of the full paid result.
|
|
73
|
+
Keep tests proportional to the actual offer rather than requiring every
|
|
74
|
+
possible account, payment or file feature.
|
|
75
|
+
|
|
76
|
+
## Carry the resource basis and remaining gaps
|
|
77
|
+
|
|
78
|
+
Use the accepted delivery, support and recovery obligations and the task's resource
|
|
79
|
+
basis. Read Wallet for current balances/rates when a resource check is needed.
|
|
80
|
+
Return a missing commercial decision to its owner instead of adapting the offer
|
|
81
|
+
inside technical review. Keep resource limits separate from unfinished authorized work.
|
|
82
|
+
|
|
83
|
+
Return the product location, repeatable review steps, necessary private access,
|
|
84
|
+
access lifetime, remaining human actions and verified/unverified outcomes in the
|
|
85
|
+
existing handoff. Keep secrets out of public plans and evidence. Completion of
|
|
86
|
+
this preparation does not authorize launch or establish demand or revenue.
|
|
@@ -0,0 +1,296 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Preview or install shipped product foundations without network operations."""
|
|
3
|
+
import argparse
|
|
4
|
+
from dataclasses import dataclass
|
|
5
|
+
import json
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
import sys
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
class Conflict(ValueError):
|
|
11
|
+
pass
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
@dataclass
|
|
15
|
+
class Edit:
|
|
16
|
+
path: Path
|
|
17
|
+
before: bytes | None
|
|
18
|
+
after: bytes
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
def skill(root: Path, name: str) -> Path:
|
|
22
|
+
"""Work in both a source checkout and the complete installed catalog."""
|
|
23
|
+
for candidate in (root / ("egbe-os-" + name), root / name):
|
|
24
|
+
if (candidate / "SKILL.md").is_file():
|
|
25
|
+
return candidate
|
|
26
|
+
raise Conflict(f"Missing skill bundle: egbe-os-{name}; refresh the complete catalog")
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
def check_path(root: Path, path: Path):
|
|
30
|
+
for candidate in (path, *path.parents):
|
|
31
|
+
if candidate.is_symlink():
|
|
32
|
+
raise Conflict(f"Symlink destination: {candidate}")
|
|
33
|
+
if candidate == root:
|
|
34
|
+
break
|
|
35
|
+
if path.exists() and not path.is_file():
|
|
36
|
+
raise Conflict(f"Expected a regular file: {path}")
|
|
37
|
+
for parent in path.parents:
|
|
38
|
+
if parent == root.parent:
|
|
39
|
+
break
|
|
40
|
+
if parent.exists() and not parent.is_dir():
|
|
41
|
+
raise Conflict(f"Expected a directory: {parent}")
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def tree(source: Path):
|
|
45
|
+
if not source.is_dir():
|
|
46
|
+
raise Conflict(f"Missing shipped foundation: {source}")
|
|
47
|
+
for path in sorted(source.rglob("*")):
|
|
48
|
+
relative = path.relative_to(source)
|
|
49
|
+
if any(part in {"node_modules", ".next", "__pycache__"} for part in relative.parts):
|
|
50
|
+
continue
|
|
51
|
+
if path.is_symlink():
|
|
52
|
+
raise Conflict(f"Symlink in foundation: {path}")
|
|
53
|
+
if path.is_file() and path.name not in {"package.fragment.json", "AGENTS.append.md"}:
|
|
54
|
+
yield relative, path.read_bytes()
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
def append_marked(existing: str, marker: str, text: str, *, ignore_file=False) -> str:
|
|
58
|
+
start, end = (f"# {marker}", f"# /{marker}") if ignore_file else (f"<!-- {marker} -->", f"<!-- /{marker} -->")
|
|
59
|
+
block = start + "\n" + text.rstrip() + "\n" + end
|
|
60
|
+
if start in existing or end in existing:
|
|
61
|
+
if existing.count(start) != 1 or existing.count(end) != 1 or block not in existing:
|
|
62
|
+
raise Conflict(f"Existing foundation guidance differs: {marker}; review it manually")
|
|
63
|
+
return existing
|
|
64
|
+
return existing.rstrip() + ("\n\n" if existing.strip() else "") + block + "\n"
|
|
65
|
+
|
|
66
|
+
|
|
67
|
+
# The command-line options by name, for callers that select foundations without flags.
|
|
68
|
+
FOUNDATIONS = {"nextjs": "base", "auth-db": "auth_db", "accounts": "accounts", "subscriptions": "subscriptions"}
|
|
69
|
+
MERGED = {Path("package.json"), Path("AGENTS.md"), Path(".gitignore")}
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
LOCKFILE = Path("package-lock.json")
|
|
73
|
+
LOCKED_SECTIONS = ("dependencies", "devDependencies")
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
def shipped_lockfiles(skills):
|
|
77
|
+
"""The starter's lockfile and the prebuilt ones for its foundation combinations."""
|
|
78
|
+
assets = skill(skills, "design-landing-page") / "assets"
|
|
79
|
+
paths = [assets / "scaffold/package-lock.json", *sorted((assets / "lockfiles").glob("*/package-lock.json"))]
|
|
80
|
+
return [path.read_bytes() for path in paths if path.is_file()]
|
|
81
|
+
|
|
82
|
+
|
|
83
|
+
def lock_lists(lock: bytes, package: dict) -> bool:
|
|
84
|
+
"""Whether a lockfile's root lists exactly the package's dependencies, as `npm ci` requires."""
|
|
85
|
+
try:
|
|
86
|
+
root = json.loads(lock).get("packages", {}).get("", {})
|
|
87
|
+
except (ValueError, AttributeError):
|
|
88
|
+
return False
|
|
89
|
+
return all((package.get(section) or {}) == (root.get(section) or {}) for section in LOCKED_SECTIONS)
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
def _lock_shape(lock: bytes):
|
|
93
|
+
"""A lockfile without the root package's own name and version."""
|
|
94
|
+
try:
|
|
95
|
+
data = json.loads(lock)
|
|
96
|
+
root = dict(data.get("packages", {}).get("", {}))
|
|
97
|
+
except (ValueError, AttributeError):
|
|
98
|
+
return None
|
|
99
|
+
for field in ("name", "version"):
|
|
100
|
+
data.pop(field, None)
|
|
101
|
+
root.pop(field, None)
|
|
102
|
+
return {**data, "packages": {**data.get("packages", {}), "": root}}
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
def is_shipped_lockfile(lock: bytes, skills) -> bool:
|
|
106
|
+
"""An unedited shipped lockfile, whatever the root package's name and version."""
|
|
107
|
+
return _lock_shape(lock) in [_lock_shape(shipped) for shipped in shipped_lockfiles(skills)]
|
|
108
|
+
|
|
109
|
+
|
|
110
|
+
def prebuilt_lockfile(package: dict, skills):
|
|
111
|
+
"""The shipped lockfile listing the package's dependencies, carrying its name and version."""
|
|
112
|
+
shipped = shipped_lockfiles(skills)
|
|
113
|
+
for lock in shipped:
|
|
114
|
+
if lock_lists(lock, package):
|
|
115
|
+
data = json.loads(lock)
|
|
116
|
+
if all(data.get(field) == package.get(field) for field in ("name", "version")):
|
|
117
|
+
return lock
|
|
118
|
+
for record in (data, data["packages"][""]):
|
|
119
|
+
for field in ("name", "version"):
|
|
120
|
+
if field in package:
|
|
121
|
+
record[field] = package[field]
|
|
122
|
+
else:
|
|
123
|
+
record.pop(field, None)
|
|
124
|
+
return (json.dumps(data, indent=2) + "\n").encode()
|
|
125
|
+
return None
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
def compose(read, *, base=False, auth_db=False, accounts=False, subscriptions=False, skills=None):
|
|
129
|
+
"""Plan the selected foundations against any destination.
|
|
130
|
+
|
|
131
|
+
`read(relative)` returns the destination's bytes at a relative path, or None
|
|
132
|
+
when absent, and raises Conflict for a path that cannot hold a file. Returns
|
|
133
|
+
`(relative, before, after)` for every file the installation changes.
|
|
134
|
+
"""
|
|
135
|
+
skills = skills or Path(__file__).resolve().parents[2]
|
|
136
|
+
if not (base or auth_db or accounts or subscriptions):
|
|
137
|
+
raise Conflict("Select --nextjs, --auth-db, --accounts or --subscriptions explicitly")
|
|
138
|
+
files = {}
|
|
139
|
+
|
|
140
|
+
def add(source, prefix=Path()):
|
|
141
|
+
for relative, content in tree(source):
|
|
142
|
+
relative = prefix / relative
|
|
143
|
+
if relative in files and files[relative] != content:
|
|
144
|
+
raise Conflict(f"Overlapping foundation files: {relative}")
|
|
145
|
+
files[relative] = content
|
|
146
|
+
|
|
147
|
+
if base:
|
|
148
|
+
add(skill(skills, "design-landing-page") / "assets/scaffold")
|
|
149
|
+
existing_package = read(Path("package.json"))
|
|
150
|
+
package_bytes = existing_package if existing_package is not None else files.get(Path("package.json"))
|
|
151
|
+
if package_bytes is None:
|
|
152
|
+
raise Conflict("A product package.json is required; use --nextjs only for a new app")
|
|
153
|
+
package = json.loads(package_bytes)
|
|
154
|
+
if not isinstance(package, dict):
|
|
155
|
+
raise Conflict("package.json must contain an object")
|
|
156
|
+
agents = (read(Path("AGENTS.md")) or b"").decode()
|
|
157
|
+
if base:
|
|
158
|
+
starter_guidance = files[Path("AGENTS.md")].decode()
|
|
159
|
+
agents = append_marked(agents, "EGBE:APPLICATION-SCAFFOLD", starter_guidance)
|
|
160
|
+
existing_ignores = (read(Path(".gitignore")) or b"").decode()
|
|
161
|
+
files[Path(".gitignore")] = append_marked(
|
|
162
|
+
existing_ignores, "EGBE:APPLICATION-SCAFFOLD", files[Path(".gitignore")].decode(), ignore_file=True,
|
|
163
|
+
).encode()
|
|
164
|
+
|
|
165
|
+
foundations = []
|
|
166
|
+
if auth_db or accounts or subscriptions:
|
|
167
|
+
auth = skill(skills, "product-auth")
|
|
168
|
+
add(auth / "assets/db", Path("db"))
|
|
169
|
+
foundations.append(auth / "assets/scaffolds/product-auth-database")
|
|
170
|
+
if accounts or subscriptions:
|
|
171
|
+
foundations.append(auth / "assets/scaffolds/product-nextjs-postgres")
|
|
172
|
+
if subscriptions:
|
|
173
|
+
foundations.append(skill(skills, "payments") / "assets/scaffolds/billing-nextjs-subscription")
|
|
174
|
+
original_package = json.loads(package_bytes)
|
|
175
|
+
for foundation in foundations:
|
|
176
|
+
fragment = json.loads((foundation / "package.fragment.json").read_text())
|
|
177
|
+
scripts = package.setdefault("scripts", {})
|
|
178
|
+
if not isinstance(scripts, dict):
|
|
179
|
+
raise Conflict("package.json scripts must contain an object")
|
|
180
|
+
for name, expected in fragment.get("expectedScripts", {}).items():
|
|
181
|
+
if scripts.get(name) not in (expected, fragment.get("scripts", {}).get(name, expected)):
|
|
182
|
+
raise Conflict(f"Incompatible script: {name}; expected {expected!r}")
|
|
183
|
+
for section in ("dependencies", "devDependencies", "scripts"):
|
|
184
|
+
current = package.setdefault(section, {})
|
|
185
|
+
if not isinstance(current, dict):
|
|
186
|
+
raise Conflict(f"package.json {section} must contain an object")
|
|
187
|
+
for name, value in fragment.get(section, {}).items():
|
|
188
|
+
if name in current and current[name] != value:
|
|
189
|
+
expected = fragment.get("expectedScripts", {}).get(name)
|
|
190
|
+
if section != "scripts" or current[name] != expected:
|
|
191
|
+
raise Conflict(f"Conflicting {section} entry: {name}")
|
|
192
|
+
current[name] = value
|
|
193
|
+
add(foundation)
|
|
194
|
+
agents = append_marked(agents, fragment["agentsMarker"], (foundation / "AGENTS.append.md").read_text())
|
|
195
|
+
if base and existing_package is not None:
|
|
196
|
+
# Do not transplant a starter package into an existing application.
|
|
197
|
+
# Repeated installation is allowed only when its merged package agrees.
|
|
198
|
+
starter = json.loads(files[Path("package.json")])
|
|
199
|
+
if any(package.get(key) != value for key, value in starter.items() if key not in {"scripts", "dependencies", "devDependencies"}):
|
|
200
|
+
raise Conflict("Existing app package differs; omit --nextjs and integrate only the selected foundation")
|
|
201
|
+
for section in ("scripts", "dependencies", "devDependencies"):
|
|
202
|
+
for name, value in starter.get(section, {}).items():
|
|
203
|
+
allowed = {value}
|
|
204
|
+
for foundation in foundations:
|
|
205
|
+
fragment = json.loads((foundation / "package.fragment.json").read_text())
|
|
206
|
+
if name in fragment.get(section, {}):
|
|
207
|
+
allowed.add(fragment[section][name])
|
|
208
|
+
if package.get(section, {}).get(name) not in allowed:
|
|
209
|
+
raise Conflict(f"Existing app differs from starter: {section}.{name}")
|
|
210
|
+
if package == original_package:
|
|
211
|
+
files[Path("package.json")] = package_bytes
|
|
212
|
+
else:
|
|
213
|
+
files[Path("package.json")] = (json.dumps(package, indent=2) + "\n").encode()
|
|
214
|
+
if base or foundations:
|
|
215
|
+
files[Path("AGENTS.md")] = agents.encode()
|
|
216
|
+
# Keep `npm ci` working: an unedited shipped lockfile that no longer lists the
|
|
217
|
+
# package's dependencies is replaced by the prebuilt one for this combination.
|
|
218
|
+
replaceable = set(MERGED)
|
|
219
|
+
lock = files.get(LOCKFILE)
|
|
220
|
+
lock = lock if lock is not None else read(LOCKFILE)
|
|
221
|
+
final_package = json.loads(files[Path("package.json")])
|
|
222
|
+
if lock is not None and not lock_lists(lock, final_package):
|
|
223
|
+
existing_lock = read(LOCKFILE)
|
|
224
|
+
prebuilt = prebuilt_lockfile(final_package, skills) if is_shipped_lockfile(lock, skills) else None
|
|
225
|
+
if prebuilt is not None and (existing_lock is None or is_shipped_lockfile(existing_lock, skills)):
|
|
226
|
+
files[LOCKFILE] = prebuilt
|
|
227
|
+
replaceable.add(LOCKFILE)
|
|
228
|
+
changes = []
|
|
229
|
+
for relative, after in sorted(files.items()):
|
|
230
|
+
before = read(relative)
|
|
231
|
+
if before == after:
|
|
232
|
+
continue
|
|
233
|
+
if before is not None and relative not in replaceable:
|
|
234
|
+
raise Conflict(f"Existing file differs: {relative}; no files were written")
|
|
235
|
+
changes.append((relative, before, after))
|
|
236
|
+
return changes
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
def plan(target: Path, *, base=False, auth_db=False, accounts=False, subscriptions=False, skills=None):
|
|
240
|
+
if target.is_symlink():
|
|
241
|
+
raise Conflict(f"Symlink destination: {target}")
|
|
242
|
+
root = target.resolve()
|
|
243
|
+
if root.exists() and not root.is_dir():
|
|
244
|
+
raise Conflict(f"Expected a product directory: {root}")
|
|
245
|
+
|
|
246
|
+
def read(relative):
|
|
247
|
+
path = root / relative
|
|
248
|
+
check_path(root, path)
|
|
249
|
+
return path.read_bytes() if path.exists() else None
|
|
250
|
+
|
|
251
|
+
changes = compose(read, base=base, auth_db=auth_db, accounts=accounts, subscriptions=subscriptions,
|
|
252
|
+
skills=skills)
|
|
253
|
+
return root, [Edit(root / relative, before, after) for relative, before, after in changes]
|
|
254
|
+
|
|
255
|
+
|
|
256
|
+
def apply(root, edits):
|
|
257
|
+
# Recheck every planned write before changing anything.
|
|
258
|
+
for edit in edits:
|
|
259
|
+
check_path(root, edit.path)
|
|
260
|
+
before = edit.path.read_bytes() if edit.path.exists() else None
|
|
261
|
+
if before != edit.before:
|
|
262
|
+
raise Conflict(f"Destination changed since planning: {edit.path}")
|
|
263
|
+
# Ownership guidance describes code already copied, so write it last.
|
|
264
|
+
for edit in sorted(edits, key=lambda item: item.path.name == "AGENTS.md"):
|
|
265
|
+
edit.path.parent.mkdir(parents=True, exist_ok=True)
|
|
266
|
+
edit.path.write_bytes(edit.after)
|
|
267
|
+
|
|
268
|
+
|
|
269
|
+
def main():
|
|
270
|
+
parser = argparse.ArgumentParser(description=__doc__)
|
|
271
|
+
parser.add_argument("command", choices=("list", "plan", "apply"))
|
|
272
|
+
parser.add_argument("--target", type=Path, default=Path.cwd())
|
|
273
|
+
parser.add_argument("--nextjs", action="store_true", help="Copy the blank Next.js starter; for new applications only")
|
|
274
|
+
parser.add_argument("--auth-db", action="store_true", help="Add shared Node/Postgres auth database assets without Next.js server helpers")
|
|
275
|
+
parser.add_argument("--accounts", action="store_true", help="Add the Postgres account/session foundation")
|
|
276
|
+
parser.add_argument("--subscriptions", action="store_true", help="Add subscription billing and its required account foundation; not one-time purchases")
|
|
277
|
+
args = parser.parse_args()
|
|
278
|
+
if args.command == "list":
|
|
279
|
+
print("--nextjs: blank Next.js application; use only when this stack fits")
|
|
280
|
+
print("--auth-db: shared Node/Postgres auth schema, migrations and private validation-session helper; preserves framework/start command")
|
|
281
|
+
print("--accounts: Postgres users, identities, sessions and migrations; account-entry UI still needs implementation")
|
|
282
|
+
print("--subscriptions: subscription lifecycle, checkout, billing UI and account foundation; not a one-time purchase engine")
|
|
283
|
+
return
|
|
284
|
+
try:
|
|
285
|
+
root, edits = plan(args.target, base=args.nextjs, auth_db=args.auth_db, accounts=args.accounts, subscriptions=args.subscriptions)
|
|
286
|
+
if args.command == "apply":
|
|
287
|
+
apply(root, edits)
|
|
288
|
+
print(json.dumps({"target": str(root), "applied": args.command == "apply", "changes": [str(e.path.relative_to(root)) for e in edits]}, indent=2))
|
|
289
|
+
if edits:
|
|
290
|
+
print("Next: install dependencies with your package manager (refresh the lockfile only if it was edited or npm ci fails), implement accepted behavior, configure real bindings and verify before publishing.", file=sys.stderr)
|
|
291
|
+
except (Conflict, OSError, ValueError) as exc:
|
|
292
|
+
parser.exit(1, f"Scaffold installation stopped: {exc}\n")
|
|
293
|
+
|
|
294
|
+
|
|
295
|
+
if __name__ == "__main__":
|
|
296
|
+
main()
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-product-demo-video
|
|
3
|
+
description: Record a real product walkthrough and produce a video and poster.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Offer when a homepage or pitch would benefit from showing the product in action."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Product demo video"
|
|
8
|
+
egbe-description: "Show your product in action with a clear walkthrough video and a preview image."
|
|
9
|
+
egbe-category: "Product & design"
|
|
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
|
+
|
|
56
|
+
# Record a product demo
|
|
57
|
+
|
|
58
|
+
Keep the recording context, source captures, final media and checks together in
|
|
59
|
+
`egbe-docs/marketing/packs/<video-id>/`; version source captures in `work/` and use
|
|
60
|
+
the existing plan or asset notes rather than creating a separate document per step.
|
|
61
|
+
Keep credential-bearing captures out of Git and public exports.
|
|
62
|
+
|
|
63
|
+
Show the real path from customer intent to a useful result. Deliver a playable
|
|
64
|
+
video and poster; embedding or publishing them is a separate action unless
|
|
65
|
+
included in the request.
|
|
66
|
+
|
|
67
|
+
## Through the Egbe connector
|
|
68
|
+
|
|
69
|
+
Egbe does not record video. Through the connector you can plan the walkthrough,
|
|
70
|
+
confirm the serving revision with `egbe-os-deploy` and keep the notes in Egbe's
|
|
71
|
+
artifact store. Recording needs browser and recording tools in your own
|
|
72
|
+
environment, or a set-up project workspace (in a persistent project workspace
|
|
73
|
+
not set up yet, call `egbe_local_setup`). Without either, tell the founder;
|
|
74
|
+
screenshots or a description are not a recording.
|
|
75
|
+
|
|
76
|
+
## Prepare the walkthrough
|
|
77
|
+
|
|
78
|
+
Read the requested or already agreed audience, destination and behavior, then
|
|
79
|
+
inspect the actual product. Resolve consequential gaps without reopening accepted
|
|
80
|
+
choices. Capture the shortest coherent journey that demonstrates the requested
|
|
81
|
+
result. Use a local or staging app when appropriate; for an existing
|
|
82
|
+
deployment, confirm its serving revision through `egbe-os-deploy` rather than guessing
|
|
83
|
+
a hostname.
|
|
84
|
+
|
|
85
|
+
Use synthetic, non-sensitive content and a test identity only if the journey
|
|
86
|
+
needs authentication. Reuse an authorized identity when possible. A public
|
|
87
|
+
tool needs neither signup nor a mailbox. Do not generate paid transactions,
|
|
88
|
+
send outreach or alter real customer records just to make a demo. Prepare any
|
|
89
|
+
necessary test state within the approved task scope.
|
|
90
|
+
|
|
91
|
+
## Capture real behavior
|
|
92
|
+
|
|
93
|
+
Use the harness's available browser/recording tools. If they cannot record,
|
|
94
|
+
follow [Recording options](references/recording.md). Identify the precise
|
|
95
|
+
missing dependency or permission if recording remains unavailable; screenshots
|
|
96
|
+
or AI-generated footage are not a completed recording.
|
|
97
|
+
|
|
98
|
+
Start from a ready page, perform meaningful actions and wait for visible
|
|
99
|
+
outcomes instead of relying only on fixed sleeps. Keep text legible at the
|
|
100
|
+
target size and let viewers see the result. If the app fails, record the defect
|
|
101
|
+
as a blocker; do not conceal it with a mock success screen. Cut idle/setup time,
|
|
102
|
+
not steps essential to understanding what the product really does.
|
|
103
|
+
|
|
104
|
+
## Verify and deliver
|
|
105
|
+
|
|
106
|
+
Inspect playback from start to finish and the poster at the intended display
|
|
107
|
+
size: content is readable, the promised result is visible, no private data is
|
|
108
|
+
exposed, and no black/error frames or accidental dialogs remain. Confirm file
|
|
109
|
+
duration, codec and dimensions, not just existence. Keep source revision/URL
|
|
110
|
+
and walkthrough steps with the project's existing asset records so another
|
|
111
|
+
session can reproduce the capture.
|
|
112
|
+
|
|
113
|
+
Store the video and poster in the requested destination; for embedding, use
|
|
114
|
+
the product's existing public asset convention. Check the actual browser
|
|
115
|
+
player, fallback poster and mobile layout. Provide controls or a pause option
|
|
116
|
+
for looping content; respect reduced motion and add captions when speech
|
|
117
|
+
carries meaning. Report local file paths, verified outcome and any limitations.
|
|
118
|
+
Publish only when authorized, using `egbe-os-git` and `egbe-os-deploy` for an Egbe-hosted app.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Recording options
|
|
2
|
+
|
|
3
|
+
Prefer a recording feature already available in the browser tool. Otherwise,
|
|
4
|
+
use an existing project-local Playwright installation or an approved isolated
|
|
5
|
+
tool environment. Do not change the product's dependencies or global browser
|
|
6
|
+
configuration just to capture a video.
|
|
7
|
+
|
|
8
|
+
With Playwright, create an isolated browser context with matching `viewport`
|
|
9
|
+
and `recordVideo.size` dimensions; the default recording may shrink the page
|
|
10
|
+
and make text unreadable. Inspect the live page and use its actual roles/selectors for
|
|
11
|
+
the planned actions. Save the `page.video()` handle, then **close the context**
|
|
12
|
+
before calling `video.saveAs(...)`: closing finalizes the WebM. Keep auth state
|
|
13
|
+
and credentials out of the saved assets. If browser binaries or recording
|
|
14
|
+
support are missing, report the dependency and use the harness's normal
|
|
15
|
+
installation/approval flow.
|
|
16
|
+
|
|
17
|
+
When FFmpeg is available, convert and create a poster from a useful frame:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
ffmpeg -n -i capture.webm -c:v libx264 -pix_fmt yuv420p \
|
|
21
|
+
-movflags +faststart -an demo.mp4
|
|
22
|
+
ffmpeg -n -ss 2 -i demo.mp4 -frames:v 1 demo-poster.jpg
|
|
23
|
+
ffprobe -v error -show_entries format=duration,size:stream=codec_name,width,height \
|
|
24
|
+
-of json demo.mp4
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Choose the poster timestamp from the actual recording; the example's two
|
|
28
|
+
seconds is not a product requirement. Preserve audio when it is part of the
|
|
29
|
+
requested story (remove `-an` and encode compatible audio). Use unique output
|
|
30
|
+
paths or explicitly approve replacing old assets; `-n` avoids overwriting them.
|
|
31
|
+
Compression, cropping and speed changes must preserve readable content and
|
|
32
|
+
must not misrepresent actual product latency. Validate playback after editing.
|