@spaceflow/core 0.1.3 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spaceflow/core",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "Spaceflow 核心能力库",
   "license": "MIT",
   "author": "Lydanne",
@@ -75,25 +75,17 @@
     "@anthropic-ai/claude-agent-sdk": "^0.2.7",
     "@larksuiteoapi/node-sdk": "^1.55.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@nestjs/common": "^11.0.1",
-    "@nestjs/config": "^4.0.2",
-    "@nestjs/core": "^11.0.1",
-    "@nestjs/event-emitter": "^3.0.1",
-    "@nestjs/platform-express": "^11.0.1",
-    "@nestjs/swagger": "^11.2.6",
     "@opencode-ai/sdk": "^1.1.23",
     "@release-it/conventional-changelog": "^10.0.4",
     "@rspack/cli": "^1.7.4",
     "@rspack/core": "^1.7.4",
     "chalk": "^5.6.2",
-    "class-transformer": "^0.5.1",
-    "class-validator": "^0.14.3",
+    "dotenv": "^16.4.5",
     "i18next": "^25.8.4",
     "json-stringify-pretty-compact": "^4.0.0",
     "jsonrepair": "^3.13.1",
     "log-update": "^7.1.0",
     "micromatch": "^4.0.8",
-    "nest-commander": "^3.20.1",
     "openai": "^6.1.0",
     "ora": "^9.3.0",
     "reflect-metadata": "^0.2.2",
