@arrislink/axon 1.2.0 → 1.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arrislink/axon",
-  "version": "1.2.0",
+  "version": "1.5.0",
   "description": "AI-Powered Development Operating System with unified LLM provider support",
   "type": "module",
   "main": "dist/index.js",

package/templates/skills/api/rest-crud.md

@@ -1,240 +0,0 @@
----
-name: RESTful CRUD API
-description: 实现标准 RESTful CRUD 接口
-tags: [api, rest, crud, typescript]
-models: [claude-sonnet-4, gpt-4]
-tokens_avg: 2200
-difficulty: easy
-last_updated: 2026-02-09
----
-
-## Context
-
-实现标准的 RESTful CRUD API，包括列表、详情、创建、更新和删除操作。
-
-## Prerequisites
-
-- Hono / Express / Fastify
-- TypeScript
-- 数据验证库 (Zod)
-
-## Implementation
-
-### 1. 路由结构
-
-| 方法 | 路径 | 描述 |
-|------|------|------|
-| GET | /api/items | 获取列表 (分页) |
-| GET | /api/items/:id | 获取详情 |
-| POST | /api/items | 创建 |
-| PUT | /api/items/:id | 完整更新 |
-| PATCH | /api/items/:id | 部分更新 |
-| DELETE | /api/items/:id | 删除 |
-
-### 2. 使用 Hono 实现
-
-```typescript
-// src/routes/items.ts
-import { Hono } from 'hono';
-import { zValidator } from '@hono/zod-validator';
-import { z } from 'zod';
-
-const app = new Hono();
-
-// 验证 Schema
-const createItemSchema = z.object({
-  name: z.string().min(1).max(100),
-  description: z.string().optional(),
-  price: z.number().positive(),
-  category: z.enum(['electronics', 'clothing', 'food']),
-});
-
-const updateItemSchema = createItemSchema.partial();
-
-const querySchema = z.object({
-  page: z.coerce.number().min(1).default(1),
-  limit: z.coerce.number().min(1).max(100).default(20),
-  sort: z.enum(['newest', 'oldest', 'price_asc', 'price_desc']).default('newest'),
-  category: z.string().optional(),
-});
-
-// GET /items - 列表
-app.get('/', zValidator('query', querySchema), async (c) => {
-  const { page, limit, sort, category } = c.req.valid('query');
-  const offset = (page - 1) * limit;
-
-  const items = await db.query.items.findMany({
-    where: category ? eq(items.category, category) : undefined,
-    limit,
-    offset,
-    orderBy: getSortOrder(sort),
-  });
-
-  const total = await db.select({ count: count() }).from(items);
-
-  return c.json({
-    data: items,
-    pagination: {
-      page,
-      limit,
-      total: total[0].count,
-      totalPages: Math.ceil(total[0].count / limit),
-    },
-  });
-});
-
-// GET /items/:id - 详情
-app.get('/:id', async (c) => {
-  const id = c.req.param('id');
-  const item = await db.query.items.findFirst({
-    where: eq(items.id, id),
-  });
-
-  if (!item) {
-    return c.json({ error: 'Item not found' }, 404);
-  }
-
-  return c.json({ data: item });
-});
-
-// POST /items - 创建
-app.post('/', zValidator('json', createItemSchema), async (c) => {
-  const data = c.req.valid('json');
-
-  const [item] = await db.insert(items).values(data).returning();
-
-  return c.json({ data: item }, 201);
-});
-
-// PUT /items/:id - 完整更新
-app.put('/:id', zValidator('json', createItemSchema), async (c) => {
-  const id = c.req.param('id');
-  const data = c.req.valid('json');
-
-  const [item] = await db
-    .update(items)
-    .set({ ...data, updatedAt: new Date() })
-    .where(eq(items.id, id))
-    .returning();
-
-  if (!item) {
-    return c.json({ error: 'Item not found' }, 404);
-  }
-
-  return c.json({ data: item });
-});
-
-// PATCH /items/:id - 部分更新
-app.patch('/:id', zValidator('json', updateItemSchema), async (c) => {
-  const id = c.req.param('id');
-  const data = c.req.valid('json');
-
-  const [item] = await db
-    .update(items)
-    .set({ ...data, updatedAt: new Date() })
-    .where(eq(items.id, id))
-    .returning();
-
-  if (!item) {
-    return c.json({ error: 'Item not found' }, 404);
-  }
-
-  return c.json({ data: item });
-});
-
-// DELETE /items/:id - 删除
-app.delete('/:id', async (c) => {
-  const id = c.req.param('id');
-
-  const [item] = await db
-    .delete(items)
-    .where(eq(items.id, id))
-    .returning();
-
-  if (!item) {
-    return c.json({ error: 'Item not found' }, 404);
-  }
-
-  return c.json({ message: 'Deleted successfully' });
-});
-
-export default app;
-```
-
-### 3. 响应格式规范
-
-```typescript
-// 成功响应
-{
-  "data": { ... } | [ ... ],
-  "pagination": { ... }  // 仅列表接口
-}
-
-// 错误响应
-{
-  "error": "Error message",
-  "code": "ERROR_CODE",
-  "details": { ... }  // 可选
-}
-```
-
-### 4. HTTP 状态码规范
-
-| 状态码 | 含义 | 使用场景 |
-|--------|------|----------|
-| 200 | OK | GET, PUT, PATCH 成功 |
-| 201 | Created | POST 成功 |
-| 204 | No Content | DELETE 成功 (无响应体) |
-| 400 | Bad Request | 请求参数错误 |
-| 401 | Unauthorized | 未认证 |
-| 403 | Forbidden | 无权限 |
-| 404 | Not Found | 资源不存在 |
-| 409 | Conflict | 资源冲突 (如重复) |
-| 422 | Unprocessable | 验证失败 |
-| 500 | Internal Error | 服务器错误 |
-
-## Tests
-
-```typescript
-// tests/routes/items.test.ts
-import { describe, test, expect } from 'bun:test';
-import app from '../../src/routes/items';
-
-describe('Items API', () => {
-  test('GET /items returns list', async () => {
-    const res = await app.request('/');
-    expect(res.status).toBe(200);
-
-    const data = await res.json();
-    expect(data.data).toBeArray();
-    expect(data.pagination).toBeDefined();
-  });
-
-  test('POST /items creates item', async () => {
-    const res = await app.request('/', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        name: 'Test Item',
-        price: 99.99,
-        category: 'electronics',
-      }),
-    });
-
-    expect(res.status).toBe(201);
-    const data = await res.json();
-    expect(data.data.name).toBe('Test Item');
-  });
-
-  test('GET /items/:id returns 404 for missing', async () => {
-    const res = await app.request('/non-existent-id');
-    expect(res.status).toBe(404);
-  });
-});
-```
-
-## Related Skills
-
-- api/pagination.md
-- api/error-handling.md
-- api/rate-limiting.md

