@blink-authority-com/claude-code-plugin 1.0.0

package/dist/docs/parser.js

@@ -0,0 +1,145 @@
+/**
+ * BLINK Authority MCP Server — Markdown Parser
+ */
+/**
+ * Parse a markdown document into structured sections split by headings.
+ */
+export function parseDocument(markdown, path) {
+    // Strip AI-instruction comments: <!-- ... -->
+    const cleaned = markdown
+        .replace(/<!--\s*internal\s*-->[\s\S]*?(?=<!--|$)/gi, '')
+        .replace(/<!--\s*private\s*-->[\s\S]*?<!--\s*\/private\s*-->/gi, '')
+        .replace(/<!--[\s\S]*?-->/g, '');
+    const lines = cleaned.split('\n');
+    const sections = [];
+    let currentTitle = path;
+    let currentLevel = 1;
+    let currentLines = [];
+    let currentCodeBlocks = [];
+    let inCodeBlock = false;
+    let codeBlockContent = '';
+    function flushSection() {
+        const content = currentLines.join('\n').trim();
+        if (content) {
+            sections.push({
+                title: currentTitle,
+                path,
+                content,
+                codeBlocks: [...currentCodeBlocks],
+                headingLevel: currentLevel,
+            });
+        }
+        currentLines = [];
+        currentCodeBlocks = [];
+    }
+    for (const line of lines) {
+        // Track code blocks
+        if (line.startsWith('```')) {
+            if (inCodeBlock) {
+                // End of code block
+                codeBlockContent += line + '\n';
+                currentCodeBlocks.push(codeBlockContent.trim());
+                currentLines.push(line);
+                inCodeBlock = false;
+                codeBlockContent = '';
+                continue;
+            }
+            else {
+                // Start of code block
+                inCodeBlock = true;
+                codeBlockContent = line + '\n';
+                currentLines.push(line);
+                continue;
+            }
+        }
+        if (inCodeBlock) {
+            codeBlockContent += line + '\n';
+            currentLines.push(line);
+            continue;
+        }
+        // Check for heading
+        const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+        if (headingMatch) {
+            flushSection();
+            currentLevel = headingMatch[1].length;
+            currentTitle = headingMatch[2].trim();
+            currentLines.push(line);
+            continue;
+        }
+        currentLines.push(line);
+    }
+    // Flush remaining content
+    flushSection();
+    return sections;
+}
+/**
+ * Extract structured API endpoint info from a parsed doc section.
+ */
+export function extractApiInfo(sections) {
+    let method = 'POST';
+    let apiPath = '';
+    let description = '';
+    let requestFormat = '';
+    let responseFormat = '';
+    let codeExample = '';
+    for (const section of sections) {
+        const content = section.content;
+        // Extract method and path from patterns like "POST /api/v1/sign"
+        const methodMatch = content.match(/\b(GET|POST|PUT|PATCH|DELETE)\s+(\/[^\s]+)/);
+        if (methodMatch) {
+            method = methodMatch[1];
+            apiPath = methodMatch[2];
+        }
+        const lower = section.title.toLowerCase();
+        if (lower.includes('request') || lower.includes('input')) {
+            requestFormat = content;
+        }
+        else if (lower.includes('response') || lower.includes('output')) {
+            responseFormat = content;
+        }
+        else if (lower.includes('example') || lower.includes('usage')) {
+            codeExample = section.codeBlocks[0] ?? content;
+        }
+        else if (!description && section.headingLevel <= 2) {
+            description = content.slice(0, 500);
+        }
+    }
+    return { method, apiPath, description, requestFormat, responseFormat, codeExample };
+}
+/**
+ * Extract CLI command info from parsed doc sections.
+ */
+export function extractCliInfo(sections) {
+    let description = '';
+    let usage = '';
+    const flags = [];
+    const examples = [];
+    for (const section of sections) {
+        const lower = section.title.toLowerCase();
+        if (lower.includes('flag') || lower.includes('option')) {
+            // Parse flags from content lines like "--flag  description"
+            const flagLines = section.content.split('\n');
+            for (const fl of flagLines) {
+                const flagMatch = fl.match(/^\s*[|`]*\s*(--?\w[\w-]*)\s*[|`]*\s+(.+)/);
+                if (flagMatch) {
+                    flags.push({
+                        flag: flagMatch[1],
+                        description: flagMatch[2].replace(/\|/g, '').trim(),
+                        required: fl.toLowerCase().includes('required'),
+                    });
+                }
+            }
+        }
+        else if (lower.includes('usage') || lower.includes('synopsis')) {
+            usage = section.codeBlocks[0] ?? section.content;
+        }
+        else if (lower.includes('example')) {
+            examples.push(...section.codeBlocks);
+        }
+        else if (!description && section.headingLevel <= 2) {
+            description = section.content.slice(0, 500);
+        }
+    }
+    return { description, usage, flags, examples };
+}
+//# sourceMappingURL=parser.js.map

