PyPI - briefloop - Versions diffs - 0.11.12__py3-none-any.whl - Mend

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

multi_agent_brief/configs/artifact_contracts.yaml ADDED Viewed

@@ -0,0 +1,514 @@
+schema_version: multi-agent-brief-artifact-contracts/v1
+artifact_contract:
+  status_values:
+    - expected
+    - missing
+    - present
+    - valid
+    - invalid
+    - blocked
+  provenance_ready_fields:
+    - artifact_id
+    - path
+    - producer_stage
+    - producer_role
+    - consumer_stages
+    - validation_result
+    - blocking_reason
+    - allowed_decisions
+    - retry_or_human_review_decision
+  producer_kind_values:
+    - workflow_stage
+    - control_tool
+  edge_direction_notes:
+    artifact_derived_from: "from is the derived/output artifact; to is the source/input artifact."
+artifacts:
+  - artifact_id: source_candidates
+    path: source_candidates.yaml
+    format: yaml
+    required: false
+    producer_stage: source-discovery
+    producer_role: source-planner
+    consumer_stages: []
+    validation_result: reference_only
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: input_classification
+    path: output/input_classification.json
+    format: json
+    required: false
+    producer_stage: input-governance
+    producer_role: python_tool
+    consumer_stages:
+      - scout
+      - analyst
+      - editor
+    validation_result: reference_only
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: retry_stage
+  - artifact_id: source_evidence_pack_manifest
+    path: output/intermediate/source_evidence_pack_manifest.json
+    format: json
+    required: false
+    producer_kind: control_tool
+    producer_stage: source-discovery
+    producer_role: python_tool
+    consumer_stages:
+      - scout
+      - claim-ledger
+      - finalize
+    validation_result: experimental_source_evidence_pack_manifest
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: candidate_claims
+    path: output/intermediate/candidate_claims.json
+    format: json
+    required: true
+    producer_stage: scout
+    producer_role: scout
+    consumer_stages:
+      - screener
+    validation_result: reference_only
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: retry_stage
+  - artifact_id: screened_candidates
+    path: output/intermediate/screened_candidates.json
+    format: json
+    required: true
+    producer_stage: screener
+    producer_role: screener
+    consumer_stages:
+      - claim-ledger
+    validation_result: reference_only
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: retry_stage
+  - artifact_id: claim_ledger
+    path: output/intermediate/claim_ledger.json
+    format: json
+    required: true
+    producer_stage: claim-ledger
+    producer_role: claim-ledger
+    consumer_stages:
+      - analyst
+      - auditor
+    validation_result: reference_only
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: claim_drafts
+    path: output/intermediate/claim_drafts.json
+    format: json
+    required: false
+    producer_stage: claim-ledger
+    producer_role: claim-ledger
+    consumer_stages: []
+    validation_result: experimental_freeze_input
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: atomic_claim_graph
+    path: output/intermediate/atomic_claim_graph.json
+    format: json
+    required: false
+    producer_stage: claim-ledger
+    producer_role: claim-ledger
+    consumer_stages: []
+    validation_result: experimental_atomic_claim_graph_schema
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: evidence_span_registry
+    path: output/intermediate/evidence_span_registry.json
+    format: json
+    required: false
+    producer_stage: claim-ledger
+    producer_role: claim-ledger
+    consumer_stages: []
+    validation_result: experimental_evidence_span_registry_schema
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: evidence_extract_source_lock
+    path: output/intermediate/evidence_extract_source_lock.json
+    format: json
+    required: false
+    producer_kind: control_tool
+    producer_stage: source-discovery
+    producer_role: python_tool
+    consumer_stages:
+      - scout
+      - claim-ledger
+      - finalize
+    validation_result: experimental_evidence_extract_source_lock
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: evidence_extract_page_inventory
+    path: output/intermediate/evidence_extract_page_inventory.json
+    format: json
+    required: false
+    producer_kind: control_tool
+    producer_stage: source-discovery
+    producer_role: python_tool
+    consumer_stages:
+      - scout
+      - claim-ledger
+      - finalize
+    validation_result: experimental_evidence_extract_page_inventory
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: claim_support_matrix
+    path: output/intermediate/claim_support_matrix.json
+    format: json
+    required: false
+    producer_stage: auditor
+    producer_role: auditor
+    consumer_stages: []
+    validation_result: experimental_claim_support_matrix_schema
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: semantic_assessment_report
+    path: output/intermediate/semantic_assessment_report.json
+    format: json
+    required: false
+    producer_stage: auditor
+    producer_role: auditor
+    consumer_stages: []
+    validation_result: experimental_semantic_assessment_report_schema
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: semantic_support_acceptance_ledger
+    path: output/intermediate/semantic_support_acceptance_ledger.json
+    format: json
+    required: false
+    producer_kind: control_tool
+    producer_stage: auditor
+    producer_role: python_tool
+    consumer_stages: []
+    validation_result: experimental_semantic_support_acceptance_ledger
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: human_approval_ledger
+    path: output/intermediate/human_approval_ledger.json
+    format: json
+    required: false
+    producer_kind: control_tool
+    producer_stage: finalize
+    producer_role: python_tool
+    consumer_stages: []
+    validation_result: experimental_human_approval_ledger
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: release_readiness_report
+    path: output/intermediate/release_readiness_report.json
+    format: json
+    required: false
+    producer_kind: control_tool
+    producer_stage: finalize
+    producer_role: python_tool
+    consumer_stages: []
+    validation_result: experimental_release_readiness_report
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: quality_panel
+    path: output/intermediate/quality_panel.json
+    format: json
+    required: false
+    producer_kind: control_tool
+    producer_stage: quality-panel
+    producer_role: python_tool
+    consumer_stages: []
+    validation_result: experimental_quality_panel
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: quality_summary
+    path: output/intermediate/quality_summary.md
+    format: markdown
+    required: false
+    producer_kind: control_tool
+    producer_stage: quality-panel
+    producer_role: python_tool
+    consumer_stages: []
+    validation_result: experimental_quality_summary_markdown
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: quality_panel_html
+    path: output/intermediate/quality_panel.html
+    format: html
+    required: false
+    producer_kind: control_tool
+    producer_stage: quality-panel
+    producer_role: python_tool
+    consumer_stages: []
+    validation_result: experimental_quality_panel_html
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: guidance_manifestation_report
+    path: output/intermediate/guidance_manifestation_report.json
+    format: json
+    required: false
+    producer_kind: control_tool
+    producer_stage: guidance-manifestation
+    producer_role: python_tool_or_human_import
+    consumer_stages: []
+    validation_result: experimental_guidance_manifestation_report
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: audited_brief
+    path: output/intermediate/audited_brief.md
+    format: markdown
+    required: true
+    producer_stage: editor
+    producer_role: editor
+    consumer_stages:
+      - auditor
+      - finalize
+    validation_result: reference_only
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - delegate_repair
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: delegate_repair
+  - artifact_id: analyst_draft_snapshot
+    path: output/intermediate/analyst_draft_snapshot.md
+    format: markdown
+    required: true
+    producer_kind: control_tool
+    producer_stage: analyst
+    producer_role: python_tool
+    consumer_stages:
+      - editor
+      - auditor
+    validation_result: editor_gate_snapshot
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - delegate_repair
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: delegate_repair
+  - artifact_id: audit_report
+    path: output/intermediate/audit_report.json
+    format: json
+    required: true
+    producer_stage: auditor
+    producer_role: auditor
+    consumer_stages:
+      - finalize
+    validation_result: reference_only
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - delegate_repair
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: delegate_repair
+  - artifact_id: feedback_issues
+    path: output/intermediate/feedback_issues.json
+    format: json
+    required: false
+    producer_stage: auditor
+    producer_role: python_tool_or_orchestrator
+    consumer_stages:
+      - analyst
+      - editor
+      - auditor
+      - finalize
+    validation_result: reference_only
+    blocking_reason: ""
+    allowed_decisions:
+      - delegate_repair
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: repair_plan
+    path: output/intermediate/repair_plan.json
+    format: json
+    required: false
+    producer_stage: auditor
+    producer_role: python_tool_or_orchestrator
+    consumer_stages:
+      - analyst
+      - editor
+      - auditor
+      - finalize
+    validation_result: reference_only
+    blocking_reason: ""
+    allowed_decisions:
+      - delegate_repair
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: delta_audit_report
+    path: output/intermediate/delta_audit_report.json
+    format: json
+    required: false
+    producer_stage: auditor
+    producer_role: auditor
+    consumer_stages:
+      - auditor
+      - finalize
+    validation_result: conditional_repair_only
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - retry_stage
+      - delegate_repair
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: delegate_repair
+  - artifact_id: auditor_quality_gate_report
+    path: output/intermediate/gates/auditor_quality_gate_report.json
+    format: json
+    required: false
+    producer_stage: auditor
+    producer_role: python_tool
+    consumer_stages:
+      - auditor
+      - finalize
+    validation_result: conditional_quality_gate_only
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - delegate_repair
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: finalize_quality_gate_report
+    path: output/intermediate/gates/finalize_quality_gate_report.json
+    format: json
+    required: false
+    producer_stage: finalize
+    producer_role: python_tool
+    consumer_stages:
+      - finalize
+    validation_result: conditional_quality_gate_only
+    blocking_reason: ""
+    allowed_decisions:
+      - finalize
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: provenance_graph
+    path: output/intermediate/provenance_graph.json
+    format: json
+    required: false
+    producer_kind: control_tool
+    producer_stage: provenance
+    producer_role: python_tool
+    consumer_stages:
+      - auditor
+      - finalize
+    validation_result: conditional_provenance_only
+    blocking_reason: ""
+    allowed_decisions:
+      - continue
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review
+  - artifact_id: reader_brief
+    path: output/brief.md
+    format: markdown
+    required: true
+    producer_stage: finalize
+    producer_role: python_tool
+    consumer_stages: []
+    validation_result: reference_only
+    blocking_reason: ""
+    allowed_decisions:
+      - finalize
+      - request_human_review
+      - block_run
+    retry_or_human_review_decision: request_human_review

