@tatara/cli 0.1.3 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tatara/cli",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Create and grow opinionated Hono backends",
   "type": "module",
   "license": "MIT",

package/templates/features/admin/files/src/apps/admin/server.ts

@@ -1,5 +1,6 @@
+import { startServer } from "@tatara/http";
 import { app } from "#apps/admin/app";
 import { env } from "#core/config/env";
-import { startServer } from "#core/http/server";
+import { logger } from "#core/logging/logger";
 
-startServer(app, env.ADMIN_PORT, "admin");
+startServer(app, { port: env.ADMIN_PORT, name: "admin", logger });

package/templates/features/admin/files/src/modules/example/routes/admin-greeting.routes.ts

@@ -1,6 +1,6 @@
 import { createRoute } from "@hono/zod-openapi";
 import { currentPrincipal } from "#core/auth/middleware";
-import { errorResponses, jsonContent, success, successSchema } from "#core/http/response";
+import { errorResponses, jsonContent, success, successSchema } from "@tatara/http";
 import { createRouter, defineRoutes } from "#core/http/routes";
 import { greetingSchema } from "#modules/example/validators/greeting.validators";
 

package/templates/features/auth/files/src/core/auth/middleware.ts

@@ -1,7 +1,7 @@
 import { createMiddleware } from "hono/factory";
 import type { Context } from "hono";
 import type { AppEnv, Principal } from "#core/http/context";
