@colbymchenry/codegraph-darwin-x64 0.9.0

package/lib/dist/installer/targets/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Agent target abstraction for the installer.
+ *
+ * Each MCP-capable agent (Claude Code, Cursor, Codex CLI, opencode, ...)
+ * implements this interface so the installer orchestrator can write the
+ * right MCP-server config + instructions file + permissions for that
+ * agent without baking client-specific paths into core code. Adding a
+ * new agent = one new file in `targets/` + one entry in `registry.ts`.
+ *
+ * Closes the Claude-locked installer issue (upstream #137). The
+ * runtime MCP server is already agent-agnostic; this brings the
+ * installer to the same surface.
+ */
+export type Location = 'global' | 'local';
+/**
+ * Stable string id used in the `--target` CLI flag and the registry
+ * lookup. New targets add a value here when they're added to the
+ * registry. Keep these short and lowercase.
+ */
+export type TargetId = 'claude' | 'cursor' | 'codex' | 'opencode';
+/**
+ * Result of `target.detect(location)`.
+ *
+ * `installed` is a best-effort heuristic that the agent's CLI / app /
+ * config dir is present on this system — used to default the
+ * multiselect prompt to "what's actually here." False positives are
+ * acceptable (we still write); false negatives just mean the user
+ * has to opt in manually.
+ *
+ * `alreadyConfigured` reports whether codegraph has already been
+ * wired into this target at this location — drives the
+ * "Updated"-vs-"Added" log line and lets `--check` exit 0/1.
+ */
+export interface DetectionResult {
+    installed: boolean;
+    alreadyConfigured: boolean;
+    /** Path inspected; surfaced in diagnostic / dry-run output. */
+    configPath?: string;
+}
+/**
+ * What `target.install(location)` actually changed on disk. The
+ * orchestrator renders one log line per file using `action`.
+ *
+ * `unchanged` means we touched the file but its contents were already
+ * what we'd write — used for byte-identical idempotent re-runs.
+ */
+export interface WriteResult {
+    files: Array<{
+        path: string;
+        action: 'created' | 'updated' | 'unchanged' | 'removed' | 'not-found' | 'kept';
+    }>;
+    /**
+     * Optional one-line notes the orchestrator surfaces verbatim — e.g.
+     * "Restart Cursor to apply." Keep these short; multi-line goes in
+     * the README.
+     */
+    notes?: string[];
+}
+export interface InstallOptions {
+    /**
+     * Whether to write the agent's permissions / auto-allow surface
+     * (Claude `settings.json`, others where applicable). When the
+     * target has no permissions concept this option is a no-op.
+     */
+    autoAllow: boolean;
+}
+export interface AgentTarget {
+    /** Stable id; matches the `TargetId` union. */
+    readonly id: TargetId;
+    /** Human-readable name shown in clack prompts and log lines. */
+    readonly displayName: string;
+    /** Optional URL for "where do I learn more about this agent." */
+    readonly docsUrl?: string;
+    /**
+     * Whether this target supports the given install location.
+     *
+     * Some agents (Codex CLI as of 2026-05) have no project-local
+     * config concept — only a single `~/.codex/` dir. Returning false
+     * for an unsupported (target, location) pair lets the orchestrator
+     * skip cleanly with a clear message.
+     */
+    supportsLocation(loc: Location): boolean;
+    detect(loc: Location): DetectionResult;
+    install(loc: Location, opts: InstallOptions): WriteResult;
+    /**
+     * Inverse of install. Removes only what install would have written;
+     * preserves sibling MCP servers, sibling permissions, and unrelated
+     * markdown sections. Must be safe to call when nothing was ever
+     * installed (returns `not-found` actions).
+     */
+    uninstall(loc: Location): WriteResult;
+    /**
+     * Print the MCP-server snippet a user would paste manually for this
+     * target. Used by `codegraph install --print-config <id>` and by
+     * the README. Must NOT touch the filesystem.
+     */
+    printConfig(loc: Location): string;
+    /** Filesystem paths this target would write to at this location. */
+    describePaths(loc: Location): string[];
+    /**
+     * Optional. Write any project-local surfaces this target needs in
+     * order to work fully when its MCP config is configured globally.
+     * Called by `codegraph init` to bootstrap new projects without
+     * forcing the user to re-run `codegraph install` per project.
+     *
+     * Most targets need nothing here — their global config is complete.
+     * Cursor is the notable exception: its rules system
+     * (`.cursor/rules/*.mdc`) is project-scoped only, and is what makes
+     * Cursor's agent prefer codegraph over its built-in grep.
+     *
+     * Must be idempotent. Targets that have nothing project-local omit
+     * the method entirely.
+     */
+    wireProjectSurfaces?(): WriteResult;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/dist/installer/targets/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE1C;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAElE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;KAChF,CAAC,CAAC;IACH;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,gEAAgE;IAChE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzC,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,eAAe,CAAC;IACvC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,WAAW,CAAC;IAC1D;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC;IACtC;;;;OAIG;IACH,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAAC;IACnC,oEAAoE;IACpE,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,EAAE,CAAC;IACvC;;;;;;;;;;;;;OAaG;IACH,mBAAmB,CAAC,IAAI,WAAW,CAAC;CACrC"}

package/lib/dist/installer/targets/types.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Agent target abstraction for the installer.
+ *
+ * Each MCP-capable agent (Claude Code, Cursor, Codex CLI, opencode, ...)
+ * implements this interface so the installer orchestrator can write the
+ * right MCP-server config + instructions file + permissions for that
+ * agent without baking client-specific paths into core code. Adding a
+ * new agent = one new file in `targets/` + one entry in `registry.ts`.
+ *
+ * Closes the Claude-locked installer issue (upstream #137). The
+ * runtime MCP server is already agent-agnostic; this brings the
+ * installer to the same surface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/dist/installer/targets/types.js.map

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

package/lib/dist/mcp/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * CodeGraph MCP Server
+ *
+ * Model Context Protocol server that exposes CodeGraph functionality
+ * as tools for AI assistants like Claude.
+ *
+ * @module mcp
+ *
+ * @example
+ * ```typescript
+ * import { MCPServer } from 'codegraph';
+ *
+ * const server = new MCPServer('/path/to/project');
+ * await server.start();
+ * ```
+ */
+/**
+ * MCP Server for CodeGraph
+ *
+ * Implements the Model Context Protocol to expose CodeGraph
+ * functionality as tools that can be called by AI assistants.
+ */
+export declare class MCPServer {
+    private transport;
+    private cg;
+    private toolHandler;
+    private projectPath;
+    private initPromise;
+    private clientSupportsRoots;
+    private rootsAttempted;
+    constructor(projectPath?: string);
+    /**
+     * Start the MCP server
+     *
+     * Note: CodeGraph initialization is deferred until the initialize request
+     * is received, which includes the rootUri from the client.
+     */
+    start(): Promise<void>;
+    /**
+     * Try to initialize CodeGraph for the default project.
+     *
+     * Walks up parent directories to find the nearest .codegraph/ folder,
+     * similar to how git finds .git/ directories.
+     *
+     * If initialization fails, the error is recorded but the server continues
+     * to work — cross-project queries and retries on subsequent tool calls
+     * are still possible.
+     */
+    private tryInitializeDefault;
+    /**
+     * Retry initialization of the default project if it previously failed.
+     * Called lazily on tool calls that need the default project.
+     * Re-walks parent directories each time so it picks up projects
+     * initialized after the MCP server started.
+     *
+     * Awaits any in-flight background init (kicked off by handleInitialize) so
+     * we never open the SQLite file twice concurrently.
+     */
+    private retryInitIfNeeded;
+    /**
+     * Resolve the project root via the MCP `roots/list` request and initialize
+     * from the first root the client reports. Falls back to the process cwd if
+     * the client returns no usable root or doesn't answer in time. See issue #196.
+     */
+    private initFromRoots;
+    /**
+     * Start file watching on the active CodeGraph instance.
+     * Logs sync activity to stderr for diagnostics.
+     */
+    private startWatching;
+    /**
+     * Stop the server
+     */
+    stop(): void;
+    /**
+     * Handle incoming JSON-RPC messages
+     */
+    private handleMessage;
+    /**
+     * Handle initialize request
+     */
+    private handleInitialize;
+    /**
+     * Handle tools/list request
+     */
+    private handleToolsList;
+    /**
+     * Handle tools/call request
+     */
+    private handleToolsCall;
+}
+export { StdioTransport } from './transport';
+export { tools, ToolHandler } from './tools';
+//# sourceMappingURL=index.d.ts.map

package/lib/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA6DH;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAAgB;IAGnC,OAAO,CAAC,WAAW,CAA8B;IAIjD,OAAO,CAAC,mBAAmB,CAAS;IAGpC,OAAO,CAAC,cAAc,CAAS;gBAEnB,WAAW,CAAC,EAAE,MAAM;IAOhC;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;;;;;;;;OASG;YACW,oBAAoB;IAyBlC;;;;;;;;OAQG;YACW,iBAAiB;IA+C/B;;;;OAIG;YACW,aAAa;IAiB3B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAsCrB;;OAEG;IACH,IAAI,IAAI,IAAI;IAYZ;;OAEG;YACW,aAAa;IA6C3B;;OAEG;YACW,gBAAgB;IA6D9B;;OAEG;YACW,eAAe;IAO7B;;OAEG;YACW,eAAe;CAqC9B;AAGD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}