@elyracode/laravel 0.7.15 → 0.7.16

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## [Unreleased]
+
+## [0.7.16] - 2026-05-26
+
+### Added
+- `laravel_docs` tool: semantic search across 17,000+ Laravel ecosystem documentation entries with version-specific results
+- `laravel_logs` tool: read and filter recent entries from the Laravel application log
+- `laravel_last_error` tool: quickly retrieve the most recent error from the application log
+
 ## [0.7.12] - 2026-05-24
 
 ### Added

package/README.md

@@ -15,11 +15,18 @@ elyra install npm:@elyracode/laravel
 | `laravel_models` | Map all Eloquent models with relationships, casts, scopes, traits, and fillable fields |
 | `laravel_routes` | List routes with middleware, controllers, form requests, and resources |
 | `laravel_analyze` | Analyze project architecture: stack, patterns, auth, queue, conventions |
+| `laravel_docs` | Semantic search of Laravel ecosystem documentation (Laravel, Livewire, Inertia, Filament, Pest, Tailwind, etc.) |
+| `laravel_logs` | Read recent log entries from the application log with count and level filtering |
+| `laravel_last_error` | Get the most recent error or exception from the Laravel log |
 
 ## Why
 
 Other coding agents read Laravel files one at a time and guess at conventions. With these tools, the agent sees your entire data model and architecture before writing a single line — fewer wrong guesses, fewer wasted tokens, code that matches your project.
 
+## Documentation Search
+
+`laravel_docs` searches 17,000+ Laravel ecosystem documentation entries using semantic search, powered by [Laravel Boost](https://laravelboost.com)'s hosted API. Results are version-specific to the project's installed packages. Requires internet access; no authentication needed.
+
 ## Included Skill
 
 The `elyra-laravel` skill provides deep knowledge of Laravel conventions, Eloquent patterns, common architectures, and best practices.

package/extensions/index.ts

@@ -404,6 +404,91 @@ function analyzeProject(cwd: string, models: ModelInfo[]): string {
 	return lines.join("\n");
 }
 
+// ── Installed Packages ───────────────────────────────────────────────────────
+
+function getInstalledPackages(cwd: string): Array<{ name: string; version: string }> {
+	const packages: Array<{ name: string; version: string }> = [];
+	const ecosystemPrefixes = [
+		"laravel/",
+		"livewire/",
+		"inertiajs/",
+		"filament/",
+		"pestphp/",
+		"spatie/",
+		"tightenco/",
+		"nunomaduro/",
+		"barryvdh/",
+	];
+	const npmEcosystemPatterns = [
+		"@inertiajs/",
+		"tailwindcss",
+		"alpinejs",
+		"@tailwindcss/",
+		"@livewire/",
+	];
+
+	const composerLockPath = join(cwd, "composer.lock");
+	if (existsSync(composerLockPath)) {
+		try {
+			const lock = JSON.parse(readFileSync(composerLockPath, "utf-8")) as {
+				packages: Array<{ name: string; version: string }>;
+			};
+			for (const pkg of lock.packages) {
+				if (ecosystemPrefixes.some((prefix) => pkg.name.startsWith(prefix))) {
+					const major = pkg.version.replace(/^v/, "").split(".")[0];
+					packages.push({ name: pkg.name, version: `${major}.x` });
+				}
+			}
+		} catch {
+			// skip
+		}
+	}
+
+	const packageJsonPath = join(cwd, "package.json");
+	if (existsSync(packageJsonPath)) {
+		try {
+			const pkgJson = JSON.parse(readFileSync(packageJsonPath, "utf-8")) as Record<string, unknown>;
+			const deps = {
+				...(pkgJson.dependencies as Record<string, string> ?? {}),
+				...(pkgJson.devDependencies as Record<string, string> ?? {}),
+			};
+			for (const [name, version] of Object.entries(deps)) {
+				if (npmEcosystemPatterns.some((p) => name === p || name.startsWith(p))) {
+					const clean = version.replace(/^[\^~>=<]*/, "");
+					const major = clean.split(".")[0];
+					packages.push({ name, version: `${major}.x` });
+				}
+			}
+		} catch {
+			// skip
+		}
+	}
+
+	return packages;
+}
+
+// ── Log Parser ──────────────────────────────────────────────────────────────
+
+function parseLogEntries(content: string): string[] {
+	const lines = content.split("\n");
+	const entries: string[] = [];
+	const entryPattern = /^\[\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}:\d{2}\]/;
+	let currentLines: string[] = [];
+
+	for (let i = lines.length - 1; i >= 0; i--) {
+		const line = lines[i];
+		if (entryPattern.test(line)) {
+			currentLines.unshift(line);
+			entries.unshift(currentLines.join("\n"));
+			currentLines = [];
+		} else {
+			currentLines.unshift(line);
+		}
+	}
+
+	return entries;
+}
+
 // ── Extension ───────────────────────────────────────────────────────────────
 
 export default function (elyra: ExtensionAPI): void {
@@ -527,4 +612,149 @@ function registerTools(elyra: ExtensionAPI, getCwd: () => string): void {
 			return { content: [{ type: "text", text: result }] };
 		},
 	});
