@omerrgocmen/crewctl 1.1.1 → 1.3.1

package/orchestrator/README.md

@@ -367,10 +367,21 @@ checkpoint'i oluşturulur; böylece geri alma da geri alınabilir. Sürümler `s
 tutulur (`versioningRetention`, varsayılan 20 sürüm/klasör) ve yalnızca motor **boşta** iken geri yüklenir.
 Bu, Git yerine geçmez; kritik iş için normal sürüm kontrolünüzü sürdürün.
 
-> ⚠️ Otonom çalışma onayı bir sandbox değildir. Agent'lar çalışma klasöründeki dosyaları değiştirebilir,
-> komut çalıştırabilir ve CLI'ın verdiği yetki ölçüsünde daha geniş sisteme erişebilir. İzole çalışma
-> klasörü/repo kullanın, önemli dosyaları sürüm kontrolünde tutun ve **web panelini güvenilmeyen bir
-> ağa açmayın** — ayar API'si CLI komutlarını değiştirebilir.
+### 🧱 Ajan hapsi (sandbox)
+
+`config.json` → `sandbox` alanı ajanı **çalışma klasörüne** hapseder. **Docker veya Git GEREKTİRMEZ**, her PC'de (Windows/macOS/Linux) çalışır:
+
+| `sandbox.mode` | Davranış |
+|----------------|----------|
+| `"workspace"` (varsayılan) | Ajan yalnızca çalışma klasörüne yazabilir. **Codex**: `-s workspace-write` ile dışarıya yazma + ağ, OS-native olarak engellenir (mac Seatbelt / Linux Landlock+seccomp / Windows restricted-token+ACL). **Claude**: orkestratörün kendi dizinleri (config/memory/kurulum) `permissions.deny` ile gizlenir. **Tüm CLI'lar**: prompt'ta katı "yalnız bu klasör" talimatı. |
+| `"off"` | Eski davranış (hapis yok). |
+
+- `sandbox.extraWritableDirs`: çalışma klasörü dışında izin verilen ek yazılabilir mutlak yollar (monorepo/paylaşılan bağımlılık için). Codex'e `writable_roots` olarak geçer.
+- **Dürüst sınır:** Codex/Claude/Cursor dahil tüm OS-native sandbox'lar **okumayı** kasten serbest bırakır; `workspace` modu dışarıya *yazmayı* keser ama okumayı tam engellemez. Okumayı da tümüyle hapsetmek yalnızca konteynerle mümkündür (Docker gerekir; bu projede kapsam dışı). Codex tarafında okuma+yazma birlikte, mac/Linux'ta çekirdek düzeyinde hapsedilir.
+
+> ⚠️ `workspace` modu güçlü bir koruma sağlar ama tam bir izolasyon garantisi değildir. Yine de izole çalışma
+> klasörü kullanın, önemli dosyaları sürüm kontrolünde tutun ve **web panelini güvenilmeyen bir ağa açmayın**
+> — ayar API'si CLI komutlarını değiştirebilir.
 
 ## 🗄️ Depolama
 

package/orchestrator/config.default.json

@@ -14,6 +14,14 @@
   "liveDiffIntervalMs": 2500,
   "versioning": true,
   "versioningRetention": 20,
+  "sandbox": {
+    "_comment": "Ajan hapsi. mode: 'workspace' = ajan yalnizca calisma klasorune yazabilir, disariya yazma/ag engellenir (Docker/Git GEREKMEZ; codex Win/mac/Linux'ta OS-native zorlar, digerleri en-iyi-caba + prompt). 'off' = eski davranis. extraWritableDirs: calisma klasoru disinda izin verilen ek yazilabilir mutlak yollar (monorepo icin).",
+    "mode": "workspace",
+    "extraWritableDirs": []
+  },
+  "_projectContext_comment": "Her calisma klasorunun .crewctl/CONTEXT.md proje profili gorev acilisinda operatore yuklenir (tum kodu bastan taramaya gerek kalmaz), gorev bitiminde operator profili REVIZE eder (changelog degil). Gorev basina '--fresh' ile atlanabilir. false = eski global hafiza.",
+  "projectContext": true,
+  "projectContextCharBudget": 6000,
   "notify": {
     "_comment": "Görev bitince/başarısız olunca webhookUrl'e {text,...} POST edilir (Slack incoming webhook ile uyumlu). Boş webhookUrl = bildirim kapalı.",
     "webhookUrl": "",
@@ -28,9 +36,20 @@
     "protocolRetries": 2,
     "passFastPath": true
   },
