arkts-lsp-proxy 0.1.6 → 0.1.8

package/README.md

@@ -1,6 +1,6 @@
 # ArkTS LSP Proxy
 
-将 DevEco Studio 内置的 ArkTS 语言服务器（ace-server）桥接出来，让 Claude Code 等支持 LSP 的工具获得 ArkTS 语言智能。
+将 DevEco Studio 内置的 ArkTS 语言服务器（ace-server）桥接出来，让 Claude Code 等支持 LSP 的工具获得 ArkTS 语言智能；同时提供 Codex MCP 适配器，让 Codex 通过工具调用使用 ArkTS hover、definition、symbols 和 diagnostics。
 
 ## 解决什么问题
 
@@ -35,7 +35,21 @@ arkts-lsp-proxy (Node.js 进程)
          └── @Component/@State/@Prop 语义理解
 ```
 
-代理不实现 ArkTS 语义分析，只做启动适配、消息转发、参数注入和必要的 LSP 结果归一化。比如 DevEco ace-server 会把 hover 内容包成私有 JSON 字符串，代理会转换成标准 Markdown hover，方便 Claude Code 直接消费类型信息。DevEco ace-server 未提供的 symbol 能力由 proxy 做轻量 fallback。
+Codex 侧不使用 Claude Code 的 `.lsp.json` 自动激活模型，而是通过 `arkts-lsp-mcp` 启动 MCP server：
+
+```
+Codex
+    │ MCP stdio (JSON-RPC lines)
+    ▼
+arkts-lsp-mcp
+    ├── 轻量工具：project_info / document_symbols / workspace_symbols
+    └── LSP-backed 工具：hover / definition / references / signature_help / diagnostics
+         │
+         ▼
+    arkts-lsp-proxy → ace-server
+```
+
+代理不实现 ArkTS 语义分析，只做启动适配、消息转发、参数注入和必要的 LSP 结果归一化。比如 DevEco ace-server 会把 hover 内容包成私有 JSON 字符串，代理会转换成标准 Markdown hover，方便 Claude Code 或 Codex 直接消费类型信息。DevEco ace-server 未提供的 symbol 能力由 proxy/MCP 做轻量 fallback。
 
 ## 当前支持的核心能力
 
@@ -47,6 +61,7 @@ arkts-lsp-proxy (Node.js 进程)
 - `textDocument/documentSymbol`，基于打开文件文本解析 ArkTS/ArkUI 文件结构
 - `workspace/symbol`，基于项目根轻量扫描 `.ets/.ts/.d.ets/.d.ts`
 - diagnostics，来自 ace-server 的发布诊断
+- Codex MCP tools：`arkts_project_info`、`arkts_document_symbols`、`arkts_workspace_symbols`、`arkts_hover`、`arkts_definition`、`arkts_references`、`arkts_signature_help`、`arkts_diagnostics`
 
 ## 前置条件
 
@@ -65,6 +80,57 @@ arkts-lsp-proxy (Node.js 进程)
 /plugin install arkts-lsp
 ```
 
+### Codex 项目级 MCP
+
+Codex 不使用全局 marketplace 安装。为了避免所有项目都加载 ArkTS MCP 工具，
+请在需要启用 ArkTS 能力的 Codex 项目目录执行项目级安装脚本：
+
+```bash
+npx -y --package arkts-lsp-proxy@latest arkts-lsp-codex-install
+```
+
+脚本只负责写入当前项目的 Codex 配置，不会判断该目录是不是 HarmonyOS 项目，也不会扫描
+子目录。它会写入：
+
+```text
+<project>/.codex/config.toml
+```
+
+写入内容等价于：
+
+```toml
+[mcp_servers.arkts-lsp]
+command = "npx"
+args = ["-y", "--package", "arkts-lsp-proxy@latest", "arkts-lsp-mcp"]
+
+[mcp_servers.arkts-lsp.env]
+ARKTS_LSP_SYNC = "auto"
+```
+
+这样 ArkTS MCP 只在该 Codex 项目中生效；其它项目没有这段项目级
+`.codex/config.toml`，不会暴露 ArkTS tools，也不会占用工具上下文。真正的
+HarmonyOS 项目识别由 MCP tools 在运行时根据文件路径、`projectRoot` 或 `startPath`
+完成。
+
+安装脚本会按当前项目状态处理：
+
+| 场景 | 行为 |
+|------|------|
+| 没有 `.codex/config.toml` | 创建 `.codex/` 目录和新的 `config.toml` |
+| 已有 `.codex/config.toml`，但没有 Codex MCP 配置 | 先备份原文件，再写入 `arkts-lsp` MCP 配置 |
+| 已有 `.codex/config.toml`，且已有其它配置 | 先备份原文件，保留其它配置，只新增或替换 `[mcp_servers.arkts-lsp]` 相关配置 |
+
+备份文件位于同一目录，形如 `config.toml.bak-YYYYMMDDTHHMMSSZ`。安装脚本只清理
+自己生成的时间戳备份，默认保留最近 3 份；其它手工备份文件不会被删除。如果只是想
+预览将要写入的内容，可以先执行：
+
+```bash
+npx -y --package arkts-lsp-proxy@latest arkts-lsp-codex-install --dry-run
+```
+
+注意：Codex 只会读取 trusted project 的项目级 `.codex/config.toml`。安装后请在
+该项目根目录启动 Codex，必要时重启当前 Codex 会话。
+
 ### npm 全局安装（手动 CLI 使用）
 
 ```bash
@@ -98,6 +164,12 @@ export DEVECO_HOME=/opt/DevEco-Studio
 arkts-lsp-proxy --project-root /path/to/harmonyos/project
 ```
 
+也可以手动启动 Codex MCP server：
+
+```bash
+arkts-lsp-mcp
+```
+
 当从非鸿蒙目录启动时，默认不会立即校验项目；会等到 LSP 初始化请求到来后根据 `rootUri`/`workspaceFolders` 自动定位鸿蒙项目路径。
 
 ### Hvigor metadata sync
@@ -187,24 +259,32 @@ src/
 ├── hvigor.ts       hvigor metadata 状态、sync 策略与后台执行
 ├── ace-server.ts   ace-server 子进程生命周期管理（onExit 回调）
 ├── proxy.ts        LSP 消息代理，拦截 initialize 注入参数
