Skip to content

feat(skill): add port-forward manager to dev-cluster skill#820

Open
jeremyeder wants to merge 2 commits intoambient-code:mainfrom
jeremyeder:jeder/dev-cluster-port-forwarding
Open

feat(skill): add port-forward manager to dev-cluster skill#820
jeremyeder wants to merge 2 commits intoambient-code:mainfrom
jeremyeder:jeder/dev-cluster-port-forwarding

Conversation

@jeremyeder
Copy link
Contributor

Summary

  • Add port-forward-manager.sh script that eliminates zombie kubectl port-forward processes and port conflicts through structured lifecycle management (preflight, start, stop, status, restart)
  • Rewrite SKILL.md to be concise (263 lines, down from 659) conforming to the agentskills.io specification, with port forwarding as a first-class concern
  • Standard port assignments: backend→8081, public-api→8082, frontend→8080 (optional)

What the script does

Command Purpose
preflight Kill zombies, validate ports free, check cluster reachability
start [services] Launch port-forwards with PID tracking + health verification
stop Kill tracked + untracked processes, clean PID files
status Report health with HTTP connectivity check per service
restart [services] Atomic stop + preflight + start cycle

Test plan

  • Tested preflight against running kind cluster
  • Tested start — both services start with PID tracking
  • Tested stop — clean shutdown, PID files removed
  • Tested restart — full cycle works end-to-end
  • Tested status — shows healthy with HTTP status codes
  • Verified script handles port conflicts (lsof check)
  • Verified zombie detection (pgrep-based cleanup)

🤖 Generated with Claude Code

jeremyeder and others added 2 commits February 28, 2026 20:12
Daily scheduled triage of open issues via ACP session using
the triage workflow from ambient-code/workflows.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add a port-forward-manager.sh script that eliminates zombie processes
and port conflicts by providing structured lifecycle management:

- preflight: kills existing zombies, validates ports are free, checks
  cluster reachability
- start: launches port-forwards with PID tracking and health verification
- stop: kills tracked + untracked processes, cleans PID files
- status: reports health of each service with HTTP connectivity check
- restart: atomic stop + preflight + start cycle

Standard port assignments:
  backend    → localhost:8081
  public-api → localhost:8082
  frontend   → localhost:8080 (optional, NodePort usually sufficient)

Also rewrites SKILL.md to be more concise (263 lines, down from 659),
conforming to the agentskills.io specification (<500 lines), with port
forwarding as a first-class concern rather than an afterthought.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@ambient-code
Copy link
Contributor

ambient-code bot commented Mar 5, 2026

Merge Readiness — Blockers Found

Check Status Detail
CI pass
Merge conflicts FAIL Has merge conflicts
Review comments pass
Jira hygiene warn No Jira reference found
Staleness pass
Diff overlap risk pass

This comment is auto-generated by the PR Overview workflow and will be updated when the PR changes.

@ambient-code
Copy link
Contributor

ambient-code bot commented Mar 11, 2026

🚦 Review Queue Status

This PR has 1 blocker(s) preventing merge:

  • Merge Conflicts: Has merge conflicts

Action Needed

Resolve merge conflicts


This comment is posted by the Review Queue workflow. It will update when blockers change.

@ambient-code ambient-code bot modified the milestones: Merge Queue, Review Queue Mar 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant