{"report":"{\"v\":1,\"package\":\"project-mcp\",\"version\":\"3.3.0\",\"ranAt\":\"2026-11-16T11:46:31.540Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-nMsVfIcWIgM+oRco+B+FiNT8ME4X8HMvMIWLIQREV2LxPtECFyk50JJWR0Au47ycHLoEVzN5JpilCTwcaKRSFw==\",\"deps\":114,\"scripts\":[],\"bins\":[\"project-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=18.0.0\",\"repository\":\"git+https://github.com/pouyanafisi/project-mcp.git\",\"bin\":\"project-mcp\"},\"start\":{\"ok\":true,\"ms\":192,\"serverName\":\"project-mcp\",\"serverVersion\":\"1.4.0\",\"protocol\":\"2025-06-18\",\"stderr\":\"Project MCP server running on stdio\\nSources: .project/ (operational), root files, docs/ (reference)\\n\"},\"tools\":[{\"name\":\"search_project\",\"description\":\"Search across project sources with smart intent detection. IMPORTANT: \\\"project docs\\\" means APPLICATION documentation (docs/ + DECISIONS.md), NOT project management. Use intent \\\"project_docs\\\" when user says \\\"project docs/documents/documentation\\\" to search application documentation. Use intent \\\"plan\\\" for project management (status, todos, roadmap, backlog).\",\"params\":[\"query\",\"intent\",\"maxResults\"]},{\"name\":\"search_docs\",\"description\":\"Search only the docs/ directory for reference documentation. Use this when the user specifically asks for \\\"docs\\\" or \\\"documentation\\\". Returns relevant documentation chunks with file paths and content snippets.\",\"params\":[\"query\",\"category\",\"maxResults\"]},{\"name\":\"get_doc\",\"description\":\"Get the full content of a specific file. Supports files from .project/, root-level, or docs/. Use the path as returned from search results.\",\"params\":[\"path\"]},{\"name\":\"list_docs\",\"description\":\"List all available documentation files organized by category. Use this to discover what documentation is available or to get an overview of the documentation structure.\",\"params\":[\"category\"]},{\"name\":\"get_doc_structure\",\"description\":\"Get the complete documentation directory structure with file paths and descriptions. Useful for understanding the organization of documentation.\",\"params\":[]},{\"name\":\"manage_project_file\",\"description\":\"Smart tool that automatically determines which project file to create or update based on context. Use this when making changes to the project - it will check project state and determine if index.md, ROADMAP.md, TODO.md, STATUS.md, or DECISIONS.md should be created/updated. This is the primary tool for managing project documentation during development.\",\"params\":[\"action\",\"content\",\"fileType\"]},{\"name\":\"check_project_state\",\"description\":\"Checks the current state of project management files. Returns which files exist (.project/index.md, ROADMAP.md, TODO.md, STATUS.md, DECISIONS.md) and provides a summary of project state. Use this before making changes to understand what exists.\",\"params\":[]},{\"name\":\"create_or_update_roadmap\",\"description\":\"Creates or updates the ROADMAP.md file in .project/ directory. Use this when planning future work, milestones, or phases. If the file exists, intelligently merges new content with existing roadmap.\",\"params\":[\"content\",\"section\",\"replace\"]},{\"name\":\"create_or_update_todo\",\"description\":\"Creates or updates the TODO.md file in .project/ directory. Use this when adding tasks, marking items complete, or updating task status. Intelligently organizes tasks into sections (In Progress, Next Up, Blocked, Completed).\",\"params\":[\"content\",\"section\",\"markComplete\",\"replace\"]},{\"name\":\"create_or_update_status\",\"description\":\"Creates or updates the STATUS.md file in .project/ directory. Use this when updating project health, recent changes, metrics, or current phase. Automatically updates the \\\"Last Updated\\\" timestamp.\",\"params\":[\"content\",\"updateType\",\"replace\"]},{\"name\":\"create_or_update_index\",\"description\":\"Creates or updates the index.md file in .project/ directory. This is the contract file that defines how agents should interpret sources. Use this when setting up project structure or updating source mappings.\",\"params\":[\"content\",\"replace\"]},{\"name\":\"create_or_update_decisions\",\"description\":\"Creates or updates the DECISIONS.md file in .project/ directory. Use this when documenting architecture decisions, trade-offs, or rationale. Helps maintain a decision log for the project.\",\"params\":[\"content\",\"decisionTitle\",\"replace\"]},{\"name\":\"add_decision\",\"description\":\"Adds a single architecture decision record (ADR) to DECISIONS.md. Creates a structured entry with title, context, decision, and consequences sections.\",\"params\":[\"title\",\"context\",\"decision\",\"consequences\",\"status\",\"tags\"]},{\"name\":\"list_decisions\",\"description\":\"Lists all architecture decisions from DECISIONS.md with optional filtering by status or tag.\",\"params\":[\"status\",\"tag\"]},{\"name\":\"update_project_status\",\"description\":\"Quick status update for the project. Adds a timestamped entry to STATUS.md with the current status, changes, or notes.\",\"params\":[\"status\",\"health\",\"changes\",\"blockers\",\"next_milestone\"]},{\"name\":\"add_roadmap_milestone\",\"description\":\"Adds a milestone or phase to ROADMAP.md. Creates a structured entry with title, description, target date, and deliverables.\",\"params\":[\"title\",\"description\",\"target_date\",\"deliverables\",\"status\"]},{\"name\":\"get_decision\",\"description\":\"Reads a specific architecture decision by ADR ID. Returns the full decision content including context, decision, and consequences.\",\"params\":[\"id\"]},{\"name\":\"get_roadmap\",\"description\":\"Reads the current roadmap content from ROADMAP.md. Returns milestones, phases, and planned work.\",\"params\":[\"section\"]},{\"name\":\"create_task\",\"description\":\"Creates a new task with YAML frontmatter metadata. Uses Jira-like IDs (e.g., AUTH-001, API-042) for stable references. Supports dependencies, priorities, estimates, due dates, and tags. Agents can determine execution order by checking dependencies and priorities.\",\"params\":[\"title\",\"project\",\"description\",\"owner\",\"priority\",\"status\",\"depends_on\",\"blocked_by\",\"estimate\",\"due\",\"tags\",\"subtasks\"]},{\"name\":\"update_task\",\"description\":\"Updates an existing task by ID. Can update any field including status, priority, owner, dependencies, etc. Use this to transition tasks through workflow states.\",\"params\":[\"id\",\"title\",\"description\",\"owner\",\"priority\",\"status\",\"depends_on\",\"blocked_by\",\"estimate\",\"due\",\"tags\",\"add_subtask\",\"complete_subtask\"]},{\"name\":\"get_task\",\"description\":\"Reads and returns a specific task by ID. Shows all metadata including frontmatter, description, subtasks, and notes.\",\"params\":[\"id\"]},{\"name\":\"delete_task\",\"description\":\"Permanently deletes a task from todos/. Use with caution - this cannot be undone. Consider using archive_task instead for completed tasks.\",\"params\":[\"id\",\"confirm\"]},{\"name\":\"get_next_task\",\"description\":\"Returns the next task(s) that should be worked on. Considers: dependencies (only returns tasks whose dependencies are done), priority (P0 first), status (excludes done/blocked), and optionally filters by owner or project. This is the key tool for agentic execution - call this to know what to do next.\",\"params\":[\"owner\",\"project\",\"include_blocked\",\"limit\"]},{\"name\":\"list_tasks\",\"description\":\"Lists all tasks with optional filtering. Returns a summary view of tasks organized by status and priority.\",\"params\":[\"project\",\"owner\",\"status\",\"priority\",\"tag\"]},{\"name\":\"search_tasks\",\"description\":\"Search tasks by keyword in title, description, or content. Returns matching tasks with relevance ranking.\",\"params\":[\"query\",\"project\",\"status\",\"include_archived\",\"limit\"]},{\"name\":\"sync_todo_index\",\"description\":\"Syncs the parent TODO.md file with all tasks. Generates a dashboard view with tasks organized by status, priority counts, dependency graph, and execution order. This provides a bird's eye view of all work.\",\"params\":[\"format\"]},{\"name\":\"import_tasks\",\"description\":\"Parses a plan document and imports tasks to BACKLOG.md (not individual files). Use this to populate the backlog from a roadmap or requirements doc. Tasks stay in BACKLOG until promoted to active work via promote_task.\",\"params\":[\"source\",\"source_type\",\"project\",\"phase\",\"default_priority\",\"dry_run\"]},{\"name\":\"promote_task\",\"description\":\"Promotes a task from BACKLOG.md to an active YAML task file in todos/. Use this when starting work on a backlog item. Creates a full task file with YAML frontmatter, dependencies, and metadata.\",\"params\":[\"task_id\",\"owner\",\"priority\",\"depends_on\",\"estimate\",\"due\"]},{\"name\":\"archive_task\",\"description\":\"Archives a completed task by moving it from todos/ to archive/. Keeps the active task queue small and focused. Archived tasks are preserved for history but excluded from get_next_task.\",\"params\":[\"task_id\",\"force\"]},{\"name\":\"add_to_backlog\",\"description\":\"Adds a single item to BACKLOG.md. Use this for quick task creation without bulk import. Items are added to the specified priority section and can later be promoted to active work.\",\"params\":[\"title\",\"project\",\"priority\",\"tags\",\"phase\",\"subtasks\"]},{\"name\":\"get_backlog\",\"description\":\"Reads and returns the current backlog contents with optional filtering. Shows tasks organized by priority with counts and summary.\",\"params\":[\"priority\",\"project\",\"include_promoted\"]},{\"name\":\"update_backlog_item\",\"description\":\"Updates an item in BACKLOG.md. Can change priority, title, tags, or phase without promoting to active work.\",\"params\":[\"task_id\",\"title\",\"priority\",\"tags\",\"phase\"]},{\"name\":\"remove_from_backlog\",\"description\":\"Removes an item from BACKLOG.md without promoting it. Use for tasks that are no longer needed or were added by mistake.\",\"params\":[\"task_id\",\"reason\"]},{\"name\":\"list_archived_tasks\",\"description\":\"Lists tasks in the archive/ directory. Shows completed work history with optional filtering by project or date.\",\"params\":[\"project\",\"limit\"]},{\"name\":\"unarchive_task\",\"description\":\"Restores a task from archive/ back to todos/ for further work. Use when a completed task needs to be reopened.\",\"params\":[\"task_id\",\"status\"]},{\"name\":\"lint_project_docs\",\"description\":\"Validates project documentation against standards. Checks for required files, valid frontmatter, broken dependencies, missing fields, and formatting issues. Can auto-fix common problems. Run this before commits to ensure documentation quality.\",\"params\":[\"fix\",\"strict\",\"scope\"]},{\"name\":\"init_project\",\"description\":\"Initializes the .project/ directory with all standard files following strict templates. Creates index.md (contract), TODO.md (dashboard), BACKLOG.md (prioritized work queue), ROADMAP.md, STATUS.md, DECISIONS.md, and todos/ directory. Use this to bootstrap a new project with proper structure.\",\"params\":[\"project_name\",\"project_description\",\"overwrite\"]},{\"name\":\"process_thoughts\",\"description\":\"Reads brain dump markdown files from .project/thoughts/todos/ and returns the content along with project context for analysis.\\n\\nThis tool gathers:\\n1. **Raw thought content** - The unstructured brain dump as written\\n2. **Project context** - Existing tasks, roadmap milestones, decisions for reference\\n3. **Task format guide** - The YAML structure for creating tasks\\n\\nYOU (the LLM) should then analyze the content to:\\n- Understand the user's intent (explicit, shadow/underlying, practical)\\n- Identify logical task groupings (consolidate related items)\\n- Determine appropriate priorities based on context\\n- Create well-structured tasks using create_task\\n- **After creating tasks, use archive_thought to archive the processed file**\\n\\nThe tool does NOT automatically create tasks - it provides you with everything needed to make intelligent decisions about task creation.\",\"params\":[\"file\",\"project\"]},{\"name\":\"archive_thought\",\"description\":\"Archives a processed thought file by moving it to .project/thoughts/todos/.archive/. \\nUse this after you've created tasks from a thought file to keep the active thoughts folder clean.\\nAlso logs the archive action with timestamp and created task IDs.\",\"params\":[\"file\",\"created_tasks\",\"notes\"]},{\"name\":\"list_thoughts\",\"description\":\"Lists all thought files in the .project/thoughts/ directory structure. Shows available brain dump files organized by category.\",\"params\":[\"category\",\"include_archived\"]},{\"name\":\"list_archived_thoughts\",\"description\":\"Lists all archived thought files with their processing history. Shows what thoughts were processed, when, and what tasks were created.\",\"params\":[\"limit\"]},{\"name\":\"get_thought\",\"description\":\"Reads a specific thought file and returns its raw content for review.\",\"params\":[\"file\",\"category\",\"from_archive\"]}],\"toolsHash\":\"4d5518caabde564aa5d6bb9a186265576aa3d1916df1cd4bb2dbd511f91a8e0f\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:46:38.404Z\",\"calls\":[{\"tool\":\"list_docs\",\"ok\":true,\"ms\":5,\"bytes\":29},{\"tool\":\"get_doc_structure\",\"ok\":true,\"ms\":1,\"bytes\":33},{\"tool\":\"list_decisions\",\"ok\":true,\"ms\":1,\"bytes\":83},{\"tool\":\"get_roadmap\",\"ok\":true,\"ms\":1,\"bytes\":96},{\"tool\":\"get_next_task\",\"ok\":true,\"ms\":1,\"bytes\":165}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmZjYmM3OGVhZmZmMTMxZGNlMzI0MTQ2YTI1NzZhOTMzMmJjMWIzYTgwOWQ3OGYzMDY3ZTZlZGY0Y2Q2YmI0NWUiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTMyMSIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTkwNCwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjk2MDQsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiZWViYjQ0ZGUtNWU1MC00ZGM5LWJiZTQtYzFhMDk3OTNkNjYzIiwibmJmIjoxNzk0ODI5MzA0LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.4nNZuTU4_mxBi10Uk1pvsqBEq_zwFys1Pfg2xhguMNyLwC0eNuGeaqjLHmX3Xq9qZNIjxSWZfeSKefDUlkk_-9VUWWisTnbJMXbVTUspFLfya2ym75ZId0LJ0VmPLzGAJhU0Wg7-x9ExHNDhxwuJ6j_AyPRjJbZgp1akfo7GapjgxHUfEUOmd2GNV2Y7EcRDtlIcgqnlcHl1c-VxCFAHGLvFFFpXEtg18DehSOMNBeYzN9jbX2uqxC3ZjdUK0ine15klAa-qRXDqdzb0_Cw4R8CNkfz2O4tm21CPijQSzK2KwfyHz_0wnRde-ObD_VNQzGG8HTU2jYm8CjpAUL53yw"}