pi-harness-runtime 1.1.445 → 1.1.447

package/packages/health-monitor/dist/types.d.ts

@@ -1,33 +0,0 @@
-/**
- * Health Monitor — Types
- */
-export type ComponentName = "provider-adapter" | "skill-registry" | "memory-engine" | "session-manager" | "checkpoint-engine" | "quota-manager" | "framework-detector";
-export type HealthStatus = "healthy" | "degraded" | "unhealthy" | "unknown";
-export interface ComponentHealth {
-    component: ComponentName;
-    status: HealthStatus;
-    lastCheck: string;
-    responseTimeMs?: number;
-    errorRate?: number;
-    details?: string;
-}
-export interface HealthReport {
-    overall: HealthStatus;
-    timestamp: string;
-    components: ComponentHealth[];
-    uptime: number;
-}
-export interface MonitorConfig {
-    checkIntervalMs: number;
-    degradedThreshold: number;
-    unhealthyThreshold: number;
-    maxErrorRate: number;
-    autoRecover: boolean;
-    maxRecoveryAttempts: number;
-}
-export interface RecoveryAction {
-    type: "restart" | "retry" | "fallback" | "alert" | "scale";
-    target: ComponentName;
-    config: Record<string, unknown>;
-}
-//# sourceMappingURL=types.d.ts.map

package/packages/health-monitor/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,aAAa,GACtB,kBAAkB,GAClB,gBAAgB,GAChB,eAAe,GACf,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,GACf,oBAAoB,CAAC;AAExB,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC/B,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3D,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC"}

package/packages/health-monitor/dist/types.js

@@ -1,5 +0,0 @@
-/**
- * Health Monitor — Types
- */
-export {};
-//# sourceMappingURL=types.js.map

package/packages/health-monitor/dist/types.js.map

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

package/packages/health-monitor/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "@pi/health-monitor",
-  "version": "1.1.445",
-  "type": "module",
-  "description": "Health monitoring and auto-healing",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "tsc --noEmit",
-    "test": "bun test"
-  },
-  "devDependencies": {
-    "bun-types": "^1.0.0"
-  }
-}

package/packages/health-monitor/src/index.ts

@@ -1,16 +0,0 @@
-/**
- * Health Monitor — Main Entry
- */
-
-export {
-	DEFAULT_CONFIG,
-	determineStatus,
-	createReport,
-	aggregateHealth,
-	determineRecoveryAction,
-	resetRecoveryAttempts,
-	runHealthCheck,
-	calculateUptime,
-	collectSnapshot,
-} from "./monitor.js";
-export type * from "./types.js";

package/packages/health-monitor/src/monitor.ts

