critical_path_validator

io.github.danafitkowski/cpp-cpm-engine · Verify this server

Critical-path validation, logic health, and DCMA-14 assessment of a Primavera P6 schedule. Runs the CPP critical-path validator: checks for false criticality, constraint-driven CP segments, open ends, broken logic, and surfaces a DCMA-14 block with the 14 metrics (logic, leads, lags, FS%, hard constraints, high float, high duration, invalid dates, resources, missed tasks, critical tasks, CPLI, BEI, etc.) at the chosen profile threshold (commercial / nuclear / mining). When ``baseline_xer_path`` is supplied, BEI (Baseline Execution Index) is computed. Use this tool to grade a schedule's logic health and find what should be fixed before forensic analysis. For the full HTML health-dashboard PDF render, use ``dcma14_health_check``. Args: xer_path: server-side path to the schedule XER. xer_content: full text of the schedule XER (alternative for hosted/remote use). Supply EXACTLY ONE of path/content. project_index: which project to analyze in a multi-project XER (0 = first/primary; default). profile: DCMA threshold profile - 'commercial' (default), 'nuclear', 'mining'. baseline_xer_path: optional server-side baseline XER for DCMA BEI. baseline_xer_content: optional baseline XER text content (alternative). Returns: Full validator result dict including: - 'project_name', 'data_date', 'analysis_timestamp' - 'total_activities', 'complete', activity counts - 'critical_path_findings': list of issues - 'logic_findings', 'constraint_findings' - 'overall_rating' / 'overall_score' / 'overall_confidence': LOGIC-HEALTH verdict only (open ends, logic continuity, critical-path correctness, constraints, lags). NOT a full schedule-health verdict. - 'overall_rating_scope': always 'logic_health'; 'overall_rating_label': 'Logic Health'. Use these so the headline cannot be read as full DCMA schedule-health. - 'dcma_worst_severity': the embedded DCMA-14 worst severity (BLOCK/RED/WARN/INFO/PASS) surfaced at the top level so a DCMA hard stop is visible next to the logic-health rating rather than buried in dcma_14.report.summary. - 'dcma_blocks_despite_logic_rating': True when DCMA-14 says BLOCK/RED even if the logic-health headline reads GREEN/AMBER. - 'dcma_14': dict of 14 DCMA metric results - 'recommendations': list of remediation suggestions