create-theokit 1.0.13 → 1.0.15

package/templates/services/agent-node/src/index.ts

@@ -0,0 +1,58 @@
+/**
+ * TheoKit polyglot agent service — Hono sidecar.
+ *
+ * Conforms to the Like-Vercel runtime contract (ADR-0015):
+ *   - Fetch-handler entry (native fetch handler from Hono)
+ *   - GET /health convention (200 / 503)
+ *   - JSON-line stdout logs
+ *   - W3C traceparent propagation
+ *   - Env vars at runtime
+ *
+ * Generated by `create-theokit --backend node`.
+ */
+import { Hono } from 'hono'
+import { serve } from '@hono/node-server'
+
+const SERVICE_NAME = process.env.THEOKIT_SERVICE_NAME ?? 'agent-node'
+const SERVICE_PORT = Number.parseInt(process.env.THEOKIT_SERVICE_PORT ?? '8002', 10)
+
+function log(
+  level: 'info' | 'warn' | 'error',
+  message: string,
+  extra: Record<string, unknown> = {},
+) {
+  // eslint-disable-next-line no-console -- structured stdout per ADR-0015 invariant #5
+  console.log(
+    JSON.stringify({
+      timestamp: new Date().toISOString(),
+      level,
+      message,
+      service: SERVICE_NAME,
+      ...extra,
+    }),
+  )
+}
+
+const app = new Hono()
+
+// ADR-0015 invariant #6 — W3C traceparent propagation
+app.use(async (c, next) => {
+  const tp = c.req.header('traceparent')
+  if (tp) {
+    log('info', 'request', { traceparent: tp, path: c.req.path })
+  }
+  await next()
+})
+
+// ADR-0015 invariant #4 — healthcheck convention
+app.get('/health', (c) => c.json({ status: 'ok' }))
+
+// Example endpoint — TheoKit proxies /api/worker/* to this service.
+app.post('/echo', async (c) => {
+  const body = (await c.req.json()) as { message: string }
+  return c.json({ echo: body.message })
+})
+
+serve({ fetch: app.fetch, port: SERVICE_PORT }, () => {
+  log('info', `agent-node listening on :${String(SERVICE_PORT)}`)
+})

package/templates/services/agent-node/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "lib": ["ES2022"],
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"]
+}

package/templates/default/AGENTS.md

@@ -1,91 +0,0 @@
-# AGENTS.md — TheoKit App
-
-Guide for coding agents (Claude, Copilot, Cursor) working on this TheoKit project.
-
-## Architecture
-
-This is a **full-stack TypeScript app** built with TheoKit — a framework for AI agent apps.
-
-```
-server/
-  routes/             → HTTP API routes (defineRoute + Zod validation)
-    health.ts         → GET /api/health
-  db/
-    schema.ts         → Drizzle ORM schema (SQLite) — empty, add your tables
-    index.ts          → DB connection (better-sqlite3, WAL mode)
-app/
-  page.tsx            → React frontend
-  layout.tsx          → Root layout
-tests/
-  tasks.test.ts       → Example unit test
-```
-
-## Key Patterns
-
-### Routes (defineRoute)
-```typescript
-import { defineRoute } from 'theokit/server/define'
-import { z } from 'zod'
-
-export const GET = defineRoute({
-  handler: () => db.select().from(posts).all(),
-})
-
-export const POST = defineRoute({
-  body: z.object({ title: z.string().min(3) }),
-  status: 201,
-  handler: ({ body }) => db.insert(posts).values(body).returning().get(),
-})
-```
-
-### Database (Drizzle + SQLite)
-```typescript
-import { sqliteTable, text, integer } from 'drizzle-orm/sqlite-core'
-
-export const posts = sqliteTable('posts', {
-  id: integer('id').primaryKey({ autoIncrement: true }),
-  title: text('title').notNull(),
-  published: integer('published', { mode: 'boolean' }).notNull().default(false),
-})
-```
-
-### Scaffold a Resource
-```bash
-npx theokit generate resource posts title:string published:boolean
-# Creates: schema table + routes (CRUD) + test
-```
-
-### Validation
-- **Zod is the single source of truth** — define schema once, get types + validation + OpenAPI
-- `body: z.object(...)` in defineRoute validates automatically, returns 422 on failure
-- Use `z.infer<typeof schema>` for TypeScript types
-
-### Dynamic Routes
-- `server/routes/posts/[id].ts` → `/api/posts/:id`
-- Params validated with `params: z.object({ id: z.coerce.number() })`
-
-### Path Aliases
-- `@/*` → project root (configured in tsconfig.json)
-
-## Commands
-
-```bash
-npm run dev          # Start dev server
-npm run build        # Build for production
-npm run start        # Run production build
-npm run test         # Run tests (vitest)
-npm run lint         # ESLint check
-npm run format       # Prettier format
-npm run typecheck    # TypeScript type check
-npx theokit generate resource <name> <fields...>  # Scaffold CRUD resource
-npx drizzle-kit push      # Apply schema changes (dev)
-npx drizzle-kit generate  # Generate migration files (prod)
-```
-
-## Don't
-
-- Don't use `any` — use Zod schemas + `z.infer<>`
-- Don't write raw `res.status().json()` — use defineRoute with status option
-- Don't parse request body manually — use `body: z.object(...)` in defineRoute
-- Don't import from `theokit/dist/...` or `theokit/src/...` — use public exports only
-- Don't call LLM APIs directly — use @Agent + @Tool decorators

