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,237 @@
1
+ """inputs — workspace input classification and governance."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ import json
7
+ from pathlib import Path
8
+ from typing import Any
9
+
10
+ from multi_agent_brief.inputs.classifier import classify_input_dir
11
+ from multi_agent_brief.inputs.extractor import extract_input_documents
12
+
13
+
14
+ # ---------------------------------------------------------------------------
15
+ # CLI registration
16
+ # ---------------------------------------------------------------------------
17
+
18
+ def register(subparsers: argparse._SubParsersAction) -> None:
19
+ """Register the inputs subcommand group."""
20
+ inputs_parser = subparsers.add_parser(
21
+ "inputs", help="Input file classification and governance."
22
+ )
23
+ inputs_sub = inputs_parser.add_subparsers(
24
+ dest="inputs_action", required=True
25
+ )
26
+
27
+ classify_parser = inputs_sub.add_parser(
28
+ "classify",
29
+ help="Classify input/ files by role (evidence / feedback / instruction / context).",
30
+ )
31
+ classify_parser.add_argument(
32
+ "--config", required=True, help="Path to workspace config.yaml."
33
+ )
34
+ classify_parser.add_argument(
35
+ "--output",
36
+ help="Output JSON path (default: <output.path>/input_classification.json).",
37
+ )
38
+ classify_parser.add_argument(
39
+ "--quiet", action="store_true", help="Suppress summary output."
40
+ )
41
+
42
+ extract_parser = inputs_sub.add_parser(
43
+ "extract",
44
+ help=(
45
+ "Convert PDF/DOCX/image files under input/ to Markdown using MinerU"
46
+ " before classification."
47
+ ),
48
+ )
49
+ extract_parser.add_argument(
50
+ "--config", required=True, help="Path to workspace config.yaml."
51
+ )
52
+ extract_parser.add_argument(
53
+ "--backend",
54
+ default="pipeline",
55
+ help="MinerU backend for local CLI mode. Default: pipeline.",
56
+ )
57
+ extract_parser.add_argument(
58
+ "--force",
59
+ action="store_true",
60
+ help="Regenerate .mineru.md files even when they already exist.",
61
+ )
62
+ extract_parser.add_argument(
63
+ "--dry-run",
64
+ action="store_true",
65
+ help="List extractable input files without running MinerU or writing Markdown.",
66
+ )
67
+ extract_parser.add_argument(
68
+ "--output",
69
+ help="Output JSON path (default: <output.path>/input_extraction_report.json).",
70
+ )
71
+ extract_parser.add_argument(
72
+ "--quiet", action="store_true", help="Suppress summary output."
73
+ )
74
+
75
+
76
+ def handle(args: argparse.Namespace) -> int:
77
+ """Dispatch inputs subcommands."""
78
+ if args.inputs_action == "classify":
79
+ return _handle_classify(args)
80
+ if args.inputs_action == "extract":
81
+ return _handle_extract(args)
82
+ print(f"[inputs] Unknown action: {args.inputs_action}", flush=True)
83
+ return 1
84
+
85
+
86
+ # ---------------------------------------------------------------------------
87
+ # Classify command
88
+ # ---------------------------------------------------------------------------
89
+
90
+ def _handle_classify(args: argparse.Namespace) -> int:
91
+ """Classify input/ files by role."""
92
+ resolved = _resolve_workspace_paths(args.config)
93
+ if resolved.get("error"):
94
+ print(resolved["error"], flush=True)
95
+ return 1
96
+ input_path = resolved["input_path"]
97
+ output_path = (
98
+ Path(args.output)
99
+ if args.output
100
+ else resolved["output_dir"] / "input_classification.json"
101
+ )
102
+ output_path.parent.mkdir(parents=True, exist_ok=True)
103
+
104
+ classified = classify_input_dir(input_path)
105
+
106
+ payload = json.dumps(classified, ensure_ascii=False, indent=2)
107
+ output_path.write_text(payload, encoding="utf-8")
108
+
109
+ if not args.quiet:
110
+ _print_summary(classified)
111
+
112
+ print(f"[inputs] Classification written: {output_path}", flush=True)
113
+ return 0
114
+
115
+
116
+ def _handle_extract(args: argparse.Namespace) -> int:
117
+ """Extract binary input documents into Markdown with MinerU."""
118
+ resolved = _resolve_workspace_paths(args.config)
119
+ if resolved.get("error"):
120
+ print(resolved["error"], flush=True)
121
+ return 1
122
+
123
+ input_path = resolved["input_path"]
124
+ output_dir = resolved["output_dir"]
125
+ report_path = Path(args.output) if args.output else output_dir / "input_extraction_report.json"
126
+ report_path.parent.mkdir(parents=True, exist_ok=True)
127
+
128
+ report = extract_input_documents(
129
+ input_path=input_path,
130
+ workspace=resolved["workspace"],
131
+ output_dir=output_dir,
132
+ backend=str(args.backend or "pipeline"),
133
+ force=bool(args.force),
134
+ dry_run=bool(args.dry_run),
135
+ )
136
+ report_path.write_text(
137
+ json.dumps(report, ensure_ascii=False, indent=2),
138
+ encoding="utf-8",
139
+ )
140
+
141
+ if not args.quiet:
142
+ _print_extraction_summary(report)
143
+
144
+ print(f"[inputs] Extraction report written: {report_path}", flush=True)
145
+ return 1 if report.get("status") in {"failed", "completed_with_errors"} else 0
146
+
147
+
148
+ def _resolve_workspace_paths(config: str | Path) -> dict[str, Any]:
149
+ """Resolve workspace, input path, and output dir from config.yaml."""
150
+ config_path = Path(config).resolve()
151
+ if not config_path.exists():
152
+ return {"error": f"[inputs] config.yaml not found: {config_path}"}
153
+
154
+ workspace = config_path.parent
155
+
156
+ # ── load config to read input.path / output.path ──
157
+ from multi_agent_brief.core.config import load_config
158
+ try:
159
+ cfg = load_config(config_path)
160
+ except Exception as exc:
161
+ return {"error": f"[inputs] Failed to read config: {exc}"}
162
+
163
+ input_cfg = cfg.get("input", {}) or {}
164
+ output_cfg = cfg.get("output", {}) or {}
165
+
166
+ raw_input_path = input_cfg.get("path", "input")
167
+ input_path = Path(raw_input_path)
168
+ if not input_path.is_absolute():
169
+ input_path = workspace / input_path
170
+
171
+ if not input_path.is_dir():
172
+ return {"error": f"[inputs] No input directory found: {input_path}"}
173
+
174
+ raw_output_path = output_cfg.get("path", "output")
175
+ output_dir = Path(raw_output_path)
176
+ if not output_dir.is_absolute():
177
+ output_dir = workspace / output_dir
178
+
179
+ return {
180
+ "workspace": workspace,
181
+ "input_path": input_path,
182
+ "output_dir": output_dir,
183
+ }
184
+
185
+
186
+ # ---------------------------------------------------------------------------
187
+ # Summary output
188
+ # ---------------------------------------------------------------------------
189
+
190
+ def _print_summary(classified: dict[str, Any]) -> None:
191
+ """Print a human-readable summary."""
192
+ print()
193
+ print("=== Input Classification Summary ===")
194
+ for role, label in [
195
+ ("evidence", "📄 Evidence (claims-eligible)"),
196
+ ("feedback", "✏️ Feedback (editorial direction)"),
197
+ ("instruction", "📋 Instructions (task guidance)"),
198
+ ("context", "📎 Context (background reference)"),
199
+ ]:
200
+ files = classified.get(role, [])
201
+ count = len(files)
202
+ print(f" {label}: {count} file(s)")
203
+ for f in files:
204
+ note = ""
205
+ if f.get("flagged"):
206
+ note = " ⚠️ (suspicious content markers)"
207
+ print(f" - {f['name']}{note}")
208
+
209
+ skipped_files = classified.get("skipped", [])
210
+ skipped_count = len(skipped_files)
211
+ print(f" ⏭️ Skipped: {skipped_count} file(s)")
212
+ if skipped_count > 0:
213
+ for f in skipped_files:
214
+ reason = f.get("reason", "unknown")
215
+ suggested = f" → {f['suggested_role']}" if f.get("suggested_role") else ""
216
+ print(f" - {f['name']} ({reason}{suggested})")
217
+ print()
218
+
219
+
220
+ def _print_extraction_summary(report: dict[str, Any]) -> None:
221
+ """Print a human-readable extraction summary."""
222
+ print()
223
+ print("=== Input Document Extraction Summary ===")
224
+ print(f" Status: {report.get('status', 'unknown')}")
225
+ print(f" Extracted: {len(report.get('extracted', []))} file(s)")
226
+ for item in report.get("extracted", []):
227
+ print(f" - {item.get('input_relative_path')} -> {item.get('markdown_path')}")
228
+ print(f" Skipped: {len(report.get('skipped', []))} file(s)")
229
+ for item in report.get("skipped", []):
230
+ reason = item.get("reason") or item.get("status", "unknown")
231
+ print(f" - {item.get('input_relative_path', item.get('name'))} ({reason})")
232
+ errors = report.get("errors", [])
233
+ if errors:
234
+ print(" Errors:")
235
+ for error in errors:
236
+ print(f" - {error}")
237
+ print()
@@ -0,0 +1,288 @@
1
+ """Multi-Agent Brief Workflow — thin CLI router.
2
+
3
+ Every command group owns its subparser registration and handler logic in a
4
+ dedicated module. main.py only creates the top-level parser, calls each
5
+ module's register(), and dispatches parsed args to the matching handler.
6
+ """
7
+
8
+ from __future__ import annotations
9
+
10
+ import argparse
11
+ import sys
12
+ from pathlib import Path
13
+
14
+ from multi_agent_brief import __version__
15
+ from multi_agent_brief.cli import (
16
+ run_commands,
17
+ onboard_commands,
18
+ init_commands,
19
+ hermes_commands,
20
+ sources_commands,
21
+ competitors_commands,
22
+ audit_commands,
23
+ finalize_commands,
24
+ deliver_commands,
25
+ analysis_commands,
26
+ capability_commands,
27
+ input_commands,
28
+ status_commands,
29
+ state_commands,
30
+ feedback_commands,
31
+ repair_commands,
32
+ gates_commands,
33
+ eval_cases_commands,
34
+ claude_commands,
35
+ provenance_commands,
36
+ controls_commands,
37
+ runtime_commands,
38
+ improve_commands,
39
+ experiments_commands,
40
+ product_commands,
41
+ secrets_commands,
42
+ approval_commands,
43
+ release_commands,
44
+ workbuddy_commands,
45
+ semantic_support_commands,
46
+ )
47
+
48
+
49
+ def _default_prog() -> str:
50
+ executable = Path(sys.argv[0]).stem
51
+ return "briefloop" if executable == "briefloop" else "multi-agent-brief"
52
+
53
+
54
+ def build_parser(*, prog: str | None = None) -> argparse.ArgumentParser:
55
+ parser = argparse.ArgumentParser(prog=prog or _default_prog())
56
+ subparsers = parser.add_subparsers(dest="command", required=True)
57
+
58
+ # Runtime handoff launchers
59
+ run_commands.register(subparsers)
60
+
61
+ # Workspace lifecycle
62
+ onboard_commands.register(subparsers)
63
+ init_commands.register(subparsers)
64
+
65
+ # Source health and discovery
66
+ sources_commands.register_doctor(subparsers)
67
+ sources_commands.register_sources(subparsers)
68
+ secrets_commands.register(subparsers)
69
+
70
+ # Competitor universe
71
+ competitors_commands.register(subparsers)
72
+
73
+ # Quality gates
74
+ audit_commands.register(subparsers)
75
+ finalize_commands.register(subparsers)
76
+ deliver_commands.register(subparsers)
77
+
78
+ # Analysis tooling
79
+ analysis_commands.register_analysis_blocks(subparsers)
80
+ analysis_commands.register_limitation_hygiene(subparsers)
81
+
82
+ # Capability discovery and setup
83
+ capability_commands.register_features(subparsers)
84
+ capability_commands.register_capability(subparsers)
85
+ capability_commands.register_recommend(subparsers)
86
+ capability_commands.register_setup(subparsers)
87
+
88
+ # Input governance
89
+ input_commands.register(subparsers)
90
+
91
+ # Read-only writer-facing workspace status
92
+ status_commands.register(subparsers)
93
+
94
+ # Orchestrator runtime state
95
+ state_commands.register(subparsers)
96
+
97
+ # Feedback and repair planning
98
+ feedback_commands.register(subparsers)
99
+ repair_commands.register(subparsers)
100
+
101
+ # Deterministic quality gate controls
102
+ gates_commands.register(subparsers)
103
+
104
+ # Public-safe evaluation cases
105
+ eval_cases_commands.register(subparsers)
106
+
107
+ # Experimental measurement harnesses
108
+ experiments_commands.register(subparsers)
109
+
110
+ # Deterministic provenance projection
111
+ provenance_commands.register(subparsers)
112
+
113
+ # Orchestrator control switchboard
114
+ controls_commands.register(subparsers)
115
+
116
+ # Improvement Ledger lifecycle
117
+ improve_commands.register(subparsers)
118
+
119
+ # Workspace runtime kit install
120
+ runtime_commands.register(subparsers)
121
+
122
+ # Experimental product-layer report contracts
123
+ product_commands.register_new_workspace(subparsers)
124
+ product_commands.register_packs(subparsers)
125
+ product_commands.register_validate_report_spec(subparsers)
126
+ product_commands.register_extract(subparsers)
127
+ product_commands.register_quality(subparsers)
128
+
129
+ # Internal review release modes and human approval ledger
130
+ approval_commands.register(subparsers)
131
+ release_commands.register(subparsers)
132
+
133
+ # Claude Code install helpers
134
+ claude_commands.register(subparsers)
135
+
136
+ # Hermes runtime
137
+ hermes_commands.register(subparsers)
138
+
139
+ # WorkBuddy source-clone Skill packaging
140
+ workbuddy_commands.register(subparsers)
141
+
142
+ # Human adjudication for semantic support proposals
143
+ semantic_support_commands.register(subparsers)
144
+
145
+ # Meta
146
+ subparsers.add_parser("version", help="Print package version.")
147
+
148
+ return parser
149
+
150
+
151
+ # ── dispatch table ──────────────────────────────────────────────────────────
152
+ # Each entry maps a command string (and optional sub-action) to a handler.
153
+ # For command groups with sub-actions (sources, competitors, hermes) the
154
+ # handler internally dispatches on args.<group>_action.
155
+
156
+
157
+ def _dispatch(args: argparse.Namespace) -> int:
158
+ cmd = args.command
159
+
160
+ if cmd == "version":
161
+ print(__version__)
162
+ return 0
163
+
164
+ if cmd in ("run", "start", "handoff", "prepare"):
165
+ return run_commands.handle(args)
166
+
167
+ if cmd == "onboard":
168
+ return onboard_commands.handle(args)
169
+
170
+ if cmd == "init":
171
+ return init_commands.handle(args)
172
+
173
+ if cmd == "hermes":
174
+ return hermes_commands.handle(args)
175
+
176
+ if cmd == "doctor":
177
+ return sources_commands.handle_doctor(args)
178
+
179
+ if cmd == "sources":
180
+ return sources_commands.handle_sources(args)
181
+
182
+ if cmd == "secrets":
183
+ return secrets_commands.handle(args)
184
+
185
+ if cmd == "approval":
186
+ return approval_commands.handle(args)
187
+
188
+ if cmd == "release":
189
+ return release_commands.handle(args)
190
+
191
+ if cmd == "competitors":
192
+ return competitors_commands.handle(args)
193
+
194
+ if cmd == "audit":
195
+ return audit_commands.handle(args)
196
+
197
+ if cmd == "finalize":
198
+ return finalize_commands.handle(args)
199
+
200
+ if cmd == "deliver":
201
+ return deliver_commands.handle(args)
202
+
203
+ if cmd == "analysis-blocks":
204
+ return analysis_commands.handle_analysis_blocks(args)
205
+
206
+ if cmd == "limitation-hygiene":
207
+ return analysis_commands.handle_limitation_hygiene(args)
208
+
209
+ if cmd in ("features", "capability"):
210
+ return capability_commands.handle_features_capability(args)
211
+
212
+ if cmd == "recommend":
213
+ return capability_commands.handle_recommend(args)
214
+
215
+ if cmd == "setup":
216
+ return capability_commands.handle_setup(args)
217
+
218
+ if cmd == "inputs":
219
+ return input_commands.handle(args)
220
+
221
+ if cmd == "status":
222
+ return status_commands.handle(args)
223
+
224
+ if cmd == "state":
225
+ return state_commands.handle(args)
226
+
227
+ if cmd == "feedback":
228
+ return feedback_commands.handle(args)
229
+
230
+ if cmd == "repair":
231
+ return repair_commands.handle(args)
232
+
233
+ if cmd == "gates":
234
+ return gates_commands.handle(args)
235
+
236
+ if cmd == "eval-cases":
237
+ return eval_cases_commands.handle(args)
238
+
239
+ if cmd == "experiments":
240
+ return experiments_commands.handle(args)
241
+
242
+ if cmd == "provenance":
243
+ return provenance_commands.handle(args)
244
+
245
+ if cmd == "controls":
246
+ return controls_commands.handle(args)
247
+
248
+ if cmd == "improve":
249
+ return improve_commands.handle(args)
250
+
251
+ if cmd == "runtime":
252
+ return runtime_commands.handle(args)
253
+
254
+ if cmd == "packs":
255
+ return product_commands.handle_packs(args)
256
+
257
+ if cmd == "new":
258
+ return product_commands.handle_new_workspace(args)
259
+
260
+ if cmd == "validate-report-spec":
261
+ return product_commands.handle_validate_report_spec(args)
262
+
263
+ if cmd == "extract":
264
+ return product_commands.handle_extract(args)
265
+
266
+ if cmd == "quality":
267
+ return product_commands.handle_quality(args)
268
+
269
+ if cmd == "claude":
270
+ return claude_commands.handle(args)
271
+
272
+ if cmd == "workbuddy":
273
+ return workbuddy_commands.handle(args)
274
+
275
+ if cmd == "semantic-support":
276
+ return semantic_support_commands.handle(args)
277
+
278
+ return 1
279
+
280
+
281
+ def main(argv: list[str] | None = None) -> int:
282
+ parser = build_parser()
283
+ args = parser.parse_args(argv)
284
+ return _dispatch(args)
285
+
286
+
287
+ if __name__ == "__main__":
288
+ raise SystemExit(main())