optiprune 2.1.8 → 2.2.22

package/README.md

@@ -1,110 +1,210 @@
-![Optiprune Logo](docs/public/logo.svg)
-![NPM Version](https://img.shields.io/npm/v/optiprune)
-![GitHub License](https://img.shields.io/github/license/DreamLongYT/optiprune)
+![OptiPrune analyzer animation](https://raw.githubusercontent.com/optiprune/core/main/animation.svg)
 
-# 🚀 OptiPrune
----
+[![CLI npm version](https://img.shields.io/npm/v/%40optiprune%2Fcli?label=%40optiprune%2Fcli)](https://www.npmjs.com/package/@optiprune/cli)[![Core npm version](https://img.shields.io/npm/v/%40optiprune%2Fcore?label=%40optiprune%2Fcore)](https://www.npmjs.com/package/@optiprune/core)[![CLI package](https://img.shields.io/github/package-json/v/optiprune/cli?label=CLI%20package)](https://github.com/optiprune/cli)[![Core tests](https://img.shields.io/github/actions/workflow/status/optiprune/core/tests.yml?branch=main&label=core%20tests)](https://github.com/optiprune/core/actions/workflows/tests.yml)[![License](https://img.shields.io/github/license/optiprune/cli)](./LICENSE)[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D21-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
 
-## 💎 The Vision
-Most dead-code analyzers just guess. They look at import graphs and hope they don't miss anything critical. This leads to **false positives**, broken builds, and developer frustration.
+# OptiPrune
 
-**OptiPrune is different.** We use formal logic, isolated execution, and a high-performance engine to not just find dead code, but to mathematically **prove** it.
+OptiPrune is a static dead-code analyzer for TypeScript and JavaScript projects. It combines parser-backed module graphs, export and member reachability, dependency and workspace inspection, dynamic-import analysis, semantic contracts, optional symbolic/concolic checks, and source-aware plugins.
 
-> **"Stop Guessing, Start Proving."**
+The CLI package is `@optiprune/cli`. The analysis engine is available separately as the headless package `@optiprune/core`.
 
----
+## Features
 
-## ⚡ The 3 Pillars of Superiority
+| Area | What is included |
+| --- | --- |
+| Project analysis | Entry discovery, module graphs, export/member reachability, dependency edges, strongly connected components, and cycle reporting. |
+| TypeScript and JavaScript | `.ts`, `.tsx`, `.js`, `.jsx`, and `.vue` extensions by default, with custom extension lists available from the CLI or config. |
+| Dynamic paths | Literal and pattern-based dynamic imports, unresolved-path findings, recovery information, and isolated execution checks. |
+| Logic analysis | Constant conditions, contradictory guards, unreachable statements, and schema-impossible guards. |
+| Dependencies | `package.json`, scripts, dependency/devDependency usage, package exports, bins, workspace packages, and lockfile-aware context. |
+| Contracts and entries | Public API contracts, schema-aware protection, conventional entries, entry-file exports, test-file handling, and framework/plugin entry points. |
+| Fixes | Opt-in fixes for unreachable files, unused exports and members, dependencies, development dependencies, and verified conditions. Every fix is confidence-gated and supports dry runs. |
+| Output | Human-readable terminal output, JSON reports, and SARIF output for CI/code-scanning workflows. |
+| Headless usage | `analyze`, `shouldFail`, cache helpers, fix helpers, reporters, and public TypeScript types from `@optiprune/core`. |
+| Plugins | Source-aware adapters for frameworks, build tools, test tools, runtimes, package managers, and workspace conventions. |
 
-### 1. Raw Power: The Yuku Engine (Zig)
-While other tools are throttled by the N-API bottleneck, OptiPrune utilizes the **Yuku Engine** written in **Zig**. It minimizes the overhead between native performance and the JavaScript runtime.
-*   **The Result:** Up to 3x faster parsing than traditional tools, even in massive monorepos.
+## Installation
 
-### 2. Deep Intelligence: SMT & Z3 Solver
-OptiPrune is the first analyzer to use a real **SMT Solver (Z3)**. We don't just analyze if a function is exported; we analyze if the code *inside* the function is logically reachable.
-*   **The Result:** Detects dead logic paths (e.g., impossible `if` conditions) that are completely invisible to Knip.
+Install the CLI as a development dependency:
 
-### 3. Absolute Precision: WASM Sandbox Execution
-Dynamic imports are the final boss of static analysis. OptiPrune solves this through a **WASM-based QuickJS sandbox**. We securely execute critical code snippets to resolve paths at runtime.
-*   **The Result:** Zero false alarms for dynamic paths. If OptiPrune says it's dead, it's dead.
+```bash
+npm install --save-dev @optiprune/cli
+# or
+pnpm add -D @optiprune/cli
+# or
+yarn add -D @optiprune/cli
+```
 
----
+The Core package currently requires Node.js 21 or newer.
 
-## 🥊 OptiPrune vs. Knip: The Head-to-Head
+## Quick start
 
-| Feature | Knip | OptiPrune |
-| :--- | :--- | :--- |
-| **Engine** | Babel / OXC (Standard) | **Yuku / Zig (Hyper-Speed)** |
-| **Logic Analysis** | Heuristics (Guessing) | **Z3 SMT Solver (Proving)** |
-| **Dynamic Paths** | Pattern Matching | **WASM Sandbox Execution** |
-| **Interface Audit** | Ignores Members | **Deep Member-Level Analysis** |
-| **Framework Support** | Plugins (Core-Level) | **7-Layer Semantic Context** |
-| **False Positives** | High (in complex setups) | **Near-Zero (Context Aware)** |
+Run an analysis from the project root:
 
----
+```bash
+npx @optiprune/cli analyze
+```
 
-## 🏗️ The 7-Layer Architecture
-OptiPrune operates in seven specialized layers to guarantee maximum accuracy:
+The default command is `analyze`, so this is equivalent:
 
-1.  **Layer 1: Discovery** – Ultra-fast file scanning.
-2.  **Layer 2: Basic CFG** – Detects standard dead code after terminal statements.
-3.  **Layer 3: SMT Logic** – Mathematical path proofs with Z3.
-4.  **Layer 4: WASM Sandbox** – Dynamic path resolution via execution.
-5.  **Layer 6: Schema Shield** – Protection for Zod, Decorators & Contracts.
-6.  **Layer 6: Dependency Audit** – Scans lockfiles & package.json scripts.
-7.  **Layer 7: Topology Engine** – Understands NestJS DI & Event Buses.
+```bash
+npx @optiprune/cli
+```
 
----
+Select a machine-readable output format when integrating with tooling:
 
-## 📈 Benchmark Numbers (Real-World Test)
-*Tested on a NestJS project with 1000+ files.*
+```bash
+npx @optiprune/cli analyze --json
+npx @optiprune/cli analyze --sarif > optiprune.sarif
+```
 
-*   **Knip Speed:** 1.26s (with crash risks on complex types)
-*   **OptiPrune Speed:** **0.87s** (Stable & Precise)
-*   **Accuracy:** OptiPrune found **15% more** real dead code (unused interface properties & logical errors) that Knip completely missed.
+## Commands
 
----
+| Command | Purpose |
+| --- | --- |
+| `analyze [options]` | Analyze the project. This is the default command. |
+| `export-cache <targetPath>` | Export the current analysis cache to a JSON file. |
+| `import-cache <sourcePath>` | Import an external cache JSON file into the local project cache. |
+| `optiprune --help` | Print command and option help. |
+| `optiprune --version` | Print the CLI and detected Core versions. |
 
-## Installation
+## Analyze flags
 
-Install Optiprune as a dev dependency via pnpm, npm, or yarn:
+| Flag | Description | Default |
+| --- | --- | --- |
+| `-r, --rootDir <path>` | Root directory of the project. | Current working directory |
+| `-e, --entry <patterns...>` | Entry-point patterns, globs, or file paths. | `[]` |
+| `-x, --extensions <exts...>` | File extensions to analyze. | `.ts .tsx .js .jsx .vue` |
+| `-i, --ignore <patterns...>` | Glob patterns to ignore. | `[]` |
+| `--no-report-unused-exports` | Disable unused-export reporting. | Enabled |
+| `--no-conventional-entries` | Exclude conventional entries such as `src/index.ts`. | Included |
+| `--include-entry-exports` | Report unused exports declared directly in entry files. | Disabled |
+| `--cycles` | Print detected dependency cycles. | Disabled |
+| `--ignore-tests` | Ignore test files such as `test.ts`, `*.test.ts`, and `__tests__`. | Disabled |
+| `--fail-on <confidence>` | Exit non-zero when findings meet the selected confidence level: `high`, `medium`, `low`, or `none`. | `high` |
+| `--json` | Print the structured analysis report as JSON. | Disabled |
+| `--sarif` | Print SARIF output. | Disabled |
+| `--skip-3` | Skip the SMT constraint-analysis layer. | Disabled |
+| `--skip-4` | Skip the concolic execution-proof layer. | Disabled |
+| `-v, --verbose` | Print verbose output and internal graph state. | Disabled |
+| `--fix <rules...>` | Select fix targets: `files`, `exports`, `dependencies`, `devDependencies`, or `conditions`. | None |
+| `--confidence <level>` | Minimum fix confidence: `high`, `medium+`, or `low+`. | `high` |
+| `--force` | Allow a selected fix when the source edit is otherwise considered unsafe. | Disabled |
+| `--dry-run` | Log planned fixes without changing files. | Disabled |
+| `--cache-from <path>` | Import a JSON cache before analysis. | None |
+| `--cache-to <path>` | Export the resulting cache after analysis. | None |
+
+`--confidence`, `--force`, and `--dry-run` require `--fix`. Unknown fix targets are rejected before analysis begins.
+
+## Fixes
+
+Fixes are explicit rather than implicit. Start with a dry run, inspect the output, then omit `--dry-run` when the proposed changes are acceptable.
 
 ```bash
-pnpm add -D optiprune
-# or
-npm install --save-dev optiprune
-# or
-yarn add -D optiprune
+npx @optiprune/cli analyze \
+  --fix files exports dependencies devDependencies conditions \
+  --confidence medium+ \
+  --dry-run
+```
 
----
+| Target | Applies to |
+| --- | --- |
+| `files` | Verified unreachable files. |
+| `exports` | Verified unused exports and members. |
+| `dependencies` | Unused runtime dependencies. |
+| `devDependencies` | Unused development dependencies. |
+| `conditions` | Verified constant conditions. |
 
-## Usage
+`--force` changes the safety decision for the selected fix operation; it does not make an unverified finding correct. Use it only when the source edit has been reviewed.
 
-Run Optiprune from your project root:
+## Cache
+
+Use cache files to reuse analysis state in local workflows or CI:
 
 ```bash
-npx optiprune
+npx @optiprune/cli analyze \
+  --cache-from .optiprune/cache.json \
+  --cache-to .optiprune/cache.json
+
+npx @optiprune/cli export-cache .optiprune/cache.json
+npx @optiprune/cli import-cache .optiprune/cache.json
 ```
 
-### CLI Options
+`export-cache` and `import-cache` accept `-r, --rootDir <path>` when the cache belongs to a directory other than the current working directory.
 
-| Flag | Description | Default |
-| :--- | :--- | :--- |
-| `-r, --rootDir` | Project root directory | `process.cwd()` |
-| `-e, --entry` | Entry point patterns (glob) | `[]` |
-| `-i, --ignore` | Patterns to ignore | `[]` |
-| `--no-report-unused-exports` | Disable unused export reporting | `false` |
-| `--fail-on` | Fail on confidence (high/medium/low/none) | `high` |
-| `--json` | Output as JSON | `false` |
-| `--sarif` | Output as SARIF | `false` |
-| `--skip-3` | Skip Layer 3 (SMT Constraint Solver) | `false` |
-| `--skip-4` | Skip Layer 4 (Concolic Execution Proofs) | `false` |
-
----
-
-## 🤝 Join the Revolution
-OptiPrune isn't just a tool. It's a technical statement. Help us save the world from dirty code.
-
-**GitHub:** [DreamLongYT/optiprune](https://github.com/DreamLongYT/optiprune)
-**Web:** [opti.drml.int.yt](https://opti.drml.int.yt)
-See [CONTRIBUTING.md](CONTRIBUTING.md) for local setup and development guides.
+## Configuration
+
+OptiPrune reads configuration through the Core loader. Supported sources include:
+
+| Source | Notes |
+| --- | --- |
+| `optiprune.json` | Standard JSON configuration. |
+| `optiprune.jsonc` | JSON with comments and trailing commas. |
+| `optiprune.config.ts` | TypeScript configuration with a default export. |
+| `optiprune.config.js` | JavaScript ESM configuration with a default export. |
+| `optiprune.config.mjs` | JavaScript ESM configuration with a default export. |
+| `package.json#optiprune` | Package field configuration. |
+
+See [`config.md`](./config.md) for the configuration reference and [`schema.json`](https://github.com/optiprune/core/blob/main/schema.json) for the authoritative schema.
+
+## Headless Core API
+
+Use `@optiprune/core` directly when the CLI is not the right integration boundary:
+
+```bash
+npm install @optiprune/core
+```
+
+```
+import { analyze, shouldFail } from "@optiprune/core";
+
+const report = await analyze({
+  rootDir: process.cwd(),
+  entry: ["src/index.ts"],
+  output: "json",
+});
+
+console.log(report.summary);
+
+if (shouldFail(report, "high")) {
+  process.exitCode = 1;
+}
+```
+
+The Core package also exposes cache helpers, `applyFixes`, reporters, and public types:
+
+```
+import { applyFixes, exportCache, importCache } from "@optiprune/core";
+import { formatSarif, formatTerminal } from "@optiprune/core/reporters";
+import type { AnalysisReport, AnalyzerOptions, Finding } from "@optiprune/core/types";
+```
+
+An `AnalysisReport` contains summary counts, findings, entry points, module records, exports, dependency edges, and strongly connected components.
+
+## Plugin model
+
+Plugins provide source-aware context for frameworks, build tools, test runners, runtimes, package managers, and workspace conventions. They can contribute entry patterns, mark files or packages as used, interpret project metadata, and participate in analysis lifecycle hooks.
+
+Browse the [Core plugin directory](https://github.com/optiprune/core/tree/main/src/plugins) to inspect the current source-backed set and the `AnalyzerPlugin`/`PluginAdapter` contracts.
+
+## Development
+
+Build the package from this repository:
+
+```bash
+npm run build
+npm test
+```
+
+The Core repository uses Vitest for its test suite. The workflow badges above reflect the status reported by GitHub Actions rather than a hard-coded claim in this README.
+
+## Links
+
+| Resource | Link |
+| --- | --- |
+| CLI repository | [github.com/optiprune/cli](https://github.com/optiprune/cli) |
+| Core repository | [github.com/optiprune/core](https://github.com/optiprune/core) |
+| CLI package | [npmjs.com/package/@optiprune/cli](https://www.npmjs.com/package/@optiprune/cli) |
+| Core package | [npmjs.com/package/@optiprune/core](https://www.npmjs.com/package/@optiprune/core) |
+| Documentation site | [opti.drml.int.yt](https://opti.drml.int.yt/) |
+| License | [MIT](./LICENSE) |

package/config.md

@@ -0,0 +1,142 @@
+# OptiPrune Configuration Guide (`config.md`)
+
+OptiPrune uses a structured configuration file to define entry points, rule behavior, ignore patterns, and core analysis engine mechanics.
+
+---
+
+## Quick Start
+
+Create an `optiprune.json` or `optiprune.jsonc` file in the root directory of your project:
+
+```
+{
+  "$schema": "https://raw.githubusercontent.com/optiprune/core/refs/heads/main/schema.json",
+  "rootDir": "src",
+  "entry": ["src/index.ts", "src/cli.ts"],
+  "ignore": ["**/*.test.ts", "**/dist/**"],
+  "externalContracts": ["PluginAdapter", "AnalyzerPlugin"],
+  "failOn": "high",
+  "rules": {
+    "unused-variable": "warning",
+    "dead-code": "error"
+  }
+}
+```
+
+---
+
+## How OptiPrune Loads Configuration
+
+When OptiPrune initializes, it checks the workspace root in the following order of precedence:
+
+optiprune.json (Highest Priority )
+
+optiprune.jsonc (Allows comments //, /* */, and trailing commas)
+
+package.json (Falls back to reading an "optiprune" key)
+
+---
+
+## Configuration Reference
+
+**1. File & Workspace Discovery**rootDir (string, default: ".")
+
+Specifies the base directory for source files relative to the project workspace root.
+
+entry (string[], default: [])
+
+Defines root entry files. Any code reachable from these files (and their dependency trees) is marked as used and protected from unused-code reports.
+
+extensions (string[], default: [".ts", ".tsx", ".js", ".jsx"])
+
+File extensions that OptiPrune will parse and analyze.
+
+ignore (string[], default: [])
+
+Glob patterns or directory paths to skip entirely during analysis (e.g., test fixtures, output directories).
+
+**2. Export & Contract Safeguards**externalContracts (string[], default: [])
+
+List of public API symbol or interface names. Marks these exports as globally used across all execution layers, preventing OptiPrune from flagging them as dead code when building public libraries or plugins.
+
+reportUnusedExports (boolean, default: true)
+
+When set to true, OptiPrune reports exported functions, types, or variables that have no internal or external references.
+
+includeConventionalEntries (boolean, default: true)
+
+Automatically treats framework conventions (e.g., index.ts, main.ts, App.tsx) as entry points without needing manual listing in entry.
+
+**3. CLI & Execution Controls**failOn ("high" | "medium" | "low" | "info" | "none", default: "high")
+
+Determines the minimum issue severity level required to exit the process with a non-zero exit code in CI/CD pipelines.
+
+verbose (boolean, default: false)
+
+Prints step-by-step diagnostic information to stdout.
+
+json (boolean, default: false)
+
+Formats output directly as raw JSON for external tool ingestion.
+
+**4. Automated Fixes (fix)**
+
+Configures the automatic removal of dead code. Can be a boolean or an object for granular control.
+
+```
+{
+  "fix": {
+    "confidence": "medium+",
+    "rules": ["exports", "files", "dependencies"],
+    "dryRun": false
+  }
+}
+```
+
+- **confidence**: Minimum confidence to apply a fix (`high`, `medium+`, `low+`, `all`).
+
+- **rules**: Specific rules or categories (`exports`, `files`, `dependencies`) to fix.
+
+- **dryRun**: If true, logs what would be fixed without modifying files.
+
+**5. Rule Overrides (rules)**Fine-tune or disable specific inspection rules:
+
+```json
+"rules": {
+  "rule-name": "error" | "warning" | "off"
+}
+```
+
+- `"error"`: Causes finding to trigger build errors or exit failures.
+
+- `"warning"`: Emits warnings without halting execution (unless configured by failOn).
+
+- `"off"`: Disables rule checking entirely.
+
+**6. Engine & Solver Tuning (layers)**Configure isolated runtimes, SMT solvers, and symbolic execution passes:
+
+| Option | Type | Default | Purpose |
+| --- | --- | --- | --- |
+| smtTimeoutMs | number | 10000 | SMT solver execution cap (in milliseconds) per proof path. |
+| isolateMemoryLimitMb | number | 128 | Memory ceiling (in MB) allocated to V8 worker isolates. |
+| enableConcolicProof | boolean | false | Enables concolic analysis to prove dead execution paths. |
+| skip3 | boolean | false | Bypasses Analysis Layer 3. |
+| skip4 | boolean | false | Bypasses Analysis Layer 4. |
+
+---
+
+## Alternative: package.json Configuration
+
+If you do not want an additional configuration file in your root folder, add an "optiprune" field inside package.json:
+
+```json
+{
+  "name": "my-library",
+  "version": "1.0.0",
+  "optiprune": {
+    "entry": ["src/index.ts"],
+    "externalContracts": ["MyPublicApi"],
+    "failOn": "medium"
+  }
+}
+```

package/dist/cli.d.ts

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

package/dist/cli.js

@@ -0,0 +1,184 @@
+#!/usr/bin/env node
+import path from "pathe";
+import fs from "node:fs";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+const program = new Command();
+const FIX_TARGETS = new Set(["files", "exports", "dependencies", "devDependencies", "conditions"]);
+// Using @ts-ignore for core imports as CI environments sometimes struggle 
+// with subpath exports resolution in strict NodeNext mode.
+// @ts-ignore
+import { analyze, shouldFail, exportCache, importCache } from "@optiprune/core";
+// @ts-ignore
+import { formatTerminal, formatSarif } from "@optiprune/core/reporters";
+/** ANSI colour helpers */
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const yellow = (s) => `\x1b[33m${s}\x1b[0m`;
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+// Helper to find the CLI package version
+function getCliVersion() {
+    try {
+        const currentDir = path.dirname(fileURLToPath(import.meta.url));
+        let dir = currentDir;
+        while (dir !== path.dirname(dir)) {
+            const pkgPath = path.join(dir, "package.json");
+            if (fs.existsSync(pkgPath)) {
+                const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+                if (pkg.version)
+                    return pkg.version;
+            }
+            dir = path.dirname(dir);
+        }
+    }
+    catch (e) { }
+    return "unknown";
+}
+// Helper to find the core version safely
+function getCoreVersion(rootDir) {
+    try {
+        // 1. Try local node_modules in the current working directory
+        const localCore = path.join(rootDir, "node_modules/@optiprune/core/package.json");
+        if (fs.existsSync(localCore)) {
+            const content = fs.readFileSync(localCore, "utf-8");
+            const pkg = JSON.parse(content);
+            if (pkg.version)
+                return pkg.version;
+        }
+        // 2. Try resolving relative to this CLI file if bundled together
+        const cliDir = path.dirname(fileURLToPath(import.meta.url));
+        const siblingCore = path.join(cliDir, "../core/package.json");
+        if (fs.existsSync(siblingCore)) {
+            const content = fs.readFileSync(siblingCore, "utf-8");
+            const pkg = JSON.parse(content);
+            if (pkg.version)
+                return pkg.version;
+        }
+    }
+    catch (e) { }
+    return "1.11.45";
+}
+const cliVersion = getCliVersion();
+const coreVersion = getCoreVersion(process.cwd());
+program
+    .name("optiprune")
+    .description("Finds dead code in TypeScript/JavaScript projects.")
+    .version(`CLI: ${cliVersion}, Core: ${coreVersion}`, "-V, --version", "output the version number");
+program
+    .command("analyze", { isDefault: true })
+    .description("Perform full analysis of the project")
+    .option("-r, --rootDir <path>", "Root directory of the project", process.cwd())
+    .option("-e, --entry <patterns...>", "Entry point patterns (glob or file paths)", [])
+    .option("-x, --extensions <exts...>", "File extensions to analyze", [".ts", ".tsx", ".js", ".jsx", ".vue"])
+    .option("-i, --ignore <patterns...>", "Ignore patterns (glob)", [])
+    .option("--no-report-unused-exports", "Do not report unused exports")
+    .option("--no-conventional-entries", "Do not include conventional entry points (e.g., src/index.ts)")
+    .option("--include-entry-exports", "Report unused exports declared directly in entry files")
+    .option("--cycles", "Print detected dependency cycles")
+    .option("--ignore-tests", "Ignore test files such as test.ts, *.test.ts, and __tests__ files")
+    .option("--fail-on <confidence>", "Fail on findings with confidence level (high, medium, low, none)", "high")
+    .option("--json", "Output results as JSON")
+    .option("--sarif", "Output results in SARIF format")
+    .option("--skip-3", "Skip Layer 3 (SMT Constraint Solver)")
+    .option("--skip-4", "Skip Layer 4 (Concolic Execution Proofs)")
+    .option("-v, --verbose", "Show verbose output and internal graph state")
+    .option("--fix <rules...>", "Fix selected targets: files, exports, dependencies, devDependencies")
+    .option("--confidence <level>", "Minimum confidence to fix (high, medium+, low+)", "high")
+    .option("--force", "Allow fixes when the source edit is otherwise considered unsafe")
+    .option("--dry-run", "Log what would be fixed without changing files")
+    .option("--cache-from <path>", "Path to a JSON file to import cache from before analysis")
+    .option("--cache-to <path>", "Path to export the resulting cache to after analysis")
+    .action(async (options, command) => {
+    try {
+        const isCliOverride = (name) => command.getOptionValueSource(name) === "cli";
+        let fixOption = undefined;
+        const hasFixFlags = isCliOverride("fix") || isCliOverride("confidence") || isCliOverride("force") || isCliOverride("dryRun");
+        if (hasFixFlags) {
+            if (!isCliOverride("fix")) {
+                throw new Error("--confidence, --force, and --dry-run require --fix <target...>");
+            }
+            const invalidTargets = options.fix.filter((target) => !FIX_TARGETS.has(target));
+            if (invalidTargets.length > 0) {
+                throw new Error(`Unknown --fix target(s): ${invalidTargets.join(", ")}. Choose files, exports, dependencies, devDependencies, or conditions.`);
+            }
+            fixOption = {
+                confidence: options.confidence,
+                rules: options.fix,
+                force: !!options.force,
+                dryRun: !!options.dryRun,
+            };
+        }
+        const analyzerOptions = {
+            ...(isCliOverride("rootDir") && { rootDir: options.rootDir }),
+            ...(isCliOverride("entry") && { entry: options.entry }),
+            ...(isCliOverride("extensions") && { extensions: options.extensions }),
+            ...(isCliOverride("ignore") && { ignore: options.ignore }),
+            ...(isCliOverride("reportUnusedExports") && {
+                reportUnusedExports: options.reportUnusedExports,
+            }),
+            ...(isCliOverride("conventionalEntries") && {
+                includeConventionalEntries: options.conventionalEntries,
+            }),
+            ...(isCliOverride("includeEntryExports") && { includeEntryExports: options.includeEntryExports }),
+            ...(isCliOverride("cycles") && { cycles: options.cycles }),
+            ...(isCliOverride("ignoreTests") && { ignoreTests: options.ignoreTests }),
+            ...(isCliOverride("failOn") && { failOn: options.failOn }),
+            ...(isCliOverride("json") && { json: options.json }),
+            ...(isCliOverride("skip3") && { skip3: options.skip3 }),
+            ...(isCliOverride("skip4") && { skip4: options.skip4 }),
+            ...(isCliOverride("verbose") && { verbose: options.verbose }),
+            ...(fixOption !== undefined && { fix: fixOption }),
+            ...(isCliOverride("cacheFrom") && { cacheFrom: options.cacheFrom }),
+            ...(isCliOverride("cacheTo") && { cacheTo: options.cacheTo }),
+        };
+        const report = await analyze(analyzerOptions);
+        if (options.sarif) {
+            console.log(formatSarif(report));
+        }
+        else if (options.json) {
+            console.log(JSON.stringify(report, (k, v) => typeof v === 'bigint' ? v.toString() : v, 2));
+        }
+        else {
+            const terminal = formatTerminal(report, { showCycles: !!options.cycles });
+            console.log(terminal);
+        }
+        if (shouldFail(report, options.failOn))
+            process.exit(1);
+    }
+    catch (error) {
+        console.error("An unexpected error occurred during analysis:", error);
+        process.exit(1);
+    }
+});
+program
+    .command("export-cache <targetPath>")
+    .description("Export the current analysis cache to a JSON file")
+    .option("-r, --rootDir <path>", "Root directory of the project", process.cwd())
+    .action(async (targetPath, options) => {
+    try {
+        const rootDir = options.rootDir ?? process.cwd();
+        await exportCache(rootDir, targetPath);
+        console.log(`${yellow("✔")} Cache exported to ${bold(targetPath)}`);
+    }
+    catch (error) {
+        console.error("Failed to export cache:", error);
+        process.exit(1);
+    }
+});
+program
+    .command("import-cache <sourcePath>")
+    .description("Import an external cache JSON file into the local directory")
+    .option("-r, --rootDir <path>", "Root directory of the project", process.cwd())
+    .action(async (sourcePath, options) => {
+    try {
+        const rootDir = options.rootDir ?? process.cwd();
+        await importCache(rootDir, sourcePath);
+        console.log(`${yellow("✔")} Cache imported from ${bold(sourcePath)}`);
+    }
+    catch (error) {
+        console.error("Failed to import cache:", error);
+        process.exit(1);
+    }
+});
+program.parse(process.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/logo.svg

@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" style="width:100%;height:100%">
+  <defs>
+    <linearGradient id="opti-grad-1" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#6366F1"></stop>
+      <stop offset="50%" stop-color="#8B5CF6"></stop>
+      <stop offset="100%" stop-color="#D946EF"></stop>
+    </linearGradient>
+    <linearGradient id="opti-grad-2" x1="0%" y1="100%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#06B6D4"></stop>
+      <stop offset="100%" stop-color="#3B82F6"></stop>
+    </linearGradient>
+    <filter id="glow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="8" stdDeviation="16" flood-color="#8B5CF6" flood-opacity="0.35"></feDropShadow>
+    </filter>
+  </defs>
+  <g filter="url(#glow)">
+    <path d="M 256 64 C 362 64, 448 150, 448 256 C 448 290, 439 322, 423 350 L 340 267 C 352 240, 345 208, 321 184 C 297 160, 265 153, 238 165 L 155 82 C 185 70, 220 64, 256 64 Z" fill="url(#opti-grad-1)"></path>
+    <path d="M 256 448 C 150 448, 64 362, 64 256 C 64 222, 73 190, 89 162 L 172 245 C 160 272, 167 304, 191 328 C 215 352, 247 359, 274 347 L 357 430 C 327 442, 292 448, 256 448 Z" fill="url(#opti-grad-1)"></path>
+    <polygon points="110,410 410,110 380,80 80,380" fill="url(#opti-grad-2)" opacity="0.9"></polygon>
+  </g>
+  <circle cx="256" cy="256" r="28" fill="#FFFFFF" opacity="0.95"></circle>
+</svg>

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "optiprune",
-  "version": "2.1.8",
-  "description": "Resilient static dead-code analyzer for TypeScript and JavaScript workspaces.",
+  "version": "2.2.22",
+  "description": "CLI for resilient static dead-code analyzer for TypeScript and JavaScript workspaces.",
   "type": "module",
-  "main": "./dist/cli.js",
+  "bin": {
+    "optiprune": "./dist/cli.js"
+  },
   "homepage": "https://opti.drml.int.yt/",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/DreamLongYT/optiprune.git"
+    "url": "git+https://github.com/optiprune/cli.git"
   },
   "bugs": {
-    "url": "https://github.com/DreamLongYT/optiprune/issues"
+    "url": "https://github.com/optiprune/cli/issues"
   },
   "keywords": [
     "analysis",
@@ -46,26 +48,44 @@
     "pruning",
     "dead",
     "opti",
-    "optimization"
+    "optimization",
+    "resilient",
+    "api",
+    "optimization",
+    "resilient",
+    "analyzer",
+    "code"
   ],
-  "bin": {
-    "optiprune": "./bin/runner.js"
-  },
   "files": [
-    "bin",
+    "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "config.md",
+    "package.json",
+    "logo.svg"
   ],
+  "exports": {
+    ".": "./dist/cli.js",
+    "./package.json": "./package.json"
+  },
   "dependencies": {
-    "@optiprune/cli": "^1.2.9",
+    "@optiprune/core": "^1.11.45",
+    "commander": "^15.0.0",
     "pathe": "2.0.3"
   },
-  "engines": {
-    "node": "^22.18.0 || >=24.11.0"
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "typescript": "^5.8.3"
   },
-  "license": "MIT",
-  "directories": {
-    "doc": "docs"
+  "optionalDependencies": {
+    "@yuku-codegen/wasm": "0.8.7",
+    "@yuku-parser/wasm": "0.8.7"
   },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --test tests/ignore-unknown-import.test.mjs",
+    "prepublishOnly": "npm run build"
+  },
+  "license": "MIT",
   "author": "DreamLongYT"
-}
+}

package/bin/runner.js

@@ -1,26 +0,0 @@
-#!/usr/bin/env node
-import { createRequire } from "node:module";
-import { fileURLToPath, pathToFileURL } from "node:url";
-import path from "pathe";
-
-const require = createRequire(import.meta.url);
-
-let cliPath;
-
-try {
-  // 1. Try standard package resolution
-  const pkgPath = require.resolve("@optiprune/cli/package.json");
-  cliPath = path.join(path.dirname(pkgPath), "dist/cli.js");
-} catch {
-  // 2. Monorepo / global symlink fallback
-  const currentDir = path.dirname(fileURLToPath(import.meta.url));
-  cliPath = path.resolve(currentDir, "../../cli/dist/cli.js");
-}
-
-// Convert absolute Windows path (E:\...) into a valid file:// URL
-const cliUrl = pathToFileURL(cliPath).href;
-
-import(cliUrl).catch((err) => {
-  console.error("Failed to execute @optiprune/cli:", err);
-  process.exit(1);
-});