@spaceflow/core 0.15.0 → 0.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaceflow/core",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Spaceflow 核心能力库",
   "license": "MIT",
   "author": "Lydanne",

package/src/cli-runtime/extension-loader.ts

@@ -81,4 +81,24 @@ export class ExtensionLoader {
     }
     return result;
   }
+
+  /**
+   * 获取所有 MCP 资源
+   * 返回扩展中定义的 resources 字段
+   */
+  getResources(): Array<{
+    extensionName: string;
+    resources: NonNullable<ExtensionDefinition["resources"]>;
+  }> {
+    const result: Array<{
+      extensionName: string;
+      resources: NonNullable<ExtensionDefinition["resources"]>;
+    }> = [];
+    for (const ext of this.extensions.values()) {
+      if (ext.resources && ext.resources.length > 0) {
+        result.push({ extensionName: ext.name, resources: ext.resources });
+      }
+    }
+    return result;
+  }
 }

package/src/commands/mcp/mcp.service.ts

@@ -1,12 +1,19 @@
 import { t } from "@spaceflow/core";
-import type { VerboseLevel } from "@spaceflow/core";
+import type { VerboseLevel, McpResourceDefinition, SpaceflowContext } from "@spaceflow/core";
 import { shouldLog, type McpToolMetadata } from "@spaceflow/core";
+import { readConfigSync } from "@spaceflow/shared";
 import type { ExtensionLoader } from "../../cli-runtime/extension-loader";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { spawn } from "child_process";
 
+/** 内部 resource 收集结构 */
+interface CollectedResource {
+  resource: McpResourceDefinition;
+  ctx: SpaceflowContext;
+}
+
 export class McpService {
   constructor(private readonly extensionLoader: ExtensionLoader) {}
 
@@ -57,16 +64,27 @@ export class McpService {
       }
     }
 
