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,471 @@
1
+ from __future__ import annotations
2
+
3
+ from datetime import date, datetime
4
+ import re
5
+
6
+ from multi_agent_brief.audit.redaction import scan_redaction_risks
7
+ from multi_agent_brief.audit.interfaces import AuditAgentInterface
8
+ from multi_agent_brief.audit.rule_packs import tag_finding
9
+ from multi_agent_brief.core.citations import SRC_REF_PATTERN
10
+ from multi_agent_brief.core.claim_ledger import ClaimLedger
11
+ from multi_agent_brief.core.schemas import AuditFinding, AuditReport, PipelineContext
12
+
13
+
14
+ NUMBER_PATTERN = re.compile(r"(\$[\d,.]+|[\d,.]+%|\b\d+(?:\.\d+)?\s?(?:GW|GWh|MW|MWh|million|billion)\b)")
15
+ HEADING_PATTERN = re.compile(r"^(#{1,6})\s+(.+?)\s*#*\s*$")
16
+ SOURCE_REFERENCE_SECTION_TITLES = {
17
+ "bibliography",
18
+ "data sources",
19
+ "references",
20
+ "source appendix",
21
+ "source list",
22
+ "sources",
23
+ "sources cited",
24
+ "works cited",
25
+ }
26
+ SOURCE_REFERENCE_SECTION_KEYWORDS = (
27
+ re.compile(r"(数据来源|资料来源|参考资料|参考来源|参考文献|来源附录)"),
28
+ )
29
+
30
+
31
+ def _tag(finding_type: str, **kwargs) -> AuditFinding:
32
+ """Create an AuditFinding with taxonomy tags from the rule pack."""
33
+ tax = tag_finding(finding_type)
34
+ return AuditFinding(
35
+ finding_type=finding_type,
36
+ blocking_level=tax["blocking_level"],
37
+ repair_owner=tax["repair_owner"],
38
+ **kwargs,
39
+ )
40
+
41
+
42
+ def parse_date(value: str) -> date | None:
43
+ if not value:
44
+ return None
45
+ text = value.strip()
46
+ for fmt, width in (("%Y-%m-%d", 10), ("%Y%m%d", 8)):
47
+ try:
48
+ return datetime.strptime(text[:width], fmt).date()
49
+ except ValueError:
50
+ continue
51
+ try:
52
+ return datetime.fromisoformat(text.replace("Z", "+00:00")).date()
53
+ except ValueError:
54
+ return None
55
+
56
+
57
+ def extract_src_refs(markdown: str) -> list[dict]:
58
+ refs: list[dict] = []
59
+ for line_number, line in enumerate(markdown.splitlines(), start=1):
60
+ for match in SRC_REF_PATTERN.finditer(line):
61
+ refs.append({"claim_id": match.group(1), "line_number": line_number, "line": line.strip()})
62
+ return refs
63
+
64
+
65
+ def _heading_level(line: str) -> int | None:
66
+ match = HEADING_PATTERN.match(line.strip())
67
+ if not match:
68
+ return None
69
+ return len(match.group(1))
70
+
71
+
72
+ def _plain_heading_text(line: str) -> str:
73
+ match = HEADING_PATTERN.match(line.strip())
74
+ if not match:
75
+ return ""
76
+ text = match.group(2).strip()
77
+ text = re.sub(r"[*_`]+", "", text)
78
+ text = re.sub(r"^\d+(?:\.\d+)*[.)、.]?\s*", "", text)
79
+ text = re.sub(r"^[一二三四五六七八九十]+[、..]\s*", "", text)
80
+ return text.strip(" \t:-—–:")
81
+
82
+
83
+ def _source_reference_section_level(line: str) -> int | None:
84
+ level = _heading_level(line)
85
+ if level is None:
86
+ return None
87
+ heading = _plain_heading_text(line)
88
+ english_heading = re.sub(r"\s+", " ", heading.casefold())
89
+ if english_heading in SOURCE_REFERENCE_SECTION_TITLES:
90
+ return level
91
+ if any(pattern.search(heading) for pattern in SOURCE_REFERENCE_SECTION_KEYWORDS):
92
+ return level
93
+ return None
94
+
95
+
96
+ def run_deterministic_audit(
97
+ markdown: str,
98
+ ledger: ClaimLedger,
99
+ *,
100
+ report_date: str = "",
101
+ max_source_age_days: int | None = None,
102
+ fail_on_stale_source: bool = False,
103
+ ) -> AuditReport:
104
+ findings: list[AuditFinding] = []
105
+ refs = extract_src_refs(markdown)
106
+ referenced_ids = {ref["claim_id"] for ref in refs}
107
+
108
+ for ref in refs:
109
+ if ledger.get_claim(ref["claim_id"]) is None:
110
+ findings.append(
111
+ _tag(
112
+ "missing_claim",
113
+ finding_id=f"ORPHAN_{len(findings)+1:03d}",
114
+ severity="high",
115
+ related_claim_id=ref["claim_id"],
116
+ line_number=ref["line_number"],
117
+ description=f"Referenced claim_id {ref['claim_id']} was not found in the Claim Ledger.",
118
+ recommendation="Remove the reference or add the supporting claim to the ledger.",
119
+ evidence=ref["line"],
120
+ )
121
+ )
122
+
123
+ source_reference_section_level: int | None = None
124
+ for line_number, line in enumerate(markdown.splitlines(), start=1):
125
+ heading_level = _heading_level(line)
126
+ if heading_level is not None and source_reference_section_level is not None:
127
+ if heading_level <= source_reference_section_level:
128
+ source_reference_section_level = None
129
+ section_level = _source_reference_section_level(line)
130
+ if section_level is not None:
131
+ source_reference_section_level = section_level
132
+ continue
133
+ if source_reference_section_level is not None:
134
+ continue
135
+ if not line.strip() or line.startswith("#"):
136
+ continue
137
+ if SRC_REF_PATTERN.search(line):
138
+ continue
139
+ for match in NUMBER_PATTERN.finditer(line):
140
+ findings.append(
141
+ _tag(
142
+ "number_without_source",
143
+ finding_id=f"NUMBER_{len(findings)+1:03d}",
144
+ severity="medium",
145
+ line_number=line_number,
146
+ description=f"Number-like value '{match.group(1)}' appears without a source reference on the same line.",
147
+ recommendation="Attach a [src:<claim_id>] reference using a real Claim Ledger ID or remove the unsupported number.",
148
+ evidence=line.strip(),
149
+ )
150
+ )
151
+
152
+ for claim in ledger.detect_missing_sources():
153
+ findings.append(
154
+ _tag(
155
+ "missing_source",
156
+ finding_id=f"SOURCE_{len(findings)+1:03d}",
157
+ severity="high",
158
+ related_claim_id=claim.claim_id,
159
+ description="A claim requires audit but is missing source_id or evidence_text.",
160
+ recommendation="Add source metadata and evidence text before using the claim.",
161
+ evidence=claim.statement,
162
+ )
163
+ )
164
+
165
+ for duplicate_group in ledger.detect_duplicate_claims():
166
+ findings.append(
167
+ _tag(
168
+ "duplicate_claim",
169
+ finding_id=f"DUP_{len(findings)+1:03d}",
170
+ severity="low",
171
+ related_claim_id=duplicate_group[0].claim_id,
172
+ description=f"Duplicate claim statements found: {', '.join(claim.claim_id for claim in duplicate_group)}.",
173
+ recommendation="Merge duplicate claims or clarify their separate source contexts.",
174
+ evidence=duplicate_group[0].statement,
175
+ )
176
+ )
177
+
178
+ report_day = parse_date(report_date)
179
+ web_search_missing_date_count = 0
180
+ if report_day and max_source_age_days is not None:
181
+ for claim in ledger:
182
+ published_at = str(claim.metadata.get("published_at", ""))
183
+ source_day = parse_date(published_at)
184
+ if source_day is None:
185
+ # web_search sources often lack published_at — flag it at low severity (B15)
186
+ if claim.source_type == "web_search":
187
+ findings.append(
188
+ _tag(
189
+ "missing_source_date",
190
+ finding_id=f"DATE_{len(findings)+1:03d}",
191
+ severity="low",
192
+ related_claim_id=claim.claim_id,
193
+ description="Web search claim is missing a parseable published_at date.",
194
+ recommendation="Mark the source as retrieved_only or provide published_at.",
195
+ evidence=claim.statement,
196
+ )
197
+ )
198
+ web_search_missing_date_count += 1
199
+ else:
200
+ findings.append(
201
+ _tag(
202
+ "missing_source_date",
203
+ finding_id=f"DATE_{len(findings)+1:03d}",
204
+ severity="medium",
205
+ related_claim_id=claim.claim_id,
206
+ description="Claim source is missing a parseable published_at date for reporting-window audit.",
207
+ recommendation="Add source published_at metadata or mark the source as evergreen/background.",
208
+ evidence=claim.statement,
209
+ )
210
+ )
211
+ continue
212
+ age_days = (report_day - source_day).days
213
+ if age_days > max_source_age_days:
214
+ findings.append(
215
+ _tag(
216
+ "stale_source",
217
+ finding_id=f"STALE_{len(findings)+1:03d}",
218
+ severity="high" if fail_on_stale_source else "medium",
219
+ related_claim_id=claim.claim_id,
220
+ description=(
221
+ f"Source date {source_day.isoformat()} is {age_days} days before report date "
222
+ f"{report_day.isoformat()}, exceeding the {max_source_age_days}-day reporting window."
223
+ ),
224
+ recommendation="Remove this item from the weekly brief or recast it as dated background.",
225
+ evidence=claim.statement,
226
+ )
227
+ )
228
+
229
+ for risk in scan_redaction_risks(markdown + "\n" + "\n".join(claim.evidence_text for claim in ledger)):
230
+ findings.append(
231
+ _tag(
232
+ "redaction_risk",
233
+ finding_id=f"REDACT_{len(findings)+1:03d}",
234
+ severity="high" if risk["severity"] == "high" else "medium",
235
+ description=f"Potential {risk['type']} detected.",
236
+ recommendation=risk["recommendation"],
237
+ evidence=risk["text"],
238
+ )
239
+ )
240
+
241
+ # Epistemic gate checks (Claim Schema v2)
242
+ for claim in ledger:
243
+ if claim.epistemic_type == "hypothesis" and claim.confidence == "high":
244
+ findings.append(
245
+ _tag(
246
+ "hypothesis_high_confidence",
247
+ finding_id=f"EPISTEMIC_{len(findings)+1:03d}",
248
+ severity="high",
249
+ related_claim_id=claim.claim_id,
250
+ description="Hypothesis claim is presented with high confidence — hypotheses should not be treated as certain facts.",
251
+ recommendation="Lower confidence to medium/low or reclassify as observed.",
252
+ evidence=claim.statement,
253
+ )
254
+ )
255
+ if claim.epistemic_type == "action" and not claim.applicability_reason.strip():
256
+ findings.append(
257
+ _tag(
258
+ "action_without_basis",
259
+ finding_id=f"EPISTEMIC_{len(findings)+1:03d}",
260
+ severity="high",
261
+ related_claim_id=claim.claim_id,
262
+ description="Action claim lacks applicability rationale — actions must justify why they apply here.",
263
+ recommendation="Add applicability_reason explaining why this action is relevant.",
264
+ evidence=claim.statement,
265
+ )
266
+ )
267
+ if claim.epistemic_type == "analogy" and not claim.limitations:
268
+ findings.append(
269
+ _tag(
270
+ "analogy_without_limitations",
271
+ finding_id=f"EPISTEMIC_{len(findings)+1:03d}",
272
+ severity="medium",
273
+ related_claim_id=claim.claim_id,
274
+ description="Analogy claim has no stated limitations — analogies must declare where they break down.",
275
+ recommendation="Add limitations describing where the analogy does not hold.",
276
+ evidence=claim.statement,
277
+ )
278
+ )
279
+ if claim.epistemic_type == "analogy" and claim.evidence_relation == "direct":
280
+ findings.append(
281
+ _tag(
282
+ "analogy_direct_relation",
283
+ finding_id=f"EPISTEMIC_{len(findings)+1:03d}",
284
+ severity="high",
285
+ related_claim_id=claim.claim_id,
286
+ description="Analogy claim uses 'direct' evidence relation — analogies should use indirect or analogous relation.",
287
+ recommendation="Change evidence_relation to 'indirect' or 'analogous'.",
288
+ evidence=claim.statement,
289
+ )
290
+ )
291
+
292
+ unused_claims = [claim.claim_id for claim in ledger if claim.claim_id not in referenced_ids]
293
+ metadata = {
294
+ "refs_extracted": len(refs),
295
+ "unique_refs": len(referenced_ids),
296
+ "ledger_claims": len(ledger),
297
+ "unused_claims": unused_claims,
298
+ "report_date": report_date,
299
+ "max_source_age_days": max_source_age_days,
300
+ "fail_on_stale_source": fail_on_stale_source,
301
+ "web_search_missing_published_at": web_search_missing_date_count,
302
+ }
303
+ high = sum(1 for finding in findings if finding.severity == "high")
304
+ medium = sum(1 for finding in findings if finding.severity == "medium")
305
+ if high:
306
+ status = "fail"
307
+ elif medium:
308
+ status = "warning"
309
+ else:
310
+ status = "pass"
311
+ score = max(0, 100 - high * 25 - medium * 10 - (len(findings) - high - medium) * 3)
312
+ return AuditReport(audit_status=status, audit_score=score, findings=findings, metadata=metadata)
313
+
314
+
315
+ class DeterministicAuditAgent(AuditAgentInterface):
316
+ name = "deterministic-auditor"
317
+
318
+ def run_audit(
319
+ self,
320
+ markdown: str,
321
+ ledger: ClaimLedger,
322
+ context: PipelineContext | None = None,
323
+ ) -> AuditReport:
324
+ report = run_deterministic_audit(
325
+ markdown,
326
+ ledger,
327
+ report_date=context.report_date if context else "",
328
+ max_source_age_days=context.max_source_age_days if context else None,
329
+ fail_on_stale_source=context.fail_on_stale_source if context else False,
330
+ )
331
+
332
+ # Local signal audit checks — only when local signal discovery is configured
333
+ if context:
334
+ local_signal_report = context.metadata.get("local_signal_report")
335
+ discovery = context.metadata.get("source_discovery", {})
336
+ has_local_signal = bool(
337
+ local_signal_report
338
+ or discovery.get("local_signal_discovery", {}).get("enabled", False)
339
+ )
340
+ if has_local_signal:
341
+ local_findings = _check_local_signal_claims(markdown, ledger, context)
342
+ report.findings.extend(local_findings)
343
+ if local_findings:
344
+ from multi_agent_brief.audit.interfaces import recompute_report_status
345
+ recompute_report_status(report)
346
+
347
+ return report
348
+
349
+
350
+ # ── Local Signal Audit Checks ────────────────────────────────────────
351
+
352
+ # Patterns that indicate consumer pain-point claims
353
+ # Chinese patterns — no case distinction
354
+ _CONSUMER_PAIN_PATTERNS_ZH = [
355
+ re.compile(r"消费者(?:认为|抱怨|普遍|反馈|觉得|表示)"),
356
+ re.compile(r"用户(?:抱怨|觉得|认为|反馈|评价|普遍)"),
357
+ re.compile(r"市场反馈(?:显示|表明|指出)"),
358
+ re.compile(r"用户评价(?:显示|表明)"),
359
+ ]
360
+
361
+ # English patterns — case insensitive
362
+ _CONSUMER_PAIN_PATTERNS_EN = [
363
+ re.compile(r"consumers?\s+\w*\s*(?:report|complain|believe|feel|say|indicate)", re.IGNORECASE),
364
+ re.compile(r"users?\s+\w*\s*(?:complain|report|feel|believe|commonly)", re.IGNORECASE),
365
+ re.compile(r"market\s+feedback\s+(?:shows|indicates|suggests)", re.IGNORECASE),
366
+ re.compile(r"customer\s+(?:complaints?|feedback|reviews?)\s+(?:show|indicate|suggest)", re.IGNORECASE),
367
+ ]
368
+
369
+ _CONSUMER_PAIN_PATTERNS = _CONSUMER_PAIN_PATTERNS_ZH + _CONSUMER_PAIN_PATTERNS_EN
370
+
371
+ # Source types that count as consumer-level evidence
372
+ _CONSUMER_SOURCE_TYPES = {"local_signal", "consumer_discussion", "platform_data"}
373
+
374
+
375
+ def _check_local_signal_claims(
376
+ markdown: str,
377
+ ledger: ClaimLedger,
378
+ context: PipelineContext,
379
+ ) -> list[AuditFinding]:
380
+ """Check local signal audit rules.
381
+
382
+ LOCAL_SIGNAL_CLAIM_001: Consumer pain-point claims require consumer-level sources.
383
+ LOCAL_SIGNAL_PROVENANCE_001: Local signal claims require sample metadata.
384
+ LOCAL_SIGNAL_PRIVACY_001: Personal data must not enter final brief.
385
+ """
386
+ findings: list[AuditFinding] = []
387
+
388
+ # LOCAL_SIGNAL_CLAIM_001: Check for consumer pain-point claims without consumer sources
389
+ for line_num, line in enumerate(markdown.splitlines(), start=1):
390
+ if not line.strip() or line.startswith("#"):
391
+ continue
392
+ for pattern in _CONSUMER_PAIN_PATTERNS:
393
+ if pattern.search(line):
394
+ # Check if this line has a source reference to a consumer-level claim
395
+ src_refs = SRC_REF_PATTERN.findall(line)
396
+ has_consumer_source = False
397
+ for claim_id in src_refs:
398
+ claim = ledger.get_claim(claim_id)
399
+ if claim and claim.source_type in _CONSUMER_SOURCE_TYPES:
400
+ has_consumer_source = True
401
+ break
402
+ # Also check metadata for source_family
403
+ if claim and claim.metadata.get("source_family") == "local_signal":
404
+ has_consumer_source = True
405
+ break
406
+
407
+ if not has_consumer_source:
408
+ findings.append(
409
+ _tag(
410
+ "local_signal_unsupported_claim",
411
+ finding_id=f"LOCAL_SIGNAL_CLAIM_{len(findings)+1:03d}",
412
+ severity="high",
413
+ line_number=line_num,
414
+ description=(
415
+ "Consumer pain-point claim appears without consumer-level "
416
+ "or platform-data source support. External trend articles "
417
+ "cannot support specific consumer sentiment claims."
418
+ ),
419
+ recommendation=(
420
+ "Add consumer-discussion or platform-data sources, "
421
+ "or reframe as external trend observation."
422
+ ),
423
+ evidence=line.strip(),
424
+ )
425
+ )
426
+ break # Only one finding per line
427
+
428
+ # LOCAL_SIGNAL_PROVENANCE_001: Check local signal claims have required metadata
429
+ for claim in ledger:
430
+ if claim.source_type == "local_signal" or claim.metadata.get("source_family") == "local_signal":
431
+ required_meta = ["platform", "market", "collected_at", "access_level", "sample_type", "collector"]
432
+ missing = [k for k in required_meta if not claim.metadata.get(k)]
433
+ if missing:
434
+ findings.append(
435
+ _tag(
436
+ "local_signal_missing_provenance",
437
+ finding_id=f"LOCAL_SIGNAL_PROV_{len(findings)+1:03d}",
438
+ severity="medium",
439
+ related_claim_id=claim.claim_id,
440
+ description=(
441
+ f"Local signal claim {claim.claim_id} is missing required "
442
+ f"sample metadata: {', '.join(missing)}"
443
+ ),
444
+ recommendation="Add sample metadata (platform, market, collected_at, etc.) to the claim.",
445
+ evidence=claim.statement,
446
+ )
447
+ )
448
+
449
+ # LOCAL_SIGNAL_PRIVACY_001: Check for personal data in local signal claims
450
+ for claim in ledger:
451
+ is_local_signal = (
452
+ claim.source_type == "local_signal"
453
+ or claim.metadata.get("source_family") == "local_signal"
454
+ )
455
+ if is_local_signal and claim.metadata.get("contains_personal_data", False):
456
+ findings.append(
457
+ _tag(
458
+ "local_signal_privacy_violation",
459
+ finding_id=f"LOCAL_SIGNAL_PRIV_{len(findings)+1:03d}",
460
+ severity="high",
461
+ related_claim_id=claim.claim_id,
462
+ description=(
463
+ f"Claim {claim.claim_id} is marked as containing personal data "
464
+ f"and must not appear in the final brief."
465
+ ),
466
+ recommendation="Remove this claim or redact personal data before including in brief.",
467
+ evidence=claim.statement,
468
+ )
469
+ )
470
+
471
+ return findings