@sdd-method/sdd-cli 1.23.1 → 1.24.0

package/dist/lib/catalogue/rubric-coverage-map.yaml

@@ -1,8 +1,8 @@
 # GENERATED — DO NOT EDIT. This file is a projection of the authored model (M-ADR 0210 §4.6, flip 2):
 #   docs/method/foundations/schemas/catalogue-schema-meta.tql — coverage-meta + relationship-meta rows carry
 #   every entry here; the relations themselves (roles, players) are in catalogue-schema.tql.
-# Regenerate:  python3 orchestration/scripts/check-catalogue-schema-roundtrip.py --write
-# Guard:       python3 orchestration/scripts/check-catalogue-schema-roundtrip.py   (any difference fails the build)
+# Regenerate:  sdd-cli metamodel roundtrip --write
+# Guard:       sdd-cli metamodel roundtrip   (any difference fails the build)
 # Vocabularies, rulings and the reading of each token live in the authored .tql header, as comments.
 coverage:
   c4_system_kind:
@@ -40,7 +40,7 @@ coverage:
   products:
     kind: entity
     scoring: rubric-pair
-    instrument: 'forward: rubrics/product-definition-rubric.md · reverse: reverse/rubrics/product-synthesis-quality.md'
+    instrument: "forward: rubrics/product-definition-rubric.md · reverse: reverse/rubrics/product-synthesis-quality.md"
     relationships:
       domain_id:
         class: membership
@@ -71,7 +71,7 @@ coverage:
   adrs:
     kind: entity
     scoring: rubric-pair
-    instrument: 'forward: rubrics/adr-quality-rubric.md · reverse: reverse/rubrics/reverse-adr-quality.md'
+    instrument: "forward: rubrics/adr-quality-rubric.md · reverse: reverse/rubrics/reverse-adr-quality.md"
     relationships:
       domain_id:
         class: membership
@@ -82,7 +82,7 @@ coverage:
   glossary_items:
     kind: entity
     scoring: rubric-pair
-    instrument: 'forward: rubrics/glossary-rubric.md · reverse: reverse/rubrics/reverse-glossary-quality.md'
+    instrument: "forward: rubrics/glossary-rubric.md · reverse: reverse/rubrics/reverse-glossary-quality.md"
     relationships:
       owning_domain_id:
         class: membership
@@ -92,20 +92,20 @@ coverage:
         impact_flow: toward-source
   glossary_xref:
     kind: edge
+    scoring: derived-edge
     class: xref
     impact_flow: none
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   entity_glossary:
     kind: edge
+    scoring: derived-edge
     class: xref
     impact_flow: none
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   services:
     kind: entity
     scoring: re-targeted
-    instrument: 'deliberately no dedicated rubric: boundary scored by rubrics/domain-architecture-rubric.md B5/B9 against the declared set (repo-config, input 3); source absence by scripts/check-repo-config-coverage.sh; reverse doc form by reverse/rubrics/repo-doc-quality.md'
+    instrument: "deliberately no dedicated rubric: boundary scored by rubrics/domain-architecture-rubric.md B5/B9 against the declared set (repo-config, input 3); source absence by scripts/check-repo-config-coverage.sh; reverse doc form by reverse/rubrics/repo-doc-quality.md"
     relationships:
       product_id:
         class: membership
@@ -119,7 +119,7 @@ coverage:
   capabilities:
     kind: entity
     scoring: rubric-pair
-    instrument: 'forward: rubrics/intent-quality-rubric.md · reverse: reverse/rubrics/reverse-capability-spec-quality.md'
+    instrument: "forward: rubrics/intent-quality-rubric.md · reverse: reverse/rubrics/reverse-capability-spec-quality.md"
     relationships:
       domain_id:
         class: membership
@@ -144,7 +144,7 @@ coverage:
   features:
     kind: entity
     scoring: rubric-pair
-    instrument: 'forward: rubrics/intent-quality-rubric.md (feature tier) + rubrics/feature-grounding-rubric.md · reverse: reverse/rubrics/reverse-feature-grounding-quality.md'
+    instrument: "forward: rubrics/intent-quality-rubric.md (feature tier) + rubrics/feature-grounding-rubric.md · reverse: reverse/rubrics/reverse-feature-grounding-quality.md"
     relationships:
       product_id:
         class: membership
@@ -161,7 +161,7 @@ coverage:
   personas:
     kind: entity
     scoring: rubric-pair
-    instrument: 'forward: rubrics/persona-rubric.md · reverse: reverse/rubrics/reverse-persona-quality.md'
+    instrument: "forward: rubrics/persona-rubric.md · reverse: reverse/rubrics/reverse-persona-quality.md"
     relationships:
       product_id:
         class: membership
