tillerhand 3.42.0 → 3.43.0

package/.claude/agents/test-writer.md

@@ -20,6 +20,7 @@ Uygulama planını, kod rolüne verilen talimatları ve yarım kalmış uygulama
 - Her kabul kriteri için en az bir test; kriter kimliği test adında (`Ö-01.1`). Yetki, ödeme, kişisel veri varsa saldırgan testi (başka kullanıcı, anonim, bozuk girdi).
 - Uç durumlar: boş, sıfır, çok büyük girdi, Türkçe karakter (`I/İ/ı/i`), tarih ve saat dilimi, eşzamanlı istek; kritere uyanları ekle.
 - Beklentiler sıkı olsun: `toBeTruthy`, `toBeDefined`, matcher'sız `expect` gibi gevşek beklenti yazma. `.skip`/`.only` bırakma.
+- Test dosyalarını Write/Edit ile yaz. Bash, betik veya patch ile yazılan test dosyası commit kapısında durur: kapı yalnız senin Write/Edit ile bıraktığın içeriği tanır.
 - Uygulama kodu yazma; yalnız test dosyaları ve test yardımcıları (fixture, sahte veri). Uygulama dosyası gerekiyorsa (boş fonksiyon iskeleti bile) yazma, raporda söyle.
 - Testleri çalıştır ve **kırmızı** olduklarını göster: her testin neden başarısız olduğu (yok, yanlış değer) beklenen sebep olmalı. Sözdizimi veya içe aktarma hatasıyla kırmızı olan test geçerli değildir; düzelt.
 - Kriter belirsizse veya iki şekilde okunabiliyorsa tahmin etme: soruyu ve seçenekleri raporla, testi yazmadan dur.

package/.claude/hooks/commit-gate.mjs

@@ -11,6 +11,8 @@ import crypto from 'node:crypto';
 import { execSync } from 'node:child_process';
 import { findRoot, isMain } from './shared.mjs';
 import { unquote } from './destructive-guard.mjs';
+import { isTestFile, isTestConfig, digest, readRecord } from './test-guard.mjs';
+import { isCodeFile } from './edit-rounds.mjs';
 
 // Project root (the script's location) even when called from a subfolder: approval and gate must not be written elsewhere
 const root = findRoot();
