pi-harness-runtime 0.10.11 → 0.10.13

package/packages/experience-replay/dist/types.d.ts.map

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

package/packages/experience-replay/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Experience Replay Types (RFC-0059)
+ *
+ * Interfaces for replaying prior runtime execution.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/experience-replay/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/packages/experience-replay/src/index.ts

@@ -0,0 +1,19 @@
+/**
+ * Experience Replay (RFC-0059)
+ *
+ * Re-exports all public types and classes.
+ */
+
+export { ExperienceReplay, createExperienceReplay } from "./replay.js";
+export type {
+	ReplayRequest,
+	ReplayResult,
+	ReplayEvent,
+	ReplayDivergence,
+	JobStateSnapshot,
+	ReplaySources,
+	DivergenceCheck,
+	DivergenceReason,
+	ReplayRuntimeEvent,
+	ReplayMode,
+} from "./types.js";

package/packages/experience-replay/src/replay.ts

@@ -0,0 +1,348 @@
+/**
+ * Experience Replay (RFC-0059)
+ *
+ * Reconstructs prior runtime execution from persisted events and checkpoints.
+ */
+
+import type {
+	ReplayRequest,
+	ReplayResult,
+	ReplayEvent,
+	ReplayDivergence,
+	JobStateSnapshot,
+	ReplaySources,
+	DivergenceReason,
+	ReplayRuntimeEvent,
+	RuntimeEvent,
+	RuntimeCheckpoint,
+	TaskGraph,
+} from "./types.js";
+
+// --- Event Timeline Reconstruction -------------------------------------------
+
+function reconstructTimeline(
+	events: RuntimeEvent[],
+	startSequence = 0,
+): ReplayEvent[] {
+	return events.map((event, index) => ({
+		sequence: startSequence + index,
+		timestamp: event.ts,
+		type: event.type,
+		data: event.data || {},
+	}));
+}
+
+// --- State Reconstruction -----------------------------------------------------
+
+function reconstructState(
+	jobId: string,
+	checkpoint: RuntimeCheckpoint | undefined,
+	events: RuntimeEvent[],
+	taskGraph: TaskGraph | undefined,
+): JobStateSnapshot {
+	// Apply events to checkpoint to get final state
+	let currentTaskId = checkpoint?.currentTaskId;
+	let status = checkpoint?.status || "unknown";
+
+	// Process events to find latest state
+	for (const event of events) {
+		if (event.type === "task.started" && event.data?.taskId) {
+			currentTaskId = event.data.taskId as string;
+		}
+		if (event.type === "job.status") {
+			status = (event.data?.status as string) || status;
+		}
+	}
+
+	return {
+		jobId,
+		status,
+		currentTaskId,
+		checkpoint: checkpoint || {
+			version: 0,
+			jobId,
+			status: "unknown",
+			requirement: "",
+			createdAt: new Date().toISOString(),
+			updatedAt: new Date().toISOString(),
+		},
+		taskGraph: taskGraph || { nodes: [], edges: [] },
+		events,
+		timestamp: new Date().toISOString(),
+	};
+}
+
+// --- Divergence Detection ----------------------------------------------------
+
+// --- Source Validation --------------------------------------------------------
+
+function validateSources(sources: ReplaySources): {
+	valid: boolean;
+	missing: string[];
+} {
+	const missing: string[] = [];
+
+	if (!sources.checkpoint && !sources.events) {
+		missing.push("checkpoint or events");
+	}
+
+	return { valid: missing.length === 0, missing };
+}
+
+// --- Mode Handlers ------------------------------------------------------------
+
+async function handleInspect(
+	sources: ReplaySources,
+	jobId: string,
+	fromSequence?: number,
+	toSequence?: number,
+): Promise<{ state: JobStateSnapshot; timeline: ReplayEvent[] }> {
+	const events = sources.events || [];
+	const filteredEvents =
+		fromSequence !== undefined || toSequence !== undefined
+			? events.slice(fromSequence, toSequence)
+			: events;
+
+	const timeline = reconstructTimeline(filteredEvents, fromSequence ?? 0);
+	const state = reconstructState(
+		jobId,
+		sources.checkpoint,
+		filteredEvents,
+		sources.taskGraph,
+	);
+
+	return { state, timeline };
+}
+
+async function handleSimulate(
+	sources: ReplaySources,
+	jobId: string,
+	fromSequence?: number,
+	toSequence?: number,
+): Promise<{
+	state: JobStateSnapshot;
+	timeline: ReplayEvent[];
+	divergences: ReplayDivergence[];
+}> {
+	const events = sources.events || [];
+	const filteredEvents =
+		fromSequence !== undefined || toSequence !== undefined
+			? events.slice(fromSequence, toSequence)
+			: events;
+
+	const timeline = reconstructTimeline(filteredEvents, fromSequence ?? 0);
+	const state = reconstructState(
+		jobId,
+		sources.checkpoint,
+		filteredEvents,
+		sources.taskGraph,
+	);
+
+	// Check for divergent events
+	const divergences: ReplayDivergence[] = [];
+	for (let i = 0; i < timeline.length; i++) {
+		const event = timeline[i];
+		if (event.type.includes("error") || event.type.includes("failure")) {
+			divergences.push({
+				sequence: event.sequence,
+				reason: "Provider output differs" as DivergenceReason,
+				severity: "warning",
+			});
+		}
+	}
+
+	return { state, timeline, divergences };
+}
+
+async function handleReexecute(
+	sources: ReplaySources,
+	jobId: string,
+	allowExternalCalls: boolean,
+): Promise<{
+	state: JobStateSnapshot;
+	timeline: ReplayEvent[];
+	divergences: ReplayDivergence[];
+}> {
+	// Reexecute requires explicit approval and valid sources
+	const validation = validateSources(sources);
+	if (!validation.valid) {
+		throw new Error(
+			`Missing required sources: ${validation.missing.join(", ")}`,
+		);
+	}
+
+	if (!allowExternalCalls) {
+		throw new Error(
+			"Reexecution with external calls requires explicit approval",
+		);
+	}
+
+	// For reexecution, we simulate first then mark for actual reexecution
+	const result = await handleSimulate(sources, jobId);
+
+	// Add informational divergence for reexecution mode
+	result.divergences.push({
+		sequence: 0,
+		reason: "Runtime version differs" as DivergenceReason,
+		severity: "info",
+	});
+
+	return result;
+}
+
+// --- Main Engine ---------------------------------------------------------------
+
+export class ExperienceReplay {
+	private eventListeners: Array<(event: ReplayRuntimeEvent) => void> = [];
+
+	/**
+	 * Replay a prior job execution
+	 */
+	async replay(
+		request: ReplayRequest,
+		sources: ReplaySources,
+	): Promise<ReplayResult> {
+		const { jobId, mode } = request;
+
+		// Emit start event
+		this.emit({ type: "replay.started", jobId, mode });
+
+		// Validate sources
+		const validation = validateSources(sources);
+		if (!validation.valid) {
+			return {
+				jobId,
+				reconstructedState: {
+					jobId,
+					status: "error",
+					checkpoint: sources.checkpoint || ({} as RuntimeCheckpoint),
+					taskGraph: sources.taskGraph || { nodes: [], edges: [] },
+					events: [],
+					timestamp: new Date().toISOString(),
+				},
+				timeline: [],
+				divergences: [
+					{
+						sequence: 0,
+						reason: `Missing sources: ${validation.missing.join(", ")}`,
+						severity: "error",
+					},
+				],
+				artifacts: [],
+				replayedAt: new Date().toISOString(),
+			};
+		}
+
+		try {
+			let result: {
+				state: JobStateSnapshot;
+				timeline: ReplayEvent[];
+				divergences?: ReplayDivergence[];
+			};
+
+			switch (mode) {
+				case "inspect":
+					result = await handleInspect(
+						sources,
+						jobId,
+						request.fromSequence,
+						request.toSequence,
+					);
+					break;
+				case "simulate":
+					result = await handleSimulate(
+						sources,
+						jobId,
+						request.fromSequence,
+						request.toSequence,
+					);
+					break;
+				case "reexecute":
+					result = await handleReexecute(
+						sources,
+						jobId,
+						request.allowExternalCalls,
+					);
+					break;
+			}
+
+			// Emit divergence events
+			if (result.divergences) {
+				for (const div of result.divergences) {
+					this.emit({
+						type: "replay.divergence.detected",
+						jobId,
+						reason: div.reason,
+					});
+				}
+			}
+
+			// Collect artifacts
+			const artifacts: string[] = [];
+			if (sources.prompts) artifacts.push(...Object.keys(sources.prompts));
+			if (sources.outputs) artifacts.push(...Object.keys(sources.outputs));
+
+			// Emit completion event
+			this.emit({ type: "replay.completed", jobId });
+
+			return {
+				jobId,
+				reconstructedState: result.state,
+				timeline: result.timeline,
+				divergences: result.divergences || [],
+				artifacts,
+				replayedAt: new Date().toISOString(),
+			};
+		} catch (error) {
+			const errorMessage =
+				error instanceof Error ? error.message : String(error);
+			return {
+				jobId,
+				reconstructedState: {
+					jobId,
+					status: "error",
+					checkpoint: sources.checkpoint || ({} as RuntimeCheckpoint),
+					taskGraph: sources.taskGraph || { nodes: [], edges: [] },
+					events: [],
+					timestamp: new Date().toISOString(),
+				},
+				timeline: [],
+				divergences: [
+					{
+						sequence: 0,
+						reason: errorMessage,
+						severity: "error",
+					},
+				],
+				artifacts: [],
+				replayedAt: new Date().toISOString(),
+			};
+		}
+	}
+
+	/**
+	 * Subscribe to replay events
+	 */
+	onEvent(listener: (event: ReplayRuntimeEvent) => void): () => void {
+		this.eventListeners.push(listener);
+		return () => {
+			this.eventListeners = this.eventListeners.filter((l) => l !== listener);
+		};
+	}
+
+	private emit(event: ReplayRuntimeEvent): void {
+		for (const listener of this.eventListeners) {
+			try {
+				listener(event);
+			} catch {
+				// Best effort
+			}
+		}
+	}
+}
+
+// --- Factory -----------------------------------------------------------------
+
+export function createExperienceReplay(): ExperienceReplay {
+	return new ExperienceReplay();
+}

