Files
breakpilot-compliance/ai-compliance-sdk/internal/iace/hazard_patterns_cobot.go
T
Benjamin Admin 6a3e96d54c fix(iace): set-based measure-category filter + 235 pattern-author fixes
Two-part nachhaltiger fix replacing the previous "fill to 5 mitigations
no matter what" behavior that the GT-Bremse benchmark proved
unfaithful (e.g. HP1625 "scharfe Kanten" returning M005 "Rotations-
bewegung vermeiden" via category fallback; HP1651 "Wiederanlauf
Roboter" returning M054 "Sichere thermische Auslegung" via
mismatched pattern reference).

PART A — Set-based category filter (handlers package):
- acceptableMeasureCategories: replaces 1:1 patternCatToMeasureCat
  with a curated set per pattern category, so e.g.
  safety_function_failure now accepts software_control measures
  (watchdogs, plausibility checks) and emc_hazard accepts both
  electrical and software_control measures
- isCategoryCompatible: gate every measure id against the accepted
  set before creating a mitigation; mismatches log MEASURE-SKIP
- The old category fallback is REMOVED. A hazard whose pattern has
  no category-compatible measure is now created with zero mitigations
  and logged as COVERAGE-GAP — the operator must consult an expert.
  No more silent invention of generic defaults.

PART B — 235 pattern author-error fixes across 26 files:
- HP040-HP044 (AI): M101/M102/M103 (Auffangwanne/Absauganlage) ->
  M133 Anomalieerkennung + M214 Plausibilitaet + M213 Sensor-Redundanz
  + M044 Zweikanalige Steuerung + others
- HP011-HP015, HP104-HP109, HP1085-HP1095, HP1281-HP1334 (electrical):
  M001-M005/M054/M061 placeholders -> M481/M482 Isolation +
  M511-M522 PE/Schutzleiter/RCD/Hauptschalter
- HP110-HP1331 (material_environmental): M101-M103 -> M384-M395
  Brandschutz/Laserschutz + M533/M408 SDB/PSA
- HP800-HP858, HP1178-HP1264 (software/sensor/hmi):
  M101/M104 -> M105/M106/M107/M214 SPS/Watchdog/Plausibilitaet
- HP026, HP611-HP1690 (ergonomic): M001/M082 -> M353-M360 +
  M530-M532 Hebehilfe/ergonomische Hoehe
- HP201-HP1697 (mechanical): M054/M051 -> M002/M008/M061/M141 +
  M487/M488 Tueroeffnung-Stillsetzung/Wiederanlauf
- Plus EMF/Strahlung/Brand/Lärm/Vibration/Kommunikation/Cyber

Coverage shift (Pattern-Author-Fehler bei aktiviertem Set-Filter):
   start:         237 patterns with zero category-compatible measures
   after Stufe 1A:   5 (AI)
   after Stufe 1B:  20 (mechanical Bestand)
   after Stufe 1C:  35 (electrical Bestand)
   after Stufe 1D:  29 (material_environmental)
   after Stufe 1E:  29 (software/sensor/hmi)
   after Stufe 1F:  20 (ergonomic)
   after Stufe 1G:  80 (thermal/comm/radiation/fire/safety)
   final:           0  (28 extended.go/extended2.go duplicates fixed)

New regression tests:
- TestEveryPattern_HasCategoryCompatibleMeasure: every pattern in
  collectAllPatterns() must reference at least one category-compatible
  measure; gaps must be explicitly listed in AllowlistKnownGaps
  (currently empty). Fails CI for any new pattern that drifts.
- TestAcceptableMeasureCategories: pins the set-mapping for the
  7 most-bug-prone pattern categories.
- TestIsCategoryCompatible_EmptyMeasureCat: protects legacy entries.

A separate task #11 tracks 58 HP-ID duplicates between
extended.go/extended2.go and cobot.go/press.go/operational.go —
patterns are semantically different and TestGetBuiltinHazardPatterns_-
UniqueIDs misses them because it only checks HP001-HP044.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-16 21:11:02 +02:00

129 lines
8.0 KiB
Go

