Merge pull request #17 from MB3R-Lab/feat/mvp-bootstrap-contract

docs: position Bering as general model producer

Author: a-a-k

README.md

@@ -1,10 +1,8 @@
 # Bering
 
-Bering is the upstream model discovery tool for Sheaft.
-It consumes trace artifacts and produces canonical `bering-model.json` in
-`BeringResilienceModel` v1.0.0 contract format.
+Bering builds a resilience model artifact from trace artifacts. The output artifact is `bering-model.json` in `BeringResilienceModel` v1.0.0 format. Use it in any downstream tooling or analytics pipeline.
 
-## Contract (strict)
+## Contract
 
 Bering pins `metadata.schema` exactly:
 
@@ -25,7 +23,7 @@ internal/discovery            model inference from normalized spans
 internal/model                model structs, semantic checks, canonical IO
 internal/schema               pinned contract constants + JSON Schema validation
 internal/jsoncanon            deterministic recursive JSON encoder
-api/schema                    canonical public schema
+api/schema                    versioned public schema
 configs                       sample configs (replicas override)
 examples                      trace fixtures + expected output artifacts
 docs                          format, heuristic, and MVP limits
@@ -57,16 +55,21 @@ go run ./cmd/bering validate \
   --input examples/outputs/bering-model.normalized.sample.json
 ```
 
-### 3) Run Sheaft manually on generated model
-
-```bash
-# from sibling Sheaft repository
-go run ./cmd/sheaft run \
-  --model ../Bering/examples/outputs/bering-model.normalized.sample.json \
-  --policy configs/gate.policy.example.yaml \
-  --out-dir out \
-  --seed 42
-```
+### 3) Use the model in any downstream tool
+
+Examples:
+
+- run your own analytics (topology checks, risk scoring, SLO diagnostics)
+- feed the model into simulation tooling
+- simulate failures with [Sheaft](https://github.com/MB3R-Lab/Sheaft) (one possible consumer), for example:
+  ```bash
+  # from sibling Sheaft repository
+  go run ./cmd/sheaft run \
+    --model ../Bering/examples/outputs/bering-model.normalized.sample.json \
+    --policy configs/gate.policy.example.yaml \
+    --out-dir out \
+    --seed 42
+  ```
 
 ## Deterministic output
 

docs/mvp-scope-and-limits.md

@@ -3,7 +3,7 @@
 ## In scope
 
 - Discover model from trace files/directories.
-- Emit Sheaft-compatible `bering-model.json` (v1.0.0 contract).
+- Emit contract-compliant `bering-model.json` (v1.0.0) compatible with Sheaft and other downstream analytics tools.
 - Validate artifact with strict `metadata.schema` match.
 - Deterministic output ordering and canonical JSON serialization.
 
@@ -28,4 +28,3 @@ Result is clamped to `[0,1]` and rounded to 2 decimals.
 
 This score is informational in MVP and should not be interpreted as a calibrated
 probability of correctness.
-