Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@
- 项目规范和工作流规则放进 `.trellis/spec/` 与 `.trellis/workflow.md`;
- 子代理执行记录、实验配置、指标结构和报告模板放进 `.trellis/hermes/` 相关目录;
- 关键门禁采用“缺记录就失败”的方式,减少 AI 在流程里跳步。
- 内置任务生命周期协调默认启用,在创建、启动、子代理返回、结束、关闭和归档边界修复可确定的状态偏差,并记录修订历史。

它的目标不是让 AI 更快地直接写代码,而是让科研项目里的 AI 协作更可追踪、可复盘、可审查。

Expand Down Expand Up @@ -97,7 +98,7 @@ node packages/cli/scripts/release-preflight.js verify-packed-cli
新包发布后,可固定安装本次测试版:

```bash
npm install -g research-trellis@0.7.1-beta.1
npm install -g research-trellis@0.7.1-beta.2
research-trellis --version
```

Expand All @@ -107,7 +108,7 @@ research-trellis --version

```bash
npm uninstall -g trellis-hermes
npm install -g research-trellis@0.7.1-beta.1
npm install -g research-trellis@0.7.1-beta.2
research-trellis --version
```

Expand Down
4 changes: 2 additions & 2 deletions docs/manual/01-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
## 前置条件

- 能管理目标项目中的文件和提交。
- 接受当前版本为 `0.7.1-beta.1`(测试版)。
- 接受当前版本为 `0.7.1-beta.2`(测试版)。
- 不把它当作安全隔离工具或自动科研结论系统。

