feat: Copilot CLI fix for Termux (Android ARM64)

README.md

@@ -68,6 +68,16 @@ dotnet run -- --mcp
 - Sensitive data (code, events, files) encrypted at rest in SQLite
 - Non-sensitive metadata (timestamps, types) stored in plaintext
 
+### 3. `copilot-termux/` — Copilot CLI Fix for Termux
+
+Fixes GitHub Copilot CLI (v1.0.60+) to run natively on Termux (Android ARM64). Solves the `Native addon "runtime" not found for android-arm64` error and all related glibc/seccomp issues.
+
+```bash
+cd copilot-termux && ./install.sh
+```
+
+**See [copilot-termux/README.md](copilot-termux/README.md) for full documentation.**
+
 ## Requirements
 
 - Termux (Android ARM64) or proot-distro Ubuntu

copilot-termux/README.md

@@ -0,0 +1,206 @@
+# Copilot CLI on Termux — Complete Fix
+
+> تشغيل GitHub Copilot CLI (v1.0.60+) مباشرة على Termux (Android ARM64) بدون الحاجة للدخول إلى proot-distro
+
+## المشكلة
+
+عند تثبيت Copilot CLI على Termux بالطريقة العادية (`npm install -g @github/copilot`)، يفشل التشغيل بالخطأ:
+
+```
+Error: Native addon "runtime" not found for android-arm64
+```
+
+### تسلسل المشكلة وجذرها
+
+Copilot CLI v1.0.60 يعتمد على native addon مُترجم مسبقاً (`runtime.node`) وهو ملف ELF مبني لنظام Linux القياسي. عند تشغيله على Termux تظهر سلسلة من المشاكل المتتابعة:
+
+```
+المشكلة 1: كشف المنصة
+├─ process.platform يُرجع "android" بدلاً من "linux"
+├─ الكود يبحث عن prebuilds/android-arm64/ وهو غير موجود
+└─ الحل: ترقيع app.js لمعاملة android كـ linux
+
+المشكلة 2: المكتبات الأصلية (Native Libraries)
+├─ runtime.node مبني ضد glibc (GNU C Library)
+├─ Termux يستخدم Bionic (Android C Library)
+├─ لا يمكن خلط glibc و Bionic في نفس العملية
+└─ الحل: استخدام Node.js مبني ضد glibc مع Ubuntu rootfs libraries
+
+المشكلة 3: libc.so Linker Scripts
+├─ Ubuntu يستخدم usrmerge (/lib → /usr/lib)
+├─ libc.so ملف نصي (linker script) وليس مكتبة ELF
+├─ Dynamic linker يفشل عند محاولة تحميله
+└─ الحل: تخطّيه - المكتبات الحقيقية هي .so.6
+
+المشكلة 4: LD_PRELOAD التعارض
+├─ Termux يحقن libtermux-exec-ld-preload.so عبر LD_PRELOAD
+├─ هذه المكتبة مبنية ضد Bionic وتتعارض مع glibc
+└─ الحل: إلغاء LD_PRELOAD عند التشغيل
+
+المشكلة 5: Seccomp و Syscalls
+├─ Android يحجب بعض system calls عبر seccomp filters
+├─ glibc Node.js يستخدم syscalls محجوبة → Signal 31 (SIGSYS)
+└─ الحل: استخدام proot لاعتراض syscalls المحجوبة
+```
+
+### الحل الجذري
+
+استخدام **proot خفيف** (بدون proot-distro الكامل) لتشغيل Node.js 22 المبني لـ Linux مع مكتبات Ubuntu، مع ربط مجلد Termux الرئيسي لإبقاء الملفات والجلسات متاحة:
+
+```
+Termux Shell
+  └─ copilot (wrapper script)
+       └─ proot (syscall interception فقط)
+            └─ Ubuntu rootfs (مكتبات glibc)
+                 └─ Node.js 22 linux-arm64
+                      └─ Copilot CLI app.js (مُرقّع)
+                           └─ runtime.node (يعمل بنجاح)
+```
+
+## المتطلبات
+
+| المتطلب | الأمر |
+|---------|-------|
+| Termux (Android ARM64) | — |
+| proot-distro مع Ubuntu | `pkg install proot-distro && proot-distro install ubuntu` |
+| Node.js على Termux | `pkg install nodejs` |
+| GitHub CLI | `pkg install gh` |
+
+## التثبيت السريع
+
+```bash
+# تثبيت بخطوة واحدة
+bash <(curl -sL https://raw.githubusercontent.com/sbay-dev/dotnet-termux/main/copilot-termux/install.sh)
+```
+
+### أو تثبيت يدوي
+
+```bash
+git clone https://github.com/sbay-dev/dotnet-termux.git
+cd dotnet-termux/copilot-termux
+chmod +x install.sh
+./install.sh
+```
+
+## ماذا يفعل سكربت التثبيت
+
+1. **يتحقق** من المتطلبات (proot-distro، Ubuntu rootfs)
+2. **يُثبّت Copilot CLI** داخل Ubuntu rootfs عبر npm
+3. **يُرقّع `app.js`** لدعم منصة Android (4 ترقيعات)
+4. **يُنزّل Node.js 22** (linux-arm64) لدعم `node:sqlite`
+5. **يُنشئ wrapper script** في `$PREFIX/bin/copilot`
+6. **يختبر** التثبيت تلقائياً
+
+## البنية
+
+```
+copilot-termux/
+├── README.md              # هذا الملف - التوثيق الكامل
+├── install.sh             # سكربت التثبيت الرئيسي
+├── patch-app.sh           # ترقيع app.js لمنصة Android
+├── fix-session.sh         # إصلاح الجلسات التالفة (tokensRemoved سالب)
+└── wrapper-template.sh    # قالب wrapper script
+```
+
+## استكشاف الأخطاء
+
+### الخطأ: `Session file is corrupted (tokensRemoved: Number must be >= 0)`
+
+**رسالة الخطأ الكاملة:**
+```
+Error: Session '1e3b7178-...' was found but could not be loaded.
+Error: Session file is corrupted (line 89198: data.tokensRemoved: Number must be greater than or equal to 0)
+```
+
+**السبب الجذري:**
+
+Copilot CLI يُجري عملية **ضغط (compaction)** دورية على الجلسات الطويلة لتقليل استهلاك الـ tokens. العملية تسجّل حدث `session.compaction_complete` في ملف `events.jsonl` يحتوي:
+- `preCompactionTokens`: عدد الـ tokens قبل الضغط
+- `postCompactionTokens`: عدد الـ tokens بعد الضغط
+- `tokensRemoved`: الفرق بينهما (المفترض أن يكون ≥ 0)
+
+في بعض الحالات — خاصة مع الجلسات الطويلة جداً أو عند استخدام أدوات كثيرة — يحدث أن `postCompactionTokens > preCompactionTokens` (الملخص أكبر من الأصل)، فتكون النتيجة **قيمة سالبة**. هذا سلوك طبيعي من الـ compaction لكن مُخالف لقواعد التحقق (validation schema) التي تشترط `tokensRemoved >= 0`.
+
+**التأثير:**
+- الجلسة **موجودة وسليمة** لكن لا يمكن تحميلها بسبب فشل التحقق
+- البيانات **غير تالفة** فعلياً — فقط قيمة إحصائية خاطئة
+- يمكن أن يتأثر أكثر من حدث compaction في نفس الجلسة (في حالتنا: 19 حدث)
+
+**الإصلاح التلقائي:**
+```bash
+# سكربت إصلاح مضمّن
+./fix-session.sh <session-id>
+
+# مثال
+./fix-session.sh 1e3b7178-cb31-419a-a73b-1ef5f6a0c09d
+```
+
+**الإصلاح اليدوي:**
+```bash
+# 1. العثور على ملف الأحداث
+EVENTS="$HOME/.copilot/session-state/<session-id>/events.jsonl"
+
+# 2. فحص القيم السالبة
+grep -c '"tokensRemoved":-' "$EVENTS"
+
+# 3. نسخة احتياطية
+cp "$EVENTS" "${EVENTS}.bak"
+
+# 4. تصفير جميع القيم السالبة
+sed -i 's/"tokensRemoved":-[0-9]\+/"tokensRemoved":0/g' "$EVENTS"
+
+# 5. استئناف الجلسة
+copilot --resume=<session-id>
+```
+
+**لماذا التصفير آمن:**
+- `tokensRemoved` قيمة **إحصائية بحتة** تُستخدم فقط لتسجيل ما حدث
+- لا تؤثر على محتوى المحادثة أو سياقها أو سلوك النموذج
+- الضغط نفسه تمّ بنجاح — فقط القيمة المسجّلة غير صحيحة
+
+---
+
+### الخطأ: `Native addon "runtime" not found for android-arm64`
+**السبب:** app.js غير مُرقّع
+**الحل:**
+```bash
+cd dotnet-termux/copilot-termux && ./patch-app.sh
+```
+
+### الخطأ: `libc.so: invalid ELF header`
+**السبب:** LD_LIBRARY_PATH يشير لمجلد يحتوي linker scripts
+**الحل:** السكربت يتعامل مع هذا تلقائياً عبر proot
+
+### الخطأ: `Unknown signal 31`
+**السبب:** Android seccomp يحجب syscalls
+**الحل:** استخدام proot (مُضمّن في wrapper)
+
+### الخطأ: `ERR_UNKNOWN_BUILTIN_MODULE: node:sqlite`
+**السبب:** إصدار Node.js قديم (أقل من 22)
+**الحل:** السكربت ينزّل Node.js 22 تلقائياً
+
+## التحديث
+
+عند تحديث Copilot CLI، أعد تشغيل سكربت التثبيت:
+
+```bash
+cd dotnet-termux/copilot-termux && ./install.sh
+```
+
+## المعلومات التقنية
+
+| المكون | التفاصيل |
+|--------|----------|
+| Copilot CLI | v1.0.60 |
+| Node.js | v22.x (linux-arm64, glibc) |
+| نظام الملفات | Ubuntu rootfs عبر proot |
+| المنصة | Android ARM64 (Termux) |
+| Syscall Interception | proot |
+
+## المؤلف
+
+[@sultanaalyami](https://github.com/sultanaalyami) / [sbay-dev](https://github.com/sbay-dev)
+
+## الترخيص
+
+MIT

copilot-termux/fix-session.sh

@@ -0,0 +1,100 @@
+#!/usr/bin/env bash
+# fix-session.sh — إصلاح جلسات Copilot CLI التالفة
+# يُعالج خطأ: Session file is corrupted (tokensRemoved: Number must be >= 0)
+#
+# الاستخدام:
+#   ./fix-session.sh <session-id>
+#   ./fix-session.sh 1e3b7178-cb31-419a-a73b-1ef5f6a0c09d
+#
+# يبحث في المسارات التالية بالترتيب:
+#   1. ~/.copilot/session-state/<id>/events.jsonl
+#   2. $COPILOT_SESSION_DIR (إذا كان مُعيّناً)
+
+set -euo pipefail
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+info()  { echo -e "${CYAN}ℹ️  $1${NC}"; }
+ok()    { echo -e "${GREEN}✅ $1${NC}"; }
+warn()  { echo -e "${YELLOW}⚠️  $1${NC}"; }
+err()   { echo -e "${RED}❌ $1${NC}"; }
+
+if [ $# -lt 1 ]; then
+    echo "الاستخدام: $0 <session-id>"
+    echo "مثال:     $0 1e3b7178-cb31-419a-a73b-1ef5f6a0c09d"
+    exit 1
+fi
+
+SESSION_ID="$1"
+
+# البحث عن ملف الأحداث
+EVENTS=""
+SEARCH_PATHS=(
+    "$HOME/.copilot/session-state/$SESSION_ID/events.jsonl"
+    "${COPILOT_SESSION_DIR:-/nonexistent}/$SESSION_ID/events.jsonl"
+)
+
+for path in "${SEARCH_PATHS[@]}"; do
+    if [ -f "$path" ]; then
+        EVENTS="$path"
+        break
+    fi
+done
+
+if [ -z "$EVENTS" ]; then
+    err "لم يتم العثور على الجلسة: $SESSION_ID"
+    echo "   المسارات التي تم البحث فيها:"
+    for path in "${SEARCH_PATHS[@]}"; do
+        echo "   - $path"
+    done
+    exit 1
+fi
+
+info "ملف الأحداث: $EVENTS"
+info "حجم الملف: $(du -h "$EVENTS" | cut -f1)"
+info "عدد الأسطر: $(wc -l < "$EVENTS")"
+
+# فحص القيم السالبة
+NEGATIVE_COUNT=$(grep -c '"tokensRemoved":-' "$EVENTS" 2>/dev/null || echo "0")
+
+if [ "$NEGATIVE_COUNT" -eq 0 ]; then
+    ok "لا توجد قيم tokensRemoved سالبة. الملف سليم."
+    exit 0
+fi
+
+warn "وُجدت $NEGATIVE_COUNT قيمة سالبة في tokensRemoved"
+echo ""
+
+# عرض القيم التالفة
+info "القيم التالفة:"
+grep -n '"tokensRemoved":-' "$EVENTS" | while IFS= read -r match; do
+    LINE_NUM=$(echo "$match" | cut -d: -f1)
+    VALUE=$(echo "$match" | grep -o '"tokensRemoved":-[0-9]*' | head -1)
+    echo "   السطر $LINE_NUM: $VALUE"
+done
+echo ""
+
+# نسخة احتياطية
+BACKUP="${EVENTS}.bak-$(date +%Y%m%d%H%M%S)"
+cp "$EVENTS" "$BACKUP"
+ok "نسخة احتياطية: $BACKUP"
+
+# الإصلاح: تصفير جميع القيم السالبة
+sed -i 's/"tokensRemoved":-[0-9]\+/"tokensRemoved":0/g' "$EVENTS"
+
+# التحقق
+REMAINING=$(grep -c '"tokensRemoved":-' "$EVENTS" 2>/dev/null || echo "0")
+
+if [ "$REMAINING" -eq 0 ]; then
+    ok "تم إصلاح $NEGATIVE_COUNT قيمة بنجاح!"
+    echo ""
+    info "جرّب الآن:"
+    echo "   copilot --resume=$SESSION_ID"
+else
+    err "لا تزال هناك $REMAINING قيمة سالبة. الرجاء الإصلاح يدوياً."
+    exit 1
+fi