DAC: DAC — Literate Programming Tool Revival

DAC is a small, dependency-light literate programming tool that extracts (“tangles”) named code chunks and renders (“weaves”) source documents.

Revival status

This repository is in investigation and stabilization. The legacy Tcl and Perl tanglers both pass their original nested-expansion tests. The newer dac-hfd.tcl embedded test runner has a parsing defect and must not yet be treated as a trustworthy quality gate.

Current implementations

dac / dac.tcl: Tcl implementation; currently the likely primary implementation.
dac.pl: Perl implementation with broadly equivalent tangle/weave behavior.
dac-hfd.tcl: experimental workflow wrapper for lint, embedded tests, and TDD commands.
*.dac: literate source and examples.
Generated examples: day01.py, day01.md, hello_world.pl, and hello_world.md.

Verified commands

prove -v
tclsh dac.test
./dac -t -R day01.py day01.dac

Known unsafe assumption

dac-hfd.tcl test hello_world.dac currently parses multiple test chunks as one test and exits with status 0 despite reporting failure. See STATUS.md and docs/investigation/INITIAL-FINDINGS.md.

Governance

Agent behavior is canonical in AGENTS.md. Architecture is canonical in ARCHITECTURE.md. Semantic governance is canonical in SPEECHACT.md. Any meaningful behavior or architecture change must update relevant documentation in the same unit of work.