thrunt-god

من الإشارة إلى السرب.
لا آلهة. فقط ثرنت.

نظام أوامر صيد التهديدات لبيئات التطوير الذكية (IDEs agentic).
Claude Code · OpenCode · Gemini · Codex · Copilot · Cursor · Windsurf

/thrunt:autonomous  |  أمر واحد، صيد كامل

تثبيت  ·   المراحل الخمس  ·   الأوامر  ·   التدفقات الشائعة  ·   المخرجات

التثبيت

npx thrunt-god@latest --claude --local

قم بتجهيز سطح أوامر الصيد في بيئة IDE المحلية الخاصة بك.

تثبيت إصدار ألفا لملحق VS Code

قم بتنزيل thrunt-god-0.3.0.vsix من الإصدار v0.3.0.

ثم قم بتثبيته بإحدى طريقتين:

1. في VS Code، افتح الإضافات، انقر على قائمة ...، اختر Install from VSIX...، واختر الملف الذي تم تنزيله.
2. من الطرفية:

code --install-extension thrunt-god-0.3.0.vsix

بعد التثبيت، افتح مجلدًا يحتوي على .planning/MISSION.md أو .hunt/MISSION.md وسيتم تفعيل الشريط الجانبي لـ THRUNT تلقائيًا.

المراحل الخمس

كل عملية صيد تمر بخمس مراحل. كل خطوة واضحة.

أوامر الصيد

أوامر Thrunt

أوامر الأدوات والتنسيق (/thrunt:*) لإدارة مساحة العمل، التشخيص، الإعدادات، والتحكم في الوكلاء.

التدفقات الشائعة

المخرجات

جميع حالة الصيد موجودة في دليل تخطيط في جذر المشروع (افتراضيًا .planning/). كل استعلام، إيصال، ونتيجة هو ملف، ليس ملخصًا.

.planning/
├── config.json             # إعدادات المشروع (الوضع، الملف الشخصي، الموصلات، مفاتيح سير العمل)
├── MISSION.md              # مهمة ونطاق برنامج الصيد
├── HYPOTHESES.md           # فرضيات قابلة للاختبار مع تتبع الحالة
├── SUCCESS_CRITERIA.md     # تعريف الإنجاز للبرنامج
├── HUNTMAP.md              # تفصيل المراحل وخريطة التنفيذ
├── STATE.md                # المرحلة الحالية، التقدم، المعوقات
├── FINDINGS.md             # النتائج المؤكدة فقط
├── EVIDENCE_REVIEW.md      # تدقيق سلسلة الأدلة
├── QUERIES/                # الاستعلامات المنفذة بالضبط مع الطوابع الزمنية
├── RECEIPTS/               # إيصالات التنفيذ لكل مهمة مرحلة
├── DETECTIONS/             # قواعد الكشف المعززة من النتائج
├── environment/
│   └── ENVIRONMENT.md      # جرد مصدر البيانات وخريطة الوصول
├── phases/                 # خطط، أبحاث، ونتائج لكل مرحلة
├── workstreams/            # حالات صيد متوازية (اختياري)
├── milestones/             # معالم مكتملة مؤرشفة
└── published/              # مخرجات نهائية

الإعدادات

الإعدادات موجودة في .planning/config.json، يتم إنشاؤها بواسطة /hunt:new-program وقابلة للتعديل عبر /thrunt:settings. الإعدادات الافتراضية العامة في ~/.thrunt/defaults.json تُدمج في كل مشروع جديد.

المخطط الكامل وملفات تعريف الموصلات: docs/CONFIGURATION.md

دليل تخطيط مخصص

قم بتعيين THRUNT_PLANNING_DIR لتغيير اسم الدليل. يؤثر هذا على جميع عمليات حل المسار، اكتشاف جذر المشروع، وتخزين المخرجات.

export THRUNT_PLANNING_DIR=".hunt"

التخزين

افتراضيًا، يتم التزام .planning/ في git حتى تنتقل مخرجات الصيد مع المستودع. للحفاظ على المخرجات محليًا:

1. أضف .planning/ إلى .gitignore
2. عيّن planning.commit_docs: false و planning.search_gitignored: true في الإعدادات
3. إذا كانت متتبعة سابقًا: git rm -r --cached .planning/

مسارات العمل (/thrunt:new-workspace) تنشئ أشجار مخرجات معزولة تحت .planning/workstreams/{name}/ لعمليات صيد متوازية في نفس المشروع.

يقوم التمهيد بملء الحقول المؤكدة فورًا. TBD يشير فقط إلى حقائق البيئة الحية أو المشغل التي لا تزال غير معروفة.