@canonical/pragma-cli 0.30.0 → 0.32.0

package/src/domains/info/formatters/info.ts

@@ -1,131 +0,0 @@
-import chalk from "chalk";
-import { formatField, formatHeading } from "#pipeline";
-import type { InfoData } from "../types.js";
-
-/**
- * Renders `pragma info` output for a plain terminal.
- *
- * Includes chalk-styled version, config, update status, and store summary.
- *
- * @param data - The collected info data.
- * @returns A formatted terminal string.
- */
-function renderInfoPlain(data: InfoData): string {
-  const lines: string[] = [];
-
-  lines.push(`pragma v${data.version}`);
-
-  lines.push(formatField("  Installed via:", data.installSource));
-
-  lines.push(formatField("  Config:", data.configPath));
-
-  if (data.tier) {
-    const chain = data.tierChain.join(" → ");
-    lines.push(formatField("    tier:", `${data.tier} (${chain})`));
-  } else {
-    lines.push(formatField("    tier:", "(none)"));
-  }
-
-  const releases = data.channelReleases.join(", ");
-  lines.push(formatField("    channel:", `${data.channel} (${releases})`));
-
-  lines.push("");
-  lines.push(formatHeading("Update"));
-  if (data.update) {
-    lines.push(
-      `  ${data.update.current} → ${chalk.green(data.update.latest)} available`,
-    );
-    lines.push(`  Run ${chalk.cyan(`\`${data.update.command}\``)} to upgrade.`);
-    lines.push(`  Or run ${chalk.cyan("`pragma upgrade`")}.`);
-  } else if (data.updateSkipped) {
-    lines.push("  Upgrade check skipped (offline)");
-  } else {
-    lines.push("  Up to date.");
-  }
-
-  if (data.packageRefs && data.packageRefs.length > 0) {
-    lines.push("");
-    lines.push(formatHeading("Packages"));
-    for (const ref of data.packageRefs) {
-      lines.push(formatField(`  ${ref.pkg}:`, `${ref.source} (${ref.detail})`));
-    }
-  }
-
-  if (data.store) {
-    lines.push("");
-    lines.push(formatHeading("Store"));
-    lines.push(
-      formatField("  Triples:", data.store.tripleCount.toLocaleString()),
-    );
-    if (data.store.graphNames.length > 0) {
-      lines.push(
-        formatField(
-          "  Graphs:",
-          `default, ${data.store.graphNames.join(", ")}`,
-        ),
-      );
-    } else {
-      lines.push(formatField("  Graphs:", "default"));
-    }
-  }
-
-  return lines.join("\n");
-}
-
-/**
- * Renders `pragma info` output as condensed Markdown for LLM consumption.
- *
- * @param data - The collected info data.
- * @returns A Markdown string.
- */
-function renderInfoLlm(data: InfoData): string {
-  const lines: string[] = [];
-
-  lines.push(`# pragma v${data.version}`);
-  lines.push(`- Installed via: ${data.installSource}`);
-
-  if (data.tier) {
-    lines.push(`- Tier: ${data.tier} (${data.tierChain.join(" → ")})`);
-  } else {
-    lines.push("- Tier: (none)");
-  }
-  lines.push(`- Channel: ${data.channel} (${data.channelReleases.join(", ")})`);
-
-  if (data.update) {
-    lines.push(
-      `- Update: ${data.update.current} → ${data.update.latest} available`,
-    );
-  } else if (data.updateSkipped) {
-    lines.push("- Update: check skipped (offline)");
-  } else {
-    lines.push("- Update: up to date");
-  }
-
-  if (data.packageRefs && data.packageRefs.length > 0) {
-    lines.push("## Packages");
-    for (const ref of data.packageRefs) {
-      lines.push(`- ${ref.pkg}: ${ref.source} (${ref.detail})`);
-    }
-  }
-
-  if (data.store) {
-    lines.push(`- Store: ${data.store.tripleCount.toLocaleString()} triples`);
-    if (data.store.graphNames.length > 0) {
-      lines.push(`- Graphs: default, ${data.store.graphNames.join(", ")}`);
-    }
-  }
-
-  return lines.join("\n");
-}
-
-/**
- * Renders `pragma info` output as indented JSON.
- *
- * @param data - The collected info data.
- * @returns A JSON string.
- */
-function renderInfoJson(data: InfoData): string {
-  return JSON.stringify(data, null, 2);
-}
-
-export { renderInfoJson, renderInfoLlm, renderInfoPlain };

