agentic-flow-kit 1.8.2 → 2.0.0

package/templates/engine/.agents/tests/fixtures/dev-tour/plan-layers-fallback.md

@@ -0,0 +1,17 @@
+---
+标题: 解析失败样例
+状态: 起草中
+级别: L1
+模块: 物资
+日期: 2099-12-31
+---
+# PLAN — 解析失败样例：零散主题调整
+
+## 背景
+一次性调整，没按模板写步骤小节，只有散列文件。
+
+- `frontend/src/styles/widgets/theme.scss`：主题色微调
+- `backend/Widgets/ThemeOptions.cs`：主题配置
+
+## 附注
+同步补 `tests/Widgets/ThemeTests.cs` 一条冒烟用例。

package/templates/engine/.agents/tests/fixtures/dev-tour/plan-layers-fallback.model.json

@@ -0,0 +1,207 @@
+{
+  "schema": 2,
+  "generatedAt": "2020-01-01T00:00:00.000Z",
+  "rootLabel": "Shipyard.Material",
+  "doc": {
+    "path": ".agents/tests/fixtures/dev-tour/plan-layers-fallback.md",
+    "type": "DOC",
+    "title": "解析失败样例：零散主题调整",
+    "status": "起草中",
+    "level": "L1",
+    "module": "物资",
+    "date": "2099-12-31",
+    "purpose": "",
+    "links": [],
+    "upstream": []
+  },
+  "evidence": {
+    "windowStart": "2099-12-31",
+    "rows": [],
+    "totalInWindow": 0
+  },
+  "base": {
+    "ref": "HEAD",
+    "sha": "a1b2c3d4e5f6",
+    "available": true,
+    "note": ""
+  },
+  "stats": {
+    "files": 3,
+    "new": 0,
+    "modified": 0,
+    "deleted": 0,
+    "renamed": 0,
+    "planned": 3,
+    "tests": 1,
+    "additions": 0,
+    "deletions": 0,
+    "docs": 0,
+    "steps": 3
+  },
+  "parseHealth": {
+    "total": 3,
+    "direct": 0,
+    "bySource": {
+      "layers": 3
+    },
+    "zeroFileSteps": 0,
+    "layersFallback": true,
+    "hitRate": 0,
+    "pathGuesses": {
+      "total": 0,
+      "items": []
+    },
+    "issues": [
+      {
+        "line": 1,
+        "title": "未发现结构化步骤标题（## 步骤 / ## 任务拆解 / ### 批次 N）",
+        "kind": "layers-fallback"
+      }
+    ]
+  },
+  "steps": [
+    {
+      "id": "S1",
+      "index": 1,
+      "title": "前端",
+      "summary": "1 个文件",
+      "detail": [],
+      "files": [
+        "frontend/src/styles/widgets/theme.scss"
+      ],
+      "status": "todo",
+      "source": "layers"
+    },
+    {
+      "id": "S2",
+      "index": 2,
+      "title": "应用层",
+      "summary": "1 个文件",
+      "detail": [],
+      "files": [
+        "backend/Widgets/ThemeOptions.cs"
+      ],
+      "status": "todo",
+      "source": "layers"
+    },
+    {
+      "id": "S3",
+      "index": 3,
+      "title": "测试",
+      "summary": "1 个文件",
+      "detail": [],
+      "files": [
+        "tests/Widgets/ThemeTests.cs"
+      ],
+      "status": "todo",
+      "source": "layers"
+    }
+  ],
+  "files": [
+    {
+      "path": "backend/Widgets/ThemeOptions.cs",
+      "status": "planned",
+      "badge": "计划",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "test": false,
+      "layer": "app",
+      "planned": true,
+      "actual": false,
+      "steps": [
+        "S2"
+      ],
+      "diff": "",
+      "oldPath": "",
+      "pathGuess": false
+    },
+    {
+      "path": "frontend/src/styles/widgets/theme.scss",
+      "status": "planned",
+      "badge": "计划",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "test": false,
+      "layer": "frontend",
+      "planned": true,
+      "actual": false,
+      "steps": [
+        "S1"
+      ],
+      "diff": "",
+      "oldPath": "",
+      "pathGuess": false
+    },
+    {
+      "path": "tests/Widgets/ThemeTests.cs",
+      "status": "planned",
+      "badge": "计划",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "test": true,
+      "layer": "test",
+      "planned": true,
+      "actual": false,
+      "steps": [
+        "S3"
+      ],
+      "diff": "",
+      "oldPath": "",
+      "pathGuess": false
+    }
+  ],
+  "sequence": {
+    "participants": [
+      {
+        "id": "frontend",
+        "label": "前端"
+      },
+      {
+        "id": "app",
+        "label": "应用层"
+      },
+      {
+        "id": "test",
+        "label": "测试"
+      }
+    ],
+    "messages": [
+      {
+        "stepId": "S1",
+        "from": "frontend",
+        "to": "frontend",
+        "label": "前端",
+        "self": true
+      },
+      {
+        "stepId": "S2",
+        "from": "app",
+        "to": "app",
+        "label": "应用层",
+        "self": true
+      },
+      {
+        "stepId": "S3",
+        "from": "test",
+        "to": "test",
+        "label": "测试",
+        "self": true
+      }
+    ]
+  },
+  "dataflow": {
+    "objects": [],
+    "flows": []
+  },
+  "deps": {
+    "edges": [],
+    "source": "",
+    "unresolved": 0,
+    "unresolvedItems": []
+  },
+  "gates": [],
+  "note": ""
+}

