@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,133 @@
|
|
|
1
|
+
# Analysis and output contract
|
|
2
|
+
|
|
3
|
+
## Normalized source evidence
|
|
4
|
+
|
|
5
|
+
`normalize-videos.py` writes `normalized/videos.json` with schema version 1,
|
|
6
|
+
`analysis_contract_version: "evidence-v5"`, generation time, source manifest hash,
|
|
7
|
+
selection gaps and stable observation IDs. Observations retain canonical URLs,
|
|
8
|
+
account context, publication time, caption, nullable provider metrics, comments,
|
|
9
|
+
sound metadata and media availability. Descriptive comparisons are not causal
|
|
10
|
+
attribution or an eligibility score.
|
|
11
|
+
|
|
12
|
+
`collection_window` records the frozen reference time and lower date;
|
|
13
|
+
`time_window_counts` separates `in_window`, `outside_window` and `unknown_date`.
|
|
14
|
+
Each observation has `time_window_status`. Out-of-window and unknown-date rows
|
|
15
|
+
remain inspectable but do not affect account medians or enter selection and
|
|
16
|
+
enrichment. Unknown dates are not represented as proven dates outside the window.
|
|
17
|
+
|
|
18
|
+
The requested sample is frozen in hash-bound `normalized/selection.json` before
|
|
19
|
+
enrichment. Its account-balanced resource cap is not a best-performing ranking
|
|
20
|
+
and has no minimum number per account. Enrichment may add evidence but cannot
|
|
21
|
+
silently replace selected IDs. Preserve normalized selection gaps in the analysis.
|
|
22
|
+
|
|
23
|
+
Media paths are runtime-relative and confined to that directory. Local video
|
|
24
|
+
and frames have exact `artifact_sha256` entries and `visual_preparation` proof
|
|
25
|
+
from `prepare-visual-evidence.py`. A provider `media_url` is distinct from its
|
|
26
|
+
`cover_url`; a cover cannot establish the video's opening. Validation checks
|
|
27
|
+
file hashes and provider-media provenance, not just path existence.
|
|
28
|
+
|
|
29
|
+
Every comment has a stable `comment_id`, derived from its provider ID or exact
|
|
30
|
+
text hash. Do not hand-edit normalized data or invent identities.
|
|
31
|
+
|
|
32
|
+
## Analysis evidence-v5
|
|
33
|
+
|
|
34
|
+
Write `analysis.json` using the actual normalized file hash:
|
|
35
|
+
|
|
36
|
+
```json
|
|
37
|
+
{
|
|
38
|
+
"schema_version": 1,
|
|
39
|
+
"analysis_contract_version": "evidence-v5",
|
|
40
|
+
"source_normalized_sha256": "<sha256>",
|
|
41
|
+
"generated_at": "2026-11-03T12:15:00Z",
|
|
42
|
+
"summary": "Answer to the scoped question, with the main limitation",
|
|
43
|
+
"videos": [
|
|
44
|
+
{
|
|
45
|
+
"observation_id": "tiktok:123",
|
|
46
|
+
"url": "https://www.tiktok.com/@example/video/123",
|
|
47
|
+
"message": {
|
|
48
|
+
"status": "observed",
|
|
49
|
+
"modality": "caption",
|
|
50
|
+
"text": "The caption presents a product workflow",
|
|
51
|
+
"evidence_refs": ["caption"]
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
],
|
|
55
|
+
"synthesis": {
|
|
56
|
+
"findings": [
|
|
57
|
+
{
|
|
58
|
+
"text": "A source-grounded finding, not an inferred performance cause",
|
|
59
|
+
"supporting_evidence_refs": ["tiktok:123#message"]
|
|
60
|
+
}
|
|
61
|
+
],
|
|
62
|
+
"adaptations": [
|
|
63
|
+
{
|
|
64
|
+
"name": "An adaptation for this product",
|
|
65
|
+
"text": "The proposed treatment, separate from the source observation",
|
|
66
|
+
"reason": "Why the observed mechanism fits the question and available assets",
|
|
67
|
+
"source_observation_ids": ["tiktok:123"]
|
|
68
|
+
}
|
|
69
|
+
]
|
|
70
|
+
},
|
|
71
|
+
"evidence_gaps": ["Media was unavailable; no visual-opening claim is made"]
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
`summary`, `videos`, `synthesis` and `evidence_gaps` are required. Findings and
|
|
76
|
+
adaptations may be empty. Include the selected observations actually analyzed;
|
|
77
|
+
omitted selected observations make coverage partial. Unknown or duplicate IDs
|
|
78
|
+
and mismatched URLs/hashes are errors, not evidence gaps.
|
|
79
|
+
|
|
80
|
+
### Optional analytical fields
|
|
81
|
+
|
|
82
|
+
Use only fields relevant to the question and supported by evidence:
|
|
83
|
+
|
|
84
|
+
| Field | Shape and evidence |
|
|
85
|
+
| --- | --- |
|
|
86
|
+
| `thumb_stop` | `status`, `text`, `evidence_refs`; observed opening requires inspected frames. |
|
|
87
|
+
| `hook` | Same plus `modality: visual|verbal|mixed`; frames for visual, transcript for verbal, both for mixed. |
|
|
88
|
+
| `format`, `message`, `cta` | Same with `modality: visual|verbal|mixed|caption`; describe only what that modality establishes. A caption may describe a format but cannot prove unseen execution. |
|
|
89
|
+
| `proof_reference` | `status`, `claim`, `mechanism`, `evidence_refs`; preserve a source's attributed claim rather than endorsing it. |
|
|
90
|
+
| `sound` | Source `id`, `name`, `author` when present; no age-derived lifecycle label. |
|
|
91
|
+
| `comment_analysis` | Entries with actual `comment_id`, `relevance: relevant|uncertain|irrelevant`, `reason`; nonempty `insight` only for relevant comments. |
|
|
92
|
+
|
|
93
|
+
An unavailable axis has `status: unavailable`, empty text (or claim/mechanism),
|
|
94
|
+
and no refs. Alternatively omit an unused axis. There is no seven-axis quota,
|
|
95
|
+
required comment count, creative count or impact score.
|
|
96
|
+
|
|
97
|
+
When a canonical per-video media receipt exists, attach its
|
|
98
|
+
`multimodal_receipt_sha256` even when using only its source caption. Frame refs
|
|
99
|
+
must appear in it; `transcript` must be available
|
|
100
|
+
and hash-bound. The validator checks the current frames/transcript and rejects
|
|
101
|
+
forged or stale proof. Caption-only analysis does not need a media receipt.
|
|
102
|
+
Preserve the receipt's exact analysis gaps in `evidence_gaps`. The literal
|
|
103
|
+
`caption` reference is valid for a source caption, not speech or visual content.
|
|
104
|
+
A source proof remains independently unverified unless separate
|
|
105
|
+
evidence establishes it.
|
|
106
|
+
|
|
107
|
+
Findings cite `<observation_id>#<axis>` for an observed axis, or the source's
|
|
108
|
+
`metrics`, `caption`, `sound`, or `comment:<comment_id>` evidence. References
|
|
109
|
+
must exist; a convenient reference does not by itself justify a conclusion.
|
|
110
|
+
Adaptations cite real analyzed source IDs and explain the relevance in `reason`.
|
|
111
|
+
Source links and quoted audience comments are resolved from canonical IDs.
|
|
112
|
+
|
|
113
|
+
## Generated outputs and coverage
|
|
114
|
+
|
|
115
|
+
`render-result.py` produces a readable section body in `result.md`, including
|
|
116
|
+
findings, adaptations, source evidence and limitations. Do not expose provider
|
|
117
|
+
handles, raw receipt internals or model usage as founder-facing explanation.
|
|
118
|
+
PMR supplies its own enclosing heading; direct use can present the same body.
|
|
119
|
+
|
|
120
|
+
`finalize-receipt.py` validates and seals context, raw manifest, normalized data,
|
|
121
|
+
analysis and rendered result with hashes. Its `coverage` contains:
|
|
122
|
+
|
|
123
|
+
- `status: complete|partial|no_data`;
|
|
124
|
+
- `collected_count`, `selected_count`, `analyzed_count`;
|
|
125
|
+
- `gaps`, including sampling and missing evidence.
|
|
126
|
+
|
|
127
|
+
Receipt `status` is respectively `completed`, `partial` or `no_data`. A no-data
|
|
128
|
+
collection can explain that successful collection returned no observations. A partial
|
|
129
|
+
collection can still be useful; neither should be rewritten as full coverage by
|
|
130
|
+
a consumer. Terminal provider failures can be reported alongside valid successful
|
|
131
|
+
datasets with the exact gap `Provider collection <key> ended with <STATUS>.`.
|
|
132
|
+
No successful dataset, corrupt hashes, unsupported claims, and running or
|
|
133
|
+
uncertain provider operations remain validation failures, not no-data evidence.
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
# Provider contract
|
|
2
|
+
|
|
3
|
+
## Boundary
|
|
4
|
+
|
|
5
|
+
Call Apify only through:
|
|
6
|
+
|
|
7
|
+
```text
|
|
8
|
+
GET $OS_URL/scrape/apify/actors/{actor_id}
|
|
9
|
+
POST $OS_URL/scrape/apify/run
|
|
10
|
+
GET $OS_URL/scrape/apify/runs/{run_id}
|
|
11
|
+
GET $OS_URL/scrape/apify/datasets/{dataset_id}?limit={bounded_limit}
|
|
12
|
+
```
|
|
13
|
+
|
|
14
|
+
Authenticate with `Authorization: Bearer $OS_API_KEY`. Use asynchronous runs
|
|
15
|
+
and a stable `Idempotency-Key` derived from the context hash, collection epoch,
|
|
16
|
+
logical run key, actor ID, and actor-input hash. Record the returned run and
|
|
17
|
+
dataset IDs before polling.
|
|
18
|
+
|
|
19
|
+
The idempotency header identifies one logical start but is not a local
|
|
20
|
+
exactly-once guarantee. If the initial POST succeeds upstream and its response
|
|
21
|
+
is lost before `run_id` is persisted, this skill cannot prove locally whether a
|
|
22
|
+
run exists; retry safety then depends on durable gateway/upstream idempotency.
|
|
23
|
+
The runner persists the exact request and attempt before POST. A retry with no
|
|
24
|
+
handle replays only that saved request/key through the gateway's durable
|
|
25
|
+
submission record; pending reconciliation must not be bypassed with a new key.
|
|
26
|
+
|
|
27
|
+
`scripts/build-provider-inputs.py` is the only actor-input adapter. It emits the
|
|
28
|
+
exact keys in `apify-inputs-v1`, which were verified against the current public
|
|
29
|
+
actor contracts. `scripts/run-apify.py` rejects missing or extra keys and saves
|
|
30
|
+
a hash-bound actor-details snapshot before a paid start. Actor-details metadata
|
|
31
|
+
is provenance, not a promise of a machine-readable input schema; when an actor
|
|
32
|
+
contract changes, update and version the adapter rather than asking the agent
|
|
33
|
+
to guess fields.
|
|
34
|
+
|
|
35
|
+
## Actors and bounded run plan
|
|
36
|
+
|
|
37
|
+
- TikTok: `clockworks/tiktok-scraper`
|
|
38
|
+
- Instagram Reels: `apify/instagram-reel-scraper`
|
|
39
|
+
|
|
40
|
+
Use at most four logical runs:
|
|
41
|
+
|
|
42
|
+
1. `tiktok-discovery`: the bounded requested TikTok accounts and recent videos.
|
|
43
|
+
2. `instagram-discovery`: the bounded requested Instagram accounts and recent Reels.
|
|
44
|
+
3. `tiktok-enrichment`: selected TikTok URLs, with video,
|
|
45
|
+
transcript/subtitles, and up to 20 comments.
|
|
46
|
+
4. `instagram-enrichment`: selected Reel URLs, with downloaded video,
|
|
47
|
+
transcript, and shares where the actor exposes them.
|
|
48
|
+
|
|
49
|
+
These four keys and actor/platform/kind combinations are enforced by
|
|
50
|
+
`scripts/run-apify.py`; arbitrary keys or actors fail before a paid run starts.
|
|
51
|
+
`raw/manifest.json` and `receipt.json` retain each `logical_key`, allow no more
|
|
52
|
+
than four entries, and reject duplicate logical keys, run IDs, or dataset IDs.
|
|
53
|
+
Discovery is required for every platform with declared accounts. Enrichment is
|
|
54
|
+
optional: request it only when additional evidence is needed for the scoped
|
|
55
|
+
question, within the authorized collection budget. Discovery-only evidence can
|
|
56
|
+
answer a caption or metric question without another paid call. If needed comments,
|
|
57
|
+
transcript or visual evidence remain unavailable, disclose that gap instead of
|
|
58
|
+
claiming complete coverage of the question.
|
|
59
|
+
|
|
60
|
+
A terminal failed run can be disclosed as partial coverage alongside valid
|
|
61
|
+
successful datasets. Missing required discovery, or any running/uncertain saved
|
|
62
|
+
handle, blocks sealing. Once enrichment has started, preserve and settle its
|
|
63
|
+
handle too; optional does not mean it can disappear from the record.
|
|
64
|
+
|
|
65
|
+
The v1 adapter supports at most six account records total, 1–30 discovery results
|
|
66
|
+
per account, and 30 enrichment URLs total across both platforms. These are
|
|
67
|
+
execution limits, not evidence sufficiency rules.
|
|
68
|
+
Set the requested sample to fit the task and paid-call budget; disclose sampling
|
|
69
|
+
gaps. There is no required number of examples per account or quality score.
|
|
70
|
+
|
|
71
|
+
Do not start discovery without declared accounts or enrichment without frozen
|
|
72
|
+
selected observations. Batch the applicable accounts or selected URLs for a
|
|
73
|
+
platform into its one logical run. Cap actor results and dataset reads; enrichment
|
|
74
|
+
uses the frozen selection rather than silently replacing it with new examples.
|
|
75
|
+
|
|
76
|
+
The versioned actor-input builder accepts only the current fields needed for:
|
|
77
|
+
|
|
78
|
+
- TikTok discovery by profile and enrichment by post URL;
|
|
79
|
+
- TikTok video/cover downloads, subtitles or transcript, and comments;
|
|
80
|
+
- Instagram Reels discovery by usernames/profile URLs and enrichment by Reel
|
|
81
|
+
URLs;
|
|
82
|
+
- Instagram transcript, downloaded video, and shares when the actor
|
|
83
|
+
exposes them.
|
|
84
|
+
|
|
85
|
+
The exact input JSON is saved under `raw/`; `run-state.json` binds its path,
|
|
86
|
+
hash, contract version, sorted key list, and actor-metadata snapshot.
|
|
87
|
+
|
|
88
|
+
The context's `collection` parameters default to 30 results per account and a
|
|
89
|
+
60-day lookback. The builder can revise previews before submission, but the
|
|
90
|
+
runner fixes the actual lower date at the first POST attempt and preserves it
|
|
91
|
+
on resume. Both actors support a lower date; this adapter does not promise an
|
|
92
|
+
identical arbitrary provider start/end interval. See the official
|
|
93
|
+
[TikTok input schema](https://apify.com/clockworks/tiktok-scraper/input-schema) and
|
|
94
|
+
[Reels input schema](https://apify.com/apify/instagram-reel-scraper/input-schema).
|
|
95
|
+
TikTok's date filter is a charged option: changing result count alone is not a
|
|
96
|
+
complete price estimate. Dataset `--dataset-limit` bounds retrieval, not paid
|
|
97
|
+
collection.
|
|
98
|
+
|
|
99
|
+
The current TikTok actor exposes requested comments through each video's
|
|
100
|
+
`commentsDatasetURL`, not necessarily inline. `run-apify.py` resolves those
|
|
101
|
+
dataset IDs, reads them through OS, and stores the exact linked responses in
|
|
102
|
+
`raw/tiktok-enrichment-comments.json`. This is a secondary dataset read under
|
|
103
|
+
the existing TikTok enrichment run, not a fifth actor run. The actor shares one
|
|
104
|
+
comments dataset across all videos of the run, so it is read with the run's
|
|
105
|
+
`--dataset-limit`. The gateway grants that dataset only after the run's own
|
|
106
|
+
video dataset was read through OS. `run-apify.py` reads it before the comments,
|
|
107
|
+
and a retry from saved output reads it again so a failed grant is retried.
|
|
108
|
+
Normalization must not claim TikTok comment coverage unless that hash-bound
|
|
109
|
+
bundle was processed.
|
|
110
|
+
|
|
111
|
+
## Raw evidence
|
|
112
|
+
|
|
113
|
+
Save every OS response as a raw JSON file before normalization. Preserve actor
|
|
114
|
+
ID, run ID, dataset ID, collection time, input hash, and raw-file hash. Do not
|
|
115
|
+
strip provider fields before the raw file is persisted.
|
|
116
|
+
|
|
117
|
+
Continue polling transitional `READY`, `RUNNING`, `TIMING-OUT`, and `ABORTING`
|
|
118
|
+
states. Treat only final `FAILED`, `ABORTED`, `TIMED-OUT`, or `TIMED_OUT` states
|
|
119
|
+
as terminal failures eligible for the explicit restart flow below.
|
|
120
|
+
|
|
121
|
+
If a run fails, preserve its terminal status. Successful datasets may still
|
|
122
|
+
support a partial result; record the exact gap
|
|
123
|
+
`Provider collection <key> ended with <STATUS>.` in the analysis. If no dataset
|
|
124
|
+
was successfully collected, report a collection failure, not no-data research.
|
|
125
|
+
Do not replace missing evidence with generic web search, another actor, a direct
|
|
126
|
+
provider API, or invented observations. Discovery may use OS web search to
|
|
127
|
+
locate public account handles and canonical profile URLs; it is not substitute
|
|
128
|
+
trend evidence.
|
|
129
|
+
|
|
130
|
+
A normal provider retry keeps the saved terminal failure; it cannot silently
|
|
131
|
+
spend on a replacement run. After inspecting the failure, explicitly
|
|
132
|
+
start a clean collection epoch with the exact failed handle:
|
|
133
|
+
|
|
134
|
+
```bash
|
|
135
|
+
python3 "$ORGANIC_TREND_SKILL_ROOT/scripts/run-state.py" \
|
|
136
|
+
--runtime-root "$RUNTIME_ROOT" restart-failed-collection \
|
|
137
|
+
--key "$FAILED_LOGICAL_KEY" --run-id "$FAILED_RUN_ID"
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
The command refuses an active/successful or mismatched handle, archives the
|
|
141
|
+
whole failed collection, and resets every provider-derived step before any new
|
|
142
|
+
paid call.
|
|
143
|
+
|
|
144
|
+
## Media evidence
|
|
145
|
+
|
|
146
|
+
When audiovisual evidence is needed, run `scripts/prepare-visual-evidence.py` for
|
|
147
|
+
the selected observations to inspect that have a provider `media_url`. It downloads
|
|
148
|
+
the media into the runtime root and extracts dense opening frames at approximately 0.0, 0.5, 1.5,
|
|
149
|
+
3.0, and 5.0 seconds plus middle, later, and ending samples when duration is
|
|
150
|
+
known. The canonical OS multimodal analyzer inspects those frames before the
|
|
151
|
+
analysis is written. A transcript can support spoken words but cannot establish
|
|
152
|
+
what appeared on screen.
|
|
153
|
+
|
|
154
|
+
Only `prepare-visual-evidence.py` may establish local visual evidence for this
|
|
155
|
+
workflow. It binds the provider media URL, downloaded video, fixed frame
|
|
156
|
+
samples, and their hashes. The default aggregate downloaded-media budget is 1
|
|
157
|
+
GiB across the collection; an individual video remains capped at 250 MiB.
|
|
158
|
+
|
|
159
|
+
If media cannot be retrieved or inspected, set the visual fields to
|
|
160
|
+
`unavailable` and record the evidence gap. Never turn a caption, cover, metric,
|
|
161
|
+
or transcript into an observed visual claim.
|
|
162
|
+
|
|
163
|
+
## Freshness and cache
|
|
164
|
+
|
|
165
|
+
Reuse matching successful runs on retry without changing collection times.
|
|
166
|
+
Assess whether the evidence is recent enough for the question; age alone does
|
|
167
|
+
not authorize spending on another collection. An explicitly requested refresh
|
|
168
|
+
archives the previous epoch and uses new idempotency keys. `init` never does this
|
|
169
|
+
silently, and active/uncertain starts must be resolved before refresh.
|
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
# Runtime contract
|
|
2
|
+
|
|
3
|
+
## Ownership
|
|
4
|
+
|
|
5
|
+
Direct use initializes `context.json` from the assignment; a research caller may
|
|
6
|
+
supply it instead. This skill owns collection, analysis and receipt files.
|
|
7
|
+
PMR additionally owns its combined report and integration receipt.
|
|
8
|
+
|
|
9
|
+
All paths below are relative to the workspace:
|
|
10
|
+
|
|
11
|
+
```text
|
|
12
|
+
egbe-docs/research/market/work/organic_trend_watch/
|
|
13
|
+
├── context.json
|
|
14
|
+
├── run-state.json
|
|
15
|
+
├── raw/
|
|
16
|
+
│ ├── manifest.json
|
|
17
|
+
│ ├── tiktok-enrichment-comments.json
|
|
18
|
+
│ └── *.json
|
|
19
|
+
├── media/
|
|
20
|
+
│ └── *.mp4
|
|
21
|
+
├── frames/
|
|
22
|
+
│ └── *.jpg
|
|
23
|
+
├── visual-analysis/
|
|
24
|
+
│ └── <observation-id-and-hash>.json
|
|
25
|
+
├── normalized/
|
|
26
|
+
│ ├── selection.json
|
|
27
|
+
│ └── videos.json
|
|
28
|
+
├── analysis.json
|
|
29
|
+
├── result.md
|
|
30
|
+
└── receipt.json
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
Never write outside this root. Every path stored in JSON is relative to this
|
|
34
|
+
root, uses `/`, and must not contain `..`.
|
|
35
|
+
|
|
36
|
+
Each `visual-analysis/*.json` receipt is bound to the ordered frame paths and
|
|
37
|
+
hashes, optional transcript hash, Organic visual-analysis instructions, OS
|
|
38
|
+
prompt contract, model role, and effective model. A valid completed receipt is
|
|
39
|
+
reused after a task retry or follow-up. A receipt with `status: unavailable` contains
|
|
40
|
+
no claims and records that neither frames nor a transcript were available.
|
|
41
|
+
|
|
42
|
+
## Context v1
|
|
43
|
+
|
|
44
|
+
```json
|
|
45
|
+
{
|
|
46
|
+
"schema_version": 1,
|
|
47
|
+
"section_id": "organic_trend_watch",
|
|
48
|
+
"assignment": "What the collected short-video evidence should help answer",
|
|
49
|
+
"product_context": "Relevant product, audience and constraints",
|
|
50
|
+
"collection": {"discovery_limit_per_account": 30, "lookback_days": 60},
|
|
51
|
+
"supporting_sections": [
|
|
52
|
+
{"id": "target_audience", "label": "Target audience", "content": "..."}
|
|
53
|
+
],
|
|
54
|
+
"sources": {
|
|
55
|
+
"context": {"path": "egbe-docs/research/market/context.md", "source_sha256": "..."},
|
|
56
|
+
"supporting_sections": [
|
|
57
|
+
{"id": "target_audience", "path": "...", "source_sha256": "..."}
|
|
58
|
+
]
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Only `schema_version`, `section_id`, `assignment` and `product_context` are
|
|
64
|
+
required. `supporting_sections` may contain relevant supplied evidence with
|
|
65
|
+
unique IDs; no PMR section is prerequisite. `sources` is optional; supplied
|
|
66
|
+
source paths/hashes identify their provenance, and supporting source IDs must
|
|
67
|
+
match their content entries. PMR verifies those local files/receipts against its
|
|
68
|
+
workspace before publishing; direct callers are responsible for the provenance
|
|
69
|
+
of supplied context. The runtime binds the exact context hash.
|
|
70
|
+
Do not use failed, stale or tampered receipts as completed research.
|
|
71
|
+
|
|
72
|
+
Optional `max_analysis_videos` can lower the default 30-video resource ceiling
|
|
73
|
+
for the v1 enrichment adapter. This is not a research quality threshold.
|
|
74
|
+
Selection records exclusions so a capped sample is not complete coverage.
|
|
75
|
+
|
|
76
|
+
Optional `collection` configures paid discovery: `discovery_limit_per_account`
|
|
77
|
+
is an integer from 1 to 30; `lookback_days` is a positive integer. Omitted fields
|
|
78
|
+
default to 30 and 60. These adjustable adapter defaults are not evidence
|
|
79
|
+
sufficiency criteria. Account/run limits, the total analysis cap and the dataset
|
|
80
|
+
read limit remain independent. Direct and PMR callers use this same context.
|
|
81
|
+
|
|
82
|
+
## Run state v1
|
|
83
|
+
|
|
84
|
+
Use `scripts/run-state.py` rather than editing this file directly. Steps are:
|
|
85
|
+
|
|
86
|
+
1. `discovery`
|
|
87
|
+
2. `collection`
|
|
88
|
+
3. `normalization`
|
|
89
|
+
4. `visual_analysis`
|
|
90
|
+
5. `synthesis`
|
|
91
|
+
6. `render`
|
|
92
|
+
|
|
93
|
+
Each step is `pending`, `running`, `completed`, or `failed`. Provider runs are
|
|
94
|
+
keyed by a stable logical key such as `tiktok-discovery`; the key and input hash
|
|
95
|
+
identify retry intent. Immediately before the first POST, the runner saves
|
|
96
|
+
`collection_window` (effective parameters, `reference_at`, `oldest_post_date`),
|
|
97
|
+
the exact actor input and each run's `request_json`, `attempted_at`, and stable
|
|
98
|
+
idempotency key. Initialization and input previews do not start collection.
|
|
99
|
+
The date lower bound is UTC midnight `lookback_days` before the first attempt;
|
|
100
|
+
the analytical upper bound is its exact `reference_at`. Both platforms request
|
|
101
|
+
the fixed lower date; local normalization enforces the full analytical window.
|
|
102
|
+
|
|
103
|
+
Persist `run_id` and `dataset_id` immediately after the response, before polling.
|
|
104
|
+
After any attempted submission, the builder preserves its input bytes or rejects
|
|
105
|
+
a conflict. Missing responses/handles retain `SUBMITTING` state. A retry may ask
|
|
106
|
+
the gateway to recover the same saved key/request; it never creates a replacement
|
|
107
|
+
operation. A gateway reconciliation error needs inspection, not a new key. This
|
|
108
|
+
is not an exactly-once guarantee for the external provider.
|
|
109
|
+
|
|
110
|
+
`run-state.py init` never discards existing collection because of age or a
|
|
111
|
+
changed context. Resume unchanged work; use a new study ID for a different
|
|
112
|
+
assignment. When a fresh collection is explicitly needed, `run-state.py refresh`
|
|
113
|
+
archives finished or terminal work and creates a new `collection_epoch` for
|
|
114
|
+
idempotency. It refuses active or uncertain provider starts. The narrower
|
|
115
|
+
`restart-failed-collection --key ... --run-id ...` flow validates the exact
|
|
116
|
+
terminal failure before archiving; see `provider-contract.md`. Preserve original
|
|
117
|
+
collection times so old evidence is not relabeled as fresh.
|
|
118
|
+
|
|
119
|
+
## Raw manifest v1
|
|
120
|
+
|
|
121
|
+
```json
|
|
122
|
+
{
|
|
123
|
+
"schema_version": 1,
|
|
124
|
+
"collection_epoch": "opaque-run-epoch",
|
|
125
|
+
"collection_started_at": "2026-07-31T12:00:00Z",
|
|
126
|
+
"collection_completed_at": "2026-07-31T12:10:00Z",
|
|
127
|
+
"accounts": [
|
|
128
|
+
{
|
|
129
|
+
"platform": "tiktok",
|
|
130
|
+
"handle": "example",
|
|
131
|
+
"account_type": "official",
|
|
132
|
+
"product_keywords": ["product"]
|
|
133
|
+
}
|
|
134
|
+
],
|
|
135
|
+
"accounts_source": {
|
|
136
|
+
"path": "raw/accounts.json",
|
|
137
|
+
"sha256": "..."
|
|
138
|
+
},
|
|
139
|
+
"datasets": [
|
|
140
|
+
{
|
|
141
|
+
"platform": "tiktok",
|
|
142
|
+
"kind": "discovery",
|
|
143
|
+
"path": "raw/tiktok-discovery.json",
|
|
144
|
+
"sha256": "..."
|
|
145
|
+
}
|
|
146
|
+
],
|
|
147
|
+
"linked_datasets": [
|
|
148
|
+
{
|
|
149
|
+
"kind": "tiktok-comments",
|
|
150
|
+
"parent_logical_key": "tiktok-enrichment",
|
|
151
|
+
"path": "raw/tiktok-enrichment-comments.json",
|
|
152
|
+
"sha256": "..."
|
|
153
|
+
}
|
|
154
|
+
],
|
|
155
|
+
"provider_runs": [
|
|
156
|
+
{
|
|
157
|
+
"logical_key": "tiktok-discovery",
|
|
158
|
+
"provider": "apify",
|
|
159
|
+
"actor_id": "clockworks/tiktok-scraper",
|
|
160
|
+
"run_id": "...",
|
|
161
|
+
"dataset_id": "...",
|
|
162
|
+
"status": "SUCCEEDED",
|
|
163
|
+
"input_sha256": "...",
|
|
164
|
+
"input_contract_version": "apify-inputs-v1",
|
|
165
|
+
"input_keys": ["oldestPostDateUnified", "profileSorting", "profiles", "resultsPerPage"],
|
|
166
|
+
"actor_metadata": {
|
|
167
|
+
"path": "raw/tiktok-discovery-actor-metadata.json",
|
|
168
|
+
"sha256": "..."
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
]
|
|
172
|
+
}
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
Allowed account types are `official`, `shadow`, `partner`,
|
|
176
|
+
`shadow-or-partner`, and `viral` (an independent high-performing account in the
|
|
177
|
+
same problem/category space). A dataset file may contain an OS envelope
|
|
178
|
+
(`data.rows`), a provider object with `items`, or a raw JSON array. Its declared
|
|
179
|
+
hash must match.
|
|
180
|
+
|
|
181
|
+
The manifest contains at most six accounts in v1. Its collection epoch and
|
|
182
|
+
provider handles, inputs, actor metadata, and raw hashes must match
|
|
183
|
+
`run-state.json` exactly. Discovery applies to each declared account platform;
|
|
184
|
+
enrichment is optional according to the question's evidence needs. A discovery-only
|
|
185
|
+
result is valid without inventing enrichment receipts. Terminal failures may be
|
|
186
|
+
explicit coverage gaps; no started run may disappear silently. Successful
|
|
187
|
+
TikTok enrichment also requires the hash-bound linked-comments bundle, even
|
|
188
|
+
when the actor exposed no comment dataset URLs.
|
|
189
|
+
|
|
190
|
+
## Receipt v1
|
|
191
|
+
|
|
192
|
+
`scripts/finalize-receipt.py` creates the receipt only after validating all
|
|
193
|
+
artifacts. It binds the collection epoch and exact context, raw manifest, normalized observations,
|
|
194
|
+
analysis, and rendered Markdown by SHA-256. `collected_at` equals the manifest's
|
|
195
|
+
`collection_completed_at`; `completed_at` cannot precede it. At least one
|
|
196
|
+
successful collected Apify dataset is required. Required discovery and any started
|
|
197
|
+
enrichment must be successful or a recorded terminal failure; running/unknown
|
|
198
|
+
handles block sealing. Needed but unavailable modalities remain coverage gaps,
|
|
199
|
+
not permission to infer them from captions or counts.
|
|
200
|
+
|
|
201
|
+
`status` is `completed`, `partial` or `no_data`. `coverage` records the matching
|
|
202
|
+
`complete`, `partial` or `no_data` status, collected/selected/analyzed counts and
|
|
203
|
+
gaps. Limited or absent usable evidence is a valid result, distinct from a
|
|
204
|
+
corrupt receipt or an unfinished/uncertain provider call. See `output-contract.md`.
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
Inspect the supplied chronological frame samples and optional transcript as
|
|
2
|
+
evidence for short-form video research.
|
|
3
|
+
|
|
4
|
+
- Describe literal visible subjects, actions, composition, cuts represented by
|
|
5
|
+
the samples, and exact on-screen text. Do not infer motion between samples.
|
|
6
|
+
- Identify what the available samples establish in the first 0–1.5 seconds and
|
|
7
|
+
across the 0–5 second opening. Keep visual and spoken evidence distinct.
|
|
8
|
+
- Capture observed format cues, explicit calls to action, paid-amplification
|
|
9
|
+
cues, and concrete source proof such as a demonstration, benchmark, ranking,
|
|
10
|
+
authority statement, or named result.
|
|
11
|
+
- Preserve useful source phrasing as attributed evidence. Do not transfer a
|
|
12
|
+
source's result, dataset, ranking, customer proof, or product capability to
|
|
13
|
+
the founder's product.
|
|
14
|
+
- Use the transcript only for spoken evidence. A caption, metric, cover image,
|
|
15
|
+
or filename is not visual or verbal evidence.
|
|
16
|
+
- State gaps when the samples cannot establish an opening, format, claim,
|
|
17
|
+
sequence, or spoken message.
|