@forinda/kickjs-cli 4.1.0 → 5.0.0

package/dist/index.d.mts

@@ -19,7 +19,7 @@ interface KickCommandDefinition {
   aliases?: string[];
 }
 /** Project pattern — controls what generators produce and which deps are installed */
-type ProjectPattern = 'rest' | 'graphql' | 'ddd' | 'cqrs' | 'minimal';
+type ProjectPattern = 'rest' | 'ddd' | 'cqrs' | 'minimal';
 /** Package manager used for `kick add` and other dep-installing commands */
 type PackageManager = 'pnpm' | 'npm' | 'yarn' | 'bun';
 /** Built-in repository types with first-class code generation support */
@@ -143,7 +143,6 @@ interface KickConfig {
   /**
    * Project pattern — controls default generator behavior.
    * - 'rest' — Express + Swagger (default)
-   * - 'graphql' — GraphQL + GraphiQL
    * - 'ddd' — Full DDD modules with use cases, entities, value objects
    * - 'cqrs' — CQRS with commands, queries, events, WebSocket + queue
    * - 'minimal' — Bare Express with no scaffolding
@@ -287,7 +286,6 @@ interface GenerateModuleOptions {
  * Patterns:
  *   rest         — flat folder: controller + service + DTOs + repo
  *   ddd          — nested DDD: presentation/ application/ domain/ infrastructure/
- *   graphql      — flat folder: resolver + service + DTOs + repo (future)
  *   cqrs         — commands, queries, events with WS/queue integration
  *   minimal      — just controller + module index
  */
@@ -367,7 +365,7 @@ interface GenerateDtoOptions {
 declare function generateDto(options: GenerateDtoOptions): Promise<string[]>;
 //#endregion
 //#region src/generators/project.d.ts
-type ProjectTemplate = 'rest' | 'graphql' | 'ddd' | 'cqrs' | 'minimal';
+type ProjectTemplate = 'rest' | 'ddd' | 'cqrs' | 'minimal';
 interface InitProjectOptions {
   name: string;
   directory: string;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/config.ts","../src/generators/module.ts","../src/generators/adapter.ts","../src/generators/middleware.ts","../src/generators/guard.ts","../src/generators/service.ts","../src/generators/controller.ts","../src/generators/dto.ts","../src/generators/project.ts","../src/generator-extension/define.ts","../src/generator-extension/discover.ts","../src/generator-extension/context.ts","../src/utils/naming.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/config.ts","../src/generators/module.ts","../src/generators/adapter.ts","../src/generators/middleware.ts","../src/generators/guard.ts","../src/generators/service.ts","../src/generators/controller.ts","../src/generators/dto.ts","../src/generators/project.ts","../src/generator-extension/define.ts","../src/generator-extension/discover.ts","../src/generator-extension/context.ts","../src/utils/naming.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1,5 +1,5 @@
 /**
- * @forinda/kickjs-cli v4.1.0
+ * @forinda/kickjs-cli v5.0.0
  *
  * Copyright (c) Felix Orinda
  *
@@ -1588,54 +1588,9 @@ export class Prisma${pascal}Repository implements I${pascal}Repository {
 */
 function generateEntryFile(name, template, version, packages = []) {
 	switch (template) {
-		case "graphql": {
-			const gqlImports = [];
-			const gqlAdapters = [];
-			if (packages.includes("devtools")) {
-				gqlImports.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`);
-				gqlAdapters.push(`    DevToolsAdapter(),`);
-			}
-			if (packages.includes("otel")) {
-				gqlImports.push(`import { OtelAdapter } from '@forinda/kickjs-otel'`);
-				gqlAdapters.push(`    OtelAdapter({ serviceName: '${name}' }),`);
-			}
-			if (packages.includes("swagger")) {
-				gqlImports.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`);
-				gqlAdapters.push(`    SwaggerAdapter({ info: { title: '${name}', version: '${version}' } }),`);
-			}
-			return `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'
-import { bootstrap } from '@forinda/kickjs'
-import { GraphQLAdapter } from '@forinda/kickjs-graphql'
-${gqlImports.length ? gqlImports.join("\n") + "\n" : ""}import { modules } from './modules'
-
-// Import your resolvers here
-// import { UserResolver } from './resolvers/user.resolver'
-
-// Export the app for the Vite plugin (dev mode)
-export const app = await bootstrap({
-  modules,
-  adapters: [
-${gqlAdapters.length ? gqlAdapters.join("\n") + "\n" : ""}    new GraphQLAdapter({
-      resolvers: [/* UserResolver */],
-      // Add custom type definitions here:
-      // typeDefs: userTypeDefs,
-    }),
-  ],
-})
-`;
-		}
 		case "cqrs": {
 			const cqrsImports = [];
 			const cqrsAdapters = [];
-			if (packages.includes("otel")) {
-				cqrsImports.push(`import { OtelAdapter } from '@forinda/kickjs-otel'`);
-				cqrsAdapters.push(`    OtelAdapter({ serviceName: '${name}' }),`);
-			}
 			if (packages.includes("devtools")) {
 				cqrsImports.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`);
 				cqrsAdapters.push(`    DevToolsAdapter(),`);
@@ -1644,10 +1599,6 @@ ${gqlAdapters.length ? gqlAdapters.join("\n") + "\n" : ""}    new GraphQLAdapter
 				cqrsImports.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`);
 				cqrsAdapters.push(`    SwaggerAdapter({\n      info: { title: '${name}', version: '${version}' },\n    }),`);
 			}
-			if (packages.includes("graphql")) {
-				cqrsImports.push(`import { GraphQLAdapter } from '@forinda/kickjs-graphql'`);
-				cqrsAdapters.push(`    new GraphQLAdapter({ resolvers: [] }),`);
-			}
 			return `import 'reflect-metadata'
 // Side-effect import — registers the extended env schema with kickjs
 // **before** any controller / service / @Value gets resolved. Without
@@ -1676,14 +1627,6 @@ export const app = await bootstrap({
 				imports.push(`import { DevToolsAdapter } from '@forinda/kickjs-devtools'`);
 				adapters.push(`    DevToolsAdapter(),`);
 			}
-			if (packages.includes("otel")) {
-				imports.push(`import { OtelAdapter } from '@forinda/kickjs-otel'`);
-				adapters.push(`    OtelAdapter({ serviceName: '${name}' }),`);
-			}
-			if (packages.includes("graphql")) {
-				imports.push(`import { GraphQLAdapter } from '@forinda/kickjs-graphql'`);
-				adapters.push(`    new GraphQLAdapter({ resolvers: [] }),`);
-			}
 			return `import 'reflect-metadata'
 // Side-effect import — registers the extended env schema with kickjs
 // **before** any controller / service / @Value gets resolved. Without
@@ -1708,10 +1651,6 @@ export const app = await bootstrap({ modules${adapters.length ? `,\n  adapters:
 				restImports.push(`import { SwaggerAdapter } from '@forinda/kickjs-swagger'`);
 				restAdapters.push(`    SwaggerAdapter({\n      info: { title: '${name}', version: '${version}' },\n    }),`);
 			}
-			if (packages.includes("otel")) {
-				restImports.push(`import { OtelAdapter } from '@forinda/kickjs-otel'`);
-				restAdapters.push(`    OtelAdapter({ serviceName: '${name}' }),`);
-			}
 			return `import 'reflect-metadata'
 // Side-effect import — registers the extended env schema with kickjs
 // **before** any controller / service / @Value gets resolved. Without
@@ -2265,7 +2204,6 @@ async function generateDddFiles(ctx) {
 * Patterns:
 *   rest         — flat folder: controller + service + DTOs + repo
 *   ddd          — nested DDD: presentation/ application/ domain/ infrastructure/
-*   graphql      — flat folder: resolver + service + DTOs + repo (future)
 *   cqrs         — commands, queries, events with WS/queue integration
 *   minimal      — just controller + module index
 */
@@ -2378,7 +2316,13 @@ async function generateAdapter(options) {
 	const pascal = toPascalCase(name);
 	const files = [];
 	const filePath = join(outDir, `${kebab}.adapter.ts`);
-	await writeFileSafe(filePath, `import { defineAdapter, type AdapterContext, type AdapterMiddleware } from '@forinda/kickjs'
+	await writeFileSafe(filePath, `import {
+  defineAdapter,
+  type AdapterContext,
+  type AdapterMiddleware,
+  type ContributorRegistrations,
+  type Constructor,
+} from '@forinda/kickjs'
 
 /**
  * Configuration for the ${pascal} adapter.
@@ -2399,7 +2343,12 @@ export interface ${pascal}AdapterConfig {
  * factory's call / \`.scoped()\` / \`.async()\` surfaces for free.
  *
  * Hooks into the Application lifecycle to add middleware, routes,
- * or external service connections.
+ * Context Contributors, or external service connections.
+ *
+ * Every lifecycle hook below is OPTIONAL. The scaffold emits all of
+ * them so adopters can browse what's available and delete what they
+ * don't need — \`build()\` returning \`{}\` is also valid for an adapter
+ * that only contributes config defaults.
  *
  * @example
  * \`\`\`ts
@@ -2415,59 +2364,126 @@ export interface ${pascal}AdapterConfig {
 export const ${pascal}Adapter = defineAdapter<${pascal}AdapterConfig>({
   name: '${pascal}Adapter',
   defaults: {
-    // Default config values go here
+    // Default config values go here. The adopter's overrides shallow-merge
+    // on top of these before \`build()\` runs.
   },
-  build: (_config, { name: _name }) => ({
-    /**
-     * Return middleware entries that the Application will mount.
-     * \`phase\` controls where in the pipeline they run:
-     * 'beforeGlobal' | 'afterGlobal' | 'beforeRoutes' | 'afterRoutes'.
-     */
-    middleware(): AdapterMiddleware[] {
-      return [
-        // Example: add a custom header to all responses
-        // {
-        //   phase: 'beforeGlobal',
-        //   handler: (_req, res, next) => {
-        //     res.setHeader('X-${pascal}', 'true')
-        //     next()
-        //   },
-        // },
-      ]
-    },
-
-    /**
-     * Called before global middleware. Use this to mount routes that
-     * bypass the middleware stack (health checks, docs UI, static
-     * assets).
-     */
-    beforeMount(_ctx: AdapterContext): void {
-      // Example:
-      // _ctx.app.get('/${kebab}/status', (_req, res) => res.json({ status: 'ok' }))
-    },
-
-    /**
-     * Called after modules and routes are registered, before the
-     * server starts. Use this for late-stage DI registrations or
-     * config validation.
-     */
-    beforeStart(_ctx: AdapterContext): void {
-      // Example: _ctx.container.bindToken(MY_TOKEN, new MyService(_config))
-    },
-
-    /**
-     * Called after the HTTP server is listening. Use this to attach
-     * to the raw http.Server (Socket.IO, gRPC, etc).
-     */
-    afterStart(_ctx: AdapterContext): void {
-      // Example: const io = new Server(_ctx.server)
-    },
+  build: (_config, { name: _name }) => {
+    // Closures inside \`build()\` are how each adapter instance owns its
+    // own state (database client, Map, timer handle, …). The same
+    // \`_config\` is visible to every hook below.
 
-    /** Called on graceful shutdown. Clean up connections. */
-    async shutdown(): Promise<void> {
-      // Example: await this.pool.end()
-    },
-  }),
+    return {
+      /**
+       * Express middleware entries the Application mounts at named phases.
+       *
+       * \`phase\` controls where each handler sits in the pipeline:
+       *   'beforeGlobal' | 'afterGlobal' | 'beforeRoutes' | 'afterRoutes'.
+       *
+       * \`path\` (optional) scopes the entry to a path prefix.
+       *
+       * Delete this hook entirely if you don't add middleware.
+       */
+      middleware(): AdapterMiddleware[] {
+        return [
+          // Example: add a custom header to all responses
+          // {
+          //   phase: 'beforeGlobal',
+          //   handler: (_req, res, next) => {
+          //     res.setHeader('X-${pascal}', 'true')
+          //     next()
+          //   },
+          // },
+          // Example: scope a rate limiter to one path prefix
+          // {
+          //   phase: 'beforeRoutes',
+          //   path: '/api/v1/auth',
+          //   handler: rateLimit({ max: 10 }),
+          // },
+        ]
+      },
+
+      /**
+       * Runs BEFORE global middleware. Mount routes that should bypass the
+       * middleware stack — health checks, docs UI, static assets, OAuth
+       * callbacks. Anything you want reachable even if a global middleware
+       * later in the chain rejects requests.
+       *
+       * Delete this hook if you have no early routes.
+       */
+      beforeMount(_ctx: AdapterContext): void {
+        // Example:
+        // _ctx.app.get('/${kebab}/status', (_req, res) => res.json({ status: 'ok' }))
+      },
+
+      /**
+       * Fires once per controller class as the router mounts. Use this to
+       * collect route metadata for OpenAPI specs, dependency graphs, route
+       * inventories, devtools dashboards.
+       *
+       * Delete this hook unless your adapter introspects the route registry.
+       */
+      onRouteMount(_controllerClass: Constructor, _mountPath: string): void {
+        // Example (Swagger-style): collect routes for the spec.
+        // openApiSpec.addController(_controllerClass, _mountPath)
+      },
+
+      /**
+       * Runs AFTER modules + routes are wired, BEFORE the server starts.
+       * Right place for late-stage DI registrations or final config validation.
+       *
+       * Delete this hook if there's nothing to wire post-modules.
+       */
+      beforeStart(_ctx: AdapterContext): void {
+        // Example: _ctx.container.registerInstance(MY_TOKEN, new MyService(_config))
+      },
+
+      /**
+       * Runs AFTER the HTTP server is listening. The raw \`http.Server\` is
+       * available on \`ctx.server\` — attach upgrade handlers (Socket.IO,
+       * gRPC, GraphQL subscriptions), warm caches, log a banner.
+       *
+       * Delete this hook if you don't need the running server reference.
+       */
+      afterStart(_ctx: AdapterContext): void {
+        // Example: const io = new Server(_ctx.server)
+      },
+
+      /**
+       * Returns Context Contributors to merge into every route's pipeline
+       * at the \`'adapter'\` precedence level. Per-route handlers can
+       * override the value at the method / class / module level.
+       *
+       * Delete this hook unless your adapter ships typed per-request values
+       * (auth user, tenant, locale, feature flags, geo, etc).
+       */
+      contributors(): ContributorRegistrations {
+        return [
+          // Example:
+          // import { defineHttpContextDecorator } from '@forinda/kickjs'
+          // declare module '@forinda/kickjs' { interface ContextMeta { ${kebab}: { id: string } } }
+          // const Load${pascal} = defineHttpContextDecorator({
+          //   key: '${kebab}',
+          //   resolve: (ctx) => ({ id: ctx.req.headers['x-${kebab}-id'] as string }),
+          // })
+          // return [Load${pascal}.registration]
+        ]
+      },
+
+      /**
+       * Runs on graceful shutdown (SIGINT/SIGTERM). Clean up long-lived
+       * resources the adapter owns: close connections, flush buffers,
+       * cancel timers. The framework runs every adapter's \`shutdown\`
+       * concurrently via \`Promise.allSettled\` — one failure won't block
+       * sibling adapters.
+       *
+       * Delete this hook if your adapter holds no resources.
+       */
+      async shutdown(): Promise<void> {
+        // Example: await this.pool.end()
+        // Example: clearInterval(this.heartbeatTimer)
+      },
+    }
+  },
 })
 `);
 	files.push(filePath);
@@ -2741,15 +2757,9 @@ export type ${pascal}DTO = z.infer<typeof ${camel}Schema>
 const PACKAGE_DEPS = {
 	auth: "@forinda/kickjs-auth",
 	swagger: "@forinda/kickjs-swagger",
-	otel: "@forinda/kickjs-otel",
 	ws: "@forinda/kickjs-ws",
 	queue: "@forinda/kickjs-queue",
-	cron: "@forinda/kickjs-cron",
-	mailer: "@forinda/kickjs-mailer",
-	graphql: "@forinda/kickjs-graphql",
-	devtools: "@forinda/kickjs-devtools",
-	notifications: "@forinda/kickjs-notifications",
-	"multi-tenant": "@forinda/kickjs-multi-tenant"
+	devtools: "@forinda/kickjs-devtools"
 };
 /** Generate package.json with template-aware dependencies */
 function generatePackageJson(name, template, kickjsVersion, packages = []) {
@@ -2762,15 +2772,10 @@ function generatePackageJson(name, template, kickjsVersion, packages = []) {
 		pino: "^10.3.1",
 		"pino-pretty": "^13.1.3"
 	};
-	if (template === "graphql") {
-		baseDeps["@forinda/kickjs-graphql"] = kickjsVersion;
-		baseDeps["graphql"] = "^16.11.0";
-	}
 	for (const pkg of packages) {
 		const dep = PACKAGE_DEPS[pkg];
 		if (dep && !baseDeps[dep]) baseDeps[dep] = kickjsVersion;
 	}
-	if (packages.includes("graphql") && !baseDeps["graphql"]) baseDeps["graphql"] = "^16.11.0";
 	return JSON.stringify({
 		name,
 		version: kickjsVersion.replace("^", ""),
@@ -2970,15 +2975,13 @@ export default defineConfig({
 function generateReadme(name, template, pm) {
 	const templateLabels = {
 		rest: "REST API",
-		graphql: "GraphQL API",
 		ddd: "Domain-Driven Design",
 		cqrs: "CQRS + Event-Driven",
 		minimal: "Minimal"
 	};
 	const packages = ["@forinda/kickjs", "@forinda/kickjs-vite"];
 	if (template !== "minimal") packages.push("@forinda/kickjs-swagger", "@forinda/kickjs-devtools");
-	if (template === "graphql") packages.push("@forinda/kickjs-graphql");
-	if (template === "cqrs") packages.push("@forinda/kickjs-queue", "@forinda/kickjs-ws", "@forinda/kickjs-otel");
+	if (template === "cqrs") packages.push("@forinda/kickjs-queue", "@forinda/kickjs-ws");
 	return `# ${name}
 
 A **${templateLabels[template] ?? "REST API"}** built with [KickJS](https://forinda.github.io/kick-js/) — a decorator-driven Node.js framework on Express 5 and TypeScript.
@@ -3023,11 +3026,11 @@ kick add auth          # Authentication (JWT, API key, OAuth)
 kick add swagger       # OpenAPI documentation
 kick add ws            # WebSocket support
 kick add queue         # Background job processing
-kick add mailer        # Email sending
-kick add cron          # Scheduled tasks
 kick add --list        # Show all available packages
 \`\`\`
 
+For email, scheduled tasks, multi-tenancy, OpenTelemetry, GraphQL, and notifications use the BYO recipes in the [KickJS guides](https://forinda.github.io/kick-js/guide/) — they wire the upstream library through \`defineAdapter()\` / \`definePlugin()\` directly, so you keep control of the integration.
+
 ## Environment Variables
 
 Copy \`.env.example\` to \`.env\` and configure:
@@ -3202,8 +3205,8 @@ mistakes:
     property assignment (\`ctx.tenant = …\`) sticks to the contributor
     instance only — the handler instance never sees it.
   - **Read across instances via \`ctx.set\` / \`ctx.get\`** (or
-    \`requestStore.getStore()?.values.get('key')\` from a service that
-    has no \`ctx\` reference). \`ctx.req\` works because the underlying
+    \`getRequestValue(key)\` from a service that has no \`ctx\` reference
+    — typed via \`MetaValue<K>\`). \`ctx.req\` works because the underlying
     Express request is shared; bespoke property assignments don't.
 
 - **Test isolation** — default to \`Container.create()\` for fresh DI state.
@@ -3271,7 +3274,7 @@ package additions, env access patterns, troubleshooting) is detailed below.
 | Module registry | \`src/modules/index.ts\` |
 | Feature modules | \`src/modules/<module-name>/\` |
 | **Module entry file** | \`src/modules/<name>/<name>.module.ts\` (filename suffix is required — see Vite HMR contract below) |
-${template === "graphql" ? "| GraphQL resolvers | `src/resolvers/` |\n" : ""}| Env values | \`.env\` |
+| Env values | \`.env\` |
 | Env schema (Zod) | \`src/config/index.ts\` |
 | TypeScript config | \`tsconfig.json\` |
 | Vite config (HMR) | \`vite.config.ts\` |
@@ -3308,12 +3311,6 @@ ${template === "ddd" ? `\`\`\`
 ├── <name>.repository.ts     # Data access
 └── <name>.module.ts         # Module definition (implements AppModule)
 \`\`\`
-` : template === "graphql" ? `\`\`\`
-resolvers/
-├── <name>.resolver.ts       # @Resolver, @Query, @Mutation
-├── <name>.types.ts          # GraphQL type definitions
-└── <name>.service.ts        # Business logic
-\`\`\`
 ` : template === "rest" ? `\`\`\`
 <name>/
 ├── <name>.controller.ts     # HTTP routes (@Controller)
@@ -3586,15 +3583,7 @@ fast). The \`onError\` hook is async-permitted.
 
 Full guide: <https://forinda.github.io/kick-js/guide/context-decorators>.
 
-${template === "graphql" ? `### GraphQL
-| Decorator | Purpose |
-|-----------|---------|
-| \`@Resolver()\` | GraphQL resolver class |
-| \`@Query()\` | Query handler |
-| \`@Mutation()\` | Mutation handler |
-| \`@Arg('name')\` | Resolver argument |
-
-` : ""}${template === "cqrs" ? `### Background Jobs
+${template === "cqrs" ? `### Background Jobs
 | Decorator | Purpose |
 |-----------|---------|
 | \`@Job('name')\` | Queue job handler |
@@ -3852,10 +3841,11 @@ Precedence high → low: **method > class > module > adapter > global**.
 Cycles or unmet \`dependsOn\` keys throw \`MissingContributorError\` at boot.
 
 **Critical rules — all stem from the same shared-via-ALS instance model**:
-- Every per-request stage (middleware → contributors → handler) gets its OWN \`RequestContext\` instance, but they all read/write the SAME \`AsyncLocalStorage\`-backed Map (\`requestStore.getStore().values\`).
+- Every per-request stage (middleware → contributors → handler) gets its OWN \`RequestContext\` instance, but they all read/write the SAME \`AsyncLocalStorage\`-backed bag.
 - **\`resolve\` and \`onError\` must RETURN the value** — the runner writes it via \`ctx.set(key, value)\`. Direct property assignment (\`ctx.tenant = …\`) sticks to one instance only and the handler instance never sees it.
 - \`ctx.set('tenant', x)\` then \`ctx.get('tenant')\` works across instances. \`ctx.req.headers[...]\` works (the underlying Express request is shared).
-- Services can read contributor output without a \`ctx\` reference via \`requestStore.getStore()?.values.get('tenant')\` — same Map, no DI plumbing needed.
+- Services with no \`ctx\` reference: \`getRequestValue('tenant')\` returns \`MetaValue<'tenant'> | undefined\` (typed via the augmented \`ContextMeta\`). For \`requestId\` use \`getRequestStore()\`.
+- **No \`setRequestValue\` — writes flow through \`ctx.set\` or a contributor's return value.** Avoids "spooky action at a distance" where any service can pollute the per-request bag.
 
 **Don't use this for**: response short-circuit, stream mutation, or
 pre-route-matching work — keep \`@Middleware()\` for those.
@@ -3928,7 +3918,6 @@ async function initProject(options) {
 	await writeFileSafe(join(dir, "src/modules/hello/hello.service.ts"), generateHelloService());
 	await writeFileSafe(join(dir, "src/modules/hello/hello.controller.ts"), generateHelloController());
 	await writeFileSafe(join(dir, "src/modules/hello/hello.module.ts"), generateHelloModule());
-	if (template === "graphql") await writeFileSafe(join(dir, "src/resolvers/.gitkeep"), "");
 	await writeFileSafe(join(dir, "kick.config.ts"), generateKickConfig(template, defaultRepo, packageManager));
 	await writeFileSafe(join(dir, "vitest.config.ts"), generateVitestConfig());
 	await writeFileSafe(join(dir, "README.md"), generateReadme(name, template, packageManager));
@@ -3948,7 +3937,7 @@ async function initProject(options) {
 		}
 	}
 	try {
-		const { runTypegen } = await import("./typegen-C-H8pg-y.mjs");
+		const { runTypegen } = await import("./typegen-B13guHZF.mjs");
 		await runTypegen({
 			cwd: dir,
 			allowDuplicates: true,
@@ -3984,7 +3973,6 @@ async function initProject(options) {
 	if (!options.installDeps) log(`  ${packageManager} install`);
 	const genHint = {
 		rest: "kick g module user",
-		graphql: "kick g resolver user",
 		ddd: "kick g module user --repo drizzle",
 		cqrs: "kick g module user --pattern cqrs",
 		minimal: "# add your routes to src/index.ts"
@@ -4006,7 +3994,6 @@ async function initProject(options) {
 	log("  kick g guard <name>       Route guard (auth, roles, etc.)");
 	log("  kick g adapter <name>     AppAdapter with lifecycle hooks");
 	log("  kick g dto <name>         Zod DTO schema");
-	if (template === "graphql") log("  kick g resolver <name>    GraphQL resolver");
 	if (template === "cqrs") log("  kick g job <name>         Queue job processor");
 	log("  kick g config             Generate kick.config.ts");
 	log("");
@@ -4014,8 +4001,7 @@ async function initProject(options) {
 	log("  kick add <pkg>            Install a KickJS package + peers");
 	log("  kick add --list           Show all available packages");
 	log("");
-	log("Available: auth, swagger, graphql, drizzle, prisma, ws, cron,");
-	log("           queue, mailer, otel, devtools, multi-tenant, notifications, mcp, testing");
+	log("Available: auth, swagger, drizzle, prisma, ws, queue, devtools, mcp, testing");
 	log("");
 }
 //#endregion