@maolon/pi-watcher 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this project are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses
 [Semantic Versioning](https://semver.org/). Before 1.0, minor versions may break.
 
+## [Unreleased]
+
+## [0.1.3] - 2026-10-08
+
+### Changed
+- Attention toasts follow the outcome: a succeeded `task.terminal` notice shows at `info`; failures, cancellations, unknown exits, deadlines, semantic candidates and failed relay wakes stay at `warning`.
+- Git flow: `dev` integration branch, release and hotfix PRs into `main` publish to npm.
+
+## [0.1.2] - 2026-10-08
+
+### Changed
+- README: state up front that the optional semantic check uses Jev, with credentials from Pi's `/login`.
+
 ## [0.1.1] - 2026-10-08
 
 ### Changed

package/README.md

@@ -4,6 +4,11 @@ Watch long-running work from [Pi](https://pi.dev) without babysitting it. pi-wat
 training jobs, CI pipelines and deadlines from durable evidence. It keeps the session quiet while things progress
 and wakes the session (through [pi-relay](https://github.com/Maolon/pi-relay)) only when a fact needs a decision.
 
+For what patterns cannot see (a stalled run, a fix loop that keeps repeating, a log that claims success while
+showing errors), pi-watcher can optionally run a **semantic check with [Jev](https://typesafe.ai)**, TypeSafe's
+fast discriminative classifier, using the Jev credentials you already have in Pi (`/login` → TypeSafe). See
+[Semantic review](#semantic-review-jev-optional).
+
 ```bash
 pi install npm:@maolon/pi-relay      # wake transport (recommended, see "pi-relay" below)
 pi install npm:@maolon/pi-watcher
@@ -16,7 +21,10 @@ model turn and grows the context just to learn "still running". pi-watcher moves
 
 - **Facts first.** Explicit terminal states, exit markers, deadlines and silence are decided by code, not by a model.
 - **Quiet by default.** Routine progress only updates a status widget. Nothing enters the conversation.
-- **Wake on decisions.** Failure, a crossed deadline, a ready dependency or (optionally) a semantic blocker
+- **Semantic check with Jev (optional).** Per watch, Jev answers six bounded questions about a sanitized
+  evidence window: progress, blocker, needs a decision, repeating, claim vs evidence, enough context. Its scores
+  never override hard facts; they only raise or annotate episodes. Off unless you enable it.
+- **Wake on decisions.** Failure, a crossed deadline, a ready dependency or (optionally) a Jev-detected blocker
   becomes one episode and one wake. The host then inspects the fresh facts and responds.
 - **Honest state.** Unknown stays unknown. Delivery, withdrawal and completion are reported only with evidence.
 

package/dist/engine/engine.d.ts

@@ -42,6 +42,8 @@ export interface AttentionNotice {
     relayError?: string;
     /** Deadline until which the envelope is still valid (ms epoch) */
     validUntil: number;
+    /** Observed task state for terminal-fact notices (display layer picks the toast level from it) */
+    taskState?: string;
 }
 /** Accepted-judgment-complete notification (display-layer notice; judge review must be visible) */
 export interface JudgmentNotice {

package/dist/engine/engine.js

@@ -236,7 +236,7 @@ export class WatchEngine {
             }, now);
             if (episodeId) {
                 produced.episodes.push(episodeId);
-                await this.publishEpisodeAttention(watchId, row, episodeId, kind, `${snapshot.taskState}${snapshot.exitCode !== undefined && snapshot.exitCode !== null ? ` exitCode=${snapshot.exitCode}` : ''}: ${snapshot.summary ?? 'no summary'}`, now);
+                await this.publishEpisodeAttention(watchId, row, episodeId, kind, `${snapshot.taskState}${snapshot.exitCode !== undefined && snapshot.exitCode !== null ? ` exitCode=${snapshot.exitCode}` : ''}: ${snapshot.summary ?? 'no summary'}`, now, undefined, snapshot.taskState);
             }
             const resultId = `result-${watchId}-${row.generation}-${snapshot.lastSourceSeq ?? 0}`;
             const card = buildResultCard({
@@ -720,7 +720,7 @@ export class WatchEngine {
         return { inspectionId, watchId, ingested: 0, produced, health: missing.length > 0 ? 'degraded' : 'healthy', lifecycleAfter: 'active' };
     }
     /** Unified attention publishing for hard facts / semantic candidates: truth lands in the outbox first, then publishes via relay managed delivery (I6). */
-    async publishEpisodeAttention(watchId, row, episodeId, reasonCode, summary, now, probability) {
+    async publishEpisodeAttention(watchId, row, episodeId, reasonCode, summary, now, probability, taskState) {
         const envelopeId = newId('att');
         const envelope = {
             schemaVersion: 1,
@@ -785,7 +785,8 @@ export class WatchEngine {
                 summary,
                 transport,
                 relayError,
-                validUntil: validUntilMs
+                validUntil: validUntilMs,
+                taskState
             });
         }
         catch { /* display-layer failure does not affect the engine */ }

package/dist/pi-extension.d.ts

@@ -15,6 +15,7 @@
  *   source/profile/owner capability are injected from the trusted context; the model cannot specify sessionId
  * - ack requires relay delivery (deliveryRef); when relay is not negotiated it returns NO_DELIVERY and never fabricates a receipt
  */
+import { type AttentionNotice } from './engine/engine.js';
 import { type PiClassifierRegistry } from './jev/pi-registry.js';
 /** Minimal structural types: avoid a hard dependency on the pi runtime (the loader is Pi itself). */
 export interface PiToolCallContext {
@@ -120,4 +121,15 @@ export interface RelayBindResult {
         message?: string;
     };
 }
+/**
+ * Session backend: local runtime, no IPC (per-session root, decision 2026-09-21).
+ * This session is the only process on its own root, so the single-writer invariant holds naturally; no primary/attached,
+ * no failover; version skew (an old primary serving an old action surface) is structurally impossible.
+ */
+/**
+ * Toast level for an attention notice. A clean success is informational; anything that needs a
+ * closer look (failure, cancellation, unknown exit, deadline, semantic candidate) or a broken
+ * relay wake leg stays a warning.
+ */
+export declare function attentionNotifyLevel(notice: Pick<AttentionNotice, 'reasonCode' | 'transport' | 'taskState'>): 'info' | 'warning';
 export default function watcherExtension(pi: PiExtensionAPI, options?: WatcherExtensionOptions): void;

package/dist/pi-extension.js

@@ -78,6 +78,16 @@ const sessionDirOf = (sid) => sid.replace(/[^A-Za-z0-9._-]+/g, '_').slice(0, 64)
  * This session is the only process on its own root, so the single-writer invariant holds naturally; no primary/attached,
  * no failover; version skew (an old primary serving an old action surface) is structurally impossible.
  */
+/**
+ * Toast level for an attention notice. A clean success is informational; anything that needs a
+ * closer look (failure, cancellation, unknown exit, deadline, semantic candidate) or a broken
+ * relay wake leg stays a warning.
+ */
+export function attentionNotifyLevel(notice) {
+    if (notice.transport === 'relay-failed')
+        return 'warning';
+    return notice.reasonCode === 'task.terminal' && notice.taskState === 'succeeded' ? 'info' : 'warning';
+}
 class SessionBackend {
     rt;
     refreshWidget;
@@ -100,7 +110,7 @@ class SessionBackend {
         const text = `pi-watcher attention [${notice.reasonCode}] watch ${notice.watchId}: ${notice.summary}` + tail;
         if (!notice.ownerSession || notice.ownerSession === this.sessionId) {
             try {
-                this.notifyUser(text);
+                this.notifyUser(text, attentionNotifyLevel(notice));
             }
             catch { /* display failure does not block */ }
         }
@@ -226,7 +236,7 @@ export default function watcherExtension(pi, options = {}) {
                     catch { /* display failure does not block the engine */ }
                 }
             });
-            const be = new SessionBackend(rt, refreshWidget, text => { ctx.ui?.notify?.(text, 'warning'); }, primarySid);
+            const be = new SessionBackend(rt, refreshWidget, (text, level) => { ctx.ui?.notify?.(text, level); }, primarySid);
             attentionSink = n => be.handleAttention(n);
             if (sessionClosed) {
                 be.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maolon/pi-watcher",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Watch long-running Pi tasks without babysitting: deterministic task monitoring, optional semantic review, and relay-delivered wakes only when something needs the host.",
   "keywords": [
     "pi-package",