@irisrun/inspect 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,33 @@
+# @irisrun/inspect
+
+**See what your agent decided — read-only, snapshot-safe.** A recorded session
+is a snapshot plus a journal; this reads it back as a decision/effect/marker
+timeline keyed by the stable `sessionId`. Nothing it derives re-enters replayed
+state, so inspecting a session can never change it — and re-inspecting the same
+journal bytes is byte-identical.
+
+## What it is
+
+`inspectSession(store, sessionId)` reads the latest snapshot + journal tail from a
+`StateStore`, decodes each record, and returns a `SessionInspection` —
+`governingDigest`, `snapshotUpTo`, the `InspectedRecord[]` timeline, per-kind
+`counts`, and a `terminal` of `finished` | `parked` | `open`. The governing
+digest is re-derived LOCALLY from the post-snapshot tail (snapshot-safely), so the
+package depends on `@irisrun/core` ONLY. `renderTimeline(inspection)` formats it
+as one deterministic line per record.
+
+This is the library API — not a CLI. (`iris inspect` is an image-only command.)
+
+## Use it
+
+```ts
+import { inspectSession, renderTimeline } from "@irisrun/inspect";
+
+const inspection = await inspectSession(store, "s1");
+console.log(renderTimeline(inspection));    // one line per decision/effect/marker
+```
+
+See **[docs/Inspecting a session](../../docs/guides/inspect.md)**.
+
+---
+Part of [Iris](../../README.md) — own, portable, verifiable state.

package/dist/inspect.js

@@ -1,4 +1,4 @@
-// inspectSession (ADR-0009 inspect surface) — render a recorded session's
+// inspectSession (inspect surface) — render a recorded session's
 // decision/effect/marker timeline from a StateStore, keyed by the stable
 // sessionId. READ-ONLY: it reads snapshot + journal, decodes, and summarizes; it
 // never writes and nothing it derives re-enters replayed state (determinism). The

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@irisrun/inspect",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
-  "description": "Iris journal/decision viewer (ADR-0009 inspect surface) — reads a recorded session (snapshot + journal) from a StateStore and renders the deterministic decision/effect/marker timeline, keyed by the stable sessionId. READ-ONLY; re-derives the governing digest snapshot-safely; never writes. Pure over @irisrun/core.",
+  "description": "Iris journal/decision viewer (inspect surface) — reads a recorded session (snapshot + journal) from a StateStore and renders the deterministic decision/effect/marker timeline, keyed by the stable sessionId. READ-ONLY; re-derives the governing digest snapshot-safely; never writes. Pure over @irisrun/core.",
   "exports": {
     ".": {
       "iris-src": "./src/index.ts",
@@ -11,7 +11,7 @@
     }
   },
   "dependencies": {
-    "@irisrun/core": "^0.1.0"
+    "@irisrun/core": "^0.2.0"
   },
   "license": "MIT",
   "engines": {