Skip to content

v0.16.0

Choose a tag to compare

@github-actions github-actions released this 04 Nov 19:30
· 22 commits to main since this release

Security

Please update. This release hardens path limits (--allow-path, --deny-path) against symbolic links on a server vault. Details follow in an advisory.

Update your server first. With a path limit, this zn asks the server to mark links, and refuses with a clear message on a server that cannot: any server older than 2.82.1. The reason also shows in vault_info. Access-only limits such as --read-only, and clients with no limits, keep working on any server.

What's new

zn mcp can manage attachments and more (#34, #35). 11 new tools, 45 in all. Thank you, Asterythm.

  • read_asset: returns an image, text or an embedded file, up to 5 MiB.
  • upload_asset: adds a file from base64, up to 16 MiB, never overwriting, and returns the embed to paste into a note.
  • rename_asset, move_asset: also update the notes that link to the file.
  • duplicate_asset, delete_asset, restore_asset: deleting is soft, with an undo token. list_assets {deleted: true} lists what can be restored.
  • update_task: changes a task's due date, priority, @waiting, state, status or text.
  • daily_note: finds the note under the vault's own settings without changing anything.
  • note_sections, edit_section: list a note's headings, read the part under one, or append, prepend or replace it.

Purging deleted files is left out on purpose: it cannot be undone. With a path limit on a server, renaming, moving, reading and duplicating attachments are refused.

Fixes

  • A server switching its own vault no longer redirects zn mcp silently (#37). Calls stop until vault_info reports the new vault, so nothing lands in the wrong one.
  • Renaming a file in the TUI updates bare embeds and counts them as uses (#36). On a server older than 2.50.4 the rename still works, but embeds are not rewritten.
  • A renamed file that gains a space keeps its plain Markdown links working on a local vault.

How to test locally

T=$(mktemp -d); mkdir -p "$T/vault/inbox/Projects" "$T/vault/inbox/Private" "$T/vault/assets"
printf '# Plan\n\n![[photo.png]]\n' > "$T/vault/inbox/Projects/Plan.md"
printf '# Secret\n' > "$T/vault/inbox/Private/Secret.md"
printf 'x' > "$T/vault/assets/photo.png"
zn tui --vault "$T/vault"
  • In the Files view, rename photo.png. Before: Plan.md kept the old name. After: its embed follows the new name.
  • Connect an MCP client with zn mcp --vault "$T/vault" and list tools: 45.
  • Connect with zn mcp --vault "$T/vault" --allow-path inbox/Projects: list_notes shows only Plan, note_sections reads it, and read_note on inbox/Private/Secret.md answers "Note not found".