कमांड-लाइन इंटरफ़ेस — प्रकाशित Scarp v0.0.5-alpha.4

यह v0.0.5-alpha.4 का alpha.4 का ऐतिहासिक CLI संदर्भ है। यह 3 नवंबर 2026 को source commit 79141329176f5dce51457e90a6652902f6432135 से जारी हुआ। ये commands वास्तविक प्रकाशित interpreter में उपलब्ध हैं, केवल प्रस्तावित सुविधाएँ नहीं। भाषा और project manifest अभी प्रयोगात्मक हैं। सही native package और SHA-256 जाँच के लिए इंस्टॉलेशन देखें।

यह alpha.4 का पृष्ठ है। ऐतिहासिक alpha.3 file CLI और alpha.1 CLI को अलग रखा गया है, ताकि पुराने versions में मौजूद commands की जानकारी सही रहे।

प्रकाशित commands की सूची

इस प्रकाशित tag में उपलब्ध नहीं: scarp inspect modules --json DIRECTORY (केवल development source), scarp build, scarp compile, package manager, arbitrary program arguments, native .srp executables और project की स्वतः खोज। पुराने run, check, tokens, modules migration के लिए अभी मौजूद हैं, लेकिन check runtime paths चला सकता है और verify का विकल्प नहीं है।

पहला project बनाएँ और चलाएँ

एक writable parent folder में चलाएँ जहाँ hello-world नाम का folder पहले से न हो। Extracted archive से चलाते समय Windows PowerShell में .\scarp.exe या Linux/macOS में ./scarp इस्तेमाल करें, ताकि PATH के पुराने executable से भ्रम न हो।

scarp version
scarp guide
scarp diagnose --json
scarp create hello-world
scarp verify hello-world
scarp launch hello-world
scarp verify hello-world/src/main.srp
scarp exec hello-world/src/main.srp

create से hello-world/Scarp.project और hello-world/src/main.srp बनते हैं। यह किसी भी मौजूदा folder, खाली folder को भी, overwrite नहीं करता। वास्तविक generated manifest:

scarp-project: 1
name: hello-world
entry: src/main.srp

वास्तविक generated source:

print("Hello from Scarp!");

launch hello-world और exec hello-world/src/main.srp दोनों का stdout:

Hello from Scarp!

Source, manifest तथा output प्रकाशित alpha.4 conformance suite से सत्यापित हैं। पहला project quickstart भी देखें।

File और project commands में अंतर

verify FILE.srp सामान्य runtime statements चलाए बिना syntax, imports, नाम और types जाँचता है। verify DIRECTORY पहले उस directory की स्पष्ट Scarp.project file और entrypoint जाँचता है, फिर वही static checks करता है। सफल verify चुप रहता है और artifacts नहीं बनाता, पर इससे launch की runtime सफलता की गारंटी नहीं मिलती। exec FILE.srp अलग source file चलाता है; launch DIRECTORY manifest में लिखे entrypoint को उसी interpreter से चलाता है।

Manifest UTF-8 में होनी चाहिए और अधिकतम 4096 bytes की हो सकती है। केवल तीन ordered v1 fields स्वीकार हैं: scarp-project: 1, name:, entry:। Entry project के भीतर relative .srp path हो। बाहर जाने वाले paths, unsafe symlinks, गलत या duplicate fields अस्वीकार होते हैं। CLI parent folders में project manifest नहीं खोजता। source path safety और alpha.3→alpha.4 migration देखें।

Runtime budgets, JSON और exit codes

launch और exec में path से पहले flags दिए जा सकते हैं: --max-steps, --max-prints, --max-call-depth, --max-calls, --max-live-slots, --max-capture-bytes, --max-vector-bytes, --max-text-bytes। Static verify ऐसे runtime flags को exit status 2 के साथ अस्वीकार करता है। Spaces वाले path quotes में लिखें, dash से शुरू होने वाले path के पहले -- लगाएँ।

scarp launch --max-steps 500000 hello-world
scarp verify --diagnostic-format=json hello-world
scarp launch --diagnostic-format=json hello-world
scarp inspect modules --json hello-world/src/main.srp

diagnose --json में "project_workflow":true और "native_executable":false मिलता है। सफल inspect modules --json FILE से schema-v1 inventory मिलता है। verify या launch के साथ --diagnostic-format=json केवल stderr के errors का format बदलता है। सफल launch सामान्य program output देता है, successful JSON नहीं।

inspect tokens type-check नहीं करता। inspect ast मानव-पठनीय, अस्थिर development tree देता है, successful JSON नहीं। diagnostics, runtime budgets तथा compatibility देखें।

स्रोत प्रमाण: प्रकाशित release, tagged CLI, project parser और project tests। TypeScript CI दोनों भाषाओं के commands और प्रकाशित version boundaries की जाँच करती है; tagged compiler conformance CI वास्तविक executable चलाती है।