@spartan-ng/mcp 0.0.1-alpha.707

package/src/tools/cache.d.ts

@@ -0,0 +1,99 @@
+import type { APIInfo, CodeBlock } from './utils.js';
+interface ComponentFullData {
+    html: string;
+    api: APIInfo;
+    examples: CodeBlock[];
+    url: string;
+}
+interface ComponentCacheEntry {
+    componentName: string;
+    version: string;
+    cachedAt: string;
+    html: string;
+    api: APIInfo;
+    examples: CodeBlock[];
+    full: ComponentFullData;
+}
+interface BlockCacheEntry {
+    blockName: string;
+    version: string;
+    cachedAt: string;
+    html: string;
+    text?: string;
+    code: CodeBlock[];
+    full: {
+        html: string;
+        code: CodeBlock[];
+        url: string;
+    };
+}
+interface CacheResult<T> {
+    data: T | null;
+    cached: boolean;
+    stale: boolean;
+    cachedAt: string | null;
+    version: string | null;
+}
+interface ClearResult {
+    success: boolean;
+    message: string;
+    version?: string;
+    versions?: string[];
+}
+interface StatsResult {
+    currentVersion: string | null;
+    totalVersions: number;
+    versions: Array<{
+        version: string;
+        componentCount: number;
+        docsCount: number;
+        blockCount: number;
+        createdAt: string;
+        lastUpdated: string;
+        isCurrent: boolean;
+    }>;
+    error?: string;
+}
+interface VersionInfo {
+    version: string;
+    path: string;
+    isCurrent: boolean;
+}
+/**
+ * Version-aware cache manager for Spartan UI documentation
+ * Stores cached data in cache/{version}/ directory structure
+ */
+export declare class CacheManager {
+    private readonly _cacheDir;
+    currentVersion: string | null;
+    private _cacheMetadata;
+    constructor();
+    initialize(spartanVersion?: string): Promise<string>;
+    ensureCacheDir(): Promise<void>;
+    loadMetadata(): Promise<void>;
+    saveMetadata(): Promise<void>;
+    getComponent(componentName: string, dataType?: string): Promise<CacheResult<ComponentCacheEntry | ComponentFullData | string | APIInfo | CodeBlock[] | string[]>>;
+    setComponent(componentName: string, data: Partial<ComponentCacheEntry>): Promise<void>;
+    getDocs(topic: string): Promise<CacheResult<string | null>>;
+    setDocs(topic: string, content: string): Promise<void>;
+    getBlock(blockName: string): Promise<CacheResult<unknown>>;
+    setBlock(blockName: string, data: Partial<BlockCacheEntry>): Promise<void>;
+    clearVersion(): Promise<ClearResult>;
+    clearAll(): Promise<ClearResult>;
+    getStats(): Promise<StatsResult>;
+    listVersions(): Promise<VersionInfo[]>;
+    private validateVersion;
+    /**
+     * Guard cache keys that become filenames. Callers may pass user-supplied
+     * names, so reject anything containing path separators or traversal segments
+     * to keep writes/reads inside the cache directory.
+     */
+    private safeKey;
+    switchVersion(version: string): Promise<{
+        success: boolean;
+        version: string;
+        message: string;
+    }>;
+}
+export declare const cacheManager: CacheManager;
+export {};

package/src/tools/cache.js

