vixl-engine 0.15.0__tar.gz

vixl_engine-0.15.0/.claude-plugin/marketplace.json

@@ -0,0 +1,5 @@
+{
+  "name": "vixl",
+  "owner": {"name": "Vixl contributors"},
+  "plugins": [{"name": "vixl", "source": "./", "description": "Editable graphics with Vixl MCP and its design skill"}]
+}

vixl_engine-0.15.0/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "vixl",
+  "description": "Editable graphics, brand kits and human review with the Vixl engine.",
+  "author": {
+    "name": "Vixl contributors"
+  },
+  "homepage": "https://github.com/jxburros/Vixl",
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json",
+  "version": "0.15.0"
+}

vixl_engine-0.15.0/.github/workflows/agent-eval.yml

@@ -0,0 +1,51 @@
+name: Agent eval
+on:
+  schedule:
+    - cron: '0 15 * * 1'
+  workflow_dispatch:
+    inputs:
+      model:
+        description: Claude model ID
+        default: claude-opus-5-5
+      effort:
+        description: Effort (low, medium, high, xhigh, max; empty = model default)
+        default: ''
+permissions:
+  contents: read
+jobs:
+  eval:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        schema: [full, slim]
+    env:
+      ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: python -m pip install -e ".[dev]"
+      - name: Verify offline reference against stored baseline
+        run: python -m evals.run --schema '${{ matrix.schema }}' --tools core --baseline evals/baseline.json --out reference-results
+      - name: Run the agent eval (spends API credits)
+        if: env.ANTHROPIC_API_KEY != ''
+        env:
+          MODEL: ${{ inputs.model || 'claude-opus-5-5' }}
+          EFFORT: ${{ inputs.effort }}
+          SCHEMA: ${{ matrix.schema }}
+        run: |
+          args=(--agent claude --model "$MODEL" --schema "$SCHEMA" --tools core --baseline evals/baseline.json --out eval-results --keep)
+          if [ -n "$EFFORT" ]; then args+=(--effort "$EFFORT"); fi
+          python -m evals.run "${args[@]}" | tee -a "$GITHUB_STEP_SUMMARY"
+      - name: Explain unavailable live evaluation
+        if: env.ANTHROPIC_API_KEY == ''
+        run: echo 'Live agent eval skipped — configure ANTHROPIC_API_KEY. Offline baseline was checked.' >> "$GITHUB_STEP_SUMMARY"
+      - uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: agent-eval-${{ matrix.schema }}
+          path: |
+            eval-results
+            reference-results

vixl_engine-0.15.0/.github/workflows/pypi.yml

