Commit 0d086be
committed
docs(tools[hook]): restore 'Why no set_hook?' design rationale
Hoist the page-level intro the mechanical split dropped. Original
prose lives at 970b000:docs/tools/hooks.md:9-22; the per-tool pages
inherit tool-scoped Use/Avoid blocks from autodoc but cannot carry
area-level design rationale explaining WHY the surface is read-only.
Content restored explains:
- tmux servers outlive the MCP process.
- FastMCP lifespan teardown runs only on graceful SIGTERM/SIGINT;
kill -9, OOM-kill, and C-extension-fault crashes bypass it.
- Three candidate future paths (tmux-side client-detached
meta-hook, LIBTMUX_SAFETY=destructive gating, one-shot run_hook)
are explicitly out of scope until one is implemented.1 parent 2b9c220 commit 0d086be
1 file changed
Lines changed: 9 additions & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | | - | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
4 | 12 | | |
5 | 13 | | |
6 | 14 | | |
| |||
0 commit comments