cntx-ui 3.1.2 → 3.1.3

package/README.md

@@ -40,6 +40,10 @@ Agents interact through MCP tools or the HTTP API:
 | `agent/query` | Semantic search — "where is auth handled?" |
 | `agent/investigate` | Find integration points for a new feature |
 | `agent/organize` | Audit and optimize bundle structure |
+| `artifacts/list` | List normalized project artifacts (OpenAPI + Navigation) |
+| `artifacts/get_openapi` | Return OpenAPI artifact summary and payload |
+| `artifacts/get_navigation` | Return Navigation artifact summary and payload |
+| `artifacts/summarize` | Compact cross-artifact summary for agents |
 | `list_bundles` | List all bundles with metadata |
 | `get_bundle` | Get full bundle content as XML |
 | `get_semantic_chunks` | Get all analyzed code chunks |
@@ -47,6 +51,11 @@ Agents interact through MCP tools or the HTTP API:
 
 Full tool reference with parameters is generated in `.cntx/AGENT.md` and `.cntx/TOOLS.md`.
 
+Artifact HTTP endpoints:
+- `GET /api/artifacts`
+- `GET /api/artifacts/openapi`
+- `GET /api/artifacts/navigation`
+
 ## How it works
 
 1. **tree-sitter** parses source files into AST, extracts functions/types/interfaces

package/dist/bin/cntx-ui.js

