theokit 0.5.3 → 0.6.0

package/dist/generate-ODDAYXNR.js

@@ -0,0 +1,494 @@
+#!/usr/bin/env node
+import "tsx/esm";
+import "./chunk-KT3MWNZG.js";
+
+// src/cli/commands/generate.ts
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { resolve as resolve2, dirname as dirname2 } from "path";
+
+// src/cli/commands/generate-resource.ts
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { resolve, dirname } from "path";
+var ALLOWED_FIELD_TYPES = /* @__PURE__ */ new Set(["string", "text", "number", "boolean"]);
+var RESERVED_FIELDS = /* @__PURE__ */ new Set(["id", "createdAt", "created_at"]);
+function parseResourceFields(args) {
+  if (args.length === 0) {
+    throw new Error(
+      "Resource requires at least one field. Example: theokit generate resource posts title:string"
+    );
+  }
+  return args.map((arg) => {
+    const parts = arg.split(":");
+    if (parts.length !== 2 || !parts[0] || !parts[1]) {
+      throw new Error(`Invalid field "${arg}". Use name:type format (e.g. title:string)`);
+    }
+    const [name, type] = parts;
+    if (!ALLOWED_FIELD_TYPES.has(type)) {
+      throw new Error(
+        `Unknown field type "${type}" in "${arg}". Valid types: ${[...ALLOWED_FIELD_TYPES].join(", ")}`
+      );
+    }
+    if (RESERVED_FIELDS.has(name)) {
+      throw new Error(`Field "${name}" is reserved (auto-generated by the framework)`);
+    }
+    const fieldType = type;
+    return {
+      name,
+      type: fieldType,
+      drizzleColumn: mapDrizzleColumn(name, fieldType),
+      zodType: mapZodType(fieldType)
+    };
+  });
+}
+function mapDrizzleColumn(name, type) {
+  switch (type) {
+    case "string":
+    case "text":
+      return `text('${name}').notNull()`;
+    case "number":
+      return `integer('${name}').notNull()`;
+    case "boolean":
+      return `integer('${name}', { mode: 'boolean' }).notNull().default(false)`;
+  }
+}
+function mapZodType(type) {
+  switch (type) {
+    case "string":
+    case "text":
+      return "z.string()";
+    case "number":
+      return "z.number()";
+    case "boolean":
+      return "z.boolean()";
+  }
+}
+function generateSchemaEntry(resourceName, fields) {
+  const cols = [
+    `  id: integer('id').primaryKey({ autoIncrement: true }),`,
+    ...fields.map((f) => `  ${f.name}: ${f.drizzleColumn},`),
+    `  createdAt: text('created_at')`,
+    `    .notNull()`,
+    `    .$defaultFn(() => new Date().toISOString().split('T')[0]),`
+  ];
+  return [
+    ``,
+    `export const ${resourceName} = sqliteTable('${resourceName}', {`,
+    ...cols,
+    `})`,
+    ``
+  ].join("\n");
+}
+function generateRouteIndex(resourceName, fields) {
+  const bodyFields = fields.map((f) => `    ${f.name}: ${f.zodType},`).join("\n");
+  return [
+    `import { defineRoute } from 'theokit/server/define'`,
+    `import { z } from 'zod'`,
+    `import { db } from '../../db/index.js'`,
+    `import { ${resourceName} } from '../../db/schema.js'`,
+    ``,
+    `export const GET = defineRoute({`,
+    `  handler: () => db.select().from(${resourceName}).all(),`,
+    `})`,
+    ``,
+    `export const POST = defineRoute({`,
+    `  body: z.object({`,
+    bodyFields,
+    `  }),`,
+    `  status: 201,`,
+    `  handler: ({ body }) => {`,
+    `    const result = db.insert(${resourceName}).values(body).returning().get()`,
+    `    return result`,
+    `  },`,
+    `})`,
+    ``
+  ].join("\n");
+}
+function generateRouteId(resourceName, fields) {
+  const updateFields = fields.map((f) => `    ${f.name}: ${f.zodType}.optional(),`).join("\n");
+  return [
+    `import { defineRoute } from 'theokit/server/define'`,
+    `import { z } from 'zod'`,
+    `import { db } from '../../db/index.js'`,
+    `import { ${resourceName} } from '../../db/schema.js'`,
+    `import { eq } from 'drizzle-orm'`,
+    ``,
+    `export const GET = defineRoute({`,
+    `  params: z.object({ id: z.coerce.number() }),`,
+    `  handler: ({ params }) => {`,
+    `    const item = db.select().from(${resourceName}).where(eq(${resourceName}.id, params.id)).get()`,
+    `    if (!item) return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })`,
+    `    return item`,
+    `  },`,
+    `})`,
+    ``,
+    `export const PUT = defineRoute({`,
+    `  params: z.object({ id: z.coerce.number() }),`,
+    `  body: z.object({`,
+    updateFields,
+    `  }),`,
+    `  handler: ({ params, body }) => {`,
+    `    const result = db.update(${resourceName}).set(body).where(eq(${resourceName}.id, params.id)).returning().get()`,
+    `    if (!result) return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })`,
+    `    return result`,
+    `  },`,
+    `})`,
+    ``,
+    `export const DELETE = defineRoute({`,
+    `  params: z.object({ id: z.coerce.number() }),`,
+    `  status: 204,`,
+    `  handler: ({ params }) => {`,
+    `    db.delete(${resourceName}).where(eq(${resourceName}.id, params.id)).run()`,
+    `  },`,
+    `})`,
+    ``
+  ].join("\n");
+}
+function generateTestTemplate(resourceName) {
+  return [
+    `import { describe, it, expect } from 'vitest'`,
+    ``,
+    `describe('${resourceName} API', () => {`,
+    `  it('should have a schema defined', async () => {`,
+    `    const schema = await import('../server/db/schema.js')`,
+    `    expect(schema.${resourceName}).toBeDefined()`,
+    `  })`,
+    ``,
+    `  it('should have route handlers', async () => {`,
+    `    const index = await import('../server/routes/${resourceName}/index.js')`,
+    `    expect(index.GET).toBeDefined()`,
+    `    expect(index.POST).toBeDefined()`,
+    `  })`,
+    `})`,
+    ``
+  ].join("\n");
+}
+function generateResource(cwd, name, fieldArgs) {
+  let fields;
+  try {
+    fields = parseResourceFields(fieldArgs);
+  } catch (err) {
+    return { status: "invalid_name", message: err instanceof Error ? err.message : String(err) };
+  }
+  const schemaPath = resolve(cwd, "server/db/schema.ts");
+  const routeIndexPath = resolve(cwd, `server/routes/${name}/index.ts`);
+  const routeIdPath = resolve(cwd, `server/routes/${name}/[id].ts`);
+  const testPath = resolve(cwd, `tests/${name}.test.ts`);
+  if (!existsSync(schemaPath)) {
+    return {
+      status: "not_a_project",
+      message: "server/db/schema.ts not found. Run this from a TheoKit project with database setup."
+    };
+  }
+  if (existsSync(routeIndexPath)) {
+    return { status: "already_exists", filePath: routeIndexPath, kind: "resource", name };
+  }
+  const existingSchema = readFileSync(schemaPath, "utf-8");
+  if (existingSchema.includes(`export const ${name} =`)) {
+    return {
+      status: "already_exists",
+      filePath: schemaPath,
+      kind: "resource",
+      name,
+      message: `Table "${name}" already exists in schema.ts`
+    };
+  }
+  appendFileSync(schemaPath, generateSchemaEntry(name, fields));
+  mkdirSync(dirname(routeIndexPath), { recursive: true });
+  writeFileSync(routeIndexPath, generateRouteIndex(name, fields));
+  writeFileSync(routeIdPath, generateRouteId(name, fields));
+  mkdirSync(dirname(testPath), { recursive: true });
+  if (!existsSync(testPath)) {
+    writeFileSync(testPath, generateTestTemplate(name));
+  }
+  return { status: "created", filePath: routeIndexPath, kind: "resource", name };
+}
+
+// src/cli/commands/generate-types.ts
+var VALID_TYPES = [
+  "route",
+  "action",
+  "page",
+  "ws",
+  "controller",
+  "agent",
+  "toolbox",
+  "resource"
+];
+
+// src/cli/commands/generate.ts
+function toKebabCase(name) {
+  return /^[a-z][a-z0-9/-]*$/.test(name);
+}
+var RESERVED_BASENAMES = /* @__PURE__ */ new Set([
+  "index",
+  "constructor",
+  "__proto__",
+  "prototype",
+  "hasOwnProperty"
+]);
+function hasReservedSegment(name) {
+  const basename = name.includes("/") ? name.split("/").pop() ?? name : name;
+  return RESERVED_BASENAMES.has(basename);
+}
+function isPathInside(cwd, targetSubpath) {
+  if (targetSubpath.includes("\0")) return false;
+  if (targetSubpath.startsWith("/") || targetSubpath.startsWith("\\")) return false;
+  const resolved = resolve2(cwd, targetSubpath);
+  const cwdResolved = resolve2(cwd);
+  const sep = process.platform === "win32" ? "\\" : "/";
+  return resolved === cwdResolved || resolved.startsWith(cwdResolved + sep);
+}
+function toPascalCase(name) {
+  return name.split(/[-/]/).map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+}
+function toCamelCase(name) {
+  const pascal = toPascalCase(name);
+  return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+function generateRouteTemplate(name) {
+  return [
+    `import { defineRoute } from 'theokit/server'`,
+    `import { z } from 'zod'`,
+    ``,
+    `export const GET = defineRoute({`,
+    `  handler: ({ ctx }) => {`,
+    `    return { message: 'TODO: implement ${name} GET' }`,
+    `  },`,
+    `})`,
+    ``
+  ].join("\n");
+}
+function generateControllerTemplate(name) {
+  const className = toPascalCase(name) + "Controller";
+  const baseName = name.split("/").pop() ?? name;
+  return [
+    `// AUTO-GENERATED by \`theokit generate controller ${name}\``,
+    `import { Controller, Get } from '@theokit/http'`,
+    ``,
+    `@Controller('${baseName}')`,
+    `export class ${className} {`,
+    `  @Get()`,
+    `  findAll(): string {`,
+    `    return 'This action returns all ${baseName}'`,
+    `  }`,
+    `}`,
+    ``
+  ].join("\n");
+}
+function generateActionTemplate(name) {
+  const camel = toCamelCase(name);
+  return [
+    `import { defineAction } from 'theokit/server'`,
+    `import { z } from 'zod'`,
+    ``,
+    `export const ${camel} = defineAction({`,
+    `  input: z.object({}),`,
+    `  handler: ({ input, ctx }) => {`,
+    `    return { message: 'TODO: implement ${name}' }`,
+    `  },`,
+    `})`,
+    ``
+  ].join("\n");
+}
+function generateAgentTemplate(name) {
+  const pascal = toPascalCase(name);
+  return [
+    `import 'reflect-metadata'`,
+    `import { Agent, MainLoop } from '@theokit/agents'`,
+    `import { UseGuards } from '@theokit/http'`,
+    ``,
+    `@Agent({`,
+    `  name: '${name}',`,
+    `  route: '/api/agents/${name}',`,
+    `  model: 'openai/gpt-4o-mini',`,
+    `  systemPrompt: 'You are a helpful ${name} assistant.',`,
+    `})`,
+    `export class ${pascal}Agent {`,
+    `  @MainLoop({ strategy: 'react', maxIterations: 5 })`,
+    `  async run() {}`,
+    `}`,
+    ``
+  ].join("\n");
+}
+function generateToolboxTemplate(name) {
+  const pascal = toPascalCase(name);
+  return [
+    `import 'reflect-metadata'`,
+    `import { z } from 'zod'`,
+    `import { Toolbox, Tool } from '@theokit/agents'`,
+    ``,
+    `@Toolbox({ namespace: '${name}' })`,
+    `export class ${pascal}Tools {`,
+    `  @Tool({`,
+    `    name: 'hello',`,
+    `    description: 'Say hello',`,
+    `    input: z.object({ name: z.string() }),`,
+    `  })`,
+    `  async hello(input: { name: string }) {`,
+    `    return \`Hello, \${input.name}!\``,
+    `  }`,
+    `}`,
+    ``
+  ].join("\n");
+}
+function resolveTemplate(cwd, type, name) {
+  switch (type) {
+    case "route":
+      return {
+        filePath: resolve2(cwd, "server/routes", `${name}.ts`),
+        content: generateRouteTemplate(name)
+      };
+    case "action":
+      return {
+        filePath: resolve2(cwd, "server/actions", `${name}.ts`),
+        content: generateActionTemplate(name)
+      };
+    case "page":
+      return { filePath: resolve2(cwd, `app/${name}/page.tsx`), content: generatePageTemplate(name) };
+    case "ws":
+      return {
+        filePath: resolve2(cwd, "server/ws", `${name}.ts`),
+        content: generateWsTemplate(name)
+      };
+    case "controller":
+      return {
+        filePath: resolve2(cwd, "server/controllers", `${name}.controller.ts`),
+        content: generateControllerTemplate(name)
+      };
+    case "agent":
+      return {
+        filePath: resolve2(cwd, "server/agents", `${name}.agent.ts`),
+        content: generateAgentTemplate(name)
+      };
+    case "toolbox":
+      return {
+        filePath: resolve2(cwd, "server/toolboxes", `${name}.tools.ts`),
+        content: generateToolboxTemplate(name)
+      };
+    default:
+      return null;
+  }
+}
+function generateActionTestTemplate(name) {
+  const camel = toCamelCase(name);
+  return [
+    `import { describe, it, expect } from 'vitest'`,
+    ``,
+    `import { ${camel} } from './${name.split("/").pop()}.js'`,
+    ``,
+    `describe('${name} action', () => {`,
+    `  it('should accept a valid input shape', () => {`,
+    `    expect(${camel}.input).toBeDefined()`,
+    `    expect(typeof ${camel}.handler).toBe('function')`,
+    `  })`,
+    ``,
+    `  it('should reject invalid input via zod schema', () => {`,
+    `    const parsed = ${camel}.input.safeParse({ __invalid: true })`,
+    `    // Empty object schema accepts {}; tighten this assertion when adding fields.`,
+    `    expect(parsed.success).toBe(true)`,
+    `  })`,
+    `})`,
+    ``
+  ].join("\n");
+}
+function generatePageTemplate(name) {
+  const pascal = toPascalCase(name);
+  return [`export default function ${pascal}Page() {`, `  return <h1>${pascal}</h1>`, `}`, ``].join(
+    "\n"
+  );
+}
+function generateWsTemplate(_name) {
+  return [
+    `import { defineWebSocket } from 'theokit/server'`,
+    ``,
+    `export default defineWebSocket({`,
+    `  onMessage(ws, data) {`,
+    `    ws.send(\`echo: \${data}\`)`,
+    `  },`,
+    `})`,
+    ``
+  ].join("\n");
+}
+async function generate(opts) {
+  const { cwd, type, name } = opts;
+  if (!existsSync2(resolve2(cwd, "theo.config.ts")) && !existsSync2(resolve2(cwd, "theo.config.js"))) {
+    return {
+      status: "not_a_project",
+      message: "Not a Theo project. cwd has no theo.config.ts or theo.config.js"
+    };
+  }
+  if (!VALID_TYPES.includes(type)) {
+    return {
+      status: "invalid_kind",
+      message: `Invalid generator type "${type}". Available: ${VALID_TYPES.join(", ")}`
+    };
+  }
+  if (!name || !toKebabCase(name)) {
+    return {
+      status: "invalid_name",
+      message: `Invalid name "${name}". Use kebab-case: lowercase letters, numbers, hyphens.`
+    };
+  }
+  if (hasReservedSegment(name)) {
+    return {
+      status: "invalid_name",
+      message: `Reserved name "${name}" \u2014 basename collides with built-in identifier (index/constructor/__proto__/prototype/hasOwnProperty).`
+    };
+  }
+  if (type === "resource") {
+    return generateResource(cwd, name, opts.fields ?? []);
+  }
+  const resolved = resolveTemplate(cwd, type, name);
+  if (resolved === null) {
+    return { status: "invalid_kind", message: `Unknown type: ${type}` };
+  }
+  const { filePath, content } = resolved;
+  const relativeFromCwd = filePath.startsWith(resolve2(cwd)) ? filePath.slice(resolve2(cwd).length + 1) : filePath;
+  if (!isPathInside(cwd, relativeFromCwd)) {
+    return {
+      status: "invalid_name",
+      message: `Path traversal denied: "${name}" would escape project root.`
+    };
+  }
+  if (existsSync2(filePath)) {
+    return { status: "already_exists", filePath, kind: type, name };
+  }
+  mkdirSync2(dirname2(filePath), { recursive: true });
+  writeFileSync2(filePath, content);
+  if (type === "action") {
+    const testPath = filePath.replace(/\.ts$/, ".test.ts");
+    if (!existsSync2(testPath)) {
+      writeFileSync2(testPath, generateActionTestTemplate(name));
+    }
+  }
+  return { status: "created", filePath, kind: type, name };
+}
+async function generateCommand(type, name, fields) {
+  const result = await generate({ cwd: process.cwd(), type, name, fields });
+  switch (result.status) {
+    case "not_a_project":
+      throw new Error("Not a Theo project. Run this from a project root with theo.config.ts");
+    case "invalid_kind":
+      throw new Error(result.message ?? "Invalid kind");
+    case "invalid_name":
+      throw new Error(
+        `Invalid name "${name}". Use kebab-case: lowercase letters, numbers, hyphens. Example: my-route`
+      );
+    case "already_exists":
+      console.log(`
+  \u26A0 ${result.filePath} already exists. Skipping.
+`);
+      return;
+    case "created":
+      console.log(`
+  \u2713 Created ${type}: ${result.filePath}
+`);
+      return;
+  }
+}
+export {
+  VALID_TYPES,
+  generate,
+  generateCommand
+};
+//# sourceMappingURL=generate-ODDAYXNR.js.map

package/dist/generate-ODDAYXNR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/generate.ts","../src/cli/commands/generate-resource.ts","../src/cli/commands/generate-types.ts"],"sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from 'node:fs'\nimport { resolve, dirname } from 'node:path'\n\nimport { generateResource } from './generate-resource.js'\nimport {\n  VALID_TYPES,\n  type GeneratorType,\n  type GenerateOptions,\n  type GenerateStatus,\n  type GenerateResult,\n} from './generate-types.js'\n\nexport {\n  VALID_TYPES,\n  type GeneratorType,\n  type GenerateOptions,\n  type GenerateStatus,\n  type GenerateResult,\n}\n\nfunction toKebabCase(name: string): boolean {\n  return /^[a-z][a-z0-9/-]*$/.test(name)\n}\n\n/**\n * Reserved JS identifier names that conflict with object prototype machinery\n * or would shadow built-in module shapes if used as action/route names.\n * Mirrors action-scan's RESERVED_NAMES (T1.4).\n */\nconst RESERVED_BASENAMES = new Set([\n  'index',\n  'constructor',\n  '__proto__',\n  'prototype',\n  'hasOwnProperty',\n])\n\n/**\n * Validate that a name segment doesn't hit the reserved-identifier list.\n * Checks the BASENAME (last `/` segment) — nested `admin/constructor` still\n * rejected because the file `constructor.ts` would be the conflict.\n */\nfunction hasReservedSegment(name: string): boolean {\n  const basename = name.includes('/') ? (name.split('/').pop() ?? name) : name\n  return RESERVED_BASENAMES.has(basename)\n}\n\n/**\n * EC-4: validate that resolving `targetSubpath` under `cwd` stays inside `cwd`.\n * Returns `true` when path is safe (stays inside), `false` when it escapes via\n * `..`, absolute path, null byte, or similar traversal vector.\n */\nfunction isPathInside(cwd: string, targetSubpath: string): boolean {\n  if (targetSubpath.includes('\\x00')) return false\n  if (targetSubpath.startsWith('/') || targetSubpath.startsWith('\\\\')) return false\n  const resolved = resolve(cwd, targetSubpath)\n  const cwdResolved = resolve(cwd)\n  const sep = process.platform === 'win32' ? '\\\\' : '/'\n  return resolved === cwdResolved || resolved.startsWith(cwdResolved + sep)\n}\n\nfunction toPascalCase(name: string): string {\n  return name\n    .split(/[-/]/)\n    .map((s) => s.charAt(0).toUpperCase() + s.slice(1))\n    .join('')\n}\n\nfunction toCamelCase(name: string): string {\n  const pascal = toPascalCase(name)\n  return pascal.charAt(0).toLowerCase() + pascal.slice(1)\n}\n\nfunction generateRouteTemplate(name: string): string {\n  return [\n    `import { defineRoute } from 'theokit/server'`,\n    `import { z } from 'zod'`,\n    ``,\n    `export const GET = defineRoute({`,\n    `  handler: ({ ctx }) => {`,\n    `    return { message: 'TODO: implement ${name} GET' }`,\n    `  },`,\n    `})`,\n    ``,\n  ].join('\\n')\n}\n\nfunction generateControllerTemplate(name: string): string {\n  const className = toPascalCase(name) + 'Controller'\n  const baseName = name.split('/').pop() ?? name\n  return [\n    `// AUTO-GENERATED by \\`theokit generate controller ${name}\\``,\n    `import { Controller, Get } from '@theokit/http'`,\n    ``,\n    `@Controller('${baseName}')`,\n    `export class ${className} {`,\n    `  @Get()`,\n    `  findAll(): string {`,\n    `    return 'This action returns all ${baseName}'`,\n    `  }`,\n    `}`,\n    ``,\n  ].join('\\n')\n}\n\nfunction generateActionTemplate(name: string): string {\n  const camel = toCamelCase(name)\n  return [\n    `import { defineAction } from 'theokit/server'`,\n    `import { z } from 'zod'`,\n    ``,\n    `export const ${camel} = defineAction({`,\n    `  input: z.object({}),`,\n    `  handler: ({ input, ctx }) => {`,\n    `    return { message: 'TODO: implement ${name}' }`,\n    `  },`,\n    `})`,\n    ``,\n  ].join('\\n')\n}\n\n/**\n * Co-located test template for `theokit generate action <name>` (T5.2 +\n * plan Q4 cenário 1: roundtrip serialize). Skeleton uses vitest BDD shape\n * per testing.md.\n */\nfunction generateAgentTemplate(name: string): string {\n  const pascal = toPascalCase(name)\n  return [\n    `import 'reflect-metadata'`,\n    `import { Agent, MainLoop } from '@theokit/agents'`,\n    `import { UseGuards } from '@theokit/http'`,\n    ``,\n    `@Agent({`,\n    `  name: '${name}',`,\n    `  route: '/api/agents/${name}',`,\n    `  model: 'openai/gpt-4o-mini',`,\n    `  systemPrompt: 'You are a helpful ${name} assistant.',`,\n    `})`,\n    `export class ${pascal}Agent {`,\n    `  @MainLoop({ strategy: 'react', maxIterations: 5 })`,\n    `  async run() {}`,\n    `}`,\n    ``,\n  ].join('\\n')\n}\n\nfunction generateToolboxTemplate(name: string): string {\n  const pascal = toPascalCase(name)\n  return [\n    `import 'reflect-metadata'`,\n    `import { z } from 'zod'`,\n    `import { Toolbox, Tool } from '@theokit/agents'`,\n    ``,\n    `@Toolbox({ namespace: '${name}' })`,\n    `export class ${pascal}Tools {`,\n    `  @Tool({`,\n    `    name: 'hello',`,\n    `    description: 'Say hello',`,\n    `    input: z.object({ name: z.string() }),`,\n    `  })`,\n    `  async hello(input: { name: string }) {`,\n    `    return \\`Hello, \\${input.name}!\\``,\n    `  }`,\n    `}`,\n    ``,\n  ].join('\\n')\n}\n\nfunction resolveTemplate(\n  cwd: string,\n  type: GeneratorType,\n  name: string,\n): { filePath: string; content: string } | null {\n  switch (type) {\n    case 'route':\n      return {\n        filePath: resolve(cwd, 'server/routes', `${name}.ts`),\n        content: generateRouteTemplate(name),\n      }\n    case 'action':\n      return {\n        filePath: resolve(cwd, 'server/actions', `${name}.ts`),\n        content: generateActionTemplate(name),\n      }\n    case 'page':\n      return { filePath: resolve(cwd, `app/${name}/page.tsx`), content: generatePageTemplate(name) }\n    case 'ws':\n      return {\n        filePath: resolve(cwd, 'server/ws', `${name}.ts`),\n        content: generateWsTemplate(name),\n      }\n    case 'controller':\n      return {\n        filePath: resolve(cwd, 'server/controllers', `${name}.controller.ts`),\n        content: generateControllerTemplate(name),\n      }\n    case 'agent':\n      return {\n        filePath: resolve(cwd, 'server/agents', `${name}.agent.ts`),\n        content: generateAgentTemplate(name),\n      }\n    case 'toolbox':\n      return {\n        filePath: resolve(cwd, 'server/toolboxes', `${name}.tools.ts`),\n        content: generateToolboxTemplate(name),\n      }\n    default:\n      return null\n  }\n}\n\nfunction generateActionTestTemplate(name: string): string {\n  const camel = toCamelCase(name)\n  return [\n    `import { describe, it, expect } from 'vitest'`,\n    ``,\n    `import { ${camel} } from './${name.split('/').pop()}.js'`,\n    ``,\n    `describe('${name} action', () => {`,\n    `  it('should accept a valid input shape', () => {`,\n    `    expect(${camel}.input).toBeDefined()`,\n    `    expect(typeof ${camel}.handler).toBe('function')`,\n    `  })`,\n    ``,\n    `  it('should reject invalid input via zod schema', () => {`,\n    `    const parsed = ${camel}.input.safeParse({ __invalid: true })`,\n    `    // Empty object schema accepts {}; tighten this assertion when adding fields.`,\n    `    expect(parsed.success).toBe(true)`,\n    `  })`,\n    `})`,\n    ``,\n  ].join('\\n')\n}\n\nfunction generatePageTemplate(name: string): string {\n  const pascal = toPascalCase(name)\n  return [`export default function ${pascal}Page() {`, `  return <h1>${pascal}</h1>`, `}`, ``].join(\n    '\\n',\n  )\n}\n\nfunction generateWsTemplate(_name: string): string {\n  return [\n    `import { defineWebSocket } from 'theokit/server'`,\n    ``,\n    `export default defineWebSocket({`,\n    `  onMessage(ws, data) {`,\n    `    ws.send(\\`echo: \\${data}\\`)`,\n    `  },`,\n    `})`,\n    ``,\n  ].join('\\n')\n}\n\n/**\n * Programmatic generate. Returns a structured result instead of throwing —\n * Studio (`theokit_generate` tool) consumes this directly. The CLI wrapper\n * below maps the structured result to console output + exit code semantics.\n */\n// eslint-disable-next-line @typescript-eslint/require-await\nexport async function generate(opts: GenerateOptions): Promise<GenerateResult> {\n  const { cwd, type, name } = opts\n\n  if (!existsSync(resolve(cwd, 'theo.config.ts')) && !existsSync(resolve(cwd, 'theo.config.js'))) {\n    return {\n      status: 'not_a_project',\n      message: 'Not a Theo project. cwd has no theo.config.ts or theo.config.js',\n    }\n  }\n\n  if (!VALID_TYPES.includes(type as GeneratorType)) {\n    return {\n      status: 'invalid_kind',\n      message: `Invalid generator type \"${type}\". Available: ${VALID_TYPES.join(', ')}`,\n    }\n  }\n\n  if (!name || !toKebabCase(name)) {\n    return {\n      status: 'invalid_name',\n      message: `Invalid name \"${name}\". Use kebab-case: lowercase letters, numbers, hyphens.`,\n    }\n  }\n\n  // EC-2-related: reject reserved JS identifier basenames (would shadow\n  // built-in prototype machinery in virtual module emit or scan).\n  if (hasReservedSegment(name)) {\n    return {\n      status: 'invalid_name',\n      message: `Reserved name \"${name}\" — basename collides with built-in identifier (index/constructor/__proto__/prototype/hasOwnProperty).`,\n    }\n  }\n\n  // Resource generates multiple files — handle separately\n  if (type === 'resource') {\n    return generateResource(cwd, name, opts.fields ?? [])\n  }\n\n  const resolved = resolveTemplate(cwd, type as GeneratorType, name)\n  if (resolved === null) {\n    return { status: 'invalid_kind', message: `Unknown type: ${type}` }\n  }\n  const { filePath, content } = resolved\n\n  // EC-4: confirm the resolved filePath stays inside cwd. `toKebabCase`\n  // already rejects most traversal vectors but a defense-in-depth check\n  // against `..` slipping in via valid-looking segments is cheap.\n  const relativeFromCwd = filePath.startsWith(resolve(cwd))\n    ? filePath.slice(resolve(cwd).length + 1)\n    : filePath\n  if (!isPathInside(cwd, relativeFromCwd)) {\n    return {\n      status: 'invalid_name',\n      message: `Path traversal denied: \"${name}\" would escape project root.`,\n    }\n  }\n\n  if (existsSync(filePath)) {\n    return { status: 'already_exists', filePath, kind: type as GeneratorType, name }\n  }\n\n  mkdirSync(dirname(filePath), { recursive: true })\n  writeFileSync(filePath, content)\n\n  // T5.2 + plan Q4: emit co-located test file alongside actions (only\n  // for action type; routes/pages/ws keep prior single-file behavior).\n  // Skip if existing test file present (preserve user-customized tests).\n  if (type === 'action') {\n    const testPath = filePath.replace(/\\.ts$/, '.test.ts')\n    if (!existsSync(testPath)) {\n      writeFileSync(testPath, generateActionTestTemplate(name))\n    }\n  }\n\n  return { status: 'created', filePath, kind: type as GeneratorType, name }\n}\n\n/**\n * CLI entry point — preserves the original surface (throws + console.log).\n * Wraps the programmatic `generate` function.\n */\nexport async function generateCommand(\n  type: string,\n  name: string,\n  fields?: string[],\n): Promise<void> {\n  const result = await generate({ cwd: process.cwd(), type, name, fields })\n  switch (result.status) {\n    case 'not_a_project':\n      throw new Error('Not a Theo project. Run this from a project root with theo.config.ts')\n    case 'invalid_kind':\n      throw new Error(result.message ?? 'Invalid kind')\n    case 'invalid_name':\n      throw new Error(\n        `Invalid name \"${name}\". Use kebab-case: lowercase letters, numbers, hyphens. Example: my-route`,\n      )\n    case 'already_exists':\n      console.log(`\\n  ⚠ ${result.filePath} already exists. Skipping.\\n`)\n      return\n    case 'created':\n      console.log(`\\n  ✓ Created ${type}: ${result.filePath}\\n`)\n      return\n  }\n}\n","import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { resolve, dirname } from 'node:path'\n\nimport type { GenerateResult } from './generate-types.js'\n\n// --- Field parsing ---\n\nconst ALLOWED_FIELD_TYPES = new Set(['string', 'text', 'number', 'boolean'])\nconst RESERVED_FIELDS = new Set(['id', 'createdAt', 'created_at'])\n\nexport interface ResourceField {\n  name: string\n  type: 'string' | 'text' | 'number' | 'boolean'\n  drizzleColumn: string\n  zodType: string\n}\n\nexport function parseResourceFields(args: string[]): ResourceField[] {\n  if (args.length === 0) {\n    throw new Error(\n      'Resource requires at least one field. Example: theokit generate resource posts title:string',\n    )\n  }\n  return args.map((arg) => {\n    const parts = arg.split(':')\n    if (parts.length !== 2 || !parts[0] || !parts[1]) {\n      throw new Error(`Invalid field \"${arg}\". Use name:type format (e.g. title:string)`)\n    }\n    const [name, type] = parts\n    if (!ALLOWED_FIELD_TYPES.has(type)) {\n      throw new Error(\n        `Unknown field type \"${type}\" in \"${arg}\". Valid types: ${[...ALLOWED_FIELD_TYPES].join(', ')}`,\n      )\n    }\n    if (RESERVED_FIELDS.has(name)) {\n      throw new Error(`Field \"${name}\" is reserved (auto-generated by the framework)`)\n    }\n    const fieldType = type as ResourceField['type']\n    return {\n      name,\n      type: fieldType,\n      drizzleColumn: mapDrizzleColumn(name, fieldType),\n      zodType: mapZodType(fieldType),\n    }\n  })\n}\n\n// --- Column / type mapping ---\n\nfunction mapDrizzleColumn(name: string, type: ResourceField['type']): string {\n  switch (type) {\n    case 'string':\n    case 'text':\n      return `text('${name}').notNull()`\n    case 'number':\n      return `integer('${name}').notNull()`\n    case 'boolean':\n      return `integer('${name}', { mode: 'boolean' }).notNull().default(false)`\n  }\n}\n\nfunction mapZodType(type: ResourceField['type']): string {\n  switch (type) {\n    case 'string':\n    case 'text':\n      return 'z.string()'\n    case 'number':\n      return 'z.number()'\n    case 'boolean':\n      return 'z.boolean()'\n  }\n}\n\n// --- Template generators ---\n\nfunction generateSchemaEntry(resourceName: string, fields: ResourceField[]): string {\n  const cols = [\n    `  id: integer('id').primaryKey({ autoIncrement: true }),`,\n    ...fields.map((f) => `  ${f.name}: ${f.drizzleColumn},`),\n    `  createdAt: text('created_at')`,\n    `    .notNull()`,\n    `    .$defaultFn(() => new Date().toISOString().split('T')[0]),`,\n  ]\n  return [\n    ``,\n    `export const ${resourceName} = sqliteTable('${resourceName}', {`,\n    ...cols,\n    `})`,\n    ``,\n  ].join('\\n')\n}\n\nfunction generateRouteIndex(resourceName: string, fields: ResourceField[]): string {\n  const bodyFields = fields.map((f) => `    ${f.name}: ${f.zodType},`).join('\\n')\n  return [\n    `import { defineRoute } from 'theokit/server/define'`,\n    `import { z } from 'zod'`,\n    `import { db } from '../../db/index.js'`,\n    `import { ${resourceName} } from '../../db/schema.js'`,\n    ``,\n    `export const GET = defineRoute({`,\n    `  handler: () => db.select().from(${resourceName}).all(),`,\n    `})`,\n    ``,\n    `export const POST = defineRoute({`,\n    `  body: z.object({`,\n    bodyFields,\n    `  }),`,\n    `  status: 201,`,\n    `  handler: ({ body }) => {`,\n    `    const result = db.insert(${resourceName}).values(body).returning().get()`,\n    `    return result`,\n    `  },`,\n    `})`,\n    ``,\n  ].join('\\n')\n}\n\nfunction generateRouteId(resourceName: string, fields: ResourceField[]): string {\n  const updateFields = fields.map((f) => `    ${f.name}: ${f.zodType}.optional(),`).join('\\n')\n  return [\n    `import { defineRoute } from 'theokit/server/define'`,\n    `import { z } from 'zod'`,\n    `import { db } from '../../db/index.js'`,\n    `import { ${resourceName} } from '../../db/schema.js'`,\n    `import { eq } from 'drizzle-orm'`,\n    ``,\n    `export const GET = defineRoute({`,\n    `  params: z.object({ id: z.coerce.number() }),`,\n    `  handler: ({ params }) => {`,\n    `    const item = db.select().from(${resourceName}).where(eq(${resourceName}.id, params.id)).get()`,\n    `    if (!item) return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })`,\n    `    return item`,\n    `  },`,\n    `})`,\n    ``,\n    `export const PUT = defineRoute({`,\n    `  params: z.object({ id: z.coerce.number() }),`,\n    `  body: z.object({`,\n    updateFields,\n    `  }),`,\n    `  handler: ({ params, body }) => {`,\n    `    const result = db.update(${resourceName}).set(body).where(eq(${resourceName}.id, params.id)).returning().get()`,\n    `    if (!result) return new Response(JSON.stringify({ error: 'Not found' }), { status: 404 })`,\n    `    return result`,\n    `  },`,\n    `})`,\n    ``,\n    `export const DELETE = defineRoute({`,\n    `  params: z.object({ id: z.coerce.number() }),`,\n    `  status: 204,`,\n    `  handler: ({ params }) => {`,\n    `    db.delete(${resourceName}).where(eq(${resourceName}.id, params.id)).run()`,\n    `  },`,\n    `})`,\n    ``,\n  ].join('\\n')\n}\n\nfunction generateTestTemplate(resourceName: string): string {\n  return [\n    `import { describe, it, expect } from 'vitest'`,\n    ``,\n    `describe('${resourceName} API', () => {`,\n    `  it('should have a schema defined', async () => {`,\n    `    const schema = await import('../server/db/schema.js')`,\n    `    expect(schema.${resourceName}).toBeDefined()`,\n    `  })`,\n    ``,\n    `  it('should have route handlers', async () => {`,\n    `    const index = await import('../server/routes/${resourceName}/index.js')`,\n    `    expect(index.GET).toBeDefined()`,\n    `    expect(index.POST).toBeDefined()`,\n    `  })`,\n    `})`,\n    ``,\n  ].join('\\n')\n}\n\n// --- Orchestrator ---\n\nexport function generateResource(cwd: string, name: string, fieldArgs: string[]): GenerateResult {\n  let fields: ResourceField[]\n  try {\n    fields = parseResourceFields(fieldArgs)\n  } catch (err) {\n    return { status: 'invalid_name', message: err instanceof Error ? err.message : String(err) }\n  }\n\n  const schemaPath = resolve(cwd, 'server/db/schema.ts')\n  const routeIndexPath = resolve(cwd, `server/routes/${name}/index.ts`)\n  const routeIdPath = resolve(cwd, `server/routes/${name}/[id].ts`)\n  const testPath = resolve(cwd, `tests/${name}.test.ts`)\n\n  if (!existsSync(schemaPath)) {\n    return {\n      status: 'not_a_project',\n      message:\n        'server/db/schema.ts not found. Run this from a TheoKit project with database setup.',\n    }\n  }\n\n  if (existsSync(routeIndexPath)) {\n    return { status: 'already_exists', filePath: routeIndexPath, kind: 'resource', name }\n  }\n\n  const existingSchema = readFileSync(schemaPath, 'utf-8')\n  if (existingSchema.includes(`export const ${name} =`)) {\n    return {\n      status: 'already_exists',\n      filePath: schemaPath,\n      kind: 'resource',\n      name,\n      message: `Table \"${name}\" already exists in schema.ts`,\n    }\n  }\n\n  // 1. Append schema entry\n  appendFileSync(schemaPath, generateSchemaEntry(name, fields))\n\n  // 2. Create route files\n  mkdirSync(dirname(routeIndexPath), { recursive: true })\n  writeFileSync(routeIndexPath, generateRouteIndex(name, fields))\n  writeFileSync(routeIdPath, generateRouteId(name, fields))\n\n  // 3. Create test file\n  mkdirSync(dirname(testPath), { recursive: true })\n  if (!existsSync(testPath)) {\n    writeFileSync(testPath, generateTestTemplate(name))\n  }\n\n  return { status: 'created', filePath: routeIndexPath, kind: 'resource', name }\n}\n","/**\n * Shared types for the `theokit generate` CLI command family.\n *\n * Extracted to break the circular dependency between generate.ts ↔ generate-resource.ts\n * (architecture-remediation plan T1.1, 2026-06-12).\n */\n\nexport const VALID_TYPES = [\n  'route',\n  'action',\n  'page',\n  'ws',\n  'controller',\n  'agent',\n  'toolbox',\n  'resource',\n] as const\nexport type GeneratorType = (typeof VALID_TYPES)[number]\n\nexport interface GenerateOptions {\n  cwd: string\n  type: string\n  name: string\n  fields?: string[]\n}\n\nexport type GenerateStatus =\n  | 'created'\n  | 'already_exists'\n  | 'invalid_kind'\n  | 'invalid_name'\n  | 'not_a_project'\n\nexport interface GenerateResult {\n  status: GenerateStatus\n  filePath?: string\n  kind?: GeneratorType\n  name?: string\n  message?: string\n}\n"],"mappings":";;;;;AAAA,SAAS,cAAAA,aAAY,aAAAC,YAAW,iBAAAC,sBAAqB;AACrD,SAAS,WAAAC,UAAS,WAAAC,gBAAe;;;ACDjC,SAAS,gBAAgB,YAAY,WAAW,cAAc,qBAAqB;AACnF,SAAS,SAAS,eAAe;AAMjC,IAAM,sBAAsB,oBAAI,IAAI,CAAC,UAAU,QAAQ,UAAU,SAAS,CAAC;AAC3E,IAAM,kBAAkB,oBAAI,IAAI,CAAC,MAAM,aAAa,YAAY,CAAC;AAS1D,SAAS,oBAAoB,MAAiC;AACnE,MAAI,KAAK,WAAW,GAAG;AACrB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO,KAAK,IAAI,CAAC,QAAQ;AACvB,UAAM,QAAQ,IAAI,MAAM,GAAG;AAC3B,QAAI,MAAM,WAAW,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;AAChD,YAAM,IAAI,MAAM,kBAAkB,GAAG,6CAA6C;AAAA,IACpF;AACA,UAAM,CAAC,MAAM,IAAI,IAAI;AACrB,QAAI,CAAC,oBAAoB,IAAI,IAAI,GAAG;AAClC,YAAM,IAAI;AAAA,QACR,uBAAuB,IAAI,SAAS,GAAG,mBAAmB,CAAC,GAAG,mBAAmB,EAAE,KAAK,IAAI,CAAC;AAAA,MAC/F;AAAA,IACF;AACA,QAAI,gBAAgB,IAAI,IAAI,GAAG;AAC7B,YAAM,IAAI,MAAM,UAAU,IAAI,iDAAiD;AAAA,IACjF;AACA,UAAM,YAAY;AAClB,WAAO;AAAA,MACL;AAAA,MACA,MAAM;AAAA,MACN,eAAe,iBAAiB,MAAM,SAAS;AAAA,MAC/C,SAAS,WAAW,SAAS;AAAA,IAC/B;AAAA,EACF,CAAC;AACH;AAIA,SAAS,iBAAiB,MAAc,MAAqC;AAC3E,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AACH,aAAO,SAAS,IAAI;AAAA,IACtB,KAAK;AACH,aAAO,YAAY,IAAI;AAAA,IACzB,KAAK;AACH,aAAO,YAAY,IAAI;AAAA,EAC3B;AACF;AAEA,SAAS,WAAW,MAAqC;AACvD,UAAQ,MAAM;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,EACX;AACF;AAIA,SAAS,oBAAoB,cAAsB,QAAiC;AAClF,QAAM,OAAO;AAAA,IACX;AAAA,IACA,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,EAAE,IAAI,KAAK,EAAE,aAAa,GAAG;AAAA,IACvD;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,YAAY,mBAAmB,YAAY;AAAA,IAC3D,GAAG;AAAA,IACH;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,mBAAmB,cAAsB,QAAiC;AACjF,QAAM,aAAa,OAAO,IAAI,CAAC,MAAM,OAAO,EAAE,IAAI,KAAK,EAAE,OAAO,GAAG,EAAE,KAAK,IAAI;AAC9E,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY,YAAY;AAAA,IACxB;AAAA,IACA;AAAA,IACA,qCAAqC,YAAY;AAAA,IACjD;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,gCAAgC,YAAY;AAAA,IAC5C;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,gBAAgB,cAAsB,QAAiC;AAC9E,QAAM,eAAe,OAAO,IAAI,CAAC,MAAM,OAAO,EAAE,IAAI,KAAK,EAAE,OAAO,cAAc,EAAE,KAAK,IAAI;AAC3F,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY,YAAY;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,qCAAqC,YAAY,cAAc,YAAY;AAAA,IAC3E;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,gCAAgC,YAAY,wBAAwB,YAAY;AAAA,IAChF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,iBAAiB,YAAY,cAAc,YAAY;AAAA,IACvD;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,qBAAqB,cAA8B;AAC1D,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,aAAa,YAAY;AAAA,IACzB;AAAA,IACA;AAAA,IACA,qBAAqB,YAAY;AAAA,IACjC;AAAA,IACA;AAAA,IACA;AAAA,IACA,oDAAoD,YAAY;AAAA,IAChE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAIO,SAAS,iBAAiB,KAAa,MAAc,WAAqC;AAC/F,MAAI;AACJ,MAAI;AACF,aAAS,oBAAoB,SAAS;AAAA,EACxC,SAAS,KAAK;AACZ,WAAO,EAAE,QAAQ,gBAAgB,SAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,EAAE;AAAA,EAC7F;AAEA,QAAM,aAAa,QAAQ,KAAK,qBAAqB;AACrD,QAAM,iBAAiB,QAAQ,KAAK,iBAAiB,IAAI,WAAW;AACpE,QAAM,cAAc,QAAQ,KAAK,iBAAiB,IAAI,UAAU;AAChE,QAAM,WAAW,QAAQ,KAAK,SAAS,IAAI,UAAU;AAErD,MAAI,CAAC,WAAW,UAAU,GAAG;AAC3B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SACE;AAAA,IACJ;AAAA,EACF;AAEA,MAAI,WAAW,cAAc,GAAG;AAC9B,WAAO,EAAE,QAAQ,kBAAkB,UAAU,gBAAgB,MAAM,YAAY,KAAK;AAAA,EACtF;AAEA,QAAM,iBAAiB,aAAa,YAAY,OAAO;AACvD,MAAI,eAAe,SAAS,gBAAgB,IAAI,IAAI,GAAG;AACrD,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,MAAM;AAAA,MACN;AAAA,MACA,SAAS,UAAU,IAAI;AAAA,IACzB;AAAA,EACF;AAGA,iBAAe,YAAY,oBAAoB,MAAM,MAAM,CAAC;AAG5D,YAAU,QAAQ,cAAc,GAAG,EAAE,WAAW,KAAK,CAAC;AACtD,gBAAc,gBAAgB,mBAAmB,MAAM,MAAM,CAAC;AAC9D,gBAAc,aAAa,gBAAgB,MAAM,MAAM,CAAC;AAGxD,YAAU,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAChD,MAAI,CAAC,WAAW,QAAQ,GAAG;AACzB,kBAAc,UAAU,qBAAqB,IAAI,CAAC;AAAA,EACpD;AAEA,SAAO,EAAE,QAAQ,WAAW,UAAU,gBAAgB,MAAM,YAAY,KAAK;AAC/E;;;ACjOO,IAAM,cAAc;AAAA,EACzB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;AFIA,SAAS,YAAY,MAAuB;AAC1C,SAAO,qBAAqB,KAAK,IAAI;AACvC;AAOA,IAAM,qBAAqB,oBAAI,IAAI;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAOD,SAAS,mBAAmB,MAAuB;AACjD,QAAM,WAAW,KAAK,SAAS,GAAG,IAAK,KAAK,MAAM,GAAG,EAAE,IAAI,KAAK,OAAQ;AACxE,SAAO,mBAAmB,IAAI,QAAQ;AACxC;AAOA,SAAS,aAAa,KAAa,eAAgC;AACjE,MAAI,cAAc,SAAS,IAAM,EAAG,QAAO;AAC3C,MAAI,cAAc,WAAW,GAAG,KAAK,cAAc,WAAW,IAAI,EAAG,QAAO;AAC5E,QAAM,WAAWC,SAAQ,KAAK,aAAa;AAC3C,QAAM,cAAcA,SAAQ,GAAG;AAC/B,QAAM,MAAM,QAAQ,aAAa,UAAU,OAAO;AAClD,SAAO,aAAa,eAAe,SAAS,WAAW,cAAc,GAAG;AAC1E;AAEA,SAAS,aAAa,MAAsB;AAC1C,SAAO,KACJ,MAAM,MAAM,EACZ,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,IAAI,EAAE,MAAM,CAAC,CAAC,EACjD,KAAK,EAAE;AACZ;AAEA,SAAS,YAAY,MAAsB;AACzC,QAAM,SAAS,aAAa,IAAI;AAChC,SAAO,OAAO,OAAO,CAAC,EAAE,YAAY,IAAI,OAAO,MAAM,CAAC;AACxD;AAEA,SAAS,sBAAsB,MAAsB;AACnD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,0CAA0C,IAAI;AAAA,IAC9C;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,2BAA2B,MAAsB;AACxD,QAAM,YAAY,aAAa,IAAI,IAAI;AACvC,QAAM,WAAW,KAAK,MAAM,GAAG,EAAE,IAAI,KAAK;AAC1C,SAAO;AAAA,IACL,sDAAsD,IAAI;AAAA,IAC1D;AAAA,IACA;AAAA,IACA,gBAAgB,QAAQ;AAAA,IACxB,gBAAgB,SAAS;AAAA,IACzB;AAAA,IACA;AAAA,IACA,uCAAuC,QAAQ;AAAA,IAC/C;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,uBAAuB,MAAsB;AACpD,QAAM,QAAQ,YAAY,IAAI;AAC9B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,gBAAgB,KAAK;AAAA,IACrB;AAAA,IACA;AAAA,IACA,0CAA0C,IAAI;AAAA,IAC9C;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAOA,SAAS,sBAAsB,MAAsB;AACnD,QAAM,SAAS,aAAa,IAAI;AAChC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAY,IAAI;AAAA,IAChB,yBAAyB,IAAI;AAAA,IAC7B;AAAA,IACA,sCAAsC,IAAI;AAAA,IAC1C;AAAA,IACA,gBAAgB,MAAM;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,wBAAwB,MAAsB;AACrD,QAAM,SAAS,aAAa,IAAI;AAChC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,0BAA0B,IAAI;AAAA,IAC9B,gBAAgB,MAAM;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,gBACP,KACA,MACA,MAC8C;AAC9C,UAAQ,MAAM;AAAA,IACZ,KAAK;AACH,aAAO;AAAA,QACL,UAAUA,SAAQ,KAAK,iBAAiB,GAAG,IAAI,KAAK;AAAA,QACpD,SAAS,sBAAsB,IAAI;AAAA,MACrC;AAAA,IACF,KAAK;AACH,aAAO;AAAA,QACL,UAAUA,SAAQ,KAAK,kBAAkB,GAAG,IAAI,KAAK;AAAA,QACrD,SAAS,uBAAuB,IAAI;AAAA,MACtC;AAAA,IACF,KAAK;AACH,aAAO,EAAE,UAAUA,SAAQ,KAAK,OAAO,IAAI,WAAW,GAAG,SAAS,qBAAqB,IAAI,EAAE;AAAA,IAC/F,KAAK;AACH,aAAO;AAAA,QACL,UAAUA,SAAQ,KAAK,aAAa,GAAG,IAAI,KAAK;AAAA,QAChD,SAAS,mBAAmB,IAAI;AAAA,MAClC;AAAA,IACF,KAAK;AACH,aAAO;AAAA,QACL,UAAUA,SAAQ,KAAK,sBAAsB,GAAG,IAAI,gBAAgB;AAAA,QACpE,SAAS,2BAA2B,IAAI;AAAA,MAC1C;AAAA,IACF,KAAK;AACH,aAAO;AAAA,QACL,UAAUA,SAAQ,KAAK,iBAAiB,GAAG,IAAI,WAAW;AAAA,QAC1D,SAAS,sBAAsB,IAAI;AAAA,MACrC;AAAA,IACF,KAAK;AACH,aAAO;AAAA,QACL,UAAUA,SAAQ,KAAK,oBAAoB,GAAG,IAAI,WAAW;AAAA,QAC7D,SAAS,wBAAwB,IAAI;AAAA,MACvC;AAAA,IACF;AACE,aAAO;AAAA,EACX;AACF;AAEA,SAAS,2BAA2B,MAAsB;AACxD,QAAM,QAAQ,YAAY,IAAI;AAC9B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,YAAY,KAAK,cAAc,KAAK,MAAM,GAAG,EAAE,IAAI,CAAC;AAAA,IACpD;AAAA,IACA,aAAa,IAAI;AAAA,IACjB;AAAA,IACA,cAAc,KAAK;AAAA,IACnB,qBAAqB,KAAK;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA,sBAAsB,KAAK;AAAA,IAC3B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAEA,SAAS,qBAAqB,MAAsB;AAClD,QAAM,SAAS,aAAa,IAAI;AAChC,SAAO,CAAC,2BAA2B,MAAM,YAAY,gBAAgB,MAAM,SAAS,KAAK,EAAE,EAAE;AAAA,IAC3F;AAAA,EACF;AACF;AAEA,SAAS,mBAAmB,OAAuB;AACjD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,KAAK,IAAI;AACb;AAQA,eAAsB,SAAS,MAAgD;AAC7E,QAAM,EAAE,KAAK,MAAM,KAAK,IAAI;AAE5B,MAAI,CAACC,YAAWD,SAAQ,KAAK,gBAAgB,CAAC,KAAK,CAACC,YAAWD,SAAQ,KAAK,gBAAgB,CAAC,GAAG;AAC9F,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SAAS;AAAA,IACX;AAAA,EACF;AAEA,MAAI,CAAC,YAAY,SAAS,IAAqB,GAAG;AAChD,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SAAS,2BAA2B,IAAI,iBAAiB,YAAY,KAAK,IAAI,CAAC;AAAA,IACjF;AAAA,EACF;AAEA,MAAI,CAAC,QAAQ,CAAC,YAAY,IAAI,GAAG;AAC/B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SAAS,iBAAiB,IAAI;AAAA,IAChC;AAAA,EACF;AAIA,MAAI,mBAAmB,IAAI,GAAG;AAC5B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SAAS,kBAAkB,IAAI;AAAA,IACjC;AAAA,EACF;AAGA,MAAI,SAAS,YAAY;AACvB,WAAO,iBAAiB,KAAK,MAAM,KAAK,UAAU,CAAC,CAAC;AAAA,EACtD;AAEA,QAAM,WAAW,gBAAgB,KAAK,MAAuB,IAAI;AACjE,MAAI,aAAa,MAAM;AACrB,WAAO,EAAE,QAAQ,gBAAgB,SAAS,iBAAiB,IAAI,GAAG;AAAA,EACpE;AACA,QAAM,EAAE,UAAU,QAAQ,IAAI;AAK9B,QAAM,kBAAkB,SAAS,WAAWA,SAAQ,GAAG,CAAC,IACpD,SAAS,MAAMA,SAAQ,GAAG,EAAE,SAAS,CAAC,IACtC;AACJ,MAAI,CAAC,aAAa,KAAK,eAAe,GAAG;AACvC,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,SAAS,2BAA2B,IAAI;AAAA,IAC1C;AAAA,EACF;AAEA,MAAIC,YAAW,QAAQ,GAAG;AACxB,WAAO,EAAE,QAAQ,kBAAkB,UAAU,MAAM,MAAuB,KAAK;AAAA,EACjF;AAEA,EAAAC,WAAUC,SAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AAChD,EAAAC,eAAc,UAAU,OAAO;AAK/B,MAAI,SAAS,UAAU;AACrB,UAAM,WAAW,SAAS,QAAQ,SAAS,UAAU;AACrD,QAAI,CAACH,YAAW,QAAQ,GAAG;AACzB,MAAAG,eAAc,UAAU,2BAA2B,IAAI,CAAC;AAAA,IAC1D;AAAA,EACF;AAEA,SAAO,EAAE,QAAQ,WAAW,UAAU,MAAM,MAAuB,KAAK;AAC1E;AAMA,eAAsB,gBACpB,MACA,MACA,QACe;AACf,QAAM,SAAS,MAAM,SAAS,EAAE,KAAK,QAAQ,IAAI,GAAG,MAAM,MAAM,OAAO,CAAC;AACxE,UAAQ,OAAO,QAAQ;AAAA,IACrB,KAAK;AACH,YAAM,IAAI,MAAM,sEAAsE;AAAA,IACxF,KAAK;AACH,YAAM,IAAI,MAAM,OAAO,WAAW,cAAc;AAAA,IAClD,KAAK;AACH,YAAM,IAAI;AAAA,QACR,iBAAiB,IAAI;AAAA,MACvB;AAAA,IACF,KAAK;AACH,cAAQ,IAAI;AAAA,WAAS,OAAO,QAAQ;AAAA,CAA8B;AAClE;AAAA,IACF,KAAK;AACH,cAAQ,IAAI;AAAA,mBAAiB,IAAI,KAAK,OAAO,QAAQ;AAAA,CAAI;AACzD;AAAA,EACJ;AACF;","names":["existsSync","mkdirSync","writeFileSync","resolve","dirname","resolve","existsSync","mkdirSync","dirname","writeFileSync"]}

package/dist/index.d.ts

@@ -6,7 +6,7 @@ import './rate-limit-BdNDZ3vt.js';
 import 'node:http';
 import './rate-limit-store-BEJnhWdw.js';
 import './csrf-readiness-store-CjIoub3U.js';
-import './schema-D3v8VB7o.js';
+import './schema-BpH6ivDY.js';
 
 /**
  * G5 T1.3 — formatError hook signature (blueprint ADR D3).
@@ -45,6 +45,23 @@ declare const theoConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     port: z.ZodDefault<z.ZodNumber>;
+    host: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>;
+    open: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
+    strictPort: z.ZodDefault<z.ZodBoolean>;
+    forwardConsole: z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        unhandledErrors: z.ZodOptional<z.ZodBoolean>;
+        logLevels: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warn: "warn";
+            debug: "debug";
+            log: "log";
+        }>>>;
+    }, z.core.$strip>]>>;
+    warmup: z.ZodOptional<z.ZodObject<{
+        clientFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        ssrFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
     ssr: z.ZodDefault<z.ZodBoolean>;
     ssrStreaming: z.ZodDefault<z.ZodBoolean>;
     rateLimit: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
@@ -232,14 +249,13 @@ declare const theoConfigSchema: z.ZodObject<{
         type: z.ZodOptional<z.ZodEnum<{
             server: "server";
             worker: "worker";
-            frontend: "frontend";
         }>>;
         port: z.ZodNumber;
         proxy: z.ZodString;
         dev: z.ZodString;
         build: z.ZodOptional<z.ZodString>;
         start: z.ZodString;
-        openapi: z.ZodOptional<z.ZodString>;
+        openapi: z.ZodOptional<z.ZodURL>;
         healthcheck: z.ZodDefault<z.ZodString>;
         cors: z.ZodDefault<z.ZodBoolean>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
@@ -304,6 +320,17 @@ declare class TheoProjectError extends Error {
  * T2.2 of architecture-cleanup so `devtools → core/contracts` is the legal
  * edge (replacing the prior `devtools → router` violation).
  */
+/**
+ * Dynamic-segment metadata for a file-system route node.
+ * Set when the directory name is `[param]` (single segment) or `[...slug]`
+ * (catch-all). `generate.ts` turns this into react-router `:param` / `*` syntax.
+ */
+interface RouteNodeDynamic {
+    /** The param name (`slug` for `[slug]` / `[...slug]`). Always `[A-Za-z0-9_]+`. */
+    paramName: string;
+    /** True for catch-all `[...slug]`, false for single dynamic `[slug]`. */
+    catchAll: boolean;
+}
 interface RouteNode {
     segment: string;
     path: string;
@@ -312,6 +339,8 @@ interface RouteNode {
     error?: string;
     loading?: string;
     notFound?: string;
+    /** Present only for dynamic / catch-all segments (additive — static routes omit it). */
+    dynamic?: RouteNodeDynamic;
     children: RouteNode[];
 }
 

package/dist/index.js

@@ -8,8 +8,8 @@ import {
   scanRoutes,
   theoConfigSchema,
   theoPlugin
-} from "./chunk-X3VNROZ7.js";
-import "./chunk-DNMSV3R3.js";
+} from "./chunk-SVSUUK4H.js";
+import "./chunk-D7ZH7DTG.js";
 import "./chunk-7BIM27LV.js";
 import "./chunk-PIVX3DYW.js";
 import "./chunk-5QW7IQQU.js";
@@ -23,13 +23,12 @@ import "./chunk-B3L3TJVF.js";
 import "./chunk-C3ZZ56YZ.js";
 import "./chunk-7MQOHNHE.js";
 import "./chunk-X2VVCJ4V.js";
-import "./chunk-KJLECZWQ.js";
+import "./chunk-3FYJ7R7N.js";
 import "./chunk-GY5Q27BJ.js";
 import "./chunk-Z5IGLBWE.js";
 import "./chunk-ZEGYW52B.js";
 import "./chunk-TSLSIRBR.js";
 import "./chunk-UD3LFGDL.js";
-import "./chunk-4HBI7DHP.js";
 import "./chunk-DGUM43GV.js";
 
 // src/config/define-config.ts