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.
- briefloop-0.11.12.dist-info/METADATA +473 -0
- briefloop-0.11.12.dist-info/RECORD +424 -0
- briefloop-0.11.12.dist-info/WHEEL +5 -0
- briefloop-0.11.12.dist-info/entry_points.txt +3 -0
- briefloop-0.11.12.dist-info/licenses/LICENSE +22 -0
- briefloop-0.11.12.dist-info/top_level.txt +1 -0
- multi_agent_brief/__init__.py +36 -0
- multi_agent_brief/analysis_blocks/__init__.py +11 -0
- multi_agent_brief/analysis_blocks/builder.py +206 -0
- multi_agent_brief/analysis_blocks/renderer.py +237 -0
- multi_agent_brief/analysis_blocks/schemas.py +52 -0
- multi_agent_brief/analysis_modules/__init__.py +8 -0
- multi_agent_brief/analysis_modules/base.py +87 -0
- multi_agent_brief/analysis_modules/market_competitor/__init__.py +68 -0
- multi_agent_brief/analysis_modules/market_competitor/auditor.py +290 -0
- multi_agent_brief/analysis_modules/market_competitor/config.py +187 -0
- multi_agent_brief/analysis_modules/market_competitor/event_builder.py +226 -0
- multi_agent_brief/analysis_modules/market_competitor/renderer.py +199 -0
- multi_agent_brief/analysis_modules/market_competitor/schemas.py +518 -0
- multi_agent_brief/analysis_modules/policy_regulatory/__init__.py +7 -0
- multi_agent_brief/analysis_modules/policy_regulatory/audit.py +195 -0
- multi_agent_brief/analysis_modules/policy_regulatory/module.py +387 -0
- multi_agent_brief/analysis_modules/policy_regulatory/schemas.py +129 -0
- multi_agent_brief/analysis_modules/registry.py +73 -0
- multi_agent_brief/audience/__init__.py +19 -0
- multi_agent_brief/audience/profiles.py +246 -0
- multi_agent_brief/audience_memory/__init__.py +23 -0
- multi_agent_brief/audience_memory/profile.py +358 -0
- multi_agent_brief/audit/__init__.py +36 -0
- multi_agent_brief/audit/case_applicability.py +181 -0
- multi_agent_brief/audit/deterministic.py +471 -0
- multi_agent_brief/audit/editorial_governance.py +404 -0
- multi_agent_brief/audit/final_quality.py +764 -0
- multi_agent_brief/audit/harness.py +242 -0
- multi_agent_brief/audit/interfaces.py +96 -0
- multi_agent_brief/audit/limitation_hygiene.py +238 -0
- multi_agent_brief/audit/proposal_boundary.py +34 -0
- multi_agent_brief/audit/redaction.py +27 -0
- multi_agent_brief/audit/rule_packs.py +96 -0
- multi_agent_brief/audit/semantic.py +435 -0
- multi_agent_brief/capabilities/__init__.py +22 -0
- multi_agent_brief/capabilities/catalog.py +215 -0
- multi_agent_brief/capabilities/detect.py +199 -0
- multi_agent_brief/capabilities/models.py +60 -0
- multi_agent_brief/capabilities/recommend.py +206 -0
- multi_agent_brief/cli/__init__.py +2 -0
- multi_agent_brief/cli/analysis_commands.py +140 -0
- multi_agent_brief/cli/approval_commands.py +107 -0
- multi_agent_brief/cli/audit_commands.py +59 -0
- multi_agent_brief/cli/capability_commands.py +548 -0
- multi_agent_brief/cli/claude_commands.py +159 -0
- multi_agent_brief/cli/competitors_commands.py +182 -0
- multi_agent_brief/cli/controls_commands.py +137 -0
- multi_agent_brief/cli/deliver_commands.py +942 -0
- multi_agent_brief/cli/eval_cases_commands.py +99 -0
- multi_agent_brief/cli/experiments_commands.py +395 -0
- multi_agent_brief/cli/feedback_commands.py +192 -0
- multi_agent_brief/cli/finalize_commands.py +153 -0
- multi_agent_brief/cli/gates_commands.py +174 -0
- multi_agent_brief/cli/hermes_commands.py +356 -0
- multi_agent_brief/cli/improve_commands.py +224 -0
- multi_agent_brief/cli/init_commands.py +564 -0
- multi_agent_brief/cli/init_wizard.py +1473 -0
- multi_agent_brief/cli/input_commands.py +237 -0
- multi_agent_brief/cli/main.py +288 -0
- multi_agent_brief/cli/onboard_commands.py +193 -0
- multi_agent_brief/cli/product_commands.py +1449 -0
- multi_agent_brief/cli/provenance_commands.py +100 -0
- multi_agent_brief/cli/release_commands.py +68 -0
- multi_agent_brief/cli/repair_commands.py +169 -0
- multi_agent_brief/cli/run_commands.py +292 -0
- multi_agent_brief/cli/runtime_commands.py +81 -0
- multi_agent_brief/cli/secrets_commands.py +232 -0
- multi_agent_brief/cli/semantic_support_commands.py +80 -0
- multi_agent_brief/cli/sources_commands.py +647 -0
- multi_agent_brief/cli/start_commands.py +8 -0
- multi_agent_brief/cli/state_commands.py +446 -0
- multi_agent_brief/cli/status_commands.py +26 -0
- multi_agent_brief/cli/workbuddy_commands.py +103 -0
- multi_agent_brief/configs/artifact_contracts.yaml +514 -0
- multi_agent_brief/configs/orchestrator_contract.yaml +181 -0
- multi_agent_brief/configs/policy_packs/default.yaml +65 -0
- multi_agent_brief/configs/policy_profiles/evidence_extract_default.yaml +58 -0
- multi_agent_brief/configs/policy_profiles/finance_default.yaml +44 -0
- multi_agent_brief/configs/policy_profiles/internet_default.yaml +44 -0
- multi_agent_brief/configs/policy_profiles/manufacturing_default.yaml +33 -0
- multi_agent_brief/configs/policy_profiles/solar_manufacturing_default.yaml +64 -0
- multi_agent_brief/configs/report_packs/evidence_extract.yaml +48 -0
- multi_agent_brief/configs/report_packs/management_monthly.yaml +36 -0
- multi_agent_brief/configs/report_packs/market_weekly.yaml +36 -0
- multi_agent_brief/configs/report_packs/solar_industry_periodic.yaml +50 -0
- multi_agent_brief/configs/report_templates/evidence_extract.yaml +55 -0
- multi_agent_brief/configs/report_templates/management_monthly.yaml +48 -0
- multi_agent_brief/configs/report_templates/market_weekly.yaml +49 -0
- multi_agent_brief/configs/report_templates/solar_industry_periodic.yaml +75 -0
- multi_agent_brief/configs/stage_specs.yaml +180 -0
- multi_agent_brief/contracts/__init__.py +41 -0
- multi_agent_brief/contracts/base.py +99 -0
- multi_agent_brief/contracts/errors.py +41 -0
- multi_agent_brief/contracts/migrations/__init__.py +5 -0
- multi_agent_brief/contracts/migrations/claim_v1_to_v2.py +33 -0
- multi_agent_brief/contracts/registry.py +159 -0
- multi_agent_brief/contracts/role_topology.py +25 -0
- multi_agent_brief/contracts/schemas/__init__.py +35 -0
- multi_agent_brief/contracts/schemas/analysis_pack.py +135 -0
- multi_agent_brief/contracts/schemas/atomic_claim_graph.py +304 -0
- multi_agent_brief/contracts/schemas/audit_report.py +80 -0
- multi_agent_brief/contracts/schemas/candidate_item.py +51 -0
- multi_agent_brief/contracts/schemas/claim.py +197 -0
- multi_agent_brief/contracts/schemas/claim_draft.py +386 -0
- multi_agent_brief/contracts/schemas/claim_support_matrix.py +334 -0
- multi_agent_brief/contracts/schemas/evidence_span_registry.py +270 -0
- multi_agent_brief/contracts/schemas/policy_profile.py +247 -0
- multi_agent_brief/contracts/schemas/report_spec.py +257 -0
- multi_agent_brief/contracts/schemas/semantic_assessment_report.py +480 -0
- multi_agent_brief/contracts/schemas/source_evidence_pack_manifest.py +233 -0
- multi_agent_brief/contracts/schemas/source_item.py +96 -0
- multi_agent_brief/contracts/semantic_assessment_status.py +12 -0
- multi_agent_brief/contracts/source_metadata.py +252 -0
- multi_agent_brief/contracts/target_contract.py +460 -0
- multi_agent_brief/contracts/validator.py +225 -0
- multi_agent_brief/controls/__init__.py +23 -0
- multi_agent_brief/controls/contract.py +106 -0
- multi_agent_brief/controls/switchboard.py +1076 -0
- multi_agent_brief/core/__init__.py +2 -0
- multi_agent_brief/core/citations.py +14 -0
- multi_agent_brief/core/claim_ledger.py +94 -0
- multi_agent_brief/core/config.py +191 -0
- multi_agent_brief/core/env.py +69 -0
- multi_agent_brief/core/previous.py +83 -0
- multi_agent_brief/core/schemas.py +181 -0
- multi_agent_brief/core/selection.py +189 -0
- multi_agent_brief/delivery/__init__.py +6 -0
- multi_agent_brief/delivery/base.py +36 -0
- multi_agent_brief/delivery/feishu.py +204 -0
- multi_agent_brief/delivery/gws.py +237 -0
- multi_agent_brief/evaluation_cases/__init__.py +15 -0
- multi_agent_brief/evaluation_cases/contract.py +429 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/approved_guidance_materialized/workspace/config.yaml +18 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/approved_guidance_materialized/workspace/improvement/ledger.jsonl +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/approved_guidance_materialized/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/approved_guidance_materialized/workspace/user.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/company_event_missing_latest_official_check/workspace/config.yaml +13 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/company_event_missing_latest_official_check/workspace/sources.yaml +9 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/company_event_missing_latest_official_check/workspace/user.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/control_switchboard_selection_is_not_execution/workspace/config.yaml +12 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/control_switchboard_selection_is_not_execution/workspace/sources.yaml +6 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/control_switchboard_selection_is_not_execution/workspace/user.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/feedback_triage_required/workspace/config.yaml +6 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/feedback_triage_required/workspace/input/human_feedback.md +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/feedback_triage_required/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/feedback_triage_required/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/config.yaml +8 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/brief.md +14 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/intermediate/audit_report.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/intermediate/audited_brief.md +5 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/intermediate/candidate_claims.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/intermediate/claim_ledger.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/output/intermediate/screened_candidates.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/final_abstract_quality_warning_surface/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/formal_release_missing_human_approval/workspace/config.yaml +13 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/formal_release_missing_human_approval/workspace/sources.yaml +9 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/formal_release_missing_human_approval/workspace/user.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/guidance_manifestation_not_observable/workspace/config.yaml +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/guidance_manifestation_not_observable/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/guidance_manifestation_not_observable/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/media_only_legal_policy_blocks_research_review/workspace/config.yaml +13 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/media_only_legal_policy_blocks_research_review/workspace/sources.yaml +9 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/media_only_legal_policy_blocks_research_review/workspace/user.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/mixed_metric_scope_support_blocker/workspace/config.yaml +13 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/mixed_metric_scope_support_blocker/workspace/sources.yaml +9 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/mixed_metric_scope_support_blocker/workspace/user.md +5 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/config.yaml +6 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/audited_brief.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/candidate_claims.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/claim_ledger.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/feedback_issues.json +25 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/repair_plan.json +27 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/output/intermediate/screened_candidates.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/planned_blocking_issue_cannot_continue/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/config.yaml +8 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/audit_report.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/audited_brief.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/candidate_claims.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/claim_ledger.json +11 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/quality_gate_report.json +22 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/output/intermediate/screened_candidates.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/provenance_projection_minimal/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/config.yaml +13 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/output/intermediate/audit_report.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/output/intermediate/audited_brief.md +5 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/output/intermediate/candidate_claims.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/output/intermediate/claim_ledger.json +40 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/output/intermediate/screened_candidates.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/sources.yaml +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_source_appendix/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/config.yaml +8 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/brief.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/intermediate/audit_report.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/intermediate/audited_brief.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/intermediate/candidate_claims.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/intermediate/claim_ledger.json +13 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/output/intermediate/screened_candidates.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reader_facing_target_relevance/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/release_readiness_forged_event_blocker/workspace/config.yaml +13 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/release_readiness_forged_event_blocker/workspace/output/intermediate/release_readiness_report.json +31 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/release_readiness_forged_event_blocker/workspace/sources.yaml +9 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/release_readiness_forged_event_blocker/workspace/user.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/config.yaml +18 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/improvement/ledger.jsonl +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/improvement/memory.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/output/intermediate/improvement_memory_snapshot.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/reverted_entry_removed_from_next_snapshot/workspace/user.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/config.yaml +12 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/input/sources/source-001.txt +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/brief.md +37 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/delivery/brief.md +37 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/atomic_claim_graph.json +17 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/audit_report.json +5 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/audited_brief.md +37 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/claim_ledger.json +20 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/evidence_span_registry.json +20 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/finalize_report.json +40 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/gates/auditor_quality_gate_report.json +42 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/gates/finalize_quality_gate_report.json +42 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/intermediate/screened_candidates.json +33 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/source_appendix.md +12 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/output/source_appendix_trace.md +10 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/report_spec.yaml +24 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/sources.yaml +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/same_evidence_reader_quality_regression/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/source_evidence_pack_blocks_non_evidence_file/workspace/config.yaml +13 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/source_evidence_pack_blocks_non_evidence_file/workspace/input/sources/README.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/source_evidence_pack_blocks_non_evidence_file/workspace/output/intermediate/source_evidence_pack_manifest.json +26 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/source_evidence_pack_blocks_non_evidence_file/workspace/sources.yaml +9 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/source_evidence_pack_blocks_non_evidence_file/workspace/user.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/config.yaml +9 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/output/intermediate/audit_report.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/output/intermediate/audited_brief.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/output/intermediate/candidate_claims.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/output/intermediate/claim_ledger.json +13 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/output/intermediate/screened_candidates.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/stale_current_claim/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/third_party_price_snapshot_formal_block/workspace/config.yaml +13 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/third_party_price_snapshot_formal_block/workspace/sources.yaml +9 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/third_party_price_snapshot_formal_block/workspace/user.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/trajectory_retry_budget_exhausted/workspace/config.yaml +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/trajectory_retry_budget_exhausted/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/trajectory_retry_budget_exhausted/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unapproved_entry_not_materialized/workspace/config.yaml +18 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unapproved_entry_not_materialized/workspace/improvement/ledger.jsonl +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unapproved_entry_not_materialized/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unapproved_entry_not_materialized/workspace/user.md +4 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unauthorized_institution_branding_blocks_release/workspace/config.yaml +18 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unauthorized_institution_branding_blocks_release/workspace/sources.yaml +9 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unauthorized_institution_branding_blocks_release/workspace/user.md +5 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/config.yaml +8 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/output/intermediate/audit_report.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/output/intermediate/audited_brief.md +8 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/output/intermediate/candidate_claims.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/output/intermediate/claim_ledger.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/output/intermediate/screened_candidates.json +1 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/sources.yaml +2 -0
- multi_agent_brief/evaluation_cases/fixtures/cases/unsupported_material_fact/workspace/user.md +3 -0
- multi_agent_brief/evaluation_cases/fixtures/manifest.yaml +861 -0
- multi_agent_brief/evaluation_cases/fixtures.py +20 -0
- multi_agent_brief/evaluation_cases/runner.py +1603 -0
- multi_agent_brief/experiments/__init__.py +45 -0
- multi_agent_brief/experiments/experiment_080.py +5835 -0
- multi_agent_brief/experiments/schemas.py +63 -0
- multi_agent_brief/experiments/target_contract.py +10 -0
- multi_agent_brief/feedback/__init__.py +17 -0
- multi_agent_brief/feedback/feedback_contract.py +482 -0
- multi_agent_brief/feedback/feedback_state.py +898 -0
- multi_agent_brief/hermes/__init__.py +25 -0
- multi_agent_brief/hermes/adapter.py +832 -0
- multi_agent_brief/improvement/__init__.py +83 -0
- multi_agent_brief/improvement/contract.py +1114 -0
- multi_agent_brief/improvement/memory.py +451 -0
- multi_agent_brief/improvement/product_definition.py +228 -0
- multi_agent_brief/improvement/state.py +961 -0
- multi_agent_brief/inputs/__init__.py +2 -0
- multi_agent_brief/inputs/classifier.py +322 -0
- multi_agent_brief/inputs/contracts.py +59 -0
- multi_agent_brief/inputs/extractor.py +310 -0
- multi_agent_brief/install/__init__.py +2 -0
- multi_agent_brief/install/writer.py +97 -0
- multi_agent_brief/onboarding/__init__.py +11 -0
- multi_agent_brief/onboarding/io.py +103 -0
- multi_agent_brief/onboarding/mapper.py +484 -0
- multi_agent_brief/onboarding/schema.py +46 -0
- multi_agent_brief/orchestrator/__init__.py +2 -0
- multi_agent_brief/orchestrator/fact_layer_import.py +352 -0
- multi_agent_brief/orchestrator/handoff.py +2209 -0
- multi_agent_brief/orchestrator/role_topology.py +42 -0
- multi_agent_brief/orchestrator/run_archive.py +888 -0
- multi_agent_brief/orchestrator/run_integrity.py +346 -0
- multi_agent_brief/orchestrator/runtime_state/__init__.py +70 -0
- multi_agent_brief/orchestrator/runtime_state/_io.py +167 -0
- multi_agent_brief/orchestrator/runtime_state/_transactions.py +298 -0
- multi_agent_brief/orchestrator/runtime_state/artifact_registry.py +1825 -0
- multi_agent_brief/orchestrator/runtime_state/atomic_claim_graph.py +96 -0
- multi_agent_brief/orchestrator/runtime_state/claim_ledger_freeze.py +510 -0
- multi_agent_brief/orchestrator/runtime_state/claim_metadata_enrichment.py +836 -0
- multi_agent_brief/orchestrator/runtime_state/claim_support_matrix.py +582 -0
- multi_agent_brief/orchestrator/runtime_state/completion_gates.py +672 -0
- multi_agent_brief/orchestrator/runtime_state/contracts_loader.py +66 -0
- multi_agent_brief/orchestrator/runtime_state/decisions.py +239 -0
- multi_agent_brief/orchestrator/runtime_state/errors.py +61 -0
- multi_agent_brief/orchestrator/runtime_state/event_log.py +256 -0
- multi_agent_brief/orchestrator/runtime_state/evidence_span_registry.py +233 -0
- multi_agent_brief/orchestrator/runtime_state/fact_layer.py +755 -0
- multi_agent_brief/orchestrator/runtime_state/identity.py +90 -0
- multi_agent_brief/orchestrator/runtime_state/lifecycle.py +675 -0
- multi_agent_brief/orchestrator/runtime_state/manifest.py +82 -0
- multi_agent_brief/orchestrator/runtime_state/operations.py +224 -0
- multi_agent_brief/orchestrator/runtime_state/paths.py +38 -0
- multi_agent_brief/orchestrator/runtime_state/repair.py +984 -0
- multi_agent_brief/orchestrator/runtime_state/safety_surfaces.py +147 -0
- multi_agent_brief/orchestrator/runtime_state/semantic_assessment_report.py +692 -0
- multi_agent_brief/orchestrator/runtime_state/semantic_support_acceptance.py +683 -0
- multi_agent_brief/orchestrator/runtime_state/source_evidence_pack.py +131 -0
- multi_agent_brief/orchestrator/runtime_state/stage_completion.py +1320 -0
- multi_agent_brief/orchestrator/runtime_state/trajectory.py +200 -0
- multi_agent_brief/orchestrator/runtime_state/workflow.py +350 -0
- multi_agent_brief/orchestrator/source_evidence.py +43 -0
- multi_agent_brief/orchestrator/timing.py +410 -0
- multi_agent_brief/orchestrator_contract.py +96 -0
- multi_agent_brief/outputs/__init__.py +2 -0
- multi_agent_brief/outputs/atomic_reader_projection.py +288 -0
- multi_agent_brief/outputs/docx.py +32 -0
- multi_agent_brief/outputs/finalize.py +1036 -0
- multi_agent_brief/outputs/ib_docx.py +983 -0
- multi_agent_brief/outputs/naming.py +38 -0
- multi_agent_brief/outputs/pdf.py +20 -0
- multi_agent_brief/outputs/reader_final_gate.py +509 -0
- multi_agent_brief/outputs/reader_projection.py +397 -0
- multi_agent_brief/outputs/source_appendix.py +753 -0
- multi_agent_brief/outputs/templates/__init__.py +112 -0
- multi_agent_brief/product/__init__.py +49 -0
- multi_agent_brief/product/bundle_projection.py +686 -0
- multi_agent_brief/product/citation_profile.py +145 -0
- multi_agent_brief/product/guidance_manifestation.py +421 -0
- multi_agent_brief/product/materiality_selection.py +472 -0
- multi_agent_brief/product/policy_gate_adapter.py +116 -0
- multi_agent_brief/product/policy_profile.py +39 -0
- multi_agent_brief/product/policy_projection.py +161 -0
- multi_agent_brief/product/policy_registry.py +83 -0
- multi_agent_brief/product/policy_resolver.py +225 -0
- multi_agent_brief/product/quality_closeout.py +188 -0
- multi_agent_brief/product/quality_panel.py +2217 -0
- multi_agent_brief/product/release_approval.py +1034 -0
- multi_agent_brief/product/report_pack.py +130 -0
- multi_agent_brief/product/report_pack_aliases.py +68 -0
- multi_agent_brief/product/report_registry.py +101 -0
- multi_agent_brief/product/report_spec.py +181 -0
- multi_agent_brief/product/support_wording.py +525 -0
- multi_agent_brief/product/template_conformance.py +516 -0
- multi_agent_brief/product/template_projection.py +123 -0
- multi_agent_brief/product/template_registry.py +244 -0
- multi_agent_brief/product/template_render_plan.py +315 -0
- multi_agent_brief/product/template_renderer.py +224 -0
- multi_agent_brief/product/trajectory_regulation.py +441 -0
- multi_agent_brief/provenance/__init__.py +5 -0
- multi_agent_brief/provenance/builder.py +841 -0
- multi_agent_brief/provenance/contract.py +21 -0
- multi_agent_brief/provenance/io.py +144 -0
- multi_agent_brief/provenance/model.py +110 -0
- multi_agent_brief/provenance/references.py +43 -0
- multi_agent_brief/provenance/validator.py +135 -0
- multi_agent_brief/quality_gates/__init__.py +19 -0
- multi_agent_brief/quality_gates/contract.py +581 -0
- multi_agent_brief/quality_gates/state.py +2498 -0
- multi_agent_brief/repair/__init__.py +5 -0
- multi_agent_brief/repair/router.py +842 -0
- multi_agent_brief/runtime_assets.py +431 -0
- multi_agent_brief/sources/__init__.py +16 -0
- multi_agent_brief/sources/api_filings.py +236 -0
- multi_agent_brief/sources/api_news.py +174 -0
- multi_agent_brief/sources/base.py +142 -0
- multi_agent_brief/sources/cached_package.py +119 -0
- multi_agent_brief/sources/cli_provider.py +263 -0
- multi_agent_brief/sources/coverage.py +336 -0
- multi_agent_brief/sources/decider.py +756 -0
- multi_agent_brief/sources/doctor.py +373 -0
- multi_agent_brief/sources/evidence_pack.py +364 -0
- multi_agent_brief/sources/feishu_provider.py +326 -0
- multi_agent_brief/sources/filing_resolver.py +400 -0
- multi_agent_brief/sources/industry_packs.py +130 -0
- multi_agent_brief/sources/join.py +206 -0
- multi_agent_brief/sources/local_signal.py +81 -0
- multi_agent_brief/sources/local_signal_planner.py +636 -0
- multi_agent_brief/sources/manual.py +259 -0
- multi_agent_brief/sources/mcp_provider.py +309 -0
- multi_agent_brief/sources/mineru_provider.py +601 -0
- multi_agent_brief/sources/normalizer.py +95 -0
- multi_agent_brief/sources/opencli_provider.py +282 -0
- multi_agent_brief/sources/planner.py +178 -0
- multi_agent_brief/sources/registry.py +367 -0
- multi_agent_brief/sources/rss.py +190 -0
- multi_agent_brief/sources/search_backends/__init__.py +31 -0
- multi_agent_brief/sources/search_backends/base.py +51 -0
- multi_agent_brief/sources/search_backends/brave.py +192 -0
- multi_agent_brief/sources/search_backends/capabilities.py +94 -0
- multi_agent_brief/sources/search_backends/exa.py +180 -0
- multi_agent_brief/sources/search_backends/firecrawl.py +164 -0
- multi_agent_brief/sources/search_backends/serper.py +241 -0
- multi_agent_brief/sources/search_backends/tavily.py +124 -0
- multi_agent_brief/sources/sourcehub.py +505 -0
- multi_agent_brief/sources/web_search.py +267 -0
- multi_agent_brief/status.py +966 -0
- multi_agent_brief/tools/__init__.py +3 -0
- multi_agent_brief/tools/draft_cleanup.py +198 -0
- multi_agent_brief/workbuddy/__init__.py +1 -0
- multi_agent_brief/workbuddy/diagnose.py +569 -0
- multi_agent_brief/workbuddy/skill_pack.py +309 -0
- multi_agent_brief/workspace/__init__.py +1 -0
- multi_agent_brief/workspace/init_profile.py +45 -0
|
@@ -0,0 +1,471 @@
|
|
|
1
|
+
from __future__ import annotations
|
|
2
|
+
|
|
3
|
+
from datetime import date, datetime
|
|
4
|
+
import re
|
|
5
|
+
|
|
6
|
+
from multi_agent_brief.audit.redaction import scan_redaction_risks
|
|
7
|
+
from multi_agent_brief.audit.interfaces import AuditAgentInterface
|
|
8
|
+
from multi_agent_brief.audit.rule_packs import tag_finding
|
|
9
|
+
from multi_agent_brief.core.citations import SRC_REF_PATTERN
|
|
10
|
+
from multi_agent_brief.core.claim_ledger import ClaimLedger
|
|
11
|
+
from multi_agent_brief.core.schemas import AuditFinding, AuditReport, PipelineContext
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
NUMBER_PATTERN = re.compile(r"(\$[\d,.]+|[\d,.]+%|\b\d+(?:\.\d+)?\s?(?:GW|GWh|MW|MWh|million|billion)\b)")
|
|
15
|
+
HEADING_PATTERN = re.compile(r"^(#{1,6})\s+(.+?)\s*#*\s*$")
|
|
16
|
+
SOURCE_REFERENCE_SECTION_TITLES = {
|
|
17
|
+
"bibliography",
|
|
18
|
+
"data sources",
|
|
19
|
+
"references",
|
|
20
|
+
"source appendix",
|
|
21
|
+
"source list",
|
|
22
|
+
"sources",
|
|
23
|
+
"sources cited",
|
|
24
|
+
"works cited",
|
|
25
|
+
}
|
|
26
|
+
SOURCE_REFERENCE_SECTION_KEYWORDS = (
|
|
27
|
+
re.compile(r"(数据来源|资料来源|参考资料|参考来源|参考文献|来源附录)"),
|
|
28
|
+
)
|
|
29
|
+
|
|
30
|
+
|
|
31
|
+
def _tag(finding_type: str, **kwargs) -> AuditFinding:
|
|
32
|
+
"""Create an AuditFinding with taxonomy tags from the rule pack."""
|
|
33
|
+
tax = tag_finding(finding_type)
|
|
34
|
+
return AuditFinding(
|
|
35
|
+
finding_type=finding_type,
|
|
36
|
+
blocking_level=tax["blocking_level"],
|
|
37
|
+
repair_owner=tax["repair_owner"],
|
|
38
|
+
**kwargs,
|
|
39
|
+
)
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
def parse_date(value: str) -> date | None:
|
|
43
|
+
if not value:
|
|
44
|
+
return None
|
|
45
|
+
text = value.strip()
|
|
46
|
+
for fmt, width in (("%Y-%m-%d", 10), ("%Y%m%d", 8)):
|
|
47
|
+
try:
|
|
48
|
+
return datetime.strptime(text[:width], fmt).date()
|
|
49
|
+
except ValueError:
|
|
50
|
+
continue
|
|
51
|
+
try:
|
|
52
|
+
return datetime.fromisoformat(text.replace("Z", "+00:00")).date()
|
|
53
|
+
except ValueError:
|
|
54
|
+
return None
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
def extract_src_refs(markdown: str) -> list[dict]:
|
|
58
|
+
refs: list[dict] = []
|
|
59
|
+
for line_number, line in enumerate(markdown.splitlines(), start=1):
|
|
60
|
+
for match in SRC_REF_PATTERN.finditer(line):
|
|
61
|
+
refs.append({"claim_id": match.group(1), "line_number": line_number, "line": line.strip()})
|
|
62
|
+
return refs
|
|
63
|
+
|
|
64
|
+
|
|
65
|
+
def _heading_level(line: str) -> int | None:
|
|
66
|
+
match = HEADING_PATTERN.match(line.strip())
|
|
67
|
+
if not match:
|
|
68
|
+
return None
|
|
69
|
+
return len(match.group(1))
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
def _plain_heading_text(line: str) -> str:
|
|
73
|
+
match = HEADING_PATTERN.match(line.strip())
|
|
74
|
+
if not match:
|
|
75
|
+
return ""
|
|
76
|
+
text = match.group(2).strip()
|
|
77
|
+
text = re.sub(r"[*_`]+", "", text)
|
|
78
|
+
text = re.sub(r"^\d+(?:\.\d+)*[.)、.]?\s*", "", text)
|
|
79
|
+
text = re.sub(r"^[一二三四五六七八九十]+[、..]\s*", "", text)
|
|
80
|
+
return text.strip(" \t:-—–:")
|
|
81
|
+
|
|
82
|
+
|
|
83
|
+
def _source_reference_section_level(line: str) -> int | None:
|
|
84
|
+
level = _heading_level(line)
|
|
85
|
+
if level is None:
|
|
86
|
+
return None
|
|
87
|
+
heading = _plain_heading_text(line)
|
|
88
|
+
english_heading = re.sub(r"\s+", " ", heading.casefold())
|
|
89
|
+
if english_heading in SOURCE_REFERENCE_SECTION_TITLES:
|
|
90
|
+
return level
|
|
91
|
+
if any(pattern.search(heading) for pattern in SOURCE_REFERENCE_SECTION_KEYWORDS):
|
|
92
|
+
return level
|
|
93
|
+
return None
|
|
94
|
+
|
|
95
|
+
|
|
96
|
+
def run_deterministic_audit(
|
|
97
|
+
markdown: str,
|
|
98
|
+
ledger: ClaimLedger,
|
|
99
|
+
*,
|
|
100
|
+
report_date: str = "",
|
|
101
|
+
max_source_age_days: int | None = None,
|
|
102
|
+
fail_on_stale_source: bool = False,
|
|
103
|
+
) -> AuditReport:
|
|
104
|
+
findings: list[AuditFinding] = []
|
|
105
|
+
refs = extract_src_refs(markdown)
|
|
106
|
+
referenced_ids = {ref["claim_id"] for ref in refs}
|
|
107
|
+
|
|
108
|
+
for ref in refs:
|
|
109
|
+
if ledger.get_claim(ref["claim_id"]) is None:
|
|
110
|
+
findings.append(
|
|
111
|
+
_tag(
|
|
112
|
+
"missing_claim",
|
|
113
|
+
finding_id=f"ORPHAN_{len(findings)+1:03d}",
|
|
114
|
+
severity="high",
|
|
115
|
+
related_claim_id=ref["claim_id"],
|
|
116
|
+
line_number=ref["line_number"],
|
|
117
|
+
description=f"Referenced claim_id {ref['claim_id']} was not found in the Claim Ledger.",
|
|
118
|
+
recommendation="Remove the reference or add the supporting claim to the ledger.",
|
|
119
|
+
evidence=ref["line"],
|
|
120
|
+
)
|
|
121
|
+
)
|
|
122
|
+
|
|
123
|
+
source_reference_section_level: int | None = None
|
|
124
|
+
for line_number, line in enumerate(markdown.splitlines(), start=1):
|
|
125
|
+
heading_level = _heading_level(line)
|
|
126
|
+
if heading_level is not None and source_reference_section_level is not None:
|
|
127
|
+
if heading_level <= source_reference_section_level:
|
|
128
|
+
source_reference_section_level = None
|
|
129
|
+
section_level = _source_reference_section_level(line)
|
|
130
|
+
if section_level is not None:
|
|
131
|
+
source_reference_section_level = section_level
|
|
132
|
+
continue
|
|
133
|
+
if source_reference_section_level is not None:
|
|
134
|
+
continue
|
|
135
|
+
if not line.strip() or line.startswith("#"):
|
|
136
|
+
continue
|
|
137
|
+
if SRC_REF_PATTERN.search(line):
|
|
138
|
+
continue
|
|
139
|
+
for match in NUMBER_PATTERN.finditer(line):
|
|
140
|
+
findings.append(
|
|
141
|
+
_tag(
|
|
142
|
+
"number_without_source",
|
|
143
|
+
finding_id=f"NUMBER_{len(findings)+1:03d}",
|
|
144
|
+
severity="medium",
|
|
145
|
+
line_number=line_number,
|
|
146
|
+
description=f"Number-like value '{match.group(1)}' appears without a source reference on the same line.",
|
|
147
|
+
recommendation="Attach a [src:<claim_id>] reference using a real Claim Ledger ID or remove the unsupported number.",
|
|
148
|
+
evidence=line.strip(),
|
|
149
|
+
)
|
|
150
|
+
)
|
|
151
|
+
|
|
152
|
+
for claim in ledger.detect_missing_sources():
|
|
153
|
+
findings.append(
|
|
154
|
+
_tag(
|
|
155
|
+
"missing_source",
|
|
156
|
+
finding_id=f"SOURCE_{len(findings)+1:03d}",
|
|
157
|
+
severity="high",
|
|
158
|
+
related_claim_id=claim.claim_id,
|
|
159
|
+
description="A claim requires audit but is missing source_id or evidence_text.",
|
|
160
|
+
recommendation="Add source metadata and evidence text before using the claim.",
|
|
161
|
+
evidence=claim.statement,
|
|
162
|
+
)
|
|
163
|
+
)
|
|
164
|
+
|
|
165
|
+
for duplicate_group in ledger.detect_duplicate_claims():
|
|
166
|
+
findings.append(
|
|
167
|
+
_tag(
|
|
168
|
+
"duplicate_claim",
|
|
169
|
+
finding_id=f"DUP_{len(findings)+1:03d}",
|
|
170
|
+
severity="low",
|
|
171
|
+
related_claim_id=duplicate_group[0].claim_id,
|
|
172
|
+
description=f"Duplicate claim statements found: {', '.join(claim.claim_id for claim in duplicate_group)}.",
|
|
173
|
+
recommendation="Merge duplicate claims or clarify their separate source contexts.",
|
|
174
|
+
evidence=duplicate_group[0].statement,
|
|
175
|
+
)
|
|
176
|
+
)
|
|
177
|
+
|
|
178
|
+
report_day = parse_date(report_date)
|
|
179
|
+
web_search_missing_date_count = 0
|
|
180
|
+
if report_day and max_source_age_days is not None:
|
|
181
|
+
for claim in ledger:
|
|
182
|
+
published_at = str(claim.metadata.get("published_at", ""))
|
|
183
|
+
source_day = parse_date(published_at)
|
|
184
|
+
if source_day is None:
|
|
185
|
+
# web_search sources often lack published_at — flag it at low severity (B15)
|
|
186
|
+
if claim.source_type == "web_search":
|
|
187
|
+
findings.append(
|
|
188
|
+
_tag(
|
|
189
|
+
"missing_source_date",
|
|
190
|
+
finding_id=f"DATE_{len(findings)+1:03d}",
|
|
191
|
+
severity="low",
|
|
192
|
+
related_claim_id=claim.claim_id,
|
|
193
|
+
description="Web search claim is missing a parseable published_at date.",
|
|
194
|
+
recommendation="Mark the source as retrieved_only or provide published_at.",
|
|
195
|
+
evidence=claim.statement,
|
|
196
|
+
)
|
|
197
|
+
)
|
|
198
|
+
web_search_missing_date_count += 1
|
|
199
|
+
else:
|
|
200
|
+
findings.append(
|
|
201
|
+
_tag(
|
|
202
|
+
"missing_source_date",
|
|
203
|
+
finding_id=f"DATE_{len(findings)+1:03d}",
|
|
204
|
+
severity="medium",
|
|
205
|
+
related_claim_id=claim.claim_id,
|
|
206
|
+
description="Claim source is missing a parseable published_at date for reporting-window audit.",
|
|
207
|
+
recommendation="Add source published_at metadata or mark the source as evergreen/background.",
|
|
208
|
+
evidence=claim.statement,
|
|
209
|
+
)
|
|
210
|
+
)
|
|
211
|
+
continue
|
|
212
|
+
age_days = (report_day - source_day).days
|
|
213
|
+
if age_days > max_source_age_days:
|
|
214
|
+
findings.append(
|
|
215
|
+
_tag(
|
|
216
|
+
"stale_source",
|
|
217
|
+
finding_id=f"STALE_{len(findings)+1:03d}",
|
|
218
|
+
severity="high" if fail_on_stale_source else "medium",
|
|
219
|
+
related_claim_id=claim.claim_id,
|
|
220
|
+
description=(
|
|
221
|
+
f"Source date {source_day.isoformat()} is {age_days} days before report date "
|
|
222
|
+
f"{report_day.isoformat()}, exceeding the {max_source_age_days}-day reporting window."
|
|
223
|
+
),
|
|
224
|
+
recommendation="Remove this item from the weekly brief or recast it as dated background.",
|
|
225
|
+
evidence=claim.statement,
|
|
226
|
+
)
|
|
227
|
+
)
|
|
228
|
+
|
|
229
|
+
for risk in scan_redaction_risks(markdown + "\n" + "\n".join(claim.evidence_text for claim in ledger)):
|
|
230
|
+
findings.append(
|
|
231
|
+
_tag(
|
|
232
|
+
"redaction_risk",
|
|
233
|
+
finding_id=f"REDACT_{len(findings)+1:03d}",
|
|
234
|
+
severity="high" if risk["severity"] == "high" else "medium",
|
|
235
|
+
description=f"Potential {risk['type']} detected.",
|
|
236
|
+
recommendation=risk["recommendation"],
|
|
237
|
+
evidence=risk["text"],
|
|
238
|
+
)
|
|
239
|
+
)
|
|
240
|
+
|
|
241
|
+
# Epistemic gate checks (Claim Schema v2)
|
|
242
|
+
for claim in ledger:
|
|
243
|
+
if claim.epistemic_type == "hypothesis" and claim.confidence == "high":
|
|
244
|
+
findings.append(
|
|
245
|
+
_tag(
|
|
246
|
+
"hypothesis_high_confidence",
|
|
247
|
+
finding_id=f"EPISTEMIC_{len(findings)+1:03d}",
|
|
248
|
+
severity="high",
|
|
249
|
+
related_claim_id=claim.claim_id,
|
|
250
|
+
description="Hypothesis claim is presented with high confidence — hypotheses should not be treated as certain facts.",
|
|
251
|
+
recommendation="Lower confidence to medium/low or reclassify as observed.",
|
|
252
|
+
evidence=claim.statement,
|
|
253
|
+
)
|
|
254
|
+
)
|
|
255
|
+
if claim.epistemic_type == "action" and not claim.applicability_reason.strip():
|
|
256
|
+
findings.append(
|
|
257
|
+
_tag(
|
|
258
|
+
"action_without_basis",
|
|
259
|
+
finding_id=f"EPISTEMIC_{len(findings)+1:03d}",
|
|
260
|
+
severity="high",
|
|
261
|
+
related_claim_id=claim.claim_id,
|
|
262
|
+
description="Action claim lacks applicability rationale — actions must justify why they apply here.",
|
|
263
|
+
recommendation="Add applicability_reason explaining why this action is relevant.",
|
|
264
|
+
evidence=claim.statement,
|
|
265
|
+
)
|
|
266
|
+
)
|
|
267
|
+
if claim.epistemic_type == "analogy" and not claim.limitations:
|
|
268
|
+
findings.append(
|
|
269
|
+
_tag(
|
|
270
|
+
"analogy_without_limitations",
|
|
271
|
+
finding_id=f"EPISTEMIC_{len(findings)+1:03d}",
|
|
272
|
+
severity="medium",
|
|
273
|
+
related_claim_id=claim.claim_id,
|
|
274
|
+
description="Analogy claim has no stated limitations — analogies must declare where they break down.",
|
|
275
|
+
recommendation="Add limitations describing where the analogy does not hold.",
|
|
276
|
+
evidence=claim.statement,
|
|
277
|
+
)
|
|
278
|
+
)
|
|
279
|
+
if claim.epistemic_type == "analogy" and claim.evidence_relation == "direct":
|
|
280
|
+
findings.append(
|
|
281
|
+
_tag(
|
|
282
|
+
"analogy_direct_relation",
|
|
283
|
+
finding_id=f"EPISTEMIC_{len(findings)+1:03d}",
|
|
284
|
+
severity="high",
|
|
285
|
+
related_claim_id=claim.claim_id,
|
|
286
|
+
description="Analogy claim uses 'direct' evidence relation — analogies should use indirect or analogous relation.",
|
|
287
|
+
recommendation="Change evidence_relation to 'indirect' or 'analogous'.",
|
|
288
|
+
evidence=claim.statement,
|
|
289
|
+
)
|
|
290
|
+
)
|
|
291
|
+
|
|
292
|
+
unused_claims = [claim.claim_id for claim in ledger if claim.claim_id not in referenced_ids]
|
|
293
|
+
metadata = {
|
|
294
|
+
"refs_extracted": len(refs),
|
|
295
|
+
"unique_refs": len(referenced_ids),
|
|
296
|
+
"ledger_claims": len(ledger),
|
|
297
|
+
"unused_claims": unused_claims,
|
|
298
|
+
"report_date": report_date,
|
|
299
|
+
"max_source_age_days": max_source_age_days,
|
|
300
|
+
"fail_on_stale_source": fail_on_stale_source,
|
|
301
|
+
"web_search_missing_published_at": web_search_missing_date_count,
|
|
302
|
+
}
|
|
303
|
+
high = sum(1 for finding in findings if finding.severity == "high")
|
|
304
|
+
medium = sum(1 for finding in findings if finding.severity == "medium")
|
|
305
|
+
if high:
|
|
306
|
+
status = "fail"
|
|
307
|
+
elif medium:
|
|
308
|
+
status = "warning"
|
|
309
|
+
else:
|
|
310
|
+
status = "pass"
|
|
311
|
+
score = max(0, 100 - high * 25 - medium * 10 - (len(findings) - high - medium) * 3)
|
|
312
|
+
return AuditReport(audit_status=status, audit_score=score, findings=findings, metadata=metadata)
|
|
313
|
+
|
|
314
|
+
|
|
315
|
+
class DeterministicAuditAgent(AuditAgentInterface):
|
|
316
|
+
name = "deterministic-auditor"
|
|
317
|
+
|
|
318
|
+
def run_audit(
|
|
319
|
+
self,
|
|
320
|
+
markdown: str,
|
|
321
|
+
ledger: ClaimLedger,
|
|
322
|
+
context: PipelineContext | None = None,
|
|
323
|
+
) -> AuditReport:
|
|
324
|
+
report = run_deterministic_audit(
|
|
325
|
+
markdown,
|
|
326
|
+
ledger,
|
|
327
|
+
report_date=context.report_date if context else "",
|
|
328
|
+
max_source_age_days=context.max_source_age_days if context else None,
|
|
329
|
+
fail_on_stale_source=context.fail_on_stale_source if context else False,
|
|
330
|
+
)
|
|
331
|
+
|
|
332
|
+
# Local signal audit checks — only when local signal discovery is configured
|
|
333
|
+
if context:
|
|
334
|
+
local_signal_report = context.metadata.get("local_signal_report")
|
|
335
|
+
discovery = context.metadata.get("source_discovery", {})
|
|
336
|
+
has_local_signal = bool(
|
|
337
|
+
local_signal_report
|
|
338
|
+
or discovery.get("local_signal_discovery", {}).get("enabled", False)
|
|
339
|
+
)
|
|
340
|
+
if has_local_signal:
|
|
341
|
+
local_findings = _check_local_signal_claims(markdown, ledger, context)
|
|
342
|
+
report.findings.extend(local_findings)
|
|
343
|
+
if local_findings:
|
|
344
|
+
from multi_agent_brief.audit.interfaces import recompute_report_status
|
|
345
|
+
recompute_report_status(report)
|
|
346
|
+
|
|
347
|
+
return report
|
|
348
|
+
|
|
349
|
+
|
|
350
|
+
# ── Local Signal Audit Checks ────────────────────────────────────────
|
|
351
|
+
|
|
352
|
+
# Patterns that indicate consumer pain-point claims
|
|
353
|
+
# Chinese patterns — no case distinction
|
|
354
|
+
_CONSUMER_PAIN_PATTERNS_ZH = [
|
|
355
|
+
re.compile(r"消费者(?:认为|抱怨|普遍|反馈|觉得|表示)"),
|
|
356
|
+
re.compile(r"用户(?:抱怨|觉得|认为|反馈|评价|普遍)"),
|
|
357
|
+
re.compile(r"市场反馈(?:显示|表明|指出)"),
|
|
358
|
+
re.compile(r"用户评价(?:显示|表明)"),
|
|
359
|
+
]
|
|
360
|
+
|
|
361
|
+
# English patterns — case insensitive
|
|
362
|
+
_CONSUMER_PAIN_PATTERNS_EN = [
|
|
363
|
+
re.compile(r"consumers?\s+\w*\s*(?:report|complain|believe|feel|say|indicate)", re.IGNORECASE),
|
|
364
|
+
re.compile(r"users?\s+\w*\s*(?:complain|report|feel|believe|commonly)", re.IGNORECASE),
|
|
365
|
+
re.compile(r"market\s+feedback\s+(?:shows|indicates|suggests)", re.IGNORECASE),
|
|
366
|
+
re.compile(r"customer\s+(?:complaints?|feedback|reviews?)\s+(?:show|indicate|suggest)", re.IGNORECASE),
|
|
367
|
+
]
|
|
368
|
+
|
|
369
|
+
_CONSUMER_PAIN_PATTERNS = _CONSUMER_PAIN_PATTERNS_ZH + _CONSUMER_PAIN_PATTERNS_EN
|
|
370
|
+
|
|
371
|
+
# Source types that count as consumer-level evidence
|
|
372
|
+
_CONSUMER_SOURCE_TYPES = {"local_signal", "consumer_discussion", "platform_data"}
|
|
373
|
+
|
|
374
|
+
|
|
375
|
+
def _check_local_signal_claims(
|
|
376
|
+
markdown: str,
|
|
377
|
+
ledger: ClaimLedger,
|
|
378
|
+
context: PipelineContext,
|
|
379
|
+
) -> list[AuditFinding]:
|
|
380
|
+
"""Check local signal audit rules.
|
|
381
|
+
|
|
382
|
+
LOCAL_SIGNAL_CLAIM_001: Consumer pain-point claims require consumer-level sources.
|
|
383
|
+
LOCAL_SIGNAL_PROVENANCE_001: Local signal claims require sample metadata.
|
|
384
|
+
LOCAL_SIGNAL_PRIVACY_001: Personal data must not enter final brief.
|
|
385
|
+
"""
|
|
386
|
+
findings: list[AuditFinding] = []
|
|
387
|
+
|
|
388
|
+
# LOCAL_SIGNAL_CLAIM_001: Check for consumer pain-point claims without consumer sources
|
|
389
|
+
for line_num, line in enumerate(markdown.splitlines(), start=1):
|
|
390
|
+
if not line.strip() or line.startswith("#"):
|
|
391
|
+
continue
|
|
392
|
+
for pattern in _CONSUMER_PAIN_PATTERNS:
|
|
393
|
+
if pattern.search(line):
|
|
394
|
+
# Check if this line has a source reference to a consumer-level claim
|
|
395
|
+
src_refs = SRC_REF_PATTERN.findall(line)
|
|
396
|
+
has_consumer_source = False
|
|
397
|
+
for claim_id in src_refs:
|
|
398
|
+
claim = ledger.get_claim(claim_id)
|
|
399
|
+
if claim and claim.source_type in _CONSUMER_SOURCE_TYPES:
|
|
400
|
+
has_consumer_source = True
|
|
401
|
+
break
|
|
402
|
+
# Also check metadata for source_family
|
|
403
|
+
if claim and claim.metadata.get("source_family") == "local_signal":
|
|
404
|
+
has_consumer_source = True
|
|
405
|
+
break
|
|
406
|
+
|
|
407
|
+
if not has_consumer_source:
|
|
408
|
+
findings.append(
|
|
409
|
+
_tag(
|
|
410
|
+
"local_signal_unsupported_claim",
|
|
411
|
+
finding_id=f"LOCAL_SIGNAL_CLAIM_{len(findings)+1:03d}",
|
|
412
|
+
severity="high",
|
|
413
|
+
line_number=line_num,
|
|
414
|
+
description=(
|
|
415
|
+
"Consumer pain-point claim appears without consumer-level "
|
|
416
|
+
"or platform-data source support. External trend articles "
|
|
417
|
+
"cannot support specific consumer sentiment claims."
|
|
418
|
+
),
|
|
419
|
+
recommendation=(
|
|
420
|
+
"Add consumer-discussion or platform-data sources, "
|
|
421
|
+
"or reframe as external trend observation."
|
|
422
|
+
),
|
|
423
|
+
evidence=line.strip(),
|
|
424
|
+
)
|
|
425
|
+
)
|
|
426
|
+
break # Only one finding per line
|
|
427
|
+
|
|
428
|
+
# LOCAL_SIGNAL_PROVENANCE_001: Check local signal claims have required metadata
|
|
429
|
+
for claim in ledger:
|
|
430
|
+
if claim.source_type == "local_signal" or claim.metadata.get("source_family") == "local_signal":
|
|
431
|
+
required_meta = ["platform", "market", "collected_at", "access_level", "sample_type", "collector"]
|
|
432
|
+
missing = [k for k in required_meta if not claim.metadata.get(k)]
|
|
433
|
+
if missing:
|
|
434
|
+
findings.append(
|
|
435
|
+
_tag(
|
|
436
|
+
"local_signal_missing_provenance",
|
|
437
|
+
finding_id=f"LOCAL_SIGNAL_PROV_{len(findings)+1:03d}",
|
|
438
|
+
severity="medium",
|
|
439
|
+
related_claim_id=claim.claim_id,
|
|
440
|
+
description=(
|
|
441
|
+
f"Local signal claim {claim.claim_id} is missing required "
|
|
442
|
+
f"sample metadata: {', '.join(missing)}"
|
|
443
|
+
),
|
|
444
|
+
recommendation="Add sample metadata (platform, market, collected_at, etc.) to the claim.",
|
|
445
|
+
evidence=claim.statement,
|
|
446
|
+
)
|
|
447
|
+
)
|
|
448
|
+
|
|
449
|
+
# LOCAL_SIGNAL_PRIVACY_001: Check for personal data in local signal claims
|
|
450
|
+
for claim in ledger:
|
|
451
|
+
is_local_signal = (
|
|
452
|
+
claim.source_type == "local_signal"
|
|
453
|
+
or claim.metadata.get("source_family") == "local_signal"
|
|
454
|
+
)
|
|
455
|
+
if is_local_signal and claim.metadata.get("contains_personal_data", False):
|
|
456
|
+
findings.append(
|
|
457
|
+
_tag(
|
|
458
|
+
"local_signal_privacy_violation",
|
|
459
|
+
finding_id=f"LOCAL_SIGNAL_PRIV_{len(findings)+1:03d}",
|
|
460
|
+
severity="high",
|
|
461
|
+
related_claim_id=claim.claim_id,
|
|
462
|
+
description=(
|
|
463
|
+
f"Claim {claim.claim_id} is marked as containing personal data "
|
|
464
|
+
f"and must not appear in the final brief."
|
|
465
|
+
),
|
|
466
|
+
recommendation="Remove this claim or redact personal data before including in brief.",
|
|
467
|
+
evidence=claim.statement,
|
|
468
|
+
)
|
|
469
|
+
)
|
|
470
|
+
|
|
471
|
+
return findings
|