tillerhand 3.27.1 → 3.28.0

package/.claude/board/rules.md

@@ -44,7 +44,7 @@ Kurulda olmayan bir üyeyi çağırma; ilgili alan kurulda yoksa durum bloğunda
 ## 4. Toplantı nasıl yapılır
 
 1. **Limit kontrolü** (`docs/workflow/usage-limits.md`): Seviye sarıysa üye sayısını yarıya indir; kırmızıysa kullanıcıya sor (kurulu hafiflet seçeneği dahil).
-1b. **Deterministik kapı** (commit, görev sonu, faz sonu; plan toplantısında yok): `node .claude/hooks/gate.mjs --run`. AGENTS.md → Komutlar'daki lint, tip kontrolü ve test ile Semgrep çalışır; sonuç değişiklik imzasıyla saklanır. Kırmızıysa veya boşsa (hiçbir kontrol çalışmadı) commit kapısı açılmaz: önce düzelt ya da Komutlar'ı doldur. Kullanıcı ara commit için açıkça isterse `--approve "atlandı: kullanıcı isteği"`. Kapı "komut onayı gerekli" derse komutları kullanıcıya göster; onaylarsa `node .claude/hooks/gate.mjs --approve` (yeni veya değişen komut onaysız çalışmaz).
+1b. **Deterministik kapı** (commit, görev sonu, faz sonu; plan toplantısında yok): `node .claude/hooks/gate.mjs --run`. AGENTS.md → Komutlar'daki lint, tip kontrolü ve test ile Semgrep çalışır; sonuç değişiklik imzasıyla saklanır. Kırmızıysa veya boşsa (hiçbir kontrol çalışmadı) commit kapısı açılmaz: önce düzelt ya da Komutlar'ı doldur. Kullanıcı ara commit için açıkça isterse `node .claude/hooks/commit-gate.mjs --skip "kullanıcı isteği"` (her zaman onaya sorulur). Kapı "komut onayı gerekli" derse komutları kullanıcıya göster; onaylarsa `node .claude/hooks/gate.mjs --approve` (yeni veya değişen komut onaysız çalışmaz).
 2. **Üyeleri paralel çalıştır** (Agent aracı, her üye ayrı alt ajan). Her üyeye şunları ver: toplantı türü, kapsam (plan metni / diff aralığı / faz), görev kodu, kabul kriterleri ve kapı çıktısı (varsa). Commit toplantısında `model: "haiku"` ver.
 2b. **Konsey toplantısıysa** (§2) `.claude/board/council.md` aşama 1-4'ü uygula. Sentezi başkanın kararından kur; görüş ayrılığı satırına azınlık görüşünü yaz.
 3. **Sentezle** (ana ajan; konseyde başkanın kararına göre):
@@ -62,7 +62,7 @@ Kullanıcıya sorulacaklar: [üyelerin işaretlediği kararlar]
 5. **Kaydet:** `docs/workflow/board.md` → toplantı günlüğüne bir satır ekle. Kararları `docs/decisions/log.md` günlüğüne ekle. Açık kalan bulguları `docs/workflow/progress.md` → "Açık sorunlar"a yaz.
 6. **Commit toplantısı sonucu ONAY veya KOŞULLU ONAY ise** commit kapısını aç: `node .claude/hooks/commit-gate.mjs --approve "<katılan üyeler>"`. RET ise açma; önce kullanıcıya sor.
 
-Kullanıcı commit denetimini o an için atlamak isterse açıkça söylemesi gerekir. O durumda `node .claude/hooks/commit-gate.mjs --approve "atlandı: kullanıcı isteği"` çalıştır ve günlüğe yaz. Kalıcı olarak kapatmak için: `docs/workflow/board.md` → `**Commit denetimi:** kapalı`.
+Kullanıcı commit denetimini o an için atlamak isterse açıkça söylemesi gerekir. O durumda `node .claude/hooks/commit-gate.mjs --skip "kullanıcı isteği"` çalıştır (onaya sorulur) ve günlüğe yaz. Kalıcı olarak kapatmak için: `docs/workflow/board.md` → `**Commit denetimi:** kapalı`.
 
 ## 5. Kurul nasıl kurulur (`/start` Kurul adımı veya `/board setup`)
 

package/.claude/commands/build.md

