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,548 @@
1
+ """features / capability / recommend / setup commands."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ from pathlib import Path
7
+
8
+
9
+ def register_features(subparsers: argparse._SubParsersAction) -> None:
10
+ """Register the features subparser."""
11
+ features_parser = subparsers.add_parser(
12
+ "features",
13
+ help="Show all available features and their status.",
14
+ )
15
+ features_parser.add_argument(
16
+ "workspace",
17
+ nargs="?",
18
+ help="Optional workspace path to check provider status.",
19
+ )
20
+ features_parser.add_argument(
21
+ "--info",
22
+ metavar="ID",
23
+ help="Show details for a specific capability.",
24
+ )
25
+ features_parser.add_argument(
26
+ "--json",
27
+ action="store_true",
28
+ dest="json_output",
29
+ help="Output as JSON.",
30
+ )
31
+
32
+
33
+ def register_capability(subparsers: argparse._SubParsersAction) -> None:
34
+ """Register the capability subparser (alias for features)."""
35
+ capability_parser = subparsers.add_parser(
36
+ "capability",
37
+ help="Alias for 'features': show capabilities and setup status.",
38
+ )
39
+ capability_parser.add_argument(
40
+ "workspace",
41
+ nargs="?",
42
+ help="Optional workspace path to check provider status.",
43
+ )
44
+ capability_parser.add_argument(
45
+ "--info",
46
+ metavar="ID",
47
+ help="Show details for a specific capability.",
48
+ )
49
+ capability_parser.add_argument(
50
+ "--json",
51
+ action="store_true",
52
+ dest="json_output",
53
+ help="Output as JSON.",
54
+ )
55
+
56
+
57
+ def register_recommend(subparsers: argparse._SubParsersAction) -> None:
58
+ """Register the recommend subparser."""
59
+ rec_parser = subparsers.add_parser(
60
+ "recommend",
61
+ help="Recommend capabilities based on task description.",
62
+ )
63
+ rec_parser.add_argument(
64
+ "workspace", nargs="?", help="Workspace path to check."
65
+ )
66
+ rec_parser.add_argument(
67
+ "--text",
68
+ help="Task description text to scan for keywords.",
69
+ )
70
+ rec_parser.add_argument(
71
+ "--json",
72
+ action="store_true",
73
+ dest="json_output",
74
+ help="Output as JSON.",
75
+ )
76
+
77
+
78
+ def register_setup(subparsers: argparse._SubParsersAction) -> None:
79
+ """Register the setup subparser."""
80
+ setup_parser = subparsers.add_parser(
81
+ "setup",
82
+ help="Apply recommended capabilities to a workspace.",
83
+ )
84
+ setup_parser.add_argument(
85
+ "workspace", help="Workspace path to configure."
86
+ )
87
+ setup_parser.add_argument(
88
+ "--from-plan",
89
+ help="Path to setup-plan.json to apply.",
90
+ )
91
+ setup_parser.add_argument(
92
+ "--dry-run",
93
+ action="store_true",
94
+ help="Show what would change without writing.",
95
+ )
96
+
97
+
98
+ def handle_features_capability(args: argparse.Namespace) -> int:
99
+ """Show all available features with status indicators."""
100
+ import json as json_mod
101
+
102
+ from multi_agent_brief.capabilities.catalog import (
103
+ CAPABILITIES,
104
+ get_capability,
105
+ )
106
+ from multi_agent_brief.capabilities.detect import assess_capability
107
+
108
+ # --info mode: single capability detail
109
+ if args.info:
110
+ cap = get_capability(args.info)
111
+ if cap is None:
112
+ print(f"[error] Unknown capability: {args.info}")
113
+ print(
114
+ f" Available IDs:"
115
+ f" {', '.join(c.id for c in CAPABILITIES)}"
116
+ )
117
+ return 1
118
+
119
+ enabled_providers = None
120
+ if args.workspace:
121
+ from multi_agent_brief.sources.registry import load_sources_config
122
+
123
+ sources_path = Path(args.workspace) / "sources.yaml"
124
+ if sources_path.exists():
125
+ sc = load_sources_config(sources_path)
126
+ enabled_providers = set(sc.enabled_providers)
127
+
128
+ status = assess_capability(
129
+ cap.id, args.workspace, enabled_providers
130
+ )
131
+
132
+ if args.json_output:
133
+ print(
134
+ json_mod.dumps(
135
+ {
136
+ "id": cap.id,
137
+ "name": cap.name,
138
+ "summary": cap.summary,
139
+ "category": cap.category,
140
+ "visibility": cap.visibility,
141
+ "maturity": cap.maturity,
142
+ "state": status.state,
143
+ "notes": status.notes,
144
+ "options": [
145
+ {
146
+ "id": o.id,
147
+ "name": o.name,
148
+ "description": o.description,
149
+ }
150
+ for o in cap.options
151
+ ],
152
+ "requirements": cap.requirements,
153
+ },
154
+ ensure_ascii=False,
155
+ indent=2,
156
+ )
157
+ )
158
+ else:
159
+ print(
160
+ f"\n {cap.name.get('en', cap.id)} ({cap.id})"
161
+ )
162
+ print(f" {cap.summary.get('en', '')}")
163
+ print(
164
+ f" Category: {cap.category} | Visibility:"
165
+ f" {cap.visibility} | Maturity: {cap.maturity}"
166
+ )
167
+ print(f" Status: {status.state}")
168
+ if status.notes:
169
+ print(f" Notes: {status.notes}")
170
+ if cap.options:
171
+ print("\n Options:")
172
+ for o in cap.options:
173
+ print(
174
+ f" {o.name:16s} {o.description}"
175
+ )
176
+ if cap.requirements:
177
+ print("\n Requirements:")
178
+ for r in cap.requirements:
179
+ print(f" - {r}")
180
+ print()
181
+ return 0
182
+
183
+ # --json mode
184
+ if args.json_output:
185
+ enabled_providers = None
186
+ if args.workspace:
187
+ from multi_agent_brief.sources.registry import load_sources_config
188
+
189
+ sources_path = Path(args.workspace) / "sources.yaml"
190
+ if sources_path.exists():
191
+ sc = load_sources_config(sources_path)
192
+ enabled_providers = set(sc.enabled_providers)
193
+
194
+ items = []
195
+ for cap in CAPABILITIES:
196
+ status = assess_capability(
197
+ cap.id, args.workspace, enabled_providers
198
+ )
199
+ items.append(
200
+ {
201
+ "id": cap.id,
202
+ "name": cap.name.get("en", cap.id),
203
+ "category": cap.category,
204
+ "visibility": cap.visibility,
205
+ "state": status.state,
206
+ "notes": status.notes,
207
+ }
208
+ )
209
+ print(json_mod.dumps(items, ensure_ascii=False, indent=2))
210
+ return 0
211
+
212
+ # Default: human-readable table
213
+ enabled_providers = None
214
+ if args.workspace:
215
+ from multi_agent_brief.sources.registry import load_sources_config
216
+
217
+ sources_path = Path(args.workspace) / "sources.yaml"
218
+ if sources_path.exists():
219
+ sc = load_sources_config(sources_path)
220
+ enabled_providers = set(sc.enabled_providers)
221
+
222
+ symbols = {
223
+ "ENABLED_READY": "✓",
224
+ "ENABLED_NEEDS_SETUP": "!",
225
+ "AVAILABLE": "○",
226
+ "UNAVAILABLE": "—",
227
+ }
228
+
229
+ # Group by category
230
+ categories: dict[str, list] = {}
231
+ for cap in CAPABILITIES:
232
+ categories.setdefault(cap.category, []).append(cap)
233
+
234
+ category_labels = {
235
+ "source": "Source Providers",
236
+ "processing": "Processing",
237
+ "analysis": "Analysis Modules",
238
+ "output": "Output Formats",
239
+ "integration": "Integration",
240
+ }
241
+
242
+ print()
243
+ for cat, caps in categories.items():
244
+ label = category_labels.get(cat, cat.title())
245
+ print(f"━━━ {label} ━━━")
246
+ for cap in caps:
247
+ status = assess_capability(
248
+ cap.id, args.workspace, enabled_providers
249
+ )
250
+ sym = symbols.get(status.state, "?")
251
+ name = cap.name.get("en", cap.id)
252
+ note = f" — {status.notes}" if status.notes else ""
253
+ print(f" {sym} {name:40s}{note}")
254
+ print()
255
+
256
+ print(
257
+ "Run 'multi-agent-brief features --info <id>' for details on any"
258
+ " feature."
259
+ )
260
+ print(
261
+ "Run 'multi-agent-brief features <workspace>' to check status"
262
+ " against a workspace."
263
+ )
264
+ return 0
265
+
266
+
267
+ def handle_recommend(args: argparse.Namespace) -> int:
268
+ """Recommend capabilities based on task description or workspace config."""
269
+ import json as json_mod
270
+
271
+ from multi_agent_brief.capabilities.recommend import (
272
+ recommend_from_input_dir,
273
+ recommend_from_text,
274
+ generate_setup_plan,
275
+ )
276
+
277
+ text_parts: list[str] = []
278
+
279
+ # Collect text from --text flag
280
+ if args.text:
281
+ text_parts.append(args.text)
282
+
283
+ # Collect from workspace
284
+ workspace_dir = None
285
+ enabled_providers = None
286
+ if args.workspace:
287
+ workspace_dir = Path(args.workspace)
288
+ sources_path = workspace_dir / "sources.yaml"
289
+ if sources_path.exists():
290
+ from multi_agent_brief.sources.registry import load_sources_config
291
+
292
+ sc = load_sources_config(sources_path)
293
+ enabled_providers = set(sc.enabled_providers)
294
+
295
+ config_path = workspace_dir / "config.yaml"
296
+ if config_path.exists():
297
+ from multi_agent_brief.core.config import load_config
298
+
299
+ config = load_config(str(config_path))
300
+ # Extract text from config
301
+ proj = config.get("project", {})
302
+ for key in ("name", "industry", "title"):
303
+ if proj.get(key):
304
+ text_parts.append(str(proj[key]))
305
+
306
+ # Scan input directory for file types
307
+ input_dir = workspace_dir / "input"
308
+ file_recs = recommend_from_input_dir(input_dir, enabled_providers)
309
+ else:
310
+ file_recs = []
311
+
312
+ # Run text recommendations
313
+ combined_text = " ".join(text_parts)
314
+ text_recs = (
315
+ recommend_from_text(combined_text, enabled_providers)
316
+ if combined_text
317
+ else []
318
+ )
319
+
320
+ all_recs = text_recs + file_recs
321
+
322
+ if not all_recs:
323
+ print(
324
+ "[recommend] No capability recommendations for this task."
325
+ )
326
+ print(
327
+ "[hint] Use --text to provide a task description, or specify a"
328
+ " workspace."
329
+ )
330
+ return 0
331
+
332
+ if args.json_output:
333
+ plan = generate_setup_plan(all_recs, workspace_dir)
334
+ print(json_mod.dumps(plan, ensure_ascii=False, indent=2))
335
+ else:
336
+ print(f"\nRecommendations ({len(all_recs)}):")
337
+ print()
338
+ for rec in all_recs:
339
+ print(f" → {rec.capability_id}")
340
+ print(f" Reason: {rec.reason}")
341
+ print(f" Rule: {rec.trigger_rule}")
342
+ print()
343
+
344
+ return 0
345
+
346
+
347
+ def handle_setup(args: argparse.Namespace) -> int:
348
+ """Apply a setup plan to a workspace (safe YAML merge)."""
349
+ import json as json_mod
350
+
351
+ workspace = Path(args.workspace)
352
+ if not workspace.exists():
353
+ print(f"[error] Workspace not found: {workspace}")
354
+ return 1
355
+
356
+ sources_path = workspace / "sources.yaml"
357
+ config_path = workspace / "config.yaml"
358
+
359
+ if not sources_path.exists():
360
+ print(f"[error] sources.yaml not found in {workspace}")
361
+ return 1
362
+
363
+ # Load setup plan
364
+ if args.from_plan:
365
+ plan_path = Path(args.from_plan)
366
+ if not plan_path.exists():
367
+ print(f"[error] Setup plan not found: {plan_path}")
368
+ return 1
369
+ plan = json_mod.loads(plan_path.read_text(encoding="utf-8"))
370
+ else:
371
+ # Generate plan from workspace
372
+ from multi_agent_brief.capabilities.recommend import (
373
+ recommend_from_input_dir,
374
+ recommend_from_text,
375
+ generate_setup_plan,
376
+ )
377
+
378
+ text_parts = []
379
+ if config_path.exists():
380
+ from multi_agent_brief.core.config import load_config
381
+
382
+ config = load_config(str(config_path))
383
+ proj = config.get("project", {})
384
+ for key in ("name", "industry", "title"):
385
+ if proj.get(key):
386
+ text_parts.append(str(proj[key]))
387
+
388
+ enabled_providers = None
389
+ from multi_agent_brief.sources.registry import load_sources_config
390
+
391
+ sc = load_sources_config(sources_path)
392
+ enabled_providers = set(sc.enabled_providers)
393
+
394
+ combined_text = " ".join(text_parts)
395
+ recs = (
396
+ recommend_from_text(combined_text, enabled_providers)
397
+ if combined_text
398
+ else []
399
+ )
400
+ recs += recommend_from_input_dir(
401
+ workspace / "input", enabled_providers
402
+ )
403
+ plan = generate_setup_plan(recs, workspace)
404
+
405
+ capabilities = plan.get("capabilities", [])
406
+ if not capabilities:
407
+ print("[setup] No capabilities to enable.")
408
+ return 0
409
+
410
+ # Show what would change
411
+ if args.dry_run:
412
+ print("[dry-run] Changes that would be applied:")
413
+ for cap in capabilities:
414
+ print(
415
+ f" → {cap['name']}:"
416
+ f" {cap.get('config_hint', 'enable in sources.yaml')}"
417
+ )
418
+ print()
419
+ print("[dry-run] No files modified.")
420
+ return 0
421
+
422
+ # Apply changes
423
+ try:
424
+ import yaml
425
+ except ModuleNotFoundError:
426
+ print(
427
+ "[error] PyYAML required for setup. Install: pip install pyyaml"
428
+ )
429
+ return 1
430
+
431
+ sources_data = (
432
+ yaml.safe_load(sources_path.read_text(encoding="utf-8")) or {}
433
+ )
434
+ changes_made = 0
435
+
436
+ for cap in capabilities:
437
+ cap_id = cap["id"]
438
+ if cap_id == "web_search":
439
+ ws = sources_data.setdefault("web_search", {})
440
+ if not ws.get("enabled"):
441
+ ws["enabled"] = True
442
+ ws.setdefault("mode", "runtime_tool")
443
+ ws.setdefault("required_capability", "web_search")
444
+ changes_made += 1
445
+ print(
446
+ " ✓ Enabled web_search in sources.yaml"
447
+ " (mode: runtime_tool; optional external backends:"
448
+ " tavily, exa, brave, firecrawl, serper)"
449
+ )
450
+ elif cap_id == "mineru":
451
+ mu = sources_data.setdefault("mineru", {})
452
+ if not mu.get("enabled"):
453
+ mu["enabled"] = True
454
+ changes_made += 1
455
+ print(" ✓ Enabled mineru in sources.yaml")
456
+ elif cap_id == "filing_resolver":
457
+ fr = sources_data.setdefault("filing_resolver", {})
458
+ if not fr.get("enabled"):
459
+ fr["enabled"] = True
460
+ changes_made += 1
461
+ print(" ✓ Enabled filing_resolver in sources.yaml")
462
+ elif cap_id == "feishu":
463
+ fe = sources_data.setdefault("feishu", {})
464
+ if not fe.get("enabled"):
465
+ fe["enabled"] = True
466
+ changes_made += 1
467
+ print(" ✓ Enabled feishu in sources.yaml")
468
+ elif cap_id == "rss":
469
+ rss = sources_data.setdefault("rss", {})
470
+ if not rss.get("enabled"):
471
+ rss["enabled"] = True
472
+ changes_made += 1
473
+ print(" ✓ Enabled rss in sources.yaml")
474
+ elif cap_id == "api_news":
475
+ api = sources_data.setdefault("api", {})
476
+ if not api.get("enabled"):
477
+ api["enabled"] = True
478
+ changes_made += 1
479
+ print(" ✓ Enabled api in sources.yaml")
480
+ elif cap_id == "market_competitor":
481
+ if config_path.exists():
482
+ config_text = config_path.read_text(encoding="utf-8")
483
+ if "market_competitor" not in config_text:
484
+ config_data = yaml.safe_load(config_text) or {}
485
+ modules = config_data.setdefault("modules", {})
486
+ mc = modules.setdefault("market_competitor", {})
487
+ if not mc.get("enabled"):
488
+ mc["enabled"] = True
489
+ config_path.write_text(
490
+ yaml.safe_dump(
491
+ config_data,
492
+ sort_keys=False,
493
+ default_flow_style=False,
494
+ ),
495
+ encoding="utf-8",
496
+ )
497
+ changes_made += 1
498
+ print(
499
+ " ✓ Enabled market_competitor in config.yaml"
500
+ )
501
+ elif cap_id == "docx_output":
502
+ if config_path.exists():
503
+ config_text = config_path.read_text(encoding="utf-8")
504
+ if "docx" not in config_text:
505
+ config_data = yaml.safe_load(config_text) or {}
506
+ output = config_data.setdefault("output", {})
507
+ formats = output.setdefault(
508
+ "formats", ["markdown"]
509
+ )
510
+ if "docx" not in formats:
511
+ formats.append("docx")
512
+ config_path.write_text(
513
+ yaml.safe_dump(
514
+ config_data,
515
+ sort_keys=False,
516
+ default_flow_style=False,
517
+ ),
518
+ encoding="utf-8",
519
+ )
520
+ changes_made += 1
521
+ print(
522
+ " ✓ Added docx to output.formats in"
523
+ " config.yaml"
524
+ )
525
+
526
+ if changes_made:
527
+ # Write updated sources.yaml
528
+ sources_path.write_text(
529
+ yaml.safe_dump(
530
+ sources_data,
531
+ sort_keys=False,
532
+ default_flow_style=False,
533
+ ),
534
+ encoding="utf-8",
535
+ )
536
+ print(
537
+ f"\n[setup] {changes_made} change(s) applied to {workspace}"
538
+ )
539
+ print(
540
+ "[hint] Run 'multi-agent-brief doctor"
541
+ " --config <workspace>/config.yaml' to verify."
542
+ )
543
+ else:
544
+ print(
545
+ "[setup] All recommended capabilities are already enabled."
546
+ )
547
+
548
+ return 0
@@ -0,0 +1,159 @@
1
+ """Claude Code install helpers."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import argparse
6
+ from pathlib import Path
7
+
8
+ from multi_agent_brief.install.writer import (
9
+ InstallWriteError,
10
+ PlannedWrite,
11
+ apply_planned_writes,
12
+ )
13
+
14
+
15
+ INSTALL_MARKER = "<!-- Generated by briefloop claude install. -->"
16
+ LEGACY_INSTALL_MARKER = "<!-- Generated by multi-agent-brief claude install. -->"
17
+
18
+
19
+ def register(subparsers: argparse._SubParsersAction) -> None:
20
+ claude_parser = subparsers.add_parser(
21
+ "claude",
22
+ help="Install or inspect Claude Code assets for BriefLoop.",
23
+ )
24
+ actions = claude_parser.add_subparsers(dest="claude_action", required=True)
25
+
26
+ install = actions.add_parser(
27
+ "install",
28
+ help="Install BriefLoop Claude Code assets into ~/.claude.",
29
+ )
30
+ install.add_argument(
31
+ "--repo-workdir",
32
+ default=".",
33
+ help="BriefLoop source repository root (default: current directory).",
34
+ )
35
+ install.add_argument(
36
+ "--target",
37
+ default=str(Path.home() / ".claude"),
38
+ help="Claude Code user config directory (default: ~/.claude).",
39
+ )
40
+ install.add_argument(
41
+ "--force",
42
+ action="store_true",
43
+ help="Overwrite existing non-generated files in target locations.",
44
+ )
45
+ install.add_argument(
46
+ "--dry-run",
47
+ action="store_true",
48
+ help="Print planned writes without changing files.",
49
+ )
50
+
51
+
52
+ def handle(args: argparse.Namespace) -> int:
53
+ if args.claude_action == "install":
54
+ try:
55
+ return _install(args)
56
+ except RuntimeError as exc:
57
+ print(f"[claude install] {exc}")
58
+ return 1
59
+ return 1
60
+
61
+
62
+ def _install(args: argparse.Namespace) -> int:
63
+ repo = Path(args.repo_workdir).expanduser().resolve()
64
+ target = Path(args.target).expanduser().resolve()
65
+ command_dir = repo / ".claude" / "commands"
66
+ generate_src = command_dir / "generate-brief.md"
67
+ briefloop_src = command_dir / "briefloop.md"
68
+ mabw_src = command_dir / "mabw.md"
69
+ agents_src = repo / ".claude" / "agents"
70
+ if not generate_src.exists():
71
+ raise RuntimeError(f"Claude command not found: {generate_src}")
72
+ if not briefloop_src.exists():
73
+ raise RuntimeError(f"Claude command not found: {briefloop_src}")
74
+ if not mabw_src.exists():
75
+ raise RuntimeError(f"Claude command not found: {mabw_src}")
76
+ if not agents_src.exists():
77
+ raise RuntimeError(f"Claude agents directory not found: {agents_src}")
78
+
79
+ agents_dst = target / "agents" / "mabw"
80
+
81
+ command_sources = [briefloop_src, mabw_src, generate_src]
82
+ writes: list[PlannedWrite] = [
83
+ PlannedWrite(
84
+ target / "commands" / src.name,
85
+ _installed_command_text(src, repo=repo),
86
+ )
87
+ for src in command_sources
88
+ ]
89
+ for src in sorted(agents_src.glob("*.md")):
90
+ writes.append(PlannedWrite(agents_dst / src.name, _installed_agent_text(src)))
91
+
92
+ try:
93
+ planned = apply_planned_writes(
94
+ writes=writes,
95
+ root=target,
96
+ force=bool(args.force),
97
+ dry_run=bool(args.dry_run),
98
+ generated_markers=(INSTALL_MARKER, LEGACY_INSTALL_MARKER),
99
+ )
100
+ except InstallWriteError as exc:
101
+ raise RuntimeError(str(exc)) from exc
102
+
103
+ if args.dry_run:
104
+ for dst in planned:
105
+ print(f"[claude install] would write {dst}")
106
+ return 0
107
+
108
+ for dst in planned:
109
+ print(f"[claude install] wrote {dst}")
110
+
111
+ print("")
112
+ print("[claude install] Installed /briefloop and compatibility Claude Code assets.")
113
+ print("[claude install] In Claude Code, type '/' and confirm /briefloop is listed.")
114
+ return 0
115
+
116
+
117
+ def _installed_command_text(command_src: Path, *, repo: Path) -> str:
118
+ text = command_src.read_text(encoding="utf-8")
119
+ if command_src.name != "generate-brief.md":
120
+ return _with_install_marker(text)
121
+
122
+ repo_text = repo.as_posix()
123
+ text = text.replace(
124
+ "Read shared contract references before delegation:\n\n"
125
+ "- `configs/orchestrator_contract.yaml`\n"
126
+ "- `configs/stage_specs.yaml`\n"
127
+ "- `configs/artifact_contracts.yaml`\n"
128
+ "- `configs/policy_packs/default.yaml`",
129
+ "This command was installed from the MABW source repository:\n\n"
130
+ f"- `{repo_text}`\n\n"
131
+ "Read shared contract references before delegation:\n\n"
132
+ f"- `{repo_text}/configs/orchestrator_contract.yaml`\n"
133
+ f"- `{repo_text}/configs/stage_specs.yaml`\n"
134
+ f"- `{repo_text}/configs/artifact_contracts.yaml`\n"
135
+ f"- `{repo_text}/configs/policy_packs/default.yaml`",
136
+ )
137
+ text = text.replace(
138
+ "You are the Orchestrator main agent generating a real user-facing brief for workspace: $ARGUMENTS.",
139
+ "You are the Orchestrator main agent generating a real user-facing brief for workspace: $ARGUMENTS.\n\n"
140
+ "If $ARGUMENTS is a relative path, resolve it from the current Claude Code project folder. "
141
+ "If the workspace is not found, ask for an absolute workspace path before proceeding.",
142
+ )
143
+ return _with_install_marker(text)
144
+
145
+
146
+ def _installed_agent_text(agent_src: Path) -> str:
147
+ return _with_install_marker(agent_src.read_text(encoding="utf-8"))
148
+
149
+
150
+ def _with_install_marker(text: str) -> str:
151
+ """Insert the marker without breaking Markdown YAML frontmatter."""
152
+ if text.startswith("---\n"):
153
+ close = text.find("\n---", 4)
154
+ if close != -1:
155
+ close_end = close + len("\n---")
156
+ if close_end < len(text) and text[close_end] == "\n":
157
+ close_end += 1
158
+ return f"{text[:close_end]}{INSTALL_MARKER}\n{text[close_end:]}"
159
+ return f"{INSTALL_MARKER}\n{text}"