alter-runtime 0.3.2__tar.gz → 0.3.3__tar.gz

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/.gitignore

@@ -22,7 +22,7 @@ htmlcov/
 .vscode/
 .idea/
 
-# Wave 2+ generated artefacts (local daemon state — never in the repo)
+# Generated daemon artefacts (local daemon state, never in the repo)
 *.sock
 keypair.json
 runtime.yaml

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alter-runtime
-Version: 0.3.2
+Version: 0.3.3
 Summary: ~Alter Identity Runtime - local sovereign daemon for the continuous identity field. Subscribes to per-~handle Cloudflare Durable Objects, exposes Unix socket + D-Bus + CLI surfaces, falls back gracefully to direct MCP polling.
 Project-URL: Homepage, https://truealter.com
 Project-URL: Documentation, https://truealter.com/docs/alter-runtime
@@ -110,16 +110,10 @@ filing a public issue. Non-security bugs and feature requests: email
 
 ## Status
 
-| Wave | Stream | Status |
-|------|--------|--------|
-| 1 | 1c - Daemon skeleton + `AlterClient` SDK | Shipped |
-| 2 | 2b - Subscribers, Unix socket, D-Bus, git watcher | Shipped |
-| 2 | 2c - systemd + launchd service units | Shipped |
-| 2 | 2d - First pixel: CC hook + scripts upgrade | Shipped |
-| 2 | 2e - eBPF subscriber (reference impl in `alter-ebpf`) | Shipped |
-| 3 | 3a - Cross-platform tray surfaces | Planned |
-| 3 | 3b - Windows Service + `pam_alter` stub | Planned |
-| 3 | 3c - PyPI release CI + signed binaries | Planned |
+Shipped: the daemon and `AlterClient` SDK; subscribers, the Unix socket,
+D-Bus, and the git watcher; systemd and launchd service units; the CC hook
+and scripts integration; and the eBPF subscriber (reference implementation
+in the `alter-ebpf` package).
 
 ## Install
 
@@ -179,9 +173,9 @@ alter-runtime stop
    - **HTTP/SSE** loopback at `http://127.0.0.1:<port>/events` - used by the CC hook
      and shell scripts
 
-4. **Collects ambient signals** via adapters (Wave 2):
+4. **Collects ambient signals** via adapters:
    - Git commits, branch switches, pushes (via `watchdog` on `.git/refs/heads/`)
-   - CC hook events (forwarded from `.claude/hooks/*.sh`)
+   - Editor session hook events (forwarded from local shell hooks)
    - Shell command invocations (opt-in)
    - eBPF kernel attestations (shipped; reference impl in `alter-ebpf`)
 
@@ -204,15 +198,15 @@ alter-runtime/
 │   ├── sdk/
 │   │   ├── __init__.py
 │   │   └── client.py             # AlterClient (async identity MCP client)
-│   ├── subscribers/              # (Wave 2)
+│   ├── subscribers/
 │   │   ├── do_sse.py             # primary - subscribes to handle-alter DO SSE
 │   │   └── mcp_fallback.py       # fallback - polls api.truealter.com/api/v1/mcp
-│   ├── sockets/                  # (Wave 2)
+│   ├── sockets/
 │   │   ├── unix.py               # /run/user/$UID/alter.sock
 │   │   └── dbus.py               # org.alter.Identity1
-│   ├── adapters/                 # (Wave 2)
+│   ├── adapters/
 │   │   └── git_watcher.py        # watchdog on .git/refs/heads/
-│   └── services/                 # (Wave 2)
+│   └── services/
 │       ├── systemd/alter-runtime.service
 │       ├── launchd/com.alter.runtime.plist
 │       └── windows/AlterRuntimeService.py

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/README.md

@@ -42,16 +42,10 @@ filing a public issue. Non-security bugs and feature requests: email
 
 ## Status
 
