quality.mdx

title	أوامر Quality
description	التحقق والسلامة: verify وscan وspec وtaste وuicheck وharden — إضافةً إلى بوّابتَي precommit وradar.

مجموعة Quality هي سطح التحقق والسلامة. راجع بوّابات التحقق لكيفية تركيبها.

forge verify

بوّابة تحقق مستقلة — اختبارات + رمز مُهلوَس + مصدرية.

forge verify
forge verify --deep       # multi-lens consensus

يُبلِّغ forge verify --deep عن status رباعي الحالات بدلًا من نجاح/إخفاق ثنائي:

الحالة	المعنى
PASS	اتفقت جميع العدسات و حالة اختبارات forge verify الأساسية هي أيضًا PASS.
FAIL	أبلغت عدسة واحدة على الأقل عن إخفاق حقيقي.
INCOMPLETE	لم تتمكن عدسة من الإنهاء (مهلة، أو تعطل، أو تبعية مفقودة) — تُعامَل كأنها غير مُثبَتة.
NOT_CONFIGURED	لا توجد عدسات موصولة بهذا المستودع — لم يُفحَص شيء فعليًا.

PASS وحدها تُعتبر تحققًا. يرفض --deep عمدًا ترقية الإجماع إلى PASS عندما تكون حالة اختبارات forge verify الأساسية أي شيء غير PASS، بحيث يستلزم اجتياز الفحص العميق اجتياز الفحص الأساسي دائمًا.

forge scan

بوّابة المهارات — فحص مهارة أو خادم MCP بحثًا عن الحقن / RCE / التسريب قبل التثبيت.

forge scan <path-to-SKILL.md-or-.mcp.json>

forge spec

المواصفة كعقد — init (OpenSpec)، وقفل، وفحص الانحراف.

forge spec init
forge spec lock
forge spec check

forge taste

تمكين أداة ذوق واحدة لواجهة المستخدم لهذا المستودع (بدون وسيط يعرض الخيارات).

forge taste                # list the profiles
forge taste <profile>      # brutalist · corporate · editorial · minimalist · playful

يكتب DESIGN.md ويُعدّل عتبات بوّابة uicheck design.

forge uicheck

فحوصات حتمية لواجهة المستخدم.

forge uicheck contrast <fg> <bg>     # WCAG contrast ratio
forge uicheck fingerprint <file...>  # deterministic design fingerprint
forge uicheck design <file...>       # slop-distance + conformance gate
forge uicheck visual <file-or-url>   # Playwright-rendered check (opt-in tier)

forge harden

توصيل ضوابط الأمان — gitleaks قبل الالتزام + إعدادات الصندوق الرملي.

forge harden

forge precommit

بوّابة على مستوى الالتزام — تُشغّل الحد الأدنى للتحقق عند وقت الالتزام، فيُلتقط العمل الجزئي أو غير المُتحقَّق منه قبل أن يستقر.

forge precommit

forge radar

حلقات حداثة التبعيات — تُجمِّع تبعيات المشروع بحسب مدى حداثتها، ليظهر ما هو بائت أو منحرف قبل أن يعضّ.

forge radar

راجع دليل إبقاء التبعيات محدَّثة لكيفية قراءة الحلقات.