kortext 2.2.0 → 3.0.0

package/scripts/kortext-bulk-plan.py

@@ -1,63 +0,0 @@
-#!/usr/bin/env python3
-from __future__ import annotations
-
-import json
-import subprocess
-import sys
-from pathlib import Path
-
-
-SCRIPT_ADD = Path(__file__).with_name("kortext-backlog-add.py")
-
-
-def run_add_task(item_type: str, epic: str | None, item_id: str, title: str, persona: str) -> None:
-    cmd = [
-        sys.executable,
-        str(SCRIPT_ADD),
-        "--type",
-        item_type,
-        "--id",
-        item_id,
-        "--title",
-        title,
-        "--persona",
-        persona,
-    ]
-    if epic:
-        cmd.extend(["--epic", epic])
-    subprocess.run(cmd, check=True)
-
-
-def main() -> None:
-    if len(sys.argv) < 2:
-        raise SystemExit("Kullanım: kortext-bulk-plan.py <plan.json>")
-
-    data = json.loads(Path(sys.argv[1]).read_text())
-
-    for epic in data.get("epics", []):
-        epic_id = epic.get("id")
-        for item in epic.get("tasks", []):
-            print(f"⌛ Oluşturuluyor: {item.get('id')}...")
-            run_add_task(
-                item.get("type", "task"),
-                epic_id,
-                item.get("id"),
-                item.get("title"),
-                item.get("persona", "+persona"),
-            )
-
-    for debt in data.get("debts", []):
-        print(f"⌛ Oluşturuluyor: {debt.get('id')}...")
-        run_add_task(
-            "debt",
-            None,
-            debt.get("id"),
-            debt.get("title"),
-            debt.get("persona", "+persona"),
-        )
-
-    print("\n🚀 Toplu planlama başarıyla tamamlandı!")
-
-
-if __name__ == "__main__":
-    main()

package/scripts/kortext-cli.py

