@yalehwang/archguard 0.1.23 → 0.1.31

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, and exposes query and MCP workflows for architecture inspection.
+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), Python (beta), C++ (beta), and Kotlin/Android (beta) through a plugin system, and exposes query and MCP workflows for architecture inspection.
 
 ## Screenshots
 
@@ -16,10 +16,11 @@ ArchGuard analyzes source code to extract architectural insights and generates *
 ## Features
 
 - **AI-Native MCP Interface**: Query architecture in natural language from Claude Code or Codex — analyze projects, trace dependencies, find implementers, detect cycles
-- **Multi-Language Support**: TypeScript, Go, Java, Python via plugin system
+- **Multi-Language Support**: TypeScript, Go, Java, Python, C++, Kotlin/Android 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
-- **Static Test Analysis**: Test coverage mapping, assertion density, orphan detection, and quality issues — no test execution required
+- **Kotlin/Android Support**: Auto-detect Kotlin projects, parse `build.gradle.kts` / `settings.gradle.kts`, and plan multi-module diagrams
+- **Static Test Analysis**: Test coverage mapping, assertion density, orphan detection, and quality issues — no test execution required, including Kotlin/Android projects
 - **Parallel Processing**: High-performance parsing with configurable concurrency
 - **Smart Caching**: File-based caching with SHA-256 hashing for fast repeated runs
 - **Zero External Dependencies**: Local Mermaid rendering using isomorphic-mermaid
@@ -43,6 +44,24 @@ Register the MCP server (project scope):
 claude mcp add --scope project archguard -- archguard mcp
 ```
 
+Or install it for Claude Code user scope, including the bundled repository
+skills from this checkout:
+
+```bash
+bash scripts/install-claude-user-scope.sh
+```
+
+This installs the `archguard` binary globally for the current user, registers
+`archguard mcp` in `~/.claude/mcp.json`, and syncs all skills from
+`.agents/skills/` into `~/.claude/skills/`.
+
+If you already have fresh `dist/` artifacts and only want to re-install the user
+scope wiring, use:
+
+```bash
+bash scripts/install-claude-user-scope.sh --skip-build
+```
+
 Then ask Claude to analyze any project:
 
 > Analyze the architecture of `/path/to/my-project` using archguard MCP.
@@ -99,7 +118,7 @@ Point archguard at any project path — no configuration file needed:
 
 > Analyze the architecture of `/home/user/work/my-project` using archguard MCP.
 
-Archguard auto-detects the language and project structure, generates diagrams under `<project>/.archguard/`, and builds the query index for follow-up queries.
+Archguard auto-detects the language and project structure, generates diagrams under `<project>/.archguard/`, and builds the query index for follow-up queries. Kotlin/Android projects are detected from `build.gradle.kts`, `settings.gradle.kts`, `.kt`, and `.kts` markers and can be analyzed without forcing `--lang kotlin`.
 
 ### Standalone CLI
 
@@ -130,7 +149,7 @@ archguard analyze [options]
 
 - `-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)
+- `--lang <language>` - Language: `typescript` | `go` | `java` | `python` | `cpp` | `kotlin` (auto-detected)
 - `--config <path>` - Config file path (default: `archguard.config.json`)
 
 **Output:**
@@ -162,11 +181,6 @@ archguard analyze [options]
 - `--atlas-include-tests` - Include test packages in Atlas
 - `--atlas-protocols <protocols>` - Protocols included in flow graph
 
-**Claude CLI:**
-
-- `--cli-command <command>` - Claude CLI executable (default: `claude`)
-- `--cli-args <args>` - Additional Claude CLI arguments
-
 **Examples:**
 
 ```bash
@@ -199,6 +213,9 @@ archguard analyze --include-tests
 
 # Refresh test report only, skip re-parsing source (faster)
 archguard analyze --tests-only
+
+# Kotlin/Android project (explicit language selection is optional)
+archguard analyze -s ./app/src/main/java --lang kotlin
 ```
 
 ### `query`
