You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 7b1a772
Browse filesBrowse the repository at this point in the historyBrowse files
Copy file name to clipboardExpand all lines: SECURITY.md
+6-4Lines changed: 6 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -122,11 +122,12 @@ We follow the [CVSS v3.1](https://www.first.org/cvss/v3.1/specification-document
122
122
123
123
## Security Design Principles
124
124
125
-
### 1. Local-First, Zero-Network
125
+
### 1. Local-First (not zero-network)
126
126
127
-
- All embeddings, reranking, and memory consolidation run locally
128
-
- Memory text **never** leaves the device
129
-
- No telemetry, no analytics, no remote logging
127
+
- Storage, keyword/BM25 search, mirroring and the injection pipeline are entirely local
128
+
- Embeddings and consolidation **run locally only when configured to**: `embedProvider` defaults to `openai`, which POSTs memory text to the endpoint you configure; `autoDream` / `autoSummarize` send text through the host LLM. Set `embedProvider: local` (plus the local runtime) if text must not leave the machine
129
+
- Other outbound calls: the npm registry version check, and local model downloads when the runtime is provisioned
130
+
- No telemetry, no analytics, no remote logging of memory content
130
131
131
132
### 2. Fail-Safe by Default
132
133
@@ -156,6 +157,7 @@ The token is a lock on the **write** surface, not a wall around the whole API.
156
157
-**Gated routes (when a token is configured)**: all writes (`/create`, `/update`, `/delete`, `/import`, `/mode`, `/features`, `/commands`, `/conflicts/resolve`, `PUT /profile`, `PUT /rules`, `/vector-config`, `/vector-reindex`, `/runtime/provision`, `/maintenance/reclaim`, `/test-model`, `/health`) and the sensitive reads `/export` and `/external-api`.
157
158
-**The standalone data plane** (`127.0.0.1:8790`) is the opposite shape: every route except `GET /health` requires its own Bearer token. Pointing `externalApiHost` at a non-loopback address therefore turns it into a plaintext, token-only HTTP surface — an explicit operator decision.
158
159
-**Consequence**: if you expose the plugin beyond loopback (reverse proxy, non-loopback bind), set `apiToken`*and* check that the plain reads above are acceptable to expose — they are not covered by it.
160
+
-**How this list stays true**: every route declares its own `policy` (`open` / `token` / `token-write`) at registration, and `createRouteRegistrar` throws when a route has none or reuses a path. A new route that forgets its classification **fails to boot** instead of silently opening — the matrix above is derived from code, not from anyone's memory.
0 commit comments