@canonical/pragma-cli 0.31.0 → 0.32.0

package/src/domains/modifier/orchestration/resolveModifierLookup.ts

@@ -1,33 +0,0 @@
-import type { LookupContract, LookupResult } from "../../shared/contracts.js";
-import lookupMany from "../../shared/lookupMany.js";
-import type { PragmaRuntime } from "../../shared/runtime.js";
-import { expandLookupQueries } from "../../shared/suggestions/index.js";
-import type { ModifierFamily } from "../../shared/types/index.js";
-import { lookupModifier } from "../operations/index.js";
-
-export default async function resolveModifierLookup(
-  store: Pick<PragmaRuntime, "store">["store"],
-  queries: readonly string[],
-): Promise<LookupContract<ModifierFamily>> {
-  const { names, globErrors } = await expandLookupQueries(
-    queries,
-    store,
-    "modifier",
-  );
-
-  const lookupResult: LookupResult<ModifierFamily> =
-    names.length > 0
-      ? await lookupMany(names, (query) => lookupModifier(store, query))
-      : { results: [], errors: [], meta: { internalErrorCount: 0 } };
-
-  const result: LookupResult<ModifierFamily> = {
-    results: lookupResult.results,
-    errors: [...lookupResult.errors, ...globErrors],
-    meta: lookupResult.meta ?? { internalErrorCount: 0 },
-  };
-
-  return {
-    params: { names: queries },
-    result,
-  };
-}

package/src/domains/modifier/stories.test.ts

@@ -1,20 +0,0 @@
-import { describe, expect, it } from "vitest";
-import { modifierListStory, modifierLookupStory } from "./stories.js";
-
-describe("modifierListStory", () => {
-  it("renders the ink list view", () => {
-    const view = modifierListStory.renderInk?.([]);
-    expect(typeof view).toBe("string");
-    expect(view).toContain("Modifiers");
-  });
-});
-
-describe("modifierLookupStory", () => {
-  it("renders the ink lookup view", () => {
-    const view = modifierLookupStory.renderInk?.(
-      { results: [], errors: [] },
-      { surface: "cli", detailed: false, params: {} },
-    );
-    expect(typeof view).toBe("string");
-  });
-});

package/src/domains/modifier/stories.ts

@@ -1,86 +0,0 @@
-/**
- * Modifier read stories — the single declaration of `modifier list` and
- * `modifier lookup` for both surfaces.
- *
- * The story kernel compiles these into the CLI commands and MCP tools,
- * so descriptions, parameters, resolution, and rendering live here once.
- */
-
-import { createListView, createLookupView } from "#tui";
-import { PragmaError } from "../../error/index.js";
-import type { LookupStory, ReadStory } from "../shared/stories/index.js";
-import type { ModifierFamily } from "../shared/types/index.js";
-import {
-  createInkLookupOptions,
-  listFormatters,
-  lookupFormatters,
-} from "./formatters/index.js";
-import { modifierConfig } from "./modifierConfig.js";
-import {
-  resolveModifierList,
-  resolveModifierLookup,
-} from "./orchestration/index.js";
-import type { ModifierListResolution } from "./types.js";
-
-/** The `modifier list` / `modifier_list` read story. */
-export const modifierListStory: ReadStory<
-  ModifierListResolution,
-  ModifierFamily[]
-> = {
-  noun: "modifier",
-  verb: "list",
-  description: "List all modifier families",
-  toolDescription: "List all modifier families with their values.",
-  params: [],
-  examples: ["pragma modifier list", "pragma modifier list --llm"],
-  resolve: (rt) => resolveModifierList(rt),
-  toOutput: (resolution) => [...resolution.items],
-  formatters: listFormatters,
-  toEnvelope: (resolution) => ({
-    data: resolution.items,
-    meta: { count: resolution.items.length },
-  }),
-  renderInk: (items) =>
-    createListView({
-      heading: "Modifiers",
-      domain: "modifier",
-      items,
-      columns: modifierConfig.listColumns,
-    }),
-};
-
-/** The `modifier lookup` / `modifier_lookup` read story. */
-export const modifierLookupStory: LookupStory<ModifierFamily, ModifierFamily> =
-  {
-    noun: "modifier",
-    description: "Look up a modifier family and its values",
-    toolDescription: "Get one or more modifier families and their values.",
-    namesDescription: "Modifier family names or IRIs",
-    namesToolDescription: "Modifier family names or IRIs to look up",
-    examples: [
-      "pragma modifier lookup importance",
-      "pragma modifier lookup importance density",
-      "pragma modifier lookup importance --llm",
-    ],
-    resolve: async (rt, names) => {
-      const contract = await resolveModifierLookup(rt.store, names);
-      return contract.result;
-    },
-    toFmtInput: (family) => family,
-    formatters: lookupFormatters,
-    emptyNamesError: () =>
-      PragmaError.invalidInput("names", "(empty)", {
-        recovery: {
-          message: "List available modifier families.",
-          cli: "pragma modifier list",
-          mcp: { tool: "modifier_list" },
-        },
-      }),
-    renderInk: (result) =>
-      createLookupView({
-        results: result.results,
-        errors: result.errors,
-        domain: "modifier",
-        options: createInkLookupOptions(),
-      }),
-  };

