Commit Graph

32 Commits

Author SHA1 Message Date
Ollie Agent 02f130f79e Update 9P architecture documentation 2026-08-16 19:50:35 +02:00
Ollie Agent 16240b3e12 Consolidate tool architecture documentation 2026-08-16 19:44:09 +02:00
Ollie Agent ab9fd60901 Document sub-agent context isolation 2026-08-16 11:39:21 +02:00
Ollie Agent 929b94e34d Clarify workspace path placeholders 2026-08-16 10:30:56 +02:00
Levi Neely c4b5a58300 doc: promote evolution.md to doc/, add rationale
It's a study log, not a resource. Added opening paragraph explaining
what the document is and why the dead ends matter.
2026-08-12 21:48:06 +02:00
Levi Neely 155e4fe97b evolution: consolidate dead ends into comprehensive final table
Removed two inline 'Dead Ends and Reversals' tables scattered mid-document.
Added single comprehensive table at the end covering all reversals from all
phases — including hooks, event ring buffer, abstractions, namespace merges,
concurrent-by-default rejection, and every other thing that was built and
then killed.
2026-08-12 21:39:53 +02:00
Levi Neely 8ead5c29e1 evolution: update background process interrupt delivery, drop concurrent-by-default
Background processes now deliver completions as user prompts (queued via
the agent's prompt file) upon completion, not injected in-loop alongside
tool results.

Removed 'Open Problem: Concurrency' section — concurrent-by-default was
considered and rejected (sequential execution but slower and more expensive).
Replaced with a paragraph explaining the deliberate design choice.
2026-08-12 21:30:33 +02:00
Levi Neely e323e7079e doc: add Phases 22-26 + Good Idea Fairy + pubsub migration to evolution.md
Major architectural changes documented:
- Aug 3: Ring buffer -> pubsub (Phase 19)
- Aug 5: Hooks deleted entirely, ~960 lines removed
- Aug 11-12: Meta-only tool definitions, bypass via 9P, fs/ flattening,
  sandbox simplification, agent loop cleanup
2026-08-12 20:43:08 +02:00
Levi Neely ef9a56d41b doc: rename tool scripts to tool definitions throughout 2026-08-12 19:40:06 +02:00
Levi Neely 9bb3cd76b8 Remove sudo mechanism from bypass system
The sudo credential broker was never functional and added complexity
without value. This removes:

- Sudo field from bypass Request structs (broker, client, toolsrv)
- Sudo parameter from EvaluateRequest interface and implementations
- Sudo/ResetsCounter fields from MetaFile and Variant structs
- sudo: true from system_logs.meta variants
- All sudo documentation from writing-tools.md, tool-registry.md,
  core.md, evolution.md, and misc.md

Bypass remains fully functional for sandbox escapes. Tools that need
elevated privileges should handle that internally or be run manually.
2026-08-12 08:58:41 +02:00
Ollie Agent 9e4c7582a3 doc: remove stale logging section from evolution.md 2026-08-11 10:25:54 +02:00
Ollie Agent 391465be77 doc+fix: background procs force timeout=0, update docs
- Background procs get timeout=0 (no deadline) set by toolsrv at
  the execution layer — not injected as an arg from olliesrv.
  Foreground default remains 30s. User can still override via args.
- Timeout logic simplified: caller sets default, ExecuteTool honors it.
- System prompt: clarify background has no timeout, uses 'stop' not 'kill'
- architecture.md: document lifecycle (connection-based ownership)
- evolution.md: update interrupt section with streaming, lifecycle, id= format
- README.md: add parallel execution to capabilities table
2026-08-11 10:18:30 +02:00
Ollie Agent 12babf2f92 doc: document parallel execution, background interrupts, and dispatch flags 2026-08-11 08:30:31 +02:00
Ollie Agent 3e6d1aa7d5 doc: update concurrency section with parallel fan-out and protocol constraints 2026-08-11 08:06:38 +02:00
Ollie Agent bb58c42f4f doc: note concurrency as unsolved problem in toolsrv evolution 2026-08-11 07:32:38 +02:00
Ollie Agent 41969ed4b2 doc: clarify toolsrv lifecycle for local vs SSH-remote case 2026-08-11 07:27:38 +02:00
Ollie Agent 4b7d5cdd79 doc: update architecture, evolution, README for toolsrv 9P migration
- README: toolsrv shown as separate child process in architecture diagram,
  cmd/toolsrv added to repository layout table
- architecture.md: repository structure reflects cmd/{olliesrv,toolsrv}
  internal packages, package table updated for two-server model
- evolution.md: add Phase 20 (toolsrv 9P migration & process isolation),
  update topology diagram, add to gantt chart
2026-08-11 07:24:53 +02:00
Ollie Agent 2d74ffb95e prompt audit: trim system prompt, kill dead code, improve maintainability
- System prompt: ~200 → ~80 lines (removed tool-first table, API docs,
  output protocol, dead 9P entries)
- Removed AllowTools entirely (field, RPC, configs)
- Removed PRIME_* env vars, replaced with typed struct fields
- Merged tool listing + docs into single renderTools()
- Killed BuildToolListing, changed OnToolsChanged to func() signal
- Typed Preamble.Section (compile-time safety)
- Added protocol docs on extractToolResult
- Added session/ package godoc
- Moved output protocol to per-agent prompts
- Rewrote data/agents/README.md
- Moved 7 reference docs from doc/resources/ to doc/
- Deleted PromptEnv() dead function
2026-08-09 14:13:52 +02:00
Ollie Agent 25924d0909 fs: add /help ctl command — returns command reference 2026-08-09 03:32:21 +02:00
Ollie Agent aa74e1c683 docs: fix stale references in 9p.md, usage.md, misc.md
- 9p.md: update agent file table to current namespace
- usage.md: readloop→read -l, tail→read chat, command table updated,
  TUI description updated (no grep pipe)
- misc.md: readloop→read -l
2026-08-09 03:10:20 +02:00
Ollie Agent 42823dab2e docs: update README, AGENTS.md, architecture, evolution for Aug 9 changes
- README: fix CLI commands, repo layout (remove detach/, add fsedsl/lib9p)
- AGENTS.md: update architecture section (ctl rdwr, bypass, tool_load)
- architecture.md: rewrite namespace tree to match current state
- evolution.md: add Aug 9 section documenting all simplifications
2026-08-09 03:06:05 +02:00
Ollie Agent c7aea0db59 rename elevate→bypass throughout
The sandbox escape mechanism is a bypass, not privilege elevation.
The old name caused the agent to confuse it with sudo.

- elevate/ → bypass/ (package, types, tests)
- elevate_notify.go → bypass_notify.go
- Namespace: /elevate → /bypass, session/*/elevate → session/*/bypass
- Tool arg: "elevated" → "bypass"
- Env: OLLIE_ELEVATE_SOCKET → OLLIE_BYPASS_SOCKET
- File: elevate-policy.yaml → bypass-policy.yaml
- All docs, prompts, and scripts updated
2026-08-09 02:22:39 +02:00
Ollie Agent 38b35f1ba5 toolsrv/agent: rename ClassifyTool→CanParallelize, ClassifyTier→MemoryTier
Rename throughout: Go methods, interface types, Runtime fields, wire
protocol RPCs, tests, and ollie-remote.

- IsParallelRead / ParallelClassifier → CanParallelize
- ResultTier / ResultTierArgs / TierClassifier → MemoryTier / MemoryTierArgs / MemoryTierClassifier
- Wire: is_parallel_read → can_parallelize, result_tier → memory_tier, result_tier_args → memory_tier_args
2026-08-08 14:29:41 +02:00
Ollie Agent 5584a24efb Remove tool_active/skill_active references from system prompts and core.md 2026-08-05 19:40:21 +02:00
Ollie Agent 36822717a1 Move 'Tool registry: zero built-in tools' to doc/resources/tool-registry.md 2026-08-05 19:10:08 +02:00
Ollie Agent 0d8bd9a56c Move '9P: Everything is a File' to doc/resources/9p.md 2026-08-05 19:05:49 +02:00
Ollie Agent 8f883c2355 rename resources/whitepaper.md to misc.md 2026-08-04 21:15:49 +02:00
Ollie Agent 6657030969 revert whitepaper: move back to resources/, restore original content 2026-08-04 21:10:28 +02:00
Ollie Agent bc0c0709e4 whitepaper: move from resources/ to doc/ (top-level) 2026-08-04 21:09:30 +02:00
Ollie Agent 8b3fce317a whitepaper: add opening paragraph (what + motivations) 2026-08-04 21:08:57 +02:00
Ollie Agent 9c92c5736d doc: move img back to doc/img/, keep resources/ for extra docs 2026-08-04 21:07:04 +02:00
Ollie Agent b72b2a0a83 doc: organize into doc/resources/, keep front-page docs at doc/ 2026-08-04 21:06:20 +02:00