pi-harness-runtime 0.9.2 → 0.9.5

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

@@ -0,0 +1,323 @@
+/**
+ * Laravel Analyzer (RFC-0065)
+ *
+ * Deep analysis of Laravel workspaces via filesystem inspection.
+ */
+
+import { existsSync } from "node:fs";
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import type { LaravelAnalysis } from "./types.js";
+
+// ─── Detection ───────────────────────────────────────────────────────────────
+
+function isLaravelWorkspace(root: string): boolean {
+	if (existsSync(join(root, "artisan"))) return true;
+	if (existsSync(join(root, "bootstrap", "app.php"))) return true;
+	if (existsSync(join(root, "composer.json"))) {
+		// Defer to async version; use basic file presence check as proxy
+		return (
+			existsSync(join(root, "app", "Http", "Controllers")) ||
+			existsSync(join(root, "app", "Models")) ||
+			existsSync(join(root, "app", "Console", "Commands")) ||
+			existsSync(join(root, "database", "migrations")) ||
+			existsSync(join(root, "bootstrap", "app.php"))
+		);
+	}
+	return false;
+}
+
+// ─── Version ────────────────────────────────────────────────────────────────
+
+async function detectVersion(root: string): Promise<string | undefined> {
+	const composerPath = join(root, "composer.json");
+	if (!existsSync(composerPath)) return undefined;
+
+	try {
+		const composer = JSON.parse(await readFile(composerPath, "utf-8"));
+		const requires = {
+			...(composer.require ?? {}),
+			...(composer["require-dev"] ?? {}),
+		};
+		const laravel = requires["laravel/framework"];
+		if (laravel) {
+			return laravel.replace(/[\^~>=<]/, "");
+		}
+		// Also check for laravel/installer pattern
+		const pkg = composer.name;
+		if (pkg && pkg.toLowerCase().includes("laravel")) {
+			return composer.version ?? undefined;
+		}
+		return undefined;
+	} catch {
+		return undefined;
+	}
+}
+
+// ─── Packages ────────────────────────────────────────────────────────────────
+
+async function detectPackages(root: string): Promise<string[]> {
+	const composerPath = join(root, "composer.json");
+	if (!existsSync(composerPath)) return [];
+
+	try {
+		const composer = JSON.parse(await readFile(composerPath, "utf-8"));
+		const deps = {
+			...(composer.require ?? {}),
+			...(composer["require-dev"] ?? {}),
+		};
+		return Object.keys(deps);
+	} catch {
+		return [];
+	}
+}
+
+// ─── Auth Detection ────────────────────────────────────────────────────────
+
+async function detectAuth(root: string): Promise<string | undefined> {
+	const packages = await detectPackages(root);
+
+	if (packages.includes("laravel/sanctum")) return "sanctum";
+	if (packages.includes("laravel/passport")) return "passport";
+	if (packages.includes("laravel/spark-aurelius")) return "spark";
+	if (packages.includes("tymon/jwt-auth")) return "jwt";
+
+	// Check config files
+	for (const authFile of [
+		join(root, "config", "auth.php"),
+		join(root, "config", "sanctum.php"),
+	]) {
+		if (existsSync(authFile)) {
+			try {
+				const content = await readFile(authFile, "utf-8");
+				if (content.includes("Sanctum") || content.includes("sanctum")) {
+					return "sanctum";
+				}
+			} catch {
+				/* ignore */
+			}
+		}
+	}
+	return undefined;
+}
+
+// ─── Controllers ───────────────────────────────────────────────────────────
+
+async function findControllers(root: string): Promise<string[]> {
+	const controllerDirs = [
+		join(root, "app", "Http", "Controllers"),
+		join(root, "app", "Controllers"),
+	];
+	const controllers: string[] = [];
+
+	for (const dir of controllerDirs) {
+		if (!existsSync(dir)) continue;
+		try {
+			const entries = await readdir(dir, { withFileTypes: true });
+			for (const entry of entries) {
+				if (entry.name.startsWith(".") || entry.name === "Controller.php")
+					continue;
+				if (
+					entry.name.endsWith("Controller.php") ||
+					entry.name.endsWith("Controller.ts")
+				) {
+					controllers.push(entry.name.replace(/\.(php|ts)$/, ""));
+				} else if (entry.isDirectory()) {
+					// Nested controller directory
+					const subEntries = await readdir(join(dir, entry.name));
+					for (const sub of subEntries) {
+						if (
+							sub.endsWith("Controller.php") ||
+							sub.endsWith("Controller.ts")
+						) {
+							controllers.push(
+								`${entry.name}/${sub.replace(/\.(php|ts)$/, "")}`,
+							);
+						}
+					}
+				}
+			}
+		} catch {
+			/* ignore */
+		}
+	}
+
+	return controllers;
+}
+
+// ─── Models ────────────────────────────────────────────────────────────────
+
+async function findModels(root: string): Promise<string[]> {
+	const modelDirs = [join(root, "app", "Models"), join(root, "app", "Models")];
+	const models: string[] = [];
+
+	for (const dir of modelDirs) {
+		if (!existsSync(dir)) continue;
+		try {
+			const entries = await readdir(dir);
+			for (const entry of entries) {
+				if (entry.startsWith(".") || entry === "User.php") continue;
+				if (entry.endsWith(".php")) {
+					models.push(entry.replace(/\.php$/, ""));
+				}
+			}
+		} catch {
+			/* ignore */
+		}
+	}
+
+	return models;
+}
+
+// ─── Blade Views ───────────────────────────────────────────────────────────
+
+async function findViews(root: string): Promise<string[]> {
+	const viewDirs = [join(root, "resources", "views"), join(root, "views")];
+	const views: string[] = [];
+
+	for (const dir of viewDirs) {
+		if (!existsSync(dir)) continue;
+		try {
+			const entries = await readdir(dir, { withFileTypes: true });
+			for (const entry of entries) {
+				if (entry.name.startsWith(".")) continue;
+				const fullPath = join(dir, entry.name);
+				if (entry.isDirectory()) {
+					const subEntries = await readdir(fullPath);
+					for (const sub of subEntries) {
+						if (sub.endsWith(".blade.php")) {
+							views.push(`${entry.name}/${sub}`);
+						}
+					}
+				} else if (entry.name.endsWith(".blade.php")) {
+					views.push(entry.name);
+				}
+			}
+		} catch {
+			/* ignore */
+		}
+	}
+
+	return views;
+}
+
+// ─── Artisan Commands ──────────────────────────────────────────────────────
+
+async function findCommands(root: string): Promise<string[]> {
+	const commandDirs = [
+		join(root, "app", "Console", "Commands"),
+		join(root, "app", "Commands"),
+	];
+	const commands: string[] = [];
+
+	for (const dir of commandDirs) {
+		if (!existsSync(dir)) continue;
+		try {
+			const entries = await readdir(dir);
+			for (const entry of entries) {
+				if (entry.startsWith(".") || !entry.endsWith(".php")) continue;
+				commands.push(entry.replace(/\.php$/, ""));
+			}
+		} catch {
+			/* ignore */
+		}
+	}
+
+	return commands;
+}
+
+// ─── Migrations Count ─────────────────────────────────────────────────────
+
+async function countMigrations(root: string): Promise<number> {
+	const migrationDirs = [
+		join(root, "database", "migrations"),
+		join(root, "migrations"),
+	];
+	let count = 0;
+
+	for (const dir of migrationDirs) {
+		if (!existsSync(dir)) continue;
+		try {
+			const entries = await readdir(dir);
+			count += entries.filter(
+				(e) => !e.startsWith(".") && e.endsWith(".php"),
+			).length;
+		} catch {
+			/* ignore */
+		}
+	}
+
+	return count;
+}
+
+// ─── Env Variables ────────────────────────────────────────────────────────
+
+async function findEnvVars(root: string): Promise<string[]> {
+	const envFiles = [join(root, ".env.example"), join(root, ".env")];
+	const vars: string[] = [];
+	const seen = new Set<string>();
+
+	for (const envPath of envFiles) {
+		if (!existsSync(envPath)) continue;
+		try {
+			const content = await readFile(envPath, "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 ─────────────────────────────────────────────────────────
+
+export async function analyzeLaravel(
+	root: string,
+): Promise<LaravelAnalysis | null> {
+	if (!isLaravelWorkspace(root)) return null;
+
+	const [version, packages, authType] = await Promise.all([
+		detectVersion(root),
+		detectPackages(root),
+		detectAuth(root),
+	]);
+
+	const [controllers, models, views, commands, migrations, envVars] =
+		await Promise.all([
+			findControllers(root),
+			findModels(root),
+			findViews(root),
+			findCommands(root),
+			countMigrations(root),
+			findEnvVars(root),
+		]);
+
+	return {
+		framework: {
+			id: "laravel",
+			name: "Laravel",
+			category: "fullstack",
+			description: "The PHP Framework for Web Artisans",
+			tags: ["php", "fullstack", "eloquent"],
+		},
+		version,
+		controllers,
+		models,
+		views,
+		commands,
+		migrations,
+		authType,
+		envVars,
+		packages,
+	};
+}

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

@@ -0,0 +1,40 @@
+/**
+ * Laravel Plugin — Main Entry (RFC-0065)
+ */
+
+import type { FrameworkExtension } from "../../framework-plugin-sdk/src/types.js";
+import { analyzeLaravel } from "./analyzer.js";
+
+export type { LaravelAnalysis } from "./types.js";
+
+export async function analyzeLaravelWorkspace(
+	root: string,
+): Promise<import("./types.js").LaravelAnalysis | null> {
+	return analyzeLaravel(root);
+}
+
+export function createLaravelPlugin(): FrameworkExtension {
+	return {
+		capability: "framework",
+		name: "Laravel Framework Plugin",
+		detector: {
+			detect: async (root: unknown): Promise<unknown> => {
+				const r = root as string;
+				const { existsSync } = await import("node:fs");
+				return (
+					existsSync(`${r}/artisan`) ||
+					(existsSync(`${r}/composer.json`) &&
+						(existsSync(`${r}/app/Http/Controllers`) ||
+							existsSync(`${r}/bootstrap/app.php`)))
+				);
+			},
+			signals: [
+				{ type: "file", pattern: "artisan", weight: 0.7 },
+				{ type: "file", pattern: "composer.json", weight: 0.3 },
+				{ type: "directory", pattern: "app/Http/Controllers", weight: 0.5 },
+				{ type: "directory", pattern: "bootstrap/app.php", weight: 0.4 },
+			],
+		},
+		config: {},
+	};
+}

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

@@ -0,0 +1,24 @@
+/**
+ * Laravel Plugin — Types (RFC-0065)
+ */
+
+export interface LaravelAnalysis {
+	framework: FrameworkInfo;
+	version?: string;
+	controllers: string[];
+	models: string[];
+	views: string[];
+	commands: string[];
+	migrations: number;
+	authType?: string;
+	envVars: string[];
+	packages: string[];
+}
+
+export interface FrameworkInfo {
+	id: string;
+	name: string;
+	category: string;
+	description: string;
+	tags: string[];
+}

package/packages/laravel-plugin/test/analyzer.test.ts

@@ -0,0 +1,220 @@
+/**
+ * Laravel Plugin Tests (RFC-0065)
+ */
+
+import { describe, it, expect, afterEach } from "bun:test";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as os from "node:os";
+import { analyzeLaravel } from "../src/analyzer.js";
+
+const roots: string[] = [];
+
+async function mkdtemp(): Promise<string> {
+	const d = await fs.mkdtemp(path.join(os.tmpdir(), "laravel-plugin-"));
+	roots.push(d);
+	return d;
+}
+
+afterEach(async () => {
+	for (const d of roots) {
+		try {
+			await fs.rm(d, { recursive: true, force: true });
+		} catch {
+			/* ignore */
+		}
+	}
+	roots.length = 0;
+});
+
+describe("analyzeLaravel", () => {
+	it("returns null for non-laravel workspace", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(path.join(dir, "package.json"), "{}", "utf-8");
+		expect(await analyzeLaravel(dir)).toBeNull();
+	});
+
+	it("detects laravel workspace via artisan", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(
+			path.join(dir, "artisan"),
+			"#!/usr/bin/env php",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "composer.json"),
+			JSON.stringify({
+				name: "laravel/laravel",
+				require: { "laravel/framework": "^10.0" },
+			}),
+			"utf-8",
+		);
+		const result = await analyzeLaravel(dir);
+		expect(result).not.toBeNull();
+		expect(result!.framework.id).toBe("laravel");
+	});
+
+	it("detects laravel workspace via app structure", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "app", "Http", "Controllers"), {
+			recursive: true,
+		});
+		await fs.writeFile(
+			path.join(dir, "composer.json"),
+			JSON.stringify({
+				require: { "laravel/framework": "^10.0" },
+			}),
+			"utf-8",
+		);
+		const result = await analyzeLaravel(dir);
+		expect(result).not.toBeNull();
+	});
+
+	it("extracts version from composer.json", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(
+			path.join(dir, "artisan"),
+			"#!/usr/bin/env php",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "composer.json"),
+			JSON.stringify({
+				require: { "laravel/framework": "^10.0" },
+			}),
+			"utf-8",
+		);
+		const result = await analyzeLaravel(dir);
+		expect(result!.version).toBe("10.0");
+	});
+
+	it("lists controllers", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "app", "Http", "Controllers"), {
+			recursive: true,
+		});
+		await fs.writeFile(
+			path.join(dir, "composer.json"),
+			JSON.stringify({
+				require: { "laravel/framework": "^10.0" },
+			}),
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "app", "Http", "Controllers", "UserController.php"),
+			"class UserController {}",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "app", "Http", "Controllers", "PostController.php"),
+			"class PostController {}",
+			"utf-8",
+		);
+		const result = await analyzeLaravel(dir);
+		expect(result!.controllers).toContain("UserController");
+		expect(result!.controllers).toContain("PostController");
+	});
+
+	it("counts migrations", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "database", "migrations"), {
+			recursive: true,
+		});
+		await fs.writeFile(
+			path.join(dir, "composer.json"),
+			JSON.stringify({
+				require: { "laravel/framework": "^10.0" },
+			}),
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(
+				dir,
+				"database",
+				"migrations",
+				"2024_01_01_000000_create_users_table.php",
+			),
+			"create table",
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(
+				dir,
+				"database",
+				"migrations",
+				"2024_01_02_000000_create_posts_table.php",
+			),
+			"create table",
+			"utf-8",
+		);
+		const result = await analyzeLaravel(dir);
+		expect(result!.migrations).toBe(2);
+	});
+
+	it("detects Sanctum auth", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(
+			path.join(dir, "composer.json"),
+			JSON.stringify({
+				require: { "laravel/framework": "^10.0", "laravel/sanctum": "^3.0" },
+			}),
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "artisan"),
+			"#!/usr/bin/env php",
+			"utf-8",
+		);
+		const result = await analyzeLaravel(dir);
+		expect(result!.authType).toBe("sanctum");
+	});
+
+	it("lists artisan commands", async () => {
+		const dir = await mkdtemp();
+		await fs.mkdir(path.join(dir, "app", "Console", "Commands"), {
+			recursive: true,
+		});
+		await fs.writeFile(
+			path.join(dir, "composer.json"),
+			JSON.stringify({
+				require: { "laravel/framework": "^10.0" },
+			}),
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "app", "Console", "Commands", "SendEmailCommand.php"),
+			"class SendEmailCommand {}",
+			"utf-8",
+		);
+		const result = await analyzeLaravel(dir);
+		expect(result!.commands).toContain("SendEmailCommand");
+	});
+
+	it("extracts env variables", async () => {
+		const dir = await mkdtemp();
+		await fs.writeFile(
+			path.join(dir, ".env.example"),
+			`
+APP_NAME=Laravel
+APP_ENV=local
+APP_KEY=
+DB_CONNECTION=mysql
+MAIL_MAILER=smtp
+`.trim(),
+			"utf-8",
+		);
+		await fs.writeFile(
+			path.join(dir, "composer.json"),
+			JSON.stringify({
+				require: { "laravel/framework": "^10.0" },
+			}),
+			"utf-8",
+		);
+		await fs.mkdir(path.join(dir, "app", "Http", "Controllers"), {
+			recursive: true,
+		});
+		const result = await analyzeLaravel(dir);
+		expect(result!.envVars).toContain("APP_NAME");
+		expect(result!.envVars).toContain("DB_CONNECTION");
+	});
+});

