Project Files

.pydev-tools

_ast

describe.py

do_work.py

docstrings.py

extract_function.py

extract.py

legacy_handler_2.py

legacy_handler_3.py

legacy_handler.py

migration.py

reference.py

rename.py

workspace_description.md

prompt_examples

dependency_version_migration.txt

hotfix_rework.txt

new_project.txt

performance_optimization.txt

refactory.txt

security_hardening.txt

source_tree_analysis.txt

test_coverage_expansion.txt

scripts

e2e_runPytest_test.cjs

setupVenv.mjs

smokeNew6Tools.ts

smokeNewTools.ts

verify_testfile_fix.ts

verifySetupVenv.ts

skills

pydev-mcp.md

src

tools

_profiling_worker_main.py

analyzeImportsAndDependencies.ts

buildPythonPackage.ts

checkForBugs.ts

checkForBugsInFile.ts

createProjectStructure.ts

createTestFileTool.ts

editTextFile.ts

editTextFileByLine.ts

findFiles.ts

generateRequirementsTxtTool.ts

getSetupStatusTool.ts

getWorkspaceRootTool.ts

inspectEnvironmentTool.ts

installModule.ts

listDirectory.ts

listTools.ts

profileProject.ts

pydevAuditDocstringsTool.ts

pydevDescribeWorkspaceTool.ts

pydevExtractFunctionTool.ts

pydevGenerateReferenceTool.ts

pydevMigrationAuditTool.ts

pydevSafeRenameTool.ts

readTextFile.ts

runLinterAndFormatter.ts

runLinterAndFormatterInFile.ts

runProjectCoverage.ts

runPython.ts

runPythonFile.ts

runPythonFileInteractive.ts

runPythonInteractive.ts

runRepl.ts

runTests.ts

runWithDebuggerTool.ts

saveTextFile.ts

scanProjectSecurity.ts

searchDirectory.ts

setupVenvTool.ts

switchPythonVersion.ts

typeCheckProjectTool.ts

uninstallModule.ts

config.ts

index.ts

test

run_tests.cjs

tools.test.cjs

manifest.json

package-lock.json

package.json

professor_headache.jpg

README.md

setup-venv.sh

tsconfig.json

prompt_examples / source_tree_analysis.txt

Use the `pydev-mcp` MCP tools to perform a comprehensive audit and architecture analysis of the existing codebase.

Follow these steps in order:

1. **Environment Verification**:
   - Call `pydev_get_workspace_root` and `pydev_get_setup_status` to confirm the active environment.
2. **Codebase Discovery**:
   - Use `pydev_list_directory` recursively to map the entire project structure.
   - Use `pydev_find_files` to identify all Python source files.
   - Use `pydev_describe_workspace` to get a high-level overview of purposes and dependencies.
3. **Deep Analysis**:
   - Search for key definitions and entry points using `pydev_search_directory`.
   - Use `pydev_audit_docstrings` to identify missing or stale documentation.
   - Use `pydev_analyze_imports_and_dependencies` on core modules to check for missing packages.
4. **Health & Security Audit**:
   - Run `pydev_check_for_bugs_in_file` on core source files.
   - Run `pydev_scan_security` across the entire target path.
   - Run `pydev_type_check` to identify type inconsistencies.
5. **Reporting**:
   - Create `doc/AUDIT-REPORT.md` which must include:
     - A high-level architecture summary.
     - A list of all identified modules and their responsibilities.
     - A summary of security vulnerabilities (High/Medium/Low).
     - A report on docstring coverage and missing type hints.
     - A summary of any missing dependencies found during analysis.

Do not modify any source code during this process. Confirm the result of each step before proceeding to the next one.