multi_agent_brief/configs/orchestrator_contract.yaml ADDED Viewed

@@ -0,0 +1,181 @@
+schema_version: multi-agent-brief-orchestrator-contract/v1
+orchestrator:
+  role: main_agent
+  authority: runtime_controller
+  contract_references:
+    stage_specs: configs/stage_specs.yaml
+    artifact_contracts: configs/artifact_contracts.yaml
+    default_policy_pack: configs/policy_packs/default.yaml
+  responsibilities:
+    - read_workspace_context
+    - select_next_stage
+    - delegate_specialist_subagent
+    - check_expected_artifacts
+    - record_decision_summary
+    - block_unsafe_progress
+    - finalize_after_audit_readiness
+  python_layer:
+    role: tools_validators_renderers
+    examples:
+      - init
+      - sources_decide
+      - doctor
+      - inputs_classify
+      - audit
+      - finalize
+      - provenance_build
+      - controls_build_switchboard
+      - controls_select
+  developer_ci_tools:
+    - eval_cases
+contracts:
+  behavior:
+    purpose: define orchestrator and specialist role boundaries
+    first_landing: v0.6.0
+  process_artifact:
+    purpose: define stage readiness and expected artifact categories
+    first_landing: v0.6.0_reference_only
+  fact_grounding_evidence:
+    purpose: keep material statements traceable to supported claims
+    first_landing: v0.6.0_reference_only
+  quality_audience:
+    purpose: keep delivery decisions aligned with reader context
+    first_landing: v0.6.0_reference_only
+decision_vocabulary:
+  - continue
+  - retry_stage
+  - delegate_repair
+  - request_human_review
+  - block_run
+  - finalize
+decision_record_fields:
+  - decision_id
+  - stage_id
+  - decision
+  - reason_summary
+  - input_artifacts
+  - output_artifacts
+  - validation_result
+  - next_allowed_actions
+  - created_at
+runtime_surfaces:
+  - hermes
+  - claude
+  - codex
+  - codebuddy
+  - opencode
+  - operator
+  - manual
+v060_boundaries:
+  implements:
+    - shared_orchestrator_authority
+    - decision_vocabulary
+    - contract_references
+    - runtime_role_parity
+  deferred:
+    - persisted_workflow_state
+    - artifact_registry_execution
+    - feedback_repair_loop
+    - evidence_execution_graph
+    - public_safe_evaluation_cases
+v061_boundaries:
+  implements:
+    - persisted_runtime_state_control_files
+    - minimum_artifact_registry_status_check
+    - stage_scoped_blocking_summary
+    - orchestrator_decision_event_entrypoint
+  deferred:
+    - feedback_repair_loop
+    - material_fact_freshness_target_relevance_gates
+    - evidence_execution_graph
+    - public_safe_evaluation_cases
+v062_boundaries:
+  implements:
+    - feedback_issue_handling
+    - bounded_repair_planning
+    - feedback_event_trace
+    - current_stage_feedback_blocking
+  deferred:
+    - automatic_repair_execution
+    - semantic_repair_verification
+    - material_fact_freshness_target_relevance_gates
+    - evidence_execution_graph
+    - public_safe_evaluation_cases
+v063_boundaries:
+  implements:
+    - deterministic_material_fact_gate
+    - deterministic_freshness_gate
+    - deterministic_target_relevance_gate
+    - quality_gate_report_control_artifact
+    - current_stage_quality_gate_blocking
+  deferred:
+    - automatic_repair_execution
+    - semantic_truth_judgment
+    - live_market_quote_fetching
+    - automatic_source_recrawl
+    - evidence_execution_graph
+    - public_safe_evaluation_cases
+v064_boundaries:
+  implements:
+    - packaged_public_safe_evaluation_cases
+    - structured_eval_case_action_dispatch
+    - fixture_leakage_scanner
+    - gates_feedback_runtime_static_regression_cases
+  deferred:
+    - private_commercial_benchmark_suites
+    - llm_as_judge_prose_scoring
+    - automatic_repair_execution
+    - evidence_execution_graph
+v065_boundaries:
+  implements:
+    - deterministic_provenance_projection
+    - workspace_local_audit_graph
+    - provenance_graph_validation
+    - provenance_event_trace
+  deferred:
+    - semantic_truth_verification
+    - source_support_graph
+    - execution_replay
+    - workflow_dag_runtime
+    - graph_database_or_query_engine
+    - automatic_repair_execution
+v066_boundaries:
+  implements:
+    - workspace_local_audience_profile
+    - per_run_audience_profile_snapshot
+    - audience_memory_handoff_context
+    - audience_profile_snapshot_event_trace
+  deferred:
+    - automatic_profile_updates
+    - taste_based_runtime_routing
+    - audience_memory_artifact_contract
+    - provenance_graph_expansion_for_audience_memory
+v067_boundaries:
+  implements:
+    - orchestrator_control_switchboard
+    - deterministic_control_recommendations
+    - explicit_control_selection_records
+    - human_approval_selection_state
+    - control_selection_event_trace
+  deferred:
+    - automatic_control_execution
+    - smart_runtime_router
+    - automatic_source_collection
+    - automatic_repair_execution
+    - friction_store
+    - policy_pack_rewrite
+v070_boundaries:
+  implements:
+    - approved_improvement_ledger
+    - deterministic_improvement_memory_projection
+    - per_run_improvement_memory_snapshot
+    - improvement_memory_handoff_context
+    - public_safe_improvement_eval_cases
+  deferred:
+    - retrieval_memory
+    - automatic_repair_execution
+    - automatic_prompt_rewriting
+    - runtime_specific_guidance_filtering
+    - output_quality_improvement_claims
+    - friction_store
+    - ledger_compaction