{ "canonical_name": "triggerdotdev/trigger.dev", "compilation_id": "pack_bf1c3b866b764b8382a821da5a6bcfed", "created_at": "2026-06-12T04:58:27.011052+00:00", "created_by": "project-pack-compiler", "feedback": { "carrier_selection_notes": [ "viable_asset_types=mcp_config, recipe, host_instruction, eval, preflight", "recommended_asset_types=mcp_config, recipe, host_instruction, eval, preflight" ], "evidence_delta": { "confirmed_claims": [ "identity_anchor_present", "capability_and_host_targets_present", "install_path_declared_or_better" ], "missing_required_fields": [], "must_verify_forwarded": [ "Run or inspect `npm install @trigger.dev/sdk` in an isolated environment.", "Confirm the project exposes the claimed capability to at least one target host." ], "quickstart_execution_scope": "allowlisted_sandbox_smoke", "sandbox_command": "npm install @trigger.dev/sdk", "sandbox_container_image": "node:22-slim", "sandbox_execution_backend": "docker", "sandbox_planner_decision": "llm_execute_isolated_install", "sandbox_validation_id": "sbx_979c3448bd404f6cb2d74c4dabac9017" }, "feedback_event_type": "project_pack_compilation_feedback", "learning_candidate_reasons": [], "template_gaps": [] }, "identity": { "canonical_id": "project_f280ffca2e3527572f9cc6e1d85131e0", "canonical_name": "triggerdotdev/trigger.dev", "homepage_url": null, "license": "unknown", "repo_url": "https://github.com/triggerdotdev/trigger.dev", "slug": "trigger-dev", "source_packet_id": "phit_74b0dcf1c5514d4394d7cc73f508e091", "source_validation_id": "dval_0f400fe592834ae3a9c3e8ae6709fae4" }, "merchandising": { "best_for": "需要流程自动化能力，并使用 mcp_host的用户", "github_forks": 1296, "github_stars": 15264, "one_liner_en": "Trigger.dev – build and deploy fully‑managed AI agents and workflows", "one_liner_zh": "Trigger.dev – 构建并部署全托管的 AI 代理和工作流", "primary_category": { "category_id": "workflow-automation", "confidence": "high", "name_en": "Workflow Automation", "name_zh": "流程自动化", "reason": "curated popular coverage category matched project identity" }, "target_user": "使用 mcp_host 等宿主 AI 的用户", "title_en": "trigger.dev", "title_zh": "trigger.dev 能力包", "visible_tags": [ { "label_en": "Visual Generation", "label_zh": "视觉生成", "source": "repo_evidence_project_characteristics", "tag_id": "product_domain-visual-generation", "type": "product_domain" }, { "label_en": "Visual Workflow Orchestration", "label_zh": "视觉工作流编排", "source": "repo_evidence_project_characteristics", "tag_id": "user_job-visual-workflow-orchestration", "type": "user_job" }, { "label_en": "Workflow Automation", "label_zh": "流程自动化", "source": "repo_evidence_project_characteristics", "tag_id": "core_capability-workflow-automation", "type": "core_capability" }, { "label_en": "Node-based Workflow", "label_zh": "节点式流程编排", "source": "repo_evidence_project_characteristics", "tag_id": "workflow_pattern-node-based-workflow", "type": "workflow_pattern" }, { "label_en": "Evidence-backed Context", "label_zh": "证据化上下文", "source": "repo_evidence_project_characteristics", "tag_id": "selection_signal-evidence-backed-context", "type": "selection_signal" } ] }, "packet_id": "phit_74b0dcf1c5514d4394d7cc73f508e091", "page_model": { "artifacts": { "artifact_slug": "trigger-dev", "files": [ "PROJECT_PACK.json", "QUICK_START.md", "PROMPT_PREVIEW.md", "HUMAN_MANUAL.md", "AI_CONTEXT_PACK.md", "BOUNDARY_RISK_CARD.md", "PITFALL_LOG.md", "REPO_INSPECTION.json", "REPO_INSPECTION.md", "CAPABILITY_CONTRACT.json", "EVIDENCE_INDEX.json", "CLAIM_GRAPH.json" ], "required_files": [ "PROJECT_PACK.json", "QUICK_START.md", "PROMPT_PREVIEW.md", "HUMAN_MANUAL.md", "AI_CONTEXT_PACK.md", "BOUNDARY_RISK_CARD.md", "PITFALL_LOG.md", "REPO_INSPECTION.json" ] }, "detail": { "capability_source": "Project Hit Packet + DownstreamValidationResult", "commands": [ { "command": "npm install @trigger.dev/sdk", "label": "Node.js / npm · 官方安装入口", "source": "https://github.com/triggerdotdev/trigger.dev#readme", "verified": true } ], "display_tags": [ "视觉生成", "视觉工作流编排", "流程自动化", "节点式流程编排", "证据化上下文" ], "eyebrow": "流程自动化", "glance": [ { "body": "判断自己是不是目标用户。", "label": "最适合谁", "value": "需要流程自动化能力，并使用 mcp_host的用户" }, { "body": "先理解能力边界，再决定是否继续。", "label": "核心价值", "value": "Trigger.dev – build and deploy fully‑managed AI agents and workflows" }, { "body": "未完成验证前保持审慎。", "label": "继续前", "value": "publish to Doramagic.ai project surfaces" } ], "guardrail_source": "Boundary & Risk Card", "guardrails": [ { "body": "Prompt Preview 只展示流程，不证明项目已安装或运行。", "label": "Check 1", "value": "不要把试用当真实运行" }, { "body": "mcp_host", "label": "Check 2", "value": "确认宿主兼容" }, { "body": "publish to Doramagic.ai project surfaces", "label": "Check 3", "value": "先隔离验证" } ], "mode": "mcp_config, recipe, host_instruction, eval, preflight", "pitfall_log": { "items": [ { "body": "Project evidence flags a identity risk. Review the linked source before relying on this workflow.", "category": "Identity risk", "evidence": [ "identity.distribution | github_repo:572570113 | https://github.com/triggerdotdev/trigger.dev" ], "severity": "medium", "suggested_check": "Reproduce the official install and quickstart path in an isolated environment.", "title": "Identity risk requires verification", "user_impact": "May increase setup, validation, or first-run risk for the user." }, { "body": "Developers should check this installation risk before relying on the project: bug: CLI crashes with \"Invalid comparator: catalog:\" when @trigger.dev/* deps use workspace catalogs (bun/pnpm catalog: protocol)", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_issue | https://github.com/triggerdotdev/trigger.dev/issues/3905" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: bug: CLI crashes with \"Invalid comparator: catalog:\" when @trigger.dev/* deps use workspace catalogs (bun/pnpm catalog: protocol). Context: Observed when using node, windows", "title": "Installation risk requires verification", "user_impact": "Developers may fail before the first successful local run: bug: CLI crashes with \"Invalid comparator: catalog:\" when @trigger.dev/* deps use workspace catalogs (bun/pnpm catalog: protocol)" }, { "body": "Developers should check this installation risk before relying on the project: trigger.dev v4.4.3", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.3" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.3. Context: Observed when using node, python, docker", "title": "Installation risk requires verification", "user_impact": "Upgrade or migration may change expected behavior: trigger.dev v4.4.3" }, { "body": "Developers should check this installation risk before relying on the project: trigger.dev v4.4.4", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.4" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.4. Context: Observed when using node, docker", "title": "Installation risk requires verification", "user_impact": "Upgrade or migration may change expected behavior: trigger.dev v4.4.4" }, { "body": "Developers should check this installation risk before relying on the project: trigger.dev v4.4.5", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.5" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.5. Context: Observed when using node, docker", "title": "Installation risk requires verification", "user_impact": "Upgrade or migration may change expected behavior: trigger.dev v4.4.5" }, { "body": "Developers should check this installation risk before relying on the project: trigger.dev v4.4.6", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.6" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.6. Context: Observed when using node, python, docker", "title": "Installation risk requires verification", "user_impact": "Upgrade or migration may change expected behavior: trigger.dev v4.4.6" }, { "body": "Developers should check this installation risk before relying on the project: trigger.dev v4.5.0-rc.0", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.0" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.5.0-rc.0. Context: Observed when using node, docker", "title": "Installation risk requires verification", "user_impact": "Upgrade or migration may change expected behavior: trigger.dev v4.5.0-rc.0" }, { "body": "Developers should check this installation risk before relying on the project: trigger.dev v4.5.0-rc.1", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.1" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.5.0-rc.1. Context: Observed when using node, python, docker", "title": "Installation risk requires verification", "user_impact": "Upgrade or migration may change expected behavior: trigger.dev v4.5.0-rc.1" }, { "body": "Developers should check this installation risk before relying on the project: trigger.dev v4.5.0-rc.2", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.2" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.5.0-rc.2. Context: Observed when using node, python, docker", "title": "Installation risk requires verification", "user_impact": "Upgrade or migration may change expected behavior: trigger.dev v4.5.0-rc.2" }, { "body": "Developers should check this installation risk before relying on the project: trigger.dev v4.5.0-rc.3", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.3" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.5.0-rc.3. Context: Observed when using node, python, docker", "title": "Installation risk requires verification", "user_impact": "Upgrade or migration may change expected behavior: trigger.dev v4.5.0-rc.3" }, { "body": "Developers should check this installation risk before relying on the project: trigger.dev v4.5.0-rc.4", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.4" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.5.0-rc.4. Context: Observed when using node, python, docker", "title": "Installation risk requires verification", "user_impact": "Upgrade or migration may change expected behavior: trigger.dev v4.5.0-rc.4" }, { "body": "Developers should check this installation risk before relying on the project: trigger.dev v4.5.0-rc.5", "category": "Installation risk", "evidence": [ "failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.5" ], "severity": "medium", "suggested_check": "Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.5.0-rc.5. Context: Observed when using node, python, docker", "title": "Installation risk requires verification", "user_impact": "Upgrade or migration may change expected behavior: trigger.dev v4.5.0-rc.5" }, { "body": "Project evidence flags a installation risk. Review the linked source before relying on this workflow.", "category": "Installation risk", "evidence": [ "community_evidence:github | https://github.com/triggerdotdev/trigger.dev/issues/3905" ], "severity": "medium", "suggested_check": "Reproduce the official install and quickstart path in an isolated environment.", "title": "Installation risk requires verification", "user_impact": "May increase setup, validation, or first-run risk for the user." }, { "body": "README/documentation is current enough for a first validation pass.", "category": "Capability evidence risk", "evidence": [ "capability.assumptions | github_repo:572570113 | https://github.com/triggerdotdev/trigger.dev" ], "severity": "medium", "suggested_check": "Reproduce the official install and quickstart path in an isolated environment.", "title": "Capability evidence risk requires verification", "user_impact": "May increase setup, validation, or first-run risk for the user." }, { "body": "Project evidence flags a maintenance risk. Review the linked source before relying on this workflow.", "category": "Maintenance risk", "evidence": [ "evidence.maintainer_signals | github_repo:572570113 | https://github.com/triggerdotdev/trigger.dev" ], "severity": "medium", "suggested_check": "Reproduce the official install and quickstart path in an isolated environment.", "title": "Maintenance risk requires verification", "user_impact": "May increase setup, validation, or first-run risk for the user." }, { "body": "no_demo", "category": "Security or permission risk", "evidence": [ "downstream_validation.risk_items | github_repo:572570113 | https://github.com/triggerdotdev/trigger.dev" ], "severity": "medium", "suggested_check": "Reproduce the official install and quickstart path in an isolated environment.", "title": "Security or permission risk requires verification", "user_impact": "May increase setup, validation, or first-run risk for the user." } ], "source": "ProjectPitfallLog + ProjectHitPacket + validation + community signals", "summary": "Found 19 structured pitfall item(s), including 0 high/blocking item(s). Top priority: Identity risk - Identity risk requires verification.", "title": "Pitfall Log" }, "snapshot": { "contributors": 138, "forks": 1296, "license": "unknown", "note": "站点快照，非实时质量证明；用于开工前背景判断。", "stars": 15264 }, "source_url": "https://github.com/triggerdotdev/trigger.dev", "steps": [ { "body": "不安装项目，先体验能力节奏。", "code": "preview", "title": "先试 Prompt" }, { "body": "理解输入、输出、失败模式和边界。", "code": "manual", "title": "读说明书" }, { "body": "把上下文交给宿主 AI 继续工作。", "code": "context", "title": "带给 AI" }, { "body": "进入主力环境前先完成安装入口与风险边界验证。", "code": "verify", "title": "沙箱验证" } ], "subtitle": "Trigger.dev – build and deploy fully‑managed AI agents and workflows", "title": "trigger.dev 能力包", "trial_prompt": "# trigger.dev - Prompt Preview\n\n> Copy the prompt below into your AI host before installing anything.\n> Its purpose is to let you safely feel the project's workflow, not to claim the project has already run.\n\n## Copy this prompt\n\n```text\nYou are using an independent Doramagic capability pack for triggerdotdev/trigger.dev.\n\nProject:\n- Name: trigger.dev\n- Repository: https://github.com/triggerdotdev/trigger.dev\n- Summary: Trigger.dev – build and deploy fully‑managed AI agents and workflows\n- Host target: mcp_host\n\nGoal:\nHelp me evaluate this project for the following task without installing it yet: Trigger.dev – build and deploy fully‑managed AI agents and workflows\n\nBefore taking action:\n1. Restate my task, success standard, and boundary.\n2. Identify whether the next step requires tools, browser access, network access, filesystem access, credentials, package installation, or host configuration.\n3. Use only the Doramagic Project Pack, the upstream repository, and the source-linked evidence listed below.\n4. If a real command, install step, API call, file write, or host integration is required, mark it as \"requires post-install verification\" and ask for approval first.\n5. If evidence is missing, say \"evidence is missing\" instead of filling the gap.\n\nPreviewable capabilities:\n- Capability 1: Use the source-backed project context to guide one small, checkable workflow step.\n\nCapabilities that require post-install verification:\n- Capability 1: Use the source-backed project context to guide one small, checkable workflow step.\n\nCore service flow:\n1. page-overview: Platform Overview & Architecture. Produce one small intermediate artifact and wait for confirmation.\n2. page-cli: Trigger.dev CLI v3 & Developer Workflows. Produce one small intermediate artifact and wait for confirmation.\n3. page-run-engine: Run Engine, Queues, and Task Execution. Produce one small intermediate artifact and wait for confirmation.\n4. page-deployment: Deployment, Self-hosting & Worker Infrastructure. Produce one small intermediate artifact and wait for confirmation.\n\nSource-backed evidence to keep in mind:\n- https://github.com/triggerdotdev/trigger.dev\n- https://github.com/triggerdotdev/trigger.dev#readme\n- .claude/skills/span-timeline-events/SKILL.md\n- .claude/skills/trigger-dev-tasks/SKILL.md\n- packages/cli-v3/skills/authoring-chat-agent/SKILL.md\n- packages/cli-v3/skills/authoring-tasks/SKILL.md\n- packages/cli-v3/skills/chat-agent-advanced/SKILL.md\n- packages/cli-v3/skills/getting-started/SKILL.md\n- packages/cli-v3/skills/realtime-and-frontend/SKILL.md\n- README.md\n\nFirst response rules:\n1. Start Step 1 only.\n2. Explain the one service action you will perform first.\n3. Ask exactly three questions about my target workflow, success standard, and sandbox boundary.\n4. Stop and wait for my answers.\n\nStep 1 follow-up protocol:\n- After I answer the first three questions, stay in Step 1.\n- Produce six parts only: clarified task, success standard, boundary conditions, two or three options, tradeoffs for each option, and one recommendation.\n- End by asking whether I confirm the recommendation.\n- Do not move to Step 2 until I explicitly confirm.\n\nConversation rules:\n- Advance one step at a time and wait for confirmation after each small artifact.\n- Write outputs as recommendations or planned checks, not as completed execution.\n- Do not claim tests passed, files changed, commands ran, APIs were called, or the project was installed.\n- If the user asks for execution, first provide the sandbox setup, expected output, rollback, and approval checkpoint.\n```\n", "voices": [ { "body": "来源平台：github。github/github_issue: bug: CLI crashes with \"Invalid comparator: catalog:\" when @trigger.dev/*（https://github.com/triggerdotdev/trigger.dev/issues/3905）；github/github_release: trigger.dev v4.5.0-rc.5（https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.5）；github/github_release: trigger.dev v4.5.0-rc.4（https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.4）；github/github_release: trigger.dev v4.5.0-rc.3（https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.3）；github/github_release: trigger.dev v4.5.0-rc.2（https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.2）；github/github_release: trigger.dev v4.5.0-rc.1（https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.1）；github/github_release: trigger.dev v4.5.0-rc.0（https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.0）；github/github_release: trigger.dev v4.4.6（https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.6）；github/github_release: trigger.dev v4.4.5（https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.5）；github/github_release: trigger.dev v4.4.4（https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.4）；github/github_release: trigger.dev v4.4.3（https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.3）。这些是项目级外部声音，不作为单独质量证明。", "items": [ { "kind": "github_issue", "source": "github", "title": "bug: CLI crashes with \"Invalid comparator: catalog:\" when @trigger.dev/*", "url": "https://github.com/triggerdotdev/trigger.dev/issues/3905" }, { "kind": "github_release", "source": "github", "title": "trigger.dev v4.5.0-rc.5", "url": "https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.5" }, { "kind": "github_release", "source": "github", "title": "trigger.dev v4.5.0-rc.4", "url": "https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.4" }, { "kind": "github_release", "source": "github", "title": "trigger.dev v4.5.0-rc.3", "url": "https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.3" }, { "kind": "github_release", "source": "github", "title": "trigger.dev v4.5.0-rc.2", "url": "https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.2" }, { "kind": "github_release", "source": "github", "title": "trigger.dev v4.5.0-rc.1", "url": "https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.1" }, { "kind": "github_release", "source": "github", "title": "trigger.dev v4.5.0-rc.0", "url": "https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.0" }, { "kind": "github_release", "source": "github", "title": "trigger.dev v4.4.6", "url": "https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.6" }, { "kind": "github_release", "source": "github", "title": "trigger.dev v4.4.5", "url": "https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.5" }, { "kind": "github_release", "source": "github", "title": "trigger.dev v4.4.4", "url": "https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.4" }, { "kind": "github_release", "source": "github", "title": "trigger.dev v4.4.3", "url": "https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.3" } ], "status": "已收录 11 条来源", "title": "社区讨论" } ] }, "homepage_card": { "category": "流程自动化", "desc": "Trigger.dev – build and deploy fully‑managed AI agents and workflows", "effort": "安装已验证", "forks": 1296, "icon": "bolt", "name": "trigger.dev 能力包", "risk": "可发布", "slug": "trigger-dev", "stars": 15264, "tags": [ "视觉生成", "视觉工作流编排", "流程自动化", "节点式流程编排", "证据化上下文" ], "thumb": "gray", "type": "MCP 配置" }, "manual": { "markdown": "", "markdown_key": "trigger-dev", "pages": "draft", "source_refs": [ { "evidence_id": "github_repo:572570113", "kind": "repo", "supports_claim_ids": [ "claim_identity", "claim_distribution", "claim_capability" ], "url": "https://github.com/triggerdotdev/trigger.dev" }, { "evidence_id": "art_f86e9d25177e46a985fe1ef48695f6ca", "kind": "docs", "supports_claim_ids": [ "claim_identity", "claim_distribution", "claim_capability" ], "url": "https://github.com/triggerdotdev/trigger.dev#readme" } ], "summary": "Full DeepWiki/Human Wiki output with Doramagic pitfall notes appended.", "title": "trigger.dev Manual", "toc": [ "https://github.com/triggerdotdev/trigger.dev Project Manual", "Table of Contents", "Platform Overview & Architecture", "Purpose and Scope", "Repository Structure", "Core Architecture", "Development, Deployment, and Known Issues", "See Also", "Pitfall Log" ] } }, "quality_gate": { "blocking_gaps": [], "category_confidence": "medium", "compile_status": "ready_for_review", "five_assets_present": true, "install_sandbox_verified": true, "missing_evidence": [], "next_action": "publish to Doramagic.ai project surfaces", "prompt_preview_boundary_ok": true, "publish_status": "publishable", "quick_start_verified": true, "repo_clone_verified": true, "repo_commit": "8dc77c0ccde7cf0e127f3d3da04d892d4aa54e6d", "repo_inspection_error": null, "repo_inspection_files": [ "pnpm-lock.yaml", "README.md", "package.json", "docs/migration-defer.mdx", "docs/wait-for-token.mdx", "docs/examples.mdx", "docs/cli-dev-commands.mdx", "docs/cli-preview-archive.mdx", "docs/help-email.mdx", "docs/video-walkthrough.mdx", "docs/how-to-reduce-your-spend.mdx", "docs/openapi.yml", "docs/run-usage.mdx", "docs/cli-init-commands.mdx", "docs/apikeys.mdx", "docs/batch-queue-metrics.md", "docs/docs.json", "docs/cli-deploy-commands.mdx", "docs/manual-setup.mdx", "docs/community.mdx", "docs/quick-start.mdx", "docs/github-integration.mdx", "docs/cli-development-commands.mdx", "docs/cli-switch.mdx", "docs/triggering.mdx", "docs/cli-promote-commands.mdx", "docs/queue-concurrency.mdx", "docs/cli-list-profiles-commands.mdx", "docs/open-source-contributing.mdx", "docs/cli-update-commands.mdx", "docs/compute-private-beta.mdx", "docs/troubleshooting-uptime-status.mdx", "docs/troubleshooting-debugging-in-vscode.mdx", "docs/roadmap.mdx", "docs/migrating-from-v3.mdx", "docs/README.md", "docs/introduction.mdx", "docs/wait.mdx", "docs/cli-whoami-commands.mdx", "docs/runs.mdx" ], "repo_inspection_verified": true, "review_reasons": [], "tag_count_ok": true, "unsupported_claims": [] }, "schema_version": "0.1", "user_assets": { "ai_context_pack": { "asset_id": "ai_context_pack", "filename": "AI_CONTEXT_PACK.md", "markdown": "# trigger.dev - Doramagic AI Context Pack\n\n> Purpose: pre-work context for the user's host AI. This pack does not prove that the project has been installed, run, or validated.\n\n## Project\n\n- canonical_name: `triggerdotdev/trigger.dev`\n- capability: Trigger.dev – build and deploy fully‑managed AI agents and workflows\n- expected_user_outcome: Trigger.dev – build and deploy fully‑managed AI agents and workflows\n\n## Operating Boundaries\n\n- Do not claim that the project has been installed, run, called through an API, or used on local files unless separate evidence proves it.\n- Project facts must come from repo evidence, Claim Graph, or explicit source references.\n- When a capability is not verified, mark it as unverified instead of completing it as fact.\n- publish_status: `publishable`\n- blocking_gaps: none\n\n---\n\n## Doramagic Context Augmentation\n\nThe following sections strengthen the repository context for a host AI. Human Manual data is a reading route, and pitfall notes become operating constraints.\n\n## Human Manual Outline\n\nUsage rule: this is only a reading route and salience signal, not factual authority. Concrete claims must still return to repo evidence or Claim Graph.\n\nHost AI hard rules:\n- Do not treat page titles, section order, summaries, or importance values as factual project evidence.\n- When explaining the Human Manual outline, state that it is only a reading route or salience signal.\n- Capability, installation, compatibility, runtime state, and risk claims must cite repo evidence, source paths, or Claim Graph.\n\n- **Platform Overview & Architecture**: importance `high`\n - source_paths: README.md, package.json, turbo.json, pnpm-workspace.yaml, docs/introduction.mdx\n- **Trigger.dev CLI v3 & Developer Workflows**: importance `high`\n - source_paths: packages/cli-v3/README.md, packages/cli-v3/DEVELOPMENT.md, packages/cli-v3/src/cli/index.ts, packages/cli-v3/src/commands/dev.ts, packages/cli-v3/src/commands/deploy.ts\n- **Run Engine, Queues, and Task Execution**: importance `high`\n - source_paths: internal-packages/run-engine/README.md, internal-packages/run-engine/src/engine/index.ts, internal-packages/run-engine/src/engine/systems/systems.ts, internal-packages/run-engine/src/run-queue/index.ts, internal-packages/run-engine/src/batch-queue/index.ts\n- **Deployment, Self-hosting & Worker Infrastructure**: importance `high`\n - source_paths: DOCKER_INSTALLATION.md, docker/docker-compose.yml, docker/Dockerfile, hosting/docker/docker-compose.traefik.yml, hosting/k8s/helm/Chart.yaml\n\n## Repo Inspection Evidence\n\n- repo_clone_verified: true\n- repo_inspection_verified: true\n- repo_commit: `8dc77c0ccde7cf0e127f3d3da04d892d4aa54e6d`\n- inspected_files: `pnpm-lock.yaml`, `README.md`, `package.json`, `docs/migration-defer.mdx`, `docs/wait-for-token.mdx`, `docs/examples.mdx`, `docs/cli-dev-commands.mdx`, `docs/cli-preview-archive.mdx`, `docs/help-email.mdx`, `docs/video-walkthrough.mdx`, `docs/how-to-reduce-your-spend.mdx`, `docs/openapi.yml`, `docs/run-usage.mdx`, `docs/cli-init-commands.mdx`, `docs/apikeys.mdx`, `docs/batch-queue-metrics.md`, `docs/docs.json`, `docs/cli-deploy-commands.mdx`, `docs/manual-setup.mdx`, `docs/community.mdx`\n\nHost AI hard rules:\n- Without repo_clone_verified=true, do not claim that the source code has been read.\n- Without repo_inspection_verified=true, do not write README, docs, or package-file conclusions as facts.\n- Without quick_start_verified=true, do not claim that the Quick Start path has run successfully.\n\n## Doramagic Pitfall Constraints\n\nThese rules come from Doramagic discovery, validation, or compilation findings. The host AI must treat them as operating constraints, not background notes.\n\n### Constraint 1: Identity risk requires verification\n\n- Trigger: Project evidence flags a identity risk. Review the linked source before relying on this workflow.\n- Host AI rule: Reproduce the official install and quickstart path in an isolated environment.\n- Why it matters: May increase setup, validation, or first-run risk for the user.\n- Evidence: identity.distribution | github_repo:572570113 | https://github.com/triggerdotdev/trigger.dev\n- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.\n\n### Constraint 2: Installation risk requires verification\n\n- Trigger: Developers should check this installation risk before relying on the project: bug: CLI crashes with \"Invalid comparator: catalog:\" when @trigger.dev/* deps use workspace catalogs (bun/pnpm catalog: protocol)\n- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: bug: CLI crashes with \"Invalid comparator: catalog:\" when @trigger.dev/* deps use workspace catalogs (bun/pnpm catalog: protocol). Context: Observed when using node, windows\n- Why it matters: Developers may fail before the first successful local run: bug: CLI crashes with \"Invalid comparator: catalog:\" when @trigger.dev/* deps use workspace catalogs (bun/pnpm catalog: protocol)\n- Evidence: failure_mode_cluster:github_issue | https://github.com/triggerdotdev/trigger.dev/issues/3905\n- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.\n\n### Constraint 3: Installation risk requires verification\n\n- Trigger: Developers should check this installation risk before relying on the project: trigger.dev v4.4.3\n- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.3. Context: Observed when using node, python, docker\n- Why it matters: Upgrade or migration may change expected behavior: trigger.dev v4.4.3\n- Evidence: failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.3\n- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.\n\n### Constraint 4: Installation risk requires verification\n\n- Trigger: Developers should check this installation risk before relying on the project: trigger.dev v4.4.4\n- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.4. Context: Observed when using node, docker\n- Why it matters: Upgrade or migration may change expected behavior: trigger.dev v4.4.4\n- Evidence: failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.4\n- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.\n\n### Constraint 5: Installation risk requires verification\n\n- Trigger: Developers should check this installation risk before relying on the project: trigger.dev v4.4.5\n- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.5. Context: Observed when using node, docker\n- Why it matters: Upgrade or migration may change expected behavior: trigger.dev v4.4.5\n- Evidence: failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.5\n- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.\n\n### Constraint 6: Installation risk requires verification\n\n- Trigger: Developers should check this installation risk before relying on the project: trigger.dev v4.4.6\n- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.6. Context: Observed when using node, python, docker\n- Why it matters: Upgrade or migration may change expected behavior: trigger.dev v4.4.6\n- Evidence: failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.4.6\n- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.\n\n### Constraint 7: Installation risk requires verification\n\n- Trigger: Developers should check this installation risk before relying on the project: trigger.dev v4.5.0-rc.0\n- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.5.0-rc.0. Context: Observed when using node, docker\n- Why it matters: Upgrade or migration may change expected behavior: trigger.dev v4.5.0-rc.0\n- Evidence: failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.0\n- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.\n\n### Constraint 8: Installation risk requires verification\n\n- Trigger: Developers should check this installation risk before relying on the project: trigger.dev v4.5.0-rc.1\n- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.5.0-rc.1. Context: Observed when using node, python, docker\n- Why it matters: Upgrade or migration may change expected behavior: trigger.dev v4.5.0-rc.1\n- Evidence: failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.1\n- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.\n\n### Constraint 9: Installation risk requires verification\n\n- Trigger: Developers should check this installation risk before relying on the project: trigger.dev v4.5.0-rc.2\n- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.5.0-rc.2. Context: Observed when using node, python, docker\n- Why it matters: Upgrade or migration may change expected behavior: trigger.dev v4.5.0-rc.2\n- Evidence: failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.2\n- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.\n\n### Constraint 10: Installation risk requires verification\n\n- Trigger: Developers should check this installation risk before relying on the project: trigger.dev v4.5.0-rc.3\n- Host AI rule: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.5.0-rc.3. Context: Observed when using node, python, docker\n- Why it matters: Upgrade or migration may change expected behavior: trigger.dev v4.5.0-rc.3\n- Evidence: failure_mode_cluster:github_release | https://github.com/triggerdotdev/trigger.dev/releases/tag/v4.5.0-rc.3\n- Hard boundary: Do not present this pitfall as solved, verified, or ignorable unless later evidence explicitly closes it.\n", "summary": "Context and operating boundaries for the user's host AI.", "title": "AI Context Pack" }, "boundary_risk_card": { "asset_id": "boundary_risk_card", "filename": "BOUNDARY_RISK_CARD.md", "markdown": "# Boundary & Risk Card\n\nProject: triggerdotdev/trigger.dev\n\n## Doramagic Trial Decision\n\nCurrent decision: ready for pre-publication recommendation checks. First use should still start with least privilege, a temporary directory, and rollback.\n\n## What The User Can Do Now\n\n- Read the Human Manual first to understand purpose and main workflows.\n- Copy the Prompt Preview for a pre-install trial. This checks interaction feel, not real execution.\n- Test the official Quick Start command in an isolated environment before using a primary machine.\n\n## What Not To Do Yet\n\n- Do not treat Prompt Preview output as an actual project run.\n- Do not treat metadata-only validation as sandbox install validation.\n- Do not write unverified capabilities as supported, tested, or safe to install.\n- Do not provide production data, private files, real secrets, or primary configuration directories on first use.\n\n## Pre-install Checklist\n\n- Host AI match: mcp_host\n- Official install entry state: official entry found\n- Verification location: temporary directory, temporary host, or container required\n- Rollback readiness: required\n- API keys, network access, file writes, or host configuration changes: treat as high risk until confirmed\n- Install command, actual output, and failure logs: must be recorded\n\n## Current Blockers\n\n- No blockers.\n\n## Project-specific Pitfalls\n\n- Identity risk requires verification (medium): May increase setup, validation, or first-run risk for the user. Suggested check: Reproduce the official install and quickstart path in an isolated environment.\n- Installation risk requires verification (medium): Developers may fail before the first successful local run: bug: CLI crashes with \"Invalid comparator: catalog:\" when @trigger.dev/* deps use workspace catalogs (bun/pnpm catalog: protocol) Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: bug: CLI crashes with \"Invalid comparator: catalog:\" when @trigger.dev/* deps use workspace catalogs (bun/pnpm catalog: protocol). Context: Observed when using node, windows\n- Installation risk requires verification (medium): Upgrade or migration may change expected behavior: trigger.dev v4.4.3 Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.3. Context: Observed when using node, python, docker\n- Installation risk requires verification (medium): Upgrade or migration may change expected behavior: trigger.dev v4.4.4 Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.4. Context: Observed when using node, docker\n- Installation risk requires verification (medium): Upgrade or migration may change expected behavior: trigger.dev v4.4.5 Suggested check: Before packaging this project, run the relevant install/config/quickstart check for: trigger.dev v4.4.5. Context: Observed when using node, docker\n\n## Risk And Permission Notes\n\n- no_demo: medium\n\n## Evidence Gaps\n\n- No structured evidence gaps found.\n", "summary": "Install, permission, validation, and recommendation risks.", "title": "Boundary & Risk Card" }, "human_manual": { "asset_id": "human_manual", "filename": "HUMAN_MANUAL.md", "markdown": "", "summary": "Full DeepWiki/Human Wiki output with Doramagic pitfall notes appended.", "title": "Human Manual" }, "pitfall_log": { "asset_id": "pitfall_log", "filename": "PITFALL_LOG.md", "markdown": "", "summary": "Identity, install, configuration, runtime, and safety issues to check before use.", "title": "Pitfall Log" }, "prompt_preview": { "asset_id": "prompt_preview", "filename": "PROMPT_PREVIEW.md", "markdown": "# trigger.dev - Prompt Preview\n\n> Copy the prompt below into your AI host before installing anything.\n> Its purpose is to let you safely feel the project's workflow, not to claim the project has already run.\n\n## Copy this prompt\n\n```text\nYou are using an independent Doramagic capability pack for triggerdotdev/trigger.dev.\n\nProject:\n- Name: trigger.dev\n- Repository: https://github.com/triggerdotdev/trigger.dev\n- Summary: Trigger.dev – build and deploy fully‑managed AI agents and workflows\n- Host target: mcp_host\n\nGoal:\nHelp me evaluate this project for the following task without installing it yet: Trigger.dev – build and deploy fully‑managed AI agents and workflows\n\nBefore taking action:\n1. Restate my task, success standard, and boundary.\n2. Identify whether the next step requires tools, browser access, network access, filesystem access, credentials, package installation, or host configuration.\n3. Use only the Doramagic Project Pack, the upstream repository, and the source-linked evidence listed below.\n4. If a real command, install step, API call, file write, or host integration is required, mark it as \"requires post-install verification\" and ask for approval first.\n5. If evidence is missing, say \"evidence is missing\" instead of filling the gap.\n\nPreviewable capabilities:\n- Capability 1: Use the source-backed project context to guide one small, checkable workflow step.\n\nCapabilities that require post-install verification:\n- Capability 1: Use the source-backed project context to guide one small, checkable workflow step.\n\nCore service flow:\n1. page-overview: Platform Overview & Architecture. Produce one small intermediate artifact and wait for confirmation.\n2. page-cli: Trigger.dev CLI v3 & Developer Workflows. Produce one small intermediate artifact and wait for confirmation.\n3. page-run-engine: Run Engine, Queues, and Task Execution. Produce one small intermediate artifact and wait for confirmation.\n4. page-deployment: Deployment, Self-hosting & Worker Infrastructure. Produce one small intermediate artifact and wait for confirmation.\n\nSource-backed evidence to keep in mind:\n- https://github.com/triggerdotdev/trigger.dev\n- https://github.com/triggerdotdev/trigger.dev#readme\n- .claude/skills/span-timeline-events/SKILL.md\n- .claude/skills/trigger-dev-tasks/SKILL.md\n- packages/cli-v3/skills/authoring-chat-agent/SKILL.md\n- packages/cli-v3/skills/authoring-tasks/SKILL.md\n- packages/cli-v3/skills/chat-agent-advanced/SKILL.md\n- packages/cli-v3/skills/getting-started/SKILL.md\n- packages/cli-v3/skills/realtime-and-frontend/SKILL.md\n- README.md\n\nFirst response rules:\n1. Start Step 1 only.\n2. Explain the one service action you will perform first.\n3. Ask exactly three questions about my target workflow, success standard, and sandbox boundary.\n4. Stop and wait for my answers.\n\nStep 1 follow-up protocol:\n- After I answer the first three questions, stay in Step 1.\n- Produce six parts only: clarified task, success standard, boundary conditions, two or three options, tradeoffs for each option, and one recommendation.\n- End by asking whether I confirm the recommendation.\n- Do not move to Step 2 until I explicitly confirm.\n\nConversation rules:\n- Advance one step at a time and wait for confirmation after each small artifact.\n- Write outputs as recommendations or planned checks, not as completed execution.\n- Do not claim tests passed, files changed, commands ran, APIs were called, or the project was installed.\n- If the user asks for execution, first provide the sandbox setup, expected output, rollback, and approval checkpoint.\n```\n", "summary": "A safe trial prompt for feeling the workflow before installing the project.", "title": "Prompt Preview / Pre-install Trial Prompt" }, "quick_start": { "asset_id": "quick_start", "filename": "QUICK_START.md", "markdown": "# Quick Start / Official Entry\n\nProject: triggerdotdev/trigger.dev\n\n## Official Install Entry\n\n### Node.js / npm - Official install entry\n\n```bash\nnpm install @trigger.dev/sdk\n```\n\nSource: https://github.com/triggerdotdev/trigger.dev#readme\n\n## Sources\n\n- repo: https://github.com/triggerdotdev/trigger.dev\n- docs: https://github.com/triggerdotdev/trigger.dev#readme\n", "summary": "Official entry points extracted from the project README or install docs.", "title": "Quick Start / Official Entry" } }, "validation_id": "dval_0f400fe592834ae3a9c3e8ae6709fae4" }