oh-my-codex 0.11.13 → 0.12.1

package/README.tr.md

@@ -1,263 +0,0 @@
-# oh-my-codex (OMX)
-
-<p align="center">
-  <img src="https://yeachan-heo.github.io/oh-my-codex-website/omx-character-nobg.png" alt="oh-my-codex character" width="280">
-  <br>
-  <em>Codex'iniz yalnız değil.</em>
-</p>
-
-[![npm version](https://img.shields.io/npm/v/oh-my-codex)](https://www.npmjs.com/package/oh-my-codex)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
-
-> **[Website](https://yeachan-heo.github.io/oh-my-codex-website/)** | **[Documentation](https://yeachan-heo.github.io/oh-my-codex-website/docs.html)** | **[CLI Reference](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#cli-reference)** | **[Workflows](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#workflows)** | **[OpenClaw Entegrasyon Kılavuzu](./docs/openclaw-integration.tr.md)** | **[GitHub](https://github.com/Yeachan-Heo/oh-my-codex)** | **[npm](https://www.npmjs.com/package/oh-my-codex)**
-
-[OpenAI Codex CLI](https://github.com/openai/codex) için çok ajanlı orkestrasyon katmanı.
-
-## v0.9.0'daki Yenilikler — Spark Initiative
-
-Spark Initiative, OMX içindeki native keşif ve inceleme yolunu güçlendiren sürümdür.
-
-- **`omx explore` için native harness** — salt okunur depo keşfini Rust tabanlı daha hızlı ve daha sıkı bir yol üzerinden çalıştırır.
-- **`omx sparkshell`** — uzun çıktıları özetleyen ve açık tmux pane yakalama desteği veren operatör odaklı native inceleme yüzeyidir.
-- **Çapraz platform native release varlıkları** — `omx-explore-harness`, `omx-sparkshell` ve `native-release-manifest.json` için hydration yolu artık release pipeline'ın parçasıdır.
-- **Güçlendirilmiş CI/CD** — `build` job'ına açık Rust toolchain kurulumu ile birlikte `cargo fmt --check` ve `cargo clippy -- -D warnings` eklendi.
-
-Ayrıntılar için [v0.9.0 release notları](./docs/release-notes-0.9.0.md) ve [release body](./docs/release-body-0.9.0.md) dosyalarına bakın.
-
-## İlk Oturum
-
-Codex içinde:
-
-```text
-$deep-interview "clarify the auth change"
-$ralplan "approve the auth plan and review tradeoffs"
-$ralph "carry the approved plan to completion"
-$team 3:executor "execute the approved plan in parallel"
-```
-
-Terminalden:
-
-```bash
-omx team 4:executor "parallelize a multi-module refactor"
-omx team status <team-name>
-omx team shutdown <team-name>
-```
-
-## Önerilen iş akışı
-
-1. `$deep-interview` — kapsam veya sınırlar hâlâ net değilse.
-2. `$ralplan` — netleşen kapsamı onaylanmış bir mimari ve uygulama planına dönüştürmek için.
-3. `$team` veya `$ralph` — koordineli paralel yürütme için `$team`, tek sahipli kalıcı tamamlama/doğrulama döngüsü için `$ralph` kullanın.
-
-## Temel Model
-
-OMX şu katmanları kurar ve bağlar:
-
-```text
-User
-  -> Codex CLI
-    -> AGENTS.md (orkestrasyon beyni)
-    -> ~/.codex/prompts/*.md (ajan prompt kataloğu)
-    -> ~/.codex/skills/*/SKILL.md (skill kataloğu)
-    -> ~/.codex/config.toml (özellikler, bildirimler, MCP)
-    -> .omx/ (çalışma zamanı durumu, bellek, planlar, günlükler)
-```
-
-## Ana Komutlar
-
-```bash
-omx                # Codex'i başlat (tmux'ta HUD ile birlikte)
-omx setup          # Prompt/skill/config'i kapsama göre kur + proje .omx + kapsama özel AGENTS.md
-omx doctor         # Kurulum/çalışma zamanı tanılamaları
-omx doctor --team  # Team/swarm tanılamaları
-omx team ...       # tmux takım çalışanlarını başlat/durum/devam et/kapat
-omx status         # Aktif modları göster
-omx cancel         # Aktif çalışma modlarını iptal et
-omx reasoning <mode> # low|medium|high|xhigh
-omx tmux-hook ...  # init|status|validate|test
-omx hooks ...      # init|status|validate|test (eklenti uzantı iş akışı)
-omx hud ...        # --watch|--json|--preset
-omx help
-```
-
-## Hooks Uzantısı (Ek Yüzey)
-
-OMX artık eklenti iskelesi ve doğrulaması için `omx hooks` içerir.
-
-- `omx tmux-hook` desteklenmeye devam eder ve değişmemiştir.
-- `omx hooks` ek niteliktedir ve tmux-hook iş akışlarını değiştirmez.
-- Eklenti dosyaları `.omx/hooks/*.mjs` konumunda bulunur.
-- Eklentiler varsayılan olarak kapalıdır; `OMX_HOOK_PLUGINS=1` ile etkinleştirin.
-
-Tam uzantı iş akışı ve olay modeli için `docs/hooks-extension.md` dosyasına bakın.
-
-## Başlatma Bayrakları
-
-```bash
---yolo
---high
---xhigh
---madmax
---force
---dry-run
---verbose
---scope <user|project>  # yalnızca setup
-```
-
-`--madmax`, Codex `--dangerously-bypass-approvals-and-sandbox` ile eşlenir.
-Yalnızca güvenilir/harici sandbox ortamlarında kullanın.
-
-### MCP workingDirectory politikası (isteğe bağlı sertleştirme)
-
-Varsayılan olarak, MCP durum/bellek/trace araçları çağıranın sağladığı `workingDirectory` değerini kabul eder.
-Bunu kısıtlamak için bir izin listesi belirleyin:
-
-```bash
-export OMX_MCP_WORKDIR_ROOTS="/path/to/project:/path/to/another-root"
-```
-
-Ayarlandığında, bu kökler dışındaki `workingDirectory` değerleri reddedilir.
-
-## Codex-First Prompt Kontrolü
-
-Varsayılan olarak, OMX şunu enjekte eder:
-
-```text
--c model_instructions_file="<cwd>/AGENTS.md"
-```
-
-Bu, `CODEX_HOME` içindeki `AGENTS.md` ile proje `AGENTS.md` dosyasını (varsa) birleştirir ve ardından çalışma zamanı kaplamasını ekler.
-Codex davranışını genişletir, ancak Codex çekirdek sistem politikalarını değiştirmez/atlamaz.
-
-Kontroller:
-
-```bash
-OMX_BYPASS_DEFAULT_SYSTEM_PROMPT=0 omx     # AGENTS.md enjeksiyonunu devre dışı bırak
-OMX_MODEL_INSTRUCTIONS_FILE=/path/to/instructions.md omx
-```
-
-## Takım Modu
-
-Paralel çalışanlardan fayda sağlayan geniş kapsamlı işler için takım modunu kullanın.
-
-Yaşam döngüsü:
-
-```text
-start -> assign scoped lanes -> monitor -> verify terminal tasks -> shutdown
-```
-
-Operasyonel komutlar:
-
-```bash
-omx team <args>
-omx team status <team-name>
-omx team resume <team-name>
-omx team shutdown <team-name>
-```
-
-Önemli kural: İptal etmiyorsanız, görevler hâlâ `in_progress` durumundayken kapatmayın.
-
-### Team shutdown policy
-
-Use `omx team shutdown <team-name>` after the team reaches a terminal state.
-Team cleanup now follows one standalone path; legacy linked-Ralph shutdown handling is no longer a separate public workflow.
-
-Takım çalışanları için Worker CLI seçimi:
-
-```bash
-OMX_TEAM_WORKER_CLI=auto    # varsayılan; worker --model "claude" içeriyorsa claude kullanır
-OMX_TEAM_WORKER_CLI=codex   # Codex CLI çalışanlarını zorla
-OMX_TEAM_WORKER_CLI=claude  # Claude CLI çalışanlarını zorla
-OMX_TEAM_WORKER_CLI_MAP=codex,codex,claude,claude  # çalışan başına CLI karışımı (uzunluk=1 veya çalışan sayısı)
-OMX_TEAM_AUTO_INTERRUPT_RETRY=0  # isteğe bağlı: adaptif queue->resend geri dönüşünü devre dışı bırak
-```
-
-Notlar:
-- Worker başlatma argümanları hâlâ `OMX_TEAM_WORKER_LAUNCH_ARGS` aracılığıyla paylaşılır.
-- `OMX_TEAM_WORKER_CLI_MAP`, çalışan başına seçim için `OMX_TEAM_WORKER_CLI`'yi geçersiz kılar.
-- Tetikleyici gönderimi varsayılan olarak adaptif yeniden denemeler kullanır (queue/submit, ardından gerektiğinde güvenli clear-line+resend geri dönüşü).
-- Claude worker modunda, OMX çalışanları düz `claude` olarak başlatır (ekstra başlatma argümanı yok) ve açık `--model` / `--config` / `--effort` geçersiz kılmalarını yok sayar, böylece Claude varsayılan `settings.json` kullanır.
-
-## `omx setup` Ne Yazar
-
-- `.omx/setup-scope.json` (kalıcı kurulum kapsamı)
-- Kapsama bağlı kurulumlar:
-  - `user`: `~/.codex/prompts/`, `~/.codex/skills/`, `~/.codex/config.toml`, `~/.omx/agents/`, `~/.codex/AGENTS.md`
-  - `project`: `./.codex/prompts/`, `./.codex/skills/`, `./.codex/config.toml`, `./.omx/agents/`, `./AGENTS.md`
-- Başlatma davranışı: kalıcı kapsam `project` ise, `omx` başlatma otomatik olarak `CODEX_HOME=./.codex` kullanır (`CODEX_HOME` zaten ayarlanmadıysa).
-- Başlatma talimatları `~/.codex/AGENTS.md` (veya geçersiz kılındıysa `CODEX_HOME/AGENTS.md`) ile proje `./AGENTS.md` dosyasını birleştirir ve ardından çalışma zamanı kaplamasını ekler.
-- Mevcut `AGENTS.md` dosyaları sessizce üzerine yazılmaz: etkileşimli TTY'de setup değiştirmeden önce sorar; etkileşimsiz çalıştırmada ise `--force` yoksa değiştirme atlanır (aktif oturum güvenlik kontrolleri hâlâ geçerlidir).
-- `config.toml` güncellemeleri (her iki kapsam için):
-  - `notify = ["node", "..."]`
-  - `model_reasoning_effort = "high"`
-  - `developer_instructions = "..."`
-  - `[features] multi_agent = true, child_agents_md = true`
-  - MCP sunucu girişleri (`omx_state`, `omx_memory`, `omx_code_intel`, `omx_trace`)
-  - `[tui] status_line`
-- Kapsama özel `AGENTS.md`
-- `.omx/` çalışma zamanı dizinleri ve HUD yapılandırması
-
-## Ajanlar ve Skill'ler
-
-- Prompt'lar: `prompts/*.md` (`user` için `~/.codex/prompts/`'a, `project` için `./.codex/prompts/`'a kurulur)
-- Skill'ler: `skills/*/SKILL.md` (`user` için `~/.codex/skills/`'a, `project` için `./.codex/skills/`'a kurulur)
-
-Örnekler:
-- Ajanlar: `architect`, `planner`, `executor`, `debugger`, `verifier`, `security-reviewer`
-- Skill'ler: `deep-interview`, `ralplan`, `team`, `ralph`, `plan`, `cancel`
-
-## Proje Yapısı
-
-```text
-oh-my-codex/
-  bin/omx.js
-  src/
-    cli/
-    team/
-    mcp/
-    hooks/
-    hud/
-    config/
-    modes/
-    notifications/
-    verification/
-  prompts/
-  skills/
-  templates/
-  scripts/
-```
-
-## Geliştirme
-
-```bash
-git clone https://github.com/Yeachan-Heo/oh-my-codex.git
-cd oh-my-codex
-npm install
-npm run build
-npm test
-```
-
-## Dokümantasyon
-
-- **[Tam Dokümantasyon](https://yeachan-heo.github.io/oh-my-codex-website/docs.html)** — Eksiksiz kılavuz
-- **[CLI Referansı](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#cli-reference)** — Tüm `omx` komutları, bayraklar ve araçlar
-- **[Bildirim Kılavuzu](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#notifications)** — Discord, Telegram, Slack ve webhook kurulumu
-- **[Önerilen İş Akışları](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#workflows)** — Yaygın görevler için savaşta test edilmiş skill zincirleri
-- **[Sürüm Notları](https://yeachan-heo.github.io/oh-my-codex-website/docs.html#release-notes)** — Her sürümdeki yenilikler
-
-## Notlar
-
-- Tam değişiklik günlüğü: `CHANGELOG.md`
-- Geçiş rehberi (v0.4.4 sonrası mainline): `docs/migration-mainline-post-v0.4.4.md`
-- Kapsam ve eşitlik notları: `COVERAGE.md`
-- Hook uzantı iş akışı: `docs/hooks-extension.md`
-- Kurulum ve katkı detayları: `CONTRIBUTING.md`
-
-## Teşekkürler
-
-[oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode)'dan ilham alınmıştır, Codex CLI için uyarlanmıştır.
-
-## Lisans
-
-MIT

package/README.vi.md

@@ -1,223 +0,0 @@
-# oh-my-codex (OMX)
-
-<p align="center">
-  <img src="https://yeachan-heo.github.io/oh-my-codex-website/omx-character-nobg.png" alt="oh-my-codex character" width="280">
-  <br>
-  <em>Dùng Codex hiệu quả hơn — OMX lo phần prompt, workflow và runtime khi dự án phức tạp dần.</em>
-</p>
-
-[![npm version](https://img.shields.io/npm/v/oh-my-codex)](https://www.npmjs.com/package/oh-my-codex)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
-[![Discord](https://img.shields.io/discord/1452487457085063218?color=5865F2&logo=discord&logoColor=white&label=Discord)](https://discord.gg/PUwSMR9XNk)
-
-**Website:** https://yeachan-heo.github.io/oh-my-codex-website/
-**Tài liệu:** [Bắt đầu](./docs/getting-started.html) · [Agent](./docs/agents.html) · [Skill](./docs/skills.html) · [Tích hợp](./docs/integrations.html) · [Demo](./DEMO.md) · [Hướng dẫn OpenClaw](./docs/openclaw-integration.md)
-
-OMX là lớp workflow mở rộng cho [OpenAI Codex CLI](https://github.com/openai/codex).
-
-Codex vẫn là engine chính, OMX giúp bạn:
-- cấu hình Codex tốt hơn ngay từ phiên đầu tiên
-- chạy workflow nhất quán từ làm rõ yêu cầu đến hoàn thành
-- gọi các skill chính bằng `$deep-interview`, `$ralplan`, `$team` và `$ralph`
-- lưu trữ hướng dẫn dự án, kế hoạch, log và trạng thái trong `.omx/`
-
-## Workflow mặc định
-
-Nếu bạn muốn trải nghiệm OMX nhanh nhất, bắt đầu từ đây:
-
-```bash
-npm install -g @openai/codex oh-my-codex
-omx setup
-omx --madmax --high
-```
-
-Sau đó làm việc bình thường trong Codex:
-
-```text
-$deep-interview "clarify the authentication change"
-$ralplan "approve the auth plan and review tradeoffs"
-$ralph "carry the approved plan to completion"
-$team 3:executor "execute the approved plan in parallel"
-```
-
-Đó là flow chính.
-Khởi động OMX, làm rõ yêu cầu khi cần, duyệt kế hoạch, rồi chọn `$team` để chạy song song hoặc `$ralph` để một agent lo đến khi xong.
-
-## OMX dùng để làm gì
-
-Dùng OMX nếu bạn đã quen Codex và muốn trải nghiệm tốt hơn:
-- workflow chuẩn xoay quanh `$deep-interview`, `$ralplan`, `$team` và `$ralph`
-- các role chuyên biệt và skill hỗ trợ cho từng loại task
-- hướng dẫn dự án qua `AGENTS.md` theo scope
-- lưu trạng thái lâu dài trong `.omx/` — kế hoạch, log, memory và theo dõi mode
-
-Nếu bạn chỉ muốn dùng Codex thuần mà không cần thêm workflow, thì có lẽ không cần OMX.
-
-## Bắt đầu nhanh
-
-### Yêu cầu
-
-- Node.js 20+
-- Codex CLI đã cài: `npm install -g @openai/codex`
-- Codex đã xác thực (auth)
-- `tmux` trên macOS/Linux nếu muốn dùng team runtime
-- `psmux` trên Windows nếu muốn dùng team mode
-
-### Phiên đầu tiên
-
-Khởi chạy OMX:
-
-```bash
-omx --madmax --high
-```
-
-Rồi thử workflow chính:
-
-```text
-$deep-interview "clarify the authentication change"
-$ralplan "approve the safest implementation path"
-$ralph "carry the approved plan to completion"
-$team 3:executor "execute the approved plan in parallel"
-```
-
-Dùng `$team` khi cần nhiều worker chạy song song, hoặc `$ralph` khi muốn một agent lo từ đầu đến cuối.
-
-## Mô hình đơn giản
-
-OMX **không** thay thế Codex.
-
-OMX bổ sung một lớp hỗ trợ phía trên Codex:
-- **Codex** vẫn làm toàn bộ việc thực thi
-- **Role của OMX** giúp gọi nhanh các vai trò chuyên biệt
-- **Skill của OMX** đóng gói các workflow phổ biến thành lệnh
-- **`.omx/`** lưu kế hoạch, log, memory và trạng thái runtime
-
-Nói đơn giản: OMX giúp **phân task đúng chỗ + workflow rõ ràng + runtime ổn định hơn** — không phải một bảng điều khiển để gõ lệnh cả ngày.
-
-## Hướng dẫn cho người mới
-
-1. Chạy `omx setup`
-2. Khởi động với `omx --madmax --high`
-3. Dùng `$deep-interview "..."` khi yêu cầu còn mơ hồ
-4. Dùng `$ralplan "..."` để duyệt kế hoạch và cân nhắc trade-off
-5. Chọn `$team` để chạy song song hoặc `$ralph` để một agent lo đến khi xong
-
-## Workflow khuyến nghị
-
-1. `$deep-interview` — làm rõ scope khi yêu cầu còn mơ hồ.
-2. `$ralplan` — chuyển scope đã rõ thành kế hoạch triển khai được duyệt.
-3. `$team` hoặc `$ralph` — dùng `$team` khi cần nhiều worker song song, hoặc `$ralph` khi muốn một agent chạy liên tục đến khi xong.
-
-## Các lệnh thường dùng trong phiên
-
-| Lệnh | Dùng khi |
-| --- | --- |
-| `$deep-interview "..."` | Làm rõ ý định, scope và non-goal |
-| `$ralplan "..."` | Duyệt kế hoạch triển khai và trade-off |
-| `$ralph "..."` | Chạy liên tục đến khi hoàn thành và verify |
-| `$team "..."` | Chạy song song khi task đủ lớn |
-| `/skills` | Xem danh sách skill và helper đã cài |
-
-## Nâng cao
-
-Các phần dưới đây hữu ích nhưng không phải là bước bắt đầu chính.
-
-### Team runtime
-
-Dùng team runtime khi cần phối hợp nhiều worker qua tmux/worktree — đây không phải bước bắt đầu mặc định.
-
-```bash
-omx team 3:executor "fix the failing tests with verification"
-omx team status <team-name>
-omx team resume <team-name>
-omx team shutdown <team-name>
-```
-
-### Setup, doctor và HUD
-
-Đây là các công cụ vận hành/hỗ trợ:
-- `omx setup` cài prompt, skill, config và scaffold AGENTS
-- `omx doctor` kiểm tra cài đặt khi có vấn đề
-- `omx hud --watch` theo dõi trạng thái, không phải workflow chính
-
-### Explore và sparkshell
-
-- `omx explore --prompt "..."` tìm kiếm chỉ đọc trong repository
-- `omx sparkshell <command>` chạy lệnh shell có kiểm soát output
-
-Ví dụ:
-
-```bash
-omx explore --prompt "find where team state is written"
-omx sparkshell git status
-omx sparkshell --tmux-pane %12 --tail-lines 400
-```
-
-### Cài tmux theo nền tảng
-
-`omx team` cần backend tương thích tmux:
-
-| Nền tảng | Cài đặt |
-| --- | --- |
-| macOS | `brew install tmux` |
-| Ubuntu/Debian | `sudo apt install tmux` |
-| Fedora | `sudo dnf install tmux` |
-| Arch | `sudo pacman -S tmux` |
-| Windows | `winget install psmux` |
-| Windows (WSL2) | `sudo apt install tmux` |
-
-## Vấn đề đã biết
-
-### Intel Mac: CPU `syspolicyd` / `trustd` cao khi khởi động
-
-Trên một số máy Intel Mac, khi khởi động OMX — đặc biệt với `--madmax --high` — CPU có thể tăng đột biến do macOS Gatekeeper xác thực nhiều tiến trình đồng thời.
-
-Nếu gặp tình trạng này, thử:
-- `xattr -dr com.apple.quarantine $(which omx)`
-- Thêm ứng dụng terminal vào danh sách Developer Tools trong cài đặt Security của macOS
-- Dùng cấu hình nhẹ hơn (bỏ `--madmax --high`)
-
-## Tài liệu
-
-- [Bắt đầu](./docs/getting-started.html)
-- [Hướng dẫn demo](./DEMO.md)
-- [Danh mục agent](./docs/agents.html)
-- [Tham chiếu skill](./docs/skills.html)
-- [Tích hợp](./docs/integrations.html)
-- [Hướng dẫn OpenClaw / notification gateway](./docs/openclaw-integration.md)
-- [Đóng góp](./CONTRIBUTING.md)
-- [Nhật ký thay đổi](./CHANGELOG.md)
-
-## Ngôn ngữ
-
-- [English](./README.md)
-- [한국어](./README.ko.md)
-- [日本語](./README.ja.md)
-- [简体中文](./README.zh.md)
-- [繁體中文](./README.zh-TW.md)
-- [Tiếng Việt](./README.vi.md)
-- [Español](./README.es.md)
-- [Português](./README.pt.md)
-- [Русский](./README.ru.md)
-- [Türkçe](./README.tr.md)
-- [Deutsch](./README.de.md)
-- [Français](./README.fr.md)
-- [Italiano](./README.it.md)
-- [Ελληνικά](./README.el.md)
-- [Polski](./README.pl.md)
-
-## Đóng góp
-
-| Vai trò | Tên | GitHub |
-| --- | --- | --- |
-| Tác giả & Lead | Yeachan Heo | [@Yeachan-Heo](https://github.com/Yeachan-Heo) |
-| Maintainer | HaD0Yun | [@HaD0Yun](https://github.com/HaD0Yun) |
-
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=Yeachan-Heo/oh-my-codex&type=date&legend=top-left)](https://www.star-history.com/#Yeachan-Heo/oh-my-codex&type=date&legend=top-left)
-
-## Giấy phép
-
-MIT