claude-token-saver 2.10.0 → 2.10.2

package/bin/cli.js

@@ -446,12 +446,13 @@ async function main() {
 
   // Subcommand: harness — manage the project's CLAUDE.md harness rules.
   //   claude-token-saver harness init       # write CLAUDE.md (5 sections) + ratchet.md
+  //   claude-token-saver harness uninit     # remove harness block from CLAUDE.md (backup kept)
   //   claude-token-saver harness check      # show 🅷 N/5 + which sections are missing
   //   claude-token-saver harness promote "<rule>"  # append a rule to ratchet.md
   //   claude-token-saver harness off | on   # toggle the statusline 🅷 segment
   if (args[0] === 'harness') {
     const sub = args[1];
-    const { harnessInit, harnessStatus, harnessPromote, findProjectRoot } =
+    const { harnessInit, harnessUninit, harnessStatus, harnessPromote, findProjectRoot } =
       await import('../src/harness.js');
     const { HARNESS_SECTIONS } = await import('../src/harness-templates.js');
     const { loadConfig, saveConfig } = await import('../src/config.js');
@@ -557,6 +558,17 @@ async function main() {
       return;
     }
 
+    if (sub === 'uninit' || sub === 'remove') {
+      const purgeRatchet = args.includes('--purge-ratchet');
+      const r = harnessUninit({ purgeRatchet });
+      console.log(`Project root: ${r.root}`);
+      r.removed.forEach((f) => console.log(`  removed: ${f}`));
+      r.backedUp.forEach((f) => console.log(`  backup:  ${f}`));
+      r.skipped.forEach((f) => console.log(`  skip:    ${f}`));
+      if (r.removed.length === 0) console.log('Nothing to remove.');
+      return;
+    }
+
     if (sub === 'off' || sub === 'on') {
       const cfg = loadConfig();
       cfg.harness = cfg.harness || {};
@@ -567,7 +579,7 @@ async function main() {
     }
 
     console.error(`Unknown harness subcommand: ${sub}`);
-    console.error('Usage: claude-token-saver harness [check|init|promote "<rule>"|off|on]');
+    console.error('Usage: claude-token-saver harness [check|init|uninit [--purge-ratchet]|promote "<rule>"|off|on]');
     process.exit(1);
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-token-saver",
-  "version": "2.10.0",
+  "version": "2.10.2",
   "description": "Save tokens on Claude Code — spike diagnosis, 1M-context detection, TTL countdown, statusline. (formerly claude-cache-monitor)",
   "type": "module",
   "bin": {

package/src/harness.js

@@ -125,15 +125,17 @@ export function harnessInit({ root = findProjectRoot(), force = false } = {}) {
       writeFileSync(cmPath, next);
       result.wrote.push(cmPath + ' (block updated in place)');
     } else {
-      // Backup, then overwrite with the harness block. User-confirmed design:
-      // single CLAUDE.md, backup-then-overwrite (not append) so a clean reset
-      // is always one command away.
+      // Backup as safety net, then APPEND the harness block to existing
+      // content (do not clobber). Users keep all their prior CLAUDE.md content;
+      // the harness block is added at the end and managed in-place on re-runs
+      // via the BEGIN/END markers.
       const stamp = new Date().toISOString().replace(/[:.]/g, '').slice(0, 15); // YYYYMMDDTHHMMSS
       const bak = `${cmPath}.bak-${stamp}`;
       writeFileSync(bak, existing);
-      writeFileSync(cmPath, block);
+      const sep = existing.endsWith('\n') ? '\n' : '\n\n';
+      writeFileSync(cmPath, existing + sep + block);
       result.backedUp.push(bak);
-      result.wrote.push(cmPath);
+      result.wrote.push(cmPath + ' (harness block appended)');
     }
   } else {
     writeFileSync(cmPath, block);
@@ -152,6 +154,54 @@ export function harnessInit({ root = findProjectRoot(), force = false } = {}) {
   return result;
 }
 
+/**
+ * harness uninit — remove the harness block from CLAUDE.md (preserves the
+ * user's other content). A safety backup is written first. ratchet.md is
+ * left intact (user-grown rules) unless `purgeRatchet` is true.
+ *
+ * Returns { removed: [], backedUp: [], skipped: [] }.
+ */
+export function harnessUninit({ root = findProjectRoot(), purgeRatchet = false } = {}) {
+  const cmPath = claudeMdPath(root);
+  const rmPath = ratchetMdPath(root);
+  const result = { removed: [], backedUp: [], skipped: [], root };
+
+  if (existsSync(cmPath)) {
+    const existing = readFileSync(cmPath, 'utf8');
+    if (existing.includes(HARNESS_BLOCK_BEGIN)) {
+      const stamp = new Date().toISOString().replace(/[:.]/g, '').slice(0, 15);
+      const bak = `${cmPath}.bak-${stamp}`;
+      writeFileSync(bak, existing);
+      const re = new RegExp(
+        `\\n*${escapeRe(HARNESS_BLOCK_BEGIN)}[\\s\\S]*?${escapeRe(HARNESS_BLOCK_END)}\\n?`,
+        'm',
+      );
+      const next = existing.replace(re, '').replace(/\n{3,}$/, '\n\n');
+      writeFileSync(cmPath, next);
+      result.backedUp.push(bak);
+      result.removed.push(cmPath + ' (harness block removed)');
+    } else {
+      result.skipped.push(cmPath + ' (no harness block found)');
+    }
+  } else {
+    result.skipped.push(cmPath + ' (does not exist)');
+  }
+
+  if (purgeRatchet && existsSync(rmPath)) {
+    const stamp = new Date().toISOString().replace(/[:.]/g, '').slice(0, 15);
+    const bak = `${rmPath}.bak-${stamp}`;
+    writeFileSync(bak, readFileSync(rmPath, 'utf8'));
+    result.backedUp.push(bak);
+    // Replace with empty initial template rather than delete (preserves dir).
+    writeFileSync(rmPath, harnessRatchetMdInitial());
+    result.removed.push(rmPath + ' (reset to initial)');
+  } else if (existsSync(rmPath)) {
+    result.skipped.push(rmPath + ' (kept; pass --purge-ratchet to reset)');
+  }
+
+  return result;
+}
+
 /**
  * harness promote — append a one-line rule to .claude/ratchet.md.
  * Creates the file from the initial template if missing.