kortext 1.0.0 → 2.2.3

package/hooks/kortext-lib.sh

@@ -0,0 +1,151 @@
+#!/usr/bin/env bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# Shared path and config helpers for Kortext hooks.
+
+kortext_find_root() {
+    local dir="${1:-$PWD}"
+
+    while [ "$dir" != "/" ]; do
+        if [ -d "$dir/.kortext/hooks" ]; then
+            printf '%s\n' "$dir"
+            return 0
+        fi
+        dir="$(dirname "$dir")"
+    done
+
+    return 1
+}
+
+KORTEXT_ROOT="${KORTEXT_ROOT:-$(kortext_find_root "$PWD" 2>/dev/null || pwd)}"
+
+# .kortext zorunlu — çift modlu sistem kaldırıldı
+KORTEXT_REL="${KORTEXT_REL:-.kortext}"
+KORTEXT_DIR="${KORTEXT_DIR:-$KORTEXT_ROOT/$KORTEXT_REL}"
+
+# Hata kontrolü: .kortext/ bulunmazsa açık hata ver
+if [ ! -d "$KORTEXT_DIR/hooks" ]; then
+    echo "❌ HATA: .kortext/ dizini bulunamadı: $KORTEXT_DIR" >&2
+    return 1
+fi
+
+# KORTEXT_WORKSPACE_DIR: npm global kurulumda framework ve proje dizini ayrılır.
+# Önce çalışma dizininde local workspace/ ara; yoksa framework'ün kendi workspace/'ini kullan.
+if [ -z "${KORTEXT_WORKSPACE_DIR:-}" ]; then
+    if [ -d "$PWD/workspace" ]; then
+        KORTEXT_WORKSPACE_DIR="$PWD/workspace"
+    else
+        KORTEXT_WORKSPACE_DIR="$KORTEXT_DIR/workspace"
+    fi
+fi
+export KORTEXT_WORKSPACE_DIR
+
+kortext_abs_path() {
+    local path="$1"
+    case "$path" in
+        /*) printf '%s\n' "$path" ;;
+        *) printf '%s\n' "$KORTEXT_ROOT/$path" ;;
+    esac
+}
+
+kortext_load_config() {
+    local config_file line key value
+    local candidates=(
+        "$KORTEXT_DIR/settings/config"
+        "$KORTEXT_DIR/settings/config.md"
+        "$KORTEXT_DIR/config"
+        "$KORTEXT_ROOT/.kortext/config"
+    )
+
+    for config_file in "${candidates[@]}"; do
+        [ -f "$config_file" ] || continue
+        while IFS= read -r line; do
+            line="${line%%#*}"
+            [[ "$line" =~ ^[[:space:]]*([A-Z_][A-Z0-9_]*)[[:space:]]*=[[:space:]]*(.*)[[:space:]]*$ ]] || continue
+            key="${BASH_REMATCH[1]}"
+            value="${BASH_REMATCH[2]}"
+            value="${value%\"}"
+            value="${value#\"}"
+            value="${value%\'}"
+            value="${value#\'}"
+            if [ -z "${!key+x}" ]; then
+                export "$key=$value"
+            fi
+        done < "$config_file"
+        return 0
+    done
+
+    return 0
+}
+
+kortext_is_workspace_path() {
+    local abs
+    abs="$(kortext_abs_path "$1")"
+
+    case "$abs" in
+        "$KORTEXT_WORKSPACE_DIR"/*|"$KORTEXT_ROOT/.kortext/workspace"/*)
+            return 0
+            ;;
+        *)
+            return 1
+            ;;
+    esac
+}
+
+kortext_is_env_path() {
+    local base
+    base="$(basename "$1")"
+    case "$base" in
+        .env|.env.*)
+            return 0
+            ;;
+        *)
+            return 1
+            ;;
+    esac
+}
+
+kortext_json_field() {
+    # JSON içinden bir alan çek. jq yoksa python3 fallback'ine düşer.
+    # query formatı: '.tool_input.file_path' gibi nokta yollu erişim.
+    local input="$1"
+    local query="$2"
+
+    if command -v jq >/dev/null 2>&1; then
+        printf '%s' "$input" | jq -r "$query // empty" 2>/dev/null || true
+        return 0
+    fi
+
+    if command -v python3 >/dev/null 2>&1; then
+        # Python fallback — '.a.b.c' yolunu dict erişimine çevirir.
+        printf '%s' "$input" | KORTEXT_JSON_QUERY="$query" python3 -c '
+import json, os, sys
+try:
+    data = json.load(sys.stdin)
+    query = os.environ.get("KORTEXT_JSON_QUERY", "").lstrip(".")
+    if not query:
+        print("")
+        sys.exit(0)
+    parts = query.split(".")
+    for p in parts:
+        if isinstance(data, dict):
+            data = data.get(p, "")
+        else:
+            data = ""
+            break
+    if data is None:
+        data = ""
+    print(data)
+except Exception:
+    pass
+' 2>/dev/null || true
+        return 0
+    fi
+
+    # Hiçbir araç yoksa boş döndür.
+    echo ""
+    return 1
+}
+
+kortext_staged_files() {
+    git diff --cached --name-only --diff-filter=ACMR -z
+}

package/hooks/lint-guard.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Kod Hatası Denetleyicisi (Lint-Guard)
+
+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" ] || [ ! -f "$FILE_PATH" ]; then exit 0; fi
+
+EXTENSION="${FILE_PATH##*.}"
+
+echo "🔍 [KORTEXT LINT] Denetleniyor: $FILE_PATH"
+
+case "$EXTENSION" in
+    sh)
+        # Shell script syntax kontrolü
+        bash -n "$FILE_PATH"
+        ;;
+    js)
+        # JavaScript syntax kontrolü (Node.js varsa)
+        if command -v node > /dev/null 2>&1; then
+            node -c "$FILE_PATH"
+        fi
+        ;;
+    json)
+        # JSON format kontrolü (Python varsa)
+        if command -v python3 > /dev/null 2>&1; then
+            python3 -m json.tool "$FILE_PATH" > /dev/null
+        fi
+        ;;
+    *)
+        # Diğer dosyalar için şimdilik pas geç
+        exit 0
+        ;;
+esac
+
+# Eğer yukarıdaki komutlardan biri hata verirse ($? 1 olursa) durdur
+if [ $? -ne 0 ]; then
+    echo "---"
+    echo "❌ KORTEXT LINT HATASI"
+    echo "Dosya içinde yazım veya sözdizimi (syntax) hatası tespit edildi."
+    echo "Lütfen kodu düzeltip tekrar deneyin."
+    echo "---"
+    exit 1
+fi
+
+exit 0

package/hooks/secret-scanner.sh

@@ -0,0 +1,89 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Gizli Bilgi ve Sızıntı Tarayıcı
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+
+kortext_load_config
+KORTEXT_HOOK_MODE="${KORTEXT_HOOK_MODE:-permissive}"
+
+# ---- Pattern Grubu 1: Tırnaklı Atama (api_key = "...") ----
+P1="(api[_-]?key|secret[_-]?key|password|token|bearer|credential|private[_-]key|access[_-]?key|auth[_-]?token)\s*[:=]\s*['\"][^'\"]{8,}['\"]"
+
+# ---- Pattern Grubu 2: Tırnaksız Atama (API_KEY=sk-abc123) ----
+P2="(API_KEY|SECRET_KEY|ACCESS_KEY|AUTH_TOKEN|DB_PASSWORD|DATABASE_URL)=[^'\"\s]{8,}"
+
+# ---- Pattern Grubu 3: Servis Spesifik Formatlar ----
+# OpenAI: sk-proj-..., Anthropic: sk-ant-..., AWS: AKIA..., GitHub: ghp_..., Slack: xox*
+P3="(sk-[a-zA-Z0-9]{20,}|AKIA[0-9A-Z]{16}|ghp_[a-zA-Z0-9]{36,}|ghs_[a-zA-Z0-9]{36,}|xox[baprs]-[0-9\-a-zA-Z]{20,})"
+
+# ---- Pattern Grubu 4: Authorization Header Değerleri ----
+P4="Authorization:\s*Bearer\s+[a-zA-Z0-9._\-]{20,}"
+
+# ---- İstisna: Env okuma ve placeholder değerler ----
+EXCLUSIONS="process\.env|import\.meta\.env|os\.environ|getenv|YOUR_|<YOUR|PLACEHOLDER|example|EXAMPLE|\[VALUE\]|\[fill\]"
+
+scan_file() {
+    local source_path="$1"
+    local display_path="${2:-$source_path}"
+    local pattern
+
+    # Behavior kuralı: ".env versiyon kontrolüne dahil edilmez, gizli bilgiler orada saklanır."
+    # Bu yüzden gerçek .env dosyalarını tarama dışı bırakıyoruz.
+    if [[ "$display_path" == *".env"* ]] && [[ "$display_path" != *".env.example"* ]]; then
+        return 0
+    fi
+
+    [ -f "$source_path" ] || return 0
+
+    for pattern in "$P1" "$P2" "$P3" "$P4"; do
+        if grep -Ei "$pattern" "$source_path" 2>/dev/null | grep -vEi "$EXCLUSIONS" > /dev/null; then
+            echo "---"
+            echo "⚠️ KORTEXT GÜVENLİK İHLALİ: SIZINTI TESPİT EDİLDİ"
+            echo "Hata: Dosya içinde açık bir şifre, anahtar (key) veya token tespit edildi."
+            echo "Kortext Behavior Kuralları gereği (Madde 38-39):"
+            echo "1. Gizli bilgiler asla kod içine hardcoded yazılmaz."
+            echo "2. Sadece .env dosyası kullanılmalı ve değerler tırnak içinde oraya taşınmalıdır."
+            echo ""
+            echo "Dosya: $display_path"
+            echo "---"
+            return 1
+        fi
+    done
+
+    return 0
+}
+
+if [ "${1:-}" = "--stdin" ]; then
+    DISPLAY_PATH="${2:-STDIN}"
+    TMP_FILE="$(mktemp)"
+    cat > "$TMP_FILE"
+    scan_file "$TMP_FILE" "$DISPLAY_PATH"
+    STATUS=$?
+    rm -f "$TMP_FILE"
+    exit "$STATUS"
+fi
+
+if [ "$#" -gt 0 ]; then
+    STATUS=0
+    for FILE_PATH in "$@"; do
+        if ! scan_file "$FILE_PATH"; then
+            STATUS=1
+        fi
+    done
+    exit "$STATUS"
+fi
+
+FILE_PATH="${KORTEXT_FILE_PATH:-${CLAUDE_FILE_PATH:-${GEMINI_FILE_PATH:-${OPENAI_FILE_PATH:-}}}}"
+
+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
+
+scan_file "$FILE_PATH"

package/hooks/size-guard.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Dosya Boyutu ve Arşivleme Muhafixı
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+
+kortext_load_config
+KORTEXT_HOOK_MODE="${KORTEXT_HOOK_MODE:-permissive}"
+MAX_LINES="${KORTEXT_SIZE_LIMIT:-500}"
+
+FILE_PATH="${KORTEXT_FILE_PATH:-${CLAUDE_FILE_PATH:-${GEMINI_FILE_PATH:-${OPENAI_FILE_PATH:-}}}}"
+
+# Eğer dosya yolu boşsa veya dosya mevcut değilse çık
+if [ -z "$FILE_PATH" ] || [ ! -f "$FILE_PATH" ]; then
+    if [ -z "$FILE_PATH" ] && [ "$KORTEXT_HOOK_MODE" = "strict" ]; then
+        echo "⚠️ [KORTEXT] KORTEXT_FILE_PATH tanımsız. strict modda çıkılıyor."
+        exit 1
+    fi
+    exit 0
+fi
+
+# ÖZEL İSTİSNA: backlog/ dizini her zaman tam kapsamlı kalmalıdır, arşivlenmez.
+if [[ "$FILE_PATH" == *"backlog/"* ]]; then
+    exit 0
+fi
+
+LINE_COUNT=$(wc -l < "$FILE_PATH")
+
+if [ "$LINE_COUNT" -gt "$MAX_LINES" ]; then
+    echo "---"
+    echo "🛑 KORTEXT BOYUT SINIRI AŞILDI"
+    echo "Dosya: $FILE_PATH ($LINE_COUNT satır)"
+    echo "Limit: $MAX_LINES satır"
+    echo ""
+    echo "⚠️ ARCHIVING PROTOCOL GEREĞİ:"
+    echo "1. Dosyadaki eski veya tamamlanmış verileri tespit et."
+    echo "2. Bu verileri '$KORTEXT_REL/workspace/archive/' altına '[dosya-adi]_[YYYY-MM-DD_HHMMSS].md' formatıyla taşı."
+    echo "3. Ana dosyada arşivlenen bölüme bir link/not bırak."
+    echo "4. Ana dosyayı hafifletip işlemi tekrar dene."
+    echo ""
+    echo "Not: 'backlog/' dizinindeki dosyalar bu kuraldan muaf tutulmuştur."
+    echo "---"
+    exit 1
+fi
+
+exit 0

package/hooks/snapshot-guard.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Anlık Yedekleme Muhafızı (Snapshot-Guard)
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+
+kortext_load_config
+KORTEXT_HOOK_MODE="${KORTEXT_HOOK_MODE:-permissive}"
+BACKUP_KEEP="${KORTEXT_BACKUP_KEEP:-5}"
+
+FILE_PATH="${KORTEXT_FILE_PATH:-${CLAUDE_FILE_PATH:-${GEMINI_FILE_PATH:-${OPENAI_FILE_PATH:-}}}}"
+BACKUP_DIR="$KORTEXT_WORKSPACE_DIR/backups"
+
+# Dosya yolu yoksa veya mevcut değilse çık
+if [ -z "$FILE_PATH" ] || [ ! -f "$FILE_PATH" ]; then
+    if [ -z "$FILE_PATH" ] && [ "$KORTEXT_HOOK_MODE" = "strict" ]; then
+        echo "⚠️ [KORTEXT] KORTEXT_FILE_PATH tanımsız. strict modda çıkılıyor."
+        exit 1
+    fi
+    exit 0
+fi
+
+# Yedekleme dizinini oluştur
+mkdir -p "$BACKUP_DIR"
+
+FILENAME=$(basename "$FILE_PATH")
+TIMESTAMP=$(date "+%Y-%m-%d_%H%M%S") # Tarih-Saat-Dakika-Saniye
+BACKUP_NAME="${BACKUP_DIR}/${FILENAME}_${TIMESTAMP}.bak"
+
+# 1. Yedeği al
+cp "$FILE_PATH" "$BACKUP_NAME"
+
+# 2. Temizlik: Aynı dosya için olan yedeklerden sadece en yeni 5 tanesini tut
+# (Diğerlerini silerek yer tasarrufu sağlar)
+ls -t "${BACKUP_DIR}/${FILENAME}"_* 2>/dev/null | tail -n +$((BACKUP_KEEP + 1)) | xargs rm -f 2>/dev/null
+
+exit 0

package/hooks/write-guard.sh

@@ -0,0 +1,77 @@
+#!/bin/bash
+# KORTEXT MANAGED HOOK — generated/edited by kortext framework
+# [KORTEXT] Yazma Muhafızı (Gelişmiş)
+# 1. Konum Kontrolü: Sadece izin verilen dizinlere yazılmasını sağlar.
+# 2. Kalite Kontrolü (Tamlık Kapısı): Yarım kalmış içeriklerin yazılmasını engeller.
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=kortext-lib.sh
+source "$SCRIPT_DIR/kortext-lib.sh"
+
+kortext_load_config
+KORTEXT_HOOK_MODE="${KORTEXT_HOOK_MODE:-permissive}"
+
+# Girdiyi Oku (JSON formatında gelmesi beklenir)
+INPUT=$(cat)
+FILE_PATH="$(kortext_json_field "$INPUT" '.tool_input.file_path')"
+
+# Eğer JSON'dan gelmiyorsa çevresel değişkenleri dene
+if [ -z "$FILE_PATH" ]; then
+    FILE_PATH="${KORTEXT_FILE_PATH:-${CLAUDE_FILE_PATH:-${GEMINI_FILE_PATH:-${OPENAI_FILE_PATH:-}}}}"
+fi
+
+if [ -z "$FILE_PATH" ]; then
+    if [ "$KORTEXT_HOOK_MODE" = "strict" ]; then
+        echo "⚠️ [KORTEXT] Dosya yolu tespit edilemedi. strict modda çıkılıyor."
+        exit 1
+    fi
+    exit 0
+fi
+
+# 1. BÖLÜM: KONUM KONTROLÜ
+ALLOWED=false
+if kortext_is_workspace_path "$FILE_PATH" || kortext_is_env_path "$FILE_PATH"; then
+    ALLOWED=true
+fi
+
+if [ "$ALLOWED" = false ]; then
+    echo "---"
+    echo "❌ KORTEXT ERİŞİM ENGELİ"
+    echo "Hata: Kortext kuralları gereği Framework çekirdek dizinlerine yazma yetkiniz yoktur."
+    echo "Lütfen çıktılarınızı '$KORTEXT_REL/workspace/' altındaki uygun klasörlere kaydedin."
+    echo "Hedeflenen Dosya: $FILE_PATH"
+    echo "---"
+    exit 1
+fi
+
+# 2. BÖLÜM: TAMLIK KAPISI (KALİTE KONTROLÜ)
+# Yazılacak içeriği al (Write veya Edit/MultiEdit araçları için)
+CONTENT="$(kortext_json_field "$INPUT" '.tool_input.content // .tool_input.new_string')"
+
+if [ -n "$CONTENT" ]; then
+    # Yarım bırakma işaretçileri (TBD, FIXME, PLACEHOLDER vb.)
+    # Önemli İstisna: "// todo: [tech-debt]" formatındaki teknik borçlara izin verilir.
+    if echo "$CONTENT" | grep -qiE '\bTBD\b|\bFIXME\b|\[PLACEHOLDER\]|\[INSERT ' || \
+       (echo "$CONTENT" | grep -i '\bTODO\b' | grep -vi '\[tech-debt\]' | grep -q .); then
+        echo "---"
+        echo "⚠️ TAMLIK KAPISI: EKSİK İÇERİK TESPİT EDİLDİ"
+        echo "Hata: Yazmaya çalıştığınız içerikte disiplinsiz (etiketsiz) yer tutucular var."
+        echo "Kortext Politikası: Sıradan TODO/TBD kullanımı yasaktır."
+        echo "İstisna: Eğer teknik borç bırakmanız gerekiyorsa '// todo: [tech-debt] açıklama' formatını kullanın."
+        echo "Dosya: $FILE_PATH"
+        echo "---"
+        exit 1
+    fi
+
+    # Kararsızlık ifadeleri
+    if echo "$CONTENT" | grep -qiE 'assess whether|decide later|need to determine|open question|to be decided|deferred decision'; then
+        echo "---"
+        echo "⚠️ TAMLIK KAPISI: BELİRSİZLİK TESPİT EDİLDİ"
+        echo "Hata: İçerikte 'sonra karar verilecek' veya 'belirlenmesi gerekiyor' gibi ucu açık ifadeler var."
+        echo "Kortext Politikası: Yazma işleminden önce tüm kararlar çözülmüş olmalıdır."
+        echo "---"
+        exit 1
+    fi
+fi
+
+exit 0

package/package.json

@@ -1,12 +1,29 @@
 {
   "name": "kortext",
-  "version": "1.0.0",
-  "description": "",
-  "license": "ISC",
-  "author": "",
-  "type": "commonjs",
+  "version": "2.2.3",
+  "description": "AI Agent Framework for Operational Discipline and Automated Project Management",
   "main": "index.js",
+  "bin": {
+    "kortext": "scripts/kortext-cli.py"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "python3 scripts/kortext-consistency-check.py",
+    "check": "python3 scripts/kortext-context-check.py",
+    "health": "python3 scripts/kortext-backlog-health.py"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "framework",
+    "automation",
+    "project-management",
+    "gemini",
+    "claude"
+  ],
+  "author": "Eray Endes",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0",
+    "python": ">=3.10.0"
   }
 }