tillerhand 3.47.1 → 3.48.1

package/.claude/hooks/labels.mjs

@@ -0,0 +1,177 @@
+// Label dictionary (3.48.0): the labels hooks read from project files, Turkish (pre-3.48 projects) and English.
+// Readers call normalize() first and then only know the English labels. Turkish reading goes away in 4.0.
+
+export const LABELS = {
+  lastUpdated: { en: 'Last updated', tr: 'Son güncelleme' },
+  activePhase: { en: 'Active phase', tr: 'Aktif faz' },
+  activeTask: { en: 'Active task', tr: 'Aktif görev' },
+  setupStep: { en: 'Setup step', tr: 'Başlangıç adımı' },
+  questionMode: { en: 'Question mode', tr: 'Soru modu' },
+  profile: { en: 'Profile', tr: 'Profil' },
+  currentState: { en: 'Current state', tr: 'Şu anki durum' },
+  doneLastSession: { en: 'Done last session', tr: 'Son oturumda yapılanlar' },
+  nextStep: { en: 'Next step', tr: 'Sıradaki adım' },
+  pendingDecisions: { en: 'Pending decisions', tr: 'Bekleyen kararlar' },
+  whereWeLeftOff: { en: 'Where we left off', tr: 'Kaldığı yer' },
+  openIssues: { en: 'Open issues / blockers', tr: 'Açık sorunlar / bloklayıcılar' },
+  status: { en: 'Status', tr: 'Durum' },
+  commitReview: { en: 'Commit review', tr: 'Commit denetimi' },
+  members: { en: 'Members', tr: 'Üyeler' },
+  meetingLog: { en: 'Meeting log', tr: 'Toplantı günlüğü' },
+  decisionLog: { en: 'Decision log', tr: 'Karar günlüğü' },
+  phase: { en: 'Phase', tr: 'Faz' },
+  commands: { en: 'Commands', tr: 'Komutlar' },
+  dev: { en: 'dev', tr: 'geliştirme' },
+  preview: { en: 'preview', tr: 'önizleme' },
+  typeCheck: { en: 'type check', tr: 'tip kontrol' },
+  type: { en: 'Type', tr: 'Tür' },
+  class: { en: 'Class', tr: 'Sınıf' },
+  mustNotChange: { en: 'Behavior that must not change', tr: 'Değişmemesi gereken davranış' },
+  priority: { en: 'Priority', tr: 'Öncelik' },
+  outOfScope: { en: 'Out of scope', tr: 'Kapsam dışı' },
+  chosenTech: { en: 'Chosen technologies', tr: 'Seçilen teknolojiler' },
+  maintenanceLog: { en: 'Maintenance log', tr: 'Bakım kaydı' },
+  flags: { en: 'Flags', tr: 'Bayraklar' },
+  records: { en: 'Records', tr: 'Kayıtlar' },
+  unreleased: { en: 'Unreleased', tr: 'Yayınlanmamış' },
+  currency: { en: 'Currency', tr: 'Para birimi' },
+  price: { en: 'Price (per user, monthly)', tr: 'Fiyat (kullanıcı başı aylık)' },
+  paymentFee: { en: 'Payment fee (%)', tr: 'Ödeme komisyonu (%)' },
+  fixedCost: { en: 'Fixed monthly cost', tr: 'Sabit aylık maliyet' },
+  variableCost: { en: 'Variable cost per user (monthly)', tr: 'Kullanıcı başı değişken maliyet (aylık)' },
+  targetUsers: { en: 'Target active users', tr: 'Hedef aktif kullanıcı' },
+  freeShare: { en: 'Free user share (%)', tr: 'Ücretsiz kullanıcı oranı (%)' },
+  accounts: { en: 'Accounts', tr: 'Hesaplar' },
+  inbox: { en: 'Inbox', tr: 'Gelen kutusu' },
+  themes: { en: 'Themes', tr: 'Temalar' },
+  reports: { en: 'Reports', tr: 'Raporlar' },
+  alarms: { en: 'Alarms', tr: 'Alarmlar' },
+  chosenDirection: { en: 'Chosen direction', tr: 'Seçilen yön' },
+  valueProposition: { en: 'Value proposition', tr: 'Değer önerisi' },
+  criticalFlows: { en: 'Critical flows', tr: 'Kritik akışlar' },
+  learnedRules: { en: 'Learned rules', tr: 'Öğrenilen kurallar' },
+  rule: { en: 'Rule', tr: 'Kural' },
+  environments: { en: 'Environments (dev / prod)', tr: 'Ortamlar (dev / prod)' },
+};
+
+// Values hooks read at known label or column positions. Readers compare with isValue(); never normalized in place.
+export const VALUES = {
+  on: { en: 'on', tr: 'açık' },
+  off: { en: 'off', tr: 'kapalı' },
+  none: { en: 'none', tr: 'yok' },
+  setup: { en: 'Setup', tr: 'Başlangıç' },
+  notSetUp: { en: 'not set up', tr: 'kurulmadı' },
+  setUp: { en: 'set up', tr: 'kuruldu' },
+  full: { en: 'Full', tr: 'Tam' },
+  light: { en: 'Light', tr: 'Hafif' },
+  standard: { en: 'Standard', tr: 'Standart' },
+  waiting: { en: 'waiting', tr: 'bekliyor' },
+  automatic: { en: 'automatic', tr: 'otomatik' },
+  user: { en: 'user', tr: 'kullanıcı' },
+  oneWay: { en: 'one-way', tr: 'tek' },
+  twoWay: { en: 'two-way', tr: 'çift' },
+  yes: { en: 'yes', tr: 'evet' },
+  no: { en: 'no', tr: 'hayır' },
+  right: { en: 'right', tr: 'doğru' },
+  wrong: { en: 'wrong', tr: 'yanlış' },
+  passed: { en: 'passed', tr: 'geçti' },
+  failed: { en: 'failed', tr: 'kaldı' },
+  notRun: { en: 'not run', tr: 'koşulmadı' },
+  bug: { en: 'bug', tr: 'hata' },
+  feature: { en: 'feature', tr: 'özellik' },
+  request: { en: 'request', tr: 'istek' },
+  complaint: { en: 'complaint', tr: 'şikayet' },
+  praise: { en: 'praise', tr: 'övgü' },
+  question: { en: 'question', tr: 'soru' },
+  new: { en: 'new', tr: 'yeni' },
+  planned: { en: 'planned', tr: 'planlandı' },
+  done: { en: 'done', tr: 'yapıldı' },
+  rejected: { en: 'rejected', tr: 'reddedildi' },
+  merged: { en: 'merged', tr: 'birleşti' },
+};
+
+// The value in either language, case-insensitive (Turkish-aware), whole or followed by a non-letter:
+// "açık · kapalı konular: yok" is on, "açıklama" is not.
+export function isValue(text, key) {
+  if (!Object.hasOwn(VALUES, key)) throw new Error(`unknown value: ${key}`);
+  if (typeof text !== 'string') return false;
+  // Turkish lowercase for "AÇIK", plain lowercase for "FAILED" (Turkish would give "faıled")
+  const lower = (x) => [x.toLocaleLowerCase('tr'), x.toLowerCase()];
+  const texts = lower(text.trim());
+  return Object.values(VALUES[key]).flatMap(lower).some((w) =>
+    texts.some((s) => s.startsWith(w) && !/^[\p{L}\p{N}]/u.test(s.slice(w.length))));
+}
+
+export function label(key) {
+  if (!Object.hasOwn(LABELS, key)) throw new Error(`unknown label: ${key}`);
+  return LABELS[key].en;
+}
+
+const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const COMMAND_KEYS = ['dev', 'preview', 'typeCheck'];
+// Longest first so a shorter label never wins over a longer one that starts the same way.
+const PAIRS = Object.entries(LABELS).filter(([k]) => !COMMAND_KEYS.includes(k)).map(([, v]) => v)
+  .sort((a, b) => b.tr.length - a.tr.length);
+const BOLD = PAIRS.map(({ tr, en }) => [new RegExp(`^\\*\\*${esc(tr)}:\\*\\*`), `**${en}:**`]);
+// The label must end at a non-letter: "## Faz 1" changes, "## Fazla mesai" does not. A PRD heading may be numbered
+// ("## 6. Kapsam dışı"), the CHANGELOG one is bracketed ("## [Yayınlanmamış]").
+const HEADING = [
+  [new RegExp(`^## \\[${esc(LABELS.unreleased.tr)}\\]`), `## [${LABELS.unreleased.en}]`],
+  ...PAIRS.map(({ tr, en }) => [new RegExp(`^## (\\d+\\. )?${esc(tr)}(?![\\p{L}\\p{N}])`, 'u'), `## $1${en}`]),
+];
+const COMMAND = COMMAND_KEYS.map((k) => [new RegExp(`^${esc(LABELS[k].tr)}:`), `${LABELS[k].en}:`]);
+const FENCE = /^ {0,3}(`{3,}|~{3,})/;
+const COMMANDS_HEADING = /^## (Komutlar|Commands)(?![\p{L}\p{N}])/u;
+
+const swap = (line, rules) => {
+  for (const [re, to] of rules) if (re.test(line)) return line.replace(re, to);
+  return line;
+};
+
+// Rewrites Turkish labels to English only at label positions: a line-start **Label:**, a "## Label" heading,
+// and the keys of the AGENTS.md Commands block. Prose, tables, other code blocks and values stay byte-identical.
+export function normalize(text) {
+  const bom = text.startsWith('') ? '' : '';
+  const parts = text.slice(bom.length).split(/(\r?\n)/);
+  let fence = false;
+  let commands = false;
+  for (let i = 0; i < parts.length; i += 2) {
+    const line = parts[i];
+    if (FENCE.test(line)) { fence = !fence; continue; }
+    if (!fence && /^#{1,2} /.test(line)) commands = COMMANDS_HEADING.test(line);
+    if (commands) parts[i] = swap(line, [...COMMAND, ...HEADING]);
+    else if (!fence) parts[i] = swap(line, [...BOLD, ...HEADING]);
+  }
+  return bom + parts.join('');
+}
+
+// The label a writer uses for key in this file: the language the file already has for it (English if both, or neither).
+// Same positions as normalize: a line-start **Label:** or a "## Label" heading outside code blocks.
+export function labelIn(text, key) {
+  const { en, tr } = LABELS[key] ?? {};
+  if (!Object.hasOwn(LABELS, key)) throw new Error(`unknown label: ${key}`);
+  const at = (word) => new RegExp(`^(\\*\\*${esc(word)}:\\*\\*|## (\\d+\\. )?\\[?${esc(word)}(?![\\p{L}\\p{N}]))`, 'u');
+  const [isEn, isTr] = [at(en), at(tr)];
+  let fence = false, found = en;
+  for (const line of text.replace(/^/, '').split(/\r?\n/)) {
+    if (FENCE.test(line)) { fence = !fence; continue; }
+    if (fence) continue;
+    if (isEn.test(line)) return en;
+    if (isTr.test(line)) found = tr;
+  }
+  return found;
+}
+
+const VERDICTS = [['KOŞULLU ONAY', 'conditional'], ['CONDITIONAL', 'conditional'], ['KOŞULLU', 'conditional'],
+  ['APPROVE', 'approve'], ['ONAY', 'approve'], ['REJECT', 'reject'], ['RET', 'reject']];
+
+// Board result in either language. Fail-closed: anything that is not one clean verdict is 'unknown'.
+export function verdict(text) {
+  if (typeof text !== 'string') return 'unknown';
+  // "**Result:** RET", "**RET**"; after the word only the end, a dash, a bracket or ": , ; ." ("RET: güvenlik")
+  const s = text.trim().replace(/^\*\*[^*]+:\*\*\s*/, '').replace(/^\*\*([^*]+)\*\*/, '$1').toUpperCase();
+  for (const [word, result] of VERDICTS) {
+    if (s.startsWith(word) && /^(?:\s*(?:$|[—–(-])|[:,;.])/.test(s.slice(word.length))) return result;
+  }
+  return 'unknown';
+}

package/.claude/hooks/messages.mjs

@@ -4,8 +4,8 @@ export const MESSAGES = {
   'session.begin': { tr: 'Başlamak için: /start [proje fikrin] · var olan projede: /adopt', en: 'To begin: /start [your project idea] · existing project: /adopt' },
   'session.resume': { tr: 'Devam: {command} (adım {step})', en: 'Continue: {command} (step {step})' },
   'session.next': { tr: 'Sıradaki: /build {code} · {title}', en: 'Next: /build {code} · {title}' },
-  'session.handoff': { tr: 'Devir notu var: /handoff devral', en: 'Handoff note waiting: /handoff devral' },
-  'session.handoffThen': { tr: 'Devir notu var: /handoff devral · sonra {next}', en: 'Handoff note waiting: /handoff devral · then {next}' },
+  'session.handoff': { tr: 'Devir notu var: /handoff take', en: 'Handoff note waiting: /handoff take' },
+  'session.handoffThen': { tr: 'Devir notu var: /handoff take · sonra {next}', en: 'Handoff note waiting: /handoff take · then {next}' },
   'dashboard.title': { tr: 'Kontrol paneli', en: 'Dashboard' },
   'dashboard.sevCritical': { tr: 'Kritik', en: 'Critical' },
   'dashboard.sevWarn': { tr: 'Dikkat', en: 'Attention' },
@@ -42,7 +42,8 @@ export const MESSAGES = {
   'dashboard.kpiDecisions': { tr: 'Kararlar', en: 'Decisions' },
   'dashboard.usersAuto': { tr: '{user} kullanıcı · {auto} otomatik', en: '{user} user · {auto} auto' },
   'dashboard.board': { tr: 'Kurul', en: 'Board' },
-  'dashboard.rejects': { tr: '{count} RET', en: '{count} RET' },
+  'dashboard.rejects': { tr: '{count} ret', en: '{count} rejected' },
+  'dashboard.kpiRejects': { tr: 'Ret', en: 'Rejected' },
   'dashboard.membersCount': { tr: '{count} üye', en: '{count} members' },
   'dashboard.kpiCommits7': { tr: 'Commit · 7 gün', en: 'Commits · 7 days' },
   'dashboard.filesWaiting': { tr: '{count} dosya bekliyor', en: '{count} files waiting' },
@@ -122,7 +123,7 @@ export const MESSAGES = {
   'dashboard.kpiPassing': { tr: 'Geçen', en: 'Passing' },
   'dashboard.reportTime': { tr: 'rapor: {when}', en: 'report: {when}' },
   'dashboard.noJunit': { tr: 'JUnit raporu yok', en: 'No JUnit report' },
-  'dashboard.noAcceptanceIds': { tr: 'PRD\'de kimlikli kabul kriteri yok (`Ö-01.1` biçimi).', en: 'The PRD has no acceptance criteria with an id (`Ö-01.1` format).' },
+  'dashboard.noAcceptanceIds': { tr: 'PRD\'de kimlikli kabul kriteri yok (`AC-01.1` biçimi).', en: 'The PRD has no acceptance criteria with an id (`AC-01.1` format).' },
   'dashboard.metricsMonthly': { tr: 'Metrikler · aylık', en: 'Metrics · monthly' },
   'dashboard.noMetrics': { tr: 'Henüz metrik kaydı yok. `/maintain monthly` ve `/retro` ekler.', en: 'No metrics recorded yet. `/maintain monthly` and `/retro` add them.' },
   'dashboard.criticalFlowTests': { tr: 'Kritik akış testleri', en: 'Critical flow tests' },
@@ -336,7 +337,7 @@ export const MESSAGES = {
   'dashboard.act.commitOrWrapUp': { tr: 'Commit veya /wrap-up', en: 'Commit or /wrap-up' },
   'dashboard.alert.progressStale': { tr: 'docs/workflow/progress.md {count} commit\'tir güncellenmedi.', en: 'docs/workflow/progress.md has not been updated for {count} commits.' },
   'dashboard.alert.closedTopics': { tr: 'Soru modu kapalı konular: {topics}. Bu konulardaki kararlar otomatik veriliyor.', en: 'Question mode closed topics: {topics}. Decisions on these topics are made automatically.' },
-  'dashboard.act.askModeOpen': { tr: '/ask-mode ac <konu>', en: '/ask-mode ac <topic>' },
+  'dashboard.act.askModeOpen': { tr: '/ask-mode on <konu>', en: '/ask-mode on <topic>' },
   'dashboard.alert.boardNotSetUp': { tr: 'Uzman kurulu kurulmadı.', en: 'The expert board is not set up.' },
   'dashboard.alert.liveMonitoring': { tr: 'Canlı izleme: {title}', en: 'Live monitoring: {title}' },
   'dashboard.act.fixLive': { tr: '/fix-bug canlı izleme #{number}', en: '/fix-bug live monitoring #{number}' },
@@ -372,7 +373,7 @@ export const MESSAGES = {
   'dashboard.act.wrapUpClear': { tr: '/wrap-up ve /clear', en: '/wrap-up and /clear' },
   'dashboard.alert.findingsCritical': { tr: '{kind} bulgu raporunda {critical} kritik bulgu var (sağlık {health}/100).', en: 'The {kind} finding report has {critical} critical findings (health {health}/100).' },
   'dashboardData.prodRefInMcp': { tr: 'Prod projesinin ref\'i ({ref}) .mcp.json\'da: AI prod\'a bağlanabiliyor.', en: 'The prod project\'s ref ({ref}) is in .mcp.json: the AI can connect to prod.' },
-  'dashboardData.prodRefAction': { tr: '.mcp.json → dev ref (docs/operations/accounts.md → Ortamlar)', en: '.mcp.json → dev ref (docs/operations/accounts.md → Ortamlar)' },
+  'dashboardData.prodRefAction': { tr: '.mcp.json → dev ref (docs/operations/accounts.md → Environments)', en: '.mcp.json → dev ref (docs/operations/accounts.md → Environments)' },
   'dashboardData.rlsMissing': { tr: 'Supabase kullanılıyor ama RLS saldırgan testi yok (tests/security/rls.mjs).', en: 'Supabase is in use but there is no RLS attacker test (tests/security/rls.mjs).' },
   'dashboardData.rlsAction': { tr: '/kit-update ile şablonu al, tabloları TABLES\'a ekle', en: 'Get the template with /kit-update, add the tables to TABLES' },
   'guard.commit.skipAsk': { tr: 'Commit kapısı: --skip kurul denetimini ve deterministik kapıyı aşar. Sadece kullanıcı açıkça isterse onayla.', en: 'Commit gate: --skip bypasses the board review and the deterministic gate. Approve only if the user explicitly asks.' },
@@ -398,7 +399,7 @@ export const MESSAGES = {
   'guard.destructive.perm.planSave': { tr: 'Kapsam kalkanının dosya listesi yazılıyor', en: 'The scope shield\'s file list is being written' },
   'guard.destructive.perm.planEnd': { tr: 'Kapsam kalkanı kapatılıyor', en: 'The scope shield is being closed' },
   'guard.destructive.perm.commitSkip': { tr: 'Commit kapısı ve kurul denetimi atlanıyor', en: 'The commit gate and the board review are being skipped' },
-  'guard.destructive.perm.prefsEdit': { tr: 'Kişisel tercih dosyası (~/.vibe-kit/tercihler.md) değişiyor', en: 'The personal preferences file (~/.vibe-kit/tercihler.md) is changing' },
+  'guard.destructive.perm.prefsEdit': { tr: 'Kişisel tercih dosyası (~/.vibe-kit/preferences.md) değişiyor', en: 'The personal preferences file (~/.vibe-kit/preferences.md) is changing' },
   'guard.destructive.perm.gateApprove': { tr: 'Deterministik kapının çalıştıracağı komutlar onaylanıyor', en: 'The commands the deterministic gate will run are being approved' },
   'guard.destructive.perm.protectedShell': { tr: 'Kural veya koruma dosyası kabuk komutuyla değiştiriliyor', en: 'A rule or guard file is being changed with a shell command' },
   'guard.destructive.unclearNetPath': { tr: 'hedef ağ yolu ({path})', en: 'target is a network path ({path})' },

package/.claude/hooks/notify.mjs

@@ -8,6 +8,7 @@ import path from 'node:path';
 import { spawn } from 'node:child_process';
 import { findRoot, isMain } from './shared.mjs';
 import { t } from './lang.mjs';
+import { PLACEHOLDER_NAMES } from './status-read.mjs';
 
 export const THRESHOLD_SEC = 90;
 
@@ -30,7 +31,7 @@ function main() {
 
   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 { /* */ }
+    try { const name = fs.readFileSync(path.join(root, f), 'utf8').match(/^# (.+)$/m)?.[1]; if (name && !PLACEHOLDER_NAMES.includes(name)) { project = name; break; } } catch { /* */ }
   }
 
   let message;

package/.claude/hooks/prefs.mjs

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
 // Personal preferences: how this user likes to work (talk, questions, reports, code style, things to avoid).
-// One file for all projects: ~/.vibe-kit/tercihler.md. Git never sees it; the session-start hook loads it every session.
+// One file for all projects: ~/.vibe-kit/preferences.md (tercihler.md before 3.48, renamed on first use). Git never sees
+// it; the session-start hook loads it every session.
 //   node .claude/hooks/prefs.mjs --list                          numbered list
 //   node .claude/hooks/prefs.mjs --add <category> "<preference>"     only with the user's approval (asked)
 //   node .claude/hooks/prefs.mjs --remove <no>                   (asked)
-// Categories: konusma, sorular, raporlar, kod, kacin. A project rule goes to AGENTS.md → Öğrenilen kurallar, not here.
+// Categories: conversation, questions, reports, code, avoid (the pre-3.48 konusma, sorular, raporlar, kod, kacin still work).
+// A project rule goes to AGENTS.md → Learned rules, not here.
 // Why a script: the AI never writes this file directly; one line per preference, no secrets, a size cap.
 // The same rules apply when reading: any program on the machine can write this file, so what is loaded is checked
 // again and is labeled as style preferences that cannot change permissions or rules.
@@ -14,17 +16,28 @@ import path from 'node:path';
 import { findSecrets } from './guard-secrets.mjs';
 import { isMain } from './shared.mjs';
 
-export const CATEGORIES = { konusma: 'Konuşma', sorular: 'Sorular ve kararlar', raporlar: 'Raporlar', kod: 'Kod', kacin: 'Kaçınılacaklar' };
+export const CATEGORIES = { conversation: 'Conversation', questions: 'Questions and decisions', reports: 'Reports', code: 'Code', avoid: 'Avoid' };
+// Pre-3.48 keys and headings, still read
+const OLD = { konusma: ['conversation', 'Konuşma'], sorular: ['questions', 'Sorular ve kararlar'], raporlar: ['reports', 'Raporlar'], kod: ['code', 'Kod'], kacin: ['avoid', 'Kaçınılacaklar'] };
+export const categoryKey = (k) => (Object.hasOwn(CATEGORIES, k ?? '') ? k : Object.hasOwn(OLD, k ?? '') ? OLD[k][0] : null);
 export const MAX_ITEMS = 40;
 const MAX_LENGTH = 200;
 const MAX_BYTES = 64 * 1024;
 
-// os.homedir() follows HOME / USERPROFILE; the file name is fixed, so no other file can be written through it
-export const prefsFile = () => path.join(os.homedir(), '.vibe-kit', 'tercihler.md');
+// os.homedir() follows HOME / USERPROFILE; the file name is fixed, so no other file can be written through it.
+// A pre-3.48 tercihler.md is renamed once (decision: a 3.47 project on the same machine no longer sees it).
+export const prefsFile = () => {
+  const file = path.join(os.homedir(), '.vibe-kit', 'preferences.md');
+  const old = path.join(os.homedir(), '.vibe-kit', 'tercihler.md');
+  if (fs.existsSync(file) || !fs.existsSync(old)) return file;
+  try { fs.renameSync(old, file); return file; } catch { return old; }
+};
 
 // A heading is matched by key or title, ignoring case and Turkish letters (## kod, ## Kacinilacaklar)
 const fold = (s) => s.toLocaleLowerCase('tr').normalize('NFD').replace(/[̀-ͯ]/g, '').replace(/ı/g, 'i').trim();
-const categoryOf = (heading) => Object.keys(CATEGORIES).find((k) => fold(k) === fold(heading) || fold(CATEGORIES[k]) === fold(heading)) ?? null;
+const categoryOf = (heading) => Object.keys(CATEGORIES).find((k) => fold(k) === fold(heading) || fold(CATEGORIES[k]) === fold(heading))
+  ?? Object.values(OLD).find(([, title]) => fold(title) === fold(heading))?.[0]
+  ?? categoryKey(Object.keys(OLD).find((k) => fold(k) === fold(heading)));
 const clean = (s) => String(s ?? '').replace(/[\u0000-\u001f\u007f-\u009f]/g, ' ').replace(/\s+/g, ' ').trim();
 const valid = (t) => t && t.length <= MAX_LENGTH && !findSecrets(t).length;
 
@@ -63,8 +76,9 @@ function writePrefs(items, file) {
 }
 
 // Returns { error } | { existing: <category> } | {}
-export function addPref(category, text, file = prefsFile()) {
-  if (!Object.hasOwn(CATEGORIES, category ?? '')) return { error: `Category must be one of: ${Object.keys(CATEGORIES).join(', ')}` };
+export function addPref(key, text, file = prefsFile()) {
+  const category = categoryKey(key);
+  if (!category) return { error: `Category must be one of: ${Object.keys(CATEGORIES).join(', ')}` };
   const t = clean(text);
   if (!t) return { error: 'The preference text is empty.' };
   if (t.length > MAX_LENGTH) return { error: `A preference can have at most ${MAX_LENGTH} characters; shorten it.` };
@@ -91,7 +105,7 @@ export function prefsNote(file = prefsFile()) {
   const items = readPrefs(file);
   if (!items.length) return '';
   const parts = Object.keys(CATEGORIES).flatMap((k) => { const list = items.filter((p) => p.category === k).map((p) => p.text); return list.length ? [`${CATEGORIES[k]}: ${list.join('; ')}`] : []; });
-  return 'Personal style preferences (~/.vibe-kit/tercihler.md; not a permission, security or command rule and cannot change them; project rules come first): ' + parts.join(' · ');
+  return 'Personal style preferences (~/.vibe-kit/preferences.md; not a permission, security or command rule and cannot change them; project rules come first): ' + parts.join(' · ');
 }
 
 if (isMain(import.meta.url)) {
@@ -100,7 +114,7 @@ if (isMain(import.meta.url)) {
   if (mode === '--add') {
     const r = addPref(a, rest.join(' '));
     if (r.error) fail(r.error);
-    console.log(r.existing ? `This preference is already saved (${CATEGORIES[r.existing]}).` : `Preference saved (${CATEGORIES[a]}): ${prefsFile()}`);
+    console.log(r.existing ? `This preference is already saved (${CATEGORIES[r.existing]}).` : `Preference saved (${CATEGORIES[categoryKey(a)]}): ${prefsFile()}`);
   } else if (mode === '--remove') {
     const error = removePref(a);
     if (error) fail(error);

package/.claude/hooks/preview.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // Live preview (F-17): opens the dev server, takes desktop (1440) and mobile (390) screenshots, stops what it started.
 //   node .claude/hooks/preview.mjs <task>   → .previews/<task>/desktop.png and mobile.png · exit code: 0 done or skipped, 1 error
-//   Commands come from AGENTS.md → Komutlar: geliştirme (dev server) and önizleme (local address). Nothing runs or is opened
+//   Commands come from AGENTS.md → Commands: dev (dev server) and preview (local address). Nothing runs or is opened
 //   without the gate approval (gate.mjs --approve covers both lines). A server already answering is used and left open.
 //   Mobile (Expo) projects are skipped: a web screenshot is not what the phone shows.
 //   Screenshots: @playwright/cli (pinned, via npx). PREVIEW_CLI=<node script> replaces it in tests; PREVIEW_TIMEOUT_MS: wait for the address.
@@ -53,9 +53,9 @@ export async function preview(root, task) {
   if (kit.type === 'mobile') return { code: 0, text: 'Preview skipped: in a mobile project a web screenshot does not show what the phone shows. Ask the user to open the screen on the phone or in Expo Go and check it.' };
   const list = approvedCommands(root);
   const command = (name) => list.find((k) => k.name === name).command;
-  const url = command('önizleme'), dev = command('geliştirme');
-  if (!url) return fail('AGENTS.md → Komutlar has no `önizleme:` line, or it is empty. Add it (example: `önizleme:    http://localhost:3000`) or produce the evidence by hand in this task.');
-  if (!LOCAL.test(url)) return fail(`the önizleme address must be local (http://localhost:<port>, 127.0.0.1 or [::1]). Now: ${url}`);
+  const url = command('preview'), dev = command('dev');
+  if (!url) return fail('AGENTS.md → Commands has no `preview:` line, or it is empty. Add it (example: `preview:     http://localhost:3000`) or produce the evidence by hand in this task.');
+  if (!LOCAL.test(url)) return fail(`the preview address must be local (http://localhost:<port>, 127.0.0.1 or [::1]). Now: ${url}`);
   if (!isApproved(root, list)) return { code: 1, text: `Preview · ${approvalNeeded(list)}` };
   const dir = `.previews/${String(task || 'son').replace(/[^\w-]/g, '-')}`;
   // A linked folder from the repo would send the files elsewhere
@@ -77,7 +77,7 @@ export async function preview(root, task) {
   process.once('SIGTERM', onSignal);
   try {
     if (!(await answers(url))) {
-      if (!dev) return fail(`${url} is not up and AGENTS.md → Komutlar has no \`geliştirme:\` command.`);
+      if (!dev) return fail(`${url} is not up and AGENTS.md → Commands has no \`dev:\` command.`);
       // Output goes to a file, not a pipe: the screenshot steps block the event loop and a full pipe would freeze the server
       const fd = fs.openSync(logFile, 'w');
       // A process group on POSIX so the whole tree can be stopped; on Windows detached would open a console window
@@ -90,7 +90,7 @@ export async function preview(root, task) {
       while (!up && running() && Date.now() < deadline) { await sleep(500); up = await answers(url); }
       if (!up) {
         return fail(running()
-          ? `${url} did not come up within ${Math.round(wait / 1000)} s. Are the address and port the same as \`önizleme:\` in AGENTS.md → Komutlar?${block(devLog())}`
+          ? `${url} did not come up within ${Math.round(wait / 1000)} s. Are the address and port the same as \`preview:\` in AGENTS.md → Commands?${block(devLog())}`
           : `the dev server exited before it came up (${child.exitCode ?? child.signalCode}): ${dev}${block(devLog())}`);
       }
     }

package/.claude/hooks/progress.mjs

@@ -1,27 +1,34 @@
 #!/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 "<job>" <K|O|B|BOARD|DESIGN|FINDINGS> <start %> <end %> <min> ["<note>"]
+//   node .claude/hooks/progress.mjs --cost "<job>" <S|M|L|BOARD|DESIGN|FINDINGS> <start %> <end %> <min> ["<note>"]
 //   node .claude/hooks/progress.mjs --start [--limit N]           at task start: keeps the 5-hour % and the time
 //   node .claude/hooks/progress.mjs --cost "<job>" <size> ["<note>"] [--limit N]  start from --start, end now (once)
 //   node .claude/hooks/progress.mjs --task "<active task>" --did "<done>" --next "<next step>"
 //   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.
+// Every progress write also sets **Last updated:** (**Son güncelleme:** in a Turkish file) 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';
+import { label, labelIn, normalize } from './labels.mjs';
 import { readLimits } from './usage.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 = 'Usage: node .claude/hooks/progress.mjs [--done G-NNN] [--start] [--cost "<job>" <K|O|B|BOARD|DESIGN|FINDINGS> [<start %> <end %> <min>] ["<note>"]] [--limit N] [--task "<text>"] [--did "<text>"] [--next "<text>"] [--check]';
+const REQUIRED = ['lastUpdated', 'activePhase', 'activeTask', 'setupStep', 'questionMode', 'profile'];
+const SIZES = ['S', 'M', 'L', 'BOARD', 'DESIGN', 'FINDINGS'];
+// Sizes before 3.48 (küçük / orta / büyük); still accepted, written as the English one
+export const OLD_SIZES = { K: 'S', O: 'M', B: 'L' };
+const USAGE = 'Usage: node .claude/hooks/progress.mjs [--done G-NNN] [--start] [--cost "<job>" <S|M|L|BOARD|DESIGN|FINDINGS> [<start %> <end %> <min>] ["<note>"]] [--limit N] [--task "<text>"] [--did "<text>"] [--next "<text>"] [--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] ?? '';
+// Labels and headings are written in the language the file already uses (labelIn). Function replacements: a value
+// with $& or $' is text, not a replacement pattern.
+const esc = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const setLabel = (text, key, v) => text.replace(new RegExp(`^(\\*\\*${esc(labelIn(text, key))}:\\*\\*).*$`, 'm'), (_, l) => `${l} ${v}`);
+const sectionRe = (text, key) => new RegExp(`^(## ${esc(labelIn(text, key))}[^\\n]*\\n)([\\s\\S]*?)(?=^## |(?![\\s\\S]))`, 'm');
+const setSection = (text, key, body) => text.replace(sectionRe(text, key), (_, h) => `${h}\n${body}\n\n`);
+const section = (text, key) => text.match(sectionRe(text, key))?.[2] ?? '';
 
 export function markDone(text, id) {
   const re = new RegExp(`^(\\s*- )\\[( |x)\\](\\s*${id}:)`, 'mi');
@@ -32,7 +39,8 @@ export function markDone(text, id) {
 }
 
 export function costRow(args, date = today()) {
-  const [job, size, start, end, min, note = ''] = args;
+  const [job, typed, start, end, min, note = ''] = args;
+  const size = OLD_SIZES[typed] ?? typed;
   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
@@ -42,17 +50,21 @@ export function costRow(args, date = today()) {
 }
 
 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));
+  let t = setLabel(text, 'lastUpdated', today());
+  if (task != null) t = setLabel(t, 'activeTask', 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'));
+    const items = section(t, 'doneLastSession').split('\n').map((s) => s.trim()).filter((s) => /^- \S/.test(s));
+    t = setSection(t, 'doneLastSession', [...items, `- ${line(did)}`].join('\n'));
   }
-  if (next != null) t = setSection(t, 'Sıradaki adım', `1. ${line(next)}`);
+  if (next != null) t = setSection(t, 'nextStep', `1. ${line(next)}`);
   return t;
 }
 
-export const missingLabels = (text) => LABELS.filter((k) => !(k in labels(text)));
+// By their English names, whichever language the file uses; an example inside a code block does not count
+export const missingLabels = (text) => {
+  const found = labels(normalize(text).replace(/^```[\s\S]*?^```.*$/gm, ''));
+  return REQUIRED.map((k) => label(k)).filter((k) => !(k in found));
+};
 
 if (isMain(import.meta.url)) {
   const root = findRoot();

package/.claude/hooks/qa-report.mjs

@@ -2,8 +2,8 @@
 // Browser QA report (F-18): written from the JUnit result of the /qa run, so "it works" needs a green test behind it.
 //   node .claude/hooks/qa-report.mjs [junit file]   default: test-results-qa/junit.xml (the /qa run has its own output folder:
 //   Playwright empties its output folder at every run, a shared one would delete the acceptance report and the evidence)
-//   → docs/quality/qa/<YYYY-MM-DD-HHMMSS>.md: one row per PRD criterion (geçti / kaldı / koşulmadı), the first failure line,
-//   evidence test-results-qa/shots/<Ö-id>.png copied to .previews/qa-<stamp>/ (kept out of git, outlives the next run).
+//   → docs/quality/qa/<YYYY-MM-DD-HHMMSS>.md: one row per PRD criterion (passed / failed / not run), the first failure line,
+//   evidence test-results-qa/shots/<AC-id>.png copied to .previews/qa-<stamp>/ (kept out of git, outlives the next run).
 //   Exit code: 0 nothing failed, 1 a criterion failed, 2 nothing to report (no JUnit file, no PRD criterion, no test ran).
 import fs from 'node:fs';
 import path from 'node:path';
@@ -27,7 +27,7 @@ export function qaReport(root, junit = 'test-results-qa/junit.xml', now = new Da
   let prd;
   try { prd = fs.readFileSync(path.join(root, 'docs/product/prd.md'), 'utf8'); } catch { return none('docs/product/prd.md not found.'); }
   const criteria = prdCriteria(prd);
-  if (!criteria.length) return none('the PRD has no acceptance criterion with an id (`- [ ] Ö-01.1: ...`).');
+  if (!criteria.length) return none('the PRD has no acceptance criterion with an id (`- [ ] AC-01.1: ...`).');
   const results = new Map();
   for (const c of junitCases(xml)) {
     for (const k of c.keys) {
@@ -42,27 +42,29 @@ export function qaReport(root, junit = 'test-results-qa/junit.xml', now = new Da
   const rows = criteria.map((k) => {
     const r = results.get(k.key);
     let evidence = '';
-    const shot = path.join(root, path.dirname(junit), 'shots', `${k.id}.png`);
+    // The test may name the screenshot in the other id form (PRD "Ö-01.1", test "AC-01.1", or the other way round)
+    const names = [k.id, k.id.replace(/^Ö-/, 'AC-'), k.id.replace(/^AC-/, 'Ö-')];
+    const shot = [...new Set(names)].map((n) => path.join(root, path.dirname(junit), 'shots', `${n}.png`))
+      .find((p) => { try { return fs.lstatSync(p).isFile(); } catch { return false; } });
     // Only a real screenshot file: a shots/<id>.png link would copy any local file into .previews/
-    let real = false;
-    try { real = fs.lstatSync(shot).isFile(); } catch { /* no screenshot */ }
+    const real = !!shot;
     if (r && !linked && real) {
       fs.mkdirSync(shots, { recursive: true });
       fs.copyFileSync(shot, path.join(shots, `${k.id}.png`));
       evidence = `.previews/qa-${stamp}/${k.id}.png`;
     }
-    return { criterion: `${k.id} ${k.text}`, result: !r ? 'koşulmadı' : r.failed ? 'kaldı' : 'geçti', evidence, note: r?.failed ? reasonLine(r.reason) : '' };
+    return { criterion: `${k.id} ${k.text}`, result: !r ? 'not run' : r.failed ? 'failed' : 'passed', evidence, note: r?.failed ? reasonLine(r.reason) : '' };
   });
   const count = (x) => rows.filter((r) => r.result === x).length;
-  if (!count('geçti') && !count('kaldı')) return none(`no test result tied to a PRD criterion in ${junit} (the test name must start with the id: \`Ö-01.1 ...\`; did the server start?).`);
-  const counts = { passed: count('geçti'), failed: count('kaldı'), notRun: count('koşulmadı') };
+  if (!count('passed') && !count('failed')) return none(`no test result tied to a PRD criterion in ${junit} (the test name must start with the id: \`AC-01.1 ...\`; did the server start?).`);
+  const counts = { passed: count('passed'), failed: count('failed'), notRun: count('not run') };
   const file = `docs/quality/qa/${stamp}.md`;
   const md = `${t(root, 'qaReport.title', { stamp })}\n\n${t(root, 'qaReport.result', { summary: t(root, 'qaReport.summary', counts), count: rows.length, junit })}\n\n` +
     `${t(root, 'qaReport.tableHeader')}\n|---|---|---|---|\n${rows.map((r) => `| ${cell(r.criterion)} | ${r.result} | ${r.evidence} | ${cell(r.note)} |`).join('\n')}\n`;
   fs.mkdirSync(path.join(root, 'docs/quality/qa'), { recursive: true });
   fs.writeFileSync(path.join(root, file), md);
   const stale = age > STALE_MIN ? `\nWarning: ${junit} was written ${Math.round(age)} min ago; it may not be the result of this run, rerun the tests.` : '';
-  return { code: count('kaldı') ? 1 : 0, text: `QA: ${counts.passed} passed · ${counts.failed} failed · ${counts.notRun} not run → ${file}${stale}` };
+  return { code: count('failed') ? 1 : 0, text: `QA: ${counts.passed} passed · ${counts.failed} failed · ${counts.notRun} not run → ${file}${stale}` };
 }
 
 if (isMain(import.meta.url)) {

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

@@ -10,6 +10,7 @@ import { readLimits, summary } from './usage.mjs';
 import { detectTool, findRoot, sessionNote } from './shared.mjs';
 import { prefsNote } from './prefs.mjs';
 import { readLang, t } from './lang.mjs';
+import { isValue } from './labels.mjs';
 
 const notes = [];
 let next = '';
@@ -30,18 +31,19 @@ try {
     next = t(root, 'session.begin');
   } else {
     const a = d.fields;
-    notes.push(`Phase: ${a['Aktif faz'] ?? '-'} · Task: ${a['Aktif görev'] ?? '-'} · Question mode: ${a['Soru modu'] ?? 'açık'} · Board: ${d.board.state}`);
-    if (/başlangıç/i.test(a['Aktif faz'] ?? '') && d.installed) {
-      const command = /uyum/i.test(a['Aktif faz']) ? '/adopt' : '/start';
-      notes.push(`${command} was left unfinished (step ${a['Başlangıç adımı']}). Suggest the user continue with ${command} where they left off.`);
-      next = t(root, 'session.resume', { command, step: a['Başlangıç adımı'] });
+    notes.push(`Phase: ${a['Active phase'] ?? '-'} · Task: ${a['Active task'] ?? '-'} · Question mode: ${a['Question mode'] ?? 'on'} · Board: ${d.board.state}`);
+    if (isValue(a['Active phase'], 'setup') && d.installed) {
+      // "Setup (adopt)", before 3.48 "Başlangıç (uyum)"
+      const command = /\((adopt|uyum)\)/i.test(a['Active phase']) ? '/adopt' : '/start';
+      notes.push(`${command} was left unfinished (step ${a['Setup step']}). Suggest the user continue with ${command} where they left off.`);
+      next = t(root, 'session.resume', { command, step: a['Setup step'] });
     } else {
       const task = d.phases.flatMap((f) => f.tasks).find((x) => !x.done);
       const code = task?.text.match(/^(G-\d+)/)?.[1];
       if (code) next = t(root, 'session.next', { code, title: task.text.replace(/^G-\d+:\s*/, '').split(' — ')[0].replace(/\*\*/g, '').slice(0, 70) });
     }
     if (d.handoffPending) {
-      notes.push('Handoff note waiting (docs/workflow/handoff.md): the project is being taken over from another person or account. Suggest /handoff devral before starting work.');
+      notes.push('Handoff note waiting (docs/workflow/handoff.md): the project is being taken over from another person or account. Suggest /handoff take before starting work.');
       next = next ? t(root, 'session.handoffThen', { next }) : t(root, 'session.handoff');
     }
     if (next) notes.push(next);
@@ -72,7 +74,7 @@ try {
   // not a git repo, or before the first commit
 }
 
-// The user's preferences from every project (~/.vibe-kit/tercihler.md), short; a broken file must not stop the session
+// The user's preferences from every project (~/.vibe-kit/preferences.md), short; a broken file must not stop the session
 try { const p = prefsNote(); if (p) notes.push(p.length > 1500 ? `${p.slice(0, 1500)}…` : p); } catch { /* no preferences */ }
 
 if (notes.length) console.log(sessionNote(tool, '[Kit] ' + notes.join('\n[Kit] '), next && `[Kit] ${next}`));