hunter-harness 0.2.16 → 0.2.17

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

@@ -3003,6 +3003,111 @@ async function refreshProject(options) {
     conflicts: sortByTarget(conflicts)
   };
 }
+function freshnessEntry(agent, profile, status, identity) {
+  return { agent, profile, status, identity, driftedFiles: [], missingFiles: [] };
+}
+var BUILD_MARKER_BUNDLE_PATH = ".harness-build.json";
+function buildMarkerCoreHash(text) {
+  if (text === null || text === "")
+    return null;
+  try {
+    const parsed = JSON.parse(text);
+    return typeof parsed.coreHash === "string" && parsed.coreHash.length > 0 ? parsed.coreHash : null;
+  } catch {
+    return null;
+  }
+}
+async function collectFreshness(options) {
+  const root = resolve4(options.projectRoot);
+  const installed = await readInstalledState(root);
+  const codebuddySurface2 = options.codebuddySurface ?? "both";
+  const agents = [];
+  for (const agent of sortHarnessAgents(options.agents)) {
+    const installedProfile = installed.profiles.get(agent) ?? installed.profile;
+    const requestedProfile = options.profile ?? installedProfile ?? "general";
+    const installedManifest = installed.manifests.find((entry) => entry.adapter === agent);
+    const identity = {
+      adapter: agent,
+      bundleVersion: null,
+      installedBundleVersion: installedManifest?.bundle_version ?? null,
+      manifestHash: null,
+      installedManifestHash: installedManifest?.bundle_manifest_hash ?? null,
+      coreHash: null,
+      installedCoreHash: null,
+      adapterHash: null,
+      installedAdapterHash: null
+    };
+    let officialHash = null;
+    let officialVersion = null;
+    let bundle;
+    try {
+      bundle = await loadAgentBundle(options.resourcesRoot, requestedProfile, agent);
+      officialHash = sha256Bytes(canonicalJson(bundle.manifest.files));
+      officialVersion = bundle.manifest.bundle_version;
+      identity.bundleVersion = officialVersion;
+      identity.manifestHash = officialHash;
+      const markerBytes = bundle.files.get(BUILD_MARKER_BUNDLE_PATH);
+      identity.coreHash = markerBytes === void 0 ? null : buildMarkerCoreHash(new TextDecoder().decode(markerBytes));
+    } catch {
+      bundle = null;
+    }
+    if (installed.schemaVersion === null || !installed.adapters.includes(agent) || installedProfile === null || installedProfile === void 0 || installedManifest === void 0 || bundle === null) {
+      agents.push(freshnessEntry(agent, installedProfile ?? null, "UNVERIFIABLE", identity));
+      continue;
+    }
+    const targets = managedTargetsFor(getAdapter(agent), bundle, {
+      profile: installedProfile,
+      codebuddySurface: codebuddySurface2
+    });
+    identity.adapterHash = sha256Bytes(canonicalJson(targets.map((target) => ({ path: target.target_path.replace(/\\/g, "/"), sha256: target.sha256 })).sort((a, b) => a.path.localeCompare(b.path))));
+    const installedProjection = await Promise.all(targets.map(async (target) => ({
+      path: target.target_path.replace(/\\/g, "/"),
+      sha256: await fileHex(join6(root, target.target_path))
+    })));
+    identity.installedAdapterHash = sha256Bytes(canonicalJson(installedProjection.sort((a, b) => a.path.localeCompare(b.path))));
+    const markerTarget = targets.find((target) => target.target_path.replace(/\\/g, "/").endsWith(`/${BUILD_MARKER_BUNDLE_PATH}`) || target.target_path === BUILD_MARKER_BUNDLE_PATH);
+    if (markerTarget !== void 0) {
+      identity.installedCoreHash = buildMarkerCoreHash(await readOptionalText(join6(root, markerTarget.target_path)));
+    }
+    if (requestedProfile !== installedProfile) {
+      agents.push(freshnessEntry(agent, installedProfile, "PROFILE_MISMATCH", identity));
+      continue;
+    }
+    if (installedManifest.bundle_manifest_hash !== officialHash || installedManifest.bundle_version !== officialVersion) {
+      agents.push(freshnessEntry(agent, installedProfile, "VERSION_BEHIND", identity));
+      continue;
+    }
+    const drifted = [];
+    const missing = [];
+    for (const target of targets) {
+      const current = await fileHex(join6(root, target.target_path));
+      if (current === null) {
+        missing.push(target.target_path);
+      } else if (current !== target.sha256) {
+        drifted.push(target.target_path);
+      }
+    }
+    if (missing.length > 0) {
+      const entry = freshnessEntry(agent, installedProfile, "MISSING", identity);
+      entry.missingFiles = missing.sort();
+      entry.driftedFiles = drifted.sort();
+      agents.push(entry);
+      continue;
+    }
+    if (drifted.length > 0) {
+      const entry = freshnessEntry(agent, installedProfile, "LOCALLY_MODIFIED", identity);
+      entry.driftedFiles = drifted.sort();
+      agents.push(entry);
+      continue;
+    }
+    agents.push(freshnessEntry(agent, installedProfile, "CURRENT", identity));
+  }
+  return {
+    schema_version: 1,
+    generated_at: (/* @__PURE__ */ new Date()).toISOString(),
+    agents
+  };
+}
 
 // ../core/dist/proposal/diff.js
 function operationPath(operation) {
@@ -5554,6 +5659,14 @@ async function runRefresh(options, dependencies) {
       forceManaged: options.forceManaged === true
     });
     const output = summarize(result);
+    const freshness = await collectFreshness({
+      projectRoot: dependencies.cwd,
+      resourcesRoot: dependencies.resourcesRoot,
+      ...targetProfile === void 0 ? {} : { profile: targetProfile },
+      agents: targetAgents,
+      codebuddySurface: codebuddySurface(detection.config, options.codebuddySurface)
+    });
+    output.freshness = freshness.agents;
     if (options.json === true) {
       dependencies.stdout(serializeCliResult({ ...output, request_id: requestId }));
     } else {

package/package.json

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

package/LICENSE

@@ -1,21 +0,0 @@
-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.