@cerefox/memory 1.1.0-beta.2 → 1.1.0-beta.4

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 (9) hide show
  1. package/dist/bin/cerefox.js +243 -168
  2. package/dist/frontend/assets/index-BLqrpbNz.js +121 -0
  3. package/dist/frontend/assets/index-BLqrpbNz.js.map +1 -0
  4. package/dist/frontend/index.html +1 -1
  5. package/docs/guides/configuration.md +2 -1
  6. package/docs/guides/content-format.md +18 -0
  7. package/package.json +1 -1
  8. package/dist/frontend/assets/index-CMNl_LF9.js +0 -121
  9. package/dist/frontend/assets/index-CMNl_LF9.js.map +0 -1
package/dist/frontend/index.html CHANGED
@@ -15,7 +15,7 @@
15
15
  href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600;700&display=swap"
16
16
  />
17
17
  <title>Cerefox</title>
18
- <script type="module" crossorigin src="/app/assets/index-CMNl_LF9.js"></script>
18
+ <script type="module" crossorigin src="/app/assets/index-BLqrpbNz.js"></script>
19
19
  <link rel="stylesheet" crossorigin href="/app/assets/index-C1JXZA9m.css">
20
20
  </head>
21
21
  <body>
package/docs/guides/configuration.md CHANGED
@@ -264,7 +264,8 @@ cerefox document get <document-id> --version-id <version-id>
264
264
 
265
265
  | Variable | Default | Description |
266
266
  |----------|---------|-------------|
267
- | `CEREFOX_BACKUP_DIR` | dev mode: `./backups` · user-state mode: `~/.cerefox/backups` (v0.3.0+) | Local directory where file system backups are stored. Created automatically if it doesn't exist. The default tracks the resolved config dir — dev users see no change. |
267
+ | `CEREFOX_BACKUP_DIR` | `~/.cerefox/backups` | Local directory where file system backups are stored. Created automatically if it doesn't exist. **Use an absolute path** — a relative value (such as the pre-v0.3.0 `./backups`) resolves against the current working directory, so snapshots scatter depending on where you run the command; `backup create` warns when it sees one. Does **not** follow `CEREFOX_CONFIG_DIR`, so a second environment must set it explicitly. |
268
+ | `CEREFOX_ENV_LABEL` | _(unset)_ | Names a non-production environment (e.g. `staging`). Purely cosmetic and inert when unset. When set: the web UI shows a banner on every page, `doctor` shows `[LABEL]` on its title line, `backup create` puts the label in the snapshot filename and payload, and `backup restore` warns when a snapshot's environment differs from the target's. See [`staging-env.md`](staging-env.md). |
268
269
  | `CEREFOX_VERSION_RETENTION_HOURS` | `48` | How long to retain archived document versions (hours). The most recent version is always kept regardless of this setting. |
269
270
 
270
271
  ---
package/docs/guides/content-format.md CHANGED
@@ -49,6 +49,24 @@ in — even after the current version has moved to format 2.
49
49
  > existing chunk rows; it never re-chunks, so it cannot advance the stored
50
50
  > format. Earlier versions of this guide said otherwise (#164).
51
51
 
52
+ > **Large stores: batch it.** Converting a few hundred documents or more is a
53
+ > heavy bulk rewrite — each one is re-chunked, its previous chunks archived as
54
+ > a version snapshot, and new rows inserted. A contributor reindexing a
55
+ > ~1,300-document store on Supabase depleted the project's **Disk IO Budget**
56
+ > and got a warning email: slower responses, CPU climbing on IO wait, and
57
+ > potentially a briefly unresponsive instance (it recovers once the budget
58
+ > refills). Nothing is corrupted, but prefer `--limit 200` in stages during a
59
+ > quiet period. The command warns above 500 documents and is resumable.
60
+
61
+ > **Requires v1.1.0-beta.4 or later.** On **v1.0.7 through v1.1.0-beta.3**
62
+ > `migrate-format` printed `Converted N` while converting nothing: it
63
+ > re-ingests byte-identical content by design, and the pipeline answered an
64
+ > unchanged content hash with a metadata-only update — no re-chunk, so no
65
+ > format advance. If you ran it on one of those versions, the documents are
66
+ > untouched and still on format 1 (no data was harmed and no embedding spend
67
+ > was incurred); re-run it on a current build. Check with `cerefox doctor`,
68
+ > which reports the real count.
69
+
52
70
  `cerefox doctor` reports how many documents still use the legacy format — purely
53
71
  informational, never a failure. A fresh install shows zero.
54
72
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cerefox/memory",
3
- "version": "1.1.0-beta.2",
3
+ "version": "1.1.0-beta.4",
4
4
  "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).",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://github.com/fstamatelopoulos/cerefox",