CR-2026-03-25: Hooks Enhancement — Risk & Communications

Hook timeout

Validation takes >5s, delays edits

Low

Low

5s timeout configured; typical execution <1s

False positives

Built-in attrs flagged as undefined

Medium

Low

80+ built-in attrs whitelisted in script

antora.yml not found

File outside Antora structure

Medium

None

Graceful skip with debug logging

Hook script error

Syntax or logic bug in validator

Low

Low

Exit 0 on error; test suite validates

Workflow disruption

Excessive warnings annoying

Low

Low

Warnings are informational only

During change

None - configuration update only

After change - success

~1s added to .adoc edits; warnings on undefined attrs

After change - failure

Rollback to backup; <1 minute recovery

Worst case

Hook causes Edit operations to hang; kill hook process, restore backup