Merge README updates and scope tests to current test directory

Preserve wassname User ask and screenshot layout; retain bundled install instructions. 71 current tests pass, lint/typecheck clean. Exclude local backups/worktrees from test discovery.

Co-Authored-By: Pi/OpenAI <288921227+claudypoo@users.noreply.github.com>
This commit is contained in:
wassname
2026-09-10 18:46:46 +08:00
co-authored by Pi/OpenAI
2 changed files with 24 additions and 6 deletions
+21 -3
View File
@@ -2,9 +2,23 @@
Make a short list of goals in one Markdown plan file. The main chat keeps the high-level context, supervises a worker in a visible Herdr pane, and checks whether each goal is complete.
<img width="2513" height="1259" alt="2026-09-10_15-30-pi-goals" src="https://github.com/user-attachments/assets/35feaa15-f022-4491-bcc2-fc31cb878a9f" />
# User ask
Abridged text from the isolated test, with approval and completion shown together. Paths are shortened; bracketed labels are annotations. Model names and token counts below illustrate the intended supervisor/worker split, not measurements from this capture.
The hope is we can have a smart supervisor, with judgment and context. But it doesn't use many tokens as it checks in and sees an overview from a cheaper worker.
The supervisor has a goal / plan that it agrees on with the user, and is reminded of it in a Ralph-loop-type repeat.
It compacts every 150k or similar to avoid cost and context rot.
It steers a smaller model, adding perspective and judgment.
Since it's two panes, the user can review both, intervene in both and have visibility on sub-agent mis/communication.
-- wassname (spelling and punctuation corrected by Pi/OpenAI)
## Screenshot
Mock up:
```text
+-----------------------------------------------------------+-----------------------------------------------------------+
@@ -33,6 +47,10 @@ Abridged text from the isolated test, with approval and completion shown togethe
+-----------------------------------------------------------+-----------------------------------------------------------+
```
Real screenshot:
<img width="2513" height="1259" alt="2026-09-10_15-30-pi-goals" src="https://github.com/user-attachments/assets/35feaa15-f022-4491-bcc2-fc31cb878a9f" />
The plan file looks like this:
```md
@@ -81,7 +99,7 @@ resync-after-compaction from [tmonk/pi-goal-x](https://github.com/tmonk/pi-goal-
## Install
Requires Herdr. The package includes the worker, messaging and scheduled-prompt extensions. Remove separate installations of pi-subagents, pi-intercom and pi-schedule-prompt to avoid loading them twice.
Requires Herdr. Includes [edxeth/pi-subagents](https://github.com/edxeth/pi-subagents), pi-intercom and pi-schedule-prompt. Disable separately loaded copies to avoid duplicate commands.
```bash
pi install git:github.com/wassname/pi-goals@experiment/main-supervisor-edxeth
+3 -3
View File
@@ -38,9 +38,9 @@
"scripts": {
"build": "tsc",
"prepublishOnly": "npm run lint && npm run typecheck && npm run test",
"test": "vitest run",
"test:rpc": "vitest run test/rpc-review.test.ts",
"test:watch": "vitest",
"test": "vitest run --dir test",
"test:rpc": "vitest run --dir test rpc-review.test.ts",
"test:watch": "vitest --dir test",
"typecheck": "tsc --noEmit",
"lint": "biome check src/ test/",
"lint:fix": "biome check --fix src/ test/"