punkshell/src/lib_tcl8/AGENTS.md

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)