@rsdk/depdoc.cli 6.0.0-next.42 → 6.0.0-next.44

package/dist/model/types.d.ts

@@ -16,8 +16,14 @@ export interface DependencyRule {
     rootOnly?: boolean;
     required?: boolean;
 }
+export interface ToolingFileRule {
+    match: string | string[];
+    workspace?: string | string[];
+}
 export interface DependencyModelConfig {
     version?: number;
+    ignoredImports?: string[];
+    toolingFiles?: ToolingFileRule[];
     rules?: DependencyRule[];
     doctor?: DoctorConfig;
 }
@@ -33,7 +39,7 @@ export interface DependencyModelOptions {
     withDts?: boolean;
 }
 export interface DependencyViolation {
-    code: 'root-private' | 'root-section' | 'role-missing' | 'role-invalid' | 'forbidden-section' | 'missing' | 'wrong-section' | 'wrong-range' | 'root-only' | 'root-only-usage' | 'unconstrained-version' | 'mirror' | 'stale' | 'dist-missing';
+    code: 'root-private' | 'root-section' | 'role-missing' | 'role-invalid' | 'forbidden-section' | 'missing' | 'wrong-section' | 'wrong-range' | 'root-only' | 'root-only-usage' | 'unconstrained-version' | 'stale-rule' | 'mirror' | 'stale' | 'dist-missing';
     workspace: string;
     workspaceLocation: string;
     dependency?: string | undefined;
@@ -66,6 +72,7 @@ export interface WorkspaceFacts {
     hasSrc: boolean;
     hasDist: boolean;
     sourceFileCount?: number;
+    toolingFiles?: Set<string>;
 }
 export interface WorkspaceContext extends WorkspaceFacts {
     dir: string;

package/dist/model/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/model/types.ts"],"names":[],"mappings":";;;AAgKa,QAAA,QAAQ,GAAkB;IACrC,cAAc;IACd,kBAAkB;IAClB,iBAAiB;CAClB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/model/types.ts"],"names":[],"mappings":";;;AAgLa,QAAA,QAAQ,GAAkB;IACrC,cAAc;IACd,kBAAkB;IAClB,iBAAiB;CAClB,CAAC"}

package/dist/runner.js

@@ -24,7 +24,7 @@ function runDependencyModel(options = {}) {
     const config = (0, config_1.loadConfig)(rootDir, options.depdocYamlPath);
     const rules = config.rules ?? [];
     const withDts = options.withDts === true;
-    const contexts = (0, workspaces_1.loadWorkspaces)(rootDir, withDts);
+    const contexts = (0, workspaces_1.loadWorkspaces)(rootDir, withDts, config.ignoredImports ?? [], config.toolingFiles ?? []);
     const packageExtensions = (0, package_extensions_1.loadPackageExtensions)(rootDir);
     const workspaceNames = new Set(contexts.filter((ws) => !ws.isRoot).map((ws) => ws.name));
     const typeProviderPackages = (0, type_providers_1.collectTypeProviderPackages)(rootDir, contexts[0].pkg, rules);

package/dist/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rsdk/depdoc.cli",
   "role": "cli",
-  "version": "6.0.0-next.42",
+  "version": "6.0.0-next.44",
   "description": "CLI for monorepo dependency management",
   "license": "Apache License 2.0",
   "publishConfig": {
@@ -18,5 +18,5 @@
     "typescript": "5.7.3",
     "yaml": "^2.6.1"
   },
-  "gitHead": "ec9e809168d3d70d2bf12f93309b6bc5c5334cf3"
+  "gitHead": "6cd75fef09ff91a5aa7963717efee5734f9bd6b5"
 }

package/src/collectors/tsconfig-aliases.ts

@@ -0,0 +1,45 @@
+/**
+ * TypeScript path alias collector.
+ *
+ * Depdoc treats `compilerOptions.paths` entries as internal module specifiers:
+ * they are resolved by TypeScript/bundlers, not package manager dependencies.
+ */
+import { type Dirent, readdirSync } from 'node:fs';
+import path from 'node:path';
+import ts = require('typescript');
+
+const TSCONFIG_RE = /^tsconfig(?:\..*)?\.json$/;
+
+export function collectTsConfigPathAliases(workspaceDir: string): string[] {
+  const aliases = new Set<string>();
+
+  let entries: Dirent[];
+
+  try {
+    entries = readdirSync(workspaceDir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+
+  for (const entry of entries) {
+    if (!entry.isFile() || !TSCONFIG_RE.test(entry.name)) continue;
+
+    const configPath = path.join(workspaceDir, entry.name);
+    const config = ts.readConfigFile(configPath, ts.sys.readFile);
+    if (config.error || !config.config) continue;
+
+    const parsed = ts.parseJsonConfigFileContent(
+      config.config,
+      ts.sys,
+      path.dirname(configPath),
+      undefined,
+      configPath,
+    );
+
+    for (const alias of Object.keys(parsed.options.paths ?? {})) {
+      aliases.add(alias);
+    }
+  }
+
+  return [...aliases].sort();
+}

package/src/collectors/workspaces.ts

@@ -11,24 +11,60 @@ import path from 'node:path';
 
 import {
   collectDtsImports,
+  collectRootConfigFiles,
   collectSourceFiles,
   collectSourceImportsFromFiles,
 } from '../lib/imports';
 import { readPackageJson } from '../lib/package-json';
-import { isWorkspaceRole } from '../model/rules';
-import type { WorkspaceContext } from '../model/types';
+import { isWorkspaceRole, matchesPatterns } from '../model/rules';
+import type { ToolingFileRule, WorkspaceContext } from '../model/types';
+
+import { collectTsConfigPathAliases } from './tsconfig-aliases';
 
 interface YarnWorkspaceInfo {
   location: string;
   name: string | null;
 }
 
-function collectUsage(workspace: WorkspaceContext, withDts: boolean): void {
-  const sourceFiles = collectSourceFiles(workspace.dir, workspace.pkg);
+function getToolingPatternsForWorkspace(
+  toolingFileRules: readonly ToolingFileRule[],
+  wsName: string,
+  wsLocation: string,
+): string[] {
+  return toolingFileRules
+    .filter(
+      (rule) =>
+        !rule.workspace ||
+        matchesPatterns(wsName, rule.workspace) ||
+        matchesPatterns(wsLocation, rule.workspace),
+    )
+    .flatMap((rule) => (Array.isArray(rule.match) ? rule.match : [rule.match]));
+}
+
+function collectUsage(
+  workspace: WorkspaceContext,
+  withDts: boolean,
+  ignoredImports: readonly string[],
+  toolingFilePatterns: readonly string[],
+): void {
+  const sourceFiles = collectSourceFiles(
+    workspace.dir,
+    workspace.pkg,
+    toolingFilePatterns,
+  );
+  const ignoredSpecifiers = [
+    ...ignoredImports,
+    ...collectTsConfigPathAliases(workspace.dir),
+  ];
 
   workspace.sourceFileCount = sourceFiles.length;
+  workspace.toolingFiles = new Set(
+    collectRootConfigFiles(workspace.dir, toolingFilePatterns),
+  );
 
-  for (const entry of collectSourceImportsFromFiles(sourceFiles)) {
+  for (const entry of collectSourceImportsFromFiles(sourceFiles, {
+    ignoredSpecifiers,
+  })) {
     if (!workspace.sourceUsage.has(entry.packageName)) {
       workspace.sourceUsage.set(entry.packageName, {
         files: new Set(),
@@ -48,13 +84,15 @@ function collectUsage(workspace: WorkspaceContext, withDts: boolean): void {
 
   const distDir = path.join(workspace.dir, 'dist');
   if (withDts || existsSync(distDir)) {
-    workspace.dtsImports = collectDtsImports(distDir);
+    workspace.dtsImports = collectDtsImports(distDir, { ignoredSpecifiers });
   }
 }
 
 export function loadWorkspaces(
   rootDir: string,
   withDts: boolean,
+  ignoredImports: readonly string[] = [],
+  toolingFileRules: readonly ToolingFileRule[] = [],
 ): WorkspaceContext[] {
   const rootPkg = readPackageJson(rootDir);
   const raw = execSync('yarn workspaces list --json', {
@@ -99,7 +137,12 @@ export function loadWorkspaces(
       hasDist: existsSync(path.join(dir, 'dist')),
     };
 
-    collectUsage(ctx, withDts);
+    collectUsage(
+      ctx,
+      withDts,
+      ignoredImports,
+      getToolingPatternsForWorkspace(toolingFileRules, ctx.name, ctx.location),
+    );
     workspaces.push(ctx);
   }
 

package/src/lib/imports.ts

@@ -5,7 +5,7 @@
  * import facts. They do not decide dependency placement; they only normalize
  * specifiers and classify imports as runtime or type-only.
  */
-import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { type Dirent,existsSync, readdirSync, readFileSync } from 'node:fs';
 import { builtinModules } from 'node:module';
 import path from 'node:path';
 import ts = require('typescript');
@@ -18,6 +18,10 @@ export interface ImportEntry {
   file: string;
 }
 
+export interface ImportCollectionOptions {
+  ignoredSpecifiers?: readonly string[];
+}
+
 interface ModuleReference {
   specifier: string;
   isTypeOnly: boolean;
@@ -41,6 +45,23 @@ const SOURCE_EXTENSIONS = new Set([
 
 const DTS_RE = /\.d\.(?:c|m)?ts$/;
 const DEFAULT_SOURCE_ROOTS = ['src', 'test', 'tests', '__tests__'];
+
+// Build-tool config files conventionally live at the workspace root, outside
+// src/, but still import real runtime dependencies (e.g. vite.config.ts,
+// docusaurus.config.ts). They are scanned non-recursively so unrelated root
+// files aren't picked up. Filenames that don't follow this convention (e.g.
+// Docusaurus' sidebars.ts) aren't matched by default — declare them via
+// depdoc.yml's `toolingFiles` instead.
+const ROOT_CONFIG_FILE_SUFFIXES = [
+  '.config.ts',
+  '.config.tsx',
+  '.config.js',
+  '.config.jsx',
+  '.config.mjs',
+  '.config.cjs',
+  '.config.mts',
+  '.config.cts',
+];
 const IGNORED_ENTRYPOINT_DIRS = new Set([
   'node_modules',
   'dist',
@@ -74,6 +95,30 @@ export function getPackageName(specifier: string): string | null {
   return slash === -1 ? specifier : specifier.slice(0, slash);
 }
 
+function globToRegExp(pattern: string): RegExp {
+  const escaped = pattern.replaceAll(
+    /[-[\]{}()+?.,\\^$|#\s]/g,
+    String.raw`\$&`,
+  );
+
+  return new RegExp(`^${escaped.replaceAll('*', '.*')}$`);
+}
+
+function matchesSpecifierPattern(specifier: string, pattern: string): boolean {
+  return pattern.includes('*')
+    ? globToRegExp(pattern).test(specifier)
+    : specifier === pattern;
+}
+
+function isIgnoredSpecifier(
+  specifier: string,
+  options: ImportCollectionOptions,
+): boolean {
+  return (options.ignoredSpecifiers ?? []).some((pattern) =>
+    matchesSpecifierPattern(specifier, pattern),
+  );
+}
+
 function walkFiles(dir: string, filter: (name: string) => boolean): string[] {
   const results: string[] = [];
 
@@ -133,9 +178,12 @@ function addImport(
   file: string,
   specifier: string,
   isTypeOnly: boolean,
+  options: ImportCollectionOptions,
 ): void {
+  if (isIgnoredSpecifier(specifier, options)) return;
   const packageName = getPackageName(specifier);
   if (!packageName) return;
+  if (isIgnoredSpecifier(packageName, options)) return;
   results.push({ packageName, isTypeOnly, file });
 }
 
@@ -202,13 +250,16 @@ function extractModuleReferences(
   const visit = (node: ts.Node): void => {
     if (ts.isImportDeclaration(node)) {
       const specifier = stringLiteralText(node.moduleSpecifier);
+
       addModuleReference(results, specifier, isImportDeclarationTypeOnly(node));
     } else if (ts.isExportDeclaration(node)) {
       const specifier = stringLiteralText(node.moduleSpecifier);
+
       addModuleReference(results, specifier, isExportDeclarationTypeOnly(node));
     } else if (ts.isImportEqualsDeclaration(node)) {
       if (ts.isExternalModuleReference(node.moduleReference)) {
         const specifier = collectExternalModuleReference(node.moduleReference);
+
         addModuleReference(results, specifier, node.isTypeOnly);
       }
     } else if (ts.isCallExpression(node)) {
@@ -217,6 +268,7 @@ function extractModuleReferences(
         node.arguments.length === 1
       ) {
         const specifier = stringLiteralText(node.arguments[0]);
+
         addModuleReference(results, specifier, false);
       } else if (
         ts.isIdentifier(node.expression) &&
@@ -224,12 +276,14 @@ function extractModuleReferences(
         node.arguments.length === 1
       ) {
         const specifier = stringLiteralText(node.arguments[0]);
+
         addModuleReference(results, specifier, false);
       }
     } else if (ts.isImportTypeNode(node)) {
       const argument = node.argument;
       if (ts.isLiteralTypeNode(argument)) {
         const specifier = stringLiteralText(argument.literal);
+
         addModuleReference(results, specifier, true);
       }
     } else if (
@@ -250,12 +304,18 @@ function extractModuleReferences(
 function extractImports(
   file: string,
   content: string,
-  options: { includeDtsForms?: boolean } = {},
+  options: ImportCollectionOptions & { includeDtsForms?: boolean } = {},
 ): ImportEntry[] {
   const results: ImportEntry[] = [];
 
   for (const reference of extractModuleReferences(file, content, options)) {
-    addImport(results, file, reference.specifier, reference.isTypeOnly);
+    addImport(
+      results,
+      file,
+      reference.specifier,
+      reference.isTypeOnly,
+      options,
+    );
   }
 
   return results;
@@ -379,9 +439,39 @@ function collectEntrypointGraphFiles(
   return [...result];
 }
 
+export function isRootConfigFile(
+  name: string,
+  extraPatterns: readonly string[] = [],
+): boolean {
+  return (
+    ROOT_CONFIG_FILE_SUFFIXES.some((suffix) => name.endsWith(suffix)) ||
+    extraPatterns.some((pattern) => matchesSpecifierPattern(name, pattern))
+  );
+}
+
+export function collectRootConfigFiles(
+  workspaceDir: string,
+  extraPatterns: readonly string[] = [],
+): string[] {
+  let entries: Dirent[];
+
+  try {
+    entries = readdirSync(workspaceDir, { withFileTypes: true });
+  } catch {
+    return [];
+  }
+
+  return entries
+    .filter(
+      (entry) => entry.isFile() && isRootConfigFile(entry.name, extraPatterns),
+    )
+    .map((entry) => path.join(workspaceDir, entry.name));
+}
+
 export function collectSourceFiles(
   srcDirOrWorkspaceDir: string,
   pkg?: PackageJson,
+  toolingFilePatterns: readonly string[] = [],
 ): string[] {
   if (!pkg) return walkFiles(srcDirOrWorkspaceDir, (name) => isSourceFile(name));
 
@@ -396,6 +486,13 @@ export function collectSourceFiles(
     }
   }
 
+  for (const file of collectRootConfigFiles(
+    srcDirOrWorkspaceDir,
+    toolingFilePatterns,
+  )) {
+    files.add(file);
+  }
+
   for (const file of collectEntrypointGraphFiles(srcDirOrWorkspaceDir, pkg)) {
     files.add(file);
   }
@@ -403,22 +500,31 @@ export function collectSourceFiles(
   return [...files].sort();
 }
 
-export function collectSourceImportsFromFiles(files: string[]): ImportEntry[] {
+export function collectSourceImportsFromFiles(
+  files: string[],
+  options: ImportCollectionOptions = {},
+): ImportEntry[] {
   return files.flatMap((file) =>
-    extractImports(file, readFileSync(file, 'utf8')),
+    extractImports(file, readFileSync(file, 'utf8'), options),
   );
 }
 
 export function collectSourceImports(
   srcDirOrWorkspaceDir: string,
   pkg?: PackageJson,
+  options: ImportCollectionOptions = {},
+  toolingFilePatterns: readonly string[] = [],
 ): ImportEntry[] {
   return collectSourceImportsFromFiles(
-    collectSourceFiles(srcDirOrWorkspaceDir, pkg),
+    collectSourceFiles(srcDirOrWorkspaceDir, pkg, toolingFilePatterns),
+    options,
   );
 }
 
-export function collectDtsImports(distDir: string): Set<string> {
+export function collectDtsImports(
+  distDir: string,
+  options: ImportCollectionOptions = {},
+): Set<string> {
   const files = walkFiles(distDir, (name) => DTS_RE.test(name));
   const result = new Set<string>();
 
@@ -426,7 +532,7 @@ export function collectDtsImports(distDir: string): Set<string> {
     for (const { packageName } of extractImports(
       file,
       readFileSync(file, 'utf8'),
-      { includeDtsForms: true },
+      { ...options, includeDtsForms: true },
     )) {
       result.add(packageName);
     }

package/src/model/config-validation.ts

@@ -1,9 +1,13 @@
 /**
  * Config validation for rule shapes that the model cannot interpret safely.
  */
-import type { DependencyModelConfig, DependencyRule } from './types';
+import type {
+  DependencyModelConfig,
+  DependencyRule,
+  ToolingFileRule,
+} from './types';
 
-function getRuleMatches(rule: DependencyRule): string[] {
+function getRuleMatches(rule: DependencyRule | ToolingFileRule): string[] {
   return Array.isArray(rule.match) ? rule.match : [rule.match];
 }
 
@@ -34,10 +38,65 @@ export function validateDependencyRules(rules: DependencyRule[]): string[] {
   return errors;
 }
 
+export function validateIgnoredImports(ignoredImports: unknown): string[] {
+  if (ignoredImports === undefined) return [];
+  if (!Array.isArray(ignoredImports)) {
+    return ['ignoredImports must be an array of module specifier patterns'];
+  }
+
+  return ignoredImports.flatMap((item, index) =>
+    typeof item === 'string'
+      ? []
+      : [`ignoredImports[${index}] must be a string`],
+  );
+}
+
+function isStringOrStringArray(value: unknown): boolean {
+  return (
+    typeof value === 'string' ||
+    (Array.isArray(value) && value.every((item) => typeof item === 'string'))
+  );
+}
+
+export function validateToolingFiles(toolingFiles: unknown): string[] {
+  if (toolingFiles === undefined) return [];
+  if (!Array.isArray(toolingFiles)) {
+    return ['toolingFiles must be an array of { match, workspace? } rules'];
+  }
+
+  return toolingFiles.flatMap((item, index) => {
+    const label = `toolingFiles[${index}]`;
+    if (typeof item !== 'object' || item === null) {
+      return [`${label} must be an object with a match field`];
+    }
+
+    const rule = item as Record<string, unknown>;
+    const errors: string[] = [];
+
+    if (!isStringOrStringArray(rule.match)) {
+      errors.push(`${label}.match must be a string or an array of strings`);
+    }
+    if (
+      rule.workspace !== undefined &&
+      !isStringOrStringArray(rule.workspace)
+    ) {
+      errors.push(
+        `${label}.workspace must be a string or an array of strings`,
+      );
+    }
+
+    return errors;
+  });
+}
+
 export function assertValidDependencyModelConfig(
   config: DependencyModelConfig,
 ): void {
-  const errors = validateDependencyRules(config.rules ?? []);
+  const errors = [
+    ...validateDependencyRules(config.rules ?? []),
+    ...validateIgnoredImports(config.ignoredImports),
+    ...validateToolingFiles(config.toolingFiles),
+  ];
 
   if (errors.length === 0) return;
 

package/src/model/diagnostics.ts

@@ -12,7 +12,7 @@ import {
   getExpectedSection,
 } from './expected';
 import { isExternal } from './placement';
-import { getEffectiveRule, isWorkspaceRole } from './rules';
+import { getEffectiveRule, isWorkspaceRole, matchesPatterns } from './rules';
 import type {
   DependencyRule,
   DependencyViolation,
@@ -42,6 +42,57 @@ function hasCollectedPackageUsage(workspace: WorkspaceFacts): boolean {
   return workspace.sourceUsage.size > 0 || workspace.dtsImports.size > 0;
 }
 
+function getRuleMatches(rule: DependencyRule): string[] {
+  return Array.isArray(rule.match) ? rule.match : [rule.match];
+}
+
+function getConcreteRuleMatches(rule: DependencyRule): string[] {
+  return getRuleMatches(rule).filter((match) => !match.includes('*'));
+}
+
+function getWorkspacePatternLabel(rule: DependencyRule): string {
+  if (!rule.workspace) return '<all>';
+
+  return Array.isArray(rule.workspace)
+    ? rule.workspace.join(', ')
+    : rule.workspace;
+}
+
+function getRuleTargetWorkspaces(
+  rule: DependencyRule,
+  workspaces: WorkspaceFacts[],
+): WorkspaceFacts[] {
+  if (!rule.workspace) return workspaces;
+
+  return workspaces.filter(
+    (workspace) =>
+      matchesPatterns(workspace.name, rule.workspace!) ||
+      matchesPatterns(workspace.location, rule.workspace!),
+  );
+}
+
+function expectedHasDependency(
+  expected: ExpectedWorkspace | undefined,
+  depIdent: string,
+): boolean {
+  if (!expected) return false;
+
+  return SECTIONS.some((section) => expected.sections[section].has(depIdent));
+}
+
+function workspaceHasDependencySignal(
+  workspace: WorkspaceFacts,
+  expected: ExpectedWorkspace | undefined,
+  depIdent: string,
+): boolean {
+  return (
+    workspace.sourceUsage.has(depIdent) ||
+    workspace.dtsImports.has(depIdent) ||
+    collectActualDependencyNames(workspace).has(depIdent) ||
+    expectedHasDependency(expected, depIdent)
+  );
+}
+
 export function compareManifest(
   expected: ExpectedWorkspace,
   violations: DependencyViolation[],
@@ -330,6 +381,59 @@ export function validateBasicShape(
   }
 }
 
+export function collectStaleRuleViolations(
+  workspaces: WorkspaceFacts[],
+  expectedByLocation: Map<string, ExpectedWorkspace>,
+  rules: DependencyRule[],
+): DependencyViolation[] {
+  const violations: DependencyViolation[] = [];
+
+  rules.forEach((rule) => {
+    const concreteMatches = getConcreteRuleMatches(rule);
+    if (concreteMatches.length === 0) return;
+
+    const targetWorkspaces = getRuleTargetWorkspaces(rule, workspaces);
+    const workspaceLabel = getWorkspacePatternLabel(rule);
+
+    for (const depIdent of concreteMatches) {
+      if (targetWorkspaces.length === 0) {
+        violations.push({
+          code: 'stale-rule',
+          workspace: '<root>',
+          workspaceLocation: '.',
+          dependency: depIdent,
+          message:
+            `${depIdent} has a workspace-scoped depdoc.yml rule, but no workspace matches ${workspaceLabel}`,
+        });
+        continue;
+      }
+
+      const isUsed = targetWorkspaces.some((workspace) =>
+        workspaceHasDependencySignal(
+          workspace,
+          expectedByLocation.get(workspace.location),
+          depIdent,
+        ),
+      );
+      if (isUsed) continue;
+
+      const workspace = rule.workspace ? targetWorkspaces[0]! : workspaces[0]!;
+
+      violations.push({
+        code: 'stale-rule',
+        workspace: rule.workspace ? getWorkspaceLabel(workspace) : '<root>',
+        workspaceLocation: rule.workspace ? workspace.location : '.',
+        dependency: depIdent,
+        message: rule.workspace
+          ? `${depIdent} has a depdoc.yml rule scoped to ${workspaceLabel}, but no matching usage or declaration was found`
+          : `${depIdent} has a depdoc.yml rule, but no matching usage or declaration was found`,
+      });
+    }
+  });
+
+  return violations;
+}
+
 export function dedupeViolations(
   violations: DependencyViolation[],
 ): DependencyViolation[] {

package/src/model/engine.ts

@@ -5,7 +5,12 @@
  * diagnostics. It must not read files, execute Yarn, or inspect `node_modules`;
  * those concerns belong to collectors and the runner.
  */
-import { compareManifest, dedupeViolations, validateBasicShape } from './diagnostics';
+import {
+  collectStaleRuleViolations,
+  compareManifest,
+  dedupeViolations,
+  validateBasicShape,
+} from './diagnostics';
 import { emptySections } from './expected';
 import { propagatePeers } from './peer-propagation';
 import {
@@ -111,6 +116,7 @@ export function deriveDependencyModel(
   violations.push(
     ...collectUnconstrainedVersionViolations(workspaces, expected, rules),
   );
+  violations.push(...collectStaleRuleViolations(workspaces, expected, rules));
 
   return {
     violations: dedupeViolations(violations),