@@ -277,7 +294,17 @@ Test analysis (requires `archguard_analyze(includeTests: true)` first):
 | `archguard_detect_test_patterns` | Detect test frameworks and return suggested pattern config — call this first |
 | `archguard_get_test_metrics` | Summary: file counts, entity coverage ratio, assertion density, issue counts |
 | `archguard_get_test_issues` | Per-file issues: `zero_assertion`, `orphan_test`, `assertion_poverty`, `skip_accumulation` |
-| `archguard_get_test_coverage` | Per-entity coverage map with confidence scores |
+| `archguard_get_entity_coverage` | Per-entity coverage map with confidence scores |
+
+Git history analysis:
+
+| Tool | Purpose |
+|------|---------|
+| `archguard_analyze_git` | Index git history for change-based queries |
+| `archguard_get_change_context` | Commits and changed files for an entity |
+| `archguard_get_cochange` | Files that frequently change together |
+| `archguard_get_change_risk` | Change risk score based on churn and coupling |
+| `archguard_get_ownership` | Author ownership breakdown per file or entity |
 
 See [MCP Usage Guide](docs/user-guide/mcp-usage.md) for setup, tool reference, and usage patterns.
 
@@ -301,12 +328,14 @@ 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                 |
+| 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                 |
+| C++            | Beta   | tree-sitter               | Structs, classes, inheritance, CMake deps           |
+| Kotlin/Android | Beta   | tree-sitter               | Classes, interfaces, top-level functions, `build.gradle.kts` deps, `settings.gradle.kts` multi-module planning, static test analysis |
 
 ### Go Architecture Atlas
 
@@ -410,8 +439,34 @@ archguard analyze --diagrams class method
 | `cache.enabled` | boolean | `true` | Enable file-based caching |
 | `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) |
+| `projectSemantics` | object | — | Skill-authored project knowledge consumed during analysis |
+
+## Skill-Authored Project Semantics
+
+ArchGuard does not discover project semantics at runtime. Skills or users write project knowledge, and ArchGuard loads, validates, merges, and consumes it during analysis.
+
+Authoritative locations and priority:
+
+1. `archguard.config.json.projectSemantics`
+2. `.archguard/project-semantics.json`
+3. built-in defaults
+
+The sidecar file uses the same shape as `archguard.config.json.projectSemantics`.
+
+```json
+{
+  "additionalTestPatterns": ["tests/**/*.ts"],
+  "customAssertionPatterns": ["expect[A-Z]\\w+"],
+  "architecturalLayers": {
+    "src/analysis": "analysis",
+    "src/cli": "cli",
+    "src/rendering": "rendering"
+  },
+  "suggestedDepth": 2
+}
+```
+
+If either the config `projectSemantics` block or `.archguard/project-semantics.json` is malformed, ArchGuard fails fast during configuration load or analysis startup instead of silently ignoring the knowledge.
 
 ## Output Formats
 
@@ -515,7 +570,9 @@ archguard/
 │   │   ├── golang/          # Stable (tree-sitter + gopls + Atlas)
 │   │   │   └── atlas/       # package, capability, goroutine, flow builders
 │   │   ├── java/            # Beta
-│   │   └── python/          # Beta
+│   │   ├── python/          # Beta
+│   │   ├── cpp/             # Beta (tree-sitter + CMake)
+│   │   └── kotlin/          # Beta (tree-sitter + build.gradle.kts)
 │   └── types/               # Core types (config, ArchJSON, extensions)
 ├── tests/
 │   ├── unit/                # Unit tests
@@ -594,11 +651,11 @@ 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
+# Package-level overview only
+node dist/cli/index.js analyze --diagrams package
 
 # Method-level detail for a module
-node dist/cli/index.js analyze -s ./src/cli -l method -n cli-module
+node dist/cli/index.js analyze -s ./src/cli --diagrams method
 ```
 
 ## Technology Stack

