@longzai-intelligence-pipeline/config 0.0.1

package/README.md

@@ -0,0 +1,44 @@
+# @longzai-intelligence-pipeline/config
+
+管道配置包：`lzi-pipeline.config.ts` 的一切——结构 schema、加载器、骨架生成。
+
+## 定位
+
+longzai-intelligence-pipeline 三包之一（config / core / cli）：本包持有配置结构真源；core 依赖本包（并 re-export）；apps/cli 的 config 命令组消费本包。用户仓配置文件可从本包 import 工厂获得类型推导。
+
+## 用法
+
+```ts
+// lzi-pipeline.config.ts（推荐：类型推导）
+import { definePipelineConfig } from '@longzai-intelligence-pipeline/config';
+
+export default definePipelineConfig({
+  version: 1,
+  library: { root: '../my-library-repo' }, // 必填：用户自建独立 git 仓路径（编排层零 git）
+  pipelines: [
+    {
+      id: 'demo',
+      sources: [{ id: 'mock-1', plugin: 'builtin:mock', config: { /* 插件 configSchema 二次校验 */ } }],
+      processors: [{ uses: 'builtin:markdown' }],
+      outputs: [{ collection: 'daily' }],
+    },
+  ],
+});
+```
+
+零依赖形态：`config init` 生成的骨架为**零 import 裸对象**（任何目录可加载，运行时由 zod 校验兜底）。
+
+## API 面
+
+| 导出 | 说明 |
+| --- | --- |
+| `PipelineConfigSchema` / 相关类型 | 配置结构（library.root 必填；**无 schedule 字段**——本阶段不考虑调度，reviews/005） |
+| `definePipelineConfig()` | 配置工厂（identity + 类型收口） |
+| `discoverConfigPath(explicit?)` | 配置发现：显式路径 → cwd 向上查找（最多 5 级） |
+| `loadPipelineConfig(explicit?)` | 动态 import + PipelineConfigSchema 一级校验 |
+| `scaffoldConfigText(root)` | 零 import 配置骨架文本（config init 用） |
+| `CONFIG_FILENAME` | 约定文件名 `lzi-pipeline.config.ts` |
+
+## 裁定出处
+
+TS 配置模块（专题 reviews/001）；无 schedule 字段（reviews/005）；独立 config 包（统帅部仓结构裁定，records/015）——真源：`longzai-intelligence-architecture/docs/reports/report-20260919-feed-pipeline-orchestration-refactor/`。

package/dist/index.d.ts

