Contextor v1.0.4 - patch v1.0.3

Contextor transforms complex Python repositories into structured architectural context that both developers and Large Language Models (LLMs) can understand. It generates JSON reports - you can give access to the path of Output json reports folder to LLM working directly in your repo. This way you spare tokens required by LLM for full structural analysis of the code base. Contextor statically extracts deep Python AST semantics to feed LLMs token-efficient context—offering multi-level granularity (entire repo, layer slice, single file, or individual symbol), exact artifact consumption and call-chain tracking, consumer counts, entry chain mapping, cycle detection, high-coupling hotspot identification, blast radius and impact depth analysis, global variable mutation tracking, cyclomatic control flow analysis, callback/event binding extraction, name collision detection, dead code / unused API identification, automated refactoring action items, untested public API identification, test-to-code mappingand, core extraction candidate suggestions.

Why I built Contextor:

Feeding entire codebases into LLMs eats thousands of tokens and often misses architectural context (like cycle risks or high-coupling hotspots).

The output:

It generates structured JSON/Markdown context snapshots (and compact indexed reports) that give LLMs architectural awareness.

Features a Tkinter GUI and CLI. Built in pure Python.

OPTIONS:

Flexible Granularity — Name Your Scope:

1. Entire Repository:

Map the complete dependency graph, hotspot topology, and overall tech debt. Selected Layer: Slice and analyze a specific package or directory relative to the rest of the project. Single File: Deep-dive into purpose, semantic flow, blast radius, and entry chains for a target module. Individual Symbol: Track precise ownership, API consumers, calls, and usage across the codebase down to a single class, function, or variable. Analyze at any scale — just name it.

2. Short One-Liner Multi-Level Architectural Analysis:

Analyze the entire codebase, slice a specific layer, inspect a single file, or trace an individual symbol — full architectural awareness at whatever level of granularity you need.

3.Technical & Concise Context at Any Scope:

Whether you need a macro-level overview of the entire repository, a layer-bounded slice, a single-file semantic deep dive, or symbol-level artifact consumption tracking — Contextor delivers precise, token-efficient context. Simply pick your granularity.

🚀 Release Notes - Multi-Threading Engine, Performance Boost & UI/UX Upgrade
⚡ Performance & Architecture

Multi-Threaded Scanning Engine: Rebuilt the core repository indexing and parsing pipeline to utilize true multi-threading. The application now processes multiple files concurrently across available CPU cores, resulting in a monumental, multi-fold increase in scanning speed compared to the previous single-threaded approach.
Live Threads Indicator: Added a real-time CPU/Threads indicator to the main GUI dashboard, providing immediate visual feedback on current thread utilization and concurrent processing activity during analysis.
Event Loop Throttling (Speed Unlocker): Fixed a critical bottleneck where the new multi-threaded engine was flooding the GUI with thousands of redraw requests. By implementing a 10 FPS rate-limiter for background progress updates, CPU resources are now fully dedicated to backend processing rather than rendering, unlocking the true speed of the concurrent engine.

✨ Features & Enhancements:

Console Window Management: Contextor will now boot up purely as a graphical application on Windows without leaving a lingering CMD terminal window in the background.
"Open CMD Log" Toggle: Added a new "Open CMD log" checkbox directly in the main GUI header. This allows you to smoothly toggle the visibility of the backend terminal on and off whenever you need to inspect raw execution logs.
Aggressive Cleanup on Exit: Closing the main GUI will now force an immediate, clean termination of all underlying threads and processes (os._exit), preventing zombie processes and stray terminal windows from hanging in the background.
Progress Percentage Readability: Repositioned the completion percentage indicator ([XX.X%]) to sit cleanly next to the ETA timer instead of jumping around at the end of file paths.
"Stop" Button: aborting the ongoing process of analysis.

🐛 Bug Fixes & Stability:

Progress Bar Jitter Fix: Deeply nested file paths shown during analysis are now cleanly truncated
(e.g. .../module/file.py). Furthermore, the UI labels have been given fixed spatial widths, completely fixing the annoying bug where the main window's right edge would frantically stretch and shrink to accommodate long paths.
Legacy Code Cleanup: Removed obsolete and broken fallback scripts from the main.py entry point that were previously causing erratic application behaviors and syntax errors.

Contextor v1.0.3 - patch v1.0.2

Contextor
(patch v1.0.2)

Contextor is a static Python repository analysis tool that generates architectural context for developers and Large Language Models (LLMs).

Features:

• Static Python repository analysis
• AST-based source inspection
• Dependency graph generation
• Symbol ownership and usage tracking
• Architectural debt analysis
• Circular dependency detection
• Namespace collision detection
• LLM-ready JSON reports
• GUI and CLI interfaces

Patch Notes: major overhaul and general improvements to the Repo Builder window for better stability and smoother user experience. Direct Path Pasting: added support for pasting full, absolute file paths directly into the repository structure list, streamlining the workflow for adding specific files to Repo Builder files / folders section.
Real-time Metrics Estimation: introduced dynamic calculation of the estimated output file size and the expected number of lines, providing better visibility before building the repository in Repo Builder GUI.

Contextor v1.0.1 - Repo Builder patch v1.0.0

Contextor
(Repo Builder patch v1.0.0)

Contextor is a static Python repository analysis tool that generates architectural context for developers and Large Language Models (LLMs).

Features:

• Static Python repository analysis
• AST-based source inspection
• Dependency graph generation
• Symbol ownership and usage tracking
• Architectural debt analysis
• Circular dependency detection
• Namespace collision detection
• LLM-ready JSON reports
• GUI and CLI interfaces

This release includes Repo Builder GUI updated with possibility of automatic output file split into packages of predefined size.

Contextor v1.0.0 - Initial Release

Initial public release of Contextor.

Contextor is a static Python repository analysis tool that generates architectural context for developers and Large Language Models (LLMs).

Features:

• Static Python repository analysis
• AST-based source inspection
• Dependency graph generation
• Symbol ownership and usage tracking
• Architectural debt analysis
• Circular dependency detection
• Namespace collision detection
• LLM-ready JSON reports
• GUI and CLI interfaces

This release represents the first public version of Contextor.

Contextor v1.0.2 - JSON parser patch v1.0.1

Contextor
(Repo Builder patch v1.0.1)

Contextor is a static Python repository analysis tool that generates architectural context for developers and Large Language Models (LLMs).

Features:

• Static Python repository analysis
• AST-based source inspection
• Dependency graph generation
• Symbol ownership and usage tracking
• Architectural debt analysis
• Circular dependency detection
• Namespace collision detection
• LLM-ready JSON reports
• GUI and CLI interfaces

This release includes Parse Json GUI updated for operations asynchronous to main GUI.