56 lines
2.8 KiB
Markdown
56 lines
2.8 KiB
Markdown
# M12-03A Status
|
|
|
|
status: done
|
|
task: inventory append, link, and library override data-blocks and dependency closures
|
|
updated: 2026-08-17 America/New_York
|
|
enablingTask: true
|
|
parityStateChange: false
|
|
|
|
## Scope
|
|
|
|
The machine inventory separately records Append, Link, and Library Override entry points,
|
|
selectable data-block roots, non-root ID roles, direct/indirect/transitive/embedded dependency
|
|
classes, terminal ownership actions, and override reference/hierarchy/property-operation fields.
|
|
|
|
The exact closure is an actual Blender Main ID pointer graph walked by
|
|
`BKE_library_foreach_ID_link`, not a hard-coded Object-to-Mesh table. The inventory therefore
|
|
preserves cross-library and override-only dependency distinctions needed by later ownership and
|
|
invalidation contracts. It does not perform a library mutation or add a parity slice.
|
|
|
|
## Findings
|
|
|
|
- Blender 5.2 exposes 36 selectable library data-block collections. Screen and WorkSpace are
|
|
append-only; Library is source/transitive metadata, while embedded Key IDs follow their owner.
|
|
- Append can keep linked, reuse local, make local, or copy local after classifying direct,
|
|
indirect, and liboverride-only dependencies. Recursive cross-library localization is explicit.
|
|
- Link retains the source `Library`, direct `ID_TAG_EXTERN`, indirect `ID_TAG_INDIRECT`, and
|
|
transitive parent-library relationships without localization.
|
|
- Override retains a linked reference alongside a local override and hierarchy root. Its 17 RNA
|
|
fields cover reference/root flags, property paths, operations, and local/reference subitems.
|
|
- Current Web metadata represents only library source, dependency IDs, and read-only state; eight
|
|
per-ID ownership, override, and invalidation semantics remain absent and mutation stays blocked.
|
|
|
|
## Evidence
|
|
|
|
- `npm --prefix web run test:library-operation-inventory` passed with
|
|
`roots=36 appendOnly=2 operations=3 overrideFields=17 gaps=8 next=M12-03B`.
|
|
- The checker binds nine Blender/Web source files and one real nested-library fixture by SHA-256,
|
|
verifies link/append action and dependency-walk tokens, launches Blender 5.2, and compares the
|
|
actual append/link operator properties, library collections, nested source, and override RNA.
|
|
|
|
## Artifact Hashes
|
|
|
|
- inventory: `0dcb16233b52b3c0be2373f489d6bf3c771c9d6564993ff98b5d63dcd322fef7`
|
|
- checker: `1581490d1923578293202d27a1c379eb2a8c5e13be418547d148cf09c6a783fd`
|
|
- package commands: `a7cf339b0cf6fab17ef63e9394b2e540af60327f7bf1f7fe95823d182e0d3e63`
|
|
|
|
## Next Task
|
|
|
|
`M12-03B`: define source library ID, owner, read-only state, and invalidation token for all three
|
|
operations.
|
|
|
|
## Rollback
|
|
|
|
Remove the library operation inventory, checker, package command, and this status entry. Restore
|
|
M12-03A to pending and the queue to M12-03A. No parity ledger rollback is required.
|