claude-code-swarm 0.3.2 → 0.3.4

package/references/swarmkit/src/commands/remove.ts

@@ -1,72 +0,0 @@
-import type { Command } from "commander";
-import chalk from "chalk";
-import { readConfig, removeInstalledPackage } from "../config/global.js";
-import { getLostIntegrations } from "../packages/registry.js";
-import { uninstallPackage, getInstalledVersion } from "../packages/installer.js";
-import { isInstalledPlugin } from "../packages/plugin.js";
-import * as ui from "../utils/ui.js";
-
-export function registerRemoveCommand(program: Command): void {
-  program
-    .command("remove <package>")
-    .description("Uninstall a swarmkit package (preserves project data)")
-    .action(async (packageName: string) => {
-      const config = readConfig();
-
-      // Check if tracked by swarmkit
-      if (!config.installedPackages.includes(packageName)) {
-        ui.fail(`${packageName} is not in the swarmkit package list.`);
-        ui.info("Run `swarmkit status` to see installed packages.");
-        process.exitCode = 1;
-        return;
-      }
-
-      // Show what will break
-      const lostIntegrations = getLostIntegrations(
-        config.installedPackages,
-        packageName,
-      );
-      if (lostIntegrations.length > 0) {
-        console.log();
-        console.log(`  ${chalk.bold("Affected integrations:")}`);
-        for (const integration of lostIntegrations) {
-          const other = integration.packages.find((p) => p !== packageName)!;
-          ui.warn(`${other} — ${integration.description}`);
-        }
-        console.log();
-      }
-
-      // Check if it's a plugin before uninstalling (while we can still resolve the path)
-      const wasPlugin = await isInstalledPlugin(packageName);
-
-      // Uninstall
-      console.log(`  Uninstalling ${chalk.bold(packageName)}...`);
-      const version = await getInstalledVersion(packageName);
-
-      try {
-        await uninstallPackage(packageName);
-        ui.success(
-          `${packageName}${version ? " v" + version : ""} uninstalled`,
-        );
-      } catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        ui.fail(`Failed to uninstall: ${msg}`);
-        process.exitCode = 1;
-        return;
-      }
-
-      // Update registry
-      removeInstalledPackage(packageName);
-      ui.blank();
-      ui.info(
-        "Project data directories are preserved. Delete them manually if no longer needed.",
-      );
-
-      if (wasPlugin) {
-        ui.info(
-          `If activated as a Claude Code plugin, also run: claude plugin uninstall ${packageName}`,
-        );
-      }
-      ui.blank();
-    });
-}

package/references/swarmkit/src/commands/status.ts

@@ -1,101 +0,0 @@
-import type { Command } from "commander";
-import chalk from "chalk";
-import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { join, dirname } from "node:path";
-import { readConfig } from "../config/global.js";
-import { listKeys } from "../config/keys.js";
-import { PACKAGES, getActiveIntegrations } from "../packages/registry.js";
-import { getInstalledVersion } from "../packages/installer.js";
-import * as ui from "../utils/ui.js";
-
-export function registerStatusCommand(program: Command): void {
-  program
-    .command("status")
-    .description("Show installed packages and configuration")
-    .action(async () => {
-      const config = readConfig();
-      const { installedPackages } = config;
-
-      console.log();
-      console.log(
-        `  ${chalk.bold("swarmkit")} ${chalk.dim("v" + getVersion())}`,
-      );
-
-      // Packages
-      if (installedPackages.length === 0) {
-        ui.blank();
-        ui.info("No packages installed. Run `swarmkit init` to get started.");
-        ui.blank();
-        return;
-      }
-
-      ui.heading("  Packages:");
-      const rows: string[][] = [];
-      for (const pkg of installedPackages) {
-        const version = await getInstalledVersion(pkg);
-        const def = PACKAGES[pkg];
-        if (version) {
-          rows.push([
-            pkg,
-            chalk.dim(version),
-            chalk.green("installed"),
-            chalk.dim(def?.description ?? ""),
-          ]);
-        } else {
-          rows.push([
-            pkg,
-            chalk.dim("—"),
-            chalk.red("not found"),
-            chalk.dim(def?.description ?? ""),
-          ]);
-        }
-      }
-      ui.table(rows);
-
-      // Integrations
-      const integrations = getActiveIntegrations(installedPackages);
-      if (integrations.length > 0) {
-        ui.heading("  Integrations:");
-        for (const integration of integrations) {
-          const [a, b] = integration.packages;
-          ui.bullet(
-            `  ${a} ${chalk.dim("↔")} ${b}  ${chalk.dim(integration.description)}`,
-          );
-        }
-      }
-
-      // Embeddings
-      if (config.embeddingProvider) {
-        ui.heading("  Embeddings:");
-        const model = config.embeddingModel ?? "default";
-        ui.bullet(`  ${config.embeddingProvider} (${model})`);
-      }
-
-      // API Keys
-      const keys = listKeys();
-      if (keys.length > 0) {
-        ui.heading("  API Keys:");
-        const keyRows: string[][] = [];
-        for (const key of keys) {
-          keyRows.push([key, chalk.green("set")]);
-        }
-        ui.table(keyRows);
-      }
-
-      ui.blank();
-    });
-}
-
-function getVersion(): string {
-  try {
-    const __dirname = dirname(fileURLToPath(import.meta.url));
-    const pkgPath = join(__dirname, "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8")) as {
-      version: string;
-    };
-    return pkg.version;
-  } catch {
-    return "0.0.1";
-  }
-}

