@canonical/pragma-cli 0.20.0 → 0.22.0-experimental.0

package/src/domains/block/operations/lookup.ts

@@ -2,7 +2,7 @@
  * Look up detailed information for a single block.
  *
  * Queries the base block, then resolves related modifiers, implementations,
- * tokens, anatomy nodes, blank-node properties, and direct subcomponents.
+ * tokens, anatomy nodes, blank-node properties, and recursive subcomponents.
  * The result is assembled into a {@link BlockDetailed} object.
  *
  * @param store - ke store to query
@@ -23,10 +23,11 @@ import { buildFilters } from "../../shared/filters/buildFilters.js";
 import { P } from "../../shared/prefixes.js";
 import type {
   BlockDetailed,
+  BlockSubcomponent,
   FilterConfig,
   StandardRef,
   TokenRef,
-} from "../../shared/types.js";
+} from "../../shared/types/index.js";
 
 function normalizeBlockType(value: string | undefined): BlockDetailed["type"] {
   const localName = extractLocalName(value ?? "").toLowerCase();
@@ -45,17 +46,17 @@ export default async function lookupBlock(
   store: Store,
   nameOrUri: string,
   filters: FilterConfig,
-): Promise<BlockDetailed> {
+): Promise<BlockDetailed[]> {
   const filterClauses = buildFilters(filters);
   const subjectClause = buildLookupSubjectClause(nameOrUri, store.prefixes);
   const bindClause =
     subjectClause === null ? "" : `BIND(${subjectClause} AS ?component)`;
   const matchClause =
     subjectClause === null
-      ? `?component ${P.ds}name ${escapeSparqlValue(nameOrUri)} .`
+      ? `?component ${P.ds}name ?name . FILTER(LCASE(STR(?name)) = ${escapeSparqlValue(nameOrUri.toLowerCase())})`
       : "";
 
-  // Base query: find the block
+  // Base query: find the block(s) — no LIMIT so ambiguous names return all matches
   const baseResult = await store.query(
     buildQuery(`
       SELECT ?component ?name ?type ?tier ?summary ?whenToUse ?whenNotToUse ?guidelines ?anatomyDsl ?anatomyClassic ?figmaLink
@@ -75,7 +76,6 @@ export default async function lookupBlock(
         OPTIONAL { ?component ${P.ds}figmaLink ?figmaLink }
         ${filterClauses}
       }
-      LIMIT 1
     `),
   );
 
@@ -89,8 +89,18 @@ export default async function lookupBlock(
     });
   }
 
-  // Safe: length check above guarantees bindings[0] exists
-  const base = baseResult.bindings[0] as (typeof baseResult.bindings)[number];
+  const results: BlockDetailed[] = [];
+  for (const base of baseResult.bindings) {
+    results.push(await resolveBlockDetail(store, base, nameOrUri));
+  }
+  return results;
+}
+
+async function resolveBlockDetail(
+  store: Store,
+  base: Record<string, string>,
+  nameOrUri: string,
+): Promise<BlockDetailed> {
   const componentUri = base.component;
 
   // Modifier families with values
@@ -231,24 +241,31 @@ export default async function lookupBlock(
         }))
       : [];
 
-  // Direct subcomponents
+  // Recursive subcomponents
   const subcomponentsResult = await store.query(
     buildQuery(`
-      SELECT ?subcomponent ?name
+      SELECT DISTINCT ?parent ?subcomponent ?name
       WHERE {
-        <${componentUri}> ${P.ds}hasSubcomponent ?subcomponent .
+        <${componentUri}> (${P.ds}hasSubcomponent|^${P.ds}parentComponent)+ ?subcomponent .
+        ?parent (${P.ds}hasSubcomponent|^${P.ds}parentComponent) ?subcomponent .
         ?subcomponent ${P.ds}name ?name .
+        FILTER(
+          ?parent = <${componentUri}> ||
+          EXISTS {
+            <${componentUri}> (${P.ds}hasSubcomponent|^${P.ds}parentComponent)+ ?parent
+          }
+        )
       }
-      ORDER BY ?name
+      ORDER BY ?parent ?name
     `),
   );
 
   const subcomponents =
     subcomponentsResult.type === "select"