@@ -0,0 +1,361 @@
+import fs from 'fs/promises';
+import os from 'os';
+import path from 'path';
+/**
+ * Resolve a writable base directory for the on-disk cache.
+ *
+ * Priority: explicit override -> XDG cache home -> OS user cache directory.
+ * Avoids writing inside the installed package, which is often read-only for
+ * global/npx installs.
+ */
+function resolveCacheDir() {
+    if (process.env.SPARTAN_MCP_CACHE_DIR) {
+        return path.resolve(process.env.SPARTAN_MCP_CACHE_DIR);
+    }
+    if (process.env.XDG_CACHE_HOME) {
+        return path.join(path.resolve(process.env.XDG_CACHE_HOME), 'spartan-mcp');
+    }
+    return path.join(os.homedir(), '.cache', 'spartan-mcp');
+}
+/**
+ * Version-aware cache manager for Spartan UI documentation
+ * Stores cached data in cache/{version}/ directory structure
+ */
+export class CacheManager {
+    _cacheDir;
+    currentVersion;
+    _cacheMetadata;
+    constructor() {
+        this._cacheDir = resolveCacheDir();
+        this.currentVersion = null;
+        this._cacheMetadata = null;
+    }
+    async initialize(spartanVersion) {
+        this.currentVersion = spartanVersion ? this.validateVersion(spartanVersion) : 'latest';
+        await this.ensureCacheDir();
+        await this.loadMetadata();
+        return this.currentVersion;
+    }
+    async ensureCacheDir() {
+        const versionDir = path.join(this._cacheDir, this.currentVersion);
+        const componentsDir = path.join(versionDir, 'components');
+        const docsDir = path.join(versionDir, 'docs');
+        const blocksDir = path.join(versionDir, 'blocks');
+        await fs.mkdir(componentsDir, { recursive: true });
+        await fs.mkdir(docsDir, { recursive: true });
+        await fs.mkdir(blocksDir, { recursive: true });
+    }
+    async loadMetadata() {
+        const metadataPath = path.join(this._cacheDir, this.currentVersion, 'metadata.json');
+        try {
+            const data = await fs.readFile(metadataPath, 'utf-8');
+            this._cacheMetadata = JSON.parse(data);
+        }
+        catch {
+            this._cacheMetadata = {
+                version: this.currentVersion,
+                createdAt: new Date().toISOString(),
+                lastUpdated: new Date().toISOString(),
+                components: {},
+                docs: {},
+                blocks: {},
+            };
+            await this.saveMetadata();
+        }
+    }
+    async saveMetadata() {
+        const metadataPath = path.join(this._cacheDir, this.currentVersion, 'metadata.json');
+        await fs.writeFile(metadataPath, JSON.stringify(this._cacheMetadata, null, 2), 'utf-8');
+    }
+    async getComponent(componentName, dataType = 'full') {
+        const componentFile = path.join(this._cacheDir, this.currentVersion, 'components', `${this.safeKey(componentName)}.json`);
+        try {
+            const data = await fs.readFile(componentFile, 'utf-8');
+            const componentData = JSON.parse(data);
+            const ttlHours = Number(process.env.SPARTAN_CACHE_TTL_HOURS || 24);
+            const cacheAge = Date.now() - new Date(componentData.cachedAt).getTime();
+            const isStale = cacheAge > ttlHours * 60 * 60 * 1000;
+            let selectedData;
+            switch (dataType) {
+                case 'html':
+                    selectedData = componentData.html;
+                    break;
+                case 'api':
+                    selectedData = componentData.api;
+                    break;
+                case 'examples':
+                    selectedData = componentData.examples;
+                    break;
+                case 'full':
+                default:
+                    selectedData = componentData.full;
+                    break;
+            }
+            return {
+                data: selectedData,
+                cached: true,
+                stale: isStale,
+                cachedAt: componentData.cachedAt,
+                version: this.currentVersion,
+            };
+        }
+        catch {
+            return {
+                data: null,
+                cached: false,
+                stale: false,
+                cachedAt: null,
+                version: this.currentVersion,
+            };
+        }
+    }
+    async setComponent(componentName, data) {
+        const componentFile = path.join(this._cacheDir, this.currentVersion, 'components', `${this.safeKey(componentName)}.json`);
+        const cacheEntry = {
+            ...data,
+            componentName,
+            version: this.currentVersion,
+            cachedAt: new Date().toISOString(),
+        };
+        await fs.writeFile(componentFile, JSON.stringify(cacheEntry, null, 2), 'utf-8');
+        this._cacheMetadata.components[componentName] = {
+            cachedAt: cacheEntry.cachedAt,
+            size: JSON.stringify(cacheEntry).length,
+        };
+        this._cacheMetadata.lastUpdated = new Date().toISOString();
+        await this.saveMetadata();
+    }
+    async getDocs(topic) {
+        const docsFile = path.join(this._cacheDir, this.currentVersion, 'docs', `${this.safeKey(topic)}.json`);
+        try {
+            const data = await fs.readFile(docsFile, 'utf-8');
+            const docsData = JSON.parse(data);
+            const ttlHours = Number(process.env.SPARTAN_CACHE_TTL_HOURS || 24);
+            const cacheAge = Date.now() - new Date(docsData.cachedAt).getTime();
+            const isStale = cacheAge > ttlHours * 60 * 60 * 1000;
+            return {
+                data: docsData.content,
+                cached: true,
+                stale: isStale,
+                cachedAt: docsData.cachedAt,
+                version: this.currentVersion,
+            };
+        }
+        catch {
+            return {
+                data: null,
+                cached: false,
+                stale: false,
+                cachedAt: null,
+                version: this.currentVersion,
+            };
+        }
+    }
+    async setDocs(topic, content) {
+        const docsFile = path.join(this._cacheDir, this.currentVersion, 'docs', `${this.safeKey(topic)}.json`);
+        const cacheEntry = {
+            topic,
+            content,
+            version: this.currentVersion,
+            cachedAt: new Date().toISOString(),
+        };
+        await fs.writeFile(docsFile, JSON.stringify(cacheEntry, null, 2), 'utf-8');
+        this._cacheMetadata.docs[topic] = {
+            cachedAt: cacheEntry.cachedAt,
+            size: JSON.stringify(cacheEntry).length,
+        };
+        this._cacheMetadata.lastUpdated = new Date().toISOString();
+        await this.saveMetadata();
+    }
+    async getBlock(blockName) {
+        const blockFile = path.join(this._cacheDir, this.currentVersion, 'blocks', `${this.safeKey(blockName)}.json`);
+        try {
+            const data = await fs.readFile(blockFile, 'utf-8');
+            const blockData = JSON.parse(data);
+            const ttlHours = Number(process.env.SPARTAN_CACHE_TTL_HOURS || 24);
+            const cacheAge = Date.now() - new Date(blockData.cachedAt).getTime();
+            const isStale = cacheAge > ttlHours * 60 * 60 * 1000;
+            return {
+                data: blockData,
+                cached: true,
+                stale: isStale,
+                cachedAt: blockData.cachedAt,
+                version: this.currentVersion,
+            };
+        }
+        catch {
+            return {
+                data: null,
+                cached: false,
+                stale: false,
+                cachedAt: null,
+                version: this.currentVersion,
+            };
+        }
+    }
+    async setBlock(blockName, data) {
+        const blockFile = path.join(this._cacheDir, this.currentVersion, 'blocks', `${this.safeKey(blockName)}.json`);
+        const cacheEntry = {
+            ...data,
+            blockName,
+            version: this.currentVersion,
+            cachedAt: new Date().toISOString(),
+        };
+        await fs.writeFile(blockFile, JSON.stringify(cacheEntry, null, 2), 'utf-8');
+        // `blocks` is optional and may be absent in metadata written by older versions.
+        this._cacheMetadata.blocks ??= {};
+        this._cacheMetadata.blocks[blockName] = {
+            cachedAt: cacheEntry.cachedAt,
+            size: JSON.stringify(cacheEntry).length,
+        };
+        this._cacheMetadata.lastUpdated = new Date().toISOString();
+        await this.saveMetadata();
+    }
+    async clearVersion() {
+        const versionDir = path.join(this._cacheDir, this.currentVersion);
+        try {
+            await fs.rm(versionDir, { recursive: true, force: true });
+            await this.ensureCacheDir();
+            await this.loadMetadata();
+            return {
+                success: true,
+                message: `Cleared cache for version ${this.currentVersion}`,
+                version: this.currentVersion,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to clear cache: ${error.message}`,
+                version: this.currentVersion,
+            };
+        }
+    }
+    async clearAll() {
+        try {
+            const versions = await fs.readdir(this._cacheDir);
+            const clearedVersions = [];
+            for (const version of versions) {
+                const versionPath = path.join(this._cacheDir, version);
+                const stats = await fs.stat(versionPath);
+                if (stats.isDirectory()) {
+                    await fs.rm(versionPath, { recursive: true, force: true });
+                    clearedVersions.push(version);
+                }
+            }
+            await this.ensureCacheDir();
+            await this.loadMetadata();
+            return {
+                success: true,
+                message: `Cleared cache for ${clearedVersions.length} version(s)`,
+                versions: clearedVersions,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to clear all cache: ${error.message}`,
+                versions: [],
+            };
+        }
+    }
+    async getStats() {
+        try {
+            const versions = await fs.readdir(this._cacheDir);
+            const versionStats = [];
+            for (const version of versions) {
+                const versionPath = path.join(this._cacheDir, version);
+                const stats = await fs.stat(versionPath);
+                if (stats.isDirectory()) {
+                    const metadataPath = path.join(versionPath, 'metadata.json');
+                    try {
+                        const metadataContent = await fs.readFile(metadataPath, 'utf-8');
+                        const metadata = JSON.parse(metadataContent);
+                        const componentCount = Object.keys(metadata.components || {}).length;
+                        const docsCount = Object.keys(metadata.docs || {}).length;
+                        const blockCount = Object.keys(metadata.blocks || {}).length;
+                        versionStats.push({
+                            version,
+                            componentCount,
+                            docsCount,
+                            blockCount,
+                            createdAt: metadata.createdAt,
+                            lastUpdated: metadata.lastUpdated,
+                            isCurrent: version === this.currentVersion,
+                        });
+                    }
+                    catch {
+                        // Skip invalid directories
+                    }
+                }
+            }
+            return {
+                currentVersion: this.currentVersion,
+                totalVersions: versionStats.length,
+                versions: versionStats,
+            };
+        }
+        catch (error) {
+            return {
+                currentVersion: this.currentVersion,
+                totalVersions: 0,
+                versions: [],
+                error: error.message,
+            };
+        }
+    }
+    async listVersions() {
+        try {
+            const versions = await fs.readdir(this._cacheDir);
+            const validVersions = [];
+            for (const version of versions) {
+                const versionPath = path.join(this._cacheDir, version);
+                const stats = await fs.stat(versionPath);
+                if (stats.isDirectory()) {
+                    validVersions.push({
+                        version,
+                        path: versionPath,
+                        isCurrent: version === this.currentVersion,
+                    });
+                }
+            }
+            return validVersions;
+        }
+        catch {
+            return [];
+        }
+    }
+    validateVersion(version) {
+        if (!version || version === '.' || version === '..') {
+            throw new Error(`Invalid version: "${version}". Version cannot be empty, '.', or '..'.`);
+        }
+        if (!/^[\w.-]+$/.test(version)) {
+            throw new Error(`Invalid version: "${version}". Only alphanumeric, dash, underscore, and dot characters are allowed.`);
+        }
+        return version;
+    }
+    /**
+     * Guard cache keys that become filenames. Callers may pass user-supplied
+     * names, so reject anything containing path separators or traversal segments
+     * to keep writes/reads inside the cache directory.
+     */
+    safeKey(key) {
+        if (!key || key === '.' || key === '..' || !/^[\w.-]+$/.test(key)) {
+            throw new Error(`Invalid cache key: "${key}". Only alphanumeric, dash, underscore, and dot characters are allowed.`);
+        }
+        return key;
+    }
+    async switchVersion(version) {
+        this.currentVersion = this.validateVersion(version);
+        await this.ensureCacheDir();
+        await this.loadMetadata();
+        return {
+            success: true,
+            version: this.currentVersion,
+            message: `Switched to version ${version}`,
+        };
+    }
+}
+// Export singleton instance
+export const cacheManager = new CacheManager();
+//# sourceMappingURL=cache.js.map