package/references/swarmkit/src/commands/update.ts

@@ -1,62 +0,0 @@
-import type { Command } from "commander";
-import chalk from "chalk";
-import { readConfig } from "../config/global.js";
-import { updatePackages } from "../packages/installer.js";
-import * as ui from "../utils/ui.js";
-
-export function registerUpdateCommand(program: Command): void {
-  program
-    .command("update")
-    .description("Update all installed packages to latest versions")
-    .action(async () => {
-      const config = readConfig();
-      const { installedPackages } = config;
-
-      if (installedPackages.length === 0) {
-        ui.info("No packages installed. Run `swarmkit init` to get started.");
-        return;
-      }
-
-      console.log();
-      console.log(`  Checking for updates...`);
-      console.log();
-
-      const results = await updatePackages(installedPackages);
-
-      const rows: string[][] = [];
-      let updatedCount = 0;
-
-      for (const result of results) {
-        if (result.error) {
-          rows.push([result.package, chalk.red("error"), chalk.dim(result.error)]);
-        } else if (result.updated) {
-          updatedCount++;
-          rows.push([
-            result.package,
-            chalk.dim(result.previousVersion ?? "?") +
-              " → " +
-              chalk.green(result.newVersion ?? "?"),
-            chalk.green("updated"),
-          ]);
-        } else {
-          rows.push([
-            result.package,
-            chalk.dim(result.previousVersion ?? "?"),
-            chalk.dim("up to date"),
-          ]);
-        }
-      }
-
-      ui.table(rows);
-      ui.blank();
-
-      if (updatedCount > 0) {
-        ui.info(
-          `${updatedCount} package${updatedCount === 1 ? "" : "s"} updated.`,
-        );
-      } else {
-        ui.info("All packages are up to date.");
-      }
-      ui.blank();
-    });
-}

package/references/swarmkit/src/commands/whoami.ts

@@ -1,41 +0,0 @@
-import type { Command } from "commander";
-import chalk from "chalk";
-import { isLoggedIn } from "../hub/credentials.js";
-import { getMe, getHubUrl, HubApiError } from "../hub/client.js";
-import * as ui from "../utils/ui.js";
-
-export function registerWhoamiCommand(program: Command): void {
-  program
-    .command("whoami")
-    .description("Show the currently authenticated SwarmHub user")
-    .action(async () => {
-      if (!isLoggedIn()) {
-        ui.blank();
-        ui.info("Not logged in. Run `swarmkit login` to authenticate.");
-        ui.blank();
-        return;
-      }
-
-      try {
-        const user = await getMe();
-
-        ui.blank();
-        ui.table([
-          [chalk.dim("User"), chalk.bold(user.name)],
-          [chalk.dim("Email"), user.email],
-          [chalk.dim("Hub"), getHubUrl()],
-        ]);
-        ui.blank();
-      } catch (err) {
-        ui.blank();
-        if (err instanceof HubApiError && err.statusCode === 401) {
-          ui.fail("Session expired. Run `swarmkit login` to re-authenticate.");
-        } else if (err instanceof HubApiError) {
-          ui.fail(`SwarmHub error: ${err.message}`);
-        } else {
-          ui.fail("Could not reach SwarmHub.");
-        }
-        ui.blank();
-      }
-    });
-}

