@forinda/kickjs-cli 5.5.0 → 5.7.0

package/dist/{builtins-BpWIctor.mjs → run-plugins-DaO1FtZb.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v5.5.0
+ * @forinda/kickjs-cli v5.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,14 +8,14 @@
  *
  * @license MIT
  */
-import{A as e,C as t,D as n,E as r,F as i,I as a,L as o,M as s,N as c,O as l,P as u,R as d,S as f,T as p,_ as m,a as h,b as g,c as _,d as ee,f as v,g as y,h as te,j as ne,k as b,l as re,m as ie,n as ae,o as oe,p as se,s as ce,t as le,u as ue,v as de,w as x,x as fe,y as S}from"./generator-extension-CEYm6tuj.mjs";import{a as C,i as w,o as pe,t as me}from"./config-BSo8gLtM.mjs";import{n as T}from"./types-CYw_hoZY.mjs";import{n as he}from"./plugin-CVRofuDz.mjs";import{a as ge,c as _e,i as ve,n as ye,o as be,s as xe,t as E}from"./typegen-DyXcnNCk.mjs";import D,{basename as Se,dirname as O,isAbsolute as Ce,join as k,relative as A,resolve as j,sep as we}from"node:path";import{cpSync as Te,existsSync as M,mkdirSync as N,readFileSync as P,readdirSync as Ee,rmSync as De,statSync as Oe,writeFileSync as ke}from"node:fs";import{copyFile as Ae,mkdir as je,readFile as F,readdir as Me,rm as Ne,stat as Pe,writeFile as I}from"node:fs/promises";import{execSync as Fe,fork as Ie,spawn as Le,spawnSync as Re}from"node:child_process";import{pathToFileURL as L}from"node:url";import{glob as ze}from"glob";import{groupAssetKeys as Be}from"@forinda/kickjs";import{arch as Ve,platform as He,release as Ue}from"node:os";import{detectCompositeReferences as We,generate as Ge,migrateDown as Ke,migrateLatest as qe,migrateRollback as Je,migrateStatus as Ye,migrateUp as Xe,renderSchemaSource as Ze,resolveDbConfig as Qe}from"@forinda/kickjs-db";const $e={kickjs:{pkg:`@forinda/kickjs`,peers:[`express`],description:`Unified framework: DI, decorators, routing, middleware`,core:!0},vite:{pkg:`@forinda/kickjs-vite`,peers:[`vite`],description:`Vite plugin: dev server, HMR, module discovery`,dev:!0,core:!0},cli:{pkg:`@forinda/kickjs-cli`,peers:[],description:`CLI tool and code generators`,dev:!0,core:!0},swagger:{pkg:`@forinda/kickjs-swagger`,peers:[],description:`OpenAPI spec + Swagger UI + ReDoc`},db:{pkg:`@forinda/kickjs-db`,peers:[],description:`kick/db core — schema DSL, migrations, KickDbClient, customType`},"db-pg":{pkg:`@forinda/kickjs-db-pg`,peers:[`pg`],description:`kick/db PostgreSQL dialect + adapter (pgDialect, pgAdapter)`},drizzle:{pkg:`@forinda/kickjs-drizzle`,peers:[`drizzle-orm`],description:`Drizzle ORM adapter + query builder`},prisma:{pkg:`@forinda/kickjs-prisma`,peers:[`@prisma/client`],description:`Prisma adapter + query builder`},ws:{pkg:`@forinda/kickjs-ws`,peers:[`socket.io`],description:`WebSocket with @WsController decorators`},devtools:{pkg:`@forinda/kickjs-devtools`,peers:[],description:`Development dashboard — routes, DI, metrics, health`,dev:!0},auth:{pkg:`@forinda/kickjs-auth`,peers:[`jsonwebtoken`],description:`Authentication — JWT, API key, and custom strategies`},queue:{pkg:`@forinda/kickjs-queue`,peers:[],description:`Queue adapter (BullMQ/RabbitMQ/Kafka)`},"queue:bullmq":{pkg:`@forinda/kickjs-queue`,peers:[`bullmq`,`ioredis`],description:`Queue with BullMQ + Redis`},"queue:rabbitmq":{pkg:`@forinda/kickjs-queue`,peers:[`amqplib`],description:`Queue with RabbitMQ`},"queue:kafka":{pkg:`@forinda/kickjs-queue`,peers:[`kafkajs`],description:`Queue with Kafka`},mcp:{pkg:`@forinda/kickjs-mcp`,peers:[`@modelcontextprotocol/sdk`],description:`Model Context Protocol server — expose @Controller endpoints as AI tools`},testing:{pkg:`@forinda/kickjs-testing`,peers:[],description:`Test utilities and TestModule builder`,dev:!0}};function R(e,t=process.cwd()){let n=t;for(;;){if(M(j(n,e)))return n;let t=O(n);if(t===n)return null;n=t}}function et(){return R(`pnpm-lock.yaml`)?`pnpm`:R(`yarn.lock`)?`yarn`:R(`bun.lockb`)||R(`bun.lock`)?`bun`:R(`package-lock.json`)?`npm`:null}function tt(){let e=process.cwd();for(;e;){let t=j(e,`package.json`);if(M(t))try{let e=JSON.parse(P(t,`utf-8`)).packageManager;if(typeof e==`string`){let t=e.split(`@`)[0];if(me.includes(t))return t}}catch{}let n=O(e);if(n===e)return null;e=n}return null}async function nt(e){if(e&&me.includes(e))return{pm:e,source:`flag`};let t=await w(process.cwd());if(t?.packageManager&&me.includes(t.packageManager))return{pm:t.packageManager,source:`config`};let n=tt();if(n)return{pm:n,source:`package.json`};let r=et();return r?{pm:r,source:`lockfile`}:{pm:`npm`,source:`default`}}async function rt(e){let{pm:t}=await nt(e);return t}function it(e=!1){let t=Object.entries($e),n=Math.max(...t.map(([e])=>e.length)),r=t.filter(([,e])=>e.core),i=t.filter(([,e])=>!e.core),a=([e,t])=>{let r=e.padEnd(n+2),i=t.peers.length?` (+ ${t.peers.join(`, `)})`:``;return`    ${r} ${t.description}${i}`};console.log(`
+import{A as e,B as t,C as n,D as r,E as i,F as a,I as o,L as s,M as c,N as l,O as u,P as d,R as f,S as p,T as m,_ as h,a as g,b as _,c as v,d as y,f as ee,g as te,h as b,j as x,k as S,l as ne,m as re,n as ie,o as ae,p as oe,s as se,t as ce,u as le,v as ue,w as de,x as C,y as fe,z as w}from"./generator-extension-Cd2DU_XX.mjs";import{a as T,i as E,o as pe,t as me}from"./config-BQUzGk6m.mjs";import{t as he}from"./project-root-Dsxhm7OL.mjs";import{n as D}from"./types-Du3p7CZ5.mjs";import{n as ge}from"./plugin-B6ANfh7O.mjs";import{a as _e,c as ve,i as ye,n as be,o as xe,s as Se,t as O}from"./typegen-D-1Q9yBD.mjs";import k,{basename as Ce,dirname as A,isAbsolute as we,join as j,relative as M,resolve as N,sep as Te}from"node:path";import{cpSync as Ee,existsSync as P,mkdirSync as De,readFileSync as F,readdirSync as Oe,rmSync as ke,statSync as Ae,writeFileSync as je}from"node:fs";import{copyFile as Me,mkdir as Ne,readFile as I,readdir as Pe,rm as Fe,stat as Ie,writeFile as L}from"node:fs/promises";import{execSync as Le,fork as Re,spawn as ze,spawnSync as Be}from"node:child_process";import{pathToFileURL as R}from"node:url";import{glob as Ve}from"glob";import{groupAssetKeys as He}from"@forinda/kickjs";import{arch as Ue,platform as We,release as Ge}from"node:os";import{detectCompositeReferences as Ke,generate as qe,migrateDown as Je,migrateLatest as Ye,migrateRollback as Xe,migrateStatus as Ze,migrateUp as Qe,renderSchemaSource as $e,resolveDbConfig as et}from"@forinda/kickjs-db";const tt={kickjs:{pkg:`@forinda/kickjs`,peers:[`express`],description:`Unified framework: DI, decorators, routing, middleware`,core:!0},vite:{pkg:`@forinda/kickjs-vite`,peers:[`vite`],description:`Vite plugin: dev server, HMR, module discovery`,dev:!0,core:!0},cli:{pkg:`@forinda/kickjs-cli`,peers:[],description:`CLI tool and code generators`,dev:!0,core:!0},swagger:{pkg:`@forinda/kickjs-swagger`,peers:[],description:`OpenAPI spec + Swagger UI + ReDoc`},db:{pkg:`@forinda/kickjs-db`,peers:[],description:`kick/db core — schema DSL, migrations, KickDbClient, customType`},"db-pg":{pkg:`@forinda/kickjs-db-pg`,peers:[`pg`],description:`kick/db PostgreSQL dialect + adapter (pgDialect, pgAdapter)`},drizzle:{pkg:`@forinda/kickjs-drizzle`,peers:[`drizzle-orm`],description:`Drizzle ORM adapter + query builder`},prisma:{pkg:`@forinda/kickjs-prisma`,peers:[`@prisma/client`],description:`Prisma adapter + query builder`},ws:{pkg:`@forinda/kickjs-ws`,peers:[`socket.io`],description:`WebSocket with @WsController decorators`},devtools:{pkg:`@forinda/kickjs-devtools`,peers:[],description:`Development dashboard — routes, DI, metrics, health`,dev:!0},queue:{pkg:`@forinda/kickjs-queue`,peers:[],description:`Queue adapter (BullMQ/RabbitMQ/Kafka)`},"queue:bullmq":{pkg:`@forinda/kickjs-queue`,peers:[`bullmq`,`ioredis`],description:`Queue with BullMQ + Redis`},"queue:rabbitmq":{pkg:`@forinda/kickjs-queue`,peers:[`amqplib`],description:`Queue with RabbitMQ`},"queue:kafka":{pkg:`@forinda/kickjs-queue`,peers:[`kafkajs`],description:`Queue with Kafka`},mcp:{pkg:`@forinda/kickjs-mcp`,peers:[`@modelcontextprotocol/sdk`],description:`Model Context Protocol server — expose @Controller endpoints as AI tools`},testing:{pkg:`@forinda/kickjs-testing`,peers:[],description:`Test utilities and TestModule builder`,dev:!0}};function z(e,t=process.cwd()){let n=t;for(;;){if(P(N(n,e)))return n;let t=A(n);if(t===n)return null;n=t}}function nt(){return z(`pnpm-lock.yaml`)?`pnpm`:z(`yarn.lock`)?`yarn`:z(`bun.lockb`)||z(`bun.lock`)?`bun`:z(`package-lock.json`)?`npm`:null}function rt(){let e=process.cwd();for(;e;){let t=N(e,`package.json`);if(P(t))try{let e=JSON.parse(F(t,`utf-8`)).packageManager;if(typeof e==`string`){let t=e.split(`@`)[0];if(me.includes(t))return t}}catch{}let n=A(e);if(n===e)return null;e=n}return null}async function it(e){if(e&&me.includes(e))return{pm:e,source:`flag`};let t=await E(process.cwd());if(t?.packageManager&&me.includes(t.packageManager))return{pm:t.packageManager,source:`config`};let n=rt();if(n)return{pm:n,source:`package.json`};let r=nt();return r?{pm:r,source:`lockfile`}:{pm:`npm`,source:`default`}}async function at(e){let{pm:t}=await it(e);return t}function ot(e=!1){let t=Object.entries(tt),n=Math.max(...t.map(([e])=>e.length)),r=t.filter(([,e])=>e.core),i=t.filter(([,e])=>!e.core),a=([e,t])=>{let r=e.padEnd(n+2),i=t.peers.length?` (+ ${t.peers.join(`, `)})`:``;return`    ${r} ${t.description}${i}`};console.log(`
   Core packages (always installed by \`kick new\`):
 `);for(let e of r)console.log(a(e));if(e){console.log(`
   Optional packages (add as needed):
 `);for(let e of i)console.log(a(e))}else console.log(`\n  Plus ${i.length} optional packages (auth, swagger, db, queue, …).`),console.log("  Run `kick add --list --all` for the full catalog.");console.log(`
-  Usage: kick add auth drizzle swagger`),console.log(`         kick add queue:bullmq`),console.log()}function at(e){e.command(`list`).alias(`ls`).description(`List KickJS packages (core only; pair with --all for the full catalog)`).option(`--all`,`Include the full optional catalog`).action(e=>{it(!!e.all)})}function ot(e){e.command(`add [packages...]`).description(`Add KickJS packages with their required dependencies`).option(`--pm <manager>`,`Package manager override`).option(`-D, --dev`,`Install as dev dependency`).option(`--list`,`List packages (core only by default; pair with --all)`).option(`--all`,`When listing, include the full optional catalog`).action(async(e,t)=>{if(t.list||e.length===0){it(!!t.all);return}let{pm:n,source:r}=await nt(t.pm);console.log(`\n  Using ${n} (resolved from ${r})`);let i=t.dev,a=new Set,o=new Set,s=[];for(let t of e){let e=$e[t];if(!e){s.push(t);continue}let n=i||e.dev?o:a;n.add(e.pkg);for(let t of e.peers)n.add(t)}if(!(s.length>0&&(console.log(`\n  Unknown packages: ${s.join(`, `)}`),console.log(`  Run "kick add --list" to see available packages.
-`),a.size===0&&o.size===0))){if(a.size>0){let e=Array.from(a),t=`${n} add ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dependency(ies):`);for(let t of e)console.log(`    + ${t}`);console.log();try{Fe(t,{stdio:`inherit`})}catch{console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(o.size>0){let e=Array.from(o),t=`${n} add -D ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dev dependency(ies):`);for(let t of e)console.log(`    + ${t} (dev)`);console.log();try{Fe(t,{stdio:`inherit`})}catch{console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}console.log(`  Done!
-`)}})}const st=[{value:`auth`,label:`Auth`,hint:`JWT, OAuth, API keys`},{value:`swagger`,label:`Swagger`,hint:`OpenAPI docs`},{value:`ws`,label:`WebSocket`,hint:`rooms, heartbeat`},{value:`queue`,label:`Queue`,hint:`BullMQ/RabbitMQ/Kafka`},{value:`devtools`,label:`DevTools`,hint:`debug dashboard`}];function ct(t){t.command(`new [name]`).alias(`init`).description(`Create a new KickJS project (use "." for current directory)`).option(`-d, --directory <dir>`,`Target directory (defaults to project name)`).option(`--pm <manager>`,`Package manager: pnpm | npm | yarn | bun`).option(`--git`,`Initialize git repository`).option(`--no-git`,`Skip git initialization`).option(`--install`,`Install dependencies after scaffolding`).option(`--no-install`,`Skip dependency installation`).option(`-f, --force`,`Remove existing files without prompting`).option(`-t, --template <type>`,`Project template: rest | ddd | cqrs | minimal`).option(`-r, --repo <type>`,`Default repository: prisma | drizzle | inmemory | custom`).option(`--packages <packages>`,`Comma-separated packages to include (e.g. auth,swagger,ws,queue)`).option(`-y, --yes`,`Pick safe defaults for every prompt (template=minimal, repo=inmemory, no extras, git+install on)`).option(`--non-interactive`,`alias for --yes`).action(async(t,i)=>{r(`KickJS — Create a new project`);let a=!!(i.yes||i.nonInteractive);t||=a?`my-api`:await s({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let o;if(t===`.`?(o=j(`.`),t=Se(o)):o=j(i.directory||t),M(o)){let e=Ee(o);if(e.length>0){if(i.force)n.warn(`Clearing existing files in ${o}`);else if(a){n.warn(`Directory "${t}" is not empty. Pass --force to clear it.`),b(`Aborted.`);return}else{n.warn(`Directory "${t}" is not empty:`);let r=e.slice(0,5);for(let e of r)n.message(`  - ${e}`);if(e.length>5&&n.message(`  ... and ${e.length-5} more`),!await p({message:u.red(`Remove all existing files and proceed?`),initialValue:!1})){b(`Aborted.`);return}}for(let t of e)De(j(o,t),{recursive:!0,force:!0})}}let c=i.template;c||=a?`minimal`:await e({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`ddd`,label:`DDD`,hint:`Domain-Driven Design modules`},{value:`cqrs`,label:`CQRS`,hint:`Commands, Queries, Events + WS/Queue`},{value:`minimal`,label:`Minimal`,hint:`bare Express`}]});let d=i.pm;d||=a?await rt(void 0):await e({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let f=i.repo;f||(a?f=`inmemory`:(f=await e({message:`Default repository/ORM`,options:[{value:`prisma`,label:`Prisma`},{value:`drizzle`,label:`Drizzle`},{value:`inmemory`,label:`In-Memory`},{value:`custom`,label:`Custom`,hint:`specify later`}]}),f===`custom`&&(f=await s({message:`Custom repository name`,defaultValue:`custom`}))));let m;if(i.packages!==void 0){let e=i.packages.trim().toLowerCase();m=e===``||e===`none`||e===`false`?[]:i.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else m=a?[]:await l({message:`Select packages to include`,options:[...st],required:!1});let g;g=i.git===void 0?a?!0:await p({message:`Initialize git repository?`,initialValue:!0}):i.git;let _;_=i.install===void 0?a?!0:await p({message:`Install dependencies?`,initialValue:!0}):i.install,await h({name:t,directory:o,packageManager:d,initGit:g,installDeps:_,template:c,defaultRepo:f,packages:m}),b(`Done! Next steps: ${u.cyan(`cd ${t} && ${d} dev`)}`)})}async function lt(e){let{name:n,outDir:r}=e,i=t(n),a=x(n),o=[],s=k(r,`${i}.plugin.ts`);return await d(s,`import {
+  Usage: kick add auth drizzle swagger`),console.log(`         kick add queue:bullmq`),console.log()}function st(e){e.command(`list`).alias(`ls`).description(`List KickJS packages (core only; pair with --all for the full catalog)`).option(`--all`,`Include the full optional catalog`).action(e=>{ot(!!e.all)})}function ct(e){e.command(`add [packages...]`).description(`Add KickJS packages with their required dependencies`).option(`--pm <manager>`,`Package manager override`).option(`-D, --dev`,`Install as dev dependency`).option(`--list`,`List packages (core only by default; pair with --all)`).option(`--all`,`When listing, include the full optional catalog`).action(async(e,t)=>{if(t.list||e.length===0){ot(!!t.all);return}let{pm:n,source:r}=await it(t.pm);console.log(`\n  Using ${n} (resolved from ${r})`);let i=t.dev,a=new Set,o=new Set,s=[];for(let t of e){let e=tt[t];if(!e){s.push(t);continue}let n=i||e.dev?o:a;n.add(e.pkg);for(let t of e.peers)n.add(t)}if(!(s.length>0&&(console.log(`\n  Unknown packages: ${s.join(`, `)}`),console.log(`  Run "kick add --list" to see available packages.
+`),a.size===0&&o.size===0))){if(a.size>0){let e=Array.from(a),t=`${n} add ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dependency(ies):`);for(let t of e)console.log(`    + ${t}`);console.log();try{Le(t,{stdio:`inherit`})}catch{console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(o.size>0){let e=Array.from(o),t=`${n} add -D ${e.join(` `)}`;console.log(`\n  Installing ${e.length} dev dependency(ies):`);for(let t of e)console.log(`    + ${t} (dev)`);console.log();try{Le(t,{stdio:`inherit`})}catch{console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}console.log(`  Done!
+`)}})}const lt=[{value:`swagger`,label:`Swagger`,hint:`OpenAPI docs`},{value:`ws`,label:`WebSocket`,hint:`rooms, heartbeat`},{value:`queue`,label:`Queue`,hint:`BullMQ/RabbitMQ/Kafka`},{value:`devtools`,label:`DevTools`,hint:`debug dashboard`}];function ut(t){t.command(`new [name]`).alias(`init`).description(`Create a new KickJS project (use "." for current directory)`).option(`-d, --directory <dir>`,`Target directory (defaults to project name)`).option(`--pm <manager>`,`Package manager: pnpm | npm | yarn | bun`).option(`--git`,`Initialize git repository`).option(`--no-git`,`Skip git initialization`).option(`--install`,`Install dependencies after scaffolding`).option(`--no-install`,`Skip dependency installation`).option(`-f, --force`,`Remove existing files without prompting`).option(`-t, --template <type>`,`Project template: rest | ddd | cqrs | minimal`).option(`-r, --repo <type>`,`Default repository: prisma | drizzle | inmemory | custom`).option(`--packages <packages>`,`Comma-separated packages to include (e.g. auth,swagger,ws,queue)`).option(`-y, --yes`,`Pick safe defaults for every prompt (template=minimal, repo=inmemory, no extras, git+install on)`).option(`--non-interactive`,`alias for --yes`).action(async(t,n)=>{u(`KickJS — Create a new project`);let i=!!(n.yes||n.nonInteractive);t||=i?`my-api`:await d({message:`Project name`,placeholder:`my-api`,defaultValue:`my-api`});let a;if(t===`.`?(a=N(`.`),t=Ce(a)):a=N(n.directory||t),P(a)){let e=Oe(a);if(e.length>0){if(n.force)S.warn(`Clearing existing files in ${a}`);else if(i){S.warn(`Directory "${t}" is not empty. Pass --force to clear it.`),x(`Aborted.`);return}else{S.warn(`Directory "${t}" is not empty:`);let n=e.slice(0,5);for(let e of n)S.message(`  - ${e}`);if(e.length>5&&S.message(`  ... and ${e.length-5} more`),!await r({message:o.red(`Remove all existing files and proceed?`),initialValue:!1})){x(`Aborted.`);return}}for(let t of e)ke(N(a,t),{recursive:!0,force:!0})}}let s=n.template;s||=i?`minimal`:await c({message:`Project template`,options:[{value:`rest`,label:`REST API`,hint:`Express + Swagger`},{value:`ddd`,label:`DDD`,hint:`Domain-Driven Design modules`},{value:`cqrs`,label:`CQRS`,hint:`Commands, Queries, Events + WS/Queue`},{value:`minimal`,label:`Minimal`,hint:`bare Express`}]});let l=n.pm;l||=i?await at(void 0):await c({message:`Package manager`,options:[{value:`pnpm`,label:`pnpm`},{value:`npm`,label:`npm`},{value:`yarn`,label:`yarn`},{value:`bun`,label:`bun`}]});let f=n.repo;f||(i?f=`inmemory`:(f=await c({message:`Default repository/ORM`,options:[{value:`prisma`,label:`Prisma`},{value:`drizzle`,label:`Drizzle`},{value:`inmemory`,label:`In-Memory`},{value:`custom`,label:`Custom`,hint:`specify later`}]}),f===`custom`&&(f=await d({message:`Custom repository name`,defaultValue:`custom`}))));let p;if(n.packages!==void 0){let e=n.packages.trim().toLowerCase();p=e===``||e===`none`||e===`false`?[]:n.packages.split(`,`).map(e=>e.trim()).filter(Boolean)}else p=i?[]:await e({message:`Select packages to include`,options:[...lt],required:!1});let m;m=n.git===void 0?i?!0:await r({message:`Initialize git repository?`,initialValue:!0}):n.git;let h;h=n.install===void 0?i?!0:await r({message:`Install dependencies?`,initialValue:!0}):n.install,await g({name:t,directory:a,packageManager:l,initGit:m,installDeps:h,template:s,defaultRepo:f,packages:p}),x(`Done! Next steps: ${o.cyan(`cd ${t} && ${l} dev`)}`)})}async function dt(e){let{name:n,outDir:r}=e,a=m(n),o=i(n),s=[],c=j(r,`${a}.plugin.ts`);return await t(c,`import {
   definePlugin,
   type AppAdapter,
   type AppModuleEntry,
@@ -24,21 +24,21 @@ import{A as e,C as t,D as n,E as r,F as i,I as a,L as o,M as s,N as c,O as l,P a
 } from '@forinda/kickjs'
 
 /**
- * Configuration for the ${a} plugin.
+ * Configuration for the ${o} plugin.
  *
  * Plugins typically take a small config object so callers can tune
  * behaviour at bootstrap time. Keep the shape narrow — anything
  * derived from the environment should be read inside the build
  * function via getEnv(), not forced onto the caller.
  */
-export interface ${a}PluginConfig {
+export interface ${o}PluginConfig {
   // Add your plugin config here, e.g.:
   // enabled?: boolean
   // apiKey?: string
 }
 
 /**
- * ${a} plugin — built via \`definePlugin()\` so callers get the
+ * ${o} plugin — built via \`definePlugin()\` so callers get the
  * factory's call / \`.scoped()\` / \`.async()\` surfaces for free.
  *
  * A plugin bundles DI bindings, modules, adapters, and middleware
@@ -59,16 +59,16 @@ export interface ${a}PluginConfig {
  * @example
  * \`\`\`ts
  * import { bootstrap } from '@forinda/kickjs'
- * import { ${a}Plugin } from './plugins/${i}.plugin'
+ * import { ${o}Plugin } from './plugins/${a}.plugin'
  *
  * export const app = await bootstrap({
  *   modules,
- *   plugins: [${a}Plugin({ /* config overrides *\\/ })],
+ *   plugins: [${o}Plugin({ /* config overrides *\\/ })],
  * })
  * \`\`\`
  */
-export const ${a}Plugin = definePlugin<${a}PluginConfig>({
-  name: '${a}Plugin',
+export const ${o}Plugin = definePlugin<${o}PluginConfig>({
+  name: '${o}Plugin',
   defaults: {
     // Default config values go here
   },
@@ -131,12 +131,12 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
       return [
         // Example:
         // import { defineHttpContextDecorator } from '@forinda/kickjs'
-        // declare module '@forinda/kickjs' { interface ContextMeta { ${i}: { foo: string } } }
-        // const Load${a} = defineHttpContextDecorator({
-        //   key: '${i}',
-        //   resolve: (ctx) => ({ foo: ctx.req.headers['x-${i}'] as string }),
+        // declare module '@forinda/kickjs' { interface ContextMeta { ${a}: { foo: string } } }
+        // const Load${o} = defineHttpContextDecorator({
+        //   key: '${a}',
+        //   resolve: (ctx) => ({ foo: ctx.req.headers['x-${a}'] as string }),
         // })
-        // return [Load${a}.registration]
+        // return [Load${o}.registration]
       ]
     },
 
@@ -147,7 +147,7 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
      */
     async onReady(_container: Container): Promise<void> {
       // const log = _container.resolve(Logger)
-      // log.info('${a} plugin ready')
+      // log.info('${o} plugin ready')
     },
 
     /**
@@ -159,13 +159,13 @@ export const ${a}Plugin = definePlugin<${a}PluginConfig>({
     },
   }),
 })
-`),o.push(s),o}async function ut(e){let t=k(e.outDir,`kick.config.ts`),n=e.modulesDir??`src/modules`,r=e.defaultRepo??`inmemory`;return M(t)&&!e.force&&!await p({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
-  Skipped — existing kick.config.ts preserved.`),[]):(await d(t,`import { defineConfig } from '@forinda/kickjs-cli'
+`),s.push(c),s}async function ft(e){let n=j(e.outDir,`kick.config.ts`),i=e.modulesDir??`src/modules`,a=e.defaultRepo??`inmemory`;return P(n)&&!e.force&&!await r({message:`kick.config.ts already exists. Overwrite?`,initialValue:!1})?(console.log(`
+  Skipped — existing kick.config.ts preserved.`),[]):(await t(n,`import { defineConfig } from '@forinda/kickjs-cli'
 
 export default defineConfig({
   modules: {
-    dir: '${n}',
-    repo: '${r}',
+    dir: '${i}',
+    repo: '${a}',
     pluralize: true,
   },
 
@@ -197,219 +197,22 @@ export default defineConfig({
     },
   ],
 })
-`),[t])}const dt=new Set([`rest`,`ddd`,`cqrs`,`minimal`]);function ft(e,t){if(t)return t;try{let t=JSON.parse(P(k(e,`package.json`),`utf-8`));if(t.name)return t.name.replace(/^@[^/]+\//,``)}catch{}return e.split(`/`).findLast(Boolean)??`app`}function pt(e,t){if(t)return t;try{let t=JSON.parse(P(k(e,`package.json`),`utf-8`));if(t.packageManager)return t.packageManager.split(`@`)[0]}catch{}return`pnpm`}async function mt(e,t){if(t)return t;try{let t=(await w(e))?.pattern;if(t&&dt.has(t))return t}catch{}return`ddd`}async function ht(e){let t=e.only??`all`,n=ft(e.outDir,e.name),r=pt(e.outDir,e.pm),i=await mt(e.outDir,e.template),a=t===`agents`||t===`both`||t===`all`,o=t===`claude`||t===`both`||t===`all`,s=t===`skills`||t===`all`,c=[];a&&c.push({file:k(e.outDir,`AGENTS.md`),render:()=>oe(n,i,r)}),o&&c.push({file:k(e.outDir,`CLAUDE.md`),render:()=>ce(n,i,r)}),s&&c.push({file:k(e.outDir,`kickjs-skills.md`),render:()=>_(n,i,r)});let l=[];for(let{file:t,render:n}of c){if(M(t)&&!e.force&&!await p({message:`${t.replace(e.outDir+`/`,``)} already exists. Overwrite?`,initialValue:!1})){console.log(`  Skipped — existing ${t.replace(e.outDir+`/`,``)} preserved.`);continue}await d(t,n()),l.push(t)}return l}function z(e,t){if(e[t]!==`{`)return-1;let n=1;for(let r=t+1;r<e.length;r++){let t=e[r];if(t===`{`)n++;else if(t===`}`&&(n--,n===0))return r}return-1}function B(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=z(e,r);return i===-1?null:e.slice(r+1,i)}function V(e,t,n){let r=` `.repeat(n);return e.split(`
+`),[n])}const B=`.agents`,pt=new Set([`rest`,`ddd`,`cqrs`,`minimal`]);function mt(e,t){if(t)return t;try{let t=JSON.parse(F(j(e,`package.json`),`utf-8`));if(t.name)return t.name.replace(/^@[^/]+\//,``)}catch{}return e.split(`/`).findLast(Boolean)??`app`}function ht(e,t){if(t)return t;try{let t=JSON.parse(F(j(e,`package.json`),`utf-8`));if(t.packageManager)return t.packageManager.split(`@`)[0]}catch{}return`pnpm`}async function gt(e,t){if(t)return t;try{let t=(await E(e))?.pattern;if(t&&pt.has(t))return t}catch{}return`ddd`}async function _t(e){let n=e.only??`all`,i=mt(e.outDir,e.name),a=ht(e.outDir,e.pm),o=await gt(e.outDir,e.template),s=n===`agents`||n===`both`||n===`all`,c=n===`claude`||n===`both`||n===`all`,l=n===`skills`||n===`all`,u=n===`gemini`||n===`all`,d=n===`copilot`||n===`all`,f=[];if(s&&f.push({file:j(e.outDir,B,`AGENTS.md`),render:()=>ae(i,o,a)}),c&&f.push({file:j(e.outDir,`CLAUDE.md`),render:()=>se(i,o,a)}),l)for(let t of le(i,o,a))f.push({file:j(e.outDir,B,`skills`,t.slug,`SKILL.md`),render:()=>t.content});u&&f.push({file:j(e.outDir,B,`GEMINI.md`),render:()=>ne(i,o,a)}),d&&f.push({file:j(e.outDir,B,`COPILOT.md`),render:()=>v(i,o,a)});let p=[];for(let{file:n,render:i}of f){if(P(n)&&!e.force&&!await r({message:`${n.replace(e.outDir+`/`,``)} already exists. Overwrite?`,initialValue:!1})){console.log(`  Skipped — existing ${n.replace(e.outDir+`/`,``)} preserved.`);continue}await t(n,i()),p.push(n)}return p}function V(e,t){if(e[t]!==`{`)return-1;let n=1;for(let r=t+1;r<e.length;r++){let t=e[r];if(t===`{`)n++;else if(t===`}`&&(n--,n===0))return r}return-1}function H(e,t){let n=t.exec(e);if(!n)return null;let r=n.index+n[0].length-1,i=V(e,r);return i===-1?null:e.slice(r+1,i)}function U(e,t,n){let r=` `.repeat(n);return e.split(`
 `).map(e=>{if(e.trim()===``)return e;let n=RegExp(`^ {0,${t}}`);return r+e.replace(n,``)}).join(`
-`)}function gt(e){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`Container`&&e!==`type Container`&&e!==`type AppModule`&&e!==`AppModule`&&e!==`type ModuleRoutes`&&e!==`ModuleRoutes`);return n.includes(`defineModule`)||n.push(`defineModule`),`import { ${n.join(`, `)} } from '@forinda/kickjs'`})}function _t(e,t){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,n)=>{let r=n.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`defineModule`);return t.container&&!r.includes(`Container`)&&r.push(`Container`),t.appModule&&!r.some(e=>e===`AppModule`||e===`type AppModule`)&&r.push(`type AppModule`),t.moduleRoutes&&!r.some(e=>e===`ModuleRoutes`||e===`type ModuleRoutes`)&&r.push(`type ModuleRoutes`),t.contributorRegistrations&&!r.some(e=>e===`ContributorRegistrations`||e===`type ContributorRegistrations`)&&r.push(`type ContributorRegistrations`),`import { ${r.join(`, `)} } from '@forinda/kickjs'`})}function vt(e){if(/\bdefineModule\s*\(/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+class\s+(\w+Module)\s+implements\s+AppModule\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no class form detected`};if(t.length>1)return{migrated:null,reason:`multiple module classes in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=z(e,i);if(a===-1)return{migrated:null,reason:`unbalanced class braces`};let o=e.slice(i+1,a),s=e.slice(0,n.index),c=e.slice(a+1),l=B(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=B(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=B(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=gt(s),p=``;return l&&(p+=`    register(container) {${V(l,4,6)}    },\n\n`),u&&(p+=`    contributors() {${V(u,4,6)}    },\n\n`),p+=`    routes() {${V(d,4,6)}    },`,{migrated:`${f}${`export const ${r} = defineModule({
+`)}function vt(e){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,t)=>{let n=t.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`Container`&&e!==`type Container`&&e!==`type AppModule`&&e!==`AppModule`&&e!==`type ModuleRoutes`&&e!==`ModuleRoutes`);return n.includes(`defineModule`)||n.push(`defineModule`),`import { ${n.join(`, `)} } from '@forinda/kickjs'`})}function yt(e,t){return e.replaceAll(/import\s*\{\s*([^}]+)\s*\}\s*from\s*'@forinda\/kickjs'/g,(e,n)=>{let r=n.split(`,`).map(e=>e.trim()).filter(e=>e&&e!==`defineModule`);return t.container&&!r.includes(`Container`)&&r.push(`Container`),t.appModule&&!r.some(e=>e===`AppModule`||e===`type AppModule`)&&r.push(`type AppModule`),t.moduleRoutes&&!r.some(e=>e===`ModuleRoutes`||e===`type ModuleRoutes`)&&r.push(`type ModuleRoutes`),t.contributorRegistrations&&!r.some(e=>e===`ContributorRegistrations`||e===`type ContributorRegistrations`)&&r.push(`type ContributorRegistrations`),`import { ${r.join(`, `)} } from '@forinda/kickjs'`})}function bt(e){if(/\bdefineModule\s*\(/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+class\s+(\w+Module)\s+implements\s+AppModule\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no class form detected`};if(t.length>1)return{migrated:null,reason:`multiple module classes in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=V(e,i);if(a===-1)return{migrated:null,reason:`unbalanced class braces`};let o=e.slice(i+1,a),s=e.slice(0,n.index),c=e.slice(a+1),l=H(o,/register\s*\(([^)]*)\)\s*:\s*void\s*\{/),u=H(o,/contributors\s*\(\s*\)\s*:\s*ContributorRegistrations\s*\{/),d=H(o,/routes\s*\(\s*\)\s*:\s*[A-Za-z|[\]\s]+\{/);if(!d)return{migrated:null,reason:`routes() method missing or signature unrecognized`};let f=vt(s),p=``;return l&&(p+=`    register(container) {${U(l,4,6)}    },\n\n`),u&&(p+=`    contributors() {${U(u,4,6)}    },\n\n`),p+=`    routes() {${U(d,4,6)}    },`,{migrated:`${f}${`export const ${r} = defineModule({
   name: '${r}',
   build: () => ({
 ${p}
   }),
-})`}${c}`}}function yt(e){if(/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+const\s+(\w+Module)\s*=\s*defineModule\s*\(\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no defineModule form detected`};if(t.length>1)return{migrated:null,reason:`multiple defineModule blocks in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=z(e,i);if(a===-1)return{migrated:null,reason:`unbalanced defineModule braces`};let o=e.indexOf(`)`,a);if(o===-1)return{migrated:null,reason:`unbalanced defineModule call parens`};let s=e.slice(i+1,a),c=e.slice(0,n.index),l=o+1;for(;l<e.length&&(e[l]===`
-`||e[l]===`\r`);)l++;let u=e.slice(l),d=/build\s*:\s*\([^)]*\)\s*=>\s*\(\s*\{/g.exec(s);if(!d)return{migrated:null,reason:`build: () => ({...}) not found in defineModule`};let f=d.index+d[0].length-1,p=z(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=B(m,/register\s*\(([^)]*)\)\s*\{/),g=B(m,/contributors\s*\(\s*\)\s*\{/),_=B(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let ee=_t(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),v=``;return h!==null&&(v+=`  register(container: Container): void {${V(h,6,4)}  }\n\n`),g!==null&&(v+=`  contributors(): ContributorRegistrations {${V(g,6,4)}  }\n\n`),v+=`  routes(): ModuleRoutes {${V(_,6,4)}  }`,{migrated:`${ee}${`export class ${r} implements AppModule {
-${v}
+})`}${c}`}}function xt(e){if(/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/.test(e))return{migrated:null,reason:`already in target form`};let t=[...e.matchAll(/export\s+const\s+(\w+Module)\s*=\s*defineModule\s*\(\s*\{/g)];if(t.length===0)return{migrated:null,reason:`no defineModule form detected`};if(t.length>1)return{migrated:null,reason:`multiple defineModule blocks in one file — migrate manually`};let n=t[0],r=n[1],i=n.index+n[0].length-1,a=V(e,i);if(a===-1)return{migrated:null,reason:`unbalanced defineModule braces`};let o=e.indexOf(`)`,a);if(o===-1)return{migrated:null,reason:`unbalanced defineModule call parens`};let s=e.slice(i+1,a),c=e.slice(0,n.index),l=o+1;for(;l<e.length&&(e[l]===`
+`||e[l]===`\r`);)l++;let u=e.slice(l),d=/build\s*:\s*\([^)]*\)\s*=>\s*\(\s*\{/g.exec(s);if(!d)return{migrated:null,reason:`build: () => ({...}) not found in defineModule`};let f=d.index+d[0].length-1,p=V(s,f);if(p===-1)return{migrated:null,reason:`unbalanced build() braces`};let m=s.slice(f+1,p),h=H(m,/register\s*\(([^)]*)\)\s*\{/),g=H(m,/contributors\s*\(\s*\)\s*\{/),_=H(m,/routes\s*\(\s*\)\s*\{/);if(!_)return{migrated:null,reason:`routes() method missing inside build()`};let v=yt(c,{container:h!==null,appModule:!0,moduleRoutes:!0,contributorRegistrations:g!==null}),y=``;return h!==null&&(y+=`  register(container: Container): void {${U(h,6,4)}  }\n\n`),g!==null&&(y+=`  contributors(): ContributorRegistrations {${U(g,6,4)}  }\n\n`),y+=`  routes(): ModuleRoutes {${U(_,6,4)}  }`,{migrated:`${v}${`export class ${r} implements AppModule {
+${y}
 }
-`}${u}`}}function bt(e,t){return t===`class`?yt(e):vt(e)}function xt(e,t){let n=e,r=!1;if(t===`define`){/\bAppModuleClass\b/.test(n)&&(n=n.replaceAll(/\bAppModuleClass\b/g,`AppModuleEntry`),r=!0);let e=/(=\s*\[)([\s\S]*?)(])/,t=e.exec(n);if(t){let i=t[1],a=t[3],o=t[2],s=o.replaceAll(/(\b\w+Module)(?![(.])/g,`$1()`);s!==o&&(n=n.replace(e,`${i}${s}${a}`),r=!0)}}else{/\bAppModuleEntry\b/.test(n)&&(n=n.replaceAll(/\bAppModuleEntry\b/g,`AppModuleClass`),r=!0);let e=/(=\s*\[)([\s\S]*?)(])/,t=e.exec(n);if(t){let i=t[1],a=t[3],o=t[2],s=o.replaceAll(/(\b\w+Module)\s*\(\s*\)/g,`$1`);s!==o&&(n=n.replace(e,`${i}${s}${a}`),r=!0)}}return r?{migrated:n}:{migrated:null,reason:`no changes needed`}}async function St(e){let t=[];return await n(j(e),0),t;async function n(e,r){let i;try{i=await Me(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=k(e,a),o;try{o=await Pe(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function Ct(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await Me(e)}catch{return}await je(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=k(e,a),o=k(t,a),s;try{s=await Pe(i)}catch{continue}s.isDirectory()?await r(i,o):(await Ae(i,o),n++)}}}function wt(e){return k(e,`.kickjs`,`codemod-backups`,`${new Date().toISOString().replaceAll(/[:.]/g,`-`)}-modules`)}async function Tt(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await St(e),s=await F(k(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=wt(r),await Ct(e,c));let l=[];for(let e of o){let t=bt(await F(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await I(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=k(e,`index.ts`),d=null;try{d=await F(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=xt(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await I(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function Et(e,t){let n=await St(e),r=[],i=t===`define`?/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/:/export\s+const\s+\w+Module\s*=\s*defineModule\s*\(/;for(let e of n){let t=await F(e,`utf-8`);i.test(t)&&r.push(e)}return r}async function Dt(e={}){let t=e.strategy??`jwt`,n=e.outDir??`src/modules/auth`,r=k(n,`dto`),i=[],a=k(n,`auth.module.ts`);await d(a,`import { Module } from '@forinda/kickjs'
-import { AuthController } from './auth.controller'
-import { AuthService } from './auth.service'
-
-@Module({
-  controllers: [AuthController],
-  services: [AuthService],
-})
-export class AuthModule {}
-`),i.push(a);let o=k(n,`auth.controller.ts`);await d(o,t===`jwt`?Ot():At()),i.push(o);let s=k(n,`auth.service.ts`);await d(s,t===`jwt`?kt():jt()),i.push(s);let c=k(r,`register.dto.ts`);await d(c,`import { z } from 'zod'
-
-export const RegisterDto = z.object({
-  email: z.string().email(),
-  password: z.string().min(8),
-  name: z.string().min(1).optional(),
-})
-
-export type RegisterInput = z.infer<typeof RegisterDto>
-`),i.push(c);let l=k(r,`login.dto.ts`);await d(l,`import { z } from 'zod'
-
-export const LoginDto = z.object({
-  email: z.string().email(),
-  password: z.string().min(1),
-})
-
-export type LoginInput = z.infer<typeof LoginDto>
-`),i.push(l);let u=k(n,`auth.test.ts`);if(await d(u,`import { describe, it, expect } from 'vitest'
-
-describe('Auth Module', () => {
-  it.todo('POST /register — creates a new user')
-  it.todo('POST /login — returns token for valid credentials')
-  it.todo('POST /login — rejects invalid credentials')
-  it.todo('POST /logout — invalidates session/token')
-  it.todo('GET /me — returns authenticated user')
-})
-`),i.push(u),e.roleGuards!==!1){let e=k(n,`auth.guard.ts`);await d(e,`import { Roles } from '@forinda/kickjs-auth'
-
-/**
- * Role-based access guard.
- * Usage: @Roles('admin') on a controller method.
- *
- * The AuthAdapter extracts the user's roles from the JWT/session
- * and the framework checks them automatically.
- */
-export const AdminOnly = Roles('admin')
-export const ManagerOnly = Roles('manager')
-`),i.push(e)}return i}function Ot(){return`import { Controller, Post, Get } from '@forinda/kickjs'
-import { Authenticated, Public } from '@forinda/kickjs-auth'
-import type { RequestContext } from '@forinda/kickjs'
-import { Autowired } from '@forinda/kickjs'
-import { AuthService } from './auth.service'
-
-@Controller()
-@Authenticated()
-export class AuthController {
-  @Autowired() private authService!: AuthService
-
-  @Post('/register')
-  @Public()
-  async register(ctx: RequestContext) {
-    const result = await this.authService.register(ctx.body)
-    return ctx.created(result)
-  }
-
-  @Post('/login')
-  @Public()
-  async login(ctx: RequestContext) {
-    const result = await this.authService.login(ctx.body)
-    if (!result) return ctx.badRequest('Invalid credentials')
-    return ctx.json(result)
-  }
-
-  @Post('/logout')
-  async logout(ctx: RequestContext) {
-    return ctx.json({ message: 'Logged out' })
-  }
-
-  @Get('/me')
-  async me(ctx: RequestContext) {
-    return ctx.json({ user: ctx.user })
-  }
-}
-`}function kt(){return`import { Service, Autowired } from '@forinda/kickjs'
-import { PasswordService } from '@forinda/kickjs-auth'
-import type { RegisterInput } from './dto/register.dto'
-import type { LoginInput } from './dto/login.dto'
-
-// TODO: Replace with your User repository
-const users = new Map<string, { id: string; email: string; name?: string; passwordHash: string }>()
-
-@Service()
-export class AuthService {
-  @Autowired() private password!: PasswordService
-
-  async register(input: RegisterInput) {
-    const { email, password, name } = input
-
-    if (users.has(email)) {
-      throw new Error('User already exists')
-    }
-
-    const passwordHash = await this.password.hash(password)
-    const id = crypto.randomUUID()
-    users.set(email, { id, email, name, passwordHash })
-
-    return { id, email, name }
-  }
-
-  async login(input: LoginInput) {
-    const { email, password } = input
-    const user = users.get(email)
-    if (!user) return null
-
-    const valid = await this.password.verify(user.passwordHash, password)
-    if (!valid) return null
-
-    // TODO: Generate JWT token here
-    // const token = jwt.sign({ sub: user.id, email: user.email }, process.env.JWT_SECRET!)
-    return { user: { id: user.id, email: user.email, name: user.name } }
-  }
-}
-`}function At(){return`import { Controller, Post, Get } from '@forinda/kickjs'
-import { Authenticated, Public } from '@forinda/kickjs-auth'
-import { sessionLogin, sessionLogout } from '@forinda/kickjs-auth'
-import type { RequestContext } from '@forinda/kickjs'
-import { Autowired } from '@forinda/kickjs'
-import { AuthService } from './auth.service'
-
-@Controller()
-@Authenticated()
-export class AuthController {
-  @Autowired() private authService!: AuthService
-
-  @Post('/register')
-  @Public()
-  async register(ctx: RequestContext) {
-    const result = await this.authService.register(ctx.body)
-    return ctx.created(result)
-  }
-
-  @Post('/login')
-  @Public()
-  async login(ctx: RequestContext) {
-    const user = await this.authService.login(ctx.body)
-    if (!user) return ctx.badRequest('Invalid credentials')
-    await sessionLogin(ctx.session, user)
-    return ctx.json({ message: 'Logged in', user })
-  }
-
-  @Post('/logout')
-  async logout(ctx: RequestContext) {
-    await sessionLogout(ctx.session)
-    return ctx.json({ message: 'Logged out' })
-  }
-
-  @Get('/me')
-  async me(ctx: RequestContext) {
-    return ctx.json({ user: ctx.user })
-  }
-}
-`}function jt(){return`import { Service, Autowired } from '@forinda/kickjs'
-import { PasswordService } from '@forinda/kickjs-auth'
-import type { RegisterInput } from './dto/register.dto'
-import type { LoginInput } from './dto/login.dto'
-
-// TODO: Replace with your User repository
-const users = new Map<string, { id: string; email: string; name?: string; passwordHash: string }>()
-
-@Service()
-export class AuthService {
-  @Autowired() private password!: PasswordService
-
-  async register(input: RegisterInput) {
-    const { email, password, name } = input
-
-    if (users.has(email)) {
-      throw new Error('User already exists')
-    }
-
-    const passwordHash = await this.password.hash(password)
-    const id = crypto.randomUUID()
-    users.set(email, { id, email, name, passwordHash })
-
-    return { id, email, name }
-  }
-
-  async login(input: LoginInput) {
-    const { email, password } = input
-    const user = users.get(email)
-    if (!user) return null
-
-    const valid = await this.password.verify(user.passwordHash, password)
-    if (!valid) return null
-
-    return { id: user.id, email: user.email, name: user.name }
-  }
-}
-`}async function Mt(e){let{name:n,outDir:r}=e,i=x(n),a=t(n),o=f(n),s=e.queue??`${a}-queue`,c=[];return await(async(e,t)=>{let n=k(r,e);await d(n,t),c.push(n)})(`${a}.job.ts`,`import { Inject } from '@forinda/kickjs'
+`}${u}`}}function St(e,t){return t===`class`?xt(e):bt(e)}function Ct(e,t){let n=e,r=!1;if(t===`define`){/\bAppModuleClass\b/.test(n)&&(n=n.replaceAll(/\bAppModuleClass\b/g,`AppModuleEntry`),r=!0);let e=/(=\s*\[)([\s\S]*?)(])/,t=e.exec(n);if(t){let i=t[1],a=t[3],o=t[2],s=o.replaceAll(/(\b\w+Module)(?![(.])/g,`$1()`);s!==o&&(n=n.replace(e,`${i}${s}${a}`),r=!0)}}else{/\bAppModuleEntry\b/.test(n)&&(n=n.replaceAll(/\bAppModuleEntry\b/g,`AppModuleClass`),r=!0);let e=/(=\s*\[)([\s\S]*?)(])/,t=e.exec(n);if(t){let i=t[1],a=t[3],o=t[2],s=o.replaceAll(/(\b\w+Module)\s*\(\s*\)/g,`$1`);s!==o&&(n=n.replace(e,`${i}${s}${a}`),r=!0)}}return r?{migrated:n}:{migrated:null,reason:`no changes needed`}}async function wt(e){let t=[];return await n(N(e),0),t;async function n(e,r){let i;try{i=await Pe(e)}catch{return}for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=j(e,a),o;try{o=await Ie(i)}catch{continue}o.isDirectory()?await n(i,r+1):(a.endsWith(`.module.ts`)||a===`index.ts`&&r===1)&&t.push(i)}}}async function Tt(e,t){let n=0;return await r(e,t),n;async function r(e,t){let i;try{i=await Pe(e)}catch{return}await Ne(t,{recursive:!0});for(let a of i){if(a===`node_modules`||a===`dist`||a===`.kickjs`)continue;let i=j(e,a),o=j(t,a),s;try{s=await Ie(i)}catch{continue}s.isDirectory()?await r(i,o):(await Me(i,o),n++)}}}function Et(e){return j(e,`.kickjs`,`codemod-backups`,`${new Date().toISOString().replaceAll(/[:.]/g,`-`)}-modules`)}async function Dt(e,t){let{dryRun:n=!1,cwd:r=process.cwd(),target:i}=t,a=t.backup??!n,o=await wt(e),s=await I(j(e,`index.ts`),`utf-8`).then(()=>!0,()=>!1),c=null;a&&(o.length>0||s)&&(c=Et(r),await Tt(e,c));let l=[];for(let e of o){let t=St(await I(e,`utf-8`),i);if(t.migrated==null){l.push({path:e,status:`skipped`,reason:t.reason});continue}n||await L(e,t.migrated,`utf-8`),l.push({path:e,status:`migrated`})}let u=j(e,`index.ts`),d=null;try{d=await I(u,`utf-8`)}catch{return{target:i,files:l,indexStatus:`not-found`,indexPath:u,backupDir:c}}let f=Ct(d,i);return f.migrated==null?{target:i,files:l,indexStatus:`skipped`,indexPath:u,indexReason:f.reason,backupDir:c}:(n||await L(u,f.migrated,`utf-8`),{target:i,files:l,indexStatus:`migrated`,indexPath:u,backupDir:c})}async function Ot(e,t){let n=await wt(e),r=[],i=t===`define`?/export\s+class\s+\w+Module\s+implements\s+AppModule\s*\{/:/export\s+const\s+\w+Module\s*=\s*defineModule\s*\(/;for(let e of n){let t=await I(e,`utf-8`);i.test(t)&&r.push(e)}return r}async function kt(e){let{name:n,outDir:r}=e,a=i(n),o=m(n),s=de(n),c=e.queue??`${o}-queue`,l=[];return await(async(e,n)=>{let i=j(r,e);await t(i,n),l.push(i)})(`${o}.job.ts`,`import { Inject } from '@forinda/kickjs'
 import { Job, Process, QUEUE_MANAGER, type QueueService } from '@forinda/kickjs-queue'
 
 /**
- * ${i} Job Processor
+ * ${a} Job Processor
  *
  * Decorators:
  *   @Job(queueName) — marks this class as a job processor for a queue
@@ -419,10 +222,10 @@ import { Job, Process, QUEUE_MANAGER, type QueueService } from '@forinda/kickjs-
  *
  * To add jobs to this queue from a service or controller:
  *   @Inject(QUEUE_MANAGER) private queue: QueueService
- *   await this.queue.add('${s}', '${o}', { ... })
+ *   await this.queue.add('${c}', '${s}', { ... })
  */
-@Job('${s}')
-export class ${i}Job {
+@Job('${c}')
+export class ${a}Job {
   @Process()
   async handle(job: { name: string; data: any; id?: string }) {
     console.log(\`Processing \${job.name} (id: \${job.id})\`, job.data)
@@ -432,13 +235,13 @@ export class ${i}Job {
     // await this.emailService.send(job.data.to, job.data.subject, job.data.body)
   }
 
-  @Process('${o}.priority')
+  @Process('${s}.priority')
   async handlePriority(job: { name: string; data: any; id?: string }) {
     console.log(\`Priority job: \${job.name}\`, job.data)
     // Handle high-priority variant of this job
   }
 }
-`),c}const Nt={string:{ts:`string`,zod:`z.string()`},text:{ts:`string`,zod:`z.string()`},number:{ts:`number`,zod:`z.number()`},int:{ts:`number`,zod:`z.number().int()`},float:{ts:`number`,zod:`z.number()`},boolean:{ts:`boolean`,zod:`z.boolean()`},date:{ts:`string`,zod:`z.string().datetime()`},email:{ts:`string`,zod:`z.string().email()`},url:{ts:`string`,zod:`z.string().url()`},uuid:{ts:`string`,zod:`z.string().uuid()`},json:{ts:`any`,zod:`z.any()`}};function Pt(e){return e.map(e=>{let t=e.indexOf(`:`);if(t===-1)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let n=e.slice(0,t),r=e.slice(t+1);if(!n||!r)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let i=!1;r.endsWith(`:optional`)&&(r=r.slice(0,-9),i=!0),n.endsWith(`?`)&&(n=n.slice(0,-1),i=!0),r.endsWith(`?`)&&(r=r.slice(0,-1),i=!0);let a=r;if(a.startsWith(`enum:`)){let e=a.slice(5).split(`,`);return{name:n,type:`enum`,tsType:e.map(e=>`'${e}'`).join(` | `),zodType:`z.enum([${e.map(e=>`'${e}'`).join(`, `)}])`,optional:i}}let o=Nt[a];if(!o){let e=[...Object.keys(Nt),`enum:a,b,c`].join(`, `);throw Error(`Unknown field type: "${a}". Valid types: ${e}`)}return{name:n,type:a,tsType:o.ts,zodType:o.zod,optional:i}})}async function Ft(e){let{name:n,fields:r,modulesDir:i,noEntity:a,noTests:o,repo:s=`inmemory`,tokenScope:c=`app`,style:l=`define`}=e,u=e.pluralize!==!1,p=t(n),m=x(n);f(n);let h=u?g(p):p,_=u?fe(m):m,ee=k(i,h),v=[],y=async(e,t)=>{let n=k(ee,e);await d(n,t),v.push(n)};await y(`${p}.module.ts`,Ut(m,p,h,l)),await y(`constants.ts`,zt(m,r)),await y(`presentation/${p}.controller.ts`,Wt(m,p,h,_)),await y(`application/dtos/create-${p}.dto.ts`,It(m,r)),await y(`application/dtos/update-${p}.dto.ts`,Lt(m,r)),await y(`application/dtos/${p}-response.dto.ts`,Rt(m,r));let ne=qt(m,p,h,_);for(let e of ne)await y(`application/use-cases/${e.file}`,e.content);return await y(`domain/repositories/${p}.repository.ts`,Gt(m,p,c)),await y(`domain/services/${p}-domain.service.ts`,Kt(m,p)),s===`inmemory`&&await y(`infrastructure/repositories/in-memory-${p}.repository.ts`,Bt(m,p,r)),a||(await y(`domain/entities/${p}.entity.ts`,Vt(m,p,r)),await y(`domain/value-objects/${p}-id.vo.ts`,Ht(m))),await te(i,m,h,p,l),v}function It(e,t){return`import { z } from 'zod'
+`),l}const At={string:{ts:`string`,zod:`z.string()`},text:{ts:`string`,zod:`z.string()`},number:{ts:`number`,zod:`z.number()`},int:{ts:`number`,zod:`z.number().int()`},float:{ts:`number`,zod:`z.number()`},boolean:{ts:`boolean`,zod:`z.boolean()`},date:{ts:`string`,zod:`z.string().datetime()`},email:{ts:`string`,zod:`z.string().email()`},url:{ts:`string`,zod:`z.string().url()`},uuid:{ts:`string`,zod:`z.string().uuid()`},json:{ts:`any`,zod:`z.any()`}};function jt(e){return e.map(e=>{let t=e.indexOf(`:`);if(t===-1)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let n=e.slice(0,t),r=e.slice(t+1);if(!n||!r)throw Error(`Invalid field: "${e}". Use format: name:type (e.g. title:string)`);let i=!1;r.endsWith(`:optional`)&&(r=r.slice(0,-9),i=!0),n.endsWith(`?`)&&(n=n.slice(0,-1),i=!0),r.endsWith(`?`)&&(r=r.slice(0,-1),i=!0);let a=r;if(a.startsWith(`enum:`)){let e=a.slice(5).split(`,`);return{name:n,type:`enum`,tsType:e.map(e=>`'${e}'`).join(` | `),zodType:`z.enum([${e.map(e=>`'${e}'`).join(`, `)}])`,optional:i}}let o=At[a];if(!o){let e=[...Object.keys(At),`enum:a,b,c`].join(`, `);throw Error(`Unknown field type: "${a}". Valid types: ${e}`)}return{name:n,type:a,tsType:o.ts,zodType:o.zod,optional:i}})}async function Mt(e){let{name:r,fields:a,modulesDir:o,noEntity:s,noTests:c,repo:l=`inmemory`,tokenScope:u=`app`,style:d=`define`}=e,f=e.pluralize!==!1,g=m(r),_=i(r);de(r);let v=f?p(g):g,y=f?n(_):_,ee=j(o,v),te=[],b=async(e,n)=>{let r=j(ee,e);await t(r,n),te.push(r)};await b(`${g}.module.ts`,Bt(_,g,v,d)),await b(`constants.ts`,It(_,a)),await b(`presentation/${g}.controller.ts`,Vt(_,g,v,y)),await b(`application/dtos/create-${g}.dto.ts`,Nt(_,a)),await b(`application/dtos/update-${g}.dto.ts`,Pt(_,a)),await b(`application/dtos/${g}-response.dto.ts`,Ft(_,a));let x=Wt(_,g,v,y);for(let e of x)await b(`application/use-cases/${e.file}`,e.content);return await b(`domain/repositories/${g}.repository.ts`,Ht(_,g,u)),await b(`domain/services/${g}-domain.service.ts`,Ut(_,g)),l===`inmemory`&&await b(`infrastructure/repositories/in-memory-${g}.repository.ts`,Lt(_,g,a)),s||(await b(`domain/entities/${g}.entity.ts`,Rt(_,g,a)),await b(`domain/value-objects/${g}-id.vo.ts`,zt(_))),await h(o,_,v,g,d),te}function Nt(e,t){return`import { z } from 'zod'
 
 export const create${e}Schema = z.object({
 ${t.map(e=>{let t=e.zodType;return`  ${e.name}: ${t}${e.optional?`.optional()`:``},`}).join(`
@@ -446,7 +249,7 @@ ${t.map(e=>{let t=e.zodType;return`  ${e.name}: ${t}${e.optional?`.optional()`:`
 })
 
 export type Create${e}DTO = z.infer<typeof create${e}Schema>
-`}function Lt(e,t){return`import { z } from 'zod'
+`}function Pt(e,t){return`import { z } from 'zod'
 
 export const update${e}Schema = z.object({
 ${t.map(e=>`  ${e.name}: ${e.zodType}.optional(),`).join(`
@@ -454,21 +257,21 @@ ${t.map(e=>`  ${e.name}: ${e.zodType}.optional(),`).join(`
 })
 
 export type Update${e}DTO = z.infer<typeof update${e}Schema>
-`}function Rt(e,t){return`export interface ${e}ResponseDTO {
+`}function Ft(e,t){return`export interface ${e}ResponseDTO {
   id: string
 ${t.map(e=>`  ${e.name}${e.optional?`?`:``}: ${e.tsType}`).join(`
 `)}
   createdAt: string
   updatedAt: string
 }
-`}function zt(e,t){let n=t.filter(e=>e.tsType===`string`).map(e=>`'${e.name}'`);t.filter(e=>e.tsType===`number`).map(e=>`'${e.name}'`);let r=t.map(e=>`'${e.name}'`),i=[...r].join(`, `),a=[...r,`'createdAt'`,`'updatedAt'`].join(`, `),o=n.length>0?n.join(`, `):`'name'`;return`import type { ApiQueryParamsConfig } from '@forinda/kickjs'
+`}function It(e,t){let n=t.filter(e=>e.tsType===`string`).map(e=>`'${e.name}'`);t.filter(e=>e.tsType===`number`).map(e=>`'${e.name}'`);let r=t.map(e=>`'${e.name}'`),i=[...r].join(`, `),a=[...r,`'createdAt'`,`'updatedAt'`].join(`, `),o=n.length>0?n.join(`, `):`'name'`;return`import type { ApiQueryParamsConfig } from '@forinda/kickjs'
 
 export const ${e.toUpperCase()}_QUERY_CONFIG: ApiQueryParamsConfig = {
   filterable: [${i}],
   sortable: [${a}],
   searchable: [${o}],
 }
-`}function Bt(e,t,n){return`import { randomUUID } from 'node:crypto'
+`}function Lt(e,t,n){return`import { randomUUID } from 'node:crypto'
 import { Repository, HttpException } from '@forinda/kickjs'
 import type { ParsedQuery } from '@forinda/kickjs'
 import type { I${e}Repository } from '../../domain/repositories/${t}.repository'
@@ -520,7 +323,7 @@ ${n.map(e=>`      ${e.name}: dto.${e.name},`).join(`
     this.store.delete(id)
   }
 }
-`}function Vt(e,t,n){return`import { ${e}Id } from '../value-objects/${t}-id.vo'
+`}function Rt(e,t,n){return`import { ${e}Id } from '../value-objects/${t}-id.vo'
 
 interface ${e}Props {
   id: ${e}Id
@@ -566,7 +369,7 @@ ${n.map(e=>`      ${e.name}: this.props.${e.name},`).join(`
     }
   }
 }
-`}function Ht(e){return`import { randomUUID } from 'node:crypto'
+`}function zt(e){return`import { randomUUID } from 'node:crypto'
 
 export class ${e}Id {
   private constructor(private readonly value: string) {}
@@ -581,7 +384,7 @@ export class ${e}Id {
   toString(): string { return this.value }
   equals(other: ${e}Id): boolean { return this.value === other.value }
 }
-`}function Ut(e,t,n,r=`define`){let i=`import { ${e}Controller } from './presentation/${t}.controller'
+`}function Bt(e,t,n,r=`define`){let i=`import { ${e}Controller } from './presentation/${t}.controller'
 import { ${e.toUpperCase()}_REPOSITORY } from './domain/repositories/${t}.repository'
 import { InMemory${e}Repository } from './infrastructure/repositories/in-memory-${t}.repository'
 
@@ -654,7 +457,7 @@ ${a}
     },
   }),
 })
-`}function Wt(e,t,n,r){return`import { Controller, Get, Post, Put, Delete, Autowired, ApiQueryParams, type Ctx } from '@forinda/kickjs'
+`}function Vt(e,t,n,r){return`import { Controller, Get, Post, Put, Delete, Autowired, ApiQueryParams, type Ctx } from '@forinda/kickjs'
 import { ApiTags } from '@forinda/kickjs-swagger'
 import { Create${e}UseCase } from '../application/use-cases/create-${t}.use-case'
 import { Get${e}UseCase } from '../application/use-cases/get-${t}.use-case'
@@ -717,7 +520,7 @@ export class ${e}Controller {
     ctx.noContent()
   }
 }
-`}function Gt(e,t,n){return`import { createToken } from '@forinda/kickjs'
+`}function Ht(e,t,n){return`import { createToken } from '@forinda/kickjs'
 import type { ${e}ResponseDTO } from '../../application/dtos/${t}-response.dto'
 import type { Create${e}DTO } from '../../application/dtos/create-${t}.dto'
 import type { Update${e}DTO } from '../../application/dtos/update-${t}.dto'
@@ -743,7 +546,7 @@ export interface I${e}Repository {
  * adopters must NOT use the reserved \`'kick/'\` namespace.
  */
 export const ${e.toUpperCase()}_REPOSITORY = createToken<I${e}Repository>('${n}/${e}/repository')
-`}function Kt(e,t){return`import { Service, Inject, HttpException } from '@forinda/kickjs'
+`}function Ut(e,t){return`import { Service, Inject, HttpException } from '@forinda/kickjs'
 import { ${e.toUpperCase()}_REPOSITORY, type I${e}Repository } from '../repositories/${t}.repository'
 
 @Service()
@@ -757,7 +560,7 @@ export class ${e}DomainService {
     if (!entity) throw HttpException.notFound('${e} not found')
   }
 }
-`}function qt(e,t,n,r){return[{file:`create-${t}.use-case.ts`,content:`import { Service, Inject } from '@forinda/kickjs'
+`}function Wt(e,t,n,r){return[{file:`create-${t}.use-case.ts`,content:`import { Service, Inject } from '@forinda/kickjs'
 import { ${e.toUpperCase()}_REPOSITORY, type I${e}Repository } from '../../domain/repositories/${t}.repository'
 import type { Create${e}DTO } from '../dtos/create-${t}.dto'
 
@@ -800,10 +603,10 @@ export class Delete${e}UseCase {
   constructor(@Inject(${e.toUpperCase()}_REPOSITORY) private repo: I${e}Repository) {}
   async execute(id: string) { return this.repo.delete(id) }
 }
-`}]}async function Jt(e){let{name:n,moduleName:r,modulesDir:i}=e,a=e.pluralize??!0,o=t(n),s=x(n),c=[],l;if(e.outDir)l=j(e.outDir);else if(r){let e=t(r),n=a?g(e):e;l=j(k(i??`src/modules`,n,`__tests__`))}else l=j(`src/__tests__`);let u=k(l,`${o}.test.ts`);return await d(u,`import { describe, it, expect, beforeEach } from 'vitest'
+`}]}async function Gt(e){let{name:n,moduleName:r,modulesDir:a}=e,o=e.pluralize??!0,s=m(n),c=i(n),l=[],u;if(e.outDir)u=N(e.outDir);else if(r){let e=m(r),t=o?p(e):e;u=N(j(a??`src/modules`,t,`__tests__`))}else u=N(`src/__tests__`);let d=j(u,`${s}.test.ts`);return await t(d,`import { describe, it, expect, beforeEach } from 'vitest'
 import { Container } from '@forinda/kickjs'
 
-describe('${s}', () => {
+describe('${c}', () => {
   beforeEach(() => {
     Container.reset()
   })
@@ -823,59 +626,58 @@ describe('${s}', () => {
     expect(true).toBe(true)
   })
 })
-`),c.push(u),c}const Yt=[`agents`,`claude`,`skills`,`both`,`all`];function H(e){return e.parent?.opts()?.dryRun??!1}function U(e,t=!1){let n=process.cwd();console.log(`\n  ${t?`Would generate`:`Generated`} ${e.length} file${e.length===1?``:`s`}:`);for(let t of e)console.log(`    ${t.replace(n+`/`,``)}`);t&&console.log(`
-  (dry run — no files were written)`),console.log()}async function Xt(e){if(!e)try{let e=await w(process.cwd());await E({cwd:process.cwd(),allowDuplicates:!0,silent:!0,schemaValidator:e?.typegen?.schemaValidator??`zod`,envFile:e?.typegen?.envFile,srcDir:e?.typegen?.srcDir,outDir:e?.typegen?.outDir})}catch{}}const Zt=[{name:`module <name>`,description:`Full DDD module (controller, DTOs, use-cases, repo)`},{name:`scaffold <name> <fields...>`,description:`CRUD module from field definitions`},{name:`controller <name>`,description:`@Controller() class            [-m module]`},{name:`service <name>`,description:`@Service() singleton             [-m module]`},{name:`middleware <name>`,description:`Express middleware function     [-m module]`},{name:`guard <name>`,description:`Route guard (auth, roles, etc.)  [-m module]`},{name:`dto <name>`,description:`Zod DTO schema                  [-m module]`},{name:`adapter <name>`,description:`AppAdapter with lifecycle hooks (app-level only)`},{name:`test <name>`,description:`Vitest test scaffold            [-m module]`},{name:`job <name>`,description:`Queue @Job processor`},{name:`config`,description:`Generate kick.config.ts`},{name:`agents`,description:`Regenerate AGENTS.md + CLAUDE.md + kickjs-skills.md from upstream templates`}];async function Qt(){console.log(`
+`),l.push(d),l}const Kt=[`agents`,`claude`,`skills`,`gemini`,`copilot`,`both`,`all`];function W(e){return e.parent?.opts()?.dryRun??!1}function G(e,t=!1){let n=process.cwd();console.log(`\n  ${t?`Would generate`:`Generated`} ${e.length} file${e.length===1?``:`s`}:`);for(let t of e)console.log(`    ${t.replace(n+`/`,``)}`);t&&console.log(`
+  (dry run — no files were written)`),console.log()}async function qt(e){if(!e)try{let e=await E(process.cwd());await O({cwd:process.cwd(),allowDuplicates:!0,silent:!0,schemaValidator:e?.typegen?.schemaValidator??`zod`,envFile:e?.typegen?.envFile,srcDir:e?.typegen?.srcDir,outDir:e?.typegen?.outDir})}catch{}}const Jt=[{name:`module <name>`,description:`Full DDD module (controller, DTOs, use-cases, repo)`},{name:`scaffold <name> <fields...>`,description:`CRUD module from field definitions`},{name:`controller <name>`,description:`@Controller() class            [-m module]`},{name:`service <name>`,description:`@Service() singleton             [-m module]`},{name:`middleware <name>`,description:`Express middleware function     [-m module]`},{name:`guard <name>`,description:`Route guard (auth, roles, etc.)  [-m module]`},{name:`dto <name>`,description:`Zod DTO schema                  [-m module]`},{name:`adapter <name>`,description:`AppAdapter with lifecycle hooks (app-level only)`},{name:`test <name>`,description:`Vitest test scaffold            [-m module]`},{name:`job <name>`,description:`Queue @Job processor`},{name:`config`,description:`Generate kick.config.ts`},{name:`agents`,description:`Regenerate AGENTS.md + CLAUDE.md + kickjs-skills.md from upstream templates`}];async function Yt(){console.log(`
   Built-in generators:
-`);let e=Math.max(...Zt.map(e=>e.name.length));for(let t of Zt)console.log(`    kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await w(process.cwd()),n=he(t?.plugins??[],t?.commands??[]),r=await le(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
+`);let e=Math.max(...Jt.map(e=>e.name.length));for(let t of Jt)console.log(`    kick g ${t.name.padEnd(e+2)} ${t.description}`);let t=await E(process.cwd()),n=ge(t?.plugins??[],t?.commands??[]),r=await ce(process.cwd(),n.generators);if(r.generators.length>0){console.log(`
   Plugin generators:
 `);let e=Math.max(...r.generators.map(e=>`${e.spec.name} <name>`.length));for(let{source:t,spec:n}of r.generators){let r=`${n.name} <name>`;console.log(`    kick g ${r.padEnd(e+2)} ${n.description}  [${t}]`)}}if(r.failed.length>0){console.log(`
   Failed to load:
-`);for(let{source:e,reason:t}of r.failed)console.log(`    ${e} — ${t}`)}console.log()}async function $t(e,t,n){let r=await w(process.cwd()),i=C(r),a=t.modulesDir??i.dir??`src/modules`,o=t.repo??de(i.repo),s=t.pattern??r?.pattern??`ddd`,c=t.pluralize===!1?!1:i.pluralize??!0,l=pe(r,process.cwd()),d=i.style??`define`;if(!n&&d===`define`){let e=await Et(j(a),`define`);if(e.length>0){console.error(`\n  ${u.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n  ${u.dim(`Project setting:`)} modules.style: 'define' (default)\n\n  ${u.bold(`Files needing migration:`)}`);for(let t of e.slice(0,5))console.error(`    - ${t}`);e.length>5&&console.error(`    … and ${e.length-5} more`),console.error(`\n  ${u.bold(`Pick one:`)}\n    1. Migrate everything to defineModule:\n       ${u.dim(`$`)} kick codemod modules --experimental --apply\n    2. Keep the class form — pin it in kick.config.ts:\n       ${u.dim(`// kick.config.ts`)}\n       ${u.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let f=[];for(let r of e){let e=await m({name:r,modulesDir:j(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:o,minimal:t.minimal,force:t.force,pattern:s,dryRun:n,pluralize:c,prismaClientPath:i.prismaClientPath,tokenScope:l,style:i.style});f.push(...e)}U(f,n),await Xt(n)}function en(t){let n=t.command(`generate [names...]`).alias(`g`).description("Generate code scaffolds — bare form `kick g <name>` is shorthand for `kick g module <name>`").option(`--list`,`List all available generators`).option(`--dry-run`,`Preview files that would be generated without writing them`).option(`--no-entity`,`Skip entity and value object generation (module shortcut)`).option(`--no-tests`,`Skip test file generation (module shortcut)`).option(`--repo <type>`,`Repository implementation: inmemory | drizzle | prisma`).option(`--pattern <pattern>`,`Override project pattern: rest | ddd | cqrs | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,r)=>{if(t.list){await Qt();return}if(!e||e.length===0){n.help();return}let i=H(r);if(o(i),e.length>=2){let[n,r,...a]=e,o=await w(process.cwd()),s=he(o?.plugins??[],o?.commands??[]),c=await ae({generatorName:n,itemName:r,args:a,flags:t,cwd:process.cwd()},s.generators);if(c){U(c.files,i);return}}await $t(e,t,i)});n.command(`module <names...>`).description(`Generate one or more modules (e.g. kick g module user task project)`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--repo <type>`,`Repository implementation: inmemory | drizzle | prisma`).option(`--pattern <pattern>`,`Override project pattern: rest | ddd | cqrs | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,n)=>{let r=H(n);o(r),await $t(e,{...n.optsWithGlobals(),...t},r)}),n.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(e,t,n)=>{let r=H(n);o(r),U(await ie({name:e,outDir:j(t.out)}),r)}),n.command(`plugin <name>`).description(`Generate a KickPlugin with DI, modules, adapters, middleware, and lifecycle hooks`).option(`-o, --out <dir>`,`Output directory`,`src/plugins`).action(async(e,t,n)=>{let r=H(n);o(r),U(await lt({name:e,outDir:j(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate an Express middleware function
-  Use -m to scope it to a module: kick g middleware auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=H(n);o(r);let i=await w(process.cwd()),a=C(i),s=a.dir??`src/modules`;U(await se({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
-  Use -m to scope it to a module: kick g guard admin -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=H(n);o(r);let i=await w(process.cwd()),a=C(i),s=a.dir??`src/modules`;U(await v({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
-  Use -m to scope it to a module: kick g service payment -m orders`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=H(n);o(r);let i=await w(process.cwd()),a=C(i),s=a.dir??`src/modules`;U(await ee({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
-  Use -m to scope it to a module: kick g controller auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=H(n);o(r);let i=await w(process.cwd()),a=C(i),s=a.dir??`src/modules`;U(await ue({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:i?.pattern,pluralize:a.pluralize??!0}),r),await Xt(r)}),n.command(`dto <name>`).description(`Generate a Zod DTO schema
-  Use -m to scope it to a module: kick g dto create-user -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=H(n);o(r);let i=await w(process.cwd()),a=C(i),s=a.dir??`src/modules`;U(await re({name:e,outDir:t.out,moduleName:t.module,modulesDir:s,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`test <name>`).description(`Generate a Vitest test scaffold
-  Use -m to scope it to a module: kick g test user-service -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module's __tests__/ folder`).action(async(e,t,n)=>{let r=H(n);o(r);let i=C(await w(process.cwd())),a=i.dir??`src/modules`;U(await Jt({name:e,outDir:t.out,moduleName:t.module,modulesDir:a,pluralize:i.pluralize??!0}),r)}),n.command(`job <name>`).description(`Generate a @Job queue processor with @Process handlers`).option(`-o, --out <dir>`,`Output directory`,`src/jobs`).option(`-q, --queue <name>`,`Queue name (default: <name>-queue)`).action(async(e,t,n)=>{let r=H(n);o(r),U(await Mt({name:e,outDir:j(t.out),queue:t.queue}),r)}),n.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
+`);for(let{source:e,reason:t}of r.failed)console.log(`    ${e} — ${t}`)}console.log()}async function Xt(e,t,n){let r=await E(process.cwd()),i=T(r),a=t.modulesDir??i.dir??`src/modules`,s=t.repo??_(i.repo),c=t.pattern??r?.pattern??`ddd`,l=t.pluralize===!1?!1:i.pluralize??!0,u=pe(r,process.cwd()),d=i.style??`define`;if(!n&&d===`define`){let e=await Ot(N(a),`define`);if(e.length>0){console.error(`\n  ${o.red(`Error:`)} ${e.length} module file(s) still use the legacy \`class … implements AppModule\` shape.\n  ${o.dim(`Project setting:`)} modules.style: 'define' (default)\n\n  ${o.bold(`Files needing migration:`)}`);for(let t of e.slice(0,5))console.error(`    - ${t}`);e.length>5&&console.error(`    … and ${e.length-5} more`),console.error(`\n  ${o.bold(`Pick one:`)}\n    1. Migrate everything to defineModule:\n       ${o.dim(`$`)} kick codemod modules --experimental --apply\n    2. Keep the class form — pin it in kick.config.ts:\n       ${o.dim(`// kick.config.ts`)}\n       ${o.dim(`export default defineConfig({ modules: { style: 'class' } })`)}\n`),process.exit(1)}}let f=[];for(let r of e){let e=await fe({name:r,modulesDir:N(a),noEntity:t.entity===!1,noTests:t.tests===!1,repo:s,minimal:t.minimal,force:t.force,pattern:c,dryRun:n,pluralize:l,prismaClientPath:i.prismaClientPath,tokenScope:u,style:i.style});f.push(...e)}G(f,n),await qt(n)}function Zt(e,t){let n=e.command(`generate [names...]`).alias(`g`).description("Generate code scaffolds — bare form `kick g <name>` is shorthand for `kick g module <name>`").option(`--list`,`List all available generators`).option(`--dry-run`,`Preview files that would be generated without writing them`).option(`--no-entity`,`Skip entity and value object generation (module shortcut)`).option(`--no-tests`,`Skip test file generation (module shortcut)`).option(`--repo <type>`,`Repository implementation: inmemory | drizzle | prisma`).option(`--pattern <pattern>`,`Override project pattern: rest | ddd | cqrs | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,r)=>{if(t.list){await Yt();return}if(!e||e.length===0){n.help();return}let i=W(r);w(i);let[a,o,...s]=e;if(a){let e=await E(process.cwd()),n=ge(e?.plugins??[],e?.commands??[]),r=await ie({generatorName:a,itemName:o??``,args:s,flags:t,cwd:process.cwd()},n.generators);if(r){G(r.files,i);return}}await Xt(e,t,i)});n.command(`module <names...>`).description(`Generate one or more modules (e.g. kick g module user task project)`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--repo <type>`,`Repository implementation: inmemory | drizzle | prisma`).option(`--pattern <pattern>`,`Override project pattern: rest | ddd | cqrs | minimal`).option(`--minimal`,`Shorthand for --pattern minimal`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t,n)=>{let r=W(n);w(r),await Xt(e,{...n.optsWithGlobals(),...t},r)}),n.command(`adapter <name>`).description(`Generate an AppAdapter with lifecycle hooks and middleware support`).option(`-o, --out <dir>`,`Output directory`,`src/adapters`).action(async(e,t,n)=>{let r=W(n);w(r),G(await te({name:e,outDir:N(t.out)}),r)}),n.command(`plugin <name>`).description(`Generate a KickPlugin with DI, modules, adapters, middleware, and lifecycle hooks`).option(`-o, --out <dir>`,`Output directory`,`src/plugins`).action(async(e,t,n)=>{let r=W(n);w(r),G(await dt({name:e,outDir:N(t.out)}),r)}),n.command(`middleware <name>`).description(`Generate an Express middleware function
+  Use -m to scope it to a module: kick g middleware auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=W(n);w(r);let i=await E(process.cwd()),a=T(i),o=a.dir??`src/modules`;G(await b({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`guard <name>`).description(`Generate a route guard (auth, roles, etc.)
+  Use -m to scope it to a module: kick g guard admin -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=W(n);w(r);let i=await E(process.cwd()),a=T(i),o=a.dir??`src/modules`;G(await re({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`service <name>`).description(`Generate a @Service() class
+  Use -m to scope it to a module: kick g service payment -m orders`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=W(n);w(r);let i=await E(process.cwd()),a=T(i),o=a.dir??`src/modules`;G(await oe({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`controller <name>`).description(`Generate a @Controller() class with basic routes
+  Use -m to scope it to a module: kick g controller auth -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=W(n);w(r);let i=await E(process.cwd()),a=T(i),o=a.dir??`src/modules`;G(await ee({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r),await qt(r)}),n.command(`dto <name>`).description(`Generate a Zod DTO schema
+  Use -m to scope it to a module: kick g dto create-user -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module folder`).action(async(e,t,n)=>{let r=W(n);w(r);let i=await E(process.cwd()),a=T(i),o=a.dir??`src/modules`;G(await y({name:e,outDir:t.out,moduleName:t.module,modulesDir:o,pattern:i?.pattern,pluralize:a.pluralize??!0}),r)}),n.command(`test <name>`).description(`Generate a Vitest test scaffold
+  Use -m to scope it to a module: kick g test user-service -m users`).option(`-o, --out <dir>`,`Output directory (overrides --module)`).option(`-m, --module <module>`,`Place inside a module's __tests__/ folder`).action(async(e,t,n)=>{let r=W(n);w(r);let i=T(await E(process.cwd())),a=i.dir??`src/modules`;G(await Gt({name:e,outDir:t.out,moduleName:t.module,modulesDir:a,pluralize:i.pluralize??!0}),r)}),n.command(`job <name>`).description(`Generate a @Job queue processor with @Process handlers`).option(`-o, --out <dir>`,`Output directory`,`src/jobs`).option(`-q, --queue <name>`,`Queue name (default: <name>-queue)`).action(async(e,t,n)=>{let r=W(n);w(r),G(await kt({name:e,outDir:N(t.out),queue:t.queue}),r)}),n.command(`scaffold <name> [fields...]`).description(`Generate a full CRUD module from field definitions
   Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
   Types: string, text, number, int, float, boolean, date, email, url, uuid, json, enum:a,b,c
   Optional: append :optional (shell-safe):  description:text:optional
-            or use ? with quoting:           "description:text?" or "description?:text"`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`--modules-dir <dir>`,`Modules directory`).action(async(e,t,n,r)=>{let i=H(r);o(i),t.length===0&&(console.error(`
+            or use ? with quoting:           "description:text?" or "description?:text"`).option(`--no-entity`,`Skip entity and value object generation`).option(`--no-tests`,`Skip test file generation`).option(`--no-pluralize`,`Use singular names (skip auto-pluralization)`).option(`--modules-dir <dir>`,`Modules directory`).action(async(e,t,n,r)=>{let i=W(r);w(i),t.length===0&&(console.error(`
   Error: At least one field is required.
   Usage: kick g scaffold <name> <field:type> [field:type...]
   Example: kick g scaffold Post title:string body:text:optional published:boolean:optional
   Optional: append :optional (shell-safe, no quoting needed)
-`),process.exit(1));let a=await w(process.cwd()),s=C(a),c=n.modulesDir??s.dir??`src/modules`,l=Pt(t),u=pe(a,process.cwd()),d=a?.pattern??`ddd`;d!==`ddd`&&(console.error(`\n  Error: 'kick g scaffold' currently only supports the DDD pattern.\n  Detected project pattern: '${d}'.\n  Workarounds:\n    - Run 'kick g module ${e}' for the ${d} layout (no fields), then add fields manually.\n    - Override the pattern for this scaffold by setting kick.config.ts pattern: 'ddd'.\n`),process.exit(1));let f=await Ft({name:e,fields:l,modulesDir:j(c),noEntity:n.entity===!1,noTests:n.tests===!1,pluralize:n.pluralize===!1?!1:s.pluralize??!0,tokenScope:u,style:s.style});console.log(`\n  Scaffolded ${e} with ${l.length} field(s):`);for(let e of l)console.log(`    ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);U(f,i),await Xt(i)}),n.command(`auth-scaffold`).description(`Generate a complete auth module (register, login, logout, password hashing)
-  Includes controller, service, DTOs, and test stubs.`).option(`-s, --strategy <type>`,`Auth strategy: jwt | session`).option(`--role-guards`,`Generate role-based guards (default: true)`).option(`--no-role-guards`,`Skip role-based guard generation`).option(`-o, --out <dir>`,`Output directory`,`src/modules/auth`).action(async(t,n)=>{let r=H(n);o(r);let i=t.strategy;i||=await e({message:`Auth strategy`,options:[{value:`jwt`,label:`JWT`,hint:`stateless token-based auth`},{value:`session`,label:`Session`,hint:`server-side session with cookies`}]});let a=t.roleGuards;a===void 0&&(a=await p({message:`Generate role-based guards?`,initialValue:!0})),U(await Dt({strategy:i,outDir:t.out,roleGuards:a}),r)}),n.command(`config`).description(`Generate a kick.config.ts at the project root`).option(`--modules-dir <dir>`,`Modules directory path`,`src/modules`).option(`--repo <type>`,`Default repository type: inmemory | drizzle | prisma`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(e,t)=>{let n=H(t);o(n),U(await ut({outDir:j(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),n)}),n.command(`agents`).alias(`agent-docs`).alias(`ai-docs`).description(`Regenerate AGENTS.md + CLAUDE.md + kickjs-skills.md (sync after framework upgrades)`).option(`--only <which>`,`Limit scope: agents | claude | skills | both (agents+claude) | all (default: all)`,`all`).option(`--name <name>`,`Project name (defaults to package.json name)`).option(`--pm <pm>`,`Package manager (defaults to package.json packageManager)`).option(`--template <template>`,`Template: rest | ddd | cqrs | minimal`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t)=>{let n=H(t);o(n);let r=e.only??`all`;if(!Yt.includes(r)){console.error(`  Invalid --only value: ${r}. Expected: ${Yt.join(` | `)}`),process.exitCode=1;return}U(await ht({outDir:j(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n)})}function tn(e,t,n){let r=Re(process.execPath,[e],{cwd:n,stdio:`inherit`,env:{...process.env,...t}});r.status!==0&&process.exit(r.status??1)}async function nn(e){let t=D.resolve(e.cwd,`.kickjs/types`);await je(t,{recursive:!0});let n=new Map,r=e.scan??_e,i={cwd:e.cwd,config:e.config,async importTs(e){return await import(L(e).href)},async writeFile(t,n){let r=D.resolve(e.cwd,t);await je(D.dirname(r),{recursive:!0}),await I(r,n,`utf8`)},getScanResult:e=>{let t=rn(e),i=n.get(t);return i||(i=r(e),n.set(t,i)),i},log:console},a=[];for(let n of e.plugins){let r=await n.generate(i);if(r===null){a.push({id:n.id,status:`skipped`});continue}let o=n.outExtension??`.d.ts`,s=D.join(t,`${n.id.replace(/\//g,`__`)}${o}`),c=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: ${n.id} */\n\n`+r+`
-`,l=``;if(M(s)&&(l=await F(s,`utf8`)),l===c){a.push({id:n.id,status:`unchanged`,outFile:s});continue}if(e.check)throw Error(`kick typegen --check: drift detected for ${n.id} (${s})`);await I(s,c,`utf8`),a.push({id:n.id,status:`written`,outFile:s})}return a}function rn(e){let t=(e.extensions??[]).slice().toSorted().join(`,`),n=(e.exclude??[]).slice().toSorted().join(`,`);return[`root=${e.root}`,`cwd=${e.cwd}`,`extensions=${t}`,`exclude=${n}`,`envFile=${e.envFile??``}`].join(`|`)}function an(e,t){let n=new Set(t),r=[],i=[],a=new Set;for(let t of e)n.has(t.id)?(i.push(t),a.add(t.id)):r.push(t);return{enabled:r,skipped:i,unknown:[...n].filter(e=>!a.has(e))}}async function W(e){let{enabled:t,skipped:n,unknown:r}=an(he([...Lr,...e.config?.plugins??[]],e.config?.commands??[]).typegens,e.config?.typegen?.disable??[]);if(!e.silent&&n.length>0)for(let e of n)console.log(`  ${e.id}: disabled (typegen.disable)`);if(!e.silent&&r.length>0&&console.warn(`  kick typegen: disable list references unknown id(s): ${r.map(e=>`'${e}'`).join(`, `)}. Run \`kick typegen --list\` to see registered ids.`),t.length===0)return[];try{let n=await nn({cwd:e.cwd,config:e.config??{},plugins:t,check:e.check});if(!e.silent)for(let e of n)console.log(`  ${e.id}: ${e.status}`);return n}catch(t){if(!e.silent){let e=t instanceof Error?t.message:String(t);console.warn(`  kick typegen plugins: skipped (${e})`)}return[]}}async function on(e,t){let{cwd:n,silent:r=!1}=t,i=t.distDir??e?.build?.outDir??`dist`,a=e?.assetMap;if(!a||Object.keys(a).length===0)return null;let o=r?()=>{}:console.log,s=j(n,i);N(s,{recursive:!0});let c=[],l={};for(let[e,t]of Object.entries(a)){let r=await sn(e,t,n,s);c.push(r.entrySummary),Object.assign(l,r.manifestSlice),o(`    ✓ ${e}: ${r.entrySummary.filesCopied} file(s) → ${r.entrySummary.dest}`)}let u={version:1,entries:l},d=k(s,`.kickjs-assets.json`);return ke(d,JSON.stringify(u,null,2)+`
-`,`utf-8`),o(`    ✓ wrote manifest → ${A(n,d)} (${Object.keys(l).length} entries)`),{manifestPath:d,entries:c,manifest:u}}async function sn(e,t,n,r){let i=j(n,t.src),a=t.dest?j(n,t.dest):k(r,e);if(ln(a,n))return console.warn(`  ⚠ assetMap.${e}.dest ('${t.dest}') resolves outside the project root — skipping copy`),{entrySummary:{namespace:e,src:t.src,dest:A(n,a),filesCopied:0},manifestSlice:{}};if(!M(i)||!un(i))return{entrySummary:{namespace:e,src:t.src,dest:A(n,a),filesCopied:0},manifestSlice:{}};let o=await ze(t.glob??`**/*`,{cwd:i,nodir:!0,dot:!1,posix:!0});N(a,{recursive:!0});let s={},{pairs:c,collisionGroupsResolved:l}=Be(e,[...o].toSorted(),{strategy:t.keys??`auto`});for(let{rel:e,key:t}of c){let n=k(i,e),o=k(a,e);N(O(o),{recursive:!0}),Te(n,o),s[t]=cn(r,o)}return l>0&&console.log(`  ℹ assetMap.${e}: auto-resolved ${l} basename collision(s) by keeping extensions (set 'keys: "strip"' to opt back into legacy last-write-wins behaviour, or 'keys: "with-extension"' to keep all keys verbose).`),{entrySummary:{namespace:e,src:t.src,dest:A(n,a),filesCopied:o.length},manifestSlice:s}}function cn(e,t){return A(e,t).split(/[\\/]/).filter(Boolean).join(`/`)}function ln(e,t){let n=A(t,e);return n===``?!1:n.startsWith(`..`)||Ce(n)}function un(e){try{return Oe(e).isDirectory()}catch{return!1}}function dn(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function fn(e,t,n={}){t&&(process.env.PORT=t);let r=dn(n.polling),i=process.cwd(),a=await w(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await E({cwd:i,allowDuplicates:!0,schemaValidator:o,envFile:s,srcDir:a?.typegen?.srcDir,outDir:a?.typegen?.outDir,assetMap:a?.assetMap,runPlugins:!1})}catch(e){console.warn(`  kick typegen: skipped (${e?.message??e})`)}await W({cwd:i,config:a});let{createRequire:c}=await import(`node:module`),{createServer:l}=await import(L(c(j(`package.json`)).resolve(`vite`)).href),u=await l({configFile:j(`vite.config.ts`),server:{port:t?parseInt(t,10):void 0,...r?{watch:{usePolling:!0,interval:100}}:{}}}),d=a?.assetMap?Object.values(a.assetMap).map(e=>e?.src).filter(e=>typeof e==`string`&&e.length>0).map(e=>j(i,e)):[],f=e=>d.some(t=>e===t||e.startsWith(`${t}/`)),p=null,m=e=>{if(e.includes(`.kickjs`)||e.endsWith(`.d.ts`))return;let t=/\.(ts|tsx|mts|cts)$/.test(e),n=f(e);!t&&!n||(p&&clearTimeout(p),p=setTimeout(()=>{E({cwd:i,silent:!0,allowDuplicates:!0,schemaValidator:o,envFile:s,srcDir:a?.typegen?.srcDir,outDir:a?.typegen?.outDir,assetMap:a?.assetMap,runPlugins:!1}).catch(()=>{}),W({cwd:i,config:a,silent:!0}).catch(()=>{})},100))};u.watcher.on(`add`,m),u.watcher.on(`unlink`,m),u.watcher.on(`change`,m),d.length>0&&u.watcher.add(d),await u.listen(),u.printUrls(),console.log(`
+`),process.exit(1));let a=await E(process.cwd()),o=T(a),s=n.modulesDir??o.dir??`src/modules`,c=jt(t),l=pe(a,process.cwd()),u=a?.pattern??`ddd`;u!==`ddd`&&(console.error(`\n  Error: 'kick g scaffold' currently only supports the DDD pattern.\n  Detected project pattern: '${u}'.\n  Workarounds:\n    - Run 'kick g module ${e}' for the ${u} layout (no fields), then add fields manually.\n    - Override the pattern for this scaffold by setting kick.config.ts pattern: 'ddd'.\n`),process.exit(1));let d=await Mt({name:e,fields:c,modulesDir:N(s),noEntity:n.entity===!1,noTests:n.tests===!1,pluralize:n.pluralize===!1?!1:o.pluralize??!0,tokenScope:l,style:o.style});console.log(`\n  Scaffolded ${e} with ${c.length} field(s):`);for(let e of c)console.log(`    ${e.name}: ${e.type}${e.optional?` (optional)`:``}`);G(d,i),await qt(i)}),n.command(`config`).description(`Generate a kick.config.ts at the project root`).option(`--modules-dir <dir>`,`Modules directory path`,`src/modules`).option(`--repo <type>`,`Default repository type: inmemory | drizzle | prisma`,`inmemory`).option(`-f, --force`,`Overwrite existing kick.config.ts without prompting`).action(async(e,t)=>{let n=W(t);w(n),G(await ft({outDir:N(`.`),modulesDir:e.modulesDir,defaultRepo:e.repo,force:e.force}),n)}),n.command(`agents`).alias(`agent-docs`).alias(`ai-docs`).description(`Regenerate AGENTS.md + CLAUDE.md + kickjs-skills.md (sync after framework upgrades)`).option(`--only <which>`,`Limit scope: agents | claude | skills | both (agents+claude) | all (default: all)`,`all`).option(`--name <name>`,`Project name (defaults to package.json name)`).option(`--pm <pm>`,`Package manager (defaults to package.json packageManager)`).option(`--template <template>`,`Template: rest | ddd | cqrs | minimal`).option(`-f, --force`,`Overwrite existing files without prompting`).action(async(e,t)=>{let n=W(t);w(n);let r=e.only??`all`;if(!Kt.includes(r)){console.error(`  Invalid --only value: ${r}. Expected: ${Kt.join(` | `)}`),process.exitCode=1;return}G(await _t({outDir:N(`.`),only:r,name:e.name,pm:e.pm,template:e.template,force:e.force}),n)});for(let e of t?.generators??[])Qt(n,e)}function Qt(e,t){let{source:n,spec:r}=t,i=r.args?.[0],a=i?.name??`itemName`,o=i?.required?`<${a}>`:`[${a}]`,s=`${r.name} ${o} [extraArgs...]`,c=e.command(s).description(`${r.description}  [${n}]`);for(let e of r.flags??[]){let t=e.takesValue?`--${e.name} <value>`:`--${e.name}`,n=e.alias?`-${e.alias}, ${t}`:t;c.option(n,e.description??``)}c.action(async(e,n,i,a)=>{let o=W(a);w(o);let s=await ie({generatorName:r.name,itemName:e??``,args:n??[],flags:i,cwd:process.cwd()},[t]);s&&G(s.files,o)})}function $t(e,t,n){let r=Be(process.execPath,[e],{cwd:n,stdio:`inherit`,env:{...process.env,...t}});r.status!==0&&process.exit(r.status??1)}async function en(e){let t=k.resolve(e.cwd,`.kickjs/types`);await Ne(t,{recursive:!0});let n=new Map,r=e.scan??ve,i={cwd:e.cwd,config:e.config,async importTs(e){return await import(R(e).href)},async writeFile(t,n){let r=k.resolve(e.cwd,t);await Ne(k.dirname(r),{recursive:!0}),await L(r,n,`utf8`)},getScanResult:e=>{let t=tn(e),i=n.get(t);return i||(i=r(e),n.set(t,i)),i},log:console},a=[];for(let n of e.plugins){let r=await n.generate(i);if(r===null){a.push({id:n.id,status:`skipped`});continue}let o=n.outExtension??`.d.ts`,s=k.join(t,`${n.id.replace(/\//g,`__`)}${o}`),c=`/* AUTO-GENERATED by kick typegen — do not edit. Plugin: ${n.id} */\n\n`+r+`
+`,l=``;if(P(s)&&(l=await I(s,`utf8`)),l===c){a.push({id:n.id,status:`unchanged`,outFile:s});continue}if(e.check)throw Error(`kick typegen --check: drift detected for ${n.id} (${s})`);await L(s,c,`utf8`),a.push({id:n.id,status:`written`,outFile:s})}return a}function tn(e){let t=(e.extensions??[]).slice().toSorted().join(`,`),n=(e.exclude??[]).slice().toSorted().join(`,`);return[`root=${e.root}`,`cwd=${e.cwd}`,`extensions=${t}`,`exclude=${n}`,`envFile=${e.envFile??``}`].join(`|`)}function nn(e,t){let n=new Set(t),r=[],i=[],a=new Set;for(let t of e)n.has(t.id)?(i.push(t),a.add(t.id)):r.push(t);return{enabled:r,skipped:i,unknown:[...n].filter(e=>!a.has(e))}}async function rn(e){let{enabled:t,skipped:n,unknown:r}=nn(ge([...Lr,...e.config?.plugins??[]],e.config?.commands??[]).typegens,e.config?.typegen?.disable??[]);if(!e.silent&&n.length>0)for(let e of n)console.log(`  ${e.id}: disabled (typegen.disable)`);if(!e.silent&&r.length>0&&console.warn(`  kick typegen: disable list references unknown id(s): ${r.map(e=>`'${e}'`).join(`, `)}. Run \`kick typegen --list\` to see registered ids.`),t.length===0)return[];try{let n=await en({cwd:e.cwd,config:e.config??{},plugins:t,check:e.check});if(!e.silent)for(let e of n)console.log(`  ${e.id}: ${e.status}`);return n}catch(t){if(!e.silent){let e=t instanceof Error?t.message:String(t);console.warn(`  kick typegen plugins: skipped (${e})`)}return[]}}async function an(e,t){let{cwd:n,silent:r=!1}=t,i=t.distDir??e?.build?.outDir??`dist`,a=e?.assetMap;if(!a||Object.keys(a).length===0)return null;let o=r?()=>{}:console.log,s=N(n,i);De(s,{recursive:!0});let c=[],l={};for(let[e,t]of Object.entries(a)){let r=await on(e,t,n,s);c.push(r.entrySummary),Object.assign(l,r.manifestSlice),o(`    ✓ ${e}: ${r.entrySummary.filesCopied} file(s) → ${r.entrySummary.dest}`)}let u={version:1,entries:l},d=j(s,`.kickjs-assets.json`);return je(d,JSON.stringify(u,null,2)+`
+`,`utf-8`),o(`    ✓ wrote manifest → ${M(n,d)} (${Object.keys(l).length} entries)`),{manifestPath:d,entries:c,manifest:u}}async function on(e,t,n,r){let i=N(n,t.src),a=t.dest?N(n,t.dest):j(r,e);if(cn(a,n))return console.warn(`  ⚠ assetMap.${e}.dest ('${t.dest}') resolves outside the project root — skipping copy`),{entrySummary:{namespace:e,src:t.src,dest:M(n,a),filesCopied:0},manifestSlice:{}};if(!P(i)||!ln(i))return{entrySummary:{namespace:e,src:t.src,dest:M(n,a),filesCopied:0},manifestSlice:{}};let o=await Ve(t.glob??`**/*`,{cwd:i,nodir:!0,dot:!1,posix:!0});De(a,{recursive:!0});let s={},{pairs:c,collisionGroupsResolved:l}=He(e,[...o].toSorted(),{strategy:t.keys??`auto`});for(let{rel:e,key:t}of c){let n=j(i,e),o=j(a,e);De(A(o),{recursive:!0}),Ee(n,o),s[t]=sn(r,o)}return l>0&&console.log(`  ℹ assetMap.${e}: auto-resolved ${l} basename collision(s) by keeping extensions (set 'keys: "strip"' to opt back into legacy last-write-wins behaviour, or 'keys: "with-extension"' to keep all keys verbose).`),{entrySummary:{namespace:e,src:t.src,dest:M(n,a),filesCopied:o.length},manifestSlice:s}}function sn(e,t){return M(e,t).split(/[\\/]/).filter(Boolean).join(`/`)}function cn(e,t){let n=M(t,e);return n===``?!1:n.startsWith(`..`)||we(n)}function ln(e){try{return Ae(e).isDirectory()}catch{return!1}}function un(e){if(typeof e==`boolean`)return e;let t=process.env.KICKJS_WATCH_POLLING;return t===`1`||t===`true`}async function dn(e,t,n={}){t&&(process.env.PORT=t);let r=un(n.polling),i=process.cwd(),a=await E(i),o=a?.typegen?.schemaValidator??`zod`,s=a?.typegen?.envFile;try{await O({cwd:i,allowDuplicates:!0,schemaValidator:o,envFile:s,srcDir:a?.typegen?.srcDir,outDir:a?.typegen?.outDir,assetMap:a?.assetMap,runPlugins:!1})}catch(e){console.warn(`  kick typegen: skipped (${e?.message??e})`)}await rn({cwd:i,config:a});let{createRequire:c}=await import(`node:module`),{createServer:l}=await import(R(c(N(`package.json`)).resolve(`vite`)).href),u=await l({configFile:N(`vite.config.ts`),server:{port:t?parseInt(t,10):void 0,...r?{watch:{usePolling:!0,interval:100}}:{}}}),d=a?.assetMap?Object.values(a.assetMap).map(e=>e?.src).filter(e=>typeof e==`string`&&e.length>0).map(e=>N(i,e)):[],f=e=>d.some(t=>e===t||e.startsWith(`${t}/`)),p=null,m=e=>{if(e.includes(`.kickjs`)||e.endsWith(`.d.ts`))return;let t=/\.(ts|tsx|mts|cts)$/.test(e),n=f(e);!t&&!n||(p&&clearTimeout(p),p=setTimeout(()=>{O({cwd:i,silent:!0,allowDuplicates:!0,schemaValidator:o,envFile:s,srcDir:a?.typegen?.srcDir,outDir:a?.typegen?.outDir,assetMap:a?.assetMap,runPlugins:!1}).catch(()=>{}),rn({cwd:i,config:a,silent:!0}).catch(()=>{})},100))};u.watcher.on(`add`,m),u.watcher.on(`unlink`,m),u.watcher.on(`change`,m),d.length>0&&u.watcher.add(d),await u.listen(),u.printUrls(),console.log(`
   KickJS dev server running (Vite + @forinda/kickjs-vite)
-`);let h=async()=>{p&&clearTimeout(p),await u.close(),process.exit(0)};process.on(`SIGINT`,h),process.on(`SIGTERM`,h)}function pn(e){e.command(`dev`).description(`Start development server with Vite HMR (zero-downtime reload)`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--polling`,`Force chokidar to poll for file changes (Docker / WSL / NFS / older kernels)`).action(async e=>{try{await fn(e.entry,e.port,{polling:e.polling})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
+`);let h=async()=>{p&&clearTimeout(p),await u.close(),process.exit(0)};process.on(`SIGINT`,h),process.on(`SIGTERM`,h)}function fn(e){e.command(`dev`).description(`Start development server with Vite HMR (zero-downtime reload)`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--polling`,`Force chokidar to poll for file changes (Docker / WSL / NFS / older kernels)`).action(async e=>{try{await dn(e.entry,e.port,{polling:e.polling})}catch(e){e.code===`ERR_MODULE_NOT_FOUND`&&e.message?.includes(`vite`)?console.error(`
   Error: vite is not installed.
   Run: pnpm add -D vite unplugin-swc
 `):console.error(`
   Dev server failed:`,e.message??e),process.exit(1)}}),e.command(`build`).description(`Build for production via Vite`).action(async()=>{console.log(`
   Building for production...
-`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(L(e(j(`package.json`)).resolve(`vite`)).href);await t({configFile:j(`vite.config.ts`)});let n=await w(process.cwd()),r=n?.copyDirs??[];if(r.length>0){console.log(`
-  Copying directories to dist...`);for(let e of r){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?k(`dist`,e):e.dest??k(`dist`,t),r=j(t),i=j(n);if(!M(r)){console.log(`    ⚠ Skipped ${t} (not found)`);continue}N(i,{recursive:!0}),Te(r,i,{recursive:!0}),console.log(`    ✓ ${t} → ${n}`)}}if(n?.assetMap&&Object.keys(n.assetMap).length>0){console.log(`
-  Building asset map...`);try{await on(n,{cwd:process.cwd()})}catch(e){console.error(`    ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
+`);let{createRequire:e}=await import(`node:module`),{build:t}=await import(R(e(N(`package.json`)).resolve(`vite`)).href);await t({configFile:N(`vite.config.ts`)});let n=await E(process.cwd()),r=n?.copyDirs??[];if(r.length>0){console.log(`
+  Copying directories to dist...`);for(let e of r){let t=typeof e==`string`?e:e.src,n=typeof e==`string`?j(`dist`,e):e.dest??j(`dist`,t),r=N(t),i=N(n);if(!P(r)){console.log(`    ⚠ Skipped ${t} (not found)`);continue}De(i,{recursive:!0}),Ee(r,i,{recursive:!0}),console.log(`    ✓ ${t} → ${n}`)}}if(n?.assetMap&&Object.keys(n.assetMap).length>0){console.log(`
+  Building asset map...`);try{await an(n,{cwd:process.cwd()})}catch(e){console.error(`    ✗ asset build failed: ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}console.log(`
   Build complete.
-`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await w(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0){console.log(`  No assetMap entries — nothing to build.`);return}console.log(`
-  Building asset map...`);try{await on(e,{cwd:process.cwd()}),console.log(`
+`)}),e.command(`build:assets`).description(`Rebuild the .kickjs-assets.json manifest under the configured outDir (no JS rebuild)`).action(async()=>{let e=await E(process.cwd());if(!e?.assetMap||Object.keys(e.assetMap).length===0){console.log(`  No assetMap entries — nothing to build.`);return}console.log(`
+  Building asset map...`);try{await an(e,{cwd:process.cwd()}),console.log(`
   Asset build complete.
-`)}catch(e){console.error(`  ✗ ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}),e.command(`start`).description(`Start production server`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`-p, --port <port>`,`Port number`).action(e=>{let t={NODE_ENV:`production`};e.port&&(t.PORT=String(e.port)),tn(e.entry,t)}),e.command(`dev:debug`).description(`Start dev server with Node.js inspector attached`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--inspect-port <port>`,`Inspector port`,`9229`).action(async e=>{let t=e.inspectPort??`9229`;process.env.NODE_OPTIONS=`--inspect=0.0.0.0:${t}`,console.log(`  Debugger: ws://0.0.0.0:${t}`);try{await fn(e.entry,e.port)}catch(e){console.error(`
-  Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function mn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{console.log(`
+`)}catch(e){console.error(`  ✗ ${e instanceof Error?e.message:String(e)}`),process.exit(1)}}),e.command(`start`).description(`Start production server`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`-p, --port <port>`,`Port number`).action(e=>{let t={NODE_ENV:`production`};e.port&&(t.PORT=String(e.port)),$t(e.entry,t)}),e.command(`dev:debug`).description(`Start dev server with Node.js inspector attached`).option(`-e, --entry <file>`,`Entry file`,`src/index.ts`).option(`-p, --port <port>`,`Port number`).option(`--inspect-port <port>`,`Inspector port`,`9229`).action(async e=>{let t=e.inspectPort??`9229`;process.env.NODE_OPTIONS=`--inspect=0.0.0.0:${t}`,console.log(`  Debugger: ws://0.0.0.0:${t}`);try{await dn(e.entry,e.port)}catch(e){console.error(`
+  Dev server (debug) failed:`,e.message??e),process.exit(1)}})}function pn(e){e.command(`info`).description(`Print system and framework info`).action(()=>{console.log(`
   KickJS CLI
 
   System:
-    OS:       ${He()} ${Ue()} (${Ve()})
+    OS:       ${We()} ${Ge()} (${Ue()})
     Node:     ${process.version}
 
   Packages:
     @forinda/kickjs          workspace
     @forinda/kickjs-vite     workspace
     @forinda/kickjs-cli      workspace
-`)})}const{bold:G,dim:K,green:hn,red:q,yellow:gn,blue:_n}=u;function vn(e){let t=Math.floor(e/86400),n=Math.floor(e%86400/3600),r=Math.floor(e%3600/60),i=e%60,a=[];return t&&a.push(`${t}d`),n&&a.push(`${n}h`),r&&a.push(`${r}m`),a.push(`${i}s`),a.join(` `)}async function yn(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function J(e,t){try{return await yn(`${e}${t}`)}catch{return null}}async function bn(e){let[t,n,r,i,a]=await Promise.all([J(e,`/health`),J(e,`/metrics`),J(e,`/routes`),J(e,`/container`),J(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function xn(e,t){let{health:n,metrics:r,routes:i,container:a,ws:o}=t,s=K(`─`.repeat(60));if(console.log(),console.log(G(`  KickJS Inspector`)+K(`  →  ${e}`)),console.log(s),n){let e=n.status===`healthy`?hn(`● healthy`):q(`● `+n.status);console.log(`  ${G(`Health:`)}    ${e}`)}else console.log(`  ${G(`Health:`)}    ${q(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?q:r.errorRate>0?gn:hn;console.log(`  ${G(`Uptime:`)}    ${vn(r.uptimeSeconds)}`),console.log(`  ${G(`Requests:`)}  ${r.requests}`),console.log(`  ${G(`Errors:`)}    ${r.serverErrors} server, ${r.clientErrors??0} client  ${K(`(`)}${t(e+`%`)}${K(`)`)}`)}if(a&&console.log(`  ${G(`DI:`)}        ${a.count} bindings`),o&&o.enabled&&console.log(`  ${G(`WS:`)}        ${o.connections??0} connections, ${o.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(G(`  Routes`)),console.log(s),console.log(`  ${K(`METHOD`)}  ${K(`PATH`.padEnd(36))} ${K(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(`  ${c(e.method)} ${t} ${_n(e.controller)}.${K(e.handler)}`)}}console.log(s),console.log()}function Sn(e){e.command(`inspect [url]`).description(`Connect to a running KickJS app and display debug info`).option(`-p, --port <port>`,`Override port`).option(`-w, --watch`,`Poll every 5 seconds`).option(`-j, --json`,`Output raw JSON`).action(async(e,t)=>{let n=e??`http://localhost:3000`;if(t.port)try{let e=new URL(n);e.port=t.port,n=e.origin}catch{n=`http://localhost:${t.port}`}let r=`${n.replace(/\/$/,``)}/_debug`,i=async()=>{try{let e=await bn(r);t.json?console.log(JSON.stringify(e,null,2)):xn(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(q(`  ✖ Could not connect to ${n}`)),console.error(K(`    ${e instanceof Error?e.message:String(e)}`))),t.watch||(process.exitCode=1)}};if(t.watch){let e=async()=>{process.stdout.write(`\x1B[2J\x1B[H`),await i()};await e(),setInterval(e,5e3)}else await i()})}function Cn(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function Y(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const wn=[{match(e,t){let n=Cn(e,[`config`,`get`])&&Y(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&Y(e,[`undefined`,`is not defined`]);return!n&&!r?null:{confidence:n&&r?90:75,diagnosis:{id:`env-schema-not-registered`,title:`ConfigService.get() returns undefined for user-defined keys`,explanation:`Your src/index.ts is missing \`import "./config"\`. That side-effect import
+`)})}const{bold:K,dim:q,green:mn,red:hn,yellow:gn,blue:_n}=o;function vn(e){let t=Math.floor(e/86400),n=Math.floor(e%86400/3600),r=Math.floor(e%3600/60),i=e%60,a=[];return t&&a.push(`${t}d`),n&&a.push(`${n}h`),r&&a.push(`${r}m`),a.push(`${i}s`),a.join(` `)}async function yn(e){let t=await fetch(e,{signal:AbortSignal.timeout(5e3)});if(!t.ok)throw Error(`${t.status} ${t.statusText}`);return t.json()}async function J(e,t){try{return await yn(`${e}${t}`)}catch{return null}}async function bn(e){let[t,n,r,i,a]=await Promise.all([J(e,`/health`),J(e,`/metrics`),J(e,`/routes`),J(e,`/container`),J(e,`/ws`)]);return{health:t,metrics:n,routes:r,container:i,ws:a}}function xn(e,t){let{health:n,metrics:r,routes:i,container:o,ws:s}=t,c=q(`─`.repeat(60));if(console.log(),console.log(K(`  KickJS Inspector`)+q(`  →  ${e}`)),console.log(c),n){let e=n.status===`healthy`?mn(`● healthy`):hn(`● `+n.status);console.log(`  ${K(`Health:`)}    ${e}`)}else console.log(`  ${K(`Health:`)}    ${hn(`● unreachable`)}`);if(r){let e=((r.errorRate??0)*100).toFixed(1),t=r.errorRate>.1?hn:r.errorRate>0?gn:mn;console.log(`  ${K(`Uptime:`)}    ${vn(r.uptimeSeconds)}`),console.log(`  ${K(`Requests:`)}  ${r.requests}`),console.log(`  ${K(`Errors:`)}    ${r.serverErrors} server, ${r.clientErrors??0} client  ${q(`(`)}${t(e+`%`)}${q(`)`)}`)}if(o&&console.log(`  ${K(`DI:`)}        ${o.count} bindings`),s&&s.enabled&&console.log(`  ${K(`WS:`)}        ${s.connections??0} connections, ${s.namespaces??0} namespaces`),i?.routes?.length){console.log(),console.log(K(`  Routes`)),console.log(c),console.log(`  ${q(`METHOD`)}  ${q(`PATH`.padEnd(36))} ${q(`CONTROLLER`)}`);for(let e of i.routes){let t=e.path.length>36?e.path.slice(0,33)+`...`:e.path.padEnd(36);console.log(`  ${a(e.method)} ${t} ${_n(e.controller)}.${q(e.handler)}`)}}console.log(c),console.log()}function Sn(e){e.command(`inspect [url]`).description(`Connect to a running KickJS app and display debug info`).option(`-p, --port <port>`,`Override port`).option(`-w, --watch`,`Poll every 5 seconds`).option(`-j, --json`,`Output raw JSON`).action(async(e,t)=>{let n=e??`http://localhost:3000`;if(t.port)try{let e=new URL(n);e.port=t.port,n=e.origin}catch{n=`http://localhost:${t.port}`}let r=`${n.replace(/\/$/,``)}/_debug`,i=async()=>{try{let e=await bn(r);t.json?console.log(JSON.stringify(e,null,2)):xn(n,e)}catch(e){t.json?console.log(JSON.stringify({error:String(e)})):(console.error(hn(`  ✖ Could not connect to ${n}`)),console.error(q(`    ${e instanceof Error?e.message:String(e)}`))),t.watch||(process.exitCode=1)}};if(t.watch){let e=async()=>{process.stdout.write(`\x1B[2J\x1B[H`),await i()};await e(),setInterval(e,5e3)}else await i()})}function Cn(e,t){let n=e.toLowerCase();return t.every(e=>n.includes(e.toLowerCase()))}function Y(e,t){let n=e.toLowerCase();return t.some(e=>n.includes(e.toLowerCase()))}const wn=[{match(e,t){let n=Cn(e,[`config`,`get`])&&Y(e,[`undefined`,`null`]),r=e.includes(`@Value`)&&Y(e,[`undefined`,`is not defined`]);return!n&&!r?null:{confidence:n&&r?90:75,diagnosis:{id:`env-schema-not-registered`,title:`ConfigService.get() returns undefined for user-defined keys`,explanation:`Your src/index.ts is missing \`import "./config"\`. That side-effect import
 registers the env schema with kickjs at module-load time. Without it,
 ConfigService falls back to the base schema (PORT/NODE_ENV/LOG_LEVEL only)
 and every user-defined key reads as undefined. @Value() may *appear* to
@@ -965,7 +767,7 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
 `),process.exit(1));let r=Ln(),i=Tn(n,r);if(t.json&&i){process.stdout.write(JSON.stringify({matched:!0,...i},null,2)+`
 `);return}if(i){Rn(n,i.diagnosis,i.confidence);return}t.ai||(t.json&&(process.stdout.write(JSON.stringify({matched:!1},null,2)+`
 `),process.exit(2)),zn(n,!1),process.exit(2));let a=await En({input:n,model:t.model,cwd:r.cwd});t.json&&(process.stdout.write(JSON.stringify(Nn(a),null,2)+`
-`),process.exit(a.kind===`ok`?0:2)),Pn(n,a),process.exit(a.kind===`ok`?0:2)})}function Nn(e){return e.kind===`ok`?{matched:!0,source:`ai`,diagnosis:e.diagnosis}:e.kind===`unavailable`?{matched:!1,aiUnavailable:!0,reason:e.reason}:{matched:!1,aiError:!0,error:e.message}}function Pn(e,t){if(t.kind===`ok`){Rn(e,t.diagnosis,-1,!0);return}if(t.kind===`unavailable`){process.stdout.write(`\n  Explaining: ${Z(e.trim(),200)}\n\n`),process.stdout.write(`  AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${X(t.suggestion,`  `)}\n\n`);return}process.stdout.write(`\n  Explaining: ${Z(e.trim(),200)}\n\n`),process.stdout.write(`  AI fallback error: ${t.message}\n\n`)}async function Fn(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:In()}function In(){return new Promise((e,t)=>{let n=``;process.stdin.setEncoding(`utf8`),process.stdin.on(`data`,e=>{n+=e}),process.stdin.on(`end`,()=>e(n)),process.stdin.on(`error`,t)})}function Ln(){let e=process.cwd();return{cwd:e,hasFile:t=>M(j(e,t))}}function Rn(e,t,n,r=!1){let i=Z(e.trim(),200),a=r?`AI-generated — verify before applying`:Bn(n);process.stdout.write(`\n  Explaining: ${i}\n`),process.stdout.write(`\n  Match: ${t.id}  (${a})\n`),process.stdout.write(`  Title: ${t.title}\n`),process.stdout.write(`\n  Diagnosis:\n${X(t.explanation,`    `)}\n`),process.stdout.write(`\n  Fix:\n${X(t.fix,`    `)}\n`),t.codeBefore&&process.stdout.write(`\n  Before:\n${X(t.codeBefore,`      `)}\n`),t.codeAfter&&process.stdout.write(`\n  After:\n${X(t.codeAfter,`      `)}\n`),t.docs&&process.stdout.write(`\n  Docs: ${t.docs}\n`),process.stdout.write(`
+`),process.exit(a.kind===`ok`?0:2)),Pn(n,a),process.exit(a.kind===`ok`?0:2)})}function Nn(e){return e.kind===`ok`?{matched:!0,source:`ai`,diagnosis:e.diagnosis}:e.kind===`unavailable`?{matched:!1,aiUnavailable:!0,reason:e.reason}:{matched:!1,aiError:!0,error:e.message}}function Pn(e,t){if(t.kind===`ok`){Rn(e,t.diagnosis,-1,!0);return}if(t.kind===`unavailable`){process.stdout.write(`\n  Explaining: ${Z(e.trim(),200)}\n\n`),process.stdout.write(`  AI fallback unavailable: ${t.reason}\n\n`),process.stdout.write(`${X(t.suggestion,`  `)}\n\n`);return}process.stdout.write(`\n  Explaining: ${Z(e.trim(),200)}\n\n`),process.stdout.write(`  AI fallback error: ${t.message}\n\n`)}async function Fn(e,t){return e&&e.trim().length>0?e:t&&t.trim().length>0?t:process.stdin.isTTY?``:In()}function In(){return new Promise((e,t)=>{let n=``;process.stdin.setEncoding(`utf8`),process.stdin.on(`data`,e=>{n+=e}),process.stdin.on(`end`,()=>e(n)),process.stdin.on(`error`,t)})}function Ln(){let e=process.cwd();return{cwd:e,hasFile:t=>P(N(e,t))}}function Rn(e,t,n,r=!1){let i=Z(e.trim(),200),a=r?`AI-generated — verify before applying`:Bn(n);process.stdout.write(`\n  Explaining: ${i}\n`),process.stdout.write(`\n  Match: ${t.id}  (${a})\n`),process.stdout.write(`  Title: ${t.title}\n`),process.stdout.write(`\n  Diagnosis:\n${X(t.explanation,`    `)}\n`),process.stdout.write(`\n  Fix:\n${X(t.fix,`    `)}\n`),t.codeBefore&&process.stdout.write(`\n  Before:\n${X(t.codeBefore,`      `)}\n`),t.codeAfter&&process.stdout.write(`\n  After:\n${X(t.codeAfter,`      `)}\n`),t.docs&&process.stdout.write(`\n  Docs: ${t.docs}\n`),process.stdout.write(`
 `)}function zn(e,t){let n=Z(e.trim(),200);process.stdout.write(`\n  Explaining: ${n}\n\n`),t?process.stdout.write(`  No known-issue matched, and --ai fallback is not yet wired.
   When @forinda/kickjs-ai ships its provider implementations,
   this command will call the configured LLM with the error +
@@ -985,10 +787,10 @@ Pass a message as a positional arg, --message flag, or pipe via stdin:
 
 `)}function X(e,t){return e.split(`
 `).map(e=>`${t}${e}`).join(`
-`)}function Z(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function Bn(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function Vn(e){let t=e.command(`mcp`).description(`Model Context Protocol commands (start | init)`);t.command(`start`,{isDefault:!0}).description(`Run the built application as an MCP server over stdio`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`--node-arg <arg...>`,`Extra arguments to pass to node`).action(Hn),t.command(`init`).description(`Generate .mcp.json for Claude Code / Cursor / Zed`).option(`-n, --name <name>`,`Server name (defaults to package.json name)`).option(`-o, --out <file>`,`Output file`,`.mcp.json`).option(`-f, --force`,`Overwrite an existing entry without prompting`).option(`--global`,`Write to ~/.mcp.json instead of the project root`).action(Un)}function Hn(e){let t=j(e.entry);M(t)||(process.stderr.write(`Error: entry file not found: ${t}\n\nBuild the app first with \`kick build\`, or pass a custom entry:\n  kick mcp -e dist/server.js\n`),process.exit(1));let n=[...e.nodeArg??[],t],r=Le(process.execPath,n,{stdio:`inherit`,env:{...process.env,KICK_MCP_STDIO:`1`,NODE_ENV:process.env.NODE_ENV??`production`}});r.on(`error`,e=>{process.stderr.write(`Failed to start MCP server: ${e.message}\n`),process.exit(1)}),r.on(`exit`,(e,t)=>{if(t){process.kill(process.pid,t);return}process.exit(e??0)});let i=e=>{r.killed||r.kill(e)};process.on(`SIGINT`,()=>i(`SIGINT`)),process.on(`SIGTERM`,()=>i(`SIGTERM`))}function Un(e){let t=process.cwd(),n=Wn(t)??Se(t),r=e.name??n,i=e.global?j(process.env.HOME??`.`,`.mcp.json`):j(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(M(i))try{let e=P(i,`utf8`),t=JSON.parse(e);t&&typeof t==`object`&&t.mcpServers&&(o={mcpServers:{...t.mcpServers}})}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`Error: existing ${i} is not valid JSON (${t}).\nFix the file or pass --force to overwrite the entry.\n`),process.exit(1)}o.mcpServers[r]&&!e.force&&(process.stderr.write(`Error: an entry for "${r}" already exists in ${i}.\nPass --force to overwrite it, or use --name to pick a different key.\n`),process.exit(1)),o.mcpServers[r]=a,ke(i,JSON.stringify(o,null,2)+`
-`,`utf8`),process.stdout.write(`\n  ✓ Wrote MCP server entry "${r}" to ${i}\n\n  To activate it:\n    1. Build your app:    kick build\n    2. Restart your MCP client (Claude Code, Cursor, Zed)\n    3. The server should appear in the client's tool picker\n\n`)}function Wn(e){let t=j(e,`package.json`);if(!M(t))return null;try{let e=P(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Gn(e){e.command(`tinker`).description(`Interactive REPL with DI container and services loaded`).option(`-e, --entry <file>`,`Entry file to load`,`src/index.ts`).action(async e=>{let t=process.cwd(),n=j(t,e.entry);M(n)||(console.error(`\n  Error: ${e.entry} not found.\n`),process.exit(1));let r=qn(t,`tsx`);r||(console.error(`
+`)}function Z(e,t){return e.length<=t?e:e.slice(0,t-1)+`…`}function Bn(e){return e>=90?`high confidence`:e>=70?`good match`:e>=50?`medium confidence`:`low confidence — verify manually`}function Vn(e){let t=e.command(`mcp`).description(`Model Context Protocol commands (start | init)`);t.command(`start`,{isDefault:!0}).description(`Run the built application as an MCP server over stdio`).option(`-e, --entry <file>`,`Entry file`,`dist/index.js`).option(`--node-arg <arg...>`,`Extra arguments to pass to node`).action(Hn),t.command(`init`).description(`Generate .mcp.json for Claude Code / Cursor / Zed`).option(`-n, --name <name>`,`Server name (defaults to package.json name)`).option(`-o, --out <file>`,`Output file`,`.mcp.json`).option(`-f, --force`,`Overwrite an existing entry without prompting`).option(`--global`,`Write to ~/.mcp.json instead of the project root`).action(Un)}function Hn(e){let t=N(e.entry);P(t)||(process.stderr.write(`Error: entry file not found: ${t}\n\nBuild the app first with \`kick build\`, or pass a custom entry:\n  kick mcp -e dist/server.js\n`),process.exit(1));let n=[...e.nodeArg??[],t],r=ze(process.execPath,n,{stdio:`inherit`,env:{...process.env,KICK_MCP_STDIO:`1`,NODE_ENV:process.env.NODE_ENV??`production`}});r.on(`error`,e=>{process.stderr.write(`Failed to start MCP server: ${e.message}\n`),process.exit(1)}),r.on(`exit`,(e,t)=>{if(t){process.kill(process.pid,t);return}process.exit(e??0)});let i=e=>{r.killed||r.kill(e)};process.on(`SIGINT`,()=>i(`SIGINT`)),process.on(`SIGTERM`,()=>i(`SIGTERM`))}function Un(e){let t=process.cwd(),n=Wn(t)??Ce(t),r=e.name??n,i=e.global?N(process.env.HOME??`.`,`.mcp.json`):N(t,e.out),a={command:`kick`,args:[`mcp`],cwd:t},o={mcpServers:{}};if(P(i))try{let e=F(i,`utf8`),t=JSON.parse(e);t&&typeof t==`object`&&t.mcpServers&&(o={mcpServers:{...t.mcpServers}})}catch(e){let t=e instanceof Error?e.message:String(e);process.stderr.write(`Error: existing ${i} is not valid JSON (${t}).\nFix the file or pass --force to overwrite the entry.\n`),process.exit(1)}o.mcpServers[r]&&!e.force&&(process.stderr.write(`Error: an entry for "${r}" already exists in ${i}.\nPass --force to overwrite it, or use --name to pick a different key.\n`),process.exit(1)),o.mcpServers[r]=a,je(i,JSON.stringify(o,null,2)+`
+`,`utf8`),process.stdout.write(`\n  ✓ Wrote MCP server entry "${r}" to ${i}\n\n  To activate it:\n    1. Build your app:    kick build\n    2. Restart your MCP client (Claude Code, Cursor, Zed)\n    3. The server should appear in the client's tool picker\n\n`)}function Wn(e){let t=N(e,`package.json`);if(!P(t))return null;try{let e=F(t,`utf8`),n=JSON.parse(e);return typeof n.name==`string`?n.name:null}catch{return null}}function Gn(e){e.command(`tinker`).description(`Interactive REPL with DI container and services loaded`).option(`-e, --entry <file>`,`Entry file to load`,`src/index.ts`).action(async e=>{let t=process.cwd(),n=N(t,e.entry);P(n)||(console.error(`\n  Error: ${e.entry} not found.\n`),process.exit(1));let r=qn(t,`tsx`);r||(console.error(`
   Error: tsx not found. Install it: pnpm add -D tsx
-`),process.exit(1));let i=Kn(n,e.entry),a=k(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=Ie(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function Kn(e,t){return`
+`),process.exit(1));let i=Kn(n,e.entry),a=j(t,`.kick-tinker.mjs`),{writeFileSync:o,unlinkSync:s}=await import(`node:fs`);o(a,i,`utf-8`);try{let e=Re(a,[],{cwd:t,execPath:r,stdio:`inherit`});await new Promise(t=>{e.on(`exit`,()=>t())})}finally{try{s(a)}catch{}}})}function Kn(e,t){return`
 import 'reflect-metadata'
 
 // Prevent bootstrap() from starting the HTTP server
@@ -1013,7 +815,7 @@ try {
 
 // Load entry to trigger decorator registration
 try {
-  await import('${L(e).href}')
+  await import('${R(e).href}')
 } catch (err) {
   console.warn('  Warning: ' + err.message)
   console.warn('  Container may be partially initialized.\\n')
@@ -1042,32 +844,32 @@ server.on('exit', () => {
   console.log('\\n  Goodbye!\\n')
   process.exit(0)
 })
-`}function qn(e,t){let n=e;for(;;){let e=k(n,`node_modules`,`.bin`,t);if(M(e))return e;let r=j(n,`..`);if(r===n)break;n=r}return null}function Jn(e,t){let n=RegExp(`^\\s*${S(t)}Module\\b`),r=!1,i=0,a=e;for(;;){let e=a.indexOf(`.mount(`,i);if(e===-1)break;let t=e+7,o=1,s=t;for(;s<a.length&&o>0;){let e=a.slice(s,s+2);if(e===`//`||e===`/*`){if(e===`//`)for(s+=2;s<a.length&&a[s]!==`
+`}function qn(e,t){let n=e;for(;;){let e=j(n,`node_modules`,`.bin`,t);if(P(e))return e;let r=N(n,`..`);if(r===n)break;n=r}return null}function Jn(e,t){let n=RegExp(`^\\s*${C(t)}Module\\b`),r=!1,i=0,a=e;for(;;){let e=a.indexOf(`.mount(`,i);if(e===-1)break;let t=e+7,o=1,s=t;for(;s<a.length&&o>0;){let e=a.slice(s,s+2);if(e===`//`||e===`/*`){if(e===`//`)for(s+=2;s<a.length&&a[s]!==`
 `;)s++;else{for(s+=2;s+1<a.length&&!(a[s]===`*`&&a[s+1]===`/`);)s++;s+=2}continue}let t=a[s]??``;if(t===`'`||t===`"`||t==="`"){let e=t;for(s++;s<a.length&&a[s]!==e;)a[s]===`\\`&&s++,s++}else if(t===`(`)o++;else if(t===`)`&&(o--,o===0))break;s++}if(o!==0)break;let c=a.slice(t,s);if(n.test(c)){let t=e;for(;t>0&&(a[t-1]===` `||a[t-1]===`	`||a[t-1]===`
-`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function Yn(e,t){let n=y(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Jn(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${S(t)}Module\\b(?:\\s*\\(\\s*\\))?\\s*,?`,`g`),e=>{let t=e.trimStart().startsWith(`,`),n=e.trimEnd().endsWith(`,`);return t&&n?`,`:``}),a=a.replace(/,(\s*])/,`$1`),e.slice(0,r)+a+e.slice(i)}async function Xn(e){let{name:n,modulesDir:r,force:i}=e,o=e.pluralize!==!1,s=t(n),c=x(n),l=o?g(s):s,d=k(r,l);if(!await a(d)){console.log(`\n  Module not found: ${d}\n`);return}if(!i&&!await p({message:u.red(`Delete module '${l}' at ${d}? This cannot be undone.`),initialValue:!1})){console.log(`
+`);)t--;a=a.slice(0,t)+a.slice(s+1),r=!0,i=t;continue}i=s+1}return{content:a,changed:r}}function Yn(e,t){let n=ue(e);if(!n)return e;let r=n.rhsStart,i=n.rhsEnd+1,a=e.slice(r,i);return a=Jn(a,t).content,a=a.replace(RegExp(`\\s*,?\\s*${C(t)}Module\\b(?:\\s*\\(\\s*\\))?\\s*,?`,`g`),e=>{let t=e.trimStart().startsWith(`,`),n=e.trimEnd().endsWith(`,`);return t&&n?`,`:``}),a=a.replace(/,(\s*])/,`$1`),e.slice(0,r)+a+e.slice(i)}async function Xn(e){let{name:t,modulesDir:n,force:a}=e,s=e.pluralize!==!1,c=m(t),l=i(t),u=s?p(c):c,d=j(n,u);if(!await f(d)){console.log(`\n  Module not found: ${d}\n`);return}if(!a&&!await r({message:o.red(`Delete module '${u}' at ${d}? This cannot be undone.`),initialValue:!1})){console.log(`
   Cancelled.
-`);return}await Ne(d,{recursive:!0,force:!0}),console.log(`  Deleted: ${d}`);let f=k(r,`index.ts`);if(await a(f)){let e=await F(f,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${S(c)}Module\\s*\\}\\s*from\\s*['"][^'"]*${S(l)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=Yn(e,c),e=e.replace(/\n{3,}/g,`
+`);return}await Fe(d,{recursive:!0,force:!0}),console.log(`  Deleted: ${d}`);let h=j(n,`index.ts`);if(await f(h)){let e=await I(h,`utf-8`),t=e,n=RegExp(`^import\\s*\\{\\s*${C(l)}Module\\s*\\}\\s*from\\s*['"][^'"]*${C(u)}(?:/[^'"]*)?['"].*\\n?`,`gm`);e=e.replace(n,``),e=Yn(e,l),e=e.replace(/\n{3,}/g,`
 
-`),e!==t&&(await I(f,e,`utf-8`),console.log(`  Unregistered: ${c}Module from ${f}`))}console.log(`\n  Module '${l}' removed.\n`)}function Zn(e){e.command(`remove`).alias(`rm`).description(`Remove generated code`).command(`module <names...>`).description(`Remove one or more modules (e.g. kick rm module user task)`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular module name`).option(`-f, --force`,`Skip confirmation prompt`).action(async(e,t)=>{let n=C(await w(process.cwd())),r=t.modulesDir??n.dir??`src/modules`,i=t.pluralize===!1?!1:n.pluralize??!0;for(let n of e)await Xn({name:n,modulesDir:j(r),force:t.force,pluralize:i})})}function Qn(e){if(e!==void 0){if(e===`false`||e===`off`||e===`none`)return!1;if(e===`zod`)return`zod`;console.warn(`  kick typegen: unknown --schema-validator '${e}' (only 'zod' and 'false' are supported). Falling back to project config.`)}}function $n(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function er(e){e.command(`typegen`).description(`Generate type-safe DI registry and module types into .kickjs/types/`).option(`-w, --watch`,`Watch source files and regenerate on change`).option(`-s, --src <dir>`,`Source directory to scan`,`src`).option(`-o, --out <dir>`,`Output directory`,`.kickjs/types`).option(`--silent`,`Suppress output`).option(`--allow-duplicates`,`Auto-namespace duplicate class names instead of failing (use with caution)`).option(`--schema-validator <name>`,`Schema validator for body/query/params typing (currently 'zod' or 'false')`).option(`--env-file <path>`,`Path to env schema file for KickEnv typing (default 'src/env.ts'; pass 'false' to disable)`).option(`--check`,`CI gate: fail on plugin-typegen drift instead of writing`).option(`--list`,"List every registered typegen plugin id (use to populate `typegen.disable`)").action(async e=>{let t=process.cwd(),n=await w(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-CVRofuDz.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await import(`./builtins-BpWIctor.mjs`),r=e([...t,...n?.plugins??[]],n?.commands??[]),i=new Set(n?.typegen?.disable??[]);if(r.typegens.length===0){console.log(`  No typegen plugins registered.`);return}let a=Math.max(...r.typegens.map(e=>e.id.length));console.log(`
+`),e!==t&&(await L(h,e,`utf-8`),console.log(`  Unregistered: ${l}Module from ${h}`))}console.log(`\n  Module '${u}' removed.\n`)}function Zn(e){e.command(`remove`).alias(`rm`).description(`Remove generated code`).command(`module <names...>`).description(`Remove one or more modules (e.g. kick rm module user task)`).option(`--modules-dir <dir>`,`Modules directory`).option(`--no-pluralize`,`Use singular module name`).option(`-f, --force`,`Skip confirmation prompt`).action(async(e,t)=>{let n=T(await E(process.cwd())),r=t.modulesDir??n.dir??`src/modules`,i=t.pluralize===!1?!1:n.pluralize??!0;for(let n of e)await Xn({name:n,modulesDir:N(r),force:t.force,pluralize:i})})}function Qn(e){if(e!==void 0){if(e===`false`||e===`off`||e===`none`)return!1;if(e===`zod`)return`zod`;console.warn(`  kick typegen: unknown --schema-validator '${e}' (only 'zod' and 'false' are supported). Falling back to project config.`)}}function $n(e){if(e!==void 0)return e===`false`||e===`off`||e===`none`?!1:e}function er(e){e.command(`typegen`).description(`Generate type-safe DI registry and module types into .kickjs/types/`).option(`-w, --watch`,`Watch source files and regenerate on change`).option(`-s, --src <dir>`,`Source directory to scan`,`src`).option(`-o, --out <dir>`,`Output directory`,`.kickjs/types`).option(`--silent`,`Suppress output`).option(`--allow-duplicates`,`Auto-namespace duplicate class names instead of failing (use with caution)`).option(`--schema-validator <name>`,`Schema validator for body/query/params typing (currently 'zod' or 'false')`).option(`--env-file <path>`,`Path to env schema file for KickEnv typing (default 'src/env.ts'; pass 'false' to disable)`).option(`--check`,`CI gate: fail on plugin-typegen drift instead of writing`).option(`--list`,"List every registered typegen plugin id (use to populate `typegen.disable`)").action(async e=>{let t=he(process.cwd()),n=await E(t);if(e.list){let{mergeCliPlugins:e}=await import(`./plugin-B6ANfh7O.mjs`).then(e=>e.t),{builtinCliPlugins:t}=await import(`./builtins-BIpoT6cb.mjs`),r=e([...t,...n?.plugins??[]],n?.commands??[]),i=new Set(n?.typegen?.disable??[]);if(r.typegens.length===0){console.log(`  No typegen plugins registered.`);return}let a=Math.max(...r.typegens.map(e=>e.id.length));console.log(`
   Registered typegen plugins:
-`);for(let e of r.typegens){let t=i.has(e.id)?` (disabled)`:``;console.log(`    ${e.id.padEnd(a+2)}inputs: ${e.inputs.join(`, `)||`(none)`}${t}`)}console.log();return}let r=Qn(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=$n(e.envFile)??n?.typegen?.envFile,a={cwd:t,srcDir:e.src??n?.typegen?.srcDir,outDir:e.out??n?.typegen?.outDir,silent:e.silent,allowDuplicates:e.allowDuplicates,schemaValidator:r,envFile:i,assetMap:n?.assetMap,runPlugins:!1};try{if(e.watch){let t=await ve(a);e.silent||console.log(`  kick typegen: watching for changes (Ctrl-C to exit)`);let n=()=>{t(),process.exit(0)};process.on(`SIGINT`,n),process.on(`SIGTERM`,n),await new Promise(()=>{})}else{let{result:r}=await E(a),i=await W({cwd:t,config:n??null,silent:e.silent,check:e.check});e.check&&i.some(e=>e.status===`written`)&&process.exit(1),e.check||await ye(j(t,e.out??n?.typegen?.outDir??`.kickjs/types`),r.written,i,e.silent??!1)}}catch(e){e instanceof xe?console.error(`
+`);for(let e of r.typegens){let t=i.has(e.id)?` (disabled)`:``;console.log(`    ${e.id.padEnd(a+2)}inputs: ${e.inputs.join(`, `)||`(none)`}${t}`)}console.log();return}let r=Qn(e.schemaValidator)??n?.typegen?.schemaValidator??`zod`,i=$n(e.envFile)??n?.typegen?.envFile,a={cwd:t,srcDir:e.src??n?.typegen?.srcDir,outDir:e.out??n?.typegen?.outDir,silent:e.silent,allowDuplicates:e.allowDuplicates,schemaValidator:r,envFile:i,assetMap:n?.assetMap,runPlugins:!1};try{if(e.watch){let t=await ye(a);e.silent||console.log(`  kick typegen: watching for changes (Ctrl-C to exit)`);let n=()=>{t(),process.exit(0)};process.on(`SIGINT`,n),process.on(`SIGTERM`,n),await new Promise(()=>{})}else{let{result:r}=await O(a),i=await rn({cwd:t,config:n??null,silent:e.silent,check:e.check});e.check&&i.some(e=>e.status===`written`)&&process.exit(1),e.check||await be(N(t,e.out??n?.typegen?.outDir??`.kickjs/types`),r.written,i,e.silent??!1)}}catch(e){e instanceof Se?console.error(`
 `+e.message+`
-`):e instanceof Error?console.error(`\n  kick typegen failed: ${e.message}`):console.error(`\n  kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function tr(e){let t=[];if(!M(e))return t;let n=Ee(e,{withFileTypes:!0});for(let r of n){let n=k(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...tr(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function nr(e){try{return P(e,`utf-8`)}catch{return``}}const rr=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function ir(e,t){let n=nr(k(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(rr.has(t.toLowerCase())||t.length<32)return{severity:`CRITICAL`,message:`JWT_SECRET appears to be a default value or too short (< 32 chars) — change it`}}}for(let e of t)for(let t of[/JWT_SECRET['"]?\s*[:=]\s*['"]?(secret|changeme|password|test|default)['"]?/i,/secret\s*[:=]\s*['"]?(secret|changeme|password|test|default)['"]?/i])if(t.test(e))return{severity:`CRITICAL`,message:`JWT_SECRET appears to be a default value in source code — use an environment variable`};return null}function ar(e){for(let t of e)if(/cors\s*\(/.test(t)&&/origin\s*:\s*['"]\*['"]/.test(t))return{severity:`CRITICAL`,message:`CORS origin is '*' — restrict to your domains`};return null}function or(e){for(let t of e)if(/rateLimit/i.test(t)||/@RateLimit/i.test(t))return null;return{severity:`WARNING`,message:`No rate limiting detected — add rateLimit() middleware or @RateLimit decorator`}}function sr(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function cr(e){let t=!1,n=!1;for(let r of e)/tokenStore/i.test(r)&&(t=!0),/MemoryTokenStore/i.test(r)&&(n=!0);return n?{severity:`WARNING`,message:`MemoryTokenStore detected — use a persistent store (Redis, DB) for production deployments`}:t?null:{severity:`WARNING`,message:`No token revocation store detected — consider adding one for auth token management`}}function lr(e){for(let t of e)if(/helmet\s*\(/.test(t))return/security\s*\.\s*helmet\s*.*false/.test(t)?{severity:`WARNING`,message:`Helmet security headers are disabled — enable them for production`}:{severity:`INFO`,message:`Helmet security headers active`};return{severity:`WARNING`,message:`Helmet not detected — add helmet() middleware for security headers`}}function ur(e){for(let t of e)if(/AuthAdapter/i.test(t))return{severity:`INFO`,message:`AuthAdapter configured`};return{severity:`INFO`,message:`No AuthAdapter detected — add one if your app requires authentication`}}function dr(e){let t=tr(k(e,`src`)).map(e=>nr(e)),n=[],r=ir(e,t);r&&n.push(r);let i=ar(t);i&&n.push(i);let a=or(t);a&&n.push(a);let o=sr();o&&n.push(o);let s=cr(t);return s&&n.push(s),n.push(lr(t)),n.push(ur(t)),n}function fr(e){e.command(`check`).description(`Audit project for common issues`).option(`--deploy`,`Run production readiness checks`).action(e=>{if(!e.deploy){console.log(`
+`):e instanceof Error?console.error(`\n  kick typegen failed: ${e.message}`):console.error(`\n  kick typegen failed: ${JSON.stringify(e)}`),process.exit(1)}})}function tr(e){let t=[];if(!P(e))return t;let n=Oe(e,{withFileTypes:!0});for(let r of n){let n=j(e,r.name);if(r.isDirectory()){if([`node_modules`,`dist`,`.kickjs`,`.git`].includes(r.name))continue;t.push(...tr(n))}else r.isFile()&&/\.tsx?$/.test(r.name)&&!r.name.endsWith(`.d.ts`)&&t.push(n)}return t}function nr(e){try{return F(e,`utf-8`)}catch{return``}}const rr=new Set([`secret`,`changeme`,`password`,`test`,`default`,``]);function ir(e,t){let n=nr(j(e,`.env`));if(n){let e=n.match(/^JWT_SECRET\s*=\s*['"]?([^'"\n]*)['"]?/m);if(e){let t=e[1].trim();if(rr.has(t.toLowerCase())||t.length<32)return{severity:`CRITICAL`,message:`JWT_SECRET appears to be a default value or too short (< 32 chars) — change it`}}}for(let e of t)for(let t of[/JWT_SECRET['"]?\s*[:=]\s*['"]?(secret|changeme|password|test|default)['"]?/i,/secret\s*[:=]\s*['"]?(secret|changeme|password|test|default)['"]?/i])if(t.test(e))return{severity:`CRITICAL`,message:`JWT_SECRET appears to be a default value in source code — use an environment variable`};return null}function ar(e){for(let t of e)if(/cors\s*\(/.test(t)&&/origin\s*:\s*['"]\*['"]/.test(t))return{severity:`CRITICAL`,message:`CORS origin is '*' — restrict to your domains`};return null}function or(e){for(let t of e)if(/rateLimit/i.test(t)||/@RateLimit/i.test(t))return null;return{severity:`WARNING`,message:`No rate limiting detected — add rateLimit() middleware or @RateLimit decorator`}}function sr(){return process.env.NODE_ENV===`production`?null:{severity:`WARNING`,message:`NODE_ENV is '${process.env.NODE_ENV??`undefined`}', not 'production'`}}function cr(e){let t=!1,n=!1;for(let r of e)/tokenStore/i.test(r)&&(t=!0),/MemoryTokenStore/i.test(r)&&(n=!0);return n?{severity:`WARNING`,message:`MemoryTokenStore detected — use a persistent store (Redis, DB) for production deployments`}:t?null:{severity:`WARNING`,message:`No token revocation store detected — consider adding one for auth token management`}}function lr(e){for(let t of e)if(/helmet\s*\(/.test(t))return/security\s*\.\s*helmet\s*.*false/.test(t)?{severity:`WARNING`,message:`Helmet security headers are disabled — enable them for production`}:{severity:`INFO`,message:`Helmet security headers active`};return{severity:`WARNING`,message:`Helmet not detected — add helmet() middleware for security headers`}}function ur(e){for(let t of e)if(/AuthAdapter/i.test(t))return{severity:`INFO`,message:`AuthAdapter configured`};return{severity:`INFO`,message:`No AuthAdapter detected — add one if your app requires authentication`}}function dr(e){let t=tr(j(e,`src`)).map(e=>nr(e)),n=[],r=ir(e,t);r&&n.push(r);let i=ar(t);i&&n.push(i);let a=or(t);a&&n.push(a);let o=sr();o&&n.push(o);let s=cr(t);return s&&n.push(s),n.push(lr(t)),n.push(ur(t)),n}function fr(e){e.command(`check`).description(`Audit project for common issues`).option(`--deploy`,`Run production readiness checks`).action(e=>{if(!e.deploy){console.log(`
   Usage: kick check --deploy
 
   Available checks:
     --deploy    Audit for production readiness (security, config, best practices)
-`);return}let t=process.cwd();r(`KickJS Deploy Check`);let a=ne();a.start(`Scanning project...`);let o=dr(t);a.stop(`Scan complete`);let s={CRITICAL:0,WARNING:1,INFO:2};o.sort((e,t)=>s[e.severity]-s[t.severity]);for(let e of o)n.message(`${i(e.severity)} ${e.message}`);let c=o.filter(e=>e.severity===`CRITICAL`).length,l=o.filter(e=>e.severity===`WARNING`).length,d=o.filter(e=>e.severity===`INFO`).length,f=l===1?`warning`:`warnings`,p=[c>0?u.red(`${c} critical`):`${c} critical`,l>0?u.yellow(`${l} ${f}`):`${l} ${f}`,`${d} info`].join(`, `);c>0?(b(u.red(`${p} — fix critical issues before deploying`)),process.exit(1)):b(u.green(`${p} — looking good!`))})}async function Q(e){return Qe({configPath:D.resolve(process.cwd(),e.config)})}async function $(e){if(e.adapter){let t=await e.adapter();return{adapter:t,cleanup:async()=>t.close()}}if(!e.connectionString)throw Error(`kickjs-db: no adapter resolved — set db.connectionString (or DATABASE_URL) in kick.config.ts, or supply db.adapter() factory`);let t=e.dialect??`postgres`;if(t!==`postgres`)throw Error(`kickjs-db: built-in CLI adapter only supports postgres in M1 (dialect=${t}); use db.adapter() factory for other dialects`);let[{pgAdapter:n},r]=await Promise.all([import(`@forinda/kickjs-db-pg`),import(`pg`)]),i=new r.default.Pool({connectionString:e.connectionString}),a=n({pool:i});return{adapter:a,cleanup:async()=>{await a.close(),await i.end()}}}async function pr(e){if(e.adapter||(e.dialect??`postgres`)!==`postgres`||!e.connectionString)return null;let t=new(await(import(`pg`))).default.Pool({connectionString:e.connectionString});return{runner:t,cleanup:async()=>{await t.end()}}}function mr(e){if(e.length===0){console.log(`No migrations.`);return}console.table(e.map(e=>({id:e.id,state:e.state,batch:e.batch??`-`,reviewed:e.reviewed,applied:e.appliedAt??`-`})))}function hr(e){let t=e.command(`db`).description(`Database commands (kickjs-db)`);t.command(`generate <name>`).description(`Generate a new migration from schema diff`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`-e, --empty`,`Skip schema diff and create an empty migration shell (data migration, seed, freeform SQL)`).action(async(e,t)=>{let n=process.cwd(),r=await Q(t),i=await pr(r),a=i?e=>We(i.runner,e):void 0;try{let i=await Ge({name:e,config:r,cwd:n,empty:t.empty,detectCompositeRefs:a});if(i.status===`no-changes`){console.log(`No schema changes detected.`);return}if(i.empty){console.log(`Created empty migration ${i.migrationDir} (author up.sql + down.sql).`);return}let o=i.changeCount===1?``:`s`;console.log(`Created migration ${i.migrationDir} (${i.changeCount} change${o}).`)}finally{await i?.cleanup()}});let n=t.command(`migrate`).description(`Migration runner subcommands`);n.command(`latest`).description(`Apply all pending migrations in a new batch`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`--confirm-enum-drop`,"Allow migrations carrying the `-- KICK ENUM REMOVE` header to apply",!1).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let r=await qe({adapter:n,migrationsDir:t.migrationsDir,confirmEnumDrop:e.confirmEnumDrop});r.applied.length===0?console.log(`No pending migrations.`):console.log(`Applied batch ${r.batch}: ${r.applied.join(`, `)}`)}finally{await r()}}),n.command(`up`).description(`Apply the next single pending migration`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`--confirm-enum-drop`,"Allow migrations carrying the `-- KICK ENUM REMOVE` header to apply",!1).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let r=await Xe({adapter:n,migrationsDir:t.migrationsDir,confirmEnumDrop:e.confirmEnumDrop});r.applied.length===0?console.log(`No pending migrations.`):console.log(`Applied ${r.applied[0]} (batch ${r.batch})`)}finally{await r()}}),n.command(`down`).description(`Reverse the most recent applied migration`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let e=await Ke({adapter:n,migrationsDir:t.migrationsDir});e.reversed?console.log(`Reversed ${e.reversed}.`):console.log(`Nothing to reverse.`)}finally{await r()}}),n.command(`rollback`).description(`Reverse the entire last batch as a single unit`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let e=await Je({adapter:n,migrationsDir:t.migrationsDir});e.reversed.length===0?console.log(`Nothing to roll back.`):console.log(`Rolled back batch ${e.batch}: ${e.reversed.join(`, `)}`)}finally{await r()}}),n.command(`status`).description(`Print applied + pending migrations`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{mr(await Ye({adapter:n,migrationsDir:t.migrationsDir}))}finally{await r()}}),t.command(`introspect`).description(`Generate a TypeScript schema file from a live database`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`--out <path>`,`Output file (defaults to db.schemaPath from config)`).option(`--json`,`Print the raw SchemaSnapshot JSON to stdout instead of writing TS source`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let r=await n.introspect();if(e.json){console.log(JSON.stringify(r,null,2));return}let i=e.out??t.schemaPath;await I(i,Ze(r),`utf8`);let a=Object.keys(r.tables).length;console.log(`Wrote ${i} (${a} table${a===1?``:`s`}).`)}finally{await r()}})}function gr(e){return e.optsWithGlobals().dryRun??!1}function _r(e){e.command(`codemod`).description(`Codebase migration commands (AST-style rewrites — distinct from db migrate)`).command(`modules`).description(`Rewrite module declarations between class form and the defineModule factory.
+`);return}let t=process.cwd();u(`KickJS Deploy Check`);let n=l();n.start(`Scanning project...`);let r=dr(t);n.stop(`Scan complete`);let i={CRITICAL:0,WARNING:1,INFO:2};r.sort((e,t)=>i[e.severity]-i[t.severity]);for(let e of r)S.message(`${s(e.severity)} ${e.message}`);let a=r.filter(e=>e.severity===`CRITICAL`).length,c=r.filter(e=>e.severity===`WARNING`).length,d=r.filter(e=>e.severity===`INFO`).length,f=c===1?`warning`:`warnings`,p=[a>0?o.red(`${a} critical`):`${a} critical`,c>0?o.yellow(`${c} ${f}`):`${c} ${f}`,`${d} info`].join(`, `);a>0?(x(o.red(`${p} — fix critical issues before deploying`)),process.exit(1)):x(o.green(`${p} — looking good!`))})}async function Q(e){return et({configPath:k.resolve(process.cwd(),e.config)})}async function $(e){if(e.adapter){let t=await e.adapter();return{adapter:t,cleanup:async()=>t.close()}}if(!e.connectionString)throw Error(`kickjs-db: no adapter resolved — set db.connectionString (or DATABASE_URL) in kick.config.ts, or supply db.adapter() factory`);let t=e.dialect??`postgres`;if(t!==`postgres`)throw Error(`kickjs-db: built-in CLI adapter only supports postgres in M1 (dialect=${t}); use db.adapter() factory for other dialects`);let[{pgAdapter:n},r]=await Promise.all([import(`@forinda/kickjs-db-pg`),import(`pg`)]),i=new r.default.Pool({connectionString:e.connectionString}),a=n({pool:i});return{adapter:a,cleanup:async()=>{await a.close(),await i.end()}}}async function pr(e){if(e.adapter||(e.dialect??`postgres`)!==`postgres`||!e.connectionString)return null;let t=new(await(import(`pg`))).default.Pool({connectionString:e.connectionString});return{runner:t,cleanup:async()=>{await t.end()}}}function mr(e){if(e.length===0){console.log(`No migrations.`);return}console.table(e.map(e=>({id:e.id,state:e.state,batch:e.batch??`-`,reviewed:e.reviewed,applied:e.appliedAt??`-`})))}function hr(e){let t=e.command(`db`).description(`Database commands (kickjs-db)`);t.command(`generate <name>`).description(`Generate a new migration from schema diff`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`-e, --empty`,`Skip schema diff and create an empty migration shell (data migration, seed, freeform SQL)`).action(async(e,t)=>{let n=process.cwd(),r=await Q(t),i=await pr(r),a=i?e=>Ke(i.runner,e):void 0;try{let i=await qe({name:e,config:r,cwd:n,empty:t.empty,detectCompositeRefs:a});if(i.status===`no-changes`){console.log(`No schema changes detected.`);return}if(i.empty){console.log(`Created empty migration ${i.migrationDir} (author up.sql + down.sql).`);return}let o=i.changeCount===1?``:`s`;console.log(`Created migration ${i.migrationDir} (${i.changeCount} change${o}).`)}finally{await i?.cleanup()}});let n=t.command(`migrate`).description(`Migration runner subcommands`);n.command(`latest`).description(`Apply all pending migrations in a new batch`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`--confirm-enum-drop`,"Allow migrations carrying the `-- KICK ENUM REMOVE` header to apply",!1).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let r=await Ye({adapter:n,migrationsDir:t.migrationsDir,confirmEnumDrop:e.confirmEnumDrop});r.applied.length===0?console.log(`No pending migrations.`):console.log(`Applied batch ${r.batch}: ${r.applied.join(`, `)}`)}finally{await r()}}),n.command(`up`).description(`Apply the next single pending migration`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`--confirm-enum-drop`,"Allow migrations carrying the `-- KICK ENUM REMOVE` header to apply",!1).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let r=await Qe({adapter:n,migrationsDir:t.migrationsDir,confirmEnumDrop:e.confirmEnumDrop});r.applied.length===0?console.log(`No pending migrations.`):console.log(`Applied ${r.applied[0]} (batch ${r.batch})`)}finally{await r()}}),n.command(`down`).description(`Reverse the most recent applied migration`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let e=await Je({adapter:n,migrationsDir:t.migrationsDir});e.reversed?console.log(`Reversed ${e.reversed}.`):console.log(`Nothing to reverse.`)}finally{await r()}}),n.command(`rollback`).description(`Reverse the entire last batch as a single unit`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let e=await Xe({adapter:n,migrationsDir:t.migrationsDir});e.reversed.length===0?console.log(`Nothing to roll back.`):console.log(`Rolled back batch ${e.batch}: ${e.reversed.join(`, `)}`)}finally{await r()}}),n.command(`status`).description(`Print applied + pending migrations`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{mr(await Ze({adapter:n,migrationsDir:t.migrationsDir}))}finally{await r()}}),t.command(`introspect`).description(`Generate a TypeScript schema file from a live database`).option(`-c, --config <path>`,`Path to kick.config.ts`,`kick.config.ts`).option(`--out <path>`,`Output file (defaults to db.schemaPath from config)`).option(`--json`,`Print the raw SchemaSnapshot JSON to stdout instead of writing TS source`).action(async e=>{let t=await Q(e),{adapter:n,cleanup:r}=await $(t);try{let r=await n.introspect();if(e.json){console.log(JSON.stringify(r,null,2));return}let i=e.out??t.schemaPath;await L(i,$e(r),`utf8`);let a=Object.keys(r.tables).length;console.log(`Wrote ${i} (${a} table${a===1?``:`s`}).`)}finally{await r()}})}function gr(e){return e.optsWithGlobals().dryRun??!1}function _r(e){e.command(`codemod`).description(`Codebase migration commands (AST-style rewrites — distinct from db migrate)`).command(`modules`).description(`Rewrite module declarations between class form and the defineModule factory.
   Direction defaults to \`modules.style\` from kick.config (or "define").
   --target define|class  Override the migration direction.
   --apply                Apply the changes (default: dry-run preview).
-  --experimental         Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,t)=>{let n=gr(t)||!e.apply;o(n),e.experimental||(console.error(`
-  `+u.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
+  --experimental         Acknowledge that AST migration is experimental.`).option(`--modules-dir <dir>`,`Modules directory (default: src/modules from kick.config)`).option(`--apply`,`Apply the migration to disk (default: dry-run)`).option(`--experimental`,`Acknowledge that this command is experimental`).option(`--target <style>`,`Migration direction — 'define' or 'class'`).option(`--no-backup`,`Skip the .kickjs/codemod-backups/ snapshot (default: backup on)`).action(async(e,t)=>{let n=gr(t)||!e.apply;w(n),e.experimental||(console.error(`
+  `+o.red(`Error:`)+` kick codemod modules is experimental — pass --experimental to acknowledge.
   The regex-based rewrite handles the shapes our templates produce.
   Hand-rolled modules with non-standard structures may be skipped.
   Always commit before running with --apply.
-`),process.exit(1));let r=C(await w(process.cwd())),i=j(e.modulesDir??r.dir??`src/modules`),a;e.target===`define`||e.target===`class`?a=e.target:e.target===void 0?a=r.style??`define`:(console.error(`\n  ${u.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let s=u.dim(`→ ${a}`),c=n?u.dim(`(dry-run)`):u.bold(`(applying)`);console.log(`\n  ${u.bold(`kick codemod modules`)} ${s} ${c}`),console.log(`  modulesDir: ${u.dim(i)}\n`);let l=e.backup!==!1&&!n,d=await Tt(i,{dryRun:n,target:a,backup:l});if(d.backupDir){let e=d.backupDir;console.log(`  ${u.green(`✓`)} backup: ${u.dim(e)}\n    ${u.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else !n&&e.backup===!1&&console.log(`  ${u.dim(`(--no-backup — skipping snapshot)`)}\n`);let f=0,p=0;for(let e of d.files)if(e.status===`migrated`)f++,console.log(`    ${u.green(`✓`)} ${e.path}`);else{p++;let t=u.dim(`(${e.reason??`skipped`})`);console.log(`    ${u.dim(`-`)} ${e.path} ${t}`)}if(console.log(),d.indexStatus===`migrated`)console.log(`    ${u.green(`✓`)} ${d.indexPath}`);else if(d.indexStatus===`skipped`){let e=u.dim(`(${d.indexReason??`skipped`})`);console.log(`    ${u.dim(`-`)} ${d.indexPath} ${e}`)}else console.log(`    ${u.dim(`-`)} ${d.indexPath} ${u.dim(`(not found)`)}`);let m=n?u.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n  ${u.bold(String(f))} migrated, ${u.bold(String(p))} skipped${m}\n`)})}const vr=[`src/db/schema.ts`,`src/db/schema/index.ts`,`src/db/schema`],yr=()=>({id:`kick/db`,inputs:[`src/db/schema.ts`,`src/db/schema/**/*.ts`],async generate(e){let t=br(e.cwd);if(!t)return null;let n=D.resolve(e.cwd,`.kickjs/types`);return[`import type { SchemaToTypes, SchemaToRelationsRegister, KickDbClient } from '@forinda/kickjs-db'`,`import type * as appSchema from '${xr(D.relative(n,t)).replace(/\.ts$/,``).replace(/\/index$/,``)}'`,``,`declare global {`,`  interface KickDbSchema extends SchemaToTypes<typeof appSchema> {}`,`}`,``,`declare module '@forinda/kickjs-db' {`,`  interface KickDbRegister {`,`    db: KickDbClient<KickDbSchema>`,`  }`,``,`  interface KickDbRelationsRegister {`,`    db: SchemaToRelationsRegister<typeof appSchema>`,`  }`,`}`].join(`
-`)}});function br(e){for(let t of vr){let n=D.resolve(e,t);if(t.endsWith(`.ts`)){if(M(n))return n}else{let e=D.join(n,`index.ts`);if(M(e))return e}}return null}function xr(e){return e.replace(/\\/g,`/`)}const Sr=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){if(!M(D.resolve(e.cwd,`kick.config.ts`)))return null;let t=await w(e.cwd);if(!t?.assetMap)return null;let n=ge(t.assetMap,e.cwd);return n.count===0?null:be(n)}}),Cr="/* eslint-disable */\n// AUTO-GENERATED by `kick typegen`. DO NOT EDIT.\n// Re-run with `kick typegen` or rely on `kick dev` to refresh.\n";function wr(e,t,n){if(e.length===0)return`${Cr}
+`),process.exit(1));let r=T(await E(process.cwd())),i=N(e.modulesDir??r.dir??`src/modules`),a;e.target===`define`||e.target===`class`?a=e.target:e.target===void 0?a=r.style??`define`:(console.error(`\n  ${o.red(`Error:`)} --target must be 'define' or 'class' (got '${e.target}').\n`),process.exit(1));let s=o.dim(`→ ${a}`),c=n?o.dim(`(dry-run)`):o.bold(`(applying)`);console.log(`\n  ${o.bold(`kick codemod modules`)} ${s} ${c}`),console.log(`  modulesDir: ${o.dim(i)}\n`);let l=e.backup!==!1&&!n,u=await Dt(i,{dryRun:n,target:a,backup:l});if(u.backupDir){let e=u.backupDir;console.log(`  ${o.green(`✓`)} backup: ${o.dim(e)}\n    ${o.dim(`(restore: rm -rf <modulesDir> && mv "<backup>" <modulesDir>)`)}\n`)}else !n&&e.backup===!1&&console.log(`  ${o.dim(`(--no-backup — skipping snapshot)`)}\n`);let d=0,f=0;for(let e of u.files)if(e.status===`migrated`)d++,console.log(`    ${o.green(`✓`)} ${e.path}`);else{f++;let t=o.dim(`(${e.reason??`skipped`})`);console.log(`    ${o.dim(`-`)} ${e.path} ${t}`)}if(console.log(),u.indexStatus===`migrated`)console.log(`    ${o.green(`✓`)} ${u.indexPath}`);else if(u.indexStatus===`skipped`){let e=o.dim(`(${u.indexReason??`skipped`})`);console.log(`    ${o.dim(`-`)} ${u.indexPath} ${e}`)}else console.log(`    ${o.dim(`-`)} ${u.indexPath} ${o.dim(`(not found)`)}`);let p=n?o.dim(` (dry-run — pass --apply to write)`):``;console.log(`\n  ${o.bold(String(d))} migrated, ${o.bold(String(f))} skipped${p}\n`)})}const vr=[`src/db/schema.ts`,`src/db/schema/index.ts`,`src/db/schema`],yr=()=>({id:`kick/db`,inputs:[`src/db/schema.ts`,`src/db/schema/**/*.ts`],async generate(e){let t=br(e.cwd);if(!t)return null;let n=k.resolve(e.cwd,`.kickjs/types`);return[`import type { SchemaToTypes, SchemaToRelationsRegister, KickDbClient } from '@forinda/kickjs-db'`,`import type * as appSchema from '${xr(k.relative(n,t)).replace(/\.ts$/,``).replace(/\/index$/,``)}'`,``,`declare global {`,`  interface KickDbSchema extends SchemaToTypes<typeof appSchema> {}`,`}`,``,`declare module '@forinda/kickjs-db' {`,`  interface KickDbRegister {`,`    db: KickDbClient<KickDbSchema>`,`  }`,``,`  interface KickDbRelationsRegister {`,`    db: SchemaToRelationsRegister<typeof appSchema>`,`  }`,`}`].join(`
+`)}});function br(e){for(let t of vr){let n=k.resolve(e,t);if(t.endsWith(`.ts`)){if(P(n))return n}else{let e=k.join(n,`index.ts`);if(P(e))return e}}return null}function xr(e){return e.replace(/\\/g,`/`)}const Sr=()=>({id:`kick/assets`,inputs:[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`],async generate(e){if(!P(k.resolve(e.cwd,`kick.config.ts`)))return null;let t=await E(e.cwd);if(!t?.assetMap)return null;let n=_e(t.assetMap,e.cwd);return n.count===0?null:xe(n)}}),Cr="/* eslint-disable */\n// AUTO-GENERATED by `kick typegen`. DO NOT EDIT.\n// Re-run with `kick typegen` or rely on `kick dev` to refresh.\n";function wr(e,t,n){if(e.length===0)return`${Cr}
 // (no routes discovered yet — annotate a controller method with
 //  @Get/@Post/@Put/@Delete/@Patch and re-run \`kick typegen\`)
 declare global {
@@ -1089,7 +891,7 @@ ${o.join(`
 export {}
 `}function Tr(e){if(e.queryFilterable===null)return`unknown`;let t=e.querySortable??[];return`{ filter?: string | string[]; sort?: ${t.length>0?t.flatMap(e=>[`'${e}'`,`'-${e}'`]).join(` | `):`string`}; q?: string; page?: string; limit?: string }`}function Er(e){let t=[];return e.queryFilterable&&e.queryFilterable.length>0&&t.push(`Filterable: ${e.queryFilterable.join(`, `)}`),e.querySortable&&e.querySortable.length>0&&t.push(`Sortable: ${e.querySortable.join(`, `)}`),e.querySearchable&&e.querySearchable.length>0&&t.push(`Searchable: ${e.querySearchable.join(`, `)}`),t}function Dr(e,t,n,r,i){if(!e||r!==`zod`||e.source===null)return null;let a=kr(e.source,t,n);if(a===`unknown`)return null;let o=`${a}::${e.identifier}`,s=i.get(o)?.specifier;return s?s=i.get(o).specifier:(s=`_S${i.size}`,i.set(o,{identifier:e.identifier,specifier:s})),s}function Or(e){if(e.size===0)return``;let t=[];for(let[n,r]of e){let[e]=n.split(`::`);t.push(`import type { ${r.identifier} as ${r.specifier} } from '${e}'`)}return t.join(`
 `)+`
-`}function kr(e,t,n){if(e===null)return`unknown`;let r=O(n);if(e===``){let e=A(r,t).split(we).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=A(r,j(O(t),e)).split(we).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),i}const Ar=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:jr(e),cwd:e.cwd,envFile:Mr(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=D.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return wr(t.routes,r,n)}});function jr(e){return D.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Mr(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function Nr(e,t){if(!e)return null;let n=A(O(t),e.filePath).split(we).join(`/`);return n=n.replace(/\.(ts|tsx|mts|cts)$/i,``),n.startsWith(`.`)||(n=`./`+n),`/* eslint-disable */
+`}function kr(e,t,n){if(e===null)return`unknown`;let r=A(n);if(e===``){let e=M(r,t).split(Te).join(`/`);return e=e.replace(/\.(ts|tsx|mts|cts)$/i,``),e.startsWith(`.`)||(e=`./`+e),e}if(!e.startsWith(`.`)&&!e.startsWith(`/`))return e;let i=M(r,N(A(t),e)).split(Te).join(`/`);return i=i.replace(/\.(ts|tsx|mts|cts)$/i,``),i.startsWith(`.`)||(i=`./`+i),i}const Ar=()=>({id:`kick/routes`,outExtension:`.ts`,inputs:[`src/**/*.controller.ts`,`src/**/*.module.ts`],async generate(e){let t=await e.getScanResult({root:jr(e),cwd:e.cwd,envFile:Mr(e)}),n=e.config?.typegen?.schemaValidator??`zod`,r=k.resolve(e.cwd,`.kickjs/types/kick__routes.ts`);return wr(t.routes,r,n)}});function jr(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Mr(e){let t=e.config?.typegen?.envFile;if(t!==!1)return t}function Nr(e,t){if(!e)return null;let n=M(A(t),e.filePath).split(Te).join(`/`);return n=n.replace(/\.(ts|tsx|mts|cts)$/i,``),n.startsWith(`.`)||(n=`./`+n),`/* eslint-disable */
 // AUTO-GENERATED by \`kick typegen\`. DO NOT EDIT.
 // Re-run with \`kick typegen\` or rely on \`kick dev\` to refresh.
 
@@ -1125,5 +927,5 @@ declare global {
 }
 
 export {}
-`}const Pr=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=Ir(e);if(t===!1)return null;let n=await e.getScanResult({root:Fr(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=D.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return Nr(n.env,r)}});function Fr(e){return D.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Ir(e){return e.config?.typegen?.envFile}const Lr=[T({name:`kick/init`,register:ct}),T({name:`kick/generate`,register:en}),T({name:`kick/run`,register:pn}),T({name:`kick/info`,register:mn}),T({name:`kick/inspect`,register:Sn}),T({name:`kick/add`,register:ot}),T({name:`kick/list`,register:at}),T({name:`kick/explain`,register:Mn}),T({name:`kick/mcp`,register:Vn}),T({name:`kick/tinker`,register:Gn}),T({name:`kick/remove`,register:Zn}),T({name:`kick/typegen`,register:er}),T({name:`kick/check`,register:fr}),T({name:`kick/db`,register:hr,typegens:[yr()]}),T({name:`kick/codemod`,register:_r}),T({name:`kick/assets`,typegens:[Sr()]}),T({name:`kick/routes`,typegens:[Ar()]}),T({name:`kick/env`,typegens:[Pr()]})];export{Lr as builtinCliPlugins,an as n,W as t};
-//# sourceMappingURL=builtins-BpWIctor.mjs.map
+`}const Pr=()=>({id:`kick/env`,outExtension:`.ts`,inputs:[`src/env.ts`,`src/**/env.ts`,`src/**/*.env.ts`],async generate(e){let t=Ir(e);if(t===!1)return null;let n=await e.getScanResult({root:Fr(e),cwd:e.cwd,envFile:t});if(!n.env)return null;let r=k.resolve(e.cwd,`.kickjs/types/kick__env.ts`);return Nr(n.env,r)}});function Fr(e){return k.resolve(e.cwd,e.config?.typegen?.srcDir??`src`)}function Ir(e){return e.config?.typegen?.envFile}const Lr=[D({name:`kick/init`,register:ut}),D({name:`kick/generate`,register:Zt}),D({name:`kick/run`,register:fn}),D({name:`kick/info`,register:pn}),D({name:`kick/inspect`,register:Sn}),D({name:`kick/add`,register:ct}),D({name:`kick/list`,register:st}),D({name:`kick/explain`,register:Mn}),D({name:`kick/mcp`,register:Vn}),D({name:`kick/tinker`,register:Gn}),D({name:`kick/remove`,register:Zn}),D({name:`kick/typegen`,register:er}),D({name:`kick/check`,register:fr}),D({name:`kick/db`,register:hr,typegens:[yr()]}),D({name:`kick/codemod`,register:_r}),D({name:`kick/assets`,typegens:[Sr()]}),D({name:`kick/routes`,typegens:[Ar()]}),D({name:`kick/env`,typegens:[Pr()]})];export{nn as applyDisableFilter,rn as runAllPluginTypegens,Lr as t};
+//# sourceMappingURL=run-plugins-DaO1FtZb.mjs.map