@omerrgocmen/crewctl 1.1.1 → 1.3.1

package/orchestrator/src/engine.js

@@ -9,11 +9,49 @@ const checkpoints = require("./checkpoints");
 
 const isWin = process.platform === "win32";
 
+// Ajan hapsi (path-aware, Claude icin). cfg.sandbox.mode === "workspace" iken orkestratorun
+// kendi dizinlerini (veri koku ROOT = config/memory/state, paket ASSETS, kurulum WORK_BASE)
+// Claude'un gozunden gizler: Read/Edit/Write bu yollara permissions.deny ile kapatilir.
+// Docker/Git GEREKTIRMEZ. Codex ayni korumayi effectiveAgent'ta OS-native sandbox ile alir;
+// gemini/opencode icin path-scoped native kural olmadigindan yalnizca prompt talimati gecerli.
+// Calisma klasoru bu korunan dizinlerden birinin ICINDEYSE (or. gelistirme modunda repo'nun
+// kendisinde calismak) o dizin KORUNMAZ — mevcut is bozulmasin diye.
+function claudeSandboxSettings(agent, cwd, cfg) {
+  if (cfg?.sandbox?.mode !== "workspace") return null;
+  const adapter = agent?.adapter || cliRegistry.adapterId(agent?.cmd);
+  if (adapter !== "claude") return null;
+  const norm = (p) => path.resolve(p).replace(/\\/g, "/");
+  // Windows dosya sistemi buyuk/kucuk harfe duyarsizdir: C:\Test ile c:\test ayni dizindir.
+  // Karsilastirmayi case-fold'la yap; aksi halde farkli case yazilmis bir cwd, kurulum
+  // dizinini yanlislikla "disarida" sanip DENY eder (ajan kendi calisma agacinin ustune
+  // erisemez, hatta cwd==kurulum dizini iken kendi klasorune yazamaz).
+  const fold = (p) => (isWin ? p.toLowerCase() : p);
+  const workDir = norm(cwd);
+  const workCmp = fold(workDir);
+  const overlaps = (dir) => {
+    const d = fold(dir);
+    return d === workCmp || d.startsWith(workCmp + "/") || workCmp.startsWith(d + "/");
+  };
+  const protectedDirs = [store.ROOT, store.ASSETS, store.WORK_BASE]
+    .map(norm)
+    .filter((dir, i, all) => all.findIndex((other) => fold(other) === fold(dir)) === i)
+    .filter((dir) => !overlaps(dir));
+  if (!protectedDirs.length) return null;
+  const deny = [];
+  for (const dir of protectedDirs) {
+    for (const tool of ["Read", "Edit", "Write"]) deny.push(`${tool}(${dir}/**)`);
+  }
+  return { permissions: { deny } };
+}
+
 function snapshotDir(dir) {
   const map = new Map();
   const ignored = (rel) => {
     const r = rel.replace(/\\/g, "/");
+    // .crewctl/ orkestratorun kendi proje-context'ini (CONTEXT.md) tutar; gorev diff'lerinde,
+    // live-diff'te ve teslimat dosya listesinde gozukmesin (kullanicinin isi degil).
     return r.includes("node_modules") || r.includes(".git/") || r.startsWith(".git") ||
+      r === ".crewctl" || r.startsWith(".crewctl/") ||
       r.startsWith("orchestrator/queue") || r.startsWith("orchestrator/state") ||
       r.startsWith("orchestrator/memory") || r.startsWith("orchestrator/node_modules");
   };
@@ -223,6 +261,14 @@ function clip(value, limit = 12000) {
   return text.length <= limit ? text : `${text.slice(0, limit)}\n...[kesildi]`;
 }
 
+// Sohbet odakli CLI'lar profili bazen ``` ile sarar; profil dosyasina ham metni yazariz.
+// Yalnizca tum icerigi saran TEK bir dis fence'i soyar; ic kod bloklarina dokunmaz.
+function stripCodeFence(text) {
+  const trimmed = String(text || "").trim();
+  const match = trimmed.match(/^```[a-zA-Z0-9]*\s*\n([\s\S]*?)\n?```$/);
+  return match ? match[1] : trimmed;
+}
+
 // Bas ve sonu koruyarak kirpar. Denetci raporlarinda VERDICT satiri metnin SONUNDadir;
 // yalnizca bastan kirpmak operatorun karari gormemesine ve gereksiz yeniden inceleme
 // turlarina yol acar.
@@ -257,20 +303,30 @@ function meaningfulErrorLine(raw) {
 // daraltildi ve kimlik kontrollerinin arkasina alindi.
 function classifyCliError(error) {
   const raw = String(error?.message || error || "Bilinmeyen CLI hatasi");
-  const of = (code, summary, action) => ({ code, summary, action, raw: clip(raw, 5000) });
+  // Hatanin geldigi CLI biliniyorsa tavsiye ona gore uretilir (runCli her hatayi etiketler).
+  const adapter = error?.adapter || "";
+  const agentName = error?.agentName || "";
+  const of = (code, summary, action) => ({ code, summary, action, agent: agentName, adapter, raw: clip(raw, 5000) });
   if (/requires a newer version|upgrade to the latest|model metadata.*not found|unsupported.*model|model.*unsupported/i.test(raw)) {
     return of("VERSION_INCOMPATIBLE", "CLI sürümü seçilen modeli desteklemiyor.", "CLI aracını güncelleyin veya desteklenen bir model seçin.");
   }
   if (/sessiz kaldi|cikti uretmedi|CLI_STALLED/i.test(raw)) {
     return of("CLI_STALLED", "CLI uzun süre yeni çıktı üretmeyince otomatik durduruldu.", "Önceki ilerleme kayıtları korundu; operatör bu oturumda farklı bir agent kullanacak.");
   }
+  // "No provider available" 401 ile gelir ama OTURUM sorunu degildir: secili model hicbir
+  // saglayiciya cozulemiyordur. Genel 401/403 kuralindan ONCE gelmeli, yoksa zaten girisli
+  // kullaniciya bosuna "oturum acin" denir.
+  if (/no provider available/i.test(raw)) {
+    return of("PROVIDER_UNAVAILABLE", "Seçili model hiçbir yapılandırılmış sağlayıcıya çözümlenemedi (oturum sorunu değil).",
+      "Ayarlar → Agent'lar bölümünde bu agent için açık bir model seçin. Model boşken OpenCode kendi son kullandığı modele düşer; o model erişilemezse görev bu hatayla durur.");
+  }
   if (/API key not valid|API_KEY_INVALID|invalid[_ ]api[_ ]key|incorrect api key/i.test(raw)) {
-    return of("AUTH_INVALID", "API anahtarı geçersiz veya reddedildi.", "Agent ayarlarındaki API anahtarını yenileyin (Gemini için GEMINI_API_KEY / GOOGLE_API_KEY).");
+    return of("AUTH_INVALID", "API anahtarı geçersiz veya reddedildi.", `Bu agent'ın API anahtarını yenileyin. ${cliRegistry.authHint(adapter)}`);
   }
   // Gemini CLI oturum acilmadiginda "Please set an Auth method" / "GEMINI_API_KEY environment
   // variable not found" yazar; her ikisi de kurulum degil OTURUM sorunudur.
   if (/set an auth method|GEMINI_API_KEY|GOOGLE_API_KEY|unauthorized|unauthenticated|authentication|login required|not logged in|please (run )?login|credentials? (not found|missing|expired)|PERMISSION_DENIED|\b40[13]\b/i.test(raw)) {
-    return of("AUTH_REQUIRED", "CLI oturum açmamış; kimlik doğrulaması gerekiyor.", "Terminalde ilgili CLI ile oturum açın (Gemini: `gemini` çalıştırıp 'Login with Google' veya GEMINI_API_KEY tanımlayın), sonra görevi tekrar deneyin.");
+    return of("AUTH_REQUIRED", "CLI oturum açmamış; kimlik doğrulaması gerekiyor.", `${cliRegistry.authHint(adapter)} Sonra görevi tekrar deneyin.`);
   }
   // Kota (gunluk/aylik hak bitti) ile hiz siniri (kisa sureli) AYRI teshislerdir: ilki
   // beklemekle gecmez, ikincisi gecer. Kullanicinin sordugu "limitim mi bitti" ayrimi budur.
@@ -287,13 +343,16 @@ function classifyCliError(error) {
     return of("REGION_BLOCKED", "Model bulunduğunuz bölgede kullanıma kapalı.", "Desteklenen bir bölge/hesap kullanın veya başka bir sağlayıcının agent'ını seçin.");
   }
   if (/ConnectionRefused|Unable to connect|provider hatasi|provider error|ECONNREFUSED/i.test(raw)) {
-    return of("PROVIDER_UNAVAILABLE", "Seçilen model sağlayıcısına bağlanılamadı.", "Sağlayıcı bağlantısını kontrol edin veya başka bir model seçin.");
+    return of("PROVIDER_UNAVAILABLE", "Seçilen model sağlayıcısına bağlanılamadı veya model çözümlenemedi.",
+      adapter === "opencode"
+        ? "Ayarlar → Agent'lar bölümünde bu agent için açık bir model seçin (`opencode models` listesinden). Model seçili değilken OpenCode kendi son kullandığı modele düşer ve bu model erişilemez olabilir."
+        : "Sağlayıcı bağlantısını kontrol edin veya başka bir model seçin.");
   }
   if (/ENOTFOUND|EAI_AGAIN|ECONNRESET|ETIMEDOUT|getaddrinfo|fetch failed|socket hang up|network (error|unreachable)|proxy/i.test(raw)) {
     return of("NETWORK_ERROR", "Ağ bağlantısı kurulamadı (DNS/proxy/internet).", "İnternet veya kurumsal proxy ayarlarınızı kontrol edip görevi tekrar çalıştırın.");
   }
   if (/not recognized as an internal|is not recognized|command not found|spawn .*ENOENT|\bENOENT\b|no such file or directory/i.test(raw)) {
-    return of("CLI_NOT_FOUND", "CLI komutu bulunamadı; kurulu değil veya PATH üzerinde görünmüyor.", "CLI'yi kurun (Gemini: `npm install -g @google/gemini-cli`) ve Ayarlar → Agent'lar bölümünde komut adını doğrulayın.");
+    return of("CLI_NOT_FOUND", "CLI komutu bulunamadı; kurulu değil veya PATH üzerinde görünmüyor.", `${adapter && adapter !== "custom" ? `${adapter} CLI'sini kurun` : "CLI'yi kurun"} ve Ayarlar → Agent'lar bölümünde komut adını doğrulayın (kurulum komutları için Doctor ekranına bakın).`);
   }
   if (/timeout|timed out|zaman asim|zaman aşım/i.test(raw)) {
     return of("TIMEOUT", "CLI ayrılan süre içinde tamamlanamadı.", "Agent ayarlarından timeout değerini artırın veya görevi daha küçük parçalara bölün.");
@@ -305,6 +364,21 @@ const RECOVERABLE_CLI_ERRORS = new Set(["AUTH_INVALID", "AUTH_REQUIRED", "RATE_L
 // Karantina = bu oturumda tekrar denemek anlamsiz. Kota/bolge kisiti beklemekle gecmez;
 // hiz siniri (RATE_LIMIT) ve gecici saglayici hatasi (MODEL_OVERLOADED) gecer, karantinaya alinmaz.
 const QUARANTINE_CLI_ERRORS = new Set(["AUTH_INVALID", "AUTH_REQUIRED", "QUOTA_EXCEEDED", "REGION_BLOCKED", "PROVIDER_UNAVAILABLE", "CLI_NOT_FOUND", "CLI_STALLED", "VERSION_INCOMPATIBLE"]);
+// Birkac saniyede kendiliginden gecer; operatore geri tasiyip planlama turu harcamak yerine
+// ayni agent ustel bekleme ile yeniden denenir.
+const TRANSIENT_CLI_ERRORS = new Set(["RATE_LIMIT", "MODEL_OVERLOADED", "NETWORK_ERROR"]);
+// Karantina suresi (sn). 0 = beklemekle duzelmez, kalici. Digerleri sure dolunca yeniden
+// denenir (half-open); tekrar duserse sure katlanir (bkz. quarantineAgent).
+const QUARANTINE_COOLDOWN_SECONDS = {
+  AUTH_REQUIRED: 180,
+  AUTH_INVALID: 180,
+  PROVIDER_UNAVAILABLE: 180,
+  CLI_STALLED: 300,
+  QUOTA_EXCEEDED: 0,
+  REGION_BLOCKED: 0,
+  CLI_NOT_FOUND: 0,
+  VERSION_INCOMPATIBLE: 0,
+};
 
 function resolveExecutionMode(task) {
   if (["fast", "balanced", "deep"].includes(task.executionMode)) return task.executionMode;
@@ -379,7 +453,6 @@ function normalizeCliOutput(agent, stdout) {
       const event = JSON.parse(line);
       if (event.type === "text" && event.part?.text) texts.push(String(event.part.text));
       if (event.type === "error") errors.push(String(event.error?.message || event.error || "OpenCode model/provider hatasi"));
-      // Bir kosumda birden fazla adim olabilir; hepsi toplanir.
       if (event.type === "step_finish") {
         const step = readStepUsage(event);
         if (step) usage = addUsage(usage, step);
@@ -592,6 +665,15 @@ function compatibleAgentForKind(cfg, operatorName, kind) {
   )?.[0] || "";
 }
 
+// Devretme adaylari. Karantina filtresi cagirana birakilir: sureli oldugu icin karar canli
+// durumdan (isQuarantined) okunmalidir.
+function compatibleAgentsForKind(cfg, operatorName, kind) {
+  return Object.entries(cfg.agents || {})
+    .filter(([name, agent]) =>
+      name !== operatorName && agent.enabled !== false && agentUsable(agent) && supportsKind(agent, kind))
+    .map(([name]) => name);
+}
+
 function nextAssignmentId(base, usedIds) {
   let id = base;
   let suffix = 2;
@@ -672,6 +754,7 @@ class Engine extends EventEmitter {
     // Kalici config'i degistirmeyiz; kullanici kimlik bilgisini duzeltip motoru yeniden
     // baslattiginda agent tekrar denenebilir.
     this.unhealthyAgents = new Map();
+    this._retrySleepers = new Set();
     // Canli kodlama akisi: gorev calisirken calisma klasorunu periyodik tarayan zamanlayici
     // ve son yayinlanan degisiklik imzasi (ayni durum tekrar tekrar yayinlanmasin diye).
     this._liveTimer = null;
@@ -818,6 +901,7 @@ class Engine extends EventEmitter {
   stop() {
     this.running = false;
     this.wake();
+    this.cancelRetrySleeps();
     this.stopLiveDiff();
     if (this.activeChild) {
       try { this.activeChild.kill(); } catch {}
@@ -842,6 +926,58 @@ class Engine extends EventEmitter {
     });
   }
 
+  // sleepWake'ten AYRIDIR: o bos donguye aittir ve yeni gorev eklendiginde uyanir. Bu bekleme
+  // yalnizca motor durdurulunca kesilmeli.
+  sleepRetry(ms) {
+    return new Promise((resolve) => {
+      const sleeper = { resolve, timer: null };
+      sleeper.timer = setTimeout(() => { this._retrySleepers.delete(sleeper); resolve(); }, ms);
+      this._retrySleepers.add(sleeper);
+    });
+  }
+
+  cancelRetrySleeps() {
+    for (const sleeper of this._retrySleepers) {
+      clearTimeout(sleeper.timer);
+      sleeper.resolve();
+    }
+    this._retrySleepers.clear();
+  }
+
+  // Sureli karantina: kullanici oturum acar veya saglayici toparlanirsa agent kendiliginden
+  // doner. Tekrar duserse ceza katlanir (en fazla 15 dk); suresi 0 olanlar kalici kalir.
+  quarantineAgent(name, code, cfg) {
+    const strikes = (this.unhealthyAgents.get(name)?.strikes || 0) + 1;
+    const baseSeconds = QUARANTINE_COOLDOWN_SECONDS[code] ?? 120;
+    const cooldownMs = baseSeconds > 0 ? Math.min(900, baseSeconds * strikes) * 1000 : 0;
+    this.unhealthyAgents.set(name, {
+      code, strikes, at: new Date().toISOString(),
+      until: cooldownMs ? Date.now() + cooldownMs : 0,
+    });
+    if (cfg) cfg.runtimeUnavailableAgents = this.quarantinedAgents();
+    this.publish("log", {
+      level: "warn",
+      msg: cooldownMs
+        ? `${name} [${code}] nedeniyle ${Math.round(cooldownMs / 1000)} sn karantinada; sure dolunca otomatik yeniden denenecek.`
+        : `${name} [${code}] nedeniyle bu oturumda kullanim disi (beklemekle duzelmez).`,
+    });
+  }
+
+  isQuarantined(name) {
+    const entry = this.unhealthyAgents.get(name);
+    if (!entry) return false;
+    if (entry.until && Date.now() >= entry.until) {
+      this.unhealthyAgents.delete(name);
+      this.publish("log", { level: "info", msg: `${name} karantina suresi doldu; yeniden deneme hakki verildi.` });
+      return false;
+    }
+    return true;
+  }
+
+  quarantinedAgents() {
+    return [...this.unhealthyAgents.keys()].filter((name) => this.isQuarantined(name));
+  }
+
   async loop() {
     while (this.running) {
       const task = store.nextPending();
@@ -852,7 +988,7 @@ class Engine extends EventEmitter {
       try {
         await this.runTask(task);
       } catch (error) {
-        if (!this.salvage(task, error)) {
+        if (!(await this.salvage(task, error))) {
           const found = store.findTask(task.id);
           const failure = classifyCliError(error);
           task.status = "failed";
@@ -883,7 +1019,6 @@ class Engine extends EventEmitter {
     }
   }
 
-  // Uzman agent'i (operatorun altindaki ekip) cfg.agents'ten cozup calistirir.
   invokeAgent(agentName, prompt, cfg, meta = {}) {
     const configuredAgent = cfg.agents[agentName];
     const agent = configuredAgent && cliRegistry.effectiveAgent(configuredAgent, cfg);
@@ -900,7 +1035,15 @@ class Engine extends EventEmitter {
   }
 
   runCli(displayName, agent, prompt, cfg, meta = {}) {
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve, rawReject) => {
+      // Her hata hangi CLI'dan geldigini tasir; tavsiye metni buna gore uretilir. Etiket yokken
+      // opencode hatasinda kullaniciya gemini komutu oneriliyordu. Bkz. classifyCliError.
+      const reject = (cause) => {
+        const error = cause instanceof Error ? cause : new Error(String(cause));
+        if (!error.agentName) error.agentName = displayName;
+        if (!error.adapter) error.adapter = agent.adapter || cliRegistry.adapterId(agent.cmd);
+        rawReject(error);
+      };
       const count = store.bumpCallCount();
       if (count > (cfg.dailyCallBudget || Number.MAX_SAFE_INTEGER)) {
         return reject(new Error(`Gunluk cagri butcesi asildi (${cfg.dailyCallBudget}).`));
@@ -928,10 +1071,23 @@ class Engine extends EventEmitter {
         }
         return String(arg);
       });
+      const cwd = this._cwd || path.resolve(store.WORK_BASE, cfg.workingDir || ".");
+      // Path-aware hapis: codex sandbox'i disariyi zaten OS-native kapatir (effectiveAgent).
+      // Claude'un OS sandbox'i her platformda (ozellikle Windows'ta) olmadigi icin en azindan
+      // orkestratorun kendi topragini (config/memory/kurulum dizini) permissions.deny ile gizler.
+      // JSON'u arguman olarak gecmek Windows cmd.exe'de tirnaklari bozar; bu yuzden dosyaya yazip
+      // yolunu veriyoruz (prompt dosyasiyla ayni desen).
+      const sandboxSettings = claudeSandboxSettings(agent, cwd, cfg);
+      if (sandboxSettings) {
+        const sbDir = path.join(store.ROOT, "state", "prompts");
+        fs.mkdirSync(sbDir, { recursive: true });
+        const sbFile = path.join(sbDir, `${callId}.settings.json`);
+        fs.writeFileSync(sbFile, JSON.stringify(sandboxSettings), "utf8");
+        rawArgs.push("--settings", sbFile);
+      }
       const command = cliRegistry.buildCommand(agent.cmd, rawArgs);
       const file = command.file;
       const args = command.args;
-      const cwd = this._cwd || path.resolve(store.WORK_BASE, cfg.workingDir || ".");
       const started = Date.now();
       let stdout = "", stderr = "", settled = false, timedOut = false, silenceTimedOut = false;
       let timer, silenceTimer, progressTimer;
@@ -1047,12 +1203,27 @@ class Engine extends EventEmitter {
   hasUsableImplementAgent(cfg, operatorName) {
     return Object.entries(cfg.agents || {}).some(([name, agent]) =>
       name !== operatorName && agent.enabled !== false && agentUsable(agent)
-      && !this.unhealthyAgents.has(name) && supportsKind(agent, "implement"));
+      && !this.isQuarantined(name) && supportsKind(agent, "implement"));
+  }
+
+  // Sureli karantinadaki implement agentinin donusune kalan sure (ms). Geri donen yoksa ya da
+  // bekleme makul siniri asiyorsa null; cagiran bunu "gorevi durdur" olarak yorumlar.
+  msUntilImplementAgentReturns(cfg, operatorName, maxWaitMs = 5 * 60 * 1000) {
+    const now = Date.now();
+    const returns = Object.entries(cfg.agents || {})
+      .filter(([name, agent]) => name !== operatorName && agent.enabled !== false
+        && agentUsable(agent) && supportsKind(agent, "implement"))
+      .map(([name]) => this.unhealthyAgents.get(name)?.until || 0)
+      .filter((until) => until > now)
+      .sort((a, b) => a - b);
+    if (!returns.length) return null;
+    const waitMs = returns[0] - now;
+    return waitMs <= maxWaitMs ? waitMs : null;
   }
 
   agentCatalog(cfg, operatorName) {
     return Object.entries(cfg.agents)
-      .filter(([name, agent]) => name !== operatorName && agent.enabled !== false && agentUsable(agent) && !this.unhealthyAgents.has(name))
+      .filter(([name, agent]) => name !== operatorName && agent.enabled !== false && agentUsable(agent) && !this.isQuarantined(name))
       .map(([name, a]) => ({
         name,
         description: a.description || "",
@@ -1168,7 +1339,8 @@ class Engine extends EventEmitter {
       skillSection +
       `## Kullanici gorevi\n${task.prompt}\n` +
       `## Calisma klasoru\n${this._cwd}\n` +
-      `## Proje hafizasi (gecmis baglam — gecmis teslimatlar mevcut gorevi TAMAMLANMIS SAYDIRMAZ; kanit olarak degil ipucu olarak kullan)\n${clip(memory, cfg.memoryCharBudget || 8000)}\n` +
+      `SANDBOX: Butun is YALNIZCA bu klasorde yapilir. Bu klasor disina (ust dizinler, orkestrator/kurulum dizini, sistem dosyalari) dosya YAZMA/DEGISTIRME/SILME ve gerekmedikce disariyi OKUMA. Delegasyon talimatlarini da bu sinira gore yaz.\n` +
+      `## Proje profili (bu klasorun birikmis baglami — tum kodu bastan taramak zorunda kalmayasin diye. IPUCUDUR, kanit degil: kritik kararlarda DOSYADAN dogrula, celiski gorursen profile guvenme. Gecmis teslimatlar mevcut gorevi TAMAMLANMIS SAYDIRMAZ.)\n${clip(memory || "(henuz proje profili yok — ilk gorevde olusturulacak)", cfg.projectContextCharBudget || cfg.memoryCharBudget || 8000)}\n` +
       (phase === "review"
         ? `## Son bagimsiz denetim\n${(() => { const review = this.latestReview(state); return review ? `${review.id} (${review.agent}) → VERDICT: ${review.verdict}` : "Henuz tamamlanmis denetim yok."; })()}\n` +
           `## Takim calisma kaydi\n${this.teamDigest(state, cfg)}\n`
@@ -1197,11 +1369,64 @@ class Engine extends EventEmitter {
     return `${role}\n\n---\n## Takim agenti protokolu\n` +
       `Operator sana asagidaki isi devretti. ${instructionByKind[assignment.kind] || instructionByKind.implement} ` +
       `Planda olmayan riskli bir is gerekiyorsa yapma; BLOCKED olarak bildir. Yalnizca gercekten gozlemledigin veya dogruladigin sonuclari yaz.\n` +
+      `SANDBOX: Butun is YALNIZCA calisma klasorunde (${this._cwd}) yapilir. Bu klasor disina dosya YAZMA/DEGISTIRME/SILME ve gerekmedikce disariyi OKUMA.\n` +
       (skillRefs ? `## Uygulanacak beceriler\nBu is icin asagidaki beceri rehberleri secildi. Her satirda becerinin OZETI ve TAM rehberin DOSYA YOLU var. Ozet yeterliyse dogrudan uygula; daha fazla ayrinti gerekiyorsa ilgili dosyayi OKU ve prosedure uy. Ilgisiz bir sey varsa gormezden gel.\n${skillRefs}\n` : "") +
       `## Ana hedef\n${task.prompt}\n## Delegasyon\nID: ${assignment.id}\n${assignment.instruction}\n` +
       `## Onceki tamamlanan takim isleri\n${clip(JSON.stringify(completed, null, 2), cfg.teamContextCharBudget || 30000)}`;
   }
 
+  // Iki kademeli kurtarma: (1) gecici hata -> ayni agent, ustel bekleme; (2) kalici hata ->
+  // ayni turu yapabilen saglikli baska agente devret. Ikisi de tukenirse firlatir ve operator
+  // yeniden planlar. Amac, saniyelik bir 429 icin tam bir operator turu harcamamak.
+  async runAssignmentWithRecovery(task, cfg, assignment, state) {
+    const retries = Math.max(0, cfg.resilience?.transientRetries ?? 2);
+    const maxFailovers = Math.max(0, cfg.resilience?.maxFailoverAgents ?? 1);
+    const baseDelayMs = Math.max(250, (cfg.resilience?.retryBaseSeconds ?? 3) * 1000);
+    const tried = new Set();
+    let agentName = assignment.agent;
+    let failure = null;
+
+    for (let failover = 0; ; failover++) {
+      tried.add(agentName);
+      for (let attempt = 0; ; attempt++) {
+        try {
+          const response = await this.invokeAgent(
+            agentName,
+            this.specialistPrompt(task, cfg, { ...assignment, agent: agentName }, state),
+            cfg,
+            { stage: "delegate", assignmentId: assignment.id }
+          );
+          return { response, agent: agentName };
+        } catch (error) {
+          if (!this.running) throw error;
+          failure = classifyCliError(error);
+          if (!TRANSIENT_CLI_ERRORS.has(failure.code) || attempt >= retries) break;
+          // Jitter: ayni anda dusen birden fazla delegasyon saglayiciya es zamanli geri donmesin.
+          const waitMs = Math.min(30000, baseDelayMs * 2 ** attempt) + Math.floor(Math.random() * 750);
+          this.publish("log", { level: "warn", msg: `${agentName} gecici hata verdi [${failure.code}]; ${Math.round(waitMs / 1000)} sn sonra yeniden deneniyor (${attempt + 2}/${retries + 1}).` }, task.id);
+          this.publish("activity", { kind: "delegation.retry", assignmentId: assignment.id, agent: agentName, code: failure.code, attempt: attempt + 1, waitMs });
+          await this.sleepRetry(waitMs);
+          if (!this.running) throw error;
+        }
+      }
+      if (QUARANTINE_CLI_ERRORS.has(failure.code)) this.quarantineAgent(agentName, failure.code, cfg);
+      if (failover >= maxFailovers) break;
+      const next = compatibleAgentsForKind(cfg, task.operatorCli, assignment.kind)
+        .find((name) => !tried.has(name) && !this.isQuarantined(name));
+      if (!next) break;
+      this.publish("log", { level: "warn", msg: `${agentName} basarisiz [${failure.code}]; ayni is ${next} agentine devrediliyor (operator turu harcanmadan).` }, task.id);
+      this.publish("activity", { kind: "delegation.failover", assignmentId: assignment.id, from: agentName, to: next, code: failure.code });
+      agentName = next;
+    }
+    // Siniflandirici disaridaki catch'te ayni sonucu uretsin diye ham metinle firlatiyoruz.
+    // CLI etiketi de tasinmali; yoksa oturum/kurulum tavsiyesi jenerige duser.
+    const error = new Error(failure?.raw || "Delegasyon calistirilamadi.");
+    error.agentName = failure?.agent || agentName;
+    error.adapter = failure?.adapter || "";
+    error.triedAgents = [...tried];
+    throw error;
+  }
+
   async runAssignments(task, cfg, assignments, state) {
     const pending = assignments.slice();
     while (pending.length) {
@@ -1229,32 +1454,30 @@ class Engine extends EventEmitter {
       this.publish("log", { level: "stage", msg: `DELEGE ${assignment.id} -> ${assignment.agent}` }, task.id);
       if (assignment.skills?.length) this.publish("log", { level: "info", msg: `Beceriler: ${assignment.skills.join(", ")}` }, task.id);
       try {
-        const response = await this.invokeAgent(
-          assignment.agent,
-          this.specialistPrompt(task, cfg, assignment, state),
-          cfg,
-          { stage: "delegate", assignmentId: assignment.id }
-        );
-        const result = { ...assignment, status: "completed", result: response.text, durationMs: response.durationMs, callId: response.callId };
+        const { response, agent: usedAgent } = await this.runAssignmentWithRecovery(task, cfg, assignment, state);
+        const result = { ...assignment, agent: usedAgent, status: "completed", result: response.text, durationMs: response.durationMs, callId: response.callId };
+        if (usedAgent !== assignment.agent) {
+          result.failoverFrom = assignment.agent;
+          this.publish("log", { level: "info", msg: `${assignment.id} devralan agent tarafindan tamamlandi: ${assignment.agent} -> ${usedAgent}.` }, task.id);
+        }
         if (assignment.kind === "review") {
           result.verdict = extractVerdict(response.text);
           this.publish("log", { level: "info", msg: `Denetim ${assignment.id}: VERDICT ${result.verdict || "BELIRSIZ"}` }, task.id);
         }
         state.results[assignment.id] = result;
-        const message = { from: assignment.agent, to: task.operatorCli, messageType: "result", assignmentId: assignment.id, body: response.text, at: new Date().toISOString() };
+        const message = { from: usedAgent, to: task.operatorCli, messageType: "result", assignmentId: assignment.id, body: response.text, at: new Date().toISOString() };
         state.messages.push(message);
         this.publish("message", message, task.id);
       } catch (error) {
+        // Karantina ve devretme runAssignmentWithRecovery'de tuketildi; buraya dusen gercekten
+        // kurtarilamayandir.
         const failure = classifyCliError(error);
-        if (QUARANTINE_CLI_ERRORS.has(failure.code)) {
-          this.unhealthyAgents.set(assignment.agent, { code: failure.code, at: new Date().toISOString() });
-          cfg.runtimeUnavailableAgents = [...this.unhealthyAgents.keys()];
-        }
-        state.results[assignment.id] = { ...assignment, status: "failed", result: failure.summary, error: failure };
-        const message = { from: assignment.agent, to: task.operatorCli, messageType: "failure", assignmentId: assignment.id, body: `${failure.summary}\n${failure.action}`, errorCode: failure.code, at: new Date().toISOString() };
+        const tried = error.triedAgents?.length ? error.triedAgents : [assignment.agent];
+        state.results[assignment.id] = { ...assignment, status: "failed", result: failure.summary, error: failure, triedAgents: tried };
+        const message = { from: tried[tried.length - 1], to: task.operatorCli, messageType: "failure", assignmentId: assignment.id, body: `${failure.summary}\n${failure.action}`, errorCode: failure.code, at: new Date().toISOString() };
         state.messages.push(message);
         this.publish("message", message, task.id);
-        this.publish("log", { level: "warn", msg: `${assignment.agent} kullanilamadi [${failure.code}]. Operator alternatif agent sececek.` }, task.id);
+        this.publish("log", { level: "warn", msg: `${tried.join(" > ")} kullanilamadi [${failure.code}]. Operator alternatif plan uretecek.` }, task.id);
       }
       task.teamState = state;
       store.saveTask("pending", task);
@@ -1300,8 +1523,13 @@ class Engine extends EventEmitter {
     this.emit("status", this.status());
     this.emit("queue");
 
-    cfg.runtimeUnavailableAgents = [...this.unhealthyAgents.keys()];
-    const memory = store.getMemory(cfg.memoryCharBudget);
+    cfg.runtimeUnavailableAgents = this.quarantinedAgents();
+    // Proje context: varsayilan olarak bu calisma klasorunun .crewctl/CONTEXT.md profilini
+    // yukleriz (path'e ozel, tum kodu bastan taramaya gerek kalmasin). task.freshContext ise
+    // temiz sayfa. projectContext:false ise eski GLOBAL hafiza davranisi korunur.
+    const memory = cfg.projectContext === false
+      ? store.getMemory(cfg.memoryCharBudget)
+      : (task.freshContext ? "" : store.readProjectContext(this._cwd));
     const state = task.teamState || { round: 0, plan: null, criteria: [], results: {}, messages: [], operatorDecisions: [], usedIds: [] };
     const usedIds = new Set(state.usedIds || []);
 
@@ -1395,8 +1623,24 @@ class Engine extends EventEmitter {
       if (taskRequiresDelegation(task.prompt)
           && !this.hasUsableImplementAgent(cfg, operatorCli)
           && !Object.values(state.results).some((result) => result.kind === "implement" && result.status === "completed")) {
-        const dead = [...this.unhealthyAgents.keys()];
-        throw new Error(
+        // Implement agenti yalnizca SURELI karantinadaysa gorevi oldurmek yerine bekleriz.
+        // Kalici kisitlarda (kota bitti, CLI yok) null doner.
+        const waitMs = this.msUntilImplementAgentReturns(cfg, operatorCli);
+        let recovered = false;
+        if (waitMs !== null) {
+          this.publish("log", { level: "warn", msg: `Kullanilabilir implement agenti gecici olarak yok; karantina bitene kadar ${Math.ceil(waitMs / 1000)} sn bekleniyor.` }, task.id);
+          await this.sleepRetry(waitMs + 250);
+          // Bekleme sirasinda motor durdurulduysa gorevi "implement agenti yok" hatasiyla
+          // basarisiz isaretlemek yaniltici olur; dongu kosulu zaten temiz cikisi saglar.
+          if (!this.running) break;
+          recovered = this.hasUsableImplementAgent(cfg, operatorCli);
+          if (recovered) {
+            cfg.runtimeUnavailableAgents = this.quarantinedAgents();
+            this.publish("log", { level: "info", msg: "Implement agenti karantinadan dondu; gorev surduruluyor." }, task.id);
+          }
+        }
+        const dead = this.quarantinedAgents();
+        if (!recovered) throw new Error(
           "Bu gorev dosya olusturma/degistirme gerektiriyor fakat kullanilabilir bir uygulama (implement) agenti yok" +
           (dead.length ? ` (${dead.join(", ")} bu oturumda kullanim disi kaldi)` : "") +
           ". Ayarlar > Agent'lar'dan 'implementation' yetenekli bir agent (Codex/Claude/Gemini/OpenCode) ekleyip etkinlestirin veya opencode'un oturum/model durumunu kontrol edin, sonra gorevi tekrar calistirin."
@@ -1479,7 +1723,7 @@ class Engine extends EventEmitter {
   // Gorev beklenmedik bir hatayla kesildiginde (protokol hatasi, butce asimi vb.) somut is
   // uretilmisse gorevi failed yerine uyarili kismi teslimatla kapatir. Basarili olamazsa
   // false doner ve normal hata akisi calisir.
-  salvage(task, error) {
+  async salvage(task, error) {
     try {
       if (task.kind === "operator-chat") return false;
       if (!this._cwd || !this._snapBefore) return false;
@@ -1504,7 +1748,7 @@ class Engine extends EventEmitter {
           changedFiles.slice(0, 40).map((file) => `- ${file}`).join("\n")
         : `KISMI TESLIMAT: Gorev bir altyapi/protokol hatasiyla kesildi fakat tamamlanan is korundu.\n` +
           completedWork.map((result) => `- ${result.id} (${result.agent}${result.verdict ? ` · VERDICT: ${result.verdict}` : ""})`).join("\n");
-      this.complete(task, rescueState, "done", final, {
+      await this.complete(task, rescueState, "done", final, {
         warnings: [
           `Gorev su hatayla kesildi: ${failure.summary}`,
           ...(operatorDirect ? [`Operator CLI (${task.operatorCli || "?"}) plan JSON'i yerine isi dogrudan yapti. Daha guvenilir orkestrasyon icin operator olarak JSON planlamaya uygun bir CLI (or. Codex veya Claude) secmeyi dusunun.`] : []),
@@ -1556,7 +1800,7 @@ class Engine extends EventEmitter {
     this.emit("queue");
   }
 
-  complete(task, state, status, finalText, decision = {}) {
+  async complete(task, state, status, finalText, decision = {}) {
     const changes = diffSnapshots(this._snapBefore || new Map(), snapshotDir(this._cwd));
     // Son periyodik taramadan sonra yapilan degisiklikleri de replay kaydina ve dashboard'a
     // aktar; ardindan run --once yolunda da timer'in acik kalmamasini garanti et.
@@ -1601,6 +1845,45 @@ class Engine extends EventEmitter {
     this.notifyOutcome(task, status, { summary: task.summary, rounds: state.round, fileCount: files.length, verification: task.delivery.verification });
     this.emit("queue");
     this._textBefore = null;
+    // Proje profilini guncelle (sonuc zaten kullaniciya iletildi; motor mesgul kaldigindan
+    // sonraki gorevle es zamanli operator cagrisi olmaz). Basarisizsa gorevi ASLA etkilemez.
+    await this.reviseProjectContext(task, status, files);
+  }
+
+  // Gorev bitiminde bu calisma klasorunun .crewctl/CONTEXT.md proje profilini operatore REVIZE
+  // ettirir (append degil): mimari/yapi/konvansiyon/komutlar guncel kalir, bayatlamaz. Yalnizca
+  // basarili ve DOSYA DEGISTIREN gorevlerde calisir (bilgi sorulari profili degistirmez).
+  async reviseProjectContext(task, status, files) {
+    try {
+      const cfg = this.cfg();
+      if (cfg.projectContext === false) return;
+      if (status !== "done" || !this._cwd) return;
+      if (!Array.isArray(files) || !files.length) return;
+      const operatorCli = task.operatorCli || cfg.operator?.cli;
+      if (!operatorCli || !cliRegistry.operatorSpec(operatorCli, cfg)) return;
+      const budget = cfg.projectContextCharBudget || 6000;
+      const current = store.readProjectContext(this._cwd);
+      const changed = files.map((f) => `${f.action}: ${f.path}`).join("\n");
+      const prompt =
+        `Sen bir projenin YASAYAN bilgi tabanini (proje profili) guncelliyorsun. Amac: sonraki gorevlerde ` +
+        `ajan tum kodu bastan taramadan projeyi anlasin.\n` +
+        `Asagida MEVCUT profil ve SON tamamlanan gorevin ozeti + degisen dosyalar var. Guncel, oz ve DOGRU ` +
+        `bir proje profili YAZ (Markdown). Kurallar:\n` +
+        `- Degisen gerceklere gore REVIZE et; silinen/tasinan/degisen seyleri guncelle, bayat bilgi birakma.\n` +
+        `- Dayanikli bilgiyi tut: amac, mimari, klasor/dosya yapisi, giris noktalari, onemli moduller, ` +
+        `konvansiyonlar, kurulum/calistirma/test komutlari, dikkat noktalari.\n` +
+        `- Task-by-task changelog YAZMA; tek bir GUNCEL DURUM profili olsun.\n` +
+        `- En fazla ~${budget} karakter. YALNIZCA profil metnini dondur; aciklama/selamlama/JSON/kod-bloğu isareti YAZMA.\n\n` +
+        `## Mevcut profil\n${current || "(henuz yok — sifirdan olustur)"}\n\n` +
+        `## Son tamamlanan gorev\n${task.prompt}\n\n## Sonuc ozeti\n${task.summary || ""}\n\n## Degisen dosyalar\n${changed}`;
+      const response = await this.invokeOperator(operatorCli, prompt, cfg, { stage: "operator-context" });
+      const profile = stripCodeFence(String(response?.text || "")).trim();
+      if (profile && store.writeProjectContext(this._cwd, clip(profile, budget * 2))) {
+        this.publish("log", { level: "info", msg: "Proje profili (.crewctl/CONTEXT.md) guncellendi." }, task.id);
+      }
+    } catch (error) {
+      this.publish("log", { level: "warn", msg: `Proje profili guncellenemedi: ${error.message}` }, task.id);
+    }
   }
 
   // Dis bildirim icin tek cikis noktasi: server.js bu event'i dinleyip (varsa) webhook'a POST atar.
@@ -1626,5 +1909,6 @@ module.exports._internals = {
   normalizeAssignments, ensureBalancedRoleChain, extractVerdict, clipMiddle, snapshotDir, diffSnapshots,
   captureTextSnapshot, buildLineDiff, describeFileDiff, isSensitiveDiffPath, taskRequiresDelegation,
   parseJson, conversationalAnswer, classifyCliError, RECOVERABLE_CLI_ERRORS, QUARANTINE_CLI_ERRORS,
-  normalizeCliOutput, addUsage, usageTotal,
+  TRANSIENT_CLI_ERRORS, QUARANTINE_COOLDOWN_SECONDS, compatibleAgentsForKind,
+  normalizeCliOutput, addUsage, usageTotal, claudeSandboxSettings,
 };

package/orchestrator/src/schedule.js

@@ -27,7 +27,6 @@ function pad2(n) {
   return String(n).padStart(2, "0");
 }
 
-// Ham girdiyi dogrulanmis bir tetik nesnesine cevir; gecersizse Error at.
 function normalizeTrigger(raw) {
   if (!isPlainObject(raw)) throw new Error("trigger nesnesi gerekli.");
   const type = String(raw.type || "").toLowerCase();
@@ -42,7 +41,6 @@ function normalizeTrigger(raw) {
   if (!time) throw new Error('trigger.at "HH:MM" (00:00–23:59) olmali.');
   const at = `${pad2(time.hours)}:${pad2(time.minutes)}`;
   if (type === "daily") return { type, at };
-  // weekly
   const days = Array.isArray(raw.days) ? [...new Set(raw.days.map(Number))].filter((d) => Number.isInteger(d) && d >= 0 && d <= 6).sort((a, b) => a - b) : [];
   if (!days.length) throw new Error("trigger.days en az bir gun (0=Pazar .. 6=Cumartesi) icermeli.");
   return { type, at, days };