release: v1.0.21 — bridge fixes, perseus knows, /knows endpoint

CHANGELOG.md

@@ -12,6 +12,34 @@ else (installer, docs) is generated by `scripts/release.sh`.
 
 ## [Unreleased]
 
+## [1.0.21] - 2026-07-07
+
+### Fixed
+- **Legacy `mneme:`/`mimir:` config no longer shadowed by the default `perseus_vault:` block** (#704).
+  `load_config` materializes a full default `perseus_vault:` block, so a config that only had a
+  legacy block — the previously-recommended migration target — was silently dead: the bridge fell
+  back to a bare `perseus-vault` PATH lookup and `fallback_to_local` masked it as "local results
+  only". Legacy blocks are now folded into the canonical key at load (deep-merged; explicit
+  canonical wins key-by-key), with a one-time deprecation notice and a new `perseus doctor` check
+  that ERRORS when a raw legacy block is not reflected in the resolved connector config.
+- **`MnemeConnector.recall` sends the Vault tool's canonical argument names** (#699). The tool
+  drops unknown keys silently, so `max_results` never reached `limit` (every bridge recall was
+  pinned to 10) and `min_decay_score` never reached `min_decay`. A single memory-type filter now
+  maps onto the tool's `type`; `include_federation`/`filters` are documented no-ops.
+- **Serve index version badge follows the real package version** (#696) — it was hardcoded `v0.6`.
+
+### Added
+- **`perseus knows`** (#692, alias `perseus memory review`) — plain-language "what does my
+  assistant know about me?" screen: active-only headline count, buckets (About you / Project
+  facts & decisions / Recently learned / Low confidence), ✔/~ trust markers, 8-char short ids
+  resolved git-style, and curation (`--show`, `--forget` reversible archive, `--correct`
+  bitemporal wrong→right pair) with confirm-before-write. `--json` for machines. Config block:
+  `knows.enabled` / `knows.limit`.
+- **`/knows` serve endpoint + "What Perseus knows about you" index panel** (#695) — the #692
+  renderer over HTTP (markdown or `?format=json`) through the existing redact + bearer-auth
+  path, read-only; the index gains Vault memory stat cards fed by the Vault's active-only stats
+  (perseus-vault #493), never the archived-inflated totals.
+
 ## [1.0.20] - 2026-07-07
 
 Merged via #689.

VERSION

@@ -1 +1 @@
-1.0.20
+1.0.21

perseus.py

@@ -74,7 +74,7 @@ def _perseus_lazy_urllib_request(name, _urllib=urllib):
 # ── Version (injected by scripts/build.py at build time) ──────────────────
 # All other modules reference _PERSEUS_VERSION; the build script's
 # _VERSION_RE replaces the literal "0.0.0" with the VERSION file value.
-_PERSEUS_VERSION = "1.0.20"  # replaced at build time by scripts/build.py — see VERSION file for canonical value
+_PERSEUS_VERSION = "1.0.21"  # replaced at build time by scripts/build.py — see VERSION file for canonical value
 
 # Register as 'perseus' so plugins can import from us (task-65)
 import sys as _sys
@@ -952,7 +952,7 @@ def _reset_hooks_cache() -> None:
 try:
     from .serve import _PERSEUS_VERSION
 except ImportError:
-    _PERSEUS_VERSION = "1.0.20"  # replaced at build time by scripts/build.py (see VERSION file)
+    _PERSEUS_VERSION = "1.0.21"  # replaced at build time by scripts/build.py (see VERSION file)
 
 # ──────────────────────────────── Webhooks ───────────────────────────────────
 
@@ -24671,7 +24671,7 @@ def _find_version() -> str:
             return candidate.read_text(encoding="utf-8").strip()
     return _PERSEUS_VERSION  # fallback to build-time injected literal
 
-_PERSEUS_VERSION = "1.0.20"  # replaced at build time by scripts/build.py (see VERSION file)
+_PERSEUS_VERSION = "1.0.21"  # replaced at build time by scripts/build.py (see VERSION file)
 _PERSEUS_VERSION = _find_version()
 
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "perseus-ctx"
-version = "1.0.20"
+version = "1.0.21"
 description = "Live context engine for AI assistants — resolve before context, zero cold-start tax."
 readme = "README.md"
 license = { text = "MIT" }

server.json

@@ -3,12 +3,12 @@
   "name": "io.github.Perseus-Computing-LLC/perseus",
   "title": "Perseus: MCP server and live context engine",
   "description": "Live context MCP server: resolves git, services, and tests into agent context. Local-first, MIT.",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "perseus-ctx",
-      "version": "1.0.20",
+      "version": "1.0.21",
       "packageArguments": [
         {
           "type": "positional",