Commit Graph

124 Commits

Author SHA1 Message Date
Levi Neely ead4678ee5 docs: correct Session and Context section in ARCHITECTURE.md
Remove references to the non-existent contextBuilder and rolling window.
Describe the actual compaction model: unbounded history, explicit /compact
trigger, LLM-generated summary, system message preservation, user message
budget (~20k tokens), tool call flattening, and pre-compaction snapshot.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-25 11:19:05 +02:00
Levi Neely eff00a7b2e docs: document httpgw and webui
Add HTTP gateway and web UI sections to USAGE.md: build instructions,
runtime flags, HTTP→9P endpoint reference, nginx serving example, and
Vite dev workflow. Add HTTP gateway architecture section to
ARCHITECTURE.md with frontend comparison table. Update README.md with
httpgw build target, dual remote-access paths (9P mount vs httpgw),
and container example updated for both.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-25 09:14:48 +02:00
Levi Neely c3df30df3c docs: add multi-agent workflows and store federation to USAGE.md
Promote IDEAS.md content to concrete how-to documentation: subagent
delegation via subagent_spawn, concurrent sessions with direct prompt
passing (prompt/statewait/offset), predefined shell-script workflows,
self-generating workflows, and store federation via OLLIE_TOOLS_PATH
and OLLIE_TRANSCRIPT_PATH pointing at 9pfuse-mounted remote dirs.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-25 08:37:33 +02:00
Levi Neely 2148c8c668 update docs: unify b/ into s/, introduce s/bfg and s/bbg
Batch and session namespaces are now a single s/ concept. s/bfg blocks
until the agent finishes and writes to stdout; s/bbg returns immediately
and prints the session path. s/b is the core one-shot runner. Remove all
b/ references from README, USAGE, ARCHITECTURE, and scripts/README.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-25 08:31:15 +02:00
Levi Neely 6ab2bf7011 doc: add prompt composition observation 2026-04-24 14:04:11 +02:00
Levi Neely bb66a465ab doc: add dashed wrapped-by arrow between core primitives and Stores 2026-04-22 11:30:35 +02:00
Levi Neely e8204143a2 doc: fix plugin arrows — hooks from agent.Core, elevation from execute_code 2026-04-22 11:25:25 +02:00
Levi Neely 46918ff753 doc: add plugins (x/) box, route backend->LLM as bezier 2026-04-22 11:21:37 +02:00
Levi Neely 53b69fd923 doc: add sandbox region, refine architecture diagram layout 2026-04-22 11:19:40 +02:00
Levi Neely 1947f90f6f doc: scale architecture diagram to 60% width 2026-04-22 11:17:33 +02:00
Levi Neely b4a0014dd2 doc: hand-crafted architecture diagram
Replace Mermaid-generated SVG with hand-written SVG to avoid
font metric clipping. Shows core as foundation, olliesrv as
the 9P layer, and front-ends/scripts/pipelines as consumers.
2026-04-22 11:16:35 +02:00
Levi Neely 8f70b647f2 doc: simplify architecture diagram labels to fix text clipping 2026-04-22 10:56:20 +02:00
Levi Neely c616050f36 doc: add high-level architecture diagram 2026-04-22 10:53:55 +02:00
Levi Neely 2f1db75b02 docs: update documentation for recent refactor
- Package layout: add pkg/store, pkg/log, pkg/env, pkg/paths, pkg/skills
- System prompt: loaded from SYSTEM_PROMPT.md by Go, not agentSpawn hooks
- Tool prompts injected via preTurn hooks, not agentSpawn
- Sandbox config: single named config, not layered global+overlay
- Store interfaces: unified Store, remove ReadableStore/ReadWriteStore/BlobStore
- Fix batch status -> state in USAGE.md polling examples
- Fix enqueue -> fifo.in in session-management skill
- Fix 9p/internal/p9/server.go -> 9p/server.go (flattened)
- Remove stale sys-base, sys-ollie, sys-skills prompt file references
- Remove stale /pl references from 9p backing stores docs
2026-04-22 10:35:46 +02:00
Levi Neely e7cca59089 remove MCP support, add execute_code tests
- Update submodules: core (remove MCP, add tests), 9p (remove mcp file)
- Add doc/NO_MCP.md: justification for removing MCP
- Add observation to doc/OBSERVATIONS.md
- Update ARCHITECTURE.md, help.md, SYSTEM_PROMPT.md, agents/README.md
2026-04-21 13:26:00 +02:00
Levi Neely 3bc6785230 scripts,docs: batch status→state; use statewait in b/job and b/cleanup
b/job now blocks on statewait instead of polling; b/cleanup reads state.
Update all documentation references. Bump 9p submodule.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 20:45:08 +02:00
Levi Neely 186f935cbb doc/IDEAS.md: polish predefined workflows; fix stale prompt reference
Update send() to use statewait (eliminates busy-wait polling race on
submit). Fix stale prompts/08_subagents.md ref → prompts/tools-subagent.md.
Remove redundant offset explanation from prose.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 20:17:43 +02:00
Levi Neely 61fc50a702 prompts: rename p/ files; drop OLLIE_PLAN_PATH and pl/ references
Rename prompt files to semantic names (no numerical prefix):
  00_base           => sys-base
  01_ollie          => sys-ollie
  02_skills         => sys-skills
  03_tool-files     => tools-file
  04_tool-reasoning => tools-reasoning
  05_tool-memory    => tools-memory
  07_tool-subagents => tools-subagent
  08_tool-elevate   => tools-elevate

