# src/lib_tcl8 — Tcl 8 Specific Library Source

## Purpose

Holds library packages specific to Tcl major version 8. Use only when a package is specific to Tcl 8 or only exists in this tree.

## Ownership

- Agents should prefer `src/lib/` over this tree unless the task explicitly involves Tcl 8-specific behaviour.
- Files here follow the same `pkgIndex.tcl`-based structure as `src/lib/`.

## Local Contracts

- This tree holds source specific to Tcl major version 8.
- Prefer this tree only when the package or proc is specific to Tcl major version 8 or only exists here.
- Do not prefer this tree when an equivalent generic source exists in `src/lib/` unless version-specific behavior is relevant.

## Work Guidance

- Tcl 8 compatibility gates should use `if {$tcl_version < 9} { ... }` or `package require Tcl 8`.
- Use `punk::lib::compat` functions where available instead of raw version checks.

## Verification

- `package require <libraryname>` resolves under a Tcl 8.6+ interpreter.

## Child DOX Index

(None — currently empty)