implements PLN-0005
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user