مرکزی مواد پر جائیں۔

معلوم سرپرائزز

یہ فائل ریپوزٹری کے مخصوص کنفیوژن پوائنٹس کو ٹریک کرتی ہے جس کی وجہ سے ایجنٹ کی غلطی ہوتی ہے۔

داخلے کا معیار​

انٹری صرف اس صورت میں شامل کریں جب سب درست ہوں:

  • یہ اس ریپوزٹری کے لیے مخصوص ہے (عام مشورہ نہیں)۔
  • مستقبل کے ایجنٹوں کے لیے اس کے دوبارہ آنے کا امکان ہے۔
  • اس میں ایک ٹھوس تخفیف ہے جس پر عمل کیا جا سکتا ہے۔

اگر غیر یقینی ہے تو، اندراج شامل کرنے سے پہلے ڈویلپر سے پوچھیں۔

اندراج کا سانچہ​

### [Short title]

- **Date:** YYYY-MM-DD
- **Observed by:** agent name or contributor
- **Context:** where/when it happened
- **What was surprising:** concrete unexpected behavior
- **Impact:** what went wrong or could go wrong
- **Mitigation:** exact step future agents should take
- **Status:** confirmed | superseded

اندراجات​

پورٹ لیس کیننیکل لوکل ایپ URL کو تبدیل کرتا ہے​

  • تاریخ: 2026-03-18
  • مشاہدہ از: کوڈیکس
  • سیاق و سباق: براؤزر کی توثیق اور دھواں کا بہاؤ
  • **کیا تعجب کی بات نہیں تھی کہ URL ہمیں حیران کن نہیں تھا۔ ریپو پورٹ لیس کے ذریعے https://bitsocial.localhost کی توقع کرتا ہے، لہذا localhost:3000 یا localhost:5173 کو چیک کرنے سے غلط ایپ یا کچھ بھی نہیں ہو سکتا۔
  • اثر: براؤزر کی جانچ ناکام یا غلط ہدف کی توثیق کر سکتی ہے یہاں تک کہ جب ڈیو سرور صحت مند ہو۔
  • تخفیف: پہلے https://bitsocial.localhost استعمال کریں۔ صرف اس وقت PORTLESS=0 corepack yarn start کے ساتھ بائی پاس کریں جب آپ کو واضح طور پر براہ راست وائٹ پورٹ کی ضرورت ہو۔
  • Status: تصدیق شدہ

کمیٹیزن ہکس غیر متعامل کمٹ کو روکتا ہے​

  • تاریخ: 2026-03-18
  • مشاہدہ از: کوڈیکس
  • سیاق و سباق: ایجنٹ سے چلنے والے کمٹ فلو
  • حیرت کی بات کیا تھی: git commit ہسکی کے ذریعے کمٹائزن کو متحرک کرتا ہے اور انٹرایکٹو TTY ان پٹ کا انتظار کرتا ہے، جو کہ نان انٹرایکٹو ایجنٹ شیل کو ہینگ کرتا ہے۔
  • اثر: ایجنٹ اس دوران غیر معینہ مدت تک اسٹال لگا سکتے ہیں جو ایک عام کمٹ ہونا چاہیے۔
  • تخفیف: ایجنٹ کے ذریعے بنائے گئے وعدوں کے لیے git commit --no-verify -m "message" استعمال کریں۔ انسان اب بھی corepack yarn commit یا corepack yarn exec cz استعمال کر سکتے ہیں۔
  • Status: تصدیق شدہ

