shawnxixi-cli 0.1.0

package/src/index.ts

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+
+/**
+ * shawnxixi-cli
+ * 肖嘻 CLI 工具入口
+ * 命令命名空间：biz:*（日常业务）、sys:*（系统操作）
+ */
+
+import { todoCommands } from './commands/biz/todo';
+import { recordCommands } from './commands/biz/record';
+import { financeCommands } from './commands/biz/finance';
+import { itemCommands } from './commands/biz/item';
+import { calendarCommands } from './commands/biz/calendar';
+import { syncHealth } from './commands/sys/health';
+
+type AsyncCommandHandler = (...args: any[]) => Promise<void>;
+
+interface CommandMap {
+  [key: string]: AsyncCommandHandler;
+}
+
+const commands: CommandMap = {
+  // Todo
+  'biz:todo:create': async (title: string, args: string[]) => {
+    const options = parseTodoOptions(args);
+    await todoCommands.create(title, options);
+  },
+  'biz:todo:list': async () => {
+    await todoCommands.list({});
+  },
+  'biz:todo:done': async (id: string) => {
+    await todoCommands.done(parseInt(id, 10));
+  },
+  'biz:todo:delete': async (id: string) => {
+    await todoCommands.delete(parseInt(id, 10));
+  },
+
+  // Record
+  'biz:record:create': async (title: string, args: string[]) => {
+    const options = parseRecordOptions(args);
+    await recordCommands.create(title, options.content || '', options);
+  },
+  'biz:record:list': async () => {
+    await recordCommands.list({});
+  },
+
+  // Finance
+  'biz:finance:create': async (amount: string, args: string[]) => {
+    const options = parseFinanceOptions(args);
+    await financeCommands.create(amount, options);
+  },
+  'biz:finance:list': async (args: string[]) => {
+    const options = parseFinanceOptions(args);
+    await financeCommands.list(options);
+  },
+
+  // Item
+  'biz:item:create': async (name: string, args: string[]) => {
+    const options = parseItemOptions(args);
+    await itemCommands.create(name, options);
+  },
+  'biz:item:list': async () => {
+    await itemCommands.list({});
+  },
+
+  // Calendar
+  'biz:calendar:create': async (title: string, args: string[]) => {
+    const options = parseCalendarOptions(args);
+    await calendarCommands.create(title, options);
+  },
+  'biz:calendar:list': async () => {
+    await calendarCommands.list({});
+  },
+
+  // System
+  'sys:health:sync': async () => {
+    await syncHealth();
+  },
+  'sys:health:query': async (dataType: string, args: string[]) => {
+    const options = parseHealthOptions(args);
+    await syncHealth(dataType, options);
+  },
+};
+
+// ============ Option Parsers ============
+
+function parseTodoOptions(args: string[]): { due?: string; priority?: string } {
+  const options: { due?: string; priority?: string } = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--due' && args[i + 1]) options.due = args[++i];
+    if (args[i] === '--priority' && args[i + 1]) options.priority = args[++i];
+  }
+  return options;
+}
+
+function parseRecordOptions(args: string[]): { content?: string; type?: string; tags?: string } {
+  const options: { content?: string; type?: string; tags?: string } = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--content' && args[i + 1]) options.content = args[++i];
+    if (args[i] === '--type' && args[i + 1]) options.type = args[++i];
+    if (args[i] === '--tags' && args[i + 1]) options.tags = args[++i];
+  }
+  return options;
+}
+
+function parseFinanceOptions(args: string[]): { type?: string; category?: string; desc?: string } {
+  const options: { type?: string; category?: string; desc?: string } = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--type' && args[i + 1]) options.type = args[++i];
+    if (args[i] === '--category' && args[i + 1]) options.category = args[++i];
+    if (args[i] === '--desc' && args[i + 1]) options.desc = args[++i];
+  }
+  return options;
+}
+
+function parseItemOptions(args: string[]): { location?: string; expire?: string; category?: string } {
+  const options: { location?: string; expire?: string; category?: string } = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--location' && args[i + 1]) options.location = args[++i];
+    if (args[i] === '--expire' && args[i + 1]) options.expire = args[++i];
+    if (args[i] === '--category' && args[i + 1]) options.category = args[++i];
+  }
+  return options;
+}
+
+function parseCalendarOptions(args: string[]): { start?: string; end?: string; desc?: string } {
+  const options: { start?: string; end?: string; desc?: string } = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--start' && args[i + 1]) options.start = args[++i];
+    if (args[i] === '--end' && args[i + 1]) options.end = args[++i];
+    if (args[i] === '--desc' && args[i + 1]) options.desc = args[++i];
+  }
+  return options;
+}
+
+function parseHealthOptions(args: string[]): { startDate?: string; endDate?: string } {
+  const options: { startDate?: string; endDate?: string } = {};
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--from' && args[i + 1]) options.startDate = args[++i];
+    if (args[i] === '--to' && args[i + 1]) options.endDate = args[++i];
+  }
+  return options;
+}
+
+// ============ CLI Entry ============
+
+function printUsage(): void {
+  console.log(`
+shawnxixi CLI - 肖嘻 CLI 工具
+
+Usage: shawnxixi <command> [args...]
+
+Business Commands (biz:*):
+  biz todo create <title> [--due YYYY-MM-DD] [--priority low|medium|high]
+  biz todo list
+  biz todo done <id>
+  biz todo delete <id>
+  biz record create <title> [--content TEXT] [--type diary|pet|note|idea] [--tags TAG1,TAG2]
+  biz record list
+  biz finance create <amount> [--type income|expense] [--category CAT] [--desc TEXT]
+  biz finance list [--type income|expense] [--category CAT]
+  biz item create <name> [--location LOC] [--expire YYYY-MM-DD] [--category CAT]
+  biz item list
+  biz calendar create <title> --start DATETIME --end DATETIME [--desc TEXT]
+  biz calendar list
+
+System Commands (sys:*):
+  sys health sync [--from YYYY-MM-DD] [--to YYYY-MM-DD]
+  sys health query <dataType> [--from YYYY-MM-DD] [--to YYYY-MM-DD]
+
+Examples:
+  shawnxixi biz todo create "开会" --due 2026-04-12 --priority high
+  shawnxixi biz finance create 50 --category food --desc "午饭"
+  shawnxixi biz calendar create "面试" --start "2026-04-15 14:00" --end "2026-04-15 15:00"
+`);
+}
+
+function main(): void {
+  const args = process.argv.slice(2);
+
+  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+    printUsage();
+    process.exit(0);
+  }
+
+  // Handle special case: "biz todo list" -> "biz:todo:list"
+  let commandKey: string;
+  if (args[0] === 'biz' || args[0] === 'sys') {
+    commandKey = args.join(':');
+  } else {
+    commandKey = args[0];
+  }
+
+  const handler = commands[commandKey];
+
+  if (!handler) {
+    console.error(`Unknown command: ${commandKey}`);
+    printUsage();
+    process.exit(1);
+  }
+
+  const handlerArgs = args.slice(1);
+  handler(...handlerArgs).catch((error) => {
+    console.error('Command failed:', error);
+    process.exit(1);
+  });
+}
+
+main();

