fullbleed 2.2.4__tar.gz → 2.3.0__tar.gz

{fullbleed-2.2.4 → fullbleed-2.3.0}/Cargo.lock

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

{fullbleed-2.2.4 → fullbleed-2.3.0}/Cargo.toml

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

fullbleed-2.2.4/README.md → fullbleed-2.3.0/PKG-INFO

@@ -1,7 +1,52 @@
+Metadata-Version: 2.4
+Name: fullbleed
+Version: 2.3.0
+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:
 
@@ -99,7 +177,7 @@ size-changing records render 200x faster. See
 [`docs/performance-architecture.md`](docs/performance-architecture.md) for the packed vector IR,
 typed-binding, virtual-linker, and shader roadmap.
 
-Fullbleed 2.2.4 adds a third compiler lane for
+Fullbleed 2.2.5 hardens the third compiler lane introduced in 2.2.4 for
 size-changing records: `CompiledDocument.render_pdf_reflow_bindings(...)`. It parses and recovers
 the template DOM once and compiles encountered structural flow variants into guarded fixed-point
 display programs. Matching records bind directly into those programs; workers execute pre-shaped
@@ -107,15 +185,17 @@ text/TJ paint slots, cached static PDF page segments, page-local Deflate, and on
 Explicit trusted structural slots use `data-fb-bind-html="slot"`. A value that no compiled variant
 can safely place runs ordinary fixed-point layout once to add another variant.
 
-On the independent 1,000-distinct-record case study, the final ABI3 wheel's 29-sample hot
-direct-file run had a 168.839 ms median: **5,923 records/s and 10,365 pages/s**, with a 12,510
-pages/s best. It produced
+On the independent 1,000-distinct-record case study, the 29-sample hot direct-file median was
+216.160 ms: **4,626 records/s and 8,096 pages/s**. The 168.995 ms best sample reached **5,917
+records/s and 10,355 pages/s**. It produced
 the exact 1,750-page 500/300/150/50 reflow distribution and verified all 24,900 markers. The
 throughput-tuned 6,870,320-byte PDF was deterministic across all samples. With the compact
 compression setting, compiled output was also byte-for-byte identical to ordinary rendering:
 5,298,961 bytes and SHA-256 `bb3c441313a08fb00d3bd15f23a567981f3bbbd550908e3a9fe7a07ca5d7f138`.
-This is a hot compiled-variant result, not a claim for previously unseen structure; the first
-compile-on-demand batch measured 407.521 ms (4,294 pages/s).
+This is a hot compiled-variant result, not a claim for previously unseen structure. The first
+variant-discovery render measured 0.509 s (3,437 pages/s), and the fully cold job including setup,
+bindings, compilation, discovery, and write measured 0.588 s (2,975 pages/s). The independently
+observed hot-median speedup over the ordinary path was 43.8x.
 
 ## Install
 
@@ -128,7 +208,7 @@ python -m pip install fullbleed
 From a local wheel:
 
 ```bash
-python -m pip install C:\path\to\fullbleed-2.2.4-cp310-abi3-win_amd64.whl
+python -m pip install C:\path\to\fullbleed-2.3.0-cp310-abi3-win_amd64.whl
 ```
 
 From a source checkout with Rust installed, no Python build package is needed:
@@ -186,6 +266,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):
 
