@omerrgocmen/crewctl 1.0.0

package/orchestrator/skills/security-review.md

@@ -0,0 +1,26 @@
+---
+name: security-review
+description: Değişiklikleri yaygın güvenlik açıkları açısından denetleme rehberi (OWASP odaklı)
+category: security
+appliesTo: [review]
+match: [guvenlik, güvenlik, security, auth, kimlik, yetki, injection, xss, csrf, secret, token, sql, sifre, şifre, zafiyet]
+---
+
+# Beceri: Güvenlik İncelemesi
+
+Salt okunur denetle; kanıtla göster. Teorik risk yerine bu kod tabanında sömürülebilir yolları ara.
+
+## Kontrol alanları
+
+- **Girdi doğrulama & injection:** SQL/NoSQL/komut/şablon injection; parametreli sorgu ve güvenli API kullanımı.
+- **Çıktı kodlama & XSS:** Kullanıcı verisi güvenli kaçışla mı render ediliyor; `dangerouslySetInnerHTML`/`eval` var mı?
+- **Kimlik & yetki:** Kimlik doğrulama ve yetki kontrolü her hassas yolda var mı? IDOR / eksik erişim kontrolü?
+- **Sırlar:** Kod, log veya istemciye sızan API anahtarı, parola, token var mı? `.env`/secret yönetimi doğru mu?
+- **Veri akışı:** Güvenilmeyen girdinin dosya yolu, komut, URL veya deserializasyona ulaştığı yerler.
+- **Bağımlılık & yapılandırma:** Bilinen zafiyetli paket, güvensiz varsayılan, açık CORS, eksik güvenlik başlıkları.
+- **Kripto & rastgelelik:** Zayıf hash/şifreleme, tahmin edilebilir token, sabit IV/anahtar.
+
+## Teslimat
+
+Her bulgu için: önem (HIGH/MEDIUM/LOW), dosya:satır, sömürü senaryosu ve somut düzeltme. Yıkıcı test veya
+gerçek exploit **çalıştırma**; yalnızca statik inceleme yap. Sonunda `VERDICT: PASS` veya `VERDICT: FAIL` yaz.

package/orchestrator/skills/semantic-versioning.md

@@ -0,0 +1,17 @@
+---
+name: semantic-versioning
+description: Kamuya açık sözleşme değişimine göre major, minor veya patch sürüm etkisini belirle; paket ve release işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [semver, semantic versioning, sürümleme, version bump, major, minor, patch, breaking]
+---
+
+# Semantik Sürümleme
+
+1. Önce “kamuya açık API”yi proje bağlamında tanımla: kod, CLI, şema, dosya biçimi veya davranış.
+2. Uyumlu hata düzeltmesini PATCH, geriye uyumlu yeteneği MINOR, kırıcı sözleşmeyi MAJOR olarak sınıflandır.
+3. `0.y.z`, prerelease ve proje-özel politikasını mevcut belgeden kontrol et; varsayma.
+4. Bağımlılık güncellemesinin tüketici sözleşmesine gerçek etkisini değerlendir.
+5. Sürüm kararını changelog ve migration notuyla tutarlı kıl.
+
+Yalnızca commit türüne bakarak sürüm belirleme; gözlemlenebilir tüketici etkisini kanıtla.

package/orchestrator/skills/seo-on-page.md

@@ -0,0 +1,16 @@
+---
+name: seo-on-page
+description: Sayfa niyeti, başlık, içerik yapısı ve snippet öğelerini kullanıcı odaklı optimize et; on-page SEO ve içerik güncellemede kullan.
+category: seo
+appliesTo: [plan, implement, review]
+match: [on page seo, sayfa içi seo, title tag, meta description, heading, search intent, arama niyeti, keyword]
+---
+
+# Sayfa İçi SEO
+
+- Hedef sorgu kümesinin gerçek kullanıcı niyetini ve sayfanın tek birincil amacını belirle.
+- Benzersiz, açık ve içeriği doğru temsil eden title ile H1 yaz; doğal dili bozarak anahtar kelime doldurma.
+- İlk bölümde soruyu doğrudan yanıtla, başlıklarla taranabilir yapı ve özgün kanıt/örnek sun.
+- Meta description'ı kısa değer özeti olarak yaz; garanti veya yanıltıcı vaat kullanma.
+- Açıklayıcı URL, görsel alt metni ve ilgili iç bağlantıları kullanıcı yolculuğuna göre düzenle.
+- Canonical/index durumunu, mobil görünümü ve render edilmiş HTML'i doğrula; meta keywords ekleme.

