@comity-dev/schemas 0.2.0 → 0.3.0

package/README.md

@@ -7,7 +7,7 @@ Canonical, machine-readable JSON Schema definitions for Comity package metadata,
 ## Scope
 
 - `package-metadata.v1.json` — required fields and types for every `@comity/*` package's `package.json` (`name`, `version`, `type`, `license`, `engines`, `exports`, `comity.layer`, `comity.implements`).
-- ADR-008 register schema — machine-readable composition exception register.
+- ADR-008 register schema and register — the canonical JSON Schema 2020-12 document and register from `docs/standards/decisions/data/`, embedded at build time (`pnpm --filter @comity-dev/schemas generate`); `adr008CoreExceptionRegister` is derived, never hand-edited. Compile with `createAjv2020Instance()`.
 - `comity-config.json` schema — repository-level configuration shape.
 
 ## Ownership

package/dist/ajv-instance.d.ts

@@ -1,7 +1,17 @@
 import Ajv from "ajv";
+import Ajv2020 from "ajv/dist/2020.js";
 /**
  * Creates a fresh Ajv instance with strict settings and standard formats.
  *
  * @returns Configured Ajv instance
  */
 export declare function createAjvInstance(): Ajv;
+/**
+ * Creates a fresh Ajv instance for JSON Schema draft 2020-12 documents, such
+ * as the canonical ADR-008 register schema. Separate from
+ * {@link createAjvInstance} so the draft-07 package-metadata and config
+ * schemas are unaffected.
+ *
+ * @returns Configured Ajv 2020-12 instance
+ */
+export declare function createAjv2020Instance(): Ajv2020;

package/dist/ajv-instance.js

@@ -1,4 +1,5 @@
 import Ajv from "ajv";
+import Ajv2020 from "ajv/dist/2020.js";
 import addFormats from "ajv-formats";
 /**
  * Creates a fresh Ajv instance with strict settings and standard formats.
@@ -15,3 +16,21 @@ export function createAjvInstance() {
     addFormats(ajv);
     return ajv;
 }
+/**
+ * Creates a fresh Ajv instance for JSON Schema draft 2020-12 documents, such
+ * as the canonical ADR-008 register schema. Separate from
+ * {@link createAjvInstance} so the draft-07 package-metadata and config
+ * schemas are unaffected.
+ *
+ * @returns Configured Ajv 2020-12 instance
+ */
+export function createAjv2020Instance() {
+    const ajv = new Ajv2020({
+        allErrors: true,
+        strict: false,
+        strictTypes: false,
+        verbose: true,
+    });
+    addFormats(ajv);
+    return ajv;
+}

package/dist/index.d.ts

@@ -1,9 +1,8 @@
-export type { Adr008Register } from "./schemas/adr-008-register.js";
+export type { Adr008Register, Adr008RegisterEdge, } from "./schemas/adr-008-register.js";
 export type { ComityConfig } from "./schemas/comity-config.js";
 export type { PackageMetadata, ValidationResult, } from "./schemas/package-metadata.js";
-export { createAjvInstance } from "./ajv-instance.js";
+export { createAjv2020Instance, createAjvInstance } from "./ajv-instance.js";
 export { MIN_NODE_VERSION, PACKAGE_NAME_PATTERN, RUNTIME_LAYERS, VALID_LAYERS, } from "./constants.js";
-export { adr008CoreExceptionRegister } from "./schemas/adr-008-register-data.js";
-export { adr008RegisterSchema, validateAdr008Register, } from "./schemas/adr-008-register.js";
+export { adr008CoreExceptionRegister, adr008RegisterSchema, validateAdr008Register, } from "./schemas/adr-008-register.js";
 export { comityConfigSchema, validateComityConfig, } from "./schemas/comity-config.js";
 export { packageMetadataSchema, validatePackageMetadata, } from "./schemas/package-metadata.js";

package/dist/index.js

@@ -1,6 +1,5 @@
-export { createAjvInstance } from "./ajv-instance.js";
+export { createAjv2020Instance, createAjvInstance } from "./ajv-instance.js";
 export { MIN_NODE_VERSION, PACKAGE_NAME_PATTERN, RUNTIME_LAYERS, VALID_LAYERS, } from "./constants.js";
