@forinda/kickjs-cli 8.5.0 → 8.6.1

package/templates/feature-queue/files/_dot_env.append

@@ -0,0 +1,2 @@
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379

package/templates/feature-queue/files/_dot_env.example.append

@@ -0,0 +1,2 @@
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379

package/templates/feature-swagger/feature.json

@@ -0,0 +1,16 @@
+{
+  "dependencies": ["@forinda/kickjs-swagger"],
+  "builds": {
+    "@scarf/scarf": true
+  },
+  "integrations": [
+    {
+      "import": {
+        "from": "@forinda/kickjs-swagger",
+        "names": ["SwaggerAdapter"]
+      },
+      "slot": "adapter",
+      "code": "SwaggerAdapter({ info: { title: '{{name}}', version: '{{version}}' } })"
+    }
+  ]
+}

package/templates/feature-ws/feature.json

@@ -0,0 +1,13 @@
+{
+  "dependencies": ["@forinda/kickjs-ws", "ws"],
+  "integrations": [
+    {
+      "import": {
+        "from": "@forinda/kickjs-ws",
+        "names": ["WsAdapter"]
+      },
+      "slot": "adapter",
+      "code": "// WebSocket upgrades on /ws \u2014 see guide/websockets.\nWsAdapter({ path: '/ws' })"
+    }
+  ]
+}

package/templates/fullstack-root/files/_dot_gitignore

@@ -0,0 +1,8 @@
+node_modules/
+dist/
+.env
+*.log
+.DS_Store
+# Platform build output — written by `kick build:netlify` / `kick build:vercel`.
+.netlify/
+.vercel/

package/templates/fullstack-root/files/netlify.toml

@@ -0,0 +1,13 @@
+[build]
+command = "{{packageManager}} run build:netlify"
+publish = "web/dist"
+
+[build.environment]
+NODE_VERSION = "22"
+
+# Client-side routes fall back to the app shell. The function claims /api/*
+# through its own `config.path`, so this rule never sees those requests.
+[[redirects]]
+from = "/*"
+to = "/index.html"
+status = 200

package/templates/fullstack-root/files/vercel.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "framework": null,
+  "buildCommand": "{{packageManager}} run build:vercel"
+}

package/templates/host-config/files/netlify.toml

@@ -0,0 +1,6 @@
+[build]
+command = "{{packageManager}} run build:netlify"
+publish = "dist/public"
+
+[build.environment]
+NODE_VERSION = "22"

package/templates/host-config/files/vercel.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "framework": null,
+  "buildCommand": "{{packageManager}} run build:vercel"
+}

package/templates/runtime-express/feature.json

@@ -0,0 +1,22 @@
+{
+  "dependencies": ["express"],
+  "devDependencies": ["@types/express"],
+  "integrations": [
+    {
+      "import": {
+        "from": "@forinda/kickjs",
+        "names": ["expressRuntime"]
+      },
+      "slot": "runtime",
+      "code": "runtime: expressRuntime()"
+    },
+    {
+      "import": {
+        "from": "express",
+        "default": "express"
+      },
+      "slot": "middleware",
+      "code": "// Express needs a body parser; Fastify and h3 parse bodies natively.\nexpress.json()"
+    }
+  ]
+}

package/templates/runtime-fastify/feature.json

@@ -0,0 +1,13 @@
+{
+  "dependencies": ["fastify", "@fastify/middie", "serve-static"],
+  "integrations": [
+    {
+      "import": {
+        "from": "@forinda/kickjs/fastify",
+        "names": ["fastifyRuntime"]
+      },
+      "slot": "runtime",
+      "code": "runtime: fastifyRuntime()"
+    }
+  ]
+}

package/templates/runtime-h3/feature.json

@@ -0,0 +1,13 @@
+{
+  "dependencies": ["h3", "serve-static"],
+  "integrations": [
+    {
+      "import": {
+        "from": "@forinda/kickjs/h3",
+        "names": ["h3Runtime"]
+      },
+      "slot": "runtime",
+      "code": "runtime: h3Runtime()"
+    }
+  ]
+}

package/templates/schema-valibot/feature.json

@@ -0,0 +1,3 @@
+{
+  "dependencies": ["valibot"]
+}

package/templates/schema-valibot/files/src/config/index.ts

