features-zettel_ids

To allocate a two-part ID safely, identify and consume a valid ID from the available pool using built-in concurrency controls. This ensures safe, concurrent access while mapping Left/Right parts via Yin/Yang providers without race conditions.

When Zettel ID allocation hits pool exhaustion, the system provides proper error handling to detect and report that no IDs are left. This prevents over-allocation and supports testing scenarios for debugging exhaustion messages.

Two-part ID mapping translates between 2D Left/Right coordinates and 1D indices for efficient storage. This coordinate mapping uses Yin/Yang providers to handle creation, addition, and peeking operations reliably.

Yes, you can peek at available Zettel IDs without marking them as consumed. The provider supports peeking operations alongside creation and addition, allowing you to inspect the pool before final allocation.

The best way to manage ZettelId lifecycle is through structured allocation, addition, and lookup operations that mark IDs as consumed. This enables reliable generation, tracking, and exhaustion handling during initialization or minting.

You need Yin/Yang providers for Dodder Zettel ID allocation to handle the two-part Left/Right ID structure and coordinate mapping. They ensure safe concurrent access and proper error handling during creation and addition operations.