[spec-extractor] Update package specifications for agentdrain and console

[github-actions]

Summary

Updates the package-level README specifications for pkg/agentdrain and pkg/console to reflect their current public APIs. The agentdrain README gains clarified design explanations and new code examples; the console README is substantially condensed, removing outdated spinner/progress-bar detail and replacing it with a concise overview of core capabilities and environment adaptation.

Change Classification

• Type: docs
• Scope: agentdrain, console
• Breaking: No

Key Changes

File	Change	Impact
pkg/agentdrain/README.md	Refined API descriptions, clarified design decisions, added code examples for masking/flattening workflows	Medium
pkg/console/README.md	Condensed from ~1009 to ~185 lines; removed deprecated Spinner/ProgressBar sections, replaced with concise capability and environment-adaptation overview	High

Impact Assessment

• Documentation-only change; no source code, public API signatures, or behavior modified.
• Reduces risk of stale/misleading docs for consumers of agentdrain (event mining/anomaly detection) and console (terminal rendering) packages.
• No downstream impact identified for build, CI, or runtime behavior.

Commits

ca9704e79 Update package specifications for agentdrain and console
```> Generated by [PR Description Updater](https://github.com/github/gh-aw/actions/runs/32131343756) for #53634 · auto · 42.9 AIC · ⌖ 7.57 AIC · ⊞ 7.6K · [◷](https://github.com/search?q=repo%3Agithub%2Fgh-aw+%22gh-aw-workflow-call-id%3A+github%2Fgh-aw%2Fpr-description-caveman%22&type=pullrequests)

<!-- gh-aw-agentic-workflow: PR Description Updater, engine: copilot, model: auto, id: 32131343756, workflow_id: pr-description-caveman, run: https://github.com/github/gh-aw/actions/runs/32131343756 -->

[gh-aw-bot]

@copilot Please review this PR, refresh the branch if needed, then run the pr-finisher skill and report back with the current validation status and any remaining blockers.

• No failed checks were listed in the compact queue for this run.
• make fmt could not complete in this sandbox, so no formatter push was attempted here.
• I could not retrieve PR review-thread details through the available read path for this PR number, so please confirm whether any code or CI follow-up is still required before maintainer review.

Run: https://github.com/github/gh-aw/actions/runs/32123781702

Generated by 👨‍🍳 PR Sous Chef · gpt54 · 41.3 AIC · ⌖ 7.88 AIC · ⊞ 8.8K · ◷
_{Comment /souschef to run again}

[Copilot]

@copilot Please review this PR, refresh the branch if needed, then run the pr-finisher skill and report back with the current validation status and any remaining blockers.

• No failed checks were l...

Ran pr-finisher and completed a fresh validation pass.

• ✅ Reviews — no unresolved in-scope review threads/comments found for PR [spec-extractor] Update package specifications for agentdrain and console #53634.
• ❌ Checks (local) — make fmt, make lint, make test-unit, and make recompile passed; make test failed in pkg/workflow at TestCopilotEngineInstallationWithCopilotSDKDriver (copilot_engine_test.go:2425, expected 3 install steps, got 2). This appears unrelated to this docs-only PR (only pkg/agentdrain/README.md and pkg/console/README.md changed).
• ❓ Checks (CI) — current PR workflow runs are action_required with no jobs emitted (run IDs: 32123706580, 32123706618, 32123706634, 32123706643, 32123706683); no failed job logs were available via get_job_logs. CI for any new head remains unverified until a maintainer re-triggers.
• ❌ Mergeable — PR state is open/not draft, but mergeability is currently blocked (not behind; branch is ahead of origin/main by 1 commit, behind by 0).

Actions taken: triaged PR/review state, checked branch freshness, inspected workflow runs/log availability, and ran full local validation targets.

Hand-off: maintainer should investigate/decide on the unrelated make test failure in pkg/workflow and re-trigger CI before merge.

[gh-aw-bot]

@copilot This PR is ready for maintainer investigation. Please refresh the branch if GitHub indicates an update is available, verify checks, and run the pr-finisher skill before handing back. Run: https://github.com/github/gh-aw/actions/runs/32127451201

Generated by 👨‍🍳 PR Sous Chef · gpt54 · 16.4 AIC · ⌖ 7.88 AIC · ⊞ 8.8K · ◷
_{Comment /souschef to run again}

[Copilot]

@copilot This PR is ready for maintainer investigation. Please refresh the branch if GitHub indicates an update is available, verify checks, and run the pr-finisher skill before handing back. Run: htt...

Completed a fresh pr-finisher pass.

• Branch refresh: up to date with base (origin/main); local branch is ahead 1, behind 0.
• Reviews: no unresolved in-scope review threads/comments found.
• Checks: make fmt, make lint, make test-unit, and make recompile pass; make test still fails in pkg/workflow at TestCopilotEngineInstallationWithCopilotSDKDriver (copilot_engine_test.go:2425, expected 3 install steps, got 2).
• CI verification: PR pull_request workflow runs remain action_required with no failed-job logs available via get_job_logs (runs report 0 jobs). The linked PR Sous Chef run 32127451201 is success.
• Mergeability: PR remains blocked (open, not draft, not behind).

Remaining blocker is maintainer investigation of the unrelated make test failure and CI re-trigger on maintainer infrastructure before merge.

[gh-aw-bot]

@copilot Please review the current state of this PR, refresh the branch if GitHub offers an update, and run the pr-finisher skill only if further edits are still required.

• No failed checks were listed in the compact queue for this run.
• Branch refresh was requested for this PR.
• make fmt could not be completed in this sandbox, so no formatter push was attempted here.
• Recent follow-up indicates no unresolved review feedback remains, but please confirm whether maintainer investigation of unrelated CI/test noise is still the only blocker.

Run: https://github.com/github/gh-aw/actions/runs/32129702131

Generated by 👨‍🍳 PR Sous Chef · gpt54 · 12.5 AIC · ⌖ 7.96 AIC · ⊞ 8.8K · ◷
_{Comment /souschef to run again}

[Copilot]

@copilot Please review the current state of this PR, refresh the branch if GitHub offers an update, and run the pr-finisher skill only if further edits are still required.

• No failed checks were l...

Current state check completed.

• Branch refresh: no update available; branch is still ahead 1 / behind 0 vs origin/main.
• Review feedback: no unresolved review threads/comments (get_review_comments returned none).
• Checks/CI: PR pull_request runs are still action_required with zero jobs (e.g. run 32123706580); get_job_logs confirms no failed jobs because no jobs were emitted.
• Additional runs: PR Sous Chef run 32129702131 is success; the current Copilot follow-up run is in progress.

Because no further code edits are required, I did not run pr-finisher per your instruction. At this point, maintainer-side investigation/re-trigger of the unrelated CI/test noise remains the only blocker before merge.

[github-actions]

🎉 This pull request is included in a new release.

Release: v0.87.1