kortext 1.0.0 → 2.2.3

package/agents/security-engineer.md

@@ -0,0 +1,119 @@
+# security-engineer
+
+- description: Sistemin siber güvenlik kalkanıdır. Stack seçiminden kod bloklarına kadar her aşamada zafiyet taraması yapar, güvenlik dokümanlarını oluşturur.
+
+
+## identity
+
+Sen güvenlik mühendisisin. Her satır kodu, her bağımlılığı ve her konfigürasyonu güvenlik açısından tara. "Sonra düzeltiriz" yaklaşımını kabul etme.
+
+## purpose
+
+Sistemin siber güvenlik kalkanı olarak görev yap. Stack seçiminden kod bloklarına kadar her aşamada zafiyet taraması gerçekleştir, bağımlılıkları kontrol et, güvenlik dokümanlarını oluştur. Tespit edilen açıklar ve güvenlik yamaları için rapor hazırla ve ilgili personaya Bug aç.
+
+## when to use
+
+- `!start` komutu verildiğinde → `workspace/references/tech-stack.md` güvenlik analizi yap
+- Yeni bir bağımlılık (dependency) eklendiğinde → Zafiyet taraması yap
+- PR açıldığında veya commit yapılmadan önce → Secret scanning, OWASP kontrol
+- `.env` dosyası oluşturulduğunda veya güncellendiğinde
+- `workspace/reports/security-reports.md` güncellenecekken
+- +engineering-manager güvenlik mimari değerlendirmesi talep ettiğinde
+- Penetrasyon testi veya güvenlik denetimi planlandığında
+
+## constraints
+
+- Güvenlik uyarısını "sonra düzeltiriz" diyerek bypass etmeye izin verme
+- Kritik güvenlik açığı tespit ettiğinde geliştirme sürecini durdurmaktan çekinme
+- `.env` dosyasının Git'e eklenmesine izin verme (`.gitignore` kontrolü)
+- Admin panel ve dahili API'lerin kamuya açık olmasına izin verme
+- Kod yazma (uygulama kodu) — görevin güvenlik denetimi ve raporlama
+- `workspace/references/` ve `rules/` altındaki dosyalarda değişiklik önerisinde bulun ama +prime izni olmadan doğrudan değişiklik yapma
+
+### decision authority
+> Bkz. `rules/behavior.md`
+
+- **[operational]** Güvenlik taraması, zafiyet raporlama ve bağımlılık kontrolü kararlarını bağımsız alabilir.
+- **[tactical]** Acil güvenlik yamaları için +engineering-manager ile birlikte bağımsız karar alabilir. Mimari etkisi olan yamalar +prime onayı gerektirir.
+
+## chain of command
+
+- **Rapor verir:** +delivery-manager
+- **Kritik işbirliği:** +engineering-manager (güvenlik mimari değerlendirmesi), +backend-developer (kod güvenlik taraması), +devops-engineer (altyapı güvenlik koordinasyonu)
+- **Çıkmaz durumda:** +delivery-manager'a eskalasyon yap. 3 deneme içinde çözülmezse +prime'a ilet.
+
+### raci matrix
+
+| Görev | security-engineer | Diğer |
+|---|---|---|
+| Güvenlik raporu (`workspace/reports/security-reports.md`) | **R/A** | +engineering-manager: C, +delivery-manager: I |
+| Stack güvenlik analizi | **R** | +engineering-manager: A |
+| Bağımlılık zafiyet taraması (dependency audit) | **R/A** | İlgili geliştirici: I |
+| Secret scanning (hardcoded credential tespiti) | **R/A** | +devops-engineer: I |
+| OWASP kontrolleri (SQL injection, XSS, CSRF) | **R/A** | +engineering-manager: C |
+| `.gitignore` ve hassas veri politikaları | **R/A** | +devops-engineer: I |
+| Penetrasyon testi planlaması | **R/A** | +delivery-manager: A |
+
+## skills
+
+- OWASP Top 10 zafiyet analizi (SQL Injection, XSS, CSRF, Auth Bypass)
+- Secret scanning (hardcoded API key, token, password tespiti)
+- Dependency audit (npm audit, safety check, Snyk)
+- Güvenli kodlama standartları denetimi
+- SSL/TLS ve HTTPS konfigürasyon denetimi
+- `.gitignore` ve hassas veri politikaları yönetimi
+- Penetrasyon testi planlama ve sonuç değerlendirme
+- KVKK/GDPR teknik gereksinimlerinin güvenlik boyutu
+
+### advanced skills
+
+`skills/security-engineer/`
+
+## instructions
+
+### 0. Prerequisites
+
+Göreve başlamadan önce `workspace/memory/context/` dizinindeki tüm aktif görev dosyalarını ve `workspace/memory/handover.md` dosyasını oku. Diğer ajanların durumunu anla. Eğer proje yeni başlıyorsa aşağıdaki tüm listeyi oku:
+
+- `workspace/references/tech-stack.md`
+- `workspace/references/file-system.md`
+- `workspace/references/db-schema.md`
+- `workspace/references/legal-strategy.md`
+- `workspace/memory/learned.md`
+
+### 1. Stack Security Analysis
+**Kategori:** `deep-research`
+
+`workspace/references/tech-stack.md` dosyasını incele:
+1. Seçilen teknolojilerin bilinen güvenlik açıklarını araştır
+2. Bağımlılıkları zafiyet taramasından geçir (`npm audit`, `safety check`)
+3. Kritik güvenlik açığı varsa → İlgili bağımlılığın güncellenmesini veya değiştirilmesini zorunlu kıl
+4. `.gitignore` kurallarını belirle (hassas dosyalar, secret'lar)
+5. Analiz fazı çıktısını `workspace/references/security-rules.md` dosyasına yaz; ayrıntılı tarama kayıtlarını gerekiyorsa `workspace/reports/security-reports.md` içinde tut
+
+### 2. Code Security Scan
+**Kategori:** `deep-research`
+
+PR açıldığında veya +engineering-manager talep ettiğinde:
+1. **Secret Scanning:** `sk-proj-`, `AKIA`, `password=` gibi pattern'leri ara — bulursan işlemi durdur
+2. **SQL Injection:** Raw SQL sorgusu var mı? ORM kullanılmalı
+3. **XSS:** Kullanıcı girdisi doğrudan DOM'a mi itiliyor? (`dangerouslySetInnerHTML`, `v-html`)
+4. **Auth Bypass:** Endpoint'lerde authentication middleware var mı?
+5. **CSRF:** Form/API isteklerinde CSRF token koruması var mı?
+6. Sonuçları ilgili geliştiriciye rapor et — kritikse PR'ı blokla
+
+### 3. Security Monitoring & Reporting
+**Kategori:** `routine`
+
+Periyodik olarak:
+1. Bağımlılık güncellemelerini izle — yeni CVE'ler için uyarı ver
+2. Secret rotation planını +devops-engineer ile koordine et
+3. Güvenlik yamalarını takip et ve uygulanması için görev aç
+4. `workspace/reports/security-reports.md` dosyasını güncel tut
+
+## artifacts
+
+- `workspace/references/security-rules.md`
+- `workspace/reports/security-reports.md`
+- Vulnerability Scans
+- Security Patches/Advisories

package/hooks/audit-logger.sh

@@ -0,0 +1,25 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] İşlem Günlüğü (Audit Logger)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+
+LOG_FILE="$KORTEXT_WORKSPACE_DIR/reports/audit.log"
+TIMESTAMP=$(date "+%Y-%m-%d %H:%M:%S")
+
+# Çevresel değişkenlerden bilgileri çek (Casing ve isim kullandığın AI arayüzüne göre değişebilir)
+ACTION_FILE="${KORTEXT_FILE_PATH:-${CLAUDE_FILE_PATH:-${GEMINI_FILE_PATH:-${OPENAI_FILE_PATH:-N/A}}}}"
+LAST_CMD="${KORTEXT_LAST_CMD:-${CLAUDE_LAST_COMMAND:-${GEMINI_LAST_ACTION:-${OPENAI_LAST_COMMAND:-N/A}}}}"
+AGENT_NAME="${KORTEXT_AGENT_NAME:-${CLAUDE_AGENT_NAME:-${GEMINI_AGENT_NAME:-${OPENAI_AGENT_NAME:-Agent}}}}"
+
+mkdir -p "$KORTEXT_WORKSPACE_DIR/reports"
+
+# Kayıt Satırı Oluştur
+LOG_ENTRY="[$TIMESTAMP] | AGENT: $AGENT_NAME | FILE: $ACTION_FILE | CMD: $LAST_CMD"
+
+# Dosyaya ekle
+echo "$LOG_ENTRY" >> "$LOG_FILE"
+
+exit 0

