@girardelli/architect 6.0.0 → 8.1.0

package/PROJECT_STRUCTURE.txt

@@ -1,168 +0,0 @@
-ARCHITECT - AI-Powered Architecture Analysis Plugin
-===================================================
-
-Complete GitHub Repository Structure
-
-REPOSITORY ROOT
-/sessions/stoic-keen-sagan/mnt/outputs/repos/architect/
-
-FILES CREATED:
-==============
-
-Configuration & Documentation:
-  - README.md (viral-quality, 200+ lines)
-  - LICENSE (MIT 2026, Camilo Girardelli)
-  - .gitignore (Node.js standard)
-  - CONTRIBUTING.md (contribution guidelines)
-  - .architect.json (default configuration)
-  - package.json (complete with scripts and deps)
-  - tsconfig.json (strict TypeScript)
-  - PROJECT_STRUCTURE.txt (this file)
-
-Source Code (src/ directory, 1,500+ lines):
-  - index.ts (40 lines) - Plugin entry point, command registration
-  - types.ts (80 lines) - All TypeScript interfaces
-  - config.ts (60 lines) - Configuration loader
-  - scanner.ts (150 lines) - ProjectScanner class
-  - analyzer.ts (200 lines) - ArchitectureAnalyzer class
-  - anti-patterns.ts (180 lines) - AntiPatternDetector class
-  - scorer.ts (130 lines) - ArchitectureScorer class
-  - diagram.ts (140 lines) - DiagramGenerator class
-  - reporter.ts (130 lines) - ReportGenerator class
-
-Tests (tests/ directory, 105 lines):
-  - scanner.test.ts (35 lines)
-  - anti-patterns.test.ts (40 lines)
-  - scorer.test.ts (30 lines)
-
-Examples:
-  - examples/sample-report.md (complete sample analysis output)
-
-ARCHITECTURE COMPONENTS:
-========================
-
-Scanner Agent (src/scanner.ts)
-  - Project directory traversal
-  - File type identification
-  - Line counting
-  - Framework detection (React, Angular, Spring Boot, Express, Django, etc.)
-  - File tree building with glob patterns
-
-Analyzer Agent (src/analyzer.ts)
-  - Import/dependency parsing (JS/TS/Python/Java)
-  - Dependency graph construction
-  - Layer detection (API/Service/Data/UI/Infrastructure)
-  - Module boundary identification
-
-Anti-Pattern Detector (src/anti-patterns.ts)
-  - God Class detection (500+ lines, 10+ methods)
-  - Circular Dependency detection (DFS algorithm)
-  - Leaky Abstraction detection (internal types exported)
-  - Feature Envy detection (external method usage ratio)
-  - Shotgun Surgery detection (change propagation)
-
-Scorer (src/scorer.ts)
-  - Modularity scoring (40% weight)
-  - Coupling analysis (25% weight)
-  - Cohesion evaluation (20% weight)
-  - Layering compliance (15% weight)
-  - 0-100 score calculation
-
-Diagram Generator (src/diagram.ts)
-  - Component diagram (Mermaid)
-  - Layer diagram (Mermaid)
-  - Dependency flow diagram (Mermaid)
-  - Color-coded by layer
-
-Reporter (src/reporter.ts)
-  - Markdown report generation
-  - Project summary
-  - Score sections
-  - Anti-patterns listing
-  - Layer visualization
-  - Refactoring suggestions
-  - Diagram embedding
-
-FEATURES INCLUDED:
-==================
-
-Architecture Commands:
-  - architect analyze [path] - Full analysis
-  - architect diagram [path] - Diagram only
-  - architect score [path] - Score only
-  - architect anti-patterns [path] - Anti-patterns only
-  - architect layers [path] - Layer distribution
-
-Export Formats:
-  - Mermaid diagrams
-  - JSON data
-  - Markdown reports
-
-Configuration:
-  - .architect.json with custom thresholds
-  - Ignore patterns
-  - Framework detection toggle
-  - Score weight customization
-
-Anti-Patterns Detected:
-  - God Class
-  - Circular Dependencies
-  - Leaky Abstractions
-  - Feature Envy
-  - Shotgun Surgery
-
-QUALITY METRICS:
-================
-
-Code Statistics:
-  - Total lines: 1,812 (src + tests)
-  - Source files: 9 modules
-  - Test files: 3 suites
-  - Type definitions: 15 interfaces
-  - Classes: 7
-
-Code Quality:
-  - 100% TypeScript with strict mode
-  - Comprehensive type safety
-  - Functional, well-documented code
-  - Real parsing logic (not stubs)
-  - Production-ready quality
-
-DEPENDENCIES:
-==============
-
-Core Dependencies:
-  - glob ^10.3.10 (file scanning)
-  - acorn ^8.11.0 (JS parsing)
-
-Development Dependencies:
-  - TypeScript ^5.3.0
-  - Jest ^29.7.0 (testing)
-  - ESLint ^8.55.0 (linting)
-  - ts-jest ^29.1.1 (TS test support)
-
-AUTHOR:
-=======
-
-Camilo Girardelli
-- IEEE Senior Member
-- Senior Software Architect
-- CTO at Girardelli Tecnologia
-- GitHub: @camilogivago
-- LinkedIn: Camilo Girardelli
-
-LICENSE: MIT 2026
-
-GETTING STARTED:
-================
-
-1. npm install
-2. npm run build
-3. npm test
-4. npm run dev (watch mode)
-
-Ready for:
-- Publication to npm as @girardelli/architect
-- Integration into Claude Code
-- Open source contribution
-- Enterprise use

