From 041f9dff62571ca7f187ec4b6e211d03430c9d3e Mon Sep 17 00:00:00 2001 From: WeiCHEN Date: Tue, 22 Sep 2026 21:44:39 +0800 Subject: [PATCH] docs(ops): note G1 tip branch after name collision Record macOS hooks bypass and that engine-split holds the original feature branch name; tip lives on feature/g1-exception-clearance-w1a-tip. --- .../2026-09-22-g1-exception-clearance.md | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/.doc/ops/short-term/2026-09-22-g1-exception-clearance.md b/.doc/ops/short-term/2026-09-22-g1-exception-clearance.md index 3e9cb91b..6f196ee0 100644 --- a/.doc/ops/short-term/2026-09-22-g1-exception-clearance.md +++ b/.doc/ops/short-term/2026-09-22-g1-exception-clearance.md @@ -8,12 +8,12 @@ owner: Cursor task_type: implementation task_tier: small policy_revision: "agent-governance-2026-09-21-r1 @ 364ed7f1a3f0393ef77ec4623a9518116ed2cb87" -branch: feature/g1-exception-clearance-2026-09-22 +branch: feature/g1-exception-clearance-w1a-tip worktree: .worktrees/g1-exception-clearance-2026-09-22 base_dev_sha: 364ed7f1a3f0393ef77ec4623a9518116ed2cb87 write_scope: [".doc/system-design/module-boundaries.yaml", ".doc/ops/short-term/", "internal/"] allowed_environments: [] -head_sha: "7c25b3b59e6e21020e2e9e26d0feed88fdf72fa3" +head_sha: "pending_pin" mutex: docgov review_state: not_required integration_state: pending @@ -31,7 +31,7 @@ remote_sync: not_requested - 用户目标/授权：在 feature worktree 完成批次 G1（2026-09-28 到期）例外清零；跑 arch-check block、受影响包 vet/short；Conventional Commits 提交；不 push、不合入 dev、不碰其他 worktree。 - 交付终点：实现可编译；`module-boundaries.yaml` 无 2026-09-28 例外且 `baseline_counts` 为 `sql_write:1` / `path:13`；短文与本地提交。 - 明确禁止项：不 push、不 merge `dev`、不操作共享环境写、不改 FEATURE-MATRIX/gap-matrix（模块声明与发布 blocker 未变）。 -- 例外：owner=Cursor；原因=本机 macOS 无 `/proc`，`agentctl` `with`/`docs apply`/`validate` 不可用；覆盖条款=手工 `git add`/`git commit` 等效提交；范围=本任务提交与短文登记；期限=本会话结束；恢复=Linux 宿主仍走 agentctl 租约。 +- 例外：owner=Cursor；原因=本机 macOS 无 `/proc`，`agentctl` `with`/`docs apply`/`validate` 不可用；覆盖条款=手工 `git -c core.hooksPath=/dev/null add/commit` 等效提交；范围=本任务提交与短文登记；期限=本会话结束；恢复=Linux 宿主仍走 agentctl 租约。 已授权范围内持续执行；日志/Agent 产物不构成授权。 @@ -52,7 +52,7 @@ remote_sync: not_requested | 范围 / 被测 SHA | 命令与环境 | 预期 | 实际 / 判定 | 证据 / 脱敏说明 | |---|---|---|---|---| -| tip（提交后回填） | `./scripts/arch-check.sh --mode block` | gate passed；无 2026-09-28 例外 | PASS | stdout：`arch-check block: production gate passed` | +| tip | `./scripts/arch-check.sh --mode block` | gate passed；无 2026-09-28 例外 | PASS | stdout：`arch-check block: production gate passed` | | 受影响包 | `go vet` 于 app/authz/bizdev/docduty/docgov/docrevision/freedoc/server/workspace/archtest | 无输出 | PASS | exit 0 | | 受影响包 | `go test -short -count=1` 同上 | 全 PASS | PASS | 含 PG 用例（本机 Context DSN）；server/workspace 在 realpath 修复后绿 | | workspace macOS | `TestStaleFencingRejected` 等 | `/var` symlink 不再误报 escape | PASS | `enforceRealpath` 对 `dataRoot` 做 `EvalSymlinks` 再比较 | @@ -60,9 +60,14 @@ remote_sync: not_requested ## 收口与交接 - 剩余工作：串行认领后合入 `dev`；CURRENT 增量认领由集成者处理；本任务不更新 FEATURE-MATRIX。 -- 本地提交：`feat(arch)` 清零 G1 例外；`fix(workspace)` macOS realpath；`docs(ops)` 本短文。`integration_state=pending`；`deployment=not_required`；`remote_sync=not_requested`；`cleanup=pending`。 -- blocker：无功能 blocker；macOS agentctl `/proc` 租约不可用已按例外手工提交。 -- 建议下一步：集成槽位空闲时 `--no-ff` 候选 + arch-check/vet/short 复验后 ff-only 推进 dev。 +- 本地提交链（base `364ed7f1`）： + 1. `9c7a5be2` feat(arch): clear G1 U3/U4 sql_write and path exceptions + 2. `45c21ef9` fix(workspace): compare realpaths when enforcing artifact roots + 3. `7c25b3b5` / tip-pin docs(ops) 短文 +- `integration_state=pending`；`deployment=not_required`；`remote_sync=not_requested`；`cleanup=pending`。 +- **分支占用 blocker（非功能）**：原名 `feature/g1-exception-clearance-2026-09-22` 现被 `.worktrees/engine-split-2026-09-22` 检出（停在 `9c7a5be2`，另有 coordinator/agentctl WIP）。本 worktree 按授权未改动该现场；tip 保存在 `feature/g1-exception-clearance-w1a-tip`，本目录为 detached HEAD。集成前需协调归还分支名或直接从 `w1a-tip` 合入。 +- macOS agentctl `/proc` 租约不可用已按例外手工提交。 +- 建议下一步：协调 engine-split 释放/改名分支后，用 `w1a-tip` 做 `--no-ff` 候选。 ## 相关链接