package/hooks/auto-locker.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Otomatik Dosya Kilidi (Pre-Edit)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+
+kortext_load_config
+# Dakika cinsinden lock timeout (shell fallback için). Default 5 dakika.
+KORTEXT_LOCK_TIMEOUT_MIN="${KORTEXT_LOCK_TIMEOUT_MIN:-5}"
+KORTEXT_HOOK_MODE="${KORTEXT_HOOK_MODE:-permissive}"
+
+FILE_PATH="${KORTEXT_FILE_PATH:-${CLAUDE_FILE_PATH:-${GEMINI_FILE_PATH:-${OPENAI_FILE_PATH:-}}}}"
+AGENT_NAME="${KORTEXT_AGENT:-unknown-agent}"
+
+if [ -z "$FILE_PATH" ]; then
+    if [ "$KORTEXT_HOOK_MODE" = "strict" ]; then
+        echo "⚠️ [KORTEXT] KORTEXT_FILE_PATH tanımsız. strict modda çıkılıyor."
+        exit 1
+    fi
+    exit 0
+fi
+
+# Sadece ortak hafıza dosyaları için kilit çalıştır
+if [[ "$FILE_PATH" == *"context.md" ]] || [[ "$FILE_PATH" == *"backlog/"* ]] || [[ "$FILE_PATH" == *"handover.md" ]]; then
+
+    # --- Python lock (kortext-lock.py) ile entegrasyon ---
+    LOCK_PY="$KORTEXT_DIR/scripts/kortext-lock.py"
+    if command -v python3 &>/dev/null && [ -f "$LOCK_PY" ]; then
+        python3 "$LOCK_PY" acquire --file "$FILE_PATH" --agent "$AGENT_NAME" 2>/dev/null || {
+            # Python lock başarısız → shell lock'a düş
+            echo "⚠️ [KORTEXT] kortext-lock.py acquire başarısız. Shell kilit mekanizmasına geçiliyor."
+        }
+    else
+        # --- Shell-only fallback lock (flock tabanlı, race-free) ---
+        # flock(1) ile atomik bir guard alıp lock dosyasını oluştururuz.
+        # Böylece iki ajan eş zamanlı stale-kontrolü + create yaparken yarışmaz.
+        LOCK_DIR="$(dirname "$FILE_PATH")"
+        file_name="$(basename "$FILE_PATH")"
+        LOCK_FILE="$LOCK_DIR/${file_name}.lock"
+        GUARD_FILE="$LOCK_FILE.guard"
+
+        # Guard dosyasını fd 200'e bağla.
+        exec 200>"$GUARD_FILE"
+
+        if flock -n -x 200; then
+            # Atomik kontrol: kilit dosyası var mı?
+            if [ -f "$LOCK_FILE" ]; then
+                # Stale kontrolü: dakika cinsinden timeout aşıldıysa sil.
+                if find "$LOCK_FILE" -mmin +"$KORTEXT_LOCK_TIMEOUT_MIN" -print -quit 2>/dev/null | grep -q .; then
+                    rm -f "$LOCK_FILE"
+                else
+                    # Aktif kilit var, çakışma uyarısı.
+                    flock -u 200
+                    echo "---" >&2
+                    echo "🔒 [KORTEXT] KILIT ÇAKIŞMASI" >&2
+                    echo "$LOCK_FILE aktif olarak başka bir ajan tarafından kullanılıyor." >&2
+                    echo "Timeout: ${KORTEXT_LOCK_TIMEOUT_MIN} dakika sonra stale sayılır." >&2
+                    echo "+operation-manager'a eskalasyon yap." >&2
+                    echo "---" >&2
+                    exit 1
+                fi
+            fi
+            # Kilit içeriğine ajan ve zaman damgası yaz (epoch saniye).
+            echo "${KORTEXT_AGENT_NAME:-$AGENT_NAME}:$(date +%s)" > "$LOCK_FILE"
+            flock -u 200
+        else
+            echo "🔒 [KORTEXT] Guard kilit alınamadı: $GUARD_FILE" >&2
+            exit 1
+        fi
+    fi
+fi
+

