archbird 0.0.1a1

Alpha: deterministic architecture maps, verification, and change contracts

Archbird for Python

This is the native Archbird alpha. It provides deterministic architecture maps, focused queries, structural diffs, workspaces, the built-in lexical floor, and CPython-AST precision for Python source. Verification and change contracts remain experimental during the native migration.

python -m pip install --pre archbird
archbird --config archbird.json --root /path/to/repository --check
# Python-heavy repositories automatically use up to eight AST workers.
archbird --config archbird.json --root /path/to/repository --jobs 4 --check

Library use:

from archbird import Project

project = Project.from_config("archbird.json", root="/path/to/repository")
architecture = project.map()

Archbird analyzes source bytes without importing or executing the analyzed project. The alpha package currently builds a native CPython extension from the bundled, content-hashed C snapshot. --jobs 0 is deterministic automatic selection, --jobs 1 is serial, and a positive value selects that many Python analyzer processes.

The first binary wheel targets CPython 3.10 on x86-64 glibc systems and is audited for manylinux2014/manylinux_2_17. Other supported Python versions build the same content-hashed native source from the sdist during this alpha.