0.6.1 • Published 6d agoCLI

local-architecturer

Licence

MIT

Version

0.6.1

Deps

Size

1014 kB

Vulns

Weekly

692

Summary Dependency Versions

Local Architecture Analyzer

Geliştiricilerin terminal üzerinden kendi projelerinin kök dizininde çalıştırabileceği; pnpm monorepo yapılarını, Docker konfigürasyonlarını ve Kubernetes manifestlerini otomatik analiz eden bir Node.js CLI aracı ve MCP (Model Context Protocol) sunucusu.

Özellikler

Monorepo Analizi: pnpm workspace yapısını otomatik tespit eder
Docker Analizi: docker-compose.yml dosyalarını parse eder
Kubernetes Analizi: Deployment, Service, Ingress, ConfigMap, Secret manifestlerini parse eder
Bağımlılık Grafiği: Paketler ve servisler arasındaki bağımlılıkları görselleştirir
MCP Sunucusu: AI asistanları için 40 tool sunar
Web Dashboard: React Flow ile interaktif grafik görünümü
Cache Mekanizması: TTL tabanlı scan cache ile performans optimizasyonu
Structured Logging: JSON formatında loglama desteği
Port Çakışma Tespiti: Docker servislerindeki port çakışmalarını tespit eder
CI/CD Pipeline Analizi: GitHub Actions, GitLab CI, Jenkins, CircleCI yapılandırmalarını parse eder
Git Geçmiş Zaman Yolculuğu: Mimari evrimi commit geçmişinden analiz eder
AI Mimari İnceleme: LLM ile otomatik mimari inceleme ve öneriler
Veritabanı Şema Analizi: Prisma, TypeORM, Drizzle, Sequelize, SQLAlchemy desteği
Proxy Yapılandırması: Traefik, Nginx, Caddy reverse proxy analizi
Gateway Tespiti: API gateway ve reverse proxy tespiti
Güvenlik Denetimi: Docker güvenlik denetimi ve volume analizi
Ortam Değişkeni Kapsamı: .env dosyaları ile kaynak kod arasındaki env değişken eşleşmesi
AI Model Profilleme: AI model VRAM gereksinimleri hesaplama
Donanım Tespiti: Serial, USB, GPIO cihaz tespiti

Kurulum

# npm ile
npm install -g local-architecturer

# veya doğrudan
npx local-architecturer analyze -p /path/to/project

Kullanım

Proje Analizi

# JSON çıktısı
arch-viz analyze -p /path/to/project -f json

# Metin çıktısı
arch-viz analyze -p /path/to/project -f text

Web Dashboard

# Sunucuyu başlat ve browser'ı aç
arch-viz serve -p /path/to/project

# Özel port ile
arch-viz serve -p . -port 3000

MCP Sunucusu (AI Asistanları İçin)

# MCP sunucusunu başlat
arch-viz mcp -p /path/to/project

# HTTP transport ile
arch-viz mcp -p . -t http -port 3001

AI Mimari İnceleme

# Ollama ile
arch-viz review -p /path/to/project --provider ollama --model qwen2.5

# OpenRouter ile
arch-viz review -p /path/to/project --provider openrouter --model meta-llama/llama-3-8b --api-key YOUR_KEY

Git Geçmiş Zaman Yolculuğu

# Son 50 commit'i analiz et
arch-viz time-travel -p /path/to/project -c 50

API Endpoint'leri

Endpoint	Yöntem	Açıklama
`/api/health`	GET	Sağlık kontrolü
`/api/graph`	GET	Bağımlılık grafiği
`/api/packages`	GET	Workspace paketleri
`/api/docker`	GET	Docker servisleri
`/api/analyze`	GET	Tam proje analizi
`/api/circular`	GET	Döngüsel bağımlılık tespiti
`/api/docker-audit`	GET	Docker güvenlik denetimi
`/api/env-coverage`	GET	Env değişken eşleşmesi
`/api/ai-profile`	GET	AI model profili
`/api/history`	GET	Git geçmişi
`/api/history/:commit`	GET	Tek commit anlık görüntüsü
`/api/pipelines`	GET	CI/CD pipeline'ları
`/api/database`	GET	Veritabanı şemaları
`/api/proxy`	GET	Reverse proxy yapılandırmaları
`/api/dataflow`	GET	Data flow pipeline'ları
`/api/security-boundaries`	GET	Güvenlik sınırları
`/api/kubernetes`	GET	Kubernetes manifest analizi
`POST /api/cache/invalidate`	POST	Cache temizleme

MCP Araçları (40 Tool)

Çekirdek Analiz

Araç	Açıklama
`analyze_project`	Tam proje analizi
`get_packages`	Workspace paketlerini getir
`get_monorepo_graph`	Monorepo grafiği (JSON + Mermaid)
`get_dependency_graph`	Bağımlılık grafiği (filtrelenmiş)
`get_node_details`	Belirli bir node'un detayları
`get_health_score`	Proje sağlık skoru
`search_packages`	Paket ara
`detect_circular_dependencies`	Döngüsel bağımlılık tespiti

Docker

Araç	Açıklama
`get_docker_services`	Docker servisleri (port conflict analizi)
`analyze_dockerfile`	Dockerfile analizi
`audit_docker_security`	Docker güvenlik denetimi
`parse_docker_compose_file`	Tek Docker Compose dosyası analizi
`detect_port_conflicts`	Port çakışması tespiti

Kubernetes

Araç	Açıklama
`analyze_kubernetes`	Kubernetes manifest analizi (Deployment, Service, Ingress, ConfigMap, Secret)

Veritabanı ve Proxy

