uni-harness 0.1.0

package/harness/tests/test_installer.sh

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# ════════════════════════════════════════════════════════════════
+# CLI installer (bin/cli.js) tests
+# Run: bash harness/tests/test_installer.sh
+# Exercises init → doctor → local-modification protection → update →
+# uninstall in a temp directory, including the brownfield scenario
+# (existing project with its own CLAUDE.md, settings.json, .gitignore).
+# Requires node.
+# ════════════════════════════════════════════════════════════════
+set -u
+
+ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+CLI="$ROOT/bin/cli.js"
+PASS=0
+FAIL=0
+
+check() {
+  local name="$1" expect="$2" actual="$3"
+  if [ "$expect" = "EMPTY" ]; then
+    if [ -z "$actual" ]; then PASS=$((PASS+1)); echo "  ok: $name"
+    else FAIL=$((FAIL+1)); echo "  FAIL: $name — expected empty, got: ${actual:0:120}"; fi
+  else
+    if printf '%s' "$actual" | grep -qF "$expect"; then PASS=$((PASS+1)); echo "  ok: $name"
+    else FAIL=$((FAIL+1)); echo "  FAIL: $name — missing '$expect': ${actual:0:160}"; fi
+  fi
+}
+
+command -v node >/dev/null || { echo "node not found — skipping installer tests."; exit 0; }
+
+# ── greenfield init ──────────────────────────────────────────────
+echo "init (greenfield)"
+TGT=$(mktemp -d)
+OUT=$(node "$CLI" init "$TGT" 2>&1)
+check "installs hooks" "yes" "$([ -f "$TGT/.claude/hooks/stop-gate.sh" ] && echo yes)"
+check "hooks are executable" "yes" "$([ -x "$TGT/.claude/hooks/stop-gate.sh" ] && echo yes)"
+check "installs skills" "yes" "$([ -f "$TGT/.claude/skills/ratchet/SKILL.md" ] && echo yes)"
+check "installs CLAUDE.md" "yes" "$([ -f "$TGT/CLAUDE.md" ] && echo yes)"
+check "installs settings.json" "yes" "$([ -f "$TGT/.claude/settings.json" ] && echo yes)"
+check "writes manifest" "yes" "$([ -f "$TGT/.harness/kit-manifest.json" ] && echo yes)"
+check "gitignores logs" ".harness/logs/" "$(cat "$TGT/.gitignore")"
+check "init runs hook tests" "Hook tests passed" "$OUT"
+check "prints next step" "/harness-init" "$OUT"
+
+# ── brownfield init: existing project files are preserved ────────
+echo "init (brownfield)"
+BF=$(mktemp -d)
+echo "MY PROJECT RULES" > "$BF/CLAUDE.md"
+echo "node_modules/" > "$BF/.gitignore"
+mkdir -p "$BF/.claude"
+cat > "$BF/.claude/settings.json" <<'EOF'
+{
+  "permissions": {"allow": ["Read"]},
+  "hooks": {
+    "PreToolUse": [
+      {"matcher": "Bash", "hooks": [{"type": "command", "command": "./my-own-hook.sh"}]}
+    ]
+  }
+}
+EOF
+OUT=$(node "$CLI" init "$BF" 2>&1)
+check "keeps existing CLAUDE.md" "MY PROJECT RULES" "$(cat "$BF/CLAUDE.md")"
+check "notes CLAUDE.md was kept" "existing CLAUDE.md was kept" "$OUT"
+check "keeps user permissions" '"Read"' "$(cat "$BF/.claude/settings.json")"
+check "keeps user's own hook" "my-own-hook.sh" "$(cat "$BF/.claude/settings.json")"
+check "merges kit hooks in" "stop-gate.sh" "$(cat "$BF/.claude/settings.json")"
+check "appends to existing gitignore" "node_modules/" "$(cat "$BF/.gitignore")"
+check "gitignore gains logs entry" ".harness/logs/" "$(cat "$BF/.gitignore")"
+OUT=$(node "$CLI" init "$BF" 2>&1)
+N=$(grep -c "my-own-hook.sh" "$BF/.claude/settings.json")
+check "merge is idempotent" "1" "$N"
+
+# ── update: refresh unmodified / protect modified ────────────────
+echo "update"
+echo "# local customization" >> "$TGT/.claude/hooks/guard-pre-bash.sh"
+KEEP="$TGT/.claude/hooks/observe-log.sh"
+ORIG_HASH=$(shasum -a 256 "$KEEP" | cut -d' ' -f1)
+OUT=$(node "$CLI" update "$TGT" 2>&1)
+check "skips locally modified file" "guard-pre-bash.sh" "$(printf '%s' "$OUT" | grep '!' || true)"
+check "preserves the local change" "local customization" "$(cat "$TGT/.claude/hooks/guard-pre-bash.sh")"
+check "unmodified files stay current" "$ORIG_HASH" "$(shasum -a 256 "$KEEP" | cut -d' ' -f1)"
+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)"
+
+# ── doctor ───────────────────────────────────────────────────────
+echo "doctor"
+OUT=$(node "$CLI" doctor "$TGT" 2>&1)
+check "diagnosis passes" "Diagnosis passed" "$OUT"
+check "warns on placeholder CLAUDE.md" "warn" "$OUT"
+rm "$TGT/.claude/hooks/stop-gate.sh"
+OUT=$(node "$CLI" doctor "$TGT" 2>&1); RC=$?
+check "detects missing file" "stop-gate.sh" "$(printf '%s' "$OUT" | grep FAIL)"
+check "exit 1 on failure" "1" "$RC"
+node "$CLI" update "$TGT" > /dev/null 2>&1   # restore
+
+# ── uninstall ────────────────────────────────────────────────────
+echo "uninstall"
+OUT=$(node "$CLI" uninstall "$TGT" 2>&1); RC=$?
+check "refuses without --yes" "1" "$RC"
+OUT=$(node "$CLI" uninstall "$TGT" --yes 2>&1)
+check "removes machinery" "EMPTY" "$([ -f "$TGT/.claude/hooks/observe-log.sh" ] && echo left)"
+check "keeps CLAUDE.md" "yes" "$([ -f "$TGT/CLAUDE.md" ] && echo yes)"
+check "keeps settings.json" "yes" "$([ -f "$TGT/.claude/settings.json" ] && echo yes)"
+check "removes manifest" "EMPTY" "$([ -f "$TGT/.harness/kit-manifest.json" ] && echo left)"
+
+# ── refuses to install into the kit repo itself ──────────────────
+OUT=$(node "$CLI" init "$ROOT" 2>&1); RC=$?
+check "refuses self-install" "1" "$RC"
+
+echo
+echo "passed: $PASS, failed: $FAIL"
+[ "$FAIL" -eq 0 ] || exit 1

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "uni-harness",
+  "version": "0.1.0",
+  "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"
+  },
+  "files": [
+    "bin",
+    "CLAUDE.md",
+    ".claude",
+    ".harness/commands.env",
+    "harness",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GAFFWC/uni-harness.git"
+  },
+  "homepage": "https://github.com/GAFFWC/uni-harness#readme",
+  "bugs": {
+    "url": "https://github.com/GAFFWC/uni-harness/issues"
+  },
+  "keywords": [
+    "claude-code",
+    "agent",
+    "harness",
+    "hooks",
+    "ai-coding"
+  ],
+  "license": "MIT"
+}