@octanejs/mcp-server 0.2.5 → 0.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octanejs/mcp-server",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "type": "module",
   "engines": {
     "node": ">=22"

package/skills/setup-ssr.md

@@ -66,9 +66,13 @@ hydration-stable; the client adopts server DOM instead of rebuilding it.
    self-contained SSR server at `dist/server/entry.js` (exports
    `handler`/`nodeHandler`; preview with `octane-preview`);
    `server.render: 'buffered'` switches it to the await-everything `prerender`.
-   A deploy adapter can restructure the output for a host — for example
-   `adapter: vercel()` from `@octanejs/adapter-vercel` emits Vercel's Build
-   Output API.
+   A deploy adapter prepares the output for a host: `adapter: vercel()` from
+   `@octanejs/adapter-vercel` emits Vercel's Build Output API, while
+   `adapter: cloudflare()` from `@octanejs/adapter-cloudflare` emits a module
+   Worker at `dist/server/worker.js` for Workers Static Assets. Cloudflare apps
+   keep a user-owned `wrangler.jsonc` pointing `main` at that Worker and
+   `assets.directory` at `dist/client`, with `nodejs_compat` enabled. Leave
+   `assets.not_found_handling` unset or `"none"` so navigation misses reach SSR.
 2. **Custom server**: write `entry-server.ts` exporting a function that calls
    `prerender()` (or `renderToString()`, or a streaming renderer) and splices
    the result into your HTML template, and `entry-client.ts` calling

package/src/bridge.js

@@ -22,6 +22,7 @@ export const KNOWN_BINDINGS = {
 	'styled-components': '@octanejs/styled-components',
 	'react-router': '@octanejs/remix-router',
 	'react-router-dom': '@octanejs/remix-router',
+	nuqs: '@octanejs/nuqs',
 	'@lexical/react': '@octanejs/lexical',
 	'@tiptap/react': '@octanejs/tiptap',
 	'lucide-react': '@octanejs/lucide',

package/src/bridge.test.js

@@ -1,8 +1,9 @@
 import { describe, expect, it } from 'vitest';
-import { mkdir, mkdtemp, readdir, readFile, writeFile } from 'node:fs/promises';
+import { mkdir, mkdtemp, readFile, writeFile } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
+import { getBindingPackages } from '../../../scripts/workspace-packages.mjs';
 import {
 	bridgeReport,
 	bridgeReportFromSource,
@@ -261,40 +262,14 @@ describe('KNOWN_BINDINGS', () => {
 		expect(upstreamPackages.every((name) => KNOWN_BINDINGS[name] === '@octanejs/visx')).toBe(true);
 	});
 
-	it('covers every published @octanejs binding (derived from workspace manifests)', async () => {
-		// The expected set is DERIVED from packages/*/package.json rather than
-		// hand-maintained, so publishing a new binding without registering it in
-		// KNOWN_BINDINGS fails here. Only genuinely-not-a-binding packages (the
-		// core runtime, build/deploy infrastructure, this MCP server) are
-		// excluded by name.
-		const NON_BINDINGS = new Set([
-			'octane',
-			'@octanejs/app-core',
-			'@octanejs/rspack-plugin',
-			'@octanejs/rsbuild-plugin',
-			'@octanejs/vite-plugin',
-			'@octanejs/adapter-vercel',
-			'@octanejs/mcp-server',
-		]);
-		const packagesRoot = fileURLToPath(new URL('../..', import.meta.url));
-		const bindings = [];
-		const bindingDirectories = [];
-		for (const entry of await readdir(packagesRoot, { withFileTypes: true })) {
-			if (!entry.isDirectory()) continue;
-			let manifest;
-			try {
-				manifest = JSON.parse(
-					await readFile(join(packagesRoot, entry.name, 'package.json'), 'utf8'),
-				);
-			} catch {
-				continue; // not a package dir
-			}
-			if (manifest.private || NON_BINDINGS.has(manifest.name)) continue;
-			bindings.push(manifest.name);
-			bindingDirectories.push(entry.name);
-		}
+	it('covers every published @octanejs binding (derived from workspace manifests)', () => {
+		// Use the same role classification as the generated package inventory so
+		// metaframeworks and infrastructure cannot drift into the binding catalog.
+		const bindings = getBindingPackages();
 		expect(bindings.length).toBeGreaterThan(0);
-		expect(new Set(Object.values(KNOWN_BINDINGS))).toEqual(new Set(bindings));
-		expect(KNOWN_BINDING_PACKAGE_DIRS).toEqual(new Set(bindingDirectories));
+		expect(new Set(Object.values(KNOWN_BINDINGS))).toEqual(
+			new Set(bindings.map(({ name }) => name)),
+		);
+		expect(KNOWN_BINDING_PACKAGE_DIRS).toEqual(new Set(bindings.map(({ dir }) => dir)));
 	});
 });

package/src/index.js

@@ -54,10 +54,14 @@ export const BENCHMARK_SUITES = [
 	'react-hosted-islands',
 	'ssr-throughput',
 	'streaming-ssr',
+	'ssr-http',
+	'ssr-workerd',
+	'tanstack-start',
 	'dbmon-deopt',
 	'js-framework-deopt',
 	'async-waterfall',
 	'async-composition',
+	'lynx-list',
 	'codegen-size',
 	'bundle-size',
 	'three-renderer',
@@ -94,7 +98,7 @@ export function areaForPath(path) {
 	if (path.startsWith('packages/rspack-plugin-octane/')) return 'rspack-plugin';
 	if (path.startsWith('packages/rsbuild-plugin-octane/')) return 'rsbuild-plugin';
 	if (path.startsWith('packages/vite-plugin-octane/')) return 'vite-plugin';
-	if (path.startsWith('packages/adapter-vercel/')) return 'deploy-adapter';
+	if (/^packages\/adapter-[^/]+\//.test(path)) return 'deploy-adapter';
 	if (path.startsWith('packages/octane-evals/')) return 'evals';
 	if (path.startsWith('packages/octane-mcp-server/')) return 'mcp-server';
 	const packageMatch = path.match(/^packages\/([^/]+)\//);
@@ -166,9 +170,14 @@ export function validationFor(paths, taskKind) {
 		);
 	}
 	if (areas.has('deploy-adapter')) {
-		commands.add(
-			'./node_modules/.bin/vitest run packages/adapter-vercel/tests --project adapter-vercel',
-		);
+		for (const path of paths) {
+			const match = path.match(/^packages\/(adapter-[^/]+)\//);
+			if (match) {
+				commands.add(
+					`./node_modules/.bin/vitest run packages/${match[1]}/tests --project ${match[1]}`,
+				);
+			}
+		}
 	}
 	if (
 		areas.has('metaframework-core') ||

package/src/index.test.js

@@ -30,6 +30,7 @@ describe('@octanejs/mcp-server helpers', () => {
 		expect(areaForPath('packages/radix/src/index.ts')).toBe('ecosystem-binding');
 		expect(areaForPath('packages/octane-mcp-server/src/index.js')).toBe('mcp-server');
 		expect(areaForPath('packages/adapter-vercel/src/index.ts')).toBe('deploy-adapter');
+		expect(areaForPath('packages/adapter-cloudflare/src/index.js')).toBe('deploy-adapter');
 		expect(areaForPath('packages/octane-evals/tools/run.mjs')).toBe('evals');
 		expect(areaForPath('website/src/pages/index.tsrx')).toBe('website');
 		expect(areaForPath('benchmarks/news/run.mjs')).toBe('benchmark');
@@ -40,6 +41,7 @@ describe('@octanejs/mcp-server helpers', () => {
 		const commands = validationFor(
 			[
 				'packages/adapter-vercel/src/index.ts',
+				'packages/adapter-cloudflare/src/index.js',
 				'packages/octane-evals/tools/run.mjs',
 				'website/src/pages/index.tsrx',
 			],
@@ -49,6 +51,9 @@ describe('@octanejs/mcp-server helpers', () => {
 		expect(commands).toContain(
 			'./node_modules/.bin/vitest run packages/adapter-vercel/tests --project adapter-vercel',
 		);
+		expect(commands).toContain(
+			'./node_modules/.bin/vitest run packages/adapter-cloudflare/tests --project adapter-cloudflare',
+		);
 		expect(commands).toContain(
 			'./node_modules/.bin/vitest run packages/octane-evals/tests --project octane-evals',
 		);