@principal-ai/quality-lens-cli 0.1.0

package/README.md

@@ -0,0 +1,166 @@
+# Quality Lens CLI
+
+A standalone CLI tool for running quality lenses (ESLint, Jest, TypeScript, Knip, Git) on codebases in CI/CD pipelines.
+
+## Installation
+
+```bash
+npm install -g @principal-ai/quality-lens-cli
+```
+
+## Usage
+
+### Run quality lenses
+
+```bash
+# Run all available lenses in current directory
+quality-lens run
+
+# Run on specific directory
+quality-lens run /path/to/repo
+
+# Run specific lenses only
+quality-lens run --lenses eslint,jest,typescript
+
+# Output to JSON file
+quality-lens run --output results.json --format json
+
+# Console output (default)
+quality-lens run --format console
+```
+
+### List available lenses
+
+```bash
+# List lenses in current directory
+quality-lens list
+
+# List lenses in specific directory
+quality-lens list /path/to/repo
+```
+
+## Options
+
+- `--output, -o`: Output file path for results (JSON format)
+- `--lenses`: Comma-separated list of lenses to run (eslint,jest,typescript,knip,git)
+- `--format`: Output format - `json` or `console` (default: console)
+
+## GitHub Actions Integration
+
+Create `.github/workflows/quality-lens.yml`:
+
+```yaml
+name: Quality Lens Analysis
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - run: npm ci
+
+      - name: Install quality-lens-cli
+        run: npm install -g @principal-ai/quality-lens-cli
+
+      - name: Run quality lenses
+        run: |
+          quality-lens run . \\
+            --output results.json \\
+            --format json \\
+            --lenses eslint,jest,typescript
+
+      - name: Upload results
+        uses: actions/upload-artifact@v4
+        with:
+          name: quality-lens-results
+          path: results.json
+```
+
+## Output Format
+
+### JSON Output
+
+```json
+{
+  "metadata": {
+    "timestamp": "2025-10-16T20:00:00.000Z",
+    "version": "1.0.0",
+    "totalPackages": 2,
+    "totalLenses": 6
+  },
+  "results": [
+    {
+      "package": {
+        "name": "my-package",
+        "path": "packages/my-package"
+      },
+      "lens": {
+        "id": "eslint",
+        "command": "npm run lint"
+      },
+      "execution": {
+        "success": true,
+        "exitCode": 0,
+        "duration": 1234,
+        "timestamp": 1697486400000
+      },
+      "issues": [],
+      "metrics": {},
+      "qualityContext": {}
+    }
+  ]
+}
+```
+
+### Console Output
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Quality Lens Results
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📦 my-package
+  ✓ eslint: npm run lint (1234ms)
+  ✓ jest: npm run test (5678ms)
+  ✓ typescript: npm run typecheck (2345ms)
+
+Summary:
+  Total: 3
+  Passed: 3
+  Failed: 0
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run locally
+./bin/quality-lens.js run .
+
+# Lint
+npm run lint
+
+# Type check
+npm run typecheck
+```
+
+## License
+
+MIT

package/bin/quality-lens.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+// Entry point for the quality-lens CLI
+require('../dist/cli.js');

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const yargs_1 = tslib_1.__importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const RepositoryScanner_1 = require("./scanner/RepositoryScanner");
+const QualityLensService_1 = require("./service/QualityLensService");
+const JsonFormatter_1 = require("./output/JsonFormatter");
+const ConsoleReporter_1 = require("./output/ConsoleReporter");
+const repository_abstraction_1 = require("@principal-ai/repository-abstraction");
+const fs = tslib_1.__importStar(require("fs/promises"));
+const path = tslib_1.__importStar(require("path"));
+async function buildFileTree(dirPath) {
+    const paths = await collectPaths(dirPath, '');
+    const builder = new repository_abstraction_1.PathsFileTreeBuilder();
+    const result = builder.build({
+        files: paths,
+        rootPath: dirPath,
+    });
+    return result;
+}
+async function collectPaths(dirPath, relativePath) {
+    const paths = [];
+    const entries = await fs.readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (shouldSkip(entry.name)) {
+            continue;
+        }
+        const fullPath = path.join(dirPath, entry.name);
+        const entryRelativePath = relativePath
+            ? `${relativePath}/${entry.name}`
+            : entry.name;
+        if (entry.isDirectory()) {
+            const subPaths = await collectPaths(fullPath, entryRelativePath);
+            paths.push(...subPaths);
+        }
+        else if (entry.isFile()) {
+            paths.push(entryRelativePath);
+        }
+    }
+    return paths;
+}
+function shouldSkip(name) {
+    const skipPatterns = [
+        'node_modules',
+        '.git',
+        '.next',
+        '.nuxt',
+        'dist',
+        'build',
+        'coverage',
+        '.turbo',
+        '.cache',
+    ];
+    return skipPatterns.includes(name) || name.startsWith('.');
+}
+async function runCommand(argv) {
+    const scanner = new RepositoryScanner_1.RepositoryScanner();
+    const lensService = new QualityLensService_1.QualityLensService();
+    const jsonFormatter = new JsonFormatter_1.JsonFormatter();
+    const consoleReporter = new ConsoleReporter_1.ConsoleReporter();
+    try {
+        const repoPath = path.resolve(argv.path);
+        console.log(`Scanning repository: ${repoPath}`);
+        const fileTree = await buildFileTree(repoPath);
+        const packages = await scanner.extractPackages(fileTree, repoPath);
+        if (packages.length === 0) {
+            console.warn('No packages found in repository');
+            process.exit(1);
+        }
+        console.log(`Found ${packages.length} package(s)`);
+        const lensFilter = argv.lenses
+            ? argv.lenses.split(',').map((l) => l.trim())
+            : null;
+        const allResults = [];
+        for (const pkg of packages) {
+            const lensCommands = pkg.packageData.availableCommands?.filter((cmd) => {
+                if (!cmd.isLensCommand)
+                    return false;
+                if (lensFilter && !lensFilter.includes(cmd.lensId || '')) {
+                    return false;
+                }
+                return true;
+            });
+            if (!lensCommands || lensCommands.length === 0) {
+                console.log(`Skipping ${pkg.packageData.name} (no lens commands)`);
+                continue;
+            }
+            console.log(`\nRunning lenses for ${pkg.packageData.name}...`);
+            for (const command of lensCommands) {
+                console.log(`  - ${command.lensId}: ${command.name}`);
+                try {
+                    const result = await lensService.executeTool({
+                        repoPath,
+                        packageLayer: pkg,
+                        packageCommand: command,
+                    });
+                    allResults.push({
+                        package: pkg.packageData.name,
+                        packagePath: pkg.packageData.path,
+                        lens: command.lensId || 'unknown',
+                        command: command.name,
+                        result,
+                        timestamp: Date.now(),
+                    });
+                    console.log(`    ${result.success ? '✓' : '✗'} ${result.success ? 'Success' : 'Failed'} (${result.duration}ms)`);
+                }
+                catch (error) {
+                    console.error(`    ✗ Error: ${error.message}`);
+                    allResults.push({
+                        package: pkg.packageData.name,
+                        packagePath: pkg.packageData.path,
+                        lens: command.lensId || 'unknown',
+                        command: command.name,
+                        error: error.message,
+                        timestamp: Date.now(),
+                    });
+                }
+            }
+        }
+        if (argv.format === 'json') {
+            const json = jsonFormatter.format(allResults);
+            if (argv.output) {
+                await fs.writeFile(argv.output, json, 'utf-8');
+                console.log(`\nResults written to: ${argv.output}`);
+            }
+            else {
+                console.log('\n' + json);
+            }
+        }
+        else {
+            consoleReporter.report(allResults);
+        }
+        const hasFailures = allResults.some((r) => r.error || !r.result?.success);
+        process.exit(hasFailures ? 1 : 0);
+    }
+    catch (error) {
+        console.error('Fatal error:', error.message);
+        process.exit(1);
+    }
+}
+(0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+    .command('run [path]', 'Run quality lenses on repository', (yargs) => {
+    return yargs
+        .positional('path', {
+        describe: 'Repository path',
+        type: 'string',
+        default: process.cwd(),
+    })
+        .option('output', {
+        alias: 'o',
+        describe: 'Output file for results',
+        type: 'string',
+    })
+        .option('lenses', {
+        describe: 'Specific lenses to run (comma-separated)',
+        type: 'string',
+        example: 'eslint,jest,typescript',
+    })
+        .option('format', {
+        describe: 'Output format',
+        choices: ['json', 'console'],
+        default: 'console',
+    });
+}, (argv) => runCommand(argv))
+    .command('list [path]', 'List available lenses in repository', (yargs) => {
+    return yargs.positional('path', {
+        describe: 'Repository path',
+        type: 'string',
+        default: process.cwd(),
+    });
+}, async (argv) => {
+    const repoPath = path.resolve(argv.path);
+    const scanner = new RepositoryScanner_1.RepositoryScanner();
+    console.log(`Scanning repository: ${repoPath}`);
+    const fileTree = await buildFileTree(repoPath);
+    const packages = await scanner.extractPackages(fileTree, repoPath);
+    packages.forEach((pkg) => {
+        console.log(`\n${pkg.packageData.name}:`);
+        console.log(`  Available: ${pkg.qualityMetrics?.availableLenses?.join(', ') || 'none'}`);
+        console.log(`  Missing: ${pkg.qualityMetrics?.missingLenses?.join(', ') || 'none'}`);
+    });
+})
+    .demandCommand()
+    .help()
+    .argv;
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/executor/NodeExecutor.d.ts

@@ -0,0 +1,8 @@
+import type { Executor, ExecuteResult, ExecuteOptions, StreamOptions, StreamResult } from '@principal-ai/codebase-quality-lenses';
+export declare class NodeExecutor implements Executor {
+    readonly type: "node";
+    execute(command: string, args?: string[], options?: ExecuteOptions): Promise<ExecuteResult>;
+    stream(command: string, args?: string[], options?: StreamOptions): StreamResult;
+    isAvailable(command: string): Promise<boolean>;
+}
+//# sourceMappingURL=NodeExecutor.d.ts.map

package/dist/executor/NodeExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeExecutor.d.ts","sourceRoot":"","sources":["../../src/executor/NodeExecutor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,uCAAuC,CAAC;AAQ/C,qBAAa,YAAa,YAAW,QAAQ;IAC3C,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;IAK1B,OAAO,CACX,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC;IAuEzB,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,aAAkB,GAC1B,YAAY;IAoET,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAWrD"}

package/dist/executor/NodeExecutor.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodeExecutor = void 0;
+const child_process_1 = require("child_process");
+const stream_1 = require("stream");
+class NodeExecutor {
+    constructor() {
+        this.type = 'node';
+    }
+    async execute(command, args = [], options = {}) {
+        const startTime = Date.now();
+        return new Promise((resolve) => {
+            let stdout = '';
+            let stderr = '';
+            const baseEnv = options.env || process.env;
+            const cleanEnv = { ...baseEnv };
+            delete cleanEnv['NODE_OPTIONS'];
+            delete cleanEnv['TS_NODE_PROJECT'];
+            delete cleanEnv['TS_NODE_TRANSPILE_ONLY'];
+            const child = (0, child_process_1.spawn)(command, args, {
+                cwd: options.cwd,
+                env: cleanEnv,
+                shell: true,
+            });
+            if (child.stdout) {
+                child.stdout.on('data', (data) => {
+                    stdout += data.toString();
+                });
+            }
+            if (child.stderr) {
+                child.stderr.on('data', (data) => {
+                    stderr += data.toString();
+                });
+            }
+            let timeoutHandle;
+            if (options.timeout) {
+                timeoutHandle = setTimeout(() => {
+                    child.kill('SIGTERM');
+                }, options.timeout);
+            }
+            child.on('error', (error) => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                resolve({
+                    stdout,
+                    stderr: stderr || error.message,
+                    exitCode: 1,
+                    duration: Date.now() - startTime,
+                    command,
+                    args,
+                    error,
+                });
+            });
+            child.on('close', (code) => {
+                if (timeoutHandle)
+                    clearTimeout(timeoutHandle);
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode: code ?? 0,
+                    duration: Date.now() - startTime,
+                    command,
+                    args,
+                });
+            });
+        });
+    }
+    stream(command, args = [], options = {}) {
+        const baseEnv = options.env || process.env;
+        const cleanEnv = { ...baseEnv };
+        delete cleanEnv['NODE_OPTIONS'];
+        delete cleanEnv['TS_NODE_PROJECT'];
+        delete cleanEnv['TS_NODE_TRANSPILE_ONLY'];
+        const child = (0, child_process_1.spawn)(command, args, {
+            cwd: options.cwd,
+            env: cleanEnv,
+            shell: true,
+        });
+        const exitPromise = new Promise((resolve) => {
+            let stdout = '';
+            let stderr = '';
+            const startTime = Date.now();
+            if (child.stdout) {
+                child.stdout.on('data', (data) => {
+                    stdout += data.toString();
+                });
+            }
+            if (child.stderr) {
+                child.stderr.on('data', (data) => {
+                    stderr += data.toString();
+                });
+            }
+            child.on('close', (code) => {
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode: code ?? 0,
+                    duration: Date.now() - startTime,
+                    command,
+                    args,
+                });
+            });
+            child.on('error', (error) => {
+                resolve({
+                    stdout,
+                    stderr: stderr || error.message,
+                    exitCode: 1,
+                    duration: Date.now() - startTime,
+                    command,
+                    args,
+                    error,
+                });
+            });
+        });
+        return {
+            stdout: child.stdout || new stream_1.Readable({ read() { } }),
+            stderr: child.stderr || new stream_1.Readable({ read() { } }),
+            exitPromise,
+            kill: () => {
+                child.kill('SIGTERM');
+            },
+        };
+    }
+    async isAvailable(command) {
+        try {
+            const testArgs = ['--version'];
+            const result = await this.execute(command, testArgs, {
+                timeout: 5000,
+            });
+            return result.exitCode === 0;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+}
+exports.NodeExecutor = NodeExecutor;
+//# sourceMappingURL=NodeExecutor.js.map

package/dist/executor/NodeExecutor.js.map

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

package/dist/output/ConsoleReporter.d.ts

@@ -0,0 +1,6 @@
+import type { LensExecutionResult } from './JsonFormatter';
+export declare class ConsoleReporter {
+    report(results: LensExecutionResult[]): void;
+    private groupByPackage;
+}
+//# sourceMappingURL=ConsoleReporter.d.ts.map

package/dist/output/ConsoleReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleReporter.d.ts","sourceRoot":"","sources":["../../src/output/ConsoleReporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAK3D,qBAAa,eAAe;IAC1B,MAAM,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,IAAI;IA6D5C,OAAO,CAAC,cAAc;CASvB"}

package/dist/output/ConsoleReporter.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleReporter = void 0;
+const tslib_1 = require("tslib");
+const chalk_1 = tslib_1.__importDefault(require("chalk"));
+class ConsoleReporter {
+    report(results) {
+        console.log(chalk_1.default.bold('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+        console.log(chalk_1.default.bold('Quality Lens Results'));
+        console.log(chalk_1.default.bold('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+        const byPackage = this.groupByPackage(results);
+        Object.entries(byPackage).forEach(([pkg, pkgResults]) => {
+            console.log(chalk_1.default.bold.blue(`📦 ${pkg}`));
+            pkgResults.forEach((r) => {
+                const icon = r.result?.success ? '✓' : '✗';
+                const color = r.result?.success ? chalk_1.default.green : chalk_1.default.red;
+                const duration = r.result?.duration
+                    ? `(${r.result.duration}ms)`
+                    : '';
+                console.log(`  ${color(icon)} ${r.lens}: ${r.command} ${chalk_1.default.gray(duration)}`);
+                if (r.result?.lensResult?.issues && r.result.lensResult.issues.length > 0) {
+                    const errorCount = r.result.lensResult.issues.filter((i) => i.severity === 'error').length;
+                    const warningCount = r.result.lensResult.issues.filter((i) => i.severity === 'warning').length;
+                    if (errorCount > 0) {
+                        console.log(`    ${chalk_1.default.red(`${errorCount} error(s)`)}`);
+                    }
+                    if (warningCount > 0) {
+                        console.log(`    ${chalk_1.default.yellow(`${warningCount} warning(s)`)}`);
+                    }
+                }
+                if (r.error) {
+                    console.log(`    ${chalk_1.default.red('Error:')} ${r.error}`);
+                }
+            });
+            console.log('');
+        });
+        const total = results.length;
+        const passed = results.filter((r) => r.result?.success).length;
+        const failed = total - passed;
+        console.log(chalk_1.default.bold('Summary:'));
+        console.log(`  Total: ${total}`);
+        console.log(`  ${chalk_1.default.green('Passed:')} ${passed}`);
+        console.log(`  ${chalk_1.default.red('Failed:')} ${failed}`);
+        console.log('');
+    }
+    groupByPackage(results) {
+        return results.reduce((acc, r) => {
+            if (!acc[r.package]) {
+                acc[r.package] = [];
+            }
+            acc[r.package].push(r);
+            return acc;
+        }, {});
+    }
+}
+exports.ConsoleReporter = ConsoleReporter;
+//# sourceMappingURL=ConsoleReporter.js.map

package/dist/output/ConsoleReporter.js.map

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

package/dist/output/JsonFormatter.d.ts

@@ -0,0 +1,42 @@
+import type { ToolExecutionResponse } from '../service/QualityLensService';
+export interface LensExecutionResult {
+    package: string;
+    packagePath?: string;
+    lens: string;
+    command: string;
+    result?: ToolExecutionResponse;
+    error?: string;
+    timestamp: number;
+}
+export interface FormattedResults {
+    metadata: {
+        timestamp: string;
+        version: string;
+        totalPackages: number;
+        totalLenses: number;
+    };
+    results: Array<{
+        package: {
+            name: string;
+            path?: string;
+        };
+        lens: {
+            id: string;
+            command: string;
+        };
+        execution: {
+            success: boolean;
+            exitCode?: number;
+            duration?: number;
+            timestamp: number;
+        };
+        issues: any[];
+        metrics: Record<string, any>;
+        qualityContext: Record<string, any>;
+        error?: string;
+    }>;
+}
+export declare class JsonFormatter {
+    format(results: LensExecutionResult[]): string;
+}
+//# sourceMappingURL=JsonFormatter.d.ts.map

package/dist/output/JsonFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonFormatter.d.ts","sourceRoot":"","sources":["../../src/output/JsonFormatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;SACf,CAAC;QACF,IAAI,EAAE;YACJ,EAAE,EAAE,MAAM,CAAC;YACX,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,SAAS,EAAE;YACT,OAAO,EAAE,OAAO,CAAC;YACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC;QACF,MAAM,EAAE,GAAG,EAAE,CAAC;QACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC7B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACpC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAKD,qBAAa,aAAa;IACxB,MAAM,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,MAAM;CAgC/C"}

package/dist/output/JsonFormatter.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonFormatter = void 0;
+class JsonFormatter {
+    format(results) {
+        const formatted = {
+            metadata: {
+                timestamp: new Date().toISOString(),
+                version: '1.0.0',
+                totalPackages: new Set(results.map((r) => r.package)).size,
+                totalLenses: results.length,
+            },
+            results: results.map((r) => ({
+                package: {
+                    name: r.package,
+                    path: r.packagePath,
+                },
+                lens: {
+                    id: r.lens,
+                    command: r.command,
+                },
+                execution: {
+                    success: r.result?.success ?? false,
+                    exitCode: r.result?.exitCode,
+                    duration: r.result?.duration,
+                    timestamp: r.timestamp,
+                },
+                issues: r.result?.lensResult?.issues || [],
+                metrics: r.result?.lensResult?.metrics || {},
+                qualityContext: r.result?.qualityContext || {},
+                error: r.error,
+            })),
+        };
+        return JSON.stringify(formatted, null, 2);
+    }
+}
+exports.JsonFormatter = JsonFormatter;
+//# sourceMappingURL=JsonFormatter.js.map

package/dist/output/JsonFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonFormatter.js","sourceRoot":"","sources":["../../src/output/JsonFormatter.ts"],"names":[],"mappings":";;;AA4CA,MAAa,aAAa;IACxB,MAAM,CAAC,OAA8B;QACnC,MAAM,SAAS,GAAqB;YAClC,QAAQ,EAAE;gBACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,OAAO,EAAE,OAAO;gBAChB,aAAa,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;gBAC1D,WAAW,EAAE,OAAO,CAAC,MAAM;aAC5B;YACD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC3B,OAAO,EAAE;oBACP,IAAI,EAAE,CAAC,CAAC,OAAO;oBACf,IAAI,EAAE,CAAC,CAAC,WAAW;iBACpB;gBACD,IAAI,EAAE;oBACJ,EAAE,EAAE,CAAC,CAAC,IAAI;oBACV,OAAO,EAAE,CAAC,CAAC,OAAO;iBACnB;gBACD,SAAS,EAAE;oBACT,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,IAAI,KAAK;oBACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ;oBAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ;oBAC5B,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB;gBACD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,IAAI,EAAE;gBAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,IAAI,EAAE;gBAC5C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,cAAc,IAAI,EAAE;gBAC9C,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC;SACJ,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;CACF;AAjCD,sCAiCC"}

package/dist/scanner/RepositoryScanner.d.ts

@@ -0,0 +1,8 @@
+import { PackageLayer } from '@principal-ai/codebase-composition';
+import type { FileTree } from '@principal-ai/repository-abstraction';
+export declare class RepositoryScanner {
+    private packageModule;
+    constructor();
+    extractPackages(fileTree: FileTree, repoPath: string): Promise<PackageLayer[]>;
+}
+//# sourceMappingURL=RepositoryScanner.d.ts.map

package/dist/scanner/RepositoryScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RepositoryScanner.d.ts","sourceRoot":"","sources":["../../src/scanner/RepositoryScanner.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,YAAY,EAEb,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAyFrE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,aAAa,CAAqB;;IAYpC,eAAe,CACnB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC;CA2B3B"}

package/dist/scanner/RepositoryScanner.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RepositoryScanner = void 0;
+const tslib_1 = require("tslib");
+const codebase_composition_1 = require("@principal-ai/codebase-composition");
+const path = tslib_1.__importStar(require("path"));
+const fs = tslib_1.__importStar(require("fs/promises"));
+class CLIFileSystemAdapter {
+    constructor(basePath) {
+        this.basePath = basePath;
+    }
+    async readFile(filePath) {
+        try {
+            const absolutePath = path.isAbsolute(filePath)
+                ? filePath
+                : path.join(this.basePath, filePath);
+            const content = await fs.readFile(absolutePath, 'utf-8');
+            return { content };
+        }
+        catch (error) {
+            console.error(`[CLIFileSystemAdapter] Failed to read ${filePath}:`, error);
+            return null;
+        }
+    }
+    async fileExists(filePath) {
+        try {
+            const absolutePath = path.isAbsolute(filePath)
+                ? filePath
+                : path.join(this.basePath, filePath);
+            await fs.access(absolutePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async readDirectory(dirPath) {
+        try {
+            const absolutePath = path.isAbsolute(dirPath)
+                ? dirPath
+                : path.join(this.basePath, dirPath);
+            const entries = await fs.readdir(absolutePath);
+            return entries;
+        }
+        catch (error) {
+            console.error(`[CLIFileSystemAdapter] Failed to read directory ${dirPath}:`, error);
+            return [];
+        }
+    }
+    async isDirectory(filePath) {
+        try {
+            const absolutePath = path.isAbsolute(filePath)
+                ? filePath
+                : path.join(this.basePath, filePath);
+            const stats = await fs.stat(absolutePath);
+            return stats.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+    async buildFilteredFileTree(_directoryPath, _patterns, _sourceDirectory) {
+        return { paths: [] };
+    }
+}
+class RepositoryScanner {
+    constructor() {
+        this.packageModule = new codebase_composition_1.PackageLayerModule();
+    }
+    async extractPackages(fileTree, repoPath) {
+        try {
+            const adapter = new CLIFileSystemAdapter(repoPath);
+            const fileReader = async (filePath) => {
+                const result = await adapter.readFile(filePath);
+                return result?.content || '';
+            };
+            const packages = await this.packageModule.discoverPackages(fileTree, fileReader);
+            console.info(`[RepositoryScanner] Found ${packages.length} packages in ${repoPath}`);
+            return packages;
+        }
+        catch (error) {
+            console.error('[RepositoryScanner] Failed to extract packages:', error);
+            return [];
+        }
+    }
+}
+exports.RepositoryScanner = RepositoryScanner;
+//# sourceMappingURL=RepositoryScanner.js.map

package/dist/scanner/RepositoryScanner.js.map

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

package/dist/service/QualityLensService.d.ts

@@ -0,0 +1,40 @@
+import { type LensResult } from '@principal-ai/codebase-quality-lenses';
+import type { PackageCommand, PackageLayer } from '@principal-ai/codebase-composition';
+export interface ToolExecutionRequest {
+    repoPath: string;
+    packageLayer?: PackageLayer;
+    packageCommand?: PackageCommand;
+}
+export interface ToolExecutionResponse {
+    success: boolean;
+    toolName: string;
+    command: string;
+    packagePath?: string;
+    exitCode: number;
+    duration: number;
+    stdout: string;
+    stderr: string;
+    lensResult?: LensResult;
+    qualityContext?: {
+        lensId?: string;
+        operation?: string;
+        availableLenses?: string[];
+        missingLenses?: string[];
+    };
+    error?: string;
+}
+export declare class QualityLensService {
+    private executor;
+    private lenses;
+    constructor();
+    private initializeLenses;
+    executeTool(request: ToolExecutionRequest): Promise<ToolExecutionResponse>;
+    private executeWithPackageLayer;
+    private executeNonLensCommand;
+    private parseCommandString;
+    private determineLensSuccess;
+    private createErrorResponse;
+    getAvailableLenses(): string[];
+    hasLensForTool(toolName: string): boolean;
+}
+//# sourceMappingURL=QualityLensService.d.ts.map

package/dist/service/QualityLensService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QualityLensService.d.ts","sourceRoot":"","sources":["../../src/service/QualityLensService.ts"],"names":[],"mappings":"AAKA,OAAO,EAOL,KAAK,UAAU,EAChB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAMvF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAKD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,MAAM,CAAoB;;IAclC,OAAO,CAAC,gBAAgB;IA6BX,WAAW,CACtB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;YAgBnB,uBAAuB;YAgGvB,qBAAqB;IAwCnC,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,oBAAoB;IAqC5B,OAAO,CAAC,mBAAmB;IAuBpB,kBAAkB,IAAI,MAAM,EAAE;IAO9B,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGjD"}

package/dist/service/QualityLensService.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QualityLensService = void 0;
+const codebase_quality_lenses_1 = require("@principal-ai/codebase-quality-lenses");
+const NodeExecutor_1 = require("../executor/NodeExecutor");
+class QualityLensService {
+    constructor() {
+        this.executor = new NodeExecutor_1.NodeExecutor();
+        this.lenses = new Map();
+        this.initializeLenses();
+    }
+    initializeLenses() {
+        console.log('[QualityLensService] Initializing lenses...');
+        const eslintLens = new codebase_quality_lenses_1.ESLintLens(this.executor);
+        this.lenses.set('eslint', eslintLens);
+        this.lenses.set('lint', eslintLens);
+        const jestLens = new codebase_quality_lenses_1.JestLens(this.executor);
+        this.lenses.set('jest', jestLens);
+        this.lenses.set('test', jestLens);
+        const typescriptLens = new codebase_quality_lenses_1.TypeScriptLens(this.executor);
+        this.lenses.set('typescript', typescriptLens);
+        this.lenses.set('typecheck', typescriptLens);
+        this.lenses.set('tsc', typescriptLens);
+        const knipLens = new codebase_quality_lenses_1.KnipLens(this.executor);
+        this.lenses.set('knip', knipLens);
+        this.lenses.set('deadcode', knipLens);
+        const gitLens = new codebase_quality_lenses_1.GitLens(this.executor);
+        this.lenses.set('git', gitLens);
+    }
+    async executeTool(request) {
+        const startTime = Date.now();
+        if (!request.packageLayer || !request.packageCommand) {
+            throw new Error('packageLayer and packageCommand are required. Legacy execution has been removed.');
+        }
+        return this.executeWithPackageLayer(request, startTime);
+    }
+    async executeWithPackageLayer(request, startTime) {
+        const { repoPath, packageLayer, packageCommand } = request;
+        if (!packageLayer || !packageCommand) {
+            throw new Error('packageLayer and packageCommand are required for new execution path');
+        }
+        const packagePath = packageLayer.packageData.path || '';
+        const cwd = packagePath ? `${repoPath}/${packagePath}` : repoPath;
+        if (!packageCommand.isLensCommand || !packageCommand.lensId) {
+            console.log(`[QualityLensService] Not a lens command, executing directly: ${packageCommand.name}`);
+            return this.executeNonLensCommand(request, packageCommand, cwd, startTime);
+        }
+        const lens = this.lenses.get(packageCommand.lensId);
+        if (!lens) {
+            console.warn(`[QualityLensService] No lens registered for: ${packageCommand.lensId}`);
+            return this.executeNonLensCommand(request, packageCommand, cwd, startTime);
+        }
+        console.log(`[QualityLensService] Using ${lens.name} for command: ${packageCommand.name} (lensId: ${packageCommand.lensId})`);
+        try {
+            const { command, args } = this.parseCommandString(packageCommand.command);
+            lens.configure({
+                cwd,
+                tool: {
+                    name: packageCommand.lensId,
+                    command,
+                    args,
+                    cwd,
+                    available: true,
+                },
+            });
+            const lensResult = await lens.run();
+            const { success, exitCode } = this.determineLensSuccess(lensResult);
+            return {
+                success,
+                toolName: packageCommand.lensId,
+                command: packageCommand.command,
+                packagePath,
+                exitCode,
+                duration: Date.now() - startTime,
+                stdout: lensResult.raw?.stdout || '',
+                stderr: lensResult.raw?.stderr || lensResult.error?.message || '',
+                lensResult,
+                qualityContext: {
+                    lensId: packageCommand.lensId,
+                    operation: packageCommand.lensOperation,
+                    availableLenses: packageLayer.qualityMetrics?.availableLenses,
+                    missingLenses: packageLayer.qualityMetrics?.missingLenses,
+                },
+            };
+        }
+        catch (error) {
+            console.error(`[QualityLensService] Error:`, error);
+            return this.createErrorResponse(packageCommand.lensId || packageCommand.name, packageCommand.command, packagePath, error, startTime);
+        }
+    }
+    async executeNonLensCommand(request, packageCommand, cwd, startTime) {
+        const { command, args } = this.parseCommandString(packageCommand.command);
+        try {
+            const result = await this.executor.execute(command, args, { cwd });
+            return {
+                success: result.exitCode === 0,
+                toolName: packageCommand.name,
+                command: packageCommand.command,
+                packagePath: request.packageLayer?.packageData.path,
+                exitCode: result.exitCode,
+                duration: Date.now() - startTime,
+                stdout: result.stdout,
+                stderr: result.stderr,
+            };
+        }
+        catch (error) {
+            return this.createErrorResponse(packageCommand.name, packageCommand.command, request.packageLayer?.packageData.path, error, startTime);
+        }
+    }
+    parseCommandString(commandString) {
+        if (commandString.startsWith('npm run ')) {
+            const parts = commandString.split(' ');
+            return { command: 'npm', args: ['run', ...parts.slice(2)] };
+        }
+        if (commandString.startsWith('yarn ')) {
+            const parts = commandString.split(' ');
+            return { command: 'yarn', args: parts.slice(1) };
+        }
+        if (commandString.startsWith('pnpm ')) {
+            const parts = commandString.split(' ');
+            return { command: 'pnpm', args: parts.slice(1) };
+        }
+        const parts = commandString.split(' ');
+        return { command: parts[0] || '', args: parts.slice(1) };
+    }
+    determineLensSuccess(lensResult) {
+        let exitCode = 0;
+        let success = true;
+        if (lensResult.raw?.exitCode !== undefined) {
+            exitCode = lensResult.raw.exitCode;
+            success = exitCode === 0;
+        }
+        else if (lensResult.error) {
+            exitCode = 1;
+            success = false;
+        }
+        else if (lensResult.metrics?.issuesBySeverity?.error &&
+            lensResult.metrics.issuesBySeverity.error > 0) {
+            exitCode = 1;
+            success = false;
+        }
+        else {
+            success = lensResult.success !== false;
+            exitCode = success ? 0 : 1;
+        }
+        return { success, exitCode };
+    }
+    createErrorResponse(toolName, command, packagePath, error, startTime) {
+        return {
+            success: false,
+            toolName,
+            command,
+            packagePath,
+            exitCode: 1,
+            duration: Date.now() - startTime,
+            stdout: '',
+            stderr: error.message || 'Tool execution failed',
+            error: error.message,
+        };
+    }
+    getAvailableLenses() {
+        return Array.from(this.lenses.keys());
+    }
+    hasLensForTool(toolName) {
+        return this.lenses.has(toolName.toLowerCase());
+    }
+}
+exports.QualityLensService = QualityLensService;
+//# sourceMappingURL=QualityLensService.js.map

package/dist/service/QualityLensService.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@principal-ai/quality-lens-cli",
+  "version": "0.1.0",
+  "description": "CLI tool for running quality lenses on codebases in CI/CD pipelines",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "quality-lens": "bin/quality-lens.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "typecheck": "tsc --noEmit",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "quality",
+    "linting",
+    "testing",
+    "typescript",
+    "eslint",
+    "jest",
+    "ci",
+    "cd",
+    "github-actions"
+  ],
+  "author": "Principal AI",
+  "license": "MIT",
+  "dependencies": {
+    "@principal-ai/codebase-composition": "^0.2.8",
+    "@principal-ai/codebase-quality-lenses": "^0.1.7",
+    "@principal-ai/repository-abstraction": "^0.2.0",
+    "chalk": "^5.3.0",
+    "tslib": "^2.8.1",
+    "yargs": "^17.7.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/yargs": "^17.0.32",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "optionalDependencies": {
+    "@types/pg": "^8.11.0",
+    "pg": "^8.11.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ]
+}