@@ -1,216 +0,0 @@
-/**
- * Health Monitor — Core Monitor
- */
-
-import type {
-	ComponentName,
-	ComponentHealth,
-	HealthReport,
-	HealthStatus,
-	MonitorConfig,
-	RecoveryAction,
-} from "./types.js";
-
-export const DEFAULT_CONFIG: Required<MonitorConfig> = {
-	checkIntervalMs: 30_000,
-	degradedThreshold: 2000,
-	unhealthyThreshold: 10_000,
-	maxErrorRate: 0.1,
-	autoRecover: false,
-	maxRecoveryAttempts: 3,
-};
-
-const recoveryAttempts = new Map<ComponentName, number>();
-const startTime = Date.now();
-
-// --- Collectors ----------------------------------------------------------------
-
-export interface SnapshotValue {
-	value: number;
-	unit: string;
-}
-
-export interface HealthSnapshot {
-	timestamp: number;
-	memory: Record<string, SnapshotValue>;
-	cpu: Record<string, SnapshotValue>;
-	uptime: number;
-}
-
-export function collectMemory(): { name: string; timestamp: number; values: Record<string, SnapshotValue> } {
-	const mem = process.memoryUsage();
-	return {
-		name: "memory",
-		timestamp: Date.now(),
-		values: {
-			rss: { value: mem.rss, unit: "bytes" },
-			heapTotal: { value: mem.heapTotal, unit: "bytes" },
-			heapUsed: { value: mem.heapUsed, unit: "bytes" },
-			external: { value: mem.external, unit: "bytes" },
-		},
-	};
-}
-
-export function collectCPU(): { name: string; timestamp: number; values: Record<string, SnapshotValue> } {
-	const cpu = process.cpuUsage();
-	return {
-		name: "cpu",
-		timestamp: Date.now(),
-		values: {
-			user: { value: cpu.user, unit: "microseconds" },
-			system: { value: cpu.system, unit: "microseconds" },
-		},
-	};
-}
-
-export function collectUptime(): { name: string; timestamp: number; values: Record<string, SnapshotValue> } {
-	return {
-		name: "uptime",
-		timestamp: Date.now(),
-		values: {
-			seconds: { value: process.uptime(), unit: "seconds" },
-		},
-	};
-}
-
-export function collectSnapshot(): HealthSnapshot {
-	return {
-		timestamp: Date.now(),
-		memory: {
-			rss: { value: process.memoryUsage().rss, unit: "bytes" },
-			heapUsed: { value: process.memoryUsage().heapUsed, unit: "bytes" },
-			heapTotal: { value: process.memoryUsage().heapTotal, unit: "bytes" },
-		},
-		cpu: {
-			user: { value: process.cpuUsage().user, unit: "microseconds" },
-			system: { value: process.cpuUsage().system, unit: "microseconds" },
-		},
-		uptime: process.uptime(),
-	};
-}
-
-export function determineStatus(
-	responseTimeMs: number,
-	errorRate: number,
-	config: Required<MonitorConfig>,
-): HealthStatus {
-	if (
-		responseTimeMs > config.unhealthyThreshold ||
-		errorRate > config.maxErrorRate
-	) {
-		return "unhealthy";
-	}
-	if (responseTimeMs > config.degradedThreshold) {
-		return "degraded";
-	}
-	return "healthy";
-}
-
-export function createReport(
-	components: ComponentHealth[],
-	_config: Required<MonitorConfig>,
-): HealthReport {
-	return {
-		overall: aggregateHealth(components.map((c) => c.status)),
-		timestamp: new Date().toISOString(),
-		components,
-		uptime: Math.floor((Date.now() - startTime) / 1000),
-	};
-}
-
-export function aggregateHealth(statuses: HealthStatus[]): HealthStatus {
-	if (statuses.length === 0) return "unknown";
-	if (statuses.some((s) => s === "unhealthy")) return "unhealthy";
-	if (statuses.some((s) => s === "degraded")) return "degraded";
-	if (statuses.every((s) => s === "healthy")) return "healthy";
-	return "unknown";
-}
-
-export function determineRecoveryAction(
-	component: ComponentName,
-	status: HealthStatus,
-	config: Required<MonitorConfig>,
-): RecoveryAction | null {
-	if (status === "healthy") return null;
-	if (!config.autoRecover) return null;
-
-	const attempts = recoveryAttempts.get(component) ?? 0;
-	if (attempts >= config.maxRecoveryAttempts) {
-		return {
-			type: "alert",
-			target: component,
-			config: {
-				message: `Max recovery attempts (${attempts}) exceeded for ${component}`,
-			},
-		};
-	}
-
-	recoveryAttempts.set(component, attempts + 1);
-
-	if (status === "unhealthy") {
-		return {
-			type: "restart",
-			target: component,
-			config: { attempt: attempts + 1 },
-		};
-	}
-
-	return {
-		type: "retry",
-		target: component,
-		config: { attempt: attempts + 1, backoffMs: 2 ** attempts * 1000 },
-	};
-}
-
-export function resetRecoveryAttempts(component: ComponentName): void {
-	recoveryAttempts.delete(component);
-}
-
-export async function runHealthCheck(
-	component: ComponentName,
-	checkFn: () => Promise<boolean>,
-	config: Required<MonitorConfig>,
-): Promise<ComponentHealth> {
-	const start = Date.now();
-	let status: HealthStatus = "healthy";
-	let details: string | undefined;
-
-	try {
-		const result = await Promise.race([
-			checkFn(),
-			new Promise<false>((_, reject) =>
-				setTimeout(
-					() => reject(new Error("timeout")),
-					config.unhealthyThreshold,
-				),
-			),
-		]);
-		if (!result) {
-			status = "unhealthy";
-			details = "Check returned false";
-		}
-	} catch (err) {
-		status = "unhealthy";
-		details = err instanceof Error ? err.message : "Unknown error";
-	}
-
-	const responseTimeMs = Date.now() - start;
-	const determined = determineStatus(
-		responseTimeMs,
-		status === "unhealthy" ? 1 : 0,
-		config,
-	);
-
-	return {
-		component,
-		status: determined,
-		lastCheck: new Date().toISOString(),
-		responseTimeMs,
-		errorRate: status === "unhealthy" ? 1 : 0,
-		details,
-	};
-}
-
-export function calculateUptime(report: HealthReport): number {
-	return report.overall === "unhealthy" ? 95 : 100;
-}