package/dist/analysis/atlas-metrics-analysis.d.ts

@@ -0,0 +1,11 @@
+import type { PackageGraph, PackageNode } from '../types/extensions/go-atlas.js';
+export interface EnrichedPackageNode extends PackageNode {
+    fanIn: number;
+    fanOut: number;
+}
+export declare function computePackageFanMetrics(graph: PackageGraph): {
+    fanIn: Map<string, number>;
+    fanOut: Map<string, number>;
+};
+export declare function enrichPackageNodes(nodes: PackageNode[], fanIn: Map<string, number>, fanOut: Map<string, number>): EnrichedPackageNode[];
+//# sourceMappingURL=atlas-metrics-analysis.d.ts.map

package/dist/analysis/atlas-metrics-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas-metrics-analysis.d.ts","sourceRoot":"","sources":["../../src/analysis/atlas-metrics-analysis.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAEhF,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,GAAG;IAC7D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,CAUA;AAMD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,mBAAmB,EAAE,CAMvB"}

package/dist/analysis/atlas-metrics-analysis.js

@@ -0,0 +1,17 @@
+export function computePackageFanMetrics(graph) {
+    const fanIn = new Map();
+    const fanOut = new Map();
+    for (const edge of graph.edges) {
+        fanIn.set(edge.target, (fanIn.get(edge.target) ?? 0) + 1);
+        fanOut.set(edge.source, (fanOut.get(edge.source) ?? 0) + 1);
+    }
+    return { fanIn, fanOut };
+}
+export function enrichPackageNodes(nodes, fanIn, fanOut) {
+    return nodes.map((node) => ({
+        ...node,
+        fanIn: fanIn.get(node.id) ?? 0,
+        fanOut: fanOut.get(node.id) ?? 0,
+    }));
+}
+//# sourceMappingURL=atlas-metrics-analysis.js.map

package/dist/analysis/atlas-metrics-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas-metrics-analysis.js","sourceRoot":"","sources":["../../src/analysis/atlas-metrics-analysis.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,wBAAwB,CAAC,KAAmB;IAI1D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAMD,MAAM,UAAU,kBAAkB,CAChC,KAAoB,EACpB,KAA0B,EAC1B,MAA2B;IAE3B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,GAAG,IAAI;QACP,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;KACjC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/analysis/fitness/dependency-checker.d.ts

@@ -0,0 +1,4 @@
+import type { DependencyConstraintRule, RuleResult } from './rule-types.js';
+import type { Relation } from '../../types/index.js';
+export declare function checkDependencyConstraint(rule: DependencyConstraintRule, relations: Relation[]): RuleResult;
+//# sourceMappingURL=dependency-checker.d.ts.map

package/dist/analysis/fitness/dependency-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-checker.d.ts","sourceRoot":"","sources":["../../../src/analysis/fitness/dependency-checker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,wBAAwB,EAC9B,SAAS,EAAE,QAAQ,EAAE,GACpB,UAAU,CAaZ"}

package/dist/analysis/fitness/dependency-checker.js

@@ -0,0 +1,16 @@
+import micromatch from 'micromatch';
+export function checkDependencyConstraint(rule, relations) {
+    for (const relation of relations) {
+        const sourceMatches = micromatch.isMatch(relation.source, rule.from);
+        const targetMatches = micromatch.isMatch(relation.target, rule.to);
+        if (sourceMatches && targetMatches) {
+            return {
+                rule,
+                passed: false,
+                detail: `Forbidden dependency: ${relation.source} → ${relation.target}. ${rule.message}`,
+            };
+        }
+    }
+    return { rule, passed: true };
+}
+//# sourceMappingURL=dependency-checker.js.map

