far_search
Search FAR and DFARS regulations for clauses related to a specific topic, filtering by scope and deduplicating to current in-force versions.
Instructions
FAR/DFARS-scoped semantic search — the 'which clauses touch topic X' front-door that feeds far_clause_lookup. COMPOSES ecfr_search but fixes its two compliance flaws: (1) it filters to FAR (Title 48 chapter 1) or DFARS (chapter 2), EXCLUDING GSAM/agency supplements (so 'limitations on subcontracting' no longer mis-ranks GSAM 552.x over FAR 52.x), and (2) it collapses eCFR's ~5-versions-per-section HISTORICAL duplicates to the CURRENT in-force version (endsOn==null). scope: far (default) | dfars | both. dedupeVersions (default true; false shows all historical rows). partsOnly restricts to given parts (e.g. [52] clause text). Returns distinct sections with regulation/section/headingPath/excerpt/score/ecfrUrl/effectiveOn/endsOn/isCurrent, distinctSections, and the farOverhaulRisk caveat. TRUTHFUL: dedupe never drops a distinct section (the raw→distinct collapse is disclosed); a kept-historical row is marked isCurrent:false; a search-endpoint outage THROWS (never a fake 0 results); totalAvailable is null (a deduped view has no clean upstream count). Keyless.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What to search FAR/DFARS text for, e.g. 'limitations on subcontracting', 'covered defense information', 'commercial item'. | |
| scope | No | Which corpus to search: 'far' (Title 48 chapter 1, the default), 'dfars' (chapter 2), or 'both'. Excludes GSAM/agency supplements. | |
| perPage | No | Number of DISTINCT sections to return (1–20). Default 5. | |
| partsOnly | No | Restrict results to these FAR/DFARS parts, e.g. [52] for clause text only, [12] for commercial-item policy. | |
| dedupeVersions | No | Collapse each section's historical versions to the current (in-force) one. Default true. false ⇒ return all raw rows incl. historical. |