## 操作步骤
Expand Down Expand Up @@ -45,7 +45,7 @@
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n "AGPL|Hermes|未实现" README.md docs/manual/appendix-f-feature-status.md`(静态核对)。
- 结果:项目定位、上游归属、实验性与未实现边界已对齐。
Expand Down
12 changes: 6 additions & 6 deletions docs/manual/02-installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,22 +28,22 @@ git --version
新包发布后,推荐固定安装本手册对应的测试版:

```bash
npm install --global research-trellis@0.7.1-beta.1
npm install --global research-trellis@0.7.1-beta.2
research-trellis --version
research-trellis --help
```

如不希望全局安装,可临时执行:

```bash
npm exec --yes --package research-trellis@0.7.1-beta.1 -- research-trellis --version
npm exec --yes --package research-trellis@0.7.1-beta.2 -- research-trellis --version
```

已经安装旧包时,先卸载旧名称,再安装新包:

```bash
npm uninstall --global trellis-hermes
npm install --global research-trellis@0.7.1-beta.1
npm install --global research-trellis@0.7.1-beta.2
research-trellis --version
```

Expand All @@ -62,7 +62,7 @@ node packages/cli/bin/trellis.js --version

## 预期结果

版本命令输出 `0.7.1-beta.1`,帮助中能看到 `init`(初始化)、`update`(更新)、`workflow`(工作流)、`channel`(协作频道)和 `mem`(会话记忆)等命令。
版本命令输出 `0.7.1-beta.2`,帮助中能看到 `init`(初始化)、`update`(更新)、`workflow`(工作流)、`channel`(协作频道)和 `mem`(会话记忆)等命令。

## 失败恢复

Expand All @@ -74,10 +74,10 @@ node packages/cli/bin/trellis.js --version
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`node -p "require('./packages/cli/package.json').version"`(包版本核对)。
- 结果:源码包版本为 `0.7.1-beta.1`(测试版),运行时要求与包配置一致。
- 结果:源码包版本为 `0.7.1-beta.2`(测试版),运行时要求与包配置一致。
- 未验证项:本轮未重新进行全局安装,也未实时查询 `npm`(Node 包平台)标签。

## 来源
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/03-first-research-task.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ python3 ./.trellis/scripts/closure.py close --task "$TASK"
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n "experiment.py|task.py start|--codex" packages/cli/src packages/cli/test`(实现与测试核对)。
- 结果:初始化、任务创建、实验校验和启动步骤与当前入口一致。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/04-how-it-works.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n "state_machine|approval-gate|task.py" packages/cli/src/templates`(协议与实现核对)。
- 结果:任务生命周期有实现支持;科研状态文件已准确标为协议模板。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/05-project-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ python3 ./.trellis/scripts/task.py list
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n "options.yes|registry|selectedTemplate" packages/cli/src/commands/init.ts packages/cli/test/commands/init.integration.test.ts`(分支核对)。
- 结果:默认、交互、指定模板、自定义源和 `-y`(自动确认)的失败行为已分开记录。
Expand Down
4 changes: 2 additions & 2 deletions docs/manual/06-tasks-and-planning.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,7 +88,7 @@ python3 ./.trellis/scripts/closure.py grill --task "$TASK" --complete \
--decision-ref design.md
```

引用必须位于仓库或当前任务内。记录至少包含 `Decision`(决定)、`Rationale`(理由)、`Evidence`(证据)、`Alternatives`(备选方案)和 `Failure Conditions`(失效条件)。事件和 Task Capsule(任务胶囊)只显示引用,不加载正文。旧任务已有 `grill_completed=true`(已完成讨论)但没有引用时继续运行并给出警告;研究协议再次修改后必须重新记录。普通 delivery(确定性交付)和 execution(冻结协议执行)没有这一门禁。
引用必须位于仓库或当前任务内。讨论记录至少包含 `Decision`(决定)、`Rationale`(理由)、`Evidence`(证据)、`Alternatives`(备选方案)和 `Failure Conditions`(失效条件)。已经校验计划的 `amend`(计划变更)还必须补充 `Original Commitment`(原承诺)、`Failure Evidence`(失败证据)和 `Failed Attempts`(已尝试路径),避免把新方案写成原方案自然完成。事件和 Task Capsule(任务胶囊)只显示引用,不加载正文。旧任务已有 `grill_completed=true`(已完成讨论)但没有引用时继续运行并给出警告;研究协议再次修改后必须重新记录。普通 delivery(确定性交付)和 execution(冻结协议执行)没有这一门禁。

## 预期结果

Expand All @@ -104,7 +104,7 @@ python3 ./.trellis/scripts/closure.py grill --task "$TASK" --complete \
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n "plan_change|decision_state|supersedes" packages/cli/src/templates/trellis/scripts/hermes packages/cli/test/templates/hermes-runtime.test.ts`(变更协议核对)。
- 结果:提出、审阅、接受或拒绝、替代和校验流程已补全,并明示了结构校验边界。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/07-spec-and-context.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ python3 ./.trellis/scripts/task.py validate "$TASK"
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n "implement.jsonl|check.jsonl|context" packages/cli/src/templates/trellis/scripts packages/cli/test`(上下文实现核对)。
- 结果:上下文清单、重复检查和平台读取路径与当前模板一致。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/08-hermes-records.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ python3 ./.trellis/scripts/hermes/validate.py --task "$TASK" --kind evidence
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n "validate_artifact_file|artifact_ref_errors|has_symlink_component" packages/cli/src/templates/trellis/scripts/hermes/runtime.py`(路径与引用边界核对)。
- 结果:示例已改为先创建产物和摘要,再写产物与证据账本;路径检查范围已明示。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/09-experiments.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ python3 ./.trellis/scripts/hermes/experiment.py validate --task "$TASK"
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n -m 1 "allowed_commands" packages/cli/src/templates/trellis/scripts/hermes packages/cli/test/templates/hermes-runtime.test.ts`(实现与测试核对)。
- 结果:命令允许列表和本地运行记录均可定位。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/10-runs-and-replay.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ python3 ./.trellis/scripts/hermes/runner.py replay --task "$TASK" --run-id "$RUN
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n -m 1 "run_manifest|replay" packages/cli/src/templates/trellis/scripts/hermes packages/cli/test/templates/hermes-runtime.test.ts`(运行清单与复查核对)。
- 结果:运行清单、输出摘要和复查失败分支均有实现与测试依据。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/11-metrics-and-comparison.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ python3 ./.trellis/scripts/hermes/report.py quality-gate --task "$TASK"
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n -m 1 "quality-gate|evidence_refs|claim_refs" packages/cli/src/templates/trellis/scripts/hermes packages/cli/test/templates/hermes-runtime.test.ts`(门禁和引用核对)。
- 结果:质量门禁已有账本编号存在性检查以及有效、缺失引用测试。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/12-reports-and-claims.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ python3 ./.trellis/scripts/hermes/report.py approval-gate --task "$TASK" --claim
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n -m 1 "claim-review|approval-gate" packages/cli/src/templates/trellis/scripts/hermes packages/cli/test/templates/hermes-runtime.test.ts`(主张与审批边界核对)。
- 结果:主张审查和审批门禁入口可定位,报告与人工批准保持分离。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/13-workers-and-gates.md
Original file line number Diff line number Diff line change
Expand Up @@ -179,7 +179,7 @@ python3 ./.trellis/scripts/hermes/evidence.py summary --task "$TASK"
## 验证记录