package/packages/experience-replay/src/types.ts

@@ -0,0 +1,128 @@
+/**
+ * Experience Replay Types (RFC-0059)
+ *
+ * Interfaces for replaying prior runtime execution.
+ */
+
+// --- Local Type Definitions -----------------------------------------------
+
+export interface RuntimeEvent {
+	ts: string;
+	jobId: string;
+	type: string;
+	message: string;
+	data?: Record<string, unknown>;
+}
+
+export interface RuntimeCheckpoint {
+	version: number;
+	jobId: string;
+	status: string;
+	requirement: string;
+	currentTaskId?: string;
+	provider?: string;
+	resumeAt?: string;
+	lastError?: string;
+	createdAt: string;
+	updatedAt: string;
+}
+
+export interface TaskGraphNode {
+	id: string;
+	title: string;
+	description: string;
+	status: string;
+	dependencies: string[];
+}
+
+export interface TaskGraph {
+	nodes: TaskGraphNode[];
+	edges: Array<{ from: string; to: string }>;
+}
+
+// --- Replay Types -------------------------------------------------------------
+
+export type ReplayMode = "inspect" | "simulate" | "reexecute";
+
+export interface ReplayRequest {
+	jobId: string;
+	mode: ReplayMode;
+	fromSequence?: number;
+	toSequence?: number;
+	allowExternalCalls: boolean;
+}
+
+export interface JobStateSnapshot {
+	jobId: string;
+	status: string;
+	currentTaskId?: string;
+	checkpoint: RuntimeCheckpoint;
+	taskGraph: TaskGraph;
+	events: RuntimeEvent[];
+	timestamp: string;
+}
+
+export interface ReplayEvent {
+	sequence: number;
+	timestamp: string;
+	type: string;
+	data: Record<string, unknown>;
+}
+
+export interface ReplayDivergence {
+	sequence: number;
+	reason: string;
+	expected?: unknown;
+	actual?: unknown;
+	severity: "info" | "warning" | "error";
+}
+
+export interface ReplayResult {
+	jobId: string;
+	reconstructedState: JobStateSnapshot;
+	timeline: ReplayEvent[];
+	divergences: ReplayDivergence[];
+	artifacts: string[];
+	replayedAt: string;
+}
+
+// --- Replay Sources -----------------------------------------------------------
+
+export interface ReplaySources {
+	checkpoint?: RuntimeCheckpoint;
+	events?: RuntimeEvent[];
+	taskGraph?: TaskGraph;
+	prompts?: Record<string, string>;
+	outputs?: Record<string, string>;
+	testResults?: Record<string, unknown>;
+	evaluation?: Record<string, unknown>;
+	repairs?: Record<string, unknown>;
+	knowledgeRefs?: string[];
+	/** Filter events by sequence range */
+	fromSequence?: number;
+	toSequence?: number;
+}
+
+// --- Divergence Detection -----------------------------------------------------
+
+export type DivergenceReason =
+	| "source_file_changed"
+	| "project_rules_changed"
+	| "provider_output_differs"
+	| "test_environment_changed"
+	| "required_artifact_missing"
+	| "runtime_version_differs";
+
+export interface DivergenceCheck {
+	type: DivergenceReason;
+	check: () => Promise<boolean>;
+	severity: "info" | "warning" | "error";
+}
+
+// --- Runtime Events -----------------------------------------------------------
+
+export type ReplayRuntimeEvent =
+	| { type: "replay.started"; jobId: string; mode: ReplayMode }
+	| { type: "replay.state.reconstructed"; jobId: string; sequence: number }
+	| { type: "replay.divergence.detected"; jobId: string; reason: string }
+	| { type: "replay.completed"; jobId: string };

