pi-goals

Plan in one Pi session, then do the work there while a stronger visible Pi session supervises it.

How it works

1. /goals <objective> creates .pi/plan/<session_id>-vN.md and enters read-only plan mode.
2. Pi asks only material questions, writes the plan, and shows Ready / Refine / Edit / Cancel.
3. Ready opens a second Herdr pane. The new Pi session explicitly forks the planning session and compacts that fork.
4. The original session becomes the implementation worker. It keeps the full conversation and normal tools.
5. The fork becomes a read-only supervisor. pi-supervise gives it compact worker views and carries its instructions to the worker through pi-intercom.
6. The supervisor compacts again when its context reaches 100k tokens.
7. The supervisor records a private approval only after it sees a stopped worker, no active work, a clean commit, evidence, and saved verification output. CompleteGoal checks that approval against the exact plan block and Git tree before it ticks [x].

The two Pi sessions are visible. You can switch to the supervisor pane and talk to it directly.

Install

This branch requires Herdr 0.7.5 or newer. One Pi package bundles its supervisor and intercom extensions:

pi install npm:@wassname2/pi-goals

For a local checkout:

pi -e .

Run Pi from the Git repository that the plan will change. Ready fails if the current directory is not inside a Git repository; this prevents approval from checking the wrong repository.

Commands

/goals <objective>          create a new plan
/goals model <model>        select the visible supervisor model
/goals model                use Pi's current default model
/goals clear                close the supervisor pane and disconnect the plan

/goals clear keeps the plan file. Starting another plan also keeps older versions.

Plan format

A goal is a checkbox line whose text starts with goal::

1. [ ] goal: Produce the report
   - subtle failure mode: the report exists but uses stale data
   - discriminator: the report cites the current input and the saved check confirms it
   - verify: `just verify`
   - evidence: (empty until sign-off)

The worker saves verification output in a nonempty repository file, adds that path to evidence, and commits it. The supervisor calls ApproveGoal with the inspected path; the worker then calls CompleteGoal with the exact goal text.

Development

npm test
npm run typecheck
npm run lint

test/rpc-review.test.ts runs the planning review flow through Pi's real RPC protocol with a local deterministic model. The Herdr launcher and visible supervisor bootstrap have focused tests; use a real Herdr session for the final two-pane check.

-- PI[gpt-5.6-sol]