pi-harness-runtime 1.1.445 → 1.1.447

package/packages/nextjs-plugin/dist/types.js.map

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

package/packages/nextjs-plugin/package.json

@@ -1,30 +0,0 @@
-{
-  "name": "@pi-harness/nextjs-plugin",
-  "version": "1.1.445",
-  "description": "Next.js framework detection and analysis for pi-harness-runtime (RFC-0062)",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "test": "bun test",
-    "test:watch": "bun test --watch"
-  },
-  "dependencies": {},
-  "devDependencies": {},
-  "keywords": [
-    "pi-harness",
-    "nextjs",
-    "framework",
-    "detection"
-  ]
-}

package/packages/nextjs-plugin/src/analyzer.ts

@@ -1,247 +0,0 @@
-/**
- * Next.js Analyzer (RFC-0062)
- *
- * Deep analysis of Next.js workspaces via filesystem inspection.
- * Does NOT evaluate code or connect to the network.
- */
-
-import { existsSync } from "node:fs";
-import { readdir, readFile } from "node:fs/promises";
-import { join } from "node:path";
-import type { NextJsAnalysis, AppRoute, ConfigFile } from "./types.js";
-
-// --- Detection ---------------------------------------------------------------
-
-function isNextJsWorkspace(root: string): boolean {
-	return (
-		existsSync(join(root, "next.config.js")) ||
-		existsSync(join(root, "next.config.mjs")) ||
-		existsSync(join(root, "next.config.ts")) ||
-		existsSync(join(root, "app")) ||
-		existsSync(join(root, "pages"))
-	);
-}
-
-// --- Version Detection -------------------------------------------------------
-
-async function detectVersion(root: string): Promise<string | undefined> {
-	try {
-		const pkg = JSON.parse(await readFile(join(root, "package.json"), "utf-8"));
-		return pkg.dependencies?.next
-			? pkg.dependencies.next.replace(/[\^~>=<]/, "")
-			: pkg.devDependencies?.next
-				? pkg.devDependencies.next.replace(/[\^~>=<]/, "")
-				: undefined;
-	} catch {
-		return undefined;
-	}
-}
-
-// --- Router Detection -------------------------------------------------------
-
-async function detectRouters(root: string): Promise<{
-	usingAppRouter: boolean;
-	usingPagesRouter: boolean;
-}> {
-	const hasApp = existsSync(join(root, "app"));
-	const hasPages = existsSync(join(root, "pages"));
-	return { usingAppRouter: hasApp, usingPagesRouter: hasPages };
-}
-
-// --- Config Files ------------------------------------------------------------
-
-async function findConfigFiles(root: string): Promise<ConfigFile[]> {
-	const configFiles = [
-		{ name: "next.config.js", path: join(root, "next.config.js") },
-		{ name: "next.config.mjs", path: join(root, "next.config.mjs") },
-		{ name: "next.config.ts", path: join(root, "next.config.ts") },
-	];
-	const configs: ConfigFile[] = [];
-	for (const cfg of configFiles) {
-		if (existsSync(cfg.path)) {
-			configs.push({ name: cfg.name, path: cfg.path });
-		}
-	}
-	return configs;
-}
-
-// --- App Router Routes -----------------------------------------------------
-
-async function walkAppRouter(
-	dir: string,
-	base: string = "",
-): Promise<AppRoute[]> {
-	const routes: AppRoute[] = [];
-	try {
-		const entries = await readdir(dir, { withFileTypes: true });
-		for (const entry of entries) {
-			if (entry.name.startsWith("_") || entry.name.startsWith(".")) continue;
-
-			const rel = base ? `${base}/${entry.name}` : entry.name;
-
-			if (entry.isDirectory()) {
-				// Dynamic segment: [param] or (group)
-				const isDynamic =
-					entry.name.startsWith("[") && entry.name.endsWith("]");
-				const isGroup = entry.name.startsWith("(") && entry.name.endsWith(")");
-				if (!isGroup) {
-					routes.push({
-						path: rel,
-						method: "GET",
-						isDynamic,
-						file: rel,
-					});
-				}
-				const sub = await walkAppRouter(join(dir, entry.name), rel);
-				routes.push(...sub);
-			} else if (entry.name === "page.tsx" || entry.name === "page.ts") {
-				routes.push({
-					path: rel.replace(/page\.(tsx?|jsx?)$/, ""),
-					method: "GET",
-					isDynamic: base.includes("["),
-					file: rel,
-				});
-			} else if (entry.name === "route.ts" || entry.name === "route.js") {
-				// HTTP method detection from siblings
-				routes.push({
-					path: rel.replace(/\/route\.(ts|js)$/, ""),
-					method: "ALL",
-					isDynamic: base.includes("["),
-					file: rel,
-				});
-			}
-		}
-	} catch {
-		// ignore
-	}
-	return routes;
-}
-
-// --- Pages Router API Routes -------------------------------------------------
-
-async function walkApiRoutes(
-	dir: string,
-	base: string = "",
-): Promise<string[]> {
-	const routes: string[] = [];
-	try {
-		const entries = await readdir(dir, { withFileTypes: true });
-		for (const entry of entries) {
-			if (entry.name.startsWith("_") || entry.name.startsWith(".")) continue;
-			const rel = base ? `${base}/${entry.name}` : entry.name;
-			if (entry.isDirectory()) {
-				routes.push(...(await walkApiRoutes(join(dir, entry.name), rel)));
-			} else if (entry.name.endsWith(".ts") || entry.name.endsWith(".js")) {
-				const normalized = rel.replace(/\.(ts|js)$/, "").replace(/index$/, "");
-				if (!routes.includes(normalized)) {
-					routes.push(normalized);
-				}
-			}
-		}
-	} catch {
-		// ignore
-	}
-	return routes;
-}
-
-// --- Middleware -------------------------------------------------------------
-
-async function findMiddleware(root: string): Promise<string | undefined> {
-	const candidates = [
-		join(root, "middleware.ts"),
-		join(root, "middleware.js"),
-		join(root, "middleware.tsx"),
-		join(root, "middleware.jsx"),
-	];
-	for (const p of candidates) {
-		if (existsSync(p)) return p;
-	}
-	return undefined;
-}
-
-// --- Environment Variables -------------------------------------------------
-
-async function findEnvVars(root: string): Promise<string[]> {
-	const candidates = [
-		join(root, ".env.example"),
-		join(root, ".env.local"),
-		join(root, ".env.development"),
-		join(root, ".env.production"),
-	];
-	const vars: string[] = [];
-	const seen = new Set<string>();
-	for (const p of candidates) {
-		if (existsSync(p)) {
-			try {
-				const content = await readFile(p, "utf-8");
-				for (const line of content.split("\n")) {
-					const trimmed = line.trim();
-					if (trimmed && !trimmed.startsWith("#") && trimmed.includes("=")) {
-						const key = trimmed.split("=")[0].trim();
-						if (key && !seen.has(key)) {
-							seen.add(key);
-							vars.push(key);
-						}
-					}
-				}
-			} catch {
-				// ignore
-			}
-		}
-	}
-	return vars;
-}
-
-// --- Main Analyzer ---------------------------------------------------------
-
-/**
- * Analyze a Next.js workspace (RFC-0062)
- */
-export async function analyzeNextJs(
-	root: string,
-): Promise<NextJsAnalysis | null> {
-	if (!isNextJsWorkspace(root)) {
-		return null;
-	}
-
-	const [version, routers, configs] = await Promise.all([
-		detectVersion(root),
-		detectRouters(root),
-		findConfigFiles(root),
-	]);
-
-	const appRoutes: AppRoute[] = [];
-	if (routers.usingAppRouter) {
-		appRoutes.push(...(await walkAppRouter(join(root, "app"))));
-	}
-
-	const apiRoutes: string[] = [];
-	if (routers.usingPagesRouter) {
-		const apiDir = join(root, "pages", "api");
-		if (existsSync(apiDir)) {
-			apiRoutes.push(...(await walkApiRoutes(apiDir)));
-		}
-	}
-
-	const [middleware, environmentVars] = await Promise.all([
-		findMiddleware(root),
-		findEnvVars(root),
-	]);
-
-	return {
-		framework: {
-			id: "nextjs",
-			name: "Next.js",
-			category: "fullstack",
-			description: "The React Framework for Production",
-			tags: ["react", "ssr", "fullstack", "typescript"],
-		},
-		version,
-		...routers,
-		apiRoutes,
-		appRoutes,
-		middleware,
-		environmentVars,
-		configs,
-	};
-}