package/packages/feedback-collector/dist/collector.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Feedback Collector — Core (RFC-0021)
+ */
+import type { FeedbackBatch, FeedbackCollectionConfig, FeedbackFilter, FeedbackItem, FeedbackSource, FeedbackSummary } from "./types.js";
+export declare class FeedbackCollector {
+    private items;
+    private batches;
+    private config;
+    constructor(config?: FeedbackCollectionConfig);
+    collect(source: FeedbackSource, message: string, metadata?: Record<string, unknown>): FeedbackItem;
+    collectBatch(batch: FeedbackBatch): void;
+    query(filter?: FeedbackFilter): FeedbackItem[];
+    summary(filter?: FeedbackFilter): FeedbackSummary;
+    updateStatus(id: string, status: FeedbackItem["status"]): boolean;
+    resolve(id: string, status: "actioned" | "dismissed"): boolean;
+    autoCloseOld(): number;
+    count(): number;
+    listBatches(): FeedbackBatch[];
+}
+//# sourceMappingURL=collector.d.ts.map

package/packages/feedback-collector/dist/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../src/collector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,wBAAwB,EACxB,cAAc,EACd,YAAY,EAEZ,cAAc,EACd,eAAe,EACf,MAAM,YAAY,CAAC;AAgBpB,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,MAAM,CAAqC;IAEnD,YAAY,MAAM,GAAE,wBAA6B,EAMhD;IAEA,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAalG;IAED,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CASvC;IAED,KAAK,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,YAAY,EAAE,CAkB7C;IAED,OAAO,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,eAAe,CAmChD;IAED,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,OAAO,CAQhE;IAED,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAE7D;IAED,YAAY,IAAI,MAAM,CAYrB;IAED,KAAK,IAAI,MAAM,CAEd;IAED,WAAW,IAAI,aAAa,EAAE,CAE7B;CACD"}

