[nichinichisou0609]

Summary

unity.export (version 2) now runs one task per unit:

• A unit is a prefab hierarchy (a root GameObject with the objects its prefab holds) or an object outside any hierarchy.
• A unit is named by the stable address of its root object, <bundle>:<pathId>.
• Path ids stay when a bundle's content changes, so a unit keeps its task id across catalog versions.

Unit table and selection

• The unit table (nnnotes.pipeline.units) is built from the censuses.
• A run exports the units of the selected bundles, plus every unit their objects reference (census refs).
• --only-class now selects units by the class of their root object. It is no longer part of the task keys.

Batching and keys

• The tasks of one bundle are one batch: a worker loads the bundle once and shares its object index, hierarchies, atlases and last decoded textures.
• A unit's result depends neither on the other units of its batch nor on their order (tested).
• A task key holds:
  • the bundle;
  • the unit's root;
  • the converters of its classes;
  • the script entries and shipped type trees its objects use.

Other changes

• MonoScript and AssetBundle objects get the generic typetree JSON.
• The bundle-level scripts.json and bundle.json artifacts are removed, as are the link.artifacts stage and the nnnotes.artifacts/1 schema.
• The original layout roots objects without a container path at _bundles/<bundle>, from the unit table.
• cri.audio, cri.movie, sprite.crop and view.voices find bundle-held content through the unit table.
• Docs: stages.md has a new "Units" section, and assets.md, contracts.md, schemas.md and cli.md are updated.

Test plan

• Full test suite
• Golden records regenerated with the pinned environment and checked with GOLDENS_STRICT=1
• ruff, pyright, import-linter, mkdocs build --strict

🤖 Generated with Claude Code