momo-ai 1.0.20 → 1.0.21

package/src/executor/index.js

@@ -1,50 +1,16 @@
 const executeHelp = require('./executeHelp');
 const executeInit = require('./executeInit');
-const executeRepo = require('./executeRepo');
-const executeAdd = require('./executeAdd');
-const executePlan = require('./executePlan');
-const executeArchive = require('./executeArchive');
 const executeEnv = require('./executeEnv');
 const executeOpen = require('./executeOpen');
-const executeShow = require('./executeShow');
-const executeList = require('./executeList');
-const executeValidate = require('./executeValidate');
-const executeActor = require('./executeActor');
-const executeActors = require('./executeActors');
-const executeRun = require('./executeRun');
-const executeTasks = require('./executeTasks');
-const executeUnlock = require('./executeUnlock');
-const executeProject = require('./executeProject');
-const executeAgentCfg = require('./executeAgentCfg');
-const executeAgent = require('./executeAgent');
-const executeConsole = require('./executeConsole');
-const executePull = require('./executePull');
-const executeCommit = require('./executeCommit');
-const executePush = require('./executePush');
+const executeSkills = require('./executeSkills');
+const executeMcp = require('./executeMcp');
 
 const exported = {
     executeHelp,
     executeInit,
-    executeRepo,
-    executeAdd,
-    executePlan,
-    executeArchive,
     executeEnv,
     executeOpen,
-    executeShow,
-    executeList,
-    executeValidate,
-    executeActor,
-    executeActors,
-    executeRun,
-    executeTasks,
-    executeUnlock,
-    executeProject,
-    executeAgentCfg,
-    executeAgent,
-    executeConsole,
-    executePull,
-    executeCommit,
-    executePush
+    executeSkills,
+    executeMcp
 };
-module.exports = exported;
+module.exports = exported;

package/src/momo.js

@@ -28,7 +28,8 @@ if (_isVersionMode()) {
 }
 
 // 输出头部
-Ec.executeHeader("Rachel Momo / SDD");
+Ec.info("SDD / Spec Driven Development ...")
+// Ec.executeHeader("Rachel Momo / SDD");
 
 // 读取配置文件
 const configArr = Ec.parseMetadata();

package/src/utils/momo-args.js

@@ -0,0 +1,39 @@
+/**
+ * @module args
+ * 高级参数解析工具
+ */
+const Ec = require('../epic');
+
+// 标准解析 (key-value)
+const parseStandard = (options) => Ec.parseArgument(options);
+
+// 解析可选值 (-r [val]) -> { hasFlag, value }
+const parseOptional = (flag, alias) => {
+    const args = process.argv.slice(3);
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === `-${alias}` || args[i] === `--${flag}`) {
+            const next = args[i+1];
+            return { hasFlag: true, value: (next && !next.startsWith('-')) ? next : null };
+        }
+    }
+    return { hasFlag: false, value: null };
+};
+
+// 解析布尔值 (-v) -> boolean
+const parseBool = (flag, alias) => {
+    const args = process.argv.slice(3);
+    return args.includes(`--${flag}`) || args.includes(`-${alias}`);
+};
+
+// 解析位置参数 -> array
+const parsePositional = () => {
+    const args = process.argv.slice(3);
+    const res = [];
+    for (let i = 0; i < args.length; i++) {
+        if (args[i].startsWith('-')) { i++; continue; } // Skip flags and their potential values (simple heuristic)
+        res.push(args[i]);
+    }
+    return res;
+};
+
+module.exports = { parseStandard, parseOptional, parseBool, parsePositional };

package/src/utils/momo-file-utils.js