-| Wave | Stream | Status |
-|------|--------|--------|
-| 1 | 1c - Daemon skeleton + `AlterClient` SDK | Shipped |
-| 2 | 2b - Subscribers, Unix socket, D-Bus, git watcher | Shipped |
-| 2 | 2c - systemd + launchd service units | Shipped |
-| 2 | 2d - First pixel: CC hook + scripts upgrade | Shipped |
-| 2 | 2e - eBPF subscriber (reference impl in `alter-ebpf`) | Shipped |
-| 3 | 3a - Cross-platform tray surfaces | Planned |
-| 3 | 3b - Windows Service + `pam_alter` stub | Planned |
-| 3 | 3c - PyPI release CI + signed binaries | Planned |
+Shipped: the daemon and `AlterClient` SDK; subscribers, the Unix socket,
+D-Bus, and the git watcher; systemd and launchd service units; the CC hook
+and scripts integration; and the eBPF subscriber (reference implementation
+in the `alter-ebpf` package).
 
 ## Install
 
@@ -111,9 +105,9 @@ alter-runtime stop
    - **HTTP/SSE** loopback at `http://127.0.0.1:<port>/events` - used by the CC hook
      and shell scripts
 
-4. **Collects ambient signals** via adapters (Wave 2):
+4. **Collects ambient signals** via adapters:
    - Git commits, branch switches, pushes (via `watchdog` on `.git/refs/heads/`)
-   - CC hook events (forwarded from `.claude/hooks/*.sh`)
+   - Editor session hook events (forwarded from local shell hooks)
    - Shell command invocations (opt-in)
    - eBPF kernel attestations (shipped; reference impl in `alter-ebpf`)
 
@@ -136,15 +130,15 @@ alter-runtime/
 │   ├── sdk/
 │   │   ├── __init__.py
 │   │   └── client.py             # AlterClient (async identity MCP client)
-│   ├── subscribers/              # (Wave 2)
+│   ├── subscribers/
 │   │   ├── do_sse.py             # primary - subscribes to handle-alter DO SSE
 │   │   └── mcp_fallback.py       # fallback - polls api.truealter.com/api/v1/mcp
-│   ├── sockets/                  # (Wave 2)
+│   ├── sockets/
 │   │   ├── unix.py               # /run/user/$UID/alter.sock
 │   │   └── dbus.py               # org.alter.Identity1
-│   ├── adapters/                 # (Wave 2)
+│   ├── adapters/
 │   │   └── git_watcher.py        # watchdog on .git/refs/heads/
-│   └── services/                 # (Wave 2)
+│   └── services/
 │       ├── systemd/alter-runtime.service
 │       ├── launchd/com.alter.runtime.plist
 │       └── windows/AlterRuntimeService.py

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/__init__.py

@@ -1,11 +1,10 @@
 """~Alter Identity Runtime.
 
-L3 of the six-layer identity distribution surface. See the package README and
-the Strategic Decisions Register entries D-RT1 through D-RT10 (8 Apr 2026) for
+L3 of the six-layer identity distribution surface. See the package README for
 architectural context.
 """
 
 from alter_runtime.sdk.client import AlterClient
 
-__version__ = "0.3.1"
+__version__ = "0.3.3"
 __all__ = ["AlterClient", "__version__"]

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/__init__.py

@@ -14,6 +14,7 @@ runtime component.
 
 from alter_runtime.adapters.claude_jsonl_watcher import ClaudeJsonlWatcher
 from alter_runtime.adapters.git_watcher import GitWatcher
+from alter_runtime.adapters.weave_watcher import WeaveWatcher
 from alter_runtime.adapters.worktree_watcher import WorktreeWatcher
 
-__all__ = ["ClaudeJsonlWatcher", "GitWatcher", "WorktreeWatcher"]
+__all__ = ["ClaudeJsonlWatcher", "GitWatcher", "WeaveWatcher", "WorktreeWatcher"]

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/claude_jsonl_watcher.py

