From 28f70aafdbf71a3710765605e34f119b8bc6f436 Mon Sep 17 00:00:00 2001 From: Riz Ashraf Date: Thu, 10 Sep 2026 15:57:23 +0100 Subject: [PATCH] docs: Update design.md to reflect new HTTP gate endpoints alongside CLI commands --- design.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/design.md b/design.md index 927f682..4755097 100644 --- a/design.md +++ b/design.md @@ -63,9 +63,9 @@ econcile_worker) on a 5-second polling loop responsible for: * **Ephemeral Data Cleanup:** Automatically expiring and purging sticky_notes.json that are older than 24 hours. ## 8. The Gate System (Push Safety Verification) -The binary includes dedicated CLI subcommands (gate set and gate verify) that interact with a persistent gates.json store to enforce safety policies (like ensuring tests pass before a git push). -* **mcp-memory-stub gate set**: Records an authorization status (authorized, blocked, or pending) for a specific target and namespace, alongside optional failure reasons and parameters. -* **mcp-memory-stub gate verify**: Evaluates a pending action against the gate store. It returns exit code if authorized, 1 if explicitly blocked, and 2 if no gate record exists. It also supports a --consume flag to immediately revoke the authorization after a successful check. +The binary supports a flexible safety gate authorization system, accessible both via the HTTP API and CLI subcommands. +* **API / CLI set**: Records an authorization status (`authorized`, `blocked`, or `pending`) for a specific target and namespace. Can be invoked via `POST /gate/set` (JSON) or `mcp-memory-stub gate set`. +* **API / CLI verify**: Evaluates a pending action against the gate store. It returns standard HTTP status codes (`200 OK`, `403 Forbidden`, `404 Not Found`) via `GET /gate/verify?action=...` or POSIX exit codes (0, 1, 2) via `mcp-memory-stub gate verify`. Both support a `consume` parameter/flag to immediately revoke the authorization after a successful check. ## 9. Operational Configuration & Paths The physical storage location of the knowledge graph and all persistent stores is strictly controlled by the MCP_MEMORY_STORE_DIR environment variable.