یارن کلاسک سے بچنے کے لیے کور پیک کی ضرورت ہے۔​

  • تاریخ: 2026-03-19
  • مشاہدہ از: کوڈیکس
  • سیاق و سباق: یارن 4 میں پیکیج مینیجر کی منتقلی
  • حیرت کی بات کیا تھی: مشین میں ابھی بھی PATH پر عالمی یارن کلاسک انسٹال ہے، لہذا سادہ yarn کو چلانے سے یارن 4 ورژن کی بجائے v1 کو حل کیا جا سکتا ہے۔
  • اثر: ڈویلپرز غلطی سے ریپو کے پیکیج مینیجر پننگ کو نظرانداز کرسکتے ہیں اور مختلف انسٹال رویہ یا لاک فائل آؤٹ پٹ حاصل کرسکتے ہیں۔
  • تخفیف: شیل کمانڈز کے لیے corepack yarn ... استعمال کریں، یا پہلے corepack enable چلائیں تاکہ سادہ yarn پن کیے ہوئے یارن 4 ورژن کو حل کرے۔
  • Status: تصدیق شدہ

فکسڈ پورٹ لیس ایپ کے نام بٹسوشل ویب ورک ٹریز میں ٹکرا جاتے ہیں۔​

  • تاریخ: 2026-03-30
  • مشاہدہ از: کوڈیکس
  • سیاق و سباق: ایک بٹسوشل ویب ورک ٹری میں yarn start شروع کرنا جبکہ دوسرا ورک ٹری پہلے ہی پورٹ لیس کے ذریعے کام کر رہا تھا۔
  • حیرت کی بات کیا تھی: ہر ورک ٹری میں لفظی پورٹ لیس ایپ کا نام bitsocial استعمال کرنے سے راستہ خود آپس میں ٹکرا جاتا ہے، یہاں تک کہ جب بیکنگ پورٹس مختلف ہوں، تو دوسرا عمل ناکام ہوجاتا ہے کیونکہ bitsocial.localhost پہلے سے ہی رجسٹرڈ ہے۔
  • اثر: متوازی بٹسوشل ویب برانچیں ایک دوسرے کو بلاک کرسکتی ہیں حالانکہ پورٹ لیس کا مقصد انہیں محفوظ طریقے سے ایک ساتھ رہنے دینا ہے۔
  • تخفیف: پورٹ لیس اسٹارٹ اپ کو scripts/start-dev.mjs کے پیچھے رکھیں، جو اب کینونیکل کیس سے باہر برانچ کے دائرہ کار والے *.bitsocial.localhost روٹ کا استعمال کرتا ہے اور جب ننگا bitsocial.localhost نام پہلے سے موجود ہوتا ہے تو برانچ کے دائرہ کار پر واپس آتا ہے۔
  • Status: تصدیق شدہ

دستاویزات کا پیش نظارہ ہارڈ کوڈ پورٹ 3001 میں استعمال ہوتا ہے۔​

  • تاریخ: 2026-03-30
  • مشاہدہ از: کوڈیکس
  • سیاق و سباق: دیگر مقامی ریپوز اور ایجنٹوں کے ساتھ yarn start چلانا
  • حیرت کی بات کیا تھی: روٹ ڈیو کمانڈ نے docusaurus start --port 3001 کے ساتھ دستاویزات کی ورک اسپیس چلائی، لہذا جب بھی کوئی دوسرا عمل پہلے سے ہی 3001 کی ملکیت میں ہو تو پورا ڈیو سیشن ناکام ہو گیا، حالانکہ مرکزی ایپ پہلے سے ہی پورٹ لیس استعمال کرتی ہے۔
  • اثر: yarn start ویب کے بوٹ ہونے کے فوراً بعد عمل کو ختم کر سکتا ہے، جس سے ڈاکس پورٹ کے تصادم پر غیر متعلقہ مقامی کام میں خلل پڑتا ہے۔
  • تخفیف: دستاویزات کے آغاز کو yarn start:docs کے پیچھے رکھیں، جو اب پورٹ لیس پلس scripts/start-docs.mjs کو انجیکشن فری پورٹ کا اعزاز دینے کے لیے استعمال کرتا ہے یا براہ راست چلانے پر اگلے دستیاب پورٹ پر واپس آتا ہے۔
  • Status: تصدیق شدہ