threadnote 0.3.0 → 0.3.1

package/docs/agent-instructions.md

@@ -1,13 +1,18 @@
 # Agent Instructions
 
-Threadnote installs this as user-level agent guidance for Codex and Claude.
+Threadnote installs this as user-level agent guidance for Codex, Claude, and Cursor.
 
 ## Shared Context
 
 Use OpenViking through Threadnote as a shared local context and memory layer. Repo files remain authoritative: always
 follow the nearest `AGENTS.md`, `CLAUDE.md`, or other checked-in instruction file first.
 
-When OpenViking MCP tools are available, use them directly. If MCP is unavailable, use the `threadnote` CLI fallback.
+When OpenViking MCP tools are available, use them directly. Prefer Threadnote-named MCP tools when present:
+`recall_context`, `read_context`, `list_context`, and `remember_context`. Always pass JSON arguments to MCP tools, for
+example `recall_context({"query":"current repo latest handoff"})`. Older Threadnote MCP adapters may expose
+`search`, `read`, `list`, and `store` instead.
+
+If MCP is unavailable, use the `threadnote` CLI fallback.
 
 ## Recall
 

package/docs/troubleshooting.md

@@ -166,6 +166,18 @@ threadnote mcp-install cursor --apply
 This updates the global `~/.cursor/mcp.json` file. Restart Cursor or open a fresh agent session after changing MCP
 config.
 
+## Cursor MCP Tool Says Query Is Missing
+
+If Cursor shows an error like `expected string, received undefined` for Threadnote `search`, the MCP server started but
+Cursor called the tool without JSON arguments. Prefer the Threadnote-named tool and pass a query explicitly:
+
+```json
+{"query": "current repo latest handoff"}
+```
+
+Current Threadnote adapters expose `recall_context` for this flow. Older adapters expose `search`; both require the same
+`query` argument. Run `threadnote repair` after upgrading if Cursor still lists only stale tools.
+
 ## Uninstall Without Losing Memories
 
 Run:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "threadnote",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "commonjs",
   "main": "dist/threadnote.cjs",
   "description": "Shared local context and handoffs for development agents",
@@ -39,11 +39,17 @@
     "scripts/"
   ],
   "scripts": {
-    "build": "npm run clean --silent && esbuild threadnote.ts --bundle --platform=node --format=cjs --target=node20 --outfile=dist/threadnote.cjs && esbuild mcp_server.ts --bundle --platform=node --format=cjs --target=node20 --outfile=dist/mcp_server.cjs",
+    "build": "npm run clean --silent && esbuild src/threadnote.ts --bundle --platform=node --format=cjs --target=node20 --outfile=dist/threadnote.cjs && esbuild src/mcp_server.ts --bundle --platform=node --format=cjs --target=node20 --outfile=dist/mcp_server.cjs",
     "clean": "rm -rf dist",
-    "dev": "tsx threadnote.ts",
-    "dev:mcp-server": "tsx mcp_server.ts",
+    "dev": "tsx src/threadnote.ts",
+    "dev:mcp-server": "tsx src/mcp_server.ts",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "prepare": "husky",
+    "precommit": "npm run lint && npm run prettier:check",
     "prepack": "npm run build",
+    "prettier:check": "prettier --check \"**/*.{ts,js,cjs,json,md,yaml,yml}\"",
+    "prettier:write": "prettier --write \"**/*.{ts,js,cjs,json,md,yaml,yml}\"",
     "threadnote": "npm run build --silent && node ./bin/threadnote.cjs",
     "doctor": "npm run build --silent && node ./bin/threadnote.cjs doctor",
     "mcp-server": "npm run build --silent && node ./bin/threadnote-mcp-server.cjs",
@@ -54,14 +60,20 @@
     "node": ">=20"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.6.0",
     "commander": "^14.0.3",
     "esbuild": "^0.27.7",
+    "eslint": "^10.3.0",
+    "globals": "^17.6.0",
+    "husky": "^9.1.7",
     "js-yaml": "^4.1.1",
+    "prettier": "^3.8.3",
     "tsx": "^4.21.0",
     "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.2",
     "zod": "^4.4.3"
   }
 }