Update agent configs and all documentation references. Remove
OLLIE_PLAN_PATH from env.sample and pl/ mention from OBSERVATIONS.md.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 20:09:50 +02:00
Levi Neely c32b34b05e doc update 2026-04-19 20:00:36 +02:00
Levi Neely e23c79c713 docs,prompts,scripts,tui,el: rename enqueue/dequeue to fifo.in/fifo.out; add *wait docs; bump submodules
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 16:11:19 +02:00
Levi Neely 8aa1033017 docs: update all docs for hook-based priming, remove pl/ references
- agents/README.md: explain prime-based system prompt composition
- doc/ARCHITECTURE.md: remove Planning section (pl/ no longer exists)
- doc/help.md: update p/ annotation to reflect prime/agentSpawn
- bump core and 9p submodules

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 12:16:57 +02:00
Levi Neely ec385d0d6e planning: remove plan_* tools and prompt entirely
The markdown planning mechanism created competing signals against beads.
Removing it eliminates the conflict. Planning goes through beads (bd)
or whatever external mechanism is appropriate.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 11:36:56 +02:00
Levi Neely 89f340eca9 tools: change OLLIE_BEADS_ENABLE default to 1 (opt-out instead of opt-in)
plan_* now blocks by default when bd and .beads are present.
Set OLLIE_BEADS_ENABLE=0 to use the markdown-based plan_* scripts instead.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 11:11:26 +02:00
Levi Neely 663e7f305a tools: enforce beads for planning when OLLIE_BEADS_ENABLE=1 and bd is present
If both conditions hold, plan_* scripts exit 2 with an error directing
the model to use bd instead. When either condition is false (beads not
configured or bd not installed), the scripts run normally as a fallback.

