@kood/claude-code 0.3.6 → 0.3.8

package/templates/nextjs/docs/library/zod/index.md

@@ -0,0 +1,56 @@
+# Zod
+
+> v4 | TypeScript Schema Validation
+
+@complex-types.md
+@transforms.md
+@validation.md
+
+---
+
+<quick_reference>
+
+```typescript
+// Basic
+const schema = z.object({
+  email: z.email(),              // v4!
+  name: z.string().min(1).trim(),
+  website: z.url().optional(),   // v4!
+  age: z.number().int().positive(),
+})
+type Input = z.infer<typeof schema>
+
+schema.parse(data)              // throws on failure
+schema.safeParse(data)          // { success, data/error }
+
+// TanStack Start
+export const createUser = createServerFn({ method: 'POST' })
+  .inputValidator(schema)
+  .handler(async ({ data }) => prisma.user.create({ data }))
+```
+
+</quick_reference>
+
+<v4_changes>
+
+```typescript
+// ✅ v4 new APIs
+z.email()  z.url()  z.uuid()
+z.iso.date()  z.iso.datetime()  z.iso.duration()
+z.stringbool()  // "true"/"yes"/"1" → true
+
+// ❌ v3 deprecated
+z.string().email()  z.string().url()
+
+// Changes
+z.string().min(5, { error: "Too short." })  // message → error
+z.strictObject({ name: z.string() })  // additional keys throw error
+z.looseObject({ name: z.string() })   // additional keys pass through
+z.string().refine(val => val.includes("@")).min(5)  // refinement chaining
+
+// Template literals
+const css = z.templateLiteral([z.number(), z.enum(["px", "em", "rem"])])
+// `${number}px` | `${number}em` | `${number}rem`
+```
+
+</v4_changes>

package/templates/nextjs/docs/library/zod/transforms.md

@@ -0,0 +1,51 @@
+# Zod - Transforms
+
+<patterns>
+
+```typescript
+// Transform
+const stringToLength = z.string().transform((val) => val.length)
+stringToLength.parse('hello')  // => 5
+
+type In = z.input<typeof stringToLength>   // string
+type Out = z.output<typeof stringToLength> // number
+
+// Pipe (validate then transform)
+const stringToNumber = z.string()
+  .transform((val) => parseInt(val, 10))
+  .pipe(z.number().min(0).max(100))
+
+stringToNumber.parse('50')  // => 50
+stringToNumber.parse('150') // throws
+
+// Coerce (force conversion)
+z.coerce.string()   // any value → string
+z.coerce.number()   // any value → number
+z.coerce.boolean()  // any value → boolean
+z.coerce.date()     // any value → date
+z.coerce.bigint()   // any value → BigInt
+
+z.coerce.number().parse("42")  // => 42
+z.coerce.date().parse("2021-01-01")  // => Date
+
+// v4: input type changed to unknown
+type In = z.input<typeof z.coerce.string()>  // unknown
+
+// v4 environment variable boolean
+z.stringbool()  // "true"/"yes"/"1" → true, "false"/"no"/"0" → false
+
+// Preprocess
+const trimmed = z.preprocess(
+  (val) => typeof val === 'string' ? val.trim() : val,
+  z.string()
+)
+
+// Separate input/output types
+const Schema = z.object({
+  createdAt: z.string().transform((str) => new Date(str)),
+})
+type SchemaInput = z.input<typeof Schema>   // { createdAt: string }
+type SchemaOutput = z.output<typeof Schema> // { createdAt: Date }
+```
+
+</patterns>

package/templates/nextjs/docs/library/zod/validation.md

