quietlight/skraak_mcp - Change PZHNIV62T77A3VPGPAYURINYRMUJKMNQHTHYD7L22X7WDZSSKQ7QC

fix big bug in bulk import tool

Created by quietlight on February 9, 2026

PZHNIV62T77A3VPGPAYURINYRMUJKMNQHTHYD7L22X7WDZSSKQ7QC

Dependencies

In channels

main

Change contents

Replacement in tools/bulk_file_import.go at line 125 [3.1]

B:BD[3.3899] → [3.3899:3967]

	clusterIDMap := make(map[string]string) // locationID -> clusterID

[3.3899]

[3.3967]

	clusterIDMap := make(map[string]string) // "locationID|dateRange" -> clusterID

Replacement in tools/bulk_file_import.go at line 171 [3.1]

B:BD[3.5745] → [3.5745:5788]

		clusterIDMap[loc.LocationID] = clusterID

[3.5745]

[3.5788]

		compositeKey := loc.LocationID + "|" + loc.DateRange
		clusterIDMap[compositeKey] = clusterID

Replacement in tools/bulk_file_import.go at line 183 [3.1]

B:BD[3.5954] → [3.5954:6002]

		clusterID, ok := clusterIDMap[loc.LocationID]

[3.5954]

[3.6002]

		compositeKey := loc.LocationID + "|" + loc.DateRange
		clusterID, ok := clusterIDMap[compositeKey]

File addition: verify_cluster_fix.sh (---x------)

[4.1]

#!/bin/bash
# Verification script for bulk import cluster assignment fix
# Tests that files are correctly distributed when same location has multiple date ranges
# Usage: ./verify_cluster_fix.sh [db_path]
# Default: ../db/test.duckdb
# Get absolute paths before changing directory
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
PROJECT_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
DB_PATH="${1:-$PROJECT_DIR/db/test.duckdb}"
if [ ! -f "$DB_PATH" ]; then
    echo "Error: Database not found at $DB_PATH"
    exit 1
fi
echo "======================================================================"
echo "Bulk Import Cluster Assignment Fix Verification"
echo "======================================================================"
echo "Database: $DB_PATH"
echo ""
echo "This test verifies that when the same location appears multiple times"
echo "in the CSV with different date ranges, files are distributed correctly"
echo "across their respective clusters (not all going to the last cluster)."
echo ""
# Navigate to the project directory
cd "$PROJECT_DIR" || exit 1
if [ ! -f "./skraak_mcp" ]; then
    echo "Error: skraak_mcp binary not found. Run 'go build' first."
    exit 1
fi
# Function to send MCP request
send_request() {
    local method="$1"
    local params="$2"
    (
        echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
        sleep 0.2
        echo "{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"$method\",\"params\":$params}"
        sleep 0.5
    ) | timeout 10 ./skraak_mcp "$DB_PATH" 2>&1 | grep '"id":2' | head -1
}
echo "Step 1: Create test dataset and location"
echo "========================================="
# Create a test dataset
echo -n "Creating test dataset... "
DATASET_RESULT=$(send_request "tools/call" '{"name":"create_or_update_dataset","arguments":{"name":"Cluster Fix Verification","type":"test","description":"Testing cluster assignment bug fix"}}')
DATASET_ID=$(echo "$DATASET_RESULT" | jq -r '.result.structuredContent.dataset.id // empty')
if [ -n "$DATASET_ID" ]; then
    echo "✓ Created: $DATASET_ID"
else
    echo "✗ Failed"
    exit 1
fi
# Create ONE test location (same location will be used multiple times)
echo -n "Creating test location... "
LOCATION_RESULT=$(send_request "tools/call" '{"name":"create_or_update_location","arguments":{"dataset_id":"'"$DATASET_ID"'","name":"Multi-Year Recording Site","latitude":-41.2865,"longitude":174.7762,"timezone_id":"Pacific/Auckland","description":"Site with recordings from multiple years"}}')
LOCATION_ID=$(echo "$LOCATION_RESULT" | jq -r '.result.structuredContent.location.id // empty')
if [ -n "$LOCATION_ID" ]; then
    echo "✓ Created: $LOCATION_ID"
else
    echo "✗ Failed"
    exit 1