package/src/domains/info/formatters/upgrade.test.ts

@@ -1,133 +0,0 @@
-import { describe, expect, it } from "vitest";
-import type { UpgradeData } from "../types.js";
-import {
-  renderUpgradeJson,
-  renderUpgradeLlm,
-  renderUpgradePlain,
-} from "./upgrade.js";
-
-function createUpgradeData(overrides: Partial<UpgradeData> = {}): UpgradeData {
-  return {
-    pm: "bun",
-    current: "0.18.0",
-    latest: "0.19.0",
-    command: "bun update -g @canonical/pragma-cli",
-    dryRun: false,
-    alreadyLatest: false,
-    offline: false,
-    executed: true,
-    ...overrides,
-  };
-}
-
-describe("renderUpgradePlain", () => {
-  it("shows PM info", () => {
-    const output = renderUpgradePlain(createUpgradeData());
-    expect(output).toContain("bun (global)");
-  });
-
-  it("shows version transition", () => {
-    const output = renderUpgradePlain(createUpgradeData());
-    expect(output).toContain("0.18.0");
-    expect(output).toContain("0.19.0");
-  });
-
-  it("shows executed message", () => {
-    const output = renderUpgradePlain(createUpgradeData());
-    expect(output).toContain("done. Updated to 0.19.0");
-  });
-
-  it("shows dry-run message", () => {
-    const output = renderUpgradePlain(createUpgradeData({ dryRun: true }));
-    expect(output).toContain("Would run");
-    expect(output).not.toContain("done.");
-  });
-
-  it("shows already latest", () => {
-    const output = renderUpgradePlain(
-      createUpgradeData({ alreadyLatest: true }),
-    );
-    expect(output).toContain("Already at latest version");
-  });
-
-  it("shows offline message", () => {
-    const output = renderUpgradePlain(
-      createUpgradeData({ offline: true, latest: undefined }),
-    );
-    expect(output).toContain("Could not reach registry");
-  });
-
-  it("uses npm command for npm PM", () => {
-    const output = renderUpgradePlain(
-      createUpgradeData({
-        pm: "npm",
-        command: "npm update -g @canonical/pragma-cli",
-      }),
-    );
-    expect(output).toContain("npm update -g @canonical/pragma-cli");
-  });
-
-  it("uses yarn command for yarn PM", () => {
-    const output = renderUpgradePlain(
-      createUpgradeData({
-        pm: "yarn",
-        command: "yarn global upgrade @canonical/pragma-cli",
-      }),
-    );
-    expect(output).toContain("yarn global upgrade @canonical/pragma-cli");
-  });
-});
-
-describe("renderUpgradeLlm", () => {
-  it("shows upgrade transition", () => {
-    const output = renderUpgradeLlm(createUpgradeData());
-    expect(output).toContain("0.18.0 → 0.19.0");
-  });
-
-  it("shows dry-run info", () => {
-    const output = renderUpgradeLlm(createUpgradeData({ dryRun: true }));
-    expect(output).toContain("Would upgrade");
-    expect(output).toContain("Command:");
-  });
-
-  it("shows already latest", () => {
-    const output = renderUpgradeLlm(createUpgradeData({ alreadyLatest: true }));
-    expect(output).toContain("Already at latest");
-  });
-
-  it("shows offline", () => {
-    const output = renderUpgradeLlm(
-      createUpgradeData({ offline: true, latest: undefined }),
-    );
-    expect(output).toContain("could not reach registry");
-  });
-});
-
-describe("renderUpgradeJson", () => {
-  it("produces valid JSON", () => {
-    const data = createUpgradeData();
-    const parsed = JSON.parse(renderUpgradeJson(data));
-    expect(parsed.pm).toBe("bun");
-    expect(parsed.current).toBe("0.18.0");
-    expect(parsed.latest).toBe("0.19.0");
-  });
-
-  it("includes all fields", () => {
-    const parsed = JSON.parse(renderUpgradeJson(createUpgradeData()));
-    expect(parsed).toHaveProperty("dryRun");
-    expect(parsed).toHaveProperty("alreadyLatest");
-    expect(parsed).toHaveProperty("offline");
-    expect(parsed).toHaveProperty("executed");
-    expect(parsed).toHaveProperty("command");
-  });
-
-  it("handles offline case", () => {
-    const parsed = JSON.parse(
-      renderUpgradeJson(
-        createUpgradeData({ offline: true, latest: undefined }),
-      ),
-    );
-    expect(parsed.offline).toBe(true);
-    expect(parsed.latest).toBeUndefined();
-  });
-});