-    if (allTools.length === 0) {
+    // 收集扩展 resources + 内置 resources
+    const allResources = this.collectResources(verbose);
+
+    if (allTools.length === 0 && allResources.length === 0) {
       console.error(t("mcp:noToolsFound"));
       console.error(t("mcp:noToolsHint"));
       process.exit(1);
     }
 
     if (shouldLog(verbose, 1)) {
-      console.error(t("mcp:toolsFound", { count: allTools.length }));
-      for (const { tool } of allTools) {
-        console.error(`   - ${tool.name}`);
+      if (allTools.length > 0) {
+        console.error(t("mcp:toolsFound", { count: allTools.length }));
+        for (const { tool } of allTools) {
+          console.error(`   - ${tool.name}`);
+        }
+      }
+      if (allResources.length > 0) {
+        console.error(t("mcp:resourcesFound", { count: allResources.length }));
+        for (const { resource } of allResources) {
+          console.error(`   - ${resource.name} (${resource.uri})`);
+        }
       }
     }
 
@@ -78,7 +96,93 @@ export class McpService {
     }
 
     // 被 MCP 客户端通过管道调用，正常启动 stdio server
-    await this.runServer(allTools, verbose);
+    await this.runServer(allTools, allResources, verbose);
+  }
+
+  /**
+   * 收集所有 MCP 资源（扩展 + 内置）
+   */
+  private collectResources(verbose?: VerboseLevel): CollectedResource[] {
+    const ctx = this.extensionLoader.getContext();
+    const allResources: CollectedResource[] = [];
+
+    // 1. 收集扩展声明的 resources
+    const extensionResources = this.extensionLoader.getResources();
+    for (const { extensionName, resources } of extensionResources) {
+      if (shouldLog(verbose, 2)) {
+        console.error(`   扩展 ${extensionName} 提供 ${resources.length} 个 MCP 资源`);
+      }
+      for (const resource of resources) {
+        allResources.push({ resource, ctx });
+      }
+    }
+
+    // 2. 内置资源：项目配置（过滤敏感字段）
+    allResources.push({
+      resource: {
+        name: "spaceflow-config",
+        uri: "spaceflow://config",
+        title: "Spaceflow Configuration",
+        description: "当前项目的 Spaceflow 配置（已过滤敏感字段）",
+        mimeType: "application/json",
+        handler: async (_uri, ctx) => {
+          const config = readConfigSync(ctx.cwd);
+          return JSON.stringify(this.sanitizeConfig(config), null, 2);
+        },
+      },
+      ctx,
+    });
+
+    // 3. 内置资源：扩展列表
+    allResources.push({
+      resource: {
+        name: "spaceflow-extensions",
+        uri: "spaceflow://extensions",
+        title: "Installed Extensions",
+        description: "当前项目已安装的 Spaceflow 扩展及其工具/资源",
+        mimeType: "application/json",
+        handler: async () => {
+          const extensions = this.extensionLoader.getExtensions();
+          const summary = extensions.map((ext) => ({
+            name: ext.name,
+            version: ext.version,
+            description: ext.description,
+            commands: ext.commands.map((c) => c.name),
+            tools: (ext.tools || []).map((t) => ({ name: t.name, description: t.description })),
+            resources: (ext.resources || []).map((r) => ({
+              name: r.name,
+              uri: r.uri,
+              description: r.description,
+            })),
+          }));
+          return JSON.stringify(summary, null, 2);
+        },
+      },
+      ctx,
+    });
+
+    return allResources;
+  }
+
+  /**
+   * 过滤配置中的敏感字段
+   */
+  private sanitizeConfig(config: Record<string, any>): Record<string, any> {
+    const sensitiveKeys = ["token", "apiKey", "appSecret", "authToken", "apikey", "secret"];
+    const sanitize = (obj: any): any => {
+      if (obj === null || obj === undefined || typeof obj !== "object") return obj;
+      if (Array.isArray(obj)) return obj.map(sanitize);
+      const result: Record<string, any> = {};
+      for (const [key, value] of Object.entries(obj)) {
+        if (sensitiveKeys.some((sk) => key.toLowerCase().includes(sk.toLowerCase()))) {
+          result[key] = value ? "***" : "";
+        } else {
+          result[key] = sanitize(value);
+        }
+      }
+      return result;
+    };
+    return sanitize(config);
   }
 
   /**
@@ -86,6 +190,7 @@ export class McpService {
    */
   private async runServer(
     allTools: Array<{ tool: McpToolMetadata; handler: any; ctx: any }>,
+    allResources: CollectedResource[],
     verbose?: VerboseLevel,
   ): Promise<void> {
     const server = new McpServer({ name: "spaceflow", version: "1.0.0" });
@@ -126,6 +231,43 @@ export class McpService {
       );
     }
 
+    // 注册所有资源（使用 v2 API: server.registerResource）
+    for (const { resource, ctx } of allResources) {
+      server.registerResource(
+        resource.name,
+        resource.uri,
+        {
+          title: resource.title,
+          description: resource.description,
+          mimeType: resource.mimeType || "application/json",
+        },
+        async (uri) => {
+          try {
+            const text = await resource.handler(uri.href, ctx);
+            return {
+              contents: [
+                {
+                  uri: uri.href,
+                  mimeType: resource.mimeType || "application/json",
+                  text,
+                },
+              ],
+            };
+          } catch (error) {
+            return {
+              contents: [
+                {
+                  uri: uri.href,
+                  mimeType: "text/plain",
+                  text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+              ],
+            };
+          }
+        },
+      );
+    }
+
     // 启动 stdio 传输
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/src/extension-system/types.ts

@@ -136,6 +136,29 @@ export interface ServiceDefinition {
   factory: (ctx: SpaceflowContext) => unknown;
 }
 
+/**
+ * MCP 资源定义
+ */
+export interface McpResourceDefinition {
+  /** 资源名称（唯一标识符） */
+  name: string;
+  /** 资源 URI（固定 URI，如 "config://spaceflow"） */
+  uri: string;
+  /** 资源标题（人类可读） */
+  title?: string;
+  /** 资源描述 */
+  description?: string;
+  /** MIME 类型（默认 application/json） */
+  mimeType?: string;
+  /**
+   * 资源读取处理函数
+   * @param uri 请求的 URI
+   * @param ctx Spaceflow 上下文
+   * @returns 资源内容（字符串）
+   */
+  handler: (uri: string, ctx: SpaceflowContext) => Promise<string>;
+}
+
 /**
  * MCP 工具定义
  */
@@ -174,6 +197,8 @@ export interface ExtensionDefinition {
   commands: CommandDefinition[];
   /** MCP 工具列表 */
   tools?: McpToolDefinition[];
+  /** MCP 资源列表 */
+  resources?: McpResourceDefinition[];
   /** 服务定义列表 */
   services?: ServiceDefinition[];
   /**

package/src/locales/en/mcp.json

@@ -16,6 +16,7 @@
   "noToolsFound": "❌ No MCP tools found",
   "noToolsHint": "   Hint: Make sure you have installed MCP-enabled extensions that export mcpService or getMcpTools\n   If the working directory is incorrect, set the environment variable in your MCP config:\n   \"env\": { \"SPACEFLOW_CWD\": \"/path/to/your/project\" }",
   "toolsFound": "✅ Found {{count}} MCP tools",
+  "resourcesFound": "📦 Found {{count}} MCP resources",
   "ttyHint": "💡 MCP Server must be started by an MCP client (e.g. Cursor, Claude Desktop) via pipe.\n   Add the following config to your MCP client:\n\n   \"spaceflow\": {\n     \"command\": \"npx\",\n     \"args\": [\"@spaceflow/cli\", \"mcp\"],\n     \"env\": { \"SPACEFLOW_CWD\": \"/path/to/your/project\" }\n   }",
   "serverStarted": "🚀 MCP Server started with {{count}} tools"
 }

package/src/locales/zh-cn/mcp.json

@@ -16,6 +16,7 @@
   "noToolsFound": "❌ 没有找到任何 MCP 工具",
   "noToolsHint": "   提示: 确保已安装支持 MCP 的扩展，并导出 mcpService 或 getMcpTools\n   如果工作目录不正确，请在 MCP 配置中设置环境变量:\n   \"env\": { \"SPACEFLOW_CWD\": \"/path/to/your/project\" }",
   "toolsFound": "✅ 共发现 {{count}} 个 MCP 工具",
+  "resourcesFound": "📦 共发现 {{count}} 个 MCP 资源",
   "ttyHint": "💡 MCP Server 需要由 MCP 客户端（如 Cursor、Claude Desktop）通过管道启动。\n   请将以下配置添加到你的 MCP 客户端中：\n\n   \"spaceflow\": {\n     \"command\": \"npx\",\n     \"args\": [\"@spaceflow/cli\", \"mcp\"],\n     \"env\": { \"SPACEFLOW_CWD\": \"/path/to/your/project\" }\n   }",
   "serverStarted": "🚀 MCP Server 已启动，共 {{count}} 个工具"
 }

package/src/shared/git-provider/adapters/gitea.adapter.spec.ts

@@ -383,11 +383,11 @@ describe("GiteaAdapter", () => {
   });
 
   describe("listPullReviews", () => {
-    it("应请求正确的 URL", async () => {
+    it("应请求正确的 URL（带分页参数）", async () => {
       fetchSpy.mockResolvedValue(mockResponse([]));
       await adapter.listPullReviews("owner", "repo", 42);
       expect(fetchSpy).toHaveBeenCalledWith(
-        "https://gitea.example.com/api/v1/repos/owner/repo/pulls/42/reviews",
+        "https://gitea.example.com/api/v1/repos/owner/repo/pulls/42/reviews?page=1&limit=50",
         expect.anything(),
       );
     });

package/src/shared/git-provider/adapters/gitea.adapter.ts

@@ -438,7 +438,20 @@ export class GiteaAdapter implements GitProvider {
   }
 
   async listPullReviews(owner: string, repo: string, index: number): Promise<PullReview[]> {
-    return this.request<PullReview[]>("GET", `/repos/${owner}/${repo}/pulls/${index}/reviews`);
+    const allReviews: PullReview[] = [];
+    let page = 1;
+    const limit = 50;
+    while (true) {
+      const reviews = await this.request<PullReview[]>(
+        "GET",
+        `/repos/${owner}/${repo}/pulls/${index}/reviews?page=${page}&limit=${limit}`,
+      );
+      if (!reviews || reviews.length === 0) break;
+      allReviews.push(...reviews);
+      if (reviews.length < limit) break;
+      page++;
+    }
+    return allReviews;
   }
 
   async updatePullReview(