feat(packages/bundler): add bundler package with single-file output for bun compile

Introduce the `packages/bundler` package with autoload plugin, static
command tree generation, and tsdown config mapping. Key design decisions:

- Disable code splitting (`codeSplitting: false`) so rolldown inlines all
  dynamic imports into a single output file compatible with `bun build --compile`
- Resolve `@kidd/utils/tag` to absolute path via `createRequire` so the
  virtual commands module can import it without relying on `alwaysBundle`
- Prefer ESM entry via `mainFields: ['module', 'main']` to avoid UMD
  `require()` calls breaking in ESM context

Also includes: new `packages/config` package, CLI restructuring (extract
bundler/compiler into dedicated package), documentation updates, and
example project configs.

Co-Authored-By: Claude <noreply@anthropic.com>

Author: zrosenbauer

.claude/rules/errors.md

@@ -18,7 +18,7 @@ type Result<T, E = Error> = readonly [E, null] | readonly [null, T]
 
 ## Conventions
 
-- Define domain-specific error interfaces with `_tag` discriminator and descriptive `reason` or `type` field
+- Define domain-specific error interfaces with a descriptive `type` or `reason` field
 - Create type aliases for domain results (e.g., `type ConfigResult<T> = Result<T, ConfigError>`)
 - Use `ok()` and `fail()` constructors where available (e.g., `HandlerResult` in kidd package)
 - Wrap async operations that can reject with a try/catch that returns a Result tuple
