CLI जॉब और Cloud कमांड

परिचय

यह पृष्ठ जॉब परिवहन, नेटिव DDS Cloud सत्र और वर्कस्पेस ऑपरेशन, स्पष्ट पुरानी HTTP सेवा अडैप्टर तथा 25 ग्राहक मैनिफ़ेस्ट कार्रवाइयाँ बताता है। नेटिव Evolve ऑपरेशन के अनुरोध अनुबंध अलग हैं।

रूटिंग नियम, निकास कोड के दो सेट और रसीद एनवेलप के लिए पहले CLI कमांड इंटरफ़ेस पढ़ें। स्थानीय रूप से पार्स किए इंजन नेमस्पेस के लिए CLI इंजन कमांड देखें। वर्तमान रिलीज़ सीमाओं के लिए CLI कमांड संदर्भ और मैनिफ़ेस्ट पढ़ने का अर्थ समझने के लिए कार्रवाई और क्षमता अनुबंध देखें।

job नेमस्पेस

job में ऑफ़लाइन क्लाइंट पूर्व-जाँच और Job Service से जॉब परिवहन शामिल हैं। स्थानीय पार्सर इसे सँभालता है, इसलिए -h काम करता है और किसी संपर्क से पहले मान की सीमाएँ जाँची जाती हैं।

इसके आठ में से छह उपकमांड --runner <local|cloud|private> लेते हैं, जिसका डिफ़ॉल्ट cloud है। वह फ़्लैग किस Job Service से संवाद करना है चुनता है। यह rtl compile और संबंधित कमांड पर इंजन रनर फ़्लैग नहीं है। job readiness और job validate में कोई --runner नहीं होता और वे नेटवर्क से कभी संपर्क नहीं करते।

<JOB_ID> और --artifact-id हाइफ़न से शुरू हो सकते हैं, उनके लिए -- विभाजक आवश्यक नहीं है; पार्सर इन तर्कों में शुरू के हाइफ़न वाले मान स्वीकार करता है।

इन दो विकल्पों की सीमा job wait पर पार्सर लागू करता है, सेवा नहीं:

पाठ

$ alti job wait --poll-interval-ms 99 job-123
error: invalid value '99' for '--poll-interval-ms <POLL_INTERVAL_MS>': 99 is not in 100..=60000

इसका निकास 2 है।

job readiness

job readiness बिना क्रेडेंशियल या नेटवर्क उत्तर देता है। इस रिलीज़ में यह निश्चित, बिना पथ का प्रोजेक्शन है: हर घटक configured: false और ready: false बताता है, और blockers ऐरे पूरा है।

{
  "schema": "altifigence.engine-product-host-readiness.v1",
  "product_id": "altifigence-cli",
  "authority": { "configured": false, "ready": false },
  "admission": { "configured": false, "ready": false },
  "dispatcher": { "configured": false, "ready": false },
  "executor": { "configured": false, "ready": false },
  "artifact_readback": { "configured": false, "ready": false },
  "ready": false,
  "blockers": [
    "authority_unavailable",
    "admission_unavailable",
    "dispatcher_unavailable",
    "executor_unavailable",
    "artifact_readback_unavailable"
  ]
}

इसका निकास 0 है। यहाँ 0 का अर्थ तैयारी प्रश्न का उत्तर मिलना है, कुछ तैयार होना नहीं।

job validate

job validate ऑफ़लाइन पूर्व-जाँच है जिसका चरण-दर-चरण वर्णन CLI की पहली सफलता में है। यह EngineJobV1 दस्तावेज़ --job से पढ़ता है (या --job का मान - हो अथवा अनुपस्थित हो तो stdin से), सटीक Cloud CPU RTL क्लाइंट एनवेलप के अनुसार जाँचता है और एक स्थानीय स्रोत फ़ाइल का हैश बनाता है। यह क्रेडेंशियल हल नहीं करता, क्लाइंट नहीं बनाता और किसी से संपर्क नहीं करता।

इसकी रसीद स्कीमा altifigence.cli.engine-job-preflight.v1 है। सफलता पर status का मान client_preflight_valid, submitted का मान false, server_authority_verified का मान false, job_schema का मान altifigence.engine.job.v1, execution_placement का मान cloud है, operation ब्लॉक rtl-engine / analyze / rtl-analysis-request.v1 है और source ब्लॉक में workspace_uri, sha256, और size_bytes होते हैं।

