Reports: make the entry title itself the link, drop :LINK: property

A report subheading's title is now the link to the heading it's about
(org [[target][description]] syntax, description = the short title),
instead of a separate :LINK: property in a properties drawer. Plain text
title when there's no single heading to link. Further links, if needed,
go inline in the signed body.
This commit is contained in:
marc committed 2026-11-09 10:56:03 +01:00
1 parent 18c8284349
commit b9d1f96563
4 files changed
+6 -12

No files matched your search

+2 -5
View File
@@ -73,14 +73,11 @@ diwan's own operational file, at the root of the content repo — not a place fo
Every notable thing a diwan agent does — a tick dispatching something new, a tick triaging a batch of inbox items, a `do` session finishing a real piece of work — gets its own short subheading under the top-level "Reports" heading in `diwan.org`. One entry per notable thing, not one giant paragraph per run: this is what keeps each entry short and the whole log skimmable with everything collapsed. **Whoever actually did the thing writes the entry** — `diwan tick` reports its own actions (triage moves, inline answers, promotions, new dispatches), and a `diwan do` session reports its *own* progress once it has something worth telling the user, not before. In particular: a tick merely nudging an idle active session (see the `:session:` section above) is not itself reportable — tick has no idea yet whether anything came of it, so it stays silent; if the nudge leads the session to actually do something, that session writes the entry once it has.
Format: a `[ ]`/`[X]` checkbox right in the subheading title (same pattern as `Close diwan session`), a short title, an optional `:LINK:` property pointing at the one heading the entry is most about (fuzzy heading link, or `id:` link for a note file with an `:ID:` drawer — skip it if there's no single heading to point at), and a signed one-or-two-line body, no more:
Format: a `[ ]`/`[X]` checkbox right in the subheading title (same pattern as `Close diwan session`), a short title that *is itself the link* to the one heading the entry is most about (fuzzy heading link, or `id:` link for a note file with an `:ID:` drawer — just plain text with no link if there's no single heading to point at), and a signed one-or-two-line body, no more. No `:LINK:` property, no properties drawer at all — any further links belong inline in the body text:
```org
* Reports
** [ ] Dispatched kitchen redecoration
:PROPERTIES:
:LINK: [[file:personal.org::*Plan the kitchen redecoration][Plan the kitchen redecoration]]
:END:
** [ ] [[file:personal.org::*Plan the kitchen redecoration][Dispatched kitchen redecoration]]
[diwan 2026-11-08] Non-trivial, dispatched as do-kitchen.
** [X] Triaged 2 inbox items
[diwan 2026-11-07] Moved into esdeveniments.org and personal.org.