@clossys/architect 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+# Changelog
+
+All notable changes to this package are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.2] - 2026-08-30
+
+### Changed
+
+- Updated the package's public repository, issue-tracker, and homepage metadata to the canonical Foundry repository. This change is not a publication or qualification claim.
+
+## [0.1.1] - 2026-08-24
+
+### Fixed
+
+- Corrected the install guidance now that Architect is a public package.
+
+## [0.1.0] - 2026-08-23
+
+### Added
+
+- Initial architect role contract for provider-neutral scopes, systems,
+  responsibilities, authorities, systems of record, and interfaces.
+- Deterministic topology validation, normalization, serialization, and
+  compatibility comparison.
+- Evidence-based architecture exception assessment with explicit indeterminate
+  results when no material changes have been observed.
+- `architect-check` topology and exception-assessment commands.
+- Ontology model and snapshot API under `@vespeneventures/architect/ontology`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Calvin Hung
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,171 @@
+# @clossys/architect
+
+The architect role for provider-neutral operating architecture. It answers:
+
+> Do the business ontology, operating boundaries, authoritative systems, and
+> interfaces match how material work actually crosses the business?
+
+The package defines business and portfolio scopes, systems, responsibilities,
+authoritative ownership, systems of record, and directional interfaces. It
+then assesses independent change observations against that declared topology.
+It performs no network I/O and has no runtime dependencies. Install it with:
+
+```bash
+npm install @clossys/architect
+```
+
+## Job charter
+
+Architect operates in **optimize** mode. Its durable objective is to reduce
+architecture exception rate while respecting consumer-owned security,
+privacy, authority, and lifecycle guardrails:
+
+```text
+architecture exception rate
+= observed material changes with at least one undeclared boundary crossing
+  / all observed material changes
+```
+
+No observed material changes means the rate is **indeterminate**, never zero.
+The role senses actual changes, judges them against declared boundaries,
+proposes architecture changes, verifies subsequent evidence, and learns or
+escalates. It does not transfer repositories, mutate GitHub, create systems,
+or grant itself authority. A consumer approves changes; an authorized builder
+may materialize them.
+
+## Usage
+
+```ts
+import {
+  assessArchitectureExceptions,
+  defineOperatingTopology,
+  serializeOperatingTopology,
+  validateOperatingTopology,
+} from "@clossys/architect";
+
+const topology = defineOperatingTopology({
+  id: "example",
+  schemaVersion: "0.1.0",
+  scope: { id: "example-business", kind: "business" },
+  systems: [
+    { id: "workspace", kind: "workspace", responsibilities: ["control-plane"], visibility: "private" },
+    { id: "product", kind: "repository", responsibilities: ["product"], visibility: "private" },
+  ],
+  authorities: [
+    { responsibility: "control-plane", owner: "business-owner", systemOfRecord: "workspace" },
+    { responsibility: "product", owner: "product-owner", systemOfRecord: "product" },
+  ],
+  interfaces: [
+    { id: "workspace-to-product", from: "workspace", to: "product", responsibilities: ["product"] },
+  ],
+});
+
+if (validateOperatingTopology(topology).length > 0) throw new Error("Invalid topology");
+const artifact = serializeOperatingTopology(topology);
+
+const assessment = assessArchitectureExceptions(
+  topology,
+  [{
+    id: "change-1",
+    observedAt: "2026-08-23T12:00:00Z",
+    material: true,
+    crossings: [{ from: "workspace", to: "product", responsibility: "product", interface: "workspace-to-product" }],
+  }],
+  { maximumExceptionRate: 0.05 },
+);
+```
+
+Unknown systems, responsibility mismatches, and an interface name that does
+not match the declared direction count as undeclared crossings. Observations are consumer-supplied
+evidence; the assessment never treats a success flag as proof.
+
+A valid topology has at least one system and authority, represents the
+`control-plane` responsibility, binds each authority to a system of record
+that implements its responsibility, and declares interfaces only for
+responsibilities implemented somewhere in the topology.
+
+## CLI
+
+```bash
+architect-check topology topology.json
+architect-check exceptions topology.json observations.json --maximum-exception-rate 0.05
+```
+
+Both commands emit JSON. Exit codes are `0` satisfied, `1` violated, and `2`
+indeterminate or unable to run. Invalid topology is a violation for the
+`topology` conformance command. Invalid inputs make the exception rate
+indeterminate because no valid measurement can be computed.
+
+## API
+
+| Export | Kind | Purpose |
+| --- | --- | --- |
+| `defineOperatingTopology(definition)` | function | Returns a detached, fully populated topology without claiming it is valid. |
+| `validateOperatingTopology(value)` | function | Reports structural, identity, responsibility, authority, system-of-record, and interface findings. |
+| `normalizeOperatingTopology(definition)` | function | Applies deterministic property and collection ordering. |
+| `serializeOperatingTopology(definition)` | function | Produces canonical pretty JSON ending in one newline. |
+| `compareOperatingTopologies(previous, next)` | function | Classifies additive and breaking topology contract changes. |
+| `validateArchitectureChangeObservations(value)` | function | Validates independent material-change evidence without certifying it. |
+| `assessArchitectureExceptions(topology, observations, options)` | function | Computes architecture exception rate and satisfied, violated, or indeterminate state. |
+| `OPERATING_SCOPE_KINDS` | constant | Supported `portfolio` and `business` scope kinds. |
+| `OPERATING_SYSTEM_KINDS` | constant | Provider-neutral system kinds. |
+| `OPERATING_RESPONSIBILITIES` | constant | Stable operating-responsibility vocabulary. |
+| `OperatingTopologyDefinition` / `OperatingTopology` | types | Authoring and detached topology shapes. |
+| `OperatingScopeDefinition` / `OperatingScopeKind` | types | Consumer operating boundary and its kind. |
+| `OperatingSystemDefinition` / `OperatingSystemKind` | types | One addressable system and its kind. |
+| `OperatingResponsibility` | type | Stable responsibility assigned to systems and authorities. |
+| `AuthorityDefinition` | type | Consumer-owned responsibility, owner, and system-of-record binding. |
+| `OperatingInterfaceDefinition` | type | One allowed directional system crossing. |
+| `ArchitectureFinding` / `ArchitectureFindingSeverity` | types | Validation issue and severity. |
+| `OperatingTopologyChange` / `OperatingTopologyCompatibilityReport` | types | Classified topology change and compatibility report. |
+| `BoundaryCrossingObservation` / `ArchitectureChangeObservation` | types | One observed crossing and material change. |
+| `ArchitectureAssessmentOptions` / `ArchitectureAssessmentState` | types | Assessment setpoint and three-state result vocabulary. |
+| `AssessedBoundaryCrossing` / `AssessedArchitectureChange` | types | Evidence annotated with declaration and exception status. |
+| `ArchitectureExceptionAssessment` | type | Metric counts, rate, state, evidence details, and findings. |
+
+## Ontology
+
+`@clossys/architect/ontology` contains the ontology mechanism used by
+the role. Its public model and snapshot API is compatible with the former
+standalone domain package.
+
+| Export | Kind | Purpose |
+| --- | --- | --- |
+| `defineDomainModel(definition)` | function | Returns a detached domain model for authoring. |
+| `validateDomainModel(value)` | function | Validates identifiers, fields, references, relations, and cardinality. |
+| `normalizeDomainModel(model)` | function | Canonically orders a domain model. |
+| `serializeDomainModel(model)` | function | Serializes a canonical domain model. |
+| `compareDomainModels(previous, next)` | function | Classifies additive and breaking model changes. |
+| `defineDomainSnapshot(definition)` | function | Returns a detached collection of records and relations. |
+| `validateDomainSnapshot(model, value)` | function | Validates instance values, types, endpoints, and cardinality. |
+| `normalizeDomainSnapshot(snapshot)` | function | Canonically orders a snapshot and nested values. |
+| `serializeDomainSnapshot(snapshot)` | function | Serializes a canonical snapshot. |
+| `PRIMITIVE_VALUE_TYPES` | constant | Supported primitive value types. |
+| `RELATION_CARDINALITIES` | constant | Supported directed relation cardinalities. |
+| `DomainModelDefinition` / `DomainModel` | types | Model authoring and detached shapes. |
+| `ValueTypeDefinition` / `VocabularyDefinition` | types | Scalar and closed vocabulary declarations. |
+| `DomainTypeDefinition` / `RelationDefinition` | types | Domain types and directed attributed relations. |
+| `FieldDefinition` / `FieldValueType` | types | Stable field and value reference. |
+| `PrimitiveValueType` / `RelationCardinality` | types | Primitive and relation-cardinality vocabularies. |
+| `DomainModelFinding` | type | Domain model validation issue. |
+| `DomainModelChange` / `DomainModelCompatibilityReport` | types | Classified model change and report. |
+| `DomainRecordDefinition` / `DomainRecord` | types | Snapshot record authoring and detached shapes. |
+| `DomainRelationDefinition` / `DomainRelation` | types | Snapshot relation authoring and detached shapes. |
+| `DomainSnapshotDefinition` / `DomainSnapshot` | types | Snapshot authoring and detached shapes. |
+| `DomainSnapshotFinding` | type | Snapshot validation issue. |
+
+## Topology compatibility
+
+Removing a system, authority, or interface is breaking. Changing a system's
+kind, responsibilities, provider binding, locator, visibility, an authority's
+owner or system of record, or an interface's direction or responsibilities is
+also breaking. Adding a system, authority, or interface is additive. Labels,
+descriptions, and `schemaVersion` do not determine compatibility.
+
+## Requirements
+
+Node 20+. ESM only. No runtime dependencies and no I/O in the library API.
+
+## Licence
+
+MIT

