VLCode-Lite/.codex/vendor/VL-Workflow-Engine/CLAUDE.md

VL-Workflow-Engine — CLAUDE.md

VL Workflow Engine: JS port of the Go workflow executor (spec v3.16) Called by: VL-Code, VLClaw, VLClaude, and other VL ecosystem tools Version: see package.json

---

Code Sovereignty (Charter Article 14 — MUST FOLLOW)

• 本 Claude 只写 VL-Workflow-Engine 代码 (~/Documents/VL-Workflow-Engine/)
• 可读 VL-Code、VLClaw、VLClaude 的文件（了解接口、调试）
• 不可写/编辑 VL-Code、VLClaw 或 VLClaude 的任何代码文件
• 跨项目接口变更: 改自己的代码 → 更新 Shared Contracts → 对方自行实现
• 完整规则: Charter v2.3.0 Article 14

Project Structure

VL-Workflow-Engine/
├── index.js          ← main entry, re-exports
├── package.json      ← name: vl-workflow-engine, v0.6.0
├── API.md            ← API documentation
├── lib/
│   ├── engine.js     ← core workflow engine
│   ├── executor.js   ← node executor
│   ├── expression.js ← expression evaluator
│   ├── parallel.js   ← parallel execution support
│   ├── registry.js   ← node type registry
│   └── types.js      ← type definitions
├── ui/
│   ├── workflow-editor.html ← canonical DAG visualizer (Spec 3.16)
│   └── INTEGRATION.md      ← integration guide for consumers
└── test/
    └── run.js        ← test runner

Key Facts

• Pure JS, no external dependencies
• Implements VL Workflow Spec v3.16 (DocCenter path 3)
• Exports: ./engine, ./expression, ./types
• This is a library — it does not run standalone; it is imported by VL-Code, VLClaw, etc.

Development Rules

• Run tests: node test/run.js
• Keep zero external dependencies unless absolutely necessary
• Any API change must be backward-compatible or coordinated with consumers (VL-Code, VLClaw, VLClaude)
• Follow the Workflow Spec strictly — do not invent non-spec node types or behaviors