Initial commit: Conflict Checker

Cross-discipline design-contradiction checker for construction drawing sets. Standalone tool broken out from Iron_Bid; a pipeline stage may later fold back into Iron_Bid. Pipeline: PDF->images -> per-sheet assertion extraction -> deterministic clustering by location -> per-cluster reasoning -> report. Includes CLI (cli/run_check.py) and web UI (backend/main.py). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-03 00:22:02 +00:00
commit 1d248a8808
@@ -0,0 +1 @@
+{"issues": [{"issue_id": "CODE-CONFLICT-001", "source_stage": "code", "category": "building_code", "severity": "high", "confidence": "high", "location": "Electrical Notes and Schedules", "disciplines": ["Architectural", "Electrical"], "sheets": ["E01.01", "E01.02"], "description": "The electrical drawings cite the 2021 edition of the IBC and IECC, which conflicts with the project's adopted codes of record listed in the project profile (2015 IBC, 2015 IECC). The entire design basis must be consistent with the codes enforced by the jurisdiction for the project to be compliant. This discrepancy must be clarified and all sheets must reference the correct, applicable code editions.", "evidence": [{"discipline": "Electrical", "sheet": "E01.01", "source_text": "CONTRACTOR SHALL CONFORM TO ALL LOCAL, STATE, AND APPLICABLE CODES, 2023 NEC, 2021 IBC, 2021 IECC, NFPA, ETC., AND ALL OTHER LOCAL CODES AND AMENDMENTS WHERE THERE ARE CONFLICTS BETWEEN CODES, STANDARDS AND DRAWINGS AND SPECIFICATIONS ARISE, THE MORE STRINGENT SHALL APPLY.", "asserted_value": "2021 IBC, 2021 IECC"}, {"discipline": "Electrical", "sheet": "E01.02", "source_text": "1. PROVIDE LOW-VOLTAGE DRY-TYPE TRANSFORMERS THAT MEET THE MINIMUM EFFICIENCY REQUIREMENTS OF 2021 IECC TABLE C405.8.", "asserted_value": "2021 IECC"}], "recommended_resolution": "Verify the applicable code editions with the Harris County Engineering Department and update all drawing references to be consistent with the adopted codes for the permit application. Ensure design elements comply with the correct (2015) code editions.", "code_reference": null}, {"issue_id": "ADA-HEAD-CLEARANCE-001", "source_stage": "code", "category": "ada", "severity": "high", "confidence": "high", "location": "Lighting Fixture Schedule / Lighting Plan", "disciplines": ["Electrical", "Architectural"], "sheets": ["E01.02", "E03.01"], "description": "Pendant light fixtures L-5 and L-6 are scheduled with a mounting height of 5'-5\" (65 inches) above the finished floor. Standard accessible routes require a minimum vertical clearance of 80 inches to prevent protruding objects from becoming hazards for all users, particularly those with vision impairments. If these fixtures are located within a path of travel, they would present a significant hazard.", "evidence": [{"discipline": "Electrical", "sheet": "E01.02", "source_text": "TYPE: L-5, DESCRIPTION: 12\" PENDANT, MOUNTING: PENDANT, NOTES: PENDANT 5'-5\" AFF", "asserted_value": "65"}, {"discipline": "Electrical", "sheet": "E01.02", "source_text": "TYPE: L-6, DESCRIPTION: 16\" PENDANT, MOUNTING: PENDANT, NOTES: PENDANT 5'-5\" AFF", "asserted_value": "65"}], "recommended_resolution": "Verify the locations of light fixture types L-5 and L-6 on the floor plan (Sheet E03.01). If they are located over any circulation path, either raise the mounting height to provide a minimum of 80 inches of clearance from the floor to the bottom of the fixture, or relocate the fixtures to be outside of circulation paths (e.g., directly over furniture or counters).", "code_reference": "ADA 206.2.4"}, {"issue_id": "MECH-INTAKE-SEPARATION-001", "source_stage": "code", "category": "building_code", "severity": "medium", "confidence": "medium", "location": "Roof", "disciplines": ["Mechanical", "Plumbing"], "sheets": ["M02.02"], "description": "The Mechanical Roof Plan indicates that a 10-foot radius of separation is required from any outdoor air intake. The plan also shows a '10\"RD VTR' (assumed to be a plumbing Vent Through Roof) which appears to be located within or very close to this 10-foot radius around an RTU. Codes require separation between sources of potential contaminants (like plumbing vents) and outdoor air intakes to prevent the introduction of noxious or harmful fumes or gases into the building's air supply.", "evidence": [{"discipline": "Mechanical", "sheet": "M02.02", "source_text": "LIMIT OF 10' RADIUS FROM ANY OUTDOOR AIR INTAKE.", "asserted_value": "120"}, {"discipline": "Mechanical", "sheet": "M02.02", "source_text": "10\"RD VTR", "asserted_value": "10"}], "recommended_resolution": "Verify the exact distance between the termination of the plumbing vent (VTR) and the edge of the nearest HVAC outdoor air intake. If the distance is less than the code-mandated 10 feet, relocate the vent or the intake to achieve compliance.", "code_reference": null}, {"issue_id": "PLUMB-CONDENSATE-001", "source_stage": "code", "category": "building_code", "severity": "medium", "confidence": "high", "location": "Mechanical Details", "disciplines": ["Mechanical", "Plumbing"], "sheets": ["M03.01"], "description": "A detail on sheet M03.01 directs HVAC condensate waste to terminate at the sanitary sewer. The International Plumbing Code (IPC) prohibits direct connections of condensate drains to the sanitary system to prevent cross-contamination. Such connections must be indirect, typically through an air gap or air break into a trapped and vented receptor.", "evidence": [{"discipline": "MechLine truncated
				`@@ -0,0 +1 @@`
				{"issues": [{"issue_id": "CODE-CONFLICT-001", "source_stage": "code", "category": "building_code", "severity": "high", "confidence": "high", "location": "Electrical Notes and Schedules", "disciplines": ["Architectural", "Electrical"], "sheets": ["E01.01", "E01.02"], "description": "The electrical drawings cite the 2021 edition of the IBC and IECC, which conflicts with the project's adopted codes of record listed in the project profile (2015 IBC, 2015 IECC). The entire design basis must be consistent with the codes enforced by the jurisdiction for the project to be compliant. This discrepancy must be clarified and all sheets must reference the correct, applicable code editions.", "evidence": [{"discipline": "Electrical", "sheet": "E01.01", "source_text": "CONTRACTOR SHALL CONFORM TO ALL LOCAL, STATE, AND APPLICABLE CODES, 2023 NEC, 2021 IBC, 2021 IECC, NFPA, ETC., AND ALL OTHER LOCAL CODES AND AMENDMENTS WHERE THERE ARE CONFLICTS BETWEEN CODES, STANDARDS AND DRAWINGS AND SPECIFICATIONS ARISE, THE MORE STRINGENT SHALL APPLY.", "asserted_value": "2021 IBC, 2021 IECC"}, {"discipline": "Electrical", "sheet": "E01.02", "source_text": "1. PROVIDE LOW-VOLTAGE DRY-TYPE TRANSFORMERS THAT MEET THE MINIMUM EFFICIENCY REQUIREMENTS OF 2021 IECC TABLE C405.8.", "asserted_value": "2021 IECC"}], "recommended_resolution": "Verify the applicable code editions with the Harris County Engineering Department and update all drawing references to be consistent with the adopted codes for the permit application. Ensure design elements comply with the correct (2015) code editions.", "code_reference": null}, {"issue_id": "ADA-HEAD-CLEARANCE-001", "source_stage": "code", "category": "ada", "severity": "high", "confidence": "high", "location": "Lighting Fixture Schedule / Lighting Plan", "disciplines": ["Electrical", "Architectural"], "sheets": ["E01.02", "E03.01"], "description": "Pendant light fixtures L-5 and L-6 are scheduled with a mounting height of 5'-5\" (65 inches) above the finished floor. Standard accessible routes require a minimum vertical clearance of 80 inches to prevent protruding objects from becoming hazards for all users, particularly those with vision impairments. If these fixtures are located within a path of travel, they would present a significant hazard.", "evidence": [{"discipline": "Electrical", "sheet": "E01.02", "source_text": "TYPE: L-5, DESCRIPTION: 12\" PENDANT, MOUNTING: PENDANT, NOTES: PENDANT 5'-5\" AFF", "asserted_value": "65"}, {"discipline": "Electrical", "sheet": "E01.02", "source_text": "TYPE: L-6, DESCRIPTION: 16\" PENDANT, MOUNTING: PENDANT, NOTES: PENDANT 5'-5\" AFF", "asserted_value": "65"}], "recommended_resolution": "Verify the locations of light fixture types L-5 and L-6 on the floor plan (Sheet E03.01). If they are located over any circulation path, either raise the mounting height to provide a minimum of 80 inches of clearance from the floor to the bottom of the fixture, or relocate the fixtures to be outside of circulation paths (e.g., directly over furniture or counters).", "code_reference": "ADA 206.2.4"}, {"issue_id": "MECH-INTAKE-SEPARATION-001", "source_stage": "code", "category": "building_code", "severity": "medium", "confidence": "medium", "location": "Roof", "disciplines": ["Mechanical", "Plumbing"], "sheets": ["M02.02"], "description": "The Mechanical Roof Plan indicates that a 10-foot radius of separation is required from any outdoor air intake. The plan also shows a '10\"RD VTR' (assumed to be a plumbing Vent Through Roof) which appears to be located within or very close to this 10-foot radius around an RTU. Codes require separation between sources of potential contaminants (like plumbing vents) and outdoor air intakes to prevent the introduction of noxious or harmful fumes or gases into the building's air supply.", "evidence": [{"discipline": "Mechanical", "sheet": "M02.02", "source_text": "LIMIT OF 10' RADIUS FROM ANY OUTDOOR AIR INTAKE.", "asserted_value": "120"}, {"discipline": "Mechanical", "sheet": "M02.02", "source_text": "10\"RD VTR", "asserted_value": "10"}], "recommended_resolution": "Verify the exact distance between the termination of the plumbing vent (VTR) and the edge of the nearest HVAC outdoor air intake. If the distance is less than the code-mandated 10 feet, relocate the vent or the intake to achieve compliance.", "code_reference": null}, {"issue_id": "PLUMB-CONDENSATE-001", "source_stage": "code", "category": "building_code", "severity": "medium", "confidence": "high", "location": "Mechanical Details", "disciplines": ["Mechanical", "Plumbing"], "sheets": ["M03.01"], "description": "A detail on sheet M03.01 directs HVAC condensate waste to terminate at the sanitary sewer. The International Plumbing Code (IPC) prohibits direct connections of condensate drains to the sanitary system to prevent cross-contamination. Such connections must be indirect, typically through an air gap or air break into a trapped and vented receptor.", "evidence": [{"discipline": "MechLine truncated