soloforge 1.2.20 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (667) hide show
  1. package/README.md +140 -3
  2. package/dist/adapters/claude_code/claude_md.d.ts +1 -2
  3. package/dist/adapters/claude_code/claude_md.d.ts.map +1 -1
  4. package/dist/adapters/claude_code/claude_md.js +47 -4
  5. package/dist/adapters/claude_code/claude_md.js.map +1 -1
  6. package/dist/adapters/claude_code/hooks.d.ts.map +1 -1
  7. package/dist/adapters/claude_code/hooks.js +2 -1
  8. package/dist/adapters/claude_code/hooks.js.map +1 -1
  9. package/dist/adapters/claude_code/server.js +4 -3
  10. package/dist/adapters/claude_code/server.js.map +1 -1
  11. package/dist/adapters/claude_code/tools.d.ts +255 -1
  12. package/dist/adapters/claude_code/tools.d.ts.map +1 -1
  13. package/dist/adapters/claude_code/tools.js +855 -39
  14. package/dist/adapters/claude_code/tools.js.map +1 -1
  15. package/dist/adapters/codex/codex_config.d.ts.map +1 -1
  16. package/dist/adapters/codex/codex_config.js +3 -2
  17. package/dist/adapters/codex/codex_config.js.map +1 -1
  18. package/dist/adapters/codex/codex_rules.d.ts.map +1 -1
  19. package/dist/adapters/codex/codex_rules.js +2 -1
  20. package/dist/adapters/codex/codex_rules.js.map +1 -1
  21. package/dist/adapters/shared/workflow_template.d.ts.map +1 -1
  22. package/dist/adapters/shared/workflow_template.js +2 -1
  23. package/dist/adapters/shared/workflow_template.js.map +1 -1
  24. package/dist/adapters/trae/trae_config.d.ts +0 -5
  25. package/dist/adapters/trae/trae_config.d.ts.map +1 -1
  26. package/dist/adapters/trae/trae_config.js +2 -1
  27. package/dist/adapters/trae/trae_config.js.map +1 -1
  28. package/dist/adapters/trae/trae_rules.d.ts.map +1 -1
  29. package/dist/adapters/trae/trae_rules.js +2 -1
  30. package/dist/adapters/trae/trae_rules.js.map +1 -1
  31. package/dist/bin/config_commands.d.ts.map +1 -1
  32. package/dist/bin/config_commands.js +34 -33
  33. package/dist/bin/config_commands.js.map +1 -1
  34. package/dist/bin/soloforge.d.ts.map +1 -1
  35. package/dist/bin/soloforge.js +1110 -157
  36. package/dist/bin/soloforge.js.map +1 -1
  37. package/dist/engine/adapter_prompt_contract.d.ts +60 -0
  38. package/dist/engine/adapter_prompt_contract.d.ts.map +1 -0
  39. package/dist/engine/adapter_prompt_contract.js +163 -0
  40. package/dist/engine/adapter_prompt_contract.js.map +1 -0
  41. package/dist/engine/architecture_design_contract.d.ts +49 -0
  42. package/dist/engine/architecture_design_contract.d.ts.map +1 -0
  43. package/dist/engine/architecture_design_contract.js +169 -0
  44. package/dist/engine/architecture_design_contract.js.map +1 -0
  45. package/dist/engine/artifact_contract_registry.d.ts.map +1 -1
  46. package/dist/engine/artifact_contract_registry.js +7 -14
  47. package/dist/engine/artifact_contract_registry.js.map +1 -1
  48. package/dist/engine/{batch1_manifest.d.ts → asset_manifest.d.ts} +8 -8
  49. package/dist/engine/asset_manifest.d.ts.map +1 -0
  50. package/dist/engine/{batch1_manifest.js → asset_manifest.js} +52 -9
  51. package/dist/engine/asset_manifest.js.map +1 -0
  52. package/dist/engine/audit_pool.d.ts.map +1 -1
  53. package/dist/engine/audit_pool.js +5 -4
  54. package/dist/engine/audit_pool.js.map +1 -1
  55. package/dist/engine/audit_sampler.d.ts.map +1 -1
  56. package/dist/engine/audit_sampler.js +2 -1
  57. package/dist/engine/audit_sampler.js.map +1 -1
  58. package/dist/engine/audit_verifier.d.ts.map +1 -1
  59. package/dist/engine/audit_verifier.js +5 -4
  60. package/dist/engine/audit_verifier.js.map +1 -1
  61. package/dist/engine/brainstorm_contract.d.ts +46 -0
  62. package/dist/engine/brainstorm_contract.d.ts.map +1 -0
  63. package/dist/engine/brainstorm_contract.js +136 -0
  64. package/dist/engine/brainstorm_contract.js.map +1 -0
  65. package/dist/engine/capability_action_advisor.d.ts.map +1 -1
  66. package/dist/engine/capability_action_advisor.js +8 -7
  67. package/dist/engine/capability_action_advisor.js.map +1 -1
  68. package/dist/engine/capability_registry.d.ts.map +1 -1
  69. package/dist/engine/capability_registry.js +0 -7
  70. package/dist/engine/capability_registry.js.map +1 -1
  71. package/dist/engine/capability_state_store.d.ts.map +1 -1
  72. package/dist/engine/capability_state_store.js +7 -6
  73. package/dist/engine/capability_state_store.js.map +1 -1
  74. package/dist/engine/change_coordinator.d.ts.map +1 -1
  75. package/dist/engine/change_coordinator.js +4 -3
  76. package/dist/engine/change_coordinator.js.map +1 -1
  77. package/dist/engine/chinese_semantic_priority.d.ts +62 -0
  78. package/dist/engine/chinese_semantic_priority.d.ts.map +1 -0
  79. package/dist/engine/chinese_semantic_priority.js +153 -0
  80. package/dist/engine/chinese_semantic_priority.js.map +1 -0
  81. package/dist/engine/coding_readiness_gate.d.ts +46 -0
  82. package/dist/engine/coding_readiness_gate.d.ts.map +1 -0
  83. package/dist/engine/coding_readiness_gate.js +175 -0
  84. package/dist/engine/coding_readiness_gate.js.map +1 -0
  85. package/dist/engine/cognitive_anchor.d.ts.map +1 -1
  86. package/dist/engine/cognitive_anchor.js +7 -6
  87. package/dist/engine/cognitive_anchor.js.map +1 -1
  88. package/dist/engine/command_execution_contract.d.ts.map +1 -1
  89. package/dist/engine/command_execution_contract.js +13 -12
  90. package/dist/engine/command_execution_contract.js.map +1 -1
  91. package/dist/engine/confidence_scorer.d.ts.map +1 -1
  92. package/dist/engine/confidence_scorer.js +2 -1
  93. package/dist/engine/confidence_scorer.js.map +1 -1
  94. package/dist/engine/config_precedence_contract.d.ts.map +1 -1
  95. package/dist/engine/config_precedence_contract.js +9 -8
  96. package/dist/engine/config_precedence_contract.js.map +1 -1
  97. package/dist/engine/conflict_gate.d.ts.map +1 -1
  98. package/dist/engine/conflict_gate.js +4 -3
  99. package/dist/engine/conflict_gate.js.map +1 -1
  100. package/dist/engine/consumable_asset_registry.d.ts +4 -0
  101. package/dist/engine/consumable_asset_registry.d.ts.map +1 -1
  102. package/dist/engine/consumable_asset_registry.js +307 -0
  103. package/dist/engine/consumable_asset_registry.js.map +1 -1
  104. package/dist/engine/consumption_trace_store.d.ts +50 -0
  105. package/dist/engine/consumption_trace_store.d.ts.map +1 -0
  106. package/dist/engine/consumption_trace_store.js +84 -0
  107. package/dist/engine/consumption_trace_store.js.map +1 -0
  108. package/dist/engine/contract_guard.d.ts.map +1 -1
  109. package/dist/engine/contract_guard.js +7 -6
  110. package/dist/engine/contract_guard.js.map +1 -1
  111. package/dist/engine/contract_registry.d.ts +1 -1
  112. package/dist/engine/contract_registry.d.ts.map +1 -1
  113. package/dist/engine/contract_registry.js +511 -38
  114. package/dist/engine/contract_registry.js.map +1 -1
  115. package/dist/engine/convention_detector.d.ts.map +1 -1
  116. package/dist/engine/convention_detector.js +4 -3
  117. package/dist/engine/convention_detector.js.map +1 -1
  118. package/dist/engine/core_engineering_principles.d.ts.map +1 -1
  119. package/dist/engine/core_engineering_principles.js +4 -14
  120. package/dist/engine/core_engineering_principles.js.map +1 -1
  121. package/dist/engine/core_experience_principle.d.ts +194 -0
  122. package/dist/engine/core_experience_principle.d.ts.map +1 -0
  123. package/dist/engine/core_experience_principle.js +349 -0
  124. package/dist/engine/core_experience_principle.js.map +1 -0
  125. package/dist/engine/debt_reporter.d.ts.map +1 -1
  126. package/dist/engine/debt_reporter.js +3 -2
  127. package/dist/engine/debt_reporter.js.map +1 -1
  128. package/dist/engine/debt_tracker.d.ts.map +1 -1
  129. package/dist/engine/debt_tracker.js +8 -7
  130. package/dist/engine/debt_tracker.js.map +1 -1
  131. package/dist/engine/debug_log.d.ts +4 -1
  132. package/dist/engine/debug_log.d.ts.map +1 -1
  133. package/dist/engine/debug_log.js +4 -6
  134. package/dist/engine/debug_log.js.map +1 -1
  135. package/dist/engine/debugger.d.ts.map +1 -1
  136. package/dist/engine/debugger.js +5 -4
  137. package/dist/engine/debugger.js.map +1 -1
  138. package/dist/engine/decision_contract.d.ts.map +1 -1
  139. package/dist/engine/decision_contract.js +4 -3
  140. package/dist/engine/decision_contract.js.map +1 -1
  141. package/dist/engine/delivery.d.ts.map +1 -1
  142. package/dist/engine/delivery.js +16 -15
  143. package/dist/engine/delivery.js.map +1 -1
  144. package/dist/engine/delivery_readiness.d.ts +5 -1
  145. package/dist/engine/delivery_readiness.d.ts.map +1 -1
  146. package/dist/engine/delivery_readiness.js +24 -2
  147. package/dist/engine/delivery_readiness.js.map +1 -1
  148. package/dist/engine/dependency_scanner.d.ts.map +1 -1
  149. package/dist/engine/dependency_scanner.js +6 -5
  150. package/dist/engine/dependency_scanner.js.map +1 -1
  151. package/dist/engine/detail_discipline.d.ts +40 -0
  152. package/dist/engine/detail_discipline.d.ts.map +1 -0
  153. package/dist/engine/detail_discipline.js +107 -0
  154. package/dist/engine/detail_discipline.js.map +1 -0
  155. package/dist/engine/developer_sovereignty.d.ts.map +1 -1
  156. package/dist/engine/developer_sovereignty.js +6 -5
  157. package/dist/engine/developer_sovereignty.js.map +1 -1
  158. package/dist/engine/diff_ownership.d.ts.map +1 -1
  159. package/dist/engine/diff_ownership.js +9 -8
  160. package/dist/engine/diff_ownership.js.map +1 -1
  161. package/dist/engine/diff_ownership_store.d.ts.map +1 -1
  162. package/dist/engine/diff_ownership_store.js +8 -7
  163. package/dist/engine/diff_ownership_store.js.map +1 -1
  164. package/dist/engine/documentation_governance.d.ts +55 -0
  165. package/dist/engine/documentation_governance.d.ts.map +1 -0
  166. package/dist/engine/documentation_governance.js +249 -0
  167. package/dist/engine/documentation_governance.js.map +1 -0
  168. package/dist/engine/dual_layer_mechanism_registry.d.ts +6 -4
  169. package/dist/engine/dual_layer_mechanism_registry.d.ts.map +1 -1
  170. package/dist/engine/dual_layer_mechanism_registry.js +731 -11
  171. package/dist/engine/dual_layer_mechanism_registry.js.map +1 -1
  172. package/dist/engine/enforcement_guard.d.ts.map +1 -1
  173. package/dist/engine/enforcement_guard.js +14 -0
  174. package/dist/engine/enforcement_guard.js.map +1 -1
  175. package/dist/engine/escape_report.d.ts.map +1 -1
  176. package/dist/engine/escape_report.js +4 -3
  177. package/dist/engine/escape_report.js.map +1 -1
  178. package/dist/engine/evolution_regression_gate.d.ts +42 -0
  179. package/dist/engine/evolution_regression_gate.d.ts.map +1 -0
  180. package/dist/engine/evolution_regression_gate.js +159 -0
  181. package/dist/engine/evolution_regression_gate.js.map +1 -0
  182. package/dist/engine/existing_system_analysis.d.ts +37 -0
  183. package/dist/engine/existing_system_analysis.d.ts.map +1 -0
  184. package/dist/engine/existing_system_analysis.js +151 -0
  185. package/dist/engine/existing_system_analysis.js.map +1 -0
  186. package/dist/engine/exploration.d.ts.map +1 -1
  187. package/dist/engine/exploration.js +7 -6
  188. package/dist/engine/exploration.js.map +1 -1
  189. package/dist/engine/extension_contract.d.ts +50 -0
  190. package/dist/engine/extension_contract.d.ts.map +1 -0
  191. package/dist/engine/extension_contract.js +158 -0
  192. package/dist/engine/extension_contract.js.map +1 -0
  193. package/dist/engine/extension_platform_contracts.d.ts +712 -0
  194. package/dist/engine/extension_platform_contracts.d.ts.map +1 -0
  195. package/dist/engine/extension_platform_contracts.js +42 -0
  196. package/dist/engine/extension_platform_contracts.js.map +1 -0
  197. package/dist/engine/extension_scenario_registry.d.ts +30 -0
  198. package/dist/engine/extension_scenario_registry.d.ts.map +1 -0
  199. package/dist/engine/extension_scenario_registry.js +976 -0
  200. package/dist/engine/extension_scenario_registry.js.map +1 -0
  201. package/dist/engine/failure_classifier.d.ts.map +1 -1
  202. package/dist/engine/failure_classifier.js +9 -8
  203. package/dist/engine/failure_classifier.js.map +1 -1
  204. package/dist/engine/feasibility_checker.d.ts.map +1 -1
  205. package/dist/engine/feasibility_checker.js +5 -4
  206. package/dist/engine/feasibility_checker.js.map +1 -1
  207. package/dist/engine/first_principles.d.ts +35 -0
  208. package/dist/engine/first_principles.d.ts.map +1 -0
  209. package/dist/engine/first_principles.js +128 -0
  210. package/dist/engine/first_principles.js.map +1 -0
  211. package/dist/engine/{batch1_scenario_registry.d.ts → foundation_scenario_registry.d.ts} +15 -15
  212. package/dist/engine/foundation_scenario_registry.d.ts.map +1 -0
  213. package/dist/engine/{batch1_scenario_registry.js → foundation_scenario_registry.js} +22 -25
  214. package/dist/engine/foundation_scenario_registry.js.map +1 -0
  215. package/dist/engine/{batch1_scenario_runners.d.ts → foundation_scenario_runners.d.ts} +1 -1
  216. package/dist/engine/foundation_scenario_runners.d.ts.map +1 -0
  217. package/dist/engine/{batch1_scenario_runners.js → foundation_scenario_runners.js} +8 -7
  218. package/dist/engine/foundation_scenario_runners.js.map +1 -0
  219. package/dist/engine/git_deps.d.ts.map +1 -1
  220. package/dist/engine/git_deps.js +2 -1
  221. package/dist/engine/git_deps.js.map +1 -1
  222. package/dist/engine/governance_report.d.ts.map +1 -1
  223. package/dist/engine/governance_report.js +10 -9
  224. package/dist/engine/governance_report.js.map +1 -1
  225. package/dist/engine/impact_analyzer.d.ts.map +1 -1
  226. package/dist/engine/impact_analyzer.js +5 -4
  227. package/dist/engine/impact_analyzer.js.map +1 -1
  228. package/dist/engine/implementation_roadmap_registry.d.ts.map +1 -1
  229. package/dist/engine/implementation_roadmap_registry.js +217 -80
  230. package/dist/engine/implementation_roadmap_registry.js.map +1 -1
  231. package/dist/engine/input_material_contract_registry.d.ts.map +1 -1
  232. package/dist/engine/input_material_contract_registry.js +4 -3
  233. package/dist/engine/input_material_contract_registry.js.map +1 -1
  234. package/dist/engine/instruction_contract.d.ts +68 -0
  235. package/dist/engine/instruction_contract.d.ts.map +1 -0
  236. package/dist/engine/instruction_contract.js +123 -0
  237. package/dist/engine/instruction_contract.js.map +1 -0
  238. package/dist/engine/intent_expander.d.ts.map +1 -1
  239. package/dist/engine/intent_expander.js +339 -1
  240. package/dist/engine/intent_expander.js.map +1 -1
  241. package/dist/engine/intent_router.d.ts +11 -2
  242. package/dist/engine/intent_router.d.ts.map +1 -1
  243. package/dist/engine/intent_router.js +121 -1
  244. package/dist/engine/intent_router.js.map +1 -1
  245. package/dist/engine/intent_signal_extractor.d.ts +3 -0
  246. package/dist/engine/intent_signal_extractor.d.ts.map +1 -1
  247. package/dist/engine/intent_signal_extractor.js +49 -0
  248. package/dist/engine/intent_signal_extractor.js.map +1 -1
  249. package/dist/engine/io_controller.d.ts.map +1 -1
  250. package/dist/engine/io_controller.js +8 -7
  251. package/dist/engine/io_controller.js.map +1 -1
  252. package/dist/engine/java_quality_guard.d.ts.map +1 -1
  253. package/dist/engine/java_quality_guard.js +5 -18
  254. package/dist/engine/java_quality_guard.js.map +1 -1
  255. package/dist/engine/job_manager.d.ts.map +1 -1
  256. package/dist/engine/job_manager.js +8 -7
  257. package/dist/engine/job_manager.js.map +1 -1
  258. package/dist/engine/knowledge_acceptance_registry.d.ts +35 -0
  259. package/dist/engine/knowledge_acceptance_registry.d.ts.map +1 -0
  260. package/dist/engine/knowledge_acceptance_registry.js +271 -0
  261. package/dist/engine/knowledge_acceptance_registry.js.map +1 -0
  262. package/dist/engine/knowledge_asset_audit.d.ts +65 -0
  263. package/dist/engine/knowledge_asset_audit.d.ts.map +1 -0
  264. package/dist/engine/knowledge_asset_audit.js +230 -0
  265. package/dist/engine/knowledge_asset_audit.js.map +1 -0
  266. package/dist/engine/knowledge_asset_consumer.d.ts +150 -0
  267. package/dist/engine/knowledge_asset_consumer.d.ts.map +1 -0
  268. package/dist/engine/knowledge_asset_consumer.js +279 -0
  269. package/dist/engine/knowledge_asset_consumer.js.map +1 -0
  270. package/dist/engine/knowledge_asset_generation_gate.d.ts +38 -0
  271. package/dist/engine/knowledge_asset_generation_gate.d.ts.map +1 -0
  272. package/dist/engine/knowledge_asset_generation_gate.js +131 -0
  273. package/dist/engine/knowledge_asset_generation_gate.js.map +1 -0
  274. package/dist/engine/knowledge_asset_migration.d.ts +117 -0
  275. package/dist/engine/knowledge_asset_migration.d.ts.map +1 -0
  276. package/dist/engine/knowledge_asset_migration.js +204 -0
  277. package/dist/engine/knowledge_asset_migration.js.map +1 -0
  278. package/dist/engine/knowledge_asset_schema.d.ts +97 -0
  279. package/dist/engine/knowledge_asset_schema.d.ts.map +1 -0
  280. package/dist/engine/knowledge_asset_schema.js +413 -0
  281. package/dist/engine/knowledge_asset_schema.js.map +1 -0
  282. package/dist/engine/knowledge_config_loader.d.ts.map +1 -1
  283. package/dist/engine/knowledge_config_loader.js +5 -4
  284. package/dist/engine/knowledge_config_loader.js.map +1 -1
  285. package/dist/engine/knowledge_consumption_snapshot.d.ts +91 -0
  286. package/dist/engine/knowledge_consumption_snapshot.d.ts.map +1 -0
  287. package/dist/engine/knowledge_consumption_snapshot.js +113 -0
  288. package/dist/engine/knowledge_consumption_snapshot.js.map +1 -0
  289. package/dist/engine/knowledge_evolution.d.ts +82 -0
  290. package/dist/engine/knowledge_evolution.d.ts.map +1 -0
  291. package/dist/engine/knowledge_evolution.js +272 -0
  292. package/dist/engine/knowledge_evolution.js.map +1 -0
  293. package/dist/engine/knowledge_lifecycle.d.ts +70 -10
  294. package/dist/engine/knowledge_lifecycle.d.ts.map +1 -1
  295. package/dist/engine/knowledge_lifecycle.js +238 -4
  296. package/dist/engine/knowledge_lifecycle.js.map +1 -1
  297. package/dist/engine/knowledge_manager.d.ts.map +1 -1
  298. package/dist/engine/knowledge_manager.js +9 -8
  299. package/dist/engine/knowledge_manager.js.map +1 -1
  300. package/dist/engine/knowledge_scenario_registry.d.ts +21 -0
  301. package/dist/engine/knowledge_scenario_registry.d.ts.map +1 -0
  302. package/dist/engine/knowledge_scenario_registry.js +337 -0
  303. package/dist/engine/knowledge_scenario_registry.js.map +1 -0
  304. package/dist/engine/knowledge_sovereignty.d.ts.map +1 -1
  305. package/dist/engine/knowledge_sovereignty.js +5 -4
  306. package/dist/engine/knowledge_sovereignty.js.map +1 -1
  307. package/dist/engine/knowledge_template_contracts.d.ts +244 -0
  308. package/dist/engine/knowledge_template_contracts.d.ts.map +1 -0
  309. package/dist/engine/knowledge_template_contracts.js +26 -0
  310. package/dist/engine/knowledge_template_contracts.js.map +1 -0
  311. package/dist/engine/language_policy.d.ts +69 -12
  312. package/dist/engine/language_policy.d.ts.map +1 -1
  313. package/dist/engine/language_policy.js +129 -8
  314. package/dist/engine/language_policy.js.map +1 -1
  315. package/dist/engine/llm_gateway.d.ts.map +1 -1
  316. package/dist/engine/llm_gateway.js +10 -9
  317. package/dist/engine/llm_gateway.js.map +1 -1
  318. package/dist/engine/local_docker_acceptance.d.ts +94 -0
  319. package/dist/engine/local_docker_acceptance.d.ts.map +1 -0
  320. package/dist/engine/local_docker_acceptance.js +312 -0
  321. package/dist/engine/local_docker_acceptance.js.map +1 -0
  322. package/dist/engine/logger.d.ts +64 -0
  323. package/dist/engine/logger.d.ts.map +1 -0
  324. package/dist/engine/logger.js +115 -0
  325. package/dist/engine/logger.js.map +1 -0
  326. package/dist/engine/main_path_integration_contract.d.ts.map +1 -1
  327. package/dist/engine/main_path_integration_contract.js +43 -42
  328. package/dist/engine/main_path_integration_contract.js.map +1 -1
  329. package/dist/engine/mechanism_contract_registry.d.ts.map +1 -1
  330. package/dist/engine/mechanism_contract_registry.js +448 -17
  331. package/dist/engine/mechanism_contract_registry.js.map +1 -1
  332. package/dist/engine/metric_governance.d.ts +51 -0
  333. package/dist/engine/metric_governance.d.ts.map +1 -0
  334. package/dist/engine/metric_governance.js +138 -0
  335. package/dist/engine/metric_governance.js.map +1 -0
  336. package/dist/engine/migration_guard.d.ts.map +1 -1
  337. package/dist/engine/migration_guard.js +6 -5
  338. package/dist/engine/migration_guard.js.map +1 -1
  339. package/dist/engine/mutation_audit.d.ts.map +1 -1
  340. package/dist/engine/mutation_audit.js +6 -5
  341. package/dist/engine/mutation_audit.js.map +1 -1
  342. package/dist/engine/observability.d.ts +11 -0
  343. package/dist/engine/observability.d.ts.map +1 -1
  344. package/dist/engine/observability.js +60 -8
  345. package/dist/engine/observability.js.map +1 -1
  346. package/dist/engine/onboarding.d.ts.map +1 -1
  347. package/dist/engine/onboarding.js +17 -16
  348. package/dist/engine/onboarding.js.map +1 -1
  349. package/dist/engine/plan_proposal_gate.d.ts +131 -0
  350. package/dist/engine/plan_proposal_gate.d.ts.map +1 -0
  351. package/dist/engine/plan_proposal_gate.js +340 -0
  352. package/dist/engine/plan_proposal_gate.js.map +1 -0
  353. package/dist/engine/platform_context.d.ts +44 -0
  354. package/dist/engine/platform_context.d.ts.map +1 -0
  355. package/dist/engine/platform_context.js +165 -0
  356. package/dist/engine/platform_context.js.map +1 -0
  357. package/dist/engine/policy_drift_detector.d.ts.map +1 -1
  358. package/dist/engine/policy_drift_detector.js +8 -7
  359. package/dist/engine/policy_drift_detector.js.map +1 -1
  360. package/dist/engine/regression_matrix.d.ts.map +1 -1
  361. package/dist/engine/regression_matrix.js +15 -14
  362. package/dist/engine/regression_matrix.js.map +1 -1
  363. package/dist/engine/release_compatibility.d.ts +62 -0
  364. package/dist/engine/release_compatibility.d.ts.map +1 -0
  365. package/dist/engine/release_compatibility.js +145 -0
  366. package/dist/engine/release_compatibility.js.map +1 -0
  367. package/dist/engine/release_gate.d.ts +29 -0
  368. package/dist/engine/release_gate.d.ts.map +1 -0
  369. package/dist/engine/release_gate.js +675 -0
  370. package/dist/engine/release_gate.js.map +1 -0
  371. package/dist/engine/release_gate_scenario_registry.d.ts +50 -0
  372. package/dist/engine/release_gate_scenario_registry.d.ts.map +1 -0
  373. package/dist/engine/release_gate_scenario_registry.js +514 -0
  374. package/dist/engine/release_gate_scenario_registry.js.map +1 -0
  375. package/dist/engine/release_readiness_gate.d.ts +36 -0
  376. package/dist/engine/release_readiness_gate.d.ts.map +1 -0
  377. package/dist/engine/release_readiness_gate.js +1050 -0
  378. package/dist/engine/release_readiness_gate.js.map +1 -0
  379. package/dist/engine/risk_sampler.d.ts.map +1 -1
  380. package/dist/engine/risk_sampler.js +4 -3
  381. package/dist/engine/risk_sampler.js.map +1 -1
  382. package/dist/engine/runtime_safety.d.ts.map +1 -1
  383. package/dist/engine/runtime_safety.js +18 -17
  384. package/dist/engine/runtime_safety.js.map +1 -1
  385. package/dist/engine/scaffolder.d.ts.map +1 -1
  386. package/dist/engine/scaffolder.js +4 -3
  387. package/dist/engine/scaffolder.js.map +1 -1
  388. package/dist/engine/scope_lease.d.ts.map +1 -1
  389. package/dist/engine/scope_lease.js +4 -3
  390. package/dist/engine/scope_lease.js.map +1 -1
  391. package/dist/engine/semantic_evidence.d.ts.map +1 -1
  392. package/dist/engine/semantic_evidence.js +4 -3
  393. package/dist/engine/semantic_evidence.js.map +1 -1
  394. package/dist/engine/state_fact_classifier.d.ts +47 -0
  395. package/dist/engine/state_fact_classifier.d.ts.map +1 -0
  396. package/dist/engine/state_fact_classifier.js +158 -0
  397. package/dist/engine/state_fact_classifier.js.map +1 -0
  398. package/dist/engine/task_context.d.ts +25 -3
  399. package/dist/engine/task_context.d.ts.map +1 -1
  400. package/dist/engine/task_context.js +126 -37
  401. package/dist/engine/task_context.js.map +1 -1
  402. package/dist/engine/task_planner.d.ts.map +1 -1
  403. package/dist/engine/task_planner.js +6 -5
  404. package/dist/engine/task_planner.js.map +1 -1
  405. package/dist/engine/team_awareness.d.ts.map +1 -1
  406. package/dist/engine/team_awareness.js +2 -1
  407. package/dist/engine/team_awareness.js.map +1 -1
  408. package/dist/engine/technology_decision.d.ts +38 -0
  409. package/dist/engine/technology_decision.d.ts.map +1 -0
  410. package/dist/engine/technology_decision.js +120 -0
  411. package/dist/engine/technology_decision.js.map +1 -0
  412. package/dist/engine/template_manifest_io.d.ts +47 -0
  413. package/dist/engine/template_manifest_io.d.ts.map +1 -0
  414. package/dist/engine/template_manifest_io.js +151 -0
  415. package/dist/engine/template_manifest_io.js.map +1 -0
  416. package/dist/engine/template_mechanism_auditor.d.ts.map +1 -1
  417. package/dist/engine/template_mechanism_auditor.js +5 -4
  418. package/dist/engine/template_mechanism_auditor.js.map +1 -1
  419. package/dist/engine/template_sync.d.ts +98 -0
  420. package/dist/engine/template_sync.d.ts.map +1 -0
  421. package/dist/engine/template_sync.js +355 -0
  422. package/dist/engine/template_sync.js.map +1 -0
  423. package/dist/engine/test_generator.d.ts.map +1 -1
  424. package/dist/engine/test_generator.js +5 -4
  425. package/dist/engine/test_generator.js.map +1 -1
  426. package/dist/engine/test_quality.d.ts.map +1 -1
  427. package/dist/engine/test_quality.js +5 -4
  428. package/dist/engine/test_quality.js.map +1 -1
  429. package/dist/engine/tool_invocation_contract_registry.d.ts.map +1 -1
  430. package/dist/engine/tool_invocation_contract_registry.js +32 -31
  431. package/dist/engine/tool_invocation_contract_registry.js.map +1 -1
  432. package/dist/engine/traceability.d.ts.map +1 -1
  433. package/dist/engine/traceability.js +6 -5
  434. package/dist/engine/traceability.js.map +1 -1
  435. package/dist/engine/user_feedback_contract.d.ts.map +1 -1
  436. package/dist/engine/user_feedback_contract.js +81 -19
  437. package/dist/engine/user_feedback_contract.js.map +1 -1
  438. package/dist/engine/user_promise.d.ts +67 -0
  439. package/dist/engine/user_promise.d.ts.map +1 -0
  440. package/dist/engine/user_promise.js +436 -0
  441. package/dist/engine/user_promise.js.map +1 -0
  442. package/dist/engine/verifier.d.ts +6 -10
  443. package/dist/engine/verifier.d.ts.map +1 -1
  444. package/dist/engine/verifier.js +149 -1
  445. package/dist/engine/verifier.js.map +1 -1
  446. package/dist/engine/workflow_contract_registry.d.ts.map +1 -1
  447. package/dist/engine/workflow_contract_registry.js +127 -10
  448. package/dist/engine/workflow_contract_registry.js.map +1 -1
  449. package/dist/engine/workflow_template_pack.d.ts +71 -0
  450. package/dist/engine/workflow_template_pack.d.ts.map +1 -0
  451. package/dist/engine/workflow_template_pack.js +246 -0
  452. package/dist/engine/workflow_template_pack.js.map +1 -0
  453. package/dist/engine/workspace_resumer.d.ts.map +1 -1
  454. package/dist/engine/workspace_resumer.js +9 -8
  455. package/dist/engine/workspace_resumer.js.map +1 -1
  456. package/dist/engine/zero_config_init.d.ts.map +1 -1
  457. package/dist/engine/zero_config_init.js +16 -15
  458. package/dist/engine/zero_config_init.js.map +1 -1
  459. package/dist/git/operations.d.ts.map +1 -1
  460. package/dist/git/operations.js +18 -17
  461. package/dist/git/operations.js.map +1 -1
  462. package/dist/index.js +10 -9
  463. package/dist/index.js.map +1 -1
  464. package/dist/knowledge/conflict_detector.d.ts.map +1 -1
  465. package/dist/knowledge/conflict_detector.js +2 -1
  466. package/dist/knowledge/conflict_detector.js.map +1 -1
  467. package/dist/knowledge/health_checker.d.ts.map +1 -1
  468. package/dist/knowledge/health_checker.js +5 -4
  469. package/dist/knowledge/health_checker.js.map +1 -1
  470. package/dist/knowledge/index_manager.js +4 -4
  471. package/dist/knowledge/index_manager.js.map +1 -1
  472. package/dist/knowledge/loader.d.ts.map +1 -1
  473. package/dist/knowledge/loader.js +20 -14
  474. package/dist/knowledge/loader.js.map +1 -1
  475. package/dist/knowledge/writer.d.ts.map +1 -1
  476. package/dist/knowledge/writer.js +7 -6
  477. package/dist/knowledge/writer.js.map +1 -1
  478. package/dist/types.d.ts +28 -8
  479. package/dist/types.d.ts.map +1 -1
  480. package/package.json +13 -5
  481. package/templates/knowledge/acceptance_templates/Bug/345/210/206/346/236/220/346/250/241/347/211/210.md +27 -3
  482. package/templates/knowledge/acceptance_templates/POC/347/273/223/350/256/272/346/250/241/347/211/210.md +27 -3
  483. package/templates/knowledge/acceptance_templates//345/211/215/347/253/257/351/241/265/351/235/242/351/252/214/346/224/266/346/270/205/345/215/225.md +30 -3
  484. package/templates/knowledge/acceptance_templates//345/216/237/345/236/213/350/257/264/346/230/216/346/250/241/347/211/210.md +31 -3
  485. package/templates/knowledge/acceptance_templates//345/220/216/347/253/257API/351/252/214/346/224/266/346/270/205/345/215/225.md +29 -3
  486. package/templates/knowledge/acceptance_templates//345/256/211/345/205/250/345/256/241/350/256/241/346/250/241/347/211/210.md +27 -3
  487. package/templates/knowledge/acceptance_templates//346/200/247/350/203/275/345/210/206/346/236/220/346/250/241/347/211/210.md +27 -3
  488. package/templates/knowledge/acceptance_templates//346/212/200/346/234/257/351/200/211/345/236/213/351/252/214/346/224/266/346/270/205/345/215/225.md +30 -3
  489. package/templates/knowledge/acceptance_templates//346/216/245/345/217/243/345/257/271/346/216/245/346/226/271/346/241/210/346/250/241/347/211/210.md +26 -3
  490. package/templates/knowledge/acceptance_templates//346/216/245/345/217/243/350/256/276/350/256/241/346/250/241/347/211/210.md +27 -3
  491. package/templates/knowledge/acceptance_templates//346/225/205/351/232/234/345/244/215/347/233/230/346/250/241/347/211/210.md +28 -3
  492. package/templates/knowledge/acceptance_templates//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264/346/226/271/346/241/210/346/250/241/347/211/210.md +26 -3
  493. package/templates/knowledge/acceptance_templates//346/225/260/346/215/256/345/272/223/345/217/230/346/233/264/351/252/214/346/224/266/346/270/205/345/215/225.md +31 -3
  494. package/templates/knowledge/acceptance_templates//346/236/266/346/236/204/350/256/276/350/256/241/346/250/241/347/211/210.md +27 -3
  495. package/templates/knowledge/acceptance_templates//346/265/213/350/257/225/350/256/241/345/210/222/346/250/241/347/211/210.md +27 -3
  496. package/templates/knowledge/acceptance_templates//350/257/246/347/273/206/350/256/276/350/256/241/346/250/241/347/211/210.md +26 -3
  497. package/templates/knowledge/acceptance_templates//350/277/201/347/247/273/350/257/204/344/274/260/346/250/241/347/211/210.md +27 -3
  498. package/templates/knowledge/acceptance_templates//351/200/232/347/224/250/350/264/250/351/207/217/351/252/214/346/224/266/346/270/205/345/215/225.md +30 -3
  499. package/templates/knowledge/acceptance_templates//351/207/215/346/236/204/346/226/271/346/241/210/346/250/241/347/211/210.md +27 -3
  500. package/templates/knowledge/acceptance_templates//351/234/200/346/261/202/345/210/206/346/236/220/346/250/241/347/211/210.md +27 -3
  501. package/templates/knowledge/checklists//344/270/273/351/223/276/350/267/257/346/216/245/345/205/245/351/252/214/346/224/266/346/270/205/345/215/225.md +29 -0
  502. package/templates/knowledge/checklists//344/274/232/350/257/235/346/201/242/345/244/215.md +30 -8
  503. package/templates/knowledge/checklists//345/267/245/344/275/234/346/265/201/351/252/214/346/224/266/346/270/205/345/215/225.md +30 -0
  504. package/templates/knowledge/checklists//346/240/270/345/277/203/345/267/245/347/250/213/346/211/247/350/241/214/351/252/214/346/224/266/346/270/205/345/215/225.md +29 -0
  505. package/templates/knowledge/checklists//347/237/245/350/257/206/346/263/250/345/205/245/351/252/214/346/224/266/346/270/205/345/215/225.md +30 -0
  506. package/templates/knowledge/checklists//351/232/220/347/247/201/345/256/241/346/237/245/346/270/205/345/215/225.md +29 -0
  507. package/templates/knowledge/checklists//351/252/214/350/257/201/351/252/214/346/224/266/346/270/205/345/215/225.md +29 -0
  508. package/templates/knowledge/domain//345/244/232/347/247/237/346/210/267.md +28 -3
  509. package/templates/knowledge/domain//345/256/241/350/256/241/346/227/245/345/277/227.md +27 -3
  510. package/templates/knowledge/domain//345/257/274/345/205/245/345/257/274/345/207/272/350/247/204/345/210/231.md +30 -3
  511. package/templates/knowledge/domain//345/267/245/344/275/234/346/265/201/345/274/225/346/223/216.md +32 -3
  512. package/templates/knowledge/domain//346/212/245/350/241/250/347/273/237/350/256/241.md +31 -3
  513. package/templates/knowledge/domain//346/224/257/344/273/230/350/247/204/345/210/231.md +31 -3
  514. package/templates/knowledge/domain//346/225/260/346/215/256/346/235/203/351/231/220.md +28 -3
  515. package/templates/knowledge/domain//351/200/232/347/224/250/346/234/272/346/242/260/346/235/241/346/254/276.md +30 -3
  516. package/templates/knowledge/domain//351/200/232/347/237/245/350/247/204/345/210/231.md +31 -3
  517. package/templates/knowledge/patterns/core/Diff/345/275/222/345/261/236/350/277/275/350/270/252.md +24 -7
  518. package/templates/knowledge/patterns/core/Java/350/264/250/351/207/217/351/227/250/347/246/201.md +25 -7
  519. package/templates/knowledge/patterns/core/LLM/351/242/204/347/256/227/347/275/221/345/205/263.md +24 -7
  520. package/templates/knowledge/patterns/core//344/273/273/345/212/241/344/270/212/344/270/213/346/226/207/347/224/237/345/221/275/345/221/250/346/234/237.md +24 -7
  521. package/templates/knowledge/patterns/core//344/273/273/345/212/241/347/256/241/347/220/206/345/231/250.md +25 -7
  522. package/templates/knowledge/patterns/core//344/275/234/347/224/250/345/237/237/344/270/216/345/257/206/351/222/245/346/213/246/346/210/252.md +24 -7
  523. package/templates/knowledge/patterns/core//344/275/234/347/224/250/345/237/237/347/247/237/347/272/246.md +25 -7
  524. package/templates/knowledge/patterns/core//345/206/262/347/252/201/351/227/250/347/246/201.md +24 -7
  525. package/templates/knowledge/patterns/core//345/206/263/347/255/226/347/275/221/345/205/263.md +26 -7
  526. package/templates/knowledge/patterns/core//345/217/230/345/274/202/345/256/241/350/256/241.md +25 -7
  527. package/templates/knowledge/patterns/core//345/233/236/345/275/222/347/237/251/351/230/265.md +24 -7
  528. package/templates/knowledge/patterns/core//345/267/245/344/275/234/345/214/272/344/272/222/346/226/245/351/224/201.md +24 -7
  529. package/templates/knowledge/patterns/core//345/267/245/344/275/234/345/214/272/345/224/244/351/206/222.md +24 -7
  530. package/templates/knowledge/patterns/core//345/271/266/345/217/221/351/224/201.md +26 -7
  531. package/templates/knowledge/patterns/core//345/274/200/345/217/221/350/200/205/345/256/252/346/263/225.md +26 -7
  532. package/templates/knowledge/patterns/core//346/225/217/346/204/237/344/277/241/346/201/257/346/211/253/346/217/217.md +24 -7
  533. package/templates/knowledge/patterns/core//346/262/273/347/220/206/350/277/220/350/241/214/346/227/266/345/276/252/347/216/257.md +25 -7
  534. package/templates/knowledge/patterns/core//346/265/201/345/274/217/345/277/203/350/267/263.md +25 -7
  535. package/templates/knowledge/patterns/core//347/237/245/350/257/206/344/270/273/346/235/203.md +25 -7
  536. package/templates/knowledge/patterns/core//350/257/255/344/271/211/350/257/201/346/215/256.md +24 -7
  537. package/templates/knowledge/patterns/core//350/277/220/350/241/214/345/256/211/345/205/250/345/214/205.md +25 -7
  538. package/templates/knowledge/patterns/core//351/233/266/351/205/215/347/275/256/345/210/235/345/247/213/345/214/226.md +24 -7
  539. package/templates/knowledge/patterns/core//351/252/214/350/257/201/345/221/275/344/273/244/347/224/237/346/210/220.md +24 -7
  540. package/templates/knowledge/procedures/Schema/345/217/230/346/233/264/346/265/201/346/260/264/347/272/277.md +29 -3
  541. package/templates/knowledge/procedures//344/270/273/351/223/276/350/267/257/346/216/245/345/205/245/351/252/214/350/257/201/346/265/201/347/250/213.md +33 -0
  542. package/templates/knowledge/procedures//344/273/243/347/240/201/351/227/250/347/246/201/346/265/201/347/250/213.md +30 -3
  543. package/templates/knowledge/procedures//344/273/273/345/212/241/346/213/206/350/247/243/346/265/201/347/250/213.md +30 -3
  544. package/templates/knowledge/procedures//345/212/237/350/203/275/345/274/200/345/217/221/346/265/201/347/250/213.md +30 -3
  545. package/templates/knowledge/procedures//345/221/275/344/273/244/346/211/247/350/241/214/346/265/201/347/250/213.md +34 -0
  546. package/templates/knowledge/procedures//345/256/211/345/205/250/345/212/240/345/233/272/346/265/201/346/260/264/347/272/277.md +30 -3
  547. package/templates/knowledge/procedures//345/267/245/345/205/267/350/260/203/347/224/250/346/265/201/347/250/213.md +34 -0
  548. package/templates/knowledge/procedures//346/200/247/350/203/275/346/265/201/346/260/264/347/272/277.md +30 -3
  549. package/templates/knowledge/procedures//346/204/217/345/233/276/350/267/257/347/224/261/346/265/201/347/250/213.md +34 -0
  550. package/templates/knowledge/procedures//346/216/245/345/217/243/351/233/206/346/210/220/346/265/201/346/260/264/347/272/277.md +30 -3
  551. package/templates/knowledge/procedures//346/225/260/346/215/256/345/272/223/350/277/201/347/247/273/346/265/201/347/250/213.md +29 -3
  552. package/templates/knowledge/procedures//346/234/254/345/234/260/346/265/217/350/247/210/345/231/250/351/252/214/346/224/266/345/267/245/344/275/234/346/265/201.md +99 -0
  553. package/templates/knowledge/procedures//346/236/266/346/236/204/350/256/276/350/256/241/345/267/245/344/275/234/346/265/201.md +95 -0
  554. package/templates/knowledge/procedures//346/236/266/346/236/204/350/256/276/350/256/241/346/265/201/347/250/213.md +30 -3
  555. package/templates/knowledge/procedures//346/246/202/345/277/265/351/252/214/350/257/201/346/265/201/346/260/264/347/272/277.md +30 -3
  556. package/templates/knowledge/procedures//346/265/213/350/257/225/344/274/230/345/205/210/347/274/226/347/240/201/345/267/245/344/275/234/346/265/201.md +91 -0
  557. package/templates/knowledge/procedures//346/272/220/347/240/201/345/216/237/345/236/213/344/272/244/344/273/230/346/265/201/347/250/213.md +30 -3
  558. package/templates/knowledge/procedures//347/216/260/346/234/211/347/263/273/347/273/237/345/267/256/350/267/235/345/210/206/346/236/220/345/267/245/344/275/234/346/265/201.md +97 -0
  559. package/templates/knowledge/procedures//347/237/245/350/257/206/347/273/264/346/212/244/346/265/201/346/260/264/347/272/277.md +30 -3
  560. package/templates/knowledge/procedures//347/264/247/346/200/245/344/277/256/345/244/215/346/265/201/346/260/264/347/272/277.md +30 -3
  561. package/templates/knowledge/procedures//347/264/247/346/200/245/344/277/256/345/244/215/346/265/201/347/250/213.md +30 -3
  562. package/templates/knowledge/procedures//347/274/226/347/240/201/345/211/215/346/276/204/346/270/205/346/265/201/347/250/213.md +33 -0
  563. package/templates/knowledge/procedures//347/274/272/351/231/267/344/277/256/345/244/215/346/265/201/346/260/264/347/272/277.md +30 -3
  564. package/templates/knowledge/procedures//350/207/252/344/270/273/351/200/211/345/236/213/346/265/201/347/250/213.md +30 -3
  565. package/templates/knowledge/procedures//350/257/246/347/273/206/350/256/276/350/256/241/346/265/201/347/250/213.md +30 -3
  566. package/templates/knowledge/procedures//350/260/203/350/257/225/346/216/222/346/237/245/346/265/201/347/250/213.md +30 -3
  567. package/templates/knowledge/procedures//350/277/201/347/247/273/346/265/201/346/260/264/347/272/277.md +30 -3
  568. package/templates/knowledge/procedures//351/203/250/347/275/262/345/217/221/345/270/203/346/265/201/347/250/213.md +30 -3
  569. package/templates/knowledge/procedures//351/207/215/346/236/204/346/265/201/346/260/264/347/272/277.md +30 -3
  570. package/templates/knowledge/procedures//351/233/206/346/210/220/351/252/214/350/257/201/346/265/201/347/250/213.md +30 -3
  571. package/templates/knowledge/procedures//351/234/200/346/261/202/346/276/204/346/270/205/346/265/201/347/250/213.md +30 -3
  572. package/templates/knowledge/procedures//351/252/214/346/224/266/346/265/213/350/257/225/350/247/204/345/210/222.md +30 -3
  573. package/templates/knowledge/procedures//351/252/214/350/257/201/350/256/241/345/210/222/346/265/201/347/250/213.md +30 -3
  574. package/templates/knowledge/review_rules//344/272/244/344/273/230/345/256/214/345/244/207/346/200/247/345/256/241/346/237/245/350/247/204/345/210/231.md +24 -3
  575. package/templates/knowledge/review_rules//345/256/211/345/205/250/345/256/241/346/237/245/350/247/204/345/210/231.md +24 -3
  576. package/templates/knowledge/review_rules//345/271/266/345/217/221/345/256/241/346/237/245/350/247/204/345/210/231.md +23 -3
  577. package/templates/knowledge/review_rules//346/200/247/350/203/275/345/256/241/346/237/245/350/247/204/345/210/231.md +24 -3
  578. package/templates/knowledge/review_rules//346/216/245/345/217/243/345/245/221/347/272/246/345/256/241/346/237/245/350/247/204/345/210/231.md +23 -3
  579. package/templates/knowledge/review_rules//346/236/266/346/236/204/345/256/241/346/237/245/350/247/204/345/210/231.md +24 -3
  580. package/templates/knowledge/review_rules//350/264/250/351/207/217/345/256/241/346/237/245/350/247/204/345/210/231.md +24 -3
  581. package/templates/knowledge/rules//344/272/247/347/211/251/345/245/221/347/272/246/350/247/204/345/210/231.md +36 -0
  582. package/templates/knowledge/rules//344/273/273/345/212/241/344/270/212/344/270/213/346/226/207/347/224/237/345/221/275/345/221/250/346/234/237/350/247/204/345/210/231.md +65 -0
  583. package/templates/knowledge/rules//345/221/275/344/273/244/346/211/247/350/241/214/350/247/204/345/210/231.md +36 -0
  584. package/templates/knowledge/rules//345/267/245/344/275/234/346/265/201/345/245/221/347/272/246/350/247/204/345/210/231.md +36 -0
  585. package/templates/knowledge/rules//345/267/245/344/275/234/346/265/201/346/250/241/346/235/277/345/214/205/350/247/204/345/210/231.md +38 -0
  586. package/templates/knowledge/rules//345/267/245/345/205/267/350/260/203/347/224/250/350/247/204/345/210/231.md +36 -0
  587. package/templates/knowledge/rules//346/204/217/345/233/276/350/267/257/347/224/261/350/247/204/345/210/231.md +36 -0
  588. package/templates/knowledge/rules//346/211/247/350/241/214/345/256/210/345/215/253/350/257/204/344/274/260/350/247/204/345/210/231.md +36 -0
  589. package/templates/knowledge/rules//346/211/251/345/261/225/347/224/237/345/221/275/345/221/250/346/234/237/350/247/204/345/210/231.md +38 -0
  590. package/templates/knowledge/rules//346/212/200/346/234/257/345/206/263/347/255/226/344/270/273/346/235/203/350/247/204/345/210/231.md +64 -0
  591. package/templates/knowledge/rules//346/225/217/346/204/237/344/277/241/346/201/257/345/244/204/347/220/206/350/247/204/345/210/231.md +36 -0
  592. package/templates/knowledge/rules//346/226/275/345/267/245/346/214/207/344/273/244/345/245/221/347/272/246/350/247/204/345/210/231.md +49 -0
  593. package/templates/knowledge/rules//346/240/270/345/277/203/344/275/223/351/252/214/345/216/237/345/210/231.md +50 -0
  594. package/templates/knowledge/rules//346/240/270/345/277/203/345/267/245/347/250/213/346/211/247/350/241/214/345/216/237/345/210/231.md +35 -0
  595. package/templates/knowledge/rules//346/263/250/345/206/214/350/241/250/345/237/272/347/241/200/350/256/276/346/226/275/350/247/204/345/210/231.md +36 -0
  596. package/templates/knowledge/rules//346/274/224/350/277/233/345/233/236/345/275/222/350/247/204/345/210/231.md +51 -0
  597. package/templates/knowledge/rules//346/274/224/350/277/233/345/233/236/345/275/222/351/227/250/346/216/247/350/247/204/345/210/231.md +74 -0
  598. package/templates/knowledge/rules//347/224/250/346/210/267/345/217/215/351/246/210/345/245/221/347/272/246/350/247/204/345/210/231.md +35 -0
  599. package/templates/knowledge/rules//347/237/245/350/257/206/346/263/250/345/205/245/350/276/271/347/225/214/350/247/204/345/210/231.md +36 -0
  600. package/templates/knowledge/rules//347/237/245/350/257/206/350/265/204/344/272/247/346/262/273/347/220/206/350/247/204/345/210/231.md +61 -0
  601. package/templates/knowledge/rules//347/254/254/344/270/200/346/200/247/345/216/237/347/220/206/346/216/250/347/220/206/350/247/204/345/210/231.md +73 -0
  602. package/templates/knowledge/rules//347/273/206/350/212/202/347/272/252/345/276/213/350/247/204/345/210/231.md +67 -0
  603. package/templates/knowledge/rules//350/204/221/346/232/264/344/270/216/346/226/271/346/241/210/346/216/242/347/264/242/350/247/204/345/210/231.md +66 -0
  604. package/templates/knowledge/rules//350/256/241/345/210/222/345/211/215/347/275/256/351/227/250/350/247/204/345/210/231.md +59 -0
  605. package/templates/knowledge/rules//350/267/250/345/271/263/345/217/260/350/267/257/345/276/204/345/256/211/345/205/250/350/247/204/345/210/231.md +38 -0
  606. package/templates/knowledge/rules//350/276/223/345/205/245/346/235/220/346/226/231/345/245/221/347/272/246/350/247/204/345/210/231.md +36 -0
  607. package/templates/knowledge/rules//351/205/215/347/275/256/344/274/230/345/205/210/347/272/247/350/247/204/345/210/231.md +35 -0
  608. package/templates/knowledge/rules//351/230/262/345/255/244/345/262/233/345/256/236/347/216/260/350/247/204/345/210/231.md +36 -0
  609. package/templates/knowledge/rules//351/233/266/351/205/215/347/275/256/345/210/235/345/247/213/345/214/226/350/247/204/345/210/231.md +36 -0
  610. package/templates/knowledge/rules//351/252/214/350/257/201/345/245/221/347/272/246/350/247/204/345/210/231.md +36 -0
  611. package/templates/knowledge/templates//345/256/241/346/237/245/346/221/230/350/246/201.md +26 -7
  612. package/templates/patterns/API/350/256/276/350/256/241/350/247/204/350/214/203.md +30 -3
  613. package/templates/patterns/Docker/351/203/250/347/275/262/350/247/204/350/214/203.md +29 -3
  614. package/templates/patterns/Git/346/223/215/344/275/234/350/247/204/350/214/203.md +33 -3
  615. package/templates/patterns/N/345/212/2401/346/237/245/350/257/242/350/247/204/350/214/203.md +31 -3
  616. package/templates/patterns/React/345/210/227/350/241/250/350/241/250/346/240/274/350/247/204/350/214/203.md +30 -3
  617. package/templates/patterns/React/346/216/245/345/217/243/351/233/206/346/210/220/350/247/204/350/214/203.md +31 -3
  618. package/templates/patterns/React/347/212/266/346/200/201/347/256/241/347/220/206/350/247/204/350/214/203.md +31 -3
  619. package/templates/patterns/React/347/273/204/344/273/266/350/247/204/350/214/203.md +30 -3
  620. package/templates/patterns/React/350/241/250/345/215/225/350/247/204/350/214/203.md +30 -3
  621. package/templates/patterns/React/350/267/257/347/224/261/350/247/204/350/214/203.md +31 -3
  622. package/templates/patterns/Schema/345/205/274/345/256/271/350/247/204/350/214/203.md +30 -3
  623. package/templates/patterns/Vue/347/212/266/346/200/201/347/256/241/347/220/206/350/247/204/350/214/203.md +29 -3
  624. package/templates/patterns/Vue/347/273/204/344/273/266/350/247/204/350/214/203.md +33 -3
  625. package/templates/patterns/Vue/350/267/257/347/224/261/350/247/204/350/214/203.md +28 -3
  626. package/templates/patterns//344/272/213/344/273/266/351/251/261/345/212/250/350/247/204/350/214/203.md +32 -3
  627. package/templates/patterns//344/272/213/345/212/241/346/250/241/345/274/217/350/247/204/350/214/203.md +31 -3
  628. package/templates/patterns//344/274/230/351/233/205/345/201/234/346/234/272/350/247/204/350/214/203.md +31 -3
  629. package/templates/patterns//345/205/250/346/240/210/346/265/201/347/250/213/344/277/256/345/244/215.md +30 -3
  630. package/templates/patterns//345/210/206/351/241/265/346/237/245/350/257/242/350/247/204/350/214/203.md +34 -3
  631. package/templates/patterns//345/211/215/347/253/257/346/200/247/350/203/275/350/247/204/350/214/203.md +32 -3
  632. package/templates/patterns//345/221/275/345/220/215/350/247/204/350/214/203.md +30 -3
  633. package/templates/patterns//345/233/275/351/231/205/345/214/226/350/247/204/350/214/203.md +31 -3
  634. package/templates/patterns//345/242/236/345/210/240/346/224/271/346/237/245/350/247/204/350/214/203.md +31 -3
  635. package/templates/patterns//345/244/226/351/203/250/344/276/235/350/265/226/350/247/204/350/214/203.md +31 -3
  636. package/templates/patterns//345/245/221/347/272/246/345/205/274/345/256/271/350/247/204/350/214/203.md +28 -3
  637. package/templates/patterns//345/256/232/346/227/266/344/273/273/345/212/241/350/247/204/350/214/203.md +32 -3
  638. package/templates/patterns//345/256/236/346/227/266/346/216/250/351/200/201/350/247/204/350/214/203.md +31 -3
  639. package/templates/patterns//345/267/245/347/250/213/347/272/252/345/276/213.md +30 -3
  640. package/templates/patterns//345/271/266/345/217/221/346/216/247/345/210/266/350/247/204/350/214/203.md +34 -3
  641. package/templates/patterns//345/274/202/346/255/245/345/257/274/345/207/272/350/247/204/350/214/203.md +31 -3
  642. package/templates/patterns//346/216/245/345/217/243/345/245/221/347/272/246/350/247/204/350/214/203.md +29 -3
  643. package/templates/patterns//346/220/234/347/264/242/346/250/241/345/274/217/350/247/204/350/214/203.md +33 -3
  644. package/templates/patterns//346/225/260/346/215/256/351/232/220/347/247/201/350/247/204/350/214/203.md +34 -3
  645. package/templates/patterns//346/226/207/344/273/266/344/270/212/344/274/240/350/247/204/350/214/203.md +30 -3
  646. package/templates/patterns//346/227/240/351/232/234/347/242/215/350/247/204/350/214/203.md +30 -3
  647. package/templates/patterns//346/227/245/345/277/227/350/247/204/350/214/203.md +31 -3
  648. package/templates/patterns//346/235/203/351/231/220/350/256/244/350/257/201/350/247/204/350/214/203.md +34 -3
  649. package/templates/patterns//346/236/266/346/236/204/347/272/242/347/272/277.md +28 -3
  650. package/templates/patterns//346/265/213/350/257/225/350/264/250/351/207/217/350/247/204/350/214/203.md +30 -3
  651. package/templates/patterns//347/206/224/346/226/255/351/231/215/347/272/247/350/247/204/350/214/203.md +32 -3
  652. package/templates/patterns//347/212/266/346/200/201/346/265/201/350/275/254/350/247/204/350/214/203.md +29 -3
  653. package/templates/patterns//347/272/246/346/235/237/345/256/236/347/216/260/350/247/204/350/214/203.md +32 -3
  654. package/templates/patterns//347/274/223/345/255/230/347/255/226/347/225/245/350/247/204/350/214/203.md +31 -3
  655. package/templates/patterns//347/274/226/347/240/201/350/264/250/351/207/217/350/247/204/350/214/203.md +30 -3
  656. package/templates/patterns//347/274/272/351/231/267/347/256/241/347/220/206/350/247/204/350/214/203.md +29 -3
  657. package/templates/patterns//350/260/203/350/257/225/346/226/271/346/263/225/350/256/272.md +30 -3
  658. package/templates/patterns//350/276/223/345/205/245/346/240/241/351/252/214/350/247/204/350/214/203.md +31 -3
  659. package/templates/patterns//351/224/231/350/257/257/345/244/204/347/220/206/350/247/204/350/214/203.md +31 -3
  660. package/templates/patterns//351/224/231/350/257/257/350/276/271/347/225/214/350/247/204/350/214/203.md +33 -3
  661. package/templates/patterns//351/242/206/345/237/237/351/251/261/345/212/250/350/256/276/350/256/241/350/247/204/350/214/203.md +30 -3
  662. package/dist/engine/batch1_manifest.d.ts.map +0 -1
  663. package/dist/engine/batch1_manifest.js.map +0 -1
  664. package/dist/engine/batch1_scenario_registry.d.ts.map +0 -1
  665. package/dist/engine/batch1_scenario_registry.js.map +0 -1
  666. package/dist/engine/batch1_scenario_runners.d.ts.map +0 -1
  667. package/dist/engine/batch1_scenario_runners.js.map +0 -1
