@spaceflow/core 0.10.0 → 0.11.0

package/package.json

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

package/src/cli-runtime/index.ts

@@ -1,3 +1,5 @@
+declare const __CORE_VERSION__: string;
+
 import { Command } from "commander";
 import type { ExtensionDefinition } from "@spaceflow/core";
 import { ServiceContainer, initializeContainer } from "./di";
@@ -16,7 +18,14 @@ export { internalExtensions } from "./internal-extensions";
  *
  * @param extensions 外部扩展定义列表（来自 .spaceflow/bin/index.js 的静态导入）
  */
-export async function exec(extensions: ExtensionDefinition[] = []): Promise<void> {
+export interface ExecOptions {
+  cliVersion?: string;
+}
+
+export async function exec(
+  extensions: ExtensionDefinition[] = [],
+  options: ExecOptions = {},
+): Promise<void> {
   // 1. 初始化 i18n（如果尚未初始化，由生成的 bin/index.js 提前调用）
   initCliI18n();
 
@@ -40,7 +49,14 @@ export async function exec(extensions: ExtensionDefinition[] = []): Promise<void
 
   // 6. 创建 CLI 程序
   const program = new Command();
-  program.name("spaceflow").description("Spaceflow CLI").version("1.0.0");
+  const cliVersion = options.cliVersion || "0.0.0";
+  const coreVersion = typeof __CORE_VERSION__ !== "undefined" ? __CORE_VERSION__ : "0.0.0";
+  const versionOutput = `spaceflow/${cliVersion} core/${coreVersion}`;
+
+  program
+    .name("spaceflow")
+    .description("Spaceflow CLI")
+    .version(versionOutput, "-V, --version", "显示版本信息");
 
   // 定义全局 verbose 选项（支持计数：-v, -vv, -vvv）
   program.option(

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

@@ -21,6 +21,11 @@ export class McpService {
       return;
     }
     if (shouldLog(verbose, 1)) {
+      const cwd = process.env.SPACEFLOW_CWD || process.cwd();
+      console.error(t("mcp:cwdInfo", { cwd }));
+      if (!process.env.SPACEFLOW_CWD) {
+        console.error(t("mcp:cwdEnvHint"));
+      }
       console.error(t("mcp:scanning"));
     }
 

package/src/locales/en/mcp.json

@@ -5,6 +5,8 @@
   "inspectorDebugCmd": "   Debug command: pnpm space mcp",
   "inspectorFailed": "❌ Failed to start MCP Inspector: {{error}}",
   "extensionDescription": "Start MCP Server with all installed extension tools",
+  "cwdInfo": "📂 Working directory: {{cwd}}",
+  "cwdEnvHint": "   💡 Set SPACEFLOW_CWD environment variable to specify workspace path",
   "scanning": "🔍 Scanning installed extensions...",
   "foundExtensions": "   Found {{count}} extensions",
   "checkingExport": "     Checking {{key}}: __mcp_server__={{hasMcpServer}}",
@@ -12,8 +14,8 @@
   "containerFailed": "     ⚠️ Failed to get {{key}} from container: {{error}}",
   "loadToolsFailed": "   ⚠️ {{name}}: Failed to load MCP tools",
   "noToolsFound": "❌ No MCP tools found",
-  "noToolsHint": "   Hint: Make sure you have installed MCP-enabled extensions that export mcpService or getMcpTools",
+  "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",
-  "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\": \"pnpm\",\n     \"args\": [\"space\", \"mcp\"]\n   }",
+  "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

@@ -5,6 +5,8 @@
   "inspectorDebugCmd": "   调试命令: pnpm space mcp",
   "inspectorFailed": "❌ 启动 MCP Inspector 失败: {{error}}",
   "extensionDescription": "启动 MCP Server，提供所有已安装扩展的 MCP 工具",
+  "cwdInfo": "📂 工作目录: {{cwd}}",
+  "cwdEnvHint": "   💡 可通过环境变量 SPACEFLOW_CWD 指定工作区路径",
   "scanning": "🔍 扫描已安装的扩展...",
   "foundExtensions": "   发现 {{count}} 个扩展",
   "checkingExport": "     检查 {{key}}: __mcp_server__={{hasMcpServer}}",
@@ -12,8 +14,8 @@
   "containerFailed": "     ⚠️ 从容器获取 {{key}} 失败: {{error}}",
   "loadToolsFailed": "   ⚠️ {{name}}: 加载 MCP 工具失败",
   "noToolsFound": "❌ 没有找到任何 MCP 工具",
-  "noToolsHint": "   提示: 确保已安装支持 MCP 的扩展，并导出 mcpService 或 getMcpTools",
+  "noToolsHint": "   提示: 确保已安装支持 MCP 的扩展，并导出 mcpService 或 getMcpTools\n   如果工作目录不正确，请在 MCP 配置中设置环境变量:\n   \"env\": { \"SPACEFLOW_CWD\": \"/path/to/your/project\" }",
   "toolsFound": "✅ 共发现 {{count}} 个 MCP 工具",
-  "ttyHint": "💡 MCP Server 需要由 MCP 客户端（如 Cursor、Claude Desktop）通过管道启动。\n   请将以下配置添加到你的 MCP 客户端中：\n\n   \"spaceflow\": {\n     \"command\": \"pnpm\",\n     \"args\": [\"space\", \"mcp\"]\n   }",
+  "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}} 个工具"
 }