package/packages/laravel-plugin/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "references": [
+    { "path": "../framework-plugin-sdk" },
+    { "path": "../framework-detector" }
+  ]
+}

package/packages/learning-engine/dist/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,EAQjB,MAAM,YAAY,CAAC;AAmNpB,qBAAa,cAAc;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAS;gBAEhB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE;IAKjE;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc;IAqF/C;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,iBAAiB,GAAG,iBAAiB;IASzD;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,iBAAiB,GAAG,iBAAiB;IAQxD;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM;CA6BlD;AAID,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,cAAc,CAEjB"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACX,eAAe,EACf,cAAc,EACd,iBAAiB,EAQjB,MAAM,YAAY,CAAC;AAmNpB,qBAAa,cAAc;IAC1B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAS;IAE5B,YAAY,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAGhE;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAmF9C;IAED;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,iBAAiB,GAAG,iBAAiB,CAOxD;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,iBAAiB,GAAG,iBAAiB,CAMvD;IAED;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,CA4BjD;CACD;AAID,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,cAAc,CAEjB"}

package/packages/learning-engine/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-harness/learning-engine",
-  "version": "0.9.1",
+  "version": "0.9.5",
   "description": "Learning engine for extracting lessons from runtime execution (RFC-0058)",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,6 +18,6 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "typescript": "^5.5.0"
