code-quality-lib 2.0.0 → 2.0.1

package/README.md

@@ -1,324 +1,134 @@
 # Code Quality Library
 
 [![npm version](https://img.shields.io/npm/v/code-quality-lib)](https://www.npmjs.com/package/code-quality-lib)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js Version](https://img.shields.io/badge/node-18.x%20%7C%2020.x%20%7C%2022.x%20%7C%2025.x-brightgreen)](https://nodejs.org/)
-[![Bun Version](https://img.shields.io/badge/bun-1.3.x-black)](https://bun.sh/)
-[![pnpm Version](https://img.shields.io/badge/pnpm-10.x-f69220)](https://pnpm.io/)
-[![Yarn Version](https://img.shields.io/badge/yarn-4.13.0-2c8ebb)](https://yarnpkg.com/)
 [![CI/CD](https://github.com/NoonCore/code-quality-lib/actions/workflows/ci.yml/badge.svg)](https://github.com/NoonCore/code-quality-lib/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-included-blue)](https://www.typescriptlang.org/)
 
-> 🚀 A configurable code quality checker for Node.js that auto-detects your package manager and runs TypeScript, ESLint, Prettier, Knip, and Snyk.
+> A configurable code quality checker for Node.js — auto-detects your package manager and runs **TypeScript**, **ESLint**, **Prettier**, **Knip**, and **Snyk** with all dependencies bundled.
 
 ## Features
 
-- 🚀 Works with npm, bun, pnpm, yarn (auto-detected)
-- 🎨 Beautiful terminal output
-- ⚙️ Configurable tools and commands
-- 📚 TypeScript definitions included
-- 🔧 CLI and library usage
-- 📄 Detailed error reports for developers and AI agents
-- 🔍 --logs flag for verbose terminal output
-- 🤖 AI-friendly structured error information
-- 📦 **All dependencies bundled** - No need to install TypeScript, ESLint, Prettier, Knip, or Snyk separately!
+- **All tools bundled** — no need to install TypeScript, ESLint, Prettier, Knip, or Snyk separately
+- **Auto-detects package manager** — npm, bun, pnpm, yarn
+- **CLI + Library** — use from terminal or programmatically
+- **Detailed reports** — generates `.quality-report.md` with AI-friendly error info
+- **`--logs` flag** — verbose terminal output for debugging
+- **TypeScript definitions** — full type safety included
 
 ## Installation
 
-### npm
-```bash
-# Install as development dependency (recommended)
-npm install -D code-quality-lib
-
-# Install globally for CLI usage
-npm install -g code-quality-lib
-
-# Install from GitHub (development)
-npm install -D https://github.com/NoonCore/code-quality-lib.git
-```
-
-### bun (recommended - faster)
 ```bash
-# Install as development dependency (recommended)
-bun add -D code-quality-lib
-
-# Install globally for CLI usage
-bun add -g code-quality-lib
-
-# Install from GitHub (development)
-bun add -D https://github.com/NoonCore/code-quality-lib.git
-```
-
-### pnpm
-```bash
-# Install as development dependency (recommended)
-pnpm add -D code-quality-lib
-
-# Install globally for CLI usage
-pnpm add -g code-quality-lib
-
-# Install from GitHub (development)
-pnpm add -D https://github.com/NoonCore/code-quality-lib.git
-```
-
-### yarn
-```bash
-# Install as development dependency (recommended)
-yarn add -D code-quality-lib
-
-# Install globally for CLI usage
-yarn global add code-quality-lib
-
-# Install from GitHub (development)
-yarn add -D https://github.com/NoonCore/code-quality-lib.git
+npm install -D code-quality-lib     # npm
+bun add -D code-quality-lib         # bun
+pnpm add -D code-quality-lib        # pnpm
+yarn add -D code-quality-lib        # yarn
 ```
 
-
 ## Quick Start
 
 ```bash
-# Install and run
-npm install -D code-quality-lib && npx code-quality
-
-# Or with bun
-bun add -D code-quality-lib && bunx code-quality
-
-# Or with yarn
-yarn add -D code-quality-lib && yarn code-quality
-```
-
-## Usage
-
-### As a CLI Tool
-
-```bash
-# Run all quality checks
-code-quality
-
-# Run with detailed error logs in terminal
-code-quality --logs
-
-# Or use with npx (without installing)
-npx code-quality-lib
-
-# Or with bunx (without installing)
-bunx code-quality-lib
-
-# Or with yarn
-yarn code-quality
+npx code-quality          # npm
+bunx code-quality         # bun
+pnpm dlx code-quality     # pnpm
+yarn dlx code-quality     # yarn
 ```
 
-### Error Reporting
+## CLI Usage
 
-The library automatically generates a detailed error report at `.quality-report.md` with:
-- ✅ Status of each quality check
-- 📋 Full error output for failed checks
-- 💡 Suggestions for fixing common issues
-- 🤖 AI-friendly structured information
-
-**Viewing Errors:**
 ```bash
-# Silent mode (default) - errors saved to .quality-report.md
-code-quality
-
-# Verbose mode - errors shown in terminal + saved to report
-code-quality --logs
-
-# View the report
-cat .quality-report.md
+code-quality              # run all quality checks
+code-quality --logs       # show detailed error output
+code-quality --help       # show help
+code-quality --version    # show version
 ```
 
-**Note:** Add `.quality-report.md` to your `.gitignore` to keep reports local only.
-
-### As a Library
+## Library Usage
 
 ```javascript
-const { CodeQualityChecker } = require('code-quality-lib');
+const { CodeQualityChecker, runQualityCheck } = require('code-quality-lib');
 
-// Use default configuration
-const checker = new CodeQualityChecker();
-checker.run().then(result => {
-  console.log(result.success ? '✅ All checks passed!' : '❌ Some checks failed');
-});
-```
+// Quick — run all checks with defaults
+const result = await runQualityCheck();
+console.log(result.success ? 'All passed' : 'Some failed');
 
-## Configuration
-
-### Default Tools
-
-The library runs these tools by default (all bundled, no separate installation needed):
-- **TypeScript** (v5.8.3) - Type checking and compilation
-- **ESLint** (v9.18.0) - Code linting and style checking with plugins:
-  - @typescript-eslint/eslint-plugin & parser
-  - eslint-plugin-react & react-hooks
-  - eslint-plugin-prettier
-  - eslint-plugin-sonarjs
-  - eslint-plugin-unicorn
-  - eslint-plugin-import
-- **Prettier** (v3.4.2) - Code formatting validation
-- **Knip** (v5.43.2) - Dead code detection and unused exports
-- **Snyk** (v1.1293.1) - Security vulnerability scanning
-
-**No need to install these tools separately!** Everything is bundled with the library.
-
-### Custom Configuration
-
-```javascript
-const customChecker = new CodeQualityChecker({
-  // Force specific package manager
-  packageManager: 'pnpm', // 'bun' | 'pnpm' | 'yarn' | 'npm'
-  
-  // Only run specific tools
+// Custom — select tools, override commands
+const checker = new CodeQualityChecker({
   tools: ['TypeScript', 'ESLint'],
-  
-  // Custom commands for each tool
+  packageManager: 'pnpm',
   commands: {
     TypeScript: 'tsc --noEmit',
     ESLint: 'eslint src/ --ext .ts,.tsx',
-    Prettier: 'prettier --check "src/**/*.{ts,tsx}"'
   },
-  
-  // Custom descriptions
-  descriptions: {
-    TypeScript: 'TypeScript type checking',
-    ESLint: 'ESLint code analysis'
-  },
-  
-  // Disable .env loading
-  loadEnv: false
+  loadEnv: false,
 });
-```
 
-### Package Manager Detection
-
-The library automatically detects your package manager in this order:
-1. **Lock files**: `bun.lock`, `pnpm-lock.yaml`, `yarn.lock`, `package-lock.json`
-2. **Available commands**: Checks if `bun`, `pnpm`, `yarn` are installed
-3. **Fallback**: Uses `npm` if nothing else is found
-
-You can also override the detection:
-```javascript
-const checker = new CodeQualityChecker({
-  packageManager: 'yarn' // Force yarn usage
-});
+const result = await checker.run({ showLogs: true });
+console.log(result.results); // per-tool results array
 ```
 
+## Configuration Options
 
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `tools` | `string[]` | All 5 tools | Which tools to run |
+| `packageManager` | `'npm' \| 'bun' \| 'pnpm' \| 'yarn'` | auto-detected | Force a specific package manager |
+| `commands` | `Record<string, string>` | bundled paths | Custom commands per tool |
+| `descriptions` | `Record<string, string>` | built-in | Custom descriptions per tool |
+| `loadEnv` | `boolean` | `true` | Load `.env` file |
 
-## API Reference
-
-### CodeQualityChecker
-
-#### Constructor
-```javascript
-new CodeQualityChecker(options)
-```
-
-#### Options
-- `loadEnv` (boolean): Load environment variables from `.env` file
-- `tools` (string[]): Array of tool names to run
-- `commands` (Record<string, string>): Custom commands for each tool
-- `descriptions` (Record<string, string>): Descriptions shown during execution
-- `packageManager` ('bun' | 'pnpm' | 'yarn' | 'npm'): Force specific package manager (auto-detected if not specified)
-
-#### Methods
-- `run()`: Promise<QualityCheckResult> - Run all configured checks
-- `runCommand(command, description)`: CommandResult - Execute a single command
-- `formatOutput(tool, result)`: string - Format output for a tool
-- `checkSnykToken()`: boolean - Check Snyk authentication status
-
-### Types
-
-```typescript
-interface CodeQualityOptions {
-  loadEnv?: boolean;
-  tools?: string[];
-  commands?: Record<string, string>;
-  descriptions?: Record<string, string>;
-  packageManager?: 'bun' | 'pnpm' | 'yarn' | 'npm';
-}
-
-interface CommandResult {
-  success: boolean;
-  output: string;
-}
-
-interface QualityCheckResult {
-  success: boolean;
-  message: string;
-}
-```
+## Bundled Tools
 
-## Requirements
+All tools are included as dependencies — zero extra setup:
 
-- **Node.js** >= 18.0.0 (tested on 25.x, 22.x, 20.x)
-- **Package Manager**: bun, pnpm, yarn, or npm (auto-detected)
-- **Quality Tools** (install only what you need):
-  - **TypeScript** - `npm install -D typescript` or `bun add -D typescript` or `pnpm add -D typescript` or `yarn add -D typescript`
-  - **ESLint** - `npm install -D eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin` or `bun add -D eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin`
-  - **Prettier** - `npm install -D prettier eslint-config-prettier` or `bun add -D prettier eslint-config-prettier`
-  - **Knip** - `npm install -D knip` or `bun add -D knip`
-  - **Snyk** - `npm install -D snyk` or `bun add -D snyk`
+| Tool | Description |
+|------|-------------|
+| **TypeScript** | Type checking (`tsc --noEmit`) |
+| **ESLint** | Linting with plugins (react, sonarjs, unicorn, import, prettier) |
+| **Prettier** | Code formatting validation |
+| **Knip** | Dead code and unused export detection |
+| **Snyk** | Security vulnerability scanning |
 
-### Quick Setup
+## Package Manager Detection
 
-#### npm
-```bash
-# Install all quality tools
-npm install -D typescript eslint prettier knip snyk
+Automatically detected by lock file presence:
 
-# Minimal setup
-npm install -D typescript eslint prettier
-```
+1. `bun.lock` / `bun.lockb` → bun
+2. `pnpm-lock.yaml` → pnpm
+3. `yarn.lock` → yarn
+4. `package-lock.json` → npm
+5. Fallback: checks installed binaries, defaults to npm
 
-#### bun (recommended - faster)
-```bash
-# Install all quality tools
-bun add -D typescript eslint prettier knip snyk
+## Error Reporting
 
-# Minimal setup
-bun add -D typescript eslint prettier
-```
+Every run generates `.quality-report.md` with:
+- Status of each check (pass/fail)
+- Full error output for failed checks
+- AI-friendly structured information for automated fixes
 
-#### pnpm
-```bash
-# Install all quality tools
-pnpm add -D typescript eslint prettier knip snyk
+Add `.quality-report.md` to your `.gitignore`.
 
-# Minimal setup
-pnpm add -D typescript eslint prettier
-```
+## AI Skills
 
-#### yarn
-```bash
-# Install all quality tools
-yarn add -D typescript eslint prettier knip snyk
+This library includes `.ai/skills/` — markdown files that teach AI coding assistants (Cursor, Copilot, Windsurf, etc.) to follow the project's coding standards. See [`.ai/skills/README.md`](.ai/skills/README.md).
 
-# Minimal setup
-yarn add -D typescript eslint prettier
-```
+## Requirements
 
-**Note**: The library automatically skips tools that aren't installed, so you can start with just the tools you need and add more later.
+- **Node.js** >= 18.0.0
 
-## Framework Support
+## Testing & CI/CD
 
-Works with any Node.js framework: Next.js, React, Vue, Angular, Express, etc.
+Tested on every push across 4 runtimes:
+- **Node.js 25.x** (npm)
+- **Bun 1.3.x**
+- **pnpm 10.x**
+- **Yarn 4.13.0**
 
 ## Contributing
 
-Contributions welcome! Fork, create a feature branch, and submit a PR.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
-
-## Testing & CI/CD
-
-This library is automatically tested across multiple runtimes:
-- **Node.js** 25.x (npm)
-- **Bun** 1.3.x
-- **pnpm** 10.x
-- **Yarn** 4.13.0
-
-All tests run in parallel on every push and pull request. The library only publishes to npm when all tests pass.
-
+MIT — see [LICENSE](LICENSE).

package/index.d.ts

@@ -1,9 +1,16 @@
 export interface CodeQualityOptions {
+  /** Load environment variables from .env file (default: true) */
   loadEnv?: boolean;
+  /** Array of tool names to run (default: all tools) */
   tools?: string[];
+  /** Custom commands for each tool, keyed by tool name */
   commands?: Record<string, string>;
+  /** Custom descriptions for each tool, keyed by tool name */
   descriptions?: Record<string, string>;
+  /** Force a specific package manager (auto-detected if not specified) */
   packageManager?: 'bun' | 'pnpm' | 'yarn' | 'npm';
+  /** Show detailed error logs in terminal */
+  showLogs?: boolean;
 }
 
 export interface CommandResult {
@@ -11,21 +18,30 @@ export interface CommandResult {
   output: string;
 }
 
+export interface CheckResult {
+  name: string;
+  description: string;
+  success: boolean;
+  output: string;
+}
+
 export interface QualityCheckResult {
   success: boolean;
   message: string;
+  results: CheckResult[];
 }
 
 export class CodeQualityChecker {
+  options: Required<Omit<CodeQualityOptions, 'showLogs'>>;
+
   constructor(options?: CodeQualityOptions);
-  
+
+  /** Execute a single shell command and return the result */
   runCommand(command: string, description: string): CommandResult;
-  
-  formatOutput(tool: string, result: CommandResult): string;
-  
-  checkSnykToken(): boolean;
-  
-  run(): Promise<QualityCheckResult>;
+
+  /** Run all configured quality checks */
+  run(options?: { showLogs?: boolean }): Promise<QualityCheckResult>;
 }
 
+/** Convenience function to run quality checks without instantiating the class */
 export function runQualityCheck(options?: CodeQualityOptions): Promise<QualityCheckResult>;

package/index.js

@@ -4,199 +4,289 @@ const { execSync } = require('child_process');
 const path = require('path');
 const fs = require('fs');
 
-// Parse command line arguments
-const args = process.argv.slice(2);
-const showLogs = args.includes('--logs');
+// ─── Package Manager Detection ──────────────────────────────────────────────
+
+function detectPackageManager() {
+  const cwd = process.cwd();
+  const lockFiles = [
+    { file: 'bun.lock', pm: 'bun' },
+    { file: 'bun.lockb', pm: 'bun' },
+    { file: 'pnpm-lock.yaml', pm: 'pnpm' },
+    { file: 'yarn.lock', pm: 'yarn' },
+    { file: 'package-lock.json', pm: 'npm' },
+  ];
+
+  for (const { file, pm } of lockFiles) {
+    if (fs.existsSync(path.join(cwd, file))) return pm;
+  }
+
+  const binaries = ['bun', 'pnpm', 'yarn'];
+  for (const bin of binaries) {
+    try {
+      execSync(`which ${bin}`, { stdio: 'ignore' });
+      return bin;
+    } catch {
+      // not found, continue
+    }
+  }
+
+  return 'npm';
+}
+
+function getExecPrefix(pm) {
+  const map = { bun: 'bunx', pnpm: 'pnpm dlx', yarn: 'yarn dlx', npm: 'npx' };
+  return map[pm] || 'npx';
+}
+
+function getRunPrefix(pm) {
+  const map = { bun: 'bun run', pnpm: 'pnpm run', yarn: 'yarn', npm: 'npm run' };
+  return map[pm] || 'npm run';
+}
+
+// ─── Environment Loading ────────────────────────────────────────────────────
 
-// Load environment variables from .env file
 function loadEnvFile() {
   try {
     const envPath = path.join(process.cwd(), '.env');
-    if (fs.existsSync(envPath)) {
-      const envContent = fs.readFileSync(envPath, 'utf8');
-      const lines = envContent.split('\n');
-      
-      lines.forEach(line => {
-        const trimmed = line.trim();
-        if (trimmed && !trimmed.startsWith('#')) {
-          const [key, ...valueParts] = trimmed.split('=');
-          if (key && valueParts.length > 0) {
-            process.env[key] = valueParts.join('=');
-          }
-        }
-      });
-      
-      console.log('✅ Loaded environment variables from .env');
+    if (!fs.existsSync(envPath)) return;
+
+    const content = fs.readFileSync(envPath, 'utf8');
+    for (const line of content.split('\n')) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith('#')) continue;
+      const eqIndex = trimmed.indexOf('=');
+      if (eqIndex === -1) continue;
+      const key = trimmed.slice(0, eqIndex);
+      const value = trimmed.slice(eqIndex + 1);
+      if (key) process.env[key] = value;
     }
-  } catch (error) {
-    console.log('⚠️  Could not load .env file:', error.message);
+  } catch {
+    // silently continue without .env
   }
 }
 
-loadEnvFile();
+// ─── Tool Path Resolution ───────────────────────────────────────────────────
 
-console.log('\n🔍 Professional Code Quality Check\n');
-console.log('─'.repeat(50));
-console.log('📦 Using bun package manager\n');
-
-if (showLogs) {
-  console.log('📋 Detailed error logging enabled (--logs flag)\n');
+function resolveToolBinDir() {
+  try {
+    return path.join(
+      path.dirname(require.resolve('code-quality-lib/package.json')),
+      'node_modules',
+      '.bin'
+    );
+  } catch {
+    return path.join(__dirname, 'node_modules', '.bin');
+  }
 }
 
-// Prepare report
-const reportPath = path.join(process.cwd(), '.quality-report.md');
-const timestamp = new Date().toISOString();
-let reportContent = `# Code Quality Report\n\n`;
-reportContent += `**Generated**: ${timestamp}\n`;
-reportContent += `**Package Manager**: npm\n\n`;
-reportContent += `---\n\n`;
-
-// Get paths to bundled tools - try to resolve from library location
-let libPath;
-try {
-  libPath = path.dirname(require.resolve('code-quality-lib/package.json'));
-} catch {
-  // Fallback to current directory if running from library itself
-  libPath = __dirname;
-}
+// ─── Default Checks ─────────────────────────────────────────────────────────
 
-const tscPath = path.join(libPath, 'node_modules', '.bin', 'tsc');
-const eslintPath = path.join(libPath, 'node_modules', '.bin', 'eslint');
-const prettierPath = path.join(libPath, 'node_modules', '.bin', 'prettier');
-const knipPath = path.join(libPath, 'node_modules', '.bin', 'knip');
-const snykPath = path.join(libPath, 'node_modules', '.bin', 'snyk');
-
-// Run quality checks using bundled dependencies
-const checks = [
-  { name: 'TypeScript', cmd: `${tscPath} --noEmit`, description: 'Type checking and compilation' },
-  { name: 'ESLint', cmd: `${eslintPath} . --ext .js,.jsx,.ts,.tsx`, description: 'Code linting and style checking' },
-  { name: 'Prettier', cmd: `${prettierPath} --check .`, description: 'Code formatting validation' },
-  { name: 'Knip', cmd: `${knipPath}`, description: 'Dead code detection' },
-  { name: 'Snyk', cmd: `${snykPath} test --severity-threshold=high`, description: 'Security vulnerability scanning' }
+const DEFAULT_TOOLS = [
+  { name: 'TypeScript', bin: 'tsc', args: '--noEmit', description: 'Type checking and compilation' },
+  { name: 'ESLint', bin: 'eslint', args: '. --ext .js,.jsx,.ts,.tsx', description: 'Code linting and style checking' },
+  { name: 'Prettier', bin: 'prettier', args: '--check .', description: 'Code formatting validation' },
+  { name: 'Knip', bin: 'knip', args: '', description: 'Dead code detection' },
+  { name: 'Snyk', bin: 'snyk', args: 'test --severity-threshold=high', description: 'Security vulnerability scanning' },
 ];
 
-let allPassed = true;
-const results = [];
+// ─── CodeQualityChecker Class ───────────────────────────────────────────────
 
-checks.forEach(({ name, cmd, description }) => {
-  console.log(`Running ${name}...`);
-  
-  reportContent += `## ${name}\n\n`;
-  reportContent += `**Description**: ${description}\n\n`;
-  reportContent += `**Command**: \`${cmd}\`\n\n`;
-  
-  try {
-    const output = execSync(cmd, { stdio: 'pipe', encoding: 'utf8' });
-    console.log(`✅ ${name}: Passed`);
-    
-    reportContent += `**Status**: ✅ **PASSED**\n\n`;
-    if (output && output.trim()) {
-      reportContent += `**Output**:\n\`\`\`\n${output.trim()}\n\`\`\`\n\n`;
-      
-      if (showLogs) {
-        console.log(`\n📄 ${name} Output:`);
-        console.log(output.trim());
+class CodeQualityChecker {
+  constructor(options = {}) {
+    this.options = {
+      loadEnv: options.loadEnv !== false,
+      tools: options.tools || DEFAULT_TOOLS.map((t) => t.name),
+      commands: options.commands || {},
+      descriptions: options.descriptions || {},
+      packageManager: options.packageManager || detectPackageManager(),
+    };
+
+    if (this.options.loadEnv) loadEnvFile();
+  }
+
+  _getChecks() {
+    const binDir = resolveToolBinDir();
+    const checks = [];
+
+    for (const toolName of this.options.tools) {
+      const defaultTool = DEFAULT_TOOLS.find((t) => t.name === toolName);
+      if (!defaultTool && !this.options.commands[toolName]) continue;
+
+      const cmd =
+        this.options.commands[toolName] ||
+        `${path.join(binDir, defaultTool.bin)}${defaultTool.args ? ' ' + defaultTool.args : ''}`;
+
+      const description =
+        this.options.descriptions[toolName] ||
+        (defaultTool ? defaultTool.description : toolName);
+
+      checks.push({ name: toolName, cmd, description });
+    }
+
+    return checks;
+  }
+
+  runCommand(command, description) {
+    try {
+      const output = execSync(command, { stdio: 'pipe', encoding: 'utf8' });
+      return { success: true, output: (output || '').trim() };
+    } catch (error) {
+      const output = error.stdout || error.stderr || error.message || 'Unknown error';
+      return { success: false, output: output.trim() };
+    }
+  }
+
+  async run(options = {}) {
+    const showLogs = options.showLogs || false;
+    const checks = this._getChecks();
+    const pm = this.options.packageManager;
+    const runCmd = getRunPrefix(pm);
+    const results = [];
+    let allPassed = true;
+
+    console.log('\n� Professional Code Quality Check\n');
+    console.log('─'.repeat(50));
+    console.log(`📦 Using ${pm} package manager\n`);
+
+    if (showLogs) {
+      console.log('📋 Detailed error logging enabled (--logs flag)\n');
+    }
+
+    for (const { name, cmd, description } of checks) {
+      console.log(`Running ${name}...`);
+      const result = this.runCommand(cmd, description);
+
+      if (result.success) {
+        console.log(`✅ ${name}: Passed`);
+      } else {
+        allPassed = false;
+        console.log(`❌ ${name}: Failed`);
+      }
+
+      if (showLogs && result.output) {
+        const icon = result.success ? '📄' : '❌';
+        console.log(`\n${icon} ${name} ${result.success ? 'Output' : 'Error Details'}:`);
+        console.log('─'.repeat(50));
+        console.log(result.output);
+        console.log('─'.repeat(50));
         console.log('');
       }
+
+      results.push({ name, description, ...result });
     }
-    
-    results.push({ name, status: 'passed', output: output.trim() });
-  } catch (error) {
-    allPassed = false;
-    const errorOutput = error.stdout || error.stderr || error.message || 'Unknown error';
-    console.log(`❌ ${name}: Failed`);
-    
-    // Show errors in terminal if --logs flag is present
-    if (showLogs) {
-      console.log(`\n❌ ${name} Error Details:`);
-      console.log('─'.repeat(50));
-      console.log(errorOutput.trim());
-      console.log('─'.repeat(50));
-      console.log('');
+
+    // Generate report
+    this._writeReport(results, allPassed, pm, runCmd);
+
+    console.log('\n' + '─'.repeat(50));
+
+    if (allPassed) {
+      console.log('\n🎉 All quality checks passed! Code is ready for production.\n');
+    } else {
+      console.log('\n❌ Some quality checks failed. Please fix the issues above.\n');
+      if (!showLogs) {
+        console.log('💡 Run with --logs flag to see detailed errors in terminal');
+      }
+      console.log('📄 See .quality-report.md for detailed error information\n');
     }
-    
-    reportContent += `**Status**: ❌ **FAILED**\n\n`;
-    reportContent += `**Error Output**:\n\`\`\`\n${errorOutput.trim()}\n\`\`\`\n\n`;
-    
-    // Add suggestions for common issues
-    reportContent += `**Suggestions**:\n`;
-    if (name === 'TypeScript') {
-      reportContent += `- Check type errors in the output above\n`;
-      reportContent += `- Run \`npx tsc --noEmit\` to see detailed errors\n`;
-      reportContent += `- Fix type mismatches and missing type definitions\n`;
-    } else if (name === 'ESLint') {
-      reportContent += `- Run \`bun run lint:fix\` to auto-fix issues\n`;
-      reportContent += `- Check ESLint errors in the output above\n`;
-      reportContent += `- Review and fix code style violations\n`;
-    } else if (name === 'Prettier') {
-      reportContent += `- Run \`bun run format:fix\` to auto-format files\n`;
-      reportContent += `- Check formatting issues in the output above\n`;
-    } else if (name === 'Knip') {
-      reportContent += `- Remove unused exports and dependencies\n`;
-      reportContent += `- Check dead code in the output above\n`;
-    } else if (name === 'Snyk') {
-      reportContent += `- Review security vulnerabilities in the output above\n`;
-      reportContent += `- Update vulnerable dependencies\n`;
-      reportContent += `- Run \`npx snyk wizard\` for guided fixes\n`;
+
+    return {
+      success: allPassed,
+      message: allPassed ? 'All quality checks passed' : 'Some quality checks failed',
+      results,
+    };
+  }
+
+  _writeReport(results, allPassed, pm, runCmd) {
+    const reportPath = path.join(process.cwd(), '.quality-report.md');
+    const timestamp = new Date().toISOString();
+    const passed = results.filter((r) => r.success);
+    const failed = results.filter((r) => !r.success);
+
+    let report = `# Code Quality Report\n\n`;
+    report += `**Generated**: ${timestamp}\n`;
+    report += `**Package Manager**: ${pm}\n\n`;
+    report += `---\n\n`;
+
+    for (const r of results) {
+      report += `## ${r.name}\n\n`;
+      report += `**Description**: ${r.description}\n\n`;
+      report += `**Status**: ${r.success ? '✅ **PASSED**' : '❌ **FAILED**'}\n\n`;
+      if (r.output) {
+        report += `**Output**:\n\`\`\`\n${r.output}\n\`\`\`\n\n`;
+      }
+      report += `---\n\n`;
+    }
+
+    report += `## Summary\n\n`;
+    report += `**Total Checks**: ${results.length}\n`;
+    report += `**Passed**: ${passed.length}\n`;
+    report += `**Failed**: ${failed.length}\n\n`;
+
+    if (allPassed) {
+      report += `### ✅ All quality checks passed!\n\nYour code is ready for production.\n\n`;
+    } else {
+      report += `### ❌ Some quality checks failed\n\n`;
+      report += `**Quick Fix Commands**:\n`;
+      report += `- \`${runCmd} lint:fix\` — Auto-fix linting issues\n`;
+      report += `- \`${runCmd} format:fix\` — Auto-format code\n\n`;
+    }
+
+    report += `---\n\n## For AI Agents\n\n`;
+    report += `**Failed Checks**: ${failed.map((r) => r.name).join(', ') || 'None'}\n\n`;
+    if (!allPassed) {
+      report += `**Action Required**:\n`;
+      for (const r of failed) {
+        report += `- Fix ${r.name} errors\n`;
+      }
+      report += `\n`;
+    }
+
+    try {
+      fs.writeFileSync(reportPath, report, 'utf8');
+      console.log(`\n📄 Quality report saved to: .quality-report.md`);
+    } catch (err) {
+      console.error(`\n⚠️  Failed to write report: ${err.message}`);
     }
-    reportContent += `\n`;
-    
-    results.push({ name, status: 'failed', error: errorOutput.trim() });
   }
-  
-  reportContent += `---\n\n`;
-});
-
-// Add summary
-reportContent += `## Summary\n\n`;
-reportContent += `**Total Checks**: ${checks.length}\n`;
-reportContent += `**Passed**: ${results.filter(r => r.status === 'passed').length}\n`;
-reportContent += `**Failed**: ${results.filter(r => r.status === 'failed').length}\n\n`;
-
-if (allPassed) {
-  reportContent += `### ✅ All quality checks passed!\n\n`;
-  reportContent += `Your code is ready for production.\n\n`;
-} else {
-  reportContent += `### ❌ Some quality checks failed\n\n`;
-  reportContent += `Please review the errors above and fix the issues.\n\n`;
-  reportContent += `**Quick Fix Commands**:\n`;
-  reportContent += `- \`bun run fix\` - Auto-fix linting and formatting\n`;
-  reportContent += `- \`bun run type:check\` - Check TypeScript errors\n`;
-  reportContent += `- \`bun run lint:check\` - Check ESLint errors\n`;
-  reportContent += `- \`bun run format:check\` - Check Prettier formatting\n\n`;
 }
 
-// Add AI Agent section
-reportContent += `---\n\n`;
-reportContent += `## For AI Agents\n\n`;
-reportContent += `This report contains detailed error information for automated code quality fixes.\n\n`;
-reportContent += `**Failed Checks**: ${results.filter(r => r.status === 'failed').map(r => r.name).join(', ') || 'None'}\n\n`;
-if (!allPassed) {
-  reportContent += `**Action Required**:\n`;
-  results.filter(r => r.status === 'failed').forEach(r => {
-    reportContent += `- Fix ${r.name} errors\n`;
-  });
-  reportContent += `\n`;
-}
+// ─── Convenience Function ───────────────────────────────────────────────────
 
-// Write report to file (overwrite existing)
-try {
-  fs.writeFileSync(reportPath, reportContent, 'utf8');
-  console.log(`\n📄 Quality report saved to: .quality-report.md`);
-} catch (error) {
-  console.error(`\n⚠️  Failed to write report: ${error.message}`);
+async function runQualityCheck(options = {}) {
+  const checker = new CodeQualityChecker(options);
+  return checker.run({ showLogs: options.showLogs || false });
 }
 
-console.log('\n' + '─'.repeat(50));
+// ─── CLI Entry Point ────────────────────────────────────────────────────────
+
+if (require.main === module) {
+  const args = process.argv.slice(2);
+
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log('Usage: code-quality [options]');
+    console.log('');
+    console.log('Options:');
+    console.log('  --help, -h     Show this help message');
+    console.log('  --version, -v  Show version number');
+    console.log('  --logs         Show detailed error logs');
+    console.log('');
+    console.log('Runs TypeScript, ESLint, Prettier, Knip, and Snyk checks.');
+    process.exit(0);
+  }
 
-if (allPassed) {
-  console.log('\n🎉 All quality checks passed! Code is ready for production.\n');
-  process.exit(0);
-} else {
-  console.log('\n❌ Some quality checks failed. Please fix the issues above.\n');
-  if (!showLogs) {
-    console.log('💡 Run with --logs flag to see detailed errors in terminal');
+  if (args.includes('--version') || args.includes('-v')) {
+    const pkg = require('./package.json');
+    console.log(pkg.version);
+    process.exit(0);
   }
-  console.log('📄 See .quality-report.md for detailed error information\n');
-  process.exit(1);
+
+  const checker = new CodeQualityChecker();
+  checker.run({ showLogs: args.includes('--logs') }).then((result) => {
+    process.exit(result.success ? 0 : 1);
+  });
 }
+
+// ─── Exports ────────────────────────────────────────────────────────────────
+
+module.exports = { CodeQualityChecker, runQualityCheck };

package/package.json

@@ -1,19 +1,16 @@
 {
   "name": "code-quality-lib",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "A configurable code quality checker library for Node.js projects",
   "main": "index.js",
+  "types": "index.d.ts",
   "bin": {
     "code-quality": "index.js"
   },
   "scripts": {
     "test": "node test/basic.test.js",
-    "test:ci": "node test/basic.test.js",
     "start": "node index.js",
-    "lint": "echo 'Linting not configured yet'",
-    "format": "echo 'Formatting not configured yet'",
-    "build": "echo 'No build step required'",
-    "prepublishOnly": "echo 'Skipping tests for publishing'"
+    "prepublishOnly": "npm test"
   },
   "keywords": [
     "code-quality",
@@ -24,40 +21,35 @@
     "knip",
     "quality-check"
   ],
-  "author": "",
+  "author": "NoonCore",
   "license": "MIT",
   "type": "commonjs",
   "engines": {
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "typescript": "^5.8.3",
-    "eslint": "^9.18.0",
-    "prettier": "^3.4.2",
     "@typescript-eslint/eslint-plugin": "^8.20.0",
     "@typescript-eslint/parser": "^8.20.0",
+    "eslint": "^9.18.0",
     "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-prettier": "^5.2.1",
     "eslint-plugin-react": "^7.37.2",
     "eslint-plugin-react-hooks": "^5.1.0",
     "eslint-plugin-react-refresh": "^0.4.16",
+    "eslint-plugin-sonarjs": "^4.0.2",
     "eslint-plugin-storybook": "^0.11.1",
-    "eslint-plugin-sonarjs": "^2.0.4",
     "eslint-plugin-unicorn": "^57.0.0",
-    "eslint-plugin-import": "^2.31.0",
     "knip": "^5.43.2",
-    "snyk": "^1.1293.1"
+    "prettier": "^3.4.2",
+    "snyk": "^1.1293.1",
+    "typescript": "^5.8.3"
   },
   "files": [
     "index.js",
     "index.d.ts",
     "README.md",
-    "LICENSE",
-    ".eslintrc.js",
-    ".prettierrc",
-    "knip.json",
-    "tsconfig.json",
-    ".code-quality.json.example"
+    "LICENSE"
   ],
   "repository": {
     "type": "git",

package/.code-quality.json.example

@@ -1,8 +0,0 @@
-{
-  "useLibraryRules": true,
-  "useProjectRules": false,
-  "customSetup": false,
-  "tools": ["TypeScript", "ESLint", "Prettier", "Knip", "Snyk"],
-  "copyConfigs": true,
-  "version": "1.0.1"
-}

package/.eslintrc.js

@@ -1,121 +0,0 @@
-module.exports = {
-  root: true,
-  env: {
-    browser: true,
-    es2022: true,
-    node: true,
-  },
-  extends: [
-    'eslint:recommended',
-    '@typescript-eslint/recommended',
-    '@typescript-eslint/recommended-requiring-type-checking',
-    'plugin:react/recommended',
-    'plugin:react-hooks/recommended',
-    'plugin:storybook/recommended',
-    'prettier',
-  ],
-  parser: '@typescript-eslint/parser',
-  parserOptions: {
-    ecmaFeatures: {
-      jsx: true,
-    },
-    ecmaVersion: 'latest',
-    sourceType: 'module',
-    project: ['./tsconfig.json', './tsconfig.node.json'],
-    tsconfigRootDir: __dirname,
-  },
-  plugins: [
-    'react',
-    'react-hooks',
-    'react-refresh',
-    '@typescript-eslint',
-    'sonarjs',
-    'unicorn',
-    'import',
-    'prettier',
-  ],
-  rules: {
-    // TypeScript
-    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
-    '@typescript-eslint/no-explicit-any': 'warn',
-    '@typescript-eslint/prefer-nullish-coalescing': 'error',
-    '@typescript-eslint/prefer-optional-chain': 'error',
-    '@typescript-eslint/no-non-null-assertion': 'warn',
-    
-    // React
-    'react/react-in-jsx-scope': 'off',
-    'react/prop-types': 'off',
-    'react-hooks/rules-of-hooks': 'error',
-    'react-hooks/exhaustive-deps': 'warn',
-    'react-refresh/only-export-components': ['warn', { allowConstantExport: true }],
-    
-    // Code Quality
-    'sonarjs/cognitive-complexity': ['warn', 15],
-    'sonarjs/no-duplicate-string': 'warn',
-    'sonarjs/no-identical-functions': 'warn',
-    
-    // Best Practices
-    'unicorn/no-array-for-each': 'error',
-    'unicorn/prefer-array-some': 'error',
-    'unicorn/no-new-array': 'error',
-    'unicorn/prefer-node-protocol': 'error',
-    
-    // Import/Export
-    'import/order': [
-      'error',
-      {
-        groups: [
-          'builtin',
-          'external',
-          'internal',
-          'parent',
-          'sibling',
-          'index',
-        ],
-        'newlines-between': 'always',
-        alphabetize: {
-          order: 'asc',
-          caseInsensitive: true,
-        },
-      },
-    ],
-    
-    // Prettier (conflicts handled by eslint-config-prettier)
-    'prettier/prettier': 'error',
-    
-    // General
-    'no-console': ['warn', { allow: ['warn', 'error'] }],
-    'no-debugger': 'error',
-    'prefer-const': 'error',
-    'no-var': 'error',
-  },
-  settings: {
-    react: {
-      version: 'detect',
-    },
-    'import/resolver': {
-      typescript: {
-        alwaysTryTypes: true,
-      },
-    },
-  },
-  overrides: [
-    {
-      files: ['**/*.test.ts', '**/*.test.tsx', '**/*.spec.ts', '**/*.spec.tsx'],
-      env: {
-        jest: true,
-      },
-      rules: {
-        '@typescript-eslint/no-explicit-any': 'off',
-        'sonarjs/no-duplicate-string': 'off',
-      },
-    },
-    {
-      files: ['**/*.stories.@(js|jsx|ts|tsx|mdx)'],
-      rules: {
-        'import/no-extraneous-dependencies': 'off',
-        'react/prop-types': 'off',
-      },
-    },
-  ],
-};

package/.prettierrc

@@ -1,17 +0,0 @@
-{
-  "semi": false,
-  "trailingComma": "es5",
-  "singleQuote": true,
-  "printWidth": 100,
-  "tabWidth": 2,
-  "useTabs": false,
-  "endOfLine": "lf",
-  "arrowParens": "always",
-  "bracketSpacing": true,
-  "bracketSameLine": false,
-  "quoteProps": "as-needed",
-  "jsxSingleQuote": true,
-  "proseWrap": "preserve",
-  "htmlWhitespaceSensitivity": "css",
-  "embeddedLanguageFormatting": "auto"
-}

package/knip.json

@@ -1,76 +0,0 @@
-{
-  "entry": ["index.js", "index.d.ts"],
-  "project": ["package.json"],
-  "ignore": [
-    "node_modules",
-    "dist",
-    "build",
-    "coverage",
-    "*.config.js",
-    "*.config.ts",
-    "test/**",
-    "**/*.test.*",
-    "**/*.spec.*",
-    "examples/**"
-  ],
-  "ignoreBinaries": ["code-quality"],
-  "ignoreDependencies": [
-    "@types/*",
-    "eslint",
-    "prettier",
-    "typescript",
-    "vitest",
-    "storybook"
-  ],
-  "rules": {
-    "dependencies": {
-      "entries": {
-        "entryFiles": ["index.js", "index.d.ts"],
-        "ignore": []
-      },
-      "exports": {
-        "ignore": []
-      },
-      "files": {
-        "ignore": [
-          "test/**",
-          "**/*.test.*",
-          "**/*.spec.*",
-          "examples/**"
-        ]
-      },
-      "classMembers": {
-        "ignore": []
-      },
-      "enums": {
-        "ignore": []
-      },
-      "enumMembers": {
-        "ignore": []
-      },
-      "types": {
-        "ignore": []
-      }
-    },
-    "exports": {
-      "ignore": []
-    },
-    "files": {
-      "ignore": [
-        "test/**",
-        "**/*.test.*",
-        "**/*.spec.*",
-        "examples/**"
-      ]
-    },
-    "duplicates": {
-      "ignore": []
-    },
-    "unlisted": {
-      "ignore": []
-    },
-    "unresolved": {
-      "ignore": []
-    }
-  }
-}

package/tsconfig.json

@@ -1,41 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2022"],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "allowSyntheticDefaultImports": true,
-    "strict": true,
-    "forceConsistentCasingInFileNames": true,
-    "noFallthroughCasesInSwitch": true,
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "declaration": true,
-    "declarationMap": true,
-    "outDir": "dist",
-    "rootDir": ".",
-    "jsx": "react-jsx",
-    "incremental": true,
-    "noUncheckedIndexedAccess": true,
-    "exactOptionalPropertyTypes": true,
-    "noImplicitReturns": true,
-    "noImplicitOverride": true,
-    "noPropertyAccessFromIndexSignature": false
-  },
-  "include": [
-    "index.js",
-    "index.d.ts",
-    "test/**/*"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist",
-    "build",
-    "coverage",
-    "examples"
-  ]
-}