package/src/services/api.ts

@@ -0,0 +1,226 @@
+/**
+ * API Service - HTTP 调用后端
+ * 封装与 shawnxixi-server 的通信
+ */
+
+import axios, { AxiosInstance } from 'axios';
+
+const API_BASE = process.env.SHAWNXIXI_API_URL || 'http://localhost:8080';
+
+class ApiService {
+  private client: AxiosInstance;
+
+  constructor() {
+    this.client = axios.create({
+      baseURL: API_BASE,
+      timeout: 10000,
+      headers: {
+        'Content-Type': 'application/json',
+      },
+    });
+
+    // 请求拦截器：添加 auth token
+    this.client.interceptors.request.use(async (config) => {
+      const token = await this.getToken();
+      if (token) {
+        config.headers.Authorization = `Bearer ${token}`;
+      }
+      return config;
+    });
+
+    // 响应拦截器：处理 401 刷新 token
+    this.client.interceptors.response.use(
+      (response) => response,
+      async (error) => {
+        if (error.response?.status === 401) {
+          // token 过期，尝试刷新
+          await this.refreshToken();
+          // 重试原请求
+          const config = error.config;
+          const token = await this.getToken();
+          config.headers.Authorization = `Bearer ${token}`;
+          return this.client(config);
+        }
+        return Promise.reject(error);
+      }
+    );
+  }
+
+  private async getToken(): Promise<string | null> {
+    // TODO: 从 Keychain 读取 token
+    return process.env.SHAWNXIXI_API_TOKEN || null;
+  }
+
+  private async refreshToken(): Promise<void> {
+    // TODO: 实现 token 刷新逻辑
+  }
+
+  // ============ Todo API ============
+  async createTodo(title: string, dueDate?: string, priority?: string) {
+    const { data } = await this.client.post('/api/v1/todos', {
+      title,
+      dueDate,
+      priority: priority || 'medium',
+      status: 'pending',
+    });
+    return data;
+  }
+
+  async listTodos(status?: string) {
+    const params = status ? { status } : {};
+    const { data } = await this.client.get('/api/v1/todos', { params });
+    return data;
+  }
+
+  async updateTodo(id: number, updates: Partial<{title: string; status: string; priority: string; dueDate: string}>) {
+    const { data } = await this.client.put(`/api/v1/todos/${id}`, updates);
+    return data;
+  }
+
+  async deleteTodo(id: number) {
+    const { data } = await this.client.delete(`/api/v1/todos/${id}`);
+    return data;
+  }
+
+  // ============ Record API ============
+  async createRecord(title: string, content: string, type: string = 'diary', tags?: string) {
+    const { data } = await this.client.post('/api/v1/records', {
+      title,
+      content,
+      type,
+      tags,
+    });
+    return data;
+  }
+
+  async listRecords(type?: string, tags?: string) {
+    const params: Record<string, string> = {};
+    if (type) params.type = type;
+    if (tags) params.tags = tags;
+    const { data } = await this.client.get('/api/v1/records', { params });
+    return data;
+  }
+
+  // ============ Finance API ============
+  async createFinance(amount: number, type: string, category: string, description?: string) {
+    const { data } = await this.client.post('/api/v1/finances', {
+      amount,
+      type,
+      category,
+      description,
+    });
+    return data;
+  }
+
+  async listFinances(type?: string, category?: string) {
+    const params: Record<string, string> = {};
+    if (type) params.type = type;
+    if (category) params.category = category;
+    const { data } = await this.client.get('/api/v1/finances', { params });
+    return data;
+  }
+
+  // ============ Health API ============
+  async syncHealthData() {
+    const { data } = await this.client.post('/api/v1/health-data/sync');
+    return data;
+  }
+
+  async queryHealthData(dataType?: string, startDate?: string, endDate?: string) {
+    const params: Record<string, string> = {};
+    if (dataType) params.dataType = dataType;
+    if (startDate) params.startDate = startDate;
+    if (endDate) params.endDate = endDate;
+    const { data } = await this.client.get('/api/v1/health-data', { params });
+    return data;
+  }
+
+  // ============ Item API ============
+  async createItem(name: string, category?: string, location?: string, expireDate?: string) {
+    const { data } = await this.client.post('/api/v1/items', {
+      name,
+      category,
+      location,
+      expireDate,
+    });
+    return data;
+  }
+
+  async listItems(category?: string, status?: string) {
+    const params: Record<string, string> = {};
+    if (category) params.category = category;
+    if (status) params.status = status;
+    const { data } = await this.client.get('/api/v1/items', { params });
+    return data;
+  }
+
+  // ============ Calendar API ============
+  async createCalendarEvent(title: string, startTime: string, endTime: string, description?: string, location?: string) {
+    const { data } = await this.client.post('/api/v1/calendar-events', {
+      title,
+      startTime,
+      endTime,
+      description,
+      location,
+    });
+    return data;
+  }
+
+  async listCalendarEvents(startTime?: string, endTime?: string) {
+    const params: Record<string, string> = {};
+    if (startTime) params.startTime = startTime;
+    if (endTime) params.endTime = endTime;
+    const { data } = await this.client.get('/api/v1/calendar-events', { params });
+    return data;
+  }
+
+  // ============ Reminder API ============
+  async createReminder(title: string, triggerTime: string, type: string = 'once') {
+    const { data } = await this.client.post('/api/v1/reminders', {
+      title,
+      triggerTime,
+      type,
+      status: 'active',
+    });
+    return data;
+  }
+
+  async listReminders(status?: string, type?: string) {
+    const params: Record<string, string> = {};
+    if (status) params.status = status;
+    if (type) params.type = type;
+    const { data } = await this.client.get('/api/v1/reminders', { params });
+    return data;
+  }
+
+  // ============ AuditLog API ============
+  async listAuditLogs(entityType?: string, entityId?: number, operation?: string) {
+    const params: Record<string, string> = {};
+    if (entityType) params.entityType = entityType;
+    if (entityId) params.entityId = String(entityId);
+    if (operation) params.operation = operation;
+    const { data } = await this.client.get('/api/v1/audit-logs', { params });
+    return data;
+  }
+
+  // ============ Task API ============
+  async createTask(title: string, description?: string, priority?: string, source?: string) {
+    const { data } = await this.client.post('/api/v1/tasks', {
+      title,
+      description,
+      priority: priority || 'medium',
+      source: source || 'cli',
+      status: 'pending',
+    });
+    return data;
+  }
+
+  async listTasks(status?: string) {
+    const params: Record<string, string> = {};
+    if (status) params.status = status;
+    const { data } = await this.client.get('/api/v1/tasks', { params });
+    return data;
+  }
+}
+
+export const apiService = new ApiService();