package/packages/health-monitor/src/types.ts

@@ -1,45 +0,0 @@
-/**
- * Health Monitor — Types
- */
-
-export type ComponentName =
-	| "provider-adapter"
-	| "skill-registry"
-	| "memory-engine"
-	| "session-manager"
-	| "checkpoint-engine"
-	| "quota-manager"
-	| "framework-detector";
-
-export type HealthStatus = "healthy" | "degraded" | "unhealthy" | "unknown";
-
-export interface ComponentHealth {
-	component: ComponentName;
-	status: HealthStatus;
-	lastCheck: string;
-	responseTimeMs?: number;
-	errorRate?: number;
-	details?: string;
-}
-
-export interface HealthReport {
-	overall: HealthStatus;
-	timestamp: string;
-	components: ComponentHealth[];
-	uptime: number;
-}
-
-export interface MonitorConfig {
-	checkIntervalMs: number;
-	degradedThreshold: number;
-	unhealthyThreshold: number;
-	maxErrorRate: number;
-	autoRecover: boolean;
-	maxRecoveryAttempts: number;
-}
-
-export interface RecoveryAction {
-	type: "restart" | "retry" | "fallback" | "alert" | "scale";
-	target: ComponentName;
-	config: Record<string, unknown>;
-}

package/packages/jev-judge/README.md