-import { ForbiddenError, UnauthorizedError } from "#core/http/errors";
+import { ForbiddenError, UnauthorizedError } from "@tatara/http";
 
 /** 401 unless the request carries a valid session or token. */
 export function requireAuth() {

package/templates/features/auth/files/src/core/auth/routes/me.routes.ts

@@ -1,6 +1,6 @@
 import { createRoute, z } from "@hono/zod-openapi";
 import { currentPrincipal, requireAuth } from "#core/auth/middleware";
-import { errorResponses, jsonContent, success, successSchema } from "#core/http/response";
+import { errorResponses, jsonContent, success, successSchema } from "@tatara/http";
 import { createRouter, defineRoutes } from "#core/http/routes";
 
 const principalSchema = z

package/templates/features/auth-keycloak/files/src/core/auth/commands/keycloak-token.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { issuer } from "#core/auth/keycloak";
-import { defineCommand } from "#core/commands/define";
+import { defineCommand } from "@tatara/core";
 import { env } from "#core/config/env";
 
 export default defineCommand({

package/templates/features/authz/files/src/core/authz/commands/grant-role.ts

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { DEFAULT_ORG_ID, SYSTEM_ORG_ID } from "#core/authz/constants";
 import { store } from "#core/authz/db/store";
 import { assignRole } from "#core/authz/services/members";
-import { defineCommand } from "#core/commands/define";
+import { defineCommand } from "@tatara/core";
 
 export default defineCommand({
 	name: "authz:grant-role",

package/templates/features/authz/files/src/core/authz/commands/sync-permissions.ts

@@ -1,4 +1,4 @@
-import { defineCommand } from "#core/commands/define";
+import { defineCommand } from "@tatara/core";
 import { syncSystemRoles } from "#core/authz/services/sync";
 
 export default defineCommand({

package/templates/features/authz/files/src/core/authz/middleware.ts

@@ -2,7 +2,7 @@ import { createMiddleware } from "hono/factory";
 import type { Scope } from "#core/authz/constants";
 import { checkPermission } from "#core/authz/resolver";
 import type { AppEnv } from "#core/http/context";
-import { ForbiddenError, UnauthorizedError } from "#core/http/errors";
+import { ForbiddenError, UnauthorizedError } from "@tatara/http";
 import type { PermissionKey } from "#generated/permissions";
 
 /**

package/templates/features/authz/files/src/core/authz/routes/authorization.routes.ts

@@ -19,7 +19,7 @@ import {
 	userParams,
 	userRoleParams,
 } from "#core/authz/validators";
-import { errorResponses, jsonBody, jsonContent, success, successSchema } from "#core/http/response";
+import { errorResponses, jsonBody, jsonContent, success, successSchema } from "@tatara/http";
 import { createRouter, defineRoutes } from "#core/http/routes";
 import { catalog } from "#generated/permissions";
 

package/templates/features/authz/files/src/core/authz/services/grants.ts

@@ -1,7 +1,7 @@
 import { assertGrantValid, InvalidGrantError, META_RESOURCES } from "#core/authz/catalog";
 import type { Scope } from "#core/authz/constants";
 import type { PermissionGrant } from "#core/authz/types";
-import { BusinessRuleError } from "#core/http/errors";
+import { BusinessRuleError } from "@tatara/http";
 import { catalog } from "#generated/permissions";
 
 /** Validates grants against the catalog; custom roles and overlays may not grant meta resources. */

package/templates/features/authz/files/src/core/authz/services/members.ts

@@ -3,7 +3,7 @@ import { type OverlayEffect, type Scope, SYSTEM_ACTOR } from "#core/authz/consta
 import { store } from "#core/authz/db/store";
 import { audit } from "#core/authz/services/audit";
 import { validateGrants } from "#core/authz/services/grants";
-import { NotFoundError } from "#core/http/errors";
+import { NotFoundError } from "@tatara/http";
 
 export async function getMember(orgId: string, userId: string) {
 	const [roles, overlays] = await Promise.all([

package/templates/features/authz/files/src/core/authz/services/roles.ts

@@ -4,7 +4,7 @@ import { audit } from "#core/authz/services/audit";
 import { validateGrants } from "#core/authz/services/grants";
 import { SYSTEM_ROLE_KEYS } from "#core/authz/system-roles";
 import type { RoleRow } from "#core/authz/types";
-import { BusinessRuleError, ConflictError, NotFoundError } from "#core/http/errors";
+import { BusinessRuleError, ConflictError, NotFoundError } from "@tatara/http";
 
 export interface RoleInput {
 	key: string;

package/templates/features/base/files/AGENTS.md

@@ -40,6 +40,7 @@ __PM_EXEC__ tatara make resource <name> --module <module>   # CRUD slice
 __PM_EXEC__ tatara make route|service|command <name> --module <module>
 __PM_EXEC__ tatara run --list            # app commands
 __PM_EXEC__ tatara routes                # every route and what protects it
+__PM_EXEC__ tatara upgrade               # after bumping @tatara/cli: run its codemods, sync, verify
 ```
 
 ## HTTP

package/templates/features/base/files/src/apps/api/server.ts

@@ -1,5 +1,6 @@
+import { startServer } from "@tatara/http";
 import { app } from "#apps/api/app";
 import { env } from "#core/config/env";
-import { startServer } from "#core/http/server";
+import { logger } from "#core/logging/logger";
 
-startServer(app, env.PORT, "api");
+startServer(app, { port: env.PORT, name: "api", logger });

package/templates/features/base/files/src/apps/cli/index.ts

@@ -1,6 +1,6 @@
-import { runCommand } from "#core/commands/runner";
-import { shutdown } from "#core/process/lifecycle";
+import { runCommand, shutdown } from "@tatara/core";
+import { logger } from "#core/logging/logger";
 import { commands } from "#generated/commands";
 
-const code = await runCommand(commands, process.argv.slice(2));
-await shutdown(code);
+const code = await runCommand(commands, process.argv.slice(2), logger);
+await shutdown(code, logger);

package/templates/features/base/files/src/core/http/app.ts

@@ -1,57 +1,44 @@
-import { OpenAPIHono } from "@hono/zod-openapi";
-import { Scalar } from "@scalar/hono-api-reference";
-import { bodyLimit } from "hono/body-limit";
-import { cors } from "hono/cors";
-import { secureHeaders } from "hono/secure-headers";
+import { createApp, handleErrors, mountRoutes, serveOpenApi } from "@tatara/http";
 import { env } from "#core/config/env";
 import type { AppEnv } from "#core/http/context";
-import { runReadinessChecks } from "#core/http/health";
-import { errorHandler, notFoundHandler } from "#core/http/middleware/error-handler";
-import { requestContext } from "#core/http/middleware/request-context";
-import { validationHook } from "#core/http/middleware/validation";
 import type { AppName } from "#core/http/routes";
+import { logger } from "#core/logging/logger";
 import { routes } from "#generated/routes";
 // tatara:slot imports
 
 export const API_PREFIX = "/api";
 
+/** The app's HTTP wiring: plain Hono, with tatara's defaults from @tatara/http. */
 export function createHttpApp(name: AppName, options: { title: string }) {
-	const app = new OpenAPIHono<AppEnv>({ defaultHook: validationHook });
-
-	app.use(requestContext);
-	app.use(secureHeaders());
-	app.use(
-		cors({
-			origin: env.CORS_ORIGINS,
-			credentials: true,
-			allowHeaders: ["Content-Type", "Authorization", "X-Request-Id", "Accept-Language"],
-			exposeHeaders: ["X-Request-Id"],
-		}),
-	);
-	app.use(bodyLimit({ maxSize: env.BODY_LIMIT_BYTES }));
-	// tatara:slot middleware
-
-	app.get("/health", (c) => c.json({ status: "ok" }));
-	app.get("/ready", async (c) => {
-		const result = await runReadinessChecks();
-		return c.json(result, result.ready ? 200 : 503);
+	const app = createApp<AppEnv>({
+		logger,
+		cors: {
+			origins: env.CORS_ORIGINS,
+			exposeHeaders: [
+				"X-Request-Id",
+				// tatara:slot expose-headers
+			],
+		},
+		bodyLimitBytes: env.BODY_LIMIT_BYTES,
+		defaults: { principal: null, language: "en" },
 	});
+	// tatara:slot middleware
 
 	// tatara:slot routes
 
-	for (const definition of routes) {
-		if (definition.app === name) app.route(`${API_PREFIX}${definition.basePath}`, definition.router);
-	}
-
-	const openApiConfig = { openapi: "3.1.0", info: { title: options.title, version: "1.0.0" } } as const;
-	app.get("/openapi.json", async (c) => {
-		const document = app.getOpenAPI31Document(openApiConfig);
-		// tatara:slot openapi
-		return c.json(document);
+	mountRoutes(app, routes, { app: name, prefix: API_PREFIX });
+	serveOpenApi(app, {
+		title: options.title,
+		async extend(document) {
+			// tatara:slot openapi
+		},
+	});
+	handleErrors(app, {
+		message(err, c) {
+			let message = err.message;
+			// tatara:slot error-message
+			return message;
+		},
 	});
-	app.get("/docs", Scalar({ url: "/openapi.json", pageTitle: options.title }));
-
-	app.onError(errorHandler);
-	app.notFound(notFoundHandler);
 	return app;
 }

package/templates/features/base/files/src/core/http/routes.ts

@@ -1,6 +1,8 @@
-import { OpenAPIHono } from "@hono/zod-openapi";
+import {
+	createRouter as createTataraRouter,
+	type RouteDefinition as TataraRouteDefinition,
+} from "@tatara/http";
 import type { AppEnv } from "#core/http/context";
-import { validationHook } from "#core/http/middleware/validation";
 
 export const APP_NAMES = [
 	"api",
@@ -9,13 +11,7 @@ export const APP_NAMES = [
 
 export type AppName = (typeof APP_NAMES)[number];
 
-export interface RouteDefinition {
-	/** which HTTP app serves these routes */
-	app: AppName;
-	/** mounted under `/api` + basePath, e.g. "/notes" */
-	basePath: string;
-	router: OpenAPIHono<AppEnv>;
-}
+export type RouteDefinition = TataraRouteDefinition<AppName, AppEnv>;
 
 /** Default export of every `routes/*.routes.ts`; discovered by `tatara sync`. */
 export function defineRoutes(definition: RouteDefinition): RouteDefinition {
@@ -23,6 +19,6 @@ export function defineRoutes(definition: RouteDefinition): RouteDefinition {
 }
 
 /** A router for one routes file. Attach middleware per route or per path, never `use("*")`. */
-export function createRouter(): OpenAPIHono<AppEnv> {
-	return new OpenAPIHono<AppEnv>({ defaultHook: validationHook });
+export function createRouter() {
+	return createTataraRouter<AppEnv>();
 }

package/templates/features/base/files/src/core/logging/logger.ts

@@ -1,17 +1,9 @@
+import { loggerOptions } from "@tatara/core";
 import { pino } from "pino";
 import { env } from "#core/config/env";
 
-export const logger = pino({
-	level: env.LOG_LEVEL,
-	base: { service: "__APP_NAME__" },
-	...(env.NODE_ENV === "development"
-		? {
-				transport: {
-					target: "pino-pretty",
-					options: { colorize: true, ignore: "pid,hostname,service" },
-				},
-			}
-		: {}),
-});
+export const logger = pino(
+	loggerOptions({ env: env.NODE_ENV, level: env.LOG_LEVEL, service: "__APP_NAME__" }),
+);
 
 export type Logger = typeof logger;

package/templates/features/base/files/src/modules/example/routes/greeting.routes.ts

@@ -1,5 +1,5 @@
 import { createRoute } from "@hono/zod-openapi";
-import { errorResponses, jsonContent, success, successSchema } from "#core/http/response";
+import { errorResponses, jsonContent, success, successSchema } from "@tatara/http";
 import { createRouter, defineRoutes } from "#core/http/routes";
 import { greet } from "#modules/example/services/greeting.service";
 import {

package/templates/features/db/files/src/core/db/commands/migrate.ts

@@ -1,4 +1,4 @@
-import { defineCommand } from "#core/commands/define";
+import { defineCommand } from "@tatara/core";
 import { env } from "#core/config/env";
 import { migrateDatabase } from "#core/db/migrate";
 

package/templates/features/db/files/src/core/db/commands/reset.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { defineCommand, flag } from "#core/commands/define";
+import { defineCommand, flag } from "@tatara/core";
 import { env } from "#core/config/env";
 import { dropAllTables } from "#core/db/admin";
 import { migrateDatabase } from "#core/db/migrate";

package/templates/features/db/files/src/core/db/commands/seed.ts

@@ -1,4 +1,4 @@
-import { defineCommand } from "#core/commands/define";
+import { defineCommand } from "@tatara/core";
 import { seeds } from "#generated/seeds";
 
 export default defineCommand({

package/templates/features/db/files/src/core/db/tests/reset.test.ts

@@ -1,5 +1,5 @@
 import { expect, it } from "vitest";
-import { parseFlags } from "#core/commands/runner";
+import { parseFlags } from "@tatara/core";
 import reset from "#core/db/commands/reset";
 
 it("does not treat --force false as forcing db:reset", () => {

package/templates/features/drizzle/files+mysql/src/core/db/client.ts

@@ -1,8 +1,8 @@
 import { drizzle } from "drizzle-orm/mysql2";
 import mysql from "mysql2/promise";
 import { env } from "#core/config/env";
-import { registerReadinessCheck } from "#core/http/health";
-import { onShutdown } from "#core/process/lifecycle";
+import { registerReadinessCheck } from "@tatara/core";
+import { onShutdown } from "@tatara/core";
 import * as schema from "#generated/schema";
 
 export const pool = mysql.createPool({ uri: env.DATABASE_URL, connectionLimit: env.DATABASE_POOL_MAX });

package/templates/features/drizzle/files+postgres/src/core/db/client.ts

@@ -1,8 +1,8 @@
 import { drizzle } from "drizzle-orm/node-postgres";
 import pg from "pg";
 import { env } from "#core/config/env";
-import { registerReadinessCheck } from "#core/http/health";
-import { onShutdown } from "#core/process/lifecycle";
+import { registerReadinessCheck } from "@tatara/core";
+import { onShutdown } from "@tatara/core";
 import * as schema from "#generated/schema";
 
 export const pool = new pg.Pool({ connectionString: env.DATABASE_URL, max: env.DATABASE_POOL_MAX });

package/templates/features/email/files/src/core/email/commands/send-test.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { defineCommand } from "#core/commands/define";
+import { defineCommand } from "@tatara/core";
 import { sendEmail } from "#core/email/send";
 
 export default defineCommand({

package/templates/features/jobs/files/src/apps/cron/index.ts

@@ -1,7 +1,7 @@
 import { Cron } from "croner";
 import { withLock } from "#core/jobs/lock";
 import { logger } from "#core/logging/logger";
-import { handleSignals, onShutdown } from "#core/process/lifecycle";
+import { handleSignals, onShutdown } from "@tatara/core";
 import { schedules } from "#generated/schedules";
 
 const jobs = schedules.map((schedule) => {
@@ -21,5 +21,5 @@ const jobs = schedules.map((schedule) => {
 onShutdown("cron", () => {
 	for (const job of jobs) job.stop();
 });
-handleSignals();
+handleSignals(logger);
 logger.info({ schedules: schedules.map((s) => `${s.name} (${s.cron})`) }, "cron started");

package/templates/features/jobs/files/src/apps/worker/index.ts

@@ -4,7 +4,7 @@ import { processJob } from "#core/jobs/process";
 import { QUEUE_NAME } from "#core/jobs/queue";
 import { redis } from "#core/jobs/redis";
 import { logger } from "#core/logging/logger";
-import { handleSignals, onShutdown } from "#core/process/lifecycle";
+import { handleSignals, onShutdown } from "@tatara/core";
 import { consumers } from "#generated/consumers";
 
 const worker = new Worker(
@@ -20,5 +20,5 @@ const worker = new Worker(
 
 worker.on("failed", (job, err) => logger.error({ err, jobId: job?.id, topic: job?.name }, "job failed"));
 onShutdown("worker", () => worker.close());
-handleSignals();
+handleSignals(logger);
 logger.info({ topics: consumers.map((c) => c.topic) }, "worker started");

package/templates/features/jobs/files/src/core/jobs/commands/enqueue.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { defineCommand } from "#core/commands/define";
+import { defineCommand } from "@tatara/core";
 import { enqueue } from "#core/jobs/queue";
 
 export default defineCommand({

package/templates/features/jobs/files/src/core/jobs/queue.ts

@@ -1,7 +1,7 @@
 import { type JobsOptions, Queue } from "bullmq";
 import { env } from "#core/config/env";
 import { redis } from "#core/jobs/redis";
-import { onShutdown } from "#core/process/lifecycle";
+import { onShutdown } from "@tatara/core";
 
 export const QUEUE_NAME = "__APP_NAME__-jobs";
 

package/templates/features/jobs/files/src/core/jobs/redis.ts

@@ -1,6 +1,6 @@
 import { Redis } from "ioredis";
 import { env } from "#core/config/env";
-import { onShutdown } from "#core/process/lifecycle";
+import { onShutdown } from "@tatara/core";
 
 let client: Redis | undefined;
 

package/templates/features/prisma/files+mysql/src/core/db/client.ts

@@ -1,8 +1,8 @@
 import { PrismaMariaDb } from "@prisma/adapter-mariadb";
 import { env } from "#core/config/env";
 import { connectionConfig } from "#core/db/admin";
-import { registerReadinessCheck } from "#core/http/health";
-import { onShutdown } from "#core/process/lifecycle";
+import { registerReadinessCheck } from "@tatara/core";
+import { onShutdown } from "@tatara/core";
 import { type Prisma, PrismaClient } from "#generated/prisma/client";
 
 export const db = new PrismaClient({

package/templates/features/prisma/files+postgres/src/core/db/client.ts

@@ -1,7 +1,7 @@
 import { PrismaPg } from "@prisma/adapter-pg";
 import { env } from "#core/config/env";
-import { registerReadinessCheck } from "#core/http/health";
-import { onShutdown } from "#core/process/lifecycle";
+import { registerReadinessCheck } from "@tatara/core";
+import { onShutdown } from "@tatara/core";
 import { type Prisma, PrismaClient } from "#generated/prisma/client";
 
 export const db = new PrismaClient({

package/templates/features/storage/files/src/core/storage/commands/check.ts

@@ -1,4 +1,4 @@
-import { defineCommand } from "#core/commands/define";
+import { defineCommand } from "@tatara/core";
 import { env } from "#core/config/env";
 import { storage } from "#core/storage/index";
 import { ensureBucket } from "#core/storage/s3";

package/templates/generators/command/files/src/modules/__moduleKebab__/commands/__nameKebab__.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { defineCommand, flag } from "#core/commands/define";
+import { defineCommand, flag } from "@tatara/core";
 
 export default defineCommand({
 	name: "__moduleKebab__:__nameKebab__",

package/templates/generators/module/files/src/modules/__moduleKebab__/routes/__moduleKebab__.routes.ts

@@ -1,5 +1,5 @@
 import { createRoute } from "@hono/zod-openapi";
-import { jsonContent, success, successSchema } from "#core/http/response";
+import { jsonContent, success, successSchema } from "@tatara/http";
 import { createRouter, defineRoutes } from "#core/http/routes";
 import { __moduleCamel__Status } from "#modules/__moduleKebab__/services/__moduleKebab__.service";
 import { __moduleCamel__StatusSchema } from "#modules/__moduleKebab__/validators/__moduleKebab__.validators";

package/templates/generators/resource/files/src/modules/__moduleKebab__/routes/__nameKebab__.routes.ts

@@ -8,7 +8,7 @@ import {
 	paginationQuerySchema,
 	success,
 	successSchema,
-} from "#core/http/response";
+} from "@tatara/http";
 import { createRouter, defineRoutes } from "#core/http/routes";
 // tatara:slot imports
 import {

package/templates/generators/resource/files+drizzle/src/modules/__moduleKebab__/services/__nameKebab__.service.ts

@@ -1,8 +1,8 @@
 import { count, desc, eq } from "drizzle-orm";
 import { db, type Executor } from "#core/db/client";
 import { newId } from "#core/db/id";
-import { NotFoundError } from "#core/http/errors";
-import type { PaginationQuery } from "#core/http/response";
+import { NotFoundError } from "@tatara/http";
+import type { PaginationQuery } from "@tatara/http";
 import { __namePluralCamel__ } from "#modules/__moduleKebab__/db/__nameKebab__.schema";
 import type {
 	Create__namePascal__Input,

package/templates/generators/resource/files+prisma/src/modules/__moduleKebab__/services/__nameKebab__.service.ts

@@ -1,7 +1,7 @@
 import { db, type Executor } from "#core/db/client";
 import { newId } from "#core/db/id";
-import { NotFoundError } from "#core/http/errors";
-import type { PaginationQuery } from "#core/http/response";
+import { NotFoundError } from "@tatara/http";
+import type { PaginationQuery } from "@tatara/http";
 import type {
 	Create__namePascal__Input,
 	__namePascal__,

package/templates/generators/route/files/src/modules/__moduleKebab__/routes/__nameKebab__.routes.ts

@@ -1,5 +1,5 @@
 import { createRoute } from "@hono/zod-openapi";
-import { errorResponses, jsonContent, success, successSchema } from "#core/http/response";
+import { errorResponses, jsonContent, success, successSchema } from "@tatara/http";
 import { createRouter, defineRoutes } from "#core/http/routes";
 // tatara:slot imports
 import {

package/templates/versions.json

@@ -30,5 +30,7 @@
   "@aws-sdk/client-s3": "3.1152.0",
   "@aws-sdk/s3-request-presigner": "3.1152.0",
   "nodemailer": "10.1.1",
-  "@types/nodemailer": "8.0.2"
+  "@types/nodemailer": "8.0.2",
+  "@tatara/core": "0.1.0",
+  "@tatara/http": "0.1.0"
 }

package/templates/features/base/files/src/core/commands/define.ts

@@ -1,33 +0,0 @@
-import { z } from "zod";
-import type { Logger } from "#core/logging/logger";
-
-export interface CommandContext {
-	logger: Logger;
-}
-
-export interface CommandDefinition<S extends z.ZodType = z.ZodType> {
-	/** `module:action`, e.g. "billing:recalculate" */
-	name: string;
-	description: string;
-	/** flags parsed from `--key value`; use z.coerce for numbers and `flag()` for booleans */
-	args?: S;
-	run(args: z.infer<S>, ctx: CommandContext): Promise<void> | void;
-}
-
-
-/** Default export of every `commands/*.ts`; discovered by `tatara sync`. */
-export function defineCommand<S extends z.ZodType = typeof noArgs>(
-	definition: CommandDefinition<S>,
-): CommandDefinition<S> {
-	return definition;
-}
-
-export const noArgs = z.object({});
-
-/**
- * A boolean flag: bare `--force` is true, `--force false|0|no|off` is false.
- * (`z.coerce.boolean()` would read the string "false" as true.)
- */
-export function flag() {
-	return z.union([z.boolean(), z.stringbool()]).default(false);
-}

package/templates/features/base/files/src/core/commands/runner.ts

@@ -1,54 +0,0 @@
-import type { CommandDefinition } from "#core/commands/define";
-import { logger } from "#core/logging/logger";
-
-/** Parses `--key value`, `--key=value` and bare `--flag` (true) into an object. */
-export function parseFlags(argv: string[]): Record<string, string | boolean> {
-	const flags: Record<string, string | boolean> = {};
-	for (let i = 0; i < argv.length; i++) {
-		const arg = argv[i] ?? "";
-		if (!arg.startsWith("--")) continue;
-		const [rawKey, inline] = arg.slice(2).split("=", 2);
-		const key = (rawKey ?? "").replace(/-([a-z])/g, (_, ch: string) => ch.toUpperCase());
-		if (inline !== undefined) {
-			flags[key] = inline;
-		} else if (argv[i + 1] !== undefined && !argv[i + 1]?.startsWith("--")) {
-			flags[key] = argv[i + 1] ?? "";
-			i++;
-		} else {
-			flags[key] = true;
-		}
-	}
-	return flags;
-}
-
-export async function runCommand(commands: CommandDefinition[], argv: string[]): Promise<number> {
-	const [name, ...rest] = argv;
-	if (!name || name === "--list" || name === "list" || name === "help") {
-		const width = Math.max(0, ...commands.map((c) => c.name.length));
-		console.log("Commands:");
-		for (const c of [...commands].sort((a, b) => a.name.localeCompare(b.name))) {
-			console.log(`  ${c.name.padEnd(width)}  ${c.description}`);
-		}
-		return 0;
-	}
-	const command = commands.find((c) => c.name === name);
-	if (!command) {
-		console.error(`Unknown command "${name}". Run with --list to see available commands.`);
-		return 1;
-	}
-	const parsed = (command.args ?? null)?.safeParse(parseFlags(rest));
-	if (parsed && !parsed.success) {
-		console.error(`Invalid arguments for ${name}:`);
-		for (const issue of parsed.error.issues) {
-			console.error(`  --${issue.path.join(".")}: ${issue.message}`);
-		}
-		return 1;
-	}
-	try {
-		await command.run(parsed ? parsed.data : {}, { logger: logger.child({ command: name }) });
-		return 0;
-	} catch (error) {
-		logger.error({ err: error, command: name }, "command failed");
-		return 1;
-	}
-}