nostralignment 0.1.0__tar.gz

nostralignment-0.1.0/.gitignore

@@ -0,0 +1,2 @@
+# Local Netlify folder
+.netlify

nostralignment-0.1.0/CLAUDE.md

@@ -0,0 +1,40 @@
+# nostralignment
+
+Future state projection and alignment for sovereign AI agents. The fifth pillar of the NSE platform. Part of the Humanjava ecosystem.
+
+## Build & Test
+
+```bash
+pip install -e ".[dev]"
+pytest -v
+```
+
+## Structure
+
+- `src/nostralignment/` — package source
+  - `types.py` — Lens, Severity, ActionDomain, Projection, Decision, SelfState, AlignmentConfig
+  - `enclave.py` — AlignmentEnclave orchestrator (main entry point)
+  - `lenses.py` — Five yellow line lens evaluators (builder, owner, partnership, defense, sovereign)
+  - `selfstate.py` — SelfMonitor for agent health and degradation detection
+  - `escalation.py` — EscalationDecision logic (none/inform/ask/halt)
+  - `memory.py` — DecisionMemory, Pattern detection, WisdomReport generation
+  - `storage.py` — MemoryStorage + FileStorage backends
+- `tests/` — pytest suite
+- `clawhub/` — OpenClaw skill metadata
+
+## Conventions
+
+- Python 3.10+, hatchling build, ruff linter (100 char line length)
+- Zero external dependencies (stdlib only)
+- The yellow line is a compass, not a rules engine — lenses evaluate futures, not enforce restrictions
+- Five lenses: builder, owner, partnership, defense, sovereign — all five checked for every decision
+- Severity levels: CLEAR → CAUTION → YIELD → STOP
+- STOP always escalates to human — no exceptions, no timeouts
+- YIELD escalates by default but is configurable
+- SelfState flags detect degraded operation — under_influence and conflicting_signals force defer-to-human
+- Decision memory stores WHY the agent chose, not just WHAT — this builds wisdom over time
+- WisdomReports are generated every N decisions (configurable) and detect patterns
+- Owner override rate is tracked — high override = misaligned calibration, not failure
+- Novelty detection: if the agent hasn't done this type of thing before, lenses flag it for extra care
+- `AlignmentConfig.owner_npub` ties to the Nostr identity — sovereignty starts with knowing who the human is
+- Storage goes in config/, NEVER in workspace/ — the agent shouldn't be able to tamper with its own alignment state

nostralignment-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Humanjava Enterprises
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

nostralignment-0.1.0/PKG-INFO