-      ? subcomponentsResult.bindings.map((binding) => ({
-          uri: (binding.subcomponent ?? "") as URI,
-          name: binding.name ?? "",
-        }))
+      ? buildSubcomponentTree(
+          (componentUri ?? "") as URI,
+          subcomponentsResult.bindings,
+        )
       : [];
 
   // Standards (not linked directly to blocks in current ontology;
@@ -357,3 +374,64 @@ async function listAllFrameworks(store: Store): Promise<string[]> {
   if (result.type !== "select") return [];
   return result.bindings.map((b) => b.framework ?? "");
 }
+
+function buildSubcomponentTree(
+  rootUri: URI,
+  bindings: readonly Record<string, string>[],
+): readonly BlockSubcomponent[] {
+  const nodeMap = new Map<string, BlockSubcomponent>();
+  const childrenByParent = new Map<string, string[]>();
+
+  for (const binding of bindings) {
+    const uri = (binding.subcomponent ?? "") as URI;
+    const parent = (binding.parent ?? "") as URI;
+    if (!uri || !parent) {
+      continue;
+    }
+
+    nodeMap.set(String(uri), {
+      uri,
+      name: binding.name ?? extractLocalName(String(uri)),
+      children: [],
+    });
+
+    const siblings = childrenByParent.get(String(parent)) ?? [];
+    if (!siblings.includes(String(uri))) {
+      siblings.push(String(uri));
+      childrenByParent.set(String(parent), siblings);
+    }
+  }
+
+  return buildSubcomponentChildren(String(rootUri), childrenByParent, nodeMap);
+}
+
+function buildSubcomponentChildren(
+  parentUri: string,
+  childrenByParent: ReadonlyMap<string, readonly string[]>,
+  nodeMap: ReadonlyMap<string, BlockSubcomponent>,
+  visited = new Set<string>(),
+): readonly BlockSubcomponent[] {
+  const childUris = childrenByParent.get(parentUri) ?? [];
+
+  return childUris.flatMap((childUri) => {
+    const node = nodeMap.get(childUri);
+    if (!node || visited.has(childUri)) {
+      return [];
+    }
+
+    const nextVisited = new Set(visited);
+    nextVisited.add(childUri);
+
+    return [
+      {
+        ...node,
+        children: buildSubcomponentChildren(
+          childUri,
+          childrenByParent,
+          nodeMap,
+          nextVisited,
+        ),
+      },
+    ];
+  });
+}

package/src/domains/block/orchestration/blockEmptyError.ts

@@ -1,6 +1,6 @@
 import { PragmaError } from "#error";
 import { describeFilters } from "../../shared/filters/index.js";
