Commit Graph

73 Commits

Author SHA1 Message Date
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