uni-harness 0.1.0 → 0.1.1

package/.claude/skills/harness-init/SKILL.md

@@ -11,6 +11,14 @@ running them.
 
 ## Step 1: Scan
 
+- **Exclude the harness's own files first.** Everything the installer put
+  here — `.claude/`, `.harness/`, `harness/` — is the kit's machinery, not
+  the project. Never let it drive language detection, and never propose the
+  kit's self-test (`harness/tests/test_hooks.sh`) as the project's TEST_CMD:
+  it verifies the harness, not the user's code, and pointing the stop gate
+  at it would "pass" every turn regardless of what broke. If no project
+  code exists outside those directories yet, say so and leave the commands
+  blank until there is something real to verify.
 - Language/version: from manifests (package.json, pyproject.toml, go.mod,
   Cargo.toml, *.csproj, ...). Prefer versions pinned in lockfiles/config.
 - BUILD / TEST / LINT candidates: collect from manifest scripts, Makefile,

package/bin/cli.js

@@ -27,6 +27,10 @@ const { spawnSync } = require('child_process');
 
 const PKG_ROOT = path.resolve(__dirname, '..');
 const MACHINERY_DIRS = ['.claude/hooks', '.claude/skills', '.claude/agents', 'harness'];
+// Files that live in these dirs but belong to the kit repository only.
+// test_installer.sh tests bin/cli.js, which is never installed into target
+// projects — shipping it there guarantees a failing test suite.
+const KIT_ONLY_FILES = new Set(['harness/tests/test_installer.sh']);
 const MANIFEST = '.harness/kit-manifest.json';
 const KIT_VERSION = require(path.join(PKG_ROOT, 'package.json')).version;
 
@@ -53,7 +57,9 @@ function machineryFiles() {
   const files = [];
   for (const d of MACHINERY_DIRS) {
     for (const f of walk(path.join(PKG_ROOT, d))) {
-      files.push(path.relative(PKG_ROOT, f));
+      const rel = path.relative(PKG_ROOT, f).split(path.sep).join('/');
+      if (KIT_ONLY_FILES.has(rel)) continue;
+      files.push(rel);
     }
   }
   return files.sort();

package/harness/tests/test_installer.sh

@@ -40,6 +40,9 @@ check "writes manifest" "yes" "$([ -f "$TGT/.harness/kit-manifest.json" ] && ech
 check "gitignores logs" ".harness/logs/" "$(cat "$TGT/.gitignore")"
 check "init runs hook tests" "Hook tests passed" "$OUT"
 check "prints next step" "/harness-init" "$OUT"
+# regression: test_installer.sh tests bin/cli.js, which only exists in the
+# npm package — shipping it to targets guarantees a failing suite there
+check "does not ship test_installer.sh" "EMPTY" "$([ -f "$TGT/harness/tests/test_installer.sh" ] && echo left)"
 
 # ── brownfield init: existing project files are preserved ────────
 echo "init (brownfield)"
@@ -82,6 +85,22 @@ check "states owned files untouched" "were not touched" "$OUT"
 OUT=$(node "$CLI" update "$TGT" --force 2>&1)
 check "--force overwrites modifications" "EMPTY" "$(grep -F 'local customization' "$TGT/.claude/hooks/guard-pre-bash.sh" || true)"
 
+# simulate a v0.1.0 install that shipped test_installer.sh: an unmodified
+# manifest-tracked copy must be cleaned up by update
+cp "$ROOT/harness/tests/test_installer.sh" "$TGT/harness/tests/test_installer.sh"
+python3 - "$TGT" <<'EOF'
+import json, sys, hashlib, os
+t = sys.argv[1]
+mp = os.path.join(t, '.harness/kit-manifest.json')
+m = json.load(open(mp))
+p = os.path.join(t, 'harness/tests/test_installer.sh')
+m['files']['harness/tests/test_installer.sh'] = hashlib.sha256(open(p, 'rb').read()).hexdigest()
+json.dump(m, open(mp, 'w'), indent=2)
+EOF
+OUT=$(node "$CLI" update "$TGT" 2>&1)
+check "update removes stale kit-only file" "removed from kit" "$OUT"
+check "stale file is gone" "EMPTY" "$([ -f "$TGT/harness/tests/test_installer.sh" ] && echo left)"
+
 # ── doctor ───────────────────────────────────────────────────────
 echo "doctor"
 OUT=$(node "$CLI" doctor "$TGT" 2>&1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uni-harness",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Agent harness kit for Claude Code — installs verification sensors, destructive-command guards, checkpoint recovery, observability logs, and ratchet skills into your project",
   "bin": {
     "uni-harness": "bin/cli.js"