stratal 0.0.15 → 0.0.17

package/README.md

@@ -80,6 +80,10 @@ Stratal provides [Agent Skills](https://agentskills.io) for AI coding assistants
 npx skills add strataljs/stratal
 ```
 
+| Skill | Description |
+|---|---|
+| `stratal` | Build Cloudflare Workers apps with the Stratal framework — modules, DI, controllers, routing, OpenAPI, queues, cron, events, seeders, CLI, auth, database, RBAC, testing, and more |
+
 ## Quick Start
 
 Define a module with a controller and wire it up as a Cloudflare Worker:

package/dist/{application-Du0d8O_e.d.mts → application-DfPtIzxF.d.mts}

@@ -1,12 +1,73 @@
-import { $t as Container, Ht as StratalEnv, It as VersioningOptions, Tt as RouterContext, U as HonoApp, ct as ModuleClass, it as DynamicModule } from "./index-D69rxo8H.mjs";
-import { l as LogLevel } from "./index-Cfkie8JM.mjs";
-import { r as CommandResult, t as CommandInput } from "./types-N84Ak6YT.mjs";
+import { Et as RouterContext, Lt as VersioningOptions, U as HonoApp, Ut as StratalEnv, at as DynamicModule, en as Container, lt as ModuleClass } from "./index-BFCxSp_f.mjs";
+import { l as LogLevel } from "./index-Dp6A5ywM.mjs";
 
 //#region src/execution-context.d.ts
 interface StratalExecutionContext {
   waitUntil(promise: Promise<unknown>): void;
 }
 //#endregion
+//#region src/quarry/types.d.ts
+/**
+ * Flat input object for programmatic command invocation.
+ */
+type CommandInput = Record<string, unknown>;
+/**
+ * Result of a command execution.
+ */
+interface CommandResult {
+  exitCode: number;
+  output: string[];
+  errors: string[];
+}
+/**
+ * User-facing Quarry interface. Only exposes the `call()` method.
+ *
+ * Inject via `@inject(DI_TOKENS.Quarry)` and type as `Quarry`.
+ */
+interface Quarry {
+  call(name: string, input?: CommandInput): Promise<CommandResult>;
+}
+/**
+ * Internal mutable state stored on Command instances via Symbol key.
+ * @internal
+ */
+interface CommandInternals {
+  inputs: CommandInput;
+  output: string[];
+  errors: string[];
+  exitCode: number;
+  quarry: Quarry | null;
+}
+/**
+ * A parsed argument from a Laravel-style signature string.
+ */
+interface ParsedArgument {
+  name: string;
+  required: boolean;
+  default?: string;
+  description?: string;
+  isArray: boolean;
+}
+/**
+ * A parsed option from a Laravel-style signature string.
+ */
+interface ParsedOption {
+  name: string;
+  alias?: string;
+  isFlag: boolean;
+  isArray: boolean;
+  default?: string;
+  description?: string;
+}
+/**
+ * Fully parsed command signature.
+ */
+interface ParsedSignature {
+  name: string;
+  arguments: ParsedArgument[];
+  options: ParsedOption[];
+}
+//#endregion
 //#region src/application.d.ts
 interface ApplicationConfig {
   /** Root application module */
@@ -112,5 +173,5 @@ declare class Application {
   private registerCoreServices;
 }
 //#endregion
-export { StratalExecutionContext as i, ApplicationConfig as n, ApplicationOptions as r, Application as t };
-//# sourceMappingURL=application-Du0d8O_e.d.mts.map
+export { CommandInternals as a, ParsedOption as c, StratalExecutionContext as d, CommandInput as i, ParsedSignature as l, ApplicationConfig as n, CommandResult as o, ApplicationOptions as r, ParsedArgument as s, Application as t, Quarry as u };
+//# sourceMappingURL=application-DfPtIzxF.d.mts.map

package/dist/application-DfPtIzxF.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-DfPtIzxF.d.mts","names":[],"sources":["../src/execution-context.ts","../src/quarry/types.ts","../src/application.ts"],"mappings":";;;;UAAiB,uBAAA;EACf,SAAA,CAAU,OAAA,EAAS,OAAA;AAAA;;;;;;KCET,YAAA,GAAe,MAAA;ADH3B;;;AAAA,UCQiB,aAAA;EACf,QAAA;EACA,MAAA;EACA,MAAA;AAAA;;;;;AARF;UAgBiB,MAAA;EACf,IAAA,CAAK,IAAA,UAAc,KAAA,GAAQ,YAAA,GAAe,OAAA,CAAQ,aAAA;AAAA;;AAZpD;;;UAmBiB,gBAAA;EACf,MAAA,EAAQ,YAAA;EACR,MAAA;EACA,MAAA;EACA,QAAA;EACA,MAAA,EAAQ,MAAA;AAAA;;;;UAMO,cAAA;EACf,IAAA;EACA,QAAA;EACA,OAAA;EACA,WAAA;EACA,OAAA;AAAA;;;;UAMe,YAAA;EACf,IAAA;EACA,KAAA;EACA,MAAA;EACA,OAAA;EACA,OAAA;EACA,WAAA;AAAA;;;;UAMe,eAAA;EACf,IAAA;EACA,SAAA,EAAW,cAAA;EACX,OAAA,EAAS,YAAA;AAAA;;;UC1BM,iBAAA;EFrCL;EEuCV,MAAA,EAAQ,WAAA,GAAc,aAAA;EFvCa;EEyCnC,OAAA;IACE,KAAA,GAAQ,QAAA;IACR,SAAA;EAAA;EDzCoB;;;;EC+CtB,UAAA,GAAa,iBAAA;AAAA;AAAA,UAGE,kBAAA,SAA2B,iBAAA;EAC1C,GAAA,EAAK,UAAA;EACL,GAAA,EAAK,uBAAA;AAAA;;;;ADpCP;;;;;;;;;;;;;;;;AAQA;cCmDa,WAAA;;;;UAIH,UAAA;EAAA,QAEA,OAAA;EAAA,QACA,cAAA;EAAA,QACA,gBAAA;EAAA,QACA,WAAA;EAAA,QACA,MAAA;EAAA,QACA,WAAA;EAAA,SAEC,GAAA,EAAK,UAAA;EAAA,iBACG,SAAA;;IAEH,GAAA;IAAK,GAAA;IAAA,GAAQ;EAAA,GAAU,kBAAA;;;;MA+BjC,SAAA,CAAA,GAAa,SAAA;EDpFjB;;;EAAA,IC2FI,IAAA,CAAA,GAAQ,OAAA;EAIN,UAAA,CAAA,GAAc,OAAA;EDvFL;;;ECmIf,OAAA,GAAA,CAAW,KAAA,WAAgB,CAAA;EDlI3B;;;EC+IM,WAAA,CAAY,KAAA,EAAO,YAAA,EAAc,SAAA,WAAoB,OAAA;ED3I3D;;;EC+JM,eAAA,CAAgB,UAAA,EAAY,mBAAA,GAAsB,OAAA;EDxJzC;;;ECyKf,uBAAA,CAAwB,MAAA,YAAgB,aAAA;EAQlC,QAAA,CAAA,GAAY,OAAA;ED/KlB;;;EC8LM,aAAA,CAAc,IAAA,UAAc,KAAA,GAAQ,YAAA,GAAe,OAAA,CAAQ,aAAA;EAAA,QAOzD,gBAAA;EAAA,QA0BA,eAAA;EAAA,QASA,sBAAA;EAAA,QAOA,gBAAA;;AAxQV;;UAkRU,sBAAA;EAhRA;;;EAAA,QAqSA,qBAAA;EA3RsB;;;EAAA,QA+StB,oBAAA;AAAA"}

package/dist/{base-email.provider-CNwsPbwm.mjs → base-email.provider-DypUAfWm.mjs}

@@ -39,4 +39,4 @@ var BaseEmailProvider = class {
 //#endregion
 export { BaseEmailProvider as t };
 
-//# sourceMappingURL=base-email.provider-CNwsPbwm.mjs.map
+//# sourceMappingURL=base-email.provider-DypUAfWm.mjs.map

package/dist/{base-email.provider-CNwsPbwm.mjs.map → base-email.provider-DypUAfWm.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"base-email.provider-CNwsPbwm.mjs","names":[],"sources":["../src/email/providers/base-email.provider.ts"],"sourcesContent":["import type { ResolvedEmailMessage } from '../contracts'\nimport type { EmailBatchSendResult, EmailSendResult, IEmailProvider } from './email-provider.interface'\n\n/**\n * Base Email Provider\n *\n * Abstract base class for email providers.\n * Provides shared implementation of sendBatch() to reduce code duplication.\n */\nexport abstract class BaseEmailProvider implements IEmailProvider {\n  /**\n   * Send a single email - must be implemented by concrete providers\n   */\n  abstract send(message: ResolvedEmailMessage): Promise<EmailSendResult>\n\n  /**\n   * Send multiple emails in a batch\n   *\n   * Default implementation sends emails sequentially.\n   * Concrete providers can override for optimized batch sending.\n   */\n  async sendBatch(messages: ResolvedEmailMessage[]): Promise<EmailBatchSendResult> {\n    const results: EmailSendResult[] = []\n    let successful = 0\n    let failed = 0\n\n    for (const message of messages) {\n      try {\n        const result = await this.send(message)\n        results.push(result)\n        successful++\n      }\n      catch (error) {\n        results.push({\n          messageId: '',\n          accepted: false,\n          metadata: {\n            error: error instanceof Error ? error.message : 'Unknown error',\n          },\n        })\n        failed++\n      }\n    }\n\n    return {\n      total: messages.length,\n      successful,\n      failed,\n      results,\n    }\n  }\n}\n"],"mappings":";;;;;;;AASA,IAAsB,oBAAtB,MAAkE;;;;;;;CAYhE,MAAM,UAAU,UAAiE;EAC/E,MAAM,UAA6B,EAAE;EACrC,IAAI,aAAa;EACjB,IAAI,SAAS;AAEb,OAAK,MAAM,WAAW,SACpB,KAAI;GACF,MAAM,SAAS,MAAM,KAAK,KAAK,QAAQ;AACvC,WAAQ,KAAK,OAAO;AACpB;WAEK,OAAO;AACZ,WAAQ,KAAK;IACX,WAAW;IACX,UAAU;IACV,UAAU,EACR,OAAO,iBAAiB,QAAQ,MAAM,UAAU,iBACjD;IACF,CAAC;AACF;;AAIJ,SAAO;GACL,OAAO,SAAS;GAChB;GACA;GACA;GACD"}
+{"version":3,"file":"base-email.provider-DypUAfWm.mjs","names":[],"sources":["../src/email/providers/base-email.provider.ts"],"sourcesContent":["import type { ResolvedEmailMessage } from '../contracts'\nimport type { EmailBatchSendResult, EmailSendResult, IEmailProvider } from './email-provider.interface'\n\n/**\n * Base Email Provider\n *\n * Abstract base class for email providers.\n * Provides shared implementation of sendBatch() to reduce code duplication.\n */\nexport abstract class BaseEmailProvider implements IEmailProvider {\n  /**\n   * Send a single email - must be implemented by concrete providers\n   */\n  abstract send(message: ResolvedEmailMessage): Promise<EmailSendResult>\n\n  /**\n   * Send multiple emails in a batch\n   *\n   * Default implementation sends emails sequentially.\n   * Concrete providers can override for optimized batch sending.\n   */\n  async sendBatch(messages: ResolvedEmailMessage[]): Promise<EmailBatchSendResult> {\n    const results: EmailSendResult[] = []\n    let successful = 0\n    let failed = 0\n\n    for (const message of messages) {\n      try {\n        const result = await this.send(message)\n        results.push(result)\n        successful++\n      }\n      catch (error) {\n        results.push({\n          messageId: '',\n          accepted: false,\n          metadata: {\n            error: error instanceof Error ? error.message : 'Unknown error',\n          },\n        })\n        failed++\n      }\n    }\n\n    return {\n      total: messages.length,\n      successful,\n      failed,\n      results,\n    }\n  }\n}\n"],"mappings":";;;;;;;AASA,IAAsB,oBAAtB,MAAkE;;;;;;;CAYhE,MAAM,UAAU,UAAiE;EAC/E,MAAM,UAA6B,EAAE;EACrC,IAAI,aAAa;EACjB,IAAI,SAAS;AAEb,OAAK,MAAM,WAAW,SACpB,KAAI;GACF,MAAM,SAAS,MAAM,KAAK,KAAK,QAAQ;AACvC,WAAQ,KAAK,OAAO;AACpB;WAEK,OAAO;AACZ,WAAQ,KAAK;IACX,WAAW;IACX,UAAU;IACV,UAAU,EACR,OAAO,iBAAiB,QAAQ,MAAM,UAAU,iBACjD;IACF,CAAC;AACF;;AAIJ,SAAO;GACL,OAAO,SAAS;GAChB;GACA;GACA;GACD"}

package/dist/bin/quarry.mjs

@@ -6,6 +6,7 @@ import { dirname, join, resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { Command, Option } from "clipanion";
 //#region src/bin/commands/dynamic-command.ts
+/** Create Clipanion command classes from Quarry-registered commands. */
 function createDynamicCommands(quarry, parseSignature, app) {
 	const commands = [];
 	for (const entry of quarry.list()) {
@@ -13,6 +14,7 @@ function createDynamicCommands(quarry, parseSignature, app) {
 		const signature = parseSignature(commandClass.command);
 		const paths = [entry.name.split(" ")];
 		if (commandClass.aliases) for (const alias of commandClass.aliases) paths.push(alias.split(" "));
+		if (entry.name === "help") paths.push([]);
 		class DynCmd extends Command {
 			static paths = paths;
 			static usage = commandClass.description ? Command.Usage({ description: commandClass.description }) : void 0;
@@ -43,65 +45,21 @@ function createDynamicCommands(quarry, parseSignature, app) {
 		});
 		for (const opt of signature.options) {
 			const optName = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`;
-			if (opt.isFlag) proto[opt.name] = Option.Boolean(optName, { description: opt.description });
-			else if (opt.isArray) proto[opt.name] = Option.Array(optName, { description: opt.description });
-			else proto[opt.name] = Option.String(optName, { description: opt.description });
+			const optDescParts = [];
+			if (opt.description) optDescParts.push(opt.description);
+			if (opt.default !== void 0) optDescParts.push(`(default: ${opt.default})`);
+			const optDesc = optDescParts.length > 0 ? optDescParts.join(" ") : void 0;
+			if (opt.isFlag) proto[opt.name] = Option.Boolean(optName, { description: optDesc });
+			else if (opt.isArray) if (opt.default !== void 0) proto[opt.name] = Option.Array(optName, [opt.default], { description: optDesc });
+			else proto[opt.name] = Option.Array(optName, { description: optDesc });
+			else if (opt.default !== void 0) proto[opt.name] = Option.String(optName, opt.default, { description: optDesc });
+			else proto[opt.name] = Option.String(optName, { description: optDesc });
 		}
 		commands.push(DynCmd);
 	}
 	return commands;
 }
 //#endregion
