pi-harness-runtime 0.9.25 → 0.10.0

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`;