@@ -0,0 +1,75 @@
+/**
+ * @module momo-fs
+ * 文件、目录、YAML 解析与 Git 操作的集合库
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const fsAsync = require('fs').promises;
+const { execSync } = require('child_process');
+
+// --- 基础文件操作 ---
+const ensureDir = async (p) => fsAsync.mkdir(p, { recursive: true });
+const exists = (p) => fs.existsSync(p);
+const readJson = (p) => exists(p) ? JSON.parse(fs.readFileSync(p, 'utf8')) : null;
+const writeJson = async (p, d, i = 4) => {
+    await ensureDir(path.dirname(p));
+    await fsAsync.writeFile(p, JSON.stringify(d, null, i));
+};
+
+const copyDir = async (src, dest) => {
+    await ensureDir(dest);
+    const items = await fsAsync.readdir(src);
+    for (const item of items) {
+        const sPath = path.join(src, item), dPath = path.join(dest, item);
+        (await fsAsync.stat(sPath)).isDirectory() ? await copyDir(sPath, dPath) : await fsAsync.copyFile(sPath, dPath);
+    }
+};
+
+const scanDir = (dir, filter = () => true) => {
+    if (!exists(dir)) return [];
+    return fs.readdirSync(dir).reduce((acc, item) => {
+        const p = path.join(dir, item);
+        try {
+            if (fs.statSync(p).isDirectory() && filter(item, p)) acc.push({ name: item, path: p, isDirectory: true });
+        } catch (e) {}
+        return acc;
+    }, []);
+};
+
+// --- 临时目录 ---
+const createTempDir = (pre = 'momo') => path.join(os.tmpdir(), `.${pre}-${Date.now()}`);
+const cleanup = async (p) => p && exists(p) ? fsAsync.rm(p, { recursive: true, force: true }).then(() => true).catch(() => false) : false;
+
+// --- Git ---
+const gitClone = (url, dest, { shallow = true } = {}) => {
+    try {
+        execSync(`git clone ${shallow ? '--depth 1' : ''} "${url}" "${dest}"`, { stdio: 'ignore' });
+        return true;
+    } catch (e) { throw new Error(`Git clone failed: ${e.message}`); }
+};
+
+// --- YAML ---
+const parseYaml = (str) => { // 简易解析
+    const meta = {}; let arrKey = null;
+    str.split('\n').forEach(line => {
+        if (!line.trim() || line.trim().startsWith('#')) return;
+        const arrM = line.match(/^(\s+)-\s+(.+)$/);
+        if (arrM && arrKey) { (meta[arrKey] = meta[arrKey] || []).push(arrM[2].trim().replace(/^["']|["']$/g, '')); return; }
+        const kvM = line.match(/^(\w[\w-]*):\s*(.*)$/);
+        if (kvM) {
+            const k = kvM[1], v = kvM[2].trim().replace(/^["']|["']$/g, '');
+            if (!v) { arrKey = k; meta[k] = []; } else { meta[k] = v === 'true' ? true : v === 'false' ? false : !isNaN(v) ? Number(v) : v; arrKey = null; }
+        }
+    });
+    return meta;
+};
+
+const parseFile = (p) => {
+    if (!exists(p)) return null;
+    const content = fs.readFileSync(p, 'utf8');
+    const match = content.match(/^---\n([\s\S]+?)\n---/);
+    return match ? { attributes: parseYaml(match[1]), body: content.replace(match[0], '').trim() } : null;
+};
+
+module.exports = { copyDir, scanDir, createTempDir, cleanup, ensureDir, exists, readJson, writeJson, gitClone, parseFile, parseYaml };

package/src/utils/momo-menu.js

@@ -0,0 +1,54 @@
+/**
+ * @module momo-menu
+ * 交互式菜单 (Raw Mode)
+ */
+const readline = require('readline');
+const clearScreen = () => process.stdout.write('\x1B[2J\x1B[0f');
+
+const _baseSelect = (items, title, isMulti) => new Promise(resolve => {
+    let cursor = 0;
+    const selected = new Array(items.length).fill(false);
+    const maxLen = Math.max(...items.map(i => (i.name||'').length), 4);
+
+    const render = () => {
+        clearScreen();
+        console.log(`\n[Momo AI]`.blue.bold + ` ====== ${title} ======`.blue + '\n');
+        items.forEach((item, i) => {
+            const active = i === cursor, check = isMulti ? (selected[i] ? '[✓]'.green : '[ ]') : '';
+            console.log(`  ${active ? '▸'.cyan : ' '} ${check} ${(item.name||'').padEnd(maxLen)[active?'cyan':'reset']}${active?''.bold:''}  ${(item.description||'').gray}`);
+        });
+        console.log('\n  ' + (isMulti ? 'Space:Toggle  A:All  N:None  ' : '') + 'Enter:Confirm  Q:Quit'.gray + '\n');
+    };
+
+    readline.emitKeypressEvents(process.stdin);
+    if (process.stdin.isTTY) process.stdin.setRawMode(true);
+    render();
+
+    const onKey = (str, key) => {
+        if (!key) return;
+        if ((key.ctrl && key.name === 'c') || key.name === 'q' || key.name === 'escape') {
+            cleanup(); resolve(isMulti ? { indices: [], items: [] } : null); return;
+        }
+        if (key.name === 'up') { cursor = cursor > 0 ? cursor - 1 : items.length - 1; render(); }
+        if (key.name === 'down') { cursor = cursor < items.length - 1 ? cursor + 1 : 0; render(); }
+        if (isMulti) {
+            if (key.name === 'space') { selected[cursor] = !selected[cursor]; render(); }
+            if (key.name === 'a') { selected.fill(true); render(); }
+            if (key.name === 'n') { selected.fill(false); render(); }
+        }
+        if (key.name === 'return') {
+            cleanup();
+            if (!isMulti) resolve(items[cursor]);
+            else resolve({ indices: selected.map((v, i) => v ? i : -1).filter(i => i !== -1), items: items.filter((_, i) => selected[i]) });
+        }
+    };
+
+    const cleanup = () => { process.stdin.setRawMode(false); process.stdin.removeListener('keypress', onKey); clearScreen(); };
+    process.stdin.on('keypress', onKey);
+});
+
+module.exports = {
+    selectMultiple: (items, title) => _baseSelect(items, title || 'Select Options', true),
+    selectSingle: (items, title) => _baseSelect(items, title || 'Select One', false),
+    clearScreen
+};

