@alfacapital-tech/c4builder 0.9.0-rc.1 → 0.9.0-rc.3

package/README.MD

@@ -5,7 +5,7 @@
 **Architecture as code that an agent writes, checks and reads.**
 
 C4-Builder is a CLI that builds a folder of markdown files and [PlantUML](https://plantuml.com/),
-[D2](https://d2lang.com/) or [BPMN](https://www.bpmn.org/) diagrams into documentation: a [docsify](https://docsify.js.org/)
+[D2](https://d2lang.com/), [BPMN](https://www.bpmn.org/) or [Mermaid](https://mermaid.js.org/) diagrams into documentation: a [docsify](https://docsify.js.org/)
 site, a markdown file per folder, or a single file. Folders follow the
 [C4 model](https://c4model.com/) (system → container → component), and git keeps the history of
 architecture decisions next to the code.
@@ -19,7 +19,7 @@ than a hundred diagrams, so we continue it as a maintained fork, adapted to work
 - **Deterministic offline rendering.** The PlantUML jar, the diagram font and the engines ship
   with the package; layout is computed by PlantUML's built-in Smetana engine, no Graphviz. The
   same sources produce the same SVG on a laptop, in CI and in Docker, with no network access.
-- **`c4builder check`** validates individual `.puml`/`.iuml`/`.d2`/`.bpmn` files with the build's own
+- **`c4builder check`** validates individual `.puml`/`.iuml`/`.d2`/`.bpmn`/`.mmd` files with the build's own
   engine and returns an exit code and the error line — fast feedback for agents, pre-commit
   hooks and CI.
 - **Plugins.** `openspec` publishes an [OpenSpec](https://github.com/Fission-AI/OpenSpec) store
@@ -29,6 +29,8 @@ than a hundred diagrams, so we continue it as a maintained fork, adapted to work
   without a system Java, c4builder downloads a private JRE.
 - **BPMN** processes written as BPMN 2.0 XML without coordinates: the build validates the model
   and lays it out with horizontal pools and lanes.
+- **Mermaid** `.mmd` files and ```` ```mermaid ```` blocks are rendered at build time by real mermaid,
+  without a browser: images in every output instead of client-side rendering.
 - **Maintained.** TypeScript, golden rendering snapshots, CI on every pull request, releases to
   npm and GHCR. The PDF output of the original was removed.
 

package/dist/cli/agent.js

@@ -0,0 +1,21 @@
+const AGENT_VARS = [
+    ['CLAUDECODE', 'claude-code'],
+    ['CODEX_THREAD_ID', 'codex'],
+    ['GEMINI_CLI', 'gemini-cli'],
+    ['OPENCODE', 'opencode'],
+    ['COPILOT_CLI', 'copilot-cli']
+];
+const fromEnv = (env) => {
+    const own = env.C4BUILDER_AGENT;
+    if (own)
+        return { on: own !== '0', name: own, explicit: true };
+    const known = AGENT_VARS.find(([key]) => env[key]);
+    const name = known ? known[1] : env.AI_AGENT;
+    return { on: !!name, name: name ?? '', explicit: false };
+};
+export const detectAgent = (env, flags) => {
+    const found = fromEnv(env);
+    if (flags.agent === undefined)
+        return found;
+    return { on: flags.agent, name: found.on ? found.name : 'agent', explicit: true };
+};

package/dist/cli/commands/check.js

@@ -7,8 +7,9 @@ import { resolveJava } from "../../core/render/jre.js";
 import { renderDiagram } from "../../core/render/diagrams.js";
 import { renderD2, teardownD2 } from "../../core/render/d2renderer.js";
 import { BpmnError, renderBpmn, teardownBpmn } from "../../core/render/bpmnrenderer.js";
+import { MermaidError, renderMermaid, teardownMermaid } from "../../core/render/mermaidrenderer.js";
 // `c4builder check <file...>` — валидация отдельных диаграмм ТЕМ ЖЕ движком, что и
-// сборка (вендорный PlantUML jar + системная/managed java, бандл D2, конвейер BPMN), без проекта и
+// сборка (вендорный PlantUML jar + системная/managed java, бандл D2, конвейер BPMN, mermaid), без проекта и
 // `.c4builder`. Рендер идёт в память и выбрасывается: проверяем ровно то, что упало бы
 // в сборке (системный `plantuml` может отличаться версией). Код выхода 0 — все файлы ок,
 // 1 — есть ошибка (движка, неизвестного расширения или чтения файла).
@@ -64,11 +65,12 @@ const CHECKERS = {
     '.puml': checkPlantUml,
     '.iuml': checkPlantUml,
     '.d2': (abs) => renderD2(abs),
-    '.bpmn': async (abs) => renderBpmn(await readFile(abs, 'utf8'), path.relative(process.cwd(), abs))
+    '.bpmn': async (abs) => renderBpmn(await readFile(abs, 'utf8'), path.relative(process.cwd(), abs)),
+    '.mmd': async (abs) => renderMermaid(await readFile(abs, 'utf8'), path.relative(process.cwd(), abs))
 };
 export default async (files) => {
     if (files.length === 0) {
-        console.log(chalk.red('usage: c4builder check <file...>  (.puml | .iuml | .d2 | .bpmn)'));
+        console.log(chalk.red('usage: c4builder check <file...>  (.puml | .iuml | .d2 | .bpmn | .mmd)'));
         process.exit(1);
     }
     let failed = 0;
@@ -78,20 +80,21 @@ export default async (files) => {
         const check = CHECKERS[path.extname(abs).toLowerCase()];
         try {
             if (!check)
-                throw new Error('unsupported extension (expected .puml, .iuml, .d2 or .bpmn)');
+                throw new Error('unsupported extension (expected .puml, .iuml, .d2, .bpmn or .mmd)');
             await check(abs);
             console.log(chalk.green(`✓ ${file}`));
         }
         catch (e) {
             failed++;
-            // BPMN: по строке на нарушение — агент правит их по id элемента.
-            const problems = e instanceof BpmnError ? e.problems : [e.message];
+            // BPMN: по строке на нарушение — агент правит их по id элемента; mermaid — `line N: …`.
+            const problems = e instanceof BpmnError || e instanceof MermaidError ? e.problems : [e.message];
             for (const p of problems)
                 console.error(chalk.red(`✗ ${file}: ${p}`));
         }
     }
     await teardownD2();
     await teardownBpmn();
+    await teardownMermaid();
     if (failed)
         process.exit(1);
 };

package/dist/cli/commands/feedback.js

@@ -0,0 +1,45 @@
+import chalk from 'chalk';
+import fs from 'node:fs';
+import { parseConfig } from "../../config/options.js";
+import { FEEDBACK_HEADER, FEEDBACK_PATH } from "./site.comments.js";
+// `c4builder feedback` (change site-agent-feedback, design D9): забирает пачку замечаний у `site -w`.
+// Конфиг читается как JSON без Configstore — тот создал бы `.c4builder` в любом каталоге. Ошибки —
+// через exitCode, а не process.exit: напечатанная в pipe пачка должна успеть уйти целиком.
+export default async (configPath, opts) => {
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    }
+    catch { }
+    const config = parseConfig(raw && typeof raw === 'object' ? raw : {});
+    const port = opts.port ?? (config.ok ? config.value : config.salvaged).webPort;
+    const shown = `http://localhost:${port}`;
+    const fail = (message) => {
+        console.error(chalk.red(message));
+        process.exitCode = 1;
+    };
+    // 127.0.0.1, а не localhost: сервер слушает только IPv4, а `localhost` → `::1` на части машин
+    // подвешивает соединение.
+    const url = `http://127.0.0.1:${port}${FEEDBACK_PATH}/next${opts.wait ? '' : '?wait=0'}`;
+    for (;;) {
+        let res;
+        try {
+            res = await fetch(url, { headers: { [FEEDBACK_HEADER]: '1' } });
+        }
+        catch {
+            return fail(`no c4builder site -w on ${shown} — start it first`);
+        }
+        if (res.status === 200) {
+            process.stdout.write(await res.text());
+            return;
+        }
+        if (res.status === 204) {
+            if (opts.wait)
+                continue;
+            return;
+        }
+        if (res.status === 404)
+            return fail(`agent feedback is disabled on ${shown} — the server runs without -w or with --no-agent`);
+        return fail(`unexpected response ${res.status} from ${shown}`);
+    }
+};