SYNAPTIC Sentinel

مراقب أمان للبرمجة بالإحساس (vibe-coding). مجموعة أدوات أمان وكيلية (agentic) بترخيص Apache-2.0 للمشاريع التي يكتب معظم كودها بواسطة الذكاء الاصطناعي. خمسة كشافة حتمية (deterministic scouts) تلتقط المشاكل النحوية؛ طبقة الدماغ (Brain Layer) (BYOK Anthropic) تقرر ما هو مهم حقًا وكيفية إصلاحه — كل ذلك داخل بيئة التطوير.

يقوم سينتينل سينابتيك بتدقيق مشروع داخل محيط العميل — لا يغادر كودك جهازك أبدًا — وينتج نتائج داخلية للمطور بالإضافة إلى كتاب تدقيق (حزمة أدلة) للامتثال والتكامل المستمر.

المنتج الثالث في عائلة SYNAPTIC، الشقيق لـ SYNAPTIC Expert.

الحالة

🚀 مباشر على سوق Visual Studio — RealGoLab.synaptic-sentinel (الإصدار 0.3.3، Apache-2.0).

🚧 تطوير نشط (ما قبل الإصدار 1.0). قيد التشغيل: طبقة الكشافة (5 ماسحات ضوئية)، المنسق (Coordinator)، المراسلون (كتاب JSON/HTML/SARIF)، واجهة سطر الأوامر (CLI)، وإضافة VSCode؛ طبقة الدماغ مع 3 وكلاء (الفرز / السياق / التصحيح، BYOK متعدد المزودين). جميع الحزم بموجب Apache-2.0 — لا يوجد مستوى متميز، ولا بوابة احتكارية.

التثبيت في VSCode:

code --install-extension RealGoLab.synaptic-sentinel

كيف يعمل

• طبقة الكشافة (حتمية، متوازية) — خمسة مدققين يعملون كعمليات محلية ويطبعون نتائجهم: OpenGrep (SAST، 17 قاعدة منسقة مع تدفق التلوث)، Gitleaks (الأسرار)، Trivy (SCA)، Checkov (IaC)، وVibe-Detect (الأنماط المضادة الخاصة بالكود المولد بالذكاء الاصطناعي).
• المنسق — ينسق بين الكشافة مع مفتاح إيقاف لكل كشاف، ويزيل النتائج المكررة، ويخزنها في colony.db.
• طبقة الدماغ (LLM، BYOK Anthropic) — وكلاء يقومون بالفرز، السياق، واقتراح التصحيحات للنتائج. مفتاح Anthropic API الخاص بك يذهب مباشرة إلى النموذج؛ لا يوجد خلفية Synaptic.
• ذاكرة السرب — الأنماط التي صنفتها طبقة الدماغ بأدلة قوية تُحل مسبقًا في الفحوصات اللاحقة دون إنفاق رمز LLM.
• الأسطح — واجهة سطر أوامر (CLI) وإضافة VSCode (السطح الأساسي).

ما الذي يجعله مراقب أمان للبرمجة بالإحساس

• كشاف Vibe-Detect — كشاف مدمج مخصص للأنماط المضادة الخاصة بالكود المولد بالذكاء الاصطناعي: واجهات برمجة تطبيقات متخيلة، تدفق تحكم يبدو معقولاً لكنه معطل، تعليقات تملق، أنماط eval غير المقيدة لمدخلات المستخدم. TypeScript أصلي، يعمل دون اتصال، لا يتطلب ملف ثنائي.
• تحليل التلوث المضبوط للكود المدعوم بالذكاء الاصطناعي — request.* / req.* / sys.argv / os.environ يتم تتبعها إلى المصارف الخطرة (exec, innerHTML, cursor.execute, open)، مع المطهرات التي سيستخدمها بالفعل مشروع مبرمج بالذكاء الاصطناعي (DOMPurify, escapeHtml, secure_filename, os.path.basename).
• الفرز بمساعدة LLM — عندما يطلق كشاف إنذاراً، تقرر طبقة الدماغ ما إذا كانت النتيجة إيجابية حقيقية في قاعدة الكود هذه، وليس مجرد تطابق نمط كتابي. ثلاثة وكلاء، ثلاث وجهات نظر: (إيجابي / سلبي / غير حاسم)، (دخول → انتشار → مصرف → تعرض)، (إصلاح ملموس + مقتطف كود).

هيكل المستودع الأحادي

المتطلبات

• Node.js ≥ 20
• pnpm ≥ 10

بدء سريع

pnpm install              # تثبيت التبعيات وربط مساحات العمل
pnpm scanners:install     # تنزيل ملفات الماسحات الضوئية مفتوحة المصدر
pnpm build                # بناء الحزم + تجميع الإضافة
node packages/cli/dist/index.js scan --path /path/to/your/project

دليل التثبيت والاستخدام الكامل: ONBOARDING.md.

التطوير

pnpm build       # tsc -b (مراجع المشروع) + حزمة الإضافة
pnpm test        # مجموعة Vitest الكاملة (وحدة + تكامل)
pnpm test:unit   # اختبارات الوحدة فقط (سريع)
pnpm lint        # ESLint (إعداد مسطح + typescript-eslint)
pnpm typecheck   # فحص الأنواع
pnpm format      # Prettier
pnpm verify      # بوابة الدورة: format:check + lint + build + test:unit

الخصوصية وتدفق البيانات

• لا يغادر كودك جهازك أبدًا للفحوصات الحتمية. تعمل الكشافة الخمسة محليًا كعمليات فرعية.
• بالنسبة لطبقة الدماغ (اختياري)، يذهب مقتطف كل نتيجة مباشرة إلى Anthropic — لا وكيل، لا وسيط، لا خلفية Synaptic. BYOK.
• ذاكرة التدقيق (colony.db) موجودة في دليل .sentinel/ في مستودعك (بجوار agents.yaml). أنت تقرر ما إذا كنت ستلتزم به. المستودعات من الإصدار 0.3.5 أو أقدم: لا يزال الملف القديم .synaptic-sentinel/colony.db يُقرأ (قراءة مزدوجة، بدون ترحيل تلقائي لتجنب فقدان البيانات).

التوثيق

• ONBOARDING.md — التثبيت، استخدام CLI والإضافة
• docs/colony-db.md — قاعدة بيانات الفيرومونات
• .synaptic/DESIGN_DOC.md — سجل التصميم والقرارات
• context/Synaptic_Sentinel_v0.4.md — وثيقة التصميم الرئيسية

الترخيص

جميع الحزم مرخصة بموجب رخصة Apache 2.0 — انظر LICENSE.

© 2026 GoLab SpA.