package/dist/docs/parser.js.map

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

package/dist/docs/search.d.ts

@@ -0,0 +1,38 @@
+/**
+ * BLINK Authority MCP Server — TF-IDF Search Index
+ */
+import type { SearchResult } from './types.js';
+export declare class SearchIndex {
+    private documents;
+    private idf;
+    private dirty;
+    /**
+     * Tokenise text into searchable terms.
+     */
+    private tokenize;
+    /**
+     * Add a document to the index.
+     */
+    addDocument(id: string, title: string, content: string): void;
+    /**
+     * Rebuild the IDF table. Called lazily before search.
+     */
+    private buildIdf;
+    /**
+     * Compute TF-IDF score for a term in a document.
+     */
+    private tfidf;
+    /**
+     * Search the index using cosine similarity.
+     */
+    search(query: string, limit?: number): SearchResult[];
+    /**
+     * Extract the most relevant ~200 chars around matching terms.
+     */
+    private extractSnippet;
+    /**
+     * Get total number of indexed documents.
+     */
+    get size(): number;
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/docs/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/docs/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA0B/C,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,GAAG,CAAkC;IAC7C,OAAO,CAAC,KAAK,CAAQ;IAErB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAsB7D;;OAEG;IACH,OAAO,CAAC,QAAQ;IAuBhB;;OAEG;IACH,OAAO,CAAC,KAAK;IAMb;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,YAAY,EAAE;IA8DhD;;OAEG;IACH,OAAO,CAAC,cAAc;IAuCtB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/docs/search.js

@@ -0,0 +1,180 @@
+/**
+ * BLINK Authority MCP Server — TF-IDF Search Index
+ */
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+    'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+    'should', 'may', 'might', 'shall', 'can', 'to', 'of', 'in', 'for',
+    'on', 'with', 'at', 'by', 'from', 'as', 'into', 'through', 'during',
+    'before', 'after', 'above', 'below', 'between', 'out', 'off', 'over',
+    'under', 'again', 'further', 'then', 'once', 'here', 'there', 'when',
+    'where', 'why', 'how', 'all', 'each', 'every', 'both', 'few', 'more',
+    'most', 'other', 'some', 'such', 'no', 'nor', 'not', 'only', 'own',
+    'same', 'so', 'than', 'too', 'very', 'and', 'but', 'or', 'if', 'it',
+    'its', 'this', 'that', 'these', 'those', 'i', 'me', 'my', 'we', 'our',
+    'you', 'your', 'he', 'him', 'his', 'she', 'her', 'they', 'them', 'their',
+    'what', 'which', 'who', 'whom',
+]);
+export class SearchIndex {
+    documents = [];
+    idf = new Map();
+    dirty = true;
+    /**
+     * Tokenise text into searchable terms.
+     */
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .split(/[\s\p{P}]+/u)
+            .filter((t) => t.length > 1 && !STOP_WORDS.has(t));
+    }
+    /**
+     * Add a document to the index.
+     */
+    addDocument(id, title, content) {
+        const tokens = this.tokenize(`${title} ${content}`);
+        const termFreqs = new Map();
+        for (const token of tokens) {
+            termFreqs.set(token, (termFreqs.get(token) ?? 0) + 1);
+        }
+        // Derive path from id
+        const path = id;
+        this.documents.push({
+            id,
+            title,
+            path,
+            content,
+            termFreqs,
+            totalTerms: tokens.length,
+        });
+        this.dirty = true;
+    }
+    /**
+     * Rebuild the IDF table. Called lazily before search.
+     */
+    buildIdf() {
+        if (!this.dirty)
+            return;
+        this.idf.clear();
+        const N = this.documents.length;
+        if (N === 0)
+            return;
+        // Collect document frequencies
+        const df = new Map();
+        for (const doc of this.documents) {
+            for (const term of doc.termFreqs.keys()) {
+                df.set(term, (df.get(term) ?? 0) + 1);
+            }
+        }
+        // Compute IDF: log(N / df)
+        for (const [term, freq] of df) {
+            this.idf.set(term, Math.log(N / freq));
+        }
+        this.dirty = false;
+    }
+    /**
+     * Compute TF-IDF score for a term in a document.
+     */
+    tfidf(term, doc) {
+        const tf = (doc.termFreqs.get(term) ?? 0) / Math.max(doc.totalTerms, 1);
+        const idfVal = this.idf.get(term) ?? 0;
+        return tf * idfVal;
+    }
+    /**
+     * Search the index using cosine similarity.
+     */
+    search(query, limit = 5) {
+        this.buildIdf();
+        if (this.documents.length === 0) {
+            return [];
+        }
+        const queryTokens = this.tokenize(query);
+        if (queryTokens.length === 0)
+            return [];
+        // Build query TF-IDF vector
+        const queryFreqs = new Map();
+        for (const t of queryTokens) {
+            queryFreqs.set(t, (queryFreqs.get(t) ?? 0) + 1);
+        }
+        const queryVec = new Map();
+        for (const [term, freq] of queryFreqs) {
+            const tf = freq / queryTokens.length;
+            const idfVal = this.idf.get(term) ?? 0;
+            queryVec.set(term, tf * idfVal);
+        }
+        // Score each document using cosine similarity
+        const scored = [];
+        for (const doc of this.documents) {
+            let dotProduct = 0;
+            let docMag = 0;
+            let queryMag = 0;
+            const allTerms = new Set([...queryVec.keys(), ...doc.termFreqs.keys()]);
+            for (const term of allTerms) {
+                const qVal = queryVec.get(term) ?? 0;
+                const dVal = this.tfidf(term, doc);
+                dotProduct += qVal * dVal;
+                docMag += dVal * dVal;
+                queryMag += qVal * qVal;
+            }
+            const magnitude = Math.sqrt(docMag) * Math.sqrt(queryMag);
+            const score = magnitude > 0 ? dotProduct / magnitude : 0;
+            if (score > 0) {
+                scored.push({ doc, score });
+            }
+        }
+        // Sort by score descending, take top N
+        scored.sort((a, b) => b.score - a.score);
+        const topResults = scored.slice(0, limit);
+        return topResults.map(({ doc, score }) => ({
+            id: doc.id,
+            title: doc.title,
+            path: doc.path,
+            snippet: this.extractSnippet(doc.content, queryTokens),
+            score: Math.round(score * 1000) / 1000,
+        }));
+    }
+    /**
+     * Extract the most relevant ~200 chars around matching terms.
+     */
+    extractSnippet(content, queryTokens) {
+        const lowerContent = content.toLowerCase();
+        let bestStart = 0;
+        let bestScore = 0;
+        // Slide a 200-char window and score by term matches
+        const windowSize = 200;
+        for (let i = 0; i <= Math.max(0, lowerContent.length - windowSize); i += 20) {
+            const window = lowerContent.slice(i, i + windowSize);
+            let score = 0;
+            for (const token of queryTokens) {
+                if (window.includes(token))
+                    score++;
+            }
+            if (score > bestScore) {
+                bestScore = score;
+                bestStart = i;
+            }
+        }
+        let snippet = content.slice(bestStart, bestStart + windowSize).trim();
+        // Clean up: start at a word boundary if possible
+        if (bestStart > 0) {
+            const firstSpace = snippet.indexOf(' ');
+            if (firstSpace > 0 && firstSpace < 20) {
+                snippet = '...' + snippet.slice(firstSpace + 1);
+            }
+        }
+        if (bestStart + windowSize < content.length) {
+            const lastSpace = snippet.lastIndexOf(' ');
+            if (lastSpace > snippet.length - 20) {
+                snippet = snippet.slice(0, lastSpace) + '...';
+            }
+        }
+        return snippet;
+    }
+    /**
+     * Get total number of indexed documents.
+     */
+    get size() {
+        return this.documents.length;
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/docs/search.js.map

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

package/dist/docs/tools/api.d.ts

@@ -0,0 +1,12 @@
+/**
+ * get_api_endpoint tool handler
+ */
+import type { CacheManager } from '../cache.js';
+import type { ServerConfig } from '../types.js';
+export declare function handleGetApiEndpoint(cache: CacheManager, config: ServerConfig, args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=api.d.ts.map

package/dist/docs/tools/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/docs/tools/api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAuD7D"}

package/dist/docs/tools/api.js

@@ -0,0 +1,58 @@
+/**
+ * get_api_endpoint tool handler
+ */
+import { fetchDoc } from '../fetcher.js';
+import { parseDocument, extractApiInfo } from '../parser.js';
+const VALID_ENDPOINTS = ['signing', 'verification', 'sessions', 'identity', 'hash', 'health'];
+export async function handleGetApiEndpoint(cache, config, args) {
+    const endpoint = String(args.endpoint ?? '');
+    if (!VALID_ENDPOINTS.includes(endpoint)) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: `Invalid endpoint. Valid options: ${VALID_ENDPOINTS.join(', ')}`,
+                    }),
+                }],
+        };
+    }
+    const cacheKey = `api/${endpoint}`;
+    let markdown = cache.get(cacheKey);
+    if (!markdown || cache.isStale(cacheKey, config.cacheTtlMs)) {
+        try {
+            const url = `${config.docsUrl}/ai-assist/api/${endpoint}.md`;
+            markdown = await fetchDoc(url);
+            cache.set(cacheKey, markdown);
+        }
+        catch (err) {
+            if (markdown) {
+                process.stderr.write(`[blink-mcp] Using stale cache for ${cacheKey}: ${err}\n`);
+            }
+            else {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({ error: `Failed to fetch documentation for ${endpoint}: ${err}` }),
+                        }],
+                };
+            }
+        }
+    }
+    const sections = parseDocument(markdown, cacheKey);
+    const info = extractApiInfo(sections);
+    const response = {
+        endpoint,
+        method: info.method,
+        path: info.apiPath || `/api/v1/${endpoint}`,
+        description: info.description.slice(0, 500),
+        request_format: info.requestFormat.slice(0, 500),
+        response_format: info.responseFormat.slice(0, 500),
+        code_example: info.codeExample.slice(0, 500),
+    };
+    let text = JSON.stringify(response, null, 2);
+    if (text.length > 2000) {
+        text = text.slice(0, 1950) + '\n[truncated — use search_blink_docs for more specific queries]';
+    }
+    return { content: [{ type: 'text', text }] };
+}
+//# sourceMappingURL=api.js.map

