src.dackar.RCA.cross_pattern.summary
====================================

.. py:module:: src.dackar.RCA.cross_pattern.summary


Attributes
----------

.. autoapisummary::

   src.dackar.RCA.cross_pattern.summary._OUTCOME_WORDING


Functions
---------

.. autoapisummary::

   src.dackar.RCA.cross_pattern.summary.format_rca_card_cross_pattern_summary
   src.dackar.RCA.cross_pattern.summary.build_manifest_cross_pattern_summary
   src.dackar.RCA.cross_pattern.summary.get_cross_pattern_attention_flags


Module Contents
---------------

.. py:data:: _OUTCOME_WORDING
   :type:  Dict[str, str]

.. py:function:: format_rca_card_cross_pattern_summary(candidate_evidences, linkage_outcome_distribution)

   Return a brief narrative string for injection into rca_card.

   Uses exact wording from §4.7 linkage_outcome table for each outcome type.
   When linked candidates exist, summarizes support posture across them.


.. py:function:: build_manifest_cross_pattern_summary(candidate_evidences, total_episodes, total_docs, total_links, links_above_threshold)

   Return structured summary for run_manifest.artifacts.

   Includes per-candidate linkage outcome and support posture breakdowns.


.. py:function:: get_cross_pattern_attention_flags(candidate_evidences, candidates, top_n_candidates = 3)

   Return attention flag strings for injection into analyst_attention_flags.

   Flags raised:
   - "conflicting" support posture on any of top_n_candidates
   - "multiple_consistent" reinforcement (positive signal) on top candidates
   - "no_data" outcome (data coverage gap) for any candidate
   - "stale" index (detected via provenance on any link)