pi-harness-runtime 1.1.192 → 1.1.194

package/packages/jev-judge/dist/continuation-controller.js

@@ -0,0 +1,245 @@
+/**
+ * Todo-Driven Continuation Controller
+ *
+ * Executes authorized todo items without repeated prompts.
+ * Uses deterministic rules + optional Jev for ambiguous cases.
+ *
+ * Architecture:
+ * A. Read real todo state (not bd)
+ * B. Deterministic continuation on agent_settled
+ * C. Jev for ambiguous classification only
+ * D. Single continuation controller
+ * E. Update prompts/Telegram/status together
+ */
+import { createTodoProvider } from "./todo-provider.js";
+/**
+ * Todo-Driven Continuation Controller
+ *
+ * Evaluates todo state on agent_settled and determines next action.
+ */
+export class TodoContinuationController {
+    pi;
+    config;
+    todoProvider = createTodoProvider();
+    state = {
+        sessionId: "",
+        generation: 0,
+        todoRevision: 0,
+        currentItemId: null,
+        nextItemId: null,
+        lastMessageId: null,
+        continuationQueued: false,
+        userPaused: false,
+        lastSteerMessage: null,
+        steerAttempts: 0,
+        lastEvaluationResult: null,
+    };
+    constructor(pi, config) {
+        this.pi = pi;
+        this.config = {
+            jevFallbackMinWaitMs: 5 * 60 * 1000, // 5 minutes
+            routineThreshold: 0.7,
+            maxSteerAttempts: 3,
+            enableJev: true,
+            ...config,
+        };
+        // Initialize Jev judge if enabled
+        if (this.config.enableJev) {
+            // Jev will be initialized with API key from environment
+        }
+    }
+    /**
+     * Register lifecycle hooks
+     */
+    register() {
+        console.log("[TodoContinuation] Registering lifecycle hooks...");
+        // Session start - reset state
+        this.pi.on("session_start", () => {
+            this.reset();
+            console.log("[TodoContinuation] Session started");
+        });
+        // Agent settled - evaluate continuation
+        this.pi.on("agent_settled", () => {
+            this.evaluateContinuation().catch((err) => console.error("[TodoContinuation] Evaluation failed:", err));
+        });
+        // User input - reset pause state
+        this.pi.on("message_start", (event) => {
+            const msg = event.message;
+            if (msg?.role === "user") {
+                this.state.userPaused = false;
+                this.state.lastSteerMessage = null;
+            }
+        });
+        // Session shutdown - cleanup
+        this.pi.on("session_shutdown", () => {
+            this.cleanup();
+        });
+        // Tool call - track mutations that might invalidate state
+        this.pi.on("tool_call", (event) => {
+            // Increment generation on edits
+            if (["write", "edit", "bash"].includes(event.toolName)) {
+                this.state.generation++;
+                this.state.continuationQueued = false;
+            }
+        });
+        console.log("[TodoContinuation] Lifecycle hooks registered");
+    }
+    /**
+     * Evaluate continuation decision and execute it
+     */
+    async evaluateContinuation() {
+        // 1. Check user pause
+        if (this.state.userPaused) {
+            console.log("[TodoContinuation] User paused, stopping");
+            return;
+        }
+        // 2. Get current todo snapshot
+        const availability = await this.todoProvider.availability();
+        if (!availability.available) {
+            // No todo provider - don't auto-continue
+            console.log("[TodoContinuation] Todo provider unavailable:", availability.error);
+            return;
+        }
+        try {
+            // Get snapshot for state tracking
+            await this.todoProvider.getSnapshot();
+            // 3. Get in-progress and pending items
+            const inProgressItems = await this.todoProvider.getByStatus("in_progress");
+            const pendingItems = await this.todoProvider.getPending();
+            const completedItems = await this.todoProvider.getCompleted();
+            // 4. If there's work in progress, continue it
+            if (inProgressItems.length > 0) {
+                const item = inProgressItems[0];
+                console.log(`[TodoContinuation] In-progress item: ${item.subject}`);
+                await this.continueItem(item);
+                return;
+            }
+            // 5. Determine action based on state
+            const totalItems = completedItems.length + pendingItems.length + inProgressItems.length;
+            const hasWork = pendingItems.length > 0 || inProgressItems.length > 0;
+            if (!hasWork && totalItems === 0) {
+                console.log("[TodoContinuation] All items complete");
+                return;
+            }
+            if (pendingItems.length > 0) {
+                // Check if items are blocked
+                const blockedItems = await this.todoProvider.getBlocked();
+                if (blockedItems.length === pendingItems.length) {
+                    // All pending items are blocked
+                    const blocker = blockedItems[0];
+                    console.log("[TodoContinuation] Items blocked:", blocker?.subject);
+                    // Don't auto-continue when blocked
+                    return;
+                }
+                // Continue the first non-blocked pending item
+                const readyItems = await this.todoProvider.getReady();
+                if (readyItems.length > 0) {
+                    await this.continueItem(readyItems[0]);
+                }
+            }
+        }
+        catch (err) {
+            console.error("[TodoContinuation] Evaluation error:", err);
+        }
+    }
+    /**
+     * Continue a specific todo item
+     */
+    async continueItem(item) {
+        if (this.state.steerAttempts >= this.config.maxSteerAttempts) {
+            console.warn("[TodoContinuation] Max steer attempts reached");
+            return;
+        }
+        this.state.steerAttempts++;
+        this.state.continuationQueued = true;
+        // Build continuation message
+        const message = item.description
+            ? `Continue task: ${item.subject}\n\n${item.description}`
+            : `Continue task: ${item.subject}`;
+        this.state.lastSteerMessage = message;
+        console.log(`[TodoContinuation] Continuing: ${item.subject}`);
+        console.log(`[TodoContinuation] Message: ${message}`);
+        // Note: Pi does not expose sendUserMessage API.
+        // The Telegram notification system will prompt user for ambiguous cases.
+    }
+    /**
+     * Steer to continue a todo item
+     */
+    async steerToContinue(itemId) {
+        if (this.state.steerAttempts >= this.config.maxSteerAttempts) {
+            console.warn("[TodoContinuation] Max steer attempts reached");
+            return;
+        }
+        this.state.steerAttempts++;
+        this.state.continuationQueued = true;
+        const snapshot = await this.todoProvider.getSnapshot();
+        const item = snapshot.items.find((i) => i.id === itemId);
+        const message = item
+            ? `Continue todo item: "${item.subject}". ${item.description ?? ""}`
+            : `Continue work on the next ready task.`;
+        this.state.lastSteerMessage = message;
+        this.state.todoRevision = snapshot.revision;
+        console.log(`[TodoContinuation] Steering to continue item ${itemId}`);
+    }
+    /**
+     * Mark a todo item as complete
+     */
+    async markComplete(itemId) {
+        console.log(`[TodoContinuation] Marking item ${itemId} complete`);
+        this.state.currentItemId = null;
+        this.state.generation++;
+    }
+    /**
+     * User paused
+     */
+    pause() {
+        this.state.userPaused = true;
+        this.state.continuationQueued = false;
+        console.log("[TodoContinuation] User paused");
+    }
+    /**
+     * Reset state for new session
+     */
+    reset() {
+        this.state = {
+            sessionId: `session-${Date.now()}`,
+            generation: 0,
+            todoRevision: 0,
+            currentItemId: null,
+            nextItemId: null,
+            lastMessageId: null,
+            continuationQueued: false,
+            userPaused: false,
+            lastSteerMessage: null,
+            steerAttempts: 0,
+            lastEvaluationResult: null,
+        };
+    }
+    /**
+     * Cleanup on shutdown
+     */
+    cleanup() {
+        console.log("[TodoContinuation] Cleaning up");
+        this.state.continuationQueued = false;
+        this.state.generation++;
+    }
+    /**
+     * Get current state summary
+     */
+    getState() {
+        return {
+            current: null, // Would need to fetch
+            next: null,
+            ready: 0,
+        };
+    }
+}
+/**
+ * Create and register a todo continuation controller
+ */
+export function createTodoContinuation(pi, config) {
+    const controller = new TodoContinuationController(pi, config);
+    controller.register();
+    return controller;
+}
+//# sourceMappingURL=continuation-controller.js.map