@@ -0,0 +1,70 @@
+# Zod - Validation
+
+<patterns>
+
+```typescript
+// Refinement (v4: message → error)
+const PasswordSchema = z.string()
+  .min(8)
+  .refine((val) => /[A-Z]/.test(val), { error: 'Uppercase letter required' })
+  .refine((val) => /[0-9]/.test(val), { error: 'Number required' })
+
+z.string().refine(val => val.includes("@")).min(5)  // v4: chaining after refinement
+
+// Async
+const schema = z.string().refine(async (val) => val.length <= 8)
+await schema.parseAsync('hello')
+
+// Superrefine
+z.object({
+  password: z.string(),
+  confirmPassword: z.string(),
+}).superRefine((data, ctx) => {
+  if (data.password !== data.confirmPassword) {
+    ctx.addIssue({
+      code: z.ZodIssueCode.custom,
+      message: 'Passwords do not match',
+      path: ['confirmPassword'],
+    })
+  }
+})  // v4: ctx.path is unavailable
+
+// Custom
+const px = z.custom<`${number}px`>((val) =>
+  typeof val === 'string' && /^\d+px$/.test(val)
+)
+px.parse('42px')  // ✅
+px.parse('42vw')  // throws
+
+// Error handling
+const result = schema.safeParse(data)
+if (!result.success) {
+  result.error.errors.forEach((err) => {
+    console.log(err.path, err.message, err.code)
+  })
+  const flat = result.error.flatten()  // { fieldErrors: { email: ['Invalid email'] } }
+}
+
+// TanStack Start
+export const createUser = createServerFn({ method: 'POST' })
+  .inputValidator(zodValidator(createUserSchema))
+  .handler(async ({ data }) => prisma.user.create({ data }))
+
+// Environment variables
+const env = z.object({
+  NODE_ENV: z.enum(['development', 'production', 'test']),
+  DATABASE_URL: z.string().url(),
+  API_SECRET: z.string().min(32),
+}).parse(process.env)
+
+// Middleware
+const workspaceMiddleware = createMiddleware({ type: 'function' })
+  .inputValidator(zodValidator(z.object({ workspaceId: z.string() })))
+  .server(({ next, data }) => next())
+
+// Zod Mini (v4)
+import * as z from "zod/mini"
+z.string().check(z.minLength(5), z.maxLength(10), z.trim())
+```
+
+</patterns>

package/templates/npx/CLAUDE.md

@@ -1,19 +1,19 @@
 # CLAUDE.md - NPX CLI
 
-> Node.js CLI 도구 개발
+> Node.js CLI tool development
 
 <context>
 
-**Purpose:** Node.js CLI 도구 개발을 위한 작업 지침
+**Purpose:** Work instructions for Node.js CLI tool development
 
-**Scope:** npx 배포 가능한 CLI 패키지 구현
+**Scope:** Implement CLI packages deployable via npx
 
 **Key Features:**
-- Commander.js 명령어 체계
-- 대화형 프롬프트 (prompts)
-- 파일 시스템 작업 (fs-extra)
+- Commander.js command system
+- Interactive prompts (prompts)
+- File system operations (fs-extra)
 - TypeScript + ESM
-- 색상 출력 (picocolors)
+- Colored output (picocolors)
 
 </context>
 
@@ -31,13 +31,13 @@
 
 <forbidden>
 
-| 분류 | 금지 행동 |
-|------|----------|
-| **Git 커밋** | AI 표시 (`Generated with Claude Code`, `🤖`, `Co-Authored-By:`), 여러 줄 메시지, 이모지 |
-| **콘솔 출력** | `console.log` 직접 사용 (logger 함수 사용) |
-| **파일 작업** | 동기 API (`fs.readFileSync` 등), 하드코딩된 경로 (path.join 사용) |
-| **에러 처리** | `process.exit()` 누락, try-catch 없는 async 작업 |
-| **코드 검색** | Bash의 grep/rg/find 명령어 (ast-grep 또는 전용 도구 사용) |
+| Category | Prohibited Actions |
+|----------|-------------------|
+| **Git Commits** | AI markers (`Generated with Claude Code`, `🤖`, `Co-Authored-By:`), multi-line messages, emojis |
+| **Console Output** | Direct `console.log` usage (use logger functions) |
+| **File Operations** | Synchronous APIs (`fs.readFileSync`, etc.), hardcoded paths (use path.join) |
+| **Error Handling** | Missing `process.exit()`, async operations without try-catch |
+| **Code Search** | Bash grep/rg/find commands (use ast-grep or dedicated tools) |
 
 </forbidden>
 