package/dist/analysis/fitness/dependency-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-checker.js","sourceRoot":"","sources":["../../../src/analysis/fitness/dependency-checker.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAIpC,MAAM,UAAU,yBAAyB,CACvC,IAA8B,EAC9B,SAAqB;IAErB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,IAAI,aAAa,IAAI,aAAa,EAAE,CAAC;YACnC,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,yBAAyB,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE;aACzF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/analysis/fitness/rule-evaluator.d.ts

@@ -0,0 +1,6 @@
+import type { MetricThresholdRule, FitnessRule, RuleResult } from './rule-types.js';
+import type { MetricVector } from '../../types/metric-vector.js';
+import type { Relation } from '../../types/index.js';
+export declare function evaluateMetricRule(rule: MetricThresholdRule, vector: MetricVector): RuleResult;
+export declare function evaluateAllRules(rules: FitnessRule[], vector: MetricVector, relations: Relation[]): RuleResult[];
+//# sourceMappingURL=rule-evaluator.d.ts.map

package/dist/analysis/fitness/rule-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-evaluator.d.ts","sourceRoot":"","sources":["../../../src/analysis/fitness/rule-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAmCjD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,CAsB9F;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,QAAQ,EAAE,GACpB,UAAU,EAAE,CAUd"}

package/dist/analysis/fitness/rule-evaluator.js

@@ -0,0 +1,64 @@
+import { evaluateGimLossRule } from '../gim/gim-loss-evaluator.js';
+import { checkDependencyConstraint } from './dependency-checker.js';
+const KNOWN_METRIC_KEYS = new Set([
+    'schemaVersion',
+    'totalEntities',
+    'totalRelations',
+    'inferredRelationRatio',
+    'sccCount',
+    'maxInDegree',
+    'maxOutDegree',
+    'maxPackageSize',
+    'giniInDegree',
+    'giniPackageSize',
+    'packageCount',
+    'entityCoverageRatio',
+]);
+function compare(actual, op, threshold) {
+    switch (op) {
+        case '<':
+            return actual < threshold;
+        case '<=':
+            return actual <= threshold;
+        case '>':
+            return actual > threshold;
+        case '>=':
+            return actual >= threshold;
+        case '==':
+            return actual === threshold;
+        case '!=':
+            return actual !== threshold;
+    }
+}
+export function evaluateMetricRule(rule, vector) {
+    if (!KNOWN_METRIC_KEYS.has(rule.metric)) {
+        return {
+            rule,
+            passed: false,
+            detail: `Unknown metric: '${rule.metric}'`,
+        };
+    }
+    const raw = vector[rule.metric];
+    if (raw === null || raw === undefined) {
+        return {
+            rule,
+            passed: false,
+            detail: `Metric '${rule.metric}' is not available (did you run with --include-tests?)`,
+        };
+    }
+    const actual = raw;
+    const passed = compare(actual, rule.op, rule.value);
+    return { rule, passed, actual };
+}
+export function evaluateAllRules(rules, vector, relations) {
+    return rules.map((rule) => {
+        if (rule.type === 'no-dependency') {
+            return checkDependencyConstraint(rule, relations);
+        }
+        if (rule.type === 'gim-loss') {
+            return evaluateGimLossRule(rule, vector);
+        }
+        return evaluateMetricRule(rule, vector);
+    });
+}
+//# sourceMappingURL=rule-evaluator.js.map

