pi-harness-runtime 0.2.0 → 0.3.1

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

@@ -0,0 +1,439 @@
+export type JobStatus =
+	| "created"
+	| "planning"
+	| "queued"
+	| "running"
+	| "testing"
+	| "e2e_testing"
+	| "reviewing"
+	| "repairing"
+	| "paused_quota"
+	| "waiting_human"
+	| "blocked"
+	| "ready_for_client"
+	| "archived"
+	| "cancelled";
+
+export type TaskStatus =
+	| "pending"
+	| "ready"
+	| "running"
+	| "testing"
+	| "reviewing"
+	| "done"
+	| "failed"
+	| "blocked";
+
+export type ProviderState =
+	| "available"
+	| "limited"
+	| "exhausted"
+	| "disabled"
+	| "unknown";
+
+export interface RuntimeTask {
+	id: string;
+	title: string;
+	description: string;
+	status: TaskStatus;
+	assignedProvider?: string;
+	worktreePath?: string;
+	acceptanceCriteria?: string[];
+}
+
+export interface RuntimeCheckpoint {
+	version: number;
+	jobId: string;
+	status: JobStatus;
+	requirement: string;
+	currentTaskId?: string;
+	provider?: string;
+	resumeAt?: string;
+	lastError?: string;
+	createdAt: string;
+	updatedAt: string;
+}
+
+export interface RuntimeEvent {
+	ts: string;
+	jobId: string;
+	type: string;
+	message: string;
+	data?: Record<string, unknown>;
+}
+
+export interface RuntimeContext {
+	jobId: string;
+	requirement: string;
+	tasks: RuntimeTask[];
+	providerStates: Record<string, ProviderState>;
+}
+
+export interface ProviderSelection {
+	providerId: string;
+	reason: string;
+}
+
+// ─── Task Graph (RFC-0016) ───────────────────────────────────────────
+
+export interface TaskNode {
+	id: string;
+	title: string;
+	description: string;
+	status: TaskStatus;
+	dependencies: string[]; // task IDs this depends on
+	dependents: string[]; // task IDs that depend on this
+	assignedAgent?: string;
+	worktreePath?: string;
+	acceptanceCriteria?: string[];
+	retryCount?: number;
+	maxRetries?: number;
+	createdAt: string;
+	updatedAt: string;
+}
+
+export interface TaskGraph {
+	jobId: string;
+	nodes: Record<string, TaskNode>;
+	topologicalOrder: string[]; // Cached topological sort
+}
+
+// ─── Blackboard (RFC-0011) ──────────────────────────────────────────
+
+export interface BlackboardRecord {
+	jobId: string;
+	status: JobStatus;
+	nextAction?: NextAction;
+	tasks: TaskGraph;
+	agentRegistry: AgentRegistry;
+	reports: Record<string, AgentReport>;
+	locks: Record<string, LockInfo>;
+	updatedAt: string;
+}
+
+export interface NextAction {
+	taskId?: string;
+	agentId?: string;
+	instruction: string;
+	priority: "high" | "normal" | "low";
+	createdAt: string;
+	expiresAt?: string;
+}
+
+export interface AgentRegistry {
+	agents: Record<string, AgentInfo>;
+}
+
+export interface AgentInfo {
+	id: string;
+	name: string;
+	provider: string;
+	model?: string;
+	status: "idle" | "working" | "waiting" | "failed";
+	currentTaskId?: string;
+	startedAt?: string;
+	lastHeartbeat?: string;
+}
+
+export interface AgentReport {
+	agentId: string;
+	taskId: string;
+	status: "success" | "failure" | "partial";
+	summary: string;
+	filesChanged?: string[];
+	testsRun?: number;
+	testsPassed?: number;
+	testsFailed?: number;
+	createdAt: string;
+}
+
+export interface LockInfo {
+	taskId: string;
+	agentId: string;
+	acquiredAt: string;
+	expiresAt?: string;
+}
+
+// ─── Context Window Manager (RFC-0010) ──────────────────────────────
+
+export interface ContextWindowStats {
+	provider: string;
+	model: string;
+	maxTokens: number;
+	usedTokens: number;
+	availableTokens: number;
+	utilizationPct: number;
+}
+
+export interface ContextWindowConfig {
+	warningThreshold: number; // e.g., 0.8 = warn at 80%
+	criticalThreshold: number; // e.g., 0.95 = critical at 95%
+	strategy: "truncate" | "summarize" | "split";
+}
+
+// ─── Quota Manager (RFC-0003) ────────────────────────────────────────
+
+export interface QuotaSignal {
+	provider: string;
+	windowType: "5h" | "daily" | "weekly" | "monthly";
+	usedPct: number;
+	remainingPct: number;
+	resetsAt?: string;
+	exhausted: boolean;
+	source: "api_response" | "provider_status" | "playwright" | "local_estimate";
+	capturedAt: string;
+	retryAfterMs?: number;
+}
+
+export interface QuotaState {
+	provider: string;
+	available: boolean;
+	limited: boolean;
+	exhausted: boolean;
+	signals: QuotaSignal[];
+	nextAvailableAt?: string;
+}
+
+// ─── Provider Adapter (RFC-0002) ─────────────────────────────────────
+
+export interface ProviderConfig {
+	id: string;
+	name: string;
+	apiKey?: string;
+	baseUrl?: string;
+	models: string[];
+	capabilities: ProviderCapability[];
+	rateLimits: RateLimitConfig;
+}
+
+export type ProviderCapability =
+	| "code"
+	| "review"
+	| "plan"
+	| "test"
+	| "e2e"
+	| "refactor";
+
+export interface RateLimitConfig {
+	requestsPerMinute?: number;
+	tokensPerMinute?: number;
+	tokensPerDay?: number;
+	concurrentRequests?: number;
+}
+
+export interface ProviderResponse {
+	content: string;
+	usage?: {
+		input: number;
+		output: number;
+		cacheRead?: number;
+		cacheWrite?: number;
+		cost?: number;
+	};
+	model?: string;
+	finishReason?: "stop" | "length" | "content_filter" | "error";
+	error?: string;
+}
+
+export interface ProviderRequest {
+	model: string;
+	messages: ProviderMessage[];
+	temperature?: number;
+	maxTokens?: number;
+	stop?: string[];
+}
+
+export interface ProviderMessage {
+	role: "system" | "user" | "assistant";
+	content: string;
+}
+
+// ─── Agent Handoff (RFC-0012) ───────────────────────────────────────
+
+export interface HandoffContext {
+	jobId: string;
+	taskId: string;
+	fromAgent: string;
+	toAgent: string;
+	sharedFiles: string[];
+	taskHistory: HandoffEvent[];
+	summary: string;
+}
+
+export interface HandoffEvent {
+	ts: string;
+	agentId: string;
+	action: string;
+	result?: string;
+}
+
+// ─── Project Detector (RFC-0014) ─────────────────────────────────────
+
+export type ProjectType =
+	| "frappe_erpnext"
+	| "frappe_spa"
+	| "nextjs"
+	| "react_vite"
+	| "django"
+	| "laravel"
+	| "generic_web"
+	| "unknown";
+
+export interface ProjectDetection {
+	projectType: ProjectType;
+	confidence: number;
+	signals: string[];
+	recommendedSeedStrategy: SeedStrategy;
+	recommendedE2EStrategy: E2EStrategy;
+	framework?: string;
+	version?: string;
+}
+
+export type SeedStrategy =
+	| "frappe_doc_insert"
+	| "frappe_site_seed"
+	| "nextjs_factory"
+	| "react_factory"
+	| "django_fixture"
+	| "laravel_factory"
+	| "generic_sql";
+
+export type E2EStrategy =
+	| "bench_site_browser_flow"
+	| "next_dev_server_flow"
+	| "vite_dev_server_flow"
+	| "django_test_client_flow"
+	| "laravel_dusk_flow"
+	| "generic_playwright_flow";
+
+// ─── E2E Test Engine (RFC-0013) ─────────────────────────────────────
+
+export interface E2EScenario {
+	id: string;
+	name: string;
+	description: string;
+	steps: E2EStep[];
+	required: boolean;
+	tags?: string[];
+}
+
+export interface E2EStep {
+	action:
+		| "navigate"
+		| "click"
+		| "type"
+		| "wait"
+		| "screenshot"
+		| "assert"
+		| "hover"
+		| "select"
+		| "upload";
+	selector?: string;
+	value?: string;
+	timeout?: number;
+	assertCondition?: string;
+}
+
+export interface E2EResult {
+	scenarioId: string;
+	status: "passed" | "failed" | "skipped" | "error";
+	duration: number;
+	stepsExecuted: number;
+	stepsPassed: number;
+	stepsFailed: number;
+	screenshotPath?: string;
+	tracePath?: string;
+	videoPath?: string;
+	errorMessage?: string;
+	failedStep?: number;
+	executedAt: string;
+}
+
+export interface E2EReport {
+	jobId: string;
+	scenarios: E2EScenario[];
+	results: E2EResult[];
+	summary: {
+		total: number;
+		passed: number;
+		failed: number;
+		skipped: number;
+		duration: number;
+	};
+	createdAt: string;
+}
+
+// ─── Repair Engine (RFC-0018) ─────────────────────────────────────────
+
+export interface RepairTask {
+	id: string;
+	originalTaskId: string;
+	failureType: FailureType;
+	description: string;
+	attemptedFixes: AttemptedFix[];
+	status: "pending" | "in_progress" | "resolved" | "escalated";
+	retryPolicy: RetryPolicy;
+	createdAt: string;
+	resolvedAt?: string;
+}
+
+export type FailureType =
+	| "test_failure"
+	| "e2e_failure"
+	| "build_error"
+	| "runtime_error"
+	| "lint_error"
+	| "type_error"
+	| "quota_exhausted"
+	| "provider_error"
+	| "unknown";
+
+export interface AttemptedFix {
+	attempt: number;
+	description: string;
+	success: boolean;
+	output?: string;
+	timestamp: string;
+}
+
+export interface RetryPolicy {
+	maxRetries: number;
+	backoffMs: number;
+	backoffMultiplier: number;
+	escalationAfter?: number;
+}
+
+// ─── Worktree (RFC-0005) ─────────────────────────────────────────────
+
+export interface WorktreeInfo {
+	name: string;
+	path: string;
+	branch: string;
+	jobId?: string;
+	taskId?: string;
+	createdAt: string;
+	status: "active" | "merged" | "abandoned";
+}
+
+// ─── Loop Runtime (RFC-0001) ─────────────────────────────────────────
+
+export interface LoopConfig {
+	jobId: string;
+	requirement: string;
+	providerPolicy: {
+		plannerProvider: string;
+		codeProviders: string[];
+		reviewProvider: string;
+		fallbackProviders: string[];
+	};
+	maxIterations?: number;
+	checkpointInterval?: number;
+}
+
+export interface LoopState {
+	jobId: string;
+	iteration: number;
+	currentTaskId?: string;
+	status: "running" | "paused" | "completed" | "failed";
+	lastActivity?: string;
+}

package/packages/worktree/README.md

@@ -0,0 +1,3 @@
+# packages/worktree
+
+Git worktree management will live here.