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

## جائزہ jira-integration Claude Code کے لیے ایک پلگ ان ہے، جو ایک Jira ایشو کو برانچ بنانے → اپروچ ڈیزائن → نفاذ → ٹیسٹ → جائزہ → لوکل انضمام تک پروسیس کرتا ہے اور ہر مرحلے کے نتائج Jira کمنٹس، اٹیچمنٹس اور اسٹیٹس ٹرانزیشن کے ذریعے محفوظ کرتا ہے۔ متعدد ایشوز کو قطار میں ڈال کر ترتیب سے ختم کیا جاتا ہے، پھر کامیاب/الگ کیے گئے نتائج کو ایک استثنائی رپورٹ میں خلاصہ کیا جاتا ہے تاکہ انسان صرف الگ کیے گئے کیسز کا فیصلہ کر سکے۔ ## عمل کا ڈھانچہ یہ دو لوپس پر مشتمل ہے۔ - مرحلہ لوپ (`auto`): ایک ٹاسک start → approach → impl+test → review کی ترتیب سے چلتا ہے۔ ہر مرحلہ ایک الگ تھلگ sub-agent کے ذریعے عمل میں آتا ہے اور ہر مرحلے کے لیے مختلف ماڈل تفویض کیا جاتا ہے۔ ریویو گیٹ ڈیزائن-نفاذ مماثلت کی شرح اور Critical کی تعداد کو ساختی قدروں سے جانچتا ہے؛ ناکامی کی صورت میں ایک اصلاحی ایجنٹ lint، ٹائپ چیک اور متعلقہ ٹیسٹوں پر مشتمل سینسر لوپ (زیادہ سے زیادہ 5 بار) چلا کر کنورجنس حاصل کرتا ہے، پھر مکمل ٹیسٹ اور delta دوبارہ جائزہ ہر ایک بار انجام دیا جاتا ہے۔ بیرونی لوپ کی حد 2 بار ہے۔ - ٹاسک لوپ (`loop`): `init` سے ترتیب دی گئی قطار کو ترتیب سے ختم کرتا ہے اور ہر ٹاسک کے لیے auto → لوکل `--no-ff` انضمام → باقی ورک ٹری کا rebase انجام دیتا ہے۔ گیٹ میں ناکامی، مرحلے کی ناکامی، یا انضمام/ریبیز تصادم پر صرف اس ٹاسک کو الگ کر کے آگے بڑھتا ہے۔ صرف تصدیقی (401/403)، MCP کنکشن یا بیس کی خرابی جیسے بنیادی ڈھانچے کے سگنلز، یا مختلف ٹاسکس کی مسلسل ناکامی پر پوری کارروائی روک دی جاتی ہے۔ کنٹرول فلو پرامپٹ کی تشریح سے نہیں بلکہ Workflow اسکرپٹ (`scripts/auto.workflow.js`) کے ذریعے قطعی انداز میں چلتا ہے، جیسا کہ دستاویز میں بیان کیا گیا ہے۔ ## Jira انضمام ایک ایشو کلید برانچ (`feature/<KEY>`)، ورک ٹری اور سیاق و سباق کی فائل سے مماثل ہے۔ مرکزی ریپو کی `.jira-context.json` پوری قطار کا مجموعی ریکارڈ ہے، جبکہ ہر ورک ٹری کی `.jira-context.json` اس ٹاسک کی حالت ہے۔ ہر کمانڈ کے ساتھ اسٹیٹس ٹرانزیشن (کرنا ہے→جاری ہے→زیر جائزہ→مکمل)، کمنٹس، اٹیچمنٹس (approach/review دستاویزات، ٹیسٹ رپورٹس) شامل ہوتے ہیں۔ الگ تھلگ کیے جانے کا عمل Jira میں کوئی تبدیلی نہیں کرتا، صرف لوکل حالت میں درج ہوتا ہے۔ Jira کالز `scripts/jira-cli.py` (REST) کے ذریعے ہوتی ہیں جو صرف معیاری لائبریری استعمال کرتی ہے۔ اسناد ورک اسپیس کی `.jira-context.json` کے `jira` بلاک میں محفوظ ہوتی ہیں اور ماحولیاتی متغیرات اور میراثی MCP ترتیبات سے خودکار منتقل ہوتی ہیں۔ MCP سرور رجسٹریشن اختیاری ہے۔ ## اہم کمانڈز - ایشو تخلیق: `epic set/show/clear`, `discover`, `create` - قطار/آٹومیشن: `init`, `loop`, `auto` - انفرادی مراحل: `start`, `approach`, `impl`, `test`, `review`, `merge`, `pr`, `done` - استفسار/صفائی: `status`, `report`, `clean` - دیگر: `/jira setup`, `/jira dashboard` ## آپریشنل قواعد کام کے حجم کا اندازہ L1/L2/L3 کے طور پر لگایا جاتا ہے تاکہ پیداوار کی مقدار اور جائزے کی گہرائی کو ایڈجسٹ کیا جا سکے۔ اگر ڈیٹا ماڈل، ٹرانزیکشن کی حدود، بیرونی API معاہدے، ہم آہنگی یا سیکیورٹی کی حدود متاثر ہوں تو L1 کو بھی L2 میں ترقی دے دی جاتی ہے۔ `start` صرف approach اور test مراحل کے لیے چھوڑنے کا مشورہ دے سکتا ہے؛ impl، review اور merge کبھی نہیں چھوڑے جاتے۔ تمام مراحل `completedSteps` میں درج ہوتے ہیں تاکہ دوبارہ عمل میں مکمل شدہ مراحل کو چھوڑ دیا جائے۔ ## پیداوار اور ڈیش بورڈ `docs/` کے تحت requirements، approach، test، review دستاویزات اور review-log·run-log (jsonl) جمع ہوتے ہیں۔ run-log اور review-log خود ہارنیس کے مشاہداتی اعداد و شمار کے طور پر استعمال ہوتے ہیں، جیسے ریویو کا غلط مثبت تناسب، مرحلے کا دورانیہ، اصلاح کی تعدد اور الگ تھلگ ہونے کی وجوہات۔ ڈیش بورڈ `http://127.0.0.1:8765` پر ہر ورک ٹری کے کارڈز (جاری مرحلہ، ٹول کالز، Jira اسٹیٹس، blocks گراف) کو SSE کے ذریعے حقیقی وقت میں دکھاتا ہے، صرف localhost کے لیے ہے اور کوئی تصدیق نہیں ہے۔ ## لائسنس MIT۔