package/src/domains/info/formatters/upgrade.ts

@@ -1,68 +0,0 @@
-import chalk from "chalk";
-import type { UpgradeData } from "../types.js";
-
-/**
- * Renders `pragma upgrade` output for a plain terminal.
- *
- * Shows version comparison, dry-run notice, or completion status with chalk styling.
- *
- * @param data - The upgrade outcome data.
- * @returns A formatted terminal string.
- */
-function renderUpgradePlain(data: UpgradeData): string {
-  const lines: string[] = [];
-
-  lines.push(`Installed via: ${data.pm} (global)`);
-
-  if (data.offline) {
-    lines.push("Could not reach registry");
-    return lines.join("\n");
-  }
-
-  if (data.alreadyLatest) {
-    lines.push(`Already at latest version (${data.current}).`);
-    return lines.join("\n");
-  }
-
-  lines.push("");
-  lines.push(
-    `@canonical/pragma-cli  ${data.current} → ${chalk.green(data.latest)}`,
-  );
-  lines.push("");
-
-  if (data.dryRun) {
-    lines.push(`Would run: ${chalk.cyan(data.command)}`);
-  } else {
-    lines.push(`Running: ${chalk.cyan(data.command)}`);
-    lines.push("");
-    lines.push(`done. Updated to ${data.latest}.`);
-  }
-
-  return lines.join("\n");
-}
-
-/**
- * Renders `pragma upgrade` output as condensed Markdown for LLM consumption.
- *
- * @param data - The upgrade outcome data.
- * @returns A single-line Markdown string.
- */
-function renderUpgradeLlm(data: UpgradeData): string {
-  if (data.offline) return "Upgrade check failed: could not reach registry";
-  if (data.alreadyLatest) return `Already at latest version (${data.current})`;
-  if (data.dryRun)
-    return `Would upgrade: ${data.current} → ${data.latest}\nCommand: ${data.command}`;
-  return `Upgraded: ${data.current} → ${data.latest}`;
-}
-
-/**
- * Renders `pragma upgrade` output as indented JSON.
- *
- * @param data - The upgrade outcome data.
- * @returns A JSON string.
- */
-function renderUpgradeJson(data: UpgradeData): string {
-  return JSON.stringify(data, null, 2);
-}
-
-export { renderUpgradeJson, renderUpgradeLlm, renderUpgradePlain };

package/src/domains/info/index.ts

@@ -1,9 +0,0 @@
-/**
- * @module Info domain barrel.
- *
- * Provides the `pragma info` and `pragma upgrade` commands,
- * and the `info` MCP tool spec.
- */
-
-export { infoCommand, upgradeCommand } from "./commands/index.js";
-export { specs as infoSpecs } from "./mcp/index.js";

package/src/domains/info/mcp/index.ts

@@ -1,2 +0,0 @@
-/** @module Info domain MCP barrel — info. */
-export { default as specs } from "./specs.js";

