wabachi 0.1.0

package/dist/architecture/documentation/project.js

@@ -0,0 +1,166 @@
+import { validateArchitectureDocument } from "../canon/validate.js";
+const SECTION_GROUP_KEYS = {
+    structure: ["elements", "interfaces", "relationships", "boundaries"],
+    responsibility: ["responsibilities"],
+    authority: ["authority", "ownership"],
+    constraints: ["constraints"],
+    flows: ["flows"],
+    deployment: ["runtimeEnvironments", "deploymentNodes", "deploymentInstances", "infrastructureReferences", "mappings"],
+    mappings: ["repositoryMappings"],
+    decisions: ["decisions"],
+    references: ["references", "attachments"],
+    views: ["views"],
+};
+function freezeArray(values) {
+    return Object.freeze([...values]);
+}
+function createAnchor(canonId) {
+    return Object.freeze({ canonId });
+}
+function createAnchors(ids) {
+    const seen = new Set();
+    const anchors = [];
+    for (const id of ids) {
+        if (id === undefined || seen.has(id))
+            continue;
+        seen.add(id);
+        anchors.push(createAnchor(id));
+    }
+    return freezeArray(anchors);
+}
+function createEntry(key, data, anchorIds) {
+    return Object.freeze({ key, anchors: createAnchors(anchorIds), data });
+}
+function compareEntries(left, right) {
+    if (left.key < right.key)
+        return -1;
+    if (left.key > right.key)
+        return 1;
+    return 0;
+}
+function createGroup(key, entries) {
+    return Object.freeze({ key, entries: freezeArray([...entries].sort(compareEntries)) });
+}
+function createSection(key, groups) {
+    return Object.freeze({ key, groups: freezeArray(groups) });
+}
+function tupleKey(...parts) {
+    return JSON.stringify(parts);
+}
+function relationshipEntry(relationship) {
+    return createEntry(tupleKey(relationship.source, relationship.target, relationship.kind, relationship.interfaceId), relationship, [relationship.source, relationship.target, relationship.interfaceId]);
+}
+function authorityEntry(fact) {
+    return createEntry(tupleKey(fact.kind, fact.concern, fact.owner), fact, [fact.concern, fact.owner]);
+}
+function ownershipEntry(fact) {
+    return createEntry(tupleKey(fact.kind, fact.resource, fact.owner), fact, [fact.resource, fact.owner]);
+}
+function constraintEntry(constraint) {
+    switch (constraint.kind) {
+        case "single-authority":
+            return createEntry(tupleKey(constraint.kind, constraint.concern), constraint, [constraint.concern]);
+        case "must-go-through":
+            return createEntry(tupleKey(constraint.kind, constraint.source, constraint.target, constraint.through), constraint, [constraint.source, constraint.target, constraint.through]);
+        default:
+            return createEntry(tupleKey(constraint.kind, constraint.source, constraint.target), constraint, [
+                constraint.source,
+                constraint.target,
+            ]);
+    }
+}
+function deploymentMappingEntry(mapping) {
+    return createEntry(tupleKey(mapping.softwareElementId, mapping.deploymentInstanceId), mapping, [
+        mapping.softwareElementId,
+        mapping.deploymentInstanceId,
+    ]);
+}
+function referenceAttachmentEntry(attachment) {
+    return createEntry(tupleKey(attachment.targetId, ...attachment.referenceIds), attachment, [
+        attachment.targetId,
+        ...attachment.referenceIds,
+    ]);
+}
+function viewEntry(view) {
+    const references = [...view.scope.include, ...view.scope.exclude];
+    return createEntry(view.key, view, references.map((reference) => reference.id));
+}
+function createSections(document) {
+    const structure = createSection("structure", [
+        createGroup("elements", document.elements.map((element) => createEntry(element.id, element, [element.id, element.parentId]))),
+        createGroup("interfaces", document.interfaces.map((contract) => createEntry(contract.id, contract, [contract.id, contract.owner]))),
+        createGroup("relationships", document.relationships.map(relationshipEntry)),
+        createGroup("boundaries", document.boundaries.map((boundary) => createEntry(boundary.id, boundary, [boundary.id, ...boundary.memberIds]))),
+    ]);
+    const responsibility = createSection("responsibility", [
+        createGroup("responsibilities", document.responsibilities.responsibilities.map((fact) => createEntry(fact.id, fact, [fact.id, fact.target.id]))),
+    ]);
+    const authority = createSection("authority", [
+        createGroup("authority", document.authority.authority.map(authorityEntry)),
+        createGroup("ownership", document.authority.ownership.map(ownershipEntry)),
+    ]);
+    const constraints = createSection("constraints", [
+        createGroup("constraints", document.constraints.map(constraintEntry)),
+    ]);
+    const flows = createSection("flows", [
+        createGroup("flows", document.flows.map((flow) => createEntry(flow.id, flow, [flow.id, ...flow.steps.flatMap((step) => [step.relationshipId, step.interfaceId])]))),
+    ]);
+    const deployment = createSection("deployment", [
+        createGroup("runtimeEnvironments", document.deployment.runtimeEnvironments.map((environment) => createEntry(environment.id, environment, [environment.id]))),
+        createGroup("deploymentNodes", document.deployment.deploymentNodes.map((node) => createEntry(node.id, node, [node.id, node.environmentId]))),
+        createGroup("deploymentInstances", document.deployment.deploymentInstances.map((instance) => createEntry(instance.id, instance, [instance.id, instance.nodeId]))),
+        createGroup("infrastructureReferences", document.deployment.infrastructureReferences.map((reference) => createEntry(reference.id, reference, [reference.id]))),
+        createGroup("mappings", document.deployment.mappings.map(deploymentMappingEntry)),
+    ]);
+    const mappings = createSection("mappings", [
+        createGroup("repositoryMappings", document.repositoryMappings.map((mapping) => createEntry(mapping.canonId, mapping, [mapping.canonId]))),
+    ]);
+    const decisions = createSection("decisions", [
+        createGroup("decisions", document.decisions.decisions.map((decision) => createEntry(decision.id, decision, [
+            decision.id,
+            ...decision.targetIds,
+            ...decision.referenceIds,
+            ...decision.supersedes,
+        ]))),
+    ]);
+    const references = createSection("references", [
+        createGroup("references", document.decisions.references.map((reference) => createEntry(reference.id, reference, [reference.id]))),
+        createGroup("attachments", document.decisions.referenceAttachments.map(referenceAttachmentEntry)),
+    ]);
+    const views = createSection("views", [createGroup("views", document.views.map(viewEntry))]);
+    return freezeArray([
+        structure,
+        responsibility,
+        authority,
+        constraints,
+        flows,
+        deployment,
+        mappings,
+        decisions,
+        references,
+        views,
+    ]);
+}
+function createNavigation(sections) {
+    return freezeArray(sections.map((section) => Object.freeze({
+        section: section.key,
+        groupKeys: freezeArray([...SECTION_GROUP_KEYS[section.key]]),
+    })));
+}
+/** Project a validated Architecture Canon into renderer-neutral documentation data. */
+export function projectArchitectureDocument(document) {
+    const validation = validateArchitectureDocument(document);
+    if (!validation.valid) {
+        const diagnostics = validation.diagnostics.map(({ code, path }) => `${code} at ${path}`).join(", ");
+        throw new Error(`cannot project invalid Architecture Canon: ${diagnostics}`);
+    }
+    const sections = createSections(document);
+    return Object.freeze({
+        canonVersion: document.canonVersion,
+        documentId: document.documentId,
+        root: createAnchor(document.root.id),
+        navigation: createNavigation(sections),
+        sections,
+    });
+}
+//# sourceMappingURL=project.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { DocumentationModel } from "./model.js";
+import { type StructurizrLauncher, type StructurizrStaticExportRequest, type StructurizrStaticExportResult } from "../projection/structurizr-export.js";
+import type { ProjectionLoss, StructurizrProjection } from "../projection/structurizr.js";
+export declare const ARCHITECTURE_SITE_LAYOUT: Readonly<{
+    indexHtml: "index.html";
+    workspaceDsl: "workspace.dsl";
+    projectionLosses: "projection-losses.json";
+    diagramsDirectory: "diagrams";
+}>;
+export type StructurizrStaticExportAdapter = (request: StructurizrStaticExportRequest) => Promise<StructurizrStaticExportResult>;
+export interface ArchitectureSiteRequest {
+    /** An absolute, caller-owned directory for all site artifacts. */
+    readonly outputRoot: string;
+    readonly documentation: DocumentationModel;
+    readonly structurizr: StructurizrProjection;
+    readonly launcher: StructurizrLauncher;
+    readonly exportAdapter?: StructurizrStaticExportAdapter;
+}
+export interface ArchitectureSiteArtifacts {
+    readonly root: string;
+    readonly indexHtml: string;
+    readonly workspaceDsl: string;
+    readonly projectionLosses: string;
+    readonly diagramsDirectory: string;
+}
+export interface ArchitectureSiteResult {
+    readonly status: "ok" | "export-failed";
+    readonly complete: boolean;
+    readonly outputRoot: string;
+    readonly canonVersion: DocumentationModel["canonVersion"];
+    readonly documentId: DocumentationModel["documentId"];
+    readonly losses: readonly ProjectionLoss[];
+    readonly artifacts: ArchitectureSiteArtifacts;
+    readonly export: StructurizrStaticExportResult;
+}
+export type ArchitectureSiteErrorCode = "invalid-input" | "generation-mismatch" | "unsafe-path" | "unsafe-overwrite";
+export declare class ArchitectureSiteError extends Error {
+    readonly code: ArchitectureSiteErrorCode;
+    constructor(code: ArchitectureSiteErrorCode, message: string);
+}
+/** Assemble the independent documentation and Structurizr projections at one filesystem edge. */
+export declare function buildArchitectureSite(request: ArchitectureSiteRequest): Promise<ArchitectureSiteResult>;
+export declare const assembleArchitectureSite: typeof buildArchitectureSite;

