Files
CTF-tool/project_status.md

2.3 KiB

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 using 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 to register nested subcommands properly.
  5. Forensics Analysis (New): Implemented ctf forensics info and ctf forensics flag-search in 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 and implemented tests in test_utils.py validating the CLI command executions and boundary cases.
  7. Documentation: Created the project ARCHITECTURE.md to define standard layouts, modules, and testing behavior.

Upcoming Milestones & Features

📅 Phase 1: Configuration Completion & Basic File Scraper

  • Extend 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).