tillerhand 3.28.6 → 3.30.0

package/.claude/commands/adopt.md

@@ -41,7 +41,7 @@ Bulguları kısa bir tablo halinde göster. Hızlı taramada kodun içine dalma:
 ## Adım 2: Tip ve kurulum
 
 1. Taramaya göre tipi öner ve onaylat (web-saas / mobile / backend; AI özelliği var mı; Türkiye'de satış veya Türk kullanıcı varsa Türkiye eki `tr`, ayrıntı `/start` Adım 2).
-2. Kur: `node <kit klasörü>/kit/kit.mjs install --type <tip> [--addons ai,tr] --project .` (kit klasörü `.kit.json` → `kit` alanında; alan `npx:tillerhand@<sürüm>` ise `npx -y tillerhand@<sürüm> install ...`; sürüm tam olarak `1.2.3` biçiminde ve `.kit.json` → `version` ile aynı değilse dur ve sor). Araç `init`'te seçilmediyse Adım 0'daki seçimi `--tool <liste>` olarak ekle.
+2. Kur: `node <kit klasörü>/kit/kit.mjs install --type <tip> [--addons ai,tr] --project .` (kit klasörü `.kit.json` → `kit` alanında; alan `local` ise klasör git dışı `.kit.local.json` → `kit`'te, o dosya yoksa proje başka makinede açılmıştır: kullanıcıya kit klasörünü sor ya da `npx -y tillerhand@<.kit.json → version>` kullan; alan `npx:tillerhand@<sürüm>` ise `npx -y tillerhand@<sürüm> install ...`; sürüm tam olarak `1.2.3` biçiminde ve `.kit.json` → `version` ile aynı değilse dur ve sor). Araç `init`'te seçilmediyse Adım 0'daki seçimi `--tool <liste>` olarak ekle.
 3. **`.kit-new` dosyaları:** Her biri için (`CLAUDE.md` ve `AGENTS.md` hariç, onlar Adım 4'te) farkı özetle ve karar olarak sor: kitinkini al / projeninkini koru / birleştir. Örnekler: `.env.example` genelde birleştirilir; `ci.yml` için mevcut CI'ın yaptıklarını kitinkiyle karşılaştır. Sonra `.kit-new` dosyasını sil.
 
 ## Adım 3: Belgeleri koddan çıkar

package/.claude/commands/build.md

@@ -39,5 +39,6 @@ Boşsa `docs/workflow/progress.md` → "Sıradaki adım" veya `docs/product/road
    - Benim nasıl test edeceğim (adım adım)
    - Önerilen commit mesajı
    - Kontrol edemediğin veya şüpheli olduğun yerler
+   - Görevde bir davranışını düzelttiysem ya da tercih söylediysem: aynı AskUserQuestion çağrısında ayrı bir çoklu seçim sorusu olarak "Tercih olarak kaydedeyim mi?" (AGENTS.md → kural 9, varsa; seçilenler `prefs.mjs --add`). Not yoksa sorma.
    - Sonra ne yapalım? AskUserQuestion ile sor: `/review-changes` ve commit (Önerilen) / sıradaki göreve geç / bu görevde değişiklik iste. Commit'te hafif kurul denetimi otomatik istenir (commit kapısı hook'u). Commit atıldıktan ve testler yeşilken çalışan nokta kaydet: `node .claude/hooks/checkpoint.mjs --save "<görev kodu> bitti, testler yeşil"` (`/rollback` buraya döner).
    - Durum bloğu

package/.claude/commands/kit-update.md

@@ -5,7 +5,7 @@ argument-hint: [boş | --addons ai,tr | --tool claude,codex,antigravity]
 
 Ek argüman: $ARGUMENTS
 
-1. `.kit.json`'u oku: mevcut sürüm, `kaynak` (kit repo adresi), tip, ekler.
+1. `.kit.json`'u oku: mevcut sürüm, `source` (kit repo adresi), tip, ekler.
 2. Commit edilmemiş değişiklik varsa dur ve önce commit etmeyi öner (güncelleme dosya yazar).
 3. Kiti geçici bir klasöre klonla ve güncellemeyi çalıştır:
 

package/.claude/commands/retro.md

@@ -28,7 +28,7 @@ Amaç: Bu projede öğrendiklerini kaybetmemek ve kiti (bundan sonraki tüm proj
    - Kural ekleme > kural değiştirme > kural silme sırasıyla tercih et; kiti şişirme. Aynı amaçlı mevcut kural varsa onu güçlendir. Metni `mattpocock-skills:writing-for-agents` ilkeleriyle yaz.
    - Önerileri **çoklu seçimle** onaylat.
 6. Onaylananları kite uygula:
-   1. `.kit.json` → `kaynak` reposunu geçici klasöre klonla.
+   1. `.kit.json` → `source` reposunu geçici klasöre klonla.
    2. `retro/<proje>-<tarih>` dalı aç.
    3. Değişiklikleri yap, `kit/CHANGELOG.md` → "[Yayınlanmamış]" bölümüne ekle.
    4. `node --test "kit/tests/*.test.mjs"` çalıştır, commit at.

package/.claude/commands/start.md

@@ -40,7 +40,7 @@ Bu bir **9 adımlı sihirbaz** (0-9). Kullanıcı hiçbir şeyi bilmiyormuş gib
     - **Kapalı (Önerilen):** Projenin hafızası `AGENTS.md`, `progress.md` ve karar günlüğünde; görünür ve git'te. Tekrarlayan hatalar `/fix-bug` ile "Öğrenilen kurallar"a önerilir. `.claude/settings.json`'a `"autoMemoryEnabled": false` ekle (dosyayı birleştir).
     - **Açık:** Tercihlerin oturumlar arasında kendiliğinden hatırlanır; notlar `AGENTS.md` ile çelişebilir. Ayara dokunma.
     Seçimi `**Profil:**` satırına ekle (örn. `hafıza: kapalı`). Kaynak: code.claude.com/docs/en/memory (2026-10-25).
-1. Ortamı kontrol et ve tek satırla raporla: `node --version`, `git --version` ve kitin yeri. İki kurulum yolu var: kökte `kit/kit.mjs` (template yolu) ya da `.kit.json` → `kit` alanındaki klasör (`init` ile kurulmuş, `type` boş). `kit` alanı `npx:tillerhand@<sürüm>` ise kit npm paketinden kurulmuştur. Klasörde zaten uygulama kodu varsa (`package.json`, `pyproject.toml`, `src/` vb.) dur ve `/adopt` öner.
+1. Ortamı kontrol et ve tek satırla raporla: `node --version`, `git --version` ve kitin yeri. İki kurulum yolu var: kökte `kit/kit.mjs` (template yolu) ya da `.kit.json` → `kit` alanındaki klasör (`init` ile kurulmuş, `type` boş). `kit` alanı `npx:tillerhand@<sürüm>` ise kit npm paketinden kurulmuştur. `local` ise klasörün bu makinedeki yolu git dışı `.kit.local.json` → `kit`'tedir; o dosya yoksa kullanıcıya kit klasörünü sor ya da `npx -y tillerhand@<.kit.json → version>` kullan. Klasörde zaten uygulama kodu varsa (`package.json`, `pyproject.toml`, `src/` vb.) dur ve `/adopt` öner.
 2. `docs/workflow/skills.md`'deki plugin'lerin skill'leri senin skill listende var mı bak. LSP eklentisi dil sunucusu ister: web ve mobil için `npm i -g typescript-language-server typescript`, backend için `npm i -g pyright` (global kurulum; kullanıcı onayıyla). **Eklentiler:** Proje ayarı eklentileri açar ama indirmez; kurulmamış olanlar yükleme hatası verir ve skill'leri gelmez. Kullanıcıya listeyi göster ve sor: "Proje ayarındaki eklentiler kurulsun mu?" Önce `node .claude/hooks/plugins-sync.mjs` ile eksikleri listele; onay gelirse `node .claude/hooks/plugins-sync.mjs --install` çalıştır. Betik eksikleri proje kapsamında kurar, `false` olanları (paket eklentileri: tasarım, güvenlik, yayın, video) kurup kapatır. Kullanıcıya tek cümleyle söyle: "Paketler kapalı gelir, ilgili komut gerektiğinde açmayı sorar; durum için `/tools`." Sonra kullanıcıdan `/reload-plugins` çalıştırmasını iste. claude CLI yoksa eksik eklentilerin `/plugin install x@y` komutlarını ver ve "Kurup devam edelim mi, eksik skill olmadan mı?" diye sor.
 3. `caveman:caveman` skill'ini yükle (rapor dili).
 4. **Limit:** Limiti oku (`docs/workflow/usage-limits.md` §1) ve raporla. Seçilen derinliğin tahmini maliyetini kalan limitle karşılaştır; adımlar arasında durup sonra devam edilebileceğini söyle. Seviye sarı veya kırmızıysa bunu tek satırla söyle; durdurma.
@@ -88,7 +88,7 @@ Kullanıcıya ne yapılacağını tek cümleyle söyle, sonra çalıştır:
 ```bash
 # template yolu (kökte kit/ var): kit/ kurulumdan sonra silinir
 node kit/kit.mjs install --type <web-saas|mobile|backend> [--addons ai,tr] [--tool claude,codex,antigravity]
-# init yolu (.kit.json → kit): kit klasörüne dokunulmaz; araç init'te seçildiyse --tool gerekmez
+# init yolu (.kit.json → kit; "local" ise .kit.local.json → kit, o dosya yoksa kullanıcıya sor): kit klasörüne dokunulmaz; araç init'te seçildiyse --tool gerekmez
 node <kit>/kit/kit.mjs install --type <web-saas|mobile|backend> [--addons ai,tr] --project .
 # npm yolu (.kit.json → kit = npx:tillerhand@<sürüm>): aynı sürümle. Sürüm tam olarak 1.2.3 biçiminde ve .kit.json → version ile aynı değilse dur, kullanıcıya sor
 npx -y tillerhand@<sürüm> install --type <web-saas|mobile|backend> [--addons ai,tr] --project .

package/.claude/commands/wrap-up.md

@@ -20,6 +20,7 @@ Bu oturumu kapatıyoruz. Bir sonraki oturum (veya `/clear` sonrası) sıfır ba
 7. `node .claude/hooks/cost.mjs` ve `node .claude/hooks/dashboard.mjs` ile `dashboard.html`'i yenile.
 7b. Bu oturumda AI'nın bilmediği için hata yaptığı proje bilgisi çıktıysa `AGENTS.md`'ye eklemeyi öner (onayla; sadece Claude Code'a özelse `/revise-claude-md` ile `CLAUDE.md`'ye). Aynı düzeltmeyi kullanıcı iki kez yaptıysa `/hookify <kural>` ile kalıcı kural öner. Kural `AGENTS.md`'de "Öğrenilen kurallar" bölümüne gider; biçim ve kaynak/tarih satırı `/fix-bug` 8. adımdaki gibi (kaynak: bu oturumdaki olay).
 8. Commit edilmemiş iş varsa commit mesajı öner. Commit'i onayımla at. Testler yeşilse çalışan nokta kaydet: `node .claude/hooks/checkpoint.mjs --save "oturum sonu: <kısa özet>"`.
+8b. **Kişisel tercihler** (AGENTS.md → kural 9, varsa): Bu oturumda kullanıcı bir davranışı düzelttiyse ya da tercih söylediyse, notları AskUserQuestion ile çoklu seçim olarak sor ve seçilenleri `node .claude/hooks/prefs.mjs --add` ile yaz. Not yoksa bu adımı atla, soru sorma.
 9. Faz bittiyse sırayla öner: `/findings-tech` (teknik borç taraması), `/board convene phase-end` (tam kurul, tahmini maliyetiyle birlikte), sonra `/retro`.
 10. Limiti ve bağlamı oku. Kalan 5 saatlik payı, sıfırlanma saatini ve bağlam %50'yi geçtiyse `/clear` önerisini sıradaki adımla birlikte söyle.
 

package/.claude/hooks/destructive-guard.mjs

@@ -205,7 +205,9 @@ export function scopeIssue(command, dir, root) {
   const vk = path.join(os.userInfo().homedir, '.vibe-kit');
   const touchesApproval = (y) => VIBE_KIT.test(y) || !/^\.\.|^$/.test(path.relative(y, vk)) && !path.isAbsolute(path.relative(y, vk));
   for (const h of targets) {
-    if (touchesApproval(h) || touchesApproval(realPath(h))) return { decision: 'ask', reason: `${h}: kapı komut onayı kaydı (kullanıcı klasörü); kabukla değiştirilmez, node .claude/hooks/gate.mjs --approve kullanılır. Kullanıcı onayı gerekli.` };
+    if (touchesApproval(h) || touchesApproval(realPath(h))) return { decision: 'ask', reason: /tercihler\.md$/i.test(h)
+      ? `${h}: kişisel tercih dosyası (kullanıcı klasörü); kabukla değiştirilmez, node .claude/hooks/prefs.mjs --add / --remove kullanılır. Kullanıcı onayı gerekli.`
+      : `${h}: kapı komut onayı kaydı (kullanıcı klasörü); kabukla değiştirilmez, node .claude/hooks/gate.mjs --approve kullanılır. Kullanıcı onayı gerekli.` };
     const rel = relPath(realPath(h), groot);
     const k = protectedRule(rel) ?? protectedRule(`${rel}/`);
     if (k) return { decision: k[0], reason: k[0] === 'deny' ? `${rel}: ${k[2]}`
@@ -253,6 +255,7 @@ const PERMISSION_EQUIVALENT = [
   ['ask', /freeze-guard\.mjs['"]?\s+['"]?--plan-save\b/i, 'Kapsam kalkanının dosya listesi yazılıyor'],
   ['ask', /freeze-guard\.mjs['"]?\s+['"]?--plan-end\b/i, 'Kapsam kalkanı kapatılıyor'],
   ['ask', /commit-gate\.mjs['"]?\s+['"]?--skip\b/i, 'Commit kapısı ve kurul denetimi atlanıyor'],
+  ['ask', /prefs\.mjs['"]?\s+['"]?--(add|remove)\b/i, 'Kişisel tercih dosyası (~/.vibe-kit/tercihler.md) değişiyor'],
   ['ask', /(?<!(?:^|[\s'"=])(?:\.[\\/]|\$\{?CLAUDE_PROJECT_DIR\}?[\\/]?)?\.claude[\\/]?hooks[\\/]?commit-)gate\.mjs['"]?\s+['"]?--approve\b/i, 'Deterministik kapının çalıştıracağı komutlar onaylanıyor'],
   // Shell counterpart of the PROTECTED rule on file tools: a command that names a rule or guard file and writes/deletes is asked
   // (.git: the gate command approval and git hooks live there)

package/.claude/hooks/freeze-guard.mjs

@@ -129,7 +129,9 @@ function hook() {
   const paths = g.files.map(({ path: p }) => realPath(path.resolve(g.dir, p)));
   // Gate command approval record (gate.mjs, in the user folder ~/.vibe-kit/): the AI must not write it by hand
   const approval = paths.find((p) => /[\\/]\.vibe-kit([\\/]|$)/i.test(p));
-  if (approval) decide(g.tool, 'ask', `${approval}: kapı komut onayı kaydı; elle yazılmaz, node .claude/hooks/gate.mjs --approve kullanılır.`);
+  if (approval) decide(g.tool, 'ask', /tercihler\.md$/i.test(approval)
+    ? `${approval}: kişisel tercih dosyası; elle yazılmaz, node .claude/hooks/prefs.mjs --add / --remove kullanılır.`
+    : `${approval}: kapı komut onayı kaydı; elle yazılmaz, node .claude/hooks/gate.mjs --approve kullanılır.`);
   if (g.tool !== 'claude') {
     for (const p of paths) {
       const k = protectedRule(relPath(p, groot));

package/.claude/hooks/gate.mjs

@@ -7,6 +7,7 @@
 //   The result goes to .claude/state/gate.json with the same change signature as the commit gate; the commit gate stops
 //   the commit on a red or stale result. A green check's output is not written, the last 30 lines of a red one are.
 //   If no check passed (commands empty, no Semgrep) the result is EMPTY: the commit gate stays closed.
+//   "Mutlak yol": an added line with this machine's project or home path is red; a generic C:\Users\<name>, /home/<name> is a note.
 //   node .claude/hooks/gate.mjs --approve   saves the commands with user approval. A new or changed command does not run unapproved:
 //   an untrusted repo's AGENTS.md must not run code through the gate. The approval lives in the user folder (~/.vibe-kit/).
 import fs from 'node:fs';
@@ -95,6 +96,55 @@ function semgrep(root, files) {
   return { name, status: 'failed', sec, output: tail(`${r.error ? `${r.error.message}\n` : ''}${r.stdout ?? ''}${r.stderr ?? ''}`) };
 }
 
+// A path that only exists on this machine in a changed line breaks the code, tests and docs on every other machine.
+//   Red: this project's folder or the home folder (at least two levels, so /app or /root alone is not matched; a path
+//   boundary after it; any slash style, JSON-escaped too; case-insensitive only on Windows).
+//   Note only: a generic C:\Users\<name>, /home/<name>/, /Users/<name>/ (a container path like /home/node/app or a route
+//   is not a machine path, so it never blocks).
+// "kit:yol-izinli" on the line or the line above allows a deliberate one (Dockerfile and JSON take no inline comment).
+// Only added lines of tracked files are read (an old path elsewhere in the file is not this change's); a new file is
+// read whole. Paths are read from the git top level, so a project in a monorepo subfolder is checked too.
+const ESCAPE = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+export function absPathCheck(root, files) {
+  const name = 'Mutlak yol';
+  const git = (...a) => spawnSync('git', a, { cwd: root, encoding: 'utf8', maxBuffer: BUFFER });
+  const top = git('rev-parse', '--show-toplevel').stdout?.trim() || root;
+  const variants = (p) => { const f = p.replace(/\\/g, '/').replace(/\/+$/, ''); return [f, f.replace(/\//g, '\\'), f.replace(/\//g, '\\\\')]; };
+  const deep = (p) => p.replace(/\\/g, '/').replace(/^[A-Za-z]:/, '').split('/').filter(Boolean).length >= 2;
+  const own = [...new Set([root, top, os.homedir()].filter((p) => p && deep(p)).flatMap(variants))].map(ESCAPE);
+  const mine = own.length ? new RegExp(`(?:${own.join('|')})(?=[\\\\/'"\`\\s,;:)\\]}]|$)`, process.platform === 'win32' ? 'i' : '') : null;
+  const generic = /\b[A-Za-z]:(?:\\\\|\\|\/)Users(?:\\\\|\\|\/)[^\\/\s'"<>:]+|(?<![\w.-])\/(?:Users|home)\/[^/\s'"<>:]+\//;
+  // Added line numbers per file from one diff against HEAD (staged and unstaged); a file not in it is new: read whole
+  const added = new Map();
+  let file = null;
+  for (const l of (git('diff', 'HEAD', '-U0', '--no-color', '--no-renames', '--no-ext-diff').stdout ?? '').split('\n')) {
+    const f = l.match(/^\+\+\+ b\/(.+)$/);
+    if (f) { file = f[1]; added.set(file, new Set()); continue; }
+    const h = file && l.match(/^@@ -\d+(?:,\d+)? \+(\d+)(?:,(\d+))? @@/);
+    if (h) for (let n = +h[1]; n < +h[1] + +(h[2] ?? 1); n++) added.get(file).add(n);
+  }
+  const red = [], notes = [];
+  for (const f of files) {
+    if (/^\.claude\/state\/|(^|\/)\.kit\.local\.json$/.test(f)) continue;
+    let lines;
+    try {
+      const b = fs.readFileSync(path.join(top, f));
+      if (b.length > 2e6 || b.subarray(0, 8000).includes(0)) continue;
+      lines = b.toString('utf8').split(/\r?\n/);
+    } catch { continue; }
+    lines.forEach((l, i) => {
+      if (added.has(f) && !added.get(f).has(i + 1)) return;
+      if (l.includes('kit:yol-izinli') || lines[i - 1]?.includes('kit:yol-izinli')) return;
+      const at = `${f}:${i + 1}: ${l.trim().slice(0, 120)}`;
+      if (mine?.test(l)) red.push(at); else if (generic.test(l)) notes.push(at);
+    });
+  }
+  const list = (a) => [...a.slice(0, 15), a.length > 15 ? `… ve ${a.length - 15} satır daha` : ''].filter(Boolean).join('\n');
+  if (red.length) return { name, status: 'failed', note: 'bu makineye özel yol; import.meta.url, __dirname, path.join(kök, …), os.tmpdir() kullan. Bilinçliyse satıra ya da üstüne kit:yol-izinli yaz',
+    output: list(red) };
+  return { name, status: 'passed', ...(notes.length && { note: `${notes.length} satırda kullanıcı klasörüne benzeyen yol var; makineye özelse düzelt (engellemez)`, output: list(notes) }) };
+}
+
 export const approvalNeeded = (list) => `komut onayı gerekli\nAGENTS.md → Komutlar yeni veya değişmiş; bu komutlar onaysız çalışmaz:\n${commandList(list)}\n` +
   'Komutları kullanıcıya göster ve sor. Onaylarsa: node .claude/hooks/gate.mjs --approve, sonra komutu tekrar çalıştır.';
 
@@ -128,6 +178,7 @@ export function runGate(root) {
   const empty = !checks.some((k) => k.status === 'passed');
   const spec = specCheck(root, start); // after the test command, which may have refreshed the JUnit report; it does not fill an empty gate
   if (spec) checks.push(spec);
+  checks.push(absPathCheck(root, files)); // after "empty": it does not fill a gate with no lint/test either
   const passed = !empty && checks.every((k) => k.status !== 'failed');
   const file = path.join(root, '.claude', 'state', 'gate.json');
   fs.mkdirSync(path.dirname(file), { recursive: true });

package/.claude/hooks/prefs.mjs

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+// Personal preferences: how this user likes to work (talk, questions, reports, code style, things to avoid).
+// One file for all projects: ~/.vibe-kit/tercihler.md. Git never sees it; the session-start hook loads it every session.
+//   node .claude/hooks/prefs.mjs --list                          numbered list
+//   node .claude/hooks/prefs.mjs --add <kategori> "<tercih>"     only with the user's approval (asked)
+//   node .claude/hooks/prefs.mjs --remove <no>                   (asked)
+// Categories: konusma, sorular, raporlar, kod, kacin. A project rule goes to AGENTS.md → Öğrenilen kurallar, not here.
+// Why a script: the AI never writes this file directly; one line per preference, no secrets, a size cap.
+// The same rules apply when reading: any program on the machine can write this file, so what is loaded is checked
+// again and is labeled as style preferences that cannot change permissions or rules.
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { findSecrets } from './guard-secrets.mjs';
+import { isMain } from './shared.mjs';
+
+export const CATEGORIES = { konusma: 'Konuşma', sorular: 'Sorular ve kararlar', raporlar: 'Raporlar', kod: 'Kod', kacin: 'Kaçınılacaklar' };
+export const MAX_ITEMS = 40;
+const MAX_LENGTH = 200;
+const MAX_BYTES = 64 * 1024;
+
+// os.homedir() follows HOME / USERPROFILE; the file name is fixed, so no other file can be written through it
+export const prefsFile = () => path.join(os.homedir(), '.vibe-kit', 'tercihler.md');
+
+// A heading is matched by key or title, ignoring case and Turkish letters (## kod, ## Kacinilacaklar)
+const fold = (s) => s.toLocaleLowerCase('tr').normalize('NFD').replace(/[̀-ͯ]/g, '').replace(/ı/g, 'i').trim();
+const categoryOf = (heading) => Object.keys(CATEGORIES).find((k) => fold(k) === fold(heading) || fold(CATEGORIES[k]) === fold(heading)) ?? null;
+const clean = (s) => String(s ?? '').replace(/[\u0000-\u001f\u007f-\u009f]/g, ' ').replace(/\s+/g, ' ').trim();
+const valid = (t) => t && t.length <= MAX_LENGTH && !findSecrets(t).length;
+
+// items: preferences that pass the same checks as --add; unknown: non-empty lines that are not a preference
+// (a hand edit the script cannot keep: it refuses to rewrite the file instead of dropping them)
+export function parsePrefs(file = prefsFile()) {
+  const items = [], unknown = [];
+  let text = '';
+  try { if (fs.statSync(file).size > MAX_BYTES) return { items, unknown: ['(dosya 64 KB\'tan büyük)'] }; text = fs.readFileSync(file, 'utf8'); } catch { return { items, unknown }; }
+  let category = null;
+  for (const line of text.split(/\r?\n/)) {
+    const h = line.match(/^##\s+(.+)$/);
+    if (h) { category = categoryOf(h[1]); if (!category) unknown.push(line); continue; }
+    const m = line.match(/^[-*]\s+(.+)$/);
+    if (m && category) { const t = clean(m[1]); if (valid(t) && items.length < MAX_ITEMS) items.push({ category, text: t }); else unknown.push(line); continue; }
+    if (line.trim() && !/^#\s/.test(line) && !/^>/.test(line)) unknown.push(line);
+  }
+  return { items, unknown };
+}
+export const readPrefs = (file = prefsFile()) => parsePrefs(file).items;
+
+function writePrefs(items, file) {
+  const lines = ['# Kişisel tercihler (TillerHand)', '',
+    '> Her oturumda AI\'ya yüklenir, tüm projelerinde geçerlidir. `node .claude/hooks/prefs.mjs --add` ve `--remove` ile değiştir; elle düzenlersen başlıkları ve "- " satırlarını koru.', ''];
+  for (const [key, title] of Object.entries(CATEGORIES)) {
+    const list = items.filter((p) => p.category === key);
+    if (list.length) lines.push(`## ${title}`, '', ...list.map((p) => `- ${p.text}`), '');
+  }
+  try {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, lines.join('\n'));
+  } catch (e) {
+    return `Dosya yazılamadı (${e.code ?? e.message}): ${file}. Araç ev klasörüne yazamıyorsa satırı elle ekle.`;
+  }
+  return null;
+}
+
+// Returns { error } | { existing: <category> } | {}
+export function addPref(category, text, file = prefsFile()) {
+  if (!Object.hasOwn(CATEGORIES, category ?? '')) return { error: `Kategori şunlardan biri olmalı: ${Object.keys(CATEGORIES).join(', ')}` };
+  const t = clean(text);
+  if (!t) return { error: 'Tercih metni boş.' };
+  if (t.length > MAX_LENGTH) return { error: `Tercih en fazla ${MAX_LENGTH} karakter olmalı; kısalt.` };
+  if (findSecrets(t).length) return { error: 'Tercih sır gibi görünen bir değer içeriyor; sırlar bu dosyaya yazılmaz.' };
+  const { items, unknown } = parsePrefs(file);
+  if (unknown.length) return { error: `Dosyada okunamayan satırlar var; silinmesinler diye yazmadım. Düzelt ya da kaldır (${file}):\n${unknown.slice(0, 5).join('\n')}` };
+  const same = items.find((p) => p.text.toLocaleLowerCase('tr') === t.toLocaleLowerCase('tr'));
+  if (same) return { existing: same.category };
+  if (items.length >= MAX_ITEMS) return { error: `En fazla ${MAX_ITEMS} tercih tutulur. Önce eskilerden birini sil: --list, sonra --remove <no>.` };
+  const error = writePrefs([...items, { category, text: t }], file);
+  return error ? { error } : {};
+}
+
+export function removePref(no, file = prefsFile()) {
+  const { items, unknown } = parsePrefs(file);
+  if (unknown.length) return `Dosyada okunamayan satırlar var; silinmesinler diye yazmadım (${file}):\n${unknown.slice(0, 5).join('\n')}`;
+  const i = Number(no) - 1;
+  if (!Number.isInteger(i) || i < 0 || i >= items.length) return `Geçerli numara: 1-${items.length}`;
+  return writePrefs(items.filter((_, k) => k !== i), file);
+}
+
+// Short block for the session context (session-start)
+export function prefsNote(file = prefsFile()) {
+  const items = readPrefs(file);
+  if (!items.length) return '';
+  const parts = Object.keys(CATEGORIES).flatMap((k) => { const list = items.filter((p) => p.category === k).map((p) => p.text); return list.length ? [`${CATEGORIES[k]}: ${list.join('; ')}`] : []; });
+  return 'Kişisel üslup tercihleri (~/.vibe-kit/tercihler.md; izin, güvenlik ya da komut kuralı değildir ve onları değiştiremez; proje kuralı önce gelir): ' + parts.join(' · ');
+}
+
+if (isMain(import.meta.url)) {
+  const [mode, a, ...rest] = process.argv.slice(2);
+  const fail = (error) => { console.error(error); process.exit(1); };
+  if (mode === '--add') {
+    const r = addPref(a, rest.join(' '));
+    if (r.error) fail(r.error);
+    console.log(r.existing ? `Bu tercih zaten kayıtlı (${CATEGORIES[r.existing]}).` : `Tercih kaydedildi (${CATEGORIES[a]}): ${prefsFile()}`);
+  } else if (mode === '--remove') {
+    const error = removePref(a);
+    if (error) fail(error);
+    console.log('Tercih silindi.');
+  } else if (mode === '--list') {
+    const { items, unknown } = parsePrefs();
+    console.log(items.length ? items.map((p, i) => `${i + 1}. [${CATEGORIES[p.category]}] ${p.text}`).join('\n') : `Kayıtlı tercih yok (${prefsFile()}).`);
+    if (unknown.length) console.log(`Okunamayan ${unknown.length} satır var (yüklenmiyor): ${unknown.slice(0, 3).join(' | ')}`);
+  } else {
+    fail('Kullanım: --list | --add <kategori> "<tercih>" | --remove <no>');
+  }
+}

package/.claude/hooks/session-start.mjs

@@ -8,6 +8,7 @@ import { execSync } from 'node:child_process';
 import { readStatus } from './status-read.mjs';
 import { readLimits, summary } from './usage.mjs';
 import { detectTool, findRoot, sessionNote } from './shared.mjs';
+import { prefsNote } from './prefs.mjs';
 
 const notes = [];
 let next = '';
@@ -65,4 +66,7 @@ try {
   // not a git repo, or before the first commit
 }
 
+// The user's preferences from every project (~/.vibe-kit/tercihler.md), short; a broken file must not stop the session
+try { const p = prefsNote(); if (p) notes.push(p.length > 1500 ? `${p.slice(0, 1500)}…` : p); } catch { /* no preferences */ }
+
 if (notes.length) console.log(sessionNote(tool, '[Kit] ' + notes.join('\n[Kit] '), next && `[Kit] ${next}`));

package/.claude/settings.json

@@ -22,7 +22,8 @@
       "Bash(node .claude/hooks/tools.mjs)",
       "Bash(node .claude/hooks/tools.mjs --required:*)",
       "Bash(node .claude/hooks/tools.mjs --measure)",
-      "Bash(node .claude/hooks/tools.mjs --disable:*)"
+      "Bash(node .claude/hooks/tools.mjs --disable:*)",
+      "Bash(node .claude/hooks/prefs.mjs --list)"
     ],
     "ask": [
       "Bash(git push:*)",
@@ -32,6 +33,8 @@
       "Bash(node .claude/hooks/freeze-guard.mjs --plan-save:*)",
       "Bash(node .claude/hooks/freeze-guard.mjs --plan-end)",
       "Bash(node .claude/hooks/commit-gate.mjs --skip:*)",
+      "Bash(node .claude/hooks/prefs.mjs --add:*)",
+      "Bash(node .claude/hooks/prefs.mjs --remove:*)",
       "Bash(node .claude/hooks/gate.mjs --approve)",
       "Edit(./CLAUDE.md)",
       "Edit(./AGENTS.md)",

package/AGENTS.md

@@ -26,6 +26,8 @@ Yapıldı: … · Kurul: … · Otomatik kararlar: …
 Sıradaki: … · bekleyen karar: …
 ```
 
+9. **Kullanıcıyı tanı.** Oturum başında gelen "Kişisel tercihler"e uy (proje kuralı önce gelir). Kullanıcı bir davranışını düzeltirse ya da nasıl çalışmak istediğini söylerse (konuşma, soru sıklığı, rapor biçimi, kod tarzı, kaçınılacaklar) kısaca not al; akışı bölme. Görev sonunda (`/build`) ve oturum sonunda (`/wrap-up`) notları AskUserQuestion ile çoklu seçim olarak sor ("Tercih olarak kaydedeyim mi?"). Seçilenleri `node .claude/hooks/prefs.mjs --add <konusma|sorular|raporlar|kod|kacin> "<tercih>"` ile yaz. Onaysız yazma. Sır, kişisel veri ya da proje adı yazma. Projeye özgü kural bu dosyaya değil "Öğrenilen kurallar"a gider.
+
 <!-- kit:other-tools -->
 ## Codex ve Antigravity'de
 
@@ -81,6 +83,7 @@ build:       [ ]
 - Onay almadan (soru modundan bağımsız): veri silme/sıfırlama, `git push --force`, `git reset --hard`, toplu dosya silme, prod deploy, para harcatan işlem.
 - Testi geçirmek için testi silme veya zayıflatma (test koruması hook'u sorar). Var olmayan API veya paket uydurma.
 - Hook'ları (sır engeli, commit kapısı) atlatmaya çalışma. Kullanıcı adına karar verip sonradan bildirme.
+- Koda, teste veya belgeye bu makineye özel mutlak yol yazma (`C:\Users\<ad>\…`, `/home/<ad>/…`, proje klasörünün tam yolu). Yolu proje kökünden, betiğin konumundan veya geçici klasörden türet; kapı yakalar. Bilinçli bir örnekse satıra `kit:yol-izinli` yaz.
 
 ## Git
 

package/README.en.md

@@ -6,7 +6,7 @@
 </p>
 
 <p align="center">
-  <a href="kit/CHANGELOG.md"><img alt="Version" src="https://img.shields.io/badge/version-3.28.6-2a78d6?style=flat-square"></a>
+  <a href="kit/CHANGELOG.md"><img alt="Version" src="https://img.shields.io/badge/version-3.30.0-2a78d6?style=flat-square"></a>
   <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-2a78d6?style=flat-square"></a>
   <img alt="Claude Code" src="https://img.shields.io/badge/Claude%20Code-ready-d97757?style=flat-square">
   <img alt="Also Codex and Antigravity" src="https://img.shields.io/badge/also-Codex%20%C2%B7%20Antigravity-5b6577?style=flat-square">
@@ -45,6 +45,7 @@
 | **Sourced facts** | Anything that changes (versions, prices, regulations) is checked against a primary source, with link and date. |
 | **Rollback** | `/rollback` returns to the last working state; history is kept, unfinished work is saved. |
 | **Narrator mode** | Optionally explains every change in plain language, as if to someone who doesn't code. |
+| **Learns how you work** | Picks up how you like to work (tone, questions, reports, code style). Preferences you approve apply to all your projects and stay on your computer. |
 
 ## Step by step for beginners
 
@@ -201,7 +202,7 @@ A new file outside the map is asked about, clutter like `*.bak` and `*-old.*` is
 | Package gate | Blocks packages that don't exist (on install and on `npx`, `uvx` runs); asks about very new ones or lookalikes of popular ones |
 | Structure guard | Asks about files outside the map, blocks clutter files |
 | Test guard | Asks before a test is deleted, skipped or weakened |
-| Deterministic gate | No commit until lint, type check, tests and Semgrep have run |
+| Deterministic gate | No commit until lint, type check, tests and Semgrep have run; catches machine-specific paths written into code |
 | Commit gate | No commit without a board review and a green gate |
 | Edit lock | With `/freeze <folder>` on, the AI writes only inside that folder |
 | Scope shield | Asks before writing to a file outside the approved plan |

package/README.md

@@ -6,7 +6,7 @@
 </p>
 
 <p align="center">
-  <a href="kit/CHANGELOG.md"><img alt="Sürüm" src="https://img.shields.io/badge/s%C3%BCr%C3%BCm-3.28.6-2a78d6?style=flat-square"></a>
+  <a href="kit/CHANGELOG.md"><img alt="Sürüm" src="https://img.shields.io/badge/s%C3%BCr%C3%BCm-3.30.0-2a78d6?style=flat-square"></a>
   <a href="LICENSE"><img alt="Lisans: MIT" src="https://img.shields.io/badge/lisans-MIT-2a78d6?style=flat-square"></a>
   <img alt="Claude Code" src="https://img.shields.io/badge/Claude%20Code-haz%C4%B1r-d97757?style=flat-square">
   <img alt="Codex ve Antigravity" src="https://img.shields.io/badge/ayr%C4%B1ca-Codex%20%C2%B7%20Antigravity-5b6577?style=flat-square">
@@ -43,6 +43,7 @@
 | **Doğru kaynak** | Değişebilen bilgi (sürüm, fiyat, mevzuat) birincil kaynaktan, kaynak ve tarihle doğrulanır. |
 | **Geri alma** | `/rollback` son çalışan hale döner; geçmiş silinmez, yarım iş saklanır. |
 | **Anlatıcı mod** | İstersen her değişikliği yazılım bilmeyen birine anlatır gibi sade Türkçe açıklar. |
+| **Seni tanır** | Nasıl çalışmak istediğini (konuşma, soru, rapor, kod tarzı) öğrenir. Onayladığın tercihler tüm projelerinde geçerli olur ve bilgisayarında kalır. |
 
 ## Hiç bilmiyorsan: adım adım
 
@@ -199,7 +200,7 @@ Harita dışı yeni dosya sorulur, `*.bak` ve `*-old.*` gibi dağınıklık dosy
 | Paket kapısı | Var olmayan paketi engeller (kurulumda ve `npx`, `uvx` ile çalıştırmada); çok yeni veya popüler bir pakete benzeyeni sorar |
 | Yapı koruyucu | Harita dışı dosyayı sorar, dağınıklık dosyalarını engeller |
 | Test koruması | Silinen, atlanan veya gevşetilen testi sorar |
-| Deterministik kapı | Lint, tip, test ve Semgrep çalışmadan commit açılmaz |
+| Deterministik kapı | Lint, tip, test ve Semgrep çalışmadan commit açılmaz; koda yazılmış makineye özel yolu yakalar |
 | Commit kapısı | Kurul denetimi ve yeşil kapı olmadan commit atılmaz |
 | Düzenleme kilidi | `/freeze <klasör>` açıkken AI sadece o klasöre yazar |
 | Kapsam kalkanı | Onaylı planın dışındaki dosyaya yazım sorulur |

package/kit/CHANGELOG.md

@@ -3,6 +3,32 @@
 Kit sürümü `kit/VERSION` dosyasında. Bir projeyi güncellemek: projede `/kit-update`.
 "Elle uyarla" notu olan maddeler projeye ait dosyalardadır; güncelleme bunlara dokunmaz.
 
+## [3.30.0] - 2026-10-26
+
+### Yeni
+- **Kişisel tercih hafızası.** Kit nasıl çalışmak istediğini öğrenir: konuşma tarzı, soru sıklığı, rapor biçimi, kod tarzı, kaçınılacaklar.
+  - Bir davranışı düzelttiğinde ya da tercih söylediğinde AI not alır. Görev sonunda (`/build`) ve oturum sonunda (`/wrap-up`) notlar çoklu seçimle "tercih olarak kaydedeyim mi?" diye sorulur. Onaylamadığın hiçbir şey yazılmaz.
+  - Tercihler tek bir dosyada durur: `~/.vibe-kit/tercihler.md`. Tüm projelerinde geçerlidir, her oturum başında yüklenir (Claude Code, Codex, Antigravity), git'e girmez.
+  - Yazma yalnız `node .claude/hooks/prefs.mjs --add <kategori> "<tercih>"` ile yapılır ve her seferinde sorulur. Listeleme: `--list`, silme: `--remove <no>`.
+  - Sır gibi görünen tercih reddedilir. En fazla 40 tercih tutulur. Proje kuralı kişisel tercihten önce gelir; projeye özgü kurallar yine "Öğrenilen kurallar"a gider.
+  - Dosyayı makinedeki herhangi bir program yazabilir. Bu yüzden okurken de aynı denetimler uygulanır: uzun satır, sır ya da kontrol karakteri içeren satır yüklenmez, 64 KB'tan büyük dosya okunmaz. Tercihler oturuma "üslup tercihi" olarak girer; izinleri, güvenlik kurallarını ya da komut kurallarını değiştiremez.
+  - Elle düzenleme desteklenir; başlıklarda büyük/küçük harf ve Türkçe harf farkı önemsenmez. Okunamayan bir satır varsa betik dosyayı yeniden yazmaz, satırı silmemek için durur ve satırı gösterir.
+  - Elle uyarla: AGENTS.md projeye ait. Yeni kural "9. Kullanıcıyı tanı" maddesi; projendeki AGENTS.md'ye eklemek istersen `.kit-new` dosyasından al. İzin satırları `/kit-update` ile eklenir.
+
+## [3.29.0] - 2026-10-26
+
+### Yeni
+- **Deterministik kapıda "Mutlak yol" kontrolü.** Eklenen bir satırda bu makinenin proje klasörünün ya da ev klasörünün tam yolu varsa kapı kırmızı olur; yol düz, ters bölü ya da kaçışlı yazılmış olabilir. Böyle bir yol başka makinede çalışmaz. Kapı satırları listeler ve yolun nasıl türetileceğini söyler.
+  - `C:\Users\<ad>`, `/home/<ad>/` gibi genel kullanıcı klasörü kalıpları yalnız not olarak listelenir, commit'i engellemez. `/home/node/app` gibi konteyner yolları ve `/users/42` gibi route'lar bu yüzden sorun çıkarmaz.
+  - Yalnız eklenen satırlar taranır, yeni dosyalar baştan sona taranır. Git'e girmeyen dosyalara bakılmaz.
+  - Bilinçli bir örnek (belgede örnek yol, test girdisi) satıra ya da bir üst satıra `kit:yol-izinli` yazarak geçer. Üst satır seçeneği Dockerfile ve JSON gibi satır içi yorum alamayan dosyalar içindir.
+- AGENTS.md (Asla) ve üç tipin stack belgesine (Sık yapılan AI hataları) aynı kural eklendi.
+
+### Düzeltilen
+- **Kit, projenin dışındaki yerel bir klondan kurulunca kit klasörünün bu makinedeki tam yolu `.kit.json`'a yazılıyordu.** `.kit.json` commit edildiği için projeyi başka makinede açan kişi var olmayan bir yolu görüyordu. Yol artık git dışı `.kit.local.json` dosyasında; `.kit.json` → `kit` alanı `local` yazar. Eski kayıtlar `/kit-update` sırasında kendiliğinden taşınır. Kayıttaki yol bu makinede yoksa (başka makinede yazılmışsa) taşınmaz, yalnız kaldırılır. `/start` ve `/adopt` dosya yoksa kit klasörünü sorar ya da npm paketini kullanır.
+- Rehberin alt bilgisindeki sürüm numarası eskide kalmıştı. Rehberdeki ve README rozetlerindeki sürüm artık testle denetleniyor.
+  - Elle uyarla: `docs/architecture/stack.md` projeye ait. Yeni madde "Sık yapılan AI hataları" bölümünde; istersen kendi stack belgene ekle. `.gitignore`'a `.kit.local.json` satırı güncellemede eklenir.
+
 ## [3.28.6] - 2026-10-26
 
 ### Düzeltilen

package/kit/VERSION

@@ -1 +1 @@
-3.28.6
+3.30.0

package/kit/guide.html

@@ -287,7 +287,7 @@ footer .container { display: flex; flex-wrap: wrap; gap: 16px; justify-content:
 <section class="hero">
   <div class="container">
     <div>
-      <span class="pill"><b>v3.28.6</b> Claude Code için başlangıç kiti · MIT</span>
+      <span class="pill"><b>v3.30.0</b> Claude Code için başlangıç kiti · MIT</span>
       <h1>Kodu AI yazar.<br><em>Dümen sende.</em></h1>
       <p class="sub">TillerHand, Claude Code ile bir ürünü fikirden canlıya ve bakıma kadar götürür. Her önemli kararda AI sana seçenekleri, önerisini ve her seçeneğin bedelini sunar. Bir uzman kurulu işi denetler, korumalar hatayı daha olmadan durdurur.</p>
       <div class="install"><span id="cmd">npx tillerhand init</span><button class="copy" type="button" data-copy="cmd">Kopyala</button></div>
@@ -764,7 +764,7 @@ node vibe-kit/kit/kit.mjs init
       <tr><td>Yapı koruyucu</td><td>Harita dışı yeni dosya sorulur; <code>*.bak</code>, <code>*-old.*</code>, kopya ve <code>temp/</code> gibi dağınıklıklar engellenir</td></tr>
       <tr><td>Yapılandırma onayı</td><td><code>CLAUDE.md</code>, <code>AGENTS.md</code>, <code>.claude/</code>, <code>.codex/</code>, <code>.mcp.json</code> ve iş akışı dosyaları onayın olmadan değişmez</td></tr>
       <tr><td>Test koruması</td><td>Beklenti silmek veya yoruma almak, <code>.skip</code>/<code>.only</code>, gevşek beklenti, test dosyasını silmek veya taşımak ve test ayarında kapsamı daraltmak sorulur; kabukla test dosyasına yazmak da</td></tr>
-      <tr><td>Deterministik kapı</td><td><code>gate.mjs --run</code>: lint, tip kontrolü, test ve Semgrep çalışır; çıktı kurula girdi olur, kırmızı kontrol RET sayılır. Spec'teki "değişmemesi gereken" davranışların testi yoksa veya kırmızıysa kapı kırmızıdır. Yeni veya değişen komut önce sana gösterilip onaylatılır</td></tr>
+      <tr><td>Deterministik kapı</td><td><code>gate.mjs --run</code>: lint, tip kontrolü, test ve Semgrep çalışır; çıktı kurula girdi olur, kırmızı kontrol RET sayılır. Spec'teki "değişmemesi gereken" davranışların testi yoksa veya kırmızıysa kapı kırmızıdır. Eklenen bir satırda bu makineye özel bir yol (proje klasörünün ya da ev klasörünün tam yolu) varsa da kırmızıdır. Yeni veya değişen komut önce sana gösterilip onaylatılır</td></tr>
       <tr><td>Commit kapısı</td><td>Kurul denetimi ve aynı değişiklikler için yeşil kapı olmadan commit atılmaz; denetimi atlamak (<code>--skip</code>) her seferinde sorulur</td></tr>
       <tr><td>Düzenleme kilidi</td><td><code>/freeze &lt;klasör&gt;</code> açıkken AI sadece o klasöre yazar; kabukla dışarı yazmak sorulur, sembolik bağdan kaçılamaz</td></tr>
       <tr><td>Kapsam kalkanı</td><td><code>/plan-task</code> onayından sonra planın dosya listesi kaydedilir; listede olmayan mevcut dosyaya yazım sorulur. Kalkanı açmak ve kapatmak da sorulur</td></tr>
@@ -893,6 +893,7 @@ Sıradaki: G-013 şifre sıfırlama · bekleyen karar: e-posta servisi</pre>
     <article class="tile"><h3>Doğru kaynak</h3><p class="stack">source-research · Context7 · Firecrawl (isteğe bağlı)</p><ul><li>Önce resmî doküman, mevzuat, standart</li><li>Her iddiaya kaynak, tarih, güven seviyesi (A-D)</li><li>Kütüphane dokümanı Context7'den güncel</li><li>Firecrawl API anahtarı senin ortam değişkeninde kalır</li></ul></article>
     <article class="tile"><h3>Dağıtım kurulumu</h3><p class="stack">/release first · deploy-setup.md</p><ul><li>Hosting, ortam değişkenleri, alan adı ve DNS, yedek, geri alma provası</li><li>Vercel, Supabase, Railway, EAS; adımlar kaynaklı ve tarihli</li><li>Sırrı sen panelde girersin; sohbete ve dosyaya yazılmaz</li></ul></article>
     <article class="tile"><h3>Öğrenen kurallar</h3><p class="stack">/fix-bug · /retro · hookify · AGENTS.md</p><ul><li>Aynı hata sınıfı ikinci kez gelince /fix-bug kural önerir; panoda da uyarı çıkar</li><li>Mekanik kural hookify'a, gerisi AGENTS.md'ye; sen onaylamadan yazılmaz</li><li>Her kuralda kaynak ve tarih; /maintain 90 günden eskileri sorar</li><li>Auto memory /start'ta sorulur, önerilen kapalı</li></ul></article>
+    <article class="tile"><h3>Kişisel tercihler</h3><p class="stack">~/.vibe-kit/tercihler.md · prefs.mjs</p><ul><li>Bir davranışı düzelttiğinde ya da nasıl çalışmak istediğini söylediğinde AI not alır</li><li>Görev ve oturum sonunda "tercih olarak kaydedeyim mi?" diye sorar; onaylamadığın yazılmaz</li><li>Tercihler tüm projelerinde geçerli, her oturumda yüklenir; git'e girmez</li><li>Listele: <code>node .claude/hooks/prefs.mjs --list</code>, sil: <code>--remove &lt;no&gt;</code></li></ul></article>
     <article class="tile"><h3>Türkiye eki</h3><p class="stack">--addons tr · docs/legal/turkiye.md</p><ul><li>KVKK yurt dışı aktarım: standart sözleşme, 5 iş günü bildirim</li><li>e-Fatura ve e-Arşiv eşikleri (GİB)</li><li>iyzico ve PayTR bildirim imzası kodu ve saldırgan testi</li><li>İ/ı ve Türkçe sıralama testleri; hukuki görüş değildir</li></ul></article>
     <article class="tile"><h3>Tarayıcıda QA ve önizleme</h3><p class="stack">/qa · preview.mjs · Playwright CLI</p><ul><li>Arayüz kriterleri gerçek tarayıcıda test olarak koşar</li><li>Rapor test sonucundan yazılır, panoda kart</li><li>/build arayüz görevinde masaüstü ve mobil ekran görüntüsü</li></ul></article>
     <article class="tile"><h3>Spec ve sapma kontrolü</h3><p class="stack">docs/product/specs/ · gate.mjs</p><ul><li>Mevcut, beklenen ve değişmemesi gereken davranış</li><li>"Değişmemesi gereken" satırların testi kapıda denetlenir</li><li>3+ dosyalık işte /plan-task, her hatada /fix-bug yazar</li></ul></article>
@@ -1053,7 +1054,7 @@ Sıradaki: G-013 şifre sıfırlama · bekleyen karar: e-posta servisi</pre>
 <footer>
   <div class="container">
     <a class="brand" href="#top" style="font-size:16px"><svg class="mark" style="width:22px;height:22px"><use href="#mark"/></svg>TillerHand</a>
-    <span>Sürüm 3.26.0 · <a href="https://github.com/burakdogrul/TillerHand">GitHub</a> · <a href="https://github.com/burakdogrul/TillerHand/blob/main/LICENSE">MIT lisansı</a> · KVKK bölümü kontrol listesidir, hukuki görüş değildir.</span>
+    <span>Sürüm 3.30.0 · <a href="https://github.com/burakdogrul/TillerHand">GitHub</a> · <a href="https://github.com/burakdogrul/TillerHand/blob/main/LICENSE">MIT lisansı</a> · KVKK bölümü kontrol listesidir, hukuki görüş değildir.</span>
   </div>
 </footer>
 

package/kit/kit.mjs

@@ -31,7 +31,7 @@ const ADDONS = fs.readdirSync(path.join(TEMPLATES, 'addons'));
 const TOOLS = ['claude', 'codex', 'antigravity'];
 // Root entries that are not part of the common layer (the kit itself, generated and temporary files)
 // CLAUDE.local.md is personal (in .gitignore); it must not be carried into a project installed from a local folder
-const COMMON_EXCLUDE = new Set(['.git', 'kit', 'node_modules', '.kit.json', 'README.md', 'dashboard.html', '.previews', 'sandbox', '.calisma', '.impeccable', 'CLAUDE.local.md', 'LICENSE', 'README.en.md', 'package.json']);
+const COMMON_EXCLUDE = new Set(['.git', 'kit', 'node_modules', '.kit.json', '.kit.local.json', 'README.md', 'dashboard.html', '.previews', 'sandbox', '.calisma', '.impeccable', 'CLAUDE.local.md', 'LICENSE', 'README.en.md', 'package.json']);
 // Files that only make sense in the kit repo and are not carried into projects
 const KIT_ONLY = ['.github/workflows/kit-tests.yml', '.github/workflows/npm-publish.yml'];
 // Run from the npm package (npx tillerhand): the kit lives in the npx cache, which can be cleared, so the record names
@@ -202,6 +202,19 @@ function writeRecord(projectDir, data) {
   fs.writeFileSync(path.join(projectDir, '.kit.json'), JSON.stringify(data, null, 2) + '\n');
 }
 
+// A local kit clone outside the project is a folder on this machine only: its path goes to the git-ignored
+// .kit.local.json and .kit.json says "local", so a clone of the project on another machine never points at this one.
+// Returns the value for .kit.json → kit; an old record with an absolute path is moved the same way on install/update.
+// A path written on another OS (D:\Kit read on Linux) counts too; one that does not exist here is not copied into
+// .kit.local.json: /start and /adopt then ask for the kit folder instead of using another machine's path.
+export function portableKit(projectDir, kit) {
+  if (typeof kit !== 'string' || !(path.win32.isAbsolute(kit) || path.posix.isAbsolute(kit))) return kit;
+  if (!fs.existsSync(kit)) return 'local';
+  fs.writeFileSync(path.join(projectDir, '.kit.local.json'), JSON.stringify({ kit }, null, 2) + '\n');
+  appendLine(path.join(projectDir, '.gitignore'), '.kit.local.json');
+  return 'local';
+}
+
 function validateTools(tools) {
   for (const a of tools) if (!TOOLS.includes(a)) throw new Error(`Geçersiz araç: ${a}. Seçenekler: ${TOOLS.join(', ')}`);
   return tools.length ? tools : ['claude'];
@@ -319,7 +332,7 @@ function init({ project, tool }) {
   installTools(projectDir, tools, files, conflicts);
   const today = new Date().toISOString().slice(0, 10);
   // type: null = kit installed, no type chosen yet (/start step 3 or /adopt)
-  writeRecord(projectDir, { version: VERSION, source: SOURCE, kit: VIA_NPX ? `npx:tillerhand@${VERSION}` : inside ? kitRel : ROOT, type: null, addons: [], tool: tool.length ? tools : null, created: today, updated: today, files });
+  writeRecord(projectDir, { version: VERSION, source: SOURCE, kit: VIA_NPX ? `npx:tillerhand@${VERSION}` : inside ? kitRel : portableKit(projectDir, ROOT), type: null, addons: [], tool: tool.length ? tools : null, created: today, updated: today, files });
 
   console.log(`Kit ${VERSION} kuruldu: ${projectDir} · araç: ${tool.length ? tools.join(', ') : 'seçilmedi (Claude Code dosyaları kuruldu; /start ve /adopt sorar, Codex/Antigravity için --tool)'}`);
   console.log(`Kit klasörü: ${VIA_NPX ? `npm paketi tillerhand@${VERSION}` : inside ? `${kitRel} (.gitignore'a eklendi)` : ROOT} · git deposu: ${git}`);
@@ -347,7 +360,7 @@ function installIntoProject(projectDir, type, addons, tool) {
   for (const p of patches) applyPatch(projectDir, p);
   const tools = tool.length ? validateTools(tool) : (j.tool ?? ['claude']);
   installTools(projectDir, tools, files, conflicts);
-  writeRecord(projectDir, { ...j, version: VERSION, type, addons, tool: tool.length ? tools : (j.tool ?? null), updated: new Date().toISOString().slice(0, 10), files });
+  writeRecord(projectDir, { ...j, kit: portableKit(projectDir, j.kit), version: VERSION, type, addons, tool: tool.length ? tools : (j.tool ?? null), updated: new Date().toISOString().slice(0, 10), files });
   console.log(`Kuruldu: ${type}${addons.length ? ' + ' + addons.join(', ') : ''} (kit ${VERSION}) · ${projectDir}`);
   conflictReport(conflicts);
 }
@@ -442,7 +455,11 @@ function update({ project, addons: newAddons, tool }) {
   const tools = tool.length ? validateTools(tool) : (j.tool ?? ['claude']);
   installTools(project, tools, record, report.conflicts);
 
-  writeRecord(project, { ...j, version: VERSION, addons: allAddons, tool: tool.length ? tools : (j.tool ?? null), updated: new Date().toISOString().slice(0, 10), files: record });
+  const kit = portableKit(project, j.kit);
+  if (kit !== j.kit) console.log(fs.existsSync(path.join(project, '.kit.local.json'))
+    ? 'Kit klasörünün bu makinedeki yolu .kit.json\'dan .kit.local.json\'a taşındı (git dışı).'
+    : '.kit.json\'daki kit klasörü yolu bu makinede yok (başka makinede yazılmış); kaldırıldı. /start ve /adopt kit klasörünü sorar.');
+  writeRecord(project, { ...j, kit, version: VERSION, addons: allAddons, tool: tool.length ? tools : (j.tool ?? null), updated: new Date().toISOString().slice(0, 10), files: record });
 
   console.log(`Kit ${j.version} -> ${VERSION}`);
   const printList = (title, list) => list.length && console.log(`${title} (${list.length}):\n  ${list.join('\n  ')}`);

package/kit/project/gitignore

@@ -18,6 +18,8 @@ CLAUDE.local.md
 
 # Kit güncellemesinden gelen, birleştirilmeyi bekleyen dosyalar
 *.kit-new
+# Kit klasörünün bu makinedeki yolu (yerel kit klonu)
+.kit.local.json
 
 # Loglar
 *.log

package/kit/templates/backend/docs/architecture/stack.md

@@ -122,6 +122,7 @@ uv run pytest --junitxml=test-results/junit.xml
 
 ## Sık yapılan AI hataları (bunlara dikkat)
 
+- Koda, teste veya ayara bu makineye özel mutlak yol yazmak (`C:\Users\<ad>\…`, `/home/<ad>/…`, proje klasörünün tam yolu): başka makinede çalışmaz. Yolu `Path(__file__).parent`, ayardan gelen kök veya testte `tmp_path` ile türet. Deterministik kapı bunu yakalar.
 - Pydantic v1 sözdizimini (`class Config`, `.dict()`) v2 ile karıştırmak.
 - Dış API çağrısında timeout koymamak, hatayı yutmak (`except: pass`).
 - CORS'u `allow_origins=["*"]` ile kimlik bilgisiyle birlikte açmak.

package/kit/templates/mobile/docs/architecture/stack.md

@@ -128,6 +128,7 @@ maestro test .maestro/ --format junit --output test-results/junit-e2e.xml
 
 ## Sık yapılan AI hataları (bunlara dikkat)
 
+- Koda, teste veya ayara bu makineye özel mutlak yol yazmak (`C:\Users\<ad>\…`, `/home/<ad>/…`, proje klasörünün tam yolu): başka makinede çalışmaz. Yolu `import.meta.url` / `__dirname`, `path.join(process.cwd(), …)` veya `os.tmpdir()` ile türet. Deterministik kapı bunu yakalar.
 - Web'e özel API veya paket kullanmak (DOM, `window`, sadece web çalışan kütüphaneler).
 - `npm install` ile SDK ile uyumsuz sürüm kurmak.
 - Token'ı AsyncStorage'a yazmak.

package/kit/templates/web-saas/docs/architecture/stack.md

@@ -134,6 +134,7 @@ npx vitest run --reporter=default --reporter=junit --outputFile.junit=test-resul
 
 ## Sık yapılan AI hataları (bunlara dikkat)
 
+- Koda, teste veya ayara bu makineye özel mutlak yol yazmak (`C:\Users\<ad>\…`, `/home/<ad>/…`, proje klasörünün tam yolu): başka makinede çalışmaz. Yolu `import.meta.url` / `__dirname`, `path.join(process.cwd(), …)` veya `os.tmpdir()` ile türet. Deterministik kapı bunu yakalar.
 - Client component içinde Supabase admin istemcisi veya sır kullanmak.
 - Sayfayı middleware ile koruyup server action'ı korumasız bırakmak.
 - RLS'i "çalışmıyor" diye kapatmak.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tillerhand",
-  "version": "3.28.6",
+  "version": "3.30.0",
   "description": "Claude Code, Codex ve Antigravity için Türkçe vibe coding kiti: kurallar, komutlar, korumalar ve proje şablonları.",
   "license": "MIT",
   "type": "module",