@forinda/kickjs-cli 6.6.0 → 6.7.0

package/dist/{fullstack-BgwfRTCN.mjs → fullstack-Cmedpn8G.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v6.6.0
+ * @forinda/kickjs-cli v6.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,10 +8,10 @@
  *
  * @license MIT
  */
-import{l as e}from"./project-docs-BSNKPfLT.mjs";import{n as t,t as n}from"./project-QWNGOwFX.mjs";import{join as r}from"node:path";import{execFileSync as i}from"node:child_process";async function a(a){let{name:_,directory:v,schemaLib:y=`zod`,runtime:b=`express`}=a,x=[`pnpm`,`npm`,`yarn`,`bun`].includes(a.packageManager),S=x?a.packageManager:`pnpm`,C=v,w=e=>console.log(`  ${e}`);a.packageManager!==void 0&&!x&&w(`Warning: unknown package manager '${String(a.packageManager)}' — falling back to pnpm.`),console.log(`\n  Creating fullstack KickJS workspace: ${_}\n`),await n({name:`${_}-server`,directory:r(C,`server`),packageManager:S,template:`minimal`,schemaLib:y,runtime:b,initGit:!1,installDeps:!1});let T=(await t())[`@forinda/kickjs-client`]??`^0.1.0`;await e(r(C,`web/package.json`),o(_,T)),await e(r(C,`web/vite.config.ts`),s()),await e(r(C,`web/tsconfig.json`),c()),await e(r(C,`web/index.html`),l(_)),await e(r(C,`web/src/main.tsx`),u()),await e(r(C,`web/src/App.tsx`),d()),await e(r(C,`web/src/api.ts`),f()),await e(r(C,`web/src/types/kick-routes.d.ts`),p()),await e(r(C,`package.json`),m(_,S)),await e(r(C,`pnpm-workspace.yaml`),`packages:
+import{l as e}from"./project-docs-BV-h5EmP.mjs";import{n as t,t as n}from"./project-CnU7KcYI.mjs";import{join as r}from"node:path";import{execFileSync as i}from"node:child_process";async function a(a){let{name:_,directory:v,schemaLib:y=`zod`,runtime:b=`express`}=a,x=[`pnpm`,`npm`,`yarn`,`bun`].includes(a.packageManager),S=x?a.packageManager:`pnpm`,C=v,w=e=>console.log(`  ${e}`);a.packageManager!==void 0&&!x&&w(`Warning: unknown package manager '${String(a.packageManager)}' — falling back to pnpm.`),console.log(`\n  Creating fullstack KickJS workspace: ${_}\n`),await n({name:`${_}-server`,directory:r(C,`server`),packageManager:S,template:`minimal`,schemaLib:y,runtime:b,initGit:!1,installDeps:!1});let T=(await t())[`@forinda/kickjs-client`]??`^0.1.0`;await e(r(C,`web/package.json`),o(_,T)),await e(r(C,`web/vite.config.ts`),s()),await e(r(C,`web/tsconfig.json`),c()),await e(r(C,`web/index.html`),l(_)),await e(r(C,`web/src/main.tsx`),u()),await e(r(C,`web/src/App.tsx`),d()),await e(r(C,`web/src/api.ts`),f()),await e(r(C,`web/src/types/kick-routes.d.ts`),p()),await e(r(C,`package.json`),m(_,S)),await e(r(C,`pnpm-workspace.yaml`),`packages:
   - server
   - web
-`),await e(r(C,`.gitignore`),h()),await e(r(C,`README.md`),g(_,S));let{generateAgentDocs:E}=await import(`./agent-docs-CqRWMHZ-.mjs`).then(e=>e.t);if(await E({outDir:C,name:_,pm:S,template:`fullstack`,only:`all`,force:!0}),a.installDeps){console.log(`\n  Installing workspace dependencies with ${S}...\n`);try{i(S,[`install`],{cwd:C,stdio:`inherit`})}catch{console.log(`\n  Warning: ${S} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-BTfDyerr.mjs`).then(e=>e.n);await e({cwd:r(C,`server`),allowDuplicates:!0,silent:!0})}catch{}if(a.initGit)try{i(`git`,[`init`],{cwd:C,stdio:`pipe`}),i(`git`,[`branch`,`-M`,`main`],{cwd:C,stdio:`pipe`}),i(`git`,[`add`,`-A`],{cwd:C,stdio:`pipe`}),i(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:C,stdio:`pipe`}),w(`Git repository initialized`)}catch{w(`Warning: git init failed (git may not be installed)`)}console.log(`
+`),await e(r(C,`.gitignore`),h()),await e(r(C,`README.md`),g(_,S));let{generateAgentDocs:E}=await import(`./agent-docs-tlau7tZv.mjs`).then(e=>e.t);if(await E({outDir:C,name:_,pm:S,template:`fullstack`,only:`all`,force:!0}),a.installDeps){console.log(`\n  Installing workspace dependencies with ${S}...\n`);try{i(S,[`install`],{cwd:C,stdio:`inherit`})}catch{console.log(`\n  Warning: ${S} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-qeQ5co2C.mjs`).then(e=>e.n);await e({cwd:r(C,`server`),allowDuplicates:!0,silent:!0})}catch{}if(a.initGit)try{i(`git`,[`init`],{cwd:C,stdio:`pipe`}),i(`git`,[`branch`,`-M`,`main`],{cwd:C,stdio:`pipe`}),i(`git`,[`add`,`-A`],{cwd:C,stdio:`pipe`}),i(`git`,[`commit`,`-m`,`chore: initial commit from kick new (fullstack)`],{cwd:C,stdio:`pipe`}),w(`Git repository initialized`)}catch{w(`Warning: git init failed (git may not be installed)`)}console.log(`
   Fullstack workspace scaffolded!`),console.log(),w(`Next steps:`),w(`  cd ${_}`),a.installDeps||w(`  ${S} install`),S===`pnpm`?w(`  pnpm dev            # runs server (kick dev) + web (vite) together`):(w(`  ${S} run dev:server   # terminal 1`),w(`  ${S} run dev:web      # terminal 2`)),w(``),w(`The web app calls the API through @forinda/kickjs-client —`),w(`edit server/src/modules/hello and watch web/src/App.tsx's types follow.`),w(``)}function o(e,t){return`${JSON.stringify({name:`${e}-web`,private:!0,version:`0.0.0`,type:`module`,scripts:{dev:`vite`,build:`tsc --noEmit && vite build`,preview:`vite preview`,typecheck:`tsc --noEmit`},dependencies:{"@forinda/kickjs-client":t,react:`^19.0.0`,"react-dom":`^19.0.0`},devDependencies:{"@types/react":`^19.0.0`,"@types/react-dom":`^19.0.0`,"@vitejs/plugin-react":`^5.0.0`,typescript:`^5.9.0`,vite:`^7.0.0`}},null,2)}\n`}function s(){return`import { defineConfig } from 'vite'
 import react from '@vitejs/plugin-react'
 
@@ -135,4 +135,4 @@ stops compiling. That's the point.
 
 Docs: https://kickjs.app/guide/typed-client.html
 `}export{a as initFullstackProject};
-//# sourceMappingURL=fullstack-BgwfRTCN.mjs.map
+//# sourceMappingURL=fullstack-Cmedpn8G.mjs.map

package/dist/{fullstack-BgwfRTCN.mjs.map → fullstack-Cmedpn8G.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"fullstack-BgwfRTCN.mjs","names":[],"sources":["../src/generators/fullstack.ts"],"sourcesContent":["// `kick new --template fullstack` — a pnpm-workspace monorepo:\n//\n//   my-app/\n//     server/   KickJS API (the standard scaffold, minus its own git/install)\n//     web/      Vite + React frontend typed end-to-end via\n//               @forinda/kickjs-client + the server's generated KickRoutes.Api\n//\n// The type loop: server controllers use return-value handlers → `kick\n// typegen` (run here once, re-run by `kick dev`) emits\n// server/.kickjs/types/kick__routes.ts → web/src/types/kick-routes.d.ts\n// side-effect-imports that file (type-only, erased at runtime) → the web\n// client calls `api.get('/hello')` with the handler's actual response type.\n\nimport { join } from 'node:path'\nimport { execFileSync } from 'node:child_process'\n\nimport { writeFileSafe } from '../utils/fs'\nimport { initProject, resolveSiblingVersions } from './project'\n\nexport interface InitFullstackOptions {\n  name: string\n  directory: string\n  packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun'\n  initGit?: boolean\n  installDeps?: boolean\n  schemaLib?: 'zod' | 'valibot' | 'yup'\n  runtime?: 'express' | 'fastify' | 'h3'\n}\n\nexport async function initFullstackProject(options: InitFullstackOptions): Promise<void> {\n  const { name, directory, schemaLib = 'zod', runtime = 'express' } = options\n  // `--pm` arrives as a free CLI string — allowlist before it reaches a\n  // process invocation (execFileSync takes an argv array, no shell, but a\n  // bogus binary name is still a confusing failure).\n  const pmValid = (['pnpm', 'npm', 'yarn', 'bun'] as const).includes(\n    options.packageManager as never,\n  )\n  const packageManager = pmValid\n    ? (options.packageManager as 'pnpm' | 'npm' | 'yarn' | 'bun')\n    : 'pnpm'\n  const dir = directory\n  const log = (msg: string) => console.log(`  ${msg}`)\n  if (options.packageManager !== undefined && !pmValid) {\n    log(\n      `Warning: unknown package manager '${String(options.packageManager)}' — falling back to pnpm.`,\n    )\n  }\n\n  console.log(`\\n  Creating fullstack KickJS workspace: ${name}\\n`)\n\n  // ── server/ — the standard scaffold, deferred install/git ──────────\n  await initProject({\n    name: `${name}-server`,\n    directory: join(dir, 'server'),\n    packageManager,\n    template: 'minimal',\n    schemaLib,\n    runtime,\n    // Root owns install + git so the lockfile/commit cover the workspace.\n    initGit: false,\n    installDeps: false,\n  })\n\n  // ── web/ — Vite + React, typed client ──────────────────────────────\n  const versions = await resolveSiblingVersions()\n  const clientVersion = versions['@forinda/kickjs-client'] ?? '^0.1.0'\n\n  await writeFileSafe(join(dir, 'web/package.json'), webPackageJson(name, clientVersion))\n  await writeFileSafe(join(dir, 'web/vite.config.ts'), webViteConfig())\n  await writeFileSafe(join(dir, 'web/tsconfig.json'), webTsConfig())\n  await writeFileSafe(join(dir, 'web/index.html'), webIndexHtml(name))\n  await writeFileSafe(join(dir, 'web/src/main.tsx'), webMain())\n  await writeFileSafe(join(dir, 'web/src/App.tsx'), webApp())\n  await writeFileSafe(join(dir, 'web/src/api.ts'), webApi())\n  await writeFileSafe(join(dir, 'web/src/types/kick-routes.d.ts'), webRouteTypes())\n\n  // ── workspace root ──────────────────────────────────────────────────\n  await writeFileSafe(join(dir, 'package.json'), rootPackageJson(name, packageManager))\n  await writeFileSafe(join(dir, 'pnpm-workspace.yaml'), `packages:\\n  - server\\n  - web\\n`)\n  await writeFileSafe(join(dir, '.gitignore'), rootGitignore())\n  await writeFileSafe(join(dir, 'README.md'), rootReadme(name, packageManager))\n\n  // Workspace-root agent docs (CLAUDE.md + .agents/) flavored for the\n  // fullstack layout — the server/ subdir keeps its own generated set.\n  const { generateAgentDocs } = await import('./agent-docs')\n  await generateAgentDocs({\n    outDir: dir,\n    name,\n    pm: packageManager,\n    template: 'fullstack',\n    only: 'all',\n    force: true,\n  })\n\n  // ── install (root — covers both workspace packages) ────────────────\n  if (options.installDeps) {\n    console.log(`\\n  Installing workspace dependencies with ${packageManager}...\\n`)\n    try {\n      execFileSync(packageManager, ['install'], { cwd: dir, stdio: 'inherit' })\n    } catch {\n      console.log(`\\n  Warning: ${packageManager} install failed. Run it manually.`)\n    }\n  }\n\n  // ── typegen (server) so web's KickRoutes.Api resolves immediately ──\n  try {\n    const { runTypegen } = await import('../typegen')\n    await runTypegen({ cwd: join(dir, 'server'), allowDuplicates: true, silent: true })\n  } catch {\n    // Non-fatal — `kick dev` in server/ retries on boot.\n  }\n\n  // ── git (root) ──────────────────────────────────────────────────────\n  if (options.initGit) {\n    try {\n      execFileSync('git', ['init'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['branch', '-M', 'main'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['add', '-A'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['commit', '-m', 'chore: initial commit from kick new (fullstack)'], {\n        cwd: dir,\n        stdio: 'pipe',\n      })\n      log('Git repository initialized')\n    } catch {\n      log('Warning: git init failed (git may not be installed)')\n    }\n  }\n\n  console.log('\\n  Fullstack workspace scaffolded!')\n  console.log()\n  log('Next steps:')\n  log(`  cd ${name}`)\n  if (!options.installDeps) log(`  ${packageManager} install`)\n  if (packageManager === 'pnpm') {\n    log('  pnpm dev            # runs server (kick dev) + web (vite) together')\n  } else {\n    log(`  ${packageManager} run dev:server   # terminal 1`)\n    log(`  ${packageManager} run dev:web      # terminal 2`)\n  }\n  log('')\n  log('The web app calls the API through @forinda/kickjs-client —')\n  log(\"edit server/src/modules/hello and watch web/src/App.tsx's types follow.\")\n  log('')\n}\n\n// ── web templates ─────────────────────────────────────────────────────\n\nfunction webPackageJson(name: string, clientVersion: string): string {\n  return `${JSON.stringify(\n    {\n      name: `${name}-web`,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts: {\n        dev: 'vite',\n        build: 'tsc --noEmit && vite build',\n        preview: 'vite preview',\n        typecheck: 'tsc --noEmit',\n      },\n      dependencies: {\n        '@forinda/kickjs-client': clientVersion,\n        react: '^19.0.0',\n        'react-dom': '^19.0.0',\n      },\n      devDependencies: {\n        '@types/react': '^19.0.0',\n        '@types/react-dom': '^19.0.0',\n        '@vitejs/plugin-react': '^5.0.0',\n        typescript: '^5.9.0',\n        vite: '^7.0.0',\n      },\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nfunction webViteConfig(): string {\n  return `import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\n\nexport default defineConfig({\n  plugins: [react()],\n  server: {\n    // The KickJS server (kick dev) listens on 3000; the client's baseUrl is\n    // the relative '/api/v1', so the browser hits Vite and Vite forwards.\n    proxy: {\n      '/api': 'http://localhost:3000',\n    },\n  },\n})\n`\n}\n\nfunction webTsConfig(): string {\n  return `${JSON.stringify(\n    {\n      compilerOptions: {\n        target: 'ES2022',\n        lib: ['ES2022', 'DOM', 'DOM.Iterable'],\n        module: 'ESNext',\n        moduleResolution: 'bundler',\n        jsx: 'react-jsx',\n        strict: true,\n        skipLibCheck: true,\n        noEmit: true,\n        isolatedModules: true,\n        // The type bridge pulls server controller sources into this\n        // program — they use legacy TS decorators.\n        experimentalDecorators: true,\n        // The KickRoutes ambient types come from the server's generated\n        // typegen output via src/types/kick-routes.d.ts.\n        types: [],\n      },\n      include: ['src'],\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nfunction webIndexHtml(name: string): string {\n  return `<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n    <title>${name}</title>\n  </head>\n  <body>\n    <div id=\"root\"></div>\n    <script type=\"module\" src=\"/src/main.tsx\"></script>\n  </body>\n</html>\n`\n}\n\nfunction webMain(): string {\n  return `import { StrictMode } from 'react'\nimport { createRoot } from 'react-dom/client'\nimport { App } from './App'\n\ncreateRoot(document.getElementById('root')!).render(\n  <StrictMode>\n    <App />\n  </StrictMode>,\n)\n`\n}\n\nfunction webApp(): string {\n  return `import { useEffect, useState } from 'react'\nimport { api } from './api'\n\n// The response types below are INFERRED from the server's handlers —\n// change server/src/modules/hello/hello.service.ts and these types follow\n// on the next \\`kick typegen\\` (automatic under \\`kick dev\\`).\ntype Greeting = Awaited<ReturnType<typeof fetchGreeting>>\n\nfunction fetchGreeting() {\n  return api.get('/hello')\n}\n\nexport function App() {\n  const [greeting, setGreeting] = useState<Greeting | null>(null)\n  const [health, setHealth] = useState<string>('checking…')\n\n  useEffect(() => {\n    fetchGreeting().then(setGreeting).catch(console.error)\n    api\n      .get('/hello/health')\n      .then((h) => setHealth(h.status))\n      .catch(() => setHealth('down'))\n  }, [])\n\n  return (\n    <main style={{ fontFamily: 'system-ui', maxWidth: 640, margin: '4rem auto', padding: '0 1rem' }}>\n      <h1>KickJS fullstack</h1>\n      <p>\n        <strong>{greeting?.message ?? 'loading…'}</strong>\n      </p>\n      <p>\n        Server said hello at <code>{greeting?.timestamp ?? '…'}</code> — health:{' '}\n        <code>{health}</code>\n      </p>\n      <p style={{ color: '#666' }}>\n        This call is typed end to end: <code>api.get('/hello')</code> returns the exact shape\n        <code> HelloService.greet()</code> produces. Rename a field on the server and this file\n        stops compiling.\n      </p>\n    </main>\n  )\n}\n`\n}\n\nfunction webApi(): string {\n  return `import { createClient } from '@forinda/kickjs-client'\n\n// KickApi (alias of KickRoutes.Api) is ambient — populated by server/.kickjs/types (see\n// src/types/kick-routes.d.ts). Keys are module-mount-relative paths;\n// the bootstrap-level '/api/v1' prefix lives here in baseUrl, and the\n// Vite dev proxy forwards it to the KickJS server.\nexport const api = createClient<KickApi>({ baseUrl: '/api/v1' })\n`\n}\n\nfunction webRouteTypes(): string {\n  return `// Type-only bridge to the server's generated route types. The import is\n// erased at build time — no server code ever enters the web bundle.\n// Regenerate with \\`kick typegen\\` in server/ (automatic under \\`kick dev\\`).\nimport '../../../server/.kickjs/types/kick__routes'\n`\n}\n\n// ── root templates ────────────────────────────────────────────────────\n\nfunction rootPackageJson(name: string, pm: string): string {\n  const scripts: Record<string, string> =\n    pm === 'pnpm'\n      ? {\n          dev: 'pnpm --parallel -r run dev',\n          'dev:server': 'pnpm --filter ./server dev',\n          'dev:web': 'pnpm --filter ./web dev',\n          build: 'pnpm -r run build',\n          typecheck: 'pnpm -r run typecheck',\n        }\n      : {\n          // cd-based scripts — the one form npm, yarn (classic AND berry),\n          // and bun all run identically; workspace-filter flags differ per\n          // manager (--workspace vs `yarn workspace <name>` vs --filter).\n          'dev:server': `cd server && ${pm} run dev`,\n          'dev:web': `cd web && ${pm} run dev`,\n          build: `${pm} run build:server && ${pm} run build:web`,\n          'build:server': `cd server && ${pm} run build`,\n          'build:web': `cd web && ${pm} run build`,\n          typecheck: `cd web && ${pm} run typecheck`,\n        }\n  return `${JSON.stringify(\n    {\n      name,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts,\n      workspaces: ['server', 'web'],\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nfunction rootGitignore(): string {\n  return `node_modules/\ndist/\n.env\n*.log\n.DS_Store\n`\n}\n\nfunction rootReadme(name: string, pm: string): string {\n  return `# ${name}\n\nFullstack KickJS workspace — typed end to end.\n\n| Package   | What                                                              |\n| --------- | ----------------------------------------------------------------- |\n| \\`server/\\` | KickJS API (decorators, DI, \\`kick dev\\` with typegen watch)       |\n| \\`web/\\`    | Vite + React, typed against the API via \\`@forinda/kickjs-client\\` |\n\n## Develop\n\n\\`\\`\\`bash\n${pm} install\n${pm === 'pnpm' ? 'pnpm dev            # server (kick dev) + web (vite), in parallel' : `${pm} run dev:server   # terminal 1\\n${pm} run dev:web      # terminal 2`}\n\\`\\`\\`\n\nServer: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \\`/api\\`).\n\n## The type loop\n\n1. Server handlers **return** their payloads (\\`return this.service.greet(...)\\`).\n2. \\`kick typegen\\` (auto under \\`kick dev\\`) emits \\`server/.kickjs/types/kick__routes.ts\\` —\n   including the flat \\`KickRoutes.Api\\` map with inferred response types.\n3. \\`web/src/types/kick-routes.d.ts\\` imports that file type-only.\n4. \\`web/src/api.ts\\`'s \\`createClient<KickRoutes.Api>\\` types every call site.\n\nRename a field in \\`server/src/modules/hello/hello.service.ts\\` → \\`web/src/App.tsx\\`\nstops compiling. That's the point.\n\nDocs: https://kickjs.app/guide/typed-client.html\n`\n}\n"],"mappings":"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"}
+{"version":3,"file":"fullstack-Cmedpn8G.mjs","names":[],"sources":["../src/generators/fullstack.ts"],"sourcesContent":["// `kick new --template fullstack` — a pnpm-workspace monorepo:\n//\n//   my-app/\n//     server/   KickJS API (the standard scaffold, minus its own git/install)\n//     web/      Vite + React frontend typed end-to-end via\n//               @forinda/kickjs-client + the server's generated KickRoutes.Api\n//\n// The type loop: server controllers use return-value handlers → `kick\n// typegen` (run here once, re-run by `kick dev`) emits\n// server/.kickjs/types/kick__routes.ts → web/src/types/kick-routes.d.ts\n// side-effect-imports that file (type-only, erased at runtime) → the web\n// client calls `api.get('/hello')` with the handler's actual response type.\n\nimport { join } from 'node:path'\nimport { execFileSync } from 'node:child_process'\n\nimport { writeFileSafe } from '../utils/fs'\nimport { initProject, resolveSiblingVersions } from './project'\n\nexport interface InitFullstackOptions {\n  name: string\n  directory: string\n  packageManager?: 'pnpm' | 'npm' | 'yarn' | 'bun'\n  initGit?: boolean\n  installDeps?: boolean\n  schemaLib?: 'zod' | 'valibot' | 'yup'\n  runtime?: 'express' | 'fastify' | 'h3'\n}\n\nexport async function initFullstackProject(options: InitFullstackOptions): Promise<void> {\n  const { name, directory, schemaLib = 'zod', runtime = 'express' } = options\n  // `--pm` arrives as a free CLI string — allowlist before it reaches a\n  // process invocation (execFileSync takes an argv array, no shell, but a\n  // bogus binary name is still a confusing failure).\n  const pmValid = (['pnpm', 'npm', 'yarn', 'bun'] as const).includes(\n    options.packageManager as never,\n  )\n  const packageManager = pmValid\n    ? (options.packageManager as 'pnpm' | 'npm' | 'yarn' | 'bun')\n    : 'pnpm'\n  const dir = directory\n  const log = (msg: string) => console.log(`  ${msg}`)\n  if (options.packageManager !== undefined && !pmValid) {\n    log(\n      `Warning: unknown package manager '${String(options.packageManager)}' — falling back to pnpm.`,\n    )\n  }\n\n  console.log(`\\n  Creating fullstack KickJS workspace: ${name}\\n`)\n\n  // ── server/ — the standard scaffold, deferred install/git ──────────\n  await initProject({\n    name: `${name}-server`,\n    directory: join(dir, 'server'),\n    packageManager,\n    template: 'minimal',\n    schemaLib,\n    runtime,\n    // Root owns install + git so the lockfile/commit cover the workspace.\n    initGit: false,\n    installDeps: false,\n  })\n\n  // ── web/ — Vite + React, typed client ──────────────────────────────\n  const versions = await resolveSiblingVersions()\n  const clientVersion = versions['@forinda/kickjs-client'] ?? '^0.1.0'\n\n  await writeFileSafe(join(dir, 'web/package.json'), webPackageJson(name, clientVersion))\n  await writeFileSafe(join(dir, 'web/vite.config.ts'), webViteConfig())\n  await writeFileSafe(join(dir, 'web/tsconfig.json'), webTsConfig())\n  await writeFileSafe(join(dir, 'web/index.html'), webIndexHtml(name))\n  await writeFileSafe(join(dir, 'web/src/main.tsx'), webMain())\n  await writeFileSafe(join(dir, 'web/src/App.tsx'), webApp())\n  await writeFileSafe(join(dir, 'web/src/api.ts'), webApi())\n  await writeFileSafe(join(dir, 'web/src/types/kick-routes.d.ts'), webRouteTypes())\n\n  // ── workspace root ──────────────────────────────────────────────────\n  await writeFileSafe(join(dir, 'package.json'), rootPackageJson(name, packageManager))\n  await writeFileSafe(join(dir, 'pnpm-workspace.yaml'), `packages:\\n  - server\\n  - web\\n`)\n  await writeFileSafe(join(dir, '.gitignore'), rootGitignore())\n  await writeFileSafe(join(dir, 'README.md'), rootReadme(name, packageManager))\n\n  // Workspace-root agent docs (CLAUDE.md + .agents/) flavored for the\n  // fullstack layout — the server/ subdir keeps its own generated set.\n  const { generateAgentDocs } = await import('./agent-docs')\n  await generateAgentDocs({\n    outDir: dir,\n    name,\n    pm: packageManager,\n    template: 'fullstack',\n    only: 'all',\n    force: true,\n  })\n\n  // ── install (root — covers both workspace packages) ────────────────\n  if (options.installDeps) {\n    console.log(`\\n  Installing workspace dependencies with ${packageManager}...\\n`)\n    try {\n      execFileSync(packageManager, ['install'], { cwd: dir, stdio: 'inherit' })\n    } catch {\n      console.log(`\\n  Warning: ${packageManager} install failed. Run it manually.`)\n    }\n  }\n\n  // ── typegen (server) so web's KickRoutes.Api resolves immediately ──\n  try {\n    const { runTypegen } = await import('../typegen')\n    await runTypegen({ cwd: join(dir, 'server'), allowDuplicates: true, silent: true })\n  } catch {\n    // Non-fatal — `kick dev` in server/ retries on boot.\n  }\n\n  // ── git (root) ──────────────────────────────────────────────────────\n  if (options.initGit) {\n    try {\n      execFileSync('git', ['init'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['branch', '-M', 'main'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['add', '-A'], { cwd: dir, stdio: 'pipe' })\n      execFileSync('git', ['commit', '-m', 'chore: initial commit from kick new (fullstack)'], {\n        cwd: dir,\n        stdio: 'pipe',\n      })\n      log('Git repository initialized')\n    } catch {\n      log('Warning: git init failed (git may not be installed)')\n    }\n  }\n\n  console.log('\\n  Fullstack workspace scaffolded!')\n  console.log()\n  log('Next steps:')\n  log(`  cd ${name}`)\n  if (!options.installDeps) log(`  ${packageManager} install`)\n  if (packageManager === 'pnpm') {\n    log('  pnpm dev            # runs server (kick dev) + web (vite) together')\n  } else {\n    log(`  ${packageManager} run dev:server   # terminal 1`)\n    log(`  ${packageManager} run dev:web      # terminal 2`)\n  }\n  log('')\n  log('The web app calls the API through @forinda/kickjs-client —')\n  log(\"edit server/src/modules/hello and watch web/src/App.tsx's types follow.\")\n  log('')\n}\n\n// ── web templates ─────────────────────────────────────────────────────\n\nfunction webPackageJson(name: string, clientVersion: string): string {\n  return `${JSON.stringify(\n    {\n      name: `${name}-web`,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts: {\n        dev: 'vite',\n        build: 'tsc --noEmit && vite build',\n        preview: 'vite preview',\n        typecheck: 'tsc --noEmit',\n      },\n      dependencies: {\n        '@forinda/kickjs-client': clientVersion,\n        react: '^19.0.0',\n        'react-dom': '^19.0.0',\n      },\n      devDependencies: {\n        '@types/react': '^19.0.0',\n        '@types/react-dom': '^19.0.0',\n        '@vitejs/plugin-react': '^5.0.0',\n        typescript: '^5.9.0',\n        vite: '^7.0.0',\n      },\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nfunction webViteConfig(): string {\n  return `import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\n\nexport default defineConfig({\n  plugins: [react()],\n  server: {\n    // The KickJS server (kick dev) listens on 3000; the client's baseUrl is\n    // the relative '/api/v1', so the browser hits Vite and Vite forwards.\n    proxy: {\n      '/api': 'http://localhost:3000',\n    },\n  },\n})\n`\n}\n\nfunction webTsConfig(): string {\n  return `${JSON.stringify(\n    {\n      compilerOptions: {\n        target: 'ES2022',\n        lib: ['ES2022', 'DOM', 'DOM.Iterable'],\n        module: 'ESNext',\n        moduleResolution: 'bundler',\n        jsx: 'react-jsx',\n        strict: true,\n        skipLibCheck: true,\n        noEmit: true,\n        isolatedModules: true,\n        // The type bridge pulls server controller sources into this\n        // program — they use legacy TS decorators.\n        experimentalDecorators: true,\n        // The KickRoutes ambient types come from the server's generated\n        // typegen output via src/types/kick-routes.d.ts.\n        types: [],\n      },\n      include: ['src'],\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nfunction webIndexHtml(name: string): string {\n  return `<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n    <title>${name}</title>\n  </head>\n  <body>\n    <div id=\"root\"></div>\n    <script type=\"module\" src=\"/src/main.tsx\"></script>\n  </body>\n</html>\n`\n}\n\nfunction webMain(): string {\n  return `import { StrictMode } from 'react'\nimport { createRoot } from 'react-dom/client'\nimport { App } from './App'\n\ncreateRoot(document.getElementById('root')!).render(\n  <StrictMode>\n    <App />\n  </StrictMode>,\n)\n`\n}\n\nfunction webApp(): string {\n  return `import { useEffect, useState } from 'react'\nimport { api } from './api'\n\n// The response types below are INFERRED from the server's handlers —\n// change server/src/modules/hello/hello.service.ts and these types follow\n// on the next \\`kick typegen\\` (automatic under \\`kick dev\\`).\ntype Greeting = Awaited<ReturnType<typeof fetchGreeting>>\n\nfunction fetchGreeting() {\n  return api.get('/hello')\n}\n\nexport function App() {\n  const [greeting, setGreeting] = useState<Greeting | null>(null)\n  const [health, setHealth] = useState<string>('checking…')\n\n  useEffect(() => {\n    fetchGreeting().then(setGreeting).catch(console.error)\n    api\n      .get('/hello/health')\n      .then((h) => setHealth(h.status))\n      .catch(() => setHealth('down'))\n  }, [])\n\n  return (\n    <main style={{ fontFamily: 'system-ui', maxWidth: 640, margin: '4rem auto', padding: '0 1rem' }}>\n      <h1>KickJS fullstack</h1>\n      <p>\n        <strong>{greeting?.message ?? 'loading…'}</strong>\n      </p>\n      <p>\n        Server said hello at <code>{greeting?.timestamp ?? '…'}</code> — health:{' '}\n        <code>{health}</code>\n      </p>\n      <p style={{ color: '#666' }}>\n        This call is typed end to end: <code>api.get('/hello')</code> returns the exact shape\n        <code> HelloService.greet()</code> produces. Rename a field on the server and this file\n        stops compiling.\n      </p>\n    </main>\n  )\n}\n`\n}\n\nfunction webApi(): string {\n  return `import { createClient } from '@forinda/kickjs-client'\n\n// KickApi (alias of KickRoutes.Api) is ambient — populated by server/.kickjs/types (see\n// src/types/kick-routes.d.ts). Keys are module-mount-relative paths;\n// the bootstrap-level '/api/v1' prefix lives here in baseUrl, and the\n// Vite dev proxy forwards it to the KickJS server.\nexport const api = createClient<KickApi>({ baseUrl: '/api/v1' })\n`\n}\n\nfunction webRouteTypes(): string {\n  return `// Type-only bridge to the server's generated route types. The import is\n// erased at build time — no server code ever enters the web bundle.\n// Regenerate with \\`kick typegen\\` in server/ (automatic under \\`kick dev\\`).\nimport '../../../server/.kickjs/types/kick__routes'\n`\n}\n\n// ── root templates ────────────────────────────────────────────────────\n\nfunction rootPackageJson(name: string, pm: string): string {\n  const scripts: Record<string, string> =\n    pm === 'pnpm'\n      ? {\n          dev: 'pnpm --parallel -r run dev',\n          'dev:server': 'pnpm --filter ./server dev',\n          'dev:web': 'pnpm --filter ./web dev',\n          build: 'pnpm -r run build',\n          typecheck: 'pnpm -r run typecheck',\n        }\n      : {\n          // cd-based scripts — the one form npm, yarn (classic AND berry),\n          // and bun all run identically; workspace-filter flags differ per\n          // manager (--workspace vs `yarn workspace <name>` vs --filter).\n          'dev:server': `cd server && ${pm} run dev`,\n          'dev:web': `cd web && ${pm} run dev`,\n          build: `${pm} run build:server && ${pm} run build:web`,\n          'build:server': `cd server && ${pm} run build`,\n          'build:web': `cd web && ${pm} run build`,\n          typecheck: `cd web && ${pm} run typecheck`,\n        }\n  return `${JSON.stringify(\n    {\n      name,\n      private: true,\n      version: '0.0.0',\n      type: 'module',\n      scripts,\n      workspaces: ['server', 'web'],\n    },\n    null,\n    2,\n  )}\\n`\n}\n\nfunction rootGitignore(): string {\n  return `node_modules/\ndist/\n.env\n*.log\n.DS_Store\n`\n}\n\nfunction rootReadme(name: string, pm: string): string {\n  return `# ${name}\n\nFullstack KickJS workspace — typed end to end.\n\n| Package   | What                                                              |\n| --------- | ----------------------------------------------------------------- |\n| \\`server/\\` | KickJS API (decorators, DI, \\`kick dev\\` with typegen watch)       |\n| \\`web/\\`    | Vite + React, typed against the API via \\`@forinda/kickjs-client\\` |\n\n## Develop\n\n\\`\\`\\`bash\n${pm} install\n${pm === 'pnpm' ? 'pnpm dev            # server (kick dev) + web (vite), in parallel' : `${pm} run dev:server   # terminal 1\\n${pm} run dev:web      # terminal 2`}\n\\`\\`\\`\n\nServer: http://localhost:3000 · Web: http://localhost:5173 (Vite proxies \\`/api\\`).\n\n## The type loop\n\n1. Server handlers **return** their payloads (\\`return this.service.greet(...)\\`).\n2. \\`kick typegen\\` (auto under \\`kick dev\\`) emits \\`server/.kickjs/types/kick__routes.ts\\` —\n   including the flat \\`KickRoutes.Api\\` map with inferred response types.\n3. \\`web/src/types/kick-routes.d.ts\\` imports that file type-only.\n4. \\`web/src/api.ts\\`'s \\`createClient<KickRoutes.Api>\\` types every call site.\n\nRename a field in \\`server/src/modules/hello/hello.service.ts\\` → \\`web/src/App.tsx\\`\nstops compiling. That's the point.\n\nDocs: https://kickjs.app/guide/typed-client.html\n`\n}\n"],"mappings":"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"}

package/dist/{fullstack-CHO-Us7Y.mjs → fullstack-e-wuEMD0.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v6.6.0
+ * @forinda/kickjs-cli v6.7.0
  *
  * Copyright (c) Felix Orinda
  *

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v6.6.0
+ * @forinda/kickjs-cli v6.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,5 +8,5 @@
  *
  * @license MIT
  */
-import{M as e,N as t,c as n,d as r,f as i,g as a,j as o,k as s,l as c,m as l,n as u,o as d,p as f,s as p,t as m,u as h,y as g}from"./doctor-BJWjI_wt.mjs";import{t as _}from"./project-QWNGOwFX.mjs";import{i as v,r as y}from"./config-BOArOJm-.mjs";import{t as b}from"./project-root-2PIpqSzM.mjs";import{n as x,t as S}from"./types-SeFJ8umm.mjs";function C(e){return e}export{S as KickPluginConflictError,n as TYPEGEN_OWNER_KEY,d as buildGeneratorContext,c as createTypegenDevWatcher,x as defineCliPlugin,y as defineConfig,m as defineDoctorCheck,u as defineDoctorExtension,p as defineGenerator,C as defineTypegen,b as findProjectRoot,a as generateAdapter,r as generateController,h as generateDto,f as generateGuard,l as generateMiddleware,g as generateModule,i as generateService,_ as initProject,v as loadKickConfig,s as pluralize,o as toCamelCase,e as toKebabCase,t as toPascalCase};
+import{M as e,N as t,c as n,d as r,f as i,g as a,j as o,k as s,l as c,m as l,n as u,o as d,p as f,s as p,t as m,u as h,y as g}from"./doctor-BHnei8KS.mjs";import{t as _}from"./project-CnU7KcYI.mjs";import{i as v,r as y}from"./config-D6C74vFp.mjs";import{t as b}from"./project-root-CdqXle6R.mjs";import{n as x,t as S}from"./types-BNOSmSFj.mjs";function C(e){return e}export{S as KickPluginConflictError,n as TYPEGEN_OWNER_KEY,d as buildGeneratorContext,c as createTypegenDevWatcher,x as defineCliPlugin,y as defineConfig,m as defineDoctorCheck,u as defineDoctorExtension,p as defineGenerator,C as defineTypegen,b as findProjectRoot,a as generateAdapter,r as generateController,h as generateDto,f as generateGuard,l as generateMiddleware,g as generateModule,i as generateService,_ as initProject,v as loadKickConfig,s as pluralize,o as toCamelCase,e as toKebabCase,t as toPascalCase};
 //# sourceMappingURL=index.mjs.map

package/dist/{plugin-IyD9yXBm.mjs → plugin-BlWy4Nbd.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v6.6.0
+ * @forinda/kickjs-cli v6.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,5 +8,5 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-CCuSuZBc.mjs";import{t}from"./types-SeFJ8umm.mjs";function n(e,n=[]){let r=new Map;for(let n of e){let e=(r.get(n.name)??0)+1;if(r.set(n.name,e),e===2)throw new t(`plugin`,n.name,[n.name,n.name])}let i=new Map,a=[];for(let n of e)for(let e of n.commands??[]){let r=i.get(e.name);if(r)throw new t(`command`,e.name,[r,n.name]);i.set(e.name,n.name),a.push(e)}let o=new Set(n.map(e=>e.name)),s=[...a.filter(e=>!o.has(e.name)),...n],c=new Map,l=[];for(let n of e)for(let e of n.typegens??[]){let r=c.get(e.id);if(r)throw new t(`typegen`,e.id,[r,n.name]);c.set(e.id,n.name),l.push(e)}let u=new Map,d=[];for(let n of e)for(let e of n.generators??[]){let r=u.get(e.name);if(r)throw new t(`generator`,e.name,[r,n.name]);u.set(e.name,n.name),d.push({source:n.name,spec:e})}return{commands:s,typegens:l,generators:d,register:async(t,n)=>{let r;if(n)r={generators:d,...n};else{let{findProjectRoot:e}=await import(`./project-root-2PIpqSzM.mjs`).then(e=>e.n),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:d}}for(let n of e)n.register&&await n.register(t,r)}}}var r=e({mergeCliPlugins:()=>n});export{n,r as t};
-//# sourceMappingURL=plugin-IyD9yXBm.mjs.map
+import{t as e}from"./rolldown-runtime-DiP_G7eI.mjs";import{t}from"./types-BNOSmSFj.mjs";function n(e,n=[]){let r=new Map;for(let n of e){let e=(r.get(n.name)??0)+1;if(r.set(n.name,e),e===2)throw new t(`plugin`,n.name,[n.name,n.name])}let i=new Map,a=[];for(let n of e)for(let e of n.commands??[]){let r=i.get(e.name);if(r)throw new t(`command`,e.name,[r,n.name]);i.set(e.name,n.name),a.push(e)}let o=new Set(n.map(e=>e.name)),s=[...a.filter(e=>!o.has(e.name)),...n],c=new Map,l=[];for(let n of e)for(let e of n.typegens??[]){let r=c.get(e.id);if(r)throw new t(`typegen`,e.id,[r,n.name]);c.set(e.id,n.name),l.push(e)}let u=new Map,d=[];for(let n of e)for(let e of n.generators??[]){let r=u.get(e.name);if(r)throw new t(`generator`,e.name,[r,n.name]);u.set(e.name,n.name),d.push({source:n.name,spec:e})}return{commands:s,typegens:l,generators:d,register:async(t,n)=>{let r;if(n)r={generators:d,...n};else{let{findProjectRoot:e}=await import(`./project-root-CdqXle6R.mjs`).then(e=>e.n),t=process.cwd();r={cwd:t,projectRoot:e(t),config:null,log:()=>{},generators:d}}for(let n of e)n.register&&await n.register(t,r)}}}var r=e({mergeCliPlugins:()=>n});export{n,r as t};
+//# sourceMappingURL=plugin-BlWy4Nbd.mjs.map

package/dist/{plugin-IyD9yXBm.mjs.map → plugin-BlWy4Nbd.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"plugin-IyD9yXBm.mjs","names":[],"sources":["../src/plugin/merge.ts","../src/plugin/index.ts"],"sourcesContent":["// Plugin → unified registry merge.\n//\n// Resolution rules (per the v1 spec + dogfood pivot):\n//   - duplicate plugin `name` across the input array → conflict error.\n//     Catches the double-install case (built-in shipped twice, or\n//     adopter requiring the same plugin twice).\n//   - plugin commands appear first in the merged list, then adopter\n//     commands; adopter `commands` of the same name override the\n//     plugin entry (filter pass).\n//   - duplicate command name across two plugins → conflict error\n//     listing both plugin names. Adopter overriding a plugin is\n//     allowed and not an error.\n//   - duplicate typegen id across two plugins → same error. Typegens\n//     have no adopter override path; only plugins contribute them.\n//   - register() functions are collected in input order; the caller\n//     invokes each one against the same Command program. They have no\n//     id-level conflict surface — owners are responsible for picking\n//     non-colliding command names inside their own register().\n//   - plugin order = array order. No implicit precedence rules.\n\nimport type { Command } from 'commander'\n\nimport type { KickCommandDefinition } from '../config'\nimport type { TypegenPlugin } from '../typegen/plugin'\nimport type { GeneratorSpec } from '../generator-extension/define'\nimport type { DiscoveredGenerator } from '../generator-extension/discover'\nimport { KickPluginConflictError, type KickCliPlugin, type KickCliPluginContext } from './types'\n\nexport interface MergedPlugins {\n  commands: KickCommandDefinition[]\n  typegens: TypegenPlugin[]\n  /** DiscoveredGenerator shape so this list slots into the existing\n   * dispatch path next to package.json-discovered entries. `source`\n   * carries the plugin name for error attribution. */\n  generators: DiscoveredGenerator[]\n  /**\n   * Apply every plugin's register() in input order. ctx is optional so\n   * tests + lightweight callers can invoke `register(program)` without\n   * constructing a full context; it falls back to cwd=process.cwd(),\n   * config=null, log=no-op.\n   */\n  register: (program: Command, ctx?: KickCliPluginContext) => Promise<void>\n}\n\nexport function mergeCliPlugins(\n  plugins: readonly KickCliPlugin[],\n  adopterCommands: readonly KickCommandDefinition[] = [],\n): MergedPlugins {\n  // Plugin-name dedup — catches double-install.\n  const seenPluginNames = new Map<string, number>()\n  for (const p of plugins) {\n    const count = (seenPluginNames.get(p.name) ?? 0) + 1\n    seenPluginNames.set(p.name, count)\n    if (count === 2) {\n      throw new KickPluginConflictError('plugin', p.name, [p.name, p.name])\n    }\n  }\n\n  const commandOwners = new Map<string, string>()\n  const pluginCommands: KickCommandDefinition[] = []\n  for (const p of plugins) {\n    for (const cmd of p.commands ?? []) {\n      const prior = commandOwners.get(cmd.name)\n      if (prior) {\n        throw new KickPluginConflictError('command', cmd.name, [prior, p.name])\n      }\n      commandOwners.set(cmd.name, p.name)\n      pluginCommands.push(cmd)\n    }\n  }\n\n  const adopterNames = new Set(adopterCommands.map((c) => c.name))\n  const filteredPlugin = pluginCommands.filter((c) => !adopterNames.has(c.name))\n  const commands = [...filteredPlugin, ...adopterCommands]\n\n  const typegenOwners = new Map<string, string>()\n  const typegens: TypegenPlugin[] = []\n  for (const p of plugins) {\n    for (const tg of p.typegens ?? []) {\n      const prior = typegenOwners.get(tg.id)\n      if (prior) {\n        throw new KickPluginConflictError('typegen', tg.id, [prior, p.name])\n      }\n      typegenOwners.set(tg.id, p.name)\n      typegens.push(tg)\n    }\n  }\n\n  const generatorOwners = new Map<string, string>()\n  const generators: DiscoveredGenerator[] = []\n  for (const p of plugins) {\n    for (const spec of p.generators ?? []) {\n      const prior = generatorOwners.get(spec.name)\n      if (prior) {\n        throw new KickPluginConflictError('generator', spec.name, [prior, p.name])\n      }\n      generatorOwners.set(spec.name, p.name)\n      generators.push({ source: p.name, spec: spec satisfies GeneratorSpec })\n    }\n  }\n\n  /**\n   * Apply every plugin's `register()` callback in input order against the\n   * given Commander program. Each callback receives a {@link KickCliPluginContext}:\n   * caller-supplied ctx wins (test fixtures can inject a different\n   * workspace boundary); otherwise a default ctx is built with\n   * `findProjectRoot(process.cwd())` as the project root, `cwd` matching\n   * `process.cwd()`, null config, no-op log, and the merged generator set\n   * threaded through so the `kick/generate` built-in can surface each as\n   * a Commander subcommand. The dynamic import of `findProjectRoot` keeps\n   * the caller-supplied fast path zero-cost.\n   */\n  const register = async (program: Command, ctx?: KickCliPluginContext): Promise<void> => {\n    let resolved: KickCliPluginContext\n    if (ctx) {\n      resolved = { generators, ...ctx }\n    } else {\n      const { findProjectRoot } = await import('../utils/project-root')\n      const cwd = process.cwd()\n      resolved = {\n        cwd,\n        projectRoot: findProjectRoot(cwd),\n        config: null,\n        log: () => {},\n        generators,\n      }\n    }\n    for (const p of plugins) {\n      if (p.register) await p.register(program, resolved)\n    }\n  }\n\n  return { commands, typegens, generators, register }\n}\n","// Barrel intentionally omits `./builtins` — that module top-level-imports\n// every register*Command, which pulls heavy modules (project scaffolders,\n// fs reads at import time) into the graph. Importers that need the\n// builtin list go through `./plugin/builtins` directly; tests + adopter\n// plugins consuming only the contract types import from here.\n\nexport type { KickCliPlugin } from './types'\nexport { defineCliPlugin, KickPluginConflictError } from './types'\nexport { mergeCliPlugins, type MergedPlugins } from './merge'\n"],"mappings":";;;;;;;;;;wFA4CA,SAAgB,EACd,EACA,EAAoD,CAAC,EACtC,CAEf,IAAM,EAAkB,IAAI,IAC5B,IAAK,IAAM,KAAK,EAAS,CACvB,IAAM,GAAS,EAAgB,IAAI,EAAE,IAAI,GAAK,GAAK,EAEnD,GADA,EAAgB,IAAI,EAAE,KAAM,CAAK,EAC7B,IAAU,EACZ,MAAM,IAAI,EAAwB,SAAU,EAAE,KAAM,CAAC,EAAE,KAAM,EAAE,IAAI,CAAC,CAExE,CAEA,IAAM,EAAgB,IAAI,IACpB,EAA0C,CAAC,EACjD,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAO,EAAE,UAAY,CAAC,EAAG,CAClC,IAAM,EAAQ,EAAc,IAAI,EAAI,IAAI,EACxC,GAAI,EACF,MAAM,IAAI,EAAwB,UAAW,EAAI,KAAM,CAAC,EAAO,EAAE,IAAI,CAAC,EAExE,EAAc,IAAI,EAAI,KAAM,EAAE,IAAI,EAClC,EAAe,KAAK,CAAG,CACzB,CAGF,IAAM,EAAe,IAAI,IAAI,EAAgB,IAAK,GAAM,EAAE,IAAI,CAAC,EAEzD,EAAW,CAAC,GADK,EAAe,OAAQ,GAAM,CAAC,EAAa,IAAI,EAAE,IAAI,CAC1C,EAAG,GAAG,CAAe,EAEjD,EAAgB,IAAI,IACpB,EAA4B,CAAC,EACnC,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAM,EAAE,UAAY,CAAC,EAAG,CACjC,IAAM,EAAQ,EAAc,IAAI,EAAG,EAAE,EACrC,GAAI,EACF,MAAM,IAAI,EAAwB,UAAW,EAAG,GAAI,CAAC,EAAO,EAAE,IAAI,CAAC,EAErE,EAAc,IAAI,EAAG,GAAI,EAAE,IAAI,EAC/B,EAAS,KAAK,CAAE,CAClB,CAGF,IAAM,EAAkB,IAAI,IACtB,EAAoC,CAAC,EAC3C,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAQ,EAAE,YAAc,CAAC,EAAG,CACrC,IAAM,EAAQ,EAAgB,IAAI,EAAK,IAAI,EAC3C,GAAI,EACF,MAAM,IAAI,EAAwB,YAAa,EAAK,KAAM,CAAC,EAAO,EAAE,IAAI,CAAC,EAE3E,EAAgB,IAAI,EAAK,KAAM,EAAE,IAAI,EACrC,EAAW,KAAK,CAAE,OAAQ,EAAE,KAAY,MAA6B,CAAC,CACxE,CAkCF,MAAO,CAAE,WAAU,WAAU,aAAY,eApBjB,EAAkB,IAA8C,CACtF,IAAI,EACJ,GAAI,EACF,EAAW,CAAE,aAAY,GAAG,CAAI,MAC3B,CACL,GAAM,CAAE,mBAAoB,MAAM,OAAO,8BAAwB,CAAA,KAAA,GAAA,EAAA,CAAA,EAC3D,EAAM,QAAQ,IAAI,EACxB,EAAW,CACT,MACA,YAAa,EAAgB,CAAG,EAChC,OAAQ,KACR,QAAW,CAAC,EACZ,YACF,CACF,CACA,IAAK,IAAM,KAAK,EACV,EAAE,UAAU,MAAM,EAAE,SAAS,EAAS,CAAQ,CAEtD,CAEkD,CACpD"}
+{"version":3,"file":"plugin-BlWy4Nbd.mjs","names":[],"sources":["../src/plugin/merge.ts","../src/plugin/index.ts"],"sourcesContent":["// Plugin → unified registry merge.\n//\n// Resolution rules (per the v1 spec + dogfood pivot):\n//   - duplicate plugin `name` across the input array → conflict error.\n//     Catches the double-install case (built-in shipped twice, or\n//     adopter requiring the same plugin twice).\n//   - plugin commands appear first in the merged list, then adopter\n//     commands; adopter `commands` of the same name override the\n//     plugin entry (filter pass).\n//   - duplicate command name across two plugins → conflict error\n//     listing both plugin names. Adopter overriding a plugin is\n//     allowed and not an error.\n//   - duplicate typegen id across two plugins → same error. Typegens\n//     have no adopter override path; only plugins contribute them.\n//   - register() functions are collected in input order; the caller\n//     invokes each one against the same Command program. They have no\n//     id-level conflict surface — owners are responsible for picking\n//     non-colliding command names inside their own register().\n//   - plugin order = array order. No implicit precedence rules.\n\nimport type { Command } from 'commander'\n\nimport type { KickCommandDefinition } from '../config'\nimport type { TypegenPlugin } from '../typegen/plugin'\nimport type { GeneratorSpec } from '../generator-extension/define'\nimport type { DiscoveredGenerator } from '../generator-extension/discover'\nimport { KickPluginConflictError, type KickCliPlugin, type KickCliPluginContext } from './types'\n\nexport interface MergedPlugins {\n  commands: KickCommandDefinition[]\n  typegens: TypegenPlugin[]\n  /** DiscoveredGenerator shape so this list slots into the existing\n   * dispatch path next to package.json-discovered entries. `source`\n   * carries the plugin name for error attribution. */\n  generators: DiscoveredGenerator[]\n  /**\n   * Apply every plugin's register() in input order. ctx is optional so\n   * tests + lightweight callers can invoke `register(program)` without\n   * constructing a full context; it falls back to cwd=process.cwd(),\n   * config=null, log=no-op.\n   */\n  register: (program: Command, ctx?: KickCliPluginContext) => Promise<void>\n}\n\nexport function mergeCliPlugins(\n  plugins: readonly KickCliPlugin[],\n  adopterCommands: readonly KickCommandDefinition[] = [],\n): MergedPlugins {\n  // Plugin-name dedup — catches double-install.\n  const seenPluginNames = new Map<string, number>()\n  for (const p of plugins) {\n    const count = (seenPluginNames.get(p.name) ?? 0) + 1\n    seenPluginNames.set(p.name, count)\n    if (count === 2) {\n      throw new KickPluginConflictError('plugin', p.name, [p.name, p.name])\n    }\n  }\n\n  const commandOwners = new Map<string, string>()\n  const pluginCommands: KickCommandDefinition[] = []\n  for (const p of plugins) {\n    for (const cmd of p.commands ?? []) {\n      const prior = commandOwners.get(cmd.name)\n      if (prior) {\n        throw new KickPluginConflictError('command', cmd.name, [prior, p.name])\n      }\n      commandOwners.set(cmd.name, p.name)\n      pluginCommands.push(cmd)\n    }\n  }\n\n  const adopterNames = new Set(adopterCommands.map((c) => c.name))\n  const filteredPlugin = pluginCommands.filter((c) => !adopterNames.has(c.name))\n  const commands = [...filteredPlugin, ...adopterCommands]\n\n  const typegenOwners = new Map<string, string>()\n  const typegens: TypegenPlugin[] = []\n  for (const p of plugins) {\n    for (const tg of p.typegens ?? []) {\n      const prior = typegenOwners.get(tg.id)\n      if (prior) {\n        throw new KickPluginConflictError('typegen', tg.id, [prior, p.name])\n      }\n      typegenOwners.set(tg.id, p.name)\n      typegens.push(tg)\n    }\n  }\n\n  const generatorOwners = new Map<string, string>()\n  const generators: DiscoveredGenerator[] = []\n  for (const p of plugins) {\n    for (const spec of p.generators ?? []) {\n      const prior = generatorOwners.get(spec.name)\n      if (prior) {\n        throw new KickPluginConflictError('generator', spec.name, [prior, p.name])\n      }\n      generatorOwners.set(spec.name, p.name)\n      generators.push({ source: p.name, spec: spec satisfies GeneratorSpec })\n    }\n  }\n\n  /**\n   * Apply every plugin's `register()` callback in input order against the\n   * given Commander program. Each callback receives a {@link KickCliPluginContext}:\n   * caller-supplied ctx wins (test fixtures can inject a different\n   * workspace boundary); otherwise a default ctx is built with\n   * `findProjectRoot(process.cwd())` as the project root, `cwd` matching\n   * `process.cwd()`, null config, no-op log, and the merged generator set\n   * threaded through so the `kick/generate` built-in can surface each as\n   * a Commander subcommand. The dynamic import of `findProjectRoot` keeps\n   * the caller-supplied fast path zero-cost.\n   */\n  const register = async (program: Command, ctx?: KickCliPluginContext): Promise<void> => {\n    let resolved: KickCliPluginContext\n    if (ctx) {\n      resolved = { generators, ...ctx }\n    } else {\n      const { findProjectRoot } = await import('../utils/project-root')\n      const cwd = process.cwd()\n      resolved = {\n        cwd,\n        projectRoot: findProjectRoot(cwd),\n        config: null,\n        log: () => {},\n        generators,\n      }\n    }\n    for (const p of plugins) {\n      if (p.register) await p.register(program, resolved)\n    }\n  }\n\n  return { commands, typegens, generators, register }\n}\n","// Barrel intentionally omits `./builtins` — that module top-level-imports\n// every register*Command, which pulls heavy modules (project scaffolders,\n// fs reads at import time) into the graph. Importers that need the\n// builtin list go through `./plugin/builtins` directly; tests + adopter\n// plugins consuming only the contract types import from here.\n\nexport type { KickCliPlugin } from './types'\nexport { defineCliPlugin, KickPluginConflictError } from './types'\nexport { mergeCliPlugins, type MergedPlugins } from './merge'\n"],"mappings":";;;;;;;;;;wFA4CA,SAAgB,EACd,EACA,EAAoD,CAAC,EACtC,CAEf,IAAM,EAAkB,IAAI,IAC5B,IAAK,IAAM,KAAK,EAAS,CACvB,IAAM,GAAS,EAAgB,IAAI,EAAE,IAAI,GAAK,GAAK,EAEnD,GADA,EAAgB,IAAI,EAAE,KAAM,CAAK,EAC7B,IAAU,EACZ,MAAM,IAAI,EAAwB,SAAU,EAAE,KAAM,CAAC,EAAE,KAAM,EAAE,IAAI,CAAC,CAExE,CAEA,IAAM,EAAgB,IAAI,IACpB,EAA0C,CAAC,EACjD,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAO,EAAE,UAAY,CAAC,EAAG,CAClC,IAAM,EAAQ,EAAc,IAAI,EAAI,IAAI,EACxC,GAAI,EACF,MAAM,IAAI,EAAwB,UAAW,EAAI,KAAM,CAAC,EAAO,EAAE,IAAI,CAAC,EAExE,EAAc,IAAI,EAAI,KAAM,EAAE,IAAI,EAClC,EAAe,KAAK,CAAG,CACzB,CAGF,IAAM,EAAe,IAAI,IAAI,EAAgB,IAAK,GAAM,EAAE,IAAI,CAAC,EAEzD,EAAW,CAAC,GADK,EAAe,OAAQ,GAAM,CAAC,EAAa,IAAI,EAAE,IAAI,CAC1C,EAAG,GAAG,CAAe,EAEjD,EAAgB,IAAI,IACpB,EAA4B,CAAC,EACnC,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAM,EAAE,UAAY,CAAC,EAAG,CACjC,IAAM,EAAQ,EAAc,IAAI,EAAG,EAAE,EACrC,GAAI,EACF,MAAM,IAAI,EAAwB,UAAW,EAAG,GAAI,CAAC,EAAO,EAAE,IAAI,CAAC,EAErE,EAAc,IAAI,EAAG,GAAI,EAAE,IAAI,EAC/B,EAAS,KAAK,CAAE,CAClB,CAGF,IAAM,EAAkB,IAAI,IACtB,EAAoC,CAAC,EAC3C,IAAK,IAAM,KAAK,EACd,IAAK,IAAM,KAAQ,EAAE,YAAc,CAAC,EAAG,CACrC,IAAM,EAAQ,EAAgB,IAAI,EAAK,IAAI,EAC3C,GAAI,EACF,MAAM,IAAI,EAAwB,YAAa,EAAK,KAAM,CAAC,EAAO,EAAE,IAAI,CAAC,EAE3E,EAAgB,IAAI,EAAK,KAAM,EAAE,IAAI,EACrC,EAAW,KAAK,CAAE,OAAQ,EAAE,KAAY,MAA6B,CAAC,CACxE,CAkCF,MAAO,CAAE,WAAU,WAAU,aAAY,eApBjB,EAAkB,IAA8C,CACtF,IAAI,EACJ,GAAI,EACF,EAAW,CAAE,aAAY,GAAG,CAAI,MAC3B,CACL,GAAM,CAAE,mBAAoB,MAAM,OAAO,8BAAwB,CAAA,KAAA,GAAA,EAAA,CAAA,EAC3D,EAAM,QAAQ,IAAI,EACxB,EAAW,CACT,MACA,YAAa,EAAgB,CAAG,EAChC,OAAQ,KACR,QAAW,CAAC,EACZ,YACF,CACF,CACA,IAAK,IAAM,KAAK,EACV,EAAE,UAAU,MAAM,EAAE,SAAS,EAAS,CAAQ,CAEtD,CAEkD,CACpD"}

package/dist/{project-QWNGOwFX.mjs → project-CnU7KcYI.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v6.6.0
+ * @forinda/kickjs-cli v6.7.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import{l as e,o as t}from"./project-docs-BSNKPfLT.mjs";import{i as n,t as r}from"./config-BOArOJm-.mjs";import{dirname as i,join as a,resolve as o}from"node:path";import{existsSync as s,readFileSync as c}from"node:fs";import{execFileSync as l,execSync as u}from"node:child_process";import{fileURLToPath as d}from"node:url";const f={express:{from:`@forinda/kickjs`,name:`expressRuntime`},fastify:{from:`@forinda/kickjs/fastify`,name:`fastifyRuntime`},h3:{from:`@forinda/kickjs/h3`,name:`h3Runtime`}};function p(e,t,n,r=[],i=`express`){let a=f[i],o=i===`express`;switch(t){case`minimal`:{let t=[],i=[],s=o?`import { bootstrap, ${a.name} } from '@forinda/kickjs'`:`import { bootstrap } from '@forinda/kickjs'\nimport { ${a.name} } from '${a.from}'`;r.includes(`swagger`)&&(t.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`),i.push(`    SwaggerAdapter({ info: { title: '${e}', version: '${n}' } }),`)),r.includes(`devtools`)&&(t.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`),i.push(`    DevToolsAdapter(),`));let c=t.length?t.join(`
+import{l as e,o as t}from"./project-docs-BV-h5EmP.mjs";import{i as n,t as r}from"./config-D6C74vFp.mjs";import{dirname as i,join as a,resolve as o}from"node:path";import{existsSync as s,readFileSync as c}from"node:fs";import{execFileSync as l,execSync as u}from"node:child_process";import{fileURLToPath as d}from"node:url";const f={express:{from:`@forinda/kickjs`,name:`expressRuntime`},fastify:{from:`@forinda/kickjs/fastify`,name:`fastifyRuntime`},h3:{from:`@forinda/kickjs/h3`,name:`h3Runtime`}};function p(e,t,n,r=[],i=`express`){let a=f[i],o=i===`express`;switch(t){case`minimal`:{let t=[],i=[],s=o?`import { bootstrap, ${a.name} } from '@forinda/kickjs'`:`import { bootstrap } from '@forinda/kickjs'\nimport { ${a.name} } from '${a.from}'`;r.includes(`swagger`)&&(t.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`),i.push(`    SwaggerAdapter({ info: { title: '${e}', version: '${n}' } }),`)),r.includes(`devtools`)&&(t.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`),i.push(`    DevToolsAdapter(),`));let c=t.length?t.join(`
 `)+`
 `:``,l=i.length?`,\n  adapters: [\n${i.join(`
 `)}\n  ]`:``;return`import 'reflect-metadata'
@@ -384,7 +384,7 @@ export default defineConfig({
 `);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 ai db swagger`),console.log(`         kick add queue:bullmq`),console.log(`         kick add upload   # installs the multipart driver for your runtime`),console.log()}function W(e,t,n=`express`){let r=new Set,i=new Set,a=[],o=[],s=[];for(let c of e){if(c===`upload`){let e=F[n];s.push(`upload (${n}): ${e.note}`),e.prod&&(t?i:r).add(e.prod),e.dev&&i.add(e.dev);continue}let e=N[c];if(!e){a.push(c);continue}e.deprecated&&o.push(`'${c}' (${e.pkg}) is deprecated — ${e.deprecated}`);let l=t||e.dev?i:r;l.add(e.pkg);for(let t of e.peers)l.add(t)}return{prodDeps:[...r],devDeps:[...i],unknown:a,warnings:o,notices:s}}function G(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=>{U(!!e.all)})}function K(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){U(!!t.all);return}let{pm:n,source:r}=await V(t.pm);console.log(`\n  Using ${n} (resolved from ${r})`);let i=await I(process.cwd()),{prodDeps:a,devDeps:o,unknown:s,warnings:c,notices:l}=W(e,!!t.dev,i);for(let e of c)console.warn(`\n  WARNING: ${e}`);for(let e of l)console.log(`\n  ${e}`);if(!(s.length>0&&(console.log(`\n  Unknown packages: ${s.join(`, `)}`),console.log(`  Run "kick add --list" to see available packages.
 `),a.length===0&&o.length===0))){if(a.length>0){let e=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{u(t,{stdio:`inherit`})}catch{console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}if(o.length>0){let e=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{u(t,{stdio:`inherit`})}catch{console.log(`\n  Installation failed. Run manually:\n    ${t}\n`)}}console.log(`  Done!
-`)}})}const q=i(d(import.meta.url)),J=JSON.parse(c(a(q,`..`,`package.json`),`utf-8`)),Y=`^${J.version}`,X=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-schema`,`@forinda/kickjs-vite`,`@forinda/kickjs-swagger`,`@forinda/kickjs-ws`,`@forinda/kickjs-queue`,`@forinda/kickjs-devtools`,`@forinda/kickjs-testing`,`@forinda/kickjs-client`];async function Z(){let e=await Promise.all(X.map(async e=>{try{let t=l(`npm`,[`view`,e,`version`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();if(t&&/^\d+\.\d+\.\d+/.test(t))return[e,`^${t}`]}catch{}return[e,Y]}));return Object.fromEntries(e)}function Q(e,t){try{let n=l(`npm`,[`view`,`${e}@${t}`,`version`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}catch{return null}}function $(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function ee(e,t){let n=e=>$(e).split(`-`)[0].split(`.`).map(e=>Number.parseInt(e,10)||0),[r=0,i=0,a=0]=n(e),[o=0,s=0,c=0]=n(t);return r===o?i===s?a>=c:i>s:r>o}function te(e,t,n){try{let r=l(`npm`,[`view`,`${e}@${t}`,`exports`,`--json`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();if(!r)return!1;let i=JSON.parse(r);return Object.prototype.hasOwnProperty.call(i,n)}catch{return!1}}async function ne(n){let{name:r,directory:i,packageManager:o=`pnpm`,template:s=`rest`,defaultRepo:c=`inmemory`,packages:l=[],schemaLib:d=`zod`,runtime:f=`express`}=n,b=i,x=e=>console.log(`  ${e}`);console.log(`\n  Creating KickJS project: ${r}\n`),x(`Resolving package versions...`);let S=await Z();if(f!==`express`)if(te(`@forinda/kickjs`,`latest`,`./${f}`))x(`Using @forinda/kickjs@latest (stable ships the ${f} runtime)`);else{let e=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-vite`],t=[],n=!1;for(let r of e){let e=Q(r,`alpha`);e&&ee(e,$(S[r]))&&(S[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}x(n?`Using the alpha channel for the ${f} runtime: ${t.join(`, `)}`:`WARNING: could not resolve @forinda/kickjs@alpha — the ${f} runtime subpath may be missing. After install, run: ${o} add @forinda/kickjs@alpha`)}await e(a(b,`package.json`),C(r,s,S,l,d,f)),await e(a(b,`vite.config.ts`),w()),await e(a(b,`tsconfig.json`),T()),await e(a(b,`.prettierrc`),E()),await e(a(b,`.editorconfig`),D()),await e(a(b,`.gitignore`),O()),await e(a(b,`.gitattributes`),k()),await e(a(b,`.env`),A()),await e(a(b,`.env.example`),j()),await e(a(b,`src/config/index.ts`),h(d)),await e(a(b,`src/index.ts`),p(r,s,J.version,l,f)),await e(a(b,`src/modules/index.ts`),m()),await e(a(b,`src/modules/hello/hello.service.ts`),g()),await e(a(b,`src/modules/hello/hello.controller.ts`),_()),await e(a(b,`src/modules/hello/hello.module.ts`),v()),await e(a(b,`kick.config.ts`),y(s,c,o,f)),await e(a(b,`vitest.config.ts`),M()),await e(a(b,`README.md`),t(r,s,o));let{generateAgentDocs:N}=await import(`./agent-docs-CqRWMHZ-.mjs`).then(e=>e.t);if(await N({outDir:b,name:r,pm:o,template:s,only:`all`,force:!0}),n.installDeps){console.log(`\n  Installing dependencies with ${o}...\n`);try{u(`${o} install`,{cwd:b,stdio:`inherit`}),console.log(`
-  Dependencies installed successfully!`)}catch{console.log(`\n  Warning: ${o} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-BTfDyerr.mjs`).then(e=>e.n);await e({cwd:b,allowDuplicates:!0,silent:!0})}catch{}if(n.initGit)try{u(`git init`,{cwd:b,stdio:`pipe`}),u(`git branch -M main`,{cwd:b,stdio:`pipe`}),u(`git add -A`,{cwd:b,stdio:`pipe`}),u(`git commit -m "chore: initial commit from kick new"`,{cwd:b,stdio:`pipe`}),x(`Git repository initialized`)}catch{x(`Warning: git init failed (git may not be installed)`)}console.log(`
+`)}})}const q=i(d(import.meta.url)),J=JSON.parse(c(a(q,`..`,`package.json`),`utf-8`)),Y=`^${J.version}`,X=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-schema`,`@forinda/kickjs-vite`,`@forinda/kickjs-swagger`,`@forinda/kickjs-ws`,`@forinda/kickjs-queue`,`@forinda/kickjs-devtools`,`@forinda/kickjs-testing`,`@forinda/kickjs-client`];async function Z(){let e=await Promise.all(X.map(async e=>{try{let t=l(`npm`,[`view`,e,`version`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();if(t&&/^\d+\.\d+\.\d+/.test(t))return[e,`^${t}`]}catch{}return[e,Y]}));return Object.fromEntries(e)}function Q(e,t){try{let n=l(`npm`,[`view`,`${e}@${t}`,`version`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();return n&&/^\d+\.\d+\.\d+/.test(n)?n:null}catch{return null}}function $(e){return(e??``).replace(/^[\^~>=<\s]+/,``)}function ee(e,t){let n=e=>$(e).split(`-`)[0].split(`.`).map(e=>Number.parseInt(e,10)||0),[r=0,i=0,a=0]=n(e),[o=0,s=0,c=0]=n(t);return r===o?i===s?a>=c:i>s:r>o}function te(e,t,n){try{let r=l(`npm`,[`view`,`${e}@${t}`,`exports`,`--json`],{encoding:`utf-8`,timeout:5e3,stdio:[`ignore`,`pipe`,`ignore`]}).toString().trim();if(!r)return!1;let i=JSON.parse(r);return Object.prototype.hasOwnProperty.call(i,n)}catch{return!1}}async function ne(n){let{name:r,directory:i,packageManager:o=`pnpm`,template:s=`rest`,defaultRepo:c=`inmemory`,packages:l=[],schemaLib:d=`zod`,runtime:f=`express`}=n,b=i,x=e=>console.log(`  ${e}`);console.log(`\n  Creating KickJS project: ${r}\n`),x(`Resolving package versions...`);let S=await Z();if(f!==`express`)if(te(`@forinda/kickjs`,`latest`,`./${f}`))x(`Using @forinda/kickjs@latest (stable ships the ${f} runtime)`);else{let e=[`@forinda/kickjs`,`@forinda/kickjs-cli`,`@forinda/kickjs-vite`],t=[],n=!1;for(let r of e){let e=Q(r,`alpha`);e&&ee(e,$(S[r]))&&(S[r]=`^${e}`,t.push(`${r}@^${e}`),r===`@forinda/kickjs`&&(n=!0))}x(n?`Using the alpha channel for the ${f} runtime: ${t.join(`, `)}`:`WARNING: could not resolve @forinda/kickjs@alpha — the ${f} runtime subpath may be missing. After install, run: ${o} add @forinda/kickjs@alpha`)}await e(a(b,`package.json`),C(r,s,S,l,d,f)),await e(a(b,`vite.config.ts`),w()),await e(a(b,`tsconfig.json`),T()),await e(a(b,`.prettierrc`),E()),await e(a(b,`.editorconfig`),D()),await e(a(b,`.gitignore`),O()),await e(a(b,`.gitattributes`),k()),await e(a(b,`.env`),A()),await e(a(b,`.env.example`),j()),await e(a(b,`src/config/index.ts`),h(d)),await e(a(b,`src/index.ts`),p(r,s,J.version,l,f)),await e(a(b,`src/modules/index.ts`),m()),await e(a(b,`src/modules/hello/hello.service.ts`),g()),await e(a(b,`src/modules/hello/hello.controller.ts`),_()),await e(a(b,`src/modules/hello/hello.module.ts`),v()),await e(a(b,`kick.config.ts`),y(s,c,o,f)),await e(a(b,`vitest.config.ts`),M()),await e(a(b,`README.md`),t(r,s,o));let{generateAgentDocs:N}=await import(`./agent-docs-tlau7tZv.mjs`).then(e=>e.t);if(await N({outDir:b,name:r,pm:o,template:s,only:`all`,force:!0}),n.installDeps){console.log(`\n  Installing dependencies with ${o}...\n`);try{u(`${o} install`,{cwd:b,stdio:`inherit`}),console.log(`
+  Dependencies installed successfully!`)}catch{console.log(`\n  Warning: ${o} install failed. Run it manually.`)}}try{let{runTypegen:e}=await import(`./typegen-qeQ5co2C.mjs`).then(e=>e.n);await e({cwd:b,allowDuplicates:!0,silent:!0})}catch{}if(n.initGit)try{u(`git init`,{cwd:b,stdio:`pipe`}),u(`git branch -M main`,{cwd:b,stdio:`pipe`}),u(`git add -A`,{cwd:b,stdio:`pipe`}),u(`git commit -m "chore: initial commit from kick new"`,{cwd:b,stdio:`pipe`}),x(`Git repository initialized`)}catch{x(`Warning: git init failed (git may not be installed)`)}console.log(`
   Project scaffolded successfully!`),console.log();let F=b!==process.cwd();x(`Next steps:`),F&&x(`  cd ${r}`),n.installDeps||x(`  ${o} install`);let I={rest:`kick g module user`,ddd:`kick g module user --repo drizzle`,cqrs:`kick g module user --pattern cqrs`,minimal:`# add your routes to src/index.ts`};x(`  ${I[s]??I.rest}`),x(`  kick dev`),x(``),x(`Commands:`),x(`  kick dev                  Start dev server with Vite HMR`),x(`  kick build                Production build via Vite`),x(`  kick start                Run production build`),x(``),x(`Generators:`),x(`  kick g module <name>      Full DDD module (controller, DTOs, use-cases, repo)`),x(`  kick g scaffold <n> <f..> CRUD module from field definitions`),x(`  kick g controller <name>  Standalone controller`),x(`  kick g service <name>     @Service() class`),x(`  kick g middleware <name>   Express middleware`),x(`  kick g guard <name>       Route guard (auth, roles, etc.)`),x(`  kick g adapter <name>     AppAdapter with lifecycle hooks`),x(`  kick g dto <name>         Zod DTO schema`),x(`  kick g config             Generate kick.config.ts`),x(``),x(`Add packages:`),x(`  kick add <pkg>            Install a KickJS package + peers`),x(`  kick add --list           Show all available packages`),x(``),x(`Available: ${P}`),x(``)}export{K as a,H as c,F as i,Z as n,G as o,N as r,I as s,ne as t};
-//# sourceMappingURL=project-QWNGOwFX.mjs.map
+//# sourceMappingURL=project-CnU7KcYI.mjs.map