essage": "I'm starting the project brief interview process.", "expectationType": "immediate", "suggestedResponse": "I'll start the project brief interview process. I'll ask you a series of questions to gather information about your project. Let's begin with understanding your project overview." } } } } ] } ``` ### apm_project_brief_status **Purpose**: Get the status of a project brief interview operation.

Functional Details

When the `apm_project_brief_status` tool is called: 1. **Parameter Validation**: - Validates the `projectRoot` parameter (required, must be an absolute path) - Validates the `operationId` parameter (required, non-empty string) 2. **Status Retrieval**: - Gets the operation status from the AsyncOperationManager - Returns an error if the operation is not found - Provides detailed information about the current state of the operation 3. **Progress Reporting**: - Returns the current progress percentage (0-100) - Provides a descriptive message about the current stage - Includes timestamps for creation, updates, and completion (if applicable) 4. **User Communication Guidance**: - For running operations, provides suggested responses to keep users informed - For completed operations, suggests next steps - For failed operations, explains what went wrong and how to proceed 5. **Response Formatting**: - Returns a structured JSON response containing: - Operation ID - Current status (pending, running, completed, failed) - Progress percentage - Status message - Timestamps (created, updated, completed) - User communication guidance 6. **Error Handling**: - Handles cases where the operation is not found - Handles internal errors during status retrieval - Returns standardized error responses with context information ##### JSON-RPC Request ```json { "method": "apm_project_brief_status", "params": { "projectRoot": "/absolute/path/to/project", "operationId": "project-brief-123456" } } ``` ##### JSON-RPC Response ```json { "content": [ { "type": "text", "text": { "operationId": "project-brief-123456", "status": "running", "progress": 65, "message": "Generating tasks", "createdAt": "2023-06-15T10:30:00Z", "updatedAt": "2023-06-15T10:30:05Z", "completedAt": null, "metadata": { "operationType": "task-generation", "userCommunication": { "message": "Task generation is in progress.", "expectationType": "long_wait", "estimatedTimeSeconds": 180, "suggestedResponse": "The task generation is in progress (65% complete).\n\nWhile we wait, here's what's happening behind the scenes:\n- The AI is analyzing your project requirements\n- It's identifying key components, features, and dependencies\n- It will create a structured task breakdown with proper sequencing\n- Tasks will be saved to the apm-artifacts directory, along with an overall project brief.\n\nYou can ask me to \"check status\" anytime if you'd like an update, or we can discuss other aspects of your project while we wait." } } } } ] } ```

### apm_project_brief_result **Purpose**: Get the result of a completed project brief interview operation.

Functional Details

When the `apm_project_brief_result` tool is called: 1. **Parameter Validation**: - Validates the `projectRoot` parameter (required, must be an absolute path) - Validates the `operationId` parameter (required, non-empty string) 2. **Result Retrieval**: - Gets the operation result from the AsyncOperationManager - Returns an error if the result is not available (operation not completed or not found) - Returns an error if the operation failed 3. **Result Processing**: - Extracts the generated tasks from the operation result - Includes file paths to

#cline-ai

Chatty MCP

AgentPM