fix(core): quality audit — fix docs, validation, tests, and correctness#5

AbdelStark merged 1 commit intomainAbdelStark/attnres:mainfrom

claude/quality-audit-hardening-YWODcAbdelStark/attnres:claude/quality-audit-hardening-YWODcCopy head branch name to clipboard