@canonical/pragma-cli 0.29.0 → 0.30.0

package/src/pipeline/runCli.ts

@@ -5,6 +5,7 @@ import { buildCapabilitiesCommand } from "../domains/llm/index.js";
 import { commands as refsCommands } from "../domains/refs/index.js";
 import { commands as setupCommands } from "../domains/setup/index.js";
 import type { PragmaContext } from "../domains/shared/context.js";
+import createInteractivePromptSession from "../domains/shared/createInteractivePromptSession.js";
 import type { PragmaRuntime } from "../domains/shared/runtime.js";
 import { bootPragma } from "../domains/shared/runtime.js";
 import { commands as traceCommands } from "../domains/trace/index.js";
@@ -19,7 +20,6 @@ import {
   renderErrorPlain,
 } from "./renderError.js";
 import resolveCommandKind from "./resolveCommandKind.js";
-import runInteractiveCommand from "./runInteractiveCommand.js";
 
 function hasCommandArg(argv: readonly string[]): boolean {
   const args = argv.slice(2);
@@ -79,12 +79,11 @@ async function handleDoctor(globalFlags: GlobalFlags): Promise<void> {
 async function handleRootHelp(globalFlags: GlobalFlags): Promise<void> {
   const stubCtx: PragmaContext = {
     store: {} as PragmaRuntime["store"],
-    config: { tier: undefined, channel: "normal" },
+    ...(await resolveHelpConfig()),
     cwd: process.cwd(),
-    packages: [],
     dispose: () => {},
     globalFlags,
-    interactive: runInteractiveCommand,
+    promptSession: createInteractivePromptSession,
   };
   const commands = collectCommands(stubCtx);
   const program = createProgram(commands, stubCtx);
@@ -96,6 +95,41 @@ async function handleRootHelp(globalFlags: GlobalFlags): Promise<void> {
   }
 }
 
+/**
+ * Resolve config and packages for root help without booting the store.
+ *
+ * Story-pack nouns come from config and package files, so bare
+ * `pragma --help` reads them via the filesystem loaders only. Help must
+ * never fail on a broken config — errors fall back to the empty stub and
+ * surface on the next real command instead.
+ *
+ * @note Impure — reads config and resolves packages from disk.
+ */
+async function resolveHelpConfig(): Promise<
+  Pick<PragmaRuntime, "config" | "packages">
+> {
+  try {
+    const { readConfig } = await import("#config");
+    const config = readConfig(process.cwd());
+    const { resolveSemanticPackages } = await import(
+      "../domains/shared/semanticPackage.js"
+    );
+    const { createGitLoader, createLocalLoader } = await import(
+      "../domains/shared/loaders/index.js"
+    );
+    const { mergeAndParseRefs } = await import(
+      "../domains/shared/mergeAndParseRefs.js"
+    );
+    const packages = await resolveSemanticPackages(
+      mergeAndParseRefs(config.packages),
+      [createLocalLoader(), createGitLoader()],
+    );
+    return { config, packages };
+  } catch {
+    return { config: { tier: undefined, channel: "normal" }, packages: [] };
+  }
+}
+
 // — Stage 4+5: Boot, build program, execute ——————————————————————————————————
 
 async function bootAndRun(
@@ -121,7 +155,7 @@ async function bootAndRun(
     const ctx: PragmaContext = {
       ...runtime,
       globalFlags,
-      interactive: runInteractiveCommand,
+      promptSession: createInteractivePromptSession,
     };
     const commands = collectCommands(ctx);
     const program = createProgram(commands, ctx);
@@ -144,7 +178,7 @@ async function runStoreSkip(
     packages: [],
     dispose: () => {},
     globalFlags,
-    interactive: runInteractiveCommand,
+    promptSession: createInteractivePromptSession,
   };
   const commands = [
     ...setupCommands(),

package/src/testing/createTestMcpClient.ts

@@ -31,7 +31,10 @@ export default async function createTestMcpClient(options?: {
   };
   const cwd = options?.cwd ?? process.cwd();
 
-  const { store, cleanup: cleanupStore } = await createTestStore({ ttl });
+  const { store, cleanup: cleanupStore } = await createTestStore({
+    ttl,
+    prefixes: config.prefixes,
+  });
 
   const runtime: PragmaRuntime = {
     store,

package/src/testing/index.ts

@@ -10,6 +10,16 @@ export {
   GRAPHQL_ERROR_TTL,
   GRAPHQL_FATAL_TTL,
 } from "./graphqlFixtures.js";
+export {
+  PARITY_GAPS,
+  STANDARD_PACK_STORY,
+} from "./standardParityFixtures.js";
 export type { PragmaTestStoreOptions } from "./store.js";
 export { createTestStore } from "./store.js";
+export {
+  RECIPE_NAMESPACE,
+  RECIPE_PREFIXES,
+  RECIPE_STORY,
+  RECIPE_TTL,
+} from "./storyFixtures.js";
 export type { TestMcpClientResult } from "./types.js";