Standalone Library Contract

This contract defines what it means for a 0x0 library under libs/ to stand

alone.

Required Layout

Every public library directory must contain:

libs/<name>/src/lib.0x0
libs/<name>/tests/smoke.0x0

The smoke test imports its local library source and has a stable observable

result.

Required Documentation

A public library should provide:

• top-of-file source documentation;
• doc annotations for public functions;
• explicit imports;
• expected smoke-test output;
• registry metadata once Milestone 6 lands.

Naming

Function names use kebab-case. Directory names may preserve compatibility ids

such as jmp0x1b_* until the registry alias policy decides final public names.

Dependencies

Library imports must be explicit. A library should not depend on hidden checkout

state or old /home/n0um3n4/repositories/libs paths.

Verification

The public layout check is:

make public-standalone-libraries-check

Broader compile/smoke gates are opt-in for this roadmap because running many

compiler processes can endanger the user session.