@ace3-memory/ace 3.0.5

package/LICENSE

@@ -0,0 +1,26 @@
+PROPRIETARY SOFTWARE LICENSE
+
+Copyright © 2025 ACE3 Technologies. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are the proprietary
+and confidential information of ACE3 Technologies.
+
+NOTICE: All information contained herein is, and remains the property of ACE3
+Technologies. The intellectual and technical concepts contained herein are proprietary
+to ACE3 Technologies and may be covered by patents, patents in process, and are
+protected by trade secret or copyright law.
+
+Dissemination of this information or reproduction of this material is strictly
+forbidden unless prior written permission is obtained from ACE3 Technologies.
+
+Unauthorized copying, modification, distribution, or use of this Software, via any
+medium, is strictly prohibited without the express written consent of ACE3 Technologies.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL ACE3 TECHNOLOGIES BE LIABLE
+FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+
+For licensing inquiries, please contact: legal@ace3-ai.com

package/README.md

@@ -0,0 +1,153 @@
+# ACE: The Private Engineering Logbook for AI
+
+> **Stop explaining your architecture to ChatGPT every morning.**
+> 
+> ACE gives your AI tools (Claude, ChatGPT, Gemini) a persistent, shared memory that lives on **your** infrastructure, not the cloud.
+
+[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](https://ace3-ai.com/license)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
+[![Version 3.0.5](https://img.shields.io/badge/version-3.0.5-green.svg)](https://github.com/AdyBrooks46/AutonomousContextEngine/releases)
+
+---
+
+## 🛑 The Problem
+
+AI coding agents are amazing, but they are **super-talented interns with amnesia**.
+*   They forget your architectural decisions from last week.
+*   They re-introduce bugs you already fixed.
+*   They don't know *why* your codebase is structured this way.
+*   **And you are tired of copy-pasting context into every new chat session.**
+
+## ✅ The Solution: Control, Not Magic.
+
+ACE (Autonomous Context Engine) is a **local-first** memory layer that sits between you and your AI. It automatically indexes your codebase, tracks your decisions, and ensures every AI session starts with full context.
+
+### Why Developers Use ACE:
+
+1.  **Complete Privacy (Local-First):**
+    *   Your code, decisions, and patterns stay on **your** PostgreSQL database (Localhost or Private Cloud).
+    *   Zero telemetry. No data sent to OpenAI/Anthropic for training.
+    *   You own the "Brain."
+
+2.  **The "Senior Engineer" in the Loop:**
+    *   **Pattern Enforcement:** ACE scans your code (`pattern_detector.py`) and tells the AI: *"We use the Repository pattern here, don't write spaghetti code."*
+    *   **Decision Tracking:** When you decide "No Microservices," ACE remembers. If an AI tries to suggest a microservice next month, ACE blocks it with context.
+
+3.  **Team Memory (The "Killer Feature"):**
+    *   **Junior Onboarding:** A new hire asks: *"How do I handle auth?"* ACE answers with the context saved by your Lead Architect 6 months ago.
+    *   **No More Repetition:** Solve a bug once. ACE remembers the fix forever. The next time the AI sees that error, it knows the solution immediately.
+
+---
+
+## ⚡ Quick Start
+
+You don't need a PhD in AI to use this. It's a single binary.
+
+### 1. Install
+
+**macOS / Linux:**
+```bash
+curl -fsSL https://ace3-ai.com/install | sh
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://ace3-ai.com/install.ps1 | iex
+```
+
+**Alternative (npm):**
+```bash
+npm install -g @ace3-memory/ace
+```
+
+### 2. Run
+
+```bash
+# Login (Authenticates your license, NOT your data)
+ace login
+
+# Start the server (Runs on localhost:7777)
+ace start
+```
+
+### 3. Connect Your AI
+
+ACE provides a universal REST API that works with **any** AI tool that can run shell commands or make HTTP requests.
+
+**Example: Telling Claude/ChatGPT to "Remember":**
+
+```bash
+# In your AI chat, just tell it to run:
+ace remember --key "auth-decision" --value "We use JWT with 30d expiry because of [reason]"
+```
+
+**Example: Search Context:**
+
+```bash
+ace recall "why did we choose postgres?"
+# Output: "Decision #45: Chosen for vector extension support and ACID compliance..."
+```
+
+---
+
+## 🛠️ Features for "Control"
+
+| Feature | What It Does | Why It Matters |
+| :--- | :--- | :--- |
+| **Pattern Detector** | Scans Python/JS/TS code to find architectural patterns. | AI writes code that *matches* your existing style, not generic StackOverflow code. |
+| **Decision Log** | Tracks "Architecture Decision Records" (ADRs). | Prevents "Architecture Drift" where AI slowly ruins your design. |
+| **Issue Tracker** | Logs bugs and their specific fixes. | Never debug the same "stale token" error twice. |
+| **Team Sync** | Syncs memories across your team (Pro Plan). | Your Junior Dev inherits the Senior Dev's context instantly. |
+
+---
+
+## 🏗️ Architecture (Privacy First)
+
+We built ACE to be the "Switzerland" of AI. Neutral, private, and secure.
+
+```
+[ Your Laptop / Server ]
+   |
+   +-- [ ACE Binary ] (The Brain)
+   |      |
+   |      +-- [ Your Local Postgres ] (The Memory) <--- DATA STAYS HERE
+   |
+   +-- [ AI Interface ] (Claude, ChatGPT, IDE) <--- Queries ACE via localhost:7777
+```
+
+**We (ACE3) provide:**
+*   The Intelligence (The Binary).
+*   The Dashboard (UI for visualizing memory).
+*   The License.
+
+**You provide:**
+*   The Database (Postgres).
+*   The Infrastructure.
+
+---
+
+## 💰 Pricing (v3.0.5)
+
+*   **Starter (Free):** 1 User, 1 Namespace, 100 Memories, 50 API calls/day. Forever free.
+*   **Developer:** £9.99/mo. 1 User, 3 Namespaces, 2,500 Memories, 500 API calls/day.
+*   **Pro:** £24.99/mo. 10 Users (+£3/extra), Unlimited Namespaces & Memories.
+*   **Founder's Deal:** £299 one-time. 25 Users, Lifetime access. Limited to 100 licenses.
+*   **Enterprise:** Custom pricing. Unlimited everything, SSO, SLA.
+
+[**View Full Pricing & Sign Up**](https://ace3-ai.com/pricing)
+
+---
+
+## 🤝 Contributing
+
+We are "Open Core" at heart. While the core binary is proprietary (to protect our IP), we welcome contributions to:
+*   **Parsers:** Add support for Rust, Go, Java.
+*   **SDKs:** Build a Python or Node.js wrapper.
+*   **Integrations:** Build a VS Code extension.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+---
+
+**Built by a Developer, for Developers.**
+*This isn't "Magic." It's just a better way to work.*

package/cli.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * ACE CLI Wrapper
+ * Thin wrapper that executes the platform-specific binary
+ * This file is readable, but the actual ACE logic is in the compiled binary
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+
+const platform = process.platform;
+const binaryName = 'ace' + (platform === 'win32' ? '.exe' : '');
+const binaryPath = path.join(__dirname, 'bin', binaryName);
+
+// Check if binary exists
+const fs = require('fs');
+if (!fs.existsSync(binaryPath)) {
+  console.error('❌ ACE binary not found.');
+  console.error('This usually means the installation failed.');
+  console.error('Try reinstalling: npm install -g @ace3-memory/ace');
+  process.exit(1);
+}
+
+// Execute the binary with all arguments
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  env: process.env
+});
+
+child.on('exit', (code) => {
+  process.exit(code || 0);
+});
+
+child.on('error', (err) => {
+  console.error('❌ Failed to start ACE:', err.message);
+  process.exit(1);
+});

package/download-binary.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+/**
+ * ACE Binary Downloader (npm postinstall script)
+ * Downloads platform-specific ACE binary from GitHub releases
+ * Similar to how Claude Code, GitHub CLI, and other modern tools work
+ */
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+const VERSION = process.env.ACE_VERSION || 'v3.0.4';
+const GITHUB_REPO = 'AdyBrooks46/AutonomousContextEngine';
+const BINARY_DIR = path.join(__dirname, 'bin');
+
+// Detect platform and architecture
+const platform = process.platform;
+const arch = process.arch;
+
+// Map to binary names
+// Note: macOS Intel (x64) uses ARM64 binary via Rosetta 2
+const BINARY_MAP = {
+  'darwin-arm64': 'ace-macos-arm64',
+  'darwin-x64': 'ace-macos-arm64',  // Intel Macs use ARM64 via Rosetta 2
+  'linux-x64': 'ace-linux-x64',
+  'win32-x64': 'ace-windows-x64.exe'
+};
+
+const platformKey = `${platform}-${arch}`;
+const binaryName = BINARY_MAP[platformKey];
+
+if (!binaryName) {
+  console.error(`❌ Unsupported platform: ${platform} ${arch}`);
+  console.error(`Supported platforms: macOS (Intel/Apple Silicon), Linux x64, Windows x64`);
+  process.exit(1);
+}
+
+// GitHub release URL
+const downloadUrl = `https://github.com/${GITHUB_REPO}/releases/download/${VERSION}/${binaryName}`;
+const binaryPath = path.join(BINARY_DIR, 'ace' + (platform === 'win32' ? '.exe' : ''));
+
+console.log(`\n📦 Installing ACE ${VERSION} for ${platform} ${arch}...`);
+console.log(`📥 Downloading: ${binaryName}`);
+
+// Create bin directory
+if (!fs.existsSync(BINARY_DIR)) {
+  fs.mkdirSync(BINARY_DIR, { recursive: true });
+}
+
+// Download binary
+const file = fs.createWriteStream(binaryPath);
+let downloadedBytes = 0;
+let totalBytes = 0;
+
+https.get(downloadUrl, (response) => {
+  if (response.statusCode === 302 || response.statusCode === 301) {
+    // Follow redirect
+    https.get(response.headers.location, (redirectResponse) => {
+      totalBytes = parseInt(redirectResponse.headers['content-length'], 10);
+
+      redirectResponse.on('data', (chunk) => {
+        downloadedBytes += chunk.length;
+        const percent = ((downloadedBytes / totalBytes) * 100).toFixed(1);
+        process.stdout.write(`\r⏳ Progress: ${percent}% (${(downloadedBytes / 1024 / 1024).toFixed(1)}MB / ${(totalBytes / 1024 / 1024).toFixed(1)}MB)`);
+      });
+
+      redirectResponse.pipe(file);
+
+      file.on('finish', () => {
+        file.close(() => {
+          process.stdout.write('\n');
+          console.log('✅ Download complete');
+
+          // Make executable (Unix-like systems)
+          if (platform !== 'win32') {
+            try {
+              fs.chmodSync(binaryPath, 0o755);
+              console.log('✅ Binary made executable');
+            } catch (err) {
+              console.error('⚠️  Could not make binary executable:', err.message);
+            }
+          }
+
+          console.log(`✅ ACE installed successfully!`);
+          console.log(`\n🚀 Quick start:`);
+          console.log(`   1. ace login       # Authenticate`);
+          console.log(`   2. ace start       # Start server`);
+          console.log(`   3. ace status      # Check status\n`);
+        });
+      });
+    }).on('error', (err) => {
+      fs.unlinkSync(binaryPath);
+      console.error(`\n❌ Download failed:`, err.message);
+      process.exit(1);
+    });
+  } else if (response.statusCode === 200) {
+    totalBytes = parseInt(response.headers['content-length'], 10);
+
+    response.on('data', (chunk) => {
+      downloadedBytes += chunk.length;
+      const percent = ((downloadedBytes / totalBytes) * 100).toFixed(1);
+      process.stdout.write(`\r⏳ Progress: ${percent}% (${(downloadedBytes / 1024 / 1024).toFixed(1)}MB / ${(totalBytes / 1024 / 1024).toFixed(1)}MB)`);
+    });
+
+    response.pipe(file);
+
+    file.on('finish', () => {
+      file.close(() => {
+        process.stdout.write('\n');
+        console.log('✅ Download complete');
+
+        // Make executable (Unix-like systems)
+        if (platform !== 'win32') {
+          try {
+            fs.chmodSync(binaryPath, 0o755);
+            console.log('✅ Binary made executable');
+          } catch (err) {
+            console.error('⚠️  Could not make binary executable:', err.message);
+          }
+        }
+
+        console.log(`✅ ACE installed successfully!`);
+        console.log(`\n🚀 Quick start:`);
+        console.log(`   1. ace login       # Authenticate`);
+        console.log(`   2. ace start       # Start server`);
+        console.log(`   3. ace status      # Check status\n`);
+      });
+    });
+  } else {
+    console.error(`\n❌ Failed to download: HTTP ${response.statusCode}`);
+    console.error(`URL: ${downloadUrl}`);
+    process.exit(1);
+  }
+}).on('error', (err) => {
+  if (fs.existsSync(binaryPath)) {
+    fs.unlinkSync(binaryPath);
+  }
+  console.error(`\n❌ Download failed:`, err.message);
+  process.exit(1);
+});
+
+file.on('error', (err) => {
+  if (fs.existsSync(binaryPath)) {
+    fs.unlinkSync(binaryPath);
+  }
+  console.error(`\n❌ File write error:`, err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@ace3-memory/ace",
+  "version": "3.0.5",
+  "description": "Your Logbook for AI - persistent memory for ChatGPT, Claude, Gemini, and more",
+  "main": "index.js",
+  "bin": {
+    "ace": "./cli.js"
+  },
+  "scripts": {
+    "postinstall": "node download-binary.js",
+    "test": "./scripts/test-report.sh run",
+    "test:report": "./scripts/test-report.sh",
+    "test:frontend": "cd ace-frontend && npm test",
+    "test:unit": "python -m pytest tests/unit -v --tb=short",
+    "test:api": "ACE_SERVER_RUNNING=1 python -m pytest tests/api -v --tb=short",
+    "test:all": "npm run test:frontend && npm run test:unit && npm run test:api",
+    "test:coverage": "python -m pytest tests/ --cov=ace_core --cov-report=html --cov-report=term"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AdyBrooks46/AutonomousContextEngine.git"
+  },
+  "keywords": [
+    "ai",
+    "memory",
+    "llm",
+    "rag",
+    "vector",
+    "embeddings",
+    "semantic-search",
+    "chatgpt",
+    "claude",
+    "gemini",
+    "context",
+    "persistent-memory"
+  ],
+  "author": "ACE3 Technologies <team@ace3-ai.com>",
+  "license": "PROPRIETARY",
+  "homepage": "https://ace3-ai.com",
+  "bugs": {
+    "url": "https://github.com/AdyBrooks46/AutonomousContextEngine/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "files": [
+    "cli.js",
+    "download-binary.js",
+    "README.md",
+    "LICENSE"
+  ]
+}