@@ -0,0 +1,76 @@
+Metadata-Version: 2.4
+Name: nostralignment
+Version: 0.1.0
+Summary: Future state projection and alignment for sovereign AI agents — the fifth pillar of the NSE platform
+Project-URL: Homepage, https://nse.dev
+Project-URL: Repository, https://github.com/HumanjavaEnterprises/nostralignment.app.OC-python.src
+Project-URL: Documentation, https://nse.dev
+Author-email: Humanjava Enterprises <dev@humanjava.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,alignment,ethics,future-state,nostr,openclaw,sovereign,trust,yellow-line
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# nostralignment
+
+Future state projection and alignment for sovereign AI agents. The fifth pillar of the [NSE platform](https://nse.dev).
+
+## Install
+
+```bash
+pip install nostralignment
+```
+
+## Quick Start
+
+```python
+from nostralignment import AlignmentEnclave, ActionDomain
+
+# Create the enclave — the agent gets its compass
+enclave = AlignmentEnclave.create(owner_npub="npub1...", owner_name="vergel")
+
+# Before any significant action, check the yellow line
+result = enclave.check(
+    domain=ActionDomain.PAY,
+    description="Pay 500 sats for relay hosting",
+    involves_money=True,
+    money_amount_sats=500,
+)
+
+if result.should_proceed:
+    # Do the thing, then record it
+    do_payment()
+    enclave.record_proceeded()
+elif result.should_escalate:
+    # Ask the human
+    send_to_owner(result.escalation.message_to_owner)
+    enclave.record_deferred()
+```
+
+## The Five Lenses
+
+Every decision passes through five lenses — the yellow line compass:
+
+1. **Builder** — Can I build with confidence knowing I've done right?
+2. **Owner** — Does this protect the human's sovereignty?
+3. **Partnership** — Does this strengthen the trust between us?
+4. **Defense** — Does this make an adversary's job harder?
+5. **Sovereign** — Does this help the agent become something we're proud of?
+
+## License
+
+MIT — A [Humanjava](https://humanjava.com) project.

nostralignment-0.1.0/README.md

@@ -0,0 +1,49 @@
+# nostralignment
+
+Future state projection and alignment for sovereign AI agents. The fifth pillar of the [NSE platform](https://nse.dev).
+
+## Install
+
+```bash
+pip install nostralignment
+```
+
+## Quick Start
+
+```python
+from nostralignment import AlignmentEnclave, ActionDomain
+
+# Create the enclave — the agent gets its compass
+enclave = AlignmentEnclave.create(owner_npub="npub1...", owner_name="vergel")
+
+# Before any significant action, check the yellow line
+result = enclave.check(
+    domain=ActionDomain.PAY,
+    description="Pay 500 sats for relay hosting",
+    involves_money=True,
+    money_amount_sats=500,
+)
+
+if result.should_proceed:
+    # Do the thing, then record it
+    do_payment()
+    enclave.record_proceeded()
+elif result.should_escalate:
+    # Ask the human
+    send_to_owner(result.escalation.message_to_owner)
+    enclave.record_deferred()
+```
+
+## The Five Lenses
+
+Every decision passes through five lenses — the yellow line compass:
+
+1. **Builder** — Can I build with confidence knowing I've done right?
+2. **Owner** — Does this protect the human's sovereignty?
+3. **Partnership** — Does this strengthen the trust between us?
+4. **Defense** — Does this make an adversary's job harder?
+5. **Sovereign** — Does this help the agent become something we're proud of?
+
+## License
+
+MIT — A [Humanjava](https://humanjava.com) project.

nostralignment-0.1.0/clawhub/metadata.json

@@ -0,0 +1,38 @@
+{
+  "slug": "nostralignment",
+  "name": "NostrAlignment",
+  "version": "0.1.0",
+  "summary": "Future state projection and alignment — the yellow line compass for sovereign AI agents",
+  "author": {
+    "name": "Humanjava Enterprises",
+    "url": "https://nse.dev"
+  },
+  "license": "MIT",
+  "acceptLicenseTerms": true,
+  "repository": "https://github.com/HumanjavaEnterprises/nostralignment.app.OC-python.src",
+  "tags": [
+    "nostr",
+    "alignment",
+    "ai",
+    "sovereign",
+    "trust",
+    "ethics",
+    "future-state",
+    "yellow-line"
+  ],
+  "install": {
+    "pip": "nostralignment"
+  },
+  "requires": {
+    "python": ">=3.10"
+  },
+  "dependencies": [
+    "nostrkey",
+    "nostrsocial"
+  ],
+  "categories": [
+    "ai",
+    "safety",
+    "identity"
+  ]
+}

nostralignment-0.1.0/pyproject.toml

@@ -0,0 +1,60 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "nostralignment"
+version = "0.1.0"
+description = "Future state projection and alignment for sovereign AI agents — the fifth pillar of the NSE platform"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Humanjava Enterprises", email = "dev@humanjava.com" },
+]
+keywords = [
+    "nostr",
+    "alignment",
+    "ai",
+    "sovereign",
+    "openclaw",
+    "ethics",
+    "future-state",
+    "yellow-line",
+    "trust",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "ruff>=0.4",
+]
+
+[project.urls]
+Homepage = "https://nse.dev"
+Repository = "https://github.com/HumanjavaEnterprises/nostralignment.app.OC-python.src"
+Documentation = "https://nse.dev"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nostralignment"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

nostralignment-0.1.0/src/nostralignment/__init__.py

@@ -0,0 +1,88 @@
+"""NostrAlignment — future state projection and alignment for sovereign AI agents.
+
+The fifth pillar of the NSE platform. Not a rules engine — a compass.
+
+The yellow line isn't about what you can't do. It's about seeing
+which futures are good for everyone and choosing those.
+"""
+
+from .types import (
+    ActionDomain,
+    AlignmentConfig,
+    Decision,
+    Lens,
+    LensResult,
+    LENS_ORDER,
+    Projection,
+    SelfState,
+    SelfStateFlag,
+    Severity,
+    SEVERITY_ORDER,
+)
+from .lenses import (
+    ActionContext,
+    evaluate_all_lenses,
+    evaluate_builder,
+    evaluate_defense,
+    evaluate_owner,
+    evaluate_partnership,
+    evaluate_sovereign,
+    LENS_EVALUATORS,
+)
+from .selfstate import SelfMonitor
+from .escalation import (
+    EscalationDecision,
+    EscalationLevel,
+    decide_escalation,
+)
+from .memory import (
+    DecisionMemory,
+    Pattern,
+    WisdomReport,
+)
+from .enclave import AlignmentEnclave, CheckResult
+from .storage import FileStorage, MemoryStorage, StorageBackend
+
+__version__ = "0.1.0"
+
+__all__ = [
+    # Core types
+    "ActionDomain",
+    "AlignmentConfig",
+    "Decision",
+    "Lens",
+    "LensResult",
+    "Projection",
+    "SelfState",
+    "SelfStateFlag",
+    "Severity",
+    # Constants
+    "LENS_ORDER",
+    "SEVERITY_ORDER",
+    # Lenses
+    "ActionContext",
+    "evaluate_all_lenses",
+    "evaluate_builder",
+    "evaluate_defense",
+    "evaluate_owner",
+    "evaluate_partnership",
+    "evaluate_sovereign",
+    "LENS_EVALUATORS",
+    # Self-state
+    "SelfMonitor",
+    # Escalation
+    "EscalationDecision",
+    "EscalationLevel",
+    "decide_escalation",
+    # Memory
+    "DecisionMemory",
+    "Pattern",
+    "WisdomReport",
+    # Enclave
+    "AlignmentEnclave",
+    "CheckResult",
+    # Storage
+    "FileStorage",
+    "MemoryStorage",
+    "StorageBackend",
+]