Araç	Açıklama
`get_database_schemas`	Veritabanı şemaları (Prisma/TypeORM/Drizzle/Sequelize/SQLAlchemy)
`get_proxy_configurations`	Reverse proxy yapılandırmaları
`parse_nginx_config`	Nginx konfigürasyon parse
`detect_gateways`	API gateway tespiti
`get_routes_edges`	Proxy routing bağımlılık kenarları

CI/CD ve Git

Araç	Açıklama
`get_ci_cd_pipelines`	CI/CD pipeline'ları
`get_build_edges`	CI build bağımlılık kenarları
`time_travel`	Git geçmişi ile mimari evrim

Ortam ve Güvenlik

Araç	Açıklama
`get_env_coverage`	Env değişken eşleşmesi
`analyze_env_file`	Tek .env dosyası analizi
`get_security_boundaries`	Güvenlik sınırları

AI ve Donanım

Araç	Açıklama
`review_architecture`	AI destekli mimari inceleme
`get_ai_profile`	AI model profili
`lookup_ai_model`	AI model VRAM gereksinimleri
`get_hardware_devices`	Donanım cihaz tespiti

Veri Akışı ve Görselleştirme

Araç	Açıklama
`get_data_flows`	Data flow pipeline'ları
`analyze_dataflow_bottlenecks`	DataFlow darboğaz analizi
`get_mermaid_diagram`	Mermaid diyagram üretimi

Dil Desteği

Araç	Açıklama
`parse_python_dependencies`	Python bağımlılık parse
`parse_composer_packages`	PHP/Composer bağımlılık parse
`parse_workspace_config`	Monorepo workspace tespiti
`parse_sequelize_models`	Sequelize ORM model parse
`parse_sqlalchemy_models`	SQLAlchemy ORM model parse

Örnek Çıktı

{
  "nodes": [
    { "id": "@app/core", "type": "package", "name": "@app/core" },
    { "id": "@app/ui", "type": "package", "name": "@app/ui" },
    { "id": "web", "type": "service", "name": "web" }
  ],
  "edges": [
    { "source": "@app/ui", "target": "@app/core", "type": "depends" },
    { "source": "web", "target": "api", "type": "network" }
  ]
}

Geliştirme

# Bağımlılıkları kur
npm install
cd frontend && npm install

# Geliştirme modunda çalıştır
npm run dev

# Testleri çalıştır (132 test)
npm test

# Build al
npm run build
cd frontend && npm run build

Proje Yapısı

local-architecturer/
├── src/
│   ├── cli.ts                    # Ana CLI giriş noktası (5 komut)
│   ├── commands/                 # CLI komutları (analyze, serve, mcp, review, time-travel)
│   ├── core/                     # Çekirdek modüller
│   │   ├── scanner.ts            # Merkez orkestratör (cache mekanizmalı)
│   │   ├── path-resolver.ts      # Dosya sistemi soyutlama
│   │   ├── docker-scanner.ts     # Docker konfigürasyon tespiti
│   │   ├── circular-detector.ts  # Döngüsel bağımlılık tespiti
│   │   ├── docker-auditor.ts     # Docker güvenlik denetimi
│   │   ├── env-analyzer.ts       # Env değişken analizi
│   │   ├── git-history-scanner.ts # Git geçmişi tarama
│   │   ├── gateway-detector.ts   # API gateway tespiti
│   │   ├── dataflow-analyzer.ts  # DataFlow darboğaz analizi
│   │   ├── build-edge-generator.ts # CI build kenar üretimi
│   │   └── routes-edge-generator.ts # Proxy routes kenar üretimi
│   ├── parsers/                  # 28 config parser
│   │   ├── workspace-parser.ts   # pnpm-workspace.yaml
│   │   ├── package-parser.ts     # package.json
│   │   ├── docker-compose-parser.ts
│   │   ├── dockerfile-parser.ts
│   │   ├── kubernetes-parser.ts  # Kubernetes manifestleri
│   │   ├── prisma-parser.ts, typeorm-parser.ts, drizzle-parser.ts
│   │   ├── sequelize-parser.ts, sqlalchemy-parser.ts
│   │   ├── nginx-parser.ts, traefik-parser.ts, caddy-parser.ts
│   │   ├── github-actions-parser.ts, gitlab-ci-parser.ts, jenkins-parser.ts, circleci-parser.ts
│   │   ├── composer-parser.ts, python-parser.ts
│   │   └── ... (ai-model, hardware, dataflow, proxy, db-schema, env, ci-cd, dependency)
│   ├── mcp/                      # MCP sunucu ve 40 tool
│   ├── server/                   # Express sunucu (18+ REST endpoint)
│   ├── ai/                       # LLM review engine (Ollama/OpenRouter/LMStudio)
│   ├── types/                    # TypeScript tip tanımları
│   └── utils/                    # Yardımcı modüller (structured logging destekli)
├── frontend/                     # React 18 + Vite 5 + @xyflow/react + dagre
├── tests/                        # 132 Vitest test
└── dist/                         # Build çıktıları

Testler

Proje 132 test ile kapsamlı bir test kapsamına sahiptir:

Parser Testleri: workspace, package, dependency, docker-compose, dockerfile, prisma, github-actions, hardware, traefik, nginx, db-schema, kubernetes, python, composer, env
Core Testleri: scanner, circular-detector, docker-scanner, docker-auditor, path-resolver
MCP Testleri: server, mermaid-builder, port-conflict-detector
Server Testleri: express-server

# Tüm testleri çalıştır
npm test

# İzleme modunda
npm run test:watch

Lisans

MIT

Keywords

architecture analyzer monorepo pnpm docker mcp cli visualization react-flow dependency-graph