@@ -1,295 +0,0 @@
-#!/usr/bin/env python3
-"""
-Kortext CLI — Ana Komut Dağıtıcı
----------------------------------
-npm install sonrası `kortext` binary'si bu dosyayı çağırır. Tüm alt komutlar
-buradan yönlendirilir. Yazılım bilmeyen kullanıcı için Türkçe açıklamalı
-komut tablosu içerir.
-
-Standart kütüphane dışında bağımlılığı yoktur. Python 3.10+ gereklidir.
-"""
-from __future__ import annotations
-
-import argparse
-import os
-import subprocess
-import sys
-from pathlib import Path
-
-
-# Kortext kurulumunun kök dizini. Bu dosya scripts/ altında olduğu için
-# bir üst klasör root sayılır.
-ROOT = Path(__file__).resolve().parents[1]
-SCRIPTS = ROOT / "scripts"
-HOOKS = ROOT / "hooks"
-WORKFLOWS = ROOT / "workflows"
-
-
-# Komut → Türkçe açıklama eşlemesi. `kortext help` çıktısında kullanılır.
-COMMAND_HELP: list[tuple[str, str]] = [
-    ("init", "Kortext'i mevcut çalışma dizinine kur (git hook + lock)."),
-    ("start <workflow>", "Workflow dosyasının başlığını ve özetini ekrana bas."),
-    ("status", "Aktif ajanları, son handover'ı ve oturum özetini göster."),
-    ("check", "Tutarlılık + context + backlog sağlık kontrollerini sırayla çalıştır."),
-    ("lock <file>", "Paylaşımlı dosyaya kilit al (eşzamanlı yazma çakışmasını önler)."),
-    ("unlock <file>", "Daha önce alınmış kilidi serbest bırak."),
-    ("list-locks", "Aktif tüm kilitleri listele."),
-    ("handover ...", "Görev devir kaydı oluştur (handover.md'ye satır ekler)."),
-    ("add ...", "Backlog'a yeni task/bug/debt item'ı ekle."),
-    ("transition ...", "Item status geçişi yap (To Do → In Progress → ...)."),
-    ("health", "Backlog sağlık raporunu üret (stale/blocked/review)."),
-    ("help", "Bu yardım listesini göster."),
-]
-
-
-def _run_python_script(script_name: str, args: list[str], env_overrides: dict[str, str] | None = None) -> int:
-    """Bir Python scriptini subprocess olarak çalıştırır ve exit code'unu döndürür."""
-    script_path = SCRIPTS / script_name
-    if not script_path.exists():
-        print(f"❌ Script bulunamadı: {script_path}", file=sys.stderr)
-        return 127
-
-    cmd = [sys.executable, str(script_path), *args]
-    env = os.environ.copy()
-    if env_overrides:
-        env.update(env_overrides)
-
-    # Subprocess çıktısı doğrudan terminale aksın; hata kodunu koruyalım.
-    result = subprocess.run(cmd, env=env)
-    return result.returncode
-
-
-def _run_shell_script(script_path: Path, args: list[str], env_overrides: dict[str, str] | None = None) -> int:
-    """Bir shell scriptini çalıştırır."""
-    if not script_path.exists():
-        print(f"❌ Shell script bulunamadı: {script_path}", file=sys.stderr)
-        return 127
-
-    cmd = ["bash", str(script_path), *args]
-    env = os.environ.copy()
-    if env_overrides:
-        env.update(env_overrides)
-
-    result = subprocess.run(cmd, env=env)
-    return result.returncode
-
-
-def cmd_init(args: argparse.Namespace) -> int:
-    """`kortext init` — kortext-init.sh'i tetikler. Runtime bilgisi env ile geçer."""
-    env: dict[str, str] = {}
-    if args.runtime:
-        env["KORTEXT_RUNTIME"] = args.runtime
-    # kortext-init.sh git hook kurulumunu da yapar.
-    return _run_shell_script(HOOKS / "kortext-init.sh", ["--install-hooks"], env)
-
-
-def cmd_start(args: argparse.Namespace) -> int:
-    """`kortext start <workflow>` — workflow dosyasının ilk başlığını basar.
-
-    Tam dosya adı bilinmiyorsa numara/anahtar kelimeyle eşleştirir
-    (ör. `analysis` → `01a-analysis-pipeline.md`).
-    """
-    workflow_arg = args.workflow.lower().strip()
-    if not WORKFLOWS.exists():
-        print(f"❌ workflows klasörü bulunamadı: {WORKFLOWS}", file=sys.stderr)
-        return 1
-
-    # En iyi eşleşmeyi bul: dosya adı içinde anahtar kelime geçen ilk dosya.
-    candidates = sorted(WORKFLOWS.glob("*.md"))
-    matches = [p for p in candidates if workflow_arg in p.stem.lower()]
-    if not matches:
-        print(f"❌ Eşleşen workflow bulunamadı: '{workflow_arg}'", file=sys.stderr)
-        print("\nMevcut workflow'lar:", file=sys.stderr)
-        for p in candidates:
-            print(f"  • {p.stem}", file=sys.stderr)
-        return 1
-
-    target = matches[0]
-    text = target.read_text(errors="ignore")
-    lines = text.splitlines()
-    title_line = next((l for l in lines if l.startswith("# ")), target.stem)
-
-    print("=" * 60)
-    print(f"  KORTEXT WORKFLOW BAŞLADI")
-    print("=" * 60)
-    print(f"\nDosya  : {target.relative_to(ROOT)}")
-    print(f"Başlık : {title_line}")
-    # Workflow özeti olarak ilk paragrafı yazdır.
-    summary_lines: list[str] = []
-    in_summary = False
-    for line in lines:
-        if line.startswith("# "):
-            in_summary = True
-            continue
-        if in_summary:
-            if line.startswith("#"):
-                break
-            if line.strip():
-                summary_lines.append(line.strip())
-    if summary_lines:
-        print(f"\nÖzet  :\n  {summary_lines[0]}")
-    print("\n→ Akışı yürütmek için dosyayı oku ve adımları sırayla uygula.")
-    return 0
-
-
-def cmd_status(_args: argparse.Namespace) -> int:
-    """`kortext status` — oturum özetini gösterir."""
-    return _run_python_script("kortext-session-start.py", [])
-
-
-def cmd_check(_args: argparse.Namespace) -> int:
-    """`kortext check` — üç ardışık sağlık kontrolü çalıştırır."""
-    print("🔍 1/3 Tutarlılık kontrolü...")
-    rc1 = _run_python_script("kortext-consistency-check.py", [])
-    print("\n🔍 2/3 Context kontrolü...")
-    rc2 = _run_python_script("kortext-context-check.py", [])
-    print("\n🔍 3/3 Backlog sağlık kontrolü...")
-    rc3 = _run_python_script("kortext-backlog-health.py", [])
-
-    # Herhangi biri fail ederse non-zero döndür.
-    final = rc1 or rc2 or rc3
-    print("\n" + ("✅ Tüm kontroller geçti." if final == 0 else "❌ Bir veya daha fazla kontrol başarısız."))
-    return final
-
-
-def cmd_lock(args: argparse.Namespace) -> int:
-    """`kortext lock` — kortext-lock.py acquire delegasyonu."""
-    return _run_python_script(
-        "kortext-lock.py",
-        ["acquire", "--file", args.file, "--agent", args.agent],
-    )
-
-
-def cmd_unlock(args: argparse.Namespace) -> int:
-    """`kortext unlock` — kortext-lock.py release delegasyonu."""
-    return _run_python_script("kortext-lock.py", ["release", "--file", args.file])
-
-
-def cmd_list_locks(_args: argparse.Namespace) -> int:
-    """`kortext list-locks` — kortext-lock.py list delegasyonu."""
-    return _run_python_script("kortext-lock.py", ["list"])
-
-
-def cmd_handover(args: argparse.Namespace) -> int:
-    """`kortext handover ...` — kortext-handover.py'ye argümanları aynen aktarır."""
-    return _run_python_script("kortext-handover.py", args.passthrough)
-
-
-def cmd_add(args: argparse.Namespace) -> int:
-    """`kortext add ...` — kortext-backlog-add.py'ye argümanları aynen aktarır."""
-    return _run_python_script("kortext-backlog-add.py", args.passthrough)
-
-
-def cmd_transition(args: argparse.Namespace) -> int:
-    """`kortext transition ...` — kortext-item-transition.py delegasyonu."""
-    return _run_python_script("kortext-item-transition.py", args.passthrough)
-
-
-def cmd_health(_args: argparse.Namespace) -> int:
-    """`kortext health` — kortext-backlog-health.py delegasyonu."""
-    return _run_python_script("kortext-backlog-health.py", [])
-
-
-def cmd_help(_args: argparse.Namespace) -> int:
-    """`kortext help` — tüm komutları Türkçe açıklamalı tabloda göster."""
-    print("=" * 70)
-    print("  KORTEXT KOMUT REFERANSI")
-    print("=" * 70)
-    print("\nKullanım: kortext <komut> [seçenekler]\n")
-    name_width = max(len(name) for name, _ in COMMAND_HELP) + 2
-    for name, desc in COMMAND_HELP:
-        print(f"  {name.ljust(name_width)} {desc}")
-    print("\nDetay için: kortext <komut> --help")
-    print("=" * 70)
-    return 0
-
-
-def build_parser() -> argparse.ArgumentParser:
-    """Subparser yapısını kurar."""
-    parser = argparse.ArgumentParser(
-        prog="kortext",
-        description="Kortext AI Agent Framework — komut satırı arayüzü.",
-        add_help=False,  # `--help` yerine `kortext help` tablosunu tercih ediyoruz.
-    )
-    parser.add_argument("-h", "--help", action="store_true", help="Yardım göster")
-    sub = parser.add_subparsers(dest="command")
-
-    # init
-    p_init = sub.add_parser("init", help="Kortext'i mevcut dizine kur")
-    p_init.add_argument(
-        "--runtime",
-        choices=["claude_code", "gemini_cli", "codex"],
-        help="Tercih edilen AI runtime (env var olarak iletilir).",
-    )
-    p_init.set_defaults(func=cmd_init)
-
-    # start
-    p_start = sub.add_parser("start", help="Bir workflow başlat")
-    p_start.add_argument("workflow", help="Workflow adı veya numarası (ör. analysis, 02b)")
-    p_start.set_defaults(func=cmd_start)
-
-    # status
-    p_status = sub.add_parser("status", help="Oturum özetini göster")
-    p_status.set_defaults(func=cmd_status)
-
-    # check
-    p_check = sub.add_parser("check", help="Üç sağlık kontrolünü sırayla çalıştır")
-    p_check.set_defaults(func=cmd_check)
-
-    # lock
-    p_lock = sub.add_parser("lock", help="Dosya kilidi al")
-    p_lock.add_argument("--file", required=True)
-    p_lock.add_argument("--agent", required=True)
-    p_lock.set_defaults(func=cmd_lock)
-
-    # unlock
-    p_unlock = sub.add_parser("unlock", help="Dosya kilidini kaldır")
-    p_unlock.add_argument("--file", required=True)
-    p_unlock.set_defaults(func=cmd_unlock)
-
-    # list-locks
-    p_locks = sub.add_parser("list-locks", help="Aktif kilitleri listele")
-    p_locks.set_defaults(func=cmd_list_locks)
-
-    # handover (passthrough)
-    p_handover = sub.add_parser("handover", help="Handover kaydı ekle")
-    p_handover.add_argument("passthrough", nargs=argparse.REMAINDER)
-    p_handover.set_defaults(func=cmd_handover)
-
-    # add (passthrough)
-    p_add = sub.add_parser("add", help="Backlog'a item ekle")
-    p_add.add_argument("passthrough", nargs=argparse.REMAINDER)
-    p_add.set_defaults(func=cmd_add)
-
-    # transition (passthrough)
-    p_trans = sub.add_parser("transition", help="Item status'u değiştir")
-    p_trans.add_argument("passthrough", nargs=argparse.REMAINDER)
-    p_trans.set_defaults(func=cmd_transition)
-
-    # health
-    p_health = sub.add_parser("health", help="Backlog sağlık raporu")
-    p_health.set_defaults(func=cmd_health)
-
-    # help
-    p_help = sub.add_parser("help", help="Yardım tablosu")
-    p_help.set_defaults(func=cmd_help)
-
-    return parser
-
-
-def main() -> int:
-    parser = build_parser()
-    args = parser.parse_args()
-
-    # Komut yoksa veya --help geldiyse yardım göster.
-    if getattr(args, "help", False) or not getattr(args, "command", None):
-        return cmd_help(args)
-
-    func = getattr(args, "func", None)
-    if func is None:
-        return cmd_help(args)
-    return func(args)
-
-
-if __name__ == "__main__":
-    sys.exit(main())