+  "resilience": {
+    "_comment": "Gecici saglayici hatalarinda (rate limit / asiri yuk / ag) delegasyon ayni agent ile ustel bekleyerek yeniden denenir; kalici hatada is ayni yetenekteki saglikli bir agente devredilir. Operatore geri donup yeni plan turu harcamak son caredir.",
+    "transientRetries": 2,
+    "retryBaseSeconds": 3,
+    "maxFailoverAgents": 1
+  },
   "cliSettings": {
     "codex": { "model": "", "reasoningEffort": "medium", "serviceTier": "fast" },
-    "opencode": { "model": "" }
+    "opencode": {
+      "_comment": "model: acikca bir model yazarsaniz otomatik secim tumden atlanir (en guvenilir yol; `opencode models` ciktisindan bir satir). Bos birakilirsa modelPreferences desenleri sirayla denenir ve ILK eslesen kullanilir; `*` joker karakterdir. Saglayici adlari kisiden kisiye degisir (kendi aboneliginiz opencode-go, minimax, openrouter, kendi sunucunuz olabilir), bu yuzden burada saglayici adi sabitlenmez — kendi tercihinizi one almak icin listeyi duzenleyin, or. \"opencode-go/*\" en basa. modelExclude: erisilebilir varsayilmayacak saglayicilar; kendi yerel sunucunuzu kullanmak istiyorsaniz ilgili satiri silin.",
+      "model": "",
+      "modelPreferences": ["*deepseek*free*", "*free*", "*"],
+      "modelExclude": ["ollama/*", "lmstudio/*", "llamacpp/*", "local/*", "localhost/*"]
+    }
   },
   "skills": {
     "_comment": "Yalnizca enabled listesindeki beceriler taranir. Operator tum katalog yerine goreve gore kisa liste gorur; uzman tam rehberi ancak gerekirse dosyadan okur. ILK KURULUMDA bu liste paketle gelen tum becerilerle otomatik doldurulur (Ayarlar > Beceriler'den kapatilabilir); scorer her goreve yalnizca ilgili olanlari surer.",

package/orchestrator/src/checkpoints.js

@@ -67,7 +67,6 @@ function walkFileList(cwd) {
   return out;
 }
 
-// Yedeklenecek dosya listesi (calisma klasorune GORE goreli yollar).
 function fileList(cwd) {
   if (isGitRepo(cwd)) {
     const git = gitFileList(cwd);
@@ -155,7 +154,6 @@ function restoreCheckpoint(id, opts = {}) {
   }
   const filesDir = path.join(CP_ROOT, path.basename(String(id)), "files");
   const keep = new Set(manifest.files);
-  // (1) Surumden sonra olusturulmus (surumde olmayan) dosyalari sil.
   let deleted = 0;
   for (const rel of fileList(cwd).files) {
     if (keep.has(rel)) continue;
@@ -163,7 +161,6 @@ function restoreCheckpoint(id, opts = {}) {
     if (!target) continue;
     try { if (fs.existsSync(target)) { fs.rmSync(target, { force: true }); deleted++; } } catch {}
   }
-  // (2) Surumdeki dosyalari birebir geri yaz.
   let restored = 0;
   for (const rel of manifest.files) {
     const src = path.join(filesDir, rel);
@@ -174,7 +171,6 @@ function restoreCheckpoint(id, opts = {}) {
   return { ok: true, id: manifest.id, cwd, restored, deleted, redoId };
 }
 
-// Listeleme: dosya listesini disari vermeden ozet meta doner (istege bagli cwd filtresi).
 function listCheckpoints(cwd) {
   try {
     ensureRoot();

package/orchestrator/src/cli-registry.js

@@ -31,6 +31,8 @@ const DEFINITIONS = {
     defaultArgs: ["--approval-mode", "yolo"],
     // Gemini de akis halinde cikti verir; uzun sessizlik takilma isaretidir.
     silenceTimeoutSeconds: 180,
+    // --skip-trust her Gemini surumunde yok; kesifte yoklanip destekleniyorsa eklenir.
+    optionalFlags: ["--skip-trust"],
     description: "Gemini CLI analiz, uygulama ve web arastirma agenti",
     capabilities: ["implementation", "planning", "analysis", "research", "web"],
     roleFile: "roles/executor.md",
@@ -100,18 +102,29 @@ function abortActiveProbes() {
   return count;
 }
 
-function selectOpenCodeModel(models) {
+// Saglayici adlari koda gomulmez: kullanicinin aboneligi farkli olabilir ve katalog degisir.
+// Sirali joker desenler; ilk eslesen kazanir. cliSettings.opencode uzerinden degistirilebilir.
+const DEFAULT_OPENCODE_MODEL_PREFERENCES = ["*deepseek*free*", "*free*", "*"];
+// Yerel/LAN saglayicilar erisilebilir varsayilamaz: kapali bir Ollama "Unable to connect" verir.
+const DEFAULT_OPENCODE_MODEL_EXCLUDE = ["ollama/*", "lmstudio/*", "llamacpp/*", "local/*", "localhost/*"];
+
+// Kullanici deseni regex ozel karakteri icerse bile duz metin sayilmali.
+function globToRegExp(pattern) {
+  const escaped = String(pattern).replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".");
+  return new RegExp(`^${escaped}$`, "i");
+}
+function patternList(value, fallback) {
+  const list = Array.isArray(value) ? value.map(String).map((x) => x.trim()).filter(Boolean) : [];
+  return (list.length ? list : fallback).map(globToRegExp);
+}
+
+function selectOpenCodeModel(models, settings = {}) {
   const list = Array.isArray(models) ? models.map(String).filter(Boolean) : [];
-  const priorities = [
-    (x) => x === "opencode/big-pickle",
-    (x) => /^opencode\/.+free$/i.test(x),
-    (x) => x.startsWith("opencode/"),
-    (x) => x.startsWith("opencode-go/"),
-    (x) => x.startsWith("minimax-coding-plan/"),
-    (x) => !x.startsWith("ollama/"),
-  ];
-  for (const match of priorities) {
-    const found = list.find(match);
+  const exclude = patternList(settings.modelExclude, DEFAULT_OPENCODE_MODEL_EXCLUDE);
+  const preferences = patternList(settings.modelPreferences, DEFAULT_OPENCODE_MODEL_PREFERENCES);
+  const usable = list.filter((model) => !exclude.some((rule) => rule.test(model)));
+  for (const rule of preferences) {
+    const found = usable.find((model) => rule.test(model));
     if (found) return found;
   }
   return "";
@@ -143,6 +156,31 @@ function listOpenCodeModels(command) {
   } catch { return []; }
 }
 
+// Liste bos kalirsa --model eklenmez ve opencode kendi "son kullanilan" modeline duser; o model
+// erisilemezse gorev "No provider available"/"Unable to connect" ile olur. Bu yuzden tembel doldurulur.
+let openCodeModelsAttempted = false;
+function ensureOpenCodeModels(command) {
+  // Negatif sonuc da onbelleklenir: aksi halde bos donduren bir kurulumda her effectiveAgent
+  // cagrisi yeniden spawn eder ve istek yolunda event loop'u kilitlerdi.
+  if (OPEN_CODE_MODELS.length || openCodeModelsAttempted) return OPEN_CODE_MODELS;
+  openCodeModelsAttempted = true;
+  OPEN_CODE_MODELS = listOpenCodeModels(RESOLVED.get("opencode") || command || "opencode");
+  return OPEN_CODE_MODELS;
+}
+
+// Oturum acma talimati CLI'ya gore degisir; tek bir sabit metin opencode hatasinda kullaniciya
+// gemini komutu onerdiriyordu. Adapter adi ya da komut yolu kabul eder.
+const AUTH_HINTS = {
+  codex: "Terminalde `codex login` calistirin (veya OPENAI_API_KEY tanimlayin).",
+  claude: "Terminalde `claude` calistirip oturum acin (veya ANTHROPIC_API_KEY tanimlayin).",
+  gemini: "Terminalde `gemini` calistirip 'Login with Google' secin (veya GEMINI_API_KEY tanimlayin).",
+  opencode: "Terminalde `opencode auth login` calistirip saglayiciyi secin; '401 No provider available' hatasi secili modelin saglayicisinda gecerli kimlik olmadigi anlamina gelir.",
+};
+function authHint(adapterOrCommand) {
+  const id = AUTH_HINTS[adapterOrCommand] ? adapterOrCommand : adapterId(adapterOrCommand);
+  return AUTH_HINTS[id] || "Bu CLI'nin kendi oturum acma komutunu terminalde calistirin.";
+}
+
 function adapterId(command) {
   const base = path.basename(String(command || "")).toLowerCase().replace(/\.(cmd|bat|exe|ps1)$/, "");
   if (base.includes("codex")) return "codex";
@@ -220,6 +258,18 @@ function normalizeAgentAdapters(cfg) {
   return changed;
 }
 
+// Ajan hapsi acik mi? cfg.sandbox.mode === "workspace" ise CLI'lar calisma klasoru DISINA
+// yazamaz/aga cikamaz. cfg verilmeyen (test/edge) cagrilar hapissiz kalir; boylece mevcut
+// arguman-esitlik testleri aynen gecer. Gercek calistirmada normalizeConfig mode'u daima
+// doldurur (varsayilan "workspace").
+function confineWorkspace(cfg) {
+  return cfg?.sandbox?.mode === "workspace";
+}
+function sandboxWritableRoots(cfg) {
+  const roots = cfg?.sandbox?.extraWritableDirs;
+  return Array.isArray(roots) ? roots.filter((x) => typeof x === "string" && x.trim()).map(String) : [];
+}
+
 // cfg verilirse cfg.cliSettings[adapter] o CLI'nin varsayilan model ayari olarak uygulanir.
 // Oncelik: agent.model (profil bazli) > cliSettings[adapter].model (global) > CLI varsayilani.
 function effectiveAgent(agent, cfg) {
@@ -234,6 +284,23 @@ function effectiveAgent(agent, cfg) {
     const commands = new Set(["exec", "review", "resume", "apply"]);
     if (!copy.args.some((arg) => commands.has(arg))) copy.args.unshift("exec", "--skip-git-repo-check");
     else if (copy.args.includes("exec") && !copy.args.includes("--skip-git-repo-check")) copy.args.splice(copy.args.indexOf("exec") + 1, 0, "--skip-git-repo-check");
+    // Hapis: calisma klasoru (spawn cwd = codex "workspace") disina yazma ve ag engellenir.
+    // AYRICA: `codex exec` bayraksiz calistiginda read-only sandbox'a duser; yazma reddedilir
+    // ama surec 0 doner, motor delegasyonu "tamamlandi" sayar ve hicbir dosya uretmeden turlar
+    // yanar. Yani bu bayrak yalnizca hapis degil, otonom kosumun calismasi icin de sarttir.
+    // Native sandbox — mac Seatbelt / Linux Landlock+seccomp / Windows restricted-token+ACL —
+    // Docker/Git GEREKTIRMEZ. Kullanici acikca kendi -s/--sandbox veya bypass bayragini
+    // koyduysa ona dokunmayiz. Bayrak, model/effort/tier PUSH'undan ONCE ve exec/skip-git'ten
+    // HEMEN SONRA eklenir; testlerin args.slice(0,2) ve slice(-6) beklentileri korunur.
+    const alreadySandboxed = copy.args.some((arg) => arg === "-s" || arg === "--sandbox" || arg === "--dangerously-bypass-approvals-and-sandbox" || arg === "--full-auto");
+    if (confineWorkspace(cfg) && !alreadySandboxed) {
+      const anchor = copy.args.indexOf("--skip-git-repo-check");
+      const at = anchor >= 0 ? anchor + 1 : Math.max(copy.args.indexOf("exec") + 1, 0);
+      const flags = ["-s", "workspace-write"];
+      const roots = sandboxWritableRoots(cfg);
+      if (roots.length) flags.push("-c", `sandbox_workspace_write.writable_roots=${JSON.stringify(roots)}`);
+      copy.args.splice(at, 0, ...flags);
+    }
     const model = String(copy.model || settings.model || "").trim();
     const effort = ["low", "medium", "high", "xhigh", "max", "ultra"].includes(String(settings.reasoningEffort)) ? String(settings.reasoningEffort) : "";
     const serviceTier = /^[A-Za-z0-9._-]{1,64}$/.test(String(settings.serviceTier || "")) ? String(settings.serviceTier) : "";
@@ -248,6 +315,10 @@ function effectiveAgent(agent, cfg) {
   if (adapter === "gemini") {
     // Otonom, non-interaktif calisma icin onay modu sart; yoksa izin bekleyip takilir.
     if (!copy.args.includes("--approval-mode") && !copy.args.includes("-y") && !copy.args.includes("--yolo")) copy.args.push("--approval-mode", "yolo");
+    // Gemini "guvenilmeyen" klasorde yolo'yu SESSIZCE default'a dusurur ve onay bekler; otonom
+    // kosumda onaylayan olmadigi icin sessizlik zaman asimina dusup karantinaya girer.
+    // --skip-trust yalnizca o oturum icindir, kalici ayarlara dokunmaz.
+    if (!copy.args.includes("--skip-trust") && cliSupportsFlag(copy.cmd, "--skip-trust")) copy.args.push("--skip-trust");
   }
   if (adapter === "opencode") {
     if (!copy.args.includes("run")) copy.args.unshift("run");
@@ -257,7 +328,9 @@ function effectiveAgent(agent, cfg) {
     if (formatAt >= 0) copy.args.splice(formatAt, 2);
     copy.args.splice(copy.args.indexOf("run") + 1, 0, "--format", "json");
     const hasModel = copy.args.includes("--model") || copy.args.includes("-m");
-    const model = copy.model || String(settings.model || "").trim() || selectOpenCodeModel(OPEN_CODE_MODELS);
+    // Sira: agent modeli > global CLI ayari > otomatik secim (bkz. ensureOpenCodeModels).
+    const model = copy.model || String(settings.model || "").trim()
+      || selectOpenCodeModel(OPEN_CODE_MODELS.length ? OPEN_CODE_MODELS : ensureOpenCodeModels(copy.cmd), settings);
     if (!hasModel && model) copy.args.splice(copy.args.indexOf("run") + 3, 0, "--model", model);
     if (model) copy.model = model;
     if (!copy.args.includes("{PROMPT}") && !copy.args.includes("{PROMPT_FILE}")) {
@@ -267,6 +340,44 @@ function effectiveAgent(agent, cfg) {
   return copy;
 }
 
+// Bayrak destegi --help'ten okunur: kosulsuz eklemek eski surumlerde "unknown argument" ile her
+// calistirmayi kirar.
+//
+// SENKRON SPAWN YALNIZCA KESIF SIRASINDA. effectiveAgent HTTP istek yolunda cagriliyor ve
+// oradaki spawnSync event loop'u kilitleyip baglantiyi ECONNRESET ile dusuruyor (sunucu-akis
+// testi bunu yakaladi); effectiveAgent yalnizca hazir sonucu okur, bilinmiyorsa bayrak eklenmez.
+// Anahtar komuttur: ayni adapteri farkli binary/surumle kullanan agentler karismamali.
+const FLAG_SUPPORT = new Map();
+function flagSupportKey(command, flag) {
+  return `${command}${flag}`;
+}
+function probeFlagSupport(command, flags) {
+  let help = "";
+  try {
+    const result = spawnSync(command, ["--help"], {
+      encoding: "utf8", timeout: 15000, windowsHide: true,
+      shell: isWin && (!path.isAbsolute(command) || /\.(cmd|bat)$/i.test(command)),
+    });
+    help = `${result.stdout || ""}\n${result.stderr || ""}`;
+  } catch {}
+  const supported = [];
+  for (const flag of flags) {
+    const ok = Boolean(help) && help.includes(flag);
+    FLAG_SUPPORT.set(flagSupportKey(command, flag), ok);
+    if (ok) supported.push(flag);
+  }
+  return supported;
+}
+// Desteklenmeyenler DE isaretlenir; yoksa "bilinmiyor" kalir ve sonraki probe (saglik testi
+// sirasinda) yeniden yoklar — kacinmak istedigimiz spawnSync tam olarak budur.
+function restoreFlagSupport(command, allFlags, supportedFlags) {
+  const supported = new Set(supportedFlags || []);
+  for (const flag of allFlags || []) FLAG_SUPPORT.set(flagSupportKey(command, flag), supported.has(flag));
+}
+function cliSupportsFlag(command, flag) {
+  return FLAG_SUPPORT.get(flagSupportKey(command, flag)) === true;
+}
+
 function probeCommand(command, definition) {
   try {
     const result = spawnSync(command, definition.versionArgs, {
@@ -282,7 +393,7 @@ function probeCommand(command, definition) {
   }
 }
 
-function probe(id, definition) {
+function probe(id, definition, cfg) {
   let result = probeCommand(definition.command, definition);
   let installedPath = "";
   if (!result.installed) {
@@ -300,13 +411,22 @@ function probe(id, definition) {
     }
   }
   if (result.installed) RESOLVED.set(id, result.resolvedCommand);
+  // Bilinen bayrak tekrar yoklanmaz: probe() saglik testinden de cagriliyor ve o sirada
+  // sunucu istek servis ediyor olabilir (bkz. probeFlagSupport'taki ECONNRESET notu).
+  if (result.installed && definition.optionalFlags?.length) {
+    const command = result.resolvedCommand || definition.command;
+    const unknown = definition.optionalFlags.filter((flag) => !FLAG_SUPPORT.has(flagSupportKey(command, flag)));
+    if (unknown.length) probeFlagSupport(command, unknown);
+    result.supportedFlags = definition.optionalFlags.filter((flag) => cliSupportsFlag(command, flag));
+  }
   if (result.installed && id === "opencode") {
+    const settings = (cfg && cfg.cliSettings && cfg.cliSettings.opencode) || {};
     OPEN_CODE_MODELS = listOpenCodeModels(result.resolvedCommand || definition.command);
     result.models = OPEN_CODE_MODELS.slice();
-    result.recommendedModel = selectOpenCodeModel(OPEN_CODE_MODELS);
+    result.recommendedModel = String(settings.model || "").trim() || selectOpenCodeModel(OPEN_CODE_MODELS, settings);
     result.ready = Boolean(result.recommendedModel);
     result.readinessError = result.ready ? "" : (OPEN_CODE_MODELS.length
-      ? "Kullanilabilir otomatik OpenCode modeli bulunamadi. Ayarlardan erisilebilir bir model secin."
+      ? "Otomatik secim kurallarina uyan bir OpenCode modeli bulunamadi. Ayarlardan bir model secin veya cliSettings.opencode.modelPreferences desenlerini duzenleyin."
       : "OpenCode kurulu, ancak model listesi okunamadi. Once saglayici girisini tamamlayin.");
   }
   return result;
@@ -347,16 +467,51 @@ function cachedProbeUsable(entry) {
   return Boolean(entry && entry.installed && entry.resolvedCommand && resolvesOnPath(entry.resolvedCommand));
 }
 
+// OpenCode model listesi persist EDILMEZ; her acilista `opencode models` ile bellekten
+// uretilir. O cagri acilista gecici olarak yavas/basarisiz olursa (soguk ilk cagri, auth
+// oturmamis, ag) liste bos kalir ve panel model dropdown'i o process boyunca bos gorunur.
+// codex icin codexModelCache ile cozulen bu kirilganligi opencode icin de kapatiriz: prob
+// bos donerse son basarili liste (config'te saklanan) fallback olarak kullanilir. Fallback
+// ayni zamanda OPEN_CODE_MODELS'i doldurur ki otomatik model secimi de calissin.
+// settings: fallback yolunda da kullanicinin acik modeli / modelPreferences desenleri gecerli
+// olmali; aksi halde bayat listeden varsayilan kurallarla secim yapilirdi.
+function applyOpenCodeFallback(entry, fallback, settings = {}) {
+  if (!entry || entry.id !== "opencode" || !entry.installed) return entry;
+  if ((entry.models && entry.models.length) || !Array.isArray(fallback) || !fallback.length) return entry;
+  const models = fallback.map(String).filter(Boolean);
+  if (!models.length) return entry;
+  OPEN_CODE_MODELS = models.slice();
+  entry.models = models.slice();
+  entry.recommendedModel = String(settings.model || "").trim() || selectOpenCodeModel(models, settings);
+  entry.ready = Boolean(entry.recommendedModel);
+  entry.modelsFromCache = true;
+  if (entry.ready) entry.readinessError = "";
+  return entry;
+}
+
 function discoverInstalled(options = {}) {
   const cache = options.cache?.version === DISCOVERY_CACHE_VERSION ? options.cache.results || {} : {};
   const force = options.force === true;
+  const openCodeFallback = Array.isArray(options.openCodeModels) ? options.openCodeModels : [];
   return Object.entries(DEFINITIONS).map(([id, definition]) => {
     const cached = cache[id];
     if (!force && !ALWAYS_PROBE.has(id) && cachedProbeUsable(cached)) {
       RESOLVED.set(id, cached.resolvedCommand);
-      return { id, ...definition, installed: true, version: cached.version || "kurulu", error: "", resolvedCommand: cached.resolvedCommand, fromCache: true };
+      // Eski sema onbelleginde supportedFlags yok. Yoklama burada, HTTP dinleme baslamadan yapilir.
+      let supportedFlags = cached.supportedFlags;
+      if (!Array.isArray(supportedFlags) && definition.optionalFlags?.length) {
+        supportedFlags = probeFlagSupport(cached.resolvedCommand, definition.optionalFlags);
+      } else {
+        restoreFlagSupport(cached.resolvedCommand, definition.optionalFlags, supportedFlags);
+      }
+      return { id, ...definition, installed: true, version: cached.version || "kurulu", error: "", resolvedCommand: cached.resolvedCommand, fromCache: true, supportedFlags: supportedFlags || [] };
     }
-    return { id, ...definition, ...probe(id, definition) };
+    // cfg: model onerisi kullanicinin modelPreferences desenlerine gore uretilir.
+    // fallback: prob bos donerse son bilinen model listesi korunur.
+    const result = { id, ...definition, ...probe(id, definition, options.cfg) };
+    return id === "opencode"
+      ? applyOpenCodeFallback(result, openCodeFallback, (options.cfg && options.cfg.cliSettings && options.cfg.cliSettings.opencode) || {})
+      : result;
   });
 }
 
@@ -366,7 +521,8 @@ function discoveryCacheFrom(discovered) {
   const results = {};
   for (const cli of discovered || []) {
     if (cli.installed && cli.resolvedCommand && !ALWAYS_PROBE.has(cli.id)) {
-      results[cli.id] = { installed: true, version: cli.version || "kurulu", resolvedCommand: cli.resolvedCommand };
+      // supportedFlags saklanmazsa onbellekli acilista Gemini --skip-trust sessizce duserdi.
+      results[cli.id] = { installed: true, version: cli.version || "kurulu", resolvedCommand: cli.resolvedCommand, supportedFlags: cli.supportedFlags || [] };
     }
   }
   return { version: DISCOVERY_CACHE_VERSION, checkedAt: new Date().toISOString(), results };
@@ -378,7 +534,17 @@ function discoveryCacheFrom(discovered) {
 function buildCommand(command, args) {
   if (!isWin) return { file: command, args, shell: false };
   const bare = !path.isAbsolute(command) && !/[\\/]/.test(command);
-  if (bare) return { file: command, args, shell: true };
+  if (bare) {
+    // shell:true iken Node argumanlari birlestirip cmd.exe'ye verir ve OTOMATIK TIRNAK KOYMAZ.
+    // Bosluk iceren yol argumanlari (or. "C:\Users\John Doe\...\x.settings.json" veya
+    // {PROMPT_FILE}) ikiye bolunurdu; bu da --settings/--file yolunu bozardi. Bosluk veya
+    // kabuk metakarakteri iceren argumanlari tirnakla; sade bayrak/model adlari dokunulmaz.
+    const shellQuote = (value) => {
+      const v = String(value);
+      return /[\s"^&|<>()%!]/.test(v) ? `"${v.replace(/"/g, '\\"')}"` : v;
+    };
+    return { file: command, args: args.map(shellQuote), shell: true };
+  }
   if (!/\.(cmd|bat)$/i.test(command)) return { file: command, args, shell: false };
   const quote = (value) => `"${String(value).replace(/"/g, '""')}"`;
   return { file: process.env.ComSpec || "cmd.exe", args: ["/d", "/s", "/c", `"${[command, ...args].map(quote).join(" ")}"`], shell: false, verbatim: true };
@@ -447,7 +613,7 @@ function classifyHealthFailure(text) {
 function testInstalledCli(id, options = {}) {
   const definition = DEFINITIONS[id];
   if (!definition) return Promise.resolve({ id, installed: false, health: { status: "unknown", label: "Bilinmiyor", detail: "Tanımsız CLI" } });
-  const found = probe(id, definition);
+  const found = probe(id, definition, options.cfg);
   if (!found.installed) return Promise.resolve({ id, installed: false, version: found.version, error: found.error, health: { status: "not-installed", label: "Kurulu değil", detail: found.error || "CLI bulunamadı" } });
   const agent = effectiveAgent({ adapter: id, cmd: definition.command, args: definition.defaultArgs.slice() }, options.cfg);
   const prompt = healthPrompt(id);
@@ -679,4 +845,4 @@ function ensureValidOperator(cfg, discovered) {
   return changed;
 }
 
-module.exports = { DEFINITIONS, KNOWN_CLIS: Object.keys(DEFINITIONS), adapterId, normalizeAgentAdapter, normalizeAgentAdapters, effectiveAgent, preparePromptArgs, operatorSpec, buildCommand, agentEnvironment, discoverInstalled, discoveryCacheFrom, healthCheckAll, listCodexModels, abortActiveProbes, currentProbeGeneration, selectOpenCodeModel, parseOpenCodeModels, addMissingAgents, ensureValidOperator };
+module.exports = { DEFINITIONS, KNOWN_CLIS: Object.keys(DEFINITIONS), adapterId, authHint, normalizeAgentAdapter, normalizeAgentAdapters, effectiveAgent, preparePromptArgs, operatorSpec, buildCommand, agentEnvironment, discoverInstalled, discoveryCacheFrom, applyOpenCodeFallback, healthCheckAll, listCodexModels, abortActiveProbes, currentProbeGeneration, selectOpenCodeModel, parseOpenCodeModels, addMissingAgents, ensureValidOperator };

package/orchestrator/src/cli.js

@@ -28,6 +28,7 @@ Task secenekleri:
   --dir <klasor>       Calisma klasoru
   --operator <cli>     codex | claude | gemini | opencode
   --mode <mod>         auto | fast | balanced | deep
+  --fresh              Proje profilini yukleme; temiz sayfadan basla
 
 Ornek:
   crewctl task "Testleri duzelt" --dir . --mode balanced
@@ -66,6 +67,9 @@ function addTask(args) {
   const targetDir = takeOption(args, "--dir");
   const operator = takeOption(args, "--operator");
   const mode = takeOption(args, "--mode") || "auto";
+  // --fresh: bu gorevde proje profilini (.crewctl/CONTEXT.md) yukleme; temiz sayfadan basla.
+  const fresh = args.includes("--fresh");
+  if (fresh) args.splice(args.indexOf("--fresh"), 1);
   if (!VALID_MODES.has(mode)) throw new Error(`Gecersiz mod: ${mode}`);
   const unknown = args.find((arg) => arg.startsWith("--"));
   if (unknown) throw new Error(`Bilinmeyen secenek: ${unknown}`);
@@ -75,8 +79,9 @@ function addTask(args) {
   const selectedOperator = operator || cfg.operator?.cli;
   const resolvedDir = targetDir ? path.resolve(targetDir) : undefined;
   const task = store.addTask(prompt, resolvedDir, selectedOperator, mode);
+  if (fresh) { task.freshContext = true; store.saveTask("pending", task); }
   console.log(`Eklendi: ${task.id}`);
-  console.log(`Mod: ${mode}  |  Operator: ${selectedOperator || "varsayilan"}`);
+  console.log(`Mod: ${mode}  |  Operator: ${selectedOperator || "varsayilan"}${fresh ? "  |  Temiz sayfa (--fresh)" : ""}`);
 }
 
 function approvals() {