@alistigo/calm-to-archify 0.0.0-stage → 0.2.0

package/LICENSE

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

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+# @alistigo/calm-to-archify
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm version](https://img.shields.io/npm/v/@alistigo/calm-to-archify.svg?style=flat)](https://www.npmjs.com/package/@alistigo/calm-to-archify)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue?logo=typescript)](https://www.typescriptlang.org/)
+[![CI](https://github.com/alistigo/holos/actions/workflows/ci.yml/badge.svg)](https://github.com/alistigo/holos/actions/workflows/ci.yml)
+
+CLI that converts [FINOS CALM](https://calm.finos.org/) architecture instances (`.arch.json`) into interactive HTML diagrams via [archify](https://github.com/tt-a1i/archify).
+
+## Install
+
+```sh
+npm install -g @alistigo/calm-to-archify
+# or
+yarn global add @alistigo/calm-to-archify
+# or
+pnpm add -g @alistigo/calm-to-archify
+```
+
+As a dev dependency:
+
+```sh
+npm install -D @alistigo/calm-to-archify
+```
+
+Requires Node.js ≥ 18.
+
+## Commands
+
+### `build` (default)
+
+Full pipeline: CALM JSON → archify JSON-IR → standalone HTML.
+
+```sh
+calm-to-archify systems/*.arch.json
+calm-to-archify build systems/*.arch.json
+```
+
+Shell glob expansion passes all matched files as positional arguments. Each file produces two outputs next to the source: `<unique-id>.archify.json` and `<unique-id>.archify.html`.
+
+**Options**
+
+| Flag | Description |
+|------|-------------|
+| `--output-dir,-o <dir>` | Write outputs to `<dir>` instead of each file's own directory |
+
+```sh
+calm-to-archify systems/*.arch.json --output-dir .archify-out
+```
+
+### `transform`
+
+CALM JSON → archify JSON-IR only (no HTML rendering).
+
+```sh
+calm-to-archify transform path/to/my.arch.json --output path/to/output.archify.json
+```
+
+**Options**
+
+| Flag | Description |
+|------|-------------|
+| `--output,-o <path>` | Output path for the archify JSON file (required) |
+
+## Input format
+
+Accepts CALM architecture instances — files that contain `nodes` and `relationships` at the top level. Pattern files (`.pattern.json`) are JSON Schema documents and are not supported.
+
+## About CALM
+
+[CALM (Common Architecture Language Model)](https://calm.finos.org/) is an open standard from [FINOS](https://www.finos.org/) for describing software architectures as machine-readable JSON. It lets you capture nodes (services, datastores, people) and the relationships between them in a way that can be validated, queried, and visualised automatically.
+
+## About archify
+
+[archify](https://github.com/tt-a1i/archify) is an open-source tool that turns a structured JSON description of a system into a fully interactive standalone HTML diagram — no server required, no external dependencies at runtime. `calm-to-archify` uses archify under the hood to produce the HTML output.
+
+## Thanks
+
+A big thank you to the [FINOS CALM team](https://github.com/finos/architecture-as-code) for building and maintaining an open, vendor-neutral standard for architecture-as-code — making tooling like this possible.
+
+And to the [archify team](https://github.com/tt-a1i/archify) for creating a lightweight, dependency-free renderer that turns plain JSON into beautiful interactive diagrams — great work.

package/dist/cli/commands/build.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "clipanion";
+export declare class BuildCommand extends Command {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    inputFiles: string[];
+    outputDir: string | undefined;
+    execute(): Promise<number>;
+    private run;
+}
+//# sourceMappingURL=build.d.ts.map

package/dist/cli/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAS5C,qBAAa,YAAa,SAAQ,OAAO;IACvC,OAAgB,KAAK,aAAgC;IAErD,OAAgB,KAAK,4BAoBlB;IAEH,UAAU,WAA+C;IAEzD,SAAS,qBAGN;IAEH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAK1B,OAAO,CAAC,GAAG;CA0DZ"}

package/dist/cli/commands/build.js

@@ -0,0 +1,95 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { Command, Option } from "clipanion";
+import { transformCalmToArchify } from "../lib/calm-to-archify.js";
+function resolveArchifyRenderBin() {
+    const req = createRequire(import.meta.url);
+    const pkgJson = req.resolve("@alistigo/archify-render/package.json");
+    return path.join(path.dirname(pkgJson), "dist/cli.js");
+}
+export class BuildCommand extends Command {
+    static paths = [Command.Default, ["build"]];
+    static usage = Command.Usage({
+        description: "Run the full CALM → archify HTML pipeline for one or more .arch.json files",
+        details: `
+      Reads each CALM .arch.json file, transforms it to archify JSON-IR, then
+      renders a standalone interactive HTML file using the archify renderer.
+
+      By default each output is written next to its source file.
+      Use --output-dir to redirect all outputs to a specific directory.
+
+      Pattern files (.pattern.json) are JSON Schema documents and are not
+      supported — only CALM architecture instances (.arch.json) are accepted.
+    `,
+        examples: [
+            ["Process all architecture files", "calm-to-archify build systems/*.arch.json"],
+            ["Process a single file", "calm-to-archify build path/to/my.arch.json"],
+            [
+                "Output to a specific directory",
+                "calm-to-archify build systems/*.arch.json --output-dir .archify-out",
+            ],
+        ],
+    });
+    inputFiles = Option.Rest({ required: 1, name: "files" });
+    outputDir = Option.String("--output-dir,-o", {
+        description: "Output directory (default: same directory as each input file)",
+        required: false,
+    });
+    execute() {
+        return Promise.resolve(this.run());
+    }
+    // fallow-ignore-next-line complexity
+    run() {
+        let archifyRenderBin;
+        try {
+            archifyRenderBin = resolveArchifyRenderBin();
+        }
+        catch (err) {
+            this.context.stderr.write(`Error: could not resolve archify-render binary. Make sure @alistigo/archify-render is installed and built: ${String(err)}\n`);
+            return 1;
+        }
+        for (const file of this.inputFiles) {
+            const inputPath = path.resolve(process.cwd(), file);
+            if (!existsSync(inputPath)) {
+                this.context.stderr.write(`Error: file not found: ${inputPath}\n`);
+                return 1;
+            }
+            const outDir = this.outputDir
+                ? path.resolve(process.cwd(), this.outputDir)
+                : path.dirname(inputPath);
+            let calm;
+            try {
+                calm = JSON.parse(readFileSync(inputPath, "utf-8"));
+            }
+            catch (err) {
+                this.context.stderr.write(`Error: failed to parse ${inputPath}: ${String(err)}\n`);
+                return 1;
+            }
+            if (!calm.nodes || !calm.relationships) {
+                this.context.stderr.write(`Error: ${inputPath} does not look like a CALM architecture instance — ` +
+                    "it's missing 'nodes' or 'relationships'. Pattern files (.pattern.json) are not supported.\n");
+                return 1;
+            }
+            const archifyJson = path.join(outDir, `${calm["unique-id"]}.archify.json`);
+            const htmlOutputPath = path.relative(process.cwd(), archifyJson.replace(/\.json$/, ".html"));
+            const archify = transformCalmToArchify(calm, htmlOutputPath);
+            mkdirSync(outDir, { recursive: true });
+            writeFileSync(archifyJson, JSON.stringify(archify, null, 2), "utf-8");
+            this.context.stdout.write(`Transformed → ${archifyJson}\n`);
+            const r = spawnSync("node", [archifyRenderBin, archifyJson], {
+                stdio: "inherit",
+                cwd: process.cwd(),
+            });
+            if (r.error) {
+                this.context.stderr.write(`Error running archify-render: ${r.error.message}\n`);
+                return 1;
+            }
+            if ((r.status ?? 1) !== 0)
+                return r.status ?? 1;
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=build.js.map

package/dist/cli/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAqB,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEtF,SAAS,uBAAuB;IAC9B,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,OAAO,YAAa,SAAQ,OAAO;IACvC,MAAM,CAAU,KAAK,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAErD,MAAM,CAAU,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QACpC,WAAW,EAAE,4EAA4E;QACzF,OAAO,EAAE;;;;;;;;;KASR;QACD,QAAQ,EAAE;YACR,CAAC,gCAAgC,EAAE,2CAA2C,CAAC;YAC/E,CAAC,uBAAuB,EAAE,4CAA4C,CAAC;YACvE;gBACE,gCAAgC;gBAChC,qEAAqE;aACtE;SACF;KACF,CAAC,CAAC;IAEH,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IAEzD,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE;QAC3C,WAAW,EAAE,+DAA+D;QAC5E,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,qCAAqC;IAC7B,GAAG;QACT,IAAI,gBAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,gBAAgB,GAAG,uBAAuB,EAAE,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CACvB,8GAA8G,MAAM,CAAC,GAAG,CAAC,IAAI,CAC9H,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,SAAS,IAAI,CAAC,CAAC;gBACnE,OAAO,CAAC,CAAC;YACX,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS;gBAC3B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC;gBAC7C,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAE5B,IAAI,IAAkB,CAAC;YACvB,IAAI,CAAC;gBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAiB,CAAC;YACtE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,SAAS,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACnF,OAAO,CAAC,CAAC;YACX,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CACvB,UAAU,SAAS,qDAAqD;oBACtE,6FAA6F,CAChG,CAAC;gBACF,OAAO,CAAC,CAAC;YACX,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAC3E,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;YAE7F,MAAM,OAAO,GAAG,sBAAsB,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAC7D,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACtE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,WAAW,IAAI,CAAC,CAAC;YAE5D,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,WAAW,CAAC,EAAE;gBAC3D,KAAK,EAAE,SAAS;gBAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;aACnB,CAAC,CAAC;YACH,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;gBAChF,OAAO,CAAC,CAAC;YACX,CAAC;YACD,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC"}

package/dist/cli/commands/transform.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "clipanion";
+export declare class TransformCommand extends Command {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    inputFile: string;
+    output: string;
+    execute(): Promise<number>;
+}
+//# sourceMappingURL=transform.d.ts.map

package/dist/cli/commands/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/transform.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAG5C,qBAAa,gBAAiB,SAAQ,OAAO;IAC3C,OAAgB,KAAK,aAAmB;IAExC,OAAgB,KAAK,4BAoBlB;IAEH,SAAS,SAAoD;IAE7D,MAAM,SAGH;IAGG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAqCjC"}

package/dist/cli/commands/transform.js

@@ -0,0 +1,64 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, relative, resolve } from "node:path";
+import { Command, Option } from "clipanion";
+import { transformCalmToArchify } from "../lib/calm-to-archify.js";
+export class TransformCommand extends Command {
+    static paths = [["transform"]];
+    static usage = Command.Usage({
+        description: "Transform a CALM architecture JSON file into archify diagram JSON",
+        details: `
+      Reads a CALM .arch.json file and produces an archify JSON-IR file
+      that can be rendered to interactive HTML using archify-render or
+      'archify render architecture'.
+
+      Pattern files (.pattern.json) are JSON Schema documents and are not
+      supported — only CALM architecture instances (.arch.json) are accepted.
+    `,
+        examples: [
+            [
+                "Transform typical-alistigo-artifact.arch.json",
+                "calm-to-archify systems/typical-alistigo-artifact.arch.json --output .archify-out/typical-alistigo-artifact.archify.json",
+            ],
+            [
+                "Transform with explicit output path",
+                "calm-to-archify path/to/my.arch.json --output path/to/output.archify.json",
+            ],
+        ],
+    });
+    inputFile = Option.String({ required: true, name: "input" });
+    output = Option.String("--output,-o", {
+        description: "Output path for the archify JSON file",
+        required: true,
+    });
+    // fallow-ignore-next-line complexity
+    async execute() {
+        const inputPath = resolve(process.cwd(), this.inputFile);
+        const outputPath = resolve(process.cwd(), this.output);
+        if (!existsSync(inputPath)) {
+            this.context.stderr.write(`Error: input file not found: ${inputPath}\n`);
+            return 1;
+        }
+        let calm;
+        try {
+            calm = JSON.parse(readFileSync(inputPath, "utf-8"));
+        }
+        catch (err) {
+            this.context.stderr.write(`Error: failed to parse ${inputPath}: ${String(err)}\n`);
+            return 1;
+        }
+        if (!calm.nodes || !calm.relationships) {
+            this.context.stderr.write(`Error: ${inputPath} does not look like a CALM architecture instance — ` +
+                "it's missing 'nodes' or 'relationships'. Pattern files (.pattern.json) are not supported.\n");
+            return 1;
+        }
+        // archify requires meta.output to be a relative path from cwd
+        const htmlOutputPath = relative(process.cwd(), outputPath.replace(/\.json$/, ".html"));
+        const archify = transformCalmToArchify(calm, htmlOutputPath);
+        const outputDir = dirname(outputPath);
+        mkdirSync(outputDir, { recursive: true });
+        writeFileSync(outputPath, JSON.stringify(archify, null, 2), "utf-8");
+        this.context.stdout.write(`Transformed → ${outputPath}\n`);
+        return 0;
+    }
+}
+//# sourceMappingURL=transform.js.map

package/dist/cli/commands/transform.js.map

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

package/dist/cli/lib/calm-to-archify.d.ts

@@ -0,0 +1,73 @@
+export interface CalmNode {
+    "unique-id": string;
+    "node-type": string;
+    name: string;
+    description?: string;
+}
+export interface CalmRelationship {
+    "unique-id": string;
+    description?: string;
+    "relationship-type": {
+        "composed-of": {
+            container: string;
+            nodes: string[];
+        };
+    } | {
+        "deployed-in": {
+            container: string;
+            nodes: string[];
+        };
+    } | {
+        connects: {
+            source: {
+                node: string;
+            };
+            destination: {
+                node: string;
+            };
+        };
+    } | {
+        interacts: {
+            actor: string;
+            nodes: string[];
+        };
+    };
+}
+export interface CalmDocument {
+    "unique-id": string;
+    name: string;
+    description?: string;
+    nodes: CalmNode[];
+    relationships: CalmRelationship[];
+}
+export interface ArchifyComponent {
+    id: string;
+    type: string;
+    label: string;
+    pos: [number, number];
+    size: [number, number];
+}
+export interface ArchifyBoundary {
+    kind: string;
+    label: string;
+    wraps: string[];
+}
+export interface ArchifyConnection {
+    id: string;
+    from: string;
+    to: string;
+}
+export interface ArchifyDocument {
+    schema_version: 1;
+    diagram_type: "architecture";
+    meta: {
+        title: string;
+        subtitle?: string;
+        output: string;
+    };
+    components: ArchifyComponent[];
+    boundaries: ArchifyBoundary[];
+    connections: ArchifyConnection[];
+}
+export declare function transformCalmToArchify(calm: CalmDocument, outputPath: string): ArchifyDocument;
+//# sourceMappingURL=calm-to-archify.d.ts.map

package/dist/cli/lib/calm-to-archify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calm-to-archify.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/calm-to-archify.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,EACf;QAAE,aAAa,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,EAAE,CAAA;SAAE,CAAA;KAAE,GACzD;QAAE,aAAa,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,EAAE,CAAA;SAAE,CAAA;KAAE,GACzD;QAAE,QAAQ,EAAE;YAAE,MAAM,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,WAAW,EAAE;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,GACzE;QAAE,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,EAAE,CAAA;SAAE,CAAA;KAAE,CAAC;CACvD;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,CAAC,CAAC;IAClB,YAAY,EAAE,cAAc,CAAC;IAC7B,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAyCD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CA+F9F"}

package/dist/cli/lib/calm-to-archify.js

@@ -0,0 +1,124 @@
+import path from "node:path";
+import { computeLayout } from "./layout.js";
+// fallow-ignore-next-line complexity
+function mapNodeType(nodeType, name) {
+    const lower = name.toLowerCase();
+    switch (nodeType) {
+        case "actor":
+            return "external";
+        case "database":
+            return "database";
+        case "data-asset":
+            return "external";
+        case "system": {
+            return "backend";
+        }
+        case "service": {
+            if (lower.includes("cdn") || lower.includes("npm"))
+                return "cloud";
+            if (lower.includes("bus") || lower.includes("event"))
+                return "messagebus";
+            if (lower.includes("presentation") ||
+                lower.includes("react") ||
+                lower.includes("ui") ||
+                lower.includes("frontend"))
+                return "frontend";
+            return "backend";
+        }
+        default:
+            return "backend";
+    }
+}
+function firstSentence(text) {
+    const dot = text.indexOf(".");
+    const maxLen = 120;
+    if (dot === -1 || dot > maxLen)
+        return text.length <= maxLen ? text : `${text.slice(0, maxLen - 1)}…`;
+    return text.slice(0, dot + 1);
+}
+// fallow-ignore-next-line complexity
+export function transformCalmToArchify(calm, outputPath) {
+    const nodeIds = calm.nodes.map((n) => n["unique-id"]);
+    const composedOfSets = [];
+    const deployedInSets = [];
+    const boundaries = [];
+    const connections = [];
+    const connIdsSeen = new Set();
+    function safeConnId(base) {
+        let id = base;
+        let counter = 1;
+        while (connIdsSeen.has(id)) {
+            id = `${base}-${counter++}`;
+        }
+        connIdsSeen.add(id);
+        return id;
+    }
+    for (const rel of calm.relationships) {
+        const rt = rel["relationship-type"];
+        if ("composed-of" in rt) {
+            const { container, nodes: children } = rt["composed-of"];
+            const containerNode = calm.nodes.find((n) => n["unique-id"] === container);
+            const label = containerNode?.name ?? container;
+            composedOfSets.push(children);
+            boundaries.push({ kind: "region", label, wraps: children });
+            continue;
+        }
+        if ("deployed-in" in rt) {
+            const { container, nodes: children } = rt["deployed-in"];
+            const containerNode = calm.nodes.find((n) => n["unique-id"] === container);
+            const label = containerNode?.name ?? container;
+            deployedInSets.push(children);
+            boundaries.push({ kind: "region", label, wraps: children });
+            continue;
+        }
+        if ("connects" in rt) {
+            const { source, destination } = rt.connects;
+            connections.push({
+                id: safeConnId(rel["unique-id"]),
+                from: source.node,
+                to: destination.node,
+            });
+            continue;
+        }
+        if ("interacts" in rt) {
+            const { actor, nodes: targets } = rt.interacts;
+            for (const target of targets) {
+                connections.push({
+                    id: safeConnId(`${rel["unique-id"]}-${target}`),
+                    from: actor,
+                    to: target,
+                });
+            }
+        }
+    }
+    const layoutInput = {
+        nodeIds,
+        composedOfSets,
+        deployedInSets,
+    };
+    const positions = computeLayout(layoutInput);
+    const components = calm.nodes.map((node) => {
+        const pos = positions.get(node["unique-id"]) ?? { x: 0, y: 0, w: 140, h: 55 };
+        return {
+            id: node["unique-id"],
+            type: mapNodeType(node["node-type"], node.name),
+            label: node.name,
+            pos: [pos.x, pos.y],
+            size: [pos.w, pos.h],
+        };
+    });
+    const subtitle = calm.description ? firstSentence(calm.description) : undefined;
+    return {
+        schema_version: 1,
+        diagram_type: "architecture",
+        meta: {
+            title: calm.name,
+            ...(subtitle && { subtitle }),
+            output: path.isAbsolute(outputPath) ? outputPath : outputPath,
+        },
+        components,
+        boundaries,
+        connections,
+    };
+}
+//# sourceMappingURL=calm-to-archify.js.map

package/dist/cli/lib/calm-to-archify.js.map

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

package/dist/cli/lib/layout.d.ts

@@ -0,0 +1,13 @@
+export interface LayoutInput {
+    nodeIds: string[];
+    composedOfSets: string[][];
+    deployedInSets: string[][];
+}
+export interface NodePosition {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export declare function computeLayout(input: LayoutInput): Map<string, NodePosition>;
+//# sourceMappingURL=layout.d.ts.map

package/dist/cli/lib/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/layout.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAuBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAsD3E"}

package/dist/cli/lib/layout.js

@@ -0,0 +1,75 @@
+const COMP_W = 240;
+const COMP_H = 55;
+const COL_GAP = 40;
+const ROW_GAP = 40;
+const COLS = 2;
+const SECTION_Y_GAP = 70;
+const EXTERNAL_START_X = 30;
+const EXTERNAL_START_Y = 30;
+function layoutRow(ids, startX, startY, cols) {
+    const result = new Map();
+    ids.forEach((id, i) => {
+        const col = i % cols;
+        const row = Math.floor(i / cols);
+        result.set(id, {
+            x: startX + col * (COMP_W + COL_GAP),
+            y: startY + row * (COMP_H + ROW_GAP),
+            w: COMP_W,
+            h: COMP_H,
+        });
+    });
+    return result;
+}
+// fallow-ignore-next-line complexity
+export function computeLayout(input) {
+    const { nodeIds, composedOfSets, deployedInSets } = input;
+    // Nodes that appear in composed-of children (deepest level)
+    const composedChildren = new Set(composedOfSets.flat());
+    // Nodes that appear in deployed-in children (middle level, not already composed children)
+    const deployedChildren = new Set(deployedInSets.flat().filter((id) => !composedChildren.has(id)));
+    // All nodes that are container targets (the "container" node itself, i.e. the node that wraps others)
+    // These are nodes referenced as containers in the relationships — we identify them by exclusion:
+    // they appear in the overall node list but are not children themselves
+    const allChildIds = new Set([...composedChildren, ...deployedChildren]);
+    const external = nodeIds.filter((id) => !allChildIds.has(id));
+    const positions = new Map();
+    // Row 0: external nodes
+    const externalLayout = layoutRow(external, EXTERNAL_START_X, EXTERNAL_START_Y, COLS);
+    for (const [id, pos] of externalLayout)
+        positions.set(id, pos);
+    const externalRows = Math.ceil(external.length / COLS);
+    const externalHeight = externalRows * (COMP_H + ROW_GAP);
+    let nextY = EXTERNAL_START_Y + externalHeight + SECTION_Y_GAP;
+    // Row 1: deployed-only nodes (not composed children), laid out before composed children
+    const deployedOnlyList = [...deployedChildren];
+    if (deployedOnlyList.length > 0) {
+        const deployedLayout = layoutRow(deployedOnlyList, EXTERNAL_START_X, nextY, COLS);
+        for (const [id, pos] of deployedLayout)
+            positions.set(id, pos);
+        const deployedRows = Math.ceil(deployedOnlyList.length / COLS);
+        nextY += deployedRows * (COMP_H + ROW_GAP) + SECTION_Y_GAP;
+    }
+    // Row 2+: composed children, laid out per composed-of group
+    const processedComposed = new Set();
+    for (const group of composedOfSets) {
+        const toLayout = group.filter((id) => !processedComposed.has(id));
+        if (toLayout.length === 0)
+            continue;
+        const groupLayout = layoutRow(toLayout, EXTERNAL_START_X, nextY, COLS);
+        groupLayout.forEach((pos, id) => {
+            positions.set(id, pos);
+            processedComposed.add(id);
+        });
+        const groupRows = Math.ceil(toLayout.length / COLS);
+        nextY += groupRows * (COMP_H + ROW_GAP) + SECTION_Y_GAP;
+    }
+    // Any remaining nodes not yet positioned
+    const remaining = nodeIds.filter((id) => !positions.has(id));
+    if (remaining.length > 0) {
+        const remainingLayout = layoutRow(remaining, EXTERNAL_START_X, nextY, COLS);
+        for (const [id, pos] of remainingLayout)
+            positions.set(id, pos);
+    }
+    return positions;
+}
+//# sourceMappingURL=layout.js.map

package/dist/cli/lib/layout.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { Cli } from "clipanion";
+import { BuildCommand } from "./cli/commands/build.js";
+import { TransformCommand } from "./cli/commands/transform.js";
+const cli = new Cli({
+    binaryLabel: "calm-to-archify",
+    binaryName: "calm-to-archify",
+    binaryVersion: "0.1.0",
+});
+cli.register(BuildCommand);
+cli.register(TransformCommand);
+cli.runExit(process.argv.slice(2));
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;IAClB,WAAW,EAAE,iBAAiB;IAC9B,UAAU,EAAE,iBAAiB;IAC7B,aAAa,EAAE,OAAO;CACvB,CAAC,CAAC;AAEH,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AAC3B,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AAC/B,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@alistigo/calm-to-archify",
+  "version": "0.2.0",
+  "license": "MIT",
+  "author": {
+    "name": "Mikael Labrut",
+    "email": "contact@alistigo.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alistigo/holos.git",
+    "directory": "cli/calm-to-archify"
+  },
+  "private": false,
+  "type": "module",
+  "description": "Convert CALM architecture JSON to archify HTML diagrams",
+  "bin": {
+    "calm-to-archify": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@alistigo/archify-render": "workspace:*",
+    "clipanion": "4.0.0-rc.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "types": "./cli.d.ts",
+  "module": "./cli.js",
+  "main": "./cli.js"
+}

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@alistigo/calm-to-archify",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "license": "MIT",
+  "author": {
+    "name": "Mikael Labrut",
+    "email": "contact@alistigo.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alistigo/holos.git",
+    "directory": "cli/calm-to-archify"
+  },
+  "private": false,
+  "type": "module",
+  "description": "Convert CALM architecture JSON to archify HTML diagrams",
+  "bin": {
+    "calm-to-archify": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "clipanion": "4.0.0-rc.4",
+    "@alistigo/archify-render": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  }
 }