@pi-stef/catalog 0.2.2

package/src/commands/profiles.ts

@@ -0,0 +1,147 @@
+/**
+ * `ct profiles` and `ct profile` subcommand implementations.
+ *
+ * `ct profiles` lists all profiles with an active indicator.
+ * `ct profile <name>` switches the active profile.
+ * `ct profile <name> --create` creates a new empty profile.
+ * `ct profile <name> --delete` deletes a profile (with confirmation).
+ */
+
+import type { CommandArgs, CommandCtx } from "./types.js";
+import { readCatalog, writeCatalog } from "../config/io.js";
+import {
+  createProfile,
+  switchProfile,
+  deleteProfile,
+  DEFAULT_PROFILE,
+} from "../profiles/manager.js";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** Context for profile commands. Extends base with `confirm` for deletion. */
+export interface ProfilesCtx extends CommandCtx {
+  ui: CommandCtx["ui"] & {
+    confirm?: (message: string) => Promise<boolean>;
+  };
+}
+
+// ---------------------------------------------------------------------------
+// profilesCommand
+// ---------------------------------------------------------------------------
+
+/**
+ * Execute the `ct profiles` subcommand.
+ *
+ * Lists all available profiles, marking the active one with `*`.
+ * The default profile is always listed.
+ */
+export async function profilesCommand(
+  _args: CommandArgs,
+  ctx: ProfilesCtx,
+): Promise<void> {
+  const catalog = readCatalog(ctx.home);
+  const active = catalog.meta.activeProfile ?? DEFAULT_PROFILE;
+  const profileNames = Object.keys(catalog.profiles ?? {});
+
+  const lines: string[] = ["Profiles:"];
+
+  // Default profile is always available
+  const defaultMarker = active === DEFAULT_PROFILE ? " *" : "";
+  lines.push(`  ${DEFAULT_PROFILE}${defaultMarker}`);
+
+  // Named profiles
+  for (const name of profileNames.sort()) {
+    const marker = active === name ? " *" : "";
+    lines.push(`  ${name}${marker}`);
+  }
+
+  ctx.ui.notify(lines.join("\n"), "info");
+}
+
+// ---------------------------------------------------------------------------
+// profileCommand
+// ---------------------------------------------------------------------------
+
+/**
+ * Execute the `ct profile` subcommand.
+ *
+ * Modes:
+ *   - No positional args: show current profile
+ *   - `ct profile <name>`: switch to the named profile
+ *   - `ct profile <name> --create`: create a new profile
+ *   - `ct profile <name> --delete`: delete a profile (prompts for confirmation)
+ */
+export async function profileCommand(
+  args: CommandArgs,
+  ctx: ProfilesCtx,
+): Promise<void> {
+  const { positional, flags } = args;
+  const name = positional[0];
+
+  // --- Show current profile ---
+  if (!name) {
+    const catalog = readCatalog(ctx.home);
+    const active = catalog.meta.activeProfile ?? DEFAULT_PROFILE;
+    ctx.ui.notify(`Current profile: ${active}`, "info");
+    return;
+  }
+
+  const catalog = readCatalog(ctx.home);
+
+  // --- Create mode ---
+  if (flags["create"]) {
+    try {
+      const updated = createProfile(catalog, name);
+      writeCatalog(updated, ctx.home);
+      ctx.ui.notify(`Created profile "${name}"`, "info");
+    } catch (err: unknown) {
+      const message = err instanceof Error ? err.message : String(err);
+      ctx.ui.notify(message, "error");
+    }
+    return;
+  }
+
+  // --- Delete mode ---
+  if (flags["delete"]) {
+    try {
+      // Pre-validate to catch errors before prompting
+      if (name === DEFAULT_PROFILE) {
+        throw new Error(`Cannot delete the "${DEFAULT_PROFILE}" profile`);
+      }
+      if (!catalog.profiles?.[name]) {
+        throw new Error(`Profile "${name}" not found`);
+      }
+
+      // Confirm deletion
+      if (ctx.ui.confirm) {
+        const confirmed = await ctx.ui.confirm(
+          `Delete profile "${name}"? This cannot be undone.`,
+        );
+        if (!confirmed) {
+          ctx.ui.notify("Cancelled", "info");
+          return;
+        }
+      }
+
+      const updated = deleteProfile(catalog, name);
+      writeCatalog(updated, ctx.home);
+      ctx.ui.notify(`Deleted profile "${name}"`, "info");
+    } catch (err: unknown) {
+      const message = err instanceof Error ? err.message : String(err);
+      ctx.ui.notify(message, "error");
+    }
+    return;
+  }
+
+  // --- Switch mode ---
+  try {
+    const updated = switchProfile(catalog, name);
+    writeCatalog(updated, ctx.home);
+    ctx.ui.notify(`Switched to profile "${name}"`, "info");
+  } catch (err: unknown) {
+    const message = err instanceof Error ? err.message : String(err);
+    ctx.ui.notify(message, "error");
+  }
+}

package/src/commands/remove.ts

@@ -0,0 +1,90 @@
+/**
+ * `ct remove` subcommand implementation.
+ *
+ * Removes a package from the catalog. Supports:
+ *   - `ct remove <name>` — prompts for confirmation, then removes
+ *   - `ct remove <name> --yes` — skips confirmation prompt
+ *   - After removing from catalog, runs `pi uninstall <name>`
+ *
+ * Uses `removePackage` from `crud.ts` for catalog mutation,
+ * and `writeCatalog` / `readCatalog` for persistence.
+ */
+
+import type { CommandArgs, CommandCtx } from "./types.js";
+import { removePackage } from "../catalog/crud.js";
+import { readCatalog, writeCatalog } from "../config/io.js";
+import { piUninstall } from "../util/exec.js";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** Context for `removeCommand`, extending the base with `confirm`. */
+export interface RemoveCtx extends CommandCtx {
+  ui: CommandCtx["ui"] & {
+    confirm?: (message: string) => Promise<boolean>;
+  };
+}
+
+// ---------------------------------------------------------------------------
+// removeCommand
+// ---------------------------------------------------------------------------
+
+/**
+ * Execute the `ct remove` subcommand.
+ *
+ * Reads the catalog, confirms removal, removes the package,
+ * writes the catalog, and runs `pi uninstall`.
+ */
+export async function removeCommand(
+  args: CommandArgs,
+  ctx: RemoveCtx,
+): Promise<void> {
+  const { positional, flags } = args;
+  const name = positional[0];
+
+  // --- Validate required args -----------------------------------------------
+  if (!name) {
+    ctx.ui.notify("Usage: ct remove <name> [--yes]", "error");
+    return;
+  }
+
+  // --- Read catalog ---------------------------------------------------------
+  const catalog = readCatalog(ctx.home);
+
+  // --- Validate package exists ----------------------------------------------
+  if (!catalog.packages[name]) {
+    ctx.ui.notify(`Package "${name}" not found`, "error");
+    return;
+  }
+
+  // --- Confirmation (skip with --yes / -y) ----------------------------------
+  const skipConfirm = "yes" in flags || "y" in flags;
+  if (!skipConfirm) {
+    if (ctx.ui.confirm) {
+      const confirmed = await ctx.ui.confirm(
+        `Remove package "${name}" from catalog?`,
+      );
+      if (!confirmed) {
+        ctx.ui.notify("Removal cancelled", "info");
+        return;
+      }
+    }
+  }
+
+  // --- Remove package -------------------------------------------------------
+  const updated = removePackage(catalog, name);
+  writeCatalog(updated, ctx.home);
+
+  ctx.ui.notify(`Removed "${name}" from catalog`, "info");
+
+  // --- Run pi uninstall -----------------------------------------------------
+  try {
+    await piUninstall(name);
+  } catch {
+    ctx.ui.notify(
+      `Warning: package "${name}" removed from catalog but uninstall failed`,
+      "warning",
+    );
+  }
+}

package/src/commands/status.ts