package/packages/nextjs-plugin/src/index.ts

@@ -1,41 +0,0 @@
-/**
- * Next.js Plugin — Main Entry (RFC-0062)
- */
-
-import type { FrameworkExtension } from "../../framework-plugin-sdk/src/types.js";
-import { analyzeNextJs } from "./analyzer.js";
-
-export type { NextJsAnalysis, AppRoute, ConfigFile } from "./types.js";
-
-export async function analyzeNextJsWorkspace(
-	root: string,
-): Promise<import("./types.js").NextJsAnalysis | null> {
-	return analyzeNextJs(root);
-}
-
-export function createNextJsPlugin(): FrameworkExtension {
-	return {
-		capability: "framework",
-		name: "Next.js Framework Plugin",
-		detector: {
-			detect: async (root: unknown): Promise<unknown> => {
-				const r = root as string;
-				const { existsSync } = await import("node:fs");
-				return (
-					existsSync(`${r}/next.config.js`) ||
-					existsSync(`${r}/next.config.mjs`) ||
-					existsSync(`${r}/next.config.ts`) ||
-					existsSync(`${r}/app`) ||
-					existsSync(`${r}/pages`)
-				);
-			},
-			signals: [
-				{ type: "file", pattern: "next.config", weight: 0.6 },
-				{ type: "directory", pattern: "app", weight: 0.4 },
-				{ type: "directory", pattern: "pages", weight: 0.3 },
-				{ type: "package", pattern: "next", weight: 0.5 },
-			],
-		},
-		config: {},
-	};
-}

