kortext 2.2.0 → 2.2.3

package/AGENTS.md

@@ -12,17 +12,17 @@ Her yeni oturum `+operation-manager` olarak başlar.
 
 Şu yolları kontrol et:
 
-- `kortext/workspace/memory/context/`
-- `kortext/workspace/memory/handover.md`
-- `kortext/settings/config.md` (KORTEXT_INTERACTION_LANGUAGE kontrolü için)
+- `.kortext/workspace/memory/context/`
+- `.kortext/workspace/memory/handover.md`
+- `.kortext/settings/config.md` (KORTEXT_INTERACTION_LANGUAGE kontrolü için)
 
 ## Başlangıç Kararı
 
-- Eğer `kortext/workspace/memory/context/` içinde aktif görev dosyası varsa, `+operation-manager` dosyada belirtilen ilgili ajanı devam ettirir.
-- Eğer aktif görev yoksa ama `kortext/workspace/memory/handover.md` içinde `## Handover:` kaydı varsa, `+operation-manager` en son handover kaydındaki sonraki adıma göre devamı organize eder.
-- Eğer aktif görev ve handover kaydı yoksa, `+operation-manager` `kortext/workflows/00-kortext-setup.md` akışını başlatır.
+- Eğer `.kortext/workspace/memory/context/` içinde aktif görev dosyası varsa, `+operation-manager` dosyada belirtilen ilgili ajanı devam ettirir.
+- Eğer aktif görev yoksa ama `.kortext/workspace/memory/handover.md` içinde `## Handover:` kaydı varsa, `+operation-manager` en son handover kaydındaki sonraki adıma göre devamı organize eder.
+- Eğer aktif görev ve handover kaydı yoksa, `+operation-manager` `.kortext/workflows/00-kortext-setup.md` akışını başlatır.
 
 ## Şablon Kuralı
 
-- `kortext/workspace/templates/` altındaki dosyalar çalışma durumu sayılmaz.
+- `.kortext/workspace/templates/` altındaki dosyalar çalışma durumu sayılmaz.
 - 

package/README.md

@@ -23,14 +23,14 @@ No coding knowledge required. You describe what you want to build — Kortext ag
 ## Quick Start
 
 ```bash
-# Install
+# Install (one-time, global)
 npm install -g kortext
 
 # In your project directory
 kortext init
 
 # Fill in the blueprint (describes your product)
-# workspace/references/blueprint.md
+# .kortext/workspace/references/blueprint.md
 
 # Then tell your AI agent:
 # !start analysis
@@ -41,15 +41,22 @@ kortext init
 ## Architecture
 
 ```
-kortext/
-├── agents/          # 14 persona definitions (operation-manager, backend-dev, qa...)
-├── workflows/       # 12 workflow pipelines (analysis, planning, dev, deploy...)
-├── hooks/           # 16 git + runtime hooks (lock, audit, secret-scan, snapshot...)
-├── scripts/         # 13 Python automation scripts (backlog, handover, health...)
-├── rules/           # Behavior rules, commands, branching strategy
-├── settings/        # Config, runtime adapters (Claude/Gemini/Codex), INTEGRATION-MAP
-├── skills/          # Per-persona skill folders (populate with your stack)
-└── workspace/       # Memory, backlog, references, templates, reports
+proje/
+├── AGENTS.md              # AI runtime entry point (auto-generated by kortext init)
+└── .kortext/              # All framework files live here (like .git/)
+    ├── agents/            # 14 persona definitions
+    ├── workflows/         # 12 workflow pipelines
+    ├── hooks/             # 16 git + runtime hooks
+    ├── scripts/           # 13 Python automation scripts
+    ├── rules/             # Behavior rules, commands, branching strategy
+    ├── settings/          # Config, runtime adapters, INTEGRATION-MAP
+    ├── skills/            # Per-persona skill folders
+    └── workspace/         # Memory, backlog, references, templates, reports
+        ├── references/
+        │   └── blueprint.md   # ← You fill this in
+        └── memory/
+            ├── backlog/       # Tasks live here
+            └── context/       # Active agent files
 ```
 
 ---

package/hooks/kortext-lib.sh

@@ -6,7 +6,7 @@ kortext_find_root() {
     local dir="${1:-$PWD}"
 
     while [ "$dir" != "/" ]; do
-        if [ -d "$dir/kortext/hooks" ] || [ -d "$dir/.kortext/hooks" ]; then
+        if [ -d "$dir/.kortext/hooks" ]; then
             printf '%s\n' "$dir"
             return 0
         fi
@@ -18,16 +18,26 @@ kortext_find_root() {
 
 KORTEXT_ROOT="${KORTEXT_ROOT:-$(kortext_find_root "$PWD" 2>/dev/null || pwd)}"
 
-if [ -d "$KORTEXT_ROOT/kortext" ]; then
-    KORTEXT_REL="${KORTEXT_REL:-kortext}"
-elif [ -d "$KORTEXT_ROOT/.kortext" ]; then
-    KORTEXT_REL="${KORTEXT_REL:-.kortext}"
-else
-    KORTEXT_REL="${KORTEXT_REL:-kortext}"
+# .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_DIR="${KORTEXT_DIR:-$KORTEXT_ROOT/$KORTEXT_REL}"
-KORTEXT_WORKSPACE_DIR="${KORTEXT_WORKSPACE_DIR:-$KORTEXT_DIR/workspace}"
+# 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"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kortext",
-  "version": "2.2.0",
+  "version": "2.2.3",
   "description": "AI Agent Framework for Operational Discipline and Automated Project Management",
   "main": "index.js",
   "bin": {

package/rules/behavior.md

@@ -246,7 +246,7 @@ Projeye özel `workspace/references/` ve `workspace/reports/` dosyalarında onay
 
 ### İletişim Dili (Communication Language)
 
-1.  **Config Kontrolü:** Ajan, her oturum başında `kortext/settings/config.md` dosyasındaki `KORTEXT_INTERACTION_LANGUAGE` değerini okumalıdır.
+1.  **Config Kontrolü:** Ajan, her oturum başında `.kortext/settings/config.md` dosyasındaki `KORTEXT_INTERACTION_LANGUAGE` değerini okumalıdır.
 2.  **Dil Uyumu:** Kullanıcı ile kurulan tüm iletişim (yanıtlar, açıklamalar, raporlar), config dosyasında belirtilen dilde (`tr` veya `en`) yapılmalıdır.
 3.  **Teknik İstisna:** Dosya yolları, kod blokları, hata mesajları ve framework çekirdek terimleri (Backlog Item ID, Persona isimleri vb.) orijinal formatında (genellikle İngilizce) bırakılmalıdır.
-4.  **Dinamik Değişim:** Eğer kullanıcı sohbet sırasında dili değiştirirse, ajan kullanıcıyı `config.md` dosyasını güncellemeye yönlendirmeli, ancak o andan itibaren yeni dilde yanıt vermeye başlamalıdır.
+4.  **Dinamik Değişim:** Eğer kullanıcı sohbet sırasında dili değiştirirse, ajan kullanıcıyı `.kortext/settings/config.md` dosyasını güncellemeye yönlendirmeli, ancak o andan itibaren yeni dilde yanıt vermeye başlamalıdır.

package/scripts/kortext-cli.py

@@ -74,13 +74,94 @@ def _run_shell_script(script_path: Path, args: list[str], env_overrides: dict[st
     return result.returncode
 
 
+def _scaffold_project(project_dir: Path) -> Path:
+    """Tüm framework dosyalarını proje/.kortext/ altına kopyalar.
+
+    Yapı:
+        proje/
+        ├── AGENTS.md          ← AI runtime'ın proje kökünde bulduğu dosya
+        └── .kortext/
+            ├── agents/
+            ├── hooks/
+            ├── scripts/
+            ├── workflows/
+            ├── rules/
+            ├── settings/
+            └── workspace/     ← proje-spesifik bellek (backlog, context...)
+
+    İkinci çalıştırmada mevcut .kortext/'e dokunulmaz; workspace/ güncellenmez
+    (içinde proje verisi olabilir).
+    """
+    import shutil
+
+    kortext_dst = project_dir / ".kortext"
+
+    if kortext_dst.exists():
+        print(f"ℹ️  .kortext/ zaten mevcut, atlandı: {kortext_dst}")
+    else:
+        # Tüm framework klasörlerini kopyala
+        folders = ["agents", "hooks", "scripts", "workflows", "rules", "settings", "skills", "workspace"]
+        kortext_dst.mkdir()
+        for folder in folders:
+            src = ROOT / folder
+            dst = kortext_dst / folder
+            if src.exists():
+                shutil.copytree(str(src), str(dst))
+        print(f"✅ .kortext/ oluşturuldu: {kortext_dst}")
+
+    # AGENTS.md proje kökünde olmalı (AI runtime'lar buraya bakar)
+    agents_src = ROOT / "AGENTS.md"
+    agents_dst = project_dir / "AGENTS.md"
+    if agents_src.exists() and not agents_dst.exists():
+        shutil.copy2(str(agents_src), str(agents_dst))
+        print(f"✅ AGENTS.md kopyalandı: {agents_dst}")
+    elif agents_dst.exists():
+        print(f"ℹ️  AGENTS.md zaten mevcut, atlandı.")
+
+    return kortext_dst
+
+
 def cmd_init(args: argparse.Namespace) -> int:
-    """`kortext init` — kortext-init.sh'i tetikler. Runtime bilgisi env ile geçer."""
-    env: dict[str, str] = {}
+    """`kortext init` — proje dizinine .kortext/ scaffold eder,
+    git hook'larını ve runtime adapter'ı kurar.
+    """
+    project_dir = Path.cwd()
+
+    # 1. Her şeyi .kortext/ altına kopyala
+    kortext_dst = _scaffold_project(project_dir)
+
+    # 2. Git hook'ları ve runtime adapter: .kortext/ içindeki hook'lardan çalıştır
+    env: dict[str, str] = {
+        "KORTEXT_ROOT": str(project_dir),   # proje kökü
+        "KORTEXT_DIR": str(kortext_dst),    # .kortext/ dizini
+        "KORTEXT_WORKSPACE_DIR": str(kortext_dst / "workspace"),
+    }
     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)
+
+    init_sh = kortext_dst / "hooks" / "kortext-init.sh"
+    rc = _run_shell_script(init_sh, ["--install-hooks"], env)
+    if rc != 0:
+        return rc
+
+    _run_shell_script(init_sh, ["--install-runtime"], env)
+
+    # 4. .kortext/ ve AGENTS.md'yi git'e ekle (varsa git repo)
+    if (project_dir / ".git").exists():
+        subprocess.run(
+            ["git", "add", ".kortext/", "AGENTS.md"],
+            cwd=str(project_dir),
+            capture_output=True,
+        )
+        print("✅ .kortext/ git'e eklendi (git add)")
+
+    print("\n🎉 Kortext kurulumu tamamlandı.")
+    print(f"\n   proje/")
+    print(f"   ├── AGENTS.md")
+    print(f"   └── .kortext/          ← tüm framework burada (git'te)")
+    print(f"\n💡 Sıradaki adım: .kortext/workspace/references/blueprint.md dosyasını doldur,")
+    print(f"   ardından AI ajanına '!start analysis' yaz.\n")
+    return 0
 
 
 def cmd_start(args: argparse.Namespace) -> int:

package/settings/README.md

@@ -9,10 +9,10 @@
 
 Kortext, birden fazla personanın (`/agents/`) kendi rolleri, yetenekleri ve görevleri doğrultusunda; belirlenmiş olan kural (`/rules/`) ve talimatlara (`/workflows/`) uygun olarak projeyi (`/workspace/`) hayata geçirme adımlarını tanımlar. 
 
-> Nihai kurulumda aşağıdaki tüm dosya ve dizinler proje kökündeki `.kortext/` altında yer alır. Framework geliştirme çalışmaları sırasında gizli klasörle uğraşmamak için aynı yapı geçici olarak `kortext/` adıyla tutulabilir; yayın öncesi toplu dönüşümle `.kortext/` adına geçirilir. Başlangıç komut dosyası (`AGENTS.md`) proje kök dizininde yer alır:
+> Tüm dosya ve dizinler proje kökündeki `.kortext/` altında yer alır. Başlangıç komut dosyası (`AGENTS.md`) proje kök dizininde yer alır:
  
 ```text