-//#region src/bin/commands/help-command.ts
-function createHelpCommand() {
-	class HelpCommand extends Command {
-		static paths = [["help"]];
-		static usage = Command.Usage({ description: "Show help for a command" });
-		commandPath = Option.Rest();
-		execute() {
-			const commandName = this.commandPath.join(" ");
-			if (this.help || !commandName) {
-				this.context.stdout.write(this.cli.usage());
-				return Promise.resolve(0);
-			}
-			try {
-				const command = this.cli.process(this.commandPath);
-				this.context.stdout.write(this.cli.usage(command, { detailed: true }));
-				return Promise.resolve(0);
-			} catch {
-				this.context.stderr.write(`Unknown command: ${commandName}\n`);
-				return Promise.resolve(1);
-			}
-		}
-	}
-	return HelpCommand;
-}
-//#endregion
-//#region src/bin/commands/list-command.ts
-function createListCommand(quarry) {
-	class ListCommand extends Command {
-		static paths = [["list"]];
-		static usage = Command.Usage({ description: "List all registered commands" });
-		execute() {
-			const commands = quarry.list();
-			if (commands.length === 0) {
-				this.context.stdout.write("No registered commands.\n");
-				return Promise.resolve(0);
-			}
-			this.context.stdout.write("\nRegistered commands:\n\n");
-			const maxName = Math.max(...commands.map((c) => c.name.length));
-			for (const cmd of commands) {
-				const aliasStr = cmd.aliases.length > 0 ? ` (${cmd.aliases.join(", ")})` : "";
-				const desc = cmd.description ?? "";
-				this.context.stdout.write(`  ${cmd.name.padEnd(maxName + 4)}${desc}${aliasStr}\n`);
-			}
-			this.context.stdout.write("\n");
-			return Promise.resolve(0);
-		}
-	}
-	return ListCommand;
-}
-//#endregion
 //#region src/bin/quarry.ts
 const require = createRequire(import.meta.url);
 register(pathToFileURL(join(dirname(require.resolve("@swc-node/register")), "esm/esm.mjs")), pathToFileURL("./"));
