flowmind 1.0.0

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "flowmind",
+  "version": "1.0.0",
+  "description": "The AI Agent That Learns How You Work - Stop repeating yourself, FlowMind learns your workflows and applies them automatically.",
+  "main": "core/index.js",
+  "bin": {
+    "flowmind": "./bin/flowmind.js"
+  },
+  "scripts": {
+    "start": "node core/index.js",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint .",
+    "build": "webpack --mode production",
+    "dev": "nodemon core/index.js"
+  },
+  "keywords": [
+    "ai-agent",
+    "workflow-automation",
+    "developer-tools",
+    "learning-system",
+    "code-review",
+    "log-analysis",
+    "devops"
+  ],
+  "author": "FlowMind Technologies",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Eleven-M/flowmind.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Eleven-M/flowmind/issues"
+  },
+  "homepage": "https://github.com/Eleven-M/flowmind#readme",
+  "files": [
+    "bin/",
+    "core/",
+    "skills/",
+    "scripts/",
+    "templates/",
+    "config/",
+    "learning/",
+    "README.md",
+    "README_CN.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^11.0.0",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1",
+    "inquirer": "^8.2.6",
+    "fs-extra": "^11.1.1",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "jest": "^29.7.0",
+    "eslint": "^8.50.0",
+    "nodemon": "^3.0.1",
+    "webpack": "^5.88.0",
+    "webpack-cli": "^5.1.4"
+  }
+}

package/scripts/migrate-config.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+
+/**
+ * FlowMind Configuration Migration Tool
+ * Migrates existing MCP server configurations to the new component architecture.
+ *
+ * Usage:
+ *   node scripts/migrate-config.js [--dry-run] [--output <path>]
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+
+const { ComponentType } = require('../core/component-types');
+
+// Default MCP server to component provider mapping
+const DEFAULT_MAPPING = {
+  'friday-sls-logs': { type: 'logService', provider: 'aliyun-sls' },
+  'aliyun-dms-mcp-server': { type: 'databaseManager', provider: 'aliyun-dms' },
+  'friday-rds-redis-query': { type: 'databaseQuery', provider: 'aliyun-rds-query' },
+  'friday-aliyun-sz-rds-redis': { type: 'redisMonitor', provider: 'aliyun-redis' },
+  'aomi-yapi-mcp': { type: 'apiDoc', provider: 'yapi' },
+  'aomi-yuque-mcp': { type: 'knowledgeBase', provider: 'yuque' },
+  'friday-auto-flow': { type: 'workflow', provider: 'friday-flow' },
+  'friday-auto-report': { type: 'report', provider: 'friday-report' }
+};
+
+// MCP server default configurations
+const SERVER_DEFAULTS = {
+  'friday-sls-logs': {
+    config: {
+      endpoints: {
+        test: 'cn-shenzhen.log.aliyuncs.com',
+        prod: 'cn-hongkong.log.aliyuncs.com'
+      }
+    }
+  }
+};
+
+function getHomeDir() {
+  return process.env.HOME || process.env.USERPROFILE || require('os').homedir();
+}
+
+/**
+ * Read existing MCP server configuration from settings.
+ */
+function readExistingConfig() {
+  const settingsPaths = [
+    path.join(process.cwd(), '.claude', 'settings.local.json'),
+    path.join(getHomeDir(), '.claude', 'settings.local.json')
+  ];
+
+  for (const settingsPath of settingsPaths) {
+    if (fs.existsSync(settingsPath)) {
+      try {
+        const settings = fs.readJsonSync(settingsPath);
+        return settings.enabledMcpjsonServers || [];
+      } catch (e) {
+        // skip
+      }
+    }
+  }
+
+  return [];
+}
+
+/**
+ * Generate component config from enabled MCP servers.
+ */
+function generateComponentConfig(enabledServers) {
+  const components = {};
+
+  for (const serverName of enabledServers) {
+    const mapping = DEFAULT_MAPPING[serverName];
+    if (!mapping) continue;
+
+    const { type, provider } = mapping;
+
+    if (!components[type]) {
+      components[type] = {
+        default: provider,
+        providers: {}
+      };
+    }
+
+    components[type].providers[provider] = {
+      adapter: `${provider}-adapter`,
+      enabled: true,
+      mcpServer: serverName,
+      ...(SERVER_DEFAULTS[serverName] || {})
+    };
+  }
+
+  return components;
+}
+
+/**
+ * Main migration function.
+ */
+async function migrate() {
+  const args = process.argv.slice(2);
+  const dryRun = args.includes('--dry-run');
+  const outputIdx = args.indexOf('--output');
+  const outputPath = outputIdx >= 0 ? args[outputIdx + 1] : null;
+
+  console.log('FlowMind Configuration Migration Tool');
+  console.log('=====================================\n');
+
+  // 1. Read existing config
+  const enabledServers = readExistingConfig();
+  console.log(`Found ${enabledServers.length} enabled MCP servers:`);
+  enabledServers.forEach(s => console.log(`  - ${s}`));
+  console.log('');
+
+  // 2. Generate component config
+  const components = generateComponentConfig(enabledServers);
+
+  // 3. Build full config
+  const config = {
+    version: '1.0.0',
+    components
+  };
+
+  // 4. Output
+  const configJson = JSON.stringify(config, null, 2);
+
+  if (dryRun) {
+    console.log('Generated component configuration (dry run):');
+    console.log(configJson);
+  } else {
+    const targetPath = outputPath || path.join(getHomeDir(), '.flowmind', 'component-config.json');
+    await fs.ensureDir(path.dirname(targetPath));
+    await fs.writeJson(targetPath, config, { spaces: 2 });
+    console.log(`Component configuration written to: ${targetPath}`);
+  }
+
+  // 5. Summary
+  console.log('\nMigration Summary:');
+  console.log(`  Component types configured: ${Object.keys(components).length}`);
+  for (const [type, cfg] of Object.entries(components)) {
+    const providers = Object.keys(cfg.providers);
+    console.log(`  - ${type}: ${cfg.default} (${providers.join(', ')})`);
+  }
+
+  if (!dryRun) {
+    console.log('\nNext steps:');
+    console.log('  1. Review the generated configuration file');
+    console.log('  2. Add component config to your flowmind.config.json');
+    console.log('  3. Skills will now use the component registry for service access');
+  }
+}
+
+migrate().catch(console.error);

