refigure 0.3.1__tar.gz → 0.3.2__tar.gz

{refigure-0.3.1 → refigure-0.3.2}/.gitignore

@@ -54,6 +54,7 @@ CLAUDE.local.md
 docs/*
 !docs/assets/
 CLAUDE.md
+BACKLOG.md
 
 # Real-document integration test fixtures (2026-08-05): 26/27 are checked
 # in — clean, well-documented redistribution licenses (see ATTRIBUTION.md

{refigure-0.3.1 → refigure-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: refigure
-Version: 0.3.1
+Version: 0.3.2
 Summary: DOCX/XLSX -> Markdown conversion with native OOXML chart-data extraction (no rasterize/OCR/VLM needed) + optional VLM interpretation for figures with no native chart data
 Project-URL: Homepage, https://github.com/HelgDemidov/refigure
 Project-URL: Repository, https://github.com/HelgDemidov/refigure
@@ -151,6 +151,9 @@ refigure report.docx --vlm                    # needs the system soffice/LibreOf
 - **MCP server included** — `refigure-mcp` console command (`[mcp]` extra),
   stdio or Streamable HTTP, tools/resources/prompts, batch conversion with
   per-file isolation (see below).
+- **Docker image** — `ghcr.io/helgdemidov/refigure`, both console commands
+  on `PATH`, `soffice`/LibreOffice baked in — the VLM composite-figure
+  path works turnkey, no manual LibreOffice install (see below).
 
 ## CLI
 
@@ -243,6 +246,52 @@ fairness soft-cap once 2+ callers are configured; `refigure-mcp --help`
 covers every tuning flag (concurrency, timeouts, resource-store limits,
 batch size, VLM ceiling).
 
+## Docker
+
+One image, both surfaces — `refigure` and `refigure-mcp` are already on
+`PATH`, no separate CLI/MCP builds to choose between. The one thing this
+format buys over `pip`/`uvx` that neither can: the system `soffice`/
+LibreOffice binary the VLM composite-figure path needs is baked in, not a
+manual install.
+
+```bash
+docker pull ghcr.io/helgdemidov/refigure:0.3.1
+```
+
+CLI, via a bind mount (the image's working directory is already `/data`):
+
+```bash
+docker run --rm -v "$PWD:/data:ro" ghcr.io/helgdemidov/refigure:0.3.1 \
+  refigure /data/report.docx
+```
+
+MCP, stdio — the client launches the container itself:
+
+```json
+{
+  "mcpServers": {
+    "refigure": {
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "ghcr.io/helgdemidov/refigure:0.3.1", "refigure-mcp"]
+    }
+  }
+}
+```
+
+MCP, Streamable HTTP — `--mcp-http-host 0.0.0.0` is required here, not
+optional: the default `127.0.0.1` bind is unreachable through `-p` port
+publishing (Docker's NAT reaches the container's external network
+interface, not its loopback), so the "obvious" invocation without this
+flag would silently never respond:
+
+```bash
+echo "sk-... = alice" > tokens.txt
+docker run --rm -p 8000:8000 -v "$PWD/tokens.txt:/data/tokens.txt:ro" \
+  ghcr.io/helgdemidov/refigure:0.3.1 \
+  refigure-mcp --transport http --mcp-http-host 0.0.0.0 \
+  --mcp-auth-token-file /data/tokens.txt
+```
+
 ## Real examples
 
 Full `convert()` output on real, openly-licensed documents — not
@@ -307,8 +356,11 @@ else:
     markdown = refigure.xlsx.convert(path).markdown
 ```
 
-`v0.3.0` published via trusted publishing (GitHub↔PyPI, no stored tokens).
-`refigure-md` is a reserved alternate name, not an active release.
+`v0.3.1` published via trusted publishing (GitHub↔PyPI, no stored tokens),
+also on GHCR as `ghcr.io/helgdemidov/refigure` and on the official
+[MCP Registry](https://registry.modelcontextprotocol.io) as
+`io.github.HelgDemidov/refigure`. `refigure-md` is a reserved alternate
+name, not an active release.
 
 ## License
 

{refigure-0.3.1 → refigure-0.3.2}/README.md

@@ -111,6 +111,9 @@ refigure report.docx --vlm                    # needs the system soffice/LibreOf
 - **MCP server included** — `refigure-mcp` console command (`[mcp]` extra),
   stdio or Streamable HTTP, tools/resources/prompts, batch conversion with
   per-file isolation (see below).
+- **Docker image** — `ghcr.io/helgdemidov/refigure`, both console commands
+  on `PATH`, `soffice`/LibreOffice baked in — the VLM composite-figure
+  path works turnkey, no manual LibreOffice install (see below).
 
 ## CLI
 
@@ -203,6 +206,52 @@ fairness soft-cap once 2+ callers are configured; `refigure-mcp --help`
 covers every tuning flag (concurrency, timeouts, resource-store limits,
 batch size, VLM ceiling).
 
+## Docker
+
+One image, both surfaces — `refigure` and `refigure-mcp` are already on
+`PATH`, no separate CLI/MCP builds to choose between. The one thing this
+format buys over `pip`/`uvx` that neither can: the system `soffice`/
+LibreOffice binary the VLM composite-figure path needs is baked in, not a
+manual install.
+
+```bash
+docker pull ghcr.io/helgdemidov/refigure:0.3.1
+```
+
+CLI, via a bind mount (the image's working directory is already `/data`):
+
+```bash
+docker run --rm -v "$PWD:/data:ro" ghcr.io/helgdemidov/refigure:0.3.1 \
+  refigure /data/report.docx
+```
+
+MCP, stdio — the client launches the container itself:
+
+```json
+{
+  "mcpServers": {
+    "refigure": {
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "ghcr.io/helgdemidov/refigure:0.3.1", "refigure-mcp"]
+    }
+  }
+}
+```
+
+MCP, Streamable HTTP — `--mcp-http-host 0.0.0.0` is required here, not
+optional: the default `127.0.0.1` bind is unreachable through `-p` port
+publishing (Docker's NAT reaches the container's external network
+interface, not its loopback), so the "obvious" invocation without this
+flag would silently never respond:
+
+```bash
+echo "sk-... = alice" > tokens.txt
+docker run --rm -p 8000:8000 -v "$PWD/tokens.txt:/data/tokens.txt:ro" \
+  ghcr.io/helgdemidov/refigure:0.3.1 \
+  refigure-mcp --transport http --mcp-http-host 0.0.0.0 \
+  --mcp-auth-token-file /data/tokens.txt
+```
+
 ## Real examples
 
 Full `convert()` output on real, openly-licensed documents — not
@@ -267,8 +316,11 @@ else:
     markdown = refigure.xlsx.convert(path).markdown
 ```
 
-`v0.3.0` published via trusted publishing (GitHub↔PyPI, no stored tokens).
-`refigure-md` is a reserved alternate name, not an active release.
+`v0.3.1` published via trusted publishing (GitHub↔PyPI, no stored tokens),
+also on GHCR as `ghcr.io/helgdemidov/refigure` and on the official
+[MCP Registry](https://registry.modelcontextprotocol.io) as
+`io.github.HelgDemidov/refigure`. `refigure-md` is a reserved alternate
+name, not an active release.
 
 ## License
 

{refigure-0.3.1 → refigure-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "refigure"
-version = "0.3.1"
+version = "0.3.2"
 description = "DOCX/XLSX -> Markdown conversion with native OOXML chart-data extraction (no rasterize/OCR/VLM needed) + optional VLM interpretation for figures with no native chart data"
 readme = "README.md"
 license = "Apache-2.0"