# @devflow-tools/workflow-engine

> DAG 工作流编排、审批门禁、worker 协调和 SSE 进度事件。（v0.17.8）

[![npm version](https://img.shields.io/npm/v/%40devflow-tools%2Fworkflow-engine.svg)](https://www.npmjs.com/package/@devflow-tools/workflow-engine)

## 安装

```bash
npm install @devflow-tools/workflow-engine
```

## 快速开始

```typescript
import { WorkflowEngine } from '@devflow-tools/workflow-engine';

const engine = new WorkflowEngine();
engine.register({ name: 'bugfix', steps: [{ id: 'analyze', needs: [] }, { id: 'verify', needs: ['analyze'] }] });
const run = await engine.run('bugfix', { issue: 'login broken' });
```

## 公共 API / 命令

`WorkflowEngine`、`topologicalSort`、`executeLevels`、`StepResolver` 以及 `failure-classifier` 子路径。


## 配置与运行时

工作流通过 SDK 的定义和 telemetry 记录执行状态；需要审批的步骤必须显式调用引擎的审批接口。

## 版本与兼容性

- 当前包版本：`0.17.8`
- Node.js：未在 package manifest 声明更高版本时，使用 Node.js 18+；原生 SQLite/Playwright 能力请按对应依赖安装
- workspace 内部包应使用同一 DevFlow minor/patch 版本，避免类型和数据库 schema 不一致

## 相关链接

- [DevFlow 仓库](https://github.com/shilongfeicool/dev-flow)
- [问题反馈](https://github.com/shilongfeicool/dev-flow/issues)

## License

MIT