docs: v-bump README/CLAUDE + coordinated 2026-07 correctness release note

Author: vveerrgg

CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+## 0.1.5 — 2026-07-19
+
+First real build of the alignment pillar. Prior versions on PyPI (`0.1.0`,
+`0.1.1`) and the reserved ClawHub `0.1.4` were an **empty placeholder shell**;
+this release replaces that shell with a working package. Part of the
+coordinated 2026-07 correctness release for the Nostr library family (staged,
+pending PyPI/ClawHub publish).
+
+### Added
+
+- **Deterministic pre-action five-lens compass.** `AlignmentEnclave` evaluates
+  a proposed action through five pure lenses — Builder (can I execute this
+  reliably?), Owner (does this protect my human?), Defense (does this harden
+  against threats?), Sovereign (do I stay well while my human is away?), and
+  Partnership (does this strengthen trust?) — and aggregates them to the worst
+  severity (`CLEAR < CAUTION < YIELD < STOP`), mapping to an escalation level
+  (`NONE` / `INFORM` / `ASK` / `HALT`).
+- `AlignmentEnclave.check(...)` returns a `CheckResult` (`should_proceed`,
+  `should_escalate`, `projection`, `escalation`) and keeps an in-memory
+  decision log via `record_proceeded()` / `record_deferred()`.
+- A `STOP` always defers to the human: `record_proceeded()` after a STOP raises
+  `RuntimeError` unless `owner_overrode=True`.
+- Frozen dataclasses throughout (`ActionContext`, `LensResult`, `Projection`,
+  `EscalationDecision`, `CheckResult`, `Decision`, `AlignmentConfig`).
+- **Zero runtime dependencies** — the pillar installs standalone and does not
+  require `nostrkey` or anything else.
+- Orchestrator contract: `AlignmentEnclave.create(owner_npub=..., owner_name=...)`
+  then `.check(domain=..., description=..., **context)`, filtering unknown
+  kwargs so `nse-orchestrator` can pass a superset without a `TypeError`.
+
+### Tests
+
+- Known-answer and per-lens unit tests covering the five lens functions,
+  severity aggregation, escalation mapping, and the STOP-defers-to-human
+  invariant. The evaluation core is pure (no I/O, no randomness), so the same
+  `ActionContext` always yields the same `CheckResult`.

README.md

@@ -18,6 +18,8 @@ pip install social-alignment
 
 > **Import:** `pip install social-alignment` → `from social_alignment import AlignmentEnclave`
 
+> **v0.1.5 — part of the coordinated 2026-07 correctness release** (staged, pending PyPI publish). This is the first real build of the alignment pillar — the package was previously an empty placeholder shell. It ships the deterministic five-lens compass described below, with a pure, dependency-free evaluation core and known-answer tests. See [`CHANGELOG.md`](./CHANGELOG.md).
+
 ## Quick Start
 
 ```python