@ace3-memory/ace 3.0.39 → 3.0.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +73 -97
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,61 +1,43 @@
1
- # ACE: The Private Engineering Logbook for AI
1
+ # ACE: Universal Memory Infrastructure for AI
2
2
 
3
3
  > **Stop explaining your architecture to ChatGPT every morning.**
4
- >
5
- > ACE gives your AI tools (Claude, ChatGPT, Gemini) a persistent, shared memory that lives on **your** infrastructure, not the cloud.
4
+ >
5
+ > ACE gives your AI tools (Claude, ChatGPT, Gemini, Cursor) persistent, structured memory that lives on **your** infrastructure.
6
6
 
7
7
  [![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)](https://ace3-ai.com/license)
8
8
  [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
9
- [![Version 3.0.9](https://img.shields.io/badge/version-3.0.9-green.svg)](https://github.com/AdyBrooks46/AutonomousContextEngine/releases)
9
+ [![Version 3.0.41](https://img.shields.io/badge/version-3.0.41-green.svg)](https://github.com/AdyBrooks46/AutonomousContextEngine/releases)
10
10
 
11
11
  ---
12
12
 
13
- ## 🛑 The Problem
13
+ ## The Problem
14
14
 
15
- AI coding agents are amazing, but they are **super-talented interns with amnesia**.
16
- * They forget your architectural decisions from last week.
17
- * They re-introduce bugs you already fixed.
18
- * They don't know *why* your codebase is structured this way.
19
- * **And you are tired of copy-pasting context into every new chat session.**
15
+ AI coding agents are amazing, but they're **super-talented interns with amnesia**.
16
+ - They forget your architectural decisions from last week.
17
+ - They re-introduce bugs you already fixed.
18
+ - They don't know *why* your codebase is structured this way.
20
19
 
21
- ## ✅ The Solution: Control, Not Magic.
20
+ ## The Solution
22
21
 
23
- 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.
22
+ ACE (Autonomous Context Engine) is a **memory layer** that sits between you and your AI. It tracks decisions, patterns, issues, and context - so every AI session starts with full knowledge.
24
23
 
25
- ### Why Developers Use ACE:
24
+ ### What Makes ACE Different
26
25
 
27
- 1. **Complete Privacy (Local-First):**
28
- * Your code, decisions, and patterns stay on **your** PostgreSQL database (Localhost or Private Cloud).
29
- * Zero telemetry. No data sent to OpenAI/Anthropic for training.
30
- * You own the "Brain."
31
-
32
- 2. **The "Senior Engineer" in the Loop:**
33
- * **Pattern Enforcement:** ACE scans your code (`pattern_detector.py`) and tells the AI: *"We use the Repository pattern here, don't write spaghetti code."*
34
- * **Decision Tracking:** When you decide "No Microservices," ACE remembers. If an AI tries to suggest a microservice next month, ACE blocks it with context.
35
-
36
- 3. **Team Memory (The "Killer Feature"):**
37
- * **Junior Onboarding:** A new hire asks: *"How do I handle auth?"* ACE answers with the context saved by your Lead Architect 6 months ago.
38
- * **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.
26
+ | | ACE3 | Mem0 | Zep | ChatGPT Memory |
27
+ |---|---|---|---|---|
28
+ | **Structured entity types** (10) | Yes | No | No | No |
29
+ | **Knowledge graph** (12 relationship types) | Yes | No | Yes | No |
30
+ | **AI Builder** (plan generation) | Yes | No | No | No |
31
+ | **Observer** (AI monitoring AI) | Yes | No | No | No |
32
+ | **Customer-hosted database** | Yes | Partial | Enterprise | No |
33
+ | **MCP-native** (29 tools) | Yes | Basic | No | No |
39
34
 
40
35
  ---
41
36
 
42
- ## ⚡ Quick Start
43
-
44
- You don't need a PhD in AI to use this. It's a single binary.
37
+ ## Quick Start
45
38
 
46
39
  ### 1. Install
47
40
 
48
- **macOS / Linux:**
49
- ```bash
50
- curl -fsSL https://ace3-ai.com/install | sh
51
- ```
52
-
53
- **Windows (PowerShell):**
54
- ```powershell
55
- irm https://ace3-ai.com/install.ps1 | iex
56
- ```
57
-
58
- **Alternative (npm):**
59
41
  ```bash
60
42
  npm install -g @ace3-memory/ace
61
43
  ```
@@ -63,91 +45,85 @@ npm install -g @ace3-memory/ace
63
45
  ### 2. Run
64
46
 
65
47
  ```bash
66
- # Login (Authenticates your license, NOT your data)
67
- ace login
68
-
69
- # Start the server (Runs on localhost:7777)
70
- ace start
48
+ ace login # Opens browser for authentication
49
+ ace start # Server runs on localhost:7777
71
50
  ```
72
51
 
73
- ### 3. Connect Your AI
74
-
75
- ACE provides a universal REST API that works with **any** AI tool that can run shell commands or make HTTP requests.
76
-
77
- **Example: Telling Claude/ChatGPT to "Remember":**
52
+ ### 3. Use
78
53
 
79
54
  ```bash
80
- # In your AI chat, just tell it to run:
81
- ace remember --key "auth-decision" --value "We use JWT with 30d expiry because of [reason]"
82
- ```
83
-
84
- **Example: Search Context:**
55
+ # Remember something
56
+ ace remember --key "auth-decision" --value "We use JWT with 30d expiry"
85
57
 
86
- ```bash
58
+ # Recall context
87
59
  ace recall "why did we choose postgres?"
88
- # Output: "Decision #45: Chosen for vector extension support and ACID compliance..."
89
- ```
90
-
91
- ---
92
60
 
93
- ## 🛠️ Features for "Control"
94
-
95
- | Feature | What It Does | Why It Matters |
96
- | :--- | :--- | :--- |
97
- | **Pattern Detector** | Scans Python/JS/TS code to find architectural patterns. | AI writes code that *matches* your existing style, not generic StackOverflow code. |
98
- | **Decision Log** | Tracks "Architecture Decision Records" (ADRs). | Prevents "Architecture Drift" where AI slowly ruins your design. |
99
- | **Issue Tracker** | Logs bugs and their specific fixes. | Never debug the same "stale token" error twice. |
100
- | **Team Sync** | Syncs memories across your team (Pro Plan). | Your Junior Dev inherits the Senior Dev's context instantly. |
61
+ # REST API (works with any AI tool)
62
+ curl -X POST http://localhost:7777/api/v1/my-project/decisions \
63
+ -H "Authorization: Bearer $ACE_JWT_TOKEN" \
64
+ -H "Content-Type: application/json" \
65
+ -d '{"decision": "Use PostgreSQL", "rationale": "Vector extensions + ACID"}'
66
+ ```
101
67
 
102
68
  ---
103
69
 
104
- ## 🏗️ Architecture (Privacy First)
105
-
106
- We built ACE to be the "Switzerland" of AI. Neutral, private, and secure.
70
+ ## Architecture
107
71
 
108
72
  ```
109
- [ Your Laptop / Server ]
73
+ [ Your Machine ]
110
74
  |
111
- +-- [ ACE Binary ] (The Brain)
75
+ +-- [ ACE Server ] (localhost:7777)
112
76
  | |
113
- | +-- [ Your Local Postgres ] (The Memory) <--- DATA STAYS HERE
77
+ | +-- [ Your PostgreSQL ] (Neon, local, AWS, etc.)
114
78
  |
115
- +-- [ AI Interface ] (Claude, ChatGPT, IDE) <--- Queries ACE via localhost:7777
79
+ +-- [ AI Tools ] (Claude, ChatGPT, Cursor) --> queries ACE via REST/MCP
80
+ |
81
+ +-- [ Dashboard ] (ace3-ai.com) --> visualize & manage memory
116
82
  ```
117
83
 
118
- **We (ACE3) provide:**
119
- * The Intelligence (The Binary).
120
- * The Dashboard (UI for visualizing memory).
121
- * The License.
84
+ **You provide:** The database (PostgreSQL) and infrastructure.
85
+ **We provide:** The intelligence, dashboard, and tools.
86
+
87
+ ---
88
+
89
+ ## Features
122
90
 
123
- **You provide:**
124
- * The Database (Postgres).
125
- * The Infrastructure.
91
+ | Feature | Description |
92
+ |---------|-------------|
93
+ | **10 Entity Types** | Memories, decisions, issues, work logs, architecture, patterns, best practices, observations, tags, relationships |
94
+ | **Knowledge Graph** | 12 relationship types with temporal traversal and visualization |
95
+ | **Semantic Search** | OpenAI embeddings + pgvector for intelligent recall |
96
+ | **AI Builder** | Generate project plans with GPT-4/Claude/Gemini |
97
+ | **Observer** | AI that monitors your AI for errors, drift, contradictions |
98
+ | **Background Agents** | 6 AI agents that maintain memory (cleanup, graph maintenance, triage, etc.) |
99
+ | **MCP Server** | 29 tools for Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT, Gemini |
100
+ | **REST API** | 210+ endpoints for any AI tool or custom integration |
101
+ | **Dashboard** | Web UI at ace3-ai.com for visual memory management |
126
102
 
127
103
  ---
128
104
 
129
- ## 💰 Pricing (v3.0.5)
105
+ ## Pricing
130
106
 
131
- * **Starter (Free):** 1 User, 1 Namespace, 100 Memories, 50 API calls/day. Forever free.
132
- * **Developer:** £9.99/mo. 1 User, 3 Namespaces, 2,500 Memories, 500 API calls/day.
133
- * **Pro:** £24.99/mo. 10 Users (+£3/extra), Unlimited Namespaces & Memories.
134
- * **Founder's Deal:** £299 one-time. 25 Users, Lifetime access. Limited to 100 licenses.
135
- * **Enterprise:** Custom pricing. Unlimited everything, SSO, SLA.
107
+ All plans include a 14-day free trial with full Pro access.
136
108
 
137
- [**View Full Pricing & Sign Up**](https://ace3-ai.com/pricing)
109
+ | Tier | Price | For |
110
+ |------|-------|-----|
111
+ | **Starter** | £14.99/mo | Solo developers |
112
+ | **Pro** | £39.99/mo | Teams (10 users included, +£3/extra) |
113
+ | **Founder** | £299 one-time | Lifetime Pro+ (25 users, limited to 100 licenses) |
114
+ | **Enterprise** | Custom | Unlimited everything, SSO, SLA |
138
115
 
139
- ---
116
+ [**View Pricing**](https://ace3-ai.com/pricing)
140
117
 
141
- ## 🤝 Contributing
118
+ ---
142
119
 
143
- We are "Open Core" at heart. While the core binary is proprietary (to protect our IP), we welcome contributions to:
144
- * **Parsers:** Add support for Rust, Go, Java.
145
- * **SDKs:** Build a Python or Node.js wrapper.
146
- * **Integrations:** Build a VS Code extension.
120
+ ## Contributing
147
121
 
148
- See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
122
+ We welcome contributions to:
123
+ - **SDKs**: Python SDK (`ace3-memory` on PyPI, see ROADMAP.md Phase 1)
124
+ - **Integrations**: VS Code extension, browser extensions
125
+ - **Parsers**: Add support for Rust, Go, Java
149
126
 
150
127
  ---
151
128
 
152
- **Built by a Developer, for Developers.**
153
- *This isn't "Magic." It's just a better way to work.*
129
+ **Built by a developer, for developers.**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ace3-memory/ace",
3
- "version": "3.0.39",
3
+ "version": "3.0.41",
4
4
  "description": "Your Logbook for AI - persistent memory for ChatGPT, Claude, Gemini, and more",
5
5
  "main": "index.js",
6
6
  "bin": {