package/orchestrator/skills/seo-structured-data.md

@@ -0,0 +1,16 @@
+---
+name: seo-structured-data
+description: Görünür sayfa içeriğini doğru Schema.org/JSON-LD işaretlemesiyle ifade et; structured data ve rich result işlerinde kullan.
+category: seo
+appliesTo: [plan, implement, review]
+match: [structured data, yapılandırılmış veri, schema.org, json-ld, rich result, breadcrumb schema, product schema]
+---
+
+# Yapılandırılmış Veri
+
+1. Sayfanın görünür birincil varlığına ve arama motorunun desteklediği özelliğe uygun en dar türü seç.
+2. Yalnız kullanıcıya gerçekten gösterilen, doğru ve güncel alanları işaretle; sahte review/rating üretme.
+3. JSON-LD'yi tek ve tutarlı `@id` ilişkileriyle kur; Organization, WebSite, WebPage ve ana varlığı gerektiğinde bağla.
+4. Required/recommended alan, URL, tarih, para birimi ve stok değerlerini gerçek veri kaynağına bağla.
+5. Syntax ve rich result doğrulamasını çalıştır; render edilmiş sayfada içerikle eşleştiğini kontrol et.
+6. Uygunluk veya zengin sonuç garantisi verme; hata ve güncelleme sahipliğini belgeye ekle.

package/orchestrator/skills/seo-technical-audit.md

@@ -0,0 +1,16 @@
+---
+name: seo-technical-audit
+description: Bir sitenin taranabilirlik, indekslenebilirlik, canonical, performans ve render sorunlarını denetle; teknik SEO işlerinde kullan.
+category: seo
+appliesTo: [plan, implement, review, research]
+match: [technical seo, teknik seo, crawl, index, canonical, robots, sitemap, search console, crawl budget]
+---
+
+# Teknik SEO Denetimi
+
+1. Önemli URL şablonlarını ve istenen index durumunu envanterle; örnek URL'leri HTTP ve render edilmiş DOM düzeyinde incele.
+2. Status/redirect zinciri, robots kuralları, meta robots, canonical ve sitemap tutarlılığını kontrol et.
+3. İç linkle keşif, orphan sayfa, pagination, faceted URL ve duplicate içerik kümelerini ara.
+4. Başlık, ana içerik ve linklerin JavaScript başarısızken erişilebilirliğini değerlendir.
+5. Mobil kullanılabilirlik, Core Web Vitals ve büyük kaynak darboğazlarını kanıtla.
+6. Bulguları etki, kapsam, kanıt ve düzeltmeyle sırala; sıralama garantisi verme ve search engine yönergelerini baypas etme.

package/orchestrator/skills/sql-query-review.md

@@ -0,0 +1,16 @@
+---
+name: sql-query-review
+description: SQL sorgusunu doğruluk, güvenlik, plan ve veri hacmi açısından incele; sorgu yazma veya performans işlerinde kullan.
+category: software
+appliesTo: [implement, review]
+match: [sql, query, sorgu, explain, index, join, database performance, n+1]
+---
+
+# SQL Sorgu İncelemesi
+
+- Parametre bağlamayı ve güvenilmeyen girdinin sorgu metnine karışmadığını doğrula.
+- Join kardinalitesi, null semantiği, duplicate satır, filtre sırası ve sınır durumlarını örnek veriyle kontrol et.
+- Beklenen veri hacminde EXPLAIN/planı incele; full scan, kötü tahmin ve gereksiz sort'u ara.
+- Seçilen kolonları daralt, sayfalamayı kararlı sıraya bağla ve N+1 erişimi önle.
+- Transaction, kilit ve eşzamanlı güncelleme etkisini yazma sorgularında değerlendir.
+- İndeksi yalnızca gerçek sorgu deseniyle gerekçelendir; önce/sonra ölçümü ve doğruluk testi sun.

package/orchestrator/skills/supply-chain-security.md

