risc0-mcp-server 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +218 -0
- package/dist/config.d.ts +12 -0
- package/dist/config.d.ts.map +1 -0
- package/dist/config.js +12 -0
- package/dist/config.js.map +1 -0
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +14 -0
- package/dist/index.js.map +1 -0
- package/dist/server.d.ts +3 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +254 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/get-api-reference.d.ts +12 -0
- package/dist/tools/get-api-reference.d.ts.map +1 -0
- package/dist/tools/get-api-reference.js +31 -0
- package/dist/tools/get-api-reference.js.map +1 -0
- package/dist/tools/get-documentation.d.ts +13 -0
- package/dist/tools/get-documentation.d.ts.map +1 -0
- package/dist/tools/get-documentation.js +26 -0
- package/dist/tools/get-documentation.js.map +1 -0
- package/dist/tools/get-example.d.ts +15 -0
- package/dist/tools/get-example.d.ts.map +1 -0
- package/dist/tools/get-example.js +52 -0
- package/dist/tools/get-example.js.map +1 -0
- package/dist/tools/get-faq.d.ts +10 -0
- package/dist/tools/get-faq.d.ts.map +1 -0
- package/dist/tools/get-faq.js +77 -0
- package/dist/tools/get-faq.js.map +1 -0
- package/dist/tools/get-terminology.d.ts +9 -0
- package/dist/tools/get-terminology.d.ts.map +1 -0
- package/dist/tools/get-terminology.js +81 -0
- package/dist/tools/get-terminology.js.map +1 -0
- package/dist/tools/index.d.ts +8 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +8 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/list-examples.d.ts +8 -0
- package/dist/tools/list-examples.d.ts.map +1 -0
- package/dist/tools/list-examples.js +54 -0
- package/dist/tools/list-examples.js.map +1 -0
- package/dist/tools/search-docs.d.ts +12 -0
- package/dist/tools/search-docs.d.ts.map +1 -0
- package/dist/tools/search-docs.js +14 -0
- package/dist/tools/search-docs.js.map +1 -0
- package/dist/types.d.ts +34 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +2 -0
- package/dist/types.js.map +1 -0
- package/dist/utils/doc-indexer.d.ts +20 -0
- package/dist/utils/doc-indexer.d.ts.map +1 -0
- package/dist/utils/doc-indexer.js +161 -0
- package/dist/utils/doc-indexer.js.map +1 -0
- package/dist/utils/file-reader.d.ts +12 -0
- package/dist/utils/file-reader.d.ts.map +1 -0
- package/dist/utils/file-reader.js +30 -0
- package/dist/utils/file-reader.js.map +1 -0
- package/dist/utils/github-fetcher.d.ts +10 -0
- package/dist/utils/github-fetcher.d.ts.map +1 -0
- package/dist/utils/github-fetcher.js +72 -0
- package/dist/utils/github-fetcher.js.map +1 -0
- package/dist/utils/markdown-parser.d.ts +17 -0
- package/dist/utils/markdown-parser.d.ts.map +1 -0
- package/dist/utils/markdown-parser.js +55 -0
- package/dist/utils/markdown-parser.js.map +1 -0
- package/package.json +60 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-documentation.js","sourceRoot":"","sources":["../../src/tools/get-documentation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,UAAsB,EACtB,IAAwC;IASxC,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC;IAErD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACpC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEjE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC;QAE5F,OAAO;YACL,KAAK;YACL,OAAO,EAAE,eAAe;YACxB,IAAI;YACJ,OAAO;YACP,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,mCAAmC,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACrG,CAAC;IACJ,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { GitHubFetcher } from '../utils/github-fetcher.js';
|
|
2
|
+
export declare function getExample(fetcher: GitHubFetcher, args: {
|
|
3
|
+
name: string;
|
|
4
|
+
includeFiles?: boolean;
|
|
5
|
+
}): Promise<{
|
|
6
|
+
name: string;
|
|
7
|
+
description: string;
|
|
8
|
+
readme: string;
|
|
9
|
+
files?: Array<{
|
|
10
|
+
path: string;
|
|
11
|
+
content: string;
|
|
12
|
+
}>;
|
|
13
|
+
usage: string;
|
|
14
|
+
}>;
|
|
15
|
+
//# sourceMappingURL=get-example.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-example.d.ts","sourceRoot":"","sources":["../../src/tools/get-example.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAI3D,wBAAsB,UAAU,CAC9B,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7C,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAsED"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import { MarkdownParser } from '../utils/markdown-parser.js';
|
|
2
|
+
import { CONFIG } from '../config.js';
|
|
3
|
+
export async function getExample(fetcher, args) {
|
|
4
|
+
const { name, includeFiles = false } = args;
|
|
5
|
+
if (!name || name.trim().length === 0) {
|
|
6
|
+
throw new Error('Name parameter is required');
|
|
7
|
+
}
|
|
8
|
+
try {
|
|
9
|
+
const examplePath = `examples/${name}`;
|
|
10
|
+
const readmePath = `${examplePath}/README.md`;
|
|
11
|
+
const readmeContent = await fetcher.fetchFile(readmePath);
|
|
12
|
+
const parser = new MarkdownParser();
|
|
13
|
+
const { data, content: markdownContent } = parser.parse(readmeContent);
|
|
14
|
+
const description = data.description || parser.extractExcerpt(markdownContent);
|
|
15
|
+
// Extract usage information from README
|
|
16
|
+
const usageMatch = markdownContent.match(/##\s*Usage\s*\n([\s\S]*?)(?=\n##|$)/i);
|
|
17
|
+
const usage = usageMatch ? usageMatch[1].trim() : 'See README for usage instructions';
|
|
18
|
+
const result = {
|
|
19
|
+
name,
|
|
20
|
+
description,
|
|
21
|
+
readme: markdownContent,
|
|
22
|
+
usage,
|
|
23
|
+
};
|
|
24
|
+
if (includeFiles) {
|
|
25
|
+
try {
|
|
26
|
+
const files = await fetcher.listDirectory(examplePath);
|
|
27
|
+
const sourceFiles = files.filter((f) => f.endsWith('.rs') ||
|
|
28
|
+
f.endsWith('.toml') ||
|
|
29
|
+
f.endsWith('.md') ||
|
|
30
|
+
f.endsWith('.json'));
|
|
31
|
+
const fileContents = await Promise.all(sourceFiles.slice(0, CONFIG.MAX_EXAMPLE_FILES).map(async (filePath) => {
|
|
32
|
+
try {
|
|
33
|
+
const content = await fetcher.fetchFile(filePath);
|
|
34
|
+
return { path: filePath, content };
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
return null;
|
|
38
|
+
}
|
|
39
|
+
}));
|
|
40
|
+
result.files = fileContents.filter((f) => f !== null);
|
|
41
|
+
}
|
|
42
|
+
catch {
|
|
43
|
+
// Could not list files
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
return result;
|
|
47
|
+
}
|
|
48
|
+
catch (error) {
|
|
49
|
+
throw new Error(`Failed to get example ${name}: ${error instanceof Error ? error.message : String(error)}`);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
//# sourceMappingURL=get-example.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-example.js","sourceRoot":"","sources":["../../src/tools/get-example.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAsB,EACtB,IAA8C;IAQ9C,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;IAE5C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,YAAY,IAAI,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,GAAG,WAAW,YAAY,CAAC;QAE9C,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACpC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAEvE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAE/E,wCAAwC;QACxC,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACjF,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,mCAAmC,CAAC;QAEtF,MAAM,MAAM,GAMR;YACF,IAAI;YACJ,WAAW;YACX,MAAM,EAAE,eAAe;YACvB,KAAK;SACN,CAAC;QAEF,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;gBACvD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACjB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;oBACnB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACjB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CACtB,CAAC;gBAEF,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;oBACpE,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;wBAClD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;oBACrC,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,IAAI,CAAC;oBACd,CAAC;gBACH,CAAC,CAAC,CACH,CAAC;gBAEF,MAAM,CAAC,KAAK,GAAG,YAAY,CAAC,MAAM,CAChC,CAAC,CAAC,EAA0C,EAAE,CAAC,CAAC,KAAK,IAAI,CAC1D,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC3F,CAAC;IACJ,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { FileReader } from '../utils/file-reader.js';
|
|
2
|
+
import { FAQEntry } from '../types.js';
|
|
3
|
+
export declare function getFaq(fileReader: FileReader, args?: {
|
|
4
|
+
keyword?: string;
|
|
5
|
+
}): Promise<{
|
|
6
|
+
faqs: FAQEntry[];
|
|
7
|
+
categories: string[];
|
|
8
|
+
total: number;
|
|
9
|
+
}>;
|
|
10
|
+
//# sourceMappingURL=get-faq.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-faq.d.ts","sourceRoot":"","sources":["../../src/tools/get-faq.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,wBAAsB,MAAM,CAC1B,UAAU,EAAE,UAAU,EACtB,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1B,OAAO,CAAC;IAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA4FpE"}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
export async function getFaq(fileReader, args) {
|
|
2
|
+
const { keyword } = args || {};
|
|
3
|
+
try {
|
|
4
|
+
// Try multiple potential FAQ locations
|
|
5
|
+
const faqPaths = [
|
|
6
|
+
'website/docs/faq.md',
|
|
7
|
+
'website/docs/faq.mdx',
|
|
8
|
+
'docs/faq.md',
|
|
9
|
+
'FAQ.md',
|
|
10
|
+
];
|
|
11
|
+
let faqContent = '';
|
|
12
|
+
for (const path of faqPaths) {
|
|
13
|
+
try {
|
|
14
|
+
faqContent = await fileReader.readFile(path);
|
|
15
|
+
break;
|
|
16
|
+
}
|
|
17
|
+
catch {
|
|
18
|
+
// Try next path
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
if (!faqContent) {
|
|
22
|
+
throw new Error('FAQ file not found in repository');
|
|
23
|
+
}
|
|
24
|
+
const faqs = [];
|
|
25
|
+
const categoriesSet = new Set();
|
|
26
|
+
let currentCategory = 'General';
|
|
27
|
+
const lines = faqContent.split('\n');
|
|
28
|
+
let i = 0;
|
|
29
|
+
while (i < lines.length) {
|
|
30
|
+
const line = lines[i].trim();
|
|
31
|
+
// Category header (## Category)
|
|
32
|
+
if (line.startsWith('## ')) {
|
|
33
|
+
currentCategory = line.replace(/^##\s+/, '').trim();
|
|
34
|
+
categoriesSet.add(currentCategory);
|
|
35
|
+
i++;
|
|
36
|
+
continue;
|
|
37
|
+
}
|
|
38
|
+
// Question header (### Question?)
|
|
39
|
+
if (line.startsWith('### ')) {
|
|
40
|
+
const question = line.replace(/^###\s+/, '').trim();
|
|
41
|
+
i++;
|
|
42
|
+
// Collect answer lines until next heading
|
|
43
|
+
const answerLines = [];
|
|
44
|
+
while (i < lines.length && !lines[i].trim().startsWith('#')) {
|
|
45
|
+
answerLines.push(lines[i]);
|
|
46
|
+
i++;
|
|
47
|
+
}
|
|
48
|
+
const answer = answerLines.join('\n').trim();
|
|
49
|
+
if (answer) {
|
|
50
|
+
faqs.push({
|
|
51
|
+
question,
|
|
52
|
+
answer,
|
|
53
|
+
category: currentCategory,
|
|
54
|
+
});
|
|
55
|
+
}
|
|
56
|
+
continue;
|
|
57
|
+
}
|
|
58
|
+
i++;
|
|
59
|
+
}
|
|
60
|
+
// Filter by keyword if provided
|
|
61
|
+
let filteredFaqs = faqs;
|
|
62
|
+
if (keyword) {
|
|
63
|
+
const lowerKeyword = keyword.toLowerCase();
|
|
64
|
+
filteredFaqs = faqs.filter((faq) => faq.question.toLowerCase().includes(lowerKeyword) ||
|
|
65
|
+
faq.answer.toLowerCase().includes(lowerKeyword));
|
|
66
|
+
}
|
|
67
|
+
return {
|
|
68
|
+
faqs: filteredFaqs,
|
|
69
|
+
categories: Array.from(categoriesSet),
|
|
70
|
+
total: filteredFaqs.length,
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
catch (error) {
|
|
74
|
+
throw new Error(`Failed to get FAQ: ${error instanceof Error ? error.message : String(error)}`);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
//# sourceMappingURL=get-faq.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-faq.js","sourceRoot":"","sources":["../../src/tools/get-faq.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,UAAsB,EACtB,IAA2B;IAE3B,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAE/B,IAAI,CAAC;QACH,uCAAuC;QACvC,MAAM,QAAQ,GAAG;YACf,qBAAqB;YACrB,sBAAsB;YACtB,aAAa;YACb,QAAQ;SACT,CAAC;QAEF,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,UAAU,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC7C,MAAM;YACR,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,IAAI,GAAe,EAAE,CAAC;QAC5B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QAExC,IAAI,eAAe,GAAG,SAAS,CAAC;QAChC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAE7B,gCAAgC;YAChC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACpD,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBACnC,CAAC,EAAE,CAAC;gBACJ,SAAS;YACX,CAAC;YAED,kCAAkC;YAClC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACpD,CAAC,EAAE,CAAC;gBAEJ,0CAA0C;gBAC1C,MAAM,WAAW,GAAa,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC5D,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC3B,CAAC,EAAE,CAAC;gBACN,CAAC;gBAED,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBAE7C,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC,IAAI,CAAC;wBACR,QAAQ;wBACR,MAAM;wBACN,QAAQ,EAAE,eAAe;qBAC1B,CAAC,CAAC;gBACL,CAAC;gBACD,SAAS;YACX,CAAC;YAED,CAAC,EAAE,CAAC;QACN,CAAC;QAED,gCAAgC;QAChC,IAAI,YAAY,GAAG,IAAI,CAAC;QACxB,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;YAC3C,YAAY,GAAG,IAAI,CAAC,MAAM,CACxB,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;gBACjD,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAClD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC;YACrC,KAAK,EAAE,YAAY,CAAC,MAAM;SAC3B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC/E,CAAC;IACJ,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { FileReader } from '../utils/file-reader.js';
|
|
2
|
+
import { TermDefinition } from '../types.js';
|
|
3
|
+
export declare function getTerminology(fileReader: FileReader, args?: {
|
|
4
|
+
term?: string;
|
|
5
|
+
}): Promise<{
|
|
6
|
+
terms: TermDefinition[];
|
|
7
|
+
total: number;
|
|
8
|
+
}>;
|
|
9
|
+
//# sourceMappingURL=get-terminology.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-terminology.d.ts","sourceRoot":"","sources":["../../src/tools/get-terminology.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAsB,cAAc,CAClC,UAAU,EAAE,UAAU,EACtB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvB,OAAO,CAAC;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAkGrD"}
|
|
@@ -0,0 +1,81 @@
|
|
|
1
|
+
export async function getTerminology(fileReader, args) {
|
|
2
|
+
const { term } = args || {};
|
|
3
|
+
try {
|
|
4
|
+
// Try multiple potential terminology/glossary locations
|
|
5
|
+
const glossaryPaths = [
|
|
6
|
+
'website/docs/terminology.md',
|
|
7
|
+
'website/docs/glossary.md',
|
|
8
|
+
'docs/terminology.md',
|
|
9
|
+
'docs/glossary.md',
|
|
10
|
+
'GLOSSARY.md',
|
|
11
|
+
];
|
|
12
|
+
let glossaryContent = '';
|
|
13
|
+
for (const path of glossaryPaths) {
|
|
14
|
+
try {
|
|
15
|
+
glossaryContent = await fileReader.readFile(path);
|
|
16
|
+
break;
|
|
17
|
+
}
|
|
18
|
+
catch {
|
|
19
|
+
// Try next path
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
if (!glossaryContent) {
|
|
23
|
+
throw new Error('Terminology/glossary file not found in repository');
|
|
24
|
+
}
|
|
25
|
+
const terms = [];
|
|
26
|
+
const lines = glossaryContent.split('\n');
|
|
27
|
+
let i = 0;
|
|
28
|
+
while (i < lines.length) {
|
|
29
|
+
const line = lines[i].trim();
|
|
30
|
+
// Term definition (### Term or **Term**)
|
|
31
|
+
let termName = '';
|
|
32
|
+
if (line.startsWith('### ')) {
|
|
33
|
+
termName = line.replace(/^###\s+/, '').trim();
|
|
34
|
+
}
|
|
35
|
+
else if (line.startsWith('**') && line.includes('**')) {
|
|
36
|
+
termName = line.replace(/\*\*/g, '').trim();
|
|
37
|
+
}
|
|
38
|
+
if (termName) {
|
|
39
|
+
i++;
|
|
40
|
+
// Collect definition lines until next term or heading
|
|
41
|
+
const definitionLines = [];
|
|
42
|
+
while (i < lines.length &&
|
|
43
|
+
!lines[i].trim().startsWith('###') &&
|
|
44
|
+
!lines[i].trim().startsWith('**')) {
|
|
45
|
+
definitionLines.push(lines[i]);
|
|
46
|
+
i++;
|
|
47
|
+
}
|
|
48
|
+
const definition = definitionLines.join('\n').trim();
|
|
49
|
+
if (definition) {
|
|
50
|
+
// Extract related terms from definition (simple pattern matching)
|
|
51
|
+
const relatedTerms = [];
|
|
52
|
+
const relatedMatch = definition.match(/See also:?\s*(.+?)(?:\.|$)/i);
|
|
53
|
+
if (relatedMatch) {
|
|
54
|
+
relatedTerms.push(...relatedMatch[1].split(',').map((t) => t.trim()));
|
|
55
|
+
}
|
|
56
|
+
terms.push({
|
|
57
|
+
term: termName,
|
|
58
|
+
definition,
|
|
59
|
+
relatedTerms: relatedTerms.length > 0 ? relatedTerms : undefined,
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
continue;
|
|
63
|
+
}
|
|
64
|
+
i++;
|
|
65
|
+
}
|
|
66
|
+
// Filter by term if provided (fuzzy matching)
|
|
67
|
+
let filteredTerms = terms;
|
|
68
|
+
if (term) {
|
|
69
|
+
const lowerTerm = term.toLowerCase();
|
|
70
|
+
filteredTerms = terms.filter((t) => t.term.toLowerCase().includes(lowerTerm));
|
|
71
|
+
}
|
|
72
|
+
return {
|
|
73
|
+
terms: filteredTerms,
|
|
74
|
+
total: filteredTerms.length,
|
|
75
|
+
};
|
|
76
|
+
}
|
|
77
|
+
catch (error) {
|
|
78
|
+
throw new Error(`Failed to get terminology: ${error instanceof Error ? error.message : String(error)}`);
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
//# sourceMappingURL=get-terminology.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"get-terminology.js","sourceRoot":"","sources":["../../src/tools/get-terminology.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,UAAsB,EACtB,IAAwB;IAExB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,wDAAwD;QACxD,MAAM,aAAa,GAAG;YACpB,6BAA6B;YAC7B,0BAA0B;YAC1B,qBAAqB;YACrB,kBAAkB;YAClB,aAAa;SACd,CAAC;QAEF,IAAI,eAAe,GAAG,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,eAAe,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAClD,MAAM;YACR,CAAC;YAAC,MAAM,CAAC;gBACP,gBAAgB;YAClB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,KAAK,GAAqB,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,CAAC;QAEV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAE7B,yCAAyC;YACzC,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5B,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAChD,CAAC;iBAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9C,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,CAAC,EAAE,CAAC;gBAEJ,sDAAsD;gBACtD,MAAM,eAAe,GAAa,EAAE,CAAC;gBACrC,OACE,CAAC,GAAG,KAAK,CAAC,MAAM;oBAChB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC;oBAClC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EACjC,CAAC;oBACD,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC/B,CAAC,EAAE,CAAC;gBACN,CAAC;gBAED,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBAErD,IAAI,UAAU,EAAE,CAAC;oBACf,kEAAkE;oBAClE,MAAM,YAAY,GAAa,EAAE,CAAC;oBAClC,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;oBACrE,IAAI,YAAY,EAAE,CAAC;wBACjB,YAAY,CAAC,IAAI,CACf,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CACnD,CAAC;oBACJ,CAAC;oBAED,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,QAAQ;wBACd,UAAU;wBACV,YAAY,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS;qBACjE,CAAC,CAAC;gBACL,CAAC;gBACD,SAAS;YACX,CAAC;YAED,CAAC,EAAE,CAAC;QACN,CAAC;QAED,8CAA8C;QAC9C,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACjC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CACzC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,KAAK,EAAE,aAAa,CAAC,MAAM;SAC5B,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACvF,CAAC;IACJ,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export { searchDocs } from './search-docs.js';
|
|
2
|
+
export { getDocumentation } from './get-documentation.js';
|
|
3
|
+
export { listExamples } from './list-examples.js';
|
|
4
|
+
export { getExample } from './get-example.js';
|
|
5
|
+
export { getApiReference } from './get-api-reference.js';
|
|
6
|
+
export { getFaq } from './get-faq.js';
|
|
7
|
+
export { getTerminology } from './get-terminology.js';
|
|
8
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export { searchDocs } from './search-docs.js';
|
|
2
|
+
export { getDocumentation } from './get-documentation.js';
|
|
3
|
+
export { listExamples } from './list-examples.js';
|
|
4
|
+
export { getExample } from './get-example.js';
|
|
5
|
+
export { getApiReference } from './get-api-reference.js';
|
|
6
|
+
export { getFaq } from './get-faq.js';
|
|
7
|
+
export { getTerminology } from './get-terminology.js';
|
|
8
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { GitHubFetcher } from '../utils/github-fetcher.js';
|
|
2
|
+
import { Example } from '../types.js';
|
|
3
|
+
export declare function listExamples(fetcher: GitHubFetcher): Promise<{
|
|
4
|
+
examples: Example[];
|
|
5
|
+
total: number;
|
|
6
|
+
categories: string[];
|
|
7
|
+
}>;
|
|
8
|
+
//# sourceMappingURL=list-examples.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"list-examples.d.ts","sourceRoot":"","sources":["../../src/tools/list-examples.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,wBAAsB,YAAY,CAChC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAyDvE"}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { MarkdownParser } from '../utils/markdown-parser.js';
|
|
2
|
+
import { CONFIG } from '../config.js';
|
|
3
|
+
export async function listExamples(fetcher) {
|
|
4
|
+
try {
|
|
5
|
+
const examplesPath = CONFIG.EXAMPLES_PATH;
|
|
6
|
+
const entries = await fetcher.listDirectory(examplesPath);
|
|
7
|
+
const examples = [];
|
|
8
|
+
const categoriesSet = new Set();
|
|
9
|
+
const parser = new MarkdownParser();
|
|
10
|
+
for (const entry of entries) {
|
|
11
|
+
// Skip non-directory entries
|
|
12
|
+
if (!entry.startsWith(examplesPath + '/')) {
|
|
13
|
+
continue;
|
|
14
|
+
}
|
|
15
|
+
const exampleName = entry.split('/').pop() || entry;
|
|
16
|
+
const readmePath = `${entry}/README.md`;
|
|
17
|
+
let description = '';
|
|
18
|
+
let category = 'General';
|
|
19
|
+
try {
|
|
20
|
+
const content = await fetcher.fetchFile(readmePath);
|
|
21
|
+
const { data, content: markdownContent } = parser.parse(content);
|
|
22
|
+
description = data.description || parser.extractExcerpt(markdownContent);
|
|
23
|
+
category = data.category || 'General';
|
|
24
|
+
}
|
|
25
|
+
catch {
|
|
26
|
+
// No README or error reading it
|
|
27
|
+
description = exampleName.replace(/[-_]/g, ' ');
|
|
28
|
+
}
|
|
29
|
+
categoriesSet.add(category);
|
|
30
|
+
examples.push({
|
|
31
|
+
name: exampleName,
|
|
32
|
+
path: entry,
|
|
33
|
+
description,
|
|
34
|
+
category,
|
|
35
|
+
});
|
|
36
|
+
}
|
|
37
|
+
// Sort examples by category, then name
|
|
38
|
+
examples.sort((a, b) => {
|
|
39
|
+
const categoryCompare = (a.category || '').localeCompare(b.category || '');
|
|
40
|
+
if (categoryCompare !== 0)
|
|
41
|
+
return categoryCompare;
|
|
42
|
+
return a.name.localeCompare(b.name);
|
|
43
|
+
});
|
|
44
|
+
return {
|
|
45
|
+
examples,
|
|
46
|
+
total: examples.length,
|
|
47
|
+
categories: Array.from(categoriesSet).sort(),
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
catch (error) {
|
|
51
|
+
throw new Error(`Failed to list examples: ${error instanceof Error ? error.message : String(error)}`);
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
//# sourceMappingURL=list-examples.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"list-examples.js","sourceRoot":"","sources":["../../src/tools/list-examples.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC;QAC1C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAE1D,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QAEpC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,6BAA6B;YAC7B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,GAAG,GAAG,CAAC,EAAE,CAAC;gBAC1C,SAAS;YACX,CAAC;YAED,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAC;YACpD,MAAM,UAAU,GAAG,GAAG,KAAK,YAAY,CAAC;YAExC,IAAI,WAAW,GAAG,EAAE,CAAC;YACrB,IAAI,QAAQ,GAAG,SAAS,CAAC;YAEzB,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;gBACpD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACjE,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;gBACzE,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,SAAS,CAAC;YACxC,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;gBAChC,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAClD,CAAC;YAED,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,WAAW;gBACjB,IAAI,EAAE,KAAK;gBACX,WAAW;gBACX,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QAED,uCAAuC;QACvC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACrB,MAAM,eAAe,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAC3E,IAAI,eAAe,KAAK,CAAC;gBAAE,OAAO,eAAe,CAAC;YAClD,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ;YACR,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE;SAC7C,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { DocIndexer } from '../utils/doc-indexer.js';
|
|
2
|
+
import { SearchResult } from '../types.js';
|
|
3
|
+
export declare function searchDocs(indexer: DocIndexer, args: {
|
|
4
|
+
query: string;
|
|
5
|
+
section?: string;
|
|
6
|
+
limit?: number;
|
|
7
|
+
}): Promise<{
|
|
8
|
+
results: SearchResult[];
|
|
9
|
+
total: number;
|
|
10
|
+
query: string;
|
|
11
|
+
}>;
|
|
12
|
+
//# sourceMappingURL=search-docs.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"search-docs.d.ts","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,wBAAsB,UAAU,CAC9B,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,OAAO,CAAC;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAcpE"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { CONFIG } from '../config.js';
|
|
2
|
+
export async function searchDocs(indexer, args) {
|
|
3
|
+
const { query, section, limit = CONFIG.MAX_SEARCH_RESULTS } = args;
|
|
4
|
+
if (!query || query.trim().length === 0) {
|
|
5
|
+
throw new Error('Query parameter is required');
|
|
6
|
+
}
|
|
7
|
+
const results = indexer.search(query, section, limit);
|
|
8
|
+
return {
|
|
9
|
+
results,
|
|
10
|
+
total: results.length,
|
|
11
|
+
query,
|
|
12
|
+
};
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=search-docs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"search-docs.js","sourceRoot":"","sources":["../../src/tools/search-docs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAmB,EACnB,IAAyD;IAEzD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,GAAG,MAAM,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAEnE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAEtD,OAAO;QACL,OAAO;QACP,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,KAAK;KACN,CAAC;AACJ,CAAC"}
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
export interface DocEntry {
|
|
2
|
+
path: string;
|
|
3
|
+
title: string;
|
|
4
|
+
content: string;
|
|
5
|
+
excerpt: string;
|
|
6
|
+
section: 'api' | 'education' | 'faq' | 'terminology' | 'examples';
|
|
7
|
+
version?: string;
|
|
8
|
+
metadata?: Record<string, any>;
|
|
9
|
+
}
|
|
10
|
+
export interface SearchResult {
|
|
11
|
+
title: string;
|
|
12
|
+
path: string;
|
|
13
|
+
excerpt: string;
|
|
14
|
+
score: number;
|
|
15
|
+
section: string;
|
|
16
|
+
}
|
|
17
|
+
export interface Example {
|
|
18
|
+
name: string;
|
|
19
|
+
path: string;
|
|
20
|
+
description: string;
|
|
21
|
+
category?: string;
|
|
22
|
+
readme?: string;
|
|
23
|
+
}
|
|
24
|
+
export interface FAQEntry {
|
|
25
|
+
question: string;
|
|
26
|
+
answer: string;
|
|
27
|
+
category: string;
|
|
28
|
+
}
|
|
29
|
+
export interface TermDefinition {
|
|
30
|
+
term: string;
|
|
31
|
+
definition: string;
|
|
32
|
+
relatedTerms?: string[];
|
|
33
|
+
}
|
|
34
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,KAAK,GAAG,WAAW,GAAG,KAAK,GAAG,aAAa,GAAG,UAAU,CAAC;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB"}
|
package/dist/types.js
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { GitHubFetcher } from './github-fetcher.js';
|
|
2
|
+
import { DocEntry, SearchResult } from '../types.js';
|
|
3
|
+
export declare class DocIndexer {
|
|
4
|
+
private fetcher;
|
|
5
|
+
private index;
|
|
6
|
+
private initialized;
|
|
7
|
+
private parser;
|
|
8
|
+
constructor(fetcher: GitHubFetcher);
|
|
9
|
+
buildIndex(): Promise<void>;
|
|
10
|
+
private indexDirectory;
|
|
11
|
+
private indexFile;
|
|
12
|
+
private indexExamples;
|
|
13
|
+
private extractTitleFromPath;
|
|
14
|
+
search(query: string, section?: string, limit?: number): SearchResult[];
|
|
15
|
+
private tokenize;
|
|
16
|
+
private calculateScore;
|
|
17
|
+
getDocByPath(path: string): DocEntry | null;
|
|
18
|
+
getAllDocs(): DocEntry[];
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=doc-indexer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"doc-indexer.d.ts","sourceRoot":"","sources":["../../src/utils/doc-indexer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGrD,qBAAa,UAAU;IAKT,OAAO,CAAC,OAAO;IAJ3B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,MAAM,CAAiB;gBAEX,OAAO,EAAE,aAAa;IAMpC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAmBnB,cAAc;YAed,SAAS;YAuBT,aAAa;IAiC3B,OAAO,CAAC,oBAAoB;IAS5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,SAA4B,GAAG,YAAY,EAAE;IA8B1F,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,cAAc;IA2BtB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAI3C,UAAU,IAAI,QAAQ,EAAE;CAGzB"}
|