Scarp दस्तावेज़ों का सत्यापन

पुराने प्रकाशित alpha.5 का source और runtime प्रमाण

Scarp v0.0.5-alpha.5 4 नवंबर 2026 को source 2eeed0aa52ccb59523307841ad8ffbd83f8911a8 से प्रकाशित हुआ। इसकी तीन native archives, उनकी तीन checksums और SHA256SUMS आधिकारिक GitHub release पर मौजूद हैं। यह compiler अभी stable नहीं है।

Docs में scalar-repeat source और प्रकाशित stdout की exact bytes रखी गई हैं। CI tagged alpha.5 interpreter को build करके verify/exec, project-directory बनाम file module JSON inventory, legacy alias और malformed-manifest diagnostics जाँचती है। Rust C11 emitter सिर्फ embedding API है; native build CLI उपलब्ध नहीं। C11 सीमाएँ पढ़ें।

दस्तावेज़ में कोई सुविधा “implemented” तभी कही जाती है, जब उसका प्रकाशित compiler source और tests में प्रमाण मिले। मुख्य भाषा-संदर्भ का pinned version v0.0.5-alpha.1 है। नई v0.0.6-alpha.2 Rust cache guide को अलग प्रकाशित source के रूप में रखा गया है; पुराने tests का version नहीं बदला है।

नया प्रकाशित संस्करण: v0.0.5-alpha.2 2 नवंबर को जारी हुआ। इसके 12 अलग प्रोग्राम और 28 प्रकाशित source/output/module/JSON फ़ाइलें प्रकाशित टैग से लिए गए हैं। ये रिलीज़ गाइड तथा collection tutorial में मिलते हैं। npm run check:alpha2 hash और द्विभाषी code/output जाँचता है; अलग alpha2-conformance CI job commit e4db8e191cd7ea623123cae7348450ca6c95b170 पर compiler build करके प्रोग्राम वास्तव में चलाती है। नीचे की पुरानी 11-case suite अलग alpha.1 baseline के लिए है।

असफल compiler programs की जाँच

Alpha.2 diagnostics और सुधार में छह जानबूझकर असफल प्रोग्राम और 14 pinned source/stderr/support फ़ाइलें हैं। npm run check:alpha2-errors published Git blob hashes तथा दोनों भाषाओं के पूरे source/stderr blocks जाँचता है। अलग alpha2-conformance CI में check/run से exit status 1, खाली stdout और प्रकाशित stderr की तुलना होती है। Native CLI के absolute imported-module path labels को published snapshot के छोटे filenames से मिलाकर शेष stderr की exact जाँच होती है। ये negative cases हैं, इसलिए 12 सफल alpha.2 या 11 सफल alpha.1 programs की गिनती में नहीं जोड़ने चाहिए।

संस्करण अपग्रेड के लिए जाँच

Alpha.1 → alpha.2 upgrade readiness में पुराने 11 source/output examples को नए प्रकाशित alpha.2 interpreter से दोबारा चलाकर check, सटीक stdout तथा lexer tokens का सत्यापन होता है। यह मूल alpha.1 suite, नए 12 alpha.2 programs और छह negative error examples से अलग परीक्षण है। यह arbitrary programs के सभी मामलों में backward compatibility की गारंटी नहीं देता।

ऐतिहासिक alpha.3 का अलग सत्यापन

प्रकाशित v0.0.5-alpha.3 गाइड तीसरा स्वतंत्र release track है, commit 7715c28df09c7703b39e14fddb963275b25df476 पर pinned। npm run check:alpha3 दोनों भाषाओं के चार पूरे source/stdout programs, imported module, E0015 JSON diagnostic और 11 upstream Git blobs जाँचता है। अलग alpha3-conformance CI job सही compiler build करके static verify, runtime exec, legacy run तथा inspection commands चलाता है। पुरानी 11 alpha.1 या 12 alpha.2 cases की गिनती इससे नहीं बदलती।

तीन स्तरों की जाँच

1. Markdown/लिंक: npm run check:docs से pages, navigation, anchors और आवश्यक metadata जाँचें।
2. Fixture पहचान: npm run check:fixtures 11 प्रकाशित Scarp उदाहरणों की 24 source/output फ़ाइलों की pinned Git blob hashes जाँचता है।
3. वास्तविक execution: CI में compiler को exact tagged commit से build करके source और expected stdout byte-by-byte जाँचे जाते हैं।

VitePress का सफल build यह प्रमाण नहीं कि .srp कोड चलता है। केवल source proposal से किसी नई सुविधा की घोषणा नहीं करें।

npm run check:snippets पुराना Scarp syntax और अनुपलब्ध CLI commands वाले runnable code fences पकड़ता है। npm run check:tutorial-evidence सभी 11 स्रोत-आउटपुट जोड़ों की हिन्दी और अंग्रेज़ी पृष्ठों से तुलना करता है। ये static checks हैं; वास्तविक compiler execution अलग CI job में होता है।

अपने कंप्यूटर पर दोहराएँ

npm install
npm run check:docs
npm run check:fixtures
npm run docs:build

दोनों प्रकाशित tag के linked reference paths देखने के लिए npm run check:evidence -- /path/to/alpha1 /path/to/alpha2 चलाएँ।

Compiler conformance test के लिए tag afe8b5380c9d6c4774162e51c6c9bc8b90901671 का interpreter build करें, फिर npm run test:compiler -- /path/to/scarp चलाएँ।

नए release के समय

Tag, change log, tests, baseline JSON, source hashes, feature-status और दोनों भाषाओं के pages साथ अपडेट करें। रखरखाव सूची में प्रक्रिया दी है।

अंग्रेज़ी संदर्भ के अपरिवर्तित कोड उदाहरण

नीचे दिए गए code snippets मूल अंग्रेज़ी संदर्भ से लिए गए हैं। Keywords, source strings और output expectations जानबूझकर अनुवादित नहीं किए गए हैं।

npm run check:docs
npm run check:fixtures

npm run check:fixtures -- /path/to/scarp/examples
npm run check:evidence -- /path/to/alpha1 /path/to/alpha2
npm run test:compiler -- /path/to/scarp/target/debug/scarp

7 नवंबर 2026 का प्रकाशित alpha.3: Top-K और temperature functions tagged compiler के उदाहरणों पर आधारित हैं; private scalar IR अभी general native compiler नहीं है.