@schemyx/mcp 0.1.8 → 0.1.10

package/README.md

@@ -1,24 +1,17 @@
 # @schemyx/mcp
 
-Local stdio MCP server for reading Schemyx project configs, Theme Forge artifacts, target-stack guidance, and implementation notes.
+Local stdio MCP server for building and reading Schemyx local codebase context.
 
-The server supports both local theme files and hosted Schemyx configs. By default it checks for local files first, then falls back to the hosted Schemyx API.
+This agent-facing MCP exposes only local codebase scan tools. It does not expose saved Schemyx config registry tools, Theme Forge files, or local theme exports, so agents cannot accidentally use config from a different project.
 
 ## Usage
 
-Local files only:
+From the project an agent should work on:
 
 ```bash
-# From a repo that contains ./schemyx-ui-theme/themeforge.json
 npx -y @schemyx/mcp
 ```
 
-Hosted Schemyx:
-
-```bash
-SCHEMYX_API_KEY=skx_live_replace_me npx -y @schemyx/mcp
-```
-
 MCP client config:
 
 ```json
@@ -26,10 +19,7 @@ MCP client config:
   "mcpServers": {
     "schemyx": {
       "command": "npx",
-      "args": ["-y", "@schemyx/mcp@latest"],
-      "env": {
-        "SCHEMYX_API_KEY": "$SCHEMYX_API_KEY"
-      }
+      "args": ["-y", "@schemyx/mcp@latest"]
     }
   }
 }
@@ -37,29 +27,7 @@ MCP client config:
 
 ## Environment
 
-- `SCHEMYX_API_KEY`: Schemyx API key with `mcp:read` or `configs:read`; required only when using hosted configs
-- `SCHEMYX_API_URL`: optional API base URL, defaults to `https://api.schemyx.com`
-- `SCHEMYX_PROJECT_ID`: optional project filter
-- `SCHEMYX_CONFIG_ID`: optional config filter
-- `SCHEMYX_MCP_CACHE_TTL_MS`: optional discovery cache TTL, defaults to `10000`
-- `SCHEMYX_MCP_SOURCE`: optional source mode, `auto`, `local`, or `remote`; defaults to `auto`
-- `SCHEMYX_THEME_DIR`: optional local theme directory containing `themeforge.json`
-- `SCHEMYX_MCP_EXPOSE_SAVED_CONFIG_TOOLS`: set to `true` only for intentional saved Theme Forge/config registry workflows. Defaults to hidden so local codebase generation starts from `schemyx_prepare_task`.
-- `SCHEMYX_MCP_CWD`: optional cwd used for local theme discovery
-
-## Local Theme Discovery
-
-In `auto` mode, the MCP server searches upward from the current working directory and uses the first local theme it finds:
-
-1. `./schemyx-ui-theme/themeforge.json`
-2. `./.schemyx/theme/themeforge.json`
-3. `./themeforge.json`
-
-If none exists, it uses the hosted API.
-
-Local discovery exposes the compact style index (`agent-style-index.json`), agent style contract (`agent-style-contract.json`), standard Theme Forge files, all current target-stack artifacts (`tailwind-theme.css`, `shadcn-globals.css`, `mui-theme.ts`, `chakra-system.ts`, `mantine-theme.ts`, `styled-theme.ts`, `theme.scss`, `tokens.json`, `react-native-theme.ts`), stack helper files placed next to `themeforge.json` such as `components.json` or `tailwind.config.ts`, and any extra safe relative paths listed in `schemyx-theme-bundle.manifest.json`.
-
-For targeted lookup, use `schemyx_list_style_recipes` and `schemyx_get_style_recipe`. Example: `schemyx_get_style_recipe` with `{ "key": "ui.input" }` returns only the input recipe and direct dependencies.
+- `SCHEMYX_MCP_CWD`: optional project root used when a tool call does not pass `rootPath`
 
 ## Local Codebase Scan
 
@@ -100,7 +68,7 @@ For generation or editing, start with `schemyx_prepare_task`:
 
 `schemyx_prepare_task` verifies or creates the local scan, resolves the task context pack, includes required source-backed reads through Schemyx, and returns the no-invention policy agents should follow before writing code.
 
-Saved Theme Forge/config registry tools are hidden by default because they are not local codebase scans. This prevents agents from accidentally using a theme export from a different project when you asked them to build from the current codebase.
+Saved Theme Forge/config registry tools and resources are not exposed by this codebase agent MCP. This prevents agents from accidentally using a theme export from a different project when you asked them to build from the current codebase.
 
 Use `schemyx_scan_codebase` with an explicit scope:
 
@@ -128,7 +96,5 @@ From the backend repo root:
 
 ```bash
 npm run build:mcp
-SCHEMYX_API_URL=http://localhost:3001 \
-SCHEMYX_API_KEY=skx_test_replace_me \
 npm run mcp:local
 ```

package/dist/codebase-scanner/bundle.d.ts

@@ -244,7 +244,7 @@ export declare function createUiGenerationGuidance(kind: string, elements: UiEle
 export declare function summarizeActionUsages(elements: UiElement[]): Array<Record<string, unknown>>;
 export declare function actionVariantNamesForElement(element: UiElement): string[];
 export declare function addUiPatternRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], files: AnalyzedFile[], styleContext?: StyleResolutionContext): void;
