@presto1314w/vite-devtools-browser 0.2.0 → 0.2.2

package/README.md

@@ -17,17 +17,23 @@ It ships in two forms:
 - Agent Skill: scenario-based debugging workflows for coding assistants
 - CLI Runtime (`@presto1314w/vite-devtools-browser`): structured shell commands for local Vite debugging
 
-Current documented baseline: `v0.2.0`.
+Current documented baseline: `v0.2.2`.
 
 ## What's New In v0.2
 
-`v0.2.0` moves `vite-browser` from snapshot-style inspection toward runtime diagnosis:
+`v0.2.x` moves `vite-browser` from snapshot-style inspection toward runtime diagnosis:
 
 - browser/runtime events are captured into a daemon-side event queue
 - `correlate errors` links the current error to recent HMR-updated modules
 - `diagnose hmr` turns runtime, trace, and error signals into structured findings
 - skills and CLI flows now route more directly to runtime triage instead of raw log inspection
 
+`v0.2.2` is the stabilization pass for this model:
+
+- tighter `diagnose hmr` wording around websocket evidence and runtime ambiguity
+- better test coverage for the four built-in diagnosis families
+- docs and release positioning aligned around the stable `v0.2.x` surface
+
 ## Built For Agents
 
 `vite-browser` is designed for agent workflows as much as local debugging.
@@ -195,7 +201,7 @@ vite-browser svelte tree
 
 ## Current Boundaries
 
-`vite-browser` v0.2 is strong at:
+`vite-browser` v0.2.2 is strong at:
 
 - surfacing runtime state as structured shell output
 - linking current errors to recent HMR/module activity

package/dist/diagnose.js

@@ -4,7 +4,9 @@ export function diagnoseHMR(input) {
         detectMissingModule(input),
         detectClosedWebsocket(input),
         detectRepeatedFullReload(input),
-    ].filter((result) => result !== null);
+    ]
+        .filter((result) => result !== null)
+        .sort(compareDiagnosisResults);
     if (results.length > 0)
         return results;
     return [
@@ -58,18 +60,23 @@ function detectMissingModule(input) {
     };
 }
 function detectClosedWebsocket(input) {
-    const runtimeClosed = /HMR Socket:\s*(closed|closing|unknown)/i.test(input.runtimeText);
+    const runtimeState = extractRuntimeSocketState(input.runtimeText);
+    const runtimeClosed = runtimeState === "closed" || runtimeState === "closing";
     const traceClosed = /disconnected|failed to connect|connection lost|ws closed/i.test(input.hmrTraceText);
     if (!runtimeClosed && !traceClosed)
         return null;
+    const runtimeOnly = runtimeClosed && !traceClosed;
+    const traceOnly = traceClosed && !runtimeClosed;
     return {
         code: "hmr-websocket-closed",
         status: "fail",
         confidence: runtimeClosed && traceClosed ? "high" : "medium",
         summary: "The HMR websocket is not healthy.",
-        detail: runtimeClosed
-            ? "Runtime status reports the HMR socket as closed, closing, or unknown."
-            : "HMR trace contains disconnect or websocket failure messages.",
+        detail: runtimeOnly
+            ? "Runtime status reports the HMR socket as closed or closing."
+            : traceOnly
+                ? "HMR trace contains disconnect or websocket failure messages."
+                : "Runtime status and HMR trace both indicate websocket instability.",
         suggestion: "Check the dev server is running, the page is connected to the correct origin, and no proxy/firewall is blocking the websocket.",
     };
 }
@@ -86,3 +93,19 @@ function detectRepeatedFullReload(input) {
         suggestion: "Check whether the changed module is outside HMR boundaries, introduces side effects, or triggers a circular dependency.",
     };
 }
+function extractRuntimeSocketState(runtimeText) {
+    const match = runtimeText.match(/HMR Socket:\s*(open|closed|closing|connecting|unknown)/i);
+    const state = match?.[1]?.toLowerCase();
+    if (state === "open" || state === "closed" || state === "closing" || state === "connecting") {
+        return state;
+    }
+    return "unknown";
+}
+function compareDiagnosisResults(a, b) {
+    return scoreDiagnosis(b) - scoreDiagnosis(a);
+}
+function scoreDiagnosis(result) {
+    const statusScore = result.status === "fail" ? 30 : result.status === "warn" ? 20 : 10;
+    const confidenceScore = result.confidence === "high" ? 3 : result.confidence === "medium" ? 2 : 1;
+    return statusScore + confidenceScore;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@presto1314w/vite-devtools-browser",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Runtime diagnostics CLI for Vite apps with event-stream correlation, HMR diagnosis, framework inspection, and mapped errors",
   "license": "MIT",
   "keywords": [