@jagilber-org/index-server 1.28.2 → 1.28.4

package/dist/services/mcpConfig/paths.d.ts

@@ -0,0 +1,18 @@
+export type McpClientTarget = 'vscode' | 'copilot-cli' | 'claude';
+export type McpConfigFormat = 'vscode' | 'vscode-global' | 'copilot-cli' | 'claude';
+export type McpScope = 'repo' | 'global';
+export interface ResolveTargetOptions {
+    targets?: McpClientTarget[];
+    target?: McpClientTarget;
+    scope?: McpScope;
+    root?: string;
+    home?: string;
+    appData?: string;
+}
+export interface McpTargetInfo {
+    target: McpClientTarget;
+    format: McpConfigFormat;
+    path: string;
+}
+export declare function defaultConfigRoot(): string;
+export declare function resolveConfigTargets(options?: ResolveTargetOptions): McpTargetInfo[];

package/dist/services/mcpConfig/paths.js

@@ -0,0 +1,50 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultConfigRoot = defaultConfigRoot;
+exports.resolveConfigTargets = resolveConfigTargets;
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+function envValue(key) {
+    const value = process.env[key];
+    return value && value.length > 0 ? value : undefined;
+}
+function defaultConfigRoot() {
+    return path_1.default.resolve(envValue('INDEX_SERVER_MCP_CONFIG_ROOT') ?? process.cwd());
+}
+function resolveConfigTargets(options = {}) {
+    const pathApi = process.platform === 'win32' ? path_1.default.win32 : path_1.default.posix;
+    const root = pathApi.resolve(options.root ?? defaultConfigRoot());
+    const scope = options.scope ?? 'repo';
+    const home = options.home ?? os_1.default.homedir();
+    const appData = options.appData ?? envValue('APPDATA') ?? pathApi.join(home, 'AppData', 'Roaming');
+    const targets = options.targets ?? (options.target ? [options.target] : ['vscode']);
+    const isWin = process.platform === 'win32';
+    const isMac = process.platform === 'darwin';
+    const results = [];
+    for (const target of targets) {
+        if (target === 'vscode') {
+            if (scope === 'global') {
+                const dir = isWin ? pathApi.join(appData, 'Code', 'User') : pathApi.join(home, '.config', 'Code', 'User');
+                results.push({ target, format: 'vscode-global', path: pathApi.join(dir, 'mcp.json') });
+            }
+            else {
+                results.push({ target, format: 'vscode', path: pathApi.join(root, '.vscode', 'mcp.json') });
+            }
+        }
+        else if (target === 'copilot-cli') {
+            results.push({ target, format: 'copilot-cli', path: pathApi.join(home, '.copilot', 'mcp-config.json') });
+        }
+        else if (target === 'claude') {
+            const dir = isWin
+                ? pathApi.join(appData, 'Claude')
+                : isMac
+                    ? pathApi.join(home, 'Library', 'Application Support', 'Claude')
+                    : pathApi.join(home, '.config', 'Claude');
+            results.push({ target, format: 'claude', path: pathApi.join(dir, 'claude_desktop_config.json') });
+        }
+    }
+    return results;
+}

package/dist/services/mcpConfig/validate.d.ts

@@ -0,0 +1,7 @@
+import type { McpConfigFormat } from './paths';
+export interface ValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+export declare function validateConfigObject(format: McpConfigFormat, config: Record<string, unknown>): ValidationResult;
+export declare function assertValidConfigObject(format: McpConfigFormat, config: Record<string, unknown>, phase: string): void;

package/dist/services/mcpConfig/validate.js

