implements PLN-0005

This commit is contained in:
2026-03-27 17:01:40 +00:00
parent 124c6d078e
commit e0c57814e1
12 changed files with 143 additions and 10 deletions
@@ -46,7 +46,10 @@ The following are not primary identity:
- filesystem path
- internal input file names
`asset_name` may still be used by authoring and runtime-facing APIs as a logical reference label.
The packer may also derive a canonical symbolic address from the asset root path for compile-time authoring surfaces.
That derived address is not a replacement for registry authority over `asset_id`.
`asset_name` may still exist as an authoring label, but it is not the operational compile-time identity used by the backend-owned symbolic asset surface.
## Local Identity Anchor
@@ -73,6 +76,20 @@ Rules:
Renaming `asset_name` is an API-visible change, but not an identity change.
Renaming or moving an asset root may change the derived canonical symbolic address used by compile-time symbolic references, even when `asset_id` and `asset_uuid` remain stable.
## Canonical Symbolic Address Projection
The packer runtime may project a canonical symbolic asset address derived from the asset root under `assets/`.
Rules:
- The canonical symbolic address is derived from the normalized relative asset root path.
- The canonical symbolic address is a projection for backend/frontend compile-time consumption.
- The canonical symbolic address MUST NOT replace registry ownership of `asset_id`.
- The backend may publish the projected symbolic address through a frontend-facing surface contract without exposing the raw packer snapshot format.
- `asset_name` MUST NOT be required as the operational key for this projected symbolic address.
## Unregistered Roots
An `asset.json` without a corresponding registry entry is an unregistered asset root.