Metadata-Version: 2.4
Name: luxforge
Version: 0.1.2
Summary: Shared foundation library for LuxForge software
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# LuxForge-Foundry

Cross-platform Python package for Rasputin-grade automation, lore-aligned workflows, and modular utility orchestration.

---

##  What Is LuxForge-Foundry?

LuxForge-Foundry is a curated suite of operational constructs—each forged for clarity, provenance, and expressive control. It unifies helper scripts, data generators, and system utilities under a dynamic launcher, with every module discoverable, inspectable, and lore-aligned.

---

##  Core Features

-  **Breadcrumb Injection** — Rasputin-style NAVIGATION lines for `.md` files
-  **Global NAVIGATION Index** — Rebuilds a full breadcrumb map across your archive
-  **Legacy Marker Cleanup** — Removes stale NAVIGATION lines and audit tags
-  **Changelog Emission** — Tracks file-level changes with timestamped logs
-  **Synthetic Data Tools** — For testing, scaffolding, and benchmarking
-  **Docker Utilities** — Volume inspection, network mapping, container orchestration
-  **Games & Experiments** — Includes lottery logic and modular playgrounds
-  **User Profiles** — YAML-backed user data with `.env` support

---

##  Getting Started

```bash
git clone https://github.com/yourusername/LuxForge-Foundry.git
cd LuxForge-Foundry
pip install -e .