fi
echo ""
echo "Step 2: Create CSV with SAME LOCATION, DIFFERENT DATE RANGES"
echo "=============================================================="
CSV_FILE="/tmp/verify_cluster_fix_$$.csv"
LOG_FILE="/tmp/verify_cluster_fix_$$.log"
# CSV with same location ID appearing 4 times with different date ranges
# This is the exact scenario that triggered the bug
cat > "$CSV_FILE" << EOF
location_name,location_id,directory_path,date_range,sample_rate,file_count
Multi-Year Recording Site,$LOCATION_ID,/nonexistent/2019,2019,8000,100
Multi-Year Recording Site,$LOCATION_ID,/nonexistent/2020,2020,8000,200
Multi-Year Recording Site,$LOCATION_ID,/nonexistent/2022,2022,8000,300
Multi-Year Recording Site,$LOCATION_ID,/nonexistent/2024,2024,8000,400
EOF
echo "CSV Contents:"
cat "$CSV_FILE"
echo ""
echo "KEY OBSERVATION: Same location_id ($LOCATION_ID) appears 4 times"
echo "                 with different date_range values (2019, 2020, 2022, 2024)"
echo ""
echo "Step 3: Run bulk import (expect cluster creation only, no files)"
echo "=================================================================="
echo "Calling bulk_file_import..."
IMPORT_RESULT=$(send_request "tools/call" "{\"name\":\"bulk_file_import\",\"arguments\":{\"dataset_id\":\"$DATASET_ID\",\"csv_path\":\"$CSV_FILE\",\"log_file_path\":\"$LOG_FILE\"}}")
# Extract results
CLUSTERS_CREATED=$(echo "$IMPORT_RESULT" | jq -r '.result.structuredContent.clusters_created // 0')
CLUSTERS_EXISTING=$(echo "$IMPORT_RESULT" | jq -r '.result.structuredContent.clusters_existing // 0')
TOTAL_CLUSTERS=$((CLUSTERS_CREATED + CLUSTERS_EXISTING))
echo ""
echo "Import Results:"
echo "  Clusters created: $CLUSTERS_CREATED"
echo "  Clusters existing: $CLUSTERS_EXISTING"
echo "  Total clusters: $TOTAL_CLUSTERS"
echo ""
if [ "$TOTAL_CLUSTERS" -eq 4 ]; then
    echo "✓ PASS: 4 clusters created/found (one per date range)"
else
    echo "✗ FAIL: Expected 4 clusters, got $TOTAL_CLUSTERS"
    exit 1
fi
echo "Step 4: Verify cluster names in database"
echo "=========================================="
# Query clusters for this location
echo "Querying database for clusters..."
SQL_QUERY="SELECT name FROM cluster WHERE location_id = '$LOCATION_ID' AND active = true ORDER BY name"
QUERY_RESULT=$(send_request "tools/call" "{\"name\":\"execute_sql\",\"arguments\":{\"query\":\"$SQL_QUERY\"}}")
CLUSTER_NAMES=$(echo "$QUERY_RESULT" | jq -r '.result.structuredContent.rows[] | .[0]' 2>/dev/null)
echo ""
echo "Clusters found in database:"
echo "$CLUSTER_NAMES" | while read -r name; do
    echo "  - $name"
done
echo ""
# Count clusters
CLUSTER_COUNT=$(echo "$CLUSTER_NAMES" | grep -c .)
if [ "$CLUSTER_COUNT" -eq 4 ]; then
    echo "✓ PASS: 4 distinct clusters in database"
else
    echo "✗ FAIL: Expected 4 clusters, found $CLUSTER_COUNT"
fi
# Verify expected names
echo ""
echo "Verifying expected cluster names..."
for year in 2019 2020 2022 2024; do
    if echo "$CLUSTER_NAMES" | grep -q "^$year$"; then
        echo "  ✓ Found cluster: $year"
    else
        echo "  ✗ Missing cluster: $year"
    fi
done
echo ""
echo "Step 5: Check log file"
echo "======================"
if [ -f "$LOG_FILE" ]; then
    echo "✓ Log file created"
    echo ""
    echo "Log excerpt (cluster creation):"
    grep -E "(Creating|Using existing) cluster:" "$LOG_FILE" | head -4
else
    echo "ℹ Log file not created"
