docs: update repo layout for tools/builtin, tools/lsp, data/

This commit is contained in:
Ollie Agent 2026-07-30 22:53:48 +02:00
parent 5a84e8b326
commit 9f947e93ec
3 changed files with 12 additions and 10 deletions

View File

@ -12,16 +12,16 @@ ollie/ ← you are here
├── fs/session/ (Go) 9P filesystem tree
├── dbus/ (Go) D-Bus adapter
├── cmd/ (Go) Binaries (olliesrv, ollie-9p, ollie-remote)
├── tools/ (Go) Tool implementations:
│ ├── builtin/ Built-in handlers (shell, reasoning, tool/skill registry)
│ └── lsp/ LSP bridge + cmd/ binaries (definition, hover, rename, ...)
├── kde/ (C++/Qt6) KDE integration: plasmoid, GUI, Kate plugin, KRunner, tray
├── el/ (Elisp) Emacs frontend (ellie.el)
├── agents/ Agent config JSONs (loaded at runtime)
├── prompts/ System prompt templates (markdown)
├── tools/ Tool scripts (file_read, lsp_*, memory_*, etc.)
├── contrib/elisp (Elisp) Emacs frontend (ellie.el)
├── data/agents/ Agent config JSONs (loaded at runtime)
├── data/prompts/ System prompt templates (markdown)
├── data/tools/ Tool executables + .meta sidecar files (installed to $OLLIE_TOOLS_PATH)
├── data/skills/ Domain knowledge modules (markdown)
├── sandbox/ Landlock sandbox config YAML
├── scripts/ User-facing CLI scripts:
│ ├── s/ Session management (sh, bfg, ls, kill, ...)
│ ├── u/ Utilities (complete, optimize, cascade)
│ └── x/ Internal/plumbing (elevate, prime, bd, task)
├── doc/ Architecture docs, usage guide
├── contrib/ Community scripts
└── experiments/ Trial notes

View File

@ -61,6 +61,8 @@ Single Go module with one Git submodule (kde).
| `agent/` | Go | Agent loop, history, hooks, prompt resolution, commands |
| `backend/` | Go | LLM providers (Anthropic, OpenAI, Ollama, Gemini, Copilot, CodeWhisperer) |
| `toolsrv/` | Go | Tool server, registry, sandboxed execution, remote execution |
| `tools/builtin/` | Go | Built-in tool handlers (shell, reasoning, tool/skill registry) |
| `tools/lsp/` | Go | LSP bridge daemon + client library (gopls, clangd, intelephense) |
| `session/` | Go | Session lifecycle, config, persistence |
| `fs/session/` | Go | 9P filesystem tree for session namespace |
| `dbus/` | Go | D-Bus adapter (`org.ollie.SessionManager`) |
@ -74,7 +76,7 @@ Single Go module with one Git submodule (kde).
| `kde/` | C++/Qt6 | KDE plasmoid, GUI, Kate plugin, KRunner, tray *(submodule)* |
| `data/agents/` | JSON | Agent configs |
| `data/prompts/` | Markdown | System prompt templates |
| `data/tools/` | Python/Bash/Go | Tool executables + `.meta` sidecar files |
| `data/tools/` | Mixed | Tool executables (scripts + compiled) + `.meta` sidecar files |
| `data/skills/` | Markdown | Domain knowledge modules |
| `doc/` | Markdown | Architecture docs, usage guide |

View File

@ -262,7 +262,7 @@ All other capabilities are **tool scripts** — executable files discovered from
### Tool Scripts
Tool scripts are plain executables with a `.meta` sidecar JSON file declaring description, parameters, tier, and parallelism class:
- `file_read`, `file_write`, `file_edit`, `file_glob`, `file_grep` — filesystem I/O
- `lsp_definition`, `lsp_references`, `lsp_rename`, `lsp_symbols`, `lsp_diagnostics`, `lsp_hover`, `lsp_completion` — LSP bridge (Python)
- `lsp_definition`, `lsp_references`, `lsp_rename`, `lsp_symbols`, `lsp_diagnostics`, `lsp_hover`, `lsp_completion` — LSP bridge (Go, `tools/lsp/`)
- `memory_remember`, `memory_recall` — persistent memory
- `reasoning_think` — scratchpad for externalized reasoning
- `subagent_spawn`, `subagent_generate` — sub-agent lifecycle