alexion/ai-artifacts
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update completed dotfiles artifacts

Browse Source
This commit is contained in:
alexion
2026-08-01 20:48:48 -04:00
parent 7002d4680f
commit 99e7626e5e
12 changed files with 177 additions and 83 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
projects/dotfiles/047-pi-subagents-lifecycle-controls-task.md
View File

@@ -1,7 +1,8 @@
---
status: claimed
status: resolved
claimed-by: "019fba91-eabf-76ae-b086-a37ac061d6e8"
claimed-at: "2026-08-01T14:05:41-04:00"
completed-at: "2026-08-01T14:13:54-04:00"
parent: "[[027-pi-subagents-implementation-spec-task]]"
blocked-by:
- "[[046-pi-subagents-minimal-tracer-bullet-task]]"
@@ -23,13 +24,19 @@ Cancellation must be idempotent and should cooperate with Pi RPC before escalati
## Acceptance criteria
- [ ] Cancelling a running subagent is idempotent and reaches `cancelled`.
- [ ] Startup and runtime timeout paths reach `timed_out`.
- [ ] Child process exit before semantic settlement reaches a failure state with diagnostics.
- [ ] Parent session shutdown cancels supervised children.
- [ ] Lifecycle tests cover abort, process close, timeout, and repeated cancel calls.
- [x] Cancelling a running subagent is idempotent and reaches `cancelled`.
- [x] Startup and runtime timeout paths reach `timed_out`.
- [x] Child process exit before semantic settlement reaches a failure state with diagnostics.
- [x] Parent session shutdown cancels supervised children.
- [x] Lifecycle tests cover abort, process close, timeout, and repeated cancel calls.
## Implementation Notes
Use `agent_settled` as semantic completion.
Use process close for resource cleanup after settlement.
Resolved in branch `pi-subagents-tracer-bullet`, commit `4e6baed`.
Cancellation is idempotent, sends RPC `abort` cooperatively with a bounded grace period, then terminates the child process group on Unix.
The supervisor now tracks startup and runtime timers, clears timers on terminal states, marks shutdown cancellation as `cancelled`, and ignores later lifecycle events once a terminal state is reached.
Lifecycle unit tests cover repeated cancel, startup timeout, runtime timeout, process failure, shutdown cleanup, and cancel-after-completion.
Verification: `nix shell nixpkgs#tsx -c tsx --test modules/agents/pi/extensions/subagents/supervisor.test.ts`, managed extension derivation build, Pi RPC command smoke, live repeated cancel smoke, and `nix flake check`.