briefloop 0.11.12__py3-none-any.whl

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 (424) hide show
  1. briefloop-0.11.12.dist-info/METADATA +473 -0
  2. briefloop-0.11.12.dist-info/RECORD +424 -0
  3. briefloop-0.11.12.dist-info/WHEEL +5 -0
  4. briefloop-0.11.12.dist-info/entry_points.txt +3 -0
  5. briefloop-0.11.12.dist-info/licenses/LICENSE +22 -0
  6. briefloop-0.11.12.dist-info/top_level.txt +1 -0
  7. multi_agent_brief/__init__.py +36 -0
  8. multi_agent_brief/analysis_blocks/__init__.py +11 -0
  9. multi_agent_brief/analysis_blocks/builder.py +206 -0
  10. multi_agent_brief/analysis_blocks/renderer.py +237 -0
  11. multi_agent_brief/analysis_blocks/schemas.py +52 -0
  12. multi_agent_brief/analysis_modules/__init__.py +8 -0
  13. multi_agent_brief/analysis_modules/base.py +87 -0
  14. multi_agent_brief/analysis_modules/market_competitor/__init__.py +68 -0
  15. multi_agent_brief/analysis_modules/market_competitor/auditor.py +290 -0
  16. multi_agent_brief/analysis_modules/market_competitor/config.py +187 -0
  17. multi_agent_brief/analysis_modules/market_competitor/event_builder.py +226 -0
  18. multi_agent_brief/analysis_modules/market_competitor/renderer.py +199 -0
  19. multi_agent_brief/analysis_modules/market_competitor/schemas.py +518 -0
  20. multi_agent_brief/analysis_modules/policy_regulatory/__init__.py +7 -0
  21. multi_agent_brief/analysis_modules/policy_regulatory/audit.py +195 -0
  22. multi_agent_brief/analysis_modules/policy_regulatory/module.py +387 -0
  23. multi_agent_brief/analysis_modules/policy_regulatory/schemas.py +129 -0
  24. multi_agent_brief/analysis_modules/registry.py +73 -0
  25. multi_agent_brief/audience/__init__.py +19 -0
  26. multi_agent_brief/audience/profiles.py +246 -0
  27. multi_agent_brief/audience_memory/__init__.py +23 -0
  28. multi_agent_brief/audience_memory/profile.py +358 -0
  29. multi_agent_brief/audit/__init__.py +36 -0
  30. multi_agent_brief/audit/case_applicability.py +181 -0
  31. multi_agent_brief/audit/deterministic.py +471 -0
  32. multi_agent_brief/audit/editorial_governance.py +404 -0
  33. multi_agent_brief/audit/final_quality.py +764 -0
  34. multi_agent_brief/audit/harness.py +242 -0
  35. multi_agent_brief/audit/interfaces.py +96 -0
  36. multi_agent_brief/audit/limitation_hygiene.py +238 -0
  37. multi_agent_brief/audit/proposal_boundary.py +34 -0
  38. multi_agent_brief/audit/redaction.py +27 -0
  39. multi_agent_brief/audit/rule_packs.py +96 -0
  40. multi_agent_brief/audit/semantic.py +435 -0
  41. multi_agent_brief/capabilities/__init__.py +22 -0
  42. multi_agent_brief/capabilities/catalog.py +215 -0
  43. multi_agent_brief/capabilities/detect.py +199 -0
  44. multi_agent_brief/capabilities/models.py +60 -0
  45. multi_agent_brief/capabilities/recommend.py +206 -0
  46. multi_agent_brief/cli/__init__.py +2 -0
  47. multi_agent_brief/cli/analysis_commands.py +140 -0
  48. multi_agent_brief/cli/approval_commands.py +107 -0
  49. multi_agent_brief/cli/audit_commands.py +59 -0
  50. multi_agent_brief/cli/capability_commands.py +548 -0
  51. multi_agent_brief/cli/claude_commands.py +159 -0
  52. multi_agent_brief/cli/competitors_commands.py +182 -0
  53. multi_agent_brief/cli/controls_commands.py +137 -0
  54. multi_agent_brief/cli/deliver_commands.py +942 -0
  55. multi_agent_brief/cli/eval_cases_commands.py +99 -0
  56. multi_agent_brief/cli/experiments_commands.py +395 -0
  57. multi_agent_brief/cli/feedback_commands.py +192 -0
  58. multi_agent_brief/cli/finalize_commands.py +153 -0
  59. multi_agent_brief/cli/gates_commands.py +174 -0
  60. multi_agent_brief/cli/hermes_commands.py +356 -0
  61. multi_agent_brief/cli/improve_commands.py +224 -0
  62. multi_agent_brief/cli/init_commands.py +564 -0
  63. multi_agent_brief/cli/init_wizard.py +1473 -0
  64. multi_agent_brief/cli/input_commands.py +237 -0
  65. multi_agent_brief/cli/main.py +288 -0
  66. multi_agent_brief/cli/onboard_commands.py +193 -0
  67. multi_agent_brief/cli/product_commands.py +1449 -0
  68. multi_agent_brief/cli/provenance_commands.py +100 -0
  69. multi_agent_brief/cli/release_commands.py +68 -0
  70. multi_agent_brief/cli/repair_commands.py +169 -0
  71. multi_agent_brief/cli/run_commands.py +292 -0
  72. multi_agent_brief/cli/runtime_commands.py +81 -0
  73. multi_agent_brief/cli/secrets_commands.py +232 -0
  74. multi_agent_brief/cli/semantic_support_commands.py +80 -0
  75. multi_agent_brief/cli/sources_commands.py +647 -0
  76. multi_agent_brief/cli/start_commands.py +8 -0
  77. multi_agent_brief/cli/state_commands.py +446 -0
  78. multi_agent_brief/cli/status_commands.py +26 -0
  79. multi_agent_brief/cli/workbuddy_commands.py +103 -0
  80. multi_agent_brief/configs/artifact_contracts.yaml +514 -0
  81. multi_agent_brief/configs/orchestrator_contract.yaml +181 -0
  82. multi_agent_brief/configs/policy_packs/default.yaml +65 -0
  83. multi_agent_brief/configs/policy_profiles/evidence_extract_default.yaml +58 -0
  84. multi_agent_brief/configs/policy_profiles/finance_default.yaml +44 -0
  85. multi_agent_brief/configs/policy_profiles/internet_default.yaml +44 -0
  86. multi_agent_brief/configs/policy_profiles/manufacturing_default.yaml +33 -0
  87. multi_agent_brief/configs/policy_profiles/solar_manufacturing_default.yaml +64 -0
  88. multi_agent_brief/configs/report_packs/evidence_extract.yaml +48 -0
  89. multi_agent_brief/configs/report_packs/management_monthly.yaml +36 -0
  90. multi_agent_brief/configs/report_packs/market_weekly.yaml +36 -0
  91. multi_agent_brief/configs/report_packs/solar_industry_periodic.yaml +50 -0
  92. multi_agent_brief/configs/report_templates/evidence_extract.yaml +55 -0
  93. multi_agent_brief/configs/report_templates/management_monthly.yaml +48 -0
  94. multi_agent_brief/configs/report_templates/market_weekly.yaml +49 -0
  95. multi_agent_brief/configs/report_templates/solar_industry_periodic.yaml +75 -0
  96. multi_agent_brief/configs/stage_specs.yaml +180 -0
  97. multi_agent_brief/contracts/__init__.py +41 -0
  98. multi_agent_brief/contracts/base.py +99 -0
  99. multi_agent_brief/contracts/errors.py +41 -0
  100. multi_agent_brief/contracts/migrations/__init__.py +5 -0
  101. multi_agent_brief/contracts/migrations/claim_v1_to_v2.py +33 -0
  102. multi_agent_brief/contracts/registry.py +159 -0
  103. multi_agent_brief/contracts/role_topology.py +25 -0
  104. multi_agent_brief/contracts/schemas/__init__.py +35 -0
  105. multi_agent_brief/contracts/schemas/analysis_pack.py +135 -0
  106. multi_agent_brief/contracts/schemas/atomic_claim_graph.py +304 -0
  107. multi_agent_brief/contracts/schemas/audit_report.py +80 -0
  108. multi_agent_brief/contracts/schemas/candidate_item.py +51 -0
  109. multi_agent_brief/contracts/schemas/claim.py +197 -0
  110. multi_agent_brief/contracts/schemas/claim_draft.py +386 -0
  111. multi_agent_brief/contracts/schemas/claim_support_matrix.py +334 -0
  112. multi_agent_brief/contracts/schemas/evidence_span_registry.py +270 -0
  113. multi_agent_brief/contracts/schemas/policy_profile.py +247 -0
  114. multi_agent_brief/contracts/schemas/report_spec.py +257 -0
  115. multi_agent_brief/contracts/schemas/semantic_assessment_report.py +480 -0
  116. multi_agent_brief/contracts/schemas/source_evidence_pack_manifest.py +233 -0
  117. multi_agent_brief/contracts/schemas/source_item.py +96 -0
  118. multi_agent_brief/contracts/semantic_assessment_status.py +12 -0
  119. multi_agent_brief/contracts/source_metadata.py +252 -0
  120. multi_agent_brief/contracts/target_contract.py +460 -0
  121. multi_agent_brief/contracts/validator.py +225 -0
  122. multi_agent_brief/controls/__init__.py +23 -0
  123. multi_agent_brief/controls/contract.py +106 -0
  124. multi_agent_brief/controls/switchboard.py +1076 -0
  125. multi_agent_brief/core/__init__.py +2 -0
  126. multi_agent_brief/core/citations.py +14 -0
  127. multi_agent_brief/core/claim_ledger.py +94 -0
  128. multi_agent_brief/core/config.py +191 -0
  129. multi_agent_brief/core/env.py +69 -0
  130. multi_agent_brief/core/previous.py +83 -0
  131. multi_agent_brief/core/schemas.py +181 -0
  132. multi_agent_brief/core/selection.py +189 -0
  133. multi_agent_brief/delivery/__init__.py +6 -0
  134. multi_agent_brief/delivery/base.py +36 -0
  135. multi_agent_brief/delivery/feishu.py +204 -0
  136. multi_agent_brief/delivery/gws.py +237 -0
  137. multi_agent_brief/evaluation_cases/__init__.py +15 -0
  138. multi_agent_brief/evaluation_cases/contract.py +429 -0
  139. multi_agent_brief/evaluation_cases/fixtures/cases/approved_guidance_materialized/workspace/config.yaml +18 -0
  140. multi_agent_brief/evaluation_cases/fixtures/cases/approved_guidance_materialized/workspace/improvement/ledger.jsonl +2 -0
  141. multi_agent_brief/evaluation_cases/fixtures/cases/approved_guidance_materialized/workspace/sources.yaml +2 -0
  142. multi_agent_brief/evaluation_cases/fixtures/cases/approved_guidance_materialized/workspace/user.md +4 -0
  143. multi_agent_brief/evaluation_cases/fixtures/cases/company_event_missing_latest_official_check/workspace/config.yaml +13 -0
  144. multi_agent_brief/evaluation_cases/fixtures/cases/company_event_missing_latest_official_check/workspace/sources.yaml +9 -0
  145. multi_agent_brief/evaluation_cases/fixtures/cases/company_event_missing_latest_official_check/workspace/user.md +4 -0
  146. multi_agent_brief/evaluation_cases/fixtures/cases/control_switchboard_selection_is_not_execution/workspace/config.yaml +12 -0
  147. multi_agent_brief/evaluation_cases/fixtures/cases/control_switchboard_selection_is_not_execution/workspace/sources.yaml +6 -0
  148. multi_agent_brief/evaluation_cases/fixtures/cases/control_switchboard_selection_is_not_execution/workspace/user.md +4 -0
  149. multi_agent_brief/evaluation_cases/fixtures/cases/feedback_triage_required/workspace/config.yaml +6 -0
  150. multi_agent_brief/evaluation_cases/fixtures/cases/feedback_triage_required/workspace/input/human_feedback.md +1 -0
  151. multi_agent_brief/evaluation_cases/fixtures/cases/feedback_triage_required/workspace/sources.yaml +2 -0
  152. multi_agent_brief/evaluation_cases/fixtures/cases/feedback_triage_required/workspace/user.md +3 -0
  153. multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/config.yaml +8 -0
  154. multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/brief.md +14 -0
  155. multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/intermediate/audit_report.json +1 -0
  156. multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/intermediate/audited_brief.md +5 -0
  157. multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/intermediate/candidate_claims.json +1 -0
  158. multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/intermediate/claim_ledger.json +1 -0
  159. multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/intermediate/screened_candidates.json +1 -0
  160. multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/sources.yaml +2 -0
  161. multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/user.md +3 -0
  162. multi_agent_brief/evaluation_cases/fixtures/cases/formal_release_missing_human_approval/workspace/config.yaml +13 -0
  163. multi_agent_brief/evaluation_cases/fixtures/cases/formal_release_missing_human_approval/workspace/sources.yaml +9 -0
  164. multi_agent_brief/evaluation_cases/fixtures/cases/formal_release_missing_human_approval/workspace/user.md +4 -0
  165. multi_agent_brief/evaluation_cases/fixtures/cases/guidance_manifestation_not_observable/workspace/config.yaml +4 -0
  166. multi_agent_brief/evaluation_cases/fixtures/cases/guidance_manifestation_not_observable/workspace/sources.yaml +2 -0
  167. multi_agent_brief/evaluation_cases/fixtures/cases/guidance_manifestation_not_observable/workspace/user.md +3 -0
  168. multi_agent_brief/evaluation_cases/fixtures/cases/media_only_legal_policy_blocks_research_review/workspace/config.yaml +13 -0
  169. multi_agent_brief/evaluation_cases/fixtures/cases/media_only_legal_policy_blocks_research_review/workspace/sources.yaml +9 -0
  170. multi_agent_brief/evaluation_cases/fixtures/cases/media_only_legal_policy_blocks_research_review/workspace/user.md +4 -0
  171. multi_agent_brief/evaluation_cases/fixtures/cases/mixed_metric_scope_support_blocker/workspace/config.yaml +13 -0
  172. multi_agent_brief/evaluation_cases/fixtures/cases/mixed_metric_scope_support_blocker/workspace/sources.yaml +9 -0
  173. multi_agent_brief/evaluation_cases/fixtures/cases/mixed_metric_scope_support_blocker/workspace/user.md +5 -0
  174. multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/config.yaml +6 -0
  175. multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/audited_brief.md +3 -0
  176. multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/candidate_claims.json +1 -0
  177. multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/claim_ledger.json +1 -0
  178. multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/feedback_issues.json +25 -0
  179. multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/repair_plan.json +27 -0
  180. multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/screened_candidates.json +1 -0
  181. multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/sources.yaml +2 -0
  182. multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/user.md +3 -0
  183. multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/config.yaml +8 -0
  184. multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/audit_report.json +1 -0
  185. multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/audited_brief.md +3 -0
  186. multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/candidate_claims.json +1 -0
  187. multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/claim_ledger.json +11 -0
  188. multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/quality_gate_report.json +22 -0
  189. multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/screened_candidates.json +1 -0
  190. multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/sources.yaml +2 -0
  191. multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/user.md +3 -0
  192. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/config.yaml +13 -0
  193. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/output/intermediate/audit_report.json +1 -0
  194. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/output/intermediate/audited_brief.md +5 -0
  195. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/output/intermediate/candidate_claims.json +1 -0
  196. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/output/intermediate/claim_ledger.json +40 -0
  197. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/output/intermediate/screened_candidates.json +1 -0
  198. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/sources.yaml +3 -0
  199. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/user.md +3 -0
  200. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/config.yaml +8 -0
  201. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/brief.md +3 -0
  202. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/intermediate/audit_report.json +1 -0
  203. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/intermediate/audited_brief.md +3 -0
  204. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/intermediate/candidate_claims.json +1 -0
  205. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/intermediate/claim_ledger.json +13 -0
  206. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/intermediate/screened_candidates.json +1 -0
  207. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/sources.yaml +2 -0
  208. multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/user.md +3 -0
  209. multi_agent_brief/evaluation_cases/fixtures/cases/release_readiness_forged_event_blocker/workspace/config.yaml +13 -0
  210. multi_agent_brief/evaluation_cases/fixtures/cases/release_readiness_forged_event_blocker/workspace/output/intermediate/release_readiness_report.json +31 -0
  211. multi_agent_brief/evaluation_cases/fixtures/cases/release_readiness_forged_event_blocker/workspace/sources.yaml +9 -0
  212. multi_agent_brief/evaluation_cases/fixtures/cases/release_readiness_forged_event_blocker/workspace/user.md +4 -0
  213. multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/config.yaml +18 -0
  214. multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/improvement/ledger.jsonl +3 -0
  215. multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/improvement/memory.md +3 -0
  216. multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/output/intermediate/improvement_memory_snapshot.md +3 -0
  217. multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/sources.yaml +2 -0
  218. multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/user.md +4 -0
  219. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/config.yaml +12 -0
  220. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/input/sources/source-001.txt +1 -0
  221. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/brief.md +37 -0
  222. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/delivery/brief.md +37 -0
  223. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/atomic_claim_graph.json +17 -0
  224. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/audit_report.json +5 -0
  225. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/audited_brief.md +37 -0
  226. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/claim_ledger.json +20 -0
  227. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/evidence_span_registry.json +20 -0
  228. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/finalize_report.json +40 -0
  229. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/gates/auditor_quality_gate_report.json +42 -0
  230. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/gates/finalize_quality_gate_report.json +42 -0
  231. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/screened_candidates.json +33 -0
  232. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/source_appendix.md +12 -0
  233. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/source_appendix_trace.md +10 -0
  234. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/report_spec.yaml +24 -0
  235. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/sources.yaml +4 -0
  236. multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/user.md +3 -0
  237. multi_agent_brief/evaluation_cases/fixtures/cases/source_evidence_pack_blocks_non_evidence_file/workspace/config.yaml +13 -0
  238. multi_agent_brief/evaluation_cases/fixtures/cases/source_evidence_pack_blocks_non_evidence_file/workspace/input/sources/README.md +4 -0
  239. multi_agent_brief/evaluation_cases/fixtures/cases/source_evidence_pack_blocks_non_evidence_file/workspace/output/intermediate/source_evidence_pack_manifest.json +26 -0
  240. multi_agent_brief/evaluation_cases/fixtures/cases/source_evidence_pack_blocks_non_evidence_file/workspace/sources.yaml +9 -0
  241. multi_agent_brief/evaluation_cases/fixtures/cases/source_evidence_pack_blocks_non_evidence_file/workspace/user.md +4 -0
  242. multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/config.yaml +9 -0
  243. multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/output/intermediate/audit_report.json +1 -0
  244. multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/output/intermediate/audited_brief.md +3 -0
  245. multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/output/intermediate/candidate_claims.json +1 -0
  246. multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/output/intermediate/claim_ledger.json +13 -0
  247. multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/output/intermediate/screened_candidates.json +1 -0
  248. multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/sources.yaml +2 -0
  249. multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/user.md +3 -0
  250. multi_agent_brief/evaluation_cases/fixtures/cases/third_party_price_snapshot_formal_block/workspace/config.yaml +13 -0
  251. multi_agent_brief/evaluation_cases/fixtures/cases/third_party_price_snapshot_formal_block/workspace/sources.yaml +9 -0
  252. multi_agent_brief/evaluation_cases/fixtures/cases/third_party_price_snapshot_formal_block/workspace/user.md +4 -0
  253. multi_agent_brief/evaluation_cases/fixtures/cases/trajectory_retry_budget_exhausted/workspace/config.yaml +4 -0
  254. multi_agent_brief/evaluation_cases/fixtures/cases/trajectory_retry_budget_exhausted/workspace/sources.yaml +2 -0
  255. multi_agent_brief/evaluation_cases/fixtures/cases/trajectory_retry_budget_exhausted/workspace/user.md +3 -0
  256. multi_agent_brief/evaluation_cases/fixtures/cases/unapproved_entry_not_materialized/workspace/config.yaml +18 -0
  257. multi_agent_brief/evaluation_cases/fixtures/cases/unapproved_entry_not_materialized/workspace/improvement/ledger.jsonl +1 -0
  258. multi_agent_brief/evaluation_cases/fixtures/cases/unapproved_entry_not_materialized/workspace/sources.yaml +2 -0
  259. multi_agent_brief/evaluation_cases/fixtures/cases/unapproved_entry_not_materialized/workspace/user.md +4 -0
  260. multi_agent_brief/evaluation_cases/fixtures/cases/unauthorized_institution_branding_blocks_release/workspace/config.yaml +18 -0
  261. multi_agent_brief/evaluation_cases/fixtures/cases/unauthorized_institution_branding_blocks_release/workspace/sources.yaml +9 -0
  262. multi_agent_brief/evaluation_cases/fixtures/cases/unauthorized_institution_branding_blocks_release/workspace/user.md +5 -0
  263. multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/config.yaml +8 -0
  264. multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/output/intermediate/audit_report.json +1 -0
  265. multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/output/intermediate/audited_brief.md +8 -0
  266. multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/output/intermediate/candidate_claims.json +1 -0
  267. multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/output/intermediate/claim_ledger.json +1 -0
  268. multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/output/intermediate/screened_candidates.json +1 -0
  269. multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/sources.yaml +2 -0
  270. multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/user.md +3 -0
  271. multi_agent_brief/evaluation_cases/fixtures/manifest.yaml +861 -0
  272. multi_agent_brief/evaluation_cases/fixtures.py +20 -0
  273. multi_agent_brief/evaluation_cases/runner.py +1603 -0
  274. multi_agent_brief/experiments/__init__.py +45 -0
  275. multi_agent_brief/experiments/experiment_080.py +5835 -0
  276. multi_agent_brief/experiments/schemas.py +63 -0
  277. multi_agent_brief/experiments/target_contract.py +10 -0
  278. multi_agent_brief/feedback/__init__.py +17 -0
  279. multi_agent_brief/feedback/feedback_contract.py +482 -0
  280. multi_agent_brief/feedback/feedback_state.py +898 -0
  281. multi_agent_brief/hermes/__init__.py +25 -0
  282. multi_agent_brief/hermes/adapter.py +832 -0
  283. multi_agent_brief/improvement/__init__.py +83 -0
  284. multi_agent_brief/improvement/contract.py +1114 -0
  285. multi_agent_brief/improvement/memory.py +451 -0
  286. multi_agent_brief/improvement/product_definition.py +228 -0
  287. multi_agent_brief/improvement/state.py +961 -0
  288. multi_agent_brief/inputs/__init__.py +2 -0
  289. multi_agent_brief/inputs/classifier.py +322 -0
  290. multi_agent_brief/inputs/contracts.py +59 -0
  291. multi_agent_brief/inputs/extractor.py +310 -0
  292. multi_agent_brief/install/__init__.py +2 -0
  293. multi_agent_brief/install/writer.py +97 -0
  294. multi_agent_brief/onboarding/__init__.py +11 -0
  295. multi_agent_brief/onboarding/io.py +103 -0
  296. multi_agent_brief/onboarding/mapper.py +484 -0
  297. multi_agent_brief/onboarding/schema.py +46 -0
  298. multi_agent_brief/orchestrator/__init__.py +2 -0
  299. multi_agent_brief/orchestrator/fact_layer_import.py +352 -0
  300. multi_agent_brief/orchestrator/handoff.py +2209 -0
  301. multi_agent_brief/orchestrator/role_topology.py +42 -0
  302. multi_agent_brief/orchestrator/run_archive.py +888 -0
  303. multi_agent_brief/orchestrator/run_integrity.py +346 -0
  304. multi_agent_brief/orchestrator/runtime_state/__init__.py +70 -0
  305. multi_agent_brief/orchestrator/runtime_state/_io.py +167 -0
  306. multi_agent_brief/orchestrator/runtime_state/_transactions.py +298 -0
  307. multi_agent_brief/orchestrator/runtime_state/artifact_registry.py +1825 -0
  308. multi_agent_brief/orchestrator/runtime_state/atomic_claim_graph.py +96 -0
  309. multi_agent_brief/orchestrator/runtime_state/claim_ledger_freeze.py +510 -0
  310. multi_agent_brief/orchestrator/runtime_state/claim_metadata_enrichment.py +836 -0
  311. multi_agent_brief/orchestrator/runtime_state/claim_support_matrix.py +582 -0
  312. multi_agent_brief/orchestrator/runtime_state/completion_gates.py +672 -0
  313. multi_agent_brief/orchestrator/runtime_state/contracts_loader.py +66 -0
  314. multi_agent_brief/orchestrator/runtime_state/decisions.py +239 -0
  315. multi_agent_brief/orchestrator/runtime_state/errors.py +61 -0
  316. multi_agent_brief/orchestrator/runtime_state/event_log.py +256 -0
  317. multi_agent_brief/orchestrator/runtime_state/evidence_span_registry.py +233 -0
  318. multi_agent_brief/orchestrator/runtime_state/fact_layer.py +755 -0
  319. multi_agent_brief/orchestrator/runtime_state/identity.py +90 -0
  320. multi_agent_brief/orchestrator/runtime_state/lifecycle.py +675 -0
  321. multi_agent_brief/orchestrator/runtime_state/manifest.py +82 -0
  322. multi_agent_brief/orchestrator/runtime_state/operations.py +224 -0
  323. multi_agent_brief/orchestrator/runtime_state/paths.py +38 -0
  324. multi_agent_brief/orchestrator/runtime_state/repair.py +984 -0
  325. multi_agent_brief/orchestrator/runtime_state/safety_surfaces.py +147 -0
  326. multi_agent_brief/orchestrator/runtime_state/semantic_assessment_report.py +692 -0
  327. multi_agent_brief/orchestrator/runtime_state/semantic_support_acceptance.py +683 -0
  328. multi_agent_brief/orchestrator/runtime_state/source_evidence_pack.py +131 -0
  329. multi_agent_brief/orchestrator/runtime_state/stage_completion.py +1320 -0
  330. multi_agent_brief/orchestrator/runtime_state/trajectory.py +200 -0
  331. multi_agent_brief/orchestrator/runtime_state/workflow.py +350 -0
  332. multi_agent_brief/orchestrator/source_evidence.py +43 -0
  333. multi_agent_brief/orchestrator/timing.py +410 -0
  334. multi_agent_brief/orchestrator_contract.py +96 -0
  335. multi_agent_brief/outputs/__init__.py +2 -0
  336. multi_agent_brief/outputs/atomic_reader_projection.py +288 -0
  337. multi_agent_brief/outputs/docx.py +32 -0
  338. multi_agent_brief/outputs/finalize.py +1036 -0
  339. multi_agent_brief/outputs/ib_docx.py +983 -0
  340. multi_agent_brief/outputs/naming.py +38 -0
  341. multi_agent_brief/outputs/pdf.py +20 -0
  342. multi_agent_brief/outputs/reader_final_gate.py +509 -0
  343. multi_agent_brief/outputs/reader_projection.py +397 -0
  344. multi_agent_brief/outputs/source_appendix.py +753 -0
  345. multi_agent_brief/outputs/templates/__init__.py +112 -0
  346. multi_agent_brief/product/__init__.py +49 -0
  347. multi_agent_brief/product/bundle_projection.py +686 -0
  348. multi_agent_brief/product/citation_profile.py +145 -0
  349. multi_agent_brief/product/guidance_manifestation.py +421 -0
  350. multi_agent_brief/product/materiality_selection.py +472 -0
  351. multi_agent_brief/product/policy_gate_adapter.py +116 -0
  352. multi_agent_brief/product/policy_profile.py +39 -0
  353. multi_agent_brief/product/policy_projection.py +161 -0
  354. multi_agent_brief/product/policy_registry.py +83 -0
  355. multi_agent_brief/product/policy_resolver.py +225 -0
  356. multi_agent_brief/product/quality_closeout.py +188 -0
  357. multi_agent_brief/product/quality_panel.py +2217 -0
  358. multi_agent_brief/product/release_approval.py +1034 -0
  359. multi_agent_brief/product/report_pack.py +130 -0
  360. multi_agent_brief/product/report_pack_aliases.py +68 -0
  361. multi_agent_brief/product/report_registry.py +101 -0
  362. multi_agent_brief/product/report_spec.py +181 -0
  363. multi_agent_brief/product/support_wording.py +525 -0
  364. multi_agent_brief/product/template_conformance.py +516 -0
  365. multi_agent_brief/product/template_projection.py +123 -0
  366. multi_agent_brief/product/template_registry.py +244 -0
  367. multi_agent_brief/product/template_render_plan.py +315 -0
  368. multi_agent_brief/product/template_renderer.py +224 -0
  369. multi_agent_brief/product/trajectory_regulation.py +441 -0
  370. multi_agent_brief/provenance/__init__.py +5 -0
  371. multi_agent_brief/provenance/builder.py +841 -0
  372. multi_agent_brief/provenance/contract.py +21 -0
  373. multi_agent_brief/provenance/io.py +144 -0
  374. multi_agent_brief/provenance/model.py +110 -0
  375. multi_agent_brief/provenance/references.py +43 -0
  376. multi_agent_brief/provenance/validator.py +135 -0
  377. multi_agent_brief/quality_gates/__init__.py +19 -0
  378. multi_agent_brief/quality_gates/contract.py +581 -0
  379. multi_agent_brief/quality_gates/state.py +2498 -0
  380. multi_agent_brief/repair/__init__.py +5 -0
  381. multi_agent_brief/repair/router.py +842 -0
  382. multi_agent_brief/runtime_assets.py +431 -0
  383. multi_agent_brief/sources/__init__.py +16 -0
  384. multi_agent_brief/sources/api_filings.py +236 -0
  385. multi_agent_brief/sources/api_news.py +174 -0
  386. multi_agent_brief/sources/base.py +142 -0
  387. multi_agent_brief/sources/cached_package.py +119 -0
  388. multi_agent_brief/sources/cli_provider.py +263 -0
  389. multi_agent_brief/sources/coverage.py +336 -0
  390. multi_agent_brief/sources/decider.py +756 -0
  391. multi_agent_brief/sources/doctor.py +373 -0
  392. multi_agent_brief/sources/evidence_pack.py +364 -0
  393. multi_agent_brief/sources/feishu_provider.py +326 -0
  394. multi_agent_brief/sources/filing_resolver.py +400 -0
  395. multi_agent_brief/sources/industry_packs.py +130 -0
  396. multi_agent_brief/sources/join.py +206 -0
  397. multi_agent_brief/sources/local_signal.py +81 -0
  398. multi_agent_brief/sources/local_signal_planner.py +636 -0
  399. multi_agent_brief/sources/manual.py +259 -0
  400. multi_agent_brief/sources/mcp_provider.py +309 -0
  401. multi_agent_brief/sources/mineru_provider.py +601 -0
  402. multi_agent_brief/sources/normalizer.py +95 -0
  403. multi_agent_brief/sources/opencli_provider.py +282 -0
  404. multi_agent_brief/sources/planner.py +178 -0
  405. multi_agent_brief/sources/registry.py +367 -0
  406. multi_agent_brief/sources/rss.py +190 -0
  407. multi_agent_brief/sources/search_backends/__init__.py +31 -0
  408. multi_agent_brief/sources/search_backends/base.py +51 -0
  409. multi_agent_brief/sources/search_backends/brave.py +192 -0
  410. multi_agent_brief/sources/search_backends/capabilities.py +94 -0
  411. multi_agent_brief/sources/search_backends/exa.py +180 -0
  412. multi_agent_brief/sources/search_backends/firecrawl.py +164 -0
  413. multi_agent_brief/sources/search_backends/serper.py +241 -0
  414. multi_agent_brief/sources/search_backends/tavily.py +124 -0
  415. multi_agent_brief/sources/sourcehub.py +505 -0
  416. multi_agent_brief/sources/web_search.py +267 -0
  417. multi_agent_brief/status.py +966 -0
  418. multi_agent_brief/tools/__init__.py +3 -0
  419. multi_agent_brief/tools/draft_cleanup.py +198 -0
  420. multi_agent_brief/workbuddy/__init__.py +1 -0
  421. multi_agent_brief/workbuddy/diagnose.py +569 -0
  422. multi_agent_brief/workbuddy/skill_pack.py +309 -0
  423. multi_agent_brief/workspace/__init__.py +1 -0
  424. multi_agent_brief/workspace/init_profile.py +45 -0