package iace
// GetCobotHazardPatterns returns patterns specific to collaborative robots,
// press-specific expert hints, and the afterrun/SIL calculation domain.
// These extend the builtin patterns (HP045-HP058 for press, HP059+ for cobot).
func GetCobotHazardPatterns() []HazardPattern {
return []HazardPattern{
// ================================================================
// Collaborative Robot (Cobot) Patterns (HP059-HP065)
// ================================================================
{
ID: "HP059", HumanRoles: []string{"operator"}, NameDE: "Kollision Mensch-Roboter (Kraft/Geschwindigkeit)", NameEN: "Human-robot collision (force/speed)",
RequiredComponentTags: []string{"collaborative_operation", "moving_part"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M001", "M054"},
SuggestedEvidenceIDs: []string{"E01", "E08"},
Priority: 98,
RequiresExpertCalculation: true,
ExpertHintDE: "Sicherheitsabstaende und maximal zulaessige Kraefte/Geschwindigkeiten muessen berechnet werden.",
ExpertHintEN: "Safety distances and maximum permissible forces/speeds must be calculated.",
ScenarioDE: "Bediener arbeitet im gemeinsamen Arbeitsraum mit dem Cobot. Roboterarm bewegt sich mit Werkstueck/Werkzeug in Richtung Bediener.",
TriggerDE: "Roboterarm trifft Bediener am Oberkoerper, Kopf oder Haenden. Kraft oder Geschwindigkeit ueberschreitet biomechanische Grenzwerte.",
HarmDE: "Prellungen, Quetschungen, Knochenbrueche. Bei Kopfkontakt: Gehirnerschuetterung.",
AffectedDE: "Bedienpersonal, Einrichter, Wartungspersonal",
ZoneDE: "Kollaborativer Arbeitsraum des Roboters",
DefaultSeverity: 5, DefaultExposure: 4,
},
{
ID: "HP060", NameDE: "Quetschen durch Werkzeug am Cobot", NameEN: "Crushing by tool on cobot",
RequiredComponentTags: []string{"tool_at_robot", "collaborative_operation"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M001", "M054", "M141"},
SuggestedEvidenceIDs: []string{"E01", "E08"},
Priority: 95,
RequiresExpertCalculation: true,
ExpertHintDE: "Werkzeug-/Werkstueckgeometrie bestimmt das Quetschrisiko. Separate Beurteilung pro Werkzeug erforderlich.",
ExpertHintEN: "Tool/workpiece geometry determines crushing risk. Separate assessment per tool required.",
ScenarioDE: "Cobot fuehrt Werkzeug (Greifer, Schrauber, Schweisszange) nah am Bediener. Quetschstelle zwischen Werkzeug und festem Gegenstand (Tisch, Werkstueck).",
TriggerDE: "Werkzeug klemmt Koerperteil des Bedieners gegen feste Flaeche ein.",
HarmDE: "Quetschung Finger/Hand, Schnittverletzung bei scharfkantigem Werkzeug.",
AffectedDE: "Bedienpersonal",
ZoneDE: "Werkzeugspitze / Greifbereich des Cobots",
DefaultSeverity: 4, DefaultExposure: 4,
},
{
ID: "HP061", NameDE: "Nachlauf nach Stopp (Reaktionszeit)", NameEN: "Afterrun after stop (reaction time)",
RequiredComponentTags: []string{"afterrun_risk", "moving_part"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M002", "M494", "M487", "M141"},
SuggestedEvidenceIDs: []string{"E01", "E08"},
Priority: 90,
RequiresExpertCalculation: true,
ExpertHintDE: "Nachlaufwegberechnung erforderlich. Sicherheitsfeld muss entsprechend dimensioniert werden.",
ExpertHintEN: "Afterrun distance calculation required. Safety field must be dimensioned accordingly.",
ScenarioDE: "Schutzeinrichtung (Lichtvorhang, Scanner) loest aus, aber Roboter stoppt nicht sofort. Nachlaufweg fuehrt Roboterarm ueber den Schutzfeld-Rand hinaus.",
TriggerDE: "Person betritt Schutzfeld, Roboter bewegt sich waehrend des Bremswegs weiter und trifft die Person.",
HarmDE: "Prellungen, Quetschungen durch verzoegerten Stopp.",
AffectedDE: "Bedienpersonal, Besucher",
ZoneDE: "Uebergangsbereich Schutzfeld / Arbeitsraum",
DefaultSeverity: 4, DefaultExposure: 3,
},
{
ID: "HP062", OperationalStates: []string{"teach_mode"}, HumanRoles: []string{"programmer"}, NameDE: "Fehlprogrammierung Kraft-/Geschwindigkeitsgrenzwerte", NameEN: "Misprogramming of force/speed limits",
RequiredComponentTags: []string{"programmable", "force_limited"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"safety_function_failure"},
SuggestedMeasureIDs: []string{"M106"},
SuggestedEvidenceIDs: []string{"E01"},
Priority: 88,
ExpertHintDE: "Grenzwerte duerfen nur nach Risikobeurteilung veraendert werden. Zugriffsschutz erforderlich.",
ScenarioDE: "Programmierer setzt Kraft- oder Geschwindigkeitsgrenzwerte zu hoch ein. Sicherheitsfunktion greift nicht oder zu spaet.",
TriggerDE: "Falsch parametrierte Grenzwerte werden in Produktion uebernommen. Roboter ueberschreitet biomechanische Limits.",
HarmDE: "Verletzungen durch zu hohe Kontaktkraft. Schwere abhaengig von Ueberschreitung.",
AffectedDE: "Bedienpersonal",
ZoneDE: "Gesamter kollaborativer Arbeitsraum",
DefaultSeverity: 4, DefaultExposure: 3,
},
{
ID: "HP063", NameDE: "Werkstueck-Herabfallen vom Roboter", NameEN: "Workpiece drop from robot",
RequiredComponentTags: []string{"variable_workpiece", "gravity_risk"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M001", "M051"},
SuggestedEvidenceIDs: []string{"E08"},
Priority: 82,
ScenarioDE: "Roboter transportiert Werkstueck. Greifer verliert Halt (Druckverlust, falsches Werkstueck, oelige Oberflaeche).",
TriggerDE: "Werkstueck faellt herab und trifft Person oder Koerperteil unterhalb des Roboterarms.",
HarmDE: "Prellungen, Knochenbrueche (abhaengig von Werkstueckgewicht und Fallhoehe).",
AffectedDE: "Bedienpersonal, Personen im Umfeld",
ZoneDE: "Bereich unterhalb des Roboterarms / Transportweg",
DefaultSeverity: 3, DefaultExposure: 3,
},
{
ID: "HP064", OperationalStates: []string{"automatic_operation"}, HumanRoles: []string{"operator", "maintenance_tech"}, NameDE: "Quetschen im Roboter-Arbeitsraum (nicht-kollaborierend)", NameEN: "Crushing in robot workspace (non-collaborative)",
RequiredComponentTags: []string{"moving_part", "high_force", "sensor_part"},
RequiredEnergyTags: []string{},
ExcludedComponentTags: []string{"collaborative_operation"},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M001", "M005", "M051"},
SuggestedEvidenceIDs: []string{"E01", "E08"},
Priority: 94,
ScenarioDE: "Person betritt abgesicherten Arbeitsraum eines nicht-kollaborierenden Roboters (z.B. bei Stoerungsbeseitigung, Umgehung der Schutzeinrichtung).",
TriggerDE: "Roboter bewegt sich unkontrolliert oder startet unerwartet. Quetschen zwischen Roboterarm und Zelle/Werkstueck.",
HarmDE: "Schwere Quetschungen, Amputationen, lebensbedrohliche Verletzungen.",
AffectedDE: "Wartungspersonal, Einrichter",
ZoneDE: "Abgesicherter Roboter-Arbeitsraum",
DefaultSeverity: 5, DefaultExposure: 2,
},
{
ID: "HP065", NameDE: "Einklemmen am Arbeitstisch (Cobot-Zelle)", NameEN: "Trapping at work table (cobot cell)",
RequiredComponentTags: []string{"pinch_point", "structural_part"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M001"},
SuggestedEvidenceIDs: []string{"E08"},
Priority: 70,
ScenarioDE: "Bediener arbeitet am Arbeitstisch neben dem Cobot. Klemmstelle zwischen Roboterarm/Werkzeug und Tischkante oder Vorrichtung.",
TriggerDE: "Roboterarm drueckt Koerperteil gegen Tischkante. Klemmkraft uebersteigt biomechanische Grenzwerte.",
HarmDE: "Quetschung Finger, Handgelenk.",
AffectedDE: "Bedienpersonal",
ZoneDE: "Tischkanten, Vorrichtungen im Arbeitsbereich",
DefaultSeverity: 3, DefaultExposure: 3,
},
}
}