@cerefox/memory 1.17.1 → 1.17.3

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 (33) hide show
  1. package/AGENT_GUIDE.md +5 -5
  2. package/AGENT_QUICK_REFERENCE.md +1 -1
  3. package/dist/bin/cerefox.js +24 -23
  4. package/dist/frontend/assets/{index-C5878rMW.js → index-D7YyXio_.js} +27 -27
  5. package/dist/frontend/assets/{index-C5878rMW.js.map → index-D7YyXio_.js.map} +1 -1
  6. package/dist/frontend/index.html +1 -1
  7. package/dist/server-assets/_shared/ef-meta/index.ts +5 -5
  8. package/dist/server-assets/_shared/embeddings/index.ts +1 -1
  9. package/dist/server-assets/_shared/embeddings/onnx-embedder.ts +2 -2
  10. package/dist/server-assets/_shared/ingest/pipeline-helpers.ts +1 -1
  11. package/dist/server-assets/_shared/mcp-tools/_utils.ts +2 -2
  12. package/dist/server-assets/_shared/mcp-tools/audit-log.ts +1 -1
  13. package/dist/server-assets/_shared/mcp-tools/get-help-content.ts +2 -2
  14. package/dist/server-assets/_shared/mcp-tools/identity.ts +1 -1
  15. package/dist/server-assets/_shared/mcp-tools/ingest.ts +1 -1
  16. package/dist/server-assets/_shared/mcp-tools/relations.ts +3 -3
  17. package/dist/server-assets/_shared/mcp-tools/search.ts +2 -2
  18. package/dist/server-assets/_shared/partial-edits/index.ts +1 -1
  19. package/dist/server-assets/db/rpcs.sql +13 -5
  20. package/dist/server-assets/db/schema.sql +1 -1
  21. package/dist/server-assets/supabase/functions/cerefox-ingest/index.ts +1 -1
  22. package/dist/server-assets/supabase/functions/cerefox-mcp/index.ts +1 -1
  23. package/dist/server-assets/supabase/functions/cerefox-search/index.ts +1 -1
  24. package/docs/api/openapi.json +10 -3
  25. package/docs/guides/api.md +4 -4
  26. package/docs/guides/cli.md +2 -2
  27. package/docs/guides/configuration.md +5 -5
  28. package/docs/guides/connect-agents.md +3 -3
  29. package/docs/guides/ops-scripts.md +3 -3
  30. package/docs/guides/response-limits.md +3 -3
  31. package/docs/guides/staging-env.md +2 -2
  32. package/docs/guides/upgrading.md +2 -2
  33. package/package.json +1 -1
@@ -53,7 +53,7 @@ Three top-level paths plus a few special cases:
53
53
  > ChatGPT becomes possible on the same server but is not yet documented.)
54
54
 
55
55
  > **Perplexity** supports stdio-only MCP on macOS Desktop (via Helper App). Remote MCP is
56
- > "coming soon." Perplexity's CTO has signalled a strategic shift away from MCP (March 2026),
56
+ > "coming soon." Perplexity's CTO has signaled a strategic shift away from MCP (March 2026),
57
57
  > so API-based integration may be the long-term path. Not a priority.
58
58
  >
59
59
  > **Gemini web** (gemini.google.com) does not support custom MCP servers. No integration path.
