@yalehwang/archguard 0.1.6 → 0.1.8

package/README.md

@@ -1,6 +1,6 @@
 # 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.
+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, and exposes query and MCP workflows for architecture inspection.
 
 ## Screenshots
 
@@ -20,7 +20,7 @@ ArchGuard analyzes source code to extract architectural insights and generates *
 - **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
+- **Query & MCP Workflows**: Persisted architecture data can be inspected via CLI query tools or MCP
 - **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
@@ -54,19 +54,16 @@ Analyze a Go project:
 archguard analyze -s ./cmd --lang go --output-dir ./docs/architecture
 ```
 
-This generates `architecture.mmd` (Mermaid source), `architecture.svg`, and `architecture.png`.
+This generates Mermaid diagrams or ArchJSON under the configured output directory, and query artifacts under the work directory.
 
-### Multi-Level Diagrams
+### Level Filtering
 
 ```bash
-# Package-level overview (high-level)
-archguard analyze -s ./src -l package -n overview
+# Generate only class and method diagrams
+archguard analyze --diagrams class method
 
-# 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
+# Generate only package diagrams for a source set
+archguard analyze -s ./src --diagrams package
 ```
 
 ## CLI Commands
@@ -79,16 +76,18 @@ Analyze a project and generate architecture diagrams.
 archguard analyze [options]
 ```
 
-**Source & Level:**
+**Source & Selection:**
 
-- `-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`)
+- `-s, --sources <paths...>` - Source directories; triggers auto-detection and multi-diagram generation
+- `--diagrams <levels...>` - Filter by level: `package` | `class` | `method` (language-dependent)
 - `--lang <language>` - Language: `typescript` | `go` | `java` | `python` (auto-detected)
+- `--config <path>` - Config file path (default: `archguard.config.json`)
 
 **Output:**
 
-- `--output-dir <dir>` - Output directory (default: `./archguard`)
+- `--work-dir <dir>` - ArchGuard work directory (default: `./.archguard`)
+- `--cache-dir <dir>` - Cache directory (default: `<work-dir>/cache`)
+- `--output-dir <dir>` - Output directory
 - `-f, --format <type>` - Output format: `mermaid` | `json` (default: `mermaid`)
 - `-e, --exclude <patterns...>` - Exclude glob patterns
 
@@ -101,20 +100,17 @@ archguard analyze [options]
 **Mermaid:**
 
 - `--mermaid-theme <theme>` - Theme: `default` | `forest` | `dark` | `neutral`
-- `--no-llm-grouping` - Use heuristic grouping instead of LLM
+- `--mermaid-renderer <renderer>` - Renderer: `isomorphic` | `cli`
 
 **Go Atlas** (enabled by default for Go):
 
+- `--atlas` - Enable Atlas mode
 - `--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-no-tests` - Exclude test files from Atlas extraction
 - `--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
+- `--atlas-protocols <protocols>` - Protocols included in flow graph
 
 **Claude CLI:**
 
@@ -127,8 +123,8 @@ archguard analyze [options]
 # Basic analysis
 archguard analyze
 
-# Analyze specific directory with custom output
-archguard analyze -s ./packages/core --output-dir ./docs/core-architecture
+# Filter generated diagrams by level
+archguard analyze --diagrams class method
 
 # Generate JSON for tooling integration
 archguard analyze -s ./src --output-dir . -f json
@@ -145,13 +141,51 @@ 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
 ```
 