package/dist/analysis/fitness/rule-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-evaluator.js","sourceRoot":"","sources":["../../../src/analysis/fitness/rule-evaluator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAG3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS;IACxC,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,uBAAuB;IACvB,UAAU;IACV,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,iBAAiB;IACjB,cAAc;IACd,qBAAqB;CACtB,CAAC,CAAC;AAEH,SAAS,OAAO,CAAC,MAAc,EAAE,EAA6B,EAAE,SAAiB;IAC/E,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,GAAG;YACN,OAAO,MAAM,GAAG,SAAS,CAAC;QAC5B,KAAK,IAAI;YACP,OAAO,MAAM,IAAI,SAAS,CAAC;QAC7B,KAAK,GAAG;YACN,OAAO,MAAM,GAAG,SAAS,CAAC;QAC5B,KAAK,IAAI;YACP,OAAO,MAAM,IAAI,SAAS,CAAC;QAC7B,KAAK,IAAI;YACP,OAAO,MAAM,KAAK,SAAS,CAAC;QAC9B,KAAK,IAAI;YACP,OAAO,MAAM,KAAK,SAAS,CAAC;IAChC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAyB,EAAE,MAAoB;IAChF,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,oBAAoB,IAAI,CAAC,MAAM,GAAG;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAI,MAA6C,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAExE,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,WAAW,IAAI,CAAC,MAAM,wDAAwD;SACvF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,GAAa,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAoB,EACpB,MAAoB,EACpB,SAAqB;IAErB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YAClC,OAAO,yBAAyB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/analysis/fitness/rule-types.d.ts

@@ -0,0 +1,34 @@
+export type ComparisonOp = '<' | '<=' | '>' | '>=' | '==' | '!=';
+export interface MetricThresholdRule {
+    type?: 'metric';
+    metric: string;
+    op: ComparisonOp;
+    value: number;
+    message: string;
+}
+export interface DependencyConstraintRule {
+    type: 'no-dependency';
+    from: string;
+    to: string;
+    message: string;
+}
+export type GimLossType = 'feasibility' | 'consistency' | 'description-length' | 'generation-alignment';
+export interface GimLossRule {
+    type: 'gim-loss';
+    loss: GimLossType;
+    op: ComparisonOp;
+    value: number;
+    message: string;
+}
+export type FitnessRule = MetricThresholdRule | DependencyConstraintRule | GimLossRule;
+export interface FitnessConfig {
+    rules: FitnessRule[];
+    failOnViolation: boolean;
+}
+export interface RuleResult {
+    rule: FitnessRule;
+    passed: boolean;
+    actual?: number | string;
+    detail?: string;
+}
+//# sourceMappingURL=rule-types.d.ts.map

package/dist/analysis/fitness/rule-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-types.d.ts","sourceRoot":"","sources":["../../../src/analysis/fitness/rule-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEjE,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,aAAa,GAAG,oBAAoB,GAAG,sBAAsB,CAAC;AAExG,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,YAAY,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,mBAAmB,GAAG,wBAAwB,GAAG,WAAW,CAAC;AAEvF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/analysis/fitness/rule-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rule-types.js.map

package/dist/analysis/fitness/rule-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-types.js","sourceRoot":"","sources":["../../../src/analysis/fitness/rule-types.ts"],"names":[],"mappings":""}

package/dist/analysis/gim/direction-hint.d.ts

@@ -0,0 +1,18 @@
+import type { MetricSnapshot } from '../snapshot-store.js';
+export type DirectionType = 'expansion' | 'contraction' | 'stable' | 'insufficient_data';
+export type ConfidenceLevel = 'low' | 'medium';
+export interface DirectionSignal {
+    metric: string;
+    direction: 'expansion' | 'contraction' | 'neutral';
+    delta: number | null;
+    percentChange: number | null;
+}
+export interface DirectionHint {
+    direction: DirectionType;
+    confidence: ConfidenceLevel | null;
+    signals: DirectionSignal[];
+    caveat: string;
+    recommendation: string;
+}
+export declare function computeDirectionHint(snapshots: MetricSnapshot[]): DirectionHint;
+//# sourceMappingURL=direction-hint.d.ts.map

package/dist/analysis/gim/direction-hint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction-hint.d.ts","sourceRoot":"","sources":["../../../src/analysis/gim/direction-hint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AACzF,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;IACnD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAgCD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,aAAa,CAqD/E"}

package/dist/analysis/gim/direction-hint.js

