eveapps-core 1.0.0

package/dist/src/router/routeQuery.js

@@ -0,0 +1,33 @@
+export function routeQuery(query, analysis, coreScore, hasEveApps) {
+    // 1. Strong core match -> always use core
+    if (coreScore >= 0.75) {
+        return {
+            source: "core",
+            confidence: coreScore,
+            reason: "High confidence match in eveapps-core index"
+        };
+    }
+    // 2. Structured engineering queries -> try both
+    if (analysis.isBuild || analysis.isSymbol || analysis.isScreen) {
+        return {
+            source: hasEveApps ? "both" : "core",
+            confidence: 0.6,
+            reason: "Structured engineering query"
+        };
+    }
+    // 3. Debug or unknown -> prefer EveApps if available
+    if (analysis.isDebug || analysis.isSample) {
+        return {
+            source: hasEveApps ? "eveapps" : "core",
+            confidence: 0.4,
+            reason: "Debug/sample query fallback"
+        };
+    }
+    // 4. Default fallback
+    return {
+        source: hasEveApps ? "eveapps" : "core",
+        confidence: 0.2,
+        reason: "Default fallback routing"
+    };
+}
+//# sourceMappingURL=routeQuery.js.map

package/dist/src/router/routeQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeQuery.js","sourceRoot":"","sources":["../../../src/router/routeQuery.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,UAAU,CACtB,KAAa,EACb,QAAuB,EACvB,SAAiB,EACjB,UAAmB;IAGnB,0CAA0C;IAC1C,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO;YACH,MAAM,EAAE,MAAM;YACd,UAAU,EAAE,SAAS;YACrB,MAAM,EAAE,6CAA6C;SACxD,CAAC;IACN,CAAC;IAED,gDAAgD;IAChD,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC7D,OAAO;YACH,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YACpC,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,8BAA8B;SACzC,CAAC;IACN,CAAC;IAED,qDAAqD;IACrD,IAAI,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,OAAO;YACH,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;YACvC,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,6BAA6B;SACxC,CAAC;IACN,CAAC;IAED,sBAAsB;IACtB,OAAO;QACH,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QACvC,UAAU,EAAE,GAAG;QACf,MAAM,EAAE,0BAA0B;KACrC,CAAC;AACN,CAAC"}

package/dist/src/router/types.d.ts

@@ -0,0 +1,12 @@
+export type RetrievalSource = "core" | "eveapps" | "both";
+export interface RouteDecision {
+    source: RetrievalSource;
+    confidence: number;
+    reason: string;
+}
+export interface RetrievalResult {
+    answer: any;
+    confidence: number;
+    source: RetrievalSource;
+    references?: string[];
+}

package/dist/src/router/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/router/types.js.map

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

package/dist/src/search/searchCore.d.ts

@@ -0,0 +1,3 @@
+import { WorkspaceContext } from "../context.js";
+import type { RetrievalResult } from "../router/types.js";
+export declare function searchCore(context: WorkspaceContext, query: string): RetrievalResult;

package/dist/src/search/searchCore.js

@@ -0,0 +1,64 @@
+import { loadCommands, loadRegisters } from "../lib/loadIndex.js";
+export function searchCore(context, query) {
+    try {
+        const commands = loadCommands();
+        const registers = loadRegisters();
+        const queryLower = query.toLowerCase();
+        // Try to find exact command/register matches
+        const matchedCommands = commands.filter(c => c.name.toLowerCase().includes(queryLower) ||
+            c.summary?.toLowerCase().includes(queryLower)).slice(0, 5);
+        const matchedRegisters = registers.filter(r => r.name.toLowerCase().includes(queryLower) ||
+            r.summary?.toLowerCase().includes(queryLower)).slice(0, 5);
+        const hasMatches = matchedCommands.length > 0 || matchedRegisters.length > 0;
+        if (!hasMatches) {
+            return {
+                answer: {
+                    message: `No BT820/EVE core references found for: "${query}"`,
+                    tip: "Try searching for specific command names, register names, or features"
+                },
+                confidence: 0,
+                source: "core",
+                references: []
+            };
+        }
+        const references = [];
+        if (matchedCommands.length > 0) {
+            references.push(`Commands: ${matchedCommands.map(c => c.name).join(", ")}`);
+        }
+        if (matchedRegisters.length > 0) {
+            references.push(`Registers: ${matchedRegisters.map(r => r.name).join(", ")}`);
+        }
+        return {
+            answer: {
+                message: `Found ${matchedCommands.length} commands and ${matchedRegisters.length} registers for: "${query}"`,
+                commands: matchedCommands.map(c => ({
+                    name: c.name,
+                    type: "command",
+                    signature: c.signature,
+                    summary: c.summary,
+                    related_samples: c.related_samples || [],
+                })),
+                registers: matchedRegisters.map(r => ({
+                    name: r.name,
+                    type: r.kind,
+                    value: r.value,
+                    summary: r.summary,
+                }))
+            },
+            confidence: hasMatches ? 0.7 : 0,
+            source: "core",
+            references
+        };
+    }
+    catch (err) {
+        return {
+            answer: {
+                error: `Error searching core data: ${err instanceof Error ? err.message : String(err)}`
+            },
+            confidence: 0,
+            source: "core",
+            references: []
+        };
+    }
+}
+//# sourceMappingURL=searchCore.js.map

