crosspad-mcp-server 4.0.0

package/dist/tools/architecture.js

@@ -0,0 +1,198 @@
+import fs from "fs";
+import path from "path";
+import { REPOS } from "../config.js";
+import { runCommand } from "../utils/exec.js";
+function findInterfaces() {
+    const coreInclude = path.join(REPOS["crosspad-core"], "include", "crosspad");
+    const results = [];
+    function scan(dir) {
+        if (!fs.existsSync(dir))
+            return;
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                scan(fullPath);
+            }
+            else if (entry.name.startsWith("I") && entry.name.endsWith(".hpp")) {
+                // Extract class name from file
+                const content = fs.readFileSync(fullPath, "utf-8");
+                const match = content.match(/class\s+(I[A-Z]\w+)\b/);
+                if (match) {
+                    results.push({
+                        name: match[1],
+                        file: fullPath.replace(/\\/g, "/"),
+                    });
+                }
+            }
+        }
+    }
+    scan(coreInclude);
+    return results;
+}
+function findImplementations(interfaceName) {
+    const results = [];
+    const pattern = `class\\s+\\w+.*:\\s*(public\\s+)?.*${interfaceName}`;
+    const platformMap = {
+        "crosspad-core": "shared",
+        "crosspad-gui": "gui",
+        "crosspad-pc": "PC",
+        "ESP32-S3": "ESP32-S3",
+        "2playerCrosspad": "2player",
+    };
+    for (const [name, repoPath] of Object.entries(REPOS)) {
+        if (!fs.existsSync(repoPath))
+            continue;
+        const result = runCommand(`git grep -n -E "${pattern}" -- "*.hpp" "*.cpp" "*.h"`, repoPath);
+        if (!result.success && result.stdout.length === 0)
+            continue;
+        for (const line of result.stdout.split("\n")) {
+            if (!line.trim())
+                continue;
+            const colonIdx = line.indexOf(":");
+            if (colonIdx < 0)
+                continue;
+            const filePart = line.slice(0, colonIdx);
+            const codePart = line.slice(colonIdx + 1);
+            // Extract the line number and code
+            const lineNumMatch = codePart.match(/^(\d+):(.*)/);
+            const code = lineNumMatch ? lineNumMatch[2] : codePart;
+            const classMatch = code.match(/class\s+(\w+)/);
+            if (classMatch) {
+                results.push({
+                    className: classMatch[1],
+                    file: path.join(repoPath, filePart).replace(/\\/g, "/"),
+                    platform: platformMap[name] ?? name,
+                });
+            }
+        }
+    }
+    return results;
+}
+function queryCapabilities() {
+    const capsFile = path.join(REPOS["crosspad-core"], "include", "crosspad", "platform", "PlatformCapabilities.hpp");
+    // Parse enum flags
+    const flags = [];
+    if (fs.existsSync(capsFile)) {
+        const content = fs.readFileSync(capsFile, "utf-8");
+        const enumMatch = content.match(/enum\s+class\s+Capability[^{]*\{([^}]+)\}/s);
+        if (enumMatch) {
+            for (const line of enumMatch[1].split("\n")) {
+                const flagMatch = line.match(/\b(\w+)\s*=/);
+                if (flagMatch && flagMatch[1] !== "None" && flagMatch[1] !== "All") {
+                    flags.push(flagMatch[1]);
+                }
+            }
+        }
+    }
+    // Find which platforms set which caps
+    const platforms = {};
+    const platformMap = {
+        "crosspad-pc": "PC",
+        "ESP32-S3": "ESP32-S3",
+        "2playerCrosspad": "2player",
+    };
+    for (const [name, repoPath] of Object.entries(REPOS)) {
+        if (!platformMap[name])
+            continue;
+        if (!fs.existsSync(repoPath))
+            continue;
+        const result = runCommand(`git grep -h "addPlatformCapability\\|setPlatformCapabilities" -- "*.cpp" "*.hpp" "*.h"`, repoPath);
+        if (!result.success && result.stdout.length === 0)
+            continue;
+        const caps = [];
+        for (const line of result.stdout.split("\n")) {
+            const matches = line.match(/Capability::(\w+)/g);
+            if (matches) {
+                for (const m of matches) {
+                    const cap = m.replace("Capability::", "");
+                    if (!caps.includes(cap))
+                        caps.push(cap);
+                }
+            }
+        }
+        if (caps.length > 0) {
+            platforms[platformMap[name]] = caps;
+        }
+    }
+    return { flags, platforms };
+}
+export function crosspadInterfaces(query) {
+    const parts = query.trim().split(/\s+/);
+    const command = parts[0]?.toLowerCase();
+    if (command === "list") {
+        return { interfaces: findInterfaces() };
+    }
+    if (command === "implementations" && parts[1]) {
+        const interfaceName = parts[1];
+        const interfaces = findInterfaces();
+        const defined = interfaces.find((i) => i.name === interfaceName);
+        return {
+            interface: interfaceName,
+            defined_in: defined?.file ?? "not found",
+            implementations: findImplementations(interfaceName),
+        };
+    }
+    if (command === "capabilities") {
+        const caps = queryCapabilities();
+        return { flags: caps.flags, platforms: caps.platforms };
+    }
+    return {
+        error: `Unknown query: "${query}". Use "list", "implementations <InterfaceName>", or "capabilities".`,
+    };
+}
+export function crosspadApps(platform) {
+    const results = [];
+    const targets = [];
+    if (platform === "pc" || platform === "all")
+        targets.push(["PC", REPOS["crosspad-pc"]]);
+    if (platform === "esp32" || platform === "all")
+        targets.push(["ESP32-S3", REPOS["ESP32-S3"]]);
+    if (platform === "2player" || platform === "all")
+        targets.push(["2player", REPOS["2playerCrosspad"]]);
+    for (const [platName, repoPath] of targets) {
+        if (!fs.existsSync(repoPath))
+            continue;
+        // Search for REGISTER_APP and _register_*_app patterns
+        const result = runCommand(`git grep -n -E "REGISTER_APP\\(|void _register_\\w+_app\\(\\)" -- "*.cpp"`, repoPath);
+        if (!result.success && result.stdout.length === 0)
+            continue;
+        for (const line of result.stdout.split("\n")) {
+            if (!line.trim())
+                continue;
+            const colonIdx = line.indexOf(":");
+            if (colonIdx < 0)
+                continue;
+            const filePart = line.slice(0, colonIdx);
+            const rest = line.slice(colonIdx + 1);
+            // REGISTER_APP(Name, ...)
+            let match = rest.match(/REGISTER_APP\((\w+)/);
+            if (match) {
+                results.push({
+                    name: match[1],
+                    registration_file: filePart,
+                    platform: platName,
+                });
+                continue;
+            }
+            // void _register_Name_app()
+            match = rest.match(/_register_(\w+)_app\(/);
+            if (match) {
+                results.push({
+                    name: match[1],
+                    registration_file: filePart,
+                    platform: platName,
+                });
+            }
+        }
+    }
+    // Deduplicate by name+platform
+    const seen = new Set();
+    return results.filter((app) => {
+        const key = `${app.platform}:${app.name}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=architecture.js.map

package/dist/tools/architecture.js.map

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

package/dist/tools/build-check.d.ts

@@ -0,0 +1,23 @@
+export interface BuildCheckResult {
+    needs_reconfigure: boolean;
+    needs_rebuild: boolean;
+    exe_exists: boolean;
+    exe_age_seconds: number | null;
+    reasons: string[];
+    submodule_changes: Record<string, {
+        pinned: string | null;
+        current: string | null;
+        changed: boolean;
+    }>;
+    new_source_files: string[];
+}
+/**
+ * Detect whether cmake reconfigure or rebuild is needed.
+ * Checks:
+ * - Does build/ dir exist?
+ * - Does bin/main.exe exist?
+ * - Are there new .cpp/.hpp files not in CMakeCache?
+ * - Did crosspad-core or crosspad-gui HEAD change vs pinned?
+ * - Are there uncommitted changes in source?
+ */
+export declare function crosspadBuildCheck(): BuildCheckResult;

package/dist/tools/build-check.js

@@ -0,0 +1,162 @@
+import fs from "fs";
+import path from "path";
+import { CROSSPAD_PC_ROOT, BUILD_DIR, BIN_EXE } from "../config.js";
+import { runCommand } from "../utils/exec.js";
+import { getSubmodulePin } from "../utils/git.js";
+/**
+ * Detect whether cmake reconfigure or rebuild is needed.
+ * Checks:
+ * - Does build/ dir exist?
+ * - Does bin/main.exe exist?
+ * - Are there new .cpp/.hpp files not in CMakeCache?
+ * - Did crosspad-core or crosspad-gui HEAD change vs pinned?
+ * - Are there uncommitted changes in source?
+ */
+export function crosspadBuildCheck() {
+    const reasons = [];
+    let needsReconfigure = false;
+    let needsRebuild = false;
+    // Check build dir
+    const buildExists = fs.existsSync(BUILD_DIR);
+    if (!buildExists) {
+        needsReconfigure = true;
+        reasons.push("build/ directory does not exist — need full configure");
+    }
+    // Check exe
+    const exeExists = fs.existsSync(BIN_EXE);
+    let exeAgeSeconds = null;
+    if (exeExists) {
+        const stat = fs.statSync(BIN_EXE);
+        exeAgeSeconds = (Date.now() - stat.mtimeMs) / 1000;
+    }
+    else {
+        needsRebuild = true;
+        reasons.push(`${path.relative(CROSSPAD_PC_ROOT, BIN_EXE)} not found — need build`);
+    }
+    // Check for source files newer than exe
+    if (exeExists) {
+        const exeMtime = fs.statSync(BIN_EXE).mtimeMs;
+        const srcDirs = [
+            path.join(CROSSPAD_PC_ROOT, "src"),
+            path.join(CROSSPAD_PC_ROOT, "crosspad-core", "src"),
+            path.join(CROSSPAD_PC_ROOT, "crosspad-core", "include"),
+            path.join(CROSSPAD_PC_ROOT, "crosspad-gui", "src"),
+            path.join(CROSSPAD_PC_ROOT, "crosspad-gui", "include"),
+        ];
+        let newerCount = 0;
+        for (const dir of srcDirs) {
+            if (!fs.existsSync(dir))
+                continue;
+            newerCount += countFilesNewerThan(dir, exeMtime, [".cpp", ".hpp", ".h", ".c"]);
+            if (newerCount > 0)
+                break; // One is enough
+        }
+        if (newerCount > 0) {
+            needsRebuild = true;
+            reasons.push("Source files are newer than executable");
+        }
+    }
+    // Check for new source files not tracked by CMake (GLOB_RECURSE freshness)
+    const newSourceFiles = [];
+    if (buildExists) {
+        const cacheFile = path.join(BUILD_DIR, "build.ninja");
+        if (fs.existsSync(cacheFile)) {
+            const ninjaContent = fs.readFileSync(cacheFile, "utf-8");
+            // Find .cpp files in src/apps that aren't in build.ninja
+            const appsDir = path.join(CROSSPAD_PC_ROOT, "src", "apps");
+            if (fs.existsSync(appsDir)) {
+                const cppFiles = findFiles(appsDir, [".cpp"]);
+                for (const f of cppFiles) {
+                    const relative = path.relative(CROSSPAD_PC_ROOT, f).replace(/\\/g, "/");
+                    if (!ninjaContent.includes(relative) && !ninjaContent.includes(path.basename(f))) {
+                        newSourceFiles.push(relative);
+                    }
+                }
+            }
+        }
+    }
+    if (newSourceFiles.length > 0) {
+        needsReconfigure = true;
+        reasons.push(`${newSourceFiles.length} source file(s) not in build system — need reconfigure`);
+    }
+    // Submodule changes (dev-mode aware)
+    const submoduleChanges = {};
+    for (const sub of ["crosspad-core", "crosspad-gui"]) {
+        const pinned = getSubmodulePin(CROSSPAD_PC_ROOT, sub);
+        const subPath = path.join(CROSSPAD_PC_ROOT, sub);
+        let current = null;
+        if (fs.existsSync(subPath)) {
+            // In dev-mode (junction), get HEAD of the junction target
+            const result = runCommand("git rev-parse HEAD", subPath);
+            current = result.success ? result.stdout.trim() : null;
+        }
+        const changed = pinned !== null && current !== null && !current.startsWith(pinned.slice(0, 7));
+        submoduleChanges[sub] = { pinned, current, changed };
+        if (changed) {
+            needsRebuild = true;
+            reasons.push(`${sub} HEAD differs from pinned commit`);
+        }
+        // Check for dirty files in submodule
+        if (fs.existsSync(subPath)) {
+            const dirty = runCommand("git status --porcelain", subPath);
+            if (dirty.success && dirty.stdout.trim().length > 0) {
+                const dirtyCount = dirty.stdout.trim().split("\n").length;
+                needsRebuild = true;
+                reasons.push(`${sub} has ${dirtyCount} dirty file(s)`);
+            }
+        }
+    }
+    if (reasons.length === 0) {
+        reasons.push("Build appears up to date");
+    }
+    return {
+        needs_reconfigure: needsReconfigure,
+        needs_rebuild: needsRebuild || needsReconfigure,
+        exe_exists: exeExists,
+        exe_age_seconds: exeAgeSeconds !== null ? Math.round(exeAgeSeconds) : null,
+        reasons,
+        submodule_changes: submoduleChanges,
+        new_source_files: newSourceFiles,
+    };
+}
+function countFilesNewerThan(dir, thresholdMs, extensions) {
+    let count = 0;
+    try {
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                count += countFilesNewerThan(fullPath, thresholdMs, extensions);
+            }
+            else if (extensions.some((ext) => entry.name.endsWith(ext))) {
+                const stat = fs.statSync(fullPath);
+                if (stat.mtimeMs > thresholdMs)
+                    count++;
+            }
+            if (count > 0)
+                return count; // Early exit
+        }
+    }
+    catch {
+        // Ignore permission errors etc.
+    }
+    return count;
+}
+function findFiles(dir, extensions) {
+    const results = [];
+    try {
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                results.push(...findFiles(fullPath, extensions));
+            }
+            else if (extensions.some((ext) => entry.name.endsWith(ext))) {
+                results.push(fullPath);
+            }
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return results;
+}
+//# sourceMappingURL=build-check.js.map

package/dist/tools/build-check.js.map

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

package/dist/tools/build.d.ts

@@ -0,0 +1,14 @@
+import { OnLine } from "../utils/exec.js";
+export interface BuildResult {
+    success: boolean;
+    duration_seconds: number;
+    errors: string[];
+    warnings_count: number;
+    output_path: string;
+}
+export declare function crosspadBuild(mode: "incremental" | "clean" | "reconfigure", onLine?: OnLine): Promise<BuildResult>;
+export interface RunResult {
+    pid: number | null;
+    exe_path: string;
+}
+export declare function crosspadRun(): RunResult;

package/dist/tools/build.js

@@ -0,0 +1,101 @@
+import fs from "fs";
+import { CROSSPAD_PC_ROOT, BUILD_DIR, BIN_EXE, VCPKG_TOOLCHAIN, IS_WINDOWS } from "../config.js";
+import { runBuild, runBuildStream, spawnDetached } from "../utils/exec.js";
+function parseErrors(output) {
+    const errors = [];
+    for (const line of output.split("\n")) {
+        if (/\berror\b/i.test(line) && !line.includes("error(s)")) {
+            errors.push(line.trim());
+        }
+    }
+    return errors.slice(0, 20); // Cap at 20 errors
+}
+function countWarnings(output) {
+    let count = 0;
+    for (const line of output.split("\n")) {
+        if (/\bwarning\b/i.test(line) && !line.includes("warning(s)")) {
+            count++;
+        }
+    }
+    return count;
+}
+export async function crosspadBuild(mode, onLine) {
+    const startTime = Date.now();
+    // Clean: remove build dir
+    if (mode === "clean" && fs.existsSync(BUILD_DIR)) {
+        onLine?.("stdout", "[crosspad] Cleaning build directory...");
+        fs.rmSync(BUILD_DIR, { recursive: true, force: true });
+    }
+    // Configure if clean or reconfigure
+    if (mode === "clean" || mode === "reconfigure") {
+        const generator = process.env.CMAKE_GENERATOR || (IS_WINDOWS ? "Ninja" : "");
+        const genFlag = generator ? ` -G ${generator}` : "";
+        const configCmd = [
+            `cmake -B build${genFlag}`,
+            `-DCMAKE_TOOLCHAIN_FILE=${VCPKG_TOOLCHAIN}`,
+            "-DCMAKE_BUILD_TYPE=Debug",
+        ].join(" ");
+        onLine?.("stdout", `[crosspad] Configuring: ${mode}...`);
+        if (onLine) {
+            const configResult = await runBuildStream(configCmd, CROSSPAD_PC_ROOT, onLine, 600_000);
+            if (!configResult.success) {
+                const combined = configResult.stdout + "\n" + configResult.stderr;
+                return {
+                    success: false,
+                    duration_seconds: (Date.now() - startTime) / 1000,
+                    errors: parseErrors(combined),
+                    warnings_count: countWarnings(combined),
+                    output_path: BIN_EXE,
+                };
+            }
+        }
+        else {
+            const configResult = runBuild(configCmd, CROSSPAD_PC_ROOT, 600_000);
+            if (!configResult.success) {
+                const combined = configResult.stdout + "\n" + configResult.stderr;
+                return {
+                    success: false,
+                    duration_seconds: (Date.now() - startTime) / 1000,
+                    errors: parseErrors(combined),
+                    warnings_count: countWarnings(combined),
+                    output_path: BIN_EXE,
+                };
+            }
+        }
+    }
+    // Build
+    onLine?.("stdout", "[crosspad] Building...");
+    let buildStdout;
+    let buildStderr;
+    let buildSuccess;
+    if (onLine) {
+        const buildResult = await runBuildStream("cmake --build build", CROSSPAD_PC_ROOT, onLine, 600_000);
+        buildStdout = buildResult.stdout;
+        buildStderr = buildResult.stderr;
+        buildSuccess = buildResult.success;
+    }
+    else {
+        const buildResult = runBuild("cmake --build build", CROSSPAD_PC_ROOT, 600_000);
+        buildStdout = buildResult.stdout;
+        buildStderr = buildResult.stderr;
+        buildSuccess = buildResult.success;
+    }
+    const combined = buildStdout + "\n" + buildStderr;
+    const result = {
+        success: buildSuccess,
+        duration_seconds: (Date.now() - startTime) / 1000,
+        errors: parseErrors(combined),
+        warnings_count: countWarnings(combined),
+        output_path: BIN_EXE,
+    };
+    onLine?.("stdout", `[crosspad] Build ${result.success ? "succeeded" : "FAILED"} in ${result.duration_seconds.toFixed(1)}s`);
+    return result;
+}
+export function crosspadRun() {
+    if (!fs.existsSync(BIN_EXE)) {
+        return { pid: null, exe_path: BIN_EXE };
+    }
+    const pid = spawnDetached(BIN_EXE, [], CROSSPAD_PC_ROOT);
+    return { pid, exe_path: BIN_EXE };
+}
+//# sourceMappingURL=build.js.map

package/dist/tools/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/tools/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAU,MAAM,kBAAkB,CAAC;AAUnF,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB;AACjD,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9D,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAA6C,EAC7C,MAAe;IAEf,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,0BAA0B;IAC1B,IAAI,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACjD,MAAM,EAAE,CAAC,QAAQ,EAAE,wCAAwC,CAAC,CAAC;QAC7D,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,oCAAoC;IACpC,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG;YAChB,iBAAiB,OAAO,EAAE;YAC1B,0BAA0B,eAAe,EAAE;YAC3C,0BAA0B;SAC3B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEZ,MAAM,EAAE,CAAC,QAAQ,EAAE,2BAA2B,IAAI,KAAK,CAAC,CAAC;QAEzD,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;YACxF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,GAAG,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC;gBAClE,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,gBAAgB,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI;oBACjD,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;oBAC7B,cAAc,EAAE,aAAa,CAAC,QAAQ,CAAC;oBACvC,WAAW,EAAE,OAAO;iBACrB,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,YAAY,GAAG,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;YACpE,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,GAAG,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC;gBAClE,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,gBAAgB,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI;oBACjD,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;oBAC7B,cAAc,EAAE,aAAa,CAAC,QAAQ,CAAC;oBACvC,WAAW,EAAE,OAAO;iBACrB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,QAAQ;IACR,MAAM,EAAE,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;IAE7C,IAAI,WAAmB,CAAC;IACxB,IAAI,WAAmB,CAAC;IACxB,IAAI,YAAqB,CAAC;IAE1B,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACnG,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC;QACjC,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC;QACjC,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,MAAM,WAAW,GAAG,QAAQ,CAAC,qBAAqB,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAC/E,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC;QACjC,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC;QACjC,YAAY,GAAG,WAAW,CAAC,OAAO,CAAC;IACrC,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,GAAG,IAAI,GAAG,WAAW,CAAC;IAClD,MAAM,MAAM,GAAgB;QAC1B,OAAO,EAAE,YAAY;QACrB,gBAAgB,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI;QACjD,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC;QAC7B,cAAc,EAAE,aAAa,CAAC,QAAQ,CAAC;QACvC,WAAW,EAAE,OAAO;KACrB,CAAC;IAEF,MAAM,EAAE,CAAC,QAAQ,EAAE,oBAAoB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,OAAO,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAE5H,OAAO,MAAM,CAAC;AAChB,CAAC;AAOD,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;IAED,MAAM,GAAG,GAAG,aAAa,CAAC,OAAO,EAAE,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACzD,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}

package/dist/tools/diff-core.d.ts

@@ -0,0 +1,24 @@
+export interface DiffEntry {
+    status: string;
+    file: string;
+}
+export interface SubmoduleDiff {
+    name: string;
+    pinned_commit: string | null;
+    current_commit: string | null;
+    is_dev_mode: boolean;
+    ahead_count: number;
+    behind_count: number;
+    changed_files: DiffEntry[];
+    uncommitted_changes: string[];
+    commit_log: string[];
+}
+export interface DiffCoreResult {
+    submodules: SubmoduleDiff[];
+}
+/**
+ * Show what changed in crosspad-core and/or crosspad-gui relative to the
+ * pinned submodule commit. Essential for dev-mode workflows where you're
+ * editing shared repos but haven't committed/pinned yet.
+ */
+export declare function crosspadDiffCore(submodule?: "crosspad-core" | "crosspad-gui" | "both"): DiffCoreResult;

package/dist/tools/diff-core.js

@@ -0,0 +1,88 @@
+import fs from "fs";
+import path from "path";
+import { CROSSPAD_PC_ROOT } from "../config.js";
+import { runCommand } from "../utils/exec.js";
+import { getSubmodulePin } from "../utils/git.js";
+/**
+ * Show what changed in crosspad-core and/or crosspad-gui relative to the
+ * pinned submodule commit. Essential for dev-mode workflows where you're
+ * editing shared repos but haven't committed/pinned yet.
+ */
+export function crosspadDiffCore(submodule = "both") {
+    const targets = submodule === "both"
+        ? ["crosspad-core", "crosspad-gui"]
+        : [submodule];
+    const submodules = [];
+    for (const sub of targets) {
+        const subPath = path.join(CROSSPAD_PC_ROOT, sub);
+        const isDevMode = isJunction(subPath);
+        const pinnedCommit = getSubmodulePin(CROSSPAD_PC_ROOT, sub);
+        // Get current HEAD
+        const headResult = runCommand("git rev-parse HEAD", subPath);
+        const currentCommit = headResult.success ? headResult.stdout.trim() : null;
+        let aheadCount = 0;
+        let behindCount = 0;
+        let changedFiles = [];
+        let commitLog = [];
+        if (pinnedCommit && currentCommit && pinnedCommit !== currentCommit) {
+            // Count commits ahead/behind
+            const countResult = runCommand(`git rev-list --count --left-right ${pinnedCommit}...HEAD`, subPath);
+            if (countResult.success) {
+                const parts = countResult.stdout.trim().split(/\s+/);
+                behindCount = parseInt(parts[0] || "0", 10);
+                aheadCount = parseInt(parts[1] || "0", 10);
+            }
+            // Get diff stat (files changed between pinned and HEAD)
+            const diffResult = runCommand(`git diff --name-status ${pinnedCommit}...HEAD`, subPath);
+            if (diffResult.success) {
+                changedFiles = diffResult.stdout
+                    .trim()
+                    .split("\n")
+                    .filter((l) => l.length > 0)
+                    .map((line) => {
+                    const parts = line.split("\t");
+                    return { status: parts[0], file: parts.slice(1).join("\t") };
+                });
+            }
+            // Get commit log between pinned and HEAD
+            const logResult = runCommand(`git log --oneline ${pinnedCommit}..HEAD`, subPath);
+            if (logResult.success) {
+                commitLog = logResult.stdout
+                    .trim()
+                    .split("\n")
+                    .filter((l) => l.length > 0)
+                    .slice(0, 20); // Cap at 20
+            }
+        }
+        // Uncommitted changes (working tree)
+        const statusResult = runCommand("git status --porcelain", subPath);
+        const uncommittedChanges = statusResult.success
+            ? statusResult.stdout
+                .trim()
+                .split("\n")
+                .filter((l) => l.length > 0)
+            : [];
+        submodules.push({
+            name: sub,
+            pinned_commit: pinnedCommit,
+            current_commit: currentCommit,
+            is_dev_mode: isDevMode,
+            ahead_count: aheadCount,
+            behind_count: behindCount,
+            changed_files: changedFiles,
+            uncommitted_changes: uncommittedChanges,
+            commit_log: commitLog,
+        });
+    }
+    return { submodules };
+}
+function isJunction(p) {
+    try {
+        const stat = fs.lstatSync(p);
+        return stat.isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=diff-core.js.map

package/dist/tools/diff-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-core.js","sourceRoot":"","sources":["../../src/tools/diff-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAS,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAuBlD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,YAAuD,MAAM;IAE7D,MAAM,OAAO,GAAG,SAAS,KAAK,MAAM;QAClC,CAAC,CAAC,CAAC,eAAe,EAAE,cAAc,CAAC;QACnC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEhB,MAAM,UAAU,GAAoB,EAAE,CAAC;IAEvC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QACjD,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,eAAe,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;QAE5D,mBAAmB;QACnB,MAAM,UAAU,GAAG,UAAU,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAE3E,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,YAAY,GAAgB,EAAE,CAAC;QACnC,IAAI,SAAS,GAAa,EAAE,CAAC;QAE7B,IAAI,YAAY,IAAI,aAAa,IAAI,YAAY,KAAK,aAAa,EAAE,CAAC;YACpE,6BAA6B;YAC7B,MAAM,WAAW,GAAG,UAAU,CAC5B,qCAAqC,YAAY,SAAS,EAC1D,OAAO,CACR,CAAC;YACF,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACrD,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC5C,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;YAC7C,CAAC;YAED,wDAAwD;YACxD,MAAM,UAAU,GAAG,UAAU,CAC3B,0BAA0B,YAAY,SAAS,EAC/C,OAAO,CACR,CAAC;YACF,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACvB,YAAY,GAAG,UAAU,CAAC,MAAM;qBAC7B,IAAI,EAAE;qBACN,KAAK,CAAC,IAAI,CAAC;qBACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;qBAC3B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;oBACZ,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC/B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/D,CAAC,CAAC,CAAC;YACP,CAAC;YAED,yCAAyC;YACzC,MAAM,SAAS,GAAG,UAAU,CAC1B,qBAAqB,YAAY,QAAQ,EACzC,OAAO,CACR,CAAC;YACF,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACtB,SAAS,GAAG,SAAS,CAAC,MAAM;qBACzB,IAAI,EAAE;qBACN,KAAK,CAAC,IAAI,CAAC;qBACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;qBAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY;YAC/B,CAAC;QACH,CAAC;QAED,qCAAqC;QACrC,MAAM,YAAY,GAAG,UAAU,CAAC,wBAAwB,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO;YAC7C,CAAC,CAAC,YAAY,CAAC,MAAM;iBAChB,IAAI,EAAE;iBACN,KAAK,CAAC,IAAI,CAAC;iBACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;YAChC,CAAC,CAAC,EAAE,CAAC;QAEP,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,YAAY;YAC3B,cAAc,EAAE,aAAa;YAC7B,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,UAAU;YACvB,YAAY,EAAE,WAAW;YACzB,aAAa,EAAE,YAAY;YAC3B,mBAAmB,EAAE,kBAAkB;YACvC,UAAU,EAAE,SAAS;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}