package/scripts/kortext-consistency-check.py

@@ -1,74 +0,0 @@
-#!/usr/bin/env python3
-from __future__ import annotations
-
-from pathlib import Path
-
-
-ROOT = Path(__file__).resolve().parents[1]
-SCAN_ROOTS = ["agents", "rules", "workflows", "scripts", "settings", "workspace"]
-FORBIDDEN_PATTERNS = {
-    "active-agents": "Eski aktif bağlam klasörü",
-    "backlog/v[": "Eski hiyerarşik backlog modeli",
-    "workspace/memory/backlog.md": "Eski monolitik backlog referansı",
-}
-
-
-def iter_text_files() -> list[Path]:
-    files: list[Path] = []
-    for rel in SCAN_ROOTS:
-        for path in (ROOT / rel).rglob("*"):
-            if path.is_file() and path.suffix in {".md", ".py", ".sh"}:
-                if path == Path(__file__).resolve():
-                    continue
-                files.append(path)
-    return files
-
-
-def main() -> None:
-    failures: list[str] = []
-    for path in iter_text_files():
-        text = path.read_text(errors="ignore")
-        for pattern, label in FORBIDDEN_PATTERNS.items():
-            if pattern in text:
-                failures.append(f"{path.relative_to(ROOT)}: {label} bulundu ({pattern})")
-
-    required_paths = [
-        ROOT / "workspace/memory/context",
-        ROOT / "workspace/memory/handover.md",
-        ROOT / "workspace/memory/decisions.md",
-        ROOT / "workspace/memory/learned.md",
-        ROOT / "workspace/memory/backlog/version-dashboard.md",
-        ROOT / "workspace/memory/backlog/epic-dashboard.md",
-        ROOT / "workspace/memory/backlog/debt-dashboard.md",
-        ROOT / "workspace/backups",
-        # v2.2.0 — yeni scriptler
-        ROOT / "scripts/kortext-session-start.py",
-        ROOT / "scripts/kortext-context-check.py",
-        ROOT / "scripts/kortext-backlog-health.py",
-        ROOT / "scripts/kortext-lock.py",
-        # v2.2.0 — yeni workflow'lar
-        ROOT / "workflows/02b-spike-workflow.md",
-        ROOT / "workflows/09-maintenance-cycle.md",
-        ROOT / "settings/CHANGELOG.md",
-        # v2.3.0 — şablon merkezi
-        ROOT / "workspace/templates",
-        ROOT / "workspace/templates/TXX-[task-name].md",
-        ROOT / "workspace/templates/BXX-[bug-name].md",
-        ROOT / "workspace/templates/DXX-[debt-name].md",
-        ROOT / "workspace/templates/[agent-name]-active.md",
-    ]
-    for path in required_paths:
-        if not path.exists():
-            failures.append(f"{path.relative_to(ROOT)} eksik")
-
-    if failures:
-        print("❌ Tutarlılık kontrolü başarısız:")
-        for failure in failures:
-            print(f"- {failure}")
-        raise SystemExit(1)
-
-    print("✅ Kortext çekirdeği tutarlı görünüyor.")
-
-
-if __name__ == "__main__":
-    main()

