soloforge 1.2.8 → 1.2.9

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 (405) hide show
  1. package/README.md +105 -321
  2. package/dist/adapters/claude_code/claude_md.d.ts +5 -0
  3. package/dist/adapters/claude_code/claude_md.d.ts.map +1 -1
  4. package/dist/adapters/claude_code/claude_md.js +6 -0
  5. package/dist/adapters/claude_code/claude_md.js.map +1 -1
  6. package/dist/adapters/claude_code/hooks.d.ts +4 -0
  7. package/dist/adapters/claude_code/hooks.d.ts.map +1 -1
  8. package/dist/adapters/claude_code/hooks.js +5 -0
  9. package/dist/adapters/claude_code/hooks.js.map +1 -1
  10. package/dist/adapters/claude_code/server.d.ts.map +1 -1
  11. package/dist/adapters/claude_code/server.js +9 -21
  12. package/dist/adapters/claude_code/server.js.map +1 -1
  13. package/dist/adapters/claude_code/tools.d.ts +5 -0
  14. package/dist/adapters/claude_code/tools.d.ts.map +1 -1
  15. package/dist/adapters/claude_code/tools.js +619 -205
  16. package/dist/adapters/claude_code/tools.js.map +1 -1
  17. package/dist/adapters/codex/codex_config.d.ts +9 -0
  18. package/dist/adapters/codex/codex_config.d.ts.map +1 -1
  19. package/dist/adapters/codex/codex_config.js +11 -3
  20. package/dist/adapters/codex/codex_config.js.map +1 -1
  21. package/dist/adapters/codex/codex_rules.d.ts +5 -0
  22. package/dist/adapters/codex/codex_rules.d.ts.map +1 -1
  23. package/dist/adapters/codex/codex_rules.js +8 -1
  24. package/dist/adapters/codex/codex_rules.js.map +1 -1
  25. package/dist/adapters/shared/workflow_template.d.ts +5 -0
  26. package/dist/adapters/shared/workflow_template.d.ts.map +1 -1
  27. package/dist/adapters/shared/workflow_template.js +32 -79
  28. package/dist/adapters/shared/workflow_template.js.map +1 -1
  29. package/dist/adapters/trae/trae_config.d.ts +4 -0
  30. package/dist/adapters/trae/trae_config.d.ts.map +1 -1
  31. package/dist/adapters/trae/trae_config.js +5 -7
  32. package/dist/adapters/trae/trae_config.js.map +1 -1
  33. package/dist/adapters/trae/trae_rules.d.ts +5 -0
  34. package/dist/adapters/trae/trae_rules.d.ts.map +1 -1
  35. package/dist/adapters/trae/trae_rules.js +7 -1
  36. package/dist/adapters/trae/trae_rules.js.map +1 -1
  37. package/dist/bin/config_commands.d.ts +33 -0
  38. package/dist/bin/config_commands.d.ts.map +1 -0
  39. package/dist/bin/config_commands.js +222 -0
  40. package/dist/bin/config_commands.js.map +1 -0
  41. package/dist/bin/soloforge.js +609 -119
  42. package/dist/bin/soloforge.js.map +1 -1
  43. package/dist/engine/artifact_contract_registry.d.ts +138 -0
  44. package/dist/engine/artifact_contract_registry.d.ts.map +1 -0
  45. package/dist/engine/artifact_contract_registry.js +427 -0
  46. package/dist/engine/artifact_contract_registry.js.map +1 -0
  47. package/dist/engine/audit_pool.d.ts +40 -0
  48. package/dist/engine/audit_pool.d.ts.map +1 -1
  49. package/dist/engine/audit_pool.js +37 -1
  50. package/dist/engine/audit_pool.js.map +1 -1
  51. package/dist/engine/audit_sampler.d.ts +5 -0
  52. package/dist/engine/audit_sampler.d.ts.map +1 -1
  53. package/dist/engine/audit_sampler.js +6 -0
  54. package/dist/engine/audit_sampler.js.map +1 -1
  55. package/dist/engine/audit_verifier.d.ts.map +1 -1
  56. package/dist/engine/audit_verifier.js +5 -1
  57. package/dist/engine/audit_verifier.js.map +1 -1
  58. package/dist/engine/batch1_manifest.d.ts +61 -0
  59. package/dist/engine/batch1_manifest.d.ts.map +1 -0
  60. package/dist/engine/batch1_manifest.js +220 -0
  61. package/dist/engine/batch1_manifest.js.map +1 -0
  62. package/dist/engine/batch1_reality_gate.d.ts +40 -0
  63. package/dist/engine/batch1_reality_gate.d.ts.map +1 -0
  64. package/dist/engine/batch1_reality_gate.js +290 -0
  65. package/dist/engine/batch1_reality_gate.js.map +1 -0
  66. package/dist/engine/batch1_scenario_registry.d.ts +62 -0
  67. package/dist/engine/batch1_scenario_registry.d.ts.map +1 -0
  68. package/dist/engine/batch1_scenario_registry.js +392 -0
  69. package/dist/engine/batch1_scenario_registry.js.map +1 -0
  70. package/dist/engine/batch1_scenario_runners.d.ts +42 -0
  71. package/dist/engine/batch1_scenario_runners.d.ts.map +1 -0
  72. package/dist/engine/batch1_scenario_runners.js +292 -0
  73. package/dist/engine/batch1_scenario_runners.js.map +1 -0
  74. package/dist/engine/capability_action_advisor.d.ts +3 -0
  75. package/dist/engine/capability_action_advisor.d.ts.map +1 -1
  76. package/dist/engine/capability_action_advisor.js +10 -0
  77. package/dist/engine/capability_action_advisor.js.map +1 -1
  78. package/dist/engine/capability_registry.d.ts +21 -0
  79. package/dist/engine/capability_registry.d.ts.map +1 -1
  80. package/dist/engine/capability_registry.js +113 -0
  81. package/dist/engine/capability_registry.js.map +1 -1
  82. package/dist/engine/capability_state_store.d.ts +63 -0
  83. package/dist/engine/capability_state_store.d.ts.map +1 -1
  84. package/dist/engine/capability_state_store.js +49 -1
  85. package/dist/engine/capability_state_store.js.map +1 -1
  86. package/dist/engine/change_coordinator.d.ts.map +1 -1
  87. package/dist/engine/change_coordinator.js +5 -4
  88. package/dist/engine/change_coordinator.js.map +1 -1
  89. package/dist/engine/classifier.d.ts +15 -5
  90. package/dist/engine/classifier.d.ts.map +1 -1
  91. package/dist/engine/classifier.js +70 -69
  92. package/dist/engine/classifier.js.map +1 -1
  93. package/dist/engine/code_reviewer.d.ts +14 -0
  94. package/dist/engine/code_reviewer.d.ts.map +1 -1
  95. package/dist/engine/code_reviewer.js +109 -10
  96. package/dist/engine/code_reviewer.js.map +1 -1
  97. package/dist/engine/cognitive_anchor.d.ts +14 -0
  98. package/dist/engine/cognitive_anchor.d.ts.map +1 -1
  99. package/dist/engine/cognitive_anchor.js +26 -2
  100. package/dist/engine/cognitive_anchor.js.map +1 -1
  101. package/dist/engine/command_execution_contract.d.ts +226 -0
  102. package/dist/engine/command_execution_contract.d.ts.map +1 -0
  103. package/dist/engine/command_execution_contract.js +571 -0
  104. package/dist/engine/command_execution_contract.js.map +1 -0
  105. package/dist/engine/confidence_scorer.d.ts.map +1 -1
  106. package/dist/engine/confidence_scorer.js +1 -0
  107. package/dist/engine/confidence_scorer.js.map +1 -1
  108. package/dist/engine/config_precedence_contract.d.ts +269 -0
  109. package/dist/engine/config_precedence_contract.d.ts.map +1 -0
  110. package/dist/engine/config_precedence_contract.js +948 -0
  111. package/dist/engine/config_precedence_contract.js.map +1 -0
  112. package/dist/engine/conflict_gate.d.ts +13 -0
  113. package/dist/engine/conflict_gate.d.ts.map +1 -1
  114. package/dist/engine/conflict_gate.js +20 -2
  115. package/dist/engine/conflict_gate.js.map +1 -1
  116. package/dist/engine/consumable_asset_registry.d.ts +46 -0
  117. package/dist/engine/consumable_asset_registry.d.ts.map +1 -0
  118. package/dist/engine/consumable_asset_registry.js +758 -0
  119. package/dist/engine/consumable_asset_registry.js.map +1 -0
  120. package/dist/engine/contract_guard.d.ts +4 -0
  121. package/dist/engine/contract_guard.d.ts.map +1 -1
  122. package/dist/engine/contract_guard.js +15 -7
  123. package/dist/engine/contract_guard.js.map +1 -1
  124. package/dist/engine/convention_detector.d.ts.map +1 -1
  125. package/dist/engine/convention_detector.js +5 -2
  126. package/dist/engine/convention_detector.js.map +1 -1
  127. package/dist/engine/core_engineering_principles.d.ts +155 -0
  128. package/dist/engine/core_engineering_principles.d.ts.map +1 -0
  129. package/dist/engine/core_engineering_principles.js +426 -0
  130. package/dist/engine/core_engineering_principles.js.map +1 -0
  131. package/dist/engine/debt_reporter.d.ts.map +1 -1
  132. package/dist/engine/debt_reporter.js +3 -1
  133. package/dist/engine/debt_reporter.js.map +1 -1
  134. package/dist/engine/debt_tracker.d.ts.map +1 -1
  135. package/dist/engine/debt_tracker.js +9 -3
  136. package/dist/engine/debt_tracker.js.map +1 -1
  137. package/dist/engine/debugger.d.ts.map +1 -1
  138. package/dist/engine/debugger.js +2 -0
  139. package/dist/engine/debugger.js.map +1 -1
  140. package/dist/engine/decision_contract.d.ts +11 -2
  141. package/dist/engine/decision_contract.d.ts.map +1 -1
  142. package/dist/engine/decision_contract.js +17 -2
  143. package/dist/engine/decision_contract.js.map +1 -1
  144. package/dist/engine/delivery.d.ts +7 -0
  145. package/dist/engine/delivery.d.ts.map +1 -1
  146. package/dist/engine/delivery.js +89 -36
  147. package/dist/engine/delivery.js.map +1 -1
  148. package/dist/engine/dependency_scanner.d.ts.map +1 -1
  149. package/dist/engine/dependency_scanner.js +14 -9
  150. package/dist/engine/dependency_scanner.js.map +1 -1
  151. package/dist/engine/developer_sovereignty.d.ts.map +1 -1
  152. package/dist/engine/developer_sovereignty.js +8 -2
  153. package/dist/engine/developer_sovereignty.js.map +1 -1
  154. package/dist/engine/diff_ownership.d.ts.map +1 -1
  155. package/dist/engine/diff_ownership.js +8 -0
  156. package/dist/engine/diff_ownership.js.map +1 -1
  157. package/dist/engine/diff_ownership_store.d.ts +26 -10
  158. package/dist/engine/diff_ownership_store.d.ts.map +1 -1
  159. package/dist/engine/diff_ownership_store.js +47 -20
  160. package/dist/engine/diff_ownership_store.js.map +1 -1
  161. package/dist/engine/dual_layer_mechanism_registry.d.ts +66 -0
  162. package/dist/engine/dual_layer_mechanism_registry.d.ts.map +1 -0
  163. package/dist/engine/dual_layer_mechanism_registry.js +1077 -0
  164. package/dist/engine/dual_layer_mechanism_registry.js.map +1 -0
  165. package/dist/engine/escape_report.d.ts +50 -0
  166. package/dist/engine/escape_report.d.ts.map +1 -1
  167. package/dist/engine/escape_report.js +38 -0
  168. package/dist/engine/escape_report.js.map +1 -1
  169. package/dist/engine/evolver.d.ts.map +1 -1
  170. package/dist/engine/evolver.js +12 -2
  171. package/dist/engine/evolver.js.map +1 -1
  172. package/dist/engine/exploration.d.ts.map +1 -1
  173. package/dist/engine/exploration.js +87 -0
  174. package/dist/engine/exploration.js.map +1 -1
  175. package/dist/engine/failure_classifier.d.ts.map +1 -1
  176. package/dist/engine/failure_classifier.js +8 -0
  177. package/dist/engine/failure_classifier.js.map +1 -1
  178. package/dist/engine/feasibility_checker.d.ts +8 -0
  179. package/dist/engine/feasibility_checker.d.ts.map +1 -1
  180. package/dist/engine/feasibility_checker.js +12 -0
  181. package/dist/engine/feasibility_checker.js.map +1 -1
  182. package/dist/engine/git_deps.d.ts +4 -1
  183. package/dist/engine/git_deps.d.ts.map +1 -1
  184. package/dist/engine/git_deps.js +5 -1
  185. package/dist/engine/git_deps.js.map +1 -1
  186. package/dist/engine/governance_report.d.ts +57 -1
  187. package/dist/engine/governance_report.d.ts.map +1 -1
  188. package/dist/engine/governance_report.js +91 -1
  189. package/dist/engine/governance_report.js.map +1 -1
  190. package/dist/engine/impact_analyzer.d.ts.map +1 -1
  191. package/dist/engine/impact_analyzer.js +5 -1
  192. package/dist/engine/impact_analyzer.js.map +1 -1
  193. package/dist/engine/implementation_roadmap_registry.d.ts +105 -0
  194. package/dist/engine/implementation_roadmap_registry.d.ts.map +1 -0
  195. package/dist/engine/implementation_roadmap_registry.js +813 -0
  196. package/dist/engine/implementation_roadmap_registry.js.map +1 -0
  197. package/dist/engine/input_material_contract_registry.d.ts +185 -0
  198. package/dist/engine/input_material_contract_registry.d.ts.map +1 -0
  199. package/dist/engine/input_material_contract_registry.js +563 -0
  200. package/dist/engine/input_material_contract_registry.js.map +1 -0
  201. package/dist/engine/intent_expander.d.ts +8 -27
  202. package/dist/engine/intent_expander.d.ts.map +1 -1
  203. package/dist/engine/intent_expander.js +1170 -139
  204. package/dist/engine/intent_expander.js.map +1 -1
  205. package/dist/engine/intent_router.d.ts +82 -0
  206. package/dist/engine/intent_router.d.ts.map +1 -0
  207. package/dist/engine/intent_router.js +458 -0
  208. package/dist/engine/intent_router.js.map +1 -0
  209. package/dist/engine/io_controller.d.ts.map +1 -1
  210. package/dist/engine/io_controller.js +25 -13
  211. package/dist/engine/io_controller.js.map +1 -1
  212. package/dist/engine/java_quality_guard.d.ts.map +1 -1
  213. package/dist/engine/java_quality_guard.js +8 -4
  214. package/dist/engine/java_quality_guard.js.map +1 -1
  215. package/dist/engine/job_manager.d.ts +35 -0
  216. package/dist/engine/job_manager.d.ts.map +1 -1
  217. package/dist/engine/job_manager.js +53 -9
  218. package/dist/engine/job_manager.js.map +1 -1
  219. package/dist/engine/knowledge_config_loader.d.ts +12 -1
  220. package/dist/engine/knowledge_config_loader.d.ts.map +1 -1
  221. package/dist/engine/knowledge_config_loader.js +50 -10
  222. package/dist/engine/knowledge_config_loader.js.map +1 -1
  223. package/dist/engine/knowledge_injection_boundary.d.ts +56 -0
  224. package/dist/engine/knowledge_injection_boundary.d.ts.map +1 -0
  225. package/dist/engine/knowledge_injection_boundary.js +561 -0
  226. package/dist/engine/knowledge_injection_boundary.js.map +1 -0
  227. package/dist/engine/knowledge_manager.d.ts +73 -0
  228. package/dist/engine/knowledge_manager.d.ts.map +1 -1
  229. package/dist/engine/knowledge_manager.js +163 -21
  230. package/dist/engine/knowledge_manager.js.map +1 -1
  231. package/dist/engine/knowledge_sovereignty.d.ts +1 -0
  232. package/dist/engine/knowledge_sovereignty.d.ts.map +1 -1
  233. package/dist/engine/knowledge_sovereignty.js +8 -3
  234. package/dist/engine/knowledge_sovereignty.js.map +1 -1
  235. package/dist/engine/llm_gateway.d.ts +74 -3
  236. package/dist/engine/llm_gateway.d.ts.map +1 -1
  237. package/dist/engine/llm_gateway.js +75 -4
  238. package/dist/engine/llm_gateway.js.map +1 -1
  239. package/dist/engine/main_path_integration_contract.d.ts +383 -0
  240. package/dist/engine/main_path_integration_contract.d.ts.map +1 -0
  241. package/dist/engine/main_path_integration_contract.js +1581 -0
  242. package/dist/engine/main_path_integration_contract.js.map +1 -0
  243. package/dist/engine/mechanism_contract_registry.d.ts +59 -0
  244. package/dist/engine/mechanism_contract_registry.d.ts.map +1 -0
  245. package/dist/engine/mechanism_contract_registry.js +484 -0
  246. package/dist/engine/mechanism_contract_registry.js.map +1 -0
  247. package/dist/engine/migration_guard.d.ts.map +1 -1
  248. package/dist/engine/migration_guard.js +24 -15
  249. package/dist/engine/migration_guard.js.map +1 -1
  250. package/dist/engine/mutation_audit.d.ts +10 -0
  251. package/dist/engine/mutation_audit.d.ts.map +1 -1
  252. package/dist/engine/mutation_audit.js +19 -2
  253. package/dist/engine/mutation_audit.js.map +1 -1
  254. package/dist/engine/observability.d.ts.map +1 -1
  255. package/dist/engine/observability.js +17 -6
  256. package/dist/engine/observability.js.map +1 -1
  257. package/dist/engine/onboarding.d.ts.map +1 -1
  258. package/dist/engine/onboarding.js +20 -4
  259. package/dist/engine/onboarding.js.map +1 -1
  260. package/dist/engine/policy_drift_detector.d.ts +6 -0
  261. package/dist/engine/policy_drift_detector.d.ts.map +1 -1
  262. package/dist/engine/policy_drift_detector.js +16 -0
  263. package/dist/engine/policy_drift_detector.js.map +1 -1
  264. package/dist/engine/privacy_secret_contract.d.ts +320 -0
  265. package/dist/engine/privacy_secret_contract.d.ts.map +1 -0
  266. package/dist/engine/privacy_secret_contract.js +874 -0
  267. package/dist/engine/privacy_secret_contract.js.map +1 -0
  268. package/dist/engine/regression_matrix.d.ts +21 -8
  269. package/dist/engine/regression_matrix.d.ts.map +1 -1
  270. package/dist/engine/regression_matrix.js +37 -8
  271. package/dist/engine/regression_matrix.js.map +1 -1
  272. package/dist/engine/risk_sampler.d.ts +6 -0
  273. package/dist/engine/risk_sampler.d.ts.map +1 -1
  274. package/dist/engine/risk_sampler.js +9 -0
  275. package/dist/engine/risk_sampler.js.map +1 -1
  276. package/dist/engine/runtime_safety.d.ts.map +1 -1
  277. package/dist/engine/runtime_safety.js +7 -3
  278. package/dist/engine/runtime_safety.js.map +1 -1
  279. package/dist/engine/scaffolder.d.ts.map +1 -1
  280. package/dist/engine/scaffolder.js +7 -1
  281. package/dist/engine/scaffolder.js.map +1 -1
  282. package/dist/engine/scope_controller.d.ts.map +1 -1
  283. package/dist/engine/scope_controller.js +12 -1
  284. package/dist/engine/scope_controller.js.map +1 -1
  285. package/dist/engine/scope_lease.d.ts +43 -0
  286. package/dist/engine/scope_lease.d.ts.map +1 -1
  287. package/dist/engine/scope_lease.js +44 -0
  288. package/dist/engine/scope_lease.js.map +1 -1
  289. package/dist/engine/semantic_evidence.d.ts +6 -0
  290. package/dist/engine/semantic_evidence.d.ts.map +1 -1
  291. package/dist/engine/semantic_evidence.js +9 -0
  292. package/dist/engine/semantic_evidence.js.map +1 -1
  293. package/dist/engine/task_context.d.ts +36 -1
  294. package/dist/engine/task_context.d.ts.map +1 -1
  295. package/dist/engine/task_context.js +252 -13
  296. package/dist/engine/task_context.js.map +1 -1
  297. package/dist/engine/task_planner.d.ts.map +1 -1
  298. package/dist/engine/task_planner.js +13 -3
  299. package/dist/engine/task_planner.js.map +1 -1
  300. package/dist/engine/team_awareness.d.ts.map +1 -1
  301. package/dist/engine/team_awareness.js +8 -7
  302. package/dist/engine/team_awareness.js.map +1 -1
  303. package/dist/engine/template_mechanism_auditor.d.ts +93 -0
  304. package/dist/engine/template_mechanism_auditor.d.ts.map +1 -0
  305. package/dist/engine/template_mechanism_auditor.js +622 -0
  306. package/dist/engine/template_mechanism_auditor.js.map +1 -0
  307. package/dist/engine/test_generator.d.ts.map +1 -1
  308. package/dist/engine/test_generator.js +6 -0
  309. package/dist/engine/test_generator.js.map +1 -1
  310. package/dist/engine/test_quality.d.ts +6 -0
  311. package/dist/engine/test_quality.d.ts.map +1 -1
  312. package/dist/engine/test_quality.js +26 -10
  313. package/dist/engine/test_quality.js.map +1 -1
  314. package/dist/engine/tool_invocation_contract_registry.d.ts +136 -0
  315. package/dist/engine/tool_invocation_contract_registry.d.ts.map +1 -0
  316. package/dist/engine/tool_invocation_contract_registry.js +731 -0
  317. package/dist/engine/tool_invocation_contract_registry.js.map +1 -0
  318. package/dist/engine/traceability.d.ts +3 -0
  319. package/dist/engine/traceability.d.ts.map +1 -1
  320. package/dist/engine/traceability.js +12 -4
  321. package/dist/engine/traceability.js.map +1 -1
  322. package/dist/engine/user_feedback_contract.d.ts +162 -0
  323. package/dist/engine/user_feedback_contract.d.ts.map +1 -0
  324. package/dist/engine/user_feedback_contract.js +356 -0
  325. package/dist/engine/user_feedback_contract.js.map +1 -0
  326. package/dist/engine/verifier.d.ts +6 -1
  327. package/dist/engine/verifier.d.ts.map +1 -1
  328. package/dist/engine/verifier.js +114 -1
  329. package/dist/engine/verifier.js.map +1 -1
  330. package/dist/engine/workflow_contract_registry.d.ts +70 -0
  331. package/dist/engine/workflow_contract_registry.d.ts.map +1 -0
  332. package/dist/engine/workflow_contract_registry.js +501 -0
  333. package/dist/engine/workflow_contract_registry.js.map +1 -0
  334. package/dist/engine/workspace_resumer.d.ts.map +1 -1
  335. package/dist/engine/workspace_resumer.js +8 -0
  336. package/dist/engine/workspace_resumer.js.map +1 -1
  337. package/dist/engine/zero_config_init.d.ts +67 -2
  338. package/dist/engine/zero_config_init.d.ts.map +1 -1
  339. package/dist/engine/zero_config_init.js +410 -28
  340. package/dist/engine/zero_config_init.js.map +1 -1
  341. package/dist/git/operations.d.ts +101 -0
  342. package/dist/git/operations.d.ts.map +1 -1
  343. package/dist/git/operations.js +125 -9
  344. package/dist/git/operations.js.map +1 -1
  345. package/dist/index.d.ts +1 -1
  346. package/dist/index.js +16 -5
  347. package/dist/index.js.map +1 -1
  348. package/dist/knowledge/conflict_detector.d.ts +6 -0
  349. package/dist/knowledge/conflict_detector.d.ts.map +1 -1
  350. package/dist/knowledge/conflict_detector.js +7 -0
  351. package/dist/knowledge/conflict_detector.js.map +1 -1
  352. package/dist/knowledge/health_checker.d.ts +16 -0
  353. package/dist/knowledge/health_checker.d.ts.map +1 -1
  354. package/dist/knowledge/health_checker.js +24 -1
  355. package/dist/knowledge/health_checker.js.map +1 -1
  356. package/dist/knowledge/index_manager.d.ts +140 -2
  357. package/dist/knowledge/index_manager.d.ts.map +1 -1
  358. package/dist/knowledge/index_manager.js +186 -26
  359. package/dist/knowledge/index_manager.js.map +1 -1
  360. package/dist/knowledge/loader.d.ts +8 -1
  361. package/dist/knowledge/loader.d.ts.map +1 -1
  362. package/dist/knowledge/loader.js +56 -2
  363. package/dist/knowledge/loader.js.map +1 -1
  364. package/dist/knowledge/writer.d.ts +49 -1
  365. package/dist/knowledge/writer.d.ts.map +1 -1
  366. package/dist/knowledge/writer.js +55 -1
  367. package/dist/knowledge/writer.js.map +1 -1
  368. package/dist/types.d.ts +255 -1
  369. package/dist/types.d.ts.map +1 -1
  370. package/dist/utils/logger.d.ts +3 -0
  371. package/dist/utils/logger.d.ts.map +1 -0
  372. package/dist/utils/logger.js +29 -0
  373. package/dist/utils/logger.js.map +1 -0
  374. package/package.json +7 -7
  375. 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 +16 -0
  376. 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 +17 -0
  377. 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 +43 -0
  378. 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 +17 -0
  379. package/templates/knowledge/checklists//351/232/220/347/247/201/345/256/241/346/237/245/346/270/205/345/215/225.md +15 -0
  380. package/templates/knowledge/checklists//351/252/214/350/257/201/351/252/214/346/224/266/346/270/205/345/215/225.md +16 -0
  381. package/templates/knowledge/patterns/core//345/206/263/347/255/226/347/275/221/345/205/263.md +1 -0
  382. 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 +23 -0
  383. package/templates/knowledge/procedures//345/221/275/344/273/244/346/211/247/350/241/214/346/265/201/347/250/213.md +19 -0
  384. package/templates/knowledge/procedures//345/267/245/345/205/267/350/260/203/347/224/250/346/265/201/347/250/213.md +15 -0
  385. package/templates/knowledge/procedures//346/204/217/345/233/276/350/267/257/347/224/261/346/265/201/347/250/213.md +15 -0
  386. 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 +1 -1
  387. 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 +53 -0
  388. package/templates/knowledge/rules//344/272/247/347/211/251/345/245/221/347/272/246/350/247/204/345/210/231.md +21 -0
  389. package/templates/knowledge/rules//345/221/275/344/273/244/346/211/247/350/241/214/350/247/204/345/210/231.md +25 -0
  390. 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 +20 -0
  391. package/templates/knowledge/rules//345/267/245/345/205/267/350/260/203/347/224/250/350/247/204/345/210/231.md +25 -0
  392. package/templates/knowledge/rules//346/204/217/345/233/276/350/267/257/347/224/261/350/247/204/345/210/231.md +26 -0
  393. 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 +24 -0
  394. 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 +20 -0
  395. 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 +125 -0
  396. 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 +26 -0
  397. 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 +22 -0
  398. 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 +25 -0
  399. 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 +27 -0
  400. 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 +22 -0
  401. 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 +24 -0
  402. 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 +28 -0
  403. package/templates/knowledge/rules//351/252/214/350/257/201/345/245/221/347/272/246/350/247/204/345/210/231.md +25 -0
  404. package/templates/knowledge/templates/{review_summary.md → /345/256/241/346/237/245/346/221/230/350/246/201.md} +1 -1
  405. package/templates/config.yaml +0 -53
