@hheei/pi-goal0.1.1

Session-scoped goal commitments with native autonomy continuation and owned review.

GitHub Actions Published 7 days ago MIT ~464 downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Reports 0

No reports yet.

Readme

@hheei/pi-goal

Session-scoped goal commitments for Pi: one goal, an explicit autonomy budget, native settle continuation, and optional independent review executed by an owned @hheei/pi-subagents child.

Usage

/goal start <objective> starts a goal (native editor dialog without arguments), authorizes autonomous continuation inside the recorded budget, and delivers one visible run-bound kickoff message that prompts the model to work. It needs a selected model: without one the command refuses and writes nothing, because Pi's extension sendMessage cannot report a failed kickoff.
/goal status prints the goal, its evidence, budget, review history, cleanup diagnostics, recovery errors, and whether the session branch is already durable.
/goal pause revokes and aborts the current run before waiting for owned children; /goal resume starts a new run without refilling usage. New work stays blocked while an owned child's stop is unconfirmed.
/goal clear records a cleared goal and stops owned review children.

The model uses the goal tool (read, checkpoint, blocked, complete) while a run is active. complete requires verification evidence; with review enabled it starts an owned reviewer child whose VERDICT: APPROVED or VERDICT: REJECTED settles the goal. A rejection is delivered exactly once as a visible native boundary message; while it is pending during the parent's streaming turn, no extra continuation is spent, and another complete is refused until that feedback is actually delivered. A kickoff the host deferred past its run is cancelled before it reaches the model. A rejection that arrives only after the parent turn settled pauses the goal instead of sending an unacknowledged wakeup; resume reports the findings.

Settings

Group goal in ext_settings.json (also editable through @hheei/pi-settings):

Field	Default	Meaning
`review`	`false`	Require an independent review before a goal completes.
`continuations`	`8`	Autonomous continuation budget recorded at `start`.
`reviews`	`3`	Review attempt budget recorded at `start`.
`reviewAgent`	`"reviewer"`	pi-subagents agent used for the review.

Settings are projected into the goal at start; they never enlarge an existing goal's budget. A missing settings file uses these defaults, while an unreadable or malformed file fails /goal start instead of silently disabling an explicit review policy.

Pi creates a session file on the first user or assistant message; a goal started before that is reported as not yet durable.

See design and DESIGN.md.