package/src/tools/cache.js.map

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

package/src/tools/components.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerComponentTools(server: McpServer): void;

package/src/tools/components.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { cacheManager } from './cache.js';
+import { KNOWN_COMPONENTS, SPARTAN_COMPONENTS_BASE, extractAPIInfo, extractCodeBlocks, fetchContent, } from './utils.js';
+function isComponentSnapshot(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const candidate = value;
+    return (typeof candidate.html === 'string' &&
+        Array.isArray(candidate.examples) &&
+        typeof candidate.url === 'string' &&
+        candidate.api !== undefined);
+}
+export function registerComponentTools(server) {
+    server.registerTool('spartan_components_list', {
+        title: 'List Spartan UI components',
+        description: 'Returns a list of known Spartan Angular UI components with their documentation URLs. ' +
+            'Use this to discover available components, then call spartan_components_get with specific component names to get detailed API documentation.',
+        inputSchema: {},
+    }, async () => {
+        const items = KNOWN_COMPONENTS.map((name) => ({
+            name,
+            url: `${SPARTAN_COMPONENTS_BASE}/${name}`,
+        }));
+        const responseText = JSON.stringify({ components: items }, null, 2) +
+            '\n\nPROCESSING INSTRUCTIONS:\n' +
+            '- This list contains all available Spartan UI components\n' +
+            '- Use spartan_components_get with any component name to get detailed API documentation\n' +
+            '- Each component has Brain API (Brn*) and Helm API (Hlm*) variants\n' +
+            '- Always present component options and APIs when helping users';
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: responseText,
+                },
+            ],
+        };
+    });
+    server.registerTool('spartan_components_get', {
+        title: 'Get component documentation',
+        description: "Fetch the Spartan UI documentation page for a given component (e.g., 'accordion'). " +
+            'IMPORTANT: The response contains comprehensive API information including Brain API (Brn*) and Helm API (Hlm*) components with their inputs, outputs, selectors, and examples. ' +
+            'Always parse and present the API tables, code examples, and component specifications from the response. ' +
+            "Look for structured sections like 'Brain API', 'Helm API', and 'Examples' in the response.",
+        inputSchema: {
+            name: z.string().min(1, 'name is required').describe("Component name (kebab-case), e.g., 'accordion'."),
+            extract: z
+                .enum(['code', 'api'])
+                .default('code')
+                .describe("Extraction: 'code' for code blocks, 'api' for structured API information."),
+            noCache: z.boolean().default(false).describe('Bypass cache when true.'),
+            spartanVersion: z
+                .string()
+                .optional()
+                .describe("Spartan UI version to use for caching (e.g., '1.2.3'). If not provided, defaults to 'latest'."),
+        },
+    }, async (args) => {
+        const name = String(args.name || '')
+            .trim()
+            .toLowerCase();
+        if (!name)
+            throw new Error('Missing component name');
+        if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+            throw new Error(`Invalid component name: "${name}". Use a kebab-case name, e.g. 'accordion'.`);
+        }
+        await cacheManager.initialize(args.spartanVersion);
+        const url = `${SPARTAN_COMPONENTS_BASE}/${encodeURIComponent(name)}`;
+        const extract = args.extract || 'code';
+        const noCache = Boolean(args.noCache);
+        let snapshot;
+        let cacheInfo = '';
+        if (!noCache) {
+            const cached = await cacheManager.getComponent(name, 'full');
+            if (cached.cached && !cached.stale && isComponentSnapshot(cached.data)) {
+                snapshot = cached.data;
+                cacheInfo = `\n[CACHED DATA - Version: ${cached.version}, Cached at: ${cached.cachedAt}]`;
+            }
+            else {
+                const html = await fetchContent(url, 'html', true);
+                const api = extractAPIInfo(html);
+                const examples = extractCodeBlocks(html);
+                snapshot = { html, api, examples, url };
+                await cacheManager.setComponent(name, {
+                    html,
+                    api,
+                    examples,
+                    full: snapshot,
+                });
+                cacheInfo = cached.cached
+                    ? `\n[CACHE REFRESHED - Version: ${cacheManager.currentVersion}]`
+                    : `\n[NEWLY CACHED - Version: ${cacheManager.currentVersion}]`;
+            }
+        }
+        else {
+            const html = await fetchContent(url, 'html', true);
+            snapshot = {
+                html,
+                api: extractAPIInfo(html),
+                examples: extractCodeBlocks(html),
+                url,
+            };
+            cacheInfo = '\n[LIVE FETCH - Cache bypassed]';
+        }
+        let extracted;
+        if (extract === 'code')
+            extracted = snapshot.examples;
+        else if (extract === 'api')
+            extracted = [snapshot.api];
+        else
+            extracted = [];
+        const payload = {
+            url,
+            extract,
+            count: Array.isArray(extracted) ? extracted.length : 0,
+            data: extracted,
+            cacheInfo: cacheInfo.trim(),
+            version: cacheManager.currentVersion,
+            processingInstructions: 'Always parse and present the API information, code examples, and component specifications from this data.',
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=components.js.map

package/src/tools/components.js.map

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

package/src/tools/docs.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDocsTools(server: McpServer): void;