coursecode 0.1.31 → 0.1.33

package/framework/docs/FRAMEWORK_GUIDE.md

@@ -664,7 +664,7 @@ Runs **in Node.js** during build (via `vite.framework-dev.config.js` `closeBundl
 
 ### MCP `coursecode_lint` — Build-Time Only
 
-The MCP `coursecode_lint` tool runs the build linter (config validation, CSS class verification, structure checks). It does NOT include runtime errors. For runtime errors, contrast warnings, and other dynamic issues, use `coursecode_state` which returns `frameworkLogs` and `errors` from the preview server.
+The MCP `coursecode_lint` tool runs the build linter (config validation, CSS class verification, structure checks). It does NOT include runtime errors. For runtime errors and contrast warnings, use `coursecode_errors` (lightweight — just errors and console logs) or `coursecode_state` (full state snapshot including errors).
 
 ### Shared Rules (`lib/validation-rules.js`)
 
@@ -873,6 +873,7 @@ If the preview is not running, runtime tools fail fast with a clear error messag
 | Tool | Purpose | Returns |
 |------|---------|--------|
 | `coursecode_state` | Full course snapshot | `{slide, toc, interactions, engagement, lmsState, apiLog, errors, frameworkLogs, consoleLogs}` |
+| `coursecode_errors` | Errors + console logs only | `{errors, consoleLogs, count, clean}` — same error sources as `coursecode_state`, without the state payload |
 | `coursecode_navigate` | Go to slide by ID | `{slide, interactions, engagement, accessibility}` |
 | `coursecode_interact` | Set response + evaluate | `{interactionId, response}` → `{correct, score, feedback}` |
 | `coursecode_screenshot` | Visual capture (JPEG) | Optional `slideId` to navigate first, `fullPage` for scroll capture |

package/lib/mcp-prompts.js

@@ -34,6 +34,29 @@ Returns:
 - consoleLogs: browser console warnings/errors [{type, text, time}]
 
 Use this first to understand the course state before taking actions.
+For error checking only (after file edits), prefer coursecode_errors — same error sources, smaller payload.
+Requires preview server to be running.`,
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: []
+        },
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true
+        }
+    },
+    {
+        name: 'coursecode_errors',
+        description: `Get runtime errors and warnings from the live preview. Uses the same error sources as coursecode_state (preview server errors + browser console) but without the heavyweight state payload.
+
+Returns:
+- errors: [{type, message, hint?, isWarning?}] — preview server errors and warnings
+- consoleLogs: [{type, text, time}] — browser console warnings/errors
+- count: total number of errors + console logs
+- clean: true if no errors, warnings, or console issues
+
+Use after making file changes to check for breakage without the overhead of coursecode_state.
 Requires preview server to be running.`,
         inputSchema: {
             type: 'object',
@@ -406,8 +429,7 @@ Use to discover available icons before authoring slides or configuring menus.`,
             readOnlyHint: true,
             idempotentHint: true
         }
-    },
-
+    }
 ];
 
 // ========================================

package/lib/mcp-server.js

@@ -231,6 +231,30 @@ export async function startMcpServer(options = {}) {
                     }
                     break;
 
+                case 'coursecode_errors': {
+                    // Same error-gathering mechanism as coursecode_state,
+                    // but without the heavyweight state payload (TOC, interactions, etc.)
+                    await ensureHeadless(port);
+                    let errors = [];
+                    try {
+                        const errResp = await fetch(`http://localhost:${port}/__lms/errors`);
+                        if (errResp.ok) {
+                            const errData = await errResp.json();
+                            errors = [...(errData.errors || []), ...(errData.warnings || [])];
+                        }
+                    } catch {
+                        // Preview server unreachable — errors array stays empty
+                    }
+                    const consoleLogs = headless.getConsoleLogs();
+                    result = {
+                        errors,
+                        consoleLogs,
+                        count: errors.length + consoleLogs.length,
+                        clean: errors.length === 0 && consoleLogs.length === 0
+                    };
+                    break;
+                }
+
                 // === Workflow & build tools ===
                 case 'coursecode_workflow_status':
                     result = await getWorkflowStatusWithInstructions(port);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coursecode",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "description": "Multi-format course authoring framework with CLI tools (SCORM 2004, SCORM 1.2, cmi5, LTI 1.3)",
   "type": "module",
   "bin": {