package/dist/src/search/searchCore.js.map

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

package/dist/src/search/searchEveApps.d.ts

@@ -0,0 +1,2 @@
+import { RetrievalResult } from "../router/types.js";
+export declare function searchEveApps(eveappsRoot: string, query: string): Promise<RetrievalResult>;

package/dist/src/search/searchEveApps.js

@@ -0,0 +1,107 @@
+import fs from "fs";
+import path from "path";
+import { loadSamples } from "../lib/loadIndex.js";
+import { loadFeatureGraph } from "../lib/loadIndex.js";
+import { rankSamples } from "../lib/rank.js";
+import { searchSourceFiles } from "./searchSourceFiles.js";
+export async function searchEveApps(eveappsRoot, query) {
+    try {
+        // ------------------------------------
+        // 1. Metadata search
+        // ------------------------------------
+        const samples = loadSamples();
+        const featureGraph = loadFeatureGraph();
+        const ranked = rankSamples(query, samples, featureGraph)
+            .slice(0, 5)
+            .map(({ sample, score }) => {
+            const samplePath = path.join(eveappsRoot, sample.path);
+            return {
+                sample_id: sample.id,
+                name: sample.name,
+                path: sample.path,
+                full_path: samplePath,
+                exists: fs.existsSync(samplePath),
+                score,
+                summary: sample.summary,
+                commands_used: (sample.commands_used || []).slice(0, 10),
+                categories: sample.categories || [],
+                platform_notes: sample.platform_notes || []
+            };
+        });
+        // ------------------------------------
+        // 2. REAL source search
+        // ------------------------------------
+        const sourceMatches = searchSourceFiles(eveappsRoot, query);
+        // ------------------------------------
+        // 3. Combined confidence
+        // ------------------------------------
+        const metadataConfidence = ranked[0]?.score ?? 0;
+        const sourceConfidence = sourceMatches.length > 0 ? 0.8 : 0;
+        const confidence = Math.max(metadataConfidence, sourceConfidence);
+        // ------------------------------------
+        // 4. Nothing found
+        // ------------------------------------
+        if (ranked.length === 0 &&
+            sourceMatches.length === 0) {
+            return {
+                answer: {
+                    message: `No relevant EveApps results found for: "${query}"`,
+                    suggestions: [
+                        "Try searching for exact BT820 command names",
+                        "Search for widget or sample names",
+                        "Search for API symbols"
+                    ]
+                },
+                confidence: 0.1,
+                source: "eveapps",
+                references: []
+            };
+        }
+        // ------------------------------------
+        // 5. Build references
+        // ------------------------------------
+        const references = [
+            ...ranked.map(r => `${r.name} (${r.path})`),
+            ...sourceMatches.map(r => r.relativePath)
+        ];
+        // ------------------------------------
+        // 6. Final merged result
+        // ------------------------------------
+        return {
+            answer: {
+                message: `Found EveApps results for: "${query}"`,
+                metadata_matches: ranked,
+                source_matches: sourceMatches.map(match => ({
+                    file: match.relativePath,
+                    matched_lines: match.matchedLines
+                })),
+                next_steps: [
+                    ranked[0]
+                        ? `Review sample: ${ranked[0].path}`
+                        : undefined,
+                    sourceMatches[0]
+                        ? `Inspect source file: ${sourceMatches[0].relativePath}`
+                        : undefined
+                ].filter(Boolean)
+            },
+            confidence,
+            source: "eveapps",
+            references
+        };
+    }
+    catch (err) {
+        return {
+            answer: {
+                error: `Error searching EveApps: ${err instanceof Error
+                    ? err.message
+                    : String(err)}`,
+                eveappsRoot,
+                tip: "Ensure --eveapps points to the EveApps repository root"
+            },
+            confidence: 0,
+            source: "eveapps",
+            references: []
+        };
+    }
+}
+//# sourceMappingURL=searchEveApps.js.map