package/dist/assessment.d.ts

@@ -0,0 +1,9 @@
+import type { ArchitectureAssessmentOptions, ArchitectureExceptionAssessment, ArchitectureFinding } from "./types.js";
+/** Validates observations as evidence without using them to certify themselves. */
+export declare function validateArchitectureChangeObservations(value: unknown): ArchitectureFinding[];
+/**
+ * Measures the package's primary metric from independent observations.
+ * No material observations is explicitly indeterminate, never a zero rate.
+ */
+export declare function assessArchitectureExceptions(topology: unknown, observations: unknown, options: ArchitectureAssessmentOptions): ArchitectureExceptionAssessment;
+//# sourceMappingURL=assessment.d.ts.map

package/dist/assessment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessment.d.ts","sourceRoot":"","sources":["../src/assessment.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,6BAA6B,EAE7B,+BAA+B,EAC/B,mBAAmB,EAKpB,MAAM,YAAY,CAAC;AAYpB,mFAAmF;AACnF,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,EAAE,CAuB5F;AAUD;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,OAAO,EACrB,OAAO,EAAE,6BAA6B,GACrC,+BAA+B,CAgCjC"}

package/dist/assessment.js

@@ -0,0 +1,98 @@
+import { validateOperatingTopology } from "./topology.js";
+import { OPERATING_RESPONSIBILITIES } from "./types.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function finding(rule, message, path) {
+    return { rule, severity: "error", message, path };
+}
+/** Validates observations as evidence without using them to certify themselves. */
+export function validateArchitectureChangeObservations(value) {
+    if (!Array.isArray(value))
+        return [finding("observations-shape", "Architecture observations must be an array.", "$")];
+    const findings = [];
+    const ids = new Set();
+    for (const [index, candidate] of value.entries()) {
+        const path = `[${index}]`;
+        if (!isRecord(candidate)) {
+            findings.push(finding("observation-shape", "An observation must be an object.", path));
+            continue;
+        }
+        if (typeof candidate.id !== "string" || candidate.id.length === 0)
+            findings.push(finding("observation-id", "id must be a non-empty string.", `${path}.id`));
+        else if (ids.has(candidate.id))
+            findings.push(finding("duplicate-observation-id", `Duplicate observation id "${candidate.id}".`, `${path}.id`));
+        else
+            ids.add(candidate.id);
+        if (typeof candidate.observedAt !== "string" || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/.test(candidate.observedAt))
+            findings.push(finding("observed-at", "observedAt must be an RFC 3339 timestamp with an offset.", `${path}.observedAt`));
+        if (typeof candidate.material !== "boolean")
+            findings.push(finding("material-shape", "material must be a boolean.", `${path}.material`));
+        if (!Array.isArray(candidate.crossings)) {
+            findings.push(finding("crossings-shape", "crossings must be an array.", `${path}.crossings`));
+            continue;
+        }
+        for (const [crossingIndex, crossing] of candidate.crossings.entries()) {
+            const crossingPath = `${path}.crossings[${crossingIndex}]`;
+            if (!isRecord(crossing)) {
+                findings.push(finding("crossing-shape", "A boundary crossing must be an object.", crossingPath));
+                continue;
+            }
+            for (const endpoint of ["from", "to"])
+                if (typeof crossing[endpoint] !== "string" || crossing[endpoint].length === 0)
+                    findings.push(finding("crossing-endpoint", `${endpoint} must be a non-empty system id.`, `${crossingPath}.${endpoint}`));
+            if (typeof crossing.responsibility !== "string" || !OPERATING_RESPONSIBILITIES.includes(crossing.responsibility))
+                findings.push(finding("crossing-responsibility", "responsibility must be a supported value.", `${crossingPath}.responsibility`));
+            if (crossing.from !== undefined && crossing.from === crossing.to)
+                findings.push(finding("crossing-boundary", "A boundary crossing must name two different systems.", crossingPath));
+            if (crossing.interface !== undefined && (typeof crossing.interface !== "string" || crossing.interface.length === 0))
+                findings.push(finding("crossing-interface", "interface must be a non-empty string when provided.", `${crossingPath}.interface`));
+        }
+    }
+    return findings;
+}
+function isDeclared(crossing, interfaces) {
+    return interfaces.some((entry) => entry.from === crossing.from && entry.to === crossing.to && entry.responsibilities.includes(crossing.responsibility) && (crossing.interface === undefined || entry.id === crossing.interface));
+}
+function indeterminate(maximumExceptionRate, observedChanges, findings) {
+    return { state: "indeterminate", exceptionRate: null, maximumExceptionRate, observedChanges, observedMaterialChanges: 0, materialChangesWithExceptions: 0, changes: [], findings };
+}
+/**
+ * Measures the package's primary metric from independent observations.
+ * No material observations is explicitly indeterminate, never a zero rate.
+ */
+export function assessArchitectureExceptions(topology, observations, options) {
+    const topologyFindings = validateOperatingTopology(topology);
+    const observationFindings = validateArchitectureChangeObservations(observations);
+    const optionFindings = [];
+    if (!Number.isFinite(options.maximumExceptionRate) || options.maximumExceptionRate < 0 || options.maximumExceptionRate > 1)
+        optionFindings.push(finding("maximum-exception-rate", "maximumExceptionRate must be a finite number in [0, 1].", "options.maximumExceptionRate"));
+    const observedChanges = Array.isArray(observations) ? observations.length : 0;
+    const findings = [...topologyFindings, ...observationFindings, ...optionFindings];
+    if (findings.some((entry) => entry.severity === "error"))
+        return indeterminate(options.maximumExceptionRate, observedChanges, findings);
+    const definition = topology;
+    const evidence = observations;
+    const interfaces = definition.interfaces ?? [];
+    const changes = evidence.map((observation) => {
+        const crossings = observation.crossings.map((crossing) => ({ ...crossing, declared: isDeclared(crossing, interfaces) }));
+        return { id: observation.id, observedAt: observation.observedAt, material: observation.material, crossings, hasException: observation.material && crossings.some((crossing) => !crossing.declared) };
+    });
+    const material = changes.filter((change) => change.material);
+    if (material.length === 0) {
+        return { state: "indeterminate", exceptionRate: null, maximumExceptionRate: options.maximumExceptionRate, observedChanges: changes.length, observedMaterialChanges: 0, materialChangesWithExceptions: 0, changes, findings: [{ rule: "material-evidence-required", severity: "warning", message: "No observed material changes are available; architecture exception rate is unobserved." }] };
+    }
+    const exceptions = material.filter((change) => change.hasException).length;
+    const exceptionRate = exceptions / material.length;
+    return {
+        state: exceptionRate <= options.maximumExceptionRate ? "satisfied" : "violated",
+        exceptionRate,
+        maximumExceptionRate: options.maximumExceptionRate,
+        observedChanges: changes.length,
+        observedMaterialChanges: material.length,
+        materialChangesWithExceptions: exceptions,
+        changes,
+        findings: [],
+    };
+}
+//# sourceMappingURL=assessment.js.map