-import type { FilterConfig } from "../../shared/types.js";
+import type { FilterConfig } from "../../shared/types/index.js";
 
 export default function blockEmptyError(
   filters: FilterConfig,

package/src/domains/block/orchestration/buildBlockFilters.ts

@@ -1,5 +1,5 @@
 import type { PragmaRuntime } from "../../shared/runtime.js";
-import type { FilterConfig } from "../../shared/types.js";
+import type { FilterConfig } from "../../shared/types/index.js";
 
 export default function buildBlockFilters(
   rt: Pick<PragmaRuntime, "config">,

package/src/domains/block/orchestration/enrichBlocks.ts

@@ -4,7 +4,7 @@ import type {
   BlockSummary,
   Disclosure,
   FilterConfig,
-} from "../../shared/types.js";
+} from "../../shared/types/index.js";
 import { lookupBlock } from "../operations/index.js";
 import type { BlockListDigest } from "../types.js";
 
@@ -14,9 +14,13 @@ export default async function enrichBlocks(
   filters: FilterConfig,
   disclosure: Disclosure,
 ): Promise<readonly (BlockListDigest | BlockDetailed)[]> {
-  const details = await Promise.all(
+  const nested = await Promise.all(
     summaries.map((summary) => lookupBlock(store, summary.name, filters)),
   );
+  // lookupBlock returns BlockDetailed[] — take the first match per summary
+  const details: BlockDetailed[] = nested.flatMap((matches) =>
+    matches[0] ? [matches[0]] : [],
+  );
 
   if (disclosure.level === "detailed") {
     return details;

package/src/domains/block/orchestration/resolveBlockList.ts

@@ -1,6 +1,6 @@
 import type { ListParams } from "../../shared/contracts.js";
 import type { PragmaRuntime } from "../../shared/runtime.js";
-import type { Disclosure } from "../../shared/types.js";
+import type { Disclosure } from "../../shared/types/index.js";
 import { listBlocks } from "../operations/index.js";
 import type { BlockListContract } from "../types.js";
 import blockEmptyError from "./blockEmptyError.js";

package/src/domains/block/orchestration/resolveBlockLookup.ts

@@ -1,7 +1,7 @@
 import type { LookupContract, LookupResult } from "../../shared/contracts.js";
 import lookupMany from "../../shared/lookupMany.js";
 import type { PragmaRuntime } from "../../shared/runtime.js";
-import type { BlockDetailed, FilterConfig } from "../../shared/types.js";
+import type { BlockDetailed, FilterConfig } from "../../shared/types/index.js";
 import { lookupBlock } from "../operations/index.js";
 
 export default async function resolveBlockLookup(
@@ -9,11 +9,17 @@ export default async function resolveBlockLookup(
   queries: readonly string[],
   filters: FilterConfig,
 ): Promise<LookupContract<BlockDetailed>> {
-  const result: LookupResult<BlockDetailed> = await lookupMany(
+  const nested: LookupResult<BlockDetailed[]> = await lookupMany(
     queries,
     (query) => lookupBlock(store, query, filters),
   );
 
+  // lookupBlock returns BlockDetailed[] (multiple matches per name) — flatten
+  const result: LookupResult<BlockDetailed> = {
+    results: nested.results.flat(),
+    errors: nested.errors,
+  };
+
   return {
     params: { names: queries },
     result,

package/src/domains/block/types.ts

@@ -5,7 +5,7 @@
  */
 
 import type { ListContract } from "../shared/contracts.js";
-import type { BlockDetailed, BlockSummary } from "../shared/types.js";
+import type { BlockDetailed, BlockSummary } from "../shared/types/index.js";
 
 /** Flags controlling which detail aspects are included in block output. */
 export interface AspectFlags {

package/src/domains/config/commands/channel.ts

@@ -3,11 +3,13 @@ import {
   type CommandResult,
   createOutputResult,
 } from "@canonical/cli-core";
-import { readConfig, writeConfig } from "#config";
+import { runTask } from "@canonical/task";
+import { readConfig } from "#config";
 import type { PragmaContext } from "../../shared/context.js";
 import { selectFormatter } from "../../shared/formatters.js";
 import { channelFormatters } from "../formatters/index.js";
 import { validateChannel } from "../operations/index.js";
+import { setChannelTask } from "../tasks/index.js";
 
 /**
  * Build the `pragma config channel` command definition.
@@ -17,7 +19,7 @@ import { validateChannel } from "../operations/index.js";
  *
  * @param ctx - Pragma context providing cwd and formatter selection.
  * @returns The command definition for `pragma config channel`.
- * @note Impure
+ * @note - Impure — validates channel and writes config to disk.
  */
 export default function buildChannelCommand(
   ctx: PragmaContext,
@@ -52,7 +54,7 @@ export default function buildChannelCommand(
       const value = params.value as string | undefined;
 
       if (reset) {
-        writeConfig(ctx.cwd, { channel: undefined });
+        await runTask(setChannelTask(ctx.cwd, undefined));
         const format = selectFormatter(ctx, channelFormatters.reset);
         return createOutputResult("Reset channel to default.", {
           plain: format,
@@ -69,7 +71,7 @@ export default function buildChannelCommand(
 
       const channel = validateChannel(value);
 
-      writeConfig(ctx.cwd, { channel });
+      await runTask(setChannelTask(ctx.cwd, channel));
       const format = selectFormatter(ctx, channelFormatters.set);
       return createOutputResult(
         { field: "channel", value: channel },

package/src/domains/config/commands/tier.ts

@@ -3,11 +3,13 @@ import {
   type CommandResult,
   createOutputResult,
 } from "@canonical/cli-core";
-import { readConfig, writeConfig } from "#config";
+import { runTask } from "@canonical/task";
+import { readConfig } from "#config";
 import type { PragmaContext } from "../../shared/context.js";
 import { selectFormatter } from "../../shared/formatters.js";
 import { tierFormatters } from "../formatters/index.js";
 import { validateTier } from "../operations/index.js";
+import { setTierTask } from "../tasks/index.js";
 
 /**
  * Build the `pragma config tier` command definition.
@@ -17,7 +19,7 @@ import { validateTier } from "../operations/index.js";
  *
  * @param ctx - Pragma context providing cwd, store, and formatter selection.
  * @returns The command definition for `pragma config tier`.
- * @note Impure
+ * @note - Impure — validates tier against the ke store and writes config to disk.
  */
 export default function buildTierCommand(
   ctx: PragmaContext,
@@ -49,7 +51,7 @@ export default function buildTierCommand(
       const tierPath = params.path as string | undefined;
 
       if (reset) {
-        writeConfig(ctx.cwd, { tier: undefined });
+        await runTask(setTierTask(ctx.cwd, undefined));
         const format = selectFormatter(ctx, tierFormatters.reset);
         return createOutputResult("Reset tier to default.", {
           plain: format,
@@ -67,7 +69,7 @@ export default function buildTierCommand(
       // Validate tier against ontology
       await validateTier(ctx.store, tierPath);
 
-      writeConfig(ctx.cwd, { tier: tierPath });
+      await runTask(setTierTask(ctx.cwd, tierPath));
       const format = selectFormatter(ctx, tierFormatters.set);
       return createOutputResult(
         { field: "tier", value: tierPath },

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

@@ -1,10 +1,19 @@
 /**
  * MCP tool specs for the config domain.
+ *
+ * config_show uses the shared resolveConfigShow() operation so that
+ * MCP data matches what the CLI produces (tierChain, includedReleases, etc.).
  */
 
 import { readConfig, writeConfig } from "#config";
+import { detectInstallSource } from "#package-manager";
 import type { ToolSpec } from "../../shared/ToolSpec.js";
-import { validateChannel, validateTier } from "../operations/index.js";
+import { showFormatters } from "../formatters/index.js";
+import {
+  resolveConfigShow,
+  validateChannel,
+  validateTier,
+} from "../operations/index.js";
 
 const specs: readonly ToolSpec[] = [
   {
@@ -20,13 +29,16 @@ const specs: readonly ToolSpec[] = [
     },
     readOnly: true,
     async execute(rt, { condensed }) {
-      const data = {
-        tier: rt.config.tier ?? null,
-        channel: rt.config.channel,
-      };
+      const install = detectInstallSource();
+      const data = resolveConfigShow(rt.config, {
+        packageManager: install.packageManager,
+        installSource: install.label,
+        configFilePath: "pragma.config.json",
+        configFileExists: true,
+      });
 
       if (condensed) {
-        const text = `Config: tier=${data.tier ?? "(none)"} channel=${data.channel}`;
+        const text = showFormatters.llm(data);
         return {
           condensed: true,
           text,

package/src/domains/config/operations/validateTier.ts

@@ -1,6 +1,6 @@
 import type { Store } from "@canonical/ke";
 import { PragmaError } from "#error";
-import type { TierEntry } from "../../shared/types.js";
+import type { TierEntry } from "../../shared/types/index.js";
 import { listTiers } from "../../tier/operations/index.js";
 
 /**

package/src/domains/config/tasks/index.ts

@@ -0,0 +1,3 @@
+/** @module Config write tasks. */
+export { default as setChannelTask } from "./setChannel.js";
+export { default as setTierTask } from "./setTier.js";

package/src/domains/config/tasks/setChannel.ts

@@ -0,0 +1,30 @@
+import { $, gen, type Task, writeFile } from "@canonical/task";
+import { readConfig } from "../../../config/index.js";
+import resolveConfigPath from "../../../config/resolveConfigPath.js";
+
+/**
+ * Build a config-write task for setting or resetting the release channel.
+ *
+ * @param cwd - Working directory containing pragma.config.json.
+ * @param channel - Channel value to persist, or `undefined` to reset.
+ * @returns Task yielding the persisted field/value payload.
+ * @note - Impure — reads config and writes to the file system.
+ */
+export default function setChannel(
+  cwd: string,
+  channel: string | undefined,
+): Task<{ field: "channel"; value: string | undefined }> {
+  return gen(function* () {
+    const current = readConfig(cwd);
+    const next = {
+      ...(current.tier !== undefined ? { tier: current.tier } : {}),
+      ...(channel !== undefined ? { channel } : {}),
+    };
+
+    yield* $(
+      writeFile(resolveConfigPath(cwd), `${JSON.stringify(next, null, 2)}\n`),
+    );
+
+    return { field: "channel", value: channel };
+  });
+}

package/src/domains/config/tasks/setTier.ts

@@ -0,0 +1,33 @@
+import { $, gen, type Task, writeFile } from "@canonical/task";
+import { readConfig } from "../../../config/index.js";
+import resolveConfigPath from "../../../config/resolveConfigPath.js";
+
+/**
+ * Build a config-write task for setting or resetting the active tier.
+ *
+ * @param cwd - Working directory containing pragma.config.json.
+ * @param tier - Tier path to persist, or `undefined` to reset.
+ * @returns Task yielding the persisted field/value payload.
+ * @note - Impure — reads config and writes to the file system.
+ */
+export default function setTier(
+  cwd: string,
+  tier: string | undefined,
+): Task<{
+  field: "tier";
+  value: string | undefined;
+}> {
+  return gen(function* () {
+    const current = readConfig(cwd);
+    const next = {
+      ...(tier !== undefined ? { tier } : {}),
+      ...(current.channel !== undefined ? { channel: current.channel } : {}),
+    };
+
+    yield* $(
+      writeFile(resolveConfigPath(cwd), `${JSON.stringify(next, null, 2)}\n`),
+    );
+
+    return { field: "tier", value: tier };
+  });
+}

package/src/domains/create/commands/package.test.ts

@@ -27,9 +27,9 @@ describe("buildPackageCommand", () => {
     expect(result.tag).toBe("output");
   });
 
-  it("with missing required params returns interactive", async () => {
+  it("with missing required params returns batch output outside a TTY", async () => {
     const cmd = buildPackageCommand();
     const result = await cmd.execute({}, ctx);
-    expect(result.tag).toBe("interactive");
+    expect(result.tag).toBe("output");
   });
 });

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

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

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

@@ -1,15 +1,9 @@
 /**
- * MCP tool specs for doctor domain — doctor, info.
+ * MCP tool specs for the doctor domain.
  *
- * The info tool is cross-domain: it uses operations and formatters from
- * the info domain, plus VERSION from #constants.
+ * The info tool has moved to its own domain: `info/mcp/specs.ts`.
  */
 
-import { VERSION } from "#constants";
-import { detectInstallSource } from "#package-manager";
-import { renderInfoLlm } from "../../info/formatters/index.js";
-import { collectStoreSummary } from "../../info/operations/index.js";
-import type { InfoData } from "../../info/types.js";
 import type { ToolSpec } from "../../shared/ToolSpec.js";
 import { doctorFormatters } from "../formatters/index.js";
 import { runChecks } from "../operations/index.js";
@@ -42,47 +36,6 @@ const specs: readonly ToolSpec[] = [
       return { data: result };
     },
   },
-  {
-    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 storeSummary = await collectStoreSummary(rt.store);
-      const install = detectInstallSource();
-
-      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: [],
-        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/graph/commands/inspect.test.ts

@@ -4,7 +4,7 @@ import createTestRuntime from "../../../testing/helpers/createTestRuntime.js";
 import type { PragmaContext } from "../../shared/context.js";
 import { PREFIX_MAP } from "../../shared/prefixes.js";
 import type { PragmaRuntime } from "../../shared/runtime.js";
-import type { InspectResult } from "../../shared/types.js";
+import type { InspectResult } from "../../shared/types/index.js";
 import buildInspectCommand from "./inspect.js";
 
 let runtime: PragmaRuntime;

package/src/domains/graph/formatters/inspect.ts

@@ -1,7 +1,9 @@
 import chalk from "chalk";
 import { formatHeading } from "#pipeline";
+import compactUri from "../../shared/compactUri.js";
 import type { Formatters } from "../../shared/formatters.js";
-import type { InspectResult } from "../../shared/types.js";
+import { PREFIX_MAP } from "../../shared/prefixes.js";
+import type { InspectResult } from "../../shared/types/index.js";
 
 /**
  * Formatters for `pragma graph inspect` output.
@@ -13,13 +15,13 @@ import type { InspectResult } from "../../shared/types.js";
 const formatters: Formatters<InspectResult> = {
   plain(result) {
     const lines: string[] = [];
-    lines.push(formatHeading(result.uri));
+    lines.push(formatHeading(compactUri(result.uri, PREFIX_MAP)));
 
     for (const g of result.groups) {
       lines.push("");
-      lines.push(chalk.bold(g.predicate));
+      lines.push(chalk.bold(compactUri(g.predicate, PREFIX_MAP)));
       for (const o of g.objects) {
-        lines.push(`  ${o}`);
+        lines.push(`  ${compactUri(o, PREFIX_MAP)}`);
       }
     }
 
@@ -27,11 +29,14 @@ const formatters: Formatters<InspectResult> = {
   },
 
   llm(result) {
-    const lines = [`## ${result.uri}`, ""];
+    const lines = [
+      `## ${compactUri(result.uri, PREFIX_MAP)} (${result.uri})`,
+      "",
+    ];
     for (const g of result.groups) {
-      lines.push(`**${g.predicate}:**`);
+      lines.push(`**${compactUri(g.predicate, PREFIX_MAP)}:**`);
       for (const o of g.objects) {
-        lines.push(`  - ${o}`);
+        lines.push(`  - ${compactUri(o, PREFIX_MAP)}`);
       }
     }
     return lines.join("\n");

package/src/domains/graph/operations/inspectUri.ts

@@ -1,7 +1,10 @@
 import type { Store } from "@canonical/ke";
 import { PragmaError } from "#error";
 import { buildQuery } from "../../shared/buildQuery.js";
-import type { InspectResult, PredicateGroup } from "../../shared/types.js";
+import type {
+  InspectResult,
+  PredicateGroup,
+} from "../../shared/types/index.js";
 import resolveUri from "../helpers/resolveUri.js";
 
 /**

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

@@ -3,7 +3,7 @@ import type { CommandDefinition, CommandResult } from "@canonical/cli-core";
 import { readConfig } from "#config";
 import { VERSION } from "#constants";
 import { PragmaError } from "#error";
-import { detectPackageManager, PM_COMMANDS } from "#package-manager";
+import { detectInstallSource, PM_COMMANDS } from "#package-manager";
 import {
   renderUpgradeJson,
   renderUpgradeLlm,
@@ -58,9 +58,12 @@ async function executeUpgrade(
   ctx: { cwd: string; globalFlags: { llm: boolean; format: "text" | "json" } },
 ): Promise<CommandResult> {
   const dryRun = params.dryRun === true;
-  const pm = detectPackageManager();
+  const source = detectInstallSource();
+  const pm = source.label;
   const config = readConfig(ctx.cwd);
-  const command = PM_COMMANDS[pm].update("@canonical/pragma-cli");
+  const command = PM_COMMANDS[source.packageManager].update(
+    "@canonical/pragma-cli",
+  );
 
   const registryResult = await checkRegistryVersion(
     "@canonical/pragma-cli",

package/src/domains/info/index.ts

@@ -1,7 +1,9 @@
 /**
  * @module Info domain barrel.
  *
- * Provides the `pragma info` and `pragma upgrade` commands.
+ * 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

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