@@ -138,15 +96,12 @@ async function main() {
 		]);
 		app = await Stratal.resolveApplication();
 		const quarry = app.container.resolve(DI_TOKENS.Quarry);
-		const { Builtins, Cli } = await import("clipanion");
+		const { Cli } = await import("clipanion");
 		const cli = new Cli({
 			binaryName: "quarry",
 			binaryLabel: "Quarry CLI",
 			binaryVersion: require("../../package.json").version
 		});
-		cli.register(Builtins.HelpCommand);
-		cli.register(createListCommand(quarry));
-		cli.register(createHelpCommand());
 		for (const cmd of createDynamicCommands(quarry, parseSignature, app)) cli.register(cmd);
 		await cli.runExit(process.argv.slice(2), { ...Cli.defaultContext });
 	} finally {

package/dist/bin/quarry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"quarry.mjs","names":[],"sources":["../../src/bin/commands/dynamic-command.ts","../../src/bin/commands/help-command.ts","../../src/bin/commands/list-command.ts","../../src/bin/quarry.ts"],"sourcesContent":["import { Command, type CommandClass, Option, type Usage } from 'clipanion'\n\nimport type { Application } from 'stratal'\nimport type { QuarryRegistry } from 'stratal/quarry'\nimport type { ParsedSignature } from 'stratal/quarry'\n\nexport function createDynamicCommands(\n  quarry: QuarryRegistry,\n  parseSignature: (command: string) => ParsedSignature,\n  app: Application,\n) {\n  const commands: CommandClass[] = []\n\n  for (const entry of quarry.list()) {\n    const commandClass = quarry.get(entry.name)! as unknown as { command: string; description?: string; aliases?: string[] }\n    const signature = parseSignature(commandClass.command)\n\n    const paths: string[][] = [entry.name.split(' ')]\n    if (commandClass.aliases) {\n      for (const alias of commandClass.aliases) {\n        paths.push(alias.split(' '))\n      }\n    }\n\n    class DynCmd extends Command {\n      static override paths = paths\n      static override usage: Usage | undefined = commandClass.description\n        ? Command.Usage({ description: commandClass.description })\n        : undefined\n\n      async execute(): Promise<number> {\n        const input: Record<string, unknown> = {}\n\n        for (const arg of signature.arguments) {\n          const value = (this as Record<string, unknown>)[arg.name]\n          if (value !== undefined) input[arg.name] = value\n        }\n\n        for (const opt of signature.options) {\n          const value = (this as Record<string, unknown>)[opt.name]\n          if (value !== undefined) input[opt.name] = value\n        }\n\n        const result = await app.handleCommand(entry.name, input)\n\n        for (const line of result.output) {\n          this.context.stdout.write(line + '\\n')\n        }\n\n        for (const err of result.errors) {\n          this.context.stderr.write(err + '\\n')\n        }\n\n        return result.exitCode\n      }\n    }\n\n    // Define Clipanion options/arguments as class property defaults\n    const proto = DynCmd.prototype as unknown as Record<string, unknown>\n    for (const arg of signature.arguments) {\n      if (arg.isArray) {\n        proto[arg.name] = Option.Rest({ name: arg.name, required: arg.required ? 1 : 0 })\n      } else {\n        proto[arg.name] = Option.String({ name: arg.name, required: arg.required })\n      }\n    }\n\n    for (const opt of signature.options) {\n      const optName = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`\n\n      if (opt.isFlag) {\n        proto[opt.name] = Option.Boolean(optName, { description: opt.description })\n      } else if (opt.isArray) {\n        proto[opt.name] = Option.Array(optName, { description: opt.description })\n      } else {\n        proto[opt.name] = Option.String(optName, { description: opt.description })\n      }\n    }\n\n    commands.push(DynCmd)\n  }\n\n  return commands\n}\n","import { Command, Option, type Usage } from 'clipanion'\n\nexport function createHelpCommand() {\n  class HelpCommand extends Command {\n    static override paths = [['help']]\n    static override usage: Usage = Command.Usage({ description: 'Show help for a command' })\n\n    commandPath = Option.Rest()\n\n    execute(): Promise<number> {\n      const commandName = this.commandPath.join(' ')\n\n      if (this.help || !commandName) {\n        this.context.stdout.write(this.cli.usage())\n        return Promise.resolve(0)\n      }\n\n      try {\n        const command = this.cli.process(this.commandPath)\n        this.context.stdout.write(this.cli.usage(command, { detailed: true }))\n        return Promise.resolve(0)\n      } catch {\n        this.context.stderr.write(`Unknown command: ${commandName}\\n`)\n        return Promise.resolve(1)\n      }\n    }\n  }\n\n  return HelpCommand\n}\n","import { Command, type Usage } from 'clipanion'\n\nimport type { QuarryRegistry } from 'stratal/quarry'\n\nexport function createListCommand(quarry: QuarryRegistry) {\n  class ListCommand extends Command {\n    static override paths = [['list']]\n    static override usage: Usage = Command.Usage({ description: 'List all registered commands' })\n\n    execute(): Promise<number> {\n      const commands = quarry.list()\n\n      if (commands.length === 0) {\n        this.context.stdout.write('No registered commands.\\n')\n        return Promise.resolve(0)\n      }\n\n      this.context.stdout.write('\\nRegistered commands:\\n\\n')\n\n      const maxName = Math.max(...commands.map((c) => c.name.length))\n      for (const cmd of commands) {\n        const aliasStr = cmd.aliases.length > 0 ? ` (${cmd.aliases.join(', ')})` : ''\n        const desc = cmd.description ?? ''\n        this.context.stdout.write(`  ${cmd.name.padEnd(maxName + 4)}${desc}${aliasStr}\\n`)\n      }\n\n      this.context.stdout.write('\\n')\n      return Promise.resolve(0)\n    }\n  }\n\n  return ListCommand\n}\n","import 'reflect-metadata'\n\nimport { existsSync } from 'node:fs'\nimport { createRequire, register } from 'node:module'\nimport { dirname, join, resolve } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport type { QuarryRegistry } from 'stratal/quarry'\n\nimport { type Application } from '../application'\nimport { createDynamicCommands } from './commands/dynamic-command'\nimport { createHelpCommand } from './commands/help-command'\nimport { createListCommand } from './commands/list-command'\n\nconst require = createRequire(import.meta.url)\n\n// Register @swc-node/register for TypeScript + decorator support\nconst swcRegisterPath = join(dirname(require.resolve('@swc-node/register')), 'esm/esm.mjs')\nregister(pathToFileURL(swcRegisterPath), pathToFileURL('./'))\n\n// Register cloudflare:workers virtual module loader\nregister(new URL('./cloudflare-workers-loader.mjs', import.meta.url), pathToFileURL('./'))\n\nconst DEFAULT_ENTRY = './src/index.ts'\n\n// Determine entry file: if first arg looks like a file path, use it; otherwise use default\nconst firstArg = process.argv[2]\nlet entryFile = DEFAULT_ENTRY\n\nif (firstArg && (firstArg.includes('/') || firstArg.includes('\\\\') || /\\.(ts|js|mts|mjs)$/.test(firstArg))) {\n  entryFile = firstArg\n  // Remove the entry file from argv so Clipanion sees: [node, script, command, ...options]\n  process.argv.splice(2, 1)\n}\n\n// Resolve and validate the entry file\nconst entryPath = resolve(process.cwd(), entryFile)\n\nif (!existsSync(entryPath)) {\n  console.error(`Error: Entry file not found: ${entryFile}`)\n  console.error('')\n  console.error('Create src/index.ts with a default Stratal export, or specify a custom path:')\n  console.error('  npx quarry ./path/to/entry.ts <command> [options]')\n  process.exit(1)\n}\n\nasync function main(): Promise<void> {\n  const cwdRequire = createRequire(join(process.cwd(), 'package.json'))\n  // eslint-disable-next-line @typescript-eslint/consistent-type-imports\n  const { getPlatformProxy } = await import(cwdRequire.resolve('wrangler')) as typeof import('wrangler')\n  const { env, ctx, dispose } = await getPlatformProxy()\n\n  let app: Application | undefined\n  try {\n    // Store platform proxy on globalThis so the cloudflare:workers virtual module can read it\n    (globalThis as Record<string, unknown>).__stratalPlatformProxy = {\n      env,\n      waitUntil: ctx.waitUntil.bind(ctx),\n    }\n\n    // Import user's entry file — triggers `new Stratal(...)` + full Application init\n    await import(pathToFileURL(entryPath).href)\n\n    // Parallel import of stratal modules\n    const [\n      { Stratal },\n      { DI_TOKENS },\n      { parseSignature },\n    ] = await Promise.all([\n      import('stratal'),\n      import('stratal/di'),\n      import('stratal/quarry'),\n    ])\n\n    app = await Stratal.resolveApplication()\n    const quarry = app.container.resolve<QuarryRegistry>(DI_TOKENS.Quarry)\n\n    // Build Clipanion CLI\n    const { Builtins, Cli } = await import('clipanion')\n    const pkg = require('../../package.json') as { version: string }\n\n    const cli = new Cli({\n      binaryName: 'quarry',\n      binaryLabel: 'Quarry CLI',\n      binaryVersion: pkg.version,\n    })\n\n    cli.register(Builtins.HelpCommand)\n    cli.register(createListCommand(quarry))\n    cli.register(createHelpCommand())\n\n    for (const cmd of createDynamicCommands(quarry, parseSignature, app)) {\n      cli.register(cmd)\n    }\n\n    await cli.runExit(process.argv.slice(2), { ...Cli.defaultContext })\n  } finally {\n    await app?.shutdown()\n    await dispose()\n  }\n}\n\nmain().catch((error: unknown) => {\n  console.error('Fatal error:', error instanceof Error ? error.message : String(error))\n  process.exit(1)\n})\n"],"mappings":"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"}
+{"version":3,"file":"quarry.mjs","names":[],"sources":["../../src/bin/commands/dynamic-command.ts","../../src/bin/quarry.ts"],"sourcesContent":["import { Command, type CommandClass, Option, type Usage } from 'clipanion'\n\nimport type { Application } from 'stratal'\nimport type { ParsedSignature, QuarryRegistry } from 'stratal/quarry'\n\n/** Create Clipanion command classes from Quarry-registered commands. */\nexport function createDynamicCommands(\n  quarry: QuarryRegistry,\n  parseSignature: (command: string) => ParsedSignature,\n  app: Application,\n) {\n  const commands: CommandClass[] = []\n\n  for (const entry of quarry.list()) {\n    const commandClass = quarry.get(entry.name)! as unknown as { command: string; description?: string; aliases?: string[] }\n    const signature = parseSignature(commandClass.command)\n\n    const paths: string[][] = [entry.name.split(' ')]\n    if (commandClass.aliases) {\n      for (const alias of commandClass.aliases) {\n        paths.push(alias.split(' '))\n      }\n    }\n\n    // Allow bare `npx quarry` (no arguments) to invoke the help command\n    if (entry.name === 'help') {\n      paths.push([])\n    }\n\n    class DynCmd extends Command {\n      static override paths = paths\n      static override usage: Usage | undefined = commandClass.description\n        ? Command.Usage({ description: commandClass.description })\n        : undefined\n\n      async execute(): Promise<number> {\n        const input: Record<string, unknown> = {}\n\n        for (const arg of signature.arguments) {\n          const value = (this as Record<string, unknown>)[arg.name]\n          if (value !== undefined) input[arg.name] = value\n        }\n\n        for (const opt of signature.options) {\n          const value = (this as Record<string, unknown>)[opt.name]\n          if (value !== undefined) input[opt.name] = value\n        }\n\n        const result = await app.handleCommand(entry.name, input)\n\n        for (const line of result.output) {\n          this.context.stdout.write(line + '\\n')\n        }\n\n        for (const err of result.errors) {\n          this.context.stderr.write(err + '\\n')\n        }\n\n        return result.exitCode\n      }\n    }\n\n    // Define Clipanion options/arguments as class property defaults\n    const proto = DynCmd.prototype as unknown as Record<string, unknown>\n    for (const arg of signature.arguments) {\n      if (arg.isArray) {\n        proto[arg.name] = Option.Rest({ name: arg.name, required: arg.required ? 1 : 0 })\n      } else {\n        proto[arg.name] = Option.String({ name: arg.name, required: arg.required })\n      }\n    }\n\n    for (const opt of signature.options) {\n      const optName = opt.alias ? `-${opt.alias},--${opt.name}` : `--${opt.name}`\n      const optDescParts: string[] = []\n      if (opt.description) optDescParts.push(opt.description)\n      if (opt.default !== undefined) optDescParts.push(`(default: ${opt.default})`)\n      const optDesc = optDescParts.length > 0 ? optDescParts.join(' ') : undefined\n\n      if (opt.isFlag) {\n        proto[opt.name] = Option.Boolean(optName, { description: optDesc })\n      } else if (opt.isArray) {\n        if (opt.default !== undefined) {\n          proto[opt.name] = Option.Array(optName, [opt.default], { description: optDesc })\n        } else {\n          proto[opt.name] = Option.Array(optName, { description: optDesc })\n        }\n      } else {\n        if (opt.default !== undefined) {\n          proto[opt.name] = Option.String(optName, opt.default, { description: optDesc })\n        } else {\n          proto[opt.name] = Option.String(optName, { description: optDesc })\n        }\n      }\n    }\n\n    commands.push(DynCmd)\n  }\n\n  return commands\n}\n","import 'reflect-metadata'\n\nimport { existsSync } from 'node:fs'\nimport { createRequire, register } from 'node:module'\nimport { dirname, join, resolve } from 'node:path'\nimport { pathToFileURL } from 'node:url'\nimport type { QuarryRegistry } from 'stratal/quarry'\n\nimport { type Application } from '../application'\nimport { createDynamicCommands } from './commands/dynamic-command'\n\nconst require = createRequire(import.meta.url)\n\n// Register @swc-node/register for TypeScript + decorator support\nconst swcRegisterPath = join(dirname(require.resolve('@swc-node/register')), 'esm/esm.mjs')\nregister(pathToFileURL(swcRegisterPath), pathToFileURL('./'))\n\n// Register cloudflare:workers virtual module loader\nregister(new URL('./cloudflare-workers-loader.mjs', import.meta.url), pathToFileURL('./'))\n\nconst DEFAULT_ENTRY = './src/index.ts'\n\n// Determine entry file: if first arg looks like a file path, use it; otherwise use default\nconst firstArg = process.argv[2]\nlet entryFile = DEFAULT_ENTRY\n\nif (firstArg && (firstArg.includes('/') || firstArg.includes('\\\\') || /\\.(ts|js|mts|mjs)$/.test(firstArg))) {\n  entryFile = firstArg\n  // Remove the entry file from argv so Clipanion sees: [node, script, command, ...options]\n  process.argv.splice(2, 1)\n}\n\n// Resolve and validate the entry file\nconst entryPath = resolve(process.cwd(), entryFile)\n\nif (!existsSync(entryPath)) {\n  console.error(`Error: Entry file not found: ${entryFile}`)\n  console.error('')\n  console.error('Create src/index.ts with a default Stratal export, or specify a custom path:')\n  console.error('  npx quarry ./path/to/entry.ts <command> [options]')\n  process.exit(1)\n}\n\nasync function main(): Promise<void> {\n  const cwdRequire = createRequire(join(process.cwd(), 'package.json'))\n  // eslint-disable-next-line @typescript-eslint/consistent-type-imports\n  const { getPlatformProxy } = await import(cwdRequire.resolve('wrangler')) as typeof import('wrangler')\n  const { env, ctx, dispose } = await getPlatformProxy()\n\n  let app: Application | undefined\n  try {\n    // Store platform proxy on globalThis so the cloudflare:workers virtual module can read it\n    (globalThis as Record<string, unknown>).__stratalPlatformProxy = {\n      env,\n      waitUntil: ctx.waitUntil.bind(ctx),\n    }\n\n    // Import user's entry file — triggers `new Stratal(...)` + full Application init\n    await import(pathToFileURL(entryPath).href)\n\n    // Parallel import of stratal modules\n    const [\n      { Stratal },\n      { DI_TOKENS },\n      { parseSignature },\n    ] = await Promise.all([\n      import('stratal'),\n      import('stratal/di'),\n      import('stratal/quarry'),\n    ])\n\n    app = await Stratal.resolveApplication()\n    const quarry = app.container.resolve<QuarryRegistry>(DI_TOKENS.Quarry)\n\n    // Build Clipanion CLI\n    const { Cli } = await import('clipanion')\n    const pkg = require('../../package.json') as { version: string }\n\n    const cli = new Cli({\n      binaryName: 'quarry',\n      binaryLabel: 'Quarry CLI',\n      binaryVersion: pkg.version,\n    })\n\n    for (const cmd of createDynamicCommands(quarry, parseSignature, app)) {\n      cli.register(cmd)\n    }\n\n    await cli.runExit(process.argv.slice(2), { ...Cli.defaultContext })\n  } finally {\n    await app?.shutdown()\n    await dispose()\n  }\n}\n\nmain().catch((error: unknown) => {\n  console.error('Fatal error:', error instanceof Error ? error.message : String(error))\n  process.exit(1)\n})\n"],"mappings":"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"}

