AGENTS.md git:20261018.4c289eeF

Immutable. This exact content never changes and is served at /api/v1/blob/71b90a7f89227d54.

# 🛡️ Antigravity Shield — Workspace Rules & Behavioral Invariants

### 🎨 قاعده یکپارچگی تم‌های پویا و ایزولاسیون هویت برند (Dynamic Accent Theme Integrity & Brand Shield Invariant)

۱. **ممنوعیت مطلق کلاس‌های رنگی هاردکد در عناصر تعاملی (Zero Hardcoded Accent Classes):**
   در کلیه کامپوننت‌ها، کارت‌ها، تب‌ها، فیلترها، دکمه‌های اکشن (مانند Install)، رینگ‌های فوکوس و بج‌های وضعیتی، استفاده مستقیم از کلاس‌های رنگی ثابت (مانند `sky-500`، `blue-600`، `cyan-500`) برای مؤلفه‌های استیت‌دار اکیداً ممنوع است. تمام این عناصر باید مستقیماً از متغیرهای داینامیک CSS استخراج شوند:
   - پس‌زمینه و هاور دکمه‌ها: `var(--color-primary-btn)` و `var(--color-primary-btn-hover)`
   - خطوط مرزی، آیکون‌های هایلایت و متون شاخص: `var(--color-accent)`
   - پس‌زمینه و بردر بج‌ها: `var(--color-badge-bg)` و `var(--color-badge-border)`
   - هاله‌ها و سایه‌ها: `var(--color-accent-glow)`

۲. **ایزولاسیون نفوذناپذیر لوگو و هویت برند (Brand Identity Immunity):**
   لوگوها، نشان‌های شیلد و نمادهای هویت سازمانی هسته سیستم (مانند `NavLogo.tsx` و برچسب‌های PRO/SHIELD رسمی) از سامانه تغییر رنگ UI کاملاً ایزوله هستند و تحت هیچ شرایطی نباید با متغیرهای تم دستخوش تغییر شوند.

۳. **گیت اعتبارسنجی فیزیکی چندرنگه پیش از استقرار (Multi-Accent Physical Inspection Gate):**
   پیش از اعلام نهایی شدن پیاده‌سازی یا رفع باگ تم، دستیار موظف است تمام زیرماژول‌ها و تب‌های درونی (Ecosystem, McpTab, RulesTab, Modals) را حداقل در دو تم متضاد (مثلاً Seafoam در برابر Crimson Rose) به‌صورت فیزیکی ممیزی کند تا از عدم وجود خطای فانتوم و عدم نشت رنگ استاتیک اطمینان حاصل شود.

### 🔒 قاعده حفاظت از اسرار تجاری و ممنوعیت افشای لوله‌کشی داخلی (Proprietary IP Shield & Anti-Reverse Engineering Invariant)

۱. **ممنوعیت مطلق افشای دیاگرام‌ها و نام‌های لوله‌کشی داخلی (Zero Internal Plumbing Exposure):**
   در اسناد عمومی، مارکتینگ، `README.md`، `CHANGELOG` و توضیحات پروپوزال، افشای موارد زیر به رقبا و عموم اکیداً و مطلقاً ممنوع است:
   - نام دیتابیس‌های خصوصی و محلی (مانند `token_stats.db`، `security.db`، `proxy.db`).
   - پورت‌های لوپ‌بک و ارتباطات بریج داخلی (مانند پورت `8765` یا IPC داخلی).
   - مسیرهای محرمانه واچر و رصدگرها (مانند `~/.gemini/antigravity/brain/`).
   - اسامی توابع و مکانیزم‌های ضدسندباکس (`Virtual DeviceProfile` و ترفندهای مهندسی معکوس بالادست).

۲. **الزام استفاده انحصاری از دیاگرام‌های انتزاعی بلک‌باکس (Abstract Black-Box Architecture Only):**
   هرگونه دیاگرام معماری در مستندات بیرونی باید صرفاً در بالاترین سطح انتزاعی (کلاینت‌ها ➔ گیت‌وی شیلد ➔ سرویس‌های بالادست AI) ترسیم شود و تنها ارزش تجاری، کارکرد کلی و مزیت رقابتی را بیان کند؛ نه نقشه لوله‌کشی و راهنمای کپی‌برداری برای رقبا.

### 🌐 قاعده استعلام لایو مدل‌های هوش مصنوعی (AI Model Discovery & Reality Grounding)

۱. **ممنوعیت مطلق اتکا به حافظه پارامتریک در ادعای عدم وجود مدل:**
   هوش مصنوعی هرگز حق ندارد بر اساس اطلاعات از پیش‌آموخته خود ادعا کند مدلی وجود ندارد یا منتشر نشده است.
۲. **پروتکل سه‌مرحله‌ای اعتبارسنجی مدل:**
   - بازرسی کاتالوگ لوکال پروژه (`latest_models_catalog.json`).
   - اجرای وب‌سرچ زنده برای بررسی آخرین تغییرات نام‌گذاری گوگل، آنتروپیک و اوپن‌ای‌آی.
   - در صورت مشاهده خطای ۴۲۹، علت باید «عدم دسترسی یا اتمام سهمیه اکانت‌های موجود برای این مدل» گزارش شود، نه نفی وجود خود مدل.

### 🔕 قاعده محافظت در برابر طوفان نوتیفیکیشن (Alert Storm Suppression Invariant)

۱. **قانون پیام واحد (Single Consolidated Alert):**
   هیچ رویدادی (اعم از انقضای سهمیه، خطای اتصال یا قطعی) نباید بیش از ۱ نوتیفیکیشن دسکتاپ و ۱ توست در بازه ۱۵ دقیقه‌ای تولید کند و هشدارهای مربوط به تارگت‌های مختلف (IDE و Platform) باید به صورت تجمیعی ارسال شوند.
۲. **ایزولاسیون پروب‌های تشخیصی (Canary Probe Isolation):**
   ابزارهای تست سلامت و پروب‌های دستی باید در حالت ایزوله اجرا شوند و شکست آن‌ها هرگز نباید آلارم سراسری، نوتیفیکیشن‌های اسپم یا چرخش تهاجمی در کل رابط کاربری نرم‌افزار ایجاد کند.