wabachi 0.1.0

package/dist/architecture/canon/views.js

@@ -0,0 +1,182 @@
+import { normalizeIdentityId } from "./identity.js";
+export const VIEW_KINDS = ["structural", "dynamic", "deployment"];
+export const VIEW_REFERENCE_KINDS = [
+    "element",
+    "relationship",
+    "flow",
+    "runtime-environment",
+    "deployment-node",
+    "deployment-instance",
+    "infrastructure-reference",
+];
+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 compareOrdinal(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function readViewKind(value) {
+    if (typeof value !== "string" || !VIEW_KINDS.includes(value)) {
+        throw new TypeError(`view kind is unsupported: ${String(value)}`);
+    }
+    return value;
+}
+function normalizeOrder(value) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new TypeError("view order must be a finite number");
+    }
+    return Object.is(value, -0) ? 0 : value;
+}
+function readReferenceKind(value) {
+    if (typeof value !== "string" || !VIEW_REFERENCE_KINDS.includes(value)) {
+        throw new TypeError(`view reference kind is unsupported: ${String(value)}`);
+    }
+    return value;
+}
+function normalizeReference(input) {
+    assertRecord(input, "view reference");
+    const kind = readReferenceKind(input.kind);
+    const id = normalizeIdentityId(input.id);
+    return Object.freeze({ kind, id });
+}
+function referenceKey(reference) {
+    return `${reference.kind}\u0000${reference.id}`;
+}
+function compareReferences(left, right) {
+    return compareOrdinal(referenceKey(left), referenceKey(right));
+}
+function normalizeReferenceList(value, label) {
+    if (value === undefined)
+        return Object.freeze([]);
+    if (!Array.isArray(value)) {
+        throw new TypeError(`view scope ${label} must be an array`);
+    }
+    const references = value.map(normalizeReference);
+    const seen = new Set();
+    for (const reference of references) {
+        const key = referenceKey(reference);
+        if (seen.has(key)) {
+            throw new Error(`duplicate view ${label} reference: ${reference.kind} ${reference.id}`);
+        }
+        seen.add(key);
+    }
+    references.sort(compareReferences);
+    return Object.freeze(references);
+}
+function normalizeScope(input) {
+    assertRecord(input, "view scope");
+    const include = normalizeReferenceList(input.include, "include");
+    const exclude = normalizeReferenceList(input.exclude, "exclude");
+    const included = new Set(include.map(referenceKey));
+    for (const reference of exclude) {
+        if (included.has(referenceKey(reference))) {
+            throw new Error(`view reference cannot be both included and excluded: ${reference.kind} ${reference.id}`);
+        }
+    }
+    return Object.freeze({ include, exclude });
+}
+function normalizePresentation(value) {
+    if (value === undefined)
+        return undefined;
+    assertRecord(value, "view presentation");
+    const layout = value.layout === undefined ? undefined : normalizeText(value.layout, "view presentation layout");
+    const direction = value.direction === undefined ? undefined : normalizeText(value.direction, "view presentation direction");
+    const grouping = value.grouping === undefined ? undefined : normalizeText(value.grouping, "view presentation grouping");
+    if (layout === undefined && direction === undefined && grouping === undefined) {
+        return Object.freeze({});
+    }
+    return Object.freeze({
+        ...(layout === undefined ? {} : { layout }),
+        ...(direction === undefined ? {} : { direction }),
+        ...(grouping === undefined ? {} : { grouping }),
+    });
+}
+function normalizeView(input) {
+    assertRecord(input, "view");
+    const key = normalizeIdentityId(input.key);
+    const kind = readViewKind(input.kind);
+    const scope = normalizeScope(input.scope);
+    const order = normalizeOrder(input.order);
+    const title = input.title === undefined ? undefined : normalizeText(input.title, "view title");
+    const presentation = normalizePresentation(input.presentation);
+    return Object.freeze({
+        key,
+        kind,
+        scope,
+        ...(order === undefined ? {} : { order }),
+        ...(title === undefined ? {} : { title }),
+        ...(presentation === undefined ? {} : { presentation }),
+    });
+}
+export function createView(input) {
+    return normalizeView(input);
+}
+export function createStructuralView(input) {
+    const view = normalizeView(input);
+    if (view.kind !== "structural") {
+        throw new TypeError("view kind must be structural");
+    }
+    return view;
+}
+export function createDynamicView(input) {
+    const view = normalizeView(input);
+    if (view.kind !== "dynamic") {
+        throw new TypeError("view kind must be dynamic");
+    }
+    return view;
+}
+export function createDeploymentView(input) {
+    const view = normalizeView(input);
+    if (view.kind !== "deployment") {
+        throw new TypeError("view kind must be deployment");
+    }
+    return view;
+}
+function compareViews(left, right) {
+    if (left.order !== undefined || right.order !== undefined) {
+        if (left.order === undefined)
+            return 1;
+        if (right.order === undefined)
+            return -1;
+        const order = left.order - right.order;
+        if (order !== 0)
+            return order;
+    }
+    return compareOrdinal(left.key, right.key);
+}
+/** Normalize view identity order without resolving references into architecture facts. */
+export function normalizeViews(inputs) {
+    if (!Array.isArray(inputs)) {
+        throw new TypeError("views must be an array");
+    }
+    const views = inputs.map(normalizeView);
+    const seen = new Set();
+    for (const view of views) {
+        if (seen.has(view.key)) {
+            throw new Error(`duplicate view key: ${view.key}`);
+        }
+        seen.add(view.key);
+    }
+    views.sort(compareViews);
+    return Object.freeze(views);
+}
+export const createViews = normalizeViews;
+//# sourceMappingURL=views.js.map

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

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