package/packages/feedback-collector/dist/collector.js

@@ -0,0 +1,145 @@
+/**
+ * Feedback Collector — Core (RFC-0021)
+ */
+let _idCounter = 0;
+function nextId() {
+    return `fb-${Date.now()}-${++_idCounter}`;
+}
+function inferSentiment(message) {
+    const lower = message.toLowerCase();
+    const positive = ["great", "excellent", "love", "perfect", "good", "helpful", "works", "amazing"];
+    const negative = ["bad", "wrong", "hate", "broken", "fail", "slow", "terrible", "bug", "error"];
+    if (positive.some((w) => lower.includes(w)))
+        return "positive";
+    if (negative.some((w) => lower.includes(w)))
+        return "negative";
+    return "neutral";
+}
+export class FeedbackCollector {
+    items = [];
+    batches = [];
+    config;
+    constructor(config = {}) {
+        this.config = {
+            retentionDays: config.retentionDays ?? 90,
+            autoCloseThreshold: config.autoCloseThreshold ?? 10,
+            anonymizeUserId: config.anonymizeUserId ?? false,
+        };
+    }
+    collect(source, message, metadata) {
+        const item = {
+            id: nextId(),
+            source,
+            sentiment: inferSentiment(message),
+            message,
+            status: "pending",
+            createdAt: new Date().toISOString(),
+            tags: metadata?.tags ?? [],
+            metadata,
+        };
+        this.items.push(item);
+        return item;
+    }
+    collectBatch(batch) {
+        for (const item of batch.items) {
+            if (!item.id)
+                item.id = nextId();
+            if (!item.createdAt)
+                item.createdAt = new Date().toISOString();
+            if (!item.sentiment)
+                item.sentiment = inferSentiment(item.message);
+            if (!item.status)
+                item.status = "pending";
+            this.items.push(item);
+        }
+        this.batches.push(batch);
+    }
+    query(filter) {
+        let results = [...this.items];
+        if (!filter)
+            return results;
+        if (filter.source)
+            results = results.filter((i) => i.source === filter.source);
+        if (filter.sentiment)
+            results = results.filter((i) => i.sentiment === filter.sentiment);
+        if (filter.status)
+            results = results.filter((i) => i.status === filter.status);
+        if (filter.tags?.length) {
+            results = results.filter((i) => filter.tags.some((t) => i.tags?.includes(t)));
+        }
+        if (filter.since) {
+            results = results.filter((i) => (i.createdAt ?? "") >= filter.since);
+        }
+        if (filter.until) {
+            results = results.filter((i) => (i.createdAt ?? "") <= filter.until);
+        }
+        return results;
+    }
+    summary(filter) {
+        const items = this.query(filter);
+        const total = items.length;
+        const bySource = {
+            human: 0,
+            automated: 0,
+            system: 0,
+            user: 0,
+        };
+        const bySentiment = {
+            positive: 0,
+            neutral: 0,
+            negative: 0,
+        };
+        let scoreSum = 0;
+        let scoreCount = 0;
+        for (const item of items) {
+            bySource[item.source] = (bySource[item.source] ?? 0) + 1;
+            if (item.sentiment) {
+                bySentiment[item.sentiment] = (bySentiment[item.sentiment] ?? 0) + 1;
+            }
+            if (item.score !== undefined) {
+                scoreSum += item.score;
+                scoreCount++;
+            }
+        }
+        return {
+            total,
+            bySource,
+            bySentiment,
+            avgScore: scoreCount > 0 ? scoreSum / scoreCount : 0,
+            pending: items.filter((i) => i.status === "pending").length,
+        };
+    }
+    updateStatus(id, status) {
+        const item = this.items.find((i) => i.id === id);
+        if (!item)
+            return false;
+        item.status = status;
+        if (status === "actioned" || status === "dismissed") {
+            item.resolvedAt = new Date().toISOString();
+        }
+        return true;
+    }
+    resolve(id, status) {
+        return this.updateStatus(id, status);
+    }
+    autoCloseOld() {
+        const cutoff = Date.now() - this.config.retentionDays * 86_400_000;
+        let count = 0;
+        for (const item of this.items) {
+            const created = new Date(item.createdAt ?? Date.now()).getTime();
+            if (created < cutoff && item.status === "pending") {
+                item.status = "dismissed";
+                item.resolvedAt = new Date().toISOString();
+                count++;
+            }
+        }
+        return count;
+    }
+    count() {
+        return this.items.length;
+    }
+    listBatches() {
+        return [...this.batches];
+    }
+}
+//# sourceMappingURL=collector.js.map

package/packages/feedback-collector/dist/collector.js.map

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