@@ -39,7 +39,6 @@ return [null, script]
 
 ```ts
 interface ConfigError {
-  readonly _tag: 'ConfigError'
   readonly type: 'invalid_toml' | 'missing_field' | 'unknown_workspace'
   readonly message: string
 }

CLAUDE.md

@@ -56,7 +56,6 @@ pnpm test           # Run package tests
 - Built with `tsdown` (`dts: true`, `format: 'esm'`, `clean: true`, `outDir: 'dist'`)
 - TypeScript: `target: ES2022`, `module: ESNext`, `moduleResolution: bundler`, `strict: true`, `isolatedDeclarations: true`
 - `vitest` for tests (test files in `test/**/*.test.ts`)
-- `_tag` discriminated unions on factory-created objects
 - All public properties `readonly`
 - Config validated with Zod at boundaries
 - Explicit return types on all exported functions (required by `isolatedDeclarations`)

assets/logo-icon.txt

@@ -0,0 +1,17 @@
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣀⣤⣤⣶⣶⣶⣶⣶⣶⣤⣤⣀⡀
+⠀⠀⠀⠀⠀⠀⠀⣀⣴⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣦⣀
+⠀⠀⠀⠀⠀⢀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡀
+⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿
+⠀⠀⠀⢀⣸⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠟⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣇⡀
+⠀⠀⢠⣿⣿⣿⣿⣿⣿⠏⠉⠙⠛⠛⠋⠁⠀⠀⠈⠙⠛⠛⠋⠉⠹⣿⣿⣿⣿⣿⣿⡄
+⠀⠀⢸⣿⣿⣿⣿⣿⠏⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣼⣿⣿⣿⣿⣿⡇
+⠀⣠⣾⣿⣿⡏⠁⢀⡴⠶⠟⢛⣛⣛⣛⠛⠶⢦⣄⠀⠀⣀⣤⠾⠋⠀⠈⢹⣿⣿⣷⣄
+⢰⣿⣿⣿⣿⣿⠀⣿⢰⣿⣿⣿⠟⠻⣿⣿⣿⣦⢹⡿⠿⠛⠉⠀⠀⠀⠀⣿⣿⣿⣿⣿⡆
+⠈⢿⣿⣿⣿⡟⠀⢻⡘⣿⣿⣿⡄⠘⢿⣿⣿⠇⡾⠁⠀⠀⠀⠀⠀⠀⠀⢻⣿⣿⣿⡿⠁
+⠀⢀⣿⣿⣯⡀⠀⠈⢳⡙⣿⣿⣭⢠⣾⣿⠏⡼⠁⠀⠀⠀⠀⠀⠀⠀⠀⢀⣽⣿⣿⡀
+⢠⣿⣿⣿⣿⣿⡄⠀⠀⠙⣮⣙⠛⠟⣛⣥⠞⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⣿⡄
+⠘⣿⣿⣿⣿⣿⠃⠀⠀⠀⠀⠉⠛⠛⠋⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⠃
+⠀⠈⣿⣿⣟⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⣻⣿⣿⠁
+⢀⣾⣿⣿⣿⣷⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣾⣿⣿⣿⣷⡀
+⠸⣿⣿⣿⣿⣿⠇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠸⣿⣿⣿⣿⣿⠇
+⠀⠙⠻⠿⠟⠋⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⠻⠿⠟⠋

assets/logo.txt

@@ -1,26 +1,23 @@
-⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣶⣾⣿⣿⣿⣶⣶⣶⣶⣄
-⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⣄
-⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣰⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣧⡀
-⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣰⣿⣿⣿⣿⣿⣿⣿⠛⠋⠉⠛⠻⣿⣿⣿⣿⣿⣿⣷
-⠀⠀⠀⠀⠀⠀⠀⠀⠀⣰⣿⣿⣿⣿⣿⣿⣿⠁⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⣿⡇
-⠀⠀⠀⠀⠀⠀⠀⠀⣰⣿⣿⣿⣿⣿⣿⣿⠇⠀⠀⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⣿⡀
-⠀⠀⠀⠀⠀⠀⠀⣰⣿⣿⣿⣿⣿⣿⣿⡟⠀⠀⠀⠀⠀⠀⠀⠀⠀⢹⣿⣿⣿⣿⣿⣧
-⠀⠀⠀⠀⠀⠀⣼⣿⣿⣿⣿⣿⣿⣿⡿⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢿⣿⣿⣿⣿⣿⡆
-⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⣿⠟⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⢿⣿⣿⣿⣿⣷
-⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣿⠋⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣿⣿⣿⣿⣿⣆
-⠀⠀⠀⠀⠀⠀⢹⣿⣿⣿⣿⣿⡆⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣸⣿⣿⣿⣿⣿⡿
-⠀⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⣷⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⣿⣿⣿⡆
-⠀⠀⠀⠀⠀⢀⣴⣿⣿⣿⣿⣿⣿⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⣿⣿⣿⣿⡇
-⠀⠀⠀⢀⣾⠿⣿⣿⣿⣿⣿⣿⣿⡇⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⣿⣿⣿⣿⡟
-⠀⠀⠀⣾⠁⠀⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⣿⣿⣿⣿⡿⠁
-⠀⠀⠀⢿⠀⣼⣿⣿⣿⣿⣿⣿⣿⣿⡆⠀⠀⠀⠀⠀⠀⠀⠀⣼⠛⣿⣿⣿⣿⠿⢿⣏⣦
-⠀⠀⣀⣼⣿⣿⣿⣿⣿⣿⣿⣿⣿⢃⠇⠀⠀⠀⠀⠀⠀⠀⢰⠏⢀⣿⣿⣿⣿⣶⣦⣿⣿⣧⣄
-⣶⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠋⠣⡀⠀⠀⠀⠀⠀⠀⠀⣿⣶⣿⣿⣿⣿⣿⣿⣿⣿⣿⡁
-⣿⣿⣿⣿⣿⠛⠙⣿⣿⣿⣿⣗⡉⠀⠀⠀⠀⠀⠀⠀⠀⣼⣿⣿⣿⣿⣴⣿⣿⣿⣷⣤⣽⡛⡄
-⠸⣿⣿⣿⣿⠀⠀⣿⣿⣿⣿⡉⠉⠁⠀⠀⠀⠀⠀⠀⠀⢹⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠁⡇
-⣶⣿⣿⣿⠃⠀⣰⣿⢻⣿⣿⣧⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠻⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠃
-⠛⢫⣿⣷⡶⢾⣿⣷⣿⣿⣿⠇⠀⠀⠀⠀⠀⠀⠀⠀⠀⡀⠀⠉⠈⢉⣿⣿⣿⣿⣿⡄⠇⣿
-⠈⣿⡅⢠⡞⠋⣽⣿⣿⠟⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠻⠷⠶⢿⡿⠟⣿⢿⣿⣿⣿⣤⡟
-⠀⠘⣿⠏⠀⣼⣿⣏⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢻⣄⣿⠿⣿⡟
-⠀⠀⢹⡇⠀⣿⡇⠈⠃⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢿⣿⣿⣿⠁
-⠀⠀⠘⠀⠀⣿⣧⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢻⣿⡏
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣀⣤⣤⣤⣤⣴⣶⣶⣤⣤⣤⣤⣄⣀⡀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣤⣶⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣶⣤⣀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣴⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣦⣄
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣴⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷⡀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⡄
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣷
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣾⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⠏⠀⠈⢿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣿⣦⣄
+⠀⠀⠀⠀⠀⠀⠀⠀⢠⣿⣿⣿⣿⣿⣿⣿⣿⣿⠃⠀⠉⠙⠛⠛⠛⠛⠋⠀⠀⠀⠀⠀⠉⠛⠛⠛⠛⠛⠉⠁⠈⣿⣿⣿⣿⣿⣿⣿⣿⣿⣧
+⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⡟⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢠⡿⠁⠀⠀⠸⣿⣿⣿⣿⣿⣿⣿⣿⣿
+⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⠿⠿⠟⠋⣀⣤⣴⠶⠶⠶⠶⠶⠶⣤⣤⣀⠀⠀⠀⠀⠀⢀⣴⡟⠁⠀⠀⠀⠀⠈⠛⠿⠿⢿⣿⣿⣿⣿
+⠀⠀⠀⠀⠀⠀⣠⣶⣿⣿⣿⣿⣇⠀⠀⠀⣾⢫⣴⣶⣶⣿⡿⣿⣿⣶⣶⣬⠹⣷⣴⣶⠶⠿⠛⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⣷⣦⡀
+⠀⠀⠀⠀⠀⣸⣿⣿⣿⣿⣿⣿⣿⡇⠀⠀⣿⠸⣿⣿⣿⡏⠀⢤⣿⣿⣿⣿⢡⡿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣿⣿⣿⣿⣿⣿⣿⣷
+⠀⠀⠀⠀⠀⢹⣿⣿⣿⣿⣿⣿⣿⡇⠀⠀⠸⣧⠻⣿⣿⡿⠆⠀⣹⣿⣿⢃⡾⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⣿⣿⣿
+⠀⠀⠀⠀⠀⠀⠻⣿⣿⣿⣿⣿⠟⠀⠀⠀⠀⠘⢷⣝⠿⣿⣧⣾⣿⠟⣡⡞⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⢿⣿⣿⣿⣿⠟⠁
+⠀⠀⠀⠀⠀⠀⠀⣸⣿⣿⣿⣇⠀⠀⠀⠀⠀⠀⠀⠙⠳⢦⣬⣥⡶⠟⠉⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣀⣿⣿⣿⣯⡀
+⠀⠀⠀⠀⠀⢀⣾⣿⣿⣿⣿⣿⣷⡄⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣼⣿⣿⣿⣿⣿⣿⣆
+⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣿
+⠀⠀⠀⠀⠀⠘⣿⣿⣿⣿⣿⣿⣿⠏⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⢿⣿⣿⣿⣿⣿⣿⠏
+⠀⠀⠀⠀⠀⠀⠈⢻⣿⣿⣿⡟⠁⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠹⣿⣿⣿⣿⠁
+⠀⠀⠀⠀⠀⠀⣴⣿⣿⣿⣿⣷⣤⡀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⣠⣾⣿⣿⣿⣿⣦⡀
+⠀⠀⠀⠀⠀⢸⣿⣿⣿⣿⣿⣿⣿⣷⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢰⣿⣿⣿⣿⣿⣿⣿⣷
+⠀⠀⠀⠀⠀⠸⣿⣿⣿⣿⣿⣿⣿⡟⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠸⣿⣿⣿⣿⣿⣿⣿⡟
+⠀⠀⠀⠀⠀⠀⠙⠿⣿⣿⣿⡿⠟⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠙⠿⣿⣿⣿⡿⠟

assets/yargs.txt

@@ -99,7 +99,7 @@ The framework primitives:
 | Module          | Purpose                                                    |
 | --------------- | ---------------------------------------------------------- |
 | `cli.ts`        | Entry function that wires yargs, config, and context       |
-| `command.ts`    | Factory for creating typed commands with `_tag: 'Command'` |
+| `command.ts`    | Factory for creating typed commands                        |
 | `middleware.ts` | Factory and pipeline runner for middleware composition     |
 | `autoloader.ts` | Auto-discovery and dynamic import of command files         |
 | `context/`      | Context creation, types, and error handling                |
@@ -224,7 +224,7 @@ sequenceDiagram
 
 ## Command System
 
-Commands are created with the `command()` factory and identified by `_tag: 'Command'`:
+Commands are created with the `command()` factory:
 
 ```ts
 export default command({
@@ -272,7 +272,7 @@ commands/
 
 **Discovery rules:**
 
-- Files must export a default `Command` (`_tag === 'Command'`)
+- Files must export a default `Command` (created via `command()`)
 - Extensions: `.ts` or `.js` (not `.d.ts`)
 - Ignored: files starting with `_` or `.`, files named `index`
 - Subdirectories become parent commands; `index.ts` in a subdirectory becomes the parent handler
@@ -298,7 +298,7 @@ kidd uses two error strategies depending on the layer:
 | Layer        | Strategy                            | Type                                       |
 | ------------ | ----------------------------------- | ------------------------------------------ |
 | Lib/internal | `Result<T, E>` tuples               | `[error, null]` or `[null, value]`         |
-| Context/CLI  | `ContextError` (thrown at boundary) | `{ _tag: 'ContextError', code, exitCode }` |
+| Context/CLI  | `ContextError` (thrown at boundary) | `{ code, exitCode }`                       |
 
 **Result tuples** are used for expected failures (config parsing, validation, file I/O). Chain with early returns:
 
@@ -312,10 +312,10 @@ if (error) return [error, null]
 ## Design Decisions
 
 1. **Immutable by default** -- All context properties are deeply readonly; only `ctx.store` is mutable (for middleware data flow)
-2. **Factories over classes** -- All components are factory functions returning objects with `_tag` discriminators
+2. **Factories over classes** -- All components are factory functions returning plain objects
 3. **Result tuples over throw** -- Expected failures use `Result<T, E>`; `ContextError` is the only thrown type at the CLI boundary
 4. **Module augmentation** -- `KiddArgs`, `KiddConfig`, `KiddStore` interfaces allow typed extensions without generics threading
-5. **Discriminated unions** -- All domain types use `_tag` for exhaustive pattern matching via `ts-pattern`
+5. **Discriminated unions** -- Domain types use `type` fields or symbol-based tags for exhaustive pattern matching via `ts-pattern`
 6. **Lazy subcommand loading** -- Commands accept `Promise<CommandMap>` from `autoload()` for deferred imports
 7. **Zod at boundaries** -- Runtime config, args, and external data validated with Zod schemas
 8. **Sensitive data redaction** -- Deep object redaction and regex pattern sanitization built into the context

contributing/concepts/architecture.md

@@ -8,7 +8,7 @@ kidd uses [yargs](https://yargs.js.org) for command routing and [`@clack/prompts
 
 ## Commands
 
-Commands are created with the `command()` factory. Each command receives a `_tag: 'Command'` discriminator and defines a description, optional args schema, optional subcommands, and a handler function.
+Commands are created with the `command()` factory. Each command defines a description, optional args schema, optional subcommands, and a handler function.
 
 | Property      | Type                                      | Description                                           |
 | ------------- | ----------------------------------------- | ----------------------------------------------------- |
@@ -210,7 +210,7 @@ commands/
 
 **Rules:**
 
-- Files must have a default export with `_tag === 'Command'`
+- Files must have a default export created via `command()`
 - Extensions: `.ts` or `.js` (not `.d.ts`)
 - Ignored: files starting with `_` or `.`, files named `index` (used as parent handlers)
 - Subdirectories become parent commands with nested subcommands
@@ -221,7 +221,7 @@ Errors propagate from handlers to the terminal through a single path:
 
 ```
 Handler calls ctx.errors.fail(message)
-  -> Throws ContextError { _tag, code, exitCode, message }
+  -> Throws ContextError { code, exitCode, message }
   -> Middleware chain unwinds (post-handler code skipped)
   -> CLI boundary catches ContextError
   -> Logs error message via @clack/prompts