@@ -31,7 +31,7 @@ Boşsa `docs/workflow/progress.md` → "Sıradaki adım" veya `docs/product/road
 6. Arayüz değiştiyse `impeccable:impeccable` → `critique` çalıştır; önemli bulguları düzeltip düzeltmeyeceğimi sor.
 6b. **Görev sonu kurul toplantısı** (`.claude/board/rules.md`; kurul kurulduysa): Değişikliğe ilgili en fazla 3 üye. RET varsa görev bitmez; bulguyu ve seçenekleri sor. Toplantıyı `docs/workflow/board.md` günlüğüne yaz.
 7. `AGENTS.md` → "Bitti tanımı" listesini tek tek kontrol et.
-8. Kapsam kalkanını kapat: `node .claude/hooks/freeze-guard.mjs --plan-end`. `docs/product/roadmap.md`'de görevi işaretle; PRD'de sadece testi yeşil olan kriterleri işaretle. Testleri JUnit raporuyla çalıştır (`docs/architecture/stack.md` → Kabul testleri) ki pano güncellensin. Limiti tekrar oku ve `docs/workflow/cost-log.md`'ye satır ekle (başlangıç/bitiş 5 saatlik %, süre dk).
+8. Kapsam kalkanını kapat (komut kullanıcıya sorulur): `node .claude/hooks/freeze-guard.mjs --plan-end`. `docs/product/roadmap.md`'de görevi işaretle; PRD'de sadece testi yeşil olan kriterleri işaretle. Testleri JUnit raporuyla çalıştır (`docs/architecture/stack.md` → Kabul testleri) ki pano güncellensin. Limiti tekrar oku ve `docs/workflow/cost-log.md`'ye satır ekle (başlangıç/bitiş 5 saatlik %, süre dk).
 9. Rapor ver:
    - Ne yapıldı (2-3 satır)
    - Bu görevde alınan kararlar (kullanıcı / otomatik)

package/.claude/commands/plan-task.md

@@ -41,4 +41,4 @@ Bu adımda **kod yazma**, sadece plan çıkar.
 
 Planı onaylatmak için AskUserQuestion kullan: "Onayla / Şunu değiştir / Görevi böl". Onayımı bekle. Onaydan sonra `/build` ile uygulanacak.
 
-8. **Onaydan sonra kapsam kalkanını aç:** `node .claude/hooks/freeze-guard.mjs --plan-save <görev kodu> <dosya...>` ("Dokunulacak dosyalar"daki yollar; bütün bir klasör için sonuna `/`). Plan aktifken listede olmayan mevcut dosyaya yazım (dosya aracıyla da, `sed -i`, `mv`, `>` gibi kabuk komutlarıyla da) kullanıcıya sorulur; yeni dosyalar ve `docs/` serbest. Uygularken listede olmayan bir dosya gerekirse kullanıcıya sor, onaylarsa `--plan-add <yol>`.
+8. **Onaydan sonra kapsam kalkanını aç:** `node .claude/hooks/freeze-guard.mjs --plan-save <görev kodu> <dosya...>` ("Dokunulacak dosyalar"daki yollar; bütün bir klasör için sonuna `/`). Komut kullanıcıya sorulur: listeyi görüp onaylar. Plan aktifken listede olmayan mevcut dosyaya yazım (dosya aracıyla da, `sed -i`, `mv`, `>` gibi kabuk komutlarıyla da) kullanıcıya sorulur; yeni dosyalar ve `docs/` serbest. Uygularken listede olmayan bir dosya gerekirse kullanıcıya sor, onaylarsa `--plan-add <yol>`.

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

@@ -2,6 +2,7 @@
 // Commit gate: before every AI `git commit` it requires a light board review and a green deterministic gate (gate.mjs).
 //   PreToolUse (Bash) hook: without review approval it stops the commit with exit code 2 and says what to do.
 //   node .claude/hooks/commit-gate.mjs --approve "<members who took part, or a note>"   binds the approval to the current changes.
+//   node .claude/hooks/commit-gate.mjs --skip "<reason>"   only when the user asks: skips the board and the gate (always asked).
 // Exempt: no board set up, "Commit denetimi: kapalı" in docs/workflow/board.md, or only docs changed.
 // Commits the user makes from their own terminal are not affected (this is a Claude Code hook).
 import fs from 'node:fs';
@@ -63,7 +64,19 @@ function reviewOff() {
   }
 }
 
+// A note starting with "atlandı" skips the board and the gate. --approve refuses it whatever the spelling
+// ($'atland\xc4\xb1', $(printf ...)); only --skip writes it, and --skip is always asked.
+const SKIPPED = /^atlandı/i;
+
 function approve(note) {
+  if (SKIPPED.test(note)) {
+    console.error('"atlandı" notu --approve ile yazılmaz. Kullanıcı açıkça isterse: node .claude/hooks/commit-gate.mjs --skip "<neden>"');
+    process.exit(1);
+  }
+  save(note);
+}
+
+function save(note) {
   const { signature, files } = changes();
   fs.mkdirSync(path.dirname(approvalFile), { recursive: true });
   fs.writeFileSync(approvalFile, JSON.stringify({ signature, note, files, date: new Date().toISOString() }));
@@ -83,25 +96,40 @@ function readApproval() {
   return a && { signature: a.signature, note: a.note };
 }
 
+// This project's own commit-gate.mjs, resolved from the shell's folder ($CLAUDE_PROJECT_DIR, absolute, relative or ./ spelling),
+// is masked so it is not read as the gate approval; any other *gate.mjs (sandbox/.claude/hooks/commit-gate.mjs, a renamed
+// copy of gate.mjs) still is. A cd in the command moves the folder the text cannot follow: then nothing is masked.
+const real = (p) => { try { return fs.realpathSync(p); } catch { return path.resolve(p); } };
+const samePath = (a, b) => (process.platform === 'win32' ? a.toLowerCase() === b.toLowerCase() : a === b);
+export function maskOwnHook(command, dir) {
+  if (/(^|[;&|(]\s*)(cd|pushd|popd|Set-Location|sl|chdir)\b/i.test(command)) return command;
+  const own = real(path.join(root, '.claude', 'hooks', 'commit-gate.mjs'));
+  return command.replace(/"([^"\n]*commit-gate\.mjs)"|'([^'\n]*commit-gate\.mjs)'|([^\s"';&|]*commit-gate\.mjs)\b/gi, (m, a, b, c) => {
+    const p = (a ?? b ?? c).replace(/\$\{?CLAUDE_PROJECT_DIR\}?|%CLAUDE_PROJECT_DIR%|\$env:CLAUDE_PROJECT_DIR/gi, process.env.CLAUDE_PROJECT_DIR || root);
+    return samePath(real(path.resolve(dir, p)), own) ? 'KIT-COMMIT-HOOK' : m;
+  });
+}
+
 function hook() {
-  let command = '';
+  let command = '', dir = root;
   try {
-    command = JSON.parse(fs.readFileSync(0, 'utf8')).tool_input?.command ?? '';
+    const input = JSON.parse(fs.readFileSync(0, 'utf8'));
+    command = input.tool_input?.command ?? '';
+    if (typeof input.cwd === 'string' && input.cwd) dir = input.cwd;
   } catch {
     process.exit(0);
   }
-  // A "atlandı" approval bypasses the gate and the board: the user is asked (the AI must not write it on its own)
+  // --skip bypasses the gate and the board: the user is asked in every spelling (the AI must not write it on its own)
   const open = unquote(command);
-  if (/commit-gate\.mjs\b[^;&|\n]*--approve\s+atlandı/i.test(open)) {
+  if ([command, open].some((c) => /commit-gate\.mjs\b[^;&|\n]*--skip\b/i.test(c))) {
     console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'PreToolUse', permissionDecision: 'ask',
-      permissionDecisionReason: 'Commit kapısı: "atlandı" onayı kurul denetimini ve deterministik kapıyı aşar. Sadece kullanıcı açıkça isterse onayla.' } }));
+      permissionDecisionReason: 'Commit kapısı: --skip kurul denetimini ve deterministik kapıyı aşar. Sadece kullanıcı açıkça isterse onayla.' } }));
     process.exit(0);
   }
   // The gate command approval gives the commands in AGENTS.md permission to run: the user is asked (also covers spellings the permission list misses).
-  // Only the real .claude/hooks/commit-gate.mjs --approve is left out (a copy of gate.mjs named commit-gate.mjs elsewhere
-  // still matches; writing one into .claude/ is itself asked); both the raw and unquoted text are tested (unquote drops
-  // the backslashes of .claude\hooks\gate.mjs, so the separators are optional).
-  if ([command, open].some((c) => /(?<!\.claude[\\/]?hooks[\\/]?commit-)gate\.mjs\b[^;&|\n]*--approve\b/i.test(c))) {
+  // Only this project's commit-gate.mjs --approve is left out (maskOwnHook); both the raw and unquoted text are tested.
+  const masked = maskOwnHook(command, dir);
+  if ([masked, unquote(masked)].some((c) => /gate\.mjs\b[^;&|\n]*--approve\b/i.test(c))) {
     // The prompt reads AGENTS.md now: a chain, an env variable, a node flag or a redirect must not change it after the
     // prompt and get another list approved. Only the exact spelling is accepted.
     if (!/^\s*node\s+(\.\/)?\.claude[\\/]hooks[\\/]gate\.mjs\s+(['"]?)--approve\2\s*$/.test(command)) {
@@ -134,16 +162,16 @@ function hook() {
   const approval = readApproval();
   // The deterministic gate (gate.mjs) must be green for the same changes; not required if the user said "atlandı"
   const gate = readGate();
-  const skipped = /^atlandı/i.test(String(approval?.note ?? ''));
+  const skipped = SKIPPED.test(String(approval?.note ?? ''));
   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;
     process.stderr.write(failed && !failed.length && gate.empty
       ? 'Commit durduruldu: deterministik kapı boş (hiçbir kontrol çalışmadı). AGENTS.md → Komutlar\'ı doldur ve kapıyı tekrar çalıştır.\n' +
-        'Kullanıcı bu commit için açıkça isterse --approve "atlandı: kullanıcı isteği" kullan.\n'
+        'Kullanıcı bu commit için açıkça isterse --skip "kullanıcı isteği" kullan.\n'
       : failed
       ? `Commit durduruldu: deterministik kapı kırmızı (${failed.join(', ') || 'kaldı'}). Düzelt, node .claude/hooks/gate.mjs --run ile tekrar çalıştır, sonra onayla.\n` +
-        'Kullanıcı ara commit (WIP) için açıkça isterse --approve "atlandı: kullanıcı isteği" kullan.\n'
+        'Kullanıcı ara commit (WIP) için açıkça isterse --skip "kullanıcı isteği" kullan.\n'
       : 'Commit durduruldu: bu değişiklikler için deterministik kapı çalışmadı (ya da sonrasında değişiklik oldu). ' +
         'node .claude/hooks/gate.mjs --run çalıştır; kırmızı yoksa kurul onayını yenile ve commit\'i tekrar dene.\n');
     process.exit(2);
@@ -155,13 +183,14 @@ function hook() {
       '1. .claude/board/rules.md §3\'e göre değişen dosyalara ilgili en fazla 2 kurul üyesini model "haiku" ile, sadece diff üzerinde çalıştır.\n' +
       '2. RET yoksa: node .claude/hooks/commit-gate.mjs --approve "<katılan üyeler>" ve commit\'i tekrar dene.\n' +
       '3. RET varsa commit atma; bulguyu ve seçenekleri kullanıcıya sor.\n' +
-      'Kullanıcı bu commit için denetimi açıkça atlamak isterse --approve "atlandı: kullanıcı isteği" kullan.\n'
+      'Kullanıcı bu commit için denetimi açıkça atlamak isterse --skip "kullanıcı isteği" kullan.\n'
   );
   process.exit(2);
 }
 
 if (isMain(import.meta.url)) {
-  const i = process.argv.indexOf('--approve');
+  const i = process.argv.indexOf('--approve'), j = process.argv.indexOf('--skip');
   if (i > -1) approve(process.argv[i + 1] || 'belirtilmedi');
+  else if (j > -1) save(`atlandı: ${process.argv[j + 1] || 'kullanıcı isteği'}`);
   else hook();
 }

package/.claude/hooks/cost.mjs

@@ -4,6 +4,7 @@
 // Run by /dashboard and /wrap-up. Not in the Stop hook: npx downloads the package the first time, it is slow.
 // On a subscription (Pro/Max) this is not a real bill; it is what the work would cost at API prices.
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import { execSync } from 'node:child_process';
 import { ccusageProjectName } from './dashboard-data.mjs';
@@ -12,10 +13,14 @@ const CCUSAGE = 'ccusage@20.0.30'; // pinned version; updating it is a technical
 const root = path.resolve(process.argv[2] ?? process.env.CLAUDE_PROJECT_DIR ?? process.cwd());
 const since = new Date(Date.now() - 30 * 864e5).toISOString().slice(0, 10).replace(/-/g, '');
 
+// Run in a fresh folder of its own: in the project npx would read a repo .npmrc or node_modules/.bin/ccusage (code from the
+// repo), and in a shared /tmp it would walk up to another user's /tmp/node_modules. The empty package.json stops that walk.
+const work = fs.mkdtempSync(path.join(os.tmpdir(), 'kit-cost-'));
 try {
-  // Arguments contain only letters, digits and "-"; on Windows npx.cmd needs a shell
+  fs.writeFileSync(path.join(work, 'package.json'), '{}');
+  // Arguments contain only letters, digits and "-"; on Windows npx.cmd needs a shell.
   const output = execSync(`npx -y ${CCUSAGE} claude daily --json --instances --project ${ccusageProjectName(root)} --since ${since} --offline`,
-    { cwd: root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 120000 });
+    { cwd: work, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 120000 });
   const data = JSON.parse(output);
   fs.mkdirSync(path.join(root, '.claude', 'state'), { recursive: true });
   fs.writeFileSync(path.join(root, '.claude', 'state', 'cost.json'), JSON.stringify({ readAt: new Date().toISOString(), data }));
@@ -23,4 +28,6 @@ try {
   console.log(`Son 30 gün: ${Math.round((t.totalTokens ?? 0) / 1e6)}M token · API karşılığı $${(t.totalCost ?? 0).toFixed(2)}`);
 } catch (h) {
   console.error(`ccusage okunamadı (${h.code ?? h.message}). Node ve ağ erişimi gerekir; pano bu kartı boş gösterir.`);
+} finally {
+  fs.rmSync(work, { recursive: true, force: true });
 }

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

@@ -239,7 +239,8 @@ export function scopeIssue(command, dir, root) {
 
 // Commands denied/asked in Claude Code via .claude/settings.json → permissions. Codex and Antigravity have no such
 // list; this is its counterpart (applied only on those tools, Claude's behavior does not change).
-// Only the real .claude/hooks/commit-gate.mjs --approve is kept out of the gate rule (separators optional: unquote drops backslashes).
+// Only the real .claude/hooks/commit-gate.mjs --approve is kept out of the gate rule (separators optional: unquote drops backslashes;
+// anchored at the start of the path, so sandbox/.claude/hooks/commit-gate.mjs, a renamed gate.mjs, is not exempt).
 const PERMISSION_EQUIVALENT = [
   ['deny', /\brm\b(?=[^;&|]*\s--?[a-z]*r)(?=[^;&|]*\s--?[a-z]*f)/i, 'rm -rf ile toplu silme'],
   ['deny', /\b(Remove-Item|rm|ri|del|erase)\b[^;&|]*\s-Recurse\b|\b(rmdir|rd|del)\s+[^;&|]*\/s\b/i, 'Klasör toplu siliniyor'],
@@ -249,7 +250,10 @@ const PERMISSION_EQUIVALENT = [
   ['ask', /freeze-guard\.mjs['"]?\s+['"]?--off\b/i, 'Düzenleme kilidi kaldırılıyor'],
   ['ask', /tools\.mjs['"]?\s+['"]?--commands\b/i, 'Paylaşılan .claude/settings.json → skillOverrides değişiyor (komut listesi)'],
   ['ask', /freeze-guard\.mjs['"]?\s+['"]?--plan-add\b/i, 'Onaylı planın dosya listesi genişliyor (kapsam kalkanı)'],
-  ['ask', /(?<!\.claude[\\/]?hooks[\\/]?commit-)gate\.mjs['"]?\s+['"]?--approve\b/i, 'Deterministik kapının çalıştıracağı komutlar onaylanıyor'],
+  ['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', /(?<!(?:^|[\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)
   ['ask', /(?=.*((^|[\s'"/\\])\.(claude|codex|agents|git)(?=$|[\s/\\'"])|\bAGENTS\.md|\bCLAUDE\.md))(?=.*(\b(rm|del|erase|rmdir|rd|mv|move|cp|copy|tee|truncate|checkout|restore|Set-Content|Add-Content|Out-File|Remove-Item|Move-Item|Copy-Item)\b|\bsed\s+-i|>|\bnode\s+-e|\bpython\d?\s+-c))/i, 'Kural veya koruma dosyası kabuk komutuyla değiştiriliyor'],
@@ -290,10 +294,21 @@ function obfuscationOne(command) {
     ? { decision: 'ask', reason: 'Komut gizlenmiş görünüyor (satır sonu \\, $\'..\', $(...), `...` veya ${...}) ve korunan bir işlem içeriyor. Kullanıcı onayı gerekli.' } : null;
 }
 
+// A kit guard script (.claude/hooks) run with an indirect spelling: $VAR, $(..), `..`, ${..}, $'..' or a glob * ? (commit-gate.mjs $S,
+// --sk$()ip, commit-*.mjs). The text rules for --skip, --approve and --plan-* cannot see through them: asked (user decision 2026-10-25).
+// Heredocs and single-quoted text are not expanded; $CLAUDE_PROJECT_DIR is the documented way to name the folder.
+export function hookScriptIssue(command) {
+  const k = command.replace(/<<-?\s*(['"]?)(\w+)\1[^\n]*\n[\s\S]*?\n[ \t]*\2[ \t]*(?=\n|$)/g, '').replace(/'[^']*'/g, "''")
+    .replace(/"(?:[^"\\]|\\.)*"/g, (q) => q.replace(/[*?]/g, '')).replace(/\$\{?CLAUDE_PROJECT_DIR\}?|\$env:CLAUDE_PROJECT_DIR/gi, '');
+  if (!/\bnode\b/i.test(k) || !/\.claude|hooks|commit-|gate|freeze/i.test(command)) return null;
+  return /\$\(|`|\$\{|\$'|\$[A-Za-z_]|[*?]/.test(k)
+    ? { decision: 'ask', reason: 'Kitin koruma betiği dolaylı yazımla çalıştırılıyor ($DEĞİŞKEN, $(...), `...`, ${...} veya * ?); kural metni bunun içini göremez. Kullanıcı onayı gerekli.' } : null;
+}
+
 // Separators inside quotes turned into spaces: a quoted & or | ("a & b") must not split a command so its later flags escape the rules
 const blankQuoted = (s) => s.replace(/"(?:[^"\\]|\\.)*"|'[^']*'/g, (q) => q.replace(/[;&|\n]/g, ' '));
 export function evaluate(command) {
-  return strictest(evaluateOne(command), evaluateOne(unquote(command)), evaluateOne(blankQuoted(command)), obfuscationOne(command));
+  return strictest(evaluateOne(command), evaluateOne(unquote(command)), evaluateOne(blankQuoted(command)), obfuscationOne(command), hookScriptIssue(command));
 }
 function evaluateOne(command) {
   const k = command.replace(/\s+/g, ' ');

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

@@ -11,9 +11,9 @@
 // Scope shield (F-06): after /plan-task approval the plan's file list is saved; while a plan is active a write to an
 // EXISTING file not on the list is asked. New files are the structure guard's job; docs/, CHANGELOG.md are free. No plan: silent.
 // State: .claude/state/plan.json → { "task": "G-012", "paths": ["src/a.ts", "src/features/fatura/"] } (ending in /: folder)
-//   node .claude/hooks/freeze-guard.mjs --plan-save <task> <path...>   save when no plan is active (no question)
+//   node .claude/hooks/freeze-guard.mjs --plan-save <task> <path...>   save when no plan is active (asked: the user sees the list)
 //   node .claude/hooks/freeze-guard.mjs --plan-add <path...>           widen the list (with user approval)
-//   node .claude/hooks/freeze-guard.mjs --plan-end                     close when the task is done
+//   node .claude/hooks/freeze-guard.mjs --plan-end                     close when the task is done (asked)
 import fs from 'node:fs';
 import path from 'node:path';
 import { readInput, decide, findRoot, isMain } from './shared.mjs';

package/.claude/hooks/gate.mjs

@@ -133,7 +133,7 @@ export function runGate(root) {
   fs.mkdirSync(path.dirname(file), { recursive: true });
   fs.writeFileSync(file, JSON.stringify({ signature, date: new Date().toISOString(), passed, empty, checks }, null, 2));
   const result = checks.some((k) => k.status === 'failed') ? 'Sonuç: KIRMIZI. Commit kapısı açılmaz: düzelt ve kapıyı tekrar çalıştır.'
-    : empty ? 'Sonuç: BOŞ, hiçbir kontrol çalışmadı. AGENTS.md → Komutlar\'ı doldur; commit kapısı açılmaz (kullanıcı isterse "atlandı").'
+    : empty ? 'Sonuç: BOŞ, hiçbir kontrol çalışmadı. AGENTS.md → Komutlar\'ı doldur; commit kapısı açılmaz (kullanıcı isterse commit-gate.mjs --skip).'
     : 'Sonuç: YEŞİL.';
   return { passed, text: [`## Kapı · ${files.length} dosya değişti`, ...checks.map(line), result].join('\n') };
 }

package/.claude/hooks/notify.mjs

@@ -6,48 +6,59 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { spawn } from 'node:child_process';
+import { isMain } from './shared.mjs';
 
-const root = process.env.CLAUDE_PROJECT_DIR || process.cwd();
 export const THRESHOLD_SEC = 90;
 
-let input = {};
-try { input = JSON.parse(fs.readFileSync(0, 'utf8')); } catch { /* no input */ }
-if (process.env.KIT_NOTIFY === 'off') process.exit(0);
-
-let project = path.basename(root);
-for (const f of ['AGENTS.md', 'CLAUDE.md']) { // in projects before 3.9.0 the name is in CLAUDE.md
-  try { const name = fs.readFileSync(path.join(root, f), 'utf8').match(/^# (.+)$/m)?.[1]; if (name && name !== '[PROJE ADI]') { project = name; break; } } catch { /* */ }
+// Title and message go in env, never into the script text: PowerShell also treats ’ ‘ ‚ ‛ as quotes.
+export function winCommand(title, message) {
+  const script = 'Add-Type -AssemblyName System.Windows.Forms; Add-Type -AssemblyName System.Drawing; ' +
+    '$n = New-Object System.Windows.Forms.NotifyIcon; $n.Icon = [System.Drawing.SystemIcons]::Information; $n.Visible = $true; ' +
+    '$n.ShowBalloonTip(6000, $env:KIT_T, $env:KIT_M, [System.Windows.Forms.ToolTipIcon]::Info); Start-Sleep -Seconds 7; $n.Dispose()';
+  return { args: ['-NoProfile', '-NonInteractive', '-WindowStyle', 'Hidden', '-Command', script], env: { ...process.env, KIT_T: title, KIT_M: message } };
 }
 
-let message;
-if (process.argv.includes('--stop')) {
-  if (input.stop_hook_active) process.exit(0);
-  let startedAt = 0;
-  try { const r = JSON.parse(fs.readFileSync(path.join(root, '.claude', 'state', 'reminder.json'), 'utf8')); startedAt = r.turnAt ?? r.tur ?? 0; } catch { /* */ } // tur: key before 3.15.0
-  const duration = (Date.now() - startedAt) / 1000;
-  if (!startedAt || duration < THRESHOLD_SEC) process.exit(0);
-  message = `İş bitti (${Math.round(duration / 60)} dk). Sonuca bakabilirsin.`;
-} else {
-  message = input.message || 'Claude cevabını bekliyor.';
-}
+if (isMain(import.meta.url)) main();
+
+function main() {
+  const root = process.env.CLAUDE_PROJECT_DIR || process.cwd();
 
-const title = `Claude Code · ${project}`.slice(0, 60);
-message = String(message).replace(/\s+/g, ' ').slice(0, 180);
-const detachedOpts = { detached: true, stdio: 'ignore', windowsHide: true };
-
-try {
-  if (process.platform === 'win32') {
-    const ps = (s) => s.replace(/'/g, "''");
-    const script = `Add-Type -AssemblyName System.Windows.Forms; Add-Type -AssemblyName System.Drawing; ` +
-      `$n = New-Object System.Windows.Forms.NotifyIcon; $n.Icon = [System.Drawing.SystemIcons]::Information; $n.Visible = $true; ` +
-      `$n.ShowBalloonTip(6000, '${ps(title)}', '${ps(message)}', [System.Windows.Forms.ToolTipIcon]::Info); Start-Sleep -Seconds 7; $n.Dispose()`;
-    spawn('powershell', ['-NoProfile', '-NonInteractive', '-WindowStyle', 'Hidden', '-Command', script], detachedOpts).unref();
-  } else if (process.platform === 'darwin') {
-    const as = (s) => s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
-    spawn('osascript', ['-e', `display notification "${as(message)}" with title "${as(title)}"`], detachedOpts).unref();
+  let input = {};
+  try { input = JSON.parse(fs.readFileSync(0, 'utf8')); } catch { /* no input */ }
+  if (process.env.KIT_NOTIFY === 'off') return;
+
+  let project = path.basename(root);
+  for (const f of ['AGENTS.md', 'CLAUDE.md']) { // in projects before 3.9.0 the name is in CLAUDE.md
+    try { const name = fs.readFileSync(path.join(root, f), 'utf8').match(/^# (.+)$/m)?.[1]; if (name && name !== '[PROJE ADI]') { project = name; break; } } catch { /* */ }
+  }
+
+  let message;
+  if (process.argv.includes('--stop')) {
+    if (input.stop_hook_active) process.exit(0);
+    let startedAt = 0;
+    try { const r = JSON.parse(fs.readFileSync(path.join(root, '.claude', 'state', 'reminder.json'), 'utf8')); startedAt = r.turnAt ?? r.tur ?? 0; } catch { /* */ } // tur: key before 3.15.0
+    const duration = (Date.now() - startedAt) / 1000;
+    if (!startedAt || duration < THRESHOLD_SEC) process.exit(0);
+    message = `İş bitti (${Math.round(duration / 60)} dk). Sonuca bakabilirsin.`;
   } else {
-    spawn('notify-send', [title, message], detachedOpts).unref();
+    message = input.message || 'Claude cevabını bekliyor.';
+  }
+
+  const title = `Claude Code · ${project}`.slice(0, 60);
+  message = String(message).replace(/\s+/g, ' ').slice(0, 180);
+  const detachedOpts = { detached: true, stdio: 'ignore', windowsHide: true };
+
+  try {
+    if (process.platform === 'win32') {
+      const { args, env } = winCommand(title, message);
+      spawn('powershell', args, { ...detachedOpts, env }).unref();
+    } else if (process.platform === 'darwin') {
+      const as = (s) => s.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+      spawn('osascript', ['-e', `display notification "${as(message)}" with title "${as(title)}"`], detachedOpts).unref();
+    } else {
+      spawn('notify-send', ['--', title, message], detachedOpts).unref();
+    }
+  } catch {
+    // no notification tool: skip silently
   }
-} catch {
-  // no notification tool: skip silently
 }

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

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
-// Package gate (PreToolUse, Bash): checks a package the AI wants to install before it is installed.
+// Package gate (PreToolUse, Bash): checks a package the AI wants to install, or download and run (npx, uvx …), before it reaches the machine.
 // Why: AIs invent package names that do not exist; attackers register those names (slopsquatting).
 //   Package missing                                                        -> denied (deny)
 //   Very new / few downloads / very close to a popular package / unverified -> the user is asked (ask)
 // The decision goes through Claude Code's permission UI; the AI cannot skip it.
 
+import fs from 'node:fs';
+import path from 'node:path';
 import { readInput, decide, isMain } from './shared.mjs';
 
 export const THRESHOLD = { newDays: 30, npmWeeklyDownloads: 500 };
@@ -26,6 +28,60 @@ const COMMANDS = [
   [/^uv\s+(add|pip\s+install)\b/, 'pypi'], [/^(python3?\s+-m\s+)?pip3?\s+install\b/, 'pypi'], [/^poetry\s+add\b/, 'pypi'],
 ];
 
+// Download-and-run: the first positional is the package (the rest are its arguments), or the values of the package flags.
+// local: the runner uses a bin the project already has before downloading (npx, npm exec, bunx); pnpm/yarn dlx always download.
+// positional: false for uv run (its positional is a script; only --with names packages).
+const EXEC = [
+  { re: /^(npx|npm\s+(exec|x)|bunx|bun\s+x)\b/, eco: 'npm', local: true, positional: true },
+  { re: /^(pnpx|pnpm\s+dlx|yarn\s+dlx)\b/, eco: 'npm', local: false, positional: true },
+  { re: /^(uvx|uv\s+tool\s+run|pipx\s+run)\b/, eco: 'pypi', local: false, positional: true },
+  { re: /^uv\s+run\b/, eco: 'pypi', local: false, positional: false },
+];
+const FLAGS = {
+  npm: { pkg: /^(-p|--package)$/, value: /^(-p|--package|-c|--call|--registry|--prefix|--cache|--userconfig|--globalconfig|-w|--workspace|--node-options|--script-shell|--shell|--loglevel|-C|--dir|--filter)$/ },
+  pypi: { pkg: /^(--from|--spec)$/, value: /^(--from|--spec|--with|--with-requirements|--with-editable|-p|--python|-i|--index|--index-url|--extra-index-url|--default-index|--pip-args|-c|--constraints|--overrides)$/ },
+};
+
+// Returns [{ arg, fromFlag, unsure }]. After an unknown flag its value may be the next word: that word and the one after are
+// both checked, unsure (a missing one is asked, not denied: it may be a file name).
+function execArgs(args, eco, positional) {
+  const named = [], extra = [], out = [];
+  let unknown = false;
+  for (let i = 0; i < args.length; i++) {
+    const [flag, inline] = args[i].split(/=(.*)/s);
+    if (args[i] === '--') { if (positional && args[i + 1]) out.push({ arg: args[i + 1] }); break; }
+    if (FLAGS[eco].value.test(flag)) {
+      const v = inline ?? args[++i] ?? '';
+      if (FLAGS[eco].pkg.test(flag)) named.push({ arg: v, fromFlag: true });
+      else if (flag === '--with') extra.push(...v.split(',').map((arg) => ({ arg, fromFlag: true })));
+      continue;
+    }
+    if (args[i].startsWith('-')) { unknown ||= inline === undefined && /^--?\w/.test(flag) && !/^(-y|--yes|--no|-q|--quiet|-s|--silent|--no-install|--ignore-existing|--offline|-v|--verbose)$/.test(flag); continue; }
+    if (!positional || named.length) break;
+    out.push({ arg: args[i], unsure: unknown });
+    if (unknown && args[i + 1] && !args[i + 1].startsWith('-')) out.push({ arg: args[i + 1], unsure: true });
+    break;
+  }
+  return [...(named.length ? named : out), ...extra];
+}
+
+// What runs a segment: wrappers, VAR=x, a path or .cmd/.exe on the tool, and the manager's own flags before its subcommand are
+// dropped (FOO=1 npx x, cmd /c npx x, bash -c "npx x", /usr/bin/npx x, npx.cmd x, pnpm -C . dlx x, npm --silent exec x).
+const WRAPPER = /^(?:\(|[A-Za-z_]\w*=\S*\s+|(?:sudo|env|time|nohup|exec|command|xargs|corepack|call|start)\s+|(?:bash|sh|zsh|dash|cmd|pwsh|powershell)(?:\.exe)?\s+(?:-c|\/c|\/k|-Command)\s+["']?)/i;
+const SUBCOMMAND = /^(install|i|add|exec|x|dlx|tool|pip|run|global)$/;
+export function normalize(part) {
+  let s = part.trim(), prev;
+  do { prev = s; s = s.replace(WRAPPER, '').trim(); } while (s !== prev);
+  s = s.replace(/^["']?(?:[^\s"']*[\/])?([\w.-]+?)(?:\.cmd|\.exe|\.ps1)?["']?(?=\s|$)/i, '$1');
+  const t = s.split(/\s+/);
+  if (/^(npm|pnpm|yarn|bun|uv)$/.test(t[0])) {
+    let i = 1;
+    while (i < t.length && t[i].startsWith('-')) i += !t[i].includes('=') && t[i + 1] && !t[i + 1].startsWith('-') && !SUBCOMMAND.test(t[i + 1]) ? 2 : 1;
+    s = [t[0], ...t.slice(i)].join(' ');
+  }
+  return s;
+}
+
 function npmName(arg) {
   if (/^(\.|\/|file:|link:|git\+|git:|https?:|github:|workspace:)/.test(arg)) return null;
   if (arg.startsWith('@')) { const i = arg.indexOf('@', 1); return i > 0 ? arg.slice(0, i) : arg; }
@@ -40,12 +96,20 @@ function pypiName(arg) {
 export function findPackages(command) {
   const result = [];
   for (const part of command.split(/&&|\|\||;|\|/)) {
-    const s = part.trim().replace(/^(sudo|env\s+\S+=\S+)\s+/, '');
+    const s = normalize(part);
     const match = COMMANDS.find(([re]) => re.test(s));
-    if (!match) continue;
-    const [re, eco] = match;
+    const exec = match ? null : EXEC.find((e) => e.re.test(s));
+    if (!match && !exec) continue;
+    const re = match?.[0] ?? exec.re, eco = match?.[1] ?? exec.eco;
     // Redirects (2>&1, > log, 2>/dev/null, &> x) are not arguments; a quoted "pkg>=1" has no space before ">" and stays
-    const args = s.replace(re, '').replace(/\s+(\d*|&)(>>?|<)(&\d+|\s*[^\s'"]+)/g, '').trim().split(/\s+/).map((x) => x.replace(/^['"]|['"]$/g, '')).filter(Boolean);
+    const args = s.replace(re, '').replace(/\s+(\d*|&)(>>?|<)(&\d+|\s*[^\s'"]+)/g, '').trim().split(/\s+/).map((x) => x.replace(/^['"(]+|['")]+$/g, '')).filter(Boolean);
+    if (exec) {
+      for (const { arg, fromFlag, unsure } of execArgs(args, eco, exec.positional)) {
+        const name = eco === 'npm' ? npmName(arg) : pypiName(arg);
+        if (name) result.push({ eco, name, exec: true, ...(exec.local && !fromFlag && { local: true }), ...(unsure && { unsure: true }) });
+      }
+      continue;
+    }
     for (let i = 0; i < args.length; i++) {
       const a = args[i];
       if (a.startsWith('-')) {
@@ -114,10 +178,13 @@ export async function check({ eco, name }, get = fetch, now = Date.now()) {
 async function hook() {
   const g = readInput();
   if (!g) process.exit(0);
-  const packages = findPackages(g.command);
+  // npx/bunx run a bin the project already installed without downloading: a local bin (tsc, eas) is not a package name
+  const bin = (name) => /^\w[\w.-]*$/.test(name) && [g.dir, g.root].some((d) => fs.existsSync(path.join(d, 'node_modules', '.bin', name)));
+  // The kit's own package (/start and /adopt run npx -y tillerhand@<version> install): the kit already trusts itself
+  const packages = findPackages(g.command).filter((p) => !(p.local && bin(p.name)) && !(p.eco === 'npm' && p.name === 'tillerhand'));
   if (!packages.length) process.exit(0);
   const results = await Promise.all(packages.map(async (p) => ({ ...p, ...(await check(p)) })));
-  const missing = results.filter((s) => s.status === 'missing');
+  const missing = results.filter((s) => s.status === 'missing' && !s.unsure);
   if (missing.length) {
     decide(g.tool, 'deny', `Paket kapısı: ${missing.map((s) => `${s.name} (${s.detail})`).join(', ')}. Bu ad uydurulmuş olabilir. Doğru paket adını resmi dokümandan bul; kullanıcıya bildir.`);
   }

package/.claude/settings.json

@@ -11,8 +11,6 @@
       "Bash(node .claude/hooks/cost.mjs)",
       "Bash(node .claude/hooks/freeze-guard.mjs --set:*)",
       "Bash(node .claude/hooks/freeze-guard.mjs --status)",
-      "Bash(node .claude/hooks/freeze-guard.mjs --plan-save:*)",
-      "Bash(node .claude/hooks/freeze-guard.mjs --plan-end)",
       "Bash(node .claude/hooks/gate.mjs --run)",
       "Bash(node .claude/hooks/preview.mjs:*)",
       "Bash(node .claude/hooks/checkpoint.mjs --list:*)",
@@ -31,6 +29,9 @@
       "Bash(node .claude/hooks/tools.mjs --enable:*)",
       "Bash(node .claude/hooks/tools.mjs --commands:*)",
       "Bash(node .claude/hooks/freeze-guard.mjs --plan-add:*)",
+      "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/gate.mjs --approve)",
       "Edit(./CLAUDE.md)",
       "Edit(./AGENTS.md)",

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.26.0-2a78d6?style=flat-square"></a>
+  <a href="kit/CHANGELOG.md"><img alt="Version" src="https://img.shields.io/badge/version-3.28.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">
@@ -56,7 +56,7 @@ You don't need to know how to code. Claude handles git, the terminal and install
 
 **2. Create your project**
 1. Make a folder for your project and select it in the **Code** tab of the Claude desktop app.
-2. Type: `clone github.com/burakdogrul/TillerHand into this folder as vibe-kit, then run node vibe-kit/kit/kit.mjs init`.
+2. Type: `run npx tillerhand init in this folder`.
 3. **Start a new session** in the same folder. The kit's commands and guardrails load in the new session.
 
 **3. Start**
@@ -87,14 +87,20 @@ Claude asks its questions one by one. **The first option is always the recommend
 
 ```bash
 mkdir my-app && cd my-app
+npx tillerhand init
+claude
+```
+
+With git instead of npm (the kit stays in a `vibe-kit/` folder inside the project and goes into `.gitignore`):
+
+```bash
 git clone https://github.com/burakdogrul/TillerHand.git vibe-kit
 node vibe-kit/kit/kit.mjs init
-claude
 ```
 
 - On first launch Claude Code offers to install the kit's skill plugins; accept.
 - Kit in another folder: `node <kit>/kit/kit.mjs init --project <project>`.
-- For Codex or Antigravity: `node vibe-kit/kit/kit.mjs init --tool codex` (several: `--tool claude,codex`).
+- For Codex or Antigravity: `npx tillerhand init --tool codex` (several: `--tool claude,codex`).
 - Recommended: a code map ([codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp)). The AI queries the code instead of reading it file by file, which saves tokens. `/start` offers to install it.
 
 ## How it works
@@ -192,7 +198,7 @@ A new file outside the map is asked about, clutter like `*.bak` and `*-old.*` is
 |---|---|
 | Secret guard | Blocks API keys written into code or docs |
 | Destructive-command shield | Blocks `DROP`, unconditional `DELETE`, `db reset`; asks before prod deploys and rollbacks |
-| Package gate | Blocks packages that don't exist; asks about very new ones or lookalikes of popular ones |
+| 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 |

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.26.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.28.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">
@@ -54,7 +54,7 @@ Kod yazmayı bilmen gerekmez. Git, terminal ve kurulum işlerini Claude yapar; s
 
 **2. Projeni oluştur**
 1. Projen için bir klasör aç ve Claude masaüstü uygulamasında **Code** sekmesinde seç.
-2. Şunu yaz: `github.com/burakdogrul/TillerHand reposunu bu klasörün içine vibe-kit adıyla klonla, sonra node vibe-kit/kit/kit.mjs init komutunu çalıştır`.
+2. Şunu yaz: `bu klasörde npx tillerhand init komutunu çalıştır`.
 3. Aynı klasörde **yeni oturum aç**. Kitin komutları ve korumaları yeni oturumda yüklenir.
 
 **3. Başlat**
@@ -85,14 +85,20 @@ Claude sırayla soru sorar. **Her sorunun ilk seçeneği önerilendir**; emin de
 
 ```bash
 mkdir yeni-proje && cd yeni-proje
+npx tillerhand init
+claude
+```
+
+npm yerine git ile (kit, proje içinde `vibe-kit/` klasöründe durur ve `.gitignore`'a girer):
+
+```bash
 git clone https://github.com/burakdogrul/TillerHand.git vibe-kit
 node vibe-kit/kit/kit.mjs init
-claude
 ```
 
 - Açılışta Claude Code, kitin skill eklentilerini kurmayı önerir; kabul et.
 - Kit başka bir klasördeyse: `node <kit>/kit/kit.mjs init --project <proje>`.
-- Codex veya Antigravity için: `node vibe-kit/kit/kit.mjs init --tool codex` (birden fazlası: `--tool claude,codex`).
+- Codex veya Antigravity için: `npx tillerhand init --tool codex` (birden fazlası: `--tool claude,codex`).
 - Önerilen: kod haritası ([codebase-memory-mcp](https://github.com/DeusData/codebase-memory-mcp)). AI kodu dosya dosya okumak yerine sorgular, token tasarrufu sağlar. `/start` kurmayı sorar.
 
 ## Nasıl çalışır
@@ -190,7 +196,7 @@ Harita dışı yeni dosya sorulur, `*.bak` ve `*-old.*` gibi dağınıklık dosy
 |---|---|
 | Sır engeli | Koda veya dokümana yazılan API anahtarını engeller |
 | Yıkıcı komut kalkanı | `DROP`, koşulsuz `DELETE`, `db reset` engellenir; prod deploy ve geri alma sorulur |
-| Paket kapısı | Var olmayan paketi engeller; çok yeni veya popüler bir pakete benzeyeni sorar |
+| 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 |

package/kit/CHANGELOG.md

@@ -3,6 +3,30 @@
 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.28.0] - 2026-10-25
+
+### Değişen
+- **Commit denetimini atlamak artık ayrı bir komut: `commit-gate.mjs --skip "<neden>"`.** Bu komut her seferinde kullanıcıya sorulur. `--approve` "atlandı" ile başlayan notu artık kabul etmiyor. Önceden hook komut metninde "atlandı" kelimesini arıyordu; kelime `$'atland\xc4\xb1'` gibi kaçışlı yazılınca soru çıkmadan kapı ve kurul atlanabiliyordu.
+- **Kapsam kalkanını açmak ve kapatmak (`freeze-guard.mjs --plan-save`, `--plan-end`) artık sorulur.** İkisi de serbestti. AI planı kapatıp listede olmayan dosyalara yazabiliyor ya da planı daha geniş bir listeyle yeniden kaydedebiliyordu. `/kit-update` eski izin satırlarını kaldırıp yenilerini ekler.
+- **Koruma betiği dolaylı yazımla çalıştırılırsa sorulur.** `.claude/hooks` altındaki bir betik `$DEĞİŞKEN`, `$(...)`, ters tırnak, `${...}` ya da `*` `?` ile çağrılırsa (`commit-gate.mjs $S`, `commit-*.mjs`) kurallar komutun içini göremez; bu yüzden kullanıcı onayı istenir. `$CLAUDE_PROJECT_DIR` ve heredoc içindeki commit mesajları bu kurala takılmaz.
+- **Paket kapısı indirip çalıştıran komutlara da bakıyor:** `npx`, `bunx`, `bun x`, `npm exec`, `pnpm dlx`, `yarn dlx`, `uvx`, `uv tool run`, `uv run --with`, `pipx run`. Paket adı uydurmaysa komut engellenir. Çok yeni, az indirilmiş ya da popüler bir pakete benzeyen paket kullanıcıya sorulur. Projede zaten kurulu bir komut (`node_modules/.bin`) `npx`, `npm exec` ve `bunx` ile çalıştırılırken denetlenmez; `dlx` her zaman indirdiği için denetlenir. Kitin kendi paketi (`tillerhand`) denetlenmez.
+- **Paket kapısı önekleri ve sarmalayıcıları da görüyor** (kurulum komutlarında da): `FOO=1 npx`, `cmd /c`, `bash -c`, `time`, `/usr/bin/npx`, `npx.cmd`, `pnpm -C . dlx`, `npm --prefix web install`. Bilinmeyen bir bayraktan sonraki ad kesin paket sayılmaz; kayıt defterinde yoksa engellenmez, sorulur.
+
+### Düzeltilen
+- **Windows'ta masaüstü bildirimi proje adından komut çalıştırabiliyordu.** Proje adı PowerShell betiğinin metnine gömülüyordu ve yalnız düz `'` kaçırılıyordu; PowerShell `’ ‘ ‚ ‛` işaretlerini de tırnak sayar. Başlık ve mesaj artık betiğe ortam değişkeniyle geçiyor.
+- **Biçimlendirme hook'u (web, mobil) Windows'ta boşluklu klasörde çalışmıyordu** ve dosya yolunu kabuğa kaçışsız veriyordu. Prettier artık kabuk olmadan, doğrudan Node ile çalışıyor (Prettier 3).
+- **Maliyet okuma (`cost.mjs`) `npx`'i proje klasöründe çalıştırıyordu.** Bu yüzden depodaki bir `.npmrc` ya da `node_modules/.bin/ccusage` devreye girebiliyordu. Artık her çalışmada açılıp silinen kendi geçici klasöründe çalışıyor.
+- **Commit kapısındaki muafiyet sadece projenin kendi `commit-gate.mjs` dosyası için geçerli.** Yol çözülerek karşılaştırılır: göreli, mutlak ya da `$CLAUDE_PROJECT_DIR` ile yazılan yol muaf kalır. Başka bir klasörde (`sandbox/.claude/hooks/commit-gate.mjs`) bu adla duran bir `gate.mjs` kopyası ise kapı komut onayı sayılır.
+- Linux bildiriminde `-` ile başlayan mesaj seçenek sanılmaz.
+  - Elle uyarla: yok; `/kit-update` hook'ları, kuralları ve izin satırlarını yeniler.
+
+## [3.27.2] - 2026-10-25
+
+### Belgeler
+- **README ve rehberde npm ile kurulum:** `npx tillerhand init` önerilen yol; git klonu seçenek olarak duruyor. Codex/Antigravity için `npx tillerhand init --tool codex`.
+- **Rehber:** Üstteki "Hemen başla" ve "Nasıl çalışır?" düğmeleri kaldırıldı. Kurulum komutları ve terminal blokları (durum bloğu, alt durum çubuğu) dar ekranda yana kaymadan alt satıra iner.
+- Paket Node.js 18 ve üstünü kabul eder (belgedeki gereksinimle aynı).
+
 ## [3.27.1] - 2026-10-25
 
 ### Düzeltilen

package/kit/VERSION

@@ -1 +1 @@
-3.27.1
+3.28.0

package/kit/guide.html

@@ -90,9 +90,9 @@ p { margin: 0 0 1em; }
 .hero h1 { font-size: clamp(40px, 5.6vw, 64px); font-weight: 800; letter-spacing: -.035em; line-height: 1.04; margin-bottom: 22px; }
 .hero h1 em { font-style: normal; color: var(--accent); }
 .hero .sub { font-size: 19px; color: var(--fg-2); max-width: 34em; margin-bottom: 30px; }
-.cta { display: flex; gap: 12px; flex-wrap: wrap; margin-bottom: 30px; }
 .install { display: flex; align-items: center; gap: 10px; max-width: 520px; background: var(--term-bg); color: var(--term-fg); border-radius: 12px; padding: 12px 12px 12px 18px; font: 14px var(--mono); }
-.install span { flex: 1; overflow-x: auto; white-space: nowrap; }
+.install + .install { margin-top: 10px; }
+.install span { flex: 1; min-width: 0; overflow-wrap: anywhere; }
 .install span::before { content: "$ "; color: var(--term-dim); }
 .copy { flex: none; background: rgba(255,255,255,.08); color: var(--term-fg); border: 1px solid rgba(255,255,255,.14); border-radius: 8px; font: 500 12.5px var(--font); padding: 6px 10px; cursor: pointer; }
 .copy:hover { background: rgba(255,255,255,.16); }
@@ -158,7 +158,7 @@ p { margin: 0 0 1em; }
 .moments { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 24px; }
 .moment h3 { font-size: 17px; margin: 18px 0 6px; }
 .moment > p { color: var(--muted); font-size: 15px; margin: 0; }
-.term { background: var(--term-bg); color: var(--term-fg); font: 13px/1.7 var(--mono); padding: 18px 20px; border-radius: 12px; overflow-x: auto; white-space: pre; margin: 0 0 1.2em; }
+.term { background: var(--term-bg); color: var(--term-fg); font: 13px/1.7 var(--mono); padding: 18px 20px; border-radius: 12px; white-space: pre-wrap; overflow-wrap: anywhere; margin: 0 0 1.2em; }
 .term .c { color: var(--term-dim); }
 .term .r { color: #ff8a80; font-weight: 600; }
 .term .g { color: #7ee2a8; }
@@ -287,14 +287,11 @@ footer .container { display: flex; flex-wrap: wrap; gap: 16px; justify-content:
 <section class="hero">
   <div class="container">
     <div>
-      <span class="pill"><b>v3.26.0</b> Claude Code için başlangıç kiti · MIT</span>
+      <span class="pill"><b>v3.28.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="cta">
-        <a class="btn primary" href="#baslangic">Hemen başla</a>
-        <a class="btn ghost" href="#nasil">Nasıl çalışır?</a>
-      </div>
-      <div class="install"><span id="cmd">git clone https://github.com/burakdogrul/TillerHand.git vibe-kit</span><button class="copy" type="button" data-copy="cmd">Kopyala</button></div>
+      <div class="install"><span id="cmd">npx tillerhand init</span><button class="copy" type="button" data-copy="cmd">Kopyala</button></div>
+      <div class="install"><span id="cmd-git">git clone https://github.com/burakdogrul/TillerHand.git vibe-kit</span><button class="copy" type="button" data-copy="cmd-git">Kopyala</button></div>
       <p class="hero-note">Claude Code için yazıldı · Codex ve Antigravity'de de çalışır · Kod bilmen gerekmez</p>
     </div>
     <div class="window" aria-label="Örnek: AI'nın sana sorduğu bir karar sorusu">
@@ -527,11 +524,13 @@ Bekleyen karar: e-posta servisi</pre>
   <h2>Kurulum</h2>
   <p class="lead">TillerHand ve projen ayrı klasörlerde durur. <code>init</code> gereken dosyaları (<code>.claude/</code>, <code>CLAUDE.md</code>, <code>AGENTS.md</code>, <code>docs/</code>) proje klasörüne kopyalar, git deposu açar ve kit klasörüne dokunmaz. Proje tipi kurulumda değil, <code>/start</code> sırasında soruyla seçilir.</p>
   <p><b>Gereksinimler:</b> <a href="https://claude.com/claude-code">Claude Code</a>, Git, Node.js 18+.</p>
-<pre class="term"><span class="c"># 1. Proje klasörü ve içinde kit</span>
+<pre class="term"><span class="c"># 1. Proje klasöründe kiti kur (npm ile, önerilen)</span>
 mkdir yeni-proje &amp;&amp; cd yeni-proje
-git clone https://github.com/burakdogrul/TillerHand.git vibe-kit
-node vibe-kit/kit/kit.mjs init      <span class="c"># vibe-kit/ .gitignore'a girer</span>
+npx tillerhand init
 claude
+<span class="c"># ya da git ile: kit proje içinde vibe-kit/ klasöründe durur (.gitignore'a girer)</span>
+git clone https://github.com/burakdogrul/TillerHand.git vibe-kit
+node vibe-kit/kit/kit.mjs init
 <span class="c"># 2. Claude Code içinde (yeni oturum)</span>
 /start Serbest çalışanlar için fatura ve tahsilat takip uygulaması
 <span class="c"># var olan projede /start yerine:</span>
@@ -549,7 +548,7 @@ claude
   <ol>
     <li><b>Hesaplar (bir kez):</b> <a href="https://github.com">GitHub</a> hesabı (ücretsiz) ve Claude <b>Pro</b> veya <b>Max</b> aboneliği.</li>
     <li><b>Programlar (bir kez):</b> <a href="https://claude.com/download">Claude masaüstü uygulaması</a>, <a href="https://nodejs.org">Node.js</a> (LTS sürümü), <a href="https://git-scm.com/downloads">Git</a>. İstersen <a href="https://desktop.github.com">GitHub Desktop</a> da kurabilirsin.</li>
-    <li><b>Proje:</b> Projen için bir klasör aç ve Claude masaüstü uygulamasında <b>Code</b> sekmesinde seç. Claude'a yaz: "github.com/burakdogrul/TillerHand reposunu bu klasörün içine vibe-kit adıyla klonla, sonra <code>node vibe-kit/kit/kit.mjs init</code> çalıştır".</li>
+    <li><b>Proje:</b> Projen için bir klasör aç ve Claude masaüstü uygulamasında <b>Code</b> sekmesinde seç. Claude'a yaz: "bu klasörde <code>npx tillerhand init</code> komutunu çalıştır".</li>
     <li><b>Aç:</b> Aynı klasörde <b>yeni oturum</b> aç; kitin komutları ve korumaları yeni oturumda yüklenir. Eklentileri kurmayı önerirse kabul et.</li>
     <li><b>Başlat:</b> <code>/start fikrin</code> yaz. <b>Her sorunun ilk seçeneği önerilendir</b>; emin değilsen onu seç. Pro'daysan ilk sorular için öneri: profil <b>Hafif</b>, planlama derinliği <b>Hızlı</b> (5 saatlik limitin ~%25-35'i), pano <b>Evet</b>, anlatıcı mod <b>Evet</b>.</li>
   </ol>
@@ -761,14 +760,14 @@ claude
     <tbody>
       <tr><td>Sır engeli</td><td>Koda veya dokümana yazılan API anahtarını (Anthropic, OpenAI, Stripe, AWS, GitHub, Supabase…) engeller; commit öncesi de tarar</td></tr>
       <tr><td>Yıkıcı komut kalkanı</td><td><code>DROP</code>, <code>TRUNCATE</code>, koşulsuz <code>DELETE</code>, <code>db reset</code> ve prod ortam değişkenlerini makineye çekmek engellenir; prod deploy, geri alma, mağazaya gönderim ve migration sorulur</td></tr>
-      <tr><td>Paket kapısı</td><td>Paket kayıt defterinden doğrulanır: yoksa engellenir; çok yeni, az indirilmiş veya popüler bir pakete benziyorsa sorulur</td></tr>
+      <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 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>Commit kapısı</td><td>Kurul denetimi ve aynı değişiklikler için yeşil kapı olmadan commit atılmaz</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</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>
       <tr><td>Düzenleme turu sayacı</td><td>Aynı kod dosyası bir oturumda 5., 10. kez düzenlenince Semgrep ve güvenlik incelemesi hatırlatılır</td></tr>
       <tr><td>Dev/prod ayrımı</td><td>Yerel ortam ve AI (salt-okunur MCP dahil) sadece dev projesine bağlanır; prod sırları barındırma panelinde kalır</td></tr>
       <tr><td>Güvenlik incelemesi</td><td><code>security-guidance</code>: yazarken riskli kalıp uyarısı (istemcide service_role, kişisel veri logu, innerHTML), commit'te ayrı modelle inceleme</td></tr>
@@ -953,7 +952,7 @@ Sıradaki: G-013 şifre sıfırlama · bekleyen karar: e-posta servisi</pre>
   <p class="path">Başka araçla</p>
   <h2>Codex ve Antigravity</h2>
   <p class="lead">TillerHand Claude Code için yazıldı. Kurallar, komutlar ve korumalar OpenAI Codex ve Google Antigravity'de de çalışır. Kurul tek modelle yürür; soru arayüzü ve durum çubuğu bu araçlarda yok.</p>
-<pre class="term">node vibe-kit/kit/kit.mjs init --tool codex          <span class="c"># ya da antigravity, ya da claude,codex</span>
+<pre class="term">npx tillerhand init --tool codex          <span class="c"># ya da antigravity, ya da claude,codex</span>
 <span class="c"># var olan projeye araç eklemek</span>
 /kit-update --tool claude,codex</pre>
   <div class="table-wrap"><table>

package/kit/kit.mjs

@@ -117,7 +117,9 @@ const OLD_RULES = {
   allow: ['Bash(node .claude/hooks/freeze-guard.mjs --plan-kaydet:*)', 'Bash(node .claude/hooks/freeze-guard.mjs --plan-bitir)',
     'Bash(node .claude/hooks/tools.mjs --gerekli:*)', 'Bash(node .claude/hooks/tools.mjs --olc)', 'Bash(node .claude/hooks/tools.mjs --kapat:*)',
     // 3.19.1: in the project folder the CLI loads a repo's .playwright/cli.config.json (it can run a program); asked, not allowed
-    ...['open', 'snapshot', 'console', 'requests', 'screenshot'].map((c) => `Bash(npx -y @playwright/cli@0.1.22 ${c}:*)`)],
+    ...['open', 'snapshot', 'console', 'requests', 'screenshot'].map((c) => `Bash(npx -y @playwright/cli@0.1.22 ${c}:*)`),
+    // 3.28.0: --plan-end + --plan-save widened or dropped the scope shield unasked; both are asked now
+    'Bash(node .claude/hooks/freeze-guard.mjs --plan-save:*)', 'Bash(node .claude/hooks/freeze-guard.mjs --plan-end)'],
   ask: ['Bash(node .claude/hooks/freeze-guard.mjs --plan-ekle:*)', 'Bash(node .claude/hooks/gate.mjs --onayla)', 'Bash(node .claude/hooks/tools.mjs --ac:*)'],
 };
 

package/kit/templates/mobile/.claude/hooks/format.mjs

@@ -3,7 +3,7 @@
 // If Prettier is not installed in the project it passes silently; it never blocks the work.
 import { readFileSync, existsSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
-import { join, extname } from 'node:path';
+import { join, extname, resolve } from 'node:path';
 
 const EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.json', '.css', '.md']);
 
@@ -11,9 +11,11 @@ try {
   const input = JSON.parse(readFileSync(0, 'utf8'));
   const file = input.tool_input?.file_path;
   const root = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-  const bin = join(root, 'node_modules', '.bin', process.platform === 'win32' ? 'prettier.cmd' : 'prettier');
+  // Prettier 3's own entry run with node: no shell, so a spaced or special-character path is passed as is
+  const bin = join(root, 'node_modules', 'prettier', 'bin', 'prettier.cjs');
   if (file && EXTENSIONS.has(extname(file)) && existsSync(bin)) {
-    spawnSync(bin, ['--write', '--log-level', 'warn', file], { cwd: root, stdio: 'ignore', shell: process.platform === 'win32' });
+    // shortcut: Prettier 3 only (v2 has bin-prettier.js and --loglevel); the kit's stack installs the latest. Absolute path: never read as a flag
+    spawnSync(process.execPath, [bin, '--write', '--log-level', 'warn', resolve(root, file)], { cwd: root, stdio: 'ignore' });
   }
 } catch {
   // a formatting error must not break the edit

package/kit/templates/web-saas/.claude/hooks/format.mjs

@@ -3,7 +3,7 @@
 // If Prettier is not installed in the project it passes silently; it never blocks the work.
 import { readFileSync, existsSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
-import { join, extname } from 'node:path';
+import { join, extname, resolve } from 'node:path';
 
 const EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.json', '.css', '.md']);
 
@@ -11,9 +11,11 @@ try {
   const input = JSON.parse(readFileSync(0, 'utf8'));
   const file = input.tool_input?.file_path;
   const root = process.env.CLAUDE_PROJECT_DIR || process.cwd();
-  const bin = join(root, 'node_modules', '.bin', process.platform === 'win32' ? 'prettier.cmd' : 'prettier');
+  // Prettier 3's own entry run with node: no shell, so a spaced or special-character path is passed as is
+  const bin = join(root, 'node_modules', 'prettier', 'bin', 'prettier.cjs');
   if (file && EXTENSIONS.has(extname(file)) && existsSync(bin)) {
-    spawnSync(bin, ['--write', '--log-level', 'warn', file], { cwd: root, stdio: 'ignore', shell: process.platform === 'win32' });
+    // shortcut: Prettier 3 only (v2 has bin-prettier.js and --loglevel); the kit's stack installs the latest. Absolute path: never read as a flag
+    spawnSync(process.execPath, [bin, '--write', '--log-level', 'warn', resolve(root, file)], { cwd: root, stdio: 'ignore' });
   }
 } catch {
   // a formatting error must not break the edit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tillerhand",
-  "version": "3.27.1",
+  "version": "3.28.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",
@@ -22,7 +22,7 @@
     "CLAUDE.md"
   ],
   "engines": {
-    "node": ">=22"
+    "node": ">=18"
   },
   "repository": {
     "type": "git",