agentic-flow-kit 1.8.2 → 2.0.0

package/templates/profiles/dotnet/.agents/config/test-impact-map.json

@@ -0,0 +1,590 @@
+{
+  "version": 1,
+  "namespace": "Shipyard.Material.IntegrationTests",
+  "note": "影响面选测映射：areas=测试类归属；always=每次集成子集必跑；paths=按序首命中，未命中/星号=全量。新增测试类须登记，check-test-impact-map.mjs 机检。",
+  "areas": {
+    "api": [
+      "AuthChallengeBodyApiTests",
+      "BusinessExceptionResponseTests",
+      "ExceptionResponseTests",
+      "MiniProfilerWiringTests",
+      "NotEmptyGuidValidationTests",
+      "PaginationClampTests",
+      "PerfGuardLatencyTests",
+      "PerfGuardSqlCountTests",
+      "RequestDtoNullabilityTests",
+      "SearchEmptyKeywordTests"
+    ],
+    "core": [
+      "ConnectionSmokeTests",
+      "TestDbLockTests",
+      "TestDbWriteGuardTests"
+    ],
+    "inventory": [
+      "DocumentAttachmentTests",
+      "OutboundInventoryLockTests",
+      "PipePieceCountInventoryTests",
+      "TransferOrderInventoryOccupationTests"
+    ],
+    "masterdata": [
+      "BuyerGroupsApiTests",
+      "BuyersApiTests",
+      "CodeTemplateSqlTests",
+      "ExchangeRateApiTests",
+      "ExchangeRateImportApiTests",
+      "ManagementSegmentsApiTests",
+      "MasterDataApiGuardMoreTests",
+      "MasterDataApiTests",
+      "MaterialCodeAttributeGuardTests",
+      "MaterialCodesApiTests",
+      "SpecCodeCounterSqlTests",
+      "SuppliersApiTests",
+      "WarehouseKeeperCascadeSqlTests",
+      "WarehousesApiTests"
+    ],
+    "mto": [
+      "MtoChangeApiOwnerGuardTests",
+      "MtoChangeCreateInProgressGuardSqlTests",
+      "MtoChangeListFilterSqlTests",
+      "MtoChangeLongNoSqlTests",
+      "MtoChangeRowVersionSqlTests",
+      "MtoChangesApproveMissingDetailTests",
+      "MtoDetailDemandDeptFallbackTests",
+      "MtoFieldDropRegressionTests",
+      "MtoImportPreviewDeptValidationTests",
+      "MtoOrdersApiOwnerGuardTests",
+      "MtoTransferOrderFlowSqlTests"
+    ],
+    "outbound": [
+      "MtoTransferOrderFlowSqlTests",
+      "OutboundAvailabilityTests",
+      "OutboundBorrowSupplementApiPathTests",
+      "OutboundBorrowSupplementTests",
+      "OutboundCheckOccupyTests",
+      "OutboundEditDeleteLineOccupyTests",
+      "OutboundHalfUpRoundingTests",
+      "OutboundInventoryLockTests",
+      "OutboundOrderImportPreviewTests",
+      "OutboundOrderPickConfirmEndpointApiTests",
+      "OutboundOrderPickFlowTests",
+      "OutboundOrderPickingAndAuditTests",
+      "OutboundOrderPickingHeaderTests",
+      "OutboundOrderPickingTypeGateTests",
+      "OutboundOrderPickReleaseTests",
+      "OutboundOrderSourceRequestGuardApiTests",
+      "OutboundOrderSummaryRedesignEndpointsTests",
+      "OutboundOrderSummaryRedesignTests",
+      "OutboundOrderUsageCaliberTests",
+      "OutboundPalletQuotaTests",
+      "OutboundPmlDetailLinkTests",
+      "OutboundQueryValidationApiTests",
+      "OutboundQuotaMainQtyTests",
+      "OutboundR01QuotaGuardTests",
+      "OutboundReleaseChainTests",
+      "OutboundRequestCategoryUsageInfoTests",
+      "OutboundRequestCheckSatisfactionTests",
+      "OutboundRequestDraftInventoryCheckTests",
+      "OutboundRequestImportTests",
+      "OutboundRequestLinkageTests",
+      "OutboundRequestLineCheckStampTests",
+      "OutboundRequestMaterialCheckTraceTests",
+      "OutboundRequestPickingDisciplineTests",
+      "OutboundRequestPickingInfoTests",
+      "OutboundRequestQueryKeywordTests",
+      "OutboundRequestSubmitChainApiTests",
+      "OutboundRequestSubmitChainTests",
+      "OutboundRequestSummaryApiTests",
+      "OutboundRequestSummaryApplyQtyApiTests",
+      "OutboundRequestSummaryApplyQtyCacheTests",
+      "OutboundRequestSummaryFifoRedistributionTests",
+      "OutboundRequestUnoccupiedFlagApiTests",
+      "OutboundRequestWarehouseRemovalTests",
+      "OutboundSummaryRebuildTests",
+      "OutboundTransferPieceCountTests",
+      "PipePieceCountInventoryTests",
+      "PmlApiOwnerGuardTests",
+      "PMLOnlyMineFilterTests",
+      "PMLProjectFilterTests",
+      "PmlQuotaDualUnitTests",
+      "TransferExecuteEndToEndSqlTests",
+      "TransferOrderDetailActualConversionRateTests",
+      "TransferOrderDetailLocationSqlTests",
+      "TransferOrderInventoryOccupationTests",
+      "TransferOrderWarehouseNullableTests"
+    ],
+    "purchase": [
+      "DocumentAttachmentTests",
+      "AutoAssignTests",
+      "AvailableBuyersTests",
+      "BuyerAndLineGuardTests",
+      "BuyerCreateSqlTests",
+      "BuyerGroupsApiTests",
+      "BuyerJobNoMatchTests",
+      "BuyersApiTests",
+      "DraftPurchaseOrderOrderedQtyTests",
+      "ExchangeRateApiTests",
+      "ExchangeRateImportApiTests",
+      "OutboundOrderSourceRequestGuardApiTests",
+      "OutboundRequestLinkageTests",
+      "PaymentTermAndBusinessTypeGuardTests",
+      "PurchaseContractApiTests",
+      "PurchaseDisabledDetailChainGuardTests",
+      "PurchaseOrderApiGuardTests",
+      "PurchaseOrderCancelGuardTests",
+      "PurchaseOrderConcurrencyTests",
+      "PurchaseOrderContractTaxTests",
+      "PurchaseOrderLineCloseTests",
+      "PurchaseOrderLinkageServiceTests",
+      "PurchaseOrderNumericGuardTests",
+      "PurchaseOrderOrgMatchTests",
+      "PurchaseOrderOverQtyGuardTests",
+      "PurchaseOrderPrCaliberTests",
+      "PurchaseOrderPrLinkageTests",
+      "PurchaseOrderPriceAnchorTests",
+      "PurchaseOrderSupplierGuardTests",
+      "PurchaseOrderTaxRateModeTests",
+      "PurchaseRequestActiveUniqueIndexGuardTests",
+      "PurchaseRequestServiceGuardTests",
+      "RejectRemarkGuardTests",
+      "SuppliersApiTests"
+    ],
+    "schema": [
+      "BuyerCreateSqlTests",
+      "CodeTemplateSqlTests",
+      "SchemaLedgerDriftTests",
+      "SpecCodeCounterSqlTests",
+      "TransferExecuteEndToEndSqlTests",
+      "WarehouseKeeperCascadeSqlTests"
+    ]
+  },
+  "always": [
+    "ConnectionSmokeTests",
+    "TestDbWriteGuardTests",
+    "TestDbLockTests"
+  ],
+  "paths": [
+    {
+      "glob": "backend/shared/**",
+      "areas": [
+        "*"
+      ],
+      "note": "跨服务共享层"
+    },
+    {
+      "glob": "backend/integration/**",
+      "areas": [
+        "*"
+      ],
+      "note": "集成支撑库"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Common/**",
+      "areas": [
+        "*"
+      ],
+      "note": "横切数值/守卫/汇率解析"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Interfaces/**",
+      "areas": [
+        "purchase",
+        "outbound",
+        "mto"
+      ],
+      "note": "订单域接口"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Implementations/MTO*",
+      "areas": [
+        "mto"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Implementations/Mto*",
+      "areas": [
+        "mto"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Implementations/Purchase*",
+      "areas": [
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Implementations/Buyer*",
+      "areas": [
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Implementations/Outbound*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Implementations/*Transfer*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Implementations/Supplement*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Implementations/Arrival*",
+      "areas": [
+        "*"
+      ],
+      "note": "无独立集成覆盖，保守全量"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Implementations/Inbound*",
+      "areas": [
+        "*"
+      ],
+      "note": "无独立集成覆盖，保守全量"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Implementations/Comparison*",
+      "areas": [
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Outbound*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/*Transfer*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Mto*",
+      "areas": [
+        "mto"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/MTO*",
+      "areas": [
+        "mto"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/Buyer*",
+      "areas": [
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Orders/**",
+      "areas": [
+        "purchase",
+        "outbound",
+        "mto"
+      ],
+      "note": "订单域其余文件：多域保守"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Inventory/**",
+      "areas": [
+        "outbound",
+        "inventory"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/MasterData/Implementations/Buyer*",
+      "areas": [
+        "purchase",
+        "masterdata"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/MasterData/Implementations/Supplier*",
+      "areas": [
+        "purchase",
+        "masterdata"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/MasterData/Implementations/ExchangeRate*",
+      "areas": [
+        "masterdata",
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/MasterData/**",
+      "areas": [
+        "masterdata"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/PML/**",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Services/Statistics/**",
+      "areas": [
+        "api"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/MTO*",
+      "areas": [
+        "mto"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/Mto*",
+      "areas": [
+        "mto"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/Outbound*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/*Transfer*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/Supplement*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/Borrow*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/Purchase*",
+      "areas": [
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/Buyer*",
+      "areas": [
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/Comparison*",
+      "areas": [
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/Arrival*",
+      "areas": [
+        "*"
+      ],
+      "note": "无独立集成覆盖，保守全量"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/Inbound*",
+      "areas": [
+        "*"
+      ],
+      "note": "无独立集成覆盖，保守全量"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Orders/**",
+      "areas": [
+        "purchase",
+        "outbound",
+        "mto"
+      ],
+      "note": "订单 DTO 跨域兜底"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Inventory/**",
+      "areas": [
+        "outbound",
+        "inventory"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/PML/**",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/MasterData/**",
+      "areas": [
+        "masterdata"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/Dtos/Statistics/**",
+      "areas": [
+        "api"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Application/**",
+      "areas": [
+        "*"
+      ],
+      "note": "应用层其余文件"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Orders/MTO*",
+      "areas": [
+        "mto"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Orders/Outbound*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Orders/*Transfer*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Orders/Supplement*",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Orders/Purchase*",
+      "areas": [
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Orders/Arrival*",
+      "areas": [
+        "*"
+      ],
+      "note": "无独立集成覆盖，保守全量"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Orders/Inbound*",
+      "areas": [
+        "*"
+      ],
+      "note": "无独立集成覆盖，保守全量"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Orders/Comparison*",
+      "areas": [
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Orders/**",
+      "areas": [
+        "purchase",
+        "outbound",
+        "mto"
+      ],
+      "note": "订单控制器其余文件：多域保守"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/MasterData/Buyer*",
+      "areas": [
+        "purchase",
+        "masterdata"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/MasterData/Supplier*",
+      "areas": [
+        "purchase",
+        "masterdata"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/MasterData/ExchangeRate*",
+      "areas": [
+        "masterdata",
+        "purchase"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/MasterData/**",
+      "areas": [
+        "masterdata"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Inventory/**",
+      "areas": [
+        "outbound",
+        "inventory"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/PML/**",
+      "areas": [
+        "outbound"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/Statistics/**",
+      "areas": [
+        "api"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/Controllers/AuthController.cs",
+      "areas": [
+        "api"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.API/**",
+      "areas": [
+        "*"
+      ],
+      "note": "启动/中间件/错误处理/JSON 转换等横切"
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Domain/**",
+      "areas": [
+        "*"
+      ]
+    },
+    {
+      "glob": "backend/material/Shipyard.Material.Infrastructure/**",
+      "areas": [
+        "*"
+      ]
+    },
+    {
+      "glob": "backend/**",
+      "areas": [
+        "*"
+      ],
+      "note": "后端兜底：未登记路径一律全量"
+    }
+  ]
+}

package/templates/profiles/dotnet/.agents/config/workflow-modules.txt

@@ -0,0 +1,18 @@
+# workflow 文档模块词表（单源：.agents/scripts/ 下 fill-intent.mjs / pipeline-run.mjs / gen-workflow-index.mjs / kb-search.mjs 共读）
+# 用法：workflow/{intents,specs,plans,incidents} 文档 frontmatter `模块:` 取下列之一（单值，取主导模块；
+#       跨模块任务取承载任务意图的模块，检索面由 kb-search 全文兜住）。
+# 建约定（2026-09-21 起新建文档必填，存量不回填——AI 触碰时顺手补）；非法模块值由消费方拒绝（pipeline-run triage 校验 / kb-search --module）。
+# 变更本表须同步 workflow/README.md「文档协议」段的说明文字。
+material
+purchase
+mto
+inventory
+masterdata
+baseData
+auth
+ui
+integration
+infra
+pipeline
+wiki
+shared

package/templates/profiles/dotnet/.agents/hooks/commit-check.config.json

@@ -0,0 +1,18 @@
+{
+  "_note": "checks 段曾空置（2026-10-29 本地减重）：前端 typecheck/lint 在本机实测 13.4s/7.4s，执法面下沉 CI 中档 verify --mid 与 pre-push 的 npm run build（内含 vue-tsc）。2026-11-10 起恢复在用：挂 dev-tour 模型测试门（node --test .agents/tests/*.test.mjs，实测 <3s），触发面限定 .agents/scripts/dev-tour* 与 .agents/tests/；commit-check.cjs 同日起 checks 面含 .agents/（引擎脚本变更照跑秒级检查）。2026-11-11 增 auto-tour 门（自动拉起看板脚本的单测，实测 0.85s），触发面 .agents/scripts/auto-tour。",
+  "builds": [
+    {
+      "name": "backend",
+      "command": "dotnet build Shipyard.Material.sln",
+      "ext": [".cs", ".sln", ".csproj"],
+      "lockPattern": "MSB3026|MSB3027",
+      "lockHint": "后端编译被文件锁拦下——8932 上的本地 API 正占用 bin 下 DLL（与代码无关）。处理：Stop-Process -Name Shipyard.Material.API -Force 后原路重试"
+    },
+    { "name": "frontend", "command": "npm run build", "cwd": "frontend", "prefix": "frontend/" }
+  ],
+  "checks": [
+    { "name": "dev-tour-model-tests", "command": "node --test .agents/tests/*.test.mjs", "prefix": ".agents/scripts/dev-tour" },
+    { "name": "auto-tour-tests", "command": "node --test .agents/tests/auto-tour.test.mjs", "prefix": ".agents/scripts/auto-tour" },
+    { "name": "dev-tour-tests-self", "command": "node --test .agents/tests/*.test.mjs", "prefix": ".agents/tests/" }
+  ]
+}

package/templates/profiles/dotnet/.agents/hooks/delete-guard-allowlist.txt

@@ -0,0 +1,28 @@
+Shipyard.Material.API/Controllers/MasterData/BasicCodeDefController.cs 2
+Shipyard.Material.Application/Services/Common/AttachmentMetadataHelper.cs 2
+Shipyard.Material.Application/Services/Common/DocumentAttachmentStore.cs 2
+Shipyard.Material.Application/Services/MasterData/Implementations/BaseCodeApplyService.cs 1
+Shipyard.Material.Application/Services/MasterData/Implementations/BuyerService.cs 4
+Shipyard.Material.Application/Services/MasterData/Implementations/CodeTemplateService.cs 3
+Shipyard.Material.Application/Services/MasterData/Implementations/DictItemService.cs 1
+Shipyard.Material.Application/Services/MasterData/Implementations/ExchangeRateService.cs 1
+Shipyard.Material.Application/Services/MasterData/Implementations/ExchangeRateTypeService.cs 1
+Shipyard.Material.Application/Services/MasterData/Implementations/ManagementSegmentService.cs 1
+Shipyard.Material.Application/Services/MasterData/Implementations/MaterialCodeService.cs 1
+Shipyard.Material.Application/Services/MasterData/Implementations/MeasurementService.cs 2
+Shipyard.Material.Application/Services/MasterData/Implementations/SupplierService.cs 3
+Shipyard.Material.Application/Services/MasterData/Implementations/WarehouseService.cs 3
+Shipyard.Material.Application/Services/Orders/Implementations/ArrivalOrderService.cs 5
+Shipyard.Material.Application/Services/Orders/Implementations/ComparisonService.cs 2
+Shipyard.Material.Application/Services/Orders/Implementations/InboundOrderService.cs 4
+Shipyard.Material.Application/Services/Orders/Implementations/MTOChangeService.cs 1
+Shipyard.Material.Application/Services/Orders/Implementations/MTOService.cs 13
+Shipyard.Material.Application/Services/Orders/Implementations/OutboundOrderService.cs 8
+Shipyard.Material.Application/Services/Orders/Implementations/OutboundRequestService.cs 5
+Shipyard.Material.Application/Services/Orders/Implementations/PurchaseContractDraftService.cs 1
+Shipyard.Material.Application/Services/Orders/Implementations/PurchaseContractTemplateService.cs 1
+Shipyard.Material.Application/Services/Orders/Implementations/PurchaseOrderService.cs 9
+Shipyard.Material.Application/Services/Orders/Implementations/PurchaseRequestService.cs 1
+Shipyard.Material.Application/Services/Orders/Implementations/SupplementRequestService.cs 2
+Shipyard.Material.Application/Services/Orders/Implementations/TransferOrderService.cs 4
+Shipyard.Material.Application/Services/PML/Implementations/PMLService.cs 11