wabachi 0.1.0

package/dist/architecture/canon/document.d.ts

@@ -0,0 +1,60 @@
+import { type ArchitectureIdentity, type CanonVersion, type DocumentId, type IdentityInput } from "./identity.js";
+import { type ElementInput, type ElementRecord } from "./elements.js";
+import { type InterfaceInput, type InterfaceRecord, type RelationshipInput, type RelationshipRecord } from "./relationships.js";
+import { type ResponsibilitySet, type ResponsibilitySetInput } from "./responsibilities.js";
+import { type AuthorityOwnershipFacts, type AuthorityOwnershipFactsInput } from "./authority.js";
+import { type Boundary, type BoundaryInput } from "./boundaries.js";
+import { type ArchitectureConstraint, type ArchitectureConstraintInput } from "./constraints.js";
+import { type Flow, type FlowInput } from "./flows.js";
+import { type DeploymentTopology, type DeploymentTopologyInput } from "./deployment.js";
+import { type RepositoryMapping, type RepositoryMappingInput } from "./repository-mappings.js";
+import { type ArchitectureDecisions, type ArchitectureDecisionsInput } from "./decisions.js";
+import { type ViewInput, type ViewSpec } from "./views.js";
+/** Canon v1 sections are emitted in the order established by leaf implementation order. */
+export declare const CANON_SECTION_ORDER: readonly ["elements", "interfaces", "relationships", "responsibilities", "authority", "boundaries", "constraints", "flows", "deployment", "repositoryMappings", "decisions", "views"];
+export type CanonSectionName = (typeof CANON_SECTION_ORDER)[number];
+export interface ArchitectureDocumentInput {
+    readonly documentId: string;
+    readonly root: IdentityInput;
+    readonly elements?: readonly ElementInput[];
+    readonly interfaces?: readonly InterfaceInput[];
+    readonly relationships?: readonly RelationshipInput[];
+    readonly responsibilities?: ResponsibilitySetInput;
+    readonly authority?: AuthorityOwnershipFactsInput;
+    readonly boundaries?: readonly BoundaryInput[];
+    readonly constraints?: readonly ArchitectureConstraintInput[];
+    readonly flows?: readonly FlowInput[];
+    readonly deployment?: DeploymentTopologyInput;
+    readonly repositoryMappings?: readonly RepositoryMappingInput[];
+    readonly decisions?: ArchitectureDecisionsInput;
+    readonly views?: readonly ViewInput[];
+}
+export type GlobalIdentityNamespace = "architecture" | "element" | "interface" | "responsibility" | "boundary" | "flow" | "decision" | "reference";
+export interface GlobalIdentityEntry {
+    readonly id: string;
+    readonly namespace: GlobalIdentityNamespace;
+}
+/** Deterministic registry of canonical identities owned by the complete document. */
+export interface GlobalIdentityRegistry {
+    readonly entries: readonly GlobalIdentityEntry[];
+}
+export interface ArchitectureDocumentV1 {
+    readonly canonVersion: CanonVersion;
+    readonly documentId: DocumentId;
+    readonly root: ArchitectureIdentity;
+    readonly elements: readonly ElementRecord[];
+    readonly interfaces: readonly InterfaceRecord[];
+    readonly relationships: readonly RelationshipRecord[];
+    readonly responsibilities: ResponsibilitySet;
+    readonly authority: AuthorityOwnershipFacts;
+    readonly boundaries: readonly Boundary[];
+    readonly constraints: readonly ArchitectureConstraint[];
+    readonly flows: readonly Flow[];
+    readonly deployment: DeploymentTopology;
+    readonly repositoryMappings: readonly RepositoryMapping[];
+    readonly decisions: ArchitectureDecisions;
+    readonly views: readonly ViewSpec[];
+    readonly globalIdentityRegistry: GlobalIdentityRegistry;
+}
+/** Compose all Canon v1 leaf sections without performing cross-section validation. */
+export declare function createArchitectureDocument(input: ArchitectureDocumentInput): ArchitectureDocumentV1;

package/dist/architecture/canon/document.js

