truecourse 0.3.1 → 0.3.3

package/README.md

@@ -85,12 +85,15 @@ truecourse add                        # Register repo without analyzing
 Configure which rule categories and LLM-powered rules are enabled per repository:
 
 ```bash
-truecourse rules categories           # Show enabled/disabled rule categories
-truecourse rules categories --disable style    # Disable a category
+# Categories
+truecourse rules categories                    # Show enabled/disabled
 truecourse rules categories --enable style     # Enable a category
-truecourse rules llm                  # Show LLM rules status
-truecourse rules llm --disable        # Disable LLM rules for this repo
-truecourse rules llm --enable         # Enable LLM rules for this repo
+truecourse rules categories --disable style    # Disable a category
+
+# LLM-powered rules
+truecourse rules llm                           # Show LLM rules status
+truecourse rules llm --enable                  # Enable LLM rules
+truecourse rules llm --disable                 # Disable LLM rules
 ```
 
 ### Git Hooks

package/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createRequire } from 'node:module'; const require = createRequire(import.meta.url);
+import { createRequire as __cR } from 'node:module'; const require = __cR(import.meta.url);
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -9694,7 +9694,7 @@ var require_websocket_server = __commonJS({
         socket.on("error", socketOnError);
         const key = req.headers["sec-websocket-key"];
         const upgrade = req.headers.upgrade;
-        const version2 = +req.headers["sec-websocket-version"];
+        const version = +req.headers["sec-websocket-version"];
         if (req.method !== "GET") {
           const message = "Invalid HTTP method";
           abortHandshakeOrEmitwsClientError(this, req, socket, 405, message);
@@ -9710,7 +9710,7 @@ var require_websocket_server = __commonJS({
           abortHandshakeOrEmitwsClientError(this, req, socket, 400, message);
           return;
         }
-        if (version2 !== 13 && version2 !== 8) {
+        if (version !== 13 && version !== 8) {
           const message = "Missing or invalid Sec-WebSocket-Version header";
           abortHandshakeOrEmitwsClientError(this, req, socket, 400, message, {
             "Sec-WebSocket-Version": "13, 8"
@@ -9754,7 +9754,7 @@ var require_websocket_server = __commonJS({
         }
         if (this.options.verifyClient) {
           const info = {
-            origin: req.headers[`${version2 === 8 ? "sec-websocket-origin" : "origin"}`],
+            origin: req.headers[`${version === 8 ? "sec-websocket-origin" : "origin"}`],
             secure: !!(req.socket.authorized || req.socket.encrypted),
             req
           };
@@ -14056,11 +14056,11 @@ function datetimeRegex(args) {
   regex = `${regex}(${opts.join("|")})`;
   return new RegExp(`^${regex}$`);
 }
-function isValidIP(ip, version2) {
-  if ((version2 === "v4" || !version2) && ipv4Regex.test(ip)) {
+function isValidIP(ip, version) {
+  if ((version === "v4" || !version) && ipv4Regex.test(ip)) {
     return true;
   }
-  if ((version2 === "v6" || !version2) && ipv6Regex.test(ip)) {
+  if ((version === "v6" || !version) && ipv6Regex.test(ip)) {
     return true;
   }
   return false;
@@ -14087,11 +14087,11 @@ function isValidJWT(jwt, alg) {
     return false;
   }
 }
-function isValidCidr(ip, version2) {
-  if ((version2 === "v4" || !version2) && ipv4CidrRegex.test(ip)) {
+function isValidCidr(ip, version) {
+  if ((version === "v4" || !version) && ipv4CidrRegex.test(ip)) {
     return true;
   }
-  if ((version2 === "v6" || !version2) && ipv6CidrRegex.test(ip)) {
+  if ((version === "v6" || !version) && ipv6CidrRegex.test(ip)) {
     return true;
   }
   return false;
@@ -20238,15 +20238,15 @@ var require_source_map_consumer = __commonJS({
       if (typeof aSourceMap === "string") {
         sourceMap = util2.parseSourceMapInput(aSourceMap);
       }
-      var version2 = util2.getArg(sourceMap, "version");
+      var version = util2.getArg(sourceMap, "version");
       var sources = util2.getArg(sourceMap, "sources");
       var names = util2.getArg(sourceMap, "names", []);
       var sourceRoot = util2.getArg(sourceMap, "sourceRoot", null);
       var sourcesContent = util2.getArg(sourceMap, "sourcesContent", null);
       var mappings = util2.getArg(sourceMap, "mappings");
       var file = util2.getArg(sourceMap, "file", null);
-      if (version2 != this._version) {
-        throw new Error("Unsupported version: " + version2);
+      if (version != this._version) {
+        throw new Error("Unsupported version: " + version);
       }
       if (sourceRoot) {
         sourceRoot = util2.normalize(sourceRoot);
@@ -20551,10 +20551,10 @@ var require_source_map_consumer = __commonJS({
       if (typeof aSourceMap === "string") {
         sourceMap = util2.parseSourceMapInput(aSourceMap);
       }
-      var version2 = util2.getArg(sourceMap, "version");
+      var version = util2.getArg(sourceMap, "version");
       var sections = util2.getArg(sourceMap, "sections");
-      if (version2 != this._version) {
-        throw new Error("Unsupported version: " + version2);
+      if (version != this._version) {
+        throw new Error("Unsupported version: " + version);
       }
       this._sources = new ArraySet();
       this._names = new ArraySet();
@@ -23748,7 +23748,7 @@ var require_typescript = __commonJS({
         usingSingleLineStringWriter: () => usingSingleLineStringWriter,
         utf16EncodeAsString: () => utf16EncodeAsString,
         validateLocaleAndSetLanguage: () => validateLocaleAndSetLanguage,
-        version: () => version2,
+        version: () => version,
         versionMajorMinor: () => versionMajorMinor,
         visitArray: () => visitArray,
         visitCommaListElements: () => visitCommaListElements,
@@ -23772,7 +23772,7 @@ var require_typescript = __commonJS({
       });
       module2.exports = __toCommonJS(typescript_exports);
       var versionMajorMinor = "5.9";
-      var version2 = "5.9.3";
+      var version = "5.9.3";
       var Comparison = /* @__PURE__ */ ((Comparison3) => {
         Comparison3[Comparison3["LessThan"] = -1] = "LessThan";
         Comparison3[Comparison3["EqualTo"] = 0] = "EqualTo";
@@ -26408,9 +26408,9 @@ ${lanes.join("\n")}
          * Tests whether a version matches the range. This is equivalent to `satisfies(version, range, { includePrerelease: true })`.
          * in `node-semver`.
          */
-        test(version22) {
-          if (typeof version22 === "string") version22 = new Version(version22);
-          return testDisjunction(version22, this._alternatives);
+        test(version2) {
+          if (typeof version2 === "string") version2 = new Version(version2);
+          return testDisjunction(version2, this._alternatives);
         }
         toString() {
           return formatDisjunction(this._alternatives);
@@ -26444,14 +26444,14 @@ ${lanes.join("\n")}
         const match2 = partialRegExp.exec(text);
         if (!match2) return void 0;
         const [, major, minor = "*", patch = "*", prerelease, build2] = match2;
-        const version22 = new Version(
+        const version2 = new Version(
           isWildcard(major) ? 0 : parseInt(major, 10),
           isWildcard(major) || isWildcard(minor) ? 0 : parseInt(minor, 10),
           isWildcard(major) || isWildcard(minor) || isWildcard(patch) ? 0 : parseInt(patch, 10),
           prerelease,
           build2
         );
-        return { version: version22, major, minor, patch };
+        return { version: version2, major, minor, patch };
       }
       function parseHyphen(left, right, comparators) {
         const leftResult = parsePartial(left);
@@ -26471,46 +26471,46 @@ ${lanes.join("\n")}
       function parseComparator(operator, text, comparators) {
         const result = parsePartial(text);
         if (!result) return false;
-        const { version: version22, major, minor, patch } = result;
+        const { version: version2, major, minor, patch } = result;
         if (!isWildcard(major)) {
           switch (operator) {
             case "~":
-              comparators.push(createComparator(">=", version22));
+              comparators.push(createComparator(">=", version2));
               comparators.push(createComparator(
                 "<",
-                version22.increment(
+                version2.increment(
                   isWildcard(minor) ? "major" : "minor"
                 )
               ));
               break;
             case "^":
-              comparators.push(createComparator(">=", version22));
+              comparators.push(createComparator(">=", version2));
               comparators.push(createComparator(
                 "<",
-                version22.increment(
-                  version22.major > 0 || isWildcard(minor) ? "major" : version22.minor > 0 || isWildcard(patch) ? "minor" : "patch"
+                version2.increment(
+                  version2.major > 0 || isWildcard(minor) ? "major" : version2.minor > 0 || isWildcard(patch) ? "minor" : "patch"
                 )
               ));
               break;
             case "<":
             case ">=":
               comparators.push(
-                isWildcard(minor) || isWildcard(patch) ? createComparator(operator, version22.with({ prerelease: "0" })) : createComparator(operator, version22)
+                isWildcard(minor) || isWildcard(patch) ? createComparator(operator, version2.with({ prerelease: "0" })) : createComparator(operator, version2)
               );
               break;
             case "<=":
             case ">":
               comparators.push(
-                isWildcard(minor) ? createComparator(operator === "<=" ? "<" : ">=", version22.increment("major").with({ prerelease: "0" })) : isWildcard(patch) ? createComparator(operator === "<=" ? "<" : ">=", version22.increment("minor").with({ prerelease: "0" })) : createComparator(operator, version22)
+                isWildcard(minor) ? createComparator(operator === "<=" ? "<" : ">=", version2.increment("major").with({ prerelease: "0" })) : isWildcard(patch) ? createComparator(operator === "<=" ? "<" : ">=", version2.increment("minor").with({ prerelease: "0" })) : createComparator(operator, version2)
               );
               break;
             case "=":
             case void 0:
               if (isWildcard(minor) || isWildcard(patch)) {
-                comparators.push(createComparator(">=", version22.with({ prerelease: "0" })));
-                comparators.push(createComparator("<", version22.increment(isWildcard(minor) ? "major" : "minor").with({ prerelease: "0" })));
+                comparators.push(createComparator(">=", version2.with({ prerelease: "0" })));
+                comparators.push(createComparator("<", version2.increment(isWildcard(minor) ? "major" : "minor").with({ prerelease: "0" })));
               } else {
-                comparators.push(createComparator("=", version22));
+                comparators.push(createComparator("=", version2));
               }
               break;
             default:
@@ -26527,21 +26527,21 @@ ${lanes.join("\n")}
       function createComparator(operator, operand) {
         return { operator, operand };
       }
-      function testDisjunction(version22, alternatives) {
+      function testDisjunction(version2, alternatives) {
         if (alternatives.length === 0) return true;
         for (const alternative of alternatives) {
-          if (testAlternative(version22, alternative)) return true;
+          if (testAlternative(version2, alternative)) return true;
         }
         return false;
       }
-      function testAlternative(version22, comparators) {
+      function testAlternative(version2, comparators) {
         for (const comparator of comparators) {
-          if (!testComparator(version22, comparator.operator, comparator.operand)) return false;
+          if (!testComparator(version2, comparator.operator, comparator.operand)) return false;
         }
         return true;
       }
-      function testComparator(version22, operator, operand) {
-        const cmp = version22.compareTo(operand);
+      function testComparator(version2, operator, operand) {
+        const cmp = version2.compareTo(operand);
         switch (operator) {
           case "<":
             return cmp < 0;
@@ -68884,7 +68884,7 @@ ${lanes.join("\n")}
       }
       var typeScriptVersion;
       function getPackageJsonTypesVersionsPaths(typesVersions) {
-        if (!typeScriptVersion) typeScriptVersion = new Version(version2);
+        if (!typeScriptVersion) typeScriptVersion = new Version(version);
         for (const key in typesVersions) {
           if (!hasProperty(typesVersions, key)) continue;
           const keyRange = VersionRange.tryParse(key);
@@ -70432,9 +70432,9 @@ ${lanes.join("\n")}
               state
             );
             if (peerPackageJson) {
-              const version22 = peerPackageJson.contents.packageJsonContent.version;
-              result += `+${key}@${version22}`;
-              if (state.traceEnabled) trace(state.host, Diagnostics.Found_peerDependency_0_with_1_version, key, version22);
+              const version2 = peerPackageJson.contents.packageJsonContent.version;
+              result += `+${key}@${version2}`;
+              if (state.traceEnabled) trace(state.host, Diagnostics.Found_peerDependency_0_with_1_version, key, version2);
             } else {
               if (state.traceEnabled) trace(state.host, Diagnostics.Failed_to_find_peerDependency_0, key);
             }
@@ -70532,7 +70532,7 @@ ${lanes.join("\n")}
             false
           );
           if (state.traceEnabled) {
-            trace(state.host, Diagnostics.package_json_has_a_typesVersions_entry_0_that_matches_compiler_version_1_looking_for_a_pattern_to_match_module_name_2, versionPaths.version, version2, moduleName);
+            trace(state.host, Diagnostics.package_json_has_a_typesVersions_entry_0_that_matches_compiler_version_1_looking_for_a_pattern_to_match_module_name_2, versionPaths.version, version, moduleName);
           }
           const pathPatterns = tryParsePatterns(versionPaths.paths);
           const result = tryLoadModuleUsingPaths(extensions, moduleName, candidate, versionPaths.paths, pathPatterns, loader2, onlyRecordFailuresForPackageFile || onlyRecordFailuresForIndex, state);
@@ -71014,7 +71014,7 @@ ${lanes.join("\n")}
         if (!startsWith(key, "types@")) return false;
         const range2 = VersionRange.tryParse(key.substring("types@".length));
         if (!range2) return false;
-        return range2.test(version2);
+        return range2.test(version);
       }
       function loadModuleFromNearestNodeModulesDirectory(extensions, moduleName, directory, state, cache2, redirectedReference) {
         return loadModuleFromNearestNodeModulesDirectoryWorker(
@@ -71150,7 +71150,7 @@ ${lanes.join("\n")}
         const versionPaths = rest !== "" && packageInfo ? getVersionPathsOfPackageJsonInfo(packageInfo, state) : void 0;
         if (versionPaths) {
           if (state.traceEnabled) {
-            trace(state.host, Diagnostics.package_json_has_a_typesVersions_entry_0_that_matches_compiler_version_1_looking_for_a_pattern_to_match_module_name_2, versionPaths.version, version2, rest);
+            trace(state.host, Diagnostics.package_json_has_a_typesVersions_entry_0_that_matches_compiler_version_1_looking_for_a_pattern_to_match_module_name_2, versionPaths.version, version, rest);
           }
           const packageDirectoryExists = nodeModulesDirectoryExists && directoryProbablyExists(packageDirectory, state.host);
           const pathPatterns = tryParsePatterns(versionPaths.paths);
@@ -151159,7 +151159,7 @@ ${lanes.join("\n")}
             emitSkipped = true;
             return;
           }
-          const buildInfo = host.getBuildInfo() || { version: version2 };
+          const buildInfo = host.getBuildInfo() || { version };
           writeFile(
             host,
             emitterDiagnostics,
@@ -161078,7 +161078,7 @@ ${lanes.join("\n")}
           const useOldState = canReuseOldState(referencedMap, oldState);
           newProgram.getTypeChecker();
           for (const sourceFile of newProgram.getSourceFiles()) {
-            const version22 = Debug.checkDefined(sourceFile.version, "Program intended to be used with Builder should have source files with versions set");
+            const version2 = Debug.checkDefined(sourceFile.version, "Program intended to be used with Builder should have source files with versions set");
             const oldUncommittedSignature = useOldState ? (_a2 = oldState.oldSignatures) == null ? void 0 : _a2.get(sourceFile.resolvedPath) : void 0;
             const signature = oldUncommittedSignature === void 0 ? useOldState ? (_b = oldState.fileInfos.get(sourceFile.resolvedPath)) == null ? void 0 : _b.signature : void 0 : oldUncommittedSignature || void 0;
             if (referencedMap) {
@@ -161088,7 +161088,7 @@ ${lanes.join("\n")}
               }
             }
             fileInfos.set(sourceFile.resolvedPath, {
-              version: version22,
+              version: version2,
               signature,
               // No need to calculate affectsGlobalScope with --out since its not used at all
               affectsGlobalScope: !options.outFile ? isFileAffectingGlobalScope(sourceFile) || void 0 : void 0,
@@ -161892,7 +161892,7 @@ ${lanes.join("\n")}
             root: arrayFrom(rootFileNames, (r) => relativeToBuildInfo(r)),
             errors: state.hasErrors ? true : void 0,
             checkPending: state.checkPending,
-            version: version2
+            version
           };
           return buildInfo2;
         }
@@ -161924,7 +161924,7 @@ ${lanes.join("\n")}
             // Actual value
             errors: state.hasErrors ? true : void 0,
             checkPending: state.checkPending,
-            version: version2
+            version
           };
           return buildInfo2;
         }
@@ -162021,7 +162021,7 @@ ${lanes.join("\n")}
           latestChangedDtsFile,
           errors: state.hasErrors ? true : void 0,
           checkPending: state.checkPending,
-          version: version2
+          version
         };
         return buildInfo;
         function relativeToBuildInfoEnsuringAbsolutePath(path14) {
@@ -162798,8 +162798,8 @@ ${lanes.join("\n")}
         const resolvedRoots = new Map(program3.resolvedRoot);
         program3.fileInfos.forEach((fileInfo, index) => {
           const path14 = toPath(program3.fileNames[index], buildInfoDirectory, getCanonicalFileName);
-          const version22 = isString(fileInfo) ? fileInfo : fileInfo.version;
-          fileInfos.set(path14, version22);
+          const version2 = isString(fileInfo) ? fileInfo : fileInfo.version;
+          fileInfos.set(path14, version2);
           if (rootIndex < program3.root.length) {
             const current = program3.root[rootIndex];
             const fileId = index + 1;
@@ -164699,7 +164699,7 @@ ${lanes.join("\n")}
           if (!content) return void 0;
           buildInfo = getBuildInfo(buildInfoPath, content);
         }
-        if (!buildInfo || buildInfo.version !== version2 || !isIncrementalBuildInfo(buildInfo)) return void 0;
+        if (!buildInfo || buildInfo.version !== version || !isIncrementalBuildInfo(buildInfo)) return void 0;
         return createBuilderProgramUsingIncrementalBuildInfo(buildInfo, buildInfoPath, host);
       }
       function createIncrementalCompilerHost(options, system = sys2) {
@@ -166402,7 +166402,7 @@ ${lanes.join("\n")}
           };
         }
         const incrementalBuildInfo = isIncremental && isIncrementalBuildInfo(buildInfo) ? buildInfo : void 0;
-        if ((incrementalBuildInfo || !isIncremental) && buildInfo.version !== version2) {
+        if ((incrementalBuildInfo || !isIncremental) && buildInfo.version !== version) {
           return {
             type: 14,
             version: buildInfo.version
@@ -166458,17 +166458,17 @@ ${lanes.join("\n")}
           }
           const inputPath = toPath2(state, inputFile);
           if (buildInfoTime < inputTime) {
-            let version22;
+            let version2;
             let currentVersion;
             if (incrementalBuildInfo) {
               if (!buildInfoVersionMap) buildInfoVersionMap = getBuildInfoFileVersionMap(incrementalBuildInfo, buildInfoPath, host);
               const resolvedInputPath = buildInfoVersionMap.roots.get(inputPath);
-              version22 = buildInfoVersionMap.fileInfos.get(resolvedInputPath ?? inputPath);
-              const text = version22 ? state.readFileWithCache(resolvedInputPath ?? inputFile) : void 0;
+              version2 = buildInfoVersionMap.fileInfos.get(resolvedInputPath ?? inputPath);
+              const text = version2 ? state.readFileWithCache(resolvedInputPath ?? inputFile) : void 0;
               currentVersion = text !== void 0 ? getSourceFileVersionAsHashFromText(host, text) : void 0;
-              if (version22 && version22 === currentVersion) pseudoInputUpToDate = true;
+              if (version2 && version2 === currentVersion) pseudoInputUpToDate = true;
             }
-            if (!version22 || version22 !== currentVersion) {
+            if (!version2 || version2 !== currentVersion) {
               return {
                 type: 5,
                 outOfDateOutputFileName: buildInfoPath,
@@ -167221,7 +167221,7 @@ ${lanes.join("\n")}
               Diagnostics.Project_0_is_out_of_date_because_output_for_it_was_generated_with_version_1_that_differs_with_current_version_2,
               relName(state, configFileName),
               status.version,
-              version2
+              version
             );
           case 17:
             return reportStatus(
@@ -167309,7 +167309,7 @@ ${lanes.join("\n")}
         return !!commandLine.options.all ? toSorted(optionDeclarations.concat(tscBuildOption), (a, b) => compareStringsCaseInsensitive(a.name, b.name)) : filter2(optionDeclarations.concat(tscBuildOption), (v) => !!v.showInSimplifiedHelpView);
       }
       function printVersion(sys22) {
-        sys22.write(getDiagnosticText(Diagnostics.Version_0, version2) + sys22.newLine);
+        sys22.write(getDiagnosticText(Diagnostics.Version_0, version) + sys22.newLine);
       }
       function createColors(sys22) {
         const showColors = defaultIsPretty(sys22);
@@ -167561,7 +167561,7 @@ ${lanes.join("\n")}
       }
       function printEasyHelp(sys22, simpleOptions) {
         const colors = createColors(sys22);
-        let output = [...getHeader(sys22, `${getDiagnosticText(Diagnostics.tsc_Colon_The_TypeScript_Compiler)} - ${getDiagnosticText(Diagnostics.Version_0, version2)}`)];
+        let output = [...getHeader(sys22, `${getDiagnosticText(Diagnostics.tsc_Colon_The_TypeScript_Compiler)} - ${getDiagnosticText(Diagnostics.Version_0, version)}`)];
         output.push(colors.bold(getDiagnosticText(Diagnostics.COMMON_COMMANDS)) + sys22.newLine + sys22.newLine);
         example("tsc", Diagnostics.Compiles_the_current_project_tsconfig_json_in_the_working_directory);
         example("tsc app.ts util.ts", Diagnostics.Ignoring_tsconfig_json_compiles_the_specified_files_with_default_compiler_options);
@@ -167608,7 +167608,7 @@ ${lanes.join("\n")}
         }
       }
       function printAllHelp(sys22, compilerOptions, buildOptions, watchOptions) {
-        let output = [...getHeader(sys22, `${getDiagnosticText(Diagnostics.tsc_Colon_The_TypeScript_Compiler)} - ${getDiagnosticText(Diagnostics.Version_0, version2)}`)];
+        let output = [...getHeader(sys22, `${getDiagnosticText(Diagnostics.tsc_Colon_The_TypeScript_Compiler)} - ${getDiagnosticText(Diagnostics.Version_0, version)}`)];
         output = [...output, ...generateSectionOptionsOutput(
           sys22,
           getDiagnosticText(Diagnostics.ALL_COMPILER_OPTIONS),
@@ -167640,7 +167640,7 @@ ${lanes.join("\n")}
         }
       }
       function printBuildHelp(sys22, buildOptions) {
-        let output = [...getHeader(sys22, `${getDiagnosticText(Diagnostics.tsc_Colon_The_TypeScript_Compiler)} - ${getDiagnosticText(Diagnostics.Version_0, version2)}`)];
+        let output = [...getHeader(sys22, `${getDiagnosticText(Diagnostics.tsc_Colon_The_TypeScript_Compiler)} - ${getDiagnosticText(Diagnostics.Version_0, version)}`)];
         output = [...output, ...generateSectionOptionsOutput(
           sys22,
           getDiagnosticText(Diagnostics.BUILD_OPTIONS),
@@ -175173,38 +175173,38 @@ ${lanes.join("\n")}
           }
           return settingsOrHost;
         }
-        function acquireDocument(fileName, compilationSettings, scriptSnapshot, version22, scriptKind, languageVersionOrOptions) {
+        function acquireDocument(fileName, compilationSettings, scriptSnapshot, version2, scriptKind, languageVersionOrOptions) {
           const path14 = toPath(fileName, currentDirectory, getCanonicalFileName);
           const key = getKeyForCompilationSettings(getCompilationSettings(compilationSettings));
-          return acquireDocumentWithKey(fileName, path14, compilationSettings, key, scriptSnapshot, version22, scriptKind, languageVersionOrOptions);
+          return acquireDocumentWithKey(fileName, path14, compilationSettings, key, scriptSnapshot, version2, scriptKind, languageVersionOrOptions);
         }
-        function acquireDocumentWithKey(fileName, path14, compilationSettings, key, scriptSnapshot, version22, scriptKind, languageVersionOrOptions) {
+        function acquireDocumentWithKey(fileName, path14, compilationSettings, key, scriptSnapshot, version2, scriptKind, languageVersionOrOptions) {
           return acquireOrUpdateDocument(
             fileName,
             path14,
             compilationSettings,
             key,
             scriptSnapshot,
-            version22,
+            version2,
             /*acquiring*/
             true,
             scriptKind,
             languageVersionOrOptions
           );
         }
-        function updateDocument(fileName, compilationSettings, scriptSnapshot, version22, scriptKind, languageVersionOrOptions) {
+        function updateDocument(fileName, compilationSettings, scriptSnapshot, version2, scriptKind, languageVersionOrOptions) {
           const path14 = toPath(fileName, currentDirectory, getCanonicalFileName);
           const key = getKeyForCompilationSettings(getCompilationSettings(compilationSettings));
-          return updateDocumentWithKey(fileName, path14, compilationSettings, key, scriptSnapshot, version22, scriptKind, languageVersionOrOptions);
+          return updateDocumentWithKey(fileName, path14, compilationSettings, key, scriptSnapshot, version2, scriptKind, languageVersionOrOptions);
         }
-        function updateDocumentWithKey(fileName, path14, compilationSettings, key, scriptSnapshot, version22, scriptKind, languageVersionOrOptions) {
+        function updateDocumentWithKey(fileName, path14, compilationSettings, key, scriptSnapshot, version2, scriptKind, languageVersionOrOptions) {
           return acquireOrUpdateDocument(
             fileName,
             path14,
             getCompilationSettings(compilationSettings),
             key,
             scriptSnapshot,
-            version22,
+            version2,
             /*acquiring*/
             false,
             scriptKind,
@@ -175216,7 +175216,7 @@ ${lanes.join("\n")}
           Debug.assert(scriptKind === void 0 || !entry || entry.sourceFile.scriptKind === scriptKind, `Script kind should match provided ScriptKind:${scriptKind} and sourceFile.scriptKind: ${entry == null ? void 0 : entry.sourceFile.scriptKind}, !entry: ${!entry}`);
           return entry;
         }
-        function acquireOrUpdateDocument(fileName, path14, compilationSettingsOrHost, key, scriptSnapshot, version22, acquiring, scriptKind, languageVersionOrOptions) {
+        function acquireOrUpdateDocument(fileName, path14, compilationSettingsOrHost, key, scriptSnapshot, version2, acquiring, scriptKind, languageVersionOrOptions) {
           var _a2, _b, _c, _d;
           scriptKind = ensureScriptKind(fileName, scriptKind);
           const compilationSettings = getCompilationSettings(compilationSettingsOrHost);
@@ -175260,7 +175260,7 @@ ${lanes.join("\n")}
               fileName,
               scriptSnapshot,
               sourceFileOptions,
-              version22,
+              version2,
               /*setNodeParents*/
               false,
               scriptKind
@@ -175274,8 +175274,8 @@ ${lanes.join("\n")}
             };
             setBucketEntry();
           } else {
-            if (entry.sourceFile.version !== version22) {
-              entry.sourceFile = updateLanguageServiceSourceFile(entry.sourceFile, scriptSnapshot, version22, scriptSnapshot.getChangeRange(entry.sourceFile.scriptSnapshot));
+            if (entry.sourceFile.version !== version2) {
+              entry.sourceFile = updateLanguageServiceSourceFile(entry.sourceFile, scriptSnapshot, version2, scriptSnapshot.getChangeRange(entry.sourceFile.scriptSnapshot));
               if (externalCache) {
                 externalCache.setDocument(keyWithMode, path14, entry.sourceFile);
               }
@@ -184120,7 +184120,7 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             throw new Error("Could not find file: '" + fileName + "'.");
           }
           const scriptKind = getScriptKind(fileName, this.host);
-          const version22 = this.host.getScriptVersion(fileName);
+          const version2 = this.host.getScriptVersion(fileName);
           let sourceFile;
           if (this.currentFileName !== fileName) {
             const options = {
@@ -184140,17 +184140,17 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
               fileName,
               scriptSnapshot,
               options,
-              version22,
+              version2,
               /*setNodeParents*/
               true,
               scriptKind
             );
-          } else if (this.currentFileVersion !== version22) {
+          } else if (this.currentFileVersion !== version2) {
             const editRange = scriptSnapshot.getChangeRange(this.currentFileScriptSnapshot);
-            sourceFile = updateLanguageServiceSourceFile(this.currentSourceFile, scriptSnapshot, version22, editRange);
+            sourceFile = updateLanguageServiceSourceFile(this.currentSourceFile, scriptSnapshot, version2, editRange);
           }
           if (sourceFile) {
-            this.currentFileVersion = version22;
+            this.currentFileVersion = version2;
             this.currentFileName = fileName;
             this.currentFileScriptSnapshot = scriptSnapshot;
             this.currentSourceFile = sourceFile;
@@ -184158,18 +184158,18 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
           return this.currentSourceFile;
         }
       };
-      function setSourceFileFields(sourceFile, scriptSnapshot, version22) {
-        sourceFile.version = version22;
+      function setSourceFileFields(sourceFile, scriptSnapshot, version2) {
+        sourceFile.version = version2;
         sourceFile.scriptSnapshot = scriptSnapshot;
       }
-      function createLanguageServiceSourceFile(fileName, scriptSnapshot, scriptTargetOrOptions, version22, setNodeParents, scriptKind) {
+      function createLanguageServiceSourceFile(fileName, scriptSnapshot, scriptTargetOrOptions, version2, setNodeParents, scriptKind) {
         const sourceFile = createSourceFile2(fileName, getSnapshotText(scriptSnapshot), scriptTargetOrOptions, setNodeParents, scriptKind);
-        setSourceFileFields(sourceFile, scriptSnapshot, version22);
+        setSourceFileFields(sourceFile, scriptSnapshot, version2);
         return sourceFile;
       }
-      function updateLanguageServiceSourceFile(sourceFile, scriptSnapshot, version22, textChangeRange, aggressiveChecks) {
+      function updateLanguageServiceSourceFile(sourceFile, scriptSnapshot, version2, textChangeRange, aggressiveChecks) {
         if (textChangeRange) {
-          if (version22 !== sourceFile.version) {
+          if (version2 !== sourceFile.version) {
             let newText;
             const prefix = textChangeRange.span.start !== 0 ? sourceFile.text.substr(0, textChangeRange.span.start) : "";
             const suffix = textSpanEnd(textChangeRange.span) !== sourceFile.text.length ? sourceFile.text.substr(textSpanEnd(textChangeRange.span)) : "";
@@ -184180,7 +184180,7 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
               newText = prefix && suffix ? prefix + changedText + suffix : prefix ? prefix + changedText : changedText + suffix;
             }
             const newSourceFile = updateSourceFile(sourceFile, newText, textChangeRange, aggressiveChecks);
-            setSourceFileFields(newSourceFile, scriptSnapshot, version22);
+            setSourceFileFields(newSourceFile, scriptSnapshot, version2);
             newSourceFile.nameTable = void 0;
             if (sourceFile !== newSourceFile && sourceFile.scriptSnapshot) {
               if (sourceFile.scriptSnapshot.dispose) {
@@ -184201,7 +184201,7 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
           sourceFile.fileName,
           scriptSnapshot,
           options,
-          version22,
+          version2,
           /*setNodeParents*/
           true,
           sourceFile.scriptKind
@@ -219251,7 +219251,7 @@ ${options.prefix}` : "\n" : options.prefix
         usingSingleLineStringWriter: () => usingSingleLineStringWriter,
         utf16EncodeAsString: () => utf16EncodeAsString,
         validateLocaleAndSetLanguage: () => validateLocaleAndSetLanguage,
-        version: () => version2,
+        version: () => version,
         versionMajorMinor: () => versionMajorMinor,
         visitArray: () => visitArray,
         visitCommaListElements: () => visitCommaListElements,
@@ -219276,7 +219276,7 @@ ${options.prefix}` : "\n" : options.prefix
       var enableDeprecationWarnings = true;
       var typeScriptVersion2;
       function getTypeScriptVersion() {
-        return typeScriptVersion2 ?? (typeScriptVersion2 = new Version(version2));
+        return typeScriptVersion2 ?? (typeScriptVersion2 = new Version(version));
       }
       function formatDeprecationMessage(name, error2, errorAfter, since, message) {
         let deprecationMessage = error2 ? "DeprecationError: " : "DeprecationWarning: ";
@@ -219316,12 +219316,12 @@ ${options.prefix}` : "\n" : options.prefix
         };
       }
       function createDeprecation(name, options = {}) {
-        const version22 = typeof options.typeScriptVersion === "string" ? new Version(options.typeScriptVersion) : options.typeScriptVersion ?? getTypeScriptVersion();
+        const version2 = typeof options.typeScriptVersion === "string" ? new Version(options.typeScriptVersion) : options.typeScriptVersion ?? getTypeScriptVersion();
         const errorAfter = typeof options.errorAfter === "string" ? new Version(options.errorAfter) : options.errorAfter;
         const warnAfter = typeof options.warnAfter === "string" ? new Version(options.warnAfter) : options.warnAfter;
         const since = typeof options.since === "string" ? new Version(options.since) : options.since ?? warnAfter;
-        const error2 = options.error || errorAfter && version22.compareTo(errorAfter) >= 0;
-        const warn = !warnAfter || version22.compareTo(warnAfter) >= 0;
+        const error2 = options.error || errorAfter && version2.compareTo(errorAfter) >= 0;
+        const warn = !warnAfter || version2.compareTo(warnAfter) >= 0;
         return error2 ? createErrorDeprecation(name, errorAfter, since, options.message) : warn ? createWarningDeprecation(name, errorAfter, since, options.message) : noop;
       }
       function wrapFunction(deprecation, func) {
@@ -219716,11 +219716,11 @@ ${options.prefix}` : "\n" : options.prefix
                   this.log.writeLine(`Adding entry into typings cache: '${packageName}' => '${typingFile}'`);
                 }
                 const info = npmLock.packages && getProperty(npmLock.packages, `node_modules/${key}`) || getProperty(npmLock.dependencies, key);
-                const version22 = info && info.version;
-                if (!version22) {
+                const version2 = info && info.version;
+                if (!version2) {
                   continue;
                 }
-                const newTyping = { typingLocation: typingFile, version: new Version(version22) };
+                const newTyping = { typingLocation: typingFile, version: new Version(version2) };
                 this.packageNameToTypingLocation.set(packageName, newTyping);
               }
             }
@@ -219785,7 +219785,7 @@ ${options.prefix}` : "\n" : options.prefix
           this.sendResponse({
             kind: EventBeginInstallTypes,
             eventId: requestId,
-            typingsInstallerVersion: version2,
+            typingsInstallerVersion: version,
             projectName: req.projectName
           });
           const scopedTypings = filteredTypings.map(typingsName);
@@ -219827,7 +219827,7 @@ ${options.prefix}` : "\n" : options.prefix
                 projectName: req.projectName,
                 packagesToInstall: scopedTypings,
                 installSuccess: ok,
-                typingsInstallerVersion: version2
+                typingsInstallerVersion: version
               };
               this.sendResponse(response);
             }
@@ -224866,7 +224866,7 @@ ${options.prefix}` : "\n" : options.prefix
             configFileName: configFileName(),
             projectType: project instanceof ExternalProject ? "external" : "configured",
             languageServiceEnabled: project.languageServiceEnabled,
-            version: version2
+            version
           };
           this.eventHandler({ eventName: ProjectInfoTelemetryEvent, data });
           function configFileName() {
@@ -227834,7 +227834,7 @@ ${json2}${newLine}`;
               "status"
               /* Status */
             ]: () => {
-              const response = { version: version2 };
+              const response = { version };
               return this.requiredResponse(response);
             },
             [
@@ -231392,11 +231392,11 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
           this.minVersion = 0;
           this.currentVersion = 0;
         }
-        versionToIndex(version22) {
-          if (version22 < this.minVersion || version22 > this.currentVersion) {
+        versionToIndex(version2) {
+          if (version2 < this.minVersion || version2 > this.currentVersion) {
             return void 0;
           }
-          return version22 % _ScriptVersionCache2.maxVersions;
+          return version2 % _ScriptVersionCache2.maxVersions;
         }
         currentVersionToIndex() {
           return this.currentVersion % _ScriptVersionCache2.maxVersions;
@@ -231481,8 +231481,8 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
       _ScriptVersionCache.maxVersions = 8;
       var ScriptVersionCache = _ScriptVersionCache;
       var LineIndexSnapshot = class _LineIndexSnapshot {
-        constructor(version22, cache2, index, changesSincePreviousVersion = emptyArray2) {
-          this.version = version22;
+        constructor(version2, cache2, index, changesSincePreviousVersion = emptyArray2) {
+          this.version = version2;
           this.cache = cache2;
           this.index = index;
           this.changesSincePreviousVersion = changesSincePreviousVersion;
@@ -256049,8 +256049,8 @@ var init_weak_ssl = __esm({
           }
         }
         if (key?.text === "minVersion" && value2) {
-          const version2 = value2.text.replace(/['"]/g, "").toLowerCase();
-          if (version2 === "tlsv1" || version2 === "tlsv1.0") {
+          const version = value2.text.replace(/['"]/g, "").toLowerCase();
+          if (version === "tlsv1" || version === "tlsv1.0") {
             return makeViolation(this.ruleKey, node, filePath, "high", "Weak SSL/TLS protocol", "Setting minimum TLS version to 1.0 allows insecure connections.", sourceCode, 'Set minVersion to "TLSv1.2" or higher.');
           }
         }
@@ -257148,14 +257148,14 @@ var init_ssl_version_unsafe = __esm({
         const key = node.childForFieldName("key");
         const value2 = node.childForFieldName("value");
         if (key?.text === "minVersion" && value2) {
-          const version2 = value2.text.replace(/['"]/g, "").toLowerCase();
-          if (version2 === "tlsv1" || version2 === "tlsv1.0" || version2 === "tlsv1.1") {
+          const version = value2.text.replace(/['"]/g, "").toLowerCase();
+          if (version === "tlsv1" || version === "tlsv1.0" || version === "tlsv1.1") {
             return makeViolation(this.ruleKey, node, filePath, "high", "Unsafe SSL/TLS minimum version", `Minimum TLS version set to "${value2.text.replace(/['"]/g, "")}". TLS 1.0 and 1.1 are deprecated.`, sourceCode, 'Set minVersion to "TLSv1.2" or higher.');
           }
         }
         if (key?.text === "maxVersion" && value2) {
-          const version2 = value2.text.replace(/['"]/g, "").toLowerCase();
-          if (version2 === "tlsv1" || version2 === "tlsv1.0" || version2 === "tlsv1.1") {
+          const version = value2.text.replace(/['"]/g, "").toLowerCase();
+          if (version === "tlsv1" || version === "tlsv1.0" || version === "tlsv1.1") {
             return makeViolation(this.ruleKey, node, filePath, "high", "Unsafe SSL/TLS minimum version", `Maximum TLS version set to "${value2.text.replace(/['"]/g, "")}". This prevents use of modern TLS.`, sourceCode, 'Set maxVersion to "TLSv1.3" or remove the restriction.');
           }
         }
@@ -315308,7 +315308,6 @@ var {
 init_dist4();
 init_setup();
 init_start();
-import { createRequire } from "node:module";
 import fs9 from "node:fs";
 import path13 from "node:path";
 import os7 from "node:os";
@@ -318818,10 +318817,8 @@ async function runHooksRun() {
 }
 
 // tools/cli/src/index.ts
-var require2 = createRequire(import.meta.url);
-var { version } = require2("../package.json");
 var program2 = new Command();
-program2.name("truecourse").version(version).description("TrueCourse CLI - Setup and manage your TrueCourse instance");
+program2.name("truecourse").version("0.3.3").description("TrueCourse CLI - Setup and manage your TrueCourse instance");
 program2.command("setup").description("Run the setup wizard to configure TrueCourse").action(async () => {
   await runSetup();
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "truecourse",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Visualize your codebase architecture as an interactive graph",
   "type": "module",
   "bin": {
@@ -18,15 +18,15 @@
     "dotenv": "^16.4.0",
     "embedded-postgres": "18.3.0-beta.16",
     "postgres": "^3.4.0",
-    "pyright": "^1.1.408",
+    "pyright": "^1.1.408"
+  },
+  "optionalDependencies": {
+    "node-windows": "^1.0.0-beta.8",
     "tree-sitter": "^0.25.0",
     "tree-sitter-javascript": "^0.25.0",
     "tree-sitter-python": "^0.25.0",
     "tree-sitter-typescript": "^0.23.2"
   },
-  "optionalDependencies": {
-    "node-windows": "^1.0.0-beta.8"
-  },
   "license": "MIT",
   "repository": {
     "type": "git",

package/postinstall.cjs

@@ -7,12 +7,39 @@
  * only specifies C++17. This script detects the failure and retries the
  * build with the correct flag.
  *
+ * Logs are written to ~/.truecourse/install.log for debugging.
+ *
  * See: https://github.com/truecourse-ai/truecourse/issues/22
  */
 
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const logDir = path.join(os.homedir(), '.truecourse');
+const logFile = path.join(logDir, 'install.log');
+
+function log(msg) {
+  const line = `[${new Date().toISOString()}] ${msg}`;
+  try {
+    fs.mkdirSync(logDir, { recursive: true });
+    fs.appendFileSync(logFile, line + '\n');
+  } catch {
+    // best effort
+  }
+  console.log(`[TrueCourse] ${msg}`);
+}
+
+log('--- postinstall started ---');
+log(`Node ${process.version}, platform=${process.platform}, arch=${process.arch}`);
+log(`CXXFLAGS=${process.env.CXXFLAGS || '(not set)'}`);
+
 try {
   require('tree-sitter');
-} catch {
+  log('tree-sitter: loaded OK');
+} catch (err) {
+  log(`tree-sitter: failed to load — ${err.message}`);
+
   const { execSync } = require('child_process');
   const packages = [
     'tree-sitter',
@@ -21,15 +48,16 @@ try {
     'tree-sitter-python',
   ].join(' ');
 
-  console.log('[TrueCourse] tree-sitter native module not found, rebuilding with C++20...');
+  log('Rebuilding with CXXFLAGS="-std=c++20"...');
 
   try {
     execSync(`CXXFLAGS="-std=c++20" npm rebuild ${packages}`, {
       stdio: 'inherit',
       env: { ...process.env, CXXFLAGS: '-std=c++20' },
     });
-    console.log('[TrueCourse] tree-sitter rebuilt successfully.');
+    log('tree-sitter: rebuilt OK');
   } catch {
+    log('tree-sitter: rebuild failed');
     console.warn(
       '\n[TrueCourse] Could not rebuild tree-sitter automatically.\n' +
       'Fix: set the C++20 flag manually and reinstall:\n' +
@@ -37,7 +65,8 @@ try {
       '  npx truecourse\n\n' +
       'See: https://github.com/truecourse-ai/truecourse/issues/22\n'
     );
-    // Exit 0 — don't fail the install
     process.exit(0);
   }
 }
+
+log('--- postinstall done ---');