Add parsed module caching with tests

[nlothian]

Summary

• add a per-interpreter parsed-module cache keyed by file path, parser configuration, and mtime to reuse parsed directives and clauses
• bump operator table versioning and parser invocation hooks to support cache invalidation and testing
• document the cache and add coverage for reuse, nested imports, and mtime-driven invalidation

Testing

• uv run pytest tests/test_module_parsing_cache.py

---

Codex Task

[kilo-code-bot]

✅ No Issues Found

5 files reviewed | Confidence: 95% | Recommendation: Merge

Review Details

Files: docs/FEATURES.md, docs/SYNTAX_NOTES.md, tests/test_module_parsing_cache.py, vibeprolog/interpreter.py, vibeprolog/operators.py

Checked: Security, correctness, performance, error handling, cache invalidation logic

Summary: The PR adds parsed module caching to improve performance by avoiding redundant parsing of unchanged files. The implementation correctly invalidates cache on file modification time changes, operator table changes, character conversion changes, and conditional compilation state changes. Tests cover reuse across imports and invalidation on mtime changes. No security or correctness issues found.

[gemini-code-assist]

Code Review

This pull request introduces a valuable performance improvement by adding a parsed module cache, which will significantly speed up repeated consultations of the same files. The implementation is well-structured, and the inclusion of tests for cache hits and mtime-based invalidation is excellent. I have a few suggestions to improve test performance, optimize the caching logic, and enhance code readability.

[nlothian]

/gemini review