-export { adr008CoreExceptionRegister } from "./schemas/adr-008-register-data.js";
-export { adr008RegisterSchema, validateAdr008Register, } from "./schemas/adr-008-register.js";
+export { adr008CoreExceptionRegister, adr008RegisterSchema, validateAdr008Register, } from "./schemas/adr-008-register.js";
 export { comityConfigSchema, validateComityConfig, } from "./schemas/comity-config.js";
 export { packageMetadataSchema, validatePackageMetadata, } from "./schemas/package-metadata.js";

package/dist/schemas/adr-008-canonical.generated.d.ts

@@ -0,0 +1,3 @@
+import type { Adr008Register } from "./adr-008-register.js";
+export declare const adr008RegisterSchemaDocument: Record<string, unknown>;
+export declare const adr008CanonicalRegister: Adr008Register;

package/dist/schemas/adr-008-canonical.generated.js

@@ -0,0 +1,390 @@
+// GENERATED FILE — DO NOT EDIT.
+// Source: docs/standards/decisions/data/adr-008-core-exception-register{,.schema}.json
+// Regenerate with: pnpm --filter @comity-dev/schemas generate
+export const adr008RegisterSchemaDocument = {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "comity:adr-008-core-exception-register.schema.json",
+    "title": "ADR-008 Core-to-Core Dependency Exception Register",
+    "description": "Machine-readable serialization of the ADR-008 closed register of Core-to-Core dependency exceptions. ADR-008 (Markdown) remains the architectural authority; this register is a derived representation and MUST NOT redefine architecture.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "$schema",
+        "schemaVersion",
+        "authority",
+        "source",
+        "edges"
+    ],
+    "properties": {
+        "$schema": {
+            "const": "comity:adr-008-core-exception-register.schema.json"
+        },
+        "schemaVersion": {
+            "type": "integer",
+            "const": 1,
+            "description": "Version of the register schema. Incremented when the data contract changes in a breaking way."
+        },
+        "authority": {
+            "const": "ADR-008",
+            "description": "The architectural authority this register serializes."
+        },
+        "source": {
+            "const": "../ADR-008-explicit-core-module-composition-exceptions.md",
+            "description": "Path to the authoritative ADR document, relative to the register file (the ADR lives in the parent directory of data/)."
+        },
+        "edges": {
+            "type": "array",
+            "description": "Closed list of approved Core-to-Core dependency exceptions.",
+            "items": {
+                "$ref": "#/$defs/dependencyEdge"
+            },
+            "uniqueItems": true
+        }
+    },
+    "$defs": {
+        "dependencyEdge": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "from",
+                "to",
+                "layer",
+                "categories",
+                "importKind",
+                "lifecycle",
+                "justification",
+                "adrReference"
+            ],
+            "properties": {
+                "from": {
+                    "type": "string",
+                    "pattern": "^@comity/[a-z0-9-]+$",
+                    "description": "Source package name."
+                },
+                "to": {
+                    "type": "string",
+                    "pattern": "^@comity/[a-z0-9-]+$",
+                    "description": "Target package name."
+                },
+                "layer": {
+                    "const": "core-to-core",
+                    "description": "Layer relationship. This register covers only Core-to-Core edges."
+                },
+                "categories": {
+                    "type": "array",
+                    "minItems": 1,
+                    "uniqueItems": true,
+                    "items": {
+                        "type": "string",
+                        "enum": [
+                            "capability",
+                            "infrastructure-contract",
+                            "value-import",
+                            "candidate-for-removal"
+                        ]
+                    },
+                    "description": "All classifications that apply to this edge. A single edge may belong to multiple classifications (e.g., storefront -> catalog is both a capability exception and a value-import exception). This is the sole classification field."
+                },
+                "importKind": {
+                    "type": "string",
+                    "enum": [
+                        "type-only",
+                        "value",
+                        "mixed"
+                    ],
+                    "description": "Whether the dependency is type-only, value, or a mix of both."
+                },
+                "lifecycle": {
+                    "type": "string",
+                    "enum": [
+                        "approved",
+                        "deprecated",
+                        "migration-candidate"
+                    ],
+                    "description": "Lifecycle status: approved exception, deprecated pattern tracked for removal, or scheduled migration candidate."
+                },
+                "justification": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Justification as recorded in ADR-008."
+                },
+                "adrReference": {
+                    "type": "string",
+                    "minLength": 1,
+                    "description": "Reference back to ADR-008, including the specific register section/table where practical."
+                },
+                "removalCandidate": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": [
+                        "criteria",
+                        "action"
+                    ],
+                    "description": "Removal candidate tracking, mirroring ADR-008 'Candidates for Removal'. Required when lifecycle is 'migration-candidate'.",
+                    "properties": {
+                        "criteria": {
+                            "type": "string",
+                            "description": "The ADR-008 acceptance criteria this dependency fails."
+                        },
+                        "action": {
+                            "type": "string",
+                            "description": "The migration action required to remove or refactor the dependency."
+                        }
+                    }
+                }
+            },
+            "if": {
+                "properties": {
+                    "lifecycle": {
+                        "const": "migration-candidate"
+                    }
+                },
+                "required": [
+                    "lifecycle"
+                ]
+            },
+            "then": {
+                "required": [
+                    "removalCandidate"
+                ]
+            }
+        }
+    }
+};
+export const adr008CanonicalRegister = {
+    "$schema": "comity:adr-008-core-exception-register.schema.json",
+    "schemaVersion": 1,
+    "authority": "ADR-008",
+    "source": "../ADR-008-explicit-core-module-composition-exceptions.md",
+    "edges": [
+        {
+            "from": "@comity/storefront",
+            "to": "@comity/catalog",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Storefront page composition references catalog domain contracts and models.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/storefront",
+            "to": "@comity/taxonomy",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Storefront category page composition references taxonomy domain contracts and models.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/storefront",
+            "to": "@comity/content",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Storefront content page composer references content domain models.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/storefront",
+            "to": "@comity/search",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Storefront search page contract references SearchResultModel.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/catalog",
+            "to": "@comity/media",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Catalog projections reference MediaModel for product/brand media.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/content",
+            "to": "@comity/media",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Content blocks/pages reference MediaModel.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/content",
+            "to": "@comity/seo",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Content pages reference SeoModel.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/taxonomy",
+            "to": "@comity/media",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Taxonomy models reference MediaModel for category image.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/order",
+            "to": "@comity/pricing",
+            "layer": "core-to-core",
+            "categories": [
+                "capability",
+                "value-import"
+            ],
+            "importKind": "value",
+            "lifecycle": "approved",
+            "justification": "@comity/order composes its order-level PriceRecord via the public PriceRecord type and combine (record composition, not calculation); the record type stays pricing-owned.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/order",
+            "to": "@comity/organization",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Order contracts reference ChannelId for commercial channel scoping.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/fulfillment",
+            "to": "@comity/order",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Fulfillment references the committed order by OrderId and reuses the OrderAddressSnapshot contract for shipping recipients; it never holds an Order and imports no value from @comity/order.",
+            "adrReference": "ADR-008 — Amendment 2, Capability Exceptions"
+        },
+        {
+            "from": "@comity/fulfillment",
+            "to": "@comity/organization",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Fulfillment repository contracts require TenantId for multi-tenant isolation, as order and customer repositories do.",
+            "adrReference": "ADR-008 — Amendment 2, Capability Exceptions"
+        },
+        {
+            "from": "@comity/customer",
+            "to": "@comity/validation",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Customer validator consumes the shared Validator contract.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/customer",
+            "to": "@comity/organization",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Customer repository requires TenantId for multi-tenant isolation.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/address",
+            "to": "@comity/validation",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Address validator consumes the shared Validator contract.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/identity",
+            "to": "@comity/validation",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Identity validator consumes the shared Validator contract.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        },
+        {
+            "from": "@comity/auth-tokens",
+            "to": "@comity/auth",
+            "layer": "core-to-core",
+            "categories": [
+                "value-import"
+            ],
+            "importKind": "mixed",
+            "lifecycle": "approved",
+            "justification": "Token facade error surface normalizes AuthError at runtime. @comity/auth owns authentication error semantics; direction is intentional and non-cyclic.",
+            "adrReference": "ADR-008 — Dependency Register, Value-Import Exceptions"
+        },
+        {
+            "from": "@comity/router",
+            "to": "@comity/http",
+            "layer": "core-to-core",
+            "categories": [
+                "infrastructure-contract"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "deprecated",
+            "justification": "Router contracts reference HttpContext, HttpHandler, HttpMethod. Compatibility exception; extraction candidate.",
+            "adrReference": "ADR-008 — Dependency Register, Infrastructure Contract Exceptions"
+        },
+        {
+            "from": "@comity/payment",
+            "to": "@comity/pricing",
+            "layer": "core-to-core",
+            "categories": [
+                "capability"
+            ],
+            "importKind": "type-only",
+            "lifecycle": "approved",
+            "justification": "Payment module uses Money value object from pricing for amount representation in PaymentRequest and PaymentOutcome.",
+            "adrReference": "ADR-008 — Dependency Register, Capability Exceptions"
+        }
+    ]
+};

package/dist/schemas/adr-008-register.d.ts

@@ -2,78 +2,51 @@ import type { Ajv, ErrorObject } from "ajv";
 /**
  * Canonical schema for the ADR-008 Core Exception Register.
  *
+ * Derived at build time from the canonical JSON Schema
+ * `docs/standards/decisions/data/adr-008-core-exception-register.schema.json`
+ * (ADR-009 §3, §5). It is a JSON Schema 2020-12 document, so it must be
+ * compiled with {@link createAjv2020Instance}.
+ *
  * @see ADR-008 — Explicit Core Module Composition Exceptions
  * @see ADR-009 — Machine-Readable Core Exception Register
- *
- * Each repository owns its own register instance; the schema is shared
- * Development tooling. The register enumerates Core-to-Core dependency
- * edges that are explicitly permitted despite the default prohibition.
  */
-export declare const adr008RegisterSchema: {
-    $id: string;
-    type: string;
-    required: string[];
-    additionalProperties: boolean;
-    properties: {
-        version: {
-            type: string;
-            const: string;
-            description: string;
-        };
-        edges: {
-            type: string;
-            uniqueItems: boolean;
-            items: {
-                type: string;
-                required: string[];
-                additionalProperties: boolean;
-                properties: {
-                    from: {
-                        type: string;
-                        pattern: string;
-                        description: string;
-                    };
-                    to: {
-                        type: string;
-                        pattern: string;
-                        description: string;
-                    };
-                    adr: {
-                        type: string;
-                        pattern: string;
-                        description: string;
-                    };
-                    rationale: {
-                        type: string;
-                        minLength: number;
-                        description: string;
-                    };
-                };
-            };
-        };
-    };
-};
+export declare const adr008RegisterSchema: Record<string, unknown>;
 /**
- * Validates a parsed ADR-008 register document.
+ * Canonical ADR-008 register, derived at build time from
+ * `docs/standards/decisions/data/adr-008-core-exception-register.json`.
+ * ADR-008 (Markdown) remains the architectural authority.
+ */
+export declare const adr008CoreExceptionRegister: Adr008Register;
+/**
+ * Validates a parsed ADR-008 register document against the canonical schema.
  *
  * @param document — parsed ADR-008 register
- * @param ajv — optional pre-built Ajv instance
+ * @param ajv — optional pre-built Ajv instance; it MUST support JSON Schema
+ *   2020-12 (use {@link createAjv2020Instance})
  * @returns validation result
  */
 export declare function validateAdr008Register(document: unknown, ajv?: Ajv): {
     valid: boolean;
     errors: ErrorObject[];
 };
+export interface Adr008RegisterEdge {
+    from: string;
+    to: string;
+    layer: string;
+    categories: string[];
+    importKind: string;
+    lifecycle: string;
+    justification: string;
+    adrReference: string;
+    removalCandidate?: {
+        criteria: string;
+        action: string;
+    };
+}
 export interface Adr008Register {
-    version: "1";
-    edges: Array<{
-        from: string;
-        to: string;
-        layer: string;
-        categories: string[];
-        importKind: string;
-        lifecycle: string;
-        justification: string;
-        adrReference: string;
-    }>;
+    $schema: string;
+    schemaVersion: number;
+    authority: string;
+    source: string;
+    edges: Adr008RegisterEdge[];
 }

package/dist/schemas/adr-008-register.js

@@ -1,68 +1,34 @@
-import { createAjvInstance } from "../ajv-instance.js";
-import { PACKAGE_NAME_PATTERN } from "../constants.js";
+import { createAjv2020Instance } from "../ajv-instance.js";
+import { adr008CanonicalRegister, adr008RegisterSchemaDocument, } from "./adr-008-canonical.generated.js";
 /**
  * Canonical schema for the ADR-008 Core Exception Register.
  *
+ * Derived at build time from the canonical JSON Schema
+ * `docs/standards/decisions/data/adr-008-core-exception-register.schema.json`
+ * (ADR-009 §3, §5). It is a JSON Schema 2020-12 document, so it must be
+ * compiled with {@link createAjv2020Instance}.
+ *
  * @see ADR-008 — Explicit Core Module Composition Exceptions
  * @see ADR-009 — Machine-Readable Core Exception Register
- *
- * Each repository owns its own register instance; the schema is shared
- * Development tooling. The register enumerates Core-to-Core dependency
- * edges that are explicitly permitted despite the default prohibition.
  */
-export const adr008RegisterSchema = {
-    $id: "https://comityjs.dev/schemas/adr-008-register.v1.json",
-    type: "object",
-    required: ["version", "edges"],
-    additionalProperties: false,
-    properties: {
-        version: {
-            type: "string",
-            const: "1",
-            description: "Schema version of the register document.",
-        },
-        edges: {
-            type: "array",
-            uniqueItems: true,
-            items: {
-                type: "object",
-                required: ["from", "to", "adr", "rationale"],
-                additionalProperties: false,
-                properties: {
-                    from: {
-                        type: "string",
-                        pattern: PACKAGE_NAME_PATTERN,
-                        description: "Source Core Module package name.",
-                    },
-                    to: {
-                        type: "string",
-                        pattern: PACKAGE_NAME_PATTERN,
-                        description: "Target Core Module package name.",
-                    },
-                    adr: {
-                        type: "string",
-                        pattern: "^ADR-[0-9]{3,4}.*$",
-                        description: "ADR reference approving this exception.",
-                    },
-                    rationale: {
-                        type: "string",
-                        minLength: 1,
-                        description: "Why this Core-to-Core edge is permitted.",
-                    },
-                },
-            },
-        },
-    },
-};
+export const adr008RegisterSchema = adr008RegisterSchemaDocument;
+/**
+ * Canonical ADR-008 register, derived at build time from
+ * `docs/standards/decisions/data/adr-008-core-exception-register.json`.
+ * ADR-008 (Markdown) remains the architectural authority.
+ */
+export const adr008CoreExceptionRegister = adr008CanonicalRegister;
 /**
- * Validates a parsed ADR-008 register document.
+ * Validates a parsed ADR-008 register document against the canonical schema.
  *
  * @param document — parsed ADR-008 register
- * @param ajv — optional pre-built Ajv instance
+ * @param ajv — optional pre-built Ajv instance; it MUST support JSON Schema
+ *   2020-12 (use {@link createAjv2020Instance})
  * @returns validation result
  */
-export function validateAdr008Register(document, ajv = createAjvInstance()) {
-    const validate = ajv.compile(adr008RegisterSchema);
+export function validateAdr008Register(document, ajv = createAjv2020Instance()) {
+    const id = adr008RegisterSchema["$id"];
+    const validate = ajv.getSchema(id) ?? ajv.compile(adr008RegisterSchema);
     const valid = validate(document);
     return {
         valid: Boolean(valid),

package/dist/schemas/index.d.ts

@@ -1,6 +1,6 @@
-export type { Adr008Register } from "./adr-008-register.js";
+export type { Adr008Register, Adr008RegisterEdge, } from "./adr-008-register.js";
 export type { ComityConfig } from "./comity-config.js";
 export type { PackageMetadata, ValidationResult } from "./package-metadata.js";
-export { adr008RegisterSchema, validateAdr008Register, } from "./adr-008-register.js";
+export { adr008CoreExceptionRegister, adr008RegisterSchema, validateAdr008Register, } from "./adr-008-register.js";
 export { comityConfigSchema, validateComityConfig } from "./comity-config.js";
 export { packageMetadataSchema, validatePackageMetadata, } from "./package-metadata.js";

package/dist/schemas/index.js

@@ -1,3 +1,3 @@
-export { adr008RegisterSchema, validateAdr008Register, } from "./adr-008-register.js";
+export { adr008CoreExceptionRegister, adr008RegisterSchema, validateAdr008Register, } from "./adr-008-register.js";
 export { comityConfigSchema, validateComityConfig } from "./comity-config.js";
 export { packageMetadataSchema, validatePackageMetadata, } from "./package-metadata.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comity-dev/schemas",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Reusable JSON Schema definitions for Comity package metadata, ADR-008 register, and repository configuration. Development tooling.",
   "type": "module",
   "private": false,
@@ -40,7 +40,8 @@
     "typescript": "^5.9.3"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "test": "vitest run"
+    "generate": "node scripts/generate-adr-008.mjs",
+    "build": "node scripts/generate-adr-008.mjs && node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "test": "vitest run --passWithNoTests"
   }
 }

package/dist/schemas/adr-008-register-data.d.ts

@@ -1,11 +0,0 @@
-import type { Adr008Register } from "./adr-008-register.js";
-/**
- * Canonical ADR-008 Core Exception Register.
- *
- * This is the authoritative machine-readable representation of the
- * ADR-008 closed register of Core-to-Core dependency exceptions.
- *
- * @see ADR-008 — Explicit Core Module Composition Exceptions
- * @see ADR-009 — Machine-Readable Core Exception Register
- */
-export declare const adr008CoreExceptionRegister: Adr008Register;

package/dist/schemas/adr-008-register-data.js

@@ -1,184 +0,0 @@
-/**
- * Canonical ADR-008 Core Exception Register.
- *
- * This is the authoritative machine-readable representation of the
- * ADR-008 closed register of Core-to-Core dependency exceptions.
- *
- * @see ADR-008 — Explicit Core Module Composition Exceptions
- * @see ADR-009 — Machine-Readable Core Exception Register
- */
-export const adr008CoreExceptionRegister = {
-    version: "1",
-    edges: [
-        {
-            from: "@comity/storefront",
-            to: "@comity/catalog",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Storefront page composition references catalog domain contracts and models.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/storefront",
-            to: "@comity/taxonomy",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Storefront category page composition references taxonomy domain contracts and models.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/storefront",
-            to: "@comity/content",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Storefront content page composer references content domain models.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/storefront",
-            to: "@comity/search",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Storefront search page contract references SearchResultModel.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/catalog",
-            to: "@comity/media",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Catalog projections reference MediaModel for product/brand media.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/content",
-            to: "@comity/media",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Content blocks/pages reference MediaModel.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/content",
-            to: "@comity/seo",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Content pages reference SeoModel.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/taxonomy",
-            to: "@comity/media",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Taxonomy models reference MediaModel for category image.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/order",
-            to: "@comity/pricing",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Order items reference Price / PriceModifier.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/order",
-            to: "@comity/organization",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Order contracts reference ChannelId for commercial channel scoping.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/customer",
-            to: "@comity/validation",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Customer validator consumes the shared Validator contract.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/customer",
-            to: "@comity/organization",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Customer repository requires TenantId for multi-tenant isolation.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/address",
-            to: "@comity/validation",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Address validator consumes the shared Validator contract.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/identity",
-            to: "@comity/validation",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Identity validator consumes the shared Validator contract.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-        {
-            from: "@comity/auth-tokens",
-            to: "@comity/auth",
-            layer: "core-to-core",
-            categories: ["value-import"],
-            importKind: "mixed",
-            lifecycle: "approved",
-            justification: "Token facade error surface normalizes AuthError at runtime. @comity/auth owns authentication error semantics; direction is intentional and non-cyclic.",
-            adrReference: "ADR-008 — Dependency Register, Value-Import Exceptions",
-        },
-        {
-            from: "@comity/router",
-            to: "@comity/http",
-            layer: "core-to-core",
-            categories: ["infrastructure-contract"],
-            importKind: "type-only",
-            lifecycle: "deprecated",
-            justification: "Router contracts reference HttpContext, HttpHandler, HttpMethod. Compatibility exception; extraction candidate.",
-            adrReference: "ADR-008 — Dependency Register, Infrastructure Contract Exceptions",
-        },
-        {
-            from: "@comity/payment",
-            to: "@comity/pricing",
-            layer: "core-to-core",
-            categories: ["capability"],
-            importKind: "type-only",
-            lifecycle: "approved",
-            justification: "Payment module uses Money value object from pricing for amount representation in PaymentRequest and PaymentOutcome.",
-            adrReference: "ADR-008 — Dependency Register, Capability Exceptions",
-        },
-    ],
-};