@sigloch/contracts 5.0.1 → 6.1.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.
@@ -1,6 +1,6 @@
1
1
  /**
2
2
  * CR-SM-227: Analysis-Freshness-Legs — the third leg-kind a review gate checks
3
- * (rule legs, layer-presence legs [R-28], now analysis-freshness legs).
3
+ * (rule legs, layer-presence legs [R-28, entfallen mit CR-SM-247], now analysis-freshness legs).
4
4
  * Presence/Resolution-Split (wie R-19/R-20/R-26/R-27 vs. RC-01..05): these five
5
5
  * rules are the PRÜFBARE FORM only — does a `graphVersion` stamp exist for the
6
6
  * artifact, as a graph attribute. They never compare the stamp against the
@@ -6,12 +6,12 @@ const ARTIFACT_LABEL = {
6
6
  fmea: 'FMEA',
7
7
  implplan: 'Implementation Plan',
8
8
  };
9
- /** Presence-check for one analysis artifact's freshness stamp, anchored on SYS (like R-28). */
9
+ /** Presence-check for one analysis artifact's freshness stamp, anchored on SYS. */
10
10
  function analysisFreshnessPresence(ruleId, artifactId) {
11
11
  return (graph) => {
12
12
  const sys = graph.elements.find(e => e.type === 'SYS');
13
13
  if (!sys)
14
- return []; // nothing to anchor on yet (same vacuous-complete exemption as R-28)
14
+ return []; // nothing to anchor on yet (vacuous-complete exemption)
15
15
  const stamp = sys.attributes?.analysisFreshness?.[artifactId];
16
16
  if (AnalysisFreshnessStampSchema.safeParse(stamp).success)
17
17
  return [];
@@ -263,75 +263,116 @@ export function ca01CapabilityAllocation(graph) {
263
263
  return violations;
264
264
  }
265
265
  // ---------------------------------------------------------------------------
266
- // IO-01: FUNC-pair IO completeness (CR-192, extended CR-SM-226)
267
- // For each FCHAIN with ≥2 FUNCs, every pair of FUNCs in the chain must have a
268
- // FLOW path between them not just pairs allocated to different MODs.
269
- // CR-SM-226 removed the cross-module-only restriction: same-module FUNC
270
- // pairs need an explicit FLOW just as much (module allocation is an
271
- // orthogonal concern to whether the interaction itself is wired up).
266
+ // IO-01: die Wirkkette haengt zusammen (CR-192, CR-SM-226, CR-SM-250)
267
+ //
268
+ // Geprueft wird ERREICHBARKEIT im io-Teilgraphen der Kette, nicht Adjazenz. Bis CR-SM-250
269
+ // musste es fuer JEDES Paar einen gemeinsamen FLOW geben — die Regel forderte damit einen
270
+ // vollstaendigen Graphen (n·(n−1)/2 Paarungen), obwohl eine Wirkkette eine Sequenz ist. Der
271
+ // Zaehler wuchs quadratisch mit der Kettenlaenge, der Nenner-Beitrag linear: eine lange, gut
272
+ // modellierte Kette las sich schlechter als eine kurze. Dieselbe Korrektur ist fuer R-21
273
+ // bereits vollzogen (CR-GC-315, "reuse was penalised quadratically").
274
+ //
275
+ // Zwei Praezisierungen gegenueber dem Vorschlag (Review 2026-08-20):
276
+ //
277
+ // 1. EIN BEFUND JE GLIED, nicht je Paar. Auch nach dem Umbau waeren zwei Komponenten der
278
+ // Groesse n/2 wieder n²/4 Befunde. Gemeldet wird je Glied ausserhalb der groessten
279
+ // Komponente — hoechstens ein Befund je FUNC und Kette, damit der Zaehler den
280
+ // Nenner-Beitrag (`domain: ['FUNC']`) nicht uebersteigt (die Fehlmessung aus CR-SM-242).
281
+ // Groesste Komponente bei Gleichstand: die mit der lexikografisch kleinsten FUNC-ID —
282
+ // ein Befund darf nicht an der Array-Reihenfolge haengen (CR-SM-244, Ordnung).
283
+ //
284
+ // 2. GAR NICHT VERDRAHTETE GLIEDER GEHOEREN R-31. Eine FUNC ohne jede io-Kante ist trivial
285
+ // ihre eigene Komponente; sie zu melden waere eine zweite Meldung derselben Ursache. Am
286
+ // sigloch-modules-Selbstmodell waren 6 der 7 IO-01-Elemente zugleich R-31-Elemente —
287
+ // genau die Doppelzaehlung, die Gate 4 verbietet. IO-01 meldet ab jetzt nur, was
288
+ // verdrahtet, aber von seiner Kette abgehaengt ist. Das ist die Aussage, die keine
289
+ // andere Regel trifft.
272
290
  // ---------------------------------------------------------------------------
273
291
  export function io01CrossModuleCompleteness(graph) {
274
292
  const violations = [];
275
- const fchains = graph.elements.filter(e => e.type === 'FCHAIN');
276
- for (const fc of fchains) {
277
- // Get FUNCs in this FCHAIN via compose
278
- const funcIds = graph.traces
293
+ const flowIds = new Set(graph.elements.filter(e => e.type === 'FLOW').map(e => e.id));
294
+ const funcIdSet = new Set(graph.elements.filter(e => e.type === 'FUNC').map(e => e.id));
295
+ /** io-Nachbarschaft FUNC <-> FLOW, richtungslos: die Frage ist "haengt das zusammen?". */
296
+ const flowsOfFunc = new Map();
297
+ for (const t of graph.traces) {
298
+ if (t.type !== 'io')
299
+ continue;
300
+ const [f, fl] = funcIdSet.has(t.source) && flowIds.has(t.target) ? [t.source, t.target]
301
+ : funcIdSet.has(t.target) && flowIds.has(t.source) ? [t.target, t.source]
302
+ : [undefined, undefined];
303
+ if (!f || !fl)
304
+ continue;
305
+ if (!flowsOfFunc.has(f))
306
+ flowsOfFunc.set(f, new Set());
307
+ flowsOfFunc.get(f).add(fl);
308
+ }
309
+ for (const fc of graph.elements.filter(e => e.type === 'FCHAIN')) {
310
+ const members = graph.traces
279
311
  .filter(t => t.source === fc.id && t.type === 'compose')
280
312
  .map(t => t.target)
281
- .filter(id => graph.elements.some(e => e.id === id && e.type === 'FUNC'));
282
- if (funcIds.length < 2)
313
+ .filter(id => funcIdSet.has(id));
314
+ // Nur verdrahtete Glieder — der Rest ist R-31s Befund (s. Kopf, Praezisierung 2).
315
+ const wired = members.filter(id => (flowsOfFunc.get(id)?.size ?? 0) > 0).sort();
316
+ if (wired.length < 2)
283
317
  continue;
284
- // Map FUNC→MOD via allocate (kept for the message context; no longer a filter).
285
- const funcToMod = new Map();
286
- for (const fid of funcIds) {
287
- const allocTrace = graph.traces.find(t => t.source === fid && t.type === 'allocate');
288
- if (allocTrace)
289
- funcToMod.set(fid, allocTrace.target);
290
- }
291
- // For each pair of FUNCs in the chain, check for a FLOW path.
292
- const checked = new Set();
293
- for (const fA of funcIds) {
294
- for (const fB of funcIds) {
295
- if (fA >= fB)
296
- continue;
297
- const modA = funcToMod.get(fA) ?? 'unallocated';
298
- const modB = funcToMod.get(fB) ?? 'unallocated';
299
- const pairKey = `${fA}:${fB}`;
300
- if (checked.has(pairKey))
301
- continue;
302
- checked.add(pairKey);
303
- // Check if there's a FLOW path: fA→io→FLOW→io→fB or fB→io→FLOW→io→fA
304
- const hasFlow = graph.traces.some(t1 => {
305
- if (t1.type !== 'io')
306
- return false;
307
- if (t1.source !== fA && t1.source !== fB)
308
- return false;
309
- const flowId = t1.target;
310
- const flowEl = graph.elements.find(e => e.id === flowId && e.type === 'FLOW');
311
- if (!flowEl)
312
- return false;
313
- const otherFunc = t1.source === fA ? fB : fA;
314
- return graph.traces.some(t2 => t2.type === 'io' &&
315
- ((t2.source === flowId && t2.target === otherFunc) ||
316
- (t2.target === flowId && t2.source === otherFunc)));
317
- });
318
- if (!hasFlow) {
319
- const elA = graph.elements.find(e => e.id === fA);
320
- const elB = graph.elements.find(e => e.id === fB);
321
- violations.push({
322
- rule_id: 'IO-01',
323
- severity: 'warning',
324
- element_id: fA,
325
- message: `${fA} (${modA}) and ${fB} (${modB}) in FCHAIN ${fc.id} have no IO path — missing FLOW?`,
326
- fix_hint: 'Add a FLOW element with io traces between these functions',
327
- context: {
328
- element_type: 'FUNC',
329
- element_name: elA?.name ?? fA,
330
- candidate_targets: elB ? [{ id: elB.id, type: elB.type, name: elB.name }] : undefined,
331
- },
332
- });
333
- }
318
+ // Union-Find ueber die Glieder: zwei Glieder am selben FLOW sind verbunden, Ketten von
319
+ // FLOW-Glied-FLOW verschmelzen dadurch transitiv zu einer Komponente.
320
+ const parent = new Map(wired.map(id => [id, id]));
321
+ const find = (x) => {
322
+ let r = x;
323
+ while (parent.get(r) !== r)
324
+ r = parent.get(r);
325
+ while (parent.get(x) !== r) {
326
+ const nxt = parent.get(x);
327
+ parent.set(x, r);
328
+ x = nxt;
329
+ }
330
+ return r;
331
+ };
332
+ const union = (a, b) => { const ra = find(a), rb = find(b); if (ra !== rb)
333
+ parent.set(ra < rb ? rb : ra, ra < rb ? ra : rb); };
334
+ const byFlow = new Map();
335
+ for (const id of wired)
336
+ for (const fl of flowsOfFunc.get(id)) {
337
+ if (!byFlow.has(fl))
338
+ byFlow.set(fl, []);
339
+ byFlow.get(fl).push(id);
334
340
  }
341
+ for (const sharing of byFlow.values())
342
+ for (let i = 1; i < sharing.length; i++)
343
+ union(sharing[0], sharing[i]);
344
+ const components = new Map();
345
+ for (const id of wired) {
346
+ const root = find(id);
347
+ if (!components.has(root))
348
+ components.set(root, []);
349
+ components.get(root).push(id);
350
+ }
351
+ if (components.size < 2)
352
+ continue;
353
+ // Groesste Komponente; bei Gleichstand die mit der kleinsten ID — deterministisch.
354
+ const largest = [...components.values()].sort((a, b) => b.length - a.length || a[0].localeCompare(b[0]))[0];
355
+ const largestSet = new Set(largest);
356
+ for (const id of wired) {
357
+ if (largestSet.has(id))
358
+ continue;
359
+ const el = graph.elements.find(e => e.id === id);
360
+ const mod = graph.traces.find(t => t.source === id && t.type === 'allocate')?.target ?? 'unallocated';
361
+ violations.push({
362
+ rule_id: 'IO-01',
363
+ severity: 'warning',
364
+ element_id: id,
365
+ message: `${id} (${mod}) is io-wired but not connected to the rest of FCHAIN ${fc.id} — no FLOW path to ${largest[0]}`,
366
+ fix_hint: `Add a FLOW (or io traces on an existing one) linking ${id} to a function of the same chain`,
367
+ context: {
368
+ element_type: 'FUNC',
369
+ element_name: el?.name ?? id,
370
+ candidate_targets: largest.slice(0, 3).map(t => {
371
+ const te = graph.elements.find(e => e.id === t);
372
+ return { id: t, type: te?.type ?? 'FUNC', name: te?.name ?? t };
373
+ }),
374
+ },
375
+ });
335
376
  }
336
377
  }
337
378
  return violations;
@@ -87,10 +87,31 @@ function noConcurrentMutation(graph) {
87
87
  return violations;
88
88
  }
89
89
  // ---------------------------------------------------------------------------
90
- // CR-R04: CR must have at least one relation→FUNC trace (CR-207)
90
+ // CR-R04: an OPEN CR must have at least one relation→FUNC trace (CR-207,
91
+ // Grundgesamtheit verengt in CR-SM-255)
92
+ //
93
+ // "Welche Funktionen fasst dieser CR an" ist eine PLANUNGSfrage — sie steuert, bevor
94
+ // gebaut wird. An einem geschlossenen CR ist sie Archaeologie: was er beruehrt hat,
95
+ // steht im Commit und im Diff, nicht im Graphen. Wer die Kanten nachtraeglich zieht,
96
+ // raet, und erfundene Praezision ist teurer als eine fehlende Kante.
97
+ //
98
+ // Gemessen am graphcode-Selbstmodell (graphVersion 171): 41 meldende CRs, davon 40
99
+ // `done` und 1 `dropped` — kein einziger offener. Die Regel feuerte ausschliesslich
100
+ // dort, wo sie nichts mehr steuern kann, und trug damit 41 unbearbeitbare Befunde.
101
+ //
102
+ // Die Statusmenge ist woertlich die von CR-R03 (s. o.): dieselbe Frage nach "noch in
103
+ // Arbeit", dieselbe Antwort. CR-R01 ("ein CR trackt ueberhaupt etwas") bleibt fuer
104
+ // ALLE CRs gueltig — nur die Verschaerfung "und zwar einen FUNC" ist Planung.
91
105
  // ---------------------------------------------------------------------------
92
106
  function crMustHaveFunc(graph) {
93
- const crs = graph.elements.filter(e => e.type === 'CR');
107
+ // Ein CR ganz OHNE status ist kein geschlossener CR — die Regel darf nicht durch ein
108
+ // fehlendes Attribut stumm werden.
109
+ const crs = graph.elements.filter(e => {
110
+ if (e.type !== 'CR')
111
+ return false;
112
+ const status = e.attributes?.status;
113
+ return status === undefined || status === 'open' || status === 'in-progress';
114
+ });
94
115
  return crs
95
116
  .filter(cr => !graph.traces.some(t => t.source === cr.id && t.type === 'relation' &&
96
117
  graph.elements.some(e => e.id === t.target && e.type === 'FUNC')))
@@ -138,7 +159,7 @@ export const CR_RULES = [
138
159
  // (= alle Elemente) ist die einzige Menge, aus der der Zielknoten garantiert stammt.
139
160
  // Damit ist sie nach R-08/R-18 die dritte 'all'-Regel — bewusst, nicht vergessen.
140
161
  { id: 'CR-R03', name: 'No concurrent mutation', severity: 'warning', evaluate: noConcurrentMutation, domain: ['all'] },
141
- { id: 'CR-R04', name: 'CR must have FUNC', severity: 'warning', evaluate: crMustHaveFunc, domain: ['CR'] },
162
+ { id: 'CR-R04', name: 'Open CR must have FUNC', severity: 'warning', evaluate: crMustHaveFunc, domain: ['CR'] },
142
163
  { id: 'MS-03', name: 'CR without milestone', severity: 'info', evaluate: crShouldHaveMilestone, domain: ['CR'] },
143
164
  ];
144
165
  // CR-SM-236: `policy` wird durchgereicht, auch wo diese Familie heute keine Schwelle hat —
@@ -10,7 +10,7 @@
10
10
  * @sigloch/contracts/se
11
11
  */
12
12
  import { ElementType } from './ontology.js';
13
- import type { TraceType, OntologyGraph } from './ontology.js';
13
+ import type { TraceType, OntologyGraph, AttributeSpec } from './ontology.js';
14
14
  export interface FormatEOperation {
15
15
  type: 'add_node' | 'remove_node' | 'update_node' | 'add_edge' | 'remove_edge' | 'strict_add_node' | 'strict_add_edge';
16
16
  semanticId: string;
@@ -50,7 +50,16 @@ export declare function extractFormatE(llmOutput: string): string | null;
50
50
  * package over. Two hydration rules would drift; there is one, and it lives here with the
51
51
  * schemas it feeds.
52
52
  */
53
- export declare function hydrateAttrValue(raw: string): unknown;
53
+ /**
54
+ * CR-SM-251: der deklarierte Typ des Attributs entscheidet, nicht die Schreibweise des Wertes.
55
+ *
56
+ * `ELEMENT_ATTRIBUTES` sagt fuer 14 Attribute (9 boolean, 5 number), welchen Typ sie tragen.
57
+ * Wer stattdessen raet (`raw === 'true'`, `/^\d+$/`), verschiebt den Defekt nur: ein
58
+ * Freitext-Attribut mit dem Wert "true" oder "8" kippt dann still den Typ. Unbekannte Keys —
59
+ * jeder Graph darf eigene tragen — fallen sauber auf String zurueck.
60
+ */
61
+ export declare function attributeTypeOf(elementType: string | undefined, key: string): AttributeSpec['type'] | undefined;
62
+ export declare function hydrateAttrValue(raw: string, declaredType?: AttributeSpec['type']): unknown;
54
63
  export interface ParseFormatEOptions {
55
64
  /**
56
65
  * CR-SM-216: resolve the type of a uid that this text does not declare. A mutation
@@ -9,7 +9,7 @@
9
9
  *
10
10
  * @sigloch/contracts/se
11
11
  */
12
- import { ElementType } from './ontology.js';
12
+ import { ElementType, ELEMENT_ATTRIBUTES } from './ontology.js';
13
13
  import { isValidTrace } from './meta-model.js';
14
14
  // ---------------------------------------------------------------------------
15
15
  // Extraction
@@ -54,7 +54,37 @@ const ATTR_RE = /^\s*@(\w+)\s+(.+)$/;
54
54
  * package over. Two hydration rules would drift; there is one, and it lives here with the
55
55
  * schemas it feeds.
56
56
  */
57
- export function hydrateAttrValue(raw) {
57
+ /**
58
+ * CR-SM-251: der deklarierte Typ des Attributs entscheidet, nicht die Schreibweise des Wertes.
59
+ *
60
+ * `ELEMENT_ATTRIBUTES` sagt fuer 14 Attribute (9 boolean, 5 number), welchen Typ sie tragen.
61
+ * Wer stattdessen raet (`raw === 'true'`, `/^\d+$/`), verschiebt den Defekt nur: ein
62
+ * Freitext-Attribut mit dem Wert "true" oder "8" kippt dann still den Typ. Unbekannte Keys —
63
+ * jeder Graph darf eigene tragen — fallen sauber auf String zurueck.
64
+ */
65
+ export function attributeTypeOf(elementType, key) {
66
+ if (!elementType)
67
+ return undefined;
68
+ const specs = ELEMENT_ATTRIBUTES[elementType];
69
+ return specs?.find(s => s.key === key)?.type;
70
+ }
71
+ export function hydrateAttrValue(raw, declaredType) {
72
+ // CR-SM-251: `concept:true` kam als String "true" an, und alle 11 Vergleiche in
73
+ // rules.ts/conformance-rules.ts pruefen identitaetsscharf (`=== true`). Damit war jeder
74
+ // Ausnahme-Schalter (concept/external/safety_relevant/spike) ueber Format-E unerreichbar:
75
+ // der Autor befolgt den fix_hint woertlich, und die Warnung bleibt stehen. Ein Export-Reimport
76
+ // entwertete zusaetzlich jede bestehende Ausnahme still.
77
+ if (declaredType === 'boolean') {
78
+ if (raw === 'true')
79
+ return true;
80
+ if (raw === 'false')
81
+ return false;
82
+ return raw; // kein stiller Fallback auf false — ein unlesbarer Wert bleibt sichtbar falsch
83
+ }
84
+ if (declaredType === 'number') {
85
+ const n = Number(raw);
86
+ return raw.trim() !== '' && Number.isFinite(n) ? n : raw;
87
+ }
58
88
  if (!/^[{[]/.test(raw))
59
89
  return raw;
60
90
  try {
@@ -90,7 +120,7 @@ export function parseFormatE(input, options = {}) {
90
120
  if (lastOp && (lastOp.type === 'add_node' || lastOp.type === 'update_node' || lastOp.type === 'strict_add_node')) {
91
121
  if (!lastOp.attributes)
92
122
  lastOp.attributes = {};
93
- lastOp.attributes[attrMatch[1]] = hydrateAttrValue(attrMatch[2].trim());
123
+ lastOp.attributes[attrMatch[1]] = hydrateAttrValue(attrMatch[2].trim(), attributeTypeOf(lastOp.elementType, attrMatch[1]));
94
124
  }
95
125
  else {
96
126
  errors.push(`@attribute line without preceding node: "${line}"`);
@@ -12,12 +12,12 @@
12
12
  export declare const GRAMMAR_SNAPSHOT: {
13
13
  readonly versions: {
14
14
  readonly ontology: "7.0.0";
15
- readonly metaModel: "1.4.0";
16
- readonly rules: "4.0.0";
15
+ readonly metaModel: "2.0.0";
16
+ readonly rules: "6.1.0";
17
17
  };
18
18
  readonly elementTypes: readonly ["ACTOR", "CR", "FCHAIN", "FLOW", "FUNC", "MOD", "MS", "REQ", "SCHEMA", "SESSION", "SYS", "TEST", "UC"];
19
19
  readonly traceTypes: readonly ["allocate", "compose", "io", "produces", "relation", "satisfy", "verify"];
20
20
  readonly patterns: readonly ["ACTOR -io-> FLOW", "ACTOR -io-> UC", "CR -relation-> FUNC", "CR -relation-> MOD", "CR -relation-> MS", "CR -relation-> REQ", "CR -relation-> UC", "FCHAIN -compose-> FUNC [1..*]", "FCHAIN -satisfy-> REQ", "FLOW -io-> ACTOR", "FLOW -io-> FUNC", "FLOW -io-> UC", "FLOW -relation-> SCHEMA", "FUNC -allocate-> MOD", "FUNC -compose-> FUNC [0..*]", "FUNC -io-> FLOW", "FUNC -satisfy-> REQ", "MOD -compose-> MOD [0..*]", "MOD -io-> MOD", "MOD -satisfy-> REQ", "MS -compose-> FUNC", "MS -compose-> MS", "MS -compose-> REQ", "MS -compose-> UC", "MS -relation-> MS", "REQ -compose-> REQ [0..*]", "SESSION -produces-> * (audit)", "SYS -compose-> MOD [0..*]", "SYS -compose-> REQ [0..*]", "SYS -compose-> SYS [0..*]", "SYS -compose-> UC [1..*]", "SYS -satisfy-> REQ", "TEST -verify-> REQ", "UC -compose-> FCHAIN [1..*]", "UC -compose-> REQ [1..*]"];
21
21
  readonly attributes: readonly ["CR.rationale: string", "CR.spike: boolean", "CR.status: enum", "FLOW.protocol: string", "FLOW.qos: string", "FUNC.concept: boolean", "FUNC.external: boolean", "FUNC.measuredMs: number", "FUNC.realRef: object", "FUNC.safety_relevant: boolean", "FUNC.sourceFile: string", "FUNC.timingBudgetMs: number", "MOD.concept: boolean", "MOD.external: boolean", "MOD.kind: string", "MOD.path: string", "MOD.realRef: object", "REQ.detection: number", "REQ.occurrence: number", "REQ.severity: number", "SCHEMA.concept: boolean", "SCHEMA.contract: string", "SCHEMA.external: boolean", "SCHEMA.realRef: object", "TEST.concept: boolean", "TEST.sourceFile: string", "TEST.testRefs: array", "UC.operatingMode: string"];
22
- readonly rules: readonly ["AF-01 (warning) domain=[graph]", "AF-02 (warning) domain=[graph]", "AF-03 (warning) domain=[graph]", "AF-04 (warning) domain=[graph]", "AF-05 (warning) domain=[graph]", "AO-D01 (info) domain=[FUNC]", "AO-D03 (info) domain=[FUNC]", "BQ-01 (warning) domain=[REQ]", "BQ-02 (warning) domain=[REQ]", "BQ-04 (warning) domain=[REQ]", "BQ-06 (warning) domain=[REQ]", "BQ-07 (warning) domain=[REQ]", "CA-01 (error) domain=[FUNC]", "CL-01 (warning) domain=[ACTOR]", "CR-01 (warning) domain=[MOD]", "CR-R01 (error) domain=[CR]", "CR-R02 (error) domain=[CR]", "CR-R03 (warning) domain=[all]", "CR-R04 (warning) domain=[CR]", "FC-01 (warning) domain=[FCHAIN]", "FC-02 (warning) domain=[UC]", "FC-03 (warning) domain=[FUNC]", "FC-04 (warning) domain=[FCHAIN]", "FM-01 (warning) domain=[REQ]", "FM-02 (warning) domain=[REQ]", "FM-03 (error) domain=[REQ]", "IO-01 (warning) domain=[FUNC]", "MS-01 (warning) domain=[MS]", "MS-02 (error) domain=[MS]", "MS-03 (info) domain=[CR]", "MT-01 (warning) domain=[MOD]", "MT-02 (info) domain=[MOD]", "ND-01 (error) domain=[FUNC]", "ND-02 (error) domain=[SCHEMA]", "NFR-01 (warning) domain=[FCHAIN,FUNC,MOD]", "PH-01 (info) domain=[MOD]", "R-01 (error) domain=[REQ]", "R-02 (warning) domain=[FUNC]", "R-03 (error) domain=[MOD]", "R-04 (warning) domain=[MOD]", "R-05 (warning) domain=[TEST]", "R-08 (error) domain=[all]", "R-10 (warning) domain=[FLOW]", "R-12 (warning) domain=[FUNC]", "R-14 (warning) domain=[UC]", "R-15 (warning) domain=[FCHAIN]", "R-16 (warning) domain=[ACTOR]", "R-17 (warning) domain=[SYS]", "R-18 (error) domain=[all]", "R-19 (warning) domain=[TEST]", "R-20 (warning) domain=[FUNC]", "R-21 (warning) domain=[FCHAIN]", "R-22 (warning) domain=[FUNC]", "R-23 (warning) domain=[MOD]", "R-26 (warning) domain=[SCHEMA]", "R-27 (warning) domain=[MOD]", "R-28 (warning) domain=[graph]", "R-29 (error) domain=[TEST]", "R-30 (warning) domain=[FUNC]", "R-31 (warning) domain=[FUNC]", "RD-01 (warning) domain=[REQ]", "RD-02 (warning) domain=[REQ]", "RD-03 (info) domain=[REQ]", "RD-04 (warning) domain=[FUNC,MOD,SYS]", "RT-01 (error) domain=[FUNC]", "SC-02 (warning) domain=[SCHEMA]", "SC-04 (warning) domain=[FLOW]", "UC-01 (error) domain=[UC]", "UC-02 (error) domain=[UC]", "UC-03 (warning) domain=[UC]", "UC-04 (warning) domain=[UC]", "UC-05 (info) domain=[UC]", "UC-06 (info) domain=[UC]", "VR-01 (info) domain=[TEST]"];
22
+ readonly rules: readonly ["AF-01 (warning) domain=[graph]", "AF-02 (warning) domain=[graph]", "AF-03 (warning) domain=[graph]", "AF-04 (warning) domain=[graph]", "AF-05 (warning) domain=[graph]", "AO-D01 (info) domain=[FUNC]", "AO-D03 (info) domain=[FUNC]", "BQ-01 (warning) domain=[REQ]", "BQ-02 (warning) domain=[REQ]", "BQ-04 (warning) domain=[REQ]", "BQ-06 (warning) domain=[REQ]", "BQ-07 (warning) domain=[REQ]", "CA-01 (error) domain=[FUNC]", "CL-01 (warning) domain=[ACTOR]", "CR-01 (warning) domain=[MOD]", "CR-R01 (error) domain=[CR]", "CR-R02 (error) domain=[CR]", "CR-R03 (warning) domain=[all]", "CR-R04 (warning) domain=[CR]", "FC-01 (warning) domain=[FCHAIN]", "FC-02 (warning) domain=[UC]", "FC-03 (warning) domain=[FUNC]", "FC-04 (warning) domain=[FCHAIN]", "FM-01 (warning) domain=[REQ]", "FM-02 (warning) domain=[REQ]", "FM-03 (error) domain=[REQ]", "IO-01 (warning) domain=[FUNC]", "MS-01 (warning) domain=[MS]", "MS-02 (error) domain=[MS]", "MS-03 (info) domain=[CR]", "MT-01 (warning) domain=[MOD]", "MT-02 (info) domain=[MOD]", "ND-01 (error) domain=[FUNC]", "ND-02 (error) domain=[SCHEMA]", "NFR-01 (warning) domain=[FCHAIN,FUNC,MOD]", "PH-01 (info) domain=[MOD]", "R-01 (error) domain=[REQ]", "R-02 (warning) domain=[FUNC]", "R-03 (error) domain=[MOD]", "R-04 (warning) domain=[MOD]", "R-05 (warning) domain=[TEST]", "R-08 (error) domain=[all]", "R-10 (warning) domain=[FLOW]", "R-12 (warning) domain=[FUNC]", "R-14 (warning) domain=[UC]", "R-15 (warning) domain=[FCHAIN]", "R-16 (warning) domain=[ACTOR]", "R-17 (warning) domain=[SYS]", "R-18 (error) domain=[all]", "R-19 (warning) domain=[TEST]", "R-20 (warning) domain=[FUNC]", "R-21 (warning) domain=[FCHAIN]", "R-22 (warning) domain=[FUNC]", "R-23 (warning) domain=[MOD]", "R-26 (warning) domain=[SCHEMA]", "R-27 (warning) domain=[MOD]", "R-29 (error) domain=[TEST]", "R-30 (warning) domain=[FUNC]", "R-31 (warning) domain=[FUNC]", "RD-01 (warning) domain=[REQ]", "RD-02 (warning) domain=[REQ]", "RD-03 (info) domain=[REQ]", "RD-04 (warning) domain=[FUNC,MOD,SYS]", "RT-01 (error) domain=[FUNC]", "SC-02 (warning) domain=[SCHEMA]", "SC-04 (warning) domain=[FLOW]", "UC-01 (error) domain=[UC]", "UC-02 (error) domain=[UC]", "UC-03 (warning) domain=[UC]", "UC-04 (warning) domain=[UC]", "UC-05 (info) domain=[UC]", "UC-06 (info) domain=[UC]", "VR-01 (info) domain=[TEST]"];
23
23
  };
@@ -12,8 +12,8 @@
12
12
  export const GRAMMAR_SNAPSHOT = {
13
13
  versions: {
14
14
  ontology: "7.0.0",
15
- metaModel: "1.4.0",
16
- rules: "4.0.0",
15
+ metaModel: "2.0.0",
16
+ rules: "6.1.0",
17
17
  },
18
18
  elementTypes: [
19
19
  "ACTOR",
@@ -163,7 +163,6 @@ export const GRAMMAR_SNAPSHOT = {
163
163
  "R-23 (warning) domain=[MOD]",
164
164
  "R-26 (warning) domain=[SCHEMA]",
165
165
  "R-27 (warning) domain=[MOD]",
166
- "R-28 (warning) domain=[graph]",
167
166
  "R-29 (error) domain=[TEST]",
168
167
  "R-30 (warning) domain=[FUNC]",
169
168
  "R-31 (warning) domain=[FUNC]",
@@ -5,9 +5,9 @@
5
5
  /** Ontology schema version (element types + trace types). */
6
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 = "4.0.0";
8
+ export declare const RULES_VERSION = "6.1.0";
9
9
  /** Meta-model version (trace pattern constraints + format-e parser). */
10
- export declare const META_MODEL_VERSION = "1.4.0";
10
+ export declare const META_MODEL_VERSION = "2.0.0";
11
11
  export * from './ontology.js';
12
12
  export * from './rules.js';
13
13
  export * from './conformance-rules.js';
package/dist/se/index.js CHANGED
@@ -5,9 +5,9 @@
5
5
  /** Ontology schema version (element types + trace types). */
6
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 = '4.0.0'; // BREAKING (CR-SM-245): MS-01 verliert den Legacy-Fallback `MS -compose-> *` ersatzlos — Scope ist ausschliesslich `CR -relation-> MS`. Der Fallback war ein zweiter Weg zu derselben Aussage: ein Meilenstein galt als befuellt, ohne dass ein CR auf ihn zeigte, womit MS-03 und jede Scope-Auswertung ihn nie sahen. Verschaerfung, deshalb major — gemessen faellt an den Selbstmodellen aber kein einziger Meilenstein (alle 7 in graphcode haben CR-Relationen, vier zusaetzlich compose; MS-01 bleibt 0 Befunde). Zweitens: '+MS-' in SE_PREFIXES — MS-01/02/03 lagen in KEINEM Profil (weder se noch coding) und liefen nur im default-Lauf. Die Dimension `ms` haengt an genau vier Regeln (MS-01/02/03 + AF-05), und AF-05 traegt als `domain: ['graph']`-Regel keinen Nenner bei — im se-Profil war `ms` damit ein strukturell leerer Topic-Score und das SRR-Gate um drei Legs aermer. Zweiter Fall der 'RD-'-Klasse (CR-SM-221), gefunden vom Profil-Test aus CR-SM-244. Prior: 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).
8
+ export const RULES_VERSION = '6.1.0'; // MINOR (CR-SM-255 + CR-SM-256): zwei Grundgesamtheiten verengt, beide Lockerungen — kein heute gruener Graph wird rot, keine Migration, keine Kante aendert sich. CR-SM-255: CR-R04 fragt nur noch CRs mit status open/in-progress (und CRs ganz ohne status — ein fehlendes Attribut darf keine Regel stumm schalten); die Statusmenge ist woertlich die von CR-R03 zwoelf Zeilen darueber. 'Welche FUNC fasst dieser CR an' ist eine PLANUNGSfrage; am geschlossenen CR ist sie Archaeologie (Umfang steht im Commit und im Diff), und wer die Kanten nachtraeglich zieht, raet. Gemessen am graphcode-Selbstmodell (graphVersion 171): 41 meldende CRs, davon 40 done und 1 dropped, KEIN einziger offener — 41 unbearbeitbare Befunde. Nach der Aenderung 0, und die Grundgesamtheit ist nicht leer: die 7 offenen CRs tragen ihre FUNC-Kanten bereits, die Regel ist erfuellt statt gegenstandslos. CR-R01 ('ein CR trackt ueberhaupt etwas') bleibt fuer ALLE CRs gueltig. Regelname 'CR must have FUNC' -> 'Open CR must have FUNC'. CR-SM-256: R-02 und R-31 bekommen dieselbe Grundgesamtheit wie R-30 seit CR-SM-249 und R-20 seit CR-210 — ausschliesslich BLAETTER (FUNC ohne FUNC-Kind). Ein zerlegter FUNC ist ein Rollup: durch einen Blackbox-Block fliesst nichts, und er erfuellt keine REQ, die nicht schon ein Blatt erfuellt; wer die beiden Regeln an ihm befriedigen will, muss eine io-Kante an einem Knoten erfinden, an dem nichts anliegt, oder eine satisfy-Kante, die dieselbe REQ ein zweites Mal beansprucht. CR-GC-375 hatte das fuer R-31 ausdruecklich offengelassen ('ein Block ohne io ist auch als Rollup ein Befund … eine eigene Frage, hier bewusst nicht'); die Messung, die Gate 1 zum Wiederaufmachen verlangt, liegt vor: 12 der 13 Bloecke am graphcode-Selbstmodell melden R-02 UND R-31, keiner aus einem anderen Grund — dieselbe Ursache zweimal gezaehlt, die Klasse CR-SM-235/-242. R-02 22->10, R-31 29->17. R-30 unveraendert. EIN geteilter Helper `decomposedFuncs` fuer alle drei Regeln, damit keine zweite Definition von 'Blatt' entsteht (Gate 2). ABGELEHNT im selben Durchlauf, hier festgehalten damit es nicht wiederkommt (CR-SM-257): R-02/R-30/R-31 sollten zusaetzlich `attributes.external === true` ueberspringen. `external` ist ein REALISIERUNGS-Marker — genau so steht es in ELEMENT_ATTRIBUTES ('exempt from the R-20 realRef-binding requirement') und genau so nutzen es R-27 und RC-01..03. Struktur schuldet der Konsument trotzdem: 5 der 12 externen FUNC am graphcode-Selbstmodell haengen vollstaendig in einer lokalen Wirkkette und sind beidseitig verdrahtet. Entscheidend ist die Reihenschaltung am System-Rand: R-31 erzwingt den Grenz-FLOW, SC-04 erzwingt dessen SCHEMA, und `external` am SCHEMA sagt 'der Vertrag wird drueben veroeffentlicht' (33 von 33 Grenz-FLOWs in graphcode tragen so ein SCHEMA, 12 davon external). Eine Ausnahme in R-31 kappt das erste Glied: ohne geforderten FLOW feuert SC-04 nie, und am externen Interface wird NIE ein Schema-Vertrag verlangt. Die 21 Befunde, die der Vorschlag entfernt haette, sind der Hebel, der genau diese Vertraege entstehen laesst. ACHTUNG, Gate-Luecke (wie CR-SM-249): `check-grammar-version.mjs` sieht beide Aenderungen NICHT — der Snapshot erfasst id/severity/domain, und alle drei bleiben gleich. Der Bump hier ist von Hand. Prior: BREAKING (CR-SM-247): R-28 (Ebenen-Praesenz) entfaellt ersatzlos. Sie schloss das Vacuous-Complete-Loch — mit 0/1 FUNC feuert keine Pro-Element-Regel und jede Vollstaendigkeitsfrage liest 'fertig' —, ist seit CR-GC-366 aber doppelt: die FLOW-Haelfte traegt R-31 (je FUNC statt einmal je Graph) plus IO-01, die SCHEMA-Haelfte SC-04 (je FLOW). Probe (SYS+UC+FCHAIN+3 FUNC, ohne FLOW/SCHEMA): 28 Befunde aus 18 Regeln, ohne R-28 bleiben 17 — das Loch bleibt zu. Gemessen feuerte sie 1x/0x an den Selbstmodellen, dort neben 14x IO-01 und 10x R-31. Dimension und Gate bleiben besetzt (R-30/R-31 sind ebenfalls arch/PDR). Bewusst in Kauf genommen: die SCHEMA-Absenz rutscht von PDR nach CDR, weil SC-04 erst feuert, wenn FLOWs existieren. Als domain:['graph']-Regel trug sie keinen Nenner bei — kein Dimensions-Score verschiebt sich. Prior: MINOR (CR-SM-250): IO-01 prueft ERREICHBARKEIT im io-Teilgraphen der Kette statt Adjazenz jedes Paares. Die Regel forderte einen vollstaendigen Graphen (n·(n−1)/2 Paarungen), obwohl eine Wirkkette eine Sequenz ist — der Zaehler wuchs quadratisch mit der Kettenlaenge, der Nenner-Beitrag linear, und wer sie befriedigen wollte, erfand einen fachlich falschen FLOW oder baute einen Ketten-Bus. Dieselbe Korrektur wie CR-GC-315 fuer R-21, eine Ebene hoeher. Zwei Praezisierungen aus dem Grammar-Review: ein Befund je abgehaengtem Glied statt je Paar (sonst waeren zwei Komponenten der Groesse n/2 wieder n²/4 Befunde, Zaehler > Nenner-Beitrag), und gar nicht verdrahtete Glieder gehoeren R-31 — am sigloch-modules-Selbstmodell waren 6 der 7 IO-01-Elemente zugleich R-31-Elemente, also Doppelzaehlung derselben Ursache. Lockerung, kein heute gruener Graph wird rot. Prior: BREAKING (CR-SM-249): R-15 wird VERSCHAERFT und heisst jetzt 'FCHAIN completeness' — eine Kette braucht Funktionen UNTER sich UND einen UC UEBER sich. Zweites Bein unter derselben rule_id nach dem R-10-Muster (bis zu zwei Meldungen je FCHAIN), bewusst keine neue Regel-ID: eine ID kostet dauerhaft einen Nenner-Anteil, eine Katalogzeile, eine readiness-Zuordnung und einen Golden-File-Eintrag — fuer einen einzigen Befund ueber beide Selbstmodelle (Gate 6 des Grammatik-Reviews). Major, weil ein heute gruener Graph rot werden kann: seit Ontologie 7.0.0 ist `UC -compose-> FCHAIN -compose-> FUNC` der EINZIGE Pfad vom Verhalten zum Zweck, und geprueft war nur sein unteres Bein. Migration: eine Kette ohne UC unterstellen oder loeschen (graphcode: `FCHAIN-doc-export`, 1 Befund). Zweitens R-30: die Grundgesamtheit sind ab jetzt AUSSCHLIESSLICH Blaetter (FUNC ohne FUNC-Kinder), und die Aufwaerts-Vererbung aus CR-GC-366 entfaellt ersatzlos. Ein zerlegter FUNC ist ein Rollup seiner Kinder und DARF gar kein Kettenglied sein — FC-03 ('FCHAIN is flat') verbietet es; die erste Fassung forderte einen Zustand, den eine andere Regel untersagt (am graphcode-Gate quittiert: graphVersion 111, zurueckgenommen in 112). Die Vererbung konnte nur greifen, wenn ein Block Kettenglied ist, und haette sonst ein unverbundenes Blatt stumm geschaltet. R-30 allein waere ein Minor (es meldet weniger: 56 -> 43 am graphcode-Selbstmodell, die 13 Differenz sind exakt die Bloecke). ACHTUNG, Gate-Luecke: `check-grammar-version.mjs` sieht diese Aenderung NICHT — der Snapshot erfasst id/severity/domain, und alle drei bleiben gleich. Eine semantische Verschaerfung ist mit einem Oberflaechen-Abzug nicht greifbar; der Bump hier ist von Hand. Prior: BREAKING (CR-SM-245): MS-01 verliert den Legacy-Fallback `MS -compose-> *` ersatzlos — Scope ist ausschliesslich `CR -relation-> MS`. Der Fallback war ein zweiter Weg zu derselben Aussage: ein Meilenstein galt als befuellt, ohne dass ein CR auf ihn zeigte, womit MS-03 und jede Scope-Auswertung ihn nie sahen. Verschaerfung, deshalb major — gemessen faellt an den Selbstmodellen aber kein einziger Meilenstein (alle 7 in graphcode haben CR-Relationen, vier zusaetzlich compose; MS-01 bleibt 0 Befunde). Zweitens: '+MS-' in SE_PREFIXES — MS-01/02/03 lagen in KEINEM Profil (weder se noch coding) und liefen nur im default-Lauf. Die Dimension `ms` haengt an genau vier Regeln (MS-01/02/03 + AF-05), und AF-05 traegt als `domain: ['graph']`-Regel keinen Nenner bei — im se-Profil war `ms` damit ein strukturell leerer Topic-Score und das SRR-Gate um drei Legs aermer. Zweiter Fall der 'RD-'-Klasse (CR-SM-221), gefunden vom Profil-Test aus CR-SM-244. Prior: 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
- export const META_MODEL_VERSION = '1.4.0'; // -REQ→MOD allocate pattern removed (CR-228 A); +FUNC→FUNC compose (blackbox function decomposition)
10
+ export const META_MODEL_VERSION = '2.0.0'; // BREAKING, zwei Anlaesse in einer Zahl. (1) Nachtrag zu CR-GC-366: dort entfiel das Trace-Pattern `FUNC -satisfy-> UC`, gebumpt wurde aber nur ONTOLOGY_VERSION — nach der in CR-SM-244 festgeschriebenen Zustaendigkeit (meta-model.ts + format-e-Parser -> META_MODEL_VERSION) fehlte der Bump hier. Eine Entfernung ist major; dass kein Konsument semver-maessig auf diese Konstante verzweigt (schema-guard.ts keyt bewusst auf einen DDL-Fingerprint), macht sie nicht kleiner, nur folgenlos fuer die Bump-Kette. (2) CR-SM-251: `hydrateAttrValue` hydriert typ-geleitet ueber ELEMENT_ATTRIBUTES — boolean/number-Attribute kamen ueber BEIDE Format-E-Pfade als String an, womit die elf `=== true`-Vergleiche in den Regeln jede Ausnahme (concept/external/safety_relevant/spike) ins Leere laufen liessen und ein Export-Reimport bestehende Ausnahmen still entwertete. Verhaltensaenderung am Parser, also hier verbucht. Prior: -REQ→MOD allocate pattern removed (CR-228 A); +FUNC→FUNC compose (blackbox function decomposition)
11
11
  export * from './ontology.js';
12
12
  export * from './rules.js';
13
13
  export * from './conformance-rules.js';
@@ -199,7 +199,7 @@ export type AnalysisArtifactId = z.infer<typeof AnalysisArtifactId>;
199
199
  * artifact was written — I/O, so writing it stays a consumer (graphcode)
200
200
  * concern; contracts only defines the shape.
201
201
  * Stored under `OntologyElement.attributes.analysisFreshness.<AnalysisArtifactId>`
202
- * on the SYS root element (same anchor convention as R-28).
202
+ * on the SYS root element (the anchor convention of the graph-wide AF-01..05 rules).
203
203
  */
204
204
  export declare const AnalysisFreshnessStampSchema: z.ZodObject<{
205
205
  graphVersion: z.ZodNumber;
@@ -147,7 +147,7 @@ export const AnalysisArtifactId = z.enum(['conops', 'fmea', 'trade', 'implplan',
147
147
  * artifact was written — I/O, so writing it stays a consumer (graphcode)
148
148
  * concern; contracts only defines the shape.
149
149
  * Stored under `OntologyElement.attributes.analysisFreshness.<AnalysisArtifactId>`
150
- * on the SYS root element (same anchor convention as R-28).
150
+ * on the SYS root element (the anchor convention of the graph-wide AF-01..05 rules).
151
151
  */
152
152
  export const AnalysisFreshnessStampSchema = z.object({
153
153
  graphVersion: z.number().int().nonnegative(),
@@ -58,11 +58,9 @@ export const RULE_TO_DIMENSION = {
58
58
  // Evidenz-Bindung einer Abnahme, R-19 ihre Praesenz, R-29 ihre Eindeutigkeit.
59
59
  'R-29': 'ver',
60
60
  'R-22': 'alloc', 'R-23': 'alloc', 'R-26': 'schema', 'R-27': 'arch',
61
- // CR-SM-226: R-28 Ebenen-Präsenz (>1 FUNC needs FLOW+SCHEMA) is an architecture rule.
62
- 'R-28': 'arch',
63
61
  // 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;
62
+ // Funktionsblock ueberhaupt im Bauplan haengt — dieselbe Dimension wie R-20 (realRef).
63
+ // NICHT 'uc': R-14..R-17 fragen, ob ein Behaelter gefuellt ist;
66
64
  // diese beiden fragen von der FUNC aus, ob sie angeschlossen ist.
67
65
  'R-30': 'arch', 'R-31': 'arch',
68
66
  // uc
@@ -153,7 +151,6 @@ export const RULE_TO_PHASE = {
153
151
  'R-04': 'PDR', 'R-22': 'PDR', 'R-23': 'PDR',
154
152
  'R-15': 'PDR',
155
153
  'FC-01': 'PDR', 'FC-03': 'PDR', 'FC-04': 'PDR',
156
- 'R-28': 'PDR', // Ebenen-Präsenz (CR-SM-226)
157
154
  // CR-GC-366: Anschluss des Funktionsbaus — gehoert an dasselbe Gate wie R-15/IO-01,
158
155
  // die auf derselben Kette aufsetzen.
159
156
  'R-30': 'PDR', 'R-31': 'PDR',
@@ -174,7 +174,7 @@ export interface RuleDefinition {
174
174
  *
175
175
  * **CR-SM-239 — „ganzer Graph" ist etwas anderes als „diese Gruppe".** `['graph']` markiert
176
176
  * eine Regel, die **einmal je Graph** prueft statt ueber eine Elementmenge: die
177
- * Analyse-Freshness-Stempel (AF-01..05) und die Ebenen-Praesenz (R-28). Sie tragen KEINE
177
+ * Analyse-Freshness-Stempel (AF-01..05). Sie tragen KEINE
178
178
  * Grundgesamtheit bei, denn sie haben keine — der Stempel haengt zwar unter SYS, geprueft
179
179
  * wird aber der Graph, nicht das Element.
180
180
  *
package/dist/se/rules.js CHANGED
@@ -37,6 +37,21 @@ export const RuleViolation = z.object({
37
37
  // Graph lookup helpers (shared across rules)
38
38
  // ---------------------------------------------------------------------------
39
39
  /** Find the MOD a FUNC/SCHEMA is allocated to. */
40
+ /**
41
+ * CR-SM-256: die EINE Definition von "zerlegt". Ein FUNC mit FUNC-Kindern ist ein Rollup
42
+ * seiner Kinder — ein Blackbox-Block, durch den nichts fliesst und der keine Anforderung
43
+ * erfuellt, die nicht schon ein Blatt erfuellt. Die Pflichten liegen vollstaendig auf den
44
+ * Blaettern (so schon R-30 seit CR-SM-249, so R-20 seit CR-210).
45
+ *
46
+ * Bewusst EIN Helper statt drei Kopien: eine zweite Definition von "Blatt" waere ein
47
+ * zweiter Weg zu derselben Aussage, und der billigere gewinnt immer.
48
+ */
49
+ function decomposedFuncs(graph) {
50
+ const funcIds = new Set(graph.elements.filter(e => e.type === 'FUNC').map(f => f.id));
51
+ return new Set(graph.traces
52
+ .filter(t => t.type === 'compose' && funcIds.has(t.source) && funcIds.has(t.target))
53
+ .map(t => t.source));
54
+ }
40
55
  function findParentModule(graph, elementId) {
41
56
  const trace = graph.traces.find(t => t.source === elementId && t.type === 'allocate');
42
57
  return trace?.target;
@@ -101,7 +116,13 @@ function reqMustHaveVerification(graph) {
101
116
  // R-02: Every FUNC must satisfy at least one REQ
102
117
  // ---------------------------------------------------------------------------
103
118
  function funcMustSatisfyReq(graph) {
104
- const funcs = graph.elements.filter(e => e.type === 'FUNC');
119
+ // CR-SM-256: Grundgesamtheit sind die BLAETTER. Ein zerlegter FUNC erfuellt keine REQ,
120
+ // die nicht schon eine seiner Blatt-Funktionen erfuellt — wer ihn befriedigen will,
121
+ // muss eine satisfy-Kante erfinden, die dieselbe REQ ein zweites Mal beansprucht.
122
+ // Am graphcode-Selbstmodell (graphVersion 171) melden 12 der 13 Bloecke R-02 UND R-31,
123
+ // also dieselbe Ursache zweimal gezaehlt — die Klasse CR-SM-235/-242.
124
+ const decomposed = decomposedFuncs(graph);
125
+ const funcs = graph.elements.filter(e => e.type === 'FUNC' && !decomposed.has(e.id));
105
126
  const allReqs = graph.elements.filter(e => e.type === 'REQ');
106
127
  // CR-GC-366: der Filter prueft den ZIELTYP. Vorher war er zieltyp-blind (`type === 'satisfy'`),
107
128
  // womit ein `FUNC -satisfy-> UC` die Regel stumm schaltete, obwohl kein Requirement erfuellt war —
@@ -510,25 +531,53 @@ function ucMustHaveCompose(graph) {
510
531
  }));
511
532
  }
512
533
  // ---------------------------------------------------------------------------
513
- // R-15: FCHAIN must have at least 1 compose trace (→ FUNC) (CR-117)
534
+ // R-15: FCHAIN completeness a chain needs functions BELOW it and a use case
535
+ // ABOVE it (CR-117, second leg CR-SM-249).
536
+ //
537
+ // Der tragende Pfad vom Verhalten zum Zweck ist `UC -compose-> FCHAIN
538
+ // -compose-> FUNC` (seit Ontologie 7.0.0 der einzige). Geprueft war nur das
539
+ // untere Bein: R-15 verlangte Funktionen unter der Kette, niemand verlangte
540
+ // einen UC ueber ihr. Eine Kette ohne UC beantwortet die Leitfrage "welche
541
+ // Wirkkette ist betroffen, wenn ich diese Funktion aendere?" auf halbem Weg.
542
+ // Belegt: `FCHAIN-doc-export` (graphcode) traegt zwei Funktionen und dient
543
+ // keinem UC.
544
+ //
545
+ // Dieselbe rule_id fuer beide Beine, nach dem Muster von R-10 (FLOW braucht
546
+ // Produzent UND Konsument): ein Belang, eine ID, bis zu zwei Meldungen je
547
+ // Element. Eine eigene ID kostete dauerhaft einen Nenner-Anteil, eine
548
+ // Katalogzeile, eine readiness-Zuordnung und einen Golden-File-Eintrag — fuer
549
+ // einen einzigen Befund ueber beide Selbstmodelle.
514
550
  // ---------------------------------------------------------------------------
515
- function fchainMustHaveCompose(graph) {
551
+ function fchainCompleteness(graph) {
516
552
  const fchains = graph.elements.filter(e => e.type === 'FCHAIN');
517
553
  const funcs = graph.elements.filter(e => e.type === 'FUNC');
518
- return fchains
519
- .filter(fc => !graph.traces.some(t => t.source === fc.id && t.type === 'compose'))
520
- .map(fc => ({
521
- rule_id: 'R-15',
522
- severity: 'warning',
523
- element_id: fc.id,
524
- message: `${fc.id} has no compose traces (no functions in chain)`,
525
- fix_hint: 'Add FUNC elements via compose trace',
526
- context: {
527
- element_type: fc.type,
528
- element_name: fc.name,
529
- candidate_targets: toCandidates(funcs),
530
- },
531
- }));
554
+ const ucs = graph.elements.filter(e => e.type === 'UC');
555
+ const ucIds = new Set(ucs.map(u => u.id));
556
+ const violations = [];
557
+ for (const fc of fchains) {
558
+ const ctx = { element_type: fc.type, element_name: fc.name };
559
+ if (!graph.traces.some(t => t.source === fc.id && t.type === 'compose')) {
560
+ violations.push({
561
+ rule_id: 'R-15',
562
+ severity: 'warning',
563
+ element_id: fc.id,
564
+ message: `${fc.id} has no compose traces (no functions in chain)`,
565
+ fix_hint: 'Add FUNC elements via compose trace',
566
+ context: { ...ctx, candidate_targets: toCandidates(funcs) },
567
+ });
568
+ }
569
+ if (!graph.traces.some(t => t.target === fc.id && t.type === 'compose' && ucIds.has(t.source))) {
570
+ violations.push({
571
+ rule_id: 'R-15',
572
+ severity: 'warning',
573
+ element_id: fc.id,
574
+ message: `${fc.id} serves no use case (no UC -compose-> FCHAIN)`,
575
+ fix_hint: 'Attach the chain to the use case it realises (UC -compose-> FCHAIN)',
576
+ context: { ...ctx, candidate_targets: toCandidates(ucs, fc) },
577
+ });
578
+ }
579
+ }
580
+ return violations;
532
581
  }
533
582
  // ---------------------------------------------------------------------------
534
583
  // R-16: ACTOR must have at least 1 io trace (CR-117)
@@ -990,92 +1039,60 @@ function physicalModMustHaveRealRef(graph) {
990
1039
  }));
991
1040
  }
992
1041
  // ---------------------------------------------------------------------------
993
- // R-28: Ebenen-Präsenz architecture-level presence (CR-SM-226).
994
- // Closes the vacuous-complete hole: with 0 or 1 FUNC, per-element rules like
995
- // R-15/FC-04/SC-04 fire 0 times and every completeness leg reads "complete" —
996
- // not because the architecture is done, but because there is nothing to check
997
- // yet. Once >1 FUNC exists, the graph must ALSO carry at least one FLOW (data
998
- // moves between functions) AND at least one SCHEMA (that data has a
999
- // contract) ONE combined rule, not staged PDR/CDR checks (the CR draft's
1000
- // two-stage proposal was simplified in Familie-Review 2026-08-04).
1042
+ // R-28 (Ebenen-Präsenz) ist mit CR-SM-247 ersatzlos entfallen — nicht weil sie falsch war,
1043
+ // sondern weil sie seit CR-GC-366 doppelt ist. Sie schloss das Vacuous-Complete-Loch (mit 0/1
1044
+ // FUNC feuert keine Pro-Element-Regel, alles liest "fertig"); beide Hälften trägt heute je eine
1045
+ // präzisere Regel: kein FLOW R-31 (io-Verdrahtung, je FUNC statt einmal je Graph) + IO-01,
1046
+ // kein SCHEMA SC-04 (je FLOW). Probe (SYS+UC+FCHAIN+3 FUNC, ohne FLOW/SCHEMA): 28 Befunde aus
1047
+ // 18 Regeln, ohne R-28 bleiben 17 das Loch bleibt zu. Gemessen feuerte sie 1× / 0× an den
1048
+ // Selbstmodellen, dort neben 14× IO-01 und 10× R-31. Bewusst in Kauf genommen: die
1049
+ // SCHEMA-Absenz rutscht von PDR nach CDR, weil SC-04 erst feuert, wenn FLOWs existieren.
1001
1050
  // ---------------------------------------------------------------------------
1002
- function ebenenPraesenz(graph) {
1003
- const funcs = graph.elements.filter(e => e.type === 'FUNC');
1004
- if (funcs.length <= 1)
1005
- return [];
1006
- const flows = graph.elements.filter(e => e.type === 'FLOW');
1007
- const schemas = graph.elements.filter(e => e.type === 'SCHEMA');
1008
- const missingLevels = [];
1009
- if (flows.length === 0)
1010
- missingLevels.push('FLOW');
1011
- if (schemas.length === 0)
1012
- missingLevels.push('SCHEMA');
1013
- if (missingLevels.length === 0)
1014
- return [];
1015
- // Anchor the graph-wide violation on SYS (the root) if present, else the
1016
- // first FUNC — there is no single "population" element this rule checks.
1017
- const anchor = graph.elements.find(e => e.type === 'SYS') ?? funcs[0];
1018
- return [{
1019
- rule_id: 'R-28',
1020
- severity: 'warning',
1021
- element_id: anchor.id,
1022
- message: `Graph has ${funcs.length} FUNCs but no ${missingLevels.join(' and no ')} element — architecture level(s) absent`,
1023
- fix_hint: `Add at least one ${missingLevels.join(' and one ')} element to bind the functional and data-level architecture`,
1024
- context: { element_type: anchor.type, element_name: anchor.name },
1025
- }];
1026
- }
1027
1051
  // ---------------------------------------------------------------------------
1028
- // R-30: FUNC gehoert in eine Wirkkette (CR-GC-366)
1029
- // Die Ontologie deckte nur die Gegenrichtung ab: R-15 verlangt, dass eine FCHAIN
1030
- // Funktionen hat — niemand verlangte, dass eine Funktion zu einer FCHAIN gehoert.
1031
- // Genau daran haengt aber die uebrige Absicherung: IO-01 bildet FLOW-Pfade nur
1032
- // zwischen FUNCs DERSELBEN Kette, R-21 fordert den Integrationstest je Kette.
1033
- // Eine FUNC ausserhalb jeder Kette faellt durch beide Netze, ohne dass etwas meldet.
1034
- // Severity warning, nicht error: am Selbstmodell trifft es 60 von 82 FUNC — ein
1035
- // error wuerde ueber das Delta-Gate jede weitere Mutation blockieren und waere
1036
- // Neubau-Zwang statt Steuerung.
1052
+ // R-30: jedes BLATT gehoert in eine Wirkkette (CR-GC-366, Grundgesamtheit
1053
+ // korrigiert in CR-SM-249).
1054
+ //
1055
+ // Die Ontologie deckte nur die Gegenrichtung ab: R-15 verlangt, dass eine
1056
+ // FCHAIN Funktionen hat — niemand verlangte, dass eine Funktion zu einer
1057
+ // FCHAIN gehoert. Genau daran haengt aber die uebrige Absicherung: IO-01
1058
+ // bildet FLOW-Pfade nur zwischen FUNCs DERSELBEN Kette, R-21 fordert den
1059
+ // Integrationstest je Kette. Eine FUNC ausserhalb jeder Kette faellt durch
1060
+ // beide Netze, ohne dass etwas meldet.
1061
+ //
1062
+ // Grundgesamtheit sind AUSSCHLIESSLICH Blaetter (FUNC ohne FUNC-Kinder). Ein
1063
+ // zerlegter FUNC ist ein Rollup seiner Kinder und hat keinen eigenen
1064
+ // Bindungszustand — er *darf* auch keinen haben: FC-03 ("FCHAIN is flat")
1065
+ // verbietet ein Kettenglied mit verschachtelter Zerlegung. Die erste Fassung
1066
+ // forderte damit einen Zustand, den eine andere Regel untersagt; am
1067
+ // graphcode-Gate quittiert (graphVersion 111, zurueckgenommen in 112).
1068
+ //
1069
+ // Die Aufwaerts-Vererbung aus CR-GC-366 ("ein Vorfahre steht in einer Kette →
1070
+ // Kind frei") entfaellt ersatzlos: sie konnte nur greifen, wenn ein Block
1071
+ // Kettenglied ist, und haette sonst ein unverbundenes Blatt stumm geschaltet.
1072
+ // Die Anforderung liegt jetzt vollstaendig auf den Blaettern — der Block wird
1073
+ // gruen, ohne je eine eigene Kante zu tragen.
1074
+ //
1075
+ // Severity warning, nicht error: am Selbstmodell trifft es 43 von 69 Blaettern
1076
+ // — ein error wuerde ueber das Delta-Gate jede weitere Mutation blockieren und
1077
+ // waere Neubau-Zwang statt Steuerung.
1037
1078
  // ---------------------------------------------------------------------------
1038
1079
  function funcMustBeInEffectChain(graph) {
1039
1080
  const funcs = graph.elements.filter(e => e.type === 'FUNC');
1040
1081
  const fchains = graph.elements.filter(e => e.type === 'FCHAIN');
1041
1082
  const funcIds = new Set(funcs.map(f => f.id));
1042
1083
  const fchainIds = new Set(fchains.map(fc => fc.id));
1084
+ // CR-SM-256: dieselbe Definition wie R-02 und R-31, nicht mehr die lokale Kopie.
1085
+ const decomposed = decomposedFuncs(graph);
1043
1086
  const inChain = new Set(graph.traces
1044
1087
  .filter(t => t.type === 'compose' && fchainIds.has(t.source) && funcIds.has(t.target))
1045
1088
  .map(t => t.target));
1046
- // Zerlegung erbt Mitgliedschaft nach unten: steht der Elternteil in einer Kette,
1047
- // sind seine Kinder dessen Realisierung eine Ebene tiefer (TRACE_PATTERNS
1048
- // `FUNC -compose-> FUNC`) und damit mitgebunden. Ohne diesen Schritt meldete die
1049
- // Regel jede Sub-Funktion eines Kettenmitglieds als Waise — ein Fehlbefund aus
1050
- // der Ontologie selbst. Am Selbstmodell aendert der Schritt heute nichts
1051
- // (Zerlegungsbaum und Ketten sind dort disjunkt), er verhindert den Fehlbefund
1052
- // fuer jedes Modell, das beides kombiniert.
1053
- const parentOf = new Map();
1054
- for (const t of graph.traces) {
1055
- if (t.type === 'compose' && funcIds.has(t.source) && funcIds.has(t.target)) {
1056
- parentOf.set(t.target, t.source);
1057
- }
1058
- }
1059
- const reachesChain = (start) => {
1060
- const seen = new Set([start]);
1061
- let cur = start;
1062
- while (cur) {
1063
- if (inChain.has(cur))
1064
- return true;
1065
- cur = parentOf.get(cur);
1066
- if (!cur || seen.has(cur))
1067
- return false;
1068
- seen.add(cur);
1069
- }
1070
- return false;
1071
- };
1072
1089
  return funcs
1073
- .filter(fn => !reachesChain(fn.id))
1090
+ .filter(fn => !decomposed.has(fn.id) && !inChain.has(fn.id))
1074
1091
  .map(fn => ({
1075
1092
  rule_id: 'R-30',
1076
1093
  severity: 'warning',
1077
1094
  element_id: fn.id,
1078
- message: `${fn.id} belongs to no function chain (no FCHAIN compose, directly or via a parent FUNC)`,
1095
+ message: `${fn.id} belongs to no function chain (no FCHAIN -compose-> FUNC)`,
1079
1096
  fix_hint: 'Add the FUNC to the FCHAIN of the use case it serves (FCHAIN -compose-> FUNC)',
1080
1097
  context: {
1081
1098
  element_type: fn.type,
@@ -1095,7 +1112,13 @@ function funcMustBeInEffectChain(graph) {
1095
1112
  // eigenen Nenner-Beitrag, was CR-SM-242 fuer IO-01 als Fehlmessung nachgewiesen hat.
1096
1113
  // ---------------------------------------------------------------------------
1097
1114
  function funcMustBeWired(graph) {
1098
- const funcs = graph.elements.filter(e => e.type === 'FUNC');
1115
+ // CR-SM-256: Grundgesamtheit sind die BLAETTER, wie bei R-02 und R-30. Durch einen
1116
+ // Blackbox-Block fliessen keine Daten — die io-Kanten haengen an seinen Kindern.
1117
+ // CR-GC-375 hat das fuer R-31 ausdruecklich offengelassen ("eine eigene Frage, hier
1118
+ // bewusst nicht"); die Messung liegt jetzt vor: 12 von 13 Bloecken am
1119
+ // graphcode-Selbstmodell melden nur deshalb, und keiner aus einem anderen Grund.
1120
+ const decomposed = decomposedFuncs(graph);
1121
+ const funcs = graph.elements.filter(e => e.type === 'FUNC' && !decomposed.has(e.id));
1099
1122
  const flows = graph.elements.filter(e => e.type === 'FLOW');
1100
1123
  const io = graph.traces.filter(t => t.type === 'io');
1101
1124
  const hasInput = new Set(io.map(t => t.target)); // FLOW -io-> FUNC
@@ -1132,7 +1155,7 @@ export const V3_RULES = [
1132
1155
  { id: 'R-04', name: 'Module size relative to crossing flows', severity: 'warning', evaluate: maxModuleSize, domain: ['MOD'] },
1133
1156
  { id: 'R-05', name: 'TEST must verify REQ', severity: 'warning', evaluate: testMustVerifyReq, domain: ['TEST'] },
1134
1157
  { id: 'R-14', name: 'UC must have compose', severity: 'warning', evaluate: ucMustHaveCompose, domain: ['UC'] },
1135
- { id: 'R-15', name: 'FCHAIN must have compose', severity: 'warning', evaluate: fchainMustHaveCompose, domain: ['FCHAIN'] },
1158
+ { id: 'R-15', name: 'FCHAIN completeness', severity: 'warning', evaluate: fchainCompleteness, domain: ['FCHAIN'] },
1136
1159
  { id: 'R-16', name: 'ACTOR must have io', severity: 'warning', evaluate: actorMustHaveTrace, domain: ['ACTOR'] },
1137
1160
  { id: 'R-17', name: 'SYS must have compose', severity: 'warning', evaluate: sysMustHaveCompose, domain: ['SYS'] },
1138
1161
  { id: 'R-08', name: 'Trace consistency', severity: 'error', evaluate: traceConsistency, domain: ['all'] },
@@ -1156,8 +1179,7 @@ export const V3_RULES = [
1156
1179
  { id: 'RD-04', name: 'Decomposition breadth', severity: 'warning', evaluate: decompositionBreadth, domain: ['FUNC', 'MOD', 'SYS'] },
1157
1180
  { id: 'MS-01', name: 'Milestone empty scope', severity: 'warning', evaluate: msEmptyScope, domain: ['MS'] },
1158
1181
  { id: 'MS-02', name: 'Milestone dangling dependency', severity: 'error', evaluate: msDanglingDependency, domain: ['MS'] },
1159
- { id: 'R-28', name: 'Ebenen-Präsenz (FLOW+SCHEMA when funcCount>1)', severity: 'warning', evaluate: ebenenPraesenz, domain: ['graph'] },
1160
- { id: 'R-30', name: 'FUNC must belong to a function chain', severity: 'warning', evaluate: funcMustBeInEffectChain, domain: ['FUNC'] },
1182
+ { id: 'R-30', name: 'FUNC leaf must belong to a function chain', severity: 'warning', evaluate: funcMustBeInEffectChain, domain: ['FUNC'] },
1161
1183
  { id: 'R-31', name: 'FUNC must be wired (io input + output)', severity: 'warning', evaluate: funcMustBeWired, domain: ['FUNC'] },
1162
1184
  ];
1163
1185
  /** Run all rules against a graph. CR-SM-236: `policy` ist Pflicht — wie bei `evaluateAllRules`. */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sigloch/contracts",
3
- "version": "5.0.1",
3
+ "version": "6.1.0",
4
4
  "type": "module",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",