@cerefox/memory 1.22.0 → 1.22.2

package/dist/frontend/index.html

@@ -15,8 +15,8 @@
       href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600;700&display=swap"
     />
     <title>Cerefox</title>
-    <script type="module" crossorigin src="/app/assets/index-Dhpoy6w3.js"></script>
-    <link rel="modulepreload" crossorigin href="/app/assets/rolldown-runtime-COiEfhsA.js">
+    <script type="module" crossorigin src="/app/assets/index-BI4vv_74.js"></script>
+    <link rel="modulepreload" crossorigin href="/app/assets/rolldown-runtime-XKyaHtl9.js">
     <link rel="stylesheet" crossorigin href="/app/assets/index-CV1iy1p2.css">
   </head>
   <body>

package/dist/server-assets/_shared/ef-meta/index.ts

@@ -18,7 +18,7 @@
  * doesn't touch `supabase/functions/` leaves it alone).
  */
 
-export const EF_VERSION = "1.22.0";
+export const EF_VERSION = "1.22.2";
 
 /**
  * The Cerefox RELEASE version — what `cerefox --version` reports and what npm
@@ -36,7 +36,7 @@ export const EF_VERSION = "1.22.0";
  * is imported by the Deno Edge Functions, which cannot reach into the npm
  * package.
  */
-export const CEREFOX_VERSION = "1.22.0";
+export const CEREFOX_VERSION = "1.22.2";
 
 /**
  * The most recent version whose EF-side SOURCE actually changed (#127).

package/docs/api/openapi.json

@@ -5797,7 +5797,7 @@
     },
     "/api/v1/version": {
       "get": {
-        "summary": "Server version, environment label, and the newest release on npm as the server last checked it (`latest`, plus `update_command` when it is newer).",
+        "summary": "Server version, environment label, and the newest release on npm as the server last checked it (`latest`; `update_available` when it is newer, with `update_command` unless the server runs in a container, where it cannot tell how it was installed).",
         "operationId": "get_version",
         "responses": {
           "200": {
@@ -5834,6 +5834,9 @@
                         "null"
                       ]
                     },
+                    "update_available": {
+                      "type": "boolean"
+                    },
                     "update_command": {
                       "type": [
                         "string",
@@ -5847,6 +5850,7 @@
                     "build_date",
                     "env_label",
                     "latest",
+                    "update_available",
                     "update_command"
                   ],
                   "additionalProperties": false

package/docs/guides/api.md

@@ -179,7 +179,7 @@ default; Cerefox Local picks its own port and `cerefox-local status` prints it).
 
 | Method + path | Purpose |
 |---|---|
-| `GET /version` | Server version, environment label, and the newest release on npm as the server last checked it (`latest`, plus `update_command` when it is newer). |
+| `GET /version` | Server version, environment label, and the newest release on npm as the server last checked it (`latest`; `update_available` when it is newer, with `update_command` unless the server runs in a container, where it cannot tell how it was installed). |
 | `GET /schema-version` | Deployed schema version. |
 | `GET /openapi.json` | This API's OpenAPI 3.1 description, served by the version you are talking to. Every `/api/v1` response points at it with `Link: </api/v1/openapi.json>; rel="service-desc"` (RFC 8631). |
 | `GET /search?q=…` | Hybrid search (FTS + semantic). `&review_status=approved\|pending_review` filters server-side; `400` while the review workflow is off. The response's `embedder` (`openai` or `local`) says which scale the scores are on. |

package/docs/guides/setup-lan.md

@@ -218,6 +218,11 @@ case:
   machine, which `cerefox backup restore` can load into a new Cerefox, on the
   NAS or elsewhere.
 
+  A backup made on the NAS itself (`cerefox backup create` in the container's
+  terminal) is saved in the data folder, under `.cerefox-backups`, so it
+  survives a rebuild and the layers above include it. Before v1.22.1 it was
+  saved inside the container and lost on the next build (#359).
+
 ## B. The web container, with your Supabase backend
 
 You need a working Supabase-backed Cerefox first (see

package/docs/guides/setup-local.md

@@ -163,8 +163,18 @@ cerefox-local upgrade v1.2.3 # pin an exact version (also how you downgrade)
 cerefox-local upgrade --latest  # follow the moving :latest tag from now on
 cerefox-local uninstall          # remove the container, KEEP the data volume
 cerefox-local uninstall --purge  # remove the container AND delete the data volume (asks you to confirm; --yes in scripts)
+cerefox-local backup create      # JSON snapshot: kept in the data volume, copied to ~/.cerefox/local/backups
+cerefox-local backup restore ~/.cerefox/local/backups/cerefox-<stamp>.json
 ```
 
+**Backups.** `backup create` writes the snapshot into the data volume, so it
+survives `upgrade` and `init`, and copies it to `~/.cerefox/local/backups` on
+your machine, so it also survives losing the volume (`uninstall --purge`).
+`backup restore` takes a file on your machine and copies it into the container
+for you. Before v1.22.1 the snapshot stayed inside the container and the next
+`upgrade` or `init` deleted it (#359); the first upgrade to v1.22.1 still runs
+the old script, so make that one's backup from the new version, right after.
+
 > **Coming from an image older than v1.1.0?** Run `cerefox-local upgrade v1.1.1`
 > (an explicit tag) once. A bare `upgrade` on those versions re-pulled the pinned
 > tag and reported success without changing anything (#153), and it cannot fix
@@ -186,6 +196,7 @@ sync.
 | Container | name `cerefox-local` (override: `CEREFOX_LOCAL_CONTAINER`) |
 | Your data | Docker volume `cerefox_local_pgdata` (survives `stop`/`upgrade`) |
 | Host config | `~/.cerefox/local/.env` (OPENAI key + port only — **no token**) |
+| Backups | `~/.cerefox/local/backups` (override: `CEREFOX_LOCAL_BACKUP_DIR`), plus a copy in the volume's `.cerefox-backups` folder |
 | Host command | `~/.cerefox/local/cerefox-local`, symlinked to `~/.local/bin/cerefox-local` |
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cerefox/memory",
-  "version": "1.22.0",
+  "version": "1.22.2",
   "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).",
   "license": "Apache-2.0",
   "homepage": "https://github.com/fstamatelopoulos/cerefox",
@@ -40,21 +40,21 @@
   ],
   "dependencies": {
     "@hono/node-server": "^2.1.5",
-    "@modelcontextprotocol/sdk": "^1.32.1",
+    "@modelcontextprotocol/sdk": "^1.32.2",
     "@supabase/supabase-js": "^2.118.0",
     "cli-progress": "^3.12.0",
     "commander": "^15.0.0",
-    "hono": "^4.13.13",
+    "hono": "^4.13.14",
     "mammoth": "^1.13.0",
     "ora": "^9.4.0",
     "picocolors": "^1.0.0",
-    "postgres": "^3.4.9",
+    "postgres": "^4.0.0",
     "prompts": "^2.4.2",
     "smol-toml": "^1.9.1",
     "zod": "^4.6.7"
   },
   "optionalDependencies": {
-    "@huggingface/transformers": "^4.3.1",
+    "@huggingface/transformers": "^4.3.2",
     "onnxruntime-node": "^1.21.0"
   },
   "devDependencies": {