package/dist/cache/index.d.mts

@@ -1,5 +1,5 @@
-import { Ht as StratalEnv, s as ApplicationError } from "../index-D69rxo8H.mjs";
-import { i as LoggerService } from "../index-Cfkie8JM.mjs";
+import { Ut as StratalEnv, s as ApplicationError } from "../index-BFCxSp_f.mjs";
+import { i as LoggerService } from "../index-Dp6A5ywM.mjs";
 
 //#region src/cache/cache.module.d.ts
 /**

package/dist/cache/index.mjs

@@ -1,13 +1,13 @@
-import { S as ApplicationError, b as ERROR_CODES } from "../errors-CtCi1wn6.mjs";
-import { i as Transient, l as DI_TOKENS, n as __decorateParam, r as __decorateMetadata, t as __decorate } from "../decorate-D5j-d9_z.mjs";
-import { s as LOGGER_TOKENS } from "../logger-BR1-s1Um.mjs";
-import { r as Module } from "../module-BH7t7BGG.mjs";
-import "../events-CXl-o1Ad.mjs";
-import "../command-DG_u5ob2.mjs";
-import "../is-command-MZDCH-0T.mjs";
-import "../is-seeder-BN9Ej1r7.mjs";
-import "../middleware-iRhNjsPH.mjs";
-import "../router-context-BLn4PrRG.mjs";
+import { S as ApplicationError, b as ERROR_CODES } from "../errors-DSKapqD8.mjs";
+import { a as __decorate, d as Transient, g as DI_TOKENS, o as __decorateParam, s as __decorateMetadata, u as LOGGER_TOKENS } from "../logger-CGT91VY6.mjs";
+import { r as Module } from "../module-tUtyVJ5E.mjs";
+import "../events-CvUSgEuN.mjs";
+import "../middleware-Bl-b5pkt.mjs";
+import "../router-context-D9R1v2Ac.mjs";
+import "../colors-Y7WIFXs7.mjs";
+import "../command-B1CPgsrU.mjs";
+import "../is-command-DJVI6wEJ.mjs";
+import "../is-seeder-D5MIEcdz.mjs";
 import { inject } from "tsyringe";
 //#region src/cache/cache.tokens.ts
 const CACHE_TOKENS = { CacheService: Symbol.for("stratal:cache:service") };

package/dist/colors-Y7WIFXs7.mjs

@@ -0,0 +1,16 @@
+//#region src/quarry/colors.ts
+/** Minimal ANSI color helpers that respect the `NO_COLOR` convention. */
+const isEnabled = () => typeof process !== "undefined" ? !process.env.NO_COLOR : true;
+/** Create an ANSI formatter that wraps text with the given open/close SGR codes. */
+const code = (open, close) => (s) => isEnabled() ? `\x1b[${open}m${s}\x1b[${close}m` : s;
+const bold = code(1, 22);
+const dim = code(2, 22);
+const cyan = code(36, 39);
+const green = code(32, 39);
+const red = code(31, 39);
+const yellow = code(33, 39);
+const dimWhite = (s) => isEnabled() ? `\x1b[2;37m${s}\x1b[22;39m` : s;
+//#endregion
+export { green as a, dimWhite as i, cyan as n, red as o, dim as r, yellow as s, bold as t };
+
+//# sourceMappingURL=colors-Y7WIFXs7.mjs.map

