{"_id":"@atom-workflow-agent/workflow-planner","name":"@atom-workflow-agent/workflow-planner","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@atom-workflow-agent/workflow-planner","version":"0.1.0","description":"Catalog-aware dynamic workflow planning and transactional validation.","license":"Apache-2.0","repository":{"type":"git","url":"git+https://github.com/joekbits/atom-workflow-agent.git","directory":"packages/workflow-planner"},"homepage":"https://github.com/joekbits/atom-workflow-agent/tree/main/packages/workflow-planner#readme","bugs":{"url":"https://github.com/joekbits/atom-workflow-agent/issues"},"keywords":["workflow","planner","agent","validation"],"type":"module","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"publishConfig":{"access":"public","provenance":true},"engines":{"node":">=22"},"dependencies":{"@atom-workflow-agent/atom-catalog":"0.1.0","@atom-workflow-agent/workflow-compiler":"0.1.0","@atom-workflow-agent/contracts":"0.1.0"},"devDependencies":{"@atom-workflow-agent/atom-sdk":"0.1.0"},"scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","test":"vitest run"},"_id":"@atom-workflow-agent/workflow-planner@0.1.0","_integrity":"sha512-5O9KZezef01syqJBWhjBkfairKXGe3D3qm1cQgbmBTdL6fql+mlLMOG1mNXKdTzU9nwyBudkmQI+YJY3yvSR5Q==","_resolved":"/private/tmp/atomflow-npm-release-20260902-1720/atom-workflow-agent-workflow-planner-0.1.0.tgz","_from":"file:/private/tmp/atomflow-npm-release-20260902-1720/atom-workflow-agent-workflow-planner-0.1.0.tgz","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-5O9KZezef01syqJBWhjBkfairKXGe3D3qm1cQgbmBTdL6fql+mlLMOG1mNXKdTzU9nwyBudkmQI+YJY3yvSR5Q==","shasum":"d35537c977ebda1b27e28a0a02990ca6cc9b86cc","tarball":"https://registry.npmjs.org/@atom-workflow-agent/workflow-planner/-/workflow-planner-0.1.0.tgz","fileCount":64,"unpackedSize":439250,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDKKLKM0R24p/SsBfiUjScqu/hLyJ3ypEqx87es4gDhFwIgeQn39+jqCM9onh6Qx9/sgPfxgowwhXgoVaraMJOnA3k="}]},"_npmUser":{"name":"joekbits","email":"wangfeihong868@foxmail.com"},"directories":{},"maintainers":[{"name":"joekbits","email":"wangfeihong868@foxmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/workflow-planner_0.1.0_1788342349128_0.424438085664808"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-02T09:45:48.823Z","0.1.0":"2026-09-02T09:45:49.284Z","modified":"2026-09-02T09:45:49.565Z"},"maintainers":[{"name":"joekbits","email":"wangfeihong868@foxmail.com"}],"description":"Catalog-aware dynamic workflow planning and transactional validation.","homepage":"https://github.com/joekbits/atom-workflow-agent/tree/main/packages/workflow-planner#readme","keywords":["workflow","planner","agent","validation"],"repository":{"type":"git","url":"git+https://github.com/joekbits/atom-workflow-agent.git","directory":"packages/workflow-planner"},"bugs":{"url":"https://github.com/joekbits/atom-workflow-agent/issues"},"license":"Apache-2.0","readme":"# @atom-workflow-agent/workflow-planner\n\n[English](README.md) | [简体中文](README.zh-CN.md)\n\n基于 Catalog 将目标编排为全局有效 Workflow Revision 的规划层。\n\n## 职责\n\n- 在生成图前解析能力覆盖并尽早报告缺失 Atom。\n- 由模型选择精确 Atom key，并把业务角色映射到精确顶层字段；权威 Atom Schema 由 Runtime 提供并校验。\n- 将语义规划事务应用到不可变 Workspace Revision。\n- 执行严格自动绑定、规范化、Compiler 校验、事务回滚与 checkpoint 恢复。\n- 通过 `PlanningModelPort` 接受任意模型适配器；Planner 内不依赖 ACP。\n\n能力预检不会要求模型复写 JSON Schema。精简 Catalog Index 只提供字段名、description、必填标记和所有适用 JSON 值类型。已覆盖需求引用这些字段；真正缺少的可执行能力使用独立的 `missing` resolution。控制流终态和常量绑定不属于能力。\n\n控制结构与控制执行必须区分：Decision 容器不是能力，但根据运行时数据计算分支的 Atom 是能力。选择器 Atom 与其他会执行的 Atom 一样，必须通过精确 key 和精确字段覆盖校验。\n\n## 边界\n\n- 不执行 Atom、不修改冻结 Revision，也不存储 Run 证据。\n\n## 主要入口\n\n- `PlanningController`\n- `PlanningModelPort`\n- `buildPlannerCatalog`\n- `PlanningWorkspaceService`\n- `resolveCapabilityCoverage`\n- `LocalPlanStore`\n\n## 开发\n\n```bash\npnpm --filter @atom-workflow-agent/workflow-planner typecheck\npnpm --filter @atom-workflow-agent/workflow-planner test\n```\n\n通用概念与完整流程见项目[中文文档](../../docs/README.zh-CN.md)。\n","readmeFilename":"README.zh-CN.md","_rev":"1-5c0611900611922e49843a31d49ee17a"}