package/scripts/kortext-context-check.py

@@ -1,146 +0,0 @@
-#!/usr/bin/env python3
-"""
-Kortext Context Check
----------------------
-Context bütünlüğünü ölçer. Stale aktif dosyalar, çakışan görevler,
-handover uyumsuzlukları ve backlog dashboard tutarsızlıklarını raporlar.
-"""
-from __future__ import annotations
-
-import os
-import re
-from datetime import datetime
-from pathlib import Path
-
-
-ROOT = Path(__file__).resolve().parents[1]
-CONTEXT_DIR = ROOT / "workspace/memory/context"
-HANDOVER_PATH = ROOT / "workspace/memory/handover.md"
-BACKLOG_DIR = ROOT / "workspace/memory/backlog"
-EPIC_DASHBOARD = BACKLOG_DIR / "epic-dashboard.md"
-
-# Stale eşikleri env var ile override edilebilir.
-STALE_HOURS_CONTEXT = int(os.environ.get("KORTEXT_STALE_HOURS_CONTEXT", "24"))
-STALE_HOURS_BACKLOG = int(os.environ.get("KORTEXT_STALE_HOURS_BACKLOG", "48"))
-WARNINGS: list[str] = []
-ERRORS: list[str] = []
-
-
-def check_stale_context() -> None:
-    """24 saatten eski In Progress context dosyalarını tespit eder."""
-    if not CONTEXT_DIR.exists():
-        return
-    for f in CONTEXT_DIR.glob("*-active.md"):
-        mtime = datetime.fromtimestamp(f.stat().st_mtime)
-        age_hours = (datetime.now() - mtime).total_seconds() / 3600
-        if age_hours > STALE_HOURS_CONTEXT:
-            WARNINGS.append(
-                f"⚠️  STALE: {f.name} — {round(age_hours, 1)} saat önce güncellendi. "
-                f"Görev hala açık mı kontrol et."
-            )
-
-
-def check_context_vs_backlog() -> None:
-    """Context dosyalarında belirtilen item ID'lerinin backlog'da gerçekten var ve In Progress olup olmadığını kontrol eder."""
-    if not CONTEXT_DIR.exists() or not BACKLOG_DIR.exists():
-        return
-    for ctx_file in CONTEXT_DIR.glob("*-active.md"):
-        content = ctx_file.read_text(errors="ignore")
-        # ### +persona | T01 | In Progress | ... formatını parse et
-        match = re.search(r"\|\s*([TB D]\d+)\s*\|", content)
-        if not match:
-            WARNINGS.append(
-                f"⚠️  FORMAT: {ctx_file.name} içinde item ID parse edilemedi. "
-                f"Standart format: `### +persona | TXX | Status | HH:MM | özet`"
-            )
-            continue
-        item_id = match.group(1).strip()
-        # Backlog'da bu ID'yi ara
-        found = list(BACKLOG_DIR.glob(f"{item_id}-*.md"))
-        if not found:
-            ERRORS.append(
-                f"❌ EXİSTS: {ctx_file.name} içindeki {item_id} backlog'da bulunamadı."
-            )
-            continue
-        item_text = found[0].read_text(errors="ignore")
-        if "**Status:** In Progress" not in item_text:
-            WARNINGS.append(
-                f"⚠️  STATUS UYUŞMAZLIĞI: {ctx_file.name} aktif gösteriyor ama "
-                f"{found[0].name} In Progress değil."
-            )
-
-
-def check_handover_freshness() -> None:
-    """handover.md'nin son 48 saatte güncellenip güncellenmediğini kontrol eder."""
-    if not HANDOVER_PATH.exists():
-        WARNINGS.append("⚠️  HANDOVER: handover.md bulunamadı. Dosya oluşturulmalı.")
-        return
-    mtime = datetime.fromtimestamp(HANDOVER_PATH.stat().st_mtime)
-    age_hours = (datetime.now() - mtime).total_seconds() / 3600
-    if age_hours > STALE_HOURS_BACKLOG:
-        WARNINGS.append(
-            f"⚠️  HANDOVER: handover.md {round(age_hours, 1)} saat önce güncellendi. "
-            f"Son tamamlanan görevin devir kaydı yapıldı mı?"
-        )
-
-
-def check_duplicate_context() -> None:
-    """Aynı ajan için birden fazla aktif context dosyası var mı kontrol eder."""
-    if not CONTEXT_DIR.exists():
-        return
-    seen: dict[str, list[str]] = {}
-    for f in CONTEXT_DIR.glob("*-active.md"):
-        # agent-name-active.md → agent-name
-        agent = f.stem.replace("-active", "")
-        seen.setdefault(agent, []).append(f.name)
-    for agent, files in seen.items():
-        if len(files) > 1:
-            ERRORS.append(
-                f"❌ DUPLICATE CONTEXT: {agent} için birden fazla aktif dosya var: {files}"
-            )
-
-
-def print_report(score: int, total_checks: int) -> None:
-    now = datetime.now().strftime("%d.%m.%Y %H:%M")
-    print("=" * 60)
-    print(f"  KORTEXT CONTEXT CHECK — {now}")
-    print("=" * 60)
-
-    if ERRORS:
-        print(f"\n❌ HATALAR ({len(ERRORS)} adet):")
-        for e in ERRORS:
-            print(f"  {e}")
-
-    if WARNINGS:
-        print(f"\n⚠️  UYARILAR ({len(WARNINGS)} adet):")
-        for w in WARNINGS:
-            print(f"  {w}")
-
-    if not ERRORS and not WARNINGS:
-        print("\n✅ Tüm kontroller geçti. Context sağlıklı görünüyor.")
-
-    print(f"\n  Sağlık Skoru: {score}/{total_checks}")
-    print("=" * 60)
-
-
-def main() -> None:
-    checks = [
-        check_stale_context,
-        check_context_vs_backlog,
-        check_handover_freshness,
-        check_duplicate_context,
-    ]
-    for check in checks:
-        check()
-
-    total = len(checks)
-    failed = len([e for e in ERRORS]) + len([w for w in WARNINGS])
-    score = max(0, total - failed)
-    print_report(score, total)
-
-    if ERRORS:
-        raise SystemExit(1)
-
-
-if __name__ == "__main__":
-    main()