package/skills/api-sync/SKILL.md

@@ -0,0 +1,203 @@
+---
+name: api-sync
+description: API documentation synchronization skill for FlowMind. Sync API definitions, generate documentation, and maintain API consistency.
+metadata:
+  version: "1.0.0"
+  author: flowmind
+  category: documentation
+---
+
+# API Sync Skill
+
+Sync API definitions, generate documentation, and maintain API consistency.
+
+## Features
+
+### 📚 Documentation Generation
+- Generate from code annotations
+- Create OpenAPI/Swagger specs
+- Generate Markdown docs
+- Create client SDKs
+
+### 🔄 Synchronization
+- Sync to API platforms
+- Update documentation
+- Version management
+- Change tracking
+
+### ✅ Validation
+- Schema validation
+- Breaking change detection
+- Backward compatibility
+- Style guide compliance
+
+## Trigger Patterns
+
+```
+"API文档", "API documentation", "API docs"
+"接口同步", "sync API", "接口文档"
+"Swagger", "OpenAPI"
+"API管理", "API management"
+```
+
+## Output Format
+
+```
+┌─────────────────────────────────────────────────────┐
+│ API Sync Report                                     │
+├─────────────────────────────────────────────────────┤
+│ Platform: {platform}                                │
+│ Project: {project}                                  │
+├─────────────────────────────────────────────────────┤
+│ Endpoints: {count}                                  │
+│ • Added: {added}                                    │
+│ • Updated: {updated}                                │
+│ • Deleted: {deleted}                                │
+├─────────────────────────────────────────────────────┤
+│ Status: ✓ Synced Successfully                       │
+│ URL: {docs_url}                                     │
+└─────────────────────────────────────────────────────┘
+```
+
+## Supported Platforms
+
+| Platform | Status | Features |
+|----------|--------|----------|
+| YApi | ✅ | Full support |
+| Swagger Hub | ✅ | Full support |
+| Postman | ✅ | Collections |
+| Stoplight | 🚧 | Coming soon |
+| ReadMe | 🚧 | Coming soon |
+
+## Learning Integration
+
+This skill supports FlowMind learning:
+
+- **Platform**: Learns preferred API platform
+- **Format**: Learns preferred doc format
+- **Sync Rules**: Learns what to sync
+
+```
+User: "同步到 YApi"
+FlowMind: ✓ Learned: Sync APIs to YApi
+
+User: [Next sync]
+FlowMind: [Syncs to YApi automatically]
+```
+
+## Examples
+
+### Example 1: Generate API Docs
+
+```
+User: 生成这个 Controller 的 API 文档
+
+FlowMind:
+┌─────────────────────────────────────────────────────┐
+│ API Documentation Generated                         │
+├─────────────────────────────────────────────────────┤
+│ Source: src/controllers/UserController.java         │
+│ Endpoints: 5                                        │
+├─────────────────────────────────────────────────────┤
+│ GET    /api/users          - List users             │
+│ GET    /api/users/{id}     - Get user               │
+│ POST   /api/users          - Create user            │
+│ PUT    /api/users/{id}     - Update user            │
+│ DELETE /api/users/{id}     - Delete user            │
+├─────────────────────────────────────────────────────┤
+│ Output: docs/api/users.md                           │
+└─────────────────────────────────────────────────────┘
+```
+
+### Example 2: Sync to Platform
+
+```
+User: 同步接口到 YApi
+
+FlowMind:
+┌─────────────────────────────────────────────────────┐
+│ API Sync Complete                                   │
+├─────────────────────────────────────────────────────┤
+│ Platform: YApi                                      │
+│ Project: My Project                                 │
+├─────────────────────────────────────────────────────┤
+│ Synced:                                             │
+│ • Added: 2 endpoints                                │
+│ • Updated: 3 endpoints                              │
+│ • Unchanged: 10 endpoints                           │
+├─────────────────────────────────────────────────────┤
+│ View at: http://yapi.example.com/project/123        │
+└─────────────────────────────────────────────────────┘
+```
+
+## Configuration
+
+```json
+{
+  "api-sync": {
+    "platform": "yapi",
+    "connection": {
+      "host": "http://yapi.example.com",
+      "projectId": "123",
+      "token": "your-token"
+    },
+    "options": {
+      "autoSync": true,
+      "generateDocs": true,
+      "validateSchema": true
+    }
+  }
+}
+```
+
+## Sync Modes
+
+### Full Sync
+
+```bash
+flowmind api-sync --full
+```
+
+Syncs all endpoints, overwriting remote changes.
+
+### Incremental Sync
+
+```bash
+flowmind api-sync --incremental
+```
+
+Only syncs changed endpoints.
+
+### Dry Run
+
+```bash
+flowmind api-sync --dry-run
+```
+
+Shows what would be synced without making changes.
+
+## Custom Templates
+
+### Markdown Template
+
+```json
+{
+  "api-sync": {
+    "templates": {
+      "markdown": "templates/api-doc.md"
+    }
+  }
+}
+```
+
+### OpenAPI Template
+
+```json
+{
+  "api-sync": {
+    "templates": {
+      "openapi": "templates/openapi.yaml"
+    }
+  }
+}
+```