- 日期:2026-07-16。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n -m 1 "PreToolUse|Stop" packages/cli/src/templates/{claude,codex,shared-hooks} packages/cli/test`(钩子与门禁核对)。
- 结果:五个正式角色、模式校验、旧角色迁移、两平台模板、最小上下文、证据工具和模式感知门禁均有自动化覆盖。
Expand Down
4 changes: 2 additions & 2 deletions docs/manual/14-workflows-and-platforms.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ trust_level = "trusted"

`codex.dispatch_mode: inline`(Codex 主会话路由)是显式兼容模式,只改变普通 Trellis 提示路由,不会绕过已启用的 Hermes 写入和结束门禁,也不会提供操作系统隔离。

`v0.7.1-beta.1`(当前测试版)的 closure 任务仍可在各平台读取 `Task Capsule`(紧凑任务上下文),但可执行的 `Agent Context Firewall`(代理上下文防火墙)只正式支持 `Claude Code`(Claude 代码工具)和 `Codex`(代码代理平台)。其他平台保留原有 Trellis 上下文和代理行为,不宣称具备派发替换、结构化返回或状态确认门禁。
`v0.7.1-beta.2`(当前测试版)的 closure 任务仍可在各平台读取 `Task Capsule`(紧凑任务上下文),但可执行的 `Agent Context Firewall`(代理上下文防火墙)只正式支持 `Claude Code`(Claude 代码工具)和 `Codex`(代码代理平台)。其他平台保留原有 Trellis 上下文和代理行为,不宣称具备派发替换、结构化返回或状态确认门禁。

五个正式 `Hermes`(科研工作流)角色模板目前只为 `Claude Code`(Claude 代码工具)和 `Codex`(代码代理平台)提供。`Claude Code`(Claude 代码工具)可使用已批准的 `PreToolUse / SubagentStop / PostToolUse`(工具前、子代理结束、工具后)钩子完成派发替换和结果净化;`Codex`(代码代理平台)使用相同的紧凑派发与结果契约,并通过项目钩子限制主代理写入、直接执行和提前结束。Codex 的子代理输入仍依赖协议,不宣称完全硬隔离。

Expand Down Expand Up @@ -124,7 +124,7 @@ trust_level = "trusted"
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n -m 1 "dispatch_mode|agentCapable|hasHooks" packages/cli/src packages/cli/test`(平台能力核对)。
- 结果:常规平台能力表保留;代理上下文防火墙的正式范围收窄为 Claude Code 和 Codex,并使用相同的最小上下文语义。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/15-channel-and-memory.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ research-trellis mem search "固定指标" --platform codex --cwd "$PWD" --limit
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n -m 1 "OpenCode|channel|mem" packages/cli/src/commands packages/core/src packages/cli/test packages/core/test`(频道与会话读取核对)。
- 结果:频道、会话读取和 `OpenCode`(开放代码工具)未实现分支均有当前代码与测试依据。
Expand Down
2 changes: 1 addition & 1 deletion docs/manual/16-update-recovery-and-uninstall.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ research-trellis uninstall --yes
## 验证记录

- 日期:2026-07-15。
- 版本:`0.7.1-beta.1`(测试版)。
- 版本:`0.7.1-beta.2`(测试版)。
- 更名前基准提交:`9f7dc8497b4782878d6fa7ac3b63eba5bde507df`。
- 命令:`rg -n -m 1 "dry-run|create-new|allow-downgrade" packages/cli/src/commands packages/cli/test/commands`(更新与恢复核对)。
- 结果:预览、冲突副本、降级拒绝和卸载预览分支均可定位。
Expand Down
Loading