project-mcp 3.2.0 → 3.2.2

package/package.json

@@ -1,79 +1,79 @@
 {
-  "name": "project-mcp",
-  "version": "3.2.0",
-  "description": "Intent-based MCP server for project documentation search. Maps natural language queries to the right sources automatically—no configuration needed. The standard for AI agent documentation search.",
-  "type": "module",
-  "main": "src/index.js",
-  "bin": {
-    "project-mcp": "src/index.js"
-  },
-  "scripts": {
-    "start": "node src/index.js",
-    "test": "node --test test/*.test.js",
-    "lint": "node --check src/index.js",
-    "format": "prettier --write \"**/*.{js,md,json}\"",
-    "format:check": "prettier --check \"**/*.{js,md,json}\"",
-    "prepublishOnly": "npm run lint && npm test"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "mcp-server",
-    "documentation",
-    "documentation-search",
-    "docs-search",
-    "search",
-    "fuzzy-search",
-    "semantic-search",
-    "markdown",
-    "markdown-search",
-    "project-documentation",
-    "project-management",
-    "intent-based-search",
-    "intent-mapping",
-    "ai-agent",
-    "ai-assistant",
-    "claude",
-    "cursor",
-    "anthropic",
-    "ai-tools",
-    "developer-tools",
-    "documentation-tools",
-    "knowledge-base",
-    "project-knowledge",
-    "operational-truth",
-    "reference-documentation",
-    "fuse.js",
-    "natural-language",
-    "nlp",
-    "zero-config",
-    "automatic-indexing"
-  ],
-  "author": "",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/pouyanafisi/project-mcp.git"
-  },
-  "bugs": {
-    "url": "https://github.com/pouyanafisi/project-mcp/issues"
-  },
-  "homepage": "https://github.com/pouyanafisi/project-mcp#readme",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4",
-    "fuse.js": "^7.0.0",
-    "gray-matter": "^4.0.3",
-    "mime-types": "^2.1.35"
-  },
-  "devDependencies": {
-    "prettier": "^3.7.4"
-  },
-  "files": [
-    "src/",
-    "README.md",
-    "LICENSE"
-  ]
+	"name": "project-mcp",
+	"version": "3.2.2",
+	"description": "Intent-based MCP server for project documentation search. Maps natural language queries to the right sources automatically—no configuration needed. The standard for AI agent documentation search.",
+	"type": "module",
+	"main": "src/index.js",
+	"bin": {
+		"project-mcp": "src/index.js"
+	},
+	"scripts": {
+		"start": "node src/index.js",
+		"test": "node --test test/*.test.js",
+		"lint": "node --check src/index.js",
+		"format": "prettier --write \"**/*.{js,md,json}\"",
+		"format:check": "prettier --check \"**/*.{js,md,json}\"",
+		"prepublishOnly": "npm run lint && npm test"
+	},
+	"keywords": [
+		"mcp",
+		"model-context-protocol",
+		"mcp-server",
+		"documentation",
+		"documentation-search",
+		"docs-search",
+		"search",
+		"fuzzy-search",
+		"semantic-search",
+		"markdown",
+		"markdown-search",
+		"project-documentation",
+		"project-management",
+		"intent-based-search",
+		"intent-mapping",
+		"ai-agent",
+		"ai-assistant",
+		"claude",
+		"cursor",
+		"anthropic",
+		"ai-tools",
+		"developer-tools",
+		"documentation-tools",
+		"knowledge-base",
+		"project-knowledge",
+		"operational-truth",
+		"reference-documentation",
+		"fuse.js",
+		"natural-language",
+		"nlp",
+		"zero-config",
+		"automatic-indexing"
+	],
+	"author": "",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/pouyanafisi/project-mcp.git"
+	},
+	"bugs": {
+		"url": "https://github.com/pouyanafisi/project-mcp/issues"
+	},
+	"homepage": "https://github.com/pouyanafisi/project-mcp#readme",
+	"engines": {
+		"node": ">=18.0.0"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.0.4",
+		"fuse.js": "^7.0.0",
+		"gray-matter": "^4.0.3",
+		"mime-types": "^2.1.35"
+	},
+	"devDependencies": {
+		"prettier": "^3.7.4"
+	},
+	"files": [
+		"src/",
+		"README.md",
+		"LICENSE"
+	]
 }

package/src/lib/constants.js

