Adapter Profiles
Per-partner tuning that raises PASS rates without weakening the engine.
What adapters do
Adapter profiles let partners configure classification boosts specific to their naming conventions, folder structures, and file formats. Adapters add positive signal — they never lower confidence thresholds or bypass required groups.
Non-negotiables
- Confidence threshold (0.90) cannot be lowered
- Required artifact groups cannot be bypassed
- Screenshots/images never satisfy required classes
- No
force_passorlower_thresholdrules (server-side validation rejects these)
Rule types
| Rule | Description | Example |
|---|---|---|
token_boosts | Boost when filename contains a token | {"acme-soc2": {"bucket": "reports", "boost": 0.10}} |
folder_boosts | Boost when parent folder matches | {"compliance-export": {"bucket": "evidence", "boost": 0.10}} |
csv_header_mappings | Boost for CSV files with specific headers | {"control_id,control_name": {"bucket": "controls", "boost": 0.15}} |
json_key_mappings | Boost for JSON files with specific keys | {"findings,severity": {"bucket": "security", "boost": 0.15}} |
pdf_title_keywords | Boost for PDFs with title keywords | {"penetration test": {"bucket": "security", "boost": 0.10}} |
disambiguation | Disambiguation preferences | {"prefer_year_suffix": true, "prefer_type_ii": true} |
How it works
- Base classification runs with standard rules (10-bucket, deterministic)
- If the partner has an enabled adapter, boosts are applied after base scoring
- Images are skipped entirely (never boosted)
- Candidates are re-ranked; ambiguity may be resolved
- Validation runs against the boosted scores (same threshold, same required groups)
Example: FAIL → PASS with adapter
A partner names their SOC 2 report acme-annual-review-2025.pdf. Without adapter, the classifier scores it at 0.78 for reports (below 0.90 threshold). With an adapter boost of {"acme-annual": {"bucket": "reports", "boost": 0.15}}, the score reaches 0.93 — satisfying the reports_or_security group and lifting the kit to PASS.
API endpoints
| Method | Path | Description |
|---|---|---|
GET | /v1/adapters | List adapter profiles |
POST | /v1/adapters | Create/update adapter |
POST | /v1/adapters/{id}/enable | Enable adapter |
POST | /v1/adapters/{id}/disable | Disable adapter |