package/templates/skills/auth/jwt.md

@@ -1,186 +0,0 @@
----
-name: JWT Authentication Implementation
-description: 实现基于 JWT 的用户认证系统
-tags: [auth, jwt, security, typescript]
-models: [claude-sonnet-4, gpt-4]
-tokens_avg: 2500
-difficulty: medium
-last_updated: 2026-02-09
----
-
-## Context
-
-实现一个安全的 JWT 认证系统，包括 token 生成、验证和刷新机制。
-
-## Prerequisites
-
-- Node.js >= 18 或 Bun
-- jsonwebtoken 库
-- 环境变量: JWT_SECRET, JWT_EXPIRES_IN
-
-## Implementation
-
-### 1. 安装依赖
-
-```bash
-bun add jsonwebtoken
-bun add -d @types/jsonwebtoken
-```
-
-### 2. Token 生成工具
-
-```typescript
-// src/auth/jwt.ts
-import jwt from 'jsonwebtoken';
-
-const JWT_SECRET = process.env.JWT_SECRET!;
-const JWT_EXPIRES_IN = process.env.JWT_EXPIRES_IN || '7d';
-
-export interface TokenPayload {
-  userId: string;
-  email?: string;
-  role?: string;
-}
-
-export function generateToken(payload: TokenPayload): string {
-  return jwt.sign(payload, JWT_SECRET, {
-    expiresIn: JWT_EXPIRES_IN,
-  });
-}
-
-export function verifyToken(token: string): TokenPayload {
-  return jwt.verify(token, JWT_SECRET) as TokenPayload;
-}
-
-export function decodeToken(token: string): TokenPayload | null {
-  const decoded = jwt.decode(token);
-  return decoded as TokenPayload | null;
-}
-```
-
-### 3. 认证中间件
-
-```typescript
-// src/auth/middleware.ts
-import type { Request, Response, NextFunction } from 'express';
-import { verifyToken } from './jwt';
-
-export function authenticateToken(
-  req: Request,
-  res: Response,
-  next: NextFunction
-) {
-  const authHeader = req.headers['authorization'];
-  const token = authHeader?.split(' ')[1];
-
-  if (!token) {
-    return res.status(401).json({ error: 'Token required' });
-  }
-
-  try {
-    const payload = verifyToken(token);
-    req.user = payload;
-    next();
-  } catch (error) {
-    return res.status(403).json({ error: 'Invalid token' });
-  }
-}
-```
-
-### 4. 登录接口示例
-
-```typescript
-// src/routes/auth.ts
-import { Router } from 'express';
-import { generateToken } from '../auth/jwt';
-
-const router = Router();
-
-router.post('/login', async (req, res) => {
-  const { email, password } = req.body;
-
-  // 验证用户 (示例)
-  const user = await validateUser(email, password);
-  if (!user) {
-    return res.status(401).json({ error: 'Invalid credentials' });
-  }
-
-  // 生成 token
-  const token = generateToken({
-    userId: user.id,
-    email: user.email,
-    role: user.role,
-  });
-
-  res.json({ token, expiresIn: process.env.JWT_EXPIRES_IN || '7d' });
-});
-
-export default router;
-```
-
-## Tests
-
-```typescript
-// tests/auth/jwt.test.ts
-import { describe, test, expect, beforeAll } from 'bun:test';
-import { generateToken, verifyToken, decodeToken } from '../../src/auth/jwt';
-
-beforeAll(() => {
-  process.env.JWT_SECRET = 'test-secret-key';
-});
-
-describe('JWT Authentication', () => {
-  test('generates valid token', () => {
-    const payload = { userId: 'user123', email: 'test@example.com' };
-    const token = generateToken(payload);
-
-    expect(token).toBeDefined();
-    expect(typeof token).toBe('string');
-    expect(token.split('.')).toHaveLength(3);
-  });
-
-  test('verifies valid token', () => {
-    const payload = { userId: 'user123' };
-    const token = generateToken(payload);
-    const decoded = verifyToken(token);
-
-    expect(decoded.userId).toBe('user123');
-  });
-
-  test('rejects invalid token', () => {
-    expect(() => {
-      verifyToken('invalid-token');
-    }).toThrow();
-  });
-
-  test('decodes token without verification', () => {
-    const payload = { userId: 'user123' };
-    const token = generateToken(payload);
-    const decoded = decodeToken(token);
-
-    expect(decoded?.userId).toBe('user123');
-  });
-});
-```
-
-## Security Considerations
-
-1. **使用强随机 SECRET** - 至少 256 位随机字符串
-2. **设置合理的过期时间** - 建议 15 分钟到 7 天
-3. **使用 HTTPS** - 防止 token 被截获
-4. **Token 刷新机制** - 实现 refresh token 延长会话
-5. **黑名单机制** - 支持主动撤销 token
-
-## Environment Variables
-
-```bash
-# .env
-JWT_SECRET=your-256-bit-secret-key-here
-JWT_EXPIRES_IN=7d
-```
-
-## Related Skills
-
-- auth/refresh-token.md
-- auth/oauth-integration.md
-- security/input-validation.md

