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

stepstone ایک CLI ٹول ہے جو پروجیکٹ روڈ میپ کو ریپوزٹری کے اندر ہی ایک کمٹ شدہ فائل کے طور پر محفوظ کرتا ہے۔ اہداف (Goals) ٹرمینل سے شامل کیے جاتے ہیں اور ریپو کی جڑ میں `.worklist/worklist.json` میں لکھے جاتے ہیں، جہاں انہیں انسانوں اور کوڈنگ ایجنٹس دونوں کے ذریعے ایک ہی کمانڈز کے ذریعے پڑھا اور تبدیل کیا جا سکتا ہے۔ یہ npm پر دستیاب ہے اور اسے `npx -y stepstone@latest` کے ذریعے انسٹالیشن کے بغیر چلایا جا سکتا ہے۔ ہر Project Goal کا ایک عنوان، ایک اختیاری تفصیل، ایک اسٹیٹس، اور ایک slug ID ہوتی ہے جو عنوان سے بنائی جاتی ہے اور بعد میں اسے تبدیل نہیں کیا جاتا، تاکہ کمٹ میسجز یا پل ریکویسٹ میں حوالہ جات بعد میں نام تبدیل ہونے کے باوجود برقرار رہیں۔ اسٹیٹس `open`، `active`، `done` اور `archived` ہوتے ہیں؛ زیادہ سے زیادہ ایک ہی گول ایکٹو ہو سکتا ہے، اور `set_active` پچھلے ہولڈر کو ڈی موٹ کر دیتا ہے۔ کسی گول کو مکمل کرنے، دوبارہ کھولنے، آرکائیو کرنے یا حذف کرنے کے لیے واضح تصدیق کی ضرورت ہوتی ہے، جو `--confirm` فلیگ یا کی اسٹروک کے ذریعے دی جاتی ہے۔ Dependency edges ریکارڈ کرتے ہیں کہ کون سے اہداف پہلے مکمل ہونے چاہئیں۔ بلاک شدہ حالت (Blocked state) ہر ریڈ پر ان ایجز سے اخذ کی جاتی ہے بجائے اس کے کہ اسے اسٹور کیا جائے۔ `ready` کمانڈ پورے پیرلل فرنٹیر کی رپورٹ کرتی ہے، `next` شروع کرنے والے پہلے گول کا نام بتاتی ہے، اور `waves` غیر مکمل اہداف کو ان کی ابتدائی ترین تہہ (layer) میں ترتیب دیتی ہے جہاں وہ انحصارات کی بنیاد پر شروع ہو سکتے ہیں۔ کوئی بھی کمانڈ ایجنٹس اور اسکرپٹس کے لیے نثر کے بجائے ایک ڈیٹرمینسٹک رزلٹ اینولپ کے لیے `--json` قبول کرتی ہے۔ README ایک سنگل ایپلی کیشن سروس، ایک کراس پروسیس لاک، اور ہر انٹرفیس کے پیچھے ایک ایٹمک فائل ریپلیسمنٹ کی وضاحت کرتا ہے، تاکہ ایک CLI کال، ایک اوپن ٹرمینل بورڈ اور ایک لائیو سیشن فائل کو خراب کیے بغیر ایک ریپوزٹری شیئر کر سکیں۔ اختیاری پری کنڈیشنز، فائل کی وسیع ریویژن اور گول کا `updatedAt` ایک پرانی ریڈ (stale read) کو خاموش اوور رائٹ کے بجائے رپورٹ شدہ تنازع (conflict) میں بدل دیتے ہیں۔ `project ui` انہی اہداف پر ایک فل اسکرین ٹرمینل بورڈ کھولتا ہے۔ ایجنٹ کے استعمال کے لیے، `skills` CLI کے ساتھ ایک اسٹینڈالون Agent Skill انسٹال کیا جا سکتا ہے جو ایجنٹ کو ورک فلو سکھاتا ہے اور ضرورت کے مطابق npm CLI کو کال کرتا ہے۔ ایک Pi extension سیشن ٹاسکس (سیشن کے ٹھوس ٹکڑوں کی ایک برانچ آگاہ کیو، جو روڈ میپ سے الگ رکھی جاتی ہے)، دونوں فہرستوں پر ایک `/tasks` ڈیش بورڈ، ایک وجٹ جو ایکٹو گول اور اگلے غیر مکمل ٹاسکس کا نام بتاتا ہے، اور ایک ماڈل کے لیے `worklist` ٹول شامل کرتا ہے۔ تیار شدہ چیک آؤٹس ایک نظر انداز کردہ روٹ `STEPSTONE_GOAL.md` میں ایک گول لے جاتے ہیں، تاکہ کام کو Stepstone کے ہارنس لانچ کیے بغیر اٹھایا جا سکے۔ پروجیکٹ بتاتا ہے کہ لوڈ شدہ کسی بھی CLI کوڈ میں Pi پیکیج امپورٹ نہیں ہے اور CI ٹار بال پیک کرتا ہے اور بغیر Pi کے انسٹال شدہ بِنز کو چلاتا ہے۔ دستاویزات CLI کے استعمال، گول ماڈل، انحصارات، ڈسپیچ اور ورک اسپیس کلیمینگ، اسٹوریج اسکیمہ اور مائیگریشنز، ٹرمینل بورڈ، Agent Skill اور Pi extension کا احاطہ کرتے ہیں۔ یہ پروجیکٹ ورژن 0.17.0 تک `pi-worklist` کے طور پر شائع ہوا تھا اور اب موجودہ نام کے تحت جاری ہے۔ یہ MIT لائسنس کے تحت ہے۔