Delete Memory Entry
vault_delete_memoryDelete one dated memory entry by exact date and text match, ensuring only the intended bullet is removed from a specified section in an About Me memory file.
Instructions
Delete a single dated entry from a memory file in About Me/. Both date and entry text are required for exact matching — ensures only the intended entry is removed.
Example: vault_delete_memory({ file: "Opinions", section: "AI tooling & memory (newest first)", date: "2026-05-01", entry: "Prefer X over Y" })
When to use: Removing an entry that was wrong when it was written — a mistake, a misattribution, or something never true. Memory files are append-only by default, so do NOT delete to reflect a change: append the new state via vault_update_memory instead (newest-first naturally supersedes). The exception is a file whose frontmatter declares entry-policy: living (check via vault_list_memory_files) — a current-state file where deleting an expired entry is the intended maintenance. Call vault_get_memory(file, section) first to see exact entry text for matching.
Prefer vault_delete_note for deleting entire non-protected notes.
Parameters:
date + entry together uniquely identify the bullet line within the given section. If multiple entries share the same date and text, deletion fails as ambiguous.
section scopes the match — an identical entry under a different heading is not found. Section matching is case-insensitive, with or without the "(newest first)" suffix.
Errors:
"memory file not found" — file does not exist in About Me/; call vault_list_memory_files to discover valid names.
"memory file must not start with a dot" / "memory file must be a bare name without path separators" — pass the file's bare name: no folder or slash, and no leading dot (that would target a hidden file; memory files are always visible notes).
"date must be a real ISO calendar date" — date only accepts an existing calendar date in bare YYYY-MM-DD form. A hand-edited bullet carrying an impossible date cannot be targeted by this tool — remove it with vault_delete_span or a manual edit.
"section not found: …" — no H2 heading matches; the error lists the file's available sections
"no entry matching …" — no bullet matched the given date and entry text; verify exact text via vault_get_memory(file, section).
"ambiguous: N entries match …" — more than one identical bullet exists in the section (e.g. from hand edits, sync conflicts, or entries predating duplicate protection; vault_update_memory refuses to write exact duplicates). Remove the extra copy with vault_delete_span (pass first_match: true — identical lines make every anchor ambiguous) or a manual edit, then retry.
"refusing memory write: … would shrink content" — safety guard blocked a write that would remove more than half the file. Re-read with vault_get_memory to confirm current content; an entry that really is that large needs vault_delete_span or a manual edit.
Returns: Confirmation message.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | ISO YYYY-MM-DD date of the entry (e.g. "2026-05-01"). Must match the date shown by vault_get_memory. | |
| file | Yes | Memory file name without .md (e.g. "Principles"). Use the exact letter case. | |
| entry | Yes | Exact entry text as shown by vault_get_memory — without the "- **YYYY-MM-DD**: " prefix or bullet. | |
| section | Yes | H2 section heading containing the entry. Matched case-insensitively, with or without the "(newest first)" suffix. |