fix: better error handling and code dedupe

Author: rodneyshibu

src/resources.ts

@@ -6,7 +6,9 @@ export async function fetchRawGithubContent(rawPath: string) {
 
   const response = await fetch(`https://raw.githubusercontent.com${path}`);
   if (!response.ok) {
-    throw new Error(`Failed to fetch GitHub content: ${response.status}`);
+    throw new Error(
+      `Failed to fetch GitHub content: ${response.status} ${response.statusText}`,
+    );
   }
   return response.text();
 }

src/tools/definitions.ts

@@ -924,12 +924,12 @@ export const NEON_TOOLS = [
     Loads comprehensive Neon documentation and usage guidelines from GitHub. This tool provides instructions for various Neon features and workflows.
     
     Use this tool when:
-    - User says "Get started with Neon" or similar onboarding phrases (with getStarted subject)
-    - User needs detailed guidance for initial Neon setup and configuration (with getStarted subject)
-    - You need comprehensive context about Neon workflows and best practices (with getStarted subject)
+    - User says "Get started with Neon" or similar onboarding phrases (with neon-get-started subject)
+    - User needs detailed guidance for initial Neon setup and configuration (with neon-get-started subject)
+    - You need comprehensive context about Neon workflows and best practices (with neon-get-started subject)
     
     Available subjects:
-    - getStarted: Comprehensive interactive guide covering organization/project setup, database configuration, connection strings, dependency installation, schema creation/migration, etc.
+    - neon-get-started: Comprehensive interactive guide covering organization/project setup, database configuration, connection strings, dependency installation, schema creation/migration, etc.
   </use_case>
 
   <important_notes>

src/tools/tools.ts

@@ -15,7 +15,7 @@ import { handleProvisionNeonAuth } from './handlers/neon-auth.js';
 import { handleSearch } from './handlers/search.js';
 import { handleFetch } from './handlers/fetch.js';
 import { getMigrationFromMemory, persistMigrationToMemory } from './state.js';
-import { fetchRawGithubContent } from '../resources.js';
+import { fetchRawGithubContent, NEON_RESOURCES } from '../resources.js';
 
 import {
   getDefaultDatabase,
@@ -1016,17 +1016,23 @@ async function handleListSharedProjects(
 }
 
 async function handleLoadResource({ subject }: { subject: string }) {
-  const resourceMap = {
-    getStarted: '/neondatabase-labs/ai-rules/blob/main/neon-get-started.mdc',
-  };
-
-  const path = resourceMap[subject as keyof typeof resourceMap];
-  if (!path) {
-    throw new InvalidArgumentError(`Unknown resource subject: ${subject}`);
+  const resource = NEON_RESOURCES.find((r) => r.name === subject);
+  if (!resource) {
+    throw new InvalidArgumentError(`Resource not found: ${subject}`);
   }
 
-  const content = await fetchRawGithubContent(path);
-  return content;
+  try {
+    const url = new URL(resource.uri);
+    const path = url.pathname;
+    const content = await fetchRawGithubContent(path);
+    return content;
+  } catch (error) {
+    const errorMessage =
+      error instanceof Error ? error.message : 'Unknown error';
+    throw new Error(
+      `Failed to load resource "${resource.name}": ${errorMessage}`,
+    );
+  }
 }
 
 async function handleCompareDatabaseSchema(

src/tools/toolsSchema.ts

@@ -361,8 +361,8 @@ export const fetchInputSchema = z.object({
 
 export const loadResourceInputSchema = z.object({
   subject: z
-    .enum(['getStarted'])
+    .enum(['neon-get-started'])
     .describe(
-      'The subject of the resource to load. Options: getStarted (Neon getting started guide).',
+      'The subject of the resource to load. Options: neon-get-started (Neon getting started guide).',
     ),
 });