tillerhand 3.47.1 → 3.48.1

package/.claude/hooks/dashboard-data.mjs

@@ -3,7 +3,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { execFileSync } from 'node:child_process';
-import { readText, sections, tableRows, labels } from './status-read.mjs';
+import { readText, sections, findSection, tableRows, labels } from './status-read.mjs';
+import { normalize, isValue, VALUES } from './labels.mjs';
 import { t } from './lang.mjs';
 
 const DAY = 864e5;
@@ -11,13 +12,13 @@ const isDate = (s) => /^\d{4}-\d{2}-\d{2}$/.test(String(s).trim());
 export const daysLeft = (date, now = Date.now()) => Math.ceil((Date.parse(`${date}T00:00:00`) - now) / DAY);
 
 // ---------- acceptance tests ----------
-// A criterion id is "Ö-01.1" in the PRD and "Ö-01.1" or "O_01_1" in tests; all normalize to the key "O_01_1".
-// Not after a letter: "ISO-27.1" or "DEMO_01_2" is not a criterion
-const CRITERION_ID = /(?<![A-Za-z])[ÖO][-_](\d{2})[._](\d+)/g;
+// A criterion id is "AC-01.1" in the PRD and "AC-01.1" or "AC_01_1" in tests; before 3.48 "Ö-01.1" / "O_01_1".
+// All four normalize to the key "O_01_1". Not after a letter: "ISO-27.1", "DEMO_01_2" or "MAC_01_1" is not a criterion
+const CRITERION_ID = /(?<![A-Za-z])(?:AC|[ÖO])[-_](\d{2})[._](\d+)/g;
 const key = (m1, m2) => `O_${m1}_${m2}`;
 
 export function prdCriteria(prdText) {
-  return [...prdText.matchAll(/^\s*- \[( |x)\]\s*(Ö-(\d{2})\.(\d+))\s*:?\s*(.*)$/gim)]
+  return [...prdText.matchAll(/^\s*- \[( |x)\]\s*((?:AC|Ö)-(\d{2})\.(\d+))\s*:?\s*(.*)$/gim)]
     .filter((m) => !m[5].startsWith('['))
     .map((m) => ({ id: m[2], key: key(m[3], m[4]), text: m[5].trim(), checked: m[1].toLowerCase() === 'x' }));
 }