@@ -0,0 +1,62 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateConfigObject = validateConfigObject;
+exports.assertValidConfigObject = assertValidConfigObject;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const ajv_1 = __importDefault(require("ajv"));
+const ajv_formats_1 = __importDefault(require("ajv-formats"));
+const flagCatalog_1 = require("./flagCatalog");
+const formats_1 = require("./formats");
+function schemaRoot() {
+    return path_1.default.resolve(__dirname, '..', '..', '..', 'schemas');
+}
+function schemaPathForFormat(format) {
+    if (format === 'vscode' || format === 'vscode-global')
+        return path_1.default.join(schemaRoot(), 'mcp.vscode.schema.json');
+    if (format === 'copilot-cli')
+        return path_1.default.join(schemaRoot(), 'mcp.copilot-cli.schema.json');
+    return path_1.default.join(schemaRoot(), 'mcp.claude.schema.json');
+}
+function loadJson(filePath) {
+    return JSON.parse(fs_1.default.readFileSync(filePath, 'utf8'));
+}
+function createAjv() {
+    const ajv = new ajv_1.default({ allErrors: true, strict: false });
+    (0, ajv_formats_1.default)(ajv);
+    ajv.addSchema(loadJson(path_1.default.join(schemaRoot(), 'mcp.indexServerEnv.schema.json')), 'mcp.indexServerEnv.schema.json');
+    return ajv;
+}
+function collectAjvErrors(validate) {
+    return (validate.errors ?? []).map((error) => `${error.instancePath || '/'} ${error.message ?? 'failed validation'}`);
+}
+function validateConfigObject(format, config) {
+    const ajv = createAjv();
+    const schema = loadJson(schemaPathForFormat(format));
+    const validate = ajv.compile(schema);
+    const valid = validate(config);
+    const errors = valid ? [] : collectAjvErrors(validate);
+    try {
+        for (const entry of Object.values((0, formats_1.getServerMap)(config, format))) {
+            if (!entry.env)
+                continue;
+            for (const key of Object.keys(entry.env)) {
+                if (key.startsWith('INDEX_SERVER_') && !flagCatalog_1.DOCUMENTED_INDEX_SERVER_FLAGS.includes(key)) {
+                    errors.push(`env contains unsupported INDEX_SERVER key: ${key}`);
+                }
+            }
+        }
+    }
+    catch (error) {
+        errors.push(error instanceof Error ? error.message : String(error));
+    }
+    return { ok: errors.length === 0, errors };
+}
+function assertValidConfigObject(format, config, phase) {
+    const result = validateConfigObject(format, config);
+    if (!result.ok)
+        throw new Error(`MCP config validation failed during ${phase}: ${result.errors.join('; ')}`);
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@jagilber-org/index-server",
-  "version": "1.28.2",
+  "version": "1.28.4",
   "mcpName": "io.github.jagilber-org/index-server",
   "description": "MCP instruction indexing server with search, CRUD, validation, and cross-repo knowledge promotion.",
   "publishConfig": {
-    "registry": "https://registry.npmjs.org/",
+    "registry": "https://npm.pkg.github.com",
     "access": "public"
   },
   "type": "commonjs",
@@ -134,6 +134,7 @@
     "ajv-formats": "^2.1.1",
     "express": "^5.2.1",
     "express-rate-limit": "^8.3.2",
+    "jsonc-parser": "^3.3.1",
     "safe-regex2": "^5.1.1",
     "sqlite-vec": "0.1.9",
     "ws": "^8.19.0",

package/schemas/mcp.claude.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "mcp.claude.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["mcpServers"],
+  "properties": {
+    "mcpServers": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["command", "args"],
+        "properties": {
+          "type": { "type": "string" },
+          "command": { "type": "string", "minLength": 1 },
+          "args": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+          "cwd": { "type": "string" },
+          "env": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/mcp.copilot-cli.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "mcp.copilot-cli.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["mcpServers"],
+  "properties": {
+    "mcpServers": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["command", "args"],
+        "properties": {
+          "type": { "type": "string" },
+          "command": { "type": "string", "minLength": 1 },
+          "args": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+          "cwd": { "type": "string" },
+          "tools": { "type": "array", "items": { "type": "string" } },
+          "env": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/mcp.indexServerEnv.schema.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "mcp.indexServerEnv.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "patternProperties": {
+    "^INDEX_SERVER_[A-Z0-9_]+$": { "type": "string" }
+  }
+}

package/schemas/mcp.vscode.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "mcp.vscode.schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["servers"],
+  "properties": {
+    "servers": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["type", "command", "args"],
+        "properties": {
+          "type": { "const": "stdio" },
+          "command": { "type": "string", "minLength": 1 },
+          "args": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+          "cwd": { "type": "string" },
+          "env": {
+            "type": "object",
+            "additionalProperties": { "type": "string" }
+          }
+        }
+      }
+    },
+    "inputs": { "type": "array" }
+  }
+}