@@ -0,0 +1,16 @@
+---
+name: supply-chain-security
+description: Kaynak, bağımlılık, build ve yayın zincirinde bütünlük ve en az yetkiyi denetle; paket ve CI güvenliğinde kullan.
+category: security
+appliesTo: [plan, implement, review]
+match: [supply chain, tedarik zinciri, sbom, provenance, dependency confusion, package security, artifact signing]
+---
+
+# Tedarik Zinciri Güvenliği
+
+1. Kaynaktan yayınlanan artefakta kadar repository, runner, registry ve paket güven sınırlarını çıkar.
+2. Bağımlılık kaynağını/lockfile bütünlüğünü doğrula; namespace ve dependency confusion riskini kontrol et.
+3. CI eylemlerini ve araç sürümlerini sabitle, izinleri daralt, güvenilmeyen koddan sırları ayır.
+4. Build'i temiz ortamda tekrarlanabilir yap; SBOM/provenance ve artefakt checksum/imza üretimini değerlendir.
+5. Yayın kimliğini kısa ömürlü ve onaylı kullan; registry sahipliği ile kurtarma hesaplarını koru.
+6. İhlal halinde paket iptali, anahtar rotation ve tüketici iletişimi yolunu belgeleyip doğrula.

package/orchestrator/skills/test-strategy.md

@@ -0,0 +1,16 @@
+---
+name: test-strategy
+description: Riski doğru test katmanına dağıtan yalın bir doğrulama stratejisi kur; özellik veya proje planlamasında kullan.
+category: testing
+appliesTo: [plan, implement, review]
+match: [test strategy, test plan, test stratejisi, kalite planı, coverage, test pyramid, doğrulama planı]
+---
+
+# Test Stratejisi
+
+1. Kritik kullanıcı akışlarını, güven sınırlarını ve en pahalı hata türlerini sırala.
+2. Saf mantığı birim, bileşen sınırını entegrasyon, az sayıdaki kritik akışı uçtan uca testlere ver.
+3. Güvenlik, performans, erişilebilirlik ve migration gibi işlev dışı riskleri ayrıca ele al.
+4. Her risk için gözlemlenebilir oracle, veri ihtiyacı ve çalıştırma katmanı belirle.
+5. Hızlı PR kapısı ile daha pahalı gece/release kontrollerini ayır.
+6. Kapsam yüzdesi yerine yakalanan risk, güvenilirlik ve tanılama kalitesini ölç.

package/orchestrator/skills/threat-modeling.md

@@ -0,0 +1,16 @@
+---
+name: threat-modeling
+description: Varlık, güven sınırı ve kötüye kullanım yollarından öncelikli tehditler çıkar; yeni özellik veya mimari güvenlik planında kullan.
+category: security
+appliesTo: [plan, review]
+match: [threat model, tehdit modeli, stride, attack surface, saldırı yüzeyi, abuse case, trust boundary]
+---
+
+# Tehdit Modelleme
+
+1. Korunacak varlıkları, aktörleri, veri akışlarını ve dış bağımlılıkları çiz.
+2. Kimliğin veya verinin güven düzeyi değiştirdiği sınırları ve giriş noktalarını işaretle.
+3. Spoofing, tampering, repudiation, disclosure, denial ve privilege escalation kötüye kullanımlarını somut akışlara uygula.
+4. Olasılık ile etkiyi birlikte değerlendir; teorik liste yerine öncelikli saldırı yolları üret.
+5. Her yüksek risk için önleme, algılama, sorumlu ve doğrulama testi tanımla.
+6. Kabul edilen riski ve varsayımı kaydet; modelin kapsamını değişiklikle birlikte güncelle.

package/orchestrator/skills/unit-testing.md

@@ -0,0 +1,16 @@
+---
+name: unit-testing
+description: Saf davranışı hızlı, yalıtılmış ve dayanıklı birim testleriyle kanıtla; fonksiyon veya sınıf testlerinde kullan.
+category: testing
+appliesTo: [implement, review]
+match: [unit test, birim testi, jest, vitest, pytest, xunit, mock, function test]
+---
+
+# Birim Testi
+
+- Tek bir davranış ve kamuya açık giriş noktası seç; uygulama ayrıntısını test etme.
+- Arrange/Act/Assert akışını belirgin tut ve test adında koşul ile beklenen sonucu yaz.
+- Eşdeğer sınıfları, sınır değerleri ve hata yollarını az ama anlamlı vakayla kapsa.
+- Saat, rastgelelik ve I/O bağımlılıklarını sınırda enjekte et; test edilen birimi mock'lama.
+- Her test kendi verisini kursun, küresel durumu geri temizlesin ve sıra bağımsız olsun.
+- Hata mesajlarının neyin bozulduğunu gösterebildiğini kontrol edip ilgili test komutunu çalıştır.

