docs: landing page accuracy sweep — align claims with the implementation

Verified every checkable claim in docs/index.html against the code:

- JSON-LD softwareVersion 1.2.0 -> 1.26.2 (stale by 24 releases)
- Docker Compose files live in docker/, not the repo root (hero carousel
- now cds into odek/docker so the later config/compose steps resolve)
- 'go 1.24' -> 'go 1.25' in demo go.mod output (go.mod says 1.25.12)
- search_files is pure-Go regex content search, not 'ripgrep-backed'
- session_search is semantic vector search over conversation content;
  there is no --deep flag
- odek serve sandboxes by default — cheatsheet showed the inverse
  (--no-sandbox is the opt-out)
- odek mcp has no --sse-addr/SSE mode, stdio only — removed the cheatsheet
  row and the same stale claim in llms.txt and AGENTS.md
- odek schedule add requires --cron "<expr>"
- --interaction-mode accepts a fourth mode (off); also fixed the raw <m>
  tag that swallowed the flag placeholder at render time
- added the EXTENSIONS.md (odek-extension/v1) link to the docs grid and
  llms.txt

Everything else checked out: install one-liner asset names, Go 1.25+,
default model/iteration count, thinking levels, learn/no-learn, repl
--id, run --deliver, memory/cleanup subcommands, telegram budget env
vars, 3-worker delegation default, network_egress=prompt default,
MIT license, Linux/macOS release targets.

Author: jkyberneees

AGENTS.md

@@ -42,7 +42,7 @@ cmd/odek/
   external_ref.go             --external-ref flag parsing (run + continue) → session.ExternalRef
   perf_tools.go               Performance/parallelism tools (batch_patch, parallel_shell, http_batch, math_eval, diff,
                               count_lines, multi_grep, json_query, tree, checksum, sort, head_tail, base64, tr, word_count)
-  mcp.go                      MCP server implementation (stdio + SSE transport)
+  mcp.go                      MCP server implementation (stdio transport)
   mcp_approval.go             Per-tool MCP server approval UI and persistence (key hashes limits/artifact_roots)
   project_sandbox_approval.go Project-level sandbox config approval gate (C-1)
   transcribe_tool.go          Whisper.cpp audio transcription

docs/index.html

@@ -517,7 +517,7 @@
   "description": "The fastest, minimal Go autonomous agent runtime. ~12 MB static binary, zero frameworks. ReAct agent with parallel tool execution, persistent memory, MCP, sandbox, Web UI, and Telegram bot.",
   "url": "https://odek.21no.de",
   "downloadUrl": "https://github.com/BackendStack21/odek",
-  "softwareVersion": "1.2.0",
+  "softwareVersion": "1.26.2",
   "license": "https://github.com/BackendStack21/odek/blob/main/LICENSE",
   "image": "https://odek.21no.de/og-image.png",
   "screenshot": "https://odek.21no.de/og-image.png",
@@ -625,8 +625,8 @@ <h2 class="hero-h2">Getting started — <span class="hl">Docker + Telegram</span
         <div class="slide active">
           <span class="info"># 1 · Start from zero — grab the repo</span><br>
           <span class="prompt">$ git clone https://github.com/BackendStack21/odek</span><br>
-          <span class="prompt">$ cd odek</span><br>
-          <span class="output">The Docker Compose setup ships in the repo root:</span><br>
+          <span class="prompt">$ cd odek/docker</span><br>
+          <span class="output">The Docker Compose setup ships in docker/:</span><br>
           <span class="output">  Dockerfile · docker-compose.yml · config.restricted.json</span><br>
           <span class="info"># the container IS the sandbox — no --sandbox needed</span>
         </div>
@@ -803,7 +803,7 @@ <h2>See it in <span class="hl">action</span></h2>
         <span class="info">═══ Iter 1/15 ═══  [456 in · 21 out · 0.8s]</span><br>
         <span class="output">The <strong>go.mod</strong> file has 3 lines:</span><br>
         <span class="output">module github.com/BackendStack21/odek</span><br>
-        <span class="output">go 1.24</span><br>
+        <span class="output">go 1.25</span><br>
         <span class="output">require ( ... )</span><br>
         <span class="info">✅ Done in 0.8s</span>
       </div>
@@ -859,7 +859,7 @@ <h2>See it in <span class="hl">action</span></h2>
         <span class="output">Connected by Claude Code. Exposing built-in tools:</span><br>
         <span class="output">  • read_file    — read files with line numbers</span><br>
         <span class="output">  • write_file   — write files safely</span><br>
-        <span class="output">  • search_files — ripgrep-backed search</span><br>
+        <span class="output">  • search_files — regex content search</span><br>
         <span class="output">  • shell        — execute commands</span><br>
         <span class="output">  • patch        — find-and-replace edits</span><br>
         <span class="output">  — MCP stdio —</span>
@@ -964,7 +964,7 @@ <h4>Web UI</h4>
     <div class="card">
       <div class="icon">🔍</div>
       <h4>Session Search</h4>
-      <p><code>session_search</code> — full-text and fuzzy search across your entire agent history. Use <code>--deep</code> for LLM-powered semantic search. Never lose a past finding, decision, or code review.</p>
+      <p><code>session_search</code> — semantic search across your entire agent history: vector matching over full conversation content finds sessions whose messages match your query, even when titles don't. Never lose a past finding, decision, or code review.</p>
     </div>
 
     <div class="card">
