1.0.3: mcp-server module split (slice 1) + plain-English README

CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 1.0.3 - 2026-05-28
+
+Housekeeping release. Nothing about how Audrey behaves has changed — this is
+all under-the-hood tidying plus a friendlier README. Safe to upgrade from 1.0.2
+without touching anything.
+
+### Cleaner code under the hood
+
+- Started breaking up the big `mcp-server/index.ts` file (it had grown to ~3,600
+  lines that did everything at once). The memory-tool input schemas and the
+  shared validation helpers now live in their own small files
+  (`tool-schemas.ts`, `tool-validation.ts`). Same behavior, just easier to read
+  and work on. More of this tidying will follow.
+
+### More reliable tests
+
+- The test suite used to need a slow, multi-step "build all the benchmark and
+  paper files first" step before it could run. It now sets those up
+  automatically, so `npm test` (or a plain `vitest run`) just works from a fresh
+  checkout. 785 tests pass with nothing extra to remember.
+
+### Friendlier docs
+
+- The README now opens with a short "In Plain English" section that explains
+  what Audrey is for in everyday language, before diving into the technical
+  detail.
+
 ## 1.0.2 - 2026-05-28
 
 Maintenance and engineering-quality release. No runtime behavior change — the

README.md

@@ -15,6 +15,14 @@
   </p>
 </div>
 
+## In Plain English
+
+AI coding assistants are brilliant but forgetful. They'll happily rerun the same broken command they ran yesterday, forget the rules your team agreed on last week, and treat every new session like it's day one.
+
+Audrey is the memory they're missing. It quietly keeps track of what worked, what failed, and what you told it — then checks that memory **before** the agent does something, so it can say "hold on, this exact command failed last time, and here's what fixed it" instead of repeating the mistake. Everything lives in one local file on your machine: no cloud, no account, and nothing about your code ever leaves your computer.
+
+That's the whole idea. The rest of this README is the detail.
+
 ## Why Audrey Exists
 
 Agents forget the exact mistakes they made yesterday. They repeat broken commands, lose project-specific rules, miss contradictions, and treat every new session like a cold start.

mcp-server/config.ts

@@ -3,7 +3,7 @@ import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import type { AudreyConfig, EmbeddingConfig, LLMConfig } from '../src/types.js';
 
-export const VERSION = '1.0.2';
+export const VERSION = '1.0.3';
 export const SERVER_NAME = 'audrey-memory';
 export const DEFAULT_AGENT = 'local-agent';
 export const DEFAULT_DATA_DIR = join(homedir(), '.audrey', 'data');