package/templates/default/app/globals.css

@@ -1,377 +0,0 @@
-/* TheoKit — design system */
-
-:root {
-  --font-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;
-  --font-mono: 'SF Mono', SFMono-Regular, ui-monospace, 'DejaVu Sans Mono', Menlo, Consolas, monospace;
-
-  --bg: #fafafa;
-  --bg-content: #ffffff;
-  --card: #ffffff;
-  --border: #e5e5e5;
-  --text: #171717;
-  --text-secondary: #666666;
-  --text-muted: #999999;
-  --accent: #6366f1;
-  --accent-hover: #4f46e5;
-  --btn-primary-bg: #171717;
-  --btn-primary-hover: #383838;
-  --btn-secondary-hover: #f2f2f2;
-  --btn-secondary-border: #ebebeb;
-  --green: #22c55e;
-  --red: #ef4444;
-  --yellow: #eab308;
-}
-
-@media (prefers-color-scheme: dark) {
-  :root {
-    --bg: #0a0a0a;
-    --bg-content: #0a0a0a;
-    --card: #141414;
-    --border: #2a2a2a;
-    --text: #ededed;
-    --text-secondary: #999999;
-    --text-muted: #666666;
-    --accent: #818cf8;
-    --accent-hover: #6366f1;
-    --btn-primary-bg: #ededed;
-    --btn-primary-hover: #cccccc;
-    --btn-secondary-hover: #1a1a1a;
-    --btn-secondary-border: #2a2a2a;
-    --green: #22c55e;
-    --red: #ef4444;
-    --yellow: #eab308;
-  }
-  html { color-scheme: dark; }
-}
-
-* { margin: 0; padding: 0; box-sizing: border-box; }
-
-html, body {
-  max-width: 100vw;
-  overflow-x: hidden;
-}
-
-body {
-  font-family: var(--font-sans);
-  background: var(--bg);
-  color: var(--text);
-  min-height: 100vh;
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
-}
-
-a { color: inherit; text-decoration: none; }
-code, pre { font-family: var(--font-mono); }
-
-/* ─── Page container ────────────────────────────────── */
-
-.page {
-  display: flex;
-  flex: 1;
-  flex-direction: column;
-  align-items: center;
-  width: 100%;
-}
-
-.main {
-  display: flex;
-  flex: 1;
-  flex-direction: column;
-  width: 100%;
-  max-width: 900px;
-  background: var(--bg-content);
-  padding: 80px 48px 48px;
-}
-
-@media (max-width: 768px) {
-  .main { padding: 48px 20px 32px; }
-}
-
-/* ─── Hero ──────────────────────────────────────────── */
-
-.hero {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  text-align: center;
-  gap: 16px;
-  margin-bottom: 48px;
-}
-
-.hero-logo {
-  border-radius: 16px;
-  margin-bottom: 8px;
-}
-
-.hero h1 {
-  font-size: 40px;
-  font-weight: 700;
-  letter-spacing: -2.4px;
-  line-height: 48px;
-  text-wrap: balance;
-}
-
-.hero .tagline {
-  font-size: 18px;
-  line-height: 28px;
-  color: var(--text-secondary);
-  max-width: 440px;
-  text-wrap: balance;
-}
-
-.hero .hint {
-  font-size: 14px;
-  color: var(--text-muted);
-  margin-top: 8px;
-}
-
-.hero .hint code {
-  background: var(--card);
-  border: 1px solid var(--border);
-  padding: 2px 8px;
-  border-radius: 6px;
-  font-size: 13px;
-}
-
-@media (max-width: 768px) {
-  .hero h1 { font-size: 32px; line-height: 40px; letter-spacing: -1.92px; }
-  .hero .tagline { font-size: 16px; }
-}
-
-/* ─── CTA Buttons ───────────────────────────────────── */
-
-.ctas {
-  display: flex;
-  gap: 12px;
-  margin-top: 8px;
-}
-
-.btn {
-  display: inline-flex;
-  justify-content: center;
-  align-items: center;
-  height: 40px;
-  padding: 0 20px;
-  border-radius: 128px;
-  border: 1px solid transparent;
-  font-size: 14px;
-  font-weight: 500;
-  cursor: pointer;
-  transition: background 0.2s, border-color 0.2s;
-  text-decoration: none;
-}
-
-.btn.primary {
-  background: var(--btn-primary-bg);
-  color: var(--bg);
-}
-
-.btn.secondary {
-  border-color: var(--btn-secondary-border);
-  color: var(--text);
-}
-
-@media (hover: hover) and (pointer: fine) {
-  .btn.primary:hover { background: var(--btn-primary-hover); }
-  .btn.secondary:hover { background: var(--btn-secondary-hover); border-color: transparent; }
-}
-
-/* ─── Role selector ─────────────────────────────────── */
-
-.role-bar {
-  display: flex;
-  justify-content: center;
-  align-items: center;
-  gap: 8px;
-  margin-bottom: 32px;
-  font-size: 14px;
-  color: var(--text-muted);
-}
-
-.role-bar select {
-  padding: 6px 12px;
-  background: var(--card);
-  border: 1px solid var(--border);
-  border-radius: 6px;
-  color: var(--text);
-  font-size: 13px;
-}
-
-/* ─── Grid ──────────────────────────────────────────── */
-
-.grid {
-  display: grid;
-  grid-template-columns: 1fr 1fr;
-  gap: 24px;
-  width: 100%;
-}
-
-@media (max-width: 768px) {
-  .grid { grid-template-columns: 1fr; }
-}
-
-/* ─── Cards ─────────────────────────────────────────── */
-
-.card {
-  background: var(--card);
-  border: 1px solid var(--border);
-  border-radius: 12px;
-  padding: 24px;
-  width: 100%;
-}
-
-.card h2 {
-  font-size: 15px;
-  font-weight: 600;
-  margin-bottom: 16px;
-  display: flex;
-  align-items: center;
-  gap: 8px;
-}
-
-/* ─── Badges ────────────────────────────────────────── */
-
-.badge {
-  font-size: 11px;
-  padding: 2px 10px;
-  border-radius: 99px;
-  font-weight: 500;
-  background: color-mix(in srgb, var(--accent) 12%, transparent);
-  color: var(--accent);
-}
-
-.badge-ai {
-  background: color-mix(in srgb, var(--yellow) 12%, transparent);
-  color: var(--yellow);
-}
-
-/* ─── Table ─────────────────────────────────────────── */
-
-table { width: 100%; border-collapse: collapse; font-size: 13px; }
-th {
-  text-align: left; padding: 8px 6px;
-  color: var(--text-muted); border-bottom: 1px solid var(--border);
-  font-weight: 500; font-size: 11px; text-transform: uppercase; letter-spacing: 0.05em;
-}
-td { padding: 8px 6px; border-bottom: 1px solid var(--border); }
-tr.done td { opacity: 0.4; text-decoration: line-through; }
-
-.prio { font-size: 11px; padding: 2px 8px; border-radius: 99px; font-weight: 500; }
-.prio-high { background: color-mix(in srgb, var(--red) 12%, transparent); color: var(--red); }
-.prio-medium { background: color-mix(in srgb, var(--yellow) 12%, transparent); color: var(--yellow); }
-.prio-low { background: color-mix(in srgb, var(--green) 12%, transparent); color: var(--green); }
-
-/* ─── Forms ─────────────────────────────────────────── */
-
-.create-bar { display: flex; gap: 8px; margin-top: 16px; }
-.create-bar input {
-  flex: 1; padding: 8px 12px;
-  background: var(--bg); border: 1px solid var(--border);
-  border-radius: 8px; color: var(--text); font-size: 13px;
-  outline: none; transition: border-color 0.2s;
-}
-.create-bar input:focus { border-color: var(--accent); }
-.create-bar select {
-  padding: 8px 10px; background: var(--bg);
-  border: 1px solid var(--border); border-radius: 8px;
-  color: var(--text); font-size: 13px;
-}
-.create-bar button, .chat-bar button {
-  padding: 8px 16px; background: var(--accent); color: white;
-  border: none; border-radius: 8px; cursor: pointer;
-  font-weight: 600; font-size: 13px; transition: background 0.2s;
-}
-@media (hover: hover) and (pointer: fine) {
-  .create-bar button:hover, .chat-bar button:hover { background: var(--accent-hover); }
-}
-.create-bar button:disabled, .chat-bar button:disabled { opacity: 0.4; cursor: not-allowed; }
-.error { color: var(--red); font-size: 13px; margin-top: 6px; }
-
-/* ─── Chat ──────────────────────────────────────────── */
-
-.chat-box {
-  height: 320px; overflow-y: auto; padding: 14px;
-  background: var(--bg); border: 1px solid var(--border);
-  border-radius: 10px; margin-bottom: 12px;
-  font-size: 13px; line-height: 1.6;
-}
-
-.msg { margin-bottom: 8px; padding: 8px 12px; border-radius: 8px; }
-.msg.user { background: color-mix(in srgb, var(--accent) 10%, transparent); color: var(--accent); }
-.msg.agent { background: var(--card); border: 1px solid var(--border); }
-.msg.tool { background: color-mix(in srgb, var(--yellow) 8%, transparent); color: var(--yellow); font-size: 12px; font-family: var(--font-mono); }
-.msg.system { color: var(--text-muted); font-size: 12px; font-style: italic; }
-.msg.error { color: var(--red); font-size: 13px; }
-
-.chat-bar { display: flex; gap: 8px; }
-.chat-bar input {
-  flex: 1; padding: 10px 14px;
-  background: var(--bg); border: 1px solid var(--border);
-  border-radius: 10px; color: var(--text); font-size: 14px;
-  outline: none; transition: border-color 0.2s;
-}
-.chat-bar input:focus { border-color: var(--accent); }
-
-/* ─── Features grid ─────────────────────────────────── */
-
-.features {
-  margin-top: 32px;
-}
-
-.feature {
-  padding: 20px;
-  border: 1px solid var(--border);
-  border-radius: 12px;
-  background: var(--card);
-}
-
-.feature h3 {
-  font-size: 14px;
-  font-weight: 600;
-  margin-bottom: 6px;
-  font-family: var(--font-mono);
-  color: var(--accent);
-}
-
-.feature p {
-  font-size: 13px;
-  line-height: 1.5;
-  color: var(--text-secondary);
-}
-
-.feature code {
-  background: var(--bg);
-  border: 1px solid var(--border);
-  padding: 1px 5px;
-  border-radius: 4px;
-  font-size: 12px;
-}
-
-/* ─── Footer ────────────────────────────────────────── */
-
-.footer {
-  text-align: center;
-  padding: 40px 24px 32px;
-  font-size: 13px;
-  color: var(--text-muted);
-}
-
-.footer a { color: var(--text-secondary); transition: color 0.2s; }
-.footer a:hover { color: var(--accent); }
-
-/* ─── Loading ───────────────────────────────────────── */
-
-.loading-spinner {
-  width: 24px; height: 24px;
-  border: 2px solid var(--border);
-  border-top-color: var(--accent);
-  border-radius: 50%;
-  animation: spin 0.8s linear infinite;
-}
-
-@keyframes spin {
-  to { transform: rotate(360deg); }
-}

