@sigloch/graphcode-client 1.3.1 → 1.5.0

package/dist/index.d.ts

@@ -19,5 +19,5 @@
 export { HOST_SOCK_BASENAME, callHost, type ShimRequest, type ShimResponse, } from './host-client.js';
 export { MARKDOWN_VIEWS, VIEW_FILENAMES, type MarkdownView } from './view-catalog.js';
 export { GRAPHCODE_INCOSE_SCOPE, PHASE_GATE_RULES, PHASE_GATE_LABELS, PHASE_GATE_CREATIONS, IMPL_GATE_PHASE, IMPL_GATE_MILESTONES, IMPL_GATE_RULES, ABSENT_CREATION_PROVIDER, creationBlockingMsg, summarizeReadiness, computeReadiness, scoreReadiness, getFamilyRuleIds, type IncoseScope, type CreationCurrency, type CreationCurrencyProvider, type ReadinessDimension, type ReadinessGate, type ReadinessReport, } from './readiness.js';
-export { NEUTRAL_COMPLETENESS, COMPLETENESS_SLICES, scoreCompleteness, typeOf, type CGraph, type CNode, type GateCompleteness, type CompletenessLeg, } from './readiness-completeness.js';
+export { NEUTRAL_COMPLETENESS, COMPLETENESS_SLICES, scoreCompleteness, typeOf, type CGraph, type CNode, GateCompleteness, type CompletenessLeg, } from './readiness-completeness.js';
 export * from './panels.js';

package/dist/index.js

@@ -19,5 +19,5 @@
 export { HOST_SOCK_BASENAME, callHost, } from './host-client.js';
 export { MARKDOWN_VIEWS, VIEW_FILENAMES } from './view-catalog.js';
 export { GRAPHCODE_INCOSE_SCOPE, PHASE_GATE_RULES, PHASE_GATE_LABELS, PHASE_GATE_CREATIONS, IMPL_GATE_PHASE, IMPL_GATE_MILESTONES, IMPL_GATE_RULES, ABSENT_CREATION_PROVIDER, creationBlockingMsg, summarizeReadiness, computeReadiness, scoreReadiness, getFamilyRuleIds, } from './readiness.js';
-export { NEUTRAL_COMPLETENESS, COMPLETENESS_SLICES, scoreCompleteness, typeOf, } from './readiness-completeness.js';
+export { NEUTRAL_COMPLETENESS, COMPLETENESS_SLICES, scoreCompleteness, typeOf, GateCompleteness, } from './readiness-completeness.js';
 export * from './panels.js';

package/dist/readiness-completeness.d.ts

@@ -21,19 +21,18 @@
  *
  * @author andreas@siglochconsulting
  */
+import { z } from 'zod/v4';
 import type { Graph } from '@sigloch/graph-api-core';
 import type { RuleViolation } from '@sigloch/contracts/harness';
 export type CGraph = Pick<Graph, 'nodes' | 'edges'>;
 export type CNode = Graph['nodes'][number];
