argsbarg 4.1.1 → 5.0.1

package/src/builtins/uninstall.ts

@@ -1,80 +0,0 @@
-import { resolveCapabilities } from "../capabilities.ts";
-import { type CliLeaf, type CliOption, CliOptionKind, type CliProgram } from "../types.ts";
-
-/** Uninstall command options (dynamic: `--mcp` only when MCP is enabled). */
-export function uninstallBuiltinOptions(root: CliProgram): CliOption[] {
-  const opts: CliOption[] = [
-    {
-      name: "all",
-      description: "Remove all detected agent artifacts (default when no scope flags are given).",
-      kind: CliOptionKind.Presence,
-    },
-    {
-      name: "skill",
-      description: "Remove agent skills only.",
-      kind: CliOptionKind.Presence,
-    },
-  ];
-
-  if (resolveCapabilities(root).mcp) {
-    opts.push({
-      name: "mcp",
-      description: "Remove MCP server configuration only.",
-      kind: CliOptionKind.Presence,
-    });
-  }
-
-  if (root.appConfig) {
-    opts.push({
-      name: "configure",
-      description: "Remove the app config file only.",
-      kind: CliOptionKind.Presence,
-    });
-  }
-
-  opts.push(
-    {
-      name: "yes",
-      description: "Skip the confirmation prompt.",
-      kind: CliOptionKind.Presence,
-      shortName: "y",
-    },
-    {
-      name: "dry",
-      description: "Show what would change without writing files.",
-      kind: CliOptionKind.Presence,
-    },
-    {
-      name: "json",
-      description: "Print changed paths on stdout.",
-      kind: CliOptionKind.Presence,
-    },
-  );
-
-  return opts;
-}
-
-/** Builds the `uninstall` built-in command. */
-export function cliBuiltinUninstallCommand(root: CliProgram): CliLeaf {
-  const app = root.key;
-  const notesLines = [
-    "Remove agent artifacts installed by this app (skills, MCP, config).",
-    "Run before `brew uninstall` while the CLI is still on PATH:",
-    "",
-    `  ${app} uninstall --yes`,
-    `  brew uninstall <tap>/${app}`,
-    "",
-    "Remove app config only:",
-    `  ${app} uninstall --configure --yes`,
-    "",
-    "Use --dry to preview changes without writing files.",
-    "Use --json for machine-readable output.",
-  ];
-  return {
-    key: "uninstall",
-    description: "Remove agent skills, MCP config, and app config for this app.",
-    options: uninstallBuiltinOptions(root),
-    notes: notesLines.join("\n"),
-    handler: () => {},
-  };
-}

package/src/install/index.ts

