archtracker-mcp 0.4.2 → 0.5.0

package/dist/index.d.ts

@@ -2,7 +2,7 @@
  * ArchTracker core schema definitions.
  * Snapshot format is versioned for backward compatibility.
  */
-declare const SCHEMA_VERSION: "1.0";
+declare const SCHEMA_VERSION: "1.1";
 /** A single dependency edge: source imports target */
 interface DependencyEdge {
     source: string;
@@ -29,12 +29,33 @@ interface DependencyGraph {
     totalFiles: number;
     totalEdges: number;
 }
+/** Metadata about a single layer within a multi-layer graph */
+interface LayerMetadata {
+    name: string;
+    originalRootDir: string;
+    language: string;
+    color: string;
+    description?: string;
+    fileCount: number;
+    edgeCount: number;
+}
+/** A multi-layer dependency graph combining multiple single-layer analyses */
+interface MultiLayerGraph {
+    /** Individual layer graphs (un-prefixed paths, original rootDirs) */
+    layers: Record<string, DependencyGraph>;
+    /** Layer metadata for rendering */
+    layerMetadata: LayerMetadata[];
+    /** Merged graph with layer-prefixed paths ("LayerName/path.ts") */
+    merged: DependencyGraph;
+}
 /** Persisted snapshot with schema version */
 interface ArchSnapshot {
-    version: typeof SCHEMA_VERSION;
+    version: typeof SCHEMA_VERSION | "1.0";
     timestamp: string;
     rootDir: string;
     graph: DependencyGraph;
+    /** Present only when layers.json was used */
+    multiLayer?: MultiLayerGraph;
 }
 /** Diff result between two snapshots */
 interface ArchDiff {
@@ -64,6 +85,41 @@ interface ArchContext {
 declare const LANGUAGE_IDS: readonly ["javascript", "python", "rust", "go", "java", "c-cpp", "c-sharp", "ruby", "php", "swift", "kotlin", "dart", "scala"];
 type LanguageId = (typeof LANGUAGE_IDS)[number];
 
+/** Definition of a single architecture layer */
+interface LayerDefinition {
+    /** Unique layer name (used as path prefix: "Backend/worker.py") */
+    name: string;
+    /** Target directory to analyze (relative to project root) */
+    targetDir: string;
+    /** Language for this layer (auto-detected if omitted) */
+    language?: LanguageId;
+    /** Exclude patterns specific to this layer */
+    exclude?: string[];
+    /** Display color (CSS color, e.g. "#58a6ff"). Auto-assigned if omitted. */
+    color?: string;
+    /** Optional description shown in the viewer */
+    description?: string;
+}
+/**
+ * Layer configuration schema (.archtracker/layers.json).
+ * The `connections` field is reserved for future cross-layer edge support.
+ */
+interface LayerConfig {
+    version: "1.0";
+    layers: LayerDefinition[];
+    /** Reserved for future cross-layer connection definitions */
+    connections?: CrossLayerConnection[];
+}
+/** Cross-layer edge definition */
+interface CrossLayerConnection {
+    fromLayer: string;
+    fromFile: string;
+    toLayer: string;
+    toFile: string;
+    type: "api-call" | "event" | "data-flow" | "manual" | "auto";
+    label?: string;
+}
+
 /** Options for the dependency analyzer */
 interface AnalyzeOptions {
     /** Regex patterns to exclude from analysis (e.g. ["node_modules", "\\.test\\.ts$"]) */
@@ -94,13 +150,37 @@ declare function formatAnalysisReport(graph: DependencyGraph, options?: {
     topN?: number;
 }): string;
 
+/**
+ * Analyze multiple layers and produce a MultiLayerGraph.
+ *
+ * Each layer is analyzed independently via analyzeProject().
+ * Results are merged into a unified graph with layer-prefixed node paths.
+ */
+declare function analyzeMultiLayer(projectRoot: string, layerDefs: LayerDefinition[]): Promise<MultiLayerGraph>;
+/**
+ * Auto-detect cross-layer connections by scanning file contents
+ * for references to identifiers defined in other layers.
+ *
+ * Strategies:
+ * 1. Unique type-name matching — PascalCase/snake_case names unique to exactly
+ *    one target layer, with context validation (not self-definitions, not
+ *    local imports, not ambiguous across layers).
+ * 2. Typed reference patterns — "StorageClient", "AuthService", etc.
+ * 3. Cross-layer import/URL patterns — import paths or URL patterns referencing
+ *    another layer's directory, with strict context for short names.
+ *
+ * Results are deduplicated to max 1 connection per (sourceLayer → targetLayer) pair,
+ * keeping the highest-scoring match. A minimum score threshold is enforced.
+ */
+declare function detectCrossLayerConnections(layers: Record<string, DependencyGraph>, layerDefs: LayerDefinition[]): CrossLayerConnection[];
+
 /**
  * Save a dependency graph as a versioned snapshot.
  *
  * Creates .archtracker/ directory if it doesn't exist.
  * Writes snapshot.json with schema version and timestamp.
  */
-declare function saveSnapshot(projectRoot: string, graph: DependencyGraph): Promise<ArchSnapshot>;
+declare function saveSnapshot(projectRoot: string, graph: DependencyGraph, multiLayer?: MultiLayerGraph): Promise<ArchSnapshot>;
 /**
  * Load the most recent snapshot from .archtracker/snapshot.json.
  *
@@ -128,6 +208,16 @@ declare function computeDiff(oldGraph: DependencyGraph, newGraph: DependencyGrap
 /** Generate a human-readable report from an ArchDiff */
 declare function formatDiffReport(diff: ArchDiff): string;
 
+/**
+ * Load layers.json from .archtracker/ if it exists.
+ * Returns null if no config file found.
+ */
+declare function loadLayerConfig(projectRoot: string): Promise<LayerConfig | null>;
+/**
+ * Save a LayerConfig to .archtracker/layers.json.
+ */
+declare function saveLayerConfig(projectRoot: string, config: LayerConfig): Promise<void>;
+
 type Locale = "en" | "ja";
 /** Get the current locale */
 declare function getLocale(): Locale;
@@ -136,4 +226,4 @@ declare function setLocale(locale: Locale): void;
 /** Get a translated message by key */
 declare function t(key: string, vars?: Record<string, string | number>): string;
 
-export { type AnalyzeOptions, AnalyzerError, type ArchContext, type ArchDiff, type ArchSnapshot, type CircularDependency, type DependencyEdge, type DependencyGraph, type FileNode, type Locale, SCHEMA_VERSION, StorageError, analyzeProject, computeDiff, formatAnalysisReport, formatDiffReport, getLocale, hasArchtrackerDir, loadSnapshot, saveSnapshot, setLocale, t };
+export { type AnalyzeOptions, AnalyzerError, type ArchContext, type ArchDiff, type ArchSnapshot, type CircularDependency, type CrossLayerConnection, type DependencyEdge, type DependencyGraph, type FileNode, type LayerConfig, type LayerDefinition, type LayerMetadata, type Locale, type MultiLayerGraph, SCHEMA_VERSION, StorageError, analyzeMultiLayer, analyzeProject, computeDiff, detectCrossLayerConnections, formatAnalysisReport, formatDiffReport, getLocale, hasArchtrackerDir, loadLayerConfig, loadSnapshot, saveLayerConfig, saveSnapshot, setLocale, t };