@forinda/kickjs-cli 8.10.1 → 8.11.0

package/dist/{agent-docs-uEhHT_Tq.mjs → agent-docs-DUxCvCBc.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.11.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,7 +8,7 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-D8pytGn4.mjs";import{o as t,r as n,u as r}from"./config-CVuSVUvw.mjs";import{n as i,o as a}from"./package-manager-Bk2uiXkV.mjs";import{existsSync as o,readFileSync as s}from"node:fs";import{join as c}from"node:path";import*as l from"@clack/prompts";import u from"picocolors";const d={GET:u.green,POST:u.cyan,PUT:u.yellow,PATCH:u.magenta,DELETE:u.red};function f(e){return(d[e]??u.dim)(e.padEnd(7))}function p(e){let t=`[${e}]`.padEnd(10);switch(e){case`CRITICAL`:return u.red(t);case`WARNING`:return u.yellow(t);case`INFO`:return u.blue(u.dim(t));default:return t}}u.green(`✓`),u.red(`✖`),u.yellow(`⚠`),u.blue(`ℹ`);function m(e){l.intro(u.bgCyan(u.black(` ${e} `)))}function h(e){l.outro(e)}function g(e){l.isCancel(e)&&(l.cancel(`Operation cancelled.`),process.exit(0))}async function _(e){let t=await l.text(e);return g(t),t}async function v(e){let t=await l.select(e);return g(t),t}async function y(e){let t=await l.multiselect(e);return g(t),t}async function b(e){let t=await l.confirm(e);return g(t),t}function x(){return l.spinner()}const S=l.log;function C(e,t){let n=e;return t===`fullstack`&&n!==`pnpm`?`${r(n,`dev:server`)} + ${r(n,`dev:web`)}`:r(n,`dev`)}function w(e,t,i){return`# CLAUDE.md — ${e}
+import{t as e}from"./rolldown-runtime-DAPeToCs.mjs";import{f as t,o as n,r}from"./config-DhzyaY1S.mjs";import{n as i,o as a}from"./package-manager-Ogog_AHE.mjs";import{existsSync as o,readFileSync as s}from"node:fs";import{join as c}from"node:path";import*as l from"@clack/prompts";import u from"picocolors";const d={GET:u.green,POST:u.cyan,PUT:u.yellow,PATCH:u.magenta,DELETE:u.red};function f(e){return(d[e]??u.dim)(e.padEnd(7))}function p(e){let t=`[${e}]`.padEnd(10);switch(e){case`CRITICAL`:return u.red(t);case`WARNING`:return u.yellow(t);case`INFO`:return u.blue(u.dim(t));default:return t}}u.green(`✓`),u.red(`✖`),u.yellow(`⚠`),u.blue(`ℹ`);function m(e){l.intro(u.bgCyan(u.black(` ${e} `)))}function h(e){l.outro(e)}function g(e){l.isCancel(e)&&(l.cancel(`Operation cancelled.`),process.exit(0))}async function _(e){let t=await l.text(e);return g(t),t}async function v(e){let t=await l.select(e);return g(t),t}async function y(e){let t=await l.multiselect(e);return g(t),t}async function b(e){let t=await l.confirm(e);return g(t),t}function x(){return l.spinner()}const S=l.log;function C(e,n){let r=e;return n===`fullstack`&&r!==`pnpm`?`${t(r,`dev:server`)} + ${t(r,`dev:web`)}`:t(r,`dev`)}function w(e,n,i){return`# CLAUDE.md — ${e}
 
 **Read \`./.agents/AGENTS.md\` first.** It is the canonical, multi-agent
 reference for this project (Claude, Copilot, Codex, Gemini, etc.) —
@@ -57,15 +57,15 @@ prose.
 
 \`\`\`bash
 ${i} install
-${C(i,t)}     # Dev server with HMR + typegen
-${r(i,`build`)} && ${r(i,`start`)}  # Production
-${r(i,`test`)}    # Vitest
-${t===`fullstack`?r(i,`typecheck`):`${n(i,`kick`)} typecheck`}   # tsc/tsgo, whichever the project has
-${t===`fullstack`?r(i,`format`):`${n(i,`kick`)} format`}      # oxfmt
+${C(i,n)}     # Dev server with HMR + typegen
+${t(i,`build`)} && ${t(i,`start`)}  # Production
+${t(i,`test`)}    # Vitest
+${n===`fullstack`?t(i,`typecheck`):`${r(i,`kick`)} typecheck`}   # tsc/tsgo, whichever the project has
+${n===`fullstack`?t(i,`format`):`${r(i,`kick`)} format`}      # oxfmt
 \`\`\`
 
 \`kick\` is this project's dev dependency, not a global command: every \`kick …\`
-in these docs runs as \`${n(i,`kick`)} …\` in a shell.
+in these docs runs as \`${r(i,`kick`)} …\` in a shell.
 
 ## v4 framework reminders
 
@@ -73,7 +73,7 @@ When generating or modifying code in this project, stay aligned with the v4 conv
 
 - **Adapters**: \`defineAdapter()\` factory — never \`class implements AppAdapter\`.
 - **Plugins**: \`definePlugin()\` factory — never plain function returning \`KickPlugin\`.
-- **DI tokens**: \`<scope>/<PascalKey>[/<suffix>]\` — scope is lowercase, the key segment is **PascalCase** (e.g. \`'app/Users/repository'\`, \`'mycorp/Cache/redis'\`). First-party uses the reserved \`'kick/'\` prefix; this project owns its own scope.
+- **DI tokens**: \`<scope>/<area>/<key>[:<instance>]\` — a lowercase scope, then slash-separated segments (e.g. \`'app/users/repository'\`, \`'app/Users/repository'\`, \`'mycorp/cache/redis'\`). First-party uses the reserved \`'kick/'\` prefix; this project owns its own scope.
 - **Decorators**: \`@Controller()\` (no path arg — mount prefix comes from \`routes().path\`).
 - **HTTP runtime**: this app may run on Express, Fastify, or h3 — check \`kick.config.ts\` \`runtime\` (or \`bootstrap({ runtime })\`) before writing engine-specific code. Prefer engine-neutral \`ctx\` APIs (\`ctx.json\`/\`ctx.body\`/\`ctx.params\`/\`ctx.sse\`); don't assume \`ctx.req\` is an Express request. Uploads (\`@FileUpload\` → \`ctx.file\`/\`ctx.files\`) work on all three (\`kick add upload\` installs the driver). Full rules in \`.agents/AGENTS.md\` → "HTTP runtime".
 - **Module entry file** MUST be named \`<name>.module.ts\` and live under \`src/modules/<name>/\`. The Vite plugin auto-discovers \`*.module.[tj]sx?\` for graceful HMR — a misnamed \`projects.ts\` silently degrades every save into a full restart.
@@ -86,7 +86,7 @@ When generating or modifying code in this project, stay aligned with the v4 conv
 - **Refresh these files**: \`kick g agents -f\` regenerates \`CLAUDE.md\` at the project root and \`.agents/AGENTS.md\` + \`.agents/GEMINI.md\` + \`.agents/COPILOT.md\` + every \`.agents/skills/<name>/SKILL.md\` from the latest CLI templates. Hand-edited content is overwritten — keep customisation in \`.agents/AGENTS.local.md\` or per-skill \`SKILL.local.md\` files alongside.
 
 For everything else (controllers, services, modules, RequestContext API, generators, CLI commands, package additions, env wiring, troubleshooting) → \`.agents/AGENTS.md\`.
-`}function T(e,t,i){return`# AGENTS.md — AI Agent Guide for ${e}
+`}function T(e,n,i){return`# AGENTS.md — AI Agent Guide for ${e}
 
 This guide is the **canonical, multi-agent reference** for this KickJS
 application — Claude, Copilot, Codex, Gemini, etc. all read it first.
@@ -96,16 +96,16 @@ add tool-specific affordances on top.
 ## Before You Start
 
 1. Run \`${i} install\` to install dependencies
-2. Run \`${C(i,t)}\` to verify the app starts
+2. Run \`${C(i,n)}\` to verify the app starts
 
 \`kick\` is this project's dev dependency, not a global command: every \`kick …\`
-below runs as \`${n(i,`kick`)} …\` in a shell.${t===`fullstack`?`
+below runs as \`${r(i,`kick`)} …\` in a shell.${n===`fullstack`?`
 
 ## Fullstack workspace layout
 
 This is a WORKSPACE root — the KickJS API lives in \`server/\`, the typed web
-app in \`web/\`. Run both with \`${C(i,t)}\`. From this root,
-\`${r(i,`test`)}\`, \`${r(i,`typecheck`)}\` and \`${r(i,`format`)}\` reach into
+app in \`web/\`. Run both with \`${C(i,n)}\`. From this root,
+\`${t(i,`test`)}\`, \`${t(i,`typecheck`)}\` and \`${t(i,`format`)}\` reach into
 \`server/\` (and \`web/\` for typecheck).
 
 The type loop (do not break it):
@@ -191,8 +191,10 @@ mistakes:
 
 - **Plugins** — \`definePlugin()\` factory. Same shape, never plain function returning \`KickPlugin\`.
 
-- **DI tokens** — \`<scope>/<PascalKey>[/<suffix>]\`. Scope is lowercase,
-  the key segment is **PascalCase** (the regex enforces both):
+- **DI tokens** — \`<scope>/<area>/<key>[:<instance>]\`. The scope is
+  lowercase; the segments after it are identifiers (\`kick typegen\` warns
+  on names that don't fit — a bare \`'UserRepository'\`, a dotted
+  \`'app.db'\`):
 
   \`\`\`ts
   const USERS_REPO = createToken<UsersRepo>('app/Users/repository')
@@ -320,13 +322,13 @@ package additions, env access patterns, troubleshooting) is detailed below.
 | Formatter config | \`.oxfmtrc.json\` (oxfmt) |
 | CLI config | \`kick.config.ts\` |
 
-### Module Pattern (${t.toUpperCase()})
+### Module Pattern (${n.toUpperCase()})
 
 > **Vite HMR auto-discovery contract:** module files **must** be named \`<name>.module.ts\` (or \`.tsx\`/\`.js\`/\`.jsx\`) and live under \`src/modules/\`. The Vite plugin scans for \`*.module.[tj]sx?\` to drive graceful HMR rebuilds; renaming a file to \`projects.ts\` (no \`.module\`) silently breaks HMR — saves trigger a full restart instead of a swap. The CLI generator (\`kick g module <name>\`) follows the convention; manual files must too.
 
 Each module in \`src/modules/<name>/\` typically contains:
 
-${t===`rest`?`\`\`\`
+${n===`rest`?`\`\`\`
 <name>/
 ├── <name>.controller.ts     # HTTP routes (@Controller)
 ├── <name>.service.ts        # Business logic (@Service)
@@ -501,7 +503,7 @@ page and lists the local tools (\`kick explain\`, \`kick doctor\`, \`kick inspec
 
 Start at <https://kickjs.app/>.
 
-`}function E(e,t=`define`){let i=t===`class`?`UserModule`:`UserModule()`;return[{slug:`add-module`,frontmatterName:`kickjs-add-module`,description:`Use when the user asks to add a new feature module (controller + service + repo + DTOs).`,body:`**Trigger phrases**: "add a users module", "scaffold tasks", "new feature for X".
+`}function E(e,n=`define`){let i=n===`class`?`UserModule`:`UserModule()`;return[{slug:`add-module`,frontmatterName:`kickjs-add-module`,description:`Use when the user asks to add a new feature module (controller + service + repo + DTOs).`,body:`**Trigger phrases**: "add a users module", "scaffold tasks", "new feature for X".
 
 **Steps**:
 1. Run \`kick g module <name>\` (use plural form if the project pluralizes — check \`kick.config.ts\`).
@@ -548,7 +550,7 @@ routes() {
 - \`@Controller('/path')\` with a path argument — \`@Controller()\` takes no arguments; the prefix goes in the module's \`routes().path\`.
 - \`TodosModule\` instead of \`TodosModule()\` for a module that takes config — refused, since the bare name would silently select the defaults. A module with no config accepts either, but prefer the invoked form for consistency.
 - \`routes()\` returning \`router: …\` when a \`controller:\` would do — controller form is required for OpenAPI/Swagger introspection.
-- Module not registered in \`src/modules/index.ts\`.`},{slug:`add-adapter`,frontmatterName:`kickjs-add-adapter`,description:`Use when wiring a single-concern lifecycle integration (Swagger, DevTools, Sentry, Redis client).`,body:"**Steps**:\n1. `kick g adapter <name>` to scaffold the boilerplate, OR install via `kick add <package>` for first-party adapters.\n2. The generated file uses `defineAdapter()` — never `class implements AppAdapter`.\n3. Add the adapter instance (note the parens) to `src/adapters/index.ts` — don't inline in `src/index.ts`.\n4. Pick the right hook and middleware phase deliberately.\n5. Verify with `kick dev` that the adapter's lifecycle logs fire.\n\n**Canonical shape** — factory closure owns instance state:\n\n```ts\nexport const RedisAdapter = defineAdapter<RedisConfig>({\n  name: 'RedisAdapter',\n  defaults: { url: 'redis://localhost' },\n  build: (config) => {\n    const client = createClient(config.url)\n    return {\n      beforeStart: ({ container }) => {\n        container.registerInstance(REDIS_CLIENT, client)\n      },\n      afterStart: () => client.connect(),\n      shutdown: () => client.quit(),\n    }\n  },\n})\n\n// In src/adapters/index.ts:\nexport const adapters = [RedisAdapter({ url: env.REDIS_URL })] // <-- note parens\n```\n\n**Lifecycle hook decision tree**:\n- `beforeMount` — register early routes that should bypass middleware (health, docs UI).\n- `beforeStart` — DI ready, server not listening yet. **Use this for `container.registerInstance(...)` calls** so they work under `createTestApp` too.\n- `afterStart` — server has `ctx.server` available. Only use for things that need a listening server (Socket.IO upgrades, port logging). **Doesn't fire under `createTestApp`.**\n- `shutdown` — runs concurrently via `Promise.allSettled`, so one failure doesn't block siblings (but errors are swallowed — log inside).\n\n**Middleware phases** (see `MiddlewarePhase` JSDoc):\n`beforeGlobal` | `afterGlobal` (default) | `beforeRoutes` | `afterRoutes` (fires only on fall-through — matched routes that respond skip it).\n\n**Multi-instance** — `.scoped('cache', { url: ... })` makes `name` become `RedisAdapter:cache`. **Deferred config** — `.async({ inject, useFactory })` for config that depends on DI-resolved services.\n\n**Red flags**:\n- `bootstrap({ adapters: [MyAdapter] })` — passed the factory, not the instance. Call it: `MyAdapter()`.\n- Inlining the adapter list directly in `src/index.ts` — entry file should stay thin.\n- Returning a plain object instead of going through `defineAdapter()` — type inference for `config` will be wrong.\n- Using `.async()` for an adapter that returns `middleware()` / `contributors()` / `beforeMount()` / `onRouteMount()` — those hooks have already run by the time `.async()` resolves and are silently skipped.\n- Cross-adapter ordering via array position when it's load-bearing — use `dependsOn: ['OtelAdapter']`; cycles throw `MountCycleError` at boot.\n- Using an adapter when the integration ships **modules + DI bindings + middleware** together → that's a plugin. Promote to `definePlugin()` (see `add-plugin` skill).\n\n**Nuances**:\n- `AdapterContext.server` is `undefined` outside `afterStart`.\n- `shutdown` errors are swallowed by `Promise.allSettled` — wrap in try/catch and log if you care."},{slug:`add-plugin`,frontmatterName:`kickjs-add-plugin`,description:`Use when scaffolding a feature that bundles modules + DI + middleware + adapters together (auth, monitoring suite, multi-tenant scaffolding).`,body:"**When plugin > adapter**: a plugin is the right answer when the integration ships **more than one** of: a module, a DI binding, middleware, or another adapter. If you have a single hook (`beforeStart`) and no other contributions, use `defineAdapter` instead.\n\n**Canonical shape**:\n\n```ts\nimport { definePlugin } from '@forinda/kickjs'\n\nexport const AuthPlugin = definePlugin({\n  name: 'AuthPlugin',\n  defaults: { tokenTtl: '1h' },\n  build: (config, { name }) => ({\n    modules: () => [AuthModule()],\n    adapters: () => [JwtAdapter({ ttl: config.tokenTtl })],\n    middleware: () => [requestIdMiddleware()],\n    register(container) {\n      container.registerFactory(TOKEN_SIGNER, () => createSigner(config))\n    },\n    contributors() {\n      return [LoadCurrentUser.registration]\n    },\n    onReady({ server }) {\n      log.info(`AuthPlugin listening on port ${server.address().port}`)\n    },\n  }),\n})\n\n// In bootstrap:\nbootstrap({ plugins: [AuthPlugin({ tokenTtl: env.TOKEN_TTL })] }) // <-- parens\n```\n\n**Inline plugin literal** — the canonical answer for one-off DI bindings. There's no top-level `register:` on `bootstrap` itself:\n\n```ts\nbootstrap({\n  plugins: [{ name: 'vector-store', register(c) { c.registerInstance(VECTOR_STORE, store) } }],\n})\n```\n\n**Execution order** (memorize):\nplugin `register()` → plugin `middleware()` → plugin `modules()` + user modules → plugin `adapters()` + user adapters → server listens → plugin `onReady()`.\n\n**Static vs dynamic modules**: `modules()` returning an array is introspectable (Swagger, DevTools see it). `setup(registry)` is imperative — pick the latter when the module set depends on resolved config.\n\n**Multi-instance** — `.scoped('users', { url })`; derive unique DI tokens from `ctx.name` inside `build`:\n\n```ts\nbuild: (config, { name }) => ({\n  register(c) {\n    c.registerInstance(createToken(`cache/${name}`), client)\n  },\n})\n```\n\n**Precedence**: plugin contributors land at `'adapter'` precedence — beat global, lose to module/class/method same-key.\n\n**Red flags**:\n- `bootstrap({ plugins: [AuthPlugin] })` — passed factory. Call it: `AuthPlugin()`.\n- Reaching for a plugin when an adapter would do (no modules, no DI bindings, no contributors) — overkill; use `defineAdapter()`.\n- `.async()` plugin that depends on `modules()` / `middleware()` / `adapters()` / `contributors()` — those are dropped. `.async()` only resolves `register()` + `onReady()`.\n- Confusing CLI plugins (`defineCliPlugin` from `@forinda/kickjs-cli`) with runtime plugins (`definePlugin` from `@forinda/kickjs`) — different surfaces, different registration sites.\n- `dependsOn: ['SomePlugin']` referring to a plugin not in the boot list — throws `MissingMountDepError` at boot.\n\n**Nuances**:\n- `definition` is `Object.freeze`'d metadata; useful for version checks (`compare(AuthPlugin.definition.version, '1.2.0')`) — not mountable."},{slug:`write-controller-test`,frontmatterName:`kickjs-write-controller-test`,description:`Use when adding a Vitest test that exercises an HTTP route or DI graph.`,body:`**Template** (copy/paste, adjust):
+- Module not registered in \`src/modules/index.ts\`.`},{slug:`add-adapter`,frontmatterName:`kickjs-add-adapter`,description:`Use when wiring a single-concern lifecycle integration (Swagger, DevTools, Sentry, Redis client).`,body:"**Steps**:\n1. `kick g adapter <name>` to scaffold the boilerplate, OR install via `kick add <package>` for first-party adapters.\n2. The generated file uses `defineAdapter()` — never `class implements AppAdapter`.\n3. Add the adapter instance (note the parens) to `src/adapters/index.ts` — don't inline in `src/index.ts`.\n4. Pick the right hook and middleware phase deliberately.\n5. Verify with `kick dev` that the adapter's lifecycle logs fire.\n\n**Canonical shape** — factory closure owns instance state:\n\n```ts\nexport const RedisAdapter = defineAdapter<RedisConfig>({\n  name: 'RedisAdapter',\n  defaults: { url: 'redis://localhost' },\n  build: (config) => {\n    const client = createClient(config.url)\n    return {\n      beforeStart: ({ container }) => {\n        container.registerInstance(REDIS_CLIENT, client)\n      },\n      afterStart: () => client.connect(),\n      shutdown: () => client.quit(),\n    }\n  },\n})\n\n// In src/adapters/index.ts:\nexport const adapters = [RedisAdapter({ url: getEnv('REDIS_URL') })] // <-- note parens\n```\n\n**Lifecycle hook decision tree**:\n- `beforeMount` — register early routes that should bypass middleware (health, docs UI).\n- `beforeStart` — DI ready, server not listening yet. **Use this for `container.registerInstance(...)` calls** so they work under `createTestApp` too.\n- `afterStart` — server has `ctx.server` available. Only use for things that need a listening server (Socket.IO upgrades, port logging). **Doesn't fire under `createTestApp`.**\n- `shutdown` — runs concurrently via `Promise.allSettled`, so one failure doesn't block siblings (but errors are swallowed — log inside).\n\n**Middleware phases** (see `MiddlewarePhase` JSDoc):\n`beforeGlobal` | `afterGlobal` (default) | `beforeRoutes` | `afterRoutes` (fires only on fall-through — matched routes that respond skip it).\n\n**Multi-instance** — `.scoped('cache', { url: ... })` makes `name` become `RedisAdapter:cache`. **Deferred config** — `.async({ inject, useFactory })` for config that depends on DI-resolved services.\n\n**Red flags**:\n- `bootstrap({ adapters: [MyAdapter] })` — passed the factory, not the instance. Call it: `MyAdapter()`.\n- Inlining the adapter list directly in `src/index.ts` — entry file should stay thin.\n- Returning a plain object instead of going through `defineAdapter()` — type inference for `config` will be wrong.\n- Using `.async()` for an adapter that returns `middleware()` / `contributors()` / `beforeMount()` / `onRouteMount()` — those hooks have already run by the time `.async()` resolves and are silently skipped.\n- Cross-adapter ordering via array position when it's load-bearing — use `dependsOn: ['OtelAdapter']`; cycles throw `MountCycleError` at boot.\n- Using an adapter when the integration ships **modules + DI bindings + middleware** together → that's a plugin. Promote to `definePlugin()` (see `add-plugin` skill).\n\n**Nuances**:\n- `AdapterContext.server` is `undefined` outside `afterStart`.\n- `shutdown` errors are swallowed by `Promise.allSettled` — wrap in try/catch and log if you care."},{slug:`add-plugin`,frontmatterName:`kickjs-add-plugin`,description:`Use when scaffolding a feature that bundles modules + DI + middleware + adapters together (auth, monitoring suite, multi-tenant scaffolding).`,body:"**When plugin > adapter**: a plugin is the right answer when the integration ships **more than one** of: a module, a DI binding, middleware, or another adapter. If you have a single hook (`beforeStart`) and no other contributions, use `defineAdapter` instead.\n\n**Canonical shape**:\n\n```ts\nimport { definePlugin } from '@forinda/kickjs'\n\nexport const AuthPlugin = definePlugin({\n  name: 'AuthPlugin',\n  defaults: { tokenTtl: '1h' },\n  build: (config, { name }) => ({\n    modules: () => [AuthModule()],\n    adapters: () => [JwtAdapter({ ttl: config.tokenTtl })],\n    middleware: () => [requestIdMiddleware()],\n    register(container) {\n      container.registerFactory(TOKEN_SIGNER, () => createSigner(config))\n    },\n    contributors() {\n      return [LoadCurrentUser.registration]\n    },\n    onReady({ server }) {\n      log.info(`AuthPlugin listening on port ${server.address().port}`)\n    },\n  }),\n})\n\n// In bootstrap:\nbootstrap({ plugins: [AuthPlugin({ tokenTtl: getEnv('TOKEN_TTL') })] }) // <-- parens\n```\n\n**Inline plugin literal** — the canonical answer for one-off DI bindings. There's no top-level `register:` on `bootstrap` itself:\n\n```ts\nbootstrap({\n  plugins: [{ name: 'vector-store', register(c) { c.registerInstance(VECTOR_STORE, store) } }],\n})\n```\n\n**Execution order** (memorize):\nplugin `register()` → plugin `middleware()` → plugin `modules()` + user modules → plugin `adapters()` + user adapters → server listens → plugin `onReady()`.\n\n**Static vs dynamic modules**: `modules()` returning an array is introspectable (Swagger, DevTools see it). `setup(registry)` is imperative — pick the latter when the module set depends on resolved config.\n\n**Multi-instance** — `.scoped('users', { url })`; derive unique DI tokens from `ctx.name` inside `build`:\n\n```ts\nbuild: (config, { name }) => ({\n  register(c) {\n    c.registerInstance(createToken(`cache/${name}`), client)\n  },\n})\n```\n\n**Precedence**: plugin contributors land at `'adapter'` precedence — beat global, lose to module/class/method same-key.\n\n**Red flags**:\n- `bootstrap({ plugins: [AuthPlugin] })` — passed factory. Call it: `AuthPlugin()`.\n- Reaching for a plugin when an adapter would do (no modules, no DI bindings, no contributors) — overkill; use `defineAdapter()`.\n- `.async()` plugin that depends on `modules()` / `middleware()` / `adapters()` / `contributors()` — those are dropped. `.async()` only resolves `register()` + `onReady()`.\n- Confusing CLI plugins (`defineCliPlugin` from `@forinda/kickjs-cli`) with runtime plugins (`definePlugin` from `@forinda/kickjs`) — different surfaces, different registration sites.\n- `dependsOn: ['SomePlugin']` referring to a plugin not in the boot list — throws `MissingMountDepError` at boot.\n\n**Nuances**:\n- `definition` is `Object.freeze`'d metadata; useful for version checks (`compare(AuthPlugin.definition.version, '1.2.0')`) — not mountable."},{slug:`write-controller-test`,frontmatterName:`kickjs-write-controller-test`,description:`Use when adding a Vitest test that exercises an HTTP route or DI graph.`,body:`**Template** (copy/paste, adjust):
 
 \`\`\`ts
 import { describe, it, expect, beforeEach } from 'vitest'
@@ -606,7 +608,7 @@ async create(ctx: Ctx<KickRoutes.TodoController['create']>) {
 **Nuances**:
 - \`@Inject\` and \`@Autowired\` are interchangeable — same runtime, same types; pick by readability.
 - \`@Value('MISSING_KEY')\` with no default **throws on property access**, not at construction — tests that exercise the getter will surface the missing-env issue.`},{slug:`env-wiring-check`,frontmatterName:`kickjs-env-wiring-check`,description:`Use when ConfigService.get('SOME_KEY') returns undefined or @Value silently falls back to process.env.`,body:`**Fastest path**: \`kick explain "ConfigService.get('MY_KEY') returned undefined"\` —
-pipe a failing run straight in if you prefer (\`${r(e,`test`)} 2>&1 | ${n(e,`kick`)} explain\`). It
+pipe a failing run straight in if you prefer (\`${t(e,`test`)} 2>&1 | ${r(e,`kick`)} explain\`). It
 distinguishes the entry-file cause from the test-file one, which is the step most
 people lose time on. The manual checks below are the same reasoning.
 
@@ -617,8 +619,10 @@ people lose time on. The manual checks below are the same reasoning.
    import { loadEnvFromSchema } from '@forinda/kickjs/config'
    import { fromZod } from '@forinda/kickjs-schema/zod'
    const envSchema = fromZod(z.object({ DATABASE_URL: z.url() }))
-   export const env = loadEnvFromSchema(envSchema)
+   loadEnvFromSchema(envSchema) // side effect: registers the schema
+   export default envSchema
    \`\`\`
+   App code reads values with \`getEnv('DATABASE_URL')\` (from \`@forinda/kickjs\`), an injected \`ConfigService\`, or \`@Value()\` — the config file exports no env object.
 3. The new key MUST be declared in the schema. \`@Value('NEW_KEY')\` accepts any string at the type level and **falls back to raw \`process.env\`** when the schema doesn't know the key — silently skipping its parsing and defaults.
 4. After adding a key, re-run \`kick typegen\` (or restart \`kick dev\` if the typegen watcher missed it) so the global \`KickEnv\` augmentation picks it up.
 
@@ -656,7 +660,7 @@ export const modules = defineModules().mount(HelloModule()).mount(UsersModule())
 export const middleware = [requestId(), express.json(), helmet(), cors(), traceContext()]
 
 // src/plugins/index.ts
-export const plugins = [MetricsPlugin(), AuthPlugin({ tokenTtl: env.TOKEN_TTL })]
+export const plugins = [MetricsPlugin(), AuthPlugin({ tokenTtl: getEnv('TOKEN_TTL') })]
 
 // src/adapters/index.ts
 export const adapters = [SwaggerAdapter({ ... }), DevToolsAdapter()]
@@ -701,7 +705,7 @@ plugins: [
 
 \`\`\`bash
 kick new my-api --yes                                  # CI-safe: minimal + inmemory, no prompts
-kick new my-api -t ddd --pm ${e} --no-git --install   # Fully scriptable DDD scaffold
+kick new my-api -t rest --pm ${e} --no-git --install  # Fully scriptable REST scaffold
 kick new . --yes --force                               # Scaffold into current dir, clear existing files
 kick g scaffold Post title:string body:text:optional   # Shell-safe optional field syntax
 kick g agents -f --only skills                         # Refresh just the skills after upgrade
@@ -837,7 +841,7 @@ fine and fails at runtime.
 **Local, and usually faster**
 
 - \`kick explain "<error message>"\` — matches known failures and gives the fix.
-  Pipe a failing run in: \`${r(e,`test`)} 2>&1 | ${n(e,`kick`)} explain\`.
+  Pipe a failing run in: \`${t(e,`test`)} 2>&1 | ${r(e,`kick`)} explain\`.
 - \`kick doctor\` — checks this project's wiring.
 - \`kick inspect\` — the live route / adapter table.
 - \`.kickjs/types/\` — generated types are ground truth for what exists.
@@ -921,4 +925,4 @@ Codex / Cursor / Gemini / Claude Code without copy-pasting.
 \`kick g agents --only copilot -f\` regenerates this file from the
 CLI template. Hand-edited content is overwritten — keep customisation
 in \`.agents/COPILOT.local.md\`.
-`}var A=/* @__PURE__ */ e({generateAgentDocs:()=>I});const j=`.agents`,M=/* @__PURE__ */ new Set([`rest`,`minimal`,`fullstack`,`inertia`]);function N(e,t){if(t)return t;try{let t=JSON.parse(s(c(e,`package.json`),`utf-8`));if(t.name)return t.name.replace(/^@[^/]+\//,``)}catch{}return e.split(`/`).findLast(Boolean)??`app`}async function P(e){try{return(await t(e))?.modules?.style===`class`?`class`:`define`}catch{return`define`}}async function F(e,n){if(n)return n;try{let n=(await t(e))?.pattern;if(n&&M.has(n))return n}catch{}return`rest`}async function I(e){let t=e.only??`all`,n=N(e.outDir,e.name),r=await i(e.pm,e.outDir),s=await F(e.outDir,e.template),l=await P(e.outDir),u=t===`agents`||t===`both`||t===`all`,d=t===`claude`||t===`both`||t===`all`,f=t===`skills`||t===`all`,p=t===`gemini`||t===`all`,m=t===`copilot`||t===`all`,h=[];if(u&&h.push({file:c(e.outDir,j,`AGENTS.md`),render:()=>T(n,s,r)}),d&&h.push({file:c(e.outDir,`CLAUDE.md`),render:()=>w(n,s,r)}),f)for(let t of D(n,s,r,l))h.push({file:c(e.outDir,j,`skills`,t.slug,`SKILL.md`),render:()=>t.content});p&&h.push({file:c(e.outDir,j,`GEMINI.md`),render:()=>O(n,s,r)}),m&&h.push({file:c(e.outDir,j,`COPILOT.md`),render:()=>k(n,s,r)});let g=[];for(let{file:t,render:n}of h)o(t)&&!e.force&&!await b({message:`${t.replace(e.outDir+`/`,``)} already exists. Overwrite?`,initialValue:!1})?console.log(`  Skipped — existing ${t.replace(e.outDir+`/`,``)} preserved.`):(await a(t,n()),g.push(t));return g}export{S as a,v as c,f as d,u as f,m as i,x as l,I as n,y as o,p,b as r,h as s,A as t,_ as u};
+`}var A=/* @__PURE__ */ e({generateAgentDocs:()=>I});const j=`.agents`,M=/* @__PURE__ */ new Set([`rest`,`minimal`,`fullstack`,`inertia`]);function N(e,t){if(t)return t;try{let t=JSON.parse(s(c(e,`package.json`),`utf-8`));if(t.name)return t.name.replace(/^@[^/]+\//,``)}catch{}return e.split(`/`).findLast(Boolean)??`app`}async function P(e){try{return(await n(e))?.modules?.style===`class`?`class`:`define`}catch{return`define`}}async function F(e,t){if(t)return t;try{let t=(await n(e))?.pattern;if(t&&M.has(t))return t}catch{}return`rest`}async function I(e){let t=e.only??`all`,n=N(e.outDir,e.name),r=await i(e.pm,e.outDir),s=await F(e.outDir,e.template),l=await P(e.outDir),u=t===`agents`||t===`both`||t===`all`,d=t===`claude`||t===`both`||t===`all`,f=t===`skills`||t===`all`,p=t===`gemini`||t===`all`,m=t===`copilot`||t===`all`,h=[];if(u&&h.push({file:c(e.outDir,j,`AGENTS.md`),render:()=>T(n,s,r)}),d&&h.push({file:c(e.outDir,`CLAUDE.md`),render:()=>w(n,s,r)}),f)for(let t of D(n,s,r,l))h.push({file:c(e.outDir,j,`skills`,t.slug,`SKILL.md`),render:()=>t.content});p&&h.push({file:c(e.outDir,j,`GEMINI.md`),render:()=>O(n,s,r)}),m&&h.push({file:c(e.outDir,j,`COPILOT.md`),render:()=>k(n,s,r)});let g=[];for(let{file:t,render:n}of h)o(t)&&!e.force&&!await b({message:`${t.replace(e.outDir+`/`,``)} already exists. Overwrite?`,initialValue:!1})?console.log(`  Skipped — existing ${t.replace(e.outDir+`/`,``)} preserved.`):(await a(t,n()),g.push(t));return g}export{S as a,v as c,f as d,u as f,m as i,x as l,I as n,y as o,p,b as r,h as s,A as t,_ as u};

package/dist/{build-D90mecBH.mjs → build-BQiF63pu.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.11.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,6 +8,6 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-D8pytGn4.mjs";import{dirname as t,isAbsolute as n,join as r,relative as i,resolve as a}from"node:path";import{cpSync as o,existsSync as s,mkdirSync as c,statSync as l,writeFileSync as u}from"node:fs";import{glob as d}from"glob";import{groupAssetKeys as f}from"@forinda/kickjs";var p=/* @__PURE__ */ e({ASSET_MANIFEST_VERSION:()=>1,buildAssets:()=>m});async function m(e,t){let{cwd:n,silent:o=!1}=t,s=t.distDir??e?.build?.outDir??`dist`,l=e?.assetMap;if(!l||Object.keys(l).length===0)return null;let d=o?()=>{}:console.log,f=a(n,s);c(f,{recursive:!0});let p=[],m={};for(let[e,t]of Object.entries(l)){let r=await h(e,t,n,f);p.push(r.entrySummary),Object.assign(m,r.manifestSlice),d(`    ✓ ${e}: ${r.entrySummary.filesCopied} file(s) → ${r.entrySummary.dest}`)}let g={version:1,entries:m},_=r(f,`.kickjs-assets.json`);return u(_,JSON.stringify(g,null,2)+`
+import{t as e}from"./rolldown-runtime-DAPeToCs.mjs";import{dirname as t,isAbsolute as n,join as r,relative as i,resolve as a}from"node:path";import{cpSync as o,existsSync as s,mkdirSync as c,statSync as l,writeFileSync as u}from"node:fs";import{glob as d}from"glob";import{groupAssetKeys as f}from"@forinda/kickjs";var p=/* @__PURE__ */ e({ASSET_MANIFEST_VERSION:()=>1,buildAssets:()=>m});async function m(e,t){let{cwd:n,silent:o=!1}=t,s=t.distDir??e?.build?.outDir??`dist`,l=e?.assetMap;if(!l||Object.keys(l).length===0)return null;let d=o?()=>{}:console.log,f=a(n,s);c(f,{recursive:!0});let p=[],m={};for(let[e,t]of Object.entries(l)){let r=await h(e,t,n,f);p.push(r.entrySummary),Object.assign(m,r.manifestSlice),d(`    ✓ ${e}: ${r.entrySummary.filesCopied} file(s) → ${r.entrySummary.dest}`)}let g={version:1,entries:m},_=r(f,`.kickjs-assets.json`);return u(_,JSON.stringify(g,null,2)+`
 `,`utf-8`),d(`    ✓ wrote manifest → ${i(n,_)} (${Object.keys(m).length} entries)`),{manifestPath:_,entries:p,manifest:g}}async function h(e,n,l,u){let p=a(l,n.src),m=n.dest?a(l,n.dest):r(u,e);if(v(m,l))return console.warn(`  ⚠ assetMap.${e}.dest ('${n.dest}') resolves outside the project root — skipping copy`),{entrySummary:{namespace:e,src:n.src,dest:i(l,m),filesCopied:0},manifestSlice:{}};if(!s(p)||!y(p))return{entrySummary:{namespace:e,src:n.src,dest:i(l,m),filesCopied:0},manifestSlice:{}};let h=n.glob??`**/*`,b=await d(h,{cwd:p,nodir:!0,dot:!1,posix:!0});c(m,{recursive:!0});let x={},S=[...b].toSorted(),{pairs:C,collisionGroupsResolved:w}=f(e,S,{strategy:n.keys??`auto`}),T=0;for(let{rel:e,key:n}of C){let i=r(p,e),a=r(m,e);x[n]=_(u,a),!g(i,a)&&(c(t(a),{recursive:!0}),o(i,a),T++)}return w>0&&console.log(`  ℹ assetMap.${e}: auto-resolved ${w} 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:n.src,dest:i(l,m),filesCopied:T},manifestSlice:x}}function g(e,t){if(!s(t))return!1;try{let n=l(e),r=l(t);return r.size===n.size&&r.mtimeMs>=n.mtimeMs}catch{return!1}}function _(e,t){return i(e,t).split(/[\\/]/).filter(Boolean).join(`/`)}function v(e,t){let r=i(t,e);return r===``?!1:r.startsWith(`..`)||n(r)}function y(e){try{return l(e).isDirectory()}catch{return!1}}export{p as n,m as t};
-//# sourceMappingURL=build-D90mecBH.mjs.map
+//# sourceMappingURL=build-BQiF63pu.mjs.map

package/dist/{build-D90mecBH.mjs.map → build-BQiF63pu.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"build-D90mecBH.mjs","names":["__exportAll","build_exports","buildAssets","opts","distDir","config","map","log","silent","distAbs","resolve","cwd","mkdirSync","summary","manifestEntries","namespace","entry","result","processEntry","manifest","manifestPath","join","writeFileSync","relative","srcAbs","destAbs","escapesRoot","existsSync","isDirectorySync","pattern","matches","glob","manifestSlice","sorted","groupAssetKeys","filesCopied","relPath","pairs","srcFile","destFile","key","toManifestRelative","dirname","cpSync","collisionGroupsResolved","isUpToDate","s","statSync","d","manifestDir","rel","root","path","isAbsolute"],"sources":["../src/asset-manager/build.ts"],"sourcesContent":["/**\n * Build pipeline for `assetMap` entries (asset-manager PR 2).\n *\n * For each entry, walks `src/<...>` matching the configured `glob`,\n * copies matches into `dest` (default `dist/<name>/`), then emits a\n * `dist/.kickjs-assets.json` manifest mapping logical\n * `<namespace>/<key>` keys to repo-relative paths inside `dist/`.\n *\n * Pure function on top of `node:fs` + `glob` — no shell, no side\n * effects beyond the configured directory writes. The build entry-\n * point in `commands/run.ts` calls `buildAssets` after the existing\n * `copyDirs` step.\n *\n * @module @forinda/kickjs-cli/asset-manager/build\n */\n\nimport { cpSync, existsSync, mkdirSync, statSync, writeFileSync } from 'node:fs'\nimport { dirname, isAbsolute, join, relative, resolve } from 'node:path'\nimport { glob } from 'glob'\nimport { groupAssetKeys } from '@forinda/kickjs'\nimport type { AssetMapEntry, KickConfig } from '../config'\n\n/** Wire-format version for `dist/.kickjs-assets.json`. Bump on shape change. */\nexport const ASSET_MANIFEST_VERSION = 1 as const\n\n/** On-disk manifest format (`dist/.kickjs-assets.json`). */\nexport interface AssetManifest {\n  version: typeof ASSET_MANIFEST_VERSION\n  /**\n   * Logical key → manifest-relative path. Logical key is\n   * `<namespace>/<key>` where `<key>` is the file path under `src`\n   * with the extension stripped + path separators normalised.\n   *\n   * Path values are relative to the manifest file's directory so the\n   * runtime can resolve them with a single `path.resolve(manifestDir,\n   * entry)` regardless of where dist/ lives.\n   */\n  entries: Record<string, string>\n}\n\nexport interface BuildAssetsOptions {\n  /** Project root — resolved for every relative path in the entry. */\n  cwd: string\n  /**\n   * Output dir for the manifest + per-namespace asset copies. When\n   * omitted, falls back to `config.build?.outDir` (resolved against\n   * `cwd`), then to `dist/` under cwd. Adopters with a custom Vite\n   * `build.outDir` should set `kick.config.ts.build.outDir` to match.\n   */\n  distDir?: string\n  /** Suppress per-entry log lines. Default: false. */\n  silent?: boolean\n}\n\n/** One entry in the per-build summary returned by `buildAssets`. */\nexport interface BuildAssetsEntryResult {\n  namespace: string\n  src: string\n  dest: string\n  /**\n   * Number of files actually written this run. On an incremental\n   * rebuild where nothing changed this is 0 even though the manifest\n   * still lists every matched file.\n   */\n  filesCopied: number\n}\n\n/** Aggregated outcome of `buildAssets`. */\nexport interface BuildAssetsResult {\n  manifestPath: string\n  entries: BuildAssetsEntryResult[]\n  /** `entries` merged into a single record — useful for tests + tooling. */\n  manifest: AssetManifest\n}\n\n/**\n * Run the full asset build for a loaded config:\n *\n * 1. For each `assetMap` entry, glob → copy → manifest stub.\n * 2. Write `dist/.kickjs-assets.json`.\n *\n * Returns a summary including the manifest contents. No-op (and no\n * manifest written) when `assetMap` is empty / missing — the build\n * pipeline shouldn't litter `dist/` with empty manifests for\n * adopters who don't use the feature.\n */\nexport async function buildAssets(\n  config: KickConfig | null,\n  opts: BuildAssetsOptions,\n): Promise<BuildAssetsResult | null> {\n  const { cwd, silent = false } = opts\n  // Resolution order: explicit opts.distDir → config.build.outDir → 'dist'.\n  // The CLI build command passes nothing explicit, so adopters control\n  // the output via kick.config.ts.build.outDir alone.\n  const distDir = opts.distDir ?? config?.build?.outDir ?? 'dist'\n  const map = config?.assetMap\n  if (!map || Object.keys(map).length === 0) return null\n\n  const log = silent ? () => {} : console.log\n\n  const distAbs = resolve(cwd, distDir)\n  mkdirSync(distAbs, { recursive: true })\n\n  const summary: BuildAssetsEntryResult[] = []\n  const manifestEntries: Record<string, string> = {}\n\n  for (const [namespace, entry] of Object.entries(map)) {\n    const result = await processEntry(namespace, entry, cwd, distAbs)\n    summary.push(result.entrySummary)\n    Object.assign(manifestEntries, result.manifestSlice)\n    log(\n      `    ✓ ${namespace}: ${result.entrySummary.filesCopied} file(s) → ${result.entrySummary.dest}`,\n    )\n  }\n\n  const manifest: AssetManifest = {\n    version: ASSET_MANIFEST_VERSION,\n    entries: manifestEntries,\n  }\n  const manifestPath = join(distAbs, '.kickjs-assets.json')\n  writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\\n', 'utf-8')\n  log(\n    `    ✓ wrote manifest → ${relative(cwd, manifestPath)} (${Object.keys(manifestEntries).length} entries)`,\n  )\n\n  return { manifestPath, entries: summary, manifest }\n}\n\n/** Per-entry inner pipeline — extracted for unit-test reuse. */\nasync function processEntry(\n  namespace: string,\n  entry: AssetMapEntry,\n  cwd: string,\n  distAbs: string,\n): Promise<{\n  entrySummary: BuildAssetsEntryResult\n  manifestSlice: Record<string, string>\n}> {\n  const srcAbs = resolve(cwd, entry.src)\n  const destAbs = entry.dest ? resolve(cwd, entry.dest) : join(distAbs, namespace)\n\n  // Defensive: refuse to write outside the project root (cwd) even\n  // though validateAssetMap warned about it at config-load time. The\n  // build step shouldn't trust upstream warnings — a typo like\n  // `dest: '../../'` would otherwise sprinkle files outside the\n  // workspace despite the warning being printed.\n  if (escapesRoot(destAbs, cwd)) {\n    console.warn(\n      `  ⚠ assetMap.${namespace}.dest ('${entry.dest}') resolves outside the project root — skipping copy`,\n    )\n    return {\n      entrySummary: { namespace, src: entry.src, dest: relative(cwd, destAbs), filesCopied: 0 },\n      manifestSlice: {},\n    }\n  }\n\n  // Treat src-not-a-directory the same as src-missing — `glob` would\n  // throw if pointed at a file, surfacing as a generic build failure\n  // instead of a clean 0-files entry. Matches the validator's warning\n  // shape (already emitted at config-load time for the missing case).\n  if (!existsSync(srcAbs) || !isDirectorySync(srcAbs)) {\n    return {\n      entrySummary: { namespace, src: entry.src, dest: relative(cwd, destAbs), filesCopied: 0 },\n      manifestSlice: {},\n    }\n  }\n\n  const pattern = entry.glob ?? '**/*'\n  // `glob` returns paths relative to `cwd` when `cwd` is set —\n  // exactly the slugs we want for the manifest keys.\n  const matches = await glob(pattern, {\n    cwd: srcAbs,\n    nodir: true,\n    dot: false,\n    posix: true,\n  })\n\n  mkdirSync(destAbs, { recursive: true })\n\n  const manifestSlice: Record<string, string> = {}\n  // Sort the walk so the manifest is byte-stable across platforms.\n  // The `groupAssetKeys` helper preserves input order, so a stable\n  // sort here makes the resulting manifest stable too.\n  const sorted = [...matches].toSorted()\n  const { pairs, collisionGroupsResolved } = groupAssetKeys(namespace, sorted, {\n    strategy: entry.keys ?? 'auto',\n  })\n\n  // Copy the files and write the keyed manifest slice. Both come from\n  // the same `pairs` order so the on-disk layout matches the\n  // manifest's iteration order — easier to grep in cold-start\n  // debugging.\n  //\n  // Incremental: skip the copy when the destination is already\n  // up-to-date (exists, same size, mtime ≥ source). `cpSync` stamps the\n  // copy with the current time, so an unchanged source always satisfies\n  // `dest.mtime ≥ src.mtime` on the next run — turning a re-build into a\n  // pure stat sweep instead of re-copying every asset. The manifest\n  // slice is written unconditionally so the manifest stays complete.\n  let filesCopied = 0\n  for (const { rel: relPath, key } of pairs) {\n    const srcFile = join(srcAbs, relPath)\n    const destFile = join(destAbs, relPath)\n    manifestSlice[key] = toManifestRelative(distAbs, destFile)\n    if (isUpToDate(srcFile, destFile)) continue\n    mkdirSync(dirname(destFile), { recursive: true })\n    cpSync(srcFile, destFile)\n    filesCopied++\n  }\n\n  if (collisionGroupsResolved > 0) {\n    console.log(\n      `  ℹ assetMap.${namespace}: auto-resolved ${collisionGroupsResolved} basename collision(s) by keeping extensions ` +\n        `(set 'keys: \"strip\"' to opt back into legacy last-write-wins behaviour, or 'keys: \"with-extension\"' to keep all keys verbose).`,\n    )\n  }\n\n  return {\n    entrySummary: {\n      namespace,\n      src: entry.src,\n      dest: relative(cwd, destAbs),\n      filesCopied,\n    },\n    manifestSlice,\n  }\n}\n\n/**\n * Is `destFile` already a current copy of `srcFile`? True when the\n * destination exists with the same byte size and an mtime no older than\n * the source. Used to skip redundant copies on an incremental rebuild.\n */\nfunction isUpToDate(srcFile: string, destFile: string): boolean {\n  if (!existsSync(destFile)) return false\n  try {\n    const s = statSync(srcFile)\n    const d = statSync(destFile)\n    return d.size === s.size && d.mtimeMs >= s.mtimeMs\n  } catch {\n    return false\n  }\n}\n\n/**\n * Make `destFile` relative to the manifest's directory + force POSIX\n * separators so the manifest is byte-stable across platforms.\n */\nfunction toManifestRelative(manifestDir: string, destFile: string): string {\n  const rel = relative(manifestDir, destFile)\n  // path.relative returns OS-native separators; the manifest is JSON\n  // and the runtime uses path.resolve which handles either, but a\n  // forward-slash manifest is grep-friendly + diff-stable.\n  return rel.split(/[\\\\/]/).filter(Boolean).join('/')\n}\n\n/**\n * Pure manifest writer — handy for tests that want to assert against\n * a hand-crafted manifest without exercising the full pipeline.\n */\nexport function writeAssetManifest(distDir: string, manifest: AssetManifest): string {\n  const path = join(distDir, '.kickjs-assets.json')\n  mkdirSync(distDir, { recursive: true })\n  writeFileSync(path, JSON.stringify(manifest, null, 2) + '\\n', 'utf-8')\n  return path\n}\n\n/**\n * Read + parse a manifest from disk. Returns `null` on missing or\n * malformed file rather than throwing — the runtime resolver wants\n * to fall through to dev-mode lookup in that case.\n */\nexport function readAssetManifest(distDir: string): AssetManifest | null {\n  const path = join(distDir, '.kickjs-assets.json')\n  if (!existsSync(path)) return null\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const fs = require('node:fs') as typeof import('node:fs')\n    const raw = fs.readFileSync(path, 'utf-8')\n    const parsed = JSON.parse(raw) as Partial<AssetManifest>\n    if (parsed.version !== ASSET_MANIFEST_VERSION) return null\n    if (!parsed.entries || typeof parsed.entries !== 'object') return null\n    return parsed as AssetManifest\n  } catch {\n    return null\n  }\n}\n\n/**\n * Project-root escape check that's safe across symlinks + drive letters.\n * `path.relative` returns `..` segments when the target sits above root,\n * and an absolute path when the two live on different roots (Windows).\n * `startsWith(root)` would miss both cases.\n */\nfunction escapesRoot(path: string, root: string): boolean {\n  const rel = relative(root, path)\n  if (rel === '') return false\n  return rel.startsWith('..') || isAbsolute(rel)\n}\n\n/** Pure helper — `false` for missing, non-dir, or unreadable paths. */\nfunction isDirectorySync(path: string): boolean {\n  try {\n    return statSync(path).isDirectory()\n  } catch {\n    return false\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"build-BQiF63pu.mjs","names":["__exportAll","build_exports","buildAssets","opts","distDir","config","map","log","silent","distAbs","resolve","cwd","mkdirSync","summary","manifestEntries","namespace","entry","result","processEntry","manifest","manifestPath","join","writeFileSync","relative","srcAbs","destAbs","escapesRoot","existsSync","isDirectorySync","pattern","matches","glob","manifestSlice","sorted","groupAssetKeys","filesCopied","relPath","pairs","srcFile","destFile","key","toManifestRelative","dirname","cpSync","collisionGroupsResolved","isUpToDate","s","statSync","d","manifestDir","rel","root","path","isAbsolute"],"sources":["../src/asset-manager/build.ts"],"sourcesContent":["/**\n * Build pipeline for `assetMap` entries (asset-manager PR 2).\n *\n * For each entry, walks `src/<...>` matching the configured `glob`,\n * copies matches into `dest` (default `dist/<name>/`), then emits a\n * `dist/.kickjs-assets.json` manifest mapping logical\n * `<namespace>/<key>` keys to repo-relative paths inside `dist/`.\n *\n * Pure function on top of `node:fs` + `glob` — no shell, no side\n * effects beyond the configured directory writes. The build entry-\n * point in `commands/run.ts` calls `buildAssets` after the existing\n * `copyDirs` step.\n *\n * @module @forinda/kickjs-cli/asset-manager/build\n */\n\nimport { cpSync, existsSync, mkdirSync, statSync, writeFileSync } from 'node:fs'\nimport { dirname, isAbsolute, join, relative, resolve } from 'node:path'\nimport { glob } from 'glob'\nimport { groupAssetKeys } from '@forinda/kickjs'\nimport type { AssetMapEntry, KickConfig } from '../config'\n\n/** Wire-format version for `dist/.kickjs-assets.json`. Bump on shape change. */\nexport const ASSET_MANIFEST_VERSION = 1 as const\n\n/** On-disk manifest format (`dist/.kickjs-assets.json`). */\nexport interface AssetManifest {\n  version: typeof ASSET_MANIFEST_VERSION\n  /**\n   * Logical key → manifest-relative path. Logical key is\n   * `<namespace>/<key>` where `<key>` is the file path under `src`\n   * with the extension stripped + path separators normalised.\n   *\n   * Path values are relative to the manifest file's directory so the\n   * runtime can resolve them with a single `path.resolve(manifestDir,\n   * entry)` regardless of where dist/ lives.\n   */\n  entries: Record<string, string>\n}\n\nexport interface BuildAssetsOptions {\n  /** Project root — resolved for every relative path in the entry. */\n  cwd: string\n  /**\n   * Output dir for the manifest + per-namespace asset copies. When\n   * omitted, falls back to `config.build?.outDir` (resolved against\n   * `cwd`), then to `dist/` under cwd. Adopters with a custom Vite\n   * `build.outDir` should set `kick.config.ts.build.outDir` to match.\n   */\n  distDir?: string\n  /** Suppress per-entry log lines. Default: false. */\n  silent?: boolean\n}\n\n/** One entry in the per-build summary returned by `buildAssets`. */\nexport interface BuildAssetsEntryResult {\n  namespace: string\n  src: string\n  dest: string\n  /**\n   * Number of files actually written this run. On an incremental\n   * rebuild where nothing changed this is 0 even though the manifest\n   * still lists every matched file.\n   */\n  filesCopied: number\n}\n\n/** Aggregated outcome of `buildAssets`. */\nexport interface BuildAssetsResult {\n  manifestPath: string\n  entries: BuildAssetsEntryResult[]\n  /** `entries` merged into a single record — useful for tests + tooling. */\n  manifest: AssetManifest\n}\n\n/**\n * Run the full asset build for a loaded config:\n *\n * 1. For each `assetMap` entry, glob → copy → manifest stub.\n * 2. Write `dist/.kickjs-assets.json`.\n *\n * Returns a summary including the manifest contents. No-op (and no\n * manifest written) when `assetMap` is empty / missing — the build\n * pipeline shouldn't litter `dist/` with empty manifests for\n * adopters who don't use the feature.\n */\nexport async function buildAssets(\n  config: KickConfig | null,\n  opts: BuildAssetsOptions,\n): Promise<BuildAssetsResult | null> {\n  const { cwd, silent = false } = opts\n  // Resolution order: explicit opts.distDir → config.build.outDir → 'dist'.\n  // The CLI build command passes nothing explicit, so adopters control\n  // the output via kick.config.ts.build.outDir alone.\n  const distDir = opts.distDir ?? config?.build?.outDir ?? 'dist'\n  const map = config?.assetMap\n  if (!map || Object.keys(map).length === 0) return null\n\n  const log = silent ? () => {} : console.log\n\n  const distAbs = resolve(cwd, distDir)\n  mkdirSync(distAbs, { recursive: true })\n\n  const summary: BuildAssetsEntryResult[] = []\n  const manifestEntries: Record<string, string> = {}\n\n  for (const [namespace, entry] of Object.entries(map)) {\n    const result = await processEntry(namespace, entry, cwd, distAbs)\n    summary.push(result.entrySummary)\n    Object.assign(manifestEntries, result.manifestSlice)\n    log(\n      `    ✓ ${namespace}: ${result.entrySummary.filesCopied} file(s) → ${result.entrySummary.dest}`,\n    )\n  }\n\n  const manifest: AssetManifest = {\n    version: ASSET_MANIFEST_VERSION,\n    entries: manifestEntries,\n  }\n  const manifestPath = join(distAbs, '.kickjs-assets.json')\n  writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\\n', 'utf-8')\n  log(\n    `    ✓ wrote manifest → ${relative(cwd, manifestPath)} (${Object.keys(manifestEntries).length} entries)`,\n  )\n\n  return { manifestPath, entries: summary, manifest }\n}\n\n/** Per-entry inner pipeline — extracted for unit-test reuse. */\nasync function processEntry(\n  namespace: string,\n  entry: AssetMapEntry,\n  cwd: string,\n  distAbs: string,\n): Promise<{\n  entrySummary: BuildAssetsEntryResult\n  manifestSlice: Record<string, string>\n}> {\n  const srcAbs = resolve(cwd, entry.src)\n  const destAbs = entry.dest ? resolve(cwd, entry.dest) : join(distAbs, namespace)\n\n  // Defensive: refuse to write outside the project root (cwd) even\n  // though validateAssetMap warned about it at config-load time. The\n  // build step shouldn't trust upstream warnings — a typo like\n  // `dest: '../../'` would otherwise sprinkle files outside the\n  // workspace despite the warning being printed.\n  if (escapesRoot(destAbs, cwd)) {\n    console.warn(\n      `  ⚠ assetMap.${namespace}.dest ('${entry.dest}') resolves outside the project root — skipping copy`,\n    )\n    return {\n      entrySummary: { namespace, src: entry.src, dest: relative(cwd, destAbs), filesCopied: 0 },\n      manifestSlice: {},\n    }\n  }\n\n  // Treat src-not-a-directory the same as src-missing — `glob` would\n  // throw if pointed at a file, surfacing as a generic build failure\n  // instead of a clean 0-files entry. Matches the validator's warning\n  // shape (already emitted at config-load time for the missing case).\n  if (!existsSync(srcAbs) || !isDirectorySync(srcAbs)) {\n    return {\n      entrySummary: { namespace, src: entry.src, dest: relative(cwd, destAbs), filesCopied: 0 },\n      manifestSlice: {},\n    }\n  }\n\n  const pattern = entry.glob ?? '**/*'\n  // `glob` returns paths relative to `cwd` when `cwd` is set —\n  // exactly the slugs we want for the manifest keys.\n  const matches = await glob(pattern, {\n    cwd: srcAbs,\n    nodir: true,\n    dot: false,\n    posix: true,\n  })\n\n  mkdirSync(destAbs, { recursive: true })\n\n  const manifestSlice: Record<string, string> = {}\n  // Sort the walk so the manifest is byte-stable across platforms.\n  // The `groupAssetKeys` helper preserves input order, so a stable\n  // sort here makes the resulting manifest stable too.\n  const sorted = [...matches].toSorted()\n  const { pairs, collisionGroupsResolved } = groupAssetKeys(namespace, sorted, {\n    strategy: entry.keys ?? 'auto',\n  })\n\n  // Copy the files and write the keyed manifest slice. Both come from\n  // the same `pairs` order so the on-disk layout matches the\n  // manifest's iteration order — easier to grep in cold-start\n  // debugging.\n  //\n  // Incremental: skip the copy when the destination is already\n  // up-to-date (exists, same size, mtime ≥ source). `cpSync` stamps the\n  // copy with the current time, so an unchanged source always satisfies\n  // `dest.mtime ≥ src.mtime` on the next run — turning a re-build into a\n  // pure stat sweep instead of re-copying every asset. The manifest\n  // slice is written unconditionally so the manifest stays complete.\n  let filesCopied = 0\n  for (const { rel: relPath, key } of pairs) {\n    const srcFile = join(srcAbs, relPath)\n    const destFile = join(destAbs, relPath)\n    manifestSlice[key] = toManifestRelative(distAbs, destFile)\n    if (isUpToDate(srcFile, destFile)) continue\n    mkdirSync(dirname(destFile), { recursive: true })\n    cpSync(srcFile, destFile)\n    filesCopied++\n  }\n\n  if (collisionGroupsResolved > 0) {\n    console.log(\n      `  ℹ assetMap.${namespace}: auto-resolved ${collisionGroupsResolved} basename collision(s) by keeping extensions ` +\n        `(set 'keys: \"strip\"' to opt back into legacy last-write-wins behaviour, or 'keys: \"with-extension\"' to keep all keys verbose).`,\n    )\n  }\n\n  return {\n    entrySummary: {\n      namespace,\n      src: entry.src,\n      dest: relative(cwd, destAbs),\n      filesCopied,\n    },\n    manifestSlice,\n  }\n}\n\n/**\n * Is `destFile` already a current copy of `srcFile`? True when the\n * destination exists with the same byte size and an mtime no older than\n * the source. Used to skip redundant copies on an incremental rebuild.\n */\nfunction isUpToDate(srcFile: string, destFile: string): boolean {\n  if (!existsSync(destFile)) return false\n  try {\n    const s = statSync(srcFile)\n    const d = statSync(destFile)\n    return d.size === s.size && d.mtimeMs >= s.mtimeMs\n  } catch {\n    return false\n  }\n}\n\n/**\n * Make `destFile` relative to the manifest's directory + force POSIX\n * separators so the manifest is byte-stable across platforms.\n */\nfunction toManifestRelative(manifestDir: string, destFile: string): string {\n  const rel = relative(manifestDir, destFile)\n  // path.relative returns OS-native separators; the manifest is JSON\n  // and the runtime uses path.resolve which handles either, but a\n  // forward-slash manifest is grep-friendly + diff-stable.\n  return rel.split(/[\\\\/]/).filter(Boolean).join('/')\n}\n\n/**\n * Pure manifest writer — handy for tests that want to assert against\n * a hand-crafted manifest without exercising the full pipeline.\n */\nexport function writeAssetManifest(distDir: string, manifest: AssetManifest): string {\n  const path = join(distDir, '.kickjs-assets.json')\n  mkdirSync(distDir, { recursive: true })\n  writeFileSync(path, JSON.stringify(manifest, null, 2) + '\\n', 'utf-8')\n  return path\n}\n\n/**\n * Read + parse a manifest from disk. Returns `null` on missing or\n * malformed file rather than throwing — the runtime resolver wants\n * to fall through to dev-mode lookup in that case.\n */\nexport function readAssetManifest(distDir: string): AssetManifest | null {\n  const path = join(distDir, '.kickjs-assets.json')\n  if (!existsSync(path)) return null\n  try {\n    // eslint-disable-next-line @typescript-eslint/no-require-imports\n    const fs = require('node:fs') as typeof import('node:fs')\n    const raw = fs.readFileSync(path, 'utf-8')\n    const parsed = JSON.parse(raw) as Partial<AssetManifest>\n    if (parsed.version !== ASSET_MANIFEST_VERSION) return null\n    if (!parsed.entries || typeof parsed.entries !== 'object') return null\n    return parsed as AssetManifest\n  } catch {\n    return null\n  }\n}\n\n/**\n * Project-root escape check that's safe across symlinks + drive letters.\n * `path.relative` returns `..` segments when the target sits above root,\n * and an absolute path when the two live on different roots (Windows).\n * `startsWith(root)` would miss both cases.\n */\nfunction escapesRoot(path: string, root: string): boolean {\n  const rel = relative(root, path)\n  if (rel === '') return false\n  return rel.startsWith('..') || isAbsolute(rel)\n}\n\n/** Pure helper — `false` for missing, non-dir, or unreadable paths. */\nfunction isDirectorySync(path: string): boolean {\n  try {\n    return statSync(path).isDirectory()\n  } catch {\n    return false\n  }\n}\n"],"mappings":"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"}

package/dist/{build-xfLqm9dd.mjs → build-BUFgk6Ss.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.11.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,5 +8,5 @@
  *
  * @license MIT
  */
-import{t as e}from"./rolldown-runtime-D8pytGn4.mjs";import{cpSync as t,existsSync as n,mkdirSync as r,statSync as i,writeFileSync as a}from"node:fs";import{dirname as o,isAbsolute as s,join as c,relative as l,resolve as u}from"node:path";import{glob as d}from"glob";import{groupAssetKeys as f}from"@forinda/kickjs";var p=/* @__PURE__ */ e({ASSET_MANIFEST_VERSION:()=>1,buildAssets:()=>m});async function m(e,t){let{cwd:n,silent:i=!1}=t,o=t.distDir??e?.build?.outDir??`dist`,s=e?.assetMap;if(!s||Object.keys(s).length===0)return null;let d=i?()=>{}:console.log,f=u(n,o);r(f,{recursive:!0});let p=[],m={};for(let[e,t]of Object.entries(s)){let r=await h(e,t,n,f);p.push(r.entrySummary),Object.assign(m,r.manifestSlice),d(`    ✓ ${e}: ${r.entrySummary.filesCopied} file(s) → ${r.entrySummary.dest}`)}let g={version:1,entries:m},_=c(f,`.kickjs-assets.json`);return a(_,JSON.stringify(g,null,2)+`
+import{t as e}from"./rolldown-runtime-DAPeToCs.mjs";import{cpSync as t,existsSync as n,mkdirSync as r,statSync as i,writeFileSync as a}from"node:fs";import{dirname as o,isAbsolute as s,join as c,relative as l,resolve as u}from"node:path";import{glob as d}from"glob";import{groupAssetKeys as f}from"@forinda/kickjs";var p=/* @__PURE__ */ e({ASSET_MANIFEST_VERSION:()=>1,buildAssets:()=>m});async function m(e,t){let{cwd:n,silent:i=!1}=t,o=t.distDir??e?.build?.outDir??`dist`,s=e?.assetMap;if(!s||Object.keys(s).length===0)return null;let d=i?()=>{}:console.log,f=u(n,o);r(f,{recursive:!0});let p=[],m={};for(let[e,t]of Object.entries(s)){let r=await h(e,t,n,f);p.push(r.entrySummary),Object.assign(m,r.manifestSlice),d(`    ✓ ${e}: ${r.entrySummary.filesCopied} file(s) → ${r.entrySummary.dest}`)}let g={version:1,entries:m},_=c(f,`.kickjs-assets.json`);return a(_,JSON.stringify(g,null,2)+`
 `,`utf-8`),d(`    ✓ wrote manifest → ${l(n,_)} (${Object.keys(m).length} entries)`),{manifestPath:_,entries:p,manifest:g}}async function h(e,i,a,s){let p=u(a,i.src),m=i.dest?u(a,i.dest):c(s,e);if(v(m,a))return console.warn(`  ⚠ assetMap.${e}.dest ('${i.dest}') resolves outside the project root — skipping copy`),{entrySummary:{namespace:e,src:i.src,dest:l(a,m),filesCopied:0},manifestSlice:{}};if(!n(p)||!y(p))return{entrySummary:{namespace:e,src:i.src,dest:l(a,m),filesCopied:0},manifestSlice:{}};let h=i.glob??`**/*`,b=await d(h,{cwd:p,nodir:!0,dot:!1,posix:!0});r(m,{recursive:!0});let x={},S=[...b].toSorted(),{pairs:C,collisionGroupsResolved:w}=f(e,S,{strategy:i.keys??`auto`}),T=0;for(let{rel:e,key:n}of C){let i=c(p,e),a=c(m,e);x[n]=_(s,a),!g(i,a)&&(r(o(a),{recursive:!0}),t(i,a),T++)}return w>0&&console.log(`  ℹ assetMap.${e}: auto-resolved ${w} 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:i.src,dest:l(a,m),filesCopied:T},manifestSlice:x}}function g(e,t){if(!n(t))return!1;try{let n=i(e),r=i(t);return r.size===n.size&&r.mtimeMs>=n.mtimeMs}catch{return!1}}function _(e,t){return l(e,t).split(/[\\/]/).filter(Boolean).join(`/`)}function v(e,t){let n=l(t,e);return n===``?!1:n.startsWith(`..`)||s(n)}function y(e){try{return i(e).isDirectory()}catch{return!1}}export{p as n,m as t};

package/dist/{builtins-C3BQ79nW.mjs → builtins-CaOnJmm8.mjs}

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v8.10.1
+ * @forinda/kickjs-cli v8.11.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -8,4 +8,4 @@
  *
  * @license MIT
  */
-export{t as builtinCliPlugins}from"./run-plugins-CeZS2Opt.mjs";
+export{t as builtinCliPlugins}from"./run-plugins-Du6FlB7_.mjs";