eveapps-core 1.0.0

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

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export declare const findRelevantSampleInput: z.ZodObject<{
+    query: z.ZodString;
+    platform: z.ZodOptional<z.ZodString>;
+    display: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+    display?: string | undefined;
+    platform?: string | undefined;
+}, {
+    query: string;
+    display?: string | undefined;
+    platform?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type FindRelevantSampleInput = z.infer<typeof findRelevantSampleInput>;
+export declare function findRelevantSample(args: FindRelevantSampleInput): {
+    matches: {
+        sample_id: string;
+        name: string;
+        path: string;
+        score: number;
+        summary: string;
+        commands: string[];
+        reason: string;
+    }[];
+    recommended_starting_point: string | null;
+    assumptions: {
+        platform: string | null;
+        display: string | null;
+    };
+};

package/dist/src/tools/findRelevantSample.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { loadFeatureGraph, loadSamples } from "../lib/loadIndex.js";
+import { rankSamples } from "../lib/rank.js";
+export const findRelevantSampleInput = z.object({
+    query: z.string().min(3),
+    platform: z.string().optional(),
+    display: z.string().optional(),
+    limit: z.number().int().min(1).max(10).default(3),
+});
+export function findRelevantSample(args) {
+    const samples = loadSamples();
+    const featureGraph = loadFeatureGraph();
+    const ranked = rankSamples(args.query, samples, featureGraph, args.platform)
+        .slice(0, args.limit)
+        .map(({ sample, score }) => ({
+        sample_id: sample.id,
+        name: sample.name,
+        path: sample.path,
+        score,
+        summary: sample.summary,
+        commands: sample.commands_used,
+        reason: `Matched query against sample summary/categories/commands${args.platform ? ` and preferred platform ${args.platform}` : ""}.`,
+    }));
+    return {
+        matches: ranked,
+        recommended_starting_point: ranked[0]?.sample_id ?? null,
+        assumptions: {
+            platform: args.platform ?? null,
+            display: args.display ?? null,
+        },
+    };
+}
+//# sourceMappingURL=findRelevantSample.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"findRelevantSample.js","sourceRoot":"","sources":["../../../src/tools/findRelevantSample.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACpD,CAAC,CAAC;AAIH,MAAM,UAAU,kBAAkB,CAAC,IAA6B;IAC5D,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IAExC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC;SACvE,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;SACpB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC,EAAE;QACpB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,aAAa;QAC9B,MAAM,EAAE,2DAA2D,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,2BAA2B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;KACxI,CAAC,CAAC,CAAC;IAER,OAAO;QACH,OAAO,EAAE,MAAM;QACf,0BAA0B,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,IAAI,IAAI;QACxD,WAAW,EAAE;YACT,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;SAChC;KACJ,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export declare const generateBuildCommandInput: z.ZodObject<{
+    platform: z.ZodString;
+    graphics: z.ZodString;
+    display: z.ZodString;
+    spi: z.ZodString;
+    toolchain: z.ZodDefault<z.ZodEnum<["cmake", "nmake"]>>;
+}, "strip", z.ZodTypeAny, {
+    graphics: string;
+    display: string;
+    platform: string;
+    spi: string;
+    toolchain: "cmake" | "nmake";
+}, {
+    graphics: string;
+    display: string;
+    platform: string;
+    spi: string;
+    toolchain?: "cmake" | "nmake" | undefined;
+}>;
+export type GenerateBuildCommandInput = z.infer<typeof generateBuildCommandInput>;
+export declare function generateBuildCommand(args: GenerateBuildCommandInput): {
+    valid: boolean;
+    errors: string[];
+    suggested_fixes: string[];
+    command?: undefined;
+    notes?: undefined;
+} | {
+    valid: boolean;
+    command: string;
+    notes: string[];
+    errors?: undefined;
+    suggested_fixes?: undefined;
+};

