tillerhand 3.28.6 → 3.29.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/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/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/AGENTS.md

@@ -81,6 +81,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.29.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">
@@ -201,7 +201,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.29.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">
@@ -199,7 +199,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,20 @@
 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.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.29.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.29.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>
@@ -1053,7 +1053,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.29.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.29.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",