+    "typescript": "^7.0.2"
   }
 }

package/packages/mcp-adapter/README.md

@@ -0,0 +1,47 @@
+# @pi/mcp-adapter
+
+MCP (Model Context Protocol) server adapter for pi-harness. Exposes harness capabilities as MCP tools, resources, and prompts over STDIO transport.
+
+## Protocol
+
+- **Transport**: STDIO (JSON-RPC 2.0 over stdin/stdout)
+- **Protocol Version**: 2024-11-05
+- **Spec**: <https://modelcontextprotocol.io>
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `analyze_workspace` | Analyze a codebase for framework detection |
+| `search_memory` | Search harness persistent memory |
+| `list_skills` | List all registered skills |
+| `invoke_skill` | Invoke a named skill |
+
+## Usage
+
+```typescript
+import { createMCPServer } from "@pi/mcp-adapter";
+
+await createMCPServer({ name: "pi-harness", version: "0.9.4" });
+```
+
+Start as a subprocess:
+
+```bash
+node dist/index.js
+# or via npx
+npx @pi/mcp-adapter
+```
+
+## MCP Client Example (Claude Desktop)
+
+```json
+{
+  "mcpServers": {
+    "pi-harness": {
+      "command": "node",
+      "args": ["/path/to/node_modules/@pi/mcp-adapter/dist/index.js"]
+    }
+  }
+}
+```

package/packages/mcp-adapter/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Adapter — Main Entry (RFC-0068)
+ */
+export { createMCPServer } from "./server.js";
+export type { MCPRequest, MCPResponse, MCPError, MCPServerOptions, ServerCapabilities, InitializeResult, MCPTool, MCPToolCall, MCPResource, MCPPrompt, ToolCallResult, } from "./types.js";
+export { HARNESS_TOOLS } from "./tools.js";
+export { handleToolCall } from "./tools.js";
+//# sourceMappingURL=index.d.ts.map