@looptech-ai/understand-quickly-mcp 0.1.0

package/dist/tools/find-graph-for-repo.js

@@ -0,0 +1,167 @@
+import { findEntryById, loadRegistry, resolveRegistrySource, } from "../registry.js";
+// Registry id pattern: `<owner>/<repo>` with the same character class the
+// site/scripts already use in error messages and validation.
+const ID_PATTERN = /^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/;
+const HTTPS_GITHUB_RE = /^https?:\/\/github\.com\/([^/\s]+)\/([^/\s?#]+)(?:[\/?#].*)?$/i;
+const SSH_GITHUB_RE = /^git@github\.com:([^/\s]+)\/([^/\s?#]+?)(?:\.git)?$/i;
+/**
+ * Parse a github URL into a registry id. Accepts:
+ *   - https://github.com/owner/repo
+ *   - https://github.com/owner/repo.git
+ *   - https://github.com/owner/repo/ (trailing slash)
+ *   - https://github.com/owner/repo/tree/branch/...
+ *   - git@github.com:owner/repo.git
+ */
+export function parseGithubUrl(url) {
+    if (typeof url !== "string" || url.length === 0)
+        return undefined;
+    const trimmed = url.trim();
+    const ssh = trimmed.match(SSH_GITHUB_RE);
+    if (ssh) {
+        const owner = ssh[1];
+        const repo = ssh[2].replace(/\.git$/i, "");
+        if (!owner || !repo)
+            return undefined;
+        return `${owner}/${repo}`;
+    }
+    const https = trimmed.match(HTTPS_GITHUB_RE);
+    if (https) {
+        const owner = https[1];
+        let repo = https[2];
+        repo = repo.replace(/\.git$/i, "");
+        if (!owner || !repo)
+            return undefined;
+        return `${owner}/${repo}`;
+    }
+    return undefined;
+}
+/** Levenshtein distance, capped early when it exceeds `maxDistance` for speed. */
+export function levenshtein(a, b, maxDistance = Infinity) {
+    if (a === b)
+        return 0;
+    const al = a.length;
+    const bl = b.length;
+    if (al === 0)
+        return bl;
+    if (bl === 0)
+        return al;
+    if (Math.abs(al - bl) > maxDistance)
+        return maxDistance + 1;
+    // Two-row DP (rolling).
+    let prev = new Array(bl + 1);
+    let curr = new Array(bl + 1);
+    for (let j = 0; j <= bl; j++)
+        prev[j] = j;
+    for (let i = 1; i <= al; i++) {
+        curr[0] = i;
+        let rowMin = curr[0];
+        for (let j = 1; j <= bl; j++) {
+            const cost = a.charCodeAt(i - 1) === b.charCodeAt(j - 1) ? 0 : 1;
+            curr[j] = Math.min(curr[j - 1] + 1, // insertion
+            prev[j] + 1, // deletion
+            prev[j - 1] + cost);
+            if (curr[j] < rowMin)
+                rowMin = curr[j];
+        }
+        if (rowMin > maxDistance)
+            return maxDistance + 1;
+        [prev, curr] = [curr, prev];
+    }
+    return prev[bl];
+}
+function suggestFuzzy(target, ids, max = 5, maxDistance = 3) {
+    const targetLower = target.toLowerCase();
+    const scored = [];
+    for (const id of ids) {
+        const d = levenshtein(targetLower, id.toLowerCase(), maxDistance);
+        if (d <= maxDistance)
+            scored.push({ id, dist: d });
+    }
+    scored.sort((a, b) => a.dist - b.dist || a.id.localeCompare(b.id));
+    return scored.slice(0, max).map((s) => s.id);
+}
+function driftSummary(entry) {
+    const behind = entry.commits_behind;
+    if (typeof behind === "number" && behind > 0) {
+        return `behind by ${behind} commit${behind === 1 ? "" : "s"}`;
+    }
+    if (typeof behind === "number" && behind === 0) {
+        return "up to date";
+    }
+    return undefined;
+}
+export async function findGraphForRepo(params, options = {}) {
+    const hasId = typeof params?.id === "string" && params.id.length > 0;
+    const hasUrl = typeof params?.github_url === "string" && params.github_url.length > 0;
+    if (!hasId && !hasUrl) {
+        throw new Error("Provide at least one of `id` or `github_url` (e.g. \"owner/repo\" or \"https://github.com/owner/repo\").");
+    }
+    let resolvedId;
+    if (hasId) {
+        if (!ID_PATTERN.test(params.id)) {
+            throw new Error(`\`id\` must match \`owner/repo\` (got "${params.id}").`);
+        }
+        resolvedId = params.id;
+    }
+    else if (hasUrl) {
+        const parsed = parseGithubUrl(params.github_url);
+        if (!parsed) {
+            throw new Error(`Could not extract owner/repo from \`github_url\`: "${params.github_url}".`);
+        }
+        if (!ID_PATTERN.test(parsed)) {
+            throw new Error(`Parsed id "${parsed}" does not match \`owner/repo\` pattern.`);
+        }
+        resolvedId = parsed;
+    }
+    const registry = await loadRegistry({
+        source: options.source ?? resolveRegistrySource(),
+        fetchImpl: options.fetchImpl,
+    });
+    const entry = findEntryById(registry, resolvedId);
+    if (!entry) {
+        const suggestions = suggestFuzzy(resolvedId, registry.entries.map((e) => e.id));
+        return { found: false, suggestions };
+    }
+    const out = {
+        found: true,
+        id: entry.id,
+        format: entry.format,
+        graph_url: entry.graph_url,
+    };
+    if (entry.status !== undefined)
+        out.status = entry.status;
+    if (entry.last_synced !== undefined)
+        out.last_synced = entry.last_synced;
+    if (entry.last_sha !== undefined)
+        out.last_sha = entry.last_sha;
+    if (entry.source_sha !== undefined)
+        out.source_sha = entry.source_sha;
+    if (entry.head_sha !== undefined)
+        out.head_sha = entry.head_sha;
+    if (typeof entry.commits_behind === "number") {
+        out.commits_behind = entry.commits_behind;
+    }
+    const drift = driftSummary(entry);
+    if (drift)
+        out.drift_summary = drift;
+    return out;
+}
+export const findGraphForRepoToolDefinition = {
+    name: "find_graph_for_repo",
+    description: "Look up a registry entry by `id` (\"owner/repo\") or `github_url` (https or ssh). Returns the entry's graph_url and drift metadata, or `{found:false, suggestions}` with up to 5 fuzzy-matched ids.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "string",
+                description: "Registry id (\"owner/repo\"). At least one of `id` or `github_url` is required.",
+            },
+            github_url: {
+                type: "string",
+                description: "GitHub URL (https or ssh form). Branch/path suffixes and a trailing `.git` are tolerated.",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=find-graph-for-repo.js.map

package/dist/tools/find-graph-for-repo.js.map

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

package/dist/tools/get-graph.d.ts

@@ -0,0 +1,17 @@
+import type { GetGraphParams } from "../types.js";
+export declare function getGraph(params: GetGraphParams): Promise<unknown>;
+export declare const getGraphToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};

package/dist/tools/get-graph.js

@@ -0,0 +1,28 @@
+import { fetchGraph, findEntryById, loadRegistry, resolveRegistrySource, } from "../registry.js";
+export async function getGraph(params) {
+    if (!params || typeof params.id !== "string" || params.id.length === 0) {
+        throw new Error("`id` is required");
+    }
+    const registry = await loadRegistry({ source: resolveRegistrySource() });
+    const entry = findEntryById(registry, params.id);
+    if (!entry) {
+        throw new Error(`No registry entry found with id "${params.id}"`);
+    }
+    return fetchGraph(entry.graph_url);
+}
+export const getGraphToolDefinition = {
+    name: "get_graph",
+    description: "Fetch and return the parsed knowledge graph JSON for a registry entry by id.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            id: {
+                type: "string",
+                description: "Registry entry id, e.g. \"Lum1104/Understand-Anything\".",
+            },
+        },
+        required: ["id"],
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=get-graph.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-graph.js","sourceRoot":"","sources":["../../src/tools/get-graph.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,aAAa,EACb,YAAY,EACZ,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAsB;IACnD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,8EAA8E;IAChF,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,CAAC;QAChB,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { ListReposParams, RepoSummary } from "../types.js";
+export declare function listRepos(params?: ListReposParams): Promise<RepoSummary[]>;
+export declare const listReposToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            format: {
+                type: string;
+                description: string;
+            };
+            tag: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                description: string;
+            };
+        };
+        additionalProperties: boolean;
+    };
+};