@@ -0,0 +1,106 @@
+import { CANON_VERSION, createArchitectureIdentity, createDocumentId, } from "./identity.js";
+import { normalizeElements } from "./elements.js";
+import { normalizeInterfaces, normalizeRelationships, } from "./relationships.js";
+import { createResponsibilitySet } from "./responsibilities.js";
+import { createAuthorityOwnershipFacts, } from "./authority.js";
+import { createBoundaries } from "./boundaries.js";
+import { createConstraints } from "./constraints.js";
+import { createFlows } from "./flows.js";
+import { createDeploymentTopology } from "./deployment.js";
+import { createRepositoryMappings, } from "./repository-mappings.js";
+import { createArchitectureDecisions, } from "./decisions.js";
+import { normalizeViews } from "./views.js";
+/** Canon v1 sections are emitted in the order established by leaf implementation order. */
+export const CANON_SECTION_ORDER = [
+    "elements",
+    "interfaces",
+    "relationships",
+    "responsibilities",
+    "authority",
+    "boundaries",
+    "constraints",
+    "flows",
+    "deployment",
+    "repositoryMappings",
+    "decisions",
+    "views",
+];
+function assertDocumentInput(input) {
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        throw new TypeError("architecture document must be an object");
+    }
+}
+function compareIdentityEntries(left, right) {
+    if (left.id < right.id)
+        return -1;
+    if (left.id > right.id)
+        return 1;
+    if (left.namespace < right.namespace)
+        return -1;
+    if (left.namespace > right.namespace)
+        return 1;
+    return 0;
+}
+function createGlobalIdentityRegistry(document) {
+    const entries = [
+        { id: document.root.id, namespace: "architecture" },
+        ...document.elements.map(({ id }) => ({ id, namespace: "element" })),
+        ...document.interfaces.map(({ id }) => ({ id, namespace: "interface" })),
+        ...document.responsibilities.responsibilities.map(({ id }) => ({ id, namespace: "responsibility" })),
+        ...document.boundaries.map(({ id }) => ({ id, namespace: "boundary" })),
+        ...document.flows.map(({ id }) => ({ id, namespace: "flow" })),
+        ...document.decisions.decisions.map(({ id }) => ({ id, namespace: "decision" })),
+        ...document.decisions.references.map(({ id }) => ({ id, namespace: "reference" })),
+    ];
+    entries.sort(compareIdentityEntries);
+    for (let index = 1; index < entries.length; index += 1) {
+        const previous = entries[index - 1];
+        const current = entries[index];
+        if (previous.id === current.id) {
+            throw new Error(`duplicate canonical id: ${current.id} (${previous.namespace}, ${current.namespace})`);
+        }
+    }
+    return Object.freeze({
+        entries: Object.freeze(entries.map((entry) => Object.freeze(entry))),
+    });
+}
+/** Compose all Canon v1 leaf sections without performing cross-section validation. */
+export function createArchitectureDocument(input) {
+    assertDocumentInput(input);
+    const root = createArchitectureIdentity(input.root);
+    const documentId = createDocumentId(input.documentId);
+    const elements = normalizeElements(input.elements ?? []);
+    const interfaces = normalizeInterfaces(input.interfaces ?? []);
+    const relationships = normalizeRelationships(input.relationships ?? []);
+    const responsibilities = createResponsibilitySet(input.responsibilities ?? {});
+    const authority = createAuthorityOwnershipFacts(input.authority ?? {});
+    const boundaries = createBoundaries(input.boundaries ?? []);
+    const constraints = createConstraints(input.constraints ?? []);
+    const flows = createFlows(input.flows ?? []);
+    const deployment = createDeploymentTopology(input.deployment ?? {});
+    const repositoryMappings = createRepositoryMappings(input.repositoryMappings ?? []);
+    const decisions = createArchitectureDecisions(input.decisions ?? {});
+    const views = normalizeViews(input.views ?? []);
+    const document = {
+        canonVersion: CANON_VERSION,
+        documentId,
+        root,
+        elements,
+        interfaces,
+        relationships,
+        responsibilities,
+        authority,
+        boundaries,
+        constraints,
+        flows,
+        deployment,
+        repositoryMappings,
+        decisions,
+        views,
+    };
+    return Object.freeze({
+        ...document,
+        globalIdentityRegistry: createGlobalIdentityRegistry(document),
+    });
+}
+//# sourceMappingURL=document.js.map

package/dist/architecture/canon/document.js.map

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

package/dist/architecture/canon/elements.d.ts

