@decibelsystems/tools 2.0.0

package/dist/tools/auditor/index.js

@@ -0,0 +1,310 @@
+// ============================================================================
+// Auditor Domain Tool Definitions
+// ============================================================================
+// Code health assessment tools for detecting smells, naming issues, and
+// providing refactoring recommendations.
+// ============================================================================
+import { toolSuccess, toolError } from '../shared/index.js';
+import { auditorTriage, auditorHealth, auditorRefactorScore, auditorNamingAudit, auditorInit, auditorLogHealth, auditorHealthHistory, isAuditorError, } from '../auditor.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const VALID_SMELL_TYPES = [
+    'god_file',
+    'rule_sprawl',
+    'dip_violation',
+    'duplicate_code',
+    'hidden_rules',
+    'buried_legacy',
+    'naming_drift',
+    'missing_tests',
+    'hidden_side_effects',
+    'hardcoded_values',
+];
+// ============================================================================
+// auditor_triage
+// ============================================================================
+export const auditorTriageTool = {
+    definition: {
+        name: 'auditor_triage',
+        description: 'Run quick code smell triage on a file or directory. Detects god files, deep nesting, magic numbers, hardcoded values, and buried legacy code. Use before committing or during code review.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+                path: {
+                    type: 'string',
+                    description: 'Specific file or directory to scan. Defaults to src/',
+                },
+                checks: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: VALID_SMELL_TYPES,
+                    },
+                    description: 'Which smell types to check for. Defaults to common checks: god_file, rule_sprawl, hidden_rules, buried_legacy, hardcoded_values',
+                },
+                extensions: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'File extensions to scan (e.g., [".py", ".pyi"]). Auto-detected from project type if not specified.',
+                },
+            },
+            required: [],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            // Validate checks if provided
+            if (input.checks) {
+                for (const check of input.checks) {
+                    if (!VALID_SMELL_TYPES.includes(check)) {
+                        throw new Error(`Invalid check type: ${check}. Valid types: ${VALID_SMELL_TYPES.join(', ')}`);
+                    }
+                }
+            }
+            const result = await auditorTriage(input);
+            if (isAuditorError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// auditor_health_dashboard
+// ============================================================================
+export const auditorHealthTool = {
+    definition: {
+        name: 'auditor_health_dashboard',
+        description: 'Generate a code health dashboard with metrics: total files/lines, god files count, average file size, smell counts, and top offenders. Use for periodic health checks and tracking trends.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+                extensions: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'File extensions to scan (e.g., [".py"]). Auto-detected from project type if not specified.',
+                },
+            },
+            required: [],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await auditorHealth(args);
+            if (isAuditorError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// auditor_refactor_score
+// ============================================================================
+export const auditorRefactorTool = {
+    definition: {
+        name: 'auditor_refactor_score',
+        description: 'Score and rank files by refactoring urgency. Combines file size, complexity, and smell count into a priority score. Returns recommendations: split, extract, simplify, or delete.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of candidates to return (default: 10)',
+                },
+                extensions: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'File extensions to scan (e.g., [".py"]). Auto-detected from project type if not specified.',
+                },
+            },
+            required: [],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await auditorRefactorScore(args);
+            if (isAuditorError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// auditor_naming_audit
+// ============================================================================
+export const auditorNamingTool = {
+    definition: {
+        name: 'auditor_naming_audit',
+        description: 'Audit file and identifier naming against conventions. Detects anti-patterns like "utils", "helpers", "misc" in file names. For full naming audit, create naming-conventions.yml first.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+                conventions: {
+                    type: 'string',
+                    description: 'Path to naming-conventions.yml. Auto-detects if not provided.',
+                },
+                extensions: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'File extensions to scan (e.g., [".py"]). Auto-detected from project type if not specified.',
+                },
+            },
+            required: [],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await auditorNamingAudit(args);
+            if (isAuditorError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// auditor_init
+// ============================================================================
+export const auditorInitTool = {
+    definition: {
+        name: 'auditor_init',
+        description: 'Initialize naming conventions scaffold. Creates naming-conventions.yml with example patterns for entities, file naming, and anti-patterns to avoid.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+            },
+            required: [],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await auditorInit(args);
+            if (isAuditorError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// auditor_log_health
+// ============================================================================
+export const auditorLogHealthTool = {
+    definition: {
+        name: 'auditor_log_health',
+        description: 'Record a health snapshot for trend tracking. Call this periodically (e.g., after commits, weekly) to build health history. Stores metrics in .decibel/auditor/health-log.yaml.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+                commit: {
+                    type: 'string',
+                    description: 'Optional git commit SHA to associate with this snapshot.',
+                },
+            },
+            required: [],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await auditorLogHealth(args);
+            if (isAuditorError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// auditor_health_history
+// ============================================================================
+export const auditorHealthHistoryTool = {
+    definition: {
+        name: 'auditor_health_history',
+        description: 'Get health history and computed trends. Shows how code health has changed over time. Returns improvement/degradation signals for god files and code smells.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Project identifier. Uses current project if not specified.',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of snapshots to return (default: 10)',
+                },
+            },
+            required: [],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const result = await auditorHealthHistory(args);
+            if (isAuditorError(result)) {
+                return toolError(result.error, result.details);
+            }
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Export All Tools
+// ============================================================================
+export const auditorTools = [
+    auditorTriageTool,
+    auditorHealthTool,
+    auditorRefactorTool,
+    auditorNamingTool,
+    auditorInitTool,
+    auditorLogHealthTool,
+    auditorHealthHistoryTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/auditor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/auditor/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kCAAkC;AAClC,+EAA+E;AAC/E,wEAAwE;AACxE,yCAAyC;AACzC,+EAA+E;AAG/E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EACL,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,GASf,MAAM,eAAe,CAAC;AAEvB,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,iBAAiB,GAAgB;IACrC,UAAU;IACV,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,cAAc;IACd,eAAe;IACf,cAAc;IACd,eAAe;IACf,qBAAqB;IACrB,kBAAkB;CACnB,CAAC;AAEF,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAa;IACzC,UAAU,EAAE;QACV,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,4LAA4L;QACzM,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4DAA4D;iBAC1E;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,iBAAiB;qBACxB;oBACD,WAAW,EAAE,iIAAiI;iBAC/I;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,oGAAoG;iBAClH;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAA0B,CAAC;YAEzC,8BAA8B;YAC9B,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACjC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBACvC,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,kBAAkB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAChG,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAa;IACzC,UAAU,EAAE;QACV,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,4LAA4L;QACzM,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4DAA4D;iBAC1E;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,4FAA4F;iBAC1G;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAA0B,CAAC,CAAC;YAC/D,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,mBAAmB,GAAa;IAC3C,UAAU,EAAE;QACV,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,mLAAmL;QAChM,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4DAA4D;iBAC1E;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,sDAAsD;iBACpE;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,4FAA4F;iBAC1G;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,IAA4B,CAAC,CAAC;YACxE,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAa;IACzC,UAAU,EAAE;QACV,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,wLAAwL;QACrM,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4DAA4D;iBAC1E;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,+DAA+D;iBAC7E;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,4FAA4F;iBAC1G;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAA0B,CAAC,CAAC;YACpE,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAa;IACvC,UAAU,EAAE;QACV,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,qJAAqJ;QAClK,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4DAA4D;iBAC1E;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAwB,CAAC,CAAC;YAC3D,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,oBAAoB,GAAa;IAC5C,UAAU,EAAE;QACV,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,gLAAgL;QAC7L,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4DAA4D;iBAC1E;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,0DAA0D;iBACxE;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,IAA6B,CAAC,CAAC;YACrE,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,wBAAwB,GAAa;IAChD,UAAU,EAAE;QACV,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,6JAA6J;QAC1K,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4DAA4D;iBAC1E;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,qDAAqD;iBACnE;aACF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,IAAiC,CAAC,CAAC;YAC7E,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,eAAe;IACf,oBAAoB;IACpB,wBAAwB;CACzB,CAAC"}

package/dist/tools/auditor.d.ts

@@ -0,0 +1,149 @@
+export type SmellType = 'god_file' | 'rule_sprawl' | 'dip_violation' | 'duplicate_code' | 'hidden_rules' | 'buried_legacy' | 'naming_drift' | 'missing_tests' | 'hidden_side_effects' | 'hardcoded_values';
+export type SmellSeverity = 'high' | 'medium' | 'low';
+export interface CodeSmell {
+    file: string;
+    line?: number;
+    smell: SmellType;
+    severity: SmellSeverity;
+    message: string;
+    suggestion?: string;
+}
+export interface AuditorTriageInput {
+    projectId?: string;
+    path?: string;
+    checks?: SmellType[];
+    extensions?: string[];
+}
+export interface AuditorTriageOutput {
+    scanned: number;
+    issues: CodeSmell[];
+    summary: {
+        high: number;
+        medium: number;
+        low: number;
+    };
+}
+export interface AuditorNamingInput {
+    projectId?: string;
+    conventions?: string;
+    extensions?: string[];
+}
+export interface NamingViolation {
+    file: string;
+    line: number;
+    found: string;
+    expected: string;
+    category: 'variable' | 'function' | 'class' | 'file' | 'constant';
+}
+export interface AuditorNamingOutput {
+    violations: NamingViolation[];
+    stats: {
+        checked: number;
+        passed: number;
+        violations: number;
+    };
+}
+export interface RefactorCandidate {
+    file: string;
+    score: number;
+    factors: {
+        lines: number;
+        complexity: number;
+        smellCount: number;
+        testCoverage?: number;
+        lastModified?: string;
+        changeFrequency?: number;
+    };
+    recommendation: 'split' | 'extract' | 'simplify' | 'delete' | 'refactor';
+}
+export interface AuditorRefactorInput {
+    projectId?: string;
+    limit?: number;
+    extensions?: string[];
+}
+export interface AuditorRefactorOutput {
+    candidates: RefactorCandidate[];
+    totalFiles: number;
+}
+export interface CodeHealthMetrics {
+    totalFiles: number;
+    totalLines: number;
+    godFiles: number;
+    avgFileSize: number;
+    maxFileSize: number;
+    namingViolations: number;
+    smellCount: {
+        high: number;
+        medium: number;
+        low: number;
+    };
+}
+export interface AuditorHealthInput {
+    projectId?: string;
+    extensions?: string[];
+}
+export interface AuditorHealthOutput {
+    timestamp: string;
+    project: string;
+    metrics: CodeHealthMetrics;
+    trends?: {
+        godFiles: 'improving' | 'stable' | 'degrading';
+        smells: 'improving' | 'stable' | 'degrading';
+    };
+    topOffenders: Array<{
+        file: string;
+        issues: number;
+    }>;
+}
+export interface AuditorInitInput {
+    projectId?: string;
+}
+export interface AuditorInitOutput {
+    path: string;
+    created: boolean;
+}
+export interface HealthSnapshot {
+    timestamp: string;
+    metrics: CodeHealthMetrics;
+    commit?: string;
+}
+export interface AuditorLogHealthInput {
+    projectId?: string;
+    commit?: string;
+}
+export interface AuditorLogHealthOutput {
+    logged: boolean;
+    path: string;
+    snapshot: HealthSnapshot;
+    entryCount: number;
+}
+export interface AuditorHealthHistoryInput {
+    projectId?: string;
+    limit?: number;
+}
+export interface AuditorHealthHistoryOutput {
+    entries: HealthSnapshot[];
+    trends: {
+        godFiles: 'improving' | 'stable' | 'degrading';
+        smells: 'improving' | 'stable' | 'degrading';
+        totalLines: 'growing' | 'stable' | 'shrinking';
+    };
+    summary: {
+        oldestEntry: string;
+        newestEntry: string;
+        totalSnapshots: number;
+    };
+}
+export interface AuditorError {
+    error: string;
+    details?: string;
+}
+export declare function auditorTriage(input: AuditorTriageInput): Promise<AuditorTriageOutput | AuditorError>;
+export declare function auditorHealth(input: AuditorHealthInput): Promise<AuditorHealthOutput | AuditorError>;
+export declare function auditorRefactorScore(input: AuditorRefactorInput): Promise<AuditorRefactorOutput | AuditorError>;
+export declare function auditorInit(input: AuditorInitInput): Promise<AuditorInitOutput | AuditorError>;
+export declare function auditorNamingAudit(input: AuditorNamingInput): Promise<AuditorNamingOutput | AuditorError>;
+export declare function auditorLogHealth(input: AuditorLogHealthInput): Promise<AuditorLogHealthOutput | AuditorError>;
+export declare function auditorHealthHistory(input: AuditorHealthHistoryInput): Promise<AuditorHealthHistoryOutput | AuditorError>;
+export declare function isAuditorError(result: unknown): result is AuditorError;
+//# sourceMappingURL=auditor.d.ts.map

package/dist/tools/auditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditor.d.ts","sourceRoot":"","sources":["../../src/tools/auditor.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,eAAe,GACf,cAAc,GACd,eAAe,GACf,qBAAqB,GACrB,kBAAkB,CAAC;AAEvB,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;CACnE;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,cAAc,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;CAC1E;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE;QACP,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;QAC/C,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;KAC9C,CAAC;IACF,YAAY,EAAE,KAAK,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE;QACN,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;QAC/C,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;QAC7C,UAAU,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;KAChD,CAAC;IACF,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4KD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,GAAG,YAAY,CAAC,CA2K7C;AAMD,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,GAAG,YAAY,CAAC,CA8H7C;AAMD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,GAAG,YAAY,CAAC,CAuF/C;AAMD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,GAAG,YAAY,CAAC,CAsD3C;AAMD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,GAAG,YAAY,CAAC,CA6D7C;AAQD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,GAAG,YAAY,CAAC,CAmDhD;AA0CD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,GAAG,YAAY,CAAC,CAoDpD;AAMD,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,YAAY,CAEtE"}