package/templates/default/app.ts

@@ -1,15 +0,0 @@
-/**
- * TheoKit App — manual bootstrap (optional).
- *
- * `theokit dev` auto-discovers server/routes/ — you don't need this file
- * for basic usage. Use it when you need explicit controller/agent registration.
- *
- * Example with controllers + agents:
- *
- *   import 'reflect-metadata'
- *   import { TheoApp } from '@theokit/http/app'
- *   import { MyController } from './server/controllers/my.controller.js'
- *
- *   const app = await TheoApp.create({ controllers: [MyController] })
- *   await app.listen(3000)
- */

package/templates/default/drizzle.config.ts

@@ -1,10 +0,0 @@
-import { defineConfig } from 'drizzle-kit'
-
-export default defineConfig({
-  schema: './server/db/schema.ts',
-  out: './drizzle',
-  dialect: 'sqlite',
-  dbCredentials: {
-    url: './data/dev.db',
-  },
-})

package/templates/default/server/db/index.ts

@@ -1,10 +0,0 @@
-import { drizzle } from 'drizzle-orm/better-sqlite3'
-import Database from 'better-sqlite3'
-import { mkdirSync } from 'node:fs'
-import * as schema from './schema.js'
-
-mkdirSync('data', { recursive: true })
-const sqlite = new Database('data/dev.db')
-sqlite.pragma('journal_mode = WAL')
-
-export const db = drizzle(sqlite, { schema })