@@ -0,0 +1,41 @@
+import { loadEnvFromSchema } from '@forinda/kickjs/config'
+import { fromValibot } from '@forinda/kickjs-schema/valibot'
+import * as v from 'valibot'
+
+/**
+ * Project environment schema (Valibot).
+ *
+ * `fromValibot` wraps the Valibot schema as a `KickSchema` so the
+ * env loader, validate middleware, and swagger spec generator all see
+ * the same shape. The default export is the contract `kick typegen`
+ * reads to populate `KickEnv` via `InferSchemaOutput<typeof _envSchema>`
+ * — that's what makes `@Value('FOO')` autocomplete and
+ * `process.env.FOO` typed.
+ *
+ * @example
+ *   DATABASE_URL: v.pipe(v.string(), v.url()),
+ *   JWT_SECRET:   v.pipe(v.string(), v.minLength(32)),
+ *   REDIS_URL:    v.optional(v.pipe(v.string(), v.url())),
+ */
+const envSchema = fromValibot(
+  v.object({
+    PORT: v.optional(v.pipe(v.string(), v.transform(Number)), '3000'),
+    NODE_ENV: v.optional(v.picklist(['development', 'production', 'test']), 'development'),
+    LOG_LEVEL: v.optional(v.string(), 'info'),
+    // DATABASE_URL: v.pipe(v.string(), v.url()),
+  }),
+)
+
+/**
+ * IMPORTANT — side effect: register the schema with kickjs's env cache
+ * **at module-load time**. `ConfigService` and `@Value()` both consume
+ * this cache, and they will fall back to the base schema (or undefined)
+ * if no extended schema has been registered before they're resolved.
+ *
+ * As long as `src/index.ts` imports this file (`import './config'`) at
+ * the top — before `bootstrap()` runs — every controller and service
+ * in the app sees the typed extended values.
+ */
+export const env = loadEnvFromSchema(envSchema)
+
+export default envSchema

package/templates/schema-yup/feature.json

@@ -0,0 +1,3 @@
+{
+  "dependencies": ["yup"]
+}

package/templates/schema-yup/files/src/config/index.ts

@@ -0,0 +1,43 @@
+import { loadEnvFromSchema } from '@forinda/kickjs/config'
+import { fromYup } from '@forinda/kickjs-schema/yup'
+import * as yup from 'yup'
+
+/**
+ * Project environment schema (Yup).
+ *
+ * `fromYup` wraps the Yup schema as a `KickSchema` so the env loader,
+ * validate middleware, and swagger spec generator all see the same
+ * shape. The default export is the contract `kick typegen` reads to
+ * populate `KickEnv` via `InferSchemaOutput<typeof _envSchema>`.
+ *
+ * Note: Yup's `.url()` defaults to http/https; database connection
+ * strings like `postgres://` use `.matches(/^[a-z]+:\/\/.+/i)` or
+ * a plain `.string().required()`.
+ *
+ * @example
+ *   DATABASE_URL: yup.string().required(),
+ *   JWT_SECRET:   yup.string().min(32).required(),
+ *   REDIS_URL:    yup.string().url().optional(),
+ */
+const envSchema = fromYup(
+  yup.object({
+    PORT: yup.number().default(3000),
+    NODE_ENV: yup.string().oneOf(['development', 'production', 'test']).default('development'),
+    LOG_LEVEL: yup.string().default('info'),
+    // DATABASE_URL: yup.string().required(),
+  }),
+)
+
+/**
+ * IMPORTANT — side effect: register the schema with kickjs's env cache
+ * **at module-load time**. `ConfigService` and `@Value()` both consume
+ * this cache, and they will fall back to the base schema (or undefined)
+ * if no extended schema has been registered before they're resolved.
+ *
+ * As long as `src/index.ts` imports this file (`import './config'`) at
+ * the top — before `bootstrap()` runs — every controller and service
+ * in the app sees the typed extended values.
+ */
+export const env = loadEnvFromSchema(envSchema)
+
+export default envSchema

package/templates/schema-zod/feature.json

@@ -0,0 +1,3 @@
+{
+  "dependencies": ["zod"]
+}

package/templates/schema-zod/files/src/config/index.ts

@@ -0,0 +1,41 @@
+import { loadEnvFromSchema } from '@forinda/kickjs/config'
+import { fromZod } from '@forinda/kickjs-schema/zod'
+import { z } from 'zod'
+
+/**
+ * Project environment schema (Zod).
+ *
+ * `fromZod` wraps the Zod schema as a `KickSchema` so the env loader,
+ * validate middleware, and swagger spec generator all see the same
+ * shape. The default export is the contract `kick typegen` reads to
+ * populate `KickEnv` via `InferSchemaOutput<typeof _envSchema>` —
+ * that's what makes `@Value('FOO')` autocomplete and
+ * `process.env.FOO` typed.
+ *
+ * @example
+ *   DATABASE_URL: z.string().url(),
+ *   JWT_SECRET: z.string().min(32),
+ *   REDIS_URL: z.string().url().optional(),
+ */
+const envSchema = fromZod(
+  z.object({
+    PORT: z.coerce.number().default(3000),
+    NODE_ENV: z.enum(['development', 'production', 'test']).default('development'),
+    LOG_LEVEL: z.string().default('info'),
+    // DATABASE_URL: z.string().url(),
+  }),
+)
+
+/**
+ * IMPORTANT — side effect: register the schema with kickjs's env cache
+ * **at module-load time**. `ConfigService` and `@Value()` both consume
+ * this cache, and they will fall back to the base schema (or undefined)
+ * if no extended schema has been registered before they're resolved.
+ *
+ * As long as `src/index.ts` imports this file (`import './config'`) at
+ * the top — before `bootstrap()` runs — every controller and service
+ * in the app sees the typed extended values.
+ */
+export const env = loadEnvFromSchema(envSchema)
+
+export default envSchema

