Suggest HFACS-MES classification codes for a cause description. Returns ranked suggestions with confidence scores. HFACS-MES has 5 levels: External Factors, Organizational Influences, Unsafe Supervision, Preconditions, Unsafe Acts.

Confirm an HFACS classification as correct. This helps the system learn from expert decisions and improve future suggestions. Confirmed classifications are stored as learned rules.

Get HFACS-MES framework structure and category definitions. Use this to understand the classification hierarchy and criteria.

List all learned classification rules. Shows rules that have been confirmed by experts.

Reload classification rules from YAML files. Use this after manually editing config files.

Get mapping between 6M Fishbone categories and HFACS codes. Shows how Fishbone categories (Personnel, Equipment, Material, Process, Environment, Monitoring) correspond to HFACS levels. Useful for cross-framework analysis and ensuring comprehensive coverage. Also provides Why Tree depth guidance for each category.

Start a new RCA analysis session. Creates a new session with the specified case type and title. Returns session_id for subsequent operations.

Get details of an RCA session by ID. Returns session status, current stage, and progress.

List all RCA sessions with optional filters. Returns summary of all sessions.

Archive a completed RCA session. Archived sessions are preserved but marked as inactive.

Initialize a Fishbone (Ishikawa) diagram for a session. Creates a 6M structure (Personnel, Equipment, Material, Process, Environment, Monitoring) with the problem statement as the fish head.

Add a cause to a Fishbone category. Each cause can have sub-causes, evidence, and HFACS classification.

Get the complete Fishbone diagram for a session. Returns all categories and causes in structured format.

Export Fishbone diagram in various formats. Supports Mermaid, JSON, and Markdown formats.

Ask 'Why?' to drill down into root causes using 5-Why analysis. Creates or extends a WhyChain for the session. Each call goes one level deeper (up to 5 levels). This is the CORE tool for systematic root cause reasoning.

Get the complete Why Tree (5-Why analysis chain) for a session. Shows all Why questions and answers in hierarchical format.

Mark a WhyNode as the identified root cause. This indicates the analysis has reached a fundamental cause that requires action.

Export Why Tree in various formats. Supports Mermaid (flowchart), JSON, and Markdown.

Add a directed or bidirectional causal relationship between Why nodes. Use this to capture escalation loops, feedback cycles, or mitigation links that are not visible in a simple linear 5-Why chain.

Transform a completed Why Tree into a teaching-ready lesson plan. Generates learning objectives, common pitfalls, discussion prompts, and reverse-causality questions for medical learners.

Verify causal relationship between cause and effect using the Counterfactual Testing Framework. Tests: 1) Temporality - Did cause precede effect? 2) Necessity - Would effect occur without cause? 3) Mechanism - Is there a plausible causal pathway? 4) Sufficiency - Is cause alone sufficient for effect?