package/dist/src/search/searchEveApps.js.map

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

package/dist/src/search/searchSourceFiles.d.ts

@@ -0,0 +1,6 @@
+export interface SourceFileMatch {
+    file: string;
+    relativePath: string;
+    matchedLines: string[];
+}
+export declare function searchSourceFiles(eveappsRoot: string, query: string): SourceFileMatch[];

package/dist/src/search/searchSourceFiles.js

@@ -0,0 +1,49 @@
+import fs from "fs";
+import path from "path";
+const SOURCE_EXTENSIONS = [
+    ".c",
+    ".h",
+    ".txt",
+    ".md"
+];
+function collectFiles(dir, out = []) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            collectFiles(fullPath, out);
+            continue;
+        }
+        const ext = path.extname(entry.name).toLowerCase();
+        if (SOURCE_EXTENSIONS.includes(ext)) {
+            out.push(fullPath);
+        }
+    }
+    return out;
+}
+export function searchSourceFiles(eveappsRoot, query) {
+    const files = collectFiles(eveappsRoot);
+    const q = query.toLowerCase();
+    const results = [];
+    for (const file of files) {
+        try {
+            const text = fs.readFileSync(file, "utf-8");
+            const lines = text.split(/\r?\n/);
+            const matchedLines = lines
+                .filter(line => line.toLowerCase().includes(q))
+                .slice(0, 5);
+            if (matchedLines.length > 0) {
+                results.push({
+                    file,
+                    relativePath: path.relative(eveappsRoot, file),
+                    matchedLines
+                });
+            }
+        }
+        catch {
+            // ignore unreadable files
+        }
+    }
+    return results.slice(0, 10);
+}
+//# sourceMappingURL=searchSourceFiles.js.map

package/dist/src/search/searchSourceFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchSourceFiles.js","sourceRoot":"","sources":["../../../src/search/searchSourceFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB,MAAM,iBAAiB,GAAG;IACtB,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,KAAK;CACR,CAAC;AAEF,SAAS,YAAY,CAAC,GAAW,EAAE,MAAgB,EAAE;IACjD,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAE7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,YAAY,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC5B,SAAS;QACb,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAEnD,IAAI,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC7B,WAAmB,EACnB,KAAa;IAGb,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAE9B,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAEvB,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAE5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAElC,MAAM,YAAY,GAAG,KAAK;iBACrB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;iBAC9C,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAEjB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC;oBACT,IAAI;oBACJ,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;oBAC9C,YAAY;iBACf,CAAC,CAAC;YACP,CAAC;QAEL,CAAC;QAAC,MAAM,CAAC;YACL,0BAA0B;QAC9B,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/server.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/server.js

