@loom-framework/core 0.1.0-alpha.4 → 0.1.0-alpha.40

package/dist/types.d.ts

@@ -92,11 +92,12 @@ export interface ReadOptions {
     limit?: number;
     offset?: number;
 }
+export type DataRecord = Record<string, unknown>;
 export interface DataAdapter {
     readonly name: string;
-    read(model: string, options?: ReadOptions): Promise<unknown>;
-    write(model: string, data: Record<string, unknown>): Promise<unknown>;
-    update(model: string, id: string, data: Record<string, unknown>): Promise<unknown>;
+    read(model: string, options?: ReadOptions): Promise<DataRecord | DataRecord[] | null>;
+    write(model: string, data: DataRecord): Promise<DataRecord>;
+    update(model: string, id: string, data: DataRecord): Promise<DataRecord>;
     delete(model: string, id: string): Promise<void>;
     getSchema(model: string): Promise<ModelSchema | undefined>;
     listModels(): Promise<string[]>;
@@ -138,7 +139,7 @@ export interface AIUsage {
     contextWindow: number;
 }
 export interface AIChunk {
-    type: 'content' | 'session_info' | 'error' | 'done' | 'tool_call' | 'tool_result';
+    type: 'content' | 'thinking' | 'session_info' | 'error' | 'done' | 'tool_call' | 'tool_result';
     content?: string;
     sessionId?: string;
     usage?: AIUsage;
@@ -152,12 +153,6 @@ export interface AIEngine {
     readonly name: string;
     call(prompt: string, options: AICallOptions): AsyncGenerator<AIChunk>;
 }
-export interface ActiveSession {
-    id: string;
-    claudeSessionId?: string;
-    lastActivity: number;
-    createdAt: number;
-}
 export interface UserMessageEvent {
     type: 'user_message';
     content: string;
@@ -198,7 +193,5 @@ export interface ToolCallEvent {
     result?: unknown;
     error?: string;
 }
-/** @deprecated Use ChatEvent instead */
-export type WebSocketEvent = ChatEvent;
 export type ChatEvent = UserMessageEvent | AssistantChunkEvent | AssistantCompleteEvent | ToolCallEvent;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,UAAU,GACV,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAID,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,YAAY,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,6BAA6B;IAC7B,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAID,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,CAAC,EAAE,QAAQ,CAAC;IACd,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;CAC9B;AAID,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IACtF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAC3D,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAID,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,IAAI,WAAW,CAAC;CAC/B;AAID,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,aAAa,CAAC;IAC/F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;CACvE;AAID,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,KAAK,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,IAAI,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAC1C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,sBAAsB,GACtB,aAAa,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loom-framework/core",
-  "version": "0.1.0-alpha.4",
-  "description": "Loom framework core - DataAdapter, Capability Generator, config system",
+  "version": "0.1.0-alpha.40",
+  "description": "Loom framework - DataAdapter, Capability Generator, config system, backend server, CLI",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,8 +11,13 @@
       "types": "./dist/index.d.ts"
     }
   },
+  "bin": {
+    "loom": "./dist/bin.js",
+    "loom-server": "./dist/server-bin.js"
+  },
   "files": [
-    "dist"
+    "dist",
+    "templates"
   ],
   "scripts": {
     "build": "tsc",
@@ -22,7 +27,14 @@
   },
   "dependencies": {
     "jiti": "^2.6.1",
-    "zod": "^3.23.0"
+    "zod": "^3.23.0",
+    "fastify": "^5.2.0",
+    "@fastify/cors": "^10.0.0",
+    "@fastify/static": "^8.0.0",
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "glob": "^11.0.0"
   },
   "optionalDependencies": {
     "better-sqlite3": "^12.8.0"
@@ -31,4 +43,4 @@
     "@types/better-sqlite3": "^7.6.13",
     "typescript": "^5.6.0"
   }
-}
+}