package/dist/docs/tools/api.js.map

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

package/dist/docs/tools/cli.d.ts

@@ -0,0 +1,12 @@
+/**
+ * get_cli_command tool handler
+ */
+import type { CacheManager } from '../cache.js';
+import type { ServerConfig } from '../types.js';
+export declare function handleGetCliCommand(cache: CacheManager, config: ServerConfig, args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/docs/tools/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/docs/tools/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAqD7D"}

package/dist/docs/tools/cli.js

@@ -0,0 +1,56 @@
+/**
+ * get_cli_command tool handler
+ */
+import { fetchDoc } from '../fetcher.js';
+import { parseDocument, extractCliInfo } from '../parser.js';
+const VALID_COMMANDS = ['sign', 'verify', 'hash', 'keygen', 'inspect', 'config'];
+export async function handleGetCliCommand(cache, config, args) {
+    const command = String(args.command ?? '');
+    if (!VALID_COMMANDS.includes(command)) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: `Invalid command. Valid options: ${VALID_COMMANDS.join(', ')}`,
+                    }),
+                }],
+        };
+    }
+    const cacheKey = `cli/${command}`;
+    let markdown = cache.get(cacheKey);
+    if (!markdown || cache.isStale(cacheKey, config.cacheTtlMs)) {
+        try {
+            const url = `${config.docsUrl}/ai-assist/cli/${command}.md`;
+            markdown = await fetchDoc(url);
+            cache.set(cacheKey, markdown);
+        }
+        catch (err) {
+            if (markdown) {
+                process.stderr.write(`[blink-mcp] Using stale cache for ${cacheKey}: ${err}\n`);
+            }
+            else {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: JSON.stringify({ error: `Failed to fetch documentation for ${command}: ${err}` }),
+                        }],
+                };
+            }
+        }
+    }
+    const sections = parseDocument(markdown, cacheKey);
+    const info = extractCliInfo(sections);
+    const response = {
+        command: `blink ${command}`,
+        description: info.description.slice(0, 500),
+        usage: info.usage.slice(0, 300),
+        flags: info.flags.slice(0, 10),
+        examples: info.examples.slice(0, 3).map((e) => e.slice(0, 300)),
+    };
+    let text = JSON.stringify(response, null, 2);
+    if (text.length > 2000) {
+        text = text.slice(0, 1950) + '\n[truncated — use search_blink_docs for more specific queries]';
+    }
+    return { content: [{ type: 'text', text }] };
+}
+//# sourceMappingURL=cli.js.map

package/dist/docs/tools/cli.js.map

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

package/dist/docs/tools/concepts.d.ts

@@ -0,0 +1,18 @@
+/**
+ * get_concept + list_available_docs tool handlers
+ */
+import type { CacheManager } from '../cache.js';
+import type { ServerConfig } from '../types.js';
+export declare function handleGetConcept(cache: CacheManager, config: ServerConfig, args: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+export declare function handleListAvailableDocs(cache: CacheManager, config: ServerConfig): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=concepts.d.ts.map

package/dist/docs/tools/concepts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concepts.d.ts","sourceRoot":"","sources":["../../../src/docs/tools/concepts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA8D7D;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAgF7D"}