@@ -1,6 +1,7 @@
 """ClaudeJsonlWatcher - ambient token-usage adapter for Claude Code transcripts.
 
-Watches ``~/.claude/projects/<slug>/*.jsonl`` files with ``watchdog``.
+Watches the per-project ``*.jsonl`` transcript files under Claude Code's
+home projects directory with ``watchdog``.
 On modification, reads new lines from the persisted byte offset, parses each
 via the privacy-hard-stop ``parse_assistant_line`` function, and POSTs
 batches to the ALTER backend token-usage audit endpoint.
@@ -39,8 +40,8 @@ On file rotation (on-disk size < persisted offset), the offset is reset to 0.
 Backfill
 --------
 
-On first run, every existing ``*.jsonl`` under ``~/.claude/projects/`` is
-walked and assistant events within the last 30 days are emitted in batches of
+On first run, every existing ``*.jsonl`` under the Claude Code projects
+directory is walked and assistant events within the last 30 days are emitted in batches of
 at most 500. A 5-second sleep is inserted between batches to avoid flooding
 the backend.
 
@@ -60,15 +61,13 @@ is ``True`` (default ``False``).
 Decisions
 ---------
 
-- D-IaI-1 (Identity-as-Inference): token usage is a passive aggregate with
+- Identity-as-Inference: token usage is a passive aggregate with
   k=1 (single principal machine). The inferred signal (burn-rate by model)
   is operational telemetry, NOT psychometric inference - no clause of the
   IaI 5-point test is triggered. Return: operator visibility.
 - HTTP auth: JWT sourced from ``load_session()`` at adapter start, then
   refreshed per-POST from ``ALTER_RUNTIME_SESSION_JWT`` env var as a
-  fallback. Full auth substrate wiring (ensureFreshSession equivalent) is a
-  Wave 2 follow-up - see ``TOKEN_USAGE_AUTH_GAP`` docstring on
-  ``TokenUsageClient``.
+  fallback. See ``TokenUsageClient`` for details.
 """
 
 from __future__ import annotations
@@ -227,7 +226,7 @@ class ClaudeJsonlWatcher(Component):
         Shared :class:`EventBus` (not published to - present for Component
         symmetry and future local-signal emission).
     projects_dir:
-        Override ``~/.claude/projects/`` for testing.
+        Override the Claude Code projects directory for testing.
     """
 
     name = "claude_jsonl_watcher"
@@ -502,7 +501,7 @@ def _read_events_from_file(
 def _slug_from_path(jsonl_path: Path, projects_dir: Path) -> str:
     """Derive the project slug from the JSONL file path.
 
-    ``~/.claude/projects/<slug>/<session>.jsonl`` → ``<slug>``
+    ``<projects-dir>/<slug>/<session>.jsonl`` → ``<slug>``
     """
     try:
         relative = jsonl_path.relative_to(projects_dir)

alter_runtime-0.3.3/alter_runtime/adapters/household/__init__.py

@@ -0,0 +1,26 @@
+"""Household substrate adapters.
+
+Adapters for physical-substrate data sources on a home LAN:
+
+* :mod:`workshop_tools` (Eco-12): per-plug Wh fingerprint via MQTT.
+* :mod:`compost` (Eco-9): pile-temp curve via MQTT, plate-tag filtered.
+* :mod:`tapo_ecosystem` (Eco-14): hub-level multi-parameter composition.
+* :mod:`self_hoster` (Eco-15): own-host systemd + filesystem polling.
+
+All four apply the IaI 5-clause overlay; each ships a hard-coded
+Clause-4 banlist refused at trait-emit time.  Bands only: raw Wh, temp,
+and event counts never cross the daemon boundary upward.
+
+NOT auto-wired into :mod:`alter_runtime.daemon` startup; activation is a
+follow-up once these adapters land their implementation pass.
+"""
+
+from alter_runtime.adapters.household._base import (
+    EventBusSubscriberBase,
+    PassiveLanPollerBase,
+)
+
+__all__ = [
+    "EventBusSubscriberBase",
+    "PassiveLanPollerBase",
+]

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/_base.py

@@ -1,25 +1,23 @@
 """Shared base classes for the household adapter family.
 
-Two adapter shapes per the Phase-2 cross-pattern catalogue
-(ALTER internal Phase-2 cross-pattern catalogue):
+Two adapter shapes are shared across the household adapter family:
 
-* :class:`EventBusSubscriberBase` — subscribes to the in-process
+* :class:`EventBusSubscriberBase`: subscribes to the in-process
   :class:`~alter_runtime.subscribers.bus.EventBus` for events the
   household-bridge subscriber (or a future HA/MQTT shim) publishes from
   the maker's LAN.  Used by ``workshop_tools``, ``compost``, and
   ``tapo_ecosystem``.