package/templates/skill/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: Loom
+description: |
+  Use this skill when the user asks to "create a new loom project", "用loom开发一个系统",
+  "开发一个AI平台应用", "为系统添加页面", "为项目配置 AI 按钮功能", or any Loom framework task.
+  Loom is an AI-Native full-stack framework.
+version: 0.1.0
+---
+
+# Loom - AI-Native Framework Skill
+
+## Quick Start
+
+1. Confirm project scope: name, description, data models, skills
+2. Create project:
+   `npx @loom-framework/core@latest loom init <name> --description <desc> --adapter <filesystem|sqlite>`
+3. Define data models in `loom.config.ts` (see Schema below)
+4. Generate pages: `loom generate page <Name> --model <model>`
+5. Start dev: `loom dev` → http://localhost:5173 (frontend), http://localhost:3000 (backend)
+
+**Important:** Always run commands from the project directory (not the loom monorepo root).
+
+## Core CLI Commands
+
+- `loom dev` - Start dev environment (hot-reload)
+  - `--skip-generate`, `--backend-only`, `--frontend-only`
+- `loom build` - Build for production
+- `loom generate capabilities` - Generate MCP Server + CLI from config
+- `loom generate page <name> --model <model>` - Generate CRUD page (includes capabilities + wiring)
+- `loom generate skill <name>` - Generate skill scaffold
+
+## Detailed Workflows
+
+### Adding a New Data Model
+
+1. Edit `loom.config.ts` → add model definition (see Schema below; for advanced options see `references/data-model.md`)
+2. Run `loom generate page <Name> --model <model-name>`
+3. Model is immediately available via MCP Tools and `loom data` CLI
+
+### Adding a New Skill
+
+1. Create scaffold: `loom generate skill <name>`
+2. Edit `.claude/skills/<name>/SKILL.md` (see `references/skill-development.md` for format)
+3. Add reference prompts in `.claude/skills/<name>/references/`
+
+### Adding an AI Button
+
+1. Edit `loom.config.ts` → add entry to `aiButtons` array (top-level, not inside `ai`)
+2. In frontend page, use `useAIButton('<button-id>')` or `<AIActionButton buttonId="<id>" />`
+
+## loom.config.ts Schema (Core)
+
+```typescript
+import { defineConfig } from '@loom-framework/core';
+
+export default defineConfig({
+  project: {
+    name: 'my-app',           // required
+    description: '...',',     // optional
+  },
+  data: {
+    defaultAdapter: 'filesystem',  // 'filesystem' | 'sqlite'
+    models: [{
+      name: 'items',          // lowercase, hyphens/underscores allowed
+      description: '...',',   // optional: shown in generated pages
+      fields: [{
+        name: 'status',       // alphanumeric + underscore, start with letter/underscore
+        type: 'string',       // 'string' | 'number' | 'boolean' | 'date' | 'string[]' | 'number[]' | 'json'
+        required: true,       // optional, default false
+        description: '...,',  // optional: shown in forms
+        default: 'active',    // optional: auto-filled on write
+        enum: ['active', 'inactive'],  // optional: restrict values
+      }],
+    }],
+  },
+  aiButtons: [{               // optional
+    id: 'summarize',          // required: unique identifier
+    label: '总结',             // required: button text
+    prompt: '请总结以下内容',    // required (or promptTemplate)
+  }],
+});
+```
+
+For advanced config (`ai.claudeCode`, `server`, per-model `adapters`, `indexes`, `aiButtons.promptTemplate/contextVars`), see `references/data-model.md`.
+
+## Troubleshooting
+
+- **`loom` commands fail "No loom.config.ts found"**: Run commands from the project directory, not the loom monorepo root
+- **create-loom-app not on npm**: Use `npx @loom-framework/core loom init <name> --description <desc> --adapter <filesystem|sqlite>`
+
+See `references/troubleshooting.md` for more issues.

package/templates/skill/references/README.md

