Encore OS — Documentation

Version: 1.0.0
Created: 2026-01-08
Status: ✅ Complete

Overview

This document tracks the migration of existing search/filter/sort/pagination code to the centralized PF-57 framework.

Migration Status

Legend

✅ Complete
🔄 In Progress
⏳ Pending
❌ Blocked

Platform Foundation (PF) Modules

File	Patterns	Security Fix	Status
`src/platform/documents/useDocumentSearch.ts`	Filter, Sort, FTS	N/A	✅ Complete
`src/platform/data-manager/hooks/useRawData.ts`	Search, Pagination, Sort	✅ Added escaping	✅ Complete

HR Core Modules

File	Patterns	Security Fix	Status
`src/cores/hr/hooks/useCandidates.ts`	Search, Filter, Pagination, Sort	Replaced local escape	✅ Complete
`src/cores/hr/hooks/useEmployeeList.ts`	Search, Filter, Pagination, Sort	✅ Added escaping	✅ Complete
`src/cores/hr/hooks/useApplications.ts`	Filter, Pagination, Sort	N/A	✅ Complete
`src/cores/hr/hooks/useJobPostings.ts`	Search, Filter, Pagination, Sort	✅ Added escaping	✅ Complete

FA Core Modules

File	Patterns	Security Fix	Status
`src/cores/fa/hooks/useVendors.ts`	Search, Filter, Sort	✅ Added escaping	✅ Complete
`src/cores/fa/hooks/usePurchaseOrders.ts`	Search, Filter, Sort	✅ Added escaping	✅ Complete
`src/cores/fa/hooks/useJournalEntries.ts`	Sort	N/A	✅ Complete

Security Fixes Summary

The following hooks had unescaped ILIKE search terms which could allow pattern injection:

Hook	Before	After
`useRawData`	`%${search}%`	`escapeILikePattern(search)`
`useEmployeeList`	`%${filters.search}%`	`buildILikeOrConditions()`
`useJobPostings`	`%${filters.search}%`	`escapeILikePattern()`
`useVendors`	`%${filters.searchTerm}%`	`buildILikeOrConditions()`
`usePurchaseOrders`	`%${filters.search}%`	`buildILikeOrConditions()`

Framework Utilities Used

Utility	From	Purpose
`escapeILikePattern`	`@/platform/search`	Escape special chars in ILIKE
`buildILikeOrConditions`	`@/platform/search`	Build safe OR conditions
`calculateRange`	`@/platform/pagination`	Calculate Supabase `.range()`
`applySorting`	`@/platform/sort`	Apply sort config to query
`createSortConfig`	`@/platform/sort`	Create single-field sort

Backwards Compatibility

A backwards compatibility module was created at src/shared/lib/utils/search.ts with deprecated re-exports to ease gradual migration of other files.

Validation Checklist

Permissions V2 Migration — Complete Summary Pre-Migration Code Readiness Checklist

Start Here

Module Engineering Snapshots

Canonical AI Governance

Architecture

Integrations

Development

Decision Guides

Database

Module Reference

Testing

Migration

Operations

Governance & Security

Platform Internals

Migration Checklist

Overview

Migration Status

Legend

Platform Foundation (PF) Modules

HR Core Modules

FA Core Modules

Security Fixes Summary

Framework Utilities Used

Backwards Compatibility

Validation Checklist

​Overview

​Migration Status

​Legend

​Platform Foundation (PF) Modules

​HR Core Modules

​FA Core Modules

​Security Fixes Summary

​Framework Utilities Used

​Backwards Compatibility

​Validation Checklist

Overview

Migration Status

Legend

Platform Foundation (PF) Modules

HR Core Modules

FA Core Modules

Security Fixes Summary

Framework Utilities Used

Backwards Compatibility

Validation Checklist