منصوبے کے بارے میں

## جائزہ GIF (Governed Intelligence Framework) AI ٹول کی درخواست کے لیے ایک گورننس رن ٹائم ہے۔ یہ ایجنٹ کے کام کے بعد ریکارڈ رکھنے کے بجائے، کسی بھی ٹول کے چلنے سے پہلے، MCP (Model Context Protocol) پرت پر پالیسی نافذ کرتا ہے۔ یہ پروجیکٹ مسئلے کو ریکارڈز کے بجائے trajectories کے طور پر بیان کرتا ہے: ایک ایجنٹ سیکنڈوں میں غیر متعلقہ ڈیٹا ذرائع پر ہزاروں انفرادی طور پر جائز استفسارات بھیج سکتا ہے، اور مجموعی طور پر حاصل ہونے والا نتیجہ خود ایک خلاف ورزی ہو سکتا ہے جسے ریکارڈ سطح کے گورننس معیارات نہیں پکڑتے۔ ## یہ کیا کرتا ہے جب کوئی AI ایجنٹ ٹول طلب کرتا ہے، GIF: 1. پرسونا چیک کرتا ہے — آیا گورننس شناخت فعال ہے، اپنی مدت کے اندر ہے، اور ٹول کال کرنے کی اجازت رکھتی ہے۔ 2. اسکوپ نافذ کرتا ہے — پرسونا کے اعلان کردہ اسکوپ سے باہر کی کالیں مسترد اور عام غلطیوں کے بجائے بنیادی گورننس واقعات کے طور پر ریکارڈ ہوتی ہیں۔ 3. کمبی نیشن پالیسیاں جانچتا ہے — اپنانے والے ٹول ہینڈلرز عمل سے پہلے GIF کے فراہم کردہ evaluator کو کال کرتے ہیں؛ اگر موجودہ سیشن میں چھوئے گئے ڈیٹا ذرائع کا مجموعہ اعلان کردہ حساسیت کی حد سے تجاوز کرے، تو وہ کال جو یہ کمبی نیشن مکمل کرتی ہے بلاک کر دی جاتی ہے۔ README کی مثال: مالی ریکارڈز، HR ریکارڈز، اور مواصلاتی میٹا ڈیٹا الگ الگ جائز ہو سکتے ہیں، لیکن الگ الگ کالوں میں ان کا جوڑ نہیں۔ 4. سب کچھ ریکارڈ کرتا ہے — اجازت یافتہ کالیں، مستردیاں، اور سیشنز، ڈیٹا بیس کی سطح پر INSERT-only اجازتوں کے ساتھ۔ ## کلیدی تصورات - **پرسونا**: ایک گورننس شناخت جس میں لازمی، غیر null اعلان کردہ مقصد، واضح ٹول اسکوپ، وقتی مدت کی حدود، اور delegation chain شامل ہے۔ AI عمل سے پہلے انسانی منتظمین کی طرف سے بنائی جاتی ہے۔ - **اسکوپ**: اجازت یافتہ اعمال کی ایک فہرست؛ اس سے باہر کے ٹولز کال نہیں کیے جا سکتے۔ - **اسکوپ خلاف ورزی**: ایک بنیادی گورننس ریکارڈ، جسے اس بات کا ثبوت قرار دیا گیا ہے کہ حد نے کام کیا۔ - **کمبی نیشن پالیسی**: ایک اعلان کردہ اصول کہ سیشن میں ایک ساتھ رسائی حاصل کردہ ڈیٹا ذرائع کا مخصوص مجموعہ ایک حد ہے۔ GIF اسکیما، ایک فعال پالیسی evaluator، اور fail-closed سیمنٹکس فراہم کرتا ہے۔ v0.1 evaluator first-match پالیسی ریزولوشن استعمال کرتا ہے؛ جامع جانچ v0.2 trajectory آئٹم کے طور پر درج ہے۔ - **آڈٹ ٹریل**: ڈیٹا بیس اجازت کی سطح پر INSERT-only — ایپلیکیشن رول آڈٹ ریکارڈز کو UPDATE یا DELETE نہیں کر سکتا۔ - **Delegation chain**: چائلڈ پرسوناز والدین اسکوپ کے سخت ذیلی مجموعے رکھتے ہیں، لہذا ذیلی ایجنٹ کے اعمال جڑ کی انتظامی اتھارٹی تک واپس ٹریس ہوتے ہیں۔ ## آرکیٹیکچر دو Docker کنٹینرز: PostgreSQL 16 اور ایک Node.js MCP سرور۔ کلائنٹس MCP سرور پر POST کرتے ہیں، جو پرسونا کی توثیق کرتا ہے، اسکوپ نافذ کرتا ہے، اور ٹول ڈسپیچ کرتا ہے؛ PostgreSQL میں personas، sessions، audit_events، اور scope_violations رکھے جاتے ہیں۔ کمبی نیشن پالیسی evaluator ایک primitive کے طور پر دستیاب ہے جسے اپنانے والے ٹول سرورز اپنے ڈسپیچ پوائنٹس پر کال کرتے ہیں۔ انفورسمنٹ انجن ایک importable پیکیج (`gif-enforcement`) کے طور پر فراہم ہوتا ہے، جو ایک versioned git dependency کے طور پر رجسٹرڈ ہے، تاکہ اپنانے والے GIF سورس میں تبدیلی کے بغیر ڈومین ٹولز شامل کر سکیں۔ ## آڈٹ کی سالمیت آڈٹ ریکارڈز ڈیٹا بیس کی سطح پر ہیش چینڈ ہوتے ہیں: ایک trigger ایک canonical byte form پر SHA-256 digest کمپیوٹ کرتا ہے اور اسے پچھلی قطار کے digest سے جوڑتا ہے، لہذا بعد میں تبدیلی یا حذف کرنا چین توڑ دیتا ہے۔ ایک verifier CLI partitions پر چلتا ہے، digests دوبارہ کمپیوٹ کرتا ہے، اور mismatches اور chain breaks رپورٹ کرتا ہے۔ canonical form اور تصدیقی طریقہ کار ایک الگ Tamper-Evident Audit Record Contract ریپوزٹری میں بیان کیا گیا ہے (canonical form `audit-record-contract/1`، اصل میں MCP کو SEP-3004 کے طور پر جمع کرایا گیا)، جس کے لیے GIF reference implementation ہے۔ ایک mirrored vector set ریپوزٹری میں موجود ہے؛ README بتاتا ہے کہ `npm run vectors` 26 vectors پاس ہونے کی توقع رکھتا ہے۔ ## فوری آغاز پیشگی شرائط Docker Engine 24+، Docker Compose v2، اور Git ہیں۔ دستاویزی فلو `v0.2.4` tag کلون کرتا ہے، `.env.example` کاپی کرتے ہوئے placeholder secret ہٹاتا ہے، ایک generated `IDENTITY_HMAC_SECRET` شامل کرتا ہے، حقیقی پاس ورڈز سیٹ کرتا ہے، اور `docker compose up -d --build` چلاتا ہے۔ ڈیٹا بیس خود بخود roles، schema، اور migrations initialize کرتا ہے۔ MCP سرور اسٹارٹ ہونے سے انکار کرتا ہے اگر HMAC secret placeholder رہے یا 32 bytes سے کم ہو۔ دونوں شائع شدہ پورٹس بطور ڈیفالٹ `127.0.0.1` پر bind ہوتے ہیں؛ `GIF_BIND_ADDR` اسے وسیع کرتا ہے، اور ایک production deployment runbook کا حوالہ دیا گیا ہے۔ MCP endpoint براؤزر `Origin` header کی توثیق کرتا ہے، غیر مجاز origins کے لیے 403 جواب دیتا ہے جب تک وہ `GIF_ALLOWED_ORIGINS` میں درج نہ ہوں؛ بغیر Origin header بھیجنے والے کلائنٹس متاثر نہیں ہوتے۔ صحت `GET /health` کے ذریعے چیک کی جاتی ہے۔ ## موجودہ حالت README `v0.2.4` pin کرنے کی سفارش کرتا ہے، جو MCP SDK 2.0 substrate پر چلتا ہے اور v0.2 گورننس سیشن سیمنٹکس رکھتا ہے: `session_start` کے ذریعے minted واضح `gif_session_id` handles، caller-driven close، اور wall-clock TTL۔ بنیادی انفورسمنٹ کو مکمل اور ایک حقیقی PostgreSQL 16 instance کے خلاف end-to-end validated قرار دیا گیا ہے، ہر commit پر CI کے ذریعے ایک integration suite اور conformance scenarios چلتے ہیں، اور پورے کوڈ میں TypeScript strict mode ہے۔ شامل صلاحیتوں میں persona lifecycle، Streamable HTTP transport کے ساتھ MCP enforcement layer، chain-verifier CLI کے ساتھ append-only hash-chained audit trail، scope violation detection، delegation chain enforcement، session management، tool registry اور registry-driven dispatch، enforcement packaging، combination policy primitive، اور HMAC identity token کے ذریعے provisioner identity binding شامل ہیں۔ ریٹائرڈ MCP SDK v1 substrate پر ایک legacy `v0.1.0` ریلیز اب تجویز نہیں کی جاتی: اس میں SQL-identifier hardening کی کمی ہے (advisory GHSA-47gp-w74f-grvr) اور کوئی backports نہیں ملتے۔ README بتاتا ہے کہ injection `v0.2.0-rc.1` تک اور اس سمیت tags کو متاثر کرتا ہے، `v0.2.0-rc.2` پہلا patched tag ہے، اور موجودہ اپنانے والوں کو migration دستاویز کی طرف اشارہ کرتا ہے۔ external timestamping anchors، encryption at rest، multi-tenant operational hardening، اور per-scope audit chains پر مشتمل ایک compliance hardening roadmap پروڈکٹ overview میں دستاویزی ہے۔ ## دستاویزات اور لائسنس ریپوزٹری میں ایک سادہ زبان کی گائیڈ، پروڈکٹ overview، codebase walkthrough، architecture diagrams، ایک secrets دستاویز، contributor اور adopter runbooks، اور runnable conformance vectors شامل ہیں۔ Apache License 2.0 کے تحت لائسنس یافتہ؛ copyright 2026 Notboatanchor Labs LLC۔