package/dist/colors-Y7WIFXs7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors-Y7WIFXs7.mjs","names":[],"sources":["../src/quarry/colors.ts"],"sourcesContent":["/** Minimal ANSI color helpers that respect the `NO_COLOR` convention. */\nconst isEnabled = () => typeof process !== 'undefined' ? !process.env.NO_COLOR : true\n\n/** Create an ANSI formatter that wraps text with the given open/close SGR codes. */\nconst code = (open: number, close: number) => (s: string) =>\n  isEnabled() ? `\\x1b[${open}m${s}\\x1b[${close}m` : s\n\nexport const bold = code(1, 22)\nexport const dim = code(2, 22)\nexport const cyan = code(36, 39)\nexport const green = code(32, 39)\nexport const red = code(31, 39)\nexport const yellow = code(33, 39)\nexport const dimWhite = (s: string) =>\n  isEnabled() ? `\\x1b[2;37m${s}\\x1b[22;39m` : s\n"],"mappings":";;AACA,MAAM,kBAAkB,OAAO,YAAY,cAAc,CAAC,QAAQ,IAAI,WAAW;;AAGjF,MAAM,QAAQ,MAAc,WAAmB,MAC7C,WAAW,GAAG,QAAQ,KAAK,GAAG,EAAE,OAAO,MAAM,KAAK;AAEpD,MAAa,OAAO,KAAK,GAAG,GAAG;AAC/B,MAAa,MAAM,KAAK,GAAG,GAAG;AAC9B,MAAa,OAAO,KAAK,IAAI,GAAG;AAChC,MAAa,QAAQ,KAAK,IAAI,GAAG;AACjC,MAAa,MAAM,KAAK,IAAI,GAAG;AAC/B,MAAa,SAAS,KAAK,IAAI,GAAG;AAClC,MAAa,YAAY,MACvB,WAAW,GAAG,aAAa,EAAE,eAAe"}

package/dist/{command-DG_u5ob2.mjs → command-B1CPgsrU.mjs}

