pi-harness-runtime 0.9.25 → 1.1.0

package/packages/autonomous-runtime/dist/inbox.js

@@ -6,23 +6,23 @@
  */
 import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from "node:fs";
 import { getInboxDir, getTasksPath } from "./types.js";
-// ─── Errors ───────────────────────────────────────────────────────────────────
+// --- Errors -------------------------------------------------------------------
 export class InboxError extends Error {
     constructor(msg) {
         super(`[InboxError] ${msg}`);
         this.name = "InboxError";
     }
 }
-// ─── TaskInbox ────────────────────────────────────────────────────────────────
+// --- TaskInbox ----------------------------------------------------------------
 /**
  * Manages the append-only task inbox at `~/.pi/harness/inbox/tasks.jsonl`.
  *
  * Storage layout:
  * ```
  * ~/.pi/harness/inbox/
- * ├── tasks.jsonl   # append-only log (one JSON line per task)
- * ├── claimed/      # active leases (one JSON file per task)
- * └── BACKLOG.md   # human-friendly authoring surface (optional)
+ * +-- tasks.jsonl   # append-only log (one JSON line per task)
+ * +-- claimed/      # active leases (one JSON file per task)
+ * +-- BACKLOG.md   # human-friendly authoring surface (optional)
  * ```
  *
  * Operations are:
@@ -46,7 +46,7 @@ export class TaskInbox {
             mkdirSync(this.inboxDir, { recursive: true });
         }
     }
-    // ─── append ──────────────────────────────────────────────────────────────
+    // --- append --------------------------------------------------------------
     /**
      * Append a new task to tasks.jsonl.
      * The task is validated before writing. Duplicate ids are rejected.
@@ -64,7 +64,7 @@ export class TaskInbox {
         appendFileSync(this.tasksPath, line, "utf8");
         this._cache = null; // invalidate
     }
-    // ─── list ─────────────────────────────────────────────────────────────────
+    // --- list -----------------------------------------------------------------
     /**
      * Read all tasks from tasks.jsonl.
      * Results are sorted by priority ASC then createdAt ASC (oldest first).
@@ -106,13 +106,13 @@ export class TaskInbox {
         });
         return filtered;
     }
-    // ─── get ─────────────────────────────────────────────────────────────────
+    // --- get -----------------------------------------------------------------
     /** Retrieve a single task by id, or null if not found. */
     get(id) {
         const tasks = this.list();
         return tasks.find((t) => t.id === id) ?? null;
     }
