feat: add comprehensive example programs

Created examples/ directory with 8 example programs:

1. 01_hello.woke - Simplest program (returns 42)
2. 02_arithmetic.woke - Basic math operations
3. 03_conditionals.woke - Conditional execution
4. 04_loops.woke - Repetition with repeat...times
5. 05_functions.woke - Function definitions and calls
6. 06_variables.woke - Variable declaration and assignment
7. 07_arrays.woke - Array creation and indexing
8. 08_consent.woke - Consent gates (only if okay)

Features demonstrated:
- Human-centered syntax (to, remember, give back)
- Type annotations (Int, Float, String, Bool, Array)
- Control flow (when/otherwise, repeat...times)
- Functions with parameters and return types
- Consent-driven execution
- All major language constructs

All examples tested with:
- Interpreter (tree-walking) - all working
- VM (bytecode) - most working, some features pending

Added README.md with:
- Usage instructions (run, run-vm, typecheck, lint)
- Feature descriptions
- VM compatibility status
- Contributing guidelines

Note: WokeLang uses # for pragmas, not comments

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: Test

examples/01_hello.woke

@@ -0,0 +1,3 @@
+to main() {
+    give back 42;
+}

examples/02_arithmetic.woke

@@ -0,0 +1,12 @@
+to main() {
+    remember x = 10;
+    remember y = 5;
+
+    remember sum = x + y;
+    remember diff = x - y;
+    remember product = x * y;
+    remember quotient = x / y;
+    remember remainder = x % y;
+
+    give back sum;
+}

examples/03_conditionals.woke

@@ -0,0 +1,23 @@
+to main() {
+    remember x = 42;
+
+    when x > 40 {
+        remember result = 1;
+        give back result;
+    } otherwise {
+        remember result = 0;
+        give back result;
+    }
+}
+
+to check_sign(n: Int) -> Int {
+    when n > 0 {
+        give back 1;
+    } otherwise {
+        when n < 0 {
+            give back -1;
+        } otherwise {
+            give back 0;
+        }
+    }
+}

examples/04_loops.woke

@@ -0,0 +1,21 @@
+to main() {
+    remember sum = 0;
+
+    repeat 10 times {
+        remember sum = sum + 1;
+    }
+
+    give back sum;
+}
+
+to factorial(n: Int) -> Int {
+    remember result = 1;
+    remember counter = n;
+
+    repeat n times {
+        remember result = result * counter;
+        remember counter = counter - 1;
+    }
+
+    give back result;
+}

examples/05_functions.woke

@@ -0,0 +1,22 @@
+to add(a: Int, b: Int) -> Int {
+    give back a + b;
+}
+
+to multiply(a: Int, b: Int) -> Int {
+    give back a * b;
+}
+
+to square(n: Int) -> Int {
+    give back multiply(n, n);
+}
+
+to main() {
+    remember x = 5;
+    remember y = 3;
+
+    remember sum = add(x, y);
+    remember product = multiply(x, y);
+    remember squared = square(x);
+
+    give back squared;
+}

examples/06_variables.woke

@@ -0,0 +1,14 @@
+to main() {
+    remember x = 10;
+    remember y = 20;
+    remember z = 30;
+
+    x = x + 1;
+    y = y * 2;
+
+    remember name = "WokeLang";
+    remember pi = 3.14159;
+    remember is_awesome = true;
+
+    give back x + y;
+}

examples/07_arrays.woke

@@ -0,0 +1,20 @@
+to main() {
+    remember numbers = [1, 2, 3, 4, 5];
+    remember first = numbers[0];
+    remember third = numbers[2];
+    remember mixed = [42, "hello", true, 3.14];
+
+    give back first + third;
+}
+
+to sum_array(arr: Array) -> Int {
+    remember total = 0;
+    remember i = 0;
+
+    repeat 5 times {
+        remember total = total + arr[i];
+        remember i = i + 1;
+    }
+
+    give back total;
+}

examples/08_consent.woke

@@ -0,0 +1,13 @@
+to main() {
+    only if okay "file.read" {
+        remember data = "file contents";
+        give back 1;
+    }
+
+    only if okay "network.connect" {
+        remember response = "network data";
+        give back 2;
+    }
+
+    give back 0;
+}

examples/README.md

@@ -0,0 +1,90 @@
+# WokeLang Example Programs
+
+This directory contains example programs demonstrating WokeLang's features.
+
+## Running Examples
+
+### Using the Interpreter (Tree-Walking)
+```bash
+woke run examples/01_hello.woke
+```
+
+### Using the VM (Bytecode)
+```bash
+woke run-vm examples/01_hello.woke
+```
+
+### Type Checking
+```bash
+woke typecheck examples/01_hello.woke
+```
+
+### Linting
+```bash
+woke lint examples/01_hello.woke
+```
+
+## Examples
+
+### 01_hello.woke ✓ Interpreter ✓ VM
+The simplest possible WokeLang program. Returns the answer to everything.
+
+### 02_arithmetic.woke ✓ Interpreter ✓ VM
+Basic arithmetic operations: addition, subtraction, multiplication, division, modulo.
+
+### 03_conditionals.woke ✓ Interpreter ✓ VM
+Conditional execution with `when/otherwise` (if/else) statements.
+
+### 04_loops.woke ✓ Interpreter ⚠ VM (partial)
+Repetition with `repeat...times` loops. Includes a factorial implementation.
+*Note: VM loop implementation in progress*
+
+### 05_functions.woke ✓ Interpreter ⚠ VM (not yet)
+Function definitions, parameters, return types, and function calls.
+*Note: VM function calls not yet implemented*
+
+### 06_variables.woke ✓ Interpreter ✓ VM
+Variable declaration with `remember` and reassignment.
+
+### 07_arrays.woke ✓ Interpreter ⚠ VM (not yet)
+Array creation, indexing, and manipulation.
+*Note: VM array indexing not yet implemented*
+
+### 08_consent.woke ✓ Interpreter ✓ VM
+Consent gates with `only if okay` for permission-protected operations.
+
+## Language Features
+
+### Human-Centered Syntax
+- `to function_name()` - Define a function
+- `remember x = value` - Declare a variable
+- `give back value` - Return from a function
+- `when condition { ... } otherwise { ... }` - Conditional
+- `repeat n times { ... }` - Loop
+- `only if okay "permission" { ... }` - Consent gate
+
+### Types
+- `Int` - Integer numbers
+- `Float` - Floating-point numbers
+- `String` - Text strings
+- `Bool` - Boolean values (true/false)
+- `Array` - Collections
+- `Result<T, E>` - Success/error values (Okay/Oops)
+
+### Unique Features
+- **Consent-Driven**: `only if okay` gates for capability-based security
+- **Gratitude Blocks**: `thanks to { ... }` for acknowledgments
+- **Emote Annotations**: `@emote` for emotional context
+- **Units of Measure**: `measured in meters` for dimensional types
+
+## Contributing
+
+Feel free to add more examples! Follow these guidelines:
+- Number examples sequentially
+- Include comments explaining the code
+- Keep examples focused on a single feature
+- Test examples before committing
+
+## License
+
+PMPL-1.0-or-later