package/src/domains/modifier/types.ts

@@ -1,5 +0,0 @@
-import type { ModifierFamily } from "../shared/types/index.js";
-
-export interface ModifierListResolution {
-  readonly items: readonly ModifierFamily[];
-}

package/src/domains/ontology/commands/index.ts

@@ -1,4 +0,0 @@
-/** @module Barrel for ontology command builders. */
-
-export { default as listCommand } from "./list.js";
-export { default as showCommand } from "./show.js";

package/src/domains/ontology/commands/list.test.ts

@@ -1,84 +0,0 @@
-import type { CommandDefinition } from "@canonical/cli-core";
-import { afterAll, beforeAll, describe, expect, it } from "vitest";
-import createTestRuntime from "../../../testing/helpers/createTestRuntime.js";
-import type { PragmaContext } from "../../shared/context.js";
-import type { PragmaRuntime } from "../../shared/runtime.js";
-import type { OntologySummary } from "../../shared/types/index.js";
-import buildListCommand from "./list.js";
-
-let runtime: PragmaRuntime;
-
-beforeAll(async () => {
-  runtime = await createTestRuntime();
-});
-
-afterAll(() => {
-  runtime.dispose();
-});
-
-function makeCtx(overrides: Partial<PragmaContext> = {}): PragmaContext {
-  return {
-    ...runtime,
-    globalFlags: { llm: false, format: "text" as const, verbose: false },
-    ...overrides,
-  };
-}
-
-async function executeOutput(
-  cmd: CommandDefinition,
-  params: Record<string, unknown>,
-  ctx: PragmaContext,
-): Promise<{ value: unknown; text: string }> {
-  const result = await cmd.execute(params, ctx);
-  expect(result.tag).toBe("output");
-  if (result.tag !== "output") throw new Error("Expected output result");
-  return { value: result.value, text: result.render.plain(result.value) };
-}
-
-describe("ontology list command", () => {
-  it("returns ontology summaries", async () => {
-    const ctx = makeCtx();
-    const cmd = buildListCommand(ctx);
-    const { value } = await executeOutput(cmd, {}, ctx);
-
-    const prefixes = (value as OntologySummary[]).map((item) => item.prefix);
-    expect(prefixes).toContain("ds");
-    expect(prefixes).toContain("cs");
-  });
-
-  it("renders plain output", async () => {
-    const ctx = makeCtx();
-    const cmd = buildListCommand(ctx);
-    const { text } = await executeOutput(cmd, {}, ctx);
-
-    expect(text).toContain("ds");
-    expect(text).toContain("classes");
-    expect(text).toContain("relations");
-    expect(text).toContain("attributes");
-    expect(text).toContain("Next: pragma ontology show <prefix>");
-  });
-
-  it("renders llm output", async () => {
-    const ctx = makeCtx({
-      globalFlags: { llm: true, format: "text" as const, verbose: false },
-    });
-    const cmd = buildListCommand(ctx);
-    const { text } = await executeOutput(cmd, {}, ctx);
-
-    expect(text).toContain("## Ontologies");
-    expect(text).toContain("**ds:**");
-    expect(text).toContain("relations");
-  });
-
-  it("renders json output", async () => {
-    const ctx = makeCtx({
-      globalFlags: { llm: false, format: "json" as const, verbose: false },
-    });
-    const cmd = buildListCommand(ctx);
-    const { text } = await executeOutput(cmd, {}, ctx);
-
-    const parsed = JSON.parse(text) as OntologySummary[];
-    expect(Array.isArray(parsed)).toBe(true);
-    expect(parsed.some((item) => item.prefix === "ds")).toBe(true);
-  });
-});

