# Durum

Pitmaster, üç durumu karşılaştırarak çalışma ağacının durumunu hesaplar: HEAD commit'inin ağacı, dizin (hazırlama alanı) ve çalışma ağacı (diskteki gerçek dosyalar). CLI bundan `git status` tarzında bir özet yazdırırken `statusPorcelainV2()`, git için porcelain v2 biçimini yazdırır.

## Temel kullanım

```php
$entries = $repo->status();

foreach ($entries as $entry) {
    echo $entry->shortFormat() . "\n";
}
```

`shortFormat()`, git kısa biçimini yazdırır:

```
M  src/Modified.php          (staged modification)
 M src/WorktreeModified.php  (unstaged modification)
A  src/NewFile.php           (staged new file)
 D src/Deleted.php           (deleted in worktree)
?? untracked.txt             (untracked file)
```

## StatusEntry

Her dosyanın durumu bir `StatusEntry` ile gösterilir:

```php
use Pitmaster\Status\StatusEntry;

$entry->path;       // File path relative to repo root
$entry->index;      // FileStatus: HEAD-to-index state
$entry->worktree;   // FileStatus: index-to-worktree state
$entry->origPath;   // Original path for renamed entries, otherwise null
$entry->renameScore; // Similarity score for renamed entries, otherwise null
$entry->shortFormat(); // "XY path", "?? path", or "R  old -> new"
```

## FileStatus enum'ı

```php
use Pitmaster\Status\FileStatus;

FileStatus::Added;      // 'A' - new file
FileStatus::Modified;   // 'M' - content changed
FileStatus::Deleted;    // 'D' - file removed
FileStatus::Renamed;    // 'R' - file renamed
FileStatus::Copied;     // 'C' - file copied
FileStatus::Unmerged;   // 'U' - unresolved merge conflict
FileStatus::Untracked;  // '?' - not in index
FileStatus::Ignored;    // '!' - matched by .gitignore
FileStatus::Unmodified; // ' ' - no change
```

`status()` yok sayılan dosyaları raporlamaz; bu nedenle `Ignored` sonucunda görünmez.

## Porcelain v2 çıktısı

`git status --porcelain=v2` ile eşleşen, makinelerce okunabilir durum çıktısı için:

```php
echo $repo->statusPorcelainV2();
```

Çıktı:

```
1 .M N... 100644 100644 100644 ce013625030ba8dba906f756967f9e9ca394464a ce013625030ba8dba906f756967f9e9ca394464a modified-file.txt
? untracked-file.txt
```

Önce izlenen girdiler, ardından izlenmeyenler gelir. Yeniden adlandırmalar `2` satırlarını, çakışmalar ise `u` satırlarını kullanır. `git status --porcelain=v2 --branch` öğesinin `# branch` üstbilgileri yazdırılmaz ve yok sayılan dosyalar listelenmez.

## Durumun hesaplanma şekli

`WorkingTreeStatus` sınıfı üç yönlü karşılaştırmayı gerçekleştirir:

```php
use Pitmaster\Status\WorkingTreeStatus;

$status = new WorkingTreeStatus($repo->objectDatabase(), $repo->workDir(), $repo->gitDir());
$entries = $status->compute($repo->index(), $repo->resolve('HEAD'));
```

### 1. Adım: HEAD ağaç eşlemesini oluşturma

HEAD commit'inin ağacını `path => blob hash` eşlemesine düzleştirin. Bu, son commit edilmiş durumu temsil eder.

### 2. Adım: HEAD ile dizini karşılaştırma

HEAD ağacındaki ve dizindeki her dosya için:
- HEAD'de var, dizinde yok: dizin sütununda `Deleted`
- Dizinde var, HEAD'de yok: dizin sütununda `Added`
- İkisinde de var, karma farklı: dizin sütununda `Modified`
- İkisinde de var, karma aynı: dizin sütununda `Unmodified`

### 3. Adım: Dizini çalışma ağacıyla karşılaştırma

Dizindeki ve çalışma ağacındaki her dosya için:
- Dizinde var, diskte yok: çalışma ağacı sütununda `Deleted`
- İkisinde de var, içerik farklı: çalışma ağacı sütununda `Modified`
- İkisinde de var, içerik eşleşiyor: çalışma ağacı sütununda `Unmodified`

### 4. Adım: İzlenmeyen dosyaları algılama

Çalışma ağacı dizinini tarayın, `.git/` ve yok sayılan yolları atlayın; dizinde bulunmayan dosyaları her iki sütunda da `Untracked` olarak raporlayın.

## .gitignore desteği

Pitmaster, izlenmeyen dosyalardan hangilerinin yok sayılan, hangilerinin izlenmeyen olarak raporlanacağını belirlemek için `.gitignore` dosyalarını ayrıştırır.

```php
use Pitmaster\Status\GitIgnore;
```

`GitIgnore` sınıfı şu konumlardaki gitignore kalıplarını ayrıştırır:
- Depo kökündeki `.gitignore`
- Alt dizinlerdeki `.gitignore`
- `.git/info/exclude`

Desteklenen kalıp söz dizimi:
- Glob kalıpları (`*.log`, `build/`)
- Olumsuzlama (`!important.log`)
- Yalnızca dizin kalıpları (sondaki `/`)
- Kök dizine göreli kalıplar için baştaki `/`
- Özyinelemeli eşleştirme için `**`

## Durum girdilerini kategorilere ayırma

UI görünümü için yaygın bir kalıp:

```php
$staged = [];
$unstaged = [];
$untracked = [];

foreach ($repo->status() as $entry) {
    if ($entry->index === FileStatus::Untracked) {
        $untracked[] = $entry;
    } elseif ($entry->index !== FileStatus::Unmodified) {
        $staged[] = $entry;
    }

    if ($entry->worktree !== FileStatus::Unmodified
        && $entry->index !== FileStatus::Untracked
    ) {
        $unstaged[] = $entry;
    }
}
```

## CLI kullanımı

```bash
./vendor/bin/pitmaster status
```

Çıktı:

```
On branch main

Changes to be committed:
	new file:   src/Feature.php

Changes not staged for commit:
	modified:   src/Existing.php

Untracked files:
	notes.txt
```

## Fsmonitor

Pitmaster, git fsmonitor protokolü için bir yardımcı içerir:

```php
use Pitmaster\Status\Fsmonitor;
```

`Fsmonitor` sınıfı, bir belirteçten bu yana hangi dosyaların değiştiğini öğrenmek için `core.fsmonitor` kancasını sorgulayabilir (değiştirilme zamanı taramasına geri döner). `['processes' => false]` ile açılan tanıtıcılarda kendini devre dışı bırakır. `status()` şu anda bunu çağırmaz; stat verilerini ve içeriği doğrudan karşılaştırır.