Credential Curator Workbench

A VS Code-based notebook workbench and Python engine to discover, analyze, validate, de-duplicate, and curate browser credentials from Chromium-based browsers (Microsoft Edge & Google Chrome) for migration to a curated KeePass vault.

---

Architecture & Design Principles

• Notebook = Interactive UI: notebooks/curator_workbench.ipynb provides an interactive exploration and triage environment.
• Python Package = Business Logic: Core extraction, DPAPI decryption, and SQLite operations are isolated in curator_core/.
• Zero Inadvertent Secret Leaks: Passwords are automatically masked (••••••••) across all DataFrame views and object representations.
• Non-Blocking Extraction: Browser SQLite databases are copied to temporary scratch space before reading, preventing file-lock collisions with running browsers.

---

Quickstart

1. Environment Setup with mise

# Install dependencies with mise / pip
mise install
mise run pip install -e ".[dev]"

2. Run the Workbench in VS Code

1. Open d:\curator in VS Code.
2. Open notebooks/curator_workbench.ipynb.
3. Select your Python kernel (managed via mise).
4. Run the notebook cells sequentially to discover browser profiles and inspect decrypted credentials.

3. Run Automated Tests

mise run pytest tests/

---

Project Structure

d:\curator\
├── mise.toml                  # Mise tool version configuration
├── pyproject.toml             # Package metadata and dependencies
├── README.md
├── curator_core/              # Core business logic package
│   ├── crypto/                # DPAPI unprotect & Chromium AES-GCM decryption
│   │   ├── dpapi.py
│   │   └── chromium.py
│   ├── discovery/             # Edge & Chrome profile discovery and metadata
│   │   ├── paths.py
│   │   └── scanner.py
│   ├── extractor/             # Safe SQLite reader & credential parser
│   │   └── sqlite_reader.py
│   ├── models/                # Dataclasses for Profile, Credential, BrowserType
│   │   ├── profile.py
│   │   └── credential.py
│   └── storage/               # Session state & masked DataFrame generators
│       └── session.py
├── notebooks/
│   └── curator_workbench.ipynb # Master interactive workbench notebook
└── tests/                     # Unit test suite
    ├── test_crypto.py
    ├── test_discovery.py
    ├── test_extractor.py
    └── test_models.py