From c793e67cd0044c48aa6f9910f4f694ccd96e0c5a Mon Sep 17 00:00:00 2001
From: Sanskar <sanskarin@outlook.in>
Date: Fri, 6 Nov 2026 17:04:27 +0530
Subject: [PATCH 1/4] docs(compat): correct latest compiler boundary in
 bilingual reference and onboarding

---
 docs/guide/installation-alpha6.md    |  4 +++-
 docs/guide/learning-path.md          |  2 ++
 docs/hi/guide/installation-alpha6.md |  4 +++-
 docs/hi/guide/learning-path.md       |  2 ++
 docs/hi/reference/compatibility.md   | 11 ++++++++---
 docs/hi/reference/evidence.md        |  4 ++--
 docs/reference/compatibility.md      | 11 ++++++++---
 docs/reference/evidence.md           |  4 ++--
 8 files changed, 30 insertions(+), 12 deletions(-)

diff --git a/docs/guide/installation-alpha6.md b/docs/guide/installation-alpha6.md
index 4608dc41..ef40c3a4 100644
--- a/docs/guide/installation-alpha6.md
+++ b/docs/guide/installation-alpha6.md
@@ -4,7 +4,9 @@
 <!-- scarp-install-release: v0.0.6-alpha.1 -->
 <!-- scarp-install-compiler: aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8 -->
 
-This is the **current published Scarp compiler prerelease**, [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1) (November 5, 2026), built from exact source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8`. Scarp is an **experimental interpreter**, not a stable package manager or a compiler that turns `.srp` programs into native executables.
+This is a **historical, version-pinned Scarp compiler prerelease**, [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1) (November 5, 2026), built from exact source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8`. Scarp is an **experimental interpreter**, not a stable package manager or a compiler that turns `.srp` programs into native executables.
+
+**For the latest published v0.0.6-alpha.2 packages and checksums, use the [new release guide](/releases/v0.0.6-alpha.2).** The archive names, hashes and exact source commit below intentionally refer to **alpha.1**, and must not be mixed with alpha.2 artifacts.
 
 The release provides read-only [symbol and reference inspection](/tooling/cli-alpha6), [RMS numerics](/language/rms-alpha6), and a [complete two-file project tutorial](/tutorials/project-symbol-navigation-alpha6).
 
diff --git a/docs/guide/learning-path.md b/docs/guide/learning-path.md
index abdaed8e..15b76e2d 100644
--- a/docs/guide/learning-path.md
+++ b/docs/guide/learning-path.md
@@ -6,6 +6,8 @@
 
 **Unsure which command belongs to your installed compiler?** Use the [interactive version-aware CLI Command Finder](/tooling/command-finder) to avoid mixing older `run` / `check` with newer static `verify` or project inspection.
 
+**Current compiler:** The newest published prerelease is [v0.0.6-alpha.2](/releases/v0.0.6-alpha.2), which adds optional Rust caching APIs, not new Scarp syntax or CLI commands. The alpha.1 symbol-navigation lesson below remains tied to its original checked examples.
+
 **Start here if you are new to Scarp.** This track connects complete, compiler-backed lessons from the first program through numerical modeling, project modules, and the symbol-navigation tools introduced in the **[published v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1)** prerelease.
 
 Scarp is experimental. There is **no single compiler version guaranteed to run every example from every historical guide**. Each stage names the release used to verify its examples. Read the language concept in order, but **run a sample only with the release named by that lesson**, or test it yourself with another compiler. The general language reference remains pinned to v0.0.5-alpha.1; newer guides are separate release-specific evidence.
diff --git a/docs/hi/guide/installation-alpha6.md b/docs/hi/guide/installation-alpha6.md
index 43f874a9..0af28299 100644
--- a/docs/hi/guide/installation-alpha6.md
+++ b/docs/hi/guide/installation-alpha6.md
@@ -4,7 +4,9 @@
 <!-- scarp-install-release: v0.0.6-alpha.1 -->
 <!-- scarp-install-compiler: aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8 -->
 
-यह **वर्तमान प्रकाशित Scarp compiler prerelease** [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1) (5 नवंबर 2026) की installation guide है। इसका सही source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8` है। Scarp अभी **प्रयोगात्मक interpreter** है, न कि stable package manager या `.srp` को native executable में बदलने वाला compiler।
+यह **पुराने प्रकाशित Scarp compiler prerelease का version-specific guide** [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1) (5 नवंबर 2026) की installation guide है। इसका सही source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8` है। Scarp अभी **प्रयोगात्मक interpreter** है, न कि stable package manager या `.srp` को native executable में बदलने वाला compiler।
+
+**नवीनतम प्रकाशित v0.0.6-alpha.2 packages और checksum के लिए [नई release guide](/hi/releases/v0.0.6-alpha.2) पढ़ें।** नीचे के archive नाम, hash और source commit जानबूझकर पुराने **alpha.1** के हैं; इन्हें alpha.2 की files से न मिलाएँ।
 
 इस संस्करण में [symbols और references की static जाँच](/hi/tooling/cli-alpha6), [RMS गणना](/hi/language/rms-alpha6), और [दो source files वाला पूरा project tutorial](/hi/tutorials/project-symbol-navigation-alpha6) उपलब्ध हैं।
 