@@ -104,9 +96,6 @@
     "zod-to-json-schema": "^3.25.1"
   },
   "devDependencies": {
-    "@nestjs/cli": "^11.0.0",
-    "@nestjs/schematics": "^11.0.0",
-    "@nestjs/testing": "^11.0.1",
     "@swc/core": "1.15.3",
     "@types/express": "^5.0.0",
     "@types/micromatch": "^4.0.10",

package/src/config/config-loader.ts

@@ -1,4 +1,3 @@
-import { registerAs } from "@nestjs/config";
 import { z } from "zod";
 import { readConfigSync } from "./spaceflow.config";
 import { registerPluginSchema } from "./schema-generator.service";
@@ -7,7 +6,7 @@ import { registerPluginSchema } from "./schema-generator.service";
  * 配置加载器选项
  */
 export interface ConfigLoaderOptions<T extends z.ZodObject<z.ZodRawShape>> {
-  /** 配置 key（用于 registerAs 和从 spaceflow.json 读取） */
+  /** 配置 key（用于从 spaceflow.json 读取） */
   configKey: string;
   /** zod schema（应包含 .default() 设置默认值） */
   schemaFactory: () => T;
@@ -41,7 +40,7 @@ export function createConfigLoader<T extends z.ZodObject<z.ZodRawShape>>(
   const { configKey, schemaFactory, description } = options;
 
   // 创建配置加载器
-  return registerAs(configKey, (): z.infer<T> => {
+  return (): z.infer<T> => {
     const schema = schemaFactory();
     // 注册 schema 用于 JSON Schema 生成
     registerPluginSchema({
@@ -64,7 +63,7 @@ export function createConfigLoader<T extends z.ZodObject<z.ZodRawShape>>(
     }
 
     return result.data;
-  });
+  };
 }
 
 /**
@@ -76,7 +75,7 @@ export function createEnvConfigLoader<T extends z.ZodObject<z.ZodRawShape>>(
 ) {
   const { configKey, schemaFactory, description } = options;
 
-  return registerAs(configKey, (): z.infer<T> => {
+  return (): z.infer<T> => {
     const schema = schemaFactory();
     // 注册 schema（如果有描述）
     if (description) {
@@ -97,5 +96,5 @@ export function createEnvConfigLoader<T extends z.ZodObject<z.ZodRawShape>>(
     }
 
     return result.data;
-  });
+  };
 }

package/src/config/config-reader.service.ts

@@ -1,7 +1,3 @@
-import { Injectable } from "@nestjs/common";
-import { ConfigService } from "@nestjs/config";
-import type { SpaceflowConfig } from "./spaceflow.config";
-
 /**
  * 系统配置（不包含插件配置）
  */
@@ -57,9 +53,8 @@ export function getRegisteredPluginConfig(configKey: string): PluginConfigRegist
  * 2. getOtherPluginConfig - 读取其他插件的配置（需要在 metadata 中声明依赖）
  * 3. getSystemConfig - 读取系统配置
  */
-@Injectable()
 export class ConfigReaderService {
-  constructor(protected readonly configService: ConfigService) {}
+  constructor() {}
 
   /**
    * 读取插件的配置
@@ -68,8 +63,8 @@ export class ConfigReaderService {
    * @returns 验证后的插件配置
    */
   getPluginConfig<T>(configKey: string): T {
-    const rawConfig = this.configService.get<Record<string, unknown>>("spaceflow");
-    const userConfig = rawConfig?.[configKey] ?? {};
+    const rawConfig = (global as any).spaceflowConfig || {};
+    const userConfig = rawConfig[configKey] ?? {};
 
     // 从注册表获取 schema 工厂函数
     const registry = pluginRegistry.get(configKey);
@@ -124,10 +119,10 @@ export class ConfigReaderService {
    * @returns 系统配置
    */
   getSystemConfig(): SystemConfig {
-    const rawConfig = this.configService.get<SpaceflowConfig>("spaceflow");
+    const rawConfig = (global as any).spaceflowConfig || {};
     return {
-      dependencies: rawConfig?.dependencies,
-      support: rawConfig?.support,
+      dependencies: rawConfig.dependencies,
+      support: rawConfig.support,
     };
   }
 }

package/src/config/config-reader.ts

@@ -0,0 +1,75 @@
+import type { ZodSchema } from "zod";
+import { readConfigSync } from "./spaceflow.config";
+import type { IConfigReader } from "../extension-system/types";
+
+/**
+ * 配置读取器
+ * 不依赖 NestJS，直接读取配置文件
+ */
+export class ConfigReader implements IConfigReader {
+  private config: Record<string, unknown>;
+  private schemas = new Map<string, ZodSchema>();
+
+  constructor(cwd?: string) {
+    this.config = readConfigSync(cwd) as Record<string, unknown>;
+  }
+
+  /**
+   * 获取配置值
+   * @param key 配置路径（支持点分隔，如 "gitProvider.token"）
+   */
+  get<T>(key: string): T | undefined {
+    const parts = key.split(".");
+    let current: unknown = this.config;
+    for (const part of parts) {
+      if (current === null || current === undefined) {
+        return undefined;
+      }
+      current = (current as Record<string, unknown>)[part];
+    }
+    return current as T | undefined;
+  }
+
+  /**
+   * 获取插件配置
+   * 使用已注册的 schema 验证并填充默认值
+   * @param key 插件配置 key
+   */
+  getPluginConfig<T>(key: string): T | undefined {
+    const rawConfig = this.config[key] ?? {};
+    const schema = this.schemas.get(key);
+    if (!schema) {
+      return rawConfig as T;
+    }
+    try {
+      return schema.parse(rawConfig) as T;
+    } catch (error) {
+      console.warn(`⚠️ 配置 "${key}" 验证失败:`, error);
+      return rawConfig as T;
+    }
+  }
+
+  /**
+   * 注册配置 schema
+   * @param key 配置 key
+   * @param schema Zod schema
+   */
+  registerSchema(key: string, schema: ZodSchema): void {
+    this.schemas.set(key, schema);
+  }
+
+  /**
+   * 重新加载配置
+   * @param cwd 工作目录
+   */
+  reload(cwd?: string): void {
+    this.config = readConfigSync(cwd) as Record<string, unknown>;
+  }
+
+  /**
+   * 获取原始配置对象
+   */
+  getRawConfig(): Record<string, unknown> {
+    return this.config;
+  }
+}

package/src/config/index.ts

@@ -5,10 +5,13 @@ export * from "./feishu.config";
 export * from "./storage.config";
 export * from "./spaceflow.config";
 export * from "./config-reader.service";
-export * from "./config-reader.module";
 export * from "./schema-generator.service";
 export * from "./config-loader";
 
+// 新版配置系统（不依赖 NestJS）
+export { ConfigReader } from "./config-reader";
+export { loadEnvFiles } from "./load-env";
+
 import { gitProviderConfig } from "./git-provider.config";
 import { ciConfig } from "./ci.config";
 import { llmConfig } from "./llm.config";

package/src/config/load-env.ts

@@ -0,0 +1,15 @@
+import { config } from "dotenv";
+import { existsSync } from "fs";
+
+/**
+ * 加载 .env 文件
+ * 按优先级从高到低加载，先加载的变量不会被后加载的覆盖
+ * @param paths .env 文件路径列表（按优先级从高到低排列）
+ */
+export function loadEnvFiles(paths: string[]): void {
+  for (const envPath of paths) {
+    if (existsSync(envPath)) {
+      config({ path: envPath, override: false });
+    }
+  }
+}

package/src/config/schema-generator.service.ts

@@ -1,4 +1,3 @@
-import { Injectable } from "@nestjs/common";
 import { z } from "zod";
 import * as fs from "fs";
 import * as path from "path";
@@ -34,7 +33,6 @@ export function getRegisteredSchemas(): Map<string, SchemaRegistry> {
  * Schema 生成服务
  * 用于生成 JSON Schema 文件
  */
-@Injectable()
 export class SchemaGeneratorService {
   /**
    * 生成完整的 spaceflow.json 的 JSON Schema

package/src/config/spaceflow.config.ts

@@ -1,4 +1,3 @@
-import { registerAs } from "@nestjs/config";
 import { readFileSync, existsSync, writeFileSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
@@ -246,25 +245,13 @@ export function removeDependency(name: string, cwd?: string): boolean {
   return true;
 }
 
-export const spaceflowConfig = registerAs("spaceflow", (): SpaceflowConfig => {
-  const fileConfig = readConfigSync();
-
-  // 使用 zod 验证核心配置
-  const result = SpaceflowCoreConfigSchema.safeParse(fileConfig);
-
-  if (!result.success) {
-    const errors = result.error.issues
-      .map((e) => `  - ${e.path.join(".")}: ${e.message}`)
-      .join("\n");
-    throw new Error(`Spaceflow 配置验证失败:\n${errors}`);
-  }
-
-  // 返回验证后的核心配置 + 其他插件配置
-  return {
-    ...fileConfig,
-    ...result.data,
-  } as SpaceflowConfig;
-});
+/**
+ * 获取 spaceflow 配置（兼容旧 API）
+ * @deprecated 请使用 loadSpaceflowConfig()
+ */
+export function spaceflowConfig(): SpaceflowConfig {
+  return loadSpaceflowConfig();
+}
 
 /**
  * 加载 spaceflow.json 配置（用于 CLI 启动时）

package/src/extension-system/define-extension.ts

@@ -0,0 +1,25 @@
+import type { ExtensionDefinition, McpServerDefinition } from "./types";
+
+/**
+ * 定义扩展
+ * 这是一个类型安全的工厂函数，用于创建扩展定义
+ * @param definition 扩展定义
+ * @returns 扩展定义（原样返回，仅用于类型推断）
+ */
+export function defineExtension(
+  definition: ExtensionDefinition,
+): ExtensionDefinition {
+  return definition;
+}
+
+/**
+ * 定义 MCP 服务器
+ * 这是一个类型安全的工厂函数，用于创建 MCP 服务器定义
+ * @param definition MCP 服务器定义
+ * @returns MCP 服务器定义（原样返回，仅用于类型推断）
+ */
+export function defineMcpServer(
+  definition: McpServerDefinition,
+): McpServerDefinition {
+  return definition;
+}

package/src/extension-system/extension.interface.ts

@@ -1,5 +1,3 @@
-import { Type, DynamicModule } from "@nestjs/common";
-
 /** .spaceflow 目录名 */
 export const SPACEFLOW_DIR = ".spaceflow";
 
@@ -26,67 +24,6 @@ export interface SpaceflowExtensionMetadata {
   description?: string;
 }
 
-/**
- * Extension 模块类型，支持静态模块或动态模块
- */
-export type ExtensionModuleType = Type<any> | DynamicModule;
-
-/**
- * Extension 接口
- */
-export interface SpaceflowExtension {
-  /** 获取 Extension 元数据 */
-  getMetadata(): SpaceflowExtensionMetadata;
-  /**
-   * 获取 NestJS Module
-   * 可以返回静态 Module 类或 DynamicModule
-   * 如果需要动态配置，推荐返回 DynamicModule
-   */
-  getModule(): ExtensionModuleType;
-}
-
-/**
- * Extension 类静态接口
- */
-export interface SpaceflowExtensionConstructor {
-  new (): SpaceflowExtension;
-}
-
-/**
- * Extension 入口导出格式
- */
-export type SpaceflowExtensionExport =
-  | SpaceflowExtensionConstructor
-  | {
-      default: SpaceflowExtensionConstructor;
-    };
-
-/**
- * 已加载的 Extension 信息
- */
-export interface LoadedExtension {
-  /** Extension 名称 */
-  name: string;
-  /** Extension 来源（npm 包名） */
-  source: string;
-  /** NestJS 模块（静态或动态） */
-  module: ExtensionModuleType;
-  /** 包的完整导出（用于 MCP 服务发现） */
-  exports?: Record<string, unknown>;
-  /** 提供的命令列表 */
-  commands: string[];
-  /** 配置 key */
-  configKey?: string;
-  /** 依赖的其他 Extension 配置 key 列表 */
-  configDependencies?: string[];
-  /** 配置 schema 工厂函数 */
-  configSchema?: () => unknown;
-  /** Extension 版本 */
-  version?: string;
-  /** Extension 描述 */
-  description?: string;
-}
-
 /**
  * .spaceflow/package.json 中的 dependencies
  */

package/src/extension-system/index.ts

@@ -1 +1,6 @@
+// 旧版接口（保留兼容，后续移除）
 export * from "./extension.interface";
+
+// 新版接口
+export * from "./types";
+export * from "./define-extension";

package/src/extension-system/types.ts

@@ -0,0 +1,201 @@
+import type { ZodSchema } from "zod";
+
+/**
+ * 命令选项定义
+ */
+export interface OptionDefinition {
+  /** 选项标志，如 "-d, --dry-run" */
+  flags: string;
+  /** 选项描述 */
+  description: string;
+  /** 默认值 */
+  default?: unknown;
+  /** 是否为计数选项（如 -vvv 表示 verbose 级别 3） */
+  isCount?: boolean;
+}
+
+/**
+ * Spaceflow 统一上下文接口
+ * 命令和 MCP 工具共用此上下文
+ */
+export interface SpaceflowContext {
+  /** 配置读取器 */
+  readonly config: IConfigReader;
+  /** 输出服务 */
+  readonly output: IOutputService;
+  /** 存储服务 */
+  readonly storage: IStorageService;
+  /**
+   * 获取服务实例
+   * @param key 服务标识符（字符串 key，非 class 引用）
+   */
+  getService<T = unknown>(key: string): T;
+  /**
+   * 检查服务是否存在
+   * @param key 服务标识符
+   */
+  hasService(key: string): boolean;
+  /**
+   * 注册服务实例
+   * @param key 服务标识符
+   * @param service 服务实例
+   */
+  registerService(key: string, service: unknown): void;
+}
+
+/**
+ * 配置读取器接口
+ */
+export interface IConfigReader {
+  /**
+   * 获取配置值
+   * @param key 配置路径
+   */
+  get<T>(key: string): T | undefined;
+  /**
+   * 获取插件配置
+   * @param key 插件配置 key
+   */
+  getPluginConfig<T>(key: string): T | undefined;
+  /**
+   * 注册配置 schema
+   * @param key 配置 key
+   * @param schema Zod schema
+   */
+  registerSchema(key: string, schema: ZodSchema): void;
+}
+
+/**
+ * 输出服务接口
+ */
+export interface IOutputService {
+  /** 输出信息 */
+  info(message: string): void;
+  /** 输出成功信息 */
+  success(message: string): void;
+  /** 输出警告 */
+  warn(message: string): void;
+  /** 输出错误 */
+  error(message: string): void;
+  /** 输出调试信息 */
+  debug(message: string): void;
+}
+
+/**
+ * 存储服务接口
+ */
+export interface IStorageService {
+  /** 获取存储值 */
+  get<T>(key: string): Promise<T | undefined>;
+  /** 设置存储值 */
+  set<T>(key: string, value: T, ttl?: number): Promise<void>;
+  /** 删除存储值 */
+  del(key: string): Promise<boolean>;
+}
+
+/**
+ * 命令定义
+ */
+export interface CommandDefinition {
+  /** 命令名称 */
+  name: string;
+  /** 命令描述 */
+  description: string;
+  /** 命令别名 */
+  aliases?: string[];
+  /** 位置参数，如 "<script>" 或 "[file]" */
+  arguments?: string;
+  /** 参数描述 */
+  argsDescription?: Record<string, string>;
+  /** 命令选项 */
+  options?: OptionDefinition[];
+  /** 子命令 */
+  subcommands?: CommandDefinition[];
+  /**
+   * 命令执行函数
+   * @param args 位置参数
+   * @param options 选项
+   * @param ctx Spaceflow 上下文
+   */
+  run: (args: string[], options: Record<string, unknown>, ctx: SpaceflowContext) => Promise<void>;
+}
+
+/**
+ * 服务定义
+ * 扩展通过此接口声明其提供的服务
+ */
+export interface ServiceDefinition {
+  /** 服务标识符（建议格式：extName.serviceName） */
+  key: string;
+  /**
+   * 服务工厂函数
+   * @param ctx Spaceflow 上下文，可从中获取依赖
+   */
+  factory: (ctx: SpaceflowContext) => unknown;
+}
+
+/**
+ * MCP 工具定义
+ */
+export interface McpToolDefinition {
+  /** 工具名称 */
+  name: string;
+  /** 工具描述 */
+  description: string;
+  /** 输入参数 schema（Zod） */
+  inputSchema?: ZodSchema;
+  /**
+   * 工具处理函数
+   * @param input 输入参数
+   * @param ctx Spaceflow 上下文
+   */
+  handler: (input: unknown, ctx: SpaceflowContext) => Promise<unknown>;
+}
+
+/**
+ * MCP 服务器定义
+ */
+export interface McpServerDefinition {
+  /** 服务器名称 */
+  name: string;
+  /** 服务器版本 */
+  version?: string;
+  /** 服务器描述 */
+  description?: string;
+  /** 工具列表 */
+  tools: McpToolDefinition[];
+}
+
+/**
+ * 扩展定义
+ */
+export interface ExtensionDefinition {
+  /** 扩展名称（建议使用 npm 包名） */
+  name: string;
+  /** 扩展版本 */
+  version?: string;
+  /** 扩展描述 */
+  description?: string;
+  /** 配置 key（对应 spaceflow.json 中的配置路径） */
+  configKey?: string;
+  /** 配置 schema 工厂函数 */
+  configSchema?: () => ZodSchema;
+  /** 依赖的其他扩展配置 key 列表 */
+  configDependencies?: string[];
+  /** 命令列表 */
+  commands: CommandDefinition[];
+  /** MCP 服务器定义 */
+  mcp?: McpServerDefinition;
+  /** 服务定义列表 */
+  services?: ServiceDefinition[];
+  /**
+   * 扩展初始化钩子
+   * 在所有服务注册完毕后调用
+   */
+  onInit?: (ctx: SpaceflowContext) => Promise<void>;
+  /**
+   * 扩展销毁钩子
+   * 在 CLI 退出前调用
+   */
+  onDestroy?: (ctx: SpaceflowContext) => Promise<void>;
+}

package/src/index.ts

@@ -48,7 +48,21 @@ export * from "./shared/spaceflow-dir";
 export * from "./shared/rspack-config";
 
 // MCP - Model Context Protocol 支持
-export * from "./shared/mcp";
+// 注意：McpServerDefinition 和 McpToolDefinition 已在 extension-system/types.ts 中定义
+// 这里只导出装饰器和工具函数，避免重复导出
+export {
+  MCP_SERVER_METADATA,
+  MCP_TOOL_METADATA,
+  type JsonSchema,
+  dtoToJsonSchema,
+  type McpToolMetadata,
+  McpServer,
+  McpTool,
+  isMcpServer,
+  getMcpServerMetadata,
+  getMcpTools,
+  runMcpServer,
+} from "./shared/mcp";
 
 // I18n - 国际化
 export * from "./shared/i18n";
@@ -59,22 +73,5 @@ export * from "./shared/logger";
 // ============ 配置相关 ============
 export * from "./config";
 
-// ============ NestJS 重导出 ============
-export { Command, CommandRunner, Option, SubCommand } from "nest-commander";
-export { Module, Injectable, Inject, Global } from "@nestjs/common";
-export { ConfigModule, ConfigService } from "@nestjs/config";
-
 // ============ Zod 重导出 ============
 export { z } from "zod";
-
-// ============ Swagger DTO 重导出 ============
-export { ApiProperty, ApiPropertyOptional } from "@nestjs/swagger";
-export {
-  IsString,
-  IsNumber,
-  IsBoolean,
-  IsOptional,
-  IsArray,
-  IsEnum,
-  IsNotEmpty,
-} from "class-validator";

package/src/shared/claude-setup/claude-setup.service.ts

@@ -1,15 +1,11 @@
-import { Injectable } from "@nestjs/common";
-import { ConfigService } from "@nestjs/config";
 import { readFile, writeFile, mkdir, copyFile, unlink } from "fs/promises";
 import { join } from "path";
 import { homedir } from "os";
-import { LlmConfig } from "../../config";
-
+import type { LlmProxyConfig } from "../llm-proxy/interfaces";
 import { shouldLog, type VerboseLevel } from "../verbose";
 
-@Injectable()
 export class ClaudeSetupService {
-  constructor(protected readonly configService: ConfigService) {}
+  constructor(protected readonly llmConfig?: LlmProxyConfig) {}
 
   private getPaths() {
     const claudeDir = join(homedir(), ".claude");
@@ -69,8 +65,7 @@ export class ClaudeSetupService {
   async configure(verbose?: VerboseLevel): Promise<void> {
     const { claudeDir, settingsPath, claudeJsonPath } = this.getPaths();
 
-    const llmConf = this.configService.get<LlmConfig>("llm");
-    const claudeCode = llmConf?.claudeCode;
+    const claudeCode = this.llmConfig?.claudeCode;
 
     if (!claudeCode) {
       if (shouldLog(verbose, 1)) {

package/src/shared/claude-setup/index.ts

@@ -1,2 +1 @@
 export * from "./claude-setup.service";
-export * from "./claude-setup.module";