dazzle-linklib 0.1.0

Content-addressable link-record library -- the DazzleLib stack's L2 serialization layer (typed locators, content_id, export/import/rebase/scan).

dazzle-linklib

Content-addressable link-record library -- the L2 serialization layer of the DazzleLib stack.

A link record maps an identity to a typed list of locators plus metadata, and knows how to serialize, find, and resolve itself. One model serves three consumers:

• the dazzlelink filesystem CLI (the .dazzlelink file format),
• preserve's content-hash manifest (L3), and
• Relinker -- a hash-addressed, decentralized anti-link-rot resolver (rln.kr/{hash} -> a multi-protocol location set).

What this owns (and what it doesn't)

dazzle-linklib owns the link record: its schema, JSON I/O, the locator list, content_id, relation edges, and the injectable target resolver. It delegates the rest down the stack:

Concern	Layer
Link record, locators, content_id, relations, resolve	dazzle-linklib (L2, this lib)
File/link mechanics (create/detect/read, copy, hash, metadata)	dazzle-filekit (L1)
UNC <-> drive identity, path origin classification	unctools (L0)
Shared Protocols / TypedDicts / exception root	dazzle-lib (B)
Graph traversal (walking the records' relation edges)	dazzletreelib (perpendicular)

"Records that point at each other" live here; "walking and interpreting those pointers" do not. (See the L2 design rationale, decision D6.)

Status

0.1.0 is a name-reservation placeholder (pre-alpha). It is published to PyPI to claim the name, but exposes only its version -- there is no functional content yet. The extraction of DazzleLinkData and the resolver from the dazzlelink tool is stack phase P2 and lands in a later release -- see the Roadmap.

Installation

pip install dazzle-linklib

From source

git clone https://github.com/DazzleLib/dazzle-linklib.git
cd dazzle-linklib
pip install -e ".[dev]"

Development

python -m venv .venv
source .venv/bin/activate   # or .venv\Scripts\activate on Windows
pip install -e ".[dev]"

# Run tests
python -m pytest tests/ -v

# Install git hooks
bash scripts/install-hooks.sh

License

MIT. See LICENSE for details.