crosspad-mcp-server 5.0.1 → 6.0.0

package/dist/tools/midi.js

@@ -0,0 +1,112 @@
+/**
+ * Send MIDI events to the CrossPad simulator via TCP remote control.
+ *
+ * Supports: note_on, note_off, cc (control change), program_change.
+ * Uses the same remote control protocol as other sim commands.
+ */
+import { sendRemoteCommand, isSimulatorRunning } from "../utils/remote-client.js";
+/**
+ * Send a MIDI event to the running simulator.
+ */
+export async function crosspadMidiSend(params) {
+    const running = await isSimulatorRunning();
+    if (!running) {
+        return {
+            success: false,
+            type: params.type,
+            channel: params.channel,
+            details: {},
+            error: "Simulator is not running. Use crosspad_build action=pc_run to start it.",
+        };
+    }
+    // Validate channel
+    if (params.channel < 0 || params.channel > 15) {
+        return {
+            success: false,
+            type: params.type,
+            channel: params.channel,
+            details: {},
+            error: "MIDI channel must be 0-15",
+        };
+    }
+    let cmd;
+    const details = { channel: params.channel };
+    switch (params.type) {
+        case "note_on": {
+            const note = params.note ?? 60;
+            const velocity = params.velocity ?? 127;
+            if (note < 0 || note > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "Note must be 0-127" };
+            }
+            if (velocity < 0 || velocity > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "Velocity must be 0-127" };
+            }
+            cmd = { cmd: "midi", type: "note_on", channel: params.channel, note, velocity };
+            details.note = note;
+            details.velocity = velocity;
+            break;
+        }
+        case "note_off": {
+            const note = params.note ?? 60;
+            const velocity = params.velocity ?? 0;
+            if (note < 0 || note > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "Note must be 0-127" };
+            }
+            cmd = { cmd: "midi", type: "note_off", channel: params.channel, note, velocity };
+            details.note = note;
+            details.velocity = velocity;
+            break;
+        }
+        case "cc": {
+            const ccNum = params.cc_num ?? 0;
+            const value = params.value ?? 0;
+            if (ccNum < 0 || ccNum > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "CC number must be 0-127" };
+            }
+            if (value < 0 || value > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "Value must be 0-127" };
+            }
+            cmd = { cmd: "midi", type: "cc", channel: params.channel, cc: ccNum, value };
+            details.cc = ccNum;
+            details.value = value;
+            break;
+        }
+        case "program_change": {
+            const program = params.program ?? 0;
+            if (program < 0 || program > 127) {
+                return { success: false, type: params.type, channel: params.channel, details, error: "Program must be 0-127" };
+            }
+            cmd = { cmd: "midi", type: "program_change", channel: params.channel, program };
+            details.program = program;
+            break;
+        }
+        default:
+            return {
+                success: false,
+                type: params.type,
+                channel: params.channel,
+                details: {},
+                error: `Unknown MIDI event type: ${params.type}`,
+            };
+    }
+    try {
+        const resp = await sendRemoteCommand(cmd);
+        return {
+            success: resp.ok === true,
+            type: params.type,
+            channel: params.channel,
+            details,
+            error: resp.ok ? undefined : resp.error ?? "Simulator rejected MIDI command",
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            type: params.type,
+            channel: params.channel,
+            details,
+            error: err.message,
+        };
+    }
+}
+//# sourceMappingURL=midi.js.map

package/dist/tools/midi.js.map

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

