# Shipped Issues

> Find open GitHub issues whose linked GUS work item is closed AND whose issue number appears in CHANGELOG.md, then close them. Use when user invokes /shipped-issues or asks to clean up shipped issues.

- Skill: `forcedotcom/shipped-issues` (Agent Skill)
- Install (CLI): `npx skillmds@latest add forcedotcom/shipped-issues`
- Raw SKILL.md: https://api.skillmd.com/api/skills/forcedotcom/shipped-issues/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: forcedotcom (https://skillmd.com/u/forcedotcom)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/forcedotcom/shipped-issues

---


# Shipped Issues

Cross-reference open GitHub issues against closed GUS work items and the shipped CHANGELOG to identify issues that were fixed and released, but never closed on GitHub.

## Inputs

- Repo: `forcedotcom/salesforcedx-vscode`
- Changelog: `packages/salesforcedx-vscode/CHANGELOG.md` (on `develop`; pull latest first)
- GUS alias: `gus` (see `.claude/skills/gus-cli/SKILL.md`)

## Workflow

### 1. Get current CHANGELOG from develop

```bash
git fetch origin develop
git show origin/develop:packages/salesforcedx-vscode/CHANGELOG.md > /tmp/shipped-changelog.md
```

Do not switch branches; run from wherever the user is.

### 2. List open issues with W- references

```bash
gh issue list --repo forcedotcom/salesforcedx-vscode --state open --limit 500 --search "W in:body" --json number,title,body,url > /tmp/shipped-issues.json
```

The `W in:body` filter narrows to issues that contain the letter W — overly broad but cheap. Locally extract `W-\d{6,9}` matches per issue (regex; multiple W- per issue is allowed). Drop issues with no match.

### 3. Query GUS for status of each W-

Batch in chunks of ~50 W- names per query to stay under SOQL limits:

```bash
sf data query --query "SELECT Id, Name, Status__c, Last_Modified_Internal_Closed_Date__c FROM ADM_Work__c WHERE Name IN ('W-1234567','W-2345678', ...)" -o gus --json
```

Closed terminal statuses (any of these counts as closed): see `.claude/skills/gus-cli/SKILL.md` § Status\_\_c values "Closed (terminal)".

Quick check: `Status__c LIKE 'Closed%' OR Status__c IN ('Completed','Fixed')`.

### 4. Filter to candidates

Keep an issue only when **every** W- on the issue resolves to a Closed/Completed status in GUS. If any linked W- is still open, skip the issue (work isn't all done).

### 5. Cross-reference CHANGELOG

For each candidate issue number `N`, search `/tmp/shipped-changelog.md` for any of:

- `ISSUE #N` (case-insensitive)
- `issues/N` (link form)
- `#N` only when the surrounding line clearly references an issue, not a PR

If matched → issue is **shipped**. Record the matched CHANGELOG line for the closing comment.

### 6. Present the report

Show a table to the user before closing anything:

| Issue | Title | W- | WI Status | Shipped in (CHANGELOG line) |
| ----- | ----- | -- | --------- | --------------------------- |

Also list any **near-miss** rows separately so the user can review:
- Issues where WIs are all closed but the issue # isn't in the CHANGELOG (maybe under-the-hood / not customer-facing)
- Issues where some W- are still open

### 7. Close issues — only after explicit user confirmation

For each confirmed issue, post a comment then close:

```bash
gh issue close <number> --repo forcedotcom/salesforcedx-vscode --comment "Closing — shipped in <version>. See CHANGELOG entry: <verbatim line>. (Linked work item <W-XXXXXXXX> is closed.)"
```

Do **not** loop-close without user confirmation. If many issues, present the full list and ask "Close all N?" once.

## Edge cases

- **Multiple W- per issue, mixed status**: skip until all W- close.
- **Issue body mentions W- in a quoted error or unrelated context**: rare; surface as candidate anyway, the user reviews the table.
- **CHANGELOG hit on a `## Under the Hood` line**: still counts as shipped — user can opt out per-row.
- **Issue # shows up in CHANGELOG as `[PR #N]`**: not a match. Only `ISSUE #N` / `issues/N` indicate the issue itself.
- **No CHANGELOG match but WI closed long ago**: list as near-miss, don't auto-close.

## Output format

End with a one-line summary: `Closed N issues; M near-misses for review.`