@@ -177,7 +177,7 @@ coverage:
   contracts:
     kind: entity
     scoring: rubric-pair
-    instrument: 'forward: rubrics/contract-quality-rubric.md · reverse: reverse/rubrics/reverse-contract-quality.md'
+    instrument: "forward: rubrics/contract-quality-rubric.md · reverse: reverse/rubrics/reverse-contract-quality.md"
     relationships:
       service_id:
         class: membership
@@ -236,7 +236,7 @@ coverage:
   repositories:
     kind: entity
     scoring: predicate
-    instrument: 'deliberately no rubric: repo-config is four structural fields; scripts/check-repo-config-coverage.sh covers the silent absences, builder findings own enum/orphan/divergence'
+    instrument: "deliberately no rubric: repo-config is four structural fields; scripts/check-repo-config-coverage.sh covers the silent absences, builder findings own enum/orphan/divergence"
     relationships:
       domain_id:
         class: membership
@@ -247,7 +247,7 @@ coverage:
   domain_models:
     kind: entity
     scoring: rubric-pair
-    instrument: 'forward: rubrics/domain-architecture-rubric.md · reverse: reverse/rubrics/reverse-data-model-quality.md'
+    instrument: "forward: rubrics/domain-architecture-rubric.md · reverse: reverse/rubrics/reverse-data-model-quality.md"
     relationships:
       domain_id:
         class: membership
@@ -255,7 +255,7 @@ coverage:
   entities:
     kind: entity
     scoring: predicate
-    instrument: 'verified covered: builder reads glossary-alignment-manifest (entities-manifest builder); absence fires the glossary-xref + data-model-entities coverage checks (sdd-cli catalogue validate --coverage); authored population is 1 forward + 1 reverse — a rubric would be ceremony'
+    instrument: "verified covered: builder reads glossary-alignment-manifest (entities-manifest builder); absence fires the glossary-xref + data-model-entities coverage checks (sdd-cli catalogue validate --coverage); authored population is 1 forward + 1 reverse — a rubric would be ceremony"
     relationships:
       domain_id:
         class: membership
@@ -268,246 +268,246 @@ coverage:
         impact_flow: none
   repo_capability:
     kind: edge
+    scoring: derived-edge
     class: realisation
     impact_flow: both
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   repo_capability_exemption:
     kind: annotation
+    scoring: derived-edge
     class: attribute
     impact_flow: none
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   service_capability_exemption:
     kind: annotation
+    scoring: derived-edge
     class: attribute
     impact_flow: none
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   external_system_exemption:
     kind: annotation
+    scoring: derived-edge
     class: attribute
     impact_flow: none
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   repo_contract:
     kind: edge
+    scoring: derived-edge
     class: realisation
     impact_flow: both
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   product_capability:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   product_service:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   service_contract:
     kind: edge
+    scoring: derived-edge
     class: realisation
     impact_flow: both
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   service_event:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow_by:
       column: role
       values:
         publishes: toward-target
         consumes: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   service_entity:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   capability_feature:
     kind: edge
+    scoring: derived-edge
     class: traceability
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   capability_service:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   capability_event:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   capability_contract:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   journey_feature:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   persona_feature:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   feature_service:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   feature_event:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   feature_repo:
     kind: edge
+    scoring: derived-edge
     class: realisation
     impact_flow: both
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   feature_contract:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   feature_subscription_channels:
     kind: annotation
+    scoring: derived-edge
     class: attribute
     impact_flow: none
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   capability_domain_model:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   feature_domain_model:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   persona_journey:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   persona_screen:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   persona_c4system:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   persona_container:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   system_external_dependency:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   container_dependency:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   system_system_dependency:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   c4_container_entity:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   c4_system_entity:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   capability_adr:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   adr_supersedes:
     kind: edge
+    scoring: derived-edge
     class: lineage
     impact_flow: none
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   product_platform_dependencies:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   cross_sdd_platform_capability:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   application_data_plane_bindings:
     kind: annotation
+    scoring: derived-edge
     class: attribute
     impact_flow: none
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   application_data_plane_deviations:
     kind: annotation
+    scoring: derived-edge
     class: attribute
     impact_flow: none
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   application_conformance_coverage:
     kind: annotation
+    scoring: derived-edge
     class: attribute
     impact_flow: none
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   screens:
     kind: entity
     scoring: rubric-pair
-    instrument: 'forward: rubrics/screen-spec-rubric.md above the mechanical floor (guides/screen-spec-depth-rubric.md) · reverse: reverse/rubrics/reverse-screen-spec-quality.md'
+    instrument: "forward: rubrics/screen-spec-rubric.md above the mechanical floor (guides/screen-spec-depth-rubric.md) · reverse: reverse/rubrics/reverse-screen-spec-quality.md"
     relationships:
       product_id:
         class: membership
