@shuji-bonji/w3c-mcp 0.1.0

package/dist/tools/get-webidl.js

@@ -0,0 +1,50 @@
+/**
+ * Get WebIDL definitions for a specification
+ */
+import { loadWebIDLRaw, findSpec, loadSpecs } from '../data/loader.js';
+export async function getWebIDL(shortname) {
+    const idlData = await loadWebIDLRaw();
+    // Try exact match first
+    if (idlData[shortname]) {
+        return idlData[shortname];
+    }
+    // Try finding the spec to get its proper shortname
+    const spec = await findSpec(shortname);
+    if (spec && idlData[spec.shortname]) {
+        return idlData[spec.shortname];
+    }
+    // Try series shortname
+    if (spec?.series?.shortname && idlData[spec.series.shortname]) {
+        return idlData[spec.series.shortname];
+    }
+    // Try partial match
+    const matchingKeys = Object.keys(idlData).filter(key => key.includes(shortname) || shortname.includes(key));
+    if (matchingKeys.length === 1) {
+        return idlData[matchingKeys[0]];
+    }
+    if (matchingKeys.length > 1) {
+        throw new Error(`Multiple WebIDL matches found for "${shortname}": ${matchingKeys.join(', ')}. ` +
+            'Please specify the exact shortname.');
+    }
+    // No match found
+    const specs = await loadSpecs();
+    const suggestions = specs
+        .filter(s => idlData[s.shortname])
+        .filter(s => s.shortname.includes(shortname) ||
+        shortname.includes(s.shortname) ||
+        s.title.toLowerCase().includes(shortname.toLowerCase()))
+        .slice(0, 5)
+        .map(s => s.shortname);
+    throw new Error(`WebIDL not found for "${shortname}".` +
+        (suggestions.length > 0
+            ? ` Specs with WebIDL that might match: ${suggestions.join(', ')}`
+            : ' This specification might not have WebIDL definitions.'));
+}
+/**
+ * List all specifications that have WebIDL definitions
+ */
+export async function listWebIDLSpecs() {
+    const idlData = await loadWebIDLRaw();
+    return Object.keys(idlData).sort();
+}
+//# sourceMappingURL=get-webidl.js.map

package/dist/tools/get-webidl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-webidl.js","sourceRoot":"","sources":["../../src/tools/get-webidl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB;IAC/C,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IAEtC,wBAAwB;IACxB,IAAI,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACvB,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAED,mDAAmD;IACnD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,uBAAuB;IACvB,IAAI,IAAI,EAAE,MAAM,EAAE,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9D,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED,oBAAoB;IACpB,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACrD,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CACnD,CAAC;IAEF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,sCAAsC,SAAS,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAChF,qCAAqC,CACtC,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,MAAM,WAAW,GAAG,KAAK;SACtB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;SACjC,MAAM,CAAC,CAAC,CAAC,EAAE,CACV,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC/B,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/B,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CACxD;SACA,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEzB,MAAM,IAAI,KAAK,CACb,yBAAyB,SAAS,IAAI;QACtC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;YACrB,CAAC,CAAC,wCAAwC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAClE,CAAC,CAAC,wDAAwD,CAAC,CAC9D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,OAAO,GAAG,MAAM,aAAa,EAAE,CAAC;IACtC,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC"}

package/dist/tools/list-specs.d.ts

@@ -0,0 +1,6 @@
+/**
+ * List W3C/WHATWG/IETF web specifications
+ */
+import type { ListSpecsOptions, SpecSummary } from '../types/index.js';
+export declare function listSpecs(options?: ListSpecsOptions): Promise<SpecSummary[]>;
+//# sourceMappingURL=list-specs.d.ts.map

package/dist/tools/list-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-specs.d.ts","sourceRoot":"","sources":["../../src/tools/list-specs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvE,wBAAsB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA4CtF"}

package/dist/tools/list-specs.js

@@ -0,0 +1,38 @@
+/**
+ * List W3C/WHATWG/IETF web specifications
+ */
+import { loadSpecs } from '../data/loader.js';
+export async function listSpecs(options = {}) {
+    const { organization, keyword, category, limit = 50 } = options;
+    let specs = await loadSpecs();
+    // Filter by organization
+    if (organization && organization !== 'all') {
+        specs = specs.filter(spec => {
+            const specOrg = spec.organization?.toUpperCase();
+            return specOrg === organization.toUpperCase();
+        });
+    }
+    // Filter by keyword in title or shortname
+    if (keyword) {
+        const lowerKeyword = keyword.toLowerCase();
+        specs = specs.filter(spec => spec.title.toLowerCase().includes(lowerKeyword) ||
+            spec.shortname.toLowerCase().includes(lowerKeyword));
+    }
+    // Filter by category (if available in spec data)
+    if (category) {
+        specs = specs.filter(spec => spec.categories?.some(cat => cat.toLowerCase().includes(category.toLowerCase())));
+    }
+    // Limit results
+    specs = specs.slice(0, limit);
+    // Map to summary format
+    return specs.map(spec => ({
+        shortname: spec.shortname,
+        title: spec.title,
+        url: spec.url,
+        nightlyUrl: spec.nightly?.url,
+        organization: spec.organization,
+        status: spec.release?.status || spec.nightly?.status,
+        categories: spec.categories
+    }));
+}
+//# sourceMappingURL=list-specs.js.map