diff --git a/docs/hi/guide/learning-path.md b/docs/hi/guide/learning-path.md
index 5dfc4001..10ca2db7 100644
--- a/docs/hi/guide/learning-path.md
+++ b/docs/hi/guide/learning-path.md
@@ -6,6 +6,8 @@
 
 **आपके compiler में कौन सा command उपलब्ध है?** [Version-aware CLI Command Finder](/hi/tooling/command-finder) में installed release और काम चुनें। पुरानी `run` / `check` commands को नए static `verify` या project inspection से न मिलाएँ।
 
+**नवीनतम compiler:** प्रकाशित [v0.0.6-alpha.2](/hi/releases/v0.0.6-alpha.2) में वैकल्पिक Rust caching APIs आई हैं, नया Scarp syntax या CLI command नहीं। नीचे का alpha.1 symbol-navigation पाठ अपने मूल परीक्षण किए हुए examples पर आधारित है।
+
 **Scarp पहली बार सीख रहे हैं तो यहाँ से शुरुआत करें।** यह मार्गदर्शिका शुरुआती प्रोग्राम से numerical examples, source modules, project और **[प्रकाशित v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1)** में आए symbol-navigation tools तक पहुँचाती है। हर पाठ के examples compiler के वास्तविक परीक्षणों पर आधारित हैं।
 
 Scarp अभी **experimental prerelease** है। ऐसा **कोई प्रमाण नहीं** कि हर पुराने tutorial का code एक ही नए binary में बिना बदलाव चलेगा। इसलिए **पढ़ाई इसी क्रम में करें**, लेकिन code चलाते समय **उस tutorial का बताया हुआ exact release** प्रयोग करें या दूसरे release पर स्वयं जाँचें। मुख्य भाषा-संदर्भ अभी v0.0.5-alpha.1 से सत्यापित है; नए features अलग release-specific पाठ में लिखे हैं।
diff --git a/docs/hi/reference/compatibility.md b/docs/hi/reference/compatibility.md
index df1dc768..059ec072 100644
--- a/docs/hi/reference/compatibility.md
+++ b/docs/hi/reference/compatibility.md
@@ -6,7 +6,8 @@ Scarp के शुरुआती prereleases में syntax और API ब
 
 | संस्करण | प्रमुख प्रकाशित सुविधा |
 | --- | --- |
-| **`v0.0.6-alpha.1`** | **नवीनतम, 5 नवंबर 2026:** static symbols/references JSON inspection तथा `rms(vector)`; [release](/hi/releases/v0.0.6-alpha.1), [पूरा project lab](/hi/tutorials/project-symbol-navigation-alpha6) |
+| **[v0.0.6-alpha.2](/hi/releases/v0.0.6-alpha.2)** | **वर्तमान प्रकाशित prerelease (6 नवंबर):** वैकल्पिक Rust caching और dependency invalidation APIs; नया Scarp CLI command या syntax नहीं |
+| **`v0.0.6-alpha.1`** | **पिछला प्रकाशित, 5 नवंबर 2026:** static symbols/references JSON inspection तथा `rms(vector)`; [release](/hi/releases/v0.0.6-alpha.1), [पूरा project lab](/hi/tutorials/project-symbol-navigation-alpha6) |
 | **`v0.0.5-alpha.5`** | पिछला, 4 नवंबर 2026: project-directory module inspection; केवल Rust embedding के लिए सीमित C11 emitter; [release](/hi/releases/v0.0.5-alpha.5) |
 | **`v0.0.5-alpha.4`** | 3 नवंबर: नया project create, static verify DIRECTORY, launch; [project guide](/hi/releases/v0.0.5-alpha.4) |
 | `v0.0.1` | integer arithmetic, शुरुआती printing |
@@ -33,12 +34,16 @@ Scarp के शुरुआती prereleases में syntax और API ब
 
 पुराने version की syntax की सामान्य compatibility **सिद्ध नहीं** है। पुराने examples को उसी tagged version से जाँचें; version-specific tutorials और manifests को बदलकर नया tag न दें।
 
-## नवीनतम प्रकाशित alpha.6 की compatibility सीमा
+## प्रकाशित alpha.6 symbols और CLI की compatibility सीमा
 