package/dist/architecture/cli.d.ts

@@ -0,0 +1,2 @@
+/** Adapt the public architecture CLI to the existing Canon and projection APIs. */
+export declare function runArchitectureCli(args: readonly string[]): Promise<number>;

package/dist/architecture/cli.js

@@ -0,0 +1,158 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { parseCanonicalArchitectureDocument } from "./canon/codec.js";
+import { projectArchitectureDocument } from "./documentation/project.js";
+import { ArchitectureSiteError, buildArchitectureSite } from "./documentation/site.js";
+import { projectArchitectureDocumentToStructurizr } from "./projection/structurizr.js";
+const DEFAULT_STRUCTURIZR_COMMAND = "structurizr";
+const MAX_DIAGNOSTIC_LENGTH = 240;
+function usage(command) {
+    if (command === "validate")
+        return "usage: PACKAGE_NAME architecture validate <file> [--json]";
+    if (command === "render") {
+        return "usage: PACKAGE_NAME architecture render <file> --out <dir> [--structurizr-command <executable-path>] [--json]";
+    }
+    return "usage: PACKAGE_NAME architecture <validate|render> ...";
+}
+function bounded(value) {
+    const message = value.replace(/\s+/gu, " ").trim();
+    if (message.length <= MAX_DIAGNOSTIC_LENGTH)
+        return message;
+    return `${message.slice(0, MAX_DIAGNOSTIC_LENGTH - 1)}…`;
+}
+function errorMessage(error) {
+    return bounded(error instanceof Error ? error.message : String(error));
+}
+function parseArguments(args) {
+    const command = args[0];
+    const json = args.includes("--json");
+    if (command !== "validate" && command !== "render") {
+        return { ok: false, json, message: usage() };
+    }
+    let file;
+    let outputRoot;
+    let structurizrCommand;
+    for (let index = 1; index < args.length; index += 1) {
+        const argument = args[index];
+        if (argument === "--json")
+            continue;
+        if (argument === "--out") {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return { ok: false, json, message: "--out requires a directory" };
+            }
+            if (outputRoot !== undefined)
+                return { ok: false, json, message: "--out may be provided only once" };
+            outputRoot = value;
+            index += 1;
+            continue;
+        }
+        if (argument === "--structurizr-command") {
+            const value = args[index + 1];
+            if (value === undefined || value.startsWith("--")) {
+                return { ok: false, json, message: "--structurizr-command requires an executable path" };
+            }
+            if (structurizrCommand !== undefined) {
+                return { ok: false, json, message: "--structurizr-command may be provided only once" };
+            }
+            structurizrCommand = value;
+            index += 1;
+            continue;
+        }
+        if (argument.startsWith("--"))
+            return { ok: false, json, message: `unknown option: ${argument}` };
+        if (file !== undefined)
+            return { ok: false, json, message: "architecture commands accept one explicit file" };
+        file = argument;
+    }
+    if (file === undefined)
+        return { ok: false, json, message: usage(command) };
+    if (command === "validate" && (outputRoot !== undefined || structurizrCommand !== undefined)) {
+        return { ok: false, json, message: "validate does not accept render options" };
+    }
+    if (command === "render" && outputRoot === undefined) {
+        return { ok: false, json, message: "render requires --out <dir>" };
+    }
+    return { ok: true, value: { command, file, outputRoot, structurizrCommand, json } };
+}
+function writeFailure(command, json, diagnostic) {
+    const result = {
+        ok: false,
+        command: `architecture ${command}`,
+        diagnostics: [{ code: bounded(diagnostic.code), message: bounded(diagnostic.message) }],
+    };
+    if (json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.error(`${result.command}: ${result.diagnostics[0]?.message ?? "command failed"}`);
+    }
+    return 1;
+}
+function writeUsageFailure(json, message) {
+    const diagnostic = { code: "invalid-arguments", message: bounded(message) };
+    if (json) {
+        console.log(JSON.stringify({ ok: false, command: "architecture", diagnostics: [diagnostic] }));
+    }
+    else {
+        console.error(diagnostic.message);
+    }
+    return 1;
+}
+/** Adapt the public architecture CLI to the existing Canon and projection APIs. */
+export async function runArchitectureCli(args) {
+    const parsed = parseArguments(args);
+    if (!parsed.ok)
+        return writeUsageFailure(parsed.json, parsed.message);
+    const { command, file, json } = parsed.value;
+    let document;
+    try {
+        document = parseCanonicalArchitectureDocument(await readFile(file, "utf8"));
+    }
+    catch (error) {
+        return writeFailure(command, json, { code: "invalid-canon", message: errorMessage(error) });
+    }
+    if (command === "validate") {
+        if (json) {
+            console.log(JSON.stringify({ ok: true, command: "architecture validate", file }));
+        }
+        else {
+            console.log(`valid Architecture Canon: ${file}`);
+        }
+        return 0;
+    }
+    try {
+        const documentation = projectArchitectureDocument(document);
+        const structurizr = projectArchitectureDocumentToStructurizr(document);
+        const result = await buildArchitectureSite({
+            outputRoot: path.resolve(parsed.value.outputRoot),
+            documentation,
+            structurizr,
+            launcher: { executable: parsed.value.structurizrCommand ?? DEFAULT_STRUCTURIZR_COMMAND },
+        });
+        if (!result.complete) {
+            return writeFailure(command, json, {
+                code: "export-failed",
+                message: result.export.diagnostic?.message ?? "Structurizr static export failed",
+            });
+        }
+        if (json) {
+            console.log(JSON.stringify({
+                ok: true,
+                command: "architecture render",
+                file,
+                outputRoot: result.outputRoot,
+                projectionLosses: result.losses.length,
+            }));
+        }
+        else {
+            console.log(`rendered architecture site: ${result.outputRoot}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const code = error instanceof ArchitectureSiteError ? error.code : "render-failed";
+        return writeFailure(command, json, { code, message: errorMessage(error) });
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/architecture/cli.js.map

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

package/dist/architecture/documentation/html.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentationModel } from "./model.js";
+/** Render the documentation projection as deterministic, safe static HTML. */
+export declare function renderDocumentationHtml(model: DocumentationModel): string;

package/dist/architecture/documentation/html.js

@@ -0,0 +1,143 @@
+const HTML_ESCAPE_PATTERN = /[&<>"']/g;
+const HTML_ESCAPES = {
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#39;",
+};
+const STYLE = `<style>
+:root { font-family: system-ui, sans-serif; color: #202124; background: #fff; }
+body { max-width: 72rem; margin: 0 auto; padding: 2rem; line-height: 1.5; }
+nav, main { margin-block: 2rem; }
+nav ul, nav ol { padding-inline-start: 1.5rem; }
+section { margin-block: 2rem; }
+article { border: 1px solid #d8dbe0; padding: 1rem; margin-block: 1rem; }
+dl { display: grid; gap: 0.5rem; }
+dl > div { display: grid; grid-template-columns: minmax(8rem, max-content) 1fr; gap: 1rem; }
+dt { font-weight: 600; }
+dd { margin: 0; overflow-wrap: anywhere; }
+.documentation-value, .documentation-array, .documentation-object { overflow-wrap: anywhere; }
+.documentation-anchors { display: flex; flex-wrap: wrap; gap: 0.75rem; }
+</style>`;
+function escapeHtml(value) {
+    return value.replace(HTML_ESCAPE_PATTERN, (character) => HTML_ESCAPES[character] ?? character);
+}
+function encodeIdPart(value) {
+    try {
+        return encodeURIComponent(value);
+    }
+    catch {
+        return Array.from(value, (character) => character.codePointAt(0)?.toString(16) ?? "0").join("-");
+    }
+}
+function htmlId(prefix, ...parts) {
+    return [prefix, ...parts.map(encodeIdPart)].join("-");
+}
+function canonAnchorId(canonId) {
+    return htmlId("canon", canonId);
+}
+function sectionId(section) {
+    return htmlId("section", section);
+}
+function groupId(section, group) {
+    return htmlId("group", section, group);
+}
+function renderPrimitive(value) {
+    return `<span class="documentation-value">${escapeHtml(String(value))}</span>`;
+}
+function renderValue(value) {
+    if (value === null || typeof value !== "object") {
+        return renderPrimitive(value);
+    }
+    if (Array.isArray(value)) {
+        return `<ol class="documentation-array">${value.map((item) => `<li>${renderValue(item)}</li>`).join("")}</ol>`;
+    }
+    const fields = Object.entries(value).sort(([left], [right]) => {
+        if (left < right)
+            return -1;
+        if (left > right)
+            return 1;
+        return 0;
+    });
+    if (fields.length === 0)
+        return `<span class="documentation-object">{}</span>`;
+    return `<dl class="documentation-object">${fields
+        .map(([key, fieldValue]) => `<div><dt>${escapeHtml(key)}</dt><dd>${renderValue(fieldValue)}</dd></div>`)
+        .join("")}</dl>`;
+}
+function renderNavigationItem(item) {
+    const groups = item.groupKeys
+        .map((group) => `<li><a href="#${escapeHtml(groupId(item.section, group))}">${escapeHtml(group)}</a></li>`)
+        .join("");
+    return `<li><a href="#${escapeHtml(sectionId(item.section))}">${escapeHtml(item.section)}</a><ul>${groups}</ul></li>`;
+}
+function renderNavigation(navigation) {
+    return `<nav aria-label="documentation"><ol>${navigation.map(renderNavigationItem).join("")}</ol></nav>`;
+}
+function renderCanonReference(anchor) {
+    const id = canonAnchorId(anchor.canonId);
+    return `<a href="#${escapeHtml(id)}">${escapeHtml(anchor.canonId)}</a>`;
+}
+function renderEntryAnchors(anchors, anchoredCanonIds) {
+    return anchors
+        .map((anchor) => {
+        const id = canonAnchorId(anchor.canonId);
+        const marker = anchoredCanonIds.has(anchor.canonId)
+            ? ""
+            : `<span id="${escapeHtml(id)}" aria-hidden="true"></span>`;
+        anchoredCanonIds.add(anchor.canonId);
+        return `${marker}${renderCanonReference(anchor)}`;
+    })
+        .join(" ");
+}
+function renderEntry(entry, anchoredCanonIds) {
+    const anchors = renderEntryAnchors(entry.anchors, anchoredCanonIds);
+    return `<article>
+<h4>${escapeHtml(entry.key)}</h4>
+<p class="documentation-anchors">${anchors}</p>
+<div class="documentation-data">${renderValue(entry.data)}</div>
+</article>`;
+}
+function renderGroup(section, group, anchoredCanonIds) {
+    return `<section id="${escapeHtml(groupId(section.key, group.key))}">
+<h3>${escapeHtml(group.key)}</h3>
+<ol>${group.entries.map((entry) => renderEntry(entry, anchoredCanonIds)).join("")}</ol>
+</section>`;
+}
+function renderSection(section, anchoredCanonIds) {
+    return `<section id="${escapeHtml(sectionId(section.key))}">
+<h2>${escapeHtml(section.key)}</h2>
+${section.groups.map((group) => renderGroup(section, group, anchoredCanonIds)).join("\n")}
+</section>`;
+}
+/** Render the documentation projection as deterministic, safe static HTML. */
+export function renderDocumentationHtml(model) {
+    const rootId = canonAnchorId(model.root.canonId);
+    const anchoredCanonIds = new Set([model.root.canonId]);
+    const metadata = `<dl>
+<div><dt>canonVersion</dt><dd>${renderPrimitive(model.canonVersion)}</dd></div>
+<div><dt>documentId</dt><dd>${renderPrimitive(model.documentId)}</dd></div>
+<div><dt>root</dt><dd>${renderCanonReference(model.root)}</dd></div>
+</dl>`;
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${escapeHtml(model.documentId)}</title>
+${STYLE}
+</head>
+<body>
+<header id="${escapeHtml(rootId)}">
+<h1>${escapeHtml(model.documentId)}</h1>
+${metadata}
+</header>
+${renderNavigation(model.navigation)}
+<main id="documentation">
+${model.sections.map((section) => renderSection(section, anchoredCanonIds)).join("\n")}
+</main>
+</body>
+</html>`;
+}
+//# sourceMappingURL=html.js.map

package/dist/architecture/documentation/html.js.map

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

package/dist/architecture/documentation/model.d.ts

@@ -0,0 +1,46 @@
+import type { ArchitectureDecision, ArchitectureReference, ArchitectureReferenceAttachment } from "../canon/decisions.js";
+import type { AuthorityFact, OwnershipFact } from "../canon/authority.js";
+import type { Boundary } from "../canon/boundaries.js";
+import type { ArchitectureConstraint } from "../canon/constraints.js";
+import type { DeploymentInstance, DeploymentMapping, DeploymentNode, InfrastructureReference, RuntimeEnvironment } from "../canon/deployment.js";
+import type { ElementRecord } from "../canon/elements.js";
+import type { Flow } from "../canon/flows.js";
+import type { InterfaceRecord, RelationshipRecord } from "../canon/relationships.js";
+import type { RepositoryMapping } from "../canon/repository-mappings.js";
+import type { ResponsibilityFact } from "../canon/responsibilities.js";
+import type { ViewSpec } from "../canon/views.js";
+import type { CanonVersion, DocumentId } from "../canon/identity.js";
+export declare const DOCUMENTATION_SECTION_ORDER: readonly ["structure", "responsibility", "authority", "constraints", "flows", "deployment", "mappings", "decisions", "references", "views"];
+export type DocumentationSectionKey = (typeof DOCUMENTATION_SECTION_ORDER)[number];
+/** A stable reference to an identity owned by the Architecture Canon. */
+export interface DocumentationAnchor {
+    readonly canonId: string;
+}
+/** Canon data retained by the renderer-neutral projection. */
+export type DocumentationData = ElementRecord | InterfaceRecord | RelationshipRecord | Boundary | ResponsibilityFact | AuthorityFact | OwnershipFact | ArchitectureConstraint | Flow | RuntimeEnvironment | DeploymentNode | DeploymentInstance | InfrastructureReference | DeploymentMapping | RepositoryMapping | ArchitectureDecision | ArchitectureReference | ArchitectureReferenceAttachment | ViewSpec;
+export interface DocumentationEntry<TData extends DocumentationData = DocumentationData> {
+    /** A deterministic projection key. It is not an additional architecture identity. */
+    readonly key: string;
+    readonly anchors: readonly DocumentationAnchor[];
+    readonly data: TData;
+}
+export interface DocumentationGroup {
+    /** A fixed Canon field/group name, not architecture prose. */
+    readonly key: string;
+    readonly entries: readonly DocumentationEntry[];
+}
+export interface DocumentationSection {
+    readonly key: DocumentationSectionKey;
+    readonly groups: readonly DocumentationGroup[];
+}
+export interface DocumentationNavigationItem {
+    readonly section: DocumentationSectionKey;
+    readonly groupKeys: readonly string[];
+}
+export interface DocumentationModel {
+    readonly canonVersion: CanonVersion;
+    readonly documentId: DocumentId;
+    readonly root: DocumentationAnchor;
+    readonly navigation: readonly DocumentationNavigationItem[];
+    readonly sections: readonly DocumentationSection[];
+}

package/dist/architecture/documentation/model.js

@@ -0,0 +1,13 @@
+export const DOCUMENTATION_SECTION_ORDER = [
+    "structure",
+    "responsibility",
+    "authority",
+    "constraints",
+    "flows",
+    "deployment",
+    "mappings",
+    "decisions",
+    "references",
+    "views",
+];
+//# sourceMappingURL=model.js.map

package/dist/architecture/documentation/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../../src/architecture/documentation/model.ts"],"names":[],"mappings":"AAuBA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,WAAW;IACX,gBAAgB;IAChB,WAAW;IACX,aAAa;IACb,OAAO;IACP,YAAY;IACZ,UAAU;IACV,WAAW;IACX,YAAY;IACZ,OAAO;CACC,CAAC"}

package/dist/architecture/documentation/project.d.ts

@@ -0,0 +1,4 @@
+import type { ArchitectureDocumentV1 } from "../canon/document.js";
+import type { DocumentationModel } from "./model.js";
+/** Project a validated Architecture Canon into renderer-neutral documentation data. */
+export declare function projectArchitectureDocument(document: ArchitectureDocumentV1): DocumentationModel;