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,75 @@
1
+ schema_version: briefloop.report_template.v1
2
+ template_id: solar_industry_periodic
3
+ report_type: solar_industry_periodic
4
+ display_name: Solar Industry Periodic Template
5
+ status: experimental
6
+ section_order:
7
+ - cover
8
+ - executive_summary
9
+ - supply_chain_price_tracker
10
+ - demand_installation_outlook
11
+ - policy_tax_financing
12
+ - fx_rates_tracker
13
+ - company_implications
14
+ - source_appendix
15
+ section_aliases:
16
+ cover:
17
+ - Cover
18
+ - 封面
19
+ executive_summary:
20
+ - Executive Summary
21
+ - 执行摘要
22
+ - 核心摘要
23
+ supply_chain_price_tracker:
24
+ - Supply Chain Price Tracker
25
+ - 供应链价格跟踪
26
+ - 供应链价格追踪
27
+ demand_installation_outlook:
28
+ - Demand Installation Outlook
29
+ - Demand and Installation Outlook
30
+ - 需求与装机展望
31
+ - 中美欧需求与装机展望
32
+ policy_tax_financing:
33
+ - Policy Tax Financing
34
+ - Policy, Tax, and Financing
35
+ - 政策、税收与融资环境
36
+ - 政策税收融资
37
+ - 政策、税务与融资
38
+ - 政策税务融资
39
+ fx_rates_tracker:
40
+ - FX Rates Tracker
41
+ - Exchange Rate and Interest Rate Tracker
42
+ - 汇率与利率追踪
43
+ - 汇率利率追踪
44
+ - 汇率跟踪
45
+ - 汇率追踪
46
+ company_implications:
47
+ - Company Implications
48
+ - 对公司的启示
49
+ - 对目标公司的启示
50
+ - 公司影响
51
+ - 对公司的影响
52
+ - 对目标公司的影响
53
+ source_appendix:
54
+ - Source Appendix
55
+ - 来源附录
56
+ reader_contract:
57
+ required_blocks:
58
+ - cover
59
+ - executive_summary
60
+ - supply_chain_price_tracker
61
+ - demand_installation_outlook
62
+ - policy_tax_financing
63
+ - fx_rates_tracker
64
+ - company_implications
65
+ - source_appendix
66
+ required_table_sections:
67
+ - supply_chain_price_tracker
68
+ - fx_rates_tracker
69
+ max_executive_summary_words: 260
70
+ source_appendix_position: last
71
+ citation_profile: executive
72
+ metadata:
73
+ product_layer: report_template_registry
74
+ boundary: section_order_contract_only
75
+ dogfood_use_case: solar_industry_periodic_report
@@ -0,0 +1,180 @@
1
+ schema_version: multi-agent-brief-stage-specs/v1
2
+ workflow:
3
+ orchestrator_role: main_agent
4
+ default_policy_pack: default
5
+ stages:
6
+ - stage_id: doctor
7
+ owner: python_tool
8
+ category: environment_readiness
9
+ command: multi-agent-brief doctor --config <workspace>/config.yaml
10
+ consumes:
11
+ - config
12
+ - sources_config
13
+ produces: []
14
+ expected_artifacts: []
15
+ allowed_decisions:
16
+ - continue
17
+ - request_human_review
18
+ - block_run
19
+ - stage_id: source-discovery
20
+ owner: python_tool_or_source_planner
21
+ category: source_governance
22
+ command: multi-agent-brief sources decide --config <workspace>/config.yaml
23
+ consumes:
24
+ - config
25
+ - sources_config
26
+ - user_profile
27
+ produces:
28
+ - source_candidates
29
+ expected_artifacts:
30
+ - source_candidates
31
+ allowed_decisions:
32
+ - continue
33
+ - retry_stage
34
+ - request_human_review
35
+ - block_run
36
+ - stage_id: input-governance
37
+ owner: python_tool
38
+ category: input_governance
39
+ command: multi-agent-brief inputs extract --config <workspace>/config.yaml (when non-text inputs exist); multi-agent-brief inputs classify --config <workspace>/config.yaml
40
+ consumes:
41
+ - workspace_input
42
+ produces:
43
+ - input_classification
44
+ expected_artifacts:
45
+ - input_classification
46
+ allowed_decisions:
47
+ - continue
48
+ - retry_stage
49
+ - request_human_review
50
+ - block_run
51
+ - stage_id: scout
52
+ owner: scout
53
+ category: source_extraction
54
+ consumes:
55
+ - workspace_sources
56
+ - input_classification
57
+ produces:
58
+ - candidate_claims
59
+ expected_artifacts:
60
+ - candidate_claims
61
+ allowed_decisions:
62
+ - continue
63
+ - retry_stage
64
+ - request_human_review
65
+ - block_run
66
+ - stage_id: screener
67
+ owner: screener
68
+ category: candidate_screening
69
+ topology_satisfaction:
70
+ default:
71
+ satisfied_by: scout
72
+ required_artifacts:
73
+ - candidate_claims
74
+ - screened_candidates
75
+ human_assisted:
76
+ satisfied_by: scout
77
+ required_artifacts:
78
+ - candidate_claims
79
+ - screened_candidates
80
+ consumes:
81
+ - candidate_claims
82
+ produces:
83
+ - screened_candidates
84
+ expected_artifacts:
85
+ - screened_candidates
86
+ allowed_decisions:
87
+ - continue
88
+ - retry_stage
89
+ - request_human_review
90
+ - block_run
91
+ - stage_id: claim-ledger
92
+ owner: claim-ledger
93
+ category: claim_grounding
94
+ consumes:
95
+ - screened_candidates
96
+ produces:
97
+ - claim_ledger
98
+ expected_artifacts:
99
+ - claim_ledger
100
+ allowed_decisions:
101
+ - continue
102
+ - retry_stage
103
+ - request_human_review
104
+ - block_run
105
+ - stage_id: analyst
106
+ owner: analyst
107
+ category: drafting
108
+ topology_satisfaction:
109
+ human_assisted:
110
+ satisfied_by: writer
111
+ required_artifacts:
112
+ - audited_brief
113
+ consumes:
114
+ - claim_ledger
115
+ - user_profile
116
+ - input_classification
117
+ produces:
118
+ - analyst_draft_snapshot
119
+ expected_artifacts:
120
+ - analyst_draft_snapshot
121
+ allowed_decisions:
122
+ - continue
123
+ - retry_stage
124
+ - delegate_repair
125
+ - request_human_review
126
+ - block_run
127
+ - stage_id: editor
128
+ owner: editor
129
+ category: editorial_refinement
130
+ topology_satisfaction:
131
+ human_assisted:
132
+ satisfied_by: writer
133
+ required_artifacts:
134
+ - audited_brief
135
+ consumes:
136
+ - analyst_draft_snapshot
137
+ - claim_ledger
138
+ - user_profile
139
+ - input_classification
140
+ produces:
141
+ - audited_brief
142
+ expected_artifacts:
143
+ - audited_brief
144
+ allowed_decisions:
145
+ - continue
146
+ - retry_stage
147
+ - delegate_repair
148
+ - request_human_review
149
+ - block_run
150
+ - stage_id: auditor
151
+ owner: auditor
152
+ category: audit
153
+ consumes:
154
+ - audited_brief
155
+ - claim_ledger
156
+ produces:
157
+ - audit_report
158
+ expected_artifacts:
159
+ - audit_report
160
+ allowed_decisions:
161
+ - continue
162
+ - retry_stage
163
+ - delegate_repair
164
+ - request_human_review
165
+ - block_run
166
+ - stage_id: finalize
167
+ owner: python_tool
168
+ category: reader_output
169
+ command: multi-agent-brief finalize --config <workspace>/config.yaml
170
+ consumes:
171
+ - audited_brief
172
+ - audit_report
173
+ produces:
174
+ - reader_brief
175
+ expected_artifacts:
176
+ - reader_brief
177
+ allowed_decisions:
178
+ - finalize
179
+ - request_human_review
180
+ - block_run
@@ -0,0 +1,41 @@
1
+ """Contracts package — schema definitions, validators, and migrations."""
2
+
3
+ from multi_agent_brief.contracts.base import Contract, SchemaRegistry
4
+ from multi_agent_brief.contracts.errors import ContractError, FieldViolation
5
+ from multi_agent_brief.contracts.registry import (
6
+ ArtifactContract,
7
+ ContractRegistry,
8
+ StageSpec,
9
+ )
10
+ from multi_agent_brief.contracts.schemas import (
11
+ AuditReportContract,
12
+ AtomicClaimGraphContract,
13
+ CandidateItemContract,
14
+ ClaimDraftContract,
15
+ ClaimContract,
16
+ EvidenceSpanRegistryContract,
17
+ ReportSpecContract,
18
+ SourceEvidencePackManifestContract,
19
+ SourceItemContract,
20
+ )
21
+ from multi_agent_brief.contracts.migrations import migrate_claim_v1_to_v2
22
+
23
+ __all__ = [
24
+ "Contract",
25
+ "SchemaRegistry",
26
+ "ContractError",
27
+ "FieldViolation",
28
+ "ArtifactContract",
29
+ "ContractRegistry",
30
+ "StageSpec",
31
+ "AuditReportContract",
32
+ "AtomicClaimGraphContract",
33
+ "CandidateItemContract",
34
+ "ClaimDraftContract",
35
+ "ClaimContract",
36
+ "EvidenceSpanRegistryContract",
37
+ "ReportSpecContract",
38
+ "SourceEvidencePackManifestContract",
39
+ "SourceItemContract",
40
+ "migrate_claim_v1_to_v2",
41
+ ]
@@ -0,0 +1,99 @@
1
+ """Base contract class and schema registry."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from abc import ABC, abstractmethod
6
+ from typing import Any, ClassVar
7
+
8
+ from multi_agent_brief.contracts.errors import ContractError, FieldViolation
9
+
10
+
11
+ class Contract(ABC):
12
+ """Base class for schema contracts.
13
+
14
+ Subclasses define:
15
+ - schema_id: unique identifier (e.g. "source_item", "claim")
16
+ - schema_version: current version (e.g. "v1")
17
+ - json_schema(): return the JSON Schema dict
18
+ - validate(): return list of FieldViolation (empty = valid)
19
+ - migrate(): transform data from an older version
20
+ """
21
+
22
+ schema_id: ClassVar[str]
23
+ schema_version: ClassVar[str]
24
+
25
+ @classmethod
26
+ @abstractmethod
27
+ def json_schema(cls) -> dict[str, Any]:
28
+ """Return the JSON Schema for this contract."""
29
+
30
+ @classmethod
31
+ @abstractmethod
32
+ def validate(cls, data: dict[str, Any]) -> list[FieldViolation]:
33
+ """Validate data against this contract. Returns violations (empty = valid)."""
34
+
35
+ @classmethod
36
+ @abstractmethod
37
+ def migrate(cls, data: dict[str, Any], from_version: str) -> dict[str, Any]:
38
+ """Migrate data from an older schema version to the current version."""
39
+
40
+ @classmethod
41
+ def validate_or_raise(cls, data: dict[str, Any]) -> None:
42
+ """Validate and raise ContractError if violations found."""
43
+ violations = cls.validate(data)
44
+ errors = [v for v in violations if v.severity == "error"]
45
+ if errors:
46
+ raise ContractError(
47
+ violations=violations,
48
+ schema_id=cls.schema_id,
49
+ schema_version=cls.schema_version,
50
+ )
51
+
52
+ @classmethod
53
+ def is_valid(cls, data: dict[str, Any]) -> bool:
54
+ """Return True if data passes validation (no error-level violations)."""
55
+ violations = cls.validate(data)
56
+ return not any(v.severity == "error" for v in violations)
57
+
58
+
59
+ class SchemaRegistry:
60
+ """Central registry mapping schema_id to Contract class."""
61
+
62
+ _registry: ClassVar[dict[str, type[Contract]]] = {}
63
+
64
+ @classmethod
65
+ def register(cls, contract_cls: type[Contract]) -> type[Contract]:
66
+ """Register a contract class. Returns the class for use as decorator."""
67
+ cls._registry[contract_cls.schema_id] = contract_cls
68
+ return contract_cls
69
+
70
+ @classmethod
71
+ def get(cls, schema_id: str) -> type[Contract] | None:
72
+ """Get a registered contract class by schema_id."""
73
+ return cls._registry.get(schema_id)
74
+
75
+ @classmethod
76
+ def all_ids(cls) -> list[str]:
77
+ """Return all registered schema IDs."""
78
+ return sorted(cls._registry.keys())
79
+
80
+ @classmethod
81
+ def validate(cls, schema_id: str, data: dict[str, Any]) -> list[FieldViolation]:
82
+ """Validate data against a registered schema. Raises KeyError if unknown."""
83
+ contract = cls._registry.get(schema_id)
84
+ if contract is None:
85
+ raise KeyError(f"Unknown schema: {schema_id}")
86
+ return contract.validate(data)
87
+
88
+ @classmethod
89
+ def validate_or_raise(cls, schema_id: str, data: dict[str, Any]) -> None:
90
+ """Validate or raise ContractError."""
91
+ contract = cls._registry.get(schema_id)
92
+ if contract is None:
93
+ raise KeyError(f"Unknown schema: {schema_id}")
94
+ contract.validate_or_raise(data)
95
+
96
+ @classmethod
97
+ def clear(cls) -> None:
98
+ """Clear all registered contracts (for testing)."""
99
+ cls._registry.clear()
@@ -0,0 +1,41 @@
1
+ """Contract validation errors."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from dataclasses import dataclass, field
6
+
7
+
8
+ @dataclass
9
+ class FieldViolation:
10
+ """A single validation failure on a specific field."""
11
+
12
+ field: str
13
+ error: str
14
+ severity: str = "error" # "error" | "warning"
15
+
16
+ def __str__(self) -> str:
17
+ return f"[{self.severity}] {self.field}: {self.error}"
18
+
19
+
20
+ class ContractError(Exception):
21
+ """Raised when contract validation fails with one or more violations."""
22
+
23
+ def __init__(
24
+ self,
25
+ violations: list[FieldViolation],
26
+ schema_id: str = "",
27
+ schema_version: str = "",
28
+ ) -> None:
29
+ self.violations = violations
30
+ self.schema_id = schema_id
31
+ self.schema_version = schema_version
32
+ msg = f"Contract '{schema_id}' v{schema_version} failed with {len(violations)} violation(s)"
33
+ super().__init__(msg)
34
+
35
+ @property
36
+ def error_count(self) -> int:
37
+ return sum(1 for v in self.violations if v.severity == "error")
38
+
39
+ @property
40
+ def warning_count(self) -> int:
41
+ return sum(1 for v in self.violations if v.severity == "warning")
@@ -0,0 +1,5 @@
1
+ """Schema migrations."""
2
+
3
+ from multi_agent_brief.contracts.migrations.claim_v1_to_v2 import migrate_claim_v1_to_v2
4
+
5
+ __all__ = ["migrate_claim_v1_to_v2"]
@@ -0,0 +1,33 @@
1
+ """Claim v1 → v2 migration: adds epistemic fields from claim_type."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any
6
+
7
+
8
+ # Mapping from old claim_type to new epistemic_type
9
+ _CLAIM_TYPE_TO_EPISTEMIC: dict[str, str] = {
10
+ "interpretation": "interpreted",
11
+ "forecast": "hypothesis",
12
+ "risk": "hypothesis",
13
+ }
14
+
15
+ # Types that are direct observations
16
+ _OBSERVED_TYPES = {"fact", "number", "date"}
17
+
18
+
19
+ def migrate_claim_v1_to_v2(data: dict[str, Any]) -> dict[str, Any]:
20
+ """Migrate a v1 claim dict to v2 by adding epistemic fields.
21
+
22
+ Does not mutate the input dict.
23
+ """
24
+ result = dict(data)
25
+
26
+ claim_type = result.get("claim_type", "fact")
27
+ result["epistemic_type"] = _CLAIM_TYPE_TO_EPISTEMIC.get(claim_type, "observed")
28
+ result["evidence_relation"] = result.get("evidence_relation", "direct")
29
+ result["applicability_reason"] = result.get("applicability_reason", "")
30
+ result["limitations"] = result.get("limitations", [])
31
+ result["schema_version"] = "v2"
32
+
33
+ return result
@@ -0,0 +1,159 @@
1
+ """Read-only registry for MABW orchestration YAML contracts."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from dataclasses import dataclass
6
+ from importlib.resources import files
7
+ from pathlib import Path
8
+ from typing import Any
9
+
10
+ import yaml
11
+
12
+
13
+ @dataclass(frozen=True)
14
+ class StageSpec:
15
+ """A stage entry from configs/stage_specs.yaml."""
16
+
17
+ stage_id: str
18
+ owner: str
19
+ category: str
20
+ command: str
21
+ consumes: tuple[str, ...]
22
+ produces: tuple[str, ...]
23
+ expected_artifacts: tuple[str, ...]
24
+ allowed_decisions: tuple[str, ...]
25
+
26
+ @classmethod
27
+ def from_mapping(cls, data: dict[str, Any]) -> "StageSpec":
28
+ return cls(
29
+ stage_id=str(data.get("stage_id", "")),
30
+ owner=str(data.get("owner", "")),
31
+ category=str(data.get("category", "")),
32
+ command=str(data.get("command", "")),
33
+ consumes=tuple(str(item) for item in data.get("consumes", []) or []),
34
+ produces=tuple(str(item) for item in data.get("produces", []) or []),
35
+ expected_artifacts=tuple(
36
+ str(item) for item in data.get("expected_artifacts", []) or []
37
+ ),
38
+ allowed_decisions=tuple(
39
+ str(item) for item in data.get("allowed_decisions", []) or []
40
+ ),
41
+ )
42
+
43
+
44
+ @dataclass(frozen=True)
45
+ class ArtifactContract:
46
+ """An artifact entry from configs/artifact_contracts.yaml."""
47
+
48
+ artifact_id: str
49
+ path: str
50
+ format: str
51
+ required: bool
52
+ producer_stage: str
53
+ producer_role: str
54
+ producer_kind: str
55
+ consumer_stages: tuple[str, ...]
56
+ validation_result: str
57
+ allowed_decisions: tuple[str, ...]
58
+
59
+ @classmethod
60
+ def from_mapping(cls, data: dict[str, Any]) -> "ArtifactContract":
61
+ return cls(
62
+ artifact_id=str(data.get("artifact_id", "")),
63
+ path=str(data.get("path", "")),
64
+ format=str(data.get("format", "")),
65
+ required=bool(data.get("required", False)),
66
+ producer_stage=str(data.get("producer_stage", "")),
67
+ producer_role=str(data.get("producer_role", "")),
68
+ producer_kind=str(data.get("producer_kind", "workflow_stage")),
69
+ consumer_stages=tuple(
70
+ str(item) for item in data.get("consumer_stages", []) or []
71
+ ),
72
+ validation_result=str(data.get("validation_result", "")),
73
+ allowed_decisions=tuple(
74
+ str(item) for item in data.get("allowed_decisions", []) or []
75
+ ),
76
+ )
77
+
78
+
79
+ @dataclass(frozen=True)
80
+ class ContractRegistry:
81
+ """Typed, read-only view over current contract YAML files."""
82
+
83
+ config_dir: Path
84
+ stage_specs_data: dict[str, Any]
85
+ artifact_contracts_data: dict[str, Any]
86
+ orchestrator_contract_data: dict[str, Any]
87
+ policy_pack_data: dict[str, Any]
88
+ stages: tuple[StageSpec, ...]
89
+ artifacts: tuple[ArtifactContract, ...]
90
+ decision_vocabulary: tuple[str, ...]
91
+ producer_kind_values: tuple[str, ...]
92
+
93
+ @classmethod
94
+ def from_config_dir(cls, config_dir: str | Path) -> "ContractRegistry":
95
+ base = Path(config_dir)
96
+ stage_specs = _load_yaml(base / "stage_specs.yaml")
97
+ artifact_contracts = _load_yaml(base / "artifact_contracts.yaml")
98
+ orchestrator_contract = _load_yaml(base / "orchestrator_contract.yaml")
99
+ policy_pack = _load_yaml(base / "policy_packs" / "default.yaml")
100
+
101
+ stages = tuple(
102
+ StageSpec.from_mapping(item)
103
+ for item in (stage_specs.get("workflow", {}) or {}).get("stages", []) or []
104
+ )
105
+ artifacts = tuple(
106
+ ArtifactContract.from_mapping(item)
107
+ for item in artifact_contracts.get("artifacts", []) or []
108
+ )
109
+ decision_vocabulary = tuple(
110
+ str(item) for item in orchestrator_contract.get("decision_vocabulary", []) or []
111
+ )
112
+ producer_kind_values = tuple(
113
+ str(item)
114
+ for item in (
115
+ artifact_contracts.get("artifact_contract", {}) or {}
116
+ ).get("producer_kind_values", []) or []
117
+ )
118
+ return cls(
119
+ config_dir=base,
120
+ stage_specs_data=stage_specs,
121
+ artifact_contracts_data=artifact_contracts,
122
+ orchestrator_contract_data=orchestrator_contract,
123
+ policy_pack_data=policy_pack,
124
+ stages=stages,
125
+ artifacts=artifacts,
126
+ decision_vocabulary=decision_vocabulary,
127
+ producer_kind_values=producer_kind_values,
128
+ )
129
+
130
+ @classmethod
131
+ def from_package(cls) -> "ContractRegistry":
132
+ config_dir = files("multi_agent_brief").joinpath("configs")
133
+ return cls.from_config_dir(Path(str(config_dir)))
134
+
135
+ def stage_ids(self) -> set[str]:
136
+ return {stage.stage_id for stage in self.stages}
137
+
138
+ def artifact_ids(self) -> set[str]:
139
+ return {artifact.artifact_id for artifact in self.artifacts}
140
+
141
+ def stage(self, stage_id: str) -> StageSpec | None:
142
+ return next((stage for stage in self.stages if stage.stage_id == stage_id), None)
143
+
144
+ def artifact(self, artifact_id: str) -> ArtifactContract | None:
145
+ return next(
146
+ (artifact for artifact in self.artifacts if artifact.artifact_id == artifact_id),
147
+ None,
148
+ )
149
+
150
+
151
+ def _load_yaml(path: Path) -> dict[str, Any]:
152
+ try:
153
+ data = yaml.safe_load(path.read_text(encoding="utf-8"))
154
+ except FileNotFoundError:
155
+ return {}
156
+ if not isinstance(data, dict):
157
+ return {}
158
+ return data
159
+
@@ -0,0 +1,25 @@
1
+ """Role-topology contract vocabulary."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from typing import Any
6
+
7
+
8
+ ROLE_TOPOLOGY_DEFAULT = "default"
9
+ ROLE_TOPOLOGY_VALUES = frozenset({"default", "strict", "human_assisted"})
10
+ ROLE_TOPOLOGY_SATISFIER_VALUES = frozenset({"scout", "writer"})
11
+
12
+
13
+ def resolve_role_topology(policy_pack: dict[str, Any] | None) -> str:
14
+ """Return the selected role topology, defaulting missing legacy packs."""
15
+
16
+ policy = policy_pack.get("policy") if isinstance(policy_pack, dict) else None
17
+ if not isinstance(policy, dict) or "role_topology" not in policy:
18
+ return ROLE_TOPOLOGY_DEFAULT
19
+ value = str(policy.get("role_topology") or "").strip()
20
+ if value not in ROLE_TOPOLOGY_VALUES:
21
+ raise ValueError(
22
+ "policy.role_topology must be one of: "
23
+ + ", ".join(sorted(ROLE_TOPOLOGY_VALUES))
24
+ )
25
+ return value
@@ -0,0 +1,35 @@
1
+ """Contract schemas for core data objects."""
2
+
3
+ from multi_agent_brief.contracts.schemas.analysis_pack import (
4
+ AnalysisCardContract,
5
+ MarketEventContract,
6
+ )
7
+ from multi_agent_brief.contracts.schemas.atomic_claim_graph import AtomicClaimGraphContract
8
+ from multi_agent_brief.contracts.schemas.audit_report import AuditReportContract
9
+ from multi_agent_brief.contracts.schemas.candidate_item import CandidateItemContract
10
+ from multi_agent_brief.contracts.schemas.claim_draft import ClaimDraftContract
11
+ from multi_agent_brief.contracts.schemas.claim import ClaimContract
12
+ from multi_agent_brief.contracts.schemas.claim_support_matrix import ClaimSupportMatrixContract
13
+ from multi_agent_brief.contracts.schemas.source_item import SourceItemContract
14
+ from multi_agent_brief.contracts.schemas.evidence_span_registry import EvidenceSpanRegistryContract
15
+ from multi_agent_brief.contracts.schemas.policy_profile import PolicyProfileContract
16
+ from multi_agent_brief.contracts.schemas.report_spec import ReportSpecContract
17
+ from multi_agent_brief.contracts.schemas.semantic_assessment_report import SemanticAssessmentReportContract
18
+ from multi_agent_brief.contracts.schemas.source_evidence_pack_manifest import SourceEvidencePackManifestContract
19
+
20
+ __all__ = [
21
+ "AnalysisCardContract",
22
+ "AtomicClaimGraphContract",
23
+ "AuditReportContract",
24
+ "CandidateItemContract",
25
+ "ClaimDraftContract",
26
+ "ClaimContract",
27
+ "ClaimSupportMatrixContract",
28
+ "EvidenceSpanRegistryContract",
29
+ "MarketEventContract",
30
+ "PolicyProfileContract",
31
+ "ReportSpecContract",
32
+ "SemanticAssessmentReportContract",
33
+ "SourceEvidencePackManifestContract",
34
+ "SourceItemContract",
35
+ ]