fix: add COMPILE_PERMS option for compiled template permissions (GH #118)

[toddr-bot]

What

Add a COMPILE_PERMS configuration option to control file permissions on compiled template files.

Why

File::Temp creates files with 0600 permissions. When multiple processes running as different users share a compiled template directory (via COMPILE_DIR), the second process fails to read templates compiled by the first. There was no way to override this without monkey-patching Template::Document. Reported in GH #118 (rt.cpan.org #84840).

How

• Template::Document::write_perl_file accepts an optional 4th $perms argument and calls chmod on the temp file before renaming it into place.
• Template::Provider stores the new COMPILE_PERMS config key and passes it through to write_perl_file.
• When COMPILE_PERMS is not set, behavior is unchanged (File::Temp default 0600).

Testing

• Unit tests in t/document_methods.t: verify permissions are set correctly at the write_perl_file level and flow through the full Template pipeline.
• Full test suite passes (3400+ tests).
• Windows-skipped (chmod is not reliable on Win32).

Closes #118

---

Quality Report

Changes: 4 files changed, 106 insertions(+), 6 deletions(-)

Code scan: clean

Tests: passed (OK)

Branch hygiene: clean

Generated by Kōan