package/orchestrator/skills/write-tests.md

@@ -0,0 +1,28 @@
+---
+name: write-tests
+description: Değişen davranış için hedefli, güvenilir test yazma ve çalıştırma disiplini
+category: testing
+appliesTo: [implement, review]
+match: [test, tests, jest, pytest, mocha, vitest, coverage, kapsam, birim, unit, e2e, dogrula, doğrula]
+---
+
+# Beceri: Test Yazma
+
+Testin amacı davranışı kanıtlamaktır; yeşil göstermek değil.
+
+## Yaklaşım
+
+- **Davranışı test et, uygulamayı değil:** Gözlemlenebilir girdi→çıktı ve yan etkilere odaklan; iç
+  ayrıntıya kilitlenen kırılgan testlerden kaçın.
+- **Önce risk:** En olası hata yollarını ve sınır durumlarını (boş, sıfır, negatif, çok büyük, eşzamanlı,
+  hatalı girdi) kapsa. Mutlu yol tek başına yetmez.
+- **Bağımsız ve deterministik:** Testler sıralamadan, saatten, ağdan ve paylaşılan durumdan bağımsız olsun;
+  dış bağımlılıkları uygun yerde taklit et (mock/fake).
+- **Tek iddia teması:** Her test tek bir davranışı doğrulasın; isim ne test edildiğini anlatsın.
+- **Mevcut düzene uy:** Projenin test çatısını, klasör ve adlandırma kurallarını izle.
+
+## Doğrulama
+
+Testleri gerçekten çalıştır ve sonucu raporla. Yeni testin, düzeltmeden önce **kırmızı** olup düzeltmeden
+sonra **yeşile** döndüğünü mümkünse göster. Testi geçirmek için üretim kodunu bozma veya kontrolü gevşetme.
+Çalıştırılamayan testi "geçti" gibi sunma; nedenini belirt.

package/orchestrator/src/checkpoints.js

