@spaceflow/core 0.1.1

package/README.md

@@ -0,0 +1,105 @@
+# @spaceflow/core
+
+Spaceflow 核心能力库，提供共享模块、插件系统基础设施和平台适配层。
+
+## 安装
+
+```bash
+pnpm add @spaceflow/core
+```
+
+## 共享模块
+
+核心库导出以下共享模块，供插件开发使用：
+
+| 模块              | 导入路径                          | 说明                                      |
+| ----------------- | --------------------------------- | ----------------------------------------- |
+| `git-provider`    | `@spaceflow/core`                 | Git 平台适配器（GitHub / Gitea / GitLab） |
+| `git-sdk`         | `@spaceflow/core`                 | Git 命令操作封装                          |
+| `llm-proxy`       | `@spaceflow/core/llm-proxy`       | 多 LLM 适配器（OpenAI、Claude、Gemini）   |
+| `llm-jsonput`     | `@spaceflow/core/llm-jsonput`     | LLM JSON 结构化输出                       |
+| `feishu-sdk`      | `@spaceflow/core`                 | 飞书 API 操作封装                         |
+| `storage`         | `@spaceflow/core`                 | 通用存储服务                              |
+| `logger`          | `@spaceflow/core`                 | 日志系统（TUI / Plain 双模式）            |
+| `parallel`        | `@spaceflow/core/parallel`        | 并行执行工具                              |
+| `verbose`         | `@spaceflow/core/verbose`         | 日志级别控制                              |
+| `editor-config`   | `@spaceflow/core/editor-config`   | 编辑器配置管理                            |
+| `source-utils`    | `@spaceflow/core/source-utils`    | 源码工具                                  |
+| `package-manager` | `@spaceflow/core/package-manager` | 包管理器抽象                              |
+| `rspack-config`   | `@spaceflow/core/rspack-config`   | Rspack 构建配置                           |
+
+## 作为库使用
+
+```typescript
+import {
+  GitProviderService,
+  GitSdkService,
+  LlmProxyService,
+  FeishuSdkService,
+  StorageService,
+  Logger,
+
+  // NestJS 重导出
+  Command,
+  CommandRunner,
+  Module,
+  Injectable,
+} from "@spaceflow/core";
+```
+
+## 目录结构
+
+```text
+core/
+├── src/
+│   ├── config/              # 配置管理（Zod Schema）
+│   ├── extension-system/    # 插件系统核心
+│   ├── locales/             # 国际化资源（i18next）
+│   ├── shared/              # 共享模块
+│   │   ├── git-provider/    # Git 平台适配器
+│   │   │   └── adapters/    # GitHub / Gitea / GitLab 实现
+│   │   ├── git-sdk/         # Git 命令封装
+│   │   ├── llm-proxy/       # LLM 统一代理
+│   │   ├── llm-jsonput/     # JSON 结构化输出
+│   │   ├── feishu-sdk/      # 飞书 SDK
+│   │   ├── logger/          # 日志系统（TUI/Plain）
+│   │   ├── parallel/        # 并行执行工具
+│   │   ├── storage/         # 通用存储服务
+│   │   ├── editor-config/   # 编辑器配置管理
+│   │   ├── verbose/         # 日志级别控制
+│   │   ├── source-utils/    # 源码工具
+│   │   ├── package-manager/ # 包管理器抽象
+│   │   └── rspack-config/   # Rspack 构建配置
+│   ├── app.module.ts        # NestJS 根模块
+│   └── index.ts             # 库导出入口
+└── test/                    # E2E 测试
+```
+
+## 开发
+
+```bash
+# 构建
+pnpm run build
+
+# 测试
+pnpm run test
+
+# 代码检查
+pnpm run lint
+
+# 代码格式化
+pnpm run format
+```
+
+## 技术栈
+
+- **NestJS** — 依赖注入框架
+- **nest-commander** — CLI 命令框架
+- **rspack** — 构建工具
+- **i18next** — 国际化
+- **Zod** — 配置校验
+- **TypeScript** — 类型系统
+
+## 许可证
+
+[MIT](../LICENSE)

package/nest-cli.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "webpack": true,
+    "webpackConfigPath": "webpack.config.cjs"
+  }
+}

