@cerefox/memory 1.7.1 → 1.9.0

package/docs/guides/connect-agents.md

@@ -638,7 +638,7 @@ In the action editor, paste this schema (replace `<your-project-ref>`):
 openapi: 3.1.0
 info:
   title: Cerefox Knowledge Base
-  version: 3.2.0
+  version: 3.3.0
 servers:
   - url: https://<your-project-ref>.supabase.co/functions/v1
 paths:
@@ -934,7 +934,9 @@ paths:
                   type: string
                   description: >
                     Filter by operation type: create, update-content, update-metadata,
-                    delete, status-change, archive, unarchive (optional)
+                    insert, replace-section, delete-section, rename-section, delete,
+                    restore, status-change, archive, unarchive, config-change,
+                    project-create, project-edit, project-delete (optional)
                 since:
                   type: string
                   description: ISO timestamp lower bound for temporal queries (optional)
@@ -1490,23 +1492,6 @@ neighbours** (±`p_window_size` chunks within the same document).
 Returns: `chunk_id`, `document_id`, `chunk_index`, `title`, `content`, `heading_path`,
 `heading_level`, `doc_title`, `is_seed` (TRUE for the original seed chunks)
 
-#### `cerefox_save_note`
-
-Create a document record directly. The note is stored but **not embedded** — use `cerefox-ingest`
-Edge Function instead for notes that need to be immediately searchable.
-
-| Parameter | Type | Default | Description |
-|-----------|------|---------|-------------|
-| `p_title` | TEXT | required | Note title |
-| `p_content` | TEXT | required | Markdown content |
-| `p_source` | TEXT | `'agent'` | Origin label |
-| `p_project_id` | UUID | null | Project to assign |
-| `p_metadata` | JSONB | `{}` | Metadata (agent name, tags, etc.) |
-
-Returns: `id`, `title`, `created_at`
-
----
-
 ### Metadata RPCs
 
 #### `cerefox_list_metadata_keys`

package/docs/guides/ops-scripts.md

@@ -80,9 +80,9 @@ bun scripts/db_status.ts          # human-readable report
 bun scripts/db_status.ts --json   # structured JSON output
 ```
 
-Reports:
-- Tables: `cerefox_documents`, `cerefox_chunks`, `cerefox_document_versions`, `cerefox_projects`, `cerefox_document_projects`, `cerefox_audit_log`, `cerefox_migrations`
-- RPC functions: hybrid_search, fts_search, semantic_search, reconstruct_doc, save_note, search_docs, context_expand, snapshot_version, get_document, list_document_versions, ingest_document, delete_document, create_audit_entry, list_audit_entries, list_metadata_keys, update_chunk_fts, **`cerefox_schema_version`** (new in v0.3.0), **`cerefox_pg_function_exists`** (new in v0.3.0)
+Reports (the expected lists live in `_shared/db-status/index.ts` — the single source of truth):
+- Tables: `cerefox_projects`, `cerefox_documents`, `cerefox_document_versions`, `cerefox_audit_log`, `cerefox_document_projects`, `cerefox_chunks`, `cerefox_migrations`, `cerefox_usage_log`, `cerefox_config`, `cerefox_document_relations`
+- RPC functions: set_updated_at, hybrid_search, fts_search, semantic_search, reconstruct_doc, list_projects, log_usage, list_metadata_keys, snapshot_version, get_document, list_document_versions, create_audit_entry, list_audit_entries, ingest_document, delete_document, restore_document, purge_document, set_config, create_project, update_project, delete_project, set_document_metadata, find_dead_links, metadata_health, metadata_search, update_chunk_fts, `cerefox_schema_version`, `cerefox_pg_function_exists`
 - Row counts per table
 - **Schema-version mismatch**: compares the `@version` marker in the bundled `schema.sql` against the deployed `cerefox_schema_version()` RPC. Non-zero exit if they differ (the same check powers the web UI's schema-mismatch banner).
 
@@ -114,7 +114,7 @@ bun scripts/db_migrate.ts [OPTIONS]
 
 On a freshly deployed database, `db_migrate.ts` is always a no-op — `db_deploy.ts` has already stamped all existing migrations.
 
-Migration files live in `src/cerefox/db/migrations/` and are applied in filename order (`0001_...`, `0002_...`). Each file is applied exactly once; applied filenames are recorded in the `cerefox_migrations` table.
+Migration files live in `src/cerefox/db/migrations/` and are applied in filename order (`0001_...`, `0002_...`). Each file is applied exactly once; applied filenames are recorded in the `cerefox_migrations` table. Recent migrations (0023–0027) include data migrations that print what they did (0027 reports reclaimed space); see [`docs/guides/upgrading.md`](upgrading.md).
 
 Always run a backup before migrating:
 

package/docs/guides/upgrading.md

@@ -136,7 +136,7 @@ a linked Supabase project.
 
 ## Notable cross-version transitions
 
-Most upgrades need nothing beyond the steps above. Two transitions are worth
+Most upgrades need nothing beyond the steps above. A few transitions are worth
 knowing about:
 
 - **v0.9 — CLI verbs moved to a resource-verb shape** (`cerefox document get`,
@@ -149,6 +149,19 @@ knowing about:
   `@cerefox/memory` npm package (CLI, MCP server, web server, ingestion). If
   you're coming from a pre-installer 0.1.x clone, see the "old pre-installer
   clone" note above: install the package and run `cerefox init`.
+- **v1.5.0 — heading-duplication refusal.** Documents with duplicate headings
+  that ingested fine before now need deduplication, or are refused on edit.
+- **v1.7.0 — trashed documents refuse content updates.** A soft-deleted
+  document must be restored before its content can be updated.
+
+## Notable: v1.8.0 storage reclaim (migration 0027)
+
+Upgrading to v1.8.0 strips never-read search artifacts from archived version
+chunks (rationale: #216 / the migration's own header) and the migration
+prints what it freed. Postgres releases the bytes for **reuse** via
+autovacuum rather than shrinking files immediately, so expect growth to stop
+rather than the reported database size to drop the same day. Archived
+version *content* is untouched.
 
 ## After upgrading: AI agents
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cerefox/memory",
-  "version": "1.7.1",
+  "version": "1.9.0",
   "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",
@@ -65,7 +65,7 @@
     "typescript": "^6.0.3"
   },
   "scripts": {
-    "build": "bun build src/bin/cerefox.ts --outdir dist/bin --target node --format esm --external @huggingface/transformers --external onnxruntime-node",
+    "build": "bun run bundle-server-assets && bun build src/bin/cerefox.ts --outdir dist/bin --target node --format esm --external @huggingface/transformers --external onnxruntime-node",
     "clean": "rm -rf dist docs AGENT_GUIDE.md AGENT_QUICK_REFERENCE.md",
     "bundle-docs": "bun run ../../scripts/bundle_package_docs.ts",
     "bundle-server-assets": "bun run ../../scripts/bundle_server_assets.ts",