sp-rag 0.6.3 → 0.6.5

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.3`
+- version đang publish: `0.6.5`
 - binary public: `sp-rag`
 
 ## Cài từ source trong monorepo
@@ -66,6 +66,12 @@ Flow khuyên dùng sau khi đã có `grc_pat_*`:
 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`
 
+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í dụ:
 
 ```bash

package/dist/cli.js

@@ -4,7 +4,7 @@ import { runEvaluationSuite } from './lib/eval.js';
 import { defaultBaseUrl, defaultMcpServerAlias, defaultMcpUrl, installMcpConfig, resolveMcpConfigPath, } from './lib/mcp-config.js';
 import { fetchJson, fetchText, runDoctor } from './lib/http.js';
 import { installSkill, resolveSkillInstallTarget, } from './lib/skill.js';
-const cliVersion = '0.6.3';
+const cliVersion = '0.6.5';
 function parseArgv(argv) {
     const positionals = [];
     const options = {};

package/dist/lib/skill.js

@@ -31,10 +31,11 @@ function normalizeScope(client, scope) {
     }
 }
 function requireProjectCwd(client, cwd) {
-    if (!cwd?.trim()) {
+    const resolvedCwd = cwd?.trim() ? cwd : process.cwd();
+    if (!resolvedCwd.trim()) {
         throw new Error(`${client} cần --cwd hoặc --target-dir để cài skill theo project.`);
     }
-    return path.resolve(cwd);
+    return path.resolve(resolvedCwd);
 }
 export function defaultSkillDir(client = 'codex', cwd, scope) {
     const normalizedScope = normalizeScope(client, scope);
@@ -61,7 +62,7 @@ export function defaultSkillDir(client = 'codex', cwd, scope) {
 function renderSkillMarkdown(context) {
     return `---
 name: sp-rag
-description: Use SP-RAG whenever the user asks about this codebase, internal business domain, rendered docs, import inventory, or codegraph sync status. Prefer MCP-backed evidence before answering from memory.
+description: Use SP-RAG whenever the user asks about this codebase, internal business domain, rendered docs, import inventory, or codegraph sync status. You must call SP-RAG MCP tools first before answering from memory or reading local files.
 ---
 
 # SP-RAG
@@ -87,27 +88,30 @@ Docs URL: \`${context.docsUrl}\`
 
 ## Guardrails
 
+- You must call SP-RAG MCP tools first for codebase or domain questions before using local workspace search, grep, or file reads.
 - Prefer MCP-grounded answers before relying on memory.
 - If the evidence may be stale, say so clearly and mention that the graph or docs may need a refresh.
 - Do not trigger sync or import actions unless the user asked for it or the workflow truly requires it.
 - When rendered docs already answer the question, cite or summarize those docs instead of rewriting everything from scratch.
+- Only fall back to local workspace search or file reads after MCP is unavailable or clearly lacks the needed evidence, and say that you are falling back.
 `;
 }
 function renderCursorRule(context) {
     return `---
 description: Use SP-RAG when the request is about this codebase, internal business workflows, rendered docs, import inventory, or codegraph sync status.
 globs:
-alwaysApply: false
+alwaysApply: true
 ---
 
 # SP-RAG
 
-- Prefer the \`${context.serverAlias}\` MCP server at \`${context.mcpUrl}\` before answering from memory.
+- You must call the \`${context.serverAlias}\` MCP server first before using local workspace search, grep, or file reads for codebase and domain questions.
 - Use rendered docs from \`${context.docsUrl}\` when documentation already answers the question.
 - For architecture, domain, entities, relations, and business workflow questions, query MCP first and only then synthesize the answer.
 - For freshness or operational questions, check sync status, recent runs, and metrics before assuming the graph is current.
 - Only trigger codegraph sync when the user explicitly asks for it or stale evidence is the confirmed blocker.
 - If the evidence may be stale, say so clearly.
+- Only fall back to local workspace search after MCP is unavailable or clearly lacks the needed evidence, and say that you are falling back.
 `;
 }
 function renderVsCodeAgent(context) {
@@ -121,6 +125,8 @@ You are the SP-RAG custom agent for this workspace.
 
 Use the \`${context.serverAlias}\` MCP server at \`${context.mcpUrl}\` and the rendered docs URL \`${context.docsUrl}\` as your grounded source of truth.
 
+You must call an SP-RAG MCP tool before using local workspace search, grep, or file reads for codebase and domain questions.
+
 ## Recommended Workflow
 
 1. Start with \`healthz\` if connectivity or freshness is uncertain.
@@ -132,9 +138,11 @@ Use the \`${context.serverAlias}\` MCP server at \`${context.mcpUrl}\` and the r
 ## Guardrails
 
 - Prefer MCP-grounded evidence before answering from memory.
+- Do not use local workspace search, grep, or file reads until SP-RAG MCP has been tried first for the current question.
 - When evidence may be stale, say so clearly and mention that a refresh might be needed.
 - Do not trigger sync or import actions unless the workflow truly requires it.
 - When rendered docs already answer the question, summarize those docs instead of rewriting everything from scratch.
+- Only fall back to local workspace search or file reads after MCP is unavailable or clearly lacks the needed evidence, and say that you are falling back.
 `;
 }
 function renderSkillArtifact(context) {

package/package.json

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