@@ -0,0 +1,563 @@
1
+ import crypto from "node:crypto";
2
+ import { isReadForbidden as privacyIsReadForbidden, isReadRequiresConfirmation as privacyIsReadRequiresConfirmation } from "./privacy_secret_contract.js";
3
+ import fs from "node:fs";
4
+ // ── 摄取策略:auto_allowed / requires_confirmation / forbidden 路径 ──
5
+ const AUTO_ALLOWED_PATTERNS = [
6
+ { pattern: /^\.soloforge\/(knowledge|output|state)\//, description: ".soloforge 内部文件" },
7
+ ];
8
+ const AUTO_ALLOWED_EXTENSIONS = [
9
+ ".json", ".yaml", ".yml", ".xml", ".toml", ".ini", ".env.example",
10
+ ".md", ".txt", ".rst", ".adoc",
11
+ ".ts", ".js", ".tsx", ".jsx", ".mjs", ".cjs",
12
+ ".java", ".kt", ".py", ".go", ".rs", ".rb", ".php", ".cs", ".swift",
13
+ ".html", ".css", ".scss", ".less",
14
+ ".sql", ".graphql", ".proto",
15
+ ".zip", ".tar", ".gz", ".rar", ".7z", ".jar", ".war",
16
+ ".csv", ".tsv",
17
+ ];
18
+ const REQUIRES_CONFIRMATION_PATTERNS = [
19
+ { pattern: /\/Downloads\//i, reason: "下载目录需确认" },
20
+ { pattern: /\/Desktop\//i, reason: "桌面目录需确认" },
21
+ { pattern: /\/\.ssh\//, reason: "SSH 目录敏感" },
22
+ { pattern: /\/\.aws\//, reason: "AWS 凭证目录敏感" },
23
+ { pattern: /\/\.config\//, reason: "配置目录敏感" },
24
+ { pattern: /\/\.gnupg\//, reason: "GPG 目录敏感" },
25
+ { pattern: /\.dump$|\.sql\.gz$|\.bak$/i, reason: "数据库 dump 或备份文件" },
26
+ { pattern: /prod|production/i, reason: "生产环境相关" },
27
+ { pattern: /^https?:\/\//i, reason: "外部 URL 未验证" },
28
+ { pattern: /\.exe$|\.bin$|\.sh$|\.bat$/i, reason: "可执行文件" },
29
+ { pattern: /\.fig$|\.sketch$/i, reason: "设计文件需确认" },
30
+ ];
31
+ const FORBIDDEN_PATTERNS = [
32
+ { pattern: /\/\.ssh\/id_/, reason: "SSH 私钥" },
33
+ { pattern: /\.pem$|\.key$|\.p12$|\.pfx$/i, reason: "密钥文件" },
34
+ { pattern: /token|secret|credential|password/i, reason: "凭证文件" },
35
+ { pattern: /\.kube\/config/, reason: "Kubernetes 凭证" },
36
+ { pattern: /\/\.ssh\/authorized_keys/, reason: "SSH 授权密钥" },
37
+ { pattern: /Cookies\.plist|cookies\.sqlite|Login Data/i, reason: "浏览器 cookie/session" },
38
+ { pattern: /\/Library\/Keychains\//, reason: "系统钥匙串" },
39
+ { pattern: /\.gnupg\/private-keys/i, reason: "GPG 私钥" },
40
+ ];
41
+ // ── 信任等级规则 ──
42
+ const TRUST_LEVEL_ORDER = {
43
+ authoritative: 5,
44
+ project_context: 4,
45
+ user_provided: 3,
46
+ external_unverified: 2,
47
+ ai_generated: 1,
48
+ derived: 0,
49
+ };
50
+ /** derived 和 ai_generated 不能单独支撑强结论 */
51
+ /**
52
+ * 判断指定信任等级是否可以支撑强结论。
53
+ * @description derived 和 ai_generated 等级不能单独支撑强结论。
54
+ * @param trustLevel - 信任等级
55
+ * @returns 是否可以支撑强结论
56
+ */
57
+ export function canSupportStrongConclusion(trustLevel) {
58
+ return TRUST_LEVEL_ORDER[trustLevel] >= TRUST_LEVEL_ORDER["user_provided"];
59
+ }
60
+ /** 提升信任等级需要 confirmation evidence */
61
+ /**
62
+ * 判断是否可以提升信任等级。
63
+ * @param from - 源信任等级
64
+ * @param to - 目标信任等级
65
+ * @param hasConfirmationEvidence - 是否有确认证据
66
+ * @returns 是否可以提升
67
+ */
68
+ export function canElevateTrust(from, to, hasConfirmationEvidence) {
69
+ if (TRUST_LEVEL_ORDER[to] <= TRUST_LEVEL_ORDER[from])
70
+ return false;
71
+ if (to === "authoritative" && !hasConfirmationEvidence)
72
+ return false;
73
+ return true;
74
+ }
75
+ // ── 作用域角色规则 ──
76
+ /** input_only 不得自动变成 project_scope 或 write scope */
77
+ /**
78
+ * 判断是否可以更改作用域角色。
79
+ * @description input_only 不得自动变为 project_scope 或 output_target。
80
+ * @param from - 源作用域角色
81
+ * @param to - 目标作用域角色
82
+ * @returns 是否允许更改
83
+ */
84
+ export function canChangeScopeRole(from, to) {
85
+ if (from === "input_only" && (to === "project_scope" || to === "output_target")) {
86
+ return false;
87
+ }
88
+ return true;
89
+ }
90
+ /** access_mode 为 read_only 的材料不得写入 */
91
+ /**
92
+ * 判断材料是否允许写入。
93
+ * @description access_mode 为 read_only 的材料不得写入。
94
+ * @param material - 输入材料
95
+ * @returns 是否允许写入
96
+ */
97
+ export function isWriteAllowed(material) {
98
+ return material.access_mode === "read_write" && material.scope_role === "output_target";
99
+ }
100
+ // ── 归档解压规则 ──
101
+ /** 归档解压隔离基准路径 */
102
+ export const ARCHIVE_EXTRACTION_BASE = ".soloforge/tmp/ingest";
103
+ /**
104
+ * 生成隔离解压路径。
105
+ * @param materialId - 材料 ID
106
+ * @returns 隔离解压路径
107
+ */
108
+ export function getExtractionPath(materialId) {
109
+ return `${ARCHIVE_EXTRACTION_BASE}/${materialId}`;
110
+ }
111
+ /** archive 不能直接解压到项目根 */
112
+ /**
113
+ * 判断解压路径是否被隔离。
114
+ * @description archive 不能直接解压到项目根。
115
+ * @param extractedTo - 实际解压路径
116
+ * @param projectRoot - 项目根目录
117
+ * @returns 解压路径是否在隔离区域内
118
+ */
119
+ export function isExtractionPathConfined(extractedTo, projectRoot) {
120
+ if (extractedTo.startsWith(projectRoot) && !extractedTo.includes(ARCHIVE_EXTRACTION_BASE)) {
121
+ return false;
122
+ }
123
+ return extractedTo.includes(ARCHIVE_EXTRACTION_BASE) || extractedTo.includes("/tmp/");
124
+ }
125
+ // ── 摄取状态分类 ──
126
+ /**
127
+ * 对指定路径或引用进行摄取状态分类。
128
+ * @description 优先检查隐私契约,再检查本地禁止/确认模式,默认为 auto_allowed。
129
+ * @param pathOrRef - 路径或引用字符串
130
+ * @returns 摄取状态(auto_allowed / requires_confirmation / forbidden)
131
+ */
132
+ export function classifyIngestionStatus(pathOrRef) {
133
+ console.error("[soloForge] InputMaterialContract: 分类摄取状态", { pathOrRef });
134
+ // 隐私契约优先 — 基于规范模式进行禁止/确认()
135
+ if (privacyIsReadForbidden(pathOrRef))
136
+ return "forbidden";
137
+ if (privacyIsReadRequiresConfirmation(pathOrRef))
138
+ return "requires_confirmation";
139
+ // 本地模式作为补充
140
+ for (const { pattern } of FORBIDDEN_PATTERNS) {
141
+ if (pattern.test(pathOrRef))
142
+ return "forbidden";
143
+ }
144
+ for (const { pattern } of REQUIRES_CONFIRMATION_PATTERNS) {
145
+ if (pattern.test(pathOrRef))
146
+ return "requires_confirmation";
147
+ }
148
+ return "auto_allowed";
149
+ }
150
+ // ── 材料类型检测 ──
151
+ /**
152
+ * 根据路径或引用检测材料类型。
153
+ * @param pathOrRef - 路径或引用字符串
154
+ * @returns 检测到的材料类型
155
+ */
156
+ export function detectMaterialKind(pathOrRef) {
157
+ if (/^https?:\/\//i.test(pathOrRef))
158
+ return "url";
159
+ if (/\.(zip|tar|tar\.gz|tgz|gz|rar|7z|jar|war)$/i.test(pathOrRef))
160
+ return "archive";
161
+ if (/\.(log|out)$/i.test(pathOrRef))
162
+ return "log";
163
+ if (/\.(png|jpg|jpeg|gif|bmp|svg|webp)$/i.test(pathOrRef))
164
+ return "image";
165
+ if (/\.(fig)$/i.test(pathOrRef))
166
+ return "figma";
167
+ if (/\.(yaml|yml|json)$/i.test(pathOrRef) && /api|openapi|swagger/i.test(pathOrRef))
168
+ return "api_spec";
169
+ if (/\.(sql|ddl)$/i.test(pathOrRef) && /schema|dump/i.test(pathOrRef))
170
+ return "db_schema";
171
+ if (/\.(md|txt|doc|docx|pdf|rst|adoc)$/i.test(pathOrRef))
172
+ return "document";
173
+ if (pathOrRef.endsWith("/") || /\/$/.test(pathOrRef))
174
+ return "directory";
175
+ if (pathOrRef.startsWith("/"))
176
+ return "external_file";
177
+ if (pathOrRef.startsWith("./") || pathOrRef.startsWith("../"))
178
+ return "project_file";
179
+ return "user_text";
180
+ }
181
+ // ── 摄取警告检测 ──
182
+ /**
183
+ * 检测材料的摄取警告。
184
+ * @param material - 输入材料
185
+ * @returns 警告信息列表
186
+ */
187
+ export function detectIngestionWarnings(material) {
188
+ const warnings = [];
189
+ if (material.trust_level === "derived") {
190
+ warnings.push("derived 材料不能单独支撑强结论");
191
+ }
192
+ if (material.trust_level === "ai_generated") {
193
+ warnings.push("AI 生成材料不能单独支撑强结论");
194
+ }
195
+ if (material.trust_level === "external_unverified") {
196
+ warnings.push("来源未验证,不得作为已验证事实");
197
+ }
198
+ if (material.scope_role === "input_only" && material.access_mode !== "read_only") {
199
+ warnings.push("input_only 材料应当 read_only");
200
+ }
201
+ if (material.kind === "archive" && material.extracted_to && !material.cleanup_required) {
202
+ warnings.push("archive 解压后应标记 cleanup_required");
203
+ }
204
+ if (material.size_bytes && material.size_bytes > 50 * 1024 * 1024) {
205
+ warnings.push("文件超过 50MB,不得全文注入 prompt");
206
+ }
207
+ return warnings;
208
+ }
209
+ /** 禁止注入 prompt 的材料类型(全量大文件) */
210
+ export const FORBIDDEN_SOURCE_KINDS = ["figma", "image"];
211
+ /** 禁止注入 prompt 的来源前缀列表 */
212
+ export const FORBIDDEN_SOURCE_PREFIXES = [
213
+ "figma://",
214
+ "figma.site",
215
+ "figma.com",
216
+ "x-callback-url://",
217
+ "browser://",
218
+ ];
219
+ /** 额外禁止注入 prompt 的来源名称列表 */
220
+ export const EXTRA_FORBIDDEN_SOURCES = [
221
+ "Figma MCP",
222
+ "browser runtime",
223
+ "figma.site",
224
+ "截图/Design 文件",
225
+ "猜测补充",
226
+ ];
227
+ /**
228
+ * 判断指定来源是否为禁止注入的来源。
229
+ * @description prompt 注入不得包含全量大文件。
230
+ * @param pathOrRef - 路径或引用
231
+ * @param kind - 材料类型
232
+ * @returns 是否为禁止来源
233
+ */
234
+ export function isForbiddenSource(pathOrRef, kind) {
235
+ if (FORBIDDEN_SOURCE_KINDS.includes(kind))
236
+ return true;
237
+ const lower = pathOrRef.toLowerCase();
238
+ for (const prefix of FORBIDDEN_SOURCE_PREFIXES) {
239
+ if (lower.includes(prefix.toLowerCase()))
240
+ return true;
241
+ }
242
+ return false;
243
+ }
244
+ /**
245
+ * 构建 prompt 注入计划。
246
+ * @description 遍历所有材料,分类为允许/禁止来源,生成摘要和确认列表。
247
+ * @param materials - 输入材料列表
248
+ * @param evidences - 可选的摄取证据列表
249
+ * @returns prompt 注入计划
250
+ */
251
+ export function buildPromptInjectionPlan(materials, evidences) {
252
+ const plan = {
253
+ required_summary: [],
254
+ evidence_refs: [],
255
+ selected_excerpts: [],
256
+ forbidden_notes: [],
257
+ manual_confirm_list: [],
258
+ allowed_sources: [],
259
+ forbidden_sources: [...EXTRA_FORBIDDEN_SOURCES],
260
+ };
261
+ for (let i = 0; i < materials.length; i++) {
262
+ const m = materials[i];
263
+ const ev = evidences?.[i];
264
+ const hashPart = ev?.hash ? `hash=${ev.hash}` : (ev && !ev.hash ? "hash=missing" : "");
265
+ const statusPart = ev ? `status=${ev.status}` : "";
266
+ plan.evidence_refs.push(`evidence_id=${ev?.evidence_id ?? "n/a"} material_id=${m.id} ${hashPart} ${statusPart}`.trim());
267
+ if (m.access_mode === "forbidden") {
268
+ plan.forbidden_notes.push(`材料 ${m.path_or_ref} 禁止使用`);
269
+ continue;
270
+ }
271
+ if (isForbiddenSource(m.path_or_ref, m.kind)) {
272
+ plan.forbidden_sources.push(m.path_or_ref);
273
+ continue;
274
+ }
275
+ plan.allowed_sources.push(m.path_or_ref);
276
+ if (m.trust_level === "external_unverified") {
277
+ plan.manual_confirm_list.push(`[Manual Confirm] ${m.path_or_ref} 来源未验证`);
278
+ }
279
+ if (m.trust_level === "derived" || m.trust_level === "ai_generated") {
280
+ plan.manual_confirm_list.push(`[Manual Confirm] ${m.path_or_ref} 为 ${m.trust_level},不可作为强事实`);
281
+ }
282
+ plan.required_summary.push(`摘要: ${m.path_or_ref} (kind=${m.kind}, trust=${m.trust_level})`);
283
+ }
284
+ return plan;
285
+ }
286
+ // ── 工厂函数 ──
287
+ /**
288
+ * 创建输入材料实例。
289
+ * @description 自动推断材料类型、摄取状态、信任等级和作用域角色。
290
+ * @param params - 材料参数(kind 可选,将自动推断)
291
+ * @returns 创建的输入材料
292
+ */
293
+ export function createInputMaterial(params) {
294
+ console.error("[soloForge] InputMaterialContract: 创建输入材料");
295
+ const id = `mat-${Date.now()}-${crypto.randomUUID().slice(0, 8)}`;
296
+ const kind = params.kind ?? detectMaterialKind(params.path_or_ref);
297
+ const status = classifyIngestionStatus(params.path_or_ref);
298
+ let accessMode = params.access_mode ?? "read_only";
299
+ if (status === "forbidden")
300
+ accessMode = "forbidden";
301
+ const trustLevel = params.trust_level ?? inferTrustLevel(kind, params.path_or_ref);
302
+ const scopeRole = params.scope_role ?? inferScopeRole(kind);
303
+ const extracted_to = kind === "archive" ? getExtractionPath(id) : undefined;
304
+ return {
305
+ id,
306
+ kind,
307
+ path_or_ref: params.path_or_ref,
308
+ access_mode: accessMode,
309
+ trust_level: trustLevel,
310
+ scope_role: scopeRole,
311
+ hash: params.hash,
312
+ extracted_to,
313
+ cleanup_required: kind === "archive",
314
+ size_bytes: params.size_bytes,
315
+ created_at: new Date().toISOString(),
316
+ };
317
+ }
318
+ function inferTrustLevel(kind, pathOrRef) {
319
+ if (kind === "url")
320
+ return "external_unverified";
321
+ if (kind === "figma")
322
+ return "external_unverified";
323
+ if (kind === "user_text" || kind === "clipboard")
324
+ return "user_provided";
325
+ if (kind === "project_file")
326
+ return "project_context";
327
+ if (kind === "image")
328
+ return "derived";
329
+ if (pathOrRef.startsWith("/") || pathOrRef.startsWith("~"))
330
+ return "user_provided";
331
+ return "user_provided";
332
+ }
333
+ function inferScopeRole(kind) {
334
+ if (kind === "project_file")
335
+ return "project_scope";
336
+ return "input_only";
337
+ }
338
+ /**
339
+ * 为指定材料创建摄取证据。
340
+ * @description 读取文件元数据/内容,计算 hash,检测摄取警告。
341
+ * @param material - 输入材料
342
+ * @returns 摄取证据
343
+ */
344
+ export function createIngestionEvidence(material) {
345
+ const warnings = detectIngestionWarnings(material);
346
+ let status = "pending";
347
+ let computedHash = material.hash;
348
+ let sizeBytes = material.size_bytes;
349
+ if (material.access_mode === "forbidden") {
350
+ status = "forbidden";
351
+ }
352
+ else {
353
+ const isLocalFile = material.kind === "project_file" || material.kind === "external_file"
354
+ || material.kind === "log" || material.kind === "document" || material.kind === "archive";
355
+ if (isLocalFile) {
356
+ const resolvedPath = material.path_or_ref.replace(/^~\//, (process.env.HOME || "/") + "/");
357
+ try {
358
+ const stat = fs.statSync(resolvedPath);
359
+ if (!sizeBytes)
360
+ sizeBytes = stat.size;
361
+ if (material.kind === "archive") {
362
+ // 归档文件:仅读取元数据,未解析内容
363
+ status = "metadata_read";
364
+ // 计算归档文件自身的 hash
365
+ try {
366
+ const fileBuf = fs.readFileSync(resolvedPath);
367
+ computedHash = "sha256:" + crypto.createHash("sha256").update(fileBuf).digest("hex");
368
+ }
369
+ catch {
370
+ warnings.push("archive hash 计算失败");
371
+ }
372
+ }
373
+ else {
374
+ // 非归档本地文件:完整读取并计算 hash
375
+ try {
376
+ const fileBuf = fs.readFileSync(resolvedPath);
377
+ computedHash = "sha256:" + crypto.createHash("sha256").update(fileBuf).digest("hex");
378
+ status = "read";
379
+ }
380
+ catch {
381
+ status = "metadata_read";
382
+ warnings.push("文件内容读取失败,hash 不可用");
383
+ }
384
+ }
385
+ }
386
+ catch {
387
+ status = "failed";
388
+ warnings.push(`文件不存在: ${material.path_or_ref}`);
389
+ }
390
+ }
391
+ }
392
+ return {
393
+ evidence_id: `ev-${material.id}`,
394
+ material_id: material.id,
395
+ source_ref: material.path_or_ref,
396
+ status,
397
+ hash: computedHash,
398
+ size_bytes: sizeBytes,
399
+ detected_kind: material.kind,
400
+ trust_level: material.trust_level,
401
+ access_mode: material.access_mode,
402
+ extracted_to: material.extracted_to,
403
+ parsed_artifacts: [],
404
+ warnings,
405
+ created_at: material.created_at ?? new Date().toISOString(),
406
+ };
407
+ }
408
+ // ── 治理校验 ──
409
+ /**
410
+ * 校验输入材料契约的合规性。
411
+ * @description 检查 scope、解压路径、cleanup、信任等级、摄取状态等 8 条规则。
412
+ * @param materials - 待校验的材料列表
413
+ * @returns 治理发现列表(hard_fail 为硬性错误,advisory 为建议项)
414
+ */
415
+ export function validateInputMaterialContracts(materials) {
416
+ console.error("[soloForge] InputMaterialContract: 开始校验输入材料契约", { count: materials.length });
417
+ const findings = [];
418
+ for (const m of materials) {
419
+ // 规则 1:input_only 不得进入 write scope
420
+ if (m.scope_role === "input_only" && m.access_mode === "read_write") {
421
+ findings.push({
422
+ severity: "hard_fail",
423
+ material_id: m.id,
424
+ rule: "gc-input-only-write",
425
+ message: `input_only 材料 ${m.id} 不得有 read_write access_mode`,
426
+ });
427
+ }
428
+ // 规则 2:archive 必须有隔离解压路径
429
+ if (m.kind === "archive") {
430
+ if (!m.extracted_to) {
431
+ findings.push({
432
+ severity: "hard_fail",
433
+ material_id: m.id,
434
+ rule: "gc-archive-no-extraction-path",
435
+ message: `archive ${m.id} 缺少 extracted_to 隔离路径`,
436
+ });
437
+ }
438
+ else if (m.extracted_to === "." || m.extracted_to === "./" || m.extracted_to === "/") {
439
+ findings.push({
440
+ severity: "hard_fail",
441
+ material_id: m.id,
442
+ rule: "gc-archive-root-extraction",
443
+ message: `archive ${m.id} 解压到项目根: ${m.extracted_to}`,
444
+ });
445
+ }
446
+ else if (!isExtractionPathConfined(m.extracted_to, ".")) {
447
+ findings.push({
448
+ severity: "hard_fail",
449
+ material_id: m.id,
450
+ rule: "gc-archive-unconfined-extraction",
451
+ message: `archive ${m.id} 解压路径未隔离: ${m.extracted_to}`,
452
+ });
453
+ }
454
+ }
455
+ // 规则 3:archive 必须标记 cleanup_required
456
+ if (m.kind === "archive" && !m.cleanup_required) {
457
+ findings.push({
458
+ severity: "advisory",
459
+ material_id: m.id,
460
+ rule: "gc-archive-no-cleanup",
461
+ message: `archive ${m.id} 未标记 cleanup_required`,
462
+ });
463
+ }
464
+ // 规则 4:derived/ai_generated 不得作为 authoritative
465
+ if ((m.trust_level === "derived" || m.trust_level === "ai_generated") &&
466
+ m.scope_role === "evidence_ref" &&
467
+ m.access_mode !== "forbidden") {
468
+ findings.push({
469
+ severity: "advisory",
470
+ material_id: m.id,
471
+ rule: "gc-low-trust-evidence",
472
+ message: `${m.trust_level} 材料 ${m.id} 作为 evidence_ref 不可支撑强结论`,
473
+ });
474
+ }
475
+ // 规则 5:forbidden 材料必须 access_mode=forbidden
476
+ const status = classifyIngestionStatus(m.path_or_ref);
477
+ if (status === "forbidden" && m.access_mode !== "forbidden") {
478
+ findings.push({
479
+ severity: "hard_fail",
480
+ material_id: m.id,
481
+ rule: "gc-forbidden-not-blocked",
482
+ message: `材料 ${m.id} 路径触发禁止规则但 access_mode 不是 forbidden`,
483
+ });
484
+ }
485
+ // 规则 6:requires_confirmation 路径应有确认
486
+ if (status === "requires_confirmation" && m.access_mode === "read_write") {
487
+ findings.push({
488
+ severity: "hard_fail",
489
+ material_id: m.id,
490
+ rule: "gc-sensitive-write",
491
+ message: `敏感路径 ${m.id} 需确认后才可读取,不得 read_write`,
492
+ });
493
+ }
494
+ // 规则 7:每个材料必须有 trust_level 和 scope_role
495
+ if (!m.trust_level) {
496
+ findings.push({
497
+ severity: "hard_fail",
498
+ material_id: m.id,
499
+ rule: "gc-no-trust-level",
500
+ message: `材料 ${m.id} 缺少 trust_level`,
501
+ });
502
+ }
503
+ if (!m.scope_role) {
504
+ findings.push({
505
+ severity: "hard_fail",
506
+ material_id: m.id,
507
+ rule: "gc-no-scope-role",
508
+ message: `材料 ${m.id} 缺少 scope_role`,
509
+ });
510
+ }
511
+ // 规则 8:大文件不得全文注入 prompt
512
+ if (m.size_bytes && m.size_bytes > 50 * 1024 * 1024 && m.scope_role !== "manual_reference") {
513
+ findings.push({
514
+ severity: "advisory",
515
+ material_id: m.id,
516
+ rule: "gc-large-file-injection",
517
+ message: `材料 ${m.id} 超过 50MB,应只注入摘要`,
518
+ });
519
+ }
520
+ }
521
+ return findings;
522
+ }
523
+ /**
524
+ * 验证 IngestionEvidence 完整性。
525
+ * @param evidence - 摄取证据
526
+ * @returns 治理发现列表
527
+ */
528
+ export function validateIngestionEvidence(evidence) {
529
+ const findings = [];
530
+ if (!evidence.evidence_id) {
531
+ findings.push({
532
+ severity: "hard_fail",
533
+ rule: "gc-no-evidence-id",
534
+ message: "IngestionEvidence 缺少 evidence_id",
535
+ });
536
+ }
537
+ if (!evidence.material_id) {
538
+ findings.push({
539
+ severity: "hard_fail",
540
+ rule: "gc-no-material-id",
541
+ message: "IngestionEvidence 缺少 material_id",
542
+ });
543
+ }
544
+ if (!evidence.created_at) {
545
+ findings.push({
546
+ severity: "advisory",
547
+ rule: "gc-no-created-at",
548
+ message: "IngestionEvidence 缺少 created_at",
549
+ });
550
+ }
551
+ // 本地文件证据缺少 hash 时应有警告
552
+ const isLocalFile = evidence.detected_kind === "project_file" || evidence.detected_kind === "external_file"
553
+ || evidence.detected_kind === "log" || evidence.detected_kind === "document";
554
+ if (isLocalFile && evidence.status === "read" && !evidence.hash) {
555
+ findings.push({
556
+ severity: "advisory",
557
+ rule: "gc-no-hash-on-read",
558
+ message: `IngestionEvidence ${evidence.evidence_id} status=read 但无 hash`,
559
+ });
560
+ }
561
+ return findings;
562
+ }
563
+ //# sourceMappingURL=input_material_contract_registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"input_material_contract_registry.js","sourceRoot":"","sources":["../../src/engine/input_material_contract_registry.ts"],"names":[],"mappings":"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"}
@@ -1,18 +1,7 @@
1
- /**
2
- * 意图膨胀器 — 将分类结果扩展为包含完整上下文的 AI 执行 prompt。
3
- *
4
- * 核心职责:
5
- * - 查询知识库获取匹配的领域知识
6
- * - 检测遗留代码惯例(通过 convention_detector)
7
- * - 解析 scope(允许修改路径、新建文件规则)
8
- * - 生成验收标准(自动 + 人工)
9
- * - 组装 Handlebars 模板生成最终 prompt
10
- * - 生成执行契约(能力 1: 约束 + 停止条件)
11
- * - 生成不确定性触发条件(能力 4: DDL/权限/金额等高风险模式识别)
12
- */
13
1
  import type { ProjectConfig, ClassifyResult, ExpandResult, SubTask } from "../types.js";
14
2
  import type { KnowledgeIndexManager } from "../knowledge/index_manager.js";
15
- /** 计划阶段上下文: 用于多阶段执行时注入当前步骤信息 */
3
+ import { type IntentRouteDecision } from "./intent_router.js";
4
+ /** 计划阶段上下文 */
16
5
  export interface PlanContext {
17
6
  current_step: SubTask;
18
7
  previous_outputs: Record<string, string>;
@@ -26,35 +15,27 @@ export interface ExpandInput {
26
15
  knowledgeIndex: KnowledgeIndexManager;
27
16
  clarificationAnswers?: string[];
28
17
  plan_context?: PlanContext;
18
+ route_decision?: IntentRouteDecision;
19
+ input_material_confirmations?: string[];
20
+ task_id?: string;
29
21
  }
30
22
  /**
31
23
  * 将分类结果扩展为完整的 AI 执行 prompt 和配套元数据。
32
- * @param input - 膨胀输入,包含意图、分类结果、项目配置、知识索引等
33
- * @returns 膨胀结果,包含 prompt / scope / 验收标准 / 执行契约 / 不确定性触发条件
34
24
  */
35
25
  export declare function expand(input: ExpandInput): Promise<ExpandResult>;
36
- /** 熔断触发结果 */
37
26
  export interface CircuitBreakerResult {
38
- /** 是否触发熔断 */
39
27
  tripped: boolean;
40
- /** 置信度 (0-1) */
41
28
  confidence: number;
42
- /** 熔断原因 */
43
29
  reason?: string;
44
- /** 头脑风暴输出(熔断时生成) */
45
30
  brainstorm?: BrainstormOutput;
46
31
  }
47
- /** 头脑风暴输出 */
48
32
  export interface BrainstormOutput {
49
- /** 三个逻辑盲区 */
50
33
  blind_spots: string[];
51
- /** 三轨演进路径 */
52
34
  evolution_tracks: {
53
35
  minimal: string;
54
36
  industrial: string;
55
37
  radical: string;
56
38
  };
57
- /** 闭环逼问(≤3 个 A/B 选择题) */
58
39
  decision_questions: Array<{
59
40
  question: string;
60
41
  option_a: string;
@@ -62,9 +43,9 @@ export interface BrainstormOutput {
62
43
  }>;
63
44
  }
64
45
  /**
65
- * 置信度熔断器评估意图清晰度,低于阈值触发 sf_brainstorm 模式。
66
- * 评估维度: 知识匹配度、意图明确性、分类一致性。
67
- * 熔断后不输出执行代码,而是输出头脑风暴结构供人类决策。
46
+ * 意图熔断器评估意图理解置信度,低于阈值时触发熔断并生成头脑风暴辅助决策。
47
+ * @param params - 熔断器参数,包含意图、分类结果、匹配知识条目和降级标记
48
+ * @returns 熔断结果,包含是否触发、置信度、原因和头脑风暴输出
68
49
  */
69
50
  export declare function checkCircuitBreaker(params: {
70
51
  intent: string;