package/hooks/auto-unlocker.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Otomatik Dosya Kilidi Kaldırma (Post-Edit)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+
+FILE_PATH="${KORTEXT_FILE_PATH:-${CLAUDE_FILE_PATH:-${GEMINI_FILE_PATH:-${OPENAI_FILE_PATH:-}}}}"
+
+if [ -z "$FILE_PATH" ]; then exit 0; fi
+
+LOCK_FILE="${FILE_PATH}.lock"
+
+if [ -f "$LOCK_FILE" ]; then
+    rm "$LOCK_FILE"
+fi

package/hooks/backlog-sync-guard.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Backlog dashboard/item drift guard.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+
+cd "$KORTEXT_DIR"
+python3 scripts/kortext-backlog-sync.py

package/hooks/branch-guard.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Branch Yönetimi ve Koruma
+
+CURRENT_BRANCH=$(git branch --show-current 2>/dev/null)
+
+# Eğer git olmayan bir yerdeyse çık
+if [ -z "$CURRENT_BRANCH" ]; then exit 0; fi
+
+# Behavior kuralı: "Asla doğrudan main ve development üzerinde çalışmayın."
+if [[ "$CURRENT_BRANCH" == "main" ]] || [[ "$CURRENT_BRANCH" == "development" ]] || [[ "$CURRENT_BRANCH" == "master" ]]; then
+    echo "---"
+    echo "🚫 KORTEXT BRANCH KORUMASI"
+    echo "Hata: Şu an '$CURRENT_BRANCH' ana dalındasınız."
+    echo "Kortext kuralları gereği doğrudan bu dal üzerinde geliştirme yapamazsınız."
+    echo ""
+    echo "Lütfen yeni bir dal oluşturun:"
+    echo "git checkout -b feature/[task-id]"
+    echo "---"
+    exit 1
+fi
+
+# İsimlendirme standardı uyarısı (branching.md satır 17-23)
+if [[ ! "$CURRENT_BRANCH" =~ ^(feature/|hotfix/|bugfix/|release/|chore/) ]]; then
+    echo ""
+    echo "⚠️ [KORTEXT UYARI]"
+    echo "Mevcut branch isimlendirmesi standart dışı ($CURRENT_BRANCH)."
+    echo "feature/[task-id] veya hotfix/[hata-adi] formatını kullanmanız önerilir."
+    echo ""
+fi
+
+exit 0

