airgen-cli 0.4.1 → 0.5.0

package/dist/commands/diagrams.js

@@ -1,29 +1,41 @@
 import { writeFileSync } from "node:fs";
 import { output, printTable, isJsonMode } from "../output.js";
 // ── Mermaid rendering helpers ─────────────────────────────────
+// Counter for generating short, readable Mermaid node IDs
+let mermaidNodeCounter = 0;
+const mermaidIdMap = new Map();
+function resetMermaidIds() {
+    mermaidNodeCounter = 0;
+    mermaidIdMap.clear();
+}
 function sanitizeId(id) {
-    return id.replace(/[^a-zA-Z0-9_-]/g, "_");
+    let short = mermaidIdMap.get(id);
+    if (!short) {
+        short = `n${mermaidNodeCounter++}`;
+        mermaidIdMap.set(id, short);
+    }
+    return short;
 }
 function mermaidNodeShape(block) {
     const id = sanitizeId(block.id);
     const label = block.name.replace(/"/g, "'");
     const stereo = block.stereotype?.replace(/[«»<>]/g, "") ?? block.kind ?? "block";
-    const display = `"«${stereo}»\\n${label}"`;
+    const display = `"<<${stereo}>><br/>${label}"`;
     switch (block.kind) {
         case "system": return `${id}[${display}]`;
         case "subsystem": return `${id}[${display}]`;
         case "actor": return `${id}([${display}])`;
-        case "external": return `${id}>${display}]`;
+        case "external": return `${id}[${display}]`;
         case "interface": return `${id}{{${display}}}`;
-        default: return `${id}[${display}]`; // component
+        default: return `${id}[${display}]`;
     }
 }
 function mermaidArrow(kind) {
     switch (kind) {
         case "flow": return "==>";
         case "dependency": return "-.->";
-        case "composition": return "--*";
-        default: return "-->"; // association
+        case "composition": return "-->";
+        default: return "-->";
     }
 }
 function mermaidStyle(block) {
@@ -174,6 +186,7 @@ function renderTerminal(blocks, connectors) {
     return lines.join("\n");
 }
 function renderMermaid(blocks, connectors, direction) {
+    resetMermaidIds();
     const lines = [`flowchart ${direction}`];
     // Nodes
     for (const b of blocks) {
@@ -185,7 +198,8 @@ function renderMermaid(blocks, connectors, direction) {
         const tgt = sanitizeId(c.target);
         const arrow = mermaidArrow(c.kind);
         if (c.label) {
-            lines.push(`  ${src} ${arrow}|"${c.label.replace(/"/g, "'")}"| ${tgt}`);
+            const edgeLabel = c.label.replace(/"/g, "'");
+            lines.push(`  ${src} ${arrow}|${edgeLabel}| ${tgt}`);
         }
         else {
             lines.push(`  ${src} ${arrow} ${tgt}`);
@@ -346,6 +360,32 @@ export function registerDiagramCommands(program, client) {
     });
     // Blocks sub-group
     const blocks = cmd.command("blocks").description("Manage blocks in diagrams");
+    blocks
+        .command("list")
+        .description("List blocks in a diagram")
+        .argument("<tenant>", "Tenant slug")
+        .argument("<project>", "Project slug")
+        .argument("<diagram-id>", "Diagram ID")
+        .action(async (tenant, project, diagramId) => {
+        const data = await client.get(`/architecture/blocks/${tenant}/${project}/${diagramId}`);
+        const list = data.blocks ?? [];
+        if (isJsonMode()) {
+            output(list);
+        }
+        else {
+            if (list.length === 0) {
+                console.log("No blocks in this diagram.");
+                return;
+            }
+            printTable(["ID", "Name", "Kind", "Stereotype", "Ports"], list.map(b => [
+                b.id,
+                b.name,
+                b.kind ?? "",
+                b.stereotype ?? "",
+                String(b.ports?.length ?? 0),
+            ]));
+        }
+    });
     blocks
         .command("library")
         .description("Get all block definitions in the project")

package/dist/commands/lint.js

@@ -1,4 +1,4 @@
-import { writeFileSync } from "node:fs";
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
 import { UhtClient } from "../uht-client.js";
 import { isJsonMode } from "../output.js";
 // ── Constants ────────────────────────────────────────────────
@@ -320,6 +320,9 @@ export function registerLintCommands(program, client) {
         .option("--concepts <n>", "Max concepts to classify", "15")
         .option("--format <fmt>", "Output format: text, markdown, json", "text")
         .option("-o, --output <file>", "Write report to file")
+        .option("--suppress <titles...>", "Suppress findings by title substring (repeatable)")
+        .option("--baseline <file>", "Suppress findings listed in a baseline file (one title per line)")
+        .option("--save-baseline <file>", "Write current finding titles to a baseline file for future suppression")
         .action(async (tenant, project, opts) => {
         const uht = new UhtClient();
         if (!uht.isConfigured) {
@@ -391,7 +394,28 @@ export function registerLintCommands(program, client) {
         }
         // Step 5: Analyze findings
         console.error("Analyzing...");
-        const findings = analyzeFindings(concepts, comparisons, requirements);
+        let findings = analyzeFindings(concepts, comparisons, requirements);
+        // Step 5b: Save baseline if requested (before suppression)
+        if (opts.saveBaseline) {
+            const titles = findings.map(f => f.title);
+            writeFileSync(opts.saveBaseline, titles.join("\n") + "\n", "utf-8");
+            console.error(`Baseline saved to ${opts.saveBaseline} (${titles.length} findings)`);
+        }
+        // Step 5c: Apply suppression
+        const suppressions = [...(opts.suppress ?? [])];
+        if (opts.baseline && existsSync(opts.baseline)) {
+            const baselineContent = readFileSync(opts.baseline, "utf-8");
+            const baselineLines = baselineContent.split("\n").map(l => l.trim()).filter(Boolean);
+            suppressions.push(...baselineLines);
+        }
+        if (suppressions.length > 0) {
+            const before = findings.length;
+            findings = findings.filter(f => !suppressions.some(s => f.title.includes(s)));
+            const suppressed = before - findings.length;
+            if (suppressed > 0) {
+                console.error(`Suppressed ${suppressed} known finding(s).`);
+            }
+        }
         // Step 6: Output report
         let report;
         if (opts.format === "json" || isJsonMode()) {

package/dist/commands/traceability.js

@@ -12,7 +12,7 @@ export function registerTraceabilityCommands(program, client) {
             ? `/trace-links/${tenant}/${project}/${opts.requirement}`
             : `/trace-links/${tenant}/${project}`;
         const data = await client.get(path);
-        const links = data.links ?? [];
+        const links = data.traceLinks ?? [];
         if (isJsonMode()) {
             output(links);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "airgen-cli",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "AIRGen CLI — requirements engineering from the command line",
   "type": "module",
   "main": "dist/index.js",