Skip to main content
StackKit Open Spec “खुले होमलैब स्टैंडर्ड” के पीछे का पतला, प्रकाशित अनुबंध है। यह उन आर्टिफ़ैक्ट की सूची बनाता है जो हर StackKits रिलीज़ के साथ शिप होते हैं; यह कोई नया स्कीमा नहीं लाता। स्पेक का वर्शन उस रिलीज़ टैग का अनुसरण करता है जिसके साथ वह शिप होता है, और v0 के भीतर बदलाव केवल जोड़ने वाले होते हैं। मानक प्रति सार्वजनिक रिपॉज़िटरी में docs/OPEN-SPEC.md पर है। स्पेक में सब कुछ बिना-अकाउंट है: Standard Mode को kombify अकाउंट, होस्टेड kombify एंडपॉइंट और Techstack की ज़रूरत नहीं।

​
1. आर्किटेक्चर स्नैपशॉट

केवल-तथ्यों वाला आर्किटेक्चर स्नैपशॉट किसी रिलीज़ का वर्णन करता है: किट, टोपोलॉजी, क्षमताएँ, प्लेसमेंट मॉडल, मॉड्यूल, ऐड-ऑन और सपोर्ट परिपक्वता। तकनीकी सत्य का स्रोत CUE है; स्नैपशॉट उसका प्रक्षेपण है। उपभोक्ता स्नैपशॉट पढ़ता है, CUE कभी नहीं, और उसे जोड़े गए फ़ील्ड सहन करने चाहिए।

​
2. लाइफ़साइकल क्रियाएँ

हर किट को stackkit CLI और stackkit-mcp कनेक्टर के ज़रिए एक ही क्रियाओं से चलाया जाता है। इनपुट और आउटपुट CLI संदर्भ और CLI वॉकथ्रू में दस्तावेज़ित हैं। कोई क्रिया या तो प्रमाण के साथ पूरी होती है या अंतिम कारण के साथ विफल होती है। वह उस काम की सफलता कभी रिपोर्ट नहीं करती जो उसने किया नहीं।

​
3. प्लेसमेंट वर्गीकरण

प्लेसमेंट बताता है कि कोई किट या मॉड्यूल कहाँ चल सकता है। शब्दावली foundation/placement.cue में प्रकाशित है:
  • #PlacementMode: local-only, standard, managed-serverless
  • #PlacementSupport: प्रति-मॉड्यूल पात्रता मेटाडेटा (मॉड्यूल किन मोड में चल सकता है)
ओपन-सोर्स लाइफ़साइकल local-only और standard को साकार करता है। managed-serverless केवल पात्रता मेटाडेटा है; उसका साकार रूप StackKits और इस स्पेक के बाहर है।

​
4. सत्यापन प्रमाण

परिपक्वता के शब्द प्रमाण-समर्थित होते हैं, घोषित नहीं। प्रमाण के रूप सार्वजनिक JSON Schema हैं; रिलीज़ इंस्टेंस शिप करता है। शब्दावली:
  • किट: supported (प्रतिबद्ध सेल के लिए उद्धृत सत्यापन पथ मौजूद है), preview (इंस्टॉल होती है, लेकिन सत्यापन या रिकवरी प्रमाण लंबित है), alpha (केवल परिभाषा)।
  • संगतता पंक्तियाँ (ऑपरेटिंग सिस्टम, हाइपरवाइज़र, एनवायरनमेंट के अनुसार किट, एप्लिकेशन): supported (प्रमाण रिलीज़ पर सबसे नए रन में हर लाइफ़साइकल चरण पास हुआ), preview (इंस्टॉल से verify तक पास हुआ; बाद का चरण विफल रहा) या unverified (उस रिलीज़ पर अभी कोई पूरा रन नहीं, या सबसे नया रन verify से पहले विफल रहा)। प्रमाण की अनुपस्थिति unverified के रूप में प्रकाशित होती है, सपोर्ट के रूप में कभी नहीं।
  • स्थिति तभी चौड़ी होती है जब सटीक रिलीज़ के लिए उद्धृत रन मौजूद हो।

​
5. अनुरूपता

कोई टूल या सेवा StackKit-संगत तब है जब वह
  1. उस सटीक रिलीज़ का आर्किटेक्चर स्नैपशॉट इस्तेमाल करे जिसे वह लक्षित करता है,
  2. किट को केवल ऊपर दी लाइफ़साइकल क्रियाओं से चलाए (सीधे या MCP कनेक्टर के ज़रिए) और उनके प्रमाण सुरक्षित रखे,
  3. प्लेसमेंट को प्रकाशित वर्गीकरण से बताए, और
  4. सत्यापन नतीजे ऊपर के प्रमाण रूपों में, उस रिलीज़ टैग के साथ प्रकाशित करे जिससे वे संबंधित हैं।

​
स्थिति

यह सार्वजनिक बीटा के साथ प्रकाशित v0 ड्राफ़्ट है। वर्शनिंग नीति के साथ एक अलग स्पेसिफ़िकेशन रिपॉज़िटरी बीटा के बाद आएगी; तब तक रिपॉज़िटरी दस्तावेज़ और लिंक किए आर्टिफ़ैक्ट ही स्पेक हैं।