@claudetools/tools 0.8.2 → 0.8.4

package/dist/tools.js

@@ -7,7 +7,14 @@ export function registerToolDefinitions(server) {
         tools: [
             {
                 name: 'memory_search',
-                description: 'Search the memory system for relevant facts and entities based on a query. Use this to recall past conversations, facts, and relationships. NOTE: Context is now automatically injected - use this only for explicit searches.',
+                description: `⚠️ RARELY NEEDED - Context is AUTO-INJECTED via hooks on every message.
+
+Only use this tool when:
+- You need to search with DIFFERENT parameters than the user's query
+- You're debugging what's in memory
+- The user explicitly asks to search memory
+
+DO NOT use this tool to "recall context" - that happens automatically.`,
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -29,7 +36,7 @@ export function registerToolDefinitions(server) {
             },
             {
                 name: 'memory_explain',
-                description: 'Explain what memory context was automatically injected in the last response. Use this when you want to understand what memories are being used.',
+                description: 'Debug tool: Show what memory context was auto-injected. Only use if debugging memory injection.',
                 inputSchema: {
                     type: 'object',
                     properties: {},
@@ -37,7 +44,13 @@ export function registerToolDefinitions(server) {
             },
             {
                 name: 'memory_inject',
-                description: 'Manually trigger context injection for a specific query. Normally context is injected automatically, but use this for explicit control.',
+                description: `⚠️ RARELY NEEDED - Context is AUTO-INJECTED via user-prompt-submit hook.
+
+Only use this tool when:
+- You need to inject context for a DIFFERENT query than the user's message
+- The user explicitly asks to refresh context
+
+DO NOT call this routinely - it wastes context tokens.`,
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -133,13 +146,19 @@ EXAMPLES:
                             type: 'string',
                             description: 'Project ID (optional, uses default if not provided)',
                         },
+                        is_critical: {
+                            type: 'boolean',
+                            description: 'Mark as critical fact - always injected regardless of query relevance. Use sparingly for truly essential facts.',
+                        },
                     },
                     required: ['entity1', 'relationship', 'entity2', 'context'],
                 },
             },
             {
                 name: 'memory_get_context',
-                description: 'Get the current memory context, optionally filtered by a query. Returns recent facts and entities.',
+                description: `⚠️ RARELY NEEDED - Context is AUTO-INJECTED via hooks.
+
+Only use for debugging or when user explicitly asks "what context do you have?"`,
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -185,23 +204,10 @@ EXAMPLES:
             // =========================================================================
             {
                 name: 'memory_index',
-                description: `Get a lightweight index of available memories WITHOUT fetching full content. Use this FIRST to scan what context is available before deciding what to retrieve.
-
-Returns for each memory:
-- id: Unique identifier for fetching details
-- topic: Short topic/subject description
-- relevance: Score (0-1) indicating how relevant to query
-- token_cost: Estimated tokens if fetched
-- importance: "critical" | "high" | "normal" - Critical facts are auto-injected
-- category: "architecture" | "pattern" | "decision" | "preference" | "fact"
-- last_accessed: When this memory was last used
-
-WORKFLOW:
-1. Call memory_index with your query to see what's available
-2. Review the index - critical items are auto-injected
-3. Call memory_detail for specific IDs you want full content for
+                description: `⚠️ RARELY NEEDED - Critical facts are AUTO-INJECTED via hooks.
 
-This saves tokens by letting you selectively fetch only relevant memories.`,
+Only use when you need to browse ALL available memories or debug what's stored.
+For normal work, context is injected automatically - don't call this.`,
                 inputSchema: {
                     type: 'object',
                     properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claudetools/tools",
-  "version": "0.8.2",
+  "version": "0.8.4",
   "description": "Persistent AI memory, task management, and codebase intelligence for Claude Code",
   "type": "module",
   "main": "dist/index.js",
@@ -26,7 +26,9 @@
     "codedna:analytics": "tsx -e \"import { weeklyAnalyticsSummary } from './src/helpers/usage-analytics.js'; weeklyAnalyticsSummary()\"",
     "codedna:analytics:24h": "tsx -e \"import { getLast24HoursAnalytics, printAnalytics } from './src/helpers/usage-analytics.js'; const r = await getLast24HoursAnalytics(); printAnalytics(r, 'Last 24 Hours')\"",
     "codedna:analytics:30d": "tsx -e \"import { getLast30DaysAnalytics, printAnalytics } from './src/helpers/usage-analytics.js'; const r = await getLast30DaysAnalytics(); printAnalytics(r, 'Last 30 Days')\"",
-    "prompt:verify": "scripts/verify-prompt-compliance.sh"
+    "prompt:verify": "scripts/verify-prompt-compliance.sh",
+    "eval:build-dataset": "tsx src/evaluation/build-dataset.ts",
+    "eval:threshold": "tsx src/evaluation/threshold-eval.ts"
   },
   "repository": {
     "type": "git",
@@ -63,10 +65,12 @@
     "typescript": "^5.3.0"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^20.10.0",
     "@types/nunjucks": "^3.2.6",
     "@types/prompts": "^2.4.9",
     "@vitest/ui": "^4.0.15",
+    "better-sqlite3": "^12.5.0",
     "tsx": "^4.7.0",
     "typescript": "^5.3.0",
     "vitest": "^4.0.15"