package/src/commander/actor.json

@@ -1,12 +0,0 @@
-{
-    "executor": "executeActor",
-    "description": "创建或更新指定的AI角色信息！",
-    "command": "actor",
-    "options": [
-        {
-            "name": "name",
-            "alias": "n",
-            "description": "角色名称！"
-        }
-    ]
-}

package/src/commander/actors.json

@@ -1,6 +0,0 @@
-{
-    "executor": "executeActors",
-    "description": "列出所有已存在的AI角色信息！",
-    "command": "actors",
-    "options": []
-}

package/src/commander/add.json

@@ -1,12 +0,0 @@
-{
-    "executor": "executeAdd",
-    "description": "（CV）添加新需求，并将 prompt 追加到剪切板中！",
-    "command": "add",
-    "options": [
-        {
-            "name": "name",
-            "alias": "n",
-            "description": "需求名称或者需求文件的 .md 路径"
-        }
-    ]
-}

package/src/commander/agent.json

@@ -1,12 +0,0 @@
-{
-    "executor": "executeAgent",
-    "description": "加载并复制指定 Agent 的提示词到剪切板",
-    "command": "agent",
-    "options": [
-        {
-            "name": "agent",
-            "alias": "a",
-            "description": "智能体名称（Arg Name）"
-        }
-    ]
-}

package/src/commander/agentcfg.json

@@ -1,5 +0,0 @@
-{
-    "executor": "executeAgentCfg",
-    "description": "配置和打开系统内置 agents",
-    "command": "agentcfg"
-}

package/src/commander/archive.json

@@ -1,12 +0,0 @@
-{
-    "executor": "executeArchive",
-    "description": "将某个需求归档操作，会删除原始需求信息！",
-    "command": "archive",
-    "options": [
-        {
-            "name": "name",
-            "alias": "n",
-            "description": "需求名称，不可以是 .md 的文档，而且需求必须存在！"
-        }
-    ]
-}

package/src/commander/commit.json

@@ -1,12 +0,0 @@
-{
-    "executor": "executeCommit",
-    "description": "提交所有副本的更改到本地仓库！",
-    "command": "commit",
-    "options": [
-        {
-            "name": "message",
-            "alias": "m",
-            "description": "提交信息"
-        }
-    ]
-}

package/src/commander/console.json

@@ -1,7 +0,0 @@
-{
-    "executor": "executeConsole",
-    "description": "启动交互式控制台",
-    "command": "console",
-    "options": [
-    ]
-}

package/src/commander/lain.json

@@ -1,7 +0,0 @@
-{
-    "executor": "executeConsole",
-    "description": "启动交互式控制台",
-    "command": "lain",
-    "options": [
-    ]
-}

package/src/commander/list.json

@@ -1,7 +0,0 @@
-{
-    "executor": "executeList",
-    "description": "列举所有需求列表！",
-    "command": "list",
-    "options": [
-    ]
-}

package/src/commander/plan.json

@@ -1,12 +0,0 @@
-{
-    "executor": "executePlan",
-    "description": "（CV）生成新的需求计划，重写需求信息！",
-    "command": "plan",
-    "options": [
-        {
-            "name": "name",
-            "alias": "n",
-            "description": "需求名称，不可以是 .md 的文档，而且需求必须存在！"
-        }
-    ]
-}