@@ -581,7 +664,8 @@ Machine discovery:
 fullbleed capabilities --json
 ```
 
-Inspect the `svg` object in `fullbleed.capabilities.v1` for SVG support metadata.
+Inspect the `svg` object in `fullbleed.capabilities.v1` for SVG support metadata. The `engine`
+object also reports compiled-document/reflow availability and supported per-call compression modes.
 It reports the compiled `svg_raster` build feature plus a feature matrix for
 native-vector SVG, raster-fallback-required SVG, and unsupported/known-loss SVG
 features.
@@ -940,6 +1024,7 @@ Module exports:
 
 - `PdfEngine`
 - `CompiledDocument`
+- `CompiledFlowCompression`
 - `AssetBundle`
 - `Asset`
 - `AssetKind`
@@ -988,8 +1073,8 @@ Module exports:
 | `render_pdf_batch(copies, deterministic_hash=None)` | `bytes` |
 | `render_pdf_bindings(bindings, deterministic_hash=None)` | `bytes` |
 | `render_pdf_bindings_to_file(bindings, path, deterministic_hash=None)` | `int` |
-| `render_pdf_reflow_bindings(bindings, deterministic_hash=None)` | `bytes` |
-| `render_pdf_reflow_bindings_to_file(bindings, path, deterministic_hash=None)` | `int` |
+| `render_pdf_reflow_bindings(bindings, deterministic_hash=None, *, compression="throughput")` | `bytes` |
+| `render_pdf_reflow_bindings_to_file(bindings, path, deterministic_hash=None, *, compression="throughput")` | `int` |
 
 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
@@ -1001,7 +1086,10 @@ The reflow binding methods use the same exact-column contract but execute the co
 program. `{{slot}}` values are literal text and may reshape, wrap, resize blocks, and change page
 counts. Empty elements can opt into trusted generated markup with
 `data-fb-bind-html="slot"`; those values replace the element's children. One DOM is reused per
-native worker and record output is linked in input order through a bounded queue. See
+native worker and record output is linked in input order through a bounded queue. Structural slot
+values are parsed as trusted markup: sanitize untrusted input or use scalar `{{slot}}` bindings,
+which remain literal text. Choose `CompiledFlowCompression.Throughput` (default) or
+`CompiledFlowCompression.Compact` per render; modes can be mixed safely in one process. See
 [`docs/python-api.md`](docs/python-api.md) for the trust boundary and current limitations.
 
 When `deterministic_hash` is set, engine writes PDF SHA-256 to the provided file path.

fullbleed-2.2.4/PKG-INFO → fullbleed-2.3.0/README.md

@@ -1,44 +1,9 @@
-Metadata-Version: 2.4
-Name: fullbleed
-Version: 2.2.4
-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:
 
@@ -136,7 +134,7 @@ size-changing records render 200x faster. See
 [`docs/performance-architecture.md`](docs/performance-architecture.md) for the packed vector IR,
 typed-binding, virtual-linker, and shader roadmap.
 
-Fullbleed 2.2.4 adds a third compiler lane for
+Fullbleed 2.2.5 hardens the third compiler lane introduced in 2.2.4 for
 size-changing records: `CompiledDocument.render_pdf_reflow_bindings(...)`. It parses and recovers
 the template DOM once and compiles encountered structural flow variants into guarded fixed-point
 display programs. Matching records bind directly into those programs; workers execute pre-shaped
@@ -144,15 +142,17 @@ text/TJ paint slots, cached static PDF page segments, page-local Deflate, and on
 Explicit trusted structural slots use `data-fb-bind-html="slot"`. A value that no compiled variant
 can safely place runs ordinary fixed-point layout once to add another variant.
 
-On the independent 1,000-distinct-record case study, the final ABI3 wheel's 29-sample hot
-direct-file run had a 168.839 ms median: **5,923 records/s and 10,365 pages/s**, with a 12,510
-pages/s best. It produced
+On the independent 1,000-distinct-record case study, the 29-sample hot direct-file median was
+216.160 ms: **4,626 records/s and 8,096 pages/s**. The 168.995 ms best sample reached **5,917
+records/s and 10,355 pages/s**. It produced
 the exact 1,750-page 500/300/150/50 reflow distribution and verified all 24,900 markers. The
 throughput-tuned 6,870,320-byte PDF was deterministic across all samples. With the compact
 compression setting, compiled output was also byte-for-byte identical to ordinary rendering:
 5,298,961 bytes and SHA-256 `bb3c441313a08fb00d3bd15f23a567981f3bbbd550908e3a9fe7a07ca5d7f138`.
-This is a hot compiled-variant result, not a claim for previously unseen structure; the first
-compile-on-demand batch measured 407.521 ms (4,294 pages/s).
+This is a hot compiled-variant result, not a claim for previously unseen structure. The first
+variant-discovery render measured 0.509 s (3,437 pages/s), and the fully cold job including setup,
+bindings, compilation, discovery, and write measured 0.588 s (2,975 pages/s). The independently
+observed hot-median speedup over the ordinary path was 43.8x.
 
 ## Install
 
@@ -165,7 +165,7 @@ python -m pip install fullbleed
 From a local wheel:
 
 ```bash
-python -m pip install C:\path\to\fullbleed-2.2.4-cp310-abi3-win_amd64.whl
+python -m pip install C:\path\to\fullbleed-2.3.0-cp310-abi3-win_amd64.whl
 ```
 
 From a source checkout with Rust installed, no Python build package is needed:
@@ -223,6 +223,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):
 
@@ -618,7 +621,8 @@ Machine discovery:
 fullbleed capabilities --json
 ```
 
-Inspect the `svg` object in `fullbleed.capabilities.v1` for SVG support metadata.
+Inspect the `svg` object in `fullbleed.capabilities.v1` for SVG support metadata. The `engine`
+object also reports compiled-document/reflow availability and supported per-call compression modes.
 It reports the compiled `svg_raster` build feature plus a feature matrix for
 native-vector SVG, raster-fallback-required SVG, and unsupported/known-loss SVG
 features.
@@ -977,6 +981,7 @@ Module exports:
 
 - `PdfEngine`
 - `CompiledDocument`
+- `CompiledFlowCompression`
 - `AssetBundle`
 - `Asset`
 - `AssetKind`
@@ -1025,8 +1030,8 @@ Module exports:
 | `render_pdf_batch(copies, deterministic_hash=None)` | `bytes` |
 | `render_pdf_bindings(bindings, deterministic_hash=None)` | `bytes` |
 | `render_pdf_bindings_to_file(bindings, path, deterministic_hash=None)` | `int` |
-| `render_pdf_reflow_bindings(bindings, deterministic_hash=None)` | `bytes` |
-| `render_pdf_reflow_bindings_to_file(bindings, path, deterministic_hash=None)` | `int` |
+| `render_pdf_reflow_bindings(bindings, deterministic_hash=None, *, compression="throughput")` | `bytes` |
+| `render_pdf_reflow_bindings_to_file(bindings, path, deterministic_hash=None, *, compression="throughput")` | `int` |
 
 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
@@ -1038,7 +1043,10 @@ The reflow binding methods use the same exact-column contract but execute the co
 program. `{{slot}}` values are literal text and may reshape, wrap, resize blocks, and change page
 counts. Empty elements can opt into trusted generated markup with
 `data-fb-bind-html="slot"`; those values replace the element's children. One DOM is reused per
-native worker and record output is linked in input order through a bounded queue. See
+native worker and record output is linked in input order through a bounded queue. Structural slot
+values are parsed as trusted markup: sanitize untrusted input or use scalar `{{slot}}` bindings,
+which remain literal text. Choose `CompiledFlowCompression.Throughput` (default) or
+`CompiledFlowCompression.Compact` per render; modes can be mixed safely in one process. See
 [`docs/python-api.md`](docs/python-api.md) for the trust boundary and current limitations.
 
 When `deterministic_hash` is set, engine writes PDF SHA-256 to the provided file path.