@hunter-harness/workflow-harness 0.2.7 → 0.2.8

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "claude-code",
-  "coreHash": "89e664933ed69572"
+  "coreHash": "0d4dcc4204125f4d"
 }

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

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=claude-code; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

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=89e664933ed69572; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=claude-code; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

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

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-ingest
 
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。

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

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; 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 的上下文归属。

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

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

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

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

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

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

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

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; 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=89e664933ed69572; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=claude-code; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose

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

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

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

@@ -172,12 +172,30 @@ def list_active_changes(project_root: Path) -> list[dict[str, Any]]:
                 archived = {}
             if isinstance(archived, dict) and archived.get("status") == "archived":
                 continue
+        has_plan = any((entry / "plans").glob("*-plan.md"))
+        has_context = (entry / CHANGE_CONTEXT_REL).is_file()
+        has_checkpoints = (entry / CHECKPOINTS_REL).is_file()
+        worktree_path = entry / WORKTREE_META_REL
+        has_active_worktree = False
+        if worktree_path.is_file():
+            try:
+                worktree = _read_json(worktree_path)
+                has_active_worktree = isinstance(worktree, dict) and (
+                    worktree.get("created") is True or
+                    worktree.get("requested") is True
+                )
+            except (OSError, json.JSONDecodeError):
+                has_active_worktree = False
+        # Runtime notes, event logs and requested=false worktree metadata can
+        # survive archive/submit cleanup. They are residues, not active changes.
+        if not (has_plan or has_context or has_checkpoints or has_active_worktree):
+            continue
         active.append(
             {
                 "changeId": entry.name,
                 "path": str(entry.resolve()),
-                "hasPlan": (entry / "plans").is_dir(),
-                "hasWorktreeMeta": (entry / WORKTREE_META_REL).is_file(),
+                "hasPlan": has_plan,
+                "hasWorktreeMeta": worktree_path.is_file(),
             }
         )
     return active

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

@@ -106,6 +106,25 @@ def execution_log_path(change_dir: Path) -> Path:
     return change_dir / "logs" / "execution-log.md"
 
 
+def archived_change_dir(change_dir: Path) -> Path | None:
+    """Return the matching archive when change_dir follows the project layout."""
+    changes_root = change_dir.parent
+    harness_root = changes_root.parent
+    if changes_root.name != "changes" or harness_root.name != ".harness":
+        return None
+    archive_root = harness_root / "archive"
+    if not archive_root.is_dir():
+        return None
+    suffix = "-" + change_dir.name
+    matches = sorted(
+        candidate for candidate in archive_root.iterdir()
+        if candidate.is_dir() and (
+            candidate.name == change_dir.name or candidate.name.endswith(suffix)
+        )
+    )
+    return matches[-1] if matches else None
+
+
 def parse_timestamp(value: Any) -> dt.datetime | None:
     if not isinstance(value, str) or not value.strip():
         return None
@@ -620,6 +639,13 @@ def cmd_append(args: argparse.Namespace) -> int:
             as_json=as_json,
         )
     change_dir = resolve_change_dir(args.change_dir)
+    archived = archived_change_dir(change_dir)
+    if archived is not None:
+        return emit_error(
+            "ARCHIVED_CHANGE_IMMUTABLE: refusing to append to archived change "
+            f"{change_dir.name} ({archived})",
+            as_json=as_json,
+        )
     path = events_path(change_dir)
     lock_path = change_dir / "events.ndjson.lock"
 

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "codebuddy",
-  "coreHash": "89e664933ed69572"
+  "coreHash": "0d4dcc4204125f4d"
 }

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

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到
   .harness/archive/，含归档元数据和可视化最终总结。使用场景：归档、完成归档、收尾、打包产出物
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=codebuddy; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

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=89e664933ed69572; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=codebuddy; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-knowledge-ingest
 description: 从 .harness/archive 归档整理、同步和维护项目知识索引。适用场景：ingest knowledge、sync
   knowledge、rebuild knowledge index、promote knowledge、确认知识条目、检查知识库是否过期。
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=codebuddy; do not edit -->
 # harness-knowledge-ingest
 
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。

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

@@ -3,7 +3,7 @@ name: harness-knowledge-query
 description: 根据新需求、设计任务、代码修改请求或问题排查，在规划和编码前查询 .harness/knowledge
   历史上下文。适用场景：query knowledge、查找历史需求、根据归档理解需求、继续之前类似开发、生成需求上下文包。
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=codebuddy; do not edit -->
 # harness-knowledge-query
 
 并行 change 中查询必须传 `--change <change-id>`；成功后以该 change 的 `meta/knowledge-context.json` 为稳定指针。全局 `context-packs/latest.json` 仅向后兼容，不得用于判断多个 active change 的上下文归属。

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