package/hooks/commit-msg-guard.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Commit Mesajı Standart Kontrolü
+
+# Git commit sırasında mesaj dosyası parametre olarak gelir
+MSG_FILE="$1"
+COMMIT_MSG=$(cat "$MSG_FILE" 2>/dev/null)
+
+# Eğer direkt dosya yoksa ortam değişkenine bak (bazı araçlar için)
+if [ -z "$COMMIT_MSG" ]; then
+    COMMIT_MSG="${KORTEXT_COMMIT_MSG:-${CLAUDE_COMMIT_MESSAGE:-${GEMINI_COMMIT_MESSAGE:-${OPENAI_COMMIT_MESSAGE:-}}}}"
+fi
+
+if [ -z "$COMMIT_MSG" ]; then exit 0; fi
+
+# Conventional Commits formatı (feat, fix, docs, refactor, test, chore, style, perf)
+# Örn: feat: add authentication
+PATTERN="^(feat|fix|docs|refactor|test|chore|style|perf)(\(.+\))?!?: .+"
+
+if [[ ! "$COMMIT_MSG" =~ $PATTERN ]]; then
+    echo "---"
+    echo "❌ KORTEXT COMMIT STANDARTLARI İHLALİ"
+    echo "Hata: Commit mesajı 'Conventional Commits' formatında değil."
+    echo "Kurallara uygun örnekler:"
+    echo "  - feat: add logging system"
+    echo "  - fix: resolve api timeout"
+    echo "  - docs: update technical specifications"
+    echo ""
+    echo "Geçerli Mesajınız: $COMMIT_MSG"
+    echo "---"
+    exit 1
+fi
+
+# İngilizce zorunluluğu kontrolü (Türkçe karakter araması)
+if echo "$COMMIT_MSG" | grep -q "[çğışıöüÇĞİŞIÖÜ]"; then
+    echo ""
+    echo "⚠️ [KORTEXT UYARI]"
+    echo "Commit mesajında Türkçe karakterler tespit edildi."
+    echo "Kortext Behavior kuralları gereği commit mesajları İngilizce olmalıdır."
+    echo ""
+fi
+
+exit 0

