{"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":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"orders","tool":"search_project","quote":"Search across project sources with smart intent detection. IMPORTANT: \"project docs\" means APPLICATION documentation (docs/ + DECISIONS.md), NOT project management. Use"}],"tools":42,"wrote":0,"callsTried":5,"callsAnswered":5,"callContacts":[]},"history":[{"package":"project-mcp","version":"3.3.0","ranAt":"2026-11-16T11:46:31.540Z","outcome":"started","tools":42,"contacts":0,"flags":1,"serious":0,"toolsHash":"4d5518caabde564aa5d6bb9a186265576aa3d1916df1cd4bb2dbd511f91a8e0f"}],"page":"https://bragproof.smaverk.com/r/project-mcp"}