@@ -45,15 +45,15 @@
 
 <required>
 
-| 작업 | 필수 행동 |
-|------|----------|
-| **작업 시작 전** | 관련 docs 읽기 (Commander → commander, 파일 → fs-extra) |
-| **콘솔 출력** | logger 함수 사용 (info/success/error/warn) |
-| **파일 작업** | async API (`fs-extra`), `path.join`으로 경로 조합 |
-| **에러 처리** | try-catch + `process.exit(1)`, 사용자에게 명확한 에러 메시지 |
-| **코드 검색** | ast-grep 사용 (함수/클래스/패턴 검색) |
-| **코드 작성** | UTF-8 인코딩, 코드 묶음별 한글 주석, const 함수 선언 |
-| **복잡한 작업** | Sequential Thinking MCP (5+ 단계 작업) |
+| Task | Required Actions |
+|------|-----------------|
+| **Before Starting** | Read relevant docs (Commander → commander, Files → fs-extra) |
+| **Console Output** | Use logger functions (info/success/error/warn) |
+| **File Operations** | Async API (`fs-extra`), `path.join` for paths |
+| **Error Handling** | try-catch + `process.exit(1)`, clear error messages to users |
+| **Code Search** | Use ast-grep (search functions/classes/patterns) |
+| **Code Writing** | UTF-8 encoding, Korean comments per code block, const function declarations |
+| **Complex Tasks** | Sequential Thinking MCP (5+ step tasks) |
 
 </required>
 
@@ -61,8 +61,8 @@
 
 <tech_stack>
 
-| 기술 | 버전 |
-|------|------|
+| Technology | Version |
+|-----------|---------|
 | Node.js | >= 18 (ESM) |
 | TypeScript | 5.x (strict) |
 | Commander | 12.x |
@@ -78,13 +78,13 @@
 <structure>
 ```
 src/
-├── index.ts      # CLI 진입점
-├── commands/     # 명령어 모듈
+├── index.ts      # CLI entry point
+├── commands/     # Command modules
 ├── utils/        # logger, copy
-└── types/        # 타입
+└── types/        # Types
 
-templates/        # 빌드 시 복사
-dist/             # 빌드 결과물
+templates/        # Copied during build
+dist/             # Build output
 ```
 </structure>
 
@@ -92,9 +92,9 @@ dist/             # 빌드 결과물
 
 <conventions>
 
-**파일명:** kebab-case
-**TypeScript:** const 선언, 명시적 return type, interface(객체)/type(유니온), any→unknown
-**Import 순서:** 외부 → 내부 → type
+**File naming:** kebab-case
+**TypeScript:** const declarations, explicit return types, interface(objects)/type(unions), any→unknown
+**Import order:** external → internal → type
 
 </conventions>
 
@@ -103,7 +103,7 @@ dist/             # 빌드 결과물
 <quick_patterns>
 
 ```typescript
-// CLI 진입점 (index.ts)
+// CLI entry point (index.ts)
 #!/usr/bin/env node
 import { Command } from 'commander'
 import { logger } from './utils/logger.js'
@@ -142,7 +142,7 @@ export const logger = {
 ```
 
 ```typescript
-// 파일 복사 (utils/copy.ts)
+// File copying (utils/copy.ts)
 import path from 'node:path'
 import { copy, pathExists } from 'fs-extra'
 
@@ -162,7 +162,7 @@ export const copyTemplate = async (
 ```
 
 ```typescript
-// 대화형 프롬프트
+// Interactive prompts
 import prompts from 'prompts'
 
 const response = await prompts([
@@ -192,6 +192,6 @@ const response = await prompts([
 ```
 docs/
 ├── library/      # commander, fs-extra, prompts