@@ -1097,13 +1097,12 @@ <h3>Commands</h3>
     <li><span class="cmd">odek run --sandbox &lt;task&gt;</span><span class="desc">Run in Docker sandbox</span></li>
     <li><span class="cmd">odek repl</span><span class="desc">Interactive multi-turn REPL</span></li>
     <li><span class="cmd">odek repl --id &lt;uuid&gt;</span><span class="desc">Resume a saved session</span></li>
-    <li><span class="cmd">odek serve</span><span class="desc">Start Web UI (http://127.0.0.1:8080)</span></li>
-    <li><span class="cmd">odek serve --sandbox</span><span class="desc">Web UI with Docker sandbox</span></li>
+    <li><span class="cmd">odek serve</span><span class="desc">Start Web UI (sandboxed by default, http://127.0.0.1:8080)</span></li>
+    <li><span class="cmd">odek serve --no-sandbox</span><span class="desc">Web UI without the Docker sandbox</span></li>
     <li><span class="cmd">odek subagent --goal &lt;s&gt;</span><span class="desc">Run a focused sub-task</span></li>
-    <li><span class="cmd">odek mcp</span><span class="desc">Start MCP server (stdio)</span></li>
-    <li><span class="cmd">odek mcp --sse-addr :8081</span><span class="desc">Start MCP server (SSE)</span></li>
+    <li><span class="cmd">odek mcp</span><span class="desc">Start MCP server (stdio; --sandbox for Docker)</span></li>
     <li><span class="cmd">odek telegram</span><span class="desc">Start Telegram bot</span></li>
-    <li><span class="cmd">odek schedule add &lt;task&gt;</span><span class="desc">Schedule a recurring agent task (cron)</span></li>
+    <li><span class="cmd">odek schedule add --cron "&lt;expr&gt;" &lt;task&gt;</span><span class="desc">Schedule a recurring agent task (cron)</span></li>
     <li><span class="cmd">odek cleanup --dry-run</span><span class="desc">Preview storage maintenance, delete nothing</span></li>
     <li><span class="cmd">odek cleanup</span><span class="desc">Run one storage maintenance sweep</span></li>
     <li><span class="cmd">odek memory extended stats</span><span class="desc">Memory store, index, quarantine, recall health</span></li>
@@ -1128,7 +1127,7 @@ <h3>Key Flags</h3>
     <li><span class="cmd">--system &lt;prompt&gt;</span><span class="desc">Override system prompt</span></li>
     <li><span class="cmd">--no-color</span><span class="desc">Disable colored output</span></li>
     <li><span class="cmd">--deliver</span><span class="desc">Deliver result to Telegram default chat</span></li>
-    <li><span class="cmd">--interaction-mode <m></span><span class="desc">engaging | verbose | enhance</span></li>
+    <li><span class="cmd">--interaction-mode &lt;mode&gt;</span><span class="desc">engaging | verbose | enhance | off</span></li>
   </ul>
 </section>
 
@@ -1146,6 +1145,7 @@ <h2>Everything else is <span class="hl">documented</span></h2>
     <a href="https://github.com/BackendStack21/odek/blob/main/docs/PROVIDERS.md">Providers & Models<span>DeepSeek, OpenAI, Anthropic, Ollama, vLLM, more</span></a>
     <a href="https://github.com/BackendStack21/odek/blob/main/docs/CACHING.md">Prompt Caching<span>Cache markers for lower latency and cost on repeats</span></a>
     <a href="https://github.com/BackendStack21/odek/blob/main/docs/MCP.md">MCP (Two-Way)<span>Serve tools + connect to external MCP servers</span></a>
+    <a href="https://github.com/BackendStack21/odek/blob/main/docs/EXTENSIONS.md">Extension Contract<span>odek-extension/v1: limits, artifact refs, events, budgets</span></a>
     <a href="https://github.com/BackendStack21/odek/blob/main/docs/MEMORY.md">Memory System<span>Legacy facts, buffer, episodes</span></a>
     <a href="https://github.com/BackendStack21/odek/blob/main/docs/EXTENDED_MEMORY.md">Extended Memory<span>Semantic atoms, recall, quarantine, proactive engagement</span></a>
     <a href="https://github.com/BackendStack21/odek/blob/main/docs/MAINTENANCE.md">Storage Maintenance<span>Janitor, retention config, odek cleanup</span></a>

docs/llms.txt

@@ -18,7 +18,8 @@ Module path: `github.com/BackendStack21/odek`. Repository: https://github.com/Ba
 - [Sub-agents](https://odek.21no.de/SUBAGENTS.md): `delegate_tasks` tool and `odek subagent` — real OS processes with trust levels, risk caps, and FD-based API key handoff
 - [Tool Selection](https://odek.21no.de/TOOL_SELECTION.md): restricting which built-in tools the LLM can see
 - [Prompt Caching](https://odek.21no.de/CACHING.md): provider prompt-caching support, cost and latency effects
-- [MCP Integration](https://odek.21no.de/MCP.md): odek as MCP server (stdio/SSE) and as MCP client, per-tool approval flow
+- [MCP Integration](https://odek.21no.de/MCP.md): odek as MCP server (stdio) and as MCP client, per-tool approval flow
+- [Extension Contract](https://odek.21no.de/EXTENSIONS.md): odek-extension/v1 — MCP per-server limits, artifact refs, runtime events, execution budgets
 - [Development](https://odek.21no.de/DEVELOPMENT.md): build, test, release workflow, and contributor notes
 
 ## Memory, learning, and sessions