-वर्तमान प्रकाशित compiler [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1) का source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8` है। इसमें `scarp inspect symbols --json` तथा `scarp inspect references --json` से file या explicit project directory के definitions/references देख सकते हैं। साथ में `rms(vector)` भी प्रकाशित हुआ है। Symbol IDs केवल **एक compilation snapshot** के लिए हैं; कोई तैयार LSP, rename या incremental cache उपलब्ध नहीं है। [Alpha.6 CLI](/hi/tooling/cli-alpha6), [RMS पाठ](/hi/language/rms-alpha6) और [project lab](/hi/tutorials/project-symbol-navigation-alpha6) पढ़ें।
+पहले प्रकाशित alpha.6 compiler [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1) का source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8` है। इसमें `scarp inspect symbols --json` तथा `scarp inspect references --json` से file या explicit project directory के definitions/references देख सकते हैं। साथ में `rms(vector)` भी प्रकाशित हुआ है। Symbol IDs केवल **एक compilation snapshot** के लिए हैं; कोई तैयार LSP, rename या user-facing incremental compilation service नहीं है; बाद के alpha.2 में अलग Rust cache APIs आई हैं। [Alpha.6 CLI](/hi/tooling/cli-alpha6), [RMS पाठ](/hi/language/rms-alpha6) और [project lab](/hi/tutorials/project-symbol-navigation-alpha6) पढ़ें।
 
 [सात चरणों वाला learning path](/hi/guide/learning-path) हर पुराने tutorial के लिए **सही compiler release** बताता है। नए features के आने से सभी पुराने source files के compatible होने का प्रमाण नहीं मिलता। Native `.srp` executable compiler CLI और general tensor runtime अभी नहीं हैं।
 
+## नवीनतम alpha.2 में Rust caching की सीमा
+
+[6 नवंबर की प्रकाशित prerelease](/hi/releases/v0.0.6-alpha.2) में whole-graph resolution, tokens और AST के लिए सीमित, वैकल्पिक Rust cache APIs, dependency invalidation तथा source eviction शामिल हैं। **नया Scarp syntax या CLI command नहीं आया है।** पुराने alpha.1 examples अपने मूल compiler version पर सत्यापित रहते हैं। Cache hit से import, syntax, type और resource checks नहीं छोड़ी जातीं।
+
 ## पुराना स्रोत migrate करना
 
 नए source में अपरिवर्तनीय declaration `bind name = expr;`, mutable declaration `var name = expr;` है। पुराने `let`/`let mut` syntax को वर्तमान `bind`/`var` से बदलें। `print` और `println` alias हैं, लेकिन बहुत पुराने binaries इन्हें अलग तरह से समझते थे।
diff --git a/docs/hi/reference/evidence.md b/docs/hi/reference/evidence.md
index 526cb647..5bfc5dee 100644
--- a/docs/hi/reference/evidence.md
+++ b/docs/hi/reference/evidence.md
@@ -1,12 +1,12 @@
 # Scarp दस्तावेज़ों का सत्यापन
 