@@ -0,0 +1,192 @@
1
+ """Feedback issue and repair-plan CLI commands."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import json
7
+ from typing import Any
8
+
9
+ from multi_agent_brief.feedback.feedback_contract import FeedbackContractError
10
+ from multi_agent_brief.feedback.feedback_state import (
11
+ ingest_feedback,
12
+ plan_feedback,
13
+ resolve_feedback,
14
+ show_feedback_state,
15
+ validate_feedback_workspace,
16
+ )
17
+ from multi_agent_brief.orchestrator.runtime_state import RuntimeStateError
18
+
19
+
20
+ def register(subparsers: argparse._SubParsersAction) -> None:
21
+ feedback_parser = subparsers.add_parser(
22
+ "feedback",
23
+ help="Ingest feedback issues and create deterministic repair plans.",
24
+ )
25
+ actions = feedback_parser.add_subparsers(dest="feedback_action", required=True)
26
+
27
+ ingest_parser = actions.add_parser(
28
+ "ingest",
29
+ help="Convert human feedback or audit findings into feedback_issues.json.",
30
+ )
31
+ ingest_parser.add_argument("--workspace", required=True, help="Path to workspace directory.")
32
+ ingest_parser.add_argument("--feedback", required=True, help="Feedback or audit report file path.")
33
+ ingest_parser.add_argument(
34
+ "--source",
35
+ required=True,
36
+ help="Feedback source: human or audit.",
37
+ )
38
+ ingest_parser.add_argument("--stage", help="Mapped stage id. Missing mappings create triage issues.")
39
+ ingest_parser.add_argument("--artifact", help="Mapped artifact id. Missing mappings create triage issues.")
40
+ ingest_parser.add_argument("--category", help="Feedback category. Missing mappings create triage issues.")
41
+ ingest_parser.add_argument("--severity", help="Severity: low, medium, high, or blocking.")
42
+ ingest_parser.add_argument(
43
+ "--repo-workdir",
44
+ help="Repository or packaged contract base (default: auto-detect).",
45
+ )
46
+ ingest_parser.add_argument("--json", action="store_true", help="Emit machine-readable JSON.")
47
+
48
+ plan_parser = actions.add_parser(
49
+ "plan",
50
+ help="Create deterministic repair_plan.json from open feedback issues.",
51
+ )
52
+ plan_parser.add_argument("--workspace", required=True, help="Path to workspace directory.")
53
+ plan_parser.add_argument(
54
+ "--repo-workdir",
55
+ help="Repository or packaged contract base (default: auto-detect).",
56
+ )
57
+ plan_parser.add_argument("--json", action="store_true", help="Emit machine-readable JSON.")
58
+
59
+ resolve_parser = actions.add_parser(
60
+ "resolve",
61
+ help="Mark a feedback issue resolved and its repair plan completed.",
62
+ )
63
+ resolve_parser.add_argument("--workspace", required=True, help="Path to workspace directory.")
64
+ resolve_parser.add_argument("--issue-id", required=True, help="Feedback issue id to resolve.")
65
+ resolve_parser.add_argument("--repair-plan-id", required=True, help="Repair plan id covering the issue.")
66
+ resolve_parser.add_argument("--reason", required=True, help="Resolution reason summary.")
67
+ resolve_parser.add_argument(
68
+ "--delta-audit",
69
+ help="Optional delta audit report path to reference after repair.",
70
+ )
71
+ resolve_parser.add_argument(
72
+ "--repo-workdir",
73
+ help="Repository or packaged contract base (default: auto-detect).",
74
+ )
75
+ resolve_parser.add_argument("--json", action="store_true", help="Emit machine-readable JSON.")
76
+
77
+ show_parser = actions.add_parser(
78
+ "show",
79
+ help="Show feedback issue and repair-plan state.",
80
+ )
81
+ show_parser.add_argument("--workspace", required=True, help="Path to workspace directory.")
82
+ show_parser.add_argument(
83
+ "--repo-workdir",
84
+ help="Repository or packaged contract base (default: auto-detect).",
85
+ )
86
+ show_parser.add_argument("--json", action="store_true", help="Emit machine-readable JSON.")
87
+
88
+ validate_parser = actions.add_parser(
89
+ "validate",
90
+ help="Validate feedback_issues.json and repair_plan.json.",
91
+ )
92
+ validate_parser.add_argument("--workspace", required=True, help="Path to workspace directory.")
93
+ validate_parser.add_argument(
94
+ "--repo-workdir",
95
+ help="Repository or packaged contract base (default: auto-detect).",
96
+ )
97
+ validate_parser.add_argument("--json", action="store_true", help="Emit machine-readable JSON.")
98
+
99
+
100
+ def handle(args: argparse.Namespace) -> int:
101
+ try:
102
+ if args.feedback_action == "ingest":
103
+ state = ingest_feedback(
104
+ workspace=args.workspace,
105
+ feedback_path=args.feedback,
106
+ source=args.source,
107
+ stage_id=getattr(args, "stage", None),
108
+ artifact_id=getattr(args, "artifact", None),
109
+ category=getattr(args, "category", None),
110
+ severity=getattr(args, "severity", None),
111
+ repo_workdir=getattr(args, "repo_workdir", None),
112
+ )
113
+ _print_state("feedback ingest", state, as_json=getattr(args, "json", False))
114
+ return 0
115
+
116
+ if args.feedback_action == "plan":
117
+ state = plan_feedback(
118
+ workspace=args.workspace,
119
+ repo_workdir=getattr(args, "repo_workdir", None),
120
+ )
121
+ _print_state("feedback plan", state, as_json=getattr(args, "json", False))
122
+ return 0
123
+
124
+ if args.feedback_action == "resolve":
125
+ state = resolve_feedback(
126
+ workspace=args.workspace,
127
+ issue_id=args.issue_id,
128
+ repair_plan_id=args.repair_plan_id,
129
+ reason=args.reason,
130
+ delta_audit=getattr(args, "delta_audit", None),
131
+ repo_workdir=getattr(args, "repo_workdir", None),
132
+ )
133
+ _print_state("feedback resolve", state, as_json=getattr(args, "json", False))
134
+ return 0
135
+
136
+ if args.feedback_action == "show":
137
+ state = show_feedback_state(
138
+ workspace=args.workspace,
139
+ repo_workdir=getattr(args, "repo_workdir", None),
140
+ )
141
+ _print_state("feedback show", state, as_json=getattr(args, "json", False))
142
+ return 0 if state.get("ok") else 1
143
+
144
+ if args.feedback_action == "validate":
145
+ result = validate_feedback_workspace(
146
+ workspace=args.workspace,
147
+ repo_workdir=getattr(args, "repo_workdir", None),
148
+ )
149
+ if getattr(args, "json", False):
150
+ print(json.dumps(result, ensure_ascii=False, indent=2, sort_keys=True))
151
+ else:
152
+ _print_validation(result)
153
+ return 0 if result.get("ok") else 1
154
+ except (RuntimeStateError, FeedbackContractError) as exc:
155
+ _print_error(exc, as_json=getattr(args, "json", False))
156
+ return 1
157
+
158
+ return 1
159
+
160
+
161
+ def _print_state(label: str, state: dict[str, Any], *, as_json: bool) -> None:
162
+ if as_json:
163
+ print(json.dumps(state, ensure_ascii=False, indent=2, sort_keys=True))
164
+ return
165
+ issues = (state.get("feedback_issues") or {}).get("issues") or []
166
+ plans = (state.get("repair_plan") or {}).get("repair_plans") or []
167
+ validation = state.get("validation") or {}
168
+ print(f"[{label}] issues: {len(issues)}")
169
+ print(f"[{label}] repair_plans: {len(plans)}")
170
+ print(f"[{label}] valid: {validation.get('ok')}")
171
+ print(f"[{label}] triage: {validation.get('triage_count', 0)}")
172
+ if validation.get("errors"):
173
+ for error in validation.get("errors") or []:
174
+ print(f" - {error}")
175
+
176
+
177
+ def _print_validation(result: dict[str, Any]) -> None:
178
+ print(f"[feedback validate] ok: {result.get('ok')}")
179
+ print(f"[feedback validate] issue_count: {result.get('issue_count', 0)}")
180
+ print(f"[feedback validate] triage_count: {result.get('triage_count', 0)}")
181
+ print(f"[feedback validate] blocking_triage_count: {result.get('blocking_triage_count', 0)}")
182
+ print(f"[feedback validate] repair_plan_count: {result.get('repair_plan_count', 0)}")
183
+ for error in result.get("errors") or []:
184
+ print(f" - {error}")
185
+
186
+
187
+ def _print_error(exc: Exception, *, as_json: bool) -> None:
188
+ payload = exc.to_dict() if hasattr(exc, "to_dict") else {"ok": False, "error": str(exc)}
189
+ if as_json:
190
+ print(json.dumps(payload, ensure_ascii=False, indent=2, sort_keys=True))
191
+ else:
192
+ print(f"[feedback] {exc}")
@@ -0,0 +1,153 @@
1
+ """finalize — regenerate reader-facing artifacts command."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import json
7
+ import sys
8
+ from pathlib import Path
9
+
10
+ from multi_agent_brief.core.config import build_run_settings, get_output_config, load_config
11
+ from multi_agent_brief.orchestrator.runtime_state import (
12
+ E_ACTIVE_REPAIR_OPEN,
13
+ E_ASSESSMENT_TARGET_COMPLETE,
14
+ RuntimeStateError,
15
+ check_runtime_state,
16
+ raise_if_auditable_target_complete_blocks_downstream,
17
+ raise_if_active_repair_open,
18
+ runtime_state_paths,
19
+ )
20
+ from multi_agent_brief.orchestrator.runtime_state.errors import E_TRANSACTION_INTEGRITY
21
+ from multi_agent_brief.outputs.finalize import finalize_reader_outputs
22
+
23
+
24
+ def register(subparsers: argparse._SubParsersAction) -> None:
25
+ """Register the finalize subparser."""
26
+ finalize_parser = subparsers.add_parser(
27
+ "finalize",
28
+ help="Regenerate reader-facing Markdown/DOCX from"
29
+ " output/intermediate/audited_brief.md.",
30
+ )
31
+ finalize_parser.add_argument(
32
+ "--config", required=True, help="Path to config.yaml in the workspace."
33
+ )
34
+ finalize_parser.add_argument("--output", help="Override output directory.")
35
+
36
+
37
+ def handle(args: argparse.Namespace) -> int:
38
+ """Regenerate final reader-facing artifacts from audited internal markdown.
39
+
40
+ This is a deterministic delivery gate for agent-assisted workflows where
41
+ analyst/editor/auditor subagents write
42
+ output/intermediate/audited_brief.md before reader-facing artifacts are
43
+ rendered.
44
+ """
45
+ config_path = Path(args.config).resolve()
46
+ workspace = config_path.parent
47
+ config = load_config(str(config_path))
48
+ settings = build_run_settings(
49
+ config=config,
50
+ input_dir=None,
51
+ output_dir=args.output,
52
+ name=None,
53
+ language=None,
54
+ audience=None,
55
+ )
56
+ output_config = get_output_config(config)
57
+
58
+ try:
59
+ _preflight_runtime_state_before_finalize(workspace)
60
+ result = finalize_reader_outputs(
61
+ output_dir=settings["output_dir"],
62
+ project_name=settings["project_name"],
63
+ output_formats=settings.get("output_formats", ["markdown"]),
64
+ output_footer=settings.get("output_footer", ""),
65
+ output_named_outputs=bool(
66
+ settings.get("output_named_outputs", True)
67
+ ),
68
+ output_filename_template=settings.get("output_filename_template", ""),
69
+ output_filename_tokens=settings.get("output_filename_tokens", {}),
70
+ docx_template=output_config.get("docx_template", "default"),
71
+ source_appendix_config=output_config.get("source_appendix", {}),
72
+ workspace_dir=workspace,
73
+ )
74
+ except (FileNotFoundError, ValueError, RuntimeError, RuntimeStateError) as exc:
75
+ print(f"[finalize] Error: {exc}", file=sys.stderr)
76
+ return 1
77
+
78
+ print(f"[finalize] Delivery Markdown: {result.delivery_markdown}")
79
+ if result.delivery_docx:
80
+ print(f"[finalize] Delivery DOCX: {result.delivery_docx}")
81
+ elif result.docx_generation != "not_requested":
82
+ print(
83
+ f"[finalize] DOCX generation: {result.docx_generation}"
84
+ )
85
+ if result.source_appendix:
86
+ print(f"[finalize] Source appendix audit copy: {result.source_appendix}")
87
+ elif result.source_appendix_generation not in {"not_requested", "generated"}:
88
+ print(f"[finalize] Source appendix audit copy: {result.source_appendix_generation}")
89
+ if result.delivery_snapshot_dir:
90
+ print(f"[finalize] Delivery snapshot: {result.delivery_snapshot_dir}")
91
+ print("[finalize] Audit records remain under output/intermediate/.")
92
+ print(
93
+ "[finalize] Internal [src:<claim_id>] markers stripped from"
94
+ " reader-facing artifacts."
95
+ )
96
+ return 0
97
+
98
+
99
+ def _preflight_runtime_state_before_finalize(workspace: Path) -> None:
100
+ paths = runtime_state_paths(workspace)
101
+ workflow_path = paths["workflow_state"]
102
+ if not workflow_path.exists():
103
+ return
104
+ try:
105
+ workflow = json.loads(workflow_path.read_text(encoding="utf-8"))
106
+ except (OSError, json.JSONDecodeError) as exc:
107
+ raise RuntimeStateError(
108
+ f"workflow_state.json is unreadable before finalize: {exc}",
109
+ ) from exc
110
+ if not isinstance(workflow, dict):
111
+ raise RuntimeStateError("workflow_state.json must contain an object before finalize.")
112
+ try:
113
+ raise_if_active_repair_open(workspace=workspace, workflow=workflow)
114
+ if paths["runtime_manifest"].exists():
115
+ try:
116
+ check_runtime_state(workspace=workspace, actor="cli")
117
+ except RuntimeStateError:
118
+ raise
119
+ except Exception as exc:
120
+ raise RuntimeStateError(f"Unable to verify runtime state integrity before finalize: {exc}") from exc
121
+ try:
122
+ workflow = json.loads(workflow_path.read_text(encoding="utf-8"))
123
+ except (OSError, json.JSONDecodeError) as exc:
124
+ raise RuntimeStateError(
125
+ f"workflow_state.json is unreadable after runtime state refresh: {exc}",
126
+ ) from exc
127
+ if not isinstance(workflow, dict):
128
+ raise RuntimeStateError("workflow_state.json must contain an object after runtime state refresh.")
129
+ _raise_if_run_integrity_not_reference_eligible_before_finalize(workflow)
130
+ raise_if_auditable_target_complete_blocks_downstream(
131
+ workspace=workspace,
132
+ workflow=workflow,
133
+ command="finalize",
134
+ )
135
+ except RuntimeStateError as exc:
136
+ if exc.error_code == E_ACTIVE_REPAIR_OPEN:
137
+ raise
138
+ if exc.error_code == E_ASSESSMENT_TARGET_COMPLETE:
139
+ raise
140
+ if exc.error_code == E_TRANSACTION_INTEGRITY:
141
+ raise
142
+ raise RuntimeStateError(f"Unable to verify runtime state before finalize: {exc}") from exc
143
+
144
+
145
+ def _raise_if_run_integrity_not_reference_eligible_before_finalize(workflow: dict[str, object]) -> None:
146
+ integrity = workflow.get("run_integrity") if isinstance(workflow.get("run_integrity"), dict) else {}
147
+ if integrity.get("status") == "clean" and integrity.get("reference_eligible") is True:
148
+ return
149
+ raise RuntimeStateError(
150
+ "Runtime state integrity check failed because run integrity is not clean before finalize.",
151
+ details={"run_integrity": integrity},
152
+ error_code=E_TRANSACTION_INTEGRITY,
153
+ )
@@ -0,0 +1,174 @@
1
+ """Quality-gate CLI commands."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import json
7
+ from typing import Any
8
+
9
+ from multi_agent_brief.orchestrator.runtime_state import RuntimeStateError
10
+ from multi_agent_brief.quality_gates.contract import QualityGateContractError
11
+ from multi_agent_brief.quality_gates.state import (
12
+ check_quality_gates,
13
+ show_quality_gates,
14
+ validate_quality_gates_workspace,
15
+ )
16
+
17
+
18
+ def register(subparsers: argparse._SubParsersAction) -> None:
19
+ gates_parser = subparsers.add_parser(
20
+ "gates",
21
+ help="Run deterministic quality gates and inspect stage-scoped quality gate reports.",
22
+ )
23
+ actions = gates_parser.add_subparsers(dest="gates_action", required=True)
24
+
25
+ check_parser = actions.add_parser(
26
+ "check",
27
+ help="Run material-fact, freshness, target-relevance, coverage/omission, and editor-new-fact gates.",
28
+ )
29
+ check_parser.add_argument("--workspace", required=True, help="Path to workspace directory.")
30
+ check_parser.add_argument(
31
+ "--brief",
32
+ help="Brief path. Defaults to output/intermediate/audited_brief.md, or output/brief.md for --stage finalize.",
33
+ )
34
+ check_parser.add_argument("--ledger", help="Claim Ledger path. Defaults to output/intermediate/claim_ledger.json.")
35
+ check_parser.add_argument("--report-date", default="", help="Report date, e.g. 2026-06-08.")
36
+ check_parser.add_argument("--max-source-age-days", type=int, help="Maximum current-source age in days.")
37
+ check_parser.add_argument(
38
+ "--stage",
39
+ help="Gate stage id. Defaults to auditor for audited_brief.md and finalize for output/brief.md.",
40
+ )
41
+ check_parser.add_argument(
42
+ "--strict",
43
+ action="store_true",
44
+ help="Escalate high-severity freshness/material/editor-new-fact warnings into blocking findings.",
45
+ )
46
+ check_parser.add_argument("--repo-workdir", help="Repository or packaged contract base.")
47
+ check_parser.add_argument("--json", action="store_true", help="Emit machine-readable JSON.")
48
+
49
+ show_parser = actions.add_parser(
50
+ "show",
51
+ help="Show quality gate report state, including stage-scoped reports and legacy projection.",
52
+ )
53
+ show_parser.add_argument("--workspace", required=True, help="Path to workspace directory.")
54
+ show_parser.add_argument("--repo-workdir", help="Repository or packaged contract base.")
55
+ show_parser.add_argument("--json", action="store_true", help="Emit machine-readable JSON.")
56
+
57
+ validate_parser = actions.add_parser(
58
+ "validate",
59
+ help="Validate stage-scoped quality gate reports.",
60
+ )
61
+ validate_parser.add_argument("--workspace", required=True, help="Path to workspace directory.")
62
+ validate_parser.add_argument("--repo-workdir", help="Repository or packaged contract base.")
63
+ validate_parser.add_argument("--json", action="store_true", help="Emit machine-readable JSON.")
64
+
65
+
66
+ def handle(args: argparse.Namespace) -> int:
67
+ try:
68
+ if args.gates_action == "check":
69
+ state = check_quality_gates(
70
+ workspace=args.workspace,
71
+ brief=getattr(args, "brief", None),
72
+ ledger=getattr(args, "ledger", None),
73
+ report_date=getattr(args, "report_date", ""),
74
+ max_source_age_days=getattr(args, "max_source_age_days", None),
75
+ stage_id=getattr(args, "stage", None),
76
+ strict=getattr(args, "strict", False),
77
+ repo_workdir=getattr(args, "repo_workdir", None),
78
+ )
79
+ _print_state("gates check", state, as_json=getattr(args, "json", False))
80
+ return 0 if state.get("ok") else 1
81
+
82
+ if args.gates_action == "show":
83
+ state = show_quality_gates(
84
+ workspace=args.workspace,
85
+ repo_workdir=getattr(args, "repo_workdir", None),
86
+ )
87
+ _print_state("gates show", state, as_json=getattr(args, "json", False))
88
+ return 0 if state.get("ok") else 1
89
+
90
+ if args.gates_action == "validate":
91
+ result = validate_quality_gates_workspace(
92
+ workspace=args.workspace,
93
+ repo_workdir=getattr(args, "repo_workdir", None),
94
+ )
95
+ if getattr(args, "json", False):
96
+ print(json.dumps(result, ensure_ascii=False, indent=2, sort_keys=True))
97
+ else:
98
+ _print_validation(result)
99
+ return 0 if result.get("ok") else 1
100
+ except (RuntimeStateError, QualityGateContractError) as exc:
101
+ _print_error(exc, as_json=getattr(args, "json", False))
102
+ return 1
103
+
104
+ return 1
105
+
106
+
107
+ def _print_state(label: str, state: dict[str, Any], *, as_json: bool) -> None:
108
+ if as_json:
109
+ print(json.dumps(state, ensure_ascii=False, indent=2, sort_keys=True))
110
+ return
111
+ report = state.get("quality_gate_report") or {}
112
+ validation = state.get("validation") or {}
113
+ print(f"[{label}] status: {report.get('status')}")
114
+ print(f"[{label}] findings: {validation.get('finding_count', 0)}")
115
+ print(f"[{label}] blocking: {validation.get('blocking_count', 0)}")
116
+ print(f"[{label}] valid: {validation.get('ok')}")
117
+ for error in validation.get("errors") or []:
118
+ print(f" - {error}")
119
+ _print_repair_guidance(label, state)
120
+
121
+
122
+ def _print_repair_guidance(label: str, state: dict[str, Any]) -> None:
123
+ required_commands = state.get("required_commands") or []
124
+ if required_commands:
125
+ print(f"[{label}] required_commands:")
126
+ for command in required_commands:
127
+ print(f" - {command}")
128
+ repair_warnings = state.get("repair_warnings") or []
129
+ if repair_warnings:
130
+ print(f"[{label}] repair_warnings:")
131
+ for warning in repair_warnings:
132
+ print(f" - {warning}")
133
+ repair_steps = state.get("repair_steps") or []
134
+ if repair_steps:
135
+ print(f"[{label}] repair_steps:")
136
+ for step in repair_steps:
137
+ print(f" - {step}")
138
+ repair_route = state.get("repair_route")
139
+ if not isinstance(repair_route, dict):
140
+ return
141
+ if repair_route.get("ok"):
142
+ print(f"[{label}] repair_owner: {repair_route.get('repair_owner')}")
143
+ print(f"[{label}] must_rerun_from: {repair_route.get('must_rerun_from') or 'none'}")
144
+ allowed = repair_route.get("allowed_artifacts") or []
145
+ if allowed:
146
+ print(f"[{label}] allowed_artifacts:")
147
+ for artifact in allowed:
148
+ print(f" - {artifact}")
149
+ blocked = repair_route.get("blocked_direct_edits") or []
150
+ if blocked:
151
+ print(f"[{label}] blocked_direct_edits:")
152
+ for artifact in blocked:
153
+ print(f" - {artifact}")
154
+ else:
155
+ message = repair_route.get("message") or repair_route.get("error")
156
+ if message:
157
+ print(f"[{label}] repair_route_error: {message}")
158
+
159
+
160
+ def _print_validation(result: dict[str, Any]) -> None:
161
+ print(f"[gates validate] ok: {result.get('ok')}")
162
+ print(f"[gates validate] report_present: {result.get('report_present')}")
163
+ print(f"[gates validate] finding_count: {result.get('finding_count', 0)}")
164
+ print(f"[gates validate] blocking_count: {result.get('blocking_count', 0)}")
165
+ for error in result.get("errors") or []:
166
+ print(f" - {error}")
167
+
168
+
169
+ def _print_error(exc: Exception, *, as_json: bool) -> None:
170
+ payload = exc.to_dict() if hasattr(exc, "to_dict") else {"ok": False, "error": str(exc)}
171
+ if as_json:
172
+ print(json.dumps(payload, ensure_ascii=False, indent=2, sort_keys=True))
173
+ else:
174
+ print(f"[gates] {exc}")