@tekton-ui/mcp-server 0.3.1 → 0.3.3

package/README.md

@@ -10,8 +10,8 @@ MCP (Model Context Protocol) server enabling AI-driven blueprint generation, the
 
 ## Features
 
-- **🤖 stdio MCP Protocol**: Claude Code native tool registration via JSON-RPC 2.0 (13 tools)
-- **🎨 Theme Preview**: 13 built-in OKLCH-based themes with CSS variable generation
+- **🤖 stdio MCP Protocol**: Claude Code native tool registration via JSON-RPC 2.0 (16 tools)
+- **🎨 Theme Preview**: 6 built-in OKLCH-based themes with CSS variable generation
 - **📋 Blueprint Generation**: Natural language → Blueprint JSON with validation
 - **💾 Data-Only Output**: No file system writes, Claude Code handles file operations
 - **🚀 Production Export**: JSX, TSX, Vue code generation
@@ -42,49 +42,71 @@ TEKTON_API_KEY=tk_live_xxx...
 TEKTON_API_URL=https://tekton-ui.com  # or http://localhost:3000 for dev
 ```
 
-### Theme Access Tiers
+### Theme Access
 
-**Free Themes** (No authentication required):
+**All Themes** (Requires valid API key and license):
 
-- `next-tailwind-shadcn`
-- `vite-tailwind-shadcn`
-- `next-styled-components`
-- `next-tailwind-radix`
-- `saas-modern`
-- `tech-startup`
+- `classic-magazine` - Classic magazine style
+- `equinox-fitness` - Fitness & wellness
+- `minimal-workspace` - Minimal workspace
+- `neutral-humanism` - Neutral humanism
+- `round-minimal` - Round minimal
+- `square-minimalism` - Square minimalism
 
-**Premium Themes** (Requires valid API key and license):
-
-- `calm-wellness` - Serene wellness applications
-- `dynamic-fitness` - Energetic fitness tracking
-- `korean-fintech` - Professional financial services
-- `media-streaming` - Video/audio streaming platforms
-- `premium-editorial` - Sophisticated content platforms
-- `saas-dashboard` - Modern SaaS dashboards
-- `warm-humanist` - Warm and inviting experiences
+**Note:** All 6 themes require authentication. No free themes are available.
 
 ### Authentication Behavior
 
 **Without API Key**:
 
 - Server starts normally
-- Only free themes are accessible
-- Premium themes return authentication error
+- All theme access attempts return authentication error
+- Tools function but theme-related operations require auth
 
 **With Valid API Key**:
 
 - Server verifies key on startup (cached for 5 minutes)
-- Free themes always accessible
-- Licensed premium themes become accessible
-- Unlicensed premium themes return license error
+- Licensed themes become accessible
+- Unlicensed themes return license error
 
 **With Invalid API Key**:
 
 - Server logs error but continues running
-- Falls back to free themes only
+- Falls back to no theme access
 - Does not crash the server
 
-## Quick Start
+## Quick Start: `init` Command
+
+프로젝트에 Tekton UI를 한 줄로 설정합니다.
+
+```bash
+npx @tekton-ui/mcp-server init
+```
+
+자동으로 수행되는 작업:
+
+1. **프로젝트 감지** - Next.js / Vite 자동 인식
+2. **패키지 설치** - `@tekton-ui/ui`, `tailwindcss-animate` (패키지 매니저 자동 감지: pnpm/yarn/bun/npm)
+3. **Tailwind CSS 설정** - `tailwind.config.ts`에 content 경로 및 animate 플러그인 추가
+4. **CSS 토큰 임포트** - `globals.css`에 `@import '@tekton-ui/ui/styles'` 추가
+5. **MCP 연결** - `.mcp.json`에 tekton 서버 등록 (프로젝트 루트)
+6. **가이드 생성** - `TEKTON-GUIDE.md` 프로젝트 루트에 생성
+7. **AI 에이전트 가이드** - `CLAUDE.md` 및 `AGENTS.md`에 Tekton 워크플로우 섹션 추가
+8. **완료 안내** - 인증 필요성 및 다음 단계 안내
+
+설정 완료 후 Claude Code를 재시작하면, AI에게 "로그인 화면 만들어줘"와 같이 자연어로 화면 생성을 요청할 수 있습니다.
+
+### CLI Commands
+
+| Command                          | Description           |
+| -------------------------------- | --------------------- |
+| `npx @tekton-ui/mcp-server`      | MCP stdio 서버 시작   |
+| `npx @tekton-ui/mcp-server init` | 프로젝트 초기 설정    |
+| `tekton-mcp login`               | 브라우저 OAuth 로그인 |
+| `tekton-mcp logout`              | 로그아웃              |
+| `tekton-mcp status`              | 인증 상태 확인        |
+
+## Development Quick Start
 
 ### 1. Build the Server
 
@@ -104,26 +126,20 @@ pnpm inspect
 
 See [Claude Code Integration Guide](../../.moai/specs/SPEC-MCP-002/CLAUDE-CODE-INTEGRATION.md) for complete setup instructions.
 
-**Quick Config** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+**Quick Config** (프로젝트 루트 `.mcp.json`):
 
 ```json
 {
   "mcpServers": {
     "tekton": {
-      "command": "node",
-      "args": ["/absolute/path/to/tekton/packages/mcp-server/dist/index.js"],
-      "env": {
-        "NODE_ENV": "production",
-        "TEKTON_API_KEY": "tk_live_your_api_key_here",
-        "TEKTON_API_URL": "https://tekton-ui.com"
-      }
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@tekton-ui/mcp-server"]
     }
   }
 }
 ```
 
-**Note**: Remove `TEKTON_API_KEY` from env to run with free themes only.
-
 ## MCP Tools
 
 ### 1. Generate Blueprint
@@ -584,6 +600,42 @@ See [Claude Code Integration Guide](../../.moai/specs/SPEC-MCP-002/CLAUDE-CODE-I
 
 **Total Templates**: 13
 
+## MCP Prompts (Universal Guidance)
+
+The MCP server provides 2 built-in prompts that work across all MCP clients:
+
+### 1. getting-started
+
+**Purpose**: Complete onboarding guide for Tekton UI
+
+**Content**:
+
+- Authentication setup (tekton-mcp login)
+- Theme exploration workflow
+- Component availability checking
+- 4-step screen generation workflow
+- Common mistakes and troubleshooting
+
+**When to use**: First-time users, onboarding, workflow overview
+
+### 2. screen-workflow
+
+**Purpose**: Detailed 4-step production workflow
+
+**Content**:
+
+- Step 1/4: get-screen-generation-context
+- Step 2/4: validate-screen-definition
+- Step 3/4: generate_screen
+- Step 4/4: validate-environment
+- Complete examples and troubleshooting
+
+**When to use**: Production screen generation, workflow clarification
+
+**Note**: These prompts are platform-agnostic and work with Claude Code, OpenAI Codex, Cursor, Windsurf, and any MCP-compatible client.
+
+**Total Prompts**: 2
+
 ### 11. Preview Screen Template
 
 **Tool**: `preview-screen-template`
@@ -806,24 +858,19 @@ packages/mcp-server/
 - ❌ HTTP endpoints removed (moved to SPEC-PLAYGROUND-001)
 - ❌ previewUrl/filePath removed from outputs
 
-## Built-in Themes (13 Total)
-
-1. `calm-wellness` - Serene wellness applications
-2. `dynamic-fitness` - Energetic fitness tracking
-3. `korean-fintech` - Professional financial services
-4. `media-streaming` - Video/audio streaming platforms
-5. `next-styled-components` - Next.js with styled-components
-6. `next-tailwind-radix` - Next.js + Tailwind + Radix UI
-7. `next-tailwind-shadcn` - Next.js + Tailwind + shadcn/ui
-8. `premium-editorial` - Sophisticated content platforms
-9. `saas-dashboard` - Modern SaaS dashboards
-10. `saas-modern` - Clean SaaS applications
-11. `tech-startup` - Tech startup vibes
-12. `vite-tailwind-shadcn` - Vite + Tailwind + shadcn/ui
-13. `warm-humanist` - Warm and inviting experiences
+## Built-in Themes (6 Total)
+
+1. `classic-magazine` - Classic magazine style
+2. `equinox-fitness` - Fitness & wellness
+3. `minimal-workspace` - Minimal workspace
+4. `neutral-humanism` - Neutral humanism
+5. `round-minimal` - Round minimal
+6. `square-minimalism` - Square minimalism
 
 **CSS Format**: All color values use OKLCH format for perceptual uniformity
 
+**Authentication**: All themes require valid API key and license
+
 ## Quality Metrics (SPEC-MCP-002 v2.0.0)
 
 | Metric                       | Target  | Current    | Status |
@@ -898,7 +945,7 @@ All MCP tools reuse `@tekton/core` functions:
 ### Quick Links
 
 - 🧪 [Test Coverage Report](./coverage/) - 94.39% coverage
-- 🎨 [Theme System](../../packages/core/src/themes/) - 13 built-in themes
+- 🎨 [Theme System](../../packages/core/src/themes/) - 6 themes
 - 🧩 [UI Component Library](../../packages/ui/) - 30+ production-ready components
 - 📄 [Template Registry](../../packages/ui/src/templates/) - 13 screen templates
 - 🔧 [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) - Protocol testing tool

package/dist/auth/guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/auth/guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,qBAAa,iBAAkB,SAAQ,KAAK;;CAK3C;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAIlC"}
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/auth/guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,qBAAa,iBAAkB,SAAQ,KAAK;;CAO3C;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAIlC"}

package/dist/auth/guard.js.map

@@ -1 +1 @@
-{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/auth/guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C;QACE,KAAK,CAAC,8GAA8G,CAAC,CAAC;QACtH,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,iBAAiB,EAAE,CAAC;IAChC,CAAC;AACH,CAAC"}
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/auth/guard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C;QACE,KAAK,CACH,8GAA8G,CAC/G,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC;QACvB,MAAM,IAAI,iBAAiB,EAAE,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/auth/theme-access.d.ts

@@ -3,7 +3,7 @@
  * SPEC-DEPLOY-001: 모든 테마 유료 - 인증 필수
  */
 /**
- * 모든 프리미엄 테마 목록
+ * 모든 프리미엄 테마 목록 (실제 존재하는 6개 테마만)
  * 인증된 사용자만 라이선스 보유 테마에 접근 가능
  */
 export declare const PREMIUM_THEMES: string[];

package/dist/auth/theme-access.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme-access.d.ts","sourceRoot":"","sources":["../../src/auth/theme-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,UAc1B,CAAC"}
+{"version":3,"file":"theme-access.d.ts","sourceRoot":"","sources":["../../src/auth/theme-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc,UAO1B,CAAC"}

package/dist/auth/theme-access.js

@@ -3,22 +3,15 @@
  * SPEC-DEPLOY-001: 모든 테마 유료 - 인증 필수
  */
 /**
- * 모든 프리미엄 테마 목록
+ * 모든 프리미엄 테마 목록 (실제 존재하는 6개 테마만)
  * 인증된 사용자만 라이선스 보유 테마에 접근 가능
  */
 export const PREMIUM_THEMES = [
-    'calm-wellness',
-    'dynamic-fitness',
-    'korean-fintech',
-    'media-streaming',
-    'premium-editorial',
-    'saas-dashboard',
-    'warm-humanist',
-    'next-tailwind-shadcn',
-    'vite-tailwind-shadcn',
-    'next-styled-components',
-    'next-tailwind-radix',
-    'saas-modern',
-    'tech-startup',
+    'classic-magazine',
+    'equinox-fitness',
+    'minimal-workspace',
+    'neutral-humanism',
+    'round-minimal',
+    'square-minimalism',
 ];
 //# sourceMappingURL=theme-access.js.map

package/dist/auth/theme-access.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme-access.js","sourceRoot":"","sources":["../../src/auth/theme-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,eAAe;IACf,iBAAiB;IACjB,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,gBAAgB;IAChB,eAAe;IACf,sBAAsB;IACtB,sBAAsB;IACtB,wBAAwB;IACxB,qBAAqB;IACrB,aAAa;IACb,cAAc;CACf,CAAC"}
+{"version":3,"file":"theme-access.js","sourceRoot":"","sources":["../../src/auth/theme-access.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,kBAAkB;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,kBAAkB;IAClB,eAAe;IACf,mBAAmB;CACpB,CAAC"}

package/dist/auth/verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/auth/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC,CAAC;IACH,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,0CAA0C;QAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAiD1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,EAAE,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,cAAc,GAAG,IAAI,GACpC,OAAO,CAST"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/auth/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC,CAAC;IACH,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,0CAA0C;QAC1C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAiD1E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,cAAc,GAAG,MAAM,EAAE,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CASjG"}

package/dist/auth/verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/auth/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAuB7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,uBAAuB,CAAC;IACrE,MAAM,QAAQ,GAAG,GAAG,MAAM,iBAAiB,CAAC;IAE5C,IAAI,CAAC;QACH,IAAI,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;QAErD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YACrC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,MAAM,EAAE;gBACjC,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,QAAQ,CAAC,gCAAgC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAEnF,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,wBAAwB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE;aACvF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAC;QAEvD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,QAAQ,CAAC,uBAAuB,IAAI,CAAC,KAAK,IAAI,gBAAgB,EAAE,CAAC,CAAC;YAClE,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,oBAAoB;aAC1C,CAAC;QACJ,CAAC;QAED,IAAI,CACF,2CAA2C,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,SAAS,WAAW,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS,GAAG,CACnH,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,QAAQ,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;QAExD,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,kBAAkB,YAAY,EAAE;SACxC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,cAA8B;IAC/D,IAAI,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;QACpD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,cAAc,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,cAAqC;IAErC,QAAQ;IACR,IAAI,CAAC,cAAc,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oBAAoB;IACpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/auth/verify.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAuB7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,uBAAuB,CAAC;IACrE,MAAM,QAAQ,GAAG,GAAG,MAAM,iBAAiB,CAAC;IAE5C,IAAI,CAAC;QACH,IAAI,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;QAErD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YACrC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,aAAa,EAAE,UAAU,MAAM,EAAE;gBACjC,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,QAAQ,CAAC,gCAAgC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAEnF,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,wBAAwB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,MAAM,SAAS,EAAE;aACvF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAC;QAEvD,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,QAAQ,CAAC,uBAAuB,IAAI,CAAC,KAAK,IAAI,gBAAgB,EAAE,CAAC,CAAC;YAClE,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,oBAAoB;aAC1C,CAAC;QACJ,CAAC;QAED,IAAI,CACF,2CAA2C,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,SAAS,WAAW,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS,GAAG,CACnH,CAAC;QAEF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,QAAQ,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;QAExD,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,kBAAkB,YAAY,EAAE;SACxC,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,cAA8B;IAC/D,IAAI,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;QACpD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,cAAc,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,cAAqC;IACtF,QAAQ;IACR,IAAI,CAAC,cAAc,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oBAAoB;IACpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,cAAc,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC"}

package/dist/cli/agent-md-templates.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Agent guidance templates for CLAUDE.md and AGENTS.md
+ * Provides framework-specific Tekton workflow instructions
+ */
+export type Framework = 'nextjs' | 'vite';
+/**
+ * Generate CLAUDE.md section for Claude Code
+ * (Claude Code-specific patterns and MCP integration)
+ */
+export declare function generateClaudeMdSection(framework: Framework): string;
+/**
+ * Generate AGENTS.md section for generic AI agents
+ * (Platform-agnostic guidance for OpenAI Codex, Cursor, Windsurf, etc.)
+ */
+export declare function generateAgentsMdSection(framework: Framework): string;
+//# sourceMappingURL=agent-md-templates.d.ts.map

package/dist/cli/agent-md-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-md-templates.d.ts","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAyHpE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAoMpE"}

package/dist/cli/agent-md-templates.js

@@ -0,0 +1,330 @@
+/**
+ * Agent guidance templates for CLAUDE.md and AGENTS.md
+ * Provides framework-specific Tekton workflow instructions
+ */
+/**
+ * Generate CLAUDE.md section for Claude Code
+ * (Claude Code-specific patterns and MCP integration)
+ */
+export function generateClaudeMdSection(framework) {
+    const importPath = framework === 'nextjs' ? 'app/page.tsx' : 'src/App.tsx';
+    return `
+## Tekton UI Workflow (Claude Code)
+
+### MCP Server Connection
+
+Tekton MCP server is configured in \`.mcp.json\`. Claude Code automatically loads 16 tools for screen generation.
+
+### Authentication (Step 1)
+
+Before generating any screens, authenticate:
+
+\`\`\`bash
+tekton-mcp login
+\`\`\`
+
+**Important:** All 6 themes require authentication. No free themes are available.
+
+### Screen Generation Workflow (4 Steps)
+
+**Step 1/4:** Gather Context
+- Call \`get-screen-generation-context\` with user's screen description
+- Receive template matches, component suggestions, and schema
+
+**Step 2/4:** Validate Definition
+- Generate Screen Definition JSON based on context
+- Call \`validate-screen-definition\` to verify structure
+- Fix any errors before proceeding
+
+**Step 3/4:** Generate Code
+- Call \`generate_screen\` with validated definition
+- Receive production React code and dependencies list
+- Check \`dependencies.external\` field
+
+**Step 4/4:** Validate Environment
+- Call \`validate-environment\` with project path and required packages
+- Verify Tailwind CSS configuration
+- Show user install commands for missing packages
+
+### Component Usage Example
+
+\`\`\`tsx
+// ${importPath}
+import { Button, Card, CardHeader, CardTitle, CardContent } from '@tekton-ui/ui';
+
+export default function Page() {
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle>Welcome to Tekton</CardTitle>
+      </CardHeader>
+      <CardContent>
+        <Button variant="default" size="lg">Get Started</Button>
+      </CardContent>
+    </Card>
+  );
+}
+\`\`\`
+
+### Available Tools
+
+**Discovery (6 tools):**
+- \`list-themes\` - List 6 available themes
+- \`preview-theme\` - Get theme design tokens
+- \`list-components\` - List 30+ UI components
+- \`preview-component\` - Get component props and variants
+- \`list-screen-templates\` - List 13 screen templates
+- \`preview-screen-template\` - Get template structure
+
+**Screen Generation (4 tools):**
+- \`get-screen-generation-context\` - Step 1/4
+- \`validate-screen-definition\` - Step 2/4
+- \`generate_screen\` - Step 3/4
+- \`validate-environment\` - Step 4/4
+
+**Quick Prototyping (3 tools):**
+- \`generate-blueprint\` - Quick UI structure
+- \`export-screen\` - Export to JSX/TSX/Vue
+- \`list_tokens\` - List layout tokens
+
+**Icon Libraries (2 tools):**
+- \`list-icon-libraries\` - List available icon libraries
+- \`preview-icon-library\` - Preview icon library
+
+**Additional:**
+- \`validate_screen\` - Simple validation (use \`validate-screen-definition\` for production)
+
+### MCP Prompts (Universal Guidance)
+
+Claude Code can access built-in prompts for guidance:
+
+- \`getting-started\` - Authentication → Theme → Components → Screen generation
+- \`screen-workflow\` - Detailed 4-step workflow with troubleshooting
+
+These prompts work across all MCP clients, not just Claude Code.
+
+### Common Mistakes to Avoid
+
+1. ❌ Skipping authentication before generating screens
+2. ❌ Using non-existent theme IDs (only 6 exist)
+3. ❌ Skipping validate-screen-definition step
+4. ❌ Not checking dependencies.external field
+5. ❌ Delivering code without verifying Tailwind config
+
+### Troubleshooting
+
+**Authentication issues:**
+- Run \`tekton-mcp status\` to check authentication
+- Run \`tekton-mcp login\` to re-authenticate
+
+**Missing styles:**
+- Run \`validate-environment\` to check Tailwind config
+- Verify \`@tekton-ui/ui\` content paths are included
+- Check \`tailwindcss-animate\` plugin is configured
+
+**Component not found:**
+- Use \`list-components\` to verify component exists
+- Use \`preview-component\` to check correct component ID
+`;
+}
+/**
+ * Generate AGENTS.md section for generic AI agents
+ * (Platform-agnostic guidance for OpenAI Codex, Cursor, Windsurf, etc.)
+ */
+export function generateAgentsMdSection(framework) {
+    const importPath = framework === 'nextjs' ? 'app/page.tsx' : 'src/App.tsx';
+    return `
+## Tekton UI Workflow (AI Agents)
+
+### Overview
+
+Tekton MCP server provides 16 tools for screen generation via Model Context Protocol (MCP). This guide is for AI agents on platforms like OpenAI Codex, Cursor, Windsurf, and other MCP-compatible clients.
+
+### Prerequisites
+
+1. **MCP Server Running:** Ensure \`@tekton-ui/mcp-server\` is running and connected
+2. **Authentication:** User must run \`tekton-mcp login\` before generating screens
+3. **Project Setup:** \`@tekton-ui/ui\` and \`tailwindcss-animate\` must be installed
+
+### Required Authentication Flow
+
+**Step 1:** Check authentication status
+\`\`\`bash
+tekton-mcp status
+\`\`\`
+
+**Step 2:** If not authenticated, instruct user:
+\`\`\`bash
+tekton-mcp login
+\`\`\`
+
+**Important:** All 6 themes require valid licenses. There are no free themes available.
+
+### Screen Generation Workflow (4 Steps)
+
+Follow this exact sequence for production-ready screens:
+
+#### Step 1/4: Gather Context
+
+**Tool:** \`get-screen-generation-context\`
+
+**Purpose:** Get all context needed to create Screen Definition
+
+**Input:**
+\`\`\`json
+{
+  "description": "user dashboard with profile card",
+  "themeId": "minimal-workspace",
+  "includeExamples": true
+}
+\`\`\`
+
+**Output:** Template matches, component suggestions, schema, examples
+
+#### Step 2/4: Validate Definition
+
+**Tool:** \`validate-screen-definition\`
+
+**Purpose:** Ensure Screen Definition JSON is correct
+
+**Input:**
+\`\`\`json
+{
+  "definition": {
+    "id": "user-dashboard",
+    "shell": "shell.web.dashboard",
+    "page": "page.dashboard",
+    "sections": [...]
+  },
+  "strict": true
+}
+\`\`\`
+
+**Output:** Validation results with errors, warnings, suggestions
+
+**Critical:** Always validate before Step 3. Fix all errors before proceeding.
+
+#### Step 3/4: Generate Code
+
+**Tool:** \`generate_screen\`
+
+**Purpose:** Generate production React code
+
+**Input:**
+\`\`\`json
+{
+  "screenDefinition": { /* from Step 2 */ },
+  "outputFormat": "tailwind",
+  "options": {
+    "typescript": true,
+    "prettier": true
+  }
+}
+\`\`\`
+
+**Output:** React code + dependencies
+
+**Critical:** Check \`dependencies.external\` field. If non-empty, proceed to Step 4.
+
+#### Step 4/4: Validate Environment
+
+**Tool:** \`validate-environment\`
+
+**Purpose:** Verify project has required packages and Tailwind config
+
+**Input:**
+\`\`\`json
+{
+  "projectPath": "/path/to/package.json",
+  "requiredPackages": ["framer-motion", "@radix-ui/react-slot"],
+  "checkTailwind": true
+}
+\`\`\`
+
+**Output:** Missing packages, install commands, Tailwind validation
+
+**Critical:** Always inform user about missing packages and Tailwind config issues.
+
+### Discovery Tools
+
+Before generating screens, explore available resources:
+
+**Themes (6 total, all require authentication):**
+- \`list-themes\` → See all 6 themes
+- \`preview-theme\` → Get theme design tokens
+
+**Components (30+ available):**
+- \`list-components\` → Browse component catalog
+- \`preview-component\` → Get component props, variants, examples
+
+**Templates (13 available):**
+- \`list-screen-templates\` → Browse screen templates
+- \`preview-screen-template\` → Get template structure
+
+### Component Usage Example
+
+\`\`\`tsx
+// ${importPath}
+import { Button, Card, CardHeader, CardTitle, CardContent } from '@tekton-ui/ui';
+
+export default function Page() {
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle>Welcome</CardTitle>
+      </CardHeader>
+      <CardContent>
+        <Button variant="default">Get Started</Button>
+      </CardContent>
+    </Card>
+  );
+}
+\`\`\`
+
+### MCP Prompts (Universal Guidance)
+
+Your MCP client may support prompts. If available:
+
+- \`getting-started\` - Complete onboarding guide
+- \`screen-workflow\` - Detailed 4-step workflow
+
+These provide context to help you guide users effectively.
+
+### Error Handling
+
+**Authentication errors:**
+- Instruct user to run \`tekton-mcp login\`
+- Verify with \`tekton-mcp status\`
+
+**Validation errors (Step 2):**
+- Read error messages - they include suggestions
+- Fix errors in Screen Definition
+- Re-run \`validate-screen-definition\`
+
+**Missing dependencies (Step 3):**
+- Always run Step 4 to check environment
+- Show user install commands from \`validate-environment\`
+
+**Missing styles (runtime):**
+- Run \`validate-environment\` to diagnose
+- Check Tailwind config includes \`@tekton-ui/ui\` content paths
+- Check \`tailwindcss-animate\` plugin is configured
+
+### Best Practices
+
+1. ✅ Always authenticate before generating screens
+2. ✅ Follow all 4 workflow steps in order
+3. ✅ Validate before generating (Step 2 before Step 3)
+4. ✅ Check environment before delivering code (Step 4)
+5. ✅ Inform user about missing dependencies and Tailwind issues
+6. ✅ Use \`strict: true\` for production validation
+
+### Quick Reference: All 16 Tools
+
+**Discovery:** list-themes, preview-theme, list-components, preview-component, list-screen-templates, preview-screen-template
+**Workflow:** get-screen-generation-context, validate-screen-definition, generate_screen, validate-environment
+**Quick:** generate-blueprint, export-screen, validate_screen, list_tokens
+**Icons:** list-icon-libraries, preview-icon-library
+`;
+}
+//# sourceMappingURL=agent-md-templates.js.map

package/dist/cli/agent-md-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-md-templates.js","sourceRoot":"","sources":["../../src/cli/agent-md-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAyCJ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Ed,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB;IAC1D,MAAM,UAAU,GAAG,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmIJ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6Dd,CAAC;AACF,CAAC"}

package/dist/cli/guide-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guide-template.d.ts","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAmI1D"}
+{"version":3,"file":"guide-template.d.ts","sourceRoot":"","sources":["../../src/cli/guide-template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE1C;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CA8L1D"}