@archpilotlabs/archpilot 0.0.19 → 0.1.0

package/README.md

@@ -13,7 +13,7 @@ ArchPilot validates your repository against architecture rules, helping engineer
 **Your AI writes code. ArchPilot protects architecture.**
 
 <p align="center">
-  Validate | Enforce | Measure architecture continuously
+  Validate • Enforce • Measure architecture continuously
 </p>
 
 ArchPilot makes architecture **visible, enforceable, and measurable** as your system evolves.
@@ -38,11 +38,12 @@ ArchPilot gives teams deterministic architecture guardrails in local development
 
 ArchPilot turns architecture into something you can actually run and verify:
 
-- Validate module boundaries and dependencies
+- Validate architecture across modern application stacks
+- Validate module boundaries and dependency governance
 - Enforce architecture rules and contracts
 - Detect architectural drift over time
 - Generate architecture scores and reports
-- Surface architecture feedback in PRs and CI
+- Surface architecture feedback in local development, PRs, and CI
 
 No runtime agents. No external services. Fully deterministic and local-first.
 
@@ -52,23 +53,32 @@ ArchPilot works alongside GitHub Copilot, Claude Code, Codex, Cursor, and other
 
 ## Supported Stacks
 
-ArchPilot supports **practical deterministic architecture detection** across modern application stacks.
+ArchPilot provides **deterministic architecture validation** across modern application stacks using framework-aware analysis and explicit architectural evidence.
 
 ### Backend
 
-- Node.js / TypeScript
+Framework-aware validation
+
+- Spring / Spring Boot
 - NestJS
 - Express.js
+- FastAPI
+- Laravel
+- ASP.NET
+- Go
+
+Language-aware validation
+
 - Java
-- Spring / Spring Boot
+- Node.js / TypeScript
+- PHP
+- Python
+
+Framework detection
+
 - Kotlin
-- FastAPI
 - Django
 - Flask
-- PHP
-- Laravel
-- Go
-- .NET
 - Ruby on Rails
 
 ### Frontend
@@ -78,12 +88,16 @@ ArchPilot supports **practical deterministic architecture detection** across mod
 - Angular
 - Vue
 
-### Infrastructure
+### Infrastructure Context
 
 - Terraform
 - Ansible
 
-ArchPilot detects application stacks from practical repository evidence - framework markers, manifests, project layout, and source structure - then applies conservative architecture discovery defaults locally.
+Infrastructure repositories are detected as part of repository architecture discovery. Full architecture validation currently focuses on application stacks.
+
+ArchPilot automatically detects supported stacks from repository evidence including framework markers, dependency metadata, manifests, project layout, source structure, and framework-specific constructs.
+
+Validation remains deterministic and framework-aware. When evidence is ambiguous, ArchPilot intentionally prefers conservative findings over speculative analysis.
 
 **No cloud scanning. No remote indexing. Deterministic local validation.**
 
@@ -254,7 +268,8 @@ archpilot governance upload
 
 - Architecture-as-code (`.archpilot/`)
 - Smart Init architecture discovery
-- Dependency validation and module contracts
+- Cross-stack architecture validation
+- Dependency governance and module contracts
 - ADR (Architecture Decision Record) support
 - Drift detection and history tracking
 - PR review and CI integration
@@ -262,6 +277,25 @@ archpilot governance upload
 
 ---
 
+## Deterministic by Design
+
+ArchPilot intentionally avoids speculative code analysis.
+
+Findings are produced from explicit architectural evidence such as:
+
+- Framework annotations and decorators
+- Dependency relationships
+- Route and API definitions
+- Authorization constructs
+- Transaction boundaries
+- ORM and query APIs
+- Event and messaging infrastructure
+- Architecture configuration and contracts
+
+When evidence is ambiguous, ArchPilot prefers not to report a finding rather than generating false positives.
+
+---
+
 ## Philosophy
 
 ArchPilot is built on four principles: