uni-harness 0.2.0 → 0.2.1

package/bin/cli.js

@@ -180,6 +180,36 @@ function mergeSettings(target) {
   }
 }
 
+// pre-v0.2 checkpoints lived at the project root. Migrate them into
+// .harness/state/, but ONLY files whose content is recognizably the
+// harness's own checkpoint format — a root plan.md may well be the
+// project's own document, and those are never touched.
+function migrateLegacyState(target) {
+  const isOurs = {
+    'progress.json': (s) => {
+      try { const j = JSON.parse(s); return !!j && typeof j === 'object' && 'status' in j && ('task_id' in j || 'next_step' in j); }
+      catch { return false; }
+    },
+    'decisions.jsonl': (s) => {
+      const lines = s.trim().split('\n');
+      return lines.length > 0 && lines.every((l) => {
+        try { return 'decision' in JSON.parse(l); } catch { return false; }
+      });
+    },
+    'plan.md': (s) => /^# Plan:/m.test(s),
+  };
+  for (const [name, test] of Object.entries(isOurs)) {
+    const src = path.join(target, name);
+    const dst = path.join(target, '.harness/state', name);
+    if (!fs.existsSync(src) || fs.existsSync(dst)) continue;
+    let body;
+    try { body = fs.readFileSync(src, 'utf8'); } catch { continue; }
+    if (!test(body)) { log('  ! ' + name + ' left at the root (not in harness checkpoint format)'); continue; }
+    fs.renameSync(src, dst);
+    log('  > ' + name + ' -> .harness/state/' + name + ' (migrated)');
+  }
+}
+
 // ── init ─────────────────────────────────────────────────────────
 function init(target, force) {
   const files = machineryFiles();
@@ -273,6 +303,7 @@ function update(target, force) {
 
   writeManifest(target, files);
   ensureRuntimeDirs(target);
+  migrateLegacyState(target);
   log(`\n${changed} file(s) updated (v${manifest.kitVersion} -> v${KIT_VERSION}). ` +
       'CLAUDE.md / commands.env / settings.json were not touched.');
 
@@ -282,11 +313,11 @@ function update(target, force) {
     const cm = fs.readFileSync(path.join(target, 'CLAUDE.md'), 'utf8');
     if (cm.includes('progress.json') && !cm.includes('.harness/state')) {
       log('\nNote: checkpoint files (plan.md / progress.json / decisions.jsonl)');
-      log('now live in .harness/state/ instead of the project root. Your');
+      log('now live in .harness/state/ instead of the project root. Recognized');
+      log('checkpoint files were migrated automatically (see above). Your');
       log('CLAUDE.md still references the old locations — update its Work Loop');
-      log('and Checkpoints sections, and move any existing checkpoint files');
-      log('into .harness/state/. Until then the SessionStart hook still reads');
-      log('a root progress.json as a fallback.');
+      log('and Checkpoints sections. Until then the SessionStart hook still');
+      log('reads a root progress.json as a fallback.');
     }
   } catch { /* no CLAUDE.md — nothing to migrate */ }
   if (skipped.length) {

package/harness/tests/test_installer.sh

@@ -111,8 +111,16 @@ check "update re-adds state gitignore entry" ".harness/state/" "$(cat "$TGT/.git
 # pre-v0.2 CLAUDE.md pointing checkpoints at the project root -> migration
 # note (told, never touched); the current template must NOT trigger it
 printf '# old project\n- read progress.json first\n' > "$TGT/CLAUDE.md"
+# legacy root checkpoints: harness-format files are migrated, foreign ones kept
+echo '{"task_id":"t1","status":"in_progress","next_step":"do X"}' > "$TGT/progress.json"
+printf '{"ts":"2026-01-01","decision":"use X","why":"y"}\n' > "$TGT/decisions.jsonl"
+printf '# Roadmap\nnot a harness plan\n' > "$TGT/plan.md"
 OUT=$(node "$CLI" update "$TGT" 2>&1)
 check "prints checkpoint migration note" "now live in .harness/state/" "$OUT"
+check "migrates harness-format progress.json" "yes" "$([ -f "$TGT/.harness/state/progress.json" ] && [ ! -f "$TGT/progress.json" ] && echo yes)"
+check "migrates harness-format decisions.jsonl" "yes" "$([ -f "$TGT/.harness/state/decisions.jsonl" ] && echo yes)"
+check "keeps foreign plan.md at the root" "yes" "$([ -f "$TGT/plan.md" ] && [ ! -f "$TGT/.harness/state/plan.md" ] && echo yes)"
+rm -f "$TGT/plan.md" "$TGT/.harness/state/progress.json" "$TGT/.harness/state/decisions.jsonl"
 check "migration note does not edit CLAUDE.md" "# old project" "$(cat "$TGT/CLAUDE.md")"
 cp "$ROOT/CLAUDE.md" "$TGT/CLAUDE.md"   # restore for the doctor section
 OUT=$(node "$CLI" update "$TGT" 2>&1)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uni-harness",
-  "version": "0.2.0",
+  "version": "0.2.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"