@hunter-harness/workflow-harness 0.2.48 → 0.2.50

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "claude-code",
-  "coreHash": "0c6cb544b7c0aef7"
+  "coreHash": "6b900d319d6b6d77"
 }

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=0c6cb544b7c0aef7; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose
@@ -119,6 +119,9 @@ disallowed-tools:
 1. 运行 `python <skills-root>/scripts/harness_archive.py status --change-dir ".harness/changes/<change-name>" --intent release-candidate --json` 前置检查。无 CI 项目若已有完整全量 ledger，先运行 `certify-local`；若用户明确只封存事实，则 status/finalize 均使用 `--intent record-only`。
 2. `meta/archive-meta.md` **由 `harness_archive.py finalize` 自动生成**（与 summary-data `finalStatus` 同源）；**禁止 agent 手写**该文件，手写视为数据丢失。维护者结论写入 events（decision/issue）即可，finalize 会汇总到 summary / archive-meta。
 3. 运行 `python <skills-root>/scripts/harness_archive.py finalize --change-dir ".harness/changes/<change-name>" --archive-root ".harness/archive" --intent <release-candidate|record-only> --json`；读 JSON（cleanup、事件、移动、collect、render、validate、manifest 比对、archive-meta）。finalize 内部负责且仅负责一次 `phase.start` / `phase.end`，调用者不得重复追加。**finalize 不再同步执行知识维护**（§8.2）：它写一个 `pending` maintenance-outbox 项即返回，`knowledgeMaintenance=QUEUED`；写 outbox 失败时 `NOT_QUEUED`（warning，不回滚 archive，总状态 CONDITIONAL）。后续由 `harness-sync` / `harness_knowledge.py maintain` 异步推进 outbox。**finalize 失败或 validate 报错时不删除原目录**。
+   - **平台钩子（best-effort，不阻断归档）**：
+     1. **归档推送（C1）**：有远程凭据时自动 `hunter-harness push` 上传核心+可选辅助档（spec/plans/summary-data/knowledge + `reports/review/*`、`reports/test/*`、`meta/archive-meta.md`、`meta/change-context.json`）。
+     2. **监控终态（C3）**：auto-push 之后自动 `events-sync`，用归档前 change 路径派生的 `run_id` + 原 `change_key` 上报；平台依据 `phase.end`/`archive` 将 run 置为 succeeded/failed（含 `ended_at`）。失败只记 warning。
 
 - **Read `reference.md`** — finalize 输出字段、archive-meta 格式、CONDITIONAL_OK 规则
 - **Read `templates/summary-data-template.json`** — summary-data 数据结构
@@ -135,6 +138,11 @@ disallowed-tools:
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust
 
 ## 关键规则（硬门禁速查）

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=0c6cb544b7c0aef7; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose
@@ -73,6 +73,11 @@ disallowed-tools:
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust · map 额外：文件存在/行数/hash 为证据
 
 ## 关键规则

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

@@ -20,12 +20,21 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=0c6cb544b7c0aef7; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-ingest
 
-从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。
+从 `.harness/archive/**/reports/final/summary-data.json` **本地抽取**知识条目，产物随归档 push 上传；**裁决与投影以平台为准**（远程优先）。本地 SQLite / Agent judge 仅作离线或未连接平台时的回退。
 
-当前实现是本地、离线、无 LLM、无外部服务的 SQLite FTS MVP，已经支持基础生命周期：`candidate`、`stale`、`active`、`superseded`、`conflicted`。按新需求查询历史由独立的 `harness-knowledge-query` 负责。
+> 语言约定：知识条目的 title / summary / body 及一切生成文档优先使用中文（标识符与字段名保持原文）。详见 [[../shared/p0-trust.md|p0-trust]] 的"生成内容语言约定"。
+
+## 远程优先模式（平台连接后）
+
+1. **本地职责**：抽取 candidate 条目 JSON，写入 `.harness/knowledge/entries/**`（及可选本地 index）。
+2. **上传**：条目随 `hunter-harness push` / 归档 finalize 的 auto-push 上传（见归档分级清单：核心含 `knowledge/entries/active|candidate`）。
+3. **平台职责**：服务端 ingest 后自动裁决 status（promote→active 等启发式），并投影到语义知识库；`deprecate` 粘性不被后续 push 覆盖。
+4. **本地 judge / SQLite**：无平台凭据或离线时仍可用；已连接平台时**不要**把本地裁决当作多人共享真源。
+
+未连接平台时，行为退回本地离线 MVP：`candidate` / `stale` / `active` / `superseded` / `conflicted` + SQLite FTS。按新需求查询历史由独立的 `harness-knowledge-query` 负责（默认远程语义搜索，本地索引离线回退）。
 
 ## Triggers
 