@@ -12,6 +12,8 @@ export const PROJECT_DIR = join(PROJECT_ROOT, '.project');
 export const TODOS_DIR = join(PROJECT_DIR, 'todos');
 export const ARCHIVE_DIR = join(PROJECT_DIR, 'archive');
 export const BACKLOG_FILE = join(PROJECT_DIR, 'BACKLOG.md');
+export const THOUGHTS_DIR = join(PROJECT_DIR, 'thoughts');
+export const THOUGHTS_TODOS_DIR = join(THOUGHTS_DIR, 'todos');
 
 /**
  * Intent to source mapping.

package/src/lib/files.js

@@ -5,7 +5,7 @@
 import { readFile, readdir, stat, writeFile, mkdir, unlink, rename } from 'fs/promises';
 import { join, extname, basename } from 'path';
 import matter from 'gray-matter';
-import { PROJECT_DIR, TODOS_DIR, ARCHIVE_DIR } from './constants.js';
+import { PROJECT_DIR, TODOS_DIR, ARCHIVE_DIR, THOUGHTS_DIR, THOUGHTS_TODOS_DIR } from './constants.js';
 
 /**
  * Ensure .project directory exists
@@ -40,6 +40,28 @@ export async function ensureArchiveDir() {
 	}
 }
 
+/**
+ * Ensure .project/thoughts directory exists
+ */
+export async function ensureThoughtsDir() {
+	try {
+		await mkdir(THOUGHTS_DIR, { recursive: true });
+	} catch (error) {
+		// Directory might already exist
+	}
+}
+
+/**
+ * Ensure .project/thoughts/todos directory exists
+ */
+export async function ensureThoughtsTodosDir() {
+	try {
+		await mkdir(THOUGHTS_TODOS_DIR, { recursive: true });
+	} catch (error) {
+		// Directory might already exist
+	}
+}
+
 /**
  * Check if a file exists
  * @param {string} filePath - Path to check
@@ -91,7 +113,7 @@ export function extractTitle(content) {
  * @returns {string|null}
  */
 export function extractDescription(content) {
-	const lines = content.split('\n').filter((line) => line.trim());
+	const lines = content.split('\n').filter(line => line.trim());
 	for (let i = 1; i < Math.min(5, lines.length); i++) {
 		const line = lines[i].trim();
 		if (line && !line.startsWith('#') && line.length > 20) {

package/src/lib/search.js

@@ -32,9 +32,7 @@ export function detectIntent(query, explicitIntent) {
 	const queryLower = query.toLowerCase();
 
 	// Check for operational keywords
-	if (
-		/\b(plan|plans|todo|todos|roadmap|status|operational|current state|decisions)\b/.test(queryLower)
-	) {
+	if (/\b(plan|plans|todo|todos|roadmap|status|operational|current state|decisions)\b/.test(queryLower)) {
 		return 'plan';
 	}
 
@@ -161,7 +159,7 @@ export async function searchFiles(query, sources, maxResults = 10) {
 	await loadAllFiles();
 
 	// Filter files by source
-	const filesToSearch = allFilesCache.filter((file) => sources.includes(file.source));
+	const filesToSearch = allFilesCache.filter(file => sources.includes(file.source));
 
 	// Rebuild index with filtered files
 	const index = new Fuse(filesToSearch, {

package/src/lib/tasks.js

@@ -5,13 +5,7 @@
 import { readFile, readdir } from 'fs/promises';
 import { join } from 'path';
 import matter from 'gray-matter';
-import {
-	TODOS_DIR,
-	ARCHIVE_DIR,
-	BACKLOG_FILE,
-	PRIORITY_ORDER,
-	PRIORITY_KEYWORDS,
-} from './constants.js';
+import { TODOS_DIR, ARCHIVE_DIR, BACKLOG_FILE, PRIORITY_ORDER, PRIORITY_KEYWORDS } from './constants.js';
 import { ensureTodosDir, fileExists } from './files.js';
 
 /**
@@ -78,7 +72,7 @@ export async function loadAllTasks() {
  */
 export function areDependenciesMet(task, allTasks) {
 	if (!task.depends_on || task.depends_on.length === 0) return true;
-	const taskMap = new Map(allTasks.map((t) => [t.id, t]));
+	const taskMap = new Map(allTasks.map(t => [t.id, t]));
 	for (const depId of task.depends_on) {
 		const dep = taskMap.get(depId);
 		if (!dep || dep.status !== 'done') return false;
@@ -218,7 +212,7 @@ export function parseTasksFromContent(content, project, defaultPriority) {
 
 			if (isSubtask && currentParent) {
 				// Add as subtask to parent
-				const parent = tasks.find((t) => t.tempId === currentParent);
+				const parent = tasks.find(t => t.tempId === currentParent);
 				if (parent) {
 					parent.subtasks = parent.subtasks || [];
 					parent.subtasks.push(title);
@@ -239,7 +233,7 @@ export function parseTasksFromContent(content, project, defaultPriority) {
 				// Extract tags from brackets
 				const tagMatch = title.match(/\[([^\]]+)\]/g);
 				if (tagMatch) {
-					task.tags = tagMatch.map((t) => t.slice(1, -1).toLowerCase());
+					task.tags = tagMatch.map(t => t.slice(1, -1).toLowerCase());
 					task.title = title.replace(/\[[^\]]+\]/g, '').trim();
 				}
 

package/src/prompts/definitions.js

@@ -211,7 +211,7 @@ export const prompts = [
  * @returns {string[]}
  */
 export function getPromptNames() {
-	return prompts.map((p) => p.name);
+	return prompts.map(p => p.name);
 }
 
 /**

package/src/prompts/index.js

@@ -2,10 +2,7 @@
  * Prompt handlers for the MCP server.
  */
 
-import {
-	ListPromptsRequestSchema,
-	GetPromptRequestSchema,
-} from '@modelcontextprotocol/sdk/types.js';
+import { ListPromptsRequestSchema, GetPromptRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { prompts, promptToolMapping } from './definitions.js';
 
 /**
@@ -254,9 +251,9 @@ export function setupPrompts(server) {
 	}));
 
 	// Handle get prompt request
-	server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+	server.setRequestHandler(GetPromptRequestSchema, async request => {
 		const { name, arguments: args } = request.params;
-		const prompt = prompts.find((p) => p.name === name);
+		const prompt = prompts.find(p => p.name === name);
 
 		if (!prompt) {
 			throw new Error(`Prompt not found: ${name}`);

package/src/resources/index.js

@@ -2,10 +2,7 @@
  * Resource handlers for the MCP server.
  */
 
-import {
-	ListResourcesRequestSchema,
-	ReadResourceRequestSchema,
-} from '@modelcontextprotocol/sdk/types.js';
+import { ListResourcesRequestSchema, ReadResourceRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { lookup } from 'mime-types';
 import { PROJECT_ROOT } from '../lib/constants.js';
 import { readFile, join } from '../lib/files.js';
@@ -19,7 +16,7 @@ async function listResources() {
 	await loadAllFiles();
 	const allFilesCache = getCachedFiles();
 
-	return allFilesCache.map((doc) => ({
+	return allFilesCache.map(doc => ({
 		uri: `project://${doc.path}`,
 		name: doc.title,
 		description: doc.description || `File: ${doc.path} [${doc.source}]`,
@@ -63,7 +60,7 @@ export function setupResources(server) {
 		resources: await listResources(),
 	}));
 
-	server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+	server.setRequestHandler(ReadResourceRequestSchema, async request => {
 		const { uri } = request.params;
 		return await readResource(uri);
 	});

package/src/server.js

@@ -48,7 +48,7 @@ export class ProjectMCPServer {
 			tools: toolDefinitions,
 		}));
 
-		this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+		this.server.setRequestHandler(CallToolRequestSchema, async request => {
 			const { name, arguments: args } = request.params;
 
 			try {

package/src/tools/backlog.js

@@ -3,13 +3,7 @@
  * Handles: import_tasks, promote_task, archive_task, add_to_backlog, get_backlog, update_backlog_item, remove_from_backlog, list_archived_tasks, unarchive_task
  */
 
-import {
-	PROJECT_ROOT,
-	PROJECT_DIR,
-	TODOS_DIR,
-	ARCHIVE_DIR,
-	BACKLOG_FILE,
-} from '../lib/constants.js';
+import { PROJECT_ROOT, PROJECT_DIR, TODOS_DIR, ARCHIVE_DIR, BACKLOG_FILE } from '../lib/constants.js';
 import {
 	readFile,
 	writeFile,
@@ -42,8 +36,7 @@ export const definitions = [
 				},
 				source_type: {
 					type: 'string',
-					description:
-						'Type of source: "file" (path to file) or "content" (raw markdown). Default: "file".',
+					description: 'Type of source: "file" (path to file) or "content" (raw markdown). Default: "file".',
 					enum: ['file', 'content'],
 					default: 'file',
 				},
@@ -63,8 +56,7 @@ export const definitions = [
 				},
 				dry_run: {
 					type: 'boolean',
-					description:
-						'If true, shows what would be imported without modifying BACKLOG.md. Default: false.',
+					description: 'If true, shows what would be imported without modifying BACKLOG.md. Default: false.',
 					default: false,
 				},
 			},
@@ -329,7 +321,7 @@ async function importTasks(args) {
 
 	// Filter by phase if specified
 	if (filterPhase) {
-		tasks = tasks.filter((t) => t.phase && t.phase.toLowerCase().includes(filterPhase.toLowerCase()));
+		tasks = tasks.filter(t => t.phase && t.phase.toLowerCase().includes(filterPhase.toLowerCase()));
 	}
 
 	if (tasks.length === 0) {
@@ -452,10 +444,7 @@ updated: ${getISODate()}
 		}
 
 		// Update timestamp
-		backlogContent = backlogContent.replace(
-			/\*\*Last Updated:\*\* .*/,
-			`**Last Updated:** ${getCurrentDate()}`
-		);
+		backlogContent = backlogContent.replace(/\*\*Last Updated:\*\* .*/, `**Last Updated:** ${getCurrentDate()}`);
 		backlogContent = backlogContent.replace(/updated: .*/, `updated: ${getISODate()}`);
 
 		await writeFile(BACKLOG_FILE, backlogContent, 'utf-8');
@@ -523,7 +512,7 @@ async function promoteTask(args) {
 	}
 
 	const title = match[1].trim();
-	const tags = match[2] ? match[2].split(',').map((t) => t.trim()) : [];
+	const tags = match[2] ? match[2].split(',').map(t => t.trim()) : [];
 	const phase = match[3] || null;
 
 	// Detect priority from backlog section
@@ -720,10 +709,7 @@ updated: ${getISODate()}
 	}
 
 	// Update timestamp
-	backlogContent = backlogContent.replace(
-		/\*\*Last Updated:\*\* .*/,
-		`**Last Updated:** ${getCurrentDate()}`
-	);
+	backlogContent = backlogContent.replace(/\*\*Last Updated:\*\* .*/, `**Last Updated:** ${getCurrentDate()}`);
 	backlogContent = backlogContent.replace(/updated: .*/, `updated: ${getISODate()}`);
 
 	await writeFile(BACKLOG_FILE, backlogContent, 'utf-8');
@@ -763,15 +749,14 @@ async function getBacklog(args) {
 
 	// Parse backlog items
 	const items = [];
-	const itemRegex =
-		/^- \[([ x]|promoted)\] \*\*([A-Z]+-\d+)\*\*:\s*(.+?)(?:\s*\[([^\]]+)\])?(?:\s*\(([^)]+)\))?$/gm;
+	const itemRegex = /^- \[([ x]|promoted)\] \*\*([A-Z]+-\d+)\*\*:\s*(.+?)(?:\s*\[([^\]]+)\])?(?:\s*\(([^)]+)\))?$/gm;
 	let match;
 
 	while ((match = itemRegex.exec(backlogContent)) !== null) {
 		const status = match[1] === ' ' ? 'pending' : match[1] === 'x' ? 'done' : 'promoted';
 		const id = match[2];
 		const title = match[3].trim();
-		const tags = match[4] ? match[4].split(',').map((t) => t.trim()) : [];
+		const tags = match[4] ? match[4].split(',').map(t => t.trim()) : [];
 		const phase = match[5] || null;
 
 		// Detect priority from section
@@ -788,13 +773,13 @@ async function getBacklog(args) {
 	// Apply filters
 	let filtered = items;
 	if (!include_promoted) {
-		filtered = filtered.filter((i) => i.status !== 'promoted');
+		filtered = filtered.filter(i => i.status !== 'promoted');
 	}
 	if (priority) {
-		filtered = filtered.filter((i) => i.priority === priority);
+		filtered = filtered.filter(i => i.priority === priority);
 	}
 	if (project) {
-		filtered = filtered.filter((i) => i.id.startsWith(project.toUpperCase()));
+		filtered = filtered.filter(i => i.id.startsWith(project.toUpperCase()));
 	}
 
 	// Group by priority
@@ -866,7 +851,7 @@ async function updateBacklogItem(args) {
 	}
 
 	const currentTitle = match[2].trim();
-	const currentTags = match[3] ? match[3].split(',').map((t) => t.trim()) : [];
+	const currentTags = match[3] ? match[3].split(',').map(t => t.trim()) : [];
 	const currentPhase = match[4] || null;
 
 	// Build new entry
@@ -919,7 +904,7 @@ async function updateBacklogItem(args) {
 	await writeFile(BACKLOG_FILE, backlog, 'utf-8');
 
 	let result = `## Updated Backlog Item: ${id}\n\n`;
-	result += `**Changes:**\n${changes.map((c) => `- ${c}`).join('\n')}\n\n`;
+	result += `**Changes:**\n${changes.map(c => `- ${c}`).join('\n')}\n\n`;
 	result += `✅ BACKLOG.md updated.`;
 
 	return {
@@ -1000,12 +985,10 @@ async function listArchivedTasks(args) {
 		};
 	}
 
-	const mdFiles = files.filter((f) => f.endsWith('.md'));
+	const mdFiles = files.filter(f => f.endsWith('.md'));
 	if (mdFiles.length === 0) {
 		return {
-			content: [
-				{ type: 'text', text: `📦 Archive is empty. No completed tasks have been archived yet.` },
-			],
+			content: [{ type: 'text', text: `📦 Archive is empty. No completed tasks have been archived yet.` }],
 		};
 	}
 
@@ -1024,7 +1007,7 @@ async function listArchivedTasks(args) {
 	// Filter by project if specified
 	let filtered = tasks;
 	if (project) {
-		filtered = filtered.filter((t) => t.project === project.toUpperCase());
+		filtered = filtered.filter(t => t.project === project.toUpperCase());
 	}
 
 	// Sort by archived date (newest first)

package/src/tools/index.js

@@ -7,16 +7,17 @@ import * as projectFiles from './project-files.js';
 import * as tasks from './tasks.js';
 import * as backlog from './backlog.js';
 import * as lint from './lint.js';
+import * as thoughts from './thoughts.js';
 
 /**
  * All tool modules
  */
-const modules = [search, projectFiles, tasks, backlog, lint];
+const modules = [search, projectFiles, tasks, backlog, lint, thoughts];
 
 /**
  * Combined tool definitions
  */
-export const definitions = modules.flatMap((m) => m.definitions);
+export const definitions = modules.flatMap(m => m.definitions);
 
 /**
  * Combined handler map

package/src/tools/lint.js

@@ -3,13 +3,7 @@
  * Handles: lint_project_docs, init_project
  */
 
-import {
-	PROJECT_DIR,
-	TODOS_DIR,
-	ARCHIVE_DIR,
-	VALID_STATUSES,
-	VALID_PRIORITIES,
-} from '../lib/constants.js';
+import { PROJECT_DIR, TODOS_DIR, ARCHIVE_DIR, VALID_STATUSES, VALID_PRIORITIES } from '../lib/constants.js';
 import {
 	readFile,
 	writeFile,
@@ -150,7 +144,7 @@ async function lintProjectDocs(args) {
 	// Check task files
 	if (scope === 'all' || scope === 'tasks') {
 		const tasks = await loadAllTasks();
-		const taskIds = new Set(tasks.map((t) => t.id));
+		const taskIds = new Set(tasks.map(t => t.id));
 
 		// Required task fields
 		const requiredFields = ['id', 'title', 'project', 'status', 'priority'];
@@ -290,8 +284,8 @@ async function lintProjectDocs(args) {
 		// Check for orphaned tasks (done tasks that others depend on)
 		for (const task of tasks) {
 			if (task.status === 'done' && task.depends_on?.length > 0) {
-				const unresolvedDeps = task.depends_on.filter((depId) => {
-					const dep = tasks.find((t) => t.id === depId);
+				const unresolvedDeps = task.depends_on.filter(depId => {
+					const dep = tasks.find(t => t.id === depId);
 					return dep && dep.status !== 'done';
 				});
 				if (unresolvedDeps.length > 0) {
@@ -306,8 +300,8 @@ async function lintProjectDocs(args) {
 	}
 
 	// Build result
-	const errorCount = issues.filter((i) => i.type === 'error').length;
-	const warningCount = issues.filter((i) => i.type === 'warning').length + warnings.length;
+	const errorCount = issues.filter(i => i.type === 'error').length;
+	const warningCount = issues.filter(i => i.type === 'warning').length + warnings.length;
 
 	let result = `## Documentation Lint Results\n\n`;
 	result += `**Scope:** ${scope} | **Strict:** ${strict} | **Auto-fix:** ${fix}\n\n`;