-    // ─── transition ──────────────────────────────────────────────────────────
+    // --- transition ----------------------------------------------------------
     /**
      * Update a task's status in-place inside tasks.jsonl.
      *
@@ -159,7 +159,7 @@ export class TaskInbox {
         this._cache = null;
         return updated;
     }
-    // ─── markDone / markFailed ───────────────────────────────────────────────
+    // --- markDone / markFailed -----------------------------------------------
     /** Convenience: mark a task as completed with a result. */
     complete(taskId, result) {
         return this.transition(taskId, "completed", { result }, {
@@ -179,7 +179,7 @@ export class TaskInbox {
             payload: { reason, attempts },
         });
     }
-    // ─── reindex ─────────────────────────────────────────────────────────────
+    // --- reindex -------------------------------------------------------------
     /** Rewrite tasks.jsonl from the given task list. */
     _rewriteAll(tasks) {
         const tmp = `${this.tasksPath}.tmp`;
@@ -198,7 +198,7 @@ export class TaskInbox {
         this._rewriteAll(tasks);
         this._cache = null;
     }
-    // ─── count ───────────────────────────────────────────────────────────────
+    // --- count ---------------------------------------------------------------
     /** Return counts of tasks grouped by status. */
     stats() {
         const tasks = this.list();

package/packages/autonomous-runtime/dist/lease.js

@@ -7,9 +7,9 @@
  * Filesystem layout:
  * ```
  * ~/.pi/harness/inbox/
- * ├── tasks.jsonl        # task records
- * └── claimed/
- *     └── <task-id>.lease.json   # one lease file per claimed task
+ * +-- tasks.jsonl        # task records
+ * +-- claimed/
+ *     +-- <task-id>.lease.json   # one lease file per claimed task
  * ```
  *
  * Safety properties:
@@ -20,14 +20,14 @@
 import { closeSync, existsSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync, writeSync, } from "node:fs";
 import { join } from "node:path";
 import { getLeasesDir } from "./types.js";
-// ─── Errors ───────────────────────────────────────────────────────────────────
+// --- Errors -------------------------------------------------------------------
 export class LeaseError extends Error {
     constructor(msg) {
         super(`[LeaseError] ${msg}`);
         this.name = "LeaseError";
     }
 }
-// ─── Constants ────────────────────────────────────────────────────────────────
+// --- Constants ----------------------------------------------------------------
 /** Default lease duration before heartbeat extension is required. */
 export const DEFAULT_LEASE_TTL_MS = 30_000; // 30 s
 /** Heartbeat interval sent by the worker. */
@@ -50,7 +50,7 @@ export class LeaseManager {
             mkdirSync(this.leasesDir, { recursive: true });
         }
     }
-    // ─── claim ───────────────────────────────────────────────────────────────
+    // --- claim ---------------------------------------------------------------
     /**
      * Atomically claim a task for a worker.
      *
@@ -111,7 +111,7 @@ export class LeaseManager {
             throw err;
         }
     }
-    // ─── heartbeat ────────────────────────────────────────────────────────────
+    // --- heartbeat ------------------------------------------------------------
     /**
      * Extend a lease's expiry time.
      * Only the worker that holds the lease can extend it.
@@ -133,7 +133,7 @@ export class LeaseManager {
         this._writeLease(updated);
         return updated;
     }
-    // ─── release ─────────────────────────────────────────────────────────────
+    // --- release -------------------------------------------------------------
     /**
      * Explicitly release a lease (task completed or failed without retry).
      */
@@ -146,7 +146,7 @@ export class LeaseManager {
         }
         this._removeLease(taskId);
     }
-    // ─── get ─────────────────────────────────────────────────────────────────
+    // --- get -----------------------------------------------------------------
     /** Read a lease by taskId. Returns null if not found. */
     get(taskId) {
         const path = this._leasePath(taskId);
@@ -159,12 +159,12 @@ export class LeaseManager {
             return null;
         }
     }
-    // ─── isExpired ────────────────────────────────────────────────────────────
+    // --- isExpired ------------------------------------------------------------
     /** Check if a lease has expired (expiresAt is in the past). */
     isExpired(lease) {
         return new Date(lease.expiresAt).getTime() < Date.now();
     }
-    // ─── reap ────────────────────────────────────────────────────────────────
+    // --- reap ----------------------------------------------------------------
     /**
      * Scan all leases and return the ones that have expired.
      * Does NOT remove them — call reapAndRelease() to remove atomically.
@@ -214,7 +214,7 @@ export class LeaseManager {
         }
         return released;
     }
-    // ─── recoverOrphanLeases ─────────────────────────────────────────────────
+    // --- recoverOrphanLeases -------------------------------------------------
     /**
      * On worker startup, release any leases held by dead workers.
      * A lease is orphaned if its worker has not re-claimed it since startup.
@@ -225,7 +225,7 @@ export class LeaseManager {
     recoverOnStartup() {
         return this.reapAndRelease();
     }
-    // ─── listActive ───────────────────────────────────────────────────────────
+    // --- listActive -----------------------------------------------------------
     /** Return all active (non-expired) leases. */
     listActive() {
         if (!existsSync(this.leasesDir))
@@ -254,7 +254,7 @@ export class LeaseManager {
         }
         return active;
     }
-    // ─── internals ───────────────────────────────────────────────────────────
+    // --- internals -----------------------------------------------------------
     _leasePath(taskId) {
         return join(this.leasesDir, `${taskId}.lease.json`);
     }

package/packages/autonomous-runtime/dist/types.js

@@ -6,7 +6,7 @@
  * These types are the canonical contracts. Do not re-define them in other packages.
  */
 import { env } from "node:process";
-// ─── Storage paths ────────────────────────────────────────────────────────────
+// --- Storage paths ------------------------------------------------------------
 const DEFAULT_ROOT = `${env["HOME"] ?? "."}/.pi/harness`;
 /** Returns the standard storage root for the runtime. */
 export function getRuntimeRoot() {

package/packages/autonomous-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi/autonomous-runtime",
-  "version": "0.9.24",
+  "version": "1.1.0",
   "description": "Autonomous Operations Runtime — task inbox, lease management, and worker lifecycle (RFC-0101)",
   "type": "module",
   "main": "./dist/index.js",

package/packages/autonomous-runtime/src/inbox.ts

@@ -15,7 +15,7 @@ import { dirname } from "node:path";
 import type { TaskRecord, TaskStatus, TaskEvent } from "./types.js";
 import { getInboxDir, getTasksPath } from "./types.js";
 
-// ─── Errors ───────────────────────────────────────────────────────────────────
+// --- Errors -------------------------------------------------------------------
 
 export class InboxError extends Error {
 	constructor(msg: string) {
@@ -24,7 +24,7 @@ export class InboxError extends Error {
 	}
 }
 
-// ─── TaskInbox ────────────────────────────────────────────────────────────────
+// --- TaskInbox ----------------------------------------------------------------
 
 /**
  * Manages the append-only task inbox at `~/.pi/harness/inbox/tasks.jsonl`.
@@ -32,9 +32,9 @@ export class InboxError extends Error {
  * Storage layout:
  * ```
  * ~/.pi/harness/inbox/
- * ├── tasks.jsonl   # append-only log (one JSON line per task)
- * ├── claimed/      # active leases (one JSON file per task)
- * └── BACKLOG.md   # human-friendly authoring surface (optional)
+ * +-- tasks.jsonl   # append-only log (one JSON line per task)
+ * +-- claimed/      # active leases (one JSON file per task)
+ * +-- BACKLOG.md   # human-friendly authoring surface (optional)
  * ```
  *
  * Operations are:
@@ -61,7 +61,7 @@ export class TaskInbox {
 		}
 	}
 
-	// ─── append ──────────────────────────────────────────────────────────────
+	// --- append --------------------------------------------------------------
 
 	/**
 	 * Append a new task to tasks.jsonl.
@@ -85,7 +85,7 @@ export class TaskInbox {
 		this._cache = null; // invalidate
 	}
 
-	// ─── list ─────────────────────────────────────────────────────────────────
+	// --- list -----------------------------------------------------------------
 
 	/**
 	 * Read all tasks from tasks.jsonl.
@@ -131,7 +131,7 @@ export class TaskInbox {
 		return filtered;
 	}
 
-	// ─── get ─────────────────────────────────────────────────────────────────
+	// --- get -----------------------------------------------------------------
 
 	/** Retrieve a single task by id, or null if not found. */
 	get(id: string): TaskRecord | null {
@@ -139,7 +139,7 @@ export class TaskInbox {
 		return tasks.find((t) => t.id === id) ?? null;
 	}
 
-	// ─── transition ──────────────────────────────────────────────────────────
+	// --- transition ----------------------------------------------------------
 
 	/**
 	 * Update a task's status in-place inside tasks.jsonl.
@@ -197,7 +197,7 @@ export class TaskInbox {
 		return updated;
 	}
 
-	// ─── markDone / markFailed ───────────────────────────────────────────────
+	// --- markDone / markFailed -----------------------------------------------
 
 	/** Convenience: mark a task as completed with a result. */
 	complete(taskId: string, result: TaskRecord["result"]): TaskRecord {
@@ -231,7 +231,7 @@ export class TaskInbox {
 		);
 	}
 
-	// ─── reindex ─────────────────────────────────────────────────────────────
+	// --- reindex -------------------------------------------------------------
 
 	/** Rewrite tasks.jsonl from the given task list. */
 	private _rewriteAll(tasks: TaskRecord[]): void {
@@ -252,7 +252,7 @@ export class TaskInbox {
 		this._cache = null;
 	}
 
-	// ─── count ───────────────────────────────────────────────────────────────
+	// --- count ---------------------------------------------------------------
 
 	/** Return counts of tasks grouped by status. */
 	stats(): Record<TaskStatus, number> {

package/packages/autonomous-runtime/src/lease.ts

@@ -7,9 +7,9 @@
  * Filesystem layout:
  * ```
  * ~/.pi/harness/inbox/
- * ├── tasks.jsonl        # task records
- * └── claimed/
- *     └── <task-id>.lease.json   # one lease file per claimed task
+ * +-- tasks.jsonl        # task records
+ * +-- claimed/
+ *     +-- <task-id>.lease.json   # one lease file per claimed task
  * ```
  *
  * Safety properties:
@@ -33,7 +33,7 @@ import { join } from "node:path";
 import type { TaskLease } from "./types.js";
 import { getLeasesDir } from "./types.js";
 
-// ─── Errors ───────────────────────────────────────────────────────────────────
+// --- Errors -------------------------------------------------------------------
 
 export class LeaseError extends Error {
 	constructor(msg: string) {
@@ -42,7 +42,7 @@ export class LeaseError extends Error {
 	}
 }
 
-// ─── Constants ────────────────────────────────────────────────────────────────
+// --- Constants ----------------------------------------------------------------
 
 /** Default lease duration before heartbeat extension is required. */
 export const DEFAULT_LEASE_TTL_MS = 30_000; // 30 s
@@ -53,7 +53,7 @@ export const HEARTBEAT_INTERVAL_MS = 5_000; // 5 s
 /** Default worker heartbeat interval extension. */
 export const HEARTBEAT_EXTENSION_MS = 30_000; // extend by 30 s
 
-// ─── LeaseManager ─────────────────────────────────────────────────────────────
+// --- LeaseManager -------------------------------------------------------------
 
 export interface LeaseOptions {
 	leasesDir?: string;
@@ -80,7 +80,7 @@ export class LeaseManager {
 		}
 	}
 
-	// ─── claim ───────────────────────────────────────────────────────────────
+	// --- claim ---------------------------------------------------------------
 
 	/**
 	 * Atomically claim a task for a worker.
@@ -143,7 +143,7 @@ export class LeaseManager {
 		}
 	}
 
-	// ─── heartbeat ────────────────────────────────────────────────────────────
+	// --- heartbeat ------------------------------------------------------------
 
 	/**
 	 * Extend a lease's expiry time.
@@ -170,7 +170,7 @@ export class LeaseManager {
 		return updated;
 	}
 
-	// ─── release ─────────────────────────────────────────────────────────────
+	// --- release -------------------------------------------------------------
 
 	/**
 	 * Explicitly release a lease (task completed or failed without retry).
@@ -186,7 +186,7 @@ export class LeaseManager {
 		this._removeLease(taskId);
 	}
 
-	// ─── get ─────────────────────────────────────────────────────────────────
+	// --- get -----------------------------------------------------------------
 
 	/** Read a lease by taskId. Returns null if not found. */
 	get(taskId: string): TaskLease | null {
@@ -199,14 +199,14 @@ export class LeaseManager {
 		}
 	}
 
-	// ─── isExpired ────────────────────────────────────────────────────────────
+	// --- isExpired ------------------------------------------------------------
 
 	/** Check if a lease has expired (expiresAt is in the past). */
 	isExpired(lease: TaskLease): boolean {
 		return new Date(lease.expiresAt).getTime() < Date.now();
 	}
 
-	// ─── reap ────────────────────────────────────────────────────────────────
+	// --- reap ----------------------------------------------------------------
 
 	/**
 	 * Scan all leases and return the ones that have expired.
@@ -256,7 +256,7 @@ export class LeaseManager {
 		return released;
 	}
 
-	// ─── recoverOrphanLeases ─────────────────────────────────────────────────
+	// --- recoverOrphanLeases -------------------------------------------------
 
 	/**
 	 * On worker startup, release any leases held by dead workers.
@@ -269,7 +269,7 @@ export class LeaseManager {
 		return this.reapAndRelease();
 	}
 
-	// ─── listActive ───────────────────────────────────────────────────────────
+	// --- listActive -----------------------------------------------------------
 
 	/** Return all active (non-expired) leases. */
 	listActive(): TaskLease[] {
@@ -298,7 +298,7 @@ export class LeaseManager {
 		return active;
 	}
 
-	// ─── internals ───────────────────────────────────────────────────────────
+	// --- internals -----------------------------------------------------------
 
 	private _leasePath(taskId: string): string {
 		return join(this.leasesDir, `${taskId}.lease.json`);

package/packages/autonomous-runtime/src/types.ts

@@ -7,7 +7,7 @@
  */
 import { env } from "node:process";
 
-// ─── Capability model ──────────────────────────────────────────────────────────
+// --- Capability model ----------------------------------------------------------
 
 /** A named capability that the privilege broker may grant. */
 export type CapabilityName =
@@ -35,7 +35,7 @@ export type ApprovalClass =
 	| "human_approval_required" // must ask operator
 	| "forbidden"; // never grant, regardless of override
 
-// ─── Task lifecycle ───────────────────────────────────────────────────────────
+// --- Task lifecycle -----------------------------------------------------------
 
 export type TaskStatus =
 	| "queued"
@@ -68,7 +68,7 @@ export type TaskEvent = {
 	payload?: Record<string, unknown>;
 };
 
-// ─── Task record ─────────────────────────────────────────────────────────────
+// --- Task record -------------------------------------------------------------
 
 /** The primary durable record for a task. */
 export interface TaskRecord {
@@ -96,7 +96,7 @@ export interface TaskRecord {
 	history: TaskEvent[];
 }
 
-// ─── Leasing ──────────────────────────────────────────────────────────────────
+// --- Leasing ------------------------------------------------------------------
 
 /** A lease held by a worker on a specific task. */
 export interface TaskLease {
@@ -108,7 +108,7 @@ export interface TaskLease {
 	attempt: number; // which attempt this lease covers
 }
 
-// ─── Worker registry ──────────────────────────────────────────────────────────
+// --- Worker registry ----------------------------------------------------------
 
 /** Heartbeat emitted by a worker every 5 s to worker-registry.json. */
 export interface WorkerHeartbeat {
@@ -119,7 +119,7 @@ export interface WorkerHeartbeat {
 	inflightTaskIds: string[];
 }
 
-// ─── Privilege broker ─────────────────────────────────────────────────────────
+// --- Privilege broker ---------------------------------------------------------
 
 /** A resolved grant from the privilege broker. */
 export interface CapabilityGrant {
@@ -131,7 +131,7 @@ export interface CapabilityGrant {
 	timeoutMs: number;
 }
 
-// ─── Approval ─────────────────────────────────────────────────────────────────
+// --- Approval -----------------------------------------------------------------
 
 /** An in-flight human approval request. */
 export interface ApprovalRequest {
@@ -145,7 +145,7 @@ export interface ApprovalRequest {
 	expiresAt: string; // ISO-8601 — timeout threshold
 }
 
-// ─── Scheduler ───────────────────────────────────────────────────────────────
+// --- Scheduler ---------------------------------------------------------------
 
 /** A scheduled recurring task. */
 export interface ScheduledTask {
@@ -165,7 +165,7 @@ export type ScheduleSpec =
 	| { kind: "interval"; intervalMs: number }
 	| { kind: "once"; at: string };
 
-// ─── Notification ─────────────────────────────────────────────────────────────
+// --- Notification -------------------------------------------------------------
 
 export type RuntimeNotificationEvent =
 	| "task.claimed"
@@ -189,7 +189,7 @@ export interface NotificationEvent {
 	payload: Record<string, unknown>;
 }
 
-// ─── Checkpoint ───────────────────────────────────────────────────────────────
+// --- Checkpoint ---------------------------------------------------------------
 
 export interface Checkpoint {
 	taskId: string;
@@ -198,7 +198,7 @@ export interface Checkpoint {
 	savedAt: string; // ISO-8601
 }
 
-// ─── Execution context ────────────────────────────────────────────────────────
+// --- Execution context --------------------------------------------------------
 
 /** The context given to the loop runtime when executing a task. */
 export interface ExecutionContext {
@@ -212,7 +212,7 @@ export interface ExecutionContext {
 	okfBundles: string[]; // content hashes available to planner
 }
 
-// ─── Task result ─────────────────────────────────────────────────────────────
+// --- Task result -------------------------------------------------------------
 
 export interface TaskResult {
 	taskId: string;
@@ -227,7 +227,7 @@ export interface TaskResult {
 	modelUsage?: { inputTokens: number; outputTokens: number; provider: string };
 }
 
-// ─── Storage paths ────────────────────────────────────────────────────────────
+// --- Storage paths ------------------------------------------------------------
 
 const DEFAULT_ROOT = `${env["HOME"] ?? "."}/.pi/harness`;