@elench/testkit 0.1.97 → 0.1.99

package/lib/cli/commands/discover.mjs

@@ -1,11 +1,8 @@
-import fs from "fs";
-import path from "path";
 import { Command, Flags } from "@oclif/core";
-import { discoverTests } from "../../discovery/index.mjs";
-import { resolveProductDir } from "../../config/index.mjs";
-import { buildDiscoveryReportLines } from "../presentation/discovery-reporter.mjs";
-import { resolveRequestedFiles } from "../args.mjs";
-import { sharedFlags } from "../command-helpers.mjs";
+import { executeDiscoverOperation } from "../operations/discover/operation.mjs";
+import { renderDiscoverResult } from "../renderers/discover/text.mjs";
+import { sharedFlags } from "../command-flags.mjs";
+import { withAssistantCommandResult } from "../assistant/command-results.mjs";
 
 export default class DiscoverCommand extends Command {
   static summary = "Discover managed tests and report their metadata";
@@ -48,33 +45,17 @@ export default class DiscoverCommand extends Command {
   };
 
   async run() {
-    const { flags } = await this.parse(DiscoverCommand);
-    const productDir = resolveProductDir(process.cwd(), flags.dir);
-    const fileNames = resolveRequestedFiles(flags.file || [], productDir, process.cwd());
-    const result = await discoverTests({
-      dir: productDir,
-      service: flags.service || null,
-      type: flags.type || [],
-      suite: flags.suite || [],
-      file: fileNames,
-      runnableOnly: flags["runnable-only"],
-      diagnostics: flags.strict ? "error" : "report",
-    });
-    let outputLabel = null;
-    if (flags.output) {
-      const outputPath = path.resolve(productDir, flags.output);
-      fs.mkdirSync(path.dirname(outputPath), { recursive: true });
-      fs.writeFileSync(outputPath, `${JSON.stringify(result, null, 2)}\n`);
-      outputLabel = path.relative(productDir, outputPath) || path.basename(outputPath);
-    }
+    return withAssistantCommandResult("discover", async () => {
+      const { flags } = await this.parse(DiscoverCommand);
+      const result = await executeDiscoverOperation(flags, process.cwd());
 
-    if (!this.jsonEnabled()) {
-      for (const line of buildDiscoveryReportLines(result, { outputMode: flags["output-mode"] })) {
-        this.log(line);
+      if (!this.jsonEnabled()) {
+        for (const line of renderDiscoverResult(result, { outputMode: flags["output-mode"] })) {
+          this.log(line);
+        }
       }
-      if (outputLabel) this.log(`Wrote ${outputLabel}`);
-    }
 
-    return result;
+      return result;
+    });
   }
 }

package/lib/cli/commands/doctor.mjs

@@ -1,5 +1,7 @@
 import { Command, Flags } from "@oclif/core";
-import { runDoctor } from "../../app/doctor.mjs";
+import { executeDoctorOperation } from "../operations/doctor/operation.mjs";
+import { renderDoctorResult } from "../renderers/doctor/text.mjs";
+import { withAssistantCommandResult } from "../assistant/command-results.mjs";
 
 export default class DoctorCommand extends Command {
   static summary = "Run built-in config, discovery, and hygiene checks";
@@ -18,22 +20,23 @@ export default class DoctorCommand extends Command {
   };
 
   async run() {
-    const { flags } = await this.parse(DoctorCommand);
-    const result = await runDoctor({ dir: flags.dir, typecheck: flags.typecheck });
+    return withAssistantCommandResult("doctor", async () => {
+      const { flags } = await this.parse(DoctorCommand);
+      const result = await executeDoctorOperation(flags);
 
-    if (!this.jsonEnabled()) {
-      this.log(`testkit doctor ${result.ok ? "passed" : "failed"} for ${result.productDir}`);
-      for (const check of result.checks) {
-        this.log(`${check.level.toUpperCase()} ${check.code} ${check.message}`);
+      if (!this.jsonEnabled()) {
+        for (const line of renderDoctorResult(result)) {
+          this.log(line);
+        }
       }
-    }
 
-    if (!result.ok) {
-      const error = new Error("testkit doctor failed");
-      error.result = result;
-      throw error;
-    }
+      if (!result.ok) {
+        const error = new Error("testkit doctor failed");
+        error.result = result;
+        throw error;
+      }
 
-    return result;
+      return result;
+    });
   }
 }

package/lib/cli/commands/run.mjs

@@ -1,5 +1,8 @@
 import { Args, Command } from "@oclif/core";
-import { executeRunCommand, runFlags } from "../command-helpers.mjs";
+import { runFlags } from "../command-flags.mjs";
+import { buildRunRequest, executeRunRequest } from "../operations/run/operation.mjs";
+import { resolveTerminalCapabilities } from "../terminal/capabilities.mjs";
+import { withAssistantCommandResult } from "../assistant/command-results.mjs";
 
 export default class RunCommand extends Command {
   static summary = "Run test suites";
@@ -17,7 +20,15 @@ export default class RunCommand extends Command {
   static flags = runFlags;
 
   async run() {
-    const { args, flags } = await this.parse(RunCommand);
-    return executeRunCommand(this, flags, args.type || null);
+    return withAssistantCommandResult("run", async () => {
+      const { args, flags } = await this.parse(RunCommand);
+      const request = await buildRunRequest(flags, args.type || null, process.cwd(), process.cwd());
+      return executeRunRequest(request, {
+        outputMode: flags["output-mode"] || "compact",
+        json: this.jsonEnabled(),
+        debug: flags.debug,
+        terminal: resolveTerminalCapabilities(),
+      });
+    });
   }
 }

package/lib/cli/commands/status.mjs

@@ -1,5 +1,8 @@
 import { Command } from "@oclif/core";
-import { runStatusLike, sharedFlags } from "../command-helpers.mjs";
+import { sharedFlags } from "../command-flags.mjs";
+import { executeStatusOperation } from "../operations/status/operation.mjs";
+import { renderStatusResult } from "../renderers/status/text.mjs";
+import { withAssistantCommandResult } from "../assistant/command-results.mjs";
 
 export default class StatusCommand extends Command {
   static summary = "Show local testkit state";
@@ -9,7 +12,15 @@ export default class StatusCommand extends Command {
   static flags = sharedFlags;
 
   async run() {
-    const { flags } = await this.parse(StatusCommand);
-    return runStatusLike("status", flags);
+    return withAssistantCommandResult("status", async () => {
+      const { flags } = await this.parse(StatusCommand);
+      const results = await executeStatusOperation(flags);
+      if (!this.jsonEnabled()) {
+        for (const result of results) {
+          for (const line of renderStatusResult(result)) this.log(line);
+        }
+      }
+      return { ok: true, results };
+    });
   }
 }

package/lib/cli/commands/typecheck.mjs

@@ -1,5 +1,7 @@
 import { Command, Flags } from "@oclif/core";
-import { runTestkitTypecheck } from "../../app/typecheck.mjs";
+import { executeTypecheckOperation } from "../operations/typecheck/operation.mjs";
+import { renderTypecheckResult } from "../renderers/typecheck/text.mjs";
+import { withAssistantCommandResult } from "../assistant/command-results.mjs";
 
 export default class TypecheckCommand extends Command {
   static summary = "Typecheck testkit config, helpers, and suites";
@@ -13,16 +15,17 @@ export default class TypecheckCommand extends Command {
   };
 
   async run() {
-    const { flags } = await this.parse(TypecheckCommand);
-    const result = await runTestkitTypecheck({ dir: flags.dir });
+    return withAssistantCommandResult("typecheck", async () => {
+      const { flags } = await this.parse(TypecheckCommand);
+      const result = await executeTypecheckOperation(flags);
 
-    if (!this.jsonEnabled()) {
-      this.log(`Typechecked ${result.results.length} testkit program(s) in ${result.productDir}`);
-      for (const entry of result.results) {
-        this.log(`PASS ${entry.label} ${entry.tsconfigPath}`);
+      if (!this.jsonEnabled()) {
+        for (const line of renderTypecheckResult(result)) {
+          this.log(line);
+        }
       }
-    }
 
-    return result;
+      return result;
+    });
   }
 }

package/lib/cli/{tui/inspect-app.mjs → components/blocks/run-tree.mjs}

@@ -1,7 +1,7 @@
 import React, { createElement, useEffect, useMemo, useState } from "react";
 import { Box, Text, useAnimation, useApp, useInput } from "ink";
 import figures from "figures";
-import { formatDuration } from "../../runner/formatting.mjs";
+import { formatDuration } from "../../../runner/formatting.mjs";
 import {
   bold,
   colorService,
@@ -10,61 +10,60 @@ import {
   green,
   red,
   yellow,
-} from "../presentation/colors.mjs";
-import { renderSummaryBox } from "../presentation/summary-box.mjs";
-import { getTerminalWidth } from "../presentation/terminal-layout.mjs";
-import { readContextContent } from "../context-resources.mjs";
-import { applyHighlight } from "./fuzzy-match.mjs";
-import { FilterBar } from "./filter-bar.mjs";
+} from "../../terminal/colors.mjs";
+import { renderSummaryBox } from "../primitives/summary-box.mjs";
+import { applyHighlight } from "../../state/tree/fuzzy-match.mjs";
+import { FilterBar } from "../primitives/filter-bar.mjs";
 
 const SPINNER_FRAMES = ["|", "/", "-", "\\"];
 
-export function InspectApp({
-  inspectState,
+export function RunTreeView({
+  runState,
   stdout,
-  productDir,
   onRequestClose,
+  interactive = true,
 } = {}) {
   const { exit } = useApp();
-  const [snapshot, setSnapshot] = useState(() => inspectState.getSnapshot());
+  const [snapshot, setSnapshot] = useState(() => runState.getSnapshot());
   const { frame } = useAnimation({ interval: 80, isActive: !snapshot.finished });
   const spinnerFrame = SPINNER_FRAMES[frame % SPINNER_FRAMES.length];
 
   useEffect(() => {
-    const unsubscribe = inspectState.subscribe(() => {
-      setSnapshot(inspectState.getSnapshot());
+    const unsubscribe = runState.subscribe(() => {
+      setSnapshot(runState.getSnapshot());
     });
     return unsubscribe;
-  }, [inspectState]);
+  }, [runState]);
 
   useInput((input, key) => {
+    if (!interactive) return;
     if (!snapshot.finished) {
       if (input === "q") {
-        inspectState.setNotice("Run is still in progress. Wait for completion before closing.");
+        runState.setNotice("Run is still in progress. Wait for completion before closing.");
       }
       return;
     }
 
     if (snapshot.filter.active) {
       if (key.escape) {
-        inspectState.deactivateFilter();
+        runState.deactivateFilter();
         return;
       }
       if (key.return) return;
       if (key.downArrow || input === "j") {
-        inspectState.moveCursorDown();
+        runState.moveCursorDown();
         return;
       }
       if (key.upArrow || input === "k") {
-        inspectState.moveCursorUp();
+        runState.moveCursorUp();
         return;
       }
       if (key.backspace || key.delete) {
-        inspectState.updateFilterQuery(snapshot.filter.query.slice(0, -1));
+        runState.updateFilterQuery(snapshot.filter.query.slice(0, -1));
         return;
       }
       if (isPrintableInput(input, key)) {
-        inspectState.updateFilterQuery(`${snapshot.filter.query}${input}`);
+        runState.updateFilterQuery(`${snapshot.filter.query}${input}`);
       }
       return;
     }
@@ -74,43 +73,27 @@ export function InspectApp({
       return;
     }
     if (input === "/") {
-      inspectState.activateFilter();
+      runState.activateFilter();
       return;
     }
     if (key.downArrow || input === "j") {
-      inspectState.moveCursorDown();
+      runState.moveCursorDown();
       return;
     }
     if (key.upArrow || input === "k") {
-      inspectState.moveCursorUp();
+      runState.moveCursorUp();
       return;
     }
     if (key.return) {
-      inspectState.toggleExpand();
+      runState.toggleExpand();
       return;
     }
-    if (key.tab) {
-      inspectState.cyclePaneMode();
-      return;
-    }
-  });
+  }, { isActive: interactive });
 
-  const terminalWidth = getTerminalWidth(stdout, 100);
-  const leftWidth = Math.max(42, Math.floor(terminalWidth * 0.52));
-  const rightWidth = Math.max(28, terminalWidth - leftWidth - 1);
   const visibleTreeEntries = useMemo(
-    () => buildTreeViewport(snapshot.visibleEntries, snapshot.selectedEntryId, 17),
+    () => buildTreeViewport(snapshot.visibleEntries, snapshot.selectedEntryId, 24),
     [snapshot.visibleEntries, snapshot.selectedEntryId]
   );
-  const paneContent = useMemo(
-    () =>
-      readContextContent({
-        productDir,
-        snapshot,
-        mode: snapshot.paneMode,
-      }),
-    [productDir, snapshot]
-  );
   const summaryLines = snapshot.finished && snapshot.summaryData
     ? renderSummaryBox(snapshot.summaryData.rows, { stdout })
     : [];
@@ -122,15 +105,8 @@ export function InspectApp({
     snapshot.notice ? createElement(Text, { key: "notice" }, yellow(snapshot.notice)) : null,
     createElement(
       Box,
-      { key: "main", marginTop: 1, flexDirection: "row" },
-      createElement(Box, { width: leftWidth, flexDirection: "column", paddingRight: 1 }, ...visibleTreeEntries.map(renderTreeLine.bind(null, snapshot, spinnerFrame))),
-      createElement(
-        Box,
-        { width: rightWidth, flexDirection: "column", paddingLeft: 1 },
-        createElement(Text, { key: "pane-title" }, bold(paneContent.title)),
-        createElement(Text, { key: "pane-gap" }, ""),
-        ...paneContent.lines.slice(0, 34).map((line, index) => createElement(Text, { key: `pane-${index}` }, line))
-      )
+      { key: "main", marginTop: 1, flexDirection: "column" },
+      ...visibleTreeEntries.map(renderTreeLine.bind(null, snapshot, spinnerFrame))
     ),
     snapshot.filter.active ? createElement(Text, { key: "filter-gap" }, "") : null,
     snapshot.filter.active ? createElement(FilterBar, { key: "filter-bar", filter: snapshot.filter }) : null,
@@ -144,7 +120,7 @@ export function InspectApp({
 export function buildHeaderText(snapshot) {
   const progressText = snapshot.totalCount > 0 ? `[${snapshot.completedCount}/${snapshot.totalCount}]` : "[0/0]";
   const phaseText = snapshot.phase || (snapshot.finished ? "run complete" : "preparing");
-  const sourceText = snapshot.dataSource === "artifact" ? "artifact inspect" : snapshot.finished ? "live summary" : "live run";
+  const sourceText = snapshot.dataSource === "artifact" ? "artifact run" : snapshot.finished ? "live summary" : "live run";
   const filterText = snapshot.filter.active ? `filter ${snapshot.filter.count}` : null;
   return [progressText, phaseText, sourceText, filterText].filter(Boolean).join(" · ");
 }
@@ -154,8 +130,7 @@ export function buildFooterText(snapshot) {
   if (snapshot.filter.active) {
     return "type to filter · ↑/↓ move · Esc clear filter · q quit";
   }
-  const inspectKeys = "↑/↓ move · Enter collapse/expand · Tab cycle pane · / filter";
-  return `${inspectKeys} · q quit`;
+  return "↑/↓ move · Enter collapse/expand · / filter · q quit";
 }
 
 function buildTreeViewport(entries, selectedEntryId, radius) {

package/lib/cli/{tui → components/primitives}/filter-bar.mjs

@@ -1,6 +1,6 @@
 import React, { createElement } from "react";
 import { Text } from "ink";
-import { bold, dim } from "../presentation/colors.mjs";
+import { bold, dim } from "../../terminal/colors.mjs";
 
 export function FilterBar({ filter } = {}) {
   if (!filter?.active) return null;

package/lib/cli/{presentation → components/primitives}/summary-box.mjs

@@ -1,5 +1,5 @@
 import figures from "figures";
-import { clamp, getTerminalWidth, measureWidth, padEndVisible, wrapText } from "./terminal-layout.mjs";
+import { clamp, getTerminalWidth, measureWidth, padEndVisible, wrapText } from "../../terminal/layout.mjs";
 
 export function renderSummaryBox(
   rows,

package/lib/cli/config.mjs

@@ -0,0 +1,63 @@
+import fs from "fs";
+import path from "path";
+
+export const DEFAULT_CLI_CONFIG = Object.freeze({
+  autoCollapsePassedTreeBranches: true,
+});
+
+export function cliConfigPath(productDir) {
+  return path.join(productDir || process.cwd(), ".testkit", "config.json");
+}
+
+export function loadCliConfig(productDir) {
+  try {
+    return normalizeCliConfig(JSON.parse(fs.readFileSync(cliConfigPath(productDir), "utf8")));
+  } catch {
+    return { ...DEFAULT_CLI_CONFIG };
+  }
+}
+
+export function saveCliConfig(productDir, config) {
+  const filePath = cliConfigPath(productDir);
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, `${JSON.stringify(normalizeCliConfig(config), null, 2)}\n`, "utf8");
+}
+
+export function resetCliConfig(productDir) {
+  fs.rmSync(cliConfigPath(productDir), { force: true });
+  return { ...DEFAULT_CLI_CONFIG };
+}
+
+export function mergeCliConfig(...configs) {
+  let merged = { ...DEFAULT_CLI_CONFIG };
+  for (const config of configs) {
+    if (!config || typeof config !== "object") continue;
+    merged = normalizeCliConfig({ ...merged, ...dropUndefined(config) });
+  }
+  return merged;
+}
+
+export function normalizeCliConfig(config = {}) {
+  return {
+    autoCollapsePassedTreeBranches:
+      config.autoCollapsePassedTreeBranches == null
+        ? DEFAULT_CLI_CONFIG.autoCollapsePassedTreeBranches
+        : Boolean(config.autoCollapsePassedTreeBranches),
+  };
+}
+
+export function formatCliConfig(config) {
+  const normalized = normalizeCliConfig(config);
+  return [
+    `autoCollapsePassedTreeBranches: ${normalized.autoCollapsePassedTreeBranches}`,
+    `path: .testkit/config.json`,
+  ].join("\n");
+}
+
+function dropUndefined(value) {
+  const result = {};
+  for (const [key, entry] of Object.entries(value)) {
+    if (entry !== undefined) result[key] = entry;
+  }
+  return result;
+}

package/lib/cli/entrypoint.mjs

@@ -1,4 +1,7 @@
 export function normalizeCliArgs(argv) {
+  if (argv[0] === "help") return normalizeHelpInvocation(argv);
+  if (isOclifBuiltinInvocation(argv)) return argv;
+
   const topLevelCommands = new Set([
     "assistant",
     "run",
@@ -10,11 +13,6 @@ export function normalizeCliArgs(argv) {
     "doctor",
     "browser",
     "db",
-    "help",
-    "--help",
-    "-h",
-    "--version",
-    "-v",
   ]);
   const runTypeShortcuts = new Set(["int", "e2e", "scenario", "dal", "load", "pw", "all"]);
   const valueFlags = new Set([
@@ -95,6 +93,17 @@ export function normalizeCliArgs(argv) {
   return argv;
 }
 
+function isOclifBuiltinInvocation(argv) {
+  const first = argv[0];
+  if (first === "--help" || first === "-h" || first === "--version" || first === "-v") return true;
+  return false;
+}
+
+function normalizeHelpInvocation(argv) {
+  if (!argv[1]) return ["--help"];
+  return [argv[1], ...argv.slice(2), "--help"];
+}
+
 function findPositionals(args, flagsWithValues) {
   const positionals = [];
   for (let index = 0; index < args.length; index += 1) {

package/lib/cli/operations/browser/serve/operation.mjs

@@ -0,0 +1,23 @@
+import { startBrowserBridgeServer } from "@elench/testkit-bridge";
+import { loadBrowserBridgeContext } from "../../../../app/browser-bridge.mjs";
+
+export async function executeBrowserServeOperation(flags = {}) {
+  const { productDir, context } = await loadBrowserBridgeContext({ dir: flags.dir });
+
+  const adapter = {
+    loadProductContext: async () => context,
+  };
+
+  const serverRef = await startBrowserBridgeServer(adapter, {
+    host: flags.host,
+    port: flags.port,
+  });
+
+  return {
+    ok: true,
+    productDir,
+    host: serverRef.host,
+    port: serverRef.port,
+    url: serverRef.url,
+  };
+}

package/lib/cli/operations/cleanup/operation.mjs

@@ -0,0 +1,8 @@
+import * as runner from "../../../runner/index.mjs";
+import { loadManagedConfigs } from "../../../app/configs.mjs";
+
+export async function executeCleanupOperation(flags = {}) {
+  const { allConfigs } = await loadManagedConfigs({ dir: flags.dir, service: flags.service });
+  const productDir = allConfigs[0]?.productDir || process.cwd();
+  return runner.cleanup(productDir);
+}

package/lib/cli/{db.mjs → operations/db/snapshot/capture/operation.mjs}

@@ -1,15 +1,15 @@
 import fs from "fs";
 import os from "os";
 import path from "path";
-import { loadManagedConfigs, resolveTargetConfig, collectRequiredConfigs, topologicallySortConfigs } from "../app/configs.mjs";
-import { resolveProductDir } from "../config/index.mjs";
-import { captureDatabaseTemplateSnapshot, prepareDatabaseRuntime } from "../database/index.mjs";
-import { createRunReporter } from "./presentation/run-reporter.mjs";
-import { createRunLogRegistry } from "../runner/logs.mjs";
-import { createSetupOperationRegistry } from "../runner/setup-operations.mjs";
-import { resolveRuntimeInstanceConfigs } from "../runner/template.mjs";
+import { loadManagedConfigs, resolveTargetConfig, collectRequiredConfigs, topologicallySortConfigs } from "../../../../../app/configs.mjs";
+import { resolveProductDir } from "../../../../../config/index.mjs";
+import { captureDatabaseTemplateSnapshot, prepareDatabaseRuntime } from "../../../../../database/index.mjs";
+import { createRunReporter } from "../../../../renderers/run/text-reporter.mjs";
+import { createRunLogRegistry } from "../../../../../runner/logs.mjs";
+import { createSetupOperationRegistry } from "../../../../../runner/setup-operations.mjs";
+import { resolveRuntimeInstanceConfigs } from "../../../../../runner/template.mjs";
 
-export async function runDatabaseSnapshotCaptureCommand(options = {}) {
+export async function executeDatabaseSnapshotCaptureOperation(options = {}) {
   const productDir = resolveProductDir(process.cwd(), options.dir);
   const { configs } = await loadManagedConfigs({ dir: productDir });
   const target = resolveTargetConfig(configs, options.service);
@@ -51,7 +51,13 @@ export async function runDatabaseSnapshotCaptureCommand(options = {}) {
       logRegistry,
       setupRegistry,
     });
-    console.log(`Wrote ${path.relative(productDir, absoluteOutputPath)}`);
+    return {
+      ok: true,
+      productDir,
+      service: target.name,
+      outputPath: absoluteOutputPath,
+      outputLabel: path.relative(productDir, absoluteOutputPath) || path.basename(absoluteOutputPath),
+    };
   } finally {
     logRegistry.closeAll();
     fs.rmSync(runtimeRoot, { recursive: true, force: true });

package/lib/cli/operations/destroy/operation.mjs

@@ -0,0 +1,12 @@
+import * as runner from "../../../runner/index.mjs";
+import { loadManagedConfigs } from "../../../app/configs.mjs";
+
+export async function executeDestroyOperation(flags = {}) {
+  const { configs } = await loadManagedConfigs({ dir: flags.dir, service: flags.service });
+  const results = [];
+  for (const config of configs) {
+    await runner.destroy(config);
+    results.push({ name: config.name, destroyed: true });
+  }
+  return results;
+}

package/lib/cli/operations/discover/operation.mjs

@@ -0,0 +1,32 @@
+import fs from "fs";
+import path from "path";
+import { discoverTests } from "../../../discovery/index.mjs";
+import { resolveProductDir } from "../../../config/index.mjs";
+import { resolveRequestedFiles } from "../../args.mjs";
+
+export async function executeDiscoverOperation(flags = {}, cwd = process.cwd()) {
+  const productDir = resolveProductDir(cwd, flags.dir);
+  const fileNames = resolveRequestedFiles(flags.file || [], productDir, cwd);
+  const result = await discoverTests({
+    dir: productDir,
+    service: flags.service || null,
+    type: flags.type || [],
+    suite: flags.suite || [],
+    file: fileNames,
+    runnableOnly: flags["runnable-only"],
+    diagnostics: flags.strict ? "error" : "report",
+  });
+
+  let outputLabel = null;
+  if (flags.output) {
+    const outputPath = path.resolve(productDir, flags.output);
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, `${JSON.stringify(result, null, 2)}\n`);
+    outputLabel = path.relative(productDir, outputPath) || path.basename(outputPath);
+  }
+
+  return {
+    ...result,
+    outputLabel,
+  };
+}

package/lib/cli/operations/doctor/operation.mjs

@@ -0,0 +1,5 @@
+import { runDoctor } from "../../../app/doctor.mjs";
+
+export async function executeDoctorOperation(flags = {}) {
+  return runDoctor({ dir: flags.dir, typecheck: flags.typecheck });
+}