@threejs-doctor/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 codergeeta
+
+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/bin/threejs-doctor.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import('../dist/index.js')
+  .then((mod) => mod.main())
+  .then((code) => {
+    process.exit(typeof code === 'number' ? code : 0)
+  })
+  .catch((err) => {
+    console.error(err)
+    process.exit(1)
+  })

package/dist/cli.d.ts

@@ -0,0 +1,18 @@
+import type { DoctorReport } from '@threejs-doctor/runtime';
+import type { Profile } from '@threejs-doctor/core';
+export interface CliArgs {
+    command: 'scan' | 'bench' | 'ci' | 'help';
+    path: string;
+    format: 'human' | 'json';
+    profile: Profile;
+    budget: 'low' | 'mid' | 'high';
+    minScore: number;
+}
+export interface CliDeps {
+    runScan: (args: CliArgs) => Promise<DoctorReport>;
+    runBench: (args: CliArgs) => Promise<DoctorReport>;
+    write: (text: string) => void;
+}
+export declare function parseArgs(argv: string[]): CliArgs;
+export declare function main(argv?: string[], deps?: CliDeps): Promise<number>;
+//# 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":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAA;IACzC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,GAAG,MAAM,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;IAC9B,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IACjD,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAClD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAuBjD;AAED,wBAAsB,IAAI,CACxB,IAAI,GAAE,MAAM,EAA0B,EACtC,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAAC,MAAM,CAAC,CAwCjB"}

package/dist/cli.js

@@ -0,0 +1,70 @@
+import { formatHumanReport } from './report/human.js';
+import { formatJsonReport } from './report/json.js';
+export function parseArgs(argv) {
+    const args = {
+        command: 'help',
+        path: '.',
+        format: 'human',
+        profile: 'auto',
+        budget: 'low',
+        minScore: 70,
+    };
+    if (argv.length === 0)
+        return args;
+    const cmd = argv[0];
+    if (cmd === 'scan' || cmd === 'bench' || cmd === 'ci' || cmd === 'help') {
+        args.command = cmd;
+    }
+    if (cmd === 'scan' && argv[1] && !argv[1].startsWith('-'))
+        args.path = argv[1];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--format')
+            args.format = argv[++i] === 'json' ? 'json' : 'human';
+        if (a === '--profile')
+            args.profile = argv[++i];
+        if (a === '--budget')
+            args.budget = argv[++i] ?? 'low';
+        if (a === '--min-score')
+            args.minScore = Number(argv[++i]);
+    }
+    return args;
+}
+export async function main(argv = process.argv.slice(2), deps) {
+    const args = parseArgs(argv);
+    const write = deps?.write ?? ((t) => console.log(t));
+    if (args.command === 'help') {
+        write(`Usage:
+  npx threejs-doctor bench --profile <profile> --budget low [--format human|json]
+  npx @threejs-doctor/cli bench --profile <profile> --budget low
+  # scan / ci are not implemented (exit 1)`);
+        return 0;
+    }
+    if (args.command === 'ci' && !Number.isFinite(args.minScore)) {
+        write('error: --min-score must be a finite number');
+        return 1;
+    }
+    const runScan = deps?.runScan ?? (await import('./commands/scan.js')).runScan;
+    const runBench = deps?.runBench ?? (await import('./commands/bench.js')).runBench;
+    let report;
+    try {
+        report = args.command === 'bench' ? await runBench(args) : await runScan(args);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const code = err && typeof err === 'object' && 'code' in err ? err.code : undefined;
+        if (code === 'SCAN_NOT_IMPLEMENTED' || message.toLowerCase().includes('not implemented')) {
+            write(message);
+            return 1;
+        }
+        throw err;
+    }
+    write(args.format === 'json' ? formatJsonReport(report) : formatHumanReport(report));
+    if (args.command === 'ci') {
+        const hasError = report.findings.some((f) => f.severity === 'error');
+        if (report.score < args.minScore || hasError || report.incomplete)
+            return 1;
+    }
+    return 0;
+}
+//# 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/commands/bench.d.ts

