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

Adds `trellis upgrade` and carries stable-line context fixes into the 0.6 beta track.

## Enhancements

### Trellis Upgrade

`trellis upgrade` installs the npm channel that matches the current CLI version.

| Command                       | Behavior                                                             |
| ----------------------------- | -------------------------------------------------------------------- |
| `trellis upgrade`             | Installs `@mindfoldhq/trellis@latest`, `@beta`, or `@rc` by channel. |
| `trellis upgrade --tag <tag>` | Installs an explicit dist-tag or version.                            |
| `trellis upgrade --dry-run`   | Prints the npm command without installing.                           |

Update hints now point at `trellis upgrade` instead of raw `npm install -g`
commands.

### Brainstorm Templates

Bundled brainstorm instructions are shorter and match the beta.8 planning
artifact flow.

| Template                                                          | Change                                     |
| ----------------------------------------------------------------- | ------------------------------------------ |
| `packages/cli/src/templates/codex/skills/brainstorm/SKILL.md`     | Uses the shorter brainstorm routing model. |
| `packages/cli/src/templates/common/skills/brainstorm.md`          | Uses the same shared planning contract.    |
| `packages/cli/src/templates/copilot/prompts/brainstorm.prompt.md` | Mirrors the shorter prompt text.           |

## Bug Fixes

### Upgrade Execution

The upgrade command validates tag/version input, avoids shell interpolation on
POSIX, uses `cmd.exe /d /s /c` on Windows, and prints npm/PATH troubleshooting
when installation fails.

### OpenCode Context Prefix

OpenCode now picks the `TRELLIS_CONTEXT_ID` prefix for the shell dialect that
will parse the command.

| 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

Non-Git Trellis roots no longer report fake clean Git state. Session context now
states that the root is not a Git repository and scans bounded child repositories
for unconfigured polyrepo layouts.

### OpenCode Sub-Agent Context

Trellis implement/check/research child sessions skip duplicate workflow-state
injection and resolve the active task from session runtime, an `Active task:`
prompt hint, or a single-session fallback.

```text theme={null}
jsonl entries -> prd.md -> design.md if present -> implement.md if present
```

### Hook Timeouts And Copilot

Hook defaults now allow 30s for SessionStart and 15s for per-prompt workflow
injection across hook-based platforms. Copilot SessionStart output no longer
emits the stale `systemMessage`; it keeps `hookSpecificOutput.additionalContext`.

## Internal

### Manifest Continuity

The beta line restores `0.5.13.json` so future beta manifest checks include the
stable `0.5.13` release.

## Upgrade

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