-## नवीनतम प्रकाशित alpha.5 का source और runtime प्रमाण
+## पुराने प्रकाशित alpha.5 का source और runtime प्रमाण
 
 [Scarp v0.0.5-alpha.5](/hi/releases/v0.0.5-alpha.5) 4 नवंबर 2026 को source `2eeed0aa52ccb59523307841ad8ffbd83f8911a8` से प्रकाशित हुआ। इसकी तीन native archives, उनकी तीन checksums और SHA256SUMS आधिकारिक GitHub release पर मौजूद हैं। यह compiler अभी stable नहीं है।
 
 Docs में [scalar-repeat source](https://github.com/scarp-lang/scarp/blob/v0.0.5-alpha.5/examples/native_scalar_repeat.srp) और प्रकाशित 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 सीमाएँ](/hi/reference/c11-backend-alpha5) पढ़ें।
 
-दस्तावेज़ में कोई सुविधा “implemented” तभी कही जाती है, जब उसका **प्रकाशित compiler source और tests** में प्रमाण मिले। वर्तमान pinned version `v0.0.5-alpha.1` है।
+दस्तावेज़ में कोई सुविधा “implemented” तभी कही जाती है, जब उसका **प्रकाशित compiler source और tests** में प्रमाण मिले। मुख्य भाषा-संदर्भ का pinned version `v0.0.5-alpha.1` है। नई [v0.0.6-alpha.2 Rust cache guide](/hi/releases/v0.0.6-alpha.2) को अलग प्रकाशित source के रूप में रखा गया है; पुराने tests का version नहीं बदला है।
 
 **नया प्रकाशित संस्करण:** [v0.0.5-alpha.2](/hi/releases/v0.0.5-alpha.2) 2 नवंबर को जारी हुआ। इसके **12 अलग प्रोग्राम और 28 प्रकाशित source/output/module/JSON फ़ाइलें** प्रकाशित टैग से लिए गए हैं। ये [रिलीज़ गाइड](/hi/releases/v0.0.5-alpha.2) तथा [collection tutorial](/hi/tutorials/alpha2-collections-and-learning) में मिलते हैं। `npm run check:alpha2` hash और द्विभाषी code/output जाँचता है; अलग `alpha2-conformance` CI job commit `e4db8e191cd7ea623123cae7348450ca6c95b170` पर compiler build करके प्रोग्राम वास्तव में चलाती है। नीचे की पुरानी 11-case suite अलग **alpha.1** baseline के लिए है।
 
diff --git a/docs/reference/compatibility.md b/docs/reference/compatibility.md
index 5fb74677..173089cf 100644
--- a/docs/reference/compatibility.md
+++ b/docs/reference/compatibility.md
@@ -6,7 +6,8 @@ The language is **prerelease and evolving**. Use the exact executable version ma
 
 | Version | Distinguishing features |
 | --- | --- |
-| **v0.0.6-alpha.1** | **Latest published prerelease (Nov 5):** static symbols/references inspection, schema-v1 navigation JSON, pure `rms(vector)`; [release guide](/releases/v0.0.6-alpha.1) and [verified project tutorial](/tutorials/project-symbol-navigation-alpha6) |
+| **[v0.0.6-alpha.2](/releases/v0.0.6-alpha.2)** | **Current published prerelease (Nov 6):** optional bounded Rust embedding cache and dependency invalidation APIs; no new Scarp CLI commands or syntax |
+| **v0.0.6-alpha.1** | **Earlier published prerelease (Nov 5):** static symbols/references inspection, schema-v1 navigation JSON, pure `rms(vector)`; [release guide](/releases/v0.0.6-alpha.1) and [verified project tutorial](/tutorials/project-symbol-navigation-alpha6) |
 | **v0.0.5-alpha.5** | Previous prerelease (Nov 4): explicit project module inspection and experimental Rust-only scalar C11 emitter; [release guide](/releases/v0.0.5-alpha.5) |
 | **v0.0.5-alpha.4** | Published Nov 3: new create/verify DIRECTORY/launch project workflow; [release guide](/releases/v0.0.5-alpha.4) |
 | **v0.0.5-alpha.3** | **Historical prerelease (Nov 2):** Scarp-first `exec`/static `verify`/`inspect`, offline `diagnose`, bounded text construction; [four verified examples](/releases/v0.0.5-alpha.3) |
@@ -36,12 +37,16 @@ The [v0.0.5-alpha.5 release](https://github.com/scarp-lang/scarp/releases/tag/v0
 
 This does not prove that **every** old program works unchanged on the latest prerelease. Preserve tagged test fixtures and check exact versions when diagnosing a regression.
 
-## Current published alpha.6 compatibility boundary
+## Published alpha.6 symbol/CLI compatibility boundary
 
-The newest published compiler is [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1), built from source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8`. It adds `scarp inspect symbols --json` and `scarp inspect references --json` for an explicit source file or project directory, plus `rms(vector)`. The alpha.6 inventory uses snapshot-local IDs: it is **not** an LSP, rename feature or incremental compilation service. See the [alpha.6 CLI](/tooling/cli-alpha6), [RMS guide](/language/rms-alpha6) and [end-to-end project lab](/tutorials/project-symbol-navigation-alpha6).
+The earlier alpha.6 language/CLI milestone is [v0.0.6-alpha.1](https://github.com/scarp-lang/scarp/releases/tag/v0.0.6-alpha.1), built from source commit `aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8`. It adds `scarp inspect symbols --json` and `scarp inspect references --json` for an explicit source file or project directory, plus `rms(vector)`. The alpha.1 symbol inventory uses snapshot-local IDs: it is **not** an LSP, rename feature or user-facing incremental compilation service. The subsequent alpha.2 adds separate Rust-only caching APIs. See the [alpha.6 CLI](/tooling/cli-alpha6), [RMS guide](/language/rms-alpha6) and [end-to-end project lab](/tutorials/project-symbol-navigation-alpha6).
 
 The [seven-stage learning path](/guide/learning-path) names the **exact release required for each historical runnable lesson**. New published features do **not** imply universal binary/source compatibility across versions. There is no native `.srp` executable compiler CLI or general tensor runtime.
 
+## Latest alpha.2 Rust cache scope
+
+The [November 6 prerelease](/releases/v0.0.6-alpha.2) adds opt-in, bounded Rust-only caches for whole-graph resolution, tokens and parsed syntax, plus conservative dependency invalidation and source eviction. **These APIs are not new Scarp language constructs or CLI commands.** The released alpha.1 tutorials remain pinned to their original source tags. A cache hit does not override import, syntax, type or resource checks.
+
 ## Source migration
 
 Some early Scarp examples used `let`, `let mut`, and `println`; current v0.0.5-alpha.1 uses `bind`, `var`, and `print` while retaining `println` as an alias. Do not assume a snippet written for one prerelease runs unchanged on another. Refer to the compiler's [syntax migration guide](https://github.com/scarp-lang/scarp/blob/v0.0.5-alpha.1/docs/syntax-migration.md).
diff --git a/docs/reference/evidence.md b/docs/reference/evidence.md
index 900262f1..7a97f82e 100644
--- a/docs/reference/evidence.md
+++ b/docs/reference/evidence.md
@@ -1,12 +1,12 @@
 # How Scarp documentation is verified
 
-## Latest published alpha.5 compiler evidence
+## Historical published alpha.5 compiler evidence
 
 [Scarp v0.0.5-alpha.5](/releases/v0.0.5-alpha.5) was published November 4, 2026 from pinned source `2eeed0aa52ccb59523307841ad8ffbd83f8911a8`. The GitHub release contains three native archives, matching sidecar checksums, and SHA256SUMS. It is a prerelease, not stable.
 
 Docs carry the [scalar-repeat source](https://github.com/scarp-lang/scarp/blob/v0.0.5-alpha.5/examples/native_scalar_repeat.srp) and **byte-exact** stdout. CI builds the tagged alpha.5 compiler and checks static verify, interpreter exec, identical file/project module JSON inventory, the legacy alias, and invalid-manifest diagnostics. Experimental C11 emission is a **Rust-only embedding API**; no native compile CLI has shipped. See [C11 limits](/reference/c11-backend-alpha5).
 
-This site targets the **published v0.0.5-alpha.1 Scarp prerelease**. We treat compiler source, tests, actual release fixtures, and published artifacts as evidence. Design proposals and open pull requests are **not** proof that a feature shipped.
+The **general language reference** is pinned to the published v0.0.5-alpha.1 Scarp prerelease. The separately published [v0.0.6-alpha.2 Rust cache guide](/releases/v0.0.6-alpha.2) documents newer library APIs without repinning older compiler tests. We treat compiler source, tests, actual release fixtures, and published artifacts as evidence. Design proposals and open pull requests are **not** proof that a feature shipped.
 
 **New release:** Scarp [v0.0.5-alpha.2](/releases/v0.0.5-alpha.2) was published on November 2. It now has **12 additional, separately pinned programs and 28 upstream Git blob hashes** across the [release guide](/releases/v0.0.5-alpha.2) and [collections tutorial](/tutorials/alpha2-collections-and-learning). `npm run check:alpha2` checks the complete bilingual release-page code/output fences and byte-for-byte fixture provenance; the `alpha2-conformance` CI job checks out exact source commit `e4db8e191cd7ea623123cae7348450ca6c95b170`, builds the published compiler, and tests those programs. The 11-case suite below remains tied only to alpha.1—these are **two distinct release suites**, not a claim that the main docs baseline was already migrated.
 

From e298126d829ef90ca27335fa3c0fffae0a5f5997 Mon Sep 17 00:00:00 2001
From: Sanskar <sanskarin@outlook.in>
Date: Fri, 6 Nov 2026 17:05:12 +0530
Subject: [PATCH 2/4] docs(history): stop labeling alpha.2 through alpha.4
 tutorials as newest

---
 docs/guide/quickstart-alpha3.md           | 2 +-
 docs/guide/quickstart-alpha4.md           | 2 +-
 docs/hi/guide/quickstart-alpha3.md        | 2 +-
 docs/hi/guide/quickstart-alpha4.md        | 2 +-
 docs/hi/language/typed-bindings-alpha2.md | 2 +-
 docs/hi/tooling/cli-alpha4.md             | 2 +-
 docs/language/typed-bindings-alpha2.md    | 2 +-
 docs/tooling/cli-alpha4.md                | 2 +-
 8 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/guide/quickstart-alpha3.md b/docs/guide/quickstart-alpha3.md
index 7f31a8fe..5fe8a460 100644
--- a/docs/guide/quickstart-alpha3.md
+++ b/docs/guide/quickstart-alpha3.md
@@ -2,7 +2,7 @@
 
 <!-- scarp-cli-release: v0.0.5-alpha.3 -->
 
-This is the **recommended first-run guide for the latest published prerelease**, [v0.0.5-alpha.3](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.3), published **November 2, 2026**. Scarp is experimental and runs programs through an interpreter: there is **no native executable builder or stable language guarantee**. Older reference pages remain pinned to [alpha.1](/reference/status).
+This is the **historically verified alpha.3 first-run guide**, [v0.0.5-alpha.3](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.3), published **November 2, 2026**. Scarp is experimental and runs programs through an interpreter: there is **no native executable builder or stable language guarantee**. Older reference pages remain pinned to [alpha.1](/reference/status). **For a new installation, see the [current v0.0.6-alpha.2 release](/releases/v0.0.6-alpha.2); the commands and files below are intentionally pinned to alpha.3.**
 
 ## 1. Choose and verify the official download
 
diff --git a/docs/guide/quickstart-alpha4.md b/docs/guide/quickstart-alpha4.md
index 31f62656..a2c489fe 100644
--- a/docs/guide/quickstart-alpha4.md
+++ b/docs/guide/quickstart-alpha4.md
@@ -1,6 +1,6 @@
 # Quickstart: your first Scarp project (v0.0.5-alpha.4)
 ::: tip Latest published compiler
-New installs should use the [published v0.0.6-alpha.1 release and checksums](/releases/v0.0.6-alpha.1) and [release-aware learning path](/guide/learning-path). This alpha.4 page is intentionally pinned to its original generator, binary and stdout.
+New installs should use the [published v0.0.6-alpha.2 release and checksums](/releases/v0.0.6-alpha.2) and [release-aware learning path](/guide/learning-path). This alpha.4 page is intentionally pinned to its original generator, binary and stdout.
 :::
 
 
diff --git a/docs/hi/guide/quickstart-alpha3.md b/docs/hi/guide/quickstart-alpha3.md
index 9c195b62..460f33f1 100644
--- a/docs/hi/guide/quickstart-alpha3.md
+++ b/docs/hi/guide/quickstart-alpha3.md
@@ -2,7 +2,7 @@
 
 <!-- scarp-cli-release: v0.0.5-alpha.3 -->
 
-यह **नई प्रकाशित prerelease** [v0.0.5-alpha.3](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.3) (2 नवंबर 2026) के लिए शुरुआती मार्गदर्शिका है। Scarp अभी **प्रयोगात्मक interpreter** है। यह `.srp` से native executable नहीं बनाता और भाषा की स्थिर compatibility की गारंटी नहीं है। पुराने मुख्य संदर्भ का आधार अब भी [alpha.1](/hi/reference/status) है।
+यह **ऐतिहासिक, alpha.3 के लिए सत्यापित शुरुआती गाइड** [v0.0.5-alpha.3](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.3) (2 नवंबर 2026) के लिए शुरुआती मार्गदर्शिका है। Scarp अभी **प्रयोगात्मक interpreter** है। यह `.srp` से native executable नहीं बनाता और भाषा की स्थिर compatibility की गारंटी नहीं है। पुराने मुख्य संदर्भ का आधार अब भी [alpha.1](/hi/reference/status) है। **नई स्थापना के लिए [वर्तमान v0.0.6-alpha.2 release](/hi/releases/v0.0.6-alpha.2) देखें; नीचे के commands और source examples जानबूझकर alpha.3 पर आधारित हैं।**
 
 ## 1. सही archive चुनें और checksum मिलाएँ
 
diff --git a/docs/hi/guide/quickstart-alpha4.md b/docs/hi/guide/quickstart-alpha4.md
index f1fcdab2..eda82ace 100644
--- a/docs/hi/guide/quickstart-alpha4.md
+++ b/docs/hi/guide/quickstart-alpha4.md
@@ -1,6 +1,6 @@
 # Scarp में पहला project बनाएँ (v0.0.5-alpha.4)
 ::: tip नवीनतम प्रकाशित compiler
-नए उपयोगकर्ताओं के लिए [प्रकाशित v0.0.6-alpha.1 release और checksum](/hi/releases/v0.0.6-alpha.1) तथा [सही version वाला learning path](/hi/guide/learning-path) हैं। इस पुराने alpha.4 guide का source, binary और stdout जानबूझकर बदला नहीं गया है।
+नए उपयोगकर्ताओं के लिए [प्रकाशित v0.0.6-alpha.2 release और checksum](/hi/releases/v0.0.6-alpha.2) तथा [सही version वाला learning path](/hi/guide/learning-path) हैं। इस पुराने alpha.4 guide का source, binary और stdout जानबूझकर बदला नहीं गया है।
 :::
 
 
diff --git a/docs/hi/language/typed-bindings-alpha2.md b/docs/hi/language/typed-bindings-alpha2.md
index 3acdb164..1f3160ab 100644
--- a/docs/hi/language/typed-bindings-alpha2.md
+++ b/docs/hi/language/typed-bindings-alpha2.md
@@ -5,7 +5,7 @@
 इस पाठ में 2 नवंबर 2026 को प्रकाशित **[v0.0.5-alpha.2](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.2)** की दो वास्तविक सुविधाएँ सीखेंगे: `bind` / `var` में स्पष्ट type annotation और जाँच के साथ numeric conversion। Source का सटीक compiler commit [`e4db8e191cd7ea623123cae7348450ca6c95b170`](https://github.com/scarp-lang/scarp/commit/e4db8e191cd7ea623123cae7348450ca6c95b170) है। यह **release-specific** पाठ है। पुराने [variables](/hi/language/variables) और [types](/hi/language/types) के सामान्य references अब भी अलग **alpha.1** प्रमाण पर आधारित हैं।
 
 ::: tip कौन-सा संस्करण?
-नीचे की commands **alpha.2 compiler** पर ही चलाएँ। सबसे नया प्रकाशित compiler [alpha.3](/hi/releases/v0.0.5-alpha.3) है, जिसमें नए CLI commands भी हैं। Alpha.1 executable इन annotations और conversion functions को नहीं समझता। इस पाठ के पूरे programs वास्तविक **tagged alpha.2 compiler** पर जाँचे गए हैं; सभी versions के लिए compatibility की गारंटी नहीं दी गई है।
+नीचे की commands **alpha.2 compiler** पर ही चलाएँ। नवीनतम प्रकाशित compiler [v0.0.6-alpha.2](/hi/releases/v0.0.6-alpha.2) है; पुराने [alpha.3 release](/hi/releases/v0.0.5-alpha.3) में नए CLI commands आए थे। Alpha.1 executable इन annotations और conversion functions को नहीं समझता। इस पाठ के पूरे programs वास्तविक **tagged alpha.2 compiler** पर जाँचे गए हैं; सभी versions के लिए compatibility की गारंटी नहीं दी गई है।
 :::
 
 ## 1. Type annotation क्या होता है?
diff --git a/docs/hi/tooling/cli-alpha4.md b/docs/hi/tooling/cli-alpha4.md
index b1a552f8..883df6ab 100644
--- a/docs/hi/tooling/cli-alpha4.md
+++ b/docs/hi/tooling/cli-alpha4.md
@@ -1,6 +1,6 @@
 # कमांड-लाइन इंटरफ़ेस — प्रकाशित Scarp v0.0.5-alpha.4
 ::: tip नवीनतम CLI
-नया compiler [v0.0.5-alpha.5](/hi/releases/v0.0.5-alpha.5) है। Project-directory module inspection के लिए [alpha.5 CLI](/hi/tooling/cli-alpha5) पढ़ें। नीचे के commands alpha.4 पर आधारित हैं।
+नवीनतम प्रकाशित compiler [v0.0.6-alpha.2](/hi/releases/v0.0.6-alpha.2) है। इसमें नया CLI command नहीं, केवल वैकल्पिक Rust cache APIs हैं। पुराने project-directory module inspection के लिए [alpha.5 CLI](/hi/tooling/cli-alpha5) पढ़ें। नीचे के commands alpha.4 पर आधारित हैं।
 :::
 
 
diff --git a/docs/language/typed-bindings-alpha2.md b/docs/language/typed-bindings-alpha2.md
index a2a8a53e..481736f6 100644
--- a/docs/language/typed-bindings-alpha2.md
+++ b/docs/language/typed-bindings-alpha2.md
@@ -5,7 +5,7 @@
 This practical lesson covers two capabilities **shipped in the published [v0.0.5-alpha.2](https://github.com/scarp-lang/scarp/releases/tag/v0.0.5-alpha.2) prerelease** on November 2, 2026: optional type annotations in `bind` / `var` declarations and explicit, checked numeric conversions. The source is pinned to compiler commit [`e4db8e191cd7ea623123cae7348450ca6c95b170`](https://github.com/scarp-lang/scarp/commit/e4db8e191cd7ea623123cae7348450ca6c95b170). It is a **release-specific addition**; the older [variables](/language/variables) and [types](/language/types) references retain their independent alpha.1 evidence.
 
 ::: tip Version boundary
-Use an **alpha.2 compiler** for the exact commands below. The latest released compiler is [alpha.3](/releases/v0.0.5-alpha.3), which also adds newer CLI verbs; the older alpha.1 compiler does **not** implement these annotations or conversion built-ins. This lesson's programs have been executed and verified **on the tagged alpha.2 compiler**; it does not claim an exhaustive cross-release compatibility guarantee.
+Use an **alpha.2 compiler** for the exact commands below. The latest released compiler is [v0.0.6-alpha.2](/releases/v0.0.6-alpha.2); the historical [alpha.3 release](/releases/v0.0.5-alpha.3) introduced newer CLI verbs; the older alpha.1 compiler does **not** implement these annotations or conversion built-ins. This lesson's programs have been executed and verified **on the tagged alpha.2 compiler**; it does not claim an exhaustive cross-release compatibility guarantee.
 :::
 
 ## 1. What is a type annotation?
diff --git a/docs/tooling/cli-alpha4.md b/docs/tooling/cli-alpha4.md
index 92fe97a4..d7c027d3 100644
--- a/docs/tooling/cli-alpha4.md
+++ b/docs/tooling/cli-alpha4.md
@@ -1,6 +1,6 @@
 # Command-line interface — published Scarp v0.0.5-alpha.4
 ::: tip Latest CLI reference
-The current published compiler is [v0.0.5-alpha.5](/releases/v0.0.5-alpha.5); use the [alpha.5 CLI](/tooling/cli-alpha5) for project-directory module inspection. The commands below remain alpha.4-only.
+The latest published compiler is [v0.0.6-alpha.2](/releases/v0.0.6-alpha.2). For the historical alpha.5 module-inspection commands, see the [alpha.5 CLI](/tooling/cli-alpha5); alpha.2 adds Rust-only caching, not new CLI commands. The commands below remain alpha.4-only.
 :::
 
 

From b96debd31b143c763b97006ea9781bc8df1e4833 Mon Sep 17 00:00:00 2001
From: Sanskar <sanskarin@outlook.in>
Date: Fri, 6 Nov 2026 17:06:46 +0530
Subject: [PATCH 3/4] test(onboarding): require current alpha.2 downloads while
 preserving alpha.1 capstone

---
 scripts/lib/learning-path-policy.ts | 11 ++++++-----
 scripts/test-learning-path.ts       | 10 ++++++----
 2 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/scripts/lib/learning-path-policy.ts b/scripts/lib/learning-path-policy.ts
index 5f6091ae..108f4cc7 100644
--- a/scripts/lib/learning-path-policy.ts
+++ b/scripts/lib/learning-path-policy.ts
@@ -56,7 +56,7 @@ export function validateLearningPath(pages: LearningPathPages, release: Alpha6Ma
   const errors: string[] = []
   const fail = (what: string): void => { errors.push(what) }
   if (release.compilerRef !== ALPHA6_REF || release.compilerCommit !== ALPHA6_SHA ||
-      release.status !== 'published-prerelease') fail('latest release identity does not match published compiler')
+      release.status !== 'published-prerelease') fail('pinned capstone release identity does not match published compiler')
   const en = pages.english
   const hi = pages.hindi
   const expectedStages = learningStages.map(s => s.id + ' ' + s.release)
@@ -169,15 +169,16 @@ export function validateLearningPath(pages: LearningPathPages, release: Alpha6Ma
     ['Hindi',pages.compatibilityHindi,pages.introHindi,pages.firstHindi,pages.quickHindi]
   ] as const) {
     if (!compat.includes(ALPHA6_REF) || !compat.includes(ALPHA6_SHA) ||
+        !compat.includes('v0.0.6-alpha.2') ||
         !intro.includes(ALPHA6_REF) || !first.includes(ALPHA6_REF) ||
-        !quick.includes(ALPHA6_REF)) {
+        !quick.includes('v0.0.6-alpha.2')) {
       fail(locale + ': stale onboarding/compatibility release boundary')
     }
     const exactLatestQuickstart = locale === 'Hindi'
-      ? '[प्रकाशित v0.0.6-alpha.1 release और checksum]'
-      : '[published v0.0.6-alpha.1 release and checksums]'
+      ? '[प्रकाशित v0.0.6-alpha.2 release और checksum]'
+      : '[published v0.0.6-alpha.2 release and checksums]'
     if (!quick.includes(exactLatestQuickstart)) {
-      fail(locale + ': visible latest-release guidance in the historical quickstart is stale')
+      fail(locale + ': historical quickstart must link current published alpha.2 download')
     }
     if (!compat.includes(']('+(locale==='Hindi'?'/hi':'')+'/guide/learning-path)')) {
       fail(locale + ': compatibility page does not link to learner journey')
diff --git a/scripts/test-learning-path.ts b/scripts/test-learning-path.ts
index e71d37bd..38e636fa 100644
--- a/scripts/test-learning-path.ts
+++ b/scripts/test-learning-path.ts
@@ -50,11 +50,13 @@ mutate('homeHindi','link: /hi/guide/learning-path','link: /hi/guide/removed')
 mutate('introEnglish','](/guide/learning-path)','](/guide/removed)')
 mutate('introHindi','](/hi/guide/learning-path)','](/hi/guide/removed)')
 mutate('firstEnglish','v0.0.6-alpha.1','v0.0.5-alpha.5')
-mutate('quickEnglish','[published v0.0.6-alpha.1 release and checksums]',
-  '[published v0.0.5-alpha.5 release and checksums]')
-mutate('quickHindi','v0.0.6-alpha.1','v0.0.5-alpha.5')
+mutate('quickEnglish','[published v0.0.6-alpha.2 release and checksums]',
+  '[published v0.0.6-alpha.1 release and checksums]')
+mutate('quickHindi','[प्रकाशित v0.0.6-alpha.2 release और checksum]',
+  '[प्रकाशित v0.0.6-alpha.1 release और checksum]')
 mutate('compatibilityEnglish','aa329a22cf2bf92d2c9814a26ff9c8b67a72e6e8','wrong-release-sha')
-mutate('compatibilityHindi','**नवीनतम, 5 नवंबर 2026','**नवीनतम, 4 नवंबर 2026')
+mutate('compatibilityHindi','[v0.0.6-alpha.2](/hi/releases/v0.0.6-alpha.2)',
+  '[v0.0.6-alpha.1](/hi/releases/v0.0.6-alpha.1)')
 mutate('examplesEnglish','](/guide/learning-path)','](/guide/removed)')
 mutate('examplesHindi','](/hi/guide/learning-path)','](/hi/guide/removed)')
 mutate('readme','](docs/guide/learning-path.md)','](docs/guide/removed.md)')

From 20b598f94cc2a423d44c4dbc7b313b2dcdf6f24c Mon Sep 17 00:00:00 2001
From: Sanskar <sanskarin@outlook.in>
Date: Fri, 6 Nov 2026 17:08:23 +0530
Subject: [PATCH 4/4] test(compat): require correct latest-release table row,
 not just incidental prose

---
 scripts/lib/learning-path-policy.ts | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/scripts/lib/learning-path-policy.ts b/scripts/lib/learning-path-policy.ts
index 108f4cc7..567a4583 100644
--- a/scripts/lib/learning-path-policy.ts
+++ b/scripts/lib/learning-path-policy.ts
@@ -168,7 +168,11 @@ export function validateLearningPath(pages: LearningPathPages, release: Alpha6Ma
     ['English',pages.compatibilityEnglish,pages.introEnglish,pages.firstEnglish,pages.quickEnglish],
     ['Hindi',pages.compatibilityHindi,pages.introHindi,pages.firstHindi,pages.quickHindi]
   ] as const) {
-    if (!compat.includes(ALPHA6_REF) || !compat.includes(ALPHA6_SHA) ||
+    const currentReleaseRow = locale === 'Hindi'
+      ? '| **[v0.0.6-alpha.2](/hi/releases/v0.0.6-alpha.2)** |'
+      : '| **[v0.0.6-alpha.2](/releases/v0.0.6-alpha.2)** |'
+    if (!compat.includes(currentReleaseRow) ||
+        !compat.includes(ALPHA6_REF) || !compat.includes(ALPHA6_SHA) ||
         !compat.includes('v0.0.6-alpha.2') ||
         !intro.includes(ALPHA6_REF) || !first.includes(ALPHA6_REF) ||
         !quick.includes('v0.0.6-alpha.2')) {