hunter-harness 0.2.17 → 0.2.19

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hunter Zheng
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -21,8 +21,8 @@ npx hunter-harness update
 | Claude Code | `.claude/skills/` | `.claude/rules/*.md` | `.claude/agents/` |
 | Codex | `.agents/skills/` | `AGENTS.md` | 不生成 |
 | Cursor | `.cursor/skills/` | `.cursor/rules/*.mdc` | 不生成 |
-| CodeBuddy `both` | `.codebuddy/skills/` | `CODEBUDDY.md` + `.codebuddy/.rules/*.mdc` + `.codebuddy/rules/*.md` | `.codebuddy/agents/` |
+| CodeBuddy `both` | `.codebuddy/skills/` | `CODEBUDDY.md` + `.codebuddy/.rules/*.mdc` + `.codebuddy/rules/*.md` | `.codebuddy/agents/` |
 
-需要 Node.js 22.12 或更高版本。选择 CodeBuddy 时，可将已有 `.claude/rules` 非破坏性同步到 CodeBuddy，并在检测到 `.codegraph/` 时合并项目级 `.mcp.json`；疑似凭据内容会跳过。token 只通过 `--token-env` 指定的环境变量读取，不要写入项目文件或命令参数。
+需要 Node.js 22.12 或更高版本。选择 CodeBuddy 时，可将已有 `.claude/rules` 非破坏性同步到 CodeBuddy，并在检测到 `.codegraph/` 时合并项目级 `.mcp.json`；疑似凭据内容会跳过。token 只通过 `--token-env` 指定的环境变量读取，不要写入项目文件或命令参数。
 
-本包使用 MIT License。
+本包使用 MIT License。

package/dist/bin.js

@@ -1929,6 +1929,11 @@ function validateRelativeBundlePath(path) {
     throw new Error("invalid Harness Bundle path");
   }
 }
+function validateChangeId(changeId) {
+  if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(changeId) || changeId === "." || changeId === "..") {
+    throw new Error(`invalid Harness change id: ${changeId}`);
+  }
+}
 function ruleTarget(sourcePath, targetPath, content) {
   return {
     source_path: sourcePath,
@@ -1981,6 +1986,15 @@ function makeAdapter(spec) {
     agentsRoot: spec.agentsRoot,
     commandsRoot: spec.commandsRoot,
     supportsExecutableHooks: false,
+    worktreeFor(changeId) {
+      validateChangeId(changeId);
+      return {
+        root: spec.worktreeRoot,
+        path: `${spec.worktreeRoot}/${changeId}`,
+        branchPrefix: spec.branchPrefix,
+        branch: `${spec.branchPrefix}${changeId}`
+      };
+    },
     projectInstructionTargets() {
       return ["AGENTS.md", ...spec.extraInstructionFiles];
     },
@@ -2032,6 +2046,8 @@ var ADAPTERS = {
     agentsRoot: ".claude/agents",
     commandsRoot: null,
     instructions: "CLAUDE.md",
+    worktreeRoot: ".claude/worktrees",
+    branchPrefix: "claude/",
     extraInstructionFiles: ["CLAUDE.md"],
     ruleExt: ".md"
   }),
@@ -2042,6 +2058,8 @@ var ADAPTERS = {
     agentsRoot: null,
     commandsRoot: null,
     instructions: "AGENTS.md",
+    worktreeRoot: ".codex/worktrees",
+    branchPrefix: "codex/",
     extraInstructionFiles: [],
     ruleExt: null
   }),
@@ -2052,6 +2070,8 @@ var ADAPTERS = {
     agentsRoot: null,
     commandsRoot: ".cursor/commands",
     instructions: "AGENTS.md",
+    worktreeRoot: ".cursor/worktrees",
+    branchPrefix: "cursor/",
     extraInstructionFiles: [],
     ruleExt: ".mdc"
   }),
@@ -2062,6 +2082,8 @@ var ADAPTERS = {
     agentsRoot: ".codebuddy/agents",
     commandsRoot: ".codebuddy/commands",
     instructions: "CODEBUDDY.md",
+    worktreeRoot: ".codebuddy/worktrees",
+    branchPrefix: "codebuddy/",
     extraInstructionFiles: ["CODEBUDDY.md"],
     ruleExt: null
   })
@@ -2693,6 +2715,18 @@ function sortByTarget(items) {
 }
 async function reconcileContextIndex(root, agents, profiles, manifests, codebuddySurface2) {
   const existing = await readOptionalText(join6(root, CONTEXT_INDEX_PATH));
+  let codebase = {
+    map: ".harness/codebase/map",
+    status: "missing"
+  };
+  try {
+    const parsed = JSON.parse(existing);
+    const current = parsed.codebase;
+    if (typeof current?.map === "string" && (current.status === "missing" || current.status === "stale" || current.status === "fresh")) {
+      codebase = { map: current.map, status: current.status };
+    }
+  } catch {
+  }
   const record = {
     schema_version: 2,
     project: {
@@ -2706,7 +2740,7 @@ async function reconcileContextIndex(root, agents, profiles, manifests, codebudd
       ]))
     },
     knowledge: { index: ".harness/knowledge/index.json" },
-    codebase: { map: ".harness/codebase/map", status: "missing" },
+    codebase,
     skill_bundles: Object.fromEntries(manifests.map((manifest) => [
       manifest.adapter,
       { registry_version: manifest.bundle_version, bundle_hash: manifest.bundle_manifest_hash }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hunter-harness",
-  "version": "0.2.17",
+  "version": "0.2.19",
   "description": "Local-first, server-governed agent harness",
   "license": "MIT",
   "type": "module",