@hunter-harness/workflow-harness 0.2.75 → 0.2.77

package/harness/bundles/general/claude-code/.harness-build.json

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "claude-code",
-  "coreHash": "24b43afeb4dc4c52"
+  "coreHash": "24872a7cdba2c8e5"
 }

package/harness/bundles/general/claude-code/harness-archive/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose
@@ -221,11 +221,17 @@ git 命令通过 `powershell.exe -Command "..."` 执行；archive-meta.md 和 su
 | 上传 | 载什么 | 结果在哪 |
 |------|--------|---------|
 | `steps.archive_push` | 归档 ZIP（核心产物） | `archiveId`/`archiveStatus`/`uploadStatus`/`knowledgeStatus`，同时落盘 `state/local/archive-packages/<cn>.remote.json` |
-| `steps.managed_snapshot_push` | **plan/spec 文档、`.harness/codebase` 架构地图、`.harness/rules`**（push 会 walk 每个归档目录的 `spec/` 与 `plans/`） | `ok`/`reasonCode`/`exitCode`/`cliCode`/`detail` |
+| `steps.managed_snapshot_push` | **归档交付物（每个变更目录的 `plans/`、`spec/`、`docs/` 全部，`reports/` 只取 `final/` 定稿）、`.harness/codebase` 架构地图、`.harness/rules`、`.harness/project.yaml`、指令入口** | `ok`/`reasonCode`/`exitCode`/`cliCode`/`detail` |
+
+走 `harness-push`（remote-sync，产生分支快照）而非 legacy `push`（proposal 管道）。
+归档目录下的 `runtime/`、`meta/`、`evidence/`、`logs/`、`fixback/`、`.publication-staging/`
+等过程文件不上传；`reports/review/` 与 `reports/test/` 同样是过程产物，不上传——
+这条边界与归档 ZIP 的包内容边界一致。交付物目录里的 `*.log`、`*.tmp`、凭证与 `.env*`
+也仍被安全规则拦下。
 
 ```
 远端归档：arc_3ff325bb…（archiveStatus=durable，uploadStatus=ready，knowledgeStatus=ready，8 文件）
-受管快照：❌ MANAGED_SNAPSHOT_UPLOAD_FAILED（exitCode=1，detail=…）→ plan/spec 与规则/架构地图未上平台，需 npx hunter-harness push --yes --non-interactive 重试
+受管快照：❌ MANAGED_SNAPSHOT_UPLOAD_FAILED（exitCode=1，detail=…）→ 归档 plan/spec/report 与规则/架构地图未上平台，需 npx hunter-harness harness-push --scope config,rules,architecture,instructions,branch_files --yes --non-interactive 重试
 ```
 
 **第二条尤其不能省**：它是 best-effort，失败不阻断归档，于是最容易被淹没成一句警告——而平台上"分支文件里没有 plan/spec"正是它失败的后果。成功时也要写明 `submitted` 数量；`ok=false` 时必须带上 `reasonCode` 与 `detail`，不得省略或写成"已完成"。

package/harness/bundles/general/claude-code/harness-codebase-map/SKILL.md

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-knowledge-ingest/SKILL.md

