इस प्रोजेक्ट के बारे में

stepstone एक CLI टूल है जो प्रोजेक्ट रोडमैप को रिपॉजिटरी के भीतर ही एक कमिट की गई फ़ाइल के रूप में स्टोर करता है। गोल्स (Goals) को टर्मिनल से जोड़ा जाता है और रेपो रूट में `.worklist/worklist.json` में लिखा जाता है, जहाँ उन्हें एक ही कमांड के माध्यम से लोगों और कोडिंग एजेंटों दोनों द्वारा पढ़ा और बदला जा सकता है। यह npm पर वितरित है और इसे `npx -y stepstone@latest` के माध्यम से बिना इंस्टॉलेशन के चलाया जा सकता है। प्रत्येक Project Goal में एक शीर्षक, एक वैकल्पिक विवरण, एक स्टेटस और एक slug ID होता है जो शीर्षक से बनाया जाता है और बाद में फ्रीज कर दिया जाता है, ताकि कमिट संदेशों या पुल रिक्वेस्ट में संदर्भ बाद के नाम परिवर्तनों के बावजूद बने रहें। स्टेटस `open`, `active`, `done` और `archived` होते हैं; अधिकतम एक ही गोल एक्टिव हो सकता है, और `set_active` पिछले होल्डर को डिमोट कर देता है। किसी गोल को पूरा करने, फिर से खोलने, आर्काइव करने या हटाने के लिए स्पष्ट पुष्टि की आवश्यकता होती है, जो या तो `--confirm` फ्लैग या कीस्ट्रोक के रूप में दी जाती है। डिपेंडेंसी एजेस (Dependency edges) रिकॉर्ड करते हैं कि कौन से गोल्स पहले पूरे होने चाहिए। ब्लॉक्ड स्टेट को स्टोर करने के बजाय हर रीड पर उन एजेस से प्राप्त किया जाता है। `ready` कमांड पूरे पैरेलल फ्रंटियर की रिपोर्ट करता है, `next` शुरू करने के लिए पहले गोल का नाम बताता है, और `waves` अधूरे गोल्स को उस शुरुआती लेयर में व्यवस्थित करता है जिसमें वे शुरू हो सकते हैं, जो फ़ाइल ऑर्डर के बजाय डिपेंडेंसी पर आधारित होता है। कोई भी कमांड एजेंटों और स्क्रिप्ट्स के लिए एक डिटरमिनिस्टिक रिज़ल्ट एनवेलप के लिए `--json` स्वीकार करता है। README हर इंटरफेस के पीछे एक सिंगल एप्लिकेशन सर्विस, एक क्रॉस-प्रोसेस लॉक और एक एटॉमिक फ़ाइल रिप्लेसमेंट का वर्णन करता है, ताकि एक CLI कॉल, एक ओपन टर्मिनल बोर्ड और एक लाइव सेशन फ़ाइल को दूषित किए बिना एक रिपॉजिटरी साझा कर सकें। वैकल्पिक प्रीकंडीशन्स, एक फ़ाइल-वाइड रिविज़न और एक गोल का `updatedAt`, एक पुराने रीड को साइलेंट ओवरराइट के बजाय रिपोर्ट किए गए कॉन्फ्लिक्ट में बदल देते हैं। `project ui` उन्हीं गोल्स पर एक फुल-स्क्रीन टर्मिनल बोर्ड खोलता है। एजेंट उपयोग के लिए, `skills` CLI के साथ एक स्टैंडअलोन Agent Skill इंस्टॉल किया जा सकता है जो एजेंट को वर्कफ़्लो सिखाता है और आवश्यकतानुसार npm CLI को इनवोक करता है। एक Pi एक्सटेंशन Session Tasks (कंक्रीट सेशन चंक्स की एक ब्रांच-अवेयर क्यू, जिसे रोडमैप से अलग रखा जाता है), दोनों सूचियों पर एक `/tasks` डैशबोर्ड, एक्टिव गोल और अगले अधूरे कार्यों का नाम बताने वाला एक विजेट, और एक मॉडल-फेसिंग `worklist` टूल जोड़ता है। तैयार चेकआउट्स एक इग्नोर किए गए रूट `STEPSTONE_GOAL.md` में एक गोल ले जाते हैं, ताकि Stepstone द्वारा हार्नेस लॉन्च किए बिना काम शुरू किया जा सके; प्रोजेक्ट बताता है कि कोई भी लोड किया गया CLI कोड Pi पैकेज को इम्पोर्ट नहीं करता है और CI टारबॉल को पैक करता है और बिना Pi के इंस्टॉल किए गए बिन्स को चलाता है। डॉक्यूमेंटेशन में CLI उपयोग, गोल मॉडल, डिपेंडेंसी, डिस्पैच और वर्कस्पेस क्लेमिंग, स्टोरेज स्कीमा और माइग्रेशन, टर्मिनल बोर्ड, Agent Skill और Pi एक्सटेंशन शामिल हैं। प्रोजेक्ट को 0.17.0 तक `pi-worklist` के रूप में प्रकाशित किया गया था और वर्तमान नाम के तहत जारी है। यह MIT लाइसेंस के तहत है।