@@ -2,7 +2,7 @@
 name: harness-plan
 description: 将需求转化为设计文档+实施计划+完整测试场景表，必须在编码前完成。使用场景：需求分析、feature plan、技术方案设计、实现方案规划
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=codebuddy; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-review
 description: 6维度代码审查（架构/安全/规范/兼容/测试/性能），对照项目规则（见
   .harness/context-index.json）和测试场景表，在隔离上下文运行。使用场景：代码审查、提交前检查、合并评审
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=codebuddy; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-run
 description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编译验证），逐变更簇实现计划中的任务。使用场景：开始编码、实现功能、写代码、TDD 编码
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; 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
   合并回主分支。使用场景：提交代码、commit、push、合并分支、merge to main、完成开发
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=codebuddy; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-sync
 description: 检查并更新项目AI元数据（CodeGraph索引、harness-codebase-map分析、CLAUDE.md、AGENTS.md、.harness/完整性），确保Claude对代码库的理解与最新代码一致。当用户说'同步/更新索引/刷新元数据/检查一致性'时使用
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=codebuddy; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-test
 description: 测试执行：读取场景表，执行单元测试+API接口测试+数据兼容验证，输出测试报告。当用户说'跑测试/验证/跑用例/接口测试/单元测试'时使用
 ---
-<!-- generated by harness_deploy.py; core=89e664933ed69572; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=0d4dcc4204125f4d; overlay=none; agent=codebuddy; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose

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

@@ -172,12 +172,30 @@ def list_active_changes(project_root: Path) -> list[dict[str, Any]]:
                 archived = {}
             if isinstance(archived, dict) and archived.get("status") == "archived":
                 continue
+        has_plan = any((entry / "plans").glob("*-plan.md"))
+        has_context = (entry / CHANGE_CONTEXT_REL).is_file()
+        has_checkpoints = (entry / CHECKPOINTS_REL).is_file()
+        worktree_path = entry / WORKTREE_META_REL
+        has_active_worktree = False
+        if worktree_path.is_file():
+            try:
+                worktree = _read_json(worktree_path)
+                has_active_worktree = isinstance(worktree, dict) and (
+                    worktree.get("created") is True or
+                    worktree.get("requested") is True
+                )
+            except (OSError, json.JSONDecodeError):
+                has_active_worktree = False
+        # Runtime notes, event logs and requested=false worktree metadata can
+        # survive archive/submit cleanup. They are residues, not active changes.
+        if not (has_plan or has_context or has_checkpoints or has_active_worktree):
+            continue
         active.append(
             {
                 "changeId": entry.name,
                 "path": str(entry.resolve()),
-                "hasPlan": (entry / "plans").is_dir(),
-                "hasWorktreeMeta": (entry / WORKTREE_META_REL).is_file(),
+                "hasPlan": has_plan,
+                "hasWorktreeMeta": worktree_path.is_file(),
             }
         )
     return active

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

@@ -106,6 +106,25 @@ def execution_log_path(change_dir: Path) -> Path:
     return change_dir / "logs" / "execution-log.md"
 
 
+def archived_change_dir(change_dir: Path) -> Path | None:
+    """Return the matching archive when change_dir follows the project layout."""
+    changes_root = change_dir.parent
+    harness_root = changes_root.parent
+    if changes_root.name != "changes" or harness_root.name != ".harness":
+        return None
+    archive_root = harness_root / "archive"
+    if not archive_root.is_dir():
+        return None
+    suffix = "-" + change_dir.name
+    matches = sorted(
+        candidate for candidate in archive_root.iterdir()
+        if candidate.is_dir() and (
+            candidate.name == change_dir.name or candidate.name.endswith(suffix)
+        )
+    )
+    return matches[-1] if matches else None
+
+
 def parse_timestamp(value: Any) -> dt.datetime | None:
     if not isinstance(value, str) or not value.strip():
         return None
@@ -620,6 +639,13 @@ def cmd_append(args: argparse.Namespace) -> int:
             as_json=as_json,
         )
     change_dir = resolve_change_dir(args.change_dir)
+    archived = archived_change_dir(change_dir)
+    if archived is not None:
+        return emit_error(
+            "ARCHIVED_CHANGE_IMMUTABLE: refusing to append to archived change "
+            f"{change_dir.name} ({archived})",
+            as_json=as_json,
+        )
     path = events_path(change_dir)
     lock_path = change_dir / "events.ndjson.lock"
 

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "codex",
-  "coreHash": "7f1ff3afecd38484"
+  "coreHash": "5b2756a71712c9d3"
 }

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

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到
   .harness/archive/，含归档元数据和可视化最终总结。使用场景：归档、完成归档、收尾、打包产出物
 ---