@@ -8,7 +8,7 @@ disallowed-tools:
   - Bash(git *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-ingest
 
 知识 ingest 完全由 Hunter Platform 负责。归档完成时，客户端生成一个确定性 ZIP；

package/harness/bundles/general/claude-code/harness-knowledge-query/SKILL.md

@@ -8,7 +8,7 @@ disallowed-tools:
   - Bash(git *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-query
 
 项目知识以 Hunter Platform 的服务端索引为唯一真源。客户端只提交查询并消费结果：

package/harness/bundles/general/claude-code/harness-plan/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-pull/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-pull — 从 Hunter Platform 下拉与恢复
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-push/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-push — 上传到 Hunter Platform
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-review/SKILL.md

@@ -22,7 +22,7 @@ disallowed-tools:
   - Bash(curl *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-run/SKILL.md

@@ -22,7 +22,7 @@ disallowed-tools:
   - Bash(curl *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-submit/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-sync/SKILL.md

@@ -19,7 +19,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-sync
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-test/SKILL.md

@@ -23,7 +23,7 @@ disallowed-tools:
   - Bash(node *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=claude-code; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose

package/harness/bundles/general/claude-code/scripts/harness_archive.py

@@ -9175,7 +9175,12 @@ def persist_archive_durability(summary_path: Path, durability: dict[str, Any]) -
 
 
 def auto_push_managed_snapshot(project_root: Path) -> dict[str, Any]:
-    """Best-effort upload of rules and Codebase Map through the normal push protocol."""
+    """Best-effort upload of rules, Codebase Map and archive deliverables via remote sync.
+
+    走 `harness-push`（remote-sync）而非 legacy `push`（proposal）。后者写的是
+    project_files_current，不产生分支快照，平台的「分支文件」与「项目资料」两个视图
+    都读不到；归档交付物在那条路上还会被 policy-never 全部跳过。
+    """
     project_root = project_root.resolve()
     credentials = _resolve_archive_remote_credentials(project_root, os.environ)
     if not credentials["configured"]:
@@ -9194,11 +9199,16 @@ def auto_push_managed_snapshot(project_root: Path) -> dict[str, Any]:
             "reasonCode": "MANAGED_SNAPSHOT_UPLOAD_DEFERRED",
             "warning": f"项目规则与架构地图上传已延后：{exc}",
         }
+    # 显式列出五个 scope 而非 `all`：含义固定，不随 `all` 的展开定义漂移。
+    # branch_files 覆盖归档交付物（plans/spec/reports/docs），其余四个覆盖配置、
+    # 规则、架构地图与指令入口。
     command = [
         *launcher,
         "--yes",
         "hunter-harness",
-        "push",
+        "harness-push",
+        "--scope",
+        "config,rules,architecture,instructions,branch_files",
         "--yes",
         "--non-interactive",
         "--json",
@@ -9212,6 +9222,10 @@ def auto_push_managed_snapshot(project_root: Path) -> dict[str, Any]:
             command,
             cwd=str(project_root),
             text=True,
+            # 不指定 encoding 时中文 Windows 会按 cp936 解码 UTF-8，静默损坏 CLI
+            # 的中文输出，并可能让下面的 json.loads 失败。
+            encoding="utf-8",
+            errors="replace",
             stdout=subprocess.PIPE,
             stderr=subprocess.PIPE,
             timeout=180,
@@ -9240,22 +9254,26 @@ def auto_push_managed_snapshot(project_root: Path) -> dict[str, Any]:
             "reasonCode": "MANAGED_SNAPSHOT_UPLOAD_FAILED",
             "detail": detail[-2_048:],
             "warning": (
-                "项目规则与架构地图未能同步到平台（plan/spec 也随这条推送上传）；"
-                "归档不受影响，稍后可运行 npx hunter-harness push --yes --non-interactive 重试。"
+                "项目规则与架构地图未能同步到平台（归档 plan/spec/report 也随这条推送上传）；"
+                "归档不受影响，稍后可运行 npx hunter-harness harness-push "
+                "--scope config,rules,architecture,instructions,branch_files "
+                "--yes --non-interactive 重试。"
             ),
         }
         cli_code = output.get("code") or output.get("reason_code") if isinstance(output, dict) else None
         if isinstance(cli_code, str) and cli_code:
             failure["cliCode"] = cli_code
         return failure
+    # harness-push 的回执用 summary.applied 计已落盘的操作数（legacy push 用 submitted）。
     summary = output.get("summary")
-    submitted = summary.get("submitted", 0) if isinstance(summary, dict) else 0
+    applied = summary.get("applied", 0) if isinstance(summary, dict) else 0
     return {
         "ok": bool(output.get("ok", True)),
         "skipped": False,
         "projectId": output.get("project_id"),
-        "submitted": submitted if isinstance(submitted, int) else 0,
-        "unchanged": "MANAGED_SNAPSHOT_UNCHANGED" in output.get("warnings", []),
+        "submitted": applied if isinstance(applied, int) else 0,
+        # 无变更时 harness-push 直接短路为 no_changes，不产生快照——即"仅在有更新时推送"。
+        "unchanged": output.get("outcome") == "no_changes",
     }
 
 

package/harness/bundles/general/codebuddy/.harness-build.json

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "codebuddy",
-  "coreHash": "24b43afeb4dc4c52"
+  "coreHash": "24872a7cdba2c8e5"
 }

package/harness/bundles/general/codebuddy/harness-archive/SKILL.md

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到 .harness/archive/，含归档元数据。仅当用户显式调用
   /harness-archive 时使用；不得被其他阶段 skill 自动接续触发。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose
@@ -203,11 +203,17 @@ git 命令通过 `powershell.exe -Command "..."` 执行；archive-meta.md 和 su
 | 上传 | 载什么 | 结果在哪 |
 |------|--------|---------|
 | `steps.archive_push` | 归档 ZIP（核心产物） | `archiveId`/`archiveStatus`/`uploadStatus`/`knowledgeStatus`，同时落盘 `state/local/archive-packages/<cn>.remote.json` |
-| `steps.managed_snapshot_push` | **plan/spec 文档、`.harness/codebase` 架构地图、`.harness/rules`**（push 会 walk 每个归档目录的 `spec/` 与 `plans/`） | `ok`/`reasonCode`/`exitCode`/`cliCode`/`detail` |
+| `steps.managed_snapshot_push` | **归档交付物（每个变更目录的 `plans/`、`spec/`、`docs/` 全部，`reports/` 只取 `final/` 定稿）、`.harness/codebase` 架构地图、`.harness/rules`、`.harness/project.yaml`、指令入口** | `ok`/`reasonCode`/`exitCode`/`cliCode`/`detail` |
+
+走 `harness-push`（remote-sync，产生分支快照）而非 legacy `push`（proposal 管道）。
+归档目录下的 `runtime/`、`meta/`、`evidence/`、`logs/`、`fixback/`、`.publication-staging/`
+等过程文件不上传；`reports/review/` 与 `reports/test/` 同样是过程产物，不上传——
+这条边界与归档 ZIP 的包内容边界一致。交付物目录里的 `*.log`、`*.tmp`、凭证与 `.env*`
+也仍被安全规则拦下。
 
 ```
 远端归档：arc_3ff325bb…（archiveStatus=durable，uploadStatus=ready，knowledgeStatus=ready，8 文件）
-受管快照：❌ MANAGED_SNAPSHOT_UPLOAD_FAILED（exitCode=1，detail=…）→ plan/spec 与规则/架构地图未上平台，需 npx hunter-harness push --yes --non-interactive 重试
+受管快照：❌ MANAGED_SNAPSHOT_UPLOAD_FAILED（exitCode=1，detail=…）→ 归档 plan/spec/report 与规则/架构地图未上平台，需 npx hunter-harness harness-push --scope config,rules,architecture,instructions,branch_files --yes --non-interactive 重试
 ```
 
 **第二条尤其不能省**：它是 best-effort，失败不阻断归档，于是最容易被淹没成一句警告——而平台上"分支文件里没有 plan/spec"正是它失败的后果。成功时也要写明 `submitted` 数量；`ok=false` 时必须带上 `reasonCode` 与 `detail`，不得省略或写成"已完成"。

package/harness/bundles/general/codebuddy/harness-codebase-map/SKILL.md

@@ -3,7 +3,7 @@ name: harness-codebase-map
 description: 分析现有代码库并生成 .harness/codebase/map/
   下的结构化代码库地图。用于陌生项目理解、重大改造前梳理、harness-sync 提示 map 过期后的人工刷新。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-knowledge-ingest/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-knowledge-ingest
 description: 确认归档 ZIP 已上传并由 Hunter Platform 在服务端解包、校验和入库。客户端不再构建或维护本地知识索引。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-knowledge-ingest
 
 知识 ingest 完全由 Hunter Platform 负责。归档完成时，客户端生成一个确定性 ZIP；

package/harness/bundles/general/codebuddy/harness-knowledge-query/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-knowledge-query
 description: 在规划、实现或排查前，通过 hunter-harness CLI 查询远端项目知识库。远端不可用时直接报告不可用，不建立本地索引或离线回退。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-knowledge-query
 
 项目知识以 Hunter Platform 的服务端索引为唯一真源。客户端只提交查询并消费结果：

package/harness/bundles/general/codebuddy/harness-plan/SKILL.md

@@ -3,7 +3,7 @@ name: harness-plan
 description: 将需求转化为设计文档+实施计划+完整测试场景表，必须在编码前完成。仅当用户显式调用 /harness-plan 或明确要求进入
   Harness 规划阶段时使用；不得因用户描述需求就自动触发。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-pull/SKILL.md

@@ -3,7 +3,7 @@ name: harness-pull
 description: 从 Hunter Platform 下拉配置/规则/架构/指令（及显式来源分支的分支文件恢复）。仅当用户显式调用
   /harness-pull 或明确说'从平台拉取/恢复'时使用；不得自动触发。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-pull — 从 Hunter Platform 下拉与恢复
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-push/SKILL.md

@@ -3,7 +3,7 @@ name: harness-push
 description: 上传本地配置/规则/架构/指令（及显式归档）到 Hunter Platform。仅当用户显式调用 /harness-push
   或明确说'上传到平台'时使用；不得因存在本地修改就自动触发。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-push — 上传到 Hunter Platform
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-review/SKILL.md

@@ -4,7 +4,7 @@ description: 6维度代码审查（架构/安全/规范/兼容/测试/性能）
   .harness/context-index.json）和测试场景表，在隔离上下文运行。仅当用户显式调用 /harness-review 时使用；不得在
   test 结束后自动接续执行。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-run/SKILL.md

@@ -3,7 +3,7 @@ name: harness-run
 description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编译验证），逐变更簇实现计划中的任务。仅当用户显式调用
   /harness-run 时使用；不得因用户提到编码/实现就自动触发，也不得被其他阶段 skill 自动接续。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-submit/SKILL.md

@@ -3,7 +3,7 @@ name: harness-submit
 description: 最终提交封装：验证→中文 commit→提交/推送；worktree 模式含 --no-ff 合并回主分支。仅当用户显式调用
   /harness-submit（或 /harness-merge 重入合并段）时使用；用户口头说'提交/commit/push'时必须先确认，不得自动触发。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-sync/SKILL.md

@@ -4,7 +4,7 @@ description: Use when the user asks to synchronize, refresh, or validate Harness
   metadata, adapters, remote knowledge ownership, instruction entrypoints,
   config origins, or CodeGraph status.
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-sync
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-test/SKILL.md

@@ -3,7 +3,7 @@ name: harness-test
 description: 测试执行：读取场景表，执行单元测试+API接口测试+数据兼容验证，输出测试报告。仅当用户显式调用 /harness-test
   时使用；不得在 run 结束后自动接续执行。
 ---
-<!-- generated by harness_deploy.py; core=24b43afeb4dc4c52; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=24872a7cdba2c8e5; overlay=none; agent=codebuddy; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose

package/harness/bundles/general/codebuddy/scripts/harness_archive.py

@@ -9175,7 +9175,12 @@ def persist_archive_durability(summary_path: Path, durability: dict[str, Any]) -
 
 
 def auto_push_managed_snapshot(project_root: Path) -> dict[str, Any]:
-    """Best-effort upload of rules and Codebase Map through the normal push protocol."""
+    """Best-effort upload of rules, Codebase Map and archive deliverables via remote sync.
+
+    走 `harness-push`（remote-sync）而非 legacy `push`（proposal）。后者写的是
+    project_files_current，不产生分支快照，平台的「分支文件」与「项目资料」两个视图
+    都读不到；归档交付物在那条路上还会被 policy-never 全部跳过。
+    """
     project_root = project_root.resolve()
     credentials = _resolve_archive_remote_credentials(project_root, os.environ)
     if not credentials["configured"]:
@@ -9194,11 +9199,16 @@ def auto_push_managed_snapshot(project_root: Path) -> dict[str, Any]:
             "reasonCode": "MANAGED_SNAPSHOT_UPLOAD_DEFERRED",
             "warning": f"项目规则与架构地图上传已延后：{exc}",
         }
+    # 显式列出五个 scope 而非 `all`：含义固定，不随 `all` 的展开定义漂移。
+    # branch_files 覆盖归档交付物（plans/spec/reports/docs），其余四个覆盖配置、
+    # 规则、架构地图与指令入口。
     command = [
         *launcher,
         "--yes",
         "hunter-harness",
-        "push",
+        "harness-push",
+        "--scope",
+        "config,rules,architecture,instructions,branch_files",
         "--yes",
         "--non-interactive",
         "--json",
@@ -9212,6 +9222,10 @@ def auto_push_managed_snapshot(project_root: Path) -> dict[str, Any]:
             command,
             cwd=str(project_root),
             text=True,
+            # 不指定 encoding 时中文 Windows 会按 cp936 解码 UTF-8，静默损坏 CLI
+            # 的中文输出，并可能让下面的 json.loads 失败。
+            encoding="utf-8",
+            errors="replace",
             stdout=subprocess.PIPE,
             stderr=subprocess.PIPE,
             timeout=180,
@@ -9240,22 +9254,26 @@ def auto_push_managed_snapshot(project_root: Path) -> dict[str, Any]:
             "reasonCode": "MANAGED_SNAPSHOT_UPLOAD_FAILED",
             "detail": detail[-2_048:],
             "warning": (
-                "项目规则与架构地图未能同步到平台（plan/spec 也随这条推送上传）；"
-                "归档不受影响，稍后可运行 npx hunter-harness push --yes --non-interactive 重试。"
+                "项目规则与架构地图未能同步到平台（归档 plan/spec/report 也随这条推送上传）；"
+                "归档不受影响，稍后可运行 npx hunter-harness harness-push "
+                "--scope config,rules,architecture,instructions,branch_files "
+                "--yes --non-interactive 重试。"
             ),
         }
         cli_code = output.get("code") or output.get("reason_code") if isinstance(output, dict) else None
         if isinstance(cli_code, str) and cli_code:
             failure["cliCode"] = cli_code
         return failure
+    # harness-push 的回执用 summary.applied 计已落盘的操作数（legacy push 用 submitted）。
     summary = output.get("summary")
-    submitted = summary.get("submitted", 0) if isinstance(summary, dict) else 0
+    applied = summary.get("applied", 0) if isinstance(summary, dict) else 0
     return {
         "ok": bool(output.get("ok", True)),
         "skipped": False,
         "projectId": output.get("project_id"),
-        "submitted": submitted if isinstance(submitted, int) else 0,
-        "unchanged": "MANAGED_SNAPSHOT_UNCHANGED" in output.get("warnings", []),
+        "submitted": applied if isinstance(applied, int) else 0,
+        # 无变更时 harness-push 直接短路为 no_changes，不产生快照——即"仅在有更新时推送"。
+        "unchanged": output.get("outcome") == "no_changes",
     }
 
 

package/harness/bundles/general/codex/.harness-build.json

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "codex",
-  "coreHash": "2149c9c4851b4fb4"
+  "coreHash": "38a69f76225f5fab"
 }

package/harness/bundles/general/codex/harness-archive/SKILL.md

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到 .harness/archive/，含归档元数据。仅当用户显式调用
   /harness-archive 时使用；不得被其他阶段 skill 自动接续触发。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose
@@ -203,11 +203,17 @@ git 命令通过 `powershell.exe -Command "..."` 执行；archive-meta.md 和 su
 | 上传 | 载什么 | 结果在哪 |
 |------|--------|---------|
 | `steps.archive_push` | 归档 ZIP（核心产物） | `archiveId`/`archiveStatus`/`uploadStatus`/`knowledgeStatus`，同时落盘 `state/local/archive-packages/<cn>.remote.json` |
-| `steps.managed_snapshot_push` | **plan/spec 文档、`.harness/codebase` 架构地图、`.harness/rules`**（push 会 walk 每个归档目录的 `spec/` 与 `plans/`） | `ok`/`reasonCode`/`exitCode`/`cliCode`/`detail` |
+| `steps.managed_snapshot_push` | **归档交付物（每个变更目录的 `plans/`、`spec/`、`docs/` 全部，`reports/` 只取 `final/` 定稿）、`.harness/codebase` 架构地图、`.harness/rules`、`.harness/project.yaml`、指令入口** | `ok`/`reasonCode`/`exitCode`/`cliCode`/`detail` |
+
+走 `harness-push`（remote-sync，产生分支快照）而非 legacy `push`（proposal 管道）。
+归档目录下的 `runtime/`、`meta/`、`evidence/`、`logs/`、`fixback/`、`.publication-staging/`
+等过程文件不上传；`reports/review/` 与 `reports/test/` 同样是过程产物，不上传——
+这条边界与归档 ZIP 的包内容边界一致。交付物目录里的 `*.log`、`*.tmp`、凭证与 `.env*`
+也仍被安全规则拦下。
 
 ```
 远端归档：arc_3ff325bb…（archiveStatus=durable，uploadStatus=ready，knowledgeStatus=ready，8 文件）
-受管快照：❌ MANAGED_SNAPSHOT_UPLOAD_FAILED（exitCode=1，detail=…）→ plan/spec 与规则/架构地图未上平台，需 npx hunter-harness push --yes --non-interactive 重试
+受管快照：❌ MANAGED_SNAPSHOT_UPLOAD_FAILED（exitCode=1，detail=…）→ 归档 plan/spec/report 与规则/架构地图未上平台，需 npx hunter-harness harness-push --scope config,rules,architecture,instructions,branch_files --yes --non-interactive 重试
 ```
 
 **第二条尤其不能省**：它是 best-effort，失败不阻断归档，于是最容易被淹没成一句警告——而平台上"分支文件里没有 plan/spec"正是它失败的后果。成功时也要写明 `submitted` 数量；`ok=false` 时必须带上 `reasonCode` 与 `detail`，不得省略或写成"已完成"。

package/harness/bundles/general/codex/harness-codebase-map/SKILL.md

@@ -3,7 +3,7 @@ name: harness-codebase-map
 description: 分析现有代码库并生成 .harness/codebase/map/
   下的结构化代码库地图。用于陌生项目理解、重大改造前梳理、harness-sync 提示 map 过期后的人工刷新。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/bundles/general/codex/harness-knowledge-ingest/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-knowledge-ingest
 description: 确认归档 ZIP 已上传并由 Hunter Platform 在服务端解包、校验和入库。客户端不再构建或维护本地知识索引。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-knowledge-ingest
 
 知识 ingest 完全由 Hunter Platform 负责。归档完成时，客户端生成一个确定性 ZIP；

package/harness/bundles/general/codex/harness-knowledge-query/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-knowledge-query
 description: 在规划、实现或排查前，通过 hunter-harness CLI 查询远端项目知识库。远端不可用时直接报告不可用，不建立本地索引或离线回退。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-knowledge-query
 
 项目知识以 Hunter Platform 的服务端索引为唯一真源。客户端只提交查询并消费结果：

package/harness/bundles/general/codex/harness-plan/SKILL.md

@@ -3,7 +3,7 @@ name: harness-plan
 description: 将需求转化为设计文档+实施计划+完整测试场景表，必须在编码前完成。仅当用户显式调用 /harness-plan 或明确要求进入
   Harness 规划阶段时使用；不得因用户描述需求就自动触发。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

package/harness/bundles/general/codex/harness-pull/SKILL.md

@@ -3,7 +3,7 @@ name: harness-pull
 description: 从 Hunter Platform 下拉配置/规则/架构/指令（及显式来源分支的分支文件恢复）。仅当用户显式调用
   /harness-pull 或明确说'从平台拉取/恢复'时使用；不得自动触发。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-pull — 从 Hunter Platform 下拉与恢复
 
 ## Purpose

package/harness/bundles/general/codex/harness-push/SKILL.md

@@ -3,7 +3,7 @@ name: harness-push
 description: 上传本地配置/规则/架构/指令（及显式归档）到 Hunter Platform。仅当用户显式调用 /harness-push
   或明确说'上传到平台'时使用；不得因存在本地修改就自动触发。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-push — 上传到 Hunter Platform
 
 ## Purpose

package/harness/bundles/general/codex/harness-review/SKILL.md

@@ -4,7 +4,7 @@ description: 6维度代码审查（架构/安全/规范/兼容/测试/性能）
   .harness/context-index.json）和测试场景表，在隔离上下文运行。仅当用户显式调用 /harness-review 时使用；不得在
   test 结束后自动接续执行。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

package/harness/bundles/general/codex/harness-run/SKILL.md

@@ -3,7 +3,7 @@ name: harness-run
 description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编译验证），逐变更簇实现计划中的任务。仅当用户显式调用
   /harness-run 时使用；不得因用户提到编码/实现就自动触发，也不得被其他阶段 skill 自动接续。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose

package/harness/bundles/general/codex/harness-submit/SKILL.md

@@ -3,7 +3,7 @@ name: harness-submit
 description: 最终提交封装：验证→中文 commit→提交/推送；worktree 模式含 --no-ff 合并回主分支。仅当用户显式调用
   /harness-submit（或 /harness-merge 重入合并段）时使用；用户口头说'提交/commit/push'时必须先确认，不得自动触发。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

package/harness/bundles/general/codex/harness-sync/SKILL.md

@@ -4,7 +4,7 @@ description: Use when the user asks to synchronize, refresh, or validate Harness
   metadata, adapters, remote knowledge ownership, instruction entrypoints,
   config origins, or CodeGraph status.
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-sync
 
 ## Purpose

package/harness/bundles/general/codex/harness-test/SKILL.md

@@ -3,7 +3,7 @@ name: harness-test
 description: 测试执行：读取场景表，执行单元测试+API接口测试+数据兼容验证，输出测试报告。仅当用户显式调用 /harness-test
   时使用；不得在 run 结束后自动接续执行。
 ---
-<!-- generated by harness_deploy.py; core=2149c9c4851b4fb4; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=38a69f76225f5fab; overlay=none; agent=codex; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose