# get_outdated_references()

Returns only the references whose source files have changed (OUTDATED). v2 new method.

### Signature
```python
api.get_outdated_references() -> dict
```

### Return Value
```python
{
    "success": True,
    "data": [
        {
            "slot": int,
            "name": str,
            "namespace": str,
            "file_path": str,
        },
        ...
    ]
}
```
An empty `data` list means all references are up to date.

### Example
```python
from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
outdated = api.get_outdated_references()

if not outdated['data']:
    print("All references are up to date.")
else:
    for r in outdated['data']:
        print(f"  [{r['slot']}] {r['name']} — source file changed")
```

### Usage Example — Check OUTDATED Then Reload
```python
from os_fast_ref.api import FastRefAPI

api = FastRefAPI()
outdated = api.get_outdated_references()

if outdated['data']:
    result = api.reload_outdated_references()
    print(f"Reload complete: {result['success_count']} succeeded")
```
> **Note:** `check_file_status()` returns status for all references, while `get_outdated_references()` returns only OUTDATED ones. For automated pipelines that only need to detect changes, the latter is more efficient.

---