@meltemi/diagrams-cli 0.0.0-stage → 1.9.0

package/dist/review-command.js

@@ -0,0 +1,348 @@
+import { getLocale } from "@meltemi/diagrams-i18n";
+import { mkdirSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { ProjectSessions, REVIEW_COLOURS, gitRevisionHost, reviewProjects, } from "@meltemi/diagrams-editor/node";
+import { describeChange } from "@meltemi/diagrams-model";
+import { toProjectPath } from "@meltemi/diagrams-project";
+import { createNodeHost } from "@meltemi/diagrams-project/node";
+import { cloudHost } from "./cloud-host.js";
+import { printablePath } from "./cloud-paths.js";
+import { openCloud, reportCloudError } from "./cloud-context.js";
+import { CloudError } from "./cloud-errors.js";
+import { argumentsError, messages } from "./messages/index.js";
+import { redactSecrets } from "./redact.js";
+/**
+ * What `--base` names when it is the cloud: `cloud` (the project's current files) or `cloud:<n>`
+ * (version `n`); `invalid` for `cloud:` and `cloud:x`; undefined for a Git revision.
+ */
+export function parseCloudBase(base) {
+    if (base === "cloud")
+        return { version: undefined };
+    if (base === undefined || !base.startsWith("cloud:"))
+        return undefined;
+    return /^cloud:[0-9]{1,9}$/.test(base) ? { version: Number(base.slice(6)) } : "invalid";
+}
+const EXIT_OK = 0;
+const EXIT_FINDINGS = 1;
+const EXIT_USAGE = 2;
+const SIGNS = {
+    added: "+",
+    removed: "-",
+    renamed: ">",
+    changed: "~",
+};
+function exists(path) {
+    try {
+        return statSync(path).isDirectory() ? "folder" : "file";
+    }
+    catch {
+        return null;
+    }
+}
+/** Counts of changes by kind, over every file. */
+export function reviewSummary(review) {
+    const counts = { files: review.files.length, added: 0, removed: 0, renamed: 0, changed: 0 };
+    for (const file of review.files)
+        for (const c of file.changes)
+            counts[c.kind]++;
+    return counts;
+}
+/** The summary of a review, in the interface language or the one given. */
+function summaryLine(review, locale = getLocale()) {
+    const s = reviewSummary(review);
+    const t = messages(locale).review;
+    if (s.files === 0)
+        return t.none;
+    return t.summary(s.files, s.added, s.removed, s.renamed, s.changed);
+}
+/** The changes of a file, grouped under the diagram, model or story they are in. */
+function fileLines(file) {
+    const head = file.status === "renamed" ? `${file.from} → ${file.path}` : `${file.path}`;
+    const lines = [`${SIGNS[file.status]} ${head}`];
+    const top = file.changes.filter((c) => c.scope === null);
+    for (const c of top) {
+        lines.push(`    ${describeChange(c)}`);
+        const inside = file.changes.filter((x) => x.scope === c.id);
+        for (const x of inside)
+            lines.push(`        ${describeChange(x)}`);
+    }
+    // Scopes whose block itself did not change.
+    const scopes = [...new Set(file.changes.map((c) => c.scope).filter((s) => s !== null))];
+    const t = messages().review;
+    for (const scope of scopes) {
+        if (top.some((c) => c.id === scope))
+            continue;
+        const kind = file.scopes[scope];
+        lines.push(`    ${kind === undefined ? t.block : t.scopes[kind]} ${scope}`);
+        for (const x of file.changes.filter((c) => c.scope === scope)) {
+            lines.push(`        ${describeChange(x)}`);
+        }
+    }
+    return lines;
+}
+const escape = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+const baseName = (path) => path.slice(path.lastIndexOf("/") + 1);
+const url = (path) => path.split("/").map(encodeURIComponent).join("/");
+/**
+ * The review page: the changes of every file and the pictures of its changed diagrams, with its
+ * words in `locale`, the language of the files the command writes (never the machine's).
+ */
+export function reviewPage(review, title, compared, pictures, locale = "en") {
+    const t = messages(locale).review.page;
+    const kind = (c) => c.kind;
+    const sections = review.files.map((file) => {
+        const changes = file.changes
+            .map((c) => `<li class="${kind(c)}">${escape(describeChange(c, locale))}${c.scope ? ` <span class="in">${escape(t.in(c.scope))}</span>` : ""}</li>`)
+            .join("");
+        const diagrams = file.diagrams
+            .map((d) => {
+            const key = `${file.path}#${d.id}`;
+            const files = pictures.get(key);
+            const figure = (which, src) => `<figure><figcaption>${which === "before" ? t.before : t.after}</figcaption>${src
+                ? `<img src="${escape(url(src))}" alt="${escape(t.picture(d.id, which))}">`
+                : `<p class="none">${which === "before" ? t.new : t.removed}</p>`}</figure>`;
+            return `<h3>${escape(t.diagram(d.from && d.from !== d.id ? `${d.from} → ${d.id}` : d.id))}</h3><div class="pair">${figure("before", files?.before)}${figure("after", files?.after)}</div>`;
+        })
+            .join("");
+        const head = file.status === "renamed" ? `${file.from} → ${file.path}` : file.path;
+        return `<section><h2><span class="status ${file.status}">${t.status[file.status]}</span> ${escape(head)}</h2><ul class="changes">${changes}</ul>${diagrams}</section>`;
+    });
+    const legend = Object.keys(REVIEW_COLOURS)
+        .map((k) => `<span><i style="border-color:${REVIEW_COLOURS[k]}"></i>${t.status[k]}</span>`)
+        .join("");
+    return `<!doctype html>
+<html lang="${locale}">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta http-equiv="Content-Security-Policy" content="default-src 'none'; img-src 'self' data:; style-src 'unsafe-inline'">
+<title>${escape(`${t.title} · ${title}`)}</title>
+<style>
+:root { color-scheme: light dark; --bg: #f6f7f9; --panel: #fff; --fg: #1b1f24; --muted: #59626e; --line: #d8dde4; }
+@media (prefers-color-scheme: dark) { :root { --bg: #0f1216; --panel: #171b21; --fg: #e6e9ee; --muted: #9ba5b2; --line: #2c323b; } }
+body { margin: 0; background: var(--bg); color: var(--fg); font: 15px/1.5 system-ui, sans-serif; }
+main { max-width: 1400px; margin: 0 auto; padding: 24px 16px 48px; }
+h1 { margin: 0 0 4px; font-size: 1.6rem; }
+h2 { margin: 32px 0 8px; font-size: 1.1rem; }
+h3 { margin: 16px 0 8px; font-size: 1rem; }
+.lead, .in, .none { color: var(--muted); }
+.legend { display: flex; flex-wrap: wrap; gap: 16px; color: var(--muted); }
+.legend i { display: inline-block; width: 12px; height: 12px; margin-right: 6px; border: 3px solid; border-radius: 3px; vertical-align: -2px; }
+.status { display: inline-block; padding: 0 6px; border-radius: 4px; font-size: 0.75rem; text-transform: uppercase; color: #fff; }
+.status.added { background: ${REVIEW_COLOURS.added}; } .status.removed { background: ${REVIEW_COLOURS.removed}; }
+.status.renamed { background: ${REVIEW_COLOURS.renamed}; } .status.changed { background: ${REVIEW_COLOURS.changed}; }
+.changes { padding-left: 1.2em; font: 0.9rem/1.6 ui-monospace, "Cascadia Mono", Consolas, monospace; }
+.changes .added { color: ${REVIEW_COLOURS.added}; } .changes .removed { color: ${REVIEW_COLOURS.removed}; }
+.changes .renamed { color: ${REVIEW_COLOURS.renamed}; }
+.pair { display: grid; grid-template-columns: repeat(auto-fit, minmax(320px, 1fr)); gap: 16px; }
+figure { margin: 0; padding: 8px; border: 1px solid var(--line); border-radius: 8px; background: var(--panel); }
+figcaption { margin-bottom: 6px; color: var(--muted); font-size: 0.85rem; }
+figure img { display: block; max-width: 100%; max-height: 80vh; width: auto; height: auto; margin: 0 auto; }
+</style>
+</head>
+<body>
+<main>
+<h1>${escape(t.title)}</h1>
+<p class="lead">${escape(`${compared}. ${summaryLine(review, locale)}`)}</p>
+<p class="legend">${legend}</p>
+${sections.join("\n")}
+</main>
+</body>
+</html>
+`;
+}
+/** `meltemi-diagrams review`; asynchronous, because `--base cloud` reads the cloud project first. */
+export async function reviewCommand(args, context) {
+    /** What the command prints and writes: with a cloud context, without any token in it. */
+    const clean = (text) => context.cloud ? redactSecrets(text, context.cloud.env) : text;
+    const stdout = (text) => context.stdout(clean(text));
+    const stderr = (text) => context.stderr(clean(text));
+    const fail = (message) => {
+        stderr(`${context.name} review: ${message}\n`);
+        return EXIT_USAGE;
+    };
+    let options;
+    let paths;
+    try {
+        const parsed = parseArgs({
+            args: [...args],
+            options: {
+                base: { type: "string" },
+                before: { type: "string" },
+                out: { type: "string" },
+                project: { type: "string" },
+                host: { type: "string" },
+                json: { type: "boolean", default: false },
+                "exit-code": { type: "boolean", default: false },
+                help: { type: "boolean", short: "h", default: false },
+            },
+            allowPositionals: true,
+            strict: true,
+        });
+        options = parsed.values;
+        paths = parsed.positionals;
+    }
+    catch (error) {
+        return fail(argumentsError(error));
+    }
+    const t = messages().review;
+    if (options.help) {
+        stdout(messages().help.review);
+        return EXIT_OK;
+    }
+    if (paths.length > 1)
+        return fail(messages().common.oneProjectFolderOrFile);
+    if (options.base !== undefined && options.before !== undefined)
+        return fail(t.baseOrBefore);
+    const cloudBase = parseCloudBase(options.base);
+    if (cloudBase === "invalid")
+        return fail(t.cloudVersion);
+    if (cloudBase === undefined && (options.project !== undefined || options.host !== undefined)) {
+        return fail(t.cloudOptions);
+    }
+    const target = toProjectPath(resolve(context.cwd, paths[0] ?? "."));
+    const kind = exists(target);
+    if (!kind)
+        return fail(messages().common.pathNotFound(paths[0] ?? "."));
+    const scopeOf = (path, isFolder, workspace) => isFolder && path === workspace.root ? null : path;
+    const afterProjects = new ProjectSessions({
+        toolVersion: context.toolVersion,
+        ...localeOf(context),
+    });
+    const afterWorkspace = kind === "folder" ? afterProjects.forFolder(target) : afterProjects.forFile(target);
+    const after = {
+        workspace: afterWorkspace,
+        projects: afterProjects,
+        scope: scopeOf(target, kind === "folder", afterWorkspace),
+    };
+    let before;
+    /** What was compared, in a language: the terminal's, or the report's. */
+    let compared;
+    if (options.before !== undefined) {
+        const path = toProjectPath(resolve(context.cwd, options.before));
+        const beforeKind = exists(path);
+        if (!beforeKind)
+            return fail(messages().common.pathNotFound(options.before));
+        if (beforeKind !== kind)
+            return fail(t.sameKinds);
+        const projects = new ProjectSessions({
+            toolVersion: context.toolVersion,
+            ...localeOf(context),
+            host: createNodeHost(),
+        });
+        const workspace = kind === "folder" ? projects.forFolder(path) : projects.forFile(path);
+        before = { workspace, projects, scope: scopeOf(path, kind === "folder", workspace) };
+        // Names, not paths: the page is shared, and paths would tell where the files live.
+        compared = (locale) => messages(locale).review.comparedPaths(baseName(path), baseName(target));
+    }
+    else if (cloudBase !== undefined) {
+        const cloud = context.cloud;
+        if (cloud === undefined)
+            return fail(t.cloudUnavailable);
+        let host;
+        let project;
+        try {
+            const manifest = afterWorkspace.manifest().manifest;
+            // The manifest never chooses the host (`cloud.host-mismatch`); it names the project.
+            const named = options.project ?? manifest?.cloud?.project;
+            if (named === undefined) {
+                throw new CloudError("cloud.no-project", "The folder names no cloud project.");
+            }
+            project = named;
+            cloud.used.project = project;
+            const { client } = openCloud(cloud, {
+                host: options.host,
+                manifestHost: manifest?.cloud?.host,
+            });
+            host = await cloudHost(client, {
+                project,
+                root: afterWorkspace.root,
+                ...(cloudBase.version === undefined ? {} : { version: cloudBase.version }),
+            });
+        }
+        catch (error) {
+            if (error instanceof CloudError)
+                return reportCloudError(error, cloud);
+            throw error;
+        }
+        const projects = new ProjectSessions({
+            toolVersion: context.toolVersion,
+            host,
+            ...localeOf(context),
+        });
+        const workspace = kind === "folder" ? projects.forFolder(target) : projects.forFile(target);
+        before = { workspace, projects, scope: scopeOf(target, kind === "folder", workspace) };
+        compared = (locale) => messages(locale).review.comparedCloud(project, cloudBase.version);
+    }
+    else {
+        const revision = options.base ?? "HEAD";
+        const host = gitRevisionHost(kind === "folder" ? target : dirname(target), revision);
+        if (typeof host === "string")
+            return fail(host);
+        const projects = new ProjectSessions({
+            toolVersion: context.toolVersion,
+            host,
+            ...localeOf(context),
+        });
+        const workspace = kind === "folder" ? projects.forFolder(target) : projects.forFile(target);
+        before = { workspace, projects, scope: scopeOf(target, kind === "folder", workspace) };
+        compared = (locale) => messages(locale).review.comparedRevision(revision);
+    }
+    const review = reviewProjects(before, after, { images: options.out !== undefined });
+    const changed = review.files.length > 0;
+    if (options.out !== undefined) {
+        const out = resolve(context.cwd, options.out);
+        const pictures = new Map();
+        try {
+            for (const file of review.files) {
+                for (const diagram of file.diagrams) {
+                    const stem = file.path.replace(/\.meltemi$/, "");
+                    const write = (which, svg) => {
+                        if (svg === null)
+                            return null;
+                        const name = `${stem}/${diagram.id}.${which}.svg`;
+                        mkdirSync(dirname(join(out, name)), { recursive: true });
+                        writeFileSync(join(out, name), clean(svg));
+                        return name;
+                    };
+                    pictures.set(`${file.path}#${diagram.id}`, {
+                        before: write("before", diagram.before),
+                        after: write("after", diagram.after),
+                    });
+                }
+            }
+            mkdirSync(out, { recursive: true });
+            const title = afterWorkspace.manifest().manifest?.name ?? context.display(target);
+            // The report is a written file: `--lang`, else the project's `locale`, else English.
+            const locale = afterProjects.contentLocale(afterWorkspace);
+            writeFileSync(join(out, "index.html"), clean(reviewPage(review, title, compared(locale), pictures, locale)));
+        }
+        catch (error) {
+            return fail(messages().common.cannotWrite(context.display(out), error.message));
+        }
+        if (!options.json) {
+            stdout(`${messages().common.wrote(context.display(join(out, "index.html")))}\n`);
+        }
+    }
+    if (options.json) {
+        stdout(`${JSON.stringify({
+            compared: compared(getLocale()),
+            files: review.files.map(({ diagrams: _d, ...file }) => file),
+            summary: reviewSummary(review),
+        }, null, 2)}\n`);
+    }
+    else {
+        // The labels may come from the cloud's texts, which a collaborator wrote: control characters
+        // (an escape sequence could repaint the terminal) are written out.
+        for (const file of review.files)
+            stdout(`${fileLines(file).map(printablePath).join("\n")}\n`);
+        stdout(`${summaryLine(review)}\n`);
+    }
+    return changed && options["exit-code"] ? EXIT_FINDINGS : EXIT_OK;
+}
+/** The session option for the language of written files, when the command was given one. */
+function localeOf(context) {
+    return context.locale ? { locale: context.locale } : {};
+}
+//# sourceMappingURL=review-command.js.map

package/dist/review-command.js.map

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

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "@meltemi/diagrams-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.9.0",
+  "description": "Command line interface (meltemi-diagrams, alias mdg) for .meltemi projects.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/askenaz-dev/meltemi-diagrams.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/askenaz-dev/meltemi-diagrams/tree/main/packages/cli#readme",
+  "bugs": {
+    "url": "https://github.com/askenaz-dev/meltemi-diagrams/issues"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "type": "module",
+  "bin": {
+    "meltemi-diagrams": "./dist/bin.js",
+    "mdg": "./dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "@meltemi/diagrams-assets": "1.9.0",
+    "@meltemi/diagrams-assist": "1.9.0",
+    "@meltemi/diagrams-capture": "1.9.0",
+    "@meltemi/diagrams-catalog": "1.9.0",
+    "@meltemi/diagrams-edit": "1.9.0",
+    "@meltemi/diagrams-fonts": "1.9.0",
+    "@meltemi/diagrams-i18n": "1.9.0",
+    "@meltemi/diagrams-editor": "1.9.0",
+    "@meltemi/diagrams-import": "1.9.0",
+    "@meltemi/diagrams-layout": "1.9.0",
+    "@meltemi/diagrams-layout-elk": "1.9.0",
+    "@meltemi/diagrams-model": "1.9.0",
+    "@meltemi/diagrams-language": "1.9.0",
+    "@meltemi/diagrams-motion": "1.9.0",
+    "@meltemi/diagrams-project": "1.9.0",
+    "@meltemi/diagrams-render": "1.9.0",
+    "@meltemi/diagrams-player": "1.9.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json"
+  }
 }

package/templates/c4/diagrams/views.meltemi

@@ -0,0 +1,16 @@
+language "0.2"
+
+import system from "../models/system.meltemi"
+
+// Two views of the same model: the product in its context, and the containers inside it.
+diagram context: c4 using system {
+  title "System context"
+  level context
+}
+
+diagram containers: c4 using system {
+  title "Containers"
+  level container
+  scope product
+  direction LR
+}

package/templates/c4/models/system.meltemi

@@ -0,0 +1,23 @@
+language "0.2"
+
+// The architecture model: people, systems, containers and how they talk. Views choose what to
+// show; renaming an entity here renames it in every view.
+model system {
+  person user "User" { description "Uses the product" }
+
+  system product "Product" {
+    description "What the team builds"
+    container web "Web app" { technology "TypeScript" }
+    container api "API" { technology "Kotlin" }
+    datastore db "Database" { technology "PostgreSQL" }
+  }
+  system email "Email service" {
+    description "Sends notifications"
+    external
+  }
+
+  user -> product.web: "Uses" as uses
+  product.web -> product.api: "Calls" as calls { technology "JSON/HTTPS" }
+  product.api -> product.db: "Reads and writes" as stores
+  product.api -> email: "Sends emails" as notifies
+}

package/templates/ci/github.yml

@@ -0,0 +1,96 @@
+# Meltemi Diagrams: validate the project, review what changed in pull requests, and build the
+# catalog. Written by `meltemi-diagrams init --ci github`; edit it freely.
+name: Meltemi Diagrams
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+env:
+  PROJECT: "{{project}}"
+  MELTEMI_DIAGRAMS: "@meltemi/diagrams-cli@{{version}}"
+
+jobs:
+  diagrams:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # The review compares with the base branch, so the history is needed.
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Validate
+        run: npx --yes --package "$MELTEMI_DIAGRAMS" meltemi-diagrams validate "$PROJECT" --strict
+
+      - name: Review
+        if: github.event_name == 'pull_request'
+        # The base branch comes from the environment, never written into the script.
+        run: |
+          {
+            echo '### Diagram changes'
+            echo '```text'
+            npx --yes --package "$MELTEMI_DIAGRAMS" meltemi-diagrams review "$PROJECT" --base "origin/$GITHUB_BASE_REF" --out review
+            echo '```'
+          } >> "$GITHUB_STEP_SUMMARY"
+
+      - name: Catalog
+        run: npx --yes --package "$MELTEMI_DIAGRAMS" meltemi-diagrams build catalog "$PROJECT" --out catalog
+
+      # PNG, PDF and video profiles use the runner's Chrome; video also needs FFmpeg:
+      # - run: sudo apt-get update && sudo apt-get install -y ffmpeg
+      # - run: npx --yes --package "$MELTEMI_DIAGRAMS" meltemi-diagrams export "$PROJECT" --profiles --out exports
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: diagrams
+          path: |
+            catalog
+            review
+          if-no-files-found: ignore
+
+  # {{cloud-begin}}
+  # The job below is written by `meltemi-diagrams init --ci github --cloud` only: it mirrors the
+  # project in the Meltemi cloud on every push to the default branch, so that the page, the share
+  # links and the published catalog follow the repository.
+  #
+  # The repository is the truth, so this job pushes with --force: CI cannot answer the question a
+  # push asks when the cloud holds something the folder lacks (a diagram somebody drew in the
+  # page), and a job that waits for an answer would hang. --strict refuses a project with errors.
+  # What differs in the cloud is overwritten; pull it first if it should survive.
+  #
+  # The job runs on the repository's default branch, and the workflow starts on pushes to main
+  # only (`on:` above): edit the branches there if the default branch has another name.
+  #
+  # MELTEMI_TOKEN is an API token kept in this repository's secrets (Settings, Secrets and
+  # variables, Actions); create it in the page, under API tokens in the account menu. It is
+  # never written in this file. MELTEMI_HOST is optional: a repository variable that names
+  # another service than https://diagrams.meltemi.dev, and it must be a variable, not a secret.
+  cloud:
+    if: github.event_name == 'push' && github.ref_name == github.event.repository.default_branch
+    # One push to the cloud at a time, and a run still waiting is replaced by a newer one: with
+    # --force a slow job for an older commit would otherwise overwrite the newer commit's push.
+    concurrency:
+      group: meltemi-cloud
+      cancel-in-progress: false
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Push to the cloud
+        env:
+          MELTEMI_TOKEN: ${{ secrets.MELTEMI_TOKEN }}
+          MELTEMI_HOST: ${{ vars.MELTEMI_HOST }}
+        run: npx --yes --package "$MELTEMI_DIAGRAMS" meltemi-diagrams push "$PROJECT" --force --strict
+  # {{cloud-end}}

package/templates/ci/gitlab.yml

@@ -0,0 +1,53 @@
+# Meltemi Diagrams: validate the project, review what changed in merge requests, and build the
+# catalog. Written by `meltemi-diagrams init --ci gitlab`; edit it freely.
+meltemi-diagrams:
+  image: node:22
+  variables:
+    PROJECT: "{{project}}"
+    MELTEMI_DIAGRAMS: "@meltemi/diagrams-cli@{{version}}"
+    # The review compares with the target branch, so the history is needed.
+    GIT_DEPTH: "0"
+  script:
+    - npx --yes --package "$MELTEMI_DIAGRAMS" meltemi-diagrams validate "$PROJECT" --strict
+    - |
+      if [ -n "$CI_MERGE_REQUEST_TARGET_BRANCH_NAME" ]; then
+        git fetch origin "$CI_MERGE_REQUEST_TARGET_BRANCH_NAME"
+        npx --yes --package "$MELTEMI_DIAGRAMS" meltemi-diagrams review "$PROJECT" --base "origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME" --out review
+      fi
+    - npx --yes --package "$MELTEMI_DIAGRAMS" meltemi-diagrams build catalog "$PROJECT" --out catalog
+  artifacts:
+    paths:
+      - catalog
+      - review
+    expose_as: "Diagrams"
+  rules:
+    - if: $CI_PIPELINE_SOURCE == "merge_request_event"
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+
+# {{cloud-begin}}
+# The job below is written by `meltemi-diagrams init --ci gitlab --cloud` only: it mirrors the
+# project in the Meltemi cloud on every pipeline of the default branch, so that the page, the share
+# links and the published catalog follow the repository.
+#
+# The repository is the truth, so this job pushes with --force: CI cannot answer the question a push
+# asks when the cloud holds something the folder lacks (a diagram somebody drew in the page), and a
+# job that waits for an answer would hang. --strict refuses a project with errors. What differs in
+# the cloud is overwritten; pull it first if it should survive.
+#
+# MELTEMI_TOKEN is an API token kept as a CI/CD variable of this project (Settings, CI/CD,
+# Variables), masked and protected; create it in the page, under API tokens in the account menu.
+# It is never written in this file. MELTEMI_HOST is optional: a variable that names another service
+# than https://diagrams.meltemi.dev.
+meltemi-diagrams-cloud:
+  # One push to the cloud at a time: with --force a slow job for an older commit would otherwise
+  # overwrite the newer commit's push.
+  resource_group: meltemi-cloud
+  image: node:22
+  variables:
+    PROJECT: "{{project}}"
+    MELTEMI_DIAGRAMS: "@meltemi/diagrams-cli@{{version}}"
+  script:
+    - npx --yes --package "$MELTEMI_DIAGRAMS" meltemi-diagrams push "$PROJECT" --force --strict
+  rules:
+    - if: $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH
+# {{cloud-end}}

package/templates/flow/diagrams/overview.meltemi

@@ -0,0 +1,15 @@
+language "0.2"
+
+// A first diagram. Change the boxes and arrows, then run `meltemi-diagrams preview` to see it.
+diagram overview: flow {
+  title "Overview"
+  description "How a request reaches the data"
+  direction LR
+
+  client["Client"]
+  api["API"] { description "Handles requests" }
+  db[("Database")]
+
+  client -> api: "HTTPS" as request
+  api -> db: "Reads and writes" as store
+}