@@ -0,0 +1,21 @@
+import { type ObjectId } from "./identity.js";
+/** The canonical kinds supported by an Architecture Canon element record. */
+export declare const ELEMENT_KINDS: readonly ["system", "service", "component", "data-store", "external-system"];
+export type ElementKind = (typeof ELEMENT_KINDS)[number];
+export interface ElementInput {
+    readonly id: string;
+    readonly kind: ElementKind;
+    readonly displayName?: string;
+    readonly parentId?: string;
+}
+export interface ElementRecord {
+    readonly id: ObjectId;
+    readonly kind: ElementKind;
+    readonly parentId?: ObjectId;
+}
+/** Create one canonical record; display names are deliberately not semantic identity. */
+export declare function createElement(input: ElementInput): ElementRecord;
+/** Normalize records into a frozen, deterministic, validated containment set. */
+export declare function normalizeElements(inputs: readonly ElementInput[]): readonly ElementRecord[];
+/** Validate an already-created record set without changing its order. */
+export declare function validateContainment(elements: readonly ElementRecord[]): void;

package/dist/architecture/canon/elements.js

@@ -0,0 +1,87 @@
+import { createObjectId, normalizeIdentityId } from "./identity.js";
+/** The canonical kinds supported by an Architecture Canon element record. */
+export const ELEMENT_KINDS = ["system", "service", "component", "data-store", "external-system"];
+function assertRecordInput(input) {
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        throw new TypeError("element must be an object");
+    }
+    const candidate = input;
+    normalizeIdentityId(candidate.id);
+    if (!ELEMENT_KINDS.includes(candidate.kind)) {
+        throw new TypeError(`element kind is unsupported: ${String(candidate.kind)}`);
+    }
+    if (candidate.displayName !== undefined && typeof candidate.displayName !== "string") {
+        throw new TypeError("element displayName must be a string");
+    }
+    if (candidate.parentId !== undefined) {
+        normalizeIdentityId(candidate.parentId);
+    }
+}
+/** Create one canonical record; display names are deliberately not semantic identity. */
+export function createElement(input) {
+    assertRecordInput(input);
+    const record = {
+        id: createObjectId(input.id),
+        kind: input.kind,
+    };
+    if (input.parentId !== undefined) {
+        return Object.freeze({ ...record, parentId: createObjectId(input.parentId) });
+    }
+    return Object.freeze(record);
+}
+function compareElements(left, right) {
+    if (left.id < right.id)
+        return -1;
+    if (left.id > right.id)
+        return 1;
+    return 0;
+}
+function assertContainmentIsValid(elements) {
+    const byId = new Map();
+    for (const element of elements) {
+        if (byId.has(element.id)) {
+            throw new Error(`duplicate element id: ${element.id}`);
+        }
+        byId.set(element.id, element);
+    }
+    for (const element of elements) {
+        if (element.parentId !== undefined && !byId.has(element.parentId)) {
+            throw new Error(`unknown parent id: ${element.parentId}`);
+        }
+    }
+    const visiting = new Set();
+    const visited = new Set();
+    const visit = (element) => {
+        if (visited.has(element.id))
+            return;
+        if (visiting.has(element.id)) {
+            throw new Error(`containment cycle detected at: ${element.id}`);
+        }
+        visiting.add(element.id);
+        if (element.parentId !== undefined) {
+            visit(byId.get(element.parentId));
+        }
+        visiting.delete(element.id);
+        visited.add(element.id);
+    };
+    for (const element of elements)
+        visit(element);
+}
+/** Normalize records into a frozen, deterministic, validated containment set. */
+export function normalizeElements(inputs) {
+    if (!Array.isArray(inputs)) {
+        throw new TypeError("elements must be an array");
+    }
+    const elements = inputs.map(createElement);
+    assertContainmentIsValid(elements);
+    elements.sort(compareElements);
+    return Object.freeze(elements);
+}
+/** Validate an already-created record set without changing its order. */
+export function validateContainment(elements) {
+    if (!Array.isArray(elements)) {
+        throw new TypeError("elements must be an array");
+    }
+    assertContainmentIsValid(elements);
+}
+//# sourceMappingURL=elements.js.map

package/dist/architecture/canon/elements.js.map

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

package/dist/architecture/canon/flows.d.ts

