projscan 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abhi Yoheswaran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,193 @@
+# projscan
+
+Instant codebase insights — doctor, x-ray, and architecture map for any repository.
+
+Run once, learn something immediately. Run daily, improve your codebase.
+
+## Install
+
+```bash
+npm install -g projscan
+```
+
+Or run directly:
+
+```bash
+npx projscan
+```
+
+## Quick Start
+
+Run inside any repository:
+
+```bash
+projscan
+```
+
+This runs the default `analyze` command and outputs a full project report including language breakdown, frameworks, structure, issues, and suggestions.
+
+For a comprehensive walkthrough of every feature, use case, and output format, see the **[Full Guide](docs/GUIDE.md)**.
+
+## Commands
+
+### `projscan analyze`
+
+Full project analysis — language detection, framework detection, dependency audit, and issue scanning.
+
+```bash
+projscan analyze
+```
+
+### `projscan doctor`
+
+Health check for your project. Detects missing tooling, architecture smells, and dependency risks.
+
+```bash
+projscan doctor
+```
+
+Example output:
+
+```
+Project Health Report
+──────────────────────────────────────────
+
+  Found 3 warnings, 2 info
+
+Issues Detected
+──────────────────────────────────────────
+  ⚠ No ESLint configuration
+  ⚠ No Prettier configuration
+  ⚠ No test framework detected
+  ℹ Missing .editorconfig
+  ℹ README is nearly empty
+
+Recommendations
+──────────────────────────────────────────
+  1. Fix: No ESLint configuration
+  2. Fix: No Prettier configuration
+  3. Fix: No test framework detected
+  4. Fix: Missing .editorconfig
+
+  Run projscan fix to auto-fix 4 issues.
+```
+
+### `projscan fix`
+
+Automatically installs and configures missing developer tools.
+
+```bash
+projscan fix
+```
+
+Detects issues, proposes fixes, prompts for confirmation, then applies:
+
+- Installs ESLint with TypeScript support
+- Installs Prettier with sensible defaults
+- Installs Vitest with a sample test
+- Creates `.editorconfig`
+
+Use `-y` to skip the prompt:
+
+```bash
+projscan fix -y
+```
+
+### `projscan explain <file>`
+
+Explains a file — its purpose, imports, exports, and potential issues.
+
+```bash
+projscan explain src/services/payment.ts
+```
+
+### `projscan diagram`
+
+Generates an ASCII architecture diagram showing project layers and technologies.
+
+```bash
+projscan diagram
+```
+
+### `projscan structure`
+
+Shows the project directory tree with file counts.
+
+```bash
+projscan structure
+```
+
+### `projscan dependencies`
+
+Analyzes project dependencies — counts, risks, and recommendations.
+
+```bash
+projscan dependencies
+```
+
+## Output Formats
+
+All commands support `--format` for different output targets:
+
+```bash
+projscan analyze --format json
+projscan doctor --format markdown > HEALTH.md
+```
+
+Formats: `console` (default), `json`, `markdown`
+
+## Options
+
+| Flag | Description |
+|------|-------------|
+| `--format <type>` | Output format: console, json, markdown |
+| `--verbose` | Enable debug output |
+| `--quiet` | Suppress non-essential output |
+| `-V, --version` | Show version |
+| `-h, --help` | Show help |
+
+## Performance
+
+ProjScan is designed for speed:
+
+- 5,000 files analyzed in under 1.5 seconds
+- 20,000 files analyzed in under 3 seconds
+- Zero network requests — everything runs locally
+- Minimal dependencies (4 runtime packages)
+
+## What It Detects
+
+**Languages**: TypeScript, JavaScript, Python, Go, Rust, Java, Ruby, C/C++, PHP, Swift, Kotlin, and 20+ more
+
+**Frameworks**: React, Next.js, Vue, Nuxt, Svelte, Angular, Express, Fastify, NestJS, Vite, Tailwind CSS, Prisma, and more
+
+**Issues**:
+- Missing ESLint configuration
+- Missing Prettier configuration
+- Missing test framework
+- Missing `.editorconfig`
+- Large utility directories (architecture smell)
+- Excessive dependencies
+- Deprecated packages
+- Wildcard version ranges
+- Missing lockfile
+
+## Development
+
+```bash
+git clone https://github.com/your-org/projscan.git
+cd projscan
+npm install
+npm run build
+npm link
+```
+
+Run tests:
+
+```bash
+npm test
+```
+
+## License
+
+MIT

