> ## 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.

# v0.6.0-beta.9

> 2026-05-12

加入 `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。

```text theme={null}
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

```bash theme={null}
npm install -g @mindfoldhq/trellis@beta
trellis update
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.