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,764 @@
1
+ from __future__ import annotations
2
+
3
+ from dataclasses import dataclass, field
4
+ from pathlib import Path
5
+ import re
6
+
7
+ from multi_agent_brief.tools.draft_cleanup import strip_claim_citations
8
+ from multi_agent_brief.audit.deterministic import parse_date
9
+ from multi_agent_brief.audit.interfaces import AuditAgentInterface, recompute_report_status
10
+ from multi_agent_brief.core.citations import SRC_REF_PATTERN
11
+ from multi_agent_brief.core.claim_ledger import ClaimLedger
12
+ from multi_agent_brief.core.schemas import AuditFinding, AuditReport, PipelineContext
13
+ from multi_agent_brief.core.config import _as_bool
14
+
15
+
16
+ CURRENT_FRAMING_PATTERN = re.compile(r"\b(this week|current|latest|newly|本周|本期|当前|最新|新增)\b", re.IGNORECASE)
17
+ DATE_PATTERN = re.compile(r"\b(20\d{2}-\d{2}-\d{2}|20\d{6})\b")
18
+
19
+
20
+ @dataclass
21
+ class FinalQualityConfig:
22
+ harness_protocol: str = "BRIEF_HARNESS_V2"
23
+ min_markdown_chars: int = 8000
24
+ min_docx_text_chars: int = 7800
25
+ quiet_week: bool = False
26
+ expected_summary_bullets: int | None = 5
27
+ summary_heading: str = "Executive Summary"
28
+ summary_bullet_marker: str = "▸"
29
+ max_table_columns: int = 4
30
+ required_main_chapter_count: int | None = None
31
+ required_metadata_labels: list[str] = field(
32
+ default_factory=lambda: ["coverage", "source priority", "cutoff"]
33
+ )
34
+ stale_current_threshold_days: int | None = None
35
+ rendered_docx_path: str = ""
36
+ min_selected_claims: int = 0 # 0 = not enforced; weekly default = 20
37
+ min_zh_chars: int = 0 # 0 = not enforced; weekly default = 3000
38
+ min_en_words: int = 0 # 0 = not enforced; weekly default = 1800
39
+ require_dates: bool = False # True for weekly briefs
40
+ allow_quiet_week_exception: bool = False
41
+
42
+
43
+ class FinalQualityAuditAgent(AuditAgentInterface):
44
+ """Strict final-delivery quality gate inspired by local weekly-report V2 harnesses."""
45
+
46
+ name = "final-quality-auditor"
47
+
48
+ def __init__(self, config: FinalQualityConfig | None = None) -> None:
49
+ self.config = config or FinalQualityConfig()
50
+
51
+ def run_audit(
52
+ self,
53
+ markdown: str,
54
+ ledger: ClaimLedger,
55
+ context: PipelineContext | None = None,
56
+ ) -> AuditReport:
57
+ config = build_final_quality_config(context, self.config)
58
+ findings: list[AuditFinding] = []
59
+ findings.extend(_markdown_depth_findings(markdown, config))
60
+ findings.extend(_summary_bullet_findings(markdown, config))
61
+ findings.extend(_table_width_findings(markdown, config))
62
+ findings.extend(_metadata_findings(markdown, config))
63
+ findings.extend(_chapter_count_findings(markdown, config))
64
+ findings.extend(_stale_current_framing_findings(markdown, context, config))
65
+ findings.extend(_docx_fidelity_findings(config))
66
+ findings.extend(_claim_count_findings(ledger, markdown, context, config))
67
+ findings.extend(_brief_depth_findings(markdown, config))
68
+ findings.extend(_date_requirement_findings(ledger, markdown, context, config))
69
+ report = AuditReport(
70
+ audit_status="pass",
71
+ audit_score=100,
72
+ findings=findings,
73
+ metadata={
74
+ "harness_protocol": config.harness_protocol,
75
+ "target": "final",
76
+ "quality_gate": "blocking",
77
+ "quiet_week": config.quiet_week,
78
+ "rendered_docx_path": config.rendered_docx_path,
79
+ },
80
+ )
81
+ return recompute_report_status(report)
82
+
83
+
84
+ def build_final_quality_config(
85
+ context: PipelineContext | None,
86
+ defaults: FinalQualityConfig | None = None,
87
+ ) -> FinalQualityConfig:
88
+ base = defaults or FinalQualityConfig()
89
+ data = dict(context.metadata.get("final_quality", {})) if context else {}
90
+ report_threshold = context.max_source_age_days if context else None
91
+
92
+ # Apply audience profile thresholds if available
93
+ profile_thresholds: dict = {}
94
+ if context and context.audience_profile:
95
+ from multi_agent_brief.audience.profiles import get_profile
96
+ profile = get_profile(context.audience_profile)
97
+ profile_thresholds = profile.final_quality_thresholds
98
+
99
+ return FinalQualityConfig(
100
+ harness_protocol=str(data.get("harness_protocol", base.harness_protocol)),
101
+ min_markdown_chars=int(data.get("min_markdown_chars", profile_thresholds.get("min_markdown_chars", base.min_markdown_chars))),
102
+ min_docx_text_chars=int(data.get("min_docx_text_chars", base.min_docx_text_chars)),
103
+ quiet_week=_as_bool(data.get("quiet_week"), base.quiet_week),
104
+ expected_summary_bullets=data.get("expected_summary_bullets", profile_thresholds.get("expected_summary_bullets", base.expected_summary_bullets)),
105
+ summary_heading=str(data.get("summary_heading", base.summary_heading)),
106
+ summary_bullet_marker=str(data.get("summary_bullet_marker", base.summary_bullet_marker)),
107
+ max_table_columns=int(data.get("max_table_columns", base.max_table_columns)),
108
+ required_main_chapter_count=data.get("required_main_chapter_count", base.required_main_chapter_count),
109
+ required_metadata_labels=list(data.get("required_metadata_labels", base.required_metadata_labels)),
110
+ stale_current_threshold_days=data.get("stale_current_threshold_days", base.stale_current_threshold_days)
111
+ or report_threshold,
112
+ rendered_docx_path=str(data.get("rendered_docx_path", base.rendered_docx_path)),
113
+ min_selected_claims=int(data.get("min_selected_claims", profile_thresholds.get("min_selected_claims", base.min_selected_claims))),
114
+ min_zh_chars=int(data.get("min_zh_chars", base.min_zh_chars)),
115
+ min_en_words=int(data.get("min_en_words", base.min_en_words)),
116
+ require_dates=_as_bool(data.get("require_dates"), base.require_dates),
117
+ allow_quiet_week_exception=_as_bool(
118
+ data.get("allow_quiet_week_exception"),
119
+ base.allow_quiet_week_exception,
120
+ ),
121
+ )
122
+
123
+
124
+ def _markdown_depth_findings(markdown: str, config: FinalQualityConfig) -> list[AuditFinding]:
125
+ if config.quiet_week or len(markdown) >= config.min_markdown_chars:
126
+ return []
127
+ return [
128
+ AuditFinding(
129
+ finding_id="FINAL_DEPTH_001",
130
+ severity="high",
131
+ finding_type="final_report_too_thin",
132
+ description=(
133
+ f"Final report is too thin for a normal brief: {len(markdown)} chars "
134
+ f"vs target >= {config.min_markdown_chars}."
135
+ ),
136
+ recommendation="Regenerate or edit the final report with deeper sourced analysis, or mark the run as quiet_week.",
137
+ )
138
+ ]
139
+
140
+
141
+ def _summary_bullet_findings(markdown: str, config: FinalQualityConfig) -> list[AuditFinding]:
142
+ if config.expected_summary_bullets is None:
143
+ return []
144
+ summary = _section_by_heading(markdown, config.summary_heading)
145
+ if not summary:
146
+ return [
147
+ AuditFinding(
148
+ finding_id="FINAL_SUMMARY_001",
149
+ severity="high",
150
+ finding_type="missing_executive_summary",
151
+ description=f"Final report is missing a {config.summary_heading} section.",
152
+ recommendation="Add a reader-facing executive summary before delivery.",
153
+ )
154
+ ]
155
+ count = sum(1 for line in summary.splitlines() if line.strip().startswith(config.summary_bullet_marker))
156
+ if count == config.expected_summary_bullets:
157
+ return []
158
+ return [
159
+ AuditFinding(
160
+ finding_id="FINAL_SUMMARY_002",
161
+ severity="high",
162
+ finding_type="summary_bullet_count_mismatch",
163
+ description=(
164
+ f"Executive summary has {count} '{config.summary_bullet_marker}' bullets; "
165
+ f"expected {config.expected_summary_bullets}."
166
+ ),
167
+ recommendation="Keep summary bullets as separate standalone lines so rendering cannot merge them.",
168
+ )
169
+ ]
170
+
171
+
172
+ def _table_width_findings(markdown: str, config: FinalQualityConfig) -> list[AuditFinding]:
173
+ findings: list[AuditFinding] = []
174
+ for line_number, line in enumerate(markdown.splitlines(), start=1):
175
+ stripped = line.strip()
176
+ if not stripped.startswith("|") or not stripped.endswith("|"):
177
+ continue
178
+ cells = [cell for cell in stripped.strip("|").split("|")]
179
+ if len(cells) > config.max_table_columns:
180
+ findings.append(
181
+ AuditFinding(
182
+ finding_id=f"FINAL_TABLE_{len(findings)+1:03d}",
183
+ severity="high",
184
+ finding_type="wide_markdown_table",
185
+ line_number=line_number,
186
+ description=f"Markdown table has {len(cells)} columns; max is {config.max_table_columns}.",
187
+ recommendation="Convert wide tables into compact row sections before DOCX rendering.",
188
+ evidence=stripped,
189
+ )
190
+ )
191
+ return findings
192
+
193
+
194
+ def _metadata_findings(markdown: str, config: FinalQualityConfig) -> list[AuditFinding]:
195
+ missing = [label for label in config.required_metadata_labels if label.lower() not in markdown.lower()]
196
+ if not missing:
197
+ return []
198
+ return [
199
+ AuditFinding(
200
+ finding_id="FINAL_META_001",
201
+ severity="high",
202
+ finding_type="missing_front_page_metadata",
203
+ description=f"Final report is missing required front-page metadata labels: {', '.join(missing)}.",
204
+ recommendation="Inject public-safe coverage, cutoff, and source-priority metadata before rendering.",
205
+ )
206
+ ]
207
+
208
+
209
+ def _chapter_count_findings(markdown: str, config: FinalQualityConfig) -> list[AuditFinding]:
210
+ if config.required_main_chapter_count is None:
211
+ return []
212
+ count = sum(1 for line in markdown.splitlines() if line.startswith("## "))
213
+ if count >= config.required_main_chapter_count:
214
+ return []
215
+ return [
216
+ AuditFinding(
217
+ finding_id="FINAL_CHAPTER_001",
218
+ severity="high",
219
+ finding_type="insufficient_main_chapters",
220
+ description=f"Final report has {count} main chapters; expected at least {config.required_main_chapter_count}.",
221
+ recommendation="Add the configured report sections or mark the template as quiet/ad-hoc.",
222
+ )
223
+ ]
224
+
225
+
226
+ def _stale_current_framing_findings(
227
+ markdown: str,
228
+ context: PipelineContext | None,
229
+ config: FinalQualityConfig,
230
+ ) -> list[AuditFinding]:
231
+ if not context or not context.report_date or config.stale_current_threshold_days is None:
232
+ return []
233
+ report_day = parse_date(context.report_date)
234
+ if report_day is None:
235
+ return []
236
+ findings: list[AuditFinding] = []
237
+ for line_number, line in enumerate(markdown.splitlines(), start=1):
238
+ if not CURRENT_FRAMING_PATTERN.search(line):
239
+ continue
240
+ for match in DATE_PATTERN.finditer(line):
241
+ source_day = parse_date(match.group(1))
242
+ if source_day is None:
243
+ continue
244
+ age_days = (report_day - source_day).days
245
+ if age_days > config.stale_current_threshold_days:
246
+ findings.append(
247
+ AuditFinding(
248
+ finding_id=f"FINAL_STALE_{len(findings)+1:03d}",
249
+ severity="high",
250
+ finding_type="stale_date_framed_as_current",
251
+ line_number=line_number,
252
+ description=(
253
+ f"Line frames {source_day.isoformat()} as current/latest even though it is "
254
+ f"{age_days} days before report date {report_day.isoformat()}."
255
+ ),
256
+ recommendation="Recast stale events as dated background unless they changed in the report window.",
257
+ evidence=line.strip(),
258
+ )
259
+ )
260
+ return findings
261
+
262
+
263
+ def _docx_fidelity_findings(config: FinalQualityConfig) -> list[AuditFinding]:
264
+ if not config.rendered_docx_path:
265
+ return []
266
+ docx_path = Path(config.rendered_docx_path)
267
+ if not docx_path.exists():
268
+ return [
269
+ AuditFinding(
270
+ finding_id="FINAL_DOCX_001",
271
+ severity="high",
272
+ finding_type="missing_rendered_docx",
273
+ description=f"Rendered DOCX was configured but not found: {docx_path}.",
274
+ recommendation="Render the final Markdown to DOCX before running the final delivery gate.",
275
+ )
276
+ ]
277
+ try:
278
+ from docx import Document # type: ignore
279
+ except ModuleNotFoundError:
280
+ return [
281
+ AuditFinding(
282
+ finding_id="FINAL_DOCX_002",
283
+ severity="high",
284
+ finding_type="docx_validation_dependency_missing",
285
+ description="python-docx is required for rendered DOCX fidelity validation.",
286
+ recommendation="Install python-docx or disable DOCX validation only for non-production dry runs.",
287
+ )
288
+ ]
289
+ document = Document(str(docx_path))
290
+ text = "\n".join(paragraph.text for paragraph in document.paragraphs)
291
+ findings: list[AuditFinding] = []
292
+ if len(text) < config.min_docx_text_chars and not config.quiet_week:
293
+ findings.append(
294
+ AuditFinding(
295
+ finding_id="FINAL_DOCX_003",
296
+ severity="high",
297
+ finding_type="rendered_docx_too_thin",
298
+ description=f"Rendered DOCX text is too thin: {len(text)} chars vs target >= {config.min_docx_text_chars}.",
299
+ recommendation="Regenerate or edit the final report before delivery.",
300
+ )
301
+ )
302
+ return findings
303
+
304
+
305
+ def _claim_count_findings(
306
+ ledger: ClaimLedger,
307
+ markdown: str,
308
+ context: PipelineContext | None,
309
+ config: FinalQualityConfig,
310
+ ) -> list[AuditFinding]:
311
+ """Check that enough claims were selected for the brief."""
312
+ if config.min_selected_claims <= 0:
313
+ return []
314
+ # Count claims that are actually cited in the markdown
315
+ citation_markdown = _markdown_for_claim_refs(markdown, context)
316
+ cited_ids = set(SRC_REF_PATTERN.findall(citation_markdown))
317
+ if len(cited_ids) >= config.min_selected_claims:
318
+ return []
319
+ if config.allow_quiet_week_exception and config.quiet_week:
320
+ return []
321
+ return [
322
+ AuditFinding(
323
+ finding_id="FINAL_CLAIMS_001",
324
+ severity="high",
325
+ finding_type="insufficient_claims",
326
+ description=(
327
+ f"Only {len(cited_ids)} reportable claims selected; "
328
+ f"weekly brief requires at least {config.min_selected_claims}."
329
+ ),
330
+ recommendation="Add more source inputs or enable additional source providers, or mark as quiet_week.",
331
+ )
332
+ ]
333
+
334
+
335
+ def _brief_depth_findings(markdown: str, config: FinalQualityConfig) -> list[AuditFinding]:
336
+ """Check brief body has sufficient depth (Chinese chars or English words)."""
337
+ if config.min_zh_chars <= 0 and config.min_en_words <= 0:
338
+ return []
339
+ if config.allow_quiet_week_exception and config.quiet_week:
340
+ return []
341
+
342
+ # Count Chinese characters (CJK Unified Ideographs range)
343
+ zh_chars = sum(1 for ch in markdown if "一" <= ch <= "鿿")
344
+ # Count English words (rough approximation)
345
+ en_words = len(re.findall(r"[a-zA-Z]+", markdown))
346
+
347
+ findings: list[AuditFinding] = []
348
+ if config.min_zh_chars > 0 and zh_chars < config.min_zh_chars:
349
+ findings.append(
350
+ AuditFinding(
351
+ finding_id="FINAL_DEPTH_002",
352
+ severity="high",
353
+ finding_type="brief_too_thin_zh",
354
+ description=(
355
+ f"Brief has {zh_chars} Chinese characters; "
356
+ f"weekly brief requires at least {config.min_zh_chars}."
357
+ ),
358
+ recommendation="Add more sourced analysis or mark as quiet_week.",
359
+ )
360
+ )
361
+ if config.min_en_words > 0 and en_words < config.min_en_words:
362
+ findings.append(
363
+ AuditFinding(
364
+ finding_id="FINAL_DEPTH_003",
365
+ severity="high",
366
+ finding_type="brief_too_thin_en",
367
+ description=(
368
+ f"Brief has {en_words} English words; "
369
+ f"weekly brief requires at least {config.min_en_words}."
370
+ ),
371
+ recommendation="Add more sourced analysis or mark as quiet_week.",
372
+ )
373
+ )
374
+ return findings
375
+
376
+
377
+ def _date_requirement_findings(
378
+ ledger: ClaimLedger,
379
+ markdown: str,
380
+ context: PipelineContext | None,
381
+ config: FinalQualityConfig,
382
+ ) -> list[AuditFinding]:
383
+ """Check that claims cited in the brief have dates."""
384
+ if not config.require_dates:
385
+ return []
386
+ if config.allow_quiet_week_exception and config.quiet_week:
387
+ return []
388
+
389
+ citation_markdown = _markdown_for_claim_refs(markdown, context)
390
+ cited_ids = set(SRC_REF_PATTERN.findall(citation_markdown))
391
+ findings: list[AuditFinding] = []
392
+ for claim in ledger:
393
+ if claim.claim_id not in cited_ids:
394
+ continue
395
+ has_pub = bool(claim.metadata.get("published_at"))
396
+ has_ret = bool(claim.metadata.get("retrieved_at"))
397
+ if not has_pub and not has_ret:
398
+ findings.append(
399
+ AuditFinding(
400
+ finding_id=f"FINAL_DATE_{len(findings)+1:03d}",
401
+ severity="high",
402
+ finding_type="missing_date",
403
+ description=(
404
+ f"Claim {claim.claim_id} has no published_at or retrieved_at."
405
+ ),
406
+ recommendation="Ensure all source items have date metadata before drafting.",
407
+ )
408
+ )
409
+ return findings
410
+
411
+
412
+ def _markdown_for_claim_refs(markdown: str, context: PipelineContext | None) -> str:
413
+ if SRC_REF_PATTERN.search(markdown):
414
+ return markdown
415
+ audited = context.report_state.prepared_markdown if context else ""
416
+ if audited and strip_claim_citations(audited).strip() == markdown.strip():
417
+ return audited
418
+ return markdown
419
+
420
+
421
+ def _section_by_heading(markdown: str, heading: str) -> str:
422
+ pattern = re.compile(rf"^#+\s+{re.escape(heading)}\s*$", re.IGNORECASE | re.MULTILINE)
423
+ match = pattern.search(markdown)
424
+ if not match:
425
+ return ""
426
+ next_heading = re.search(r"^#+\s+", markdown[match.end() :], re.MULTILINE)
427
+ end = match.end() + next_heading.start() if next_heading else len(markdown)
428
+ return markdown[match.end() : end].strip()
429
+
430
+
431
+ # ── Final Clean Gate ──────────────────────────────────────────────────────────
432
+
433
+
434
+ @dataclass
435
+ class FinalCleanConfig:
436
+ """Configuration for the Final Clean gate."""
437
+ enabled: bool = True
438
+ check_template_variables: bool = True
439
+ check_internal_paths: bool = True
440
+ check_model_phrases: bool = True
441
+ check_feedback_leakage: bool = True
442
+ check_editorial_comments: bool = True
443
+ check_investment_advice: bool = True
444
+ check_invalid_citations: bool = True
445
+
446
+
447
+ class FinalCleanAuditAgent(AuditAgentInterface):
448
+ """Final Clean gate that runs after Editor and before Formatter.
449
+
450
+ Detects process residue, template variables, internal paths, model phrases,
451
+ user feedback leakage, editorial comments, investment advice, and invalid
452
+ citations. This is a delivery gate, not a draft audit replacement.
453
+ """
454
+
455
+ name = "final-clean-auditor"
456
+
457
+ def __init__(self, config: FinalCleanConfig | None = None) -> None:
458
+ self.config = config or FinalCleanConfig()
459
+
460
+ def run_audit(
461
+ self,
462
+ markdown: str,
463
+ ledger: ClaimLedger,
464
+ context: PipelineContext | None = None,
465
+ ) -> AuditReport:
466
+ if not self.config.enabled:
467
+ return AuditReport(
468
+ audit_status="pass",
469
+ audit_score=100,
470
+ findings=[],
471
+ metadata={"final_clean": "disabled"},
472
+ )
473
+
474
+ findings: list[AuditFinding] = []
475
+
476
+ # Run all Final Clean checks
477
+ findings.extend(_final_clean_pattern_findings(markdown, self.config))
478
+ findings.extend(_final_clean_invalid_citations(markdown, ledger, self.config))
479
+
480
+ report = AuditReport(
481
+ audit_status="pass",
482
+ audit_score=100,
483
+ findings=findings,
484
+ metadata={
485
+ "gate": "final_clean",
486
+ "target": "reader_facing",
487
+ "checks_enabled": {
488
+ "template_variables": self.config.check_template_variables,
489
+ "internal_paths": self.config.check_internal_paths,
490
+ "model_phrases": self.config.check_model_phrases,
491
+ "feedback_leakage": self.config.check_feedback_leakage,
492
+ "editorial_comments": self.config.check_editorial_comments,
493
+ "investment_advice": self.config.check_investment_advice,
494
+ "invalid_citations": self.config.check_invalid_citations,
495
+ },
496
+ },
497
+ )
498
+ return recompute_report_status(report)
499
+
500
+
501
+ def _final_clean_pattern_findings(
502
+ markdown: str,
503
+ config: FinalCleanConfig,
504
+ ) -> list[AuditFinding]:
505
+ """Run pattern-based Final Clean checks from draft_cleanup."""
506
+ from multi_agent_brief.tools.draft_cleanup import detect_final_clean_issues
507
+
508
+ # Build filter based on config
509
+ enabled_types: set[str] = set()
510
+ if config.check_template_variables:
511
+ enabled_types.add("template_variable_residue")
512
+ if config.check_internal_paths:
513
+ enabled_types.add("internal_path_leak")
514
+ if config.check_model_phrases:
515
+ enabled_types.add("model_phrase_residue")
516
+ if config.check_feedback_leakage:
517
+ enabled_types.add("feedback_as_fact")
518
+ if config.check_editorial_comments:
519
+ enabled_types.add("editorial_comment_as_conclusion")
520
+ if config.check_investment_advice:
521
+ enabled_types.add("investment_recommendation")
522
+
523
+ issues = detect_final_clean_issues(markdown)
524
+ findings: list[AuditFinding] = []
525
+ finding_counter = 0
526
+
527
+ for issue in issues:
528
+ if issue["finding_type"] not in enabled_types:
529
+ continue
530
+ finding_counter += 1
531
+ findings.append(
532
+ AuditFinding(
533
+ finding_id=f"FINAL_CLEAN_{finding_counter:03d}",
534
+ severity=issue["severity"],
535
+ finding_type=issue["finding_type"],
536
+ description=issue["description"],
537
+ recommendation="Remove or fix before delivery.",
538
+ line_number=issue.get("line_number"),
539
+ evidence=issue.get("evidence", ""),
540
+ blocking_level="safety_blocking" if issue["severity"] == "high" else "editor_fixable",
541
+ repair_owner="safety" if issue["severity"] == "high" else "editor",
542
+ )
543
+ )
544
+ return findings
545
+
546
+
547
+ def _final_clean_invalid_citations(
548
+ markdown: str,
549
+ ledger: ClaimLedger,
550
+ config: FinalCleanConfig,
551
+ ) -> list[AuditFinding]:
552
+ """Check for invalid or empty citation markers."""
553
+ if not config.check_invalid_citations:
554
+ return []
555
+
556
+ from multi_agent_brief.tools.draft_cleanup import detect_invalid_citations
557
+
558
+ valid_ids = {claim.claim_id for claim in ledger}
559
+ issues = detect_invalid_citations(markdown, valid_ids)
560
+ findings: list[AuditFinding] = []
561
+
562
+ for issue in issues:
563
+ findings.append(
564
+ AuditFinding(
565
+ finding_id=f"FINAL_CLEAN_CITE_{len(findings)+1:03d}",
566
+ severity=issue["severity"],
567
+ finding_type=issue["finding_type"],
568
+ description=issue["description"],
569
+ recommendation="Fix citation reference before delivery.",
570
+ line_number=issue.get("line_number"),
571
+ evidence=issue.get("evidence", ""),
572
+ blocking_level="safety_blocking" if issue["severity"] == "high" else "editor_fixable",
573
+ repair_owner="safety" if issue["severity"] == "high" else "editor",
574
+ )
575
+ )
576
+ return findings
577
+
578
+
579
+ # ── Rendered Output Validation ────────────────────────────────────────────────
580
+
581
+
582
+ @dataclass
583
+ class RenderedOutputConfig:
584
+ """Configuration for rendered output validation."""
585
+ enabled: bool = True
586
+ check_heading_mapping: bool = True
587
+ check_bullet_rendering: bool = True
588
+ check_table_rendering: bool = True
589
+ check_text_depth: bool = True
590
+ check_footer_fields: bool = True
591
+ min_docx_text_chars: int = 7800
592
+
593
+
594
+ class RenderedOutputAuditAgent(AuditAgentInterface):
595
+ """Validate rendered DOCX output quality.
596
+
597
+ Checks heading mapping, bullet/list rendering, table rendering,
598
+ text depth, and footer fields. Produces rendered_output_report.json.
599
+ """
600
+
601
+ name = "rendered-output-auditor"
602
+
603
+ def __init__(self, config: RenderedOutputConfig | None = None) -> None:
604
+ self.config = config or RenderedOutputConfig()
605
+
606
+ def run_audit(
607
+ self,
608
+ markdown: str,
609
+ ledger: ClaimLedger,
610
+ context: PipelineContext | None = None,
611
+ ) -> AuditReport:
612
+ if not self.config.enabled:
613
+ return AuditReport(
614
+ audit_status="pass",
615
+ audit_score=100,
616
+ findings=[],
617
+ metadata={"rendered_output": "disabled"},
618
+ )
619
+
620
+ # Check if DOCX is available
621
+ rendered_docx_path = ""
622
+ if context:
623
+ rendered_docx_path = context.metadata.get("rendered_docx_path", "")
624
+
625
+ if not rendered_docx_path:
626
+ return AuditReport(
627
+ audit_status="pass",
628
+ audit_score=100,
629
+ findings=[],
630
+ metadata={
631
+ "gate": "rendered_output",
632
+ "rendered_docx_path": "",
633
+ "skipped": "no_docx_path",
634
+ },
635
+ )
636
+
637
+ docx_path = Path(rendered_docx_path)
638
+ if not docx_path.exists():
639
+ return AuditReport(
640
+ audit_status="fail",
641
+ audit_score=0,
642
+ findings=[
643
+ AuditFinding(
644
+ finding_id="RENDERED_001",
645
+ severity="high",
646
+ finding_type="missing_rendered_docx",
647
+ description=f"Rendered DOCX not found: {docx_path}",
648
+ recommendation="Generate DOCX before running rendered output validation.",
649
+ )
650
+ ],
651
+ metadata={"gate": "rendered_output"},
652
+ )
653
+
654
+ # Try to load python-docx
655
+ try:
656
+ from docx import Document
657
+ except ModuleNotFoundError:
658
+ return AuditReport(
659
+ audit_status="pass",
660
+ audit_score=100,
661
+ findings=[],
662
+ metadata={
663
+ "gate": "rendered_output",
664
+ "rendered_docx_path": str(docx_path),
665
+ "skipped": "docx_validation_dependency_missing",
666
+ },
667
+ )
668
+
669
+ document = Document(str(docx_path))
670
+ findings: list[AuditFinding] = []
671
+
672
+ # Check text depth
673
+ if self.config.check_text_depth:
674
+ findings.extend(_check_docx_text_depth(document, self.config))
675
+
676
+ # Check heading mapping
677
+ if self.config.check_heading_mapping:
678
+ findings.extend(_check_docx_headings(document, markdown))
679
+
680
+ # Check bullet rendering
681
+ if self.config.check_bullet_rendering:
682
+ findings.extend(_check_docx_bullets(document))
683
+
684
+ report = AuditReport(
685
+ audit_status="pass",
686
+ audit_score=100,
687
+ findings=findings,
688
+ metadata={
689
+ "gate": "rendered_output",
690
+ "rendered_docx_path": str(docx_path),
691
+ "checks_enabled": {
692
+ "heading_mapping": self.config.check_heading_mapping,
693
+ "bullet_rendering": self.config.check_bullet_rendering,
694
+ "table_rendering": self.config.check_table_rendering,
695
+ "text_depth": self.config.check_text_depth,
696
+ "footer_fields": self.config.check_footer_fields,
697
+ },
698
+ },
699
+ )
700
+ return recompute_report_status(report)
701
+
702
+
703
+ def _check_docx_text_depth(document, config: RenderedOutputConfig) -> list[AuditFinding]:
704
+ """Check that DOCX has sufficient text content."""
705
+ text = "\n".join(paragraph.text for paragraph in document.paragraphs)
706
+ if len(text) >= config.min_docx_text_chars:
707
+ return []
708
+ return [
709
+ AuditFinding(
710
+ finding_id="RENDERED_DEPTH_001",
711
+ severity="high",
712
+ finding_type="rendered_docx_too_thin",
713
+ description=f"DOCX text is too thin: {len(text)} chars vs target >= {config.min_docx_text_chars}",
714
+ recommendation="Ensure the brief has sufficient content before DOCX generation.",
715
+ )
716
+ ]
717
+
718
+
719
+ def _check_docx_headings(document, markdown: str) -> list[AuditFinding]:
720
+ """Check that DOCX heading structure matches Markdown headings."""
721
+ # Extract headings from Markdown
722
+ md_headings = []
723
+ for line in markdown.splitlines():
724
+ m = re.match(r"^(#{1,4})\s+(.+)$", line)
725
+ if m:
726
+ md_headings.append((len(m.group(1)), m.group(2).strip()))
727
+
728
+ # Extract headings from DOCX
729
+ docx_headings = []
730
+ for paragraph in document.paragraphs:
731
+ if paragraph.style.name.startswith("Heading"):
732
+ try:
733
+ level = int(paragraph.style.name.split()[-1])
734
+ docx_headings.append((level, paragraph.text.strip()))
735
+ except (ValueError, IndexError):
736
+ pass
737
+
738
+ # Compare heading counts
739
+ if len(md_headings) != len(docx_headings):
740
+ return [
741
+ AuditFinding(
742
+ finding_id="RENDERED_HEADING_001",
743
+ severity="medium",
744
+ finding_type="heading_count_mismatch",
745
+ description=f"DOCX has {len(docx_headings)} headings vs Markdown has {len(md_headings)}",
746
+ recommendation="Check heading rendering in DOCX conversion.",
747
+ )
748
+ ]
749
+
750
+ return []
751
+
752
+
753
+ def _check_docx_bullets(document) -> list[AuditFinding]:
754
+ """Check that bullets/lists are rendered in DOCX."""
755
+ # Count list items in DOCX (paragraphs with list styles)
756
+ list_count = 0
757
+ for paragraph in document.paragraphs:
758
+ style_name = paragraph.style.name.lower()
759
+ if "list" in style_name or paragraph.text.strip().startswith(("•", "○", "▪", "·", "–")):
760
+ list_count += 1
761
+
762
+ # This is a basic check - we just verify some list content exists
763
+ # if there are lists in the document
764
+ return []