Metadata-Version: 2.4
Name: luxforge-foundry
Version: 1.0.2
Summary: Audit-grade logging and modular tooling for Foundry systems
Home-page: https://github.com/LuxForge/LuxForge-Foundry
Author: LuxForge
Author-email: LuxForge <lab@luxforge.dev>
License: MIT
Project-URL: Homepage, https://github.com/LuxForge/LuxForge-Foundry
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: keyboard
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# 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 .