package/scripts/kortext-handover.py

@@ -1,107 +0,0 @@
-#!/usr/bin/env python3
-from __future__ import annotations
-
-import argparse
-import shutil
-import subprocess
-from datetime import datetime
-from pathlib import Path
-
-
-HANDOVER_PATH = Path("workspace/memory/handover.md")
-
-
-def _atomic_commit(message: str, paths: list[str]) -> None:
-    # Kortext atomic operation: dosyaları add edip commit'ler.
-    if not shutil.which("git"):
-        return
-    try:
-        subprocess.run(["git", "add", "--", *paths], check=True, capture_output=True)
-        subprocess.run(
-            ["git", "commit", "-m", message, "--", *paths],
-            check=True,
-            capture_output=True,
-        )
-    except subprocess.CalledProcessError:
-        return
-
-
-def main() -> None:
-    parser = argparse.ArgumentParser(description="Append a Kortext handover entry")
-    parser.add_argument("--item", required=True, help="e.g. T01-login-form")
-    parser.add_argument("--title", required=True)
-    parser.add_argument("--author", required=True)
-    parser.add_argument("--to", required=True, help="Devralan ajan veya 'none' (görev Done)")
-    parser.add_argument(
-        "--status",
-        required=True,
-        choices=["completed", "blocked", "partial"],
-        help="Görev durumu: completed | blocked | partial",
-    )
-    parser.add_argument("--completed", required=True)
-    parser.add_argument("--context", required=True, help="Bir sonraki ajanın mutlaka bilmesi gereken kritik bağlam")
-    parser.add_argument("--changed-file", action="append", default=[])
-    parser.add_argument("--watch-out", action="append", default=[])
-    parser.add_argument("--last-commit", required=True)
-    parser.add_argument("--next-step", required=True)
-    parser.add_argument("--no-commit", action="store_true", help="Atomic git commit'i atla")
-    args = parser.parse_args()
-
-    STATUS_LABELS = {
-        "completed": "Tamamlandı",
-        "blocked": "Bloklandı",
-        "partial": "Kısmen tamamlandı",
-    }
-
-    existing = HANDOVER_PATH.read_text() if HANDOVER_PATH.exists() else "# Handover Reports\n"
-    date = datetime.now().strftime("%d.%m.%y-%H:%M")
-    to_label = "Yok — görev Done" if args.to.lower() == "none" else f"+{args.to}"
-    changed_files = "\n".join(f"- {entry}" for entry in args.changed_file) or "- Yok"
-    watch_outs = "\n".join(f"- {entry}" for entry in args.watch_out) or "- Yok"
-
-    block = f"""## Handover: {args.item} — {args.title}
-
-> [!INFO]
-> - **Author:** +{args.author}
-> - **To:** {to_label}
-> - **Date:** {date}
-> - **Status:** {STATUS_LABELS[args.status]}
-
-### ✅ Completed
-
-- {args.completed}
-
-### Changed Files
-
-{changed_files}
-
-### Kritik Bağlam
-
-- {args.context}
-
-### Watch-outs & Decisions
-
-{watch_outs}
-
-### Last Commit
-
-- {args.last_commit}
-
-### Next Steps
-
-- {args.next_step}
-
-"""
-    HANDOVER_PATH.write_text(block + existing)
-    print(f"✅ Handover eklendi: {args.item} [{STATUS_LABELS[args.status]}]")
-
-    if not args.no_commit:
-        _atomic_commit(
-            f"chore(kortext): handover {args.item} ({args.status}) [skip ci]",
-            [str(HANDOVER_PATH)],
-        )
-
-
-if __name__ == "__main__":
-    main()
-