@agent-pipeline/core

Agent Pipeline 引擎层，提供类型定义、关卡状态机、DAG 工具和核心服务。

模块结构

src/
├── types/              类型定义
│   ├── config.ts       管线配置（LevelConfig, PipelineConfig）
│   ├── state.ts        管线状态（LevelState, PipelineState）
│   ├── protocol.ts     文件协议常量（FILE_PROTOCOL）
│   ├── ipc.ts          IPC 通道定义（21 个通道）
│   ├── reference.ts    引用类型（ReferenceEntry, ReferencesManifest）
│   ├── action-guide.ts 行动指引（ActionGuide, ActionPhase, ActionActor）
│   └── mcp.ts          MCP 类型（资源 URI、工具参数）
├── state-machine/
│   └── levelMachine.ts XState v5 状态机（9 状态，7 事件）
├── services/
│   ├── ConfigParser.ts       配置解析 + depends_on 校验 + DAG 环检测
│   ├── StateMachineService.ts 状态机管理 + DAG 解锁（checkAndUnlockDependents）
│   ├── MigrationEngine.ts    关卡流转引擎 + 引用式迁移（generateReferences）
│   ├── FileWatcherService.ts 文件监听（chokidar, 含 _references.yaml）
│   ├── ReadmeGenerator.ts    README 自动生成
│   ├── ReferenceResolver.ts  引用解析 + 上下文链查询
│   └── SystemPromptManager.ts 系统提示词管理
├── utils/
│   ├── fileOps.ts            文件操作工具
│   ├── markdownParser.ts     Markdown 解析（验收清单 checkbox）
│   └── dagUtils.ts           拓扑排序、环检测、上下游查询
├── constants.ts              业务常量
└── index.ts                  统一导出

使用

其他包通过 workspace 协议引用：

{
  "dependencies": {
    "@agent-pipeline/core": "^2.0.0"
  }
}

import { ConfigParser, StateMachineService, FILE_PROTOCOL } from '@agent-pipeline/core'
import type { LevelConfig, PipelineState, ActionGuide } from '@agent-pipeline/core'

脚本

pnpm test          # 运行 106 个测试
pnpm build         # tsup 构建（ESM + CJS + DTS）
pnpm typecheck     # TypeScript 类型检查