projax 3.3.51 → 3.3.52

package/README.md

@@ -107,79 +107,6 @@ The API server automatically finds an available port in the range 38124-38133. T
 **API Endpoints:**
 See [packages/api/README.md](packages/api/README.md) for complete API documentation.
 
-## MCP Server - AI Context Integration
-
-**PROJAX MCP Server** provides project and workspace context to AI tools like Cursor and VS Code through the Model Context Protocol (MCP). This enables AI assistants to understand your project structure and relationships.
-
-### 🎯 What is MCP?
-
-The Model Context Protocol is an open standard that lets AI tools access contextual information from your development environment. The PROJAX MCP server exposes:
-
-- **Current Project Context**: Name, path, framework, tags, and git branch
-- **Linked Projects**: Other projects in the same workspace
-- **Workspace Metadata**: Workspace descriptions and relationships
-
-### 📦 Configuration
-
-The MCP server is included with PROJAX. Configure it in your editor:
-
-#### Cursor Configuration
-
-Add to `~/.cursor/mcp.json`:
-```json
-{
-  "mcpServers": {
-    "projax": {
-      "command": "prx",
-      "args": ["mcp"]
-    }
-  }
-}
-```
-
-#### VS Code Configuration
-
-Add to `settings.json`:
-```json
-{
-  "mcp.servers": {
-    "projax": {
-      "command": "prx",
-      "args": ["mcp"]
-    }
-  }
-}
-```
-
-### 💡 Usage
-
-Once configured, AI assistants automatically receive context about:
-- Your current project when working in any registered PROJAX project
-- Related projects in the same workspace
-- Project metadata (framework, tags, descriptions)
-
-**Example**: If you're working in a frontend project that's part of a workspace with backend and mobile projects, the AI assistant will know about all three projects and can provide context-aware suggestions.
-
-### ⚙️ Commands
-
-```bash
-# Display MCP configuration for copy/paste
-prx mcp-config
-
-# Show Cursor-specific configuration
-prx mcp-config --cursor
-
-# Show VS Code-specific configuration
-prx mcp-config --vscode
-
-# View configuration in Desktop app
-# Settings → MCP Server
-```
-
-### 📚 Documentation
-
-For detailed documentation, see [packages/mcp-server/README.md](packages/mcp-server/README.md)
-
 ## Usage
 
 ### CLI Commands

package/coverage/core-bridge.ts.html

@@ -124,7 +124,17 @@
 <a name='L59'></a><a href='#L59'>59</a>
 <a name='L60'></a><a href='#L60'>60</a>
 <a name='L61'></a><a href='#L61'>61</a>
-<a name='L62'></a><a href='#L62'>62</a></td><td class="line-coverage quiet"><span class="cline-any cline-no">&nbsp;</span>
+<a name='L62'></a><a href='#L62'>62</a>
+<a name='L63'></a><a href='#L63'>63</a>
+<a name='L64'></a><a href='#L64'>64</a>
+<a name='L65'></a><a href='#L65'>65</a>
+<a name='L66'></a><a href='#L66'>66</a>
+<a name='L67'></a><a href='#L67'>67</a>
+<a name='L68'></a><a href='#L68'>68</a>
+<a name='L69'></a><a href='#L69'>69</a></td><td class="line-coverage quiet"><span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -151,6 +161,10 @@
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -187,6 +201,9 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js"><span class="cstat-no" title="statement not covered" >import * as path from 'path';</span>
 &nbsp;
+// NOTE: projax-core is a workspace alias (not an npm scoped package)
+// pnpm resolves this via the "workspace:*" dependency in package.json
+// to the local packages/core package
 type CoreModule = typeof import('projax-core');
 &nbsp;
 let cachedCore: CoreModule | null = <span class="cstat-no" title="statement not covered" >null;</span>
@@ -212,6 +229,10 @@ function <span class="fstat-no" title="function not covered" >loadCore(</span>):
 <span class="cstat-no" title="statement not covered" >    return cachedCore;</span>
   }
 &nbsp;
