@senpi/runtime 3.0.9-dev.feat-strategy-compos.20260722213012 → 3.0.9-dev.feat-strategy-compos.20260723050017

package/dist/composer/verbs/review.py

@@ -37,22 +37,28 @@ anything.
 
 from __future__ import annotations
 
+import json
 from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Callable, Optional
 
 from . import _box
 from ._box import McpFn, default_mcp_call
-from ._layout import canonical_graph_path
+from ._layout import ARCHIVES_DIR, canonical_graph_path
 from ._live import LiveState
+from ._target import TargetError
 from .portfolio import _effective_install, _resolve_wallet, enumerate_strategies
 from .status import run_status
+from composer.validator.errors import Location, TeachingError
 
 # The named sources every figure is attributed to (printed so an operator always knows the producer).
 SRC_HISTORY = "backend trade history"          # discovery_get_trader_history (onchain closed ledger)
 SRC_EVENTS = "box event log"                   # the runtime's on-disk event ring (dsl/position/order/…)
 
 CLOSED_HISTORY_PULL = 100                       # closed positions to pull per wallet (review.py parity)
+EVENTS_PULL = 500                               # recent-ring window per runtime (review.py's `-l 500`;
+                                                # mirrors composer-live-read.ts EVENTS_PULL_DEFAULT so the
+                                                # ARCHIVED cold path enriches over the SAME depth as live)
 
 # EXIT attribution — the exit events a closed trade is matched against (references/event-log.md shapes).
 _EXIT_EVENT_NAMES = ("dsl.closed", "position.closed")
