docs: update README.md with security warning and CLI documentation enhancements

Author: jkyberneees

README.md

@@ -11,6 +11,10 @@ A Go implementation of the kMOSAIC post-quantum cryptographic library.
 - [kMOSAIC White Paper](https://github.com/BackendStack21/k-mosaic/blob/main/kMOSAIC_WHITE_PAPER.md) - Detailed technical specification and cryptographic design
 - [Developer Guide - TypeScript Reference](https://github.com/BackendStack21/k-mosaic/blob/main/DEVELOPER_GUIDE.md) - Implementation guidelines and best practices
 
+## ⚠️ Security Warning
+
+**kMOSAIC is an experimental cryptographic construction that has NOT been formally verified by academic peer review. DO NOT use in production systems protecting sensitive data.**
+
 ## Overview
 
 kMOSAIC (Key Mosaic) is a post-quantum secure cryptographic framework that combines three distinct hard mathematical problems to provide defense-in-depth security:
@@ -35,7 +39,9 @@ go get github.com/BackendStack21/k-mosaic-go
 
 ## Command-line Interface
 
-Use the `k-mosaic-cli` for common tasks such as key generation, encryption/decryption, and signing/verification. Quick cheat:
+Use the `k-mosaic-cli` for common tasks such as key generation, encryption/decryption, and signing/verification.
+
+### Quick Start
 
 ```bash
 # Install the CLI
@@ -45,9 +51,22 @@ go install github.com/BackendStack21/k-mosaic-go/cmd/k-mosaic-cli@latest
 k-mosaic-cli kem keygen -l 128 -o keys.json
 k-mosaic-cli kem encrypt -pk keys.json -m "Secret message" -o enc.json
 k-mosaic-cli kem decrypt -sk keys.json -pk keys.json -ct enc.json
+
+# Generate keys, sign, verify
+k-mosaic-cli sign keygen -l 128 -o sign.json
+k-mosaic-cli sign sign -sk sign.json -pk sign.json -m "Document" -o sig.json
+k-mosaic-cli sign verify -pk sign.json -sig sig.json
 ```
 
-Full CLI documentation and examples are available in `CLI.md` — see: [./CLI.md](CLI.md).
+### Full Documentation
+
+For comprehensive CLI documentation, installation methods, security best practices, key management workflows, and detailed command reference, see: **[CLI.md](CLI.md)**
+
+Key topics in CLI.md:
+- Installation methods (source, go install, multi-platform builds)
+- Complete encryption and signature workflows
+- Security best practices and key management
+- Troubleshooting and FAQ
 
 ## Quick Start
 
@@ -79,16 +98,16 @@ func main() {
 
 ## Benchmarks (Apple M2 Pro)
 
-| Operation       | MOS_128   |
-| --------------- | --------- |
-| KEM KeyGen      | ~6.04 ms  |
-| KEM Encapsulate | ~304 μs   |
-| KEM Decapsulate | ~337 μs   |
-| Sign KeyGen     | ~6.11 ms  |
-| Sign            | ~11.66 μs |
-| Verify          | ~2.36 ms  |
+| Operation       | MOS_128   | MOS_256   |
+| --------------- | --------- | --------- |
+| KEM KeyGen      | 6.29 ms   | 22.43 ms  |
+| KEM Encapsulate | 0.32 ms   | 0.95 ms   |
+| KEM Decapsulate | 0.38 ms   | 1.06 ms   |
+| Sign KeyGen     | 6.22 ms   | 22.49 ms  |
+| Sign            | 12.07 μs  | 21.95 μs  |
+| Verify          | 2.44 ms   | 9.13 ms   |
 
-_See [BenchmarkReport.md](BenchmarkReport.md) for full detailed benchmark results and methodology._
+_See [BenchmarkReport.md](BenchmarkReport.md) for comprehensive detailed benchmark results, performance analysis, and methodology._
 
 ## API Reference