@@ -45,13 +54,16 @@ disallowed-tools:
 - `.harness/knowledge/index.json`
 - `.harness/codebase/map-summary.md`（如存在）
 - design.md
+- （可选）`.harness/credentials.local.yaml` — 已连接平台时走远程裁决
 
 ## Purpose
 
 解决两个问题：
 
 1. **整理知识库内容**：把归档里的 `businessGoal`、`changedFiles`、`maintenanceNotes`、`knownRisks`、`manualActions`、`verification`、`reviewSummary` 抽成知识条目。
-2. **维护知识生命周期**：检查索引是否过期，保留 active 条目；高置信 candidate 由 `autoPromote` 自动提升；其余 candidate/conflicted 由 **Agent judge** 闭环裁决，不再默认输出人工待办清单。
+2. **维护知识生命周期**：
+   - **远程优先**：平台 ingest 后裁决并投影；本地只需保证条目 JSON 可上传。
+   - **离线回退**：检查索引是否过期，保留 active；高置信 candidate 由 `autoPromote` 自动提升；其余由 **Agent judge** 闭环裁决。
 
 ## Outputs
 
@@ -251,6 +263,11 @@ powershell.exe -Command "python '<skill-dir>\scripts\harness_knowledge.py' sync
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust · ingest/sync 须绑定 `upToDate`/产物路径证据
 
 ## Output Format

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

@@ -20,14 +20,18 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=0c6cb544b7c0aef7; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-query
 
 并行 change 中查询必须传 `--change <change-id>`；成功后以该 change 的 `meta/knowledge-context.json` 为稳定指针。全局 `context-packs/latest.json` 仅向后兼容，不得用于判断多个 active change 的上下文归属。
 
-根据用户的新需求或排查问题，从项目本地 `.harness/knowledge` 中检索历史需求、决策、实现、风险和测试证据，并生成 AI 可读的 context pack。
+根据用户的新需求或排查问题检索历史需求、决策、实现、风险和测试证据，并生成 AI 可读的 context pack。
 
-此 skill 只负责查询和使用知识。整理、同步和 promote 条目由 `harness-knowledge-ingest` 负责。
+## 远程优先 / 离线回退
+
+1. **默认（已 `hunter-harness connect`）**：优先查询平台语义知识库（与 ingest 上传 + 服务端裁决结果一致）；多机/多人共享同一裁决结果。
+2. **离线回退**：无凭据、网络失败或平台不可用时，回退到本地 `.harness/knowledge`（SQLite FTS / 条目文件）。
+3. 此 skill 只负责查询和使用知识。整理与上传由 `harness-knowledge-ingest` + push/归档负责；**不要**在已连接平台时把本地 promote 当作共享真源。
 
 ## Triggers
 
@@ -42,9 +46,9 @@ disallowed-tools:
 
 ## Automatic Use
 
-当用户提出新功能、改造、排查、设计方案、继续历史任务，且项目存在 `.harness/archive` 或 `.harness/knowledge` 时，AI 应主动运行本 skill，不需要等用户提醒。
+当用户提出新功能、改造、排查、设计方案、继续历史任务，且项目存在平台连接或 `.harness/archive` / `.harness/knowledge` 时，AI 应主动运行本 skill，不需要等用户提醒。
 