@@ -0,0 +1,76 @@
+import { diffSnapshots } from '../snapshot-diff.js';
+const EXPANSION_ON_INCREASE = new Set(['totalEntities', 'totalRelations', 'packageCount', 'sccCount', 'giniInDegree']);
+const THRESHOLD_PCT = 5;
+function signalDirection(metric, percentChange, delta) {
+    if (delta === null)
+        return 'neutral';
+    if (metric === 'sccCount') {
+        if (delta > 0)
+            return 'expansion';
+        if (delta < 0)
+            return 'contraction';
+        return 'neutral';
+    }
+    if (percentChange === null || Math.abs(percentChange) < THRESHOLD_PCT)
+        return 'neutral';
+    const increasing = delta > 0;
+    const expansionOnIncrease = EXPANSION_ON_INCREASE.has(metric);
+    if (increasing)
+        return expansionOnIncrease ? 'expansion' : 'contraction';
+    return expansionOnIncrease ? 'contraction' : 'expansion';
+}
+const RECOMMENDATION = {
+    expansion: 'System is in expansion phase. Consider scheduling contraction/refactor work to prevent structural debt from accumulating.',
+    contraction: 'System is in contraction phase. Good time to stabilize interfaces and consolidate responsibilities.',
+    stable: 'System is stable. Monitor key metrics (sccCount, giniInDegree) to catch early phase transitions.',
+    insufficient_data: 'Not enough snapshots to determine direction. Run archguard analyze to generate a second snapshot.',
+};
+export function computeDirectionHint(snapshots) {
+    const CAVEAT = 'Based on 2-point comparison only. Direction may flip between consecutive snapshots. Treat as a weak signal, not a definitive trend.';
+    if (snapshots.length < 2) {
+        return {
+            direction: 'insufficient_data',
+            confidence: null,
+            signals: [],
+            caveat: CAVEAT,
+            recommendation: RECOMMENDATION.insufficient_data,
+        };
+    }
+    const newer = snapshots[0];
+    const older = snapshots[1];
+    const diff = diffSnapshots(older, newer);
+    const trackedMetrics = ['totalEntities', 'totalRelations', 'packageCount', 'sccCount', 'giniInDegree'];
+    const signals = trackedMetrics.map((metric) => {
+        const entry = diff.entries.find((e) => e.metric === metric);
+        const dir = entry
+            ? signalDirection(metric, entry.percentChange, entry.delta)
+            : 'neutral';
+        return {
+            metric,
+            direction: dir,
+            delta: entry?.delta ?? null,
+            percentChange: entry?.percentChange ?? null,
+        };
+    });
+    const expansionCount = signals.filter((s) => s.direction === 'expansion').length;
+    const contractionCount = signals.filter((s) => s.direction === 'contraction').length;
+    let direction;
+    if (expansionCount > contractionCount && expansionCount > signals.length / 2) {
+        direction = 'expansion';
+    }
+    else if (contractionCount > expansionCount && contractionCount > signals.length / 2) {
+        direction = 'contraction';
+    }
+    else {
+        direction = 'stable';
+    }
+    const confidence = snapshots.length >= 3 ? 'medium' : 'low';
+    return {
+        direction,
+        confidence,
+        signals,
+        caveat: CAVEAT,
+        recommendation: RECOMMENDATION[direction],
+    };
+}
+//# sourceMappingURL=direction-hint.js.map

