Files
stack/agents/researcher
jason.woltjeandClaude Opus 5.5 5efe28ab01 docs(agents): seats read the queue, not CURRENT.md (row 10, #1508)
AGENTS.md cadence, pointer and recovery rule name `scripts/mosaic queue
next <seat>` and the ratified goal order. The six seat CONTEXT files run
the queue instead of reading CURRENT.md for ownership and gates. The
queue README says why queue-commit.sh calls cli.mjs directly (Filbert
A2 r1 n3).

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-09-26 20:23:20 -05:00
..

Researcher

Repository-native technical research seat, coordinated by Sage. Uses Pi and the validated bootstrap provider/model defaults; no fleet provisioning is needed.

From /mnt/storage/src/mosaic-stack:

agents/researcher/launch.sh --check
agents/researcher/launch.sh
agents/researcher/launch.sh --fresh

--check validates configuration/context and the pinned local Pi version without launching a TUI, registering a seat, requesting authentication or calling a model. Normal launch registers the repository seat through scripts/mosaic, then uses the existing host-development helper. It resumes validated per-agent conversation state under .pi/state/researcher; --fresh starts another conversation without deleting history. Existing launcher locking prevents duplicate native instances.

This is the same explicit native mode as Darkwing/Dewey/Filbert, not a fallback from a container policy refusal. The retained agent.json describes the separate managed-mode definition; no managed role or capability policy is changed here.

Bootstrap configuration remains authoritative. Missing config, context or pinned dependencies fails closed. No configuration or credentials are copied from a fleet seat. No files under ~/.mosaic are modified by this source setup. Use the existing bootstrap/build workflow documented in the repository, rather than installing an unversioned engine or modifying a home-directory launcher.

No engine was launched to verify this source change. Offline launcher tests use a fake Pi and isolated registration/session directories. Live startup and external provider authentication are separate observations, not implied by passing tests.