@fenglimg/fabric-cli 2.0.0-rc.1 → 2.0.0-rc.11

package/dist/uninstall-DBAR2JBS.js

@@ -0,0 +1,1082 @@
+#!/usr/bin/env node
+import {
+  detectClientSupports,
+  resolveClients
+} from "./chunk-HQLEHH4O.js";
+import {
+  FABRIC_HOOK_COMMAND_PATHS,
+  HOOK_CONFIG_ARRAY_PATHS,
+  HOOK_CONFIG_TARGETS,
+  HOOK_SCRIPT_DESTINATIONS,
+  IMPORT_POINTER_LINE,
+  POINTER_LINE,
+  POINTER_TARGETS,
+  REVIEW_POINTER_LINE,
+  SKILL_DESTINATIONS
+} from "./chunk-AW3G7ZH5.js";
+import {
+  paint
+} from "./chunk-WWNXR34K.js";
+import {
+  createDebugLogger,
+  resolveDevMode
+} from "./chunk-OBQU6NHO.js";
+import {
+  t
+} from "./chunk-6ICJICVU.js";
+
+// src/commands/uninstall.ts
+import { existsSync as existsSync2, statSync } from "fs";
+import { readdir as readdir2, rm as rm2 } from "fs/promises";
+import { homedir } from "os";
+import { isAbsolute, join as join2, relative, resolve, sep } from "path";
+import { cancel, confirm, group, intro, isCancel, log, note, outro } from "@clack/prompts";
+import { defineCommand } from "citty";
+import { checkLockOrThrow } from "@fenglimg/fabric-server";
+
+// src/install/uninstall-skills-and-hooks.ts
+import { existsSync } from "fs";
+import { readdir, readFile, rm, rmdir } from "fs/promises";
+import { dirname, join } from "path";
+import { atomicWriteJson, atomicWriteText } from "@fenglimg/fabric-shared/node/atomic-write";
+async function uninstallFabricArchiveSkill(projectRoot) {
+  return removeSkill("skill", SKILL_DESTINATIONS.fabricArchive, projectRoot);
+}
+async function uninstallFabricReviewSkill(projectRoot) {
+  return removeSkill("skill-review", SKILL_DESTINATIONS.fabricReview, projectRoot);
+}
+async function uninstallFabricImportSkill(projectRoot) {
+  return removeSkill("skill-import", SKILL_DESTINATIONS.fabricImport, projectRoot);
+}
+async function removeSkill(step, rels, projectRoot) {
+  const results = [];
+  for (const rel of rels) {
+    const target = join(projectRoot, rel);
+    results.push(await rmIfExists(step, target));
+    results.push(await rmDirIfEmpty(`${step}-dir`, dirname(target)));
+  }
+  return results;
+}
+async function removeArchiveHintHook(projectRoot) {
+  return removeHookScripts("hook-script", HOOK_SCRIPT_DESTINATIONS.fabricHint, projectRoot);
+}
+async function removeKnowledgeHintBroadHook(projectRoot) {
+  return removeHookScripts(
+    "hook-broad-script",
+    HOOK_SCRIPT_DESTINATIONS.knowledgeHintBroad,
+    projectRoot
+  );
+}
+async function removeKnowledgeHintNarrowHook(projectRoot) {
+  return removeHookScripts(
+    "hook-narrow-script",
+    HOOK_SCRIPT_DESTINATIONS.knowledgeHintNarrow,
+    projectRoot
+  );
+}
+async function removeHookScripts(step, rels, projectRoot) {
+  const results = [];
+  for (const rel of rels) {
+    const target = join(projectRoot, rel);
+    results.push(await rmIfExists(step, target));
+  }
+  return results;
+}
+async function unmergeClaudeCodeHookConfig(projectRoot, opts = {}) {
+  return unmergeHookConfig({
+    step: "claude-hook-config",
+    projectRoot,
+    configRel: HOOK_CONFIG_TARGETS.claudeCode,
+    arrayPaths: [...HOOK_CONFIG_ARRAY_PATHS.claudeCode],
+    fabricCommands: Object.values(FABRIC_HOOK_COMMAND_PATHS.claudeCode),
+    extractCommands: extractClaudeCommands,
+    cleanEmpties: opts.cleanEmpties === true
+  });
+}
+async function unmergeCodexHookConfig(projectRoot, opts = {}) {
+  return unmergeHookConfig({
+    step: "codex-hook-config",
+    projectRoot,
+    configRel: HOOK_CONFIG_TARGETS.codex,
+    arrayPaths: [...HOOK_CONFIG_ARRAY_PATHS.codex],
+    fabricCommands: Object.values(FABRIC_HOOK_COMMAND_PATHS.codex),
+    extractCommands: extractFlatCommands,
+    cleanEmpties: opts.cleanEmpties === true
+  });
+}
+async function unmergeCursorHookConfig(projectRoot, opts = {}) {
+  return unmergeHookConfig({
+    step: "cursor-hook-config",
+    projectRoot,
+    configRel: HOOK_CONFIG_TARGETS.cursor,
+    arrayPaths: [...HOOK_CONFIG_ARRAY_PATHS.cursor],
+    fabricCommands: Object.values(FABRIC_HOOK_COMMAND_PATHS.cursor),
+    extractCommands: extractFlatCommands,
+    cleanEmpties: opts.cleanEmpties === true
+  });
+}
+async function stripArchiveSkillPointers(projectRoot) {
+  const results = [];
+  for (const rel of POINTER_TARGETS) {
+    const target = join(projectRoot, rel);
+    if (!existsSync(target)) {
+      results.push({ step: "pointer", path: target, status: "skipped", message: "absent" });
+      continue;
+    }
+    let existing;
+    try {
+      existing = await readFile(target, "utf8");
+    } catch (error) {
+      results.push({
+        step: "pointer",
+        path: target,
+        status: "error",
+        message: error instanceof Error ? error.message : String(error)
+      });
+      continue;
+    }
+    const pointerLiterals = [POINTER_LINE, REVIEW_POINTER_LINE, IMPORT_POINTER_LINE];
+    const filtered = existing.split("\n").filter((line) => !pointerLiterals.some((literal) => line.includes(literal))).join("\n");
+    if (filtered === existing) {
+      results.push({
+        step: "pointer",
+        path: target,
+        status: "skipped",
+        message: "no-fabric-pointers"
+      });
+      continue;
+    }
+    try {
+      await atomicWriteText(target, filtered);
+      results.push({ step: "pointer", path: target, status: "removed" });
+    } catch (error) {
+      results.push({
+        step: "pointer",
+        path: target,
+        status: "error",
+        message: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  return results;
+}
+async function uninstallBootstrapStage(projectRoot, opts = {}) {
+  const results = [];
+  await runAndCollect(
+    results,
+    "pointer",
+    projectRoot,
+    () => stripArchiveSkillPointers(projectRoot)
+  );
+  await runAndCollectOne(
+    results,
+    "cursor-hook-config",
+    projectRoot,
+    () => unmergeCursorHookConfig(projectRoot, opts)
+  );
+  await runAndCollectOne(
+    results,
+    "codex-hook-config",
+    projectRoot,
+    () => unmergeCodexHookConfig(projectRoot, opts)
+  );
+  await runAndCollectOne(
+    results,
+    "claude-hook-config",
+    projectRoot,
+    () => unmergeClaudeCodeHookConfig(projectRoot, opts)
+  );
+  await runAndCollect(
+    results,
+    "hook-narrow-script",
+    projectRoot,
+    () => removeKnowledgeHintNarrowHook(projectRoot)
+  );
+  await runAndCollect(
+    results,
+    "hook-broad-script",
+    projectRoot,
+    () => removeKnowledgeHintBroadHook(projectRoot)
+  );
+  await runAndCollect(
+    results,
+    "hook-script",
+    projectRoot,
+    () => removeArchiveHintHook(projectRoot)
+  );
+  await runAndCollect(
+    results,
+    "skill-import",
+    projectRoot,
+    () => uninstallFabricImportSkill(projectRoot)
+  );
+  await runAndCollect(
+    results,
+    "skill-review",
+    projectRoot,
+    () => uninstallFabricReviewSkill(projectRoot)
+  );
+  await runAndCollect(
+    results,
+    "skill",
+    projectRoot,
+    () => uninstallFabricArchiveSkill(projectRoot)
+  );
+  return results;
+}
+async function runAndCollect(results, step, projectRoot, fn) {
+  try {
+    const sub = await fn();
+    results.push(...sub);
+  } catch (error) {
+    results.push({
+      step,
+      path: projectRoot,
+      status: "error",
+      message: error instanceof Error ? error.message : String(error)
+    });
+  }
+}
+async function runAndCollectOne(results, step, projectRoot, fn) {
+  try {
+    results.push(await fn());
+  } catch (error) {
+    results.push({
+      step,
+      path: projectRoot,
+      status: "error",
+      message: error instanceof Error ? error.message : String(error)
+    });
+  }
+}
+async function rmIfExists(step, target) {
+  if (!existsSync(target)) {
+    return { step, path: target, status: "skipped", message: "absent" };
+  }
+  try {
+    await rm(target, { force: true });
+    return { step, path: target, status: "removed" };
+  } catch (error) {
+    return {
+      step,
+      path: target,
+      status: "error",
+      message: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function rmDirIfEmpty(step, target) {
+  if (!existsSync(target)) {
+    return { step, path: target, status: "skipped", message: "absent" };
+  }
+  let entries;
+  try {
+    entries = await readdir(target);
+  } catch (error) {
+    return {
+      step,
+      path: target,
+      status: "error",
+      message: error instanceof Error ? error.message : String(error)
+    };
+  }
+  if (entries.length > 0) {
+    return { step, path: target, status: "skipped", message: "not-empty" };
+  }
+  try {
+    await rmdir(target);
+    return { step, path: target, status: "removed" };
+  } catch (error) {
+    return {
+      step,
+      path: target,
+      status: "error",
+      message: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function unmergeHookConfig(args) {
+  const target = join(args.projectRoot, args.configRel);
+  if (!existsSync(target)) {
+    return { step: args.step, path: target, status: "skipped", message: "absent" };
+  }
+  let raw;
+  try {
+    raw = await readFile(target, "utf8");
+  } catch (error) {
+    return {
+      step: args.step,
+      path: target,
+      status: "error",
+      message: error instanceof Error ? error.message : String(error)
+    };
+  }
+  if (raw.trim().length === 0) {
+    return { step: args.step, path: target, status: "skipped", message: "empty" };
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    return {
+      step: args.step,
+      path: target,
+      status: "error",
+      message: error instanceof Error ? error.message : String(error)
+    };
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    return { step: args.step, path: target, status: "skipped", message: "not-an-object" };
+  }
+  const next = JSON.parse(JSON.stringify(parsed));
+  for (const dotted of args.arrayPaths) {
+    pruneArrayAtPath(next, dotted, args.fabricCommands, args.extractCommands, args.cleanEmpties);
+  }
+  if (jsonEqual(parsed, next)) {
+    return { step: args.step, path: target, status: "skipped", message: "no-fabric-entries" };
+  }
+  try {
+    await atomicWriteJson(target, next, { indent: 2 });
+    return { step: args.step, path: target, status: "removed" };
+  } catch (error) {
+    return {
+      step: args.step,
+      path: target,
+      status: "error",
+      message: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+function pruneArrayAtPath(root, path, fabricCommands, extractCommands, cleanEmpties) {
+  const keys = path.split(".");
+  const chain = [];
+  let cursor = root;
+  for (let i = 0; i < keys.length; i++) {
+    const key = keys[i];
+    if (cursor === null || typeof cursor !== "object" || Array.isArray(cursor)) {
+      return;
+    }
+    const parent = cursor;
+    if (!(key in parent)) {
+      return;
+    }
+    chain.push({ parent, key });
+    cursor = parent[key];
+  }
+  if (!Array.isArray(cursor)) {
+    return;
+  }
+  const filtered = cursor.filter((entry) => {
+    const cmds = extractCommands(entry);
+    if (cmds.length === 0) {
+      return true;
+    }
+    return !cmds.some((cmd) => fabricCommands.some((fabric) => cmd === fabric || cmd.endsWith(fabric)));
+  });
+  const leaf = chain[chain.length - 1];
+  leaf.parent[leaf.key] = filtered;
+  if (!cleanEmpties || filtered.length > 0) {
+    return;
+  }
+  for (let i = chain.length - 1; i >= 0; i--) {
+    const { parent, key } = chain[i];
+    const value = parent[key];
+    const isEmpty = Array.isArray(value) && value.length === 0 || value !== null && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 0;
+    if (!isEmpty) {
+      return;
+    }
+    delete parent[key];
+  }
+}
+function extractClaudeCommands(entry) {
+  if (entry === null || typeof entry !== "object") {
+    return [];
+  }
+  const obj = entry;
+  const inner = obj["hooks"];
+  if (!Array.isArray(inner)) {
+    return [];
+  }
+  const out = [];
+  for (const sub of inner) {
+    if (sub === null || typeof sub !== "object") {
+      continue;
+    }
+    const cmd = sub["command"];
+    if (typeof cmd === "string") {
+      out.push(cmd);
+    }
+  }
+  return out;
+}
+function extractFlatCommands(entry) {
+  if (entry === null || typeof entry !== "object") {
+    return [];
+  }
+  const cmd = entry["command"];
+  return typeof cmd === "string" ? [cmd] : [];
+}
+function jsonEqual(a, b) {
+  return JSON.stringify(a) === JSON.stringify(b);
+}
+
+// src/commands/uninstall.ts
+var UNINSTALL_WIZARD_GROUP_CANCELLED = /* @__PURE__ */ Symbol("uninstall-wizard-group-cancelled");
+var KNOWLEDGE_SUBDIRS = [
+  "decisions",
+  "pitfalls",
+  "guidelines",
+  "models",
+  "processes",
+  "pending"
+];
+var FABRIC_STATE_FILES = ["agents.meta.json", "events.jsonl", "forensic.json"];
+var uninstallCommand = defineCommand({
+  meta: {
+    name: "uninstall",
+    description: t("cli.uninstall.description")
+  },
+  args: {
+    target: {
+      type: "string",
+      description: t("cli.uninstall.args.target.description")
+    },
+    debug: {
+      type: "boolean",
+      description: t("cli.uninstall.args.debug.description"),
+      default: false
+    },
+    force: {
+      type: "boolean",
+      description: t("cli.uninstall.args.force.description"),
+      default: false
+    },
+    yes: {
+      type: "boolean",
+      description: t("cli.uninstall.args.yes.description"),
+      default: false
+    },
+    plan: {
+      type: "boolean",
+      description: t("cli.uninstall.args.plan.description"),
+      default: false
+    },
+    bootstrap: {
+      type: "boolean",
+      default: true,
+      negativeDescription: t("cli.uninstall.flags.no-bootstrap")
+    },
+    mcp: {
+      type: "boolean",
+      default: true,
+      negativeDescription: t("cli.uninstall.flags.no-mcp")
+    },
+    scaffold: {
+      type: "boolean",
+      default: true,
+      negativeDescription: t("cli.uninstall.flags.no-scaffold")
+    },
+    interactive: {
+      type: "boolean",
+      description: t("cli.uninstall.flags.interactive"),
+      default: true
+    },
+    purge: {
+      type: "boolean",
+      description: t("cli.uninstall.flags.purge"),
+      default: false
+    },
+    "clean-empties": {
+      type: "boolean",
+      description: t("cli.uninstall.flags.clean-empties"),
+      default: false
+    }
+  },
+  async run({ args }) {
+    await runUninstallCommand(args);
+  }
+});
+var uninstall_default = uninstallCommand;
+async function runUninstallCommand(args) {
+  const logger = createDebugLogger(args.debug);
+  const resolution = resolveDevMode(args.target, process.cwd());
+  const intent = resolveUninstallCliIntent(args, resolution.target);
+  logger(`uninstall target source: ${resolution.source}`);
+  for (const step of resolution.chain) {
+    logger(step);
+  }
+  checkLockOrThrow(intent.target, { force: args.force });
+  const supports = detectClientSupports(intent.target);
+  const basePlan = await buildUninstallExecutionPlan(intent.target, {
+    ...intent.options
+    // Carry through interactive flag for plan-summary printing.
+  });
+  const planWithSupports = {
+    ...basePlan,
+    interactive: intent.interactiveSummary && !intent.wizardEnabled,
+    supports
+  };
+  const finalPlan = intent.wizardEnabled ? await resolveUninstallExecutionPlanWithWizard(planWithSupports, args, createDefaultUninstallWizardAdapter()) : planWithSupports;
+  if (finalPlan === null) {
+    process.exitCode = 130;
+    return;
+  }
+  if (finalPlan.options.planOnly) {
+    printUninstallPlanPreview(finalPlan);
+    return {
+      plan: finalPlan,
+      stageResults: finalPlan.stages.map((stage) => ({
+        name: stage.name,
+        disposition: "skipped",
+        steps: []
+      }))
+    };
+  }
+  if (intent.interactiveSummary && !intent.wizardEnabled && args.yes !== true && args.force !== true) {
+    const proceed = await confirmDestructive(finalPlan);
+    if (!proceed) {
+      process.exitCode = 130;
+      return;
+    }
+  }
+  const result = await executeUninstallExecutionPlan(finalPlan);
+  printUninstallSummary(result);
+  return result;
+}
+function resolveUninstallCliIntent(args, targetInput) {
+  const target = normalizeTarget(targetInput);
+  const terminalInteractive = isInteractiveUninstall();
+  const planOnly = args.plan === true;
+  const options = {
+    force: args.force,
+    skipBootstrap: args.bootstrap === false,
+    skipMcp: args.mcp === false,
+    skipScaffold: args.scaffold === false,
+    planOnly,
+    purge: args.purge === true,
+    cleanEmpties: args["clean-empties"] === true
+  };
+  return {
+    target,
+    options,
+    interactiveSummary: args.interactive !== false && terminalInteractive,
+    wizardEnabled: shouldUseUninstallWizard(args, terminalInteractive) && !planOnly
+  };
+}
+function shouldUseUninstallWizard(args, terminalInteractive = isInteractiveUninstall()) {
+  return terminalInteractive && args.interactive !== false && args.yes !== true;
+}
+async function buildUninstallExecutionPlan(target, options = {}) {
+  const scaffold = buildUninstallFabricPlan(target, options);
+  const supports = detectClientSupports(target);
+  const stages = [
+    { name: "scaffold", skipped: Boolean(options.skipScaffold) },
+    { name: "bootstrap", skipped: Boolean(options.skipBootstrap) },
+    { name: "mcp", skipped: Boolean(options.skipMcp) }
+  ];
+  return {
+    target,
+    options,
+    interactive: false,
+    supports,
+    scaffold,
+    stages
+  };
+}
+function buildUninstallFabricPlan(target, options = {}) {
+  const absTarget = normalizeTarget(target);
+  const fabricDir = join2(absTarget, ".fabric");
+  const personalKnowledgeDir = resolve(resolvePersonalFabricRoot(), ".fabric", "knowledge");
+  const entries = [];
+  for (const name of FABRIC_STATE_FILES) {
+    const p = join2(fabricDir, name);
+    entries.push({ path: p, kind: "state-file", absent: !existsSync2(p) });
+  }
+  for (const sub of KNOWLEDGE_SUBDIRS) {
+    const gk = join2(fabricDir, "knowledge", sub, ".gitkeep");
+    entries.push({ path: gk, kind: "gitkeep", absent: !existsSync2(gk) });
+  }
+  if (options.purge === true) {
+    for (const sub of KNOWLEDGE_SUBDIRS) {
+      const subdir = join2(fabricDir, "knowledge", sub);
+      entries.push({ path: subdir, kind: "knowledge-subdir", absent: !existsSync2(subdir) });
+    }
+    entries.push({ path: fabricDir, kind: "fabric-dir", absent: !existsSync2(fabricDir) });
+  }
+  const safeEntries = entries.filter((entry) => !isInsidePersonalRoot(entry.path, personalKnowledgeDir));
+  return {
+    target: absTarget,
+    fabricDir,
+    personalKnowledgeDir,
+    options,
+    entries: safeEntries
+  };
+}
+async function executeUninstallFabricPlan(plan) {
+  const results = [];
+  const fabricDirEntry = plan.entries.find((entry) => entry.kind === "fabric-dir");
+  const otherEntries = plan.entries.filter((entry) => entry.kind !== "fabric-dir");
+  for (const entry of otherEntries) {
+    if (entry.absent) {
+      results.push({
+        step: scaffoldStepLabel(entry.kind),
+        path: entry.path,
+        status: "skipped",
+        message: "absent"
+      });
+      continue;
+    }
+    try {
+      await rm2(entry.path, { recursive: entry.kind === "knowledge-subdir", force: true });
+      results.push({ step: scaffoldStepLabel(entry.kind), path: entry.path, status: "removed" });
+    } catch (error) {
+      results.push({
+        step: scaffoldStepLabel(entry.kind),
+        path: entry.path,
+        status: "error",
+        message: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  if (fabricDirEntry !== void 0) {
+    const path = fabricDirEntry.path;
+    if (!existsSync2(path)) {
+      results.push({
+        step: "fabric-dir",
+        path,
+        status: "skipped",
+        message: "absent"
+      });
+    } else {
+      try {
+        const entries = await readdir2(path);
+        if (entries.length > 0) {
+          results.push({
+            step: "fabric-dir",
+            path,
+            status: "skipped",
+            message: "not-empty"
+          });
+        } else {
+          await rm2(path, { recursive: true, force: true });
+          results.push({ step: "fabric-dir", path, status: "removed" });
+        }
+      } catch (error) {
+        results.push({
+          step: "fabric-dir",
+          path,
+          status: "error",
+          message: error instanceof Error ? error.message : String(error)
+        });
+      }
+    }
+  }
+  return results;
+}
+function scaffoldStepLabel(kind) {
+  switch (kind) {
+    case "state-file":
+      return "scaffold-state";
+    case "gitkeep":
+      return "scaffold-gitkeep";
+    case "knowledge-subdir":
+      return "scaffold-knowledge";
+    case "fabric-dir":
+      return "fabric-dir";
+  }
+}
+async function uninstallMcpClients(target, options = {}) {
+  const workspaceRoot = resolve(target);
+  const writers = resolveClients(workspaceRoot, {});
+  const details = [];
+  const results = [];
+  for (const writer of writers) {
+    let configPath;
+    try {
+      configPath = await writer.detect(workspaceRoot);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      details.push({ client: writer.clientKind, status: "error", message });
+      results.push({
+        step: `mcp-${writer.clientKind}`,
+        path: "",
+        status: "error",
+        message
+      });
+      continue;
+    }
+    if (configPath === null) {
+      details.push({ client: writer.clientKind, status: "skipped", message: "no-config-path" });
+      results.push({
+        step: `mcp-${writer.clientKind}`,
+        path: "",
+        status: "skipped",
+        message: "no-config-path"
+      });
+      continue;
+    }
+    if (options.dryRun === true) {
+      details.push({ client: writer.clientKind, status: "dry-run", path: configPath });
+      results.push({
+        step: `mcp-${writer.clientKind}`,
+        path: configPath,
+        status: "skipped",
+        message: "dry-run"
+      });
+      continue;
+    }
+    let removeResult;
+    try {
+      removeResult = await writer.remove("fabric", workspaceRoot);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      details.push({ client: writer.clientKind, status: "error", path: configPath, message });
+      results.push({
+        step: `mcp-${writer.clientKind}`,
+        path: configPath,
+        status: "error",
+        message
+      });
+      continue;
+    }
+    details.push({
+      client: writer.clientKind,
+      status: removeResult.status,
+      path: removeResult.path,
+      message: removeResult.message
+    });
+    results.push({
+      step: `mcp-${writer.clientKind}`,
+      path: removeResult.path ?? configPath,
+      status: removeResult.status === "removed" ? "removed" : removeResult.status === "error" ? "error" : "skipped",
+      message: removeResult.message
+    });
+  }
+  return { details, results };
+}
+async function executeUninstallExecutionPlan(plan) {
+  const stageResults = [];
+  for (const stage of plan.stages) {
+    if (stage.skipped) {
+      stageResults.push({ name: stage.name, disposition: "skipped", steps: [] });
+      continue;
+    }
+    console.log(formatUninstallStageHeader(stage.name));
+    try {
+      const steps = await executeUninstallStage(plan, stage.name);
+      const disposition = steps.some((s) => s.status === "error") ? "failed" : "ran";
+      stageResults.push({ name: stage.name, disposition, steps });
+      console.log(formatUninstallStageResult(stage.name, steps));
+    } catch (error) {
+      stageResults.push({
+        name: stage.name,
+        disposition: "failed",
+        steps: [
+          {
+            step: stage.name,
+            path: plan.target,
+            status: "error",
+            message: error instanceof Error ? error.message : String(error)
+          }
+        ]
+      });
+      writeStderr(formatUninstallStageFailure(stage.name, error));
+    }
+  }
+  return { plan, stageResults };
+}
+async function executeUninstallStage(plan, stageName) {
+  switch (stageName) {
+    case "scaffold":
+      return executeUninstallFabricPlan(plan.scaffold);
+    case "bootstrap": {
+      const opts = { cleanEmpties: plan.options.cleanEmpties === true };
+      return uninstallBootstrapStage(plan.target, opts);
+    }
+    case "mcp": {
+      const { results } = await uninstallMcpClients(plan.target);
+      return results;
+    }
+  }
+}
+async function uninstallFabric(target, options = {}) {
+  const plan = await buildUninstallExecutionPlan(target, options);
+  return executeUninstallExecutionPlan(plan);
+}
+async function resolveUninstallExecutionPlanWithWizard(basePlan, args, wizardAdapter) {
+  const selection = await wizardAdapter.run({
+    target: basePlan.target,
+    options: basePlan.options,
+    supports: basePlan.supports,
+    lockedStages: collectLockedWizardStages(args)
+  });
+  if (selection === null) {
+    return null;
+  }
+  const nextOptions = {
+    ...basePlan.options,
+    skipScaffold: !selection.scaffold,
+    skipBootstrap: !selection.bootstrap,
+    skipMcp: !selection.mcp,
+    purge: selection.purge,
+    cleanEmpties: selection.cleanEmpties
+  };
+  const rebuilt = await buildUninstallExecutionPlan(basePlan.target, nextOptions);
+  return {
+    ...rebuilt,
+    interactive: false,
+    supports: basePlan.supports
+  };
+}
+function createDefaultUninstallWizardAdapter() {
+  return {
+    async run(context) {
+      intro(t("cli.uninstall.wizard.intro"));
+      note(
+        t("cli.uninstall.wizard.overview.body", {
+          target: context.target
+        }),
+        t("cli.uninstall.wizard.overview.title")
+      );
+      printUninstallPlanSummary(context.target, context.options, context.supports);
+      log.step(t("cli.uninstall.wizard.step.target"));
+      const continueWithTarget = await confirm({
+        message: t("cli.uninstall.wizard.target.confirm", { target: context.target }),
+        initialValue: true
+      });
+      if (isCancel(continueWithTarget) || !continueWithTarget) {
+        emitUninstallWizardCancellation();
+        return null;
+      }
+      log.step(t("cli.uninstall.wizard.step.plan"));
+      let groupedSelection;
+      try {
+        groupedSelection = await group(
+          {
+            scaffold: async () => context.lockedStages.includes("scaffold") ? false : confirmInGroup({
+              message: t("cli.uninstall.wizard.stage.scaffold", {
+                defaultValue: formatPromptDefault(!context.options.skipScaffold)
+              }),
+              initialValue: !context.options.skipScaffold
+            }),
+            bootstrap: async () => context.lockedStages.includes("bootstrap") ? false : confirmInGroup({
+              message: t("cli.uninstall.wizard.stage.bootstrap", {
+                defaultValue: formatPromptDefault(!context.options.skipBootstrap)
+              }),
+              initialValue: !context.options.skipBootstrap
+            }),
+            mcp: async () => context.lockedStages.includes("mcp") ? false : confirmInGroup({
+              message: t("cli.uninstall.wizard.stage.mcp", {
+                defaultValue: formatPromptDefault(!context.options.skipMcp)
+              }),
+              initialValue: !context.options.skipMcp
+            }),
+            purge: async () => confirmInGroup({
+              message: t("cli.uninstall.wizard.purge", {
+                defaultValue: formatPromptDefault(context.options.purge === true)
+              }),
+              initialValue: context.options.purge === true
+            }),
+            cleanEmpties: async () => confirmInGroup({
+              message: t("cli.uninstall.wizard.clean-empties", {
+                defaultValue: formatPromptDefault(context.options.cleanEmpties === true)
+              }),
+              initialValue: context.options.cleanEmpties === true
+            })
+          },
+          {
+            onCancel() {
+              throw UNINSTALL_WIZARD_GROUP_CANCELLED;
+            }
+          }
+        );
+      } catch (error) {
+        if (error === UNINSTALL_WIZARD_GROUP_CANCELLED) {
+          emitUninstallWizardCancellation();
+          return null;
+        }
+        throw error;
+      }
+      const previewOptions = {
+        ...context.options,
+        skipScaffold: !groupedSelection.scaffold,
+        skipBootstrap: !groupedSelection.bootstrap,
+        skipMcp: !groupedSelection.mcp,
+        purge: groupedSelection.purge,
+        cleanEmpties: groupedSelection.cleanEmpties
+      };
+      log.step(t("cli.uninstall.wizard.step.review"));
+      printUninstallPlanSummary(context.target, previewOptions, context.supports);
+      const confirmed = await confirm({
+        message: t("cli.uninstall.wizard.execute.confirm"),
+        initialValue: true
+      });
+      if (isCancel(confirmed) || !confirmed) {
+        emitUninstallWizardCancellation();
+        return null;
+      }
+      outro(t("cli.uninstall.wizard.outro"));
+      return groupedSelection;
+    }
+  };
+}
+function emitUninstallWizardCancellation() {
+  cancel(t("cli.uninstall.wizard.cancelled"));
+}
+async function confirmInGroup(options) {
+  const result = await confirm(options);
+  if (isCancel(result)) {
+    throw UNINSTALL_WIZARD_GROUP_CANCELLED;
+  }
+  return result;
+}
+function collectLockedWizardStages(args) {
+  const locked = [];
+  if (args.scaffold === false) locked.push("scaffold");
+  if (args.bootstrap === false) locked.push("bootstrap");
+  if (args.mcp === false) locked.push("mcp");
+  return locked;
+}
+async function confirmDestructive(plan) {
+  printUninstallPlanSummary(plan.target, plan.options, plan.supports);
+  const answer = await confirm({
+    message: t("cli.uninstall.confirm.proceed", { target: plan.target }),
+    initialValue: false
+  });
+  if (isCancel(answer)) {
+    return false;
+  }
+  return answer === true;
+}
+function printUninstallPlanPreview(plan) {
+  console.log(t("cli.uninstall.plan.preview-title"));
+  printUninstallPlanSummary(plan.target, plan.options, plan.supports);
+  console.log(
+    t("cli.uninstall.plan.preview-result", {
+      scaffold: yesNoLabel(!plan.options.skipScaffold),
+      bootstrap: yesNoLabel(!plan.options.skipBootstrap),
+      mcp: yesNoLabel(!plan.options.skipMcp),
+      purge: yesNoLabel(plan.options.purge === true),
+      cleanEmpties: yesNoLabel(plan.options.cleanEmpties === true)
+    })
+  );
+  if (!plan.options.skipScaffold && plan.scaffold.entries.length > 0) {
+    console.log(t("cli.uninstall.plan.scaffold-entries.title"));
+    for (const entry of plan.scaffold.entries) {
+      const marker = entry.absent ? paint.muted("(absent)") : paint.success("(present)");
+      console.log(`  - ${entry.path} ${marker}`);
+    }
+  }
+}
+function printUninstallPlanSummary(target, options, supports) {
+  console.log(t("cli.uninstall.plan.title"));
+  console.log(t("cli.uninstall.plan.target", { target }));
+  console.log(
+    t("cli.uninstall.plan.actions", {
+      scaffold: yesNoLabel(!options.skipScaffold),
+      bootstrap: yesNoLabel(!options.skipBootstrap),
+      mcp: yesNoLabel(!options.skipMcp),
+      purge: yesNoLabel(options.purge === true),
+      cleanEmpties: yesNoLabel(options.cleanEmpties === true)
+    })
+  );
+  const detected = supports.filter((support) => support.detected);
+  console.log(
+    t("cli.uninstall.plan.detected", {
+      clients: detected.length > 0 ? detected.map((support) => support.label).join(", ") : t("cli.shared.none")
+    })
+  );
+  console.log(t("cli.uninstall.plan.preserves"));
+  console.log(`  - ${target}/.fabric/knowledge/  ${paint.muted(t("cli.uninstall.plan.preserves.knowledge"))}`);
+  console.log(`  - ~/.fabric/knowledge/  ${paint.muted(t("cli.uninstall.plan.preserves.personal"))}`);
+}
+function printUninstallSummary(result) {
+  const removed = result.stageResults.flatMap(
+    (stage) => stage.steps.filter((s) => s.status === "removed")
+  ).length;
+  const skipped = result.stageResults.flatMap(
+    (stage) => stage.steps.filter((s) => s.status === "skipped")
+  ).length;
+  const errors = result.stageResults.flatMap(
+    (stage) => stage.steps.filter((s) => s.status === "error")
+  ).length;
+  note(
+    t("cli.uninstall.summary.body", {
+      removed: String(removed),
+      skipped: String(skipped),
+      errors: String(errors)
+    }),
+    t("cli.uninstall.summary.title")
+  );
+  for (const stage of result.stageResults) {
+    for (const step of stage.steps) {
+      if (step.status === "error") {
+        writeStderr(`${paint.error(t("cli.shared.error"))} ${stage.name}/${step.step} ${step.path}: ${step.message ?? "unknown error"}`);
+      }
+    }
+  }
+}
+function formatUninstallStageHeader(stageName) {
+  return `${paint.ai(t("cli.shared.next"))} ${paint.muted(t(`cli.uninstall.stages.${stageName}`))}`;
+}
+function formatUninstallStageResult(stageName, steps) {
+  const removedCount = steps.filter((s) => s.status === "removed").length;
+  const skippedCount = steps.filter((s) => s.status === "skipped").length;
+  const errorCount = steps.filter((s) => s.status === "error").length;
+  const counts = `removed=${removedCount} skipped=${skippedCount} errors=${errorCount}`;
+  const label = errorCount > 0 ? paint.warn(t("cli.uninstall.stages.completed-with-errors")) : paint.success(t("cli.uninstall.stages.completed"));
+  return `${label} ${stageName}: ${counts}`;
+}
+function formatUninstallStageFailure(stage, error) {
+  const message = error instanceof Error ? error.message : String(error);
+  return `${paint.error(t("cli.uninstall.stages.failed"))} ${stage}: ${message}`;
+}
+function resolvePersonalFabricRoot() {
+  return process.env.FABRIC_HOME ?? homedir();
+}
+function isInsidePersonalRoot(candidate, personalKnowledgeDir) {
+  const candidateAbs = resolve(candidate);
+  const rootAbs = resolve(personalKnowledgeDir);
+  if (candidateAbs === rootAbs) {
+    return true;
+  }
+  const rel = relative(rootAbs, candidateAbs);
+  return rel.length > 0 && !rel.startsWith("..") && !isAbsolute(rel) && !rel.split(sep).includes("..");
+}
+function normalizeTarget(targetInput) {
+  return isAbsolute(targetInput) ? targetInput : resolve(process.cwd(), targetInput);
+}
+function assertExistingDirectory(target) {
+  if (!existsSync2(target) || !statSync(target).isDirectory()) {
+    throw new Error(t("cli.uninstall.errors.target-not-directory", { path: target }));
+  }
+}
+function isInteractiveUninstall() {
+  return Boolean(process.stdin.isTTY) && Boolean(process.stdout.isTTY) && Boolean(process.stderr.isTTY);
+}
+function formatPromptDefault(value) {
+  return value ? "Y/n" : "y/N";
+}
+function yesNoLabel(value) {
+  return value ? t("cli.shared.yes") : t("cli.shared.no");
+}
+function writeStderr(message) {
+  process.stderr.write(`${message}
+`);
+}
+export {
+  assertExistingDirectory,
+  buildUninstallExecutionPlan,
+  buildUninstallFabricPlan,
+  createDefaultUninstallWizardAdapter,
+  uninstall_default as default,
+  executeUninstallExecutionPlan,
+  executeUninstallFabricPlan,
+  isInsidePersonalRoot,
+  resolveUninstallExecutionPlanWithWizard,
+  runUninstallCommand,
+  shouldUseUninstallWizard,
+  uninstallCommand,
+  uninstallFabric,
+  uninstallMcpClients
+};