@archpilotlabs/archpilot 0.0.1

package/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2026 ArchPilotLabs
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary and confidential.
+
+No part of this Software may be used, copied, modified, distributed, sublicensed, or disclosed without prior written permission from ArchPilotLabs.
+
+For licensing inquiries, contact: support@archpilot.org

package/README.md

@@ -0,0 +1,168 @@
+# ArchPilot
+
+**Executable architecture governance for your codebase.**
+
+ArchPilot is a CLI that validates your repository against architecture rules and helps you keep your system **visible, enforceable, and measurable** as it evolves.
+
+---
+
+## 🚀 What it does
+
+ArchPilot turns architecture into something you can actually run and verify:
+
+* Validate module boundaries and dependencies
+* Enforce architecture rules and contracts
+* Detect architectural drift over time
+* Generate architecture scores and reports
+* Surface architecture feedback in PRs and CI
+
+No runtime agents. No external services. Fully deterministic and local-first.
+
+---
+
+## 📦 Installation
+
+Install globally:
+
+```bash
+npm install -g @archpilotlabs/archpilot
+```
+
+Or run without installing:
+
+```bash
+npx @archpilotlabs/archpilot --help
+```
+
+---
+
+## ⚡ Quick Start
+
+### 1. Initialize architecture
+
+```bash
+archpilot init
+```
+
+Creates `.archpilot/` with architecture config, rules, and baseline artifacts.
+
+---
+
+### 2. Run validation
+
+```bash
+archpilot validate
+```
+
+Example output:
+
+```text
+ArchPilot Architecture Review
+
+Result: FAIL
+Errors: 2   Warnings: 1
+Score: 82 / 100
+```
+
+---
+
+### 3. Fix issues
+
+```bash
+archpilot fix
+```
+
+Applies safe, deterministic fixes for missing architecture artifacts.
+
+---
+
+### 4. Use in CI
+
+```bash
+archpilot validate --ci
+```
+
+* Fails only on real architecture violations
+* Keeps setup issues separate from architecture quality
+
+---
+
+## 🧑‍💻 CLI vs VS Code Extension
+
+ArchPilot works in two ways:
+
+* **CLI (this package)** → validation, CI, automation
+* **VS Code Extension** → visual inspector, guided workflows, and architecture exploration
+
+Both use the same validation engine and produce identical results.
+The extension enhances developer experience, but is not required.
+
+---
+
+## 🧠 Key Concepts
+
+### Architecture Health Score
+
+Measures actual architecture quality based on violations.
+
+### Setup Readiness Score
+
+Tracks completeness of configuration and onboarding.
+
+### Findings
+
+* **violation** → real architecture issue
+* **setup-gap** → missing config / skipped checks
+* **guidance** → non-blocking recommendation
+
+---
+
+## 🔍 Core Commands
+
+```bash
+archpilot init
+archpilot validate
+archpilot validate --ci
+archpilot fix
+archpilot impact <file>
+archpilot review pr
+archpilot diagrams generate
+archpilot governance upload
+```
+
+---
+
+## 🧩 Features
+
+* Architecture-as-code (`.archpilot/`)
+* Dependency validation and module contracts
+* ADR (Architecture Decision Record) support
+* Drift detection and history tracking
+* PR review and CI integration
+* Architecture scoring and reporting
+
+---
+
+## 🎯 Philosophy
+
+ArchPilot is built on four principles:
+
+* Architecture should be explicit
+* Rules should be executable
+* Validation should be deterministic
+* Feedback should be continuous
+
+---
+
+## 📄 License
+
+All rights reserved. This software is proprietary and closed-source.
+
+---
+
+## 🌐 Learn More
+
+* Website: https://archpilot.org
+* Documentation: https://archpilot.org/docs
+
+---