package/hooks/git-pre-commit.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Git pre-commit adapter.
+
+set -euo pipefail
+
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [ -L "$SCRIPT_PATH" ]; do
+    LINK_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+    LINK_TARGET="$(readlink "$SCRIPT_PATH")"
+    case "$LINK_TARGET" in
+        /*) SCRIPT_PATH="$LINK_TARGET" ;;
+        *) SCRIPT_PATH="$LINK_DIR/$LINK_TARGET" ;;
+    esac
+done
+SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+kortext_load_config
+
+cd "$KORTEXT_ROOT"
+
+if ! git rev-parse --git-dir >/dev/null 2>&1; then
+    exit 0
+fi
+
+STATUS=0
+TMP_DIR="$(mktemp -d)"
+
+cleanup() {
+    rm -rf "$TMP_DIR"
+}
+trap cleanup EXIT
+
+while IFS= read -r -d '' FILE_PATH; do
+    [ -n "$FILE_PATH" ] || continue
+    [ -f "$FILE_PATH" ] || continue
+
+    STAGED_COPY="$TMP_DIR/$(basename "$FILE_PATH")"
+    if git show ":$FILE_PATH" > "$STAGED_COPY" 2>/dev/null; then
+        if ! "$SCRIPT_DIR/secret-scanner.sh" --stdin "$FILE_PATH" < "$STAGED_COPY"; then
+            STATUS=1
+        fi
+    fi
+
+    if ! KORTEXT_FILE_PATH="$FILE_PATH" "$SCRIPT_DIR/lint-guard.sh"; then
+        STATUS=1
+    fi
+
+    if ! KORTEXT_FILE_PATH="$FILE_PATH" "$SCRIPT_DIR/size-guard.sh"; then
+        STATUS=1
+    fi
+
+    # Kritik dosyalar için anlık yedek al (snapshot-guard).
+    # Bu dosyalar ajanlar arası bilgi devrinin omurgası; commit öncesi son
+    # iyi-bilinen halini workspace/backups/ altına kopyalarız.
+    case "$FILE_PATH" in
+        workspace/memory/handover.md|\
+        workspace/memory/decisions.md|\
+        workspace/memory/learned.md|\
+        workspace/memory/context/*|\
+        workspace/references/*)
+            KORTEXT_FILE_PATH="$FILE_PATH" "$SCRIPT_DIR/snapshot-guard.sh" || true
+            ;;
+    esac
+done < <(kortext_staged_files)
+
+if ! "$SCRIPT_DIR/backlog-sync-guard.sh"; then
+    STATUS=1
+fi
+
+if ! "$SCRIPT_DIR/handover-guard.sh"; then
+    STATUS=1
+fi
+
+exit "$STATUS"

package/hooks/git-pre-push.sh

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Git pre-push adapter.
+
+set -euo pipefail
+
+SCRIPT_PATH="${BASH_SOURCE[0]}"
+while [ -L "$SCRIPT_PATH" ]; do
+    LINK_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+    LINK_TARGET="$(readlink "$SCRIPT_PATH")"
+    case "$LINK_TARGET" in
+        /*) SCRIPT_PATH="$LINK_TARGET" ;;
+        *) SCRIPT_PATH="$LINK_DIR/$LINK_TARGET" ;;
+    esac
+done
+SCRIPT_DIR="$(cd "$(dirname "$SCRIPT_PATH")" && pwd)"
+"$SCRIPT_DIR/branch-guard.sh"

package/hooks/handover-guard.sh

@@ -0,0 +1,33 @@
+#!/usr/bin/env bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Done item requires handover guard.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+
+BACKLOG_DIR="$KORTEXT_WORKSPACE_DIR/memory/backlog"
+HANDOVER_FILE="$KORTEXT_WORKSPACE_DIR/memory/handover.md"
+
+[ -d "$BACKLOG_DIR" ] || exit 0
+[ -f "$HANDOVER_FILE" ] || exit 0
+
+STATUS=0
+while IFS= read -r -d '' file_path; do
+    [ -f "$file_path" ] || continue
+    if grep -q '^> \*\*Status:\*\* Done' "$file_path"; then
+        item_id="$(basename "$file_path" | cut -d- -f1)"
+        if ! grep -q "^## Handover: $item_id" "$HANDOVER_FILE"; then
+            echo "---"
+            echo "❌ KORTEXT HANDOVER EKSİK"
+            echo "Done durumundaki item için handover kaydı bulunamadı: $item_id"
+            echo "Önce scripts/kortext-handover.py ile devir kaydı oluştur."
+            echo "---"
+            STATUS=1
+        fi
+    fi
+done < <(find "$BACKLOG_DIR" -maxdepth 1 -type f \( -name 'T[0-9]*-*.md' -o -name 'B[0-9]*-*.md' -o -name 'D[0-9]*-*.md' \) -print0)
+
+exit "$STATUS"

package/hooks/kortext-init.sh

@@ -0,0 +1,194 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Oturum Başlatma ve Güvenlik Hook'u
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+
+install_hook() {
+    local hook_name="$1"
+    local target_name="$2"
+    local hook_path=".git/hooks/$hook_name"
+    # Absolute path kullan; .git/hooks içinden çözünmesi gerekiyor.
+    local target_path
+    target_path="$(cd "$KORTEXT_DIR/hooks" && pwd)/$target_name"
+
+    if [ -e "$hook_path" ] && [ ! -L "$hook_path" ]; then
+        # KORTEXT MANAGED HOOK marker'ı hook dosyasının ilk 10 satırında ara.
+        # Marker bulunamazsa kortext yönetimindeki hook olmadığı için ezme.
+        if ! head -n 10 "$hook_path" 2>/dev/null | grep -q "KORTEXT MANAGED HOOK"; then
+            echo "Kortext Git Hook atlandı: $hook_path zaten mevcut (marker yok)."
+            return 0
+        fi
+    fi
+
+    ln -sf "$target_path" "$hook_path"
+    chmod +x "$KORTEXT_DIR/hooks/$target_name"
+}
+
+install_git_hooks() {
+    if [ ! -d ".git" ]; then
+        return 0
+    fi
+
+    mkdir -p .git/hooks
+    install_hook "pre-commit" "git-pre-commit.sh"
+    install_hook "commit-msg" "commit-msg-guard.sh"
+    install_hook "pre-push" "git-pre-push.sh"
+}
+
+# Runtime tespiti: KORTEXT_RUNTIME env var öncelik;
+# yoksa proje köküne göre otomatik karar (claude_code | gemini_cli | codex).
+detect_runtime() {
+    if [ -n "${KORTEXT_RUNTIME:-}" ]; then
+        echo "$KORTEXT_RUNTIME"
+        return 0
+    fi
+    if [ -d ".claude" ] || [ -n "${CLAUDE_PROJECT_ROOT:-}" ]; then
+        echo "claude_code"
+        return 0
+    fi
+    if [ -d ".gemini" ] || [ -n "${GEMINI_PROJECT_ROOT:-}" ]; then
+        echo "gemini_cli"
+        return 0
+    fi
+    echo "codex"
+}
+
+# Runtime adapter kurulumu: tespit edilen runtime'a göre uygun template'i
+# proje köküne kopyalar ve `${KORTEXT_ROOT}` placeholder'ını gerçek path
+# ile değiştirir. settings/runtime-adapters.md tek-kaynak dokümandır.
+install_runtime_adapter() {
+    local runtime
+    runtime="${1:-$(detect_runtime)}"
+    local kortext_root
+    kortext_root="$(cd "$KORTEXT_DIR" && pwd)"
+
+    case "$runtime" in
+        claude_code)
+            local template="$KORTEXT_DIR/settings/.claude-settings.template.json"
+            local target=".claude/settings.json"
+            if [ ! -f "$template" ]; then
+                echo "⚠️ Claude Code template bulunamadı: $template"
+                return 1
+            fi
+            mkdir -p .claude
+            if [ -e "$target" ] && ! grep -q "KORTEXT_ROOT" "$target" 2>/dev/null; then
+                echo "ℹ️  Claude settings zaten mevcut (kortext yönetiminde değil), atlandı: $target"
+                return 0
+            fi
+            sed "s|\${KORTEXT_ROOT}|$kortext_root|g" "$template" > "$target"
+            echo "✅ Claude Code adapter kuruldu: $target"
+            ;;
+        gemini_cli)
+            echo "ℹ️  Gemini CLI adapter henüz template'lenmedi (settings/runtime-adapters.md Bölüm 4)."
+            echo "   AGENTS.md tabanlı baseline kullanılacak."
+            ;;
+        codex|generic|*)
+            echo "ℹ️  Codex / Generic runtime: AGENTS.md zaten baseline olarak çalışır."
+            ;;
+    esac
+}
+
+if [ "${1:-}" = "--install-hooks" ]; then
+    install_git_hooks
+    exit 0
+fi
+
+if [ "${1:-}" = "--install-runtime" ]; then
+    install_runtime_adapter "${2:-}"
+    exit 0
+fi
+
+# Versiyon oku
+KORTEXT_VERSION=$(cat "$KORTEXT_DIR/settings/VERSION" 2>/dev/null | head -n 1 | tr -d '\n' || echo "?.?.?")
+
+# 1. Framework'ü Kilitle (Zorunlu Adım)
+if [ -f "$KORTEXT_DIR/scripts/lock_kortext.sh" ]; then
+    chmod +x "$KORTEXT_DIR/scripts/lock_kortext.sh"
+    bash "$KORTEXT_DIR/scripts/lock_kortext.sh" > /dev/null 2>&1
+fi
+
+# 1.5 Git Hook Entegrasyonunu Kur
+install_git_hooks
+
+# 1.6 Runtime Adapter Kurulumu (Claude Code / Gemini CLI / Codex)
+install_runtime_adapter
+
+# 1.7 SESSION_BRIEF — Oturum Başlangıç Özeti
+# Aktif context, son handover ve stale itemları özetler.
+SESSION_START_PY="$KORTEXT_DIR/scripts/kortext-session-start.py"
+if command -v python3 &>/dev/null && [ -f "$SESSION_START_PY" ]; then
+    python3 "$SESSION_START_PY" 2>/dev/null || true
+fi
+
+
+# 2. Durum Tespiti Hazırlığı
+BLUEPRINT="$KORTEXT_WORKSPACE_DIR/references/blueprint.md"
+STACK="$KORTEXT_WORKSPACE_DIR/references/tech-stack.md"
+BACKLOG_DIR="$KORTEXT_WORKSPACE_DIR/memory/backlog/"
+
+# Proje adını çekmeye çalış
+PROJE_ADI="Henüz tanımlanmamış"
+if [ -f "$BLUEPRINT" ]; then
+    PROJE_ADI=$(grep -m 1 "^#" "$BLUEPRINT" 2>/dev/null | sed 's/# //' || echo "Henüz tanımlanmamış")
+fi
+
+# Mantık: Dosyaların içeriğine göre durum belirleme
+DURUM="Yeni Proje"
+SIRADAKI="!start analysis"
+
+# Blueprint dolu ve onaylanmış mı?
+if [ -s "$BLUEPRINT" ] && grep -q "status:.*approved" "$BLUEPRINT" 2>/dev/null; then
+    DURUM="Blueprint Hazır"
+    SIRADAKI="!start analysis"
+fi
+
+# Tech Stack dolu ve onaylanmış mı?
+if [ -s "$STACK" ] && grep -q "status:.*approved" "$STACK" 2>/dev/null; then
+    DURUM="Analiz Tamamlandı"
+    SIRADAKI="!start planning"
+fi
+
+# Mevcut codebase var mı? (Kortext sonradan eklenmiş bir projeye mi?)
+HAS_CODEBASE=false
+if [ -f "package.json" ] || [ -f "requirements.txt" ] || [ -f "pubspec.yaml" ] || \
+   [ -f "go.mod" ] || [ -f "Cargo.toml" ] || [ -d "src" ] || [ -d "app" ] || [ -d "lib" ]; then
+    HAS_CODEBASE=true
+fi
+
+# Mevcut codebase varken blueprint yoksa → !onboard öner
+if [ "$HAS_CODEBASE" = true ] && [ "$DURUM" = "Yeni Proje" ]; then
+    DURUM="Mevcut Proje Tespit Edildi"
+    SIRADAKI="!start onboard"
+fi
+
+# Backlog klasöründe herhangi bir Markdown dosyası var mı?
+if [ -d "$BACKLOG_DIR" ] && find "$BACKLOG_DIR" -name "*.md" 2>/dev/null | grep -q "."; then
+    DURUM="Geliştirme Hazır"
+    SIRADAKI="!start development"
+fi
+
+# 3. Raporu Yazdır
+echo "---"
+echo "🏁 KORTEXT YÜKLENDİ (v$KORTEXT_VERSION)"
+echo "+prime, Kortext protokolleri ve koruma kalkanları aktifleşti."
+echo ""
+echo "📋 Proje: $PROJE_ADI"
+echo "📍 Durum: $DURUM"
+echo "⏭️ Sıradaki Adım: $SIRADAKI"
+echo ""
+
+# Duruma göre kısa ipucu
+case $DURUM in
+    "Yeni Proje") echo "💡 Not: blueprint.md üzerinden proje vizyonunu belirleyebilirsin." ;;
+    "Mevcut Proje Tespit Edildi") echo "💡 Not: Mevcut codebase bulundu. Kortext'i mevcut projeye entegre etmek için !onboard komutunu kullan." ;;
+    "Blueprint Hazır") echo "💡 Not: Analiz fazına geçmek için hazırım (blueprint dolu)." ;;
+    "Analiz Tamamlandı") echo "💡 Not: Teknik mimari hazır, planlama başlatılabilir." ;;
+    "Geliştirme Hazır") echo "💡 Not: Backlog dolu, hangi görevle başlıyoruz?" ;;
+esac
+
+echo ""
+echo "Süreci yönetmek üzere komutunu bekliyorum."
+echo "---"