# Project Status & Roadmap

This file tracks the completed progress and upcoming development milestones for the AI-Enhanced CTF Toolchain.

---

## Current Status: Forensics Utilities Implemented 🚀

### Progress Made So Far
1.  **Project Structuring**: Set up a modern Python `src/` layout with `uv` as the package manager and `hatchling` as the build backend.
2.  **Config Management**: Implemented basic TOML configuration loading and writing functions in [utils.py](file:///home/venus/code/ctf/src/ctf/utils.py) using [config.toml](file:///home/venus/code/ctf/config.toml).
3.  **Directory Scanners**: Implemented functions to list active competitions and categories automatically skipping helper folders like `tools`.
4.  **CLI Entry Points & Subcommands**: Configured the Click main group in [main.py](file:///home/venus/code/ctf/src/ctf/main.py) to register nested subcommands properly.
5.  **Forensics Analysis (New)**: Implemented `ctf forensics info` and `ctf forensics flag-search` in [forensics.py](file:///home/venus/code/ctf/src/ctf/forensics.py) to inspect magic bytes/signatures, verify file extension matches, and search for flag pattern regular expressions.
6.  **Testing Environment**: Established a sandbox folder at [tests/env](file:///home/venus/code/ctf/tests/env) and implemented tests in [test_utils.py](file:///home/venus/code/ctf/tests/test_utils.py) validating the CLI command executions and boundary cases.
7.  **Documentation**: Created the project [ARCHITECTURE.md](file:///home/venus/code/ctf/ARCHITECTURE.md) to define standard layouts, modules, and testing behavior.

---

## Upcoming Milestones & Features

### 📅 Phase 1: Configuration Completion & Basic File Scraper
*   Extend [config.toml](file:///home/venus/code/ctf/config.toml) to store arbitrary data in the future
*   Implement a basic tool to load the latest download files into the active directory

### 📅 Phase 2: Downloads Organizer & Progress Tracker
*   Write a tool to scan specified download directories for newly acquired challenge files and automatically organize them into the active competition's directory structure.
*   Implement progress tracking to output current exploration paths, notes, and milestones.

### 📅 Phase 3: Forensics Metadata Expansion
*   Extend forensics tools to parse specific file-format metadata (e.g. EXIF data for JPGs or headers for specific archives).