-└── references/   # CLI 패턴, 베스트 프랙티스
+└── references/   # CLI patterns, best practices
 ```
 </docs_structure>

package/templates/npx/docs/library/commander/index.md

@@ -1,10 +1,10 @@
 # Commander.js
 
-> Node.js CLI 프레임워크
+> Node.js CLI framework
 
 <patterns>
 
-## 기본 설정
+## Basic Setup
 
 ```typescript
 import { Command } from 'commander';
@@ -22,7 +22,7 @@ program.parse();
 ## Options
 
 ```typescript
-// 기본
+// Basic
 program
   .option('-t, --template <name>', 'template name')
   .option('-f, --force', 'force overwrite')
@@ -31,19 +31,19 @@ program
     console.log(options.force);    // boolean | undefined
   });
 
-// 필수
+// Required
 program
   .requiredOption('-c, --config <path>', 'config file path')
   .action((options) => {
-    // options.config는 항상 존재
+    // options.config is always present
   });
 
-// 기본값
+// Default values
 program
   .option('-p, --port <number>', 'port number', '3000')
   .option('-e, --env <name>', 'environment', 'development')
 
-// 여러 값
+// Multiple values
 program
   .option('-i, --include <path...>', 'include paths')
   .action((options) => {
@@ -58,8 +58,8 @@ program
   .argument('<source>', 'source file')
   .argument('[destination]', 'destination file')
   .action((source, destination, options) => {
-    console.log(source);      // 필수
-    console.log(destination); // 선택
+    console.log(source);      // required
+    console.log(destination); // optional
   });
 ```
 
@@ -71,14 +71,14 @@ program
   .description('Initialize project')
   .option('-t, --template <name>', 'template')
   .action((options) => {
-    // init 처리
+    // Handle init
   });
 
 program
   .command('build')
   .description('Build project')
   .action(() => {
-    // build 처리
+    // Handle build
   });
 ```
 
@@ -95,7 +95,7 @@ program
     }
   });
 
-await program.parseAsync(); // await 필수
+await program.parseAsync(); // await required
 ```
 
 </patterns>

package/templates/npx/docs/library/fs-extra/index.md

@@ -1,6 +1,6 @@
 # fs-extra
 
-> Node.js 파일 시스템 유틸리티
+> Node.js file system utilities
 
 <patterns>
 
@@ -8,14 +8,14 @@
 import fs from 'fs-extra';
 import path from 'path';
 
-// 존재 확인
+// Check existence
 const exists = await fs.pathExists('/path/to/file');
 
-// 디렉토리 생성
+// Create directory
 await fs.ensureDir('/path/to/nested/dir');
 await fs.mkdir('/path/to/dir');
 
