docs: update Aligner2 handoff baseline

Ariver

2026-06-28 8fbe7d9123cdb618de5ecf3cd1b0fb81199a2dac

 C1.source/AGENTS.md

@@ -1,25 +1,26 @@
# C1.source/AGENTS.md - 源码目录规则

适用于 `/Users/ar/Projects/Aligner/03-O/C1.source`。
适用于 `/Users/ar/Projects/Aligner2/03-O/C1.source`。

## 当前事实

- 本目录是 SwiftPM 源码根目录。
- 本目录不是 Git 根目录；Git 命令在 `/Users/ar/Projects/Aligner/03-O` 下执行。
- 本目录不是 Git 根目录；Git 命令在 `/Users/ar/Projects/Aligner2/03-O` 下执行。
- App 名：`Aligner`。
- Bundle ID：`com.ar.Aligner`。
- 最低 macOS：`26.0`。
- 最低 macOS：`14.0`。
- 当前产品入口：只有 `quickSwitch`。
- 默认 Quick Switch 快捷键：`Option+Tab`。

## 读取顺序

1. `/Users/ar/Projects/Aligner/AGENTS.md`
2. `/Users/ar/Projects/Aligner/PROJECT.md`
3. `/Users/ar/Projects/Aligner/GLOSSARY.md`
4. `/Users/ar/Projects/Aligner/03-O/README.md`
5. 当前任务相关的 Round / 架构文档
6. UI 修改时读 `/Users/ar/Projects/Aligner/DESIGN.md`
1. `/Users/ar/Projects/Aligner2/AGENTS.md`
2. `/Users/ar/Projects/Aligner2/PROJECT.md`
3. `/Users/ar/Projects/Aligner2/GLOSSARY.md`
4. `/Users/ar/Projects/Aligner2/03-O/README.md`
5. `/Users/ar/Projects/Aligner2/03-O/C1.source/CODEGRAPH.md`
6. 当前任务相关的 Round / 架构文档
7. UI 修改时读 `/Users/ar/Projects/Aligner2/DESIGN.md`

## 代码边界

@@ -36,20 +37,22 @@
- 过滤幽灵窗口和非任务系统浮层。
- 全屏 App 窗口必须可发现。
- 永远不要吞掉或阻挡 `Command+Option+Esc` Force Quit。
- 非平凡 Quick Switch 改动前，先读 `CODEGRAPH.md` 中对应 node，再读 node 指向的源码和 QA。
- 用户要求“冻结版本”时，必须在打 tag 前更新并校验 `CODEGRAPH.md`。

## 验证

从 `/Users/ar/Projects/Aligner/03-O/C1.source` 执行：
从 `/Users/ar/Projects/Aligner2/03-O/C1.source` 执行：

```bash
swift build 2>&1 | head -c 6000
swift test 2>&1 | head -c 6000
set -o pipefail; swift build 2>&1 | head -c 6000
set -o pipefail; swift test 2>&1 | head -c 6000
```

打包时执行：

```bash
/Users/ar/Projects/Aligner/03-O/C3.tools/package-app.sh 2>&1 | head -c 6000
set -o pipefail; /Users/ar/Projects/Aligner2/03-O/C3.tools/package-app.sh 2>&1 | head -c 6000
```

如果不能运行验证，说明具体原因和剩余风险。