@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,137 @@
|
|
|
1
|
+
"""Capture/finalize state transitions and bounded, explicitly resumed delivery."""
|
|
2
|
+
import time
|
|
3
|
+
from uuid import uuid4
|
|
4
|
+
|
|
5
|
+
from . import protocol, transport
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
def capture(store, paths, *, unknown=False):
|
|
9
|
+
selected = protocol.method_paths(store.root, paths)
|
|
10
|
+
for record in store.records():
|
|
11
|
+
if record["status"] == "captured" and set(paths) & {item["path"] for item in record["files"]}:
|
|
12
|
+
raise ValueError("An unfinished capture already includes this file; resume or explicitly discard it")
|
|
13
|
+
base, key = transport.connection(store.root)
|
|
14
|
+
project_id = transport.identity(base, key)
|
|
15
|
+
files = [{"path": name, "before": protocol.snapshot(store.root, name, before=True, unknown=unknown)}
|
|
16
|
+
for name, _ in selected]
|
|
17
|
+
value = {"version": 1, "change_id": str(uuid4()), "origin": base,
|
|
18
|
+
"expected_project_id": project_id, "files": files, "status": "captured",
|
|
19
|
+
"created_at": protocol.now(), "attempts": 0, "next_retry_at": 0}
|
|
20
|
+
if len(protocol.canonical(files)) > protocol.MAX_PACKET:
|
|
21
|
+
raise ValueError("Selected before snapshots exceed the 2 MiB packet budget")
|
|
22
|
+
store.save(value, new=True)
|
|
23
|
+
return {"change_id": value["change_id"], "status": value["status"], "files": len(files)}
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
def finalize(store, identity, *, reason, expected_effect, initiator):
|
|
27
|
+
value = store.load(identity)
|
|
28
|
+
if value["status"] != "captured":
|
|
29
|
+
raise ValueError("This capture is already finalized; send its existing packet")
|
|
30
|
+
reason = protocol.metadata(reason, "reason", 4000)
|
|
31
|
+
effect = protocol.metadata(expected_effect, "expected_effect", 4000)
|
|
32
|
+
initiator = protocol.metadata(initiator, "initiator", 256)
|
|
33
|
+
paths = protocol.method_paths(store.root, [item["path"] for item in value["files"]])
|
|
34
|
+
changed = []
|
|
35
|
+
for item, (name, _) in zip(value["files"], paths):
|
|
36
|
+
before, after = item["before"], protocol.snapshot(store.root, name)
|
|
37
|
+
same = before["state"] == after["state"] and before["text"] == after["text"]
|
|
38
|
+
same = same or before["state"] == "absent" and after["state"] == "deleted"
|
|
39
|
+
if not same:
|
|
40
|
+
changed.append({**item, "after": after})
|
|
41
|
+
if not changed:
|
|
42
|
+
# Retain a compact local disposition; no server event and no private text.
|
|
43
|
+
value.pop("files")
|
|
44
|
+
value["status"] = "no_change"
|
|
45
|
+
store.save(value)
|
|
46
|
+
return {"change_id": identity, "status": "no_change"}
|
|
47
|
+
packet = {"client_change_id": identity, "expected_project_id": value["expected_project_id"],
|
|
48
|
+
"reason": reason, "expected_effect": effect, "initiator": initiator, "files": changed}
|
|
49
|
+
if len(protocol.canonical(packet)) > protocol.MAX_PACKET:
|
|
50
|
+
raise ValueError("Change packet exceeds 2 MiB; capture is preserved, do not truncate the text")
|
|
51
|
+
value.pop("files")
|
|
52
|
+
value.update(status="pending", packet=packet, content_hash=protocol.digest(packet))
|
|
53
|
+
store.save(value)
|
|
54
|
+
return {"change_id": identity, "status": "pending", "files": len(changed)}
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
def failure(store, value, error):
|
|
58
|
+
value["attempts"] += 1
|
|
59
|
+
value["error_code"] = error.code
|
|
60
|
+
if error.transient:
|
|
61
|
+
value["status"] = "pending"
|
|
62
|
+
value["next_retry_at"] = time.time() + max(error.retry_after, min(60 * 2 ** min(value["attempts"] - 1, 10), 3600))
|
|
63
|
+
else:
|
|
64
|
+
value["status"] = "held"
|
|
65
|
+
value["next_retry_at"] = 0
|
|
66
|
+
store.save(value)
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
def send(store, *, retry_held=None, max_packets=5, budget_seconds=30):
|
|
70
|
+
if not 1 <= max_packets <= 5 or not 1 <= budget_seconds <= 30:
|
|
71
|
+
raise ValueError("Send is limited to five packets and thirty seconds")
|
|
72
|
+
if retry_held:
|
|
73
|
+
protocol.change_id(retry_held)
|
|
74
|
+
target = store.load(retry_held)
|
|
75
|
+
if target["status"] != "held":
|
|
76
|
+
raise ValueError("Explicit retry expects a held record")
|
|
77
|
+
# An explicit recovery request must not be starved by unrelated due packets.
|
|
78
|
+
records = [target] if retry_held else [value for value in store.records() if
|
|
79
|
+
value["status"] == "pending" and value["next_retry_at"] <= time.time()]
|
|
80
|
+
records = records[:max_packets]
|
|
81
|
+
if not records:
|
|
82
|
+
return {"attempted": 0, "delivered": 0, "pending": 0, "held": 0}
|
|
83
|
+
base, key = transport.connection(store.root)
|
|
84
|
+
deadline = time.monotonic() + budget_seconds
|
|
85
|
+
result = {"attempted": 0, "delivered": 0, "pending": 0, "held": 0}
|
|
86
|
+
project = None
|
|
87
|
+
identity_error = None
|
|
88
|
+
for value in records:
|
|
89
|
+
if time.monotonic() >= deadline:
|
|
90
|
+
break
|
|
91
|
+
result["attempted"] += 1
|
|
92
|
+
try:
|
|
93
|
+
if value["origin"] != base:
|
|
94
|
+
raise transport.DeliveryError("origin_mismatch")
|
|
95
|
+
if (protocol.digest(value["packet"]) != value["content_hash"]
|
|
96
|
+
or value["packet"].get("client_change_id") != value["change_id"]
|
|
97
|
+
or value["packet"].get("expected_project_id") != value["expected_project_id"]):
|
|
98
|
+
raise transport.DeliveryError("frozen_packet_changed")
|
|
99
|
+
if identity_error:
|
|
100
|
+
raise identity_error
|
|
101
|
+
if project is None:
|
|
102
|
+
try:
|
|
103
|
+
project = transport.identity(base, key, timeout=max(0.1, min(10, deadline - time.monotonic())))
|
|
104
|
+
except transport.DeliveryError as error:
|
|
105
|
+
identity_error = error
|
|
106
|
+
raise
|
|
107
|
+
if project != value["expected_project_id"]:
|
|
108
|
+
raise transport.DeliveryError("project_mismatch")
|
|
109
|
+
remaining = deadline - time.monotonic()
|
|
110
|
+
if remaining <= 0:
|
|
111
|
+
raise transport.DeliveryError("delivery_budget_exhausted", transient=True)
|
|
112
|
+
received = transport.request(base, key, "/playbooks/changes", packet=value["packet"], timeout=min(10, remaining))
|
|
113
|
+
try:
|
|
114
|
+
receipt = protocol.receipt(received, value["content_hash"])
|
|
115
|
+
except (ValueError, TypeError, AttributeError):
|
|
116
|
+
raise transport.DeliveryError("unverified_receipt", transient=True) from None
|
|
117
|
+
value.update(status="delivered", receipt=receipt, next_retry_at=0)
|
|
118
|
+
value.pop("error_code", None)
|
|
119
|
+
# The server confirmed the immutable packet: keep only the receipt
|
|
120
|
+
# locally, not an unbounded second archive of method snapshots.
|
|
121
|
+
value.pop("packet")
|
|
122
|
+
store.save(value)
|
|
123
|
+
except transport.DeliveryError as error:
|
|
124
|
+
failure(store, value, error)
|
|
125
|
+
result[value["status"]] += 1
|
|
126
|
+
return result
|
|
127
|
+
|
|
128
|
+
|
|
129
|
+
def status(store, identity=None):
|
|
130
|
+
values = [store.load(identity)] if identity else [value for value in store.records()
|
|
131
|
+
if value["status"] in {"captured", "pending", "held"}]
|
|
132
|
+
return [{"change_id": value["change_id"], "status": value["status"],
|
|
133
|
+
"project_id": value["expected_project_id"], "created_at": value["created_at"],
|
|
134
|
+
**({"error_code": value["error_code"]} if value.get("error_code") else {}),
|
|
135
|
+
**({"next_retry_at": value["next_retry_at"]} if value.get("next_retry_at") else {}),
|
|
136
|
+
**({"receipt": value["receipt"]} if value.get("receipt") else {})}
|
|
137
|
+
for value in values]
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
"""Wire representation and path/content checks, without transport or persistence."""
|
|
2
|
+
from datetime import datetime, timezone
|
|
3
|
+
import hashlib
|
|
4
|
+
import json
|
|
5
|
+
import os
|
|
6
|
+
from pathlib import Path, PurePosixPath
|
|
7
|
+
import stat
|
|
8
|
+
from uuid import UUID
|
|
9
|
+
|
|
10
|
+
MAX_FILES = 16
|
|
11
|
+
MAX_TEXT = 256 * 1024
|
|
12
|
+
MAX_PACKET = 2 * 1024 * 1024
|
|
13
|
+
|
|
14
|
+
|
|
15
|
+
def now():
|
|
16
|
+
return datetime.now(timezone.utc).isoformat()
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def canonical(value):
|
|
20
|
+
return json.dumps(value, ensure_ascii=False, sort_keys=True, separators=(",", ":")).encode("utf-8")
|
|
21
|
+
|
|
22
|
+
|
|
23
|
+
def digest(value):
|
|
24
|
+
return hashlib.sha256(canonical(value)).hexdigest()
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
def change_id(value):
|
|
28
|
+
try:
|
|
29
|
+
normalized = str(UUID(value))
|
|
30
|
+
except (ValueError, TypeError, AttributeError):
|
|
31
|
+
raise ValueError("Invalid change ID") from None
|
|
32
|
+
if normalized != value:
|
|
33
|
+
raise ValueError("Use the canonical change ID returned by capture")
|
|
34
|
+
return normalized
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
def valid_path(value):
|
|
38
|
+
parts = value.split("/")
|
|
39
|
+
if (len(parts) < 3 or parts[:2] != ["egbe-docs", "playbooks"]
|
|
40
|
+
or any(part in {"", ".", ".."} or part.startswith(".") for part in parts)
|
|
41
|
+
or any(char in value for char in "\\%?#:\x00")
|
|
42
|
+
or any(ord(char) < 32 or ord(char) == 127 for char in value) or len(value) > 512
|
|
43
|
+
or PurePosixPath(value).suffix != ".md"):
|
|
44
|
+
raise ValueError("Choose relative Markdown files under egbe-docs/playbooks")
|
|
45
|
+
return value
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def method_paths(root, paths):
|
|
49
|
+
if not 1 <= len(paths) <= MAX_FILES:
|
|
50
|
+
raise ValueError("Choose between 1 and 16 method files")
|
|
51
|
+
seen_names, seen_files = set(), set()
|
|
52
|
+
result = []
|
|
53
|
+
for name in paths:
|
|
54
|
+
valid_path(name)
|
|
55
|
+
target = root / name
|
|
56
|
+
current = root
|
|
57
|
+
for part in Path(name).parts:
|
|
58
|
+
current = current / part
|
|
59
|
+
if current.is_symlink():
|
|
60
|
+
raise ValueError("Method files and their parent directories must not be symlinks")
|
|
61
|
+
if target.exists() and not target.is_file():
|
|
62
|
+
raise ValueError("A selected method path is not a regular file")
|
|
63
|
+
resolved = target.resolve()
|
|
64
|
+
if not resolved.is_relative_to(root / "egbe-docs/playbooks") or resolved in seen_names:
|
|
65
|
+
raise ValueError("Duplicate or escaping method path")
|
|
66
|
+
seen_names.add(resolved)
|
|
67
|
+
if target.exists():
|
|
68
|
+
stat = target.stat()
|
|
69
|
+
inode = (stat.st_dev, stat.st_ino)
|
|
70
|
+
if inode in seen_files or stat.st_nlink != 1:
|
|
71
|
+
raise ValueError("Method aliases and hard links are not supported")
|
|
72
|
+
seen_files.add(inode)
|
|
73
|
+
result.append((name, target))
|
|
74
|
+
return result
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
def open_method(root, name):
|
|
78
|
+
"""Walk from an opened workspace directory, rejecting symlink swaps too."""
|
|
79
|
+
flags = os.O_RDONLY | getattr(os, "O_NOFOLLOW", 0)
|
|
80
|
+
directory = os.open(root, flags | getattr(os, "O_DIRECTORY", 0))
|
|
81
|
+
try:
|
|
82
|
+
parts = Path(name).parts
|
|
83
|
+
for part in parts[:-1]:
|
|
84
|
+
child = os.open(part, flags | getattr(os, "O_DIRECTORY", 0), dir_fd=directory)
|
|
85
|
+
os.close(directory)
|
|
86
|
+
directory = child
|
|
87
|
+
return os.open(parts[-1], flags | getattr(os, "O_NONBLOCK", 0), dir_fd=directory)
|
|
88
|
+
finally:
|
|
89
|
+
os.close(directory)
|
|
90
|
+
|
|
91
|
+
|
|
92
|
+
def snapshot(root, name, *, before=False, unknown=False):
|
|
93
|
+
if unknown:
|
|
94
|
+
return {"state": "unknown", "text": None, "captured_at": now()}
|
|
95
|
+
try:
|
|
96
|
+
descriptor = open_method(root, name)
|
|
97
|
+
except FileNotFoundError:
|
|
98
|
+
return {"state": "absent" if before else "deleted", "text": None, "captured_at": now()}
|
|
99
|
+
# Decode bytes explicitly: text-mode reads would normalize CRLF.
|
|
100
|
+
with os.fdopen(descriptor, "rb") as stream:
|
|
101
|
+
initial = os.fstat(stream.fileno())
|
|
102
|
+
if not stat.S_ISREG(initial.st_mode) or initial.st_nlink != 1:
|
|
103
|
+
raise ValueError("Method snapshots require regular files without hard links")
|
|
104
|
+
raw = stream.read(MAX_TEXT + 1)
|
|
105
|
+
final = os.fstat(stream.fileno())
|
|
106
|
+
if (initial.st_size, initial.st_mtime_ns) != (final.st_size, final.st_mtime_ns):
|
|
107
|
+
raise ValueError("Method file changed during capture; retry after editing stops")
|
|
108
|
+
if len(raw) > MAX_TEXT:
|
|
109
|
+
raise ValueError("A method snapshot exceeds 256 KiB")
|
|
110
|
+
try:
|
|
111
|
+
text = raw.decode("utf-8")
|
|
112
|
+
except UnicodeDecodeError:
|
|
113
|
+
raise ValueError("Method files must be UTF-8") from None
|
|
114
|
+
if "\x00" in text:
|
|
115
|
+
raise ValueError("Method files must not contain NUL")
|
|
116
|
+
return {"state": "captured", "text": text, "captured_at": now()}
|
|
117
|
+
|
|
118
|
+
|
|
119
|
+
def metadata(value, field, maximum):
|
|
120
|
+
if not isinstance(value, str) or not value.strip() or len(value) > maximum or "\x00" in value:
|
|
121
|
+
raise ValueError(f"{field} must contain 1–{maximum} characters without NUL")
|
|
122
|
+
return value
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
def receipt(value, expected_hash):
|
|
126
|
+
if not isinstance(value, dict) or value.get("content_hash") != expected_hash:
|
|
127
|
+
raise ValueError("Delivery returned an unverified receipt")
|
|
128
|
+
change_id(value.get("id"))
|
|
129
|
+
stamp = datetime.fromisoformat(value.get("received_at", "").replace("Z", "+00:00"))
|
|
130
|
+
if stamp.tzinfo is None:
|
|
131
|
+
raise ValueError("Receipt time must include timezone")
|
|
132
|
+
return {key: value[key] for key in ("id", "content_hash", "received_at")}
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
"""Private, locked, atomic local records; never persist credentials."""
|
|
2
|
+
from contextlib import contextmanager
|
|
3
|
+
import json
|
|
4
|
+
import os
|
|
5
|
+
from pathlib import Path
|
|
6
|
+
import subprocess
|
|
7
|
+
import tempfile
|
|
8
|
+
|
|
9
|
+
from .protocol import canonical, change_id
|
|
10
|
+
|
|
11
|
+
MAX_ACTIVE = 100
|
|
12
|
+
MAX_STORAGE = 64 * 1024 * 1024
|
|
13
|
+
MAX_RECORD = 5 * 1024 * 1024
|
|
14
|
+
ACTIVE = {"captured", "pending", "held"}
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
def regular(path):
|
|
18
|
+
if path.is_symlink() or (path.exists() and not path.is_file()):
|
|
19
|
+
raise ValueError("Transport and exclusion files must be regular files")
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
def atomic_write(path, value):
|
|
23
|
+
regular(path)
|
|
24
|
+
raw = canonical(value)
|
|
25
|
+
descriptor, temp = tempfile.mkstemp(prefix=".write-", dir=path.parent)
|
|
26
|
+
try:
|
|
27
|
+
with os.fdopen(descriptor, "wb") as stream:
|
|
28
|
+
stream.write(raw)
|
|
29
|
+
stream.flush()
|
|
30
|
+
os.fsync(stream.fileno())
|
|
31
|
+
os.replace(temp, path)
|
|
32
|
+
if os.name != "nt":
|
|
33
|
+
directory = os.open(path.parent, os.O_RDONLY)
|
|
34
|
+
try:
|
|
35
|
+
os.fsync(directory)
|
|
36
|
+
finally:
|
|
37
|
+
os.close(directory)
|
|
38
|
+
finally:
|
|
39
|
+
if os.path.exists(temp):
|
|
40
|
+
os.unlink(temp)
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
class Store:
|
|
44
|
+
def __init__(self, root):
|
|
45
|
+
self.root = Path(root).resolve(strict=True)
|
|
46
|
+
self.path = self.root / "egbe-docs/.local/playbook-changes"
|
|
47
|
+
|
|
48
|
+
def require_inspectable_checkout(self):
|
|
49
|
+
markers = (folder / ".git" for folder in (self.root, *self.root.parents))
|
|
50
|
+
if any(path.exists() or path.is_symlink() for path in markers) or os.environ.get("GIT_DIR") or os.environ.get("GIT_WORK_TREE"):
|
|
51
|
+
raise ValueError("Existing Git checkout cannot be inspected; resolve Git access before recording")
|
|
52
|
+
|
|
53
|
+
def prepare(self):
|
|
54
|
+
for name, rule in ((".gitignore", "/egbe-docs/.local/"),
|
|
55
|
+
(".dockerignore", "/egbe-docs/")):
|
|
56
|
+
path = self.root / name
|
|
57
|
+
regular(path)
|
|
58
|
+
text = path.read_text(encoding="utf-8") if path.exists() else ""
|
|
59
|
+
# Last match wins; append after any existing negations.
|
|
60
|
+
if not text.splitlines() or text.splitlines()[-1] != rule:
|
|
61
|
+
with path.open("a", encoding="utf-8") as stream:
|
|
62
|
+
stream.write(("\n" if text and not text.endswith("\n") else "") + rule + "\n")
|
|
63
|
+
# An ignore rule cannot make an already tracked file private.
|
|
64
|
+
try:
|
|
65
|
+
tracked = subprocess.run(
|
|
66
|
+
["git", "-C", str(self.root), "ls-files", "--", "egbe-docs/.local"],
|
|
67
|
+
capture_output=True, timeout=5, check=False,
|
|
68
|
+
)
|
|
69
|
+
except (FileNotFoundError, subprocess.TimeoutExpired):
|
|
70
|
+
self.require_inspectable_checkout()
|
|
71
|
+
tracked = None
|
|
72
|
+
if tracked and tracked.returncode != 0:
|
|
73
|
+
self.require_inspectable_checkout()
|
|
74
|
+
if tracked and tracked.returncode == 0 and tracked.stdout.strip():
|
|
75
|
+
raise ValueError("Private egbe-docs/.local files are tracked by Git; resolve before capture")
|
|
76
|
+
current = self.root
|
|
77
|
+
for part in self.path.relative_to(self.root).parts:
|
|
78
|
+
current /= part
|
|
79
|
+
if current.is_symlink() or (current.exists() and not current.is_dir()):
|
|
80
|
+
raise ValueError("Transport directories must not be symlinks or files")
|
|
81
|
+
current.mkdir(mode=0o700, exist_ok=True)
|
|
82
|
+
# A deeper egbe-docs/.gitignore can negate the root exclusion. Keep the
|
|
83
|
+
# transport's own rule closest to its files, and verify each real write.
|
|
84
|
+
exclusion = self.path / ".gitignore"
|
|
85
|
+
regular(exclusion)
|
|
86
|
+
text = exclusion.read_text(encoding="utf-8") if exclusion.exists() else ""
|
|
87
|
+
if not text.splitlines() or text.splitlines()[-1] != "*":
|
|
88
|
+
with exclusion.open("a", encoding="utf-8") as stream:
|
|
89
|
+
stream.write(("\n" if text and not text.endswith("\n") else "") + "*\n")
|
|
90
|
+
|
|
91
|
+
def verify_ignored(self, path):
|
|
92
|
+
try:
|
|
93
|
+
repository = subprocess.run(["git", "-C", str(self.root), "rev-parse", "--is-inside-work-tree"],
|
|
94
|
+
capture_output=True, timeout=5, check=False)
|
|
95
|
+
if repository.returncode != 0:
|
|
96
|
+
self.require_inspectable_checkout()
|
|
97
|
+
return # No repository yet; the local ignore rule applies after init.
|
|
98
|
+
ignored = subprocess.run(["git", "-C", str(self.root), "check-ignore", "--quiet", "--",
|
|
99
|
+
str(path.relative_to(self.root))],
|
|
100
|
+
capture_output=True, timeout=5, check=False)
|
|
101
|
+
except (FileNotFoundError, subprocess.TimeoutExpired):
|
|
102
|
+
self.require_inspectable_checkout()
|
|
103
|
+
return
|
|
104
|
+
if ignored.returncode != 0:
|
|
105
|
+
raise ValueError("Private transport path is not Git-ignored; resolve exclusions before recording")
|
|
106
|
+
|
|
107
|
+
@contextmanager
|
|
108
|
+
def locked(self):
|
|
109
|
+
self.prepare()
|
|
110
|
+
lock = self.path / ".lock"
|
|
111
|
+
regular(lock)
|
|
112
|
+
descriptor = os.open(lock, os.O_RDWR | os.O_CREAT | getattr(os, "O_NOFOLLOW", 0), 0o600)
|
|
113
|
+
with os.fdopen(descriptor, "r+b") as stream:
|
|
114
|
+
if os.name == "nt":
|
|
115
|
+
import msvcrt
|
|
116
|
+
stream.write(b"0")
|
|
117
|
+
stream.flush()
|
|
118
|
+
stream.seek(0)
|
|
119
|
+
msvcrt.locking(stream.fileno(), msvcrt.LK_NBLCK, 1)
|
|
120
|
+
else:
|
|
121
|
+
import fcntl
|
|
122
|
+
fcntl.flock(stream.fileno(), fcntl.LOCK_EX | fcntl.LOCK_NB)
|
|
123
|
+
try:
|
|
124
|
+
yield self
|
|
125
|
+
finally:
|
|
126
|
+
if os.name == "nt":
|
|
127
|
+
stream.seek(0)
|
|
128
|
+
msvcrt.locking(stream.fileno(), msvcrt.LK_UNLCK, 1)
|
|
129
|
+
else:
|
|
130
|
+
fcntl.flock(stream.fileno(), fcntl.LOCK_UN)
|
|
131
|
+
|
|
132
|
+
def load(self, identity):
|
|
133
|
+
path = self.path / (change_id(identity) + ".json")
|
|
134
|
+
regular(path)
|
|
135
|
+
if path.stat().st_size > MAX_RECORD:
|
|
136
|
+
raise ValueError("A local transport record exceeds its size limit")
|
|
137
|
+
try:
|
|
138
|
+
value = json.loads(path.read_bytes())
|
|
139
|
+
except (ValueError, UnicodeDecodeError):
|
|
140
|
+
raise ValueError("A local transport record is invalid; preserve it for inspection") from None
|
|
141
|
+
if (not isinstance(value, dict) or value.get("version") != 1 or value.get("change_id") != identity
|
|
142
|
+
or value.get("status") not in ACTIVE | {"delivered", "no_change"}
|
|
143
|
+
or type(value.get("expected_project_id")) is not int or value["expected_project_id"] <= 0
|
|
144
|
+
or not isinstance(value.get("origin"), str) or not isinstance(value.get("created_at"), str)
|
|
145
|
+
or type(value.get("attempts")) is not int or value["attempts"] < 0
|
|
146
|
+
or not isinstance(value.get("next_retry_at"), (int, float))):
|
|
147
|
+
raise ValueError("A local transport record has an unknown format or identity")
|
|
148
|
+
if value["status"] == "captured" and not isinstance(value.get("files"), list):
|
|
149
|
+
raise ValueError("Local capture contents are invalid; preserve the file for inspection")
|
|
150
|
+
if value["status"] in {"pending", "held"} and (not isinstance(value.get("packet"), dict)
|
|
151
|
+
or not isinstance(value.get("content_hash"), str)):
|
|
152
|
+
raise ValueError("Local packet contents are invalid; preserve the file for inspection")
|
|
153
|
+
return value
|
|
154
|
+
|
|
155
|
+
def records(self):
|
|
156
|
+
return [self.load(path.stem) for path in sorted(self.path.glob("*.json"))]
|
|
157
|
+
|
|
158
|
+
def save(self, value, *, new=False):
|
|
159
|
+
path = self.path / (change_id(value["change_id"]) + ".json")
|
|
160
|
+
self.verify_ignored(path)
|
|
161
|
+
if new and path.exists():
|
|
162
|
+
raise ValueError("Refusing to overwrite an existing capture")
|
|
163
|
+
raw = canonical(value)
|
|
164
|
+
if len(raw) > MAX_RECORD:
|
|
165
|
+
raise ValueError("Local capture exceeds its size limit; existing data was preserved")
|
|
166
|
+
size = 0
|
|
167
|
+
for item in self.path.iterdir():
|
|
168
|
+
regular(item)
|
|
169
|
+
size += item.stat().st_size
|
|
170
|
+
if size - (path.stat().st_size if path.exists() else 0) + len(raw) > MAX_STORAGE:
|
|
171
|
+
raise ValueError("Local journal is full; preserve pending records and inspect storage")
|
|
172
|
+
if new and sum(record["status"] in ACTIVE for record in self.records()) >= MAX_ACTIVE:
|
|
173
|
+
raise ValueError("100 unfinished records already exist; resolve delivery before new capture")
|
|
174
|
+
atomic_write(path, value)
|
|
175
|
+
|
|
176
|
+
def discard(self, identity):
|
|
177
|
+
value = self.load(identity)
|
|
178
|
+
if value["status"] != "captured":
|
|
179
|
+
raise ValueError("Only an unfinished, unfinalized capture can be explicitly discarded")
|
|
180
|
+
(self.path / (identity + ".json")).unlink()
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
"""Origin-pinned HTTP with no redirects or provider/error-body disclosure."""
|
|
2
|
+
import json
|
|
3
|
+
import os
|
|
4
|
+
import re
|
|
5
|
+
import shlex
|
|
6
|
+
import time
|
|
7
|
+
from urllib.error import HTTPError, URLError
|
|
8
|
+
from urllib.parse import urlsplit
|
|
9
|
+
from urllib.request import HTTPRedirectHandler, Request, build_opener
|
|
10
|
+
|
|
11
|
+
MAX_RESPONSE = 128 * 1024
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
class DeliveryError(Exception):
|
|
15
|
+
def __init__(self, code, *, transient=False, retry_after=0):
|
|
16
|
+
self.code = code
|
|
17
|
+
self.transient = transient
|
|
18
|
+
self.retry_after = retry_after
|
|
19
|
+
super().__init__(code)
|
|
20
|
+
|
|
21
|
+
|
|
22
|
+
def origin(value):
|
|
23
|
+
parsed = urlsplit(value)
|
|
24
|
+
if (parsed.scheme not in {"https", "http"} or not parsed.hostname
|
|
25
|
+
or parsed.username or parsed.password or parsed.query or parsed.fragment
|
|
26
|
+
or parsed.path not in {"", "/"}
|
|
27
|
+
or (parsed.scheme == "http" and parsed.hostname not in {"localhost", "127.0.0.1", "::1"})):
|
|
28
|
+
raise ValueError("OS_URL must be an HTTPS origin (HTTP is allowed only for loopback tests)")
|
|
29
|
+
if any(ord(char) < 33 for char in value):
|
|
30
|
+
raise ValueError("OS_URL contains invalid characters")
|
|
31
|
+
port = parsed.port
|
|
32
|
+
host = "[" + parsed.hostname + "]" if ":" in parsed.hostname else parsed.hostname
|
|
33
|
+
return parsed.scheme + "://" + host + (f":{port}" if port and port != {"http": 80, "https": 443}[parsed.scheme] else "")
|
|
34
|
+
|
|
35
|
+
|
|
36
|
+
def connection(root):
|
|
37
|
+
path = root / ".env.local"
|
|
38
|
+
if path.is_symlink() or (path.exists() and not path.is_file()):
|
|
39
|
+
raise ValueError("Connection settings must be a regular project-local .env.local file")
|
|
40
|
+
if path.exists():
|
|
41
|
+
if path.stat().st_size > 1024 * 1024:
|
|
42
|
+
raise ValueError("Connection settings file is unexpectedly large")
|
|
43
|
+
values = {}
|
|
44
|
+
for line in path.read_text(encoding="utf-8").splitlines():
|
|
45
|
+
match = re.match(r"(?:export\s+)?(OS_URL|OS_API_KEY)\s*=(.*)$", line.strip())
|
|
46
|
+
if match:
|
|
47
|
+
try:
|
|
48
|
+
pieces = shlex.split(match[2], comments=True)
|
|
49
|
+
except ValueError:
|
|
50
|
+
raise ValueError("Invalid quoting in connection settings") from None
|
|
51
|
+
if len(pieces) != 1:
|
|
52
|
+
raise ValueError("Connection settings must be literal values")
|
|
53
|
+
values[match[1]] = pieces[0]
|
|
54
|
+
else:
|
|
55
|
+
values = {name: os.environ.get(name, "") for name in ("OS_URL", "OS_API_KEY")}
|
|
56
|
+
if not values.get("OS_URL") or not values.get("OS_API_KEY"):
|
|
57
|
+
raise ValueError("Set OS_URL and OS_API_KEY in this project's .env.local first")
|
|
58
|
+
key = values["OS_API_KEY"]
|
|
59
|
+
if len(key) > 4096 or any(ord(char) < 33 or ord(char) > 126 for char in key):
|
|
60
|
+
raise ValueError("Invalid project credential format")
|
|
61
|
+
return origin(values["OS_URL"]), key
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
class NoRedirects(HTTPRedirectHandler):
|
|
65
|
+
def redirect_request(self, req, fp, code, msg, headers, newurl):
|
|
66
|
+
return None
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
def request(base, key, path, *, packet=None, timeout=10):
|
|
70
|
+
from .protocol import canonical
|
|
71
|
+
req = Request(base + path, data=canonical(packet) if packet is not None else None,
|
|
72
|
+
headers={"Authorization": "Bearer " + key, "Accept": "application/json",
|
|
73
|
+
"Content-Type": "application/json", "User-Agent": "egbe-playbook-changes/1"},
|
|
74
|
+
method="POST" if packet is not None else "GET")
|
|
75
|
+
try:
|
|
76
|
+
deadline = time.monotonic() + timeout
|
|
77
|
+
with build_opener(NoRedirects()).open(req, timeout=timeout) as response:
|
|
78
|
+
raw = bytearray()
|
|
79
|
+
while True:
|
|
80
|
+
remaining = deadline - time.monotonic()
|
|
81
|
+
if remaining <= 0:
|
|
82
|
+
raise DeliveryError("network_timeout", transient=True)
|
|
83
|
+
# urllib's timeout is per socket operation. Tighten it to the
|
|
84
|
+
# remaining request budget so a slow stream cannot prolong it.
|
|
85
|
+
sock = getattr(getattr(response.fp, "raw", None), "_sock", None)
|
|
86
|
+
if sock is not None:
|
|
87
|
+
sock.settimeout(remaining)
|
|
88
|
+
chunk = response.read1(min(8192, MAX_RESPONSE + 1 - len(raw)))
|
|
89
|
+
if not chunk:
|
|
90
|
+
break
|
|
91
|
+
raw.extend(chunk)
|
|
92
|
+
if len(raw) > MAX_RESPONSE:
|
|
93
|
+
raise DeliveryError("unverified_response", transient=True)
|
|
94
|
+
value = json.loads(raw)
|
|
95
|
+
except HTTPError as error:
|
|
96
|
+
retry = error.headers.get("Retry-After", "0")
|
|
97
|
+
retry = min(int(retry), 86400) if retry.isdigit() else 0
|
|
98
|
+
error.close()
|
|
99
|
+
raise DeliveryError("http_" + str(error.code), transient=(error.code == 429 or 500 <= error.code < 600 and error.code != 507), retry_after=retry) from None
|
|
100
|
+
except (URLError, TimeoutError, ConnectionError, OSError):
|
|
101
|
+
raise DeliveryError("network_unavailable", transient=True) from None
|
|
102
|
+
except (ValueError, UnicodeDecodeError):
|
|
103
|
+
raise DeliveryError("unverified_response", transient=True) from None
|
|
104
|
+
if not isinstance(value, dict) or value.get("code") != 200 or not isinstance(value.get("data"), dict):
|
|
105
|
+
raise DeliveryError("unverified_response", transient=True)
|
|
106
|
+
return value["data"]
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
def identity(base, key, *, timeout=10):
|
|
110
|
+
project = request(base, key, "/me/limits", timeout=timeout).get("instance_id")
|
|
111
|
+
if type(project) is not int or project <= 0:
|
|
112
|
+
raise DeliveryError("unverified_project", transient=True)
|
|
113
|
+
return project
|