package/README.md

@@ -1,261 +0,0 @@
-# Architect
-
-**AI-powered architecture analysis, refactoring, and context-aware agent system generator**
-
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
-[![Node.js](https://img.shields.io/badge/Node.js-18+-339933.svg)](https://nodejs.org/)
-[![npm](https://img.shields.io/npm/v/@girardelli/architect)](https://www.npmjs.com/package/@girardelli/architect)
-[![Tests](https://img.shields.io/badge/Tests-337%20passing-22c55e.svg)]()
-[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
-
-Understand your codebase architecture in seconds. Detect anti-patterns, get refactoring plans, and generate **context-aware AI agent configurations** that actually understand your stack, domain, and toolchain — all from a single command.
-
-## What's New in v6.0.0
-
-- **Strict Layered Architecture** — Internal codebase rebuilt utilizing a rigorous Core/Infrastructure/Adapters clean architecture format, verifiable dynamically leading to a perfect 100/100 Layering score.
-- **Self-Healing AI Engine** — Architecture rules (Hub Splitter, Import Organizer, Module Grouper) are now context-aware of Clean Architecture paradigms, effectively ignoring stable DTOs/Interfaces and cross-domain test injections to eliminate false positives.
-- **AST Automation Proven** — Capable of structurally rewriting 150+ coupling bottlenecks in large codebases automatically via AST manipulation and Facade (`_deps.ts`) extractions.
-
-- **Context-Aware Agent Generation** — Agents are no longer generic. Templates adapt to your detected stack (Python/FastAPI generates pytest examples, not Jest; Go generates `go test`, not `npm test`)
-- **Framework Detection Engine** — 61 frameworks across 10+ ecosystems detected from dependency files (package.json, pyproject.toml, requirements.txt, pubspec.yaml, go.mod, Cargo.toml, pom.xml, Gemfile, composer.json)
-- **Domain Inference** — Detects business domain (fintech, healthtech, e-commerce, tax, HR, etc.) from project metadata, README, and code structure. Generates domain-specific BDD scenarios, threat models, and compliance requirements (LGPD, PCI-DSS, HIPAA, SOX)
-- **Stack-Aware Templates** — C4 Level 4 code blocks, TDD test examples, ADR decisions, quality gates, and forbidden actions all adapt to the detected language and framework
-- **Skills Generator** — Detects architectural patterns in your codebase (adapters, factories, extractors, repositories) and generates `skills/PROJECT-PATTERNS.md`
-- **Enriched Context** — Module extraction, endpoint detection, toolchain commands, project structure analysis, and critical path identification feed into every generated template
-- **Premium HTML Report** — Dark-themed responsive report with interactive D3.js dependency graph, health radar, bubble charts, and collapsible refactoring steps
-
-## Quick Start
-
-```bash
-# Run directly with npx (no install needed)
-npx @girardelli/architect analyze ./src
-
-# Or install globally
-npm install -g @girardelli/architect
-architect analyze ./src
-```
-
-## Core Features
-
-### Architecture Analysis
-
-Architect scans your codebase and produces a quality score (0-100) with weighted breakdown across four dimensions: Modularity, Coupling, Cohesion, and Layering. It detects anti-patterns (God Class, Circular Dependencies, Leaky Abstractions, Feature Envy, Shotgun Surgery) with severity levels and specific file locations, and automatically identifies architectural layers (API, Service, Data, UI, Infrastructure).
-
-The analysis supports TypeScript, JavaScript, Python, Java, Kotlin, Go, Ruby, PHP, Rust, Dart, and SQL. Framework detection covers 61 frameworks across all major ecosystems — from NestJS and React to FastAPI, Spring Boot, Flutter, Gin, Actix Web, and Rails.
-
-### Refactoring Plan
-
-Each analysis produces a tiered refactoring plan with score impact predictions. Tier 1 contains quick wins (low-risk, immediate impact), Tier 2 covers strategic refactoring with architecture-level benefits. Every step includes before/after score predictions and specific file operations (CREATE, MOVE, MODIFY, DELETE).
-
-### Context-Aware Agent System
-
-This is what sets Architect apart. The `.agent/` directory it generates isn't a generic template — it's deeply customized to your project.
-
-**What gets generated (20+ files):**
-
-```
-.agent/
-├── INDEX.md                          # Project overview with badges and links
-├── agents/
-│   ├── AGENT-ORCHESTRATOR.md         # 5-phase protocol, dispatch table, quality gates
-│   ├── {STACK}-BACKEND-DEVELOPER.md  # Stack-specific backend agent
-│   ├── {FRAMEWORK}-FRONTEND-DEVELOPER.md
-│   ├── FLUTTER-UI-DEVELOPER.md       # (if mobile detected)
-│   ├── DATABASE-ENGINEER.md          # (if database detected)
-│   ├── SECURITY-AUDITOR.md           # STRIDE threats, compliance, integrations
-│   ├── QA-TEST-ENGINEER.md           # Coverage tracking, test scenarios
-│   └── TECH-DEBT-CONTROLLER.md       # Score targets, anti-pattern tracking
-├── rules/
-│   ├── 00-general.md                 # Golden rules, naming, forbidden actions (stack-aware)
-│   ├── 01-architecture.md            # Anti-pattern prevention, module structure
-│   ├── 02-security.md                # OWASP, secrets, input validation
-│   └── {stack}-rules.md              # Stack-specific rules (Python, TypeScript, etc.)
-├── guards/
-│   ├── PREFLIGHT.md                  # Pre-action checklist with detected toolchain
-│   ├── QUALITY-GATES.md              # Build/test/coverage/score gates
-│   └── CODE-REVIEW-CHECKLIST.md      # Domain-specific review items
-├── workflows/
-│   ├── new-feature.md                # Feature development workflow
-│   ├── fix-bug.md                    # Bug fix workflow
-│   └── review.md                     # Code review workflow
-├── templates/
-│   ├── C4.md                         # Architecture template (framework-aware Level 4)
-│   ├── BDD.md                        # BDD scenarios (domain-aware)
-│   ├── TDD.md                        # TDD examples (pytest/junit/go_test/jest per stack)
-│   ├── ADR.md                        # Decision records (stack-aware context)
-│   └── THREAT-MODEL.md               # STRIDE model (domain-specific threats)
-└── skills/
-    └── PROJECT-PATTERNS.md           # Detected patterns (adapters, factories, etc.)
-```
-
-**What makes it context-aware:**
-
-A Python/FastAPI project gets pytest examples in TDD, `class ABC` interfaces in C4, SQLAlchemy references in ADR, `type: ignore` in forbidden actions, and `pytest` in quality gates. A TypeScript/NestJS project gets Jest, `interface`, TypeORM/Prisma, `@ts-ignore`, and `npm run build`. A Go project gets `go test`, `type ... interface`, GORM, `interface{}` warnings, and `go build`. The same command produces fundamentally different output based on what it detects.
-
-**Domain inference feeds into every template.** A fintech project gets PCI-DSS compliance gates, fraud-prevention BDD scenarios, and encryption-focused threat models. A healthtech project gets HIPAA checks and patient data protection rules. Domain confidence is boosted by reading pyproject.toml descriptions, README keywords, and project names.
-
-## CLI Commands
-
-### `architect analyze [path]`
-The unified command — architecture analysis, refactoring plan, and agent suggestions in one report.
-
-```bash
-architect analyze ./src                              # HTML report (default)
-architect analyze ./src --output docs/report.html    # Custom path
-architect analyze ./src --format json                # JSON output
-architect analyze ./src --format markdown             # Markdown output
-```
-
-### `architect agents [path]`
-Generate or audit the `.agent/` directory for AI coding assistants.
-
-```bash
-architect agents ./                                  # Generate full .agent/
-architect agents ./ --agents ORCHESTRATOR,QA          # Specific agents only
-```
-
-If `.agent/` already exists, Architect audits it and only generates missing files.
-
-### `architect refactor [path]`
-Generate a standalone refactoring plan.
-
-### `architect score [path]`
-Calculate architecture quality score (quick mode).
-
-### `architect anti-patterns [path]`
-Detect anti-patterns with severity levels.
-
-### `architect layers [path]`
-Analyze layer structure and distribution.
-
-### `architect diagram [path]`
-Generate architecture diagram in Mermaid format.
-
-## Configuration
-
-Create `.architect.json` in your project root:
-
-```json
-{
-  "ignore": ["node_modules", "dist", ".git", "coverage", "__pycache__", ".venv"],
-  "frameworks": { "detect": true },
-  "antiPatterns": {
-    "godClass": { "linesThreshold": 500, "methodsThreshold": 10 },
-    "shotgunSurgery": { "changePropagationThreshold": 20 }
-  },
-  "score": {
-    "modularity": 0.40,
-    "coupling": 0.25,
-    "cohesion": 0.20,
-    "layering": 0.15
-  }
-}
-```
-
-## Supported Frameworks (61)
-
-| Ecosystem | Frameworks |
-|-----------|-----------|
-| **Node.js/TypeScript** | NestJS, Express, Fastify, Koa, Hapi, Next.js, Nuxt |
-| **Python** | FastAPI, Django, Flask, Starlette, Sanic, Litestar, aiohttp, Tornado, DRF |
-| **Java/Kotlin** | Spring Boot, Quarkus, Micronaut, Ktor |
-| **Go** | Gin, Echo, Fiber, Chi, Gorilla Mux |
-| **Rust** | Actix Web, Axum, Rocket |
-| **Ruby** | Ruby on Rails, Sinatra |
-| **PHP** | Laravel, Symfony, Slim |
-| **Dart/Flutter** | Flutter, Shelf, Dart Frog |
-| **ORM/Database** | TypeORM, Prisma, Sequelize, Mongoose, Knex, Drizzle, SQLAlchemy, SQLModel, Tortoise ORM, Peewee |
-| **Testing** | Jest, Vitest, Mocha, pytest, unittest, Hypothesis, RSpec |
-| **Tooling** | ESLint, Prettier, Biome, Ruff, Black, Flake8, Pylint, mypy |
-
-## CI/CD Integration
-
-### GitHub Actions
-
-```yaml
-name: Architecture Analysis
-on: [push, pull_request]
-
-jobs:
-  architect:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-      - run: npx @girardelli/architect analyze ./src --format html --output architect-report.html
-      - uses: actions/upload-artifact@v4
-        with:
-          name: architect-report
-          path: architect-report.html
-```
-
-### As a Dev Dependency
-
-```bash
-npm install -D @girardelli/architect
-```
-
-```json
-{
-  "scripts": {
-    "architect": "architect analyze ./src --output docs/architect-report.html",
-    "architect:score": "architect score ./src"
-  }
-}
-```
-
-## Programmatic Usage
-
-```typescript
-import { Architect, HtmlReportGenerator } from '@girardelli/architect';
-
-const architect = new Architect();
-
-// Full analysis
-const report = await architect.analyze('./src');
-
-// Refactoring plan
-const plan = architect.refactor(report, './src');
-
-// Agent suggestions (dry-run)
-const agents = architect.suggestAgents('./');
-
-// Generate HTML report
-const htmlGenerator = new HtmlReportGenerator();
-const html = htmlGenerator.generateHtml(report, plan, agents);
-```
-
-## Development
-
-```bash
-npm install
-npm run build    # Compile TypeScript
-npm run dev      # Watch mode
-npm test         # Run tests (337 tests, 9 suites)
-npm run lint     # ESLint
-```
-
-## Roadmap
-
-- **v4.0** — Agent Runtime: orchestrated execution with I/O contracts, pipeline engine, and human approval gates
-
-## Author
-
-**Camilo Girardelli**
-IEEE Senior Member | Senior Software Architect | CTO at Girardelli Tecnologia
-
-- GitHub: [@camilooscargbaptista](https://github.com/camilooscargbaptista)
-- LinkedIn: [Camilo Girardelli](https://www.linkedin.com/in/camilooscargirardellibaptista/)
-- Company: [Girardelli Tecnologia](https://www.girardellitecnologia.com)
-
-## Contributing
-
-Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
-## License
-
-MIT License - Copyright (c) 2026 Camilo Girardelli / Girardelli Tecnologia
-
-See [LICENSE](LICENSE) for details.