@cerefox/memory 0.6.0 → 0.7.0
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.
- package/dist/bin/cerefox.js +2701 -1742
- package/dist/frontend/assets/{index-B-Yx2yjM.js → index-CPiXnnCV.js} +29 -29
- package/dist/frontend/assets/index-CPiXnnCV.js.map +1 -0
- package/dist/frontend/index.html +1 -1
- package/docs/guides/migration-v0.5.md +98 -0
- package/package.json +2 -1
- package/dist/frontend/assets/index-B-Yx2yjM.js.map +0 -1
package/dist/frontend/index.html
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
<link rel="icon" href="/static/cerefox_logo.jpg" />
|
|
6
6
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
7
7
|
<title>Cerefox</title>
|
|
8
|
-
<script type="module" crossorigin src="/app/assets/index-
|
|
8
|
+
<script type="module" crossorigin src="/app/assets/index-CPiXnnCV.js"></script>
|
|
9
9
|
<link rel="stylesheet" crossorigin href="/app/assets/index-DoDJGRih.css">
|
|
10
10
|
</head>
|
|
11
11
|
<body>
|
|
@@ -402,6 +402,104 @@ the banner prominent; v0.9 deletes the Python web code.
|
|
|
402
402
|
|
|
403
403
|
---
|
|
404
404
|
|
|
405
|
+
## v0.7.0 completes the TS migration arc
|
|
406
|
+
|
|
407
|
+
**TL;DR**: the 3 ingestion endpoints that returned 503 in v0.6 now
|
|
408
|
+
work. `cerefox ingest` and `cerefox ingest-dir` run in-process (no
|
|
409
|
+
Edge Function round-trip). `cerefox reindex` (a v0.5 deferred stub)
|
|
410
|
+
is a real command. PDF/DOCX support dropped. Python web prints a
|
|
411
|
+
deprecation banner. Python MCP server keeps working unchanged.
|
|
412
|
+
|
|
413
|
+
### The 503 toast is gone
|
|
414
|
+
|
|
415
|
+
If you saw "Ingestion lands in v0.7 — use `cerefox ingest <file>` from
|
|
416
|
+
the CLI for now" anywhere in the web UI during v0.6, that's gone in
|
|
417
|
+
v0.7. The 3 ingestion endpoints (`POST /api/v1/ingest`,
|
|
418
|
+
`POST /api/v1/ingest/file`, `POST /api/v1/documents/{id}/upload`) now
|
|
419
|
+
call the in-process TS pipeline. The frontend's
|
|
420
|
+
`V07IngestionDeferredError` toast detector stays in `api/client.ts`
|
|
421
|
+
as dead code — no churn there, just stops firing.
|
|
422
|
+
|
|
423
|
+
### CLI gets faster (no EF round-trip)
|
|
424
|
+
|
|
425
|
+
`cerefox ingest <file>` and `cerefox ingest-dir <dir>` pre-v0.7 made
|
|
426
|
+
an HTTP call to the `cerefox-ingest` Edge Function (Deno on Supabase).
|
|
427
|
+
In v0.7+ they run the in-process TS pipeline directly: chunk +
|
|
428
|
+
embed + atomic RPC, all in the same Bun/Node process. Faster + no
|
|
429
|
+
network egress to Supabase Functions (only to Postgres + OpenAI).
|
|
430
|
+
|
|
431
|
+
`cerefox reindex` is no longer a v0.5 stub. It re-embeds chunks via
|
|
432
|
+
the same in-process pipeline. Defaults to stale-only (chunks with a
|
|
433
|
+
different embedder model recorded); `--all` reindexes everything.
|
|
434
|
+
`--batch <n>` controls the batch size. `--document-id <uuid>` scopes
|
|
435
|
+
to one doc. `--dry-run` previews.
|
|
436
|
+
|
|
437
|
+
### PDF / DOCX support dropped
|
|
438
|
+
|
|
439
|
+
The `src/cerefox/chunking/converters.py` module and its tests are
|
|
440
|
+
deleted. The Python CLI's `.pdf` / `.docx` branches now print a clear
|
|
441
|
+
"support dropped in v0.7.0" error pointing at pandoc / docling for
|
|
442
|
+
client-side conversion. The TS surfaces never had PDF/DOCX support;
|
|
443
|
+
no UX change there.
|
|
444
|
+
|
|
445
|
+
If you were using the Python CLI to ingest PDFs/DOCXs: convert them
|
|
446
|
+
to markdown client-side first (`pandoc input.pdf -o input.md` or
|
|
447
|
+
similar), then ingest the .md.
|
|
448
|
+
|
|
449
|
+
### Python web shows a deprecation banner
|
|
450
|
+
|
|
451
|
+
`uv run cerefox web` now prints a yellow ⚠ deprecation banner at
|
|
452
|
+
startup:
|
|
453
|
+
|
|
454
|
+
```
|
|
455
|
+
⚠ Cerefox Python web server is deprecated as of v0.7.0.
|
|
456
|
+
The canonical web UI is `cerefox web` from `@cerefox/memory`
|
|
457
|
+
(npm install -g @cerefox/memory). The Python web stays through
|
|
458
|
+
v0.7.x and v0.8 as a husk; consider switching now.
|
|
459
|
+
See docs/guides/migration-v0.5.md § v0.7 for the migration path.
|
|
460
|
+
```
|
|
461
|
+
|
|
462
|
+
The Python web stays through v0.7.x and v0.8 (likely as a husk that
|
|
463
|
+
returns 503 on every route in v0.8). v0.9's call on the Python web is
|
|
464
|
+
TBD per the iter-26 design pass. Switch to `cerefox web` from npm
|
|
465
|
+
when you can — it's been functionally complete since v0.6 + has had
|
|
466
|
+
ingestion since v0.7.
|
|
467
|
+
|
|
468
|
+
### Python MCP server stays unchanged
|
|
469
|
+
|
|
470
|
+
Per the "Python minimization, not removal" policy locked at iter-24,
|
|
471
|
+
the Python MCP server stays fully functional through v0.9+. If you
|
|
472
|
+
check out the repo and run `uv run cerefox mcp`, that keeps working
|
|
473
|
+
indefinitely. `CerefoxClient` stays in the Python tree for the same
|
|
474
|
+
reason — MCP uses it.
|
|
475
|
+
|
|
476
|
+
### Scripts: 3 ported, 2 stay Python
|
|
477
|
+
|
|
478
|
+
| Script | Status in v0.7.0 |
|
|
479
|
+
|---|---|
|
|
480
|
+
| `scripts/db_deploy.py` | Husk; use `bun scripts/db_deploy.ts` |
|
|
481
|
+
| `scripts/db_migrate.py` | Husk; use `bun scripts/db_migrate.ts` |
|
|
482
|
+
| `scripts/reindex_all.py` | Husk; use `bun scripts/reindex_all.ts` |
|
|
483
|
+
| `scripts/backup_create.py` | Stays Python through v0.7.x (port deferred) |
|
|
484
|
+
| `scripts/backup_restore.py` | Stays Python through v0.7.x (port deferred) |
|
|
485
|
+
|
|
486
|
+
The Postgres client used by `db_deploy.ts` / `db_migrate.ts` is the
|
|
487
|
+
`postgres` (Porsager) library — small, well-typed, no native deps.
|
|
488
|
+
Cross-runtime (Bun + Node).
|
|
489
|
+
|
|
490
|
+
### Should I upgrade from v0.6.0 to v0.7.0?
|
|
491
|
+
|
|
492
|
+
| Workflow | Recommendation |
|
|
493
|
+
|---|---|
|
|
494
|
+
| Web UI for ingestion | **Yes — that's the whole point.** v0.6 sent you to the CLI for ingest; v0.7 has it in the browser. |
|
|
495
|
+
| MCP client only (Claude Code, Cursor, etc.) | Yes — no functional change for you, but you'll get the v0.7 npm cleanup. |
|
|
496
|
+
| `cerefox` CLI | Yes — faster ingest paths + working reindex. |
|
|
497
|
+
| `uv run cerefox web` (Python) | Optional — banner appears; can ignore for now. v0.8 will make this prominent. |
|
|
498
|
+
| `uv run cerefox mcp` (Python) | No-op — Python MCP unchanged. |
|
|
499
|
+
| PDF/DOCX ingest via Python CLI | Convert to markdown client-side before upgrading. |
|
|
500
|
+
|
|
501
|
+
---
|
|
502
|
+
|
|
405
503
|
## Known gotchas
|
|
406
504
|
|
|
407
505
|
### `npx` from inside an npm workspace
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cerefox/memory",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.0",
|
|
4
4
|
"description": "Cerefox — user-owned shared memory for AI agents. The local TypeScript runtime: stdio MCP server in v0.4; CLI binary added in v0.5; in-process web server in v0.6; ingestion pipeline in v0.7.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"homepage": "https://github.com/fstamatelopoulos/cerefox",
|
|
@@ -46,6 +46,7 @@
|
|
|
46
46
|
"commander": "^12.1.0",
|
|
47
47
|
"hono": "^4.12.23",
|
|
48
48
|
"picocolors": "^1.0.0",
|
|
49
|
+
"postgres": "^3.4.9",
|
|
49
50
|
"prompts": "^2.4.2",
|
|
50
51
|
"smol-toml": "^1.6.1",
|
|
51
52
|
"zod": "^3.23.0"
|