package/skills/archive-change/SKILL.md

@@ -0,0 +1,172 @@
+---
+name: archive-change
+description: Archive completed changes and maintain project history. Use when a feature, fix, or change is complete and needs to be documented and archived.
+metadata:
+  version: "1.0.0"
+  author: flowmind
+  category: workflow
+---
+
+# Archive Change Skill
+
+Archive completed changes and maintain project history.
+
+## Features
+
+### 📦 Change Archiving
+- Move completed changes to archive
+- Generate completion reports
+- Update project history
+- Clean up working directories
+
+### 📝 Documentation
+- Auto-generate change summary
+- Link related artifacts
+- Update changelog
+- Create knowledge base entries
+
+### 🔗 Cross-Reference
+- Link to related issues
+- Reference PRs and commits
+- Connect to requirements
+- Trace to deployments
+
+## Trigger Patterns
+
+```
+"归档", "archive", "完成"
+"变更完成", "change complete"
+"结束变更", "finish change"
+"交付", "deliver"
+```
+
+## Output Format
+
+```
+┌─────────────────────────────────────────────────────┐
+│ Change Archived                                     │
+├─────────────────────────────────────────────────────┤
+│ Change: {change_name}                               │
+│ Status: ✓ Completed                                 │
+│ Duration: {days} days                               │
+├─────────────────────────────────────────────────────┤
+│ Artifacts:                                          │
+│ • Proposal: ✓                                       │
+│ • Specs: ✓                                          │
+│ • Design: ✓                                         │
+│ • Tasks: ✓ (15/15 completed)                        │
+│ • Tests: ✓ (42 passed)                              │
+├─────────────────────────────────────────────────────┤
+│ Archive Location:                                   │
+│ archive/changes/{change_name}/                      │
+└─────────────────────────────────────────────────────┘
+```
+
+## Archive Structure
+
+```
+archive/
+└── changes/
+    └── {change_name}/
+        ├── SUMMARY.md           # Change summary
+        ├── PROPOSAL.md          # Original proposal
+        ├── SPECS.md             # Specifications
+        ├── DESIGN.md            # Design document
+        ├── TASKS.md             # Task list
+        ├── CHANGELOG.md         # Detailed changes
+        ├── TESTS.md             # Test results
+        └── artifacts/           # Related files
+```
+
+## Learning Integration
+
+This skill supports FlowMind learning:
+
+- **Archive Format**: Learns preferred archive structure
+- **Summary Style**: Learns how to summarize changes
+- **Cleanup Rules**: Learns what to keep/delete
+
+```
+User: "归档时保留测试报告"
+FlowMind: ✓ Learned: Keep test reports in archive
+
+User: [Next archive]
+FlowMind: [Includes test reports automatically]
+```
+
+## Examples
+
+### Example 1: Archive Feature
+
+```
+User: 归档用户登录功能
+
+FlowMind:
+┌─────────────────────────────────────────────────────┐
+│ Change Archived                                     │
+├─────────────────────────────────────────────────────┤
+│ Change: user-login-feature                          │
+│ Status: ✓ Completed                                 │
+│ Duration: 14 days                                   │
+├─────────────────────────────────────────────────────┤
+│ Summary:                                            │
+│ • Implemented OAuth2 login                          │
+│ • Added social login (Google, GitHub)               │
+│ • Created user session management                   │
+│ • Added login rate limiting                         │
+├─────────────────────────────────────────────────────┤
+│ Metrics:                                            │
+│ • 23 files changed                                  │
+│ • 1,847 lines added                                 │
+│ • 42 test cases                                     │
+│ • 100% test coverage                                │
+├─────────────────────────────────────────────────────┤
+│ Archive: archive/changes/user-login-feature/        │
+└─────────────────────────────────────────────────────┘
+```
+
+### Example 2: Bulk Archive
+
+```
+User: 归档所有已完成的变更
+
+FlowMind:
+┌─────────────────────────────────────────────────────┐
+│ Bulk Archive Complete                               │
+├─────────────────────────────────────────────────────┤
+│ Archived: 3 changes                                 │
+│ • user-login-feature (14 days)                      │
+│ • order-optimization (7 days)                       │
+│ • api-refactor (21 days)                            │
+├─────────────────────────────────────────────────────┤
+│ Total:                                              │
+│ • 67 files archived                                 │
+│ • 12,456 lines documented                           │
+│ • 156 test cases                                    │
+└─────────────────────────────────────────────────────┘
+```
+
+## Configuration
+
+```json
+{
+  "archive-change": {
+    "location": "archive/changes",
+    "keepTests": true,
+    "keepArtifacts": true,
+    "generateSummary": true,
+    "updateChangelog": true
+  }
+}
+```
+
+## Archive Checklist
+
+Before archiving, FlowMind checks:
+
+- [ ] All tasks completed
+- [ ] All tests passing
+- [ ] Documentation updated
+- [ ] Code reviewed
+- [ ] No open issues
+- [ ] Deployment verified