coursecode 0.1.25 → 0.1.26

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` — Unified Results
 
-The MCP `coursecode_lint` tool always runs the build linter. When the preview server is running and the headless browser is connected, it also merges runtime lint results (contrast, touch targets, spacing, layout) into the same response. Runtime-sourced items are tagged with `source: 'runtime'` and `rule: 'runtime-lint'`. The `runtimeLintIncluded` flag in the response indicates whether runtime checks were included. This gives AI agents a single, low-token-cost tool for all lint results without needing to pull the full course state via `coursecode_state`.
+The MCP `coursecode_lint` tool always runs the build linter. When the preview server is running and the headless browser is connected, it also merges runtime errors from the preview server's error log into the same response. These are the same errors shown in the debug panel's Errors tab and returned by `coursecode_state` — LMS API misuse, console errors, uncaught exceptions, and data limit warnings. Runtime-sourced items are tagged with `source: 'runtime'` and `rule: 'runtime-error'`. The `runtimeLintIncluded` flag in the response indicates whether runtime errors were included. This gives AI agents a single tool for both static lint and runtime errors without needing a separate `coursecode_state` call.
 
 ### Shared Rules (`lib/validation-rules.js`)
 

package/lib/mcp-prompts.js

@@ -308,13 +308,13 @@ Use to discover available interactions before creating assessments.`,
         name: 'coursecode_lint',
         description: `Run the course linter and get structured results.
 
-Always runs build-time lint (config, CSS classes, structure). When the preview server is running and the headless browser is connected, also includes runtime lint results (contrast, touch targets, spacing, layout).
+Always runs build-time lint (config, CSS classes, structure). When the preview server is running and the headless browser is connected, also includes runtime errors from the preview server (same errors shown in coursecode_state and the debug panel Errors tab).
 
 Returns:
 - errors: [{slideId?, rule, message, severity, source?, hint?}]
 - warnings: [{slideId?, rule, message, severity, source?, class?, suggestion?, hint?}]
 - passed: boolean
-- runtimeLintIncluded: boolean (true when runtime checks were included)
+- runtimeLintIncluded: boolean (true when runtime errors were included)
 
 Build-time rules (always checked):
 - undefined-css-class: hallucinated or stale class names (with fix suggestions)
@@ -325,11 +325,11 @@ Build-time rules (always checked):
 - assessment-id-mismatch: config ID doesn't match assessment ID
 - invalid-gating: bad gating condition configuration
 
-Runtime rules (included when preview is running, source='runtime'):
-- Contrast ratio violations
-- Touch target size violations
-- Spacing issues (missing gap, margin, padding)
-- Text proximity to borders, element overlap, styled lists
+Runtime errors (included when preview is running, source='runtime'):
+- LMS API misuse (GetValue before Initialize, SetValue after Terminate, etc.)
+- Console errors and warnings from the course
+- Uncaught exceptions and unhandled promise rejections
+- Suspend data size warnings
 
 Suppression: Add data-lint-ignore to any HTML element to suppress warnings for it and children.
   data-lint-ignore           — suppress all warnings

package/lib/mcp-server.js

@@ -247,12 +247,13 @@ export async function startMcpServer(options = {}) {
                     break;
                 case 'coursecode_lint':
                     result = await lintCourse();
-                    // Merge runtime lint errors if headless browser is already connected
+                    // Merge runtime errors if headless browser is already connected
                     if (headless.isRunning()) {
                         try {
                             const runtimeErrors = await headless.evaluateParent(() => {
                                 return window._stubPlayerState?.errorLog || [];
                             });
+                            result.runtimeLintIncluded = true;
                             if (runtimeErrors.length > 0) {
                                 const runtimeWarnings = runtimeErrors.filter(e => e.isWarning);
                                 const runtimeErrs = runtimeErrors.filter(e => !e.isWarning);
@@ -260,9 +261,10 @@ export async function startMcpServer(options = {}) {
                                     result.warnings = (result.warnings || []).concat(
                                         runtimeWarnings.map(e => ({
                                             severity: 'warning',
+                                            type: e.type,
                                             message: e.message,
                                             hint: e.hint,
-                                            rule: 'runtime-lint',
+                                            rule: 'runtime-error',
                                             source: 'runtime'
                                         }))
                                     );
@@ -272,16 +274,16 @@ export async function startMcpServer(options = {}) {
                                     result.errors = (result.errors || []).concat(
                                         runtimeErrs.map(e => ({
                                             severity: 'error',
+                                            type: e.type,
                                             message: e.message,
                                             hint: e.hint,
-                                            rule: 'runtime-lint',
+                                            rule: 'runtime-error',
                                             source: 'runtime'
                                         }))
                                     );
                                     result.errorCount = result.errors.length;
                                     result.passed = result.errors.length === 0;
                                 }
-                                result.runtimeLintIncluded = true;
                             }
                         } catch {
                             // Headless browser may have disconnected — non-fatal, build lint still valid

package/package.json

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