package/dist/tools/list-repos.js

@@ -0,0 +1,51 @@
+import { filterEntries, loadRegistry, resolveRegistrySource, } from "../registry.js";
+function toSummary(entry) {
+    return {
+        id: entry.id,
+        format: entry.format,
+        description: entry.description,
+        status: entry.status,
+        tags: entry.tags,
+        last_synced: entry.last_synced,
+        graph_url: entry.graph_url,
+    };
+}
+export async function listRepos(params = {}) {
+    const registry = await loadRegistry({ source: resolveRegistrySource() });
+    const filtered = filterEntries(registry.entries, (entry) => {
+        if (params.format && entry.format !== params.format)
+            return false;
+        if (params.status && entry.status !== params.status)
+            return false;
+        if (params.tag) {
+            const tags = entry.tags ?? [];
+            if (!tags.includes(params.tag))
+                return false;
+        }
+        return true;
+    });
+    return filtered.map(toSummary);
+}
+export const listReposToolDefinition = {
+    name: "list_repos",
+    description: "List entries in the understand-quickly registry. Optional filters: `format`, `tag`, `status`.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            format: {
+                type: "string",
+                description: "Exact match on entry.format (e.g. \"understand-anything@1\").",
+            },
+            tag: {
+                type: "string",
+                description: "Returns entries whose `tags` array contains this string.",
+            },
+            status: {
+                type: "string",
+                description: "Exact match on entry.status (typically \"ok\").",
+            },
+        },
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=list-repos.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-repos.js","sourceRoot":"","sources":["../../src/tools/list-repos.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,YAAY,EACZ,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAOxB,SAAS,SAAS,CAAC,KAAoB;IACrC,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,SAA0B,EAAE;IAE5B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,EAAE,MAAM,EAAE,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;QACzD,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAClE,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAClE,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,+FAA+F;IACjG,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+DAA+D;aAC7E;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0DAA0D;aACxE;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iDAAiD;aAC/D;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC"}

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

