docs/generated/vocabulary.mdgenerated from code
Reference · 4 min read
notification_kind
Vocabulary: notification_kind.
Read as
Kinds of notification: a notification's kind. A notification names who sent it, where, and when, never what they wrote; read its content with notifications.read.
| Value | Meaning |
|---|---|
event | An event addressed to you (discussion:owner/515): a plugin's (<plugin>.<name>, such as messaging.mention), or core's. Its metadata names the event's kind, address, and fold key; its content is the event's body, read with notifications.read. |
announce | Another peer's write notification: it is about to change, or has just changed, a range of a file (discussion:owner/513). |
stale_save | A save of yours to a tree file was applied on an older version of the file than the one it replaced, so others' changes between them may be merged into it. |
refused_write | A write of yours to a tree file was refused and not shared: it names the path, and its content gives the refusal's reason and how to recover. A cause that clears by itself (a grant arriving) sends the save again with no one asking; a secret-scan false positive is saved with agentflare add --force <path> (discussion:owner/513). |
write_held | The tree could not write a file you author because another program held it open or denied access to it (Windows), and stopped trying after its deadline: the file on disk is older than its document. Close the file in the program holding it; the next render writes it. |
executable_cleared | A save of yours through a tree cleared the executable bit of a file that had it (discussion:owner/366), as a tool that writes a new file and renames it over the old one does unless it copies the mode. The bit is part of the file, so every node and every run now has it cleared. If the file should stay executable, chmod +x it. |
action_failed | An action failed at a frontier, and you changed a file it reads since the frontier where it last passed: one per action and failing streak. It names the action, both frontiers, the lines you changed, and the window's other authors; its content is the failing output's tail. Fix the change, then the next passing frontier sends an action_succeeded. |
action_succeeded | An action that failed after your change passes again at a later frontier, which ends its failing streak. |
derived_superseded | Your version of a derived (generated) file is not the one shown: another peer's version of it was chosen, so yours is hidden. |
path_collision | A file of yours lost its name to another with the same path, exactly or by case and Unicode normalization (history row 458): two were created or moved there at once, and the one with the smaller id kept the name. Yours now shows as <stem>~<tag><ext> in the same directory; rename it to settle the collision. |
file_restored | A file you edited was removed, with a directory above it, by another peer at the same time (history row 458): the edit kept it, and it is back at its last path, its directories with it. Both authors get one; remove it again if it should go. |
derivation_failed | A generator failed, or runners disagreed on its output, on inputs you changed since its last counted generation: one per derivation, a newer one replacing it. Its content names the generated file to run agentflare explain on, which shows the generator and the failure; fix the inputs. |
incompatible_node | A node of the project runs a release whose wire major version differs from this daemon's, or speaks no sync protocol this daemon does, so nothing syncs with it: one per node and daemon run. Its content names the node, both versions, and who upgrades: you (upgrade) when the node's is newer, else the node's owner (ask). agentflare status lists the node too. |
verdict_disputed | Another node refused changes of a peer that this daemon's own checks admit, judging by the same rules and the same grants (discussion:owner/549): since the checks are deterministic, one of the two nodes has a bug. This daemon keeps the changes. To the daemon's default peer, once per document, refusing node, peer, and counter in a daemon run; its content names the document, the signer, the node, both verdicts, and the rules version. agentflare status shows a disputed line while it is unread. |
protected_held | A change to a protected path by a peer who doesn't hold Approve on it is held, while the approved lvcs.toml declares no change action (discussion:owner/314): to the owner and each Approve holder this daemon holds, once per path and held heads. It names the path; its content names who wrote it. Your own edit of the path built on the held change approves it, so read the held change first (read at main shows it). |
plugin_upgrade | A bundled plugin's manifest on disk (after agentflare update) differs from its record and asks more than it holds, or its upgrade was refused (discussion:owner/535): to the owner, once per plugin and manifest. The plugin keeps running as recorded; its content says what it asks, and next is agentflare plugin upgrade <name>. |
Cardinality: 16.