@@ -0,0 +1,37 @@
+declare const flowIdBrand: unique symbol;
+export type FlowId = string & {
+    readonly [flowIdBrand]: never;
+};
+export interface FlowStepInput {
+    /** An opaque canonical relationship identity resolved by complete-document validation. */
+    readonly relationshipId?: string;
+    /** An opaque canonical interface identity resolved by complete-document validation. */
+    readonly interfaceId?: string;
+    readonly operation?: string;
+    readonly information?: string;
+}
+export interface FlowStep {
+    readonly relationshipId?: string;
+    readonly interfaceId?: string;
+    readonly operation?: string;
+    readonly information?: string;
+}
+export interface FlowInput {
+    readonly id: string;
+    readonly steps: readonly FlowStepInput[];
+}
+export interface Flow {
+    readonly id: FlowId;
+    /** Step order is semantic and is intentionally never sorted. */
+    readonly steps: readonly FlowStep[];
+}
+export declare function createFlow(input: FlowInput): Flow;
+/**
+ * Creates a deterministic flow collection. Flow identity order is canonical;
+ * step order remains exactly the declared semantic sequence.
+ *
+ * Relationship and interface references are intentionally opaque here. Their
+ * existence is checked only by complete-document validation.
+ */
+export declare function createFlows(inputs: readonly FlowInput[]): readonly Flow[];
+export {};

package/dist/architecture/canon/flows.js