@@ -0,0 +1,46 @@
+name: Publish Python and agent bundles
+on:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+permissions:
+  contents: read
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: python -m pip install -e '.[dev]' build twine
+      - run: pytest -q
+      - name: Verify release version
+        if: startsWith(github.ref, 'refs/tags/')
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: python -c "import os; from vixl import __version__; assert os.environ['RELEASE_TAG'] == 'v' + __version__"
+      - run: python -m build && python -m twine check dist/*.whl dist/*.tar.gz
+      - run: python distribution/package_extensions.py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: pypi-and-agent-bundles
+          path: dist/*
+  publish:
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/vixl-engine
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: pypi-and-agent-bundles
+          path: dist
+      - run: mkdir packages && cp dist/*.whl dist/*.tar.gz packages/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: packages/

vixl_engine-0.15.0/.github/workflows/release.yml

@@ -0,0 +1,92 @@
+name: Windows installer and releases
+on:
+  pull_request:
+  push:
+    tags: ['v*']
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+jobs:
+  verify:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: python -m pip install -e ".[dev]" build
+      - run: pytest -q
+      - name: Verify stable tag and package versions agree
+        if: startsWith(github.ref, 'refs/tags/')
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          python -c "import os; from vixl import __version__; assert os.environ['RELEASE_TAG'] == 'v' + __version__"
+      - run: python -m build
+      - run: python distribution/package_extensions.py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-distributions
+          path: |
+            dist/*.whl
+            dist/*.tar.gz
+            dist/*.mcpb
+            dist/*-claude-code.zip
+  windows:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: python -m pip install -e ".[dev]" pyinstaller==6.16.0
+      - run: pytest -q
+      - name: Build bundled runtime, stable launcher, and installer
+        shell: pwsh
+        run: ./distribution/build_windows.ps1
+      - name: Verify installation, PATH, native updates, and uninstall
+        shell: pwsh
+        run: ./distribution/test_windows_install.ps1
+      - uses: actions/upload-artifact@v4
+        with:
+          name: windows-release
+          path: dist/release/*
+          if-no-files-found: error
+  publish:
+    if: startsWith(github.ref, 'refs/tags/')
+    needs: [verify, windows]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: '*distributions'
+          path: release
+          merge-multiple: true
+      - uses: actions/download-artifact@v4
+        with:
+          name: windows-release
+          path: release
+      - name: Publish an immutable, fully uploaded stable release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          python - <<'PYNOTES'
+          import os
+          from pathlib import Path
+          version = os.environ["RELEASE_TAG"].removeprefix("v")
+          changelog = Path("CHANGELOG.md").read_text(encoding="utf-8")
+          notes = changelog.split(f"## {version}\n", 1)[1].split("\n## ", 1)[0].strip()
+          notes += "\n\nSee [installation and release documentation](https://github.com/jxburros/Vixl/blob/" + os.environ["RELEASE_TAG"] + "/docs/releases.md).\n"
+          Path("release-notes.md").write_text(notes, encoding="utf-8")
+          PYNOTES
+          gh release create "$RELEASE_TAG" --verify-tag --draft --title "Vixl $RELEASE_TAG" --notes-file release-notes.md
+          gh release upload "$RELEASE_TAG" release/*
+          gh release edit "$RELEASE_TAG" --draft=false --latest

vixl_engine-0.15.0/.github/workflows/test.yml

@@ -0,0 +1,27 @@
+name: Test and package
+on:
+  push:
+    branches: [main]
+  pull_request:
+permissions:
+  contents: read
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python: ['3.11', '3.12', '3.13', '3.14']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install -e ".[dev]"
+      - run: pytest -q
+      - run: python -m pip wheel . --no-deps --wheel-dir dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: vixl-${{ matrix.os }}-${{ matrix.python }}
+          path: dist/*.whl

vixl_engine-0.15.0/.gitignore

@@ -0,0 +1,17 @@
+__pycache__/
+*.py[cod]
+.venv/
+.pytest_cache/
+.ruff_cache/
+*.egg-info/
+dist/
+build/
+.vixl-session.json
+.vixl-jobs/
+.vixl-cache/
+*.vixl.lock
+*.vixl
+!examples/after-hours.vixl
+.env
+
+examples/output/

vixl_engine-0.15.0/.mcp.json

@@ -0,0 +1,19 @@
+{
+  "mcpServers": {
+    "vixl": {
+      "command": "uvx",
+      "args": [
+        "--from",
+        "https://github.com/jxburros/Vixl/archive/refs/tags/v0.15.0.tar.gz",
+        "vixl",
+        "mcp",
+        "--workspace",
+        ".",
+        "--tools",
+        "core",
+        "--schema",
+        "slim"
+      ]
+    }
+  }
+}

vixl_engine-0.15.0/CHANGELOG.md

@@ -0,0 +1,219 @@
+# Changelog
+
+## Unreleased
+
+## 0.15.0
+
+- Cross-platform agent distribution: base-package MCP dependency, PyPI Trusted Publishing workflow,
+  Claude Code plugin/marketplace and Claude Desktop MCPB build artifacts with the complete skill.
+- Streamable HTTP MCP with the REST bearer-token policy and loopback protection; stdio remains available.
+- Live `view` page for renders, layers, history and persistent review notes shared with CLI/MCP agents.
+- Workspace `brand.json` defaults for layouts, templates and rolls, embedded fonts/logos, and brand checks.
+- `roll --apply` applies fonts and a layout atomically; layout results expose unfilled slots directly.
+- Editable SVG shape/path import, compound-path rendering, and optional raster PDF page import.
+- Sixteen offline agent briefs, stored acceptance baseline, weekly full/slim live comparisons when configured,
+  and a documented core/slim setup that reduces tool schema context by approximately 46%.
+
+## 0.14.0
+
+- **Character animation and sharper motion.** A new `pivot` operation (`vixl pivot arm 0.5 0.05`,
+  anchor names, `--px`, `--clear`) makes rotation and scale turn about a joint that stays fixed in
+  renders, timeline frames, layout bounds and SVG; animated rotation no longer drifts; group
+  `translate`/`rotation`/`scale` keyframes carry their children; `animate`, `animate-preset` and
+  `keyframe` accept `targets` (CLI `a,b`). `export-timeline --scale` (now up to 16) renders frames at
+  full resolution instead of enlarging them, and `export --scale` and large icon-set sizes re-render
+  text, shapes and vectors the same way. `export-animation` gains `--sampling smooth|nearest` with
+  fractional smooth scales, and frame animation works at any canvas size within the pixel budget (the
+  256×256 cap is gone). GIFs are much smaller with no visual change (frame differencing for opaque
+  animations), accept `--colors 2–256`, and the export result warns above 1 MB; a 728×90 4 s banner
+  went from 929 KB to 190 KB (76 KB at 64 colors). New REST `POST /animation/export`.
+- **MCP as two servers.** `vixl mcp --tools core` serves editing, rendering, checks, export and the
+  catalogs; `--tools ai` serves the provider-backed tools plus workspace/open/inspect/preview. Both
+  share the workspace and see each other's saved edits. The default (`all`) is unchanged.
+- **Windows: `vixl` works in already-open sessions.** The installer also places the launcher in
+  `%LOCALAPPDATA%\Microsoft\WindowsApps` (already on the user PATH of running programs) when that
+  folder is on PATH, never over another program's `vixl.exe`, and removes it on uninstall. The copy
+  finds the installation through `VIXL_HOME`, the installer's `HKCU\Software\Vixl\InstallRoot`
+  record, or `%LOCALAPPDATA%\Programs\Vixl`. The agent skill tells agents to check the standard
+  install locations and `python -m vixl` before asking where Vixl is, and the MCP docs now give the
+  correct install path.
+- **Palettes, fonts and templates.** `palette apply` also sets the role swatches (`@background`,
+  `@ink`, `@accent` …), recoloring layouts and templates (`roles: false` adds only numbered swatches).
+  Templates roll their colors into role swatches and give text `heading`/`body` font roles, so
+  `font pair` re-fonts them. `text`/`text-set` accept `font` as a registered name, role or file, and
+  `missing_font` lists the registered fonts.
+- **Checks and layouts.** On print sizes, legibility is judged in printed points (below 6 pt) instead
+  of at thumbnail width. `event-poster` grows its type on large formats, keeps the date on one line
+  and sets the facts at the foot. `render --data` checks every row and attaches a `check` report to
+  outputs with problems (`--no-check` skips it). Icon sets warn when they enlarge embedded images.
+  `vixl text --help` shows `text add` usage, and `inspect` accepts `--target`.
+- **Fixes from a ten-design hands-on pass.** Stroked polygons, stars and closed paths now join
+  their first vertex instead of leaving a notch. `text-set` keeps a `text-layout` box, so changing
+  the color, size or copy of wrapped text no longer collapses it to one long line. SVG export now
+  names the cause of a `repeat`, lookup-table or raster-mask fallback instead of reporting a
+  generic "unsupported vector appearance".
+
+- **Fill-in-the-blank layouts and templates.** Layouts and built-in templates no longer render
+  invented sample copy. Unfilled slots appear as visible `[Label]` placeholders recorded in
+  `state.blanks`, and the new default `blanks` check reports them as errors. `unfilled: "omit"`
+  leaves them out instead. Copy for a slot a layout doesn't use now fails with `unused_slot` and
+  lists the slots it does use, instead of being silently dropped. `layout show` / `vixl_layouts_list`
+  describe each layout's slots. Built-in templates roll their colors from a seeded palette unless
+  colors are supplied; custom templates can declare `blanks` and `roll`.
+- **Typefaces.** A researched catalog of open-licensed Google Fonts families (classification,
+  weights, x-height, width, contrast, era, mood, roles, misuse cautions), curated heading/body
+  pairings with the reasoning behind each, and a pairing-principles guide (`vixl fonts`,
+  `font show`, `font pairings`, `font principles`, MCP `vixl_fonts`, REST `/typefaces`).
+  `font install FAMILY --weight N` and `font pair NAME|random` download on request, cache per user,
+  embed and register fonts, and set the document typography (`font-register` gains `role`) that
+  layouts use by default. The bundled font is now a proofing fallback, and a new default `fonts`
+  check warns when text uses it.
+- **Dice.** `vixl roll` / `vixl_roll` / `GET /roll` rolls a coherent direction from one seed: a
+  pairing, a mood-consistent palette, a layout suited to the purpose and canvas, and its parameters,
+  returned as a ready `layout-apply` operation. Choices can be locked. Layouts and templates accept
+  `seed: "random"`, record which choices were rolled, and suggest exploring when parameters were thin.
+
+- Add persistent design check suites with structural/pixel baselines, explicit time coverage,
+  measured failures and needs-review outcomes. Checked actions commit only when suites pass;
+  reusable repairs cannot modify their contracts.
+- Add typed template metadata, portable document recipes with example validation, named
+  actions, minimum-size text fitting, grid arrangement, explicit vertical reflow, semantic
+  layer roles and staggered/relative motion recipes.
+- Add bounded variant matrices, draft/final production, per-output checks/repairs,
+  contact sheets, checksum-verified resume and selective rebuilding.
+- Add versioned editable component libraries and optional persistent layer/frame caching
+  with font/runtime invalidation and corrupt-cache fallback.
+- Add durable background production/image/video/film jobs with frozen inputs, worker locks,
+  cooperative cancellation and recovery without blindly repeating external inference.
+- Add shot sequences for stills, document timelines and video clips, camera movement,
+  crossfades, captions, explicit audio mixing and staged ZIP/MP4/WebM exports. Generated
+  video uses an opt-in HTTP job gateway; live service calls are not part of offline tests.
+- Expose production through `vixl workflow`, Python and workspace MCP, with fixed-project
+  REST checks/actions/planning. Keep the inline MCP operation schema below its existing
+  size budget by hoisting shared constraints and moving field prose to schema discovery.
+- Add an offline production example and [workflow reference](docs/production.md).
+
+## 0.13.0
+- **Color language.** Every color field accepts CSS Color 4/5 notations (`lab()`, `lch()`, `oklab()`, `oklch()`, `hwb()`, `color(display-p3|rec2020|srgb-linear|xyz …)`, `color-mix()`), `cmyk()`/`device-cmyk()`, `gray()`, `kelvin()`, 148 CSS and 938 public-domain (CC0) xkcd survey color names, and modifiers (`lighten`, `darken`, `saturate`, `desaturate`, `mix`, `tint`, `shade`, `tone`, `alpha`, `rotate`, `complement`, `invert`, `grayscale`, `readable`). Swatches work inside expressions and may build on other swatches. Out-of-gamut colors are mapped by OKLCH chroma reduction.
+- **Color tools.** `vixl color` / `vixl_color` / `POST /color` describe, convert, harmonize (10 schemes), build 50–950 scales, mix and check WCAG contrast; `palette-generate` stores scales and harmonies as swatches.
+- **Print output.** CMYK JPEG/TIFF/PDF export via a supplied ICC profile (LittleCMS, rendering intents, embedded profile) or device-naive GCR with black generation and total ink limits; PDF and ICO export; `export-icons` for web/Apple/Android/Windows icon sets; dpi metadata from the canvas; soft proofing; color-vision simulation (Machado 2009). Opt-in `print` (ink coverage, effective image ppi, type under 6 pt, live area, bleed) and `color_vision` checks.
+- **Named sizes.** 150 sizes across print, stationery, photo, posters, packaging, social, web, ads, email, video, slides, screens, app stores, icons, logos and games. Print sizes keep physical units, dpi, bleed and a safe area with generated trim/safe guides. `vixl new NAME`, `canvas size`, `Project.sized()`, `vixl_document_create(size=…)`, and named artboard presets.
+- **Principled layouts.** 33 `layout-apply` composition systems (hero statement, editorial grid, split screen, rule of thirds, golden section, Z/F patterns, asymmetric balance, big number, quote, framed, diagonal band, typographic poster, product card, event poster, banner, letterhead, business card, slides, logo lockups, emblem, monogram, app icon, thumbnail, vertical story, price list, photo caption, minimal mark, bento grid). They adapt to the canvas and vary by seed (or content): contrast-checked color roles, a modular type scale, margins, alignment, accents and grids. Type is shrunk to fit small formats, and the choices are recorded in `state.layout`. `type-scale` defines character styles; new guidance covers typography, color, layout, accessibility, print, icons, motion and brushes.
+- **Brushes.** Editable paint layers store strokes and render them deterministically with 17 brushes (round, soft-round, airbrush, pencil, ink, fineliner, brush-pen, marker, highlighter, calligraphy, chalk, charcoal, crayon, watercolor, dry-brush, spray, splatter). Strokes support explicit or simulated pressure, tapers, paper/grain/canvas textures, wet edges, bristles, spray, erase, SVG-path input, per-stroke overrides and `brush-define`.
+- **Animation timelines.** `timeline-set`, `keyframe`, `keyframe-remove`, `animate`, `animate-preset` (22 presets) and `marker` animate any layer property (position, translate, scale, rotation, opacity, size, colors in OKLab, text, visibility, effect amounts) and the canvas background with 30+ easings. Frames render with `render --time`, contact sheets show motion at a glance, and `export-timeline` writes GIF, APNG, animated WebP, sprite sheets, PNG-sequence ZIPs, or MP4/WebM with ffmpeg.
+- **Interfaces.** New MCP tools `vixl_sizes_list`, `vixl_layouts_list`, `vixl_brushes_list`, `vixl_color`, `vixl_timeline_inspect`, `vixl_timeline_preview`, `vixl_export_timeline` and `vixl_export_icons`; preview/export/check tools gain time, proof, simulation and print options. REST adds `/sizes`, `/layouts`, `/brushes`, `/color`, `/timeline`, `/timeline/frame` and `/timeline/export`.
+- **Fixes.** Project lock files are removed after use (filelock 3.21+ is now required). Model routing consults a saved catalog before loading an optional SDK, and the native Anthropic adapter test skips without the `anthropic` extra. CSS color names keep priority even after Pillow caches parsed names. Swatch definitions may reference other swatches.
+- **Docs.** The provider documentation records that the adapters have been used successfully against real services. New guides cover [sizes and layouts](docs/sizes-and-layouts.md), [color and print](docs/color-and-print.md) and [brushes and animation](docs/brushes-and-animation.md), and the agent skill gains matching references.
+
+## 0.12.1
+- Reject inaccessible pending runtimes without crashing the launcher, including Windows access-denied errors during file inspection. Preserve the active runtime even when no previous version exists, retain the underlying error/path in update status, and keep update settings available without starting the engine.
+- Activate explicit `vixl update` commands before returning, with a final installed-path health check, accurate active/previous version reporting, and rollback retention. Background updates still stage without disrupting running sessions.
+- Handle update/check/rollback in the stable Windows launcher even when the active engine cannot import. Existing launchers gain these controls by running the new installer.
+- Inspect visible nested group content in design checks and contrast measurements, accounting for group transforms, opacity, clipping and child targeting instead of reporting zero text layers.
+- Report vector-only status and raster fallback reasons in saved SVG CLI results; retain strict SVG rejection and vector group/text regressions.
+- Document same-session PATH setup, multiple-install/version diagnosis, and migration from older staged updaters.
+
+## 0.12.0
+- Add 19 local, editable artistic filters: sepia, duotone, solarize, pixelate, halftone, crosshatch, ink-blot, stamp, photocopy, pencil-sketch, charcoal, find-edges, emboss, oil-paint, watercolor, swirl, ripple, wave and glass. No AI provider/model is used; seeded treatments are repeatable.
+- Share HarfBuzz shaping, bidi/script runs, layout and outlined glyph geometry between PNG and SVG, including ligatures, combining characters, supported Unicode scripts, wrapping/fitting, multiline/path text and warp presets. Outline rendering can slightly change text spacing/antialiasing from earlier versions.
+- Keep common color adjustments, blur, drop shadow, glow, stroke, color overlays, vector clipping and supported adjustment layers native in SVG. Preserve unaffected vector layers around unsupported raster appearances.
+- Add strict SVG export policy through CLI, Python, REST and MCP, with responsible layer/effect details and no output overwrite on rejection. SVG filters are allowed; bitmap sources and unsupported appearances remain explicit limitations.
+- Add visual/filter/history/parameter regression tests and frozen Windows checks for the new shaping and rendering dependencies.
+
+## 0.11.1
+- Fix Windows CLI normalization/Unicode response encoding, including frozen executables and redirected output; successful saved edits no longer fail while printing normalization notes.
+- Correct native SVG rotation to use the same clockwise direction as PNG.
+- Preserve scalable logo groups, gradients, pixel grids, opaque boolean silhouettes and outlined plain ASCII wordmarks in SVG. Report remaining raster fallbacks in SVG metadata; complex text and unsupported appearances remain faithful raster fallbacks.
+- Compress embedded fonts again while retaining original compressed image bytes without recompression; restore compact font-heavy logo project sizes.
+- Load the image engine lazily for version/global-help commands, reducing startup overhead on discovery paths.
+- Reconcile agent skill/output/blur/path documentation, and add independent SVG rendering plus frozen Windows workflow regressions.
+
+## 0.11.0
+
+- Position Vixl and its documentation as a headless application designed for autonomous AI agents.
+- Add self-contained SVG exports with native simple shapes/Bézier paths and documented raster fallbacks; expose export formats through CLI, Python, REST and MCP. Verify transparent PNG and JPEG background flattening.
+- Add 16 shape/path shortcuts, editable single-contour Bézier paths, and geometry guidance for rotated logo construction.
+- Add 32 palettes, six reusable design templates, custom resource registration, and portable overall/style design guidance included in AI planning.
+- Add explicit local/HTTPS TTF/OTF font imports, registered document fonts, and workspace font tools.
+- Add document-independent command discovery/help and compact CLI edit responses with `--detail full` opt-in.
+- Add authenticated model discovery, capability routing, and native Anthropic/Gemini plus OpenAI-compatible Mistral/Meta adapters. Midjourney is supported only through a user-configured HTTP gateway.
+- Cover new features with offline regression tests; live paid-provider inference requires user credentials and is not exercised by CI.
+
+
+Vixl's main users are AI agents; this release targets long agent sessions, fewer round trips and fewer tokens.
+
+**Long sessions**
+- History stores structural deltas with a full snapshot every 32 revisions (`.vixl` format 2; format 1 still loads). Historical revisions are validated when restored.
+- Reaching `max_history` squashes the oldest unreferenced revisions instead of making the document read-only.
+- Edits no longer deep-copy the whole history: edit latency stays flat (≈20 ms after hundreds of edits instead of growing past 100 ms).
+- Imported PNG/JPEG/WebP files keep their original bytes and image assets are stored without recompression: a 24 MP JPEG document is 2.8 MB instead of 25 MB and an edit autosaves in ≈0.04 s instead of ≈1.1 s. Unreferenced assets are dropped on save.
+- Saving preserves an existing file's permissions (it used to force 0600) and new files honor the umask.
+
+**Agent ergonomics**
+- A shared normalizer accepts common model guesses in every interface (shape/type aliases, camelCase keys, `font_size`, `fill`/`color`, opacity 0–100, CSS `rgba()`, style shorthands, `"N%"` and `"center"` geometry) and reports each rewrite under `normalized`. Blur `radius` is read as `amount` (it was previously accepted and silently ignored). The command line no longer divides opacity separately.
+- Errors carry `operation_index`, `operation_type`, `field`, `allowed` and `suggestions`; MCP now passes this structure through instead of a flat string.
+- MCP results are minified JSON without duplicated structured content; advertised schemas drop pydantic titles and Optional wrappers. Compact diffs return new values only; new layers return name/type/bounds; `vixl_document_inspect` defaults to a compact summary; measurements summarize histograms unless `histogram: "full"`.
+- `vixl mcp --schema slim` plus `vixl_operation_schema` for on-demand field lookup. `vixl_ai_plan` is opt-in (`--planner`).
+- New: `vixl_check` / `vixl check` / `Project.check` / `POST /check` (bounds, text overlap, WCAG contrast, safe area and reserved zones, thumbnail legibility); `vixl_render_compare` / `POST /compare` (side-by-side or diff of revisions, `head~N`, `previous`); zoomable previews (`region`); `vixl_document_close`; `Project.at(ref)` and `Project.resolve_ref(ref)`.
+- Sessions keep up to 8 documents open; every MCP tool accepts `document`. `vixl_import_image` accepts base64 or data URLs. `vixl_import_image` now returns a compact layer summary.
+
+**Speed**
+- Plain layers composite only over their own bounds (12 MP, 30 layers: 8.5 s → 0.09 s). Decoded images are cached; JPEGs decode at reduced scale when shown smaller.
+- Previews render a scaled proxy of the document: a 24 MP preview takes ≈0.25 s instead of ≈2.7 s.
+
+**AI providers**
+- New Gemini (`gemini-3.1-flash-image`, `gemini-3.8-flash`), Black Forest Labs FLUX (`flux-2-pro`, `flux-pro-1.0-fill`) and Anthropic (`claude-opus-5-5`, official SDK via the `anthropic` extra, server-side refusal fallbacks) adapters.
+- OpenAI defaults to `gpt-image-2.5-flare` with multiple-of-16 sizes and `gpt-5-mini` for vision/planning.
+- Preset-size providers' images are fitted to the canvas and the original size recorded as `resized_from`. Detection results share one shape. AI plan safety checks run after normalization.
+
+**Evaluation**
+- `evals/`: eight design briefs with programmatic checks and reference solutions, a harness that drives the real MCP server, a Claude agent (official SDK), and a manual GitHub workflow for live runs.
+
+**Documentation**
+- Add the `skills/vixl` agent skill covering MCP tools, CLI commands, REST routes, the Python API, every operation type, AI providers and tested recipes, updated for this release (check/compare/zoom tools, structured errors, normalization, multi-document sessions, new providers).
+
+**Packaging**
+- The version is single-sourced from `vixl.__version__`.
+
+## 0.10.0
+
+- Rename the application to Vixl throughout: `vixl` CLI, `vixl-engine` distribution, `vixl` Python API, and `VixlError`.
+- Use `.vixl` documents, `.vixlscript` scripts, `vixl_*` MCP tools, `VIXL_*` environment variables, and Vixl configuration/session paths.
+- Brand Windows installers, bundled executables, update manifests, release assets, repository links, documentation, and examples as Vixl.
+- Start a distinct Windows installation identity; no legacy command, import, or file-format compatibility aliases are provided.
+
+## 0.9.0
+
+- Add opt-in spacing analysis for equal gaps, expected distances and balanced space before/after an object, with tolerances and structured measurements.
+- Add compact palette-indexed pixel layers, integer pixel/line/rectangle/flood-fill tools, named animation frames with timing, and nearest-neighbor GIF/APNG/sprite-sheet export.
+- Expose compact pixel/frame inspection and spacing tools through CLI, Python, REST and typed MCP tools; keep frame-save responses free of full snapshots by default in MCP.
+
+- Add editable design operations: groups/clipping, procedural shapes, layer styles, linked typography and swatches, frames, repeats/blends, guides/grids, pathfinder and symbols.
+- Add artboards, CSV data-set rendering, layer comps and multi-scale screen exports.
+- Add richer gradients, adjustment layers, histogram-based automatic corrections, named 3D LUTs, text box/warp/polyline layout, and read-only pixel/histogram/contrast measurements.
+- Expose shared operations through CLI/Python/REST/MCP and AI plans, plus provider-backed Remove, Content-Aware Fill and Select Subject.
+- Rebuild the example poster with one repeated stripe clipped to a live ellipse.
+
+## 0.8.0
+
+- Expose canonical operation schemas directly in MCP tools/list, including required fields and enums; no resource fetch needed.
+- Return changed layer fields by default; opt into full snapshots with `detail: "full"`. Paginate MCP history and allow inspection of one layer.
+- Bound MCP PNG previews to 1024×1024 and 1 MiB by default, with explicit dimension/byte controls and aspect-preserving resizing.
+- Add workspace browsing, document creation/opening, path-based image import, and full-resolution file export. Start with `vixl mcp --workspace DIR` without an existing project.
+- Replace MCP CLI-string AI dispatch with typed tools for generation, background removal, selection, planning, analysis, upscale, regeneration, and outpainting.
+- Keep service projects loaded between calls, detect external file changes, and serialize edits across threads/processes without losing updates. Discard cached state after failed operations/saves.
+- MCP migration: `vixl_import_image` now accepts `path` instead of `image_base64`; `vixl_ai` is replaced by the typed `vixl_ai_*` tools. Existing `--project FILE mcp` launch configurations still work, with the project's parent as workspace. CLI/Python AI interfaces remain compatible.
+
+## 0.7.0
+
+- Add a per-user Windows installer with bundled Python, font, REST and MCP dependencies.
+- Register a stable `vixl` command in the Windows user PATH; uninstall without removing user projects.
+- Check published stable GitHub releases in the background once per day when Vixl starts.
+- Verify downloaded runtime checksums, validate archive paths, and health-check side-by-side runtimes before activation.
+- Preserve existing sessions and the previous runtime; add manual check/update, opt-out/status, and rollback commands.
+- Build installer/update/Python artifacts and publish complete GitHub releases from matching version tags.
+- Add Python 3.14 CI and native Windows installer/update/uninstall tests.
+
+## 0.6.0
+
+- Initial programmable image engine with editable projects, CLI/shell, automation, AI provider adapters, REST, and MCP.