-└── index.ts        入口，串联所有模块
+├── arkts-client.ts Codex MCP 侧复用 proxy 的轻量 LSP client
+├── mcp-tools.ts    ArkTS MCP tools 的实现
+├── mcp.ts          MCP JSON-RPC 协议处理与 stdio server
+├── mcp-server.ts   arkts-lsp-mcp 入口
+├── codex-install.ts Codex 项目级 MCP 安装脚本
+└── index.ts        arkts-lsp-proxy 入口
 .claude-plugin/
 └── marketplace.json    marketplace 清单 + lspServers 配置
 plugins/
 └── arkts-lsp/
     ├── .claude-plugin/
-    │   └── plugin.json     插件清单
+    │   └── plugin.json     Claude Code 插件清单
     ├── hooks/
     │   └── hooks.json      SessionStart 自动安装 hook
     ├── package.json        npm 依赖声明（供 hook 自动安装）
     ├── .lsp.json           LSP 服务器配置
-    └── README.md           插件文档
+    └── README.md           Claude Code 插件文档
 test/
+├── codex-install.test.ts
 ├── env.test.ts
 ├── project.test.ts
 ├── hvigor.test.ts
 ├── ace-server.test.ts
 ├── proxy.test.ts
+├── mcp.test.ts
+├── mcp-tools.test.ts
 ├── index.test.ts
 └── fixtures/
 ```
@@ -214,6 +294,7 @@ test/
 - TypeScript
 - `vscode-jsonrpc` — LSP 消息解析与传输
 - `json5` — 解析 `build-profile.json5`
+- MCP stdio JSON-RPC — Codex 工具入口（零新增运行时依赖）
 - Vitest — 测试
 
 ## License

package/dist/arkts-client.d.ts

@@ -0,0 +1,43 @@
+import { type DevEcoEnv } from './env';
+import { type ProxyHandle } from './proxy';
+export interface Position {
+    line: number;
+    character: number;
+}
+export interface ArktsRequest {
+    projectRoot?: string;
+    filePath: string;
+    position: Position;
+    text?: string;
+}
+export interface ArktsDiagnosticsRequest {
+    projectRoot?: string;
+    filePath: string;
+    text?: string;
+    timeoutMs?: number;
+}
+export type ProxyFactory = (clientIn: NodeJS.ReadableStream, clientOut: NodeJS.WritableStream, env: DevEcoEnv, options: {
+    env: DevEcoEnv;
+    projectRootHint?: string;
+}) => ProxyHandle;
+export interface ArktsLanguageClientOptions {
+    envFinder?: () => DevEcoEnv | null;
+    proxyFactory?: ProxyFactory;
+}
+export declare class ArktsLanguageClient {
+    private readonly envFinder;
+    private readonly proxyFactory;
+    private readonly sessions;
+    constructor(options?: ArktsLanguageClientOptions);
+    hover(request: ArktsRequest): Promise<unknown>;
+    definition(request: ArktsRequest): Promise<unknown>;
+    references(request: ArktsRequest): Promise<unknown>;
+    signatureHelp(request: ArktsRequest): Promise<unknown>;
+    diagnostics(request: ArktsDiagnosticsRequest): Promise<unknown[]>;
+    dispose(): void;
+    private sendPositionRequest;
+    private getSession;
+    private createSession;
+    private ensureDocument;
+}
+//# sourceMappingURL=arkts-client.d.ts.map

package/dist/arkts-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arkts-client.d.ts","sourceRoot":"","sources":["../src/arkts-client.ts"],"names":[],"mappings":"AAUA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAGxD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,MAAM,MAAM,YAAY,GAAG,CACzB,QAAQ,EAAE,MAAM,CAAC,cAAc,EAC/B,SAAS,EAAE,MAAM,CAAC,cAAc,EAChC,GAAG,EAAE,SAAS,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,KAClD,WAAW,CAAC;AAEjB,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,MAAM,SAAS,GAAG,IAAI,CAAC;IACnC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAmCD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuC;gBAEpD,OAAO,GAAE,0BAA+B;IAK9C,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnD,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,WAAW,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAuBvE,OAAO,IAAI,IAAI;YAOD,mBAAmB;IAajC,OAAO,CAAC,UAAU;YAcJ,aAAa;YAyDb,cAAc;CAgC7B"}

package/dist/arkts-client.js

@@ -0,0 +1,213 @@
+"use strict";
+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.ArktsLanguageClient = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_stream_1 = require("node:stream");
+const node_url_1 = require("node:url");
+const node_1 = require("vscode-jsonrpc/node");
+const env_1 = require("./env");
+const proxy_1 = require("./proxy");
+const project_1 = require("./project");
+const defaultProxyFactory = (clientIn, clientOut, env, options) => (0, proxy_1.createProxy)(clientIn, clientOut, env, options);
+function resolveProjectRoot(projectRoot, filePath) {
+    const candidate = projectRoot ? path.resolve(projectRoot) : path.resolve(filePath);
+    const resolved = (0, project_1.findProjectRoot)(candidate);
+    if (!resolved) {
+        throw new Error(`No ArkTS project root found for ${candidate}`);
+    }
+    return resolved;
+}
+function readDocumentText(filePath, explicitText) {
+    if (typeof explicitText === 'string') {
+        return explicitText;
+    }
+    return fs.readFileSync(filePath, 'utf8');
+}
+class ArktsLanguageClient {
+    envFinder;
+    proxyFactory;
+    sessions = new Map();
+    constructor(options = {}) {
+        this.envFinder = options.envFinder ?? env_1.findDevEcoEnv;
+        this.proxyFactory = options.proxyFactory ?? defaultProxyFactory;
+    }
+    async hover(request) {
+        return this.sendPositionRequest('textDocument/hover', request);
+    }
+    async definition(request) {
+        return this.sendPositionRequest('textDocument/definition', request);
+    }
+    async references(request) {
+        return this.sendPositionRequest('textDocument/references', {
+            ...request,
+            context: { includeDeclaration: true },
+        });
+    }
+    async signatureHelp(request) {
+        return this.sendPositionRequest('textDocument/signatureHelp', request);
+    }
+    async diagnostics(request) {
+        const filePath = path.resolve(request.filePath);
+        const projectRoot = resolveProjectRoot(request.projectRoot, filePath);
+        const session = await this.getSession(projectRoot);
+        const uri = await this.ensureDocument(session, filePath, request.text);
+        const existing = session.diagnostics.get(uri);
+        if (existing) {
+            return existing;
+        }
+        return new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                resolve(session.diagnostics.get(uri) ?? []);
+            }, request.timeoutMs ?? 1500);
+            const pending = session.pendingDiagnostics.get(uri) ?? [];
+            pending.push((diagnostics) => {
+                clearTimeout(timeout);
+                resolve(diagnostics);
+            });
+            session.pendingDiagnostics.set(uri, pending);
+        });
+    }
+    dispose() {
+        for (const promise of this.sessions.values()) {
+            promise.then((session) => session.handle.dispose()).catch(() => undefined);
+        }
+        this.sessions.clear();
+    }
+    async sendPositionRequest(method, request) {
+        const filePath = path.resolve(request.filePath);
+        const projectRoot = resolveProjectRoot(request.projectRoot, filePath);
+        const session = await this.getSession(projectRoot);
+        const uri = await this.ensureDocument(session, filePath, request.text);
+        return session.connection.sendRequest(method, {
+            textDocument: { uri },
+            position: request.position,
+            ...(request.context ? { context: request.context } : {}),
+        });
+    }
+    getSession(projectRoot) {
+        const existing = this.sessions.get(projectRoot);
+        if (existing) {
+            return existing;
+        }
+        const created = this.createSession(projectRoot).catch((error) => {
+            this.sessions.delete(projectRoot);
+            throw error;
+        });
+        this.sessions.set(projectRoot, created);
+        return created;
+    }
+    async createSession(projectRoot) {
+        const env = this.envFinder();
+        if (!env) {
+            throw new Error('DevEco Studio not found. Set DEVECO_HOME or ARKTS_DEVECO_HOME.');
+        }
+        const clientIn = new node_stream_1.PassThrough();
+        const clientOut = new node_stream_1.PassThrough();
+        const handle = this.proxyFactory(clientIn, clientOut, env, { env, projectRootHint: projectRoot });
+        const connection = (0, node_1.createMessageConnection)(new node_1.StreamMessageReader(clientOut), new node_1.StreamMessageWriter(clientIn));
+        const session = {
+            projectRoot,
+            connection,
+            handle,
+            documents: new Map(),
+            diagnostics: new Map(),
+            pendingDiagnostics: new Map(),
+        };
+        connection.onNotification('textDocument/publishDiagnostics', (params) => {
+            const payload = params;
+            if (typeof payload.uri !== 'string') {
+                return;
+            }
+            const diagnostics = Array.isArray(payload.diagnostics) ? payload.diagnostics : [];
+            session.diagnostics.set(payload.uri, diagnostics);
+            const pending = session.pendingDiagnostics.get(payload.uri) ?? [];
+            session.pendingDiagnostics.delete(payload.uri);
+            for (const resolve of pending) {
+                resolve(diagnostics);
+            }
+        });
+        connection.listen();
+        await connection.sendRequest('initialize', {
+            processId: process.pid,
+            rootUri: (0, node_url_1.pathToFileURL)(projectRoot).toString(),
+            workspaceFolders: [
+                {
+                    uri: (0, node_url_1.pathToFileURL)(projectRoot).toString(),
+                    name: path.basename(projectRoot),
+                },
+            ],
+            capabilities: {
+                textDocument: {
+                    hover: { contentFormat: ['markdown', 'plaintext'] },
+                },
+            },
+        });
+        connection.sendNotification('initialized', {});
+        return session;
+    }
+    async ensureDocument(session, filePath, explicitText) {
+        const uri = (0, node_url_1.pathToFileURL)(filePath).toString();
+        const text = readDocumentText(filePath, explicitText);
+        const opened = session.documents.get(uri);
+        if (!opened) {
+            session.documents.set(uri, { text, version: 1 });
+            session.connection.sendNotification('textDocument/didOpen', {
+                textDocument: {
+                    uri,
+                    languageId: 'arkts',
+                    version: 1,
+                    text,
+                },
+            });
+            return uri;
+        }
+        if (opened.text !== text) {
+            const next = { text, version: opened.version + 1 };
+            session.documents.set(uri, next);
+            session.connection.sendNotification('textDocument/didChange', {
+                textDocument: {
+                    uri,
+                    version: next.version,
+                },
+                contentChanges: [{ text }],
+            });
+        }
+        return uri;
+    }
+}
+exports.ArktsLanguageClient = ArktsLanguageClient;
+//# sourceMappingURL=arkts-client.js.map

package/dist/arkts-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arkts-client.js","sourceRoot":"","sources":["../src/arkts-client.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA8B;AAC9B,gDAAkC;AAClC,6CAA0C;AAC1C,uCAAyC;AACzC,8CAK6B;AAC7B,+BAAsD;AACtD,mCAAwD;AACxD,uCAA4C;AAmD5C,MAAM,mBAAmB,GAAiB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,CAC9E,IAAA,mBAAW,EAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAEjD,SAAS,kBAAkB,CAAC,WAA+B,EAAE,QAAgB;IAC3E,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnF,MAAM,QAAQ,GAAG,IAAA,yBAAe,EAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB,EAAE,YAAqB;IAC/D,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,MAAa,mBAAmB;IACb,SAAS,CAAyB;IAClC,YAAY,CAAe;IAC3B,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEhE,YAAY,UAAsC,EAAE;QAClD,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,mBAAa,CAAC;QACpD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,mBAAmB,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,OAAqB;QAC/B,OAAO,IAAI,CAAC,mBAAmB,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAqB;QACpC,OAAO,IAAI,CAAC,mBAAmB,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAqB;QACpC,OAAO,IAAI,CAAC,mBAAmB,CAAC,yBAAyB,EAAE;YACzD,GAAG,OAAO;YACV,OAAO,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAqB;QACvC,OAAO,IAAI,CAAC,mBAAmB,CAAC,4BAA4B,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAgC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9C,CAAC,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;gBAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,CAAC,WAAW,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;YACH,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,MAAc,EAAE,OAA6B;QAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAEvE,OAAO,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,MAAM,EAAE;YAC5C,YAAY,EAAE,EAAE,GAAG,EAAE;YACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IAEO,UAAU,CAAC,WAAmB;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YAClC,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,WAAmB;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,yBAAW,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,yBAAW,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC,CAAC;QAClG,MAAM,UAAU,GAAG,IAAA,8BAAuB,EACxC,IAAI,0BAAmB,CAAC,SAAS,CAAC,EAClC,IAAI,0BAAmB,CAAC,QAAQ,CAAC,CAClC,CAAC;QAEF,MAAM,OAAO,GAAY;YACvB,WAAW;YACX,UAAU;YACV,MAAM;YACN,SAAS,EAAE,IAAI,GAAG,EAAE;YACpB,WAAW,EAAE,IAAI,GAAG,EAAE;YACtB,kBAAkB,EAAE,IAAI,GAAG,EAAE;SAC9B,CAAC;QAEF,UAAU,CAAC,cAAc,CAAC,iCAAiC,EAAE,CAAC,MAAM,EAAE,EAAE;YACtE,MAAM,OAAO,GAAG,MAAkD,CAAC;YACnE,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACpC,OAAO;YACT,CAAC;YACD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAClE,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/C,KAAK,MAAM,OAAO,IAAI,OAAO,EAAE,CAAC;gBAC9B,OAAO,CAAC,WAAW,CAAC,CAAC;YACvB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,UAAU,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,UAAU,CAAC,WAAW,CAAC,YAAY,EAAE;YACzC,SAAS,EAAE,OAAO,CAAC,GAAG;YACtB,OAAO,EAAE,IAAA,wBAAa,EAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;YAC9C,gBAAgB,EAAE;gBAChB;oBACE,GAAG,EAAE,IAAA,wBAAa,EAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;oBAC1C,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;iBACjC;aACF;YACD,YAAY,EAAE;gBACZ,YAAY,EAAE;oBACZ,KAAK,EAAE,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE;iBACpD;aACF;SACF,CAAC,CAAC;QACH,UAAU,CAAC,gBAAgB,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC/C,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,OAAgB,EAAE,QAAgB,EAAE,YAAqB;QACpF,MAAM,GAAG,GAAG,IAAA,wBAAa,EAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;YACjD,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,sBAAsB,EAAE;gBAC1D,YAAY,EAAE;oBACZ,GAAG;oBACH,UAAU,EAAE,OAAO;oBACnB,OAAO,EAAE,CAAC;oBACV,IAAI;iBACL;aACF,CAAC,CAAC;YACH,OAAO,GAAG,CAAC;QACb,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YACnD,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACjC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,wBAAwB,EAAE;gBAC5D,YAAY,EAAE;oBACZ,GAAG;oBACH,OAAO,EAAE,IAAI,CAAC,OAAO;iBACtB;gBACD,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AA/KD,kDA+KC"}

package/dist/codex-install.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+export declare const CODEX_MCP_CONFIG_BLOCK = "[mcp_servers.arkts-lsp]\ncommand = \"npx\"\nargs = [\"-y\", \"--package\", \"arkts-lsp-proxy@latest\", \"arkts-lsp-mcp\"]\n\n[mcp_servers.arkts-lsp.env]\nARKTS_LSP_SYNC = \"auto\"\n";
+interface InstallResult {
+    installRoot: string;
+    configPath: string;
+    backupPath?: string;
+    changed: boolean;
+    content: string;
+}
+export declare function upsertCodexMcpConfig(existing: string): string;
+export declare function installCodexProjectConfig(startDir: string, dryRun?: boolean): InstallResult;
+export {};
+//# sourceMappingURL=codex-install.d.ts.map

package/dist/codex-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-install.d.ts","sourceRoot":"","sources":["../src/codex-install.ts"],"names":[],"mappings":";AASA,eAAO,MAAM,sBAAsB,0LAMlC,CAAC;AAQF,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAqFD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG7D;AAgDD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,aAAa,CA4BzF"}

package/dist/codex-install.js

@@ -0,0 +1,229 @@
+#!/usr/bin/env node
+"use strict";
+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.CODEX_MCP_CONFIG_BLOCK = void 0;
+exports.upsertCodexMcpConfig = upsertCodexMcpConfig;
+exports.installCodexProjectConfig = installCodexProjectConfig;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const SERVER_NAME = 'arkts-lsp';
+const CONFIG_RELATIVE_PATH = path.join('.codex', 'config.toml');
+const MAX_GENERATED_BACKUPS = 3;
+exports.CODEX_MCP_CONFIG_BLOCK = `[mcp_servers.${SERVER_NAME}]
+command = "npx"
+args = ["-y", "--package", "arkts-lsp-proxy@latest", "arkts-lsp-mcp"]
+
+[mcp_servers.${SERVER_NAME}.env]
+ARKTS_LSP_SYNC = "auto"
+`;
+function usage() {
+    return `Usage: arkts-lsp-codex-install [--cwd <path>] [--dry-run]
+
+Install ArkTS LSP MCP into a Codex project .codex/config.toml.
+
+Options:
+  --cwd <path>  Project directory to install into, or a file inside it.
+  --dry-run     Print the config path and content without writing files.
+  -h, --help    Show this help.
+`;
+}
+function parseArgs(argv) {
+    const options = {
+        startDir: process.cwd(),
+        dryRun: false,
+        help: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === '-h' || arg === '--help') {
+            options.help = true;
+            continue;
+        }
+        if (arg === '--dry-run') {
+            options.dryRun = true;
+            continue;
+        }
+        if ((arg === '--cwd' || arg === '--project-root') && argv[i + 1]) {
+            options.startDir = argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--cwd=')) {
+            options.startDir = arg.slice('--cwd='.length);
+            continue;
+        }
+        if (arg.startsWith('--project-root=')) {
+            options.startDir = arg.slice('--project-root='.length);
+            continue;
+        }
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+    return options;
+}
+function isExistingFile(filePath) {
+    try {
+        return fs.statSync(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function resolveInstallRoot(startDir) {
+    const resolved = path.resolve(startDir);
+    return isExistingFile(resolved) ? path.dirname(resolved) : resolved;
+}
+function isArktsServerTable(tableName) {
+    return tableName === `mcp_servers.${SERVER_NAME}` || tableName.startsWith(`mcp_servers.${SERVER_NAME}.`);
+}
+function stripExistingArktsServerBlock(existing) {
+    const lines = existing.split(/\r?\n/);
+    const kept = [];
+    let skipping = false;
+    for (const line of lines) {
+        const header = line.match(/^\s*\[([^\]]+)\]\s*$/);
+        if (header) {
+            skipping = isArktsServerTable(header[1]);
+        }
+        if (!skipping) {
+            kept.push(line);
+        }
+    }
+    return kept.join('\n').trimEnd();
+}
+function upsertCodexMcpConfig(existing) {
+    const withoutOldBlock = stripExistingArktsServerBlock(existing);
+    return `${withoutOldBlock ? `${withoutOldBlock}\n\n` : ''}${exports.CODEX_MCP_CONFIG_BLOCK}`;
+}
+function formatTimestamp(date = new Date()) {
+    return date.toISOString().replace(/[-:]/g, '').replace(/\.\d{3}Z$/, 'Z');
+}
+function nextBackupPath(configPath) {
+    const basePath = `${configPath}.bak-${formatTimestamp()}`;
+    let candidate = basePath;
+    let suffix = 1;
+    while (fs.existsSync(candidate)) {
+        candidate = `${basePath}.${suffix}`;
+        suffix += 1;
+    }
+    return candidate;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function cleanupGeneratedBackups(configPath) {
+    const dir = path.dirname(configPath);
+    const basename = path.basename(configPath);
+    const backupPattern = new RegExp(`^${escapeRegExp(basename)}\\.bak-\\d{8}T\\d{6}Z(?:\\.\\d+)?$`);
+    let backups;
+    try {
+        backups = fs.readdirSync(dir).filter((name) => backupPattern.test(name)).sort();
+    }
+    catch {
+        return;
+    }
+    const staleBackups = backups.slice(0, Math.max(0, backups.length - MAX_GENERATED_BACKUPS));
+    for (const backup of staleBackups) {
+        try {
+            fs.unlinkSync(path.join(dir, backup));
+        }
+        catch {
+            // Best-effort cleanup only; installation has already preserved the current config.
+        }
+    }
+}
+function writeFileAtomically(filePath, content) {
+    const tempPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    fs.writeFileSync(tempPath, content, 'utf8');
+    fs.renameSync(tempPath, filePath);
+}
+function installCodexProjectConfig(startDir, dryRun = false) {
+    const installRoot = resolveInstallRoot(startDir);
+    const codexDir = path.join(installRoot, '.codex');
+    const configPath = path.join(installRoot, CONFIG_RELATIVE_PATH);
+    const hadExistingConfig = fs.existsSync(configPath);
+    const existing = hadExistingConfig ? fs.readFileSync(configPath, 'utf8') : '';
+    const content = upsertCodexMcpConfig(existing);
+    const changed = existing !== content;
+    let backupPath;
+    if (!dryRun && changed) {
+        fs.mkdirSync(codexDir, { recursive: true });
+        if (hadExistingConfig) {
+            backupPath = nextBackupPath(configPath);
+            fs.copyFileSync(configPath, backupPath);
+        }
+        writeFileAtomically(configPath, content);
+        cleanupGeneratedBackups(configPath);
+    }
+    return {
+        installRoot,
+        configPath,
+        backupPath,
+        changed,
+        content,
+    };
+}
+function main() {
+    try {
+        const options = parseArgs(process.argv.slice(2));
+        if (options.help) {
+            process.stdout.write(usage());
+            return;
+        }
+        const result = installCodexProjectConfig(options.startDir, options.dryRun);
+        process.stdout.write(`[arkts-lsp] install root: ${result.installRoot}\n`);
+        process.stdout.write(`[arkts-lsp] codex config: ${result.configPath}\n`);
+        if (result.backupPath) {
+            process.stdout.write(`[arkts-lsp] backup: ${result.backupPath}\n`);
+        }
+        if (options.dryRun) {
+            process.stdout.write('\n');
+            process.stdout.write(result.content);
+            return;
+        }
+        process.stdout.write(result.changed
+            ? '[arkts-lsp] installed project-scoped Codex MCP config\n'
+            : '[arkts-lsp] project-scoped Codex MCP config already up to date\n');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`[arkts-lsp] ${message}\n`);
+        process.exit(1);
+    }
+}
+if (require.main === module) {
+    main();
+}
+//# sourceMappingURL=codex-install.js.map

package/dist/codex-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-install.js","sourceRoot":"","sources":["../src/codex-install.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkHA,oDAGC;AAgDD,8DA4BC;AA/LD,4CAA8B;AAC9B,gDAAkC;AAElC,MAAM,WAAW,GAAG,WAAW,CAAC;AAChC,MAAM,oBAAoB,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;AAChE,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEnB,QAAA,sBAAsB,GAAG,gBAAgB,WAAW;;;;eAIlD,WAAW;;CAEzB,CAAC;AAgBF,SAAS,KAAK;IACZ,OAAO;;;;;;;;CAQR,CAAC;AACF,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,OAAO,GAAe;QAC1B,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;QACvB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,KAAK;KACZ,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YACtB,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,gBAAgB,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACjE,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC9C,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACvD,SAAS;QACX,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtE,CAAC;AAED,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,OAAO,SAAS,KAAK,eAAe,WAAW,EAAE,IAAI,SAAS,CAAC,UAAU,CAAC,eAAe,WAAW,GAAG,CAAC,CAAC;AAC3G,CAAC;AAED,SAAS,6BAA6B,CAAC,QAAgB;IACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAClD,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,SAAgB,oBAAoB,CAAC,QAAgB;IACnD,MAAM,eAAe,GAAG,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IAChE,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,eAAe,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,8BAAsB,EAAE,CAAC;AACvF,CAAC;AAED,SAAS,eAAe,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE;IACxC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,cAAc,CAAC,UAAkB;IACxC,MAAM,QAAQ,GAAG,GAAG,UAAU,QAAQ,eAAe,EAAE,EAAE,CAAC;IAC1D,IAAI,SAAS,GAAG,QAAQ,CAAC;IACzB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,SAAS,GAAG,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC;QACpC,MAAM,IAAI,CAAC,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,uBAAuB,CAAC,UAAkB;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC;IACjG,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,qBAAqB,CAAC,CAAC,CAAC;IAC3F,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,mFAAmF;QACrF,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAgB,EAAE,OAAe;IAC5D,MAAM,QAAQ,GAAG,GAAG,QAAQ,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IAChE,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,yBAAyB,CAAC,QAAgB,EAAE,MAAM,GAAG,KAAK;IACxE,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;IAChE,MAAM,iBAAiB,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,QAAQ,KAAK,OAAO,CAAC;IACrC,IAAI,UAA8B,CAAC;IAEnC,IAAI,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;QACvB,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,IAAI,iBAAiB,EAAE,CAAC;YACtB,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;YACxC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAC1C,CAAC;QACD,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACzC,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED,OAAO;QACL,WAAW;QACX,UAAU;QACV,UAAU;QACV,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,IAAI;IACX,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;QAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;QACzE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,CAAC,OAAO;YACZ,CAAC,CAAC,yDAAyD;YAC3D,CAAC,CAAC,kEAAkE,CACvE,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/mcp-server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":""}

package/dist/mcp-server.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_1 = require("./mcp");
+const dispose = (0, mcp_1.startMcpServer)();
+process.on('SIGINT', () => {
+    dispose();
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    dispose();
+    process.exit(0);
+});
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":";;;AAEA,+BAAuC;AAEvC,MAAM,OAAO,GAAG,IAAA,oBAAc,GAAE,CAAC;AAEjC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,EAAE,CAAC;IACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,OAAO,EAAE,CAAC;IACV,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/mcp-tools.d.ts

@@ -0,0 +1,16 @@
+import { type ArktsDiagnosticsRequest, type ArktsRequest } from './arkts-client';
+import type { ArktsMcpService } from './mcp';
+interface ArktsLspClientLike {
+    hover: (request: ArktsRequest) => Promise<unknown>;
+    definition: (request: ArktsRequest) => Promise<unknown>;
+    references: (request: ArktsRequest) => Promise<unknown>;
+    signatureHelp: (request: ArktsRequest) => Promise<unknown>;
+    diagnostics: (request: ArktsDiagnosticsRequest) => Promise<unknown[]>;
+    dispose: () => void;
+}
+interface ServiceOptions {
+    lspClient?: ArktsLspClientLike;
+}
+export declare function createArktsMcpService(options?: ServiceOptions): ArktsMcpService;
+export {};
+//# sourceMappingURL=mcp-tools.d.ts.map

package/dist/mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../src/mcp-tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAuB,KAAK,uBAAuB,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAItG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAE7C,UAAU,kBAAkB;IAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,UAAU,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,UAAU,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,aAAa,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,WAAW,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AAyED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,cAAmB,GAAG,eAAe,CAiEnF"}

package/dist/mcp-tools.js

@@ -0,0 +1,160 @@
+"use strict";
+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.createArktsMcpService = createArktsMcpService;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_url_1 = require("node:url");
+const arkts_client_1 = require("./arkts-client");
+const env_1 = require("./env");
+const project_1 = require("./project");
+const symbols_1 = require("./symbols");
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function getString(args, key) {
+    return typeof args[key] === 'string' && args[key].length > 0 ? args[key] : undefined;
+}
+function getNumber(args, key) {
+    return typeof args[key] === 'number' && Number.isFinite(args[key]) ? args[key] : undefined;
+}
+function uriToFilePath(uri) {
+    return uri.startsWith('file://') ? (0, node_url_1.fileURLToPath)(uri) : uri;
+}
+function resolveRoot(rawRoot, rawStart) {
+    const candidate = rawRoot ?? rawStart ?? process.cwd();
+    const normalized = candidate.startsWith('file://') ? uriToFilePath(candidate) : candidate;
+    const resolved = (0, project_1.findProjectRoot)(path.resolve(normalized));
+    if (!resolved) {
+        throw new Error(`No ArkTS project root found for ${normalized}`);
+    }
+    return resolved;
+}
+function readText(args) {
+    const text = getString(args, 'text');
+    if (text !== undefined) {
+        return text;
+    }
+    const rawFile = getString(args, 'filePath') ?? getString(args, 'uri');
+    if (!rawFile) {
+        throw new Error('Expected either text, filePath, or uri.');
+    }
+    return fs.readFileSync(uriToFilePath(rawFile), 'utf8');
+}
+function normalizePosition(args) {
+    const position = args.position;
+    if (isPlainObject(position)) {
+        const line = getNumber(position, 'line');
+        const character = getNumber(position, 'character');
+        if (line !== undefined && character !== undefined) {
+            return { line, character };
+        }
+    }
+    const line = getNumber(args, 'line');
+    const character = getNumber(args, 'character');
+    if (line === undefined || character === undefined) {
+        throw new Error('Expected position with line and character.');
+    }
+    return { line, character };
+}
+function normalizeLspRequest(args) {
+    const rawFile = getString(args, 'filePath') ?? getString(args, 'uri');
+    if (!rawFile) {
+        throw new Error('Expected filePath or uri.');
+    }
+    return {
+        projectRoot: getString(args, 'projectRoot'),
+        filePath: uriToFilePath(rawFile),
+        position: normalizePosition(args),
+        text: getString(args, 'text'),
+    };
+}
+function createArktsMcpService(options = {}) {
+    const lspClient = options.lspClient ?? new arkts_client_1.ArktsLanguageClient();
+    return {
+        async projectInfo(rawArgs) {
+            const args = isPlainObject(rawArgs) ? rawArgs : {};
+            const projectRoot = resolveRoot(getString(args, 'projectRoot'), getString(args, 'startPath'));
+            const sdkPath = getString(args, 'sdkPath') ?? (0, env_1.findDevEcoEnv)()?.sdkPath;
+            if (!sdkPath) {
+                throw new Error('DevEco Studio not found. Pass sdkPath or set DEVECO_HOME.');
+            }
+            const project = (0, project_1.parseProject)(projectRoot, sdkPath);
+            if (!project) {
+                throw new Error(`Unable to parse ArkTS project at ${projectRoot}`);
+            }
+            return project;
+        },
+        async documentSymbols(rawArgs) {
+            const args = isPlainObject(rawArgs) ? rawArgs : {};
+            return (0, symbols_1.parseDocumentSymbols)(readText(args));
+        },
+        async workspaceSymbols(rawArgs) {
+            const args = isPlainObject(rawArgs) ? rawArgs : {};
+            const query = getString(args, 'query') ?? '';
+            const projectRoot = resolveRoot(getString(args, 'projectRoot'), getString(args, 'startPath'));
+            return (0, symbols_1.parseWorkspaceSymbols)(projectRoot, query, {
+                maxFiles: getNumber(args, 'maxFiles'),
+                maxResults: getNumber(args, 'maxResults'),
+            });
+        },
+        async hover(rawArgs) {
+            return lspClient.hover(normalizeLspRequest(isPlainObject(rawArgs) ? rawArgs : {}));
+        },
+        async definition(rawArgs) {
+            return lspClient.definition(normalizeLspRequest(isPlainObject(rawArgs) ? rawArgs : {}));
+        },
+        async references(rawArgs) {
+            return lspClient.references(normalizeLspRequest(isPlainObject(rawArgs) ? rawArgs : {}));
+        },
+        async signatureHelp(rawArgs) {
+            return lspClient.signatureHelp(normalizeLspRequest(isPlainObject(rawArgs) ? rawArgs : {}));
+        },
+        async diagnostics(rawArgs) {
+            const args = isPlainObject(rawArgs) ? rawArgs : {};
+            const request = normalizeLspRequest(args);
+            return lspClient.diagnostics({
+                projectRoot: request.projectRoot,
+                filePath: request.filePath,
+                text: request.text,
+                timeoutMs: getNumber(args, 'timeoutMs'),
+            });
+        },
+        dispose() {
+            lspClient.dispose();
+        },
+    };
+}
+//# sourceMappingURL=mcp-tools.js.map

package/dist/mcp-tools.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,38 @@
+type JsonRpcId = string | number | null;
+interface JsonRpcRequest {
+    jsonrpc?: string;
+    id?: JsonRpcId;
+    method?: string;
+    params?: unknown;
+}
+interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: JsonRpcId;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface McpTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface ArktsMcpService {
+    projectInfo: (args: unknown) => Promise<unknown>;
+    documentSymbols: (args: unknown) => Promise<unknown>;
+    workspaceSymbols: (args: unknown) => Promise<unknown>;
+    hover: (args: unknown) => Promise<unknown>;
+    definition: (args: unknown) => Promise<unknown>;
+    references: (args: unknown) => Promise<unknown>;
+    signatureHelp: (args: unknown) => Promise<unknown>;
+    diagnostics: (args: unknown) => Promise<unknown>;
+    dispose: () => void;
+}
+export declare const ARKTS_MCP_TOOLS: McpTool[];
+export declare function createMcpHandler(service?: ArktsMcpService): (message: JsonRpcRequest) => Promise<JsonRpcResponse | null>;
+export declare function startMcpServer(input?: NodeJS.ReadableStream, output?: NodeJS.WritableStream, service?: ArktsMcpService): () => void;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAGA,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAExC,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,SAAS,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,eAAe,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,gBAAgB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAqBD,eAAO,MAAM,eAAe,EAAE,OAAO,EA2FpC,CAAC;AA2CF,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,eAAyC,IAC1C,SAAS,cAAc,KAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAsDjG;AAyBD,wBAAgB,cAAc,CAC5B,KAAK,GAAE,MAAM,CAAC,cAA8B,EAC5C,MAAM,GAAE,MAAM,CAAC,cAA+B,EAC9C,OAAO,GAAE,eAAyC,GACjD,MAAM,IAAI,CAyBZ"}

package/dist/mcp.js

@@ -0,0 +1,249 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARKTS_MCP_TOOLS = void 0;
+exports.createMcpHandler = createMcpHandler;
+exports.startMcpServer = startMcpServer;
+const node_readline_1 = require("node:readline");
+const mcp_tools_1 = require("./mcp-tools");
+const POSITION_SCHEMA = {
+    type: 'object',
+    properties: {
+        line: { type: 'number', description: 'Zero-based line number.' },
+        character: { type: 'number', description: 'Zero-based UTF-16 character offset.' },
+    },
+    required: ['line', 'character'],
+};
+const LSP_FILE_PROPERTIES = {
+    projectRoot: { type: 'string', description: 'HarmonyOS project root. If omitted, the server searches from filePath.' },
+    filePath: { type: 'string', description: 'ArkTS/ETS file path.' },
+    uri: { type: 'string', description: 'Optional file:// URI alternative to filePath.' },
+    text: { type: 'string', description: 'Optional in-memory file text. If omitted, the file is read from disk.' },
+    position: POSITION_SCHEMA,
+    line: { type: 'number', description: 'Alternative to position.line.' },
+    character: { type: 'number', description: 'Alternative to position.character.' },
+};
+exports.ARKTS_MCP_TOOLS = [
+    {
+        name: 'arkts_project_info',
+        description: 'Parse a HarmonyOS ArkTS project and return ace-server initialization metadata.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectRoot: { type: 'string', description: 'HarmonyOS project root containing build-profile.json5.' },
+                startPath: { type: 'string', description: 'Path used to search upward/downward for build-profile.json5.' },
+                sdkPath: { type: 'string', description: 'Optional DevEco SDK path override.' },
+            },
+        },
+    },
+    {
+        name: 'arkts_document_symbols',
+        description: 'Parse ArkTS/ArkUI document symbols from text or a file without starting DevEco.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                text: { type: 'string', description: 'ArkTS/ETS source text.' },
+                filePath: { type: 'string', description: 'Source file path.' },
+                uri: { type: 'string', description: 'Source file URI.' },
+            },
+        },
+    },
+    {
+        name: 'arkts_workspace_symbols',
+        description: 'Search lightweight ArkTS/ETS workspace symbols under a HarmonyOS project root.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectRoot: { type: 'string', description: 'HarmonyOS project root.' },
+                startPath: { type: 'string', description: 'Path used to discover the project root.' },
+                query: { type: 'string', description: 'Symbol name substring to search for.' },
+                maxFiles: { type: 'number', description: 'Optional scan file cap.' },
+                maxResults: { type: 'number', description: 'Optional result cap.' },
+            },
+            required: ['query'],
+        },
+    },
+    {
+        name: 'arkts_hover',
+        description: 'Ask DevEco ace-server for ArkTS hover/type information at a file position.',
+        inputSchema: {
+            type: 'object',
+            properties: LSP_FILE_PROPERTIES,
+            required: ['filePath', 'position'],
+        },
+    },
+    {
+        name: 'arkts_definition',
+        description: 'Ask DevEco ace-server for ArkTS definition locations at a file position.',
+        inputSchema: {
+            type: 'object',
+            properties: LSP_FILE_PROPERTIES,
+            required: ['filePath', 'position'],
+        },
+    },
+    {
+        name: 'arkts_references',
+        description: 'Ask DevEco ace-server for ArkTS references at a file position.',
+        inputSchema: {
+            type: 'object',
+            properties: LSP_FILE_PROPERTIES,
+            required: ['filePath', 'position'],
+        },
+    },
+    {
+        name: 'arkts_signature_help',
+        description: 'Ask DevEco ace-server for ArkTS signature help at a file position.',
+        inputSchema: {
+            type: 'object',
+            properties: LSP_FILE_PROPERTIES,
+            required: ['filePath', 'position'],
+        },
+    },
+    {
+        name: 'arkts_diagnostics',
+        description: 'Open an ArkTS file through DevEco ace-server and return published diagnostics.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectRoot: LSP_FILE_PROPERTIES.projectRoot,
+                filePath: LSP_FILE_PROPERTIES.filePath,
+                uri: LSP_FILE_PROPERTIES.uri,
+                text: LSP_FILE_PROPERTIES.text,
+                timeoutMs: { type: 'number', description: 'How long to wait for diagnostics. Default: 1500ms.' },
+            },
+            required: ['filePath'],
+        },
+    },
+];
+function hasId(message) {
+    return Object.prototype.hasOwnProperty.call(message, 'id');
+}
+function result(id, value) {
+    return { jsonrpc: '2.0', id, result: value };
+}
+function error(id, code, message, data) {
+    return {
+        jsonrpc: '2.0',
+        id,
+        error: {
+            code,
+            message,
+            ...(data === undefined ? {} : { data }),
+        },
+    };
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+function formatToolContent(value) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(value, null, 2),
+            },
+        ],
+    };
+}
+function getProtocolVersion(params) {
+    return isPlainObject(params) && typeof params.protocolVersion === 'string'
+        ? params.protocolVersion
+        : '2024-11-05';
+}
+function createMcpHandler(service = (0, mcp_tools_1.createArktsMcpService)()) {
+    return async function handleMcpRequest(message) {
+        if (!message.method) {
+            return hasId(message) ? error(message.id ?? null, -32600, 'Invalid Request') : null;
+        }
+        if (!hasId(message)) {
+            return null;
+        }
+        const id = message.id ?? null;
+        try {
+            if (message.method === 'initialize') {
+                return result(id, {
+                    protocolVersion: getProtocolVersion(message.params),
+                    capabilities: {
+                        tools: {},
+                    },
+                    serverInfo: {
+                        name: 'arkts-lsp-proxy',
+                        version: '0.1.8',
+                    },
+                });
+            }
+            if (message.method === 'tools/list') {
+                return result(id, { tools: exports.ARKTS_MCP_TOOLS });
+            }
+            if (message.method === 'tools/call') {
+                const params = isPlainObject(message.params) ? message.params : {};
+                const name = typeof params.name === 'string' ? params.name : '';
+                const args = params.arguments ?? {};
+                const handler = getToolHandler(service, name);
+                if (!handler) {
+                    return error(id, -32601, `Unknown tool: ${name}`);
+                }
+                const value = await handler(args);
+                return result(id, formatToolContent(value));
+            }
+            return error(id, -32601, `Method not found: ${message.method}`);
+        }
+        catch (err) {
+            return result(id, {
+                content: [
+                    {
+                        type: 'text',
+                        text: err instanceof Error ? err.message : String(err),
+                    },
+                ],
+                isError: true,
+            });
+        }
+    };
+}
+function getToolHandler(service, name) {
+    switch (name) {
+        case 'arkts_project_info':
+            return service.projectInfo;
+        case 'arkts_document_symbols':
+            return service.documentSymbols;
+        case 'arkts_workspace_symbols':
+            return service.workspaceSymbols;
+        case 'arkts_hover':
+            return service.hover;
+        case 'arkts_definition':
+            return service.definition;
+        case 'arkts_references':
+            return service.references;
+        case 'arkts_signature_help':
+            return service.signatureHelp;
+        case 'arkts_diagnostics':
+            return service.diagnostics;
+        default:
+            return null;
+    }
+}
+function startMcpServer(input = process.stdin, output = process.stdout, service = (0, mcp_tools_1.createArktsMcpService)()) {
+    const handler = createMcpHandler(service);
+    const rl = (0, node_readline_1.createInterface)({ input });
+    rl.on('line', (line) => {
+        void (async () => {
+            let response;
+            try {
+                response = await handler(JSON.parse(line));
+            }
+            catch (err) {
+                response = error(null, -32700, 'Parse error', err instanceof Error ? err.message : String(err));
+            }
+            if (response) {
+                output.write(`${JSON.stringify(response)}\n`);
+            }
+        })();
+    });
+    const dispose = () => {
+        rl.close();
+        service.dispose();
+    };
+    rl.on('close', () => service.dispose());
+    return dispose;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

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

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "arkts-lsp-proxy",
-  "version": "0.1.6",
-  "description": "ArkTS LSP Proxy — bridges DevEco Studio's ace-server to Claude Code",
+  "version": "0.1.8",
+  "description": "ArkTS LSP Proxy — bridges DevEco Studio's ace-server to Claude Code and project-scoped Codex MCP",
   "main": "dist/index.js",
   "bin": {
-    "arkts-lsp-proxy": "dist/index.js"
+    "arkts-lsp-proxy": "dist/index.js",
+    "arkts-lsp-mcp": "dist/mcp-server.js",
+    "arkts-lsp-codex-install": "dist/codex-install.js"
   },
   "scripts": {
     "build": "tsc",
@@ -22,13 +24,15 @@
     "lsp",
     "harmonyos",
     "deveco",
-    "claude-code"
+    "claude-code",
+    "codex",
+    "mcp"
   ],
   "author": "",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/HelloiOS2014/harmony_arkts_lsp_proxy.git"
+    "url": "git+https://github.com/HelloiOS2014/harmony_arkts_lsp_proxy.git"
   },
   "engines": {
     "node": ">=18"