package/src/commander/project.json

@@ -1,12 +0,0 @@
-{
-    "executor": "executeProject",
-    "description": "引用外部项目到 reference 目录中",
-    "command": "project",
-    "options": [
-        {
-            "name": "source",
-            "alias": "s",
-            "description": "项目路径，必须提供"
-        }
-    ]
-}

package/src/commander/pull.json

@@ -1,6 +0,0 @@
-{
-    "executor": "executePull",
-    "description": "从远程仓库拉取所有副本的最新代码！",
-    "command": "pull",
-    "options": []
-}

package/src/commander/push.json

@@ -1,6 +0,0 @@
-{
-    "executor": "executePush",
-    "description": "推送所有副本的更改到远程仓库！",
-    "command": "push",
-    "options": []
-}

package/src/commander/repo.json

@@ -1,18 +0,0 @@
-{
-    "executor": "executeRepo",
-    "description": "Clone 仓库中的代码到工作区！",
-    "command": "repo",
-    "options": [
-        {
-            "name": "address",
-            "alias": "a",
-            "description": "当前项目的远程 Git 仓库地址！"
-        },
-        {
-            "name": "instance",
-            "alias": "i",
-            "description": "需要 Clone 的远程仓库的实例副本数量！",
-            "default": 10
-        }
-    ]
-}

package/src/commander/run.json

@@ -1,18 +0,0 @@
-{
-    "executor": "executeRun",
-    "description": "（CV）执行指定的任务！",
-    "command": "run",
-    "options": [
-        {
-            "name": "actor",
-            "alias": "a",
-            "description": "指定执行任务的 Actor 名称",
-            "default": "unknown"
-        },
-        {
-            "name": "task",
-            "alias": "t",
-            "description": "任务名称"
-        }
-    ]
-}

package/src/commander/show.json

@@ -1,12 +0,0 @@
-{
-    "executor": "executeShow",
-    "description": "显示指定需求的详细内容！",
-    "command": "show",
-    "options": [
-        {
-            "name": "name",
-            "alias": "n",
-            "description": "需求名称！"
-        }
-    ]
-}

package/src/commander/tasks.json

@@ -1,18 +0,0 @@
-{
-    "executor": "executeTasks",
-    "description": "（CV）枚举所有任务信息！",
-    "command": "tasks",
-    "options": [
-        {
-            "name": "actor",
-            "alias": "a",
-            "description": "指定执行任务的 Actor 名称",
-            "default": "unknown"
-        },
-        {
-            "name": "task",
-            "alias": "t",
-            "description": "任务名称"
-        }
-    ]
-}

package/src/commander/unlock.json

@@ -1,6 +0,0 @@
-{
-    "executor": "executeUnlock",
-    "description": "解锁所有被占用的任务和工作空间！",
-    "command": "unlock",
-    "options": []
-}

package/src/commander/validate.json

@@ -1,12 +0,0 @@
-{
-    "executor": "executeValidate",
-    "description": "验证指定需求格式是否合法！",
-    "command": "validate",
-    "options": [
-        {
-            "name": "name",
-            "alias": "n",
-            "description": "需求名称！"
-        }
-    ]
-}

package/src/executor/executeActor.js