@@ -0,0 +1,4 @@
+import type { CliArgs } from '../cli.js';
+import type { DoctorReport } from '@threejs-doctor/runtime';
+export declare function runBench(args: CliArgs): Promise<DoctorReport>;
+//# sourceMappingURL=bench.d.ts.map

package/dist/commands/bench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bench.d.ts","sourceRoot":"","sources":["../../src/commands/bench.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,wBAAsB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAMnE"}

package/dist/commands/bench.js

@@ -0,0 +1,8 @@
+export async function runBench(args) {
+    const { runBenchSuite } = await import('@threejs-doctor/bench');
+    return runBenchSuite({
+        profile: args.profile === 'auto' ? 'marketing' : args.profile,
+        budget: args.budget,
+    });
+}
+//# sourceMappingURL=bench.js.map

package/dist/commands/bench.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bench.js","sourceRoot":"","sources":["../../src/commands/bench.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAa;IAC1C,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAA;IAC/D,OAAO,aAAa,CAAC;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;QAC7D,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAA;AACJ,CAAC"}

package/dist/commands/ci.d.ts

@@ -0,0 +1,2 @@
+export { main as runCi } from '../cli.js';
+//# sourceMappingURL=ci.d.ts.map

package/dist/commands/ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../../src/commands/ci.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,WAAW,CAAA"}

package/dist/commands/ci.js

@@ -0,0 +1,2 @@
+export { main as runCi } from '../cli.js';
+//# sourceMappingURL=ci.js.map

package/dist/commands/ci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.js","sourceRoot":"","sources":["../../src/commands/ci.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,KAAK,EAAE,MAAM,WAAW,CAAA"}

package/dist/commands/scan.d.ts

@@ -0,0 +1,10 @@
+import type { CliArgs } from '../cli.js';
+import type { DoctorReport } from '@threejs-doctor/runtime';
+export declare const SCAN_NOT_IMPLEMENTED = "not implemented: threejs-doctor scan/ci is not a working gate. Static scan is a stub and must not be used as a score gate. Attach the runtime Doctor to a live Three.js scene until a real scanner exists.";
+export declare class ScanNotImplementedError extends Error {
+    readonly code = "SCAN_NOT_IMPLEMENTED";
+    constructor(message?: string);
+}
+/** Static project scan is not implemented. Live scene attach is the runtime API. */
+export declare function runScan(_args: CliArgs): Promise<DoctorReport>;
+//# sourceMappingURL=scan.d.ts.map

package/dist/commands/scan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,eAAO,MAAM,oBAAoB,+MAC6K,CAAA;AAE9M,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,0BAAyB;gBAC1B,OAAO,SAAuB;CAI3C;AAED,oFAAoF;AACpF,wBAAsB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAEnE"}

package/dist/commands/scan.js

@@ -0,0 +1,13 @@
+export const SCAN_NOT_IMPLEMENTED = 'not implemented: threejs-doctor scan/ci is not a working gate. Static scan is a stub and must not be used as a score gate. Attach the runtime Doctor to a live Three.js scene until a real scanner exists.';
+export class ScanNotImplementedError extends Error {
+    code = 'SCAN_NOT_IMPLEMENTED';
+    constructor(message = SCAN_NOT_IMPLEMENTED) {
+        super(message);
+        this.name = 'ScanNotImplementedError';
+    }
+}
+/** Static project scan is not implemented. Live scene attach is the runtime API. */
+export async function runScan(_args) {
+    throw new ScanNotImplementedError();
+}
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,oBAAoB,GAC/B,4MAA4M,CAAA;AAE9M,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACvC,IAAI,GAAG,sBAAsB,CAAA;IACtC,YAAY,OAAO,GAAG,oBAAoB;QACxC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAA;IACvC,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAAc;IAC1C,MAAM,IAAI,uBAAuB,EAAE,CAAA;AACrC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export declare const PACKAGE_NAME: "@threejs-doctor/cli";
+export { main, parseArgs } from './cli.js';
+export { formatHumanReport } from './report/human.js';
+export { formatJsonReport } from './report/json.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,EAAG,qBAA8B,CAAA;AAC1D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export const PACKAGE_NAME = '@threejs-doctor/cli';
+export { main, parseArgs } from './cli.js';
+export { formatHumanReport } from './report/human.js';
+export { formatJsonReport } from './report/json.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,qBAA8B,CAAA;AAC1D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/report/human.d.ts