@@ -522,21 +522,21 @@ coverage:
         impact_flow: toward-target
   screen_component:
     kind: edge
+    scoring: derived-edge
     class: membership
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   screen_feature:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   screen_action:
     kind: edge
+    scoring: derived-edge
     class: dependency
     impact_flow: toward-source
-    scoring: derived-edge
     reason: derived from entity rows or manifest blocks scored at the owning entity
   conformance_finding:
     kind: finding
@@ -552,9 +552,9 @@ coverage:
         impact_flow: none
   quality_score_dimensions:
     kind: annotation
+    scoring: derived-edge
     class: attribute
     impact_flow: none
-    scoring: derived-edge
     reason: derived from the parent quality_scores row; the dimension keys are the rubric's own vocabulary, governed by the rubric that declares them
   quality_gate:
     kind: enum
@@ -582,9 +582,9 @@ coverage:
         impact_flow: none
   scaffold_items:
     kind: annotation
+    scoring: derived-edge
     class: traceability
     impact_flow: none
-    scoring: derived-edge
     reason: derived from the authored scaffold manifest (M-ADR 0207 §4.1); the polymorphic target deliberately declares no FK — resolution is conditional on state — so the row is a governance trace, not an impact path
   scaffold_status:
     kind: enum

package/dist/lib/metamodel/roundtrip-gate.d.ts

@@ -0,0 +1,52 @@
+import type { MapProjection, SchemaProjection } from "./schema-projection.js";
+export declare const CANONICAL_PATHS: {
+    readonly tql: "docs/method/foundations/schemas/catalogue-schema.tql";
+    readonly meta: "docs/method/foundations/schemas/catalogue-schema-meta.tql";
+    readonly schema: "docs/method/foundations/schemas/catalogue-schema.yaml";
+    readonly map: "orchestration/rubric-coverage-map.yaml";
+};
+/** Emit projection 1. The three header scalars are QUOTED: two downstream readers take the version textually. */
+export declare function emitSchema(out: SchemaProjection): string;
+export declare function emitMap(cov: MapProjection): string;
+export interface Regenerated {
+    readonly schemaText: string;
+    readonly mapText: string;
+    readonly schema: SchemaProjection;
+    readonly map: MapProjection;
+}
+/** Parse + project + emit from the two authored texts. Throws ParseError (fail-closed). */
+export declare function regenerateFromText(tqlText: string, metaText: string): Regenerated;
+interface Mutation {
+    readonly label: string;
+    readonly tql: string;
+    readonly meta: string;
+}
+export declare function mutations(tql: string, meta: string): Mutation[];
+export interface ControlResult {
+    readonly label: string;
+    readonly refused: boolean;
+    readonly reason: string;
+}
+export declare function runControls(tql: string, meta: string): {
+    ok: boolean;
+    fired: number;
+    total: number;
+    results: ControlResult[];
+    cleanError?: string;
+};
+export declare function semanticDiff(a: unknown, b: unknown, path?: string): Generator<string>;
+export interface GateInputs {
+    /** The canonical method repo root (defaults to cwd). */
+    readonly root?: string;
+    readonly mode?: "steady" | "write" | "self-test" | "migrate";
+    readonly oldSchema?: string;
+    readonly oldMap?: string;
+}
+/** Run the gate. Exit codes: 0 pass; 1 projection differs; 2 authored form does not parse; 3 controls did not all fire. */
+export declare function runMetamodelRoundtrip(inputs: GateInputs, write: (s: string) => void): Promise<{
+    exitCode: number;
+}>;
+/** Test helper: write two authored texts to a temp dir laid out like the canonical repo. */
+export declare function withAuthoredTemp<T>(tql: string, meta: string, fn: (root: string) => Promise<T>): Promise<T>;
+export {};
+//# sourceMappingURL=roundtrip-gate.d.ts.map

package/dist/lib/metamodel/roundtrip-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roundtrip-gate.d.ts","sourceRoot":"","sources":["../../../src/lib/metamodel/roundtrip-gate.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE9E,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AA2BX,iHAAiH;AACjH,wBAAgB,UAAU,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAMxD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAElD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;CAC7B;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAMjF;AAGD,UAAU,QAAQ;IAChB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAaD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAc/D;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAwBnJ;AAGD,wBAAiB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,SAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAenF;AAED,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAgBD,2HAA2H;AAC3H,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA+GzH;AAED,4FAA4F;AAC5F,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAYjH"}