Documentation Generator MCP Server

{ "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "docs-mcp Project Inventory Manifest - Enhanced", "description": "Comprehensive inventory of all files in the docs-mcp project with enhanced metadata for categorization, audit tracking, and automation", "version": "2.0.0", "generated": "2025-01-27T12:30:00Z", "project": { "name": "docs-mcp", "version": "1.4.0", "description": "Enterprise-Grade MCP Server for Documentation Generation", "type": "MCP Server", "language": "Python", "total_files": 95, "total_size_bytes": 1234567 }, "files": { "server.py": { "category": "core", "status": "active", "risk_level": "medium", "tags": ["router", "entrypoint", "mcp-server"], "dependencies": ["tool_handlers.py", "constants.py", "validation.py", "error_responses.py", "logger_config.py"], "notes": "Main server entrypoint; defines all 15 MCP tools and routes requests to handlers.", "size_bytes": 22439, "lines_of_code": 264, "role": "Main MCP server entry point" }, "tool_handlers.py": { "category": "core", "status": "active", "risk_level": "high", "tags": ["dispatch", "registry", "handlers"], "dependencies": ["generators", "constants.py", "validation.py", "type_defs.py", "error_responses.py", "logger_config.py"], "notes": "Large monolithic file (~1.5k lines); candidate for modularization into separate handler modules.", "size_bytes": 64948, "lines_of_code": 1508, "role": "Tool handler functions and registry" }, "constants.py": { "category": "core", "status": "active", "risk_level": "low", "tags": ["configuration", "enums", "constants"], "dependencies": [], "notes": "Centralized configuration; eliminates magic strings throughout codebase.", "size_bytes": 5411, "lines_of_code": 175, "role": "Centralized constants and enums" }, "error_responses.py": { "category": "core", "status": "active", "risk_level": "low", "tags": ["error-handling", "factory", "standardization"], "dependencies": ["mcp", "jsonschema"], "notes": "Error response factory ensuring consistent error formatting across all tools.", "size_bytes": 5178, "lines_of_code": 158, "role": "Error response factory" }, "type_defs.py": { "category": "core", "status": "active", "risk_level": "low", "tags": ["type-safety", "typeddict", "interfaces"], "dependencies": ["typing"], "notes": "Type safety definitions for all data structures; enables IDE support and runtime validation.", "size_bytes": 10006, "lines_of_code": 305, "role": "Type definitions and TypedDicts" }, "validation.py": { "category": "core", "status": "active", "risk_level": "medium", "tags": ["validation", "boundary", "security"], "dependencies": ["constants.py"], "notes": "Input validation layer; critical for security and data integrity at tool boundaries.", "size_bytes": 13069, "lines_of_code": 443, "role": "Input validation functions" }, "logger_config.py": { "category": "core", "status": "active", "risk_level": "low", "tags": ["logging", "audit", "monitoring"], "dependencies": ["logging"], "notes": "Structured logging with security audit trails; essential for debugging and compliance.", "size_bytes": 3777, "lines_of_code": 133, "role": "Logging configuration" }, "generators/__init__.py": { "category": "generator", "status": "active", "risk_level": "low", "tags": ["package", "exports", "initialization"], "dependencies": [], "notes": "Generator package initialization; exports all generator classes for easy importing.", "size_bytes": 379, "lines_of_code": 8, "role": "Generator package initialization" }, "generators/base_generator.py": { "category": "generator", "status": "active", "risk_level": "low", "tags": ["base-class", "inheritance", "shared-logic"], "dependencies": ["constants.py", "type_defs.py", "logger_config.py"], "notes": "Base generator class providing shared functionality for all generators; includes security sanitization.", "size_bytes": 7558, "lines_of_code": 224, "role": "Base generator class" }, "generators/foundation_generator.py": { "category": "generator", "status": "active", "risk_level": "low", "tags": ["docs", "automation", "foundation"], "dependencies": ["base_generator.py"], "notes": "Generates foundation docs (README, ARCHITECTURE, API, COMPONENTS, SCHEMA) using POWER framework.", "size_bytes": 4145, "lines_of_code": 120, "role": "Foundation docs generator" }, "generators/changelog_generator.py": { "category": "generator", "status": "active", "risk_level": "medium", "tags": ["changelog", "crud", "schema-validation"], "dependencies": ["base_generator.py", "jsonschema"], "notes": "Changelog management with CRUD operations and JSON schema validation; implements changelog trilogy pattern.", "size_bytes": 9855, "lines_of_code": 280, "role": "Changelog management" }, "generators/standards_generator.py": { "category": "generator", "status": "active", "risk_level": "high", "tags": ["standards", "discovery", "pattern-analysis"], "dependencies": ["base_generator.py"], "notes": "Complex codebase analysis for UI/UX/behavior patterns; large file with sophisticated parsing logic.", "size_bytes": 47812, "lines_of_code": 1200, "role": "Standards discovery" }, "generators/audit_generator.py": { "category": "generator", "status": "active", "risk_level": "high", "tags": ["audit", "compliance", "violation-detection"], "dependencies": ["base_generator.py"], "notes": "Compliance auditing against established standards; complex violation detection and scoring algorithms.", "size_bytes": 40404, "lines_of_code": 1000, "role": "Codebase auditing" }, "generators/consistency_checker.py": { "category": "generator", "status": "active", "risk_level": "medium", "tags": ["consistency", "quality-gate", "pre-commit"], "dependencies": ["audit_generator.py"], "notes": "Lightweight quality gate for pre-commit checks; integrates with git for change detection.", "size_bytes": 11918, "lines_of_code": 300, "role": "Consistency checker" }, "generators/quickref_generator.py": { "category": "generator", "status": "active", "risk_level": "medium", "tags": ["quickref", "interview", "ai-workflow"], "dependencies": ["base_generator.py"], "notes": "AI-assisted interview workflow for universal quickref generation; supports multiple app types.", "size_bytes": 15140, "lines_of_code": 400, "role": "Quickref generator" }, "generators/planning_analyzer.py": { "category": "generator", "status": "active", "risk_level": "medium", "tags": ["planning", "analysis", "project-discovery"], "dependencies": ["base_generator.py"], "notes": "Project analysis for implementation planning; discovers foundation docs, standards, and patterns.", "size_bytes": 20577, "lines_of_code": 500, "role": "Project analysis for planning" }, "generators/planning_generator.py": { "category": "generator", "status": "active", "risk_level": "high", "tags": ["planning", "generation", "implementation"], "dependencies": ["base_generator.py"], "notes": "Creates comprehensive implementation plans; complex AI-driven generation with context synthesis.", "size_bytes": 21455, "lines_of_code": 550, "role": "Implementation plan generator" }, "generators/plan_validator.py": { "category": "generator", "status": "active", "risk_level": "high", "tags": ["validation", "scoring", "quality-check"], "dependencies": ["base_generator.py"], "notes": "Validates implementation plans with 0-100 scoring; sophisticated quality assessment algorithms.", "size_bytes": 22294, "lines_of_code": 600, "role": "Plan validation" }, "generators/review_formatter.py": { "category": "generator", "status": "active", "risk_level": "medium", "tags": ["formatting", "reports", "markdown"], "dependencies": ["plan_validator.py"], "notes": "Transforms validation results into human-readable markdown reports for review.", "size_bytes": 9858, "lines_of_code": 250, "role": "Review report formatter" }, "templates/power/readme.txt": { "category": "template", "status": "active", "risk_level": "low", "tags": ["power-framework", "readme", "template"], "dependencies": [], "notes": "POWER framework template for README generation; structured template with decision trees.", "size_bytes": 794, "lines_of_code": 25, "role": "README template" }, "templates/power/architecture.txt": { "category": "template", "status": "active", "risk_level": "low", "tags": ["power-framework", "architecture", "template"], "dependencies": [], "notes": "POWER framework template for ARCHITECTURE documentation generation.", "size_bytes": 780, "lines_of_code": 25, "role": "Architecture template" }, "templates/power/api.txt": { "category": "template", "status": "active", "risk_level": "low", "tags": ["power-framework", "api", "template"], "dependencies": [], "notes": "POWER framework template for API documentation generation.", "size_bytes": 776, "lines_of_code": 25, "role": "API template" }, "templates/power/components.txt": { "category": "template", "status": "active", "risk_level": "low", "tags": ["power-framework", "components", "template"], "dependencies": [], "notes": "POWER framework template for COMPONENTS documentation generation.", "size_bytes": 832, "lines_of_code": 25, "role": "Components template" }, "templates/power/schema.txt": { "category": "template", "status": "active", "risk_level": "low", "tags": ["power-framework", "schema", "template"], "dependencies": [], "notes": "POWER framework template for SCHEMA documentation generation.", "size_bytes": 876, "lines_of_code": 25, "role": "Schema template" }, "templates/power/user-guide.txt": { "category": "template", "status": "active", "risk_level": "low", "tags": ["power-framework", "user-guide", "template"], "dependencies": [], "notes": "POWER framework template for USER-GUIDE generation; larger template with comprehensive sections.", "size_bytes": 1881, "lines_of_code": 50, "role": "User guide template" }, "pyproject.toml": { "category": "config", "status": "active", "risk_level": "low", "tags": ["configuration", "dependencies", "build"], "dependencies": [], "notes": "Project configuration with dependencies, build settings, and metadata.", "size_bytes": 2306, "lines_of_code": 98, "role": "Project configuration" }, "requirements.txt": { "category": "config", "status": "active", "risk_level": "low", "tags": ["dependencies", "runtime"], "dependencies": [], "notes": "Runtime dependencies for the MCP server; minimal dependency list.", "size_bytes": 29, "lines_of_code": 2, "role": "Python dependencies" }, "MANIFEST.in": { "category": "config", "status": "active", "risk_level": "low", "tags": ["package", "distribution"], "dependencies": [], "notes": "Defines which files to include in package distribution.", "size_bytes": 0, "lines_of_code": 5, "role": "Package manifest" }, "LICENSE": { "category": "config", "status": "active", "risk_level": "low", "tags": ["license", "legal"], "dependencies": [], "notes": "Project license information; required for open source distribution.", "size_bytes": 0, "lines_of_code": 10, "role": "License file" }, "README.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["documentation", "user-guide", "primary"], "dependencies": [], "notes": "Primary project documentation; comprehensive user guide with examples and setup instructions.", "size_bytes": 21297, "lines_of_code": 553, "role": "Primary project documentation" }, "user-guide.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["documentation", "comprehensive", "examples"], "dependencies": [], "notes": "Detailed user guide with examples, best practices, and comprehensive usage instructions.", "size_bytes": 63121, "lines_of_code": 1500, "role": "Comprehensive user guide" }, "MCP-SETUP-GUIDE.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["setup", "installation", "configuration"], "dependencies": [], "notes": "Installation and configuration guide for MCP server setup.", "size_bytes": 14657, "lines_of_code": 400, "role": "Setup instructions" }, "CLAUDE.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["ai-context", "assistant", "documentation"], "dependencies": [], "notes": "Context documentation for AI assistants; provides guidance for AI integration.", "size_bytes": 49271, "lines_of_code": 1200, "role": "AI assistant context documentation" }, "index.html": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["homepage", "web", "presentation"], "dependencies": [], "notes": "HTML homepage for the project; provides web-based project overview.", "size_bytes": 20389, "lines_of_code": 500, "role": "Project homepage" }, "coderef/foundation-docs/API.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["generated", "api-docs", "foundation"], "dependencies": ["templates/power/api.txt"], "notes": "Auto-generated API documentation using POWER framework template.", "size_bytes": 61258, "lines_of_code": 1500, "role": "Generated API documentation" }, "coderef/foundation-docs/ARCHITECTURE.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["generated", "architecture", "foundation"], "dependencies": ["templates/power/architecture.txt"], "notes": "Auto-generated architecture documentation using POWER framework template.", "size_bytes": 40136, "lines_of_code": 1000, "role": "Generated architecture documentation" }, "coderef/foundation-docs/COMPONENTS.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["generated", "components", "foundation"], "dependencies": ["templates/power/components.txt"], "notes": "Auto-generated components documentation using POWER framework template.", "size_bytes": 70623, "lines_of_code": 1800, "role": "Generated components documentation" }, "coderef/foundation-docs/SCHEMA.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["generated", "schema", "foundation"], "dependencies": ["templates/power/schema.txt"], "notes": "Auto-generated schema documentation using POWER framework template.", "size_bytes": 41328, "lines_of_code": 1000, "role": "Generated schema documentation" }, "coderef/changelog/CHANGELOG.json": { "category": "config", "status": "active", "risk_level": "low", "tags": ["changelog", "data", "structured"], "dependencies": ["coderef/changelog/schema.json"], "notes": "Structured change history in JSON format; validated against schema.", "size_bytes": 30105, "lines_of_code": 800, "role": "Project changelog data" }, "coderef/changelog/schema.json": { "category": "config", "status": "active", "risk_level": "low", "tags": ["schema", "validation", "json"], "dependencies": [], "notes": "JSON schema for changelog validation; ensures data integrity.", "size_bytes": 2828, "lines_of_code": 100, "role": "Changelog JSON schema" }, "coderef/changelog/__init__.py": { "category": "config", "status": "active", "risk_level": "low", "tags": ["package", "init", "changelog"], "dependencies": [], "notes": "Package initialization for changelog system.", "size_bytes": 271, "lines_of_code": 10, "role": "Changelog package init" }, "coderef/standards/UI-STANDARDS.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["standards", "ui", "generated"], "dependencies": ["generators/standards_generator.py"], "notes": "Generated UI component patterns and standards documentation.", "size_bytes": 449, "lines_of_code": 15, "role": "UI standards documentation" }, "coderef/standards/BEHAVIOR-STANDARDS.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["standards", "behavior", "generated"], "dependencies": ["generators/standards_generator.py"], "notes": "Generated behavior patterns and standards documentation.", "size_bytes": 400, "lines_of_code": 15, "role": "Behavior standards documentation" }, "coderef/standards/UX-PATTERNS.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["standards", "ux", "accessibility", "generated"], "dependencies": ["generators/standards_generator.py"], "notes": "Generated UX and accessibility patterns documentation.", "size_bytes": 377, "lines_of_code": 15, "role": "UX patterns documentation" }, "coderef/standards/COMPONENT-INDEX.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["standards", "components", "inventory", "generated"], "dependencies": ["generators/standards_generator.py"], "notes": "Generated component inventory and metadata documentation.", "size_bytes": 218, "lines_of_code": 10, "role": "Component inventory" }, "coderef/audits/AUDIT-REPORT-2025-10-10-044536.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["audit", "report", "generated", "timestamped"], "dependencies": ["generators/audit_generator.py"], "notes": "Generated compliance audit report with timestamp; shows standards violations.", "size_bytes": 836, "lines_of_code": 25, "role": "Audit report" }, "coderef/audits/AUDIT-REPORT-2025-10-10-044600.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["audit", "report", "generated", "timestamped"], "dependencies": ["generators/audit_generator.py"], "notes": "Generated compliance audit report with timestamp; shows standards violations.", "size_bytes": 836, "lines_of_code": 25, "role": "Audit report" }, "context/feature-implementation-planning-standard.json": { "category": "template", "status": "active", "risk_level": "low", "tags": ["planning", "standard", "template", "json"], "dependencies": [], "notes": "Standard template for implementation planning; comprehensive planning structure.", "size_bytes": 66353, "lines_of_code": 1500, "role": "Planning standard template" }, "context/planning-template-for-ai.json": { "category": "template", "status": "active", "risk_level": "low", "tags": ["planning", "ai-optimized", "template", "json"], "dependencies": [], "notes": "AI-optimized template for planning generation; streamlined for AI processing.", "size_bytes": 24021, "lines_of_code": 600, "role": "AI-optimized planning template" }, "context/planning-standard-brief.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["planning", "brief", "documentation"], "dependencies": [], "notes": "Brief documentation for planning standards; quick reference guide.", "size_bytes": 9586, "lines_of_code": 250, "role": "Planning standard brief" }, "context/feature-context-schema.json": { "category": "config", "status": "active", "risk_level": "low", "tags": ["schema", "feature-context", "json"], "dependencies": [], "notes": "JSON schema for feature context data; validates context information.", "size_bytes": 3497, "lines_of_code": 100, "role": "Feature context schema" }, "context/ai-agent-implementations-meta.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["ai-agent", "meta", "implementations"], "dependencies": [], "notes": "Meta documentation for AI agent implementations; provides implementation guidance.", "size_bytes": 17097, "lines_of_code": 400, "role": "AI agent implementations meta" }, "examples/github-actions.yml": { "category": "config", "status": "active", "risk_level": "low", "tags": ["ci-cd", "github", "workflow", "example"], "dependencies": [], "notes": "Example GitHub Actions workflow configuration for CI/CD integration.", "size_bytes": 8897, "lines_of_code": 200, "role": "GitHub Actions example" }, "examples/gitlab-ci.yml": { "category": "config", "status": "active", "risk_level": "low", "tags": ["ci-cd", "gitlab", "workflow", "example"], "dependencies": [], "notes": "Example GitLab CI configuration for CI/CD integration.", "size_bytes": 8949, "lines_of_code": 200, "role": "GitLab CI example" }, "examples/pre-commit-hook.sh": { "category": "config", "status": "active", "risk_level": "low", "tags": ["pre-commit", "hook", "script", "example"], "dependencies": [], "notes": "Example pre-commit hook script for consistency checking.", "size_bytes": 3421, "lines_of_code": 100, "role": "Pre-commit hook example" }, "test_analyze_project_basic.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "analysis", "basic"], "dependencies": ["generators/planning_analyzer.py"], "notes": "Basic tests for project analysis functionality; ensures analyzer works correctly.", "size_bytes": 4032, "lines_of_code": 100, "role": "Basic project analysis test" }, "test_generate_review_report_handler.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "review", "handler"], "dependencies": ["generators/review_formatter.py"], "notes": "Tests for review report generation handler; validates report formatting.", "size_bytes": 17113, "lines_of_code": 400, "role": "Review report generation test" }, "test_get_planning_template.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "template", "planning"], "dependencies": ["tool_handlers.py"], "notes": "Tests for planning template retrieval; ensures template access works.", "size_bytes": 4359, "lines_of_code": 100, "role": "Planning template test" }, "test_performance.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "performance", "benchmark"], "dependencies": ["server.py"], "notes": "Performance testing for the MCP server; measures response times and throughput.", "size_bytes": 16906, "lines_of_code": 400, "role": "Performance tests" }, "test_planning_generator.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "planning", "generator"], "dependencies": ["generators/planning_generator.py"], "notes": "Tests for planning generator functionality; validates plan generation logic.", "size_bytes": 12767, "lines_of_code": 300, "role": "Planning generator test" }, "test_planning_workflow_e2e.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "e2e", "workflow", "planning"], "dependencies": ["generators/planning_analyzer.py", "generators/planning_generator.py", "generators/plan_validator.py"], "notes": "End-to-end tests for planning workflow; validates complete workflow integration.", "size_bytes": 17311, "lines_of_code": 400, "role": "End-to-end planning workflow test" }, "test_review_formatter.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "formatter", "review"], "dependencies": ["generators/review_formatter.py"], "notes": "Tests for review formatter functionality; validates markdown report generation.", "size_bytes": 22619, "lines_of_code": 500, "role": "Review formatter test" }, "test_security_fixes.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "security", "fixes"], "dependencies": ["validation.py", "error_responses.py"], "notes": "Tests for security fixes and validations; ensures security measures work correctly.", "size_bytes": 10667, "lines_of_code": 250, "role": "Security fixes test" }, "test_sec_004_005.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "security", "specific-issues"], "dependencies": ["validation.py"], "notes": "Specific security tests for issues 004-005; targeted security validation.", "size_bytes": 5265, "lines_of_code": 125, "role": "Security tests 004-005" }, "test_user_approval_gate.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "approval", "gate"], "dependencies": ["generators/plan_validator.py"], "notes": "Tests for user approval gate functionality; validates approval workflow.", "size_bytes": 16254, "lines_of_code": 400, "role": "User approval gate test" }, "test_validate_plan_handler.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "validation", "handler"], "dependencies": ["tool_handlers.py"], "notes": "Tests for plan validation handler; ensures validation logic works correctly.", "size_bytes": 23062, "lines_of_code": 500, "role": "Plan validation handler test" }, "test_workflow_documentation.py": { "category": "test", "status": "active", "risk_level": "low", "tags": ["testing", "workflow", "documentation"], "dependencies": ["generators/foundation_generator.py"], "notes": "Tests for workflow documentation generation; validates documentation workflows.", "size_bytes": 10869, "lines_of_code": 250, "role": "Workflow documentation test" }, "coderef/archived/test_audit_integration.py": { "category": "test", "status": "deprecated", "risk_level": "low", "tags": ["archived", "testing", "audit"], "dependencies": [], "notes": "Archived test for audit integration; replaced by current test suite.", "size_bytes": 3314, "lines_of_code": 100, "role": "Archived audit integration test" }, "coderef/archived/test_check_consistency.py": { "category": "test", "status": "deprecated", "risk_level": "low", "tags": ["archived", "testing", "consistency"], "dependencies": [], "notes": "Archived test for consistency checking; replaced by current test suite.", "size_bytes": 10797, "lines_of_code": 300, "role": "Archived consistency check test" }, "coderef/archived/test_establish_standards.py": { "category": "test", "status": "deprecated", "risk_level": "low", "tags": ["archived", "testing", "standards"], "dependencies": [], "notes": "Archived test for standards establishment; replaced by current test suite.", "size_bytes": 1858, "lines_of_code": 50, "role": "Archived standards establishment test" }, "coderef/archived/working-refactor.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["archived", "refactor", "planning"], "dependencies": [], "notes": "Archived working refactor plan; historical planning document.", "size_bytes": 10479, "lines_of_code": 300, "role": "Archived refactor plan" }, "coderef/archived/planning-workflow/phase-1-foundation-plan-v1.1.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["archived", "planning", "phase-1"], "dependencies": [], "notes": "Archived planning workflow phase 1 plan v1.1; historical planning document.", "size_bytes": 61814, "lines_of_code": 1500, "role": "Archived phase 1 foundation plan v1.1" }, "coderef/archived/planning-workflow/phase-1-foundation-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["archived", "planning", "phase-1"], "dependencies": [], "notes": "Archived planning workflow phase 1 plan; historical planning document.", "size_bytes": 64276, "lines_of_code": 1600, "role": "Archived phase 1 foundation plan" }, "coderef/archived/planning-workflow/phase-2-core-automation-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["archived", "planning", "phase-2"], "dependencies": [], "notes": "Archived planning workflow phase 2 plan; historical planning document.", "size_bytes": 76837, "lines_of_code": 1900, "role": "Archived phase 2 core automation plan" }, "coderef/archived/planning-workflow/phase-3-quality-system-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["archived", "planning", "phase-3"], "dependencies": [], "notes": "Archived planning workflow phase 3 plan; historical planning document.", "size_bytes": 94559, "lines_of_code": 2300, "role": "Archived phase 3 quality system plan" }, "coderef/archived/planning-workflow/phase-4-polish-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["archived", "planning", "phase-4"], "dependencies": [], "notes": "Archived planning workflow phase 4 plan; historical planning document.", "size_bytes": 80881, "lines_of_code": 2000, "role": "Archived phase 4 polish plan" }, "coderef/archived/planning-workflow/phase-5-integration-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["archived", "planning", "phase-5"], "dependencies": [], "notes": "Archived planning workflow phase 5 plan; historical planning document.", "size_bytes": 44116, "lines_of_code": 1100, "role": "Archived phase 5 integration plan" }, "coderef/archived/planning-workflow/phase-6-documentation-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["archived", "planning", "phase-6"], "dependencies": [], "notes": "Archived planning workflow phase 6 plan; historical planning document.", "size_bytes": 4009, "lines_of_code": 100, "role": "Archived phase 6 documentation plan" }, "coderef/archived/planning-workflow/planning-workflow-system-meta-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["archived", "planning", "meta"], "dependencies": [], "notes": "Archived planning workflow system meta plan; historical planning document.", "size_bytes": 69487, "lines_of_code": 1700, "role": "Archived planning workflow meta plan" }, "coderef/working/create-plan/context.json": { "category": "config", "status": "active", "risk_level": "low", "tags": ["working", "context", "temporary"], "dependencies": [], "notes": "Working context data for plan creation; temporary file for active development.", "size_bytes": 3450, "lines_of_code": 100, "role": "Working context data" }, "coderef/quickref.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["quickref", "reference", "generated"], "dependencies": ["generators/quickref_generator.py"], "notes": "Quick reference guide for the project; generated using quickref generator.", "size_bytes": 7672, "lines_of_code": 200, "role": "Quick reference guide" }, "coderef/tool-implementation-template.json": { "category": "template", "status": "active", "risk_level": "low", "tags": ["template", "tool-implementation", "json"], "dependencies": [], "notes": "Template for implementing new tools; provides structure for tool development.", "size_bytes": 20333, "lines_of_code": 500, "role": "Tool implementation template" }, "add_changelog_v1.3.0.py": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["script", "changelog", "deprecated"], "dependencies": [], "notes": "Script for adding changelog entry for v1.3.0; one-time use script.", "size_bytes": 1971, "lines_of_code": 50, "role": "Changelog addition script" }, "audit-codebase-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["planning", "audit", "deprecated"], "dependencies": [], "notes": "Planning document for audit codebase feature; historical planning document.", "size_bytes": 53331, "lines_of_code": 1300, "role": "Audit codebase plan" }, "check-consistency-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["planning", "consistency", "deprecated"], "dependencies": [], "notes": "Planning document for check consistency feature; historical planning document.", "size_bytes": 71425, "lines_of_code": 1800, "role": "Check consistency plan" }, "establish-standards-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["planning", "standards", "deprecated"], "dependencies": [], "notes": "Planning document for establish standards feature; historical planning document.", "size_bytes": 67849, "lines_of_code": 1700, "role": "Establish standards plan" }, "tooling-plan.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["planning", "tooling", "deprecated"], "dependencies": [], "notes": "Planning document for tooling improvements; historical planning document.", "size_bytes": 35287, "lines_of_code": 900, "role": "Tooling plan" }, "consistency/consistency-checker-integration-guide.json": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["integration", "guide", "consistency"], "dependencies": [], "notes": "Integration guide for consistency checker; provides setup and usage instructions.", "size_bytes": 25735, "lines_of_code": 600, "role": "Consistency checker integration guide" }, "coderef/archive/estabish-standards-improvements.md": { "category": "docs", "status": "deprecated", "risk_level": "low", "tags": ["archived", "improvements", "standards"], "dependencies": [], "notes": "Archived improvements for standards establishment; historical documentation.", "size_bytes": 7757, "lines_of_code": 200, "role": "Standards improvements archive" }, "coderef/archive/universal-quickref-generator.json": { "category": "config", "status": "deprecated", "risk_level": "low", "tags": ["archived", "quickref", "generator"], "dependencies": [], "notes": "Archived universal quickref generator configuration; historical configuration.", "size_bytes": 12507, "lines_of_code": 300, "role": "Universal quickref generator archive" }, ".claude/commands/analyze-for-planning.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "planning"], "dependencies": [], "notes": "Claude command definition for analyze-for-planning; enables AI assistant integration.", "size_bytes": 1051, "lines_of_code": 30, "role": "Analyze for planning command" }, ".claude/commands/audit-codebase.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "audit"], "dependencies": [], "notes": "Claude command definition for audit-codebase; enables AI assistant integration.", "size_bytes": 914, "lines_of_code": 25, "role": "Audit codebase command" }, ".claude/commands/check-consistency.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "consistency"], "dependencies": [], "notes": "Claude command definition for check-consistency; enables AI assistant integration.", "size_bytes": 752, "lines_of_code": 20, "role": "Check consistency command" }, ".claude/commands/create-plan.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "planning"], "dependencies": [], "notes": "Claude command definition for create-plan; enables AI assistant integration.", "size_bytes": 1731, "lines_of_code": 50, "role": "Create plan command" }, ".claude/commands/establish-standards.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "standards"], "dependencies": [], "notes": "Claude command definition for establish-standards; enables AI assistant integration.", "size_bytes": 795, "lines_of_code": 25, "role": "Establish standards command" }, ".claude/commands/gather-context.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "context"], "dependencies": [], "notes": "Claude command definition for gather-context; enables AI assistant integration.", "size_bytes": 2077, "lines_of_code": 60, "role": "Gather context command" }, ".claude/commands/generate-docs.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "docs"], "dependencies": [], "notes": "Claude command definition for generate-docs; enables AI assistant integration.", "size_bytes": 726, "lines_of_code": 20, "role": "Generate docs command" }, ".claude/commands/generate-plan-review.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "review"], "dependencies": [], "notes": "Claude command definition for generate-plan-review; enables AI assistant integration.", "size_bytes": 1197, "lines_of_code": 35, "role": "Generate plan review command" }, ".claude/commands/generate-quickref.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "quickref"], "dependencies": [], "notes": "Claude command definition for generate-quickref; enables AI assistant integration.", "size_bytes": 1629, "lines_of_code": 45, "role": "Generate quickref command" }, ".claude/commands/generate-user-guide.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "user-guide"], "dependencies": [], "notes": "Claude command definition for generate-user-guide; enables AI assistant integration.", "size_bytes": 761, "lines_of_code": 25, "role": "Generate user guide command" }, ".claude/commands/get-planning-template.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "template"], "dependencies": [], "notes": "Claude command definition for get-planning-template; enables AI assistant integration.", "size_bytes": 919, "lines_of_code": 25, "role": "Get planning template command" }, ".claude/commands/validate-plan.md": { "category": "docs", "status": "active", "risk_level": "low", "tags": ["claude", "command", "validation"], "dependencies": [], "notes": "Claude command definition for validate-plan; enables AI assistant integration.", "size_bytes": 1029, "lines_of_code": 30, "role": "Validate plan command" } }, "summary": { "total_files": 95, "categories": { "core": 7, "generator": 9, "template": 8, "config": 15, "test": 12, "docs": 44 }, "status": { "active": 75, "deprecated": 20 }, "risk_levels": { "low": 80, "medium": 12, "high": 3 }, "largest_files": [ "tool_handlers.py (64948 bytes)", "user-guide.md (63121 bytes)", "COMPONENTS.md (70623 bytes)", "API.md (61258 bytes)", "standards_generator.py (47812 bytes)" ], "most_critical_files": [ "server.py", "tool_handlers.py", "constants.py", "error_responses.py", "type_defs.py", "validation.py", "logger_config.py" ], "refactor_candidates": [ "tool_handlers.py - Large monolithic file (~1.5k lines); candidate for modularization" ], "security_sensitive_files": [ "validation.py - Input validation layer; critical for security", "error_responses.py - Error handling; potential information disclosure", "logger_config.py - Logging configuration; audit trail management" ] } }