archondev 0.1.0 → 1.1.0

package/README.md

@@ -1,75 +1,108 @@
 # ArchonDev
 
-**Local-first AI-powered development governance**
+**AI Development Governance — Stop Babysitting Your AI Agent**
 
-ArchonDev brings architectural governance to AI-assisted development. It ensures your AI coding assistants (Cursor, Copilot, Claude, etc.) respect codebase boundaries, follow coding standards, and never violate critical invariants.
+## Two Ways to Use ArchonDev
 
-## Installation
+### Option 1: Full CLI (Recommended)
+The complete AI development system. It manages your entire development process so you can focus on the big picture — not constantly correcting your AI.
 
 ```bash
-npm install -g archondev
-```
+# macOS/Linux:
+npm install -g archondev && archon
 
-## Quick Start
+# Windows PowerShell:
+npm install -g archondev; archon
+```
 
-```bash
-# Initialize ArchonDev in your project
-archon init
+**What you get:**
+- AI that reads and respects your architecture before writing code
+- Adversarial planning (Architect proposes, Sentinel critiques)
+- Automatic quality gates before changes are applied
+- Learning persistence — mistakes are remembered and avoided
+- Bug reporting with root cause analysis
+- AI-powered code review for any codebase
+- Multi-provider key support with adversarial features
 
-# Create a work item (atom) with AI-powered planning
-archon plan "Add user authentication with JWT"
+### Option 2: Lite Package
+Copy governance files into any project. Works with your existing AI tools (Cursor, Claude Code, Windsurf, VS Code + Copilot).
 
-# Execute the plan with quality gates
-archon execute ATOM-001
-```
+[Download Lite Packages →](https://archondev.io/download)
 
-## How It Works
+**What you get:**
+- ARCHITECTURE.md template with best practices
+- IDE-specific rule files (.cursorrules, CLAUDE.md, etc.)
+- Progress tracking templates
+- Works with any AI coding assistant
 
-1. **Architecture as Input** - Define your system boundaries, invariants, and protected paths in `ARCHITECTURE.md`
-2. **Adversarial Planning** - An Architect agent creates plans, a Sentinel agent critiques them
-3. **Governed Execution** - Changes are validated against your architecture before being applied
-4. **Learning Persistence** - Insights are captured in `progress.txt` for future sessions
+---
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `archon init` | Initialize ArchonDev in your project |
-| `archon plan <description>` | Create a new atom with AI planning |
-| `archon execute <atom-id>` | Execute a planned atom |
-| `archon list` | List all atoms |
-| `archon show <atom-id>` | Show atom details |
-| `archon status` | Show current user and project status |
-| `archon login` | Authenticate with ArchonDev |
-| `archon keys add <provider>` | Add API key for BYOK tier |
-| `archon bug report <title>` | Report a bug with RCA |
-| `archon promote <atom-id>` | Promote atom to higher environment |
-
-## Tiers
-
-| Tier | Price | Features |
-|------|-------|----------|
-| **Free** | $0 | 100 atoms/month, basic models (Haiku, Flash, GPT-4 Mini) |
-| **BYOK** | $0 | Unlimited atoms, use your own API keys |
-| **Pro** | $29/mo | Premium models (Opus, Sonnet), $50 credits included |
-
-## Light Packages
-
-Don't need the full CLI? Download governance templates for your IDE:
-
-- [Cursor Package](https://archondev.io/downloads/cursor-package.zip)
-- [Windsurf Package](https://archondev.io/downloads/windsurf-package.zip)
-- [VS Code + Copilot Package](https://archondev.io/downloads/vscode-copilot-package.zip)
-- [Claude Code / Amp Package](https://archondev.io/downloads/claude-amp-package.zip)
+| `archon` | Interactive mode — just run and follow prompts |
+| `archon init` | Initialize in your project |
+| `archon plan <description>` | Create a work item with AI planning |
+| `archon execute <atom-id>` | Execute with quality gates |
+| `archon list` | List all work items |
+| `archon show <atom-id>` | Show details |
+| `archon watch` | Live TUI dashboard with status and credits |
+| `archon bug report <title>` | Bug report with root cause analysis |
+| `archon review init` | Initialize AI-powered code review |
+| `archon review analyze` | Scan project and populate review tasks |
+| `archon review run` | Run AI review on pending tasks |
+| `archon credits` | View credit balance |
+| `archon credits add` | Purchase credits |
+| `archon credits budget` | Set monthly budget and alerts |
+| `archon keys add <provider>` | Add your own API key — BYOK (Bring Your Own Key) |
+| `archon keys list` | Show configured API keys by provider |
+| `archon preferences` | View/set model preferences |
+| `archon models` | List available AI models |
+
+## Pricing
+
+| Tier | Cost | What You Get |
+|------|------|--------------|
+| **Free** | $0 | 10,000 atoms/month, fast models (Haiku, Flash, GPT-4 Mini) |
+| **Credits** | Pay as you go | All models, 10% service fee, deposit any amount |
+| **BYOK** (Bring Your Own Key) | $0 | Use your own API keys, unlimited usage |
+
+No subscriptions. No commitments. Start free.
 
-## Documentation
+## How It Works
 
-Full documentation at [https://archondev.io](https://archondev.io)
+1. **Define Your Rules** — Create ARCHITECTURE.md with boundaries and invariants
+2. **AI Reads Rules First** — Every session starts by understanding your architecture
+3. **Changes Are Validated** — Quality gates check code before it's applied
+4. **Learnings Persist** — Insights saved for future sessions
 
-## License
+## Working with Existing Projects
+
+Have a project created by another AI agent? ArchonDev can review it first, then govern future changes.
+
+```bash
+# Step 1: Review existing code
+cd your-existing-project
+archon review init        # Create local review database
+archon review analyze     # Scan project structure
+archon review run --all   # AI reviews all features
+archon review export > review-report.md
+
+# Step 2: Set up governance
+archon init --analyze     # Creates ARCHITECTURE.md
+
+# Step 3: Fix issues with governed workflow
+archon plan "fix critical issues from review"
+archon execute <atom-id>
+```
+
+The CLI detects existing projects and suggests this workflow automatically.
+
+## Documentation
 
-MIT
+[archondev.io](https://archondev.io)
 
 ---
 
-*Powered by ArchonDev - AI Development Governance by Jumping Ahead Corp.*
+*ArchonDev by Jumping Ahead Corp.*

package/dist/auth-2QIFQZTL.js

@@ -0,0 +1,12 @@
+import {
+  login,
+  logout,
+  status
+} from "./chunk-CAYCSBNX.js";
+import "./chunk-WCCBJSNI.js";
+import "./chunk-QGM4M3NI.js";
+export {
+  login,
+  logout,
+  status
+};

package/dist/bug-DXLBBW3U.js

@@ -0,0 +1,10 @@
+import {
+  bugReport
+} from "./chunk-JBKFAD4M.js";
+import "./chunk-MOZHC2GX.js";
+import "./chunk-WCCBJSNI.js";
+import "./chunk-A7QU6JC6.js";
+import "./chunk-QGM4M3NI.js";
+export {
+  bugReport
+};

package/dist/{chunk-R6IMTNKV.js → chunk-2CFO5GVH.js}

@@ -1,35 +1,3 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-
 // src/core/parser/parser.ts
 import { readFile } from "fs/promises";
 import { existsSync } from "fs";
@@ -382,8 +350,5 @@ var ArchitectureParser = class {
 };
 
 export {
-  __require,
-  __commonJS,
-  __toESM,
   ArchitectureParser
 };