sp-rag 0.6.11 → 0.6.12

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.7`
+- version đang publish: `0.6.12`
 - binary public: `sp-rag`
 
 ## Cài từ source trong monorepo
@@ -36,8 +36,10 @@ node dist/index.js doctor
 npx sp-rag@latest install --client codex --mcp-token <grc_pat_...> --doctor
 npx sp-rag@latest install --client cursor --scope project --cwd D:/Webs/seo-booster --mcp-token <grc_pat_...>
 npx sp-rag@latest install --client vscode --scope project --cwd D:/Webs/seo-booster --mcp-token <grc_pat_...>
-npx sp-rag@latest add --client claude-code --scope project --cwd D:/Webs/seo-booster
-npx sp-rag@latest explain --client vscode --scope project --cwd D:/Webs/seo-booster
+npx sp-rag@latest add --client claude-code --scope project --cwd D:/Webs/seo-booster
+npx sp-rag@latest update --client claude-code --scope project --cwd D:/Webs/seo-booster
+npx sp-rag@latest uninstall --client claude-code --scope project --cwd D:/Webs/seo-booster
+npx sp-rag@latest explain --client vscode --scope project --cwd D:/Webs/seo-booster
 npx sp-rag@latest token add --token <grc_pat_...>
 npx sp-rag@latest token verify --token <grc_pat_...>
 npx sp-rag@latest mcp add antigravity
@@ -50,8 +52,10 @@ Tương đương bằng `npm`:
 
 ```bash
 npm exec --yes sp-rag@latest install -- --client codex --mcp-token <grc_pat_...> --doctor
-npm exec --yes sp-rag@latest add -- --client claude-code --scope project --cwd D:/Webs/seo-booster
-npm exec --yes sp-rag@latest explain -- --client vscode --scope project --cwd D:/Webs/seo-booster
+npm exec --yes sp-rag@latest add -- --client claude-code --scope project --cwd D:/Webs/seo-booster
+npm exec --yes sp-rag@latest update -- --client claude-code --scope project --cwd D:/Webs/seo-booster
+npm exec --yes sp-rag@latest uninstall -- --client claude-code --scope project --cwd D:/Webs/seo-booster
+npm exec --yes sp-rag@latest explain -- --client vscode --scope project --cwd D:/Webs/seo-booster
 npm exec --yes sp-rag@latest token add -- --token <grc_pat_...>
 npm exec --yes sp-rag@latest token verify -- --token <grc_pat_...>
 ```
@@ -61,24 +65,29 @@ npm exec --yes sp-rag@latest token verify -- --token <grc_pat_...>
 Flow khuyên dùng sau khi đã có `grc_pat_*`:
 
 1. chạy `install` đúng một lần cho client đầu tiên, có kèm `--mcp-token`
-2. từ lần sau, dùng `add --client ...` để cài thêm MCP + skill cho client khác mà không phải nhập lại token
-3. khi chỉ muốn làm một nửa, dùng `mcp add` hoặc `skill install`
-4. khi đổi token, chỉ cần `token add`
-5. khi muốn kiểm tra máy đang được cấu hình ra sao, dùng `explain`
+2. từ lần sau, dùng `add --client ...` để cài thêm MCP + skill cho client khác mà không phải nhập lại token
+3. khi muốn cập nhật lại MCP + skill mà giữ token cũ, dùng `update`
+4. khi muốn gỡ sạch MCP + skill + config CLI do `sp-rag` tạo, dùng `uninstall`
+5. khi chỉ muốn làm một nửa, dùng `mcp add` hoặc `skill install`
+6. khi đổi token, chỉ cần `token add`
+7. khi muốn kiểm tra máy đang được cấu hình ra sao, dùng `explain`
 
 Ghi chú:
 
-- với `cursor` và `vscode` ở `scope project`, nếu Sếpp đang đứng sẵn trong repo thì có thể bỏ `--cwd`
-- CLI sẽ tự dùng thư mục hiện tại cho cả MCP lẫn skill
-- rule/agent mới đã được tăng độ ưu tiên MCP-first, giảm khả năng model nhảy thẳng sang grep/read file local
+- với `cursor` và `vscode` ở `scope project`, nếu Sếpp đang đứng sẵn trong repo thì có thể bỏ `--cwd`
+- CLI sẽ tự dùng thư mục hiện tại cho cả MCP lẫn skill
+- `update` sẽ tự tính lại target project từ `--cwd` hoặc thư mục hiện tại, không dùng target cũ lệch project nếu user không truyền `--target-dir`
+- rule/agent mới đã được tăng độ ưu tiên MCP-first, giảm khả năng model nhảy thẳng sang grep/read file local
 - skill mới cũng dặn model tổng hợp từ `matched_passages`, `top_entities`, `top_relations`, `citations`; không bê nguyên `answer_brief`
 
 Ví dụ:
 
 ```bash
-sp-rag install --client vscode --scope project --cwd D:/Webs/seo-booster --mcp-token <grc_pat_...> --doctor
-sp-rag add --client cursor --scope project --cwd D:/Webs/seo-booster
-sp-rag mcp add antigravity
+sp-rag install --client vscode --scope project --cwd D:/Webs/seo-booster --mcp-token <grc_pat_...> --doctor
+sp-rag add --client cursor --scope project --cwd D:/Webs/seo-booster
+sp-rag update --client vscode --scope project --cwd D:/Webs/seo-booster
+sp-rag uninstall --client claude-code --scope project --cwd D:/Webs/seo-booster
+sp-rag mcp add antigravity
 sp-rag skill install --client vscode --scope project --cwd D:/Webs/seo-booster
 sp-rag token add --token <grc_pat_moi>
 sp-rag explain --client vscode --scope project --cwd D:/Webs/seo-booster
@@ -186,7 +195,8 @@ Ghi chú:
 ### Skill / rule / custom agent
 
 - `codex`: `~/.codex/skills/sp-rag/SKILL.md`
-- `claude-code`: `~/.claude/skills/sp-rag/SKILL.md`
+- `claude-code` project: `.claude/skills/sp-rag/SKILL.md`
+- `claude-code` global skill-only override: `~/.claude/skills/sp-rag/SKILL.md`
 - `antigravity`: `~/.gemini/antigravity/skills/sp-rag/SKILL.md`
 - `opencode`: `~/.config/opencode/skills/sp-rag/SKILL.md`
 - `cursor` project: `.cursor/rules/sp-rag.mdc`
@@ -197,8 +207,10 @@ Ghi chú:
 
 ```bash
 sp-rag install --client codex --mcp-token <grc_pat_...> --doctor
-sp-rag add --client cursor --scope project --cwd D:/Webs/seo-booster
-sp-rag explain --client codex
+sp-rag add --client cursor --scope project --cwd D:/Webs/seo-booster
+sp-rag update --client cursor --scope project --cwd D:/Webs/seo-booster
+sp-rag uninstall --client cursor --scope project --cwd D:/Webs/seo-booster
+sp-rag explain --client codex
 sp-rag token add --token <grc_pat_...>
 sp-rag token verify --token <grc_pat_...>
 sp-rag config show
@@ -212,8 +224,10 @@ sp-rag mcp add vscode --scope project --cwd D:/Webs/seo-booster
 sp-rag mcp add opencode --scope project --cwd D:/Webs/seo-booster
 sp-rag skill install --client codex
 sp-rag skill install --client cursor --scope project --cwd D:/Webs/seo-booster
-sp-rag skill install --client vscode --scope project --cwd D:/Webs/seo-booster
-sp-rag eval run --file ./examples/eval-suite.sample.json
+sp-rag skill install --client vscode --scope project --cwd D:/Webs/seo-booster
+sp-rag eval run --file ./examples/eval-suite.sample.json
+sp-rag update --client vscode --scope project --cwd D:/Webs/seo-booster
+sp-rag uninstall --client vscode --scope project --cwd D:/Webs/seo-booster
 ```
 
 ## Lệnh chính
@@ -240,8 +254,10 @@ sp-rag mcp add opencode --scope project --cwd D:/Webs/seo-booster
 sp-rag skill install --client codex
 sp-rag skill install --client cursor --scope project --cwd D:/Webs/seo-booster
 sp-rag skill install --client vscode --scope project --cwd D:/Webs/seo-booster
-sp-rag eval run --file ./examples/eval-suite.sample.json
-sp-rag update setup --client codex
+sp-rag eval run --file ./examples/eval-suite.sample.json
+sp-rag update --client codex
+sp-rag update setup --client codex
+sp-rag uninstall --client codex
 ```
 
 ## `doctor` kiểm gì

package/dist/cli.js

@@ -1,10 +1,10 @@
 import { readFile } from 'node:fs/promises';
-import { loadCliConfig, saveCliConfig, } from './lib/config-store.js';
+import { clearCliConfig, loadCliConfig, saveCliConfig, } from './lib/config-store.js';
 import { runEvaluationSuite } from './lib/eval.js';
-import { defaultBaseUrl, defaultMcpServerAlias, defaultMcpUrl, installMcpConfig, resolveMcpConfigPath, } from './lib/mcp-config.js';
+import { defaultBaseUrl, defaultMcpServerAlias, defaultMcpUrl, installMcpConfig, removeMcpConfig, resolveMcpConfigPath, } from './lib/mcp-config.js';
 import { diagnoseMcpConfig, formatMcpDoctorResult } from './lib/doctor.js';
 import { fetchJson, fetchText, runDoctor } from './lib/http.js';
-import { installSkill, resolveSkillInstallTarget, } from './lib/skill.js';
+import { installSkill, removeSkill, resolveSkillInstallTarget, } from './lib/skill.js';
 let cliVersionPromise;
 async function resolveCliVersion() {
     if (!cliVersionPromise) {
@@ -205,9 +205,11 @@ function helpText() {
     return `sp-rag - CLI cho setup, MCP, codegraph, eval và skill của SP-RAG
 
 Lệnh chính:
-  sp-rag install --client codex|cursor|claude-code|antigravity|vscode|opencode [--base-url URL] [--mcp-url URL] [--scope global|project] [--mcp-token TOKEN] [--auth-env-var ENV_VAR] [--target-dir PATH] [--doctor]
-  sp-rag add --client codex|cursor|claude-code|antigravity|vscode|opencode [--scope global|project] [--cwd PATH] [--target-dir PATH]
-  sp-rag init [--base-url URL] [--mcp-url URL] [--client codex|cursor|claude-code|antigravity|vscode|opencode] [--skill-client codex|cursor|claude-code|antigravity|vscode|opencode] [--scope global|project] [--auth-env-var ENV_VAR] [--target-dir PATH]
+  sp-rag install --client codex|cursor|claude-code|antigravity|vscode|opencode [--base-url URL] [--mcp-url URL] [--scope global|project] [--mcp-token TOKEN] [--auth-env-var ENV_VAR] [--target-dir PATH] [--doctor]
+  sp-rag add --client codex|cursor|claude-code|antigravity|vscode|opencode [--scope global|project] [--cwd PATH] [--target-dir PATH]
+  sp-rag update [--client codex|cursor|claude-code|antigravity|vscode|opencode] [--scope global|project] [--cwd PATH] [--target-dir PATH] [--doctor]
+  sp-rag uninstall [--client codex|cursor|claude-code|antigravity|vscode|opencode] [--scope global|project] [--cwd PATH] [--target-dir PATH]
+  sp-rag init [--base-url URL] [--mcp-url URL] [--client codex|cursor|claude-code|antigravity|vscode|opencode] [--skill-client codex|cursor|claude-code|antigravity|vscode|opencode] [--scope global|project] [--auth-env-var ENV_VAR] [--target-dir PATH]
   sp-rag token add --token TOKEN
   sp-rag token verify [--token TOKEN] [--base-url URL]
   sp-rag config show
@@ -597,6 +599,50 @@ async function runUpdateSetup(parsed) {
         await runSkillInstall(parsed, defaults, client);
     }
 }
+async function runUpdate(parsed) {
+    const defaults = await loadRuntimeDefaults(parsed);
+    const client = resolveSelectedClient(parsed, defaults);
+    if (!client) {
+        throw new Error('Thiếu client. Dùng sp-rag update --client <client>.');
+    }
+    await runClientSetup(parsed, defaults, client);
+}
+async function runUninstall(parsed) {
+    const defaults = await loadRuntimeDefaults(parsed);
+    const client = resolveSelectedClient(parsed, defaults);
+    if (!client) {
+        throw new Error('Thiếu client. Dùng sp-rag uninstall --client <client>.');
+    }
+    const scope = supportedScope(optionString(parsed, 'scope')) ?? defaults.defaultScope;
+    const mcpResult = await removeMcpConfig({
+        client,
+        url: optionString(parsed, 'url') ?? defaults.mcpUrl,
+        scope,
+        cwd: optionString(parsed, 'cwd'),
+        serverAlias: optionString(parsed, 'server-alias') ?? defaults.serverAlias,
+    });
+    process.stdout.write(`${mcpResult.removed ? 'Đã gỡ' : 'Không tìm thấy'} cấu hình MCP cho ${mcpResult.client} tại ${mcpResult.path} (${mcpResult.scope}).\n`);
+    const skillClient = resolveSelectedSkillClient(parsed, defaults, client);
+    if (skillClient) {
+        const skillResult = await removeSkill({
+            client: skillClient,
+            cwd: optionString(parsed, 'cwd'),
+            scope,
+            targetDir: optionString(parsed, 'target-dir'),
+            serverAlias: optionString(parsed, 'server-alias') ?? defaults.serverAlias,
+            mcpUrl: optionString(parsed, 'mcp-url') ?? defaults.mcpUrl,
+            docsUrl: optionString(parsed, 'docs-url') ?? defaults.docsUrl,
+        });
+        for (const removedPath of skillResult.removedPaths) {
+            process.stdout.write(`Đã gỡ skill cho ${skillResult.client} tại ${removedPath}\n`);
+        }
+        if (skillResult.removedPaths.length === 0) {
+            process.stdout.write(`Không tìm thấy skill cần gỡ cho ${skillResult.client}.\n`);
+        }
+    }
+    const configPath = await clearCliConfig(defaults.homeDir);
+    process.stdout.write(`Đã xóa config CLI tại ${configPath}\n`);
+}
 export async function runCli(argv) {
     const parsed = parseArgv(argv);
     const [group, action] = parsed.positionals;
@@ -695,8 +741,17 @@ export async function runCli(argv) {
         if (group === 'eval' && action === 'run') {
             return runEval(parsed);
         }
-        if (group === 'update' && action === 'setup') {
-            await runUpdateSetup(parsed);
+        if (group === 'update' && (!action || action === 'setup')) {
+            if (action === 'setup') {
+                await runUpdateSetup(parsed);
+            }
+            else {
+                await runUpdate(parsed);
+            }
+            return 0;
+        }
+        if (group === 'uninstall') {
+            await runUninstall(parsed);
             return 0;
         }
         if (group === 'version') {

package/dist/lib/config-store.js

@@ -1,6 +1,6 @@
 import os from 'node:os';
 import path from 'node:path';
-import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
 function stripUndefined(value) {
     return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
 }
@@ -37,3 +37,8 @@ export async function saveCliConfig(config, homeDir) {
     await writeFile(filePath, `${JSON.stringify(normalized, null, 2)}\n`, 'utf8');
     return filePath;
 }
+export async function clearCliConfig(homeDir) {
+    const filePath = resolveCliConfigPath(homeDir);
+    await rm(filePath, { force: true });
+    return filePath;
+}

package/dist/lib/mcp-config.js

@@ -85,6 +85,30 @@ function upsertObjectEntryPreservingAliasByEndpoint(base, sectionKey, entryKey,
         [sectionKey]: section,
     };
 }
+function removeObjectEntryByAliasOrEndpoint(base, sectionKey, entryKey, endpointKey, endpointValue) {
+    const section = base[sectionKey] && typeof base[sectionKey] === 'object'
+        ? { ...base[sectionKey] }
+        : {};
+    const targetEndpoint = normalizeEndpoint(endpointValue);
+    let removed = false;
+    for (const [alias, value] of Object.entries(section)) {
+        if (!value || typeof value !== 'object') {
+            continue;
+        }
+        const candidateEndpoint = normalizeEndpoint(value[endpointKey]);
+        if (alias === entryKey || (targetEndpoint && candidateEndpoint === targetEndpoint)) {
+            delete section[alias];
+            removed = true;
+        }
+    }
+    return {
+        next: {
+            ...base,
+            [sectionKey]: section,
+        },
+        removed,
+    };
+}
 function vscodeGlobalConfigPath(home) {
     if (process.platform === 'win32') {
         const appData = process.env['APPDATA']?.trim() || path.join(home, 'AppData', 'Roaming');
@@ -122,6 +146,23 @@ export function upsertCodexConfig(existing, options) {
     }
     return `${cleaned ? `${cleaned}\n\n` : ''}${lines.join('\n')}\n`;
 }
+export function removeCodexConfigContent(existing, serverAlias) {
+    const alias = serverAlias.trim();
+    const aliasPattern = escapeRegex(alias);
+    let removed = false;
+    const withoutHeaders = existing.replace(new RegExp(`(?:^|\\n)\\[mcp_servers\\.(?:"${aliasPattern}"|${aliasPattern})\\.headers\\][\\s\\S]*?(?=(?:\\n\\[[^\\n]+\\])|$)`, 'g'), () => {
+        removed = true;
+        return '';
+    });
+    const cleaned = withoutHeaders.replace(new RegExp(`(?:^|\\n)\\[mcp_servers\\.(?:"${aliasPattern}"|${aliasPattern})\\][\\s\\S]*?(?=(?:\\n\\[[^\\n]+\\])|$)`, 'g'), () => {
+        removed = true;
+        return '';
+    });
+    return {
+        content: `${cleaned.trimEnd()}${cleaned.trimEnd() ? '\n' : ''}`,
+        removed,
+    };
+}
 export function upsertJsonMcpConfig(existing, options) {
     const base = parseJsonObject(existing);
     const serverConfig = withHeaders({
@@ -279,3 +320,58 @@ export async function installMcpConfig(options) {
     await writeFile(resolved.path, content, 'utf8');
     return resolved;
 }
+export async function removeMcpConfig(options) {
+    const resolved = resolveMcpConfigPath(options);
+    const existing = await readFile(resolved.path, 'utf8').catch((error) => {
+        if (error.code === 'ENOENT') {
+            return '';
+        }
+        throw error;
+    });
+    const alias = options.serverAlias?.trim() || defaultMcpServerAlias();
+    const url = options.url.trim();
+    let content = existing;
+    let removed = false;
+    if (existing.trim()) {
+        switch (resolved.client) {
+            case 'codex': {
+                const result = removeCodexConfigContent(existing, alias);
+                content = result.content;
+                removed = result.removed;
+                break;
+            }
+            case 'cursor':
+            case 'claude-code': {
+                const result = removeObjectEntryByAliasOrEndpoint(parseJsonObject(existing), 'mcpServers', alias, 'url', url);
+                content = `${JSON.stringify(result.next, null, 2)}\n`;
+                removed = result.removed;
+                break;
+            }
+            case 'antigravity': {
+                const result = removeObjectEntryByAliasOrEndpoint(parseJsonObject(existing), 'mcpServers', alias, 'serverUrl', url);
+                content = `${JSON.stringify(result.next, null, 2)}\n`;
+                removed = result.removed;
+                break;
+            }
+            case 'vscode': {
+                const result = removeObjectEntryByAliasOrEndpoint(parseJsonObject(existing), 'servers', alias, 'url', url);
+                content = `${JSON.stringify(result.next, null, 2)}\n`;
+                removed = result.removed;
+                break;
+            }
+            case 'opencode': {
+                const result = removeObjectEntryByAliasOrEndpoint(parseJsonObject(existing), 'mcp', alias, 'url', url);
+                content = `${JSON.stringify(result.next, null, 2)}\n`;
+                removed = result.removed;
+                break;
+            }
+        }
+    }
+    if (removed) {
+        await writeFile(resolved.path, content, 'utf8');
+    }
+    return {
+        ...resolved,
+        removed,
+    };
+}

package/dist/lib/skill.js

@@ -1,6 +1,6 @@
 import os from 'node:os';
 import path from 'node:path';
-import { mkdir, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
 const seoBoosterRemoteUrl = 'https://gitlab.com/secomapp/development/seo-booster.git';
 const seoBoosterProjectGuard = [
     '- SP-RAG chỉ dành cho repo seo-booster.',
@@ -260,6 +260,41 @@ export async function installSkill(options = {}) {
         paths,
     };
 }
+async function removeIfSpRagArtifact(filePath) {
+    const content = await readFile(filePath, 'utf8').catch((error) => {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    });
+    if (content === null) {
+        return false;
+    }
+    if (!content.includes('SP-RAG') && !content.includes('sp-rag')) {
+        return false;
+    }
+    await rm(filePath, { force: true });
+    return true;
+}
+export async function removeSkill(options = {}) {
+    const resolved = resolveSkillInstallTarget(options);
+    const context = createSkillContext(options, resolved.client);
+    const paths = [
+        resolved.path,
+        ...resolveAdditionalSkillArtifacts(options, resolved, context).map((entry) => entry.path),
+    ];
+    const removedPaths = [];
+    for (const filePath of paths) {
+        if (await removeIfSpRagArtifact(filePath)) {
+            removedPaths.push(filePath);
+        }
+    }
+    return {
+        client: resolved.client,
+        paths,
+        removedPaths,
+    };
+}
 export async function installCodexSkill(options = {}) {
     return installSkill({
         ...options,

package/package.json

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