docs(contracts)!: explain canonical URL and skill metadata ownership

BREAKING CHANGE: source-map URLs now live in target observations selected by declared_url_sha256, and doctor skill identity no longer emits installed_catalog_digest. Use the documented observation join and identity.skill.state instead.
This commit is contained in:
morluto committed 2026-10-10 02:49:46 +08:00
1 parent a959a8309d
commit e36afa112f
3 files changed
+17

No files matched your search

+4
View File
@@ -81,6 +81,10 @@ one physical source map. The full URL is kept out of node identity, display
label, and edge properties, so large inline data URLs are stored once per
source-map reference.
Consumers previously reading `edge.properties.declared_url` should follow
`target_node_id` and select the observation by `declared_url_sha256` instead.
Node labels serve display; the observation preserves the original URL.
For example, a source-owned synthetic fixture proves this path without using a
third-party application: