pi-harness-runtime 0.9.4 → 0.9.6

package/packages/nextjs-plugin/dist/analyzer.js

@@ -0,0 +1,217 @@
+/**
+ * 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";
+// ─── Detection ───────────────────────────────────────────────────────────────
+function isNextJsWorkspace(root) {
+    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) {
+    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) {
+    const hasApp = existsSync(join(root, "app"));
+    const hasPages = existsSync(join(root, "pages"));
+    return { usingAppRouter: hasApp, usingPagesRouter: hasPages };
+}
+// ─── Config Files ────────────────────────────────────────────────────────────
+async function findConfigFiles(root) {
+    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 = [];
+    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, base = "") {
+    const routes = [];
+    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, base = "") {
+    const routes = [];
+    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) {
+    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) {
+    const candidates = [
+        join(root, ".env.example"),
+        join(root, ".env.local"),
+        join(root, ".env.development"),
+        join(root, ".env.production"),
+    ];
+    const vars = [];
+    const seen = new Set();
+    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) {
+    if (!isNextJsWorkspace(root)) {
+        return null;
+    }
+    const [version, routers, configs] = await Promise.all([
+        detectVersion(root),
+        detectRouters(root),
+        findConfigFiles(root),
+    ]);
+    const appRoutes = [];
+    if (routers.usingAppRouter) {
+        appRoutes.push(...(await walkAppRouter(join(root, "app"))));
+    }
+    const apiRoutes = [];
+    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,
+    };
+}
+//# sourceMappingURL=analyzer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","sourceRoot":"","sources":["../src/analyzer.ts"],"names":[],"mappings":"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"}

package/packages/nextjs-plugin/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Next.js Plugin — Main Entry (RFC-0062)
+ */
+import type { FrameworkExtension } from "../../framework-plugin-sdk/src/types.js";
+export type { NextJsAnalysis, AppRoute, ConfigFile } from "./types.js";
+export declare function analyzeNextJsWorkspace(root: string): Promise<import("./types.js").NextJsAnalysis | null>;
+export declare function createNextJsPlugin(): FrameworkExtension;
+//# sourceMappingURL=index.d.ts.map

package/packages/nextjs-plugin/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAGlF,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvE,wBAAsB,sBAAsB,CAC3C,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,YAAY,EAAE,cAAc,GAAG,IAAI,CAAC,CAErD;AAED,wBAAgB,kBAAkB,IAAI,kBAAkB,CAyBvD"}

package/packages/nextjs-plugin/dist/index.js

@@ -0,0 +1,32 @@
+/**
+ * Next.js Plugin — Main Entry (RFC-0062)
+ */
+import { analyzeNextJs } from "./analyzer.js";
+export async function analyzeNextJsWorkspace(root) {
+    return analyzeNextJs(root);
+}
+export function createNextJsPlugin() {
+    return {
+        capability: "framework",
+        name: "Next.js Framework Plugin",
+        detector: {
+            detect: async (root) => {
+                const r = root;
+                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: {},
+    };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAI9C,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,IAAY;IAEZ,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,kBAAkB;IACjC,OAAO;QACN,UAAU,EAAE,WAAW;QACvB,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE;YACT,MAAM,EAAE,KAAK,EAAE,IAAa,EAAoB,EAAE;gBACjD,MAAM,CAAC,GAAG,IAAc,CAAC;gBACzB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;gBAC/C,OAAO,CACN,UAAU,CAAC,GAAG,CAAC,iBAAiB,CAAC;oBACjC,UAAU,CAAC,GAAG,CAAC,kBAAkB,CAAC;oBAClC,UAAU,CAAC,GAAG,CAAC,iBAAiB,CAAC;oBACjC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;oBACtB,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CACxB,CAAC;YACH,CAAC;YACD,OAAO,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE;gBACrD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;gBAClD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE;gBACpD,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE;aACjD;SACD;QACD,MAAM,EAAE,EAAE;KACV,CAAC;AACH,CAAC"}

package/packages/nextjs-plugin/dist/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/nextjs-plugin/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACb"}

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

@@ -0,0 +1,5 @@
+/**
+ * Next.js Plugin — Types (RFC-0062)
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/packages/nextjs-plugin/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@pi-harness/nextjs-plugin",
+  "version": "0.9.6",
+  "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

@@ -0,0 +1,247 @@
+/**
+ * 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

@@ -0,0 +1,41 @@
+/**
+ * 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: {},
+	};
+}