@@ -0,0 +1,43 @@
+import type { FetchImpl, SearchConceptsParams, SearchHit } from "../types.js";
+export interface SearchConceptsResult {
+    query: string;
+    results?: Array<{
+        id: string;
+        graph_url: string;
+        hits: SearchHit[];
+    }>;
+    matches?: Array<{
+        term: string;
+        count: number;
+        entries: number;
+        samples: string[];
+    }>;
+    source: "stats" | "graph" | "fanout";
+    truncated?: boolean;
+    scanned?: number;
+}
+export interface SearchConceptsOptions {
+    fetchImpl?: FetchImpl;
+    registrySource?: string;
+    statsSource?: string;
+}
+export declare function searchConcepts(params: SearchConceptsParams, options?: SearchConceptsOptions): Promise<SearchConceptsResult>;
+export declare const searchConceptsToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};

package/dist/tools/search-concepts.js

@@ -0,0 +1,171 @@
+import { fetchGraph, findEntryById, loadRegistry, loadStats, resolveRegistrySource, resolveStatsSource, } from "../registry.js";
+// Stub-quality cap on cross-graph searches. A real implementation would either
+// stream results or build a server-side index — for now we just bound the work.
+const CROSS_GRAPH_LIMIT = 5;
+const CONCEPTS_RESULT_CAP = 50;
+const SAMPLES_CAP = 3;
+/**
+ * Best-effort node enumeration. Different graph formats nest nodes differently
+ * (`nodes`, `entities`, `concepts`, …). For the stub we accept any of those
+ * common shapes and fall back to walking the top-level object's array values.
+ */
+function collectNodes(graph) {
+    if (!graph || typeof graph !== "object")
+        return [];
+    const obj = graph;
+    const candidates = ["nodes", "entities", "concepts", "items"];
+    for (const key of candidates) {
+        const value = obj[key];
+        if (Array.isArray(value)) {
+            return value.filter((item) => !!item && typeof item === "object");
+        }
+    }
+    // Fallback: pull every array value and concat.
+    const collected = [];
+    for (const value of Object.values(obj)) {
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                if (item && typeof item === "object")
+                    collected.push(item);
+            }
+        }
+    }
+    return collected;
+}
+function matchNode(node, query) {
+    const lower = query.toLowerCase();
+    const fields = [
+        ["id", node.id],
+        ["label", node.label],
+        ["name", node.name],
+    ];
+    for (const [field, raw] of fields) {
+        if (typeof raw === "string" && raw.toLowerCase().includes(lower)) {
+            return {
+                node_id: typeof node.id === "string" ? node.id : undefined,
+                label: typeof node.label === "string" ? node.label : undefined,
+                name: typeof node.name === "string" ? node.name : undefined,
+                matched_field: field,
+                matched_value: raw,
+            };
+        }
+    }
+    return undefined;
+}
+async function searchOneGraph(graphUrl, query, fetchImpl) {
+    let graph;
+    try {
+        graph = await fetchGraph(graphUrl, fetchImpl);
+    }
+    catch (err) {
+        // For the stub, swallow per-graph fetch errors so a single 404 does not
+        // poison the whole result set.
+        return [];
+    }
+    const nodes = collectNodes(graph);
+    const hits = [];
+    for (const node of nodes) {
+        const hit = matchNode(node, query);
+        if (hit)
+            hits.push(hit);
+    }
+    return hits;
+}
+async function fanoutSearch(query, fetchImpl, registrySource) {
+    const registry = await loadRegistry({ source: registrySource, fetchImpl });
+    const okEntries = registry.entries.filter((entry) => entry.status === "ok");
+    const slice = okEntries.slice(0, CROSS_GRAPH_LIMIT);
+    const results = [];
+    // Sequential to keep the stub gentle on remote hosts.
+    for (const entry of slice) {
+        const hits = await searchOneGraph(entry.graph_url, query, fetchImpl);
+        if (hits.length > 0) {
+            results.push({ id: entry.id, graph_url: entry.graph_url, hits });
+        }
+    }
+    return {
+        query,
+        source: "fanout",
+        scanned: slice.length,
+        truncated: okEntries.length > slice.length,
+        results,
+    };
+}
+function searchStatsConcepts(query, concepts) {
+    const lower = query.toLowerCase();
+    const out = [];
+    for (const c of concepts) {
+        if (typeof c?.term !== "string")
+            continue;
+        if (!c.term.toLowerCase().includes(lower))
+            continue;
+        out.push({
+            term: c.term,
+            count: c.entries,
+            entries: c.entries,
+            samples: Array.isArray(c.samples) ? c.samples.slice(0, SAMPLES_CAP) : [],
+        });
+        if (out.length >= CONCEPTS_RESULT_CAP)
+            break;
+    }
+    return out;
+}
+export async function searchConcepts(params, options = {}) {
+    if (!params || typeof params.query !== "string" || params.query.length === 0) {
+        throw new Error("`query` is required");
+    }
+    const registrySource = options.registrySource ?? resolveRegistrySource();
+    const statsSource = options.statsSource ?? resolveStatsSource();
+    const fetchImpl = options.fetchImpl;
+    // Single-graph mode: keep the legacy fan-out behavior for one specific graph
+    // since stats.json is repo-keyed by sample only and is not a substitute.
+    if (params.id) {
+        const registry = await loadRegistry({ source: registrySource, fetchImpl });
+        const entry = findEntryById(registry, params.id);
+        if (!entry) {
+            throw new Error(`No registry entry found with id "${params.id}"`);
+        }
+        const hits = await searchOneGraph(entry.graph_url, params.query, fetchImpl);
+        return {
+            query: params.query,
+            source: "graph",
+            scanned: 1,
+            results: [{ id: entry.id, graph_url: entry.graph_url, hits }],
+        };
+    }
+    // Default: stats.json-backed concept search. Cheap (one GET, cached 60s).
+    try {
+        const stats = await loadStats({ source: statsSource, fetchImpl });
+        const matches = searchStatsConcepts(params.query, stats.concepts);
+        return {
+            query: params.query,
+            source: "stats",
+            matches,
+        };
+    }
+    catch (err) {
+        // Fall through to the legacy fan-out so an outage on stats.json does not
+        // break this tool entirely.
+        return fanoutSearch(params.query, fetchImpl, registrySource);
+    }
+}
+export const searchConceptsToolDefinition = {
+    name: "search_concepts",
+    description: "Search aggregated concept terms (default: precomputed `stats.json`). Pass `id` to fall back to a single-graph node search. If `stats.json` is unavailable, falls back to a capped cross-graph node fan-out.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Substring to search for (case-insensitive).",
+            },
+            id: {
+                type: "string",
+                description: "Optional entry id. If given, scopes the search to that single graph (legacy node-level mode).",
+            },
+        },
+        required: ["query"],
+        additionalProperties: false,
+    },
+};
+//# sourceMappingURL=search-concepts.js.map

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

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

