rrce-workflow 0.2.81 → 0.2.83

package/agent-core/prompts/documentation.md

@@ -24,6 +24,10 @@ You are the Documentation Lead for the project. Operate like a senior engineerin
 Use the pre-resolved paths from the "System Resolved Paths" table in the context preamble.
 For details, see: `{{RRCE_DATA}}/docs/path-resolution.md`
 
+### Tool Usage Guidance
+- **search_knowledge**: PREFER this tool for finding concepts, logic flow, or documentation. It uses semantic search (RAG) to find relevant code even without exact keyword matches.
+- **grep**: Use ONLY when searching for exact string patterns (e.g., specific function names, error codes).
+
 ## Supported DOC_TYPE Values
 
 | Type | Purpose | Audience |

package/agent-core/prompts/executor.md

@@ -20,6 +20,10 @@ You are the Executor for RRCE-Workflow. You are the **ONLY agent in the pipeline
 Use the pre-resolved paths from the "System Resolved Paths" table in the context preamble.
 For details, see: `{{RRCE_DATA}}/docs/path-resolution.md`
 
+### Tool Usage Guidance
+- **search_knowledge**: PREFER this tool for finding concepts, logic flow, or documentation. It uses semantic search (RAG) to find relevant code even without exact keyword matches.
+- **grep**: Use ONLY when searching for exact string patterns (e.g., specific function names, error codes).
+
 ## Pipeline Position
 - **Requires**: Both Research AND Planning phases must be complete before execution
 - **Input**: Execution plan from `/plan` agent

package/agent-core/prompts/init.md

@@ -19,6 +19,10 @@ You are the Project Initializer for RRCE-Workflow. Your mission: create a compre
 Use the pre-resolved paths from the "System Resolved Paths" table in the context preamble.
 For details, see: `{{RRCE_DATA}}/docs/path-resolution.md`
 
+### Tool Usage Guidance
+- **search_knowledge**: PREFER this tool for finding concepts, logic flow, or documentation. It uses semantic search (RAG) to find relevant code even without exact keyword matches.
+- **grep**: Use ONLY when searching for exact string patterns (e.g., specific function names, error codes).
+
 ## Pipeline Position
 - **Entry Point**: Run before any other agent for new projects
 - **Output**: `{{RRCE_DATA}}/knowledge/project-context.md` + semantic search index

package/agent-core/prompts/planning_discussion.md

@@ -17,6 +17,10 @@ You are the Planning & Task Orchestrator for RRCE-Workflow. Your mission: transf
 Use the pre-resolved paths from the "System Resolved Paths" table in the context preamble.
 For details, see: `{{RRCE_DATA}}/docs/path-resolution.md`
 
+### Tool Usage Guidance
+- **search_knowledge**: PREFER this tool for finding concepts, logic flow, or documentation. It uses semantic search (RAG) to find relevant code even without exact keyword matches.
+- **grep**: Use ONLY when searching for exact string patterns (e.g., specific function names, error codes).
+
 ## Pipeline Position
 - **Requires**: Research phase must be complete before planning can begin
 - **Input**: Research brief from `/research` agent

package/agent-core/prompts/research_discussion.md

@@ -24,6 +24,10 @@ You are the Research & Discussion Lead for RRCE-Workflow. Your mission: achieve
 Use the pre-resolved paths from the "System Resolved Paths" table in the context preamble.
 For details, see: `{{RRCE_DATA}}/docs/path-resolution.md`
 
+### Tool Usage Guidance
+- **search_knowledge**: PREFER this tool for finding concepts, logic flow, or documentation. It uses semantic search (RAG) to find relevant code even without exact keyword matches.
+- **grep**: Use ONLY when searching for exact string patterns (e.g., specific function names, error codes).
+
 ## Pipeline Position
 - **Entry Point**: First agent invoked for new tasks (after optional `/init`)
 - **Output**: Research brief document ready for Planning agent

package/agent-core/prompts/sync.md

@@ -18,6 +18,10 @@ You are the Knowledge Sync Lead. Act like a senior architect charged with keepin
 Use the pre-resolved paths from the "System Resolved Paths" table in the context preamble.
 For details, see: `{{RRCE_DATA}}/docs/path-resolution.md`
 
+### Tool Usage Guidance
+- **search_knowledge**: PREFER this tool for finding concepts, logic flow, or documentation. It uses semantic search (RAG) to find relevant code even without exact keyword matches.
+- **grep**: Use ONLY when searching for exact string patterns (e.g., specific function names, error codes).
+
 Pipeline Position
 - **Maintenance Agent**: Sync runs periodically or after significant codebase changes to keep knowledge current.
 - **Requires**: Init must have been run at least once (project-context.md must exist).

package/dist/index.js

@@ -1997,17 +1997,17 @@ var init_rag = __esm({
         if (_RAGService.activeModelName === this.modelName && _RAGService.loadPromise) {
           return _RAGService.loadPromise;
         }
-        logger.info(`RAG: Initializing model ${this.modelName}...`);
+        logger.info(`[RAG] Initializing model ${this.modelName}...`);
         _RAGService.activeModelName = this.modelName;
         _RAGService.loadPromise = (async () => {
           try {
             const { pipeline } = await import("@xenova/transformers");
             const pipe = await pipeline("feature-extraction", this.modelName);
             _RAGService.pipelineInstance = pipe;
-            logger.info(`RAG: Model ${this.modelName} initialized successfully.`);
+            logger.info(`[RAG] Model ${this.modelName} initialized successfully.`);
             return pipe;
           } catch (error) {
-            logger.error(`RAG: Failed to initialize model ${this.modelName}`, error);
+            logger.error(`[RAG] Failed to initialize model ${this.modelName}`, error);
             _RAGService.pipelineInstance = null;
             _RAGService.activeModelName = null;
             _RAGService.loadPromise = null;
@@ -2025,9 +2025,9 @@ var init_rag = __esm({
           try {
             const data = fs13.readFileSync(this.indexPath, "utf-8");
             this.index = JSON.parse(data);
-            logger.info(`RAG: Loaded index from ${this.indexPath} with ${this.index?.chunks.length} chunks.`);
+            logger.info(`[RAG] Loaded index from ${this.indexPath} with ${this.index?.chunks.length} chunks.`);
           } catch (error) {
-            logger.error(`RAG: Failed to load index from ${this.indexPath}`, error);
+            logger.error(`[RAG] Failed to load index from ${this.indexPath}`, error);
             this.index = {
               version: INDEX_VERSION,
               baseModel: this.modelName,
@@ -2040,7 +2040,7 @@ var init_rag = __esm({
             baseModel: this.modelName,
             chunks: []
           };
-          logger.info(`RAG: Created new empty index at ${this.indexPath}`);
+          logger.info(`[RAG] Created new empty index at ${this.indexPath}`);
         }
       }
       /**
@@ -2054,9 +2054,9 @@ var init_rag = __esm({
             fs13.mkdirSync(dir, { recursive: true });
           }
           fs13.writeFileSync(this.indexPath, JSON.stringify(this.index, null, 2));
-          logger.info(`RAG: Saved index to ${this.indexPath} with ${this.index.chunks.length} chunks.`);
+          logger.info(`[RAG] Saved index to ${this.indexPath} with ${this.index.chunks.length} chunks.`);
         } catch (error) {
-          logger.error(`RAG: Failed to save index to ${this.indexPath}`, error);
+          logger.error(`[RAG] Failed to save index to ${this.indexPath}`, error);
         }
       }
       /**
@@ -2068,7 +2068,7 @@ var init_rag = __esm({
           const output = await pipe(text2, { pooling: "mean", normalize: true });
           return Array.from(output.data);
         } catch (error) {
-          logger.error("RAG: Error generating embedding", error);
+          logger.error("[RAG] Error generating embedding", error);
           throw error;
         }
       }
@@ -2088,11 +2088,11 @@ var init_rag = __esm({
         if (mtime !== void 0 && this.index.fileMetadata[filePath]) {
           const existingMeta = this.index.fileMetadata[filePath];
           if (existingMeta.mtime === mtime) {
-            logger.debug(`RAG: Skipping unchanged file ${filePath}`);
+            logger.debug(`[RAG] Skipping unchanged file ${filePath}`);
             return false;
           }
         }
-        logger.info(`RAG: Indexing file ${filePath}`);
+        logger.info(`[RAG] Indexing file ${filePath}`);
         this.index.chunks = this.index.chunks.filter((c) => c.filePath !== filePath);
         const chunks = this.chunkContent(content);
         for (const chunkText of chunks) {
@@ -2124,7 +2124,7 @@ var init_rag = __esm({
           delete this.index.fileMetadata[filePath];
         }
         if (this.index.chunks.length !== initialCount) {
-          logger.info(`RAG: Removed file ${filePath} from index (${initialCount - this.index.chunks.length} chunks removed)`);
+          logger.info(`[RAG] Removed file ${filePath} from index (${initialCount - this.index.chunks.length} chunks removed)`);
           this.saveIndex();
         }
       }
@@ -2156,10 +2156,10 @@ var init_rag = __esm({
       async search(query, limit = 5) {
         this.loadIndex();
         if (!this.index || this.index.chunks.length === 0) {
-          logger.warn("RAG: Search called on empty index");
+          logger.warn("[RAG] Search called on empty index");
           return [];
         }
-        logger.info(`RAG: Searching for "${query}" (limit: ${limit})`);
+        logger.info(`[RAG] Searching for "${query}" (limit: ${limit})`);
         const queryEmbedding = await this.generateEmbedding(query);
         const results = this.index.chunks.map((chunk) => {
           const score = this.cosineSimilarity(queryEmbedding, chunk.embedding);
@@ -2167,7 +2167,7 @@ var init_rag = __esm({
         });
         results.sort((a, b) => b.score - a.score);
         const topResults = results.slice(0, limit);
-        logger.info(`RAG: Search returned ${topResults.length} matches. Top score: ${topResults[0]?.score.toFixed(4)}`);
+        logger.info(`[RAG] Search returned ${topResults.length} matches. Top score: ${topResults[0]?.score.toFixed(4)}`);
         return topResults;
       }
       /**
@@ -2260,7 +2260,7 @@ function getExposedProjects() {
       }
     }
   }
-  return potentialProjects.filter((project) => isProjectExposed(config, project.name, project.path));
+  return potentialProjects.filter((project) => isProjectExposed(config, project.name, project.sourcePath || project.path));
 }
 function getRAGIndexPath(project) {
   const scanRoot = project.path || project.dataPath;
@@ -2272,18 +2272,18 @@ function detectActiveProject(knownProjects) {
     const config = loadMCPConfig();
     const knownPaths = config.projects.map((p) => p.path).filter((p) => !!p);
     const all = projectService.scan({ knownPaths });
-    scanList = all.filter((project) => isProjectExposed(config, project.name, project.path));
+    scanList = all.filter((project) => isProjectExposed(config, project.name, project.sourcePath || project.path));
   }
   return findClosestProject(scanList);
 }
 function getProjectContext(projectName) {
   const config = loadMCPConfig();
   const projects = projectService.scan();
-  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.path));
+  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.sourcePath || p.path));
   if (!project) {
     return null;
   }
-  const permissions = getProjectPermissions(config, projectName, project.path);
+  const permissions = getProjectPermissions(config, projectName, project.sourcePath || project.path);
   if (!permissions.knowledge) {
     return null;
   }
@@ -2299,11 +2299,11 @@ function getProjectContext(projectName) {
 function getProjectTasks(projectName) {
   const config = loadMCPConfig();
   const projects = projectService.scan();
-  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.path));
+  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.sourcePath || p.path));
   if (!project) {
     return [];
   }
-  const permissions = getProjectPermissions(config, projectName, project.path);
+  const permissions = getProjectPermissions(config, projectName, project.sourcePath || project.path);
   if (!permissions.tasks) {
     return [];
   }
@@ -2335,13 +2335,14 @@ async function searchKnowledge(query, projectFilter) {
   const queryLower = query.toLowerCase();
   for (const project of projects) {
     if (projectFilter && project.name !== projectFilter) continue;
-    const permissions = getProjectPermissions(config, project.name, project.path);
+    const permissions = getProjectPermissions(config, project.name, project.sourcePath || project.path);
     if (!permissions.knowledge || !project.knowledgePath) continue;
     const projConfig = config.projects.find(
-      (p) => p.path && normalizeProjectPath(p.path) === normalizeProjectPath(project.path) || !p.path && p.name === project.name
+      (p) => p.path && normalizeProjectPath(p.path) === normalizeProjectPath(project.sourcePath || project.path) || !p.path && p.name === project.name
     );
     const useRAG = projConfig?.semanticSearch?.enabled;
     if (useRAG) {
+      logger.info(`[RAG] Using semantic search for project '${project.name}'`);
       try {
         const indexPath = path16.join(project.knowledgePath, "embeddings.json");
         const rag = new RAGService(indexPath, projConfig?.semanticSearch?.model);
@@ -2355,9 +2356,10 @@ async function searchKnowledge(query, projectFilter) {
             score: r.score
           });
         }
+        continue;
       } catch (e) {
+        logger.error(`[RAG] Semantic search failed for project '${project.name}', falling back to text search`, e);
       }
-      continue;
     }
     try {
       const files = fs14.readdirSync(project.knowledgePath);
@@ -2394,7 +2396,7 @@ async function indexKnowledge(projectName, force = false) {
     return { success: false, message: `Project '${projectName}' not found`, filesIndexed: 0, filesSkipped: 0 };
   }
   const projConfig = config.projects.find(
-    (p) => p.path && normalizeProjectPath(p.path) === normalizeProjectPath(project.path) || !p.path && p.name === project.name
+    (p) => p.path && normalizeProjectPath(p.path) === normalizeProjectPath(project.sourcePath || project.path) || !p.path && p.name === project.name
   ) || (project.source === "global" ? { semanticSearch: { enabled: true, model: "Xenova/all-MiniLM-L6-v2" } } : void 0);
   const isEnabled = projConfig?.semanticSearch?.enabled || project.semanticSearchEnabled;
   if (!isEnabled) {
@@ -2540,7 +2542,7 @@ All file operations should be relative to WORKSPACE_ROOT shown above.
 function getTask(projectName, taskSlug) {
   const config = loadMCPConfig();
   const projects = projectService.scan();
-  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.path));
+  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.sourcePath || p.path));
   if (!project || !project.tasksPath) return null;
   const metaPath = path16.join(project.tasksPath, taskSlug, "meta.json");
   if (!fs14.existsSync(metaPath)) return null;
@@ -2553,7 +2555,7 @@ function getTask(projectName, taskSlug) {
 async function createTask(projectName, taskSlug, taskData) {
   const config = loadMCPConfig();
   const projects = projectService.scan();
-  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.path));
+  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.sourcePath || p.path));
   if (!project || !project.tasksPath) {
     throw new Error(`Project '${projectName}' not found or not configured with a tasks path.`);
   }
@@ -2608,7 +2610,7 @@ async function updateTask(projectName, taskSlug, taskData) {
   };
   const config = loadMCPConfig();
   const projects = projectService.scan();
-  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.path));
+  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.sourcePath || p.path));
   if (!project || !project.tasksPath) return null;
   const metaPath = path16.join(project.tasksPath, taskSlug, "meta.json");
   fs14.writeFileSync(metaPath, JSON.stringify(updatedMeta, null, 2));
@@ -2617,7 +2619,7 @@ async function updateTask(projectName, taskSlug, taskData) {
 function deleteTask(projectName, taskSlug) {
   const config = loadMCPConfig();
   const projects = projectService.scan();
-  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.path));
+  const project = projects.find((p) => p.name === projectName && isProjectExposed(config, p.name, p.sourcePath || p.path));
   if (!project || !project.tasksPath) return false;
   const taskDir = path16.join(project.tasksPath, taskSlug);
   if (!fs14.existsSync(taskDir)) return false;
@@ -3805,6 +3807,7 @@ var init_LogViewer = __esm({
       const emptyLines = Math.max(0, height - visibleLogs.length);
       const padding = Array(emptyLines).fill("");
       const formatLog = (log) => {
+        if (log.includes("[RAG]")) return /* @__PURE__ */ jsx7(Text7, { color: "cyan", children: log });
         if (log.includes("[ERROR]")) return /* @__PURE__ */ jsx7(Text7, { color: "red", children: log });
         if (log.includes("[WARN]")) return /* @__PURE__ */ jsx7(Text7, { color: "yellow", children: log });
         if (log.includes("[INFO]")) return /* @__PURE__ */ jsx7(Text7, { color: "green", children: log });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rrce-workflow",
-  "version": "0.2.81",
+  "version": "0.2.83",
   "description": "RRCE-Workflow TUI - Agentic code workflow generator for AI-assisted development",
   "author": "RRCE Team",
   "license": "MIT",