Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Run Gortex post-task diagnostics when the agent finishes

Open
#44 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
48/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
typescript

Research direction

Start with internal/hooks/pi.go around bridgeEventSlot and internal/hooks/posttask.go lines 71–113, then trace recordSessionWriteTargets in session_paths.go and the extension's Pi event forwarding. First determine which Pi event and delivery mode can resume the agent after it stops. Done means session-scoped diagnostics and localization checks run at task end, blocking continues the agent, and non-blocking results are shown; the issue leaves rendering and timeout behavior open.

Written by the indexing model from the issue text.

Description

enhancement
Feature

Run Gortex's post-task diagnostics when the Pi agent finishes, matching Claude Code's Stop hook.

On Stop, Claude gets "Gortex Post-Task Diagnostics" built from detect_changes -> explain_change_impact, get_test_targets, check_guards, analyze and contracts, scoped to the files this session wrote. The same hook checks localization claims in the last assistant message and can return decision: block so the model keeps working (internal/hooks/posttask.go L71-113).

What exists
  • The Pi bridge has no stop slot (bridgeEventSlot, internal/hooks/pi.go L150-161).
  • Session write targets are recorded only on the Claude path (recordSessionWriteTargets, session_paths.go L161).
Sketch
  • Gortex: record write targets in the Pi tool_call slot; add a stop / agent_end slot returning diagnostics and a block flag.
  • Extension: forward Pi's agent_end with the last assistant text; on block, queue a follow-up message so the agent continues; otherwise show the diagnostics.
To investigate
  • Which Pi event and delivery mode can continue the agent after it stopped.
  • How diagnostics should render (displayed to the user, sent to the model, or both).
  • Cost on large diffs; a timeout bigger than the 5 s hook budget may be needed.
Dominant language
TypeScript
Stars
2
Forks
1
Avg merge
10h 45m
Merged PRs (30d)
20

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from gortexhq/pi

All issues in gortexhq/pi

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.