File Search Engine

Design a reusable file search library over a supplied directory provider. Queries combine name, type and size predicates with AND/OR/NOT. Traversal needs cancellation, budgets and explicit error behavior.

• Represent queries as composable predicates.
• Separate traversal from metadata/storage access.
• Bound depth, results and visited entries.
• Define link/cycle and permission-error policies.