@sigloch/contracts 4.1.0 → 5.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/se/ao-rules.js +4 -1
- package/dist/se/cr-quality-rules.js +6 -1
- package/dist/se/fchain-quality-rules.js +4 -1
- package/dist/se/fmea-rules.js +5 -1
- package/dist/se/index.d.ts +2 -2
- package/dist/se/index.js +2 -2
- package/dist/se/meta-model.js +8 -1
- package/dist/se/readiness.js +8 -0
- package/dist/se/rules.js +116 -3
- package/dist/se/schema-quality-rules.js +4 -1
- package/package.json +1 -1
package/dist/se/ao-rules.js
CHANGED
|
@@ -343,7 +343,10 @@ export const AO_RULES = [
|
|
|
343
343
|
{ id: 'RT-01', name: 'PhysicalBoundaryIntegrity', severity: 'error', evaluate: rt01PhysicalBoundaryIntegrity, domain: ['FUNC'] },
|
|
344
344
|
{ id: 'PH-01', name: 'PhysicalModCompleteness', severity: 'info', evaluate: ph01PhysicalModCompleteness, domain: ['MOD'] },
|
|
345
345
|
{ id: 'CA-01', name: 'CapabilityAllocation', severity: 'error', evaluate: ca01CapabilityAllocation, domain: ['FUNC'] },
|
|
346
|
-
|
|
346
|
+
// CR-SM-242: domain ist FUNC, nicht MOD — die Regel laeuft ueber FUNC-Paare in FCHAINs und
|
|
347
|
+
// meldet am FUNC. Mit ['MOD'] uebertraf ihr Zaehler (21) ihren eigenen Nenner-Beitrag (10);
|
|
348
|
+
// nur der Clamp verhinderte einen negativen Score.
|
|
349
|
+
{ id: 'IO-01', name: 'FuncPairIOCompleteness', severity: 'warning', evaluate: io01CrossModuleCompleteness, domain: ['FUNC'] },
|
|
347
350
|
];
|
|
348
351
|
export function evaluateAORules(graph, policy) {
|
|
349
352
|
return AO_RULES.flatMap(r => r.evaluate(graph, policy));
|
|
@@ -132,7 +132,12 @@ function crShouldHaveMilestone(graph) {
|
|
|
132
132
|
export const CR_RULES = [
|
|
133
133
|
{ id: 'CR-R01', name: 'CR must track', severity: 'error', evaluate: crMustTrack, domain: ['CR'] },
|
|
134
134
|
{ id: 'CR-R02', name: 'Done requires commit', severity: 'error', evaluate: crDoneRequiresCommit, domain: ['CR'] },
|
|
135
|
-
|
|
135
|
+
// CR-SM-243: domain ist 'all', nicht CR — die Regel meldet am getrackten ZIELKNOTEN
|
|
136
|
+
// ("dieser Knoten wird von 2 offenen CRs angefasst"), und der kann jeden Typ haben. Eine
|
|
137
|
+
// Aufzaehlung waere eine Momentaufnahme der heute getrackten Typen, kein Modell; 'all'
|
|
138
|
+
// (= alle Elemente) ist die einzige Menge, aus der der Zielknoten garantiert stammt.
|
|
139
|
+
// Damit ist sie nach R-08/R-18 die dritte 'all'-Regel — bewusst, nicht vergessen.
|
|
140
|
+
{ id: 'CR-R03', name: 'No concurrent mutation', severity: 'warning', evaluate: noConcurrentMutation, domain: ['all'] },
|
|
136
141
|
{ id: 'CR-R04', name: 'CR must have FUNC', severity: 'warning', evaluate: crMustHaveFunc, domain: ['CR'] },
|
|
137
142
|
{ id: 'MS-03', name: 'CR without milestone', severity: 'info', evaluate: crShouldHaveMilestone, domain: ['CR'] },
|
|
138
143
|
];
|
|
@@ -140,7 +140,10 @@ export function fc04ActorBounded(graph) {
|
|
|
140
140
|
export const FC_RULES = [
|
|
141
141
|
{ id: 'FC-01', name: 'FCHAIN has actor boundary', severity: 'warning', evaluate: fc01ActorBoundary, domain: ['FCHAIN'] },
|
|
142
142
|
{ id: 'FC-02', name: 'Leaf UC has FCHAIN', severity: 'warning', evaluate: fc02LeafUcHasFchain, domain: ['UC'] },
|
|
143
|
-
|
|
143
|
+
// CR-SM-243: domain ist FUNC, nicht FCHAIN — die Regel meldet am FUNC mit der
|
|
144
|
+
// verschachtelten Zerlegung. Die FCHAIN ist der Suchraum, nicht die Grundgesamtheit:
|
|
145
|
+
// eine Kette mit n verschachtelten FUNCs erzeugt n Verstoesse gegen einen Beitrag von 1.
|
|
146
|
+
{ id: 'FC-03', name: 'FCHAIN is flat', severity: 'warning', evaluate: fc03FchainFlat, domain: ['FUNC'] },
|
|
144
147
|
{ id: 'FC-04', name: 'FCHAIN actor-bounded (trigger+consumer)', severity: 'warning', evaluate: fc04ActorBounded, domain: ['FCHAIN'] },
|
|
145
148
|
];
|
|
146
149
|
// CR-SM-236: `policy` wird durchgereicht, auch wo diese Familie heute keine Schwelle hat —
|
package/dist/se/fmea-rules.js
CHANGED
|
@@ -167,7 +167,11 @@ export const FM_RULES = [
|
|
|
167
167
|
{ id: 'FM-01', name: 'RiskReqFmeaAttributes', severity: 'warning', evaluate: fm01MissingFmeaAttributes, domain: ['REQ'] },
|
|
168
168
|
{ id: 'FM-02', name: 'RiskReqMitigation', severity: 'warning', evaluate: fm02MissingMitigation, domain: ['REQ'] },
|
|
169
169
|
{ id: 'FM-03', name: 'HighRiskVerification', severity: 'error', evaluate: fm03HighRiskUnverified, domain: ['REQ'] },
|
|
170
|
-
|
|
170
|
+
// CR-SM-243: die Regel prueft drei Typen, nicht einen — physische Budgets am MOD
|
|
171
|
+
// (PHYSICAL_BUDGET_TYPES), Verhaltensbudgets an FUNC und FCHAIN (BEHAVIORAL_BUDGET_TYPES).
|
|
172
|
+
// Die domain nennt dieselben Mengen wie die beiden Konstanten oben; wer eine davon
|
|
173
|
+
// erweitert, zieht diese Zeile mit.
|
|
174
|
+
{ id: 'NFR-01', name: 'BudgetOvershoot', severity: 'warning', evaluate: nfr01BudgetOvershoot, domain: ['MOD', 'FUNC', 'FCHAIN'] },
|
|
171
175
|
];
|
|
172
176
|
export function evaluateFMRules(graph, policy) {
|
|
173
177
|
return FM_RULES.flatMap(rule => rule.evaluate(graph, policy));
|
package/dist/se/index.d.ts
CHANGED
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
* Single source of truth for SE ontology schemas across all projects.
|
|
4
4
|
*/
|
|
5
5
|
/** Ontology schema version (element types + trace types). */
|
|
6
|
-
export declare const ONTOLOGY_VERSION = "
|
|
6
|
+
export declare const ONTOLOGY_VERSION = "7.0.0";
|
|
7
7
|
/** Rules engine version (validation rules incl. RC conformance). */
|
|
8
|
-
export declare const RULES_VERSION = "
|
|
8
|
+
export declare const RULES_VERSION = "3.0.0";
|
|
9
9
|
/** Meta-model version (trace pattern constraints + format-e parser). */
|
|
10
10
|
export declare const META_MODEL_VERSION = "1.4.0";
|
|
11
11
|
export * from './ontology.js';
|
package/dist/se/index.js
CHANGED
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
* Single source of truth for SE ontology schemas across all projects.
|
|
4
4
|
*/
|
|
5
5
|
/** Ontology schema version (element types + trace types). */
|
|
6
|
-
export const ONTOLOGY_VERSION = '
|
|
6
|
+
export const ONTOLOGY_VERSION = '7.0.0'; // BREAKING (CR-GC-366): das Trace-Pattern `FUNC -satisfy-> UC` entfaellt ersatzlos. Es war ein zweiter Weg vom Verhalten zum Use Case neben dem einzig tragenden `UC -compose-> FCHAIN -compose-> FUNC` — und der billigere: eine FUNC konnte einen UC bedienen, ohne in dessen Wirkkette zu stehen, womit IO-01 (FLOW-Pfade je Kettenpaar) und R-21 (Integrationstest je Kette) sie nie sahen. Die Abkuerzung umging genau die Pruefungen, die die Anbindung belastbar machen. Am graphcode-Selbstmodell waren 10 der 26 solchen Kanten reine Dopplung (die FUNC stand ohnehin in der FCHAIN), die restlichen 13 sind der Migrationsanlass. Jeder Graph mit solchen Kanten faellt jetzt R-18 (error) zur Last und muss migriert werden: FUNC in die FCHAIN des UC aufnehmen, satisfy-Kante loeschen. Prior: BREAKING (CR-SM-231b): das knotenweite `testResult` entfaellt — das Ergebnis haengt PRO `testRefs`-Eintrag (`result`, `ranAt`, `evidence`), aus demselben Grund wie `tool`. Ein einzelnes Ergebnis am Knoten konnte bei n Laeufen nicht sagen, welcher gemeint ist, und "einer rot, einer gruen" war gar nicht darstellbar — genau der Zustand, den ein Gate wissen muss. FM-03 liest jetzt "jeder Eintrag passed": "irgendeiner gruen" haette einen gruenen Unit-Lauf einen roten Visual-Lauf verdecken lassen. Ein Eintrag ohne Ergebnis ist nicht bestanden. VR-01 meldet die Dateien ohne Ergebnis statt nur den Knoten. Prior: BREAKING (CR-SM-231): `testRef` (Objekt) entfaellt ersatzlos zugunsten von `testRefs` (Array, min 1) — eine Abnahme, n Testdateien. Kein Union, kein Alias: ein Graph mit dem alten Attribut faellt R-19 zur Last und muss migriert werden. Anlass war ein Zaehl-Audit (537 laufende Tests in 67 Dateien, 14 TEST-Knoten mit je genau einer Datei, 53 Dateien an keine Abnahme gebunden) plus ein belegter Ausweichweg: dieselbe Spec-Datei stand im testRef ZWEIER TEST-Knoten, womit die Relation faktisch n:m war — ein roter Lauf keiner Abnahme mehr eindeutig zuordenbar, der TRR-Gate zaehlte dieselbe Evidenz doppelt. `tool` bleibt PRO EINTRAG: eine Abnahme mischt real die Runner (vitest + playwright). +AttributeSpec.type 'array' (testRefs ist das erste Listen-Attribut). Prior: BREAKING: `SemanticId` (`Name.TypeAbbr.Counter`) deleted, `ElementUid` (`<TYPE>-<slug>`) is the family canon — the old canon was used by no production graph of the family while 626 of 1145 elements already carried TYPE-slug (CR-SM-217); realRef unifies codeRef+schemaRef (+physical-MOD CAD ref), symbol optional; testRef stays separate (CR-228 C); +RepoRelativePathSchema on testRef/realRef .file — no absolute/`..` paths (CR-GC-255)
|
|
7
7
|
/** Rules engine version (validation rules incl. RC conformance). */
|
|
8
|
-
export const RULES_VERSION = '
|
|
8
|
+
export const RULES_VERSION = '3.0.0'; // BREAKING (CR-GC-366): +R-30 Wirkketten-Bindung, +R-31 io-Verdrahtung, R-02 zieltyp-scharf. Die vier Pflichten einer FUNC (ein REQ erfuellen, verdrahtet sein, in einer Wirkkette haengen, in einem MOD wohnen) waren nur zu zweit geprueft: R-02 und R-22. R-30 schliesst die Kette — R-15 verlangte, dass eine FCHAIN Funktionen hat, niemand verlangte, dass eine Funktion zu einer FCHAIN gehoert; daran haengen aber IO-01 und R-21, die beide nur INNERHALB einer Kette pruefen. R-31 schliesst die Verdrahtung: R-10 stellt dieselbe Frage vom FLOW aus und sieht eine FUNC ohne jede io-Kante deshalb nie (sie kommt in der FLOW-Schleife nicht vor); nur ACTOR darf terminieren. Ein Befund je FUNC statt je fehlender Seite, sonst uebersteigt der Zaehler den Nenner-Beitrag (die Fehlmessung aus CR-SM-242). BREAKING ist R-02: der Filter war zieltyp-blind, ein `FUNC -satisfy-> UC` schaltete ihn stumm, obwohl kein Requirement erfuellt war — am Selbstmodell 6 von 33 Faellen verdeckt (gemeldet: 27). Messung am graphcode-Selbstmodell (82 FUNC): R-30 60, R-31 54 (52 ohne Eingang, 50 ohne Ausgang, 48 ohne beides), R-02 27->33, R-22 3, R-18 26 (die Migrationsschuld aus dem gestrichenen Pattern). Prior: CR-SM-242: R-10 (`['FUNC']`→`['FLOW']`), SC-04 (`['SCHEMA']`→`['FLOW']`) und IO-01 (`['MOD']`→`['FUNC']`) deklarieren jetzt den Typ, an dem sie WIRKLICH melden. Alle drei iterierten ueber einen anderen Typ als den deklarierten: ihre Verstoesse erhoehten den Zaehler einer Grundgesamtheit, zu der sie nicht gehoerten. Gemessen am graphcode-Graphen (46 FLOW / 55 FUNC / 20 SCHEMA / 10 MOD) hob das `schema` von 0.713 auf 0.783 — SC-04 zog 46 FLOW-Verstoesse gegen 20 SCHEMA; bei IO-01 uebertraf der Zaehler (21) den eigenen Nenner-Beitrag (10) schon, nur der Clamp verhinderte einen negativen Score. Kein Evaluator, keine Regel-Semantik und kein Gate-Urteil geaendert — nur die deklarierte Grundgesamtheit, wie bei CR-SM-239. Neu erzwungen durch `se-rule-domain-invariant.test.ts`: der Typ jedes gemeldeten Elements liegt in der `domain` der Regel (stumm fuer 29 der 72 Regeln, die auf den Fixtures nicht feuern). CR-SM-243 (dieselbe Auslieferung): genau dieser Test hat vier weitere Faelle gefunden, die von Hand nie auffielen — R-03 (`['FUNC']`→`['MOD']`, meldet am Modul, das ASIL-D und QM mischt), FC-03 (`['FCHAIN']`→`['FUNC']`, meldet am FUNC mit der verschachtelten Zerlegung), NFR-01 (`['FUNC']`→`['MOD','FUNC','FCHAIN']`, Budgets liegen physisch am MOD und verhaltensseitig an FUNC/FCHAIN) und CR-R03 (`['CR']`→`['all']`, meldet am getrackten Zielknoten beliebigen Typs — nach R-08/R-18 die dritte und bewusst begruendete `all`-Regel). Prior: CR-SM-239: AF-01..05 und R-28 deklarieren `domain: ['graph']` statt `['SYS']` — sie pruefen EINMAL den Graphen, nicht die SYS-Elemente. Als Ein-Element-Gruppe waren sie ein Nenner-Beitrag mit fast sicherem Verstoss und zogen jede sonst leere Dimension auf 0 %: ein Graph ohne eine einzige REQ las `req` = 0 % (1 - 2/2 aus AF-01/AF-03) statt „nichts zu messen", und die Fokuswahl schickte den Executor dorthin. Kein Regelverhalten geaendert — nur die deklarierte Grundgesamtheit. Prior: CR-SM-231: +R-29 Testdatei-Exklusivitaet (severity **error**) — jede Testdatei erscheint in hoechstens einem `testRefs`. Das ist die Haelfte, die 1:n ERZWINGT statt es nur zu erlauben; ohne sie driftet das Attribut zurueck nach n:m. Bewusst schaerfer als R-19/R-20 (beide warning): eine doppelt beanspruchte Datei macht Gate-Zahlen nachweislich falsch, das ist eine Fehlmessung und kein Vollstaendigkeits-Signal. Rein graph-strukturell, kein I/O. R-19 und RC-02 lesen `testRefs`; RC-02 iteriert die Eintraege und nennt den konkreten Pfad statt nur der Knoten-ID. Prior: CR-SM-236: die letzten drei Urteilsschwellen sind Policy-Parameter statt Literal — CR-01 (`crossingFlows`, erstmals mit Aus-Zustand: `null` unterdrueckt auch die info je Modulpaar, die bisher die arch-Dimension verduennte), FM-03 (`riskRpn`, vorher inline 100) und R-04 (`moduleSize.{large,coupled,crossings}`, vorher inline 12/8/2 — drei Urteile, nicht eins). R-04 heisst jetzt 'Module size relative to crossing flows': die Regel waegt Groesse GEGEN Kreuzungen ab, der alte Name 'Max module size' verschwieg die zweite Haelfte der Bedingung. `RuleDefinition.evaluate` nimmt die Policy als zweiten Parameter, damit keine Familie einen Sonderweg braucht; einstellige Regelfunktionen bleiben zuweisbar. Bewertung unter DEFAULT_METRIC_POLICY unveraendert. Prior: CR-GC-315: R-12 + R-21 no longer tax FLOW reuse. R-12 restricted to dependency-carrying traces (compose/allocate/relation) — on `io` the only reachable shape was FUNC ─io→ FLOW ─io→ the SAME FUNC, i.e. read-modify-write on a shared FLOW, so the check was pure false-positive there (real io-cycles span ≥2 FUNCs and a 2-cycle test cannot see them); satisfy/verify/produces 2-cycles are pattern-illegal and belong to R-18. Its dedup key is now direction-independent (`type|sorted pair`) — keying on the message never collapsed anything, so every cycle was reported twice. R-21 no longer derives FUNC↔FUNC connections from FLOW co-adjacency alone: a producer/consumer pair with NO shared FCHAIN is silent. One hub FLOW with P producers and C consumers manufactured P·C findings, each demanding its own FCHAIN+integration test including pairs that never interact — reuse was penalised quadratically. The FCHAIN is the declared integration scope; the test is owed on that declared claim only. Rule intent (CR-GC-240 gap: unit/UC tests do not cover FUNC↔FUNC wiring) unchanged. Prior: CR-SM-227: +AF-01..05 Analysis-Freshness-Legs (analysis-freshness-rules.ts) — the third leg-kind a review gate checks (rule legs, layer-presence legs [R-28], now analysis-freshness legs, docs/articles/07-the-scoring-landscape.md); presence-only rules (Presence/Resolution-Split like R-19/R-20/R-26/R-27 vs. RC-01..05) checking a `graphVersion` freshness stamp exists under SYS.attributes.analysisFreshness.<AnalysisArtifactId> for each of the 5 CR-GC-221 judgment artifacts (conops/trade/assumption-review/fmea/implplan) — staleness (stamp vs live graphVersion) stays a consumer/I-O concern (`CreationCurrencyProvider`, @sigloch/graphcode-client), NOT evaluated here; Familie-Review 2026-08-05 gate assignment → RULE_TO_PHASE: ConOps/Trade/Assumption-Review → PDR, FMEA → CDR, Implementation Plan → TRR (SRR gets none); +AnalysisArtifactId enum + AnalysisFreshnessStampSchema (ontology.ts) as the SSOT graphcode-client's ARTIFACT_CATALOG analysis ids must match; grober Graph-Versions-Stempel only, no scope-hash in this first cut (conscious CR-SM-227 limitation).
|
|
9
9
|
/** Meta-model version (trace pattern constraints + format-e parser). */
|
|
10
10
|
export const META_MODEL_VERSION = '1.4.0'; // -REQ→MOD allocate pattern removed (CR-228 A); +FUNC→FUNC compose (blackbox function decomposition)
|
|
11
11
|
export * from './ontology.js';
|
package/dist/se/meta-model.js
CHANGED
|
@@ -20,7 +20,14 @@ export const TRACE_PATTERNS = [
|
|
|
20
20
|
{ source: 'MOD', target: 'MOD', type: 'io', description: 'Module communicates with module (ACL)' },
|
|
21
21
|
// ── satisfy (implementation) ──
|
|
22
22
|
{ source: 'FUNC', target: 'REQ', type: 'satisfy', description: 'Function implements requirement' },
|
|
23
|
-
|
|
23
|
+
// CR-GC-366: `FUNC -satisfy-> UC` ENTFAELLT (BREAKING). Es war ein zweiter, redundanter Weg
|
|
24
|
+
// vom Verhalten zum Use Case neben dem einzig tragenden `UC -compose-> FCHAIN -compose-> FUNC`.
|
|
25
|
+
// Zwei Wege = zwei Wahrheiten: eine FUNC konnte einen UC bedienen, ohne in dessen Wirkkette zu
|
|
26
|
+
// stehen, womit IO-01 (FLOW-Pfade je FCHAIN-Paar) und R-21 (Integrationstest je Kette) sie nie
|
|
27
|
+
// sahen — die Abkuerzung umging genau die Pruefungen, die die Anbindung belastbar machen.
|
|
28
|
+
// Gemessen am graphcode-Selbstmodell waren 10 von 26 solcher Kanten reine Dopplung (die FUNC
|
|
29
|
+
// stand ohnehin in einer FCHAIN); die restlichen 13 sind der Migrationsanlass, nicht ein
|
|
30
|
+
// Argument fuer das Pattern. Ersatz: die FUNC in die FCHAIN des UC aufnehmen (R-30).
|
|
24
31
|
// CR-154: NFR satisfy — non-functional REQs can be satisfied by chains, modules, or the system
|
|
25
32
|
{ source: 'FCHAIN', target: 'REQ', type: 'satisfy', description: 'Function chain satisfies end-to-end NFR (e.g. latency)' },
|
|
26
33
|
{ source: 'MOD', target: 'REQ', type: 'satisfy', description: 'Module satisfies budget NFR (e.g. uptime, memory)' },
|
package/dist/se/readiness.js
CHANGED
|
@@ -60,6 +60,11 @@ export const RULE_TO_DIMENSION = {
|
|
|
60
60
|
'R-22': 'alloc', 'R-23': 'alloc', 'R-26': 'schema', 'R-27': 'arch',
|
|
61
61
|
// CR-SM-226: R-28 Ebenen-Präsenz (>1 FUNC needs FLOW+SCHEMA) is an architecture rule.
|
|
62
62
|
'R-28': 'arch',
|
|
63
|
+
// CR-GC-366: R-30 (Wirkketten-Bindung) und R-31 (io-Verdrahtung) bewerten beide, ob ein
|
|
64
|
+
// Funktionsblock ueberhaupt im Bauplan haengt — dieselbe Dimension wie R-20 (realRef) und
|
|
65
|
+
// R-28 (Ebenen-Praesenz). NICHT 'uc': R-14..R-17 fragen, ob ein Behaelter gefuellt ist;
|
|
66
|
+
// diese beiden fragen von der FUNC aus, ob sie angeschlossen ist.
|
|
67
|
+
'R-30': 'arch', 'R-31': 'arch',
|
|
63
68
|
// uc
|
|
64
69
|
'UC-01': 'uc', 'UC-02': 'uc', 'UC-03': 'uc', 'UC-04': 'uc',
|
|
65
70
|
'UC-05': 'uc', 'UC-06': 'uc',
|
|
@@ -149,6 +154,9 @@ export const RULE_TO_PHASE = {
|
|
|
149
154
|
'R-15': 'PDR',
|
|
150
155
|
'FC-01': 'PDR', 'FC-03': 'PDR', 'FC-04': 'PDR',
|
|
151
156
|
'R-28': 'PDR', // Ebenen-Präsenz (CR-SM-226)
|
|
157
|
+
// CR-GC-366: Anschluss des Funktionsbaus — gehoert an dasselbe Gate wie R-15/IO-01,
|
|
158
|
+
// die auf derselben Kette aufsetzen.
|
|
159
|
+
'R-30': 'PDR', 'R-31': 'PDR',
|
|
152
160
|
'MT-01': 'PDR', 'MT-02': 'PDR',
|
|
153
161
|
'ND-01': 'PDR',
|
|
154
162
|
'AO-D01': 'PDR', 'AO-D03': 'PDR', 'CR-01': 'PDR', 'RT-01': 'PDR', 'PH-01': 'PDR', 'CA-01': 'PDR',
|
package/dist/se/rules.js
CHANGED
|
@@ -103,8 +103,15 @@ function reqMustHaveVerification(graph) {
|
|
|
103
103
|
function funcMustSatisfyReq(graph) {
|
|
104
104
|
const funcs = graph.elements.filter(e => e.type === 'FUNC');
|
|
105
105
|
const allReqs = graph.elements.filter(e => e.type === 'REQ');
|
|
106
|
+
// CR-GC-366: der Filter prueft den ZIELTYP. Vorher war er zieltyp-blind (`type === 'satisfy'`),
|
|
107
|
+
// womit ein `FUNC -satisfy-> UC` die Regel stumm schaltete, obwohl kein Requirement erfuellt war —
|
|
108
|
+
// der Regelname versprach mehr als der Code pruefte. Am graphcode-Selbstmodell verdeckte das 6 von
|
|
109
|
+
// 33 Faellen (gemeldet: 27). Mit dem Wegfall des UC-Patterns waere der alte Ausdruck de facto
|
|
110
|
+
// aequivalent geworden; explizit bleibt er trotzdem, damit die Regel nicht davon abhaengt, welche
|
|
111
|
+
// Ziele das Meta-Modell gerade zulaesst.
|
|
112
|
+
const reqIds = new Set(allReqs.map(r => r.id));
|
|
106
113
|
return funcs
|
|
107
|
-
.filter(fn => !graph.traces.some(t => t.source === fn.id && t.type === 'satisfy'))
|
|
114
|
+
.filter(fn => !graph.traces.some(t => t.source === fn.id && t.type === 'satisfy' && reqIds.has(t.target)))
|
|
108
115
|
.map(fn => {
|
|
109
116
|
const modId = findParentModule(graph, fn.id);
|
|
110
117
|
// Candidate REQs: same module's other FUNCs satisfy these, or constraints referencing this func
|
|
@@ -1016,10 +1023,111 @@ function ebenenPraesenz(graph) {
|
|
|
1016
1023
|
context: { element_type: anchor.type, element_name: anchor.name },
|
|
1017
1024
|
}];
|
|
1018
1025
|
}
|
|
1026
|
+
// ---------------------------------------------------------------------------
|
|
1027
|
+
// R-30: FUNC gehoert in eine Wirkkette (CR-GC-366)
|
|
1028
|
+
// Die Ontologie deckte nur die Gegenrichtung ab: R-15 verlangt, dass eine FCHAIN
|
|
1029
|
+
// Funktionen hat — niemand verlangte, dass eine Funktion zu einer FCHAIN gehoert.
|
|
1030
|
+
// Genau daran haengt aber die uebrige Absicherung: IO-01 bildet FLOW-Pfade nur
|
|
1031
|
+
// zwischen FUNCs DERSELBEN Kette, R-21 fordert den Integrationstest je Kette.
|
|
1032
|
+
// Eine FUNC ausserhalb jeder Kette faellt durch beide Netze, ohne dass etwas meldet.
|
|
1033
|
+
// Severity warning, nicht error: am Selbstmodell trifft es 60 von 82 FUNC — ein
|
|
1034
|
+
// error wuerde ueber das Delta-Gate jede weitere Mutation blockieren und waere
|
|
1035
|
+
// Neubau-Zwang statt Steuerung.
|
|
1036
|
+
// ---------------------------------------------------------------------------
|
|
1037
|
+
function funcMustBeInEffectChain(graph) {
|
|
1038
|
+
const funcs = graph.elements.filter(e => e.type === 'FUNC');
|
|
1039
|
+
const fchains = graph.elements.filter(e => e.type === 'FCHAIN');
|
|
1040
|
+
const funcIds = new Set(funcs.map(f => f.id));
|
|
1041
|
+
const fchainIds = new Set(fchains.map(fc => fc.id));
|
|
1042
|
+
const inChain = new Set(graph.traces
|
|
1043
|
+
.filter(t => t.type === 'compose' && fchainIds.has(t.source) && funcIds.has(t.target))
|
|
1044
|
+
.map(t => t.target));
|
|
1045
|
+
// Zerlegung erbt Mitgliedschaft nach unten: steht der Elternteil in einer Kette,
|
|
1046
|
+
// sind seine Kinder dessen Realisierung eine Ebene tiefer (TRACE_PATTERNS
|
|
1047
|
+
// `FUNC -compose-> FUNC`) und damit mitgebunden. Ohne diesen Schritt meldete die
|
|
1048
|
+
// Regel jede Sub-Funktion eines Kettenmitglieds als Waise — ein Fehlbefund aus
|
|
1049
|
+
// der Ontologie selbst. Am Selbstmodell aendert der Schritt heute nichts
|
|
1050
|
+
// (Zerlegungsbaum und Ketten sind dort disjunkt), er verhindert den Fehlbefund
|
|
1051
|
+
// fuer jedes Modell, das beides kombiniert.
|
|
1052
|
+
const parentOf = new Map();
|
|
1053
|
+
for (const t of graph.traces) {
|
|
1054
|
+
if (t.type === 'compose' && funcIds.has(t.source) && funcIds.has(t.target)) {
|
|
1055
|
+
parentOf.set(t.target, t.source);
|
|
1056
|
+
}
|
|
1057
|
+
}
|
|
1058
|
+
const reachesChain = (start) => {
|
|
1059
|
+
const seen = new Set([start]);
|
|
1060
|
+
let cur = start;
|
|
1061
|
+
while (cur) {
|
|
1062
|
+
if (inChain.has(cur))
|
|
1063
|
+
return true;
|
|
1064
|
+
cur = parentOf.get(cur);
|
|
1065
|
+
if (!cur || seen.has(cur))
|
|
1066
|
+
return false;
|
|
1067
|
+
seen.add(cur);
|
|
1068
|
+
}
|
|
1069
|
+
return false;
|
|
1070
|
+
};
|
|
1071
|
+
return funcs
|
|
1072
|
+
.filter(fn => !reachesChain(fn.id))
|
|
1073
|
+
.map(fn => ({
|
|
1074
|
+
rule_id: 'R-30',
|
|
1075
|
+
severity: 'warning',
|
|
1076
|
+
element_id: fn.id,
|
|
1077
|
+
message: `${fn.id} belongs to no function chain (no FCHAIN compose, directly or via a parent FUNC)`,
|
|
1078
|
+
fix_hint: 'Add the FUNC to the FCHAIN of the use case it serves (FCHAIN -compose-> FUNC)',
|
|
1079
|
+
context: {
|
|
1080
|
+
element_type: fn.type,
|
|
1081
|
+
element_name: fn.name,
|
|
1082
|
+
candidate_targets: toCandidates(fchains, fn),
|
|
1083
|
+
},
|
|
1084
|
+
}));
|
|
1085
|
+
}
|
|
1086
|
+
// ---------------------------------------------------------------------------
|
|
1087
|
+
// R-31: FUNC ist verdrahtet — Ein- UND Ausgang per io (CR-GC-366)
|
|
1088
|
+
// Nur ACTOR darf eine Kette terminieren; eine FUNC ohne Eingang oder ohne Ausgang
|
|
1089
|
+
// ist ein toter Block. R-10 prueft dieselbe Verdrahtung vom FLOW aus ("hat dieser
|
|
1090
|
+
// Flow Producer und Consumer?") und sieht eine FUNC ohne jede io-Kante deshalb nie:
|
|
1091
|
+
// sie kommt in der FLOW-Schleife gar nicht vor. IO-01 setzt Ketten-Mitgliedschaft
|
|
1092
|
+
// voraus und sieht sie ebenfalls nicht. Diese Regel schliesst die FUNC-Seite.
|
|
1093
|
+
// EIN Befund je FUNC (nicht je fehlender Seite): sonst uebersteigt der Zaehler den
|
|
1094
|
+
// eigenen Nenner-Beitrag, was CR-SM-242 fuer IO-01 als Fehlmessung nachgewiesen hat.
|
|
1095
|
+
// ---------------------------------------------------------------------------
|
|
1096
|
+
function funcMustBeWired(graph) {
|
|
1097
|
+
const funcs = graph.elements.filter(e => e.type === 'FUNC');
|
|
1098
|
+
const flows = graph.elements.filter(e => e.type === 'FLOW');
|
|
1099
|
+
const io = graph.traces.filter(t => t.type === 'io');
|
|
1100
|
+
const hasInput = new Set(io.map(t => t.target)); // FLOW -io-> FUNC
|
|
1101
|
+
const hasOutput = new Set(io.map(t => t.source)); // FUNC -io-> FLOW
|
|
1102
|
+
return funcs
|
|
1103
|
+
.map(fn => {
|
|
1104
|
+
const missing = [];
|
|
1105
|
+
if (!hasInput.has(fn.id))
|
|
1106
|
+
missing.push('input');
|
|
1107
|
+
if (!hasOutput.has(fn.id))
|
|
1108
|
+
missing.push('output');
|
|
1109
|
+
return { fn, missing };
|
|
1110
|
+
})
|
|
1111
|
+
.filter(({ missing }) => missing.length > 0)
|
|
1112
|
+
.map(({ fn, missing }) => ({
|
|
1113
|
+
rule_id: 'R-31',
|
|
1114
|
+
severity: 'warning',
|
|
1115
|
+
element_id: fn.id,
|
|
1116
|
+
message: `${fn.id} is not wired into any flow (missing: ${missing.join(' + ')})`,
|
|
1117
|
+
fix_hint: 'Connect the FUNC to a FLOW on the missing side (FLOW -io-> FUNC for input, FUNC -io-> FLOW for output) — only an ACTOR may terminate a chain',
|
|
1118
|
+
context: {
|
|
1119
|
+
element_type: fn.type,
|
|
1120
|
+
element_name: fn.name,
|
|
1121
|
+
candidate_targets: toCandidates(flows, fn),
|
|
1122
|
+
},
|
|
1123
|
+
}));
|
|
1124
|
+
}
|
|
1019
1125
|
export const V3_RULES = [
|
|
1020
1126
|
{ id: 'R-01', name: 'REQ must have verification', severity: 'error', evaluate: reqMustHaveVerification, domain: ['REQ'] },
|
|
1021
1127
|
{ id: 'R-02', name: 'FUNC must satisfy REQ', severity: 'warning', evaluate: funcMustSatisfyReq, domain: ['FUNC'] },
|
|
1022
|
-
|
|
1128
|
+
// CR-SM-243: domain ist MOD, nicht FUNC — die Regel iteriert Module und meldet am Modul,
|
|
1129
|
+
// das ASIL-D und QM mischt. Die FUNCs sind der Anlass des Urteils, nicht seine Traeger.
|
|
1130
|
+
{ id: 'R-03', name: 'ASIL isolation', severity: 'error', evaluate: asilIsolation, domain: ['MOD'] },
|
|
1023
1131
|
{ id: 'R-04', name: 'Module size relative to crossing flows', severity: 'warning', evaluate: maxModuleSize, domain: ['MOD'] },
|
|
1024
1132
|
{ id: 'R-05', name: 'TEST must verify REQ', severity: 'warning', evaluate: testMustVerifyReq, domain: ['TEST'] },
|
|
1025
1133
|
{ id: 'R-14', name: 'UC must have compose', severity: 'warning', evaluate: ucMustHaveCompose, domain: ['UC'] },
|
|
@@ -1027,7 +1135,10 @@ export const V3_RULES = [
|
|
|
1027
1135
|
{ id: 'R-16', name: 'ACTOR must have io', severity: 'warning', evaluate: actorMustHaveTrace, domain: ['ACTOR'] },
|
|
1028
1136
|
{ id: 'R-17', name: 'SYS must have compose', severity: 'warning', evaluate: sysMustHaveCompose, domain: ['SYS'] },
|
|
1029
1137
|
{ id: 'R-08', name: 'Trace consistency', severity: 'error', evaluate: traceConsistency, domain: ['all'] },
|
|
1030
|
-
|
|
1138
|
+
// CR-SM-242: domain ist FLOW, nicht FUNC — die Regel iteriert ueber FLOWs und meldet am FLOW.
|
|
1139
|
+
// Als ['FUNC'] deklariert erhoehte sie den Zaehler einer Grundgesamtheit, zu der ihre
|
|
1140
|
+
// Verstoesse nicht gehoerten (bis zu 2 Legs je FLOW gegen einen FUNC-Nenner).
|
|
1141
|
+
{ id: 'R-10', name: 'FLOW completeness', severity: 'warning', evaluate: flowCompleteness, domain: ['FLOW'] },
|
|
1031
1142
|
{ id: 'R-12', name: 'No circular dependencies', severity: 'warning', evaluate: noDirectCircular, domain: ['FUNC'] },
|
|
1032
1143
|
{ id: 'R-18', name: 'Valid trace pattern', severity: 'error', evaluate: validTracePattern, domain: ['all'] },
|
|
1033
1144
|
{ id: 'R-19', name: 'Runnable TEST binding', severity: 'warning', evaluate: testMustHaveRunnableBinding, domain: ['TEST'] },
|
|
@@ -1045,6 +1156,8 @@ export const V3_RULES = [
|
|
|
1045
1156
|
{ id: 'MS-01', name: 'Milestone empty scope', severity: 'warning', evaluate: msEmptyScope, domain: ['MS'] },
|
|
1046
1157
|
{ id: 'MS-02', name: 'Milestone dangling dependency', severity: 'error', evaluate: msDanglingDependency, domain: ['MS'] },
|
|
1047
1158
|
{ id: 'R-28', name: 'Ebenen-Präsenz (FLOW+SCHEMA when funcCount>1)', severity: 'warning', evaluate: ebenenPraesenz, domain: ['graph'] },
|
|
1159
|
+
{ id: 'R-30', name: 'FUNC must belong to a function chain', severity: 'warning', evaluate: funcMustBeInEffectChain, domain: ['FUNC'] },
|
|
1160
|
+
{ id: 'R-31', name: 'FUNC must be wired (io input + output)', severity: 'warning', evaluate: funcMustBeWired, domain: ['FUNC'] },
|
|
1048
1161
|
];
|
|
1049
1162
|
/** Run all rules against a graph. CR-SM-236: `policy` ist Pflicht — wie bei `evaluateAllRules`. */
|
|
1050
1163
|
export function evaluateRules(graph, policy) {
|
|
@@ -49,8 +49,11 @@ export function sc04FlowHasSchema(graph) {
|
|
|
49
49
|
// Aggregated array & convenience runner
|
|
50
50
|
// ---------------------------------------------------------------------------
|
|
51
51
|
export const SC_RULES = [
|
|
52
|
+
// Die Asymmetrie ist gewollt (CR-SM-242): SC-02 iteriert ueber SCHEMA („wird dieses SCHEMA
|
|
53
|
+
// benutzt"), SC-04 ueber FLOW („hat dieser FLOW einen Datenvertrag"). Gleiches Thema,
|
|
54
|
+
// verschiedene Grundgesamtheit. SC-04 als ['SCHEMA'] zog 46 FLOW-Verstoesse gegen 20 SCHEMA.
|
|
52
55
|
{ id: 'SC-02', name: 'Schema referenced by FLOW', severity: 'warning', evaluate: sc02IsReferenced, domain: ['SCHEMA'] },
|
|
53
|
-
{ id: 'SC-04', name: 'FLOW has SCHEMA binding', severity: 'warning', evaluate: sc04FlowHasSchema, domain: ['
|
|
56
|
+
{ id: 'SC-04', name: 'FLOW has SCHEMA binding', severity: 'warning', evaluate: sc04FlowHasSchema, domain: ['FLOW'] },
|
|
54
57
|
];
|
|
55
58
|
// CR-SM-236: `policy` wird durchgereicht, auch wo diese Familie heute keine Schwelle hat —
|
|
56
59
|
// ein Sonderweg je Familie waere genau der zweite Pfad, den der Regelsatz verbietet.
|