-/** A gate's structural completeness over its driving population. */
-export interface GateCompleteness {
-    /** Source elements whose chain leg is complete. */
-    covered: number;
-    /** Total source elements evaluated across the gate's legs (the denominator). */
-    total: number;
-    /** Per-leg misses as `"<leg>: <uid>"` — the on-click drill-down detail. */
-    missing: string[];
-}
+/** A gate's structural completeness over its driving population — ein Zod-Vertrag (CR-SM-361). */
+export declare const GateCompleteness: z.ZodObject<{
+    covered: z.ZodNumber;
+    total: z.ZodNumber;
+    missing: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type GateCompleteness = z.infer<typeof GateCompleteness>;
 /** Neutral completeness for gates that carry no chain slice (impl gates). */
 export declare const NEUTRAL_COMPLETENESS: GateCompleteness;
 export declare const typeOf: (byId: Map<string, CNode>, id: string) => string | undefined;

package/dist/readiness-completeness.js

@@ -1,5 +1,38 @@
+/**
+ * readiness-completeness.ts — the COMPLETENESS dimension of readiness (CR-GC-250,
+ * split out of readiness.ts by CR-GC-260; rebuilt on the rule stream CR-SM-226).
+ *
+ * Its own module because it answers a different question than the rest of readiness:
+ * compliance/gates ask "does any element violate a rule", completeness asks "is the
+ * structural chain covered at all" — the absence case rules cannot see (0 FCHAIN → a
+ * per-element warning rule fires 0 times and the gate reads green).
+ *
+ * CR-SM-226: every leg now reads off a named `@sigloch/contracts` rule instead of
+ * re-walking the graph locally. The former local out-edge/actor-boundary/testRefs/
+ * codeRef/leaf-function helpers were a SECOND, drifting implementation of exactly
+ * what R-15/UC-01/UC-03/FC-04/SC-04/R-19/R-20 already check in `@sigloch/contracts/se`
+ * — deleted. The rule engine stays the single source of truth; this file only
+ * re-groups its violations by the DRIVING population per leg, so an EMPTY
+ * population still counts against the gate (the vacuous-complete case a
+ * per-element warning rule cannot see on its own — closed for real by
+ * `@sigloch/contracts/se`'s R-28 Ebenen-Präsenz, CR-SM-226; die Regel selbst ist mit CR-SM-247 entfallen).
+ *
+ * BROWSER-SAFE — no `node:*` import may enter this file: the panels layer builds on it.
+ *
+ * @author andreas@siglochconsulting
+ */
+import { z } from 'zod/v4';
+/** A gate's structural completeness over its driving population — ein Zod-Vertrag (CR-SM-361). */
+export const GateCompleteness = z.object({
+    /** Source elements whose chain leg is complete. */
+    covered: z.number().int().nonnegative(),
+    /** Total source elements evaluated across the gate's legs (the denominator). */
+    total: z.number().int().nonnegative(),
+    /** Per-leg misses as `"<leg>: <uid>"` — the on-click drill-down detail. */
+    missing: z.array(z.string()),
+});
 /** Neutral completeness for gates that carry no chain slice (impl gates). */
-export const NEUTRAL_COMPLETENESS = { covered: 0, total: 0, missing: [] };
+export const NEUTRAL_COMPLETENESS = GateCompleteness.parse({ covered: 0, total: 0, missing: [] });
 export const typeOf = (byId, id) => byId.get(id)?.type;
 /**
  * Phase-gate → chain legs that must be complete AT THAT PHASE, each backed by
@@ -63,5 +96,5 @@ export function scoreCompleteness(gateId, graph, violations) {
                 covered += 1;
         }
     }
-    return { covered, total, missing };
+    return GateCompleteness.parse({ covered, total, missing }); // CR-SM-361: der Erzeuger prueft seinen Vertrag
 }

package/dist/readiness.js

@@ -46,6 +46,9 @@ const RC_PRESENCE_PARTNER = {
     'RC-04': 'R-26', // SCHEMA realRef parsed at its interface
     'RC-05': 'R-23', // cross-module import the graph does not document
     'RC-06': 'R-23', // external binding on a package the consumer does not depend on
+    'RC-07': 'CR-R01', // CR node agrees with docs/cr — the CR presence rule's gate (CR-SM-329)
+    'RC-08': 'R-26', // SCHEMA realRef is a Zod schema, not a type (CR-SM-358)
+    'RC-09': 'R-26', // SCHEMA parsed only at its modelled interface — code → model (CR-SM-358)
 };
 /**
  * Phase-Readiness gates (INCOSE technical reviews) → the rules each gate owns.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sigloch/graphcode-client",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -36,6 +36,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
   "peerDependencies": {
     "@sigloch/contracts": ">=10 <11",
     "@sigloch/graph-api-core": ">=5 <6"