fullbleed 2.2.5__tar.gz → 2.3.1__tar.gz

{fullbleed-2.2.5 → fullbleed-2.3.1}/Cargo.lock

@@ -4,7 +4,7 @@ version = 4
 
 [[package]]
 name = "fullbleed"
-version = "2.2.5"
+version = "2.3.1"
 dependencies = [
  "fullbleed_audit_contract",
  "subsetter",

{fullbleed-2.2.5 → fullbleed-2.3.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "fullbleed"
-version = "2.2.5"
+version = "2.3.1"
 edition = "2024"
 rust-version = "1.85"
 license = "MIT"

fullbleed-2.2.5/README.md → fullbleed-2.3.1/PKG-INFO

@@ -1,7 +1,52 @@
+Metadata-Version: 2.4
+Name: fullbleed
+Version: 2.3.1
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Printing
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Provides-Extra: api
+License-File: LICENSE
+License-File: COPYRIGHT
+License-File: LICENSING.md
+License-File: THIRD_PARTY_LICENSES.md
+License-File: FONT_LICENSE_AUDIT.md
+License-File: FONT_LICENSE_AUDIT.json
+Summary: Deterministic Python PDF engine for reports, invoices, accessible documents, print-ready output, and compiled VDP
+Keywords: pdf-generation,document-generation,html-to-pdf,python-pdf-engine,deterministic-pdf,reports,invoices,statements,forms,transactional-documents,vdp,variable-data-printing,accessible-pdf,pdf-ua,pdf-a,pdf-x,ai-agents,agentic-document-generation,mcp
+Home-Page: https://fullbleed.dev
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Agent-Contract, https://github.com/fullbleed-engine/fullbleed-official/blob/master/fullbleed-agent-contract.json
+Project-URL: Agent-Skill, https://github.com/fullbleed-engine/fullbleed-official/tree/master/skills/fullbleed
+Project-URL: Documentation, https://github.com/fullbleed-engine/fullbleed-official#readme
+Project-URL: Homepage, https://fullbleed.dev
+Project-URL: Issues, https://github.com/fullbleed-engine/fullbleed-official/issues
+Project-URL: MCP, https://github.com/fullbleed-engine/fullbleed-official/tree/master/packages/fullbleed-mcp
+Project-URL: Repository, https://github.com/fullbleed-engine/fullbleed-official
+
 <!-- SPDX-License-Identifier: MIT -->
-# Fullbleed
+# Fullbleed PDF Engine
+
+Fullbleed PDF Engine is a deterministic, self-contained document-generation runtime for Python and Rust. It turns structured data plus static HTML/CSS into reports, invoices, statements, letters, forms, certificates, accessible PDFs, print-ready documents, and high-volume compiled VDP output—without a browser or system PDF stack.
 
-Deterministic, self-contained HTML/CSS-to-PDF generation in Rust, with a Python-first CLI and Python engine bindings.
+It is designed for human developers, automation, and AI agents alike: the installed runtime exposes its exact version, capabilities, commands, schemas, compliance profiles, examples, limitations, and tool-selection boundary as a generated machine contract.
 
 
 License: MIT.
@@ -10,16 +55,49 @@ License: MIT.
 
 - **Install:** `pip install fullbleed`
 - **Try:** `fullbleed init . && python report.py`
+- **Discover:** `fullbleed agent-contract --format json`
 - **Outputs:** `output/report.pdf` 
 - Deterministic + reproducible (`--repro-record` / `--repro-check`)
 - Agent-safe JSON schemas (`--json-only`, `--schema`)
 
 ## Positioning
 
-Fullbleed is a deterministic, offline-first document rendering engine for transactional/VDP pipelines (not a browser, not a hosted web-to-print SaaS).
+Fullbleed is a deterministic, offline-first document rendering engine for structured print-document and transactional/VDP pipelines (not a browser, not a hosted web-to-print SaaS, and not a general editor for arbitrary existing PDF content).
 
 HTML and CSS are used as a familiar DSL for layout, styling, and data placement in transactional documents.
 
+## Agent discovery and integrations
+
+An agent does not need release-specific Fullbleed knowledge. The installed binary generates one canonical contract containing its actual version, selection boundary, capabilities, parser-derived CLI surface, result schemas, PDF profiles, examples, limitations, Agent Skill metadata, MCP tools, and acceptance tasks:
+
+```bash
+fullbleed agent-manifest --json
+# Equivalent canonical form:
+fullbleed agent-contract --format json
+```
+
+The committed [`fullbleed-agent-contract.json`](fullbleed-agent-contract.json), [`cli_schema.md`](cli_schema.md), and [`llms.txt`](llms.txt) are generated from the built wheel. CI rejects version, command, schema, profile, or capability drift. Runtime introspection remains authoritative.
+
+The first-party, versionless [`skills/fullbleed/SKILL.md`](skills/fullbleed/SKILL.md) teaches tool selection and the render/preview/diagnose/verify loop without duplicating the manual. It is bundled in the wheel and can be exported into any absent or empty agent-skill directory:
+
+```bash
+fullbleed agent skill-path --json
+fullbleed agent export-skill .agents/skills/fullbleed --json
+```
+
+For tool-calling agents, install the separately versioned adapter so the core package remains dependency-free:
+
+```bash
+python -m pip install fullbleed-mcp
+fullbleed-mcp --root .
+```
+
+The stdio server confines document paths to the selected workspace and delegates every engine operation to the installed Fullbleed runtime. It exposes semantic discovery, project creation, render/preview, inspect, verify, assets, and fixed/reflow compiled VDP tools. The dependency-free core also provides `fullbleed mcp --root .`.
+
+Use Fullbleed when the requested artifact is a deterministic print document built from structured content. Use a browser when the requested artifact is a screenshot or interactive state of an arbitrary live website. Use a general PDF editor when existing page content itself must be rewritten.
+
+Cold-agent testing is available through `fullbleed agent-acceptance`; compact copyable workflows live in [`examples/agent_workflows`](examples/agent_workflows), and the approach-neutral benchmark scaffold lives in [`agentdocbench`](agentdocbench).
+
 
 This README is the canonical usage guide for:
 
@@ -92,6 +170,11 @@ Fixed-geometry slots may remain inside immutable page-space transforms and clips
 captures that active coordinate-state program once and replays it in each compact record overlay;
 it does not rerun layout or clone the complete page display list.
 
+Base-14/WinAnsi slot paint keeps the measured byte-patch linker. Registered embedded fonts use a
+command-level overlay program so each bound value is shaped and included in the font subset while
+the compiled layout, pagination, and static page stream remain shared. The throughput figures above
+describe the Base-14 fast lane; they are not claims for registered-font shaping.
+
 The fixed-copy result remains scoped to identical content; the variable-data result is scoped to
 paint-only text whose geometry does not reflow. Neither is a claim that arbitrary new HTML or
 size-changing records render 200x faster. See
@@ -130,7 +213,7 @@ python -m pip install fullbleed
 From a local wheel:
 
 ```bash
-python -m pip install C:\path\to\fullbleed-2.2.5-cp310-abi3-win_amd64.whl
+python -m pip install C:\path\to\fullbleed-2.3.1-cp310-abi3-win_amd64.whl
 ```
 
 From a source checkout with Rust installed, no Python build package is needed:
@@ -188,6 +271,9 @@ Scaffolded components now include `components/primitives.py` with reusable
 layout/content helpers (`Stack`, `Row`, `Text`, table/list helpers, key/value rows, etc.).
 Each scaffolded project also includes `SCAFFOLDING.md`, which should be your
 first read before restructuring components.
+It also includes `AGENTS.md`, which preserves the installed-runtime-first
+document workflow across future coding-agent sessions without making other
+document tools categorically forbidden.
 
 Install additional project assets (defaults to `./vendor/...` in project context):
 
@@ -998,8 +1084,9 @@ Module exports:
 The compiled lane runs parsing/layout once. `render_pdf_batch` virtualizes identical untagged page
 content. The fixed binding methods accept columnar `dict[str, list[str]]` data and emit distinct
 fixed-geometry text overlays per record while sharing static paint. They require exact slot keys,
-equal non-zero column lengths, page-local WinAnsi-compatible text, and an untagged profile; bound
-values do not trigger reflow.
+equal non-zero column lengths, page-local text, and an untagged profile. Base-14 text uses the
+direct byte-patch lane; registered fonts are shaped into a command-level overlay. Bound values do
+not trigger layout or reflow.
 
 The reflow binding methods use the same exact-column contract but execute the compiled parsed-DOM
 program. `{{slot}}` values are literal text and may reshape, wrap, resize blocks, and change page

fullbleed-2.2.5/PKG-INFO → fullbleed-2.3.1/README.md

@@ -1,44 +1,9 @@
-Metadata-Version: 2.4
-Name: fullbleed
-Version: 2.2.5
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: MacOS
-Classifier: Operating System :: Microsoft :: Windows
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Rust
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Python :: Implementation :: CPython
-Classifier: Topic :: Printing
-Classifier: Topic :: Text Processing :: Markup :: HTML
-Provides-Extra: api
-License-File: LICENSE
-License-File: COPYRIGHT
-License-File: LICENSING.md
-License-File: THIRD_PARTY_LICENSES.md
-License-File: FONT_LICENSE_AUDIT.md
-License-File: FONT_LICENSE_AUDIT.json
-Summary: Deterministic static HTML/CSS-to-PDF renderer built in Rust
-Keywords: pdf,html,css,rust,static-pdf,document-generation
-Home-Page: https://fullbleed.dev
-License-Expression: MIT
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-Project-URL: Documentation, https://github.com/fullbleed-engine/fullbleed-official#readme
-Project-URL: Homepage, https://fullbleed.dev
-Project-URL: Issues, https://github.com/fullbleed-engine/fullbleed-official/issues
-Project-URL: Repository, https://github.com/fullbleed-engine/fullbleed-official
-
 <!-- SPDX-License-Identifier: MIT -->
-# Fullbleed
+# Fullbleed PDF Engine
+
+Fullbleed PDF Engine is a deterministic, self-contained document-generation runtime for Python and Rust. It turns structured data plus static HTML/CSS into reports, invoices, statements, letters, forms, certificates, accessible PDFs, print-ready documents, and high-volume compiled VDP output—without a browser or system PDF stack.
 
-Deterministic, self-contained HTML/CSS-to-PDF generation in Rust, with a Python-first CLI and Python engine bindings.
+It is designed for human developers, automation, and AI agents alike: the installed runtime exposes its exact version, capabilities, commands, schemas, compliance profiles, examples, limitations, and tool-selection boundary as a generated machine contract.
 
 
 License: MIT.
@@ -47,16 +12,49 @@ License: MIT.
 
 - **Install:** `pip install fullbleed`
 - **Try:** `fullbleed init . && python report.py`
+- **Discover:** `fullbleed agent-contract --format json`
 - **Outputs:** `output/report.pdf` 
 - Deterministic + reproducible (`--repro-record` / `--repro-check`)
 - Agent-safe JSON schemas (`--json-only`, `--schema`)
 
 ## Positioning
 
-Fullbleed is a deterministic, offline-first document rendering engine for transactional/VDP pipelines (not a browser, not a hosted web-to-print SaaS).
+Fullbleed is a deterministic, offline-first document rendering engine for structured print-document and transactional/VDP pipelines (not a browser, not a hosted web-to-print SaaS, and not a general editor for arbitrary existing PDF content).
 
 HTML and CSS are used as a familiar DSL for layout, styling, and data placement in transactional documents.
 
+## Agent discovery and integrations
+
+An agent does not need release-specific Fullbleed knowledge. The installed binary generates one canonical contract containing its actual version, selection boundary, capabilities, parser-derived CLI surface, result schemas, PDF profiles, examples, limitations, Agent Skill metadata, MCP tools, and acceptance tasks:
+
+```bash
+fullbleed agent-manifest --json
+# Equivalent canonical form:
+fullbleed agent-contract --format json
+```
+
+The committed [`fullbleed-agent-contract.json`](fullbleed-agent-contract.json), [`cli_schema.md`](cli_schema.md), and [`llms.txt`](llms.txt) are generated from the built wheel. CI rejects version, command, schema, profile, or capability drift. Runtime introspection remains authoritative.
+
+The first-party, versionless [`skills/fullbleed/SKILL.md`](skills/fullbleed/SKILL.md) teaches tool selection and the render/preview/diagnose/verify loop without duplicating the manual. It is bundled in the wheel and can be exported into any absent or empty agent-skill directory:
+
+```bash
+fullbleed agent skill-path --json
+fullbleed agent export-skill .agents/skills/fullbleed --json
+```
+
+For tool-calling agents, install the separately versioned adapter so the core package remains dependency-free:
+
+```bash
+python -m pip install fullbleed-mcp
+fullbleed-mcp --root .
+```
+
+The stdio server confines document paths to the selected workspace and delegates every engine operation to the installed Fullbleed runtime. It exposes semantic discovery, project creation, render/preview, inspect, verify, assets, and fixed/reflow compiled VDP tools. The dependency-free core also provides `fullbleed mcp --root .`.
+
+Use Fullbleed when the requested artifact is a deterministic print document built from structured content. Use a browser when the requested artifact is a screenshot or interactive state of an arbitrary live website. Use a general PDF editor when existing page content itself must be rewritten.
+
+Cold-agent testing is available through `fullbleed agent-acceptance`; compact copyable workflows live in [`examples/agent_workflows`](examples/agent_workflows), and the approach-neutral benchmark scaffold lives in [`agentdocbench`](agentdocbench).
+
 
 This README is the canonical usage guide for:
 
@@ -129,6 +127,11 @@ Fixed-geometry slots may remain inside immutable page-space transforms and clips
 captures that active coordinate-state program once and replays it in each compact record overlay;
 it does not rerun layout or clone the complete page display list.
 
+Base-14/WinAnsi slot paint keeps the measured byte-patch linker. Registered embedded fonts use a
+command-level overlay program so each bound value is shaped and included in the font subset while
+the compiled layout, pagination, and static page stream remain shared. The throughput figures above
+describe the Base-14 fast lane; they are not claims for registered-font shaping.
+
 The fixed-copy result remains scoped to identical content; the variable-data result is scoped to
 paint-only text whose geometry does not reflow. Neither is a claim that arbitrary new HTML or
 size-changing records render 200x faster. See
@@ -167,7 +170,7 @@ python -m pip install fullbleed
 From a local wheel:
 
 ```bash
-python -m pip install C:\path\to\fullbleed-2.2.5-cp310-abi3-win_amd64.whl
+python -m pip install C:\path\to\fullbleed-2.3.1-cp310-abi3-win_amd64.whl
 ```
 
 From a source checkout with Rust installed, no Python build package is needed:
@@ -225,6 +228,9 @@ Scaffolded components now include `components/primitives.py` with reusable
 layout/content helpers (`Stack`, `Row`, `Text`, table/list helpers, key/value rows, etc.).
 Each scaffolded project also includes `SCAFFOLDING.md`, which should be your
 first read before restructuring components.
+It also includes `AGENTS.md`, which preserves the installed-runtime-first
+document workflow across future coding-agent sessions without making other
+document tools categorically forbidden.
 
 Install additional project assets (defaults to `./vendor/...` in project context):
 
@@ -1035,8 +1041,9 @@ Module exports:
 The compiled lane runs parsing/layout once. `render_pdf_batch` virtualizes identical untagged page
 content. The fixed binding methods accept columnar `dict[str, list[str]]` data and emit distinct
 fixed-geometry text overlays per record while sharing static paint. They require exact slot keys,
-equal non-zero column lengths, page-local WinAnsi-compatible text, and an untagged profile; bound
-values do not trigger reflow.
+equal non-zero column lengths, page-local text, and an untagged profile. Base-14 text uses the
+direct byte-patch lane; registered fonts are shaped into a command-level overlay. Bound values do
+not trigger layout or reflow.
 
 The reflow binding methods use the same exact-column contract but execute the compiled parsed-DOM
 program. `{{slot}}` values are literal text and may reshape, wrap, resize blocks, and change page