wabachi 0.1.0

package/dist/architecture/canon/relationships.js

@@ -0,0 +1,181 @@
+import { normalizeIdentityId } from "./identity.js";
+/** The intentionally small vocabulary of canonical directed relationships. */
+export const RELATIONSHIP_KINDS = ["depends-on", "calls", "uses", "data", "control"];
+function assertRecord(value, label) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError(`${label} must be an object`);
+    }
+}
+function normalizeText(value, label) {
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} must be a string`);
+    }
+    const normalized = value.normalize("NFC").trim();
+    if (normalized.length === 0 || /[\p{Cc}\p{Cf}\p{Cs}]/u.test(normalized)) {
+        throw new TypeError(`${label} is malformed`);
+    }
+    return normalized;
+}
+function compareStrings(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function readId(record, field, label) {
+    const value = record[field];
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} ${field} must be a string`);
+    }
+    return normalizeIdentityId(value);
+}
+function readRelationshipKind(value) {
+    if (typeof value !== "string" || !RELATIONSHIP_KINDS.includes(value)) {
+        throw new TypeError(`relationship kind is unsupported: ${String(value)}`);
+    }
+    return value;
+}
+/** Create one interface/port declaration without resolving its owner. */
+export function createInterface(input) {
+    assertRecord(input, "interface");
+    const id = readId(input, "id", "interface");
+    const owner = readId(input, "owner", "interface");
+    const protocol = input.protocol === undefined ? undefined : normalizeText(input.protocol, "interface protocol");
+    const technology = input.technology === undefined ? undefined : normalizeText(input.technology, "interface technology");
+    return Object.freeze({
+        id,
+        owner,
+        ...(protocol === undefined ? {} : { protocol }),
+        ...(technology === undefined ? {} : { technology }),
+    });
+}
+/** Create one directed relationship declaration without resolving its references. */
+export function createRelationship(input) {
+    assertRecord(input, "relationship");
+    const source = readId(input, "source", "relationship");
+    const target = readId(input, "target", "relationship");
+    const kind = readRelationshipKind(input.kind);
+    const interfaceId = input.interfaceId === undefined ? undefined : readId(input, "interfaceId", "relationship");
+    return Object.freeze({
+        source,
+        target,
+        kind,
+        ...(interfaceId === undefined ? {} : { interfaceId }),
+    });
+}
+function elementIds(elements) {
+    if (elements === undefined)
+        return undefined;
+    if (!Array.isArray(elements)) {
+        throw new TypeError("relationship validation elements must be an array");
+    }
+    const ids = new Set();
+    for (const element of elements) {
+        assertRecord(element, "relationship validation element");
+        const id = readId(element, "id", "relationship validation element");
+        if (ids.has(id))
+            throw new Error(`duplicate relationship validation element id: ${id}`);
+        ids.add(id);
+    }
+    return ids;
+}
+function interfaceById(interfaces) {
+    if (interfaces === undefined)
+        return undefined;
+    if (!Array.isArray(interfaces)) {
+        throw new TypeError("relationship validation interfaces must be an array");
+    }
+    const byId = new Map();
+    for (const item of interfaces) {
+        assertRecord(item, "relationship validation interface");
+        const id = readId(item, "id", "relationship validation interface");
+        if (byId.has(id))
+            throw new Error(`duplicate interface id: ${id}`);
+        byId.set(id, item);
+    }
+    return byId;
+}
+function interfaceKey(record) {
+    return record.id;
+}
+function compareInterfaces(left, right) {
+    return compareStrings(left.id, right.id);
+}
+/** Normalize interfaces, rejecting duplicate IDs and optionally unknown owners. */
+export function normalizeInterfaces(inputs, elements) {
+    if (!Array.isArray(inputs)) {
+        throw new TypeError("interfaces must be an array");
+    }
+    const knownElements = elementIds(elements);
+    const interfaces = inputs.map(createInterface);
+    const seen = new Set();
+    for (const item of interfaces) {
+        if (seen.has(interfaceKey(item)))
+            throw new Error(`duplicate interface id: ${item.id}`);
+        seen.add(interfaceKey(item));
+        if (knownElements !== undefined && !knownElements.has(item.owner)) {
+            throw new Error(`unknown interface owner: ${item.owner}`);
+        }
+    }
+    interfaces.sort(compareInterfaces);
+    return Object.freeze(interfaces);
+}
+/** Alias matching the single-record constructor naming used by the canon modules. */
+export const createInterfaces = normalizeInterfaces;
+function compareRelationships(left, right) {
+    return (compareStrings(left.source, right.source) ||
+        compareStrings(left.target, right.target) ||
+        compareStrings(left.kind, right.kind) ||
+        compareStrings(left.interfaceId ?? "", right.interfaceId ?? ""));
+}
+function relationshipKey(record) {
+    return `${record.source}\u0000${record.target}\u0000${record.kind}\u0000${record.interfaceId ?? ""}`;
+}
+/**
+ * Normalize directed relationships. References are checked only against the
+ * supplied canonical context; no missing element or interface is synthesized.
+ */
+export function normalizeRelationships(inputs, context = {}) {
+    if (!Array.isArray(inputs)) {
+        throw new TypeError("relationships must be an array");
+    }
+    const knownElements = elementIds(context.elements);
+    const knownInterfaces = interfaceById(context.interfaces);
+    const relationships = inputs.map(createRelationship);
+    const seen = new Set();
+    for (const relationship of relationships) {
+        if (knownElements !== undefined) {
+            if (!knownElements.has(relationship.source)) {
+                throw new Error(`unknown relationship source: ${relationship.source}`);
+            }
+            if (!knownElements.has(relationship.target)) {
+                throw new Error(`unknown relationship target: ${relationship.target}`);
+            }
+        }
+        if (relationship.interfaceId !== undefined) {
+            const contract = knownInterfaces?.get(relationship.interfaceId);
+            if (contract === undefined) {
+                throw new Error(`unknown relationship interface: ${relationship.interfaceId}`);
+            }
+            if (contract.owner !== relationship.source && contract.owner !== relationship.target) {
+                throw new Error(`relationship interface owner is not an endpoint: ${relationship.interfaceId}`);
+            }
+        }
+        const key = relationshipKey(relationship);
+        if (seen.has(key)) {
+            throw new Error(`duplicate relationship: ${relationship.source} -> ${relationship.target} (${relationship.kind})`);
+        }
+        seen.add(key);
+    }
+    relationships.sort(compareRelationships);
+    return Object.freeze(relationships);
+}
+/** Validate an already-created relationship set without changing its order. */
+export function validateRelationships(relationships, context = {}) {
+    if (!Array.isArray(relationships)) {
+        throw new TypeError("relationships must be an array");
+    }
+    normalizeRelationships(relationships, context);
+}
+//# sourceMappingURL=relationships.js.map

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

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