package/templates/engine/.agents/tests/fixtures/dev-tour/plan-numbered-steps.md

@@ -0,0 +1,39 @@
+---
+标题: 编号步骤样例
+状态: 起草中
+级别: L2
+模块: 物资
+日期: 2099-12-31
+---
+# PLAN — 编号步骤样例：出库计划跟踪
+
+## 入口
+目标：把出库计划页做成可跟踪的最小闭环。
+对应入口：workflow/intents/2020-01-01-widget-demo.md
+
+## 背景
+出库计划目前只有线下台账，页面与接口均缺失，需按仓库现有分层补齐。
+
+## 步骤
+1. **T1 后端接口**：新增出库计划查询与保存接口
+2. **T2 应用服务**：出库计划的保存编排与旧服务下线
+3. **T3 前端页面**：出库计划列表与表单
+4. **T4 全链路验证**：接口到页面的回归
+
+## 改动方案
+- **T1**：后端接口
+  - `backend/Widgets/OutboundController.cs`：出库计划接口
+- **T2**：应用服务
+  - `backend/Widgets/OutboundAppService.cs`：保存编排
+  - `backend/Widgets/OldOutboundService.cs`：旧服务删除
+- **T3**：前端页面
+  - `frontend/src/views/widgets/outbound-plan.vue`：列表页
+  - `frontend/src/api/widgets/outboundPlan.ts`：接口封装
+
+## 执行顺序
+1 → 2 → 3 → 4
+依赖：3 依赖 1~2；4 依赖全部；88 依赖 1
+
+## 验证计划
+- `tests/Widgets/OutboundPlanTests.cs` 全绿
+- 手工：页面提交一条出库计划

package/templates/engine/.agents/tests/fixtures/dev-tour/plan-numbered-steps.model.json

