mcp-code-context 3.8.1 → 3.9.0

package/dist/src/utils/gemfileParser.js

@@ -0,0 +1,63 @@
+/**
+ * Gemfile Parser - v3.9.0
+ * Parses Ruby Gemfile to extract gem dependencies and infer implicit behavior.
+ * Uses a JSON data file for gem descriptions so they can be updated without recompile.
+ */
+import * as fsSync from "node:fs";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+// Load gem descriptions from JSON sibling file at module init time (sync, once)
+function loadGemDescriptions() {
+    try {
+        const dir = path.dirname(fileURLToPath(import.meta.url));
+        const jsonPath = path.join(dir, "gemDescriptions.json");
+        return JSON.parse(fsSync.readFileSync(jsonPath, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+const GEM_DESCRIPTIONS = loadGemDescriptions();
+// Cache: gemfilePath → { result, mtime }
+const gemfileCache = new Map();
+export async function parseGemfile(projectRoot) {
+    const gemfilePath = path.join(projectRoot, "Gemfile");
+    let mtime;
+    try {
+        mtime = (await fs.stat(gemfilePath)).mtimeMs;
+    }
+    catch {
+        return null; // No Gemfile — not a Ruby project
+    }
+    const cached = gemfileCache.get(gemfilePath);
+    if (cached?.mtime === mtime)
+        return cached.result;
+    const content = await fs.readFile(gemfilePath, "utf-8");
+    const result = parseGemfileContent(content);
+    gemfileCache.set(gemfilePath, { result, mtime });
+    return result;
+}
+export function parseGemfileContent(content) {
+    const gems = [];
+    // Match: gem 'name' | gem 'name', '~> 1.0' | gem "name", "version"
+    const gemRe = /^\s*gem\s+['"]([^'"]+)['"](?:\s*,\s*['"]([^'"]+)['"])?/gm;
+    let match;
+    while ((match = gemRe.exec(content)) !== null) {
+        const name = match[1].toLowerCase();
+        const version = match[2];
+        const implicitBehavior = GEM_DESCRIPTIONS[name];
+        gems.push({ name, version, implicitBehavior });
+    }
+    const knownGems = gems.filter(g => g.implicitBehavior !== undefined);
+    return { gems, knownGems };
+}
+export function formatGemAnnotation(knownGems) {
+    if (knownGems.length === 0)
+        return "";
+    const lines = knownGems
+        .map(g => `  <gem name="${g.name}"${g.version ? ` version="${g.version}"` : ""}>\n    ${g.implicitBehavior}\n  </gem>`)
+        .join("\n");
+    return `<!-- Gemfile: installed gems with implicit behavior\n${lines}\n-->`;
+}
+//# sourceMappingURL=gemfileParser.js.map

package/dist/src/utils/gemfileParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemfileParser.js","sourceRoot":"","sources":["../../../src/utils/gemfileParser.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/logger.d.ts

@@ -1,5 +1,5 @@
 /**
- * Logger - v3.8.1
+ * Logger - v3.9.0
  * Structured logging with pino (JSON to stderr, MCP-safe)
  */
 import pino from 'pino';

package/dist/src/utils/logger.js

@@ -1,5 +1,5 @@
 /**
- * Logger - v3.8.1
+ * Logger - v3.9.0
  * Structured logging with pino (JSON to stderr, MCP-safe)
  */
 import pino from 'pino';

package/dist/src/utils/metaprogramming.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Metaprogramming Entry Point Scanner - v3.9.0
+ * Identifies where Ruby's "magic" methods are generated in a codebase.
+ * Does not resolve what methods are created — it surfaces WHERE to look.
+ */
+export interface MetaprogrammingMatch {
+    file: string;
+    line: number;
+    pattern: string;
+    snippet: string;
+    description: string;
+}
+export declare function findMetaprogrammingEntryPoints(params: {
+    target: string;
+    projectRoot: string;
+    isFile?: boolean;
+}): Promise<MetaprogrammingMatch[]>;
+export declare function formatMetaprogrammingResults(matches: MetaprogrammingMatch[]): string;

package/dist/src/utils/metaprogramming.js

@@ -0,0 +1,139 @@
+/**
+ * Metaprogramming Entry Point Scanner - v3.9.0
+ * Identifies where Ruby's "magic" methods are generated in a codebase.
+ * Does not resolve what methods are created — it surfaces WHERE to look.
+ */
+import * as fs from "node:fs/promises";
+import { EXCLUDE_DIRS } from "./constants.js";
+import { walkDir } from "./fileWalker.js";
+/** Patterns that generate methods dynamically in Ruby */
+const METAPROGRAMMING_PATTERNS = [
+    {
+        regex: /\bmethod_missing\b/,
+        name: "method_missing",
+        description: "Catch-all for undefined method calls — generates methods on demand",
+    },
+    {
+        regex: /\bdefine_method\b/,
+        name: "define_method",
+        description: "Programmatically defines a method on a class at runtime",
+    },
+    {
+        regex: /\bclass_eval\b|\bmodule_eval\b/,
+        name: "class_eval/module_eval",
+        description: "Evaluates code in the context of a class — can define methods dynamically",
+    },
+    {
+        regex: /\binstance_eval\b/,
+        name: "instance_eval",
+        description: "Evaluates code in the context of an object — can define singleton methods",
+    },
+    {
+        regex: /\bsend\s*\(/,
+        name: "send",
+        description: "Invokes a method dynamically by name — may call generated methods",
+    },
+    {
+        regex: /\bpublic_send\s*\(/,
+        name: "public_send",
+        description: "Like send but restricted to public methods — dynamic dispatch",
+    },
+    {
+        regex: /\bincluded\s+do\b/,
+        name: "included do",
+        description: "ActiveSupport::Concern hook — runs when module is included, may add methods/callbacks",
+    },
+    {
+        regex: /\bprepended\s+do\b/,
+        name: "prepended do",
+        description: "Module prepend hook — methods are added before the including class in the MRO",
+    },
+    {
+        regex: /ActiveSupport::Concern/,
+        name: "ActiveSupport::Concern",
+        description: "Rails concern module — adds class methods and instance methods when included",
+    },
+    {
+        regex: /\battr_accessor\b|\battr_reader\b|\battr_writer\b/,
+        name: "attr_accessor/reader/writer",
+        description: "Generates getter/setter methods for the listed attributes",
+    },
+    {
+        regex: /\bdelegate\b.*:to\s*=>/,
+        name: "delegate",
+        description: "Rails delegate macro — generates forwarding methods to another object",
+    },
+    {
+        regex: /\bhas_many\b.*through:/,
+        name: "has_many :through",
+        description: "AR association — generates join-table query methods",
+    },
+];
+export async function findMetaprogrammingEntryPoints(params) {
+    const matches = [];
+    if (params.isFile) {
+        const content = await fs.readFile(params.target, "utf-8").catch(() => null);
+        if (content) {
+            scanContent(content, params.target, matches);
+        }
+    }
+    else {
+        await walkDir(params.target, {
+            extensions: [".rb"],
+            excludeDirs: EXCLUDE_DIRS,
+            onFile: async (fullPath) => {
+                const content = await fs.readFile(fullPath, "utf-8").catch(() => null);
+                if (content) {
+                    scanContent(content, fullPath, matches);
+                }
+            },
+        });
+    }
+    return matches;
+}
+function scanContent(content, filePath, matches) {
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        for (const { regex, name, description } of METAPROGRAMMING_PATTERNS) {
+            if (regex.test(line)) {
+                // Get 1 line of context before and after
+                const snippet = lines.slice(Math.max(0, i - 1), i + 2).join("\n");
+                matches.push({
+                    file: filePath,
+                    line: i + 1,
+                    pattern: name,
+                    snippet: snippet.trim(),
+                    description,
+                });
+                break; // one match per line
+            }
+        }
+    }
+}
+export function formatMetaprogrammingResults(matches) {
+    if (matches.length === 0) {
+        return JSON.stringify({ found: 0, message: "No metaprogramming entry points detected" });
+    }
+    // Group by file
+    const byFile = new Map();
+    for (const m of matches) {
+        const existing = byFile.get(m.file) ?? [];
+        existing.push(m);
+        byFile.set(m.file, existing);
+    }
+    const result = {
+        found: matches.length,
+        files: Array.from(byFile.entries()).map(([file, fileMatches]) => ({
+            file,
+            matches: fileMatches.map(m => ({
+                line: m.line,
+                pattern: m.pattern,
+                description: m.description,
+                snippet: m.snippet,
+            })),
+        })),
+    };
+    return JSON.stringify(result, null, 2);
+}
+//# sourceMappingURL=metaprogramming.js.map

package/dist/src/utils/metaprogramming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metaprogramming.js","sourceRoot":"","sources":["../../../src/utils/metaprogramming.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/railsRoutes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Rails Routes Parser - v3.9.0
+ * Parses config/routes.rb to map HTTP routes to controller actions.
+ * v1: handles resources, resource, explicit get/post/patch/put/delete/root.
+ * v1 limitation: only:/except:/shallow:/nested resources — emits warnings, does not generate false routes.
+ */
+export interface RouteEntry {
+    method: string;
+    path: string;
+    controller: string;
+    action: string;
+}
+export interface RoutesResult {
+    routes: RouteEntry[];
+    warnings: string[];
+}
+export declare function parseRailsRoutes(projectRoot: string): Promise<RoutesResult | null>;
+export declare function parseRoutesContent(content: string): RoutesResult;

package/dist/src/utils/railsRoutes.js

@@ -0,0 +1,148 @@
+/**
+ * Rails Routes Parser - v3.9.0
+ * Parses config/routes.rb to map HTTP routes to controller actions.
+ * v1: handles resources, resource, explicit get/post/patch/put/delete/root.
+ * v1 limitation: only:/except:/shallow:/nested resources — emits warnings, does not generate false routes.
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+// Cache: routesPath → { result, mtime }
+const routesCache = new Map();
+/** Standard 7 REST actions for `resources` */
+const RESOURCES_ACTIONS = [
+    { method: "GET", path: "", action: "index", controller: "" },
+    { method: "GET", path: "/new", action: "new", controller: "" },
+    { method: "POST", path: "", action: "create", controller: "" },
+    { method: "GET", path: "/:id", action: "show", controller: "" },
+    { method: "GET", path: "/:id/edit", action: "edit", controller: "" },
+    { method: "PATCH", path: "/:id", action: "update", controller: "" },
+    { method: "DELETE", path: "/:id", action: "destroy", controller: "" },
+];
+/** Standard 6 singular REST actions for `resource` */
+const RESOURCE_ACTIONS = [
+    { method: "GET", path: "/new", action: "new", controller: "" },
+    { method: "POST", path: "", action: "create", controller: "" },
+    { method: "GET", path: "", action: "show", controller: "" },
+    { method: "GET", path: "/edit", action: "edit", controller: "" },
+    { method: "PATCH", path: "", action: "update", controller: "" },
+    { method: "DELETE", path: "", action: "destroy", controller: "" },
+];
+export async function parseRailsRoutes(projectRoot) {
+    const routesPath = path.join(projectRoot, "config", "routes.rb");
+    let mtime;
+    try {
+        mtime = (await fs.stat(routesPath)).mtimeMs;
+    }
+    catch {
+        return null; // No routes.rb — not a Rails app
+    }
+    const cached = routesCache.get(routesPath);
+    if (cached?.mtime === mtime)
+        return cached.result;
+    const content = await fs.readFile(routesPath, "utf-8");
+    const result = parseRoutesContent(content);
+    routesCache.set(routesPath, { result, mtime });
+    return result;
+}
+export function parseRoutesContent(content) {
+    const routes = [];
+    const warnings = [];
+    // Stack for namespace/scope prefix accumulation
+    const prefixStack = [];
+    const lines = content.split("\n");
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        // Skip comments and blank lines
+        if (line.startsWith("#") || line === "")
+            continue;
+        // Namespace/scope push
+        const nsMatch = line.match(/^(?:namespace|scope)\s+[:'"]([^'"]+)['"]/);
+        if (nsMatch) {
+            prefixStack.push(nsMatch[1].replace(/^:/, ""));
+            continue;
+        }
+        // Closing end — pop prefix stack
+        if (line === "end" && prefixStack.length > 0) {
+            prefixStack.pop();
+            continue;
+        }
+        const prefix = prefixStack.length > 0 ? "/" + prefixStack.join("/") : "";
+        // Detect unsupported options — warn instead of generating wrong output
+        const hasOnlyExcept = /\bonly:\s*\[/.test(line) || /\bexcept:\s*\[/.test(line);
+        const hasShallow = /\bshallow:\s*true\b/.test(line);
+        const hasNested = line.includes("do") && (line.startsWith("resources") || line.startsWith("resource"));
+        // resources :name
+        const resourcesMatch = line.match(/^resources\s+:(\w+)/);
+        if (resourcesMatch) {
+            const name = resourcesMatch[1];
+            const controller = nameToController(name, prefixStack);
+            const basePath = `${prefix}/${name}`;
+            if (hasOnlyExcept) {
+                warnings.push(`resources :${name} uses only:/except: — route list may be incomplete. Full support planned for v2.`);
+            }
+            if (hasShallow) {
+                warnings.push(`resources :${name} uses shallow: — nested shallow routes not fully parsed.`);
+            }
+            if (hasNested) {
+                warnings.push(`resources :${name} has nested resources (do block) — only top-level routes parsed.`);
+            }
+            for (const action of RESOURCES_ACTIONS) {
+                routes.push({
+                    method: action.method,
+                    path: basePath + action.path,
+                    controller,
+                    action: action.action,
+                });
+            }
+            continue;
+        }
+        // resource :name (singular)
+        const resourceMatch = line.match(/^resource\s+:(\w+)/);
+        if (resourceMatch) {
+            const name = resourceMatch[1];
+            const controller = nameToController(name + "s", prefixStack); // pluralize for controller
+            const basePath = `${prefix}/${name}`;
+            if (hasOnlyExcept) {
+                warnings.push(`resource :${name} uses only:/except: — route list may be incomplete.`);
+            }
+            for (const action of RESOURCE_ACTIONS) {
+                routes.push({
+                    method: action.method,
+                    path: basePath + action.path,
+                    controller,
+                    action: action.action,
+                });
+            }
+            continue;
+        }
+        // Explicit HTTP verb routes: get '/path', to: 'controller#action'
+        const verbMatch = line.match(/^(get|post|patch|put|delete|head|options)\s+['"]([^'"]+)['"]\s*,\s*to:\s*['"]([^#'"]+)#([^'"]+)['"]/i);
+        if (verbMatch) {
+            routes.push({
+                method: verbMatch[1].toUpperCase(),
+                path: prefix + verbMatch[2],
+                controller: verbMatch[3].trim(),
+                action: verbMatch[4].trim(),
+            });
+            continue;
+        }
+        // root to: 'controller#action'
+        const rootMatch = line.match(/^root\s+(?:to:\s*)?['"]([^#'"]+)#([^'"]+)['"]/);
+        if (rootMatch) {
+            routes.push({
+                method: "GET",
+                path: prefix + "/",
+                controller: rootMatch[1].trim(),
+                action: rootMatch[2].trim(),
+            });
+            continue;
+        }
+    }
+    return { routes, warnings };
+}
+/** Convert resource name + namespace stack to controller name */
+function nameToController(name, prefixStack) {
+    const ns = prefixStack.length > 0 ? prefixStack.join("/") + "/" : "";
+    return `${ns}${name}`;
+}
+//# sourceMappingURL=railsRoutes.js.map

package/dist/src/utils/railsRoutes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"railsRoutes.js","sourceRoot":"","sources":["../../../src/utils/railsRoutes.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/railsSchema.d.ts

@@ -8,3 +8,4 @@ export declare function loadRailsSchema(projectRoot: string): Promise<ProjectDbS
 export declare function parseSchemaRb(content: string): ProjectDbSchema;
 export declare function modelToTable(className: string): string;
 export declare function formatSchemaAnnotation(tableName: string, columns: TableSchema): string;
+export declare function findRailsConcerns(projectRoot: string): Promise<Map<string, string[]>>;

package/dist/src/utils/railsSchema.js

@@ -101,4 +101,27 @@ export function formatSchemaAnnotation(tableName, columns) {
         .join("\n");
     return `<!-- ActiveRecord Virtual Schema: ${tableName}\n${cols}\n-->`;
 }
+// R5: Concern Resolution - Scan for concerns in app/models/concerns and app/controllers/concerns
+export async function findRailsConcerns(projectRoot) {
+    const concernMap = new Map();
+    const concernsDirs = [
+        path.join(projectRoot, "app", "models", "concerns"),
+        path.join(projectRoot, "app", "controllers", "concerns"),
+    ];
+    for (const dir of concernsDirs) {
+        try {
+            const files = await fs.readdir(dir, { withFileTypes: true });
+            for (const file of files) {
+                if (file.isFile() && file.name.endsWith(".rb")) {
+                    const moduleName = file.name.replace(/\.rb$/, "").split("_").map(part => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+                    concernMap.set(moduleName, [path.join(dir, file.name)]);
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist, skip
+        }
+    }
+    return concernMap;
+}
 //# sourceMappingURL=railsSchema.js.map

package/dist/src/utils/railsSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"railsSchema.js","sourceRoot":"","sources":["../../../src/utils/railsSchema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"railsSchema.js","sourceRoot":"","sources":["../../../src/utils/railsSchema.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/rateLimiter.d.ts

@@ -1,5 +1,5 @@
 /**
- * Rate Limiter - v3.8.1
+ * Rate Limiter - v3.9.0
  * Token bucket algorithm for DoS protection
  */
 interface RateLimitConfig {

package/dist/src/utils/rateLimiter.js

@@ -1,5 +1,5 @@
 /**
- * Rate Limiter - v3.8.1
+ * Rate Limiter - v3.9.0
  * Token bucket algorithm for DoS protection
  */
 export class RateLimiter {

package/dist/src/utils/streaming.d.ts

@@ -1,5 +1,5 @@
 /**
- * File Streaming - v3.8.1
+ * File Streaming - v3.9.0
  * Stream large files in chunks to avoid memory exhaustion
  */
 import type { BaseParser, SymbolInfo } from "../parsers/base.js";

package/dist/src/utils/streaming.js

@@ -1,5 +1,5 @@
 /**
- * File Streaming - v3.8.1
+ * File Streaming - v3.9.0
  * Stream large files in chunks to avoid memory exhaustion
  */
 import * as fs from "node:fs";

package/dist/src/utils/telemetry.d.ts

@@ -1,5 +1,5 @@
 /**
- * Telemetry - v3.8.1
+ * Telemetry - v3.9.0
  * Metrics collection and monitoring
  */
 export interface Metric {

package/dist/src/utils/telemetry.js

@@ -1,5 +1,5 @@
 /**
- * Telemetry - v3.8.1
+ * Telemetry - v3.9.0
  * Metrics collection and monitoring
  */
 export class TelemetryCollector {

package/llms.txt

@@ -1,8 +1,8 @@
-# mcp-code-context v3.8.1
+# mcp-code-context v3.9.0
 
 > A Model Context Protocol (MCP) server with **Tree-sitter WASM parsers** for 100% AST accuracy. Zero native dependencies. Production-ready with middleware pipeline, session-scoped state, and crash recovery.
 
-## What's New in v3.8.1
+## What's New in v3.9.0
 
 🚀 **CRITICAL FIXES - Production Readiness Release**:
 - ✅ **Session-scoped state**: Each MCP client gets isolated locks, confirmation store, rate limiter (no state leakage)
@@ -149,13 +149,13 @@ This MCP server solves two problems:
 - `steps` (optional): Number of versions to go back (1-5, default: 1).
 **What it does:** Reverts the file to the state it was in before the last 1-5 modifications.
 
-### Write Tools (v3.8.1 Two-Phase Workflow)
+### Write Tools (v3.9.0 Two-Phase Workflow)
 
 All write tools follow a **Two-Phase Workflow**:
 1. **Phase 1 (Preview)**: Call without a token to get a unified `diff` and a `confirmationToken`.
 2. **Phase 2 (Apply)**: Call with `confirmationToken` and `confirm: true` to apply the changes.
 
-**Important Notes (v3.8.1):**
+**Important Notes (v3.9.0):**
 - ✅ **Windows CRLF Support**: Fully resolved. All operations work correctly on Windows files with CRLF line endings.
 - ✅ **Parameter Brace Handling**: Methods with braces in parameters (e.g., `{int? cart}`) are now handled correctly.
 - ✅ **Session-scoped state**: Each MCP client gets isolated state (locks, confirmation store, rate limiter).
@@ -236,7 +236,7 @@ All write tools follow a **Two-Phase Workflow**:
 
 **Best used when:** Cleaning up deprecated functions or unused code.
 
-## New Tools (v3.8.1)
+## New Tools (v3.9.0)
 
 #### 11. `get_session_stats`
 **Purpose:** Get statistics for the current MCP client session.
@@ -268,7 +268,7 @@ All write tools follow a **Two-Phase Workflow**:
 
 **Best used when:** Recovering work after a server crash.
 
-## Previously Added Tools (v3.8.1)
+## Previously Added Tools (v3.9.0)
 
 #### 14. `parse_file`
 **Purpose:** Parse a file using Tree-sitter and extract all symbols.
@@ -313,7 +313,7 @@ All write tools follow a **Two-Phase Workflow**:
 5. **Phase 2: Apply Edit** → Verify the diff, then call with the token and `confirm: true`.
 6. **Recovery** → Use `rollback_file` if needed.
 
-## Session State Configuration (v3.8.1+)
+## Session State Configuration (v3.9.0+)
 
 ### Critical: Session-Scoped State
 
@@ -429,6 +429,6 @@ No additional configuration is needed beyond adding the MCP server definition. S
 
 ---
 
-**Version**: 3.8.1  
+**Version**: 3.9.0  
 **Last Updated**: June 8, 2026  
 **Status**: Production-ready with session-scoped state and crash recovery

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-code-context",
-  "version": "3.8.1",
+  "version": "3.9.0",
   "description": "Powerful MCP server with Tree-sitter WASM parsers for 100% AST accuracy. Zero native dependencies. Production-ready with persistent caching, structured logging, file watching, fuzzy search, rate limiting, file locking, and ReDoS protection. Supports TypeScript, JavaScript, PHP, Dart, Python, and Ruby (with ActiveRecord Virtual Schema extraction).",
   "type": "module",
   "main": "dist/src/index.js",
@@ -8,7 +8,7 @@
     "mcp-code-context": "dist/src/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && node -e \"require('fs').copyFileSync('src/utils/gemDescriptions.json', 'dist/src/utils/gemDescriptions.json')\"",
     "test": "npm run build && npm run build:tests && node dist-tests/tests/test-security.js && node dist-tests/tests/test-file-lock.js && node dist-tests/tests/test-rate-limiter.js && node dist-tests/tests/test-v3.4.js && node dist-tests/tests/test-backup-manager.js && node dist-tests/tests/test-index-manager.js && node dist-tests/tests/test-wasm-parsers.js",
     "test:ui": "vitest --ui",
     "test:run": "vitest run",