[spec-extractor] Update package specifications for agentdrain, fileutil, gitutil, tty

[github-actions]

Package Specification Updates

This PR updates README.md specifications for the following packages:

Package	Status	Changes
agentdrain	Updated	Added Snapshot/SnapshotCluster types, fixed StageSequence description (space-separated, not comma-separated), added spec-extractor footer
fileutil	Updated	Added spec-extractor footer
gitutil	Updated	Added spec-extractor footer
tty	Updated	Added spec-extractor footer

What Changed

• agentdrain: The Snapshot and SnapshotCluster types (used by SaveSnapshots/LoadSnapshots) were missing from the spec. Also corrected: StageSequence produces space-separated output ("plan tool_call finish"), not comma-separated as previously documented. The default weights update instructions were expanded for clarity.
• fileutil, gitutil, tty: All three READMEs had accurate content but were missing the standard spec-extractor footer linking back to the workflow.

Extraction Method

• Source code analysis of exported symbols, types, and constants via grep on non-test Go files
• Package doc comment extraction
• Cross-checking README prose against actual function signatures
• Correction of factual error in StageSequence description

Round-Robin State

• Packages processed this run: agentdrain, fileutil, gitutil, tty
• Next packages in rotation: cli, console, constants, envutil
• Total packages: 20
• Coverage: 6/20 packages have spec-extractor footer (3 pre-existing + 4 newly added, minus 1 overlap)

---

Auto-generated by Package Specification Extractor workflow — run §24505740503

Generated by Package Specification Extractor · ● 1.2M · ◷

• expires on Apr 19, 2026, 10:46 AM UTC