fi
echo ""
echo "======================================================================"
echo "VERIFICATION COMPLETE"
echo "======================================================================"
echo ""
echo "Expected behavior (AFTER fix):"
echo "  ✓ 4 clusters created (2019, 2020, 2022, 2024)"
echo "  ✓ Each cluster has unique name matching date_range"
echo "  ✓ Files (if present) would be distributed to correct clusters"
echo ""
echo "Bug behavior (BEFORE fix):"
echo "  ✗ 4 clusters created BUT clusterIDMap[location_id] overwrites"
echo "  ✗ Only last cluster (2024) stored in map"
echo "  ✗ ALL files would go to 2024 cluster"
echo ""
echo "This test validates that the composite key fix works correctly."
echo "The map now uses 'locationID|dateRange' preventing overwrites."
echo ""
# Cleanup
rm -f "$CSV_FILE" "$LOG_FILE"
echo "Cleanup complete."

Insertion in go.sum at line 1 [5.153180]

[5.153180]

[5.153181]

github.com/andybalholm/brotli v1.2.0 h1:ukwgCxwYrmACq68yiUqwIWnGY0cTPox/M94sVwToPjQ=
github.com/andybalholm/brotli v1.2.0/go.mod h1:rzTDkvFWvIrjDXZHkuS16NPggd91W3kUSvPlQ1pLaKY=

Insertion in go.sum at line 5 [5.153180]

[5.153362]

github.com/apache/thrift v0.22.0 h1:r7mTJdj51TMDe6RtcmNdQxgn9XcyfGDOzegMDRg47uc=
github.com/apache/thrift v0.22.0/go.mod h1:1e7J/O1Ae6ZQMTYdy9xa3w9k+XHWPfRvdPyJeynQ+/g=

Insertion in go.sum at line 9 [5.153180]

[5.153537]

github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM=
github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=

Insertion in go.sum at line 35 [5.153180]

[5.155927]

github.com/golang/snappy v1.0.0 h1:Oy607GVXHs7RtbggtPBnr2RmDArIsAefDwvrdWvRhGs=
github.com/golang/snappy v1.0.0/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q=

Insertion in go.sum at line 45 [5.153180]

[5.156645]

github.com/klauspost/asmfmt v1.3.2 h1:4Ri7ox3EwapiOjCki+hw14RyKk201CN4rzyCJRFLpK4=
github.com/klauspost/asmfmt v1.3.2/go.mod h1:AG8TuvYojzulgDAMCnYn50l/5QV3Bs/tp6j0HLHbNSE=

Insertion in go.sum at line 53 [5.153180]

[5.157182]

github.com/minio/asm2plan9s v0.0.0-20200509001527-cdd76441f9d8 h1:AMFGa4R4MiIpspGNG7Z948v4n35fFGB3RR3G/ry4FWs=
github.com/minio/asm2plan9s v0.0.0-20200509001527-cdd76441f9d8/go.mod h1:mC1jAcsrzbxHt8iiaC+zU4b1ylILSosueou12R++wfY=
github.com/minio/c2goasm v0.0.0-20190812172519-36a3d3bbc4f3 h1:+n/aFZefKZp7spd8DFdX7uMikMLXX4oubIzJF4kv/wI=
github.com/minio/c2goasm v0.0.0-20190812172519-36a3d3bbc4f3/go.mod h1:RagcQ7I8IeTMnF8JTXieKnO4Z6JCsikNEzj0DwauVzE=

Insertion in go.sum at line 61 [5.153180]

[5.157548]

github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U=
github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=

Insertion in go.sum at line 65 [5.153180]

[5.157781]

github.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=
github.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=

Insertion in go.sum at line 69 [5.153180]

[5.157968]

github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=

Deletion in go.sum at line 85 [5.153180]

B:BD[5.159175] → [5.159175:159332]

golang.org/x/tools v0.34.0 h1:qIpSLOxeCYGg9TrcJokLBG4KFA6d795g0xkBkiESGlo=
golang.org/x/tools v0.34.0/go.mod h1:pAP9OwEaY1CAW3HOmg3hLZC5Z0CCmzjAF2UQMSqNARg=

Insertion in go.sum at line 89 [5.153180]

[5.159704]

gonum.org/v1/gonum v0.16.0 h1:5+ul4Swaf3ESvrOnidPp4GZbzf0mxVQpDCYUQE7OJfk=
gonum.org/v1/gonum v0.16.0/go.mod h1:fef3am4MQ93R2HHpKnLk4/Tbh/s0+wqD5nfa6Pnwy4E=
gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