package/dist/src/tools/generateBuildCommand.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { loadBuildMatrix } from "../lib/loadIndex.js";
+export const generateBuildCommandInput = z.object({
+    platform: z.string(),
+    graphics: z.string(),
+    display: z.string(),
+    spi: z.string(),
+    toolchain: z.enum(["cmake", "nmake"]).default("cmake"),
+});
+export function generateBuildCommand(args) {
+    const matrix = loadBuildMatrix();
+    const platformKey = args.platform.toLowerCase();
+    const graphicsKey = args.graphics.toLowerCase();
+    const displayKey = args.display.toLowerCase();
+    const spiKey = args.spi.toLowerCase();
+    const platform = matrix.platforms[platformKey];
+    const errors = [];
+    if (!platform) {
+        errors.push(`Unknown platform: ${args.platform}`);
+    }
+    else {
+        if (!platform.graphics.includes(graphicsKey)) {
+            errors.push(`Platform ${args.platform} does not support graphics ${args.graphics}`);
+        }
+        if (!platform.spi.includes(spiKey)) {
+            errors.push(`Platform ${args.platform} does not support SPI mode ${args.spi}`);
+        }
+    }
+    if (!matrix.displays.includes(displayKey)) {
+        errors.push(`Unsupported display: ${args.display}`);
+    }
+    if (errors.length > 0) {
+        return {
+            valid: false,
+            errors,
+            suggested_fixes: [
+                "Check platform spelling in build_matrix.json",
+                "Use a display/SPI combination allowed by the repo",
+            ],
+        };
+    }
+    const command = args.toolchain === "cmake"
+        ? `cd build && cmake -G "NMake Makefiles" -DEVE_APPS_PLATFORM=EVE_PLATFORM_${args.platform.toUpperCase()} -DEVE_APPS_GRAPHICS=EVE_GRAPHICS_${args.graphics.toUpperCase()} -DEVE_APPS_DISPLAY=EVE_DISPLAY_${args.display.toUpperCase()} -DEVE_APPS_SPI=EVE_SPI_${args.spi.toUpperCase()}`
+        : `nmake SampleApp`;
+    return {
+        valid: true,
+        command,
+        notes: [
+            "Generated from local build_matrix.json",
+            "Add board-specific prerequisites separately if needed",
+        ],
+    };
+}
+//# sourceMappingURL=generateBuildCommand.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateBuildCommand.js","sourceRoot":"","sources":["../../../src/tools/generateBuildCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;CACzD,CAAC,CAAC;AAIH,MAAM,UAAU,oBAAoB,CAChC,IAA+B;IAE/B,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IAEtC,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACJ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ,8BAA8B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ,8BAA8B,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACnF,CAAC;IACL,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,wBAAwB,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO;YACH,KAAK,EAAE,KAAK;YACZ,MAAM;YACN,eAAe,EAAE;gBACb,8CAA8C;gBAC9C,mDAAmD;aACtD;SACJ,CAAC;IACN,CAAC;IAED,MAAM,OAAO,GACT,IAAI,CAAC,SAAS,KAAK,OAAO;QACtB,CAAC,CAAC,2EAA2E,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,qCAAqC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,mCAAmC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,2BAA2B,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE;QACxR,CAAC,CAAC,iBAAiB,CAAC;IAE5B,OAAO;QACH,KAAK,EAAE,IAAI;QACX,OAAO;QACP,KAAK,EAAE;YACH,wCAAwC;YACxC,uDAAuD;SAC1D;KACJ,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export declare const generateScreenScaffoldInput: z.ZodObject<{
+    screen_type: z.ZodString;
+    controls: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    touch: z.ZodDefault<z.ZodBoolean>;
+    platform: z.ZodOptional<z.ZodString>;
+    style: z.ZodDefault<z.ZodString>;
+    flash: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    style: string;
+    touch: boolean;
+    flash: boolean;
+    screen_type: string;
+    controls: string[];
+    platform?: string | undefined;
+}, {
+    screen_type: string;
+    style?: string | undefined;
+    touch?: boolean | undefined;
+    flash?: boolean | undefined;
+    platform?: string | undefined;
+    controls?: string[] | undefined;
+}>;
+export type GenerateScreenScaffoldInput = z.infer<typeof generateScreenScaffoldInput>;
+export declare function generateScreenScaffold(args: GenerateScreenScaffoldInput): {
+    based_on_sample: string;
+    files: {
+        path: string;
+        content: string;
+    }[];
+    notes: string[];
+};

