Add interactive CLI control center

Author: Nour833

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2.1.0 — 2026-06-22
+
+- Added a colorful full-screen control center for no-argument `fcoin`.
+- Added arrow-key, `j`/`k`, number-key, back, escape, and quit navigation.
+- Added guided workflows for every major command category.
+- Added compatible-file discovery and secure-session selection.
+- Made incomplete terminal commands open their workflow wizard.
+- Added friendly `--inspect`, `-inspect`, `--doctor`, and related aliases.
+- Preserved direct command and JSON behavior for scripts and automation.
+
 ## 2.0.0 — 2026-06-22
 
 - Replaced the monolithic prototype with an installable Python package.

README.md

@@ -13,7 +13,7 @@
 
 [![Python 3.11+](https://img.shields.io/badge/Python-3.11%2B-45E1FF?style=flat-square&logo=python&logoColor=0B0F14)](https://python.org)
 [![Zero runtime dependencies](https://img.shields.io/badge/runtime_dependencies-0-7DFFB2?style=flat-square)](#installation)
-[![Tests](https://img.shields.io/badge/tests-21_passing-7DFFB2?style=flat-square)](#development)
+[![Tests](https://img.shields.io/badge/tests-27_passing-7DFFB2?style=flat-square)](#development)
 [![License: MIT](https://img.shields.io/badge/license-MIT-FFCF70?style=flat-square)](LICENSE)
 
 **Acquire. Validate. Understand. Plan. Record. Verify. Recover.**
@@ -26,6 +26,42 @@ FCOIN is an offline-first toolkit for examining and safely maintaining MIFARE Cl
 
 FCOIN does not silently write cards, install packages with `sudo`, upload dumps, or treat heuristic guesses as facts.
 
+## Interactive control center
+
+Run FCOIN without arguments:
+
+```bash
+fcoin
+```
+
+This opens a colorful full-screen dashboard instead of printing raw command help. Navigate with:
+
+- `↑` / `↓` or `j` / `k` to move.
+- `ENTER` to open the selected workflow.
+- Number keys for immediate shortcuts.
+- `b` or `ESC` to go back.
+- `q` to exit cleanly.
+
+The dashboard provides guided menus for:
+
+- Reader and imported-dump backups.
+- Inspection, validation, comparison, and evidence questions.
+- Reports, conversion, inference, and inventory.
+- Owned-laboratory profile and value-plan workflows.
+- Transaction preparation, verification, recovery, history, and journals.
+
+File prompts automatically list compatible files in the current directory and always provide a manual-path option. Session prompts display the UID, transaction state, card type, and session ID.
+
+Incomplete direct commands also enter the relevant wizard when used in a terminal:
+
+```bash
+fcoin inspect
+fcoin compare
+fcoin backup
+```
+
+Fully specified commands remain unchanged for scripts and automation. Friendly aliases such as `fcoin --inspect` and `fcoin --doctor` are also accepted.
+
 ## What changed in 2.0
 
 | Area | Capability |
@@ -106,7 +142,7 @@ FCOIN itself has no third-party Python runtime dependencies.
 git clone https://github.com/Nour833/Fcoin.git
 cd Fcoin
 python3 -m pip install -e .
-fcoin --help
+fcoin
 ```
 
 It can also run directly from a checkout:
@@ -179,6 +215,8 @@ fcoin inspect card.mfd --json
 
 The analyzer reports protocol facts and candidates separately. A structurally valid value block is a fact; calling that value a balance requires a trusted profile or controlled evidence.
 
+The default terminal view hides routine empty blocks and valid sector trailers so important findings remain readable. Use `--all` for the complete forensic table.
+
 ### 4. Compare controlled states
 
 ```bash
@@ -464,6 +502,8 @@ Sensitive artifacts use mode `0600`; session directories use `0700`. Dumps, keys
 
 Every analysis-oriented command supports plain terminal output or JSON where appropriate. Set `NO_COLOR=1` or use `--no-color` for non-ANSI output.
 
+Use `fcoin --help` when you specifically want the complete non-interactive argparse reference instead of the dashboard.
+
 ## Architecture
 
 ```text

docs/ARCHITECTURE.md

@@ -44,6 +44,7 @@ An analysis finding is not an authorization. A writable plan additionally requir
 - `formats.py` converts complete images.
 - `reporting.py` creates archiveable output.
 - `ui.py` presents styled terminal data without runtime dependencies.
+- `interactive.py` provides arrow-key menus, file/session pickers, and guided workflows.
 - `cli.py` connects commands to domain operations.
 
 ## Transaction states

fcoin.py

@@ -15,7 +15,7 @@
 # package directory as its submodule path instead of shadowing it.
 if __name__ == "fcoin":
     __path__ = [str(SRC / "fcoin")]
-    __version__ = "2.0.0"
+    __version__ = "2.1.0"
 
 from fcoin.cli import main  # noqa: E402
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fcoin"
-version = "2.0.0"
+version = "2.1.0"
 description = "Local-first MIFARE Classic backup, validation, analysis, comparison, and guarded restoration toolkit"
 readme = "README.md"
 requires-python = ">=3.11"

src/fcoin/__init__.py

@@ -3,4 +3,4 @@
 from fcoin.dump import CardImage
 
 __all__ = ["CardImage"]
-__version__ = "2.0.0"
+__version__ = "2.1.0"