Documentation Generator MCP Server

{ "$schema": "http://json-schema.org/draft-07/schema#", "title": "Project Inventory Manifest Schema", "description": "Schema for comprehensive project file inventory manifests", "type": "object", "required": ["project_name", "project_path", "generated_at", "analysis_depth", "metrics", "files"], "properties": { "project_name": { "type": "string", "description": "Name of the project", "minLength": 1 }, "project_path": { "type": "string", "description": "Absolute path to project directory", "minLength": 1 }, "generated_at": { "type": "string", "description": "ISO 8601 timestamp when manifest was generated", "format": "date-time" }, "analysis_depth": { "type": "string", "description": "Depth of analysis performed", "enum": ["quick", "standard", "deep"] }, "metrics": { "type": "object", "description": "Project-level metrics and health indicators", "required": ["total_files", "total_size", "total_lines"], "properties": { "total_files": { "type": "integer", "description": "Total number of files in project", "minimum": 0 }, "total_size": { "type": "integer", "description": "Total size of all files in bytes", "minimum": 0 }, "total_lines": { "type": "integer", "description": "Total lines of code across all files", "minimum": 0 }, "file_categories": { "type": "object", "description": "Count of files by category", "properties": { "core": {"type": "integer", "minimum": 0}, "source": {"type": "integer", "minimum": 0}, "template": {"type": "integer", "minimum": 0}, "config": {"type": "integer", "minimum": 0}, "test": {"type": "integer", "minimum": 0}, "docs": {"type": "integer", "minimum": 0} } }, "risk_distribution": { "type": "object", "description": "Count of files by risk level", "properties": { "low": {"type": "integer", "minimum": 0}, "medium": {"type": "integer", "minimum": 0}, "high": {"type": "integer", "minimum": 0}, "critical": {"type": "integer", "minimum": 0} } }, "language_breakdown": { "type": "object", "description": "Count of files by programming language", "additionalProperties": {"type": "integer", "minimum": 0} } } }, "files": { "type": "array", "description": "Array of file metadata objects", "items": { "type": "object", "required": ["path", "name", "extension", "size", "category", "risk_level"], "properties": { "path": { "type": "string", "description": "Relative path from project root", "minLength": 1 }, "name": { "type": "string", "description": "File name including extension", "minLength": 1 }, "extension": { "type": "string", "description": "File extension (e.g., .py, .js, .md)" }, "size": { "type": "integer", "description": "File size in bytes", "minimum": 0 }, "lines": { "type": "integer", "description": "Number of lines in file", "minimum": 0 }, "category": { "type": "string", "description": "File category using universal taxonomy", "enum": ["core", "source", "template", "config", "test", "docs", "unknown"] }, "risk_level": { "type": "string", "description": "Risk level based on file characteristics", "enum": ["low", "medium", "high", "critical"] }, "role": { "type": "string", "description": "Role or purpose of the file in the project" }, "description": { "type": "string", "description": "Brief description of file contents/purpose" }, "dependencies": { "type": "array", "description": "List of imports/dependencies detected in file", "items": { "type": "string" } }, "last_modified": { "type": "string", "description": "ISO 8601 timestamp of last modification", "format": "date-time" }, "language": { "type": "string", "description": "Primary programming language of the file" }, "complexity": { "type": "string", "description": "Complexity level (simple, moderate, complex)", "enum": ["simple", "moderate", "complex"] }, "sensitive": { "type": "boolean", "description": "Whether file contains sensitive data (credentials, keys, etc.)" } } } } } }