@@ -1,295 +0,0 @@
-# Jev Judge
-
-Structured decision model integration for pi-harness-runtime. Uses [TypeSafe Jev](https://typesafe.ai) via OpenRouter for fast, calibrated, hallucination-free decisions.
-
-## Overview
-
-Jev is a "System One" model - a new class of AI optimized for **structured decisions** rather than text generation:
-
-| Aspect | Traditional LLM | Jev (System One) |
-|--------|-----------------|------------------|
-| Output | Text (can hallucinate) | Type-safe values (0% hallucination) |
-| Speed | ~1-2s per call | **~250ms per call** |
-| Cost | Higher | ~5x cheaper |
-| Use case | Chat, reasoning | Classification, routing, decisions |
-
-## Features
-
-- **JevJudge** - Core API for structured decisions
-- **E2EJudge** - E2E testing decisions (flaky detection, build blocking, retry)
-- **FlakyDetector** - Specialized flaky test detection
-- **DecisionEngine** - Threshold-based routing and actions
-- **AutoContinueJudge** - Agent autonomous decision-making (continue or wait)
-
-## Installation
-
-```bash
-# Via monorepo (already included)
-bun install
-
-# Or install separately
-npm install @pi-harness/jev-judge
-```
-
-## Configuration
-
-Requires OpenRouter API key with TypeSafe/Jev access:
-
-```bash
-export OPENROUTER_API_KEY="sk-or-..."
-```
-
-Or set in code:
-
-```typescript
-const judge = new JevJudge({
-  apiKey: process.env.OPENROUTER_API_KEY!,
-  baseUrl: "https://openrouter.ai/api/v1", // default
-  model: "typesafe/jev-1.13", // default
-});
-```
-
-## Usage
-
-### Basic Decisions
-
-```typescript
-import { JevJudge } from "@pi-harness/jev-judge";
-
-const judge = new JevJudge({ apiKey: process.env.OPENROUTER_API_KEY! });
-
-// Ask multiple questions at once
-const result = await judge.evaluate(
-  "The deploy failed with exit code 1. Error: ECONNREFUSED",
-  {
-    isUrgent: {
-      type: "noul",
-      instructions: "Does this require immediate attention?"
-    },
-    severity: {
-      type: "choice",
-      instructions: "What is the severity level?",
-      options: ["critical", "high", "medium", "low"]
-    }
-  }
-);
-
-console.log(result.decisions.isUrgent.probability); // 0.92
-console.log(result.decisions.severity.response.choice); // "critical"
-```
-
-### Task Tracker Routing (Todo vs BD)
-
-```typescript
-import { Router } from "@pi-harness/jev-judge/decision-engine";
-
-const result = await Router.routeTaskTracker(
-  "Fix the login bug on the checkout page",
-  judge
-);
-
-if (result.tracker === "bd") {
-  // Create GitHub issue
-} else {
-  // Use local todo
-}
-```
-
-### E2E Test Flaky Detection
-
-```typescript
-import { E2EJudge } from "@pi-harness/jev-judge/e2e-judge";
-
-const e2eJudge = new E2EJudge({ apiKey: process.env.OPENROUTER_API_KEY! });
-
-// Analyze a test failure
-const flakyAnalysis = await e2eJudge.analyzeFlakiness({
-  name: "checkout-flow.spec.ts",
-  status: "failed",
-  error: "Timeout: Element #checkout-button not visible after 5000ms",
-  retries: 1
-});
-
-if (flakyAnalysis.isFlaky) {
-  console.log(`Flaky detected: ${flakyAnalysis.pattern}`);
-  // Auto-skip or retry
-}
-```
-
-### Build Decision
-
-```typescript
-// Should this failure block the build?
-const blockDecision = await e2eJudge.shouldBlockBuild(testResult);
-
-if (blockDecision.shouldBlock) {
-  console.log(`Blocking build: ${blockDecision.reason}`);
-  process.exit(1);
-}
-```
-
-### Threshold-Based Actions
-
-```typescript
-import { DecisionEngine } from "@pi-harness/jev-judge/decision-engine";
-
-const engine = new DecisionEngine(
-  { apiKey: process.env.OPENROUTER_API_KEY! },
-  { approval: 0.9, review: 0.6, block: 0.3 }
-);
-
-const decision = engine.decide(0.85);
-
-switch (decision.action) {
-  case "proceed":
-    // Auto-approve
-    break;
-  case "review":
-    // Send to human
-    break;
-  case "block":
-    // Auto-reject
-    break;
-}
-```
-
-## API Reference
-
-### JevJudge
-
-Core class for making structured decisions.
-
-```typescript
-const judge = new JevJudge(config: JevJudgeConfig);
-```
-
-#### Methods
-
-- `evaluate(state, questions)` - Evaluate state against questions
-- `noul(state, question)` - Quick yes/no evaluation
-- `choice(state, question, options)` - Quick choice evaluation
-- `thresholdDecision(probability, threshold)` - Threshold-based decision
-- `batchEvaluate(states, questions)` - Batch evaluation
-
-### E2EJudge
-
-Specialized judge for E2E testing.
-
-```typescript
-const e2eJudge = new E2EJudge(config, options);
-```
-
-#### Methods
-
-- `analyzeFlakiness(testResult)` - Detect flaky tests
-- `shouldBlockBuild(testResult)` - Build blocking decision
-- `shouldRetry(testResult)` - Retry recommendation
-- `classifyError(errorMessage)` - Error classification
-- `batchAnalyze(testResults)` - Batch test analysis
-
-### FlakyDetector
-
-Specialized for flaky test detection with pattern matching.
-
-```typescript
-const detector = new FlakyDetector(config, threshold);
-```
-
-#### Methods
-
-- `detectPattern(errorMessage)` - Fast pattern-based detection
-- `detect(testResult)` - AI-powered detection
-- `batchDetect(testResults)` - Batch detection
-
-### DecisionEngine
-
-Threshold-based routing and actions.
-
-```typescript
-const engine = new DecisionEngine(config, thresholds);
-```
-
-#### Methods
-
-- `decide(probability)` - Decide action from probability
-- `decideWithThresholds(probabilities)` - Multi-question decisions
-- `route(decision, handlers)` - Route to handlers
-- `batchDecide(decisions)` - Batch decisions
-- `weightedVote(votes)` - Weighted voting
-
-## Pricing
-
-Jev via OpenRouter:
-- Input: $0.042 / 1M tokens
-- Output: Free
-- Latency: ~250ms P50
-
-See [OpenRouter pricing](https://openrouter.ai/typesafe/jev-1.13) for details.
-
-## Auto-Continue Judge (Agent Use Case)
-
-**Problem:** Agent completes 2/5 tasks, asks "Continue?" User asleep → agent waits indefinitely.
-
-**Solution:** Use Jev to judge whether to auto-continue.
-
-```typescript
-import { AutoContinueJudge, createTaskState } from "@pi-harness/jev-judge/auto-continue";
-import { hasJevApiKey, createJevJudge } from "@pi-harness/jev-judge";
-
-// Auto-detect API key from environment
-const judge = new AutoContinueJudge({
-  apiKey: process.env.TYPESAFE_API_KEY!, // or auto-detect
-  proceedThreshold: 0.7,  // Continue if >70% confidence
-  maxWaitMinutes: 30,
-});
-
-// Build task state
-const taskState = createTaskState(
-  ["task-1", "task-2"],  // completed
-  ["task-3", "task-4", "task-5"],  // remaining
-  new Date(Date.now() - 30 * 60 * 1000),  // last user activity 30 min ago
-  new Date(Date.now() - 2 * 60 * 60 * 1000)  // session started 2 hours ago
-);
-
-// Get decision
-const decision = await judge.decide(taskState);
-
-if (decision.action === "proceed") {
-  console.log("Continuing with remaining tasks...");
-  // Agent proceeds autonomously
-} else if (decision.action === "proceed_with_caution") {
-  console.log(`Proceeding with caution (${decision.riskLevel} risk)`);
-  // Agent proceeds but logs each step
-} else {
-  console.log(`Waiting... (recommend ${decision.waitRecommendation} min)`);
-  // Agent waits or notifies
-}
-```
-
-### Environment Variable Auto-Detection
-
-The package automatically detects API keys from environment:
-
-```bash
-# Option 1: TypeSafe API key (preferred)
-export TYPESAFE_API_KEY="your-key-here"
-
-# Option 2: OpenRouter API key
-export OPENROUTER_API_KEY="your-key-here"
-```
-
-```typescript
-import { hasJevApiKey, createJevJudge } from "@pi-harness/jev-judge";
-
-if (hasJevApiKey()) {
-  const judge = createJevJudge();  // Auto-detects API key
-}
-```
-
-## Examples
-
-See `tests/` directory for example usage.
-
-## License
-
-MIT

package/packages/knowledge-graph/dist/graph-extractor.d.ts

@@ -1,27 +0,0 @@
-/**
- * Knowledge Graph - RFC-0106
- *
- * Extract nodes and edges from SKILL.md files.
- */
-import type { KnowledgeNode, KnowledgeEdge, KnowledgeGraph } from './types.js';
-/**
- * Extract a knowledge node from a SKILL.md file
- */
-export declare function extractSkillNode(filePath: string, content: string, frontmatter: Record<string, unknown>): KnowledgeNode;
-/**
- * Extract edges from a SKILL.md file
- */
-export declare function extractSkillEdges(filePath: string, content: string, frontmatter: Record<string, unknown>): KnowledgeEdge[];
-/**
- * Extract RFC nodes from RFC markdown files
- */
-export declare function extractRFCNode(filePath: string, content: string, title: string): KnowledgeNode;
-/**
- * Extract edges between RFCs
- */
-export declare function extractRFCEdges(filePath: string, content: string): KnowledgeEdge[];
-/**
- * Build complete knowledge graph from directory
- */
-export declare function extractKnowledgeGraph(skillsPath: string, rfcPath: string): Promise<KnowledgeGraph>;
-//# sourceMappingURL=graph-extractor.d.ts.map

package/packages/knowledge-graph/dist/graph-extractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"graph-extractor.d.ts","sourceRoot":"","sources":["../src/graph-extractor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAC;AAqF/F;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,aAAa,CAef;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,aAAa,EAAE,CAqDjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,aAAa,CA0Bf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,aAAa,EAAE,CAmCjB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,CAAC,CA4EzB"}