package/src/domains/info/mcp/specs.ts

@@ -1,65 +0,0 @@
-/**
- * MCP tool spec for the info domain.
- *
- * Uses shared operations (collectStoreSummary, resolveTierChain) instead of
- * inlining data assembly. Skips the npm registry check to avoid network
- * latency in MCP tool calls — sets `updateSkipped: true`.
- */
-
-import { VERSION } from "#constants";
-import { detectInstallSource } from "#package-manager";
-import { CHANNEL_RELEASES } from "../../shared/filters/buildChannelFilter.js";
-import { resolveTierChain } from "../../shared/filters/buildTierFilter.js";
-import type { ToolSpec } from "../../shared/ToolSpec.js";
-import { renderInfoLlm } from "../formatters/index.js";
-import { collectStoreSummary } from "../operations/index.js";
-import type { InfoData } from "../types.js";
-
-const specs: readonly ToolSpec[] = [
-  {
-    name: "info",
-    description: "Show pragma version, configuration, and store summary.",
-    params: {
-      condensed: {
-        type: "boolean",
-        description: "Token-optimized output",
-        optional: true,
-      },
-    },
-    readOnly: true,
-    async execute(rt, params) {
-      const install = detectInstallSource();
-      const tierChain =
-        rt.config.tier !== undefined ? resolveTierChain(rt.config.tier) : [];
-      const channelReleases = CHANNEL_RELEASES[rt.config.channel];
-      const storeSummary = await collectStoreSummary(rt.store);
-
-      const data: InfoData = {
-        version: VERSION,
-        pm: install.packageManager,
-        installSource: install.label,
-        configPath: "pragma.config.json",
-        tier: rt.config.tier,
-        tierChain,
-        channel: rt.config.channel,
-        channelReleases: [...channelReleases],
-        update: undefined,
-        updateSkipped: true,
-        store: storeSummary,
-      };
-
-      if (params.condensed) {
-        const text = renderInfoLlm(data);
-        return {
-          condensed: true,
-          text,
-          tokens: `~${Math.ceil(text.length / 4)}`,
-        };
-      }
-
-      return { data };
-    },
-  },
-];
-
-export default specs;

package/src/domains/info/operations/checkRegistryVersion.test.ts