@@ -1,133 +0,0 @@
-const Ec = require('../epic');
-const fs = require('fs');
-const path = require('path');
-
-/**
- * 交互式选择LLM
- */
-const _selectLLM = async (actorName) => {
-    Ec.waiting('🤖 请选择要使用的LLM:');
-
-    const llmOptions = [
-        {name: 'OpenSpec', value: 'openspec'},
-        {name: 'SpecKit', value: 'spec-kit'},
-        {name: 'Kiro', value: 'kiro'},
-        {name: 'Trea', value: 'trea'},
-        {name: 'Cursor', value: 'cursor'},
-        {name: 'Lingma', value: 'lingma'},
-        {name: 'Qoder', value: 'qoder'},
-        {name: 'WindSurf', value: 'windsurf'},
-        {name: 'GitHub Copilot', value: 'github'},
-        {name: 'Claude Code', value: 'claude-code'},
-        {name: 'ChatGPT', value: 'chatgpt'}
-    ];
-
-    // 显示选项
-    llmOptions.forEach((option, index) => {
-        Ec.waiting(`${index + 1}. ${option.name}`);
-    });
-
-    // 获取用户选择
-    const answer = await Ec.ask('请输入选项编号: ');
-    const selectedIndex = parseInt(answer) - 1;
-
-    // 验证选择
-    if (isNaN(selectedIndex) || selectedIndex < 0 || selectedIndex >= llmOptions.length) {
-        Ec.error('❌ 无效的选择');
-        return _selectLLM(actorName); // 重新选择
-    }
-
-    const selectedLLM = llmOptions[selectedIndex];
-
-    // 获取 token 配置信息
-    const token = await Ec.ask(`请输入 ${selectedLLM.name} 的 Token (可选): `);
-
-    return {
-        llm: selectedLLM.value,
-        name: actorName,
-        token: token || ''
-    };
-};
-
-module.exports = async (options) => {
-    // 参数提取
-    const parsed = Ec.parseArgument(options);
-    const actorName = parsed.actor || parsed.a;
-
-    if (!actorName) {
-        Ec.error("❌ 请提供角色名称 (-a, --actor)");
-        process.exit(1);
-    }
-    
-    // 在 Windows 上检查非法字符
-    if (process.platform === 'win32') {
-        const illegalChars = /[<>:"/\\|?*\x00-\x1F]/g;
-        if (illegalChars.test(actorName)) {
-            Ec.error(`❌ 角色名称 "${actorName}" 包含非法字符，请避免使用以下字符: < > : " / \\ | ? * 以及控制字符`);
-            process.exit(1);
-        }
-    }
-
-    try {
-        // 检查 specification/actor 目录是否存在
-        const actorBaseDir = path.resolve(process.cwd(), 'specification', 'actor');
-        if (!fs.existsSync(actorBaseDir)) {
-            Ec.error("❌ 未找到 specification/actor 目录，请先初始化项目");
-            process.exit(1);
-        }
-
-        // 检查角色是否已存在
-        const actorDir = path.resolve(actorBaseDir, actorName);
-        if (fs.existsSync(actorDir)) {
-            Ec.error(`❌ 角色 "${actorName}" 已存在`);
-            process.exit(1);
-        }
-
-        // 创建角色目录
-        if (!fs.existsSync(actorDir)) {
-            fs.mkdirSync(actorDir, { recursive: true });
-        }
-
-        // 从模板复制内容到stack.md和limit.md
-        const templatePath = path.resolve(__dirname, '../_template/LAIN/.momo/advanced/actor.md');
-        if (fs.existsSync(templatePath)) {
-            const templateContent = fs.readFileSync(templatePath, 'utf8');
-            
-            // 提取技术栈和限制信息
-            const stackMatch = templateContent.match(/## 技术栈([\s\S]*?)## 限制/);
-            const limitMatch = templateContent.match(/## 限制([\s\S]*)/);
-            
-            if (stackMatch && limitMatch) {
-                const stackContent = `# 技术栈信息\n\n${stackMatch[1].trim()}\n`;
-                const stackPath = path.resolve(actorDir, 'stack.md');
-                fs.writeFileSync(stackPath, stackContent);
-                Ec.waiting(`📄 创建技术栈文件: ${stackPath}`);
-                
-                const limitContent = `# 角色限制\n\n${limitMatch[1].trim()}\n`;
-                const limitPath = path.resolve(actorDir, 'limit.md');
-                fs.writeFileSync(limitPath, limitContent);
-                Ec.waiting(`📄 创建限制文件: ${limitPath}`);
-                
-                // 创建config.json文件
-                const configPath = path.resolve(actorDir, 'config.json');
-                fs.writeFileSync(configPath, JSON.stringify(llmConfig, null, 4));
-                Ec.waiting(`📄 创建配置文件: ${configPath}`);
-                
-                Ec.info(`✅ 成功添加新角色 "${actorName}"`);
-                process.exit(0);
-            } else {
-                Ec.error("❌ 模板文件格式不正确");
-                process.exit(1);
-            }
-        } else {
-            Ec.error(`❌ 未找到模板文件: ${templatePath}`);
-            process.exit(1);
-        }
-    } catch (error) {
-        Ec.error(`❌ 执行过程中发生错误: ${error.message}`);
-        if (process.platform === 'win32') {
-            Ec.waiting('💡 Windows 用户提示: 请确保您在具有足够权限的命令行中运行此命令');
-        }
-        process.exit(1);
-    }
-};