truecourse 0.1.13 → 0.1.15

package/cli.mjs

@@ -12271,6 +12271,9 @@ var init_macos = __esm({
       async install(serverPath, logPath) {
         const envFile = path.join(os.homedir(), ".truecourse", ".env");
         const envVars = parseEnvFile(envFile);
+        if (process.env.PATH && !envVars.PATH) {
+          envVars.PATH = process.env.PATH;
+        }
         fs2.mkdirSync(PLIST_DIR, { recursive: true });
         fs2.mkdirSync(path.dirname(logPath), { recursive: true });
         const plist = buildPlist(serverPath, logPath, envVars);
@@ -12610,6 +12613,7 @@ var init_logs = __esm({
 // tools/cli/src/commands/start.ts
 var start_exports = {};
 __export(start_exports, {
+  getServerProcess: () => getServerProcess,
   runStart: () => runStart
 });
 import { spawn as spawn2 } from "node:child_process";
@@ -12620,7 +12624,7 @@ function getServerPath() {
 }
 async function healthcheck() {
   const url2 = getServerUrl();
-  for (let i = 0; i < 30; i++) {
+  for (let i = 0; i < 120; i++) {
     try {
       const res = await fetch(`${url2}/api/health`);
       if (res.ok) return true;
@@ -12662,11 +12666,14 @@ async function startServiceMode(openBrowser) {
     v2.info("Check logs with: truecourse service logs");
   }
 }
+function getServerProcess() {
+  return _serverProcess;
+}
 function startConsoleMode(openBrowser) {
   const serverPath = getServerPath();
   const url2 = getServerUrl();
   v2.step("Starting server (embedded PostgreSQL starts automatically)...");
-  const serverProcess = spawn2(
+  const serverProcess = _serverProcess = spawn2(
     process.execPath,
     [serverPath],
     {
@@ -12709,7 +12716,7 @@ async function runStart({ openBrowser = true } = {}) {
     startConsoleMode(openBrowser);
   }
 }
-var __dirname;
+var __dirname, _serverProcess;
 var init_start = __esm({
   "tools/cli/src/commands/start.ts"() {
     "use strict";
@@ -12718,6 +12725,7 @@ var init_start = __esm({
     init_platform();
     init_logs();
     __dirname = path4.dirname(fileURLToPath(import.meta.url));
+    _serverProcess = null;
   }
 });
 
@@ -12730,6 +12738,7 @@ __export(helpers_exports, {
   getConfigPath: () => getConfigPath,
   getServerUrl: () => getServerUrl,
   openInBrowser: () => openInBrowser,
+  promptInstallSkills: () => promptInstallSkills,
   readConfig: () => readConfig,
   renderDiffResults: () => renderDiffResults,
   renderDiffResultsSummary: () => renderDiffResultsSummary,
@@ -12740,8 +12749,11 @@ __export(helpers_exports, {
   writeConfig: () => writeConfig
 });
 import { exec } from "node:child_process";
+import { cpSync, existsSync } from "node:fs";
 import fs5 from "node:fs";
 import path5 from "node:path";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
 import os4 from "node:os";
 function getConfigPath() {
   return path5.join(os4.homedir(), ".truecourse", "config.json");
@@ -12775,16 +12787,28 @@ async function ensureServer() {
     if (!res.ok) throw new Error(`Server returned ${res.status}`);
     return false;
   } catch {
-    const { runStart: runStart2 } = await Promise.resolve().then(() => (init_start(), start_exports));
+    const envPath = path5.join(os4.homedir(), ".truecourse", ".env");
+    if (!fs5.existsSync(envPath)) {
+      const { runSetup: runSetup2 } = await Promise.resolve().then(() => (init_setup(), setup_exports));
+      await runSetup2();
+    }
+    const { runStart: runStart2, getServerProcess: getServerProcess2 } = await Promise.resolve().then(() => (init_start(), start_exports));
     await runStart2({ openBrowser: false });
-    try {
-      const res = await fetch(`${url2}/api/health`);
-      if (!res.ok) throw new Error();
-    } catch {
-      v2.error("Server failed to start. Check logs with: truecourse service logs");
-      process.exit(1);
+    const killServer = () => {
+      const proc = getServerProcess2();
+      if (proc && !proc.killed) proc.kill("SIGTERM");
+    };
+    process.on("exit", killServer);
+    for (let i = 0; i < 120; i++) {
+      try {
+        const res = await fetch(`${url2}/api/health`);
+        if (res.ok) return true;
+      } catch {
+      }
+      await new Promise((r2) => setTimeout(r2, 500));
     }
-    return true;
+    v2.error("Server failed to start. Check logs with: truecourse service logs");
+    process.exit(1);
   }
 }
 async function ensureRepo() {
@@ -12807,7 +12831,11 @@ async function ensureRepo() {
     v2.error(message);
     process.exit(1);
   }
-  return await res.json();
+  const repo = await res.json();
+  if (res.status === 201) {
+    await promptInstallSkills(process.cwd());
+  }
+  return repo;
 }
 function connectSocket(repoId) {
   const url2 = getServerUrl();
@@ -13005,6 +13033,26 @@ function openInBrowser(url2) {
   const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
   exec(`${cmd} ${url2}`);
 }
+async function promptInstallSkills(repoPath) {
+  const installSkills = await me({
+    message: "Would you like to install Claude Code skills?"
+  });
+  if (BD(installSkills) || !installSkills) return;
+  const __dirname3 = dirname(fileURLToPath2(import.meta.url));
+  const srcPath = resolve(__dirname3, "..", "..", "skills", "truecourse");
+  const distPath = resolve(__dirname3, "skills", "truecourse");
+  const skillsSrc = existsSync(srcPath) ? srcPath : distPath;
+  if (!existsSync(skillsSrc)) {
+    v2.warn("Skills directory not found in package \u2014 skipping.");
+    return;
+  }
+  const skillsDest = resolve(repoPath, ".claude", "skills");
+  cpSync(skillsSrc, skillsDest, { recursive: true });
+  v2.success("Installed Claude Code skills:");
+  v2.message("  - truecourse-analyze  (run analysis)");
+  v2.message("  - truecourse-list     (list violations)");
+  v2.message("  - truecourse-fix      (apply fixes)");
+}
 var DEFAULT_PORT, DEFAULT_CONFIG;
 var init_helpers = __esm({
   "tools/cli/src/commands/helpers.ts"() {
@@ -13016,39 +13064,15 @@ var init_helpers = __esm({
   }
 });
 
-// node_modules/.pnpm/commander@12.1.0/node_modules/commander/esm.mjs
-var import_index = __toESM(require_commander(), 1);
-var {
-  program,
-  createCommand,
-  createArgument,
-  createOption,
-  CommanderError,
-  InvalidArgumentError,
-  InvalidOptionArgumentError,
-  // deprecated old name
-  Command,
-  Argument,
-  Option,
-  Help
-} = import_index.default;
-
-// tools/cli/src/index.ts
-init_dist2();
-import fs7 from "node:fs";
-import path8 from "node:path";
-import os6 from "node:os";
-
 // tools/cli/src/commands/setup.ts
-init_dist2();
+var setup_exports = {};
+__export(setup_exports, {
+  runSetup: () => runSetup
+});
 import { execSync as execSync4 } from "node:child_process";
 import fs6 from "node:fs";
 import path6 from "node:path";
 import os5 from "node:os";
-var DEFAULT_MODELS = {
-  anthropic: "claude-sonnet-4-20250514",
-  openai: "gpt-5.3-codex"
-};
 function buildEnvContents(config) {
   const lines = [
     "# TrueCourse Environment Configuration",
@@ -13194,8 +13218,8 @@ async function runSetup() {
   const runMode = await de({
     message: "How would you like to run TrueCourse?",
     options: [
-      { value: "console", label: "Console (keep terminal open)" },
-      { value: "service", label: "Background service (runs automatically, no terminal needed)" }
+      { value: "service", label: "Background service (Recommended)" },
+      { value: "console", label: "Console (keep terminal open)" }
     ]
   });
   if (BD(runMode)) {
@@ -13211,16 +13235,46 @@ async function runSetup() {
   v2.info("Database migrations are applied on server startup.");
   fe("Setup complete!");
 }
+var DEFAULT_MODELS;
+var init_setup = __esm({
+  "tools/cli/src/commands/setup.ts"() {
+    "use strict";
+    init_dist2();
+    DEFAULT_MODELS = {
+      anthropic: "claude-sonnet-4-20250514",
+      openai: "gpt-5.3-codex"
+    };
+  }
+});
+
+// node_modules/.pnpm/commander@12.1.0/node_modules/commander/esm.mjs
+var import_index = __toESM(require_commander(), 1);
+var {
+  program,
+  createCommand,
+  createArgument,
+  createOption,
+  CommanderError,
+  InvalidArgumentError,
+  InvalidOptionArgumentError,
+  // deprecated old name
+  Command,
+  Argument,
+  Option,
+  Help
+} = import_index.default;
 
 // tools/cli/src/index.ts
+init_dist2();
+init_setup();
 init_start();
+import fs7 from "node:fs";
+import path8 from "node:path";
+import os6 from "node:os";
 
 // tools/cli/src/commands/add.ts
 init_dist2();
 init_helpers();
-import { cpSync, existsSync } from "node:fs";
-import { resolve, dirname } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
 async function runAdd() {
   const repoPath = process.cwd();
   const serverUrl = getServerUrl();
@@ -13247,27 +13301,7 @@ async function runAdd() {
     const repo = await res.json();
     const repoUrl = `${serverUrl}/repos/${repo.id}`;
     v2.success(`Repository "${repo.name}" added`);
-    const installSkills = await me({
-      message: "Would you like to install Claude Code skills?"
-    });
-    if (BD(installSkills)) {
-      fe(`Open ${repoUrl}`);
-      return;
-    }
-    if (installSkills) {
-      const cliDir = dirname(fileURLToPath2(import.meta.url));
-      const skillsSrc = resolve(cliDir, "..", "..", "skills", "truecourse");
-      if (!existsSync(skillsSrc)) {
-        v2.warn("Skills directory not found in package \u2014 skipping.");
-      } else {
-        const skillsDest = resolve(repoPath, ".claude", "skills", "truecourse");
-        cpSync(skillsSrc, skillsDest, { recursive: true });
-        v2.success("Installed Claude Code skills:");
-        v2.message("  - truecourse-analyze  (run analysis)");
-        v2.message("  - truecourse-list     (list violations)");
-        v2.message("  - truecourse-fix      (apply fixes)");
-      }
-    }
+    await promptInstallSkills(repoPath);
     fe(`Open ${repoUrl}`);
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
@@ -13286,15 +13320,37 @@ async function runAdd() {
 init_dist2();
 init_helpers();
 var TIMEOUT_MS = 15 * 60 * 1e3;
-async function runAnalyze() {
+async function runAnalyze({ noAutostart = false } = {}) {
   we("Analyzing repository");
-  const firstRun = await ensureServer();
+  if (noAutostart) {
+    const url2 = getServerUrl();
+    try {
+      const res = await fetch(`${url2}/api/health`);
+      if (!res.ok) throw new Error();
+    } catch {
+      v2.error("TrueCourse server is not running. Start it with: npx truecourse start");
+      process.exit(1);
+    }
+  }
+  const firstRun = noAutostart ? false : await ensureServer();
   const repo = await ensureRepo();
   v2.step(`Repository: ${repo.name}`);
   const serverUrl = getServerUrl();
   const socket = connectSocket(repo.id);
   const spinner = L2();
   spinner.start("Starting analysis...");
+  let canceled = false;
+  const onSigint = () => {
+    if (canceled) return;
+    canceled = true;
+    spinner.stop("Cancelling analysis...");
+    fetch(`${serverUrl}/api/repos/${repo.id}/analyze/cancel`, { method: "POST" }).catch(() => {
+    }).finally(() => {
+      socket.disconnect();
+      process.exit(130);
+    });
+  };
+  process.on("SIGINT", onSigint);
   try {
     await new Promise((resolve2, reject) => {
       const timeout = setTimeout(() => {
@@ -13321,6 +13377,10 @@ async function runAnalyze() {
         violationsReady = true;
         checkDone();
       });
+      socket.on("analysis:canceled", () => {
+        clearTimeout(timeout);
+        reject(new Error("CANCELED"));
+      });
       fetch(`${serverUrl}/api/repos/${repo.id}/analyze`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
@@ -13360,17 +13420,34 @@ async function runAnalyze() {
       fe(`Analysis complete \u2014 open ${repoUrl}`);
     }
   } catch (err) {
-    spinner.stop("Analysis failed");
     const message = err instanceof Error ? err.message : String(err);
-    v2.error(message);
-    process.exit(1);
+    if (message === "CANCELED") {
+      spinner.stop("Analysis cancelled");
+      fe("Analysis cancelled");
+    } else {
+      spinner.stop("Analysis failed");
+      v2.error(message);
+      process.exit(1);
+    }
   } finally {
+    process.removeListener("SIGINT", onSigint);
     socket.disconnect();
   }
 }
-async function runAnalyzeDiff() {
+async function runAnalyzeDiff({ noAutostart = false } = {}) {
   we("Running diff check");
-  await ensureServer();
+  if (noAutostart) {
+    const url2 = getServerUrl();
+    try {
+      const res = await fetch(`${url2}/api/health`);
+      if (!res.ok) throw new Error();
+    } catch {
+      v2.error("TrueCourse server is not running. Start it with: npx truecourse start");
+      process.exit(1);
+    }
+  } else {
+    await ensureServer();
+  }
   const repo = await ensureRepo();
   v2.step(`Repository: ${repo.name}`);
   const serverUrl = getServerUrl();
@@ -13622,11 +13699,11 @@ program2.command("start").description("Start TrueCourse services").action(async
 program2.command("add").description("Add the current directory as a repository").action(async () => {
   await runAdd();
 });
-program2.command("analyze").description("Analyze the current repository").option("--diff", "Run diff check against latest analysis").action(async (options) => {
+program2.command("analyze").description("Analyze the current repository").option("--diff", "Run diff check against latest analysis").option("--no-autostart", "Don't auto-start the server (for use from Claude Code skills)").action(async (options) => {
   if (options.diff) {
-    await runAnalyzeDiff();
+    await runAnalyzeDiff({ noAutostart: !options.autostart });
   } else {
-    await runAnalyze();
+    await runAnalyze({ noAutostart: !options.autostart });
   }
 });
 program2.command("list").description("List violations from the latest analysis").option("--diff", "Show diff check results (new and resolved)").action(async (options) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "truecourse",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Visualize your codebase architecture as an interactive graph",
   "type": "module",
   "bin": {
@@ -15,9 +15,9 @@
     "dotenv": "^16.4.0",
     "embedded-postgres": "18.3.0-beta.16",
     "postgres": "^3.4.0",
-    "tree-sitter": "^0.21.1",
-    "tree-sitter-javascript": "^0.21.4",
-    "tree-sitter-typescript": "^0.21.2"
+    "tree-sitter": "^0.25.0",
+    "tree-sitter-javascript": "^0.25.0",
+    "tree-sitter-typescript": "^0.23.2"
   },
   "optionalDependencies": {
     "node-windows": "^1.0.0-beta.8"