package/packages/nextjs-plugin/src/types.ts

@@ -1,36 +0,0 @@
-/**
- * Next.js Plugin — Types (RFC-0062)
- */
-
-export interface NextJsAnalysis {
-	framework: FrameworkInfo;
-	version?: string;
-	usingAppRouter: boolean;
-	usingPagesRouter: boolean;
-	apiRoutes: string[];
-	appRoutes: AppRoute[];
-	middleware?: string;
-	middlewareConfig?: Record<string, unknown>;
-	environmentVars: string[];
-	configs: ConfigFile[];
-}
-
-export interface FrameworkInfo {
-	id: string;
-	name: string;
-	category: string;
-	description: string;
-	tags: string[];
-}
-
-export interface AppRoute {
-	path: string;
-	method: string;
-	isDynamic: boolean;
-	file: string;
-}
-
-export interface ConfigFile {
-	name: string;
-	path: string;
-}

package/packages/observability/README.md

@@ -1,241 +0,0 @@
-# @pi/observability
-
-Comprehensive observability system with structured logging, distributed tracing, metrics collection, health monitoring, and alerting.
-
-## Features
-
-- **Structured Logging** - JSON and pretty-printed logs with correlation IDs
-- **Distributed Tracing** - OpenTelemetry-compatible tracing with spans and events
-- **Metrics Collection** - Prometheus-compatible metrics (counters, gauges, histograms)
-- **Health Monitoring** - Liveness and readiness probes for Kubernetes
-- **Alerting Engine** - Rule-based alerts with multiple action types
-
-## Installation
-
-```bash
-npm install @pi/observability
-```
-
-## Quick Start
-
-### Structured Logging
-
-```typescript
-import { createLogger } from "@pi/observability";
-
-const logger = createLogger({
-  level: "info",
-  format: "json",
-  output: "stdout"
-});
-
-// Basic logging
-logger.info("Application started");
-logger.error("Request failed", { requestId: "123" });
-
-// With correlation
-const jobLogger = logger.withJob("job-123");
-jobLogger.info("Processing task");
-```
-
-### Distributed Tracing
-
-```typescript
-import { createTracer } from "@pi/observability";
-
-const tracer = createTracer({
-  serviceName: "my-service",
-  exporter: "console",
-  sampleRate: 1.0
-});
-
-// Trace a function
-const result = await tracer.trace("processOrder", async (span) => {
-  span.setAttribute("orderId", order.id);
-  
-  await tracer.trace("validateOrder", async () => {
-    // validation logic
-  });
-  
-  return result;
-});
-```
-
-### Metrics
-
-```typescript
-import { createMetrics, createBuiltInMetrics } from "@pi/observability";
-
-const metrics = createMetrics({ serviceName: "my-service" });
-createBuiltInMetrics(metrics);
-
-// Counter
-metrics.incrementCounter("requests_total", { endpoint: "/api" });
-
-// Gauge
-metrics.setGauge("active_connections", 42);
-
-// Histogram
-metrics.observeHistogram("request_duration_seconds", 0.125, { method: "GET" });
-
-// Export metrics
-const prometheusOutput = metrics.exportPrometheus();
-```
-
-### Health Checks
-
-```typescript
-import { createHealthMonitor, createMemoryHealthCheck } from "@pi/observability";
-
-const health = createHealthMonitor("my-service", "1.0.0");
-
-// Register checks
-health.registerHealthCheck("memory", createMemoryHealthCheck("memory", 90));
-
-// Kubernetes probes
-app.get("/health/liveness", async (req, res) => {
-  const result = await health.checkLiveness();
-  res.status(result.status === "healthy" ? 200 : 503).json(result);
-});
-
-app.get("/health/readiness", async (req, res) => {
-  const result = await health.checkReadiness();
-  res.status(result.status === "healthy" ? 200 : 503).json(result);
-});
-```
-
-### Alerting
-
-```typescript
-import { createAlertEngine } from "@pi/observability";
-
-const alertEngine = createAlertEngine();
-
-alertEngine.registerRule({
-  name: "high_error_rate",
-  condition: {
-    type: "threshold",
-    metric: "error_rate",
-    operator: ">",
-    value: 0.05
-  },
-  severity: "critical",
-  cooldown: 300000, // 5 minutes
-  actions: [
-    { type: "log", level: "error" },
-    { type: "notify", channel: "slack", message: "High error rate detected" }
-  ]
-});
-
-// Evaluate alerts
-const alerts = await alertEngine.evaluate(metrics);
-```
-
-## API Reference
-
-### Logger
-
-```typescript
-const logger = createLogger({
-  level: "debug" | "info" | "warn" | "error" | "fatal",
-  format: "json" | "pretty",
-  output: "stdout" | "stderr" | "file",
-  filePath?: string,
-  defaultMeta?: Record<string, unknown>
-});
-
-logger.debug(message, meta?);
-logger.info(message, meta?);
-logger.warn(message, meta?);
-logger.error(message, error?, meta?);
-logger.fatal(message, error?, meta?);
-
-logger.child(defaults);  // Create child logger
-logger.withJob(jobId);   // Attach job ID
-logger.withTask(taskId); // Attach task ID
-logger.withCorrelationId(id); // Set correlation ID
-```
-
-### Tracer
-
-```typescript
-const tracer = createTracer({
-  serviceName: string,
-  exporter: "console" | "otlp" | "jaeger",
-  endpoint?: string,
-  sampleRate?: number
-});
-
-tracer.startSpan(name, options?);
-tracer.trace(name, fn);
-tracer.trace(name, options, fn);
-tracer.traceSync(name, fn);
-```
-
-### Metrics
-
-```typescript
-const metrics = createMetrics({
-  serviceName: string,
-  prefix?: string,
-  defaultLabels?: Labels
-});
-
-metrics.registerCounter(name, help, labels?);
-metrics.incrementCounter(name, labels?);
-metrics.registerGauge(name, help, labels?);
-metrics.setGauge(name, value, labels?);
-metrics.registerHistogram(name, help, buckets?, labels?);
-metrics.observeHistogram(name, value, labels?);
-
-metrics.asyncTimer(name, fn, labels?);
-metrics.timer(name, fn, labels?);
-
-metrics.exportPrometheus();
-metrics.exportJSON();
-```
-
-### Health Monitor
-
-```typescript
-const health = createHealthMonitor(serviceName, version);
-
-health.registerHealthCheck(name, check, critical?);
-health.checkHealth(name);
-health.checkHealthAll();
-health.checkLiveness();
-health.checkReadiness();
-```
-
-### Alert Engine
-
-```typescript
-const alertEngine = createAlertEngine(logger?);
-
-alertEngine.registerRule(rule);
-alertEngine.unregisterRule(name);
-alertEngine.evaluate(metrics);
-alertEngine.getActiveAlerts();
-alertEngine.getAlertHistory(limit?);
-```
-
-## Metrics Format
-
-Prometheus format example:
-
-```
-# HELP my_service_requests_total Total requests
-# TYPE my_service_requests_total counter
-my_service_requests_total{endpoint="/api"} 1234
-
-# HELP my_service_request_duration_seconds Request duration
-# TYPE my_service_request_duration_seconds histogram
-my_service_request_duration_seconds_bucket{le="0.1"} 1000
-my_service_request_duration_seconds_bucket{le="0.5"} 1200
-my_service_request_duration_seconds_sum 150.5
-my_service_request_duration_seconds_count 1234
-```
-
-## License
-
-MIT

