51 lines
2.4 KiB
Markdown
51 lines
2.4 KiB
Markdown
# M12-01C Status
|
|
|
|
status: done
|
|
task: define Web catalog schema v2, stable identities, and budgets
|
|
updated: 2026-08-17 America/New_York
|
|
enablingTask: true
|
|
parityStateChange: false
|
|
|
|
## Scope
|
|
|
|
Schema v2 represents Blender catalogs with canonical RFC4122 UUIDs and cleaned slash paths;
|
|
hierarchy is derived from `parentPath`, matching CDF semantics instead of retaining the Web v1
|
|
`parentId` graph. Asset identity binds Blender's `AssetWeakReference` fields
|
|
(`asset_library_identifier`, `relative_asset_identifier`) into a SHA-256 Web ID. A Blender
|
|
rename changes the relative identifier and therefore the stable ID, matching Blender's weak
|
|
reference behavior rather than promising an identity Blender does not provide.
|
|
|
|
All text budgets use UTF-8 bytes. Catalog/tag recovery strings keep Blender's 63-byte payload
|
|
limit, dynamic metadata permits empty strings, and catalog, asset, tag, custom-property,
|
|
custom-array, per-string, and aggregate-text counts are bounded. The positive schema fixture
|
|
is generated from the verified M12-01B desktop canonical report through production protocol
|
|
code. This task does not implement v1 migration, legacy-reader policy, IndexedDB migration, or
|
|
catalog mutation.
|
|
|
|
## Evidence
|
|
|
|
- `npm --prefix web run test:asset-catalog-v2` passed 4/4.
|
|
- The suite binds the desktop canonical report and Blender 5.2 weak-reference source, regenerates
|
|
schema v2 from the desktop report, parses the generated golden, and verifies deterministic
|
|
local/external identity hashes and exposed UTF-8/collection budgets.
|
|
- `npm --prefix web run typecheck`, `npm --prefix web run lint`, and `git diff --check` passed.
|
|
|
|
## Artifact Hashes
|
|
|
|
- protocol: `0949838efb2f69466368185b80bb1d2e851672d78311fcd5270eb0814576e5d7`
|
|
- generator: `b20e7dbd8508ca8ecf17d7da507b45b1225315bac7759c55c7b324683d660881`
|
|
- unit suite: `73038022124ddc7e683602b47a4804297b3a64ecd4819160c7ec086d2f6190ae`
|
|
- schema golden: `2abe279cebbffd1341dc61b1fdc5366dd1f6f42769ba36171782019ca61fb929`
|
|
- manifest: `612892b03a689ebe19804e495bd29744634ab43a3b29fff41adc2d7a5d0b67b9`
|
|
- Blender weak-reference source: `ace3d6468bcdb2f6190431e967495794b7afa35758fd82fc3941b1ce7d374635`
|
|
|
|
## Next Task
|
|
|
|
`M12-01D`: define and verify schema v1 to v2 forward migration.
|
|
|
|
## Rollback
|
|
|
|
Remove the schema v2 protocol, generator, unit suite, M12-01C golden/manifest, package command,
|
|
and this status entry. Restore M12-01C to pending and `nextTask` to M12-01C. No parity ledger
|
|
rollback is required.
|