package/dist/analysis/gim/direction-hint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction-hint.js","sourceRoot":"","sources":["../../../src/analysis/gim/direction-hint.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAqB5D,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;AAEvH,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,SAAS,eAAe,CAAC,MAAc,EAAE,aAA4B,EAAE,KAAoB;IACzF,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAGrC,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,WAAW,CAAC;QAClC,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,aAAa,CAAC;QACpC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,aAAa,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,aAAa;QAAE,OAAO,SAAS,CAAC;IAExF,MAAM,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC;IAC7B,MAAM,mBAAmB,GAAG,qBAAqB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9D,IAAI,UAAU;QAAE,OAAO,mBAAmB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;IACzE,OAAO,mBAAmB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC;AAC3D,CAAC;AAED,MAAM,cAAc,GAAkC;IACpD,SAAS,EAAE,2HAA2H;IACtI,WAAW,EAAE,qGAAqG;IAClH,MAAM,EAAE,kGAAkG;IAC1G,iBAAiB,EAAE,mGAAmG;CACvH,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,SAA2B;IAC9D,MAAM,MAAM,GAAG,qIAAqI,CAAC;IAErJ,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,SAAS,EAAE,mBAAmB;YAC9B,UAAU,EAAE,IAAI;YAChB,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,MAAM;YACd,cAAc,EAAE,cAAc,CAAC,iBAAiB;SACjD,CAAC;IACJ,CAAC;IAGD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEzC,MAAM,cAAc,GAAG,CAAC,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IACvG,MAAM,OAAO,GAAsB,cAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAC5D,MAAM,GAAG,GAAG,KAAK;YACf,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC;YAC3D,CAAC,CAAC,SAAS,CAAC;QACd,OAAO;YACL,MAAM;YACN,SAAS,EAAE,GAAG;YACd,KAAK,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI;YAC3B,aAAa,EAAE,KAAK,EAAE,aAAa,IAAI,IAAI;SAC5C,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;IACjF,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,aAAa,CAAC,CAAC,MAAM,CAAC;IAErF,IAAI,SAAwB,CAAC;IAC7B,IAAI,cAAc,GAAG,gBAAgB,IAAI,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7E,SAAS,GAAG,WAAW,CAAC;IAC1B,CAAC;SAAM,IAAI,gBAAgB,GAAG,cAAc,IAAI,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtF,SAAS,GAAG,aAAa,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,QAAQ,CAAC;IACvB,CAAC;IAED,MAAM,UAAU,GAAoB,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;IAE7E,OAAO;QACL,SAAS;QACT,UAAU;QACV,OAAO;QACP,MAAM,EAAE,MAAM;QACd,cAAc,EAAE,cAAc,CAAC,SAAS,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/analysis/gim/gim-loss-evaluator.d.ts

@@ -0,0 +1,14 @@
+import type { GimLossRule } from '../fitness/rule-types.js';
+import type { RuleResult } from '../fitness/rule-types.js';
+import type { MetricVector } from '../../types/metric-vector.js';
+export interface LossStatus {
+    value: number;
+    status: 'healthy' | 'warning' | 'info';
+    detail: string;
+    proxy: true;
+}
+type LossName = GimLossRule['loss'];
+export declare function evaluateGimLossRule(rule: GimLossRule, vector: MetricVector): RuleResult;
+export declare function computeAllLosses(vector: MetricVector): Record<LossName, LossStatus>;
+export {};
+//# sourceMappingURL=gim-loss-evaluator.d.ts.map

package/dist/analysis/gim/gim-loss-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gim-loss-evaluator.d.ts","sourceRoot":"","sources":["../../../src/analysis/gim/gim-loss-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,CAAC;CACb;AAED,KAAK,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAmCpC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,CAiBvF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAgCnF"}

package/dist/analysis/gim/gim-loss-evaluator.js

@@ -0,0 +1,80 @@
+function resolveProxy(loss, vector) {
+    switch (loss) {
+        case 'feasibility':
+            return vector.sccCount;
+        case 'consistency':
+            return vector.inferredRelationRatio;
+        case 'description-length':
+            return vector.totalEntities + vector.totalRelations;
+        case 'generation-alignment':
+            return vector.giniInDegree;
+        default:
+            return null;
+    }
+}
+function compare(actual, op, threshold) {
+    switch (op) {
+        case '<': return actual < threshold;
+        case '<=': return actual <= threshold;
+        case '>': return actual > threshold;
+        case '>=': return actual >= threshold;
+        case '==': return actual === threshold;
+        case '!=': return actual !== threshold;
+    }
+}
+const PROXY_LABELS = {
+    feasibility: 'sccCount (proxy for ℒ_F)',
+    consistency: 'inferredRelationRatio (proxy for ℒ_C)',
+    'description-length': 'totalEntities + totalRelations (proxy for ℒ_D)',
+    'generation-alignment': 'giniInDegree (proxy for ℒ_A)',
+};
+export function evaluateGimLossRule(rule, vector) {
+    const proxyValue = resolveProxy(rule.loss, vector);
+    if (proxyValue === null) {
+        return {
+            rule,
+            passed: false,
+            detail: `Unknown GIM loss type: '${rule.loss}'`,
+        };
+    }
+    const passed = compare(proxyValue, rule.op, rule.value);
+    return {
+        rule,
+        passed,
+        actual: proxyValue,
+        detail: `${PROXY_LABELS[rule.loss]} = ${proxyValue}`,
+    };
+}
+export function computeAllLosses(vector) {
+    const feasibilityVal = vector.sccCount;
+    const consistencyVal = vector.inferredRelationRatio;
+    const descLengthVal = vector.totalEntities + vector.totalRelations;
+    const alignmentVal = vector.giniInDegree;
+    return {
+        feasibility: {
+            value: feasibilityVal,
+            status: feasibilityVal === 0 ? 'healthy' : 'warning',
+            detail: `sccCount=${feasibilityVal}. Proxy for structural feasibility loss ℒ_F. Zero cycles = minimum feasibility loss.`,
+            proxy: true,
+        },
+        consistency: {
+            value: consistencyVal,
+            status: consistencyVal <= 0.3 ? 'healthy' : 'warning',
+            detail: `inferredRelationRatio=${consistencyVal.toFixed(3)}. Proxy for consistency loss ℒ_C. High ratio = many unresolved type dependencies.`,
+            proxy: true,
+        },
+        'description-length': {
+            value: descLengthVal,
+            status: 'info',
+            detail: `totalEntities(${vector.totalEntities}) + totalRelations(${vector.totalRelations}) = ${descLengthVal}. Proxy for description-length loss ℒ_D. Smaller = easier to describe.`,
+            proxy: true,
+        },
+        'generation-alignment': {
+            value: alignmentVal,
+            status: alignmentVal <= 0.5 ? 'healthy' : 'warning',
+            detail: `giniInDegree=${alignmentVal.toFixed(3)}. Proxy for generation-alignment loss ℒ_A. High gini = few nodes dominate dependency graph.`,
+            proxy: true,
+        },
+    };
+}
+//# sourceMappingURL=gim-loss-evaluator.js.map

package/dist/analysis/gim/gim-loss-evaluator.js.map

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

package/dist/analysis/gini.d.ts

@@ -0,0 +1,2 @@
+export declare function giniCoefficient(values: number[]): number;
+//# sourceMappingURL=gini.d.ts.map

package/dist/analysis/gini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gini.d.ts","sourceRoot":"","sources":["../../src/analysis/gini.ts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAaxD"}

package/dist/analysis/gini.js

@@ -0,0 +1,12 @@
+export function giniCoefficient(values) {
+    const n = values.length;
+    if (n === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const sum = sorted.reduce((acc, v) => acc + v, 0);
+    if (sum === 0)
+        return 0;
+    const weightedSum = sorted.reduce((acc, v, idx) => acc + (idx + 1) * v, 0);
+    return (2 * weightedSum) / (n * sum) - (n + 1) / n;
+}
+//# sourceMappingURL=gini.js.map

package/dist/analysis/gini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gini.js","sourceRoot":"","sources":["../../src/analysis/gini.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,eAAe,CAAC,MAAgB;IAC9C,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEtB,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAElD,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAGxB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3E,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC"}