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

feat(registry): asset versioning and immutability

Aperta
#479 1 commento 0 reazioni 0 assegnatari Vedi su GitHub
enhancement registry
Lingua principale
TypeScript
Stelle
143
Fork
46
Merge medio
3g 10h
PR unite (30g)
24

Descrizione

**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

Guida per i contributori

Apri la guida per i contributori

Direzione di ricerca

Inizia da ROADMAP.md e dalla sezione registry di docs/design/ARCHITECTURE.md, quindi esamina l’issue principale #246 per i confini dell’asset-registry. Usa i test di rollback proposti per publish, resolve e re-pin come percorso di accettazione; completato significa che le versioni pubblicate non possono essere sovrascritte, i riferimenti ai blueprint risolvono i vincoli semver in versioni concrete, i rollback fissano nuovamente le versioni precedenti e i record delle attività conservano la versione risolta.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
aws, typescript
Ambito
backend-api-design, cloud, infrastructure
Tipo di issue
Funzionalità
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Tranquilla
Chiarezza
Abbastanza chiara
Idoneità per principianti
38/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.