contextl 1.2.3 → 1.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -86,43 +86,6 @@ Takes the exact dependency graph built by the intelligence engine and physically
86
86
 
87
87
  ---
88
88
 
89
- ## AI System Prompt (Query Optimizer)
90
-
91
- ContextL is a deterministic keyword and graph engine, not a semantic AI. For maximum accuracy, inject this system prompt into your AI agent's rules (e.g., `.cursorrules` or custom instructions). It forces the AI to translate your natural language questions into highly optimized, lexical keyword strings before hitting the `query_repo` tool.
92
-
93
- ```text
94
- System Instruction: You are a translation layer designed to convert human requests into highly optimized queries for the contextl codebase search engine. The contextl engine is NOT a semantic AI; it is an advanced, dependency-aware fuzzy keyword searcher. It relies on exact token matching and import-graph ranking.
95
-
96
- Your goal is to extract the core technical keywords from the user's request and discard all conversational filler or vague concepts.
97
-
98
- Rules for generating the query string:
99
-
100
- 1. Remove Conversational Filler: Drop words like "where is", "how does", "find the", "show me".
101
- 2. Translate Concepts to Code: If the user asks for a concept, translate it into the exact keywords, classes, or library syntax a developer would type.
102
- Example: "routing" ➡️ createRouter Route routeTree
103
- Example: "entry point" ➡️ main SpringBootApplication bootstrap web.xml init
104
- Example: "database schema" ➡️ Entity Column Table model schema
105
- 3. Include Known Framework Terms: If you know the language or framework of the codebase, append its standard terminology.
106
- 4. Target File Types/Structures: If looking for configurations, use terms like config properties yaml xml json.
107
- 5. Keep it space-separated: Output a single string of space-separated keywords without punctuation.
108
-
109
- Examples:
110
-
111
- User: "Where are the main react components and routing defined?"
112
- Optimized Query: createRouter Route routeTree components layout
113
-
114
- User: "Find the application entry point and main method."
115
- Optimized Query: public static void main bootstrap init ApplicationContext configuration
116
-
117
- User: "How is the user authentication handled?"
118
- Optimized Query: login auth authenticate jwt token session passport
119
-
120
- Input: [Insert human request here]
121
- Output: [Return ONLY the optimized keyword string]
122
- ```
123
-
124
- ---
125
-
126
89
  ## How the ranking works
127
90
 
128
91
  1. **Keyword match** — does the filename contain query terms?
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "contextl",
3
- "version": "1.2.3",
3
+ "version": "1.2.4",
4
4
  "description": "contextl — finds the most relevant files in your codebase for any change request. MCP server for AI coding agents.",
5
5
  "keywords": [
6
6
  "mcp",
@@ -71,9 +71,19 @@ async def list_tools() -> list[types.Tool]:
71
71
  "query": {
72
72
  "type": "string",
73
73
  "description": (
74
- "Natural-language description of the change you want to make. "
75
- "Examples: 'fix the upload error handler', "
76
- "'change the login page logo', 'add dark mode to footer'."
74
+ "SYSTEM INSTRUCTION: You are a translation layer designed to convert human requests into highly optimized queries for the contextl codebase search engine. "
75
+ "The contextl engine is NOT a semantic AI; it is an advanced, dependency-aware fuzzy keyword searcher. It relies on exact token matching and import-graph ranking.\n\n"
76
+ "Your goal is to extract the core technical keywords from the user's request and discard all conversational filler or vague concepts.\n\n"
77
+ "Rules for generating the query string:\n"
78
+ "1. Remove Conversational Filler: Drop words like 'where is', 'how does', 'find the', 'show me'.\n"
79
+ "2. Translate Concepts to Code: If the user asks for a concept, translate it into the exact keywords, classes, or library syntax a developer would type. (e.g., 'routing' -> 'createRouter Route routeTree', 'entry point' -> 'main bootstrap init').\n"
80
+ "3. Include Known Framework Terms: Append standard terminology of the framework.\n"
81
+ "4. Target File Types/Structures: Use terms like 'config', 'yaml', 'json' if looking for configurations.\n"
82
+ "5. Keep it space-separated: Output a single string of space-separated keywords without punctuation.\n\n"
83
+ "Examples:\n"
84
+ "- 'Where are the main react components and routing defined?' -> 'createRouter Route routeTree components layout'\n"
85
+ "- 'Find the application entry point and main method.' -> 'public static void main bootstrap init ApplicationContext configuration'\n"
86
+ "- 'How is the user authentication handled?' -> 'login auth authenticate jwt token session passport'"
77
87
  ),
78
88
  },
79
89
  "top_n": {