dep-brain 0.2.0 → 0.2.1

package/README.md

@@ -41,6 +41,7 @@ dep-brain analyze
 
 npx dep-brain analyze
 npx dep-brain analyze --json
+npx dep-brain analyze --md
 npx dep-brain analyze ./path-to-project
 npx dep-brain analyze --config depbrain.config.json
 npx dep-brain analyze --min-score 90 --fail-on-risks
@@ -90,6 +91,12 @@ Suggestions:
 dep-brain analyze --json
 ```
 
+## Markdown Output
+
+```bash
+dep-brain analyze --md
+```
+
 ## Config File
 
 Create a `depbrain.config.json` file in the project root:

package/dist/cli.js

@@ -2,6 +2,7 @@
 import { analyzeProject } from "./core/analyzer.js";
 import { renderConsoleReport } from "./reporters/console.js";
 import { renderJsonReport } from "./reporters/json.js";
+import { renderMarkdownReport } from "./reporters/markdown.js";
 import { promises as fs } from "node:fs";
 import path from "node:path";
 async function main() {
@@ -80,6 +81,9 @@ async function main() {
         if (flags.has("--json")) {
             process.stdout.write(`${renderJsonReport(result)}\n`);
         }
+        else if (flags.has("--md")) {
+            process.stdout.write(`${renderMarkdownReport(result)}\n`);
+        }
         else {
             const output = renderConsoleReport(result);
             if (!output || output.trim().length === 0) {
@@ -144,13 +148,14 @@ function printHelp() {
     console.log("Dependency Brain");
     console.log("");
     console.log("Usage:");
-    console.log("  dep-brain analyze [path] [--json] [--config path] [--min-score n] [--fail-on-risks] [--fail-on-outdated] [--fail-on-unused] [--fail-on-duplicates]");
+    console.log("  dep-brain analyze [path] [--json] [--md] [--config path] [--min-score n] [--fail-on-risks] [--fail-on-outdated] [--fail-on-unused] [--fail-on-duplicates]");
     console.log("  dep-brain config [path] [--config path]");
     console.log("  dep-brain help");
     console.log("  dep-brain --version");
     console.log("");
     console.log("Options:");
     console.log("  --json              Output JSON for analysis");
+    console.log("  --md                Output Markdown report");
     console.log("  --config <path>     Path to depbrain.config.json");
     console.log("  --min-score <n>     Minimum score required to pass");
     console.log("  --fail-on-risks     Fail when risky dependencies exist");

package/dist/reporters/markdown.d.ts

@@ -0,0 +1,2 @@
+import type { AnalysisResult } from "../core/analyzer.js";
+export declare function renderMarkdownReport(result: AnalysisResult): string;

package/dist/reporters/markdown.js

@@ -0,0 +1,52 @@
+export function renderMarkdownReport(result) {
+    const lines = [];
+    lines.push(`# Dependency Brain Report`);
+    lines.push("");
+    lines.push(`- **Project Health:** ${result.score}/100`);
+    lines.push(`- **Path:** ${result.rootDir}`);
+    lines.push(`- **Policy:** ${result.policy.passed ? "PASS" : "FAIL"}`);
+    lines.push(`- **Score Breakdown:** base ${result.scoreBreakdown.baseScore} - dup ${result.scoreBreakdown.duplicates} - outdated ${result.scoreBreakdown.outdated} - unused ${result.scoreBreakdown.unused} - risk ${result.scoreBreakdown.risks}`);
+    lines.push("");
+    if (result.packages && result.packages.length > 0) {
+        lines.push("## Packages");
+        for (const pkg of result.packages) {
+            lines.push(`- ${pkg.name}: ${pkg.score}/100 (D:${pkg.duplicates.length} U:${pkg.unused.length} O:${pkg.outdated.length} R:${pkg.risks.length})`);
+        }
+        lines.push("");
+    }
+    lines.push("## Summary");
+    lines.push(`- Duplicates: ${result.duplicates.length}`);
+    lines.push(`- Unused: ${result.unused.length}`);
+    lines.push(`- Outdated: ${result.outdated.length}`);
+    lines.push(`- Risks: ${result.risks.length}`);
+    lines.push("");
+    appendSection(lines, "Duplicate dependencies", result.duplicates.map((item) => `${item.name}: ${item.versions.join(", ")}`));
+    appendSection(lines, "Unused dependencies", result.unused.map((item) => item.package
+        ? `${item.name} (${item.section}) [${item.package}]`
+        : `${item.name} (${item.section})`));
+    appendSection(lines, "Outdated dependencies", result.outdated.map((item) => item.package
+        ? `${item.name}: ${item.current} -> ${item.latest} [${item.updateType}] [${item.package}]`
+        : `${item.name}: ${item.current} -> ${item.latest} [${item.updateType}]`));
+    appendSection(lines, "Risky dependencies", result.risks.map((item) => item.package
+        ? `${item.name}: ${item.reasons.join("; ")} [${item.package}]`
+        : `${item.name}: ${item.reasons.join("; ")}`));
+    appendSection(lines, "Policy reasons", result.policy.reasons);
+    if (result.suggestions.length > 0) {
+        lines.push("## Suggestions");
+        for (const suggestion of result.suggestions) {
+            lines.push(`- ${suggestion}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function appendSection(lines, title, items) {
+    if (items.length === 0) {
+        return;
+    }
+    lines.push(`## ${title}`);
+    for (const item of items) {
+        lines.push(`- ${item}`);
+    }
+    lines.push("");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dep-brain",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "CLI and library for dependency health analysis",
   "type": "module",
   "main": "dist/index.js",