Vault Sync

vault-sync — kod değişikliklerini vault'a sindir

Tetiklendiğinde yapılacaklar:

1. Proje ve vault yolunu belirle

1. Çalışma dizininin (pwd) köküne bak — CLAUDE.md var mı?
2. Varsa Vault (llm-wiki-mind) bölümündeki vault yolunu oku.
3. Yoksa kullanıcıdan iki yolu sor (PROJECTPATH, VAULTPATH).
4. Vault yolunu doğrula: /CLAUDE.md ve /index.md mevcut olmalı.

2. Değişiklik aralığını belirle

Varsayılan: otomatik tespit. Soru sorma. Vault'un log.md dosyasından en son ingest edilen commit'i bul ve oradan HEAD'e kadar atılmamış olan tüm commit'leri sync'le.

LAST_HASH=$(grep -oE 'commit `[a-f0-9]+\.\.[a-f0-9]+`' "$VAULT_PATH/log.md" \
  | tail -1 \
  | sed -E 's/commit `[a-f0-9]+\.\.([a-f0-9]+)`/\1/')

cd "$PROJECT_PATH"
NEW_COUNT=$(git rev-list --count "$LAST_HASH..HEAD" 2>/dev/null || echo "?")

Sonra duruma göre:

• Yeni commit var (NEW_COUNT > 0) — Aralık otomatik olarak $LAST_HASH..HEAD belirlendi. Kullanıcıya kısa bir teyit yaz (örn. "Vault ``'e kadar güncel, oradan HEAD'e kadar N commit ingest edeceğim.") ve direkt §3'e geç. Soru sorma.
• Yeni commit yok (NEW_COUNT == 0) — "Vault zaten en son commit'e kadar güncel (``). Sync'lenecek bir şey yok." mesajıyla durdur.
• log.md parse edilemezse (ilk ingest, format değişikliği vb.) — geri çekil ve AskUserQuestion ile sor:
• Son commit (HEAD~1..HEAD): tek değişiklik.
• Belirli commit / aralık (kullanıcı hash verir).
• Aktif branch'in divergence'ı (main..HEAD): PR bütünü.
• Belirli tarih aralığı (örn. "son 7 gün").

Override: Kullanıcı komutu çağırırken explicit bir aralık (örn. /vault-sync HEAD~3..HEAD) veya doğal dilde belirtirse ("son commit", "PR bütünü"), otomatik tespit yerine kullanıcının seçimi kullanılır.

3. Değişikliği topla

cd "$PROJECT_PATH"
git log --format="commit %H%n%an %n%ad%n%n%B%n---" "$RANGE" > /tmp/vault-sync-log.txt
git diff --stat "$RANGE"
# Kritik dosyalar için tam diff:
git diff "$RANGE" -- 

Kısa özet dosyası hazırla: etkilenen klasörler, dokunulan dosya sayıları, commit mesajları, ne değişti kısa özet.

4. Raw'a düşür

/raw/pr-discussions/YYYY-MM-DD-.md oluştur. İçerikte:

# 

**Commit**: 
**Yazar**: 
**Tarih**: 
**Aralık**: 

## Özet

## Etkilenen dosyalar

## Önemli diff'ler

5. Ingest et

Vault'un CLAUDE.md §6 (INGEST workflow) adımlarını uygula:

1. Yeni raw dosyasını oku.
2. Anahtar çıkarımları kullanıcıyla konuş.
3. sources/YYYY-MM-DD-.md yaz.
4. Etkilenen entity/concept/decision sayfalarını güncelle. Dokunulan dosya yolu bir mevcut sayfayla eşleşiyorsa (örn. lib/features/paywall/ → entities/features/paywall.md) o sayfaya yeni bilgi ekle, updated: tarihini güncelle, sources: listesine yeni source'u ekle.
5. Yeni feature / service eklendiyse yeni entity sayfası oluştur.
6. Önemli karar içeriyorsa decisions/NNNN-.md yaz.
7. Çelişki varsa ⚠ Çelişki notu bırak — silme.
8. index.md güncelle.
9. log.md'ye append:

`` ## [YYYY-MM-DD] ingest | commit → ``

6. Özet dön

Kullanıcıya kısaca:

• Hangi sayfalar oluştu/güncellendi?
• Hangi açık sorular çıktı?
• Herhangi bir çelişki var mı?

Hatırlatıcılar

• Proje dizini ve raw/ immutable — sadece oku, yazma (raw'a script-üretimi dosya dışında).
• Vault şemasını izle — projenin kendi CLAUDE.md'si yerine vault'un CLAUDE.md'si authoritative.
• Commit büyük ve dağınıksa ingest'i parçala: önemli feature'ları ayrı source sayfalarına böl.

Kullanım örnekleri

• "Az önce portföy split feature'ını ekledim, vault'u sync'le."
• "Bu hafta yaptığım 12 commit'i topluca ingest et."
• "PR #342'de ne değişti özet çıkar, ilgili entity'leri güncelle."

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hootbu
• Source: hootbu/llm-wiki-mind
• License: MIT

Install and usage instructions live in the source repository linked above.