---
name: pc_locations_drift
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func PcLocationsDrift(registryRoot string, pcID string) ([]LocationDrift, error)"
description: "Compara la tabla pc_locations contra el estado real del disco para el PC actual. Detecta tres tipos de drift: carpetas activas que no existen, entradas missing cuya carpeta reaparece, y artefactos indexados en disco sin fila en pc_locations."
tags: [doctor, sync, pc_locations, drift, pendiente-usar]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports:
  - "bufio"
  - "database/sql"
  - "fmt"
  - "os"
  - "path/filepath"
  - "strings"
  - "github.com/mattn/go-sqlite3"
tested: true
tests:
  - "active entry whose folder is missing reports missing_on_disk"
  - "active entry with existing folder reports no drift"
  - "missing entry whose folder reappears reports status_should_be_active"
  - "indexed app on disk without pc_locations row reports untracked_on_disk"
test_file_path: "functions/infra/pc_locations_drift_test.go"
file_path: "functions/infra/pc_locations_drift.go"
params:
  - name: registryRoot
    desc: "Ruta absoluta a la raiz del registry (donde vive registry.db)."
  - name: pcID
    desc: "Identificador del PC (ej: 'home-wsl'). Si vacio, se lee de la primera linea no vacia de ~/.fn_pc."
output: "Slice de LocationDrift con todos los discrepancias encontradas. Vacio si no hay drift. Error solo si no se puede abrir registry.db."
---

## Ejemplo

```go
drifts, err := PcLocationsDrift("$HOME/fn_registry", "")
if err != nil {
    log.Fatal(err)
}
for _, d := range drifts {
    fmt.Printf("[%s] %s/%s -> %s\n", d.Issue, d.EntityType, d.EntityID, d.DirPath)
}
```

## Notas

Read-only — nunca modifica la BD ni el disco. Util como paso inicial de `fn doctor sync`.

La funcion `readFnPC` es compartida en el paquete infra (lee `~/.fn_pc` ignorando lineas vacias y comentarios con `#`).

Tipos de issue reportados:
- `missing_on_disk`: entrada `active` cuya carpeta no existe → sugerir cambiar status a `missing`
- `status_should_be_active`: entrada `missing` cuya carpeta existe → sugerir cambiar status a `active`
- `untracked_on_disk`: artefacto indexado con carpeta en disco pero sin fila en `pc_locations` → sugerir insertar
