@siemens/ix-mcp-angular 3.2.0-v.1.10.0

package/dist/src/cli.js

@@ -0,0 +1,310 @@
+#!/usr/bin/env node
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+import { readFileSync, copyFileSync } from 'fs';
+import { dirname, join, basename } from 'path';
+import { fileURLToPath } from 'url';
+import { Command } from 'commander';
+import { SDLMCPSetup } from './setup.js';
+import { loadConfig } from './config.js';
+import { ObservabilityLogger } from './logger.js';
+import { selectPrompt, showSuccess, showError, showInfo } from './prompt.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const config = loadConfig();
+const program = new Command();
+const binName = config.binName; // 'mcp'
+const documentedName = config.documentedName; // 'Design System'
+const projectName = config.projectName; // 'SDL'
+program.name(binName).description(`${projectName} MCP Server CLI - Set up local MCP configurations for ${documentedName} documentation access
+
+This tool creates an MCP (Model Context Protocol) server configuration in your repository
+root, allowing AI tools like VS Code Copilot to access
+${documentedName} documentation and provide intelligent assistance with ${documentedName} components.
+</parameter>
+
+Repository Detection:
+  Automatically detects your repository root by looking for .git or package.json
+  Creates configurations locally in your project, not globally
+
+Team Collaboration:
+  Configuration files can be committed and shared with your team
+  Each team member needs to set up their own LLM token`);
+program
+    .command('setup')
+    .description(`Create MCP server configurations${config.agentsFile ? ' and optional AI agent instruction files' : ''}`)
+    .addHelpText('after', `
+Examples:
+  $ ${binName} setup                    # Set up all MCP${config.agentsFile ? ' and agent instructions' : ' configs'}
+  $ cd my-project && ${binName} setup   # Set up in specific project
+
+This creates:
+  .vscode/mcp.json                     # VS Code MCP extension config
+${config.agentsFile
+    ? `
+Optional AI agent instruction files:
+  .github/instructions/${documentedName}.instructions.md  # ${documentedName}-specific instructions for AI agents
+  .github/copilot-instructions.md              # General instructions for AI agents
+  AGENTS.md                                     # Repository root instructions for AI agents
+`
+    : ''}
+Note: Run this from your project directory or any subdirectory`)
+    .action(async () => {
+    const setup = new SDLMCPSetup();
+    await setup.setupMCPConfigs();
+});
+program
+    .command('setup-token')
+    .description(`Configure your personal LLM token for ${documentedName} documentation access`)
+    .addHelpText('after', `
+Examples:
+  $ ${binName} setup-token              # Set up your personal token
+
+Token Requirements:
+  - Get your token from: https://my.siemens.com/
+  - Must have 'llm' scope
+  - Stored securely in system keychain
+  - Required for embedding generation
+
+Note: This is a one-time setup per machine/user`)
+    .action(async () => {
+    const setup = new SDLMCPSetup();
+    await setup.setupToken();
+});
+program
+    .command('check')
+    .description('Verify current MCP setup status and configuration')
+    .addHelpText('after', `
+Examples:
+  $ ${binName} check                    # Check setup status
+  $ cd my-project && ${binName} check   # Check specific project
+
+Checks:
+  ✓ LLM token configuration
+  ✓ MCP configuration files existence
+  ✓ ${projectName} MCP server presence in configs
+  ✓ Configuration file validity`)
+    .action(async () => {
+    const setup = new SDLMCPSetup();
+    await setup.checkSetup();
+});
+program
+    .command('init')
+    .description('Complete initial setup: configure token, MCP configurations, and optional AI agent instruction files')
+    .addHelpText('after', `
+Examples:
+  $ ${binName} init                     # Complete setup for new user
+  $ cd new-project && ${binName} init   # Set up new project
+
+This command:
+  1. Prompts for your LLM token
+  2. Stores token securely in keychain
+  3. Creates all MCP configuration files
+  4. Optionally adds instruction files for AI agents
+  5. Provides next steps guidance
+
+Perfect for first-time setup or new projects`)
+    .action(async () => {
+    const setup = new SDLMCPSetup();
+    await setup.setupToken();
+    await setup.setupMCPConfigs();
+});
+program
+    .command('test')
+    .description('Test MCP server functionality and connection')
+    .addHelpText('after', `
+Examples:
+  $ ${binName} test                     # Test server functionality
+
+This command:
+  - Validates server can be imported
+  - Tests basic initialization
+  - Verifies no critical errors
+  - Useful for troubleshooting`)
+    .action(async () => {
+    console.log(`Testing ${projectName} MCP server...`);
+    try {
+        // Dynamic import is necessary here for CLI testing
+        const { SDLMCPServer } = await import('./index.js');
+        const server = new SDLMCPServer({ debug: true });
+        setTimeout(() => {
+            console.log('✓ Server initialized successfully');
+            console.log('✓ MCP server is working correctly');
+            server.close();
+            process.exit(0);
+        }, 1000);
+    }
+    catch (error) {
+        console.error('✗ Server test failed:', error);
+        console.error('');
+        console.error('Troubleshooting:');
+        console.error(`  1. Ensure ${config.name /* 'MCP package' */} is installed`);
+        console.error(`  2. Check your LLM token is configured: ${binName} setup-token`);
+        console.error(`  3. Verify network connectivity to ${documentedName} documentation`);
+        process.exit(1);
+    }
+});
+// Only register log command if observability is enabled
+program
+    .command('log', { hidden: !config.observabilityLogging })
+    .description('View and copy observability logs from previous MCP server sessions')
+    .addHelpText('after', `
+Examples:
+  $ ${binName} log                      # View recent sessions and copy log
+
+This command:
+  - Shows all recent MCP server sessions
+  - Lets you choose a session to view
+  - Copies the log file to current directory
+  - Displays the log content
+
+Note: Observability must be enabled in config for logs to be created`)
+    .action(async () => {
+    try {
+        const sessions = ObservabilityLogger.listSessions();
+        if (sessions.length === 0) {
+            showInfo('No session logs found.');
+            console.log('');
+            console.log('Possible reasons:');
+            console.log('  - No MCP server sessions have been started yet');
+            console.log('  - Log directory has been cleared');
+            console.log('');
+            console.log(`Log directory: ${ObservabilityLogger.getLogDir()}`);
+            process.exit(0);
+        }
+        showSuccess(`Found ${sessions.length} session log(s)`);
+        console.log('');
+        const choices = sessions.map(session => ({
+            title: ObservabilityLogger.formatSessionDate(session),
+            value: session,
+            description: session
+        }));
+        const selectedSession = await selectPrompt('Select a session to view:', choices, 0);
+        if (!selectedSession) {
+            showInfo('No session selected.');
+            process.exit(0);
+        }
+        const logPath = ObservabilityLogger.getSessionPath(selectedSession);
+        const logContent = ObservabilityLogger.readSessionLog(selectedSession);
+        const fileName = basename(logPath);
+        const destPath = join(process.cwd(), fileName);
+        try {
+            copyFileSync(logPath, destPath);
+            showSuccess(`Log file copied to current directory: ${fileName}`);
+        }
+        catch (error) {
+            showError('Failed to copy log file');
+            console.error('Error:', error);
+        }
+        console.log('');
+        showInfo(`Original log location: ${logPath}`);
+        console.log('');
+        console.log('Log content:');
+        console.log('========================================');
+        console.log(logContent);
+        console.log('========================================');
+        console.log('');
+        showInfo(`Copied to: ${destPath}`);
+        console.log('');
+    }
+    catch (error) {
+        showError('Failed to read logs');
+        console.error('Error:', error);
+        process.exit(1);
+    }
+});
+program
+    .option('--verbose', 'Enable verbose logging for debugging')
+    .option('--debug', 'Enable debug mode with console logging')
+    .option('--port <number>', 'Start HTTP server on the given port instead of stdio')
+    .option('--test', 'Test mode - validate configuration and exit')
+    .option('--version', 'Display the current version')
+    .addHelpText('after', `
+Quick Start:
+  1. Navigate to your project directory
+  2. Run: ${binName} init
+  3. Follow the prompts to set up your token
+  4. Restart VS Code or your AI tool
+  5. Ask questions about ${documentedName} components!
+
+Examples:
+  ${binName} init                       # Complete first-time setup
+  ${binName} setup                      # Add to existing project
+  ${binName} check                      # Verify everything works
+  ${binName} setup-token                # Update your token
+  ${binName} --version                  # Show version
+
+For more information: https://code.siemens.com/ux/sdl-mcp`);
+if (!config.observabilityLogging) {
+    program.option('--log', 'Enable observability logging (add this flag in your MCP config, use the log command to view logs)');
+}
+else {
+    program.option('--nolog', 'Disable observability logging (add this flag in your MCP config, use the log command to view logs)');
+}
+// Handle --version option before parsing
+if (process.argv.includes('--version')) {
+    try {
+        const packageJsonPath = join(__dirname, '../../package.json');
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        console.log(packageJson.version);
+        process.exit(0);
+    }
+    catch (error) {
+        console.error('Error reading version:', error);
+        process.exit(1);
+    }
+}
+const subcommands = ['setup', 'setup-token', 'check', 'init', 'test', 'log'];
+const args = process.argv.slice(2);
+const hasSubcommand = args.some(arg => subcommands.includes(arg));
+const hasHelp = args.includes('--help') || args.includes('-h');
+// Detect unknown positional args (words that aren't flags or a port value)
+const hasUnknownPositional = args.some((arg, i) => {
+    if (arg.startsWith('-')) {
+        return false;
+    }
+    // If previous arg was --port, this is the port value (not a positional command)
+    if (i > 0 && args[i - 1] === '--port') {
+        return false;
+    }
+    return true;
+});
+// If no subcommand is provided, default to starting the server
+if (!hasSubcommand && !hasHelp && !hasUnknownPositional) {
+    // No command provided (or only --port), start the MCP server directly
+    (async () => {
+        try {
+            const verbose = args.includes('--verbose');
+            const debug = args.includes('--debug');
+            const log = args.includes('--log');
+            const noLog = args.includes('--nolog');
+            const portArg = args.find(a => a.startsWith('--port='))?.split('=')[1] ?? args[args.indexOf('--port') + 1];
+            const port = portArg ? parseInt(portArg, 10) : undefined;
+            const { SDLMCPServer } = await import('./index.js');
+            const server = new SDLMCPServer({ verbose, debug, overrideLogging: noLog ? false : log || undefined });
+            await (port !== undefined ? server.runHttp(port) : server.run());
+            // Graceful shutdown handlers
+            const shutdown = (signal) => () => {
+                if (verbose || debug || process.env.SDL_MCP_DEBUG_LOG === 'true') {
+                    console.log('');
+                    console.log(`Received ${signal} signal...`);
+                }
+                server
+                    .drainAndClose()
+                    .then(() => process.exit(0))
+                    .catch(() => process.exit(1));
+            };
+            process.on('SIGINT', shutdown('shutdown'));
+            process.on('SIGTERM', shutdown('termination'));
+        }
+        catch (error) {
+            console.error('Failed to start MCP server:', error);
+            process.exit(1);
+        }
+    })();
+}
+else {
+    program.parse();
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

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

package/dist/src/config.d.ts

@@ -0,0 +1,35 @@
+declare function loadConfig(): {
+    name: string;
+    description: string;
+    displayName: string;
+    binName: string;
+    compatTokenName?: string;
+    documentedName: string;
+    projectName: string;
+    searchToolName: string;
+    iconSearch?: boolean;
+    iconSearchToolName?: string;
+    iconName?: string;
+    iconSearchIconPrefix?: string;
+    agentsFile?: boolean;
+    instructionFileName?: string;
+    observabilityLogging?: boolean;
+    exampleQuestions: string[];
+    texts: {
+        DOC_SEARCH_INSTRUCTION: string;
+        DOC_SEARCH_TOOL_DESCRIPTION: string;
+        DOC_SEARCH_QUERY_DESCRIPTION: string;
+        DOC_NO_RESULTS: string;
+        DOC_SUCCESS_HEADER: string;
+        DOC_RESULT_NOTE: string;
+        ICON_SEARCH_INSTRUCTION?: string;
+        ICON_SEARCH_TOOL_DESCRIPTION?: string;
+        ICON_SEARCH_QUERY_DESCRIPTION?: string;
+        ICON_NO_RESULTS?: string;
+        ICON_SUCCESS_HEADER?: string;
+        ICON_RESULT_NOTE?: string;
+    };
+};
+declare function setConfigPath(customPath: string): void;
+export { loadConfig, setConfigPath };
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/mcp/config.ts"],"names":[],"mappings":"AAgDA,iBAAS,UAAU;UAjCP,MAAM;iBACC,MAAM;iBACN,MAAM;aACV,MAAM;sBACG,MAAM;oBACR,MAAM;iBACT,MAAM;oBACH,MAAM;iBACT,OAAO;yBACC,MAAM;eAChB,MAAM;2BACM,MAAM;iBAChB,OAAO;0BACE,MAAM;2BACL,OAAO;sBACZ,MAAM,EAAE;WACnB;QACL,sBAAsB,EAAE,MAAM,CAAC;QAC/B,2BAA2B,EAAE,MAAM,CAAC;QACpC,4BAA4B,EAAE,MAAM,CAAC;QACrC,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,eAAe,EAAE,MAAM,CAAC;QACxB,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,4BAA4B,CAAC,EAAE,MAAM,CAAC;QACtC,6BAA6B,CAAC,EAAE,MAAM,CAAC;QACvC,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B;EAgBN;AAED,iBAAS,aAAa,CAAC,UAAU,EAAE,MAAM,QAQxC;AAED,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC"}

package/dist/src/config.js

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) Siemens 2016 - 2025
+ * SPDX-License-Identifier: MIT
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+let configPath = undefined;
+let config = undefined;
+function loadConfig() {
+    if (config)
+        return config;
+    const actualConfigPath = configPath || path.join(__dirname, '..', '..', 'config.json');
+    const configData = fs.readFileSync(actualConfigPath, 'utf8');
+    config = JSON.parse(configData);
+    if (!config) {
+        throw new Error('Failed to load configuration');
+    }
+    return config;
+}
+function setConfigPath(customPath) {
+    if (customPath === configPath) {
+        return;
+    }
+    if (config) {
+        throw new Error('Cannot set config path after config has been loaded');
+    }
+    configPath = customPath;
+}
+export { loadConfig, setConfigPath };
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/mcp/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,IAAI,UAAU,GAAuB,SAAS,CAAC;AAE/C,IAAI,MAAM,GAiCM,SAAS,CAAC;AAE1B,SAAS,UAAU;IACjB,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,gBAAgB,GAAG,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC;IACvF,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC7D,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAEhC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,UAAkB;IACvC,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO;IACT,CAAC;IACD,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,UAAU,GAAG,UAAU,CAAC;AAC1B,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC"}