package/src/domains/ontology/commands/list.ts

@@ -1,11 +0,0 @@
-import type { CommandDefinition } from "@canonical/cli-core";
-import type { PragmaContext } from "../../shared/context.js";
-import { compileReadCommand } from "../../shared/stories/index.js";
-import { ontologyListStory } from "../stories.js";
-
-/** Wire the `pragma ontology list` CLI command from the ontology list story. */
-export default function buildListCommand(
-  ctx: PragmaContext,
-): CommandDefinition {
-  return compileReadCommand(ctx, ontologyListStory);
-}

package/src/domains/ontology/commands/show.test.ts

@@ -1,179 +0,0 @@
-import type { CommandDefinition } from "@canonical/cli-core";
-import { afterAll, beforeAll, describe, expect, it } from "vitest";
-import createTestRuntime from "../../../testing/helpers/createTestRuntime.js";
-import type { PragmaContext } from "../../shared/context.js";
-import type { PragmaRuntime } from "../../shared/runtime.js";
-import type { OntologyShowInput } from "../formatters/index.js";
-import buildShowCommand from "./show.js";
-
-let runtime: PragmaRuntime;
-
-beforeAll(async () => {
-  runtime = await createTestRuntime();
-});
-
-afterAll(() => {
-  runtime.dispose();
-});
-
-function makeCtx(overrides: Partial<PragmaContext> = {}): PragmaContext {
-  return {
-    ...runtime,
-    globalFlags: { llm: false, format: "text" as const, verbose: false },
-    ...overrides,
-  };
-}
-
-async function executeOutput(
-  cmd: CommandDefinition,
-  params: Record<string, unknown>,
-  ctx: PragmaContext,
-): Promise<{ value: unknown; text: string }> {
-  const result = await cmd.execute(params, ctx);
-  expect(result.tag).toBe("output");
-  if (result.tag !== "output") throw new Error("Expected output result");
-  return { value: result.value, text: result.render.plain(result.value) };
-}
-
-describe("ontology show command", () => {
-  it("returns ontology details", async () => {
-    const ctx = makeCtx();
-    const cmd = buildShowCommand(ctx);
-    const { value } = await executeOutput(cmd, { prefix: "ds" }, ctx);
-
-    const { ontology } = value as OntologyShowInput;
-    expect(ontology.prefix).toBe("ds");
-    expect(ontology.classes.length).toBeGreaterThan(0);
-    const propertyCount =
-      ontology.classes.reduce((n, c) => n + c.properties.length, 0) +
-      ontology.unattached.length;
-    expect(propertyCount).toBeGreaterThan(0);
-  });
-
-  it("deep-dives into a class via the class param", async () => {
-    const ctx = makeCtx();
-    const cmd = buildShowCommand(ctx);
-    const { value, text } = await executeOutput(
-      cmd,
-      { prefix: "ds", class: "Component" },
-      ctx,
-    );
-
-    const { ontology } = value as OntologyShowInput;
-    expect(ontology.focus?.iri).toBe("ds:Component");
-    expect(text).toContain("Component");
-    expect(text).toContain("extends:");
-    // Follow-up querying: the deep dive hands over runnable SPARQL.
-    expect(text).toContain(
-      "SELECT ?instance WHERE { ?instance a ds:Component }",
-    );
-  });
-
-  it("hides attributes by default and shows them with --properties", async () => {
-    const ctx = makeCtx();
-    const cmd = buildShowCommand(ctx);
-
-    const bare = await executeOutput(cmd, { prefix: "ds" }, ctx);
-    // Attributes render as `label: range` — absent by default.
-    expect(bare.text).not.toContain(": xsd:");
-    // hasModifierFamily is an object property (relation) — always shown.
-    expect(bare.text).toContain("hasModifierFamily");
-
-    const withProps = await executeOutput(
-      cmd,
-      { prefix: "ds", properties: true },
-      ctx,
-    );
-    expect(withProps.text).toContain(": xsd:");
-  });
-
-  it("expands IRIs with --full-uris", async () => {
-    const ctx = makeCtx({
-      globalFlags: { llm: true, format: "text" as const, verbose: false },
-    });
-    const cmd = buildShowCommand(ctx);
-    const { value, text } = await executeOutput(
-      cmd,
-      { prefix: "ds", fullUris: true },
-      ctx,
-    );
-
-    const { ontology } = value as OntologyShowInput;
-    const component = ontology.classes.find((c) => c.label === "Component");
-    expect(component?.iri).toBe("https://ds.canonical.com/Component");
-    expect(text).toContain("https://ds.canonical.com/Component");
-    // The seeded footer query must stay valid SPARQL: full URIs need <...>.
-    expect(text).toMatch(/\?s a <https:\/\/ds\.canonical\.com\//);
-  });
-
-  it("completes ontology prefixes", async () => {
-    const ctx = makeCtx();
-    const cmd = buildShowCommand(ctx);
-    const complete = cmd.parameters[0]?.complete;
-
-    expect(complete).toBeTypeOf("function");
-    const matches = await complete?.("d", ctx);
-    expect(matches).toContain("ds");
-  });
-
-  it("completes class names for --class", async () => {
-    const ctx = makeCtx();
-    const cmd = buildShowCommand(ctx);
-    const classParam = cmd.parameters.find((p) => p.name === "class");
-    const complete = classParam?.complete;
-
-    expect(complete).toBeTypeOf("function");
-    const matches = await complete?.("comp", ctx);
-    expect(matches).toContain("Component");
-    // Case-insensitive prefix match, sorted, no non-matches.
-    expect(matches?.every((m) => m.toLowerCase().startsWith("comp"))).toBe(
-      true,
-    );
-  });
-
-  it("renders plain output", async () => {
-    const ctx = makeCtx();
-    const cmd = buildShowCommand(ctx);
-    const { text } = await executeOutput(cmd, { prefix: "ds" }, ctx);
-
-    expect(text).toContain("Ontology ds:");
-    expect(text).toContain("classes");
-    // Hierarchy: children render beneath their parent with tree branches.
-    expect(text).toContain("└─");
-  });
-
-  it("renders llm output", async () => {
-    const ctx = makeCtx({
-      globalFlags: { llm: true, format: "text" as const, verbose: false },
-    });
-    const cmd = buildShowCommand(ctx);
-    const { text } = await executeOutput(cmd, { prefix: "ds" }, ctx);
-
-    expect(text).toContain("## Ontology ds:");
-    expect(text).toContain("### Classes");
-  });
-
-  it("renders json output", async () => {
-    const ctx = makeCtx({
-      globalFlags: { llm: false, format: "json" as const, verbose: false },
-    });
-    const cmd = buildShowCommand(ctx);
-    const { text } = await executeOutput(cmd, { prefix: "ds" }, ctx);
-
-    const parsed = JSON.parse(text) as { prefix: string };
-    expect(parsed.prefix).toBe("ds");
-  });
-
-  it("throws structured error when prefix is missing", async () => {
-    const ctx = makeCtx();
-    const cmd = buildShowCommand(ctx);
-
-    await expect(cmd.execute({}, ctx)).rejects.toMatchObject({
-      code: "INVALID_INPUT",
-      recovery: {
-        cli: "pragma ontology list",
-        mcp: { tool: "ontology_list" },
-      },
-    });
-  });
-});

package/src/domains/ontology/commands/show.ts

@@ -1,14 +0,0 @@
-import type { CommandDefinition } from "@canonical/cli-core";
-import type { PragmaContext } from "../../shared/context.js";
-import { compileReadCommand } from "../../shared/stories/index.js";
-import { ontologyShowStory } from "../stories.js";
-
-/**
- * Wire the `pragma ontology show <prefix>` CLI command from the ontology
- * show story.
- */
-export default function buildShowCommand(
-  ctx: PragmaContext,
-): CommandDefinition {
-  return compileReadCommand(ctx, ontologyShowStory);
-}

package/src/domains/ontology/formatters/index.ts

@@ -1,5 +0,0 @@
-/** @module Barrel for ontology formatters. */
-
-export { default as listFormatters } from "./list.js";
-export type { OntologyShowInput } from "./show.js";
-export { default as showFormatters } from "./show.js";

package/src/domains/ontology/formatters/list.ts

@@ -1,64 +0,0 @@
-import chalk from "chalk";
-import type { Formatters } from "../../shared/formatters.js";
-import type { OntologySummary } from "../../shared/types/index.js";
-
-/**
- * Formatters for `pragma ontology list` output.
- *
- * One line per namespace mirroring the `ontology show` summary line —
- * name, metadata, and split counts — plus a next-command footer, so the
- * list is the entry point of the same drill-down path
- * (`list → show <prefix> → show <prefix> --class <Class>`).
- *
- * - **plain**: chalk-styled lines with counts and a dimmed footer.
- * - **llm**: the same content as condensed Markdown bullets.
- * - **json**: the {@link OntologySummary} array itself.
- */
-const formatters: Formatters<readonly OntologySummary[]> = {
-  plain(ontologies) {
-    const lines = ontologies.map(
-      (o) =>
-        `${chalk.bold(prefixLabel(o))} ${o.namespace} ${chalk.dim(`— ${summaryLine(o)}`)}`,
-    );
-    lines.push("");
-    lines.push(chalk.dim("Next: pragma ontology show <prefix>"));
-    return lines.join("\n");
-  },
-
-  llm(ontologies) {
-    const lines = ["## Ontologies", ""];
-    for (const o of ontologies) {
-      lines.push(
-        `- **${prefixLabel(o)}** \`${o.namespace}\` — ${summaryLine(o)}`,
-      );
-    }
-    lines.push("");
-    lines.push("Next: `ontology show <prefix>` for the class hierarchy.");
-    return lines.join("\n");
-  },
-
-  json(ontologies) {
-    return JSON.stringify(ontologies, null, 2);
-  },
-};
-
-export default formatters;
-
-/** `ds:` for prefixed namespaces, a placeholder for unprefixed ones. */
-function prefixLabel(o: OntologySummary): string {
-  return o.prefix ? `${o.prefix}:` : "(no prefix)";
-}
-
-/** The same counts-and-metadata line `ontology show` leads with. */
-function summaryLine(o: OntologySummary): string {
-  const parts = [
-    `${o.classCount} classes`,
-    `${o.relationCount} relations`,
-    `${o.attributeCount} attributes`,
-  ];
-  if (o.shapeCount > 0) parts.push(`${o.shapeCount} shapes`);
-  if (o.anatomyCount > 0) parts.push(`${o.anatomyCount} anatomies`);
-  if (o.version) parts.push(`v${o.version}`);
-  if (o.title) parts.push(o.title);
-  return parts.join(" · ");
-}