-kortext/
+.kortext/
 ├── agents/                 # Uzmanlaşmış persona tanımları, yetkiler ve iş akışları
 ├── hooks/                  # Otomatik sistem denetimleri, Git kalkanları ve güvenlik tetikleyicileri
 ├── rules/                  # Projeden bağımsız, tüm personaların uyması gereken katı kurallar

package/settings/USER-GUIDE.md

@@ -40,11 +40,11 @@ Kortext, bir AI ajanı (Claude, Gemini vb.) üzerinde çalışan **çok ajanlı
 
 ### 2.1 Kortext'i Projeye Ekle
 
-Kortext klasörünü projenin kökündeki `.kortext/` (veya geliştirme ortamında `kortext/`) dizinine yerleştir:
+Kortext klasörünü projenin kökündeki `.kortext/` dizinine yerleştir:
 
 ```
 proje-koku/
-├── kortext/          ← tüm Kortext dosyaları buraya
+├── .kortext/         ← tüm Kortext dosyaları buraya
 ├── AGENTS.md         ← AI ajanına "buradan başla" talimatı (proje kökünde)
 ├── src/
 └── ...
@@ -53,7 +53,7 @@ proje-koku/
 ### 2.2 Git Hook'larını Kur
 
 ```bash
-bash kortext/hooks/kortext-init.sh --install-hooks
+bash .kortext/hooks/kortext-init.sh --install-hooks
 ```
 
 Bu komut şu hook'ları kurar:
@@ -76,7 +76,7 @@ export KORTEXT_HOOK_MODE="strict"          # ihlallerde uyarı yerine hata ver
 
 ### Adım 1 — Blueprint'i Doldur
 
-`kortext/workspace/references/blueprint.md` dosyasını aç ve doldur:
+`.kortext/workspace/references/blueprint.md` dosyasını aç ve doldur:
 
 ```markdown
 # Proje Adı

package/settings/VERSION

@@ -1 +1 @@
-2.3.0
+2.2.3