package/package.json

@@ -0,0 +1,128 @@
+{
+  "name": "@spaceflow/core",
+  "version": "0.1.1",
+  "description": "Spaceflow 核心能力库",
+  "license": "MIT",
+  "author": "Lydanne",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lydanne/spaceflow.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./verbose": {
+      "types": "./src/shared/verbose/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./editor-config": {
+      "types": "./src/shared/editor-config/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./source-utils": {
+      "types": "./src/shared/source-utils/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./package-manager": {
+      "types": "./src/shared/package-manager/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./spaceflow-dir": {
+      "types": "./src/shared/spaceflow-dir/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./spaceflow.config": {
+      "types": "./src/config/spaceflow.config.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema-generator.service": {
+      "types": "./src/config/schema-generator.service.ts",
+      "import": "./dist/index.js"
+    },
+    "./rspack-config": {
+      "types": "./src/shared/rspack-config/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./llm-proxy": {
+      "types": "./src/shared/llm-proxy/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./llm-jsonput": {
+      "types": "./src/shared/llm-jsonput/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./parallel": {
+      "types": "./src/shared/parallel/index.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@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",
+    "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",
+    "release-it": "^19.2.2",
+    "release-it-gitea": "^1.8.0",
+    "rxjs": "^7.8.1",
+    "zod": "^4.3.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",
+    "@types/node": "^22.15.0",
+    "@types/supertest": "^6.0.2",
+    "source-map-support": "^0.5.21",
+    "supertest": "^7.0.0",
+    "ts-loader": "^9.5.2",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.20.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "unplugin-swc": "^1.5.9",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "rspack build -c rspack.config.mjs",
+    "format": "oxfmt src test --write",
+    "lint": "oxlint src test",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:cov": "vitest run --coverage"
+  }
+}

package/rspack.config.mjs

@@ -0,0 +1,62 @@
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+export default {
+  optimization: {
+    minimize: false,
+  },
+  entry: {
+    index: "./src/index.ts",
+  },
+  plugins: [],
+  target: "node",
+  mode: process.env.NODE_ENV === "production" ? "production" : "development",
+  output: {
+    filename: "[name].js",
+    path: resolve(__dirname, "dist"),
+    library: { type: "module" },
+    chunkFormat: "module",
+    clean: true,
+  },
+  experiments: {
+    outputModule: true,
+  },
+  externalsType: "module-import",
+  externals: [
+    { micromatch: "node-commonjs micromatch" },
+    /^(?!src\/)[^./]/, // node_modules 包（排除 src/ 别名）
+  ],
+  resolve: {
+    extensions: [".ts", ".js"],
+    extensionAlias: {
+      ".js": [".ts", ".js"],
+    },
+    tsConfig: {
+      configFile: resolve(__dirname, "tsconfig.json"),
+    },
+  },
+  module: {
+    rules: [
+      {
+        test: /\.ts$/,
+        exclude: /node_modules/,
+        loader: "builtin:swc-loader",
+        options: {
+          jsc: {
+            parser: {
+              syntax: "typescript",
+              decorators: true,
+            },
+            transform: {
+              legacyDecorator: true,
+              decoratorMetadata: true,
+            },
+            target: "es2022",
+          },
+        },
+      },
+    ],
+  },
+};

package/src/__mocks__/@opencode-ai/sdk.js

@@ -0,0 +1,9 @@
+module.exports = {
+  createOpencodeClient: jest.fn().mockReturnValue({
+    session: {
+      create: jest.fn(),
+      prompt: jest.fn(),
+      delete: jest.fn(),
+    },
+  }),
+};

package/src/__mocks__/c12.ts

@@ -0,0 +1,3 @@
+export const loadConfig = jest.fn().mockResolvedValue({
+  config: {},
+});

package/src/app.module.ts

@@ -0,0 +1,18 @@
+import { Module } from "@nestjs/common";
+import { StorageModule } from "./shared/storage/storage.module";
+import { OutputModule } from "./shared/output";
+import { ConfigModule } from "@nestjs/config";
+import { configLoaders, getEnvFilePaths } from "./config";
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+      load: configLoaders,
+      envFilePath: getEnvFilePaths(),
+    }),
+    StorageModule.forFeature(),
+    OutputModule,
+  ],
+})
+export class AppModule {}

package/src/config/ci.config.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { createEnvConfigLoader } from "./config-loader";
+
+/** CI 配置 Schema */
+const schemaFactory = () =>
+  z.object({
+    /** 仓库名称 (owner/repo 格式) */
+    repository: z
+      .string()
+      .default(process.env.GITHUB_REPOSITORY || "")
+      .describe("仓库名称 (owner/repo 格式)"),
+    /** 当前分支名称 */
+    refName: z
+      .string()
+      .default(process.env.GITHUB_REF_NAME || "")
+      .describe("当前分支名称"),
+    actor: z
+      .string()
+      .default(process.env.GITHUB_ACTOR || "")
+      .describe("当前操作者"),
+  });
+
+/** CI 配置类型 */
+export type CiConfig = z.infer<ReturnType<typeof schemaFactory>>;
+
+export const ciConfig = createEnvConfigLoader({
+  configKey: "ci",
+  schemaFactory,
+});

package/src/config/config-loader.ts

@@ -0,0 +1,101 @@
+import { registerAs } from "@nestjs/config";
+import { z } from "zod";
+import { readConfigSync } from "./spaceflow.config";
+import { registerPluginSchema } from "./schema-generator.service";
+
+/**
+ * 配置加载器选项
+ */
+export interface ConfigLoaderOptions<T extends z.ZodObject<z.ZodRawShape>> {
+  /** 配置 key（用于 registerAs 和从 spaceflow.json 读取） */
+  configKey: string;
+  /** zod schema（应包含 .default() 设置默认值） */
+  schemaFactory: () => T;
+  /** 配置描述（用于生成 JSON Schema） */
+  description?: string;
+}
+
+/**
+ * 创建配置加载器
+ * 统一使用 zod 进行配置验证和默认值填充
+ *
+ * @example
+ * ```ts
+ * const GitProviderConfigSchema = z.object({
+ *   serverUrl: z.string().default(process.env.GITHUB_SERVER_URL || ""),
+ *   token: z.string().default(process.env.GITHUB_TOKEN || ""),
+ * });
+ *
+ * export type GitProviderConfig = z.infer<typeof GitProviderConfigSchema>;
+ *
+ * export const gitProviderConfig = createConfigLoader({
+ *   configKey: "gitProvider",
+ *   schemaFactory: GitProviderConfigSchema,
+ *   description: "Git Provider 服务配置",
+ * });
+ * ```
+ */
+export function createConfigLoader<T extends z.ZodObject<z.ZodRawShape>>(
+  options: ConfigLoaderOptions<T>,
+) {
+  const { configKey, schemaFactory, description } = options;
+
+  // 创建配置加载器
+  return registerAs(configKey, (): z.infer<T> => {
+    const schema = schemaFactory();
+    // 注册 schema 用于 JSON Schema 生成
+    registerPluginSchema({
+      configKey,
+      schemaFactory: () => schema,
+      description,
+    });
+
+    const fileConfig = readConfigSync();
+    const rawConfig = fileConfig[configKey] ?? {};
+
+    // 使用 zod 验证并填充默认值
+    const result = schema.safeParse(rawConfig);
+
+    if (!result.success) {
+      const errors = result.error.issues
+        .map((e) => `  - ${e.path.join(".")}: ${e.message}`)
+        .join("\n");
+      throw new Error(`配置 "${configKey}" 验证失败:\n${errors}`);
+    }
+
+    return result.data;
+  });
+}
+
+/**
+ * 创建简单配置加载器（仅从环境变量读取，不读取配置文件）
+ * 适用于 CI 等纯环境变量配置
+ */
+export function createEnvConfigLoader<T extends z.ZodObject<z.ZodRawShape>>(
+  options: Omit<ConfigLoaderOptions<T>, "description"> & { description?: string },
+) {
+  const { configKey, schemaFactory, description } = options;
+
+  return registerAs(configKey, (): z.infer<T> => {
+    const schema = schemaFactory();
+    // 注册 schema（如果有描述）
+    if (description) {
+      registerPluginSchema({
+        configKey,
+        schemaFactory: () => schema,
+        description,
+      });
+    }
+    // 直接使用空对象，让 schema 的 default 值生效
+    const result = schema.safeParse({});
+
+    if (!result.success) {
+      const errors = result.error.issues
+        .map((e) => `  - ${e.path.join(".")}: ${e.message}`)
+        .join("\n");
+      throw new Error(`配置 "${configKey}" 验证失败:\n${errors}`);
+    }
+
+    return result.data;
+  });
+}

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

@@ -0,0 +1,16 @@
+import { Global, Module } from "@nestjs/common";
+import { ConfigReaderService } from "./config-reader.service";
+import { SchemaGeneratorService } from "./schema-generator.service";
+
+/**
+ * 配置读取模块
+ * 提供插件配置读取服务和 Schema 生成服务
+ *
+ * 插件的 defaultConfig 通过 getMetadata() 返回，在插件加载时自动注册
+ */
+@Global()
+@Module({
+  providers: [ConfigReaderService, SchemaGeneratorService],
+  exports: [ConfigReaderService, SchemaGeneratorService],
+})
+export class ConfigReaderModule {}

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

@@ -0,0 +1,133 @@
+import { Injectable } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import type { SpaceflowConfig } from "./spaceflow.config";
+
+/**
+ * 系统配置（不包含插件配置）
+ */
+export interface SystemConfig {
+  /** 已安装的技能包注册表 */
+  dependencies?: Record<string, string>;
+  /** 支持的编辑器列表 */
+  support?: string[];
+}
+
+/**
+ * 插件配置注册信息
+ */
+export interface PluginConfigRegistry {
+  /** 插件名称 */
+  name: string;
+  /** 配置 key */
+  configKey?: string;
+  /** 依赖的其他插件配置 */
+  configDependencies?: string[];
+  /** 配置 schema 工厂函数 */
+  configSchema?: () => unknown;
+}
+
+/** 全局插件配置注册表（使用 global 确保跨模块共享） */
+const PLUGIN_REGISTRY_KEY = Symbol.for("spaceflow.pluginRegistry");
+const globalAny = global as any;
+if (!globalAny[PLUGIN_REGISTRY_KEY]) {
+  globalAny[PLUGIN_REGISTRY_KEY] = new Map<string, PluginConfigRegistry>();
+}
+const pluginRegistry: Map<string, PluginConfigRegistry> = globalAny[PLUGIN_REGISTRY_KEY];
+
+/**
+ * 注册插件配置（由插件加载器调用）
+ */
+export function registerPluginConfig(registry: PluginConfigRegistry): void {
+  if (registry.configKey) {
+    pluginRegistry.set(registry.configKey, registry);
+  }
+}
+
+/**
+ * 获取已注册的插件配置
+ */
+export function getRegisteredPluginConfig(configKey: string): PluginConfigRegistry | undefined {
+  return pluginRegistry.get(configKey);
+}
+
+/**
+ * 配置读取服务
+ * 提供三种配置读取方式：
+ * 1. getPluginConfig - 读取指定插件的配置
+ * 2. getOtherPluginConfig - 读取其他插件的配置（需要在 metadata 中声明依赖）
+ * 3. getSystemConfig - 读取系统配置
+ */
+@Injectable()
+export class ConfigReaderService {
+  constructor(protected readonly configService: ConfigService) {}
+
+  /**
+   * 读取插件的配置
+   * 使用 schema 验证并合并默认值
+   * @param configKey 插件的配置 key
+   * @returns 验证后的插件配置
+   */
+  getPluginConfig<T>(configKey: string): T {
+    const rawConfig = this.configService.get<Record<string, unknown>>("spaceflow");
+    const userConfig = rawConfig?.[configKey] ?? {};
+
+    // 从注册表获取 schema 工厂函数
+    const registry = pluginRegistry.get(configKey);
+    const schemaFactory = registry?.configSchema;
+
+    if (!schemaFactory || typeof schemaFactory !== "function") {
+      return userConfig as T;
+    }
+
+    // 调用工厂函数获取 schema
+    const schema = schemaFactory();
+    if (!schema || typeof (schema as any).parse !== "function") {
+      return userConfig as T;
+    }
+
+    // 使用 schema.parse() 验证并填充默认值
+    try {
+      return (schema as any).parse(userConfig) as T;
+    } catch (error) {
+      console.warn(`⚠️ 配置 "${configKey}" 验证失败:`, error);
+      return userConfig as T;
+    }
+  }
+
+  /**
+   * 读取其他插件的配置
+   * 必须在插件的 metadata.configDependencies 中声明依赖
+   * @param fromConfigKey 当前插件的配置 key
+   * @param targetConfigKey 目标插件的配置 key
+   * @returns 合并后的插件配置
+   */
+  getOtherPluginConfig<T>(fromConfigKey: string, targetConfigKey: string): T {
+    const fromRegistry = pluginRegistry.get(fromConfigKey);
+    if (!fromRegistry) {
+      throw new Error(`插件 "${fromConfigKey}" 未注册`);
+    }
+
+    // 检查是否已声明依赖
+    const dependencies = fromRegistry.configDependencies ?? [];
+    if (!dependencies.includes(targetConfigKey)) {
+      throw new Error(
+        `插件 "${fromRegistry.name}" 未声明对 "${targetConfigKey}" 配置的依赖。` +
+          `请在插件 metadata 的 configDependencies 中添加 "${targetConfigKey}"`,
+      );
+    }
+
+    return this.getPluginConfig<T>(targetConfigKey);
+  }
+
+  /**
+   * 读取系统配置（不包含插件配置）
+   * @returns 系统配置
+   */
+  getSystemConfig(): SystemConfig {
+    const rawConfig = this.configService.get<SpaceflowConfig>("spaceflow");
+    return {
+      dependencies: rawConfig?.dependencies,
+      support: rawConfig?.support,
+    };
+  }
+}

package/src/config/feishu.config.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { createConfigLoader } from "./config-loader";
+
+const schemaFactory = () =>
+  z.object({
+    /** 飞书应用 ID */
+    appId: z
+      .string()
+      .default(process.env.FEISHU_APP_ID || "")
+      .describe("飞书应用 ID"),
+    /** 飞书应用密钥 */
+    appSecret: z
+      .string()
+      .default(process.env.FEISHU_APP_SECRET || "")
+      .describe("飞书应用密钥"),
+    /** 应用类型：自建应用或商店应用 */
+    appType: z
+      .enum(["self_build", "store"])
+      .default((process.env.FEISHU_APP_TYPE as "self_build" | "store") || "self_build")
+      .describe("应用类型"),
+    /** 域名：飞书或 Lark */
+    domain: z
+      .enum(["feishu", "lark"])
+      .default((process.env.FEISHU_DOMAIN as "feishu" | "lark") || "feishu")
+      .describe("域名"),
+  });
+
+/** 飞书配置类型 */
+export type FeishuConfig = z.infer<ReturnType<typeof schemaFactory>>;
+
+export const feishuConfig = createConfigLoader({
+  configKey: "feishu",
+  schemaFactory,
+  description: "飞书 SDK 配置",
+});

package/src/config/git-provider.config.ts

@@ -0,0 +1,29 @@
+import { z } from "zod";
+import { createConfigLoader } from "./config-loader";
+import { detectProvider } from "../shared/git-provider/detect-provider";
+
+/** 从环境自动检测的默认值 */
+const detected = detectProvider();
+
+/** Git Provider 配置 Schema */
+const schemaFactory = () =>
+  z.object({
+    /** Git Provider 类型（自动检测或手动指定） */
+    provider: z
+      .enum(["gitea", "github", "gitlab"])
+      .default(detected.provider)
+      .describe("Git Provider 类型 (github | gitea | gitlab)，未指定时自动检测"),
+    /** Git Provider 服务器 URL */
+    serverUrl: z.string().default(detected.serverUrl).describe("Git Provider 服务器 URL"),
+    /** Git Provider API Token */
+    token: z.string().default(detected.token).describe("Git Provider API Token"),
+  });
+
+/** Git Provider 配置类型 */
+export type GitProviderConfig = z.infer<ReturnType<typeof schemaFactory>>;
+
+export const gitProviderConfig = createConfigLoader({
+  configKey: "gitProvider",
+  schemaFactory,
+  description: "Git Provider 服务配置",
+});