@mathonsunday/dead-code-toolkit 0.1.0

package/dist/src/setup/installer.js

@@ -0,0 +1,156 @@
+/**
+ * Main setup orchestrator
+ * Coordinates all setup tasks (configs, dependencies, hooks)
+ */
+import { existsSync, writeFileSync } from 'fs';
+import { resolve } from 'path';
+import { execSync } from 'child_process';
+import { detectProjectConfig } from '../config/detectors.js';
+import { generateKnipConfigJSON, generateTypeCoverageConfigJSON, generateLintStagedConfigJSON, } from '../config/templates.js';
+import { updatePackageJson, formatDependenciesForInstall } from './packageJsonUpdater.js';
+import { setupAllHooks } from './hookInstaller.js';
+/**
+ * Main setup function
+ */
+export async function setupProject(options) {
+    const result = {
+        status: 'success',
+        filesCreated: [],
+        scriptsAdded: [],
+        dependenciesInstalled: [],
+        nextSteps: [],
+        errors: [],
+    };
+    try {
+        // Validate project root
+        if (!existsSync(options.projectRoot)) {
+            throw new Error(`Project root does not exist: ${options.projectRoot}`);
+        }
+        if (options.verbose) {
+            console.log(`[Setup] Starting setup in: ${options.projectRoot}`);
+        }
+        // Detect project configuration
+        const projectConfig = detectProjectConfig(options.projectRoot);
+        if (options.verbose) {
+            console.log(`[Setup] Detected project type: ${projectConfig.type}`);
+        }
+        // Step 1: Create configuration files
+        const configFiles = await createConfigFiles(options.projectRoot, projectConfig);
+        result.filesCreated.push(...configFiles);
+        // Step 2: Update package.json
+        const packageJsonUpdate = updatePackageJson(options.projectRoot, {
+            addScripts: true,
+            installDependencies: options.installDependencies !== false,
+        });
+        result.scriptsAdded.push(...packageJsonUpdate.scriptsAdded);
+        if (options.verbose && packageJsonUpdate.scriptsAdded.length > 0) {
+            console.log(`[Setup] Added ${packageJsonUpdate.scriptsAdded.length} npm scripts`);
+        }
+        // Step 3: Install dependencies
+        if (options.installDependencies !== false) {
+            const depsToInstall = packageJsonUpdate.dependenciesToInstall;
+            if (Object.keys(depsToInstall).length > 0) {
+                await installDependencies(options.projectRoot, depsToInstall, options.verbose);
+                result.dependenciesInstalled.push(...Object.keys(depsToInstall));
+            }
+        }
+        // Step 4: Setup Git hooks
+        if (options.setupHooks !== false) {
+            const hookResult = setupAllHooks(options.projectRoot);
+            if (!hookResult.success) {
+                result.errors?.push(...hookResult.errors);
+                result.status = 'partial';
+            }
+            // Mark hooks as part of setup
+            result.filesCreated.push('.husky/pre-commit', '.husky/commit-msg', 'commitlint.config.js');
+        }
+        // Generate next steps
+        result.nextSteps = generateNextSteps(projectConfig, result);
+        if (options.verbose) {
+            console.log(`[Setup] Setup complete! Status: ${result.status}`);
+        }
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        result.status = 'failure';
+        result.errors?.push(message);
+        return result;
+    }
+}
+/**
+ * Create configuration files
+ */
+async function createConfigFiles(projectRoot, projectConfig) {
+    const filesCreated = [];
+    // Check for existing configs
+    if (projectConfig.existingConfigs.knip) {
+        console.log('[Setup] knip.json already exists, skipping');
+    }
+    else {
+        // Create knip.json
+        const knipConfig = generateKnipConfigJSON(projectConfig);
+        const knipPath = resolve(projectRoot, 'knip.json');
+        writeFileSync(knipPath, knipConfig);
+        filesCreated.push('knip.json');
+        console.log('[Setup] Created knip.json');
+    }
+    // Create typecoveragerc.json (always overwrite with updated config)
+    const typeCoverageConfig = generateTypeCoverageConfigJSON(projectConfig);
+    const typeCoveragePath = resolve(projectRoot, 'typecoveragerc.json');
+    writeFileSync(typeCoveragePath, typeCoverageConfig);
+    filesCreated.push('typecoveragerc.json');
+    console.log('[Setup] Created typecoveragerc.json');
+    // Create .lintstagedrc.json (always overwrite)
+    const lintStagedConfig = generateLintStagedConfigJSON();
+    const lintStagedPath = resolve(projectRoot, '.lintstagedrc.json');
+    writeFileSync(lintStagedPath, lintStagedConfig);
+    filesCreated.push('.lintstagedrc.json');
+    console.log('[Setup] Created .lintstagedrc.json');
+    // Note: ESLint config is not auto-created as it may conflict with existing configs
+    if (!projectConfig.existingConfigs.eslint) {
+        console.log('[Setup] ⚠️  ESLint config not found. Add these rules to your eslint.config.js:');
+        console.log('  @typescript-eslint/no-redundant-type-constituents: warn');
+        console.log('  @typescript-eslint/no-unused-vars: [warn, {argsIgnorePattern: "^_"}]');
+    }
+    return filesCreated;
+}
+/**
+ * Install npm dependencies
+ */
+async function installDependencies(projectRoot, dependencies, verbose) {
+    const deps = formatDependenciesForInstall(dependencies);
+    if (verbose) {
+        console.log(`[Setup] Installing ${deps.length} dependencies...`);
+    }
+    try {
+        execSync(`npm install --save-dev ${deps.join(' ')}`, {
+            cwd: projectRoot,
+            stdio: verbose ? 'inherit' : 'ignore',
+        });
+        if (verbose) {
+            console.log(`[Setup] Dependencies installed`);
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to install dependencies: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Generate next steps for user
+ */
+function generateNextSteps(projectConfig, result) {
+    const steps = [];
+    steps.push('Run: npm run dead-code to check for dead code');
+    steps.push('Review findings and consider running: npm run dead-code:fix');
+    if (result.scriptsAdded.includes('verify')) {
+        steps.push('Use: npm run verify to run all quality checks');
+    }
+    if (!projectConfig.existingConfigs.eslint) {
+        steps.push('⚠️  Update your ESLint config to include dead code detection rules');
+    }
+    steps.push('Configure pre-commit hooks: git commit -m "message"');
+    steps.push('Read: npx dead-code-toolkit --help for more commands');
+    return steps;
+}
+//# sourceMappingURL=installer.js.map

package/dist/src/setup/installer.js.map

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

package/dist/src/setup/packageJsonUpdater.d.ts

@@ -0,0 +1,54 @@
+/**
+ * package.json updater
+ * Safely updates package.json with new scripts and dependencies
+ */
+interface PackageJson {
+    name?: string;
+    version?: string;
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+/**
+ * Read package.json from project
+ */
+export declare function readPackageJson(projectRoot: string): PackageJson;
+/**
+ * Write package.json back to disk
+ */
+export declare function writePackageJson(projectRoot: string, packageJson: PackageJson): void;
+/**
+ * Add scripts to package.json
+ * Returns list of added scripts
+ */
+export declare function addScripts(packageJson: PackageJson): string[];
+/**
+ * Get recommended dev dependencies
+ */
+export declare function getRecommendedDevDependencies(): Record<string, string>;
+/**
+ * Check which dev dependencies are already installed
+ */
+export declare function getInstalledDevDependencies(packageJson: PackageJson): Record<string, string>;
+/**
+ * Get missing dev dependencies that need to be installed
+ */
+export declare function getMissingDevDependencies(packageJson: PackageJson): Record<string, string>;
+/**
+ * Format dependencies for npm install command
+ */
+export declare function formatDependenciesForInstall(deps: Record<string, string>): string[];
+/**
+ * Update package.json with all necessary changes
+ */
+export declare function updatePackageJson(projectRoot: string, options?: {
+    addScripts?: boolean;
+    installDependencies?: boolean;
+}): {
+    scriptsAdded: string[];
+    dependenciesToInstall: Record<string, string>;
+    updated: boolean;
+};
+export {};
+//# sourceMappingURL=packageJsonUpdater.d.ts.map

package/dist/src/setup/packageJsonUpdater.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageJsonUpdater.d.ts","sourceRoot":"","sources":["../../../src/setup/packageJsonUpdater.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAWhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,CAUpF;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,EAAE,CAgB7D;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUtE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY5F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY1F;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,CAEnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAAO,GACpE;IACD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;CAClB,CA8BA"}

package/dist/src/setup/packageJsonUpdater.js

@@ -0,0 +1,129 @@
+/**
+ * package.json updater
+ * Safely updates package.json with new scripts and dependencies
+ */
+import { readFileSync, writeFileSync } from 'fs';
+import { resolve } from 'path';
+import { generatePackageJsonScripts } from '../config/templates.js';
+/**
+ * Read package.json from project
+ */
+export function readPackageJson(projectRoot) {
+    const packageJsonPath = resolve(projectRoot, 'package.json');
+    try {
+        const content = readFileSync(packageJsonPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Failed to read package.json: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Write package.json back to disk
+ */
+export function writePackageJson(projectRoot, packageJson) {
+    const packageJsonPath = resolve(projectRoot, 'package.json');
+    try {
+        writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
+    }
+    catch (error) {
+        throw new Error(`Failed to write package.json: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Add scripts to package.json
+ * Returns list of added scripts
+ */
+export function addScripts(packageJson) {
+    const scriptsToAdd = generatePackageJsonScripts();
+    const addedScripts = [];
+    if (!packageJson.scripts) {
+        packageJson.scripts = {};
+    }
+    for (const [name, command] of Object.entries(scriptsToAdd)) {
+        if (!packageJson.scripts[name]) {
+            packageJson.scripts[name] = command;
+            addedScripts.push(name);
+        }
+    }
+    return addedScripts;
+}
+/**
+ * Get recommended dev dependencies
+ */
+export function getRecommendedDevDependencies() {
+    return {
+        knip: '^5.82.1',
+        'type-coverage': '^2.29.7',
+        'typescript-coverage-report': '^1.1.1',
+        husky: '^9.1.7',
+        'lint-staged': '^16.2.7',
+        '@commitlint/cli': '^20.3.1',
+        '@commitlint/config-conventional': '^20.3.1',
+    };
+}
+/**
+ * Check which dev dependencies are already installed
+ */
+export function getInstalledDevDependencies(packageJson) {
+    const devDeps = packageJson.devDependencies || {};
+    const recommended = getRecommendedDevDependencies();
+    const installed = {};
+    for (const [name] of Object.entries(recommended)) {
+        if (devDeps[name]) {
+            installed[name] = devDeps[name];
+        }
+    }
+    return installed;
+}
+/**
+ * Get missing dev dependencies that need to be installed
+ */
+export function getMissingDevDependencies(packageJson) {
+    const devDeps = packageJson.devDependencies || {};
+    const recommended = getRecommendedDevDependencies();
+    const missing = {};
+    for (const [name, version] of Object.entries(recommended)) {
+        if (!devDeps[name]) {
+            missing[name] = version;
+        }
+    }
+    return missing;
+}
+/**
+ * Format dependencies for npm install command
+ */
+export function formatDependenciesForInstall(deps) {
+    return Object.entries(deps).map(([name, version]) => `${name}@${version}`);
+}
+/**
+ * Update package.json with all necessary changes
+ */
+export function updatePackageJson(projectRoot, options = {}) {
+    const packageJson = readPackageJson(projectRoot);
+    let updated = false;
+    const scriptsAdded = [];
+    // Add scripts
+    if (options.addScripts !== false) {
+        const added = addScripts(packageJson);
+        if (added.length > 0) {
+            scriptsAdded.push(...added);
+            updated = true;
+        }
+    }
+    // Get dependencies to install
+    let dependenciesToInstall = {};
+    if (options.installDependencies !== false) {
+        dependenciesToInstall = getMissingDevDependencies(packageJson);
+    }
+    // Write back if updated
+    if (updated) {
+        writePackageJson(projectRoot, packageJson);
+    }
+    return {
+        scriptsAdded,
+        dependenciesToInstall,
+        updated,
+    };
+}
+//# sourceMappingURL=packageJsonUpdater.js.map

package/dist/src/setup/packageJsonUpdater.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Core type definitions for dead code analysis toolkit
+ */
+/**
+ * Configuration options for dead code analysis
+ */
+export interface AnalysisOptions {
+    /** Absolute path to project root directory */
+    projectRoot: string;
+    /** Which checks to run. Default: all */
+    checks?: CheckType[];
+    /** Automatically fix issues where possible */
+    fix?: boolean;
+    /** Custom paths to configuration files */
+    configPaths?: Partial<Record<string, string>>;
+    /** Verbose logging output */
+    verbose?: boolean;
+}
+/**
+ * Available check types
+ */
+export type CheckType = 'knip' | 'typescript' | 'eslint' | 'type-coverage' | 'exhaustiveness' | 'all';
+/**
+ * Result of a single analysis check
+ */
+export interface CheckResult {
+    type: CheckType;
+    status: 'success' | 'failure' | 'skipped';
+    findings: Finding[];
+    executionTime: number;
+    error?: string;
+}
+/**
+ * Individual finding - a piece of dead code or issue detected
+ */
+export interface Finding {
+    /** Category of the finding */
+    category: 'unused-export' | 'unused-file' | 'unused-dependency' | 'type-error' | 'unused-var' | 'redundant-type' | 'union-issue' | 'unused-param';
+    /** Severity level */
+    severity: 'error' | 'warning' | 'info';
+    /** File path (relative to project root) */
+    file: string;
+    /** Line number (1-based, if applicable) */
+    line?: number;
+    /** Column number (1-based, if applicable) */
+    column?: number;
+    /** Human-readable message describing the issue */
+    message: string;
+    /** Whether this issue can be automatically fixed */
+    fixable: boolean;
+    /** Suggestion for how to fix the issue */
+    suggestion?: string;
+    /** Source tool that detected this */
+    source: CheckType;
+    /** Rule name or code from the tool */
+    rule?: string;
+}
+/**
+ * Summary statistics for analysis results
+ */
+export interface AnalysisSummary {
+    /** Total number of issues found */
+    totalIssues: number;
+    /** Breakdown by category */
+    byCategory: Record<string, number>;
+    /** Number of issues that can be auto-fixed */
+    fixableCount: number;
+    /** Number of errors (highest severity) */
+    errorCount: number;
+    /** Number of warnings */
+    warningCount: number;
+    /** Number of info/low severity items */
+    infoCount: number;
+}
+/**
+ * Complete analysis result
+ */
+export interface AnalysisResult {
+    /** Overall status of the analysis */
+    status: 'success' | 'partial' | 'failure';
+    /** Summary statistics */
+    summary: AnalysisSummary;
+    /** All findings from all checks */
+    findings: Finding[];
+    /** Results from individual checks */
+    checkResults: CheckResult[];
+    /** Total execution time in milliseconds */
+    executionTime: number;
+    /** Error message if status is 'failure' */
+    error?: string;
+}
+/**
+ * Result of applying fixes
+ */
+export interface FixResult {
+    /** Overall status */
+    status: 'success' | 'partial' | 'failure';
+    /** Number of issues fixed */
+    fixedCount: number;
+    /** Number of issues that could not be fixed */
+    unfixedCount: number;
+    /** Files that were modified */
+    modifiedFiles: string[];
+    /** Details of what was fixed */
+    fixes: FixDetail[];
+    /** Any errors that occurred */
+    errors?: string[];
+}
+/**
+ * Details about a single fix that was applied
+ */
+export interface FixDetail {
+    /** The finding that was fixed */
+    finding: Finding;
+    /** What was changed */
+    action: string;
+    /** Was it successful */
+    success: boolean;
+    /** Error message if unsuccessful */
+    error?: string;
+}
+/**
+ * Configuration options for setup
+ */
+export interface SetupOptions {
+    /** Absolute path to project root */
+    projectRoot: string;
+    /** Install pre-commit hooks */
+    setupHooks?: boolean;
+    /** Install npm dependencies */
+    installDependencies?: boolean;
+    /** Override default configs */
+    configOverrides?: Partial<Record<string, unknown>>;
+    /** Show detailed output */
+    verbose?: boolean;
+}
+/**
+ * Result of setup process
+ */
+export interface SetupResult {
+    /** Overall status */
+    status: 'success' | 'partial' | 'failure';
+    /** Files created during setup */
+    filesCreated: string[];
+    /** Scripts added to package.json */
+    scriptsAdded: string[];
+    /** Dependencies installed */
+    dependenciesInstalled: string[];
+    /** Next steps for user */
+    nextSteps: string[];
+    /** Any errors that occurred */
+    errors?: string[];
+}
+/**
+ * Detected project configuration
+ */
+export interface ProjectConfig {
+    /** Root directory */
+    root: string;
+    /** Whether package.json exists */
+    hasPackageJson: boolean;
+    /** Whether TypeScript is configured */
+    hasTypeScript: boolean;
+    /** TypeScript config path if present */
+    tsconfigPath?: string;
+    /** Project type */
+    type: 'react' | 'node' | 'fullstack' | 'unknown';
+    /** Existing tool configs present */
+    existingConfigs: {
+        eslint?: string;
+        prettier?: string;
+        knip?: string;
+        husky?: string;
+        [key: string]: string | undefined;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core type definitions for dead code analysis toolkit
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}