@@ -0,0 +1,67 @@
+# Loom - AI-Native Full-Stack Framework
+
+编织 AI 能力为应用织物
+
+## 核心理念
+
+- **Prompt as Code**: 业务逻辑写在 Skill 的 Markdown 中，而非后端代码
+- **Schema-driven**: 一个模型定义 → MCP Tool + CLI 命令 + REST API（自动同步）
+- **Zero Backend Logic**: 后端是透明代理，所有智能在 Skill 中
+
+## 三种交互类型
+
+| 类型 | 说明 | 实现方式 |
+|------|------|---------|
+| AI Chat | 自然语言对话 | HTTP SSE 流式，Claude Code 引擎 |
+| AI Buttons | 一键 AI 动作 | 预定义 Prompt，`aiButtons` 配置 |
+| CRUD | 结构化数据管理 | REST API，Schema 驱动自动生成 |
+
+## 项目结构
+
+```
+my-loom-app/
+├── loom.config.ts       # 唯一配置源（模型、AI 按钮、服务器配置）
+├── frontend/            # React + TypeScript + Vite
+│   └── src/pages/       # 业务页面（CRUD 等）
+├── backend/src/         # Fastify + AI 通信（LoomServer）
+├── .claude/skills/      # Skills（Prompt as Code）
+├── cli/src/commands/    # CLI 业务命令扩展
+├── data/                # 数据存储（DataAdapter 管理）
+└── .loom/               # 自动生成（gitignore）
+    ├── mcp-server/      # MCP Server（自动生成）
+    └── mcp.json         # MCP 配置
+```
+
+## CLI 命令速查
+
+### 开发
+
+| 命令 | 说明 |
+|------|------|
+| `loom dev` | 启动开发环境（前端 + 后端，热更新） |
+| `loom build` | 生产构建 |
+
+### 生成
+
+| 命令 | 说明 |
+|------|------|
+| `loom generate page <Name> --model <model>` | 生成 CRUD 页面 |
+| `loom generate skill <name>` | 生成 Skill 脚手架 |
+| `loom generate capabilities` | 重新生成 MCP Server + CLI |
+
+### 数据
+
+| 命令 | 说明 |
+|------|------|
+| `loom data read <model>` | 读取记录 |
+| `loom data write <model> --data '<json>'` | 写入记录 |
+| `loom data schema [model]` | 查看模型定义 |
+
+### 其他
+
+| 命令 | 说明 |
+|------|------|
+| `loom skill list` | 列出所有 Skill |
+| `loom skill validate [name]` | 校验 Skill 结构 |
+| `loom observe logs` | 查看 AI 交互日志 |
+| `loom observe metrics` | 查看聚合指标 |

package/templates/skill/references/data-model.md

@@ -0,0 +1,87 @@
+# Data Model Reference
+
+Advanced configuration for `loom.config.ts` data models. Load this when defining complex models.
+
+## Full Field Options
+
+```typescript
+{
+  name: 'status',         // must match ^[a-zA-Z_][a-zA-Z0-9_]*$
+  type: 'string',         // 'string' | 'number' | 'boolean' | 'date' | 'string[]' | 'number[]' | 'json'
+  required: true,         // optional, default false
+  description: '...',',   // optional: shown in generated forms
+  default: 'active',      // optional: auto-filled on write if not provided
+  enum: ['active', 'inactive', 'archived'],  // optional: restrict to allowed values
+}
+```
+
+## Model-Level Options
+
+```typescript
+{
+  name: 'orders',
+  description: 'Order records',  // shown in generated page heading
+  fields: [...],
+  indexes: [                     // optional: database indexes
+    { fields: ['userId', 'status'], unique: false },
+  ],
+  adapters: {                    // optional: per-model adapter override
+    filesystem: { dir: 'orders', format: 'json' | 'yaml', datePattern: 'yyyy-MM-dd' },
+    sqlite: { table: 'orders' },
+  },
+},
+```
+
+## AI Configuration
+
+```typescript
+ai: {
+  engine: 'claude-code',           // default 'claude-code'
+  claudeCode: {
+    path: '/usr/local/bin/claude', // custom claude binary path
+    pluginRoot: '.claude',         // plugin root directory
+    timeout: 120000,               // command timeout in ms
+    skipPermissions: false,        // skip permission prompts
+    defaultModel: 'claude-sonnet-4-6',
+  },
+},
+```
+
+## Server Configuration
+
+```typescript
+server: {
+  port: 3000,              // default 3000
+  host: '0.0.0.0',
+  cors: true,              // default true
+  staticDir: './dist/frontend',
+},
+```
+
+## SQLite Configuration
+
+```typescript
+data: {
+  defaultAdapter: 'sqlite',
+  sqlite: { filename: 'data.db' },  // default 'loom.db'
+}
+```
+
+## AI Buttons (Full Options)
+
+```typescript
+aiButtons: [{
+  id: 'summarize',               // required: unique identifier
+  label: '总结',                  // required: button text
+  icon: 'FileTextOutlined',      // optional: Ant Design icon name
+  prompt: '请总结以下内容',         // required (or promptTemplate)
+  promptTemplate: 'Summarize {{content}}',  // alternative to prompt, with {{vars}}
+  contextVars: ['content'],      // optional: variable names for promptTemplate
+  placement: 'page-header',      // optional: UI placement hint
+}],
+```
+
+## Data Access in Skills
+
+- **Prefer MCP Tools** for data CRUD: `read_<model>`, `write_<model>`, `update_<model>`, `delete_<model>`
+- Use `loom data read/write <model>` CLI only for debugging