@@ -0,0 +1,359 @@
+{
+  "schema": 2,
+  "generatedAt": "2020-01-01T00:00:00.000Z",
+  "rootLabel": "Shipyard.Material",
+  "doc": {
+    "path": ".agents/tests/fixtures/dev-tour/plan-numbered-steps.md",
+    "type": "DOC",
+    "title": "编号步骤样例：出库计划跟踪",
+    "status": "起草中",
+    "level": "L2",
+    "module": "物资",
+    "date": "2099-12-31",
+    "purpose": "把出库计划页做成可跟踪的最小闭环。",
+    "links": [
+      {
+        "label": "2020-01-01-widget-demo.md",
+        "path": "workflow/intents/2020-01-01-widget-demo.md"
+      }
+    ],
+    "upstream": []
+  },
+  "evidence": {
+    "windowStart": "2099-12-31",
+    "rows": [],
+    "totalInWindow": 0
+  },
+  "base": {
+    "ref": "HEAD",
+    "sha": "a1b2c3d4e5f6",
+    "available": true,
+    "note": ""
+  },
+  "stats": {
+    "files": 7,
+    "new": 1,
+    "modified": 2,
+    "deleted": 1,
+    "renamed": 0,
+    "planned": 3,
+    "tests": 1,
+    "additions": 141,
+    "deletions": 73,
+    "docs": 0,
+    "steps": 5
+  },
+  "parseHealth": {
+    "total": 4,
+    "direct": 4,
+    "bySource": {
+      "steps": 4
+    },
+    "zeroFileSteps": 0,
+    "layersFallback": false,
+    "hitRate": 1,
+    "pathGuesses": {
+      "total": 0,
+      "items": []
+    },
+    "issues": [
+      {
+        "line": 35,
+        "title": "88 依赖 1",
+        "kind": "dep-unresolved"
+      }
+    ]
+  },
+  "steps": [
+    {
+      "id": "T1",
+      "index": 1,
+      "title": "后端接口",
+      "summary": "新增出库计划查询与保存接口",
+      "detail": [
+        "`backend/Widgets/OutboundController.cs`：出库计划接口"
+      ],
+      "files": [
+        "backend/Widgets/OutboundController.cs"
+      ],
+      "status": "todo",
+      "source": "steps"
+    },
+    {
+      "id": "T2",
+      "index": 2,
+      "title": "应用服务",
+      "summary": "出库计划的保存编排与旧服务下线",
+      "detail": [
+        "`backend/Widgets/OutboundAppService.cs`：保存编排",
+        "`backend/Widgets/OldOutboundService.cs`：旧服务删除"
+      ],
+      "files": [
+        "backend/Widgets/OutboundAppService.cs",
+        "backend/Widgets/OldOutboundService.cs"
+      ],
+      "status": "todo",
+      "source": "steps"
+    },
+    {
+      "id": "T3",
+      "index": 3,
+      "title": "前端页面",
+      "summary": "出库计划列表与表单",
+      "detail": [
+        "`frontend/src/views/widgets/outbound-plan.vue`：列表页",
+        "`frontend/src/api/widgets/outboundPlan.ts`：接口封装"
+      ],
+      "files": [
+        "frontend/src/views/widgets/outbound-plan.vue",
+        "frontend/src/api/widgets/outboundPlan.ts"
+      ],
+      "status": "todo",
+      "source": "steps"
+    },
+    {
+      "id": "T4",
+      "index": 4,
+      "title": "全链路验证",
+      "summary": "接口到页面的回归",
+      "detail": [],
+      "files": [
+        "tests/Widgets/OutboundPlanTests.cs"
+      ],
+      "status": "todo",
+      "source": "steps"
+    },
+    {
+      "id": "X",
+      "index": 5,
+      "title": "文档外实际改动",
+      "summary": "git 工作树里有、plan 改动面未登记——优先核对 scope",
+      "detail": [
+        "这些文件不在文档改动清单内，可能是范围漂移，也可能是文档该回填。"
+      ],
+      "files": [
+        "scripts/zz-widget/rogue-sync.ps1"
+      ],
+      "status": "warn",
+      "source": "git"
+    }
+  ],
+  "files": [
+    {
+      "path": "backend/Widgets/OldOutboundService.cs",
+      "status": "deleted",
+      "badge": "删除",
+      "additions": 0,
+      "deletions": 64,
+      "binary": false,
+      "test": false,
+      "layer": "app",
+      "planned": true,
+      "actual": true,
+      "steps": [
+        "T2"
+      ],
+      "diff": "",
+      "oldPath": "",
+      "pathGuess": false
+    },
+    {
+      "path": "backend/Widgets/OutboundAppService.cs",
+      "status": "planned",
+      "badge": "计划",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "test": false,
+      "layer": "app",
+      "planned": true,
+      "actual": false,
+      "steps": [
+        "T2"
+      ],
+      "diff": "",
+      "oldPath": "",
+      "pathGuess": false
+    },
+    {
+      "path": "backend/Widgets/OutboundController.cs",
+      "status": "modified",
+      "badge": "修改",
+      "additions": 42,
+      "deletions": 8,
+      "binary": false,
+      "test": false,
+      "layer": "app",
+      "planned": true,
+      "actual": true,
+      "steps": [
+        "T1"
+      ],
+      "diff": "diff --git a/backend/Widgets/OutboundController.cs b/backend/Widgets/OutboundController.cs\n@@ -12,6 +12,14 @@",
+      "oldPath": "",
+      "pathGuess": false
+    },
+    {
+      "path": "frontend/src/api/widgets/outboundPlan.ts",
+      "status": "planned",
+      "badge": "计划",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "test": false,
+      "layer": "frontend",
+      "planned": true,
+      "actual": false,
+      "steps": [
+        "T3"
+      ],
+      "diff": "",
+      "oldPath": "",
+      "pathGuess": false
+    },
+    {
+      "path": "frontend/src/views/widgets/outbound-plan.vue",
+      "status": "new",
+      "badge": "新增",
+      "additions": 96,
+      "deletions": 0,
+      "binary": false,
+      "test": false,
+      "layer": "frontend",
+      "planned": true,
+      "actual": true,
+      "steps": [
+        "T3"
+      ],
+      "diff": "diff --git a/frontend/src/views/widgets/outbound-plan.vue b/frontend/src/views/widgets/outbound-plan.vue\nnew file mode 100644\n--- /dev/null\n+++ b/frontend/src/views/widgets/outbound-plan.vue",
+      "oldPath": "",
+      "pathGuess": false
+    },
+    {
+      "path": "scripts/zz-widget/rogue-sync.ps1",
+      "status": "modified",
+      "badge": "修改",
+      "additions": 3,
+      "deletions": 1,
+      "binary": false,
+      "test": false,
+      "layer": "other",
+      "planned": false,
+      "actual": true,
+      "steps": [
+        "X"
+      ],
+      "diff": "",
+      "oldPath": "",
+      "pathGuess": false
+    },
+    {
+      "path": "tests/Widgets/OutboundPlanTests.cs",
+      "status": "planned",
+      "badge": "计划",
+      "additions": 0,
+      "deletions": 0,
+      "binary": false,
+      "test": true,
+      "layer": "test",
+      "planned": true,
+      "actual": false,
+      "steps": [
+        "T4"
+      ],
+      "diff": "",
+      "oldPath": "",
+      "pathGuess": false
+    }
+  ],
+  "sequence": {
+    "participants": [
+      {
+        "id": "frontend",
+        "label": "前端"
+      },
+      {
+        "id": "app",
+        "label": "应用层"
+      },
+      {
+        "id": "test",
+        "label": "测试"
+      },
+      {
+        "id": "other",
+        "label": "其他"
+      }
+    ],
+    "messages": [
+      {
+        "stepId": "T1",
+        "from": "app",
+        "to": "app",
+        "label": "后端接口",
+        "self": true
+      },
+      {
+        "stepId": "T2",
+        "from": "app",
+        "to": "app",
+        "label": "应用服务",
+        "self": true
+      },
+      {
+        "stepId": "T3",
+        "from": "frontend",
+        "to": "frontend",
+        "label": "前端页面",
+        "self": true
+      },
+      {
+        "stepId": "T4",
+        "from": "test",
+        "to": "test",
+        "label": "全链路验证",
+        "self": true
+      },
+      {
+        "stepId": "X",
+        "from": "app",
+        "to": "app",
+        "label": "文档外实际改动",
+        "self": true
+      }
+    ]
+  },
+  "dataflow": {
+    "objects": [],
+    "flows": []
+  },
+  "deps": {
+    "edges": [
+      {
+        "from": "T1",
+        "to": "T3"
+      },
+      {
+        "from": "T2",
+        "to": "T3"
+      },
+      {
+        "from": "T3",
+        "to": "T4"
+      }
+    ],
+    "source": "exec-order",
+    "unresolved": 1,
+    "unresolvedItems": [
+      {
+        "line": 35,
+        "title": "88 依赖 1"
+      }
+    ]
+  },
+  "gates": [
+    "`tests/Widgets/OutboundPlanTests.cs` 全绿",
+    "手工：页面提交一条出库计划"
+  ],
+  "note": ""
+}

package/templates/engine/.agents/tests/fixtures/dev-tour/plan-path-guess.md

@@ -0,0 +1,16 @@
+---
+标题: 路径猜测样例
+状态: 起草中
+级别: L1
+模块: 物资
+日期: 2099-12-31
+---
+# PLAN — 路径猜测样例：采购编辑器对齐
+
+## 任务拆解
+- [ ] 1. T1 编辑器对齐：contractTemplate 弹窗字段微调
+  - 判据：contractTemplate 页面构建通过
+
+## 改动方案
+- **T1**：编辑器
+  - `editor.vue`：补 contractTemplate 字段