@cerefox/memory 1.8.0 → 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 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.
@@ -1,6 +1,6 @@
1
1
  # Cerefox Knowledge Base -- Agent Quick Reference
2
2
 
3
- Cerefox is a persistent, shared knowledge base. You have **19 MCP tools** (18 of them have CLI equivalents — `cerefox_get_help` is MCP-only). For the full guide, search Cerefox for "How AI Agents Use Cerefox" or call `cerefox_get_help` to retrieve this content over MCP.
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