@@ -0,0 +1,127 @@
+import { z } from "zod";
+//#region src/schemas/pipeline-config.schema.d.ts
+/** 原始层目标声明：shared（通用 raw_items 库）/ plugin-owned（插件自管库） */
+declare const RawStoreTargetSchema: z.ZodObject<{
+  kind: z.ZodDefault<z.ZodEnum<{
+    "plugin-owned": "plugin-owned";
+    shared: "shared";
+  }>>;
+  path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** 源实例配置（源 = 插件实例） */
+declare const PipelineSourceConfigSchema: z.ZodObject<{
+  id: z.ZodString;
+  plugin: z.ZodString;
+  config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  rawStore: z.ZodDefault<z.ZodObject<{
+    kind: z.ZodDefault<z.ZodEnum<{
+      "plugin-owned": "plugin-owned";
+      shared: "shared";
+    }>>;
+    path: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/** 处理链步骤配置（顺序执行） */
+declare const PipelineProcessorConfigSchema: z.ZodObject<{
+  uses: z.ZodString;
+  config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/** 资料层输出声明 */
+declare const PipelineOutputConfigSchema: z.ZodObject<{
+  collection: z.ZodString;
+  template: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+/** 单条管道定义 */
+declare const PipelineDefinitionSchema: z.ZodObject<{
+  id: z.ZodString;
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  sources: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    plugin: z.ZodString;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    rawStore: z.ZodDefault<z.ZodObject<{
+      kind: z.ZodDefault<z.ZodEnum<{
+        "plugin-owned": "plugin-owned";
+        shared: "shared";
+      }>>;
+      path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  processors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    uses: z.ZodString;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  }, z.core.$strip>>>;
+  outputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    collection: z.ZodString;
+    template: z.ZodDefault<z.ZodString>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** 管道总配置（lzi-pipeline.config.ts 默认导出形态） */
+declare const PipelineConfigSchema: z.ZodObject<{
+  version: z.ZodLiteral<1>;
+  library: z.ZodObject<{
+    root: z.ZodString;
+  }, z.core.$strip>;
+  pipelines: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    sources: z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      plugin: z.ZodString;
+      config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+      rawStore: z.ZodDefault<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodEnum<{
+          "plugin-owned": "plugin-owned";
+          shared: "shared";
+        }>>;
+        path: z.ZodOptional<z.ZodString>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    processors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      uses: z.ZodString;
+      config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    outputs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      collection: z.ZodString;
+      template: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+type RawStoreTarget = z.infer<typeof RawStoreTargetSchema>;
+type PipelineSourceConfig = z.infer<typeof PipelineSourceConfigSchema>;
+type PipelineProcessorConfig = z.infer<typeof PipelineProcessorConfigSchema>;
+type PipelineOutputConfig = z.infer<typeof PipelineOutputConfigSchema>;
+type PipelineDefinition = z.infer<typeof PipelineDefinitionSchema>;
+type PipelineConfig = z.infer<typeof PipelineConfigSchema>;
+/**
+ * 管道配置工厂：类型收口 + 便于 IDE 推导。
+ *
+ * 运行时校验由加载方（CLI loadConfig）执行；此处保持 identity 语义。
+ */
+declare function definePipelineConfig(config: PipelineConfig): PipelineConfig;
+//#endregion
+//#region src/loader.d.ts
+/** 配置文件约定名 */
+declare const CONFIG_FILENAME = "lzi-pipeline.config.ts";
+/** 配置加载错误 */
+interface ConfigLoadError {
+  readonly code: 'CONFIG_NOT_FOUND' | 'CONFIG_INVALID';
+  readonly message: string;
+}
+/** 加载结果 */
+type ConfigLoadResult = {
+  readonly ok: true;
+  readonly config: PipelineConfig;
+  readonly path: string;
+} | {
+  readonly ok: false;
+  readonly error: ConfigLoadError;
+};
+/** 自 cwd 向上查找配置文件（最多 5 级） */
+declare function discoverConfigPath(explicitPath?: string): string | undefined;
+/** 加载并一级校验配置 */
+declare function loadPipelineConfig(explicitPath?: string): Promise<ConfigLoadResult>;
+/** 生成配置骨架文本（config init 用；零 import 依赖，任何目录可加载） */
+declare function scaffoldConfigText(libraryRoot: string): string;
+//#endregion
+export { CONFIG_FILENAME, ConfigLoadError, ConfigLoadResult, PipelineConfig, PipelineConfigSchema, PipelineDefinition, PipelineDefinitionSchema, PipelineOutputConfig, PipelineOutputConfigSchema, PipelineProcessorConfig, PipelineProcessorConfigSchema, PipelineSourceConfig, PipelineSourceConfigSchema, RawStoreTarget, RawStoreTargetSchema, definePipelineConfig, discoverConfigPath, loadPipelineConfig, scaffoldConfigText };

package/dist/index.js

@@ -0,0 +1,23 @@
+import{z as e}from"zod";import{existsSync as t}from"node:fs";import{join as n,resolve as r}from"node:path";const i=e.object({kind:e.enum([`shared`,`plugin-owned`]).default(`shared`),path:e.string().min(1).optional()}),a=e.object({id:e.string().min(1),plugin:e.string().min(1),config:e.record(e.string(),e.unknown()).default({}),rawStore:i.default({kind:`shared`})}),o=e.object({uses:e.string().min(1),config:e.record(e.string(),e.unknown()).default({})}),s=e.object({collection:e.string().min(1),template:e.string().min(1).default(`default`)}),c=e.object({id:e.string().min(1),enabled:e.boolean().default(!0),sources:e.array(a).min(1),processors:e.array(o).default([]),outputs:e.array(s).default([])}),l=e.object({version:e.literal(1),library:e.object({root:e.string().min(1)}),pipelines:e.array(c).default([])});function u(e){return e}const d=`lzi-pipeline.config.ts`;function f(e){if(e!==void 0)return t(e)?r(e):void 0;let i=process.cwd();for(let e=0;e<5;e+=1){let e=n(i,d);if(t(e))return e;let r=n(i,`..`);if(r===i)break;i=r}}async function p(e){let t=f(e);if(t===void 0)return{ok:!1,error:{code:`CONFIG_NOT_FOUND`,message:`未找到配置文件（${d}），可用 --config 显式指定`}};let n=await import(t),r=l.safeParse(n.default);return r.success?{ok:!0,config:r.data,path:t}:{ok:!1,error:{code:`CONFIG_INVALID`,message:`配置不合法：${r.error.message}`}}}function m(e){return`// lzi-pipeline 配置（运行时由 PipelineConfigSchema 校验；无需安装任何包即可加载）。
+// 如需类型推导，可在已安装 @longzai-intelligence-pipeline/core 的项目中改为：
+//   import { definePipelineConfig } from '@longzai-intelligence-pipeline/config';
+//   export default definePipelineConfig({ ... });
+export default {
+  version: 1,
+  library: { root: '${e}' },
+  pipelines: [
+    {
+      id: 'demo',
+      sources: [
+        {
+          id: 'mock-1',
+          plugin: 'builtin:mock',
+          config: { items: [{ slug: 'hello', title: 'Hello Pipeline', payload: { greeting: 'hello' } }] },
+        },
+      ],
+      processors: [{ uses: 'builtin:markdown' }],
+      outputs: [{ collection: 'daily' }],
+    },
+  ],
+};
+`}export{d as CONFIG_FILENAME,l as PipelineConfigSchema,c as PipelineDefinitionSchema,s as PipelineOutputConfigSchema,o as PipelineProcessorConfigSchema,a as PipelineSourceConfigSchema,i as RawStoreTargetSchema,u as definePipelineConfig,f as discoverConfigPath,p as loadPipelineConfig,m as scaffoldConfigText};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@longzai-intelligence-pipeline/config",
+  "version": "0.0.1",
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "test": "lzi-bun-cli test",
+    "test:watch": "lzi-bun-cli test --watch",
+    "test:coverage": "lzi-bun-cli test --coverage",
+    "clean": "lzi-dev-cli clean"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14"
+  }
+}