return &ClassifyState{

	state := &ClassifyState{

	}, nil

	}
	// When filtering, remove files with no matching segments
	// so navigation doesn't land on empty files
	if config.Filter != "" || config.Species != "" {
		var matching []*utils.DataFile
		for _, df := range dataFiles {
			if len(state.getFilteredSegments(df)) > 0 {
				matching = append(matching, df)
			}
		}
		state.DataFiles = matching
	}
	return state, nil

	fmt.Fprintf(os.Stderr, "  skraak calls classify --folder ./data --reviewer David --bind k=Kiwi --filter mymodel --species Kiwi+Duet\n")

### Available MCP Tools (9 total)

### Available MCP Tools (8 total)

- `import_ml_selections` - Import ML-detected selections from folder structure

./skraak import selections --db ./db/skraak.duckdb --dataset abc123 --cluster clust789 --folder /path/to/Clips_filter_date

# Scope to a specific filter (ML model)
./skraak calls classify --folder ./data --reviewer David --bind k=Kiwi --filter opensoundscape-kiwi-1.2
# Scope to species (and optionally calltype) within a filter
./skraak calls classify --folder ./data --reviewer David --bind k=Kiwi \
    --filter opensoundscape-kiwi-1.2 --species Kiwi+Duet

## [2026-03-29] `--species` flag for `calls classify`
Added `--species` flag to scope classification to a single species (and optionally calltype).
Composable with `--filter` for focused review of specific detections within an ML model's output.

**Examples:**
```bash
# Review only Kiwi Duet calls from a specific filter
skraak calls classify --folder ./data --reviewer dave --bind k=Kiwi \
  --filter opensoundscape-kiwi-1.2 --species Kiwi+Duet
# Review all Kiwi calls (any calltype)
skraak calls classify --folder ./data --reviewer dave --bind k=Kiwi --species Kiwi
```
**Changes:**
- `tools/calls_classify.go` — Added `Species` and `CallType` fields to `ClassifyConfig`;
  extended `getFilteredSegments()` with `segmentMatchesFilters()` for AND-composable
  filter+species+calltype matching; prune data files with no matching segments on load
- `cmd/calls_classify.go` — Parse `--species` flag (rejects duplicates), zero-segment
  guard before TUI launch, comprehensive `printClassifyUsage()`
## [2026-03-29] Codebase consistency improvements
**Changes:**
- `tools/import_file.go` — Single DB connection per `ImportFile()` call (was 3), uses
  `validateHierarchyIDs()`, passes `ctx` and `*sql.DB` to helpers
- `tools/import_files.go` — Extracted `validateHierarchyIDs()` for reuse
- `tools/bulk_file_import.go` — `bulkCreateCluster` uses `db.BeginLoggedTx()` for
  transaction audit logging
- `cmd/common.go` — Extracted `initEventLog()` helper, replacing 14 instances of
  6-line event log boilerplate across 7 cmd files
- `tools/export.go` — Documented why `fmt.Sprintf` for table names is safe (hardcoded manifest)
- `tools/location.go` — Fixed `Exec` → `ExecContext` for context propagation consistency
- `utils/cluster_import.go` — Exported `LocationData` and `GetLocationData` for cross-package use
- Removed duplicate godoc comments on several tool functions