+  // Try multiple locations to find the projax-core module
+  // 1. Local dist/core (copied during build)
+  // 2. Workspace root packages/core/dist (development)
+  // 3. Workspace alias 'projax-core' (resolved by pnpm via workspace:*)
   const candidates = <span class="cstat-no" title="statement not covered" >[</span>
     path.join(__dirname, 'core', 'index.js'),
     path.join(__dirname, 'core'),
@@ -219,7 +240,7 @@ function <span class="fstat-no" title="function not covered" >loadCore(</span>):
     path.join(__dirname, '..', 'core', 'dist'),
     path.join(__dirname, '..', '..', 'core', 'dist', 'index.js'),
     path.join(__dirname, '..', '..', 'core', 'dist'),
-    'projax-core',
+    'projax-core', // Workspace alias - pnpm resolves this to packages/core
   ];
 &nbsp;
 <span class="cstat-no" title="statement not covered" >  for (const candidate of candidates) {</span>
@@ -253,7 +274,7 @@ export type { Project, Test, ProjectPort } from 'projax-core';
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-11-20T01:55:35.207Z
+                at 2026-01-08T01:22:23.536Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/index.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">20.86% </span>
+                <span class="strong">17.96% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>154/738</span>
+                <span class='fraction'>154/857</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">16.88% </span>
+                <span class="strong">13% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>39/231</span>
+                <span class='fraction'>39/300</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">25.39% </span>
+                <span class="strong">20.77% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>16/63</span>
+                <span class='fraction'>16/77</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">21.11% </span>
+                <span class="strong">18.19% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>151/715</span>
+                <span class='fraction'>151/830</span>
             </div>
         
             
@@ -140,17 +140,32 @@
 
 <tr>
 	<td class="file low" data-value="script-runner.ts"><a href="script-runner.ts.html">script-runner.ts</a></td>
-	<td data-value="27.23" class="pic low">
-	<div class="chart"><div class="cover-fill" style="width: 27%"></div><div class="cover-empty" style="width: 73%"></div></div>
+	<td data-value="25" class="pic low">
+	<div class="chart"><div class="cover-fill" style="width: 25%"></div><div class="cover-empty" style="width: 75%"></div></div>
 	</td>
-	<td data-value="27.23" class="pct low">27.23%</td>
-	<td data-value="448" class="abs low">122/448</td>
-	<td data-value="23.62" class="pct low">23.62%</td>
-	<td data-value="127" class="abs low">30/127</td>
-	<td data-value="29.54" class="pct low">29.54%</td>
-	<td data-value="44" class="abs low">13/44</td>
-	<td data-value="27.33" class="pct low">27.33%</td>
-	<td data-value="439" class="abs low">120/439</td>
+	<td data-value="25" class="pct low">25%</td>
+	<td data-value="488" class="abs low">122/488</td>
+	<td data-value="21.89" class="pct low">21.89%</td>
+	<td data-value="137" class="abs low">30/137</td>
+	<td data-value="26" class="pct low">26%</td>
+	<td data-value="50" class="abs low">13/50</td>
+	<td data-value="25.21" class="pct low">25.21%</td>
+	<td data-value="476" class="abs low">120/476</td>
+	</tr>
+
+<tr>
+	<td class="file low" data-value="test-parser.ts"><a href="test-parser.ts.html">test-parser.ts</a></td>
+	<td data-value="0" class="pic low">
+	<div class="chart"><div class="cover-fill" style="width: 0%"></div><div class="cover-empty" style="width: 100%"></div></div>
+	</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="79" class="abs low">0/79</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="59" class="abs low">0/59</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="8" class="abs low">0/8</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="78" class="abs low">0/78</td>
 	</tr>
 
 </tbody>
@@ -161,7 +176,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-11-20T01:55:35.207Z
+                at 2026-01-08T01:22:23.536Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/core-bridge.ts.html

@@ -124,7 +124,17 @@
 <a name='L59'></a><a href='#L59'>59</a>
 <a name='L60'></a><a href='#L60'>60</a>
 <a name='L61'></a><a href='#L61'>61</a>
-<a name='L62'></a><a href='#L62'>62</a></td><td class="line-coverage quiet"><span class="cline-any cline-no">&nbsp;</span>
+<a name='L62'></a><a href='#L62'>62</a>
+<a name='L63'></a><a href='#L63'>63</a>
+<a name='L64'></a><a href='#L64'>64</a>
+<a name='L65'></a><a href='#L65'>65</a>
+<a name='L66'></a><a href='#L66'>66</a>
+<a name='L67'></a><a href='#L67'>67</a>
+<a name='L68'></a><a href='#L68'>68</a>
+<a name='L69'></a><a href='#L69'>69</a></td><td class="line-coverage quiet"><span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -151,6 +161,10 @@
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-no">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -187,6 +201,9 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js"><span class="cstat-no" title="statement not covered" >import * as path from 'path';</span>
 &nbsp;
+// NOTE: projax-core is a workspace alias (not an npm scoped package)
+// pnpm resolves this via the "workspace:*" dependency in package.json
+// to the local packages/core package
 type CoreModule = typeof import('projax-core');
 &nbsp;
 let cachedCore: CoreModule | null = <span class="cstat-no" title="statement not covered" >null;</span>
@@ -212,6 +229,10 @@ function <span class="fstat-no" title="function not covered" >loadCore(</span>):
 <span class="cstat-no" title="statement not covered" >    return cachedCore;</span>
   }
 &nbsp;