-* :class:`PassiveLanPollerBase` — polls a local resource (own host,
+* :class:`PassiveLanPollerBase`: polls a local resource (own host,
   paired LAN device) on a fixed cadence.  Used by ``self_hoster``
   (degenerate-LAN: the daemon polls its own host).
 
 Both extend :class:`~alter_runtime.daemon.Component` so the supervisor
 can run them as long-lived tasks once wired in.  They deliberately stop
-short of imposing topic taxonomy, payload shape, or storage choice —
-those are per-adapter concerns.
+short of imposing topic taxonomy, payload shape, or storage choice.
+Those are per-adapter concerns.
 
-D-PROV-1 (RATIFIED 2026-05-13) governs all consumers; IaI 5-clause map
-sits in the per-adapter ``traits.py`` modules so the banlist is
-co-located with the trait emit site that enforces it.
+The IaI 5-clause map sits in the per-adapter ``traits.py`` modules so
+the banlist is co-located with the trait emit site that enforces it.
 """
 
 from __future__ import annotations
@@ -61,7 +59,7 @@ class EventBusSubscriberBase(Component):
 
     async def run(self) -> None:
         if not self.subscribe_topics:
-            self._logger.info("%s no subscribe_topics declared — idle", self.name)
+            self._logger.info("%s no subscribe_topics declared, idle", self.name)
             await self._stop_event.wait()
             return
 
@@ -82,7 +80,7 @@ class EventBusSubscriberBase(Component):
     async def _dispatch(self, payload: Any) -> None:
         try:
             await self.handle_event(payload)
-        except Exception as exc:  # pragma: no cover — defensive
+        except Exception as exc:  # pragma: no cover - defensive
             self._logger.warning("%s handle_event raised: %s", self.name, exc)
 
     @abstractmethod
@@ -97,13 +95,13 @@ class PassiveLanPollerBase(Component):
     :meth:`poll_once`.  The base supervises the poll loop, sleeps
     between iterations, and exits cleanly on shutdown.
 
-    ``self_hoster`` (Eco-15) is the canonical degenerate-LAN consumer
-    — the daemon polls its own host's systemd D-Bus + filesystem; no
+    ``self_hoster`` (Eco-15) is the canonical degenerate-LAN consumer.
+    The daemon polls its own host's systemd D-Bus + filesystem; no
     network calls cross the loopback interface.
     """
 
     name: str = "household_passive_lan_poller"
-    #: Default 6 hours per the self-hoster stub spec.
+    #: Default poll interval (6 hours).
     poll_interval_seconds: float = 6 * 60 * 60
 
     def __init__(self, config: DaemonConfig) -> None:
@@ -119,7 +117,7 @@ class PassiveLanPollerBase(Component):
             while not self._stop_event.is_set():
                 try:
                     await self.poll_once()
-                except Exception as exc:  # pragma: no cover — defensive
+                except Exception as exc:  # pragma: no cover - defensive
                     self._logger.warning("%s poll_once raised: %s", self.name, exc)
                 try:
                     await asyncio.wait_for(

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/compost/__init__.py

@@ -4,8 +4,6 @@ Subscribes to MQTT topic glob ``tapo/temp_humid/+/state``, filters to
 devices whose member-attested plate tag is ``"compost"``, and computes
 a 30-day temperature-curve patience trait (band).  Persists to
 ``~/.local/share/alter-runtime/compost.db`` (mode 600).
-
-Spec: ALTER internal - compost substrate adapter.
 """
 
 from alter_runtime.adapters.household.compost.adapter import CompostAdapter

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/compost/adapter.py

@@ -1,9 +1,9 @@
-"""Compost adapter (Eco-9) — EventBusSubscriber over MQTT, plate-tag filtered.
+"""Compost adapter (Eco-9) ; EventBusSubscriber over MQTT, plate-tag filtered.
 
 Subscribes to ``tapo/temp_humid/+/state`` events on the in-process bus
 (republished by the household-bridge from Home-Assistant / Mosquitto).
 A device only participates in compost-trait derivation if its member-
-attested plate tag equals ``"compost"`` — declared at pairing time and
+attested plate tag equals ``"compost"`` ; declared at pairing time and
 read from the payload (``plate_tag`` / ``tag`` field).
 
 Per spec §5 raw temperature traces and pile location never leave the
@@ -58,7 +58,7 @@ class CompostAdapter(EventBusSubscriberBase):
             return
         plate_tag = (payload.get("plate_tag") or payload.get("tag") or "").lower()
         if plate_tag != COMPOST_PLATE_TAG:
-            # Spec §5 — only compost-tagged sensors feed the trait.
+            # Spec §5 ; only compost-tagged sensors feed the trait.
             return
         device_id = payload.get("device_id") or payload.get("mac")
         temp_c = payload.get("temp_c") or payload.get("temperature_c")
@@ -75,7 +75,7 @@ class CompostAdapter(EventBusSubscriberBase):
         # TODO(eco-9): derive `soil_cycle_patience_band` from rolling 365-day
         #   cycle-completion ledger; gate on ≥0.6 sensor uptime over 90 days.
         # TODO(eco-9): jitter timestamps to ±15 min before any upward emit
-        #   (spec §3 — sub-hour granularity discarded).
+        #   (spec §3 ; sub-hour granularity discarded).
         # TODO(eco-9): emit trait band via self._traits once a cycle window
         #   closes; current scaffold persists samples and stops.
         await self._storage.record_sample(device_id=str(device_id), temp_c=float(temp_c), ts=ts)

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/compost/storage.py

@@ -1,4 +1,4 @@
-"""Compost storage layer — local SQLite, mode 600."""
+"""Compost storage layer ; local SQLite, mode 600."""
 
 from __future__ import annotations
 

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/compost/tests/test_adapter.py

@@ -1,4 +1,4 @@
-"""Tests for CompostAdapter — plate-tag filter + sample persistence."""
+"""Tests for CompostAdapter ; plate-tag filter + sample persistence."""
 
 from __future__ import annotations
 
@@ -53,10 +53,10 @@ async def test_adapter_drops_non_compost_tagged_event(
     )
     bus = EventBus()
     adapter = CompostAdapter(config=DaemonConfig(), bus=bus)
-    # Tagged "bedroom" — must NOT persist, must NOT raise.
+    # Tagged "bedroom" ; must NOT persist, must NOT raise.
     await adapter.handle_event(
         {"device_id": "AA:BB:CC:DD:EE:22", "plate_tag": "bedroom", "temp_c": 20.0}
     )
-    # No tag at all — also dropped.
+    # No tag at all ; also dropped.
     await adapter.handle_event({"device_id": "X", "temp_c": 20.0})
     assert await CompostStorage(db_path=db_path).sample_count() == 0

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/compost/tests/test_storage.py

@@ -1,4 +1,4 @@
-"""Tests for compost SQLite storage — mode 600 + sample insert."""
+"""Tests for compost SQLite storage ; mode 600 + sample insert."""
 
 from __future__ import annotations
 

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/compost/tests/test_traits.py

@@ -1,4 +1,4 @@
-"""Tests for compost trait emitter — Clause-4 banlist + band shape."""
+"""Tests for compost trait emitter ; Clause-4 banlist + band shape."""
 
 from __future__ import annotations
 

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/compost/traits.py

@@ -57,10 +57,9 @@ class CompostTraits:
 
     def emit(self, kind: str, band: str) -> CompostTraitEmission:
         self._refuse_if_banned(kind)
-        # TODO(clause-3-identity-income): return/x402 hook attaches here per
-        #   D-PROV-1 + clause-3 ratification.  Each emission upward is the
-        #   point at which Identity-Income return-flow is metered.  Hook
-        #   implementation lives outside this scaffold pass.
+        # TODO(clause-3-identity-income): return/x402 hook attaches here.
+        #   Each emission upward is the point at which Identity-Income
+        #   return-flow is metered.  Hook implementation is a follow-up.
         return CompostTraitEmission(kind=kind, band=band)
 
     def emit_soil_cycle_patience_band(self, band: SoilCyclePatienceBand) -> CompostTraitEmission:

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/self_hoster/__init__.py

@@ -6,9 +6,9 @@ Polls OWN host every 6 hours (degenerate-LAN; reads its own filesystem
 ``uptime_steward``.
 
 Member-authored allowlists at pairing (services / backup-repo paths /
-LE cert dirs) — those choices stay LOCAL, never surfaced upward.
+LE cert dirs) ; those choices stay LOCAL, never surfaced upward.
 
-Spec: ``phase2-wave2-stub-specs-pack-2026-05-27.md`` §6.
+Stub adapter; implementation pass is a follow-up wave.
 """
 
 from alter_runtime.adapters.household.self_hoster.adapter import (

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/self_hoster/adapter.py

@@ -1,4 +1,4 @@
-"""Self-hoster adapter (Eco-15) — PassiveLanPoller, own-host only.
+"""Self-hoster adapter (Eco-15) ; PassiveLanPoller, own-host only.
 
 Polls the LOCAL host every 6 hours.  Reads:
 
@@ -15,10 +15,10 @@ All five inputs are gated on member-authored allowlists declared at
 pairing time (services / backup repos / cert dirs).  The adapter never
 walks the filesystem outside those allowlists.
 
-V&V hardening pass (Phase-2 substrate-adapter pilot, 2026-05-28): the
-observer-execution surface — anywhere this module would invoke
+V&V hardening pass (substrate-adapter pilot): the
+observer-execution surface ; anywhere this module would invoke
 subprocess / systemctl / Path.stat / Path.iterdir against a host target
-— MUST first pass the target through :meth:`SelfHosterAdapter._invoke_observer`,
+; MUST first pass the target through :meth:`SelfHosterAdapter._invoke_observer`,
 which consults :class:`SelfHosterAllowlists` and refuses any
 out-of-allowlist target with :class:`AllowlistViolationError`.  Real
 read implementations land in follow-up passes; the guard is wired now
@@ -43,7 +43,7 @@ __all__ = [
     "SelfHosterAllowlists",
 ]
 
-#: Default 6-hour cadence per stub spec §6.
+#: Default poll cadence (6 hours).
 DEFAULT_POLL_INTERVAL_SECONDS: float = 6 * 60 * 60
 
 #: Names of the buckets on :class:`SelfHosterAllowlists` the
@@ -63,7 +63,7 @@ class AllowlistViolationError(RuntimeError):
     subprocess / systemctl / filesystem-walk call site that would touch
     something outside those lists is refused at the
     :meth:`SelfHosterAdapter._check_allowlist` guard before the
-    invocation happens — the daemon never silently reads outside the
+    invocation happens ; the daemon never silently reads outside the
     member-authored allowlist.
     """
 
@@ -130,11 +130,11 @@ class SelfHosterAdapter(PassiveLanPollerBase):
             The sub-trait kind being observed (``"backup_cadence"`` etc.).
             Used in the warning log + exception message for traceability.
         target:
-            The concrete host resource — a systemd unit name, a backup-repo
+            The concrete host resource ; a systemd unit name, a backup-repo
             ``Path``, a letsencrypt cert dir ``Path``.
         bucket:
             One of ``"systemd_units"``, ``"backup_repo_paths"``,
-            ``"letsencrypt_cert_dirs"`` — the attribute name on
+            ``"letsencrypt_cert_dirs"`` ; the attribute name on
             :class:`SelfHosterAllowlists` to consult.
 
         Raises
@@ -142,7 +142,7 @@ class SelfHosterAdapter(PassiveLanPollerBase):
         AllowlistViolationError
             If ``target`` is not in ``self._allowlists.<bucket>``.
         AttributeError
-            If ``bucket`` does not name a known attribute — surfaces a
+            If ``bucket`` does not name a known attribute ; surfaces a
             typo loudly rather than silently passing.
         """
         allowed = getattr(self._allowlists, bucket)
@@ -155,7 +155,7 @@ class SelfHosterAdapter(PassiveLanPollerBase):
             )
             raise AllowlistViolationError(
                 f"self_hoster refused observer invocation kind={kind!r} "
-                f"target={target!r} bucket={bucket!r} — target not in "
+                f"target={target!r} bucket={bucket!r} ; target not in "
                 f"member-authored allowlist"
             )
 
@@ -187,7 +187,7 @@ class SelfHosterAdapter(PassiveLanPollerBase):
         return await invocation()
 
     # ------------------------------------------------------------------
-    # Per-sub-trait observers — scaffold-level, no real reads yet
+    # Per-sub-trait observers ; scaffold-level, no real reads yet
     # ------------------------------------------------------------------
 
     async def _observe_os_update_discipline(self) -> None:
@@ -196,7 +196,7 @@ class SelfHosterAdapter(PassiveLanPollerBase):
         #   never expose package list upward, only band.
         #   When wired, route the shell-out through self._invoke_observer with
         #   a dedicated allowlist bucket (package-mgr metadata is not bound to
-        #   the existing three buckets — extend SelfHosterAllowlists first).
+        #   the existing three buckets ; extend SelfHosterAllowlists first).
         await self._storage.record_observation(
             kind="os_update_discipline", value_summary="unobserved"
         )
@@ -206,7 +206,7 @@ class SelfHosterAdapter(PassiveLanPollerBase):
         #   the snapshot directories and record latest mtime; derive 90-day
         #   cadence band downstream.
         for path in self._allowlists.backup_repo_paths:
-            # Allowlist guard exercised even at scaffold time — the iteration
+            # Allowlist guard exercised even at scaffold time ; the iteration
             # is over the allowlist itself, so the path is trivially valid.
             # The check is here so the call shape mirrors the eventual real
             # stat()-bearing invocation.
@@ -243,6 +243,6 @@ class SelfHosterAdapter(PassiveLanPollerBase):
         # TODO(eco-15): derive 30-day uptime ratio from systemd boot-list +
         #   monotonic clock; gate against allowlisted-service availability.
         #   Per-unit reads MUST go through self._invoke_observer with bucket
-        #   "systemd_units" — uptime is computed against allowlisted services
+        #   "systemd_units" ; uptime is computed against allowlisted services
         #   only, never the full unit list.
         await self._storage.record_observation(kind="uptime_steward", value_summary="unobserved")

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/self_hoster/storage.py

@@ -1,4 +1,4 @@
-"""Self-hoster storage layer — local SQLite, mode 600.
+"""Self-hoster storage layer ; local SQLite, mode 600.
 
 Persists per-sub-trait observation rows.  Schema is deliberately
 coarse: ``kind`` + a short summary string + timestamp.  Detailed

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/self_hoster/tests/test_adapter.py

@@ -1,4 +1,4 @@
-"""Tests for SelfHosterAdapter — poll_once invokes all five sub-observers."""
+"""Tests for SelfHosterAdapter ; poll_once invokes all five sub-observers."""
 
 from __future__ import annotations
 
@@ -149,7 +149,7 @@ def test_observer_refuses_out_of_allowlist_letsencrypt_dir(
 def test_observer_proceeds_for_in_allowlist_target(
     tmp_path: Path, monkeypatch: pytest.MonkeyPatch
 ) -> None:
-    """Positive control — in-allowlist targets across all three buckets pass."""
+    """Positive control ; in-allowlist targets across all three buckets pass."""
     backup_path = Path("/tmp/restic-fake")
     le_dir = Path("/tmp/letsencrypt-fake/live/example")
     adapter = _adapter_with(

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/self_hoster/tests/test_storage.py

@@ -1,4 +1,4 @@
-"""Tests for self_hoster SQLite storage — mode 600 + observation insert."""
+"""Tests for self_hoster SQLite storage ; mode 600 + observation insert."""
 
 from __future__ import annotations
 

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/self_hoster/tests/test_traits.py

@@ -1,4 +1,4 @@
-"""Tests for self_hoster trait emitter — Clause-4 banlist + bands."""
+"""Tests for self_hoster trait emitter ; Clause-4 banlist + bands."""
 
 from __future__ import annotations
 

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/self_hoster/traits.py

@@ -1,6 +1,6 @@
 """Self-hoster trait band emitters (Eco-15) with Clause-4 banlist.
 
-Five banded sub-traits (stub spec §6):
+Five banded sub-traits:
 
 * ``os_update_discipline``
 * ``backup_cadence``
@@ -8,7 +8,7 @@ Five banded sub-traits (stub spec §6):
 * ``tls_hygiene``
 * ``uptime_steward``
 
-Clause-4 banlist (stub spec §6):
+Clause-4 banlist:
 
 * ``sysadmin-burnout``
 * ``self-hoster-anxiety``
@@ -77,10 +77,9 @@ class SelfHosterTraitEmission(BaseModel):
 class SelfHosterTraits:
     def emit(self, kind: str, band: str) -> SelfHosterTraitEmission:
         self._refuse_if_banned(kind)
-        # TODO(clause-3-identity-income): return/x402 hook attaches here per
-        #   D-PROV-1 + clause-3 ratification.  Each emission upward is the
-        #   point at which Identity-Income return-flow is metered.  Hook
-        #   implementation lives outside this scaffold pass.
+        # TODO(clause-3-identity-income): return/x402 hook attaches here.
+        #   Each emission upward is the point at which Identity-Income
+        #   return-flow is metered.  Hook implementation is a follow-up.
         return SelfHosterTraitEmission(kind=kind, band=band)
 
     def emit_os_update_discipline(self, band: OsUpdateDisciplineBand) -> SelfHosterTraitEmission:

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/tapo_ecosystem/__init__.py

@@ -1,4 +1,4 @@
-"""Tapo ecosystem adapter (Eco-14) — hub-level multi-parameter composition.
+"""Tapo ecosystem adapter (Eco-14) ; hub-level multi-parameter composition.
 
 Subscribes at hub level: N parameters at one logical location (the H100
 hub).  ``MultiParameterProvenanceRecord`` is composed across all paired
@@ -8,7 +8,7 @@ LOCAL and is never surfaced upward.
 Three banded traits: ``household_appliance_stewardship``,
 ``household_routine_cadence``, ``ambient_stewardship``.
 
-Spec: ``phase2-wave2-stub-specs-pack-2026-05-27.md`` §5.
+Stub adapter; implementation pass is a follow-up wave.
 """
 
 from alter_runtime.adapters.household.tapo_ecosystem.adapter import (

{alter_runtime-0.3.2 → alter_runtime-0.3.3}/alter_runtime/adapters/household/tapo_ecosystem/adapter.py

@@ -1,4 +1,4 @@
-"""Tapo ecosystem adapter (Eco-14) — H100/H200 hub-level composition.
+"""Tapo ecosystem adapter (Eco-14) ; H100/H200 hub-level composition.
 
 Subscribes to ``tapo/+/+/state`` and ``tapo/+/+/energy`` topic globs;
 all paired Tapo devices under one hub compose into a single
@@ -10,7 +10,7 @@ emits.  Room-mapping authored by the member at pairing stays LOCAL.
 Vendor-cloud posture (option b): TP-Link cloud REFUSED; python-kasa
 local API accepted at the LAN bridge layer; Tapo Cloud account-link
 REFUSED.  This adapter only consumes events the household-bridge
-republishes from the local LAN — it never originates cloud calls.
+republishes from the local LAN ; it never originates cloud calls.
 """
 
 from __future__ import annotations
@@ -65,7 +65,7 @@ class TapoEcosystemAdapter(EventBusSubscriberBase):
             }
 
         ``room`` may be present in the bridged payload but is dropped
-        before persistence — room-mapping stays at the bridge level.
+        before persistence ; room-mapping stays at the bridge level.
         """
         if not isinstance(payload, dict):
             self._logger.debug("tapo_ecosystem ignoring non-dict payload")
@@ -81,7 +81,7 @@ class TapoEcosystemAdapter(EventBusSubscriberBase):
             return
 
         # TODO(eco-14): MultiParameterProvenanceRecord composition keyed by
-        #   hub_mac — current scaffold persists per-device events flat.
+        #   hub_mac ; current scaffold persists per-device events flat.
         # TODO(eco-14): compute household_appliance_stewardship band from
         #   per-plug Wh fingerprint diversity × rolling-30-day cadence.
         # TODO(eco-14): compute household_routine_cadence band from