-不在 query 前单独执行 sync。`query` 命令内部执行一次 ensure-current：建立一次当前快照，索引新鲜时无操作，过期或缺失时只构建一次，然后在同一调用内完成查询。
+不在 query 前单独执行 sync。`query` 命令内部执行一次 ensure-current：建立一次当前快照，索引新鲜时无操作，过期或缺失时只构建一次，然后在同一调用内完成查询（离线路径）。
 
 ## Commands
 
@@ -56,6 +60,8 @@ disallowed-tools:
 powershell.exe -Command "python '<ingest-skill-dir>\scripts\harness_knowledge.py' query --project '<project-root>' --query '<用户需求原文>'"
 ```
 
+已连接平台时，优先使用平台语义搜索（CLI/`hunter-harness` 知识查询路径，若可用）；上述本地命令作为离线回退。
+
 ### Query with metadata filters
 
 ```powershell
@@ -65,7 +71,7 @@ powershell.exe -Command "python '<ingest-skill-dir>\scripts\harness_knowledge.py
 可重复使用：
 
 - `--file <path>`：只返回关联到指定文件的知识。
-- `--status active|candidate|stale|superseded|conflicted`：按生命周期过滤。
+- `--status active|candidate|stale|superseded|conflicted`：按生命周期过滤（远程路径通常已排除 deprecated）。
 - `--type requirement|decision|implementation|risk|test-evidence|pitfall|api-contract`：按知识类型过滤。
 - `--limit <n>`：限制返回数量。
 
@@ -128,6 +134,11 @@ powershell.exe -Command "python '<ingest-skill-dir>\scripts\harness_knowledge.py
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust · query 成功须含 `contextPack`/`planInput.kind` 与 `latest.json` 写入
 
 ## Output Format

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=0c6cb544b7c0aef7; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose
@@ -101,6 +101,11 @@ change-name 范围变更 → 提示重命名或记 🟡WARN（→ `reference.md`
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust
 
 ## 关键规则

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=0c6cb544b7c0aef7; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose
@@ -125,6 +125,11 @@ review:
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust
 
 ## 关键规则（硬门禁速查）

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=0c6cb544b7c0aef7; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose
@@ -78,7 +78,7 @@ disallowed-tools:
 
 ## Workflow 概要
 
-0. 加载上下文：先 `harness_context.py prepare --phase run --executor <tool> [--change <id>] --json`，以返回的唯一 change/executionRoot/transition receipt 为准（多 active 缺参 → `ACTIVE_CHANGE_AMBIGUOUS`，禁止按 mtime 猜测）；再 **`harness_context.py begin --phase run --change <id> --executor <tool> --json`** 校验 Plan artifact/hash/HEAD，读 spec/plan/detail/scenarios/ledger/run-task-status/worktree；`--fixback` 读 fixback → **`harness_gate.py begin --phase run --change <id>`**（claim + phase.start + identity；禁止手工 Write `events.ndjson` / 手工 `phase.end`）
+0. 加载上下文：先 `harness_context.py prepare --phase run --executor <tool> [--change <id>] --json`，以返回的唯一 change/executionRoot/transition receipt 为准（多 active 缺参 → `ACTIVE_CHANGE_AMBIGUOUS`，禁止按 mtime 猜测）；再 **`harness_context.py begin --phase run --change <id> --executor <tool> --json`** 校验 Plan artifact/hash/HEAD，读 spec/plan/detail/scenarios/ledger/run-task-status/worktree；`--fixback` 读 fixback → **`harness_gate.py begin --phase run --change <id>`**（claim + phase.start + identity；禁止手工 Write `events.ndjson` / 手工 `phase.end`）。**C3 钩子**：`harness_gate.py begin` 在已连接平台时会 best-effort 调用 events-sync（注册 run / `running`）；失败只告警，不阻断 begin。
 0.5. **测试基础设施探测**（先写 `CHECKING`，四项证据齐备后再结论）→ `reference.md` Step 0.5；进入 TDD 前执行 `harness_test_guard.py begin --project . --change-dir ".harness/changes/<cn>" --json`
 1. **变更簇 TDD** — `protocols.md` `run-tdd-protocol`；批量 RED/GREEN；按需 `change-cluster-review-protocol`（高风险 + reviewer 预检可用）
 2. 构建验证 + **仅**通过 `harness_ledger.py record` 写 ledger（禁止 Write/Edit `verification-ledger.json`）；`diff-hash --change-dir` 纳入 ignored tests → `reference.md` Step 2c