जॉब दस्तावेज़ 8388608 बाइट की कठोर सीमा में पढ़ा जाता है। इससे ऊपर कमांड इस त्रुटि से विफल होता है: EngineJobV1 JSON exceeds the CLI limit.

Cloud सबमिशन में स्रोत की स्पष्ट अनुमति आवश्यक है

विकल्प --runner cloud के साथ job submit और analyze run दोनों में स्रोत अपलोड के तीनों विकल्प साथ चाहिए। इस रिलीज़ में इनके बिना Cloud CPU RTL जॉब सबमिट करने का कोई मार्ग नहीं है:

पाठ

$ alti job submit --job job.json
error: Cloud Engine Job source upload is disabled; pass --allow-source-upload explicitly.

इसका निकास 1 है। --allow-source-upload हो लेकिन --workspace-root न हो तो संदेश --workspace-root is required with --allow-source-upload. है, और यही --source के लिए भी लागू है।

--workspace-root पूर्ण होना चाहिए। --source पथ <workspace-root>/inputs के भीतर पोर्टेबल सापेक्ष पथ है।

Cloud आर्टिफ़ैक्ट डाउनलोड की अलग स्पष्ट अनुमति चाहिए

कमांड job result पर --runner cloud के साथ तीन आर्टिफ़ैक्ट विकल्प एक समूह हैं। कोई भी देने से कमांड डाउनलोड मोड में जाता है और फिर तीनों चाहिए:

• इसके बिना --allow-artifact-download: Cloud Engine Job artifact download is disabled; pass --allow-artifact-download explicitly.

• इसके बिना --artifact-id: --artifact-id is required with --allow-artifact-download.

• इसके बिना --output-dir: --output-dir is required with --allow-artifact-download.

--output-dir पूर्ण डायरेक्टरी होना चाहिए। --artifact-id अंतिम EngineResultV1 की आउटपुट सूची से आता है।

रनर के अनुसार अस्वीकृतियाँ

तीन विकल्प समूह एक रनर के लिए सीमित हैं और उसके बाहर अस्वीकार होते हैं। हर निर्णय प्रक्रिया शुरू होने या अनुरोध भेजे जाने से पहले होता है:

पुराना स्थानीय/निजी मार्ग बंद किए alti-engine-job अडैप्टर का नाम लेता है, जो 24 रनर की रिलीज़ सूची में नहीं है। स्वीकृत रनर सिंटैक्स और एंडपॉइंट वैरिएबल उपलब्ध स्थानीय/निजी Job Service स्थापित नहीं करते। अंतर्निहित Cloud मार्ग केवल वहीं उपयोग करें जहाँ सेवा और खाता सक्षम हों, या दस्तावेज़ का सीधा स्थानीय इंजन कमांड उपयोग करें।

मशीन द्वारा पढ़ी जा सकने वाली जॉब त्रुटियाँ

job उपकमांड और analyze run को --json के साथ चलाने पर विफलता में साधारण संदेश के बजाय संरचित त्रुटि एनवेलप मिलता है:

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

पूरा कोड सेट है:

retryable का मान false इस रिलीज़ में हर एक पर है। यह एनवेलप job नेमस्पेस और analyze run के लिए मिलता है। अन्य कमांड परिवार अपने त्रुटि/रसीद अनुबंध उपयोग करते हैं; कमांड संदर्भ देखें।

analyze run और evolve run

analyze run और स्पष्ट नेटिव Evolve उपकमांड स्थानीय पार्सर तक पहुँचते हैं। एक शब्द की ग्राहक कार्रवाइयाँ analyze और evolve अलग अनुबंध हैं।

analyze run वही विकल्प सेट लेता है जो job submit लेता है और वही Cloud स्रोत अपलोड नियम मानता है। एक अंतर है: यह --runner स्वीकार करता है पर cloud के अलावा सब अस्वीकार करता है।

पाठ

$ alti analyze run --runner local --job job.json
error: Local and Private job service adapters are not available; use --runner cloud.

इसका निकास 1 है।

evolve run में --runner नहीं, --project नहीं और passthrough नहीं है। यह एक अनुरोध दस्तावेज़ पढ़ता है — --request - stdin पढ़ता है — और पैकेज किए alti-evolve इंजन को डिस्पैच करता है, जिसकी निकास स्थिति आगे दी जाती है:

पाठ

$ echo '' | alti evolve run --request -
alti-evolve: invalid request JSON: EOF while parsing a value at line 1 column 0

यह 2 इंजन alti-evolve की अपनी निकास स्थिति है जो आगे दी गई है, CLI तर्क त्रुटि नहीं। इंजन हल न हो सकने वाले इंस्टॉलेशन में वही कमांड 127 से बाहर निकलता है और रसीद का status मान unavailable होता है।

evolve capabilities, evolve analyze, evolve cx-search, evolve measured-ppa, और evolve artifact भी रूट किए जाते हैं। उदाहरण के लिए evolve analyze SAVED_RTL --top TOP [--project ABS] सहेजे स्रोत का विश्लेषण करता है। मापे-PPA की प्रवेश/तैयारी/पूर्व-जाँच मापा PPA नहीं बनाती।

सार्वजनिक GPU गतिविधि ऑपरेशन compute rtl-evolve --request FILE_OR_DASH है। उसका अलग नेटिव जनरेशन एनवेलप और स्पष्ट CPU संदर्भ/CUDA नीति है। इंजन कमांड देखें; इसे evolve run अनुरोध फ़ॉरवर्ड न करें।

Digital Design Studio Cloud

पहले ide cloud login और फिर ide cloud whoami से नेटिव सत्र पहचान सत्यापित करें। refresh और logout उस सत्र को प्रबंधित करते हैं; --session-dir डिफ़ॉल्ट के स्थान पर निजी विकल्प चुनता है। CLI प्रमाणीकरण देखें।

ide cloud contract --request FILE_OR_DASH टाइप किए प्रोजेक्ट/सदस्य/स्रोत/वर्कस्पेस अनुरोध ऑफ़लाइन सत्यापित करता है। ide cloud run --request FILE_OR_DASH सहेजे सत्र से नेटिव API पर वह अनुरोध भेजता है। स्रोत वाले अनुरोध में --allow-source-upload चाहिए। अनुबंध सत्यापन संगठन पहुँच कभी नहीं देता और सेवा की वर्तमान अनुमतियों का स्थान नहीं लेता।

alti ide cloud search --org "$ORG_ID" --project "$PROJECT_ID" \
  --query 'module' --limit 80
alti ide cloud terminal --org "$ORG_ID" --project "$PROJECT_ID" \
  --name cli --max-seconds 60

वास्तविक अधिकृत संगठन/प्रोजेक्ट UUID उपयोग करें। खोज --match-case, --whole-word, सीमित निश्चित चौड़ाई का --regex, --limit 1..500, और --timeout-seconds 1..120 लेती है। यह मौजूदा सीमित फ़ाइल/पढ़ने के रूट और सहेजी सामग्री उपयोग करती है, बजट 500 फ़ाइल, 4 MiB/फ़ाइल, 16 MiB कुल और 1 MiB आउटपुट है। मैनिफ़ेस्ट/हेडर/जनरेशन बदलाव मिले-जुले स्नैपशॉट को अमान्य करते हैं। लौटाया contentHash पढ़े गए सटीक UTF-8 पाठ का हैश है और वर्तमान Cloud स्वामी के लिए fileVersion के बराबर होना चाहिए। fileVersion और workspaceRevision अलग CAS फ़ील्ड के रूप में रखें।

टर्मिनल अटैचमेंट WebSocket परिवहन और वर्तमान प्राधिकरण सुरक्षित रखता है। यह stdout बाइट स्ट्रीम करता है; वैश्विक --json के साथ भी स्थिति stderr में जाती है। फिर शुरू करने के लिए --cursor उपयोग करें और अटैचमेंट सीमित करने के लिए --cols 2..500, --rows 1..200, और --max-seconds 1..300 उपयोग करें। अलग होना स्थायी PTY को मारने का अनुरोध नहीं है। यह Cloud प्रोजेक्ट निष्पादन है, स्थानीय CLI शेल नहीं।

पुरानी DDS वर्कस्पेस सेवा