package/dist/architecture/canon/repository-mappings.d.ts

@@ -0,0 +1,51 @@
+export type RepositoryPathScope = "file" | "directory";
+export interface RepositoryPathMapping {
+    readonly path: string;
+    readonly scope: RepositoryPathScope;
+}
+export type RepositoryPathInput = string | {
+    readonly path: string;
+    readonly scope?: RepositoryPathScope;
+};
+export interface RepositorySymbolMapping {
+    readonly path: string;
+    readonly symbol: string;
+    readonly exportName?: string;
+}
+export interface RepositorySymbolInput {
+    readonly path: string;
+    readonly symbol: string;
+    readonly exportName?: string;
+}
+export interface RepositoryTestMapping {
+    readonly path: string;
+    readonly selector: string;
+}
+export interface RepositoryTestInput {
+    readonly path: string;
+    readonly selector: string;
+}
+export interface RepositoryMappingInput {
+    readonly canonId: string;
+    readonly paths?: readonly RepositoryPathInput[];
+    readonly symbols?: readonly RepositorySymbolInput[];
+    readonly tests?: readonly RepositoryTestInput[];
+}
+export interface RepositoryMapping {
+    readonly canonId: string;
+    readonly paths: readonly RepositoryPathMapping[];
+    readonly symbols: readonly RepositorySymbolMapping[];
+    readonly tests: readonly RepositoryTestMapping[];
+}
+/**
+ * Normalizes a declaration path without consulting the repository.
+ *
+ * Backslashes and dot segments are normalized so equivalent declarations
+ * serialize identically. Parent segments are rejected instead of resolved;
+ * this keeps the declaration rooted even when its starting path is unknown.
+ */
+export declare function normalizeRepositoryPath(value: string): string;
+export declare function createRepositoryMapping(input: RepositoryMappingInput): RepositoryMapping;
+export declare function createRepositoryMappings(inputs: readonly RepositoryMappingInput[]): readonly RepositoryMapping[];
+/** Serializes declarations in canonical order; no repository access occurs. */
+export declare function serializeRepositoryMappings(mappings: readonly RepositoryMappingInput[]): string;