package/dist/src/db-handler.d.ts

@@ -0,0 +1,50 @@
+export interface DocumentRow {
+    id: string;
+    content: string;
+    vector: number[];
+    chunk_index: number;
+    type: string;
+    header_path: string | undefined;
+    header_level: number | undefined;
+    category: string | undefined;
+    terms: string | undefined;
+    token_count: number;
+}
+export interface ChunkData {
+    chunkId: string;
+    content: string;
+    type: string;
+    headerPath: string | undefined;
+    headerLevel: number | undefined;
+    category: string | undefined;
+    terms: string | undefined;
+    tokenCount: number;
+    chunkIndex: number;
+}
+export declare class DatabaseHandler {
+    private db;
+    private table;
+    private verbose;
+    private dbPath;
+    private tableName;
+    constructor(dbPath: string, options?: {
+        verbose?: boolean;
+    });
+    initialize(): Promise<void>;
+    getDocumentCount(): Promise<number>;
+    getDocumentsByType(type: string): Promise<DocumentRow[]>;
+    getAllDocuments(): Promise<DocumentRow[]>;
+    insertDocument(chunk: ChunkData, embedding: number[]): Promise<void>;
+    insertDocumentsBatch(chunks: ChunkData[], embeddings: number[][]): Promise<void>;
+    clearAllDocuments(): Promise<number>;
+    clearDocumentsByType(type: string): Promise<number>;
+    vectorSearch(queryVector: number[], limit: number, type?: string): Promise<DocumentRow[]>;
+    close(): void;
+    getStats(): Promise<{
+        totalDocuments: number;
+        documentsByType: Record<string, number>;
+    }>;
+    cleanupOldVersions(): Promise<void>;
+    private normalizeRow;
+}
+//# sourceMappingURL=db-handler.d.ts.map

package/dist/src/db-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-handler.d.ts","sourceRoot":"","sources":["../../../src/mcp/db-handler.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAe;gBAEpB,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;IAWrD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAanC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAaxD,eAAe,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAazC,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BpE,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BhF,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAepC,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBnD,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAmB/F,KAAK,IAAI,IAAI;IAQP,QAAQ,IAAI,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;IA8BxF,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BzC,OAAO,CAAC,YAAY;CAcrB"}