ide service स्पष्ट रूप से कॉन्फ़िगर पुराने HTTP वर्कस्पेस स्वामी को लक्ष्य करता है। कॉलर के निजी एनवायरनमेंट में --endpoint या ALTI_STUDIO_ENDPOINT और उसका मौजूदा ALTI_STUDIO_SERVICE_SECRET सेट करें। इसके स्थान पर नेटिव Cloud सत्र, ब्राउज़र कुकी या मनमाने URL/बॉडी की फ़ॉरवर्डिंग नहीं होती। यह पुराने सेवा अडैप्टर का वर्णन है, वर्तमान नेटिव डेस्कटॉप UI द्वारा इन एंडपॉइंट के उपयोग या सार्वजनिक उत्पादन सेवा सक्षम होने का दावा नहीं।

खोज --match-case, --whole-word, सीमित निश्चित चौड़ाई का --regex, और --limit 1..1000 (डिफ़ॉल्ट 80) स्वीकार करती है। Regex प्रवेश जानबूझकर स्वामी के JavaScript सिंटैक्स का उपसमुच्चय स्वीकार करता है; समूह, alternation और quantifier अस्वीकार होते हैं। बैकएंड मिलान सेवा की ज़िम्मेदारी है।

प्रतिस्थापन बंद JSON ऑब्जेक्ट लेता है जिसमें query, replacement, paths: [one portable path], और expectedHashes: {same path: 64 hex digits} आवश्यक हैं। वैकल्पिक options में केवल बूलियन matchCase, regex, और wholeWord होते हैं। वैकल्पिक match में वही path और एक-आधारित पूर्णांक line/column 1 और 4194305 के बीच होते हैं। match छोड़ें तो केवल चुनी फ़ाइल में प्रतिस्थापन होता है, पूरे वर्कस्पेस में नहीं। हैश इसी सेवा के वर्तमान परिणाम से प्राप्त करें।

JSON एनकोडिंग और प्रतिस्थापन पाठ सहित अनुरोध अधिकतम 64 KiB हैं। अज्ञात फ़ील्ड, बेमेल हैश कुंजी/पथ, अमान्य इंडेक्स, ट्रैवर्सल, सर्वर सीमा से बाहर लिंक और संरक्षित मेटाडेटा/खोज से बाहर पथ समर्थित नहीं हैं। CLI HTTP से पहले अमान्य संरचना और संरक्षित पथ अस्वीकार करता है; फ़ाइलसिस्टम स्वामित्व और लिंक जाँच सेवा की ज़िम्मेदारी रहती हैं। यह कभी स्थानीय वर्कस्पेस प्रतिस्थापन नहीं करता।

जवाब की सीमा 8 MiB है। --timeout-seconds 1..3600 पूरी HTTP समय सीमा (डिफ़ॉल्ट 30) सेट करता है; रीडायरेक्ट और स्वचालित पुनः प्रयास अक्षम हैं। altifigence.dds.service-receipt.v1 HTTP स्थिति और बॉडी रखता है, जिसमें खाली सफल DELETE जवाब भी है। 409 टकराव ही रहता है। बैकएंड CAS और परमाण्विकता अलग बैकएंडों की गारंटी नहीं हैं और सेवा के अनुबंध के बिना अपेक्षित हैश के स्थान पर स्थानीय/Cloud सामग्री हैश नहीं रखना चाहिए।

कार्रवाई मैनिफ़ेस्ट

स्थानीय पार्सर से न सँभाली गई हर चीज़ मैनिफ़ेस्ट डिस्पैचर में जाती है, जो कमांड पथ को अंतर्निहित customer-tools.v1.json से मिलाता है। alti commands पूरे मैनिफ़ेस्ट को पच्चीस प्रविष्टियों के एक JSON ऐरे के रूप में छापता है और 0 से बिना क्रेडेंशियल बाहर निकलता है।

बाईस प्रविष्टियाँ executes: true चिह्नित हैं। तीन — analyze, evolve, और verify — executes: false हैं और डिस्पैच से पहले [plan-only] नोट छापती हैं। यही तीन स्रोत बाइट ले जाने वाली एकमात्र प्रविष्टियाँ हैं और उन पर --allow-source-upload की शर्त है।

पच्चीस में से चौदह में remote_core प्रोफ़ाइल भी है; बाकी केवल local_extended हैं। उपलब्धता के लिए उस प्रोफ़ाइल का अर्थ कार्रवाई और क्षमता अनुबंध में है।

