feat: add deployer

skills/ack/README.md

@@ -51,8 +51,8 @@ docs/ack/
 目录读取。
 
 ACK 从当前命令指定的 `--project-root/docs/ack/` 定位项目状态，不要求在
-`tasks.yaml` 中持久化 `repoPath` 或 `devWorktree`。自动 worker 的实际工作目录仍由
-`--worktree` 指定，并且必须命中绝对路径白名单 `allowedWorktrees`。
+`tasks.yaml` 中持久化 `repoPath` 或 `devWorktree`。自动 worker 的实际工作目录由
+`--worktree` 指定；默认在 `--project-root` 工作，v0.19 起不再配置 `allowedWorktrees` 白名单。
 
 ## Skill 结构
 

skills/ack/SKILL.md

@@ -58,8 +58,9 @@ description: >-
 6. 完善 `docs/ack/tasks.yaml` 的项目信息。纯初始化且用户没有提供真实任务时，
    删除模板示例任务并保留 `tasks: []`；不要虚构需求或缺陷。
    项目状态固定从当前项目根的 `docs/ack/` 推导，不写入 `repoPath` 或 `devWorktree`；
-   worker 的绝对路径只保存在 `project.orchestration.allowedWorktrees` 并在派发时通过
-   `--worktree` 显式选择。旧任务板中的 `repoPath`、`devWorktree` 仅兼容读取。
+   worker 默认在 `--project-root`（权威状态目录）工作，不再配置
+   `allowedWorktrees` 白名单（v0.19 起废弃）；需要隔离 worktree 时由 Coordinator 在
+   派发时显式指定。旧任务板中的 `repoPath`、`devWorktree` 仅兼容读取。
 7. 检查 `docs/ack/knowledge.yaml`。新项目没有已验证的项目经验时保留
    `verificationRegistry: {}` 与 `entries: []`，不从聊天、README 或单次失败中
    猜测并激活知识。

skills/ack/examples/tasks.example.yaml

@@ -13,8 +13,7 @@ project:
   orchestration:
     profileVersion: 1
     mode: "manual"
-    allowedWorktrees:
-      - "/home/dev/notes-web-wt/fix-preview"
+    # allowedWorktrees 已废弃（v0.19 起）；worker 默认在 --project-root 工作。
     modelAllowlist:
       codex:
         developer:

skills/ack/references/adoption-checklist.md

@@ -23,10 +23,10 @@
 - [ ] Coordinator、Developer、Test 的模型档位和升级规则已明确。
 - [ ] `project.orchestration` 使用受支持的 profileVersion，模型都命中项目
       allowlist，默认 profile 与角色/档位一致。
-- [ ] `allowedWorktrees` 只列出同一 Git common-dir 下已经核对的绝对 worktree。
+- [ ] `allowedWorktrees` 已废弃（v0.19 起），新任务板不配置；worker 默认在
+      `--project-root` 工作，其它 worktree 由 launcher 按同 git 仓库且已注册约束放行。
 - [ ] `tasks.yaml` 不需要保存 `repoPath` 或 `devWorktree`；项目状态从当前
-      `--project-root/docs/ack/` 推导，worker 路径由 `--worktree` 与
-      `allowedWorktrees` 共同约束。
+      `--project-root/docs/ack/` 推导，worker 路径由 `--worktree` 显式指定。
 
 ## 路径权限
 

skills/ack/references/closed-loop.md

@@ -141,9 +141,9 @@ python3 <ack-skill-dir>/scripts/launch_worker.py launch \
 
 **方式 2：新建隔离 worktree，再在其中起子 agent**
 
