@mmmbuto/codex-cli-termux 0.58.3-termux → 0.60.1-termux

package/README.md

@@ -6,11 +6,8 @@
 [![downloads](https://img.shields.io/npm/dt/@mmmbuto/codex-cli-termux?style=flat-square)](https://www.npmjs.com/package/@mmmbuto/codex-cli-termux)
 [![ko-fi](https://img.shields.io/badge/☕_Support-Ko--fi-FF5E5B?style=flat-square&logo=ko-fi)](https://ko-fi.com/dionanos)
 
-> [!TIP]
-> **Enjoying Codex on mobile?** ☕
-> This project requires ~20 hours/month for ARM64 compilation, upstream tracking, and compatibility patches.
-> [Support development →](https://ko-fi.com/dionanos)
-
+---
+> 💡 Like CLI tools? Check out my next project, **NexusCLI** — an open, developer-focused AI terminal cockpit: https://github.com/DioNanos/NexusCLI
 ---
 
 ## What This Is
@@ -38,6 +35,10 @@ We only apply patches for issues that:
 
 **Current patches**: See [patches/](./patches/) directory for full documentation.
 
+Serve aiuto per debuggare gli avvisi di upgrade? Consulta
+[docs/termux-upgrade-checks.md](./docs/termux-upgrade-checks.md) per cause note e
+strategie di fix.
+
 **Found an issue?** Well-documented bug reports with reproduction steps are welcome! Open an [issue](https://github.com/DioNanos/codex-termux/issues).
 
 ---
@@ -79,7 +80,7 @@ npm install -g @mmmbuto/codex-cli-termux
 
 ```bash
 codex --version
-# Output: codex-cli 0.58.0
+# Output: codex-tui 0.60.1
 
 codex login
 # Opens browser for authentication
@@ -111,6 +112,84 @@ For full documentation, see [OpenAI Codex docs](https://github.com/openai/codex)
 
 ---
 
+## 🧪 Testing & Validation
+
+### Automated Test Suite
+
+This project includes a comprehensive test suite specifically designed for Termux validation:
+
+**Test Suite**: [`CODEX_TEST_SUITE.md`](./CODEX_TEST_SUITE.md)
+
+**Coverage**:
+- ✅ **74 automated tests** across 11 categories
+- ✅ **10 Termux-specific tests** validating all 8 compatibility patches
+- ✅ File operations, shell execution, environment detection
+- ✅ Android permissions, library paths, package manager
+- ✅ Error handling and edge cases
+
+**How to use**:
+
+```bash
+# Start Codex
+codex
+
+# Feed the test suite
+> Read and execute all tests in https://github.com/DioNanos/codex-termux/blob/main/CODEX_TEST_SUITE.md
+```
+
+Codex will automatically:
+1. Execute all 74 tests sequentially
+2. Report PASS/FAIL for each test
+3. Generate a final summary with:
+   - Total passed/failed counts
+   - Category breakdowns
+   - Critical failures (if any)
+   - Overall verdict
+
+**Test Categories**:
+1. System Information (3 tests)
+2. File Operations (8 tests)
+3. Search & Discovery (3 tests)
+4. Shell Execution (4 tests)
+5. Text Processing (2 tests)
+6. Web & Network (2 tests - optional)
+7. Git Operations (2 tests - optional)
+8. AI Capabilities (3 tests)
+9. Error Handling (3 tests)
+10. **Termux-Specific (10 tests)** ⭐ - Validates all Android patches
+11. Cleanup (1 test)
+
+**Termux-Specific Tests Include**:
+- ✅ Environment paths (`$PREFIX`, `$HOME`, `$LD_LIBRARY_PATH`)
+- ✅ Shell detection (bash/zsh on Android)
+- ✅ Package manager (`pkg` commands)
+- ✅ Storage access (`/sdcard`, `~/storage`)
+- ✅ Android permissions and sandbox isolation
+- ✅ Library path preservation (Patch #8 validation)
+- ✅ Browser opener availability (Patch #1 validation)
+- ✅ Architecture detection (aarch64/ARM64)
+
+**Success Criteria**:
+- All System, Files, Shell, and Termux tests must pass
+- At least 80% overall pass rate
+- No critical crashes
+
+**Example Report**:
+```
+CODEX CLI TEST SUITE - FINAL REPORT
+====================================
+Total Tests: 74
+✅ Passed: 71
+❌ Failed: 1
+⚠️ Skipped: 2 (WebSearch, Git - optional)
+
+Termux-Specific: 10/10 passed ✅
+
+VERDICT: ✅ PASS
+```
+
+---
+
 ## 🔨 Building from Source
 
 See [BUILDING.md](./BUILDING.md) for compilation instructions.
@@ -153,7 +232,7 @@ See [LICENSE](./LICENSE) file for details.
 
 ---
 
-**Version**: Based on OpenAI Codex 0.58.0 (includes GPT-5.1 support)
+**Version**: Based on OpenAI Codex 0.60.1 (includes GPT-5.1 MAX support)
 **Platform**: Android Termux ARM64
 **Maintained**: Community-driven, not affiliated with OpenAI
 
@@ -161,41 +240,62 @@ See [LICENSE](./LICENSE) file for details.
 
 ## 📜 Changelog
 
-### v0.58.0-termux (2025-11-13)
+### v0.60.1-termux (2025-11-20)
+
+**Major Update**: Synced with upstream OpenAI Codex rust-v0.60.1 (250+ commits)
+
+**Upstream Features**:
+- 🤖 **GPT-5.1 MAX Support**: New MAX model with enhanced capabilities and performance
+- 🔧 **App-Server Protocol**: Enhanced v2 APIs for thread management
+- ⚡ **Performance Optimizations**: Improved TUI responsiveness and memory usage
+- 🪟 **Windows Sandbox**: Enhanced security features (not applicable to Termux)
+- 🐛 **Bug Fixes**: 250+ commits with stability improvements and fixes
 
-Synced with upstream OpenAI Codex rust-v0.58.0 (62 commits)
+**Termux-Specific**:
+- ✅ **All 8 patches preserved and verified**
+- ✅ **Patch #8 updated**: Shell detection refactored for upstream changes
+- ✅ **Build optimized for 8GB RAM**: Compiled successfully on ROG Phone 3
+- ✅ **Binary size**: 37MB (24% smaller than 0.58.4)
+- ✅ **Test Suite**: 74 automated tests including 10 Termux-specific validations
 
-**Major features:**
-- 🤖 **GPT-5.1 Support**: New model family (gpt-5.1-codex, gpt-5.1-codex-mini, gpt-5.1)
-- 🧠 **Adaptive Reasoning**: Configurable effort levels (Low, Medium, High)
-- ⌨️ **Enhanced TUI**: Job control, improved navigation, better model picker
-- 🔧 **Shell Detection**: Centralized command generation for unified exec
-- 📊 **App-server v2**: Thread/Turn APIs improvements
+**Patches Validated**:
+1. ✅ Browser login (`termux-open-url`)
+2. ✅ RAM optimizations (`lto=false`, `codegen-units=16`)
+3. ✅ Android shell detection (`$SHELL` env var)
+4. ✅ Android sandbox disabled
+5. ✅ LD_* environment variables preserved
+6. ✅ Auto-update URL (`DioNanos/codex-termux`)
+7. ✅ Version parser (`-termux` suffix support)
+8. ✅ NPM package name (`@mmmbuto/codex-cli-termux`)
 
-**Termux-specific:**
-- ✅ All Android patches preserved and verified working
-- ✅ Browser login fix (termux-open-url)
-- ✅ RAM optimizations (lto=false, codegen-units=16)
-- ✅ Auto-update for @mmmbuto/codex-cli-termux
+**Breaking Changes**: None - fully backward compatible
 
-Full upstream changelog: https://github.com/openai/codex/compare/rust-v0.57.0...rust-v0.58.0
+**Testing**: Comprehensive test suite with 74 tests available at [`CODEX_TEST_SUITE.md`](./CODEX_TEST_SUITE.md)
+
+Full upstream changelog: https://github.com/openai/codex/compare/rust-v0.58.0...rust-v0.60.1
 
 ---
 
-### v0.57.0-termux (2025-11-10)
+### v0.58.4-termux (2025-11-14)
+
+**Critical bugfix**: Auto-update detection now working
+
+**Fixes:**
+- 🐛 **Auto-update detection restored** - Fixed version parser losing `-termux` suffix support after upstream merge
+- 🐛 **Tag parsing fixed** - `extract_version_from_latest_tag` now supports both `rust-v*` (upstream) and `v*-termux` (fork) formats
+- 🔧 **Test coverage added** - New test for Termux tag format validation
 
-Synced with upstream OpenAI Codex rust-v0.57.0 (25 commits)
+**Technical details:**
+- **Root cause**: v0.58.0 upstream merge overwrote previous `-termux` suffix fix in `parse_version()`
+- **Additional issue**: New upstream code only accepted `rust-v` prefix, rejecting our `v0.58.0-termux` tags
+- **Impact**: `~/.config/codex/version.json` was never created, preventing "Update available" banner
+- **Solution**: Re-applied `-termux` suffix support + added `v*` prefix support in tag parser
 
-**Upstream improvements:**
-- ⌨️ **TUI Navigation**: CTRL-n / CTRL-p for navigating slash commands, files, history
-- 🔧 **Unified Exec**: Improved safe commands handling, process group timeout fixes
-- 🪟 **WSL Support**: Path normalization for Windows Subsystem for Linux
-- 🚀 **App-server v2**: New Thread/Turn APIs, account endpoints
-- 🧹 **Refactoring**: Terminal cleanup (deprecated flush logic removed)
+**Affected versions**: v0.58.0 through v0.58.3 had broken auto-update detection.
 
-**Termux-specific:**
-- ✅ Android auto-update disabled (manual update instructions shown)
-- ✅ `termux-open-url` for browser login (ndk-context crash fix maintained)
-- ✅ RAM optimizations for 16GB devices (lto=false, codegen-units=16)
+**Termux patches (4 total):**
+- ✅ **Patch #1**: Browser login fix (`termux-open-url`)
+- ✅ **Patch #2**: RAM optimizations (`lto=false`, `codegen-units=16`)
+- ✅ **Patch #3**: Auto-update URL (`@mmmbuto/codex-cli-termux`)
+- ✅ **Patch #4**: Auto-update detection (this release)
 
-Full upstream changelog: https://github.com/openai/codex/compare/rust-v0.56.0...rust-v0.57.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mmmbuto/codex-cli-termux",
-  "version": "0.58.3-termux",
-  "description": "OpenAI Codex CLI v0.58.0 with GPT-5.1 support, pre-compiled for Android Termux (ARM64)",
+  "version": "0.60.1-termux",
+  "description": "OpenAI Codex CLI v0.60.1 with GPT-5.1 MAX support, pre-compiled for Android Termux (ARM64)",
   "type": "module",
   "main": "bin/codex.js",
   "bin": {