+  // Try multiple locations to find the projax-core module
+  // 1. Local dist/core (copied during build)
+  // 2. Workspace root packages/core/dist (development)
+  // 3. Workspace alias 'projax-core' (resolved by pnpm via workspace:*)
   const candidates = <span class="cstat-no" title="statement not covered" >[</span>
     path.join(__dirname, 'core', 'index.js'),
     path.join(__dirname, 'core'),
@@ -219,7 +240,7 @@ function <span class="fstat-no" title="function not covered" >loadCore(</span>):
     path.join(__dirname, '..', 'core', 'dist'),
     path.join(__dirname, '..', '..', 'core', 'dist', 'index.js'),
     path.join(__dirname, '..', '..', 'core', 'dist'),
-    'projax-core',
+    'projax-core', // Workspace alias - pnpm resolves this to packages/core
   ];
 &nbsp;
 <span class="cstat-no" title="statement not covered" >  for (const candidate of candidates) {</span>
@@ -253,7 +274,7 @@ export type { Project, Test, ProjectPort } from 'projax-core';
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-11-20T01:55:35.186Z
+                at 2026-01-08T01:22:23.516Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/index.html

@@ -23,30 +23,30 @@
         <div class='clearfix'>
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">20.86% </span>
+                <span class="strong">17.96% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>154/738</span>
+                <span class='fraction'>154/857</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">16.88% </span>
+                <span class="strong">13% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>39/231</span>
+                <span class='fraction'>39/300</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">25.39% </span>
+                <span class="strong">20.77% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>16/63</span>
+                <span class='fraction'>16/77</span>
             </div>
         
             
             <div class='fl pad1y space-right2'>
-                <span class="strong">21.11% </span>
+                <span class="strong">18.19% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>151/715</span>
+                <span class='fraction'>151/830</span>
             </div>
         
             
@@ -140,17 +140,32 @@
 
 <tr>
 	<td class="file low" data-value="script-runner.ts"><a href="script-runner.ts.html">script-runner.ts</a></td>
-	<td data-value="27.23" class="pic low">
-	<div class="chart"><div class="cover-fill" style="width: 27%"></div><div class="cover-empty" style="width: 73%"></div></div>
+	<td data-value="25" class="pic low">
+	<div class="chart"><div class="cover-fill" style="width: 25%"></div><div class="cover-empty" style="width: 75%"></div></div>
 	</td>
-	<td data-value="27.23" class="pct low">27.23%</td>
-	<td data-value="448" class="abs low">122/448</td>
-	<td data-value="23.62" class="pct low">23.62%</td>
-	<td data-value="127" class="abs low">30/127</td>
-	<td data-value="29.54" class="pct low">29.54%</td>
-	<td data-value="44" class="abs low">13/44</td>
-	<td data-value="27.33" class="pct low">27.33%</td>
-	<td data-value="439" class="abs low">120/439</td>
+	<td data-value="25" class="pct low">25%</td>
+	<td data-value="488" class="abs low">122/488</td>
+	<td data-value="21.89" class="pct low">21.89%</td>
+	<td data-value="137" class="abs low">30/137</td>
+	<td data-value="26" class="pct low">26%</td>
+	<td data-value="50" class="abs low">13/50</td>
+	<td data-value="25.21" class="pct low">25.21%</td>
+	<td data-value="476" class="abs low">120/476</td>
+	</tr>
+
+<tr>
+	<td class="file low" data-value="test-parser.ts"><a href="test-parser.ts.html">test-parser.ts</a></td>
+	<td data-value="0" class="pic low">
+	<div class="chart"><div class="cover-fill" style="width: 0%"></div><div class="cover-empty" style="width: 100%"></div></div>
+	</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="79" class="abs low">0/79</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="59" class="abs low">0/59</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="8" class="abs low">0/8</td>
+	<td data-value="0" class="pct low">0%</td>
+	<td data-value="78" class="abs low">0/78</td>
 	</tr>
 
 </tbody>
@@ -161,7 +176,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-11-20T01:55:35.186Z
+                at 2026-01-08T01:22:23.516Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/port-extractor.ts.html

@@ -1159,7 +1159,7 @@ function <span class="fstat-no" title="function not covered" >extractPortsFromEn
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-11-20T01:55:35.186Z
+                at 2026-01-08T01:22:23.516Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/port-scanner.ts.html

@@ -207,7 +207,7 @@
 <span class="cline-any cline-yes">6x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { getDatabaseManager, Project } from './core-bridge';
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">import { getDatabaseManager, Project, ProjectPort } from './core-bridge';
 import { extractPortsFromProject, PortInfo } from './port-extractor';
 import * as fs from 'fs';
 &nbsp;
@@ -274,7 +274,7 @@ export function shouldRescanPorts(projectId: number): boolean {
 &nbsp;
   // Check if any port was detected 24 hours ago or older
   const twentyFourHoursAgo = Math.floor(Date.now() / 1000) - (24 * 60 * 60);
-  const needsRescan = ports.some(port =&gt; (port.last_detected || <span class="branch-1 cbranch-no" title="branch not covered" >0)</span> &lt;= twentyFourHoursAgo);
+  const needsRescan = ports.some((port: ProjectPort) =&gt; (port.last_detected || <span class="branch-1 cbranch-no" title="branch not covered" >0)</span> &lt;= twentyFourHoursAgo);
 &nbsp;
   return needsRescan;
 }
@@ -286,7 +286,7 @@ export function shouldRescanPorts(projectId: number): boolean {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-11-20T01:55:35.186Z
+                at 2026-01-08T01:22:23.516Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/coverage/lcov-report/port-utils.ts.html

@@ -655,7 +655,7 @@ export function extractPortFromError(error: string): number | null {
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2025-11-20T01:55:35.186Z
+                at 2026-01-08T01:22:23.516Z
             </div>
         <script src="prettify.js"></script>
         <script>