fix: update instructions/AGENTS.md

Co-authored-by: jyc.dev <jycouet@gmail.com>

.changeset/rich-wolves-double.md

@@ -1,5 +0,0 @@
----
-'@sveltejs/mcp': patch
----
-
-feat: display similar result & error at the end

.github/workflows/release.yml

@@ -17,7 +17,7 @@ jobs:
     name: Release
     runs-on: ${{ matrix.os }}
     outputs:
-      publishedPackages: ${{ steps.changesets.outputs.publishedPackages }}
+      published: ${{ steps.changesets.outputs.published }}
     strategy:
       matrix:
         # pseudo-matrix for convenience, NEVER use more than a single combination
@@ -64,7 +64,7 @@ jobs:
 
   publish-mcp:
     needs: release
-    if: contains(needs.release.outputs.publishedPackages, '"@sveltejs/mcp"')
+    if: needs.release.outputs.published == 'true'
     uses: ./.github/workflows/publish-mcp.yml
     secrets:
       MCP_KEY: ${{ secrets.MCP_KEY }}

documentation/docs/10-introduction/.generated/agents.md

@@ -1,6 +1,6 @@
 You are able to use the Svelte MCP server, where you have access to comprehensive Svelte 5 and SvelteKit documentation. Here's how to use the available tools effectively:
 
-## Available Svelte MCP Tools:
+## Available MCP Tools:
 
 ### 1. list-sections
 

documentation/docs/50-opencode-plugin/opencode-plugin.md

@@ -33,13 +33,10 @@ The default configuration for the Svelte OpenCode plugin looks like this...
 	},
 	"skills": {
 		"enabled": true
-	},
-	"instructions": {
-		"enabled": true
 	}
 }
 ```
 
 ...but if you prefer, you can enable only the subagent, only the MCP, only the skills, or configure the kind of MCP server you want to use (`local` or `remote`).
 
-You can place this file in `./.opencode/svelte.json` (in your project), in `~/.config/opencode/svelte.json` or, if you have an `OPENCODE_CONFIG_DIR` environment variable specified, at `$OPENCODE_CONFIG_DIR/svelte.json`.
+You can place this file in `~/.config/opencode/svelte.json` or, if you have an `OPENCODE_CONFIG_DIR` environment variable specified, at `$OPENCODE_CONFIG_DIR/svelte.json`.

documentation/docs/60-skills/.generated/skills.md

@@ -1,6 +1,6 @@
 ## `svelte-code-writer`
 
-CLI tools for Svelte 5 documentation lookup and code analysis. MUST be used whenever creating, editing or analyzing any Svelte component (.svelte) or Svelte module (.svelte.ts/.svelte.js). If possible, this skill should be executed within the svelte-file-editor agent for optimal results.
+CLI tools for Svelte 5 documentation lookup and code analysis. MUST be used whenever creating or editing any Svelte component (.svelte) or Svelte module (.svelte.ts/.svelte.js). If possible, this skill should be executed within the svelte-file-editor agent for optimal results.
 
 <a href="https://github.com/sveltejs/mcp/releases?q=svelte-code-writer" target="_blank" rel="noopener noreferrer">Open Releases page</a>
 

packages/mcp-server/src/mcp/handlers/tools/get-documentation.ts

@@ -91,56 +91,16 @@ export async function get_documentation_handler({
 		}
 	});
 
-	const successes = results.filter((r) => r.success);
-	const failed_sections = sections.filter(
-		(s) =>
-			!available_sections.some(
-				(a) => a.title.toLowerCase() === s.toLowerCase() || a.slug === s || a.url === s,
-			),
-	);
+	const has_any_success = results.some((result) => result.success);
+	let final_text = results.map((r) => r.content).join('\n\n---\n\n');
 
-	if (successes.length > 0 && failed_sections.length === 0) {
-		return successes.map((r) => r.content).join('\n\n---\n\n');
-	}
-
-	const parts: string[] = [];
-
-	if (successes.length > 0) {
-		parts.push(successes.map((r) => r.content).join('\n\n---\n\n'));
-	}
-
-	const fuzzy_results = failed_sections.map((requested) => {
-		const lower = requested.toLowerCase();
-		const matches = available_sections.filter(
-			(a) =>
-				a.title.toLowerCase().includes(lower) ||
-				a.slug.includes(lower) ||
-				lower.includes(a.slug.split('/').pop() ?? '') ||
-				a.use_cases.toLowerCase().includes(lower),
-		);
-		return { requested, matches };
-	});
-
-	const has_fuzzy = fuzzy_results.some((r) => r.matches.length > 0);
-
-	// Full list only when no successes and no fuzzy matches
-	if (successes.length === 0 && !has_fuzzy) {
+	if (!has_any_success) {
 		const formatted_sections = await format_sections_list();
-		parts.push(`${SECTIONS_LIST_INTRO}\n\n${formatted_sections}\n\n${SECTIONS_LIST_OUTRO}`);
+
+		final_text += `\n\n---\n\n${SECTIONS_LIST_INTRO}\n\n${formatted_sections}\n\n${SECTIONS_LIST_OUTRO}`;
 	}
 
-	// Similar results then errors
-	for (const { requested, matches } of fuzzy_results) {
-		if (matches.length > 0) {
-			const match_list = matches.map((m) => `- title: ${m.title}, section: ${m.slug}`).join('\n');
-			parts.push(
-				`${matches.length} similar result${matches.length > 1 ? 's' : ''} for "${requested}":\n${match_list}`,
-			);
-		}
-		parts.push(`Section not found: "${requested}".`);
-	}
-
-	return parts.join('\n\n---\n\n');
+	return final_text;
 }
 
 export function get_documentation(server: SvelteMcp) {

packages/opencode/CHANGELOG.md

@@ -1,11 +1,5 @@
 # @sveltejs/opencode
 
-## 0.1.2
-
-### Patch Changes
-
-- feat: allow for local opencode config ([#156](https://github.com/sveltejs/mcp/pull/156))
-
 ## 0.1.1
 
 ### Patch Changes

packages/opencode/config.ts

@@ -71,15 +71,8 @@ function get_config_paths() {
 		}
 	}
 
-	// Project-local: ./.opencode/svelte.json (cwd)
-	let project_path: string | null = null;
-	const project_config = join(process.cwd(), '.opencode', 'svelte.json');
-	if (existsSync(project_config)) {
-		project_path = project_config;
-	}
-
-	// Lowest priority first, highest priority last (project overrides global)
-	return [global_path, config_dir_path, project_path];
+	// returning config_dir first so it has higher priority
+	return [config_dir_path, global_path];
 }
 
 function load_config_file(config_path: string): ConfigLoadResult {
@@ -128,9 +121,6 @@ function merge_with_defaults(user_config: Partial<McpConfig>): McpConfig {
 
 export function get_mcp_config(ctx: PluginInput) {
 	const config_paths = get_config_paths();
-	let merged: Partial<McpConfig> = {};
-
-	// Iterate from lowest to highest priority, merging as we go
 	for (const path of config_paths) {
 		if (path && existsSync(path)) {
 			const result = load_config_file(path);
@@ -139,28 +129,23 @@ export function get_mcp_config(ctx: PluginInput) {
 					ctx.client.tui.showToast({
 						body: {
 							title: 'Svelte: Invalid opencode plugin config',
-							message: `${result.parse_error} (${path})\nSkipping this config file`,
+							message: `${result.parse_error}\nUsing default values`,
 							variant: 'warning',
 							duration: 7000,
 						},
 					});
 				}, 7000);
-				continue;
+				return default_config;
 			}
 			const parsed = v.safeParse(config_schema, result.data);
 			if (parsed.success) {
-				merged = {
-					mcp: { ...merged.mcp, ...parsed.output.mcp },
-					subagent: { ...merged.subagent, ...parsed.output.subagent },
-					instructions: { ...merged.instructions, ...parsed.output.instructions },
-					skills: { ...merged.skills, ...parsed.output.skills },
-				};
+				return merge_with_defaults(parsed.output);
 			} else {
 				setTimeout(() => {
 					ctx.client.tui.showToast({
 						body: {
 							title: 'Svelte: Invalid opencode plugin config',
-							message: `Invalid config schema (${path})\nSkipping this config file`,
+							message: `${result.parse_error}\nUsing default values`,
 							variant: 'warning',
 							duration: 7000,
 						},
@@ -170,5 +155,5 @@ export function get_mcp_config(ctx: PluginInput) {
 		}
 	}
 
-	return merge_with_defaults(merged);
+	return default_config;
 }

packages/opencode/instructions/opencode-agents.md

@@ -1,6 +1,6 @@
 You are able to use the Svelte MCP server, where you have access to comprehensive Svelte 5 and SvelteKit documentation. Here's how to use the available tools effectively:
 
-## Available Svelte MCP Tools:
+## Available MCP Tools:
 
 ### 1. list-sections
 

packages/opencode/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sveltejs/opencode",
-	"version": "0.1.2",
+	"version": "0.1.1",
 	"type": "module",
 	"license": "MIT",
 	"homepage": "https://github.com/sveltejs/mcp#readme",

packages/opencode/skills/svelte-code-writer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: svelte-code-writer
-description: CLI tools for Svelte 5 documentation lookup and code analysis. MUST be used whenever creating, editing or analyzing any Svelte component (.svelte) or Svelte module (.svelte.ts/.svelte.js). If possible, this skill should be executed within the svelte-file-editor agent for optimal results.
+description: CLI tools for Svelte 5 documentation lookup and code analysis. MUST be used whenever creating or editing any Svelte component (.svelte) or Svelte module (.svelte.ts/.svelte.js). If possible, this skill should be executed within the svelte-file-editor agent for optimal results.
 ---
 
 # Svelte 5 Code Writer

plugins/svelte/skills/svelte-code-writer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: svelte-code-writer
-description: CLI tools for Svelte 5 documentation lookup and code analysis. MUST be used whenever creating, editing or analyzing any Svelte component (.svelte) or Svelte module (.svelte.ts/.svelte.js). If possible, this skill should be executed within the svelte-file-editor agent for optimal results.
+description: CLI tools for Svelte 5 documentation lookup and code analysis. MUST be used whenever creating or editing any Svelte component (.svelte) or Svelte module (.svelte.ts/.svelte.js). If possible, this skill should be executed within the svelte-file-editor agent for optimal results.
 ---
 
 # Svelte 5 Code Writer