@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,163 @@
|
|
|
1
|
+
# Channel Footprint
|
|
2
|
+
|
|
3
|
+
Read `../contracts/research-artifacts.md`. This internal section owns its
|
|
4
|
+
collection, normalized evidence and rendered prose. Do not manually edit those
|
|
5
|
+
outputs. The agent does write product relevance decisions in the separate
|
|
6
|
+
staged input described below; it does not invent provider facts.
|
|
7
|
+
|
|
8
|
+
## Inputs and planning
|
|
9
|
+
|
|
10
|
+
Use completed Competitor Set roles and their decision provenance. Explicit
|
|
11
|
+
or Keyword Economics domains without a role remain `unknown`, not direct.
|
|
12
|
+
Keep direct, indirect and unknown comparability roles separate in summaries;
|
|
13
|
+
these roles do not confer business priority or exclude assigned observations. Pass `--domains` to add domains and
|
|
14
|
+
`--product-domain` to exclude the product's own site.
|
|
15
|
+
|
|
16
|
+
Supply target countries with `--countries US,GB,DE` (alias `--target-countries`)
|
|
17
|
+
or `--country` for one country. Explicit flags take precedence over the optional
|
|
18
|
+
typed `intake.json` `markets` list; no geography is parsed from prose. Check every
|
|
19
|
+
country; UK becomes GB and EU/EEA requires an explicit list. The adapter's US
|
|
20
|
+
fallback is not a market choice. `--eu-country` does not replace target markets.
|
|
21
|
+
Supply optional provider-safe background through `--context-file`; relevance uses
|
|
22
|
+
that frozen text and the explicitly supplied typed offer, not unrelated files.
|
|
23
|
+
|
|
24
|
+
The runner records `egbe-docs/research/market/work/channel_footprint/collection-plan.json`
|
|
25
|
+
before collection: scoped checks, a bounded sample expansion and a cumulative paid-start limit. Domain tags, traffic,
|
|
26
|
+
history and undated libraries are queried once. Country-filterable libraries
|
|
27
|
+
are checked per country; unsupported countries get explicit coverage gaps.
|
|
28
|
+
Prices are shown only when known (otherwise `money_estimate: null`). The plan counts three partner searches per country, both Meta methods in supported EU countries, and a separate bounded retry reserve.
|
|
29
|
+
|
|
30
|
+
## Staged collection and product relevance
|
|
31
|
+
|
|
32
|
+
Resolve `<pmr>` to the extracted Product Market Research bundle. Set
|
|
33
|
+
`OS_API_KEY` and optionally `OS_URL` for collection. The caller owns Git publication.
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
python3 <pmr>/scripts/run-channel-footprint.py --workspace "$WS" \
|
|
37
|
+
--product-domain product.com --countries US,GB --stage collect
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Collection preserves the provider cache, `egbe-docs/research/market/work/channel_footprint/collected.json`
|
|
41
|
+
and `relevance-candidates.json`. The candidates contain the selected research/offer
|
|
42
|
+
context, competitor decisions and unique normalized ads with native IDs,
|
|
43
|
+
text, landing and source URLs, image/video URLs and observations. Inspect the
|
|
44
|
+
ad text and landing offer together with the buyer and task in the context.
|
|
45
|
+
If a landing page is available, use its content and record its URL as a
|
|
46
|
+
reasoning reference. A keyword match alone is not product relevance.
|
|
47
|
+
|
|
48
|
+
Write `egbe-docs/research/market/work/channel_footprint/relevance-decisions.json`:
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{
|
|
52
|
+
"schema_version": 1,
|
|
53
|
+
"product_context_sha256": "<copy from candidates>",
|
|
54
|
+
"decisions": [
|
|
55
|
+
{
|
|
56
|
+
"ad_id": "<canonical ad_id>",
|
|
57
|
+
"candidate_sha256": "<copy from this candidate>",
|
|
58
|
+
"relevance": "relevant",
|
|
59
|
+
"reason": "Comparable offer, buyer and job; the landing offer and copy show why.",
|
|
60
|
+
"evidence_refs": ["<landing URL>", "<source URL or ad_id:ad_text>"]
|
|
61
|
+
}
|
|
62
|
+
]
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
`--relevance-by-model` writes these decisions itself for every pending ad
|
|
67
|
+
with text or a downloadable image: the creative classifier
|
|
68
|
+
(`POST /v1/media/classify-creative`) judges the ad against the offer card and
|
|
69
|
+
returns relevant, irrelevant or unknown with its reason and a verbatim
|
|
70
|
+
excerpt, recorded as `decided_by: model`. The runner then collects again
|
|
71
|
+
(a decided sample may expand once) and leaves only ads with neither text nor
|
|
72
|
+
image pending for you.
|
|
73
|
+
|
|
74
|
+
Allowed decisions: `relevant`, `irrelevant`, `unknown`. Every decision needs a
|
|
75
|
+
reason and an `evidence_refs` array. Relevant/irrelevant decisions need at
|
|
76
|
+
least one reference. Use unknown when evidence is insufficient; it cannot
|
|
77
|
+
establish product comparability. Irrelevant ads stay in the corpus for
|
|
78
|
+
audit, never in product conclusions. Decisions are reused only for identical
|
|
79
|
+
candidate and product/intake context hashes. Native-ID deduplication merges
|
|
80
|
+
Meta actor/API observations and multi-country sightings; equal copy without
|
|
81
|
+
a native ID does not imply continuous delivery.
|
|
82
|
+
|
|
83
|
+
Run collect again with the same arguments. It reuses cached direct checks,
|
|
84
|
+
validates their decisions and expands a capped sample once if it contains
|
|
85
|
+
no comparable ads. All assigned competitor roles are collected; no direct-count
|
|
86
|
+
threshold decides whether an indirect competitor may be inspected. Review any new
|
|
87
|
+
candidates and repeat until collection is complete. The expansion can fill
|
|
88
|
+
an empty field (an image, text or URL) of an ad you already decided; collect
|
|
89
|
+
then lists that ad in `pending_ad_ids` again with a new `candidate_sha256`,
|
|
90
|
+
so decide it again. A collected expansion stays in later collects even if
|
|
91
|
+
that review finds the ad relevant. A source without
|
|
92
|
+
pagination uses one configured increased limit; expansion never grows
|
|
93
|
+
without a bound.
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
python3 <pmr>/scripts/run-channel-footprint.py --workspace "$WS" \
|
|
97
|
+
--product-domain product.com --countries US,GB --stage finalize
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
Finalize is offline and uses collected data; it never starts providers or
|
|
101
|
+
needs `OS_API_KEY`. Missing/stale decisions do not produce a completed receipt.
|
|
102
|
+
Exit 2 and `awaiting_relevance`, `awaiting_collection` or `awaiting_finalize`
|
|
103
|
+
identify the next required step. Explicit unknown decisions allow completion
|
|
104
|
+
with clearly recorded gaps. Default `--stage all` collects and completes only
|
|
105
|
+
when the current decision set and collection are ready. Pixel-only/free-only
|
|
106
|
+
runs with no ads require no relevance decisions.
|
|
107
|
+
|
|
108
|
+
## Evidence and meaning
|
|
109
|
+
|
|
110
|
+
Evidence v2 is `egbe-docs/research/market/evidence/channel-footprint.json`; the
|
|
111
|
+
receipt remains schema 1 and binds output, effective policy, current intake,
|
|
112
|
+
Competitor Set and relevance decisions. It contains `channel_ad` corpus,
|
|
113
|
+
`library_presence` aggregates, `channel_country`, direct `channel_observation`, tags,
|
|
114
|
+
modeled traffic/spend, partner/history measurements and coverage. The renderer
|
|
115
|
+
preserves the direct matrix, separate indirect/unclassified tables, country
|
|
116
|
+
observations, source samples, measurements and explicit coverage statuses.
|
|
117
|
+
|
|
118
|
+
The observation contract and its hash travel with evidence and receipts.
|
|
119
|
+
Native dates, scoped served duration and days since last delivery remain
|
|
120
|
+
measurements. Only explicit native status establishes observed activity;
|
|
121
|
+
a recent last-seen date is not an active flag. A confirmed past delivery end
|
|
122
|
+
wins over an active flag except the documented provider capture-day grace.
|
|
123
|
+
Global ad-level dates never become country delivery dates merely because the
|
|
124
|
+
query supplied a country. Durations are bounded by capture and never add
|
|
125
|
+
separate runs together. No duration proves profitability or channel success.
|
|
126
|
+
|
|
127
|
+
Native placement, not VIDEO/IMAGE format, is required to assert YouTube or
|
|
128
|
+
Display delivery. LinkedIn listing sightings and Reddit creation dates cannot
|
|
129
|
+
supply served duration. Repeated dated sightings are repeated presence
|
|
130
|
+
only. Reddit Inspiration cannot verify current campaigns, even at zero.
|
|
131
|
+
Source capabilities and native scope constraints live in the sources config.
|
|
132
|
+
Additional platforms need verified source/signature support; never invent an
|
|
133
|
+
OpenAI Ads pixel signature or unseen advertising data.
|
|
134
|
+
|
|
135
|
+
Channel summaries report distinct observed competitors and preserve evidence
|
|
136
|
+
kinds: pixel, listing, native activity, modeled traffic/spend and partner signal.
|
|
137
|
+
They do not rank channel merit or decide campaign eligibility. Direct, indirect
|
|
138
|
+
and unknown denominators stay separate. Missing values remain unknown, not zero.
|
|
139
|
+
The project assignment/method interprets these observations.
|
|
140
|
+
|
|
141
|
+
## Budgets, samples and failures
|
|
142
|
+
|
|
143
|
+
Per-attempt defaults remain 12 actors, 10 official Meta calls, 30 searches,
|
|
144
|
+
12 SpyFu lookups, 40 page fetches and 25 CDX calls. Attempt exhaustion stops
|
|
145
|
+
and cached answers resume on rerun. `--max-total-paid-starts` additionally
|
|
146
|
+
bounds metered actor, Meta, web-search and SpyFu starts across attempts in a durable `budget.json`,
|
|
147
|
+
including failures and retries. Restarting does not raise the stored cap.
|
|
148
|
+
Legacy actor start journals are counted when the budget ledger is created.
|
|
149
|
+
Cumulative exhaustion preserves collected data and marks remaining checks
|
|
150
|
+
`budget_deferred`; no silent proxy or limitless rerun spending.
|
|
151
|
+
|
|
152
|
+
Sampling records request limits, raw rows before identity/relevance,
|
|
153
|
+
matched/unique ads and unknown completeness/pagination. At the cap show
|
|
154
|
+
`≥N` for the raw sample only; comparable/active subsets are found counts,
|
|
155
|
+
never total lower bounds. Duration is the maximum observed native duration
|
|
156
|
+
in this sample with its actual scope, not a campaign's full lifetime.
|
|
157
|
+
|
|
158
|
+
Core Google/Meta provider failures stop with their subject; supplementary
|
|
159
|
+
failures retain other observations and apply the existing source breaker.
|
|
160
|
+
Cached input rejections do not re-spend. An unreachable gateway stops rather
|
|
161
|
+
than claiming missing evidence. Free HTTP failures are not valid observations.
|
|
162
|
+
Coverage distinguishes no matches, not checked, not verifiable, unsupported
|
|
163
|
+
market, budget deferred and source unavailable; none means absent advertising.
|
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
# Communities Analysis
|
|
2
|
+
|
|
3
|
+
The founder-facing name of this section is "Communities analysis"; its stable
|
|
4
|
+
catalog ID remains `community_demand`.
|
|
5
|
+
|
|
6
|
+
Read `../contracts/research-artifacts.md`. This section uses NO OS Research
|
|
7
|
+
job and no free-form web research: the bundled deterministic runner searches
|
|
8
|
+
Hacker News (keyless Algolia API), fresh Reddit (a pinned Apify actor,
|
|
9
|
+
posts and comments from the last 12 months), and YouTube comments under
|
|
10
|
+
the top videos per query (OS `/tools/youtube`; best-effort — a provider
|
|
11
|
+
failure is recorded as an excluded source, never a dead section) for
|
|
12
|
+
public demand language — payment mentions, tool-seeking asks, pain
|
|
13
|
+
descriptions, price-sensitivity language — and renders the section body
|
|
14
|
+
plus a machine-readable evidence file itself. Do not write or edit section
|
|
15
|
+
prose, tables, or the evidence file by hand.
|
|
16
|
+
|
|
17
|
+
## 1. Inputs
|
|
18
|
+
|
|
19
|
+
Search queries come from two places, merged in this order:
|
|
20
|
+
|
|
21
|
+
- `--seed-keywords "phrase one, phrase two"` — up to 5 phrases selected for
|
|
22
|
+
the assignment, considering the category noun phrase
|
|
23
|
+
(e.g. `ai whiteboard`, `virtual staging`) AND the problem phrasing
|
|
24
|
+
without the category word (e.g. `brainstorm remotely with clients`) where useful —
|
|
25
|
+
community demand is often written in problem language that category
|
|
26
|
+
queries never match. Lowercase, no boolean operators, no brand names of
|
|
27
|
+
the founder's own product. Stay within the assigned question and market.
|
|
28
|
+
- `--product-context "ai, agent"` — explicitly supplied mechanism tokens relevant
|
|
29
|
+
to the comparison. Pass these when the distinction matters: quotes that
|
|
30
|
+
mention these tokens are flagged as speaking to this product's mechanics;
|
|
31
|
+
all other quotes are bare category demand that may belong to different
|
|
32
|
+
mechanics (a request for human-to-human realtime collaboration is not
|
|
33
|
+
evidence for an AI-agent product even when both say the category word).
|
|
34
|
+
- The top validated keywords discovered by a completed Keyword Economics
|
|
35
|
+
run (its receipt-validated evidence file) fill any remaining query slots
|
|
36
|
+
automatically — auction-validated category heads make good community
|
|
37
|
+
queries (near-duplicate keyword variants are folded by token-set
|
|
38
|
+
identity).
|
|
39
|
+
|
|
40
|
+
At most 5 queries per run (`--max-queries`); each costs one Reddit actor
|
|
41
|
+
run, two free HN calls, and up to three best-effort YouTube calls, and the
|
|
42
|
+
list is trimmed to fit `--max-actor-runs` (default 6).
|
|
43
|
+
|
|
44
|
+
## 2. Run the deterministic runner
|
|
45
|
+
|
|
46
|
+
From the workspace root, resolve `<skill-root>` to the extracted directory
|
|
47
|
+
containing this skill's `SKILL.md`, then run:
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
python3 <skill-root>/scripts/run-community-demand.py --workspace . \
|
|
51
|
+
--seed-keywords "<category phrase>, <problem phrase>" \
|
|
52
|
+
--product-context "<mechanism tokens>"
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
The runner needs `OS_API_KEY` (and optional `OS_URL`) in the environment.
|
|
56
|
+
Per query it searches HN stories and comments, Reddit posts and comments,
|
|
57
|
+
and YouTube comments, marker-matches every text against a fixed versioned
|
|
58
|
+
regex list (payment / seeking / pain / price-sensitivity language), and:
|
|
59
|
+
|
|
60
|
+
- writes quote and community rows to
|
|
61
|
+
`egbe-docs/research/market/evidence/community-demand.json`;
|
|
62
|
+
- materializes the exact section under `## Communities analysis` in
|
|
63
|
+
`egbe-docs/research/market/full-report.md`;
|
|
64
|
+
- verifies the report and evidence together; Git remains caller-owned;
|
|
65
|
+
- records the completed state receipt under
|
|
66
|
+
`egbe-docs/research/market/work/community_demand/`.
|
|
67
|
+
|
|
68
|
+
Every provider response is cached in the runtime directory, so re-running
|
|
69
|
+
the same command replays cached data instead of spending actor runs again.
|
|
70
|
+
|
|
71
|
+
## 3. Known limits and failure handling
|
|
72
|
+
|
|
73
|
+
Marker matching is a deterministic heuristic: it misses paraphrased demand
|
|
74
|
+
and admits some noise, and category counts measure marker density, not
|
|
75
|
+
verified intent. The runner deterministically excludes seller posts
|
|
76
|
+
(Show HN/Launch HN stories, self-promo Reddit posts), jobs-thread comments
|
|
77
|
+
and classified-style listings, and bot accounts; a marker counts only near
|
|
78
|
+
a non-generic query token (long off-topic rants that mention the category
|
|
79
|
+
once do not qualify), and money mentions count as payment language only
|
|
80
|
+
near a payment word ($100M scale-talk is not a price). Price-sensitivity
|
|
81
|
+
counts remain source observations, without an automatic evidence-strength score. Communities over-represent complainers and early
|
|
82
|
+
adopters; a community absent from the table is weak evidence, not proof of
|
|
83
|
+
no demand. Product Hunt (its API cannot keyword-search launches), Arctic
|
|
84
|
+
Shift (historical Reddit), and Stack Exchange are deliberately excluded
|
|
85
|
+
and recorded as excluded_source rows; YouTube degrades to an
|
|
86
|
+
excluded_source row when its provider is unavailable. The community table is ordered by name and retains raw counts, dates, votes and
|
|
87
|
+
sample links. Stored quotes use a recent-first bounded sample with per-community
|
|
88
|
+
caps; this is collection coverage, not a ranking of business opportunity.
|
|
89
|
+
Interpret these observations for the caller's question.
|
|
90
|
+
|
|
91
|
+
If the runner reports no queries, supply `--seed-keywords` from the assignment
|
|
92
|
+
and relevant evidence. If no suitable category or problem phrase is known,
|
|
93
|
+
record the section as could-not-complete with that reason
|
|
94
|
+
instead of inventing queries. For any other failure, preserve the runtime
|
|
95
|
+
state and stop; a later attempt resumes from cache. Do not substitute
|
|
96
|
+
Brave search, generic OS Research, direct provider access, or an
|
|
97
|
+
agent-written result, and do not edit `egbe-docs/research/market/full-report.md` or
|
|
98
|
+
the evidence file manually. Completion is validated deterministically from
|
|
99
|
+
the runtime receipt; this section has no LLM-based Research Completion
|
|
100
|
+
Review step.
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
# Competitive landscape
|
|
2
|
+
|
|
3
|
+
Read `../contracts/research-artifacts.md` and `../prompts/competitive-landscape.md`
|
|
4
|
+
for evidence checks and output mechanics. The current assignment, not the
|
|
5
|
+
bundled topic brief, defines the question and depth.
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
python <skill-root>/scripts/run-competitive-landscape.py --workspace . \
|
|
9
|
+
--assignment "The bounded question, scope and comparison criteria from the current task"
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
Use `--assignment-file` for existing task text when convenient; no new format
|
|
13
|
+
is required. The runner keeps provider-safe product context and includes only
|
|
14
|
+
valid completed supporting results/measurements. Missing optional inputs are
|
|
15
|
+
limitations, not reasons to collect unrequested sections. A selected unfinished
|
|
16
|
+
measurement used by this section must finish or be closed before it can be cited.
|
|
17
|
+
|
|
18
|
+
The actual assignment, query, system prompt, job state and result live under
|
|
19
|
+
`egbe-docs/research/<id>/work/competitive_landscape/`. The result materializes under
|
|
20
|
+
`## Competitive landscape` in the existing incremental report. Retrying unchanged inputs
|
|
21
|
+
resumes/reuses the job before publication; changed inputs preserve that work
|
|
22
|
+
and require a separate research ID, not a silent new provider call.
|
|
23
|
+
|
|
24
|
+
After success, complete the shared Research Completion Review for
|
|
25
|
+
`competitive_landscape`. Preserve failed/uncertain state; do not replace a provider response
|
|
26
|
+
with invented output. The caller owns Git publication and may continue the
|
|
27
|
+
surrounding task when this operation finishes.
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# Competitor Ads
|
|
2
|
+
|
|
3
|
+
Read `../contracts/research-artifacts.md`. This section uses NO OS Research
|
|
4
|
+
job and no free-form web research: the bundled deterministic runner collects
|
|
5
|
+
ad-transparency data (Google Ads Transparency and the Meta Ads Library) for
|
|
6
|
+
the market's competitors and renders the section body plus a machine-readable
|
|
7
|
+
evidence file itself. Do not write or edit section prose, tables, or the
|
|
8
|
+
evidence file by hand.
|
|
9
|
+
|
|
10
|
+
## 1. Inputs
|
|
11
|
+
|
|
12
|
+
Competitor domains come from completed sections automatically: first the
|
|
13
|
+
tiered Competitor Set (`egbe-docs/research/market/evidence/competitors.json`, in
|
|
14
|
+
stable inspection order), then the Keyword Economics evidence file
|
|
15
|
+
(`egbe-docs/research/market/evidence/keyword-economics.json`, the best
|
|
16
|
+
`competitor_domain` rows discovered on the demand surface). When neither
|
|
17
|
+
section has run (or they missed a competitor the founder named), pass
|
|
18
|
+
domains explicitly from the assignment — founder-named competitors first:
|
|
19
|
+
|
|
20
|
+
- `--domains "competitor.com, other.io"` — merged ahead of discovered ones;
|
|
21
|
+
a domain the Competitor Set recorded as excluded is never refilled from
|
|
22
|
+
Keyword Economics automatically; naming it here is the founder's override;
|
|
23
|
+
- at most 3 competitors are examined per run (`--max-competitors`; each one
|
|
24
|
+
costs two actor runs, and the list is trimmed to fit `--max-actor-runs`).
|
|
25
|
+
|
|
26
|
+
If the founder stated a launch geography inside the EU, pass the matching
|
|
27
|
+
`--eu-country` ISO code (default `DE`) so official Meta EU delivery data
|
|
28
|
+
matches the intended market.
|
|
29
|
+
|
|
30
|
+
## 2. Run the deterministic runner
|
|
31
|
+
|
|
32
|
+
From the workspace root, resolve `<skill-root>` to the extracted directory
|
|
33
|
+
containing this skill's `SKILL.md`, then run:
|
|
34
|
+
|
|
35
|
+
```bash
|
|
36
|
+
python3 <skill-root>/scripts/run-competitor-ads.py \
|
|
37
|
+
--workspace . \
|
|
38
|
+
--eu-country DE
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
The runner needs `OS_API_KEY` (and optional `OS_URL`) in the environment.
|
|
42
|
+
Per competitor it runs one Google Ads Transparency actor run and one Meta
|
|
43
|
+
Ads Library actor run through OS scrape (each actor run places a temporary
|
|
44
|
+
wallet hold), plus one official Meta Ad Library search (EU delivery data).
|
|
45
|
+
It preserves native ad duration, advertiser observation spans and price
|
|
46
|
+
mentions without interpreting them as profitable campaigns, and:
|
|
47
|
+
|
|
48
|
+
- writes evidence rows to `egbe-docs/research/market/evidence/competitor-ads.json`;
|
|
49
|
+
- materializes the exact section under `## Competitor ads` in
|
|
50
|
+
`egbe-docs/research/market/full-report.md`;
|
|
51
|
+
- verifies the report and evidence together; Git remains caller-owned;
|
|
52
|
+
- records the completed state receipt under
|
|
53
|
+
`egbe-docs/research/market/work/competitor_ads/`.
|
|
54
|
+
|
|
55
|
+
Every provider response is cached in the runtime directory, so re-running the
|
|
56
|
+
same command replays cached data instead of spending actor runs again.
|
|
57
|
+
|
|
58
|
+
## 3. Known limits and failure handling
|
|
59
|
+
|
|
60
|
+
Identity is destination-verified: Google ads are collected by the domain
|
|
61
|
+
their ads point to (advertiser legal names — e.g. ClickUp advertising as
|
|
62
|
+
"Mango Technologies, Inc." — are found automatically), and Meta ads count
|
|
63
|
+
only when their landing destination resolves to the target domain or the
|
|
64
|
+
page name is an exact brand match. Same-name lookalikes are excluded from
|
|
65
|
+
the scoped sample and listed separately — never hand-patch them back in.
|
|
66
|
+
A presence span may include gaps and creative rotation. An empty sample means
|
|
67
|
+
no matches in the reviewed scope, not absent advertising or absent demand.
|
|
68
|
+
|
|
69
|
+
If the runner reports no competitor domains: pass `--domains` with
|
|
70
|
+
competitors supplied for the assignment when they exist. When the workspace has
|
|
71
|
+
neither a completed Keyword Economics run nor any named competitor, this
|
|
72
|
+
section is not executable — record it as could-not-complete with that reason
|
|
73
|
+
instead of retrying or inventing a competitor. For any other failure,
|
|
74
|
+
preserve the runtime state and stop;
|
|
75
|
+
a later attempt resumes from cache. Do not substitute Brave search, generic
|
|
76
|
+
OS Research, direct provider access, or an agent-written result, and do not
|
|
77
|
+
edit `egbe-docs/research/market/full-report.md` or the evidence file manually.
|
|
78
|
+
Completion is validated deterministically from the runtime receipt; this
|
|
79
|
+
section has no LLM-based Research Completion Review step.
|
|
80
|
+
|
|
81
|
+
The exported observation contract/hash preserves identity and provenance; it
|
|
82
|
+
contains no duration-to-success threshold or country eligibility decision.
|