-export declare function addUiCompositionRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], files: AnalyzedFile[], styleContext?: StyleResolutionContext): void;
+export declare function addUiCompositionRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], files: AnalyzedFile[], rootPath: string, styleContext?: StyleResolutionContext): void;
 export declare function addGlobalUiContractRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], files: AnalyzedFile[]): void;
 export declare function addConnectedPatternRules(entries: RegistryEntry[], usedKeys: Set<string>, nodes: GraphNode[], edges: GraphEdge[], reviewItems: ReviewItem[], files: AnalyzedFile[], styleContext?: StyleResolutionContext): void;
 export declare function buildConnectedPatternClusters(files: AnalyzedFile[], styleContext?: StyleResolutionContext): ConnectedPatternCluster[];

package/dist/codebase-scanner/bundle.js

@@ -186,14 +186,19 @@ function createBundle(rootPath, projectType, files) {
     const componentStyleContext = createComponentStyleContext(files);
     enrichUiElementsWithComponentStyles(files, componentStyleContext);
     const styleResolutionContext = createStyleResolutionContext(files);
+    const localImportKeysByPath = createLocalImportKeyMap(rootPath, files);
     for (const file of files) {
         const fileSource = sourceInfo('core.files', 'high', [`path:${file.relPath}`], file);
+        const localImportKeys = localImportKeysByPath.get(file.relPath) ?? [];
         addEntry(entries, usedKeys, {
             key: file.key,
             group: 'file',
             summary: file.summary,
             tags: file.tags,
-            dependencies: file.dependencies.map((dependency) => (0, utils_1.toRegistryKey)('dep', dependency)),
+            dependencies: (0, utils_1.unique)([
+                ...file.dependencies.map((dependency) => (0, utils_1.toRegistryKey)('dep', dependency)),
+                ...localImportKeys,
+            ]),
             usedBy: [],
             confidence: 'high',
             status: 'inferred',
@@ -268,6 +273,7 @@ function createBundle(rootPath, projectType, files) {
             const compositionRuleKey = (0, utils_1.toRegistryKey)('rule', `ui.composition.${file.relPath.replace(/\.[^.]+$/, '')}`);
             const dependencies = (0, utils_1.unique)([
                 file.key,
+                ...localImportKeys,
                 ...(hasStyleSurface(file) ? [styleKey] : []),
                 ...(file.uiElements.length ? [compositionRuleKey] : []),
             ]);
@@ -339,6 +345,7 @@ function createBundle(rootPath, projectType, files) {
             const compositionRuleKey = (0, utils_1.toRegistryKey)('rule', `ui.composition.${file.relPath.replace(/\.[^.]+$/, '')}`);
             const dependencies = (0, utils_1.unique)([
                 file.key,
+                ...localImportKeys,
                 ...(hasStyleSurface(file) ? [styleKey] : []),
                 ...(file.uiElements.length ? [compositionRuleKey] : []),
             ]);
@@ -699,7 +706,7 @@ function createBundle(rootPath, projectType, files) {
         }
     }
     addUiPatternRules(entries, usedKeys, nodes, edges, files, styleResolutionContext);
-    addUiCompositionRules(entries, usedKeys, nodes, edges, files, styleResolutionContext);
+    addUiCompositionRules(entries, usedKeys, nodes, edges, files, rootPath, styleResolutionContext);
     addGlobalUiContractRules(entries, usedKeys, nodes, edges, files);
     addConnectedPatternRules(entries, usedKeys, nodes, edges, reviewItems, files, styleResolutionContext);
     addRenderEdges(entries, files, edges);
@@ -739,6 +746,20 @@ function createComponentStyleContext(files) {
     }
     return { byName, byHelper };
 }
+function createLocalImportKeyMap(rootPath, files) {
+    const relPaths = new Set(files.map((file) => file.relPath));
+    const result = new Map();
+    for (const file of files) {
+        const localImportKeys = file.imports
+            .filter(utils_1.isRelativeImport)
+            .map((importValue) => (0, utils_1.resolveImportPath)(file.relPath, importValue, relPaths, rootPath))
+            .filter((targetRelPath) => Boolean(targetRelPath))
+            .filter((targetRelPath) => targetRelPath !== file.relPath)
+            .map((targetRelPath) => (0, utils_1.toRegistryKey)('file', targetRelPath.replace(/\.[^.]+$/, '')));
+        result.set(file.relPath, (0, utils_1.unique)(localImportKeys));
+    }
+    return result;
+}
 function enrichUiElementsWithComponentStyles(files, context) {
     for (const file of files) {
         file.uiElements = file.uiElements.map((element) => enrichUiElementWithComponentStyles(element, context));
@@ -3310,7 +3331,8 @@ function addUiPatternRules(entries, usedKeys, nodes, edges, files, styleContext)
         }
     }
 }
-function addUiCompositionRules(entries, usedKeys, nodes, edges, files, styleContext) {
+function addUiCompositionRules(entries, usedKeys, nodes, edges, files, rootPath, styleContext) {
+    const localImportKeysByPath = createLocalImportKeyMap(rootPath, files);
     for (const file of files) {
         if ((0, extractors_1.isTestFile)(file.relPath)) {
             continue;
@@ -3322,8 +3344,10 @@ function addUiCompositionRules(entries, usedKeys, nodes, edges, files, styleCont
         const styleKey = (0, utils_1.toRegistryKey)('style', file.relPath.replace(/\.[^.]+$/, ''));
         const componentKeys = file.components.map((component) => (0, utils_1.toRegistryKey)('component', component));
         const routeKeys = file.routes.map((route) => (0, utils_1.toRegistryKey)('route', route));
+        const localImportKeys = localImportKeysByPath.get(file.relPath) ?? [];
         const dependencies = (0, utils_1.unique)([
             file.key,
+            ...localImportKeys,
             ...(hasStyleSurface(file) ? [styleKey] : []),
             ...componentKeys,
             ...routeKeys,