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

> 2026-05-13

## 修复

* **`task.py archive` 自动提交不再把其他 task 目录的脏改动顺手带进归档 commit。** 现在归档 commit 只包含被归档 task 的 source + destination 路径（外加因为父子关系更新而被改了 `task.json` 的子 task 目录）。如果你在另一个终端窗口里改 task B 的同时归档 task A，B 的改动会安全地留在工作区，不会被错误提交。
* **`task.py archive` 不再留下"幽灵 delete"。** 之前用 `shutil.move` 把已 tracked 的 task 目录移到 `archive/<YYYY-MM>/` 之后，source 端的删除偶尔不会被 stage，工作区会显示一堆相对 HEAD 的 phantom delete。现在显式 `git rm --cached` source 端，归档后工作区立刻干净，不再需要补一个 "complete archive move" fixup commit。

## 内部变化

* **新增集成测试** `packages/cli/test/scripts/task-archive.integration.test.ts`：在临时 git 仓库里跑真实的 Python 脚本，覆盖 scope-creep + phantom-delete 两个回归点。
* **`safe_archive_paths_to_add()`** 新增可选参数 `task_name` + `modified_children`。已有调用方不传参数依然走 legacy 宽 scope，兼容老代码。

## 升级方式

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


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