package/tests/commands/todo.test.ts

@@ -0,0 +1,39 @@
+/**
+ * Todo Command Tests
+ */
+
+import { todoCommands } from '../../src/commands/biz/todo';
+
+// Mock apiService
+jest.mock('../../src/services/api', () => ({
+  apiService: {
+    createTodo: jest.fn().mockResolvedValue({ id: 1, title: '测试待办' }),
+    listTodos: jest.fn().mockResolvedValue([{ id: 1, title: '测试待办' }]),
+  },
+}));
+
+import { apiService } from '../../src/services/api';
+
+describe('biz todo commands', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  describe('create', () => {
+    it('should call apiService.createTodo', async () => {
+      const consoleSpy = jest.spyOn(console, 'log').mockImplementation();
+      await todoCommands.create('测试待办');
+      expect(apiService.createTodo).toHaveBeenCalledWith('测试待办', undefined, undefined);
+      consoleSpy.mockRestore();
+    });
+  });
+
+  describe('list', () => {
+    it('should call apiService.listTodos', async () => {
+      const consoleSpy = jest.spyOn(console, 'log').mockImplementation();
+      await todoCommands.list();
+      expect(apiService.listTodos).toHaveBeenCalledWith(undefined);
+      consoleSpy.mockRestore();
+    });
+  });
+});

package/tests/services/api.test.ts

@@ -0,0 +1,39 @@
+/**
+ * API Service Tests with Mock
+ */
+
+import { apiService } from '../../src/services/api';
+
+// Mock axios
+jest.mock('axios', () => ({
+  create: () => ({
+    interceptors: {
+      request: { use: jest.fn((cb) => cb) },
+      response: { use: jest.fn((successCb, _errorCb) => successCb) },
+    },
+    get: jest.fn().mockResolvedValue({ data: {} }),
+    post: jest.fn().mockResolvedValue({ data: { id: 1 } }),
+    put: jest.fn().mockResolvedValue({ data: {} }),
+    delete: jest.fn().mockResolvedValue({ data: {} }),
+  }),
+}));
+
+describe('ApiService', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  describe('createTodo', () => {
+    it('should call POST /api/v1/todos', async () => {
+      const result = await apiService.createTodo('测试待办');
+      expect(result).toBeDefined();
+    });
+  });
+
+  describe('listTodos', () => {
+    it('should call GET /api/v1/todos', async () => {
+      const result = await apiService.listTodos();
+      expect(result).toBeDefined();
+    });
+  });
+});

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "tests"]
+}