package/dist/types.d.ts

@@ -0,0 +1,82 @@
+export type RegistryEntryStatus = "ok" | "error" | "pending" | string;
+export interface RegistryEntry {
+    id: string;
+    owner?: string;
+    repo?: string;
+    format: string;
+    graph_url: string;
+    description?: string;
+    status?: RegistryEntryStatus;
+    tags?: string[];
+    last_sha?: string;
+    last_synced?: string;
+    source_sha?: string;
+    head_sha?: string;
+    commits_behind?: number;
+    [key: string]: unknown;
+}
+export interface Registry {
+    schema_version: number;
+    generated_at: string;
+    entries: RegistryEntry[];
+    [key: string]: unknown;
+}
+export interface RepoSummary {
+    id: string;
+    format: string;
+    description?: string;
+    status?: RegistryEntryStatus;
+    tags?: string[];
+    last_synced?: string;
+    graph_url: string;
+}
+export interface ListReposParams {
+    format?: string;
+    tag?: string;
+    status?: string;
+}
+export interface GetGraphParams {
+    id: string;
+}
+export interface SearchConceptsParams {
+    query: string;
+    id?: string;
+}
+export interface SearchHit {
+    node_id?: string;
+    label?: string;
+    name?: string;
+    matched_field: "id" | "label" | "name";
+    matched_value: string;
+}
+export interface FindGraphForRepoParams {
+    id?: string;
+    github_url?: string;
+}
+export interface StatsConcept {
+    term: string;
+    entries: number;
+    samples: string[];
+}
+export interface StatsJson {
+    schema_version: number;
+    generated_at: string;
+    totals?: {
+        entries: number;
+        nodes: number;
+        edges: number;
+    };
+    kinds?: unknown[];
+    languages?: unknown[];
+    concepts: StatsConcept[];
+    [key: string]: unknown;
+}
+export type FetchImpl = (input: string | URL, init?: {
+    signal?: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    statusText: string;
+    json: () => Promise<unknown>;
+    text: () => Promise<string>;
+}>;

package/dist/types.js

@@ -0,0 +1,6 @@
+// Types for the understand-quickly registry. The live schema is owned by the
+// parent project under `schemas/`; we duplicate just the surface this MCP
+// server consumes. Anything we do not use is typed as `unknown` so that we
+// stay forward-compatible with future schema additions.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,0EAA0E;AAC1E,2EAA2E;AAC3E,wDAAwD"}