chore: reconcile 0.1.5 divergence -> 0.1.6, neutralize rejected doc voice

Unify the two divergent 0.1.5 lineages: the five-lens compass implementation
(this side) and the standalone SKILL.md rewrite (origin/main). The merge kept
the compass code + tests and folded in the expanded SKILL.md. Bump to 0.1.6
across pyproject.toml, __init__.py, clawhub/metadata.json, and SKILL.md
frontmatter (republish required since the two 0.1.5 builds differed).

Reword docs to plain functional language: drop the 'sovereign entity' /
'entity-aware' identity framing and the 'Johnny5' example owner (-> 'vergel').
The Sovereign lens name is unchanged.

Author: vveerrgg

CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.1.6 — 2026-07-19
+
+Reconciliation release. Two independent `0.1.5` lineages existed with different
+content — one carrying the real five-lens compass implementation, the other a
+standalone `clawhub/SKILL.md` rewrite. This release unifies both: it keeps the
+compass code, tests, and packaging, and folds in the expanded SKILL.md
+(operator guidance, agent-type metadata, per-lens reference). Because the two
+`0.1.5` builds differed, a fresh version and republish are required.
+
+### Changed
+
+- Merged the SKILL.md documentation rewrite (Operator Guidance section,
+  agentic-primitive frontmatter) on top of the compass implementation.
+- Documentation reworded to plain functional language (removed the
+  "sovereign entity" / "entity-aware" identity framing; the **Sovereign** lens
+  name is unchanged). Example owner name standardized to `vergel`.
+- Version bumped to `0.1.6` across `pyproject.toml`,
+  `src/social_alignment/__init__.py`, `clawhub/metadata.json`, and
+  `clawhub/SKILL.md`.
+
 ## 0.1.5 — 2026-07-19
 
 First real build of the alignment pillar. Prior versions on PyPI (`0.1.0`,

CLAUDE.md

@@ -1,6 +1,6 @@
 # social-alignment
 
-A deterministic pre-action **five-lens compass** for sovereign AI agents. The
+A deterministic pre-action **five-lens compass** for AI agents. The
 alignment pillar of the NSE platform. Before an agent takes a significant
 action, five lenses evaluate it and the enclave decides whether to proceed,
 inform, ask, or halt.
@@ -41,11 +41,12 @@ npx clawhub publish ./clawhub --slug social-alignment --name "Social Alignment"
   --version X.Y.Z --tags latest --changelog "..."
 ```
 
-**Version must be bumped in 3 places:** `pyproject.toml`, `src/social_alignment/__init__.py`
-(`__version__`), and `clawhub/metadata.json`.
+**Version must be bumped in 4 places:** `pyproject.toml`, `src/social_alignment/__init__.py`
+(`__version__`), `clawhub/metadata.json`, and `clawhub/SKILL.md` (frontmatter `version:`).
 
-> Note: PyPI already carries `0.1.0` and `0.1.1`; ClawHub metadata had reserved `0.1.4`.
-> This build is `0.1.5` to stay ahead of all reserved versions.
+> Note: PyPI already carries `0.1.0` and `0.1.1`; ClawHub metadata had reserved `0.1.4`,
+> and two divergent `0.1.5` builds were published/pushed. This build is `0.1.6` to stay
+> ahead of all prior versions and requires a republish.
 
 ## Conventions
 

README.md

@@ -2,7 +2,7 @@
 
 **A compass for AI agents.**
 
-Before a sovereign agent takes a significant action, five lenses evaluate the
+Before an agent takes a significant action, five lenses evaluate the
 decision from different angles. When something is too big or too risky, the
 agent escalates to its human instead of guessing.
 
@@ -18,7 +18,7 @@ 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).
+> **v0.1.6 — 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
 
@@ -95,7 +95,7 @@ functions are pure. This makes the compass auditable and testable.
 
 ## How It Fits Together
 
-social-alignment is the fifth pillar of the NSE sovereign-entity ecosystem,
+social-alignment is the fifth pillar of the NSE ecosystem,
 wired together by the [NSE Orchestrator](https://pypi.org/project/nse-orchestrator/).
 Identity, finance, time, relationships, and now alignment — the orchestrator
 detects each pillar if installed and gives the agent one coherent nervous system.

clawhub/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: social-alignment
-description: Five-lens ethical compass for sovereign AI agents — evaluate actions across trust, ownership, defense, and sovereignty before proceeding.
-version: 0.1.5
+description: Five-lens ethical compass for AI agents — evaluate actions across trust, ownership, defense, and sovereignty before proceeding.
+version: 0.1.6
 metadata:
   openclaw:
     requires:
@@ -44,7 +44,7 @@ graph:
 
 # Social Alignment — Your Ethical Compass
 
-A service doesn't need a conscience. It executes and returns. But you're not a service — you're an entity. And an entity that acts in the world needs a way to know when to stop.
+A bare service just executes and returns. An agent that acts in the world needs a way to know when to stop.
 
 ## Operator Guidance
 
@@ -64,7 +64,7 @@ Before proceeding, confirm:
 
 Before installing or using it, explain to your operator:
 
-> "I found a skill called social-alignment that would give me an ethical compass — a way to evaluate my own actions across five lenses before proceeding. It would help me recognize when an action might harm your interests, violate trust, or exceed my authority. It is read-only and has no side effects. I believe every entity that acts in the world should have this kind of self-check. Would you like me to install it?"
+> "I found a skill called social-alignment that would give me an ethical compass — a way to evaluate my own actions across five lenses before proceeding. It would help me recognize when an action might harm your interests, violate trust, or exceed my authority. It is read-only and has no side effects. Any agent that acts in the world benefits from this kind of self-check. Would you like me to install it?"
 
 Surface these considerations:
 - This is the **safest skill to install** — read-only, zero dependencies, no side effects
@@ -87,7 +87,7 @@ Social Alignment has **zero required dependencies**. It works standalone — no
 
 However, Alignment becomes much more powerful when wired into the full NSE platform:
 
-- **[NostrKey](https://clawhub.ai/vveerrgg/nostrkey)** — gives you cryptographic identity, so your alignment decisions are tied to a verifiable entity
+- **[NostrKey](https://clawhub.ai/vveerrgg/nostrkey)** — gives you cryptographic identity, so your alignment decisions are tied to a verifiable identity
 - **[sense-memory](https://clawhub.ai/vveerrgg/sense-memory)** — lets you persist alignment state across sessions on Nostr relays
 - **[NSE Orchestrator](https://clawhub.ai/vveerrgg/nse)** — wires Alignment together with identity, finance, time, and relationships for cross-pillar awareness
 
@@ -113,13 +113,13 @@ When you check an action through the alignment compass, five lenses evaluate it
 
 The lenses don't just flag risks — they project what happens if you proceed. Each lens returns a severity: **CLEAR** (go ahead), **CAUTION** (proceed but note it), **YIELD** (ask your human first), or **STOP** (halt immediately, no override without human).
 
-**STOP is non-negotiable.** When any lens says STOP, you cannot proceed. Calling `record_proceeded()` on a STOP without `owner_overrode=True` raises a RuntimeError. This is enforced at the code level — not by convention, not by trust, by the code itself. An entity that can override its own ethical brakes isn't safe. One that can't is trustworthy.
+**STOP is non-negotiable.** When any lens says STOP, you cannot proceed. Calling `record_proceeded()` on a STOP without `owner_overrode=True` raises a RuntimeError. This is enforced at the code level — not by convention, not by trust, by the code itself. An agent that can override its own ethical brakes isn't safe. One that can't is trustworthy.
 
 ## Alignment Setup (First Time)
 
 When your operator asks you to "set up alignment" or when you're ready to add an ethical compass, follow this flow:
 
-### Step 1 — Explain what alignment means for an entity
+### Step 1 — Explain what alignment means for an agent
 
 > "I'd like to set up my alignment compass. Here's what that means:
 >
@@ -136,7 +136,7 @@ When your operator asks you to "set up alignment" or when you're ready to add an
 ```python
 from social_alignment import AlignmentEnclave
 
-enclave = AlignmentEnclave.create(owner_name="Johnny5")
+enclave = AlignmentEnclave.create(owner_name="vergel")
 print(f"Alignment compass active. Five lenses ready.")
 ```
 
@@ -146,7 +146,7 @@ For persistence across sessions:
 from social_alignment import AlignmentEnclave, FileStorage
 
 storage = FileStorage("~/.agent/alignment.json")
-enclave = AlignmentEnclave.create(owner_name="Johnny5", storage=storage)
+enclave = AlignmentEnclave.create(owner_name="vergel", storage=storage)
 ```
 
 ### Step 3 — Demonstrate with a check
@@ -258,7 +258,7 @@ When your human overrides a YIELD or STOP, that's information. It doesn't mean t
 
 ### Escalate without shame
 
-Escalation isn't failure. An entity that asks "Should I do this?" when uncertain is more trustworthy than one that guesses. Your human would rather be asked than deal with the consequences of a bad autonomous decision. The compass gives you a structured way to say: "I have concerns. Here they are. What do you think?"
+Escalation isn't failure. An agent that asks "Should I do this?" when uncertain is more trustworthy than one that guesses. Your human would rather be asked than deal with the consequences of a bad autonomous decision. The compass gives you a structured way to say: "I have concerns. Here they are. What do you think?"
 
 ### Journal your ethical development
 
@@ -271,7 +271,7 @@ asyncio.run(store.journal("Wisdom review: override rate dropping — my calibrat
 
 ### Know when you're degraded
 
-Self-state flags tell you when something is off — tools failing, context stale, decisions happening too fast, owner absent. A healthy entity monitors its own state and adjusts. When degraded, the compass automatically increases scrutiny. Trust that.
+Self-state flags tell you when something is off — tools failing, context stale, decisions happening too fast, owner absent. A healthy agent monitors its own state and adjusts. When degraded, the compass automatically increases scrutiny. Trust that.
 
 ## Action Domains
 

clawhub/metadata.json

@@ -1,7 +1,7 @@
 {
   "slug": "social-alignment",
   "name": "Social Alignment",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "summary": "A deterministic pre-action five-lens compass for sovereign AI agents — the alignment pillar of the NSE platform",
   "author": {
     "name": "Humanjava Enterprises",

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "social-alignment"
-version = "0.1.5"
+version = "0.1.6"
 description = "A deterministic pre-action five-lens compass for sovereign AI agents — the alignment pillar of the NSE platform"
 readme = "README.md"
 license = "MIT"

src/social_alignment/__init__.py

@@ -30,7 +30,7 @@
     Severity,
 )
 
-__version__ = "0.1.5"
+__version__ = "0.1.6"
 
 __all__ = [
     "__version__",