+
+	// ── laravel_docs ─────────────────────────────────────────────────────
+
+	const docsSchema = Type.Object({
+		queries: Type.Array(Type.String({ description: "Search query" }), {
+			description: "List of documentation search queries. Pass multiple if uncertain about terminology.",
+		}),
+		packages: Type.Optional(
+			Type.Array(Type.String({ description: "Composer or npm package name (e.g. 'laravel/framework')" }), {
+				description: "Limit search to specific packages. Uses all detected packages if omitted.",
+			}),
+		),
+		token_limit: Type.Optional(
+			Type.Integer({ description: "Max tokens in response. Default 3000, max 100000." }),
+		),
+	});
+
+	elyra.registerTool({
+		name: "laravel_docs",
+		label: "Laravel Docs",
+		description:
+			"Search version-specific documentation for Laravel ecosystem packages (Laravel, Livewire, Inertia, Filament, Pest, Tailwind, etc). Uses semantic search across 17,000+ documentation entries. Always use this before consulting external documentation. Results are specific to the versions installed in this project.",
+		parameters: docsSchema,
+		promptSnippet: "Search Laravel ecosystem documentation for version-specific guidance",
+		async execute(_toolCallId, params) {
+			if (!isLaravelProject(getCwd())) {
+				return { content: [{ type: "text", text: "Not a Laravel project" }], isError: true };
+			}
+
+			let packages = getInstalledPackages(getCwd());
+			if (params.packages && params.packages.length > 0) {
+				const filter = new Set(params.packages);
+				packages = packages.filter((p) => filter.has(p.name));
+			}
+
+			const tokenLimit = Math.min(params.token_limit ?? 3000, 100000);
+
+			try {
+				const response = await fetch("https://boost.laravel.com/api/docs", {
+					method: "POST",
+					headers: { "Content-Type": "application/json" },
+					body: JSON.stringify({
+						queries: params.queries,
+						packages,
+						token_limit: tokenLimit,
+						format: "markdown",
+					}),
+				});
+
+				if (!response.ok) {
+					return { content: [{ type: "text", text: `Docs API returned ${response.status}: ${await response.text()}` }], isError: true };
+				}
+
+				const text = await response.text();
+				return { content: [{ type: "text", text }] };
+			} catch (err) {
+				const message = err instanceof Error ? err.message : String(err);
+				return { content: [{ type: "text", text: `Failed to fetch docs: ${message}` }], isError: true };
+			}
+		},
+	});
+
+	// ── laravel_logs ─────────────────────────────────────────────────────
+
+	const logsSchema = Type.Object({
+		entries: Type.Optional(Type.Integer({ description: "Number of log entries to return. Default 10, max 50." })),
+		level: Type.Optional(Type.String({ description: "Filter by log level: emergency, alert, critical, error, warning, notice, info, debug" })),
+	});
+
+	elyra.registerTool({
+		name: "laravel_logs",
+		label: "Laravel Logs",
+		description:
+			"Read recent log entries from the Laravel application log (storage/logs/laravel.log). Parses multi-line PSR-3 formatted entries. Use this to diagnose errors, check for warnings, or understand application behavior.",
+		parameters: logsSchema,
+		promptSnippet: "Read recent Laravel log entries",
+		async execute(_toolCallId, params) {
+			const logPath = join(getCwd(), "storage/logs/laravel.log");
+			if (!existsSync(logPath)) {
+				return { content: [{ type: "text", text: "Log file not found at storage/logs/laravel.log" }], isError: true };
+			}
+
+			const content = readFileSync(logPath, "utf-8");
+			let entries = parseLogEntries(content);
+
+			if (params.level) {
+				const level = params.level.toUpperCase();
+				entries = entries.filter((entry) => {
+					const match = entry.match(/^\[\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}:\d{2}\]\s+\w+\.(\w+):/);
+					return match && match[1].toUpperCase() === level;
+				});
+			}
+
+			const count = Math.min(Math.max(params.entries ?? 10, 1), 50);
+			entries = entries.slice(-count);
+
+			if (entries.length === 0) {
+				return { content: [{ type: "text", text: params.level ? `No log entries found with level "${params.level}".` : "No log entries found." }] };
+			}
+
+			let output = entries.join("\n\n");
+			const maxSize = 50 * 1024;
+			if (output.length > maxSize) {
+				output = output.slice(-maxSize);
+			}
+
+			return { content: [{ type: "text", text: output }] };
+		},
+	});
+
+	// ── laravel_last_error ───────────────────────────────────────────────
+
+	const lastErrorSchema = Type.Object({});
+
+	elyra.registerTool({
+		name: "laravel_last_error",
+		label: "Laravel Last Error",
+		description:
+			"Get the most recent error or exception from the Laravel application log. Useful for quick debugging when something has gone wrong.",
+		parameters: lastErrorSchema,
+		promptSnippet: "Get the last error from Laravel logs",
+		async execute() {
+			const logPath = join(getCwd(), "storage/logs/laravel.log");
+			if (!existsSync(logPath)) {
+				return { content: [{ type: "text", text: "Log file not found at storage/logs/laravel.log" }], isError: true };
+			}
+
+			const content = readFileSync(logPath, "utf-8");
+			const entries = parseLogEntries(content);
+			const errorLevels = new Set(["ERROR", "CRITICAL", "EMERGENCY", "ALERT"]);
+
+			for (let i = entries.length - 1; i >= 0; i--) {
+				const match = entries[i].match(/^\[\d{4}-\d{2}-\d{2}\s+\d{2}:\d{2}:\d{2}\]\s+\w+\.(\w+):/);
+				if (match && errorLevels.has(match[1].toUpperCase())) {
+					let entry = entries[i];
+					if (entry.length > 2048) {
+						entry = entry.slice(0, 2048) + "\n... (truncated)";
+					}
+					return { content: [{ type: "text", text: entry }] };
+				}
+			}
+
+			return { content: [{ type: "text", text: "No error entries found in the log." }] };
+		},
+	});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elyracode/laravel",
-  "version": "0.7.15",
+  "version": "0.7.16",
   "description": "Deep Laravel project understanding for Elyra -- model relationships, route mapping, architecture analysis",
   "type": "module",
   "keywords": [

package/skills/elyra-laravel/SKILL.md

@@ -20,6 +20,9 @@ Use Laravel tools when:
 | `laravel_models` | Understanding data model, relationships, and model structure before generating code |
 | `laravel_routes` | Understanding existing routes, middleware, and controllers before adding new endpoints |
 | `laravel_analyze` | Understanding project conventions and patterns before writing any code |
+| `laravel_docs` | Searching Laravel ecosystem documentation before consulting external sources |
+| `laravel_logs` | Reading recent log entries with optional count and level filtering |
+| `laravel_last_error` | Getting the most recent error or exception from the Laravel log |
 
 ## Combining with Database Tools
 
@@ -35,6 +38,18 @@ Compare the two to find gaps:
 - Missing indexes on foreign key columns
 - Missing foreign key constraints on `_id` columns
 
+## Documentation Search
+
+Use `laravel_docs` before consulting external documentation. It performs semantic search across 17,000+ documentation entries covering the Laravel ecosystem: Laravel, Livewire, Inertia, Filament, Pest, Tailwind, and more.
+
+- Results are version-specific to the project's installed packages
+- Pass multiple queries if you are uncertain about the exact terminology
+- Filter by specific packages when you know which one is relevant
+
+## Log Analysis
+
+Use `laravel_last_error` when something has broken — it is the quickest way to see what went wrong. Use `laravel_logs` for broader log analysis, filtering entries by level (e.g. `error`, `warning`, `info`). Combine both with error context to understand application behavior over time.
+
 ## Key Principle
 
 Run `laravel_analyze` or `laravel_models` BEFORE generating Laravel code. Match the project's existing patterns — if it uses Actions, don't create Services. If controllers are invokable, don't create resource controllers.