pixelkiln 0.3.0 → 0.4.0

package/docs/AGENTS.md

@@ -35,7 +35,7 @@ The skill guides the workflow; PixelKiln remains the deterministic execution
 layer. This separation keeps agent reasoning out of polling, hashing, downloads,
 state transitions, and output placement.
 
-## PixelLab MCP and PixelKiln
+## Providers, PixelLab MCP, and PixelKiln
 
 The [official PixelLab MCP server](https://github.com/pixellab-code/pixellab-mcp)
 gives an agent direct PixelLab creation tools. It is complementary to PixelKiln,
@@ -47,10 +47,17 @@ not a replacement:
 | PixelKiln skill | Agent guidance for safe project-level operations. |
 | PixelKiln library/CLI | Budgets, state, provenance, review, recovery, audit, and packaging. |
 | PixelLab adapter | The current production and live-tested generation backend. |
-
-PixelKiln's core is provider-neutral by design, but PixelLab is the only
-production adapter today. Do not claim compatibility with another backend until
-its adapter and live integration tests ship.
+| Retro Diffusion adapter | Experimental backend; authenticated paid single-still lifecycle plus mocked advanced-workflow tests. |
+
+PixelKiln's core is provider-neutral, but PixelLab remains the only production
+and paid-generation-tested adapter. Retro Diffusion generation support is
+experimental. Paid RD Fast and RD Plus single-candidate stills have passed from
+quote through validated download and recovery. Multi-candidate, tileset, GIF,
+and spritesheet workflows still need representative live smoke tests. See
+[PixelLab vs. Retro Diffusion](../PROVIDERS.md) before choosing a provider for a
+new project or a large environment asset. Once chosen, follow
+[Set up PixelLab](./PIXELLAB.md) or
+[Set up Retro Diffusion](./RETRO_DIFFUSION.md).
 
 ## Recommended first prompt
 

package/docs/ARCHITECTURE.md

@@ -5,7 +5,7 @@ PixelKiln separates provider mechanics from the project state machine:
 ```text
 manifest + lock + planning + review + recovery + artifact pipelines
 ──────────────────── Provider interface ─────────────────────────
-PixelLabProvider             FakeProvider             future adapters
+PixelLabProvider      RetroDiffusionProvider      FakeProvider      future adapters
 ```
 
 Everything above the provider boundary is backend-neutral. URL shapes, auth
@@ -31,7 +31,8 @@ retain:
 - provider and remote object/job ids;
 - explicit lifecycle status and errors;
 - source URLs/candidates/selections;
-- `outputs[]` with portable path, SHA-256, and optional structural role;
+- `outputs[]` with portable path, SHA-256, optional structural role, and
+  optional PNG/GIF media type;
 - provider-specific metadata under a provider-id namespace;
 - successful submission cost and cost unit.
 
@@ -41,9 +42,10 @@ are rebased in memory and rewritten portably on the next save. The current
 manifest remains destination authority; a stale lock path cannot redirect
 restore into an unrelated project file.
 
-Cost units that differ are never summed. `generations`, `usd`, and `free`
-stay separate. Candidate
-count also belongs to the provider estimate rather than being assumed globally.
+Cost units that differ are never summed. Built-in adapters currently use
+`generations`, `usd`, and `free`; custom adapters may register another
+non-empty unit. Candidate count also belongs to the provider estimate rather
+than being assumed globally.
 
 ## State machine
 
@@ -72,8 +74,9 @@ and exporters all use the same role model. A consumer must request a role when
 there is no unambiguous primary output.
 
 PNG ingestion validates signature, chunks, CRCs, palettes, compressed data,
-scanlines, dimensions, and supported color modes before bytes become durable
-output or recovery cache data.
+scanlines, dimensions, and supported color modes. GIF ingestion walks the
+logical screen, color tables, extensions, image-data blocks, and trailer. Both
+formats are validated before bytes become durable output or recovery cache data.
 
 ## Concurrency and lock saves
 
@@ -112,11 +115,18 @@ byte is structurally validated before use.
 
 ## Provider capability boundary
 
-Required provider members cover support/estimate, submit, poll, selection where
-applicable, and download. Account-wide listing, tagging, deletion, and balance
-are optional. Commands such as adopt or salvage report a capability gap rather
-than failing through an undefined method.
-
-`FakeProvider` implements the same contract in memory, which keeps the paid
-pipeline testable without credentials or network access. See
-[library API](./LIBRARY.md) and [provider notes](../PROVIDERS.md).
+Providers are selected from a registry by the manifest's top-level `provider`
+id. Required members cover support/estimate, submit, poll, and download;
+candidate selection is required only when an adapter can return alternatives.
+Account-wide listing, tagging, deletion, and balance are optional. Commands
+such as adopt or salvage report a capability gap rather than failing through
+an undefined method.
+
+`PixelLabProvider` is production and live-tested. `RetroDiffusionProvider` is
+an experimental still, tileset, and animation adapter. Authenticated RD Fast
+and RD Plus single-candidate still lifecycles have passed end to end. Its
+multi-candidate, tileset, GIF, and spritesheet paths retain mocked coverage
+pending paid live smokes. `FakeProvider` implements the same contract in memory, which
+keeps the paid pipeline testable without credentials or network access. See
+[library API](./LIBRARY.md) and
+[PixelLab vs. Retro Diffusion](../PROVIDERS.md).

package/docs/CLI.md

@@ -9,6 +9,11 @@ Unknown commands, positional arguments, and flags are errors. Repeated
 separated values work too. This strict parsing prevents a misspelled filter
 from widening a paid run.
 
+The manifest's top-level `provider` field selects the provider for `plan`,
+`doctor`, and pipeline commands. It defaults to `pixellab`; the built-in
+`retrodiffusion` adapter is experimental and supports still-image
+`map`/`pixflux`, `tiles` sheets, and `animation` GIF/spritesheet work.
+
 ## Everyday pipeline
 
 ### `init`
@@ -73,9 +78,10 @@ for a screenshot of the actual interface.
 
 ### `fetch`
 
-Download completed or selected outputs, validate complete PNG structure, write
-the manifest-authoritative destinations, populate the content cache, and update
-output hashes. `--tag` also pushes manifest tags after successful downloads.
+Download completed or selected outputs, validate complete PNG or GIF structure,
+write the manifest-authoritative destinations, populate the content cache, and
+update output hashes. `--tag` also pushes manifest tags after successful
+downloads when the provider supports tagging.
 
 ### `restore`
 
@@ -134,7 +140,8 @@ or download artwork.
 
 ### `balance`
 
-Show the provider's remaining balance and cost unit.
+Show the manifest-selected provider's remaining balance and cost unit. Reports
+a capability error when an installed provider has no balance endpoint.
 
 ### `status`
 
@@ -160,29 +167,28 @@ Subcommands:
 
 | Subcommand | Effect |
 |---|---|
-| `add <manifest>` | Registers a project. Id defaults to the manifest's `name`; `--name` overrides it. Lock defaults to `pixelkiln.lock.json` beside the manifest; `--lock` overrides it. `--provider` sets the provider id (default `pixellab`); `--account` sets a free-form account label. Refuses a duplicate id or a lockfile already registered under another id. Warns, but does not refuse, when the lock does not exist yet. |
+| `add <manifest>` | Registers a project. Id defaults to the manifest's `name`; `--name` overrides it. Lock defaults to `pixelkiln.lock.json` beside the manifest; `--lock` overrides it. `--provider` overrides the manifest's provider id; `--account` sets a free-form account label. Refuses a duplicate id or a lockfile already registered under another id. Warns, but does not refuse, when the lock does not exist yet. |
 | `remove <id-or-manifest>` | Drops a registration by project id or by manifest path. Touches no art, no lock, no provider account. |
 | `list` | Lists registered projects and catalog diagnostics. Refuses if the catalog file does not exist. |
 | `status` | Aggregate provider, spend-by-unit, plan state, and claim count, offline. Provider cost units are never summed across each other. Refuses if the catalog file does not exist. |
-| `claims` | Validates the catalog and emits the exact union of `objectId`/`reviewObjectId`/`jobId` across every registered lock. Refuses — rather than silently omitting a project — when any registered lock is missing, unreadable, or the catalog itself has a duplicate id or duplicate lock path. |
+| `claims` | Validates the catalog and emits the exact union of `objectId`/`reviewObjectId`/`jobId` across every registered lock. Refuses to omit a project when any registered lock is missing or unreadable, or when the catalog has a duplicate id or lock path. |
 
 `--workspace <path>` selects the catalog file; it defaults to
 `pixelkiln.workspace.json` in the current directory. Stored paths are relative
 to the catalog file's own directory, so a catalog survives a clone or move.
 `list`/`status` support `--json` and `--check` (nonzero exit on any error-level
 diagnostic); both treat a nonexistent catalog file as a hard error rather than
-an empty, vacuously-safe one — the same hazard class as an incomplete claim
-set. In `--json` output, the `workspace` key always names the catalog *file*;
-`status` additionally reports `dir`, the catalog's own directory that
+an empty, vacuously-safe one. This is the same hazard class as an incomplete
+claim set. In `--json` output, the `workspace` key always names the catalog *file*;
+`status` also reports `dir`, the catalog's own directory that
 registered paths resolve against.
 
-Passing `--workspace <path>` to `salvage` derives its claim set, and its
-sibling-manifest style signal, from every project the catalog registers;
-`--claims` still works and unions with both — the combined lockfile claim set
-and the combined sibling-manifest list. A missing or unreadable registered
-lock is a hard error there too — never silently skipped — because it is
-precisely the account-wide claim completeness this catalog exists to
-guarantee. See
+Passing `--workspace <path>` to `salvage` derives its claim set and its
+sibling-manifest style signal from every project the catalog registers.
+`--claims` still works and joins both the lockfile claim set and sibling
+manifest list. A missing or unreadable registered lock is a hard error there
+too. PixelKiln never skips one because the catalog exists to guarantee a
+complete account-wide claim set. See
 [Recovery and account safety](./RECOVERY.md#shared-workspace-catalog).
 
 ## Local quality and derived output
@@ -262,7 +268,7 @@ Print the package version. `-v` is an alias.
 | `--tag` | fetch/adopt | Also push tags after the command's primary work. |
 | `--claims <paths>` | salvage | Other project lockfiles; repeatable and comma-separated. |
 | `--workspace <path>` | workspace/salvage | Workspace catalog path; defaults to `pixelkiln.workspace.json`. On salvage, derives the claim set instead of repeated `--claims`. |
-| `--provider <id>` | workspace add | Provider id to register the project under; defaults to `pixellab`. |
+| `--provider <id>` | workspace add | Provider id to register the project under; defaults to the target manifest's provider. |
 | `--account <label>` | workspace add | Free-form account label, e.g. distinguishing sandboxes. |
 | `--all` | salvage dry run | List every unclaimed object rather than the first 30. |
 | `--from <dir>` | init | Existing source tree to scan. |

package/docs/GENERATORS.md

@@ -32,6 +32,11 @@ It does not accept style images or a forced palette. On a measured 1-bit restyle
 switching from reference-anchored generation to `map` changed median palette
 distance from 6.6 to 41.9; cheap output is not cheap when unusable.
 
+The API describes map objects as transparent, but both 256px isolated-object
+attempts in the [environment provider benchmark](./PROVIDER_BENCHMARK.md) were
+opaque. `map` has no `noBackground` control in PixelKiln. Check alpha before
+assuming the file can be placed directly over a map.
+
 ## `1dir`
 
 `1dir` is the single-facing sibling of PixelLab's rotatable/animated object

package/docs/GETTING_STARTED.md

@@ -1,6 +1,6 @@
 # Getting started
 
-Pixelkiln turns a committed asset manifest into generated files with a
+PixelKiln turns a committed asset manifest into generated files with a
 committed provenance lockfile. Planning, auditing, packing, mounting, and
 exporting are local operations. Only generation, provider polling, candidate
 selection, downloads, tagging, account adoption, salvage, purge, and balance
@@ -9,7 +9,8 @@ checks need provider access.
 ## Requirements
 
 - Node.js 20 or newer
-- A PixelLab API key for provider-backed commands
+- A credential for the manifest's selected provider: `PIXELLAB_API_KEY` for
+  PixelLab or `RD_API_KEY` for experimental Retro Diffusion support
 - A repository checkout until the first npm release in
   [issue #1](https://github.com/gfargo/pixelkiln/issues/1) is complete
 
@@ -53,6 +54,24 @@ in `.env.local` beside the manifest:
 PIXELLAB_API_KEY=...
 ```
 
+For experimental Retro Diffusion generation, set the manifest's
+top-level `provider` to `retrodiffusion` and use:
+
+```dotenv
+RD_API_KEY=...
+```
+
+Its still, tileset-sheet, animated-GIF, and PNG-spritesheet workflows are
+implemented. Authenticated single-candidate RD Fast and RD Plus stills have
+passed from quote through validated download, provenance, and cache.
+Multi-candidate, tileset, GIF, and spritesheet live runs remain, so PixelLab
+remains the production adapter. See
+[Manifest reference](MANIFEST.md#experimental-retro-diffusion) for
+provider options and current limits, or
+[PixelLab vs. Retro Diffusion](../PROVIDERS.md) for selection guidance.
+The provider setup guides give the shortest complete path for
+[PixelLab](PIXELLAB.md) and [Retro Diffusion](RETRO_DIFFUSION.md).
+
 Before spending anything, validate and price the selected work:
 
 ```bash
@@ -134,8 +153,8 @@ pipeline stages also exit nonzero after partial failures or timeouts.
 - `restore` repairs missing generated outputs without buying new generations.
 - `.pixelkiln/cache/` stores downloaded PNG bytes by SHA-256, so restoration can
   still work after a temporary provider URL expires.
-- `cache --check` verifies hashes and fully decodes cached PNG structure before
-  trusting recovery bytes, then validates the account object-hash cache.
+- `cache --check` verifies hashes and structurally validates cached PNG/GIF
+  media before trusting recovery bytes, then validates the account object-hash cache.
   `cache --prune` removes corrupt, partial, and unreferenced project content
   plus invalid hash entries. It does not mistake
   objects belonging to another project for disposable account data.
@@ -143,7 +162,7 @@ pipeline stages also exit nonzero after partial failures or timeouts.
 - `salvage --claims <every-other-lockfile>` reviews remote objects no project
   currently claims. `salvage` never deletes; `purge` is a separate confirmed
   operation.
-- Pixelkiln refuses to overwrite a file whose bytes differ from its recorded
+- PixelKiln refuses to overwrite a file whose bytes differ from its recorded
   hash. Resolve intentional hand edits explicitly.
 
 ## What belongs in Git

package/docs/LIBRARY.md

@@ -1,6 +1,6 @@
 # Library API
 
-Pixelkiln's public package entry point exposes the same provider-independent
+PixelKiln's public package entry point exposes the same provider-independent
 primitives used by the CLI. Use these when a build tool, editor integration, or
 game pipeline needs structured results instead of terminal output.
 
@@ -130,9 +130,9 @@ await fetchAssets(provider, specs, lock, lockPath)
 ```
 
 Provider-backed operations mutate the supplied lock object; persist at the
-workflow boundary with `saveLock`. See [PROVIDERS.md](../PROVIDERS.md) before
-implementing another backend, especially its optional capabilities and cost
-units.
+workflow boundary with `saveLock`. See
+[PixelLab vs. Retro Diffusion](../PROVIDERS.md) before selecting or implementing
+another backend, especially its optional capabilities and cost units.
 
 `submit` validates adapter estimates again at the spending boundary and returns
 `{ spent, unit }` for successful submissions. Lock entries retain fractional

package/docs/MANIFEST.md

@@ -9,6 +9,7 @@ directory. The canonical machine-readable contract is
 {
   "$schema": "./node_modules/pixelkiln/schema/manifest.schema.json",
   "name": "my-game",
+  "provider": "pixellab",
   "styles": {
     "base": {
       "generator": "map",
@@ -31,6 +32,7 @@ Unknown properties are rejected at every level.
 |---|---|---|
 | `$schema` | no | Editor schema URL/path. It does not affect generation identity. |
 | `name` | yes | Project/account tag namespace. |
+| `provider` | no | Provider registry id. Defaults to `pixellab`; `retrodiffusion` is experimental. |
 | `styles` | yes | Map of style id to inherited generation/output settings. |
 | `assets` | yes | Map of stable asset id to subject and per-asset overrides. |
 
@@ -42,19 +44,20 @@ not merely a label edit.
 
 | Field | Type/default | Meaning |
 |---|---|---|
-| `generator` | `map` | `map`, `1dir`, `pixflux`, or `tiles`. |
+| `generator` | `map` | `map`, `1dir`, `pixflux`, `tiles`, or provider-specific `animation`. |
 | `outDir` | string, required | Output directory relative to the manifest. |
 | `promptPrefix` | `""` | Prepended to every participating asset prompt. |
 | `promptSuffix` | `""` | Appended to every participating asset prompt. |
 | `styleImages` | `[]` | `{ "path": "..." }` reference images. Paths are manifest-relative. |
 | `size` | integer 32–256 | Square size for `1dir`; a style reference's dimensions take precedence when present. |
-| `view` | string | Provider-facing view/direction description. |
-| `outline` | string | PixelLab `map` outline setting. |
-| `shading` | string | PixelLab shading setting. |
-| `detail` | string | PixelLab detail setting. |
+| `view` | string | PixelLab `map`: `low top-down`, `high top-down`, or `side`. Other generators interpret this separately. |
+| `outline` | string | PixelLab `map`: `single color outline`, `selective outline`, or `lineless`. |
+| `shading` | string | PixelLab `map`: `flat shading`, `basic shading`, `medium shading`, or `detailed shading`. |
+| `detail` | string | PixelLab `map`: `low detail`, `medium detail`, or `high detail`. |
 | `seed` | integer | Deterministic provider seed where supported. |
 | `palette` | hex array, `[]` | Forced palette for `pixflux`; `#` is optional. |
 | `noBackground` | boolean, `true` | `pixflux` background removal. Set false for scenes/backdrops. |
+| `providerOptions` | object, `{}` | Options grouped by provider id. Only the active provider's object is resolved and hashed. |
 | `tileSize` | integer 16–256 | Edge length for `tiles` when no style reference supplies geometry. |
 | `tileType` | enum | `hex`, `hex_pointy`, `isometric`, `oblique`, `octagon`, or `square_topdown`. |
 | `tileView` | enum | `top-down`, `high top-down`, `low top-down`, or `side`. |
@@ -77,6 +80,101 @@ Generator-specific fields are validated before planning. Important constraints:
 
 See [generator selection](./GENERATORS.md) for costs and trade-offs.
 
+## Experimental Retro Diffusion
+
+Retro Diffusion maps `map` and `pixflux` to still generation, `tiles` to its
+tileset family, and `animation` to GIF or PNG-spritesheet generation. Durable
+sources and lock outputs record `image/png` or `image/gif`, so recovery retains
+the correct extension and validates the correct structure.
+
+```jsonc
+{
+  "name": "my-game",
+  "provider": "retrodiffusion",
+  "styles": {
+    "base": {
+      "generator": "map",
+      "outDir": "assets/generated/base",
+      "providerOptions": {
+        "retrodiffusion": {
+          "promptStyle": "rd_plus__default",
+          "numImages": 4,
+          "removeBg": true
+        }
+      }
+    }
+  },
+  "assets": {
+    "anvil": { "prompt": "a compact blacksmith anvil" }
+  }
+}
+```
+
+`promptStyle` accepts a live Retro Diffusion still-style selector,
+`numImages` accepts 1–16 candidates, and `removeBg` overrides
+`noBackground`. The Retro Diffusion API accepts 16–512px output, while the
+shared PixelKiln manifest currently limits arbitrary width and height to
+16–400px and square `size` to 32–256px. Selected styles can impose smaller
+limits. RD Pro and user styles accept up to nine reference images. Costs are
+planned in USD and checked again with Retro Diffusion's free authoritative
+quote endpoint before the paid request is sent. Authenticated single-candidate
+RD Fast and RD Plus paths have passed from quote through validated output and
+recovery.
+Multi-candidate, tileset, GIF, and spritesheet paths remain mock-tested, so the
+adapter is still experimental.
+
+Additional Retro Diffusion options are:
+
+| Option | Meaning |
+|---|---|
+| `framesDuration` | Animation duration: `4`, `6`, `8`, `10`, `12`, or `16`. |
+| `returnSpritesheet` | Return a PNG spritesheet instead of an animated GIF. |
+| `extraPrompt` | Outside texture description for `rd_tile__tileset_advanced`. |
+| `tileX` / `tileY` | Make supported still styles seamless on either axis. |
+
+An animation style is declared explicitly:
+
+```jsonc
+{
+  "generator": "animation",
+  "size": 64,
+  "outDir": "assets/generated/animations",
+  "providerOptions": {
+    "retrodiffusion": {
+      "promptStyle": "rd_animation__any_animation",
+      "numImages": 1,
+      "framesDuration": 8,
+      "returnSpritesheet": false
+    }
+  }
+}
+```
+
+The default output is `<assetId>.gif`; `returnSpritesheet: true` produces
+`<assetId>.png`. Advanced animation styles require exactly one `styleImages`
+input. PixelKiln currently limits animation batches to one so selection never
+loses the output media type.
+
+For a Wang-style tileset sheet:
+
+```jsonc
+{
+  "generator": "tiles",
+  "tileSize": 32,
+  "outDir": "assets/generated/tiles",
+  "providerOptions": {
+    "retrodiffusion": {
+      "promptStyle": "rd_tile__tileset",
+      "numImages": 1
+    }
+  }
+}
+```
+
+`rd_tile__tileset_advanced` accepts `extraPrompt` and up to two style images;
+`rd_tile__tile_variation` requires one style image. Provider-specific size and
+input constraints are checked during the free planning phase.
+
 ## Asset fields
 
 | Field | Type/default | Meaning |

package/docs/PIXELLAB.md

@@ -0,0 +1,100 @@
+# Set up PixelLab
+
+PixelLab is PixelKiln's default provider and the production choice for current
+projects. Its generation and account-management paths have been exercised
+against a live account.
+
+[Visit PixelLab](https://www.pixellab.ai/) or open the
+[official API reference](https://api.pixellab.ai/v2/docs).
+
+## Add the credential
+
+Create `.env.local` beside `pixelkiln.manifest.json`:
+
+```dotenv
+PIXELLAB_API_KEY=...
+```
+
+Keep this file out of Git. PixelKiln also reads the variable from the current
+process environment.
+
+## Select PixelLab
+
+The `provider` field is optional because `pixellab` is the default. Declaring it
+makes the choice clear:
+
+```jsonc
+{
+  "name": "my-game",
+  "provider": "pixellab",
+  "styles": {
+    "props": {
+      "generator": "map",
+      "outDir": "assets/generated/props",
+      "promptSuffix": ", isolated pixel-art game asset"
+    }
+  },
+  "assets": {
+    "anvil": {
+      "prompt": "a compact blacksmith anvil",
+      "width": 64,
+      "height": 64
+    }
+  }
+}
+```
+
+Run the free checks before a paid request:
+
+```bash
+pixelkiln doctor --dry-run
+pixelkiln plan
+pixelkiln gen --budget 1
+```
+
+Copy the exact estimate from `plan` into `--budget`. PixelLab budgets use
+subscription generations.
+
+## Choose a generator
+
+| Generator | Start here when | Measured cost |
+|---|---|---:|
+| `map` | You need one prop, icon, building, or landmark at arbitrary dimensions | 1 generation |
+| `pixflux` | You need a closed palette or a full-bleed background | 1 generation |
+| `1dir` | You need references or several candidates for human review | 20 to 40 generations |
+| `tiles` | You need ground variations or a connected structural set | 20 to 40 generations |
+
+`map` accepts these values:
+
+- `view`: `low top-down`, `high top-down`, or `side`
+- `outline`: `single color outline`, `selective outline`, or `lineless`
+- `shading`: `flat shading`, `basic shading`, `medium shading`, or `detailed shading`
+- `detail`: `low detail`, `medium detail`, or `high detail`
+
+PixelLab describes map objects as transparent, but the 256px map objects in our
+[environment benchmark](./PROVIDER_BENCHMARK.md) were opaque. Check the alpha
+channel before building a production batch. For a scenic background, use
+`pixflux` with `noBackground: false`.
+
+Read [Generator selection](./GENERATORS.md) for the full constraints and
+measured economics.
+
+## Account workflows
+
+The PixelLab adapter supports `balance`, `adopt`, `salvage`, `tag`, and the
+separate confirmed `purge` flow. These are useful when several projects share
+one provider account or when existing local art needs its original provenance.
+Read [Recovery and account safety](./RECOVERY.md) before changing remote
+objects.
+
+PixelLab's official
+[MCP server](https://github.com/pixellab-code/pixellab-mcp) gives agents direct
+access to PixelLab generation tools. It complements PixelKiln: the MCP handles
+creation, while PixelKiln owns project state, budgets, review, recovery, and
+packaging.
+
+## What is outside this adapter
+
+PixelLab offers more than PixelKiln currently exposes. Character generation,
+multi-direction rotation, and animation are not part of this adapter. Use the
+[manifest reference](./MANIFEST.md) for the fields PixelKiln supports today.