एक रिपॉजिटरी-बंधित हस्तांतरण बंडल को परिभाषित करता है जिसके मालिक, निर्णय, अनुमानों, साक्ष्य, और ताजगी जांच एक नए मानव या AI एजेंट को बिना छिपे संदर्भ को पुनर्निर्मित किए काम फिर से शुरू करने देते हैं।
पैकेज स्थिति: संदर्भ समीक्षा के लिए मानव समीक्षा के लिए तैयार। अनुबंध और परीक्षण परिदृश्य पूर्ण हैं, लेकिन यह दावा नहीं किया गया है कि किसी अपनाने वाली कार्यान्वयन ने उन्हें पारित किया है।
निर्णय
परियोजना संदर्भ को एक संस्करणित बिल्ड आर्टिफैक्ट के रूप में मानें जो एक रिपॉजिटरी संशोधन से जुड़ा हो। एक हस्तांतरण तभी स्वीकार किया जाता है जब उसका मैनिफेस्ट हल हो, उसके निर्णय मालिकों को नामित करें, और स्वचालित ताजगी जांच बदले हुए स्रोत पथ न पाएं।
दायरा
- हस्तांतरण मैनिफेस्ट, निर्णय लॉग, खुले प्रश्न, परिचालन प्रतिबंध, और स्रोत सूचक।
- निर्माण, समीक्षा, समाप्ति, प्रतिस्थापन, और अभिलेखीय अवस्थाएँ।
- रिपॉजिटरी संशोधन, लिंक वैधता, गुप्त पैटर्न, और बदले हुए स्वामित्व वाले पथों के लिए जांच।
इस ब्लॉक के बाहर
- स्रोत कोड और मुद्दा इतिहास के लिए ट्रांसक्रिप्ट डंप या प्रतिस्थापन।
- नामित कार्य को फिर से शुरू करने से संबंधित नहीं दीर्घकालिक उत्पाद दस्तावेज़।
अनुबंध
- हर हस्तांतरण का एक स्थिर ID, निर्माण समय, मालिक, रिपॉजिटरी संशोधन, दायरा, और समाप्ति या समीक्षा तिथि होती है।
- दावे रिपॉजिटरी पथों, निर्णयों, या मुद्दा URLs की ओर इशारा करते हैं; अनसुलझे अनुमान स्पष्ट रूप से लेबल किए जाते हैं।
- बंडल उन कमांडों को रिकॉर्ड करता है जो वास्तव में अलग से चलाए गए थे, केवल अनुशंसित कमांडों से अलग।
- एक नया स्वीकार किया गया हस्तांतरण पिछले संस्करण को प्रतिस्थापित करता है, लेकिन उसे चुपचाप अधिलेखित नहीं करता।
- टिकटों या दस्तावेज़ों से कॉपी किया गया अविश्वसनीय पाठ डेटा होता है, प्राप्त करने वाले एजेंट के लिए निर्देश कभी नहीं।
कार्यान्वयन मार्गदर्शन
- वर्तमान कमिट और स्वामित्व वाले पथों से CI में मैनिफेस्ट उत्पन्न करें; व्याख्यात्मक निर्णय मानव-संपादन योग्य रखें।
- एक स्वामित्व मानचित्र बनाए रखें ताकि प्रमाणीकरण, स्कीमा, तैनाती, या अन्य नामित क्षेत्रों में बदलाव ताजगी अनुरोध करें।
- अनुमत URI योजनाओं का उपयोग करें और पैकेजिंग से पहले क्रेडेंशियल जैसे मानों को छिपाएं।
- पुनः शुरू करने के समय, रिकॉर्ड किए गए संशोधन की तुलना वर्तमान ट्री से करें और बदले हुए संदर्भित पथों को प्रदर्शित करें।
विफलता प्रबंधन और सुरक्षा उपाय
- यदि रिपॉजिटरी संशोधन उपलब्ध नहीं है, तो वर्तमान संशोधन को प्रतिस्थापित करने के बजाय हस्तांतरण को अपूर्ण चिह्नित करें।
- यदि कोई स्रोत गायब हो जाता है, तो उसका विवरण रखें और संदर्भ को अनसुलझा चिह्नित करें।
- यदि कोई गुप्त स्कैन सक्रिय होता है, तो आर्टिफैक्ट को क्वारंटाइन करें और पुनर्वितरण से पहले किसी भी पुष्टि किए गए क्रेडेंशियल को घुमाएं।
सत्यापन और संचालन
- हस्तांतरण आयु, अनसुलझे संदर्भ, बदले हुए स्वामित्व वाले पथ, और पुनः शुरू समय स्पष्टीकरण गणना को ट्रैक करें।
- महत्वपूर्ण वास्तुकला या इंटरफ़ेस परिवर्तनों के बाद और निर्धारित अधिकतम आयु के बाद समीक्षा करें।
- रिकॉर्ड किए गए कमांड और खुले जोखिमों की सही व्याख्या सुनिश्चित करने के लिए पुनः शुरू किए गए कार्यों का नमूना लें।
इस पैकेज में निष्पादन-समान उदाहरण फिक्स्चर और स्वीकृति अनुबंध हैं। पैकेज संरचना और मेटाडेटा जांचने के लिए संग्रह रूट से python tools/validate.py चलाएं; फिर लक्षित रिपॉजिटरी में परिदृश्यों को लागू और निष्पादित करें।
अपनाने के अनुमान
example.yamlमें नाम और संख्यात्मक मान एक अपनाने की प्रोफ़ाइल हैं, सार्वभौमिक डिफ़ॉल्ट नहीं।- अपनाने वाली टीम को अभिनेताओं, डेटा वर्गों, त्रुटि शब्दावली, और स्वामित्व को अपनी प्रणाली से मैप करना होगा।
संदर्भ
- कोई बाहरी मानक स्रोत आवश्यक नहीं; यह पैकेज एक परियोजना निर्णय को परिभाषित करता है।