lexic-mcp 0.1.0

package/README.md

@@ -0,0 +1,152 @@
+# Lexic MCP Server
+
+An MCP (Model Context Protocol) server that connects Claude Code to [Lexic](https://lexic.io) for persistent project knowledge management.
+
+## What It Does
+
+- **Store decisions** — Log architectural choices with rationale
+- **Query knowledge** — Search your project's knowledge base
+- **Get context** — Retrieve aggregated context for features/topics
+- **Maintain continuity** — Claude Code remembers across sessions
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g lexic-mcp
+```
+
+Or clone and build:
+```bash
+git clone https://github.com/yourusername/lexic-mcp.git
+cd lexic-mcp
+npm install
+npm run build
+```
+
+### 2. Get a PAT from Lexic
+
+1. Log into [Lexic](https://lexic.io)
+2. Go to Settings → API Tokens
+3. Create a new token with `notes:*` and `read` scopes
+4. Copy the token (you won't see it again)
+
+### 3. Configure Claude Code
+
+Add to your Claude Code settings (`~/.config/claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "lexic": {
+      "command": "lexic-mcp",
+      "env": {
+        "LEXIC_API_URL": "https://lexic.io/api",
+        "LEXIC_PAT": "pat_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+Or if running from source:
+```json
+{
+  "mcpServers": {
+    "lexic": {
+      "command": "node",
+      "args": ["/path/to/lexic-mcp/dist/index.js"],
+      "env": {
+        "LEXIC_API_URL": "https://lexic.io/api",
+        "LEXIC_PAT": "pat_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+### 4. Use It
+
+In Claude Code:
+
+```
+"Search my knowledge base for entity-system decisions"
+→ Uses knowledge_query tool
+
+"Log a decision: we're using IVFFlat for vector indexing because..."
+→ Uses dev_log_decision tool
+
+"What context do I need to work on the billing feature?"
+→ Uses dev_get_feature_context tool
+```
+
+## Available Tools
+
+### Core (KOA)
+
+| Tool | Description |
+|------|-------------|
+| `knowledge_query` | Search knowledge base |
+| `knowledge_store` | Store new knowledge |
+| `knowledge_get_context` | Get aggregated context for a topic |
+
+### Admin Tools (user-scoped PAT only)
+
+| Tool | Description |
+|------|-------------|
+| `lexic_create_project` | Create a new project/lexicon |
+| `lexic_list_projects` | List all accessible projects |
+| `lexic_get_project_info` | Get current project info |
+
+### Development Domain
+
+| Tool | Description |
+|------|-------------|
+| `dev_log_decision` | Log a development decision with template |
+| `dev_get_feature_context` | Get feature-specific context |
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `LEXIC_API_URL` | Yes | - | Lexic API base URL |
+| `LEXIC_PAT` | Yes | - | Personal Access Token |
+| `LEXIC_DOMAINS` | No | `development` | Comma-separated domains to load |
+| `LEXIC_DOMAINS_PATH` | No | `./domains` | Path to domains folder |
+| `LOG_LEVEL` | No | `info` | Logging level (debug, info, warn, error) |
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Development mode (watch)
+npm run dev
+```
+
+## Troubleshooting
+
+### "Invalid or expired token"
+
+Your PAT has expired (max 30 days). Generate a new one in Lexic.
+
+### "Failed to connect to Lexic"
+
+Check that `LEXIC_API_URL` is correct and the service is accessible.
+
+### Tools not appearing in Claude Code
+
+1. Restart Claude Code after changing settings
+2. Check server logs: `LOG_LEVEL=debug lexic-mcp`
+
+## License
+
+MIT

package/dist/client/lexic-api.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Lexic API Client
+ *
+ * See .claude/specs/IMPLEMENTATION.md Section 3
+ */
+import type { Config } from '../config.js';
+export interface LexicClient {
+    createNote(content: string, title?: string): Promise<CreateNoteResult>;
+    searchNotes(query: string, limit?: number): Promise<SearchResult[]>;
+    getNote(id: string): Promise<Note>;
+    updateNote(id: string, content: string): Promise<Note>;
+    semanticSearch(query: string, limit?: number): Promise<SearchResult[]>;
+    createLexicon(name: string, description?: string): Promise<CreateLexiconResult>;
+    listLexicons(): Promise<ListLexiconsResult>;
+    getCurrentLexiconInfo(): Promise<LexiconInfo>;
+    createNoteInLexicon(lexiconId: string, content: string, title?: string): Promise<CreateNoteResult>;
+    validateConnection(): Promise<ConnectionValidation>;
+    isUserScoped(): boolean;
+    getCurrentLexiconId(): string | undefined;
+}
+export interface CreateNoteResult {
+    success: boolean;
+    noteId?: string;
+    error?: string;
+}
+export interface SearchResult {
+    noteId: string;
+    title?: string;
+    content: string;
+    score: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Note {
+    id: string;
+    title?: string;
+    content: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateLexiconResult {
+    success: boolean;
+    lexiconId?: string;
+    error?: string;
+}
+export interface LexiconInfo {
+    id: string;
+    name: string;
+    description?: string;
+    noteCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ListLexiconsResult {
+    lexicons: LexiconInfo[];
+}
+export interface ConnectionValidation {
+    valid: boolean;
+    lexiconId?: string;
+    userId?: string;
+    isUserScoped: boolean;
+    error?: string;
+}
+export declare function createLexicClient(config: Config): LexicClient;
+//# sourceMappingURL=lexic-api.d.ts.map

package/dist/client/lexic-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexic-api.d.ts","sourceRoot":"","sources":["../../src/client/lexic-api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAe3C,MAAM,WAAW,WAAW;IAE1B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvD,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAGvE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChF,YAAY,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5C,qBAAqB,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IAG9C,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAGnG,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAGpD,YAAY,IAAI,OAAO,CAAC;IACxB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAcD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CA8R7D"}

package/dist/client/lexic-api.js

@@ -0,0 +1,253 @@
+/**
+ * Lexic API Client
+ *
+ * See .claude/specs/IMPLEMENTATION.md Section 3
+ */
+import { logger } from '../utils/logger.js';
+import { LexicApiError, AuthenticationError, AuthorizationError, NotFoundError, RateLimitError, ServerError } from '../utils/errors.js';
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+const REQUEST_TIMEOUT_MS = 30000;
+const MAX_RETRIES = 1;
+const INITIAL_RETRY_DELAY_MS = 1000;
+// ============================================================================
+// IMPLEMENTATION
+// ============================================================================
+export function createLexicClient(config) {
+    const { apiUrl, pat } = config;
+    // Track connection state
+    let connectionState = null;
+    // Helper to build headers
+    function getHeaders() {
+        return {
+            'Authorization': `Bearer ${pat}`,
+            'Content-Type': 'application/json'
+        };
+    }
+    // Helper to handle errors
+    function handleError(status, errorMessage, correlationId) {
+        switch (status) {
+            case 401:
+                throw new AuthenticationError(errorMessage, correlationId);
+            case 403:
+                throw new AuthorizationError(errorMessage, correlationId);
+            case 404:
+                throw new NotFoundError(errorMessage, correlationId);
+            case 429:
+                throw new RateLimitError(errorMessage, correlationId);
+            default:
+                if (status >= 500) {
+                    throw new ServerError(errorMessage, status, correlationId);
+                }
+                throw new LexicApiError(errorMessage, status, correlationId);
+        }
+    }
+    // Core fetch with timeout, retry, and error handling
+    async function fetchWithRetry(url, options, retries = MAX_RETRIES) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+        try {
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal,
+                headers: {
+                    ...getHeaders(),
+                    ...options.headers
+                }
+            });
+            clearTimeout(timeoutId);
+            // Retry on 5xx errors
+            if (response.status >= 500 && retries > 0) {
+                const delay = INITIAL_RETRY_DELAY_MS * Math.pow(2, MAX_RETRIES - retries);
+                logger.debug('Retrying request after server error', {
+                    url,
+                    status: response.status,
+                    delay,
+                    retriesLeft: retries - 1
+                });
+                await sleep(delay);
+                return fetchWithRetry(url, options, retries - 1);
+            }
+            return response;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new LexicApiError('Request timeout', 408);
+            }
+            throw error;
+        }
+    }
+    // Parse response and handle errors
+    async function parseResponse(response) {
+        const correlationId = response.headers.get('x-correlation-id') || undefined;
+        const body = await response.json();
+        if (!response.ok) {
+            const errorMessage = body.error || `Request failed with status ${response.status}`;
+            handleError(response.status, errorMessage, correlationId);
+        }
+        return body;
+    }
+    return {
+        // ========================================================================
+        // CONNECTION VALIDATION
+        // ========================================================================
+        async validateConnection() {
+            try {
+                const response = await fetch(`${apiUrl}/auth/validate`, {
+                    method: 'GET',
+                    headers: getHeaders()
+                });
+                const body = await response.json();
+                if (!response.ok) {
+                    connectionState = {
+                        valid: false,
+                        isUserScoped: false,
+                        error: body.error || 'Authentication failed'
+                    };
+                    return connectionState;
+                }
+                connectionState = {
+                    valid: body.valid ?? true,
+                    lexiconId: body.lexiconId,
+                    userId: body.userId,
+                    isUserScoped: body.isUserScoped ?? !body.lexiconId
+                };
+                return connectionState;
+            }
+            catch (error) {
+                connectionState = {
+                    valid: false,
+                    isUserScoped: false,
+                    error: `Network error: ${error instanceof Error ? error.message : String(error)}`
+                };
+                return connectionState;
+            }
+        },
+        // ========================================================================
+        // NOTES API
+        // ========================================================================
+        async createNote(content, title) {
+            try {
+                const response = await fetchWithRetry(`${apiUrl}/notes`, {
+                    method: 'POST',
+                    body: JSON.stringify({ content, title })
+                });
+                const body = await response.json();
+                if (!response.ok) {
+                    return { success: false, error: body.error || 'Failed to create note' };
+                }
+                logger.debug('Note created', { noteId: body.id });
+                return { success: true, noteId: body.id };
+            }
+            catch (error) {
+                logger.error('Failed to create note', { error: error instanceof Error ? error.message : String(error) });
+                return { success: false, error: error instanceof Error ? error.message : 'Unknown error' };
+            }
+        },
+        async searchNotes(query, limit = 10) {
+            const url = `${apiUrl}/notes/search?q=${encodeURIComponent(query)}&limit=${limit}`;
+            const response = await fetchWithRetry(url, { method: 'GET' });
+            const body = await parseResponse(response);
+            return body.results.map(r => ({
+                noteId: r.id,
+                title: r.title,
+                content: r.content,
+                score: r.score,
+                createdAt: r.createdAt,
+                updatedAt: r.updatedAt
+            }));
+        },
+        async getNote(id) {
+            const url = `${apiUrl}/notes/${encodeURIComponent(id)}`;
+            const response = await fetchWithRetry(url, { method: 'GET' });
+            return parseResponse(response);
+        },
+        async updateNote(id, content) {
+            const url = `${apiUrl}/notes/${encodeURIComponent(id)}`;
+            const response = await fetchWithRetry(url, {
+                method: 'PATCH',
+                body: JSON.stringify({ content })
+            });
+            return parseResponse(response);
+        },
+        // ========================================================================
+        // SEMANTIC SEARCH
+        // ========================================================================
+        async semanticSearch(query, limit = 10) {
+            const url = `${apiUrl}/search?q=${encodeURIComponent(query)}&limit=${limit}&type=semantic`;
+            const response = await fetchWithRetry(url, { method: 'GET' });
+            const body = await parseResponse(response);
+            return body.results.map(r => ({
+                noteId: r.id,
+                title: r.title,
+                content: r.content,
+                score: r.score,
+                createdAt: r.createdAt,
+                updatedAt: r.updatedAt
+            }));
+        },
+        // ========================================================================
+        // LEXICON MANAGEMENT (user-scoped PAT only)
+        // ========================================================================
+        async createLexicon(name, description) {
+            try {
+                const response = await fetchWithRetry(`${apiUrl}/lexicons`, {
+                    method: 'POST',
+                    body: JSON.stringify({ name, description })
+                });
+                const body = await response.json();
+                if (!response.ok) {
+                    return { success: false, error: body.error || 'Failed to create lexicon' };
+                }
+                logger.debug('Lexicon created', { lexiconId: body.id });
+                return { success: true, lexiconId: body.id };
+            }
+            catch (error) {
+                return { success: false, error: error instanceof Error ? error.message : 'Unknown error' };
+            }
+        },
+        async listLexicons() {
+            const response = await fetchWithRetry(`${apiUrl}/lexicons`, { method: 'GET' });
+            const body = await parseResponse(response);
+            return body;
+        },
+        async getCurrentLexiconInfo() {
+            const response = await fetchWithRetry(`${apiUrl}/lexicons/current`, { method: 'GET' });
+            return parseResponse(response);
+        },
+        async createNoteInLexicon(lexiconId, content, title) {
+            try {
+                const response = await fetchWithRetry(`${apiUrl}/lexicons/${encodeURIComponent(lexiconId)}/notes`, {
+                    method: 'POST',
+                    body: JSON.stringify({ content, title })
+                });
+                const body = await response.json();
+                if (!response.ok) {
+                    return { success: false, error: body.error || 'Failed to create note' };
+                }
+                return { success: true, noteId: body.id };
+            }
+            catch (error) {
+                return { success: false, error: error instanceof Error ? error.message : 'Unknown error' };
+            }
+        },
+        // ========================================================================
+        // CONTEXT HELPERS
+        // ========================================================================
+        isUserScoped() {
+            return connectionState?.isUserScoped ?? false;
+        },
+        getCurrentLexiconId() {
+            return connectionState?.lexiconId;
+        }
+    };
+}
+// ============================================================================
+// HELPERS
+// ============================================================================
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=lexic-api.js.map

package/dist/client/lexic-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lexic-api.js","sourceRoot":"","sources":["../../src/client/lexic-api.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Configuration Loading
+ *
+ * See .claude/specs/IMPLEMENTATION.md Section 2
+ */
+export interface Config {
+    apiUrl: string;
+    pat: string;
+    domainsPath: string;
+    domains: string[];
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+}
+export declare function loadConfig(): Config;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC/C;AAED,wBAAgB,UAAU,IAAI,MAAM,CAuBnC"}

package/dist/config.js

@@ -0,0 +1,30 @@
+/**
+ * Configuration Loading
+ *
+ * See .claude/specs/IMPLEMENTATION.md Section 2
+ */
+import path from 'path';
+export function loadConfig() {
+    const apiUrl = process.env.LEXIC_API_URL;
+    const pat = process.env.LEXIC_PAT;
+    if (!apiUrl)
+        throw new Error('LEXIC_API_URL is required');
+    if (!pat)
+        throw new Error('LEXIC_PAT is required');
+    if (!pat.startsWith('pat_'))
+        throw new Error('LEXIC_PAT must start with pat_');
+    // Parse domains list
+    const domainsEnv = process.env.LEXIC_DOMAINS || 'development';
+    const domains = domainsEnv.split(',').map(d => d.trim()).filter(Boolean);
+    // Resolve domains path (default: ./domains relative to package root)
+    const domainsPath = process.env.LEXIC_DOMAINS_PATH ||
+        path.resolve(process.cwd(), 'domains');
+    return {
+        apiUrl,
+        pat,
+        domainsPath,
+        domains,
+        logLevel: process.env.LOG_LEVEL || 'info'
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAUxB,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAElC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC1D,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACnD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAE/E,qBAAqB;IACrB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,aAAa,CAAC;IAC9D,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEzE,qEAAqE;IACrE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB;QAChD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;IAEzC,OAAO;QACL,MAAM;QACN,GAAG;QACH,WAAW;QACX,OAAO;QACP,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,SAAgC,IAAI,MAAM;KAClE,CAAC;AACJ,CAAC"}

package/dist/core/admin.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Lexic Admin Tools
+ *
+ * Manage lexicons (projects). Only available with user-scoped PATs.
+ */
+import type { LexicClient } from '../client/lexic-api.js';
+export interface CreateProjectParams {
+    name: string;
+    description?: string;
+    domain?: string;
+}
+export interface CreateProjectResult {
+    success: boolean;
+    projectId: string;
+    name: string;
+    seededNotes?: number;
+    message: string;
+}
+export interface ProjectInfo {
+    id: string;
+    name: string;
+    description?: string;
+    noteCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ListProjectsResult {
+    projects: ProjectInfo[];
+    total: number;
+}
+export declare function createCreateProjectTool(client: LexicClient, seeders: Map<string, (client: LexicClient, lexiconId: string) => Promise<number>>): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            domain: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    handler: (params: CreateProjectParams) => Promise<CreateProjectResult>;
+};
+export declare function createListProjectsTool(client: LexicClient): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+    handler: () => Promise<ListProjectsResult>;
+};
+export declare function createGetProjectInfoTool(client: LexicClient): {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {};
+        required: never[];
+    };
+    handler: () => Promise<ProjectInfo>;
+};
+//# sourceMappingURL=admin.d.ts.map

package/dist/core/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../../src/core/admin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAM1D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;sBAuBvD,mBAAmB,KAAG,OAAO,CAAC,mBAAmB,CAAC;EA6B7E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW;;;;;;;;mBASnC,OAAO,CAAC,kBAAkB,CAAC;EAgBjD;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW;;;;;;;;mBASrC,OAAO,CAAC,WAAW,CAAC;EAa1C"}