@@ -1,3 +1,4 @@
+import { a as green, n as cyan, o as red, r as dim, s as yellow, t as bold } from "./colors-Y7WIFXs7.mjs";
 import "reflect-metadata";
 //#region src/quarry/constants.ts
 /**
@@ -134,19 +135,19 @@ var Command = class {
 	}
 	/** Write an informational message to output */
 	info(message) {
-		this[COMMAND_INTERNALS].output.push(message);
+		this[COMMAND_INTERNALS].output.push(cyan(message));
 	}
 	/** Write a success message to output */
 	success(message) {
-		this[COMMAND_INTERNALS].output.push(message);
+		this[COMMAND_INTERNALS].output.push(`${green(bold("✔"))} ${green(message)}`);
 	}
 	/** Write a warning message to output */
 	warn(message) {
-		this[COMMAND_INTERNALS].output.push(`Warning: ${message}`);
+		this[COMMAND_INTERNALS].output.push(`${yellow(bold("⚠"))} ${yellow(message)}`);
 	}
 	/** Write an error message to errors */
 	error(message) {
-		this[COMMAND_INTERNALS].errors.push(message);
+		this[COMMAND_INTERNALS].errors.push(red(message));
 	}
 	/** Write a plain line to output */
 	line(message) {
@@ -158,7 +159,7 @@ var Command = class {
 	}
 	/** Write a comment-style line to output */
 	comment(message) {
-		this[COMMAND_INTERNALS].output.push(`// ${message}`);
+		this[COMMAND_INTERNALS].output.push(dim(`// ${message}`));
 	}
 	/** Write a formatted table to output */
 	table(headers, rows) {
@@ -167,13 +168,13 @@ var Command = class {
 			return Math.max(h.length, maxRow);
 		});
 		const formatRow = (cells) => cells.map((cell, i) => cell.padEnd(colWidths[i])).join("  ");
-		this[COMMAND_INTERNALS].output.push(formatRow(headers));
-		this[COMMAND_INTERNALS].output.push(colWidths.map((w) => "-".repeat(w)).join("  "));
+		this[COMMAND_INTERNALS].output.push(bold(formatRow(headers)));
+		this[COMMAND_INTERNALS].output.push(dim(colWidths.map((w) => "-".repeat(w)).join("  ")));
 		for (const row of rows) this[COMMAND_INTERNALS].output.push(formatRow(row));
 	}
 	/** Write an error message and set exit code */
 	fail(message, exitCode = 1) {
-		this[COMMAND_INTERNALS].errors.push(message);
+		this[COMMAND_INTERNALS].errors.push(`${red(bold("✖"))} ${red(message)}`);
 		this[COMMAND_INTERNALS].exitCode = exitCode;
 	}
 	/**
@@ -183,10 +184,13 @@ var Command = class {
 	async call(name, input) {
 		const internals = this[COMMAND_INTERNALS];
 		if (!internals.quarry) throw new CommandError("Cannot call commands: Quarry reference not set");
-		return internals.quarry.call(name, input);
+		const result = await internals.quarry.call(name, input);
+		internals.output.push(...result.output);
+		internals.errors.push(...result.errors);
+		return result;
 	}
 };
 //#endregion
 export { CommandError as n, COMMAND_INTERNALS as r, Command as t };
 
-//# sourceMappingURL=command-DG_u5ob2.mjs.map
+//# sourceMappingURL=command-B1CPgsrU.mjs.map

package/dist/{command-DG_u5ob2.mjs.map → command-B1CPgsrU.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"command-DG_u5ob2.mjs","names":[],"sources":["../src/quarry/constants.ts","../src/quarry/errors/command.error.ts","../src/quarry/command.ts"],"sourcesContent":["/**\n * Symbol key for storing internal mutable state on Command instances.\n * Keeps internal state hidden from user-facing autocomplete.\n */\nexport const COMMAND_INTERNALS = Symbol.for('stratal:command:internals')\n","/**\n * User-facing command error with a plain English message.\n *\n * Quarry catches this in `call()` and puts the message into `CommandResult.errors`.\n * Does NOT extend `ApplicationError` (which requires i18n keys + error codes).\n * Not routed through GlobalErrorHandler.\n */\nexport class CommandError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'CommandError'\n  }\n}\n","import 'reflect-metadata'\n\nimport { COMMAND_INTERNALS } from './constants'\nimport { CommandError } from './errors/command.error'\nimport type { CommandInput, CommandInternals, CommandResult } from './types'\n\n/**\n * Abstract base class for Quarry commands.\n *\n * Subclasses define a static `command` signature string and implement `handle()`.\n *\n * @example\n * ```typescript\n * export class GreetCommand extends Command {\n *   static command = 'greet {name : The name to greet} {--loud}'\n *   static description = 'Greet someone'\n *\n *   async handle(): Promise<void> {\n *     const name = this.string('name')\n *     const loud = this.boolean('loud')\n *     this.info(loud ? `HELLO, ${name.toUpperCase()}!` : `Hello, ${name}!`)\n *   }\n * }\n * ```\n */\nexport abstract class Command {\n  /**\n   * Laravel-style command signature string.\n   *\n   * **Command names:**\n   * - `'greet'` — flat command (`quarry greet`)\n   * - `'task add'` — subcommand hierarchy via spaces (`quarry task add`)\n   * - `'task:add'` — namespaced flat command via colons (`quarry task:add`)\n   *\n   * **Arguments:**\n   * - `{name}` — required argument\n   * - `{name?}` — optional argument\n   * - `{name=default}` — argument with default value\n   * - `{name*}` — array/variadic argument\n   * - `{name : description}` — argument with description\n   *\n   * **Options:**\n   * - `{--flag}` — boolean flag\n   * - `{--name=}` — option that accepts a value\n   * - `{--name=default}` — option with default value\n   * - `{--name=*}` — array option (multiple values)\n   * - `{--A|name}` — option with single-char alias\n   * - `{--name= : description}` — option with description\n   *\n   * @example\n   * ```typescript\n   * // Namespaced flat command: `quarry users:create ...`\n   * static command = 'users:create {email : The user email} {--A|admin} {--R|role= : Assign a role}'\n   *\n   * // Subcommand hierarchy: `quarry users create ...`\n   * static command = 'users create {email : The user email} {--A|admin} {--R|role= : Assign a role}'\n   * ```\n   */\n  static command: string\n  /** Human-readable description */\n  static description?: string\n  /** Alternative command names */\n  static aliases?: string[];\n\n  [COMMAND_INTERNALS]: CommandInternals\n\n  constructor() {\n    this[COMMAND_INTERNALS] = {\n      inputs: {},\n      output: [],\n      errors: [],\n      exitCode: 0,\n      quarry: null,\n    }\n  }\n\n  /**\n   * Implement this method with the command's logic.\n   * Return a number to set the exit code, or void for exit code 0.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n  abstract handle(): number | void | Promise<number | void>\n\n  // ── Input Accessors ──────────────────────────────────────────────\n\n  /**\n   * Get an input value with generic type.\n   */\n  input<T>(name: string): T {\n    return this[COMMAND_INTERNALS].inputs[name] as T\n  }\n\n  /**\n   * Get a string input. Throws CommandError if present but not a string.\n   */\n  string(name: string): string {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return ''\n    }\n    if (typeof value !== 'string') {\n      throw new CommandError(`Input \"${name}\" expected a string, got ${typeof value}`)\n    }\n    return value\n  }\n\n  /**\n   * Get a boolean input. Throws CommandError if present but not a boolean.\n   */\n  boolean(name: string): boolean {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return false\n    }\n    if (typeof value !== 'boolean') {\n      throw new CommandError(`Input \"${name}\" expected a boolean, got ${typeof value}`)\n    }\n    return value\n  }\n\n  /**\n   * Get a number input. Coerces strings to numbers. Throws CommandError on NaN.\n   */\n  number(name: string): number {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return 0\n    }\n    const num = typeof value === 'string' ? Number(value) : value\n    if (typeof num !== 'number' || Number.isNaN(num)) {\n      throw new CommandError(`Input \"${name}\" expected a number, got ${typeof value}`)\n    }\n    return num\n  }\n\n  /**\n   * Get an array input. Throws CommandError if present but not an array.\n   */\n  array(name: string): string[] {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return []\n    }\n    if (!Array.isArray(value)) {\n      throw new CommandError(`Input \"${name}\" expected an array, got ${typeof value}`)\n    }\n    return value as string[]\n  }\n\n  // ── Output Helpers ───────────────────────────────────────────────\n\n  /** Write an informational message to output */\n  info(message: string): void {\n    this[COMMAND_INTERNALS].output.push(message)\n  }\n\n  /** Write a success message to output */\n  success(message: string): void {\n    this[COMMAND_INTERNALS].output.push(message)\n  }\n\n  /** Write a warning message to output */\n  warn(message: string): void {\n    this[COMMAND_INTERNALS].output.push(`Warning: ${message}`)\n  }\n\n  /** Write an error message to errors */\n  error(message: string): void {\n    this[COMMAND_INTERNALS].errors.push(message)\n  }\n\n  /** Write a plain line to output */\n  line(message?: string): void {\n    this[COMMAND_INTERNALS].output.push(message ?? '')\n  }\n\n  /** Write an empty line to output */\n  newLine(): void {\n    this[COMMAND_INTERNALS].output.push('')\n  }\n\n  /** Write a comment-style line to output */\n  comment(message: string): void {\n    this[COMMAND_INTERNALS].output.push(`// ${message}`)\n  }\n\n  /** Write a formatted table to output */\n  table(headers: string[], rows: string[][]): void {\n    const colWidths = headers.map((h, i) => {\n      const maxRow = rows.reduce((max, row) => Math.max(max, (row[i] ?? '').length), 0)\n      return Math.max(h.length, maxRow)\n    })\n\n    const formatRow = (cells: string[]) =>\n      cells.map((cell, i) => cell.padEnd(colWidths[i])).join('  ')\n\n    this[COMMAND_INTERNALS].output.push(formatRow(headers))\n    this[COMMAND_INTERNALS].output.push(colWidths.map((w) => '-'.repeat(w)).join('  '))\n    for (const row of rows) {\n      this[COMMAND_INTERNALS].output.push(formatRow(row))\n    }\n  }\n\n  /** Write an error message and set exit code */\n  fail(message: string, exitCode = 1): void {\n    this[COMMAND_INTERNALS].errors.push(message)\n    this[COMMAND_INTERNALS].exitCode = exitCode\n  }\n\n  // ── Command Calling ──────────────────────────────────────────────\n\n  /**\n   * Call another command from within this command.\n   * Delegates to Quarry.call() via internal reference.\n   */\n  async call(name: string, input?: CommandInput): Promise<CommandResult> {\n    const internals = this[COMMAND_INTERNALS]\n    if (!internals.quarry) {\n      throw new CommandError('Cannot call commands: Quarry reference not set')\n    }\n    return internals.quarry.call(name, input)\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"command-B1CPgsrU.mjs","names":[],"sources":["../src/quarry/constants.ts","../src/quarry/errors/command.error.ts","../src/quarry/command.ts"],"sourcesContent":["/**\n * Symbol key for storing internal mutable state on Command instances.\n * Keeps internal state hidden from user-facing autocomplete.\n */\nexport const COMMAND_INTERNALS = Symbol.for('stratal:command:internals')\n","/**\n * User-facing command error with a plain English message.\n *\n * Quarry catches this in `call()` and puts the message into `CommandResult.errors`.\n * Does NOT extend `ApplicationError` (which requires i18n keys + error codes).\n * Not routed through GlobalErrorHandler.\n */\nexport class CommandError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'CommandError'\n  }\n}\n","import 'reflect-metadata'\n\nimport { bold, cyan, dim, green, red, yellow } from './colors'\nimport { COMMAND_INTERNALS } from './constants'\nimport { CommandError } from './errors/command.error'\nimport type { CommandInput, CommandInternals, CommandResult } from './types'\n\n/**\n * Abstract base class for Quarry commands.\n *\n * Subclasses define a static `command` signature string and implement `handle()`.\n *\n * @example\n * ```typescript\n * export class GreetCommand extends Command {\n *   static command = 'greet {name : The name to greet} {--loud}'\n *   static description = 'Greet someone'\n *\n *   async handle(): Promise<void> {\n *     const name = this.string('name')\n *     const loud = this.boolean('loud')\n *     this.info(loud ? `HELLO, ${name.toUpperCase()}!` : `Hello, ${name}!`)\n *   }\n * }\n * ```\n */\nexport abstract class Command {\n  /**\n   * Laravel-style command signature string.\n   *\n   * **Command names:**\n   * - `'greet'` — flat command (`quarry greet`)\n   * - `'task add'` — subcommand hierarchy via spaces (`quarry task add`)\n   * - `'task:add'` — namespaced flat command via colons (`quarry task:add`)\n   *\n   * **Arguments:**\n   * - `{name}` — required argument\n   * - `{name?}` — optional argument\n   * - `{name=default}` — argument with default value\n   * - `{name*}` — array/variadic argument\n   * - `{name : description}` — argument with description\n   *\n   * **Options:**\n   * - `{--flag}` — boolean flag\n   * - `{--name=}` — option that accepts a value\n   * - `{--name=default}` — option with default value\n   * - `{--name=*}` — array option (multiple values)\n   * - `{--A|name}` — option with single-char alias\n   * - `{--name= : description}` — option with description\n   *\n   * @example\n   * ```typescript\n   * // Namespaced flat command: `quarry users:create ...`\n   * static command = 'users:create {email : The user email} {--A|admin} {--R|role= : Assign a role}'\n   *\n   * // Subcommand hierarchy: `quarry users create ...`\n   * static command = 'users create {email : The user email} {--A|admin} {--R|role= : Assign a role}'\n   * ```\n   */\n  static command: string\n  /** Human-readable description */\n  static description?: string\n  /** Alternative command names */\n  static aliases?: string[];\n\n  [COMMAND_INTERNALS]: CommandInternals\n\n  constructor() {\n    this[COMMAND_INTERNALS] = {\n      inputs: {},\n      output: [],\n      errors: [],\n      exitCode: 0,\n      quarry: null,\n    }\n  }\n\n  /**\n   * Implement this method with the command's logic.\n   * Return a number to set the exit code, or void for exit code 0.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-invalid-void-type\n  abstract handle(): number | void | Promise<number | void>\n\n  // ── Input Accessors ──────────────────────────────────────────────\n\n  /**\n   * Get an input value with generic type.\n   */\n  input<T>(name: string): T {\n    return this[COMMAND_INTERNALS].inputs[name] as T\n  }\n\n  /**\n   * Get a string input. Throws CommandError if present but not a string.\n   */\n  string(name: string): string {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return ''\n    }\n    if (typeof value !== 'string') {\n      throw new CommandError(`Input \"${name}\" expected a string, got ${typeof value}`)\n    }\n    return value\n  }\n\n  /**\n   * Get a boolean input. Throws CommandError if present but not a boolean.\n   */\n  boolean(name: string): boolean {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return false\n    }\n    if (typeof value !== 'boolean') {\n      throw new CommandError(`Input \"${name}\" expected a boolean, got ${typeof value}`)\n    }\n    return value\n  }\n\n  /**\n   * Get a number input. Coerces strings to numbers. Throws CommandError on NaN.\n   */\n  number(name: string): number {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return 0\n    }\n    const num = typeof value === 'string' ? Number(value) : value\n    if (typeof num !== 'number' || Number.isNaN(num)) {\n      throw new CommandError(`Input \"${name}\" expected a number, got ${typeof value}`)\n    }\n    return num\n  }\n\n  /**\n   * Get an array input. Throws CommandError if present but not an array.\n   */\n  array(name: string): string[] {\n    const value = this[COMMAND_INTERNALS].inputs[name]\n    if (value === undefined || value === null) {\n      return []\n    }\n    if (!Array.isArray(value)) {\n      throw new CommandError(`Input \"${name}\" expected an array, got ${typeof value}`)\n    }\n    return value as string[]\n  }\n\n  // ── Output Helpers ───────────────────────────────────────────────\n\n  /** Write an informational message to output */\n  info(message: string): void {\n    this[COMMAND_INTERNALS].output.push(cyan(message))\n  }\n\n  /** Write a success message to output */\n  success(message: string): void {\n    this[COMMAND_INTERNALS].output.push(`${green(bold('✔'))} ${green(message)}`)\n  }\n\n  /** Write a warning message to output */\n  warn(message: string): void {\n    this[COMMAND_INTERNALS].output.push(`${yellow(bold('⚠'))} ${yellow(message)}`)\n  }\n\n  /** Write an error message to errors */\n  error(message: string): void {\n    this[COMMAND_INTERNALS].errors.push(red(message))\n  }\n\n  /** Write a plain line to output */\n  line(message?: string): void {\n    this[COMMAND_INTERNALS].output.push(message ?? '')\n  }\n\n  /** Write an empty line to output */\n  newLine(): void {\n    this[COMMAND_INTERNALS].output.push('')\n  }\n\n  /** Write a comment-style line to output */\n  comment(message: string): void {\n    this[COMMAND_INTERNALS].output.push(dim(`// ${message}`))\n  }\n\n  /** Write a formatted table to output */\n  table(headers: string[], rows: string[][]): void {\n    const colWidths = headers.map((h, i) => {\n      const maxRow = rows.reduce((max, row) => Math.max(max, (row[i] ?? '').length), 0)\n      return Math.max(h.length, maxRow)\n    })\n\n    const formatRow = (cells: string[]) =>\n      cells.map((cell, i) => cell.padEnd(colWidths[i])).join('  ')\n\n    this[COMMAND_INTERNALS].output.push(bold(formatRow(headers)))\n    this[COMMAND_INTERNALS].output.push(dim(colWidths.map((w) => '-'.repeat(w)).join('  ')))\n    for (const row of rows) {\n      this[COMMAND_INTERNALS].output.push(formatRow(row))\n    }\n  }\n\n  /** Write an error message and set exit code */\n  fail(message: string, exitCode = 1): void {\n    this[COMMAND_INTERNALS].errors.push(`${red(bold('✖'))} ${red(message)}`)\n    this[COMMAND_INTERNALS].exitCode = exitCode\n  }\n\n  // ── Command Calling ──────────────────────────────────────────────\n\n  /**\n   * Call another command from within this command.\n   * Delegates to Quarry.call() via internal reference.\n   */\n  async call(name: string, input?: CommandInput): Promise<CommandResult> {\n    const internals = this[COMMAND_INTERNALS]\n    if (!internals.quarry) {\n      throw new CommandError('Cannot call commands: Quarry reference not set')\n    }\n    const result = await internals.quarry.call(name, input)\n\n    // Forward child output/errors into parent (like Clipanion context switches)\n    internals.output.push(...result.output)\n    internals.errors.push(...result.errors)\n\n    return result\n  }\n}\n"],"mappings":"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"}

