@papyruslabsai/seshat-mcp 0.1.0 → 0.3.0

package/dist/tools/index.js

@@ -3,28 +3,51 @@
  *
  * Each tool exposes a dimension or computation over the 9D JSTF-T coordinate space.
  * Tools operate on the in-memory entity bundle loaded from .seshat/_bundle.json.
+ *
+ * Multi-project: when multiple projects are loaded, each tool accepts an optional
+ * `project` parameter. In multi-project mode, `project` is required.
  */
 import { buildCallGraph, computeBlastRadius } from '../graph.js';
 // Lazy-initialized shared state
 let loader;
-let graph = null;
-export function initTools(bundleLoader) {
-    loader = bundleLoader;
-    graph = null; // Reset graph cache when loader changes
+let graphCache = new Map();
+export function initTools(multiLoader) {
+    loader = multiLoader;
+    graphCache = new Map();
+}
+export function getLoader() {
+    return loader;
+}
+export function getGraph(project) {
+    const key = project || '__default__';
+    if (!graphCache.has(key)) {
+        graphCache.set(key, buildCallGraph(loader.getEntities(project)));
+    }
+    return graphCache.get(key);
 }
-function getGraph() {
-    if (!graph) {
-        graph = buildCallGraph(loader.getEntities());
+/**
+ * Validate project param. Returns error string if invalid, null if OK.
+ * In single-project mode, project is optional (defaults to the only project).
+ * In multi-project mode, project is required.
+ */
+export function validateProject(project) {
+    if (!loader.isMultiProject())
+        return null; // single project, always OK
+    if (!project) {
+        return `Multiple projects loaded. You must specify a "project" parameter. Available: ${loader.getProjectNames().join(', ')}`;
+    }
+    if (!loader.hasProject(project)) {
+        return `Project "${project}" not found. Available: ${loader.getProjectNames().join(', ')}`;
     }
-    return graph;
+    return null;
 }
 // ─── Helper: Extract entity name from struct ─────────────────────
-function entityName(e) {
+export function entityName(e) {
     if (typeof e.struct === 'string')
         return e.struct;
     return e.struct?.name || e.id || 'anonymous';
 }
-function entityLayer(e) {
+export function entityLayer(e) {
     // Use explicit layer if specific enough
     const explicit = e.context?.layer?.toLowerCase();
     if (explicit && explicit !== 'module' && explicit !== 'unknown')
@@ -55,11 +78,12 @@ function entityLayer(e) {
         return 'test';
     return explicit || 'other';
 }
-function entitySummary(e) {
+export function entitySummary(e) {
     const constraintTags = normalizeConstraints(e.constraints);
     return {
         id: e.id,
         name: entityName(e),
+        ...(e._project ? { project: e._project } : {}),
         layer: entityLayer(e),
         module: e.context?.module || null,
         sourceFile: e._sourceFile || null,
@@ -70,7 +94,7 @@ function entitySummary(e) {
         callCount: Array.isArray(e.edges?.calls) ? e.edges.calls.length : 0,
     };
 }
-function normalizeConstraints(constraints) {
+export function normalizeConstraints(constraints) {
     if (!constraints)
         return [];
     if (Array.isArray(constraints))
@@ -124,7 +148,7 @@ function normalizeConstraints(constraints) {
  * Deep search constraints — matches against raw constraint object fields too,
  * not just normalized tags.
  */
-function constraintMatches(constraints, target) {
+export function constraintMatches(constraints, target) {
     // First check normalized tags
     const tags = normalizeConstraints(constraints);
     if (tags.some(t => t.toUpperCase().includes(target.toUpperCase())))
@@ -139,8 +163,11 @@ function constraintMatches(constraints, target) {
 }
 // ─── Tool: query_entities ─────────────────────────────────────────
 export function queryEntities(args) {
+    const projErr = validateProject(args.project);
+    if (projErr)
+        return { error: projErr };
     const { query, layer, module, language, limit = 50 } = args;
-    let results = loader.getEntities();
+    let results = loader.getEntities(args.project);
     if (layer) {
         results = results.filter(e => entityLayer(e).toLowerCase() === layer.toLowerCase());
     }
@@ -170,7 +197,10 @@ export function queryEntities(args) {
 }
 // ─── Tool: get_entity ─────────────────────────────────────────────
 export function getEntity(args) {
-    const entity = loader.getEntityById(args.id) || loader.getEntityByName(args.id);
+    const projErr = validateProject(args.project);
+    if (projErr)
+        return { error: projErr };
+    const entity = loader.getEntityById(args.id, args.project) || loader.getEntityByName(args.id, args.project);
     if (!entity) {
         return { error: `Entity not found: ${args.id}` };
     }
@@ -178,6 +208,7 @@ export function getEntity(args) {
     return {
         id: entity.id,
         name: entityName(entity),
+        ...(entity._project ? { project: entity._project } : {}),
         sourceFile: entity._sourceFile,
         sourceLanguage: entity._sourceLanguage,
         jstfFilename: entity._jstfFilename,
@@ -196,9 +227,12 @@ export function getEntity(args) {
 }
 // ─── Tool: get_dependencies ───────────────────────────────────────
 export function getDependencies(args) {
+    const projErr = validateProject(args.project);
+    if (projErr)
+        return { error: projErr };
     const { entity_id, direction = 'both', depth = 2 } = args;
-    const g = getGraph();
-    const entity = loader.getEntityById(entity_id) || loader.getEntityByName(entity_id);
+    const g = getGraph(args.project);
+    const entity = loader.getEntityById(entity_id, args.project) || loader.getEntityByName(entity_id, args.project);
     if (!entity) {
         return { error: `Entity not found: ${entity_id}` };
     }
@@ -226,7 +260,7 @@ export function getDependencies(args) {
     }
     return result;
 }
-function collectTransitive(adjacency, startId, maxDepth) {
+export function collectTransitive(adjacency, startId, maxDepth) {
     const visited = new Set();
     const queue = [[startId, 0]];
     visited.add(startId);
@@ -249,7 +283,10 @@ function collectTransitive(adjacency, startId, maxDepth) {
 }
 // ─── Tool: get_data_flow ──────────────────────────────────────────
 export function getDataFlow(args) {
-    const entity = loader.getEntityById(args.entity_id) || loader.getEntityByName(args.entity_id);
+    const projErr = validateProject(args.project);
+    if (projErr)
+        return { error: projErr };
+    const entity = loader.getEntityById(args.entity_id, args.project) || loader.getEntityByName(args.entity_id, args.project);
     if (!entity) {
         return { error: `Entity not found: ${args.entity_id}` };
     }
@@ -262,8 +299,11 @@ export function getDataFlow(args) {
 }
 // ─── Tool: find_by_constraint ─────────────────────────────────────
 export function findByConstraint(args) {
+    const projErr = validateProject(args.project);
+    if (projErr)
+        return { error: projErr };
     const target = args.constraint;
-    const results = loader.getEntities().filter(e => constraintMatches(e.constraints, target));
+    const results = loader.getEntities(args.project).filter(e => constraintMatches(e.constraints, target));
     return {
         constraint: args.constraint,
         total: results.length,
@@ -272,12 +312,15 @@ export function findByConstraint(args) {
 }
 // ─── Tool: get_blast_radius ───────────────────────────────────────
 export function getBlastRadius(args) {
-    const g = getGraph();
+    const projErr = validateProject(args.project);
+    if (projErr)
+        return { error: projErr };
+    const g = getGraph(args.project);
     // Resolve names to IDs
     const resolvedIds = new Set();
     const notFound = [];
     for (const nameOrId of args.entity_ids) {
-        const entity = loader.getEntityById(nameOrId) || loader.getEntityByName(nameOrId);
+        const entity = loader.getEntityById(nameOrId, args.project) || loader.getEntityByName(nameOrId, args.project);
         if (entity) {
             resolvedIds.add(entity.id);
         }
@@ -306,8 +349,11 @@ export function getBlastRadius(args) {
 }
 // ─── Tool: list_modules ───────────────────────────────────────────
 export function listModules(args) {
+    const projErr = validateProject(args.project);
+    if (projErr)
+        return { error: projErr };
     const { group_by = 'layer' } = args;
-    const entities = loader.getEntities();
+    const entities = loader.getEntities(args.project);
     const groups = new Map();
     for (const e of entities) {
         let key;
@@ -339,8 +385,11 @@ export function listModules(args) {
     };
 }
 // ─── Tool: get_topology ───────────────────────────────────────────
-export function getTopology() {
-    const topology = loader.getTopology();
+export function getTopology(args) {
+    const projErr = validateProject(args?.project);
+    if (projErr)
+        return { error: projErr };
+    const topology = loader.getTopology(args?.project);
     if (!topology) {
         return { error: 'No topology data found. The _topology.json file may not have been generated.' };
     }

package/dist/types.d.ts

@@ -11,6 +11,7 @@ export interface JstfEntity {
     _jstfFilename?: string;
     _sourceFile?: string | null;
     _sourceLanguage?: string;
+    _project?: string;
     /** σ — Structure: function shape, signature, modifiers */
     struct?: {
         name?: string;
@@ -55,6 +56,7 @@ export interface JstfEntity {
             target: string;
             operation?: string;
         }>;
+        tables?: string[];
         sources?: unknown[];
         returns?: unknown[];
         [key: string]: unknown;
@@ -67,14 +69,27 @@ export interface JstfEntity {
             field: string;
             rule: string;
         }>;
+        auth?: string[] | 'none';
+        authRequired?: boolean;
+        purity?: string;
+        throws?: boolean;
+        sideEffects?: string[];
+        errorHandling?: {
+            tryCatch?: boolean;
+            catchClause?: boolean;
+            finally?: boolean;
+            errorBoundary?: boolean;
+        };
         [key: string]: unknown;
     } | string[];
     /** χ — Context: architectural position, visibility, layer */
     context?: {
         layer?: string;
+        layerSource?: string;
         module?: string;
         path?: string;
         exposure?: string;
+        visibility?: string;
         traffic?: string;
         criticality?: string;
         [key: string]: unknown;
@@ -82,7 +97,18 @@ export interface JstfEntity {
     /** λ — Ownership: memory ownership, lifetimes, borrowing */
     ownership?: Record<string, unknown>;
     /** τ — Traits: type capabilities, bounds, markers */
-    traits?: string[] | Record<string, unknown>;
+    traits?: string[] | {
+        self?: {
+            asyncContext?: boolean;
+            fallible?: boolean;
+            [key: string]: unknown;
+        };
+        params?: Record<string, {
+            bounds?: string[];
+            markers?: string[];
+        }>;
+        [key: string]: unknown;
+    };
     /** ρ — Runtime: reactive model, async platform, framework */
     runtime?: {
         async?: string;
@@ -120,3 +146,12 @@ export interface Manifest {
     languages: string[];
     layers: Record<string, number>;
 }
+export interface ProjectInfo {
+    name: string;
+    path: string;
+    entityCount: number;
+    languages: string[];
+    commitSha: string;
+    extractedAt: string;
+    layers: Record<string, number>;
+}

package/package.json

@@ -1,35 +1,35 @@
-{
-  "name": "@papyruslabsai/seshat-mcp",
-  "version": "0.1.0",
-  "description": "Semantic MCP server — exposes a codebase's 9D JSTF-T coordinate space as queryable tools",
-  "type": "module",
-  "bin": {
-    "seshat-mcp": "./dist/index.js"
-  },
-  "main": "./dist/index.js",
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "start": "node dist/index.js"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1"
-  },
-  "devDependencies": {
-    "typescript": "^5.5.0",
-    "@types/node": "^20.0.0"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "files": [
-    "dist/"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/papyruslabs-ai/seshat.git",
-    "directory": "packages/seshat-mcp"
-  },
-  "keywords": ["mcp", "jstf", "semantic", "code-analysis", "seshat"],
-  "license": "MIT"
-}
+{
+  "name": "@papyruslabsai/seshat-mcp",
+  "version": "0.3.0",
+  "description": "Semantic MCP server — exposes a codebase's 9D JSTF-T coordinate space as queryable tools",
+  "type": "module",
+  "bin": {
+    "seshat-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/node": "^20.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/papyruslabs-ai/seshat.git",
+    "directory": "packages/seshat-mcp"
+  },
+  "keywords": ["mcp", "jstf", "semantic", "code-analysis", "seshat"],
+  "license": "MIT"
+}