npm - @kood/claude-code - Versions diffs - 0.5.3 → 0.5.5 - Mend

@kood/claude-code 0.5.3 → 0.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (125) hide show

package/templates/.claude/skills/stitch-react/resources/component-template.tsx ADDED Viewed

@@ -0,0 +1,37 @@
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import React from 'react';
+// Use a valid identifier like 'StitchComponent' as the placeholder
+interface StitchComponentProps {
+  readonly children?: React.ReactNode;
+  readonly className?: string;
+}
+export const StitchComponent: React.FC<StitchComponentProps> = ({
+  children,
+  className = '',
+  ...props
+}) => {
+  return (
+    <div className={`relative ${className}`} {...props}>
+      {children}
+    </div>
+  );
+};
+export default StitchComponent;

package/templates/.claude/skills/stitch-react/resources/stitch-api-reference.md ADDED Viewed

@@ -0,0 +1,14 @@
+# Stitch API reference
+This document describes the data structures returned by the Stitch MCP server to ensure accurate component mapping.
+### Metadata schema
+When calling `get_screen`, the server returns a JSON object with these key properties:
+* **htmlCode**: Contains a `downloadUrl`. This is a signed URL that requires a system-level fetch (curl) to handle redirects and security handshakes.
+* **screenshot**: Includes a `downloadUrl` for the visual design. Use this to verify layout intent that might not be obvious in the raw HTML.
+* **deviceType**: Usually set to `DESKTOP`. All generated components should prioritize the corresponding viewport (2560px width) as the base layout.
+### Technical mapping rules
+1. **Element tracking**: Preserve `data-stitch-id` attributes as comments in the TSX to allow for future design synchronization.
+2. **Asset handling**: Treat background images in the HTML as dynamic data. Extract the URLs into `mockData.ts` rather than hardcoding them into the component styles.
+3. **Style extraction**: The HTML `<head>` contains a localized `tailwind.config`. This config must be merged with the local project theme to ensure colors like `primary` and `background-dark` render correctly.

package/templates/.claude/skills/stitch-react/resources/style-guide.json ADDED Viewed

@@ -0,0 +1,24 @@
+{
+  "theme": {
+    "colors": {
+      "primary": "#19e66f",
+      "background": {
+        "light": "#f6f8f7",
+        "dark": "#112118",
+        "elevated": "#1A1A1A"
+      },
+      "accent": {
+        "purple": "#8A2BE2",
+        "lavender": "#D0A9F5"
+      }
+    },
+    "typography": {
+      "display": ["Space Grotesk", "sans-serif"],
+      "icons": "Material Symbols Outlined"
+    },
+    "spacing": {
+      "header-h": "72px",
+      "container-max": "960px"
+    }
+  }
+}

package/templates/.claude/skills/stitch-react/scripts/fetch-stitch.sh ADDED Viewed

@@ -0,0 +1,30 @@
+#!/bin/bash
+# Copyright 2026 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+URL=$1
+OUTPUT=$2
+if [ -z "$URL" ] || [ -z "$OUTPUT" ]; then
+  echo "Usage: $0 <url> <output_path>"
+  exit 1
+fi
+echo "Initiating high-reliability fetch for Stitch HTML..."
+curl -L -f -sS --connect-timeout 10 --compressed "$URL" -o "$OUTPUT"
+if [ $? -eq 0 ]; then
+  echo "✅ Successfully retrieved HTML at: $OUTPUT"
+  exit 0
+else
+  echo "❌ Error: Failed to retrieve content. Check TLS/SNI or URL expiration."
+  exit 1
+fi

package/templates/.claude/skills/stitch-react/scripts/validate.js ADDED Viewed

