# الأدوات الأساسية (أي مجموعة تعمل — يتكيف Pentx)
sudo apt install nmap nuclei httpx sqlmap ffuf nikto amass subfinder
# أو على Termux:
pkg install nmap nuclei httpx sqlmap ffuf nikto amass subfinder

# تبعيات Python
pip3 install requests beautifulsoup4

git clone https://github.com/yashas-13/pentx-vapt-skill.git
cd pentx-vapt-skill

# 1. تحقق من الأدوات المتاحة
python3 scripts/pentx.py --check

# 2. تشغيل VAPT كامل من 5 مراحل (للقراءة فقط، آمن)
python3 scripts/pentx.py https://target.example.com ./output --no-exploit

# 3. تقييم كامل (يتطلب إذنًا — اقرأ مطالبات المرحلة 1)
python3 scripts/pentx.py https://target.example.com ./output

# 4. تشغيل مرحلة محددة فقط
python3 scripts/pentx.py https://target.example.com ./output --phase 3

# 5. إعادة إنشاء التقرير من الاكتشافات الموجودة
python3 scripts/pentx.py ./output --phase 5

output/
├── phase1-recon/
│   ├── assets.txt        → جميع الأصول المكتشفة
│   ├── live.json         → المضيفات النشطة (httpx)
│   └── subdomains.txt    → تعداد النطاقات الفرعية
├── phase2-scan/
│   ├── nmap_full.json    → نتائج nmap الكاملة
│   ├── ffuf_dirs.json    → تخمين الدلائل
│   └── nikto.json        → اكتشافات Nikto
├── phase3-vuln/
│   └── findings.jsonl    → اكتشافات الثغرات (JSONL)
├── phase4-exploit/
│   └── exploits.jsonl    → الاستغلالات المؤكدة + إثباتات المفهوم
├── report.html           → تقرير HTML كامل
├── report.md             → تقرير Markdown كامل
├── exec-summary.md       → الملخص التنفيذي
├── findings-merged.json  → جميع الاكتشافات المدمجة
└── poc-full/
    └── poc-*.txt         → قطع أثرية خام لإثبات المفهوم (*.txt)

pentx-vapt-skill/
├── SKILL.md                        # مواصفات مهارة pi-agent
├── README.md                       # هذا الملف
├── LICENSE                         # MIT
├── CONTRIBUTING.md                 # دليل المساهمة
├── assets/
│   └── report_template.md          # قالب التقرير
├── references/
│   ├── methodology.md              # منهجية المراحل الخمس + قالب إثبات المفهوم + CVSS
│   └── tools-matrix.md             # قدرات الأدوات + استراتيجية الدقة
└── scripts/
    ├── pentx.py                    # منسق سطر الأوامر الرئيسي
    ├── tools_check.sh              # فاحص توفر الأدوات
    └── lib/
        ├── pentx_common.py         # مخزن الاكتشافات، التقاط إثبات المفهوم، البدائل
        ├── phase_recon.py          # المرحلة 1
        ├── phase_scan.py           # المرحلة 2
        ├── phase_vuln.py           # المرحلة 3
        ├── phase_exploit.py        # المرحلة 4
        └── report_gen.py           # المرحلة 5

# تثبيت أو تحديث مهارة Pentx
bash -c "$(curl -fsSL https://raw.githubusercontent.com/yashas-13/pentx-vapt-skill/main/scripts/install.sh)"

# أو مع pi-agent (إذا كان مثبتًا)
/pentx install

#!/usr/bin/env bash
set -euo pipefail
REPO="yashas-13/pentx-vapt-skill"
BRANCH="main"
INSTALL_DIR="${HOME}/.pi/agent/skills/pentx"

echo "🔧 Installing Pentx VAPT skill..."
mkdir -p "${INSTALL_DIR}"
curl -fsSL "https://github.com/${REPO}/archive/refs/heads/${BRANCH}.tar.gz" | \
  tar -xz --strip-components=1 -C "${INSTALL_DIR}"

# Check tools
python3 "${INSTALL_DIR}/scripts/pentx.py" --check

echo "✅ Pentx installed to ${INSTALL_DIR}"
echo "📖 Run: python3 ${INSTALL_DIR}/scripts/pentx.py https://target.example.com ./output --no-exploit"