@@ -1,124 +0,0 @@
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import checkRegistryVersion from "./checkRegistryVersion.js";
-
-describe("checkRegistryVersion", () => {
-  const originalFetch = globalThis.fetch;
-
-  beforeEach(() => {
-    vi.restoreAllMocks();
-  });
-
-  afterEach(() => {
-    globalThis.fetch = originalFetch;
-  });
-
-  it("returns latest version for normal channel", async () => {
-    globalThis.fetch = vi.fn().mockResolvedValue({
-      ok: true,
-      json: () =>
-        Promise.resolve({
-          "dist-tags": { latest: "0.19.0", experimental: "0.20.0-exp.1" },
-        }),
-    });
-
-    const result = await checkRegistryVersion(
-      "@canonical/pragma-cli",
-      "normal",
-    );
-
-    expect(result).toEqual({ latest: "0.19.0", distTag: "latest" });
-    expect(globalThis.fetch).toHaveBeenCalledWith(
-      "https://registry.npmjs.org/%40canonical%2Fpragma-cli",
-      expect.objectContaining({
-        headers: { Accept: "application/json" },
-      }),
-    );
-  });
-
-  it("returns experimental version for experimental channel", async () => {
-    globalThis.fetch = vi.fn().mockResolvedValue({
-      ok: true,
-      json: () =>
-        Promise.resolve({
-          "dist-tags": { latest: "0.19.0", experimental: "0.20.0-exp.1" },
-        }),
-    });
-
-    const result = await checkRegistryVersion(
-      "@canonical/pragma-cli",
-      "experimental",
-    );
-
-    expect(result).toEqual({
-      latest: "0.20.0-exp.1",
-      distTag: "experimental",
-    });
-  });
-
-  it("returns next version for prerelease channel", async () => {
-    globalThis.fetch = vi.fn().mockResolvedValue({
-      ok: true,
-      json: () =>
-        Promise.resolve({
-          "dist-tags": { latest: "0.19.0", next: "0.20.0-rc.1" },
-        }),
-    });
-
-    const result = await checkRegistryVersion(
-      "@canonical/pragma-cli",
-      "prerelease",
-    );
-
-    expect(result).toEqual({ latest: "0.20.0-rc.1", distTag: "next" });
-  });
-
-  it("returns undefined when registry responds with non-ok status", async () => {
-    globalThis.fetch = vi.fn().mockResolvedValue({ ok: false, status: 404 });
-
-    const result = await checkRegistryVersion(
-      "@canonical/pragma-cli",
-      "normal",
-    );
-
-    expect(result).toBeUndefined();
-  });
-
-  it("returns undefined when dist-tag is missing", async () => {
-    globalThis.fetch = vi.fn().mockResolvedValue({
-      ok: true,
-      json: () => Promise.resolve({ "dist-tags": { latest: "0.19.0" } }),
-    });
-
-    const result = await checkRegistryVersion(
-      "@canonical/pragma-cli",
-      "prerelease",
-    );
-
-    expect(result).toBeUndefined();
-  });
-
-  it("returns undefined when fetch throws (offline)", async () => {
-    globalThis.fetch = vi.fn().mockRejectedValue(new Error("network error"));
-
-    const result = await checkRegistryVersion(
-      "@canonical/pragma-cli",
-      "normal",
-    );
-
-    expect(result).toBeUndefined();
-  });
-
-  it("returns undefined when response has no dist-tags", async () => {
-    globalThis.fetch = vi.fn().mockResolvedValue({
-      ok: true,
-      json: () => Promise.resolve({}),
-    });
-
-    const result = await checkRegistryVersion(
-      "@canonical/pragma-cli",
-      "normal",
-    );
-
-    expect(result).toBeUndefined();
-  });
-});

package/src/domains/info/operations/checkRegistryVersion.ts

@@ -1,45 +0,0 @@
-import type { Channel } from "#constants";
-import { DIST_TAG_MAP, REGISTRY_TIMEOUT_MS } from "../constants.js";
-import type { RegistryCheckResult } from "../types.js";
-
-/**
- * Checks the npm registry for the latest published version of a package.
- *
- * Returns `undefined` when offline or when the registry does not respond
- * within the configured timeout ({@link REGISTRY_TIMEOUT_MS}).
- *
- * @note Impure
- *
- * @param packageName - The npm package name (e.g. `@canonical/pragma-cli`).
- * @param channel - The release channel determining which dist-tag to check.
- * @returns A {@link RegistryCheckResult} with the latest version, or `undefined` on failure.
- */
-async function checkRegistryVersion(
-  packageName: string,
-  channel: Channel,
-): Promise<RegistryCheckResult | undefined> {
-  const distTag = DIST_TAG_MAP[channel];
-  const url = `https://registry.npmjs.org/${encodeURIComponent(packageName)}`;
-
-  try {
-    const response = await fetch(url, {
-      signal: AbortSignal.timeout(REGISTRY_TIMEOUT_MS),
-      headers: { Accept: "application/json" },
-    });
-
-    if (!response.ok) return undefined;
-
-    const data = (await response.json()) as {
-      "dist-tags"?: Record<string, string>;
-    };
-
-    const version = data["dist-tags"]?.[distTag];
-    if (!version) return undefined;
-
-    return { latest: version, distTag };
-  } catch {
-    return undefined;
-  }
-}
-
-export default checkRegistryVersion;

package/src/domains/info/operations/collectInfo.test.ts