package/dist/analyzers/architectureCheck.d.ts

@@ -0,0 +1,2 @@
+import type { FileEntry, Issue } from '../types.js';
+export declare function check(rootPath: string, files: FileEntry[]): Promise<Issue[]>;

package/dist/analyzers/architectureCheck.js

@@ -0,0 +1,91 @@
+import path from 'node:path';
+const LARGE_DIR_THRESHOLD = 10;
+const SUSPECT_DIRS = ['utils', 'helpers', 'lib', 'shared'];
+export async function check(rootPath, files) {
+    const issues = [];
+    // Check for large utility directories
+    const dirFileCounts = new Map();
+    for (const file of files) {
+        const parts = file.directory.split(path.sep);
+        for (const part of parts) {
+            if (SUSPECT_DIRS.includes(part)) {
+                const key = file.directory;
+                dirFileCounts.set(key, (dirFileCounts.get(key) ?? 0) + 1);
+            }
+        }
+    }
+    for (const [dir, count] of dirFileCounts) {
+        if (count > LARGE_DIR_THRESHOLD) {
+            const dirName = path.basename(dir);
+            issues.push({
+                id: `large-${dirName}-dir`,
+                title: `Large ${dirName}/ directory (${count} files)`,
+                description: `The ${dir}/ directory contains ${count} files. Consider splitting into domain-specific modules for better organization.`,
+                severity: 'warning',
+                category: 'architecture',
+                fixAvailable: false,
+            });
+        }
+    }
+    // Check for missing source directory organization
+    const hasSourceDir = files.some((f) => {
+        const topDir = f.directory.split(path.sep)[0];
+        return ['src', 'lib', 'app', 'pages', 'source'].includes(topDir);
+    });
+    const hasCodeFiles = files.some((f) => ['.js', '.jsx', '.ts', '.tsx', '.py', '.go', '.rs', '.java'].includes(f.extension));
+    if (hasCodeFiles && !hasSourceDir) {
+        const rootCodeFiles = files.filter((f) => (!f.directory || f.directory === '.') &&
+            ['.js', '.jsx', '.ts', '.tsx'].includes(f.extension));
+        if (rootCodeFiles.length > 3) {
+            issues.push({
+                id: 'no-source-dir',
+                title: 'No source directory organization',
+                description: 'Source code files are at the project root without a src/ or app/ directory. Consider organizing code into a source directory.',
+                severity: 'info',
+                category: 'architecture',
+                fixAvailable: false,
+            });
+        }
+    }
+    // Check for missing .editorconfig
+    const hasEditorConfig = files.some((f) => path.basename(f.relativePath) === '.editorconfig' && (!f.directory || f.directory === '.'));
+    if (!hasEditorConfig) {
+        issues.push({
+            id: 'missing-editorconfig',
+            title: 'Missing .editorconfig',
+            description: 'No .editorconfig file found. EditorConfig helps maintain consistent coding styles across different editors.',
+            severity: 'info',
+            category: 'architecture',
+            fixAvailable: true,
+            fixId: 'add-editorconfig',
+        });
+    }
+    // Check for missing or empty README
+    const readmeFile = files.find((f) => {
+        const name = path.basename(f.relativePath).toLowerCase();
+        return ((name === 'readme.md' || name === 'readme' || name === 'readme.txt') &&
+            (!f.directory || f.directory === '.'));
+    });
+    if (!readmeFile) {
+        issues.push({
+            id: 'missing-readme',
+            title: 'Missing README',
+            description: 'No README file found. A README is essential for project documentation and onboarding.',
+            severity: 'warning',
+            category: 'architecture',
+            fixAvailable: false,
+        });
+    }
+    else if (readmeFile.sizeBytes < 50) {
+        issues.push({
+            id: 'empty-readme',
+            title: 'README is nearly empty',
+            description: 'The README file contains very little content. Consider adding project description, setup instructions, and usage examples.',
+            severity: 'info',
+            category: 'architecture',
+            fixAvailable: false,
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=architectureCheck.js.map

package/dist/analyzers/architectureCheck.js.map

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

package/dist/analyzers/dependencyRiskCheck.d.ts

@@ -0,0 +1,2 @@
+import type { FileEntry, Issue } from '../types.js';
+export declare function check(rootPath: string, _files: FileEntry[]): Promise<Issue[]>;

package/dist/analyzers/dependencyRiskCheck.js

@@ -0,0 +1,17 @@
+import { analyzeDependencies } from '../core/dependencyAnalyzer.js';
+export async function check(rootPath, _files) {
+    const report = await analyzeDependencies(rootPath);
+    if (!report)
+        return [];
+    return report.risks.map((risk) => ({
+        id: `dep-risk-${risk.name}`,
+        title: risk.name === 'excessive-dependencies' || risk.name === 'many-dependencies' || risk.name === 'no-lockfile'
+            ? risk.reason
+            : `Dependency risk: ${risk.name}`,
+        description: risk.reason,
+        severity: risk.severity === 'high' ? 'error' : risk.severity === 'medium' ? 'warning' : 'info',
+        category: 'dependencies',
+        fixAvailable: false,
+    }));
+}
+//# sourceMappingURL=dependencyRiskCheck.js.map

package/dist/analyzers/dependencyRiskCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencyRiskCheck.js","sourceRoot":"","sources":["../../src/analyzers/dependencyRiskCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGpE,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAgB,EAAE,MAAmB;IAC/D,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjC,EAAE,EAAE,YAAY,IAAI,CAAC,IAAI,EAAE;QAC3B,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,wBAAwB,IAAI,IAAI,CAAC,IAAI,KAAK,mBAAmB,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa;YAC/G,CAAC,CAAC,IAAI,CAAC,MAAM;YACb,CAAC,CAAC,oBAAoB,IAAI,CAAC,IAAI,EAAE;QACnC,WAAW,EAAE,IAAI,CAAC,MAAM;QACxB,QAAQ,EAAE,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,OAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAkB,CAAC,CAAC,CAAC,MAAe;QACzH,QAAQ,EAAE,cAAc;QACxB,YAAY,EAAE,KAAK;KACpB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/analyzers/eslintCheck.d.ts

@@ -0,0 +1,2 @@
+import type { FileEntry, Issue } from '../types.js';
+export declare function check(rootPath: string, files: FileEntry[]): Promise<Issue[]>;

package/dist/analyzers/eslintCheck.js

@@ -0,0 +1,49 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const ESLINT_CONFIG_FILES = [
+    '.eslintrc',
+    '.eslintrc.js',
+    '.eslintrc.cjs',
+    '.eslintrc.json',
+    '.eslintrc.yml',
+    '.eslintrc.yaml',
+    'eslint.config.js',
+    'eslint.config.mjs',
+    'eslint.config.cjs',
+    'eslint.config.ts',
+    'eslint.config.mts',
+];
+export async function check(rootPath, files) {
+    const rootFiles = new Set(files.filter((f) => !f.directory || f.directory === '.').map((f) => path.basename(f.relativePath)));
+    // Check for config files
+    for (const configFile of ESLINT_CONFIG_FILES) {
+        if (rootFiles.has(configFile))
+            return [];
+    }
+    // Check for eslintConfig in package.json
+    try {
+        const raw = await fs.readFile(path.join(rootPath, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        if (pkg.eslintConfig)
+            return [];
+    }
+    catch {
+        // No package.json or invalid JSON
+    }
+    // Check if this is a JS/TS project (ESLint only relevant for these)
+    const hasJsTs = files.some((f) => ['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs'].includes(f.extension));
+    if (!hasJsTs)
+        return [];
+    return [
+        {
+            id: 'missing-eslint',
+            title: 'No ESLint configuration',
+            description: 'No ESLint configuration file detected. ESLint helps catch bugs and enforce code style.',
+            severity: 'warning',
+            category: 'linting',
+            fixAvailable: true,
+            fixId: 'add-eslint',
+        },
+    ];
+}
+//# sourceMappingURL=eslintCheck.js.map

package/dist/analyzers/eslintCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslintCheck.js","sourceRoot":"","sources":["../../src/analyzers/eslintCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,mBAAmB,GAAG;IAC1B,WAAW;IACX,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,gBAAgB;IAChB,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;IACnB,kBAAkB;IAClB,mBAAmB;CACpB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAgB,EAAE,KAAkB;IAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CACnG,CAAC;IAEF,yBAAyB;IACzB,KAAK,MAAM,UAAU,IAAI,mBAAmB,EAAE,CAAC;QAC7C,IAAI,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,GAAG,CAAC,YAAY;YAAE,OAAO,EAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,oEAAoE;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CACrE,CAAC;IAEF,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,OAAO;QACL;YACE,EAAE,EAAE,gBAAgB;YACpB,KAAK,EAAE,yBAAyB;YAChC,WAAW,EACT,wFAAwF;YAC1F,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,SAAS;YACnB,YAAY,EAAE,IAAI;YAClB,KAAK,EAAE,YAAY;SACpB;KACF,CAAC;AACJ,CAAC"}

package/dist/analyzers/prettierCheck.d.ts

@@ -0,0 +1,2 @@
+import type { FileEntry, Issue } from '../types.js';
+export declare function check(rootPath: string, files: FileEntry[]): Promise<Issue[]>;

package/dist/analyzers/prettierCheck.js

@@ -0,0 +1,53 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const PRETTIER_CONFIG_FILES = [
+    '.prettierrc',
+    '.prettierrc.js',
+    '.prettierrc.cjs',
+    '.prettierrc.mjs',
+    '.prettierrc.json',
+    '.prettierrc.yml',
+    '.prettierrc.yaml',
+    '.prettierrc.toml',
+    'prettier.config.js',
+    'prettier.config.cjs',
+    'prettier.config.mjs',
+    'prettier.config.ts',
+];
+export async function check(rootPath, files) {
+    const rootFiles = new Set(files.filter((f) => !f.directory || f.directory === '.').map((f) => path.basename(f.relativePath)));
+    for (const configFile of PRETTIER_CONFIG_FILES) {
+        if (rootFiles.has(configFile))
+            return [];
+    }
+    // Check for prettier key in package.json
+    try {
+        const raw = await fs.readFile(path.join(rootPath, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        if (pkg.prettier)
+            return [];
+    }
+    catch {
+        // No package.json
+    }
+    // Only relevant for JS/TS/CSS/HTML projects
+    const relevantExtensions = new Set([
+        '.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs',
+        '.css', '.scss', '.less', '.html', '.vue', '.svelte', '.json',
+    ]);
+    const hasRelevantFiles = files.some((f) => relevantExtensions.has(f.extension));
+    if (!hasRelevantFiles)
+        return [];
+    return [
+        {
+            id: 'missing-prettier',
+            title: 'No Prettier configuration',
+            description: 'No Prettier configuration file detected. Prettier ensures consistent code formatting across your project.',
+            severity: 'warning',
+            category: 'formatting',
+            fixAvailable: true,
+            fixId: 'add-prettier',
+        },
+    ];
+}
+//# sourceMappingURL=prettierCheck.js.map

package/dist/analyzers/prettierCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettierCheck.js","sourceRoot":"","sources":["../../src/analyzers/prettierCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,qBAAqB,GAAG;IAC5B,aAAa;IACb,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,kBAAkB;IAClB,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,oBAAoB;IACpB,qBAAqB;IACrB,qBAAqB;IACrB,oBAAoB;CACrB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAgB,EAAE,KAAkB;IAC9D,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CACnG,CAAC;IAEF,KAAK,MAAM,UAAU,IAAI,qBAAqB,EAAE,CAAC;QAC/C,IAAI,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,yCAAyC;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,GAAG,CAAC,QAAQ;YAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IAED,4CAA4C;IAC5C,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;QACjC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;QAC5C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO;KAC9D,CAAC,CAAC;IACH,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAChF,IAAI,CAAC,gBAAgB;QAAE,OAAO,EAAE,CAAC;IAEjC,OAAO;QACL;YACE,EAAE,EAAE,kBAAkB;YACtB,KAAK,EAAE,2BAA2B;YAClC,WAAW,EACT,2GAA2G;YAC7G,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,YAAY;YACtB,YAAY,EAAE,IAAI;YAClB,KAAK,EAAE,cAAc;SACtB;KACF,CAAC;AACJ,CAAC"}

package/dist/analyzers/testCheck.d.ts

@@ -0,0 +1,2 @@
+import type { FileEntry, Issue } from '../types.js';
+export declare function check(rootPath: string, files: FileEntry[]): Promise<Issue[]>;

package/dist/analyzers/testCheck.js

@@ -0,0 +1,52 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const TEST_FRAMEWORKS = ['vitest', 'jest', 'mocha', 'ava', 'tap', 'jasmine', '@playwright/test', 'cypress'];
+const TEST_FILE_PATTERNS = ['.test.', '.spec.', '__tests__'];
+export async function check(rootPath, files) {
+    const issues = [];
+    // Check if this is a JS/TS project
+    const hasJsTs = files.some((f) => ['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs'].includes(f.extension));
+    if (!hasJsTs)
+        return [];
+    // Check for test framework in dependencies
+    let hasTestFramework = false;
+    try {
+        const raw = await fs.readFile(path.join(rootPath, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+        for (const framework of TEST_FRAMEWORKS) {
+            if (allDeps[framework]) {
+                hasTestFramework = true;
+                break;
+            }
+        }
+    }
+    catch {
+        // No package.json
+    }
+    // Check for test files
+    const testFiles = files.filter((f) => TEST_FILE_PATTERNS.some((pattern) => f.relativePath.includes(pattern)));
+    if (!hasTestFramework) {
+        issues.push({
+            id: 'missing-test-framework',
+            title: 'No test framework detected',
+            description: 'No testing framework found in dependencies. Testing is essential for code quality and reliability.',
+            severity: 'warning',
+            category: 'testing',
+            fixAvailable: true,
+            fixId: 'add-tests',
+        });
+    }
+    else if (testFiles.length === 0) {
+        issues.push({
+            id: 'no-test-files',
+            title: 'No test files found',
+            description: 'A test framework is configured but no test files were found. Consider adding tests for your code.',
+            severity: 'info',
+            category: 'testing',
+            fixAvailable: false,
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=testCheck.js.map

package/dist/analyzers/testCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testCheck.js","sourceRoot":"","sources":["../../src/analyzers/testCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,SAAS,CAAC,CAAC;AAE5G,MAAM,kBAAkB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,QAAgB,EAAE,KAAkB;IAC9D,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,mCAAmC;IACnC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CACrE,CAAC;IACF,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,2CAA2C;IAC3C,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,EAAE,GAAG,GAAG,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,eAAe,EAAE,CAAC;QAEhE,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;YACxC,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBACvB,gBAAgB,GAAG,IAAI,CAAC;gBACxB,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IAED,uBAAuB;IACvB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnC,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CACvE,CAAC;IAEF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,wBAAwB;YAC5B,KAAK,EAAE,4BAA4B;YACnC,WAAW,EACT,oGAAoG;YACtG,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,SAAS;YACnB,YAAY,EAAE,IAAI;YAClB,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC;YACV,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,qBAAqB;YAC5B,WAAW,EACT,mGAAmG;YACrG,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,SAAS;YACnB,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};