+### `query`
+
+Query persisted architecture entities and relationships.
+
+```bash
+archguard query [options]
+```
+
+Common examples:
+
+```bash
+archguard query --summary
+archguard query --entity "DiagramProcessor"
+archguard query --entity "DiagramProcessor" --format json
+archguard query --entity "DiagramProcessor" --format json --verbose
+archguard query --deps-of "DiagramProcessor" --depth 2
+archguard query --implementers-of "ILanguagePlugin"
+archguard query --list-scopes
+```
+
+Typical architecture checking tasks:
+
+- Dependency impact: `archguard query --deps-of "DiagramProcessor" --depth 2`
+- Reverse impact: `archguard query --used-by "DiagramProcessor" --depth 2`
+- Extension points: `archguard query --implementers-of "ILanguagePlugin"`
+- Circular dependencies: `archguard query --cycles`
+- Refactoring hotspots: `archguard query --high-coupling`
+- Orphans: `archguard query --orphans`
+
+See [Architecture Checking Scenarios](docs/user-guide/architecture-checking-scenarios.md) for task-oriented workflows.
+
+### `mcp`
+
+Start the ArchGuard MCP server over stdio.
+
+```bash
+archguard mcp [--arch-dir <dir>] [--scope <key>]
+```
+
+The MCP server exposes the query tools plus `archguard_analyze`, which refreshes query artifacts for the current MCP session. Query tools default to the persisted global scope and return summary entities unless `verbose: true` is requested.
+
 ### `init`
 
 Initialize configuration file:
@@ -213,14 +247,13 @@ See [Go Plugin Usage Guide](docs/user-guide/golang-plugin-usage.md) for details.
 
 ```json
 {
-  "source": "./src",
   "format": "mermaid",
   "exclude": ["**/*.test.ts", "**/*.spec.ts", "**/node_modules/**"],
   "concurrency": 4,
-  "outputDir": "./archguard",
-  "cache": { "enabled": true },
+  "workDir": "./.archguard",
+  "outputDir": "./docs/architecture",
+  "cache": { "enabled": true, "dir": "./.archguard/cache" },
   "mermaid": {
-    "enableLLMGrouping": true,
     "renderer": "isomorphic",
     "theme": "default",
     "transparentBackground": true
@@ -264,22 +297,22 @@ Generate multiple diagrams with different sources and levels in one run:
 # Generate all diagrams
 archguard analyze
 
-# Generate specific diagrams only
-archguard analyze --diagrams overview modules/cli
+# Filter configured diagrams by level
+archguard analyze --diagrams class method
 ```
 
 ### Configuration Fields
 
 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
-| `source` | string | `./src` | Source directory (single diagram mode) |
+| `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 |
+| `workDir` | string | `./.archguard` | Work directory for cache and query artifacts |
+| `outputDir` | string | `./.archguard/output` | 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 |
@@ -355,6 +388,12 @@ archguard analyze -s ./src -c 1     # sequential (debugging)
 
 ## Architecture
 
+For current implementation details, see:
+
+- [Architecture Checking Scenarios](docs/user-guide/architecture-checking-scenarios.md)
+- [Architecture Overview](docs/dev-guide/architecture.md)
+- [CLI Usage](docs/user-guide/cli-usage.md)
+
 ### Project Structure
 
 ```
