Skip to content

feat(api): expose authorized Asset release history for delivery clients #123

Description

@kl3inIT

Problem

GET /api/asset-delivery returns one AssetSummary per Asset carrying a single releaseId/versionLabel — the current usable release. An older release is still addressable (GET /api/asset-delivery/{assetId}/releases/{releaseId} works if you know the UUID) but not discoverable.

Consequences today:

Proposal

Add GET /api/asset-delivery/{assetId}/releases returning the releases of one Asset that the current actor may use.

Constraints that must hold:

  • same authorization path as the rest of asset-delivery, no second ACL;
  • released state only — no draft, no governance/portfolio internals, matching the delivery boundary the asset-registry spec already promises;
  • per item: releaseId, versionLabel, releaseDigest, releasedAt, availability;
  • deterministic order (newest first).

Then in apps/mcp: extend AssetCompletionAdapter so release_id suggests the full authorized history, and consider a list_asset_releases read-only tool.

Acceptance

  • Endpoint implemented with the authorization recheck and the released-only boundary
  • contracts/openapi.json regenerated via OpenApiContractTests
  • Asset-registry domain spec + test matrix reconciled
  • MCP completion suggests historic releases

Notes

Do this before the prompt-coordinate change: that one needs exact version labels, which this endpoint supplies.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions