hunter-harness 0.2.15 → 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

@@ -1566,6 +1566,9 @@ function classifyFile(input) {
   if (under(path, ".harness/knowledge/")) {
     return USER_DIFF;
   }
+  if (/^\.harness\/archive\/[^/]+\/reports\/final\/summary-data\.json$/u.test(path)) {
+    return GENERATED_REVIEWABLE;
+  }
   if (under(path, ".harness/codebase/map/") || path === ".harness/codebase/map-summary.md" || path === ".harness/codebase/map-manifest.json") {
     return GENERATED_REVIEWABLE;
   }
@@ -3000,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) {
@@ -4196,6 +4304,7 @@ var SHARED_MANAGED_FILES = [
   ".harness/project.yaml",
   ".harness/context-index.json"
 ];
+var ARCHIVE_SUMMARY_PATH = /^\.harness\/archive\/[^/]+\/reports\/final\/summary-data\.json$/u;
 async function exists3(path) {
   try {
     await lstat3(path);
@@ -4223,6 +4332,35 @@ async function walkFiles(root, current, output) {
     }
   }
 }
+async function walkArchiveSummaries(root, output) {
+  const archiveRoot = join11(root, ".harness", "archive");
+  if (!await exists3(archiveRoot))
+    return;
+  for (const item2 of await readdir4(archiveRoot, { withFileTypes: true })) {
+    if (item2.isSymbolicLink()) {
+      throw new PushWorkflowError("symlink is not pushable", 6, "UNSAFE_SYMLINK");
+    }
+    if (!item2.isDirectory())
+      continue;
+    const summaryPath = join11(archiveRoot, item2.name, "reports", "final", "summary-data.json");
+    try {
+      const stats = await lstat3(summaryPath);
+      if (stats.isSymbolicLink()) {
+        throw new PushWorkflowError("symlink is not pushable", 6, "UNSAFE_SYMLINK");
+      }
+      if (!stats.isFile())
+        continue;
+    } catch (error) {
+      if (error instanceof Error && "code" in error && error.code === "ENOENT")
+        continue;
+      throw error;
+    }
+    const relativePath = normalizeManagedPath(relative(root, summaryPath).replaceAll("\\", "/"));
+    if (ARCHIVE_SUMMARY_PATH.test(relativePath)) {
+      output.push(relativePath);
+    }
+  }
+}
 function enabledHarnessAgents(project) {
   return project.adapters.enabled.flatMap((agent) => {
     const parsed = harnessAgentSchema.safeParse(agent);
@@ -4260,6 +4398,7 @@ async function managedFiles(projectRoot, project) {
   for (const path of SHARED_MANAGED_ROOTS) {
     await walkFiles(root, join11(root, path), paths);
   }
+  await walkArchiveSummaries(root, paths);
   for (const adapter of adapters) {
     if (adapter.rulesRoot !== null) {
       await walkFiles(root, join11(root, adapter.rulesRoot), paths);
@@ -5520,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.15",
+  "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.