@@ -1,409 +0,0 @@
-import { readSync } from "node:fs";
-import { resolveCapabilities } from "../capabilities.ts";
-import { displayAppConfigPath, runInstallConfigure } from "../config/bootstrap.ts";
-import { cliSkillInstall, skillTargetFromActionKind } from "../skill/install.ts";
-import type { CliProgram } from "../types.ts";
-import { normalizeInstallRawOpts } from "./normalize.ts";
-import { normalizeUninstallRawOpts } from "./normalize-uninstall.ts";
-import { resolveInstallPaths } from "./paths.ts";
-import { buildInstallPlan, buildUpdatePlan, type InstallAction, type InstallOpts } from "./plan.ts";
-import {
-  installErr,
-  installInfo,
-  installOut,
-  printInstallStatus,
-  writeInteractiveInstallIntro,
-} from "./status.ts";
-import { runTargetPreflight } from "./target-plan-build.ts";
-import type { InstallActionKind } from "./target-types.ts";
-import {
-  buildUninstallPlan,
-  skillDirFromUninstallSummary,
-  type UninstallAction,
-  uninstallSkillDir,
-} from "./uninstall.ts";
-
-export function parseInstallOpts(raw: Record<string, string>): InstallOpts {
-  const flag = (name: string) => raw[name] === "1";
-  return {
-    all: flag("all"),
-    skill: flag("skill"),
-    mcp: flag("mcp"),
-    reinstall: flag("reinstall"),
-    status: flag("status"),
-    uninstall: flag("uninstall"),
-    configure: flag("configure"),
-    yes: flag("yes"),
-    dry: flag("dry"),
-    json: flag("json"),
-  };
-}
-
-export function validateInstallOpts(opts: InstallOpts): string | null {
-  const configureOnlyInstall =
-    opts.configure && !opts.all && !opts.skill && !opts.mcp && !opts.reinstall && !opts.status;
-
-  if (configureOnlyInstall) {
-    return null;
-  }
-
-  if (opts.uninstall) {
-    return "Use `uninstall` instead of `install --uninstall`.";
-  }
-
-  if (opts.json) {
-    opts.yes = true;
-  }
-  if (opts.reinstall) {
-    opts.yes = true;
-  }
-
-  const mutationFlags = opts.all || opts.skill || opts.mcp || opts.reinstall || opts.configure;
-  if (opts.status && mutationFlags) {
-    return "--status is mutually exclusive with install/reinstall targets.";
-  }
-  if (opts.reinstall && (opts.all || opts.skill || opts.mcp || opts.status || opts.configure)) {
-    return "--reinstall cannot be combined with other target flags.";
-  }
-  if (!opts.status && !opts.reinstall) {
-    const hasTarget = opts.all || opts.skill || opts.mcp || opts.configure;
-    if (!hasTarget) {
-      return "Specify at least one target: --all, --skill, --mcp, or --configure.";
-    }
-  }
-  return null;
-}
-
-export function validateUninstallOpts(opts: InstallOpts): string | null {
-  if (opts.json) {
-    opts.yes = true;
-  }
-
-  if (opts.status || opts.reinstall) {
-    return "uninstall does not support --status or --reinstall.";
-  }
-
-  const hasTarget = opts.all || opts.skill || opts.mcp || opts.configure;
-  if (!hasTarget) {
-    return "Specify at least one target: --all, --skill, --mcp, or --configure.";
-  }
-  return null;
-}
-
-function parseSelectionIndices(input: string, max: number): number[] | null {
-  const trimmed = input.trim();
-  if (!trimmed) return null;
-  const parts = trimmed.split(/[\s,]+/).filter(Boolean);
-  const indices: number[] = [];
-  for (const part of parts) {
-    const n = Number(part);
-    if (!Number.isInteger(n) || n < 1 || n > max) {
-      return null;
-    }
-    if (!indices.includes(n)) {
-      indices.push(n);
-    }
-  }
-  return indices.sort((a, b) => a - b);
-}
-
-/** Interactive install: legacy helper (app no longer installed). */
-export function interactiveSelectionAssumesApp(
-  _actions: Array<InstallAction | UninstallAction>,
-  _uninstall: boolean,
-): boolean {
-  return false;
-}
-
-export function mergeInteractiveSelection(
-  indices: number[],
-  count: number,
-  alwaysIncludeFirst: boolean,
-): number[] {
-  if (!alwaysIncludeFirst || count === 0 || indices.includes(1)) {
-    return indices;
-  }
-  return [1, ...indices].sort((a, b) => a - b);
-}
-
-function promptSelectiveConfirm(count: number, alwaysIncludeFirst: boolean): number[] | null {
-  const hint = alwaysIncludeFirst
-    ? "Proceed [y/N], or numbers to include (e.g. 2,3): "
-    : "Proceed [y/N], or numbers to include (e.g. 1,3): ";
-  process.stderr.write(hint);
-  const buf = Buffer.alloc(256);
-  const n = readSync(0, buf, { length: 256 });
-  const ans = buf.toString("utf8", 0, n).trim();
-  if (ans === "y" || ans === "Y") {
-    return Array.from({ length: count }, (_, i) => i + 1);
-  }
-  if (ans === "n" || ans === "N" || ans === "") {
-    return null;
-  }
-  const parsed = parseSelectionIndices(ans, count);
-  if (!parsed) return null;
-  return mergeInteractiveSelection(parsed, count, alwaysIncludeFirst);
-}
-
-function runSkillAction(root: CliProgram, kind: InstallActionKind, opts: InstallOpts): string[] {
-  const target = skillTargetFromActionKind(kind);
-  if (!target) return [];
-  return cliSkillInstall(root, target, {
-    global: true,
-    rimraf: true,
-    dry: opts.dry,
-  });
-}
-
-function executePlan(
-  root: CliProgram,
-  actions: Array<InstallAction | UninstallAction>,
-  opts: InstallOpts,
-  showProgress: boolean,
-): string[] {
-  const changed: string[] = [];
-  const paths = resolveInstallPaths(root);
-  for (const action of actions) {
-    if (showProgress) {
-      installInfo(action.message, opts);
-    }
-    if ("kind" in action && action.kind) {
-      const skillTarget = skillTargetFromActionKind(action.kind);
-      if (skillTarget) {
-        changed.push(...runSkillAction(root, action.kind as InstallActionKind, opts));
-        continue;
-      }
-    }
-    if (!("kind" in action) || !action.kind) {
-      const skillDir = skillDirFromUninstallSummary(action.summary, paths);
-      if (skillDir) {
-        changed.push(...uninstallSkillDir(skillDir, !!opts.dry));
-        continue;
-      }
-    }
-    changed.push(...action.run());
-  }
-  return changed;
-}
-
-/** Runs install/reinstall mutations without exiting the process. */
-export async function runInstallMutation(
-  root: CliProgram,
-  rawOpts: Record<string, string>,
-): Promise<{
-  changed: string[];
-  opts: InstallOpts;
-  paths: ReturnType<typeof resolveInstallPaths>;
-}> {
-  const normalized = normalizeInstallRawOpts(rawOpts);
-  const opts = parseInstallOpts(normalized);
-  const err = validateInstallOpts(opts);
-  if (err) {
-    throw new Error(err);
-  }
-  return runInstallMutationInternal(root, opts);
-}
-
-/** Runs uninstall mutations without exiting the process. */
-export async function runUninstallMutation(
-  root: CliProgram,
-  rawOpts: Record<string, string>,
-): Promise<{
-  changed: string[];
-  opts: InstallOpts;
-  paths: ReturnType<typeof resolveInstallPaths>;
-}> {
-  const normalized = normalizeUninstallRawOpts(rawOpts);
-  const opts = parseInstallOpts(normalized);
-  const err = validateUninstallOpts(opts);
-  if (err) {
-    throw new Error(err);
-  }
-  return runInstallMutationInternal(root, opts);
-}
-
-async function runInstallMutationInternal(
-  root: CliProgram,
-  opts: InstallOpts,
-): Promise<{
-  changed: string[];
-  opts: InstallOpts;
-  paths: ReturnType<typeof resolveInstallPaths>;
-}> {
-  const paths = resolveInstallPaths(root);
-
-  if (opts.status) {
-    printInstallStatus(root, opts);
-    return { changed: [], opts, paths };
-  }
-
-  let actions: Array<InstallAction | UninstallAction>;
-  if (opts.uninstall) {
-    actions = buildUninstallPlan(root, paths, opts);
-  } else if (opts.reinstall) {
-    actions = buildUpdatePlan(root, paths, opts);
-  } else {
-    actions = buildInstallPlan(root, paths, opts);
-  }
-
-  const installActions = actions.filter(
-    (a): a is InstallAction => "kind" in a && typeof a.kind === "string" && a.kind.includes("-mcp"),
-  );
-  if (!opts.uninstall && resolveCapabilities(root).mcp && installActions.length > 0) {
-    runTargetPreflight(root, paths, opts, installActions);
-  }
-
-  let selectedActions = actions;
-  const autoYes = !!(opts.yes || opts.json || opts.reinstall || opts.dry);
-
-  if (!autoYes && !opts.json && process.stdin.isTTY) {
-    writeInteractiveInstallIntro(root);
-  }
-
-  if (actions.length === 0) {
-    if (!autoYes && !opts.json && process.stdin.isTTY && !opts.configure) {
-      installOut("Nothing to install for the selected targets.", opts);
-    }
-    return { changed: [], opts, paths };
-  }
-
-  if (!autoYes) {
-    installOut(
-      `About to ${opts.uninstall ? "remove" : opts.reinstall ? "reinstall" : "install"}:`,
-      opts,
-    );
-    for (let i = 0; i < actions.length; i++) {
-      installOut(`  ${i + 1}. ${actions[i]?.summary}`, opts);
-    }
-  }
-
-  if (!autoYes) {
-    if (!process.stdin.isTTY) {
-      throw new Error("Refusing to proceed without --yes (stdin is not a TTY).");
-    }
-    const assumeApp = interactiveSelectionAssumesApp(actions, !!opts.uninstall);
-    const selection = promptSelectiveConfirm(actions.length, assumeApp);
-    if (!selection) {
-      throw new Error("Aborted.");
-    }
-    process.stderr.write("Done.\n");
-    selectedActions = selection.map((i) => actions[i - 1]).filter(Boolean) as typeof actions;
-  }
-
-  const changed = executePlan(root, selectedActions, opts, autoYes);
-  return { changed, opts, paths };
-}
-
-/** Main install command orchestrator. */
-export async function cliInstall(
-  root: CliProgram,
-  rawOpts: Record<string, string>,
-): Promise<never> {
-  if (rawOpts.uninstall === "1") {
-    installErr(`Use \`${root.key} uninstall\` instead of \`${root.key} install --uninstall\`.`);
-    process.exit(1);
-  }
-
-  const normalized = normalizeInstallRawOpts(rawOpts);
-  const opts = parseInstallOpts(normalized);
-
-  const configureOnly = opts.configure && !opts.all && !opts.skill && !opts.mcp;
-
-  if (configureOnly) {
-    if (!root.appConfig) {
-      installErr("This app does not support --configure.");
-      process.exit(1);
-    }
-    if (process.stdin.isTTY) {
-      writeInteractiveInstallIntro(root);
-    }
-    const result = runInstallConfigure(root, { context: "standalone" });
-    if (result.changed) {
-      installOut(`Wrote config: ${displayAppConfigPath(root)}`, opts);
-    } else {
-      installOut(`Config unchanged: ${displayAppConfigPath(root)}`, opts);
-    }
-    process.exit(0);
-  }
-
-  const err = validateInstallOpts(opts);
-  if (err) {
-    installErr(err);
-    process.exit(1);
-  }
-
-  let result: Awaited<ReturnType<typeof runInstallMutation>>;
-  try {
-    result = await runInstallMutation(root, normalized);
-  } catch (err) {
-    installErr(err instanceof Error ? err.message : String(err));
-    process.exit(1);
-  }
-
-  const { changed, opts: mutationOpts } = result;
-
-  if (mutationOpts.status) {
-    process.exit(0);
-  }
-
-  if (mutationOpts.json) {
-    process.stdout.write(`${JSON.stringify(changed, null, 2)}\n`);
-    process.exit(0);
-  }
-
-  if (changed.length > 0) {
-    const verb = mutationOpts.uninstall
-      ? "Removed"
-      : mutationOpts.reinstall
-        ? "Reinstalled"
-        : "Installed";
-    installOut(`${verb} ${changed.length} file(s).`, mutationOpts);
-  }
-
-  if (mutationOpts.configure && root.appConfig) {
-    const configResult = runInstallConfigure(root, {
-      context: changed.length > 0 ? "after-install" : "standalone",
-    });
-    if (configResult.changed) {
-      installOut(`Wrote config: ${displayAppConfigPath(root)}`, mutationOpts);
-    }
-  }
-
-  process.exit(0);
-}
-
-/** Main uninstall command orchestrator. */
-export async function cliUninstall(
-  root: CliProgram,
-  rawOpts: Record<string, string>,
-): Promise<never> {
-  const normalized = normalizeUninstallRawOpts(rawOpts);
-  const opts = parseInstallOpts(normalized);
-
-  const err = validateUninstallOpts(opts);
-  if (err) {
-    installErr(err);
-    process.exit(1);
-  }
-
-  let result: Awaited<ReturnType<typeof runUninstallMutation>>;
-  try {
-    result = await runUninstallMutation(root, rawOpts);
-  } catch (mutationErr) {
-    installErr(mutationErr instanceof Error ? mutationErr.message : String(mutationErr));
-    process.exit(1);
-  }
-
-  const { changed, opts: mutationOpts } = result;
-
-  if (mutationOpts.json) {
-    process.stdout.write(`${JSON.stringify(changed, null, 2)}\n`);
-    process.exit(0);
-  }
-
-  if (changed.length > 0) {
-    installOut(`Removed ${changed.length} file(s).`, mutationOpts);
-  }
-
-  process.exit(0);
-}