@sentry/junior 0.202.0 → 0.204.0

package/dist/cli/plugins.js

@@ -1,249 +1,170 @@
-import {
-  validatePluginEgressCredentialHooks,
-  validatePluginRegistrations
-} from "../chunk-C6VVF43U.js";
-import {
-  pluginCatalogConfigFromPluginSet,
-  pluginCliRegistrationsFromPluginSet,
-  pluginRuntimeRegistrationsFromPluginSet
-} from "../chunk-CM5HNV2W.js";
-import {
-  loadAppPluginSet
-} from "../chunk-Y2CM7HXH.js";
-import {
-  createPluginLogger,
-  setPlugins,
-  validatePlugins
-} from "../chunk-U2GPUYAL.js";
-import "../chunk-3Y47VMHV.js";
-import {
-  getDb
-} from "../chunk-M76HMB7M.js";
-import "../chunk-PW4P4JYF.js";
-import "../chunk-NSXKRGRT.js";
-import "../chunk-2MK3QBGA.js";
-import "../chunk-7NL7T6VU.js";
-import "../chunk-VFUK3X5B.js";
-import "../chunk-63NKKFJL.js";
-import "../chunk-NHJU2ZAL.js";
-import "../chunk-5NOPO64K.js";
-import {
-  pluginCatalogRuntime
-} from "../chunk-YDUR3ZYW.js";
-import "../chunk-BXCX5QKA.js";
-import "../chunk-CEMMLV5L.js";
-import "../chunk-N7TMSOZH.js";
-import "../chunk-DWPN6SCH.js";
-import "../chunk-TXKUKMVO.js";
-import "../chunk-MAGNK5J4.js";
-import "../chunk-PEQXYSSE.js";
-import "../chunk-HMREVIO2.js";
-
-// src/cli/plugins.ts
-import { stderr as defaultStderr, stdout as defaultStdout } from "process";
+import { Et as getDb, _t as createPluginLogger, d as setPlugins, f as validatePlugins } from "../agent-hooks-Bbcp9e33.js";
+import { n as pluginCatalogRuntime } from "../catalog-runtime-BReos-D4.js";
+import { n as validatePluginRegistrations, t as validatePluginEgressCredentialHooks } from "../validation-C2CR-OX3.js";
+import { a as pluginRuntimeRegistrationsFromPluginSet, i as pluginCliRegistrationsFromPluginSet, r as pluginCatalogConfigFromPluginSet } from "../plugins-egKWjgue.js";
+import { t as loadAppPluginSet } from "../plugin-module-BKGOXca2.js";
+import { stderr, stdout } from "node:process";
 import { createJiti } from "jiti";
 import { Command, CommanderError } from "commander";