Document OLLIE_BEADS_ENABLE in README and doc/help.md.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-19 10:43:32 +02:00
Levi Neely 4202505704 elevation: add elevate_superpowers tool; remove frontend env injection from s/sh and submodules
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 20:07:10 +02:00
Levi Neely 64ed36b132 rename: ollie-el → ellie throughout; update submodule
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 13:33:30 +02:00
Levi Neely 735753bac9 doc: add server/usage docs; rename ollie.el to ellie.el; update submodule
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 13:31:58 +02:00
Levi Neely e5d9e96f8c doc: use literal mount path in cron example; $HOME unavailable in cron env
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:43:59 +02:00
Levi Neely 484da50269 doc: add b/cleanup section to USAGE.md with cronjob hint
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:43:18 +02:00
Levi Neely ea58313f94 scripts: b/job accepts args as instruction and stdin as content when both present
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:36:05 +02:00
Levi Neely e6d41e36da doc: fix AI pipeline examples; b/q takes prompt from args OR stdin, not both
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:34:21 +02:00
Levi Neely 42999232d1 doc: fix broken u/optimize pipeline example
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:31:00 +02:00
Levi Neely 817d536cbc doc: move Agents and Example session to 9p README
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:28:02 +02:00
Levi Neely adc323e4ba doc: move Sessions section to 9p README
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:27:17 +02:00
Levi Neely 6822fb6cd0 doc: add alternative front-ends section to USAGE.md
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:26:02 +02:00
Levi Neely c8795964f3 doc: add USAGE.md; update 9p submodule
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:25:40 +02:00
Levi Neely d36e75a0a2 doc: add script namespaces section to ARCHITECTURE.md
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:16:48 +02:00
Levi Neely 106bd6410e scripts: move optimize to u/ (utility) namespace
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 12:00:39 +02:00
Levi Neely 97297a6c76 scripts: move q and sched to b/ namespace
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 11:58:42 +02:00
Levi Neely 4f24c7e6c5 doc: add AI pipelines observation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 11:41:33 +02:00
Levi Neely 7a4d5fc4c8 doc: document all s/ scripts (ls, kill, q, sched)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 11:06:32 +02:00
Levi Neely f984565082 scripts: add s/sh, s/job, s/q, s/sched, s/ls, s/kill to ollie filesystem
Install scripts to ~/.config/ollie/scripts/ (not ~/bin/) so they are
served via the 9p mount without PATH changes. Add thin wrappers oq-q
(s/q, foreground one-shot) and oq-schedule (s/sched, background with
b/ path output). Switch osh and oq from OLLIE_9MOUNT to OLLIE.
Update mkfile, docs, and submodule pointer.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-18 11:06:05 +02:00
Levi Neely 4daf9464f4 doc: log store federation idea; clarify no new implementation needed
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 23:49:30 +02:00
Levi Neely e9f10eeb92 add remote access via TCP: Containerfile, mount subcommand, docs
- Containerfile: multi-stage podman build for running olliesrv as a
  remote server (port 9564, no FUSE needed on server side)
- olliesrv mount <address> [mountpoint]: mounts a remote olliesrv
  namespace locally via 9pfuse over TCP
- olliesrv start -tcp <addr>: adds TCP listener alongside Unix socket
- README: document remote access and container usage
- doc/IDEAS.md: remove Network & Remote Access (implemented)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 23:32:37 +02:00
Levi Neely 5535e0edbb transcript: add tr/ store, save via chat write or ctl save
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 22:35:07 +02:00
Levi Neely 5cfef55336 doc: remove Persistent Memory idea (implemented via m/)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 22:23:19 +02:00
Levi Neely c06bd3b223 doc: remove redundant develop->review->test example
Covered by the predefined workflows shell script below.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 22:21:45 +02:00
Levi Neely 64b10b7226 doc: document offset file semantics
offset points to chat position after the last user prompt;
tail -c +$((offset+1)) yields the model response for that turn.
Replace stale reply references in prompts, help, ideas, and skills.
Document offset usage in concurrent sessions pattern and shell script.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 22:17:33 +02:00
Levi Neely fdc9707272 doc: use offset file in predefined workflow script
Replace manual wc -c pattern with server-maintained offset file.
Document offset in help.md session file listing.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 22:05:16 +02:00
Levi Neely c2f4694ad8 doc: add predefined workflows section with updated shell script
Replace reply-based polling with chat offset pattern and named
sessions. Agents have no knowledge of each other; coordinator
script drives the workflow explicitly.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 22:00:06 +02:00
Levi Neely 9ae565957c doc: remove Sub-Agents idea (implemented via subagent_spawn)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 21:51:25 +02:00
Levi Neely 4ad8e52ce9 doc: fix stale session management references
Update s/new syntax (no 'new' prefix), rm -r for kill, and correct
Python script to use s/new and shutil.rmtree instead of top-level ctl.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 21:50:40 +02:00
Levi Neely 54af56c8d7 doc: update documentation to reflect unified execute_code
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 21:42:10 +02:00
Levi Neely 12e15d4287 execute: unify execute_pipe into execute_code as pipeline primitive
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 21:36:41 +02:00
Levi Neely 7b50e1e145 doc: correct architecture — file/memory/reasoning/task are tool scripts, not servers
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 21:24:28 +02:00
Levi Neely 534c5d81c0 execute: remove execute_tool; use execute_code {tool} steps instead
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 21:15:19 +02:00
Levi Neely 5e5a82b387 doc: move observations from README to doc/OBSERVATIONS.md
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-16 21:00:19 +02:00
Levi Neely 3097caa66e doc: document parallel execution and subagent fork-join pattern
- README.md: add parallel execution benefit; update sub-agents benefit
  to describe subagent_spawn and heterogeneous fan-out composition
