tillerhand 3.34.0 → 3.35.0

package/.claude/commands/build.md

@@ -34,7 +34,9 @@ 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). Bu, değişikliğin tek tam denetimidir: değişikliğe ilgili, akışın (2a) söylediği sayıda üye (en fazla 3) + `code-reviewer` (değişiklik auth, ödeme, kişisel veri gibi hassas bir yola dokunuyorsa `security-auditor` da), inceleme rolünün `model` ve `effort`'uyla. RET varsa görev bitmez; bulguyu ve seçenekleri sor. ONAY veya KOŞULLU ONAY ise ve kapı (adım 4) yeşilse `node .claude/hooks/commit-gate.mjs --approve "görev sonu: <katılanlar>"`: commit aynı değişiklikler için kurulu yeniden toplamaz, sonradan değişen dosyalar varsa yalnız onlar incelenir. Toplantıyı `docs/workflow/board.md` günlüğüne yaz. Kurul kurulmadıysa adım 9'da `/review-changes` öner.
 7. `AGENTS.md` → "Bitti tanımı" listesini tek tek kontrol et.
-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). Roadmap, cost-log ve progress yazımını akış "Doküman: alt ajan" diyorsa tek alt ajan çağrısıyla doküman rolüne ver (`model`, `effort`), "ana oturum" diyorsa kendin yaz; sonucu kontrol et (progress.md'nin kalın etiketli satırları durum çubuğu ve pano için aynı biçimde kalmalı).
+8. Kapsam kalkanını kapat (komut kullanıcıya sorulur): `node .claude/hooks/freeze-guard.mjs --plan-end`. 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. Roadmap, maliyet günlüğü ve progress yazımı mekaniktir, model çağrısı harcama; tek komutla yaz:
+   `node .claude/hooks/progress.mjs --done <görev kodu> --cost "<görev kodu> <kısa ad>" <K|O|B> <başlangıç 5s %> <bitiş 5s %> <süre dk> --task "-" --did "<görev kodu>: <tek satır ne yapıldı>" --next "<sıradaki görev>" --check`
+   `--check` progress.md'nin kalın etiketli satırlarını (durum çubuğu ve pano okur) denetler; bozuksa düzelt. Açık sorunlar ve bekleyen kararlar gibi düz metin bölümlerini gerekirse elle yaz.
 9. Rapor ver:
    - Ne yapıldı (2-3 satır)
    - Bu görevde alınan kararlar (kullanıcı / otomatik)

package/.claude/hooks/flow.mjs

@@ -27,7 +27,7 @@ export function flowText(f) {
   return [
     `Akış: ${f.files} dosya · ${f.size} · bağlam ${f.context == null ? 'bilinmiyor' : `%${f.context}`} · limit ${LEVEL_LABEL[f.level]}`,
     `Kod: ${where(f.code)}${f.code === 'ana' ? '' : ' (kod rolü)'}`,
-    `Doküman (roadmap, progress, cost-log): ${where(f.docs)}${f.docs === 'ana' ? '' : ' (doküman rolü)'}`,
+    `Doküman işi (roadmap, progress, maliyet günlüğü progress.mjs ile; bu satır diğerleri için): ${where(f.docs)}${f.docs === 'ana' ? '' : ' (doküman rolü)'}`,
     `Kurul: ${f.members} üye + code-reviewer, ${f.parallel ? 'paralel' : 'sırayla'} (hassas yolda + security-auditor)`,
     ...(f.clear ? [`Önce /clear öner: bağlam %${f.context}, her tur bunu yeniden okur.`] : []),
   ].join('\n');

package/.claude/hooks/progress.mjs

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+// Mechanical doc writes at task end, by script instead of a model call (0 tokens, the format cannot drift).
+//   node .claude/hooks/progress.mjs --done G-012                     roadmap: [ ] → [x]
+//   node .claude/hooks/progress.mjs --cost "<iş>" <K|O|B|BOARD|DESIGN|FINDINGS> <başlangıç %> <bitiş %> <dk> ["<not>"]
+//   node .claude/hooks/progress.mjs --task "<aktif görev>" --did "<yapılan>" --next "<sıradaki adım>"
+//   node .claude/hooks/progress.mjs --check                          progress.md labels the status line and dashboard read
+// Every progress write also sets **Son güncelleme:** to today. Flags can be combined in one call.
+import fs from 'node:fs';
+import path from 'node:path';
+import { findRoot, isMain } from './shared.mjs';
+import { clean, labels } from './status-read.mjs';
+
+const LABELS = ['Son güncelleme', 'Aktif faz', 'Aktif görev', 'Başlangıç adımı', 'Soru modu', 'Profil'];
+const SIZES = ['K', 'O', 'B', 'BOARD', 'DESIGN', 'FINDINGS'];
+const USAGE = 'Kullanım: node .claude/hooks/progress.mjs [--done G-NNN] [--cost "<iş>" <K|O|B|BOARD|DESIGN|FINDINGS> <başlangıç %> <bitiş %> <dk> ["<not>"]] [--task "<metin>"] [--did "<metin>"] [--next "<metin>"] [--check]';
+// One line per value: a newline would break a label, a list item or a table row
+const line = (s) => clean(String(s).replace(/\s*\r?\n\s*/g, ' ')).trim();
+const today = () => new Date().toLocaleDateString('sv-SE');
+const setLabel = (text, k, v) => text.replace(new RegExp(`^(\\*\\*${k}:\\*\\*).*$`, 'm'), `$1 ${v}`);
+const setSection = (text, title, body) => text.replace(new RegExp(`^(## ${title}[^\\n]*\\n)[\\s\\S]*?(?=^## |(?![\\s\\S]))`, 'm'), `$1\n${body}\n\n`);
+const section = (text, title) => text.match(new RegExp(`^## ${title}[^\\n]*\\n([\\s\\S]*?)(?=^## |(?![\\s\\S]))`, 'm'))?.[1] ?? '';
+
+export function markDone(text, id) {
+  const re = new RegExp(`^(\\s*- )\\[( |x)\\](\\s*${id}:)`, 'mi');
+  const m = text.match(re);
+  if (!m) return { error: `${id} yol haritasında yok.` };
+  if (m[2].toLowerCase() === 'x') return { text, note: `${id} zaten işaretli.` };
+  return { text: text.replace(re, '$1[x]$3'), note: `${id} işaretlendi.` };
+}
+
+export function costRow(args, date = today()) {
+  const [job, size, start, end, min, note = ''] = args;
+  const nums = [start, end, min].map(Number);
+  if (!job || !SIZES.includes(size) || nums.some((n) => !Number.isFinite(n) || n < 0) || args.length > 6) return null;
+  // The end below the start means the 5-hour window renewed in between: the difference is unknown
+  const diff = nums[1] >= nums[0] ? nums[1] - nums[0] : '?';
+  const cell = (s) => line(s).replace(/\|/g, '\\|');
+  return `| ${date} | ${cell(job)} | ${size} | ${nums[0]} | ${nums[1]} | ${diff} | ${nums[2]} | ${cell(note)} |`;
+}
+
+export function updateProgress(text, { task, did, next }) {
+  let t = setLabel(text, 'Son güncelleme', today());
+  if (task != null) t = setLabel(t, 'Aktif görev', line(task));
+  if (did != null) {
+    const items = section(t, 'Son oturumda yapılanlar').split('\n').map((s) => s.trim()).filter((s) => /^- \S/.test(s));
+    t = setSection(t, 'Son oturumda yapılanlar', [...items, `- ${line(did)}`].join('\n'));
+  }
+  if (next != null) t = setSection(t, 'Sıradaki adım', `1. ${line(next)}`);
+  return t;
+}
+
+export const missingLabels = (text) => LABELS.filter((k) => !(k in labels(text)));
+
+if (isMain(import.meta.url)) {
+  const root = findRoot();
+  const file = (rel) => path.join(root, rel);
+  const argv = process.argv.slice(2);
+  const fail = (msg) => { console.error(msg); process.exit(1); };
+  const value = (flag) => { const i = argv.indexOf(flag); return i < 0 ? undefined : argv[i + 1] ?? fail(USAGE); };
+  if (!argv.length) fail(USAGE);
+  let code = 0;
+
+  const done = value('--done');
+  if (done != null) {
+    if (!/^G-\d+$/i.test(done)) fail(USAGE);
+    const r = markDone(fs.readFileSync(file('docs/product/roadmap.md'), 'utf8'), done.toUpperCase());
+    if (r.error) fail(r.error);
+    fs.writeFileSync(file('docs/product/roadmap.md'), r.text);
+    console.log(r.note);
+  }
+
+  const c = argv.indexOf('--cost');
+  if (c > -1) {
+    const args = [];
+    for (let i = c + 1; i < argv.length && !argv[i].startsWith('--'); i++) args.push(argv[i]);
+    const row = costRow(args) ?? fail(USAGE);
+    const log = file('docs/workflow/cost-log.md');
+    fs.writeFileSync(log, `${fs.readFileSync(log, 'utf8').trimEnd()}\n${row}\n`);
+    console.log(`Maliyet satırı eklendi: ${row}`);
+  }
+
+  const [task, did, next] = ['--task', '--did', '--next'].map(value);
+  if ([task, did, next].some((v) => v != null)) {
+    fs.writeFileSync(file('docs/workflow/progress.md'), updateProgress(fs.readFileSync(file('docs/workflow/progress.md'), 'utf8'), { task, did, next }));
+    console.log('progress.md güncellendi.');
+  }
+
+  if (argv.includes('--check')) {
+    const missing = missingLabels(fs.readFileSync(file('docs/workflow/progress.md'), 'utf8'));
+    console.log(missing.length ? `progress.md'de eksik ya da bozuk kalın etiket: ${missing.join(', ')}. Biçim: **Etiket:** değer` : 'progress.md etiketleri sağlam.');
+    if (missing.length) code = 1;
+  }
+  process.exit(code);
+}

package/.claude/settings.json

@@ -27,7 +27,8 @@
       "Bash(node .claude/hooks/models.mjs --show)",
       "Bash(node .claude/hooks/models.mjs --set:*)",
       "Bash(node .claude/hooks/commit-gate.mjs --status)",
-      "Bash(node .claude/hooks/flow.mjs:*)"
+      "Bash(node .claude/hooks/flow.mjs:*)",
+      "Bash(node .claude/hooks/progress.mjs:*)"
     ],
     "ask": [
       "Bash(git push:*)",

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.34.0-2a78d6?style=flat-square"></a>
+  <a href="kit/CHANGELOG.md"><img alt="Version" src="https://img.shields.io/badge/version-3.35.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.34.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.35.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/docs/workflow/models.md

@@ -11,7 +11,7 @@
 | Planlama ve mimari | `plan` | Plan, mimari ve veri modeli kararları; PRD, README ve kullanıcıya görünen metin. Ana oturumda yürür. | Opus · yüksek |
 | Kod yazma | `code` | Kabul testleri ve uygulama kodu. Alt ajana devredilir. | Sonnet · yüksek |
 | İnceleme ve denetim | `review` | Kurul üyeleri, `code-reviewer`, `security-auditor`, bulgu raporları (`/findings-all`). | Sonnet · yüksek |
-| Doküman ve araştırma | `docs` | Görev sonunda roadmap, progress ve maliyet günlüğü; CHANGELOG, rapor özeti; kod tarama, web araştırması (`/research` derin). Karar günlüğü karar anında ana oturumda yazılır. | Haiku · yüksek |
+| Doküman ve araştırma | `docs` | CHANGELOG, rapor özeti; kod tarama, web araştırması (`/research` derin). Karar günlüğü karar anında ana oturumda yazılır. | Haiku · yüksek |
 
 Effort ölçeği: düşük = `low`, orta = `medium`, yüksek = `high`, ekstra yüksek = `xhigh`. Effort arttıkça cevap yavaşlar ve limitten daha çok yer.
 

package/docs/workflow/usage-limits.md

@@ -76,4 +76,4 @@ Max planda yüzdeler daha düşüktür. Günlük doldukça tahmin kendini düzel
 
 ## 5. Maliyet günlüğü (tahmini kalibre etmek için)
 
-`/build` ve tam kurul toplantıları başlangıçta ve sonda 5 saatlik yüzdeyi okur ve `docs/workflow/cost-log.md`'ye bir satır ekler. Limit okunamıyorsa satır eklenmez.
+`/build` ve tam kurul toplantıları başlangıçta ve sonda 5 saatlik yüzdeyi okur ve `docs/workflow/cost-log.md`'ye bir satır ekler: `node .claude/hooks/progress.mjs --cost "<iş>" <boyut> <başlangıç %> <bitiş %> <dk>` (fark hesaplanır; pencere arada yenilendiyse `?`). Limit okunamıyorsa satır eklenmez.

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.35.0] - 2026-10-26
+
+### Değişen
+- **Görev sonu belge yazımı betikle.** Roadmap işareti, maliyet günlüğü satırı ve progress etiketleri mekanik iş; artık alt ajana verilmiyor. Yeni `node .claude/hooks/progress.mjs` bunları tek komutta yazar, token harcamaz:
+  - `--done G-012` roadmap'te görevi işaretler.
+  - `--cost "<iş>" <K|O|B> <başlangıç %> <bitiş %> <dk>` maliyet günlüğüne satır ekler, farkı hesaplar. Pencere arada yenilendiyse fark `?` yazılır.
+  - `--task`, `--did`, `--next` progress.md'yi günceller, son güncelleme tarihini kendisi koyar.
+  - `--check` durum çubuğunun ve panonun okuduğu kalın etiketlerin sağlam olduğunu denetler.
+  - `/build` adım 8 bunu kullanır. İzin satırı `/kit-update` ile eklenir.
+
 ## [3.34.0] - 2026-10-26
 
 ### Eklenen

package/kit/VERSION

@@ -1 +1 @@
-3.34.0
+3.35.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.34.0</b> Claude Code için başlangıç kiti · MIT</span>
+      <span class="pill"><b>v3.35.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>
@@ -894,7 +894,7 @@ Sıradaki: G-013 şifre sıfırlama · bekleyen karar: e-posta servisi</pre>
     <article class="tile"><h3>Dağıtım kurulumu</h3><p class="stack">/release first · deploy-setup.md</p><ul><li>Hosting, ortam değişkenleri, alan adı ve DNS, yedek, geri alma provası</li><li>Vercel, Supabase, Railway, EAS; adımlar kaynaklı ve tarihli</li><li>Sırrı sen panelde girersin; sohbete ve dosyaya yazılmaz</li></ul></article>
     <article class="tile"><h3>Öğrenen kurallar</h3><p class="stack">/fix-bug · /retro · hookify · AGENTS.md</p><ul><li>Aynı hata sınıfı ikinci kez gelince /fix-bug kural önerir; panoda da uyarı çıkar</li><li>Mekanik kural hookify'a, gerisi AGENTS.md'ye; sen onaylamadan yazılmaz</li><li>Her kuralda kaynak ve tarih; /maintain 90 günden eskileri sorar</li><li>Auto memory /start'ta sorulur, önerilen kapalı</li></ul></article>
     <article class="tile"><h3>Kişisel tercihler</h3><p class="stack">~/.vibe-kit/tercihler.md · prefs.mjs</p><ul><li>Bir davranışı düzelttiğinde ya da nasıl çalışmak istediğini söylediğinde AI not alır</li><li>Görev ve oturum sonunda "tercih olarak kaydedeyim mi?" diye sorar; onaylamadığın yazılmaz</li><li>Tercihler tüm projelerinde geçerli, her oturumda yüklenir; git'e girmez</li><li>Listele: <code>node .claude/hooks/prefs.mjs --list</code>, sil: <code>--remove &lt;no&gt;</code></li></ul></article>
-    <article class="tile"><h3>Rol bazlı model</h3><p class="stack">docs/workflow/models.md · models.mjs</p><ul><li>Dört rol: planlama, kod yazma, inceleme, doküman ve araştırma</li><li>Her görevin başında iki ekran: önce rollerin modeli, sonra effort'u</li><li>Önerilen: Opus yüksek, Sonnet yüksek, Sonnet yüksek, Haiku yüksek</li><li>Kod, inceleme ve doküman işleri seçilen modelle alt ajanda; plan ana oturumda</li><li>Alt ajan yalnız karlıysa: <code>flow.mjs</code> görev büyüklüğüne, bağlama ve limite bakar; küçük görev ana oturumda kalır, kurul üye sayısı limite göre azalır</li></ul></article>
+    <article class="tile"><h3>Rol bazlı model</h3><p class="stack">docs/workflow/models.md · models.mjs</p><ul><li>Dört rol: planlama, kod yazma, inceleme, doküman ve araştırma</li><li>Her görevin başında iki ekran: önce rollerin modeli, sonra effort'u</li><li>Önerilen: Opus yüksek, Sonnet yüksek, Sonnet yüksek, Haiku yüksek</li><li>Kod, inceleme ve doküman işleri seçilen modelle alt ajanda; plan ana oturumda</li><li>Roadmap işareti, maliyet satırı ve progress etiketleri <code>progress.mjs</code> ile yazılır; model çağrısı harcanmaz, biçim bozulmaz</li><li>Alt ajan yalnız karlıysa: <code>flow.mjs</code> görev büyüklüğüne, bağlama ve limite bakar; küçük görev ana oturumda kalır, kurul üye sayısı limite göre azalır</li></ul></article>
     <article class="tile"><h3>Türkiye eki</h3><p class="stack">--addons tr · docs/legal/turkiye.md</p><ul><li>KVKK yurt dışı aktarım: standart sözleşme, 5 iş günü bildirim</li><li>e-Fatura ve e-Arşiv eşikleri (GİB)</li><li>iyzico ve PayTR bildirim imzası kodu ve saldırgan testi</li><li>İ/ı ve Türkçe sıralama testleri; hukuki görüş değildir</li></ul></article>
     <article class="tile"><h3>Tarayıcıda QA ve önizleme</h3><p class="stack">/qa · preview.mjs · Playwright CLI</p><ul><li>Arayüz kriterleri gerçek tarayıcıda test olarak koşar</li><li>Rapor test sonucundan yazılır, panoda kart</li><li>/build arayüz görevinde masaüstü ve mobil ekran görüntüsü</li></ul></article>
     <article class="tile"><h3>Spec ve sapma kontrolü</h3><p class="stack">docs/product/specs/ · gate.mjs</p><ul><li>Mevcut, beklenen ve değişmemesi gereken davranış</li><li>"Değişmemesi gereken" satırların testi kapıda denetlenir</li><li>3+ dosyalık işte /plan-task, her hatada /fix-bug yazar</li></ul></article>
@@ -1055,7 +1055,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.34.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.35.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.34.0",
+  "version": "3.35.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",