c64bridge 0.8.0 → 0.9.0

package/dist/tools/audio.js

@@ -397,9 +397,9 @@ export const audioModule = defineToolModule({
     domain: "audio",
     summary: "SID composition, playback, and audio analysis workflows.",
     resources: [
-        "c64://specs/sid",
-        "c64://specs/sidwave",
-        "c64://docs/sid/file-structure",
+        "c64://sound/sid/spec",
+        "c64://sound/sidwave/spec",
+        "c64://sound/sid/file-format",
     ],
     prompts: ["sid-music"],
     defaultTags: ["sid", "audio"],
@@ -411,7 +411,7 @@ export const audioModule = defineToolModule({
     tools: [
         {
             name: "sid_volume",
-            description: "Set the SID master volume register at $D418. See c64://specs/sid.",
+            description: "Set the SID master volume register at $D418. See c64://sound/sid/spec.",
             summary: "Clamps the requested volume and writes it to the SID master volume register.",
             inputSchema: sidVolumeArgsSchema.jsonSchema,
             tags: ["sid", "control"],
@@ -496,7 +496,7 @@ export const audioModule = defineToolModule({
         },
         {
             name: "sid_note_on",
-            description: "Trigger a SID voice with configurable waveform, pulse width, and ADSR envelope. See c64://specs/sid.",
+            description: "Trigger a SID voice with configurable waveform, pulse width, and ADSR envelope. See c64://sound/sid/spec.",
             summary: "Resolves note or frequency, clamps parameters, and writes the SID voice registers.",
             inputSchema: sidNoteOnArgsSchema.jsonSchema,
             tags: ["sid", "control", "music", "pal-ntsc"],
@@ -700,7 +700,7 @@ export const audioModule = defineToolModule({
             description: "Play a SID file stored on the Ultimate filesystem via the firmware player.",
             summary: "Instructs the SID player to load the given file and optional song number.",
             inputSchema: sidplayFileArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/sid"],
+            relatedResources: ["c64://sound/sid/spec"],
             tags: ["sid", "playback"],
             prerequisites: ["drives_list"],
             examples: [
@@ -740,7 +740,7 @@ export const audioModule = defineToolModule({
             description: "Play a MOD tracker module stored on the Ultimate filesystem.",
             summary: "Sends the module to the Ultimate SID player and starts playback.",
             inputSchema: modplayFileArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/sid"],
+            relatedResources: ["c64://sound/sid/spec"],
             tags: ["sid", "playback"],
             prerequisites: ["drives_list"],
             examples: [
@@ -780,7 +780,7 @@ export const audioModule = defineToolModule({
             summary: "Builds a note timeline from semitone offsets and triggers SID playback asynchronously.",
             lifecycle: "fire-and-forget",
             inputSchema: musicGenerateArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/sid"],
+            relatedResources: ["c64://sound/sid/spec"],
             relatedPrompts: ["sid-music"],
             tags: ["sid", "music", "generator", "pal-ntsc"],
             prerequisites: ["sid_volume"],
@@ -862,7 +862,7 @@ export const audioModule = defineToolModule({
             description: "Compile a SIDWAVE composition to PRG or SID and optionally play it immediately.",
             summary: "Parses SIDWAVE/CPG input, compiles to a PRG, and plays via PRG or SID attachment.",
             inputSchema: musicCompileArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/sid", "c64://specs/sidwave", "c64://docs/sid/file-structure"],
+            relatedResources: ["c64://sound/sid/spec", "c64://sound/sidwave/spec", "c64://sound/sid/file-format"],
             relatedPrompts: ["sid-music"],
             tags: ["sid", "music", "compiler"],
             prerequisites: [],
@@ -945,7 +945,7 @@ export const audioModule = defineToolModule({
             description: "Record audio from the default input device and analyze SID playback characteristics.",
             summary: "Captures PCM data, extracts notes, tempo, and deviation metrics for SID verification workflows.",
             inputSchema: recordAndAnalyzeArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/sid", "c64://docs/sid/file-structure"],
+            relatedResources: ["c64://sound/sid/spec", "c64://sound/sid/file-format"],
             relatedPrompts: ["sid-music"],
             tags: ["sid", "analysis"],
             prerequisites: [],
@@ -985,7 +985,7 @@ export const audioModule = defineToolModule({
             description: "Automatically analyze SID playback when the user requests verification feedback.",
             summary: "Detects verification intent in natural language, records a short clip, and returns musical feedback.",
             inputSchema: analyzeAudioArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/sid", "c64://docs/sid/file-structure"],
+            relatedResources: ["c64://sound/sid/spec", "c64://sound/sid/file-format"],
             relatedPrompts: ["sid-music"],
             tags: ["sid", "analysis"],
             prerequisites: [],

package/dist/tools/debug.js

@@ -350,7 +350,7 @@ const debugOperationDispatcher = createOperationDispatcher("c64_debug", debugOpe
 export const debugModuleGroup = defineToolModule({
     domain: "debug",
     summary: "VICE Binary Monitor debugger operations (breakpoints, registers, stepping).",
-    resources: ["c64://specs/assembly", "c64://specs/memory-map"],
+    resources: ["c64://assembly/6510-spec", "c64://memory/map"],
     prompts: ["assembly-program", "memory-debug"],
     defaultTags: ["debug", "vice"],
     workflowHints: [

package/dist/tools/developer.js

@@ -123,8 +123,8 @@ export const developerModule = defineToolModule({
     domain: "developer",
     summary: "Configuration management, diagnostics, and helper utilities for advanced workflows.",
     resources: [
-        "c64://context/bootstrap",
-        "c64://docs/index",
+        "c64://guide/bootstrap",
+        "c64://guide/index",
     ],
     prompts: ["memory-debug"],
     defaultTags: ["developer", "config", "debug"],
@@ -138,7 +138,7 @@ export const developerModule = defineToolModule({
             description: "List configuration categories available on the Ultimate firmware.",
             summary: "Fetches the configuration tree and returns firmware-reported categories.",
             inputSchema: noArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["config", "list"],
             examples: [
                 { name: "List configs", description: "Enumerate configuration categories", arguments: {} },
@@ -173,7 +173,7 @@ export const developerModule = defineToolModule({
             description: "Read a configuration category or specific item.",
             summary: "Returns firmware configuration data for the selected category (and item).",
             inputSchema: configGetArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["config", "read"],
             examples: [
                 { name: "Get audio config", description: "Read audio category", arguments: { category: "Audio" } },
@@ -210,7 +210,7 @@ export const developerModule = defineToolModule({
             description: "Set a configuration value within a category.",
             summary: "Writes a primitive value to a specific configuration item via firmware APIs.",
             inputSchema: configSetArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["config", "write"],
             examples: [
                 { name: "Set volume", description: "Adjust audio volume", arguments: { category: "Audio", item: "Volume", value: 75 } },
@@ -254,7 +254,7 @@ export const developerModule = defineToolModule({
             description: "Apply multiple configuration changes in a single request.",
             summary: "Sends a nested object of category/item values to the firmware batch endpoint.",
             inputSchema: configBatchSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["config", "write"],
             examples: [
                 { name: "Batch update", description: "Update multiple settings", arguments: { Audio: { Volume: 80, DACMode: "stereo" } } },
@@ -298,7 +298,7 @@ export const developerModule = defineToolModule({
             description: "Load configuration settings from flash storage.",
             summary: "Restores the firmware configuration by reading the persisted flash snapshot.",
             inputSchema: noArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["config", "flash"],
             examples: [
                 { name: "Load from flash", description: "Restore saved configuration", arguments: {} },
@@ -334,7 +334,7 @@ export const developerModule = defineToolModule({
             description: "Persist current configuration settings to flash storage.",
             summary: "Saves the active configuration snapshot so it survives power cycles.",
             inputSchema: noArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["config", "flash"],
             examples: [
                 { name: "Save to flash", description: "Persist current config", arguments: {} },
@@ -370,7 +370,7 @@ export const developerModule = defineToolModule({
             description: "Reset configuration categories to their factory defaults.",
             summary: "Instructs the firmware to discard overrides and restore default configuration values.",
             inputSchema: noArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["config", "reset"],
             examples: [
                 { name: "Reset config", description: "Restore factory defaults", arguments: {} },
@@ -407,7 +407,7 @@ export const developerModule = defineToolModule({
             summary: "Calls the firmware version endpoint (Ultimate) or returns emulator info (VICE).",
             supportedPlatforms: ["c64u", "vice"],
             inputSchema: noArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["diagnostics", "version"],
             examples: [
                 { name: "Get version", description: "Check firmware version", arguments: {} },
@@ -439,7 +439,7 @@ export const developerModule = defineToolModule({
             summary: "Returns the diagnostics payload reported by the firmware (Ultimate) or emulator (VICE).",
             supportedPlatforms: ["c64u", "vice"],
             inputSchema: noArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["diagnostics", "info"],
             examples: [
                 { name: "Get hardware info", description: "Query hardware status", arguments: {} },
@@ -470,7 +470,7 @@ export const developerModule = defineToolModule({
             description: "Read the Ultimate debug register ($D7FF).",
             summary: "Returns the current hex value stored in the debug register.",
             inputSchema: noArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["debug"],
             examples: [
                 { name: "Read debug register", description: "Check $D7FF value", arguments: {} },
@@ -509,7 +509,7 @@ export const developerModule = defineToolModule({
             description: "Write a value into the Ultimate debug register ($D7FF).",
             summary: "Validates the hex input and forwards it to the firmware.",
             inputSchema: debugWriteArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["debug"],
             examples: [
                 { name: "Write debug register", description: "Set $D7FF to $42", arguments: { value: "42" } },

package/dist/tools/graphics.js

@@ -546,9 +546,9 @@ export const graphicsModule = defineToolModule({
     domain: "graphics",
     summary: "PETSCII art, sprite workflows, and VIC-II graphics helpers.",
     resources: [
-        "c64://specs/vic",
-        "c64://specs/assembly",
-        "c64://specs/basic",
+        "c64://graphics/vic/spec",
+        "c64://assembly/6510-spec",
+        "c64://basic/spec",
     ],
     prompts: ["graphics-demo", "basic-program", "assembly-program"],
     defaultTags: ["graphics", "vic"],
@@ -559,10 +559,10 @@ export const graphicsModule = defineToolModule({
     tools: [
         {
             name: "render_sprite",
-            description: "Display supplied 63-byte sprite data at the requested position and colour by writing memory and patching VIC-II registers directly. See c64://specs/vic for registers.",
+            description: "Display supplied 63-byte sprite data at the requested position and colour by writing memory and patching VIC-II registers directly. See c64://graphics/vic/spec for registers.",
             summary: "Writes sprite data into RAM, updates the sprite pointer table, and patches VIC-II registers to render a sprite preview.",
             inputSchema: spriteArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/vic"],
+            relatedResources: ["c64://graphics/vic/spec"],
             relatedPrompts: ["graphics-demo", "assembly-program"],
             tags: ["sprite", "assembly", "pal-ntsc"],
             prerequisites: ["upload_run_asm"],
@@ -587,7 +587,7 @@ export const graphicsModule = defineToolModule({
             description: "Import an image file, convert it to a VIC-II bitmap, write it into RAM, and display it.",
             summary: "Decodes a source image, quantizes it into C64 colours, writes bitmap/screen/color RAM, and displays it in hires or multicolor bitmap mode.",
             inputSchema: generateBitmapArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/vic", "c64://context/bootstrap"],
+            relatedResources: ["c64://graphics/vic/spec", "c64://guide/bootstrap"],
             relatedPrompts: ["graphics-demo"],
             tags: ["bitmap", "vic", "image"],
             workflowHints: [
@@ -601,10 +601,10 @@ export const graphicsModule = defineToolModule({
         },
         {
             name: "render_petscii_text",
-            description: "Display PETSCII text with optional border and background colours. See c64://specs/basic.",
+            description: "Display PETSCII text with optional border and background colours. See c64://basic/spec.",
             summary: "Generates a BASIC program that clears the screen, sets colours, and prints text.",
             inputSchema: renderPetsciiScreenArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/basic", "c64://context/bootstrap"],
+            relatedResources: ["c64://basic/spec", "c64://guide/bootstrap"],
             relatedPrompts: ["basic-program", "graphics-demo"],
             tags: ["basic", "screen"],
             prerequisites: ["upload_run_basic"],
@@ -626,10 +626,10 @@ export const graphicsModule = defineToolModule({
         },
         {
             name: "render_petscii_art",
-            description: "Create PETSCII art from prompts, text, or bitmap input, and optionally display it on the C64. Returns metadata including PETSCII codes and glyphs. See c64://specs/basic, c64://specs/vic, and c64://specs/charset.",
+            description: "Create PETSCII art from prompts, text, or bitmap input, and optionally display it on the C64. Returns metadata including PETSCII codes and glyphs. See c64://basic/spec, c64://graphics/vic/spec, and c64://graphics/character-set.",
             summary: "Synthesises PETSCII art, generates a BASIC program with preview metadata (petsciiCodes, glyphs, dimensions), and uploads it unless dry-run is requested.",
             inputSchema: petsciiImageArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/basic", "c64://specs/vic", "c64://specs/charset"],
+            relatedResources: ["c64://basic/spec", "c64://graphics/vic/spec", "c64://graphics/character-set"],
             relatedPrompts: ["graphics-demo", "basic-program"],
             tags: ["petscii", "basic", "pal-ntsc"],
             prerequisites: ["upload_run_basic"],

package/dist/tools/machineControl.js

@@ -33,7 +33,7 @@ const menuButtonArgsSchema = createNoArgsSchema("No arguments required to toggle
 export const machineControlModule = defineToolModule({
     domain: "machine",
     summary: "Power, reset, pause/resume, and diagnostic controls for the C64 and Ultimate hardware.",
-    resources: ["c64://context/bootstrap"],
+    resources: ["c64://guide/bootstrap"],
     prompts: ["memory-debug"],
     defaultTags: ["machine", "control"],
     workflowHints: [
@@ -43,7 +43,7 @@ export const machineControlModule = defineToolModule({
     tools: [
         {
             name: "reset_c64",
-            description: "Reset the C64 via Ultimate firmware. Review c64://context/bootstrap safety rules.",
+            description: "Reset the C64 via Ultimate firmware. Review c64://guide/bootstrap safety rules.",
             summary: "Issues a soft reset, equivalent to power cycling without cutting power.",
             inputSchema: resetArgsSchema.jsonSchema,
             tags: ["reset"],
@@ -81,7 +81,7 @@ export const machineControlModule = defineToolModule({
         },
         {
             name: "reboot_c64",
-            description: "Reboot the Ultimate firmware and C64. See c64://context/bootstrap.",
+            description: "Reboot the Ultimate firmware and C64. See c64://guide/bootstrap.",
             summary: "Triggers a firmware reboot, useful after configuration changes.",
             inputSchema: rebootArgsSchema.jsonSchema,
             tags: ["reboot"],
@@ -119,7 +119,7 @@ export const machineControlModule = defineToolModule({
         },
         {
             name: "pause",
-            description: "Pause the machine on Ultimate hardware. See memory safety checklist in c64://context/bootstrap.",
+            description: "Pause the machine on Ultimate hardware. See memory safety checklist in c64://guide/bootstrap.",
             summary: "Suspends CPU execution on Ultimate hardware until resumed.",
             inputSchema: pauseArgsSchema.jsonSchema,
             tags: ["pause"],
@@ -195,7 +195,7 @@ export const machineControlModule = defineToolModule({
         },
         {
             name: "poweroff",
-            description: "Power off the machine via Ultimate firmware. See safety notes in c64://context/bootstrap.",
+            description: "Power off the machine via Ultimate firmware. See safety notes in c64://guide/bootstrap.",
             summary: "Attempts a controlled shutdown through the Ultimate control interface.",
             inputSchema: poweroffArgsSchema.jsonSchema,
             tags: ["power"],

package/dist/tools/memory.js

@@ -171,13 +171,21 @@ async function executeReadMemory(rawArgs, ctx) {
         const detailRecord = toRecord(result.details) ?? {};
         const resolvedAddress = resolveAddressLabel(detailRecord, parsed.address);
         const resolvedLength = resolveLength(detailRecord) ?? parsed.length;
-        return textResult(`Read ${resolvedLength} bytes starting at ${resolvedAddress}.`, {
+        const data = {
             success: true,
             address: resolvedAddress,
             length: resolvedLength,
             hexData: result.data ?? null,
             details: detailRecord,
-        });
+        };
+        const base = textResult(`Read ${resolvedLength} bytes starting at ${resolvedAddress}.`, data);
+        return {
+            ...base,
+            structuredContent: {
+                type: "json",
+                data,
+            },
+        };
     }
     catch (error) {
         if (error instanceof ToolError) {
@@ -354,9 +362,9 @@ export const memoryModule = defineToolModule({
     summary: "Screen, main memory, and low-level inspection utilities.",
     supportedPlatforms: ["c64u", "vice"],
     resources: [
-        "c64://context/bootstrap",
-        "c64://specs/basic",
-        "c64://specs/assembly",
+        "c64://guide/bootstrap",
+        "c64://basic/spec",
+        "c64://assembly/6510-spec",
     ],
     prompts: ["memory-debug", "basic-program", "assembly-program"],
     defaultTags: ["memory", "debug"],
@@ -367,10 +375,10 @@ export const memoryModule = defineToolModule({
     tools: [
         {
             name: "read_screen",
-            description: "Read the current text screen (40x25) and return its ASCII representation. For PETSCII details, see c64://specs/basic.",
+            description: "Read the current text screen (40x25) and return its ASCII representation. For PETSCII details, see c64://basic/spec.",
             summary: "Fetches screen RAM, converts from PETSCII, and returns the printable output.",
             inputSchema: readScreenArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap", "c64://specs/basic"],
+            relatedResources: ["c64://guide/bootstrap", "c64://basic/spec"],
             relatedPrompts: ["memory-debug", "basic-program", "assembly-program"],
             tags: ["screen", "memory"],
             prerequisites: [],
@@ -390,10 +398,10 @@ export const memoryModule = defineToolModule({
         },
         {
             name: "read",
-            description: "Read a range of bytes from main memory and return the data as hexadecimal. Consult c64://specs/assembly and docs index.",
+            description: "Read a range of bytes from main memory and return the data as hexadecimal. Consult c64://assembly/6510-spec and docs index.",
             summary: "Resolves symbols, reads memory, and returns a hex dump with addressing metadata.",
             inputSchema: readMemoryArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap", "c64://specs/assembly", "c64://docs/index"],
+            relatedResources: ["c64://guide/bootstrap", "c64://assembly/6510-spec", "c64://guide/index"],
             relatedPrompts: ["memory-debug", "assembly-program"],
             tags: ["memory", "hex"],
             prerequisites: [],
@@ -414,10 +422,10 @@ export const memoryModule = defineToolModule({
         },
         {
             name: "write",
-            description: "Write a hexadecimal byte sequence into main memory at the specified address. See c64://context/bootstrap for safety rules.",
+            description: "Write a hexadecimal byte sequence into main memory at the specified address. See c64://guide/bootstrap for safety rules.",
             summary: "Resolves symbols, validates hex data, and writes bytes to RAM.",
             inputSchema: writeMemoryArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap", "c64://specs/assembly", "c64://docs/index"],
+            relatedResources: ["c64://guide/bootstrap", "c64://assembly/6510-spec", "c64://guide/index"],
             relatedPrompts: ["memory-debug", "assembly-program"],
             tags: ["memory", "hex", "write"],
             prerequisites: ["read"],

package/dist/tools/meta/index.js

@@ -28,7 +28,7 @@ const allTools = [
 export const metaModule = defineToolModule({
     domain: "meta",
     summary: "High-level meta tools that orchestrate multiple MCP actions.",
-    resources: ["c64://context/bootstrap", "c64://specs/assembly"],
+    resources: ["c64://guide/bootstrap", "c64://assembly/6510-spec"],
     defaultTags: ["meta", "orchestration", "experimental"],
     supportedPlatforms: ["c64u", "vice"],
     workflowHints: [

package/dist/tools/printer.js

@@ -227,13 +227,12 @@ export const printerModule = defineToolModule({
     domain: "printer",
     summary: "Printer workflow helpers for Commodore MPS and Epson FX devices, including prompt templates.",
     resources: [
-        "c64://specs/printer",
-        "c64://docs/printer/guide",
-        "c64://docs/printer/commodore-text",
-        "c64://docs/printer/commodore-bitmap",
-        "c64://docs/printer/epson-text",
-        "c64://docs/printer/epson-bitmap",
-        "c64://docs/printer/prompts",
+        "c64://printer/spec",
+        "c64://printer/commodore/text",
+        "c64://printer/commodore/bitmap",
+        "c64://printer/epson/text",
+        "c64://printer/epson/bitmap",
+        "c64://printer/prompt-guide",
     ],
     prompts: ["printer-job"],
     defaultTags: ["printer"],
@@ -244,10 +243,10 @@ export const printerModule = defineToolModule({
     tools: [
         {
             name: "print_text",
-            description: "Print text on device 4 using Commodore or Epson workflows. See c64://docs/printer/guide.",
+            description: "Print text on device 4 using Commodore or Epson workflows. See c64://printer/spec.",
             summary: "Generates printer BASIC, opens device 4, prints text, and optionally emits a form feed.",
             inputSchema: printTextArgsSchema.jsonSchema,
-            relatedResources: ["c64://docs/printer/guide", "c64://specs/printer"],
+            relatedResources: ["c64://printer/spec"],
             relatedPrompts: ["printer-job"],
             tags: ["text"],
             prerequisites: ["upload_run_basic"],
@@ -304,7 +303,7 @@ export const printerModule = defineToolModule({
             description: "Print a Commodore MPS bit-image row using BIM BASIC helpers.",
             summary: "Generates BASIC that emits Commodore BIM commands for the provided bitmap columns.",
             inputSchema: commodoreBitmapArgsSchema.jsonSchema,
-            relatedResources: ["c64://docs/printer/commodore-bitmap"],
+            relatedResources: ["c64://printer/commodore/bitmap"],
             relatedPrompts: ["printer-job"],
             tags: ["bitmap", "commodore"],
             prerequisites: ["upload_run_basic"],
@@ -364,7 +363,7 @@ export const printerModule = defineToolModule({
             description: "Print an Epson FX bit-image row using ESC/P commands.",
             summary: "Generates BASIC that emits ESC/P graphics commands for Epson printers.",
             inputSchema: epsonBitmapArgsSchema.jsonSchema,
-            relatedResources: ["c64://docs/printer/epson-bitmap"],
+            relatedResources: ["c64://printer/epson/bitmap"],
             relatedPrompts: ["printer-job"],
             tags: ["bitmap", "epson"],
             prerequisites: ["upload_run_basic"],
@@ -425,7 +424,7 @@ export const printerModule = defineToolModule({
             description: "Define custom characters on Commodore MPS printers using DLL mode.",
             summary: "Uploads custom glyph data (11 columns each) for device 4 DLL mode.",
             inputSchema: commodoreDllArgsSchema.jsonSchema,
-            relatedResources: ["c64://docs/printer/commodore-bitmap"],
+            relatedResources: ["c64://printer/commodore/bitmap"],
             relatedPrompts: ["printer-job"],
             tags: ["dll", "commodore"],
             prerequisites: ["upload_run_basic"],

package/dist/tools/programRunners.js

@@ -394,7 +394,7 @@ async function executeUploadRunBasic(rawArgs, ctx) {
             format: "prg",
             entryAddress,
             prgSize: prg.length,
-            resources: ["c64://specs/basic", "c64://context/bootstrap"],
+            resources: ["c64://basic/spec", "c64://guide/bootstrap"],
             ...(screenOutput ? { screen: screenOutput } : {}),
             ...(autoFixInfo
                 ? {
@@ -460,7 +460,7 @@ async function executeUploadRunAsm(rawArgs, ctx) {
             format: "prg",
             entryAddress,
             prgSize: prg.length,
-            resources: ["c64://specs/assembly", "c64://context/bootstrap"],
+            resources: ["c64://assembly/6510-spec", "c64://guide/bootstrap"],
             ...(shouldVerify && verified ? { verified: true } : {}),
         };
         const base = textResult("Assembly program assembled, uploaded, and executed successfully.", {
@@ -506,7 +506,7 @@ async function executeLoadPrg(rawArgs, ctx) {
             format: "prg",
             path: parsed.path,
             entryAddress: null,
-            resources: ["c64://context/bootstrap"],
+            resources: ["c64://guide/bootstrap"],
         };
         const base = textResult(`PRG ${parsed.path} loaded into memory.`, {
             success: true,
@@ -538,7 +538,7 @@ async function executeRunPrg(rawArgs, ctx) {
             format: "prg",
             path: parsed.path,
             entryAddress: null,
-            resources: ["c64://context/bootstrap"],
+            resources: ["c64://guide/bootstrap"],
         };
         const base = textResult(`PRG ${parsed.path} loaded and executed.`, {
             success: true,
@@ -570,7 +570,7 @@ async function executeRunCrt(rawArgs, ctx) {
             format: "crt",
             path: parsed.path,
             entryAddress: null,
-            resources: ["c64://context/bootstrap"],
+            resources: ["c64://guide/bootstrap"],
         };
         const base = textResult(`PRG ${parsed.path} loaded and executed.`, {
             success: true,
@@ -598,9 +598,9 @@ export const programRunnersModule = defineToolModule({
     domain: "programs",
     summary: "Program uploaders, runners, and compilation workflows for BASIC, assembly, and PRG files.",
     resources: [
-        "c64://context/bootstrap",
-        "c64://specs/basic",
-        "c64://specs/assembly",
+        "c64://guide/bootstrap",
+        "c64://basic/spec",
+        "c64://assembly/6510-spec",
     ],
     prompts: ["basic-program", "assembly-program"],
     defaultTags: ["programs", "execution"],
@@ -611,10 +611,10 @@ export const programRunnersModule = defineToolModule({
     tools: [
         {
             name: "upload_run_basic",
-            description: "Upload a BASIC program to the C64 and execute it immediately. Refer to c64://specs/basic for syntax and device I/O.",
+            description: "Upload a BASIC program to the C64 and execute it immediately. Refer to c64://basic/spec for syntax and device I/O.",
             summary: "Uploads Commodore BASIC v2 source and runs it via Ultimate 64 firmware.",
             inputSchema: uploadBasicArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/basic", "c64://docs/basic/pitfalls", "c64://context/bootstrap"],
+            relatedResources: ["c64://basic/spec", "c64://basic/pitfalls", "c64://guide/bootstrap"],
             relatedPrompts: ["basic-program"],
             tags: ["basic", "execution"],
             prerequisites: ["read_screen"],
@@ -636,10 +636,10 @@ export const programRunnersModule = defineToolModule({
         },
         {
             name: "upload_run_asm",
-            description: "Assemble 6502/6510 source code, upload the PRG, and run it immediately. See c64://specs/assembly.",
+            description: "Assemble 6502/6510 source code, upload the PRG, and run it immediately. See c64://assembly/6510-spec.",
             summary: "Compiles assembly to a PRG and executes it on the C64 via Ultimate 64 firmware.",
             inputSchema: uploadAsmArgsSchema.jsonSchema,
-            relatedResources: ["c64://specs/assembly", "c64://context/bootstrap"],
+            relatedResources: ["c64://assembly/6510-spec", "c64://guide/bootstrap"],
             relatedPrompts: ["assembly-program"],
             tags: ["assembly", "execution"],
             prerequisites: ["read_screen"],
@@ -664,7 +664,7 @@ export const programRunnersModule = defineToolModule({
             description: "Load a PRG into C64 memory without executing it.",
             summary: "Instructs the Ultimate firmware to transfer a PRG into memory without RUN.",
             inputSchema: prgFileArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["programs", "file"],
             prerequisites: ["drives_list"],
             examples: [
@@ -688,7 +688,7 @@ export const programRunnersModule = defineToolModule({
             description: "Run a PRG located on the Ultimate filesystem without uploading source.",
             summary: "Loads and executes a PRG file residing on attached storage.",
             inputSchema: prgFileArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["programs", "execution", "file"],
             workflowHints: [
                 "Call when the user provides a PRG path and expects immediate execution without compiling.",
@@ -712,7 +712,7 @@ export const programRunnersModule = defineToolModule({
             description: "Run a cartridge image stored on the Ultimate filesystem.",
             summary: "Mounts and autostarts the specified CRT file through the firmware.",
             inputSchema: crtFileArgsSchema.jsonSchema,
-            relatedResources: ["c64://context/bootstrap"],
+            relatedResources: ["c64://guide/bootstrap"],
             tags: ["programs", "cartridge"],
             workflowHints: [
                 "Use for cartridge images and remind the user that the machine will reset into the CRT.",
@@ -742,7 +742,7 @@ export const programRunnersModule = defineToolModule({
                         format: "crt",
                         path: parsed.path,
                         entryAddress: null,
-                        resources: ["c64://context/bootstrap"],
+                        resources: ["c64://guide/bootstrap"],
                     };
                     const base = textResult(`CRT ${parsed.path} mounted and started.`, {
                         success: true,

package/dist/tools/rag.js

@@ -23,18 +23,18 @@ const ragRetrieveArgsSchema = objectSchema({
 });
 function createRagTool(language, options) {
     const primaryResourceUris = language === "basic"
-        ? ["c64://specs/basic", "c64://context/bootstrap"]
-        : ["c64://specs/assembly", "c64://context/bootstrap"];
+        ? ["c64://basic/spec", "c64://guide/bootstrap"]
+        : ["c64://assembly/6510-spec", "c64://guide/bootstrap"];
     return {
         name: language === "basic" ? "rag_retrieve_basic" : "rag_retrieve_asm",
         description: language === "basic"
-            ? "Retrieve BASIC references from local knowledge. See c64://specs/basic before coding."
-            : "Retrieve 6502/6510 assembly references from local knowledge. See c64://specs/assembly.",
+            ? "Retrieve BASIC references from local knowledge. See c64://basic/spec before coding."
+            : "Retrieve 6502/6510 assembly references from local knowledge. See c64://assembly/6510-spec.",
         summary: options.summary,
         inputSchema: ragRetrieveArgsSchema.jsonSchema,
         relatedResources: language === "basic"
-            ? ["c64://specs/basic"]
-            : ["c64://specs/assembly"],
+            ? ["c64://basic/spec"]
+            : ["c64://assembly/6510-spec"],
         relatedPrompts: language === "basic"
             ? ["basic-program"]
             : ["assembly-program"],
@@ -175,9 +175,9 @@ export const ragModule = defineToolModule({
     domain: "rag",
     summary: "Retrieval-augmented generation helpers for BASIC and assembly examples.",
     resources: [
-        "c64://specs/basic",
-        "c64://specs/assembly",
-        "c64://docs/index",
+        "c64://basic/spec",
+        "c64://assembly/6510-spec",
+        "c64://guide/index",
     ],
     prompts: ["basic-program", "assembly-program"],
     defaultTags: ["rag", "search"],

package/dist/tools/registry/config.js

@@ -151,7 +151,7 @@ const configOperationHandlers = createOperationHandlers(configOperations);
 export const configModuleGroup = defineToolModule({
     domain: "config",
     summary: "Grouped configuration management, diagnostics, and snapshot workflows.",
-    resources: ["c64://context/bootstrap", "c64://docs/index"],
+    resources: ["c64://guide/bootstrap", "c64://guide/index"],
     prompts: ["memory-debug"],
     defaultTags: ["config", "diagnostics"],
     supportedPlatforms: ["c64u", "vice"],