@ltm-alpha/alpha-cs 1.6.0

package/dist/installer/targets/codex.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * OpenAI Codex CLI target.
+ *
+ *   - MCP server entry to `config.toml` as the dotted-key table
+ *     `[mcp_servers.codegraph]`. TOML — not JSON — handled by the
+ *     narrow serializer in `./toml.ts`.
+ *   - Instructions to `AGENTS.md`.
+ *
+ * Both locations are supported (#1531):
+ *   - global: `$CODEX_HOME/config.toml` + `$CODEX_HOME/AGENTS.md`,
+ *     falling back to `~/.codex` when the env var is unset (#1627)
+ *   - local:  `<cwd>/.codex/config.toml` + `<cwd>/AGENTS.md`
+ *
+ * Codex has a first-class project config layer: `.codex/config.toml`
+ * is layer 4 of the loader's stack, above the user config (layer 6),
+ * merged recursively top-over-bottom
+ * (`codex-rs/config/src/loader/README.md` in openai/codex). It landed
+ * in openai/codex#8354 (2025-12-22), so the "Codex has no
+ * project-local config" note this file used to carry was never
+ * accurate. The project layer strips a denylist of settings that
+ * repo contents shouldn't get to choose (base URLs, model providers,
+ * `notify`, profiles, otel — `loader/mod.rs`), and `mcp_servers` is
+ * NOT on it, so a project-scoped `[mcp_servers.codegraph]` is honored.
+ *
+ * Caveat surfaced as an install note: project layers are "loaded but
+ * disabled when untrusted," so a local install only takes effect in a
+ * project the user has marked trusted.
+ *
+ * No permissions concept.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codexTarget = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const shared_1 = require("./shared");
+const instructions_template_1 = require("../instructions-template");
+const toml_1 = require("./toml");
+const TOML_HEADER = 'mcp_servers.codegraph';
+function configDir(loc) {
+    if (loc !== 'global')
+        return path.join(process.cwd(), '.codex');
+    // Codex resolves its user layer from `CODEX_HOME` and only falls back to
+    // `~/.codex` (#1627). Installing to the fallback while Codex reads the
+    // override is a silent no-op: the files are written, and Codex never looks
+    // at them. Same resolution the copilot-cli target already does for
+    // `COPILOT_HOME`. Only the user layer moves — the project layer below is
+    // anchored to the project, not the profile.
+    const override = process.env.CODEX_HOME;
+    if (override && override.trim().length > 0)
+        return override;
+    return path.join(os.homedir(), '.codex');
+}
+function tomlConfigPath(loc) {
+    return path.join(configDir(loc), 'config.toml');
+}
+function instructionsPath(loc) {
+    // Global AGENTS.md lives under ~/.codex/; project-local AGENTS.md
+    // lives at the project root (NOT under .codex/) — that's the file
+    // Codex reads for repo instructions, and it matches the local
+    // layout the opencode and gemini targets already use.
+    return loc === 'global'
+        ? path.join(configDir('global'), 'AGENTS.md')
+        : path.join(process.cwd(), 'AGENTS.md');
+}
+/**
+ * Project layers are "loaded but disabled when untrusted" (openai/codex
+ * `loader/mod.rs`), so a local install can be written correctly and
+ * still do nothing. Say so rather than reporting silent success.
+ */
+function trustNote() {
+    return `Codex applies ${tomlConfigPath('local')} only in a project marked trusted — otherwise the layer is loaded but disabled. Trust this project in Codex to activate it.`;
+}
+class CodexTarget {
+    id = 'codex';
+    displayName = 'Codex CLI';
+    docsUrl = 'https://github.com/openai/codex';
+    supportsLocation(_loc) {
+        return true;
+    }
+    detect(loc) {
+        const tomlPath = tomlConfigPath(loc);
+        let alreadyConfigured = false;
+        if (fs.existsSync(tomlPath)) {
+            try {
+                const content = fs.readFileSync(tomlPath, 'utf-8');
+                alreadyConfigured = content.includes(`[${TOML_HEADER}]`);
+            }
+            catch { /* ignore */ }
+        }
+        // Global: ~/.codex/ existing means Codex has run here. Local: the
+        // project only counts as "Codex-enabled" once it actually has a
+        // .codex/ dir or config file of its own.
+        const installed = fs.existsSync(configDir(loc)) || fs.existsSync(tomlPath);
+        return { installed, alreadyConfigured, configPath: tomlPath };
+    }
+    install(loc, _opts) {
+        const files = [];
+        files.push(writeMcpEntry(loc));
+        // AGENTS.md gets the short marker-fenced Alpha Code Sense block (#704):
+        // subagents and non-MCP harnesses read AGENTS.md but never the MCP
+        // initialize instructions. Upsert self-heals a stale pre-#529 block.
+        files.push((0, shared_1.upsertInstructionsEntry)(instructionsPath(loc)));
+        return loc === 'local' ? { files, notes: [trustNote()] } : { files };
+    }
+    uninstall(loc) {
+        const files = [];
+        const tomlPath = tomlConfigPath(loc);
+        if (fs.existsSync(tomlPath)) {
+            const content = fs.readFileSync(tomlPath, 'utf-8');
+            const { content: nextContent, action } = (0, toml_1.removeTomlTable)(content, TOML_HEADER);
+            if (action === 'removed') {
+                if (nextContent.trim() === '') {
+                    try {
+                        fs.unlinkSync(tomlPath);
+                    }
+                    catch { /* ignore */ }
+                }
+                else {
+                    (0, shared_1.atomicWriteFileSync)(tomlPath, nextContent.trimEnd() + '\n');
+                }
+                files.push({ path: tomlPath, action: 'removed' });
+            }
+            else {
+                files.push({ path: tomlPath, action: 'not-found' });
+            }
+        }
+        else {
+            files.push({ path: tomlPath, action: 'not-found' });
+        }
+        files.push(removeInstructionsEntry(loc));
+        return { files };
+    }
+    printConfig(loc) {
+        const block = buildCodegraphBlock();
+        return `# Add to ${tomlConfigPath(loc)}\n\n${block}\n`;
+    }
+    describePaths(loc) {
+        return [tomlConfigPath(loc), instructionsPath(loc)];
+    }
+}
+function buildCodegraphBlock() {
+    const mcp = (0, shared_1.getMcpServerConfig)();
+    return (0, toml_1.buildTomlTable)(TOML_HEADER, {
+        command: mcp.command,
+        args: mcp.args,
+    });
+}
+function writeMcpEntry(loc) {
+    const file = tomlConfigPath(loc);
+    const dir = path.dirname(file);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const block = buildCodegraphBlock();
+    // Single read — `existing === ''` derives both "is the file empty
+    // or absent" and "what was its content," avoiding a TOCTOU window
+    // between two `fs.existsSync` calls.
+    const existing = fs.existsSync(file) ? fs.readFileSync(file, 'utf-8') : '';
+    const created = existing.length === 0;
+    const { content: nextContent, action } = (0, toml_1.upsertTomlTable)(existing, TOML_HEADER, block);
+    if (action === 'unchanged') {
+        return { path: file, action: 'unchanged' };
+    }
+    (0, shared_1.atomicWriteFileSync)(file, nextContent);
+    return { path: file, action: created ? 'created' : 'updated' };
+}
+/**
+ * Strip the marker-delimited Alpha Code Sense block from this location's
+ * AGENTS.md if a prior install wrote one. Used by both install
+ * (self-heal on upgrade) and uninstall — see issue #529.
+ */
+function removeInstructionsEntry(loc) {
+    const file = instructionsPath(loc);
+    const action = (0, shared_1.removeMarkedSection)(file, instructions_template_1.CODEGRAPH_SECTION_START, instructions_template_1.CODEGRAPH_SECTION_END);
+    return { path: file, action };
+}
+exports.codexTarget = new CodexTarget();
+//# sourceMappingURL=codex.js.map

package/dist/installer/targets/codex.js.map

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

package/dist/installer/targets/copilot-cli.d.ts

@@ -0,0 +1,32 @@
+/**
+ * GitHub Copilot CLI target.
+ *
+ *   - MCP server entry to `~/.copilot/mcp-config.json` under the
+ *     `mcpServers` key (same wrapper as Claude/Cursor). Entry shape per
+ *     the GitHub docs: `{ "type": "stdio", "command", "args", "tools" }`
+ *     — `type` accepts `"local"` or `"stdio"`; we write `"stdio"` (the
+ *     standard MCP name, recommended by the docs for cross-client
+ *     compatibility). `"tools": ["*"]` mirrors the docs' example and is
+ *     the documented default.
+ *   - The config dir is `~/.copilot` unless the user moved it via
+ *     `COPILOT_HOME` (documented override) — we honor it so install and
+ *     detect follow the CLI's own resolution.
+ *
+ * Copilot CLI as of 2026-07 has no project-local MCP config — per-repo
+ * config (`.github/mcp.json`) is an open feature request
+ * (github/copilot-cli#2528). `supportsLocation('local')` returns false;
+ * the orchestrator skips this target for local installs with a clear
+ * message (same pattern as Codex).
+ *
+ * The file is machine-written by the CLI's own `/mcp add` flow, so it's
+ * plain JSON — no JSONC handling needed; surgical edits go through the
+ * shared read/mutate/write helpers (Cursor pattern), preserving sibling
+ * servers.
+ *
+ * No instructions file (MCP `initialize` instructions are the single
+ * source of truth, #529) and no permissions concept — `autoAllow` is
+ * silently ignored.
+ */
+import { AgentTarget } from './types';
+export declare const copilotCliTarget: AgentTarget;
+//# sourceMappingURL=copilot-cli.d.ts.map

package/dist/installer/targets/copilot-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-cli.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/copilot-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,EACL,WAAW,EAKZ,MAAM,SAAS,CAAC;AA8JjB,eAAO,MAAM,gBAAgB,EAAE,WAAoC,CAAC"}

package/dist/installer/targets/copilot-cli.js

@@ -0,0 +1,215 @@
+"use strict";
+/**
+ * GitHub Copilot CLI target.
+ *
+ *   - MCP server entry to `~/.copilot/mcp-config.json` under the
+ *     `mcpServers` key (same wrapper as Claude/Cursor). Entry shape per
+ *     the GitHub docs: `{ "type": "stdio", "command", "args", "tools" }`
+ *     — `type` accepts `"local"` or `"stdio"`; we write `"stdio"` (the
+ *     standard MCP name, recommended by the docs for cross-client
+ *     compatibility). `"tools": ["*"]` mirrors the docs' example and is
+ *     the documented default.
+ *   - The config dir is `~/.copilot` unless the user moved it via
+ *     `COPILOT_HOME` (documented override) — we honor it so install and
+ *     detect follow the CLI's own resolution.
+ *
+ * Copilot CLI as of 2026-07 has no project-local MCP config — per-repo
+ * config (`.github/mcp.json`) is an open feature request
+ * (github/copilot-cli#2528). `supportsLocation('local')` returns false;
+ * the orchestrator skips this target for local installs with a clear
+ * message (same pattern as Codex).
+ *
+ * The file is machine-written by the CLI's own `/mcp add` flow, so it's
+ * plain JSON — no JSONC handling needed; surgical edits go through the
+ * shared read/mutate/write helpers (Cursor pattern), preserving sibling
+ * servers.
+ *
+ * No instructions file (MCP `initialize` instructions are the single
+ * source of truth, #529) and no permissions concept — `autoAllow` is
+ * silently ignored.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copilotCliTarget = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const shared_1 = require("./shared");
+function configDir() {
+    const override = process.env.COPILOT_HOME;
+    if (override && override.trim().length > 0)
+        return override;
+    return path.join(os.homedir(), '.copilot');
+}
+function mcpConfigPath() {
+    return path.join(configDir(), 'mcp-config.json');
+}
+/**
+ * `~/.copilot` existing is NOT proof the CLI is installed: the VS Code
+ * Copilot Chat extension drops MCP socket-handoff lock files into
+ * `~/.copilot/ide/` on launch, so a machine with only the VS Code
+ * extension still has the dir (with a lone `ide` entry). Count the dir
+ * as a CLI footprint only when it holds anything besides `ide` — the
+ * CLI writes `config.json` (and later `mcp-config.json`, history state)
+ * on first run.
+ */
+function cliConfigDirPresent() {
+    let entries;
+    try {
+        entries = fs.readdirSync(configDir());
+    }
+    catch {
+        return false;
+    }
+    return entries.some((e) => e !== 'ide');
+}
+/**
+ * Best-effort check that the `copilot` binary is reachable on PATH.
+ * A plain fs scan (no shell-out) — cheap enough to run inside
+ * `detectAll()` for the multiselect prompt.
+ */
+function copilotOnPath() {
+    const pathVar = process.env.PATH || '';
+    const exts = process.platform === 'win32'
+        ? ['.exe', '.cmd', '.bat', '.ps1']
+        : [''];
+    for (const dir of pathVar.split(path.delimiter)) {
+        if (!dir)
+            continue;
+        for (const ext of exts) {
+            try {
+                if (fs.existsSync(path.join(dir, 'copilot' + ext)))
+                    return true;
+            }
+            catch { /* ignore unreadable PATH entries */ }
+        }
+    }
+    return false;
+}
+/**
+ * The shared stdio entry, every tool allowed, and `deferTools: 'never'`: Copilot CLI's tool
+ * search (on by default from ~30 connected tools on Claude and GPT-5.4+ models) otherwise holds
+ * MCP tools back until the model searches for them, so `codegraph_explore` would be a name the
+ * model has to go looking for before it can follow the "call it instead of Read" instruction.
+ */
+function buildCopilotMcpConfig() {
+    const base = (0, shared_1.getMcpServerConfig)();
+    return { ...base, tools: ['*'], deferTools: 'never' };
+}
+class CopilotCliTarget {
+    id = 'copilot-cli';
+    displayName = 'GitHub Copilot CLI';
+    docsUrl = 'https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers';
+    supportsLocation(loc) {
+        return loc === 'global';
+    }
+    detect(loc) {
+        if (loc !== 'global') {
+            return { installed: false, alreadyConfigured: false };
+        }
+        const file = mcpConfigPath();
+        const config = (0, shared_1.readJsonFile)(file);
+        const alreadyConfigured = !!config.mcpServers?.['alpha-cs'];
+        const installed = cliConfigDirPresent() || copilotOnPath();
+        return { installed, alreadyConfigured, configPath: file };
+    }
+    install(loc, _opts) {
+        if (loc !== 'global') {
+            return {
+                files: [],
+                notes: ['Copilot CLI has no project-local config — re-run with --location=global to install.'],
+            };
+        }
+        return {
+            files: [writeMcpEntry()],
+            notes: ['Restart any running Copilot CLI session to pick up the MCP server.'],
+        };
+    }
+    uninstall(loc) {
+        if (loc !== 'global')
+            return { files: [] };
+        const file = mcpConfigPath();
+        if (!fs.existsSync(file)) {
+            return { files: [{ path: file, action: 'not-found' }] };
+        }
+        const config = (0, shared_1.readJsonFile)(file);
+        if (!config.mcpServers?.['alpha-cs']) {
+            return { files: [{ path: file, action: 'not-found' }] };
+        }
+        delete config.mcpServers['alpha-cs'];
+        if (Object.keys(config.mcpServers).length === 0) {
+            delete config.mcpServers;
+        }
+        if (Object.keys(config).length === 0) {
+            // Nothing left but the `{}` we'd write back — delete the file so
+            // uninstall fully reverses a from-scratch install. A leftover
+            // empty file would keep detect() reporting the CLI as installed.
+            fs.unlinkSync(file);
+        }
+        else {
+            (0, shared_1.writeJsonFile)(file, config);
+        }
+        return { files: [{ path: file, action: 'removed' }] };
+    }
+    printConfig(loc) {
+        if (loc !== 'global') {
+            return '# Copilot CLI has no project-local config — use --location=global.\n';
+        }
+        const snippet = JSON.stringify({ mcpServers: { 'alpha-cs': buildCopilotMcpConfig() } }, null, 2);
+        return `# Add to ${mcpConfigPath()}\n\n${snippet}\n`;
+    }
+    describePaths(loc) {
+        if (loc !== 'global')
+            return [];
+        return [mcpConfigPath()];
+    }
+}
+function writeMcpEntry() {
+    const file = mcpConfigPath();
+    const existing = (0, shared_1.readJsonFile)(file);
+    const before = existing.mcpServers?.['alpha-cs'];
+    const after = buildCopilotMcpConfig();
+    if ((0, shared_1.jsonDeepEqual)(before, after)) {
+        return { path: file, action: 'unchanged' };
+    }
+    const existed = fs.existsSync(file);
+    if (!existing.mcpServers)
+        existing.mcpServers = {};
+    existing.mcpServers['alpha-cs'] = after;
+    (0, shared_1.writeJsonFile)(file, existing);
+    return { path: file, action: existed ? 'updated' : 'created' };
+}
+exports.copilotCliTarget = new CopilotCliTarget();
+//# sourceMappingURL=copilot-cli.js.map

package/dist/installer/targets/copilot-cli.js.map

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

package/dist/installer/targets/copilot-jetbrains.d.ts

@@ -0,0 +1,42 @@
+/**
+ * JetBrains IDEs (GitHub Copilot plugin) target.
+ *
+ *   - MCP server entry to the plugin's user-level `mcp.json`, which
+ *     lives under the shared `github-copilot` config dir (the same dir
+ *     the Copilot ecosystem uses for `hosts.json`):
+ *
+ *       macOS/Linux: $XDG_CONFIG_HOME|~/.config/github-copilot/intellij/mcp.json
+ *       Windows:     %LOCALAPPDATA%\github-copilot\intellij\mcp.json
+ *
+ *     `$XDG_CONFIG_HOME` is honored on every platform when set —
+ *     matching the plugin family's own resolution (copilot.vim /
+ *     copilot-language-server check it before the OS default).
+ *   - Shape is VS Code-compatible: `{ "servers": { "<name>": { "type":
+ *     "stdio", "command", "args" } } }` — the plugin documents mcp.json
+ *     parity with `.vscode/mcp.json`.
+ *   - **Global-only.** The plugin reads exactly one user-level file; a
+ *     project-level mcp.json is an open feature request
+ *     (microsoft/copilot-intellij-feedback#701, still open 2026-07).
+ *     `supportsLocation('local')` returns false so the orchestrator
+ *     skips local installs with a clear message (Codex pattern).
+ *   - No `--path` injection: the config is user-global and the plugin
+ *     documents no `${workspaceFolder}`-style variable expansion for
+ *     this file, so we ship the plain entry and let the MCP server
+ *     resolve the project from the client's roots/cwd as with other
+ *     global installs.
+ *   - No instructions file (MCP `initialize` instructions are the
+ *     single source of truth, #529) and no permissions concept —
+ *     `autoAllow` is silently ignored.
+ *
+ * The IDE opens this file in a JSON editor for hand-editing (Settings →
+ * Tools → GitHub Copilot → MCP → Configure), so reads + writes go
+ * through `jsonc-parser` — surgical edits that preserve sibling
+ * servers, user comments, and formatting (same approach as the
+ * copilot-vscode target).
+ *
+ * The plugin only re-reads mcp.json on IDE restart
+ * (microsoft/copilot-intellij-feedback#1139) — hence the restart note.
+ */
+import { AgentTarget } from './types';
+export declare const copilotJetbrainsTarget: AgentTarget;
+//# sourceMappingURL=copilot-jetbrains.d.ts.map

package/dist/installer/targets/copilot-jetbrains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-jetbrains.d.ts","sourceRoot":"","sources":["../../../src/installer/targets/copilot-jetbrains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAMH,OAAO,EACL,WAAW,EAKZ,MAAM,SAAS,CAAC;AAmLjB,eAAO,MAAM,sBAAsB,EAAE,WAA0C,CAAC"}