FOURSQUARE PUBLISHING WORKBENCH — SEARCH DESIGN AUDIT
October 31, 2026 | Version 1.0.2

WHAT WENT WRONG
The original search relied on literal text matching. The initial plural repair only changed query words and skipped words already present in the vocabulary. It therefore left asymmetric service/services and supply/supplies retrieval. Punctuation, apostrophes, alternate path separators, and dotless i were not handled consistently. Browse filters could narrow results without clear visibility. Earlier verification covered examples and event/events, rather than exhaustive catalog retrieval. That was insufficient.

WHAT CHANGED
One cached index now applies the same spelling and common word-form rules to query text and every category name and parent path. It handles tested singular/plural forms, Latin accent folding, dotless i, straight/curly apostrophes, &/and, repeated spaces, and punctuation/path separators. Original labels and category IDs stay unchanged. Exact IDs have priority. Related-term matches are labeled and may apply through a matching parent branch. New search text clears browse filters; subsequent filters show hidden match counts.

TEST RESULTS
Category entries: 1279
Same retrieval checks before and after: 10195
Unique query strings: 9895
Before this design audit: 1372 failed checks; 8823 passed.
After repair: 0 failed checks; 10195 passed.
These counts describe test cases, not unique broken keywords. Most earlier failures were alternate hierarchy-separator cases.

Exact category name: 1279 checks; before 0 failed; after 0 failed.
Exact category ID: 1279 checks; before 0 failed; after 0 failed.
Full hierarchy path: 1279 checks; before 0 failed; after 0 failed.
Case and accents: 1279 checks; before 1 failed; after 0 failed.
Punctuation and spacing: 1279 checks; before 1 failed; after 0 failed.
Ampersand spelling: 68 checks; before 68 failed; after 0 failed.
Alternate hierarchy separator: 1279 checks; before 1267 failed; after 0 failed.
Curly apostrophe: 8 checks; before 8 failed; after 0 failed.
Word anywhere in path: 1248 checks; before 1 failed; after 0 failed.
Singular of catalog plural: 14 checks; before 3 failed; after 0 failed.
Regular plural stress cases: 1180 checks; before 21 failed; after 0 failed.
Supported related-term branches: 3 checks; before 2 failed; after 0 failed.

Regular plural stress cases are mechanically generated variants. They test matching behavior, not a claim that every generated form is natural English. Singular variants are limited to observed forms or explicit suffix cases. The adjective new is not pluralized into news.
Additional regression checks cover all 132 major-branch / depth / end-category filter combinations, matching-ID overlap, event/events parity, service/services parity, supply/supplies parity, Children’s Hospital, PILAVCI, and negative controls for news and punctuation-only queries.

EXAMPLES OF BROADER FAILURES FOUND
- services missed some Service paths because Services itself existed elsewhere in the catalog.
- arts missed some Art paths; computers missed some Computer paths.
- supply missed Construction Supplies Store and Pet Supplies Store.
- accessory missed Fashion Accessories Store and Car Parts and Accessories.
- Children’s Hospital and Doctor’s Office with curly apostrophes missed straight-apostrophe labels.
- Arts & Entertainment missed Arts and Entertainment.
- A hierarchy pasted with / in place of > missed its matching path.
- PILAVCI missed the source spelling Pilavcı.

LIMITS
This is deterministic category search. It is not unrestricted semantic search, translation, typo correction, or a live business/event search. Keyword fragments and reordered words can return broader matches; inspect each original path before selecting it. Related-term coverage is finite and shown in the search help. A zero result means no catalog term matched the input, not that a service or business is absent. These checks verify expected catalog retrieval and selected exclusions; they do not prove every possible wording or relevance order. All place counts and rankings still require the place data query.

PROVENANCE
Audited prior Site source commit: 96f01ba41950ad6a047aaaca55704ab2d07f59f9
Current engine SHA256: 82bb37bfa539600c1f03b9f8fa39516d17891e4f7efddb7af3e856521175bf73
Test driver: scripts/audit-search.cjs
Full machine-readable results and prior engine retained in the Site source repository.

Later additions provide saved-database query generation; the audited category matching implementation is unchanged.
