@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,272 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Build the canonical pre-PRD recommendation artifact from a small JSON input."""
|
|
3
|
+
|
|
4
|
+
from __future__ import annotations
|
|
5
|
+
|
|
6
|
+
import sys as _artifact_sys
|
|
7
|
+
from pathlib import Path as _ArtifactPath
|
|
8
|
+
_artifact_sys.path.insert(0, str(_ArtifactPath(__file__).resolve().parent))
|
|
9
|
+
from egbe_artifacts import artifact_path as _artifact_path
|
|
10
|
+
|
|
11
|
+
import argparse
|
|
12
|
+
import json
|
|
13
|
+
import os
|
|
14
|
+
import re
|
|
15
|
+
import tempfile
|
|
16
|
+
from pathlib import Path
|
|
17
|
+
from typing import Any
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
DEFAULT_OUTPUT = Path(_artifact_path("egbe-docs/research/market/pre-prd-recommendations.md"))
|
|
21
|
+
CATALOG_PATH = Path(__file__).resolve().parents[1] / "references" / "catalog.v1.json"
|
|
22
|
+
MAX_EXPLANATION_CHARS = 400
|
|
23
|
+
# The reason renders as one short line under an option in the chat widget.
|
|
24
|
+
MAX_REASON_CHARS = 180
|
|
25
|
+
_MARKDOWN_PATTERN = re.compile(
|
|
26
|
+
r"(?:^\s{0,3}(?:#{1,6}|>|[-+*]|\d+[.)])\s)|"
|
|
27
|
+
r"(?:!?\[[^\]]*\]\([^)]*\)|`|\*\*|__|~~)"
|
|
28
|
+
)
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
class _DuplicateJsonKeyError(ValueError):
|
|
32
|
+
pass
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
def _unique_json_object(pairs: list[tuple[str, Any]]) -> dict[str, Any]:
|
|
36
|
+
value: dict[str, Any] = {}
|
|
37
|
+
for key, item in pairs:
|
|
38
|
+
if key in value:
|
|
39
|
+
raise _DuplicateJsonKeyError(f"duplicate JSON key {key!r}")
|
|
40
|
+
value[key] = item
|
|
41
|
+
return value
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def _read_json_object(path: Path, *, label: str) -> dict[str, Any]:
|
|
45
|
+
try:
|
|
46
|
+
value = json.loads(
|
|
47
|
+
path.read_text(encoding="utf-8"),
|
|
48
|
+
object_pairs_hook=_unique_json_object,
|
|
49
|
+
)
|
|
50
|
+
except OSError as exc:
|
|
51
|
+
raise ValueError(f"cannot read {label} {path}: {exc}") from exc
|
|
52
|
+
except json.JSONDecodeError as exc:
|
|
53
|
+
raise ValueError(f"{label} must be valid JSON: {exc.msg}") from exc
|
|
54
|
+
except _DuplicateJsonKeyError as exc:
|
|
55
|
+
raise ValueError(f"{label} contains {exc}") from exc
|
|
56
|
+
if not isinstance(value, dict):
|
|
57
|
+
raise ValueError(f"{label} must be a JSON object")
|
|
58
|
+
return value
|
|
59
|
+
|
|
60
|
+
|
|
61
|
+
def _catalog_sections(catalog: dict[str, Any]) -> list[dict[str, Any]]:
|
|
62
|
+
"""Return the founder-selectable sections; internal sections are omitted.
|
|
63
|
+
|
|
64
|
+
Internal sections (``"internal": true``) stay in the catalog so a caller
|
|
65
|
+
can still invoke their workflow by ID, but they never appear in the
|
|
66
|
+
founder-facing recommendation artifact.
|
|
67
|
+
"""
|
|
68
|
+
if catalog.get("schema_version") != 1:
|
|
69
|
+
raise ValueError("catalog schema_version must be 1")
|
|
70
|
+
raw_sections = catalog.get("sections")
|
|
71
|
+
if not isinstance(raw_sections, list) or not raw_sections:
|
|
72
|
+
raise ValueError("catalog sections must be a non-empty list")
|
|
73
|
+
|
|
74
|
+
sections: list[dict[str, Any]] = []
|
|
75
|
+
seen: set[str] = set()
|
|
76
|
+
for raw in raw_sections:
|
|
77
|
+
if not isinstance(raw, dict):
|
|
78
|
+
raise ValueError("catalog sections must contain objects")
|
|
79
|
+
option_id = str(raw.get("id") or "").strip()
|
|
80
|
+
label = str(raw.get("label") or "").strip()
|
|
81
|
+
description = str(raw.get("description") or "").strip()
|
|
82
|
+
tag = str(raw.get("tag") or "").strip()
|
|
83
|
+
estimated_minutes = raw.get("estimated_minutes")
|
|
84
|
+
if not option_id or not label:
|
|
85
|
+
raise ValueError("catalog sections require non-empty id and label")
|
|
86
|
+
if option_id in seen:
|
|
87
|
+
raise ValueError(f"catalog contains duplicate section id {option_id!r}")
|
|
88
|
+
seen.add(option_id)
|
|
89
|
+
if raw.get("internal") is True:
|
|
90
|
+
continue
|
|
91
|
+
if not description or not tag:
|
|
92
|
+
raise ValueError(
|
|
93
|
+
f"catalog section {option_id!r} requires non-empty description and tag"
|
|
94
|
+
)
|
|
95
|
+
if (
|
|
96
|
+
not isinstance(estimated_minutes, int)
|
|
97
|
+
or isinstance(estimated_minutes, bool)
|
|
98
|
+
or estimated_minutes <= 0
|
|
99
|
+
):
|
|
100
|
+
raise ValueError(
|
|
101
|
+
f"catalog section {option_id!r} requires a positive integer estimated_minutes"
|
|
102
|
+
)
|
|
103
|
+
sections.append(
|
|
104
|
+
{
|
|
105
|
+
"id": option_id,
|
|
106
|
+
"label": label,
|
|
107
|
+
"description": description,
|
|
108
|
+
"tag": tag,
|
|
109
|
+
"estimated_minutes": estimated_minutes,
|
|
110
|
+
}
|
|
111
|
+
)
|
|
112
|
+
if not sections:
|
|
113
|
+
raise ValueError("catalog contains no founder-selectable sections")
|
|
114
|
+
return sections
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
def _recommendation_input(value: dict[str, Any]) -> tuple[dict[str, str], str]:
|
|
118
|
+
unknown_fields = set(value) - {"recommendations", "explanation"}
|
|
119
|
+
if unknown_fields:
|
|
120
|
+
raise ValueError(
|
|
121
|
+
"recommendation input contains unsupported fields: "
|
|
122
|
+
+ ", ".join(sorted(unknown_fields))
|
|
123
|
+
)
|
|
124
|
+
|
|
125
|
+
raw_recommendations = value.get("recommendations")
|
|
126
|
+
if not isinstance(raw_recommendations, dict):
|
|
127
|
+
raise ValueError("recommendations must be an object of option id to reason")
|
|
128
|
+
recommendations: dict[str, str] = {}
|
|
129
|
+
for raw_id, raw_reason in raw_recommendations.items():
|
|
130
|
+
option_id = str(raw_id).strip()
|
|
131
|
+
if not option_id or not isinstance(raw_reason, str) or not raw_reason.strip():
|
|
132
|
+
raise ValueError("every recommended option requires a non-empty string reason")
|
|
133
|
+
reason = raw_reason.strip()
|
|
134
|
+
if "\n" in reason or "\r" in reason:
|
|
135
|
+
raise ValueError(
|
|
136
|
+
f"reason for {option_id!r} must be a single line"
|
|
137
|
+
)
|
|
138
|
+
if len(reason) > MAX_REASON_CHARS:
|
|
139
|
+
raise ValueError(
|
|
140
|
+
f"reason for {option_id!r} must be one sentence of at most "
|
|
141
|
+
f"{MAX_REASON_CHARS} characters (got {len(reason)})"
|
|
142
|
+
)
|
|
143
|
+
if _MARKDOWN_PATTERN.search(reason):
|
|
144
|
+
raise ValueError(
|
|
145
|
+
f"reason for {option_id!r} must not contain Markdown formatting"
|
|
146
|
+
)
|
|
147
|
+
recommendations[option_id] = reason
|
|
148
|
+
|
|
149
|
+
explanation = value.get("explanation")
|
|
150
|
+
if not isinstance(explanation, str) or not explanation.strip():
|
|
151
|
+
raise ValueError("explanation must be a non-empty plain-text string")
|
|
152
|
+
explanation = explanation.strip()
|
|
153
|
+
if "\n" in explanation or "\r" in explanation:
|
|
154
|
+
raise ValueError("explanation must be one plain-text paragraph")
|
|
155
|
+
if len(explanation) > MAX_EXPLANATION_CHARS:
|
|
156
|
+
raise ValueError(
|
|
157
|
+
f"explanation must be at most {MAX_EXPLANATION_CHARS} characters"
|
|
158
|
+
)
|
|
159
|
+
if _MARKDOWN_PATTERN.search(explanation):
|
|
160
|
+
raise ValueError("explanation must not contain Markdown formatting")
|
|
161
|
+
return recommendations, explanation
|
|
162
|
+
|
|
163
|
+
|
|
164
|
+
def build_recommendation_document(
|
|
165
|
+
catalog: dict[str, Any],
|
|
166
|
+
recommendation_input: dict[str, Any],
|
|
167
|
+
) -> str:
|
|
168
|
+
"""Return the complete canonical artifact without performing I/O."""
|
|
169
|
+
|
|
170
|
+
sections = _catalog_sections(catalog)
|
|
171
|
+
recommendations, explanation = _recommendation_input(recommendation_input)
|
|
172
|
+
known_ids = {section["id"] for section in sections}
|
|
173
|
+
unknown_ids = sorted(set(recommendations) - known_ids)
|
|
174
|
+
if unknown_ids:
|
|
175
|
+
raise ValueError(
|
|
176
|
+
"recommendations contain unknown catalog option ids: "
|
|
177
|
+
+ ", ".join(unknown_ids)
|
|
178
|
+
)
|
|
179
|
+
|
|
180
|
+
options: list[dict[str, Any]] = []
|
|
181
|
+
for section in sections:
|
|
182
|
+
option_id = str(section["id"])
|
|
183
|
+
recommended = option_id in recommendations
|
|
184
|
+
item: dict[str, Any] = {
|
|
185
|
+
"id": option_id,
|
|
186
|
+
"label": section["label"],
|
|
187
|
+
"description": section["description"],
|
|
188
|
+
"tag": section["tag"],
|
|
189
|
+
"estimated_minutes": section["estimated_minutes"],
|
|
190
|
+
"recommended": recommended,
|
|
191
|
+
}
|
|
192
|
+
if recommended:
|
|
193
|
+
item["reason"] = recommendations[option_id]
|
|
194
|
+
options.append(item)
|
|
195
|
+
|
|
196
|
+
metadata = {
|
|
197
|
+
"schema_version": 1,
|
|
198
|
+
"explanation_format": "plain_text",
|
|
199
|
+
"options": options,
|
|
200
|
+
}
|
|
201
|
+
# JSON is a strict subset of YAML. Using the standard-library serializer
|
|
202
|
+
# prevents generated reasons, punctuation, or Unicode from breaking the
|
|
203
|
+
# YAML frontmatter consumed by the workflow runtime.
|
|
204
|
+
encoded = json.dumps(metadata, ensure_ascii=False, indent=2)
|
|
205
|
+
document = f"---\n{encoded}\n---\n\n{explanation}\n"
|
|
206
|
+
|
|
207
|
+
# Self-validate the exact bytes before the caller can replace an artifact.
|
|
208
|
+
frontmatter, body = document[4:].split("\n---\n", 1)
|
|
209
|
+
if json.loads(frontmatter) != metadata or body.strip() != explanation:
|
|
210
|
+
raise RuntimeError("generated recommendation artifact failed self-validation")
|
|
211
|
+
return document
|
|
212
|
+
|
|
213
|
+
|
|
214
|
+
def write_recommendation_document(
|
|
215
|
+
output: Path,
|
|
216
|
+
catalog: dict[str, Any],
|
|
217
|
+
recommendation_input: dict[str, Any],
|
|
218
|
+
) -> str:
|
|
219
|
+
"""Atomically replace ``output`` only after the document validates."""
|
|
220
|
+
|
|
221
|
+
document = build_recommendation_document(catalog, recommendation_input)
|
|
222
|
+
output.parent.mkdir(parents=True, exist_ok=True)
|
|
223
|
+
temporary_path: Path | None = None
|
|
224
|
+
try:
|
|
225
|
+
with tempfile.NamedTemporaryFile(
|
|
226
|
+
mode="w",
|
|
227
|
+
encoding="utf-8",
|
|
228
|
+
newline="\n",
|
|
229
|
+
dir=output.parent,
|
|
230
|
+
prefix=f".{output.name}.",
|
|
231
|
+
suffix=".tmp",
|
|
232
|
+
delete=False,
|
|
233
|
+
) as handle:
|
|
234
|
+
handle.write(document)
|
|
235
|
+
handle.flush()
|
|
236
|
+
os.fsync(handle.fileno())
|
|
237
|
+
temporary_path = Path(handle.name)
|
|
238
|
+
if temporary_path.read_text(encoding="utf-8") != document:
|
|
239
|
+
raise RuntimeError("recommendation artifact changed during atomic write")
|
|
240
|
+
os.chmod(temporary_path, 0o644)
|
|
241
|
+
os.replace(temporary_path, output)
|
|
242
|
+
temporary_path = None
|
|
243
|
+
finally:
|
|
244
|
+
if temporary_path is not None:
|
|
245
|
+
temporary_path.unlink(missing_ok=True)
|
|
246
|
+
return document
|
|
247
|
+
|
|
248
|
+
|
|
249
|
+
def _parser() -> argparse.ArgumentParser:
|
|
250
|
+
parser = argparse.ArgumentParser(description=__doc__)
|
|
251
|
+
parser.add_argument("--input", type=Path, required=True)
|
|
252
|
+
parser.add_argument("--output", type=Path, default=DEFAULT_OUTPUT)
|
|
253
|
+
parser.add_argument("--catalog", type=Path, default=CATALOG_PATH)
|
|
254
|
+
return parser
|
|
255
|
+
|
|
256
|
+
|
|
257
|
+
def main() -> int:
|
|
258
|
+
args = _parser().parse_args()
|
|
259
|
+
try:
|
|
260
|
+
catalog = _read_json_object(args.catalog, label="catalog")
|
|
261
|
+
recommendation_input = _read_json_object(
|
|
262
|
+
args.input,
|
|
263
|
+
label="recommendation input",
|
|
264
|
+
)
|
|
265
|
+
write_recommendation_document(args.output, catalog, recommendation_input)
|
|
266
|
+
except (OSError, RuntimeError, ValueError) as exc:
|
|
267
|
+
raise SystemExit(str(exc)) from exc
|
|
268
|
+
return 0
|
|
269
|
+
|
|
270
|
+
|
|
271
|
+
if __name__ == "__main__":
|
|
272
|
+
raise SystemExit(main())
|
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: egbe-os-product-report
|
|
3
|
+
description: Package Business Loop results or requested status reviews as concise updates, Markdown and offline HTML.
|
|
4
|
+
metadata:
|
|
5
|
+
egbe-when: "Offer when decisions need a business overview; use for on-demand and scheduled reports."
|
|
6
|
+
egbe-visible: "true"
|
|
7
|
+
egbe-title: "Your product at a glance"
|
|
8
|
+
egbe-description: "See how your product, spending and customer acquisition are doing, what needs attention and what your agent can help improve."
|
|
9
|
+
egbe-category: "Business operations"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
<!-- egbe-mcp-connection:v1 -->
|
|
13
|
+
This skill comes with the Egbe plugin. If this project has its own installed copy
|
|
14
|
+
of the skill, use that copy instead. Otherwise make every Egbe API call it
|
|
15
|
+
describes with the Egbe connector: `egbe_read` for GET and `egbe_write` for POST,
|
|
16
|
+
PUT, PATCH and DELETE (with `method`). Pass the API path (for example
|
|
17
|
+
`/me/limits`), query parameters in `query` and the JSON body in `body`. Leave out `OS_URL`, the Authorization header, `.env.local`,
|
|
18
|
+
`egbe-curl.py` and catalog update checks; the connection authenticates and
|
|
19
|
+
identifies the request. Also pass the `business` that `egbe_setup` returned.
|
|
20
|
+
Where this skill sends an `Idempotency-Key` header, pass the same value as
|
|
21
|
+
`idempotency_key` and reuse it when retrying. A result with a `continuation`
|
|
22
|
+
holds one part of a long body; read the next part with `egbe_read`, the same
|
|
23
|
+
`path` and `business`, and that `continuation`.
|
|
24
|
+
Read bundled files beside this `SKILL.md`. For published skill resources on
|
|
25
|
+
Egbe OS, use `egbe_skill`. Follow "Files downloaded on demand" for listed downloads.
|
|
26
|
+
|
|
27
|
+
Publishing works through the connector: commit the app's files with the JSON
|
|
28
|
+
commit requests in `egbe-os-git` ("Without a terminal") and deploy the returned
|
|
29
|
+
commit SHA; no git push or workspace setup is needed. A step that needs a local
|
|
30
|
+
project key or a bundled script, such as a local `npx convex deploy`, needs a
|
|
31
|
+
set-up project workspace. In a persistent
|
|
32
|
+
project workspace that is not set up yet, set it up as the `egbe-setup` skill's
|
|
33
|
+
project setup describes.
|
|
34
|
+
Without such a workspace, or if it refuses, tell the founder that this step needs
|
|
35
|
+
an agent with a set-up project folder, and continue with the rest of the work.
|
|
36
|
+
|
|
37
|
+
If the connector's tools (`egbe_read` and the other `egbe_*` tools) are not
|
|
38
|
+
available, the plugin's connector is not signed in for this agent. Tell
|
|
39
|
+
the founder how to connect it, as the `egbe-setup` skill describes, rather than
|
|
40
|
+
saying Egbe is unavailable.
|
|
41
|
+
|
|
42
|
+
The connector's tools work even where this environment's shell cannot reach
|
|
43
|
+
Egbe: their calls travel through this agent's connection, not through the
|
|
44
|
+
shell's network. A step that runs in the shell, such as a bundled script, a `git
|
|
45
|
+
push` to Egbe's Git endpoint or a deploy upload, needs the shell to reach the
|
|
46
|
+
Egbe host (`os.hz.egbe.dev`). If a proxy or allowlist refuses that request
|
|
47
|
+
before Egbe answers, for example HTTP 403 on CONNECT or curl status `000`, tell
|
|
48
|
+
the founder: they allow that host in this agent's network settings or continue
|
|
49
|
+
with an agent on their own computer. Code can also be published without the
|
|
50
|
+
shell by committing through the connector (`egbe-os-git`, "Without a terminal").
|
|
51
|
+
Until the shell step or that commit and its deploy succeed, do not report the
|
|
52
|
+
work as published: a preview in this agent or on this computer is not an Egbe
|
|
53
|
+
deployment.
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
# Product report
|
|
57
|
+
|
|
58
|
+
Help the founder understand what is happening, what matters and what to do next.
|
|
59
|
+
Reporting is read-only with respect to the product and external services; it does
|
|
60
|
+
not authorize fixes, campaign changes, spending or outreach. Use `egbe-os-product-routines`
|
|
61
|
+
to configure or change a schedule, not as a prerequisite for a manual report.
|
|
62
|
+
|
|
63
|
+
## Establish the context
|
|
64
|
+
|
|
65
|
+
Identify the business from the project's configured Egbe connection and existing
|
|
66
|
+
product records. Reuse local credentials without copying them into artifacts.
|
|
67
|
+
Select `brief` for a status request or agreed short update; select `detailed` for
|
|
68
|
+
the Business Loop result or an explicit request for a full report.
|
|
69
|
+
|
|
70
|
+
Use the requested period and project/user timezone. A status request concerns
|
|
71
|
+
the current state, with today's results where applicable. A Business Loop reports
|
|
72
|
+
its current checkpoint and each measure's actual window; an existing standalone
|
|
73
|
+
daily report retains its agreed previous-calendar-day period. Choosing detailed output does not
|
|
74
|
+
turn a current-state request into a historical review. Keep current balances
|
|
75
|
+
and availability separate from period totals. If the timezone is unknown,
|
|
76
|
+
disclose the harness timezone used.
|
|
77
|
+
|
|
78
|
+
Read [artifact storage](references/artifacts.md), the latest relevant snapshot
|
|
79
|
+
and summary, and the previous detailed report when useful. Use known goals,
|
|
80
|
+
open issues, agreed experiments and founder decisions to interpret the state;
|
|
81
|
+
include them in the report only when relevant to its conclusion or next step.
|
|
82
|
+
When a recommendation depends on an earlier decision, read the relevant plan,
|
|
83
|
+
audit or decision record and distinguish its findings from current evidence.
|
|
84
|
+
When the Business Loop supplies its result, reuse its conclusions, evidence and
|
|
85
|
+
current plan. Check coverage and presentation without starting a second business
|
|
86
|
+
review or inventing another next step. A contradiction or missing material fact
|
|
87
|
+
returns to the caller for resolution; retain useful partial results meanwhile.
|
|
88
|
+
For a standalone report needing product interpretation, read the project's `egbe-docs/playbooks/product.md`
|
|
89
|
+
and `product/evaluate.md`; use `product/diagnose.md` only when a consequential
|
|
90
|
+
question needs it. For market/acquisition interpretation use
|
|
91
|
+
`egbe-docs/playbooks/market-and-acquisition.md`, its `evaluate.md` and the relevant
|
|
92
|
+
channel supplement, together with the concrete plan. Apply local
|
|
93
|
+
adaptations, including how recommendations and decisions are handled. The report
|
|
94
|
+
may reason from fresh observations and recommend a next step without an existing
|
|
95
|
+
results file; it does not change the product, campaign, accepted plan or standing method.
|
|
96
|
+
If these files are inaccessible, disclose that gap and limit dependent judgments
|
|
97
|
+
instead of replacing them with a bundled business strategy.
|
|
98
|
+
Do not reread all history or imply that an unread audit supports the report.
|
|
99
|
+
Establish the product's stage from its records and owned deployed apps, not the
|
|
100
|
+
contents of the local folder: a new connection can belong to an existing product.
|
|
101
|
+
|
|
102
|
+
## Gather supporting evidence
|
|
103
|
+
|
|
104
|
+
Follow [sources and measurement](references/sources.md). Reuse recent evidence
|
|
105
|
+
only when its scope and time fit this report; fetch what is missing or changed.
|
|
106
|
+
Supplied Business Loop evidence is reusable under the same checks, without
|
|
107
|
+
repeating its collection.
|
|
108
|
+
Save the supporting facts and coverage in `snapshot.json`.
|
|
109
|
+
|
|
110
|
+
Read only the selected reporting guide:
|
|
111
|
+
|
|
112
|
+
- [Brief update](references/brief.md): a compact status and one useful next step.
|
|
113
|
+
- [Detailed result](references/daily.md): a complete `report.md` with the relevant
|
|
114
|
+
findings, work status, decisions and their basis; no fixed business sections.
|
|
115
|
+
|
|
116
|
+
Keep the work proportional to the decision. A routine report is not a mandatory
|
|
117
|
+
full funnel audit, repository review or market study. When a finding needs deeper
|
|
118
|
+
investigation, identify the uncertainty and propose a focused next task.
|
|
119
|
+
|
|
120
|
+
## Prepare, verify and deliver
|
|
121
|
+
|
|
122
|
+
Write as the founder's partner: use first person for your recommendations and
|
|
123
|
+
offers of help. Explain technical findings by their effect on the product or
|
|
124
|
+
customer journey; keep implementation terms and diagnostic details in the
|
|
125
|
+
supporting evidence unless the founder needs them to decide.
|
|
126
|
+
Name pages and steps by their customer purpose, not internal routes; report
|
|
127
|
+
whether customers can reach them, not HTTP codes or serving revisions.
|
|
128
|
+
|
|
129
|
+
For a detailed run, finish `report.md` first. Derive `summary.md` and use `egbe-os-report-ui`
|
|
130
|
+
to create `report.html` from that report. Visual composition may differ; facts,
|
|
131
|
+
recommendations and material limitations must not. Correct content in Markdown
|
|
132
|
+
first, then update both derived outputs. For a brief run, `summary.md` is the
|
|
133
|
+
complete authored result; no full report or HTML is required.
|
|
134
|
+
|
|
135
|
+
Check arithmetic, links and agreement between formats. For each headline and
|
|
136
|
+
zero/absence claim, verify that the source's ownership, definition, period and
|
|
137
|
+
coverage support the whole claim; narrow it when they do not.
|
|
138
|
+
A failed source can still yield a useful partial report; disclose what
|
|
139
|
+
could not be checked. If HTML rendering fails, deliver the verified Markdown
|
|
140
|
+
and summary, explicitly leaving HTML unfinished.
|
|
141
|
+
|
|
142
|
+
For scheduled output, honor the caller's notification decision: prepare without
|
|
143
|
+
sending when notification is not required. Otherwise send the summary in the
|
|
144
|
+
founder's language with light formatting and links to the actual local
|
|
145
|
+
artifacts. A local path is not a public URL: when the recipient cannot open the
|
|
146
|
+
file, attach it through Egbe mail (`attachments` on `POST /mail/send`, see
|
|
147
|
+
`egbe-os-mail`) or put what they need in the message itself, and say where the
|
|
148
|
+
full report is kept, without publishing it elsewhere by default. Record the result under the artifact contract. For a
|
|
149
|
+
scheduled run, return the artifact path and coverage/delivery outcome to
|
|
150
|
+
`egbe-os-product-routines`; a manual report does not create or advance its schedule.
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
# Report artifacts
|
|
2
|
+
|
|
3
|
+
## Location and ownership
|
|
4
|
+
|
|
5
|
+
Store reports in the current product's local workspace:
|
|
6
|
+
`egbe-docs/reports/<UTC timestamp>-<mode>/`, for example
|
|
7
|
+
`2026-10-20T090000Z-detailed/`. For several Egbe businesses in one workspace,
|
|
8
|
+
prefix the report ID with the verified business ID. Do not mix their history.
|
|
9
|
+
Use `brief` or `detailed`; append a unique suffix if a separate run collides.
|
|
10
|
+
|
|
11
|
+
Use the existing product repository when present; reporting does not require
|
|
12
|
+
creating a repository, committing, pushing or publishing. Do not use the
|
|
13
|
+
installed skill folder as artifact storage. Keep reports out of public/static
|
|
14
|
+
app directories and exclude all `egbe-docs/` from the build context.
|
|
15
|
+
|
|
16
|
+
Through the Egbe connector without a project folder, keep the same files at the
|
|
17
|
+
same paths in Egbe's artifact store, as `egbe-os-quickstart` →
|
|
18
|
+
`references/artifact-sync.md` ("Through the Egbe connector") describes, and
|
|
19
|
+
render `report.html` there only if `egbe-os-report-ui` can run; otherwise leave
|
|
20
|
+
HTML unfinished as the skill describes.
|
|
21
|
+
|
|
22
|
+
## Files
|
|
23
|
+
|
|
24
|
+
| File | Brief | Detailed | Purpose |
|
|
25
|
+
|---|---|---|---|
|
|
26
|
+
| `snapshot.json` | Yes | Yes | Facts, provenance, windows and coverage |
|
|
27
|
+
| `summary.md` | Yes | Yes | The message delivered to the founder |
|
|
28
|
+
| `report.md` | No | Yes | Canonical complete findings and proposals |
|
|
29
|
+
| `report.html` | No | Yes | Offline presentation derived from report.md |
|
|
30
|
+
|
|
31
|
+
Markdown owns the interpretation, not `snapshot.json`. For detailed reports,
|
|
32
|
+
change content in `report.md` first and refresh both derived outputs. Do not
|
|
33
|
+
silently overwrite a different completed run.
|
|
34
|
+
|
|
35
|
+
## Minimal snapshot contract
|
|
36
|
+
|
|
37
|
+
Keep these fields stable; the observations themselves depend on the product:
|
|
38
|
+
|
|
39
|
+
- `project_id`, `run_id`, `mode`, `trigger` (`manual` or `scheduled`).
|
|
40
|
+
- `generated_at`: timestamp with offset; `timezone`: the reporting IANA timezone.
|
|
41
|
+
- `period`: `from` and `to` timestamps, start inclusive and end exclusive.
|
|
42
|
+
- `sources`: entries with a stable `id`, capability/reference, scope,
|
|
43
|
+
`checked_at`, status (`ok`, `partial`, `unavailable`, `not_applicable`) and a
|
|
44
|
+
concise reason when coverage is limited. Record actual data freshness if known.
|
|
45
|
+
- `observations`: entries with an `id`, name/definition, value, unit where
|
|
46
|
+
applicable and `source_ids`. Record `as_of` for point-in-time states or a
|
|
47
|
+
`period` for windowed values; aggregate granularity must be explicit.
|
|
48
|
+
- `result`: `status` (`in_progress`, `complete`, `incomplete`), overall
|
|
49
|
+
`coverage` (`complete`, `partial`, `unavailable`), produced file paths and any
|
|
50
|
+
unfinished output/check. A complete report can have partial source coverage.
|
|
51
|
+
|
|
52
|
+
Assess coverage against the applicable questions, metrics and period of this
|
|
53
|
+
report, not every feature a provider could supply. Mark a missing breakdown
|
|
54
|
+
as a limitation of that analysis, not of otherwise complete totals.
|
|
55
|
+
`not_applicable` sources alone do not make overall coverage partial: a new
|
|
56
|
+
project can have a complete status report without a deployed product or sales.
|
|
57
|
+
|
|
58
|
+
Use `null` for an unavailable value with the reason in its source record, not
|
|
59
|
+
an invented zero. Keep only aggregates and sanitized evidence used by the
|
|
60
|
+
report, not whole API payloads, credentials, customer identities or raw logs.
|
|
61
|
+
The report can cite observation/source IDs and source links or query descriptions;
|
|
62
|
+
do not embed authenticated URLs.
|
|
63
|
+
|
|
64
|
+
## Continuation and delivery
|
|
65
|
+
|
|
66
|
+
Start with the latest applicable summary/snapshot. Read the prior detailed
|
|
67
|
+
report and older evidence only when they explain an open question or decision.
|
|
68
|
+
Compare only matching scopes, definitions and windows. Keep recommendations
|
|
69
|
+
already accepted, rejected or underway visible in the authored result.
|
|
70
|
+
|
|
71
|
+
On interruption, leave the run incomplete and resume its missing work rather
|
|
72
|
+
than treating partial files as a finished report. Set `result.status` after
|
|
73
|
+
verification, independently of data coverage. If rendering failed, retain the
|
|
74
|
+
valid Markdown and record the missing HTML; the summary can still be delivered.
|
|
75
|
+
Required checks that could not run, including visual HTML verification, also
|
|
76
|
+
leave the result `incomplete` with those checks listed; they do not invalidate
|
|
77
|
+
verified facts or prevent delivery with an explicit limitation.
|
|
78
|
+
Keep the detailed validation ledger here, not in the report narrative. In the
|
|
79
|
+
founder handoff, name only the practical limitation and available alternative.
|
|
80
|
+
|
|
81
|
+
The scheduling owner is `egbe-os-product-routines`. It stores settings and delivery
|
|
82
|
+
checkpoints separately in the versioned `egbe-docs/routines.json`, and advances
|
|
83
|
+
them only after the relevant action is confirmed. Saving a report does not prove
|
|
84
|
+
that a notification was delivered. A manual run does not consume scheduled slots.
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# Brief founder update
|
|
2
|
+
|
|
3
|
+
Give the founder a useful picture in one short, scannable message. Cover the
|
|
4
|
+
areas below when applicable, combining them rather than making a long checklist:
|
|
5
|
+
|
|
6
|
+
- Available Egbe funds and any material spending or funding constraint.
|
|
7
|
+
- Product availability and confirmed consequential failures.
|
|
8
|
+
- Connected advertising: what is running, blocked or stopped; spend and
|
|
9
|
+
remaining agreed budget where known.
|
|
10
|
+
- Today's visitors, registrations, meaningful activation and purchases/revenue,
|
|
11
|
+
distinguishing unavailable measurements from zero.
|
|
12
|
+
- Important changes since the previous comparable report.
|
|
13
|
+
|
|
14
|
+
Put an urgent problem first. Separate status, results and the next step with
|
|
15
|
+
short headings or bold labels; use bullets for distinct items, not a wall of
|
|
16
|
+
paragraphs. Explain status in founder language rather than API codes, skill
|
|
17
|
+
names or internal IDs. Name the outcome Egbe enables, not the instruction file.
|
|
18
|
+
Name the reporting period and surface coverage gaps that affect a decision.
|
|
19
|
+
For an empty project, state what is actually available and the product's current
|
|
20
|
+
stage; do not fabricate a funnel or suggest repairing nonexistent instrumentation.
|
|
21
|
+
Combine areas with the same status. Prefer a precise label and scope to a
|
|
22
|
+
paragraph of qualifications; keep collection details in the snapshot.
|
|
23
|
+
Give each bullet one main message. Omit explanations of distinctions already
|
|
24
|
+
clear from the label, and empty integrations that do not affect today's decision.
|
|
25
|
+
|
|
26
|
+
End with the next step justified by the current project method and plan: the
|
|
27
|
+
problem or opportunity, proposed improvement, purpose and what I can do with Egbe.
|
|
28
|
+
Keep an agreed continuation as the next step when that is the conclusion; do not
|
|
29
|
+
invent novelty to fill the format. Preserve uncertainty and any decision needed.
|
|
30
|
+
|
|
31
|
+
A scheduled digest is still delivered when nothing changed, proportionately
|
|
32
|
+
short; an alerts-only routine follows its agreed notification condition instead.
|
|
33
|
+
Preserve any delivered message as `summary.md`.
|
|
34
|
+
Do not create `report.md` and HTML just to expand a brief update.
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# Detailed product result
|
|
2
|
+
|
|
3
|
+
Package the Business Loop's supplied result, or prepare a requested standalone
|
|
4
|
+
review using the method and plan loaded by the entrypoint. Do not recompute the
|
|
5
|
+
loop's priorities as an independent reporting task. Product, advertising and analytics are possible topics,
|
|
6
|
+
not mandatory output sections. Apply the method to current evidence and explain
|
|
7
|
+
the supported conclusions; reporting does not authorize changes or require a
|
|
8
|
+
full audit. Keep existing decisions, observed state and proposed work distinct.
|
|
9
|
+
|
|
10
|
+
## Write the canonical report
|
|
11
|
+
|
|
12
|
+
Select the useful conclusions before writing `report.md`: what is happening,
|
|
13
|
+
why it matters and what decision or next step follows. For a loop result, make
|
|
14
|
+
the current focus, meaningful changes, progress and any founder decision clear;
|
|
15
|
+
link to the existing work record instead of maintaining another task list.
|
|
16
|
+
Include the facts and
|
|
17
|
+
reasoning needed to support those conclusions. Add depth for genuine tradeoffs
|
|
18
|
+
or contested interpretations, not merely because the requested format is full.
|
|
19
|
+
|
|
20
|
+
Use direct, scoped statements. A precise label or time basis is often enough
|
|
21
|
+
to avoid an overclaim; it does not need a paragraph listing everything the
|
|
22
|
+
number is not. Explain a material limitation once beside the affected claim.
|
|
23
|
+
Other possible interpretations or things that were not checked belong in
|
|
24
|
+
evidence unless they change the decision. Group areas sharing one status.
|
|
25
|
+
Do not teach the reader how every source works or argue against mistakes the
|
|
26
|
+
report never makes. For each area, keep the useful result, its consequence and
|
|
27
|
+
any needed action; put reconciliation detail and secondary measurements in the
|
|
28
|
+
snapshot. A precise metric label can replace a repeated “this does not mean…”
|
|
29
|
+
explanation.
|
|
30
|
+
|
|
31
|
+
Keep source IDs, query details, arithmetic checks and execution/validation
|
|
32
|
+
logs in `snapshot.json`. The Markdown should be useful on its own, with links
|
|
33
|
+
to that evidence, not a narration of the reporting process.
|
|
34
|
+
|
|
35
|
+
Edit the report before deriving other formats. Every block must answer a
|
|
36
|
+
founder question or justify a consequential conclusion. Remove a passage if
|
|
37
|
+
it adds neither a fact needed to understand the situation nor a reason to
|
|
38
|
+
choose an action. Merge repeated qualifications; omit inapplicable metrics and
|
|
39
|
+
sections instead of filling them with explanations of their absence.
|
|
40
|
+
Detailed means adequately explained, not necessarily longer than the brief.
|
|
41
|
+
When little has started or changed, the canonical report may be close to the
|
|
42
|
+
summary in length; do not expand an uneventful status into a catalogue of
|
|
43
|
+
possible concerns.
|
|
44
|
+
|
|
45
|
+
Make the next step actionable: name the concrete result you can produce,
|
|
46
|
+
the founder's necessary input or decision, and how the result determines what
|
|
47
|
+
happens next. Separate work that can start now from work waiting on that input.
|
|
48
|
+
Offer a simple way to continue in chat; distinguish preparation from authorized
|
|
49
|
+
execution. A copyable instruction can help, but does not itself start the work.
|
|
50
|
+
|
|
51
|
+
## Derive the founder-facing outputs
|
|
52
|
+
|
|
53
|
+
Create `summary.md` from the completed report. Use short titled blocks and
|
|
54
|
+
bullets for distinct facts and proposals, with selective emphasis, so the
|
|
55
|
+
founder can understand the outcome and important decisions in about a minute.
|
|
56
|
+
Length follows useful content, not a word quota. Retain limitations that change
|
|
57
|
+
a decision, preserve the reason behind the main recommendation, and link to
|
|
58
|
+
the relevant sections, not only beside recommendations.
|
|
59
|
+
Explain necessary metric terms in plain language.
|
|
60
|
+
Use a separate bullet for each distinct result or action rather than stacking
|
|
61
|
+
long paragraphs under bold opening sentences. Keep test and rendering logs out
|
|
62
|
+
of this message; mention an output limitation once, briefly, if it affects use.
|
|
63
|
+
|
|
64
|
+
Use `egbe-os-report-ui` for the visual edition of the report. Supply the content's
|
|
65
|
+
relative importance: what the founder should understand at a glance and what
|
|
66
|
+
supports closer reading. Let presentation express those relationships rather
|
|
67
|
+
than map every Markdown heading or paragraph to a screen block.
|
|
68
|
+
|
|
69
|
+
Verify semantic agreement, not identical wording: findings, values, priorities,
|
|
70
|
+
evidence and material limitations must remain accessible. Add working anchors
|
|
71
|
+
for summary links. If HTML is unavailable, link to Markdown and say so.
|
|
72
|
+
|
|
73
|
+
Read the result as the founder: is it clear what to improve first and why,
|
|
74
|
+
what remains a hypothesis, what you will deliver next, and how to ask for it?
|
|
75
|
+
Revise vague investigations or task menus that leave those decisions to the
|
|
76
|
+
reader; do not invent a diagnosis to make the answer sound decisive.
|