aws-samples / aws-samples/sample-autonomous-cloud-coding-agents

feat(registry): asset versioning and immutability

Open
#479 1 comment 0 reactions 0 assignees View on GitHub
enhancement registry
Dominant language
TypeScript
Stars
143
Forks
46
Avg merge
3d 9h
Merged PRs (30d)
20

Description

**Context:** ROADMAP.md → Asset versioning and immutability

---

## Component

CDK / infrastructure

## Describe the feature

Every registry asset version is **immutable** once published. Blueprints pin versions explicitly (**no floating `latest` in production**). Version resolution follows **semver constraints**. Rollback is **re-pin to prior version**, not mutation.

Enables reproducible agent executions and safe rollout without affecting **running tasks**.

**Asset kinds** (parent #246): skills, plugins, MCP servers, capabilities (verification strategies, knowledge tools), prompt fragments, Cedar policy modules.

## Use case

Reproducible agent runs and safe rollout of new tool versions without affecting in-flight tasks require immutable version artifacts.

## Proposed solution

1. S3 object versioning + write-once metadata in DynamoDB registry table.
2. Publish API rejects overwrites for existing `(asset_id, version)`.
3. Blueprint schema: `asset_ref@^1.2.0` pin semantics.
4. Task start resolves to concrete version; record on task record.
5. Tests: publish, resolve, re-pin rollback.

## Other information

- Child of #246 central asset registry epic.
- Design context: `docs/design/ARCHITECTURE.md` (registry section when added).

- [ ] This might be a breaking change

Contributor guide

Open the contributing guide

Research direction

Start with ROADMAP.md and the registry section of docs/design/ARCHITECTURE.md, then review parent issue #246 for the asset-registry boundaries. Use the proposed publish, resolve, and re-pin rollback tests as the acceptance path; done means published versions cannot be overwritten, blueprint references resolve semver constraints to concrete versions, rollbacks re-pin prior versions, and task records preserve the resolved version.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws, typescript
Domain
backend-api-design, cloud, infrastructure
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.