package/dist/src/tools/generateScreenScaffold.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+export const generateScreenScaffoldInput = z.object({
+    screen_type: z.string(),
+    controls: z.array(z.string()).default([]),
+    touch: z.boolean().default(true),
+    platform: z.string().optional(),
+    style: z.string().default("repo-native-c"),
+    flash: z.boolean().default(false),
+});
+export function generateScreenScaffold(args) {
+    const functionName = `${args.screen_type.replace(/\s+/g, "_").toLowerCase()}_screen_draw`;
+    const includes = `#include "Common.h"
+#include "EvePatch.h"${args.flash ? `
+#include "FlashHelper.h"` : ""}`;
+    const displayMode = (() => {
+        const platform = args.platform?.toLowerCase() ?? "";
+        if (platform.includes("directvideo"))
+            return "MODE_DIRECTVIDEO";
+        if (platform.includes("video"))
+            return "MODE_VIDEO";
+        if (platform.includes("lvdsrx_sc"))
+            return "MODE_LVDSRX_SC";
+        if (platform.includes("lvdsrx"))
+            return "MODE_LVDSRX";
+        return "MODE_PICTURE";
+    })();
+    const content = `${includes}
+
+void ${functionName}(EVE_HalContext* phost) {
+    /* Initialize display and load patch */
+    s_pHalContext = &s_halContext;
+    Gpu_Init(s_pHalContext);
+    Display_Config(s_pHalContext, YCBCR, ${displayMode});
+
+    if (EVE_Load_Patch(s_pHalContext, PATCH_BASE) != 0)
+        eve_printf_debug("load patch failed\n");
+    else
+        eve_printf_debug("load patch ok\n");
+
+    // read and store calibration settings for later use
+    EVE_Calibrate(s_pHalContext);
+    Calibration_Save(s_pHalContext);
+
+    EVE_Util_clearScreen(s_pHalContext);
+
+    /* Title */
+    EVE_CoCmd_text(phost, 40, 30, 30, 0, "${args.screen_type}"); 
+
+    /* Controls */
+    ${args.controls.map((c, i) => `/* TODO: control ${i + 1}: ${c} */`).join("\n    ")}
+
+    ${args.touch ? "/* TODO: assign TAG values and handle touch routing */" : ""}
+
+    EVE_Util_clearScreen(s_pHalContext);
+    Gpu_Release(s_pHalContext);
+}
+`;
+    return {
+        based_on_sample: "to-be-selected-by-findRelevantSample",
+        files: [
+            {
+                path: `generated/${functionName}.c`,
+                content,
+            },
+        ],
+        notes: [
+            "Minimal scaffold only",
+            "You still need to add the proper frame begin/end flow",
+            "Use the nearest widget/touch sample as the implementation reference",
+        ],
+    };
+}
+//# sourceMappingURL=generateScreenScaffold.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generateScreenScaffold.js","sourceRoot":"","sources":["../../../src/tools/generateScreenScaffold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC;IAC1C,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACpC,CAAC,CAAC;AAIH,MAAM,UAAU,sBAAsB,CAAC,IAAiC;IACpE,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,cAAc,CAAC;IAE1F,MAAM,QAAQ,GAAG;uBACE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;yBACX,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAE7B,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACpD,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC;YAAE,OAAO,kBAAkB,CAAC;QAChE,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,YAAY,CAAC;QACpD,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;YAAE,OAAO,gBAAgB,CAAC;QAC5D,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,OAAO,aAAa,CAAC;QACtD,OAAO,cAAc,CAAC;IAC1B,CAAC,CAAC,EAAE,CAAC;IAEL,MAAM,OAAO,GAAG,GAAG,QAAQ;;OAExB,YAAY;;;;2CAIwB,WAAW;;;;;;;;;;;;;;4CAcV,IAAI,CAAC,WAAW;;;MAGtD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;;MAEhF,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,wDAAwD,CAAC,CAAC,CAAC,EAAE;;;;;CAK/E,CAAC;IAEE,OAAO;QACH,eAAe,EAAE,sCAAsC;QACvD,KAAK,EAAE;YACH;gBACI,IAAI,EAAE,aAAa,YAAY,IAAI;gBACnC,OAAO;aACV;SACJ;QACD,KAAK,EAAE;YACH,uBAAuB;YACvB,uDAAuD;YACvD,qEAAqE;SACxE;KACJ,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,36 @@
+import { z } from "zod";
+export declare const traceFeatureToCommandsInput: z.ZodObject<{
+    feature: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    feature: string;
+}, {
+    feature: string;
+}>;
+export type TraceFeatureToCommandsInput = z.infer<typeof traceFeatureToCommandsInput>;
+type Command = {
+    name: string;
+    type?: string;
+    level?: string;
+    weight?: number;
+};
+export declare function traceFeatureToCommands(args: TraceFeatureToCommandsInput): {
+    message: string;
+    features_detected?: undefined;
+    top_commands?: undefined;
+    all_commands?: undefined;
+    related_samples?: undefined;
+    next_steps?: undefined;
+} | {
+    features_detected: string[];
+    top_commands: {
+        name: string;
+        type: string | undefined;
+        level: string | undefined;
+        reason: string;
+    }[];
+    all_commands: Command[];
+    related_samples: string[];
+    next_steps: string[];
+    message?: undefined;
+};
+export {};

