For what it is worth, this engine is the most well designed, well thought-out piece of software I've ever seen for something of its complexity. It is something of a masterpiece of software engineering.
API Documentation is here: http://www.terathon.com/c4engine/doco/
Engine Architecture is here: http://www.terathon.com/c4engine/architecture.php