nestjs-doctor 0.4.10 → 0.4.12

package/README.md

@@ -41,7 +41,7 @@ npx nestjs-doctor@latest . --verbose
 npx nestjs-doctor@latest . --report
 ```
 
-Generates a self-contained HTML file with four tabs: **Summary** (health score overview), **Diagnosis** (source-level findings), **Modules Graph** (interactive physics-based visualization), and **Lab** (custom rule playground). Click any module to focus it — unrelated modules fade out and the detail panel shows its providers, controllers, imports, and exports.
+Self-contained HTML file with four sections: score summary, source-level diagnostics with code viewer, interactive module graph, and a custom rule playground. Opens in your browser.
 
 ![Module Graph](https://nestjs.doctor/module-graph.png)
 
@@ -110,6 +110,15 @@ npx nestjs-doctor --init
 
 A project-level fallback is always written to `.agents/nestjs-doctor/`. Commit it so every contributor gets the skill automatically.
 
+### Skills
+
+`--init` installs two skills per agent:
+
+| Skill | Command | Description |
+|-------|---------|-------------|
+| nestjs-doctor | `/nestjs-doctor` | Runs the scan, shows the report, and fixes what it can |
+| nestjs-doctor-create-rule | `/nestjs-doctor-create-rule` | Scaffolds a custom rule: checks feasibility, writes the `.ts` file, updates config, verifies it loads |
+
 ---
 
 ## Configuration

package/dist/api/index.cjs

@@ -176,49 +176,78 @@ function isProjectRule(rule) {
 
 //#endregion
 //#region src/engine/rule-runner.ts
-function runRules(project, files, rules, options) {
-	const diagnostics = [];
-	const errors = [];
+function separateRules(rules) {
 	const fileRules = [];
 	const projectRules = [];
 	for (const rule of rules) if (isProjectRule(rule)) projectRules.push(rule);
 	else fileRules.push(rule);
-	for (const filePath of files) {
-		const sourceFile = project.getSourceFile(filePath);
-		if (!sourceFile) continue;
-		const allLines = sourceFile.getFullText().split("\n");
-		for (const rule of fileRules) {
-			const context = {
-				sourceFile,
-				filePath,
-				report(partial) {
-					const sourceLines = [];
-					const start = Math.max(0, partial.line - 6);
-					const end = Math.min(allLines.length, partial.line + 5);
-					for (let i = start; i < end; i++) sourceLines.push({
-						line: i + 1,
-						text: allLines[i]
-					});
-					diagnostics.push({
-						...partial,
-						rule: rule.meta.id,
-						category: rule.meta.category,
-						severity: rule.meta.severity,
-						sourceLines
-					});
-				}
-			};
-			try {
-				rule.check(context);
-			} catch (error) {
-				errors.push({
-					ruleId: rule.meta.id,
-					error
+	return {
+		fileRules,
+		projectRules
+	};
+}
+function runFileRulesOnFile(project, filePath, rules) {
+	const diagnostics = [];
+	const errors = [];
+	const sourceFile = project.getSourceFile(filePath);
+	if (!sourceFile) return {
+		diagnostics,
+		errors
+	};
+	const allLines = sourceFile.getFullText().split("\n");
+	for (const rule of rules) {
+		const context = {
+			sourceFile,
+			filePath,
+			report(partial) {
+				const sourceLines = [];
+				const start = Math.max(0, partial.line - 6);
+				const end = Math.min(allLines.length, partial.line + 5);
+				for (let i = start; i < end; i++) sourceLines.push({
+					line: i + 1,
+					text: allLines[i]
+				});
+				diagnostics.push({
+					...partial,
+					rule: rule.meta.id,
+					category: rule.meta.category,
+					scope: "file",
+					severity: rule.meta.severity,
+					sourceLines
 				});
 			}
+		};
+		try {
+			rule.check(context);
+		} catch (error) {
+			errors.push({
+				ruleId: rule.meta.id,
+				error
+			});
 		}
 	}
-	for (const rule of projectRules) {
+	return {
+		diagnostics,
+		errors
+	};
+}
+function runFileRules(project, files, rules) {
+	const diagnostics = [];
+	const errors = [];
+	for (const filePath of files) {
+		const result = runFileRulesOnFile(project, filePath, rules);
+		diagnostics.push(...result.diagnostics);
+		errors.push(...result.errors);
+	}
+	return {
+		diagnostics,
+		errors
+	};
+}
+function runProjectRules(project, files, rules, options) {
+	const diagnostics = [];
+	const errors = [];
+	for (const rule of rules) {
 		const context = {
 			project,
 			files,
@@ -230,6 +259,7 @@ function runRules(project, files, rules, options) {
 					...partial,
 					rule: rule.meta.id,
 					category: rule.meta.category,
+					scope: "project",
 					severity: rule.meta.severity
 				});
 			}
@@ -248,6 +278,15 @@ function runRules(project, files, rules, options) {
 		errors
 	};
 }
+function runRules(project, files, rules, options) {
+	const { fileRules, projectRules } = separateRules(rules);
+	const fileResult = runFileRules(project, files, fileRules);
+	const projectResult = runProjectRules(project, files, projectRules, options);
+	return {
+		diagnostics: [...fileResult.diagnostics, ...projectResult.diagnostics],
+		errors: [...fileResult.errors, ...projectResult.errors]
+	};
+}
 
 //#endregion
 //#region src/engine/type-resolver.ts
@@ -2449,28 +2488,82 @@ function formatRuleError(error) {
 	if (error instanceof Error) return error.message;
 	return String(error);
 }
-async function scan(targetPath, options = {}) {
-	const startTime = node_perf_hooks.performance.now();
+async function prepareScan(targetPath, options = {}) {
 	const config = await loadConfig(targetPath, options.config);
 	const { rules: customRules, warnings: customRuleWarnings } = await resolveCustomRules(config, targetPath);
 	const combinedRules = mergeRules(allRules, customRules, customRuleWarnings);
-	const project = await detectProject(targetPath);
 	const files = await collectFiles(targetPath, config);
 	const astProject = createAstParser(files);
 	const moduleGraph = buildModuleGraph(astProject, files);
 	const providers = resolveProviders(astProject, files);
-	const { diagnostics: rawDiagnostics, errors } = runRules(astProject, files, filterRules(config, combinedRules), {
-		moduleGraph,
-		providers,
-		config
-	});
-	const diagnostics = filterIgnoredDiagnostics(rawDiagnostics, config, targetPath);
-	const score = calculateScore(diagnostics, files.length);
+	const { fileRules, projectRules } = separateRules(filterRules(config, combinedRules));
+	return {
+		context: {
+			astProject,
+			config,
+			fileRules,
+			files,
+			moduleGraph,
+			projectRules,
+			providers,
+			targetPath
+		},
+		customRuleWarnings
+	};
+}
+function updateFile(context, filePath) {
+	const existing = context.astProject.getSourceFile(filePath);
+	if (existing) context.astProject.removeSourceFile(existing);
+	context.astProject.addSourceFileAtPath(filePath);
+	if (!context.files.includes(filePath)) context.files.push(filePath);
+	context.moduleGraph = buildModuleGraph(context.astProject, context.files);
+	context.providers = resolveProviders(context.astProject, context.files);
+}
+function scanFile(context, filePath) {
+	const { diagnostics: rawDiagnostics, errors } = runFileRules(context.astProject, [filePath], context.fileRules);
+	return {
+		diagnostics: filterIgnoredDiagnostics(rawDiagnostics, context.config, context.targetPath),
+		errors: errors.map((e) => ({
+			ruleId: e.ruleId,
+			error: formatRuleError(e.error)
+		}))
+	};
+}
+function scanAllFiles(context) {
+	const { diagnostics: rawDiagnostics, errors } = runFileRules(context.astProject, context.files, context.fileRules);
+	return {
+		diagnostics: filterIgnoredDiagnostics(rawDiagnostics, context.config, context.targetPath),
+		errors: errors.map((e) => ({
+			ruleId: e.ruleId,
+			error: formatRuleError(e.error)
+		}))
+	};
+}
+function scanProject(context) {
+	const options = {
+		moduleGraph: context.moduleGraph,
+		providers: context.providers,
+		config: context.config
+	};
+	const { diagnostics: rawDiagnostics, errors } = runProjectRules(context.astProject, context.files, context.projectRules, options);
+	return {
+		diagnostics: filterIgnoredDiagnostics(rawDiagnostics, context.config, context.targetPath),
+		errors: errors.map((e) => ({
+			ruleId: e.ruleId,
+			error: formatRuleError(e.error)
+		}))
+	};
+}
+async function scan(targetPath, options = {}) {
+	const startTime = node_perf_hooks.performance.now();
+	const { context, customRuleWarnings } = await prepareScan(targetPath, options);
+	const fileResult = scanAllFiles(context);
+	const projectResult = scanProject(context);
+	const diagnostics = [...fileResult.diagnostics, ...projectResult.diagnostics];
+	const ruleErrors = [...fileResult.errors, ...projectResult.errors];
+	const project = await detectProject(targetPath);
+	const score = calculateScore(diagnostics, context.files.length);
 	const summary = buildSummary(diagnostics);
-	const ruleErrors = errors.map((e) => ({
-		ruleId: e.ruleId,
-		error: formatRuleError(e.error)
-	}));
 	const elapsedMs = node_perf_hooks.performance.now() - startTime;
 	return {
 		result: {
@@ -2478,17 +2571,17 @@ async function scan(targetPath, options = {}) {
 			diagnostics,
 			project: {
 				...project,
-				fileCount: files.length,
-				moduleCount: moduleGraph.modules.size
+				fileCount: context.files.length,
+				moduleCount: context.moduleGraph.modules.size
 			},
 			summary,
 			ruleErrors,
 			elapsedMs
 		},
-		moduleGraph,
+		moduleGraph: context.moduleGraph,
 		customRuleWarnings,
-		files,
-		providers
+		files: context.files,
+		providers: context.providers
 	};
 }
 function filterRules(config, rules) {
@@ -2700,4 +2793,9 @@ exports.ScanError = ScanError;
 exports.ValidationError = ValidationError;
 exports.diagnose = diagnose;
 exports.diagnoseMonorepo = diagnoseMonorepo;
-exports.getRules = getRules;
+exports.getRules = getRules;
+exports.prepareScan = prepareScan;
+exports.scanAllFiles = scanAllFiles;
+exports.scanFile = scanFile;
+exports.scanProject = scanProject;
+exports.updateFile = updateFile;

package/dist/api/index.d.cts

@@ -40,6 +40,7 @@ interface Diagnostic {
   line: number;
   message: string;
   rule: string;
+  scope?: RuleScope;
   severity: Severity;
   sourceLines?: SourceLine[];
 }
@@ -96,23 +97,6 @@ interface ProjectRule {
 }
 type AnyRule = Rule | ProjectRule;
 //#endregion
-//#region src/rules/index.d.ts
-declare function getRules(): AnyRule[];
-//#endregion
-//#region src/types/errors.d.ts
-declare class NestjsDoctorError extends Error {
-  constructor(message: string);
-}
-declare class ConfigurationError extends NestjsDoctorError {
-  constructor(message: string);
-}
-declare class ScanError extends NestjsDoctorError {
-  constructor(message: string);
-}
-declare class ValidationError extends NestjsDoctorError {
-  constructor(message: string);
-}
-//#endregion
 //#region src/types/result.d.ts
 interface Score {
   label: string;
@@ -156,6 +140,55 @@ interface MonorepoResult {
   subProjects: SubProjectResult[];
 }
 //#endregion
+//#region src/core/scanner.d.ts
+interface ScanOptions {
+  config?: string;
+}
+interface ScanContext {
+  astProject: Project;
+  config: NestjsDoctorConfig;
+  fileRules: Rule[];
+  files: string[];
+  moduleGraph: ModuleGraph;
+  projectRules: ProjectRule[];
+  providers: Map<string, ProviderInfo>;
+  targetPath: string;
+}
+declare function prepareScan(targetPath: string, options?: ScanOptions): Promise<{
+  context: ScanContext;
+  customRuleWarnings: string[];
+}>;
+declare function updateFile(context: ScanContext, filePath: string): void;
+declare function scanFile(context: ScanContext, filePath: string): {
+  diagnostics: Diagnostic[];
+  errors: RuleErrorInfo[];
+};
+declare function scanAllFiles(context: ScanContext): {
+  diagnostics: Diagnostic[];
+  errors: RuleErrorInfo[];
+};
+declare function scanProject(context: ScanContext): {
+  diagnostics: Diagnostic[];
+  errors: RuleErrorInfo[];
+};
+//#endregion
+//#region src/rules/index.d.ts
+declare function getRules(): AnyRule[];
+//#endregion
+//#region src/types/errors.d.ts
+declare class NestjsDoctorError extends Error {
+  constructor(message: string);
+}
+declare class ConfigurationError extends NestjsDoctorError {
+  constructor(message: string);
+}
+declare class ScanError extends NestjsDoctorError {
+  constructor(message: string);
+}
+declare class ValidationError extends NestjsDoctorError {
+  constructor(message: string);
+}
+//#endregion
 //#region src/api/index.d.ts
 /**
  * Scans a single NestJS project and returns a health diagnostic result.
@@ -183,5 +216,5 @@ declare function diagnoseMonorepo(path: string, options?: {
   config?: string;
 }): Promise<MonorepoResult>;
 //#endregion
-export { type AnyRule, type Category, ConfigurationError, type DiagnoseResult, type DiagnoseSummary, type Diagnostic, type MonorepoResult, type NestjsDoctorConfig, NestjsDoctorError, type ProjectInfo, type ProjectRule, type ProjectRuleContext, type Rule, type RuleContext, type RuleErrorInfo, type RuleMeta, ScanError, type Score, type Severity, type SubProjectResult, ValidationError, diagnose, diagnoseMonorepo, getRules };
+export { type AnyRule, type Category, ConfigurationError, type DiagnoseResult, type DiagnoseSummary, type Diagnostic, type MonorepoResult, type NestjsDoctorConfig, NestjsDoctorError, type ProjectInfo, type ProjectRule, type ProjectRuleContext, type Rule, type RuleContext, type RuleErrorInfo, type RuleMeta, type ScanContext, ScanError, type Score, type Severity, type SubProjectResult, ValidationError, diagnose, diagnoseMonorepo, getRules, prepareScan, scanAllFiles, scanFile, scanProject, updateFile };
 //# sourceMappingURL=index.d.cts.map

package/dist/api/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/engine/type-resolver.ts","../../src/engine/module-graph.ts","../../src/types/diagnostic.ts","../../src/types/config.ts","../../src/rules/types.ts","../../src/rules/index.ts","../../src/types/errors.ts","../../src/types/result.ts","../../src/api/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/engine/type-resolver.ts","../../src/engine/module-graph.ts","../../src/types/diagnostic.ts","../../src/types/config.ts","../../src/rules/types.ts","../../src/types/result.ts","../../src/core/scanner.ts","../../src/rules/index.ts","../../src/types/errors.ts","../../src/api/index.ts"],"mappings":"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"}

package/dist/api/index.d.mts

@@ -40,6 +40,7 @@ interface Diagnostic {
   line: number;
   message: string;
   rule: string;
+  scope?: RuleScope;
   severity: Severity;
   sourceLines?: SourceLine[];
 }
@@ -96,23 +97,6 @@ interface ProjectRule {
 }
 type AnyRule = Rule | ProjectRule;
 //#endregion
-//#region src/rules/index.d.ts
-declare function getRules(): AnyRule[];
-//#endregion
-//#region src/types/errors.d.ts
-declare class NestjsDoctorError extends Error {
-  constructor(message: string);
-}
-declare class ConfigurationError extends NestjsDoctorError {
-  constructor(message: string);
-}
-declare class ScanError extends NestjsDoctorError {
-  constructor(message: string);
-}
-declare class ValidationError extends NestjsDoctorError {
-  constructor(message: string);
-}
-//#endregion
 //#region src/types/result.d.ts
 interface Score {
   label: string;
@@ -156,6 +140,55 @@ interface MonorepoResult {
   subProjects: SubProjectResult[];
 }
 //#endregion
+//#region src/core/scanner.d.ts
+interface ScanOptions {
+  config?: string;
+}
+interface ScanContext {
+  astProject: Project;
+  config: NestjsDoctorConfig;
+  fileRules: Rule[];
+  files: string[];
+  moduleGraph: ModuleGraph;
+  projectRules: ProjectRule[];
+  providers: Map<string, ProviderInfo>;
+  targetPath: string;
+}
+declare function prepareScan(targetPath: string, options?: ScanOptions): Promise<{
+  context: ScanContext;
+  customRuleWarnings: string[];
+}>;
+declare function updateFile(context: ScanContext, filePath: string): void;
+declare function scanFile(context: ScanContext, filePath: string): {
+  diagnostics: Diagnostic[];
+  errors: RuleErrorInfo[];
+};
+declare function scanAllFiles(context: ScanContext): {
+  diagnostics: Diagnostic[];
+  errors: RuleErrorInfo[];
+};
+declare function scanProject(context: ScanContext): {
+  diagnostics: Diagnostic[];
+  errors: RuleErrorInfo[];
+};
+//#endregion
+//#region src/rules/index.d.ts
+declare function getRules(): AnyRule[];
+//#endregion
+//#region src/types/errors.d.ts
+declare class NestjsDoctorError extends Error {
+  constructor(message: string);
+}
+declare class ConfigurationError extends NestjsDoctorError {
+  constructor(message: string);
+}
+declare class ScanError extends NestjsDoctorError {
+  constructor(message: string);
+}
+declare class ValidationError extends NestjsDoctorError {
+  constructor(message: string);
+}
+//#endregion
 //#region src/api/index.d.ts
 /**
  * Scans a single NestJS project and returns a health diagnostic result.
@@ -183,5 +216,5 @@ declare function diagnoseMonorepo(path: string, options?: {
   config?: string;
 }): Promise<MonorepoResult>;
 //#endregion
-export { type AnyRule, type Category, ConfigurationError, type DiagnoseResult, type DiagnoseSummary, type Diagnostic, type MonorepoResult, type NestjsDoctorConfig, NestjsDoctorError, type ProjectInfo, type ProjectRule, type ProjectRuleContext, type Rule, type RuleContext, type RuleErrorInfo, type RuleMeta, ScanError, type Score, type Severity, type SubProjectResult, ValidationError, diagnose, diagnoseMonorepo, getRules };
+export { type AnyRule, type Category, ConfigurationError, type DiagnoseResult, type DiagnoseSummary, type Diagnostic, type MonorepoResult, type NestjsDoctorConfig, NestjsDoctorError, type ProjectInfo, type ProjectRule, type ProjectRuleContext, type Rule, type RuleContext, type RuleErrorInfo, type RuleMeta, type ScanContext, ScanError, type Score, type Severity, type SubProjectResult, ValidationError, diagnose, diagnoseMonorepo, getRules, prepareScan, scanAllFiles, scanFile, scanProject, updateFile };
 //# sourceMappingURL=index.d.mts.map

package/dist/api/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/engine/type-resolver.ts","../../src/engine/module-graph.ts","../../src/types/diagnostic.ts","../../src/types/config.ts","../../src/rules/types.ts","../../src/rules/index.ts","../../src/types/errors.ts","../../src/types/result.ts","../../src/api/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/engine/type-resolver.ts","../../src/engine/module-graph.ts","../../src/types/diagnostic.ts","../../src/types/config.ts","../../src/rules/types.ts","../../src/types/result.ts","../../src/core/scanner.ts","../../src/rules/index.ts","../../src/types/errors.ts","../../src/api/index.ts"],"mappings":"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"}