-<!-- generated by harness_deploy.py; core=7f1ff3afecd38484; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=5b2756a71712c9d3; overlay=none; agent=codex; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

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=7f1ff3afecd38484; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=5b2756a71712c9d3; overlay=none; agent=codex; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-knowledge-ingest
 description: 从 .harness/archive 归档整理、同步和维护项目知识索引。适用场景：ingest knowledge、sync
   knowledge、rebuild knowledge index、promote knowledge、确认知识条目、检查知识库是否过期。
 ---
-<!-- generated by harness_deploy.py; core=7f1ff3afecd38484; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=5b2756a71712c9d3; overlay=none; agent=codex; do not edit -->
 # harness-knowledge-ingest
 
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。

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

@@ -3,7 +3,7 @@ name: harness-knowledge-query
 description: 根据新需求、设计任务、代码修改请求或问题排查，在规划和编码前查询 .harness/knowledge
   历史上下文。适用场景：query knowledge、查找历史需求、根据归档理解需求、继续之前类似开发、生成需求上下文包。
 ---
-<!-- generated by harness_deploy.py; core=7f1ff3afecd38484; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=5b2756a71712c9d3; overlay=none; agent=codex; do not edit -->
 # harness-knowledge-query
 
 并行 change 中查询必须传 `--change <change-id>`；成功后以该 change 的 `meta/knowledge-context.json` 为稳定指针。全局 `context-packs/latest.json` 仅向后兼容，不得用于判断多个 active change 的上下文归属。

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

@@ -2,7 +2,7 @@
 name: harness-plan
 description: 将需求转化为设计文档+实施计划+完整测试场景表，必须在编码前完成。使用场景：需求分析、feature plan、技术方案设计、实现方案规划
 ---
-<!-- generated by harness_deploy.py; core=7f1ff3afecd38484; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=5b2756a71712c9d3; overlay=none; agent=codex; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-review
 description: 6维度代码审查（架构/安全/规范/兼容/测试/性能），对照项目规则（见
   .harness/context-index.json）和测试场景表，在隔离上下文运行。使用场景：代码审查、提交前检查、合并评审
 ---
-<!-- generated by harness_deploy.py; core=7f1ff3afecd38484; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=5b2756a71712c9d3; overlay=none; agent=codex; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-run
 description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编译验证），逐变更簇实现计划中的任务。使用场景：开始编码、实现功能、写代码、TDD 编码
 ---
-<!-- generated by harness_deploy.py; core=7f1ff3afecd38484; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=5b2756a71712c9d3; 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
   合并回主分支。使用场景：提交代码、commit、push、合并分支、merge to main、完成开发
 ---
-<!-- generated by harness_deploy.py; core=7f1ff3afecd38484; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=5b2756a71712c9d3; overlay=none; agent=codex; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-sync
 description: 检查并更新项目AI元数据（CodeGraph索引、harness-codebase-map分析、CLAUDE.md、AGENTS.md、.harness/完整性），确保Claude对代码库的理解与最新代码一致。当用户说'同步/更新索引/刷新元数据/检查一致性'时使用
 ---
-<!-- generated by harness_deploy.py; core=7f1ff3afecd38484; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=5b2756a71712c9d3; overlay=none; agent=codex; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-test
 description: 测试执行：读取场景表，执行单元测试+API接口测试+数据兼容验证，输出测试报告。当用户说'跑测试/验证/跑用例/接口测试/单元测试'时使用
 ---
-<!-- generated by harness_deploy.py; core=7f1ff3afecd38484; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=5b2756a71712c9d3; overlay=none; agent=codex; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose

package/harness/bundles/general/codex/scripts/harness_change.py

@@ -172,12 +172,30 @@ def list_active_changes(project_root: Path) -> list[dict[str, Any]]:
                 archived = {}
             if isinstance(archived, dict) and archived.get("status") == "archived":
                 continue
+        has_plan = any((entry / "plans").glob("*-plan.md"))
+        has_context = (entry / CHANGE_CONTEXT_REL).is_file()
+        has_checkpoints = (entry / CHECKPOINTS_REL).is_file()
+        worktree_path = entry / WORKTREE_META_REL
+        has_active_worktree = False
+        if worktree_path.is_file():
+            try:
+                worktree = _read_json(worktree_path)
+                has_active_worktree = isinstance(worktree, dict) and (
+                    worktree.get("created") is True or
+                    worktree.get("requested") is True
+                )
+            except (OSError, json.JSONDecodeError):
+                has_active_worktree = False
+        # Runtime notes, event logs and requested=false worktree metadata can
+        # survive archive/submit cleanup. They are residues, not active changes.
+        if not (has_plan or has_context or has_checkpoints or has_active_worktree):
+            continue
         active.append(
             {
                 "changeId": entry.name,
                 "path": str(entry.resolve()),
-                "hasPlan": (entry / "plans").is_dir(),
-                "hasWorktreeMeta": (entry / WORKTREE_META_REL).is_file(),
+                "hasPlan": has_plan,
+                "hasWorktreeMeta": worktree_path.is_file(),
             }
         )
     return active

