REAMDE.md updated

Author: wpak-ai

README.md

@@ -244,7 +244,7 @@ Suggests which **fields** to request and which tool to use (`count`, `query_fast
 | Parameter    | Type   | Required | Description                                                                                     |
 | ------------ | ------ | -------- | ----------------------------------------------------------------------------------------------- |
 | `namespace`  | string | Yes      | Namespace to query (must match a name from `list_namespaces`)                                   |
-| `user_query` | string | Yes      | User’s question or intent (e.g. "list papers by Lakos with titles", "how many papers by Wong?") |
+| `user_query` | string | Yes      | User’s question or intent (e.g. "list papers by John Doe with titles", "how many papers by Wong?") |
 
 **Returns:** `suggested_fields` (only fields that exist in that namespace), `use_count_tool`, `recommended_tool`, `explanation`, and `namespace_found`.
 
@@ -314,15 +314,15 @@ Rules:
 
 ### `count`
 
-Returns the **unique document count** matching a metadata filter and semantic query. Use for questions like "how many papers by Lakos?" instead of the `query` tool. For performance, the count tool uses **semantic (dense) search only** (no hybrid or lexical) and requests only document identifiers (`document_number`, `url`, `doc_id`)—no chunk content—then deduplicates by document.
+Returns the **unique document count** matching a metadata filter and semantic query. Use for questions like "how many papers by John Doe?" instead of the `query` tool. For performance, the count tool uses **semantic (dense) search only** (no hybrid or lexical) and requests only document identifiers (`document_number`, `url`, `doc_id`)—no chunk content—then deduplicates by document.
 
 **Parameters:**
 
 | Parameter         | Type   | Required | Description                                                                                  |
 | ----------------- | ------ | -------- | -------------------------------------------------------------------------------------------- |
 | `namespace`       | string | Yes      | Namespace to count in (use `list_namespaces` to discover)                                    |
 | `query_text`      | string | Yes      | Search query; use a broad term (e.g. `"paper"`, `"document"`) when counting by metadata only |
-| `metadata_filter` | object | No       | Same operators as `query` (e.g. `{"author": {"$in": ["John Lakos"]}}` for wg21-papers)       |
+| `metadata_filter` | object | No       | Same operators as `query` (e.g. `{"author": {"$in": ["John Doe"]}}` for wg21-papers)       |
 
 **Returns:** JSON with `count` (unique documents, up to 10,000), and `truncated: true` if there are at least 10,000 matches.
 
@@ -334,7 +334,7 @@ Returns the **unique document count** matching a metadata filter and semantic qu
   "count": 42,
   "truncated": false,
   "namespace": "wg21-papers",
-  "metadata_filter": { "author": { "$in": ["John Lakos"] } }
+  "metadata_filter": { "author": { "$in": ["John Doe"] } }
 }
 ```
 
@@ -402,7 +402,7 @@ Metadata filters allow you to narrow down search results based on document prope
 {"status": "published"}
 
 // Exact string match - NOTE: requires full exact match
-{"author": "John Lakos"}  // Only matches if author field is exactly "John Lakos"
+{"author": "John Doe"}  // Only matches if author field is exactly "John Doe"
 
 // Array field contains value (use $in only for array-type fields)
 {"tags": {"$in": ["cpp", "contracts"]}}  // Only if tags is stored as an array
@@ -431,8 +431,8 @@ Metadata filters allow you to narrow down search results based on document prope
 **Important Limitations:**
 
 - **String fields require EXACT match** - No wildcards, partial matches, or substring searches
-- **Comma-separated strings**: If a field contains `"John Lakos, Herb Sutter"`, you cannot filter for just `"John Lakos"`
-  - You must match the entire string: `{"author": "John Lakos, Herb Sutter"}`
+- **Comma-separated strings**: If a field contains `"John Doe, Herb Sutter"`, you cannot filter for just `"John Doe"`
+  - You must match the entire string: `{"author": "John Doe, Herb Sutter"}`
   - To filter by individual authors, the data must be stored as an array field
 - **`$in` and `$nin` operators**: Only work on array-type fields, not comma-separated strings
 - **Unsupported operators are rejected**: Unknown operators (for example `$regex`) return a validation error

src/server.test.ts

@@ -12,7 +12,7 @@ describe('suggestQueryParams', () => {
   };
 
   it('suggests count tool and minimal fields for count-style queries', () => {
-    const r = suggestQueryParams(wg21Fields, 'How many papers by Lakos?');
+    const r = suggestQueryParams(wg21Fields, 'How many papers by John Doe?');
     expect(r.use_count_tool).toBe(true);
     expect(r.suggested_fields).toContain('document_number');
     expect(r.suggested_fields).toContain('url');

src/server/tools/count-tool.ts

@@ -24,7 +24,7 @@ export function registerCountTool(server: McpServer): void {
     {
       description:
         'Get the number of unique documents matching a metadata filter and semantic query. ' +
-        'Use when the user asks for a count (e.g. "how many papers by J. Lakos?", "John\'s paper count"). ' +
+        'Use when the user asks for a count (e.g. "how many papers by J. John Doe?", "John\'s paper count"). ' +
         'Uses semantic (dense) search only and requests only document identifiers (no content) for performance. ' +
         'Returns the number of unique documents (deduped by document_number/url/doc_id) up to 10,000; truncated=true if at least that many. ' +
         'Mandatory flow: call suggest_query_params first, then count. ' +
@@ -43,7 +43,7 @@ export function registerCountTool(server: McpServer): void {
         metadata_filter: metadataFilterSchema
           .optional()
           .describe(
-            'Optional metadata filter. Use exact field names from list_namespaces. E.g. {"author": {"$in": ["John Lakos", "J. Lakos"]}} for author count.'
+            'Optional metadata filter. Use exact field names from list_namespaces. E.g. {"author": {"$in": ["John Doe", "J. John Doe"]}} for author count.'
           ),
       },
     },

src/server/tools/suggest-query-params-tool.ts

@@ -25,7 +25,7 @@ export function registerSuggestQueryParamsTool(server: McpServer): void {
         user_query: z
           .string()
           .describe(
-            'The user\'s natural language question or intent (e.g. "list papers by Lakos with titles and links", "how many papers by Wong?", "what do the contracts papers say?").'
+            'The user\'s natural language question or intent (e.g. "list papers by John Doe with titles and links", "how many papers by Wong?", "what do the contracts papers say?").'
           ),
       },
     },