From 9f947e93ecd14aaa6d54cf9ac1220b63de7a88a4 Mon Sep 17 00:00:00 2001 From: Ollie Agent Date: Thu, 30 Jul 2026 22:53:48 +0200 Subject: [PATCH] docs: update repo layout for tools/builtin, tools/lsp, data/ --- AGENTS.md | 16 ++++++++-------- README.md | 4 +++- doc/ARCHITECTURE.md | 2 +- 3 files changed, 12 insertions(+), 10 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 42903aa..a1eb4ec 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 diff --git a/README.md b/README.md index 38cec1d..08c8d39 100644 --- a/README.md +++ b/README.md @@ -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 | diff --git a/doc/ARCHITECTURE.md b/doc/ARCHITECTURE.md index 5c2f840..ec4f701 100644 --- a/doc/ARCHITECTURE.md +++ b/doc/ARCHITECTURE.md @@ -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