From e9fc91dbc8314a25a0d71b7ee4344d3fc4ccfd5e Mon Sep 17 00:00:00 2001 From: Anders Betts Date: Fri, 18 Sep 2026 22:16:32 +0200 Subject: attachments: link/unlink from the TUI, multi-voucher links MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The voucher detail can attach a file to an existing voucher (^F) and the underlag picker (f) can remove a link (d, confirmed). The Underlag inbox links a highlighted item to a voucher picked from a list (k). attachment.link and attachment.unlink are new write commands (dry-run, audited); unlinked files return to the inbox. The same content may now link to several vouchers — only the same voucher/attachment pair is a CONFLICT, matching the table's primary key. --- docs/PROTOCOL.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) (limited to 'docs/PROTOCOL.md') diff --git a/docs/PROTOCOL.md b/docs/PROTOCOL.md index e3e629b..75f384f 100644 --- a/docs/PROTOCOL.md +++ b/docs/PROTOCOL.md @@ -351,11 +351,17 @@ required. |---|---|---| | `attachment.put` | `filename`, `mime`, `content_base64`, `voucher_id?` | ≤ max_attachment_bytes | | `attachment.get` | `id` | returns base64 + sha256 | +| `attachment.link` | `id`, `voucher_id` | write; audited | +| `attachment.unlink` | `id`, `voucher_id` | write; audited | | `attachment.list` | `voucher_id?`, `unlinked?`, `limit`, `cursor` | inbox = `unlinked:true` | Attachments are immutable and content-addressed by SHA-256. They are linked to vouchers at posting time (`attachment_ids`) or afterwards via -`attachment.put` with `voucher_id`; links are separate insert-only rows. +`attachment.put` with `voucher_id` or `attachment.link`; links are audited +rows, and `attachment.unlink` removes one (an unlinked attachment returns +to the inbox). One attachment may be linked to several vouchers (the link +key is the voucher/attachment pair); linking the same pair twice is a +`CONFLICT`. ### 7.6 Reports -- cgit v1.3