GM-HZ/dsh-dag-workflow--packages-catalog1

@gm-hz/dsh-dag-workflow-catalog

Draft, CAS, validation and immutable revision catalog for DSH workflows

AI 分析

核心用途是管理工作流模板的草稿、并发控制、编译验证及不可变发布版本。适合需要对工作流进行版本控制、增量构建和完整性校验的开发者。

パッケージ
@gm-hz/dsh-dag-workflow-catalog
バージョン
0.1.1
ライセンス
MIT
最終更新
2026/08/24

インストール

検証済み bundle がないか、互換性チェックに失敗しています。先にリポジトリの説明を読んでください。 README 全文を読む ↗

ドキュメント

README 全文を読む ↗

@gm-hz/dsh-dag-workflow-catalog

Workflow Template 的 draft、乐观并发和不可变发布版本领域层。

const repository = new InMemoryWorkflowCatalogRepository()
const catalog = new WorkflowTemplateCatalog(repository, workflowNodeRegistry)

const draft = catalog.createDraft(template)
const next = catalog.updateDraft(draft.id, draft.revision, editedTemplate)
const diagnostics = catalog.validate(next.template)
const published = catalog.publish(next.id, next.revision)

语义

  • draft revision 从 1 开始,每次 update 必须携带 expectedRevision
  • draft 可以暂时无效,便于 Agent/Canvas 增量构建;publish 必须通过完整编译校验。
  • published revision 独立单调递增,内容、节点版本、content hash 和 semantic hash 不可变。
  • semantic hash 排除 layout,content hash 包含完整模板。
  • diff() 分开报告 node、edge、layout 与 semantic 变化。
  • Repository 接口把原子 CAS/publish 交给存储 provider;内存实现用于测试,SQLite provider 单独实现。