Function archiveNote

archiveNote(vault: Vault, args: ArchiveNoteArgs): Promise<RenameNoteResult>
Move a note into the archive folder, preserving every backlink.

Thin convenience wrapper around renameNote: computes the destination path (<archive_folder>/<basename>, flattened — no source folder is preserved), then delegates. Leading folders of the source are stripped so Inbox/Foo.md archives to Archive/Foo.md, not Archive/Inbox/Foo.md.
Parameters
- vault: Vault
  The vault. Must allow writes.
- args: ArchiveNoteArgs
  ArchiveNoteArgs. path is required.
Returns Promise<RenameNoteResult>
The same shape as renameNote.
Throws
If path is missing, the vault is read-only, or rename fails (e.g., destination exists without overwrite).
Example
```
await archiveNote(vault, {
  path: "Inbox/old-idea.md",
  archive_folder: "Archive/2026"
});
```
- Defined in tools/write.ts:490