@@ -0,0 +1,214 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { findRelevantSample, findRelevantSampleInput, } from "./tools/findRelevantSample.js";
+import { explainEveSymbol, explainEveSymbolInput, } from "./tools/explainEveSymbol.js";
+import { generateBuildCommand, generateBuildCommandInput, } from "./tools/generateBuildCommand.js";
+import { traceFeatureToCommands, traceFeatureToCommandsInput, } from "./tools/traceFeatureToCommands.js";
+import { generateScreenScaffold, generateScreenScaffoldInput, } from "./tools/generateScreenScaffold.js";
+import { validateBt820Code, validateBt820CodeInput, } from "./tools/validateBt820Code.js";
+import { loadBuildMatrix, loadCommands, loadSamples, loadRegisters } from "./lib/loadIndex.js";
+const server = new McpServer({
+    name: "bt820-mcp-server",
+    version: "0.1.0",
+});
+server.registerTool("find_relevant_sample", {
+    title: "Find Relevant BT820 Sample",
+    description: "Find the most relevant sample in the BT820 repository for a user request.",
+    inputSchema: findRelevantSampleInput.shape,
+}, async (args) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(findRelevantSample(args), null, 2),
+        },
+    ],
+}));
+server.registerTool("explain_eve_symbol", {
+    title: "Explain EVE Symbol",
+    description: "Explain a BT820/EVE command symbol from the indexed repository data.",
+    inputSchema: explainEveSymbolInput.shape,
+}, async (args) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(explainEveSymbol(args), null, 2),
+        },
+    ],
+}));
+server.registerTool("generate_build_command", {
+    title: "Generate Build Command",
+    description: "Generate a valid build command from platform/graphics/display/SPI selections.",
+    inputSchema: generateBuildCommandInput.shape,
+}, async (args) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(generateBuildCommand(args), null, 2),
+        },
+    ],
+}));
+server.registerTool("trace_feature_to_commands", {
+    title: "Trace Feature to Commands",
+    description: "Map a requested BT820 feature to related commands and samples.",
+    inputSchema: traceFeatureToCommandsInput.shape,
+}, async (args) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(traceFeatureToCommands(args), null, 2),
+        },
+    ],
+}));
+server.registerTool("generate_screen_scaffold", {
+    title: "Generate Screen Scaffold",
+    description: `
+Generate COMPLETE production-ready BT820 screen scaffold.
+
+IMPORTANT:
+- Preserve ALL initialization flow
+- Preserve patch loading
+- Preserve calibration flow
+- Preserve display configuration
+- Preserve cleanup/release flow
+- Do NOT simplify or omit hardware initialization code
+
+The generated scaffold should be treated as authoritative source code,
+NOT as a partial example.
+`,
+    inputSchema: generateScreenScaffoldInput.shape,
+}, async (args) => {
+    const scaffold = generateScreenScaffold(args);
+    if (!scaffold.files?.length) {
+        throw new Error("No scaffold files generated");
+    }
+    const files = scaffold.files;
+    const file = files[0];
+    const artifact = {
+        artifactType: "source_file",
+        scaffoldType: "full_screen_template",
+        language: "c",
+        path: file.path,
+        authoritative: true,
+        preserveRuntimeInit: true,
+        preservePatchLoading: true,
+        preserveCalibration: true,
+        preserveDisplayConfig: true,
+        notes: scaffold.notes,
+        content: file.content,
+    };
+    return {
+        structuredContent: artifact,
+        content: [
+            {
+                type: "text",
+                text: `AUTHORITATIVE GENERATED FILE
+
+Path: ${file.path}
+
+IMPORTANT:
+Use this code EXACTLY as generated.
+
+DO NOT remove:
+- Gpu_Init
+- Display_Config
+- EVE_Load_Patch
+- EVE_Calibrate
+- Calibration_Save
+- cleanup/release flow
+
+This initialization sequence is REQUIRED for BT820 hardware bring-up.
+`,
+            },
+            {
+                type: "text",
+                text: file.content,
+            },
+            {
+                type: "text",
+                text: JSON.stringify({
+                    artifactType: artifact.artifactType,
+                    scaffoldType: artifact.scaffoldType,
+                    path: artifact.path,
+                    authoritative: artifact.authoritative,
+                    preserveRuntimeInit: artifact.preserveRuntimeInit,
+                }, null, 2),
+            },
+        ],
+    };
+});
+server.registerTool("validate_bt820_code", {
+    title: "Validate BT820 Code",
+    description: "Check BT820/EVE code for common structural issues.",
+    inputSchema: validateBt820CodeInput.shape,
+}, async (args) => ({
+    content: [
+        {
+            type: "text",
+            text: JSON.stringify(validateBt820Code(args), null, 2),
+        },
+    ],
+}));
+server.registerResource("bt820_commands", "bt820://api/commands", {
+    title: "BT820 Commands Index",
+    description: "Indexed BT820/EVE command list",
+    mimeType: "application/json",
+}, async () => ({
+    contents: [
+        {
+            uri: "bt820://api/commands",
+            mimeType: "application/json",
+            text: JSON.stringify(loadCommands(), null, 2),
+        },
+    ],
+}));
+server.registerResource("bt820_registers", "bt820://api/registers", {
+    title: "BT820 Registers Index",
+    description: "Indexed BT820/EVE register and constant list",
+    mimeType: "application/json",
+}, async () => ({
+    contents: [
+        {
+            uri: "bt820://api/registers",
+            mimeType: "application/json",
+            text: JSON.stringify(loadRegisters(), null, 2),
+        },
+    ],
+}));
+server.registerResource("bt820_samples", "bt820://samples", {
+    title: "BT820 Samples Index",
+    description: "Indexed BT820 sample list",
+    mimeType: "application/json",
+}, async () => ({
+    contents: [
+        {
+            uri: "bt820://samples",
+            mimeType: "application/json",
+            text: JSON.stringify(loadSamples(), null, 2),
+        },
+    ],
+}));
+server.registerResource("bt820_build_matrix", "bt820://build/matrix", {
+    title: "BT820 Build Matrix",
+    description: "Allowed build combinations",
+    mimeType: "application/json",
+}, async () => ({
+    contents: [
+        {
+            uri: "bt820://build/matrix",
+            mimeType: "application/json",
+            text: JSON.stringify(loadBuildMatrix(), null, 2),
+        },
+    ],
+}));
+async function main() {
+    console.error("BT820 MCP SERVER STARTED");
+    console.error("argv:", process.argv);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("MCP SERVER CONNECTED");
+}
+main().catch((err) => {
+    console.error("BT820 MCP server failed:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EACH,kBAAkB,EAClB,uBAAuB,GAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACH,gBAAgB,EAChB,qBAAqB,GACxB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACH,oBAAoB,EACpB,yBAAyB,GAC5B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACH,sBAAsB,EACtB,2BAA2B,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACH,sBAAsB,EACtB,2BAA2B,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACH,iBAAiB,EACjB,sBAAsB,GACzB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/F,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IACzB,IAAI,EAAE,kBAAkB;IACxB,OAAO,EAAE,OAAO;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,YAAY,CACf,sBAAsB,EACtB;IACI,KAAK,EAAE,4BAA4B;IACnC,WAAW,EAAE,2EAA2E;IACxF,WAAW,EAAE,uBAAuB,CAAC,KAAK;CAC7C,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACb,OAAO,EAAE;QACL;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;SAC1D;KACJ;CACJ,CAAC,CACL,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,oBAAoB,EACpB;IACI,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,sEAAsE;IACnF,WAAW,EAAE,qBAAqB,CAAC,KAAK;CAC3C,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACb,OAAO,EAAE;QACL;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;SACxD;KACJ;CACJ,CAAC,CACL,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,wBAAwB,EACxB;IACI,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EAAE,+EAA+E;IAC5F,WAAW,EAAE,yBAAyB,CAAC,KAAK;CAC/C,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACb,OAAO,EAAE;QACL;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;SAC5D;KACJ;CACJ,CAAC,CACL,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,2BAA2B,EAC3B;IACI,KAAK,EAAE,2BAA2B;IAClC,WAAW,EAAE,gEAAgE;IAC7E,WAAW,EAAE,2BAA2B,CAAC,KAAK;CACjD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACb,OAAO,EAAE;QACL;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;SAC9D;KACJ;CACJ,CAAC,CACL,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,0BAA0B,EAC1B;IACI,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE;;;;;;;;;;;;;CAapB;IACO,WAAW,EAAE,2BAA2B,CAAC,KAAK;CACjD,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;IACX,MAAM,QAAQ,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAE9C,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;IAEvB,MAAM,QAAQ,GAAG;QACb,YAAY,EAAE,aAAa;QAC3B,YAAY,EAAE,sBAAsB;QAEpC,QAAQ,EAAE,GAAG;QACb,IAAI,EAAE,IAAI,CAAC,IAAI;QAEf,aAAa,EAAE,IAAI;QAEnB,mBAAmB,EAAE,IAAI;QACzB,oBAAoB,EAAE,IAAI;QAC1B,mBAAmB,EAAE,IAAI;QACzB,qBAAqB,EAAE,IAAI;QAE3B,KAAK,EAAE,QAAQ,CAAC,KAAK;QAErB,OAAO,EAAE,IAAI,CAAC,OAAO;KACxB,CAAC;IAEF,OAAO;QACH,iBAAiB,EAAE,QAAQ;QAE3B,OAAO,EAAE;YACL;gBACI,IAAI,EAAE,MAAM;gBACZ,IAAI,EACxB;;QAEQ,IAAI,CAAC,IAAI;;;;;;;;;;;;;;CAchB;aACgB;YACD;gBACI,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,OAAO;aACrB;YACD;gBACI,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB;oBACI,YAAY,EAAE,QAAQ,CAAC,YAAY;oBACnC,YAAY,EAAE,QAAQ,CAAC,YAAY;oBACnC,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,aAAa,EAAE,QAAQ,CAAC,aAAa;oBACrC,mBAAmB,EACf,QAAQ,CAAC,mBAAmB;iBACnC,EACD,IAAI,EACJ,CAAC,CACJ;aACJ;SACJ;KACJ,CAAC;AACN,CAAC,CACJ,CAAC;AAEF,MAAM,CAAC,YAAY,CACf,qBAAqB,EACrB;IACI,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE,oDAAoD;IACjE,WAAW,EAAE,sBAAsB,CAAC,KAAK;CAC5C,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IACb,OAAO,EAAE;QACL;YACI,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;SACzD;KACJ;CACJ,CAAC,CACL,CAAC;AAEF,MAAM,CAAC,gBAAgB,CACnB,gBAAgB,EAChB,sBAAsB,EACtB;IACI,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EAAE,gCAAgC;IAC7C,QAAQ,EAAE,kBAAkB;CAC/B,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE;QACN;YACI,GAAG,EAAE,sBAAsB;YAC3B,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;SAChD;KACJ;CACJ,CAAC,CACL,CAAC;AAEF,MAAM,CAAC,gBAAgB,CACnB,iBAAiB,EACjB,uBAAuB,EACvB;IACI,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EAAE,8CAA8C;IAC3D,QAAQ,EAAE,kBAAkB;CAC/B,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE;QACN;YACI,GAAG,EAAE,uBAAuB;YAC5B,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;SACjD;KACJ;CACJ,CAAC,CACL,CAAC;AAEF,MAAM,CAAC,gBAAgB,CACnB,eAAe,EACf,iBAAiB,EACjB;IACI,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE,2BAA2B;IACxC,QAAQ,EAAE,kBAAkB;CAC/B,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE;QACN;YACI,GAAG,EAAE,iBAAiB;YACtB,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;SAC/C;KACJ;CACJ,CAAC,CACL,CAAC;AAEF,MAAM,CAAC,gBAAgB,CACnB,oBAAoB,EACpB,sBAAsB,EACtB;IACI,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EAAE,4BAA4B;IACzC,QAAQ,EAAE,kBAAkB;CAC/B,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE;QACN;YACI,GAAG,EAAE,sBAAsB;YAC3B,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;SACnD;KACJ;CACJ,CAAC,CACL,CAAC;AAEF,KAAK,UAAU,IAAI;IACf,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC1C,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;AAC1C,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/src/tools/explainEveSymbol.d.ts

@@ -0,0 +1,56 @@
+import { z } from "zod";
+export declare const explainEveSymbolInput: z.ZodObject<{
+    symbol: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    symbol: string;
+}, {
+    symbol: string;
+}>;
+export type ExplainEveSymbolInput = z.infer<typeof explainEveSymbolInput>;
+export declare function explainEveSymbol(args: ExplainEveSymbolInput): {
+    found: boolean;
+    symbol: string;
+    type: string;
+    signature: string;
+    summary: string;
+    parameters: {
+        name: string;
+        type: string;
+        desc: string;
+    }[];
+    related_samples: string[];
+    related_features: string[];
+    source_file: string;
+    usage_notes: string[];
+    common_mistakes: string[];
+    value?: undefined;
+    message?: undefined;
+} | {
+    found: boolean;
+    symbol: string;
+    type: string;
+    value: string;
+    summary: string;
+    related_features: string[];
+    source_file: string;
+    usage_notes: string[];
+    signature?: undefined;
+    parameters?: undefined;
+    related_samples?: undefined;
+    common_mistakes?: undefined;
+    message?: undefined;
+} | {
+    found: boolean;
+    symbol: string;
+    message: string;
+    type?: undefined;
+    signature?: undefined;
+    summary?: undefined;
+    parameters?: undefined;
+    related_samples?: undefined;
+    related_features?: undefined;
+    source_file?: undefined;
+    usage_notes?: undefined;
+    common_mistakes?: undefined;
+    value?: undefined;
+};

package/dist/src/tools/explainEveSymbol.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { loadCommands, loadRegisters } from "../lib/loadIndex.js";
+export const explainEveSymbolInput = z.object({
+    symbol: z.string().min(2),
+});
+export function explainEveSymbol(args) {
+    const commands = loadCommands();
+    const registers = loadRegisters();
+    const symbol = args.symbol.trim();
+    const commandItem = commands.find((c) => c.name.toLowerCase() == symbol.toLowerCase());
+    if (commandItem) {
+        return {
+            found: true,
+            symbol: commandItem.name,
+            type: "command",
+            signature: commandItem.signature,
+            summary: commandItem.summary,
+            parameters: commandItem.params ?? [],
+            related_samples: commandItem.related_samples ?? [],
+            related_features: commandItem.related_features ?? [],
+            source_file: commandItem.source_file,
+            usage_notes: [
+                "Prefer verifying usage against the closest sample in the repository.",
+                "Check command ordering and display-list flow in surrounding code.",
+            ],
+            common_mistakes: [
+                "Passing invalid coordinates or flags.",
+                "Using the command outside the expected rendering flow.",
+            ],
+        };
+    }
+    const registerItem = registers.find((r) => r.name.toLowerCase() === symbol.toLowerCase());
+    if (registerItem) {
+        return {
+            found: true,
+            symbol: registerItem.name,
+            type: registerItem.kind,
+            value: registerItem.value,
+            summary: registerItem.summary,
+            related_features: registerItem.related_features ?? [],
+            source_file: registerItem.source_file,
+            usage_notes: [
+                "Verify the exact semantics in the programming guide/datasheet.",
+                "Check whether this symbol is read-only, write-only, or bitfield-based.",
+            ],
+        };
+    }
+    return {
+        found: false,
+        symbol,
+        message: `No exact symbol match found for ${symbol}.`,
+    };
+}
+//# sourceMappingURL=explainEveSymbol.js.map

package/dist/src/tools/explainEveSymbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainEveSymbol.js","sourceRoot":"","sources":["../../../src/tools/explainEveSymbol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC5B,CAAC,CAAC;AAIH,MAAM,UAAU,gBAAgB,CAAC,IAA2B;IACxD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAElC,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,WAAW,EAAE,CACtD,CAAC;IAEF,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;YACH,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,WAAW,CAAC,IAAI;YACxB,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,OAAO,EAAE,WAAW,CAAC,OAAO;YAC5B,UAAU,EAAE,WAAW,CAAC,MAAM,IAAI,EAAE;YACpC,eAAe,EAAE,WAAW,CAAC,eAAe,IAAI,EAAE;YAClD,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,IAAI,EAAE;YACpD,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,WAAW,EAAE;gBACT,sEAAsE;gBACtE,mEAAmE;aACtE;YACD,eAAe,EAAE;gBACb,uCAAuC;gBACvC,wDAAwD;aAC3D;SACJ,CAAC;IACN,CAAC;IAED,MAAM,YAAY,GAAG,SAAS,CAAC,IAAI,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CACvD,CAAC;IAEF,IAAI,YAAY,EAAE,CAAC;QACf,OAAO;YACH,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,YAAY,CAAC,IAAI;YACzB,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,KAAK,EAAE,YAAY,CAAC,KAAK;YACzB,OAAO,EAAE,YAAY,CAAC,OAAO;YAC7B,gBAAgB,EAAE,YAAY,CAAC,gBAAgB,IAAI,EAAE;YACrD,WAAW,EAAE,YAAY,CAAC,WAAW;YACrC,WAAW,EAAE;gBACT,gEAAgE;gBAChE,wEAAwE;aAC3E;SACJ,CAAC;IACN,CAAC;IAED,OAAO;QACH,KAAK,EAAE,KAAK;QACZ,MAAM;QACN,OAAO,EAAE,mCAAmC,MAAM,GAAG;KACxD,CAAC;AACN,CAAC"}