patchwork-os 0.2.0-alpha.0

package/dist/commands/tools.js

@@ -0,0 +1,326 @@
+/**
+ * `claude-ide-bridge tools` CLI subcommand.
+ *
+ * Subcommands:
+ *   search <query>  — case-insensitive substring match on name, description, category
+ *   list            — all tools grouped by category
+ *
+ * No bridge connection required — reads static registry at import time.
+ */
+import { TOOL_CATEGORIES } from "../tools/index.js";
+// ---------------------------------------------------------------------------
+// Static description map for the most important tools.
+// Categories come from TOOL_CATEGORIES; descriptions here are first-sentence
+// summaries used by the CLI only (does not affect the MCP searchTools tool).
+// ---------------------------------------------------------------------------
+export const TOOL_DESCRIPTIONS = {
+    // git
+    getGitStatus: "Show working tree status including staged and unstaged changes.",
+    getGitDiff: "Show diff for staged, unstaged, or between refs.",
+    getGitLog: "Retrieve recent commit history with author and message.",
+    gitAdd: "Stage files for the next commit.",
+    gitCommit: "Create a git commit with a message.",
+    gitPush: "Push the current branch to the remote.",
+    gitCheckout: "Checkout an existing branch or create a new one.",
+    gitPull: "Pull latest commits from the remote.",
+    gitListBranches: "List local and remote branches.",
+    gitBlame: "Show per-line authorship for a file.",
+    getGitHotspots: "Find change-heavy files using git log history.",
+    getSymbolHistory: "Show git blame + log history for a specific symbol.",
+    getCommitDetails: "Show full details for a single commit hash.",
+    getDiffBetweenRefs: "Diff between two git refs (branches, tags, commits).",
+    githubCreatePR: "Open a pull request on GitHub.",
+    githubListPRs: "List open pull requests for the repository.",
+    githubViewPR: "View details and diff for a pull request.",
+    githubListIssues: "List GitHub issues for the repository.",
+    githubGetIssue: "Get details for a specific GitHub issue.",
+    githubCreateIssue: "Create a new GitHub issue.",
+    githubCommentIssue: "Post a comment on a GitHub issue.",
+    githubListRuns: "List recent GitHub Actions workflow runs.",
+    githubGetRunLogs: "Fetch logs from a GitHub Actions run.",
+    githubGetPRDiff: "Get the diff for a pull request.",
+    githubPostPRReview: "Post a review comment on a pull request.",
+    getPRTemplate: "Generate a pull request description from staged changes.",
+    // lsp
+    getDiagnostics: "Return TypeScript/ESLint/Biome errors and warnings for a file or workspace.",
+    watchDiagnostics: "Long-poll for diagnostic changes (errors/warnings) in real time.",
+    getDocumentSymbols: "List all symbols (functions, classes, variables) in a file.",
+    goToDefinition: "Navigate to the definition of a symbol.",
+    findReferences: "Find all references to a symbol across the workspace.",
+    findImplementations: "Find all implementations of an interface or abstract method.",
+    goToTypeDefinition: "Navigate to the type definition of a symbol.",
+    goToDeclaration: "Navigate to the declaration of a symbol.",
+    getHover: "Get hover information (type, docs) for a symbol at a position.",
+    getCodeActions: "List available code actions (quick fixes) at a position.",
+    applyCodeAction: "Apply a code action returned by getCodeActions.",
+    previewCodeAction: "Preview the edits a code action would make.",
+    refactorPreview: "Preview exact edits a rename or refactor would produce.",
+    renameSymbol: "Safely rename a symbol across the workspace.",
+    searchWorkspaceSymbols: "Find classes, functions, and variables by name pattern.",
+    getCallHierarchy: "Show incoming or outgoing call hierarchy for a function.",
+    explainSymbol: "Composite: hover + definition + refs + type hierarchy in one call.",
+    prepareRename: "Check whether a symbol at a position can be renamed.",
+    signatureHelp: "Show function signature and parameter info at a call site.",
+    refactorAnalyze: "Analyze rename/refactor risk (ref count, caller count, risk level).",
+    selectionRanges: "Get smart selection expansion ranges for a position.",
+    foldingRanges: "Get fold ranges (functions, blocks) for a file.",
+    refactorExtractFunction: "Extract a selection into a new named function.",
+    getImportTree: "Show the full downstream import dependency chain for a file.",
+    getImportedSignatures: "Show signatures of all symbols imported into a file.",
+    getDocumentLinks: "Find all file references and links embedded in a document.",
+    batchGetHover: "Get hover info for up to 10 symbols in a single call.",
+    batchGoToDefinition: "Go to definition for up to 10 symbols in a single call.",
+    batchFindImplementations: "Find implementations for up to 10 symbols in a single call.",
+    getSemanticTokens: "Get semantic token types and modifiers for a file.",
+    getCodeLens: "Get code lens annotations (test run counts, reference counts).",
+    getChangeImpact: "Blast-radius analysis: diagnostics + reference counts for changed symbols.",
+    getTypeHierarchy: "Show supertypes and subtypes for a class or interface.",
+    getInlayHints: "Get inline type annotations and parameter names.",
+    getHoverAtCursor: "Get hover info at the current cursor position in the active editor.",
+    getTypeSignature: "Get the type signature for a symbol.",
+    jumpToFirstError: "Navigate the editor to the first error in the workspace.",
+    navigateToSymbolByName: "Jump to a symbol by name using LSP or ctags fallback.",
+    // editor
+    getOpenEditors: "List all files currently open in the editor.",
+    getCurrentSelection: "Get the current text selection in the active editor.",
+    getLatestSelection: "Get the most recent selection (persists after focus loss).",
+    checkDocumentDirty: "Check whether a file has unsaved changes.",
+    saveDocument: "Save a file (or all files) in the editor.",
+    openFile: "Open a file in the editor at an optional line and column.",
+    closeTab: "Close an editor tab by file path.",
+    captureScreenshot: "Take a screenshot of the VS Code window.",
+    setEditorDecorations: "Annotate code with inline warning/error decorations.",
+    clearEditorDecorations: "Remove decorations previously set by setEditorDecorations.",
+    openDiff: "Open a side-by-side diff view between two files or content.",
+    openInBrowser: "Open a URL or file in the system browser.",
+    executeVSCodeCommand: "Run any VS Code command by its command ID.",
+    listVSCodeCommands: "List all available VS Code command IDs.",
+    listVSCodeTasks: "List configured VS Code tasks from tasks.json.",
+    runVSCodeTask: "Run a VS Code task by name.",
+    getWorkspaceFolders: "List all workspace folders open in VS Code.",
+    setActiveWorkspaceFolder: "Switch the active workspace folder.",
+    getWorkspaceSettings: "Read VS Code workspace settings.",
+    setWorkspaceSetting: "Write a VS Code workspace setting.",
+    formatDocument: "Format a file using the language server formatter.",
+    formatRange: "Format a selected range within a file.",
+    formatAndSave: "Format then save a file in one step.",
+    fixAllLintErrors: "Apply all auto-fixable lint errors in a file.",
+    organizeImports: "Sort and remove unused imports in a file.",
+    getBufferContent: "Read the current content of a file from the VS Code buffer.",
+    editText: "Edit a file by replacing a line range.",
+    createFile: "Create a new file with optional initial content.",
+    deleteFile: "Delete a file from the workspace.",
+    renameFile: "Rename or move a file.",
+    replaceBlock: "Replace a block of text matching a pattern in a file.",
+    searchAndReplace: "Find and replace text across multiple workspace files.",
+    findFiles: "Find files matching a glob pattern in the workspace.",
+    getFileTree: "List files and directories in the workspace as a tree.",
+    readClipboard: "Read the current clipboard content.",
+    writeClipboard: "Write text to the clipboard.",
+    watchFiles: "Watch a set of files for changes.",
+    unwatchFiles: "Stop watching previously watched files.",
+    // debug
+    getDebugState: "Get the current VS Code debug session state.",
+    evaluateInDebugger: "Evaluate an expression inside the active debug session.",
+    setDebugBreakpoints: "Set or clear breakpoints in a file.",
+    startDebugging: "Start a VS Code debug session.",
+    stopDebugging: "Stop the active debug session.",
+    // diagnostics / analysis
+    runTests: "Run tests using vitest, jest, pytest, cargo test, or go test.",
+    getCodeCoverage: "Parse lcov/clover coverage and return per-file percentages.",
+    detectUnusedCode: "Find unused variables, exports, and dead code.",
+    auditDependencies: "Check for outdated npm/cargo/pip packages.",
+    getSecurityAdvisories: "Fetch CVE advisories for installed dependencies.",
+    generateTests: "Scaffold unit tests for a file or symbol.",
+    generateAPIDocumentation: "Generate API documentation for a module.",
+    findRelatedTests: "Find test files related to a source file.",
+    getDependencyTree: "Show the full npm/cargo dependency tree.",
+    screenshotAndAnnotate: "Take a screenshot and generate Playwright action steps.",
+    searchWorkspace: "Full-text search across workspace files (ripgrep or VS Code search).",
+    // bridge / orchestration
+    getBridgeStatus: "Show bridge and extension connection health.",
+    getToolCapabilities: "List available tools and whether extension is connected.",
+    bridgeDoctor: "Run diagnostics to identify common bridge configuration issues.",
+    getSessionUsage: "Show tool call counts and error rates for this session.",
+    searchTools: "Find MCP tools by keyword or category (no bridge connection needed).",
+    getProjectInfo: "Get project name, version, and dependency summary.",
+    getProjectContext: "Get rich project context: git, diagnostics, recent activity.",
+    getArchitectureContext: "Query codebase memory graph for architectural context.",
+    contextBundle: "Bundle editor context: open files, selection, git status, diagnostics.",
+    watchActivityLog: "Long-poll the activity log for new tool call events.",
+    getActivityLog: "Retrieve recent tool call activity with optional percentile stats.",
+    getAnalyticsReport: "Get performance analytics: p50/p95/p99 latency, health score.",
+    getHandoffNote: "Read the cross-session handoff note for the current workspace.",
+    setHandoffNote: "Write a cross-session handoff note for the current workspace.",
+    getPerformanceReport: "Health score 0-100, p50/p95/p99 latency, windowed throughput.",
+    // automation / orchestration
+    runClaudeTask: "Enqueue a Claude Code subprocess task with a prompt.",
+    getClaudeTaskStatus: "Get the status and output of a Claude subprocess task.",
+    cancelClaudeTask: "Cancel a running Claude subprocess task.",
+    listClaudeTasks: "List all Claude subprocess tasks and their statuses.",
+    resumeClaudeTask: "Resume an interrupted Claude subprocess task.",
+    // http
+    sendHttpRequest: "Send an HTTP request (GET/POST/etc) to an external URL.",
+    parseHttpFile: "Parse a .http file and send its requests.",
+    // plans
+    createPlan: "Create a structured multi-step plan for a task.",
+    updatePlan: "Update a step or status in an existing plan.",
+    deletePlan: "Delete a plan.",
+    getPlan: "Get the details of a plan.",
+    listPlans: "List all active plans in the workspace.",
+};
+/** Build the full tool catalog from TOOL_CATEGORIES + TOOL_DESCRIPTIONS. */
+export function buildToolCatalog() {
+    const seen = new Set();
+    const entries = [];
+    for (const [name, cats] of Object.entries(TOOL_CATEGORIES)) {
+        seen.add(name);
+        entries.push({
+            name,
+            description: TOOL_DESCRIPTIONS[name] ?? "",
+            categories: cats,
+        });
+    }
+    // Also include tools in the description map that have no category entry.
+    for (const [name, desc] of Object.entries(TOOL_DESCRIPTIONS)) {
+        if (!seen.has(name)) {
+            entries.push({ name, description: desc, categories: [] });
+        }
+    }
+    return entries.sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * Search the tool catalog.
+ * @param catalog  Full catalog from buildToolCatalog().
+ * @param query    Substring to match against name, description, or categories.
+ */
+export function searchCatalog(catalog, query) {
+    const q = query.toLowerCase().trim();
+    if (!q)
+        return catalog;
+    return catalog.filter((t) => {
+        const haystack = [t.name, t.description, ...t.categories]
+            .join(" ")
+            .toLowerCase();
+        return haystack.includes(q);
+    });
+}
+/** Group catalog entries by their first category (or "other"). */
+export function groupByCategory(catalog) {
+    const map = new Map();
+    for (const entry of catalog) {
+        const cat = entry.categories[0] ?? "other";
+        const bucket = map.get(cat);
+        if (bucket) {
+            bucket.push(entry);
+        }
+        else {
+            map.set(cat, [entry]);
+        }
+    }
+    // Sort keys
+    return new Map([...map.entries()].sort((a, b) => a[0].localeCompare(b[0])));
+}
+/** Return the first sentence of a description (up to first "."). */
+export function firstSentence(desc) {
+    const dot = desc.indexOf(".");
+    return dot !== -1 ? desc.slice(0, dot + 1) : desc;
+}
+// ---------------------------------------------------------------------------
+// CLI output helpers
+// ---------------------------------------------------------------------------
+function printTool(t, showCategory = true) {
+    const cat = showCategory && t.categories.length > 0 ? `  [${t.categories[0]}]` : "";
+    const desc = firstSentence(t.description);
+    process.stdout.write(`  ${t.name}${cat}\n`);
+    if (desc) {
+        process.stdout.write(`    ${desc}\n`);
+    }
+}
+function printSearchResults(results, query) {
+    if (results.length === 0) {
+        process.stdout.write(`No tools matched "${query}".\n`);
+        return;
+    }
+    process.stdout.write(`${results.length} tool${results.length === 1 ? "" : "s"} matching "${query}":\n\n`);
+    for (const t of results) {
+        printTool(t);
+    }
+}
+function printGroupedList(grouped) {
+    for (const [cat, entries] of grouped) {
+        process.stdout.write(`\n${cat.toUpperCase()} (${entries.length})\n`);
+        process.stdout.write(`${"─".repeat(40)}\n`);
+        for (const t of entries) {
+            printTool(t, false);
+        }
+    }
+}
+function printJson(data) {
+    process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+}
+// ---------------------------------------------------------------------------
+// Subcommand entrypoint
+// ---------------------------------------------------------------------------
+export async function runToolsCommand(argv) {
+    // Strip flag arguments before extracting the subcommand so that
+    // `tools --json list` works identically to `tools list --json`.
+    const sub = argv.find((a) => !a.startsWith("--"));
+    const jsonFlag = argv.includes("--json");
+    if (!sub || sub === "--help" || sub === "help") {
+        process.stdout.write(`claude-ide-bridge tools — Browse and search tools (no bridge required)
+
+Usage:
+  claude-ide-bridge tools search <query> [--json]
+  claude-ide-bridge tools list [--json]
+
+Subcommands:
+  search <query>  Case-insensitive search on name, description, and category
+  list            All tools grouped by category
+
+Options:
+  --json          Machine-readable JSON output
+`);
+        process.exit(!sub ? 1 : 0);
+    }
+    const catalog = buildToolCatalog();
+    if (sub === "search") {
+        const query = argv
+            .filter((a) => !a.startsWith("--") && a !== "search")
+            .join(" ")
+            .trim();
+        if (!query) {
+            process.stderr.write("Usage: claude-ide-bridge tools search <query>\n");
+            process.exit(1);
+        }
+        const results = searchCatalog(catalog, query);
+        if (jsonFlag) {
+            printJson(results);
+        }
+        else {
+            printSearchResults(results, query);
+        }
+        return;
+    }
+    if (sub === "list") {
+        const grouped = groupByCategory(catalog);
+        if (jsonFlag) {
+            const obj = {};
+            for (const [cat, entries] of grouped) {
+                obj[cat] = entries;
+            }
+            printJson(obj);
+        }
+        else {
+            const total = catalog.length;
+            process.stdout.write(`claude-ide-bridge — ${total} tools\n`);
+            printGroupedList(grouped);
+            process.stdout.write("\n");
+        }
+        return;
+    }
+    process.stderr.write(`Unknown subcommand: ${sub}\n`);
+    process.stderr.write("Usage: claude-ide-bridge tools <search <query> | list>\n");
+    process.exit(1);
+}
+//# sourceMappingURL=tools.js.map

package/dist/commands/tools.js.map

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

package/dist/commitIssueLinkLog.d.ts

@@ -0,0 +1,77 @@
+import type { Logger } from "./logger.js";
+/**
+ * CommitIssueLinkLog — persistent audit trail of every commit→issue link
+ * extracted by the `enrichCommit` tool.
+ *
+ * Mirrors RecipeRunLog: JSONL append-only file + bounded in-memory ring.
+ * Schema is additive; consumers must tolerate unknown keys. Enables reverse
+ * queries ("which commits touch issue #42?") without re-running enrichment.
+ */
+export type LinkType = "closes" | "references";
+export interface CommitIssueLink {
+    /** Monotonic sequence id within the process — stable for pagination. */
+    seq: number;
+    /** Commit SHA (full). */
+    sha: string;
+    /** Normalized issue ref, e.g. `#42`. */
+    ref: string;
+    /** Classification from commit-message verb proximity. */
+    linkType: LinkType;
+    /** Whether the issue was successfully fetched from the issue tracker. */
+    resolved: boolean;
+    /** Workspace that produced the link — lets one log span many repos. */
+    workspace: string;
+    /** Commit subject (first line of message), for display. */
+    subject?: string;
+    /** Issue state at the time the link was recorded (`OPEN`/`CLOSED`/…). */
+    issueState?: string;
+    /** Issue title at the time the link was recorded. */
+    issueTitle?: string;
+    /** Reason the link is unresolved (not_found / gh_unavailable / error / auth). */
+    reason?: string;
+    /** ms epoch when the link was recorded. */
+    createdAt: number;
+}
+export interface LinkLogOptions {
+    /** Directory holding commit_issue_links.jsonl. Created if missing. */
+    dir: string;
+    logger?: Logger;
+    /** Cap on in-memory ring. File is not truncated. */
+    memoryCap?: number;
+    /** Test hook — default Date.now. */
+    now?: () => number;
+}
+export interface LinkQuery {
+    /** Filter by commit SHA (exact or prefix ≥7 chars). */
+    sha?: string;
+    /** Filter by issue ref (`#42`). */
+    ref?: string;
+    /** Filter by workspace path. */
+    workspace?: string;
+    linkType?: LinkType;
+    resolved?: boolean;
+    /** Links with seq > after. */
+    after?: number;
+    limit?: number;
+}
+export declare class CommitIssueLinkLog {
+    private readonly opts;
+    private links;
+    private seq;
+    private readonly file;
+    private readonly memoryCap;
+    private readonly now;
+    constructor(opts: LinkLogOptions);
+    /**
+     * Record one link. De-duplicates against the most recent existing row for
+     * the same (workspace, sha, ref) — identical repeat calls don't grow the
+     * log. A row whose `resolved` flag or `issueState` changes IS appended, so
+     * the history of an issue's state across commits stays visible.
+     */
+    record(input: Omit<CommitIssueLink, "seq" | "createdAt">): CommitIssueLink | null;
+    query(q?: LinkQuery): CommitIssueLink[];
+    size(): number;
+    private findMostRecent;
+    private append;
+    private loadExisting;
+}

package/dist/commitIssueLinkLog.js

@@ -0,0 +1,142 @@
+import { appendFileSync, mkdirSync, readFileSync, statSync } from "node:fs";
+import path from "node:path";
+const DEFAULT_MEMORY_CAP = 2_000;
+export class CommitIssueLinkLog {
+    opts;
+    links = [];
+    seq = 0;
+    file;
+    memoryCap;
+    now;
+    constructor(opts) {
+        this.opts = opts;
+        this.file = path.join(opts.dir, "commit_issue_links.jsonl");
+        this.memoryCap = opts.memoryCap ?? DEFAULT_MEMORY_CAP;
+        this.now = opts.now ?? Date.now;
+        try {
+            mkdirSync(opts.dir, { recursive: true });
+        }
+        catch (err) {
+            opts.logger?.warn?.(`[linklog] could not create ${opts.dir}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        this.loadExisting();
+    }
+    /**
+     * Record one link. De-duplicates against the most recent existing row for
+     * the same (workspace, sha, ref) — identical repeat calls don't grow the
+     * log. A row whose `resolved` flag or `issueState` changes IS appended, so
+     * the history of an issue's state across commits stays visible.
+     */
+    record(input) {
+        const prev = this.findMostRecent(input.workspace, input.sha, input.ref);
+        if (prev &&
+            prev.linkType === input.linkType &&
+            prev.resolved === input.resolved &&
+            prev.issueState === input.issueState &&
+            prev.reason === input.reason) {
+            return null;
+        }
+        this.seq += 1;
+        const link = {
+            seq: this.seq,
+            sha: input.sha,
+            ref: input.ref,
+            linkType: input.linkType,
+            resolved: input.resolved,
+            workspace: input.workspace,
+            ...(input.subject !== undefined && { subject: input.subject }),
+            ...(input.issueState !== undefined && { issueState: input.issueState }),
+            ...(input.issueTitle !== undefined && { issueTitle: input.issueTitle }),
+            ...(input.reason !== undefined && { reason: input.reason }),
+            createdAt: this.now(),
+        };
+        this.links.push(link);
+        if (this.links.length > this.memoryCap) {
+            this.links.splice(0, this.links.length - this.memoryCap);
+        }
+        this.append(link);
+        return link;
+    }
+    query(q = {}) {
+        let out = this.links;
+        if (q.sha) {
+            const needle = q.sha;
+            out = out.filter((l) => l.sha === needle || (needle.length >= 7 && l.sha.startsWith(needle)));
+        }
+        if (q.ref)
+            out = out.filter((l) => l.ref === q.ref);
+        if (q.workspace)
+            out = out.filter((l) => l.workspace === q.workspace);
+        if (q.linkType)
+            out = out.filter((l) => l.linkType === q.linkType);
+        if (q.resolved !== undefined) {
+            const wanted = q.resolved;
+            out = out.filter((l) => l.resolved === wanted);
+        }
+        if (q.after !== undefined) {
+            const after = q.after;
+            out = out.filter((l) => l.seq > after);
+        }
+        out = [...out].sort((a, b) => b.seq - a.seq);
+        const limit = Math.min(Math.max(q.limit ?? 100, 1), 1_000);
+        return out.slice(0, limit);
+    }
+    size() {
+        return this.links.length;
+    }
+    findMostRecent(workspace, sha, ref) {
+        for (let i = this.links.length - 1; i >= 0; i -= 1) {
+            const l = this.links[i];
+            if (l && l.workspace === workspace && l.sha === sha && l.ref === ref) {
+                return l;
+            }
+        }
+        return undefined;
+    }
+    append(link) {
+        try {
+            appendFileSync(this.file, `${JSON.stringify(link)}\n`, { mode: 0o600 });
+        }
+        catch (err) {
+            this.opts.logger?.warn?.(`[linklog] append failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    loadExisting() {
+        try {
+            statSync(this.file);
+        }
+        catch {
+            return;
+        }
+        let raw;
+        try {
+            raw = readFileSync(this.file, "utf-8");
+        }
+        catch (err) {
+            this.opts.logger?.warn?.(`[linklog] read failed: ${err instanceof Error ? err.message : String(err)}`);
+            return;
+        }
+        for (const line of raw.split("\n")) {
+            if (!line)
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (typeof parsed.seq !== "number" ||
+                    typeof parsed.sha !== "string" ||
+                    typeof parsed.ref !== "string") {
+                    continue;
+                }
+                this.links.push(parsed);
+                if (parsed.seq > this.seq)
+                    this.seq = parsed.seq;
+            }
+            catch {
+                // skip malformed line
+            }
+        }
+        if (this.links.length > this.memoryCap) {
+            this.links.splice(0, this.links.length - this.memoryCap);
+        }
+    }
+}
+//# sourceMappingURL=commitIssueLinkLog.js.map

package/dist/commitIssueLinkLog.js.map

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

package/dist/companions/registry.d.ts

@@ -0,0 +1,12 @@
+export interface CompanionEntry {
+    description: string;
+    npmPackage: string;
+    command: string;
+    args: string[];
+    requiredEnv?: Record<string, string>;
+    /** Printed after install completes — use for post-install manual steps. */
+    postInstallMessage?: string;
+    /** Skip `npm install -g` step — for binary-only companions installed via other means. */
+    skipNpmInstall?: boolean;
+}
+export declare const COMPANIONS: Record<string, CompanionEntry>;

package/dist/companions/registry.js

@@ -0,0 +1,71 @@
+// Companion MCP server registry.
+// npm package names verified via: npm view <pkg> name
+// @modelcontextprotocol/server-memory ✓
+// superpowers-mcp ✓
+// chrome-devtools-mcp ✓
+// @bytebase/dbhub ✓
+// slack-mcp-server ✓
+// @playwright/mcp ✓
+// codebase-memory-mcp — binary only, not on npm (skipNpmInstall: true)
+export const COMPANIONS = {
+    memory: {
+        description: "Persistent memory across Claude sessions",
+        npmPackage: "@modelcontextprotocol/server-memory",
+        command: "npx",
+        args: ["-y", "@modelcontextprotocol/server-memory"],
+    },
+    superpowers: {
+        description: "Structured planning, task decomposition",
+        npmPackage: "superpowers-mcp",
+        command: "npx",
+        args: ["-y", "superpowers-mcp"],
+    },
+    // To connect to an existing Chrome instead of auto-launching:
+    // add --browser-url http://127.0.0.1:9222 to args.
+    devtools: {
+        description: "Full Chrome browser control — automate, debug, inspect network/console/performance",
+        npmPackage: "chrome-devtools-mcp",
+        command: "npx",
+        args: ["-y", "chrome-devtools-mcp"],
+    },
+    database: {
+        description: "Multi-database query tools (Postgres, MySQL, SQLite, SQL Server, MariaDB)",
+        npmPackage: "@bytebase/dbhub",
+        command: "npx",
+        args: ["-y", "@bytebase/dbhub", "--transport", "stdio"],
+        requiredEnv: { DSN: "<postgresql://user:pass@localhost/mydb>" },
+        postInstallMessage: "Replace the DSN placeholder in claude_desktop_config.json with your real connection string,\n" +
+            "or use: claude-ide-bridge install database --env DSN=postgresql://user:pass@localhost/mydb\n" +
+            "Multiple databases: add a second entry manually with key 'database-mysql' etc.",
+    },
+    slack: {
+        description: "Post Slack messages from automation hooks (onPullRequest, onGitPush, etc.)",
+        npmPackage: "slack-mcp-server",
+        command: "npx",
+        args: ["-y", "slack-mcp-server"],
+        requiredEnv: {
+            SLACK_BOT_TOKEN: "<xoxb-your-token>",
+            SLACK_TEAM_ID: "<T00000000>",
+        },
+        postInstallMessage: "Replace SLACK_BOT_TOKEN and SLACK_TEAM_ID in claude_desktop_config.json,\n" +
+            "or use: claude-ide-bridge install slack --env SLACK_BOT_TOKEN=xoxb-... --env SLACK_TEAM_ID=T...",
+    },
+    playwright: {
+        description: "AI-driven browser automation — navigate, click, fill forms, screenshot (e2e testing)",
+        npmPackage: "@playwright/mcp",
+        command: "npx",
+        args: ["-y", "@playwright/mcp"],
+        postInstallMessage: "Browsers must be installed separately:\n  npx playwright install chromium",
+    },
+    "codebase-memory": {
+        description: "Codebase knowledge graph — call chains, architecture overview, blast-radius analysis (66 languages)",
+        npmPackage: "codebase-memory-mcp",
+        command: "codebase-memory-mcp",
+        args: [],
+        skipNpmInstall: true,
+        postInstallMessage: "Install the binary first (not on npm):\n" +
+            "  curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash\n" +
+            "Then restart Claude Desktop.",
+    },
+};
+//# sourceMappingURL=registry.js.map