fix(cli): swap cac → @stacksjs/clapp

`bun run build` was failing with "Could not resolve cac" because
the source still imported from `cac` but cac wasn't in package.json
deps. Per the standing rule across the org, we use @stacksjs/clapp
not cac.

Migration:
- bin/cli.ts: `import { CAC } from 'cac'` →
  `import { CLI } from '@stacksjs/clapp'`, `new CAC` → `new CLI`
- 9 files in src/cli/commands/: type-only `import type { CAC } from 'cac'` →
  `import type { CLI } from '@stacksjs/clapp'`, function param
  `cli: CAC` → `cli: CLI`
- package.json: add `@stacksjs/clapp: 0.2.0` to devDeps. Pinned
  exactly to 0.2.0 — 0.2.3 ships a malformed CLI.d.ts that breaks
  typecheck (TS1138), 0.2.4 fixes the parse error but tightens
  action callback types in a way that breaks existing handlers.

Adjacent fix: `commit-msg` hook was `bunx gitlint` (the bare
`gitlint` package was unpublished from npm in 2022). Repointed at
`bunx --bun @stacksjs/gitlint`. Same trap that's bitten several
other repos this round.

Author: glennmichael123

bin/cli.ts

@@ -4,7 +4,7 @@
 // ============================================================================
 
 import nodeProcess from 'node:process'
-import { CAC } from 'cac'
+import { CLI } from '@stacksjs/clapp'
 import { version } from '../package.json'
 import {
   registerLocalCommands,
@@ -16,7 +16,7 @@ import {
   registerUtilityCommands,
 } from '../src/cli/commands'
 
-const cli = new CAC('dbtooling')
+const cli = new CLI('dbtooling')
 
 // Register all command modules
 registerTableCommands(cli)

bun.lock

@@ -57,6 +57,7 @@
   },
   "devDependencies": {
     "@stacksjs/cli": "^0.70.23",
+    "@stacksjs/clapp": "0.2.0",
     "@stacksjs/logging": "^0.70.23",
     "@stacksjs/storage": "^0.70.23",
     "@types/tar": "^7.0.87",
@@ -73,6 +74,6 @@
       },
       "autoRestage": true
     },
-    "commit-msg": "bunx gitlint --edit .git/COMMIT_EDITMSG"
+    "commit-msg": "bunx --bun @stacksjs/gitlint --edit .git/COMMIT_EDITMSG"
   }
 }

package.json

@@ -2,7 +2,7 @@
 // CLI Commands Index
 // ============================================================================
 
-import type { CAC } from 'cac'
+import type { CLI } from '@stacksjs/clapp'
 import { registerLocalCommands } from './local'
 import { registerMigrateCommands } from './migrate'
 import { registerModelsCommands } from './models'
@@ -24,7 +24,7 @@ export { registerUtilityCommands } from './utility'
 /**
  * Register all CLI commands
  */
-export function registerAllCommands(cli: CAC): void {
+export function registerAllCommands(cli: CLI): void {
   registerTableCommands(cli)
   registerMigrateCommands(cli)
   registerQueryCommands(cli)

src/cli/commands/index.ts

@@ -2,15 +2,15 @@
 // Local DynamoDB Development Commands
 // ============================================================================
 
-import type { CAC } from 'cac'
+import type { CLI } from '@stacksjs/clapp'
 import { getConfig } from '../../config'
 import { dynamoDb, runningProcesses } from '../../dynamodb'
 import { handleError } from '../utils'
 
 /**
  * Register local development commands
  */
-export function registerLocalCommands(cli: CAC): void {
+export function registerLocalCommands(cli: CLI): void {
   // start - Start local DynamoDB
   cli
     .command('start', 'Start DynamoDB Local')

src/cli/commands/local.ts

@@ -2,7 +2,7 @@
 // Migration CLI Commands
 // ============================================================================
 
-import type { CAC } from 'cac'
+import type { CLI } from '@stacksjs/clapp'
 import { getConfig } from '../../config'
 import {
   formatSchemaSummary,
@@ -30,7 +30,7 @@ import {
 /**
  * Register migration commands
  */
-export function registerMigrateCommands(cli: CAC): void {
+export function registerMigrateCommands(cli: CLI): void {
   // migrate - Run migrations
   cli
     .command('migrate', 'Run database migrations based on your Stacks models')

src/cli/commands/migrate.ts

@@ -3,7 +3,7 @@
 // ============================================================================
 // View and explore Stacks model definitions
 
-import type { CAC } from 'cac'
+import type { CLI } from '@stacksjs/clapp'
 import type { TreeNode } from '../ui'
 import { getConfig } from '../../config'
 import { handleCommandError } from '../error-formatter'
@@ -55,7 +55,7 @@ interface ParsedModel {
 /**
  * Register models viewer commands
  */
-export function registerModelsCommands(cli: CAC): void {
+export function registerModelsCommands(cli: CLI): void {
   // models - List all models
   cli
     .command('models', 'List all Stacks models')

src/cli/commands/models.ts

@@ -2,14 +2,14 @@
 // Query CLI Commands
 // ============================================================================
 
-import type { CAC } from 'cac'
+import type { CLI } from '@stacksjs/clapp'
 import { getConfig } from '../../config'
 import { handleError } from '../utils'
 
 /**
  * Register query commands
  */
-export function registerQueryCommands(cli: CAC): void {
+export function registerQueryCommands(cli: CLI): void {
   // query - Interactive query
   cli
     .command('query [table]', 'Query a DynamoDB table')

src/cli/commands/query.ts

@@ -3,7 +3,7 @@
 // ============================================================================
 // Interactive schema visualization and exploration
 
-import type { CAC } from 'cac'
+import type { CLI } from '@stacksjs/clapp'
 import type { TreeNode } from '../ui'
 import { getConfig } from '../../config'
 import {
@@ -30,7 +30,7 @@ import {
 /**
  * Register schema viewer commands
  */
-export function registerSchemaCommands(cli: CAC): void {
+export function registerSchemaCommands(cli: CLI): void {
   // schema - Show schema overview
   cli
     .command('schema', 'Display table schema overview')

src/cli/commands/schema.ts

@@ -2,14 +2,14 @@
 // Seeder CLI Commands
 // ============================================================================
 
-import type { CAC } from 'cac'
+import type { CLI } from '@stacksjs/clapp'
 import { getConfig } from '../../config'
 import { handleError } from '../utils'
 
 /**
  * Register seeder commands
  */
-export function registerSeedCommands(cli: CAC): void {
+export function registerSeedCommands(cli: CLI): void {
   // seed - Run seeders
   cli
     .command('seed', 'Run database seeders')