package/templates/default/server/db/schema.ts

@@ -1,13 +0,0 @@
-// Define your Drizzle tables here. Example:
-//
-// import { sqliteTable, text, integer } from 'drizzle-orm/sqlite-core'
-//
-// export const posts = sqliteTable('posts', {
-//   id: integer('id').primaryKey({ autoIncrement: true }),
-//   title: text('title').notNull(),
-//   published: integer('published', { mode: 'boolean' }).notNull().default(false),
-//   createdAt: text('created_at').notNull().$defaultFn(() => new Date().toISOString()),
-// })
-//
-// Or scaffold a full resource (schema + routes + test):
-//   npx theokit generate resource posts title:string published:boolean

package/templates/default/server/index.ts

@@ -1,2 +0,0 @@
-// Routes are auto-discovered from server/routes/ by theokit dev.
-// No manual registration needed — convention over configuration.

package/templates/default/tests/tasks.test.ts

@@ -1,18 +0,0 @@
-import { describe, it, expect } from 'vitest'
-
-describe('Health route response shape', () => {
-  it('returns expected fields', () => {
-    // Mirrors the shape returned by server/routes/health.ts GET handler.
-    // Unit test — no server dependency.
-    const response = {
-      status: 'ok',
-      timestamp: Date.now(),
-      framework: 'TheoKit',
-    }
-
-    expect(response.status).toBe('ok')
-    expect(response.framework).toBe('TheoKit')
-    expect(typeof response.timestamp).toBe('number')
-    expect(response.timestamp).toBeGreaterThan(0)
-  })
-})