dep-brain 0.2.1 → 0.3.0

package/README.md

@@ -91,6 +91,10 @@ Suggestions:
 dep-brain analyze --json
 ```
 
+Output includes `outputVersion` for schema stability and can be validated with:
+
+- `depbrain.output.schema.json`
+
 ## Markdown Output
 
 ```bash
@@ -147,6 +151,7 @@ Sample config file:
 
 - `depbrain.config.json`
 - `depbrain.config.schema.json`
+- `depbrain.output.schema.json`
 
 ## CI Behavior
 

package/depbrain.output.schema.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Dependency Brain Analysis Output",
+  "type": "object",
+  "required": ["outputVersion", "rootDir", "score", "scoreBreakdown", "policy", "duplicates", "unused", "outdated", "risks", "suggestions", "config"],
+  "additionalProperties": false,
+  "properties": {
+    "outputVersion": { "type": "string" },
+    "rootDir": { "type": "string" },
+    "score": { "type": "number" },
+    "scoreBreakdown": {
+      "type": "object",
+      "required": ["baseScore", "duplicates", "outdated", "unused", "risks", "weights"],
+      "additionalProperties": false,
+      "properties": {
+        "baseScore": { "type": "number" },
+        "duplicates": { "type": "number" },
+        "outdated": { "type": "number" },
+        "unused": { "type": "number" },
+        "risks": { "type": "number" },
+        "weights": {
+          "type": "object",
+          "required": ["duplicateWeight", "outdatedWeight", "unusedWeight", "riskWeight"],
+          "additionalProperties": false,
+          "properties": {
+            "duplicateWeight": { "type": "number" },
+            "outdatedWeight": { "type": "number" },
+            "unusedWeight": { "type": "number" },
+            "riskWeight": { "type": "number" }
+          }
+        }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "required": ["passed", "reasons"],
+      "additionalProperties": false,
+      "properties": {
+        "passed": { "type": "boolean" },
+        "reasons": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "duplicates": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "versions", "instances"],
+        "additionalProperties": false,
+        "properties": {
+          "name": { "type": "string" },
+          "versions": { "type": "array", "items": { "type": "string" } },
+          "instances": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["path", "version"],
+              "additionalProperties": false,
+              "properties": {
+                "path": { "type": "string" },
+                "version": { "type": "string" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "unused": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "section"],
+        "additionalProperties": false,
+        "properties": {
+          "name": { "type": "string" },
+          "section": { "type": "string", "enum": ["dependencies", "devDependencies"] },
+          "package": { "type": "string" }
+        }
+      }
+    },
+    "outdated": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "current", "latest", "updateType"],
+        "additionalProperties": false,
+        "properties": {
+          "name": { "type": "string" },
+          "current": { "type": "string" },
+          "latest": { "type": "string" },
+          "updateType": { "type": "string" },
+          "package": { "type": "string" }
+        }
+      }
+    },
+    "risks": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "reasons"],
+        "additionalProperties": false,
+        "properties": {
+          "name": { "type": "string" },
+          "reasons": { "type": "array", "items": { "type": "string" } },
+          "package": { "type": "string" }
+        }
+      }
+    },
+    "suggestions": { "type": "array", "items": { "type": "string" } },
+    "config": { "type": "object" },
+    "packages": { "type": "array" }
+  }
+}

package/dist/core/analyzer.d.ts

@@ -31,6 +31,7 @@ export interface RiskDependency {
     package?: string;
 }
 export interface AnalysisResult {
+    outputVersion: string;
     rootDir: string;
     score: number;
     scoreBreakdown: ScoreBreakdown;
@@ -59,6 +60,7 @@ export interface PackageAnalysisResult {
     risks: RiskDependency[];
     suggestions: string[];
 }
+export declare const OUTPUT_VERSION = "1.0";
 export interface ScoreBreakdown {
     baseScore: number;
     duplicates: number;

package/dist/core/analyzer.js

@@ -7,6 +7,7 @@ import { loadDepBrainConfig } from "../utils/config.js";
 import { findWorkspacePackages } from "../utils/workspaces.js";
 import { buildDependencyGraph } from "./graph-builder.js";
 import { calculateHealthScore } from "./scorer.js";
+export const OUTPUT_VERSION = "1.0";
 export async function analyzeProject(options = {}) {
     const rootDir = path.resolve(options.rootDir ?? process.cwd());
     const loadedConfig = await loadDepBrainConfig(rootDir, options.configPath);
@@ -55,6 +56,7 @@ export async function analyzeProject(options = {}) {
         risks: risks.length
     }, config);
     return {
+        outputVersion: OUTPUT_VERSION,
         rootDir,
         score,
         scoreBreakdown,
@@ -172,6 +174,7 @@ async function analyzeSingleProject(rootDir, config, options = {}) {
         ? risks.map((item) => ({ ...item, package: options.packageName }))
         : risks;
     return {
+        outputVersion: OUTPUT_VERSION,
         rootDir,
         score,
         scoreBreakdown,

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { analyzeProject } from "./core/analyzer.js";
 export type { AnalysisOptions, AnalysisResult, DuplicateDependency, OutdatedDependency, PolicyResult, PackageAnalysisResult, ScoreBreakdown, RiskDependency, UnusedDependency } from "./core/analyzer.js";
+export { OUTPUT_VERSION } from "./core/analyzer.js";
 export type { DepBrainConfig, DepBrainConfigOverrides } from "./utils/config.js";
 export type { WorkspacePackage } from "./utils/workspaces.js";

package/dist/index.js

@@ -1 +1,2 @@
 export { analyzeProject } from "./core/analyzer.js";
+export { OUTPUT_VERSION } from "./core/analyzer.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dep-brain",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "CLI and library for dependency health analysis",
   "type": "module",
   "main": "dist/index.js",
@@ -14,7 +14,8 @@
     "LICENSE",
     "CHANGELOG.md",
     "depbrain.config.json",
-    "depbrain.config.schema.json"
+    "depbrain.config.schema.json",
+    "depbrain.output.schema.json"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",