@yalehwang/archguard 0.1.0

package/README.md

@@ -0,0 +1,537 @@
+# ArchGuard
+
+ArchGuard analyzes source code to extract architectural insights and generates **Mermaid diagrams** at multiple levels of detail. It supports TypeScript (stable), Go (stable), Java (beta), and Python (beta) through a plugin system, with optional LLM-powered grouping for better diagram organization.
+
+## Screenshots
+
+### Package-Level Overview
+![Package Overview](docs/screenshots/overview-package.png)
+
+### Class-Level Diagram
+![Class Diagram](docs/screenshots/class-all-classes.png)
+
+### Method-Level Detail (CLI Module)
+![CLI Module Methods](docs/screenshots/method-cli-module.png)
+
+## Features
+
+- **Multi-Language Support**: TypeScript, Go, Java, Python via plugin system
+- **Multi-Level Diagrams**: Package (high-level), Class (default), Method (low-level)
+- **Go Architecture Atlas**: 4-layer visualization — package graph, capability graph, goroutine topology, flow graph
+- **Parallel Processing**: High-performance parsing with configurable concurrency
+- **Smart Caching**: File-based caching with SHA-256 hashing for fast repeated runs
+- **AI-Powered Grouping**: Optional LLM-powered intelligent grouping via Claude API
+- **Zero External Dependencies**: Local Mermaid rendering using isomorphic-mermaid
+- **Five-Layer Validation**: Automatic syntax, structure, render, quality, and auto-repair validation
+- **Configuration Files**: Project-level config with `archguard.config.json` support
+- **Rich CLI**: Interactive progress display with real-time feedback
+
+## Quick Start
+
+### Installation
+
+```bash
+npm install -g archguard
+```
+
+Or as a dev dependency:
+
+```bash
+npm install --save-dev archguard
+```
+
+### Basic Usage
+
+Analyze a TypeScript project:
+
+```bash
+archguard analyze -s ./src --output-dir ./docs/architecture
+```
+
+Analyze a Go project:
+
+```bash
+archguard analyze -s ./cmd --lang go --output-dir ./docs/architecture
+```
+
+This generates `architecture.mmd` (Mermaid source), `architecture.svg`, and `architecture.png`.
+
+### Multi-Level Diagrams
+
+```bash
+# Package-level overview (high-level)
+archguard analyze -s ./src -l package -n overview
+
+# Class-level detail (default)
+archguard analyze -s ./src -l class -n architecture
+
+# Method-level detail (granular)
+archguard analyze -s ./src/core -l method -n core-detail
+```
+
+## CLI Commands
+
+### `analyze`
+
+Analyze a project and generate architecture diagrams.
+
+```bash
+archguard analyze [options]
+```
+
+**Source & Level:**
+
+- `-s, --sources <paths...>` - Source directories (repeatable)
+- `-l, --level <level>` - Detail level: `package` | `class` | `method` (default: `class`)
+- `-n, --name <name>` - Diagram name, supports paths like `modules/auth` (default: `architecture`)
+- `--lang <language>` - Language: `typescript` | `go` | `java` | `python` (auto-detected)
+
+**Output:**
+
+- `--output-dir <dir>` - Output directory (default: `./archguard`)
+- `-f, --format <type>` - Output format: `mermaid` | `json` (default: `mermaid`)
+- `-e, --exclude <patterns...>` - Exclude glob patterns
+
+**Performance:**
+
+- `--no-cache` - Disable cache
+- `-c, --concurrency <num>` - Parallel parsing workers (default: CPU cores)
+- `-v, --verbose` - Verbose output
+
+**Mermaid:**
+
+- `--mermaid-theme <theme>` - Theme: `default` | `forest` | `dark` | `neutral`
+- `--no-llm-grouping` - Use heuristic grouping instead of LLM
+
+**Go Atlas** (enabled by default for Go):
+
+- `--no-atlas` - Disable Atlas mode, use standard Go parsing
+- `--atlas-layers <layers>` - Comma-separated layers: `package,capability,goroutine,flow`
+- `--atlas-strategy <strategy>` - Analysis strategy: `none` | `selective` | `full`
+- `--atlas-entry-points <types>` - Entry point types to focus on
+- `--atlas-include-tests` - Include test packages in Atlas
+
+**Multi-Diagram (config file):**
+
+- `--config <path>` - Config file path (default: `archguard.config.json`)
+- `--diagrams <names...>` - Generate only specific diagrams by name
+
+**Claude CLI:**
+
+- `--cli-command <command>` - Claude CLI executable (default: `claude`)
+- `--cli-args <args>` - Additional Claude CLI arguments
+
+**Examples:**
+
+```bash
+# Basic analysis
+archguard analyze
+
+# Analyze specific directory with custom output
+archguard analyze -s ./packages/core --output-dir ./docs/core-architecture
+
+# Generate JSON for tooling integration
+archguard analyze -s ./src --output-dir . -f json
+
+# Go project with Architecture Atlas
+archguard analyze -s ./cmd --lang go
+
+# Go without Atlas (faster, basic diagram)
+archguard analyze -s ./cmd --lang go --no-atlas
+
+# High concurrency
+archguard analyze -s ./src -c 8 -v
+
+# Exclude test files
+archguard analyze -s ./src -e "**/*.test.ts" "**/*.spec.ts"
+
+# Disable LLM grouping (heuristic, no Claude needed)
+archguard analyze -s ./src --no-llm-grouping
+
+# Dark theme
+archguard analyze -s ./src --mermaid-theme dark
+```
+
+### `init`
+
+Initialize configuration file:
+
+```bash
+archguard init
+```
+
+Creates `archguard.config.json` with defaults. Use `-f js` for a JavaScript config.
+
+### `cache`
+
+```bash
+archguard cache stats   # View cache statistics
+archguard cache clear   # Clear all cached data
+archguard cache path    # Show cache directory
+```
+
+## Language Support
+
+| Language   | Status | Parser                    | Features                                           |
+|------------|--------|---------------------------|----------------------------------------------------|
+| TypeScript | Stable | ts-morph (AST)            | Classes, interfaces, enums, dependencies, path aliases |
+| Go         | Stable | tree-sitter + gopls       | Structs, interfaces, goroutines, Architecture Atlas |
+| Java       | Beta   | tree-sitter               | Classes, interfaces, Maven/Gradle deps              |
+| Python     | Beta   | tree-sitter               | Classes, functions, pip/Poetry deps                 |
+
+### Go Architecture Atlas
+
+For Go projects, ArchGuard generates a multi-layer architecture atlas showing:
+
+- **Package Graph** — inter-package dependencies and coupling
+- **Capability Graph** — functional capability clusters
+- **Goroutine Topology** — concurrent execution patterns and channel topology
+- **Flow Graph** — data and control flow paths
+
+```bash
+# Full Atlas (default when --lang go)
+archguard analyze -s ./cmd --lang go
+
+# Specific layers only
+archguard analyze -s ./cmd --lang go --atlas-layers package,capability
+
+# Standard diagram without Atlas
+archguard analyze -s ./cmd --lang go --no-atlas
+```
+
+gopls is optional but improves interface detection accuracy from ~75% to ~95%:
+
+```bash
+go install golang.org/x/tools/gopls@latest
+```
+
+See [Go Plugin Usage Guide](docs/user-guide/golang-plugin-usage.md) for details.
+
+## Configuration
+
+### `archguard.config.json`
+
+```json
+{
+  "source": "./src",
+  "format": "mermaid",
+  "exclude": ["**/*.test.ts", "**/*.spec.ts", "**/node_modules/**"],
+  "concurrency": 4,
+  "outputDir": "./archguard",
+  "cache": { "enabled": true },
+  "mermaid": {
+    "enableLLMGrouping": true,
+    "renderer": "isomorphic",
+    "theme": "default",
+    "transparentBackground": true
+  },
+  "cli": {
+    "command": "claude",
+    "args": [],
+    "timeout": 60000
+  }
+}
+```
+
+### Multi-Diagram Configuration
+
+Generate multiple diagrams with different sources and levels in one run:
+
+```json
+{
+  "diagrams": [
+    {
+      "name": "overview",
+      "sources": ["./src"],
+      "level": "package"
+    },
+    {
+      "name": "modules/cli",
+      "sources": ["./src/cli"],
+      "level": "class"
+    },
+    {
+      "name": "modules/parser",
+      "sources": ["./src/parser"],
+      "level": "method"
+    }
+  ],
+  "outputDir": "./docs/architecture"
+}
+```
+
+```bash
+# Generate all diagrams
+archguard analyze
+
+# Generate specific diagrams only
+archguard analyze --diagrams overview modules/cli
+```
+
+### Configuration Fields
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `source` | string | `./src` | Source directory (single diagram mode) |
+| `diagrams` | array | — | Multi-diagram config (overrides `source`) |
+| `format` | string | `mermaid` | Output format: `mermaid` or `json` |
+| `exclude` | string[] | `[]` | Glob patterns to exclude |
+| `concurrency` | number | CPU cores | Parallel parsing workers |
+| `outputDir` | string | `./archguard` | Output directory |
+| `cache.enabled` | boolean | `true` | Enable file-based caching |
+| `mermaid.enableLLMGrouping` | boolean | `true` | LLM-powered entity grouping |
+| `mermaid.theme` | string | `default` | Diagram theme |
+| `mermaid.transparentBackground` | boolean | `true` | Transparent PNG background |
+| `cli.command` | string | `claude` | Claude CLI executable |
+| `cli.timeout` | number | `60000` | Claude CLI timeout (ms) |
+
+## Output Formats
+
+### Mermaid (default)
+
+Generates `.mmd`, `.svg`, and `.png` files:
+
+```
+archguard/
+├── overview/
+│   ├── package.mmd
+│   ├── package.svg
+│   └── package.png
+├── modules/
+│   ├── cli.mmd
+│   └── cli.png
+└── index.md
+```
+
+Example `.mmd` output:
+
+```
+graph TD
+  UserService[UserService<br/>+ getUser(id): Promise&lt;User&gt;<br/>+ createUser(data): Promise&lt;User&gt;]
+  User[User<br/>+ id: string<br/>+ name: string]
+
+  UserService --> User : uses
+```
+
+### ArchJSON
+
+Structured JSON for tooling integration:
+
+```json
+{
+  "version": "1.0",
+  "language": "typescript",
+  "timestamp": "2024-01-01T00:00:00.000Z",
+  "entities": [
+    {
+      "id": "UserService",
+      "name": "UserService",
+      "type": "class",
+      "members": [...]
+    }
+  ],
+  "relations": [
+    { "from": "UserService", "to": "User", "type": "dependency" }
+  ]
+}
+```
+
+## Performance
+
+- **Parallel Processing**: Automatically uses all CPU cores for parsing
+- **Smart Caching**: SHA-256 file hashing; 80%+ cache hit rate on repeated runs
+- **Benchmark** (ArchGuard self-analysis, 30+ files):
+  - First run: ~6–10 seconds
+  - Cached run: < 3 seconds
+  - Throughput: ~4–5 files/second
+  - Memory: < 300 MB
+
+Tune concurrency:
+
+```bash
+archguard analyze -s ./src -c 8     # custom workers
+archguard analyze -s ./src -c 1     # sequential (debugging)
+```
+
+## Architecture
+
+### Project Structure
+
+```
+archguard/
+├── src/
+│   ├── cli/                 # CLI commands and utilities
+│   │   ├── commands/        # analyze, init, cache
+│   │   ├── progress/        # Progress reporting
+│   │   ├── processors/      # Diagram processing pipeline
+│   │   └── utils/           # Config loader, error handler
+│   ├── core/                # Plugin registry and interfaces
+│   │   └── interfaces/      # ILanguagePlugin, IParser, IDependencyExtractor
+│   ├── parser/              # TypeScript AST parsing
+│   │   ├── typescript-parser.ts
+│   │   ├── parallel-parser.ts
+│   │   └── extractors/      # class, interface, enum, relation
+│   ├── mermaid/             # Diagram generation
+│   │   ├── diagram-generator.ts
+│   │   ├── renderer.ts
+│   │   ├── validation-pipeline.ts
+│   │   └── validators/      # parse, structural, render, quality
+│   ├── plugins/             # Language plugins
+│   │   ├── typescript/      # Stable
+│   │   ├── golang/          # Stable (tree-sitter + gopls + Atlas)
+│   │   │   └── atlas/       # package, capability, goroutine, flow builders
+│   │   ├── java/            # Beta
+│   │   └── python/          # Beta
+│   └── types/               # Core types (config, ArchJSON, extensions)
+├── tests/
+│   ├── unit/                # Unit tests
+│   ├── integration/         # Integration tests
+│   ├── plugins/             # Per-plugin tests
+│   └── core/                # Plugin registry tests
+└── docs/                    # Documentation and screenshots
+```
+
+### Data Flow
+
+```
+Source Files
+    │
+    ▼ Language Plugin (TypeScript / Go / Java / Python)
+AST / Tree-sitter Parse
+    │
+    ▼ Extractors
+ArchJSON (entities + relations)
+    │
+    ├─► (Go) Atlas Builders → 4-layer extension
+    │
+    ▼ LLM Grouper (optional, Claude API)
+Grouped ArchJSON
+    │
+    ▼ Mermaid Generator
+.mmd syntax
+    │
+    ▼ Five-Layer Validator + Auto-repair
+Valid .mmd
+    │
+    ▼ isomorphic-mermaid + sharp
+.svg + .png
+```
+
+## Development
+
+### Prerequisites
+
+- Node.js >= 18.0.0
+- npm or yarn
+
+Optional, for enhanced features:
+- **Claude CLI** — LLM-powered diagram grouping
+- **gopls** — Semantic interface detection for Go projects
+
+### Setup
+
+```bash
+git clone https://github.com/your-org/archguard.git
+cd archguard
+npm install
+npm run build
+npm test
+```
+
+### Testing
+
+```bash
+npm test                    # All tests (vitest)
+npm run test:unit           # Unit tests
+npm run test:integration    # Integration tests
+npm run test:coverage       # With coverage report
+npm run test:watch          # Watch mode
+```
+
+### Code Quality
+
+```bash
+npm run lint                # ESLint check
+npm run lint:fix            # Auto-fix
+npm run format              # Prettier
+npm run type-check          # TypeScript check
+npm run build && npm run lint && npm run type-check && npm test
+```
+
+### Self-Analysis
+
+```bash
+npm run build
+
+# Analyze ArchGuard itself
+node dist/cli/index.js analyze -v
+
+# Package-level overview
+node dist/cli/index.js analyze -l package -n overview
+
+# Method-level detail for a module
+node dist/cli/index.js analyze -s ./src/cli -l method -n cli-module
+```
+
+## Technology Stack
+
+| Category | Technology | Version | Purpose |
+|----------|-----------|---------|---------|
+| Language | TypeScript | ^5.3.0 | Type-safe development |
+| Runtime | Node.js | >=18.0.0 | JavaScript runtime |
+| TS Parser | ts-morph | ^21.0.0 | TypeScript AST |
+| Go Parser | tree-sitter + tree-sitter-go | ^0.25.0 | Go AST |
+| Java/Python Parser | tree-sitter | ^0.25.0 | Java/Python AST |
+| Go LSP | gopls | latest | Semantic interface detection |
+| Diagram Generation | isomorphic-mermaid | ^0.1.1 | Local Mermaid rendering |
+| Image Processing | sharp | ^0.34.5 | SVG → PNG conversion |
+| LLM Integration | @anthropic-ai/sdk | ^0.20.0 | Optional LLM grouping |
+| Process Management | execa | ^8.0.0 | Subprocess execution |
+| Testing | Vitest | ^1.2.0 | Unit/integration tests |
+| CLI | commander | ^11.1.0 | Command-line interface |
+| Progress | ora, chalk | ^8.x, ^5.x | Interactive CLI |
+| Concurrency | p-limit | ^5.0.0 | Parallel processing |
+| Configuration | zod | ^3.25.76 | Config validation |
+
+## Troubleshooting
+
+See [TROUBLESHOOTING.md](docs/user-guide/troubleshooting.md) for common issues.
+
+Quick fixes:
+
+- **LLM grouping fails** — run with `--no-llm-grouping` to use heuristic mode
+- **Go interface detection low** — install gopls: `go install golang.org/x/tools/gopls@latest`
+- **Slow first run** — normal; subsequent runs use cache (80%+ hit rate)
+- **Render errors** — the five-layer validator auto-repairs most issues; run with `-v` for details
+
+## Documentation
+
+- [CLI Usage Guide](docs/user-guide/cli-usage.md)
+- [Configuration Reference](docs/user-guide/configuration.md)
+- [Go Plugin Usage Guide](docs/user-guide/golang-plugin-usage.md)
+- [Plugin Development Guide](docs/dev-guide/plugin-development-guide.md)
+- [Plugin Registry](docs/user-guide/plugin-registry.md)
+- [Troubleshooting](docs/user-guide/troubleshooting.md)
+
+## Contributing
+
+This project follows:
+
+- **TDD Methodology**: Tests written before implementation
+- **Plugin System**: Add new languages via `ILanguagePlugin`
+- **Clean Code**: Readable, maintainable code
+
+See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for documentation management details.
+
+## License
+
+MIT
+
+## Credits
+
+Built with:
+- [ts-morph](https://ts-morph.com/) for TypeScript parsing
+- [tree-sitter](https://tree-sitter.github.io/) for Go/Java/Python parsing
+- [Mermaid](https://mermaid.js.org/) for diagram syntax
+- [isomorphic-mermaid](https://github.com/brede95/isomorphic-mermaid) for rendering
+- [Claude AI](https://www.anthropic.com/claude) for optional LLM-powered grouping

package/dist/cli/cache/arch-json-disk-cache.d.ts

@@ -0,0 +1,12 @@
+import type { ArchJSON } from '../../types/index.js';
+export declare const CACHE_VERSION = "1.0.0";
+export declare class ArchJsonDiskCache {
+    private readonly cacheDir;
+    constructor(cacheDir: string);
+    private keyPath;
+    get(key: string): Promise<ArchJSON | null>;
+    set(key: string, archJson: ArchJSON): Promise<void>;
+    computeKey(files: string[]): Promise<string>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=arch-json-disk-cache.d.ts.map

package/dist/cli/cache/arch-json-disk-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-json-disk-cache.d.ts","sourceRoot":"","sources":["../../../src/cli/cache/arch-json-disk-cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,eAAO,MAAM,aAAa,UAAU,CAAC;AAQrC,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE7C,OAAO,CAAC,OAAO;IAKT,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAY1C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/cli/cache/arch-json-disk-cache.js

@@ -0,0 +1,51 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { createHash } from 'crypto';
+export const CACHE_VERSION = '1.0.0';
+export class ArchJsonDiskCache {
+    cacheDir;
+    constructor(cacheDir) {
+        this.cacheDir = cacheDir;
+    }
+    keyPath(key) {
+        const sub = key.slice(0, 2);
+        return path.join(this.cacheDir, sub, `${key}.json`);
+    }
+    async get(key) {
+        const filePath = this.keyPath(key);
+        try {
+            if (!(await fs.pathExists(filePath)))
+                return null;
+            const entry = (await fs.readJson(filePath));
+            if (entry.version !== CACHE_VERSION)
+                return null;
+            return entry.archJson;
+        }
+        catch {
+            return null;
+        }
+    }
+    async set(key, archJson) {
+        const filePath = this.keyPath(key);
+        await fs.ensureDir(path.dirname(filePath));
+        const entry = {
+            version: CACHE_VERSION,
+            createdAt: new Date().toISOString(),
+            archJson,
+        };
+        await fs.writeJson(filePath, entry);
+    }
+    async computeKey(files) {
+        const sorted = [...files].sort();
+        const hashes = await Promise.all(sorted.map(async (f) => {
+            const content = await fs.readFile(f);
+            return createHash('sha256').update(content).digest('hex');
+        }));
+        const combined = sorted.map((f, i) => `${f}:${hashes[i]}`).join('\n');
+        return createHash('sha256').update(combined).digest('hex');
+    }
+    async clear() {
+        await fs.emptyDir(this.cacheDir);
+    }
+}
+//# sourceMappingURL=arch-json-disk-cache.js.map

package/dist/cli/cache/arch-json-disk-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-json-disk-cache.js","sourceRoot":"","sources":["../../../src/cli/cache/arch-json-disk-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGpC,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC;AAQrC,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEzC,OAAO,CAAC,GAAW;QACzB,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YAClD,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAe,CAAC;YAC1D,IAAI,KAAK,CAAC,OAAO,KAAK,aAAa;gBAAE,OAAO,IAAI,CAAC;YACjD,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,QAAkB;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAe;YACxB,OAAO,EAAE,aAAa;YACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ;SACT,CAAC;QACF,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,MAAM,MAAM,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACrB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACrC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC,CAAC,CACH,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/cli/cache-manager.d.ts

@@ -0,0 +1,28 @@
+export interface CacheStats {
+    hits: number;
+    misses: number;
+    hitRate: number;
+    totalSize: number;
+}
+export interface CacheOptions {
+    ttl?: number;
+}
+export declare class CacheManager {
+    readonly cacheDir: string;
+    private stats;
+    private defaultTTL;
+    constructor(cacheDir?: string);
+    computeFileHash(filePath: string): Promise<string>;
+    get<T = unknown>(filePath: string, hash: string): Promise<T | null>;
+    set<T = unknown>(filePath: string, hash: string, data: T, options?: CacheOptions): Promise<void>;
+    clear(): Promise<void>;
+    getStats(): CacheStats;
+    getCacheSize(): Promise<number>;
+    private getAllCacheFiles;
+    private getCacheKey;
+    private getCachePath;
+    private updateHitRate;
+    setDefaultTTL(ttl: number): void;
+    getDefaultTTL(): number;
+}
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/cli/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/cli/cache-manager.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAiBD,qBAAa,YAAY;IACvB,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,OAAO,CAAC,KAAK,CAKX;IACF,OAAO,CAAC,UAAU,CAAiB;gBAEvB,QAAQ,CAAC,EAAE,MAAM;IAOvB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASlD,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAoCnE,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,CAAC,EACP,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;IAiBV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,QAAQ,IAAI,UAAU;IAOhB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;YAwBvB,gBAAgB;IA0B9B,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,aAAa;IAQrB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOhC,aAAa,IAAI,MAAM;CAGxB"}