@@ -94,6 +94,11 @@ disallowed-tools:
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust
 
 ## 关键规则（硬门禁速查）

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=0c6cb544b7c0aef7; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose
@@ -112,6 +112,11 @@ M7. **ledger + 收尾** — 经 `harness_ledger.py record` 写入 `mergeFinalHas
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust
 
 ## 关键规则（硬门禁速查）

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=0c6cb544b7c0aef7; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
 # harness-sync
 
 ## Purpose
@@ -71,6 +71,11 @@ JSON 报告回显到对话。
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust
 
 ## 执行日志

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=0c6cb544b7c0aef7; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=claude-code; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose
@@ -142,6 +142,11 @@ Runner 强制同项目单实例、低调度优先级、逐命令超时、正常
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust
 
 ## 关键规则（硬门禁速查）

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

@@ -70,6 +70,7 @@ if str(SCRIPTS_DIR) not in sys.path:
     sys.path.insert(0, str(SCRIPTS_DIR))
 
 import harness_events as he  # noqa: E402
+import harness_events_sync as hes  # noqa: E402
 import harness_efficiency as heff  # noqa: E402
 import harness_gate as hgate  # noqa: E402
 import harness_ledger as hl  # noqa: E402
@@ -8284,6 +8285,9 @@ def cmd_finalize(
 
     # Publish only after every validator passes. The archive path is never used
     # as mutable staging, so a failed attempt cannot poison the next retry.
+    # Capture monitoring run_id from the live change path before it is deleted
+    # so archive finalize can report terminal status on the same platform run.
+    monitoring_run_id = hes.run_id_for(original_change_dir)
     try:
         archive_root.mkdir(parents=True, exist_ok=True)
         shutil.move(str(operation_temp_dir), str(archive_dir))
@@ -8368,6 +8372,23 @@ def cmd_finalize(
     if push_result.get("warning"):
         warnings.append(str(push_result["warning"]))
 
+    # C3: best-effort terminal events-sync so platform run ends (succeeded/failed).
+    # Use the pre-delete change-path run_id + original change_key for continuity.
+    try:
+        monitor = hes.auto_events_sync(
+            project_root,
+            archive_dir,
+            run_id=monitoring_run_id,
+            change_key=change_name,
+        )
+        payload["steps"]["platform_events_sync"] = monitor
+        if monitor.get("warning"):
+            warnings.append(str(monitor["warning"]))
+    except Exception as exc:  # noqa: BLE001 — never roll back archive
+        warn = f"events-sync terminal hook failed: {exc}"
+        warnings.append(warn)
+        payload["steps"]["platform_events_sync"] = {"ok": False, "warning": warn}
+
     payload["ok"] = True
     payload["finalStatus"] = "OK"
     payload["warnings"] = warnings
@@ -8387,7 +8408,7 @@ def _remote_credentials_configured(project_root: Path) -> bool:
 
 
 def collect_archive_core_paths(project_root: Path, archive_dir: Path) -> list[str]:
-    """Relative paths for the P4 core four push set."""
+    """Relative paths for the archive push allowlist (core + optional supporting)."""
     root = project_root.resolve()
     archive = archive_dir.resolve()
     paths: list[str] = []
@@ -8403,6 +8424,15 @@ def collect_archive_core_paths(project_root: Path, archive_dir: Path) -> list[st
             for path in sorted(base.rglob("*")):
                 if path.is_file():
                     paths.append(path.relative_to(root).as_posix())
+    # C1 optional supporting files.
+    for folder in (("reports", "review"), ("reports", "test")):
+        base = archive.joinpath(*folder)
+        if base.is_dir():
+            for path in sorted(base.rglob("*")):
+                if path.is_file():
+                    paths.append(path.relative_to(root).as_posix())
+    add_if_exists(archive / "meta" / "archive-meta.md")
+    add_if_exists(archive / "meta" / "change-context.json")
     knowledge = root / ".harness" / "knowledge" / "entries"
     for status in ("active", "candidate"):
         folder = knowledge / status

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

@@ -119,12 +119,19 @@ def post_json(endpoint: dict[str, str], path: str, body: dict[str, Any]) -> dict
         return json.loads(response.read().decode("utf-8"))
 
 
-def sync_change(project: Path, change_dir: Path, *, heartbeat_only: bool = False) -> dict[str, Any]:
+def sync_change(
+    project: Path,
+    change_dir: Path,
+    *,
+    heartbeat_only: bool = False,
+    run_id: str | None = None,
+    change_key: str | None = None,
+) -> dict[str, Any]:
     endpoint = load_endpoint(project)
     if endpoint is None:
         return {"ok": True, "skipped": True, "reason": "remote credentials not configured"}
-    change_key = change_dir.name
-    rid = run_id_for(change_dir)
+    resolved_key = change_key or change_dir.name
+    rid = run_id or run_id_for(change_dir)
     project_id = endpoint["project_id"]
 
     # Always heartbeat so the console can separate connection vs run status.
@@ -138,20 +145,26 @@ def sync_change(project: Path, change_dir: Path, *, heartbeat_only: bool = False
             {
                 "protocol_version": "hunter-progress-sync/v1",
                 "run_id": rid,
-                "change_key": change_key,
+                "change_key": resolved_key,
                 "client_time": client_time,
-                "title": change_key,
+                "title": resolved_key,
             },
         )
     except (urllib.error.URLError, TimeoutError, OSError, json.JSONDecodeError) as exc:
         return {"ok": False, "error": f"heartbeat failed: {exc}", "run_id": rid}
 
     if heartbeat_only:
-        return {"ok": True, "heartbeat": True, "run_id": rid}
+        return {"ok": True, "heartbeat": True, "run_id": rid, "change_key": resolved_key}
 
     events_file = change_dir / "events.ndjson"
     if not events_file.is_file():
-        return {"ok": True, "run_id": rid, "uploaded": 0, "reason": "no events.ndjson"}
+        return {
+            "ok": True,
+            "run_id": rid,
+            "change_key": resolved_key,
+            "uploaded": 0,
+            "reason": "no events.ndjson",
+        }
 
     lines = events_file.read_text(encoding="utf-8").splitlines()
     acked = load_cursor(change_dir)
@@ -167,7 +180,7 @@ def sync_change(project: Path, change_dir: Path, *, heartbeat_only: bool = False
             continue
         if not isinstance(event, dict):
             continue
-        event_id = str(event.get("id") or f"{change_key}:{acked + offset}")
+        event_id = str(event.get("id") or f"{resolved_key}:{acked + offset}")
         payload = sanitize(event)
         batch.append(
             {
@@ -181,7 +194,13 @@ def sync_change(project: Path, change_dir: Path, *, heartbeat_only: bool = False
         )
     if not batch:
         save_cursor(change_dir, len(lines))
-        return {"ok": True, "run_id": rid, "uploaded": 0, "acked_lines": len(lines)}
+        return {
+            "ok": True,
+            "run_id": rid,
+            "change_key": resolved_key,
+            "uploaded": 0,
+            "acked_lines": len(lines),
+        }
 
     # Drop None phase keys for strict schema.
     for item in batch:
@@ -195,8 +214,8 @@ def sync_change(project: Path, change_dir: Path, *, heartbeat_only: bool = False
             {
                 "protocol_version": "hunter-progress-sync/v1",
                 "run_id": rid,
-                "change_key": change_key,
-                "title": change_key,
+                "change_key": resolved_key,
+                "title": resolved_key,
                 "events": batch,
             },
         )
@@ -222,6 +241,7 @@ def sync_change(project: Path, change_dir: Path, *, heartbeat_only: bool = False
     return {
         "ok": accepted == len(batch),
         "run_id": rid,
+        "change_key": resolved_key,
         "uploaded": accepted,
         "batch_size": len(batch),
         "acked_lines": acked_lines,
@@ -229,10 +249,62 @@ def sync_change(project: Path, change_dir: Path, *, heartbeat_only: bool = False
     }
 
 
+def auto_events_sync(
+    project_root: Path,
+    change_dir: Path,
+    *,
+    heartbeat_only: bool = False,
+    run_id: str | None = None,
+    change_key: str | None = None,
+) -> dict[str, Any]:
+    """Best-effort platform events sync (same style as auto_push_archive_core).
+
+    Failures become warnings so the caller never rolls back the main workflow.
+    """
+    project_root = project_root.resolve()
+    change_dir = change_dir.resolve()
+    if load_endpoint(project_root) is None:
+        return {"skipped": True, "reason": "no remote credentials"}
+    try:
+        result = sync_change(
+            project_root,
+            change_dir,
+            heartbeat_only=heartbeat_only,
+            run_id=run_id,
+            change_key=change_key,
+        )
+    except Exception as exc:  # noqa: BLE001 — best-effort never blocks caller
+        return {
+            "skipped": False,
+            "ok": False,
+            "warning": f"events-sync deferred: {exc}",
+        }
+    if result.get("skipped"):
+        return {"skipped": True, "reason": result.get("reason") or "skipped"}
+    if result.get("ok"):
+        return {"skipped": False, "ok": True, **{
+            key: result[key]
+            for key in ("run_id", "change_key", "uploaded", "acked_lines", "heartbeat")
+            if key in result
+        }}
+    return {
+        "skipped": False,
+        "ok": False,
+        "warning": str(result.get("error") or "events-sync failed"),
+        **{
+            key: result[key]
+            for key in ("run_id", "change_key")
+            if key in result
+        },
+    }
+
+
 def main(argv: list[str] | None = None) -> int:
     parser = argparse.ArgumentParser(description="Sync events.ndjson to platform Run monitoring")
     parser.add_argument("--project", default=".", help="Project root")
     parser.add_argument("--change-dir", help="Specific change directory")
+    parser.add_argument("--run-id", help="Override stable run_id (archive finalize continuity)")
+    parser.add_argument("--change-key", help="Override change_key sent to the platform")
     parser.add_argument("--heartbeat-only", action="store_true")
     parser.add_argument("--json", action="store_true")
     args = parser.parse_args(argv)
@@ -243,7 +315,13 @@ def main(argv: list[str] | None = None) -> int:
         root = project / ".harness" / "changes"
         changes = sorted(path for path in root.glob("*") if path.is_dir()) if root.is_dir() else []
     results = [
-        sync_change(project, change_dir, heartbeat_only=args.heartbeat_only)
+        sync_change(
+            project,
+            change_dir,
+            heartbeat_only=args.heartbeat_only,
+            run_id=args.run_id,
+            change_key=args.change_key,
+        )
         for change_dir in changes
     ]
     ok = all(item.get("ok") for item in results) if results else True

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

@@ -31,6 +31,7 @@ if str(SCRIPTS_DIR) not in sys.path:
 
 import harness_change as hc  # noqa: E402
 import harness_events as he  # noqa: E402
+import harness_events_sync as hes  # noqa: E402
 import harness_ledger as hl  # noqa: E402
 import harness_paths as hp  # noqa: E402
 import harness_plan_finalize as hpf  # noqa: E402
@@ -2213,6 +2214,22 @@ def cmd_begin(args: argparse.Namespace) -> int:
         "gateSeverityMode": severity_mode,
         "gateWarnings": gate_warnings,
     }
+    # C3: best-effort start platform run monitoring (register + running via heartbeat/events).
+    try:
+        monitor = hes.auto_events_sync(project, change_dir)
+        payload["platformMonitor"] = monitor
+        if monitor.get("warning"):
+            warnings_msg = str(monitor["warning"])
+            gate_warnings.append({
+                "code": "PLATFORM_EVENTS_SYNC_WARN",
+                "message": warnings_msg,
+            })
+            payload["gateWarnings"] = gate_warnings
+    except Exception as exc:  # noqa: BLE001 — never block phase begin
+        payload["platformMonitor"] = {
+            "ok": False,
+            "warning": f"events-sync hook failed: {exc}",
+        }
     emit(payload, as_json=as_json)
     return 0
 

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "codebuddy",
-  "coreHash": "0c6cb544b7c0aef7"
+  "coreHash": "6b900d319d6b6d77"
 }

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=0c6cb544b7c0aef7; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=6b900d319d6b6d77; overlay=none; agent=codebuddy; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose
@@ -101,6 +101,9 @@ description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档
 1. 运行 `python <skills-root>/scripts/harness_archive.py status --change-dir ".harness/changes/<change-name>" --intent release-candidate --json` 前置检查。无 CI 项目若已有完整全量 ledger，先运行 `certify-local`；若用户明确只封存事实，则 status/finalize 均使用 `--intent record-only`。
 2. `meta/archive-meta.md` **由 `harness_archive.py finalize` 自动生成**（与 summary-data `finalStatus` 同源）；**禁止 agent 手写**该文件，手写视为数据丢失。维护者结论写入 events（decision/issue）即可，finalize 会汇总到 summary / archive-meta。
 3. 运行 `python <skills-root>/scripts/harness_archive.py finalize --change-dir ".harness/changes/<change-name>" --archive-root ".harness/archive" --intent <release-candidate|record-only> --json`；读 JSON（cleanup、事件、移动、collect、render、validate、manifest 比对、archive-meta）。finalize 内部负责且仅负责一次 `phase.start` / `phase.end`，调用者不得重复追加。**finalize 不再同步执行知识维护**（§8.2）：它写一个 `pending` maintenance-outbox 项即返回，`knowledgeMaintenance=QUEUED`；写 outbox 失败时 `NOT_QUEUED`（warning，不回滚 archive，总状态 CONDITIONAL）。后续由 `harness-sync` / `harness_knowledge.py maintain` 异步推进 outbox。**finalize 失败或 validate 报错时不删除原目录**。
+   - **平台钩子（best-effort，不阻断归档）**：
+     1. **归档推送（C1）**：有远程凭据时自动 `hunter-harness push` 上传核心+可选辅助档（spec/plans/summary-data/knowledge + `reports/review/*`、`reports/test/*`、`meta/archive-meta.md`、`meta/change-context.json`）。
+     2. **监控终态（C3）**：auto-push 之后自动 `events-sync`，用归档前 change 路径派生的 `run_id` + 原 `change_key` 上报；平台依据 `phase.end`/`archive` 将 run 置为 succeeded/failed（含 `ended_at`）。失败只记 warning。
 
 - **Read `reference.md`** — finalize 输出字段、archive-meta 格式、CONDITIONAL_OK 规则
 - **Read `templates/summary-data-template.json`** — summary-data 数据结构
@@ -117,6 +120,11 @@ description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档
 - 命令结果不得靠猜测；普通 Bash 被拒 → 立即改用等价 PowerShell 重试一次
 - 仅 PowerShell 成功且有明确证据（构建/git/测试输出、文件存在、exit 0）时可标 ✅OK；否则 ❌FAIL 或 🟡WARN
 - 禁止把 hook 拒绝、静态验证、无输出、用户跳过说成成功 → 详见 [[../protocols/powershell-protocol.md|powershell-protocol]]、[[../protocols/evidence-based-reporting-protocol.md|evidence-based-reporting-protocol]]
+
+## 生成内容语言约定
+
+- sync/ingest 等生成的文档、规则、知识条目、架构说明一律**优先使用中文**撰写（标识符、命令、代码、API 字段名保持原文）
+- 面向平台展示的标题/摘要/正文默认中文；仅当用户明确要求或目标系统强制时才用英文
 > 片段：p0-trust
 
 ## 关键规则（硬门禁速查）