package/dist/{command-DcebcSrL.d.mts → command-TnkPYWta.d.mts}

@@ -1,4 +1,4 @@
-import { n as CommandInternals, r as CommandResult, t as CommandInput } from "./types-N84Ak6YT.mjs";
+import { a as CommandInternals, i as CommandInput, o as CommandResult } from "./application-DfPtIzxF.mjs";
 //#region src/quarry/constants.d.ts
 /**
  * Symbol key for storing internal mutable state on Command instances.
@@ -117,4 +117,4 @@ declare abstract class Command {
 }
 //#endregion
 export { Command as t };
-//# sourceMappingURL=command-DcebcSrL.d.mts.map
+//# sourceMappingURL=command-TnkPYWta.d.mts.map

package/dist/{command-DcebcSrL.d.mts.map → command-TnkPYWta.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"command-DcebcSrL.d.mts","names":[],"sources":["../src/quarry/constants.ts","../src/quarry/command.ts"],"mappings":";;;;;;cAIa,iBAAA;;;;AAAb;;;;;;;;ACqBA;;;;;;;;;;uBAAsB,OAAA;EA8LmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAA,OA7JhD,OAAA;EA4HC;EAAA,OA1HD,WAAA;EA+HD;EAAA,OA7HC,OAAA;EAAA,CAEN,iBAAA,GAAoB,gBAAA;;EA4IC;;;;EAAA,SA3Hb,MAAA,CAAA,mBAA0B,OAAA;EAsIa;;;EA/HhD,KAAA,GAAA,CAAS,IAAA,WAAe,CAAA;;;;EAOxB,MAAA,CAAO,IAAA;;;;EAcP,OAAA,CAAQ,IAAA;;;;EAcR,MAAA,CAAO,IAAA;;;;EAeP,KAAA,CAAM,IAAA;;EAcN,IAAA,CAAK,OAAA;;EAKL,OAAA,CAAQ,OAAA;;EAKR,IAAA,CAAK,OAAA;;EAKL,KAAA,CAAM,OAAA;;EAKN,IAAA,CAAK,OAAA;;EAKL,OAAA,CAAA;;EAKA,OAAA,CAAQ,OAAA;;EAKR,KAAA,CAAM,OAAA,YAAmB,IAAA;;EAiBzB,IAAA,CAAK,OAAA,UAAiB,QAAA;;;;;EAWhB,IAAA,CAAK,IAAA,UAAc,KAAA,GAAQ,YAAA,GAAe,OAAA,CAAQ,aAAA;AAAA"}
+{"version":3,"file":"command-TnkPYWta.d.mts","names":[],"sources":["../src/quarry/constants.ts","../src/quarry/command.ts"],"mappings":";;;;;;cAIa,iBAAA;;;;AAAb;;;;;;;;ACsBA;;;;;;;;;;uBAAsB,OAAA;EA8LmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAA,OA7JhD,OAAA;EA4HC;EAAA,OA1HD,WAAA;EA+HD;EAAA,OA7HC,OAAA;EAAA,CAEN,iBAAA,GAAoB,gBAAA;;EA4IC;;;;EAAA,SA3Hb,MAAA,CAAA,mBAA0B,OAAA;EAsIa;;;EA/HhD,KAAA,GAAA,CAAS,IAAA,WAAe,CAAA;;;;EAOxB,MAAA,CAAO,IAAA;;;;EAcP,OAAA,CAAQ,IAAA;;;;EAcR,MAAA,CAAO,IAAA;;;;EAeP,KAAA,CAAM,IAAA;;EAcN,IAAA,CAAK,OAAA;;EAKL,OAAA,CAAQ,OAAA;;EAKR,IAAA,CAAK,OAAA;;EAKL,KAAA,CAAM,OAAA;;EAKN,IAAA,CAAK,OAAA;;EAKL,OAAA,CAAA;;EAKA,OAAA,CAAQ,OAAA;;EAKR,KAAA,CAAM,OAAA,YAAmB,IAAA;;EAiBzB,IAAA,CAAK,OAAA,UAAiB,QAAA;;;;;EAWhB,IAAA,CAAK,IAAA,UAAc,KAAA,GAAQ,YAAA,GAAe,OAAA,CAAQ,aAAA;AAAA"}

package/dist/config/index.d.mts

@@ -1,5 +1,5 @@
-import { dt as OnInitialize, it as DynamicModule, lt as ModuleContext, ot as FactoryProvider } from "../index-D69rxo8H.mjs";
-import { o as z } from "../index-CpAN9ENH.mjs";
+import { at as DynamicModule, ft as OnInitialize, st as FactoryProvider, ut as ModuleContext } from "../index-BFCxSp_f.mjs";
+import { o as z } from "../index-NGxg-KP_.mjs";
 import { InjectionToken } from "tsyringe";
 
 //#region src/config/config.tokens.d.ts

package/dist/config/index.mjs

@@ -1,13 +1,13 @@
-import { S as ApplicationError, b as ERROR_CODES, s as Scope } from "../errors-CtCi1wn6.mjs";
-import { i as Transient, l as DI_TOKENS, t as __decorate } from "../decorate-D5j-d9_z.mjs";
-import "../logger-BR1-s1Um.mjs";
-import { r as Module } from "../module-BH7t7BGG.mjs";
-import "../events-CXl-o1Ad.mjs";
-import "../command-DG_u5ob2.mjs";
-import "../is-command-MZDCH-0T.mjs";
-import "../is-seeder-BN9Ej1r7.mjs";
-import "../middleware-iRhNjsPH.mjs";
-import "../router-context-BLn4PrRG.mjs";
+import { S as ApplicationError, b as ERROR_CODES, s as Scope } from "../errors-DSKapqD8.mjs";
+import { a as __decorate, d as Transient, g as DI_TOKENS } from "../logger-CGT91VY6.mjs";
+import { r as Module } from "../module-tUtyVJ5E.mjs";
+import "../events-CvUSgEuN.mjs";
+import "../middleware-Bl-b5pkt.mjs";
+import "../router-context-D9R1v2Ac.mjs";
+import "../colors-Y7WIFXs7.mjs";
+import "../command-B1CPgsrU.mjs";
+import "../is-command-DJVI6wEJ.mjs";
+import "../is-seeder-D5MIEcdz.mjs";
 //#region src/config/config.tokens.ts
 const CONFIG_TOKENS = { ConfigService: Symbol.for("stratal:config:service") };
 //#endregion