@@ -0,0 +1,187 @@
+// checkpoints.js — gorev-basi otomatik surumleme (sifir bagimlilik).
+// Her gorev CALISMADAN ONCE calisma klasorunun bir surumu (checkpoint) alinir; ajan kodu
+// bozarsa tek tikla o surume donulur. Depolama daima birebir dosya KOPYASIDIR (deterministik,
+// git durumundan bagimsiz, geri-alinabilir). "git-farkinda": klasor bir git deposuysa hangi
+// dosyalarin yedeklenecegi `git ls-files` ile belirlenir (boylece .gitignore'a uyulur ve
+// build ciktilari/gecici dosyalar surume girmez); depoysa degilse guvenli bir walk kullanilir.
+// NOT: fs.cpSync Windows'ta non-ASCII yollarda (or. C:\Users\Ömer) cokebiliyor; tum kopyalar
+// Unicode-guvenli fs.copyFileSync ile yapilir.
+const { spawnSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const store = require("./store");
+
+const isWin = process.platform === "win32";
+const CP_ROOT = path.join(store.ROOT, "state", "checkpoints");
+const MAX_FILES = 5000;            // Bundan buyuk klasorlerde surum alma (guvenlik/performans).
+const MAX_BYTES = 200 * 1024 * 1024;
+const DEFAULT_RETENTION = 20;
+
+// snapshotDir (engine) ile AYNI ignore mantigi: node_modules/.git ve orkestratorun kendi
+// runtime durumu (queue/state/memory) surume girmemeli — aksi halde checkpoint kendi icine
+// kopyalanip sisebilir.
+function ignored(rel) {
+  const r = String(rel).replace(/\\/g, "/");
+  return r.includes("node_modules") || r.includes(".git/") || r === ".git" || r.startsWith(".git/") ||
+    r.startsWith("orchestrator/queue") || r.startsWith("orchestrator/state") ||
+    r.startsWith("orchestrator/memory") || r.startsWith("orchestrator/node_modules");
+}
+
+function isGitRepo(cwd) {
+  try {
+    const r = spawnSync("git", ["-C", cwd, "rev-parse", "--is-inside-work-tree"], {
+      encoding: "utf8", timeout: 8000, windowsHide: true, shell: isWin,
+    });
+    return r.status === 0 && /true/i.test(String(r.stdout || ""));
+  } catch { return false; }
+}
+
+// Tracked + izlenmeyen ama .gitignore'da olmayan dosyalar; NUL ayrac unicode/bosluk-guvenli.
+function gitFileList(cwd) {
+  try {
+    const r = spawnSync("git", ["-C", cwd, "ls-files", "--cached", "--others", "--exclude-standard", "-z"], {
+      encoding: "utf8", timeout: 20000, maxBuffer: 64 * 1024 * 1024, windowsHide: true, shell: isWin,
+    });
+    if (r.status !== 0) return null;
+    return String(r.stdout || "").split("\0").filter(Boolean);
+  } catch { return null; }
+}
+
+function walkFileList(cwd) {
+  const out = [];
+  let count = 0;
+  const walk = (abs, rel) => {
+    if (count > MAX_FILES + 1) return;
+    let entries;
+    try { entries = fs.readdirSync(abs, { withFileTypes: true }); } catch { return; }
+    for (const entry of entries) {
+      const childRel = rel ? `${rel}/${entry.name}` : entry.name;
+      if (ignored(childRel)) continue;
+      if (entry.isSymbolicLink()) continue; // Sembolik baglantilari izleme (klasor disina cikmasin).
+      const childAbs = path.join(abs, entry.name);
+      if (entry.isDirectory()) walk(childAbs, childRel);
+      else { out.push(childRel); count++; }
+    }
+  };
+  walk(cwd, "");
+  return out;
+}
+
+// Yedeklenecek dosya listesi (calisma klasorune GORE goreli yollar).
+function fileList(cwd) {
+  if (isGitRepo(cwd)) {
+    const git = gitFileList(cwd);
+    // Bos liste (or. calisma klasoru gitignore'da) walk'a duser; aksi halde surum bos kalir
+    // ve restore hicbir sey yapamaz. Dolu liste .gitignore'a uyan git-farkinda yoldur.
+    if (git && git.length) return { files: git.filter((rel) => !ignored(rel)), backend: "git" };
+  }
+  return { files: walkFileList(cwd), backend: "copy" };
+}
+
+// Yol guvenligi: hedef daima cwd icinde kalmali (path traversal / sembolik kacis engeli).
+function within(root, rel) {
+  const base = path.resolve(root);
+  const target = path.resolve(base, rel);
+  return target === base || target.startsWith(base + path.sep) ? target : null;
+}
+
+function ensureRoot() { fs.mkdirSync(CP_ROOT, { recursive: true }); }
+
+function readManifest(id) {
+  try { return JSON.parse(fs.readFileSync(path.join(CP_ROOT, path.basename(String(id)), "manifest.json"), "utf8")); }
+  catch { return null; }
+}
+
+function enforceRetention(cwd, retention) {
+  const keep = Math.max(1, Number(retention) || DEFAULT_RETENTION);
+  try {
+    const mine = fs.readdirSync(CP_ROOT)
+      .map(readManifest).filter((m) => m && path.resolve(m.cwd) === path.resolve(cwd))
+      .sort((a, b) => (a.at < b.at ? 1 : -1));
+    for (const m of mine.slice(keep)) {
+      try { fs.rmSync(path.join(CP_ROOT, m.id), { recursive: true, force: true }); } catch {}
+    }
+  } catch {}
+}
+
+// Calisma klasorunun mevcut halinden bir surum (checkpoint) olusturur. Basarisiz/atlanmis
+// durumda gorevi ASLA oldurmez; {ok:false,...} doner ve cagiran log'lar.
+function createCheckpoint(cwd, meta = {}) {
+  try {
+    ensureRoot();
+    const resolvedCwd = path.resolve(cwd);
+    if (!fs.existsSync(resolvedCwd)) return { ok: false, skipped: true, reason: "Calisma klasoru bulunamadi." };
+    const { files, backend } = fileList(resolvedCwd);
+    if (files.length > MAX_FILES) return { ok: false, skipped: true, reason: `Klasor cok buyuk (${files.length} dosya > ${MAX_FILES}); surum alinmadi.` };
+    const id = `cp-${new Date().toISOString().replace(/[-:T.]/g, "").slice(0, 17)}-${Math.random().toString(36).slice(2, 7)}`;
+    const dir = path.join(CP_ROOT, id);
+    const filesDir = path.join(dir, "files");
+    fs.mkdirSync(filesDir, { recursive: true });
+    const stored = [];
+    let bytes = 0;
+    for (const rel of files) {
+      const src = within(resolvedCwd, rel);
+      if (!src) continue;
+      let st;
+      try { st = fs.lstatSync(src); } catch { continue; }
+      if (!st.isFile()) continue; // Sembolik baglanti / klasor / silinmis izlenen dosyayi atla.
+      bytes += st.size;
+      if (bytes > MAX_BYTES) { try { fs.rmSync(dir, { recursive: true, force: true }); } catch {} return { ok: false, skipped: true, reason: `Klasor cok buyuk (>${Math.round(MAX_BYTES / 1048576)}MB); surum alinmadi.` }; }
+      const dest = path.join(filesDir, rel);
+      try { fs.mkdirSync(path.dirname(dest), { recursive: true }); fs.copyFileSync(src, dest); stored.push(rel); } catch {}
+    }
+    const manifest = {
+      id, at: new Date().toISOString(), cwd: resolvedCwd, backend,
+      fileCount: stored.length, bytes, files: stored,
+      taskId: meta.taskId || null, label: String(meta.label || "").slice(0, 300), kind: meta.kind || "pre-task",
+    };
+    fs.writeFileSync(path.join(dir, "manifest.json"), JSON.stringify(manifest, null, 2));
+    enforceRetention(resolvedCwd, meta.retention);
+    return { ok: true, ...manifest };
+  } catch (error) { return { ok: false, error: error.message }; }
+}
+
+// Bir surumu geri yukler. Once MEVCUT hali de bir surum yapar (redo guvenligi), sonra:
+// (1) surumden SONRA olusan dosyalari siler, (2) surumdeki dosyalari geri yazar.
+function restoreCheckpoint(id, opts = {}) {
+  const manifest = readManifest(id);
+  if (!manifest) return { ok: false, error: "Surum bulunamadi." };
+  const cwd = path.resolve(manifest.cwd);
+  if (!fs.existsSync(cwd)) return { ok: false, error: "Calisma klasoru bulunamadi." };
+  let redoId = null;
+  if (opts.createRedo !== false) {
+    const redo = createCheckpoint(cwd, { taskId: manifest.taskId, kind: "pre-restore", label: `Geri alma oncesi (${manifest.id})`, retention: opts.retention });
+    if (redo.ok) redoId = redo.id;
+  }
+  const filesDir = path.join(CP_ROOT, path.basename(String(id)), "files");
+  const keep = new Set(manifest.files);
+  // (1) Surumden sonra olusturulmus (surumde olmayan) dosyalari sil.
+  let deleted = 0;
+  for (const rel of fileList(cwd).files) {
+    if (keep.has(rel)) continue;
+    const target = within(cwd, rel);
+    if (!target) continue;
+    try { if (fs.existsSync(target)) { fs.rmSync(target, { force: true }); deleted++; } } catch {}
+  }
+  // (2) Surumdeki dosyalari birebir geri yaz.
+  let restored = 0;
+  for (const rel of manifest.files) {
+    const src = path.join(filesDir, rel);
+    const dest = within(cwd, rel);
+    if (!dest) continue;
+    try { if (!fs.existsSync(src)) continue; fs.mkdirSync(path.dirname(dest), { recursive: true }); fs.copyFileSync(src, dest); restored++; } catch {}
+  }
+  return { ok: true, id: manifest.id, cwd, restored, deleted, redoId };
+}
+
+// Listeleme: dosya listesini disari vermeden ozet meta doner (istege bagli cwd filtresi).
+function listCheckpoints(cwd) {
+  try {
+    ensureRoot();
+    const all = fs.readdirSync(CP_ROOT).map(readManifest).filter(Boolean);
+    const filtered = cwd ? all.filter((m) => path.resolve(m.cwd) === path.resolve(cwd)) : all;
+    return filtered.sort((a, b) => (a.at < b.at ? 1 : -1)).map(({ files, ...rest }) => rest);
+  } catch { return []; }
+}
+
+module.exports = { CP_ROOT, createCheckpoint, restoreCheckpoint, listCheckpoints, readManifest, fileList, isGitRepo, _internals: { ignored, within, walkFileList } };