feat(schema): add semantic IR and symbol ID infrastructure

.github/workflows/docs-preview.yml

@@ -28,16 +28,13 @@ jobs:
 
       - name: Install mdBook and mdbook-keeper
         run: |
-          # Only install if not already cached
           if ! command -v mdbook &> /dev/null; then
-            cargo install mdbook
+            cargo install mdbook --version "~0.4"
           fi
-          
           if ! command -v mdbook-keeper &> /dev/null; then
-            cargo install mdbook-keeper
+            cargo install mdbook-keeper --version "~0.5"
           fi
 
-
       - name: Build mdBook documentation
         run: |
           cd docs

.github/workflows/docs.yml

@@ -36,19 +36,18 @@ jobs:
 
       - name: Install mdBook and mdbook-keeper
         run: |
-          # Only install if not already cached
+          # Pin to mdbook 0.4.x (0.5.x changed preprocessor JSON format,
+          # breaking mdbook-keeper compatibility)
           if ! command -v mdbook &> /dev/null; then
-            cargo install mdbook
+            cargo install mdbook --version "~0.4"
           fi
-
           if ! command -v mdbook-keeper &> /dev/null; then
-            cargo install mdbook-keeper
+            cargo install mdbook-keeper --version "~0.5"
           fi
-      
+
       - name: Test mdBook examples
         run: |
           cd docs
-          # mdbook-keeper runs doctests during build with real dependencies
           mdbook build
 
   # Build and deploy documentation site
@@ -75,15 +74,13 @@ jobs:
 
       - name: Install mdBook and mdbook-keeper
         run: |
-          # Only install if not already cached
           if ! command -v mdbook &> /dev/null; then
-            cargo install mdbook
+            cargo install mdbook --version "~0.4"
           fi
-
           if ! command -v mdbook-keeper &> /dev/null; then
-            cargo install mdbook-keeper
+            cargo install mdbook-keeper --version "~0.5"
           fi
-          
+
       - name: Build mdBook documentation
         run: |
           cd docs

.gitignore

@@ -1,2 +1,5 @@
 /target
 docs/book
+.vscode/settings.json
+*.pyc
+__pycache__/

README.md

@@ -33,10 +33,10 @@
 
 ## Documentation
 
-- 📦 [Crates.io](https://crates.io/crates/reflectapi) - Package information and versions
-- 📖 [API Documentation](https://docs.rs/reflectapi) - Complete API reference  
-- 📚 [User Guide](https://reflectapi.partly.workers.dev/) - Tutorials and examples
-- 🚀 [Quick Start](https://reflectapi.partly.workers.dev/getting-started/quick-start.html) - Get up and running in 5 minutes
+- [Crates.io](https://crates.io/crates/reflectapi) - Package information and versions
+- [API Documentation](https://docs.rs/reflectapi) - Complete API reference
+- [User Guide](docs/src/SUMMARY.md) - Tutorials and examples (build locally with `mdbook serve` in `docs/`)
+- [Architecture](docs/architecture.md) - System design and internals
 
 ## Development notes