package/dist/architecture/canon/repository-mappings.js

@@ -0,0 +1,134 @@
+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 normalizeText(value, label) {
+    if (typeof value !== "string") {
+        throw new TypeError(`${label} must be a string`);
+    }
+    const normalized = value.normalize("NFC").trim();
+    if (normalized.length === 0 || /[\p{Cc}\p{Cf}\p{Cs}]/u.test(normalized)) {
+        throw new TypeError(`${label} is malformed`);
+    }
+    return normalized;
+}
+/**
+ * Normalizes a declaration path without consulting the repository.
+ *
+ * Backslashes and dot segments are normalized so equivalent declarations
+ * serialize identically. Parent segments are rejected instead of resolved;
+ * this keeps the declaration rooted even when its starting path is unknown.
+ */
+export function normalizeRepositoryPath(value) {
+    if (typeof value !== "string") {
+        throw new TypeError("repository path must be a string");
+    }
+    const normalized = value.normalize("NFC").replaceAll("\\", "/");
+    if (normalized.length === 0 ||
+        normalized.startsWith("/") ||
+        /^[A-Za-z]:($|\/)/u.test(normalized) ||
+        /[\p{Cc}\p{Cf}\p{Cs}]/u.test(normalized)) {
+        throw new TypeError("repository path must be relative to the repository root");
+    }
+    const segments = [];
+    for (const segment of normalized.split("/")) {
+        if (segment === "" || segment === ".")
+            continue;
+        if (segment === "..") {
+            throw new TypeError("repository path cannot escape the repository root");
+        }
+        segments.push(segment);
+    }
+    if (segments.length === 0) {
+        throw new TypeError("repository path must identify a repository-relative path");
+    }
+    return segments.join("/");
+}
+function compareStrings(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function comparePaths(left, right) {
+    return compareStrings(left.path, right.path) || compareStrings(left.scope, right.scope);
+}
+function compareSymbols(left, right) {
+    return (compareStrings(left.path, right.path) ||
+        compareStrings(left.symbol, right.symbol) ||
+        compareStrings(left.exportName ?? "", right.exportName ?? ""));
+}
+function compareTests(left, right) {
+    return compareStrings(left.path, right.path) || compareStrings(left.selector, right.selector);
+}
+function normalizePathMapping(input) {
+    const pathInput = typeof input === "string" ? { path: input } : input;
+    assertRecord(pathInput, "repository path mapping");
+    const scope = pathInput.scope ?? "file";
+    if (scope !== "file" && scope !== "directory") {
+        throw new TypeError("repository path mapping scope must be file or directory");
+    }
+    return Object.freeze({
+        path: normalizeRepositoryPath(pathInput.path),
+        scope,
+    });
+}
+function normalizeSymbolMapping(input) {
+    assertRecord(input, "repository symbol mapping");
+    const exportName = input.exportName === undefined ? undefined : normalizeText(input.exportName, "repository export name");
+    return Object.freeze({
+        path: normalizeRepositoryPath(input.path),
+        symbol: normalizeText(input.symbol, "repository symbol"),
+        ...(exportName === undefined ? {} : { exportName }),
+    });
+}
+function normalizeTestMapping(input) {
+    assertRecord(input, "repository test mapping");
+    return Object.freeze({
+        path: normalizeRepositoryPath(input.path),
+        selector: normalizeText(input.selector, "repository test selector"),
+    });
+}
+export function createRepositoryMapping(input) {
+    assertRecord(input, "repository mapping");
+    if (input.paths !== undefined && !Array.isArray(input.paths)) {
+        throw new TypeError("repository mapping paths must be an array");
+    }
+    if (input.symbols !== undefined && !Array.isArray(input.symbols)) {
+        throw new TypeError("repository mapping symbols must be an array");
+    }
+    if (input.tests !== undefined && !Array.isArray(input.tests)) {
+        throw new TypeError("repository mapping tests must be an array");
+    }
+    const paths = [...(input.paths ?? [])].map(normalizePathMapping).sort(comparePaths);
+    const symbols = [...(input.symbols ?? [])].map(normalizeSymbolMapping).sort(compareSymbols);
+    const tests = [...(input.tests ?? [])].map(normalizeTestMapping).sort(compareTests);
+    return Object.freeze({
+        canonId: normalizeIdentityId(input.canonId),
+        paths: Object.freeze(paths),
+        symbols: Object.freeze(symbols),
+        tests: Object.freeze(tests),
+    });
+}
+export function createRepositoryMappings(inputs) {
+    if (!Array.isArray(inputs)) {
+        throw new TypeError("repository mappings must be an array");
+    }
+    const mappings = inputs
+        .map(createRepositoryMapping)
+        .sort((left, right) => compareStrings(left.canonId, right.canonId));
+    for (let index = 1; index < mappings.length; index += 1) {
+        if (mappings[index - 1].canonId === mappings[index].canonId) {
+            throw new Error(`duplicate repository mapping canon id: ${mappings[index].canonId}`);
+        }
+    }
+    return Object.freeze(mappings);
+}
+/** Serializes declarations in canonical order; no repository access occurs. */
+export function serializeRepositoryMappings(mappings) {
+    return JSON.stringify(createRepositoryMappings(mappings));
+}
+//# sourceMappingURL=repository-mappings.js.map

package/dist/architecture/canon/repository-mappings.js.map

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

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

@@ -0,0 +1,40 @@
+import { type ArchitectureId, type ObjectId } from "./identity.js";
+declare const responsibilityIdBrand: unique symbol;
+export type ResponsibilityId = string & {
+    readonly [responsibilityIdBrand]: never;
+};
+export interface ResponsibilityTargetInput {
+    readonly kind: "architecture" | "object";
+    readonly id: string;
+    readonly displayName?: string;
+}
+export type ResponsibilityTarget = {
+    readonly kind: "architecture";
+    readonly id: ArchitectureId;
+} | {
+    readonly kind: "object";
+    readonly id: ObjectId;
+};
+export interface ResponsibilityInput {
+    readonly id: string;
+    readonly target: ResponsibilityTargetInput;
+    readonly concern: string;
+    readonly displayName?: string;
+}
+export interface ResponsibilityFact {
+    readonly kind: "responsibility";
+    readonly id: ResponsibilityId;
+    readonly target: ResponsibilityTarget;
+    readonly concern: string;
+}
+export interface ResponsibilitySetInput {
+    readonly responsibilities?: readonly ResponsibilityInput[];
+}
+export interface ResponsibilitySet {
+    readonly responsibilities: readonly ResponsibilityFact[];
+}
+export declare function normalizeResponsibilityId(value: string): string;
+export declare function createResponsibilityId(value: string): ResponsibilityId;
+export declare function createResponsibility(input: ResponsibilityInput): ResponsibilityFact;
+export declare function createResponsibilitySet(input: ResponsibilitySetInput): ResponsibilitySet;
+export {};

package/dist/architecture/canon/responsibilities.js

@@ -0,0 +1,89 @@
+import { createArchitectureId, createObjectId, 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 normalizeConcern(value) {
+    if (typeof value !== "string") {
+        throw new TypeError("responsibility concern 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("responsibility concern is malformed");
+    }
+    return normalized;
+}
+export function normalizeResponsibilityId(value) {
+    return normalizeIdentityId(value);
+}
+export function createResponsibilityId(value) {
+    return normalizeResponsibilityId(value);
+}
+function createTarget(input) {
+    assertRecord(input, "responsibility target");
+    const candidate = input;
+    if (candidate.kind !== "architecture" && candidate.kind !== "object") {
+        throw new TypeError("responsibility target kind is invalid");
+    }
+    if (candidate.displayName !== undefined && typeof candidate.displayName !== "string") {
+        throw new TypeError("responsibility target displayName must be a string");
+    }
+    if (candidate.kind === "architecture") {
+        return Object.freeze({
+            kind: "architecture",
+            id: createArchitectureId(candidate.id),
+        });
+    }
+    return Object.freeze({
+        kind: "object",
+        id: createObjectId(candidate.id),
+    });
+}
+export function createResponsibility(input) {
+    assertRecord(input, "responsibility");
+    const candidate = input;
+    if (candidate.displayName !== undefined && typeof candidate.displayName !== "string") {
+        throw new TypeError("responsibility displayName must be a string");
+    }
+    return Object.freeze({
+        kind: "responsibility",
+        id: createResponsibilityId(candidate.id),
+        target: createTarget(candidate.target),
+        concern: normalizeConcern(candidate.concern),
+    });
+}
+function compareResponsibility(left, right) {
+    if (left.id < right.id)
+        return -1;
+    if (left.id > right.id)
+        return 1;
+    return 0;
+}
+function declarationKey(fact) {
+    return `${fact.target.kind}:${fact.target.id}\u0000${fact.concern}`;
+}
+export function createResponsibilitySet(input) {
+    assertRecord(input, "responsibility set");
+    const candidate = input;
+    if (candidate.responsibilities !== undefined && !Array.isArray(candidate.responsibilities)) {
+        throw new TypeError("responsibility set responsibilities must be an array");
+    }
+    const responsibilities = (candidate.responsibilities ?? []).map((item) => createResponsibility(item));
+    const ids = new Set();
+    const declarations = new Set();
+    for (const responsibility of responsibilities) {
+        if (ids.has(responsibility.id)) {
+            throw new Error(`duplicate responsibility id: ${responsibility.id}`);
+        }
+        ids.add(responsibility.id);
+        const key = declarationKey(responsibility);
+        if (declarations.has(key)) {
+            throw new Error(`duplicate responsibility declaration: ${responsibility.target.kind}:${responsibility.target.id}`);
+        }
+        declarations.add(key);
+    }
+    responsibilities.sort(compareResponsibility);
+    return Object.freeze({ responsibilities: Object.freeze(responsibilities) });
+}
+//# sourceMappingURL=responsibilities.js.map

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

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

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

@@ -0,0 +1,14 @@
+import type { ArchitectureDocumentV1 } from "./document.js";
+export declare const ARCHITECTURE_DIAGNOSTIC_CODES: readonly ["identity-registry-mismatch", "duplicate-identity-registry-entry", "unknown-reference", "invalid-reference-kind", "invalid-containment-reference", "invalid-interface-owner", "invalid-relationship-endpoint", "invalid-relationship-interface", "invalid-responsibility-target", "invalid-boundary-member", "invalid-authority-target", "invalid-constraint-target", "invalid-flow-reference", "invalid-deployment-reference", "invalid-repository-mapping", "invalid-decision-target", "invalid-decision-reference", "invalid-supersession", "invalid-view-reference"];
+export type ArchitectureDiagnosticCode = (typeof ARCHITECTURE_DIAGNOSTIC_CODES)[number];
+export interface ArchitectureDiagnostic {
+    readonly code: ArchitectureDiagnosticCode;
+    readonly path: string;
+    readonly message: string;
+}
+export interface ArchitectureDocumentValidationResult {
+    readonly valid: boolean;
+    readonly diagnostics: readonly ArchitectureDiagnostic[];
+}
+/** Validate complete-document Canon semantics without mutating the document. */
+export declare function validateArchitectureDocument(document: ArchitectureDocumentV1): ArchitectureDocumentValidationResult;