@@ -32,7 +32,7 @@ async function main() {
                 await initConfig();
                 break;
             case 'mcp':
-                await startServer({ withMcp: true, skipFileWatcher: true, skipBundleGeneration: true });
+                await startServer({ withMcp: true, skipFileWatcher: true });
                 break;
             case 'bundle':
                 const bundleName = args[1] || 'master';

package/dist/lib/api-router.js

@@ -106,6 +106,16 @@ export default class APIRouter {
             if (pathname === '/api/mcp-status' && method === 'GET') {
                 return await this.handleGetMcpStatus(req, res);
             }
+            // === Artifact Endpoints ===
+            if (pathname === '/api/artifacts' && method === 'GET') {
+                return await this.handleGetArtifacts(req, res);
+            }
+            if (pathname === '/api/artifacts/openapi' && method === 'GET') {
+                return await this.handleGetArtifact(req, res, 'openapi');
+            }
+            if (pathname === '/api/artifacts/navigation' && method === 'GET') {
+                return await this.handleGetArtifact(req, res, 'navigation');
+            }
             // === Rule Management ===
             if (pathname === '/api/cursor-rules' && method === 'GET') {
                 return await this.handleGetCursorRules(req, res);
@@ -350,6 +360,15 @@ export default class APIRouter {
             message: isRunning ? 'MCP server is running' : 'MCP server integration available'
         });
     }
+    async handleGetArtifacts(req, res) {
+        const artifacts = this.cntxServer.artifactManager.refresh();
+        this.sendResponse(res, 200, { artifacts });
+    }
+    async handleGetArtifact(req, res, type) {
+        this.cntxServer.artifactManager.refresh();
+        const payload = this.cntxServer.artifactManager.getPayload(type);
+        this.sendResponse(res, 200, payload);
+    }
     async handleGetCursorRules(req, res) {
         const filePath = join(this.configManager.CWD, '.cursorrules');
         if (existsSync(filePath)) {

package/dist/lib/artifact-manager.js

@@ -0,0 +1,147 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+export default class ArtifactManager {
+    cwd;
+    records;
+    constructor(cwd) {
+        this.cwd = cwd;
+        this.records = new Map();
+    }
+    refresh() {
+        const openapi = this.resolveOpenApiArtifact();
+        const navigation = this.resolveNavigationArtifact();
+        this.records.set('openapi', openapi);
+        this.records.set('navigation', navigation);
+        return this.list();
+    }
+    list() {
+        if (this.records.size === 0) {
+            this.refresh();
+        }
+        return Array.from(this.records.values());
+    }
+    get(type) {
+        if (!this.records.has(type)) {
+            this.refresh();
+        }
+        return this.records.get(type);
+    }
+    getPayload(type) {
+        const record = this.get(type);
+        if (!record) {
+            return {
+                type,
+                filePath: '',
+                format: 'json',
+                exists: false,
+                summary: {}
+            };
+        }
+        if (!record.exists) {
+            return { ...record };
+        }
+        try {
+            const absolutePath = join(this.cwd, record.filePath);
+            const raw = readFileSync(absolutePath, 'utf8');
+            if (record.format === 'json') {
+                return { ...record, parsed: JSON.parse(raw), raw };
+            }
+            return { ...record, raw };
+        }
+        catch {
+            return { ...record };
+        }
+    }
+    resolveOpenApiArtifact() {
+        const candidates = [
+            { path: 'openapi.json', format: 'json' },
+            { path: 'openapi.yaml', format: 'yaml' },
+            { path: 'openapi.yml', format: 'yaml' }
+        ];
+        for (const candidate of candidates) {
+            const absolutePath = join(this.cwd, candidate.path);
+            if (!existsSync(absolutePath))
+                continue;
+            const summary = this.summarizeOpenApi(absolutePath, candidate.format);
+            return {
+                type: 'openapi',
+                filePath: candidate.path,
+                format: candidate.format,
+                exists: true,
+                summary
+            };
+        }
+        return {
+            type: 'openapi',
+            filePath: 'openapi.json',
+            format: 'json',
+            exists: false,
+            summary: {}
+        };
+    }
+    resolveNavigationArtifact() {
+        const candidates = [
+            { path: 'navigation.manifest.json', format: 'json' },
+            { path: 'navigation.json', format: 'json' }
+        ];
+        for (const candidate of candidates) {
+            const absolutePath = join(this.cwd, candidate.path);
+            if (!existsSync(absolutePath))
+                continue;
+            const summary = this.summarizeNavigation(absolutePath);
+            return {
+                type: 'navigation',
+                filePath: candidate.path,
+                format: candidate.format,
+                exists: true,
+                summary
+            };
+        }
+        return {
+            type: 'navigation',
+            filePath: 'navigation.manifest.json',
+            format: 'json',
+            exists: false,
+            summary: {}
+        };
+    }
+    summarizeOpenApi(absolutePath, format) {
+        try {
+            const raw = readFileSync(absolutePath, 'utf8');
+            if (format === 'json') {
+                const parsed = JSON.parse(raw);
+                const endpointCount = parsed.paths ? Object.keys(parsed.paths).length : 0;
+                return {
+                    title: parsed.info?.title,
+                    version: parsed.info?.version,
+                    endpointCount
+                };
+            }
+            const titleMatch = raw.match(/^\s*title:\s*["']?(.+?)["']?\s*$/m);
+            const versionMatch = raw.match(/^\s*version:\s*["']?(.+?)["']?\s*$/m);
+            return {
+                title: titleMatch?.[1],
+                version: versionMatch?.[1]
+            };
+        }
+        catch {
+            return {};
+        }
+    }
+    summarizeNavigation(absolutePath) {
+        try {
+            const parsed = JSON.parse(readFileSync(absolutePath, 'utf8'));
+            return {
+                title: parsed.project?.name || parsed.name,
+                version: parsed.version ? String(parsed.version) : undefined,
+                routeCount: Array.isArray(parsed.routes) ? parsed.routes.length : 0,
+                stateCount: Array.isArray(parsed.states) ? parsed.states.length : 0,
+                flowCount: Array.isArray(parsed.flows) ? parsed.flows.length : 0,
+                viewportCount: Array.isArray(parsed.viewports) ? parsed.viewports.length : 0
+            };
+        }
+        catch {
+            return {};
+        }
+    }
+}

package/dist/lib/bundle-manager.js

@@ -170,6 +170,10 @@ export default class BundleManager {
         try {
             const fullPath = this.fileSystemManager.fullPath(relativePath);
             const content = readFileSync(fullPath, 'utf8');
+            // Skip files over 100KB in bundle XML to prevent string length crashes
+            if (content.length > 100_000) {
+                return `  <file path="${this.escapeXml(relativePath)}" skipped="too-large" size="${content.length}" />\n`;
+            }
             const chunks = this.db.getChunksByFile(relativePath);
             let xml = `  <file path="${this.escapeXml(relativePath)}">\n`;
             if (chunks.length > 0) {

package/dist/lib/mcp-server.js

@@ -92,6 +92,28 @@ export class MCPServer {
             }
             // Legacy tools mapping
             switch (name) {
+                case 'artifacts/list': {
+                    const artifacts = this.cntxServer.artifactManager.refresh();
+                    return this.createSuccessResponse(id, { content: [{ type: 'text', text: JSON.stringify({ artifacts }, null, 2) }] });
+                }
+                case 'artifacts/get_openapi': {
+                    this.cntxServer.artifactManager.refresh();
+                    const payload = this.cntxServer.artifactManager.getPayload('openapi');
+                    return this.createSuccessResponse(id, { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] });
+                }
+                case 'artifacts/get_navigation': {
+                    this.cntxServer.artifactManager.refresh();
+                    const payload = this.cntxServer.artifactManager.getPayload('navigation');
+                    return this.createSuccessResponse(id, { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] });
+                }
+                case 'artifacts/summarize': {
+                    const artifacts = this.cntxServer.artifactManager.refresh();
+                    const summary = {
+                        openapi: artifacts.find((a) => a.type === 'openapi')?.summary ?? {},
+                        navigation: artifacts.find((a) => a.type === 'navigation')?.summary ?? {}
+                    };
+                    return this.createSuccessResponse(id, { content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }] });
+                }
                 case 'list_bundles':
                     const bundles = this.cntxServer.bundleManager.getAllBundleInfo();
                     return this.createSuccessResponse(id, { content: [{ type: 'text', text: JSON.stringify(bundles, null, 2) }] });
@@ -144,6 +166,26 @@ export class MCPServer {
                 description: 'Investigation Mode: Suggest integration points.',
                 inputSchema: { type: 'object', properties: { feature: { type: 'string' } }, required: ['feature'] }
             },
+            {
+                name: 'artifacts/list',
+                description: 'List normalized project artifacts (OpenAPI and Navigation manifests).',
+                inputSchema: { type: 'object', properties: {} }
+            },
+            {
+                name: 'artifacts/get_openapi',
+                description: 'Get OpenAPI artifact payload (summary + parsed content when JSON).',
+                inputSchema: { type: 'object', properties: {} }
+            },
+            {
+                name: 'artifacts/get_navigation',
+                description: 'Get Navigation artifact payload (summary + parsed manifest).',
+                inputSchema: { type: 'object', properties: {} }
+            },
+            {
+                name: 'artifacts/summarize',
+                description: 'Get compact summaries for OpenAPI and Navigation artifacts.',
+                inputSchema: { type: 'object', properties: {} }
+            },
             {
                 name: 'list_bundles',
                 description: 'List all project bundles.',

package/dist/lib/semantic-splitter.js

@@ -106,6 +106,11 @@ export default class SemanticSplitter {
         if (!existsSync(fullPath))
             return [];
         const content = readFileSync(fullPath, 'utf8');
+        // Skip files larger than 200KB — tree-sitter and embeddings can't handle them well
+        if (content.length > 200_000) {
+            console.warn(`Skipping ${relativePath}: file too large (${Math.round(content.length / 1024)}KB)`);
+            return [];
+        }
         const parser = this.getParser(relativePath);
         const tree = parser.parse(content);
         const root = tree.rootNode;
@@ -394,7 +399,10 @@ export default class SemanticSplitter {
             if (!node)
                 continue;
             if (node.type === 'table' || node.type === 'table_array_element' || node.type === 'pair') {
-                const keyNode = node.childForFieldName('name') || node.childForFieldName('key') || node.namedChild(0);
+                // Legacy parser uses namedChild instead of childForFieldName
+                const keyNode = node.childForFieldName?.('name')
+                    || node.childForFieldName?.('key')
+                    || node.namedChild(0);
                 const name = keyNode ? content.slice(keyNode.startIndex, keyNode.endIndex) : node.type;
                 const structure = this.mapStructureNode(name, node, content, filePath);
                 if (structure.code.length >= this.options.minStructureSize) {

package/dist/lib/simple-vector-store.js

@@ -37,8 +37,9 @@ export default class SimpleVectorStore {
         const existing = this.db.getEmbedding(chunkId);
         if (existing)
             return existing;
-        // Generate new embedding
-        const textToEmbed = `${chunk.name} ${chunk.purpose} ${chunk.code}`;
+        // Generate new embedding — truncate to 8KB to stay within model limits
+        const rawText = `${chunk.name} ${chunk.purpose} ${chunk.code}`;
+        const textToEmbed = rawText.length > 8192 ? rawText.slice(0, 8192) : rawText;
         const embedding = await this.generateEmbedding(textToEmbed);
         // Save to SQLite
         this.db.saveEmbedding(chunkId, embedding, this.modelName);

package/dist/server.js

@@ -13,6 +13,7 @@ import FileSystemManager from './lib/file-system-manager.js';
 import BundleManager from './lib/bundle-manager.js';
 import APIRouter from './lib/api-router.js';
 import WebSocketManager from './lib/websocket-manager.js';
+import ArtifactManager from './lib/artifact-manager.js';
 // Import existing lib modules
 import SemanticSplitter from './lib/semantic-splitter.js';
 import SimpleVectorStore from './lib/simple-vector-store.js';
@@ -47,6 +48,7 @@ export class CntxServer {
     bundleManager;
     webSocketManager;
     apiRouter;
+    artifactManager;
     semanticSplitter;
     vectorStore;
     agentRuntime;
@@ -71,6 +73,7 @@ export class CntxServer {
         this.fileSystemManager = new FileSystemManager(cwd, { verbose: this.verbose });
         this.bundleManager = new BundleManager(this.configManager, this.fileSystemManager, this.verbose);
         this.webSocketManager = new WebSocketManager(this.bundleManager, this.configManager, { verbose: this.verbose });
+        this.artifactManager = new ArtifactManager(cwd);
         // AI Components
         this.semanticSplitter = new SemanticSplitter({
             maxChunkSize: 2000,
@@ -112,6 +115,7 @@ export class CntxServer {
         }
         // Load reasoning/manifest
         await this.agentRuntime.generateAgentManifest();
+        this.artifactManager.refresh();
     }
     startWatching() {
         this.fileSystemManager.startWatching((eventType, filename) => {
@@ -152,14 +156,30 @@ export class CntxServer {
     async enhanceSemanticChunksIfNeeded(analysis) {
         if (!analysis || !analysis.chunks)
             return;
-        if (!this.vectorStoreInitialized) {
-            await this.vectorStore.init();
-            this.vectorStoreInitialized = true;
-        }
-        for (const chunk of analysis.chunks) {
-            if (!this.databaseManager.getEmbedding(chunk.id)) {
-                await this.vectorStore.upsertChunk(chunk);
+        try {
+            if (!this.vectorStoreInitialized) {
+                await this.vectorStore.init();
+                this.vectorStoreInitialized = true;
+            }
+            let embedded = 0;
+            let skipped = 0;
+            for (const chunk of analysis.chunks) {
+                if (!this.databaseManager.getEmbedding(chunk.id)) {
+                    try {
+                        await this.vectorStore.upsertChunk(chunk);
+                        embedded++;
+                    }
+                    catch (e) {
+                        skipped++;
+                    }
+                }
             }
+            if (skipped > 0) {
+                console.warn(`⚠️ Embedded ${embedded} chunks, skipped ${skipped} (too large or invalid)`);
+            }
+        }
+        catch (e) {
+            console.error(`⚠️ Vector embedding failed: ${e.message}. Semantic search will be unavailable.`);
         }
     }
     async refreshSemanticAnalysis() {
@@ -193,7 +213,11 @@ export class CntxServer {
         });
     }
     handleStaticFile(req, res, url) {
-        const webDir = join(__dirname, 'web/dist');
+        let webDir = join(__dirname, 'web', 'dist');
+        if (!existsSync(webDir)) {
+            // Fallback for dist/ context — web/dist is at package root
+            webDir = join(__dirname, '..', 'web', 'dist');
+        }
         let filePath = join(webDir, url.pathname === '/' ? 'index.html' : url.pathname);
         if (!existsSync(filePath)) {
             filePath = join(webDir, 'index.html');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cntx-ui",
   "type": "module",
-  "version": "3.1.2",
+  "version": "3.1.3",
   "description": "Autonomous Repository Intelligence engine with web UI and MCP server. Unified semantic code understanding, local RAG, and agent working memory.",
   "keywords": [
     "repository-intelligence",