okstra 0.174.0 → 0.176.0

package/src/commands/lifecycle/uninstall.mjs

@@ -1,279 +0,0 @@
-import { promises as fs } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { resolvePaths } from "../../lib/paths.mjs";
-import {
-  RUNTIMES_MANIFEST_REL,
-  runtimeManifestIncludesClaudeAssets,
-} from "../../lib/runtime-manifest.mjs";
-import { OBSOLETE_SKILL_NAMES, USER_SKILL_NAMES } from "../../lib/skill-catalog.mjs";
-import {
-  AGENTS_MANIFEST_REL,
-  INSTALLED_FILES,
-  INSTALLED_TREES,
-  LEGACY_TRANSPORT_AGENT_NAMES,
-  SKILLS_MANIFEST_REL,
-} from "../../lib/install-assets.mjs";
-
-// Manifest-less uninstall must clean out every okstra skill directory — the
-// live names AND every former/renamed one. Both sets are the single source of
-// truth in skill-catalog.mjs (install prunes OBSOLETE_SKILL_NAMES from each
-// skill home), so deriving the fallback from their union keeps uninstall from
-// drifting behind skill additions or renames.
-export const FALLBACK_SKILL_NAMES = [
-  ...new Set([...USER_SKILL_NAMES, ...OBSOLETE_SKILL_NAMES]),
-];
-
-export const FALLBACK_AGENT_NAMES = [
-  "claude-worker.md",
-  "report-writer-worker.md",
-  "translator-worker.md",
-  ...LEGACY_TRANSPORT_AGENT_NAMES,
-];
-
-const USER_HOME = homedir();
-const CLAUDE_HOME = join(USER_HOME, ".claude");
-const AGENTS_HOME = join(USER_HOME, ".agents");
-const CLAUDE_SKILLS_DIR = join(CLAUDE_HOME, "skills");
-const AGENTS_SKILLS_DIR = join(AGENTS_HOME, "skills");
-const CLAUDE_AGENTS_DIR = join(CLAUDE_HOME, "agents");
-const FALLBACK_SKILL_ROOTS = [
-  CLAUDE_SKILLS_DIR,
-  AGENTS_SKILLS_DIR,
-];
-
-
-const USAGE = `okstra uninstall — remove installed runtime and okstra skills
-
-Usage:
-  okstra uninstall              Remove ~/.okstra/{lib (python + validators),
-                                bin, schemas, templates, version,
-                                dev-link, installed-runtimes.json,
-                                installed-skills.json, installed-agents.json} AND
-                                every skill target recorded in
-                                installed-skills.json
-                                (~/.claude/skills or ~/.agents/skills).
-                                Claude worker agents are
-                                removed from ~/.claude/agents when installed.
-                                Missing manifests fall back to hard-coded
-                                Claude okstra-* / *-worker.md names.
-                                Preserves user data: recent.jsonl,
-                                active.jsonl, projects/, archive/,
-                                state.json, .locks/
-                                Per-project artifacts created by 'okstra setup'
-                                (<PROJECT>/.claude/settings.local.json symlink)
-                                are NOT touched — remove them manually if needed.
-  okstra uninstall --purge      Remove the entire ~/.okstra directory AND
-                                okstra skills in Claude/Agent homes AND
-                                ~/.claude/agents/<*-worker.md> (DESTRUCTIVE).
-                                Requires -y or an interactive confirmation
-  okstra uninstall --dry-run    Print the plan without touching disk
-  okstra uninstall -y           Skip confirmation prompt for --purge
-`;
-
-async function pathExists(p) {
-  try {
-    await fs.lstat(p);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-async function removePath(p, opts) {
-  const { dryRun = false, quiet = false } = opts ?? {};
-  if (!(await pathExists(p))) {
-    if (!quiet) process.stdout.write(`  not present: ${p}\n`);
-    return false;
-  }
-  if (dryRun) {
-    process.stdout.write(`[dry-run] rm ${p}\n`);
-    return true;
-  }
-  await fs.rm(p, { recursive: true, force: true });
-  if (!quiet) process.stdout.write(`  removed: ${p}\n`);
-  return true;
-}
-
-async function promptConfirm(question) {
-  if (!process.stdin.isTTY) return false;
-  process.stdout.write(`${question} [y/N] `);
-  return await new Promise((resolveP) => {
-    process.stdin.setEncoding("utf8");
-    process.stdin.once("data", (chunk) => {
-      const answer = chunk.toString().trim().toLowerCase();
-      resolveP(answer === "y" || answer === "yes");
-    });
-  });
-}
-
-export async function runUninstall(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stdout.write(USAGE);
-    return 0;
-  }
-  const opts = {
-    dryRun: args.includes("--dry-run"),
-    quiet: args.includes("-q") || args.includes("--quiet"),
-    purge: args.includes("--purge"),
-    yes: args.includes("-y") || args.includes("--yes"),
-  };
-  const paths = await resolvePaths();
-
-  if (!(await pathExists(paths.home))) {
-    if (!opts.quiet) process.stdout.write(`okstra not installed (no ${paths.home})\n`);
-    return 0;
-  }
-
-  if (opts.purge) {
-    if (!opts.yes && !opts.dryRun) {
-      const ok = await promptConfirm(
-        `purge entire ${paths.home} AND okstra skills in Claude/Agent homes? user data will be lost.`,
-      );
-      if (!ok) {
-        process.stdout.write("aborted.\n");
-        return 1;
-      }
-    }
-    if (!opts.quiet) process.stdout.write(`purging ${paths.home}\n`);
-    await removePath(paths.home, opts);
-    // Skills and worker agents live outside ~/.okstra — purge those too.
-    for (const root of FALLBACK_SKILL_ROOTS) {
-      for (const name of FALLBACK_SKILL_NAMES) {
-        await removePath(join(root, name), opts);
-      }
-    }
-    for (const name of FALLBACK_AGENT_NAMES) {
-      await removePath(join(CLAUDE_AGENTS_DIR, name), opts);
-    }
-    return 0;
-  }
-
-  if (!opts.quiet) {
-    process.stdout.write(`uninstalling okstra runtime\n`);
-    process.stdout.write(`  home: ${paths.home}\n`);
-  }
-  // Every tree the install writes, read from the list install itself copies
-  // from. A per-name list here drifts behind additions the moment one lands on
-  // the install side only — which is how a stale validator, a stale schema and
-  // a stale prompts tree each survived uninstall→reinstall in turn, one bug
-  // report at a time.
-  for (const tree of INSTALLED_TREES) {
-    await removePath(join(paths.home, ...tree.to), opts);
-  }
-  // Clean now-empty lib parent (best-effort) — the trees above were the only
-  // okstra-owned children.
-  const libDir = join(paths.home, "lib");
-  if (await pathExists(libDir)) {
-    try {
-      const entries = await fs.readdir(libDir);
-      if (entries.length === 0) {
-        if (!opts.dryRun) await fs.rmdir(libDir);
-        if (!opts.quiet) process.stdout.write(`  removed empty: ${libDir}\n`);
-      }
-    } catch {
-      /* ignore */
-    }
-  }
-
-  // Remove the skills we own. Manifest v2 records every target root; legacy
-  // manifests fall back to Claude-only names when the runtime manifest says
-  // Claude assets may have been installed.
-  const runtimeManifest = await readRuntimeManifest(paths.home);
-  const skillTargets = await readSkillsManifest(paths.home, runtimeManifest);
-  for (const target of skillTargets) {
-    if (!opts.quiet) {
-      process.stdout.write(`  skills: removing ${target.skills.length} entries from ${target.root}\n`);
-    }
-    for (const name of target.skills) {
-      await removePath(join(target.root, name), opts);
-    }
-  }
-  await removePath(join(paths.home, SKILLS_MANIFEST_REL), opts);
-
-  // Remove worker agents we own. Agents only live in Claude Code's agent home.
-  const shouldRemoveClaudeAgents =
-    skillTargets.some((target) => target.provider === "claude") ||
-    shouldUseClaudeAssetFallback(runtimeManifest);
-  const agentNames = shouldRemoveClaudeAgents ? await readAgentsManifest(paths.home) : [];
-  if (!opts.quiet) {
-    process.stdout.write(`  agents: removing ${agentNames.length} entries from ${CLAUDE_AGENTS_DIR}\n`);
-  }
-  for (const name of agentNames) {
-    await removePath(join(CLAUDE_AGENTS_DIR, name), opts);
-  }
-  // Per-project <PROJECT>/.claude/settings.local.json symlinks are NOT removed
-  // here — uninstall is machine-level and does not know which projects opted
-  // in. They will dangle until the user removes them manually or re-runs
-  // okstra install + okstra setup.
-
-  // Stamps and manifests, last: the skill/agent removal above reads two of them.
-  for (const name of INSTALLED_FILES) {
-    await removePath(join(paths.home, name), opts);
-  }
-
-  if (!opts.quiet) {
-    process.stdout.write("done. user data preserved (recent.jsonl, projects/, archive/, ...).\n");
-  }
-  return 0;
-}
-
-async function readRuntimeManifest(home) {
-  try {
-    const raw = await fs.readFile(join(home, RUNTIMES_MANIFEST_REL), "utf8");
-    const data = JSON.parse(raw);
-    return data && typeof data === "object" ? data : null;
-  } catch {
-    return null;
-  }
-}
-
-export function shouldUseClaudeAssetFallback(runtimeManifest) {
-  if (runtimeManifest === null) return true;
-  return runtimeManifestIncludesClaudeAssets(runtimeManifest);
-}
-
-function normalizeSkillTargets(data) {
-  if (Array.isArray(data?.targets)) {
-    return data.targets
-      .filter((target) => typeof target?.root === "string" && Array.isArray(target?.skills))
-      .map((target) => ({
-        provider: typeof target.provider === "string" ? target.provider : "unknown",
-        root: target.root,
-        skills: target.skills.filter((name) => typeof name === "string"),
-      }));
-  }
-  if (Array.isArray(data?.skills)) {
-    return [{
-      provider: "claude",
-      root: CLAUDE_SKILLS_DIR,
-      skills: data.skills.filter((name) => typeof name === "string"),
-    }];
-  }
-  return null;
-}
-
-async function readSkillsManifest(home, runtimeManifest) {
-  try {
-    const raw = await fs.readFile(join(home, SKILLS_MANIFEST_REL), "utf8");
-    const data = JSON.parse(raw);
-    const targets = normalizeSkillTargets(data);
-    if (targets !== null) return targets;
-  } catch {
-    /* fall through */
-  }
-  return shouldUseClaudeAssetFallback(runtimeManifest)
-    ? [{ provider: "claude", root: CLAUDE_SKILLS_DIR, skills: FALLBACK_SKILL_NAMES }]
-    : [];
-}
-
-async function readAgentsManifest(home) {
-  try {
-    const raw = await fs.readFile(join(home, AGENTS_MANIFEST_REL), "utf8");
-    const data = JSON.parse(raw);
-    if (Array.isArray(data?.agents)) return data.agents;
-  } catch {
-    /* fall through */
-  }
-  return FALLBACK_AGENT_NAMES;
-}