soulcraft/brainy
1
0
Fork 0
Code Issues 1 Pull requests Projects Releases 335 Packages Wiki Activity Actions

docs(8.0): drop the DeletedItemsIndex section + pseudo-code from index-architecture

Browse source 
The dead-code sweep removed `src/utils/deletedItemsIndex.ts` (a utility class
the doc itself noted was "not instantiated"). Remove its "Notes on Other
Indexes" section and the two illustrative `this.deletedItemsIndex.*` lines in
the find()/stats() pseudo-code so the architecture doc no longer references a
deleted, never-wired module.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
David Snelling 2026-06-24 15:50:49 -07:00
parent d321cf5f33
commit e7b50cf520
1 changed files with 0 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

16
docs/architecture/index-architecture.md
View file

@ -578,16 +578,6 @@ const reachable = await this.graphIndex.traverse({
// Complexity: O(V + E) breadth-first search, but each neighbor lookup is O(1)
```
## Notes on Other Indexes
### DeletedItemsIndex (Not Currently Used)
**Status**: Utility class exists in `src/utils/deletedItemsIndex.ts` but is **not instantiated** in the Brainy class.
**Purpose** (if used): O(1) tracking of soft-deleted items without removing data.
**Current Behavior**: Brainy uses hard deletes via `storage.deleteNoun()` and `storage.deleteVerb()`. Soft-delete functionality is not currently integrated.
## Shared Memory Management: UnifiedCache
All three main indexes share a single **UnifiedCache** instance for coordinated memory management.
@ -684,9 +674,6 @@ async find(query: FindQuery): Promise<Result[]> {
results = results.filter(r => connectedIds.includes(r.id))
}
// Step 4: Filter deleted items
results = results.filter(r => !this.deletedItemsIndex.isDeleted(r.id))
return results
}
```
@ -728,9 +715,6 @@ async stats(): Promise<Statistics> {
relationships: this.graphIndex.getTotalRelationshipCount(),
relationshipTypes: this.graphIndex.getRelationshipCountsByType(),
// From deleted items index
deletedItems: this.deletedItemsIndex.getDeletedCount(),
// From vector index
vectorIndexSize: this.index.getSize()
}