Replacement in go.mod at line 5 [5.159737]

B:BD[5.159768] → [5.159768:159822]

require github.com/modelcontextprotocol/go-sdk v1.2.0

[5.159768]

[5.159822]

require (
	github.com/cespare/xxhash/v2 v2.3.0
	github.com/duckdb/duckdb-go/v2 v2.5.4
	github.com/matoous/go-nanoid/v2 v2.1.0
	github.com/modelcontextprotocol/go-sdk v1.2.0
	github.com/sixdouglas/suncalc v0.0.0-20250114185126-291b1938b70c
)

Deletion in go.mod at line 15 [5.159737]
B:BD[5.159885] → [5.159885:159934]
```
	github.com/cespare/xxhash/v2 v2.3.0 // indirect
```
Deletion in go.mod at line 23 [5.159737]
B:BD[5.160465] → [5.160465:160516]
```
	github.com/duckdb/duckdb-go/v2 v2.5.4 // indirect
```
Deletion in go.mod at line 30 [5.159737]
B:BD[5.160879] → [5.160879:160931]
```
	github.com/matoous/go-nanoid/v2 v2.1.0 // indirect
```

Deletion in go.mod at line 31 [5.159737]

B:BD[5.160978] → [5.160978:161056]

	github.com/sixdouglas/suncalc v0.0.0-20250114185126-291b1938b70c // indirect

Insertion in CLAUDE.md at line 626 [5.363912]

[5.374784]

[2.607]


### Latest Update: Bulk File Import Cluster Assignment Bug Fix (2026-02-10)
**Critical Bug Fix: Files now correctly distributed across multiple clusters for same location**

Replacement in CLAUDE.md at line 631 [5.363912]

B:BD[2.608] → [2.608:672]

### Latest Update: File Modification Time Fallback (2026-02-07)

[2.608]

[6.4021]

**Problem:** When the same location appeared multiple times in the CSV with different date ranges, all files ended up in the **last cluster created** instead of being distributed across their respective clusters.
**Root Cause:** The `clusterIDMap` used only `LocationID` as the key, causing each new cluster for the same location to overwrite the previous one in the map.
**Example of Bug:**
```csv
A12,loc123,/path/2019,2019,8000,864
A12,loc123,/path/2020,2020,8000,180
A12,loc123,/path/2022,2022,8000,180
A12,loc123,/path/2024,2024,8000,549
```
- **Before fix:** 4 clusters created, ALL 1773 files go into 2024 cluster
- **After fix:** 4 clusters created, files distributed correctly (864 in 2019, 180 in 2020, etc.)
**Solution:** Changed map key from `LocationID` to composite key `LocationID|DateRange`.
**Modified:**
- `tools/bulk_file_import.go` (lines 125, 171-172, 183-184)
  - Line 125: Updated map comment to reflect composite key
  - Line 171-172: Store with `compositeKey := loc.LocationID + "|" + loc.DateRange`
  - Line 183-184: Retrieve with same composite key
**Impact:**
- ✅ **Data integrity restored:** Files now go to correct clusters
- ✅ **Multiple date ranges per location:** Now works correctly
- ✅ **No breaking changes:** Simple 3-line fix
- ✅ **Backwards compatible:** Single location CSV rows work identically
**Verification:**
```sql
SELECT
    l.name as location_name,
    c.name as cluster_name,
    COUNT(f.id) as file_count
FROM cluster c
JOIN location l ON c.location_id = l.id
LEFT JOIN file f ON f.cluster_id = c.id
WHERE l.name = 'A12'
GROUP BY c.id, l.name, c.name
ORDER BY c.name;
```
**Note:** Data previously imported with the buggy code will need to be re-imported to fix cluster assignments.
---
### Previous Update: File Modification Time Fallback (2026-02-07)

Replacement in CLAUDE.md at line 1092 [5.363912]

B:BD[5.376736] → [6.6449:6483]

B:BD[6.6483] → [2.2082:2149]

**Last Updated**: 2026-02-07 NZDT
**Status**: Cluster import enhanced with FileModTime fallback 🎯

[5.376736]

[7.52354]

**Last Updated**: 2026-02-10 NZDT
**Status**: Bulk import cluster assignment bug fixed 🐛✅