fix(ovsm): fix doctest visibility and return types for CI

- Add proper use statements to Parser and Evaluator doctests
- Add Result return types for doctests using ? operator
- Replace LEN with COUNT in example (LEN tool doesn't exist)
- Fix 7 out of 9 failing doctests (10/12 now passing vs 3/12 before)
- Remaining 2 failures need multiline string handling fixes

Issue: Doctests failed because they used ? without Result return type
and referenced types without use statements.

Author: 0xrinegade

crates/ovsm/src/lib.rs

@@ -145,14 +145,12 @@
 //! #     let mut evaluator = Evaluator::new();
 //! #     evaluator.execute(&program).unwrap()
 //! # }
-//! let code = r#"
-//!     $found = false
-//!     FOR $i IN [1..100]:
-//!         IF $i == 42 THEN
-//!             $found = true
-//!             BREAK
-//!     RETURN $found
-//! "#;
+//! let code = "$found = false
+//! FOR $i IN [1..100]:
+//!     IF $i == 42 THEN
+//!         $found = true
+//!         BREAK
+//! RETURN $found";
 //!
 //! let result = execute(code);
 //! assert_eq!(result, Value::Bool(true));
@@ -170,16 +168,14 @@
 //! #     let mut evaluator = Evaluator::new();
 //! #     evaluator.execute(&program).unwrap()
 //! # }
-//! let code = r#"
-//!     $numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
-//!     $evens = []
+//! let code = "$numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+//! $evens = []
 //!
-//!     FOR $n IN $numbers:
-//!         IF $n % 2 == 0 THEN
-//!             $evens = $evens + [$n]
+//! FOR $n IN $numbers:
+//!     IF $n % 2 == 0 THEN
+//!         $evens = $evens + [$n]
 //!
-//!     RETURN $evens
-//! "#;
+//! RETURN $evens";
 //!
 //! let result = execute(code);
 //! // Result: [2, 4, 6, 8, 10]
@@ -198,14 +194,15 @@
 //! #     evaluator.execute(&program).unwrap()
 //! # }
 //! let code = r#"
-//!     $numbers = [10, 25, 5, 30, 15]
+//! $numbers = [10, 25, 5, 30, 15]
 //!
-//!     $total = SUM($numbers)
-//!     $max = MAX($numbers)
-//!     $min = MIN($numbers)
-//!     $avg = $total / LEN($numbers)
+//! $total = SUM($numbers)
+//! $max = MAX($numbers)
+//! $min = MIN($numbers)
+//! $count = COUNT($numbers)
+//! $avg = $total / $count
 //!
-//!     RETURN {total: $total, max: $max, min: $min, avg: $avg}
+//! RETURN {total: $total, max: $max, min: $min, avg: $avg}
 //! "#;
 //!
 //! let result = execute(code);

crates/ovsm/src/parser/mod.rs

@@ -15,11 +15,14 @@
 //! use ovsm::lexer::Scanner;
 //! use ovsm::parser::Parser;
 //!
+//! # fn main() -> Result<(), Box<dyn std::error::Error>> {
 //! let code = "$x = 42\nRETURN $x * 2";
 //! let mut scanner = Scanner::new(code);
 //! let tokens = scanner.scan_tokens()?;
 //! let mut parser = Parser::new(tokens);
 //! let program = parser.parse()?;  // Returns AST
+//! # Ok(())
+//! # }
 //! ```
 //!
 //! # Parsing Strategy
@@ -61,9 +64,15 @@ impl Parser {
     /// # Example
     ///
     /// ```rust
+    /// use ovsm::lexer::Scanner;
+    /// use ovsm::parser::Parser;
+    ///
+    /// # fn main() -> Result<(), Box<dyn std::error::Error>> {
     /// let mut scanner = Scanner::new("$x = 10");
     /// let tokens = scanner.scan_tokens()?;
     /// let parser = Parser::new(tokens);
+    /// # Ok(())
+    /// # }
     /// ```
     pub fn new(tokens: Vec<Token>) -> Self {
         Parser { tokens, current: 0 }
@@ -82,9 +91,17 @@ impl Parser {
     /// # Example
     ///
     /// ```rust
+    /// use ovsm::lexer::Scanner;
+    /// use ovsm::parser::Parser;
+    ///
+    /// # fn main() -> Result<(), Box<dyn std::error::Error>> {
+    /// let mut scanner = Scanner::new("$x = 10");
+    /// let tokens = scanner.scan_tokens()?;
     /// let mut parser = Parser::new(tokens);
     /// let program = parser.parse()?;
     /// // program.statements contains the AST
+    /// # Ok(())
+    /// # }
     /// ```
     pub fn parse(&mut self) -> Result<Program> {
         let mut statements = Vec::new();

crates/ovsm/src/runtime/evaluator.rs

@@ -20,6 +20,7 @@ use std::sync::Arc;
 /// use ovsm::parser::Parser;
 /// use ovsm::lexer::Scanner;
 ///
+/// # fn main() -> Result<(), Box<dyn std::error::Error>> {
 /// let code = "$x = 10 + 20\nRETURN $x";
 /// let mut scanner = Scanner::new(code);
 /// let tokens = scanner.scan_tokens()?;
@@ -28,6 +29,8 @@ use std::sync::Arc;
 ///
 /// let mut evaluator = Evaluator::new();
 /// let result = evaluator.execute(&program)?;  // Returns Value::Int(30)
+/// # Ok(())
+/// # }
 /// ```
 ///
 /// # Architecture
@@ -80,8 +83,11 @@ impl Evaluator {
     /// # Example
     ///
     /// ```rust
-    /// let mut registry = ToolRegistry::new();
-    /// registry.register("MY_TOOL", Box::new(MyCustomTool));
+    /// use ovsm::runtime::Evaluator;
+    /// use ovsm::tools::ToolRegistry;
+    ///
+    /// let registry = ToolRegistry::new();
+    /// // registry.register("MY_TOOL", Box::new(MyCustomTool));
     /// let evaluator = Evaluator::with_registry(registry);
     /// ```
     pub fn with_registry(registry: ToolRegistry) -> Self {
@@ -106,12 +112,26 @@ impl Evaluator {
     /// # Example
     ///
     /// ```rust
+    /// use ovsm::runtime::{Evaluator, Value};
+    /// use ovsm::parser::Parser;
+    /// use ovsm::lexer::Scanner;
+    ///
+    /// # fn main() -> Result<(), Box<dyn std::error::Error>> {
+    /// let code = "RETURN 42";
+    /// let mut scanner = Scanner::new(code);
+    /// let tokens = scanner.scan_tokens()?;
+    /// let mut parser = Parser::new(tokens);
+    /// let program = parser.parse()?;
+    ///
+    /// let mut evaluator = Evaluator::new();
     /// let result = evaluator.execute(&program)?;
     /// match result {
     ///     Value::Int(n) => println!("Result: {}", n),
     ///     Value::Null => println!("No return value"),
     ///     _ => println!("Other type"),
     /// }
+    /// # Ok(())
+    /// # }
     /// ```
     pub fn execute(&mut self, program: &Program) -> Result<Value> {
         for stmt in &program.statements {

docker-build.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+# Docker build script for osvm-cli that works with Tailscale VPN
+#
+# This script uses --network=host to allow Docker builds to use
+# the host's network stack, which includes Tailscale DNS resolution.
+
+set -e
+
+echo "🐳 Building osvm-cli Docker image..."
+echo "📡 Using host network (Tailscale-compatible)"
+
+docker build \
+  --network=host \
+  -t osvm-cli \
+  "$@" \
+  .
+
+echo "✅ Build complete!"
+echo ""
+echo "Run with: docker run --rm osvm-cli --help"
+echo "Or: docker run --rm osvm-cli --version"