-// 복사
+// Copy
 await fs.copy('/src/file.txt', '/dest/file.txt');
 await fs.copy('/src/dir', '/dest/dir');
 await fs.copy(src, dest, {
@@ -24,18 +24,18 @@ await fs.copy(src, dest, {
   filter: (src) => !src.includes('node_modules'),
 });
 
-// 삭제
+// Remove
 await fs.remove('/path/to/dir');
 
-// 디렉토리 읽기
+// Read directory
 const items = await fs.readdir('/path/to/dir');
 
-// 파일 타입 확인
+// Check file type
 const stat = await fs.stat(itemPath);
 if (stat.isDirectory()) { /* ... */ }
 if (stat.isFile()) { /* ... */ }
 
-// 파일 읽기/쓰기
+// Read/Write files
 const content = await fs.readFile('/path/to/file', 'utf-8');
 await fs.writeFile('/path/to/file', content, 'utf-8');
 
@@ -43,7 +43,7 @@ await fs.writeFile('/path/to/file', content, 'utf-8');
 const data = await fs.readJson('/path/to/file.json');
 await fs.writeJson('/path/to/file.json', data, { spaces: 2 });
 
-// 재귀 복사
+// Recursive copy
 const copyRecursive = async (src: string, dest: string) => {
   const counter = { files: 0, directories: 0 };
 

package/templates/npx/docs/library/prompts/index.md

@@ -66,7 +66,7 @@ const { secret } = await prompts({
   message: 'Enter password:',
 });
 
-// 취소 처리
+// Handle cancellation
 const { template } = await prompts({ /* ... */ });
 
 if (!template) {
@@ -74,14 +74,14 @@ if (!template) {
   process.exit(0);
 }
 
-// 연속 질문
+// Multiple questions
 const response = await prompts([
   { type: 'text', name: 'name', message: 'Project name?' },
   { type: 'select', name: 'template', message: 'Template?', choices: [...] },
   { type: 'confirm', name: 'git', message: 'Initialize git?' },
 ]);
 
-// 조건부 질문
+// Conditional questions
 const response = await prompts([
   { type: 'confirm', name: 'useTypescript', message: 'Use TypeScript?' },
   { type: (prev) => prev ? 'confirm' : null, name: 'strict', message: 'Enable strict mode?' },

package/templates/npx/docs/references/patterns.md

@@ -1,10 +1,10 @@
 # NPX CLI Patterns
 
-> CLI 구현 통합 패턴
+> Integrated CLI implementation patterns
 
 <patterns>
 
-## CLI 진입점
+## CLI Entry Point
 
 ```typescript
 #!/usr/bin/env node
@@ -35,7 +35,7 @@ program
 program.parse();
 ```
 
-## Logger 유틸
+## Logger Utility
 
 ```typescript
 import pc from 'picocolors';
@@ -49,7 +49,7 @@ export const logger = {
 };
 ```
 
-## 대화형 템플릿 선택
+## Interactive Template Selection
 
 ```typescript
 import prompts from 'prompts';
@@ -61,7 +61,7 @@ export const selectAndCopyTemplate = async (
   templatesDir: string,
   targetDir: string,
 ): Promise<void> => {
-  // 1. 템플릿 선택
+  // 1. Select template
   const { template } = await prompts({
     type: 'select',
     name: 'template',
@@ -77,7 +77,7 @@ export const selectAndCopyTemplate = async (
     process.exit(0);
   }
 
-  // 2. 덮어쓰기 확인
+  // 2. Confirm overwrite
   const targetExists = await fs.pathExists(targetDir);
   if (targetExists) {
     const { overwrite } = await prompts({
@@ -93,14 +93,14 @@ export const selectAndCopyTemplate = async (
     }
   }
 
-  // 3. 복사
+  // 3. Copy files
   const src = path.join(templatesDir, template);
   await fs.copy(src, targetDir, { overwrite: true });
   logger.success(`Template copied to ${targetDir}`);
 };
 ```
 
-## ESM __dirname 처리
+## ESM __dirname Handling
 
 ```typescript
 import { fileURLToPath } from 'url';
@@ -109,11 +109,11 @@ import path from 'path';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
-// 템플릿 디렉토리 경로
+// Templates directory path
 const templatesDir = path.resolve(__dirname, '../templates');
 ```
 
-## 재귀 복사 with Counter
+## Recursive Copy with Counter
 
 ```typescript
 import fs from 'fs-extra';
@@ -147,7 +147,7 @@ export const copyRecursive = async (
 };
 ```
 
-## package.json 설정
+## package.json Configuration
 
 ```json
 {
@@ -167,7 +167,7 @@ export const copyRecursive = async (
 }
 ```
 
-## tsup 설정
+## tsup Configuration
 
 ```typescript
 import { defineConfig } from 'tsup';