hunter-harness 0.2.16 → 0.2.18

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
   })
@@ -3003,6 +3025,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 +5681,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.18",
   "description": "Local-first, server-governed agent harness",
   "license": "MIT",
   "type": "module",