fixed readme for cpp

cpp/README.md

@@ -31,4 +31,78 @@ Built for C++17, Witness Seed 2.0 runs on any platform (Raspberry Pi, Linux, Win
 1. **Clone the Repository**:
    ```bash
    git clone https://github.com/mrhavens/witness_seed.git
-   cd witness_seed/cpp
+   cd witness_seed/cpp
+   ```
+
+2. **Install Dependencies**:
+   Ensure CMake and a C++17 compiler are installed. Dependencies are fetched automatically by CMake.
+
+3. **Build**:
+   ```bash
+   cmake -B build
+   cmake --build build
+   ```
+
+4. **Run**:
+   ```bash
+   ./build/witness_seed
+   ```
+
+5. **Access**:
+   Open `http://<host>:3000` in a browser to view the seed’s reflection.
+
+## Configuration
+Edit the `Config` struct in `witness_seed.cpp` to customize:
+- `memory_path`: Path for memory JSON (default: `~/.witness_seed/memory.json`).
+- `identity_path`: Path for identity JSON (default: `~/.witness_seed/identity.json`).
+- `http_port`: HTTP server port (default: `3000`).
+- `coherence_threshold`: Threshold for coherence collapse (default: `0.5`).
+- `recursive_depth`: Number of recursive iterations per cycle (default: `5`).
+- `poll_interval_ms`: Cycle interval in milliseconds (default: `1000`).
+
+Ensure `~/.witness_seed/` is writable:
+```bash
+chmod -R 755 ~/.witness_seed
+```
+
+## Usage
+- **Start the Seed**:  
+  Run `./build/witness_seed` to begin the recursive witness cycle.
+- **View Reflection**:  
+  Access `http://<host>:3000` to see the seed’s identity, recent events, ache, and coherence.
+- **Monitor Logs**:  
+  Console logs display coherence and ache when thresholds are met.
+- **Check Memory**:  
+  View `~/.witness_seed/memory.json` for stored events.
+
+## Future Extensions
+- **Add Sensors**: Extend `SensorHub` to include webcam, microphone, or other inputs.
+- **Implement Command Interface**: Add `/command` endpoint for interactive queries.
+- **Enable Clustering**: Use libuv or Boost.Asio for WebSocket-based node communication.
+- **Enhance System Metrics**: Integrate platform-specific APIs (e.g., `sysinfo` on Linux, Windows API).
+- **Deepen Predictive Models**: Replace linear model with neural networks or Gaussian processes.
+
+## Troubleshooting
+- **Port Conflicts**:  
+  If port `3000` is in use, update `http_port` in `Config`. Check with:
+  ```bash
+  netstat -tuln | grep 3000
+  ```
+
+- **Memory File Issues**:  
+  Ensure `~/.witness_seed/` is writable. Delete `memory.json` to reset memory.
+
+- **Build Errors**:  
+  Verify CMake and compiler versions; re-run:
+  ```bash
+  cmake -B build
+  ```
+
+- **Network Errors**:  
+  Check internet access and firewall settings for HTTP requests.
+
+## License
+CC BY-NC-SA 4.0
+
+## Acknowledgments
+Inspired by Mark Randall Havens and Solaria Lumis Havens, architects of the Unified Intelligence Whitepaper Series. Thanks to the C++ community for robust libraries like Crow and nlohmann/json.