@uzysjung/agent-harness 26.131.1 → 26.132.0

package/dist/index.js

@@ -712,7 +712,7 @@ var cac = (name = "") => new CAC(name);
 // package.json
 var package_default = {
   name: "@uzysjung/agent-harness",
-  version: "26.131.1",
+  version: "26.132.0",
   description: "Curate vetted AI-coding skills & plugins by your tech stack \u2014 install only what you need, across Claude Code, Codex, OpenCode & Antigravity",
   type: "module",
   publishConfig: {
@@ -1743,6 +1743,12 @@ import { existsSync as existsSync8, mkdirSync as mkdirSync3, readFileSync as rea
 import { dirname as dirname3, join as join8 } from "path";
 var INSTALL_LOG_FILENAME = ".harness-install.json";
 var INSTALL_LOG_VERSION = 1;
+var POLICY_DIRS = [
+  { dir: "rules", ext: ".md" },
+  { dir: "agents", ext: ".md" },
+  { dir: "commands/uzys", ext: ".md" },
+  { dir: "hooks", ext: ".sh" }
+];
 function buildAssetEntries(report, scope) {
   if (!report) return [];
   return report.attempted.filter((r) => r.ok).map((r) => assetToLogEntry(r.asset, scope, r.version));
@@ -1857,6 +1863,22 @@ function collectSkillHashes(projectDir) {
     sha256: hashContent(readFileSync7(join8(skillsDir, rel), "utf8"))
   }));
 }
+function collectPolicyHashes(projectDir, templatesDir) {
+  const out = [];
+  for (const { dir, ext } of POLICY_DIRS) {
+    const targetDir = join8(projectDir, ".claude", dir);
+    const sourceDir = join8(templatesDir, dir);
+    for (const rel of listFilesRecursive(targetDir)) {
+      if (!rel.endsWith(ext)) continue;
+      if (!existsSync8(join8(sourceDir, rel))) continue;
+      out.push({
+        path: `${dir}/${rel}`,
+        sha256: hashContent(readFileSync7(join8(targetDir, rel), "utf8"))
+      });
+    }
+  }
+  return out;
+}
 function writeInstallLog(projectDir, log) {
   const path = join8(projectDir, ".claude", INSTALL_LOG_FILENAME);
   mkdirSync3(dirname3(path), { recursive: true });
@@ -2167,38 +2189,21 @@ function runUpdateMode(projectDir, templatesDir) {
     pruned: {},
     staleHookRefs: [],
     claudeMdUpdated: false,
-    skillsBackedUp: []
+    skillsBackedUp: [],
+    policyBackedUp: []
   };
-  const targets = [
-    {
-      target: join10(claudeDir, "rules"),
-      source: join10(templatesDir, "rules"),
-      pattern: ".md",
-      label: ".claude/rules"
-    },
-    {
-      target: join10(claudeDir, "agents"),
-      source: join10(templatesDir, "agents"),
-      pattern: ".md",
-      label: ".claude/agents"
-    },
-    {
-      target: join10(claudeDir, "commands/uzys"),
-      source: join10(templatesDir, "commands/uzys"),
-      pattern: ".md",
-      label: ".claude/commands/uzys"
-    },
-    {
-      target: join10(claudeDir, "hooks"),
-      source: join10(templatesDir, "hooks"),
-      pattern: ".sh",
-      label: ".claude/hooks"
-    }
-  ];
-  for (const t of targets) {
-    report.updated[t.label] = updateDir(t.target, t.source, t.pattern);
-    report.pruned[t.label] = pruneOrphans(t.target, t.source, t.pattern);
-  }
+  const policyBase = policyBaseline(projectDir);
+  for (const { dir, ext } of POLICY_DIRS) {
+    const target = join10(claudeDir, dir);
+    const source = join10(templatesDir, dir);
+    const label = `.claude/${dir}`;
+    const ctx = { prefix: dir, baseline: policyBase };
+    const synced = updateDir(target, source, ext, ctx);
+    report.updated[label] = synced.updated;
+    report.policyBackedUp.push(...synced.backedUp);
+    report.pruned[label] = pruneOrphans(target, source, ext, ctx);
+  }
+  refreshPolicyBaseline(projectDir, templatesDir);
   const skillSync = syncSkills(
     join10(claudeDir, "skills"),
     join10(templatesDir, "skills"),
@@ -2219,19 +2224,30 @@ function runUpdateMode(projectDir, templatesDir) {
   }
   return report;
 }
-function updateDir(target, source, ext) {
-  if (!existsSync11(target) || !existsSync11(source)) return 0;
-  let count = 0;
+function isHarnessOwned(ctx, rel, current) {
+  const recorded = ctx.baseline.get(`${ctx.prefix}/${rel}`);
+  return recorded !== void 0 && recorded === hashContent(current);
+}
+function updateDir(target, source, ext, ctx, now = /* @__PURE__ */ new Date()) {
+  if (!existsSync11(target) || !existsSync11(source)) return { updated: 0, backedUp: [] };
+  let updated = 0;
+  const backedUp = [];
   for (const file of readdirSync3(target)) {
     if (!file.endsWith(ext)) continue;
     const targetFile = join10(target, file);
     const sourceFile = join10(source, file);
-    if (existsSync11(sourceFile)) {
-      copyFileSync2(sourceFile, targetFile);
-      count++;
+    if (!existsSync11(sourceFile)) continue;
+    const next = readFileSync10(sourceFile, "utf8");
+    const current = readFileSync10(targetFile, "utf8");
+    if (current === next) continue;
+    if (!isHarnessOwned(ctx, file, current)) {
+      backupFile(targetFile, now);
+      backedUp.push(`${ctx.prefix}/${file}`);
     }
+    writeFileSync8(targetFile, next);
+    updated++;
   }
-  return count;
+  return { updated, backedUp };
 }
 function syncSkills(targetDir, sourceDir, baseline, now = /* @__PURE__ */ new Date()) {
   if (!existsSync11(targetDir) || !existsSync11(sourceDir)) return { updated: 0, backedUp: [] };
@@ -2267,6 +2283,22 @@ function skillBaseline(projectDir) {
   const log = readInstallLog(projectDir);
   return new Map((log?.skillFiles ?? []).map((f) => [f.path, f.sha256]));
 }
+function policyBaseline(projectDir) {
+  const log = readInstallLog(projectDir);
+  return new Map((log?.policyFiles ?? []).map((f) => [f.path, f.sha256]));
+}
+function refreshPolicyBaseline(projectDir, templatesDir) {
+  const log = readInstallLog(projectDir);
+  if (!log) return;
+  const policyFiles = collectPolicyHashes(projectDir, templatesDir);
+  const next = { ...log };
+  if (policyFiles.length > 0) next.policyFiles = policyFiles;
+  else delete next.policyFiles;
+  try {
+    writeInstallLog(projectDir, next);
+  } catch {
+  }
+}
 function refreshSkillBaseline(projectDir) {
   const log = readInstallLog(projectDir);
   if (!log) return;
@@ -2279,7 +2311,7 @@ function refreshSkillBaseline(projectDir) {
   } catch {
   }
 }
-function pruneOrphans(target, source, ext) {
+function pruneOrphans(target, source, ext, ctx, now = /* @__PURE__ */ new Date()) {
   if (!existsSync11(target) || !existsSync11(source)) return [];
   const removed = [];
   for (const file of readdirSync3(target)) {
@@ -2287,7 +2319,10 @@ function pruneOrphans(target, source, ext) {
     const sourceFile = join10(source, file);
     if (!existsSync11(sourceFile)) {
       const targetFile = join10(target, file);
+      if (!ctx.baseline.has(`${ctx.prefix}/${file}`)) continue;
       try {
+        const current = readFileSync10(targetFile, "utf8");
+        if (!isHarnessOwned(ctx, file, current)) backupFile(targetFile, now);
         unlinkSync(targetFile);
         removed.push(file);
       } catch {
@@ -2353,7 +2388,8 @@ function runInstall(ctx) {
     return runUpdateInstall(ctx, templatesDir, backupPath);
   }
   const manifestSpec = buildManifestSpec(spec);
-  const base = spec.cli.includes("claude") ? installClaudeBaseline(manifestSpec, projectDir, templatesDir) : emptyClaudeBaseline();
+  const policyBase = new Map((previousLog?.policyFiles ?? []).map((f) => [f.path, f.sha256]));
+  const base = spec.cli.includes("claude") ? installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBase) : emptyClaudeBaseline();
   const mcpResult = composeAndWriteMcp(harnessRoot, projectDir, spec);
   const ciScaffold = isAssetSelected("ci-scaffold", {
     tracks: spec.tracks,
@@ -2453,7 +2489,21 @@ function emptyClaudeBaseline() {
     backups: []
   };
 }
-function installClaudeBaseline(manifestSpec, projectDir, templatesDir) {
+function backupEditedPolicyFile(entryTarget, target, source, baseline) {
+  const prefix = ".claude/";
+  if (!entryTarget.startsWith(prefix)) return null;
+  const rel = entryTarget.slice(prefix.length);
+  if (!POLICY_DIRS.some(({ dir, ext }) => rel.startsWith(`${dir}/`) && rel.endsWith(ext))) {
+    return null;
+  }
+  if (!existsSync12(target)) return null;
+  const current = readFileSync11(target, "utf-8");
+  if (current === readFileSync11(source, "utf-8")) return null;
+  const recorded = baseline.get(rel);
+  if (recorded !== void 0 && recorded === hashContent(current)) return null;
+  return backupFile(target);
+}
+function installClaudeBaseline(manifestSpec, projectDir, templatesDir, policyBase) {
   ensureProjectSkeleton(projectDir);
   const result = emptyClaudeBaseline();
   const manifest = buildManifest(manifestSpec);
@@ -2473,6 +2523,11 @@ function installClaudeBaseline(manifestSpec, projectDir, templatesDir) {
         if (backup) {
           result.backups.push(backup);
         }
+      } else {
+        const backup = backupEditedPolicyFile(entry.target, target, source, policyBase);
+        if (backup) {
+          result.backups.push(backup);
+        }
       }
       copyFile(source, target);
       result.filesCopied += 1;
@@ -2580,7 +2635,12 @@ function writeInstallLogSafe(ctx, external, rootClaudeMdLog, previousLog, claude
       rootFiles
     );
     const skillFiles = collectSkillHashes(ctx.projectDir);
-    writeInstallLog(ctx.projectDir, skillFiles.length > 0 ? { ...log, skillFiles } : log);
+    const policyFiles = collectPolicyHashes(ctx.projectDir, join11(ctx.harnessRoot, "templates"));
+    writeInstallLog(ctx.projectDir, {
+      ...log,
+      ...skillFiles.length > 0 ? { skillFiles } : {},
+      ...policyFiles.length > 0 ? { policyFiles } : {}
+    });
   } catch (e2) {
     ctx.onProgress?.({
       type: "install-log-error",
@@ -3033,6 +3093,15 @@ function renderPhase1Rows(log, baseline, verbose = false, withEcc = false, claud
         )
       );
     }
+    if (baseline.updateMode.policyBackedUp.length > 0) {
+      log(
+        assetRow(
+          "skip",
+          "edited policy files",
+          `${baseline.updateMode.policyBackedUp.length} backed up as *.backup-<time>`
+        )
+      );
+    }
     if (baseline.updateMode.staleHookRefs.length > 0) {
       log(
         assetRow(