-创建成功后，先把 Orca 返回的绝对路径加入权威任务板的
-`project.orchestration.allowedWorktrees` 并重新运行 `validate_tasks.py`；未进入
-allowlist 的路径不能交给 launcher。
+创建成功后，确认新 worktree 与权威项目根属于同一 Git 仓库（launcher 按
+`git worktree list` 注册表 + 同 common-dir 约束校验，v0.19 起不再需要
+`allowedWorktrees` 白名单登记）。
 
 ```bash
 orca worktree create --name <feature> --base-branch <base> --json

skills/ack/references/init-new-project.md

@@ -89,9 +89,9 @@ docs/ack/
   不再参与路径绑定。
 - 新项目的 `project.deliveryFile` 固定为 `docs/ack/delivery.yaml`，并保留顶层
   `deliveryRuns: []`。旧项目只有在采用交付能力时才补这两个字段。
-- `project.orchestration.allowedWorktrees` 使用已核对的绝对 worker worktree；模型
-  allowlist、profiles 和 defaults 使用项目实际允许值。不要把完整启动命令、
-  `extraArgs`、`env` 或任意 executable 写进任务板。
+- `allowedWorktrees` 已废弃（v0.19 起），新任务板不生成该字段；worker 默认在
+  `--project-root` 工作。模型 allowlist、profiles 和 defaults 使用项目实际允许值。
+  不要把完整启动命令、`extraArgs`、`env` 或任意 executable 写进任务板。
 - 非服务项目的 `baseUrl` 写为 `n/a`。
 - 没有真实任务时使用 `tasks: []`，不要保留或虚构示例任务。
 

skills/ack/references/kickoff.md

@@ -141,8 +141,8 @@ receipt 仅用于审计，不能在后续轮次单独授权复用。不要自行
 新 worktree 时可先运行
 `orca worktree create --name <feature> --base-branch <base> --json`，再对返回的绝对
 worktree 走同一套 `plan` -> 带 expected fingerprint 的 `launch`。在调用 launcher
-前，先把新
-路径加入 `project.orchestration.allowedWorktrees` 并重新运行任务板校验。profile
+前，确认新 worktree 与权威项目根同一 Git 仓库即可（v0.19 起不再需要登记
+`allowedWorktrees`）。profile
 只允许 `read-only` 或 `workspace-write`；v0.10 的 full-access 授权通道尚未实现，
 任何 bypass、YOLO/force 或关闭 sandbox 的请求都必须失败，不能手写命令兜底。
 选型与升级见 `model-routing.md`。

skills/ack/references/model-routing.md

@@ -79,9 +79,10 @@ worker 路由的机器可读事实只保存在 `docs/ack/tasks.yaml` 的
 - `reasoningEffort`：CLI 支持时显式声明；
 - `permissionMode`：只允许 `read-only` 或 `workspace-write`。
 
-`project.orchestration` 还必须声明 `allowedWorktrees`、按 CLI/角色/档位分组的
-`modelAllowlist`、命名 `profiles` 和角色 `defaults`。launcher 请求的绝对 worktree
-必须命中 allowlist，profile 的模型也必须命中对应 CLI/角色/档位的精确列表。
+`project.orchestration` 必须声明按 CLI/角色/档位分组的 `modelAllowlist`、命名
+`profiles` 和角色 `defaults`（`allowedWorktrees` 自 v0.19 起废弃，不再配置）。
+launcher 请求的 worktree 必须是同 Git 仓库的已注册 worktree，profile 的模型也必须
+命中对应 CLI/角色/档位的精确列表。
 
 模型名称、reasoning effort 和权限模式必须来自结构化字段。禁止在 profile、项目
 覆盖层或派发内容中保存自由 `command`、额外 argv、shell 片段、环境变量覆盖或隐式
@@ -135,8 +136,9 @@ python3 <ack-skill-dir>/scripts/launch_worker.py launch \
 ```
 
 `--project-root` 始终指向保存权威 `docs/ack/tasks.yaml` 的项目根；`--worktree` 是本次
-worker 实际工作的绝对路径，两者可以不同。后者仍必须属于同一项目并命中
-`project.orchestration.allowedWorktrees`。
+worker 实际工作的绝对路径，两者可以不同。后者仍必须与项目根属于同一 Git
+仓库（v0.19 起由 launcher 按 `git worktree list` 注册表 + 同 common-dir 校验，
+不再依赖 `allowedWorktrees` 白名单）。
 
 项目状态文件固定从 `--project-root/docs/ack/` 解析；任务板不需要保存 `repoPath` 或
 `devWorktree`。旧任务板中的这两个字段仅作兼容信息，launcher 不使用它们授权或定位。

skills/ack/references/orca-adapter.md

@@ -108,9 +108,9 @@ profile 只允许 `read-only` 或 `workspace-write`。v0.10 不提供可信的 f
 launcher fail closed，不能改用手写命令兜底。模型档位与升级规则见
 `model-routing.md`。
 
-需要隔离/并行时，可以先用 Orca 创建 worktree。Coordinator 必须先把返回的绝对
-路径加入 `project.orchestration.allowedWorktrees` 并重新校验 `tasks.yaml`，然后才在
-该路径上走 `plan` -> 带 expected fingerprint 的 `launch`，并把 receipt 留作审计。
+需要隔离/并行时，可以先用 Orca 创建 worktree（须与项目根同一 Git 仓库）。
+v0.19 起不再登记 `allowedWorktrees`，直接在该路径上走 `plan` -> 带 expected
+fingerprint 的 `launch`，并把 receipt 留作审计。
 既有会话可以由用户直接操作，但不能进入 ACK v0.10 的自动派发信任路径。
 
 ---

skills/ack/scripts/launch_worker.py

@@ -557,20 +557,13 @@ def assert_git_control_entry(worktree: Path) -> None:
 def capture_worktree_identity(
     project_root: Path,
     worktree_value: str,
-    allowed_worktrees: object,
 ) -> dict:
-    if not isinstance(allowed_worktrees, list):
-        raise LaunchError("project.orchestration.allowedWorktrees 必须是列表")
+    # allowedWorktrees 白名单已废弃（v0.19 起）。worktree 合法性由以下硬约束保证：
+    #   1) 必须是 Git worktree 根目录（不是任意子目录）；
+    #   2) 必须出现在 `git worktree list` 注册表中；
+    #   3) 必须与 --project-root 属于同一 Git common-dir（同仓库）。
+    # worker 默认就在 --project-root（权威状态目录）工作，天然满足这些约束。
     worktree = canonical_directory(worktree_value, "worker worktree")
