🧭 مخطّط GOAP · GOAP Planner

تحويل هدف المشروع → خطة تنفيذ مرتّبة صحيحة هندسياً (A* optimal)

ما يفعله

يحوّل هدفاً (بالعربية أو الإنجليزية) + حالة العالم الحالية إلى خطة أفعال مرتّبة قابلة للتنفيذ — كل فعل يحترم شروطه المسبقة، بأقل تكلفة، مع مدة تقديرية و zoning.

Method Statement Work Sequence Zoning Resume mid-project A* Optimal 29 اختبار E2E ✓

الاستخدام (CLI)

cd skills/goap-planner/scripts

# المشروع الكامل → التسليم
python3 goap_cli.py plan --goal handover
python3 goap_cli.py plan --goal تسليم        # عربي مدعوم

# هدف جزئي (الهيكل فقط)
python3 goap_cli.py plan --goal frame

# استئناف من منتصف المشروع
python3 goap_cli.py plan --goal frame --have foundation,wp_sub,rebar_fnd

# مخرَج JSON للأتمتة
python3 goap_cli.py plan --goal handover --json

# الأهداف المتاحة + الأسماء العربية
python3 goap_cli.py goals

# 29 اختبار (E2E + red-team)
python3 goap_cli.py selftest

مثال مخرَج حقيقي (مشروع إسكان → التسليم)

[PLAN FOUND] 27 steps | cost=46.0 | est_duration=215 days
------------------------------------------------------------
 1. mobilize_site (3d)      → تجهيز الموقع
 2. start_dewatering (2d)   → نظام نزح المياه (مستمر)
 3. survey_setout (2d)      → المساحة والتوطين
 4. clear_grub (3d)         → تنظيف الموقع
 5. excavate [sub] (8d)     → الحفر للمنسوب
 ...
 9. pour_foundation [sub]   → صبّ الأساس
13. frame_typical [super]   → الهيكل الخرساني المتكرّر
...
27. handover [handover]     → التسليم الجوهري للمالك

البنية

📦 skills/goap-planner/scripts/goap_engine.py — محرّك A* عام
🏗️ skills/goap-planner/scripts/kcpc_domain.py — 28 فعل هندسي حقيقي
⌨️ skills/goap-planner/scripts/goap_cli.py — واجهة + محلّل أهداف عربي/إنجليزي

الأصل والضمانات

🦾 نموذج «الاستخلاص الآمن»: نأخذ الفكرة، نبنيها أصيلة عندنا، صفر سلبية.