umputun / agterm / 29358374850

98%

push

github

feat: add Pi agent-status support to Install Agent Status Hooks (#208)

* feat: add Pi agent-status support to Install Agent Status Hooks

Install a Pi lifecycle extension (agterm-status.ts) into
~/.pi/agent/extensions/ when Pi is set up, so a Pi agent running inside
agterm reports active/completed onto its session's sidebar row, matching
the Claude Code and Codex auto-wiring.

- agent_start -> 'active --blink'; agent_settled -> 'completed
  --auto-reset' (settled is Pi's own event for status integrations that
  need to know it will not continue automatically).
- The extension delegates to the shared agterm-agent-status.sh wrapper,
  no-ops outside agterm (guards on AGTERM_SESSION_ID), and uses a
  type-only SDK import so it needs no runtime package.
- Installer mirrors the Codex path: gated on ~/.pi/agent existing,
  ownership-marker protected, symlink/posix-mode preserving. Host-free
  path/marker logic in AgentHooksInstall (+ tests).

Pi has no native permission/question event, so status is active ->
completed only, never blocked (documented).

Control-API keep-in-sync exempt (drives the existing session status);
docs updated across README, control-api rule, agent skill, and site.

* address review: degrade Pi install on FS error, sync shell headers, reuse readExistingConfig

- installPiExtension catches the create-directory/write errors and returns a
  new PiResult.writeFailed warning instead of throwing, so a filesystem problem
  on ~/.pi/agent/extensions no longer aborts the whole install and hides that
  the Claude/Codex/shell steps succeeded. Build-integrity throws stay throws.
- integration.sh/.fish headers now list Pi alongside Claude Code and Codex as
  excluded from the default AGTERM_AGENT_RE, matching the README.
- installPiExtension reads the destination via readExistingConfig (nil=absent /
  throw=unreadable) like the Claude/Codex merges, so a non-ENOENT stat error
  can't read as absent and bypass the ownership-marker gate.
- document... (continued)

11 of 11 new or added lines in 1 file covered. (100.0%)

5265 of 5381 relevant lines covered (97.84%)

5587356.17 hits per line