@@ -81,8 +82,8 @@ export function junitResults(xmlTexts) {
 export function qaSummary(text) {
   const rows = tableRows(text, 4).map(([criterion, result, evidence, note]) => ({ criterion, result, evidence, note }));
   if (!rows.length) return null;
-  const count = (r) => rows.filter((x) => x.result === r).length;
-  return { passed: count('geçti'), failed: count('kaldı'), notRun: count('koşulmadı'), failures: rows.filter((x) => x.result === 'kaldı') };
+  const count = (k) => rows.filter((x) => isValue(x.result, k)).length;
+  return { passed: count('passed'), failed: count('failed'), notRun: count('notRun'), failures: rows.filter((x) => isValue(x.result, 'failed')) };
 }
 
 function junitFiles(root) {
@@ -111,21 +112,21 @@ export function acceptanceStatus(root) {
   };
 }
 
-// "Must not change" lines of the specs (F-23): each Ö id, whether a test carries it and its JUnit result.
+// "Must not change" lines of the specs (F-23): each AC id, whether a test carries it and its JUnit result.
 // since: only reports written at or after this time count (the gate passes its own start: an old red report must not
 // stop a commit whose tests pass now). Files starting with "_" (the template) are skipped. unreadable: lines that name
-// an id but not in the "- Ö-01.1: ..." form, so the check would silently skip them.
+// an id but not in the "- AC-01.1: ..." form, so the check would silently skip them.
 export function specInvariants(root, since = 0) {
   const dir = path.join(root, 'docs/product/specs');
   let files = [];
   try { files = fs.readdirSync(dir).filter((f) => f.endsWith('.md') && !f.startsWith('_')).sort(); } catch { return { invariants: [], unreadable: [] }; }
   const list = [], unreadable = [];
   for (const f of files) {
-    const body = sections(readText(path.join(dir, f)))['Değişmemesi gereken davranış'] ?? '';
+    const body = sections(readText(path.join(dir, f)))['Behavior that must not change'] ?? '';
     for (const line of body.split(/\r?\n/)) {
-      const m = line.match(/^\s*-\s*(Ö-(\d{2})\.(\d+))/);
+      const m = line.match(/^\s*-\s*((?:AC|Ö)-(\d{2})\.(\d+))/);
       if (m) list.push({ spec: f, id: m[1], key: key(m[2], m[3]) });
-      else if (/[ÖO][-_]\d{2}[._]\d+/.test(line)) unreadable.push({ spec: f, line: line.trim() });
+      else if (/(?<![A-Za-z])(?:AC|[ÖO])[-_]\d{2}[._]\d+/.test(line)) unreadable.push({ spec: f, line: line.trim() });
     }
   }
   if (!list.length) return { invariants: [], unreadable };
@@ -135,9 +136,11 @@ export function specInvariants(root, since = 0) {
 }
 
 // Bug classes seen in two or more bug specs (F-21): a repeat is the cue to propose a rule. Only the fixed list counts
-// ("diğer" and free text never do). A group closes once every spec has a "**Kural:**" answer (rule added or not needed);
+// ("diğer"/"other" and free text never do). A group closes once every spec has a "**Rule:**" answer (rule added or not needed);
 // a new undecided spec in a decided class opens it again (the rule did not prevent the bug).
-export const BUG_CLASSES = ['boş-girdi', 'doğrulama', 'yetki', 'tarih-saat', 'yerel-dil', 'sıralama', 'eşzamanlılık', 'yapılandırma', 'dış-servis', 'sözleşme', 'arayüz-durumu'];
+export const BUG_CLASSES = ['empty-input', 'validation', 'authorization', 'date-time', 'locale', 'sorting', 'concurrency', 'configuration', 'external-service', 'contract', 'ui-state'];
+// Pre-3.48 specs name the class in Turkish, in the same order; both count as one class under the English name
+const BUG_CLASSES_TR = ['boş-girdi', 'doğrulama', 'yetki', 'tarih-saat', 'yerel-dil', 'sıralama', 'eşzamanlılık', 'yapılandırma', 'dış-servis', 'sözleşme', 'arayüz-durumu'];
 export function repeatedBugClasses(root) {
   const dir = path.join(root, 'docs/product/specs');
   let files = [];
@@ -145,12 +148,13 @@ export function repeatedBugClasses(root) {
   const byClass = new Map();
   for (const f of files) {
     const text = readText(path.join(dir, f));
-    if (!/^\*\*Tür:\*\*[ \t]*hata\b/im.test(text)) continue;
-    const raw = text.match(/^\*\*Sınıf:\*\*[ \t]*`?([^\s`,.[\]]+)/im)?.[1] ?? '';
+    if (!isValue(text.match(/^\*\*Type:\*\*[ \t]*(.*)$/im)?.[1], 'bug')) continue;
+    const raw = text.match(/^\*\*Class:\*\*[ \t]*`?([^\s`,.[\]]+)/im)?.[1] ?? '';
     // YETKI and YETKİ both mean yetki: try the Turkish and the plain lowercase
-    const cls = [raw.toLocaleLowerCase('tr'), raw.toLowerCase()].find((c) => BUG_CLASSES.includes(c));
+    const cls = [raw.toLocaleLowerCase('tr'), raw.toLowerCase()]
+      .map((c) => (BUG_CLASSES.includes(c) ? c : BUG_CLASSES[BUG_CLASSES_TR.indexOf(c)])).find(Boolean);
     if (!cls) continue;
-    const decided = /^\*\*Kural:\*\*[ \t]*[^\s[]/im.test(text);
+    const decided = /^\*\*Rule:\*\*[ \t]*[^\s[]/im.test(text);
     byClass.set(cls, [...(byClass.get(cls) ?? []), { f, decided }]);
   }
   return [...byClass].filter(([, list]) => list.length > 1 && list.some((s) => !s.decided)).map(([cls, list]) => ({ cls, specs: list.map((s) => s.f) }));
@@ -158,19 +162,19 @@ export function repeatedBugClasses(root) {
 
 // ---------- accounts and flags ----------
 export function accounts(text, now = Date.now()) {
-  return tableRows(sections(text)['Hesaplar'], 8)
+  return tableRows(sections(normalize(text))['Accounts'], 8)
     .filter(([service]) => service && !service.startsWith('['))
     .map(([service, purpose, owner, twoFactor, plan, expiry, keyRotation]) => {
-      const dates = [['bitiş', expiry], ['anahtar yenileme', keyRotation]].filter(([, t]) => isDate(t))
+      const dates = [['expiry', expiry], ['keyRotation', keyRotation]].filter(([, t]) => isDate(t))
         .map(([kind, t]) => ({ kind, date: t, left: daysLeft(t, now) }));
-      return { service, purpose, owner, twoFactor, plan, dates, noTwoFactor: /^(hayır|yok|no)$/i.test(twoFactor) };
+      return { service, purpose, owner, twoFactor, plan, dates, noTwoFactor: isValue(twoFactor, 'no') || isValue(twoFactor, 'none') };
     });
 }
 
 // Dev/prod split and the RLS attacker test: the prod ref must not be in the AI's MCP config; with Supabase an RLS test must exist
 export function envWarnings(root) {
   const u = [];
-  const prodRef = tableRows(sections(readText(path.join(root, 'docs/operations/accounts.md')))['Ortamlar (dev / prod)'], 4)
+  const prodRef = tableRows(sections(readText(path.join(root, 'docs/operations/accounts.md')))['Environments (dev / prod)'], 4)
     // A real ref (Supabase: 20 characters); "-", "yok", "n/a" would match anywhere in .mcp.json
     .find(([environment, , ref]) => environment === 'prod' && /^[a-z0-9][a-z0-9._:/-]{7,}$/i.test(ref ?? ''))?.[2];
   if (prodRef && readText(path.join(root, '.mcp.json')).includes(prodRef)) {
@@ -183,24 +187,24 @@ export function envWarnings(root) {
 }
 
 export function flags(text, now = Date.now()) {
-  return tableRows(sections(text)['Bayraklar'], 7).filter(([name]) => name)
+  return tableRows(sections(normalize(text))['Flags'], 7).filter(([name]) => name)
     .map(([name, purpose, state, owner, added, removal, killSwitchTested]) => ({
       name, purpose, state, owner, added, removal, killSwitchTested,
       isOverdue: isDate(removal) && daysLeft(removal, now) < 0,
-      untested: !/^(evet|✅|var|yes\b)/i.test(killSwitchTested ?? ''),
+      untested: !(isValue(killSwitchTested, 'yes') || /^(✅|var\b)/i.test(killSwitchTested ?? '')),
     }));
 }
 
 // ---------- unit economics ----------
 export function unitEconomics(text) {
-  const e = labels(text);
+  const e = labels(normalize(text));
   const s = (k) => { const v = parseFloat(String(e[k] ?? '').replace(/[^\d.,-]/g, '').replace(',', '.')); return Number.isFinite(v) ? v : 0; };
-  const price = s('Fiyat (kullanıcı başı aylık)');
-  const commission = s('Ödeme komisyonu (%)');
-  const fixedCost = s('Sabit aylık maliyet');
-  const variableCost = s('Kullanıcı başı değişken maliyet (aylık)');
-  const target = s('Hedef aktif kullanıcı');
-  const freeShare = Math.min(99, s('Ücretsiz kullanıcı oranı (%)'));
+  const price = s('Price (per user, monthly)');
+  const commission = s('Payment fee (%)');
+  const fixedCost = s('Fixed monthly cost');
+  const variableCost = s('Variable cost per user (monthly)');
+  const target = s('Target active users');
+  const freeShare = Math.min(99, s('Free user share (%)'));
   if (!price && !fixedCost && !variableCost) return null;
   const margin = price * (1 - commission / 100) - variableCost;
   // Every paying user also carries the variable cost of the free users
@@ -210,7 +214,7 @@ export function unitEconomics(text) {
   const revenue = paying * price * (1 - commission / 100);
   const cost = fixedCost + target * variableCost;
   return {
-    currency: e['Para birimi'] || '',
+    currency: e['Currency'] || '',
     price, margin, effectiveMargin,
     breakEven: effectiveMargin > 0 ? Math.ceil(fixedCost / effectiveMargin) : null,
     target, revenue, cost, profit: revenue - cost,
@@ -219,19 +223,24 @@ export function unitEconomics(text) {
 }
 
 // ---------- feedback and metrics ----------
+const FEEDBACK_KINDS = ['bug', 'request', 'complaint', 'praise', 'question'];
+const FEEDBACK_STATES = ['new', 'planned', 'done', 'rejected', 'merged'];
+// A known value in either language becomes the English one; anything else stays as written
+const inEnglish = (v, keys) => VALUES[keys.find((k) => isValue(v, k))]?.en ?? v;
 export function feedback(text) {
-  const b = sections(text);
-  const records = tableRows(b['Gelen kutusu'], 9).map(([no, date, source, user, summary, kind, theme, priority, state]) => ({ no, date, summary, kind, theme, priority, state }));
-  const themes = tableRows(b['Temalar'], 3).map(([theme, count, feature, decision]) => ({ theme, count: parseInt(count, 10) || 0, feature, decision }))
+  const b = sections(normalize(text));
+  const records = tableRows(b['Inbox'], 9).map(([no, date, source, user, summary, kind, theme, priority, state]) =>
+    ({ no, date, summary, kind: inEnglish(kind, FEEDBACK_KINDS), theme, priority, state: inEnglish(state, FEEDBACK_STATES) }));
+  const themes = tableRows(b['Themes'], 3).map(([theme, count, feature, decision]) => ({ theme, count: parseInt(count, 10) || 0, feature, decision }))
     .sort((x, y) => y.count - x.count);
-  return { records, themes, newCount: records.filter((k) => /yeni/i.test(k.state)).length };
+  return { records, themes, newCount: records.filter((k) => k.state === 'new').length };
 }
 
 // Comprehension check answers (F-22, narrator mode); null without rows so the card is left out
 export function learning(text) {
-  // Only "doğru" / "yanlış" rows count; a skipped or malformed answer is not a wrong one
-  const rows = tableRows(sections(text)['Kayıtlar'], 4).filter(([, , , result]) => /^(doğru|yanlış)/i.test(result))
-    .map(([date, task, concept, result]) => ({ concept, right: /^doğru/i.test(result) }));
+  // Only right / wrong rows count; a skipped or malformed answer is not a wrong one
+  const rows = tableRows(sections(normalize(text))['Records'], 4).filter(([, , , result]) => isValue(result, 'right') || isValue(result, 'wrong'))
+    .map(([date, task, concept, result]) => ({ concept, right: isValue(result, 'right') }));
   if (!rows.length) return null;
   const missed = new Map();
   for (const r of rows) if (!r.right) missed.set(r.concept, (missed.get(r.concept) ?? 0) + 1);
@@ -240,17 +249,24 @@ export function learning(text) {
 }
 
 export function metrics(text) {
-  return tableRows(sections(text)['Kayıtlar'], 9)
+  return tableRows(sections(normalize(text))['Records'], 9)
     .map(([period, taskCount, duration, limit, fixes, reverts, duplicates, critical, acceptance]) => ({ period, taskCount, duration, limit, fixes, reverts, duplicates, critical, acceptance }));
 }
 
 // ---------- finding reports ----------
-export const FINDING_KINDS = { tech: 'Teknik', business: 'İş', security: 'Güvenlik', ux: 'UX', perf: 'Performans', legal: 'Hukuk' };
+export const FINDING_KINDS = { tech: 'Tech', business: 'Business', security: 'Security', ux: 'UX', perf: 'Performance', legal: 'Legal' };
+// Pre-3.48 report tables name the area in Turkish
+const FINDING_KINDS_TR = { tech: 'Teknik', business: 'İş', security: 'Güvenlik', ux: 'UX', perf: 'Performans', legal: 'Hukuk' };
+const findingKind = (v) => {
+  const low = [v.toLocaleLowerCase('tr'), v.toLowerCase()];
+  const named = Object.keys(FINDING_KINDS).find((k) => [k, FINDING_KINDS[k], FINDING_KINDS_TR[k]].some((n) => low.includes(n.toLocaleLowerCase('tr')) || low.includes(n.toLowerCase())));
+  return named ?? low[1];
+};
 export function findingReports(text) {
   const count = (x) => { const n = parseInt(String(x ?? '').trim().replace(/^[^\d-]+/, ''), 10); return Number.isFinite(n) ? n : null; };
-  const rows = tableRows(sections(text)['Raporlar'], 7)
+  const rows = tableRows(sections(normalize(text))['Reports'], 7)
     .map(([date, kind, health, previous, findings, critical, report]) => ({
-      date, kind: kind.toLowerCase(), health: count(health), previous: count(previous), findings: count(findings), critical: count(critical) ?? 0, report,
+      date, kind: findingKind(kind), health: count(health), previous: count(previous), findings: count(findings), critical: count(critical) ?? 0, report,
     }))
     .filter((r) => r.date && r.health != null);
   const latest = {};
@@ -283,7 +299,7 @@ export function producedAssets(root) {
 
 // ---------- Spend alarms (docs/operations/spend-alarms.md) ----------
 export function spendAlarms(text, now = Date.now()) {
-  return tableRows(sections(text)['Alarmlar'], 6).filter(([service]) => service)
+  return tableRows(sections(normalize(text))['Alarms'], 6).filter(([service]) => service)
     .map(([service, kind, amount, thresholds, where, lastCheck]) => ({
       service, kind, amount, thresholds, where, lastCheck,
       unset: !/\d/.test(amount ?? ''),
@@ -300,17 +316,21 @@ export function councilMinutes(root) {
     const text = readText(path.join(folder, f));
     const a = {};
     for (const [, k, v] of text.matchAll(/\*\*([^*:]+):\*\*\s*([^·\n]*)/g)) a[k.trim()] ??= v.trim();
-    const ranking = tableRows(sections(text)['3. Toplu sıralama'], 3).filter(([g]) => /^[A-Z]$/.test(g));
-    const idsByLetter = Object.fromEntries([...(sections(text)['Kimlikler'] ?? '').matchAll(/([A-Z])\s*=\s*([^·\n]+)/g)].map((m) => [m[1], m[2].trim()]));
+    // English minutes, or Turkish ones written before 3.48 (they stay as they are: a council record is history)
+    const pick = (en, tr) => a[en] ?? a[tr];
+    const b = sections(text);
+    const ranking = tableRows(findSection(b, '3.'), 3).filter(([g]) => /^[A-Z]$/.test(g));
+    const idsByLetter = Object.fromEntries([...(b['IDs'] ?? b['Kimlikler'] ?? '').matchAll(/([A-Z])\s*=\s*([^·\n]+)/g)].map((m) => [m[1], m[2].trim()]));
+    const consensus = pick('Consensus', 'Uzlaşma')?.match(/\d+/)?.[0];
     return {
       file: `docs/workflow/council/${f}`,
-      topic: text.match(/^#\s+Konsey:\s*(.+)$/m)?.[1] ?? f.replace(/\.md$/, ''),
-      date: a['Tarih'] ?? f.slice(0, 10),
-      kind: a['Tür'] ?? '-',
-      decision: a['Karar'] || a['Öneri'] || null,
-      consensus: a['Uzlaşma']?.match(/\d+/) ? Number(a['Uzlaşma'].match(/\d+/)[0]) : null,
-      disputed: Number(a['Tartışmalı'] ?? 0) || 0,
-      eliminated: Number(a['Elenen'] ?? 0) || 0,
+      topic: text.match(/^#\s+(?:Council|Konsey):\s*(.+)$/m)?.[1] ?? f.replace(/\.md$/, ''),
+      date: pick('Date', 'Tarih') ?? f.slice(0, 10),
+      kind: pick('Type', 'Tür') ?? '-',
+      decision: pick('Decision', 'Karar') || pick('Recommendation', 'Öneri') || null,
+      consensus: consensus ? Number(consensus) : null,
+      disputed: Number(pick('Disputed', 'Tartışmalı') ?? 0) || 0,
+      eliminated: Number(pick('Eliminated', 'Elenen') ?? 0) || 0,
       ranking: ranking.map(([g, avg]) => ({ opinion: g, who: idsByLetter[g] ?? null, average: avg })),
     };
   }).sort((x, y) => y.date.localeCompare(x.date) || y.file.localeCompare(x.file));