@@ -394,27 +433,22 @@ archguard/
 ### Data Flow
 
 ```
-Source Files
-    │
-    ▼ Language Plugin (TypeScript / Go / Java / Python)
-AST / Tree-sitter Parse
-    │
-    ▼ Extractors
-ArchJSON (entities + relations)
+CLI / MCP entrypoint
     │
-    ├─► (Go) Atlas Builders → 4-layer extension
+    ▼ Shared analysis core (`runAnalysis`)
+Config normalization + diagram selection
     │
-    ▼ LLM Grouper (optional, Claude API)
-Grouped ArchJSON
+    ▼ DiagramProcessor
+ArchJsonProvider + language plugins
     │
-    ▼ Mermaid Generator
-.mmd syntax
+    ▼ ArchJSON (entities + relations + optional extensions)
     │
-    ▼ Five-Layer Validator + Auto-repair
-Valid .mmd
+    ├─► Query artifacts (`.archguard/query/*`)
+    ├─► Mermaid / JSON outputs (`.archguard/output/*`)
+    └─► Go Atlas extension (package / capability / goroutine / flow)
     │
-    ▼ isomorphic-mermaid + sharp
-.svg + .png
+    ▼ QueryEngine / MCP query tools
+Architecture inspection workflows
 ```
 
 ## Development
@@ -425,7 +459,6 @@ Valid .mmd
 - npm or yarn
 
 Optional, for enhanced features:
-- **Claude CLI** — LLM-powered diagram grouping
 - **gopls** — Semantic interface detection for Go projects
 
 ### Setup
@@ -485,7 +518,6 @@ node dist/cli/index.js analyze -s ./src/cli -l method -n cli-module
 | 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 |
@@ -499,17 +531,18 @@ 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
-- **Install fails on macOS arm64 + Node.js 25** — `tree-sitter` native addon compilation requires C++20; use `npm install -g @yalehwang/archguard --ignore-scripts` to skip native build (JS functionality unaffected), or use Node.js 22 LTS
+- **Install fails with missing `tree-sitter` binding** — use the packaged release tarball that bundles the required prebuilt `tree-sitter` binary for your platform/runtime; source rebuild fallback is disabled
 
 ## Documentation
 
 - [CLI Usage Guide](docs/user-guide/cli-usage.md)
+- [Architecture Checking Scenarios](docs/user-guide/architecture-checking-scenarios.md)
 - [Configuration Reference](docs/user-guide/configuration.md)
 - [Go Plugin Usage Guide](docs/user-guide/golang-plugin-usage.md)
+- [Architecture Overview](docs/dev-guide/architecture.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)
@@ -535,4 +568,3 @@ Built with:
 - [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/analyze/normalize-to-diagrams.d.ts

@@ -0,0 +1,5 @@
+import type { Config } from '../config-loader.js';
+import type { CLIOptions, DiagramConfig } from '../../types/config.js';
+export declare function normalizeToDiagrams(config: Config, cliOptions: CLIOptions, rootDir?: string): Promise<DiagramConfig[]>;
+export declare function filterByLevels(diagrams: DiagramConfig[], levels?: string[]): DiagramConfig[];
+//# sourceMappingURL=normalize-to-diagrams.d.ts.map

package/dist/cli/analyze/normalize-to-diagrams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-to-diagrams.d.ts","sourceRoot":"","sources":["../../../src/cli/analyze/normalize-to-diagrams.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAKvE,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,EAAE,CAAC,CAoF1B;AASD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAM5F"}

package/dist/cli/analyze/normalize-to-diagrams.js

@@ -0,0 +1,94 @@
+import path from 'path';
+import fs from 'fs-extra';
+import { detectProjectStructure } from '../utils/project-structure-detector.js';
+import { detectCppProjectStructure } from '../utils/cpp-project-structure-detector.js';
+export async function normalizeToDiagrams(config, cliOptions, rootDir) {
+    const resolvedRoot = rootDir ?? process.cwd();
+    if (config.diagrams && config.diagrams.length > 0) {
+        return filterByLevels(config.diagrams, cliOptions.diagrams);
+    }
+    if (cliOptions.sources && cliOptions.sources.length > 0) {
+        const language = cliOptions.lang ?? (cliOptions.atlas ? 'go' : undefined);
+        const atlasEnabled = language === 'go' && cliOptions.atlas !== false;
+        if (atlasEnabled) {
+            const diagram = {
+                name: 'architecture',
+                sources: cliOptions.sources,
+                level: 'package',
+                format: cliOptions.format,
+                exclude: cliOptions.exclude,
+                language,
+                languageSpecific: {
+                    atlas: {
+                        enabled: true,
+                        functionBodyStrategy: cliOptions.atlasStrategy ?? 'selective',
+                        excludeTests: !cliOptions.atlasIncludeTests,
+                        protocols: cliOptions.atlasProtocols?.split(',').map((s) => s.trim()),
+                        layers: cliOptions.atlasLayers?.split(',').map((s) => s.trim()),
+                    },
+                },
+            };
+            return [diagram];
+        }
+        if (language === 'go' && cliOptions.atlas === false) {
+            const diagram = {
+                name: 'architecture',
+                sources: cliOptions.sources,
+                level: 'class',
+                format: cliOptions.format,
+                exclude: cliOptions.exclude,
+                language,
+            };
+            return [diagram];
+        }
+        if (language === 'cpp') {
+            const sourcePath = path.resolve(cliOptions.sources[0]);
+            const moduleName = path.basename(sourcePath);
+            const diagrams = await detectCppProjectStructure(sourcePath, moduleName, {
+                format: cliOptions.format,
+                exclude: cliOptions.exclude,
+            });
+            return filterByLevels(diagrams, cliOptions.diagrams);
+        }
+        const externalSourceRoot = path.resolve(cliOptions.sources[0]);
+        const diagrams = await detectProjectStructure(resolvedRoot, externalSourceRoot);
+        return filterByLevels(diagrams, cliOptions.diagrams);
+    }
+    const inferredLanguage = cliOptions.lang ?? (cliOptions.atlas ? 'go' : await detectRootLanguage(resolvedRoot));
+    if (inferredLanguage === 'go') {
+        return [
+            {
+                name: 'architecture',
+                sources: ['.'],
+                level: 'package',
+                format: cliOptions.format,
+                exclude: cliOptions.exclude,
+                language: 'go',
+                languageSpecific: {
+                    atlas: {
+                        enabled: cliOptions.atlas !== false,
+                        functionBodyStrategy: cliOptions.atlasStrategy ?? 'selective',
+                        excludeTests: !cliOptions.atlasIncludeTests,
+                        protocols: cliOptions.atlasProtocols?.split(',').map((s) => s.trim()),
+                        layers: cliOptions.atlasLayers?.split(',').map((s) => s.trim()),
+                    },
+                },
+            },
+        ];
+    }
+    const diagrams = await detectProjectStructure(resolvedRoot);
+    return filterByLevels(diagrams, cliOptions.diagrams);
+}
+async function detectRootLanguage(rootDir) {
+    if (await fs.pathExists(path.join(rootDir, 'go.mod'))) {
+        return 'go';
+    }
+    return undefined;
+}
+export function filterByLevels(diagrams, levels) {
+    if (!levels || levels.length === 0) {
+        return diagrams;
+    }
+    return diagrams.filter((d) => levels.includes(d.level ?? 'class'));
+}
+//# sourceMappingURL=normalize-to-diagrams.js.map

package/dist/cli/analyze/normalize-to-diagrams.js.map

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

package/dist/cli/analyze/run-analysis.d.ts

@@ -0,0 +1,20 @@
+import type { Config } from '../config-loader.js';
+import type { CLIOptions, DiagramConfig } from '../../types/config.js';
+import type { ProgressReporterLike } from '../progress.js';
+import type { DiagramResult } from '../processors/diagram-processor.js';
+export interface RunAnalysisOptions {
+    sessionRoot: string;
+    workDir: string;
+    cliOptions: Partial<CLIOptions>;
+    reporter: ProgressReporterLike;
+}
+export interface RunAnalysisResult {
+    config: Config;
+    diagrams: DiagramConfig[];
+    results: DiagramResult[];
+    queryScopesPersisted: number;
+    persistedScopeKeys: string[];
+    hasDiagramFailures: boolean;
+}
+export declare function runAnalysis(options: RunAnalysisOptions): Promise<RunAnalysisResult>;
+//# sourceMappingURL=run-analysis.d.ts.map

package/dist/cli/analyze/run-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-analysis.d.ts","sourceRoot":"","sources":["../../../src/cli/analyze/run-analysis.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAO3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExE,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,QAAQ,EAAE,oBAAoB,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAoGzF"}

package/dist/cli/analyze/run-analysis.js

@@ -0,0 +1,150 @@
+import path from 'path';
+import { ConfigLoader } from '../config-loader.js';
+import { DiagramProcessor } from '../processors/diagram-processor.js';
+import { DiagramIndexGenerator } from '../utils/diagram-index-generator.js';
+import { ParseCache } from '../../parser/parse-cache.js';
+import { persistQueryScopes } from '../query/query-artifacts.js';
+import { readManifest, writeManifest, cleanStaleDiagrams } from '../cache/diagram-manifest.js';
+import { normalizeToDiagrams } from './normalize-to-diagrams.js';
+export async function runAnalysis(options) {
+    const { sessionRoot, workDir, cliOptions, reporter } = options;
+    reporter.start('Loading configuration...');
+    const configLoader = new ConfigLoader(sessionRoot);
+    const configOverrides = buildConfigOverrides(cliOptions, workDir, sessionRoot);
+    const config = await configLoader.load(configOverrides, cliOptions.config);
+    reporter.succeed('Configuration loaded');
+    const selectedDiagrams = (await normalizeToDiagrams(config, cliOptions, sessionRoot)).map((diagram) => ({
+        ...diagram,
+        sources: diagram.sources.map((source) => path.resolve(sessionRoot, source)),
+    }));
+    reporter.info(`Found ${selectedDiagrams.length} diagram(s) to generate`);
+    if (selectedDiagrams.length === 0) {
+        return {
+            config,
+            diagrams: [],
+            results: [],
+            queryScopesPersisted: 0,
+            persistedScopeKeys: [],
+            hasDiagramFailures: false,
+        };
+    }
+    const cacheDir = config.cache?.dir || path.join(config.workDir || '.archguard', 'cache');
+    const outputDir = config.outputDir || path.join(config.workDir || '.archguard', 'output');
+    const existingManifest = await readManifest(cacheDir);
+    if (existingManifest) {
+        const currentNames = selectedDiagrams.map((d) => d.name);
+        const stale = await cleanStaleDiagrams(currentNames, existingManifest, outputDir);
+        if (stale.length > 0 && config.verbose) {
+            reporter.info(`Cleaned ${stale.length} stale diagram(s): ${stale.join(', ')}`);
+        }
+    }
+    const parseCache = new ParseCache();
+    const processor = new DiagramProcessor({
+        diagrams: selectedDiagrams,
+        globalConfig: config,
+        progress: reporter,
+        parseCache,
+    });
+    const results = await processor.processAll();
+    const successfulNames = results.filter((r) => r.success).map((r) => r.name);
+    if (successfulNames.length > 0) {
+        try {
+            await writeManifest(cacheDir, successfulNames, outputDir);
+        }
+        catch (err) {
+            if (config.verbose) {
+                const msg = err instanceof Error ? err.message : String(err);
+                reporter.warn(`[manifest] Failed to write diagram manifest: ${msg}`);
+            }
+        }
+    }
+    let persistedScopeKeys = [];
+    let hasArtifactFailures = results.some((r) => !r.success);
+    const queryScopes = processor.getQuerySourceGroups();
+    if (queryScopes.length > 0) {
+        try {
+            const entries = await persistQueryScopes(config.workDir || workDir, queryScopes);
+            persistedScopeKeys = entries.map((entry) => entry.key);
+            if (config.verbose) {
+                reporter.info(`Persisted ${entries.length} query scope(s) to ${(config.workDir || workDir)}/query/`);
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            reporter.warn(`[query] Failed to persist query scopes: ${msg}`);
+        }
+    }
+    if (results.length > 1) {
+        try {
+            reporter.start('Generating index...');
+            const indexGenerator = new DiagramIndexGenerator(config);
+            await indexGenerator.generate(results);
+            reporter.succeed('Index generated');
+        }
+        catch (err) {
+            hasArtifactFailures = true;
+            const msg = err instanceof Error ? err.message : String(err);
+            reporter.warn(`[index] Failed to generate index: ${msg}`);
+        }
+    }
+    return {
+        config,
+        diagrams: selectedDiagrams,
+        results,
+        queryScopesPersisted: persistedScopeKeys.length,
+        persistedScopeKeys,
+        hasDiagramFailures: hasArtifactFailures,
+    };
+}
+function buildConfigOverrides(cliOptions, workDir, sessionRoot) {
+    const configOverrides = { workDir };
+    if (cliOptions.format)
+        configOverrides.format = cliOptions.format;
+    if (cliOptions.exclude)
+        configOverrides.exclude = cliOptions.exclude;
+    if (cliOptions.cache !== undefined) {
+        configOverrides.cache = { enabled: cliOptions.cache, ttl: 86400 };
+    }
+    if (cliOptions.cacheDir) {
+        configOverrides.cache = {
+            enabled: cliOptions.cache ?? true,
+            ttl: 86400,
+            dir: cliOptions.cacheDir,
+        };
+    }
+    if (cliOptions.concurrency) {
+        configOverrides.concurrency = parseInt(String(cliOptions.concurrency), 10);
+    }
+    if (cliOptions.verbose !== undefined)
+        configOverrides.verbose = cliOptions.verbose;
+    if (cliOptions.cliCommand || cliOptions.cliArgs) {
+        configOverrides.cli = {
+            command: cliOptions.cliCommand || 'claude',
+            args: cliOptions.cliArgs ? cliOptions.cliArgs.split(' ') : [],
+            timeout: 60000,
+        };
+    }
+    if (cliOptions.mermaidTheme !== undefined || cliOptions.mermaidRenderer !== undefined) {
+        configOverrides.mermaid = {
+            theme: cliOptions.mermaidTheme,
+            renderer: cliOptions.mermaidRenderer,
+            transparentBackground: true,
+        };
+    }
+    if (cliOptions.outputDir)
+        configOverrides.outputDir = cliOptions.outputDir;
+    if (cliOptions.sources &&
+        cliOptions.sources.length > 0 &&
+        !cliOptions.outputDir &&
+        !cliOptions.workDir) {
+        const sourcePath = path.resolve(sessionRoot, cliOptions.sources[0]);
+        if (!sourcePath.startsWith(sessionRoot)) {
+            const SOURCE_ROOT_NAMES = ['src', 'lib', 'app', 'source'];
+            const basename = path.basename(sourcePath);
+            const projectRoot = SOURCE_ROOT_NAMES.includes(basename) ? path.dirname(sourcePath) : sourcePath;
+            configOverrides.workDir = path.join(projectRoot, '.archguard');
+        }
+    }
+    return configOverrides;
+}
+//# sourceMappingURL=run-analysis.js.map

package/dist/cli/analyze/run-analysis.js.map

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

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

@@ -1 +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"}
+{"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;AAGjD,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

@@ -1,6 +1,7 @@
 import fs from 'fs-extra';
 import path from 'path';
 import { createHash } from 'crypto';
+import { canonicalizeArchJson } from '../utils/canonicalize-arch-json.js';
 export const CACHE_VERSION = '1.0.0';
 export class ArchJsonDiskCache {
     cacheDir;
@@ -31,7 +32,7 @@ export class ArchJsonDiskCache {
         const entry = {
             version: CACHE_VERSION,
             createdAt: new Date().toISOString(),
-            archJson,
+            archJson: canonicalizeArchJson(archJson),
         };
         await fs.writeJson(filePath, entry);
     }

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

@@ -1 +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"}
+{"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;AAEpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,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,EAAE,oBAAoB,CAAC,QAAQ,CAAC;SACzC,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/diagram-manifest.d.ts

@@ -0,0 +1,13 @@
+export declare const MANIFEST_VERSION = "1.0";
+export declare const MANIFEST_FILENAME = "diagram-manifest.json";
+export interface DiagramManifest {
+    version: string;
+    lastRun: string;
+    outputDir: string;
+    diagrams: string[];
+}
+export declare function readManifest(cacheDir: string): Promise<DiagramManifest | null>;
+export declare function writeManifest(cacheDir: string, diagrams: string[], outputDir: string): Promise<void>;
+export declare function cleanStaleDiagrams(currentDiagrams: string[], manifest: DiagramManifest, outputDir: string): Promise<string[]>;
+export declare function clearRenderHashes(outputDir: string): Promise<number>;
+//# sourceMappingURL=diagram-manifest.d.ts.map