package/dist/assessment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessment.js","sourceRoot":"","sources":["../src/assessment.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+export declare class ArchitectCliInputError extends Error {
+}
+/** Testable command dispatcher. Invalid arguments throw and the executable maps them to 2. */
+export declare function main(argv: readonly string[]): number;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAgBA,qBAAa,sBAAuB,SAAQ,KAAK;CAAG;AAwCpD,8FAA8F;AAC9F,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMpD"}

package/dist/cli.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { assessArchitectureExceptions } from "./assessment.js";
+import { validateOperatingTopology } from "./topology.js";
+const USAGE = `Usage: architect-check topology <topology-file>
+       architect-check exceptions <topology-file> <observations-file> --maximum-exception-rate <rate>
+
+Commands:
+  topology    Validate a provider-neutral operating topology.
+  exceptions Assess architecture exception rate from observed changes.
+
+Exit codes: 0 = satisfied, 1 = violated, 2 = indeterminate or could not run.`;
+export class ArchitectCliInputError extends Error {
+}
+function readJson(path, label) {
+    const resolved = resolve(path);
+    if (!existsSync(resolved))
+        throw new ArchitectCliInputError(`${label} "${path}" does not exist`);
+    try {
+        if (!statSync(resolved).isFile())
+            throw new ArchitectCliInputError(`${label} "${path}" is not a file`);
+    }
+    catch (error) {
+        if (error instanceof ArchitectCliInputError)
+            throw error;
+        throw new ArchitectCliInputError(`cannot inspect ${label} "${path}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+    try {
+        return JSON.parse(readFileSync(resolved, "utf8"));
+    }
+    catch (error) {
+        throw new ArchitectCliInputError(`${label} "${path}" is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function topologyCommand(argv) {
+    if (argv.length !== 1)
+        throw new ArchitectCliInputError("topology requires exactly one topology-file");
+    const findings = validateOperatingTopology(readJson(argv[0], "topology-file"));
+    const report = { state: findings.some((entry) => entry.severity === "error") ? "violated" : "satisfied", findings };
+    console.log(JSON.stringify(report, null, 2));
+    return report.state === "satisfied" ? 0 : 1;
+}
+function exceptionsCommand(argv) {
+    let topologyFile;
+    let observationsFile;
+    let rate;
+    for (let index = 0; index < argv.length; index++) {
+        const argument = argv[index];
+        if (argument === "--maximum-exception-rate") {
+            const value = argv[++index];
+            if (value === undefined)
+                throw new ArchitectCliInputError("--maximum-exception-rate requires a value");
+            rate = Number(value);
+        }
+        else if (argument.startsWith("-"))
+            throw new ArchitectCliInputError(`unknown option "${argument}"`);
+        else if (topologyFile === undefined)
+            topologyFile = argument;
+        else if (observationsFile === undefined)
+            observationsFile = argument;
+        else
+            throw new ArchitectCliInputError(`unexpected extra argument "${argument}"`);
+    }
+    if (topologyFile === undefined || observationsFile === undefined || rate === undefined)
+        throw new ArchitectCliInputError("exceptions requires topology-file, observations-file, and --maximum-exception-rate");
+    const report = assessArchitectureExceptions(readJson(topologyFile, "topology-file"), readJson(observationsFile, "observations-file"), { maximumExceptionRate: rate });
+    console.log(JSON.stringify(report, null, 2));
+    return report.state === "satisfied" ? 0 : report.state === "violated" ? 1 : 2;
+}
+/** Testable command dispatcher. Invalid arguments throw and the executable maps them to 2. */
+export function main(argv) {
+    if (argv.length === 1 && (argv[0] === "--help" || argv[0] === "-h")) {
+        console.log(USAGE);
+        return 0;
+    }
+    const [command, ...rest] = argv;
+    if (command === "topology")
+        return topologyCommand(rest);
+    if (command === "exceptions")
+        return exceptionsCommand(rest);
+    throw new ArchitectCliInputError(command === undefined ? "a command is required" : `unknown command "${command}"`);
+}
+function run() {
+    try {
+        process.exitCode = main(process.argv.slice(2));
+    }
+    catch (error) {
+        console.error(`architect-check: ${error instanceof Error ? error.message : String(error)}`);
+        process.exitCode = 2;
+    }
+}
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === resolve(process.argv[1]))
+    run();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+/** Provider-neutral operating-architecture contracts and evidence-based assessment. */
+export { OPERATING_RESPONSIBILITIES, OPERATING_SCOPE_KINDS, OPERATING_SYSTEM_KINDS, } from "./types.js";
+export { compareOperatingTopologies, defineOperatingTopology, normalizeOperatingTopology, serializeOperatingTopology, validateOperatingTopology, } from "./topology.js";
+export { assessArchitectureExceptions, validateArchitectureChangeObservations, } from "./assessment.js";
+export type { ArchitectureAssessmentOptions, ArchitectureAssessmentState, ArchitectureChangeObservation, ArchitectureExceptionAssessment, ArchitectureFinding, ArchitectureFindingSeverity, AssessedArchitectureChange, AssessedBoundaryCrossing, AuthorityDefinition, BoundaryCrossingObservation, OperatingInterfaceDefinition, OperatingResponsibility, OperatingScopeDefinition, OperatingScopeKind, OperatingSystemDefinition, OperatingSystemKind, OperatingTopology, OperatingTopologyChange, OperatingTopologyCompatibilityReport, OperatingTopologyDefinition, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,oCAAoC,EACpC,2BAA2B,GAC5B,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/** Provider-neutral operating-architecture contracts and evidence-based assessment. */
+export { OPERATING_RESPONSIBILITIES, OPERATING_SCOPE_KINDS, OPERATING_SYSTEM_KINDS, } from "./types.js";
+export { compareOperatingTopologies, defineOperatingTopology, normalizeOperatingTopology, serializeOperatingTopology, validateOperatingTopology, } from "./topology.js";
+export { assessArchitectureExceptions, validateArchitectureChangeObservations, } from "./assessment.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,4BAA4B,EAC5B,sCAAsC,GACvC,MAAM,iBAAiB,CAAC"}

package/dist/ontology/compatibility.d.ts

@@ -0,0 +1,7 @@
+import type { DomainModelCompatibilityReport, DomainModelDefinition } from "./types.js";
+/**
+ * Compares actual model content. Labels and `schemaVersion` are intentionally
+ * not compatibility surface; stable identifiers and structural contracts are.
+ */
+export declare function compareDomainModels(previous: DomainModelDefinition, next: DomainModelDefinition): DomainModelCompatibilityReport;
+//# sourceMappingURL=compatibility.d.ts.map

package/dist/ontology/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/ontology/compatibility.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkC,8BAA8B,EAAE,qBAAqB,EAAwG,MAAM,YAAY,CAAC;AAsG9N;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,IAAI,EAAE,qBAAqB,GAAG,8BAA8B,CAuBhI"}

package/dist/ontology/compatibility.js

@@ -0,0 +1,135 @@
+import { normalizeDomainModel } from "./normalize.js";
+import { validateDomainModel } from "./validate.js";
+function mapById(items) {
+    return new Map(items.map((item) => [item.id, item]));
+}
+function stable(value) {
+    return JSON.stringify(value);
+}
+function compareFields(previous, next, subject, ownerId, changes) {
+    const before = mapById(previous);
+    const after = mapById(next);
+    for (const [id, field] of before) {
+        const replacement = after.get(id);
+        if (replacement === undefined) {
+            changes.push({ kind: "breaking", subject, id, message: `${subject} "${id}" was removed from "${ownerId}".` });
+            continue;
+        }
+        if (field.valueType !== replacement.valueType) {
+            changes.push({ kind: "breaking", subject, id, message: `${subject} "${id}" changed valueType.` });
+        }
+        if (field.required !== true && replacement.required === true) {
+            changes.push({ kind: "breaking", subject, id, message: `${subject} "${id}" became required.` });
+        }
+        if (field.required === true && replacement.required !== true) {
+            changes.push({ kind: "additive", subject, id, message: `${subject} "${id}" became optional.` });
+        }
+    }
+    for (const [id, field] of after) {
+        if (!before.has(id)) {
+            changes.push({
+                kind: field.required === true ? "breaking" : "additive",
+                subject,
+                id,
+                message: `${subject} "${id}" was added to "${ownerId}"${field.required === true ? " as required" : ""}.`,
+            });
+        }
+    }
+}
+function compareValueTypes(previous, next, changes) {
+    const before = mapById(previous);
+    const after = mapById(next);
+    for (const [id, valueType] of before) {
+        const replacement = after.get(id);
+        if (replacement === undefined)
+            changes.push({ kind: "breaking", subject: "value-type", id, message: `Value type "${id}" was removed.` });
+        else if (valueType.primitive !== replacement.primitive)
+            changes.push({ kind: "breaking", subject: "value-type", id, message: `Value type "${id}" changed primitive.` });
+    }
+    for (const [id] of after)
+        if (!before.has(id))
+            changes.push({ kind: "additive", subject: "value-type", id, message: `Value type "${id}" was added.` });
+}
+function compareVocabularies(previous, next, changes) {
+    const before = mapById(previous);
+    const after = mapById(next);
+    for (const [id, vocabulary] of before) {
+        const replacement = after.get(id);
+        if (replacement === undefined) {
+            changes.push({ kind: "breaking", subject: "vocabulary", id, message: `Vocabulary "${id}" was removed.` });
+            continue;
+        }
+        const previousValues = new Set(vocabulary.values);
+        const nextValues = new Set(replacement.values);
+        for (const value of previousValues)
+            if (!nextValues.has(value))
+                changes.push({ kind: "breaking", subject: "vocabulary-value", id: `${id}.${value}`, message: `Vocabulary value "${value}" was removed from "${id}".` });
+        for (const value of nextValues)
+            if (!previousValues.has(value))
+                changes.push({ kind: "additive", subject: "vocabulary-value", id: `${id}.${value}`, message: `Vocabulary value "${value}" was added to "${id}".` });
+    }
+    for (const [id] of after)
+        if (!before.has(id))
+            changes.push({ kind: "additive", subject: "vocabulary", id, message: `Vocabulary "${id}" was added.` });
+}
+function compareTypes(previous, next, changes) {
+    const before = mapById(previous);
+    const after = mapById(next);
+    for (const [id, type] of before) {
+        const replacement = after.get(id);
+        if (replacement === undefined)
+            changes.push({ kind: "breaking", subject: "type", id, message: `Type "${id}" was removed.` });
+        else
+            compareFields(type.fields ?? [], replacement.fields ?? [], "field", id, changes);
+    }
+    for (const [id] of after)
+        if (!before.has(id))
+            changes.push({ kind: "additive", subject: "type", id, message: `Type "${id}" was added.` });
+}
+function compareRelations(previous, next, changes) {
+    const before = mapById(previous);
+    const after = mapById(next);
+    for (const [id, relation] of before) {
+        const replacement = after.get(id);
+        if (replacement === undefined) {
+            changes.push({ kind: "breaking", subject: "relation", id, message: `Relation "${id}" was removed.` });
+            continue;
+        }
+        if (relation.from !== replacement.from || relation.to !== replacement.to)
+            changes.push({ kind: "breaking", subject: "relation", id, message: `Relation "${id}" changed an endpoint.` });
+        if (relation.cardinality !== replacement.cardinality)
+            changes.push({ kind: "breaking", subject: "relation", id, message: `Relation "${id}" changed cardinality.` });
+        compareFields(relation.properties ?? [], replacement.properties ?? [], "relation-property", id, changes);
+    }
+    for (const [id] of after)
+        if (!before.has(id))
+            changes.push({ kind: "additive", subject: "relation", id, message: `Relation "${id}" was added.` });
+}
+/**
+ * Compares actual model content. Labels and `schemaVersion` are intentionally
+ * not compatibility surface; stable identifiers and structural contracts are.
+ */
+export function compareDomainModels(previous, next) {
+    const previousFindings = validateDomainModel(previous);
+    const nextFindings = validateDomainModel(next);
+    if (previousFindings.some((entry) => entry.severity === "error") || nextFindings.some((entry) => entry.severity === "error")) {
+        return { compatible: false, changes: [], previousFindings, nextFindings };
+    }
+    const before = normalizeDomainModel(previous);
+    const after = normalizeDomainModel(next);
+    const changes = [];
+    if (before.id !== after.id)
+        changes.push({ kind: "breaking", subject: "model", id: after.id, message: `Model id changed from "${before.id}" to "${after.id}".` });
+    compareValueTypes(before.valueTypes, after.valueTypes, changes);
+    compareVocabularies(before.vocabularies, after.vocabularies, changes);
+    compareTypes(before.types, after.types, changes);
+    compareRelations(before.relations, after.relations, changes);
+    changes.sort((left, right) => stable(left).localeCompare(stable(right)));
+    return {
+        compatible: changes.every((entry) => entry.kind !== "breaking"),
+        changes,
+        previousFindings,
+        nextFindings,
+    };
+}
+//# sourceMappingURL=compatibility.js.map