@@ -0,0 +1,82 @@
+import { normalizeIdentityId } from "./identity.js";
+function assertRecord(value, label) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError(`${label} must be an object`);
+    }
+}
+function normalizeId(value, label) {
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} must be a string`);
+    }
+    try {
+        return normalizeIdentityId(value);
+    }
+    catch {
+        throw new TypeError(`${label} is malformed`);
+    }
+}
+function normalizeText(value, label) {
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} must be a string`);
+    }
+    const normalized = value.normalize("NFC");
+    if (normalized.trim().length === 0 || /[\p{Cc}\p{Cf}\p{Cs}]/u.test(normalized)) {
+        throw new TypeError(`${label} is malformed`);
+    }
+    return normalized;
+}
+function compareOrdinal(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function normalizeFlowStep(input) {
+    assertRecord(input, "flow step");
+    const relationshipId = input.relationshipId === undefined ? undefined : normalizeId(input.relationshipId, "flow step relationshipId");
+    const interfaceId = input.interfaceId === undefined ? undefined : normalizeId(input.interfaceId, "flow step interfaceId");
+    if (relationshipId === undefined && interfaceId === undefined) {
+        throw new TypeError("flow step must reference a relationship or interface");
+    }
+    const operation = input.operation === undefined ? undefined : normalizeText(input.operation, "flow step operation");
+    const information = input.information === undefined ? undefined : normalizeText(input.information, "flow step information");
+    return Object.freeze({
+        ...(relationshipId === undefined ? {} : { relationshipId }),
+        ...(interfaceId === undefined ? {} : { interfaceId }),
+        ...(operation === undefined ? {} : { operation }),
+        ...(information === undefined ? {} : { information }),
+    });
+}
+export function createFlow(input) {
+    assertRecord(input, "flow");
+    const id = normalizeId(input.id, "flow id");
+    if (!Array.isArray(input.steps)) {
+        throw new TypeError("flow steps must be an array");
+    }
+    const steps = input.steps.map(normalizeFlowStep);
+    return Object.freeze({ id, steps: Object.freeze(steps) });
+}
+/**
+ * Creates a deterministic flow collection. Flow identity order is canonical;
+ * step order remains exactly the declared semantic sequence.
+ *
+ * Relationship and interface references are intentionally opaque here. Their
+ * existence is checked only by complete-document validation.
+ */
+export function createFlows(inputs) {
+    if (!Array.isArray(inputs)) {
+        throw new TypeError("flows must be an array");
+    }
+    const flows = inputs.map(createFlow);
+    const seen = new Set();
+    for (const flow of flows) {
+        if (seen.has(flow.id)) {
+            throw new Error(`duplicate flow id: ${flow.id}`);
+        }
+        seen.add(flow.id);
+    }
+    flows.sort((left, right) => compareOrdinal(left.id, right.id));
+    return Object.freeze(flows);
+}
+//# sourceMappingURL=flows.js.map

package/dist/architecture/canon/flows.js.map

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

package/dist/architecture/canon/identity.d.ts

@@ -0,0 +1,45 @@
+declare const CANON_VERSION: 1;
+declare const architectureIdBrand: unique symbol;
+declare const objectIdBrand: unique symbol;
+declare const documentIdBrand: unique symbol;
+export type CanonVersion = typeof CANON_VERSION;
+export type ArchitectureId = string & {
+    readonly [architectureIdBrand]: never;
+};
+export type ObjectId = string & {
+    readonly [objectIdBrand]: never;
+};
+export type DocumentId = string & {
+    readonly [documentIdBrand]: never;
+};
+export interface IdentityInput {
+    readonly id: string;
+    readonly displayName?: string;
+}
+export interface ArchitectureIdentity {
+    readonly kind: "architecture";
+    readonly id: ArchitectureId;
+}
+export interface ObjectIdentity {
+    readonly kind: "object";
+    readonly id: ObjectId;
+}
+export interface ArchitectureCanonEnvelopeInput {
+    readonly documentId: string;
+    readonly root: IdentityInput;
+    readonly objects?: readonly IdentityInput[];
+}
+export interface ArchitectureCanonEnvelope {
+    readonly canonVersion: CanonVersion;
+    readonly documentId: DocumentId;
+    readonly root: ArchitectureIdentity;
+    readonly objects: readonly ObjectIdentity[];
+}
+export { CANON_VERSION };
+export declare function normalizeIdentityId(value: string): string;
+export declare function createArchitectureId(value: string): ArchitectureId;
+export declare function createObjectId(value: string): ObjectId;
+export declare function createDocumentId(value: string): DocumentId;
+export declare function createArchitectureIdentity(input: IdentityInput): ArchitectureIdentity;
+export declare function createObjectIdentity(input: IdentityInput): ObjectIdentity;
+export declare function createArchitectureCanonEnvelope(input: ArchitectureCanonEnvelopeInput): ArchitectureCanonEnvelope;

package/dist/architecture/canon/identity.js

@@ -0,0 +1,83 @@
+const CANON_VERSION = 1;
+export { CANON_VERSION };
+function normalizeId(value, label) {
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} must be a string`);
+    }
+    const normalized = value.normalize("NFC");
+    if (normalized.length === 0 || /[\p{White_Space}\p{Cc}\p{Cf}\p{Cs}]/u.test(normalized)) {
+        throw new TypeError(`${label} is malformed`);
+    }
+    return normalized;
+}
+function validateIdentityInput(input) {
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        throw new TypeError("identity must be an object");
+    }
+    const candidate = input;
+    normalizeId(candidate.id, "identity id");
+    if (candidate.displayName !== undefined && typeof candidate.displayName !== "string") {
+        throw new TypeError("identity displayName must be a string");
+    }
+}
+export function normalizeIdentityId(value) {
+    return normalizeId(value, "identity id");
+}
+export function createArchitectureId(value) {
+    return normalizeIdentityId(value);
+}
+export function createObjectId(value) {
+    return normalizeIdentityId(value);
+}
+export function createDocumentId(value) {
+    return normalizeId(value, "document id");
+}
+export function createArchitectureIdentity(input) {
+    validateIdentityInput(input);
+    return Object.freeze({
+        kind: "architecture",
+        id: createArchitectureId(input.id),
+    });
+}
+export function createObjectIdentity(input) {
+    validateIdentityInput(input);
+    return Object.freeze({
+        kind: "object",
+        id: createObjectId(input.id),
+    });
+}
+export function createArchitectureCanonEnvelope(input) {
+    if (input === null || typeof input !== "object" || Array.isArray(input)) {
+        throw new TypeError("canon envelope must be an object");
+    }
+    const candidate = input;
+    const documentId = createDocumentId(candidate.documentId);
+    const root = createArchitectureIdentity(candidate.root);
+    if (candidate.objects !== undefined &&
+        (!Array.isArray(candidate.objects) ||
+            candidate.objects.some((object) => object === null || typeof object !== "object"))) {
+        throw new TypeError("canon envelope objects must be an array of identities");
+    }
+    const objects = (candidate.objects ?? []).map((object) => createObjectIdentity(object));
+    const objectIds = new Set();
+    for (const object of objects) {
+        if (objectIds.has(object.id)) {
+            throw new Error(`duplicate object id: ${object.id}`);
+        }
+        objectIds.add(object.id);
+    }
+    objects.sort((left, right) => {
+        if (left.id < right.id)
+            return -1;
+        if (left.id > right.id)
+            return 1;
+        return 0;
+    });
+    return Object.freeze({
+        canonVersion: CANON_VERSION,
+        documentId,
+        root,
+        objects: Object.freeze(objects),
+    });
+}
+//# sourceMappingURL=identity.js.map

package/dist/architecture/canon/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/architecture/canon/identity.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,CAAU,CAAC;AAuCjC,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,SAAS,WAAW,CAAC,KAAc,EAAE,KAAa;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,sCAAsC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,eAAe,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,SAAS,CAAC,4BAA4B,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,SAAS,GAAG,KAAgD,CAAC;IACnE,WAAW,CAAC,SAAS,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;IACzC,IAAI,SAAS,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACrF,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,OAAO,mBAAmB,CAAC,KAAK,CAAmB,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,mBAAmB,CAAC,KAAK,CAAa,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,WAAW,CAAC,KAAK,EAAE,aAAa,CAAe,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAoB;IAC7D,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAE7B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,cAAuB;QAC7B,EAAE,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;KACnC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAoB;IACvD,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAE7B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAiB;QACvB,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAAqC;IACnF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,SAAS,CAAC,kCAAkC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,SAAS,GAAG,KAIjB,CAAC;IACF,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,UAAoB,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,0BAA0B,CAAC,SAAS,CAAC,IAAqB,CAAC,CAAC;IAEzE,IACE,SAAS,CAAC,OAAO,KAAK,SAAS;QAC/B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;YAChC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,EACpF,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,uDAAuD,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAuB,CAAC,CAAC,CAAC;IACzG,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC3B,IAAI,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE;YAAE,OAAO,CAAC,CAAC;QACjC,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,YAAY,EAAE,aAAa;QAC3B,UAAU;QACV,IAAI;QACJ,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;KAChC,CAAC,CAAC;AACL,CAAC"}

package/dist/architecture/canon/relationships.d.ts

@@ -0,0 +1,48 @@
+import { type ObjectId } from "./identity.js";
+import type { ElementRecord } from "./elements.js";
+/** The intentionally small vocabulary of canonical directed relationships. */
+export declare const RELATIONSHIP_KINDS: readonly ["depends-on", "calls", "uses", "data", "control"];
+export type RelationshipKind = (typeof RELATIONSHIP_KINDS)[number];
+export interface InterfaceInput {
+    readonly id: string;
+    readonly owner: string;
+    readonly protocol?: string;
+    readonly technology?: string;
+}
+export interface InterfaceRecord {
+    readonly id: ObjectId;
+    readonly owner: ObjectId;
+    readonly protocol?: string;
+    readonly technology?: string;
+}
+export interface RelationshipInput {
+    readonly source: string;
+    readonly target: string;
+    readonly kind: RelationshipKind;
+    readonly interfaceId?: string;
+}
+export interface RelationshipRecord {
+    readonly source: ObjectId;
+    readonly target: ObjectId;
+    readonly kind: RelationshipKind;
+    readonly interfaceId?: ObjectId;
+}
+export interface RelationshipValidationContext {
+    readonly elements?: readonly ElementRecord[];
+    readonly interfaces?: readonly InterfaceRecord[];
+}
+/** Create one interface/port declaration without resolving its owner. */
+export declare function createInterface(input: InterfaceInput): InterfaceRecord;
+/** Create one directed relationship declaration without resolving its references. */
+export declare function createRelationship(input: RelationshipInput): RelationshipRecord;
+/** Normalize interfaces, rejecting duplicate IDs and optionally unknown owners. */
+export declare function normalizeInterfaces(inputs: readonly InterfaceInput[], elements?: readonly ElementRecord[]): readonly InterfaceRecord[];
+/** Alias matching the single-record constructor naming used by the canon modules. */
+export declare const createInterfaces: typeof normalizeInterfaces;
+/**
+ * Normalize directed relationships. References are checked only against the
+ * supplied canonical context; no missing element or interface is synthesized.
+ */
+export declare function normalizeRelationships(inputs: readonly RelationshipInput[], context?: RelationshipValidationContext): readonly RelationshipRecord[];
+/** Validate an already-created relationship set without changing its order. */
+export declare function validateRelationships(relationships: readonly RelationshipRecord[], context?: RelationshipValidationContext): void;