@cerefox/memory 1.7.1 → 1.9.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/AGENT_GUIDE.md +13 -0
- package/AGENT_QUICK_REFERENCE.md +1 -1
- package/README.md +4 -0
- package/dist/bin/cerefox.js +325 -99
- package/dist/frontend/assets/index-DWT7wZMR.js +121 -0
- package/dist/frontend/assets/index-DWT7wZMR.js.map +1 -0
- package/dist/frontend/index.html +1 -1
- package/dist/server-assets/_shared/ef-meta/index.ts +3 -3
- package/dist/server-assets/_shared/mcp-tools/_projects.ts +76 -51
- package/dist/server-assets/_shared/mcp-tools/_utils.ts +45 -0
- package/dist/server-assets/_shared/mcp-tools/audit-log.ts +3 -5
- package/dist/server-assets/_shared/mcp-tools/audit-ops.ts +46 -0
- package/dist/server-assets/_shared/mcp-tools/get-help-content.ts +1 -1
- package/dist/server-assets/_shared/mcp-tools/ingest.ts +6 -6
- package/dist/server-assets/db/migrations/0025_drop_orphaned_overloads.sql +2 -1
- package/dist/server-assets/db/migrations/0027_drop_archived_search_artifacts.sql +172 -0
- package/dist/server-assets/db/migrations/0028_audit_store_level_writes.sql +349 -0
- package/dist/server-assets/db/rpcs.sql +270 -64
- package/dist/server-assets/db/schema.sql +18 -4
- package/dist/server-assets/supabase/functions/cerefox-ingest/index.ts +14 -97
- package/docs/guides/cli.md +13 -2
- package/docs/guides/connect-agents.md +4 -19
- package/docs/guides/ops-scripts.md +4 -4
- package/docs/guides/upgrading.md +14 -1
- package/package.json +2 -2
- package/dist/frontend/assets/index-D8E0mTnp.js +0 -121
- package/dist/frontend/assets/index-D8E0mTnp.js.map +0 -1
package/AGENT_GUIDE.md
CHANGED
|
@@ -356,6 +356,19 @@ Cheap and idempotent. Call it any time you're uncertain about a convention (link
|
|
|
356
356
|
|
|
357
357
|
---
|
|
358
358
|
|
|
359
|
+
### Dormant relation tools
|
|
360
|
+
|
|
361
|
+
Four additional tools exist but are hidden unless the operator has set `relations_enabled=true` (default false). If you don't see them, they are off — don't ask for them.
|
|
362
|
+
|
|
363
|
+
| Tool | Purpose |
|
|
364
|
+
|------|---------|
|
|
365
|
+
| `cerefox_set_relation` | Link two documents (`source --rel_type--> target`). |
|
|
366
|
+
| `cerefox_delete_relation` | Remove a relation. |
|
|
367
|
+
| `cerefox_get_relations` | List all relations touching a document, both directions. |
|
|
368
|
+
| `cerefox_get_neighbors` | Walk the graph along one relation type, cycle-safe. |
|
|
369
|
+
|
|
370
|
+
---
|
|
371
|
+
|
|
359
372
|
## Choosing a retrieval tool: `cerefox_search` vs `cerefox_metadata_search`
|
|
360
373
|
|
|
361
374
|
These two tools have **different contracts**. Picking the wrong one is the most common retrieval mistake.
|
package/AGENT_QUICK_REFERENCE.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Cerefox Knowledge Base -- Agent Quick Reference
|
|
2
2
|
|
|
3
|
-
Cerefox is a persistent, shared knowledge base. You have **
|
|
3
|
+
Cerefox is a persistent, shared knowledge base. You have **15 core MCP tools** (14 with CLI equivalents — `cerefox_get_help` is MCP-only), plus 4 dormant relation tools that appear only when `relations_enabled` is on. For the full guide, search Cerefox for "How AI Agents Use Cerefox" or call `cerefox_get_help` to retrieve this content over MCP.
|
|
4
4
|
|
|
5
5
|
## Tools
|
|
6
6
|
|
package/README.md
CHANGED
|
@@ -173,6 +173,10 @@ never your data.
|
|
|
173
173
|
```bash
|
|
174
174
|
cerefox search "second brain" # hybrid (FTS + semantic)
|
|
175
175
|
cerefox document ingest notes.md --project "Personal" # add a doc
|
|
176
|
+
cerefox document get <id> --section "## Heading" # read one section
|
|
177
|
+
cerefox document set-metadata <id> --set-meta k='"v"' # metadata-only write
|
|
178
|
+
cerefox document delete <id> # soft-delete (restore undoes it)
|
|
179
|
+
cerefox document dead-links # sweep for dead document links
|
|
176
180
|
cerefox project list # discover projects
|
|
177
181
|
cerefox metadata search --metadata-filter '{"type":"decision-log"}'
|
|
178
182
|
cerefox audit list --since 2026-05-01 # immutable history
|