package/packages/observability/dist/alerts.d.ts

@@ -1,99 +0,0 @@
-/**
- * Observability Package - Alert Engine
- *
- * Alert rule evaluation and alerting.
- */
-import type { Alert, AlertRule } from "./types.js";
-import { Logger } from "./logger.js";
-export declare class AlertEngine {
-    private readonly rules;
-    private readonly activeAlerts;
-    private readonly alertHistory;
-    private readonly logger;
-    constructor(logger?: Logger, _maxHistory?: number);
-    /**
-     * Register an alert rule
-     */
-    registerRule(rule: AlertRule): void;
-    /**
-     * Unregister an alert rule
-     */
-    unregisterRule(name: string): void;
-    /**
-     * Get a rule by name
-     */
-    getRule(name: string): AlertRule | undefined;
-    /**
-     * Enable or disable a rule
-     */
-    setRuleEnabled(name: string, enabled: boolean): void;
-    /**
-     * Evaluate all rules
-     */
-    evaluate(metrics: Record<string, number>): Promise<Alert[]>;
-    /**
-     * Evaluate a single condition
-     */
-    private evaluateCondition;
-    /**
-     * Create an alert from a rule
-     */
-    private createAlert;
-    /**
-     * Format alert message
-     */
-    private formatAlertMessage;
-    /**
-     * Trigger alert actions
-     */
-    private triggerActions;
-    /**
-     * Execute a single action
-     */
-    private executeAction;
-    /**
-     * Log an alert
-     */
-    private logAlert;
-    /**
-     * Send a notification
-     */
-    private sendNotification;
-    /**
-     * Send a webhook
-     */
-    private sendWebhook;
-    /**
-     * Execute a command
-     */
-    private executeCommand;
-    /**
-     * Get active alerts
-     */
-    getActiveAlerts(): Alert[];
-    /**
-     * Get alert history
-     */
-    getAlertHistory(limit?: number): Alert[];
-    /**
-     * Clear alert history
-     */
-    clearHistory(): void;
-    /**
-     * List all rules
-     */
-    listRules(): AlertRule[];
-    /**
-     * Get rule count
-     */
-    getRuleCount(): {
-        total: number;
-        enabled: number;
-        disabled: number;
-    };
-}
-/**
- * Create an alert engine
- */
-export declare function createAlertEngine(logger?: Logger): AlertEngine;
-//# sourceMappingURL=alerts.d.ts.map

package/packages/observability/dist/alerts.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../src/alerts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAA+B,SAAS,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,YAAY,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,SAAO,EAE9C;IAED;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAGlC;IAED;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGjC;IAED;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE3C;IAED;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAKnD;IAED;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAsChE;IAED;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2CzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;YACW,cAAc;IAS5B;;OAEG;YACW,aAAa;IAuB3B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAwBhB;;OAEG;YACW,gBAAgB;IAW9B;;OAEG;YACW,WAAW;IA4BzB;;OAEG;YACW,cAAc;IAO5B;;OAEG;IACH,eAAe,IAAI,KAAK,EAAE,CAEzB;IAED;;OAEG;IACH,eAAe,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAMvC;IAED;;OAEG;IACH,YAAY,IAAI,IAAI,CAEnB;IAED;;OAEG;IACH,SAAS,IAAI,SAAS,EAAE,CAEvB;IAED;;OAEG;IACH,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAiBnE;CACD;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,CAE9D"}