package/harness/bundles/general/codex/scripts/harness_events.py

@@ -106,6 +106,25 @@ def execution_log_path(change_dir: Path) -> Path:
     return change_dir / "logs" / "execution-log.md"
 
 
+def archived_change_dir(change_dir: Path) -> Path | None:
+    """Return the matching archive when change_dir follows the project layout."""
+    changes_root = change_dir.parent
+    harness_root = changes_root.parent
+    if changes_root.name != "changes" or harness_root.name != ".harness":
+        return None
+    archive_root = harness_root / "archive"
+    if not archive_root.is_dir():
+        return None
+    suffix = "-" + change_dir.name
+    matches = sorted(
+        candidate for candidate in archive_root.iterdir()
+        if candidate.is_dir() and (
+            candidate.name == change_dir.name or candidate.name.endswith(suffix)
+        )
+    )
+    return matches[-1] if matches else None
+
+
 def parse_timestamp(value: Any) -> dt.datetime | None:
     if not isinstance(value, str) or not value.strip():
         return None
@@ -620,6 +639,13 @@ def cmd_append(args: argparse.Namespace) -> int:
             as_json=as_json,
         )
     change_dir = resolve_change_dir(args.change_dir)
+    archived = archived_change_dir(change_dir)
+    if archived is not None:
+        return emit_error(
+            "ARCHIVED_CHANGE_IMMUTABLE: refusing to append to archived change "
+            f"{change_dir.name} ({archived})",
+            as_json=as_json,
+        )
     path = events_path(change_dir)
     lock_path = change_dir / "events.ndjson.lock"
 

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "cursor",
-  "coreHash": "7ae747a9c129bcc8"
+  "coreHash": "7bc40a6254c830f4"
 }

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

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到
   .harness/archive/，含归档元数据和可视化最终总结。使用场景：归档、完成归档、收尾、打包产出物
 ---
-<!-- generated by harness_deploy.py; core=7ae747a9c129bcc8; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=7bc40a6254c830f4; overlay=none; agent=cursor; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

package/harness/bundles/general/cursor/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=7ae747a9c129bcc8; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=7bc40a6254c830f4; overlay=none; agent=cursor; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-knowledge-ingest
 description: 从 .harness/archive 归档整理、同步和维护项目知识索引。适用场景：ingest knowledge、sync
   knowledge、rebuild knowledge index、promote knowledge、确认知识条目、检查知识库是否过期。
 ---
-<!-- generated by harness_deploy.py; core=7ae747a9c129bcc8; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=7bc40a6254c830f4; overlay=none; agent=cursor; do not edit -->
 # harness-knowledge-ingest
 
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。

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

@@ -3,7 +3,7 @@ name: harness-knowledge-query
 description: 根据新需求、设计任务、代码修改请求或问题排查，在规划和编码前查询 .harness/knowledge
   历史上下文。适用场景：query knowledge、查找历史需求、根据归档理解需求、继续之前类似开发、生成需求上下文包。
 ---
-<!-- generated by harness_deploy.py; core=7ae747a9c129bcc8; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=7bc40a6254c830f4; overlay=none; agent=cursor; do not edit -->
 # harness-knowledge-query
 
 并行 change 中查询必须传 `--change <change-id>`；成功后以该 change 的 `meta/knowledge-context.json` 为稳定指针。全局 `context-packs/latest.json` 仅向后兼容，不得用于判断多个 active change 的上下文归属。

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

@@ -2,7 +2,7 @@
 name: harness-plan
 description: 将需求转化为设计文档+实施计划+完整测试场景表，必须在编码前完成。使用场景：需求分析、feature plan、技术方案设计、实现方案规划
 ---
-<!-- generated by harness_deploy.py; core=7ae747a9c129bcc8; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=7bc40a6254c830f4; overlay=none; agent=cursor; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-review
 description: 6维度代码审查（架构/安全/规范/兼容/测试/性能），对照项目规则（见
   .harness/context-index.json）和测试场景表，在隔离上下文运行。使用场景：代码审查、提交前检查、合并评审
 ---
-<!-- generated by harness_deploy.py; core=7ae747a9c129bcc8; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=7bc40a6254c830f4; overlay=none; agent=cursor; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose