diff --git a/AGENTS.md b/AGENTS.md index a9a2872..a1bdafd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -56,9 +56,7 @@ cmake --install build # installs the 6 .so to ~/.local/.../qt6/plu - **Match the existing style.** No pointless indirection; file-local helpers duplicated across plugins are preferred over a shared lib for a few trivial functions. -- **Never read a file you haven't read, then rewrite from memory.** Use targeted - edits. The LSP bridge in this environment is unreliable; prefer the Tree-sitter - (`code_*`) and `file_*` tools. +- **Never rewrite a file from memory.** Read it first, then make targeted edits. ## Two load-bearing design decisions diff --git a/README.md b/README.md index 609fbee..dfa7ccd 100644 --- a/README.md +++ b/README.md @@ -201,7 +201,8 @@ comment, case changes…), so the mouse stays at the text. - Slices can trigger any action by name, including `palette`/`switch` doors. - **Configure:** drop a `radials.json` at `~/.config/deft/radials.json` to replace the built-in tree; when it is absent, empty, or invalid, the built-in - default is used. + default is used. See [docs/radials.example.json](docs/radials.example.json) + for the format. ### `[deft:nineify] acme` — acme editing gestures diff --git a/docs/PLUMBING.md b/docs/PLUMBING.md index 143bcd4..24810a3 100644 --- a/docs/PLUMBING.md +++ b/docs/PLUMBING.md @@ -6,8 +6,9 @@ line, or a directory as a folder). The *routing* — what a plumbed string means lives in the plumber's rules, not in Kate. This document covers the user-side rules in `~/lib/plumbing` that make files and directories open in Kate. -See `PLAN.md` → "Plumbing" for the implementation (the native 9P client, the -edit-port reader, and the in-process handler). +The implementation (the native 9P client, the edit-port reader, and the +in-process handler) lives in `src/plumb/` — `plumb_lib` is the pure codec/9P +client and `plumbplugin.{h,cpp}` is the Kate glue. ## How plumbing reaches Kate diff --git a/docs/radials.example.json b/docs/radials.example.json index 29f4b82..3cc7caa 100644 --- a/docs/radials.example.json +++ b/docs/radials.example.json @@ -1,7 +1,7 @@ { - "//": "Ollie radial-menu config. Copy to $XDG_CONFIG_HOME/olliepalette/radials.json", + "//": "Deft radial-menu config. Copy to $XDG_CONFIG_HOME/deft/radials.json", "//trigger": "Each radial may have a key 'trigger' (e.g. \"Alt+R\") and/or a mouse 'button' (\"RightButton\" | \"MiddleButton\").", - "//slices": "A slice is a leaf { \"label\", \"action\": } or a branch { \"label\", \"slices\": [ ... ] }. The special action \"ollie_command_palette\" opens the M-x palette.", + "//slices": "A slice is a leaf { \"label\", \"action\": } or a branch { \"label\", \"slices\": [ ... ] }. The special action \"deft_command_palette\" opens the M-x palette.", "radials": [ { "name": "edit", @@ -19,9 +19,9 @@ { "label": "Align", "action": "tools_align" }, { "label": "UPPER", "action": "tools_uppercase" }, { "label": "lower", "action": "tools_lowercase" }, - { "label": "File…", "action": "ollie_goto_file" }, - { "label": "Sym…", "action": "ollie_goto_symbol" }, - { "label": "M-x", "action": "ollie_command_palette" } + { "label": "File…", "action": "deft_goto_file" }, + { "label": "Sym…", "action": "deft_goto_symbol" }, + { "label": "M-x", "action": "deft_command_palette" } ] } ]