team-anya-cli 0.1.4 → 0.1.6

package/apps/server/dist/broker/cc-broker.js

@@ -15,12 +15,14 @@ export class CCBroker extends EventEmitter {
     instances = new Map();
     maxLoidInstances;
     maxYorInstances;
+    maxFrankyInstances;
     logger;
     shuttingDown = false;
     constructor(config) {
         super();
         this.maxLoidInstances = config.maxLoidInstances;
         this.maxYorInstances = config.maxYorInstances;
+        this.maxFrankyInstances = config.maxFrankyInstances ?? 2;
         this.logger = config.logger ?? { info: console.log, error: console.error };
     }
     // ── 生命周期 ──
@@ -33,7 +35,9 @@ export class CCBroker extends EventEmitter {
         }
         // 并发检查
         const currentCount = this.countByRole(options.role);
-        const maxCount = options.role === 'loid' ? this.maxLoidInstances : this.maxYorInstances;
+        const maxCount = options.role === 'loid' ? this.maxLoidInstances
+            : options.role === 'yor' ? this.maxYorInstances
+                : this.maxFrankyInstances;
         if (currentCount >= maxCount) {
             throw new Error(`${options.role} 实例已满（${currentCount}/${maxCount}）`);
         }

package/apps/server/dist/franky/context-builder.js

@@ -0,0 +1,160 @@
+import { readFile, readdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { getTopic, getRecentMessages } from '@team-anya/db';
+/**
+ * 为 Franky CC 实例重建上下文
+ * 按 checkpoint 截断策略：所有 checkpoint 标题 + 最近 2 个详情 + 末个 checkpoint 后对话
+ */
+export async function buildTopicContext(deps, topicId) {
+    const topic = getTopic(deps.db, topicId);
+    if (!topic)
+        throw new Error(`专项 ${topicId} 不存在`);
+    const topicDir = join(deps.workspacePath, 'franky', 'topics', topicId);
+    const sections = [];
+    // 1. Topic 元信息
+    sections.push(`# 专项上下文：${topic.title} (${topic.id})`);
+    sections.push('');
+    sections.push('## 目标');
+    sections.push(topic.description ?? '（未设定）');
+    sections.push('');
+    sections.push('## 通讯信息');
+    if (topic.chat_id)
+        sections.push(`- 群聊 ID：\`${topic.chat_id}\``);
+    if (topic.root_message_id)
+        sections.push(`- 话题根消息 ID：\`${topic.root_message_id}\``);
+    if (topic.thread_id)
+        sections.push(`- 话题 ID：\`${topic.thread_id}\`（仅供参考，channel.send 的 reply_to 请用根消息 ID）`);
+    sections.push('');
+    sections.push('## 项目信息');
+    sections.push(`- 专项 ID：${topic.id}`);
+    sections.push(`- 状态：${topic.status}`);
+    if (topic.project_id)
+        sections.push(`- 关联项目：${topic.project_id}`);
+    if (topic.branch_name)
+        sections.push(`- 分支：${topic.branch_name}`);
+    sections.push('');
+    // 1.5 代码工作区（worktree 信息）
+    if (topic.project_id && topic.workspace_path) {
+        try {
+            const entries = await readdir(topic.workspace_path, { withFileTypes: true });
+            const worktreeDirs = entries
+                .filter(e => e.isDirectory() && !e.name.startsWith('.') && e.name !== 'checkpoints')
+                .map(e => e.name);
+            if (worktreeDirs.length > 0) {
+                sections.push('## 代码工作区');
+                sections.push('');
+                for (const dir of worktreeDirs) {
+                    const fullPath = join(topic.workspace_path, dir);
+                    const branchInfo = topic.branch_name ? `分支 \`${topic.branch_name}\`，` : '';
+                    sections.push(`- \`${dir}/\` → ${branchInfo}路径 \`${fullPath}\``);
+                }
+                sections.push('');
+                sections.push('> 代码在上述 worktree 子目录中，git 操作请进入对应子目录执行。');
+                sections.push('');
+            }
+        }
+        catch {
+            // workspace 不可读，跳过
+        }
+    }
+    // 2. Checkpoints
+    const checkpointsDir = join(topicDir, 'checkpoints');
+    let checkpointFiles = [];
+    if (existsSync(checkpointsDir)) {
+        const files = await readdir(checkpointsDir);
+        checkpointFiles = files.filter(f => f.match(/^\d{3}-.*\.md$/)).sort();
+    }
+    if (checkpointFiles.length > 0) {
+        sections.push('## Checkpoint 概览');
+        for (const file of checkpointFiles) {
+            const num = file.split('-')[0];
+            const name = file.replace(/^\d{3}-/, '').replace(/\.md$/, '');
+            sections.push(`${parseInt(num, 10)}. ${name}`);
+        }
+        sections.push('');
+        // 最近 2 个 checkpoint 的完整内容
+        const recentCheckpoints = checkpointFiles.slice(-2);
+        sections.push('## 最近 Checkpoint 详情');
+        sections.push('');
+        for (const file of recentCheckpoints) {
+            try {
+                const content = await readFile(join(checkpointsDir, file), 'utf-8');
+                sections.push(content.trim());
+                sections.push('');
+            }
+            catch {
+                // 文件读取失败，跳过
+            }
+        }
+    }
+    // 3. Git log（如果有 worktree）
+    const gitDir = join(topicDir);
+    try {
+        const gitLog = execSync('git log --oneline -10 2>/dev/null || true', {
+            cwd: gitDir,
+            encoding: 'utf-8',
+            timeout: 5000,
+        }).trim();
+        if (gitLog) {
+            sections.push('## 近期 Git 记录');
+            sections.push('```');
+            sections.push(gitLog);
+            sections.push('```');
+            sections.push('');
+        }
+    }
+    catch {
+        // 不是 git 仓库或命令失败，跳过
+    }
+    // 4. 最后一个 checkpoint 之后的对话（用 thread_id 所在的 chat_id + since 过滤）
+    if (topic.chat_id) {
+        try {
+            // 查找最后一个 checkpoint 的时间戳，只拉取其后的消息
+            let since;
+            if (checkpointFiles.length > 0) {
+                try {
+                    const lastCheckpointPath = join(checkpointsDir, checkpointFiles[checkpointFiles.length - 1]);
+                    const stat = await import('node:fs/promises').then(m => m.stat(lastCheckpointPath));
+                    since = stat.mtime.toISOString().replace(/\.\d{3}Z$/, 'Z');
+                }
+                catch {
+                    // stat 失败，不设 since 过滤
+                }
+            }
+            const messages = getRecentMessages(deps.db, {
+                chat_id: topic.chat_id,
+                limit: 30,
+                sort: 'asc',
+                ...(since ? { since } : {}),
+            });
+            if (messages.length > 0) {
+                sections.push('## 近期对话');
+                sections.push('');
+                for (const msg of messages) {
+                    const direction = msg.direction === 'outbound' ? 'Anya' : (msg.sender_name ?? msg.sender ?? '用户');
+                    sections.push(`**${direction}** (${msg.created_at}):`);
+                    // 截断过长的消息
+                    const content = msg.content.length > 500 ? msg.content.slice(0, 500) + '...' : msg.content;
+                    sections.push(content);
+                    sections.push('');
+                }
+            }
+        }
+        catch (err) {
+            deps.logger?.error('[TopicContextBuilder] 查询对话历史失败:', err);
+        }
+    }
+    return sections.join('\n');
+}
+/**
+ * 生成并写入 context.md 文件
+ */
+export async function writeTopicContext(deps, topicId) {
+    const content = await buildTopicContext(deps, topicId);
+    const contextPath = join(deps.workspacePath, 'franky', 'topics', topicId, 'context.md');
+    await writeFile(contextPath, content, 'utf-8');
+    return contextPath;
+}
+//# sourceMappingURL=context-builder.js.map

package/apps/server/dist/franky/franky-mcp-server.js

@@ -0,0 +1,107 @@
+import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { Server } from '@modelcontextprotocol/sdk/server';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { createToolRouter } from '@team-anya/mcp-tools';
+// ── MCP Server 创建（薄路由层） ──
+function createFrankyMcpServer(deps) {
+    const logger = deps.logger ?? { info: console.log, error: console.error };
+    const routerDeps = {
+        db: deps.db,
+        workspacePath: deps.workspacePath,
+        currentTopicId: deps.topicId,
+        replyToThreadId: deps.replyToThreadId,
+        channelRegistry: deps.channelRegistry,
+        onMessageSent: deps.onMessageSent,
+        onTopicClosed: deps.onTopicClosed,
+        onTopicEscalated: deps.onTopicEscalated,
+        logger,
+    };
+    const router = createToolRouter('franky', routerDeps);
+    const server = new Server({ name: 'franky-mcp', version: '1.0.0' }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        const tools = router.tools.map(def => ({
+            name: def.name,
+            description: def.description,
+            inputSchema: zodToJsonSchema(def.inputSchema),
+        }));
+        return { tools };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        return router.handleToolCall(name, args ?? {});
+    });
+    return server;
+}
+/**
+ * 启动 Franky MCP server（薄路由层）
+ *
+ * Franky 可以使用 Layer 1 全部共享工具 + Layer 3 Franky 专属工具（channel.send 等）。
+ * 不需要 Yor 的 deliver/block 工具。
+ *
+ * 所有工具实现来自 @team-anya/mcp-tools。
+ */
+export async function startFrankyMcpServer(deps) {
+    const sessions = new Map();
+    const httpServer = createServer(async (req, res) => {
+        const url = new URL(req.url ?? '/', `http://${req.headers.host ?? 'localhost'}`);
+        if (url.pathname !== '/mcp') {
+            res.writeHead(404);
+            res.end('Not Found');
+            return;
+        }
+        const sessionId = req.headers['mcp-session-id'];
+        if (sessionId && sessions.has(sessionId)) {
+            const { transport } = sessions.get(sessionId);
+            await transport.handleRequest(req, res);
+            return;
+        }
+        if (req.method === 'POST') {
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+            });
+            const server = createFrankyMcpServer(deps);
+            transport.onclose = () => {
+                if (transport.sessionId) {
+                    sessions.delete(transport.sessionId);
+                }
+            };
+            await server.connect(transport);
+            await transport.handleRequest(req, res);
+            if (transport.sessionId) {
+                sessions.set(transport.sessionId, { server, transport });
+            }
+            return;
+        }
+        res.writeHead(400);
+        res.end('Bad Request: No valid session');
+    });
+    await new Promise((resolve) => {
+        httpServer.listen(0, '127.0.0.1', resolve);
+    });
+    const addr = httpServer.address();
+    const port = typeof addr === 'object' && addr !== null ? addr.port : 0;
+    const serverUrl = `http://127.0.0.1:${port}/mcp`;
+    return {
+        port,
+        url: serverUrl,
+        close: async () => {
+            for (const { server, transport } of sessions.values()) {
+                await transport.close();
+                await server.close();
+            }
+            sessions.clear();
+            await new Promise((resolve, reject) => {
+                httpServer.close((err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=franky-mcp-server.js.map