feat: add dependency graph visualization, layer grouping, violations highlighting, and CI pipeline

Author: Olgabelokopytova90

.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - dev
+      - "**"
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test

bin/truss.ts

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 import * as path from "node:path";
 import { Command } from "commander";
-import { runCheck } from "../src/core/engine";
+import { runCheck, runAnalysis } from "../src/core/engine";
 import {
   renderHumanReport,
   renderJsonError,
   renderJsonReport,
 } from "../src/core/reporter";
 import { ExitCode } from "../src/core/types";
+import { renderGraphAsDot } from "../src/graph/dotRenderer";
 
 const program = new Command();
 
@@ -21,11 +22,11 @@ program
   .description("Check repository for architectural violations")
   .option("-c, --config <path>", "Path to truss.yml", "truss.yml")
   .option("--repo <path>", "Repo root", ".")
-  .option("--format <format>", "Output format: human|json", "human")
+  .option("--format <format>", 'Output format: human|json', "human")
   .option(
     "--show-suppressed",
     "Print suppressed violations in full detail (human only)",
-    false,
+    false
   )
   .action(async (options) => {
     const format = options.format;
@@ -73,7 +74,7 @@ program
         console.log(
           renderHumanReport(result.report, {
             showSuppressed: Boolean(options.showSuppressed),
-          }),
+          })
         );
       }
 
@@ -82,7 +83,7 @@ program
       const message = error instanceof Error ? error.message : String(error);
       if (format === "json") {
         console.log(
-          renderJsonError(`Internal error: ${message}`, ExitCode.INTERNAL_ERROR),
+          renderJsonError(`Internal error: ${message}`, ExitCode.INTERNAL_ERROR)
         );
       } else {
         console.error("Truss: Internal error");
@@ -92,4 +93,66 @@ program
     }
   });
 
+program
+  .command("graph")
+  .description("Render the repository dependency graph as DOT")
+  .option("-c, --config <path>", "Path to truss.yml", "truss.yml")
+  .option("--repo <path>", "Repo root", ".")
+  .option("--format <format>", 'Output format: dot', "dot")
+  .action(async (options) => {
+    const format = options.format;
+
+    try {
+      const repoRoot = path.resolve(options.repo);
+      const configPath = options.config;
+
+      if (format !== "dot") {
+        const msg = `Invalid --format value "${format}". Expected "dot".`;
+        console.error("Truss: Configuration error");
+        console.error(msg);
+        process.exitCode = ExitCode.CONFIG_ERROR;
+        return;
+      }
+
+      const {
+  config,
+  graph,
+} = runAnalysis({
+  repoRoot,
+  configPath,
+});
+
+      const result = await runCheck({
+  repoRoot,
+  configPath,
+  format: "human",
+  showSuppressed: false,
+});
+
+const violations =
+  "report" in result
+    ? result.report.unsuppressed.flatMap((v) =>
+        v.edge.importKind === "internal"
+          ? [
+              {
+                from: v.edge.fromFile,
+                to: v.edge.toFile,
+              },
+            ]
+          : []
+      )
+    : [];
+
+const dot = renderGraphAsDot(graph, config.layers, violations);
+
+      process.stdout.write(`${dot}\n`);
+      process.exitCode = ExitCode.OK;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error("Truss: Internal error");
+      console.error(message);
+      process.exitCode = ExitCode.INTERNAL_ERROR;
+    }
+  });
+
 program.parse(process.argv);

package-lock.json

@@ -15,10 +15,11 @@
   },
   "dependencies": {
     "commander": "^12.1.0",
+    "minimatch": "^10.2.5",
     "yaml": "^2.8.1"
   },
   "devDependencies": {
-    "@types/node": "^22.15.18",
+    "@types/node": "^22.19.17",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3"
   }

package.json

@@ -30,6 +30,15 @@ function formatYamlError(err: Error, shownPath: string): string {
   return `Invalid YAML in ${shownPath}. Fix the syntax and try again.`;
 }
 
+function normalizeLayerPattern(pattern: string): string {
+  const trimmed = pattern.trim().split(path.sep).join("/");
+
+  if (!trimmed) return trimmed;
+  if (trimmed.includes("*")) return trimmed;
+
+  return trimmed.endsWith("/") ? `${trimmed}**` : `${trimmed}/**`;
+}
+
 // Loads the YAML file, validates the required shape, and returns it as a typed config.
 export function loadTrussConfig(
   configPath: string,
@@ -83,6 +92,13 @@ export function loadTrussConfig(
     }
   }
 
+  const normalizedLayers = Object.fromEntries(
+  Object.entries(cfg.layers).map(([layerName, patterns]) => [
+    layerName,
+    patterns.map(normalizeLayerPattern),
+  ])
+);
+
   if (!cfg.rules || !Array.isArray(cfg.rules) || cfg.rules.length === 0) {
     throw new ConfigError(
       `No rules defined in ${shownPath}. Add at least one rule under "rules".`,
@@ -116,6 +132,13 @@ export function loadTrussConfig(
         `Rule "${r.name}" in ${shownPath} must define "disallow" as a non-empty string[].`,
       );
     }
+
+    if ("message" in r && r.message !== undefined && typeof r.message !== "string") {
+  throw new ConfigError(
+    `Rule "${r.name}" in ${shownPath} has invalid "message": expected a string.`,
+  );
+}
+
     for (const target of r.disallow) {
       if (!knownLayers.has(target)) {
         throw new ConfigError(
@@ -125,5 +148,8 @@ export function loadTrussConfig(
     }
   }
 
-  return cfg as TrussConfig;
+  return {
+  ...cfg,
+  layers: normalizedLayers,
+} as TrussConfig;
 }