@cerefox/memory 1.7.0 → 1.8.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
@@ -478,7 +478,7 @@ Call `cerefox_list_metadata_keys` for the current list -- conventions evolve.
478
478
 
479
479
  ## Writing linkable content
480
480
 
481
- Documents you ingest may contain markdown links to other Cerefox documents. The Cerefox web UI intercepts these links at click time and resolves them to the target document. The resolution happens entirely in the browser; the stored markdown is untouched.
481
+ Documents you ingest may contain markdown links to other Cerefox documents. The Cerefox web UI intercepts these links at click time and resolves them to the target document. The resolution happens entirely in the browser; the stored markdown is untouched. (User-facing overview of the whole linking system, including *why* long ids corrupt during regeneration: [`docs/guides/linking.md`](docs/guides/linking.md).)
482
482
 
483
483
  ### The rule for agents: use document UUIDs
484
484
 
@@ -502,9 +502,9 @@ same-turn-fixable error. Three things to know:
502
502
  mechanism, and it is just correct markdown authoring.
503
503
  - **Only links your write introduces are validated on updates.** A dead
504
504
  link the document already carried (its target purged after linking) does
505
- not block your unrelated edit — legacy dead links are found by the
506
- dead-link sweep (#214 phase 2), not by holding your edit hostage. New
507
- documents validate every link.
505
+ not block your unrelated edit — legacy dead links are found on demand by
506
+ the sweep (`cerefox document dead-links`, CLI), not by holding your edit
507
+ hostage. New documents validate every link.
508
508
 
509
509
  `[[Wikilinks]]` are NOT validated — they remain the sanctioned form for
510
510
  "flag a document to create later."