package/templates/server-fullstack/feature.json

@@ -0,0 +1,13 @@
+{
+  "devDependencies": ["@typescript/typescript6"],
+  "integrations": [
+    {
+      "slot": "vite-option",
+      "code": "server: {\n  // web/vite.config.ts proxies /api to this port \u2014 fail instead of moving\n  // to another port when it's taken, or the proxy would reach the wrong process.\n  strictPort: true,\n}"
+    },
+    {
+      "slot": "typegen-option",
+      "code": "// web/ reads this map from the ambient KickClientApi namespace. Producing\n// it builds a TypeScript program over the server, so it stays off unless a\n// project actually consumes it.\nclient: true"
+    }
+  ]
+}

package/templates/template-minimal/feature.json

@@ -0,0 +1,10 @@
+{
+  "integrations": [
+    {
+      "import": {
+        "from": "@forinda/kickjs",
+        "names": ["bootstrap"]
+      }
+    }
+  ]
+}

package/templates/template-minimal/files/src/index.ts

@@ -0,0 +1,17 @@
+import 'reflect-metadata'
+// Side-effect import — registers the extended env schema with kickjs
+// **before** any controller / service / @Value gets resolved. Without
+// this line ConfigService.get('YOUR_KEY') returns undefined because the
+// cached schema would still be the base shape. See guide/configuration.
+import './config'
+// @kick:imports
+import { modules } from './modules'
+
+// Export the app for the Vite plugin (dev mode)
+export const app = await bootstrap({
+  modules,
+  // @kick:runtime
+  adapters: [
+    // @kick:adapter
+  ],
+})

package/templates/template-rest/feature.json

@@ -0,0 +1,10 @@
+{
+  "integrations": [
+    {
+      "import": {
+        "from": "@forinda/kickjs",
+        "names": ["bootstrap", "requestId", "requestLogger", "helmet", "cors"]
+      }
+    }
+  ]
+}

package/templates/template-rest/files/src/index.ts

@@ -0,0 +1,28 @@
+import 'reflect-metadata'
+// Side-effect import — registers the extended env schema with kickjs
+// **before** any controller / service / @Value gets resolved. Without
+// this line ConfigService.get('YOUR_KEY') returns undefined because the
+// cached schema would still be the base shape. See guide/configuration.
+import './config'
+// @kick:imports
+import { modules } from './modules'
+
+// Export the app for the Vite plugin (dev mode)
+export const app = await bootstrap({
+  modules,
+  // @kick:runtime
+  adapters: [
+    // @kick:adapter
+  ],
+  middlewares: [
+    // Security headers. The framework injects helmet() with these defaults
+    // anyway — declaring it here is what lets you CHANGE them, e.g.
+    // helmet({ frameguard: 'SAMEORIGIN' }) or helmet({ hsts: false }).
+    // Auto-injection stands down as soon as this line is present.
+    helmet(),
+    cors({ origin: '*' }),
+    requestId(),
+    requestLogger(),
+    // @kick:middleware
+  ],
+})

package/templates/web-kick/files/web/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{name}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/web-kick/files/web/src/App.tsx