package/templates/skills/database/postgres-schema.md

@@ -1,161 +0,0 @@
----
-name: PostgreSQL Schema Design
-description: PostgreSQL 数据库表结构设计最佳实践
-tags: [database, postgresql, schema, sql]
-models: [claude-sonnet-4, gpt-4]
-tokens_avg: 2000
-difficulty: medium
-last_updated: 2026-02-09
----
-
-## Context
-
-设计 PostgreSQL 数据库表结构，遵循最佳实践和规范。
-
-## Prerequisites
-
-- PostgreSQL >= 14
-- 数据库迁移工具 (如 Drizzle, Prisma, Knex)
-
-## Implementation
-
-### 1. 基础表结构模板
-
-```sql
--- 启用 UUID 扩展
-CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
-
--- 用户表
-CREATE TABLE users (
-    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
-    email VARCHAR(255) NOT NULL UNIQUE,
-    password_hash VARCHAR(255) NOT NULL,
-    username VARCHAR(50) NOT NULL UNIQUE,
-    display_name VARCHAR(100),
-    avatar_url TEXT,
-    role VARCHAR(20) DEFAULT 'user' CHECK (role IN ('user', 'admin', 'moderator')),
-    status VARCHAR(20) DEFAULT 'active' CHECK (status IN ('active', 'inactive', 'banned')),
-    email_verified_at TIMESTAMP WITH TIME ZONE,
-    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
-    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
-);
-
--- 创建更新时间触发器
-CREATE OR REPLACE FUNCTION update_updated_at_column()
-RETURNS TRIGGER AS $$
-BEGIN
-    NEW.updated_at = NOW();
-    RETURN NEW;
-END;
-$$ language 'plpgsql';
-
-CREATE TRIGGER update_users_updated_at
-    BEFORE UPDATE ON users
-    FOR EACH ROW
-    EXECUTE FUNCTION update_updated_at_column();
-```
-
-### 2. 索引策略
-
-```sql
--- 常用查询索引
-CREATE INDEX idx_users_email ON users(email);
-CREATE INDEX idx_users_status ON users(status) WHERE status != 'active';
-CREATE INDEX idx_users_created_at ON users(created_at DESC);
-
--- 复合索引 (按查询模式设计)
-CREATE INDEX idx_users_role_status ON users(role, status);
-```
-
-### 3. 关联表设计
-
-```sql
--- 会话表 (一对多)
-CREATE TABLE sessions (
-    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
-    user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
-    token VARCHAR(255) NOT NULL UNIQUE,
-    user_agent TEXT,
-    ip_address INET,
-    expires_at TIMESTAMP WITH TIME ZONE NOT NULL,
-    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
-);
-
-CREATE INDEX idx_sessions_user_id ON sessions(user_id);
-CREATE INDEX idx_sessions_expires_at ON sessions(expires_at);
-
--- 标签表 (多对多)
-CREATE TABLE tags (
-    id SERIAL PRIMARY KEY,
-    name VARCHAR(50) NOT NULL UNIQUE,
-    slug VARCHAR(50) NOT NULL UNIQUE,
-    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
-);
-
-CREATE TABLE post_tags (
-    post_id UUID NOT NULL REFERENCES posts(id) ON DELETE CASCADE,
-    tag_id INTEGER NOT NULL REFERENCES tags(id) ON DELETE CASCADE,
-    PRIMARY KEY (post_id, tag_id)
-);
-```
-
-### 4. JSONB 字段使用
-
-```sql
--- 灵活的元数据存储
-ALTER TABLE users ADD COLUMN metadata JSONB DEFAULT '{}';
-
--- JSONB 索引 (GIN)
-CREATE INDEX idx_users_metadata ON users USING GIN (metadata);
-
--- 查询 JSONB
-SELECT * FROM users WHERE metadata->>'theme' = 'dark';
-SELECT * FROM users WHERE metadata @> '{"preferences": {"newsletter": true}}';
-```
-
-### 5. Drizzle ORM 示例
-
-```typescript
-// src/db/schema.ts
-import { pgTable, uuid, varchar, timestamp, text, jsonb } from 'drizzle-orm/pg-core';
-
-export const users = pgTable('users', {
-  id: uuid('id').primaryKey().defaultRandom(),
-  email: varchar('email', { length: 255 }).notNull().unique(),
-  passwordHash: varchar('password_hash', { length: 255 }).notNull(),
-  username: varchar('username', { length: 50 }).notNull().unique(),
-  displayName: varchar('display_name', { length: 100 }),
-  avatarUrl: text('avatar_url'),
-  role: varchar('role', { length: 20 }).default('user'),
-  status: varchar('status', { length: 20 }).default('active'),
-  emailVerifiedAt: timestamp('email_verified_at', { withTimezone: true }),
-  metadata: jsonb('metadata').default({}),
-  createdAt: timestamp('created_at', { withTimezone: true }).defaultNow(),
-  updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow(),
-});
-
-export const sessions = pgTable('sessions', {
-  id: uuid('id').primaryKey().defaultRandom(),
-  userId: uuid('user_id').notNull().references(() => users.id, { onDelete: 'cascade' }),
-  token: varchar('token', { length: 255 }).notNull().unique(),
-  userAgent: text('user_agent'),
-  ipAddress: varchar('ip_address', { length: 45 }),
-  expiresAt: timestamp('expires_at', { withTimezone: true }).notNull(),
-  createdAt: timestamp('created_at', { withTimezone: true }).defaultNow(),
-});
-```
-
-## Best Practices
-
-1. **使用 UUID 作为主键** - 分布式友好，无法猜测
-2. **始终添加 created_at/updated_at** - 审计和调试必需
-3. **使用 CHECK 约束** - 确保数据完整性
-4. **索引策略** - 根据查询模式设计，避免过度索引
-5. **使用 ON DELETE CASCADE** - 简化级联删除
-6. **分区大表** - 超过 1000 万行考虑分区
-
-## Related Skills
-
-- database/migrations.md
-- database/query-optimization.md
-- database/backup-strategy.md