package/dist/tools/repo-actions.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Mutable repo operations: submodule update and commit.
+ *
+ * These are intentionally separate from repos.ts (read-only status)
+ * to make the mutation surface explicit.
+ */
+export interface SubmoduleUpdateResult {
+    success: boolean;
+    submodule: string;
+    repo: string;
+    old_sha: string | null;
+    new_sha: string | null;
+    commits_pulled: number;
+    changed_files: string[];
+    staged: boolean;
+    error?: string;
+}
+export interface CommitResult {
+    success: boolean;
+    repo: string;
+    commit_hash: string | null;
+    message: string;
+    files_committed: string[];
+    error?: string;
+}
+/**
+ * Update a submodule in a parent repo to the latest commit on its tracking branch.
+ *
+ * Workflow:
+ * 1. cd into submodule
+ * 2. git fetch origin
+ * 3. git checkout origin/<branch> (default: main)
+ * 4. cd back to parent, git add <submodule>
+ * 5. Report old→new SHA, commits pulled, files changed
+ */
+export declare function crosspadSubmoduleUpdate(submodule: string, repo: string, branch?: string): SubmoduleUpdateResult;
+/**
+ * Commit changes in a specific repo.
+ *
+ * Safety:
+ * - Refuses if working tree has merge conflicts
+ * - If files specified, stages only those files
+ * - If no files specified, commits whatever is currently staged
+ * - Never pushes to remote
+ */
+export declare function crosspadCommit(repo: string, message: string, files?: string[]): CommitResult;

package/dist/tools/repo-actions.js

@@ -0,0 +1,273 @@
+/**
+ * Mutable repo operations: submodule update and commit.
+ *
+ * These are intentionally separate from repos.ts (read-only status)
+ * to make the mutation surface explicit.
+ */
+import fs from "fs";
+import path from "path";
+import { getRepos } from "../config.js";
+import { runCommand } from "../utils/exec.js";
+import { getHead } from "../utils/git.js";
+const REPO_ALIASES = {
+    idf: "platform-idf",
+    pc: "crosspad-pc",
+    arduino: "ESP32-S3",
+    core: "crosspad-core",
+    gui: "crosspad-gui",
+};
+function resolveRepo(repo) {
+    const repos = getRepos();
+    const canonical = REPO_ALIASES[repo] ?? repo;
+    if (repos[canonical]) {
+        return { name: canonical, root: repos[canonical] };
+    }
+    // Try partial match
+    for (const [name, repoPath] of Object.entries(repos)) {
+        if (name.toLowerCase().includes(repo.toLowerCase())) {
+            return { name, root: repoPath };
+        }
+    }
+    return null;
+}
+function getAvailableRepoNames() {
+    return Object.keys(getRepos());
+}
+// ═══════════════════════════════════════════════════════════════════════
+// SUBMODULE PATHS — where each submodule lives inside parent repos
+// ═══════════════════════════════════════════════════════════════════════
+const SUBMODULE_PATHS = {
+    "platform-idf": {
+        "crosspad-core": "components/crosspad-core",
+        "crosspad-gui": "components/crosspad-gui",
+        "crosspad-instructions": "components/crosspad-instructions",
+        "crosspad-sampler": "components/crosspad-sampler",
+    },
+    "crosspad-pc": {
+        "crosspad-core": "crosspad-core",
+        "crosspad-gui": "crosspad-gui",
+    },
+    "ESP32-S3": {
+        "crosspad-core": "lib/crosspad-core",
+        "crosspad-gui": "lib/crosspad-gui",
+    },
+};
+function getSubmodulePath(repoName, submodule) {
+    return SUBMODULE_PATHS[repoName]?.[submodule] ?? null;
+}
+// ═══════════════════════════════════════════════════════════════════════
+// SUBMODULE UPDATE
+// ═══════════════════════════════════════════════════════════════════════
+/**
+ * Update a submodule in a parent repo to the latest commit on its tracking branch.
+ *
+ * Workflow:
+ * 1. cd into submodule
+ * 2. git fetch origin
+ * 3. git checkout origin/<branch> (default: main)
+ * 4. cd back to parent, git add <submodule>
+ * 5. Report old→new SHA, commits pulled, files changed
+ */
+export function crosspadSubmoduleUpdate(submodule, repo, branch = "main") {
+    const resolvedRepo = resolveRepo(repo);
+    if (!resolvedRepo) {
+        return {
+            success: false,
+            submodule,
+            repo,
+            old_sha: null,
+            new_sha: null,
+            commits_pulled: 0,
+            changed_files: [],
+            staged: false,
+            error: `Unknown repo "${repo}". Available: ${getAvailableRepoNames().join(", ")}`,
+        };
+    }
+    const subPath = getSubmodulePath(resolvedRepo.name, submodule);
+    if (!subPath) {
+        const knownSubs = Object.keys(SUBMODULE_PATHS[resolvedRepo.name] ?? {});
+        return {
+            success: false,
+            submodule,
+            repo: resolvedRepo.name,
+            old_sha: null,
+            new_sha: null,
+            commits_pulled: 0,
+            changed_files: [],
+            staged: false,
+            error: `Submodule "${submodule}" not found in ${resolvedRepo.name}. Known: ${knownSubs.join(", ")}`,
+        };
+    }
+    const fullSubPath = path.join(resolvedRepo.root, subPath);
+    if (!fs.existsSync(fullSubPath)) {
+        return {
+            success: false,
+            submodule,
+            repo: resolvedRepo.name,
+            old_sha: null,
+            new_sha: null,
+            commits_pulled: 0,
+            changed_files: [],
+            staged: false,
+            error: `Submodule directory not found: ${fullSubPath}`,
+        };
+    }
+    // Get current SHA
+    const oldSha = getHead(fullSubPath);
+    // Fetch latest
+    const fetchResult = runCommand("git fetch origin", fullSubPath, 30_000);
+    if (!fetchResult.success) {
+        return {
+            success: false,
+            submodule,
+            repo: resolvedRepo.name,
+            old_sha: oldSha,
+            new_sha: null,
+            commits_pulled: 0,
+            changed_files: [],
+            staged: false,
+            error: `git fetch failed: ${fetchResult.stderr}`,
+        };
+    }
+    // Checkout target
+    const checkoutResult = runCommand(`git checkout origin/${branch}`, fullSubPath, 15_000);
+    if (!checkoutResult.success) {
+        return {
+            success: false,
+            submodule,
+            repo: resolvedRepo.name,
+            old_sha: oldSha,
+            new_sha: null,
+            commits_pulled: 0,
+            changed_files: [],
+            staged: false,
+            error: `git checkout origin/${branch} failed: ${checkoutResult.stderr}`,
+        };
+    }
+    // Get new SHA
+    const newSha = getHead(fullSubPath);
+    // Count commits between old and new
+    let commitsPulled = 0;
+    let changedFiles = [];
+    if (oldSha && newSha && oldSha !== newSha) {
+        const countResult = runCommand(`git rev-list --count ${oldSha}..${newSha}`, fullSubPath);
+        if (countResult.success) {
+            commitsPulled = parseInt(countResult.stdout.trim(), 10) || 0;
+        }
+        const diffResult = runCommand(`git diff --name-only ${oldSha}..${newSha}`, fullSubPath);
+        if (diffResult.success) {
+            changedFiles = diffResult.stdout
+                .trim()
+                .split("\n")
+                .filter((l) => l.length > 0);
+        }
+    }
+    // Stage the submodule update in parent repo
+    const addResult = runCommand(`git add ${subPath}`, resolvedRepo.root, 10_000);
+    return {
+        success: true,
+        submodule,
+        repo: resolvedRepo.name,
+        old_sha: oldSha,
+        new_sha: newSha,
+        commits_pulled: commitsPulled,
+        changed_files: changedFiles,
+        staged: addResult.success,
+    };
+}
+// ═══════════════════════════════════════════════════════════════════════
+// COMMIT
+// ═══════════════════════════════════════════════════════════════════════
+/**
+ * Commit changes in a specific repo.
+ *
+ * Safety:
+ * - Refuses if working tree has merge conflicts
+ * - If files specified, stages only those files
+ * - If no files specified, commits whatever is currently staged
+ * - Never pushes to remote
+ */
+export function crosspadCommit(repo, message, files) {
+    const resolvedRepo = resolveRepo(repo);
+    if (!resolvedRepo) {
+        return {
+            success: false,
+            repo,
+            commit_hash: null,
+            message,
+            files_committed: [],
+            error: `Unknown repo "${repo}". Available: ${getAvailableRepoNames().join(", ")}`,
+        };
+    }
+    // Check for merge conflicts
+    const statusResult = runCommand("git status --porcelain", resolvedRepo.root);
+    if (statusResult.success) {
+        const conflicted = statusResult.stdout
+            .split("\n")
+            .filter((l) => l.startsWith("UU") || l.startsWith("AA") || l.startsWith("DD"));
+        if (conflicted.length > 0) {
+            return {
+                success: false,
+                repo: resolvedRepo.name,
+                commit_hash: null,
+                message,
+                files_committed: [],
+                error: `Merge conflicts detected:\n${conflicted.join("\n")}\nResolve conflicts before committing.`,
+            };
+        }
+    }
+    // Stage specific files if provided
+    if (files && files.length > 0) {
+        const fileList = files.map((f) => `"${f}"`).join(" ");
+        const addResult = runCommand(`git add ${fileList}`, resolvedRepo.root, 10_000);
+        if (!addResult.success) {
+            return {
+                success: false,
+                repo: resolvedRepo.name,
+                commit_hash: null,
+                message,
+                files_committed: [],
+                error: `git add failed: ${addResult.stderr}`,
+            };
+        }
+    }
+    // Check something is staged
+    const diffResult = runCommand("git diff --cached --name-only", resolvedRepo.root);
+    const stagedFiles = diffResult.success
+        ? diffResult.stdout.trim().split("\n").filter((l) => l.length > 0)
+        : [];
+    if (stagedFiles.length === 0) {
+        return {
+            success: false,
+            repo: resolvedRepo.name,
+            commit_hash: null,
+            message,
+            files_committed: [],
+            error: "Nothing staged to commit. Stage files first or specify files parameter.",
+        };
+    }
+    // Commit — escape message for shell safety
+    const escapedMessage = message.replace(/'/g, "'\\''");
+    const commitResult = runCommand(`git commit -m '${escapedMessage}'`, resolvedRepo.root, 30_000);
+    if (!commitResult.success) {
+        return {
+            success: false,
+            repo: resolvedRepo.name,
+            commit_hash: null,
+            message,
+            files_committed: stagedFiles,
+            error: `git commit failed: ${commitResult.stderr || commitResult.stdout}`,
+        };
+    }
+    // Get the new commit hash
+    const hashResult = runCommand("git rev-parse HEAD", resolvedRepo.root);
+    const commitHash = hashResult.success ? hashResult.stdout.trim() : null;
+    return {
+        success: true,
+        repo: resolvedRepo.name,
+        commit_hash: commitHash,
+        message,
+        files_committed: stagedFiles,
+    };
+}
+//# sourceMappingURL=repo-actions.js.map

package/dist/tools/repo-actions.js.map

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

package/dist/tools/symbols.d.ts

@@ -4,6 +4,7 @@ export interface SymbolResult {
     file: string;
     line: number;
     context: string;
+    surrounding?: string[];
     repo: string;
 }
 export interface SymbolSearchResult {
@@ -13,8 +14,22 @@ export interface SymbolSearchResult {
     total_matches: number;
     truncated: boolean;
 }
+/**
+ * Build a regex pattern that matches definition lines containing the query.
+ * Each kind has a specific pattern that only matches declarations/definitions.
+ */
+/** @internal exported for testing */
+export declare function buildPattern(query: string, kind: string): string;
 /**
  * Search for symbol definitions (classes, functions, macros, enums) across CrossPad repos.
  * Only matches definition lines, not usages.
  */
-export declare function crosspadSearchSymbols(query: string, kind?: string, repos?: string[], maxResults?: number): SymbolSearchResult;
+export declare function crosspadSearchSymbols(query: string, kind?: string, repos?: string[], maxResults?: number, contextLines?: number): SymbolSearchResult;
+/** @internal exported for testing */
+export declare function escapeForShell(s: string): string;
+/** @internal exported for testing */
+export declare function escapeForRegex(s: string): string;
+/** @internal exported for testing */
+export declare function classifyDefinition(line: string): SymbolResult["kind"] | null;
+/** @internal exported for testing */
+export declare function extractSymbolName(line: string, kind: SymbolResult["kind"]): string | null;