sp-rag 0.6.0 → 0.6.1

package/README.md

@@ -17,7 +17,7 @@ CLI để setup nhanh SP-RAG theo hướng dev-friendly:
 ## Trạng thái package
 
 - package npm public: `sp-rag`
-- version đang publish: `0.6.0`
+- version đang publish: `0.6.1`
 - binary public: `sp-rag`
 
 ## Cài từ source trong monorepo
@@ -69,6 +69,7 @@ Luồng chuẩn:
 - quyền nhìn thấy tool/resource trên MCP bám theo role của account đó
 - `viewer`, `operator`, `approver`, `admin` sẽ thấy inventory khác nhau
 - `MCP_SERVER_ACCESS_TOKENS_JSON` chỉ còn là fallback legacy/break-glass, không còn là luồng chính cho dev
+- khi client đã có sẵn một alias trỏ cùng MCP endpoint, CLI sẽ ưu tiên cập nhật alias đó thay vì tạo alias mới song song
 
 Tự tạo PAT bằng API hiện có:
 

package/dist/cli.js

@@ -511,7 +511,7 @@ export async function runCli(argv) {
             return 0;
         }
         if (group === 'version') {
-            process.stdout.write('sp-rag 0.6.0\n');
+            process.stdout.write('sp-rag 0.6.1\n');
             return 0;
         }
         process.stdout.write(helpText());

package/dist/lib/mcp-config.js

@@ -19,6 +19,13 @@ function withHeaders(target, headers) {
         headers,
     };
 }
+function normalizeEndpoint(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed ? trimmed.replace(/\/+$/, '') : null;
+}
 function bearerHeader(authToken, authEnvVar, envStyle = 'shell') {
     const trimmedToken = authToken?.trim();
     if (trimmedToken) {
@@ -55,6 +62,29 @@ function upsertObjectEntry(base, sectionKey, entryKey, entryValue) {
         [sectionKey]: section,
     };
 }
+function upsertObjectEntryPreservingAliasByEndpoint(base, sectionKey, entryKey, entryValue, endpointKey) {
+    const section = base[sectionKey] && typeof base[sectionKey] === 'object'
+        ? { ...base[sectionKey] }
+        : {};
+    const targetEndpoint = normalizeEndpoint(entryValue[endpointKey]);
+    const existingAlias = targetEndpoint
+        ? Object.entries(section).find(([alias, value]) => {
+            if (alias === entryKey || !value || typeof value !== 'object') {
+                return false;
+            }
+            return normalizeEndpoint(value[endpointKey]) === targetEndpoint;
+        })?.[0]
+        : undefined;
+    const aliasToWrite = existingAlias ?? entryKey;
+    section[aliasToWrite] = entryValue;
+    if (existingAlias && existingAlias !== entryKey && entryKey in section) {
+        delete section[entryKey];
+    }
+    return {
+        ...base,
+        [sectionKey]: section,
+    };
+}
 function vscodeGlobalConfigPath(home) {
     if (process.platform === 'win32') {
         const appData = process.env['APPDATA']?.trim() || path.join(home, 'AppData', 'Roaming');
@@ -98,14 +128,14 @@ export function upsertJsonMcpConfig(existing, options) {
         ...(options.includeTypeHttp ? { type: 'http' } : {}),
         url: options.url,
     }, bearerHeader(options.authToken, options.authEnvVar, 'shell'));
-    return `${JSON.stringify(upsertObjectEntry(base, 'mcpServers', options.serverAlias, serverConfig), null, 2)}\n`;
+    return `${JSON.stringify(upsertObjectEntryPreservingAliasByEndpoint(base, 'mcpServers', options.serverAlias, serverConfig, 'url'), null, 2)}\n`;
 }
 export function upsertAntigravityConfig(existing, options) {
     const base = parseJsonObject(existing);
     const serverConfig = withHeaders({
         serverUrl: options.url,
     }, bearerHeader(options.authToken, options.authEnvVar, 'shell'));
-    return `${JSON.stringify(upsertObjectEntry(base, 'mcpServers', options.serverAlias, serverConfig), null, 2)}\n`;
+    return `${JSON.stringify(upsertObjectEntryPreservingAliasByEndpoint(base, 'mcpServers', options.serverAlias, serverConfig, 'serverUrl'), null, 2)}\n`;
 }
 export function upsertVsCodeConfig(existing, options) {
     const base = parseJsonObject(existing);
@@ -113,7 +143,7 @@ export function upsertVsCodeConfig(existing, options) {
         type: 'http',
         url: options.url,
     }, bearerHeader(options.authToken, options.authEnvVar, 'vscode'));
-    return `${JSON.stringify(upsertObjectEntry(base, 'servers', options.serverAlias, serverConfig), null, 2)}\n`;
+    return `${JSON.stringify(upsertObjectEntryPreservingAliasByEndpoint(base, 'servers', options.serverAlias, serverConfig, 'url'), null, 2)}\n`;
 }
 export function upsertOpenCodeConfig(existing, options) {
     const base = parseJsonObject(existing);
@@ -130,7 +160,7 @@ export function upsertOpenCodeConfig(existing, options) {
         enabled: true,
         ...(headers ? { oauth: false } : {}),
     }, headers);
-    return `${JSON.stringify(upsertObjectEntry(nextBase, 'mcp', options.serverAlias, serverConfig), null, 2)}\n`;
+    return `${JSON.stringify(upsertObjectEntryPreservingAliasByEndpoint(nextBase, 'mcp', options.serverAlias, serverConfig, 'url'), null, 2)}\n`;
 }
 export function resolveMcpConfigPath(options) {
     const inferredScope = options.client === 'codex' || options.client === 'antigravity'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sp-rag",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "CLI cho setup MCP, codegraph GitNexus và skill của SP-RAG",
   "type": "module",
   "files": [