freeharness 0.4.1

package/dist/cli/uninstall.js

@@ -0,0 +1,147 @@
+// Uninstall: remove only what the install manifest lists. settings.json is never removed
+// (only our two hook entries are pruned from it); the claude-mem plugin cache, its
+// registration files, and the data dir are never touched; empty dirs we created are pruned.
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { manifestPath, readManifest } from "../infra/manifest.js";
+import { dataDir } from "../adapters/memory/doctor.js";
+import { PLUGIN_KEY, UPSTREAM_PLUGIN_NAME } from "../adapters/memory/vendored.js";
+/** Command substrings that identify the hook entries FreeHarness writes into settings.json. */
+export const OUR_HOOK_MARKERS = ["freeharness-session-start", "freeharness-memory-guard", "freeharness-config-guard", "freeharness-repeat-tool", "freeharness-security-guidance", "freeharness-cost-tracker", "freeharness-output-pruner", "freeharness-context-monitor", "freeharness-precompact", "freeharness-auto-memory", "freeharness-converge"];
+/**
+ * Tells whether a hook entry is one FreeHarness wrote.
+ * @param e A settings.json hook entry.
+ * @returns True when any of its commands carries our marker.
+ */
+export function isOurHook(e) {
+    return (e.hooks ?? []).some((h) => OUR_HOOK_MARKERS.some((m) => (h.command ?? "").includes(m)));
+}
+/**
+ * Tells whether a hook entry is an upstream claude-mem wired into settings.json (`npx
+ * claude-mem start ...`); the plugin ships its own hooks.json, so the entry duplicates it.
+ * @param e A settings.json hook entry.
+ * @returns True when a command names claude-mem and the entry is not ours.
+ */
+export function isClaudeMemHook(e) {
+    return !isOurHook(e) && (e.hooks ?? []).some((h) => (h.command ?? "").includes(UPSTREAM_PLUGIN_NAME));
+}
+/**
+ * Removes the hook entries of a settings.json that satisfy a predicate; every other entry
+ * and key is untouched. Emptied events and an emptied `hooks` object are dropped.
+ * @param settingsPath The settings.json.
+ * @param predicate Which entries to remove.
+ * @param dryRun Report only.
+ * @returns Number of entries removed (or that would be); 0 when the file is unreadable.
+ */
+export function pruneHooksMatching(settingsPath, predicate, dryRun) {
+    let settings;
+    try {
+        settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+    }
+    catch {
+        return 0;
+    }
+    if (!settings.hooks)
+        return 0;
+    let removed = 0;
+    for (const [event, entries] of Object.entries(settings.hooks)) {
+        if (!Array.isArray(entries))
+            continue;
+        const keep = entries.filter((e) => !predicate(e));
+        removed += entries.length - keep.length;
+        if (keep.length === 0)
+            delete settings.hooks[event];
+        else
+            settings.hooks[event] = keep;
+    }
+    if (Object.keys(settings.hooks).length === 0)
+        delete settings.hooks;
+    if (removed > 0 && !dryRun)
+        fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), "utf8");
+    return removed;
+}
+/**
+ * Removes FreeHarness hook entries from a settings.json; foreign entries, keys and
+ * `enabledPlugins` are untouched.
+ * @param settingsPath The settings.json.
+ * @param dryRun Report only.
+ * @returns Number of entries removed (or that would be).
+ */
+export function pruneOurHooks(settingsPath, dryRun) {
+    return pruneHooksMatching(settingsPath, isOurHook, dryRun);
+}
+/**
+ * Directories that are ours to prune when empty, bounded by the scope root (never
+ * removed itself).
+ * @param scope user | project.
+ * @param projectRoot Project root.
+ * @returns The boundary directory.
+ */
+function pruneBoundary(scope, projectRoot) {
+    return scope === "user" ? path.join(os.homedir(), ".claude") : projectRoot;
+}
+/**
+ * Runs (or previews) an uninstall for a scope.
+ * @param scope user | project.
+ * @param projectRoot Project root (project scope).
+ * @param dryRun Compute the plan without deleting anything.
+ * @returns The plan; undefined when no manifest exists.
+ */
+export function uninstallScope(scope, projectRoot, dryRun) {
+    const file = manifestPath(scope, projectRoot);
+    const manifest = readManifest(file);
+    if (!manifest)
+        return undefined;
+    const plan = { manifest: file, remove: [], missing: [], kept: [], settings: [], prunedDirs: [] };
+    const claudeDir = path.dirname(path.dirname(file));
+    const pluginsDir = path.join(claudeDir, "plugins") + path.sep;
+    const memData = dataDir() + path.sep;
+    const settingsSeen = new Set();
+    const ordered = manifest.files.filter((f) => f.path !== file).map((f) => f.path);
+    ordered.push(file); // the manifest itself goes last
+    for (const p of ordered) {
+        if (path.basename(p) === "settings.json") {
+            settingsSeen.add(p);
+            plan.kept.push({ path: p, reason: "settings.json is never removed; only FreeHarness hook entries are pruned" });
+            continue;
+        }
+        if (p.startsWith(pluginsDir) || (p + path.sep).startsWith(memData)) {
+            plan.kept.push({ path: p, reason: `claude-mem plugin/data: left alone (use \`claude plugin uninstall ${PLUGIN_KEY}\`)` });
+            continue;
+        }
+        if (!fs.existsSync(p)) {
+            plan.missing.push(p);
+            continue;
+        }
+        if (fs.statSync(p).isDirectory()) {
+            plan.kept.push({ path: p, reason: "directory entry; only files are removed" });
+            continue;
+        }
+        plan.remove.push(p);
+    }
+    // Our hook entries live in the scope's settings.json even when it was never listed.
+    settingsSeen.add(path.join(claudeDir, "settings.json"));
+    for (const s of settingsSeen) {
+        if (fs.existsSync(s) && pruneOurHooks(s, true) > 0)
+            plan.settings.push(s);
+    }
+    if (dryRun)
+        return plan;
+    for (const p of plan.remove)
+        fs.rmSync(p, { force: true });
+    for (const s of plan.settings)
+        pruneOurHooks(s, false);
+    const boundary = pruneBoundary(scope, projectRoot);
+    const candidates = new Set(plan.remove.map((p) => path.dirname(p)));
+    for (let dir of [...candidates].sort((a, b) => b.length - a.length)) {
+        while (dir.startsWith(boundary + path.sep) && dir !== boundary) {
+            if (!fs.existsSync(dir) || fs.readdirSync(dir).length > 0)
+                break;
+            fs.rmdirSync(dir);
+            plan.prunedDirs.push(dir);
+            dir = path.dirname(dir);
+        }
+    }
+    return plan;
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Whether a project CLAUDE.md still carries template placeholders (`<text with spaces>` or
+ * `<dir_name>`); HTML comments and the section tags are not placeholders.
+ * @param text File content.
+ * @returns True when at least one placeholder remains.
+ */
+export declare function hasPlaceholders(text: string): boolean;