@@ -174,7 +174,7 @@ set — as it is for a [staging environment](staging-env.md) — the name become
174
174
  entry rather than replacing it, and an agent can hold both at once (v1.4.0, #168).
175
175
  The command prints the name it used.
176
176
 
177
- A labelled entry additionally carries `CEREFOX_CONFIG_DIR` and `CEREFOX_ENV_LABEL`
177
+ A labeled entry additionally carries `CEREFOX_CONFIG_DIR` and `CEREFOX_ENV_LABEL`
178
178
  in its `env` block. That is what makes it actually reach the environment it is named
179
179
  after: MCP clients spawn a stdio server with the **client's** environment, not the
180
180
  shell you ran `configure-agent` in, and a desktop client launched from the dock has
@@ -344,7 +344,7 @@ https://<your-project-ref>.supabase.co/functions/v1/cerefox-mcp
344
344
  |----------|--------|
345
345
  | Default local agent (Claude Code, Cursor, Codex, Gemini, Claude Desktop) | Path A-Local -- preferred; `cerefox configure-agent`, zero Edge Function cost, no token to distribute |
346
346
  | Multiple machines / cloud dev environments | Path A-Remote -- one hosted URL works everywhere (needs a Cerefox token) |
347
- | Minimise Supabase Edge Function usage (free tier limits) | Path A-Local -- zero Edge Function invocations |
347
+ | Minimize Supabase Edge Function usage (free tier limits) | Path A-Local -- zero Edge Function invocations |
348
348
  | Offline use or development on the cerefox codebase | Path A-Local -- no network dependency |
349
349
  | Lowest latency (same machine, no HTTPS round-trip) | Path A-Local -- slightly faster |
350
350
 
@@ -277,7 +277,7 @@ it is off the field is absent from every other surface, and an export is not the
277
277
  place to resurrect it.
278
278
 
279
279
  Markdown rather than JSON so the sidecars are readable in the same editor as the
280
- documents. Pass `--no-metadata` for the older content-only behaviour.
280
+ documents. Pass `--no-metadata` for the older content-only behavior.
281
281
 
282
282
  Two naming details worth knowing:
283
283
 
@@ -320,7 +320,7 @@ Two things worth knowing about what it does *not* claim:
320
320
 
321
321
  - **Coverage is stated, not implied.** `x-cerefox-coverage` in the document lists
322
322
  how many routes carry a response schema, which routes legitimately return
323
- something other than JSON, and which are unmodelled. An unmodelled route gets
323
+ something other than JSON, and which are unmodeled. An unmodeled route gets
324
324
  **no** schema rather than a guessed one.
325
325
  - **`info.version` is the API's, not the release's.** It moves when `/api/v1`
326
326
  changes. Binding it to the package version made the committed artifact stale at
@@ -329,7 +329,7 @@ Two things worth knowing about what it does *not* claim:
329
329
 
330
330
  ## search_benchmark.ts — Search-calibration benchmark
331
331
 
332
- Measures how search ranks against a labelled query vocabulary
332
+ Measures how search ranks against a labeled query vocabulary
333
333
  (`_shared/search-benchmark/vocabulary/`: a synthetic corpus, about 150 queries
334
334
  in 13 categories, variant groups, no-answer queries) and compares alternative
335
335
  scoring formulas and settings. It is how the v1.17.0 defaults were chosen. Design
@@ -19,13 +19,13 @@ raises or lowers it per call with `--max-bytes`.
19
19
  > **Changed in v0.10.2.** The CLI originally returned everything, like the web UI. It now
20
20
  > honours `CEREFOX_MAX_RESPONSE_BYTES` (200 000 default) and prints
21
21
  > `(results truncated at N bytes; use --max-bytes to raise)` when results are dropped.
22
- > This guide described the pre-v0.10.2 behaviour until v1.14.4.
22
+ > This guide described the pre-v0.10.2 behavior until v1.14.4.
23
23
 
24
24
  ---
25
25
 
26
26
  ## How each access path handles response size
27
27
 
28
- | Path | Limit behaviour |
28
+ | Path | Limit behavior |
29
29
  |------|----------------|
30
30
  | Web UI (`/search`) | **No limit** — all results returned |
31
31
  | CLI (`cerefox search`) | Defaults to `CEREFOX_MAX_RESPONSE_BYTES` (200 000); raise or lower per call with `--max-bytes`. Announces truncation. |
@@ -203,4 +203,4 @@ threshold (it is a SQL DEFAULT in `rpcs.sql`, changed via `cerefox server deploy
203
203
  | Can an agent exceed the server ceiling? | No — always capped |
204
204
  | Where is the ceiling configured? | `.env` for local MCP; TypeScript constant in Edge Functions |
205
205
  | How are limits applied? | Whole-document drop; never mid-content truncation |
206
- | Is truncation signalled? | Yes — `truncated: true` in responses |
206
+ | Is truncation signaled? | Yes — `truncated: true` in responses |
@@ -30,7 +30,7 @@ Three things, and the third turned out to matter most:
30
30
  every legacy document (real spend, rewrites chunks). Proving it on a copy
31
31
  first turns an act of faith into a measurement.
32
32
  - **Development.** A store you are willing to break is the cheapest way to turn
33
- a claim about runtime behaviour into a measurement. During the 1.1.0 cycle this
33
+ a claim about runtime behavior into a measurement. During the 1.1.0 cycle this
34
34
  found a retry loop executing 68,825 times per request, a `migrate-format` that
35
35
  reported success while converting nothing, and a `backup create` that failed
36
36
  against older servers — none visible from the code or the test suite. Keep it
@@ -276,7 +276,7 @@ read but nothing acts on it.
276
276
 
277
277
  | Area | Problem |
278
278
  |---|---|
279
- | **Agent (MCP) config** | Safe since v1.4.0 ([#168](https://github.com/fstamatelopoulos/cerefox/issues/168)). `configure-agent` names the server after `CEREFOX_ENV_LABEL`, so a staging environment registers as **`cerefox-staging`** alongside your production `cerefox` entry rather than replacing it, and an agent can hold both. The labelled entry also carries its own `CEREFOX_CONFIG_DIR` and `CEREFOX_ENV_LABEL` in the config it writes — without that the client would spawn the server with *its own* environment (a GUI client launched from the dock has none), `CEREFOX_CONFIG_DIR` would be absent, and an entry named `cerefox-staging` would quietly serve production. Before v1.4.0 it registered every environment as `cerefox` and running it from staging silently repointed all your agents. |
279
+ | **Agent (MCP) config** | Safe since v1.4.0 ([#168](https://github.com/fstamatelopoulos/cerefox/issues/168)). `configure-agent` names the server after `CEREFOX_ENV_LABEL`, so a staging environment registers as **`cerefox-staging`** alongside your production `cerefox` entry rather than replacing it, and an agent can hold both. The labeled entry also carries its own `CEREFOX_CONFIG_DIR` and `CEREFOX_ENV_LABEL` in the config it writes — without that the client would spawn the server with *its own* environment (a GUI client launched from the dock has none), `CEREFOX_CONFIG_DIR` would be absent, and an entry named `cerefox-staging` would quietly serve production. Before v1.4.0 it registered every environment as `cerefox` and running it from staging silently repointed all your agents. |
280
280
  | **`doctor`'s `mcp clients` line** | It inspects your global agent configs, which point at production, and reports them even in staging mode. Informative, but easy to misread as "staging is wired to my agents". |
281
281
  | **`doctor` remediation commands** | Environment-aware since v1.8.0: in a staging environment the remediations tell you to prefix `CEREFOX_CONFIG_DIR` (or use the alias). Before that, a staging `doctor` printed bare `cerefox …` remediations that act on production. |
282
282
 
@@ -66,7 +66,7 @@ schema-requiring release.
66
66
  > `pending_review`" decision out of the clients and into the
67
67
  > `cerefox_ingest_document` RPC (#241). A v1.13.0 client no longer decides
68
68
  > the status itself, so against an older server every agent write would
69
- > silently land `approved` — a behaviour change, not a missing feature — and
69
+ > silently land `approved` — a behavior change, not a missing feature — and
70
70
  > the new review-status search filter would fail outright. The **minimum
71
71
  > supported schema is therefore `0.16.0`**: until you run `cerefox server
72
72
  > deploy`, `cerefox web` refuses to start and `doctor` says exactly why.
@@ -84,7 +84,7 @@ schema-requiring release.
84
84
  > `pending_review` regardless, so turning the workflow back on shows the
85
85
  > statuses the store would have had all along. It is an RPC-only change —
86
86
  > `cerefox server deploy` (or `--schema-only`) picks it up; nothing refuses
87
- > to run until you do, but a 0.16.0 server keeps the v1.13.0 write behaviour.
87
+ > to run until you do, but a 0.16.0 server keeps the v1.13.0 write behavior.
88
88
 
89
89
  > ### Upgrading to v1.1.0 — `cerefox server deploy` is required
90
90
  >
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cerefox/memory",
3
- "version": "1.17.1",
3
+ "version": "1.17.3",
4
4
  "description": "Cerefox \u2014 user-owned shared memory for AI agents. CLI + stdio MCP server + web UI + ingestion for a knowledge base on your own Supabase project (or fully self-hosted with Cerefox Local).",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://github.com/fstamatelopoulos/cerefox",