package/dist/src/tools/traceFeatureToCommands.js

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import { loadFeatureGraph } from "../lib/loadIndex.js";
+export const traceFeatureToCommandsInput = z.object({
+    feature: z.string().min(2),
+});
+export function traceFeatureToCommands(args) {
+    const graph = loadFeatureGraph();
+    const input = args.feature.toLowerCase();
+    //callback
+    const matches = Object.entries(graph)
+        .filter(([feature, meta]) => {
+        return (input.includes(feature.toLowerCase()) ||
+            meta.keywords.some((k) => input.includes(k.toLowerCase())));
+    })
+        .map(([feature, meta]) => ({
+        feature,
+        commands: meta.commands,
+        samples: meta.samples,
+    }));
+    if (matches.length === 0) {
+        return {
+            message: "No matching feature found.",
+        };
+    }
+    // commands
+    const allCommands = matches.flatMap((m) => m.commands);
+    // remove duplicate and keep weight
+    const dedup = new Map();
+    for (const cmd of allCommands) {
+        const existing = dedup.get(cmd.name);
+        if (!existing || (cmd.weight ?? 0) > (existing.weight ?? 0)) {
+            dedup.set(cmd.name, cmd);
+        }
+    }
+    const uniqueCommands = Array.from(dedup.values());
+    // sort
+    const ranked = uniqueCommands.sort((a, b) => {
+        const wa = a.weight ?? 0;
+        const wb = b.weight ?? 0;
+        if (wb !== wa)
+            return wb - wa;
+        // high-level API
+        if (a.level === "high" && b.level !== "high")
+            return -1;
+        if (b.level === "high" && a.level !== "high")
+            return 1;
+        return 0;
+    });
+    // remove duplicate
+    const samples = [
+        ...new Set(matches.flatMap((m) => m.samples)),
+    ];
+    // explain
+    function explain(cmd) {
+        if (cmd.type === "coprocessor") {
+            return "High-level API, recommended for UI development";
+        }
+        if (cmd.type === "display_list") {
+            return "Low-level rendering command";
+        }
+        if (cmd.type === "hal") {
+            return "Hardware-level API";
+        }
+        return "Related command";
+    }
+    // output
+    return {
+        features_detected: matches.map((m) => m.feature),
+        top_commands: ranked.slice(0, 5).map((c) => ({
+            name: c.name,
+            type: c.type,
+            level: c.level,
+            reason: explain(c),
+        })),
+        all_commands: ranked, // context to AI
+        related_samples: samples.slice(0, 5),
+        next_steps: [
+            "Start with top_commands (prefer high-level APIs)",
+            "Refer to related_samples for working examples",
+            "Integrate commands into your rendering loop",
+        ],
+    };
+}
+//# sourceMappingURL=traceFeatureToCommands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traceFeatureToCommands.js","sourceRoot":"","sources":["../../../src/tools/traceFeatureToCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAC;AAaH,MAAM,UAAU,sBAAsB,CAClC,IAAiC;IAEjC,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAEzC,UAAU;IACV,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;QACxB,OAAO,CACH,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAC7B,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAClC,CACJ,CAAC;IACN,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACvB,OAAO;QACP,QAAQ,EAAE,IAAI,CAAC,QAAqB;QACpC,OAAO,EAAE,IAAI,CAAC,OAAmB;KACpC,CAAC,CAAC,CAAC;IAER,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACH,OAAO,EAAE,4BAA4B;SACxC,CAAC;IACN,CAAC;IAED,WAAW;IACX,MAAM,WAAW,GAAc,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAElE,mCAAmC;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IAEzC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAErC,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC;YAC1D,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAElD,OAAO;IACP,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACxC,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QACzB,MAAM,EAAE,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QAEzB,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAE9B,iBAAiB;QACjB,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,CAAC;QAEvD,OAAO,CAAC,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,mBAAmB;IACnB,MAAM,OAAO,GAAG;QACZ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;KAChD,CAAC;IAEF,UAAU;IACV,SAAS,OAAO,CAAC,GAAY;QACzB,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAC7B,OAAO,gDAAgD,CAAC;QAC5D,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YAC9B,OAAO,6BAA6B,CAAC;QACzC,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO,oBAAoB,CAAC;QAChC,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC7B,CAAC;IAED,SAAS;IACT,OAAO;QACH,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAEhD,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;SACrB,CAAC,CAAC;QAEH,YAAY,EAAE,MAAM,EAAE,gBAAgB;QAEtC,eAAe,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAEpC,UAAU,EAAE;YACR,kDAAkD;YAClD,+CAA+C;YAC/C,6CAA6C;SAChD;KACJ,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,28 @@
+import { z } from "zod";
+export declare const validateBt820CodeInput: z.ZodObject<{
+    code: z.ZodString;
+    platform: z.ZodOptional<z.ZodString>;
+    display: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    display?: string | undefined;
+    platform?: string | undefined;
+}, {
+    code: string;
+    display?: string | undefined;
+    platform?: string | undefined;
+}>;
+export type ValidateBt820CodeInput = z.infer<typeof validateBt820CodeInput>;
+export declare function validateBt820Code(args: ValidateBt820CodeInput): {
+    issues: {
+        severity: "high" | "medium" | "low";
+        title: string;
+        detail: string;
+        suggestion: string;
+    }[];
+    summary: {
+        high: number;
+        medium: number;
+        low: number;
+    };
+};

