dotfiles
bugabingas dorkfiles
owned by bugabinga
docs(neovim): specify read-only pivi help with live editor view
e4db9b04be69322d1476238475bc9ef8ff1428dc
Oliver Krylow <o.krylow@isp-insoft.de> ·
SSH signature · not checked
Browse filesCompare with HEAD
Changed files (1)
neovim/.system/specs/NL-SPEC-GMWDCMJZ-pivi-native-neovim-integration/index.md
Modified 62 -- `:Pi help` answers a fast question about Neovim or pivi.
62 +- `:Pi help` answers a fast question about Neovim, pivi, or Pi.
63 63 - Help runs as an independent ephemeral agent run with no persisted session and no shared history.
64 64 - Help never enters a working session's transcript, queue, or status.
65 65 - Help stays available while a working session runs, and neither delays nor interrupts it.
66 66 - Help failure is isolated and never degrades a working session.
67 +- Help may read, and never modifies the editor, the filesystem, or Pi state.
68 +- Each question carries what the user can currently see rather than whole buffers.
69 +- Editor documentation is answered from the running instance, so the version and installed plugins decide the answer.
70 +- pivi's own behavior is supplied as knowledge to the agent rather than assumed.
71 75 editor --> help["Ephemeral help run"]
72 76 session --> history["Persistent session history"]
73 77 help --> discard["Discarded after answer"]
78 + help --> readonly["Read-only editor and documentation lookups"]
149 154 - A Pi slash command can run through `:Pi command ...`; `/` invokes slash-command entry only at the first character of a Pi input buffer.
150 155 - `:Pi help` answers while a working session run is active, without appearing in that session's history, queue, or status.
156 +- A help question carries the visible editor region, layout, selection, recent messages, and the last error, and no full buffer.
157 +- Help can answer an editor documentation question from the running instance, including documentation of installed plugins.
158 +- No help run can modify a buffer, a file, or Pi state.
151 159 - A submission made during an active run is queued with explicit delivery and can be listed and cleared before delivery.
152 160 - A user can create, resume, switch, and stop explicit Pi sessions without tying their lifetime to a source buffer or tab.
153 161 - A prompt can include an unsaved selection with stable source and revision metadata.