package/dist/architecture/documentation/site.js

@@ -0,0 +1,147 @@
+import { lstat, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { renderDocumentationHtml } from "./html.js";
+import { runStructurizrStaticExport, } from "../projection/structurizr-export.js";
+export const ARCHITECTURE_SITE_LAYOUT = Object.freeze({
+    indexHtml: "index.html",
+    workspaceDsl: "workspace.dsl",
+    projectionLosses: "projection-losses.json",
+    diagramsDirectory: "diagrams",
+});
+export class ArchitectureSiteError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "ArchitectureSiteError";
+        this.code = code;
+    }
+}
+async function entryKind(entryPath) {
+    try {
+        const stats = await lstat(entryPath);
+        if (stats.isSymbolicLink())
+            return "symlink";
+        if (stats.isDirectory())
+            return "directory";
+        if (stats.isFile())
+            return "file";
+        return "other";
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            return "missing";
+        throw error;
+    }
+}
+function assertInsideRoot(root, relativePath) {
+    const candidate = path.resolve(root, relativePath);
+    const prefix = root.endsWith(path.sep) ? root : `${root}${path.sep}`;
+    if (!candidate.startsWith(prefix)) {
+        throw new ArchitectureSiteError("unsafe-path", `site artifact path escapes output root: ${relativePath}`);
+    }
+    return candidate;
+}
+function artifactPaths(outputRoot) {
+    return Object.freeze({
+        root: outputRoot,
+        indexHtml: assertInsideRoot(outputRoot, ARCHITECTURE_SITE_LAYOUT.indexHtml),
+        workspaceDsl: assertInsideRoot(outputRoot, ARCHITECTURE_SITE_LAYOUT.workspaceDsl),
+        projectionLosses: assertInsideRoot(outputRoot, ARCHITECTURE_SITE_LAYOUT.projectionLosses),
+        diagramsDirectory: assertInsideRoot(outputRoot, ARCHITECTURE_SITE_LAYOUT.diagramsDirectory),
+    });
+}
+async function prepareOutput(artifacts) {
+    const rootKind = await entryKind(artifacts.root);
+    if (rootKind === "symlink") {
+        throw new ArchitectureSiteError("unsafe-path", "site output root must not be a symbolic link");
+    }
+    if (rootKind === "file" || rootKind === "other") {
+        throw new ArchitectureSiteError("invalid-input", "site output root must be a directory");
+    }
+    if (rootKind === "missing")
+        await mkdir(artifacts.root, { recursive: true });
+    const verifiedRootKind = await entryKind(artifacts.root);
+    if (verifiedRootKind !== "directory") {
+        throw new ArchitectureSiteError("unsafe-path", "site output root is not a stable directory");
+    }
+    for (const target of [artifacts.indexHtml, artifacts.workspaceDsl, artifacts.projectionLosses]) {
+        const kind = await entryKind(target);
+        if (kind !== "missing") {
+            throw new ArchitectureSiteError("unsafe-overwrite", `refusing to overwrite existing site artifact: ${target}`);
+        }
+    }
+    const diagramsKind = await entryKind(artifacts.diagramsDirectory);
+    if (diagramsKind !== "missing") {
+        throw new ArchitectureSiteError("unsafe-overwrite", `refusing to reuse existing diagrams directory: ${artifacts.diagramsDirectory}`);
+    }
+    await mkdir(artifacts.diagramsDirectory);
+}
+function assertCompatibleGeneration(documentation, structurizr) {
+    if (documentation.canonVersion !== structurizr.canonVersion || documentation.documentId !== structurizr.documentId) {
+        throw new ArchitectureSiteError("generation-mismatch", "documentation and Structurizr projections must originate from the same Canon generation");
+    }
+}
+function siteNavigation(lossCount) {
+    return `<aside id="architecture-site-navigation">
+<h2>Wabachi architecture site</h2>
+<nav aria-label="architecture-site"><ul>
+<li><a href="index.html">Documentation</a></li>
+<li><a href="diagrams/index.html">Structurizr diagrams</a></li>
+<li><a href="projection-losses.json">Projection losses (${String(lossCount)})</a></li>
+</ul></nav>
+</aside>`;
+}
+function composeIndex(documentation, losses) {
+    const rendered = renderDocumentationHtml(documentation);
+    const closingBody = "</body>";
+    const insertionPoint = rendered.lastIndexOf(closingBody);
+    if (insertionPoint < 0) {
+        throw new ArchitectureSiteError("invalid-input", "documentation renderer did not return a complete HTML document");
+    }
+    return `${rendered.slice(0, insertionPoint)}${siteNavigation(losses.length)}\n${rendered.slice(insertionPoint)}`;
+}
+function projectionLossReport(projection) {
+    return `${JSON.stringify({
+        canonVersion: projection.canonVersion,
+        documentId: projection.documentId,
+        losses: projection.losses,
+    }, null, 2)}\n`;
+}
+/** Assemble the independent documentation and Structurizr projections at one filesystem edge. */
+export async function buildArchitectureSite(request) {
+    if (!path.isAbsolute(request.outputRoot) || request.outputRoot.length === 0) {
+        throw new ArchitectureSiteError("invalid-input", "site output root must be a non-empty absolute path");
+    }
+    assertCompatibleGeneration(request.documentation, request.structurizr);
+    const outputRoot = path.resolve(request.outputRoot);
+    const artifacts = artifactPaths(outputRoot);
+    await prepareOutput(artifacts);
+    await writeFile(artifacts.indexHtml, composeIndex(request.documentation, request.structurizr.losses), {
+        encoding: "utf8",
+        flag: "wx",
+    });
+    await writeFile(artifacts.workspaceDsl, request.structurizr.dsl, { encoding: "utf8", flag: "wx" });
+    await writeFile(artifacts.projectionLosses, projectionLossReport(request.structurizr), {
+        encoding: "utf8",
+        flag: "wx",
+    });
+    const exportRequest = {
+        launcher: request.launcher,
+        workspacePath: artifacts.workspaceDsl,
+        outputDirectory: artifacts.diagramsDirectory,
+    };
+    const exportResult = await (request.exportAdapter ?? runStructurizrStaticExport)(exportRequest);
+    const complete = exportResult.status === "ok";
+    return Object.freeze({
+        status: complete ? "ok" : "export-failed",
+        complete,
+        outputRoot,
+        canonVersion: request.documentation.canonVersion,
+        documentId: request.documentation.documentId,
+        losses: request.structurizr.losses,
+        artifacts,
+        export: exportResult,
+    });
+}
+export const assembleArchitectureSite = buildArchitectureSite;
+//# sourceMappingURL=site.js.map

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

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

