CLI कमांड रेफ़रेंस

अवलोकन

पहले सत्यापन और इंस्टॉलेशन के बाद इंस्टॉल की गई बाइनरी उपयोग करें। यह रेफ़रेंस कमांड खोज, निष्पादन परिणाम, प्रीफ़्लाइट रसीद और सेवा प्रतिक्रिया को अलग समझाता है।

एक्शन मैनिफ़ेस्ट

सफल होने पर एक JSON एरे लिखता है। हर प्रविष्टि में name, description, inputSchema, executes और class हैं। एम्बेडेड ग्राहक मैनिफ़ेस्ट में 25 क्रियाएँ हैं, जिनमें से 22 में executes: true है। altifigence.analyze.run, altifigence.evolve.launch और altifigence.verify.run केवल योजना के लिए हैं। नेटिव CLI सबकमांड में इस ग्राहक मैनिफ़ेस्ट से आगे अपनी अंतिम-स्तर की मदद है। सेवा संचालन अधिकृत और तैयार है या नहीं, यह सर्वर प्रतिक्रिया तय करती है।

नेटिव आर्ग्युमेंट के लिए अंतिम स्तर की मदद देखें:

alti commands

alti xls upstream run --help
alti compute rtl-evolve --help
alti ide workspace hierarchy-plan --help
alti ide cloud search --help
alti ide service workspace replace --help

ऑफ़लाइन जॉब प्रीफ़्लाइट

सोर्स और एनवेलप CLI में पहली सफल प्रक्रिया में तैयार करें, फिर चलाएँ:

सफलता स्कीमा altifigence.cli.engine-job-preflight.v1 है। submitted: false और server_authority_verified: false आवश्यक हैं: सोर्स हैश और जॉब का आकार स्थानीय रूप से जाँचे गए, लेकिन कोई जॉब जमा या निष्पादित नहीं हुआ। एनवेलप में माँगा गया execution_placement इसे नहीं बदलता।

alti --json job validate \
  --job "$ALTI_WORKSPACE/job.json" \
  --workspace-root "$ALTI_WORKSPACE" \
  --source rtl/top.sv

JSON त्रुटि अनुबंध

विफल --json job validate stdout पर सफलता रसीद नहीं लिखता और stderr पर altifigence.cli.error.v1 ऑब्जेक्ट देता है:

उपलब्ध हो तो error.code उपयोग करें। अन्य कमांड परिवारों के अपने त्रुटि स्कीमा हैं; यह एनवेलप हर CLI कमांड पर लागू मानकर न चलें।

{
  "schema": "altifigence.cli.error.v1",
  "error": {
    "code": "ENGINE_JOB_JSON_INVALID",
    "message": "The engine job JSON is invalid.",
    "retryable": false
  }
}

एग्ज़िट स्थिति

stdout पार्स करने से पहले हमेशा एग्ज़िट स्थिति जाँचें और stderr अलग रखें। खाली या अधूरी आउटपुट फ़ाइल सफल परिणाम नहीं है। सेव की गई योजना लागू ट्रांज़ैक्शन नहीं है और सर्वर की स्वीकृति जॉब पूरा होना नहीं है।

इंजन कमांड: वास्तव में क्या चलता है

XLS, compute और नेटिव DDS एडाप्टर पैकेज में निश्चित साथ के प्रोग्राम उपयोग करते हैं। इंस्टॉल निष्पादन संबंधित रनर को उसके हस्ताक्षरित रिलीज़ रिकॉर्ड से प्रमाणित करता है; PATH में दूसरा प्रोग्राम जोड़ने से आवश्यक साथ के प्रोग्राम का अभाव ठीक नहीं होता। कुछ पुराने संगतता कमांड अपना दस्तावेज़ित रिज़ॉल्वर व्यवहार रखते हैं। देखें: कमांड का दायरा।

विकल्प --json के बिना इंजन stdout आगे भेजा जाता है ताकि नेटिव योजना सीधे सेव की जा सके। --json के साथ इंजन कॉल सामान्यतः altifigence.local-engine-execution.v1 देता है; उसके stdout और stderr फ़ील्ड में चाइल्ड की स्ट्रीम स्ट्रिंग के रूप में हैं। अंदर का परिणाम अलग पार्स करें।

फ़ाइल और पदानुक्रम योजनाओं के लिए पूरा नेटिव योजना परिणाम मेल खाने वाली apply कमांड को दें। बाहरी CLI एनवेलप या केवल योजना डाइजेस्ट न दें। नेटिव बैकएंड वर्तमान फ़ाइल हैश और अपनी ट्रांज़ैक्शन शर्तें जाँचता है।

सेवा और स्ट्रीमिंग आउटपुट

ide service से altifigence.dds.service-receipt.v1 मिलता है, जिसमें operation, ok, httpStatus और सीमित प्रतिक्रिया body है। प्रतिस्थापन से मिला HTTP 409 टकराव रहता है और फिर कोशिश नहीं होती। सफल DELETE की खाली प्रतिक्रिया खाली रहती है; उसे कृत्रिम सर्वर JSON ऑब्जेक्ट नहीं बनाया जाता।

नेटिव DDS खोज और Cloud खोज अपने मैच/सामग्री प्रमाण देते हैं। जिस बैकएंड पर लिखेंगे उसकी पहचान उपयोग करें; दूसरे खोज बैकएंड का हैश अपने आप मान्य CAS टोकन नहीं होता।

ide cloud terminal stdout पर टर्मिनल बाइट और stderr पर कनेक्शन स्थिति स्ट्रीम करता है। वैश्विक --json के साथ भी यह एकल JSON रसीद नहीं है। अटैचमेंट अवधि सीमित करें और फिर कनेक्ट करना हो तो कर्सर रखें।

--json release install और --json release uninstall से altifigence.cli.release-bootstrap.v1 मिलता है, जिसमें operation, ok और exitCode हैं। इंस्टॉलर डायग्नोस्टिक्स stderr में आते हैं। सफलता एनवेलप बनने से पहले सत्यापन या अधिकार विफलता हो सकती है।

ऑटोमेशन के लिए परिणाम कैप्चर करें

हर कॉल के लिए नई आउटपुट डायरेक्टरी चुनें। stdout और stderr अलग सेव करें, तुरंत एग्ज़िट स्थिति दर्ज करें और शून्य एग्ज़िट के बाद ही सफलता स्कीमा पार्स करें। इंजन एनवेलप में उसकी stdout स्ट्रिंग को नेटिव दस्तावेज़ तभी पार्स करें जब कमांड अनुबंध कहता हो कि उसमें JSON है।

plan/apply वर्कफ़्लो में पूरी रॉ नेटिव योजना रखें और वही प्रोजेक्ट उपयोग करें। apply से पहले प्रभावित फ़ाइलें और वर्तमान हैश देखें। टकराव में नया पठन और समीक्षा की योजना चाहिए; यह हैश जाँच हटाने का कारण नहीं है। दोहराई जा सकने वाली स्थानीय जाँच के लिए ऑटोमेशन और CI देखें।