@@ -0,0 +1,3 @@
+import type { DoctorReport } from '@threejs-doctor/runtime';
+export declare function formatHumanReport(report: DoctorReport): string;
+//# sourceMappingURL=human.d.ts.map

package/dist/report/human.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human.d.ts","sourceRoot":"","sources":["../../src/report/human.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAyC9D"}

package/dist/report/human.js

@@ -0,0 +1,39 @@
+export function formatHumanReport(report) {
+    const lines = [];
+    lines.push(`threejs-doctor — profile=${report.profile} mode=${report.mode}`);
+    lines.push(`Doctor Score: ${report.score}`);
+    lines.push('');
+    lines.push('Findings:');
+    if (report.findings.length === 0)
+        lines.push('  (none)');
+    for (const f of report.findings) {
+        lines.push(`  [${f.severity}] ${f.id}: ${f.message}`);
+        lines.push(`    fix: ${f.suggestedFix}`);
+    }
+    lines.push('');
+    lines.push('Baseline → After (deltas):');
+    const keys = Object.keys(report.baseline);
+    for (const key of keys) {
+        const base = report.baseline[key];
+        const after = report.after?.[key];
+        const delta = report.deltas?.[key];
+        lines.push(`  ${String(key)}: ${base}${after === undefined ? '' : ` → ${after}`}${delta === undefined ? '' : ` (${delta >= 0 ? '+' : ''}${delta})`}`);
+    }
+    lines.push('');
+    lines.push(`Applied passes: ${report.appliedPasses.join(', ') || '(none)'}`);
+    if (report.failedPasses.length) {
+        lines.push('Failed passes:');
+        for (const p of report.failedPasses)
+            lines.push(`  ${p.id}: ${p.error}`);
+    }
+    if (report.incomplete) {
+        lines.push('Run incomplete: after metrics unavailable; baseline retained.');
+    }
+    if (report.visualDelta) {
+        lines.push(report.rolledBackDueToVisual
+            ? 'Visual delta vs control (confirmed); applied passes were rolled back. Capture must use a fixed viewpoint.'
+            : 'Visual delta vs control; do not treat apply: [safe] as visually safe.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=human.js.map

package/dist/report/human.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"human.js","sourceRoot":"","sources":["../../src/report/human.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,CAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,OAAO,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IAC5E,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAA;IAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IACvB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IACxD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;QACrD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,YAAY,EAAE,CAAC,CAAA;IAC1C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAA;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAwC,CAAA;IAChF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAA;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAA;QAClC,KAAK,CAAC,IAAI,CACR,KAAK,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,GAClE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,GAC/D,EAAE,CACH,CAAA;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACd,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAA;IAC5E,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;QAC5B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,YAAY;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAA;IAC1E,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAA;IAC7E,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,qBAAqB;YAC1B,CAAC,CAAC,2GAA2G;YAC7G,CAAC,CAAC,uEAAuE,CAC5E,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC"}

package/dist/report/json.d.ts

@@ -0,0 +1,3 @@
+import type { DoctorReport } from '@threejs-doctor/runtime';
+export declare function formatJsonReport(report: DoctorReport): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/report/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/report/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE7D"}

package/dist/report/json.js

@@ -0,0 +1,4 @@
+export function formatJsonReport(report) {
+    return JSON.stringify(report, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/report/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/report/json.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AACxC,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@threejs-doctor/cli",
+  "version": "0.1.0",
+  "description": "threejs-doctor CLI (bench; scan/ci not implemented)",
+  "license": "MIT",
+  "author": "codergeeta",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "threejs-doctor": "./bin/threejs-doctor.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./bin/threejs-doctor.js": "./bin/threejs-doctor.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "dependencies": {
+    "@threejs-doctor/bench": "^0.1.0",
+    "@threejs-doctor/runtime": "^0.1.0",
+    "@threejs-doctor/rules": "^0.1.0",
+    "@threejs-doctor/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codergeeta/threejs-doctor.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/codergeeta/threejs-doctor#readme",
+  "bugs": {
+    "url": "https://github.com/codergeeta/threejs-doctor/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}