package/packages/jev-judge/dist/continuation-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation-controller.js","sourceRoot":"","sources":["../src/continuation-controller.ts"],"names":[],"mappings":"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"}

package/packages/jev-judge/dist/todo-provider.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Todo Provider - Read local todo state
+ *
+ * Provides typed access to the local todo list.
+ * Separates todo from bd (issue tracker).
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/**
+ * Todo item status
+ */
+export type TodoStatus = "pending" | "in_progress" | "completed" | "deleted";
+/**
+ * A single todo item
+ */
+export interface TodoItem {
+    id: number;
+    subject: string;
+    description?: string;
+    status: TodoStatus;
+    activeForm?: string;
+    blockedBy?: number[];
+    owner?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Snapshot of the todo list at a point in time
+ */
+export interface TodoSnapshot {
+    items: TodoItem[];
+    sessionId: string;
+    revision: number;
+    createdAt: Date;
+}
+/**
+ * Availability result for todo provider
+ */
+export interface TodoAvailability {
+    available: boolean;
+    error?: string;
+    provider?: string;
+}
+/**
+ * Todo Provider interface
+ */
+export interface TodoProvider {
+    /**
+     * Check if todo is available
+     */
+    availability(): Promise<TodoAvailability>;
+    /**
+     * Get current snapshot of todo list
+     */
+    getSnapshot(): Promise<TodoSnapshot>;
+    /**
+     * Get items by status
+     */
+    getByStatus(status: TodoStatus): Promise<TodoItem[]>;
+    /**
+     * Get in-progress items
+     */
+    getInProgress(): Promise<TodoItem[]>;
+    /**
+     * Get pending items (not completed)
+     */
+    getPending(): Promise<TodoItem[]>;
+    /**
+     * Get completed items
+     */
+    getCompleted(): Promise<TodoItem[]>;
+    /**
+     * Get ready items (pending with satisfied dependencies)
+     */
+    getReady(): Promise<TodoItem[]>;
+    /**
+     * Get blocked items (pending with unsatisfied dependencies)
+     */
+    getBlocked(): Promise<TodoItem[]>;
+}
+/**
+ * Mock Todo Provider for testing
+ */
+export declare class MockTodoProvider implements TodoProvider {
+    private items;
+    private _sessionId;
+    private _revision;
+    constructor(sessionId?: string);
+    availability(): Promise<TodoAvailability>;
+    getSnapshot(): Promise<TodoSnapshot>;
+    getByStatus(status: TodoStatus): Promise<TodoItem[]>;
+    getInProgress(): Promise<TodoItem[]>;
+    getPending(): Promise<TodoItem[]>;
+    getCompleted(): Promise<TodoItem[]>;
+    getReady(): Promise<TodoItem[]>;
+    getBlocked(): Promise<TodoItem[]>;
+    addItem(item: Omit<TodoItem, "id">): TodoItem;
+    setStatus(id: number, status: TodoStatus): void;
+    clear(): void;
+}
+/**
+ * Create a todo provider based on available tools
+ */
+export declare function createTodoProvider(pi?: ExtensionAPI): TodoProvider;
+//# sourceMappingURL=todo-provider.d.ts.map

package/packages/jev-judge/dist/todo-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-provider.d.ts","sourceRoot":"","sources":["../src/todo-provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAE1C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAErC;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErD;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAErC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAElC;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEpC;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEhC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACpD,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAK;IAEtB,YAAY,SAAS,CAAC,EAAE,MAAM,EAE7B;IAEK,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAE9C;IAEK,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,CAQzC;IAEK,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAEzD;IAEK,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAEzC;IAEK,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAEtC;IAEK,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAExC;IAEK,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CASpC;IAEK,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAStC;IAGD,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,QAAQ,CAK5C;IAED,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAK9C;IAED,KAAK,IAAI,IAAI,CAGZ;CACD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,YAAY,GAAG,YAAY,CAKlE"}

package/packages/jev-judge/dist/todo-provider.js

@@ -0,0 +1,119 @@
+/**
+ * Todo Provider - Read local todo state
+ *
+ * Provides typed access to the local todo list.
+ * Separates todo from bd (issue tracker).
+ */
+/**
+ * Mock Todo Provider for testing
+ */
+export class MockTodoProvider {
+    items = [];
+    _sessionId;
+    _revision = 0;
+    constructor(sessionId) {
+        this._sessionId = sessionId ?? `mock-${Date.now()}`;
+    }
+    async availability() {
+        return { available: true, provider: "mock" };
+    }
+    async getSnapshot() {
+        this._revision++;
+        return {
+            items: [...this.items],
+            sessionId: this._sessionId,
+            revision: this._revision,
+            createdAt: new Date(),
+        };
+    }
+    async getByStatus(status) {
+        return this.items.filter((item) => item.status === status);
+    }
+    async getInProgress() {
+        return this.getByStatus("in_progress");
+    }
+    async getPending() {
+        return this.items.filter((item) => item.status === "pending");
+    }
+    async getCompleted() {
+        return this.getByStatus("completed");
+    }
+    async getReady() {
+        const pending = await this.getPending();
+        return pending.filter((item) => {
+            if (!item.blockedBy?.length)
+                return true;
+            const blockedIds = new Set(item.blockedBy);
+            return !this.items.some((i) => blockedIds.has(i.id) && i.status !== "completed");
+        });
+    }
+    async getBlocked() {
+        const pending = await this.getPending();
+        return pending.filter((item) => {
+            if (!item.blockedBy?.length)
+                return false;
+            const blockedIds = new Set(item.blockedBy);
+            return this.items.some((i) => blockedIds.has(i.id) && i.status !== "completed");
+        });
+    }
+    // Test helpers
+    addItem(item) {
+        const id = this.items.length + 1;
+        const newItem = { ...item, id };
+        this.items.push(newItem);
+        return newItem;
+    }
+    setStatus(id, status) {
+        const item = this.items.find((i) => i.id === id);
+        if (item) {
+            item.status = status;
+        }
+    }
+    clear() {
+        this.items = [];
+        this._revision++;
+    }
+}
+/**
+ * Create a todo provider based on available tools
+ */
+export function createTodoProvider(pi) {
+    // Check if Pi exposes a todo API
+    // For now, Pi does not expose a todo extension API
+    // Return a provider that reports unavailability
+    return new PiUnavailableTodoProvider();
+}
+/**
+ * Provider that reports Pi todo extension is not available
+ */
+class PiUnavailableTodoProvider {
+    async availability() {
+        return {
+            available: false,
+            error: "Pi does not expose a todo extension API. Todo state is not available.",
+            provider: "pi-todo",
+        };
+    }
+    async getSnapshot() {
+        throw new Error("Pi todo extension is not available");
+    }
+    async getByStatus(_status) {
+        return [];
+    }
+    async getInProgress() {
+        return [];
+    }
+    async getPending() {
+        return [];
+    }
+    async getCompleted() {
+        return [];
+    }
+    async getReady() {
+        return [];
+    }
+    async getBlocked() {
+        return [];
+    }
+}
+//# sourceMappingURL=todo-provider.js.map

package/packages/jev-judge/dist/todo-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-provider.js","sourceRoot":"","sources":["../src/todo-provider.ts"],"names":[],"mappings":"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"}

package/packages/jev-judge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/jev-judge",
-  "version": "1.1.192",
+  "version": "1.1.194",
   "description": "Jev Judge - Structured decision model for agent routing, E2E testing, and automated decisions",
   "type": "module",
   "main": "./dist/index.js",