FFLOW 0.5.0: conditional flows share symbols; per-flow and per-symbol step commands; popup header shows set/replace/add

This commit is contained in:
olivier committed 2026-10-27 12:58:58 -04:00
1 parent f5992e4539
commit 60582bcb03
11 files changed
+291 -40

No files matched your search

+20 -2
View File
@@ -2,7 +2,9 @@
Set frontmatter properties from the editor with trigger symbols, the way `#` autocompletes tags.
Type `@mee`, pick `meeting`: the text `@mee` disappears and the note gets `type: meeting`.
Type `&mee`, pick `meeting`: the text `&mee` disappears and the note gets `type: meeting`.
The top of the popup says what the pick will do: **Set** a property that is empty, **Replace** its current value (shown), or **Add to** a list.
## Flows
@@ -12,8 +14,24 @@ Everything is a flow (Settings → FFLOW). A flow has:
- **Symbol** (optional): one character that is not a letter, digit or space. `# [ / :` are reserved (tags, links, slash commands, emoji). It fires only at the start of a word (line start or after a space), never inside frontmatter or code.
- **Property**: the frontmatter key the flow sets.
- **Kind**:
- **Ordered list**: fixed steps, in order. Each step can also set other properties (**Also sets**). Gets **FFLOW: <name>: next step** / **previous step** commands for hotkeys; **Loop** wraps around at the ends.
- **Ordered list**: fixed steps, in order. Each step can also set other properties (**Also sets**). Gets next/previous step commands for hotkeys (see below); **Loop** wraps around at the ends. Also the way to offer a fixed list of values: only the listed values are proposed.
- **Open (vault)**: suggests every value already used for the property in the vault, ranked by use, and accepts new values. *Single value* replaces, *List* appends without duplicates. No steps, no hotkeys.
- **Only on notes where** (optional): a property and comma-separated values, e.g. `type` = `highlight, source`. The flow runs only on notes whose property holds one of the values (case-insensitive; for a list property, any item). Leave the values empty to match any note where the property is set.
### Several flows on one symbol
Flows can share a symbol when they have conditions. On a given note, the first flow whose condition matches runs; a flow without a condition runs when none matches. Example:
| Symbol | Flow | Only on notes where | Property |
|---|---|---|---|
| `@` | Author | `type` = `highlight, source` | `author` |
| `@` | Participants | `type` = `meeting` | `participants` (list) |
| `!` | Project status | `type` = `project` | `status`: inactive → active → done |
| `!` | Client status | `type` = `business` | `status`: active → inactive |
On a note that matches none of them, `!` and `@` do nothing. The condition is read from the note as typed, so `&project` then `!` works right away. A flow that can never run (an earlier flow with the same symbol covers the same notes) is flagged in the settings.
Every ordered flow gets **FFLOW: <name>: next step** / **previous step**, available only on notes its condition matches. Command ids derive from the flow id, so hotkeys and toolbar buttons (e.g. Note Toolbar) survive renames. Ordered flows sharing a symbol also get a shared pair, **FFLOW: ! Project status / Client status: next step** / **previous step**, that moves whichever flow matches the note: one hotkey for every status.
### Step effects