feat: deliver scoped Mill alpha CLI

.gitignore

@@ -3,7 +3,23 @@
 # Local agent/tool worktrees and leftover nested checkout (not part of the package)
 .codex/
 .serena/
-/xtox/
+# Ignore the historical nested checkout, but retain the small Python
+# compatibility namespace used by the published xtotext distribution.
+/xtox/*
+!/xtox/__init__.py
+!/xtox/core/
+/xtox/core/*
+!/xtox/core/__init__.py
+!/xtox/workflows/
+/xtox/workflows/*
+!/xtox/workflows/__init__.py
+!/xtox/utils/
+/xtox/utils/*
+!/xtox/utils/__init__.py
+!/xtox/cli/
+/xtox/cli/*
+!/xtox/cli/__init__.py
+!/xtox/cli/main.py
 
 # IDE and editors
 .idea/

CLAUDE.md

@@ -4,15 +4,18 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project
 
-**xtotext (xtox)** — AI-ready document conversion system. Transforms any document (PDF, DOCX, LaTeX, Markdown, etc.) into AI-optimized text formats for LLM consumption. Includes document storage and permission-based access.
+**Mill** — alpha document and media conversion workspace. The public npm
+package is `@celladore/mill`; the Python distribution `xtotext` and import
+namespace `xtox` remain compatibility APIs.
 
 ## Tech Stack
 
-- **Language**: Python
-- **CLI**: Click-based CLI tool
-- **API**: FastAPI REST API (`api/`)
-- **Serverless**: Azure Functions (`azure-functions/`)
-- **Storage**: Azure Data Lake Storage Gen2
+- **Languages**: Python and JavaScript
+- **CLI**: Node launcher (`mill`) plus the compatible Python `xtotext` executable
+- **API**: FastAPI REST API (`backend/`)
+- **Frontend**: React (`frontend/`)
+- **Legacy serverless lane**: Azure Functions (`azure-functions/`)
+- **Storage**: Azure Blob Storage and Cosmos DB's MongoDB API
 - **Build**: Makefile
 
 ## Key Commands
@@ -31,10 +34,11 @@ make md-to-pdf            # Convert markdown to PDF
 
 ## Architecture
 
-- `cli/` — Click CLI for document conversion
-- `api/` — FastAPI REST API
-- `azure-functions/` — Serverless conversion endpoints
-- `backend/` — Core conversion logic
+- `mill-cli/` and `bin/mill.js` — active Node CLI and npm package
+- `backend/` — active FastAPI REST API and conversion services
+- `core/` — local deterministic Python conversion engine
+- `cli/` and `api/` — legacy Python compatibility entry points
+- `azure-functions/` — legacy serverless lane; not the canonical deployed API
 
 ## AgentKit Forge
 

IMPLEMENTATION.md

@@ -1,6 +1,7 @@
-# xtotext Implementation Details
+# Mill Python Compatibility Implementation
 
-This document describes the implementation of the xtotext package, focusing on the main Markdown -> LaTeX -> PDF pipeline.
+This document describes Mill's compatible `xtotext` Python distribution and
+`xtox` import namespace, focusing on the Markdown -> LaTeX -> PDF pipeline.
 
 ## Core Components
 
@@ -98,4 +99,4 @@ Potential future enhancements include:
 - Advanced LaTeX customization
 - PDF metadata management
 - Custom LaTeX templates
-- Integration with AI services for content enhancement
+- Integration with AI services for content enhancement