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,525 @@
1
+ """Read-only support-calibrated wording diagnostics.
2
+
3
+ This module surfaces deterministic reader-facing wording risks from already
4
+ recorded source/support metadata. It does not judge claim truth, generate or
5
+ accept Claim-Support Matrix rows, run gates, approve delivery, or decide release
6
+ readiness.
7
+ """
8
+
9
+ from __future__ import annotations
10
+
11
+ import json
12
+ import re
13
+ from pathlib import Path
14
+ from typing import Any, Mapping
15
+
16
+ from multi_agent_brief.contracts.schemas.claim import ClaimContract
17
+ from multi_agent_brief.core.claim_ledger import ClaimLedger
18
+
19
+
20
+ SUPPORT_WORDING_SCHEMA_VERSION = "briefloop.support_wording.v1"
21
+ SUPPORT_WORDING_BOUNDARY = "support_wording_projection_only_not_support_truth_or_gate_authority"
22
+ SUPPORT_WORDING_RUNTIME_EFFECT = "none"
23
+
24
+ SUPPORT_WORDING_STATUSES = {
25
+ "checked",
26
+ "invalid_claim_ledger",
27
+ "no_reader_targets",
28
+ "not_available",
29
+ }
30
+ SUPPORT_WORDING_FINDING_TYPES = {
31
+ "unsupported_claim_reaches_reader",
32
+ "weak_support_strong_wording",
33
+ "inference_without_framing",
34
+ "source_class_strong_wording",
35
+ }
36
+ SUPPORT_WORDING_ACTIONS = {"review_support_wording_warnings", "request_human_review"}
37
+ SUPPORT_WORDING_NON_GOALS = {
38
+ "semantic_truth_proof",
39
+ "support_truth_assessment",
40
+ "claim_support_matrix_generation",
41
+ "semantic_assessment_acceptance",
42
+ "gate_decision",
43
+ "delivery_approval",
44
+ "release_authority",
45
+ "quality_score",
46
+ }
47
+ SUPPORT_WORDING_SUMMARY_FIELDS = {
48
+ "target_count",
49
+ "present_target_count",
50
+ "unreadable_target_count",
51
+ "finding_count",
52
+ "unsupported_reader_claim_count",
53
+ "weak_support_strong_wording_count",
54
+ "inference_without_framing_count",
55
+ "source_class_strong_wording_count",
56
+ }
57
+
58
+ _INTERMEDIATE = Path("output/intermediate")
59
+ _READER_TARGETS = ("output/brief.md", "output/delivery/brief.md")
60
+ _UNSUPPORTED_SUPPORT_LABELS = {"unsupported", "contradicted", "insufficient_evidence"}
61
+ _AUTHORITY_KEYS = {
62
+ "approve_delivery",
63
+ "approved_for_delivery",
64
+ "accepted_support_truth",
65
+ "claim_support_matrix_generation",
66
+ "delivery_approval",
67
+ "gate_decision",
68
+ "quality_score",
69
+ "release_authority",
70
+ "semantic_truth_proof",
71
+ "state_transition",
72
+ "support_truth_assessment",
73
+ }
74
+ _STRONG_WORDING_RE = re.compile(
75
+ r"\b(will|must|guarantee(?:s|d)?|prove(?:s|d)?|confirm(?:s|ed)?|demonstrate(?:s|d)?|"
76
+ r"certain(?:ly)?|undeniabl(?:e|y)|officially\s+confirmed)\b|"
77
+ r"(必然|一定|保证|证明|证实|确认|将会|毫无疑问)",
78
+ re.IGNORECASE,
79
+ )
80
+ _FRAMING_RE = re.compile(
81
+ r"\b(may|might|could|suggest(?:s|ed)?|appear(?:s|ed)?|report(?:s|ed)?|according\s+to|"
82
+ r"indicat(?:e|es|ed)|estimate(?:s|d)?|scenario|possible|potential)\b|"
83
+ r"(可能|或许|据|显示|表明|估计|情景|潜在|报道称|报告称)",
84
+ re.IGNORECASE,
85
+ )
86
+ _ATTRIBUTION_RE = re.compile(
87
+ r"\b(according\s+to|reported\s+by|the\s+report\s+(?:said|says)|sources?\s+(?:said|say))\b|"
88
+ r"(据|报道称|报告称|来源称)",
89
+ re.IGNORECASE,
90
+ )
91
+ _TOKEN_RE = re.compile(r"[a-z0-9]+|[\u4e00-\u9fff]{2,}", re.IGNORECASE)
92
+
93
+
94
+ def project_workspace_support_wording(
95
+ workspace: str | Path,
96
+ *,
97
+ claim_support_matrix: Mapping[str, Any] | None = None,
98
+ ) -> dict[str, Any]:
99
+ """Project reader wording risks without writing workspace state."""
100
+
101
+ ws = Path(workspace).expanduser().resolve()
102
+ base = _base_projection()
103
+ claims, reason = _read_claims(ws / _INTERMEDIATE / "claim_ledger.json")
104
+ if reason:
105
+ status = "not_available" if reason == "claim_ledger_missing" else "invalid_claim_ledger"
106
+ return {
107
+ **base,
108
+ "status": status,
109
+ "reason": reason,
110
+ "claim_count": 0,
111
+ "support_artifact_status": "not_available",
112
+ "targets": _missing_targets(ws),
113
+ "summary_counts": _summary_counts([]),
114
+ }
115
+
116
+ if isinstance(claim_support_matrix, Mapping):
117
+ support_projection = dict(claim_support_matrix)
118
+ else:
119
+ from multi_agent_brief.orchestrator.runtime_state.claim_support_matrix import (
120
+ project_claim_support_matrix_from_workspace,
121
+ )
122
+
123
+ support_projection = project_claim_support_matrix_from_workspace(ws)
124
+ support_artifact_status = _support_artifact_status(support_projection)
125
+ support_index = _support_index(support_projection) if support_artifact_status == "valid" else {}
126
+ targets = [_project_target(ws, rel_path, claims, support_index) for rel_path in _READER_TARGETS]
127
+ present_targets = [target for target in targets if target.get("status") not in {"missing", "unreadable"}]
128
+ unreadable_target_count = sum(1 for target in targets if target.get("status") == "unreadable")
129
+ findings = [finding for target in targets for finding in target.get("findings", []) if isinstance(finding, dict)]
130
+ status = "checked" if present_targets else "not_available" if unreadable_target_count else "no_reader_targets"
131
+ reason = None
132
+ if not present_targets:
133
+ reason = "reader_targets_unreadable" if unreadable_target_count else "reader_targets_missing"
134
+ return {
135
+ **base,
136
+ "status": status,
137
+ "reason": reason,
138
+ "claim_count": len(claims),
139
+ "support_artifact_status": support_artifact_status,
140
+ "targets": targets,
141
+ "findings": findings[:50],
142
+ "summary_counts": _summary_counts(
143
+ findings,
144
+ present_target_count=len(present_targets),
145
+ unreadable_target_count=unreadable_target_count,
146
+ ),
147
+ "recommended_actions": _recommended_actions(findings),
148
+ }
149
+
150
+
151
+ def validate_support_wording_payload(payload: Any) -> str | None:
152
+ if not isinstance(payload, dict):
153
+ return "support_wording_schema_error:not_object"
154
+ if _contains_authority_key(payload):
155
+ return "support_wording_schema_error:authority_field"
156
+ if payload.get("schema_version") != SUPPORT_WORDING_SCHEMA_VERSION:
157
+ return "support_wording_schema_error:schema_version"
158
+ if payload.get("boundary") != SUPPORT_WORDING_BOUNDARY:
159
+ return "support_wording_schema_error:boundary"
160
+ if payload.get("runtime_effect") != SUPPORT_WORDING_RUNTIME_EFFECT:
161
+ return "support_wording_schema_error:runtime_effect"
162
+ if payload.get("read_only") is not True:
163
+ return "support_wording_schema_error:read_only"
164
+ if payload.get("status") not in SUPPORT_WORDING_STATUSES:
165
+ return "support_wording_schema_error:status"
166
+ if not SUPPORT_WORDING_NON_GOALS.issubset({str(item) for item in payload.get("non_goals", [])}):
167
+ return "support_wording_schema_error:non_goals"
168
+ for field in ("targets", "findings", "recommended_actions", "non_goals"):
169
+ if not isinstance(payload.get(field), list):
170
+ return f"support_wording_schema_error:{field}"
171
+ summary = payload.get("summary_counts")
172
+ if not isinstance(summary, dict):
173
+ return "support_wording_schema_error:summary_counts"
174
+ for field in SUPPORT_WORDING_SUMMARY_FIELDS:
175
+ if not isinstance(summary.get(field), int) or summary.get(field, 0) < 0:
176
+ return f"support_wording_schema_error:summary_counts.{field}"
177
+ for target in payload.get("targets", []):
178
+ if not isinstance(target, dict):
179
+ return "support_wording_schema_error:targets"
180
+ if target.get("status") not in {"missing", "pass", "warning", "unreadable"}:
181
+ return "support_wording_schema_error:targets.status"
182
+ for finding in payload.get("findings", []):
183
+ if not isinstance(finding, dict):
184
+ return "support_wording_schema_error:findings"
185
+ if str(finding.get("finding_type") or "") not in SUPPORT_WORDING_FINDING_TYPES:
186
+ return "support_wording_schema_error:findings.finding_type"
187
+ if str(finding.get("severity") or "") not in {"warning", "human_review"}:
188
+ return "support_wording_schema_error:findings.severity"
189
+ for action in payload.get("recommended_actions", []):
190
+ if not isinstance(action, dict):
191
+ return "support_wording_schema_error:recommended_actions"
192
+ if str(action.get("action") or "") not in SUPPORT_WORDING_ACTIONS:
193
+ return "support_wording_schema_error:recommended_actions.action"
194
+ return None
195
+
196
+
197
+ def _base_projection() -> dict[str, Any]:
198
+ return {
199
+ "schema_version": SUPPORT_WORDING_SCHEMA_VERSION,
200
+ "read_only": True,
201
+ "runtime_effect": SUPPORT_WORDING_RUNTIME_EFFECT,
202
+ "boundary": SUPPORT_WORDING_BOUNDARY,
203
+ "semantic_boundary": "deterministic_lexical_projection_from_recorded_support_metadata_only",
204
+ "targets": [],
205
+ "findings": [],
206
+ "summary_counts": _summary_counts([]),
207
+ "recommended_actions": [],
208
+ "non_goals": sorted(SUPPORT_WORDING_NON_GOALS),
209
+ }
210
+
211
+
212
+ def _read_claims(path: Path) -> tuple[list[dict[str, Any]], str | None]:
213
+ if not path.exists():
214
+ return [], "claim_ledger_missing"
215
+ try:
216
+ payload = json.loads(path.read_text(encoding="utf-8"))
217
+ claims = ClaimLedger._claim_items_from_json(payload)
218
+ except (OSError, UnicodeDecodeError, json.JSONDecodeError, ValueError) as exc:
219
+ return [], f"claim_ledger_unreadable:{type(exc).__name__}"
220
+ seen_ids: set[str] = set()
221
+ for index, claim in enumerate(claims):
222
+ for field in ("claim_id", "statement", "source_id", "evidence_text"):
223
+ value = claim.get(field)
224
+ if not isinstance(value, str) or not value.strip():
225
+ return [], f"claim_ledger_invalid:claims[{index}].{field}"
226
+ claim_id = claim["claim_id"].strip()
227
+ if claim_id in seen_ids:
228
+ return [], f"claim_ledger_invalid:duplicate_claim_id:{claim_id}"
229
+ seen_ids.add(claim_id)
230
+ violations = [
231
+ violation
232
+ for violation in ClaimContract.validate(claim)
233
+ if violation.severity == "error"
234
+ ]
235
+ if violations:
236
+ first = violations[0]
237
+ return [], f"claim_ledger_invalid:claims[{index}].{first.field}"
238
+ return [dict(claim) for claim in claims], None
239
+
240
+
241
+ def _missing_targets(workspace: Path) -> list[dict[str, Any]]:
242
+ return [
243
+ {"target_artifact": rel_path, "status": "missing", "finding_count": 0, "findings": []}
244
+ for rel_path in _READER_TARGETS
245
+ if not (workspace / rel_path).exists()
246
+ ]
247
+
248
+
249
+ def _project_target(
250
+ workspace: Path,
251
+ rel_path: str,
252
+ claims: list[dict[str, Any]],
253
+ support_index: Mapping[str, Mapping[str, Any]],
254
+ ) -> dict[str, Any]:
255
+ path = workspace / rel_path
256
+ if not path.exists():
257
+ return {"target_artifact": rel_path, "status": "missing", "finding_count": 0, "findings": []}
258
+ try:
259
+ text = path.read_text(encoding="utf-8")
260
+ except (OSError, UnicodeDecodeError) as exc:
261
+ return {
262
+ "target_artifact": rel_path,
263
+ "status": "unreadable",
264
+ "error": str(exc),
265
+ "finding_count": 0,
266
+ "findings": [],
267
+ }
268
+ findings: list[dict[str, Any]] = []
269
+ for claim in claims:
270
+ context = _matching_context(text, _text(claim.get("statement")))
271
+ if not context:
272
+ continue
273
+ finding_base = {
274
+ "target_artifact": rel_path,
275
+ "claim_id": _text(claim.get("claim_id")),
276
+ "evidence_ref": _short_text(context),
277
+ }
278
+ support = dict(support_index.get(_text(claim.get("claim_id"))) or _claim_intrinsic_support_risk(claim))
279
+ source_class = _claim_source_class(claim)
280
+ strong_wording = bool(_STRONG_WORDING_RE.search(context))
281
+ framed = bool(_FRAMING_RE.search(context))
282
+ attributed = bool(_ATTRIBUTION_RE.search(context))
283
+ if support.get("blocking") or support.get("unsupported"):
284
+ findings.append(_finding(
285
+ finding_type="unsupported_claim_reaches_reader",
286
+ severity="human_review",
287
+ description="A claim with explicit unsupported/contradicted/insufficient support records appears in reader text.",
288
+ recommendation="Downgrade, remove, or route the claim through support repair before relying on it in reader-facing text.",
289
+ metadata={"support_labels": support.get("support_labels", []), "support_source": support.get("source")},
290
+ **finding_base,
291
+ ))
292
+ if strong_wording and (support.get("weak") or support.get("downgrade_required")):
293
+ findings.append(_finding(
294
+ finding_type="weak_support_strong_wording",
295
+ severity="warning",
296
+ description="Reader text uses strong certainty wording for a claim recorded as weak or downgrade-required support.",
297
+ recommendation="Use attributed, qualified wording or resolve the support record before retaining strong phrasing.",
298
+ metadata={"support_labels": support.get("support_labels", []), "support_source": support.get("source")},
299
+ **finding_base,
300
+ ))
301
+ if support.get("inference_required") and not framed:
302
+ findings.append(_finding(
303
+ finding_type="inference_without_framing",
304
+ severity="warning",
305
+ description="Reader text presents an inferred or interpretive claim without visible uncertainty/attribution framing.",
306
+ recommendation="Frame the wording as an inference, estimate, scenario, or attributed report.",
307
+ metadata={"support_labels": support.get("support_labels", []), "support_source": support.get("source")},
308
+ **finding_base,
309
+ ))
310
+ if source_class in {"news_media", "market_report", "media_report"} and strong_wording and not attributed:
311
+ findings.append(_finding(
312
+ finding_type="source_class_strong_wording",
313
+ severity="warning",
314
+ description="Reader text uses strong wording for a claim sourced from media/report-style evidence without visible attribution.",
315
+ recommendation="Attribute the source class or soften certainty wording unless stronger primary support is available.",
316
+ metadata={"source_class": source_class},
317
+ **finding_base,
318
+ ))
319
+ return {
320
+ "target_artifact": rel_path,
321
+ "status": "warning" if findings else "pass",
322
+ "finding_count": len(findings),
323
+ "findings": [
324
+ {**finding, "finding_id": f"SUPWORD-{idx:03d}"}
325
+ for idx, finding in enumerate(findings, start=1)
326
+ ],
327
+ }
328
+
329
+
330
+ def _support_artifact_status(projection: Mapping[str, Any]) -> str:
331
+ status = _text(projection.get("status"))
332
+ if status == "valid":
333
+ return "valid"
334
+ if status in {"invalid_matrix", "invalid"}:
335
+ return "invalid"
336
+ if status in {"not_available", ""}:
337
+ return "not_available"
338
+ return status
339
+
340
+
341
+ def _support_index(projection: Mapping[str, Any]) -> dict[str, dict[str, Any]]:
342
+ index: dict[str, dict[str, Any]] = {}
343
+ atoms = projection.get("atoms") if isinstance(projection.get("atoms"), list) else []
344
+ for atom in atoms:
345
+ if not isinstance(atom, Mapping):
346
+ continue
347
+ claim_id = _text(atom.get("claim_id"))
348
+ if not claim_id:
349
+ continue
350
+ item = index.setdefault(
351
+ claim_id,
352
+ {
353
+ "source": "claim_support_matrix",
354
+ "support_labels": set(),
355
+ "blocking": False,
356
+ "weak": False,
357
+ "downgrade_required": False,
358
+ "inference_required": False,
359
+ "unsupported": False,
360
+ },
361
+ )
362
+ item["blocking"] = bool(item["blocking"] or atom.get("blocking"))
363
+ item["weak"] = bool(item["weak"] or atom.get("weak_support"))
364
+ item["downgrade_required"] = bool(item["downgrade_required"] or atom.get("downgrade_required"))
365
+ item["inference_required"] = bool(item["inference_required"] or atom.get("inference_framing_required"))
366
+ labels = atom.get("support_labels") if isinstance(atom.get("support_labels"), list) else []
367
+ item["support_labels"].update(str(label) for label in labels if str(label).strip())
368
+ item["unsupported"] = bool(
369
+ item["unsupported"]
370
+ or any(str(label).strip() in _UNSUPPORTED_SUPPORT_LABELS for label in labels)
371
+ )
372
+ for item in index.values():
373
+ item["support_labels"] = sorted(item["support_labels"])
374
+ return index
375
+
376
+
377
+ def _claim_intrinsic_support_risk(claim: Mapping[str, Any]) -> dict[str, Any]:
378
+ evidence_relation = _text(claim.get("evidence_relation"))
379
+ epistemic_type = _text(claim.get("epistemic_type"))
380
+ confidence = _text(claim.get("confidence"))
381
+ claim_type = _text(claim.get("claim_type"))
382
+ return {
383
+ "source": "claim_ledger_metadata",
384
+ "support_labels": [],
385
+ "blocking": False,
386
+ "weak": confidence == "low",
387
+ "downgrade_required": False,
388
+ "inference_required": evidence_relation in {"inferred", "analogous"}
389
+ or epistemic_type in {"interpreted", "hypothesis", "analogy"}
390
+ or claim_type in {"interpretation", "forecast", "risk"},
391
+ }
392
+
393
+
394
+ def _claim_source_class(claim: Mapping[str, Any]) -> str:
395
+ metadata = claim.get("metadata") if isinstance(claim.get("metadata"), Mapping) else {}
396
+ for key in ("source_category", "underlying_evidence_type", "retrieval_source_type"):
397
+ value = _text(metadata.get(key))
398
+ if value:
399
+ return value
400
+ return _text(claim.get("source_type"))
401
+
402
+
403
+ def _matching_context(text: str, statement: str) -> str:
404
+ if not statement.strip():
405
+ return ""
406
+ target_sentences = _sentences(text)
407
+ statement_norm = _normalize_text(statement)
408
+ for sentence in target_sentences:
409
+ sentence_norm = _normalize_text(sentence)
410
+ if statement_norm and statement_norm in sentence_norm:
411
+ return sentence.strip()
412
+ statement_tokens = _tokens(statement)
413
+ if len(statement_tokens) < 4:
414
+ return ""
415
+ threshold = max(3, int(len(statement_tokens) * 0.65))
416
+ for sentence in target_sentences:
417
+ sentence_tokens = set(_tokens(sentence))
418
+ if len(statement_tokens & sentence_tokens) >= threshold:
419
+ return sentence.strip()
420
+ return ""
421
+
422
+
423
+ def _sentences(text: str) -> list[str]:
424
+ chunks = re.split(r"(?<=[.!?。!?])\s+|\n+", text)
425
+ return [chunk.strip() for chunk in chunks if chunk.strip()]
426
+
427
+
428
+ def _tokens(text: str) -> set[str]:
429
+ return set(_token_list(text))
430
+
431
+
432
+ def _normalize_text(text: str) -> str:
433
+ return " ".join(_token_list(text))
434
+
435
+
436
+ def _token_list(text: str) -> list[str]:
437
+ return [match.group(0).lower() for match in _TOKEN_RE.finditer(text)]
438
+
439
+
440
+ def _finding(
441
+ *,
442
+ finding_type: str,
443
+ severity: str,
444
+ description: str,
445
+ recommendation: str,
446
+ target_artifact: str,
447
+ claim_id: str,
448
+ evidence_ref: str,
449
+ metadata: Mapping[str, Any],
450
+ ) -> dict[str, Any]:
451
+ return {
452
+ "finding_type": finding_type,
453
+ "severity": severity,
454
+ "target_artifact": target_artifact,
455
+ "claim_id": claim_id,
456
+ "description": description,
457
+ "recommendation": recommendation,
458
+ "evidence_ref": evidence_ref,
459
+ "blocking": False,
460
+ "runtime_effect": "none",
461
+ "metadata": {
462
+ **dict(metadata),
463
+ "semantic_boundary": (
464
+ "deterministic lexical warning from recorded support/source metadata; not support truth"
465
+ ),
466
+ },
467
+ }
468
+
469
+
470
+ def _summary_counts(
471
+ findings: list[Mapping[str, Any]],
472
+ *,
473
+ present_target_count: int = 0,
474
+ unreadable_target_count: int = 0,
475
+ ) -> dict[str, int]:
476
+ counts = {
477
+ "target_count": len(_READER_TARGETS),
478
+ "present_target_count": present_target_count,
479
+ "unreadable_target_count": unreadable_target_count,
480
+ "finding_count": len(findings),
481
+ "unsupported_reader_claim_count": 0,
482
+ "weak_support_strong_wording_count": 0,
483
+ "inference_without_framing_count": 0,
484
+ "source_class_strong_wording_count": 0,
485
+ }
486
+ for finding in findings:
487
+ finding_type = _text(finding.get("finding_type"))
488
+ if finding_type == "unsupported_claim_reaches_reader":
489
+ counts["unsupported_reader_claim_count"] += 1
490
+ elif finding_type == "weak_support_strong_wording":
491
+ counts["weak_support_strong_wording_count"] += 1
492
+ elif finding_type == "inference_without_framing":
493
+ counts["inference_without_framing_count"] += 1
494
+ elif finding_type == "source_class_strong_wording":
495
+ counts["source_class_strong_wording_count"] += 1
496
+ return counts
497
+
498
+
499
+ def _recommended_actions(findings: list[Mapping[str, Any]]) -> list[dict[str, str]]:
500
+ if not findings:
501
+ return []
502
+ if any(_text(finding.get("severity")) == "human_review" for finding in findings):
503
+ return [{"action": "request_human_review", "reason": "unsupported_claim_present_in_reader_text"}]
504
+ return [{"action": "review_support_wording_warnings", "reason": "support_calibrated_wording_warning"}]
505
+
506
+
507
+ def _contains_authority_key(value: Any) -> bool:
508
+ if isinstance(value, Mapping):
509
+ for key, child in value.items():
510
+ if str(key) in _AUTHORITY_KEYS:
511
+ return True
512
+ if _contains_authority_key(child):
513
+ return True
514
+ elif isinstance(value, list):
515
+ return any(_contains_authority_key(item) for item in value)
516
+ return False
517
+
518
+
519
+ def _text(value: Any) -> str:
520
+ return value.strip() if isinstance(value, str) else ""
521
+
522
+
523
+ def _short_text(value: str, limit: int = 220) -> str:
524
+ collapsed = " ".join(value.split())
525
+ return collapsed if len(collapsed) <= limit else collapsed[: limit - 3].rstrip() + "..."