@@ -40,7 +42,7 @@ export function changes() {
     let body = null;
     try { body = fs.readFileSync(path.join(root, f)); } catch { /* deleted */ }
     h.update(body ?? '\0silindi');
-    hashes.set(f, body ? crypto.createHash('sha256').update(body).digest('hex').slice(0, 16) : 'silindi');
+    hashes.set(f, body ? digest(body) : 'silindi');
   }
   for (const f of partial) {
     h.update(`\0index:${f}:${blobs.get(f)}`);
@@ -228,6 +230,19 @@ async function hook() {
   // The deterministic gate (gate.mjs) must be green for the same changes; not required if the user said "atlandı"
   const gate = readGate();
   const skipped = SKIPPED.test(String(approval?.note ?? ''));
+  // Test files only test-writer writes (AGENTS.md rule 7): one changed past the PreToolUse guards stops the commit.
+  // Deleted files are left to the guards that ask before a delete. Only code files: snapshots, images and fixtures are
+  // written by the test runner, not by Write/Edit. A partially staged test (git apply --cached, skip-worktree) commits an
+  // index blob the record does not describe, so it always stops.
+  const written = readRecord(root);
+  const foreign = d.files.filter((f) => isTestFile(f) && isCodeFile(f) && !isTestConfig(f) && d.hashes[f] !== 'silindi' && written[f] !== d.hashes[f]);
+  if (foreign.length && !(skipped && approval.signature === d.signature)) {
+    process.stderr.write(`Commit durduruldu: şu test dosyalarını test-writer yazmadı, yazdıktan sonra değişti ya da kısmen hazırlandı: ${foreign.join(', ')}.\n` +
+      'Test dosyalarına yalnız test-writer ajanı Write/Edit ile yazar (AGENTS.md kural 7); patch, betik, kabuk, git mv veya Codex/Antigravity ile yazılan test sayılmaz.\n' +
+      'Değişiklik gerekiyorsa test-writer\'a dosyayı gözden geçirtip Write/Edit ile yeniden yazdır. Değişikliği kullanıcı kendisi yaptıysa ' +
+      've bu commit için denetimi atlamayı açıkça isterse --skip "kullanıcı isteği" kullan.\n');
+    process.exit(2);
+  }
   if (approval?.signature === d.signature && (skipped || (gate?.signature === d.signature && gate.passed === true))) process.exit(0);
   if (approval?.signature === d.signature) {
     const failed = gate?.signature === d.signature ? gate.checks.filter((k) => k.status === 'failed').map((k) => k.name) : null;

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

@@ -51,7 +51,12 @@ const NEEDS_APPROVAL = [
 // Each part of a command chain is checked alone: "rm -r node_modules && npx vitest run a.test.ts" does not change a test.
 const WRITER = /\b(rm|del|erase|rmdir|rd|unlink|mv|move|cp|copy|tee|truncate|touch|ln|dd|Set-Content|Add-Content|Out-File|Remove-Item|Move-Item|Copy-Item|Clear-Content)\b|\bcurl\b[^;&|]*\s(-o|--output)\b|\bwget\b[^;&|]*\s(-O|--output-document)\b|\bsed\b[^;&|]*\s(-[a-zA-Z]*i\S*|--in-place\b)|\bperl\b[^;&|]*\s-[a-zA-Z]*i|\bgit\s+(checkout|restore|rm|mv)\b/i;
 // Dependency and git internals are not the project's tests; a URL (curl … https://x/tests/a) or a dd input is not a target
-const isTestCode = (t) => !/(^|[/\\])(node_modules|\.git)([/\\]|$)|:\/\/|^if=/i.test(t) && (isTestFile(t) || /(^|[/\\])(tests?|__tests__|e2e|spec)[/\\]?$/i.test(t));
+// Normalized first: node_modules/../tests/a.test.ts is a test path; only a path that stays under them is skipped
+const isTestCode = (t) => {
+  if (/:\/\/|^if=/i.test(t)) return false;
+  const n = path.posix.normalize(t.replace(/\\/g, '/'));
+  return !/(^|\/)(node_modules|\.git)(\/|$)/i.test(n) && (isTestFile(n) || /(^|\/)(tests?|__tests__|e2e|spec)\/?$/i.test(n));
+};
 const isTestPath = (t) => isTestCode(t) || isTestConfig(t);
 function writesTest(command, isPath = isTestPath) {
   return command.split(/&&|\|\||[;|\n]/).some((part) => {

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

@@ -7,8 +7,10 @@
 //   test script) changes a field that could narrow the scope. A commented-out expectation counts as deleted.
 //   It does not block: the user approves a justified change.
 //   In Claude Code a test file can only be written by the test-writer subagent (agent_type); anyone else is denied.
+//   --record (PostToolUse): stores the digest of each test file test-writer wrote; commit-gate.mjs checks it.
 import fs from 'node:fs';
 import path from 'node:path';
+import crypto from 'node:crypto';
 import { readInput, decide, isMain } from './shared.mjs';
 
 const TEST = /(^|\/)(tests?|__tests__|e2e|spec)\/|\.(test|spec|e2e-spec)\.[cm]?[jt]sx?$|(^|\/)test_[^/]*\.py$|_test\.(py|go)$/i;
@@ -48,6 +50,14 @@ export function configRisk(before, after) {
   return changed.some((s) => RISKY.test(s)) ? 'testlerin kapsamını belirleyen ayar değişiyor (include/exclude, testMatch, passWithNoTests, eşik, test script\'i)' : null;
 }
 
+// The real path too: a link or junction into the test folder, a Windows short name (TESTS~1)
+// A new nested path (lnk/new/sub/x.ts): resolve the nearest folder that exists and append the rest
+const realOf = (p) => {
+  for (let dir = p, rest = ''; ; rest = path.join(path.basename(dir), rest), dir = path.dirname(dir)) {
+    try { return path.join(fs.realpathSync.native(dir), rest); } catch { if (path.dirname(dir) === dir) return p; }
+  }
+};
+
 function hook() {
   const g = readInput();
   if (!g) process.exit(0);
@@ -56,11 +66,6 @@ function hook() {
     const rel = path.relative(g.root, full);
     return [full, rel.startsWith('..') || path.isAbsolute(rel) ? full : rel];
   };
-  // The real path too: a link or junction into the test folder, a Windows short name (TESTS~1)
-  const realOf = (p) => {
-    try { return fs.realpathSync.native(p); } catch { /* a new file */ }
-    try { return path.join(fs.realpathSync.native(path.dirname(p)), path.basename(p)); } catch { return p; }
-  };
   for (const f of g.files) {
     if (!f.path) continue;
     const [full, name] = resolveName(f.path);
@@ -91,4 +96,42 @@ function hook() {
   process.exit(0);
 }
 
-if (isMain(import.meta.url)) hook();
+// What test-writer wrote: the commit gate stops a changed test file whose content on disk is not one of these
+// (git apply, patch or a script writes past the PreToolUse guards). State: .claude/state/test-writer.json → { files: { path: digest } }
+export const digest = (buf) => crypto.createHash('sha256').update(buf).digest('hex').slice(0, 16);
+export const recordPath = (root) => path.join(root, '.claude', 'state', 'test-writer.json');
+export function readRecord(root) {
+  try {
+    const d = JSON.parse(fs.readFileSync(recordPath(root), 'utf8'));
+    return d?.files && typeof d.files === 'object' && !Array.isArray(d.files) ? d.files : {};
+  } catch { return {}; }
+}
+
+// PostToolUse: the file is on disk now, so its digest is what test-writer left
+function record() {
+  const g = readInput();
+  if (!g || g.tool !== 'claude' || g.agent !== 'test-writer') process.exit(0);
+  const files = readRecord(g.root);
+  const rootReal = realOf(g.root);
+  for (const f of g.files) {
+    if (!f.path) continue;
+    const full = path.resolve(g.dir, f.path);
+    let body;
+    try { body = fs.readFileSync(full); } catch { continue; }
+    // The written path and its real path (a link into the test folder): git lists the one it tracks
+    for (const rel of [path.relative(g.root, full), path.relative(rootReal, realOf(full))]) {
+      const key = rel.split(path.sep).join('/');
+      if (!key.startsWith('..') && !path.isAbsolute(rel) && isTestFile(key) && !isTestConfig(key)) files[key] = digest(body);
+    }
+  }
+  // Temp file + rename: a reader never sees half a JSON (it would read {} and drop every record)
+  const tmp = `${recordPath(g.root)}.${process.pid}.tmp`;
+  try {
+    fs.mkdirSync(path.dirname(tmp), { recursive: true });
+    fs.writeFileSync(tmp, JSON.stringify({ files }, null, 2));
+    fs.renameSync(tmp, recordPath(g.root));
+  } catch { fs.rmSync(tmp, { force: true }); /* the commit gate then asks for test-writer again */ }
+  process.exit(0);
+}
+
+if (isMain(import.meta.url)) (process.argv.includes('--record') ? record : hook)();

package/.claude/settings.json

@@ -133,6 +133,10 @@
           {
             "type": "command",
             "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/edit-rounds.mjs\""
+          },
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/test-guard.mjs\" --record"
           }
         ]
       }

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.42.0-2a78d6?style=flat-square"></a>
+  <a href="kit/CHANGELOG.md"><img alt="Version" src="https://img.shields.io/badge/version-3.43.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">

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.42.0-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.43.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">

package/kit/CHANGELOG.md

@@ -3,6 +3,16 @@
 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.43.0] - 2026-10-27
+
+### Eklenen
+- **Commit kapısı test dosyasının kaynağını denetler.** `test-writer` bir test dosyasını Write/Edit ile yazınca içeriğin özeti kaydedilir (`.claude/state/test-writer.json`). Commit'e giren bir test dosyası bu kayıtla eşleşmiyorsa commit durur: `git apply`, `patch`, bir betik ya da kabukla yazılan test artık kurul onayıyla da geçmez. Değişikliği kullanıcı kendisi yaptıysa o commit için `--skip` kullanılır. Kısmen hazırlanmış bir test dosyası (`git apply --cached`, `skip-worktree`) her zaman durur. Test klasöründeki kod olmayan dosyalar (snapshot, görsel, fixture) denetlenmez; silinen test dosyaları için silmeden önce soran korumalar geçerli. Yalnız Claude Code'da (ajan kimliği orada var).
+
+## [3.42.1] - 2026-10-27
+
+### Düzeltilen
+- **Test ayrımında iki yol kaçağı kapandı.** `node_modules/../tests/a.test.ts` gibi `..` içeren yollar artık normalleştirilip test yolu sayılıyor; test klasörüne giden bir bağın altında henüz var olmayan iç içe bir yola yazım da yakalanıyor.
+
 ## [3.42.0] - 2026-10-27
 
 ### Eklenen

package/kit/VERSION

@@ -1 +1 @@
-3.42.0
+3.43.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.42.0</b> Claude Code için başlangıç kiti · MIT</span>
+      <span class="pill"><b>v3.43.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>
@@ -776,7 +776,7 @@ node vibe-kit/kit/kit.mjs init</pre>
       <tr><td>Paket kapısı</td><td>Kurulan ya da <code>npx</code>, <code>uvx</code> ile indirilip çalıştırılan paket kayıt defterinden doğrulanır: yoksa engellenir; çok yeni, az indirilmiş veya popüler bir pakete benziyorsa sorulur</td></tr>
       <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 ayrımı</td><td>Testleri kodu yazan değil, ayrı bir ajan (<code>test-writer</code>, farklı model önerilir) koddan önce yazar. Test dosyasına bu ajan dışında kimse yazamaz: ana oturum ve kod ajanı denerse engellenir. Böylece kodu yazan testi kendi koduna göre şekillendiremez</td></tr>
+      <tr><td>Test ayrımı</td><td>Testleri kodu yazan değil, ayrı bir ajan (<code>test-writer</code>, farklı model önerilir) koddan önce yazar. Test dosyasına bu ajan dışında kimse yazamaz: ana oturum ve kod ajanı denerse engellenir. Patch veya betikle dolaylı değişen test dosyası da commit kapısında durur. Böylece kodu yazan testi kendi koduna göre şekillendiremez</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. 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; görev sonu onayı commit için de geçerli, aynı değişiklik iki kez denetlenmez; denetimi atlamak (<code>--skip</code>) her seferinde sorulur</td></tr>
@@ -1070,7 +1070,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.42.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.43.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tillerhand",
-  "version": "3.42.0",
+  "version": "3.43.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",