नीचे हर कार्रवाई क्लाइंट बनाने से पहले प्रक्रिया एनवायरनमेंट से ALTI_TOKEN और ALTI_ORG_ID पढ़ती है और इनमें कोई गायब हो तो निकास 1 से विफल होती है:

पाठ

$ alti credits
Config error: ALTI_TOKEN is not set (org API key or access token).

सूची कार्रवाइयों के साझा विकल्प

कई कार्रवाइयाँ पेजिंग संरचना साझा करती हैं: --limit <INTEGER> की सीमा 1..=100, और --cursor <STRING>। किसी अनुरोध से पहले दोनों स्थानीय रूप से सत्यापित होते हैं:

पाठ

$ alti project ls --limit 101
Invalid value for --limit: outside allowed range.

इसका निकास 2 है, और अज्ञात फ़्लैग (Unknown option(s): --limti), गायब आवश्यक विकल्प (Missing required option(s): --projectId) तथा enum से बाहर मान (Invalid value for --visibility: expected one of public, private.) का भी।

वर्कस्पेस और प्रोजेक्ट

संवादात्मक RTL

chat models का मिलान chat से पहले होता है, क्योंकि डिस्पैचर सबसे लंबे मेल खाते कमांड पथ को प्राथमिकता देता है। alti chat पर सर्वर में क्रेडिट की शर्त है और उसका ऑडिट लॉग बनता है।

अनुमान और केवल योजना कार्रवाइयाँ

--rtl और --testbench इनलाइन स्रोत स्ट्रिंग हैं, प्रत्येक की कठोर सीमा 1048576 बाइट है और स्थानीय जाँच होती है:

पाठ

$ alti analyze --target kv260-fpga --rtl "$(cat huge.sv)" --allow-source-upload
Invalid value for --rtl: exceeds size limit.

इसका निकास 2 है। --allow-source-upload के बिना ये तीनों क्लाइंट बनने से पहले 4 से बाहर निकलते हैं:

पाठ

Source upload is disabled by default. Re-run with --allow-source-upload only
after reviewing the destination and input.

ये तीन executes: false हैं, इसलिए अनुमति होने पर भी stderr पर [plan-only] नोट छापते हैं और सर्वर रन के बजाय संरचित डिस्पैच योजना लौटाता है।

आर्टिफ़ैक्ट, प्रमाण, रनर और बिलिंग

MCP रजिस्ट्री

ये सर्वर की बताई MCP टूल रजिस्ट्री और हर संगठन की अनुमति सूची पढ़ते हैं। इनका alti mcp serve से संबंध नहीं है, जो किसी भी डिस्पैचर से पहले पकड़ लिया जाता है और स्थानीय stdio सर्वर शुरू करता है। MCP देखें।

एक मैनिफ़ेस्ट कार्रवाई तक पहुँचना संभव नहीं है

मैनिफ़ेस्ट ट्रेस सारांश के लिए एक शब्द की trace कार्रवाई परिभाषित करता है। इसे कॉल नहीं कर सकते, क्योंकि trace को स्थानीय पार्सर इंजन नेमस्पेस के रूप में ले लेता है। alti trace स्थानीय पार्सर तक जाता है, उपकमांड नहीं पाता और 2 से बाहर निकलता है; alti trace --limit 5 भी वहाँ जाता है और अज्ञात तर्क पर 2 से बाहर निकलता है।

कार्रवाई अब भी alti commands आउटपुट में मौजूद है, इसलिए वहाँ संख्या पच्चीस और पहुँच योग्य कमांड की संख्या चौबीस है। मैनिफ़ेस्ट को प्रोग्राम से सूचीबद्ध करें तो इसे फ़िल्टर करें।

Cloud वर्कफ़्लो चुनें

दूसरे वर्कफ़्लो की ID, हैश या रसीद तब तक पुनः उपयोग न करें जब तक अनुबंध स्पष्ट रूप से स्वीकार न करे। दोबारा जुड़ता टर्मिनल अब भी मौजूदा रिमोट सत्र है; खोया सबमिशन जवाब अब भी संभावित मौजूदा जॉब है। प्रतिलिपि बनाने से पहले स्थिति देखें।