From e9be5b4add7b4ff6b3148ee41d63b53113286277 Mon Sep 17 00:00:00 2001 From: danielvogler Date: Thu, 19 Nov 2026 16:52:22 +0100 Subject: [PATCH 1/4] feat(cli): show every loop in the terminal, and let a shell loop read its inbox - What waits for a person was seen only on the board. `loopcaptain status` prints one line per watched loop, what needs the person first: status, round, last line and what the loop asks. - A loop in shell could report with `emit` and had no way to read what the person sent. `loopcaptain inbox ` prints it, one line each, and marks it read. It prints only lines the board signed for this loop that answer the present asking, so a script cannot take a forged stop by mistake; `--json` shows every entry. - The docs gain a worked `loop.sh` for a Ralph loop, which a test runs as printed: it reports two rounds, hands a note to the agent and takes a stop. --- .agent/FINDINGS.md | 1 - README.md | 7 +- docs/BACKLOG.md | 2 - docs/llms.txt | 1 + docs/reference/cli.md | 26 ++++++ docs/shell-loop.md | 126 +++++++++++++++++++++++++++ scripts/docs_pages.py | 1 + src/loopcaptain/cli.py | 85 ++++++++++++++++++ src/loopcaptain/mcp_server/server.py | 17 +--- src/loopcaptain/protocol/store.py | 20 ++++- tests/test_cli_board.py | 70 +++++++++++++++ tests/test_shell_loop.py | 91 +++++++++++++++++++ zensical.toml | 1 + 13 files changed, 429 insertions(+), 19 deletions(-) create mode 100644 docs/shell-loop.md create mode 100644 tests/test_shell_loop.py diff --git a/.agent/FINDINGS.md b/.agent/FINDINGS.md index 04cb8fc..55c87fc 100644 --- a/.agent/FINDINGS.md +++ b/.agent/FINDINGS.md @@ -46,4 +46,3 @@ in the commit that settles it. Proposed: now, later, check, drop. | F112 | The block-list of key and credential names holds broad patterns (`secrets*`, `*.env`), so ordinary files with such names are refused too | open | check: keep them, or narrow them | src/loopcaptain/board/files.py:61-98 | | F113 | The weekly link check reads the Markdown files only, not the built docs site; about six lines in the workflow would add it | open | check: add it, or skip | .github/workflows/links.yml | | F114 | Discussions are off and the wiki is on with no page, so a question has no place but an issue | open | now: Discussions (Q&A) on, wiki off; a repository setting, no file change | repository settings read 2026-11-19 | -| F115 | The README gives a Ralph loop one line (`emit` once per iteration); no page walks through a worked shell loop that reports to the board | open | later: a "Monitor a Ralph loop" page | README.md:134 | diff --git a/README.md b/README.md index 2c045eb..a26a734 100644 --- a/README.md +++ b/README.md @@ -132,7 +132,9 @@ fault and the loop asks you what to do: [standard/LOOPS.md](standard/LOOPS.md) and call it where a round and a step begin and end, or append the JSON lines yourself. 2. **A Ralph loop or any loop around an agent's command line:** the shell - form, `loopcaptain emit key=value`, once per iteration. + form, `loopcaptain emit key=value` once per iteration and + `loopcaptain inbox ` for your stop and notes; a worked `loop.sh` is + in [docs/shell-loop.md](docs/shell-loop.md). 3. **A long-running agent session:** add the MCP server (`loopcaptain mcp-config `), and the session reports its rounds through five tools. @@ -150,6 +152,9 @@ loopcaptain validate # check a repository's .loops folders loopcaptain doctor # does the loop take a stop? loopcaptain mcp-config # how your agent adds the MCP server loopcaptain emit key=value # one event from a shell loop +loopcaptain inbox # what you sent it, for a shell loop to read +loopcaptain status # where every loop stands, in the terminal +loopcaptain hide # one loop off the first page ``` From a checkout, put `uv run` in front, or use the `make` targets in diff --git a/docs/BACKLOG.md b/docs/BACKLOG.md index f6ac1ae..a7437e6 100644 --- a/docs/BACKLOG.md +++ b/docs/BACKLOG.md @@ -10,7 +10,5 @@ picked are in the ledgers in `.agent/`. | # | Item | From | Picked | |---|---|---|---| -| 1 | `loopcaptain status`: where every watched loop stands, in a terminal. `load_all` in `board/discover.py` already returns what it would print; nothing in the protocol changes | F64 | 2026-11-19 | -| 2 | `loopcaptain inbox `: read a loop's inbox from a shell, and one worked shell loop in the docs, so the shell route the README promises is whole | F49 | 2026-11-19 | | 3 | Tell the person a loop waits while the board's tab is in the background: a count in the tab's title and a browser notification, on 127.0.0.1 only, nothing loaded from another origin | F65 | 2026-11-19 | | 4 | The MCP SDK becomes an extra, `loopcaptain[mcp]`: a plain install pulls in about half as much, `loopcaptain mcp` without the extra says what to install, and the install line for agent sessions in the docs names the extra | F70 | 2026-11-19 | diff --git a/docs/llms.txt b/docs/llms.txt index aa98c6c..2ec6e3e 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -19,6 +19,7 @@ - [LOOPS.md](https://github.com/faviens/loopcaptain/blob/main/standard/LOOPS.md): the protocol, the helper to paste, conformance - [AGENTS.md for a loop](https://github.com/faviens/loopcaptain/blob/main/standard/AGENTS.md): connect a loop, or build one from nothing - [Works with every agent](https://faviens.github.io/loopcaptain/agents/): how each coding agent adds the MCP server +- [Monitor a Ralph or shell loop](https://faviens.github.io/loopcaptain/shell-loop/): a worked loop.sh with `emit` and `inbox` ## Optional diff --git a/docs/reference/cli.md b/docs/reference/cli.md index 2f2bd2f..f9bc9ee 100644 --- a/docs/reference/cli.md +++ b/docs/reference/cli.md @@ -98,6 +98,32 @@ loopcaptain unwatch [-h] path |---|---| | `path` | | +## `status` + +Where every watched loop stands, in a terminal. + +```text +loopcaptain status [-h] [--all] +``` + +| Argument | Meaning | +|---|---| +| `--all` | hidden and finished loops too | + +## `inbox` + +What the person sent a loop since the last call, one line each, for a loop in shell. + +```text +loopcaptain inbox [-h] [--repo REPO] [--json] loop +``` + +| Argument | Meaning | +|---|---| +| `loop` | | +| `--repo` | | +| `--json` | every entry as a JSON line, with signed and stale | + ## `hide` Take one loop off the board's first page and out of its figures. diff --git a/docs/shell-loop.md b/docs/shell-loop.md new file mode 100644 index 0000000..6bf51aa --- /dev/null +++ b/docs/shell-loop.md @@ -0,0 +1,126 @@ +--- +description: "Monitor and steer a Ralph loop or any shell loop around a coding agent: report each iteration with one command, read the person's stop and notes with another." +--- + +# Monitor a Ralph loop or any shell loop + +A Ralph loop is a shell loop that hands the same prompt to a coding agent +again and again until a check passes. It needs no Python and no helper to +show up on the board: two commands do it. + +1. `loopcaptain emit key=value ...` appends one event. +2. `loopcaptain inbox ` prints what you sent from the board since + the last call, one line each, and marks it read. + +`loopcaptain status` then says in a terminal where every watched loop +stands, and the board shows the same with its rounds, its cost and a Stop +button. + +## The loop + +Save this as `loop.sh` in the repository the loop works in. Set +`AGENT_CMD` to your agent's command line, one that reads a prompt on +standard input and prints its answer, and `CHECK_CMD` to the command that +says whether the work is done. + +```bash +#!/usr/bin/env bash +# loop.sh: hand PROMPT.md to an agent until the check passes, and report every round. +set -euo pipefail + +LOOP=ralph +AGENT_CMD=${AGENT_CMD:?set AGENT_CMD to your agent command, reading the prompt on standard input} +CHECK_CMD=${CHECK_CMD:-make test} +MAX_ROUNDS=${MAX_ROUNDS:-20} + +mkdir -p ".loops/$LOOP" out +cat > ".loops/$LOOP/loop.json" </dev/null || true) +round=${round:-0} + +while true; do + # What the person sent since the last round: only lines the board signed are printed. + sent=$(loopcaptain inbox "$LOOP") + if grep -q '^stop' <<<"$sent"; then + loopcaptain emit "$LOOP" loop_stopped stop_reason=person summary="Stopped from the board." + exit 0 + fi + notes=$(grep '^reply' <<<"$sent" | cut -f2- || true) + if [ "$round" -ge "$MAX_ROUNDS" ]; then + loopcaptain emit "$LOOP" loop_stopped stop_reason=round_cap summary="Stopped at $MAX_ROUNDS rounds." + exit 0 + fi + + round=$((round + 1)) + loopcaptain emit "$LOOP" round_started round="$round" + + loopcaptain emit "$LOOP" step_started round="$round" step=agent + { + cat PROMPT.md + if [ -n "$notes" ]; then printf '\nFrom the person:\n%s\n' "$notes"; fi + } | bash -c "$AGENT_CMD" > "out/round-$round.md" + loopcaptain emit "$LOOP" step_finished round="$round" step=agent artifact="out/round-$round.md" + + if bash -c "$CHECK_CMD" > "out/check-$round.log" 2>&1; then + loopcaptain emit "$LOOP" step_finished round="$round" step=check passed=true + loopcaptain emit "$LOOP" round_finished round="$round" verdict=done stop_reason=goal_met \ + summary="The check passes." + exit 0 + fi + loopcaptain emit "$LOOP" step_finished round="$round" step=check passed=false \ + artifact="out/check-$round.log" + loopcaptain emit "$LOOP" round_finished round="$round" verdict=continue \ + summary="The check still fails." +done +``` + +## Run it and watch it + +```bash +AGENT_CMD='your-agent --print' bash loop.sh # from the repository +loopcaptain watch . # once: put the repository on the board +loopcaptain status # where it stands, in a terminal +loopcaptain serve # the board; open the address it prints +``` + +On the board the loop shows each round with its two steps, the agent's +output and the check's log as files to open, and a Stop button. Stop is +taken before the next round starts. A note typed on the loop's page is +handed to the agent with the next prompt, under "From the person". + +## What the two commands print + +```console +$ loopcaptain inbox ralph +reply Leave the migration alone, fix the tests first. +stop +$ loopcaptain inbox ralph --json +{"id": "...", "kind": "stop", "signed": true, "stale": false, ...} +``` + +Without `--json`, `inbox` prints only what a loop may act on: lines the +board signed for this loop that answer the present asking, as the kind, a +tab and the text on one line. Anything else in the file (a line an agent +wrote, a reply to a question asked earlier) is counted on standard error +and left out, so a script that reads the lines cannot take a forged stop +by mistake. `--json` prints every entry with `signed` and `stale`. + +A value in `emit` is read as JSON where it parses (`round=2`, +`passed=true`) and as text where the field is text. `loopcaptain validate +.` checks what the loop wrote, and `loopcaptain doctor . ralph` sends a +stop and tells you whether the loop took it. diff --git a/scripts/docs_pages.py b/scripts/docs_pages.py index 735c270..ee79bca 100644 --- a/scripts/docs_pages.py +++ b/scripts/docs_pages.py @@ -96,6 +96,7 @@ def llms_txt() -> str: f"- [LOOPS.md]({files}/standard/LOOPS.md): the protocol, the helper to paste, conformance", f"- [AGENTS.md for a loop]({files}/standard/AGENTS.md): connect a loop, or build one from nothing", f"- [Works with every agent]({site}/agents/): how each coding agent adds the MCP server", + f"- [Monitor a Ralph or shell loop]({site}/shell-loop/): a worked loop.sh with `emit` and `inbox`", "", "## Optional", "", diff --git a/src/loopcaptain/cli.py b/src/loopcaptain/cli.py index 17a9204..06edec0 100644 --- a/src/loopcaptain/cli.py +++ b/src/loopcaptain/cli.py @@ -8,6 +8,7 @@ import socket import sys from collections.abc import Callable +from dataclasses import replace from importlib.metadata import version as package_version from pathlib import Path @@ -18,14 +19,19 @@ from loopcaptain.board.discover import ( CONFIG_ENV, Config, + LoopView, as_written, config_in_use, config_target, edit_config, find_repos, + load_all, load_config, + put_aside, survey, ) +from loopcaptain.board.filters import ago +from loopcaptain.board.overview import GROUPS, group_of from loopcaptain.protocol import spec_text, store from loopcaptain.protocol.doctor import examine from loopcaptain.protocol.models import EVENT_NAMES, FOLDER, AnyEvent, InboxEntry, Manifest, now @@ -242,6 +248,16 @@ def build_parser() -> argparse.ArgumentParser: watch.add_argument("--root", action="store_true", help="every sub-folder with .loops/ is a repository") unwatch = commands.add_parser("unwatch", help="take a folder off the board") unwatch.add_argument("path", type=Path) + status = commands.add_parser("status", help="where every watched loop stands, in a terminal") + status.add_argument("--all", action="store_true", help="hidden and finished loops too") + inbox = commands.add_parser( + "inbox", help="what the person sent a loop since the last call, one line each, for a loop in shell" + ) + inbox.add_argument("loop") + inbox.add_argument("--repo", type=Path, default=Path(".")) + inbox.add_argument( + "--json", action="store_true", help="every entry as a JSON line, with signed and stale" + ) for name, about in ( ("hide", "take one loop off the board's first page and out of its figures"), ("unhide", "show a hidden loop on the first page again"), @@ -350,6 +366,73 @@ def run_unhide(args: argparse.Namespace) -> int: return 0 +def status_lines(views: list[LoopView], *, everything: bool) -> list[str]: + """One line per loop, what needs the person first: status, where, round, last line, what it asks.""" + order = list(GROUPS) + kept = [view for view in views if everything or group_of(view) not in ("hidden", "finished")] + kept.sort(key=lambda view: (order.index(group_of(view)), view.repo.key, view.loop_id)) + width = max((len(f"{view.repo.key}/{view.loop_id}") for view in kept), default=0) + lines = [] + for view in kept: + state, name = view.state, f"{view.repo.key}/{view.loop_id}" + if state is None: + lines.append(f"{'unreadable':10} {name:{width}} {view.error}") + continue + last = state.last_round + told = f"asks: {state.question.text}" if state.question else state.last_line + parts = [ + f"round {last.number}" if last else "no round", + ago(state.last_event), + " ".join(told.split()), + ] + lines.append(f"{state.status:10} {name:{width}} " + " ".join(part for part in parts if part)) + return lines + + +def run_status(args: argparse.Namespace) -> int: + config = load_config() + views = [replace(view, hidden=put_aside(config, view.repo, view.loop_id)) for view in load_all(config)] + lines = status_lines(views, everything=args.all) + waiting = sum(1 for view in views if not view.hidden and view.state and view.state.question) + left_out = len(views) - len(lines) + say(lines or ["no loop to show"]) + say( + [ + f"{waiting} waiting for you" + + (f", {left_out} hidden or finished not shown (--all)" if left_out else "") + ] + ) + return 0 + + +def run_inbox(args: argparse.Namespace) -> int: + """The loop's side of the inbox for a loop that is no Python: what the person sent, marked read. + + Without `--json` only what a loop may act on is printed, `kind`, a tab, the text on one line: + entries the board signed for this loop that answer the present asking. The rest is counted + on standard error, so a script that reads the lines cannot take a forged one by mistake.""" + repo = args.repo.expanduser().resolve() + if args.loop not in store.loop_ids(repo): + raise StoreError(f"no loop {args.loop!r} in {args.repo}") + entries = store.taken(repo, args.loop) + if args.json: + say([json.dumps(entry, ensure_ascii=False) for entry in entries]) + return 0 + good = [entry for entry in entries if entry["signed"] is True and not entry["stale"]] + say([f"{entry['kind']}\t{' '.join(str(entry.get('text', '')).split())}" for entry in good]) + if len(good) < len(entries): + unchecked = any(entry["signed"] is None for entry in entries) + why = ( + "this loop's key cannot be read, so nothing was checked" + if unchecked + else "not from the board, or stale" + ) + sys.stderr.write( + f"loopcaptain: {len(entries) - len(good)} entry(ies) left out: {why}; --json shows them\n" + ) + return 0 + + def run_demo(args: argparse.Namespace) -> int: from loopcaptain.demo import DemoError, write_demo @@ -407,6 +490,8 @@ def run_serve(args: argparse.Namespace) -> int: "doctor": run_doctor, "watch": run_watch, "unwatch": run_unwatch, + "status": run_status, + "inbox": run_inbox, "hide": run_hide, "unhide": run_unhide, "demo": run_demo, diff --git a/src/loopcaptain/mcp_server/server.py b/src/loopcaptain/mcp_server/server.py index 28ddd10..dd33607 100644 --- a/src/loopcaptain/mcp_server/server.py +++ b/src/loopcaptain/mcp_server/server.py @@ -18,8 +18,8 @@ from pydantic import ValidationError from loopcaptain.protocol import spec_text, store -from loopcaptain.protocol.models import EVENT_NAMES, Manifest, Question, now -from loopcaptain.protocol.signing import is_signed, read_loop_key, unchecked_ids +from loopcaptain.protocol.models import EVENT_NAMES, Manifest, now +from loopcaptain.protocol.signing import unchecked_ids from loopcaptain.protocol.state import fold from loopcaptain.protocol.store import StoreError from loopcaptain.protocol.validate import before_writing @@ -160,18 +160,7 @@ def inbox_read(loop_id: str, repo: str = ".") -> list[dict[str, Any]]: stale: true for a reply that names a question and was written before you last asked that question: it answers an earlier asking, do not take it as the answer now. """ - path = known_loop(repo, loop_id) - key = read_loop_key(store.loop_dir(path, loop_id)) - events, _ = store.read_events(path, loop_id) - asked = {event.id: event.ts for event in events if isinstance(event, Question) and event.id} - return [ - { - **entry.model_dump(mode="json", exclude_none=True), - "signed": is_signed(entry.body(), key, loop_id), - "stale": entry.question in asked and entry.ts < asked[entry.question], - } - for entry in store.take_inbox(path, loop_id) - ] + return store.taken(known_loop(repo, loop_id), loop_id) @server.tool() diff --git a/src/loopcaptain/protocol/store.py b/src/loopcaptain/protocol/store.py index 83e68a7..88c23c4 100644 --- a/src/loopcaptain/protocol/store.py +++ b/src/loopcaptain/protocol/store.py @@ -29,10 +29,11 @@ InboxKind, InboxRead, Manifest, + Question, is_slug, now, ) -from loopcaptain.protocol.signing import BoardKeys, hand_out, marks +from loopcaptain.protocol.signing import BoardKeys, hand_out, is_signed, marks, read_loop_key from loopcaptain.protocol.state import STALE_AFTER #: The most the board reads of one file. A summary log of a long loop is a few hundred kilobytes. @@ -308,6 +309,23 @@ def take_inbox(repo: Path, loop_id: str) -> list[InboxEntry]: return fresh +def taken(repo: Path, loop_id: str) -> list[dict[str, Any]]: + """What the person sent since the last call, as every way in hands it to a loop: each entry + with `signed` (true only for a line the board wrote for this loop, None where the loop's key + cannot be read) and `stale` (a reply to an earlier asking of its question). Marks them read.""" + key = read_loop_key(loop_dir(repo, loop_id)) + events, _ = read_events(repo, loop_id) + asked = {event.id: event.ts for event in events if isinstance(event, Question) and event.id} + return [ + { + **entry.model_dump(mode="json", exclude_none=True), + "signed": is_signed(entry.body(), key, loop_id), + "stale": entry.question in asked and entry.ts < asked[entry.question], + } + for entry in take_inbox(repo, loop_id) + ] + + def fingerprint(repo: Path, loop_id: str) -> str: """Changes whenever any of the loop's files does, and once more when the loop has written nothing for so long that a round under way reads as stalled; the page polls it to know when diff --git a/tests/test_cli_board.py b/tests/test_cli_board.py index 2e8432e..19ba856 100644 --- a/tests/test_cli_board.py +++ b/tests/test_cli_board.py @@ -3,6 +3,7 @@ from __future__ import annotations import ast +import json import socket import types from pathlib import Path @@ -17,6 +18,7 @@ from loopcaptain.board.discover import Config, load_config, parse_config from loopcaptain.board.steer import Runner from loopcaptain.cli import main as cli_main +from loopcaptain.protocol import signing, store @pytest.fixture @@ -497,3 +499,71 @@ def test_hide_refuses_a_loop_that_is_not_there( assert "no loop 'ghost'" in capsys.readouterr().err assert not (home / ".config" / "loopcaptain" / "config.yaml").exists() + + +def test_status_says_in_a_terminal_where_every_watched_loop_stands( + scan: Path, + helper: types.ModuleType, + tmp_path: Path, + monkeypatch: pytest.MonkeyPatch, + capsys: pytest.CaptureFixture[str], +) -> None: + """What waits was seen only on the board; a person in a terminal had to open a browser to know.""" + helper.register("asks", {"title": "Asks"}, scan) + helper.emit("asks", "round_started", {"round": 1}, scan) + helper.emit("asks", "question", {"id": "seats", "text": "Per seat\nor per team?"}, scan) + helper.register("over", {"title": "Over"}, scan) + helper.emit("over", "round_started", {"round": 1}, scan) + helper.emit("over", "round_finished", {"round": 1, "verdict": "done"}, scan) + config = tmp_path / "config.yaml" + config.write_text(f"repos:\n - {scan}\nhidden:\n - {scan}/.loops/scan\n") + monkeypatch.setenv("LOOPCAPTAIN_CONFIG", str(config)) + + assert cli_main(["status"]) == 0 + shown = capsys.readouterr().out.splitlines() + assert cli_main(["status", "--all"]) == 0 + everything = capsys.readouterr().out + + assert len(shown) == 2 and shown[0].startswith("running some-repo/asks round 1") + assert shown[0].endswith("asks: Per seat or per team?") + assert shown[1] == "1 waiting for you, 2 hidden or finished not shown (--all)" + assert "some-repo/scan" in everything and "done some-repo/over" in everything + + +def test_inbox_prints_what_a_shell_loop_may_act_on_and_marks_it_read( + scan: Path, capsys: pytest.CaptureFixture[str] +) -> None: + """A loop in shell could write events with `emit` and had no way to read what the person sent.""" + keys = signing.board_keys() + store.append_inbox(scan, "scan", "reply", "Look at\nprices first.", keys=keys) + store.append_inbox(scan, "scan", "stop", keys=keys) + store.append_line( + scan / ".loops" / "scan" / "inbox.jsonl", '{"id": "f1", "ts": "2026-11-15T00:00:00Z", "kind": "stop"}' + ) + + assert cli_main(["inbox", "scan", "--repo", str(scan)]) == 0 + first = capsys.readouterr() + assert cli_main(["inbox", "scan", "--repo", str(scan)]) == 0 + second = capsys.readouterr() + + assert first.out == "reply\tLook at prices first.\nstop\t\n" + assert "1 entry(ies) left out: not from the board, or stale" in first.err + assert second.out == "" and second.err == "" + + +def test_inbox_as_json_shows_every_entry_with_what_was_checked( + scan: Path, capsys: pytest.CaptureFixture[str] +) -> None: + store.append_inbox(scan, "scan", "stop", keys=signing.board_keys()) + store.append_line( + scan / ".loops" / "scan" / "inbox.jsonl", '{"id": "f1", "ts": "2026-11-15T00:00:00Z", "kind": "stop"}' + ) + + assert cli_main(["inbox", "scan", "--repo", str(scan), "--json"]) == 0 + lines = [json.loads(line) for line in capsys.readouterr().out.splitlines()] + + assert [(entry["kind"], entry["signed"], entry["stale"]) for entry in lines] == [ + ("stop", True, False), + ("stop", False, False), + ] + assert cli_main(["inbox", "ghost", "--repo", str(scan)]) == 1 diff --git a/tests/test_shell_loop.py b/tests/test_shell_loop.py new file mode 100644 index 0000000..b26c641 --- /dev/null +++ b/tests/test_shell_loop.py @@ -0,0 +1,91 @@ +"""The worked shell loop of the docs runs as printed: it reports, takes a note and a stop, and ends.""" + +from __future__ import annotations + +import os +import re +import subprocess +import sys +from pathlib import Path + +from loopcaptain.protocol import signing, store +from loopcaptain.protocol.models import now +from loopcaptain.protocol.state import LoopState, fold +from loopcaptain.protocol.validate import validate_report + +ROOT = Path(__file__).resolve().parents[1] +#: An agent that needs two runs: the first leaves a mark, the second finishes the work. +AGENT = "cat >> seen-prompt.txt; if [ -f once ]; then touch finished; fi; touch once; echo worked" + + +def loop_script() -> str: + page = (ROOT / "docs" / "shell-loop.md").read_text(encoding="utf-8") + found = re.search(r"```bash\n(#!/usr/bin/env bash\n# loop\.sh.*?)```", page, re.DOTALL) + assert found is not None + return found.group(1) + + +def run(repo: Path, *, agent: str = AGENT) -> None: + # `loopcaptain` as this checkout has it, whatever else of that name is installed on the machine. + shim = repo.parent / "bin" + shim.mkdir(exist_ok=True) + source = ROOT / "src" + (shim / "loopcaptain").write_text( + f'#!/bin/sh\nPYTHONPATH="{source}" exec "{sys.executable}" -m loopcaptain.cli "$@"\n' + ) + (shim / "loopcaptain").chmod(0o755) + env = { + # Without a file a non-interactive bash reads first: on some machines it puts another PATH first. + **{name: value for name, value in os.environ.items() if name not in ("BASH_ENV", "ENV")}, + "PATH": f"{shim}{os.pathsep}{os.environ['PATH']}", + "AGENT_CMD": agent, + "CHECK_CMD": "test -f finished", + "MAX_ROUNDS": "3", + } + subprocess.run(["bash", "loop.sh"], cwd=repo, env=env, check=True, timeout=120) + + +def state_of(repo: Path) -> LoopState: + events, problems = store.read_events(repo, "ralph") + assert problems == [] + return fold(store.read_manifest(repo, "ralph"), events, store.read_inbox(repo, "ralph")[0], now()) + + +def shell_repo(tmp_path: Path) -> Path: + repo = tmp_path / "shell" + repo.mkdir(parents=True) + (repo / "loop.sh").write_text(loop_script(), encoding="utf-8") + (repo / "PROMPT.md").write_text("Make the check pass.\n", encoding="utf-8") + return repo + + +def test_the_shell_loop_of_the_docs_reports_its_rounds_and_ends_done(tmp_path: Path) -> None: + repo = shell_repo(tmp_path) + + run(repo) + + state = state_of(repo) + assert [round_.verdict for round_ in state.rounds] == ["continue", "done"] and state.status == "done" + assert validate_report(repo).problems == [] + assert (repo / "out" / "round-2.md").read_text(encoding="utf-8") == "worked\n" + + +def test_the_shell_loop_hands_a_note_to_the_agent_and_takes_a_stop(tmp_path: Path) -> None: + repo = shell_repo(tmp_path) + run(repo, agent="cat > seen-prompt.txt; echo tried") # never done: it stops at its cap + assert state_of(repo).status != "done" + keys = signing.board_keys() + store.append_inbox(repo, "ralph", "stop", keys=keys) + run(repo) + stopped = state_of(repo) + + fresh = shell_repo(tmp_path / "second") + (fresh / ".loops" / "ralph").mkdir(parents=True) + (fresh / ".loops" / "ralph" / "loop.json").write_text('{"protocol": 1, "id": "ralph"}', encoding="utf-8") + store.append_inbox(fresh, "ralph", "reply", "Leave the migration alone.", keys=keys) + run(fresh) + + assert stopped.ended is not None and stopped.ended.stop_reason == "person" + assert "From the person:\nLeave the migration alone." in (fresh / "seen-prompt.txt").read_text( + encoding="utf-8" + ) diff --git a/zensical.toml b/zensical.toml index c3c5f38..8617cd1 100644 --- a/zensical.toml +++ b/zensical.toml @@ -12,6 +12,7 @@ nav = [ { "Get started" = "get-started.md" }, { "Setup" = "setup.md" }, { "Connect or build a loop" = "connect.md" }, + { "Monitor a Ralph or shell loop" = "shell-loop.md" }, { "Works with every agent" = "agents.md" }, { "The board" = "board.md" }, { "The protocol" = "protocol/index.md" }, From 014ebe10008ff8e2479d0bdfc719c5981db8b8b2 Mon Sep 17 00:00:00 2001 From: danielvogler Date: Thu, 19 Nov 2026 16:55:16 +0100 Subject: [PATCH 2/4] feat(board): tell a tab in the background that a loop waits - A tab that is not in front was never drawn again, so the count in its title stayed as it was and a loop could wait unseen for hours. - The pulse the page polls now carries how many loops wait. A tab in the background puts that count in its title, and shows a browser notification when it rises, where the person allowed one through the button in the footer. - A tab that comes back in front draws what changed at once. - Everything stays on this machine: the notification is made by the page's own script, and no page loads anything from another origin. --- .agent/DEFERRED_VERIFICATION.md | 1 + docs/BACKLOG.md | 1 - src/loopcaptain/board/app.py | 10 ++++-- src/loopcaptain/board/static/board.js | 43 +++++++++++++++++++++-- src/loopcaptain/board/static/style.css | 1 + src/loopcaptain/board/templates/base.html | 2 +- tests/test_board.py | 20 +++++++++++ 7 files changed, 71 insertions(+), 7 deletions(-) diff --git a/.agent/DEFERRED_VERIFICATION.md b/.agent/DEFERRED_VERIFICATION.md index 0f63228..c8944d7 100644 --- a/.agent/DEFERRED_VERIFICATION.md +++ b/.agent/DEFERRED_VERIFICATION.md @@ -24,3 +24,4 @@ is named in the commit that closes it. | the key per loop | Seen on a running board over the example loop on 2026-11-19: Stop wrote a line with `loop_sig` and `sig`, the key files had mode 0600 in a 0700 folder, and the example's own helper read the line as signed True. Not seen: a machine that already has an `inbox.key` and inboxes full of lines with `sig` only, and a loop with a helper pasted from the earlier text | After the upgrade earlier answers read as not from the board and a waiting question shows again, or a loop with the earlier helper stops taking a Stop | A board of the new version started on a machine with earlier loops: an earlier answer still reads as the board's (its mark is in the loop's `.earlier` list), and `loopcaptain doctor` passes on a loop with the earlier helper | | the page limits, the open questions, the turn of a sleeping page | Seen on a running board on 2026-11-19: a loop of 75 rounds drawn 30 at a time with links to the rest, two open questions shown one after the other, an open page of a sleeping loop turning to stalled by itself, the example loop started from the board, answered with a button and going on. Not seen: the notice beside Start that a Stop is waiting, the Copy buttons of an empty board, `watch` and `unwatch` on a config a person wrote by hand, a log near 20 MB from a real loop | A wording or a layout reads worse live than in a test; a real config has a shape the line editor does not know and is written anew | Each opened or run once on a real board and a real config | | hiding a loop, the old mark | Seen on a running board on 2026-11-19: `hide` took a waiting loop off an open first page, which reloaded by itself, out of the waiting count and the figures, the `hidden` chip listed it, its page opened with the command that shows it again, `unhide` brought it back; a loop silent for 20 days showed as stalled, marked old, outside the count of loops that need a look. Not seen: a loop hidden from one worktree and read from another, and `hide` on a config a person wrote by hand | A hidden loop comes back when its repository is read from another worktree | A loop hidden in the main checkout stays hidden while a worktree of that repository writes last | +| the waiting count in a background tab | Seen in Chrome on a running board on 2026-11-19, with the tab made to read as hidden and the notification replaced by a recorder: a second loop asked, the title went from (1) to (2) without the page being drawn again, and one notification was made. Not seen: the browser's own permission prompt answered by a person and the notification the system then shows; `status` and `inbox` were run against a real board's loops | The system shows nothing, or shows it for every poll | Notify allowed in the footer, the board's tab put behind another, a loop made to ask: one notification, and a click on it brings the tab forward | diff --git a/docs/BACKLOG.md b/docs/BACKLOG.md index a7437e6..9bc37db 100644 --- a/docs/BACKLOG.md +++ b/docs/BACKLOG.md @@ -10,5 +10,4 @@ picked are in the ledgers in `.agent/`. | # | Item | From | Picked | |---|---|---|---| -| 3 | Tell the person a loop waits while the board's tab is in the background: a count in the tab's title and a browser notification, on 127.0.0.1 only, nothing loaded from another origin | F65 | 2026-11-19 | | 4 | The MCP SDK becomes an extra, `loopcaptain[mcp]`: a plain install pulls in about half as much, `loopcaptain mcp` without the extra says what to install, and the install line for agent sessions in the docs names the extra | F70 | 2026-11-19 | diff --git a/src/loopcaptain/board/app.py b/src/loopcaptain/board/app.py index 9a552d3..fff64d7 100644 --- a/src/loopcaptain/board/app.py +++ b/src/loopcaptain/board/app.py @@ -261,6 +261,12 @@ def totals() -> dict[str, object] | None: templates.env.globals["totals"] = totals + def waiting_now() -> int: + """How many loops wait for the person: a tab in the background shows it in its title and + says so in a notification, without drawing the page again.""" + figures = totals() + return int(cast(int, figures["waiting"])) if figures else 0 + def overview_fingerprint() -> str: """From file stats alone, in discovery order: the overview polls it every few seconds. Which loops are hidden is part of it: `hide` changes the page and no loop's file.""" @@ -372,7 +378,7 @@ def rank(view: LoopView) -> tuple[int, float]: @app.get("/pulse", name="overview_pulse") def overview_pulse() -> JSONResponse: try: - return JSONResponse({"pulse": overview_fingerprint()}) + return JSONResponse({"pulse": overview_fingerprint(), "waiting": waiting_now()}) except StoreError: return JSONResponse({"pulse": "error"}) @@ -435,7 +441,7 @@ def loop_pulse(repo_key: str, loop_id: str) -> JSONResponse: found = find_loop(config(), repo_key, loop_id) if found is None: raise HTTPException(404, "no such loop on this board") - return JSONResponse({"pulse": pulse_of(found[0], loop_id, steer)}) + return JSONResponse({"pulse": pulse_of(found[0], loop_id, steer), "waiting": waiting_now()}) @app.get("/loop/{repo_key}/{loop_id}/file", response_class=HTMLResponse, name="loop_file") def loop_file(request: Request, repo_key: str, loop_id: str, path: str) -> Response: diff --git a/src/loopcaptain/board/static/board.js b/src/loopcaptain/board/static/board.js index 482d5d3..d5f8ed1 100644 --- a/src/loopcaptain/board/static/board.js +++ b/src/loopcaptain/board/static/board.js @@ -26,8 +26,25 @@ return typed || document.querySelector("table.items details[open]") !== null; } + // A tab in the background is not drawn again, but it still says how many loops wait: in its + // title, and in a notification where the person allowed one. Nothing leaves this machine. + var canNotify = "Notification" in window; + var waiting = Number((document.title.match(/^\((\d+)\) /) || [0, 0])[1]); + + function showWaiting(count) { + if (typeof count !== "number" || count === waiting) return; + document.title = (count ? "(" + count + ") " : "") + document.title.replace(/^\(\d+\) /, ""); + if (count > waiting && canNotify && Notification.permission === "granted") { + var note = new Notification(count === 1 ? "A loop waits for you" : count + " loops wait for you", { + body: "Loopcaptain: open the board to answer.", + tag: "loopcaptain-waiting" + }); + note.onclick = function () { window.focus(); note.close(); }; + } + waiting = count; + } + function poll() { - if (document.hidden) return; fetch(url, { cache: "no-store" }) .then(function (response) { // 401: the board was started again and no longer knows this browser; the reload says so. @@ -35,12 +52,32 @@ return response.ok ? response.json() : null; }) .then(function (data) { - if (data && data.pulse !== seen && !busy()) window.location.reload(); + if (!data) return; + if (document.hidden) showWaiting(data.waiting); + else if (data.pulse !== seen && !busy()) window.location.reload(); }) .catch(function () { /* the board is restarting; the next poll tries again */ }); } - if (url) window.setInterval(poll, POLL_MS); + if (url) { + window.setInterval(poll, POLL_MS); + // Back in front: draw what changed meanwhile at once, not at the next tick. + document.addEventListener("visibilitychange", function () { if (!document.hidden) poll(); }); + } + + // Asking for a notification needs the person's own click; the footer offers it once. + var ask = document.querySelector("[data-notify]"); + var asked = document.querySelector("[data-notify-on]"); + if (ask && canNotify) { + ask.hidden = Notification.permission !== "default"; + asked.hidden = Notification.permission !== "granted"; + ask.addEventListener("click", function () { + Notification.requestPermission().then(function (answer) { + ask.hidden = true; + asked.hidden = answer !== "granted"; + }); + }); + } // A loop that said when it is back turns to stalled when that time passes, and no file changes // then, so the pulse stays as it is. The page names the moment; look again once it has come. diff --git a/src/loopcaptain/board/static/style.css b/src/loopcaptain/board/static/style.css index 1fe3fad..81b08bf 100644 --- a/src/loopcaptain/board/static/style.css +++ b/src/loopcaptain/board/static/style.css @@ -99,6 +99,7 @@ nav.strip a[aria-current] { background: var(--surface); color: var(--text); font the menu at its edges. */ :root { --page: 1560px; } main { width: 100%; max-width: var(--page); margin: 0 auto; padding: var(--s4) var(--s4) var(--s6); flex: 1; } +.foot button.link { min-height: 0; padding: 0; border: 0; background: none; color: var(--accent); font: inherit; text-decoration: underline; text-underline-offset: 3px; cursor: pointer; box-shadow: none; } .foot { width: 100%; max-width: var(--page); margin: 0 auto; padding: var(--s3) var(--s4) var(--s5); color: var(--text-2); font-size: var(--t12); border-top: 1px solid var(--line); } .crumb { font-size: var(--t14); color: var(--text-2); margin: 0; } /* the way back to the list: a link that reads as one and a target as tall as any control */ diff --git a/src/loopcaptain/board/templates/base.html b/src/loopcaptain/board/templates/base.html index 247f047..ce3b1d6 100644 --- a/src/loopcaptain/board/templates/base.html +++ b/src/loopcaptain/board/templates/base.html @@ -32,6 +32,6 @@
{% block main %}{% endblock %}
-
Reads each loop's .loops/ folder on every request. Answers only on this machine.
+
Reads each loop's .loops/ folder on every request. Answers only on this machine.
diff --git a/tests/test_board.py b/tests/test_board.py index 636d649..cc311ef 100644 --- a/tests/test_board.py +++ b/tests/test_board.py @@ -801,6 +801,26 @@ def later(days: int) -> datetime: assert 'class="pill stalled"' in old and 'class="old"' in old +def test_a_tab_in_the_background_learns_how_many_loops_wait_and_may_say_so( + client: TestClient, scan: Path, helper: types.ModuleType +) -> None: + """A tab that is not in front is not drawn again, so its title kept an old count and nothing told the person.""" + before = ( + client.get("/pulse").json()["waiting"], + client.get("/loop/some-repo/scan/pulse").json()["waiting"], + ) + helper.emit("scan", "question", {"id": "seats", "text": "Per seat?"}, scan) + after = client.get("/pulse").json()["waiting"], client.get("/loop/some-repo/scan/pulse").json()["waiting"] + page = client.get("/").text + script = (Path(steer.__file__).parent / "static" / "board.js").read_text(encoding="utf-8") + + assert before == (0, 0) and after == (1, 1) + assert "data-notify hidden" in page and "data-notify-on hidden" in page + assert "if (document.hidden) showWaiting(data.waiting);" in script + assert 'Notification.permission === "granted"' in script and "Notification.requestPermission()" in script + assert "http" not in script.split("new Notification")[1].split("};")[0] # nothing fetched to say it + + def test_every_status_has_a_place_on_the_overview_and_a_meaning() -> None: assert set(get_args(Status)) == set(STATUS_ORDER) == set(STATUS_TEXT) From 4318d7b4cd432ed13201fd8a7fe702477c03e0de Mon Sep 17 00:00:00 2001 From: danielvogler Date: Thu, 19 Nov 2026 16:58:45 +0100 Subject: [PATCH 3/4] feat(package)!: make the MCP server an extra, loopcaptain[mcp] - The MCP SDK came with every install though only a loop driven by an agent session uses it: a plain install is 21 packages and 12 MB without it, 36 packages and 28 MB with it. - `loopcaptain mcp` on an install without the extra ends with one line that names the install command, and `mcp-config` says the same beside the block it prints. The board, the helper, `emit`, `inbox` and every other command need nothing more than before. BREAKING CHANGE: `loopcaptain mcp` needs the package installed as `loopcaptain[mcp]`. An agent session set up against a plain install gets the one-line message until it is reinstalled with the extra. --- AGENTS.md | 3 ++- docs/BACKLOG.md | 1 - docs/agents.md | 3 ++- docs/installation.md | 8 ++++++++ pyproject.toml | 7 ++++++- src/loopcaptain/agents.py | 3 ++- src/loopcaptain/cli.py | 13 ++++++++++++- tests/test_mcp.py | 21 +++++++++++++++++++++ uv.lock | 11 +++++++++-- 9 files changed, 62 insertions(+), 8 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index c82faee..4f15c20 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -87,7 +87,8 @@ Work in the loop's repository, not here, and follow [standard/AGENTS.md](standard/AGENTS.md); propose the smallest change and wait for a yes. Do not add this repository as a dependency of a loop. A loop an agent session drives adds the MCP server, `loopcaptain mcp` over -stdio: `loopcaptain mcp-config ` prints the line for it, +stdio, installed with its extra (`uv tool install 'loopcaptain[mcp]'`): +`loopcaptain mcp-config ` prints the line for it, [docs/agents.md](docs/agents.md) lists every agent. ### What the board does and does not do diff --git a/docs/BACKLOG.md b/docs/BACKLOG.md index 9bc37db..e60653d 100644 --- a/docs/BACKLOG.md +++ b/docs/BACKLOG.md @@ -10,4 +10,3 @@ picked are in the ledgers in `.agent/`. | # | Item | From | Picked | |---|---|---|---| -| 4 | The MCP SDK becomes an extra, `loopcaptain[mcp]`: a plain install pulls in about half as much, `loopcaptain mcp` without the extra says what to install, and the install line for agent sessions in the docs names the extra | F70 | 2026-11-19 | diff --git a/docs/agents.md b/docs/agents.md index f0e864b..6249f5e 100644 --- a/docs/agents.md +++ b/docs/agents.md @@ -5,7 +5,8 @@ description: "Use Loopcaptain from Claude Code, Codex, Gemini CLI, Cursor, VS Co # Works with every agent The protocol names no vendor: a loop writes its files, whatever runs it. Around it, each -agent adds the MCP server its own way. The server is `loopcaptain mcp`, over stdio. +agent adds the MCP server its own way. The server is `loopcaptain mcp`, over stdio. It needs +the MCP extra, which a plain install leaves out: `uv tool install 'loopcaptain[mcp]'`. The lines below are for the installed command. From a checkout of the repository the server is `uv run --project loopcaptain mcp`, and `loopcaptain mcp-config `, run diff --git a/docs/installation.md b/docs/installation.md index 25d3dfb..bd14a98 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -50,6 +50,14 @@ loopcaptain --version To run it once without installing, `uvx loopcaptain demo` and `uvx loopcaptain serve` do the same from a temporary environment. +A loop that an agent session drives reports through the MCP server, +`loopcaptain mcp`. Its SDK is an extra, since the board, the pasted helper +and the command line need none of it: + +```bash +uv tool install 'loopcaptain[mcp]' # or: pipx install 'loopcaptain[mcp]' +``` + ## Install from the repository A release is also a tag in the repository. Name the tag, so the install diff --git a/pyproject.toml b/pyproject.toml index 198d78e..bfdddcc 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -31,13 +31,17 @@ dependencies = [ "fastapi>=0.115", "jinja2>=3.1", "markdown-it-py>=3.0", - "mcp>=2.0", "pydantic>=2.7", "python-multipart>=0.0.9", "pyyaml>=6.0", "uvicorn>=0.30", ] +# The MCP server, for a loop an agent session drives: `uv tool install 'loopcaptain[mcp]'`. The board, +# the helper and the command line need none of it, and the SDK was about half of a plain install. +[project.optional-dependencies] +mcp = ["mcp>=2.0"] + [project.urls] Documentation = "https://faviens.github.io/loopcaptain/" Repository = "https://github.com/faviens/loopcaptain" @@ -50,6 +54,7 @@ loopcaptain = "loopcaptain.cli:main" [dependency-groups] dev = [ "httpx>=0.27", + "mcp>=2.0", "mypy>=1.11", "pre-commit>=4.0", "pytest>=8", diff --git a/src/loopcaptain/agents.py b/src/loopcaptain/agents.py index 37fb4b2..125a9a7 100644 --- a/src/loopcaptain/agents.py +++ b/src/loopcaptain/agents.py @@ -138,7 +138,8 @@ def markdown(checkout: str = "") -> str: "# Works with every agent", "", "The protocol names no vendor: a loop writes its files, whatever runs it. Around it, each", - "agent adds the MCP server its own way. The server is `loopcaptain mcp`, over stdio.", + "agent adds the MCP server its own way. The server is `loopcaptain mcp`, over stdio. It needs", + "the MCP extra, which a plain install leaves out: `uv tool install 'loopcaptain[mcp]'`.", "", "The lines below are for the installed command. From a checkout of the repository the server", f"is `{' '.join(server_argv(''))}`, and `loopcaptain mcp-config `, run", diff --git a/src/loopcaptain/cli.py b/src/loopcaptain/cli.py index 06edec0..fd3d47b 100644 --- a/src/loopcaptain/cli.py +++ b/src/loopcaptain/cli.py @@ -450,6 +450,10 @@ def run_demo(args: argparse.Namespace) -> int: return 0 +#: How the MCP server gets its SDK, said wherever it is missing or about to be needed. +MCP_EXTRA = "Install with it: `uv tool install 'loopcaptain[mcp]'` (or `pipx install 'loopcaptain[mcp]'`)" + + def run_mcp_config(args: argparse.Namespace) -> int: if args.markdown: sys.stdout.write(markdown()) @@ -462,6 +466,8 @@ def run_mcp_config(args: argparse.Namespace) -> int: except KeyError as error: raise StoreError(str(error.args[0])) from error sys.stdout.write(f"{item.name}\n\n{item.add}\n\nunattended: {item.headless}\n") + if not args.checkout: + sys.stdout.write(f"\nthe server needs the MCP extra. {MCP_EXTRA}\n") return 0 @@ -471,7 +477,12 @@ def run_spec(args: argparse.Namespace) -> int: def run_mcp(args: argparse.Namespace) -> int: - from loopcaptain.mcp_server.server import serve_stdio + try: + from loopcaptain.mcp_server.server import serve_stdio + except ImportError as error: + if (error.name or "").split(".")[0] != "mcp": + raise + raise StoreError(f"the MCP server needs the extra, which is not installed. {MCP_EXTRA}") from error serve_stdio() return 0 diff --git a/tests/test_mcp.py b/tests/test_mcp.py index 1ef530f..0c8dc2e 100644 --- a/tests/test_mcp.py +++ b/tests/test_mcp.py @@ -4,7 +4,9 @@ import asyncio import re +import sys import time +import tomllib from pathlib import Path from typing import Any, get_args @@ -18,6 +20,8 @@ from loopcaptain.protocol.validate import validate_repo from tests.conftest import STEPS +ROOT = Path(__file__).resolve().parents[1] + MANIFEST: dict[str, Any] = { "title": "Planning rounds", "brief": {"goal": "Decide the design."}, @@ -317,3 +321,20 @@ def test_finding_closed_before_its_round_is_written_as_validate_allows(tmp_path: {"ts": "2026-11-16T08:00:00Z", "event": "finding_closed", "round": 3, "step": "a", "id": "f1"} ) assert refusals(tmp_path, manifest, [], event) == [] + + +def test_the_mcp_server_is_an_extra_and_says_so_where_it_is_missing( + monkeypatch: pytest.MonkeyPatch, capsys: pytest.CaptureFixture[str] +) -> None: + """The SDK was about half of a plain install, and the board and the helper never load it.""" + project = tomllib.loads((ROOT / "pyproject.toml").read_text(encoding="utf-8"))["project"] + assert not [name for name in project["dependencies"] if name.startswith("mcp")] + assert project["optional-dependencies"]["mcp"] == ["mcp>=2.0"] + monkeypatch.delitem(sys.modules, "loopcaptain.mcp_server.server", raising=False) + for name in ("mcp", "mcp.server", "mcp.server.mcpserver"): # as on a machine without the extra + monkeypatch.setitem(sys.modules, name, None) + + assert main(["mcp"]) == 1 + assert "uv tool install 'loopcaptain[mcp]'" in capsys.readouterr().err + assert main(["mcp-config", "claude-code", "--checkout", ""]) == 0 + assert "the server needs the MCP extra" in capsys.readouterr().out diff --git a/uv.lock b/uv.lock index 51dd632..67679c4 100644 --- a/uv.lock +++ b/uv.lock @@ -697,16 +697,21 @@ dependencies = [ { name = "fastapi" }, { name = "jinja2" }, { name = "markdown-it-py" }, - { name = "mcp" }, { name = "pydantic" }, { name = "python-multipart" }, { name = "pyyaml" }, { name = "uvicorn" }, ] +[package.optional-dependencies] +mcp = [ + { name = "mcp" }, +] + [package.dev-dependencies] dev = [ { name = "httpx" }, + { name = "mcp" }, { name = "mypy" }, { name = "pre-commit" }, { name = "pytest" }, @@ -723,16 +728,18 @@ requires-dist = [ { name = "fastapi", specifier = ">=0.115" }, { name = "jinja2", specifier = ">=3.1" }, { name = "markdown-it-py", specifier = ">=3.0" }, - { name = "mcp", specifier = ">=2.0" }, + { name = "mcp", marker = "extra == 'mcp'", specifier = ">=2.0" }, { name = "pydantic", specifier = ">=2.7" }, { name = "python-multipart", specifier = ">=0.0.9" }, { name = "pyyaml", specifier = ">=6.0" }, { name = "uvicorn", specifier = ">=0.30" }, ] +provides-extras = ["mcp"] [package.metadata.requires-dev] dev = [ { name = "httpx", specifier = ">=0.27" }, + { name = "mcp", specifier = ">=2.0" }, { name = "mypy", specifier = ">=1.11" }, { name = "pre-commit", specifier = ">=4.0" }, { name = "pytest", specifier = ">=8" }, From 4c1a2092f81190ac3e1ee6ec2f310c661ddc0ae7 Mon Sep 17 00:00:00 2001 From: "faviens-agent-daniel[bot]" <354525062+faviens-agent-daniel[bot]@users.noreply.github.com> Date: Thu, 19 Nov 2026 17:10:22 +0100 Subject: [PATCH 4/4] docs(site): give a search result and a shared link a title and a picture (#36) * docs(site): give a search result and a shared link a title, a sentence and a picture - The site's pages carried no card data, so a shared link showed the host's generic card, and most page titles were one or two words ("Setup", "The board") that say nothing in a search result. Every page now has a title that names what it is about, Open Graph and card tags, and a picture; the first page also says what the project is as structured data. - The site loaded its fonts from another host, while the board vendors its font and loads nothing from anywhere. The site now uses the reader's own fonts. - A page of questions and answers puts into words what people search for: what an agent loop is, how to monitor, stop and steer one, which agents work, what leaves the machine. * docs(cli): describe every argument, and say server where it said door - The generated command reference had eleven arguments without a description, wrote "Mcp" for MCP, and did not list the events `emit` takes. Every argument has one now, the first letter alone is capitalised, and `emit` names its events. - "Door" stood for the two ways a loop writes its files. A reader new to the project met it in the MCP reference and the standard with nothing to say what a door is. Those texts now say script, session and MCP server. * feat(release): print a commit's reasons below its line of the release notes - A release note was one subject per commit: what changed, never why, though every commit says why in its bullets. - The notes now print up to six bullets of a commit's body below its subject. Check boxes and text that is no bullet are left out. --------- Co-authored-by: danielvogler --- .agent/DEFERRED_VERIFICATION.md | 2 +- .agent/FINDINGS.md | 6 +- AGENTS.md | 7 ++- docs/ARCHITECTURE.md | 14 ++--- docs/assets/social-card.png | Bin 0 -> 72349 bytes docs/board.md | 1 + docs/connect.md | 1 + docs/faq.md | 89 +++++++++++++++++++++++++++ docs/get-started.md | 1 + docs/installation.md | 1 + docs/llms.txt | 1 + docs/opentelemetry.md | 1 + docs/protocol/index.md | 1 + docs/reference/cli.md | 47 +++++++------- docs/reference/mcp.md | 11 ++-- docs/security.md | 1 + docs/setup.md | 1 + docs/shell-loop.md | 1 + overrides/main.html | 42 +++++++++++++ scripts/docs_pages.py | 5 +- scripts/release.py | 28 ++++++++- src/loopcaptain/cli.py | 44 ++++++++----- src/loopcaptain/mcp_server/AGENTS.md | 4 +- src/loopcaptain/mcp_server/server.py | 11 ++-- standard/LOOPS.md | 3 +- tests/test_docs.py | 16 +++++ tests/test_release.py | 16 +++++ zensical.toml | 7 +++ 28 files changed, 290 insertions(+), 72 deletions(-) create mode 100644 docs/assets/social-card.png create mode 100644 docs/faq.md create mode 100644 overrides/main.html diff --git a/.agent/DEFERRED_VERIFICATION.md b/.agent/DEFERRED_VERIFICATION.md index c8944d7..6b3b177 100644 --- a/.agent/DEFERRED_VERIFICATION.md +++ b/.agent/DEFERRED_VERIFICATION.md @@ -14,7 +14,6 @@ is named in the commit that closes it. | 1663afd, a327458 | MCP `emit` refuses what `validate` would refuse and takes `inbox_read`; `inbox` marks a reply to an earlier asking `stale`; driven over stdio by tests, not by an agent session | An agent may misread a refusal or ignore `stale` | One agent session using the MCP tools: a refused event, an `inbox_read` through `emit`, a stale reply seen | | 45bc2ef | A round that is started again is allowed and counted on; tested, not seen from a real loop | A real restart shows a wrong round or a problem | A real loop restarting a round, shown on the board and passing `validate` | | 5c6efbf, 5672f1a | The board's state lives in the user's state folder, and each repository and loop is a boundary. Seen on a running board on 2026-11-19: a watched folder whose `.loops` cannot be entered is named with the reason, a line dated 9999 and a `loop.json` that cannot be read leave every other loop shown, and Stop for another loop goes through beside the broken one. Not seen: a board started inside a watched repository that holds a planted state folder | The board reads state a repository planted | A board started inside a watched repository with a planted state folder, which it must leave unread | -| 5672f1a | A fault answers with the board's page (500); tested through the app. The 422 page was opened in Chrome on a running board (2026-11-18) | The page may not render in a real browser | The 500 page opened on a running board | | c07643a | The overview's pulse turns an open page to stalled when a loop goes quiet; tested through the app | An open overview keeps showing running | An overview left open past 45 minutes of silence turns to stalled | | cbe60a1 | A worktree counts only when its repository lists it back; tested with planted `.git` files | A real worktree is split from its repository, or a claim still passes | A real worktree and a folder with a `.git` file naming another repository, both on a running board | | df0e651 | The browser is let in by the printed address (cookie `SameSite=Strict`); shown with curl and Chrome, not in Safari or Firefox | Another browser refuses the cookie on the redirect and shows the locked page | The printed address opened in Safari and Firefox, a loop page reached | @@ -25,3 +24,4 @@ is named in the commit that closes it. | the page limits, the open questions, the turn of a sleeping page | Seen on a running board on 2026-11-19: a loop of 75 rounds drawn 30 at a time with links to the rest, two open questions shown one after the other, an open page of a sleeping loop turning to stalled by itself, the example loop started from the board, answered with a button and going on. Not seen: the notice beside Start that a Stop is waiting, the Copy buttons of an empty board, `watch` and `unwatch` on a config a person wrote by hand, a log near 20 MB from a real loop | A wording or a layout reads worse live than in a test; a real config has a shape the line editor does not know and is written anew | Each opened or run once on a real board and a real config | | hiding a loop, the old mark | Seen on a running board on 2026-11-19: `hide` took a waiting loop off an open first page, which reloaded by itself, out of the waiting count and the figures, the `hidden` chip listed it, its page opened with the command that shows it again, `unhide` brought it back; a loop silent for 20 days showed as stalled, marked old, outside the count of loops that need a look. Not seen: a loop hidden from one worktree and read from another, and `hide` on a config a person wrote by hand | A hidden loop comes back when its repository is read from another worktree | A loop hidden in the main checkout stays hidden while a worktree of that repository writes last | | the waiting count in a background tab | Seen in Chrome on a running board on 2026-11-19, with the tab made to read as hidden and the notification replaced by a recorder: a second loop asked, the title went from (1) to (2) without the page being drawn again, and one notification was made. Not seen: the browser's own permission prompt answered by a person and the notification the system then shows; `status` and `inbox` were run against a real board's loops | The system shows nothing, or shows it for every poll | Notify allowed in the footer, the board's tab put behind another, a loop made to ask: one notification, and a click on it brings the tab forward | +| the site's head and the release notes | The built site carries a title, a sentence, a card picture and, on the first page, the project as data; no page loads a font from another host; a release note prints its commit's bullets. Checked on the built pages and by tests, not on the published site or a real release | A card that does not show when a link is shared; notes that read badly for a squash merge, whose body is the pull request's list of commits | A link to the published site pasted into a chat or a card checker shows the picture; the notes of the next release read well | diff --git a/.agent/FINDINGS.md b/.agent/FINDINGS.md index 55c87fc..4e396f8 100644 --- a/.agent/FINDINGS.md +++ b/.agent/FINDINGS.md @@ -13,7 +13,6 @@ in the commit that settles it. Proposed: now, later, check, drop. | F15 | An optional exporter that tails `events.jsonl` and sends OTLP along docs/opentelemetry.md: its own process and dependency group, off by default, the first thing that would send data off the machine | open | later: when someone wants loops beside agent traces | docs/ARCHITECTURE.md section 15 | | F17 | The tab title counts what waits; the favicon does not. A count in the icon needs a drawn image per number or script | open | later | src/loopcaptain/board/templates/overview.html | | F18 | A prompt to build a loop, given to a fresh agent, ended with a 302-line loop file for a three-step job; a smaller starting template (one loop.py of 60 lines beside the helper) would make the first loop cheaper | open | later: check with the next acceptance run | the acceptance run of 2026-11-15 | -| F19 | "Door" is used for the two ways a loop writes its files (the MCP server's docstring and so `docs/reference/mcp.md`, `mcp_server/AGENTS.md`, `standard/LOOPS.md` section 5). A reader new to the project does not know what a door is; the architecture heading and picture now say "ways in" and name the script and MCP | open | later: reword with the next change to those files, then `make docs-pages` | `git grep -n -i door`, 2026-11-15 | | F20 | SECURITY.md and the issue template send reporters to private security advisories, but private vulnerability reporting is switched off on the repository, so a reporter has no private way in | open | now: a repository setting, no file change | the repository's `private-vulnerability-reporting` setting read `enabled: false`; SECURITY.md:29-31, .github/ISSUE_TEMPLATE/config.yml | | F26 | The release workflow tags and publishes on a push to main without waiting for CI: 0.3.1 was published 29 seconds after the CI run for the same commit was created | open | now: trigger on a successful CI run, or make the release job need a `make check` job | .github/workflows/release.yml:11-14, :55-66; run and upload times of 2026-11-15 | | F34 | `a helper of 50 lines` is stale in CHANGELOG.md; the helper has 76 | open | later: the file is frozen at 0.1.0, so only if that entry is ever rewritten | CHANGELOG.md; `wc -l standard/loops.py` | @@ -26,12 +25,9 @@ in the commit that settles it. Proposed: now, later, check, drop. | F72 | PyPI holds no provenance attestations for the published files | open | later | PyPI file metadata of 0.3.1; .github/workflows/release.yml | | F73 | `make setup` in a worktree repoints the main checkout's git hooks at the worktree's virtualenv | open | later: skip the install when the git dir is not the common dir, and say so in AGENTS.md section B.1 | Makefile:7-12; the installed hook's `INSTALL_PYTHON` line | | F74 | The repository topics miss the terms people search by (agent loops, human in the loop, dashboard); one topic is shared by six repositories. Topics naming agent products would need a reading of rule 8 | open | check: add `human-in-the-loop`, `agent-monitoring`, `ai-agents`, `coding-agents`, `ralph-loop`, `local-first`, and one of `claude-code` or `agent-protocol`; a repository setting, no file change | repository topics read 2026-11-15 and 2026-11-19 | -| F75 | A shared link shows the code host's generic card, and the docs site has no card image | open | later | repository settings, zensical.toml; review of 2026-11-15 at 7e22640 | | F76 | `How it differs` names no alternative, so a reader cannot place the project against tools they know. Naming other projects bends rule 8 | open | check: a rule change, and a section in docs/ARCHITECTURE.md | README.md `How it differs`; AGENTS.md rule 8 | -| F77 | A release note is one commit subject, and CHANGELOG.md 0.1.0 contradicts itself and the product in places | open | later: bullets from the commit body into the release note | CHANGELOG.md, scripts/release.py; the notes of 0.3.1 | -| F78 | The generated command-line reference has eleven empty descriptions, lower-cases proper names, and does not say that `emit` values parse as JSON | open | later | docs/reference/cli.md, src/loopcaptain/cli.py help texts | +| F77 | CHANGELOG.md 0.1.0 contradicts itself and the product in places (a helper of 50 lines, among others) | open | later: only if that entry is ever rewritten; the file is frozen at the first version | CHANGELOG.md | | F80 | The standard a loop author pastes does not say what only `validate` checks beyond the JSON Schema (paths, rules across lines); a loop and a board that look at different key folders make every answer read as not from the person, with no sign on the board | open | later | standard/LOOPS.md, standard/schema/, docs/setup.md section 5; review of 2026-11-15 at 7e22640 | -| F81 | The docs site loads its fonts from a third-party host, while the board vendors its font | open | check: vendor the font in the site too | zensical.toml; requests of the built site, review of 2026-11-15 at 7e22640 | | F83 | Small stale or author-facing statements across the standard, the site and the nested AGENTS.md files | open | later: with the next change to each file; done on 2026-11-16 for README.md, docs/index.md, docs/get-started.md, docs/installation.md, docs/agents.md and the one line in standard/AGENTS.md | git grep of the review | | F84 | Protocol proposal held back by rule 3: the helper's `inbox()` could drop entries whose `signed` is not `true`, or that are `stale`, by default or behind an opt-in argument; today a loop filters them itself, and a call written against the earlier text must keep returning what it returned | open | later: an opt-in argument fits version 1, a new default is protocol 2 | standard/loops.py `inbox`; docs/ARCHITECTURE.md section 26, Rejected; commit a327458 | | F89 | One loop page walks the watched folders several times per request: `find_loop`, `find_repo` and the repository list each call `find_repos(config())`. Measured on 300 folders, 100 of them with loops: 13 ms a walk, so about 50 ms of a page | open | later: one walk per request, if a board with hundreds of folders feels slow | src/loopcaptain/board/discover.py, board/app.py; measured 2026-11-19 | diff --git a/AGENTS.md b/AGENTS.md index 4f15c20..ce6413f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -143,13 +143,14 @@ stdio, installed with its extra (`uv tool install 'loopcaptain[mcp]'`): it the major one. A push with only `docs`, `test`, `chore`, `ci` or `refactor` commits makes no release. 3. A release is a tag `vX.Y.Z` and a GitHub release whose notes are the - subjects of those commits, with the wheel attached: built with the + subjects of those commits, each with the bullets of its body below + it, with the wheel attached: built with the tag's version, installed in a clean environment and smoke-tested first. It goes to PyPI once the repository variable `PUBLISH_PYPI` is `true`. 4. Nothing is committed back. `pyproject.toml` says `0.0.0`; a checkout and an install from `main` report that, a released wheel its tag. -5. A commit subject is a line of the release notes, so write it for a - user. `CHANGELOG.md` holds the first version and points to the +5. A commit subject is a line of the release notes and its bullets are + printed below it, so write both for a user. `CHANGELOG.md` holds the first version and points to the releases. 6. The package version is not the protocol number: a release may add optional fields and events, never break a loop written today. diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 91c1e33..e2e1c2e 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -557,8 +557,8 @@ would still vanish. the line's `event` (`event_tag`); a name not in `EVENT_NAMES` reads as `OtherEvent`, which the fold skips and which still counts as a sign of life. `validate` warns (`unknown_events`). The published schema takes any -other event name with a `ts`. Writing stays strict: both `emit` doors -take known events only. +other event name with a `ts`. Writing stays strict: `emit` on the command +line and `emit` over MCP take known events only. **Why.** Version 1 grows by new events, and the standard tells a board to ignore what it does not know. A reader that refused them would call the @@ -594,13 +594,13 @@ only grows). Raising an error without a key: a loop on a machine where no board has run yet would not start. A new event for the case: boards installed before unknown events were skipped would call it a problem. -## 27. A door refuses an event that would stay a problem, and no more +## 27. A way in refuses an event that would stay a problem, and no more **Decision.** `before_writing` in `protocol/validate.py` holds what the -two doors that write on a loop's behalf check, the MCP `emit` and +two ways in that write on a loop's behalf check, the MCP `emit` and `loopcaptain emit`. `refusals` (the round has started, the step is in `loop.json`, the artifact exists, the verdict agrees with the round's -first) refuses an event: the door writes nothing. An `inbox_read` naming +first) refuses an event: nothing is written. An `inbox_read` naming an entry the models cannot read is written with a warning; where `loop.json` or the log cannot be read (over the size the reader takes, unreadable), the event is written without the checks against the log, @@ -608,7 +608,7 @@ with a warning. The MCP `emit` adds the warning to its answer, `loopcaptain emit` writes it to standard error. Both take `inbox_read`. **Why.** The log is append-only, so a line `validate` refuses is refused -for good; a writer that hears `recorded` never learns it. A door that +for good; a writer that hears `recorded` never learns it. A way in that refuses more than `validate` calls a problem stops a loop for nothing. The standard has a loop append `inbox_read` after acting on entries, and a loop that reads the inbox file itself has no other way to mark them; @@ -619,7 +619,7 @@ loop still has to report. **Rejected.** Writing the line and returning the problems with it: the problem is then permanent, and the caller can only add to it. Refusing -`inbox_read` on both doors: a shell loop would have to write the line by +`inbox_read` on both ways in: a shell loop would have to write the line by hand, without any check of its ids. Refusing an unreadable entry or an unreadable log: the loop could not report at all. Writing such a line silently: the writer would not know its line went unchecked. diff --git a/docs/assets/social-card.png b/docs/assets/social-card.png new file mode 100644 index 0000000000000000000000000000000000000000..d7e093c83cecd3750b6225fe75748ac46a8d3b31 GIT binary patch literal 72349 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/events.jsonl` in its own +repository, one line per event, and open the board. The board shows every +loop on the machine: which round it is in, what each step found, what it +cost, and whether it still moves. A Python loop pastes a helper of under +110 lines, a shell loop calls `loopcaptain emit`, an agent session uses +the MCP server. [Connect or build a loop](connect.md) has the steps. + +## How do I stop or steer a running agent loop? + +Press Stop on the loop's page, answer its question with a button, or type +a note for the next round. The board appends a signed line to the loop's +`inbox.jsonl`; the loop reads it at the start of a round and acts on it. +The signature lets the loop tell your line from one an agent wrote into +the file. See [The board](board.md). + +## How do I keep a human in the loop without watching a chat window? + +A loop asks with a `question` event and either goes on with a default or +stands still until you answer. The board lists what waits for you, counts +it in the tab's title and can notify you through the browser. You answer +when you look, and the loop takes the answer at its next round. + +## How do I monitor a Ralph loop? + +Two commands in the shell loop: `loopcaptain emit` for each round and +step, `loopcaptain inbox` to read your stop and notes. A complete +`loop.sh` is on [Monitor a Ralph loop or any shell loop](shell-loop.md). + +## Which coding agents does it work with? + +Any. The protocol is plain files, so whatever can write a file can +report: Claude Code, Codex, Gemini CLI, Cursor, opencode, Amp, or a +script that calls a model's API. [Works with every agent](agents.md) +lists how each adds the MCP server. + +## Does a loop have to install or import Loopcaptain? + +No. A loop writes three small files; the helper is pasted text that uses +the Python standard library only. The board is installed once per +machine: `uv tool install loopcaptain`. + +## Does anything leave my machine? + +No. The board listens on `127.0.0.1` only, loads nothing from another +origin and sends nothing anywhere. It reads files in the repositories you +tell it to watch and writes only the inbox lines you send. The +[threat model](security.md) says what it reads, runs and writes. + +## How is this different from tracing and observability tools? + +Those record what a model call did, for later analysis, usually in a +hosted service. Loopcaptain shows where a loop stands now, round by +round, and carries your answer back into it; it runs on your laptop and +keeps its data in your repositories. The two fit together: a loop's +events map onto OpenTelemetry, see [OpenTelemetry](opentelemetry.md). + +## What does it cost? + +Nothing. Apache License 2.0, no account, no service. The example loop +that `loopcaptain demo` writes calls no model, so trying it is free too. + +## How do I see every loop without opening a browser? + +`loopcaptain status` prints one line per loop in the terminal: its +status, its round, its last line and what it asks. + +## How do I take a finished or dead loop off the board? + +`loopcaptain hide ` takes one loop off the first page +and out of the figures; `unhide` brings it back. Loops that ended are +folded away by themselves, and one that died weeks ago is marked old and +no longer counts as needing a look. diff --git a/docs/get-started.md b/docs/get-started.md index c74a5fc..e0cfb25 100644 --- a/docs/get-started.md +++ b/docs/get-started.md @@ -1,4 +1,5 @@ --- +title: "Get started: run an agent loop on the board in five minutes" description: "Run the free example loop on the board: no model, no network. Start it, answer its question with a button and watch it finish." --- diff --git a/docs/installation.md b/docs/installation.md index bd14a98..a7f13d2 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -1,4 +1,5 @@ --- +title: "Install Loopcaptain" description: "Install Loopcaptain from PyPI with uv, pipx or pip, run it once through uvx, or install a tagged release from the repository." --- diff --git a/docs/llms.txt b/docs/llms.txt index 2ec6e3e..6b24a36 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -20,6 +20,7 @@ - [AGENTS.md for a loop](https://github.com/faviens/loopcaptain/blob/main/standard/AGENTS.md): connect a loop, or build one from nothing - [Works with every agent](https://faviens.github.io/loopcaptain/agents/): how each coding agent adds the MCP server - [Monitor a Ralph or shell loop](https://faviens.github.io/loopcaptain/shell-loop/): a worked loop.sh with `emit` and `inbox` +- [Questions and answers](https://faviens.github.io/loopcaptain/faq/): what a loop is, how to monitor, stop and steer one ## Optional diff --git a/docs/opentelemetry.md b/docs/opentelemetry.md index 9407e38..b2a9d22 100644 --- a/docs/opentelemetry.md +++ b/docs/opentelemetry.md @@ -1,4 +1,5 @@ --- +title: "Agent loops and OpenTelemetry" description: "How a loop's events map onto OpenTelemetry and the GenAI conventions, for loops beside agent traces. Loopcaptain sends no telemetry." --- diff --git a/docs/protocol/index.md b/docs/protocol/index.md index 58c4e27..6d68c0c 100644 --- a/docs/protocol/index.md +++ b/docs/protocol/index.md @@ -1,4 +1,5 @@ --- +title: "The Loops protocol: the files an agent loop writes" description: "The Loops protocol, version 1: the files an agent loop writes and reads, every field and event, and the helper a loop pastes." --- diff --git a/docs/reference/cli.md b/docs/reference/cli.md index f9bc9ee..fd17303 100644 --- a/docs/reference/cli.md +++ b/docs/reference/cli.md @@ -26,30 +26,27 @@ loopcaptain validate [-h] [--strict] repo | Argument | Meaning | |---|---| -| `repo` | | +| `repo` | the repository whose .loops folders are checked | | `--strict` | count warnings as problems | ## `emit` -Append one event: loopcaptain emit key=value .... +Append one event to a loop's log, its fields as key=value pairs, for a loop in shell. ```text -loopcaptain emit [-h] [--repo REPO] - loop - {round_started,step_started,step_finished,finding_closed,round_finished,question,question_closed,check,inbox_read,loop_started,loop_stopped,heartbeat} - [fields ...] +loopcaptain emit [-h] [--repo REPO] loop event [fields ...] ``` | Argument | Meaning | |---|---| -| `loop` | | -| `event` | | +| `loop` | the loop's id, the name of its folder in .loops/ | +| `event` | the event to append, one of: round_started, step_started, step_finished, finding_closed, round_finished, question, question_closed, check, inbox_read, loop_started, loop_stopped, heartbeat | | `fields` | key=value; a value is read as JSON where it parses (round=2, blocks=true, ids='["a"]'), and as text where the field is text (commit=1234567) | -| `--repo` | | +| `--repo` | the repository the loop lives in, default: this folder | ## `schema` -Write the protocol as json schema. +Write the protocol as JSON Schema. ```text loopcaptain schema [-h] target @@ -57,7 +54,7 @@ loopcaptain schema [-h] target | Argument | Meaning | |---|---| -| `target` | | +| `target` | the folder the schema files are written into | ## `doctor` @@ -69,8 +66,8 @@ loopcaptain doctor [-h] [--timeout TIMEOUT] repo loop | Argument | Meaning | |---|---| -| `repo` | | -| `loop` | | +| `repo` | the repository the loop lives in | +| `loop` | the loop's id, the name of its folder in .loops/ | | `--timeout` | seconds to wait, default 600 | ## `watch` @@ -83,7 +80,7 @@ loopcaptain watch [-h] [--root] path | Argument | Meaning | |---|---| -| `path` | | +| `path` | a repository, or with --root a folder of repositories | | `--root` | every sub-folder with .loops/ is a repository | ## `unwatch` @@ -96,7 +93,7 @@ loopcaptain unwatch [-h] path | Argument | Meaning | |---|---| -| `path` | | +| `path` | the folder to take off, however the config spells it | ## `status` @@ -120,8 +117,8 @@ loopcaptain inbox [-h] [--repo REPO] [--json] loop | Argument | Meaning | |---|---| -| `loop` | | -| `--repo` | | +| `loop` | the loop's id, the name of its folder in .loops/ | +| `--repo` | the repository the loop lives in, default: this folder | | `--json` | every entry as a JSON line, with signed and stale | ## `hide` @@ -134,8 +131,8 @@ loopcaptain hide [-h] repo loop | Argument | Meaning | |---|---| -| `repo` | | -| `loop` | | +| `repo` | the repository the loop lives in | +| `loop` | the loop's id, the name of its folder in .loops/ | ## `unhide` @@ -147,8 +144,8 @@ loopcaptain unhide [-h] repo loop | Argument | Meaning | |---|---| -| `repo` | | -| `loop` | | +| `repo` | the repository the loop lives in | +| `loop` | the loop's id, the name of its folder in .loops/ | ## `demo` @@ -160,12 +157,12 @@ loopcaptain demo [-h] [--target TARGET] [--no-watch] | Argument | Meaning | |---|---| -| `--target` | | +| `--target` | the folder the example loop is written into, default ~/.local/share/loopcaptain/demo | | `--no-watch` | write it, but leave the config alone | ## `mcp-config` -How one coding agent adds the mcp server. +How one coding agent adds the MCP server. ```text loopcaptain mcp-config [-h] [--checkout CHECKOUT] [--markdown] [agent] @@ -179,7 +176,7 @@ loopcaptain mcp-config [-h] [--checkout CHECKOUT] [--markdown] [agent] ## `spec` -Print loops.md, the protocol to paste into a loop. +Print LOOPS.md, the protocol to paste into a loop. ```text loopcaptain spec [-h] @@ -187,7 +184,7 @@ loopcaptain spec [-h] ## `mcp` -Run the mcp server on stdio. +Run the MCP server on stdio. ```text loopcaptain mcp [-h] diff --git a/docs/reference/mcp.md b/docs/reference/mcp.md index f7611cd..94d27d6 100644 --- a/docs/reference/mcp.md +++ b/docs/reference/mcp.md @@ -2,13 +2,14 @@ # The MCP tools -The MCP door: the protocol as five tools, for a loop that an agent session drives. +The MCP server: the protocol as five tools, for a loop that an agent session drives. The tools mirror the helper a script pastes (`register`, `emit`, `inbox`), so there is one -vocabulary on both doors and the tool list stays small in the agent's context. Every tool writes -the same files; the board cannot tell the two doors apart. `repo` is the repository the loop -lives in; left out, it is the folder the server was started in, which is the agent's working folder. -A `repo` outside that folder is refused unless `LOOPCAPTAIN_MCP_ROOTS` names a folder above it. +vocabulary for a script and for a session, and the tool list stays small in the agent's context. +Every tool writes the same files the helper writes; the board cannot tell which of the two wrote +a line. `repo` is the repository the loop lives in; left out, it is the folder the server was +started in, which is the agent's working folder. A `repo` outside that folder is refused unless +`LOOPCAPTAIN_MCP_ROOTS` names a folder above it. ## `protocol` diff --git a/docs/security.md b/docs/security.md index 15d6cc9..2a4173d 100644 --- a/docs/security.md +++ b/docs/security.md @@ -1,4 +1,5 @@ --- +title: "Security and threat model of the local board" description: "What the board reads, runs and writes: how a browser gets in, how an answer reaches a loop signed, and what Start may run." --- diff --git a/docs/setup.md b/docs/setup.md index 12aede8..f2c28b3 100644 --- a/docs/setup.md +++ b/docs/setup.md @@ -1,4 +1,5 @@ --- +title: "Set up the board for your agent loops" description: "Put the repositories that run agent loops on the board, find the loops that already report, and connect the ones that do not." --- diff --git a/docs/shell-loop.md b/docs/shell-loop.md index 6bf51aa..48661c9 100644 --- a/docs/shell-loop.md +++ b/docs/shell-loop.md @@ -1,4 +1,5 @@ --- +title: "Monitor and steer a Ralph loop or any shell loop" description: "Monitor and steer a Ralph loop or any shell loop around a coding agent: report each iteration with one command, read the person's stop and notes with another." --- diff --git a/overrides/main.html b/overrides/main.html new file mode 100644 index 0000000..bffaadc --- /dev/null +++ b/overrides/main.html @@ -0,0 +1,42 @@ +{#- What a shared link and a search result show: a title, a sentence and a picture for every page, + and on the first page what the project is, as data a search engine reads. Nothing is loaded + from another origin. -#} +{% extends "base.html" %} + +{% block extrahead %} + {% set named = page and page.meta and page.meta.title is defined and page.meta.title %} + {% set title = page.meta.title if named else (page.title if page and page.title else config.site_name) %} + {% set home = page and page.canonical_url is defined and page.canonical_url == config.site_url %} + {% set shown = title if title == config.site_name else title ~ " - " ~ config.site_name %} + {% set described = page and page.meta and page.meta.description is defined and page.meta.description %} + {% set description = page.meta.description if described else config.site_description %} + {% set card = config.site_url ~ "assets/social-card.png" %} + + + + + + + + + + + + + {% if home %} + + {% endif %} +{% endblock %} diff --git a/scripts/docs_pages.py b/scripts/docs_pages.py index ee79bca..1d6ae6c 100644 --- a/scripts/docs_pages.py +++ b/scripts/docs_pages.py @@ -36,7 +36,9 @@ def cli_page() -> str: subparsers = next(a for a in parser._actions if isinstance(a, argparse._SubParsersAction)) helps = {choice.dest: choice.help for choice in subparsers._choices_actions} for name, sub in subparsers.choices.items(): - lines += [f"## `{name}`", "", f"{(helps.get(name) or '').capitalize()}.", ""] + about = (helps.get(name) or "").rstrip(".") + # The first letter only: `capitalize` would write "Mcp" and "Loops.md". + lines += [f"## `{name}`", "", f"{about[:1].upper()}{about[1:]}.", ""] usage = sub.format_usage().replace("usage: ", "").strip() lines += ["```text", usage, "```", ""] options = [action for action in sub._actions if not isinstance(action, argparse._HelpAction)] @@ -97,6 +99,7 @@ def llms_txt() -> str: f"- [AGENTS.md for a loop]({files}/standard/AGENTS.md): connect a loop, or build one from nothing", f"- [Works with every agent]({site}/agents/): how each coding agent adds the MCP server", f"- [Monitor a Ralph or shell loop]({site}/shell-loop/): a worked loop.sh with `emit` and `inbox`", + f"- [Questions and answers]({site}/faq/): what a loop is, how to monitor, stop and steer one", "", "## Optional", "", diff --git a/scripts/release.py b/scripts/release.py index b88fe07..21a9627 100644 --- a/scripts/release.py +++ b/scripts/release.py @@ -62,14 +62,38 @@ def next_tag(last: str | None, bump: str) -> str: return f"v{major}.{minor}.{patch + 1}" +#: A commit says why in bullets; a release note carries at most this many of them per commit. +MOST_BULLETS = 6 + + +def bullets(body: str) -> list[str]: + """The top-level bullets of a commit body, each on one line: what a release note adds below a + subject. Check boxes of a pull request's text and everything that is no bullet are left out.""" + found: list[str] = [] + open_bullet = False + for line in body.splitlines(): + if line.startswith("- ") and not line.startswith("- ["): + found.append(line[2:].strip()) + open_bullet = True + elif open_bullet and line.startswith(" ") and line.strip(): + found[-1] = f"{found[-1]} {line.strip()}" + else: + open_bullet = False + return found[:MOST_BULLETS] + + def notes(commits: list[Commit]) -> str: - """The release notes: each feat, fix and perf subject under its heading, newest first.""" + """The release notes: each feat, fix and perf subject under its heading, newest first, with the + reasons its commit gives below it.""" sections: dict[str, list[str]] = {kind: [] for kind in HEADINGS} for commit in commits: match = SUBJECT.match(commit.subject) if match and match["type"] in sections: scope = f"**{match['scope']}**: " if match["scope"] else "" - sections[match["type"]].append(f"- {scope}{match['text']} ({commit.sha[:7]})") + entry = [f"- {scope}{match['text']} ({commit.sha[:7]})"] + sections[match["type"]].append( + "\n".join(entry + [f" - {text}" for text in bullets(commit.body)]) + ) return "\n\n".join( f"## {HEADINGS[kind]}\n\n" + "\n".join(lines) for kind, lines in sections.items() if lines ) diff --git a/src/loopcaptain/cli.py b/src/loopcaptain/cli.py index fd3d47b..0a815d6 100644 --- a/src/loopcaptain/cli.py +++ b/src/loopcaptain/cli.py @@ -217,44 +217,53 @@ def build_parser() -> argparse.ArgumentParser: serve.add_argument("--port", type=int, default=8484, help="the port on 127.0.0.1, default 8484") validate = commands.add_parser("validate", help="check a repository's .loops folders") - validate.add_argument("repo", type=Path) + validate.add_argument("repo", type=Path, help="the repository whose .loops folders are checked") validate.add_argument("--strict", action="store_true", help="count warnings as problems") emit_cmd = commands.add_parser( - "emit", help="append one event: loopcaptain emit key=value ..." + "emit", help="append one event to a loop's log, its fields as key=value pairs, for a loop in shell" + ) + emit_cmd.add_argument("loop", help="the loop's id, the name of its folder in .loops/") + emit_cmd.add_argument( + "event", + choices=EVENT_NAMES, + help=f"the event to append, one of: {', '.join(EVENT_NAMES)}", + metavar="event", ) - emit_cmd.add_argument("loop") - emit_cmd.add_argument("event", choices=EVENT_NAMES) emit_cmd.add_argument( "fields", nargs="*", help="key=value; a value is read as JSON where it parses (round=2, blocks=true, " "ids='[\"a\"]'), and as text where the field is text (commit=1234567)", ) - emit_cmd.add_argument("--repo", type=Path, default=Path(".")) + emit_cmd.add_argument( + "--repo", type=Path, default=Path("."), help="the repository the loop lives in, default: this folder" + ) schema = commands.add_parser("schema", help="write the protocol as JSON Schema") - schema.add_argument("target", type=Path) + schema.add_argument("target", type=Path, help="the folder the schema files are written into") doctor = commands.add_parser("doctor", help="send a loop a stop and check that it takes it and ends") - doctor.add_argument("repo", type=Path) - doctor.add_argument("loop") + doctor.add_argument("repo", type=Path, help="the repository the loop lives in") + doctor.add_argument("loop", help="the loop's id, the name of its folder in .loops/") doctor.add_argument("--timeout", type=float, default=600, help="seconds to wait, default 600") watch = commands.add_parser( "watch", help="add a repository, or with --root a folder of them, to the board" ) - watch.add_argument("path", type=Path) + watch.add_argument("path", type=Path, help="a repository, or with --root a folder of repositories") watch.add_argument("--root", action="store_true", help="every sub-folder with .loops/ is a repository") unwatch = commands.add_parser("unwatch", help="take a folder off the board") - unwatch.add_argument("path", type=Path) + unwatch.add_argument("path", type=Path, help="the folder to take off, however the config spells it") status = commands.add_parser("status", help="where every watched loop stands, in a terminal") status.add_argument("--all", action="store_true", help="hidden and finished loops too") inbox = commands.add_parser( "inbox", help="what the person sent a loop since the last call, one line each, for a loop in shell" ) - inbox.add_argument("loop") - inbox.add_argument("--repo", type=Path, default=Path(".")) + inbox.add_argument("loop", help="the loop's id, the name of its folder in .loops/") + inbox.add_argument( + "--repo", type=Path, default=Path("."), help="the repository the loop lives in, default: this folder" + ) inbox.add_argument( "--json", action="store_true", help="every entry as a JSON line, with signed and stale" ) @@ -263,13 +272,18 @@ def build_parser() -> argparse.ArgumentParser: ("unhide", "show a hidden loop on the first page again"), ): one_loop = commands.add_parser(name, help=about) - one_loop.add_argument("repo", type=Path) - one_loop.add_argument("loop") + one_loop.add_argument("repo", type=Path, help="the repository the loop lives in") + one_loop.add_argument("loop", help="the loop's id, the name of its folder in .loops/") demo = commands.add_parser( "demo", help="write the example loop into a folder and watch it; costs nothing" ) - demo.add_argument("--target", type=Path, default=Path("~/.local/share/loopcaptain/demo")) + demo.add_argument( + "--target", + type=Path, + default=Path("~/.local/share/loopcaptain/demo"), + help="the folder the example loop is written into, default ~/.local/share/loopcaptain/demo", + ) demo.add_argument("--no-watch", action="store_true", help="write it, but leave the config alone") mcp_config = commands.add_parser("mcp-config", help="how one coding agent adds the MCP server") diff --git a/src/loopcaptain/mcp_server/AGENTS.md b/src/loopcaptain/mcp_server/AGENTS.md index 6bbb1ca..1a809c4 100644 --- a/src/loopcaptain/mcp_server/AGENTS.md +++ b/src/loopcaptain/mcp_server/AGENTS.md @@ -1,4 +1,4 @@ -# mcp_server/: the MCP door +# mcp_server/: the MCP server Read [the root AGENTS.md](../../../AGENTS.md) first. `server.py` exposes the protocol as MCP tools for a loop that an agent session drives without @@ -8,7 +8,7 @@ Rules here: 1. Five tools and no more: `protocol`, `loop_register`, `emit`, `inbox_read`, `loop_status`. They mirror the helper's three verbs, so - a loop reads the same on both doors and the tool list stays short in + a loop reads the same from a script and from a session, and the tool list stays short in an agent's context. A new event is a new value for `emit`, not a tool. 2. A tool writes exactly what the helper in `standard/loops.py` would write. No tool adds state of its own; `tests/test_mcp.py` validates the diff --git a/src/loopcaptain/mcp_server/server.py b/src/loopcaptain/mcp_server/server.py index dd33607..7292f1c 100644 --- a/src/loopcaptain/mcp_server/server.py +++ b/src/loopcaptain/mcp_server/server.py @@ -1,10 +1,11 @@ -"""The MCP door: the protocol as five tools, for a loop that an agent session drives. +"""The MCP server: the protocol as five tools, for a loop that an agent session drives. The tools mirror the helper a script pastes (`register`, `emit`, `inbox`), so there is one -vocabulary on both doors and the tool list stays small in the agent's context. Every tool writes -the same files; the board cannot tell the two doors apart. `repo` is the repository the loop -lives in; left out, it is the folder the server was started in, which is the agent's working folder. -A `repo` outside that folder is refused unless `LOOPCAPTAIN_MCP_ROOTS` names a folder above it. +vocabulary for a script and for a session, and the tool list stays small in the agent's context. +Every tool writes the same files the helper writes; the board cannot tell which of the two wrote +a line. `repo` is the repository the loop lives in; left out, it is the folder the server was +started in, which is the agent's working folder. A `repo` outside that folder is refused unless +`LOOPCAPTAIN_MCP_ROOTS` names a folder above it. """ from __future__ import annotations diff --git a/standard/LOOPS.md b/standard/LOOPS.md index cfc7617..86078db 100644 --- a/standard/LOOPS.md +++ b/standard/LOOPS.md @@ -479,7 +479,8 @@ A loop that an agent session drives, with no script of its own, uses the | `loop_status` | returns where a loop stands, or the loops of a repository | | Five tools on purpose: the same three verbs as the helper, so a loop reads -the same on both doors, and a short tool list in the agent's context. +the same from a script and from a session, and a short tool list in the +agent's context. ## 6. Conformance diff --git a/tests/test_docs.py b/tests/test_docs.py index db96949..8e0d103 100644 --- a/tests/test_docs.py +++ b/tests/test_docs.py @@ -5,6 +5,7 @@ import importlib.util import json import re +import struct import sys import tomllib import types @@ -360,3 +361,18 @@ def test_every_written_page_tells_a_search_engine_what_it_is_about_in_its_own_wo assert front_matter(ROOT / "docs" / "index.md").get("title", "Home") != "Home" assert [name for name, text in descriptions.items() if not 40 <= len(text) <= 160] == [] assert len(set(descriptions.values())) == len(descriptions) + + +def test_a_shared_link_and_a_search_result_get_a_title_a_sentence_and_a_picture() -> None: + """The site wrote no card data and loaded its fonts from another host.""" + theme = tomllib.loads((ROOT / "zensical.toml").read_text(encoding="utf-8"))["project"]["theme"] + head = (ROOT / "overrides" / "main.html").read_text(encoding="utf-8") + card = (ROOT / "docs" / "assets" / "social-card.png").read_bytes() + + assert theme["custom_dir"] == "overrides" and theme["font"] is False + for name in ("og:title", "og:description", "og:url", "og:image", "twitter:card", "application/ld+json"): + assert name in head + assert "assets/social-card.png" in head and "http" not in head.replace("https://schema.org", "").replace( + "https://www.apache.org/licenses/LICENSE-2.0", "" + ) + assert card[:8] == b"\x89PNG\r\n\x1a\n" and struct.unpack(">II", card[16:24]) == (1200, 630) diff --git a/tests/test_release.py b/tests/test_release.py index be53f5e..1c6bcb9 100644 --- a/tests/test_release.py +++ b/tests/test_release.py @@ -71,6 +71,22 @@ def test_the_notes_list_what_users_notice_under_headings(release: types.ModuleTy assert "keep the table readable" not in text +def test_a_note_carries_the_reasons_its_commit_gives(release: types.ModuleType) -> None: + """A release note was one subject line; why the change was made stayed in the commit.""" + body = ( + "- A reply closed whichever question was asked last,\n whatever it named.\n" + "- Open questions are kept per asking.\n\nNot a bullet.\n- [x] A check box of a pull request.\n" + ) + + text = release.notes([release.Commit("1234567890", "fix(board): keep every open question", body)]) + + assert text == ( + "## Fixed\n\n- **board**: keep every open question (1234567)\n" + " - A reply closed whichever question was asked last, whatever it named.\n" + " - Open questions are kept per asking." + ) + + def test_the_checkout_carries_no_version_of_its_own() -> None: project = tomllib.loads((ROOT / "pyproject.toml").read_text(encoding="utf-8"))["project"] diff --git a/zensical.toml b/zensical.toml index 8617cd1..8ec2fa4 100644 --- a/zensical.toml +++ b/zensical.toml @@ -21,6 +21,7 @@ nav = [ { "MCP tools" = "reference/mcp.md" }, { "Configuration" = "reference/configuration.md" }, ] }, + { "Questions and answers" = "faq.md" }, { "OpenTelemetry" = "opentelemetry.md" }, { "Security" = "security.md" }, { "Architecture" = "ARCHITECTURE.md" }, @@ -28,6 +29,12 @@ nav = [ { "Contributing" = "contributing.md" }, ] +# The pages load nothing from another host: no web fonts, the reader's own are used. The override +# adds what a shared link and a search result show (overrides/main.html). +[project.theme] +custom_dir = "overrides" +font = false + [[project.theme.palette]] scheme = "default" toggle.icon = "lucide/sun"