-var pluginCliLoader = createJiti(import.meta.url, { moduleCache: false });
-var CORE_COMMAND_NAMES = /* @__PURE__ */ new Set([
-  "chat",
-  "check",
-  "init",
-  "snapshot",
-  "upgrade"
+//#region src/cli/plugins.ts
+/**
+* Plugin CLI bootstrap for the local/package command line.
+* This module imports app plugins, validates top-level namespaces before
+* installing runtime plugin state, and dispatches only plugin-owned subcommands.
+*/
+const pluginCliLoader = createJiti(import.meta.url, { moduleCache: false });
+const CORE_COMMAND_NAMES = /* @__PURE__ */ new Set([
+	"chat",
+	"check",
+	"init",
+	"snapshot",
+	"upgrade"
 ]);
-var PLUGIN_COMMAND_NAME_RE = /^[a-z][a-z0-9-]*$/;
-var DEFAULT_IO = {
-  writeError: (text) => writeStream(defaultStderr, text),
-  writeOutput: (text) => writeStream(defaultStdout, text)
+const PLUGIN_COMMAND_NAME_RE = /^[a-z][a-z0-9-]*$/;
+const DEFAULT_IO = {
+	writeError: (text) => writeStream(stderr, text),
+	writeOutput: (text) => writeStream(stdout, text)
 };
 function writeStream(stream, text) {
-  return new Promise((resolve, reject) => {
-    stream.write(text, (error) => {
-      if (error) {
-        reject(error);
-        return;
-      }
-      resolve();
-    });
-  });
+	return new Promise((resolve, reject) => {
+		stream.write(text, (error) => {
+			if (error) {
+				reject(error);
+				return;
+			}
+			resolve();
+		});
+	});
 }
+/** Load the app plugin set once for one CLI process. */
 async function loadCliPluginSet() {
-  return await loadAppPluginSet(
-    process.cwd(),
-    async (moduleRef) => pluginCliLoader.import(moduleRef.importPath)
-  );
+	return await loadAppPluginSet(process.cwd(), async (moduleRef) => pluginCliLoader.import(moduleRef.importPath));
 }
 function findPluginCommand(plugins, commandName) {
-  for (const plugin of plugins) {
-    const command = plugin.cli?.commands.find(
-      (candidate) => candidate.name === commandName
-    );
-    if (command) {
-      return { command, plugin };
-    }
-  }
-  return void 0;
+	for (const plugin of plugins) {
+		const command = plugin.cli?.commands.find((candidate) => candidate.name === commandName);
+		if (command) return {
+			command,
+			plugin
+		};
+	}
 }
 function createPluginCliHost(args) {
-  return {
-    action(handler) {
-      return async (...actionArgs) => {
-        const pluginName = args.plugin.manifest.name;
-        const result = await handler(
-          {
-            db: getDb(),
-            command: {
-              name: args.command.name,
-              summary: args.command.summary
-            },
-            io: args.io,
-            log: createPluginLogger(pluginName),
-            plugin: { name: pluginName }
-          },
-          ...actionArgs
-        );
-        args.setExitCode(result ?? 0);
-      };
-    }
-  };
+	return { action(handler) {
+		return async (...actionArgs) => {
+			const pluginName = args.plugin.manifest.name;
+			const result = await handler({
+				db: getDb(),
+				command: {
+					name: args.command.name,
+					summary: args.command.summary
+				},
+				io: args.io,
+				log: createPluginLogger(pluginName),
+				plugin: { name: pluginName }
+			}, ...actionArgs);
+			args.setExitCode(result ?? 0);
+		};
+	} };
 }
 function createPluginCommanderCommand(args) {
-  const command = new Command(args.command.name).description(args.command.summary).exitOverride().showHelpAfterError().showSuggestionAfterError().configureOutput({
-    writeOut: (text) => {
-      void args.io.writeOutput(text);
-    },
-    writeErr: (text) => {
-      void args.io.writeError(text);
-    },
-    outputError: (text, write) => {
-      write(text);
-    }
-  });
-  args.command.configure(command, createPluginCliHost(args));
-  return command;
+	const command = new Command(args.command.name).description(args.command.summary).exitOverride().showHelpAfterError().showSuggestionAfterError().configureOutput({
+		writeOut: (text) => {
+			args.io.writeOutput(text);
+		},
+		writeErr: (text) => {
+			args.io.writeError(text);
+		},
+		outputError: (text, write) => {
+			write(text);
+		}
+	});
+	args.command.configure(command, createPluginCliHost(args));
+	return command;
 }
 function validateConfiguredPluginCommand(args) {
-  const pluginName = args.plugin.manifest.name;
-  if (args.command.name() !== args.definition.name) {
-    throw new Error(
-      `Plugin CLI command "${args.definition.name}" from plugin "${pluginName}" must not rename its top-level command`
-    );
-  }
-  if (args.command.commands.length === 0) {
-    throw new Error(
-      `Plugin CLI command "${args.definition.name}" from plugin "${pluginName}" must define at least one subcommand`
-    );
-  }
-  if (args.command.aliases().length > 0) {
-    throw new Error(
-      `Plugin CLI command "${args.definition.name}" from plugin "${pluginName}" must not define top-level aliases`
-    );
-  }
+	const pluginName = args.plugin.manifest.name;
+	if (args.command.name() !== args.definition.name) throw new Error(`Plugin CLI command "${args.definition.name}" from plugin "${pluginName}" must not rename its top-level command`);
+	if (args.command.commands.length === 0) throw new Error(`Plugin CLI command "${args.definition.name}" from plugin "${pluginName}" must define at least one subcommand`);
+	if (args.command.aliases().length > 0) throw new Error(`Plugin CLI command "${args.definition.name}" from plugin "${pluginName}" must not define top-level aliases`);
 }
 function validateConfiguredPluginCommands(plugins) {
-  const ownerByName = /* @__PURE__ */ new Map();
-  const validationIo = DEFAULT_IO;
-  for (const plugin of plugins) {
-    for (const definition of plugin.cli?.commands ?? []) {
-      const pluginName = plugin.manifest.name;
-      const existingOwner = ownerByName.get(definition.name);
-      if (!PLUGIN_COMMAND_NAME_RE.test(definition.name)) {
-        throw new Error(
-          `Plugin CLI command "${definition.name}" from plugin "${pluginName}" must be a lowercase command identifier`
-        );
-      }
-      if (CORE_COMMAND_NAMES.has(definition.name)) {
-        throw new Error(
-          `Plugin CLI command "${definition.name}" from plugin "${pluginName}" conflicts with a core command`
-        );
-      }
-      if (existingOwner) {
-        throw new Error(
-          `Plugin CLI command "${definition.name}" from plugin "${pluginName}" conflicts with plugin "${existingOwner}"`
-        );
-      }
-      ownerByName.set(definition.name, pluginName);
-      if (typeof definition.configure !== "function") {
-        throw new Error(
-          `Plugin CLI command "${definition.name}" from plugin "${pluginName}" must define a configure function`
-        );
-      }
-      let exitCode = 0;
-      validateConfiguredPluginCommand({
-        command: createPluginCommanderCommand({
-          command: definition,
-          io: validationIo,
-          plugin,
-          setExitCode: (nextExitCode) => {
-            exitCode = nextExitCode;
-          }
-        }),
-        definition,
-        plugin
-      });
-      void exitCode;
-    }
-  }
+	const ownerByName = /* @__PURE__ */ new Map();
+	const validationIo = DEFAULT_IO;
+	for (const plugin of plugins) for (const definition of plugin.cli?.commands ?? []) {
+		const pluginName = plugin.manifest.name;
+		const existingOwner = ownerByName.get(definition.name);
+		if (!PLUGIN_COMMAND_NAME_RE.test(definition.name)) throw new Error(`Plugin CLI command "${definition.name}" from plugin "${pluginName}" must be a lowercase command identifier`);
+		if (CORE_COMMAND_NAMES.has(definition.name)) throw new Error(`Plugin CLI command "${definition.name}" from plugin "${pluginName}" conflicts with a core command`);
+		if (existingOwner) throw new Error(`Plugin CLI command "${definition.name}" from plugin "${pluginName}" conflicts with plugin "${existingOwner}"`);
+		ownerByName.set(definition.name, pluginName);
+		if (typeof definition.configure !== "function") throw new Error(`Plugin CLI command "${definition.name}" from plugin "${pluginName}" must define a configure function`);
+		validateConfiguredPluginCommand({
+			command: createPluginCommanderCommand({
+				command: definition,
+				io: validationIo,
+				plugin,
+				setExitCode: (nextExitCode) => {}
+			}),
+			definition,
+			plugin
+		});
+	}
 }
 async function loadPluginRegistrations(args) {
-  const pluginSet = args.pluginSet;
-  if (!pluginSet) {
-    return { cliPlugins: [], runtimePlugins: [] };
-  }
-  const cliPlugins = pluginCliRegistrationsFromPluginSet(pluginSet);
-  const runtimePlugins = pluginRuntimeRegistrationsFromPluginSet(pluginSet);
-  const pluginConfig = pluginCatalogConfigFromPluginSet(pluginSet);
-  validatePlugins(runtimePlugins);
-  const previousPluginCatalogConfig = pluginCatalogRuntime.setConfig(pluginConfig);
-  try {
-    validatePluginRegistrations(pluginSet.registrations);
-    validatePluginEgressCredentialHooks(pluginSet.registrations);
-    args.validateConfiguredCommands?.(cliPlugins);
-    setPlugins(runtimePlugins);
-    return { cliPlugins, runtimePlugins };
-  } catch (error) {
-    pluginCatalogRuntime.setConfig(previousPluginCatalogConfig);
-    throw error;
-  }
+	const pluginSet = args.pluginSet;
+	if (!pluginSet) return {
+		cliPlugins: [],
+		runtimePlugins: []
+	};
+	const cliPlugins = pluginCliRegistrationsFromPluginSet(pluginSet);
+	const runtimePlugins = pluginRuntimeRegistrationsFromPluginSet(pluginSet);
+	const pluginConfig = pluginCatalogConfigFromPluginSet(pluginSet);
+	validatePlugins(runtimePlugins);
+	const previousPluginCatalogConfig = pluginCatalogRuntime.setConfig(pluginConfig);
+	try {
+		validatePluginRegistrations(pluginSet.registrations);
+		validatePluginEgressCredentialHooks(pluginSet.registrations);
+		args.validateConfiguredCommands?.(cliPlugins);
+		setPlugins(runtimePlugins);
+		return {
+			cliPlugins,
+			runtimePlugins
+		};
+	} catch (error) {
+		pluginCatalogRuntime.setConfig(previousPluginCatalogConfig);
+		throw error;
+	}
 }
+/** Import configured app plugins and build the plugin CLI command dispatcher. */
 async function loadCliPluginCommands(pluginSet) {
-  const resolvedPluginSet = pluginSet === void 0 ? await loadCliPluginSet() : pluginSet ?? void 0;
-  const { cliPlugins } = await loadPluginRegistrations({
-    pluginSet: resolvedPluginSet,
-    validateConfiguredCommands: validateConfiguredPluginCommands
-  });
-  const commandNames = cliPlugins.flatMap(
-    (plugin) => (plugin.cli?.commands ?? []).map((command) => command.name)
-  );
-  return {
-    commandNames,
-    async run(commandName, argv, io = DEFAULT_IO) {
-      const resolved = findPluginCommand(cliPlugins, commandName);
-      if (!resolved) {
-        return void 0;
-      }
-      let exitCode = 0;
-      const command = createPluginCommanderCommand({
-        command: resolved.command,
-        io,
-        plugin: resolved.plugin,
-        setExitCode: (nextExitCode) => {
-          exitCode = nextExitCode;
-        }
-      });
-      try {
-        await command.parseAsync(argv, { from: "user" });
-      } catch (error) {
-        if (error instanceof CommanderError) {
-          return error.exitCode;
-        }
-        throw error;
-      }
-      return exitCode;
-    }
-  };
+	const { cliPlugins } = await loadPluginRegistrations({
+		pluginSet: pluginSet === void 0 ? await loadCliPluginSet() : pluginSet ?? void 0,
+		validateConfiguredCommands: validateConfiguredPluginCommands
+	});
+	return {
+		commandNames: cliPlugins.flatMap((plugin) => (plugin.cli?.commands ?? []).map((command) => command.name)),
+		async run(commandName, argv, io = DEFAULT_IO) {
+			const resolved = findPluginCommand(cliPlugins, commandName);
+			if (!resolved) return;
+			let exitCode = 0;
+			const command = createPluginCommanderCommand({
+				command: resolved.command,
+				io,
+				plugin: resolved.plugin,
+				setExitCode: (nextExitCode) => {
+					exitCode = nextExitCode;
+				}
+			});
+			try {
+				await command.parseAsync(argv, { from: "user" });
+			} catch (error) {
+				if (error instanceof CommanderError) return error.exitCode;
+				throw error;
+			}
+			return exitCode;
+		}
+	};
 }
-export {
-  loadCliPluginCommands,
-  loadCliPluginSet
-};
+//#endregion
+export { loadCliPluginCommands, loadCliPluginSet };

package/dist/cli/run.d.ts

@@ -0,0 +1,16 @@
+//#region src/cli/run.d.ts
+export declare const CLI_USAGE = "usage: junior init <dir>\n       junior snapshot create\n       junior check [dir]\n       junior upgrade\n       junior chat\n       junior chat -p <message>";
+interface CliHandlers {
+  runChat: (argv: string[]) => Promise<number>;
+  runInit: (dir: string) => Promise<void>;
+  runSnapshotCreate: () => Promise<void>;
+  runCheck: (dir?: string) => Promise<void>;
+  runUpgrade: () => Promise<void>;
+  runPluginCommand?: (command: string, argv: string[]) => Promise<number | undefined>;
+}
+interface CliIo {
+  error: (line: string) => void;
+}
+/** Dispatch CLI arguments to command handlers and return a process exit code. */
+export declare function runCli(argv: string[], handlers: CliHandlers, io?: CliIo): Promise<number>;
+//#endregion

package/dist/cli/run.js

@@ -1,8 +1,52 @@
-import {
-  CLI_USAGE,
-  runCli
-} from "../chunk-4UO6FK4G.js";
-export {
-  CLI_USAGE,
-  runCli
-};
+//#region src/cli/run.ts
+const CLI_USAGE = "usage: junior init <dir>\n       junior snapshot create\n       junior check [dir]\n       junior upgrade\n       junior chat\n       junior chat -p <message>";
+const DEFAULT_IO = { error: console.error };
+/** Strip Node's leading argv separator while preserving command-level flags. */
+function normalizeCliArgv(argv) {
+	return argv[0] === "--" ? argv.slice(1) : argv;
+}
+/** Dispatch CLI arguments to command handlers and return a process exit code. */
+async function runCli(argv, handlers, io = DEFAULT_IO) {
+	const [command, subcommand, ...rest] = normalizeCliArgv(argv);
+	if (command === "chat") return await handlers.runChat(subcommand === void 0 ? [] : [subcommand, ...rest]);
+	if (command === "init") {
+		if (!subcommand || rest.length > 0) {
+			io.error(CLI_USAGE);
+			return 1;
+		}
+		await handlers.runInit(subcommand);
+		return 0;
+	}
+	if (command === "snapshot" && subcommand === "create") {
+		if (rest.length > 0) {
+			io.error(CLI_USAGE);
+			return 1;
+		}
+		await handlers.runSnapshotCreate();
+		return 0;
+	}
+	if (command === "check") {
+		if (rest.length > 0) {
+			io.error(CLI_USAGE);
+			return 1;
+		}
+		await handlers.runCheck(subcommand);
+		return 0;
+	}
+	if (command === "upgrade") {
+		if (subcommand || rest.length > 0) {
+			io.error(CLI_USAGE);
+			return 1;
+		}
+		await handlers.runUpgrade();
+		return 0;
+	}
+	if (command && handlers.runPluginCommand) {
+		const exitCode = await handlers.runPluginCommand(command, subcommand === void 0 ? [] : [subcommand, ...rest]);
+		if (exitCode !== void 0) return exitCode;
+	}
+	io.error(CLI_USAGE);
+	return 1;
+}
+//#endregion
+export { CLI_USAGE, runCli };

package/dist/cli/snapshot-create.d.ts

@@ -0,0 +1,4 @@
+//#region src/cli/snapshot-create.d.ts
+/** Resolve or create the default sandbox snapshot and report its progress. */
+export declare function runSnapshotCreate(log?: (line: string) => void): Promise<void>;
+//#endregion