package/dist/architecture/projection/structurizr-export.d.ts

@@ -0,0 +1,65 @@
+export interface StructurizrLauncher {
+    /** Executable used to start the Structurizr vNext CLI or launcher. */
+    readonly executable: string;
+    /** Arguments needed by a launcher before Structurizr's own arguments. */
+    readonly args?: readonly string[];
+}
+export interface StructurizrStaticExportRequest {
+    readonly launcher: StructurizrLauncher;
+    /** Path to the already-generated Structurizr DSL or JSON workspace. */
+    readonly workspacePath: string;
+    /** Explicit caller-owned directory in which Structurizr writes the static site. */
+    readonly outputDirectory: string;
+}
+export interface StructurizrToolIdentity {
+    readonly id: "structurizr";
+    readonly executable: string;
+    readonly launcherArgs: readonly string[];
+    readonly version: string | null;
+}
+export interface StructurizrProcessInvocation {
+    readonly executable: string;
+    readonly args: readonly string[];
+    readonly shell: false;
+}
+export interface StructurizrProcessOutput {
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export type StructurizrExportFailureCode = "invalid-input" | "unavailable" | "spawn-failed" | "non-zero-exit" | "version-output-missing";
+export interface StructurizrExportDiagnostic {
+    readonly code: StructurizrExportFailureCode;
+    readonly phase: "version" | "export" | "input";
+    readonly message: string;
+}
+interface StructurizrExportResultBase {
+    readonly tool: StructurizrToolIdentity;
+    readonly workspacePath: string;
+    readonly outputDirectory: string;
+    readonly invocations: {
+        readonly version: StructurizrProcessInvocation;
+        readonly export: StructurizrProcessInvocation;
+    };
+    readonly versionOutput: StructurizrProcessOutput;
+    readonly output: StructurizrProcessOutput;
+}
+export interface StructurizrExportSuccess extends StructurizrExportResultBase {
+    readonly status: "ok";
+    readonly exitCode: 0;
+    readonly signal: null;
+    readonly diagnostic: null;
+}
+export interface StructurizrExportFailure extends StructurizrExportResultBase {
+    readonly status: "invalid-input" | "unavailable" | "spawn-failed" | "failed";
+    readonly exitCode: number | null;
+    readonly signal: NodeJS.Signals | null;
+    readonly diagnostic: StructurizrExportDiagnostic;
+}
+export type StructurizrStaticExportResult = StructurizrExportSuccess | StructurizrExportFailure;
+/**
+ * Run the current Structurizr static export surface against an existing
+ * generated workspace. The adapter never creates or rewrites that workspace.
+ */
+export declare function runStructurizrStaticExport(request: StructurizrStaticExportRequest): Promise<StructurizrStaticExportResult>;
+export declare const executeStructurizrStaticExport: typeof runStructurizrStaticExport;
+export {};

package/dist/architecture/projection/structurizr-export.js

@@ -0,0 +1,136 @@
+import { spawn } from "node:child_process";
+const EMPTY_OUTPUT = Object.freeze({ stdout: "", stderr: "" });
+function processError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+function isMissingExecutable(error) {
+    return "code" in error && error.code === "ENOENT";
+}
+function runArgv(executable, args) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(executable, [...args], {
+                shell: false,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+        }
+        catch (error) {
+            resolve({ kind: "spawn-failed", error: processError(error), output: EMPTY_OUTPUT });
+            return;
+        }
+        let stdout = "";
+        let stderr = "";
+        let settled = false;
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        child.once("error", (error) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve({ kind: "spawn-failed", error, output: { stdout, stderr } });
+        });
+        child.once("close", (exitCode, signal) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve({ kind: "exit", exitCode, signal, output: { stdout, stderr } });
+        });
+    });
+}
+function invocation(executable, args) {
+    return Object.freeze({ executable, args: Object.freeze([...args]), shell: false });
+}
+function baseResult(request, launcherArgs, versionInvocation, exportInvocation, version, versionOutput, output) {
+    return {
+        tool: {
+            id: "structurizr",
+            executable: request.launcher.executable,
+            launcherArgs: Object.freeze([...launcherArgs]),
+            version,
+        },
+        workspacePath: request.workspacePath,
+        outputDirectory: request.outputDirectory,
+        invocations: { version: versionInvocation, export: exportInvocation },
+        versionOutput,
+        output,
+    };
+}
+function invalidInputResult(request, launcherArgs, versionInvocation, exportInvocation, message) {
+    return {
+        ...baseResult(request, launcherArgs, versionInvocation, exportInvocation, null, EMPTY_OUTPUT, EMPTY_OUTPUT),
+        status: "invalid-input",
+        exitCode: null,
+        signal: null,
+        diagnostic: { code: "invalid-input", phase: "input", message },
+    };
+}
+function failureResult(base, status, phase, code, message, exitCode, signal) {
+    return { ...base, status, exitCode, signal, diagnostic: { code, phase, message } };
+}
+function versionFromOutput(output) {
+    const version = output
+        .split(/\r?\n/u)
+        .map((line) => line.trim())
+        .find((line) => line.length > 0);
+    return version ?? null;
+}
+/**
+ * Run the current Structurizr static export surface against an existing
+ * generated workspace. The adapter never creates or rewrites that workspace.
+ */
+export async function runStructurizrStaticExport(request) {
+    const launcherArgs = request.launcher.args === undefined ? [] : [...request.launcher.args];
+    const versionArgs = [...launcherArgs, "--version"];
+    const exportArgs = [
+        ...launcherArgs,
+        "export",
+        "-format",
+        "static",
+        "-workspace",
+        request.workspacePath,
+        "-output",
+        request.outputDirectory,
+    ];
+    const versionInvocation = invocation(request.launcher.executable, versionArgs);
+    const exportInvocation = invocation(request.launcher.executable, exportArgs);
+    if (request.launcher.executable.length === 0 ||
+        launcherArgs.some((argument) => typeof argument !== "string") ||
+        request.workspacePath.length === 0 ||
+        request.outputDirectory.length === 0) {
+        return invalidInputResult(request, launcherArgs, versionInvocation, exportInvocation, "Structurizr executable, launcher arguments, workspace path, and output directory must be non-empty strings");
+    }
+    const versionResult = await runArgv(request.launcher.executable, versionArgs);
+    if (versionResult.kind === "spawn-failed") {
+        const base = baseResult(request, launcherArgs, versionInvocation, exportInvocation, null, versionResult.output, EMPTY_OUTPUT);
+        const missing = isMissingExecutable(versionResult.error);
+        return failureResult(base, missing ? "unavailable" : "spawn-failed", "version", missing ? "unavailable" : "spawn-failed", `Structurizr version process could not be started: ${versionResult.error.message}`, null, null);
+    }
+    const version = versionFromOutput(versionResult.output.stdout);
+    const versionBase = baseResult(request, launcherArgs, versionInvocation, exportInvocation, version, versionResult.output, EMPTY_OUTPUT);
+    if (versionResult.exitCode !== 0) {
+        return failureResult(versionBase, "failed", "version", "non-zero-exit", `Structurizr version process exited with code ${String(versionResult.exitCode)}`, versionResult.exitCode, versionResult.signal);
+    }
+    if (version === null) {
+        return failureResult(versionBase, "failed", "version", "version-output-missing", "Structurizr version process exited successfully without version output", versionResult.exitCode, versionResult.signal);
+    }
+    const exportResult = await runArgv(request.launcher.executable, exportArgs);
+    if (exportResult.kind === "spawn-failed") {
+        const base = baseResult(request, launcherArgs, versionInvocation, exportInvocation, version, versionResult.output, exportResult.output);
+        const missing = isMissingExecutable(exportResult.error);
+        return failureResult(base, missing ? "unavailable" : "spawn-failed", "export", missing ? "unavailable" : "spawn-failed", `Structurizr export process could not be started: ${exportResult.error.message}`, null, null);
+    }
+    const base = baseResult(request, launcherArgs, versionInvocation, exportInvocation, version, versionResult.output, exportResult.output);
+    if (exportResult.exitCode !== 0) {
+        return failureResult(base, "failed", "export", "non-zero-exit", `Structurizr export process exited with code ${String(exportResult.exitCode)}`, exportResult.exitCode, exportResult.signal);
+    }
+    return { ...base, status: "ok", exitCode: 0, signal: null, diagnostic: null };
+}
+export const executeStructurizrStaticExport = runStructurizrStaticExport;
+//# sourceMappingURL=structurizr-export.js.map