package/dist/src/tools/validateBt820Code.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+export const validateBt820CodeInput = z.object({
+    code: z.string().min(1),
+    platform: z.string().optional(),
+    display: z.string().optional(),
+});
+export function validateBt820Code(args) {
+    const code = args.code;
+    const issues = [];
+    if (!/EVE_CoCmd_text|EVE_CoCmd_button|EVE_CoCmd_/m.test(code)) {
+        issues.push({
+            severity: "low",
+            title: "No obvious coprocessor commands detected",
+            detail: "The snippet does not appear to use known EVE command helpers.",
+            suggestion: "Check whether this is the intended rendering layer.",
+        });
+    }
+    const tagMatches = [...code.matchAll(/\bTAG\s*\(\s*(\d+)\s*\)/g)].map((m) => m[1]);
+    const duplicates = tagMatches.filter((tag, i) => tagMatches.indexOf(tag) !== i);
+    if (duplicates.length > 0) {
+        issues.push({
+            severity: "medium",
+            title: "Duplicate touch tag values",
+            detail: `Repeated TAG ids found: ${[...new Set(duplicates)].join(", ")}`,
+            suggestion: "Assign unique TAG values to each interactive control.",
+        });
+    }
+    if (!/DISPLAY|swap|Swap|DL_DISPLAY/i.test(code)) {
+        issues.push({
+            severity: "medium",
+            title: "Possible incomplete frame/display-list sequence",
+            detail: "No obvious display termination or swap marker found.",
+            suggestion: "Verify the display-list end and frame swap sequence.",
+        });
+    }
+    return {
+        issues,
+        summary: {
+            high: issues.filter((i) => i.severity === "high").length,
+            medium: issues.filter((i) => i.severity === "medium").length,
+            low: issues.filter((i) => i.severity === "low").length,
+        },
+    };
+}
+//# sourceMappingURL=validateBt820Code.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validateBt820Code.js","sourceRoot":"","sources":["../../../src/tools/validateBt820Code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAIH,MAAM,UAAU,iBAAiB,CAAC,IAA4B;IAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACvB,MAAM,MAAM,GAKP,EAAE,CAAC;IAER,IAAI,CAAC,6CAA6C,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC;YACR,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,0CAA0C;YACjD,MAAM,EAAE,+DAA+D;YACvE,UAAU,EAAE,qDAAqD;SACpE,CAAC,CAAC;IACP,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAChF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC;YACR,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,4BAA4B;YACnC,MAAM,EAAE,2BAA2B,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACxE,UAAU,EAAE,uDAAuD;SACtE,CAAC,CAAC;IACP,CAAC;IAED,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC;YACR,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,iDAAiD;YACxD,MAAM,EAAE,sDAAsD;YAC9D,UAAU,EAAE,sDAAsD;SACrE,CAAC,CAAC;IACP,CAAC;IAED,OAAO;QACH,MAAM;QACN,OAAO,EAAE;YACL,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;YACxD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,MAAM;YAC5D,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,MAAM;SACzD;KACJ,CAAC;AACN,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,44 @@
+export interface CommandIndexItem {
+    name: string;
+    category: string;
+    signature: string;
+    summary: string;
+    params?: Array<{
+        name: string;
+        type: string;
+        desc: string;
+    }>;
+    related_samples?: string[];
+    related_features?: string[];
+    source_file: string;
+}
+export interface SampleIndexItem {
+    id: string;
+    name: string;
+    path: string;
+    categories: string[];
+    summary: string;
+    commands_used: string[];
+    platform_notes?: string[];
+    assets_required?: string[];
+    difficulty?: "beginner" | "intermediate" | "advanced";
+    keywords?: string[];
+}
+export type Command = {
+    name: string;
+    type: string;
+    level: string;
+    weight: number;
+};
+export interface FeatureGraphItem {
+    commands: Command[];
+    samples: string[];
+    keywords: string[];
+}
+export interface BuildMatrix {
+    platforms: Record<string, {
+        graphics: string[];
+        spi: string[];
+    }>;
+    displays: string[];
+}

package/dist/src/types.js

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

package/dist/src/types.js.map

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

package/dist/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/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/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"}