package/references/swarmkit/src/config/global.test.ts

@@ -1,258 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
-import { mkdtempSync, rmSync, existsSync, readFileSync, statSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-
-// Mock os.homedir to use a temp directory
-let tempHome: string;
-
-vi.mock("node:os", async () => {
-  const actual = await vi.importActual<typeof import("node:os")>("node:os");
-  return {
-    ...actual,
-    homedir: () => tempHome,
-  };
-});
-
-// Import after mock is set up
-const {
-  getConfigDir,
-  getConfigPath,
-  ensureConfigDir,
-  isFirstRun,
-  readConfig,
-  writeConfig,
-  addInstalledPackages,
-  removeInstalledPackage,
-  getSwarmkitVersion,
-  isConfigOutdated,
-} = await import("./global.js");
-
-describe("config/global", () => {
-  beforeEach(() => {
-    tempHome = mkdtempSync(join(tmpdir(), "swarmkit-test-"));
-  });
-
-  afterEach(() => {
-    rmSync(tempHome, { recursive: true, force: true });
-  });
-
-  describe("getConfigDir", () => {
-    it("returns ~/.swarmkit", () => {
-      expect(getConfigDir()).toBe(join(tempHome, ".swarmkit"));
-    });
-  });
-
-  describe("getConfigPath", () => {
-    it("returns ~/.swarmkit/config.json", () => {
-      expect(getConfigPath()).toBe(join(tempHome, ".swarmkit", "config.json"));
-    });
-  });
-
-  describe("ensureConfigDir", () => {
-    it("creates the config directory if it does not exist", () => {
-      ensureConfigDir();
-      expect(existsSync(join(tempHome, ".swarmkit"))).toBe(true);
-    });
-
-    it("creates the keys subdirectory", () => {
-      ensureConfigDir();
-      expect(existsSync(join(tempHome, ".swarmkit", "keys"))).toBe(true);
-    });
-
-    it("sets directory permissions to 0700", () => {
-      ensureConfigDir();
-      const stats = statSync(join(tempHome, ".swarmkit"));
-      expect(stats.mode & 0o777).toBe(0o700);
-    });
-
-    it("is idempotent", () => {
-      ensureConfigDir();
-      ensureConfigDir();
-      expect(existsSync(join(tempHome, ".swarmkit"))).toBe(true);
-    });
-  });
-
-  describe("isFirstRun", () => {
-    it("returns true when config does not exist", () => {
-      expect(isFirstRun()).toBe(true);
-    });
-
-    it("returns false after writing config", () => {
-      writeConfig({ installedPackages: [] });
-      expect(isFirstRun()).toBe(false);
-    });
-  });
-
-  describe("readConfig", () => {
-    it("returns defaults when no config exists", () => {
-      const config = readConfig();
-      expect(config.installedPackages).toEqual([]);
-      expect(config.embeddingProvider).toBeUndefined();
-    });
-
-    it("reads written config", () => {
-      writeConfig({
-        installedPackages: ["opentasks"],
-        embeddingProvider: "openai",
-        embeddingModel: "text-embedding-3-small",
-      });
-
-      const config = readConfig();
-      expect(config.installedPackages).toEqual(["opentasks"]);
-      expect(config.embeddingProvider).toBe("openai");
-      expect(config.embeddingModel).toBe("text-embedding-3-small");
-    });
-
-    it("returns defaults for corrupt config file", async () => {
-      ensureConfigDir();
-      const { writeFileSync } = await import("node:fs");
-      writeFileSync(getConfigPath(), "not json");
-
-      const config = readConfig();
-      expect(config.installedPackages).toEqual([]);
-    });
-
-    it("merges partial config with defaults", async () => {
-      ensureConfigDir();
-      const { writeFileSync } = await import("node:fs");
-      writeFileSync(
-        getConfigPath(),
-        JSON.stringify({ embeddingProvider: "gemini" }),
-      );
-
-      const config = readConfig();
-      expect(config.installedPackages).toEqual([]);
-      expect(config.embeddingProvider).toBe("gemini");
-    });
-  });
-
-  describe("writeConfig", () => {
-    it("creates the config directory if needed", () => {
-      writeConfig({ installedPackages: [] });
-      expect(existsSync(join(tempHome, ".swarmkit"))).toBe(true);
-    });
-
-    it("writes valid JSON", () => {
-      writeConfig({ installedPackages: ["minimem"] });
-      const raw = readFileSync(getConfigPath(), "utf-8");
-      const parsed = JSON.parse(raw);
-      expect(parsed.installedPackages).toEqual(["minimem"]);
-    });
-
-    it("sets file permissions to 0600", () => {
-      writeConfig({ installedPackages: [] });
-      const stats = statSync(getConfigPath());
-      expect(stats.mode & 0o777).toBe(0o600);
-    });
-  });
-
-  describe("addInstalledPackages", () => {
-    it("adds packages to an empty list", () => {
-      writeConfig({ installedPackages: [] });
-      addInstalledPackages(["opentasks", "minimem"]);
-
-      const config = readConfig();
-      expect(config.installedPackages).toEqual(["minimem", "opentasks"]);
-    });
-
-    it("deduplicates packages", () => {
-      writeConfig({ installedPackages: ["opentasks"] });
-      addInstalledPackages(["opentasks", "minimem"]);
-
-      const config = readConfig();
-      expect(config.installedPackages).toEqual(["minimem", "opentasks"]);
-    });
-
-    it("sorts packages alphabetically", () => {
-      addInstalledPackages(["minimem", "cognitive-core", "opentasks"]);
-
-      const config = readConfig();
-      expect(config.installedPackages).toEqual([
-        "cognitive-core",
-        "minimem",
-        "opentasks",
-      ]);
-    });
-
-    it("preserves other config fields", () => {
-      writeConfig({
-        installedPackages: [],
-        embeddingProvider: "openai",
-      });
-      addInstalledPackages(["minimem"]);
-
-      const config = readConfig();
-      expect(config.embeddingProvider).toBe("openai");
-    });
-  });
-
-  describe("removeInstalledPackage", () => {
-    it("removes a package from the list", () => {
-      writeConfig({ installedPackages: ["opentasks", "minimem"] });
-      removeInstalledPackage("minimem");
-
-      const config = readConfig();
-      expect(config.installedPackages).toEqual(["opentasks"]);
-    });
-
-    it("does nothing if package is not in list", () => {
-      writeConfig({ installedPackages: ["opentasks"] });
-      removeInstalledPackage("minimem");
-
-      const config = readConfig();
-      expect(config.installedPackages).toEqual(["opentasks"]);
-    });
-
-    it("preserves other config fields", () => {
-      writeConfig({
-        installedPackages: ["minimem"],
-        embeddingProvider: "gemini",
-      });
-      removeInstalledPackage("minimem");
-
-      const config = readConfig();
-      expect(config.embeddingProvider).toBe("gemini");
-    });
-  });
-
-  describe("getSwarmkitVersion", () => {
-    it("returns a semver string", () => {
-      const version = getSwarmkitVersion();
-      expect(version).toMatch(/^\d+\.\d+\.\d+/);
-    });
-  });
-
-  describe("isConfigOutdated", () => {
-    it("returns true when configVersion is missing", () => {
-      const config = { installedPackages: [] };
-      expect(isConfigOutdated(config, "1.0.0")).toBe(true);
-    });
-
-    it("returns false when versions match exactly", () => {
-      const config = { installedPackages: [], configVersion: "1.2.3" };
-      expect(isConfigOutdated(config, "1.2.3")).toBe(false);
-    });
-
-    it("returns false for patch-only difference", () => {
-      const config = { installedPackages: [], configVersion: "1.2.0" };
-      expect(isConfigOutdated(config, "1.2.5")).toBe(false);
-    });
-
-    it("returns true when minor version differs", () => {
-      const config = { installedPackages: [], configVersion: "1.0.0" };
-      expect(isConfigOutdated(config, "1.1.0")).toBe(true);
-    });
-
-    it("returns true when major version differs", () => {
-      const config = { installedPackages: [], configVersion: "0.1.0" };
-      expect(isConfigOutdated(config, "1.0.0")).toBe(true);
-    });
-
-    it("uses getSwarmkitVersion when currentVersion is not provided", () => {
-      const version = getSwarmkitVersion();
-      const config = { installedPackages: [], configVersion: version };
-      expect(isConfigOutdated(config)).toBe(false);
-    });
-  });
-});

package/references/swarmkit/src/config/global.ts

@@ -1,141 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-export interface GlobalConfig {
-  /** Packages installed by swarmkit */
-  installedPackages: string[];
-  /** Embedding provider preference */
-  embeddingProvider?: "openai" | "gemini" | "local";
-  /** Embedding model (provider-specific) */
-  embeddingModel?: string;
-  /** Whether project configs are nested under .swarm/ (default true) */
-  usePrefix?: boolean;
-  /** The swarmkit version that last ran full global setup */
-  configVersion?: string;
-}
-
-const DEFAULT_CONFIG: GlobalConfig = {
-  installedPackages: [],
-};
-
-/** Get the swarmkit config directory path (~/.swarmkit/) */
-export function getConfigDir(): string {
-  return join(homedir(), ".swarmkit");
-}
-
-/** Get the config file path (~/.swarmkit/config.json) */
-export function getConfigPath(): string {
-  return join(getConfigDir(), "config.json");
-}
-
-/** Ensure the config directory exists with correct permissions */
-export function ensureConfigDir(): void {
-  const dir = getConfigDir();
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true, mode: 0o700 });
-  }
-
-  const keysDir = join(dir, "keys");
-  if (!existsSync(keysDir)) {
-    mkdirSync(keysDir, { recursive: true, mode: 0o700 });
-  }
-}
-
-/** Check if this is the first time running swarmkit */
-export function isFirstRun(): boolean {
-  return !existsSync(getConfigPath());
-}
-
-/** Read the global config, returning defaults if it doesn't exist */
-export function readConfig(): GlobalConfig {
-  const path = getConfigPath();
-  if (!existsSync(path)) {
-    return { ...DEFAULT_CONFIG };
-  }
-
-  try {
-    const raw = readFileSync(path, "utf-8");
-    const parsed = JSON.parse(raw) as Partial<GlobalConfig>;
-    return {
-      ...DEFAULT_CONFIG,
-      ...parsed,
-    };
-  } catch {
-    return { ...DEFAULT_CONFIG };
-  }
-}
-
-/** Write the global config */
-export function writeConfig(config: GlobalConfig): void {
-  ensureConfigDir();
-  const path = getConfigPath();
-  writeFileSync(path, JSON.stringify(config, null, 2) + "\n", {
-    mode: 0o600,
-  });
-}
-
-/** Add packages to the installed list (deduplicates) */
-export function addInstalledPackages(packages: string[]): void {
-  const config = readConfig();
-  const existing = new Set(config.installedPackages);
-  for (const pkg of packages) {
-    existing.add(pkg);
-  }
-  config.installedPackages = [...existing].sort();
-  writeConfig(config);
-}
-
-/** Remove a package from the installed list */
-export function removeInstalledPackage(packageName: string): void {
-  const config = readConfig();
-  config.installedPackages = config.installedPackages.filter(
-    (p) => p !== packageName,
-  );
-  writeConfig(config);
-}
-
-/** Get the current swarmkit version from package.json */
-export function getSwarmkitVersion(): string {
-  try {
-    const __dirname = dirname(fileURLToPath(import.meta.url));
-    const pkgPath = join(__dirname, "..", "package.json");
-    const pkg = JSON.parse(readFileSync(pkgPath, "utf-8")) as {
-      version: string;
-    };
-    return pkg.version;
-  } catch {
-    return "0.0.0";
-  }
-}
-
-function parseVersion(version: string): {
-  major: number;
-  minor: number;
-  patch: number;
-} {
-  const parts = version.split(".").map(Number);
-  return {
-    major: parts[0] ?? 0,
-    minor: parts[1] ?? 0,
-    patch: parts[2] ?? 0,
-  };
-}
-
-/**
- * Check if the config version is outdated compared to the current swarmkit version.
- * Outdated if configVersion is missing or major/minor version differs.
- * Patch-only bumps are not considered outdated.
- */
-export function isConfigOutdated(
-  config: GlobalConfig,
-  currentVersion?: string,
-): boolean {
-  if (!config.configVersion) return true;
-
-  const current = parseVersion(currentVersion ?? getSwarmkitVersion());
-  const saved = parseVersion(config.configVersion);
-
-  return current.major !== saved.major || current.minor !== saved.minor;
-}