@@ -1,122 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
-
-const readConfigLayersMock = vi.fn();
-const detectInstallSourceMock = vi.fn();
-const bootStoreMock = vi.fn();
-const checkRegistryVersionMock = vi.fn();
-const collectStoreSummaryMock = vi.fn();
-
-vi.mock("#config", async (importOriginal) => ({
-  ...(await importOriginal<typeof import("#config")>()),
-  readConfigLayers: readConfigLayersMock,
-}));
-
-vi.mock("#package-manager", async (importOriginal) => {
-  const actual = await importOriginal<typeof import("#package-manager")>();
-  return {
-    ...actual,
-    detectInstallSource: detectInstallSourceMock,
-    PM_COMMANDS: {
-      ...actual.PM_COMMANDS,
-      bun: {
-        ...actual.PM_COMMANDS.bun,
-        update: (pkg: string) => `bun update ${pkg}`,
-      },
-    },
-  };
-});
-
-vi.mock("../../shared/bootStore.js", () => ({
-  bootStore: bootStoreMock,
-}));
-
-vi.mock("./checkRegistryVersion.js", () => ({
-  default: checkRegistryVersionMock,
-}));
-
-vi.mock("./collectStoreSummary.js", () => ({
-  collectStoreSummary: collectStoreSummaryMock,
-}));
-
-describe("collectInfo", () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-    detectInstallSourceMock.mockReturnValue({
-      packageManager: "bun",
-      scope: "global",
-      label: "bun (global)",
-    });
-    readConfigLayersMock.mockReturnValue({
-      config: { tier: "apps/lxd", channel: "normal" },
-      origins: {
-        tier: "project",
-        channel: "default",
-        packages: "default",
-        trace: "default",
-        framework: "default",
-      },
-      global: { path: "/home/u/.config/pragma/config.json", exists: false },
-      project: { path: "/repo/pragma.config.json", exists: true },
-    });
-  });
-
-  it("includes update information and store summary when available", async () => {
-    const dispose = vi.fn();
-    bootStoreMock.mockResolvedValue({ store: { dispose }, packages: [] });
-    checkRegistryVersionMock.mockResolvedValue({
-      latest: "9.9.9",
-      distTag: "latest",
-    });
-    collectStoreSummaryMock.mockResolvedValue({
-      tripleCount: 42,
-      graphNames: ["default"],
-    });
-
-    const { default: collectInfo } = await import("./collectInfo.js");
-    const result = await collectInfo("/workspace");
-
-    expect(result.update).toEqual({
-      current: expect.any(String),
-      latest: "9.9.9",
-      command: "bun update @canonical/pragma-cli",
-    });
-    expect(result.installSource).toBe("bun (global)");
-    expect(result.updateSkipped).toBe(false);
-    expect(result.store).toEqual({ tripleCount: 42, graphNames: ["default"] });
-    expect(result.tierChain.length).toBeGreaterThan(0);
-    expect(dispose).toHaveBeenCalledTimes(1);
-  });
-
-  it("marks update as skipped and omits store when registry and store are unavailable", async () => {
-    checkRegistryVersionMock.mockResolvedValue(undefined);
-    bootStoreMock.mockRejectedValue(new Error("store unavailable"));
-
-    const { default: collectInfo } = await import("./collectInfo.js");
-    const result = await collectInfo("/workspace");
-
-    expect(result.update).toBeUndefined();
-    expect(result.updateSkipped).toBe(true);
-    expect(result.store).toBeUndefined();
-  });
-
-  it("omits the update section when already on the latest version", async () => {
-    const { VERSION } = await import("#constants");
-    const dispose = vi.fn();
-    bootStoreMock.mockResolvedValue({ store: { dispose }, packages: [] });
-    checkRegistryVersionMock.mockResolvedValue({
-      latest: VERSION,
-      distTag: "latest",
-    });
-    collectStoreSummaryMock.mockResolvedValue({
-      tripleCount: 10,
-      graphNames: ["default"],
-    });
-
-    const { default: collectInfo } = await import("./collectInfo.js");
-    const result = await collectInfo("/workspace");
-
-    expect(result.update).toBeUndefined();
-    expect(result.updateSkipped).toBe(false);
-    expect(result.store?.tripleCount).toBe(10);
-  });
-});