-    configured_paths: list[Path] = []
-    for index, configured in enumerate(allowed_worktrees):
-        if not isinstance(configured, str):
-            raise LaunchError(f"allowedWorktrees[{index}] 必须是字符串")
-        configured_paths.append(
-            canonical_directory(configured, f"allowedWorktrees[{index}]")
-        )
-    if worktree not in configured_paths:
-        raise LaunchError(f"worker worktree 不在 allowedWorktrees 中: {worktree}")
 
     git = resolve_executable("git")
     assert_git_control_entry(project_root)
@@ -699,7 +692,6 @@ def build_plan(
     worktree = capture_worktree_identity(
         project_root,
         worktree_value,
-        orchestration.get("allowedWorktrees"),
     )
     executable = resolve_executable(str(profile["cli"]))
     executable_stat = executable.stat()

skills/ack/scripts/worker_profiles.py

@@ -46,6 +46,9 @@ def executable_basename_matches_cli(executable: str, cli: str) -> bool:
         return True
     return cli == "grok" and GROK_EXECUTABLE_NAME_RE.fullmatch(name) is not None
 
+# allowedWorktrees 已废弃（v0.19 起）：新任务板不再配置，旧任务板遗留该字段仍被容忍。
+# ORCHESTRATION_FIELDS 是“允许出现”的字段全集（含废弃字段），
+# REQUIRED_ORCHESTRATION_FIELDS 是“必须存在”的子集（不含废弃字段）。
 ORCHESTRATION_FIELDS = frozenset(
     {
         "profileVersion",
@@ -56,6 +59,15 @@ ORCHESTRATION_FIELDS = frozenset(
         "defaults",
     }
 )
+REQUIRED_ORCHESTRATION_FIELDS = frozenset(
+    {
+        "profileVersion",
+        "mode",
+        "modelAllowlist",
+        "profiles",
+        "defaults",
+    }
+)
 PROFILE_FIELDS = frozenset(
     {
         "role",
@@ -341,11 +353,10 @@ def validate_orchestration(
         return [f"{where}: must be an object"]
 
     errors = _unknown_fields(orchestration, ORCHESTRATION_FIELDS, where)
-    errors.extend(_missing_fields(orchestration, ORCHESTRATION_FIELDS, where))
+    errors.extend(_missing_fields(orchestration, REQUIRED_ORCHESTRATION_FIELDS, where))
 
     profile_version = orchestration.get("profileVersion")
     mode = orchestration.get("mode")
-    allowed_worktrees = orchestration.get("allowedWorktrees")
     allowlist = orchestration.get("modelAllowlist")
     profiles = orchestration.get("profiles")
     defaults = orchestration.get("defaults")
@@ -355,20 +366,9 @@ def validate_orchestration(
     if not isinstance(mode, str) or mode not in ORCHESTRATION_MODES:
         errors.append(f"{where}.mode: must be orca/manual")
 
-    if not isinstance(allowed_worktrees, list):
-        errors.append(f"{where}.allowedWorktrees: must be a list")
-    else:
-        if mode == "orca" and not allowed_worktrees:
-            errors.append(f"{where}.allowedWorktrees: Orca mode requires at least one path")
-        seen_worktrees: set[str] = set()
-        for index, worktree in enumerate(allowed_worktrees):
-            item_where = f"{where}.allowedWorktrees[{index}]"
-            if not _is_absolute_safe_path(worktree):
-                errors.append(f"{item_where}: must be a safe absolute path other than root")
-            elif worktree in seen_worktrees:
-                errors.append(f"{item_where}: duplicate worktree {worktree!r}")
-            else:
-                seen_worktrees.add(worktree)
+    # allowedWorktrees 已废弃：worker 默认在 --project-root 工作，
+    # 其它 worktree 由 launcher 按“同 git 仓库且已注册”约束（capture_worktree_identity）。
+    # 旧任务板中遗留的该字段被容忍，不再校验。
 
     errors.extend(_validate_model_allowlist(allowlist, f"{where}.modelAllowlist"))
 
@@ -757,11 +757,6 @@ def validate_worker_receipt(
             profile = candidate
         else:
             errors.append(f"{where}.profileId: unknown profile {profile_id!r}")
-        allowed = orchestration.get("allowedWorktrees")
-        if isinstance(worktree, dict) and isinstance(allowed, list):
-            if worktree.get("path") not in allowed:
-                errors.append(f"{where}.worktree.path: is not in allowedWorktrees")
-
     if profile is not None:
         try:
             expected_profile_hash = profile_hash(

skills/ack/templates/tasks.template.yaml

@@ -28,10 +28,10 @@ project:
   #     attachments: "<field_id>"
   #     updatedAt: "<field_id>"
   orchestration:
+    # worker 默认在 --project-root（权威状态目录）工作；不再配置 allowedWorktrees 白名单
+    # （v0.19 起废弃）。需要隔离 worktree 时由 Coordinator 在派发时显式指定。
     profileVersion: 1
     mode: "orca"
-    allowedWorktrees:
-      - "<dev_worktree>"
     modelAllowlist:
       codex:
         developer: