opencode-rag-plugin 1.19.3 → 1.19.4

package/dist/api.d.ts

@@ -4,7 +4,7 @@
  */
 import { type IndexRunStats } from "./indexer.js";
 import { type WorkspaceFile } from "./content/reader.js";
-import type { SearchResult } from "./core/interfaces.js";
+import { type SearchResult } from "./core/interfaces.js";
 /** Options controlling a semantic search query. */
 export interface SearchOptions {
     /** Working directory to resolve relative paths against. */

package/dist/api.js

@@ -7,6 +7,7 @@ import { retrieve } from "./retriever/retriever.js";
 import { optimizeContext, DEFAULT_CONTEXT_OPTIMIZATION } from "./retriever/context-optimizer.js";
 import { runIndexPass } from "./indexer.js";
 import { scanWorkspaceFiles } from "./content/reader.js";
+import { CODE_SEARCH_FILTER } from "./core/interfaces.js";
 import { destroyAllPooledConnections } from "./embedder/http.js";
 /**
  * Format a list of search results into a human-readable markdown block.
@@ -55,6 +56,7 @@ export async function search(query, options = {}) {
             filter: {
                 pathPatterns: options.pathHints,
                 languages: options.languageHints,
+                kinds: CODE_SEARCH_FILTER.kinds,
             },
         });
         const optCfg = ctx.config.retrieval.contextOptimization ?? DEFAULT_CONTEXT_OPTIMIZATION;

package/dist/cli/commands/query.js

@@ -6,6 +6,7 @@
  */
 import path from "node:path";
 import pc from "picocolors";
+import { CODE_SEARCH_FILTER } from "../../core/interfaces.js";
 import { retrieve } from "../../retriever/retriever.js";
 import { c, resolveCliContext, cleanupContext, logCliError, logCliInfo, formatDuration } from "../format.js";
 import { optimizeContext, DEFAULT_CONTEXT_OPTIMIZATION } from "../../retriever/context-optimizer.js";
@@ -54,6 +55,7 @@ export function registerQueryCommand(program) {
                 hybridEnabled: hybridCfg?.enabled,
                 queryPrefix: config.embedding.queryPrefix,
                 explain: options.explain ?? false,
+                filter: CODE_SEARCH_FILTER,
             });
             const optCfg = config.retrieval.contextOptimization ?? DEFAULT_CONTEXT_OPTIMIZATION;
             const results = optimizeContext(rawResults, { topK, config: optCfg });

package/dist/content/reader.js

