[johnf]

Summary

Records the decisions from the Storage: pluggable storage backends for 5.0 map. Docs only; no code.

 GLOSSARY.md
+## How it is stored
+  Storage backend, Storage key, Delivery
 docs/adr/
   0002-library-enforces-access.md   # "handler" → storage backend
+  0004-pluggable-storage-backends.md

ADR 0004 in brief:

-fileHandler:    { get, head }   → redirect | stream | file(+accelPath) | false
-roCrateHandler: { get, head }
+storage: {
+  metadata(entity, ctx)          → stream | path | redirect | json | null
+  content(file, entity, ctx)     → stream | path | redirect | null
+}
+arocapi/storage/{directory,s3,ocfl,entity-meta}
+arocapi/search/{opensearch,postgres}   # moved

Evidence

• Before: GLOSSARY.md and docs/adr/ have no storage entries; ADR 0002 refers to handlers.
  After: pre-commit lint (biome, types, examples, knip, consumer types) passes. Each ADR section traces to a closed ticket on the map.

Merge Danger

Door: two-way

Docs only. Merging to main publishes a beta, but there are no code changes.

Blast Radius: none

The ADR describes 5.0 behaviour that isn't implemented yet. Until to-spec and the implementation land, CLAUDE.md and the website still describe handlers.

Closes #121

[github-actions]

Coverage Report

Status	Category	Percentage	Covered / Total
🟢	Lines	100% (🎯 100%)	1017 / 1017
🟢	Statements	100% (🎯 100%)	1070 / 1070
🟢	Functions	100% (🎯 100%)	231 / 231
🟢	Branches	100% (🎯 100%)	692 / 692

File Coverage

No changed files found.

Generated in workflow #136 for commit 2e33244 by the Vitest Coverage Report Action

[github-actions]

🎉 This PR is included in version 5.0.0-beta.7 🎉

The release is available on:

• npm package (@beta dist-tag)
• GitHub release

Your semantic-release bot 📦🚀