sap-transport-overview

SAP Transport Overview (system-wide)

A basis-/lead-oriented register of every open transport in the system: who owns what, how large each request is, and where the risks are — without ever pulling source or diffs. It's deliberately breadth-first and token-cheap, built on one call:

• SAPTransport(action="list", summary=true, user="*", status="D") — every modifiable request, all users, with objects[] omitted and an objectCount kept. (On a busy system the full object-laden list is ~25K tokens; summary cuts it to a few KB — see ARC-1 PR #448.)

This is the breadth companion to sap-transport-review (which is depth — diffs of one transport's objects). Overview answers "what's open and risky across the landscape"; review answers "what exactly changed in this one." Don't diff here.

Smart Defaults (apply silently, do NOT ask)

Setting	Default	Rationale
Users	all (user="*")	Basis cares about the whole system, not one developer
Status	modifiable (status="D")	Open/unreleased work; pass status="R" for released, "*" for both
Payload	summary=true	Inventory needs counts + headers, never source — keeps a 100-request list cheap
Diffs	never	That's sap-transport-review's job; this skill stays breadth-only
Grouping	by owner	The basis mental model: "whose requests, how many, how big"

Input

Optional narrowing — apply if given, else default to the whole system:

• Owner / user — one developer's open requests.
• Status — D (default), R (released), * (all).
• Age / package / description filter — e.g. "older than 30 days", "in package ZSALES", "matching 'migration'".

Scope guard: the system-wide list can be hundreds of requests. Always start with summary=true. If it's still large, aggregate (counts per owner, top-N by objectCount) and offer to filter — never expand every request's object list unprompted.

Step 1: The register (cheap, always)

SAPTransport(action="list", summary=true, user="*", status="D")

Returns one row per request: id, description, owner, status, target/targetDesc, objectCount (+ per-task counts). That alone answers "what's open and how big" for the whole system.

Step 2: Expand only what matters (still no diffs)

For requests the user flags (or the suspicious ones from Step 3), pull the full object list:

SAPTransport(action="get", id="<id>")

This lists the objects (type/name/locked) — the contents, not the source. Only get the handful in focus; do not get the whole system.

Step 3: Risk / health flags (the basis value)

These are what an overview is for. Derive from the data already gathered:

• Import-order conflict — the same object in two or more open requests. The classic cause of transport-sequence breakage. To check one object across requests: SAPTransport(action="history", type="<type>", name="<name>"). To find them in a working set, get the in-scope requests and intersect their object lists.
• $TMP / local objects — won't transport; flag requests that carry them.
• Empty requests (objectCount 0) — cleanup candidates (delete or release).
• Stale — long-open requests (old changedAt); ageing backlog.
• Locked objects (locked: true from get) — block other developers; may need release or unlock.
• No target (target empty) — a local request that cannot be transported onward (often a mistake for work meant to ship).

Step 4: Report

# Open transports — <SID>  (<N> requests, <M> objects, <K> owners)

## By owner
| Owner | Requests | Objects | Notable |
|---|---|---|---|
| MARIAN | 6 | 41 | 1 empty, 1 stale (>60d) |
| ANNA   | 2 | 8  | |

## Register
| Request | Owner | Description | Objects | Target | Flags |
|---|---|---|---|---|---|
| A4HK900123 | MARIAN | Sales order RAP | 12 | LOCAL | ⚠ no target — won't ship |
| A4HK900200 | ANNA   | Pricing fix     | 3  | C11   | ⚠ ZCL_PRICE also in A4HK900123 |

## Needs attention
- ⚠ ZCL_PRICE is in 2 open requests (A4HK900123, A4HK900200) → import-order conflict; sequence or consolidate.
- ⚠ A4HK900155 (MARIAN) is empty → delete or release.
- ⚠ A4HK900090 open since <date> (>60d) → stale; confirm still needed.

Write to disk only if asked; otherwise return inline.

Error Handling

Error	Cause	Fix
list returns very many requests	Busy system	Keep summary=true; aggregate per owner + top-N by size; offer to filter
user="*" returns only my requests	Backend ignored the unfiltered query / scope limits	Confirm the SAP user may see others' requests (S_TRANSPRT); some systems restrict cross-user listing
history/get slow across many requests	Expanding too much	Only expand the flagged/in-focus requests, never the whole system
Need released history too	Default is D only	Re-run with status="R" or status="*"

When to use this skill

• Basis / release manager: "what's open across the system, and what's risky to import?"
• Team lead: "what is everyone working on right now?" / backlog and cleanup review.
• Pre-import / pre-go-live: find object overlaps and local-only requests before a transport wave.

When NOT to use this skill

• What exactly changed in a request (source diffs) → sap-transport-review.
• One object's history ("which transports touched ZCL_X") → SAPTransport(action="history", type=…, name=…) directly.
• Cross-system (is DEV ahead of QAS) → out of scope: ARC-1 binds one system per instance; run the CLI against each system and compare.

Follow-up Options

• "Review the actual changes in one of these?" → sap-transport-review.
• "Release the ready ones?" → SAPTransport(action="release") / release_recursive.
• "Clean up the empty/stale ones?" → SAPTransport(action="delete").