lexic-mcp 0.1.0

package/dist/utils/errors.js

@@ -0,0 +1,48 @@
+/**
+ * Error Types
+ *
+ * See .claude/specs/IMPLEMENTATION.md Section 3
+ */
+export class LexicApiError extends Error {
+    statusCode;
+    correlationId;
+    constructor(message, statusCode, correlationId) {
+        super(message);
+        this.statusCode = statusCode;
+        this.correlationId = correlationId;
+        this.name = 'LexicApiError';
+    }
+}
+export class AuthenticationError extends LexicApiError {
+    constructor(message, correlationId) {
+        super(message, 401, correlationId);
+        this.name = 'AuthenticationError';
+    }
+}
+export class AuthorizationError extends LexicApiError {
+    constructor(message, correlationId) {
+        super(message, 403, correlationId);
+        this.name = 'AuthorizationError';
+    }
+}
+export class NotFoundError extends LexicApiError {
+    constructor(message, correlationId) {
+        super(message, 404, correlationId);
+        this.name = 'NotFoundError';
+    }
+}
+export class RateLimitError extends LexicApiError {
+    retryAfter;
+    constructor(message, correlationId, retryAfter) {
+        super(message, 429, correlationId);
+        this.retryAfter = retryAfter;
+        this.name = 'RateLimitError';
+    }
+}
+export class ServerError extends LexicApiError {
+    constructor(message, statusCode, correlationId) {
+        super(message, statusCode, correlationId);
+        this.name = 'ServerError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAG7B;IACA;IAHT,YACE,OAAe,EACR,UAAkB,EAClB,aAAsB;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,eAAU,GAAV,UAAU,CAAQ;QAClB,kBAAa,GAAb,aAAa,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,aAAa;IACpD,YAAY,OAAe,EAAE,aAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAe,EAAE,aAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,aAAa;IAC9C,YAAY,OAAe,EAAE,aAAsB;QACjD,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,aAAa;IAItC;IAHT,YACE,OAAe,EACf,aAAsB,EACf,UAAmB;QAE1B,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QAF5B,eAAU,GAAV,UAAU,CAAS;QAG1B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,aAAa;IAC5C,YAAY,OAAe,EAAE,UAAkB,EAAE,aAAsB;QACrE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Structured Logger
+ *
+ * Logs to stderr (MCP uses stdout for protocol)
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+declare class Logger {
+    private level;
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+    private shouldLog;
+    private format;
+    debug(message: string, data?: Record<string, unknown>): void;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AASpD,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAoB;IAEjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAM/B,QAAQ,IAAI,QAAQ;IAIpB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,MAAM;IAiBd,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAK7D;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,63 @@
+/**
+ * Structured Logger
+ *
+ * Logs to stderr (MCP uses stdout for protocol)
+ */
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3
+};
+class Logger {
+    level = 'info';
+    setLevel(level) {
+        if (LOG_LEVELS[level] !== undefined) {
+            this.level = level;
+        }
+    }
+    getLevel() {
+        return this.level;
+    }
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
+    }
+    format(level, message, data) {
+        const timestamp = new Date().toISOString();
+        const base = `[${timestamp}] [${level.toUpperCase()}] ${message}`;
+        if (data) {
+            // Redact sensitive fields
+            const safeData = { ...data };
+            if ('pat' in safeData)
+                safeData.pat = '[REDACTED]';
+            if ('token' in safeData)
+                safeData.token = '[REDACTED]';
+            if ('authorization' in safeData)
+                safeData.authorization = '[REDACTED]';
+            return `${base} ${JSON.stringify(safeData)}`;
+        }
+        return base;
+    }
+    debug(message, data) {
+        if (this.shouldLog('debug')) {
+            console.error(this.format('debug', message, data));
+        }
+    }
+    info(message, data) {
+        if (this.shouldLog('info')) {
+            console.error(this.format('info', message, data));
+        }
+    }
+    warn(message, data) {
+        if (this.shouldLog('warn')) {
+            console.error(this.format('warn', message, data));
+        }
+    }
+    error(message, data) {
+        if (this.shouldLog('error')) {
+            console.error(this.format('error', message, data));
+        }
+    }
+}
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,GAA6B;IAC3C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,MAAM,MAAM;IACF,KAAK,GAAa,MAAM,CAAC;IAEjC,QAAQ,CAAC,KAAe;QACtB,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAEO,MAAM,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B;QAC7E,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;QAElE,IAAI,IAAI,EAAE,CAAC;YACT,0BAA0B;YAC1B,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YAC7B,IAAI,KAAK,IAAI,QAAQ;gBAAE,QAAQ,CAAC,GAAG,GAAG,YAAY,CAAC;YACnD,IAAI,OAAO,IAAI,QAAQ;gBAAE,QAAQ,CAAC,KAAK,GAAG,YAAY,CAAC;YACvD,IAAI,eAAe,IAAI,QAAQ;gBAAE,QAAQ,CAAC,aAAa,GAAG,YAAY,CAAC;YAEvE,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/C,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "lexic-mcp",
+  "version": "0.1.0",
+  "description": "MCP server connecting Claude Code to Lexic knowledge management",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "lexic-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && npm run build:domains",
+    "build:domains": "tsc -p domains/tsconfig.json",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "lexic",
+    "claude",
+    "knowledge-management",
+    "ai-development"
+  ],
+  "author": "Parul Bhargava <parulb@lexic.io>",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@typescript-eslint/eslint-plugin": "^6.13.0",
+    "@typescript-eslint/parser": "^6.13.0",
+    "eslint": "^8.55.0",
+    "prettier": "^3.1.0",
+    "rimraf": "^5.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.0.17"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ]
+}

package/templates/README.md

@@ -0,0 +1,12 @@
+# Templates
+
+This folder is empty. Templates now live within each domain:
+
+```
+domains/
+└── development/
+    └── templates/
+        └── decision.md
+```
+
+Each domain is self-contained with its own templates.