@@ -0,0 +1,230 @@
1
+ /**
2
+ * Knowledge Asset Audit — 问题五十七核心机制之二。
3
+ *
4
+ * 扫描所有知识资产,输出审计报告,识别:
5
+ * - frontmatter 缺失字段
6
+ * - 重复 ID / canonical 冲突
7
+ * - owner/evidence 缺失
8
+ * - deprecated/draft/quarantine 注入风险
9
+ * - checklist 硬规则越权
10
+ * - 消费链路不可追踪
11
+ */
12
+ import { validateKnowledgeAssetFrontmatter } from "./knowledge_asset_schema.js";
13
+ import matter from "gray-matter";
14
+ // ── YAML 解析 ──
15
+ /**
16
+ * 使用 gray-matter 解析知识资产文件的 frontmatter。
17
+ * 返回正确类型的 frontmatter(数组是数组,不是字符串)。
18
+ */
19
+ export function parseKnowledgeAssetFrontmatter(rawContent) {
20
+ try {
21
+ const parsed = matter(rawContent);
22
+ const data = parsed.data;
23
+ // gray-matter 返回的数组字段已经是真正的数组
24
+ return data;
25
+ }
26
+ catch {
27
+ return {};
28
+ }
29
+ }
30
+ /**
31
+ * 解析文件并返回可审计的资产对象。
32
+ */
33
+ export function parseAssetFile(filePath, rawContent) {
34
+ const fm = parseKnowledgeAssetFrontmatter(rawContent);
35
+ const body = rawContent.replace(/^---\n[\s\S]*?\n---\n?/, "");
36
+ return {
37
+ frontmatter: fm,
38
+ file_path: filePath,
39
+ body,
40
+ };
41
+ }
42
+ // ── 核心函数 ──
43
+ /**
44
+ * 执行知识资产全量审计。
45
+ * 接受已解析的 frontmatter 对象(推荐使用 parseAssetFile 预处理)。
46
+ */
47
+ export function auditKnowledgeAssets(assets) {
48
+ const allFindings = [];
49
+ const idSet = new Set();
50
+ const canonicalSubjects = new Map();
51
+ const deprecatedWithRoutes = [];
52
+ for (const asset of assets) {
53
+ // 1. Schema 校验
54
+ const schemaFindings = validateKnowledgeAssetFrontmatter(asset.frontmatter, asset.file_path);
55
+ for (const sf of schemaFindings) {
56
+ allFindings.push({
57
+ asset_id: sf.asset_id,
58
+ file_path: sf.file_path,
59
+ severity: sf.severity,
60
+ kind: sf.field === "owner_mechanism_id" ? "owner_missing"
61
+ : sf.field === "required_evidence" ? "required_evidence_missing"
62
+ : sf.message_zh.includes("deprecated") ? "deprecated_injected"
63
+ : "missing_required_field",
64
+ detail: sf.message_zh,
65
+ suggested_action: sf.field === "owner_mechanism_id" ? "repair"
66
+ : sf.field === "required_evidence" ? "repair"
67
+ : "manual_required",
68
+ });
69
+ }
70
+ const id = asset.frontmatter.id;
71
+ if (!id)
72
+ continue;
73
+ // 2. 重复 ID
74
+ if (idSet.has(id)) {
75
+ allFindings.push({
76
+ asset_id: id,
77
+ file_path: asset.file_path,
78
+ severity: "hard_fail",
79
+ kind: "duplicate_id",
80
+ detail: `知识资产 ID 重复: ${id} (SF-KA-5702)`,
81
+ suggested_action: "merge",
82
+ });
83
+ }
84
+ idSet.add(id);
85
+ // 3. canonical 冲突
86
+ if (asset.frontmatter.authority === "canonical" && asset.frontmatter.name) {
87
+ const subject = asset.frontmatter.name;
88
+ const existing = canonicalSubjects.get(subject) ?? [];
89
+ existing.push(id);
90
+ canonicalSubjects.set(subject, existing);
91
+ }
92
+ // 4. deprecated/draft/quarantine 注入检测
93
+ const status = asset.frontmatter.lifecycle_status;
94
+ if (status && ["deprecated", "draft", "quarantine"].includes(status)) {
95
+ if (asset.frontmatter.routes && asset.frontmatter.routes.length > 0) {
96
+ deprecatedWithRoutes.push(id);
97
+ allFindings.push({
98
+ asset_id: id,
99
+ file_path: asset.file_path,
100
+ severity: "hard_fail",
101
+ kind: "deprecated_injected",
102
+ detail: `${status} 资产 ${id} 有活跃路由,可能被注入 prompt (SF-KA-5705)`,
103
+ suggested_action: "repair",
104
+ });
105
+ }
106
+ }
107
+ // 5. hard_rule/workflow 无 owner
108
+ const kind = asset.frontmatter.asset_kind;
109
+ if (kind && ["hard_rule", "workflow", "procedure", "pipeline"].includes(kind)) {
110
+ if (!asset.frontmatter.owner_mechanism_id) {
111
+ allFindings.push({
112
+ asset_id: id,
113
+ file_path: asset.file_path,
114
+ severity: "hard_fail",
115
+ kind: "owner_missing",
116
+ detail: `${kind} ${id} 缺少 owner_mechanism_id (SF-KA-5704)`,
117
+ suggested_action: "repair",
118
+ });
119
+ }
120
+ }
121
+ // 6. P0/P1 缺 required_evidence
122
+ if (asset.frontmatter.priority && ["P0", "P1"].includes(asset.frontmatter.priority)) {
123
+ if (!asset.frontmatter.required_evidence || asset.frontmatter.required_evidence.length === 0) {
124
+ allFindings.push({
125
+ asset_id: id,
126
+ file_path: asset.file_path,
127
+ severity: "hard_fail",
128
+ kind: "required_evidence_missing",
129
+ detail: `P0/P1 资产 ${id} 缺少 required_evidence (SF-KA-5706)`,
130
+ suggested_action: "repair",
131
+ });
132
+ }
133
+ }
134
+ // 7. checklist 硬规则越权
135
+ if (kind === "checklist" && asset.frontmatter.hard_blocks && asset.frontmatter.hard_blocks.length > 0) {
136
+ allFindings.push({
137
+ asset_id: id,
138
+ file_path: asset.file_path,
139
+ severity: "hard_fail",
140
+ kind: "semantic_conflict",
141
+ detail: `checklist ${id} 平行定义了硬规则,只能引用 canonical (SF-KA-5704)`,
142
+ suggested_action: "mark_supporting",
143
+ });
144
+ }
145
+ // 8. 消费路径检查
146
+ if (kind && ["hard_rule", "workflow", "procedure"].includes(kind)) {
147
+ if (!asset.frontmatter.consumes || asset.frontmatter.consumes.length === 0) {
148
+ allFindings.push({
149
+ asset_id: id,
150
+ file_path: asset.file_path,
151
+ severity: "warning",
152
+ kind: "consumption_path_missing",
153
+ detail: `${kind} ${id} 未声明 consumes,消费链路不可追踪 (SF-KA-5709)`,
154
+ suggested_action: "repair",
155
+ });
156
+ }
157
+ }
158
+ // 9. 中文质量门
159
+ if (asset.body) {
160
+ const zhIssues = checkChineseQuality(asset.body, asset.frontmatter.name ?? "");
161
+ for (const issue of zhIssues) {
162
+ allFindings.push({
163
+ asset_id: id,
164
+ file_path: asset.file_path,
165
+ severity: "warning",
166
+ kind: "language_quality_issue",
167
+ detail: issue,
168
+ suggested_action: "repair",
169
+ });
170
+ }
171
+ }
172
+ }
173
+ // canonical 重复汇总
174
+ for (const [subject, ids] of canonicalSubjects) {
175
+ if (ids.length > 1) {
176
+ for (const dupId of ids) {
177
+ allFindings.push({
178
+ asset_id: dupId,
179
+ file_path: "",
180
+ severity: "hard_fail",
181
+ kind: "duplicate_canonical",
182
+ detail: `主题 "${subject}" 存在多个 canonical: ${ids.join(", ")} (SF-KA-5703)`,
183
+ suggested_action: "mark_supporting",
184
+ });
185
+ }
186
+ }
187
+ }
188
+ const hardFails = allFindings.filter((f) => f.severity === "hard_fail");
189
+ const warnings = allFindings.filter((f) => f.severity === "warning");
190
+ return {
191
+ report_id: `ka-audit-${Date.now()}`,
192
+ generated_at: new Date().toISOString(),
193
+ total_assets: assets.length,
194
+ findings: allFindings,
195
+ hard_fail_count: hardFails.length,
196
+ warning_count: warnings.length,
197
+ info_count: allFindings.filter((f) => f.severity === "info").length,
198
+ passed: hardFails.length === 0,
199
+ summary_zh: hardFails.length === 0
200
+ ? `审计通过: ${assets.length} 个资产,${warnings.length} 个警告`
201
+ : `审计未通过: ${hardFails.length} 个 hard_fail, ${warnings.length} 个警告`,
202
+ };
203
+ }
204
+ /**
205
+ * 中文质量检查 — 发现明显的质量问题。
206
+ */
207
+ function checkChineseQuality(body, assetName) {
208
+ const issues = [];
209
+ // 含糊词检测
210
+ const vagueWords = ["适当", "酌情", "尽量", "可能", "应该可以", "大概"];
211
+ for (const word of vagueWords) {
212
+ if (body.includes(word)) {
213
+ issues.push(`${assetName}: 包含含糊词 "${word}",建议改为具体标准`);
214
+ }
215
+ }
216
+ // 异常中英文混杂
217
+ const mixedPattern = /[a-zA-Z]{3,}\s*的\s*[a-zA-Z]{3,}/g;
218
+ if (mixedPattern.test(body)) {
219
+ issues.push(`${assetName}: 可能存在不必要的技术名词中英混杂`);
220
+ }
221
+ return issues;
222
+ }
223
+ /**
224
+ * 快速审计 — 对已有资产做最小化检查,返回是否通过。
225
+ */
226
+ export function quickAuditPassed(assets) {
227
+ const report = auditKnowledgeAssets(assets);
228
+ return report.passed;
229
+ }
230
+ //# sourceMappingURL=knowledge_asset_audit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"knowledge_asset_audit.js","sourceRoot":"","sources":["../../src/engine/knowledge_asset_audit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,150 @@
1
+ /**
2
+ * Knowledge Asset Consumer — 问题五十七消费链路实现。
3
+ *
4
+ * 为 intent_router、expander、verifier、adapter prompt、sync/migration、observability
5
+ * 提供统一的知识资产消费接口。所有组件通过此模块消费 KnowledgeAssetFrontmatter 标准字段。
6
+ */
7
+ import type { KnowledgeConsumptionSnapshot } from "./knowledge_consumption_snapshot.js";
8
+ /** 知识资产消费记录 */
9
+ export interface AssetConsumptionRecord {
10
+ asset_id: string;
11
+ asset_name: string;
12
+ file_path: string;
13
+ fields_consumed: string[];
14
+ consumer: string;
15
+ consumed_at: string;
16
+ }
17
+ /** 路由器消费的字段 */
18
+ export interface RouterConsumptionFields {
19
+ routes: string[];
20
+ primary_triggers: string[];
21
+ negative_triggers: string[];
22
+ specificity: number;
23
+ }
24
+ /** 扩展器消费的字段 */
25
+ export interface ExpanderConsumptionFields {
26
+ authority: string;
27
+ priority: string;
28
+ required_evidence: string[];
29
+ asset_kind: string;
30
+ }
31
+ /** 验证器消费的字段 */
32
+ export interface VerifierConsumptionFields {
33
+ hard_blocks: string[];
34
+ required_evidence: string[];
35
+ fallback: string;
36
+ lifecycle_status: string;
37
+ }
38
+ /** 适配器 Prompt 消费的字段 */
39
+ export interface AdapterPromptConsumptionFields {
40
+ name: string;
41
+ scope: string[];
42
+ version: string;
43
+ }
44
+ /** 全量消费报告 */
45
+ export interface KnowledgeConsumptionReport {
46
+ generated_at: string;
47
+ /** 静态资产目录扫描结果 — 来自离线 frontmatter/registry 扫描,非真实消费证据 */
48
+ indexed_catalog: {
49
+ total_assets: number;
50
+ assets: Array<{
51
+ asset_id: string;
52
+ file_path: string;
53
+ asset_kind: string;
54
+ priority: string;
55
+ }>;
56
+ };
57
+ /** registry 静态记录 — 来自 consumeFor* 离线扫描,不作为真实消费证据 */
58
+ registry_records: {
59
+ router: AssetConsumptionRecord[];
60
+ expander: AssetConsumptionRecord[];
61
+ verifier: AssetConsumptionRecord[];
62
+ adapter_prompt: AssetConsumptionRecord[];
63
+ };
64
+ /** 真实消费 trace — 来自 runtime trace store,仅此可作为 通过证据 */
65
+ runtime_consumption_traces: {
66
+ router: AssetConsumptionRecord[];
67
+ expander: AssetConsumptionRecord[];
68
+ verifier: AssetConsumptionRecord[];
69
+ adapter_prompt: AssetConsumptionRecord[];
70
+ };
71
+ consumers: {
72
+ router: AssetConsumptionRecord[];
73
+ expander: AssetConsumptionRecord[];
74
+ verifier: AssetConsumptionRecord[];
75
+ adapter_prompt: AssetConsumptionRecord[];
76
+ };
77
+ snapshot: KnowledgeConsumptionSnapshot;
78
+ total_assets_indexed: number;
79
+ total_assets_injected: number;
80
+ real_trace_evidence?: {
81
+ router_entries: number;
82
+ verifier_entries: number;
83
+ expander_entries: number;
84
+ adapter_entries: number;
85
+ p0p1_injected?: number;
86
+ p2p3_backlog?: number;
87
+ };
88
+ }
89
+ /**
90
+ * 加载知识资产注册表 — 使用 gray-matter YAML 解析 templates/knowledge/** 和 templates/patterns/**。
91
+ */
92
+ export declare function loadKnowledgeAssetRegistry(baseDir: string): Array<{
93
+ asset_id: string;
94
+ frontmatter: Record<string, unknown>;
95
+ file_path: string;
96
+ }>;
97
+ /**
98
+ * 为 intent_router 消费知识资产字段。
99
+ * 消费: routes, primary_triggers, negative_triggers, specificity
100
+ * 兼容旧格式:when → primary_triggers
101
+ */
102
+ export declare function consumeForRouter(assets: Array<{
103
+ asset_id: string;
104
+ frontmatter: Record<string, unknown>;
105
+ file_path: string;
106
+ }>): {
107
+ fields: RouterConsumptionFields[];
108
+ records: AssetConsumptionRecord[];
109
+ };
110
+ /**
111
+ * 为 intent_expander 消费知识资产字段。
112
+ * 消费: authority, priority, required_evidence, asset_kind
113
+ */
114
+ export declare function consumeForExpander(assets: Array<{
115
+ asset_id: string;
116
+ frontmatter: Record<string, unknown>;
117
+ file_path: string;
118
+ }>): {
119
+ fields: ExpanderConsumptionFields[];
120
+ records: AssetConsumptionRecord[];
121
+ };
122
+ /**
123
+ * 为 verifier 消费知识资产字段。
124
+ * 消费: hard_blocks, required_evidence, fallback, lifecycle_status
125
+ */
126
+ export declare function consumeForVerifier(assets: Array<{
127
+ asset_id: string;
128
+ frontmatter: Record<string, unknown>;
129
+ file_path: string;
130
+ }>): {
131
+ fields: VerifierConsumptionFields[];
132
+ records: AssetConsumptionRecord[];
133
+ };
134
+ /**
135
+ * 为 adapter_prompt 消费知识资产字段。
136
+ * 消费: name, scope, version
137
+ */
138
+ export declare function consumeForAdapterPrompt(assets: Array<{
139
+ asset_id: string;
140
+ frontmatter: Record<string, unknown>;
141
+ file_path: string;
142
+ }>): {
143
+ fields: AdapterPromptConsumptionFields[];
144
+ records: AssetConsumptionRecord[];
145
+ };
146
+ /**
147
+ * 生成完整的知识消费报告。
148
+ */
149
+ export declare function generateKnowledgeConsumptionReport(baseDir: string): KnowledgeConsumptionReport;
150
+ //# sourceMappingURL=knowledge_asset_consumer.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"knowledge_asset_consumer.d.ts","sourceRoot":"","sources":["../../src/engine/knowledge_asset_consumer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGxF,eAAe;AACf,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAe;AACf,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAe;AACf,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAe;AACf,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,uBAAuB;AACvB,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,aAAa;AACb,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,eAAe,EAAE;QACf,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC9F,CAAC;IACF,oDAAoD;IACpD,gBAAgB,EAAE;QAChB,MAAM,EAAE,sBAAsB,EAAE,CAAC;QACjC,QAAQ,EAAE,sBAAsB,EAAE,CAAC;QACnC,QAAQ,EAAE,sBAAsB,EAAE,CAAC;QACnC,cAAc,EAAE,sBAAsB,EAAE,CAAC;KAC1C,CAAC;IACF,qDAAqD;IACrD,0BAA0B,EAAE;QAC1B,MAAM,EAAE,sBAAsB,EAAE,CAAC;QACjC,QAAQ,EAAE,sBAAsB,EAAE,CAAC;QACnC,QAAQ,EAAE,sBAAsB,EAAE,CAAC;QACnC,cAAc,EAAE,sBAAsB,EAAE,CAAC;KAC1C,CAAC;IACF,SAAS,EAAE;QACT,MAAM,EAAE,sBAAsB,EAAE,CAAC;QACjC,QAAQ,EAAE,sBAAsB,EAAE,CAAC;QACnC,QAAQ,EAAE,sBAAsB,EAAE,CAAC;QACnC,cAAc,EAAE,sBAAsB,EAAE,CAAC;KAC1C,CAAC;IACF,QAAQ,EAAE,4BAA4B,CAAC;IACvC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,MAAM,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAID;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAsCD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,GAAG;IAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IAAC,OAAO,EAAE,sBAAsB,EAAE,CAAA;CAAE,CA8B5E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,GAAG;IAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;IAAC,OAAO,EAAE,sBAAsB,EAAE,CAAA;CAAE,CAuB9E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,GAAG;IAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;IAAC,OAAO,EAAE,sBAAsB,EAAE,CAAA;CAAE,CAuB9E;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,GAAG;IAAE,MAAM,EAAE,8BAA8B,EAAE,CAAC;IAAC,OAAO,EAAE,sBAAsB,EAAE,CAAA;CAAE,CAsBnF;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,CAqG9F"}
@@ -0,0 +1,279 @@
1
+ /**
2
+ * Knowledge Asset Consumer — 问题五十七消费链路实现。
3
+ *
4
+ * 为 intent_router、expander、verifier、adapter prompt、sync/migration、observability
5
+ * 提供统一的知识资产消费接口。所有组件通过此模块消费 KnowledgeAssetFrontmatter 标准字段。
6
+ */
7
+ import fs from "node:fs";
8
+ import path from "node:path";
9
+ import matter from "gray-matter";
10
+ import { getConsumptionTraces, getTraceCounts } from "./consumption_trace_store.js";
11
+ // ── 核心函数 ──
12
+ /**
13
+ * 加载知识资产注册表 — 使用 gray-matter YAML 解析 templates/knowledge/** 和 templates/patterns/**。
14
+ */
15
+ export function loadKnowledgeAssetRegistry(baseDir) {
16
+ const assets = [];
17
+ const scanPaths = [
18
+ "templates/knowledge/rules",
19
+ "templates/knowledge/procedures",
20
+ "templates/knowledge/review_rules",
21
+ "templates/knowledge/checklists",
22
+ "templates/knowledge/acceptance_templates",
23
+ "templates/knowledge/domain",
24
+ "templates/knowledge/patterns/core",
25
+ "templates/knowledge/templates",
26
+ "templates/patterns",
27
+ ];
28
+ for (const d of scanPaths) {
29
+ const dp = path.join(baseDir, d);
30
+ if (!fs.existsSync(dp))
31
+ continue;
32
+ for (const f of fs.readdirSync(dp)) {
33
+ if (!f.endsWith(".md"))
34
+ continue;
35
+ const fpath = path.join(dp, f);
36
+ try {
37
+ const raw = fs.readFileSync(fpath, "utf-8");
38
+ const parsed = matter(raw);
39
+ const fm = (parsed.data || {});
40
+ const assetId = fm.id || fm.name || f;
41
+ assets.push({ asset_id: assetId, frontmatter: fm, file_path: fpath });
42
+ }
43
+ catch {
44
+ // gray-matter 解析失败 — 跳过,审计时会捕获
45
+ }
46
+ }
47
+ }
48
+ return assets;
49
+ }
50
+ /**
51
+ * 为 intent_router 消费知识资产字段。
52
+ * 消费: routes, primary_triggers, negative_triggers, specificity
53
+ * 兼容旧格式:when → primary_triggers
54
+ */
55
+ export function consumeForRouter(assets) {
56
+ const fields = [];
57
+ const records = [];
58
+ for (const asset of assets) {
59
+ const fm = asset.frontmatter;
60
+ const routes = parseArrayField(fm.routes);
61
+ const primaryTriggers = parseArrayField(fm.primary_triggers || fm.when);
62
+ const negativeTriggers = parseArrayField(fm.negative_triggers);
63
+ const specificity = parseInt(String(fm.specificity || "0"), 10);
64
+ if (routes.length > 0 || primaryTriggers.length > 0) {
65
+ fields.push({
66
+ routes,
67
+ primary_triggers: primaryTriggers,
68
+ negative_triggers: negativeTriggers,
69
+ specificity,
70
+ });
71
+ records.push({
72
+ asset_id: asset.asset_id,
73
+ asset_name: fm.name || asset.asset_id,
74
+ file_path: asset.file_path,
75
+ fields_consumed: ["routes", "primary_triggers", "negative_triggers", "specificity"],
76
+ consumer: "intent_router",
77
+ consumed_at: new Date().toISOString(),
78
+ });
79
+ }
80
+ }
81
+ return { fields, records };
82
+ }
83
+ /**
84
+ * 为 intent_expander 消费知识资产字段。
85
+ * 消费: authority, priority, required_evidence, asset_kind
86
+ */
87
+ export function consumeForExpander(assets) {
88
+ const fields = [];
89
+ const records = [];
90
+ for (const asset of assets) {
91
+ const fm = asset.frontmatter;
92
+ fields.push({
93
+ authority: fm.authority || "supporting",
94
+ priority: fm.priority || "P3",
95
+ required_evidence: parseArrayField(fm.required_evidence),
96
+ asset_kind: fm.asset_kind || fm.type || "domain_knowledge",
97
+ });
98
+ records.push({
99
+ asset_id: asset.asset_id,
100
+ asset_name: fm.name || asset.asset_id,
101
+ file_path: asset.file_path,
102
+ fields_consumed: ["authority", "priority", "required_evidence", "asset_kind"],
103
+ consumer: "intent_expander",
104
+ consumed_at: new Date().toISOString(),
105
+ });
106
+ }
107
+ return { fields, records };
108
+ }
109
+ /**
110
+ * 为 verifier 消费知识资产字段。
111
+ * 消费: hard_blocks, required_evidence, fallback, lifecycle_status
112
+ */
113
+ export function consumeForVerifier(assets) {
114
+ const fields = [];
115
+ const records = [];
116
+ for (const asset of assets) {
117
+ const fm = asset.frontmatter;
118
+ fields.push({
119
+ hard_blocks: parseArrayField(fm.hard_blocks),
120
+ required_evidence: parseArrayField(fm.required_evidence),
121
+ fallback: fm.fallback || "none",
122
+ lifecycle_status: fm.lifecycle_status || "active",
123
+ });
124
+ records.push({
125
+ asset_id: asset.asset_id,
126
+ asset_name: fm.name || asset.asset_id,
127
+ file_path: asset.file_path,
128
+ fields_consumed: ["hard_blocks", "required_evidence", "fallback", "lifecycle_status"],
129
+ consumer: "verifier",
130
+ consumed_at: new Date().toISOString(),
131
+ });
132
+ }
133
+ return { fields, records };
134
+ }
135
+ /**
136
+ * 为 adapter_prompt 消费知识资产字段。
137
+ * 消费: name, scope, version
138
+ */
139
+ export function consumeForAdapterPrompt(assets) {
140
+ const fields = [];
141
+ const records = [];
142
+ for (const asset of assets) {
143
+ const fm = asset.frontmatter;
144
+ fields.push({
145
+ name: fm.name || asset.asset_id,
146
+ scope: parseArrayField(fm.scope),
147
+ version: fm.version || "0.0.0",
148
+ });
149
+ records.push({
150
+ asset_id: asset.asset_id,
151
+ asset_name: fm.name || asset.asset_id,
152
+ file_path: asset.file_path,
153
+ fields_consumed: ["name", "scope", "version"],
154
+ consumer: "adapter_prompt",
155
+ consumed_at: new Date().toISOString(),
156
+ });
157
+ }
158
+ return { fields, records };
159
+ }
160
+ /**
161
+ * 生成完整的知识消费报告。
162
+ */
163
+ export function generateKnowledgeConsumptionReport(baseDir) {
164
+ const assets = loadKnowledgeAssetRegistry(baseDir);
165
+ const routerConsumption = consumeForRouter(assets);
166
+ const expanderConsumption = consumeForExpander(assets);
167
+ const verifierConsumption = consumeForVerifier(assets);
168
+ const adapterConsumption = consumeForAdapterPrompt(assets);
169
+ const activeAssets = assets.filter((a) => {
170
+ const status = a.frontmatter.lifecycle_status;
171
+ return status === "active" || !status;
172
+ });
173
+ // ── 真实 trace 证据(来自统一 trace store,非离线扫描)──
174
+ const allTraces = getConsumptionTraces();
175
+ const traceCounts = getTraceCounts();
176
+ const toRecord = (t, consumerName) => ({
177
+ asset_id: t.asset_id,
178
+ asset_name: t.asset_id,
179
+ file_path: "runtime_trace_store",
180
+ fields_consumed: t.fields_consumed,
181
+ consumer: consumerName,
182
+ consumed_at: t.consumed_at,
183
+ });
184
+ const runtimeRouter = allTraces.filter(t => t.consumer === "router").map(t => toRecord(t, "intent_router"));
185
+ const runtimeExpander = allTraces.filter(t => t.consumer === "expander").map(t => toRecord(t, "intent_expander"));
186
+ const runtimeVerifier = allTraces.filter(t => t.consumer === "verifier").map(t => toRecord(t, "verifier"));
187
+ const runtimeAdapter = allTraces.filter(t => t.consumer === "adapter_prompt").map(t => toRecord(t, "adapter_prompt"));
188
+ // P2/P3 资产过滤
189
+ const p0p1Dirs = ["templates/knowledge/rules", "templates/knowledge/procedures",
190
+ "templates/knowledge/review_rules", "templates/knowledge/checklists"];
191
+ const isP0P1 = (a) => p0p1Dirs.some(d => a.file_path.startsWith(path.join(baseDir, d)));
192
+ const p0p1Active = assets.filter(a => {
193
+ const status = a.frontmatter.lifecycle_status;
194
+ return (status === "active" || !status) && isP0P1(a);
195
+ });
196
+ const p2p3Assets = assets.filter(a => !isP0P1(a));
197
+ const deprecatedFiltered = assets.filter(a => {
198
+ const status = a.frontmatter.lifecycle_status;
199
+ return ["deprecated", "draft", "quarantine"].includes(status);
200
+ }).map(a => ({ asset_id: a.asset_id, reason: a.frontmatter.lifecycle_status || "unknown" }));
201
+ const p2p3Filtered = p2p3Assets.map(a => ({ asset_id: a.asset_id, reason: "P2/P3 backlog: 暂不入注入链路" }));
202
+ return {
203
+ generated_at: new Date().toISOString(),
204
+ indexed_catalog: {
205
+ total_assets: assets.length,
206
+ assets: assets.map(a => ({
207
+ asset_id: a.asset_id,
208
+ file_path: a.file_path,
209
+ asset_kind: a.frontmatter.asset_kind || "unknown",
210
+ priority: a.frontmatter.priority || "P3",
211
+ })),
212
+ },
213
+ registry_records: {
214
+ router: routerConsumption.records,
215
+ expander: expanderConsumption.records,
216
+ verifier: verifierConsumption.records,
217
+ adapter_prompt: adapterConsumption.records,
218
+ },
219
+ runtime_consumption_traces: {
220
+ router: runtimeRouter,
221
+ expander: runtimeExpander,
222
+ verifier: runtimeVerifier,
223
+ adapter_prompt: runtimeAdapter,
224
+ },
225
+ consumers: {
226
+ router: runtimeRouter,
227
+ expander: runtimeExpander,
228
+ verifier: runtimeVerifier,
229
+ adapter_prompt: runtimeAdapter,
230
+ },
231
+ snapshot: {
232
+ build_id: `consumption-${Date.now()}`,
233
+ route: "knowledge_asset_consumer",
234
+ indexed_assets: assets.map((a) => a.asset_id),
235
+ injected_assets: p0p1Active.map((a) => a.asset_id),
236
+ filtered_assets: [...deprecatedFiltered, ...p2p3Filtered],
237
+ degraded_assets: [],
238
+ backlog_assets: p2p3Assets.map(a => ({ asset_id: a.asset_id, reason: "P2/P3 backlog" })),
239
+ conflict_resolutions: [],
240
+ generated_at: new Date().toISOString(),
241
+ total_indexed: assets.length,
242
+ total_injected: p0p1Active.length,
243
+ total_filtered: deprecatedFiltered.length + p2p3Filtered.length,
244
+ total_degraded: 0,
245
+ total_backlog: p2p3Assets.length,
246
+ },
247
+ total_assets_indexed: assets.length,
248
+ total_assets_injected: p0p1Active.length,
249
+ real_trace_evidence: {
250
+ router_entries: traceCounts.router,
251
+ verifier_entries: traceCounts.verifier,
252
+ expander_entries: traceCounts.expander,
253
+ adapter_entries: traceCounts.adapter_prompt,
254
+ p0p1_injected: p0p1Active.length,
255
+ p2p3_backlog: p2p3Assets.length,
256
+ },
257
+ };
258
+ }
259
+ /**
260
+ * 解析字段值为字符串数组(兼容 gray-matter 的真实数组和旧式字符串)。
261
+ */
262
+ function parseArrayField(val) {
263
+ if (!val)
264
+ return [];
265
+ if (Array.isArray(val))
266
+ return val.map((v) => String(v).trim());
267
+ if (typeof val === "string") {
268
+ const trimmed = val.trim();
269
+ if (trimmed.startsWith("[") && trimmed.endsWith("]")) {
270
+ const inner = trimmed.slice(1, -1);
271
+ if (inner.trim() === "")
272
+ return [];
273
+ return inner.split(",").map((s) => s.trim().replace(/^"(.*)"$/, "$1").replace(/^'(.*)'$/, "$1"));
274
+ }
275
+ return [trimmed];
276
+ }
277
+ return [String(val)];
278
+ }
279
+ //# sourceMappingURL=knowledge_asset_consumer.js.map