@@ -56,17 +56,17 @@ export async function walkFiles(dir, extensions, excludeDirs, excludeFiles, root
     return results;
 }
 async function dispatchExtraction(filePath, buffer, imageVisionProvider, imagePrompt, resizeMaxDimension) {
-    const lower = filePath.toLowerCase();
-    if (pdfExtractor.PDF_EXTENSIONS.has(lower)) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (pdfExtractor.PDF_EXTENSIONS.has(ext)) {
         return pdfExtractor.extract(filePath, buffer);
     }
-    if (docxExtractor.DOCX_EXTENSIONS.has(lower)) {
+    if (docxExtractor.DOCX_EXTENSIONS.has(ext)) {
         return docxExtractor.extract(filePath, buffer);
     }
-    if (docExtractor.DOC_EXTENSIONS.has(lower)) {
+    if (docExtractor.DOC_EXTENSIONS.has(ext)) {
         return docExtractor.extract(filePath, buffer);
     }
-    if (excelExtractor.EXCEL_EXTENSIONS.has(lower)) {
+    if (excelExtractor.EXCEL_EXTENSIONS.has(ext)) {
         return excelExtractor.extract(filePath, buffer);
     }
     if (imageVisionProvider && imageExtractor.isImageFile(filePath)) {
@@ -164,10 +164,11 @@ export async function scanWorkspaceFiles(cwd, config, logger, manifest, filterPa
             }
         }
         const isImage = imageVisionProvider !== null && imageExtractor.isImageFile(filePath);
-        const isBinary = pdfExtractor.PDF_EXTENSIONS.has(filePath.toLowerCase()) ||
-            docxExtractor.DOCX_EXTENSIONS.has(filePath.toLowerCase()) ||
-            docExtractor.DOC_EXTENSIONS.has(filePath.toLowerCase()) ||
-            excelExtractor.EXCEL_EXTENSIONS.has(filePath.toLowerCase()) ||
+        const ext = path.extname(filePath).toLowerCase();
+        const isBinary = pdfExtractor.PDF_EXTENSIONS.has(ext) ||
+            docxExtractor.DOCX_EXTENSIONS.has(ext) ||
+            docExtractor.DOC_EXTENSIONS.has(ext) ||
+            excelExtractor.EXCEL_EXTENSIONS.has(ext) ||
             isImage;
         logger?.info(`Reading: ${filePath}`);
         const buffer = isBinary ? await fs.readFile(filePath) : Buffer.alloc(0);

package/dist/core/interfaces.d.ts

@@ -201,6 +201,14 @@ export interface MetadataFilter {
     /** Synthetic kind filters (e.g. ["quirk"]). */
     kinds?: string[];
 }
+/**
+ * Filter for general code/document retrieval that excludes quirk memory
+ * chunks. Regular indexed chunks store `kind: ""`, quirk chunks `kind: "quirk"`.
+ * All code-search paths (search_semantic, hotkey injection, CLI query, web UI,
+ * read-tool context) must pass this so quirks never surface as code results —
+ * quirks are only reachable through recall_quirks / the quirk CLI.
+ */
+export declare const CODE_SEARCH_FILTER: MetadataFilter;
 /** Callback interface for reporting indexing progress to the UI or CLI. */
 export interface IndexProgress {
     /** Set the total number of files to be indexed. */

package/dist/core/interfaces.js

@@ -2,5 +2,12 @@
  * @fileoverview Core type definitions for the OpenCodeRAG pipeline: Chunk, SearchResult,
  * Chunker, EmbeddingProvider, VectorStore, KeywordIndex, and related interfaces.
  */
-export {};
+/**
+ * Filter for general code/document retrieval that excludes quirk memory
+ * chunks. Regular indexed chunks store `kind: ""`, quirk chunks `kind: "quirk"`.
+ * All code-search paths (search_semantic, hotkey injection, CLI query, web UI,
+ * read-tool context) must pass this so quirks never surface as code results —
+ * quirks are only reachable through recall_quirks / the quirk CLI.
+ */
+export const CODE_SEARCH_FILTER = { kinds: [""] };
 //# sourceMappingURL=interfaces.js.map

package/dist/mcp/handlers.d.ts

@@ -1,7 +1,7 @@
 /**
  * @fileoverview Handler implementations for all MCP tools: semantic search, file skeleton, symbol usage lookup, and image description.
  */
-import type { EmbeddingProvider, VectorStore, KeywordIndex, SearchResult } from "../core/interfaces.js";
+import { type EmbeddingProvider, type VectorStore, type KeywordIndex, type SearchResult } from "../core/interfaces.js";
 import type { RagConfig } from "../core/config.js";
 import { type ImageVisionProvider } from "../chunker/image.js";
 import { retrieve } from "../retriever/retriever.js";

package/dist/mcp/handlers.js

@@ -1,3 +1,7 @@
+/**
+ * @fileoverview Handler implementations for all MCP tools: semantic search, file skeleton, symbol usage lookup, and image description.
+ */
+import { CODE_SEARCH_FILTER } from "../core/interfaces.js";
 import { SUPPORTED_IMAGE_EXTENSIONS } from "../chunker/image.js";
 import { retrieve } from "../retriever/retriever.js";
 import { optimizeContext, DEFAULT_CONTEXT_OPTIMIZATION } from "../retriever/context-optimizer.js";
@@ -178,6 +182,7 @@ export async function handleSearchSemantic(params, embedder, store, cfg, keyword
         keywordWeight: cfg.retrieval.hybridSearch?.keywordWeight,
         hybridEnabled: cfg.retrieval.hybridSearch?.enabled,
         queryPrefix: cfg.embedding.queryPrefix,
+        filter: CODE_SEARCH_FILTER,
     };
     const rawResults = await retrieveFn_(query, embedder, store, retrieveOpts);
     if (rawResults.length === 0) {
@@ -256,7 +261,7 @@ export async function handleFindUsages(params, embedder, store, cfg, keywordInde
     const symbolName = params.symbolName.trim();
     const topK = params.topK ?? 30;
     const kwResults = keywordIndex
-        ? keywordIndex.search(symbolName, topK)
+        ? keywordIndex.search(symbolName, topK, CODE_SEARCH_FILTER)
         : [];
     const count = await store.count();
     const vsResults = count > 0
@@ -265,6 +270,7 @@ export async function handleFindUsages(params, embedder, store, cfg, keywordInde
             minScore: 0,
             keywordIndex: undefined,
             queryPrefix: cfg.embedding.queryPrefix,
+            filter: CODE_SEARCH_FILTER,
         })
         : [];
     const seen = new Set();

package/dist/opencode/create-read-tool.d.ts

@@ -2,7 +2,7 @@
  * @fileoverview Creates the RAG-backed read tool that returns full file contents with supplementary semantic context.
  */
 import { tool } from "@opencode-ai/plugin/tool";
-import type { EmbeddingProvider, KeywordIndex, VectorStore, SearchResult } from "../core/interfaces.js";
+import { type EmbeddingProvider, type KeywordIndex, type VectorStore, type SearchResult } from "../core/interfaces.js";
 import type { RagConfig } from "../core/config.js";
 export interface RagReadToolOptions {
     /** Workspace root directory. */

package/dist/opencode/create-read-tool.js

@@ -3,6 +3,7 @@
  */
 import fs from "node:fs/promises";
 import { tool } from "@opencode-ai/plugin/tool";
+import { CODE_SEARCH_FILTER } from "../core/interfaces.js";
 import { retrieve } from "../retriever/retriever.js";
 import { normalizeReadArgs, resolveWorkspacePath } from "./tool-args.js";
 import { buildReadQuery } from "./read-query.js";
@@ -63,7 +64,7 @@ export function createRagReadTool(options) {
                             }
                             else {
                                 const retrievalQuery = buildSessionQuery(messageText, resolvedPath, normalized);
-                                rawResults = await retrieve(retrievalQuery, embedder, store, { topK: retrievalTopK, keywordIndex, hybridEnabled: config.retrieval.hybridSearch?.enabled, queryPrefix: config.embedding.queryPrefix });
+                                rawResults = await retrieve(retrievalQuery, embedder, store, { topK: retrievalTopK, keywordIndex, hybridEnabled: config.retrieval.hybridSearch?.enabled, queryPrefix: config.embedding.queryPrefix, filter: CODE_SEARCH_FILTER });
                                 const maxSize = options.maxSessionCacheSize ?? 50;
                                 if (!sessionRetrievalCache.has(sessionID) && sessionRetrievalCache.size >= maxSize) {
                                     const oldest = sessionRetrievalCache.keys().next().value;
@@ -80,7 +81,7 @@ export function createRagReadTool(options) {
                                 startLine: normalized.startLine,
                                 endLine: normalized.endLine,
                             });
-                            rawResults = await retrieve(retrievalQuery, embedder, store, { topK: retrievalTopK, keywordIndex, hybridEnabled: config.retrieval.hybridSearch?.enabled, queryPrefix: config.embedding.queryPrefix });
+                            rawResults = await retrieve(retrievalQuery, embedder, store, { topK: retrievalTopK, keywordIndex, hybridEnabled: config.retrieval.hybridSearch?.enabled, queryPrefix: config.embedding.queryPrefix, filter: CODE_SEARCH_FILTER });
                         }
                         // Collect related files from raw results (before filtering)
                         relatedFiles = collectRelatedFiles(rawResults, resolvedPath, readRelatedFilesMax);

package/dist/opencode/tools.d.ts

@@ -2,7 +2,7 @@
  * @fileoverview Factory functions for OpenCode autonomous-agent tools (file skeleton, find usages, describe image).
  */
 import type { ToolDefinition } from "@opencode-ai/plugin";
-import type { EmbeddingProvider, VectorStore, KeywordIndex } from "../core/interfaces.js";
+import { type EmbeddingProvider, type VectorStore, type KeywordIndex } from "../core/interfaces.js";
 import type { RagConfig } from "../core/config.js";
 import { type ImageVisionProvider } from "../chunker/image.js";
 import { retrieve } from "../retriever/retriever.js";

package/dist/opencode/tools.js

@@ -13,6 +13,7 @@
  * These complement the general-purpose search_semantic tool.
  */
 import { tool } from "@opencode-ai/plugin/tool";
+import { CODE_SEARCH_FILTER } from "../core/interfaces.js";
 import { SUPPORTED_IMAGE_EXTENSIONS, createImageVisionProvider, getMimeType } from "../chunker/image.js";
 import { resizeImage } from "../content/image.js";
 import { retrieve } from "../retriever/retriever.js";
@@ -362,7 +363,7 @@ export function createFindUsagesTool(options) {
     async function searchViaKeywordIndex(symbol, topK) {
         if (!keywordIndex)
             return [];
-        return keywordIndex.search(symbol, topK);
+        return keywordIndex.search(symbol, topK, CODE_SEARCH_FILTER);
     }
     async function searchViaVectorStore(symbol, topK) {
         const count = await store.count();
@@ -373,6 +374,7 @@ export function createFindUsagesTool(options) {
             minScore: 0,
             keywordIndex: undefined,
             queryPrefix: cfg.embedding.queryPrefix,
+            filter: CODE_SEARCH_FILTER,
         });
     }
     function escapeRegex(s) {

package/dist/plugin.d.ts

@@ -4,7 +4,7 @@
  * automatic context injection and documentation mode.
  */
 import type { Plugin, Hooks } from "@opencode-ai/plugin";
-import type { EmbeddingProvider, DescriptionProvider, KeywordIndex, VectorStore } from "./core/interfaces.js";
+import { type EmbeddingProvider, type DescriptionProvider, type KeywordIndex, type VectorStore } from "./core/interfaces.js";
 import { type RagConfig } from "./core/config.js";
 import { createEmbedder } from "./embedder/factory.js";
 import { retrieve } from "./retriever/retriever.js";

package/dist/plugin.js

@@ -4,6 +4,7 @@
  * automatic context injection and documentation mode.
  */
 import { tool } from "@opencode-ai/plugin/tool";
+import { CODE_SEARCH_FILTER } from "./core/interfaces.js";
 import { loadConfig, findConfigFile, DEFAULT_CONFIG, resolveLogConfig, persistProbedDimension } from "./core/config.js";
 import { createEmbedder } from "./embedder/factory.js";
 import { createDescriptionProvider } from "./describer/factory.js";
@@ -1189,6 +1190,8 @@ export function createRagHooks(options) {
                         keywordIndex,
                         keywordWeight: hybridCfg?.keywordWeight,
                         queryPrefix: effectiveCfg.embedding.queryPrefix,
+                        // Never surface quirk chunks in hotkey file lists / chunk injections.
+                        filter: CODE_SEARCH_FILTER,
                     });
                     const retrievalTimeMs = Date.now() - retrievalStart;
                     if (results.length > 0) {

package/dist/web/api.d.ts

@@ -5,7 +5,7 @@ import type { IncomingMessage, ServerResponse } from "node:http";
 import { LanceDbStore } from "../vectorstore/lancedb.js";
 import { KeywordIndex } from "../retriever/keyword-index.js";
 import type { RagConfig } from "../core/config.js";
-import type { EmbeddingProvider } from "../core/interfaces.js";
+import { type EmbeddingProvider } from "../core/interfaces.js";
 /** Internal shape for a JSON API response: an HTTP status code and a serialisable body. */
 interface ApiResponse {
     status: number;

package/dist/web/api.js

@@ -5,6 +5,7 @@ import { listSessions, getSession, deleteSession, compareSessions, validateSessi
 import { analyzeTokenUsage, compareTokenAnalyses, projectTokenSavings } from "../eval/token-analysis.js";
 import { listQuirks, lintQuirks, removeQuirk } from "../quirks/quirk-store.js";
 import { retrieve } from "../retriever/retriever.js";
+import { CODE_SEARCH_FILTER } from "../core/interfaces.js";
 const FILE_MIME_TYPES = {
     ".png": "image/png",
     ".jpg": "image/jpeg",
@@ -297,7 +298,7 @@ async function handleSearch(keywordIndex, params) {
     if (!query.trim()) {
         return { status: 200, body: { results: [] } };
     }
-    const results = keywordIndex.search(query, topK);
+    const results = keywordIndex.search(query, topK, CODE_SEARCH_FILTER);
     return {
         status: 200,
         body: {
@@ -355,6 +356,7 @@ async function handleRetrieve(store, keywordIndex, getEmbedder, cfg, params) {
             filter: {
                 pathPatterns: pathFilter ? pathFilter.split(",").map((s) => s.trim()).filter(Boolean) : undefined,
                 languages: langFilter ? langFilter.split(",").map((s) => s.trim()).filter(Boolean) : undefined,
+                kinds: CODE_SEARCH_FILTER.kinds,
             },
         });
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-rag-plugin",
-  "version": "1.19.3",
+  "version": "1.19.4",
   "description": "OpenCode plugin for local-first RAG-based semantic code search",
   "type": "module",
   "main": "./dist/plugin-entry.js",