Two tools with basic schemas but significant quality gaps. count_lines has minimal description (11 chars, below 20-char threshold). append_file has good description (180 chars) and comprehensive parameter documentation, but count_lines lacks parameter descriptions entirely. No output schemas documented for either tool. No error handling guidance. Naming is verb-noun compliant but generic. No tool annotations (readOnlyHint/destructiveHint). Missing idempotency guidance for append_file despite being a write operation.

• Expand count_lines description to 50-150 chars: 'Count the number of lines in a text file. Returns the total line count. Use this to inspect file size before processing. Requires read access to the file.'
• Add parameter description for count_lines.path: 'Absolute or relative path to a text file within the workspace. Must be readable and exist.'
• Document output schemas for both tools. E.g., count_lines returns {line_count: int, file_path: str}; append_file returns {success: bool, new_file_size: int, lines_added: int}.
• Add error handling to append_file description: 'If file does not exist and create_if_missing=false, returns error. If path is outside workspace, returns permission error. Idempotent only if content is identical.'
• Add tool annotations via fastmcp: mark append_file with @tool(destructiveHint=True) and document that repeated calls with identical content are safe but will duplicate text if content differs.