feat(s36): PricingContract + fail-fast loader + placeholder path + quality guidance

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0145ZKPLMVeqM47z2jxxokym

src/portfolio_optimiser/costsim.py

@@ -21,8 +21,15 @@ from __future__ import annotations
 import json
 from pathlib import Path
 
+from pydantic import BaseModel, Field
+
 _DATA_DIR = Path(__file__).resolve().parent / "data"
 _MODEL_MAP_FILE = _DATA_DIR / "model_map.json"
+_PRICING_FILE = _DATA_DIR / "pricing.example.json"
+
+# A model-map deployment id that the operator has not yet replaced (data/model_map.json ships the
+# azure roles as REPLACE-WITH-FOUNDRY-DEPLOYMENT). Such ids are UNPRICED, not an error.
+PLACEHOLDER_PREFIX = "REPLACE-WITH-"
 
 
 def _load_model_map(
@@ -44,3 +51,54 @@ def _load_model_map(
     if not isinstance(entry, dict):
         raise ValueError(f"unknown profile {profile!r} in model map")
     return dict(entry)
+
+
+class QualityGuidance(BaseModel):
+    """Per-model quality trade-off as GUIDANCE WITH SOURCE (brief Goal 4 / D-I pkt. 3): prose
+    ``note`` + a provenance ``source`` — never a bare measured number. This keeps a quality claim
+    honest (veiledning med kilde), never asserted as measured fact without belegg (målbilde §1)."""
+
+    note: str = Field(min_length=1)
+    source: str = Field(min_length=1)
+
+
+class ModelPrice(BaseModel):
+    """A model's blended price in INTEGER øre per 1000 total tokens (float NOK is banned — see
+    ``ledger.py``). ``quality_guidance`` is optional sourced prose, never a number."""
+
+    ore_per_1k_tokens: int = Field(ge=0)
+    quality_guidance: QualityGuidance | None = None
+
+
+class PricingContract(BaseModel):
+    """Schema-validated pricing config (fail-fast). ``source`` + ``date`` are REQUIRED provenance
+    (kilde + dato) — the framework ships an example; the deployer owns verified vendor prices."""
+
+    source: str = Field(min_length=1)
+    date: str = Field(min_length=1)
+    models: dict[str, ModelPrice]
+
+
+def load_pricing(path: str | Path | None = None) -> PricingContract:
+    """Load + validate pricing config, fail-fast. Missing file → ``FileNotFoundError``;
+    malformed / missing ``source``/``date`` → ``pydantic.ValidationError`` (mirrors
+    ``contracts.load_goal_config``). ``None`` loads the packaged ``data/pricing.example.json``.
+    Top-level ``_``-prefixed keys (e.g. ``_note``) are ignored."""
+    p = Path(path) if path is not None else _PRICING_FILE
+    if not p.is_file():
+        raise FileNotFoundError(f"pricing config not found: {str(p)!r}")
+    raw = json.loads(p.read_text(encoding="utf-8"))
+    data = {k: v for k, v in raw.items() if not k.startswith("_")}
+    return PricingContract(**data)
+
+
+def _price_ore_per_1k(model: str, pricing: PricingContract) -> int | None:
+    """Return ``model``'s øre-per-1k-tokens rate. Returns ``None`` for a placeholder deployment id
+    (``REPLACE-WITH-*`` — the defined unpriced path; azure profile ships these). Fail-fast
+    (``ValueError``) for a genuine (non-placeholder) model absent from the price map."""
+    if model.startswith(PLACEHOLDER_PREFIX):
+        return None
+    entry = pricing.models.get(model)
+    if entry is None:
+        raise ValueError(f"missing price for {model}")
+    return entry.ore_per_1k_tokens

src/portfolio_optimiser/data/pricing.example.json

@@ -0,0 +1,28 @@
+{
+  "_note": "S3.6 EXAMPLE prices — kr/1k tokens as INTEGER øre (blended total-token rate, matching the runtime meter's total_token_count). The framework ships this example; the DEPLOYER owns verified vendor prices (replace values, keep source+date honest). quality_guidance is sourced GUIDANCE, never a measured number. Azure ids below are forward-looking examples the deployer activates once they replace the REPLACE-WITH-FOUNDRY-DEPLOYMENT placeholder in model_map.json.",
+  "source": "Framework example prices (UNVERIFIED) — deployer MUST replace with vendor prices + kilde/dato",
+  "date": "2026-07-15",
+  "models": {
+    "qwen3:4b": {
+      "ore_per_1k_tokens": 0,
+      "quality_guidance": {
+        "note": "Lokal Ollama-modell: gratis, ingen egress (D6). Lavere resonnering enn frontier-modeller — egnet for billige, høy-volum utkast, ikke kritisk falsifisering.",
+        "source": "Ollama model card qwen3:4b (2026-07-15)"
+      }
+    },
+    "gpt-4o-mini": {
+      "ore_per_1k_tokens": 15,
+      "quality_guidance": {
+        "note": "Rimelig frontier-klasse; god kost/kvalitet for proposer-rollen. Eksempelpris — verifiser mot Azure OpenAI-prisliste før bruk.",
+        "source": "Azure OpenAI pricing (EXAMPLE, unverified) (2026-07-15)"
+      }
+    },
+    "gpt-5-mini": {
+      "ore_per_1k_tokens": 40,
+      "quality_guidance": {
+        "note": "Sterkere resonnering enn 4o-mini; egnet for checker-rollen der falsifisering er kritisk. Eksempelpris — verifiser før bruk.",
+        "source": "Azure OpenAI pricing (EXAMPLE, unverified) (2026-07-15)"
+      }
+    }
+  }
+}