@@ -0,0 +1,77 @@
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import swc from '@swc/core';
+import fs from 'node:fs';
+import path from 'node:path';
+async function validateComponent(filePath) {
+  const code = fs.readFileSync(filePath, 'utf-8');
+  const filename = path.basename(filePath);
+  try {
+    const ast = await swc.parse(code, { syntax: 'typescript', tsx: true });
+    let hasInterface = false;
+    let tailwindIssues = [];
+    console.log('🔍 Scanning AST...');
+    const walk = (node) => {
+      if (!node) return;
+      if (
+        node.type === 'TsInterfaceDeclaration' &&
+        node.id.value.endsWith('Props')
+      )
+        hasInterface = true;
+      if (node.type === 'JSXAttribute' && node.name.name === 'className') {
+        if (node.value?.value && /#[0-9A-Fa-f]{6}/.test(node.value.value))
+          tailwindIssues.push(node.value.value);
+      }
+      for (const key in node) {
+        if (node[key] && typeof node[key] === 'object') walk(node[key]);
+      }
+    };
+    walk(ast);
+    console.log(`--- Validation for: ${filename} ---`);
+    if (hasInterface) {
+      console.log('✅ Props declaration found.');
+    } else {
+      console.error("❌ MISSING: Props interface (must end in 'Props').");
+    }
+    if (tailwindIssues.length === 0) {
+      console.log('✅ No hardcoded hex values found.');
+    } else {
+      console.error(
+        `❌ STYLE: Found ${tailwindIssues.length} hardcoded hex codes.`,
+      );
+      tailwindIssues.forEach((hex) => console.error(`   - ${hex}`));
+    }
+    if (hasInterface && tailwindIssues.length === 0) {
+      console.log('\n✨ COMPONENT VALID.');
+      process.exit(0);
+    } else {
+      console.error('\n🚫 VALIDATION FAILED.');
+      process.exit(1);
+    }
+  } catch (err) {
+    console.error('❌ PARSE ERROR:', err.message);
+    process.exit(1);
+  }
+}
+validateComponent(process.argv[2]);

package/templates/hono/CLAUDE.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # CLAUDE.md - Hono
-> Ultra-lightweight framework based on Web Standards
+> Web Standards 기반 초경량 프레임워크
 <instructions>
 @../../commands/git.md
@@ -15,12 +15,12 @@
 <forbidden>
-| Category | Prohibited |
-|----------|------------|
-| **Git** | `Generated with Claude Code`, `🤖`, `Co-Authored-By:`, multi-line commits, emojis |
-| **Prisma** | Auto-run `db push/migrate/generate`, arbitrary schema changes |
-| **API** | Manual validation/auth in handlers, throwing generic Error |
-| **Search** | grep, rg, find |
+| 분류 | 금지 |
+|------|------|
+| **Git** | `Generated with Claude Code`, `🤖`, `Co-Authored-By:`, 여러 줄, 이모지 |
+| **Prisma** | `db push/migrate/generate` 자동 실행, schema 임의 변경 |
+| **API** | handler 내 수동 검증/인증, 일반 Error throw |
+| **검색** | grep, rg, find |
 </forbidden>
@@ -28,15 +28,15 @@
 <required>
-| Task | Required |
-|------|----------|
-| Before work | Read related docs (API→hono, DB→prisma) |
-| Document search | serena mcp (document indexing/search, context length optimization) |
-| Code search | ast-grep |
-| Complex tasks | Sequential Thinking MCP |
-| 3+ file changes | gemini-review |
-| Validation | zValidator, HTTPException error handling |
-| Code writing | UTF-8, Korean comments per code block, Prisma Multi-File all elements commented |
+| 작업 | 필수 |
+|------|------|
+| 작업 전 | 관련 docs 읽기 (API→hono, DB→prisma) |
+| 문서 검색 | serena mcp (문서 인덱싱/검색, context 길이 최적화) |
+| 코드 검색 | ast-grep |
+| 복잡한 작업 | Sequential Thinking MCP |
+| 3+ 파일 수정 | gemini-review |
+| Validation | zValidator, HTTPException 에러 처리 |
+| 코드 작성 | UTF-8, 코드 묶음별 한글 주석, Prisma Multi-File 모든 요소 주석 |
 </required>
@@ -44,11 +44,11 @@
 <tech_stack>
-| Technology | Version | Notes |
-|------------|---------|-------|
-| Hono | Latest | - |
+| 기술 | 버전 | 주의 |
+|------|------|------|
+| Hono | 최신 | - |
 | TypeScript | 5.x | strict |
-| Prisma | **7.x** | `prisma-client`, output required |
+| Prisma | **7.x** | `prisma-client`, output 필수 |
 | Zod | **4.x** | `z.email()`, `z.url()` |
 </tech_stack>
@@ -70,23 +70,23 @@ src/
 └── types/
 ```
-Common logic → `src/services/`, route-specific logic → individual route files
+공통 로직 → `src/services/`, 라우트별 로직 → 각 route 파일
 </structure>
 ---
 <conventions>
-File naming: kebab-case
-TypeScript: const declarations, explicit return types, interface (objects)/type (unions), any→unknown
-Import order: external → internal → relative paths → types
+파일명: kebab-case
+TypeScript: const 선언, 명시적 return type, interface(객체)/type(유니온), any→unknown
+Import 순서: 외부 → 내부 → 상대경로 → type
 Prisma Multi-File:
 ```
 prisma/schema/
 ├── +base.prisma   # datasource, generator
-├── +enum.prisma   # enums
-└── [model].prisma # per-model files (Korean comments!)
+├── +enum.prisma   # enum
+└── [model].prisma # 모델별 (한글 주석!)
 ```
 </conventions>
@@ -96,7 +96,7 @@ prisma/schema/
 <quick_patterns>
 ```typescript
-// App + Error handler
+// App + 에러 핸들러
 import { Hono } from 'hono'
 import { HTTPException } from 'hono/http-exception'
@@ -145,7 +145,7 @@ export const authMiddleware = createMiddleware(async (c, next) => {
   await next()
 })
-// Usage
+// 사용
 app.use('/api/*', authMiddleware)
 ```

package/templates/hono/docs/architecture.md CHANGED Viewed

@@ -1,10 +1,10 @@
-# Hono Server Architecture
+# Hono 서버 아키텍처
-> Layer-based architecture
+> 레이어 기반 아키텍처
 ---
-## System Overview
+## 시스템 개요
 ```
 Client → Middleware → Routes → Validation → Services → Database
@@ -12,21 +12,21 @@ Client → Middleware → Routes → Validation → Services → Database
 ---
-## Project Structure
+## 프로젝트 구조
 ```
 src/
 ├── index.ts            # Entry point
-├── routes/             # Route modules
-├── middleware/         # Custom middleware
-├── validators/         # Zod schemas
-├── services/           # Business logic
+├── routes/             # 라우트 모듈
+├── middleware/         # 커스텀 미들웨어
+├── validators/         # Zod 스키마
+├── services/           # 비즈니스 로직
 │   └── user/
-│       ├── queries.ts  # Read operations
-│       └── mutations.ts # Create/Update/Delete
+│       ├── queries.ts  # 조회
+│       └── mutations.ts # 생성/수정/삭제
 ├── database/           # Prisma Client
-├── types/              # Type definitions
-└── lib/                # Utilities
+├── types/              # 타입 정의
+└── lib/                # 유틸리티
 ```
 ---
@@ -227,8 +227,8 @@ const data = await res.json()
 ## Tech Stack
-| Category | Technology | Version |
-|----------|------------|---------|
+| 분류 | 기술 | 버전 |
+|------|------|------|
 | Framework | Hono | latest |
 | Validation | Zod | **4.x** |
 | ORM | Prisma | **7.x** |
@@ -236,20 +236,20 @@ const data = await res.json()
 ---
-## Pattern Summary
+## 패턴 요약
-| Layer | Responsibility | Files |
-|-------|----------------|-------|
-| Routes | HTTP routing | `routes/*.ts` |
-| Middleware | Request/Response handling | `middleware/*.ts` |
-| Validators | Input validation | `validators/*.ts` |
-| Services | Business logic | `services/*/*.ts` |
-| Database | Data access | `database/prisma.ts` |
+| 레이어 | 역할 | 파일 |
+|--------|------|------|
+| Routes | HTTP 라우팅 | `routes/*.ts` |
+| Middleware | 요청/응답 처리 | `middleware/*.ts` |
+| Validators | 입력 검증 | `validators/*.ts` |
+| Services | 비즈니스 로직 | `services/*/*.ts` |
+| Database | 데이터 액세스 | `database/prisma.ts` |
 ---
-## Related Documentation
+## 관련 문서
 - [Hono](../library/hono/index.md)
 - [Prisma](../library/prisma/index.md)
-- [Cloudflare Deployment](../deployment/cloudflare.md)
+- [Cloudflare 배포](../deployment/cloudflare.md)

package/templates/hono/docs/deployment/cloudflare.md CHANGED Viewed

@@ -1,10 +1,10 @@
-# Nitro - Cloudflare Deployment
+# Nitro - Cloudflare 배포
-> Cloudflare Workers/Pages Edge deployment
+> Cloudflare Workers/Pages Edge 배포
 ---
-## Workers Configuration
+## Workers 설정
 ```typescript
 // nitro.config.ts
@@ -22,7 +22,7 @@ export default defineNitroConfig({
 ---
-## Pages Configuration
+## Pages 설정
 ```typescript
 // nitro.config.ts
@@ -65,7 +65,7 @@ bucket_name = "my-bucket"
 ---
-## Deployment
+## 배포
 ```bash
 wrangler login
@@ -78,7 +78,7 @@ wrangler pages deploy .output/public
 ---
-## Using Bindings
+## Bindings 사용
 ### D1
@@ -137,7 +137,7 @@ app.get("/download/:name", async (c) => {
 ---
-## Secrets
+## 시크릿
 ```bash
 wrangler secret put API_SECRET
@@ -146,7 +146,7 @@ wrangler secret list
 ---
-## D1 Migrations
+## D1 마이그레이션
 ```bash
 wrangler d1 migrations create my-database create_users
@@ -191,21 +191,21 @@ jobs:
 ---
-## Troubleshooting
+## 문제 해결
-| Issue | Solution |
-|-------|----------|
-| Worker size limit | Configure externals, minify |
-| D1 not found | Check wrangler.toml bindings |
-| Node.js API errors | Add `nodejs_compat` flag |
+| 문제 | 해결 |
+|------|------|
+| Worker size limit | externals 설정, minify |
+| D1 not found | wrangler.toml 바인딩 확인 |
+| Node.js API 오류 | `nodejs_compat` 플래그 |
 ```bash
-wrangler tail          # Real-time logs
-wrangler deploy --dry-run  # Validation
+wrangler tail          # 실시간 로그
+wrangler deploy --dry-run  # 검증
 ```
 ---
-## Related Documentation
+## 관련 문서
-- [Deployment Guide](./index.md)
+- [배포 가이드](./index.md)

package/templates/hono/docs/deployment/docker.md CHANGED Viewed

@@ -1,6 +1,6 @@
-# Nitro - Docker Deployment
+# Nitro - Docker 배포
-> Container deployment
+> 컨테이너 배포
 ---
@@ -63,13 +63,13 @@ docs/
 ---
-## Build and Run
+## 빌드 및 실행
 ```bash
 docker build -t my-hono-app .
 docker run -p 3000:3000 my-hono-app
-# Environment variables
+# 환경 변수
 docker run -p 3000:3000 \
   -e DATABASE_URL="postgresql://..." \
   my-hono-app
@@ -119,7 +119,7 @@ docker compose down
 ---
-## Development
+## 개발용
 ```yaml
 # docker-compose.dev.yml
@@ -178,13 +178,13 @@ jobs:
 ---
-## Troubleshooting
+## 문제 해결
-| Issue | Solution |
-|-------|----------|
-| Port connection failed | Set `HOST=0.0.0.0` |
-| Permission errors | Use non-root user |
-| Out of memory | Use multi-stage build |
+| 문제 | 해결 |
+|------|------|
+| 포트 연결 실패 | `HOST=0.0.0.0` 설정 |
+| 권한 오류 | 비-root 사용자 |
+| 메모리 부족 | 멀티스테이지 빌드 |
 ```bash
 docker exec -it hono-app sh
@@ -194,6 +194,6 @@ docker stats hono-app
 ---
-## Related Documentation
+## 관련 문서
-- [Deployment Guide](./index.md)
+- [배포 가이드](./index.md)

package/templates/hono/docs/deployment/index.md CHANGED Viewed

@@ -1,6 +1,6 @@
-# Nitro v3 Deployment Guide
+# Nitro v3 배포 가이드
-> Hono + Nitro deployment
+> Hono + Nitro 배포
 @docker.md
 @railway.md
@@ -9,7 +9,7 @@
 ---
-## Installation
+## 설치
 ```bash
 npm install nitro@3
@@ -17,7 +17,7 @@ npm install nitro@3
 ---
-## Basic Configuration
+## 기본 설정
 ```typescript
 // nitro.config.ts
@@ -32,7 +32,7 @@ export default defineNitroConfig({
 ---
-## Entry Point
+## 엔트리포인트
 ```typescript
 // src/server.ts
@@ -51,19 +51,19 @@ export default app;
 ## CLI
 ```bash
-npx nitro dev              # Development server
-npx nitro build            # Build
-npx nitro preview          # Preview
-node .output/server/index.mjs  # Run
+npx nitro dev              # 개발 서버
+npx nitro build            # 빌드
+npx nitro preview          # 프리뷰
+node .output/server/index.mjs  # 실행
 ```
 ---
-## Preset Selection
+## Preset 선택
-| Preset | Usage |
-|--------|-------|
-| `node` | Node.js server, Docker |
+| Preset | 용도 |
+|--------|------|
+| `node` | Node.js 서버, Docker |
 | `cloudflare_module` | Cloudflare Workers |
 | `cloudflare_pages` | Cloudflare Pages |
 | `vercel` | Vercel Functions |
@@ -71,7 +71,7 @@ node .output/server/index.mjs  # Run
 ---
-## Environment Variables
+## 환경 변수
 ```typescript
 // nitro.config.ts
@@ -97,22 +97,22 @@ app.get("/config", (c) => {
 ---
-## Project Structure
+## 프로젝트 구조
 ```
-project/
+프로젝트/
 ├── nitro.config.ts
 ├── src/
-│   ├── server.ts      # Hono app
+│   ├── server.ts      # Hono 앱
 │   ├── routes/
 │   └── lib/
-├── .output/           # Build output
+├── .output/           # 빌드 결과물
 └── package.json
 ```
 ---
-## Related Documentation
+## 관련 문서
 - [Docker](./docker.md)
 - [Railway](./railway.md)