Documentation Index
Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt
Use this file to discover all available pages before exploring further.
加入 trellis upgrade，并把 stable 线的 context 修复带入 0.6 beta 线。
Enhancements
Trellis Upgrade
trellis upgrade 会安装与当前 CLI 版本匹配的 npm channel。
| Command | 行为 |
|---|
trellis upgrade | 按 channel 安装 @mindfoldhq/trellis@latest、@beta 或 @rc。 |
trellis upgrade --tag <tag> | 安装指定 dist-tag 或版本。 |
trellis upgrade --dry-run | 只打印 npm command，不安装。 |
trellis upgrade，不再提示原始 npm install -g command。
Brainstorm Templates
内置 brainstorm instructions 更短，并与 beta.8 的 planning artifact flow 保持一致。
| Template | Change |
|---|
packages/cli/src/templates/codex/skills/brainstorm/SKILL.md | 使用更短的 brainstorm routing model。 |
packages/cli/src/templates/common/skills/brainstorm.md | 使用同一套 shared planning contract。 |
packages/cli/src/templates/copilot/prompts/brainstorm.prompt.md | 对齐更短的 prompt text。 |
Bug Fixes
Upgrade Execution
Upgrade command 现在会校验 tag/version input，在 POSIX 上避免 shell interpolation，
在 Windows 上使用 cmd.exe /d /s /c，并在安装失败时打印 npm/PATH 排查信息。
OpenCode Context Prefix
OpenCode 现在会按实际解析 command 的 shell dialect 选择 TRELLIS_CONTEXT_ID
prefix。
| Environment | Prefix format |
|---|
| Windows PowerShell | $env:TRELLIS_CONTEXT_ID = ... |
| Windows Git Bash/MSYS/Cygwin | export TRELLIS_CONTEXT_ID=... |
Existing env prefix | env TRELLIS_CONTEXT_ID=... |
Session Context
非 Git Trellis root 不再展示假的 clean Git state。Session context 现在会说明 root
不是 Git repository，并为未配置的 polyrepo layout 做有边界的 child repository scan。
OpenCode Sub-Agent Context
Trellis implement/check/research child sessions 会跳过重复的 workflow-state injection，
并从 session runtime、Active task: prompt hint 或 single-session fallback 解析
active task。
jsonl entries -> prd.md -> design.md if present -> implement.md if present
Hook Timeouts And Copilot
Hook defaults 现在给 SessionStart 30s，给 per-prompt workflow injection 15s，覆盖
hook-based platforms。Copilot SessionStart output 不再输出过期的 systemMessage；
它保留 hookSpecificOutput.additionalContext。
Internal
Manifest Continuity
Beta 线补回 0.5.13.json，让后续 beta manifest check 覆盖 stable 0.5.13
release。
Upgrade
npm install -g @mindfoldhq/trellis@beta
trellis update
