venus/CTF-tool
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

working command structure and advanced llm Integration

Browse Source
This commit is contained in:
venus
2026-07-17 01:09:50 -05:00
parent 58351e1086
commit 70e793c4a3
15 changed files with 248 additions and 34 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
project_status.md Normal file
View File

@@ -0,0 +1,31 @@
# 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).