archondev 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# ArchonDev
+
+**Local-first AI-powered development governance**
+
+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.
+
+## Installation
+
+```bash
+npm install -g archondev
+```
+
+## Quick Start
+
+```bash
+# Initialize ArchonDev in your project
+archon init
+
+# Create a work item (atom) with AI-powered planning
+archon plan "Add user authentication with JWT"
+
+# Execute the plan with quality gates
+archon execute ATOM-001
+```
+
+## How It Works
+
+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)
+
+## Documentation
+
+Full documentation at [https://archondev.io](https://archondev.io)
+
+## License
+
+MIT
+
+---
+
+*Powered by ArchonDev - AI Development Governance by Jumping Ahead Corp.*

package/dist/chunk-R6IMTNKV.js

@@ -0,0 +1,389 @@
+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";
+import matter from "gray-matter";
+var ArchitectureParser = class {
+  filePath;
+  constructor(filePath = "ARCHITECTURE.md") {
+    this.filePath = filePath;
+  }
+  /**
+   * Parse the ARCHITECTURE.md file
+   */
+  async parse() {
+    const errors = [];
+    const warnings = [];
+    if (!existsSync(this.filePath)) {
+      return {
+        success: false,
+        errors: [
+          {
+            type: "FILE_NOT_FOUND",
+            message: `ARCHITECTURE.md not found at ${this.filePath}`
+          }
+        ],
+        warnings: []
+      };
+    }
+    let content;
+    try {
+      content = await readFile(this.filePath, "utf-8");
+    } catch (error) {
+      return {
+        success: false,
+        errors: [
+          {
+            type: "FILE_NOT_FOUND",
+            message: `Failed to read ${this.filePath}: ${error instanceof Error ? error.message : "Unknown error"}`
+          }
+        ],
+        warnings: []
+      };
+    }
+    let parsed;
+    try {
+      parsed = matter(content);
+    } catch (error) {
+      return {
+        success: false,
+        errors: [
+          {
+            type: "INVALID_YAML",
+            message: `Invalid YAML frontmatter: ${error instanceof Error ? error.message : "Unknown error"}`
+          }
+        ],
+        warnings: []
+      };
+    }
+    const data = parsed.data;
+    if (!data["version"]) {
+      warnings.push('Missing version field, defaulting to "1.0"');
+    }
+    const schema = {
+      version: this.getString(data, "version", "1.0"),
+      updatedAt: this.getString(data, "updatedAt", (/* @__PURE__ */ new Date()).toISOString()),
+      profile: this.getProfile(data),
+      strictMode: this.getBoolean(data, "strictMode", true),
+      systemGoals: this.parseSystemGoals(data, warnings),
+      components: this.parseComponents(data, errors, warnings),
+      invariants: this.parseInvariants(data, errors, warnings),
+      protectedPaths: this.parseProtectedPaths(data, warnings),
+      cautiousPaths: this.parseCautiousPaths(data, warnings),
+      temporaryOverrides: this.parseTemporaryOverrides(data, warnings),
+      environments: this.parseEnvironments(data, warnings),
+      rawYaml: data,
+      markdownBody: parsed.content
+    };
+    if (errors.length > 0) {
+      return {
+        success: false,
+        errors,
+        warnings
+      };
+    }
+    return {
+      success: true,
+      schema,
+      errors: [],
+      warnings
+    };
+  }
+  // ============================================================================
+  // HELPER METHODS
+  // ============================================================================
+  getString(data, key, defaultValue) {
+    const value = data[key];
+    return typeof value === "string" ? value : defaultValue;
+  }
+  getBoolean(data, key, defaultValue) {
+    const value = data[key];
+    return typeof value === "boolean" ? value : defaultValue;
+  }
+  getProfile(data) {
+    const value = data["profile"];
+    if (value === "strict" || value === "balanced" || value === "exploratory") {
+      return value;
+    }
+    return "strict";
+  }
+  parseSystemGoals(data, warnings) {
+    const goals = data["systemGoals"];
+    if (!Array.isArray(goals)) {
+      if (goals !== void 0) {
+        warnings.push("systemGoals should be an array");
+      }
+      return [];
+    }
+    return goals.filter((g) => typeof g === "object" && g !== null).map((g) => ({
+      id: this.getString(g, "id", ""),
+      title: this.getString(g, "title", ""),
+      description: this.getString(g, "description", ""),
+      priority: this.getPriority(g)
+    })).filter((g) => g.id && g.title);
+  }
+  getPriority(data) {
+    const value = data["priority"];
+    if (value === "CRITICAL" || value === "HIGH" || value === "MEDIUM" || value === "LOW") {
+      return value;
+    }
+    return "MEDIUM";
+  }
+  parseComponents(data, errors, warnings) {
+    const components = data["components"];
+    if (!Array.isArray(components)) {
+      if (components !== void 0) {
+        warnings.push("components should be an array");
+      }
+      return [];
+    }
+    return components.filter((c) => typeof c === "object" && c !== null).map((c) => {
+      const id = this.getString(c, "id", "");
+      const name = this.getString(c, "name", "");
+      const paths = this.getStringArray(c, "paths");
+      if (!id) {
+        errors.push({
+          type: "MISSING_REQUIRED_FIELD",
+          message: "Component missing required field: id",
+          field: "components[].id"
+        });
+      }
+      if (paths.length === 0) {
+        warnings.push(`Component ${id} has no paths defined`);
+      }
+      return {
+        id,
+        name,
+        description: this.getOptionalString(c, "description"),
+        paths,
+        boundary: this.getBoundary(c),
+        stability: this.getStability(c),
+        owner: this.getOptionalString(c, "owner"),
+        tags: this.getStringArray(c, "tags"),
+        dependsOn: this.parseDependencies(c),
+        exports: this.parseExports(c),
+        forbiddenImports: this.parseForbiddenImports(c)
+      };
+    }).filter((c) => c.id);
+  }
+  getStringArray(data, key) {
+    const value = data[key];
+    if (!Array.isArray(value)) return [];
+    return value.filter((v) => typeof v === "string");
+  }
+  getOptionalString(data, key) {
+    const value = data[key];
+    return typeof value === "string" ? value : void 0;
+  }
+  getBoundary(data) {
+    const value = data["boundary"];
+    if (value === "PUBLIC_API" || value === "INTERNAL" || value === "INFRASTRUCTURE" || value === "EXTERNAL") {
+      return value;
+    }
+    return "INTERNAL";
+  }
+  getStability(data) {
+    const value = data["stability"];
+    if (value === "STABLE" || value === "EVOLVING" || value === "EXPERIMENTAL" || value === "DEPRECATED") {
+      return value;
+    }
+    return "EVOLVING";
+  }
+  parseDependencies(data) {
+    const deps = data["dependsOn"];
+    if (!Array.isArray(deps)) return void 0;
+    return deps.filter((d) => typeof d === "object" && d !== null).map((d) => ({
+      component: this.getString(d, "component", ""),
+      coupling: this.getCoupling(d),
+      reason: this.getOptionalString(d, "reason")
+    })).filter((d) => d.component);
+  }
+  getCoupling(data) {
+    const value = data["coupling"];
+    if (value === "TIGHT" || value === "LOOSE" || value === "NONE") {
+      return value;
+    }
+    return "LOOSE";
+  }
+  parseExports(data) {
+    const exports = data["exports"];
+    if (!Array.isArray(exports)) return void 0;
+    return exports.filter((e) => typeof e === "object" && e !== null).map((e) => ({
+      symbol: this.getString(e, "symbol", ""),
+      type: this.getExportType(e),
+      path: this.getString(e, "path", "")
+    })).filter((e) => e.symbol && e.path);
+  }
+  getExportType(data) {
+    const value = data["type"];
+    if (value === "function" || value === "class" || value === "interface" || value === "type" || value === "const") {
+      return value;
+    }
+    return "function";
+  }
+  parseForbiddenImports(data) {
+    const imports = data["forbiddenImports"];
+    if (!Array.isArray(imports)) return void 0;
+    return imports.filter((i) => typeof i === "object" && i !== null).map((i) => ({
+      pattern: this.getString(i, "pattern", ""),
+      reason: this.getString(i, "reason", "")
+    })).filter((i) => i.pattern);
+  }
+  parseInvariants(data, errors, warnings) {
+    const invariants = data["invariants"];
+    if (!Array.isArray(invariants)) {
+      if (invariants !== void 0) {
+        warnings.push("invariants should be an array");
+      }
+      return [];
+    }
+    return invariants.filter((i) => typeof i === "object" && i !== null).map((i) => {
+      const id = this.getString(i, "id", "");
+      const rule = this.getString(i, "rule", "");
+      if (!id) {
+        errors.push({
+          type: "MISSING_REQUIRED_FIELD",
+          message: "Invariant missing required field: id",
+          field: "invariants[].id"
+        });
+      }
+      if (!rule) {
+        errors.push({
+          type: "MISSING_REQUIRED_FIELD",
+          message: `Invariant ${id} missing required field: rule`,
+          field: "invariants[].rule"
+        });
+      }
+      return {
+        id,
+        severity: this.getSeverity(i),
+        rule,
+        match: this.getOptionalString(i, "match"),
+        scope: this.getOptionalString(i, "scope"),
+        pathPattern: this.getOptionalString(i, "pathPattern"),
+        reason: this.getOptionalString(i, "reason"),
+        exception: this.getOptionalString(i, "exception")
+      };
+    }).filter((i) => i.id && i.rule);
+  }
+  getSeverity(data) {
+    const value = data["severity"];
+    if (value === "BLOCKING" || value === "REQUIRES_OVERRIDE" || value === "WARN" || value === "ADVISORY") {
+      return value;
+    }
+    return "WARN";
+  }
+  parseProtectedPaths(data, warnings) {
+    const paths = data["protectedPaths"];
+    if (!Array.isArray(paths)) {
+      if (paths !== void 0) {
+        warnings.push("protectedPaths should be an array");
+      }
+      return [];
+    }
+    return paths.filter((p) => typeof p === "object" && p !== null).map((p) => ({
+      pattern: this.getString(p, "pattern", ""),
+      level: this.getProtectionLevel(p),
+      reason: this.getString(p, "reason", ""),
+      approvalRequired: this.getOptionalString(p, "approvalRequired")
+    })).filter((p) => p.pattern);
+  }
+  getProtectionLevel(data) {
+    const value = data["level"];
+    if (value === "HARD" || value === "SOFT" || value === "ADVISORY") {
+      return value;
+    }
+    return "SOFT";
+  }
+  parseCautiousPaths(data, warnings) {
+    const paths = data["cautiousPaths"];
+    if (!Array.isArray(paths)) {
+      if (paths !== void 0) {
+        warnings.push("cautiousPaths should be an array");
+      }
+      return [];
+    }
+    return paths.filter((p) => typeof p === "object" && p !== null).map((p) => ({
+      pattern: this.getString(p, "pattern", ""),
+      level: "SOFT",
+      reason: this.getString(p, "reason", ""),
+      warning: this.getOptionalString(p, "warning")
+    })).filter((p) => p.pattern);
+  }
+  parseTemporaryOverrides(data, warnings) {
+    const overrides = data["temporaryOverrides"];
+    if (!Array.isArray(overrides)) {
+      if (overrides !== void 0) {
+        warnings.push("temporaryOverrides should be an array");
+      }
+      return [];
+    }
+    return overrides.filter((o) => typeof o === "object" && o !== null).map((o) => ({
+      path: this.getString(o, "path", ""),
+      grantedTo: this.getString(o, "grantedTo", ""),
+      reason: this.getString(o, "reason", ""),
+      expiresAt: this.getString(o, "expiresAt", "")
+    })).filter((o) => o.path && o.grantedTo);
+  }
+  parseEnvironments(data, warnings) {
+    const envs = data["environments"];
+    if (typeof envs !== "object" || envs === null) {
+      if (envs !== void 0) {
+        warnings.push("environments should be an object");
+      }
+      return {};
+    }
+    const envsObj = envs;
+    const result = {};
+    for (const key of ["development", "staging", "production"]) {
+      const env = envsObj[key];
+      if (typeof env === "object" && env !== null) {
+        const envData = env;
+        result[key] = {
+          autoApprove: this.getBoolean(envData, "autoApprove", key === "development"),
+          qualityGates: this.getStringArray(envData, "qualityGates"),
+          requiresManualPromotion: this.getBoolean(envData, "requiresManualPromotion", false)
+        };
+      }
+    }
+    return result;
+  }
+};
+
+export {
+  __require,
+  __commonJS,
+  __toESM,
+  ArchitectureParser
+};

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node