@@ -0,0 +1,45 @@
+import { useEffect, useState } from 'react'
+import { api } from './api'
+
+// The response types below are INFERRED from the server's handlers —
+// change server/src/modules/hello/hello.service.ts and these types follow on
+// the next `kick typegen`. Not under `kick dev`: resolving the client map
+// builds a whole TypeScript program, so it is a build step, not a per-save one.
+type Greeting = Awaited<ReturnType<typeof fetchGreeting>>
+
+function fetchGreeting() {
+  return api.get('/hello')
+}
+
+export function App() {
+  const [greeting, setGreeting] = useState<Greeting | null>(null)
+  const [health, setHealth] = useState<string>('checking…')
+
+  useEffect(() => {
+    fetchGreeting().then(setGreeting).catch(console.error)
+    api
+      .get('/hello/health')
+      .then((h) => setHealth(h.status))
+      .catch(() => setHealth('down'))
+  }, [])
+
+  return (
+    <main
+      style={{ fontFamily: 'system-ui', maxWidth: 640, margin: '4rem auto', padding: '0 1rem' }}
+    >
+      <h1>KickJS fullstack</h1>
+      <p>
+        <strong>{greeting?.message ?? 'loading…'}</strong>
+      </p>
+      <p>
+        Server said hello at <code>{greeting?.timestamp ?? '…'}</code> — health:{' '}
+        <code>{health}</code>
+      </p>
+      <p style={{ color: '#666' }}>
+        This call is typed end to end: <code>api.get('/hello')</code> returns the exact shape
+        <code> HelloService.greet()</code> produces. Rename a field on the server and this file
+        stops compiling.
+      </p>
+    </main>
+  )
+}

package/templates/web-kick/files/web/src/api.ts

@@ -0,0 +1,14 @@
+import { createClient } from '@forinda/kickjs-client'
+
+// KickClientApi is ambient — the resolved route map from
+// server/.kickjs/types/kick__client.d.ts, wired in tsconfig's `types`. Every
+// response type is a literal shape, so nothing from the server's source graph
+// enters this program.
+//
+// Keys are module-mount-relative paths; the bootstrap-level '/api/v1' prefix
+// lives here in baseUrl, and the Vite dev proxy forwards it to the KickJS
+// server.
+//
+// Prefer an explicit import? The same file exports the type:
+//   import type { Api } from '../../server/.kickjs/types/kick__client'
+export const api = createClient<KickClientApi.Api>({ baseUrl: '/api/v1' })

package/templates/web-kick/files/web/src/main.tsx

@@ -0,0 +1,9 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { App } from './App'
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+)

package/templates/web-kick/files/web/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "isolatedModules": true,
+    "types": ["../server/.kickjs/types/kick__client"]
+  },
+  "include": ["src"]
+}

package/templates/web-kick/files/web/vite.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    // The KickJS server (kick dev) listens on 3000; the client's baseUrl is
+    // the relative '/api/v1', so the browser hits Vite and Vite forwards.
+    proxy: {
+      '/api': 'http://localhost:3000',
+    },
+  },
+})

package/dist/agent-docs-CXX06wib.mjs

@@ -1,11 +0,0 @@
-/**
- * @forinda/kickjs-cli v8.5.0
- *
- * Copyright (c) Felix Orinda
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- * @license MIT
- */
-import{t as e}from"./rolldown-runtime-DzFISCwE.mjs";import{a as t}from"./config-F1NW28_P.mjs";import{a as n,i as r,l as i,n as a,r as o,t as s}from"./project-docs-BE8DKCWP.mjs";import{existsSync as c,readFileSync as l}from"node:fs";import{join as u}from"node:path";import*as d from"@clack/prompts";import f from"picocolors";const p={GET:f.green,POST:f.cyan,PUT:f.yellow,PATCH:f.magenta,DELETE:f.red};function m(e){return(p[e]??f.dim)(e.padEnd(7))}function h(e){let t=`[${e}]`.padEnd(10);switch(e){case`CRITICAL`:return f.red(t);case`WARNING`:return f.yellow(t);case`INFO`:return f.blue(f.dim(t));default:return t}}f.green(`✓`),f.red(`✖`),f.yellow(`⚠`),f.blue(`ℹ`);function g(e){d.intro(f.bgCyan(f.black(` ${e} `)))}function _(e){d.outro(e)}function v(e){d.isCancel(e)&&(d.cancel(`Operation cancelled.`),process.exit(0))}async function y(e){let t=await d.text(e);return v(t),t}async function b(e){let t=await d.select(e);return v(t),t}async function x(e){let t=await d.multiselect(e);return v(t),t}async function S(e){let t=await d.confirm(e);return v(t),t}function C(){return d.spinner()}const w=d.log;var T=e({generateAgentDocs:()=>M});const E=`.agents`,D=new Set([`rest`,`minimal`,`fullstack`]);function O(e,t){if(t)return t;try{let t=JSON.parse(l(u(e,`package.json`),`utf-8`));if(t.name)return t.name.replace(/^@[^/]+\//,``)}catch{}return e.split(`/`).findLast(Boolean)??`app`}function k(e,t){if(t)return t;try{let t=JSON.parse(l(u(e,`package.json`),`utf-8`));if(t.packageManager)return t.packageManager.split(`@`)[0]}catch{}return`pnpm`}async function A(e){try{return(await t(e))?.modules?.style===`class`?`class`:`define`}catch{return`define`}}async function j(e,n){if(n)return n;try{let n=(await t(e))?.pattern;if(n&&D.has(n))return n}catch{}return`rest`}async function M(e){let t=e.only??`all`,l=O(e.outDir,e.name),d=k(e.outDir,e.pm),f=await j(e.outDir,e.template),p=await A(e.outDir),m=t===`agents`||t===`both`||t===`all`,h=t===`claude`||t===`both`||t===`all`,g=t===`skills`||t===`all`,_=t===`gemini`||t===`all`,v=t===`copilot`||t===`all`,y=[];if(m&&y.push({file:u(e.outDir,E,`AGENTS.md`),render:()=>s(l,f,d)}),h&&y.push({file:u(e.outDir,`CLAUDE.md`),render:()=>a(l,f,d)}),g)for(let t of n(l,f,d,p))y.push({file:u(e.outDir,E,`skills`,t.slug,`SKILL.md`),render:()=>t.content});_&&y.push({file:u(e.outDir,E,`GEMINI.md`),render:()=>r(l,f,d)}),v&&y.push({file:u(e.outDir,E,`COPILOT.md`),render:()=>o(l,f,d)});let b=[];for(let{file:t,render:n}of y){if(c(t)&&!e.force&&!await S({message:`${t.replace(e.outDir+`/`,``)} already exists. Overwrite?`,initialValue:!1})){console.log(`  Skipped — existing ${t.replace(e.outDir+`/`,``)} preserved.`);continue}await i(t,n()),b.push(t)}return b}export{w as a,b as c,m as d,f,g as i,C as l,M as n,x as o,h as p,S as r,_ as s,T as t,y as u};

package/dist/agent-docs-CXs5UDAM.mjs

@@ -1,12 +0,0 @@
-/**
- * @forinda/kickjs-cli v8.5.0
- *
- * Copyright (c) Felix Orinda
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- * @license MIT
- */
-import{t as e}from"./rolldown-runtime-DzFISCwE.mjs";import{a as t,i as n,l as r,n as i,r as a,t as o}from"./project-docs-Y6vOc-Uj.mjs";import{t as s}from"./prompts-wFEGsPZt.mjs";import{o as c}from"./config-BUYf44lU.mjs";import{join as l}from"node:path";import{existsSync as u,readFileSync as d}from"node:fs";var f=e({generateAgentDocs:()=>y});const p=`.agents`,m=new Set([`rest`,`minimal`,`fullstack`]);function h(e,t){if(t)return t;try{let t=JSON.parse(d(l(e,`package.json`),`utf-8`));if(t.name)return t.name.replace(/^@[^/]+\//,``)}catch{}return e.split(`/`).findLast(Boolean)??`app`}function g(e,t){if(t)return t;try{let t=JSON.parse(d(l(e,`package.json`),`utf-8`));if(t.packageManager)return t.packageManager.split(`@`)[0]}catch{}return`pnpm`}async function _(e){try{return(await c(e))?.modules?.style===`class`?`class`:`define`}catch{return`define`}}async function v(e,t){if(t)return t;try{let t=(await c(e))?.pattern;if(t&&m.has(t))return t}catch{}return`rest`}async function y(e){let c=e.only??`all`,d=h(e.outDir,e.name),f=g(e.outDir,e.pm),m=await v(e.outDir,e.template),y=await _(e.outDir),b=c===`agents`||c===`both`||c===`all`,x=c===`claude`||c===`both`||c===`all`,S=c===`skills`||c===`all`,C=c===`gemini`||c===`all`,w=c===`copilot`||c===`all`,T=[];if(b&&T.push({file:l(e.outDir,p,`AGENTS.md`),render:()=>o(d,m,f)}),x&&T.push({file:l(e.outDir,`CLAUDE.md`),render:()=>i(d,m,f)}),S)for(let n of t(d,m,f,y))T.push({file:l(e.outDir,p,`skills`,n.slug,`SKILL.md`),render:()=>n.content});C&&T.push({file:l(e.outDir,p,`GEMINI.md`),render:()=>n(d,m,f)}),w&&T.push({file:l(e.outDir,p,`COPILOT.md`),render:()=>a(d,m,f)});let E=[];for(let{file:t,render:n}of T){if(u(t)&&!e.force&&!await s({message:`${t.replace(e.outDir+`/`,``)} already exists. Overwrite?`,initialValue:!1})){console.log(`  Skipped — existing ${t.replace(e.outDir+`/`,``)} preserved.`);continue}await r(t,n()),E.push(t)}return E}export{y as n,f as t};
-//# sourceMappingURL=agent-docs-CXs5UDAM.mjs.map

package/dist/agent-docs-CXs5UDAM.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent-docs-CXs5UDAM.mjs","names":[],"sources":["../src/generators/agent-docs.ts"],"sourcesContent":["import { join } from 'node:path'\nimport { existsSync, readFileSync } from 'node:fs'\nimport { writeFileSafe } from '../utils/fs'\nimport { confirm } from '../utils/prompts'\nimport {\n  generateClaude,\n  generateAgents,\n  generateKickJsSkillFiles,\n  generateGemini,\n  generateCopilot,\n} from './templates/project-docs'\nimport { loadKickConfig } from '../config'\nimport type { ModuleStyle } from './templates/types'\n\ntype ProjectTemplate = 'rest' | 'minimal' | 'fullstack'\n\n/**\n * Subdirectory (relative to the project root) where every shared\n * agent-context file lands. CLAUDE.md is the only exception — it stays\n * at the project root because Claude Code auto-loads CLAUDE.md from\n * there. CLAUDE.md is generated as a thin pointer that tells Claude\n * to read `.agents/AGENTS.md` first.\n *\n * Existing root-level AGENTS.md / kickjs-skills.md files (from older\n * scaffolds before this restructure) are left untouched — the\n * generator emits the new layout alongside them and leaves migration\n * to the adopter.\n */\nconst AGENTS_DIR = '.agents'\n\nexport interface GenerateAgentDocsOptions {\n  outDir: string\n  /** Override project name (defaults to package.json `name`). */\n  name?: string\n  /** Override package manager (defaults to package.json `packageManager` field, then 'pnpm'). */\n  pm?: string\n  /** Override template (defaults to kick.config.ts `pattern`, then 'rest'). */\n  template?: ProjectTemplate\n  /**\n   * Which file(s) to (re)generate. All `.agents/`-bound files land in\n   * the project's `.agents/` subdirectory; `claude` is the only file\n   * that stays at the project root.\n   *\n   * - `agents`  → `.agents/AGENTS.md`\n   * - `claude`  → `CLAUDE.md` (root; thin pointer to .agents/)\n   * - `skills`  → `.agents/skills/<slug>/SKILL.md` (one per skill)\n   * - `gemini`  → `.agents/GEMINI.md`\n   * - `copilot` → `.agents/COPILOT.md`\n   * - `both`    → `.agents/AGENTS.md` + `CLAUDE.md` (legacy alias)\n   * - `all`     → every file above\n   */\n  only?: 'agents' | 'claude' | 'skills' | 'gemini' | 'copilot' | 'both' | 'all'\n  /** Skip the overwrite prompt. */\n  force?: boolean\n}\n\nconst VALID_TEMPLATES = new Set<ProjectTemplate>(['rest', 'minimal', 'fullstack'])\n\nfunction detectName(outDir: string, override?: string): string {\n  if (override) return override\n  try {\n    const pkg = JSON.parse(readFileSync(join(outDir, 'package.json'), 'utf-8')) as { name?: string }\n    if (pkg.name) return pkg.name.replace(/^@[^/]+\\//, '')\n  } catch {\n    // No package.json — fall back to folder name\n  }\n  return outDir.split('/').findLast(Boolean) ?? 'app'\n}\n\nfunction detectPm(outDir: string, override?: string): string {\n  if (override) return override\n  try {\n    const pkg = JSON.parse(readFileSync(join(outDir, 'package.json'), 'utf-8')) as {\n      packageManager?: string\n    }\n    if (pkg.packageManager) return pkg.packageManager.split('@')[0]\n  } catch {\n    // ignore\n  }\n  return 'pnpm'\n}\n\n/**\n * Module declaration style, so generated examples show the form this project\n * actually uses. A `class` module passed as `UserModule()` calls a class\n * without `new`; a `define` module passed bare is refused when it takes config.\n */\nasync function detectStyle(outDir: string): Promise<ModuleStyle> {\n  try {\n    const cfg = await loadKickConfig(outDir)\n    return cfg?.modules?.style === 'class' ? 'class' : 'define'\n  } catch {\n    return 'define'\n  }\n}\n\nasync function detectTemplate(\n  outDir: string,\n  override?: ProjectTemplate,\n): Promise<ProjectTemplate> {\n  if (override) return override\n  try {\n    const cfg = await loadKickConfig(outDir)\n    const pattern = cfg?.pattern as ProjectTemplate | undefined\n    if (pattern && VALID_TEMPLATES.has(pattern)) return pattern\n  } catch {\n    // ignore\n  }\n  return 'rest'\n}\n\nexport async function generateAgentDocs(options: GenerateAgentDocsOptions): Promise<string[]> {\n  const only = options.only ?? 'all'\n  const name = detectName(options.outDir, options.name)\n  const pm = detectPm(options.outDir, options.pm)\n  const template = await detectTemplate(options.outDir, options.template)\n  const style = await detectStyle(options.outDir)\n\n  const wantsAgents = only === 'agents' || only === 'both' || only === 'all'\n  const wantsClaude = only === 'claude' || only === 'both' || only === 'all'\n  const wantsSkills = only === 'skills' || only === 'all'\n  const wantsGemini = only === 'gemini' || only === 'all'\n  const wantsCopilot = only === 'copilot' || only === 'all'\n\n  // CLAUDE.md stays at the project root because Claude Code auto-loads\n  // it from there. Every other shared-context file lands under\n  // `.agents/` so the root stays uncluttered. `writeFileSafe` creates\n  // parent directories automatically — no need to pre-mkdir.\n  const targets: { file: string; render: () => string }[] = []\n  if (wantsAgents) {\n    targets.push({\n      file: join(options.outDir, AGENTS_DIR, 'AGENTS.md'),\n      render: () => generateAgents(name, template, pm),\n    })\n  }\n  if (wantsClaude) {\n    targets.push({\n      file: join(options.outDir, 'CLAUDE.md'),\n      render: () => generateClaude(name, template, pm),\n    })\n  }\n  if (wantsSkills) {\n    // Per-skill SKILL.md under `.agents/skills/<slug>/` so agents that\n    // auto-discover skills (Claude Code, Copilot CLI plugins, Gemini's\n    // activate_skill) pick each up by its frontmatter without needing\n    // a separate index file.\n    for (const skill of generateKickJsSkillFiles(name, template, pm, style)) {\n      targets.push({\n        file: join(options.outDir, AGENTS_DIR, 'skills', skill.slug, 'SKILL.md'),\n        render: () => skill.content,\n      })\n    }\n  }\n  if (wantsGemini) {\n    targets.push({\n      file: join(options.outDir, AGENTS_DIR, 'GEMINI.md'),\n      render: () => generateGemini(name, template, pm),\n    })\n  }\n  if (wantsCopilot) {\n    targets.push({\n      file: join(options.outDir, AGENTS_DIR, 'COPILOT.md'),\n      render: () => generateCopilot(name, template, pm),\n    })\n  }\n\n  const written: string[] = []\n  for (const { file, render } of targets) {\n    if (existsSync(file) && !options.force) {\n      const overwrite = await confirm({\n        message: `${file.replace(options.outDir + '/', '')} already exists. Overwrite?`,\n        initialValue: false,\n      })\n      if (!overwrite) {\n        console.log(`  Skipped — existing ${file.replace(options.outDir + '/', '')} preserved.`)\n        continue\n      }\n    }\n    await writeFileSafe(file, render())\n    written.push(file)\n  }\n  return written\n}\n"],"mappings":"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"}

package/dist/config-BUYf44lU.mjs

@@ -1,13 +0,0 @@
-/**
- * @forinda/kickjs-cli v8.5.0
- *
- * Copyright (c) Felix Orinda
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- * @license MIT
- */
-import{t as e}from"./rolldown-runtime-DzFISCwE.mjs";import{isAbsolute as t,join as n,relative as r,resolve as i}from"node:path";import{existsSync as a,mkdirSync as o,readFileSync as s,writeFileSync as c}from"node:fs";import{access as l,readFile as u}from"node:fs/promises";var d=e({BUILTIN_REPO_TYPES:()=>p,DEPRECATED_REPO_TYPES:()=>m,PACKAGE_MANAGERS:()=>f,defineConfig:()=>g,hasDependency:()=>_,hasSwagger:()=>v,loadKickConfig:()=>w,resolveModuleConfig:()=>S,resolveSchemaLib:()=>y,resolveTokenScope:()=>b,validateAssetMap:()=>E,warnIfDeprecatedRepo:()=>h,writeAssetConfigSnapshot:()=>T});const f=[`pnpm`,`npm`,`yarn`,`bun`],p=[`inmemory`],m=[`prisma`,`drizzle`];function h(e){return m.includes(e)?(console.warn(`  Note: '${e}' is no longer a built-in repository preset — a repository shaped to it is that library's interface, not KickJS's.\n  Scaffolding a generic custom-repository stub instead; wire it to ${e} yourself.`),!0):!1}function g(e){return e}function _(e,t,r=`runtime`){try{let i=n(e,`package.json`);if(!a(i))return!1;let o=JSON.parse(s(i,`utf-8`));return o.dependencies?.[t]?!0:r===`any`&&!!o.devDependencies?.[t]}catch{return!1}}function v(e){return _(e,`@forinda/kickjs-swagger`,`runtime`)}function y(e){return _(e,`valibot`,`runtime`)?`valibot`:_(e,`yup`,`runtime`)?`yup`:`zod`}function b(e,t){if(e?.tokenScope&&typeof e.tokenScope==`string`&&e.tokenScope.length>0){let t=x(e.tokenScope);if(t.length>0)return t}try{let e=n(t,`package.json`);if(a(e)){let t=JSON.parse(s(e,`utf-8`));if(typeof t.name==`string`&&t.name.length>0){let e=t.name.match(/^@([^/]+)\//),n=x(e?e[1]:t.name);if(n.length>0)return n}}}catch{}return`app`}function x(e){return e.toLowerCase().replace(/[^a-z0-9-]/g,`-`).replace(/^-+|-+$/g,``).replace(/-{2,}/g,`-`)}function S(e){if(!e)return{};let t={dir:e.modules?.dir,repo:e.modules?.repo,schemaDir:e.modules?.schemaDir,pluralize:e.modules?.pluralize,style:e.modules?.style};return t.style!==void 0&&t.style!==`define`&&t.style!==`class`&&(console.warn(`  Warning: modules.style '${t.style}' is not a valid value (expected 'define' or 'class'). Falling back to 'define'.`),t.style=`define`),t.repo&&typeof t.repo==`string`&&!p.includes(t.repo)&&(h(t.repo)||console.warn(`  Warning: modules.repo '${t.repo}' is not a built-in type (${p.join(`, `)}). It will generate a stub repository. Use { name: '${t.repo}' } to silence this warning.`)),t}const C=[`kick.config.ts`,`kick.config.js`,`kick.config.mjs`,`kick.config.json`];async function w(e){let{findProjectRoot:t}=await import(`./project-root-BzyIWFlH.mjs`).then(e=>e.n),r=t(e);for(let e of C){let t=n(r,e);try{await l(t)}catch{continue}if(e.endsWith(`.json`)){let e=await u(t,`utf-8`);return JSON.parse(e)}if(e.endsWith(`.ts`)){let n;try{n=await import(`jiti`)}catch(t){let n=t instanceof Error?t.message:String(t);n.includes(`Cannot find package 'jiti'`)||n.includes(`ERR_MODULE_NOT_FOUND`)?console.warn(`Warning: Failed to load ${e} — 'jiti' is required for TypeScript configs. Run \`pnpm add -D jiti\` (or your package manager's equivalent), or rename the file to kick.config.js / kick.config.mjs / kick.config.json.`):console.warn(`Warning: Failed to initialize jiti for ${e}: ${n}`);continue}try{let e=await n.createJiti(r,{interopDefault:!0,fsCache:!1}).import(t,{default:!0}),i=E(e,r);for(let e of i)console.warn(`  Warning: ${e}`);return T(r,e),e}catch(t){let n=t instanceof Error?t.message:String(t);console.warn(`Warning: Failed to load ${e}: ${n}`);continue}}try{let{pathToFileURL:e}=await import(`node:url`),n=await import(e(t).href),i=n.default??n,a=E(i,r);for(let e of a)console.warn(`  Warning: ${e}`);return T(r,i),i}catch(t){let n=t instanceof Error?t.message:String(t);console.warn(`Warning: Failed to load ${e}: ${n}`);continue}}return null}function T(e,t){if(t?.assetMap&&Object.keys(t.assetMap).length!==0)try{let r=n(e,`.kickjs`);o(r,{recursive:!0});let i={version:1,assetMap:t.assetMap,...t.build?.outDir?{build:{outDir:t.build.outDir}}:{}};c(n(r,`kick.config.json`),JSON.stringify(i,null,2)+`
-`,`utf-8`)}catch{}}function E(e,t){let n=[];if(!e?.assetMap)return n;let r=i(t);for(let[o,s]of Object.entries(e.assetMap)){if(!o||o.includes(`/`)){n.push(`assetMap key '${o}' is invalid — must be a non-empty string without '/'`);continue}if(typeof s?.src!=`string`||s.src.length===0){n.push(`assetMap.${o} is missing a non-empty 'src' field`);continue}let e=i(t,s.src);a(e)||n.push(`assetMap.${o}.src ('${s.src}') does not exist — typegen + build will fail`),s.dest&&D(i(t,s.dest),r)&&n.push(`assetMap.${o}.dest ('${s.dest}') resolves outside the project root — refusing to copy`)}return n}function D(e,n){let i=r(n,e);return i===``?!1:i.startsWith(`..`)||t(i)}export{v as a,y as c,_ as i,b as l,d as n,w as o,g as r,S as s,f as t,h as u};
-//# sourceMappingURL=config-BUYf44lU.mjs.map