intention-coding 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,262 @@
+# 智能软件星工厂 - MCP服务器
+
+一个基于FastMCP的智能化软件开发工具服务器，提供从需求分析到代码生成的完整开发生命周期管理。
+
+## 🚀 核心功能
+
+### 1. 集成化项目生成器 (推荐)
+**`integrated_generator`** - 全新的需求驱动开发工具
+
+```javascript
+// 创建完整项目
+{
+  "project_name": "用户管理系统",
+  "project_description": "企业级用户权限管理系统",
+  "user_story": "作为系统管理员，我想要管理用户权限，以便于确保系统安全",
+  "acceptance_criteria": [
+    "可以创建新用户",
+    "可以分配用户角色",
+    "可以设置权限范围"
+  ],
+  "programming_language": "typescript",
+  "framework": "express"
+}
+```
+
+### 2. 需求分析工具
+**`requirement_analyzer`** - 智能需求分析和文档生成
+
+### 3. 代码生成工具 (已弃用)
+**`code_generator`** - 传统代码生成工具，建议使用集成化生成器
+
+### 4. 项目模板工具 (已弃用)
+**`init_project_standard`** - 传统项目规范工具，建议使用集成化生成器
+
+### 5. 文档转换工具
+- **`word2md`** - Word文档转Markdown
+- **`pdf2md`** - PDF文档转Markdown
+
+### 6. Claude Code集成
+- **`claude_code`** - Claude Code会话管理
+- **`claude_code_sessions`** - 会话历史查询
+
+### 7. 变更摘要工具
+**`change_summarizer`** - Git变更智能摘要
+
+## 📋 使用指南
+
+### 集成化项目生成器 (推荐)
+
+这是最强大的工具，严格按照`.cursor/rules/`中的开发流程执行：
+
+#### 基本用法
+```javascript
+// 生成完整项目
+{
+  "project_name": "电商订单系统",
+  "project_description": "处理电商订单的完整生命周期",
+  "user_story": "作为商家，我想要管理订单，以便于及时处理客户订单",
+  "acceptance_criteria": [
+    "可以创建新订单",
+    "可以查询订单状态",
+    "可以更新订单信息",
+    "可以取消订单"
+  ],
+  "programming_language": "typescript",
+  "framework": "express"
+}
+```
+
+#### 高级用法
+```javascript
+// 生成特定模块
+{
+  "project_name": "支付模块",
+  "project_description": "集成多种支付方式的支付处理模块",
+  "user_story": "作为用户，我想要多种支付方式，以便于选择最方便的支付方式",
+  "acceptance_criteria": [
+    "支持支付宝支付",
+    "支持微信支付",
+    "支持银行卡支付",
+    "支持支付状态查询"
+  ],
+  "programming_language": "typescript",
+  "framework": "express",
+  "generation_type": "module_only",
+  "architecture_pattern": "layered",
+  "include_tests": true,
+  "business_rules": [
+    "支付金额必须大于0",
+    "同一订单不能重复支付",
+    "支付超时自动取消"
+  ]
+}
+```
+
+### 需求分析工具
+
+```javascript
+// 分析需求文档
+{
+  "requirement_text": "我们需要一个用户管理系统，能够...",
+  "analysis_type": "comprehensive",
+  "output_format": "structured"
+}
+```
+
+### 文档转换
+
+```javascript
+// Word转Markdown
+{
+  "file_path": "/path/to/document.docx",
+  "output_dir": "/output/path"
+}
+
+// PDF转Markdown
+{
+  "file_path": "/path/to/document.pdf",
+  "output_dir": "/output/path"
+}
+```
+
+## 🏗️ 开发工作流
+
+集成化项目生成器遵循以下严格的工作流程：
+
+```mermaid
+flowchart TD
+    Start([开始]) --> Story[创建用户故事]
+    Story --> ReviewStory{用户故事评审}
+    ReviewStory -->|通过| WriteFeature[编写Feature文件]
+    ReviewStory -->|不通过| ReviseStory[修改用户故事]
+    ReviseStory --> ReviewStory
+    
+    WriteFeature --> ConfirmFeature{Feature确认}
+    ConfirmFeature -->|通过| Design[技术方案设计]
+    ConfirmFeature -->|不通过| ReviseFeature[修改Feature]
+    ReviseFeature --> ConfirmFeature
+    
+    Design --> Implement[代码实现]
+    Implement --> Test[编写测试]
+    Test --> ReviewCode[代码审查]
+    ReviewCode --> DeployTest[部署测试]
+    DeployTest --> Acceptance{验收测试}
+    Acceptance -->|通过| Done([完成])
+    Acceptance -->|不通过| Fix[修复问题]
+    Fix --> Test
+```
+
+## 📁 生成的项目结构
+
+```
+project-name/
+├── docs/
+│   ├── requirements/
+│   │   ├── user-story.md
+│   │   └── project-name.feature.md
+│   ├── architecture/
+│   │   └── technical-architecture.md
+│   ├── api/
+│   │   └── api-specification.md
+│   ├── development-standards.md
+│   ├── development-workflow.md
+│   └── testing-strategy.md
+├── src/
+│   ├── controllers/
+│   ├── services/
+│   ├── repositories/
+│   ├── models/
+│   ├── middleware/
+│   └── utils/
+├── tests/
+│   ├── unit/
+│   ├── integration/
+│   └── e2e/
+├── config/
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## 🛠️ 快速开始
+
+### 1. 安装依赖
+```bash
+npm install
+```
+
+### 2. 启动开发服务器
+```bash
+npm run dev
+```
+
+### 3. 测试工具
+```bash
+npm run test-mcp
+```
+
+### 4. 查看可用工具
+```bash
+npm run inspect
+```
+
+## 🔧 配置
+
+### 环境变量
+```bash
+# 存储目录
+STORAGE_DIR=/path/to/storage
+
+# 日志级别
+LOG_LEVEL=info
+
+# AI服务配置
+AI_API_KEY=your-api-key
+```
+
+### 项目配置
+编辑 `src/config.ts` 文件进行项目级配置。
+
+## 📊 工具对比
+
+| 工具名称 | 主要功能 | 状态 | 推荐程度 |
+|----------|----------|------|----------|
+| `integrated_generator` | 需求驱动的完整项目生成 | ✅ 活跃 | ⭐⭐⭐⭐⭐ |
+| `requirement_analyzer` | 智能需求分析 | ✅ 活跃 | ⭐⭐⭐⭐ |
+| `code_generator` | 传统代码生成 | ⚠️ 弃用 | ⭐⭐ |
+| `init_project_standard` | 项目规范生成 | ⚠️ 弃用 | ⭐⭐ |
+| `word2md` | Word转Markdown | ✅ 活跃 | ⭐⭐⭐⭐ |
+| `pdf2md` | PDF转Markdown | ✅ 活跃 | ⭐⭐⭐⭐ |
+
+## 🚨 弃用通知
+
+### 已弃用工具
+- **`init_project_standard`** - 请使用 `integrated_generator`
+- **`code_generator`** - 请使用 `integrated_generator`
+
+这些工具仍然可用，但不再维护，建议迁移到新的集成化工具。
+
+## 🤝 贡献
+
+1. Fork 项目
+2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 创建 Pull Request
+
+## 📄 许可证
+
+MIT License - 详见 [LICENSE](LICENSE) 文件
+
+## 🆘 支持
+
+- 📖 [文档](docs/)
+- 🐛 [问题报告](https://github.com/your-repo/issues)
+- 💬 [讨论区](https://github.com/your-repo/discussions)
+
+## 🔗 相关链接
+
+- [FastMCP文档](https://github.com/punkpeye/fastmcp)
+- [Cursor规则](.cursor/rules/)
+- [最佳实践](docs/best-practices.md)

package/dist/config.d.ts

@@ -1,5 +1,6 @@
 export declare const PROJECT_ROOT: string;
 export declare const getStorageDir: () => string;
+export declare const getExportsDir: () => string;
 /**
  * 应用配置
  */

package/dist/db/file-storage.d.ts

@@ -0,0 +1,255 @@
+export interface TestPlan {
+    id: number;
+    uuid: string;
+    name: string;
+    status: string;
+    completed: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface TestTask {
+    id: number;
+    uuid: string;
+    tableUuid: string;
+    url: string;
+    method: string;
+    query?: string;
+    headers?: string;
+    body?: string;
+    hopeRes?: string;
+    res?: string;
+    review?: string;
+    suggest?: string;
+    status: string;
+    completed: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface RequirementProject {
+    id: number;
+    uuid: string;
+    name: string;
+    description?: string;
+    status: string;
+    priority: string;
+    stakeholders?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface RequirementAnalysis {
+    id: number;
+    uuid: string;
+    projectUuid: string;
+    analysisType: string;
+    title: string;
+    content: string;
+    originalInput: string;
+    analysisParams?: string;
+    filePath?: string;
+    status: string;
+    version: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface RequirementItem {
+    id: number;
+    uuid: string;
+    projectUuid: string;
+    analysisUuid?: string;
+    type: string;
+    category: string;
+    title: string;
+    description: string;
+    priority: string;
+    status: string;
+    acceptanceCriteria?: string;
+    dependencies?: string;
+    estimatedEffort?: number;
+    actualEffort?: number;
+    assignee?: string;
+    tags?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface RequirementValidation {
+    id: number;
+    uuid: string;
+    requirementUuid: string;
+    validationType: string;
+    status: string;
+    issues?: string;
+    suggestions?: string;
+    validatedBy?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface CodeGenerationSession {
+    id: number;
+    uuid: string;
+    sessionId: string;
+    taskTitle: string;
+    taskDescription: string;
+    projectName: string;
+    programmingLanguage?: string;
+    framework?: string;
+    featureType: string;
+    priority: string;
+    userStory?: string;
+    acceptanceCriteria: string;
+    technicalRequirements?: string;
+    testRequirements?: string;
+    customContext?: string;
+    sessionDir: string;
+    status: string;
+    generatedFiles: number;
+    totalDuration: number;
+    errorMessage?: string;
+    startedAt?: Date;
+    completedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface CodeGenerationTask {
+    id: number;
+    uuid: string;
+    sessionUuid: string;
+    taskType: string;
+    taskName: string;
+    description: string;
+    inputData?: string;
+    outputPath?: string;
+    outputContent?: string;
+    fileSize?: number;
+    status: string;
+    duration: number;
+    errorMessage?: string;
+    startedAt?: Date;
+    completedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export declare const dbOperations: {
+    createTestPlan: (data: {
+        uuid: string;
+        name: string;
+        status?: string;
+    }) => Promise<TestPlan[]>;
+    getTestPlan: (uuid: string) => Promise<TestPlan[]>;
+    getAllTestPlans: () => Promise<TestPlan[]>;
+    updateTestPlan: (uuid: string, data: Partial<{
+        name: string;
+        status: string;
+        completed: boolean;
+    }>) => Promise<void>;
+    createTestTask: (data: {
+        uuid: string;
+        tableUuid: string;
+        url: string;
+        method?: string;
+        query?: string;
+        headers?: string;
+        body?: string;
+        hopeRes?: string;
+    }) => Promise<TestTask[]>;
+    getTestTask: (uuid: string) => Promise<TestTask[]>;
+    getTestTasksByPlan: (tableUuid: string) => Promise<TestTask[]>;
+    updateTestTask: (uuid: string, data: Partial<{
+        url: string;
+        method: string;
+        query: string;
+        headers: string;
+        body: string;
+        hopeRes: string;
+        res: string;
+        review: string;
+        suggest: string;
+        status: string;
+        completed: boolean;
+    }>) => Promise<void>;
+    batchUpdateTaskSummaries: (updates: Array<{
+        uuid: string;
+        summary: string;
+        suggest: string;
+    }>) => Promise<void>;
+    createRequirementProject: (data: {
+        uuid: string;
+        name: string;
+        description?: string;
+        priority?: string;
+        stakeholders?: string;
+    }) => Promise<RequirementProject>;
+    getRequirementProject: (uuid: string) => Promise<RequirementProject | null>;
+    getAllRequirementProjects: () => Promise<RequirementProject[]>;
+    updateRequirementProject: (uuid: string, data: Partial<RequirementProject>) => Promise<void>;
+    createRequirementAnalysis: (data: {
+        uuid: string;
+        projectUuid: string;
+        analysisType: string;
+        title: string;
+        content: string;
+        originalInput: string;
+        analysisParams?: string;
+        filePath?: string;
+    }) => Promise<RequirementAnalysis>;
+    getRequirementAnalyses: (projectUuid: string) => Promise<RequirementAnalysis[]>;
+    getRequirementAnalysis: (uuid: string) => Promise<RequirementAnalysis | null>;
+    createRequirementItem: (data: {
+        uuid: string;
+        projectUuid: string;
+        analysisUuid?: string;
+        type: string;
+        category: string;
+        title: string;
+        description: string;
+        priority?: string;
+        acceptanceCriteria?: string;
+        dependencies?: string;
+        estimatedEffort?: number;
+        assignee?: string;
+        tags?: string;
+    }) => Promise<RequirementItem>;
+    getRequirementItems: (projectUuid: string) => Promise<RequirementItem[]>;
+    updateRequirementItem: (uuid: string, data: Partial<RequirementItem>) => Promise<void>;
+    createRequirementValidation: (data: {
+        uuid: string;
+        requirementUuid: string;
+        validationType: string;
+        status: string;
+        issues?: string;
+        suggestions?: string;
+        validatedBy?: string;
+    }) => Promise<RequirementValidation>;
+    getRequirementValidations: (requirementUuid: string) => Promise<RequirementValidation[]>;
+    createCodeGenerationSession: (data: {
+        uuid: string;
+        sessionId: string;
+        taskTitle: string;
+        taskDescription: string;
+        projectName: string;
+        programmingLanguage?: string;
+        framework?: string;
+        featureType: string;
+        priority: string;
+        userStory?: string;
+        acceptanceCriteria: string[];
+        technicalRequirements?: string;
+        testRequirements?: string;
+        customContext?: string;
+        sessionDir: string;
+    }) => Promise<CodeGenerationSession>;
+    getCodeGenerationSession: (uuid: string) => Promise<CodeGenerationSession | null>;
+    getAllCodeGenerationSessions: () => Promise<CodeGenerationSession[]>;
+    updateCodeGenerationSession: (uuid: string, data: Partial<CodeGenerationSession>) => Promise<void>;
+    createCodeGenerationTask: (data: {
+        uuid: string;
+        sessionUuid: string;
+        taskType: string;
+        taskName: string;
+        description: string;
+        inputData?: string;
+        outputPath?: string;
+        fileSize?: number;
+    }) => Promise<CodeGenerationTask>;
+    getCodeGenerationTasksBySession: (sessionUuid: string) => Promise<CodeGenerationTask[]>;
+    updateCodeGenerationTask: (uuid: string, data: Partial<CodeGenerationTask>) => Promise<void>;
+};