truecourse 0.6.9 → 0.6.10

package/README.md

@@ -28,12 +28,24 @@ Both store their results under `.truecourse/` and surface them in a shared [dash
   <img src="assets/demo.gif" alt="TrueCourse Screenshot" width="100%" />
 </p>
 
-Jump to: **[1. Analyze](#1-analyze--code-intelligence)** · **[2. Spec → Verify](#2-spec--verify--business-logic-drift)** · **[Dashboard](#dashboard-web-ui)**
+Jump to: **[Install](#install)** · **[1. Analyze](#1-analyze--code-intelligence)** · **[2. Spec → Verify](#2-spec--verify--business-logic-drift)** · **[Dashboard](#dashboard-web-ui)**
 
 No setup step and no database: TrueCourse creates `.truecourse/` in your repo on first use and stores everything there as plain JSON files. It uses the [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) for LLM-powered work — if `claude` isn't on your PATH, deterministic analysis still runs and LLM-dependent features are skipped.
 
 ---
 
+# Install
+
+```bash
+npm install -g truecourse
+```
+
+This puts the `truecourse` command on your PATH — every example below uses it. Prefer not to install globally? Run any command one-off with `npx truecourse <command>` instead.
+
+See [Prerequisites](#prerequisites) for Node, Claude Code, and C# requirements.
+
+---
+
 # 1. Analyze — code intelligence
 
 Static + LLM analysis of your code: architecture, security, bugs, performance, and more.
@@ -42,8 +54,8 @@ Static + LLM analysis of your code: architecture, security, bugs, performance, a
 
 ```bash
 cd <your-repo>
-npx truecourse analyze      # Runs the full analysis in-process
-npx truecourse list         # Show the violations it found
+truecourse analyze          # Runs the full analysis in-process
+truecourse list             # Show the violations it found
 ```
 
 The first analyze creates `.truecourse/` and stores results as plain JSON. View them visually with [`truecourse dashboard`](#dashboard-web-ui).

package/cli.mjs

@@ -26795,12 +26795,9 @@ var init_lsp_client = __esm({
         this.process.stdout.on("data", (chunk) => this.onData(chunk));
         this.process.stderr.on("data", (chunk) => {
         });
-        this.process.on("error", (err) => {
-          for (const pending of this.pendingRequests.values()) {
-            pending.reject(err);
-          }
-          this.pendingRequests.clear();
-        });
+        this.process.on("error", (err) => this.rejectAllPending(err));
+        this.process.stdin.on("error", (err) => this.rejectAllPending(new Error(`${this.config.name} LSP stdin error: ${err.message}`)));
+        this.process.on("exit", (code, signal) => this.rejectAllPending(new Error(`${this.config.name} LSP server exited (${signal ?? `code ${code}`}) before responding`)));
         const initResult = await this.sendRequest("initialize", {
           processId: process.pid,
           capabilities: {
@@ -26979,17 +26976,33 @@ var init_lsp_client = __esm({
       // -------------------------------------------------------------------------
       // Internal: JSON-RPC transport
       // -------------------------------------------------------------------------
+      /** Reject and clear every in-flight request — used when the server dies. */
+      rejectAllPending(err) {
+        if (this.pendingRequests.size === 0)
+          return;
+        for (const pending of this.pendingRequests.values())
+          pending.reject(err);
+        this.pendingRequests.clear();
+      }
       sendRequest(method, params) {
         return new Promise((resolve12, reject) => {
           const id = ++this.requestId;
           this.pendingRequests.set(id, { resolve: resolve12, reject });
           const msg = { jsonrpc: "2.0", id, method, params };
-          this.process.stdin.write(encodeMessage(msg));
+          try {
+            this.process.stdin.write(encodeMessage(msg));
+          } catch (err) {
+            this.pendingRequests.delete(id);
+            reject(err instanceof Error ? err : new Error(String(err)));
+          }
         });
       }
       sendNotification(method, params) {
         const msg = { jsonrpc: "2.0", method, params };
-        this.process.stdin.write(encodeMessage(msg));
+        try {
+          this.process.stdin.write(encodeMessage(msg));
+        } catch {
+        }
       }
       onData(chunk) {
         this.buffer = Buffer.concat([this.buffer, chunk]);
@@ -144749,6 +144762,7 @@ var init_pyproject_checker = __esm({
 // packages/analyzer/dist/roslyn-host-client.js
 import { spawn as spawn4 } from "child_process";
 import { existsSync as existsSync10 } from "fs";
+import { tmpdir } from "os";
 import { dirname as dirname9, resolve as resolve9 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 function resolveRoslynHostBinary() {
@@ -144766,35 +144780,66 @@ function resolveRoslynHostBinary() {
 }
 function invokeHost(bin, request) {
   return new Promise((resolvePromise, reject) => {
-    const child = spawn4(bin, [], { stdio: ["pipe", "pipe", "pipe"] });
+    const child = spawn4(bin, [], { stdio: ["pipe", "pipe", "pipe"], cwd: tmpdir() });
     let stdout = "";
     let stderr = "";
+    let settled = false;
+    const fail4 = (err) => {
+      if (settled)
+        return;
+      settled = true;
+      reject(err);
+    };
+    const succeed = (violations) => {
+      if (settled)
+        return;
+      settled = true;
+      resolvePromise(violations);
+    };
     child.stdout.setEncoding("utf8");
     child.stderr.setEncoding("utf8");
     child.stdout.on("data", (d3) => stdout += d3);
     child.stderr.on("data", (d3) => stderr += d3);
-    child.on("error", (e) => reject(new RoslynHostUnavailableError(`Failed to start the Roslyn host (${bin}): ${e.message}. Is the .NET runtime installed?`)));
-    child.on("close", () => {
-      const line = stdout.split("\n").find((l) => l.trim());
-      if (!line) {
-        reject(new Error(`Roslyn host produced no output.${stderr ? ` stderr: ${stderr}` : ""}`));
+    child.on("error", (e) => fail4(new RoslynHostUnavailableError(`Failed to start the Roslyn host (${bin}): ${e.message}. Is the .NET runtime installed?`)));
+    child.stdin.on("error", () => {
+    });
+    child.on("close", (code, signalName) => {
+      if (code !== 0 || signalName) {
+        const reason = stderr.trim() || stdout.trim() || "(no output)";
+        fail4(new RoslynHostUnavailableError(`The Roslyn host exited ${signalName ? `via ${signalName}` : `with code ${code}`} before responding. Is a compatible .NET runtime installed? Host output: ${reason}`));
+        return;
+      }
+      const lines = stdout.split("\n").map((l) => l.trim()).filter(Boolean);
+      if (lines.length === 0) {
+        fail4(new Error(`Roslyn host produced no output.${stderr ? ` stderr: ${stderr}` : ""}`));
         return;
       }
       let resp;
-      try {
-        resp = JSON.parse(line);
-      } catch {
-        reject(new Error(`Roslyn host returned invalid JSON: ${line}`));
+      for (const l of lines) {
+        try {
+          const parsed = JSON.parse(l);
+          if (parsed && typeof parsed.ok === "boolean") {
+            resp = parsed;
+            break;
+          }
+        } catch {
+        }
+      }
+      if (!resp) {
+        fail4(new Error(`Roslyn host returned invalid JSON: ${lines[0]}`));
         return;
       }
       if (!resp.ok) {
-        reject(new Error(`Roslyn host error: ${resp.error ?? "unknown"}`));
+        fail4(new Error(`Roslyn host error: ${resp.error ?? "unknown"}`));
         return;
       }
-      resolvePromise(resp.violations ?? []);
+      succeed(resp.violations ?? []);
     });
-    child.stdin.write(JSON.stringify(request) + "\n");
-    child.stdin.end();
+    try {
+      child.stdin.write(JSON.stringify(request) + "\n");
+      child.stdin.end();
+    } catch {
+    }
   });
 }
 function runRoslynWorkspace(projectPath, rules) {
@@ -147477,7 +147522,7 @@ var init_schemas2 = __esm({
 // packages/core/dist/services/llm/cli-provider.js
 import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { join as join10 } from "node:path";
-import { tmpdir } from "node:os";
+import { tmpdir as tmpdir2 } from "node:os";
 import { randomUUID as randomUUID4 } from "node:crypto";
 var import_cross_spawn, BaseCLIProvider, ClaudeCodeProvider;
 var init_cli_provider = __esm({
@@ -147547,7 +147592,7 @@ var init_cli_provider = __esm({
       constructor(transport) {
         this.transport = transport;
         if (process.env.TRUECOURSE_CLI_DEBUG) {
-          this.debugDir = join10(tmpdir(), "truecourse-cli-debug");
+          this.debugDir = join10(tmpdir2(), "truecourse-cli-debug");
           mkdirSync2(this.debugDir, { recursive: true });
           log.info(`[CLI] Debug output: ${this.debugDir}`);
         }
@@ -147660,8 +147705,13 @@ var init_cli_provider = __esm({
               unregisterChildProcess(this._repoId, child);
             reject(new Error(`[CLI] Failed to spawn ${this.binaryName}: ${err.message}`));
           });
-          child.stdin.write(prompt);
-          child.stdin.end();
+          child.stdin.on("error", () => {
+          });
+          try {
+            child.stdin.write(prompt);
+            child.stdin.end();
+          } catch {
+          }
         });
       }
       /** Extract usage data from CLI JSON envelope if present. */
@@ -169400,7 +169450,7 @@ function readToolVersion() {
   if (cachedVersion)
     return cachedVersion;
   if (true) {
-    cachedVersion = "0.6.9";
+    cachedVersion = "0.6.10";
     return cachedVersion;
   }
   try {
@@ -206318,7 +206368,7 @@ async function runHooksRun() {
 
 // tools/cli/src/index.ts
 var program2 = new Command();
-program2.name("truecourse").version("0.6.9").description("TrueCourse CLI \u2014 analyze your repository and open the dashboard");
+program2.name("truecourse").version("0.6.10").description("TrueCourse CLI \u2014 analyze your repository and open the dashboard");
 var dashboardCmd = program2.command("dashboard").description("Start the TrueCourse dashboard and open it in your browser").option("--reconfigure", "Re-prompt for console vs background service mode").option("--service", "Run as a background service (skips mode prompt)").option("--console", "Run in this terminal (skips mode prompt)").action(async (options) => {
   if (options.service && options.console) {
     console.error("error: --service and --console are mutually exclusive");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "truecourse",
-  "version": "0.6.9",
+  "version": "0.6.10",
   "description": "Visualize your codebase architecture as an interactive graph",
   "type": "module",
   "bin": {

package/server.mjs

@@ -51597,12 +51597,9 @@ var init_lsp_client = __esm({
         this.process.stdout.on("data", (chunk) => this.onData(chunk));
         this.process.stderr.on("data", (chunk) => {
         });
-        this.process.on("error", (err) => {
-          for (const pending of this.pendingRequests.values()) {
-            pending.reject(err);
-          }
-          this.pendingRequests.clear();
-        });
+        this.process.on("error", (err) => this.rejectAllPending(err));
+        this.process.stdin.on("error", (err) => this.rejectAllPending(new Error(`${this.config.name} LSP stdin error: ${err.message}`)));
+        this.process.on("exit", (code, signal) => this.rejectAllPending(new Error(`${this.config.name} LSP server exited (${signal ?? `code ${code}`}) before responding`)));
         const initResult = await this.sendRequest("initialize", {
           processId: process.pid,
           capabilities: {
@@ -51781,17 +51778,33 @@ var init_lsp_client = __esm({
       // -------------------------------------------------------------------------
       // Internal: JSON-RPC transport
       // -------------------------------------------------------------------------
+      /** Reject and clear every in-flight request — used when the server dies. */
+      rejectAllPending(err) {
+        if (this.pendingRequests.size === 0)
+          return;
+        for (const pending of this.pendingRequests.values())
+          pending.reject(err);
+        this.pendingRequests.clear();
+      }
       sendRequest(method, params) {
         return new Promise((resolve11, reject) => {
           const id = ++this.requestId;
           this.pendingRequests.set(id, { resolve: resolve11, reject });
           const msg = { jsonrpc: "2.0", id, method, params };
-          this.process.stdin.write(encodeMessage(msg));
+          try {
+            this.process.stdin.write(encodeMessage(msg));
+          } catch (err) {
+            this.pendingRequests.delete(id);
+            reject(err instanceof Error ? err : new Error(String(err)));
+          }
         });
       }
       sendNotification(method, params) {
         const msg = { jsonrpc: "2.0", method, params };
-        this.process.stdin.write(encodeMessage(msg));
+        try {
+          this.process.stdin.write(encodeMessage(msg));
+        } catch {
+        }
       }
       onData(chunk) {
         this.buffer = Buffer.concat([this.buffer, chunk]);
@@ -168808,6 +168821,7 @@ var init_pyproject_checker = __esm({
 // packages/analyzer/dist/roslyn-host-client.js
 import { spawn as spawn3 } from "child_process";
 import { existsSync as existsSync9 } from "fs";
+import { tmpdir } from "os";
 import { dirname as dirname8, resolve as resolve8 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function resolveRoslynHostBinary() {
@@ -168825,35 +168839,66 @@ function resolveRoslynHostBinary() {
 }
 function invokeHost(bin, request) {
   return new Promise((resolvePromise, reject) => {
-    const child = spawn3(bin, [], { stdio: ["pipe", "pipe", "pipe"] });
+    const child = spawn3(bin, [], { stdio: ["pipe", "pipe", "pipe"], cwd: tmpdir() });
     let stdout = "";
     let stderr = "";
+    let settled = false;
+    const fail = (err) => {
+      if (settled)
+        return;
+      settled = true;
+      reject(err);
+    };
+    const succeed = (violations) => {
+      if (settled)
+        return;
+      settled = true;
+      resolvePromise(violations);
+    };
     child.stdout.setEncoding("utf8");
     child.stderr.setEncoding("utf8");
     child.stdout.on("data", (d) => stdout += d);
     child.stderr.on("data", (d) => stderr += d);
-    child.on("error", (e) => reject(new RoslynHostUnavailableError(`Failed to start the Roslyn host (${bin}): ${e.message}. Is the .NET runtime installed?`)));
-    child.on("close", () => {
-      const line = stdout.split("\n").find((l) => l.trim());
-      if (!line) {
-        reject(new Error(`Roslyn host produced no output.${stderr ? ` stderr: ${stderr}` : ""}`));
+    child.on("error", (e) => fail(new RoslynHostUnavailableError(`Failed to start the Roslyn host (${bin}): ${e.message}. Is the .NET runtime installed?`)));
+    child.stdin.on("error", () => {
+    });
+    child.on("close", (code, signalName) => {
+      if (code !== 0 || signalName) {
+        const reason = stderr.trim() || stdout.trim() || "(no output)";
+        fail(new RoslynHostUnavailableError(`The Roslyn host exited ${signalName ? `via ${signalName}` : `with code ${code}`} before responding. Is a compatible .NET runtime installed? Host output: ${reason}`));
+        return;
+      }
+      const lines = stdout.split("\n").map((l) => l.trim()).filter(Boolean);
+      if (lines.length === 0) {
+        fail(new Error(`Roslyn host produced no output.${stderr ? ` stderr: ${stderr}` : ""}`));
         return;
       }
       let resp;
-      try {
-        resp = JSON.parse(line);
-      } catch {
-        reject(new Error(`Roslyn host returned invalid JSON: ${line}`));
+      for (const l of lines) {
+        try {
+          const parsed = JSON.parse(l);
+          if (parsed && typeof parsed.ok === "boolean") {
+            resp = parsed;
+            break;
+          }
+        } catch {
+        }
+      }
+      if (!resp) {
+        fail(new Error(`Roslyn host returned invalid JSON: ${lines[0]}`));
         return;
       }
       if (!resp.ok) {
-        reject(new Error(`Roslyn host error: ${resp.error ?? "unknown"}`));
+        fail(new Error(`Roslyn host error: ${resp.error ?? "unknown"}`));
         return;
       }
-      resolvePromise(resp.violations ?? []);
+      succeed(resp.violations ?? []);
     });
-    child.stdin.write(JSON.stringify(request) + "\n");
-    child.stdin.end();
+    try {
+      child.stdin.write(JSON.stringify(request) + "\n");
+      child.stdin.end();
+    } catch {
+    }
   });
 }
 function runRoslynWorkspace(projectPath, rules) {
@@ -172082,7 +172127,7 @@ var init_schemas2 = __esm({
 // packages/core/dist/services/llm/cli-provider.js
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join as join10 } from "node:path";
-import { tmpdir } from "node:os";
+import { tmpdir as tmpdir2 } from "node:os";
 import { randomUUID as randomUUID2 } from "node:crypto";
 var import_cross_spawn, BaseCLIProvider, ClaudeCodeProvider;
 var init_cli_provider = __esm({
@@ -172152,7 +172197,7 @@ var init_cli_provider = __esm({
       constructor(transport) {
         this.transport = transport;
         if (process.env.TRUECOURSE_CLI_DEBUG) {
-          this.debugDir = join10(tmpdir(), "truecourse-cli-debug");
+          this.debugDir = join10(tmpdir2(), "truecourse-cli-debug");
           mkdirSync(this.debugDir, { recursive: true });
           log.info(`[CLI] Debug output: ${this.debugDir}`);
         }
@@ -172265,8 +172310,13 @@ var init_cli_provider = __esm({
               unregisterChildProcess(this._repoId, child);
             reject(new Error(`[CLI] Failed to spawn ${this.binaryName}: ${err.message}`));
           });
-          child.stdin.write(prompt);
-          child.stdin.end();
+          child.stdin.on("error", () => {
+          });
+          try {
+            child.stdin.write(prompt);
+            child.stdin.end();
+          } catch {
+          }
         });
       }
       /** Extract usage data from CLI JSON envelope if present. */
@@ -198085,7 +198135,7 @@ function readToolVersion() {
   if (cachedVersion)
     return cachedVersion;
   if (true) {
-    cachedVersion = "0.6.9";
+    cachedVersion = "0.6.10";
     return cachedVersion;
   }
   try {