package/dist/tools/list-specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-specs.js","sourceRoot":"","sources":["../../src/tools/list-specs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG9C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,UAA4B,EAAE;IAC5D,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEhE,IAAI,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAE9B,yBAAyB;IACzB,IAAI,YAAY,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;QAC3C,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC;YACjD,OAAO,OAAO,KAAK,YAAY,CAAC,WAAW,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,0CAA0C;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAC3C,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAC1B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC/C,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CACpD,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAC1B,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAC1B,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CACnD,CACF,CAAC;IACJ,CAAC;IAED,gBAAgB;IAChB,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAE9B,wBAAwB;IACxB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM;QACpD,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/tools/search-specs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Search web specifications by query
+ *
+ * Performance improvements:
+ * - Early termination for exact matches
+ * - Score threshold to skip low-relevance results
+ * - Optimized string operations
+ */
+import type { SpecSearchResult } from '../types/index.js';
+export declare function searchSpecs(query: string, limit?: number): Promise<SpecSearchResult[]>;
+/**
+ * Quick search for exact shortname match
+ * O(1) with index - use when you know exact shortname
+ */
+export declare function quickFindByShortname(shortname: string): Promise<SpecSearchResult | null>;
+//# sourceMappingURL=search-specs.d.ts.map

package/dist/tools/search-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-specs.d.ts","sourceRoot":"","sources":["../../src/tools/search-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK1D,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA2FhG;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAgB9F"}

package/dist/tools/search-specs.js

@@ -0,0 +1,117 @@
+/**
+ * Search web specifications by query
+ *
+ * Performance improvements:
+ * - Early termination for exact matches
+ * - Score threshold to skip low-relevance results
+ * - Optimized string operations
+ */
+import { loadSpecs } from '../data/loader.js';
+// Pre-compile common patterns
+const WORD_SPLIT_REGEX = /\s+/;
+export async function searchSpecs(query, limit = 20) {
+    const specs = await loadSpecs();
+    const lowerQuery = query.toLowerCase();
+    const queryWords = lowerQuery.split(WORD_SPLIT_REGEX).filter(w => w.length > 2);
+    const results = [];
+    // Track if we found a perfect match - can optimize further iterations
+    let foundPerfectMatch = false;
+    for (const spec of specs) {
+        const lowerShortname = spec.shortname.toLowerCase();
+        const lowerTitle = spec.title.toLowerCase();
+        let score = 0;
+        let matchType = 'title';
+        // Exact shortname match (highest score) - early optimization
+        if (lowerShortname === lowerQuery) {
+            score = 100;
+            matchType = 'shortname';
+            foundPerfectMatch = true;
+        }
+        // Shortname contains query
+        else if (lowerShortname.includes(lowerQuery)) {
+            score = 80;
+            matchType = 'shortname';
+        }
+        // Query contains shortname (only for meaningful shortnames)
+        else if (lowerShortname.length > 3 && lowerQuery.includes(lowerShortname)) {
+            score = 70;
+            matchType = 'shortname';
+        }
+        // Exact title match
+        else if (lowerTitle === lowerQuery) {
+            score = 90;
+            matchType = 'title';
+        }
+        // Title contains query
+        else if (lowerTitle.includes(lowerQuery)) {
+            score = 60;
+            matchType = 'title';
+        }
+        // Word-based matching
+        else if (queryWords.length > 0) {
+            const matchedWords = queryWords.filter(word => lowerTitle.includes(word));
+            if (matchedWords.length === queryWords.length) {
+                // All words match
+                score = 50;
+                matchType = 'title';
+            }
+            else if (matchedWords.length > 0) {
+                // Some words match
+                score = 30 + (matchedWords.length / queryWords.length) * 20;
+                matchType = 'title';
+            }
+        }
+        // Abstract/description match (lower priority) - only check if no other match
+        if (score === 0 && spec.abstract) {
+            const lowerAbstract = spec.abstract.toLowerCase();
+            if (lowerAbstract.includes(lowerQuery)) {
+                score = 25;
+                matchType = 'description';
+            }
+            else if (queryWords.length > 0) {
+                const matchedWords = queryWords.filter(word => lowerAbstract.includes(word));
+                if (matchedWords.length >= queryWords.length / 2) {
+                    score = 15 + (matchedWords.length / queryWords.length) * 10;
+                    matchType = 'description';
+                }
+            }
+        }
+        // Only add results with meaningful scores
+        if (score > 0) {
+            results.push({
+                shortname: spec.shortname,
+                title: spec.title,
+                url: spec.url,
+                nightlyUrl: spec.nightly?.url,
+                organization: spec.organization,
+                status: spec.release?.status || spec.nightly?.status,
+                matchType,
+                score
+            });
+        }
+    }
+    // Sort by score descending
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, limit);
+}
+/**
+ * Quick search for exact shortname match
+ * O(1) with index - use when you know exact shortname
+ */
+export async function quickFindByShortname(shortname) {
+    const { findSpec } = await import('../data/loader.js');
+    const spec = await findSpec(shortname);
+    if (!spec)
+        return null;
+    return {
+        shortname: spec.shortname,
+        title: spec.title,
+        url: spec.url,
+        nightlyUrl: spec.nightly?.url,
+        organization: spec.organization,
+        status: spec.release?.status || spec.nightly?.status,
+        matchType: 'shortname',
+        score: 100
+    };
+}
+//# sourceMappingURL=search-specs.js.map

package/dist/tools/search-specs.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Type definitions for W3C MCP Server
+ */
+export interface SpecSummary {
+    shortname: string;
+    title: string;
+    url: string;
+    nightlyUrl?: string;
+    organization?: string;
+    status?: string;
+    categories?: string[];
+}
+export interface SpecDetail extends SpecSummary {
+    abstract?: string;
+    repository?: string;
+    tests?: {
+        repository?: string;
+        testPaths?: string[];
+    };
+    release?: {
+        url: string;
+        status?: string;
+    };
+    nightly?: {
+        url: string;
+        status?: string;
+    };
+    series?: {
+        shortname: string;
+        currentSpecification?: string;
+    };
+    source?: string;
+    standing?: string;
+}
+export interface SpecSearchResult extends SpecSummary {
+    matchType: 'title' | 'shortname' | 'description';
+    score: number;
+}
+export interface CSSProperty {
+    name: string;
+    value?: string;
+    initial?: string;
+    appliesTo?: string;
+    inherited?: string;
+    percentages?: string;
+    computedValue?: string;
+    animationType?: string;
+    spec: string;
+}
+export interface CSSValue {
+    name: string;
+    value?: string;
+    type?: string;
+    spec: string;
+}
+export interface ElementDefinition {
+    name: string;
+    interface?: string;
+    categories?: string[];
+    contentModel?: string;
+    attributes?: AttributeDefinition[];
+    spec: string;
+}
+export interface AttributeDefinition {
+    name: string;
+    type?: string;
+    description?: string;
+}
+export interface DependencyInfo {
+    shortname: string;
+    title: string;
+    dependencies: string[];
+    dependents: string[];
+}
+export interface ListSpecsOptions {
+    organization?: 'W3C' | 'WHATWG' | 'IETF' | 'all';
+    keyword?: string;
+    category?: string;
+    limit?: number;
+}
+export interface WebIDLResult {
+    shortname: string;
+    idl: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for W3C MCP Server
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Logger utility for W3C MCP Server
+ * Provides debug logging controlled by environment variable
+ */
+/**
+ * Log debug message (only when W3C_MCP_DEBUG=true)
+ */
+export declare function debug(message: string, data?: unknown): void;
+/**
+ * Log info message (always shown)
+ */
+export declare function info(message: string): void;
+/**
+ * Log warning message (always shown)
+ */
+export declare function warn(message: string, error?: Error): void;
+/**
+ * Log error message (always shown)
+ */
+export declare function error(message: string, err?: Error): void;
+/**
+ * Performance measurement utilities
+ */
+export declare class PerformanceTimer {
+    private startTime;
+    private label;
+    constructor(label: string);
+    /**
+     * End the timer and log the duration
+     */
+    end(): number;
+    /**
+     * Log an intermediate checkpoint
+     */
+    checkpoint(name: string): number;
+}
+/**
+ * Decorator-style performance logging
+ */
+export declare function logPerformance<T>(label: string, fn: () => T | Promise<T>): T | Promise<T>;
+/**
+ * Log tool invocation (for debugging)
+ */
+export declare function logToolCall(toolName: string, args: unknown): void;
+/**
+ * Log tool result (for debugging)
+ */
+export declare function logToolResult(toolName: string, resultSize: number): void;
+//# 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;;;GAGG;AAKH;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAS3D;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAMzD;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CASxD;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,EAAE,MAAM;IASzB;;OAEG;IACH,GAAG,IAAI,MAAM;IAUb;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CASjC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAchB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAEjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAExE"}

package/dist/utils/logger.js

@@ -0,0 +1,113 @@
+/**
+ * Logger utility for W3C MCP Server
+ * Provides debug logging controlled by environment variable
+ */
+const DEBUG = process.env.W3C_MCP_DEBUG === 'true';
+const LOG_PERFORMANCE = process.env.W3C_MCP_PERF === 'true' || DEBUG;
+/**
+ * Log debug message (only when W3C_MCP_DEBUG=true)
+ */
+export function debug(message, data) {
+    if (DEBUG) {
+        const timestamp = new Date().toISOString();
+        if (data !== undefined) {
+            console.error(`[${timestamp}] [DEBUG] ${message}`, JSON.stringify(data, null, 2));
+        }
+        else {
+            console.error(`[${timestamp}] [DEBUG] ${message}`);
+        }
+    }
+}
+/**
+ * Log info message (always shown)
+ */
+export function info(message) {
+    console.error(`[INFO] ${message}`);
+}
+/**
+ * Log warning message (always shown)
+ */
+export function warn(message, error) {
+    if (error) {
+        console.error(`[WARN] ${message}:`, error.message);
+    }
+    else {
+        console.error(`[WARN] ${message}`);
+    }
+}
+/**
+ * Log error message (always shown)
+ */
+export function error(message, err) {
+    if (err) {
+        console.error(`[ERROR] ${message}:`, err.message);
+        if (DEBUG && err.stack) {
+            console.error(err.stack);
+        }
+    }
+    else {
+        console.error(`[ERROR] ${message}`);
+    }
+}
+/**
+ * Performance measurement utilities
+ */
+export class PerformanceTimer {
+    startTime;
+    label;
+    constructor(label) {
+        this.label = label;
+        this.startTime = Date.now();
+        if (LOG_PERFORMANCE) {
+            debug(`${label} started`);
+        }
+    }
+    /**
+     * End the timer and log the duration
+     */
+    end() {
+        const duration = Date.now() - this.startTime;
+        if (LOG_PERFORMANCE) {
+            console.error(`[PERF] ${this.label}: ${duration}ms`);
+        }
+        return duration;
+    }
+    /**
+     * Log an intermediate checkpoint
+     */
+    checkpoint(name) {
+        const duration = Date.now() - this.startTime;
+        if (LOG_PERFORMANCE) {
+            console.error(`[PERF] ${this.label} → ${name}: ${duration}ms`);
+        }
+        return duration;
+    }
+}
+/**
+ * Decorator-style performance logging
+ */
+export function logPerformance(label, fn) {
+    if (!LOG_PERFORMANCE) {
+        return fn();
+    }
+    const timer = new PerformanceTimer(label);
+    const result = fn();
+    if (result instanceof Promise) {
+        return result.finally(() => timer.end());
+    }
+    timer.end();
+    return result;
+}
+/**
+ * Log tool invocation (for debugging)
+ */
+export function logToolCall(toolName, args) {
+    debug(`Tool called: ${toolName}`, args);
+}
+/**
+ * Log tool result (for debugging)
+ */
+export function logToolResult(toolName, resultSize) {
+    debug(`Tool result: ${toolName}`, { resultSize });
+}
+//# 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":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+	"name": "@shuji-bonji/w3c-mcp",
+	"version": "0.1.0",
+	"description": "MCP Server for accessing W3C Web specifications",
+	"type": "module",
+	"main": "dist/index.js",
+	"bin": {
+		"w3c-mcp": "dist/index.js"
+	},
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch",
+		"start": "node dist/index.js",
+		"prepare": "npm run build"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.0.0",
+		"web-specs": "latest",
+		"@webref/idl": "latest",
+		"@webref/css": "latest",
+		"@webref/elements": "latest",
+		"zod": "^3.23.0"
+	},
+	"devDependencies": {
+		"@types/node": "^20.0.0",
+		"typescript": "^5.5.0"
+	},
+	"keywords": [
+		"mcp",
+		"w3c",
+		"web-specs",
+		"webref",
+		"pwa",
+		"service-worker",
+		"web-standards"
+	],
+	"author": "shuji-bonji",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/shuji-bonji/w3c-mcp.git"
+	},
+	"bugs": {
+		"url": "https://github.com/shuji-bonji/w3c-mcp/issues"
+	},
+	"homepage": "https://github.com/shuji-bonji/w3c-mcp#readme",
+	"files": [
+		"dist"
+	],
+	"engines": {
+		"node": ">=18.0.0"
+	}
+}