@@ -722,3 +728,276 @@ def run_review(
         result.strategies.append(
             _review_one(str(state_dir), strategy, runtime_id, wallet, history_fn, events_section))
     return result
+
+
+# =========================================================================== K7: ARCHIVED cold path
+#
+# The live review reads the HOT event ring served in-process by the rim (no cold-boot subprocess).
+# But `runtime delete` (close / update teardown) ARCHIVES the whole per-runtime state dir to
+# `<base>/archives/<runtimeId>-<wallet>-<ts>/` (src/runtime/state-layout.ts::archiveStateDir), moving
+# the on-disk event ring with it (`<archive>/strategies/<wallet>/events/events.jsonl` +
+# `events.1.jsonl`, src/telemetry/event-store.ts). A CLOSED / torn-down strategy's exit-attribution
+# data SURVIVES teardown — it is just no longer on the live rim. So `composer review --archived
+# <wallet|runtime>` does an OFFLINE FILE READ of that archived ring (NOT a subprocess, NOT a cold
+# boot — the sanctioned exception the module header carves out) and feeds the rows through the SAME
+# enrichment/render the live path uses. Dev-test #7 F3: the model called a closed strategy's exits
+# "unknowable (event ring gone)" while the ground-truth DSL trail sat in the archive — this reaches it.
+
+
+def _parse_archive_dir_name(name: str) -> Optional[tuple[str, str, int]]:
+    """Parse an archive dir name ``<runtimeId>-<wallet>-<ts>`` into ``(runtimeId, wallet, ts_ms)``.
+    Mirrors TS ``listArchives`` (state-layout.ts): the trailing token is the epoch-ms timestamp, the
+    token before it is the wallet (0x… — no dashes), and everything before that is the runtime id
+    (which DOES carry dashes, e.g. ``<strategy>-<hash8>``). None when the name doesn't fit / no ts."""
+    parts = name.rsplit("-", 2)
+    if len(parts) < 3:
+        return None
+    runtime_id, wallet, ts_str = parts[0], parts[1], parts[2]
+    if not runtime_id or not wallet:
+        return None
+    try:
+        ts = int(ts_str)
+    except ValueError:
+        return None
+    if ts <= 0:
+        return None
+    return runtime_id, wallet, ts
+
+
+def _archives_root(base_state_dir: str) -> Path:
+    return Path(base_state_dir) / ARCHIVES_DIR
+
+
+def _list_archive_dirs(base_state_dir: str) -> list[tuple[str, str, str, int, Path]]:
+    """Every parseable archive under ``<base>/archives`` as ``(name, runtimeId, wallet, ts, path)``,
+    newest ts first. Unparseable / non-dir entries are skipped (they are not composer's shape)."""
+    root = _archives_root(base_state_dir)
+    if not root.is_dir():
+        return []
+    out: list[tuple[str, str, str, int, Path]] = []
+    for child in sorted(root.iterdir()):
+        if not child.is_dir():
+            continue
+        parsed = _parse_archive_dir_name(child.name)
+        if parsed is None:
+            continue
+        runtime_id, wallet, ts = parsed
+        out.append((child.name, runtime_id, wallet, ts, child))
+    out.sort(key=lambda t: t[3], reverse=True)
+    return out
+
+
+def _resolve_archive(base_state_dir: str, target: str) -> tuple[str, str, int, Path]:
+    """Resolve the NEWEST archive dir matching ``target`` (a wallet OR a runtime id OR a substring of
+    the dir name). Returns ``(runtimeId, wallet, ts, path)``. Fail-loud: raises :class:`TargetError`
+    (CMP256 — the existing "target could not be resolved" class, reused per the _target.py precedent)
+    ENUMERATING the archive dirs that DO exist, mirroring ``_target.available_strategies_hint``."""
+    archives = _list_archive_dirs(base_state_dir)
+    tl = target.strip().lower()
+    matches = [
+        a for a in archives
+        if a[2].lower() == tl                     # wallet (case-insensitive)
+        or a[1] == target.strip()                 # runtime id (exact)
+        or tl in a[0].lower()                     # substring of the dir name (strategy-name / partial)
+    ]
+    if matches:
+        best = matches[0]                          # already newest-first
+        _name, runtime_id, wallet, ts, path = best
+        return runtime_id, wallet, ts, path
+
+    root = _archives_root(base_state_dir)
+    if archives:
+        shown = ", ".join(a[0] for a in archives[:20]) + (", …" if len(archives) > 20 else "")
+        hint = (f"Archive dirs under {root} (newest first): {shown}. Pass a wallet (0x…) or a "
+                f"runtime id that appears in one of those names.")
+    else:
+        hint = (f"No archived runtime state dirs exist under {root} — nothing has been closed / "
+                f"torn down on this box (archives are written by `runtime delete`, i.e. `composer "
+                f"close` / `composer update`). For a LIVE strategy, run `composer review <strategy>` "
+                f"(no --archived).")
+    raise TargetError(TeachingError(
+        "CMP256",
+        f"no archived event ring matched {target!r} under {root} — it is not the wallet or runtime "
+        f"id of any archived (closed / torn-down) runtime on this box.",
+        hint,
+        Location(),
+    ))
+
+
+def _find_archived_events_dir(archive_dir: Path, wallet: str) -> Optional[Path]:
+    """The events dir inside an archive: ``<archive>/strategies/<wallet>/events`` (the on-disk ring
+    layout, event-store.ts::eventsDir, keyed by the LOWERCASED wallet). Falls back to the first
+    ``strategies/*/events`` dir if the exact lowercased wallet subdir isn't there (a case/normalize
+    drift). None when the archive carries no events tree at all."""
+    strategies = archive_dir / "strategies"
+    if not strategies.is_dir():
+        return None
+    exact = strategies / wallet.strip().lower() / "events"
+    if exact.is_dir():
+        return exact
+    for sub in sorted(strategies.iterdir()):
+        ev = sub / "events"
+        if sub.is_dir() and ev.is_dir():
+            return ev
+    return None
+
+
+def _read_archived_ring(events_dir: Optional[Path]) -> tuple[list[dict], int]:
+    """Read the archived 2-file ring OFFLINE: ``events.1.jsonl`` (older rotation) THEN ``events.jsonl``
+    (newer), chronological — the SAME order the runtime's ``readEvents`` uses. Each line is one JSONL
+    row (``{ts,name,body,level,attrs}``). Corrupt / non-dict rows are SKIPPED and COUNTED (never a
+    crash, never silently dropped). Applies the ``EVENTS_PULL`` recency cap (newest tail by ts).
+    Returns ``(rows, skipped_count)``; rows is ``[]`` for a genuinely empty / absent ring."""
+    rows: list[dict] = []
+    skipped = 0
+    if events_dir is None:
+        return rows, skipped
+    for fname in ("events.1.jsonl", "events.jsonl"):     # archive (older) then current (newer)
+        fpath = events_dir / fname
+        if not fpath.is_file():
+            continue
+        try:
+            text = fpath.read_text(encoding="utf-8")
+        except OSError:
+            continue
+        for line in text.splitlines():
+            if not line.strip():
+                continue
+            try:
+                obj = json.loads(line)
+            except (json.JSONDecodeError, ValueError):
+                skipped += 1                              # a torn / partial JSONL row — count, skip
+                continue
+            if isinstance(obj, dict):
+                rows.append(obj)
+            else:
+                skipped += 1                              # a well-formed-but-non-object row
+    # Recency cap (EVENTS_PULL) — keep the newest tail by ts, matching the live per-runtime pull.
+    if len(rows) > EVENTS_PULL:
+        rows.sort(key=lambda r: _num(r.get("ts")) or 0)
+        rows = rows[-EVENTS_PULL:]
+    return rows, skipped
+
+
+@dataclass
+class ArchivedReviewResult:
+    """A CLOSED / torn-down strategy's retrospective review, read from its ARCHIVED on-disk event ring
+    (K7). Wraps ONE :class:`StrategyReview` (built through the SAME enrichment/render as live) with the
+    archive provenance banner: which archive dir, when it was archived, the runtime id, and the ring's
+    read/skip counts. Exit reasons + leaks come from the archived ring; realized PnL / win rate from the
+    backend trade history (wired from the wallet parsed out of the archive name)."""
+
+    base_state_dir: str
+    target: str
+    archive_name: str
+    archive_dir: str
+    archive_ts: int
+    runtime_id: str
+    wallet: str
+    strategy: str
+    review: StrategyReview
+    events_total: int = 0
+    rows_skipped: int = 0
+
+    @property
+    def ring_empty(self) -> bool:
+        return self.events_total == 0
+
+    def _archived_at(self) -> str:
+        """The archive timestamp as an ISO-8601 UTC string (the ts is epoch MILLISECONDS)."""
+        import datetime as _dt
+        try:
+            return _dt.datetime.fromtimestamp(self.archive_ts / 1000.0,
+                                              tz=_dt.timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+        except (OverflowError, OSError, ValueError):
+            return "unknown"
+
+    def to_json(self) -> dict:
+        return {
+            "verb": "review",
+            "scope": "archived",
+            "state_dir": self.base_state_dir,
+            "target": self.target,
+            "archived": {
+                "archive_name": self.archive_name,
+                "archive_dir": self.archive_dir,
+                "archived_at_ms": self.archive_ts,
+                "archived_at": self._archived_at(),
+                "runtime_id": self.runtime_id,
+                "wallet": self.wallet,
+                "strategy": self.strategy,
+                "ring_events_read": self.events_total,
+                "ring_rows_skipped": self.rows_skipped,
+                "ring_empty": self.ring_empty,
+            },
+            "sources": {"history": SRC_HISTORY, "events": f"{SRC_EVENTS} (ARCHIVED)"},
+            "strategy": self.review.to_json(),
+        }
+
+    def render(self) -> str:
+        lines = [
+            f"trade review — ARCHIVED  (state: {self.base_state_dir})",
+            f"reading the NEWEST archived event ring for target {self.target!r}: this strategy is "
+            f"CLOSED / torn down — its live runtime + event ring were ARCHIVED on `runtime delete` "
+            f"(`composer close` / `composer update`). Exit reasons + leaks below are from that "
+            f"archived ring [{SRC_EVENTS}]; realized PnL + win rate from {SRC_HISTORY}.",
+            f"  archive    : {self.archive_name}  (archived {self._archived_at()})",
+            f"  archive dir: {self.archive_dir}",
+            f"  runtime    : {self.runtime_id}",
+        ]
+        if self.ring_empty:
+            lines.append("  ring       : archived ring is empty — no events were recorded "
+                         "(the ring WAS read; it simply held nothing — this is not an "
+                         "unavailable/undetermined telemetry state)")
+        else:
+            skip = f"  [{self.rows_skipped} unreadable row(s) skipped]" if self.rows_skipped else ""
+            lines.append(f"  ring       : {self.events_total} event(s) read from the archived "
+                         f"ring{skip}  [{SRC_EVENTS} (ARCHIVED)]")
+        lines.append("")
+        lines.append("strategy (closed / torn down):")
+        lines.extend(self.review.render())
+        return "\n".join(lines) + "\n"
+
+
+def run_archived_review(
+    base_state_dir: str,
+    target: str,
+    *,
+    history_fn: HistoryFn = default_closed_history,
+) -> ArchivedReviewResult:
+    """`composer review --archived <wallet|runtime>` — review a CLOSED / torn-down strategy from its
+    ARCHIVED on-disk event ring (K7). Resolves the NEWEST archive dir under ``<base>/archives`` matching
+    the target (wallet / runtime id / dir-name substring; :class:`TargetError` CMP256 enumerating what
+    DOES exist when nothing matches), reads the archived ring OFFLINE (``events.1.jsonl`` then
+    ``events.jsonl``, EVENTS_PULL-capped, corrupt rows skipped + counted), and feeds the rows through
+    the SAME exit-reason enrichment + leak scan + render the LIVE path uses — banner-labelled ARCHIVED.
+    Closed-trade history is wired from the wallet parsed out of the archive name (an honest "unavailable
+    (reason)" degrades that side only). Never a subprocess, never a cold boot — a sanctioned file read."""
+    runtime_id, wallet, ts, archive_dir = _resolve_archive(base_state_dir, target)
+
+    events_dir = _find_archived_events_dir(archive_dir, wallet)
+    rows, skipped = _read_archived_ring(events_dir)
+
+    # Derive the strategy NAME from the runtime id (``<strategy>-<hash8>``) so the render labels it and
+    # a still-present composer/<strategy>/graph.yaml thesis is quoted (torn-down runtime, but the
+    # composer record graph often survives). Falls back to the raw runtime id when there is no dash.
+    strategy = runtime_id.rsplit("-", 1)[0] if "-" in runtime_id else runtime_id
+
+    # Feed the archived rows through the SAME machinery as live by presenting them as the resolved
+    # runtime's slice of an events section — _review_one + StrategyReview.render() are reused verbatim.
+    events_section = {"ok": True, "by_runtime": {runtime_id: rows}}
+    sr = _review_one(base_state_dir, strategy, runtime_id, wallet, history_fn, events_section)
+
+    return ArchivedReviewResult(
+        base_state_dir=str(Path(base_state_dir)),
+        target=target,
+        archive_name=archive_dir.name,
+        archive_dir=str(archive_dir),
+        archive_ts=ts,
+        runtime_id=runtime_id,
+        wallet=wallet,
+        strategy=strategy,
+        review=sr,
+        events_total=len(rows),
+        rows_skipped=skipped,
+    )

package/dist/composer/verbs/status.py

@@ -78,8 +78,27 @@ from ._layout import (
     resolve_wallet_json,
     runtime_state_dir,
 )
+from ._target import TargetError, available_strategies_hint
 from .check import run_check
 from .install import INSTALL_JSON, REGISTRY_FILENAME, compute_hash8
+from composer.validator.errors import Location, TeachingError
+
+
+def _status_read(path: Path, base_state_dir=None) -> str:
+    """Read a user-supplied status target, wrapping any OSError (a permissions/IO fault, a vanished
+    file) as a CMP256 teaching error instead of letting a raw ``[Errno N]`` escape to the backstop
+    (K4). ``status`` shares the graph verbs' target vocabulary — a read fault teaches the same way."""
+    try:
+        return path.read_text(encoding="utf-8")
+    except OSError as exc:
+        detail = exc.strerror or str(exc)
+        raise TargetError(TeachingError(
+            "CMP256",
+            f"the status target {str(path)!r} could not be read: {detail}.",
+            "Pass the path to an existing, readable graph .yaml, a strategy directory, or a strategy "
+            "name. " + available_strategies_hint(base_state_dir),
+            Location(),
+        )) from exc
 
 ABSENT = "absent"
 INVALID = "invalid"
@@ -429,7 +448,7 @@ def _resolve(target, out_dir, base_state_dir=None) -> tuple[Optional[str], str,
     if p.is_dir():
         manifest = p / "manifest.json"
         if manifest.is_file():
-            man = json.loads(manifest.read_text(encoding="utf-8"))
+            man = json.loads(_status_read(manifest, base_state_dir))
             strategy = str(man.get("strategy", p.name))
             # G8b: the top-level graph SNAPSHOT is the record; fall back to the in-unit copy, then
             # the flat legacy location for older stagings.
@@ -439,7 +458,7 @@ def _resolve(target, out_dir, base_state_dir=None) -> tuple[Optional[str], str,
                  if c.is_file()),
                 p / "main" / graph_name,
             )
-            text = gpath.read_text(encoding="utf-8") if gpath.is_file() else None
+            text = _status_read(gpath, base_state_dir) if gpath.is_file() else None
             return text, str(gpath if gpath.is_file() else p), p, strategy
         return None, str(p), None, p.name
     if not p.is_file():
@@ -449,11 +468,11 @@ def _resolve(target, out_dir, base_state_dir=None) -> tuple[Optional[str], str,
             cstaged = canonical_staged_dir(base_state_dir, target)
             staged = cstaged if (cstaged / "manifest.json").is_file() else None
             if cgraph.is_file():
-                return cgraph.read_text(encoding="utf-8"), str(cgraph), staged, target
+                return _status_read(cgraph, base_state_dir), str(cgraph), staged, target
             if staged is not None:
                 return None, str(cgraph), staged, target
         return None, str(p), None, p.name.replace(".graph.yaml", "")
-    text = p.read_text(encoding="utf-8")
+    text = _status_read(p, base_state_dir)
     strategy = _strategy_name(text, p.stem)
     staged = None
     if out_dir is not None:
@@ -687,7 +706,9 @@ def _build_manual_status(label: str, strategy: str, state_dir: Path,
     if wj_path is not None:
         try:
             rec = json.loads(wj_path.read_text(encoding="utf-8"))
-            wallet = str(rec.get("wallet")) if rec.get("wallet") else None
+            # K3 follow-up: tolerant address read (hand-authored markers use the MCP key spellings).
+            from .fund import _rec_wallet
+            wallet = _rec_wallet(rec) or None
             strategy_id = rec.get("strategyId")
         except (OSError, json.JSONDecodeError):
             pass

package/dist/composer/verbs/update.py

@@ -70,7 +70,7 @@ from ._layout import (
 )
 from ._unit_diff import UnitDiff, diff_unit_dirs
 from .check import render_unit_summary
-from .fund import _read_wallet_json
+from .fund import _read_wallet_json, _rec_wallet
 from .install import (
     ALREADY_INSTALLED,
     INSTALL_JSON,
@@ -368,11 +368,15 @@ def run_update(
     # corrupt staging can never strand a live wallet.
     staged = _resolve_staged(target, out_dir, base_state_dir)
     if staged is None:
+        # K4: share the graph verbs' target vocabulary — a target that resolves to nothing names the
+        # strategies that DO exist under the state root, so the model corrects to a real one.
+        from ._target import available_strategies_hint
         return _refused(target, TeachingError(
             "CMP200", "the update target is not a staged unit (no manifest.json found).",
             "Point `composer update` at a `composer deploy` staging dir (the one containing "
-            "manifest.json + main/), or pass the graph file plus `-o <staging-dir>`. Run "
-            "`composer deploy <graph> -o <dir>` first.",
+            "manifest.json + main/), a graph file plus `-o <staging-dir>`, or a strategy NAME whose "
+            "canonical staged/ exists. Run `composer deploy <graph>` first. "
+            + available_strategies_hint(base_state_dir),
             Location(),
         ))
     try:
@@ -416,7 +420,13 @@ def run_update(
     if not wallet:
         wj, _layout = resolve_wallet_json(base_state_dir, strategy)
         rec = _read_wallet_json(wj) if wj is not None else None
-        rec_wallet = str((rec or {}).get("wallet") or "").strip()
+        # K4 (CMP240 fix): read the wallet ADDRESS with the SAME tolerant reader `composer fund` uses
+        # (K3 `_rec_wallet`) — a hand-authored / MCP-shaped / adopt-flow wallet.json records the
+        # address under `address` / `walletAddress` / `strategyWalletAddress`, NOT the canonical
+        # `wallet` key. Pre-K4 update read `rec.get("wallet")` raw and REFUSED CMP240 on such a
+        # marker (dev-test #7: a wallet.json with strategyId + address) though fund/install resolved
+        # it fine — the exact fund/update divergence this unifies.
+        rec_wallet = _rec_wallet(rec or {}).strip()
         if not rec_wallet:
             return _refused(target, TeachingError(
                 "CMP240", f"no wallet to update — `--wallet` was omitted and no funded "

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,OAAO,EAA2B,KAAK,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAkBnG,OAAO,KAAK,EAAuB,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAOjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAgC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAM5E,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAIjD;AAGD,OAAO,EACL,OAAO,EACP,SAAS,EACT,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,MAAM,IAAI,SAAS,EACnB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EAClB,4BAA4B,EAC5B,8BAA8B,EAC9B,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,aAAa,EACb,SAAS,EACT,UAAU,EACV,cAAc,EACd,YAAY,EACZ,eAAe,EACf,SAAS,EACT,mBAAmB,EACnB,MAAM,EACN,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,YAAY,EACV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,MAAM,EACN,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAC/G,kDAAkD;AAClD,OAAO,EAAE,mBAAmB,IAAI,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAC3F,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEtF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,mDAAmD,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACb,QAAQ,EACR,UAAU,EACV,qBAAqB,EACrB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,UAAU,IAAI,iBAAiB,EAC/B,QAAQ,GACT,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,YAAY,EACZ,aAAa,EACb,UAAU,EACV,QAAQ,EACR,SAAS,EACT,iBAAiB,IAAI,wBAAwB,EAC7C,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,kCAAkC,EAClC,eAAe,EACf,OAAO,IAAI,cAAc,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,YAAY,EACZ,4BAA4B,EAC5B,2BAA2B,EAC3B,+BAA+B,EAC/B,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,IAAI,2BAA2B,GACpD,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,wIAAwI;AACxI,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,aAAa,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB;;;;;;;WAOG;QACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC9B;;;;;;WAMG;QACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB;;;;;;WAMG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAKnH,CAAC;CACH;AAID,UAAU,YAAY;IACpB,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/C;AAED;;;;;;;;;GASG;AACH,KAAK,aAAa,GACd,gBAAgB,GAChB,eAAe,GACf,gBAAgB,GAChB,oBAAoB,GACpB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE;QACP,KAAK,EAAE;YACL,eAAe,IAAI,MAAM,CAAC;SAC3B,CAAC;QACF,MAAM,CAAC,EAAE;YACP,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/B,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;SACjD,CAAC;KACH,CAAC;IACF,eAAe,CAAC,OAAO,EAAE;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,CAAC,GAAG,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC5D,GAAG,IAAI,CAAC;IACT,WAAW,CACT,EAAE,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE;YAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,EACrF,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,GAC5B,IAAI,CAAC;IACR,YAAY,CAAC,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACjD,qBAAqB,CACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC5H,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,aAAa,CAAA;KAAE,GAC/B,IAAI,CAAC;IACR,EAAE,CAGA,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EACxC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3B,IAAI,CAAC;CACT;AAyID;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAKvE;AAED;;;GAGG;AACH,QAAA,MAAM,kBAAkB;;;;;;qBAUP,OAAO;;kBAQR,SAAS;CAwhDxB,CAAC;AA2FF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,aAAa,GAAG,SAAS,GAChC,kBAAkB,CAyCpB;AA0FD,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -36,6 +36,7 @@ import { resolvePackageName } from "./runtime/auto-update/resolve-package-name.j
 import { runOpenClawPluginsUpdate } from "./runtime/auto-update/run-update-command.js";
 import { registerSpanHooks } from "./telemetry/spans/index.js";
 import { registerComposerWriteAnnotationHook } from "./runtime/composer-managed-write.js";
+import { registerNoReplyScopingOverlayHook } from "./runtime/no-reply-scoping-overlay.js";
 import { initDefaultPiiRedactor } from "./telemetry/spans/redact-pii.js";
 import { initOtelSdk, shutdownOtelSdk } from "./telemetry/otel-sdk.js";
 import { getLogLevel, getLogLevelSource, parseLogLevel, setErrorNotifier, setLogLevel, } from "./utils/logger.js";
@@ -333,6 +334,21 @@ const senpiRuntimePlugin = {
                 err: err instanceof Error ? err.message : String(err),
             });
         }
+        // K9 — NO_REPLY scoping overlay. openclaw core teaches an unscoped "Silent
+        // Replies" rule (entire reply = NO_REPLY); a model that considers its
+        // tool-side work "already communicated" then goes silent after real work
+        // (dev-test #7 F6: silence after a successful composer update). The fleet
+        // pins openclaw, so the deployable lever is plugin-side: append a scoping
+        // correction to the cached system prompt via before_prompt_build. Additive
+        // and defensive — never blocks a turn or takes the plugin down.
+        try {
+            registerNoReplyScopingOverlayHook({ api, logger: pluginLogger });
+        }
+        catch (err) {
+            pluginLogger.warn("[senpi-runtime] failed to register NO_REPLY scoping overlay hook", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+        }
         const runtimeHandles = new Map();
         let apiHandle;
         // Supervised scanner state — module-scoped so stop() can reach them.