- doc/ARCHITECTURE.md: update execute tool descriptions; add Parallel
  Execution and Sub-agents section documenting the fork-join pattern
  and architecture boundary preservation
2026-04-16 20:35:22 +02:00
Levi Neely e32d96962f doc: update for b/ batch namespace
- doc/help.md: add b/ to filesystem layout, remove s/{id}/reply
- README.md: update sub-agents and composability blurbs to reference b/
2026-04-16 19:41:40 +02:00
Levi Neely f155ba91d0 doc: add env.sample; update help.md (OLLIE, m/, idx files, backend vars)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-14 21:57:39 +02:00
Levi Neely 3911cedeed update 9p submodule; doc: prompt rebuild triggers
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-14 20:07:49 +02:00
Levi Neely 191ebf5af0 update core submodule; doc: shutdown closes all sessions
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-14 19:53:01 +02:00
Levi Neely 1e90b68124 update submodules; doc: systemprompt, session lifecycle, !/sp commands
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-14 19:40:22 +02:00
Levi Neely 30d1902580 update submodules and tools: consistent memory path, sandbox RWX
- 9p: memory defaults to ~/.config/ollie/memory, created on startup
- core sandbox: ~/.config/ollie and ~/mnt/ollie are RWX
- tools: memory_remember/recall use $OLLIE_9MOUNT/m
- doc: update ARCHITECTURE.md memory path reference

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-14 16:16:00 +02:00
Levi Neely ed4fe7e6f2 docs: update ARCHITECTURE and PLANNING for new tool structure
Reflect the removal of PlanBackend/MemoryBackend abstractions and the
addition of pkg/tools/memory and pkg/tools/task. Update tool table (12
tools, 5 servers), data flow diagram, planning lifecycle, and consumer
setup example. Rewrite PLANNING.md around task_plan/task_complete.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-14 08:16:42 +02:00
Levi Neely 8b55fc3895 fix 9P docs: s/new is r/w, fix ctl command list
help.md: s/new was listed as (w) but reading returns a KV template.
9p submodule: ctl comment listed 'compact, clear, interrupt' but
actual commands are stop, kill, rn, compact, clear.
2026-04-13 18:08:59 +02:00
Levi Neely fa5828b2d3 rename workdir to cwd throughout codebase
Completes the rename started with the 9P file change.

Go API: WorkDir→CWD, SetWorkDir→SetCWD, WorkDirSetter→CWDSetter.
Unexported: workdir→cwd in fields, params, locals.
Template: {{.WorkDir}}→{{.CWD}}.
Docs: ARCHITECTURE.md, PLANNING.md, README.md, IDEAS.md.
2026-04-13 18:02:54 +02:00
Levi Neely cf7145593f rename workdir to cwd in docs, toys, and submodule refs 2026-04-13 15:51:58 +02:00
Levi Neely e6885ece62 update submodules; copy help.md in mkfile data target 2026-04-13 14:45:20 +02:00
Levi Neely 687cf48255 update submodules: 9p create/writable skills, core tools path
- 9p: add Tcreate for /t and /sk, writable skill files, tools path
- core: default tools path to ~/.config/ollie/tools
- docs: update ARCHITECTURE.md and IDEAS.md for new path
2026-04-13 10:25:30 +02:00
Levi Neely 3f7d2cf7e2 doc: replace Task Tracking with Memory Recall in IDEAS.md
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-11 22:31:37 +02:00
Levi Neely 6f7a11025c move ideas section to monorepo, IDEAS.md 2026-04-11 18:15:23 +02:00
Levi Neely c6aae23c06 remove backup file 2026-04-11 18:13:34 +02:00
Levi Neely 863f60cb48 move doc/ to monorepo 2026-04-11 18:13:21 +02:00