package/templates/skill/references/skill-development.md

@@ -0,0 +1,46 @@
+# Skill Development Reference
+
+Guide for creating and managing Loom Skills. Load this when adding or editing `.claude/skills/`.
+
+## Skill Structure
+
+```
+.claude/skills/<skill-name>/
+├── SKILL.md          # Required: trigger conditions + workflow
+└── references/       # Optional: detailed rules and reference docs
+    └── *.md
+```
+
+## SKILL.md Format
+
+```markdown
+---
+name: <skill-name>
+description: |
+  This skill should be used when the user asks to "<trigger phrases>".
+  Include both English and Chinese trigger phrases.
+version: 1.0.0
+---
+
+# <Skill Name>
+
+<Description of what this skill does>
+
+## Workflow
+
+1. <Step 1>
+2. <Step 2>
+
+## Rules
+
+- <Rule 1>
+- <Rule 2>
+```
+
+## Best Practices
+
+- Keep SKILL.md focused on one capability domain
+- Use `references/` for detailed rules that would clutter the main SKILL.md
+- Specify which MCP Tools (`read_<model>`, `write_<model>`) the skill should use
+- Skills define behavior through prompts, not code generation
+- Run `loom skill validate [name]` to check SKILL.md structure

package/templates/skill/references/troubleshooting.md

@@ -0,0 +1,35 @@
+# Troubleshooting Guide
+
+Common issues when creating and running Loom projects.
+
+## `loom generate` Fails: Cannot find module '@loom-framework/core'
+
+Dependencies not installed. Run `npm install` from the project directory.
+
+## `loom dev` Port Already in Use (EADDRINUSE)
+
+Previous process still running. Kill it: `lsof -ti:3000 | xargs kill -9`
+
+## Commands Fail: "No loom.config.ts found"
+
+Running from the wrong directory. `cd` into the project directory before running `loom` commands.
+
+## Model Name Validation Error
+
+Model names must match `^[a-z][a-z0-9_-]*$` (lowercase, hyphens/underscores allowed).
+Field names must match `^[a-zA-Z_][a-zA-Z0-9_]*$`.
+
+## `loom build` Backend TSC Fails: Cannot use JSX
+
+Root `tsconfig.json` includes `frontend/` with `.tsx` files.
+Add `"frontend"` to `exclude` in root `tsconfig.json`:
+```json
+{ "exclude": ["node_modules", "dist", "frontend"] }
+```
+Frontend has its own `frontend/tsconfig.json` with `jsx: "react-jsx"`.
+
+## Debug Tips
+
+- `loom data schema <model>` — inspect model fields
+- `loom observe logs` — view AI interaction logs
+- `loom skill validate` — check skill structure