@@ -0,0 +1,142 @@
+/**
+ * `ct status` subcommand implementation.
+ *
+ * Shows catalog status: profile, package counts by rating,
+ * installed/missing/orphan counts, gist URL, and last sync time.
+ */
+
+import type { CommandArgs, CommandCtx } from "./types.js";
+import { readCatalog, readLock } from "../config/io.js";
+import { scanInstalled } from "../catalog/install.js";
+import { readCachedGistId } from "../sync/cache.js";
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/** Context for `statusCommand`. Uses the base `CommandCtx`. */
+export type StatusCtx = CommandCtx;
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+interface RatingCounts {
+  core: number;
+  useful: number;
+  debatable: number;
+  disabled: number;
+}
+
+function countByRating(
+  packages: Record<string, { rating: string; enabled?: boolean }>,
+): RatingCounts {
+  const counts: RatingCounts = { core: 0, useful: 0, debatable: 0, disabled: 0 };
+  for (const pkg of Object.values(packages)) {
+    const r = pkg.rating as keyof RatingCounts;
+    if (r in counts) {
+      counts[r]++;
+    }
+  }
+  return counts;
+}
+
+// ---------------------------------------------------------------------------
+// statusCommand
+// ---------------------------------------------------------------------------
+
+/**
+ * Execute the `ct status` subcommand.
+ *
+ * Reads catalog, lock, gist cache, and installed packages to build
+ * a comprehensive status summary.
+ */
+export async function statusCommand(
+  args: CommandArgs,
+  ctx: StatusCtx,
+): Promise<void> {
+  const { flags } = args;
+  const profile =
+    typeof flags["profile"] === "string" ? flags["profile"] : "default";
+
+  const catalog = readCatalog(ctx.home);
+  const lock = readLock(ctx.home);
+  const installed = scanInstalled(ctx.home);
+  const gistId = readCachedGistId(ctx.home);
+
+  const packages = catalog.packages;
+  const totalPackages = Object.keys(packages).length;
+
+  // --- Package counts by rating ---
+  const ratingCounts = countByRating(packages);
+
+  // --- Installed / missing / orphan ---
+  const catalogSources = new Set<string>();
+  for (const pkg of Object.values(packages)) {
+    catalogSources.add(pkg.source);
+  }
+
+  const installedSources = new Set<string>();
+  for (const inst of Object.values(installed)) {
+    installedSources.add(inst.source);
+  }
+
+  // Count how many catalog packages are actually installed
+  let installedCount = 0;
+  for (const pkg of Object.values(packages)) {
+    if (installedSources.has(pkg.source)) {
+      installedCount++;
+    }
+  }
+
+  // Missing = catalog packages not installed
+  const missingCount = totalPackages - installedCount;
+
+  // Orphans = installed packages not in catalog
+  let orphanCount = 0;
+  for (const inst of Object.values(installed)) {
+    if (!catalogSources.has(inst.source)) {
+      orphanCount++;
+    }
+  }
+
+  // --- Last sync time ---
+  let lastSync: string | undefined;
+  for (const lockPkg of Object.values(lock.packages)) {
+    if (!lastSync || lockPkg.installedAt > lastSync) {
+      lastSync = lockPkg.installedAt;
+    }
+  }
+
+  // --- Build status message ---
+  const lines: string[] = [];
+
+  // Profile
+  lines.push(`Profile: ${profile}`);
+
+  // Package counts
+  lines.push(
+    `Packages: ${totalPackages} total (core: ${ratingCounts.core}, useful: ${ratingCounts.useful}, debatable: ${ratingCounts.debatable}, disabled: ${ratingCounts.disabled})`,
+  );
+
+  // Installed/missing/orphan
+  lines.push(
+    `Installed: ${installedCount}, Missing: ${missingCount}, Orphans: ${orphanCount}`,
+  );
+
+  // Gist URL
+  if (gistId) {
+    lines.push(`Gist: https://gist.github.com/${gistId}`);
+  } else {
+    lines.push("No remote gist configured");
+  }
+
+  // Last sync
+  if (lastSync) {
+    lines.push(`Last sync: ${lastSync}`);
+  } else {
+    lines.push("Last sync: never synced");
+  }
+
+  ctx.ui.notify(lines.join("\n"), "info");
+}