package/dist/architecture/projection/structurizr-export.js.map

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

package/dist/architecture/projection/structurizr.d.ts

@@ -0,0 +1,34 @@
+import type { ArchitectureDocumentV1 } from "../canon/document.js";
+import type { ViewSpec } from "../canon/views.js";
+export declare const PROJECTION_LOSS_CODES: readonly ["unsupported-authority", "unsupported-ownership", "unsupported-boundary", "unsupported-responsibility", "unsupported-constraint", "unsupported-repository-mapping", "unsupported-decision", "unsupported-reference", "unsupported-reference-attachment", "unsupported-interface", "unsupported-containment", "unsupported-flow", "unsupported-deployment-instance", "unsupported-deployment-mapping", "unsupported-infrastructure-reference", "unsupported-view-reference", "unsupported-view-exclusion", "unsupported-view-scope", "unsupported-presentation", "ambiguous-flow-step"];
+export type ProjectionLossCode = (typeof PROJECTION_LOSS_CODES)[number];
+/** A machine-readable explanation of a Canon fact not represented losslessly by Structurizr. */
+export interface ProjectionLoss {
+    readonly code: ProjectionLossCode;
+    readonly path: string;
+    readonly canonIds: readonly string[];
+    readonly message: string;
+}
+export type StructurizrIdentityNamespace = "architecture" | "element" | "interface" | "responsibility" | "boundary" | "flow" | "decision" | "reference" | "runtime-environment" | "deployment-node" | "deployment-instance" | "infrastructure-reference";
+export interface StructurizrIdentityMapping {
+    readonly canonId: string;
+    readonly namespace: StructurizrIdentityNamespace;
+    /** The deterministic identifier or metadata token used by the projection. */
+    readonly structurizrId: string;
+}
+export interface StructurizrViewMapping {
+    readonly canonKey: string;
+    readonly kind: ViewSpec["kind"];
+    readonly structurizrKey: string;
+}
+export interface StructurizrProjection {
+    readonly canonVersion: ArchitectureDocumentV1["canonVersion"];
+    readonly documentId: ArchitectureDocumentV1["documentId"];
+    readonly dsl: string;
+    readonly identityMappings: readonly StructurizrIdentityMapping[];
+    readonly viewMappings: readonly StructurizrViewMapping[];
+    readonly losses: readonly ProjectionLoss[];
+}
+/** Project a validated Architecture Canon into current Structurizr DSL plus explicit losses. */
+export declare function projectArchitectureDocumentToStructurizr(document: ArchitectureDocumentV1): StructurizrProjection;
+export declare const projectArchitectureToStructurizr: typeof projectArchitectureDocumentToStructurizr;