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,247 @@
1
+ """Contract for experimental product-layer PolicyProfile files."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import re
6
+ from typing import Any, ClassVar
7
+
8
+ from multi_agent_brief.contracts.base import Contract, SchemaRegistry
9
+ from multi_agent_brief.contracts.errors import FieldViolation
10
+
11
+ POLICY_PROFILE_SCHEMA_VERSION = "briefloop.policy_profile.v1"
12
+ POLICY_PROFILE_ID_RE = re.compile(r"^[a-z][a-z0-9_]*$")
13
+
14
+ VALID_GATE_POLICY_LEVELS = {"standard", "strict"}
15
+ REQUIRED_SOURCE_POLICY_KEYS = (
16
+ "freshness_days_by_tier",
17
+ "preferred_source_tiers",
18
+ "discouraged_source_tiers",
19
+ )
20
+ REQUIRED_GATE_POLICY_KEYS = ("freshness", "material_fact", "target_relevance")
21
+ POLICY_PROFILE_BOUNDARY = "experimental_policy_profile_only"
22
+
23
+
24
+ @SchemaRegistry.register
25
+ class PolicyProfileContract(Contract):
26
+ """Validate product-layer policy profiles.
27
+
28
+ PolicyProfile records deterministic product defaults only. It does not
29
+ change runtime stage behavior, adapt gates, judge compliance, or authorize
30
+ release.
31
+ """
32
+
33
+ schema_id: ClassVar[str] = "policy_profile"
34
+ schema_version: ClassVar[str] = "v1"
35
+
36
+ @classmethod
37
+ def json_schema(cls) -> dict[str, Any]:
38
+ return {
39
+ "type": "object",
40
+ "required": [
41
+ "schema_version",
42
+ "policy_profile_id",
43
+ "industry",
44
+ "source_policy",
45
+ "claim_policy",
46
+ "wording_policy",
47
+ "gate_policy",
48
+ "metadata",
49
+ ],
50
+ "properties": {
51
+ "schema_version": {"type": "string", "enum": [POLICY_PROFILE_SCHEMA_VERSION]},
52
+ "policy_profile_id": {"type": "string", "pattern": POLICY_PROFILE_ID_RE.pattern},
53
+ "industry": {"type": "string"},
54
+ "source_policy": {
55
+ "type": "object",
56
+ "required": list(REQUIRED_SOURCE_POLICY_KEYS),
57
+ "properties": {
58
+ "freshness_days_by_tier": {
59
+ "type": "object",
60
+ "additionalProperties": {"type": "integer", "minimum": 1},
61
+ },
62
+ "preferred_source_tiers": {"type": "array", "items": {"type": "string"}},
63
+ "discouraged_source_tiers": {"type": "array", "items": {"type": "string"}},
64
+ },
65
+ "additionalProperties": True,
66
+ },
67
+ "claim_policy": {
68
+ "type": "object",
69
+ "required": ["materiality_terms"],
70
+ "properties": {
71
+ "materiality_terms": {"type": "array", "items": {"type": "string"}},
72
+ },
73
+ "additionalProperties": True,
74
+ },
75
+ "wording_policy": {
76
+ "type": "object",
77
+ "required": ["forbidden_phrases"],
78
+ "properties": {
79
+ "forbidden_phrases": {"type": "array", "items": {"type": "string"}},
80
+ },
81
+ "additionalProperties": True,
82
+ },
83
+ "gate_policy": {
84
+ "type": "object",
85
+ "required": list(REQUIRED_GATE_POLICY_KEYS),
86
+ "properties": {
87
+ key: {"type": "string", "enum": sorted(VALID_GATE_POLICY_LEVELS)}
88
+ for key in REQUIRED_GATE_POLICY_KEYS
89
+ },
90
+ "additionalProperties": True,
91
+ },
92
+ "metadata": {
93
+ "type": "object",
94
+ "required": ["boundary"],
95
+ "properties": {"boundary": {"type": "string", "enum": [POLICY_PROFILE_BOUNDARY]}},
96
+ "additionalProperties": True,
97
+ },
98
+ },
99
+ "additionalProperties": True,
100
+ }
101
+
102
+ @classmethod
103
+ def validate(cls, data: dict[str, Any]) -> list[FieldViolation]:
104
+ if not isinstance(data, dict):
105
+ return [FieldViolation(field="<root>", error="must be an object")]
106
+
107
+ violations: list[FieldViolation] = []
108
+ schema_version = data.get("schema_version")
109
+ if schema_version != POLICY_PROFILE_SCHEMA_VERSION:
110
+ violations.append(
111
+ FieldViolation(field="schema_version", error=f"must be {POLICY_PROFILE_SCHEMA_VERSION}")
112
+ )
113
+
114
+ profile_id = data.get("policy_profile_id")
115
+ if not _non_empty_string(profile_id):
116
+ violations.append(FieldViolation(field="policy_profile_id", error="required field is missing or blank"))
117
+ elif not POLICY_PROFILE_ID_RE.match(str(profile_id).strip()):
118
+ violations.append(FieldViolation(field="policy_profile_id", error="must match ^[a-z][a-z0-9_]*$"))
119
+
120
+ if not _non_empty_string(data.get("industry")):
121
+ violations.append(FieldViolation(field="industry", error="required field is missing or blank"))
122
+
123
+ source_policy = data.get("source_policy")
124
+ if not isinstance(source_policy, dict):
125
+ violations.append(FieldViolation(field="source_policy", error="must be an object"))
126
+ else:
127
+ violations.extend(_validate_source_policy(source_policy))
128
+
129
+ claim_policy = data.get("claim_policy")
130
+ if not isinstance(claim_policy, dict):
131
+ violations.append(FieldViolation(field="claim_policy", error="must be an object"))
132
+ else:
133
+ violations.extend(
134
+ _validate_string_list(
135
+ claim_policy.get("materiality_terms"),
136
+ field="claim_policy.materiality_terms",
137
+ allow_empty=False,
138
+ )
139
+ )
140
+
141
+ wording_policy = data.get("wording_policy")
142
+ if not isinstance(wording_policy, dict):
143
+ violations.append(FieldViolation(field="wording_policy", error="must be an object"))
144
+ else:
145
+ violations.extend(
146
+ _validate_string_list(
147
+ wording_policy.get("forbidden_phrases"),
148
+ field="wording_policy.forbidden_phrases",
149
+ allow_empty=False,
150
+ )
151
+ )
152
+
153
+ gate_policy = data.get("gate_policy")
154
+ if not isinstance(gate_policy, dict):
155
+ violations.append(FieldViolation(field="gate_policy", error="must be an object"))
156
+ else:
157
+ for key in REQUIRED_GATE_POLICY_KEYS:
158
+ value = gate_policy.get(key)
159
+ if value not in VALID_GATE_POLICY_LEVELS:
160
+ violations.append(
161
+ FieldViolation(
162
+ field=f"gate_policy.{key}",
163
+ error=f"must be one of {', '.join(sorted(VALID_GATE_POLICY_LEVELS))}",
164
+ )
165
+ )
166
+
167
+ metadata = data.get("metadata")
168
+ if not isinstance(metadata, dict):
169
+ violations.append(FieldViolation(field="metadata", error="must be an object"))
170
+ elif metadata.get("boundary") != POLICY_PROFILE_BOUNDARY:
171
+ violations.append(
172
+ FieldViolation(field="metadata.boundary", error=f"must be {POLICY_PROFILE_BOUNDARY}")
173
+ )
174
+
175
+ return violations
176
+
177
+ @classmethod
178
+ def migrate(cls, data: dict[str, Any], from_version: str) -> dict[str, Any]:
179
+ return dict(data)
180
+
181
+
182
+ def _validate_source_policy(source_policy: dict[str, Any]) -> list[FieldViolation]:
183
+ violations: list[FieldViolation] = []
184
+ if "tier_weights" in source_policy:
185
+ violations.append(FieldViolation(field="source_policy.tier_weights", error="not supported"))
186
+
187
+ freshness = source_policy.get("freshness_days_by_tier")
188
+ if not isinstance(freshness, dict) or not freshness:
189
+ violations.append(FieldViolation(field="source_policy.freshness_days_by_tier", error="must be a non-empty object"))
190
+ else:
191
+ for tier, days in freshness.items():
192
+ if not _non_empty_string(tier) or not POLICY_PROFILE_ID_RE.match(str(tier).strip()):
193
+ violations.append(
194
+ FieldViolation(field=f"source_policy.freshness_days_by_tier.{tier}", error="tier must be stable id")
195
+ )
196
+ if type(days) is not int or days <= 0:
197
+ violations.append(
198
+ FieldViolation(field=f"source_policy.freshness_days_by_tier.{tier}", error="days must be positive integer")
199
+ )
200
+
201
+ preferred_errors = _validate_string_list(
202
+ source_policy.get("preferred_source_tiers"),
203
+ field="source_policy.preferred_source_tiers",
204
+ allow_empty=False,
205
+ )
206
+ discouraged_errors = _validate_string_list(
207
+ source_policy.get("discouraged_source_tiers"),
208
+ field="source_policy.discouraged_source_tiers",
209
+ allow_empty=True,
210
+ )
211
+ violations.extend(preferred_errors)
212
+ violations.extend(discouraged_errors)
213
+
214
+ if not preferred_errors and not discouraged_errors:
215
+ preferred = {item.strip() for item in source_policy.get("preferred_source_tiers", []) if isinstance(item, str)}
216
+ discouraged = {item.strip() for item in source_policy.get("discouraged_source_tiers", []) if isinstance(item, str)}
217
+ overlap = sorted(preferred & discouraged)
218
+ if overlap:
219
+ violations.append(
220
+ FieldViolation(
221
+ field="source_policy.discouraged_source_tiers",
222
+ error=f"must not overlap preferred_source_tiers:{','.join(overlap)}",
223
+ )
224
+ )
225
+ return violations
226
+
227
+
228
+ def _validate_string_list(value: Any, *, field: str, allow_empty: bool) -> list[FieldViolation]:
229
+ violations: list[FieldViolation] = []
230
+ if not isinstance(value, list):
231
+ return [FieldViolation(field=field, error="must be a list")]
232
+ if not allow_empty and not value:
233
+ violations.append(FieldViolation(field=field, error="must be non-empty"))
234
+ seen: set[str] = set()
235
+ for idx, item in enumerate(value):
236
+ if not _non_empty_string(item):
237
+ violations.append(FieldViolation(field=f"{field}[{idx}]", error="must be a non-empty string"))
238
+ continue
239
+ normalized = item.strip()
240
+ if normalized in seen:
241
+ violations.append(FieldViolation(field=f"{field}[{idx}]", error=f"duplicate value:{normalized}"))
242
+ seen.add(normalized)
243
+ return violations
244
+
245
+
246
+ def _non_empty_string(value: Any) -> bool:
247
+ return isinstance(value, str) and bool(value.strip())
@@ -0,0 +1,257 @@
1
+ """Contract for experimental product-layer ReportSpec files."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import re
6
+ from typing import Any, ClassVar
7
+
8
+ from multi_agent_brief.contracts.base import Contract, SchemaRegistry
9
+ from multi_agent_brief.contracts.errors import FieldViolation
10
+ from multi_agent_brief.contracts.schemas.policy_profile import POLICY_PROFILE_ID_RE
11
+
12
+ REPORT_SPEC_SCHEMA_VERSION = "briefloop.report_spec.v1"
13
+ REPORT_PACK_ID_RE = re.compile(r"^[a-z][a-z0-9_]*$")
14
+
15
+ REQUIRED_CONTROL_SPINE_KEYS = (
16
+ "claim_ledger",
17
+ "artifact_registry",
18
+ "quality_gates",
19
+ "event_log",
20
+ "archive",
21
+ "source_appendix",
22
+ "support_records",
23
+ "human_delivery_approval",
24
+ "frozen_artifact_integrity",
25
+ )
26
+
27
+ VALID_SOURCE_POLICY_MODES = {"local_first", "explicit_sources", "runtime_handoff"}
28
+ VALID_POLICY_PROFILE_RESOLUTION_SOURCES = {
29
+ "explicit_override",
30
+ "industry_resolver",
31
+ "report_pack.default_policy_profile",
32
+ }
33
+
34
+
35
+ @SchemaRegistry.register
36
+ class ReportSpecContract(Contract):
37
+ """Validate product-layer report specifications.
38
+
39
+ ReportSpec is a product contract over the existing control spine. It does
40
+ not create workspaces, run stages, render templates, or authorize delivery.
41
+ """
42
+
43
+ schema_id: ClassVar[str] = "report_spec"
44
+ schema_version: ClassVar[str] = "v1"
45
+
46
+ @classmethod
47
+ def json_schema(cls) -> dict[str, Any]:
48
+ return {
49
+ "type": "object",
50
+ "required": [
51
+ "schema_version",
52
+ "report_pack",
53
+ "report_type",
54
+ "title",
55
+ "audience",
56
+ "source_policy",
57
+ "control_spine",
58
+ ],
59
+ "properties": {
60
+ "schema_version": {"type": "string", "enum": [REPORT_SPEC_SCHEMA_VERSION]},
61
+ "report_pack": {"type": "string", "pattern": REPORT_PACK_ID_RE.pattern},
62
+ "policy_profile": {"type": "string", "pattern": POLICY_PROFILE_ID_RE.pattern},
63
+ "policy_profile_resolution": {
64
+ "type": "object",
65
+ "required": ["policy_profile", "source", "confidence"],
66
+ "properties": {
67
+ "policy_profile": {"type": "string", "pattern": POLICY_PROFILE_ID_RE.pattern},
68
+ "source": {
69
+ "type": "string",
70
+ "enum": sorted(VALID_POLICY_PROFILE_RESOLUTION_SOURCES),
71
+ },
72
+ "input": {"type": "string"},
73
+ "matched_rule": {"type": "string"},
74
+ "confidence": {"type": "string"},
75
+ "alternatives": {"type": "array", "items": {"type": "string"}},
76
+ },
77
+ "additionalProperties": True,
78
+ },
79
+ "report_type": {"type": "string", "pattern": REPORT_PACK_ID_RE.pattern},
80
+ "title": {"type": "string"},
81
+ "audience": {
82
+ "type": "object",
83
+ "required": ["label", "language"],
84
+ "properties": {
85
+ "label": {"type": "string"},
86
+ "language": {"type": "string"},
87
+ },
88
+ "additionalProperties": True,
89
+ },
90
+ "cadence": {"type": "string"},
91
+ "source_policy": {
92
+ "type": "object",
93
+ "required": ["mode", "hidden_autonomous_crawling"],
94
+ "properties": {
95
+ "mode": {"type": "string", "enum": sorted(VALID_SOURCE_POLICY_MODES)},
96
+ "hidden_autonomous_crawling": {"type": "boolean", "const": False},
97
+ },
98
+ "additionalProperties": True,
99
+ },
100
+ "control_spine": {
101
+ "type": "object",
102
+ "required": list(REQUIRED_CONTROL_SPINE_KEYS),
103
+ "properties": {
104
+ key: {"type": "boolean", "const": True}
105
+ for key in REQUIRED_CONTROL_SPINE_KEYS
106
+ },
107
+ "additionalProperties": True,
108
+ },
109
+ "outputs": {"type": "array", "items": {"type": "string"}},
110
+ "metadata": {"type": "object"},
111
+ },
112
+ "additionalProperties": True,
113
+ }
114
+
115
+ @classmethod
116
+ def validate(cls, data: dict[str, Any]) -> list[FieldViolation]:
117
+ if not isinstance(data, dict):
118
+ return [FieldViolation(field="<root>", error="must be an object")]
119
+
120
+ violations: list[FieldViolation] = []
121
+ schema_version = data.get("schema_version")
122
+ if not _non_empty_string(schema_version):
123
+ violations.append(FieldViolation(field="schema_version", error="required field is missing"))
124
+ elif schema_version != REPORT_SPEC_SCHEMA_VERSION:
125
+ violations.append(
126
+ FieldViolation(field="schema_version", error=f"must be {REPORT_SPEC_SCHEMA_VERSION}")
127
+ )
128
+
129
+ for field in ("report_pack", "report_type", "title"):
130
+ value = data.get(field)
131
+ if not _non_empty_string(value):
132
+ violations.append(FieldViolation(field=field, error="required field is missing or blank"))
133
+ elif field in {"report_pack", "report_type"} and not REPORT_PACK_ID_RE.match(str(value).strip()):
134
+ violations.append(FieldViolation(field=field, error="must match ^[a-z][a-z0-9_]*$"))
135
+
136
+ policy_profile = data.get("policy_profile")
137
+ if policy_profile is not None:
138
+ if not _non_empty_string(policy_profile):
139
+ violations.append(FieldViolation(field="policy_profile", error="must be a non-empty string"))
140
+ elif not POLICY_PROFILE_ID_RE.match(str(policy_profile).strip()):
141
+ violations.append(FieldViolation(field="policy_profile", error="must match ^[a-z][a-z0-9_]*$"))
142
+
143
+ resolution = data.get("policy_profile_resolution")
144
+ if resolution is not None:
145
+ if not isinstance(resolution, dict):
146
+ violations.append(FieldViolation(field="policy_profile_resolution", error="must be an object"))
147
+ else:
148
+ resolution_profile = resolution.get("policy_profile")
149
+ if not _non_empty_string(resolution_profile):
150
+ violations.append(
151
+ FieldViolation(
152
+ field="policy_profile_resolution.policy_profile",
153
+ error="must be a non-empty string",
154
+ )
155
+ )
156
+ elif not POLICY_PROFILE_ID_RE.match(str(resolution_profile).strip()):
157
+ violations.append(
158
+ FieldViolation(
159
+ field="policy_profile_resolution.policy_profile",
160
+ error="must match ^[a-z][a-z0-9_]*$",
161
+ )
162
+ )
163
+ source = resolution.get("source")
164
+ if source not in VALID_POLICY_PROFILE_RESOLUTION_SOURCES:
165
+ violations.append(
166
+ FieldViolation(
167
+ field="policy_profile_resolution.source",
168
+ error=(
169
+ "must be one of "
170
+ + ", ".join(sorted(VALID_POLICY_PROFILE_RESOLUTION_SOURCES))
171
+ ),
172
+ )
173
+ )
174
+ if not _non_empty_string(resolution.get("confidence")):
175
+ violations.append(
176
+ FieldViolation(
177
+ field="policy_profile_resolution.confidence",
178
+ error="must be a non-empty string",
179
+ )
180
+ )
181
+ alternatives = resolution.get("alternatives")
182
+ if alternatives is not None:
183
+ if not isinstance(alternatives, list):
184
+ violations.append(
185
+ FieldViolation(
186
+ field="policy_profile_resolution.alternatives",
187
+ error="must be a list",
188
+ )
189
+ )
190
+ else:
191
+ for idx, item in enumerate(alternatives):
192
+ if not _non_empty_string(item):
193
+ violations.append(
194
+ FieldViolation(
195
+ field=f"policy_profile_resolution.alternatives[{idx}]",
196
+ error="must be a non-empty string",
197
+ )
198
+ )
199
+
200
+ audience = data.get("audience")
201
+ if not isinstance(audience, dict):
202
+ violations.append(FieldViolation(field="audience", error="must be an object"))
203
+ else:
204
+ for field in ("label", "language"):
205
+ if not _non_empty_string(audience.get(field)):
206
+ violations.append(FieldViolation(field=f"audience.{field}", error="must be a non-empty string"))
207
+
208
+ source_policy = data.get("source_policy")
209
+ if not isinstance(source_policy, dict):
210
+ violations.append(FieldViolation(field="source_policy", error="must be an object"))
211
+ else:
212
+ mode = source_policy.get("mode")
213
+ if mode not in VALID_SOURCE_POLICY_MODES:
214
+ violations.append(
215
+ FieldViolation(
216
+ field="source_policy.mode",
217
+ error=f"must be one of {', '.join(sorted(VALID_SOURCE_POLICY_MODES))}",
218
+ )
219
+ )
220
+ if source_policy.get("hidden_autonomous_crawling") is not False:
221
+ violations.append(
222
+ FieldViolation(
223
+ field="source_policy.hidden_autonomous_crawling",
224
+ error="must be false",
225
+ )
226
+ )
227
+
228
+ control_spine = data.get("control_spine")
229
+ if not isinstance(control_spine, dict):
230
+ violations.append(FieldViolation(field="control_spine", error="must be an object"))
231
+ else:
232
+ for key in REQUIRED_CONTROL_SPINE_KEYS:
233
+ if control_spine.get(key) is not True:
234
+ violations.append(FieldViolation(field=f"control_spine.{key}", error="must be true"))
235
+
236
+ outputs = data.get("outputs")
237
+ if outputs is not None:
238
+ if not isinstance(outputs, list):
239
+ violations.append(FieldViolation(field="outputs", error="must be a list"))
240
+ else:
241
+ for idx, item in enumerate(outputs):
242
+ if not _non_empty_string(item):
243
+ violations.append(FieldViolation(field=f"outputs[{idx}]", error="must be a non-empty string"))
244
+
245
+ metadata = data.get("metadata")
246
+ if metadata is not None and not isinstance(metadata, dict):
247
+ violations.append(FieldViolation(field="metadata", error="must be an object"))
248
+
249
+ return violations
250
+
251
+ @classmethod
252
+ def migrate(cls, data: dict[str, Any], from_version: str) -> dict[str, Any]:
253
+ return dict(data)
254
+
255
+
256
+ def _non_empty_string(value: Any) -> bool:
257
+ return isinstance(value, str) and bool(value.strip())