@cerefox/memory 1.0.7 → 1.0.8

package/dist/bin/cerefox.js

@@ -7184,7 +7184,7 @@ var exports_meta = {};
 __export(exports_meta, {
   PKG_VERSION: () => PKG_VERSION
 });
-var PKG_VERSION = "1.0.7";
+var PKG_VERSION = "1.0.8";
 var init_meta = () => {};
 
 // ../../node_modules/.bun/tslib@2.8.1/node_modules/tslib/tslib.js
@@ -75039,7 +75039,7 @@ import { homedir as homedir6 } from "node:os";
 import { join as join9 } from "node:path";
 
 // ../../_shared/ef-meta/index.ts
-var EF_VERSION = "1.0.7";
+var EF_VERSION = "1.0.8";
 var EF_LAST_CHANGED = "1.0.6";
 
 // src/cli/util/checks.ts

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.0.7";
+export const EF_VERSION = "1.0.8";
 
 /**
  * The most recent version whose EF-side SOURCE actually changed (#127).

package/docs/guides/cli.md

@@ -544,6 +544,42 @@ Detects fresh vs. existing databases: a fresh DB gets schema + RPCs + migration
 | `--all` | flag | off | Reindex every chunk regardless of embedder. |
 | `--dry-run` | flag | off | Count what would be re-embedded; do nothing. |
 
+> **Reindex refreshes embeddings only.** It rewrites `embedding_primary` on
+> existing chunk rows and never re-chunks, so it cannot change a document's
+> stored `content_format`. Use `server migrate-format` for that (#164).
+
+---
+
+### `cerefox server migrate-format`
+
+**Purpose**: convert documents still stored under the legacy chunk-reconstruction
+format to the current one, by re-ingesting them through the normal pipeline
+(re-chunk → re-embed → stamp the current format). `cerefox doctor` reports how
+many documents are affected.
+
+**Synopsis**: `cerefox server migrate-format [OPTIONS]`
+
+**Options**:
+
+| Flag | Type | Default | Description |
+|---|---|---|---|
+| `--dry-run` | flag | off | Report how many documents would convert; write nothing. |
+| `-l, --limit <n>` | int | all | Convert at most N documents (re-run to continue). |
+| `--document-id <uuid>` | string | — | Convert a single document. |
+| `--author <name>` | string | `CEREFOX_AUTHOR_NAME` | Recorded in the audit log per conversion. |
+
+**This costs embedding spend** — every converted document is re-embedded — so it
+is opt-in and never runs automatically. Legacy-format documents are *not*
+broken: they reconstruct exactly as they always have, and convert on their own
+the next time they are edited. Each conversion runs under optimistic
+concurrency, so a document edited mid-run is skipped rather than overwritten,
+and documents whose content is byte-identical to another document cannot be
+converted (the ingestion pipeline's dedup check rejects them) — those are
+reported rather than failing the run.
+
+**Take a backup first** (`cerefox backup create`). The previous chunks are
+archived as a document version, but version retention defaults to 48 hours.
+
 ---
 
 ### `cerefox token generate` / `cerefox token rotate` / `cerefox token list`

package/docs/guides/migration-1.0.md

@@ -61,7 +61,9 @@ The migration is **lazy and safe**:
 - Existing documents keep the legacy format and reconstruct **exactly as before** — nothing
   re-processes, nothing re-embeds.
 - A document moves to the new format automatically the next time it is edited/saved. To
-  convert everything now instead, run `cerefox server reindex`.
+  convert everything now instead, run `cerefox server migrate-format` (it re-chunks and
+  re-embeds, so try `--dry-run` first). **Not `server reindex`** — that refreshes
+  embeddings on existing chunks and cannot change the stored format (#164).
 - `cerefox doctor` shows how many documents still use the legacy format.
 
 Details: `cerefox guides show content-format` (or [`content-format.md`](content-format.md)).

package/docs/guides/ops-scripts.md

@@ -126,7 +126,7 @@ bun scripts/backup_create.ts && bun scripts/db_migrate.ts
 
 ## backup_create.ts — Create a backup
 
-Exports all documents, chunks, and metadata to a JSON file in the backup directory. (End users use `cerefox backup create`.)
+Exports all documents, chunks, metadata, **projects and project memberships** to a JSON file in the backup directory. (End users use `cerefox backup create`.)
 
 ```bash
 bun scripts/backup_create.ts [OPTIONS]
@@ -153,7 +153,7 @@ Output: `backup-data/cerefox-20260308T143022Z-before-v2-migration.json`
 
 ## backup_restore.ts — Restore from a backup
 
-Restores documents and chunks from a previously created backup file. Idempotent — documents with the same content hash are skipped. (End users use `cerefox backup restore`.)
+Restores documents, chunks, projects and project memberships from a previously created backup file. Idempotent — documents with the same content hash are skipped, and projects/memberships are upserted. Snapshots taken before v1.0.7 contain no memberships; restoring one warns and recreates documents only. (End users use `cerefox backup restore`.)
 
 ```bash
 bun scripts/backup_restore.ts BACKUP_FILE [OPTIONS]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cerefox/memory",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Cerefox — 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",