pixelkiln 0.10.0 → 0.11.0

package/PROVIDERS.md

@@ -72,7 +72,7 @@ prompt, size, batch, and optional seed inputs PixelKiln may replace.
 | Cost model | `0 free`; local compute and hosting are outside PixelKiln's estimate |
 | Reproducibility | Workflow content is hashed; model files, custom-node versions, and runtime settings must still be managed outside PixelKiln |
 | Account lifecycle | Read-only connectivity check; no balance, remote object listing, tagging, or purge |
-| Confidence | Full mocked coverage plus live generation, four-candidate review, and cache-only restore on Apple MPS; cleanup and native-grid experiments remain manual, and aesthetic approval remains human |
+| Confidence | Full mocked coverage plus live generation, four-candidate review, cache-only restore, and three provider-neutral refinement runs on Apple MPS; background removal stays in the graph and aesthetic approval remains human |
 
 Choose ComfyUI when workflow ownership is worth manual validation. If the goal
 is the least cleanup between a prompt and usable pixel art, start with a
@@ -208,10 +208,11 @@ estimate and hard budget remain enforced.
 ## What to build next
 
 The first ComfyUI release has a live, versioned core-node reference workflow.
-Transport, candidate review, provenance, and cache recovery work. Art quality is
-still the gap. The tested SDXL plus Pixel Art XL graph is useful for composition,
-but it is not a production preset. Native-grid recovery, final palette
-enforcement, prompt coverage, and aesthetic approval remain manual.
+Transport, candidate review, provenance, cache recovery, native-grid recovery,
+final palette enforcement, and a fail-closed approval record now work. The
+tested SDXL plus Pixel Art XL graph is useful for composition, but it is not a
+production preset. Background removal stays in the graph. Prompt coverage,
+pixel clusters, and aesthetic approval still require a person.
 
 Native per-style provider routing remains the highest-value orchestration
 feature. One manifest should be able to send a building style to PixelLab, an
@@ -238,20 +239,18 @@ documents free cost preflights. That combination adds something the current
 providers do not: a project-specific visual model with a cost check that can be
 captured before submission.
 
-Recommended order:
+Recommended order from here:
 
-1. Build a provider-neutral post-processing record for background removal,
-   native-grid recovery, final palette enforcement, and human approval.
-2. Benchmark pinned ComfyUI models and prompt patterns across at least two scene
+1. Benchmark pinned ComfyUI models and prompt patterns across at least two scene
    families. Reject any supposed improvement that helps only one subject.
-3. Add per-style provider selection, provider-keyed budgets, and mixed-provider
+2. Add per-style provider selection, provider-keyed budgets, and mixed-provider
    integration tests.
-4. Finish live Retro Diffusion multi-candidate, tileset, GIF, and spritesheet
+3. Finish live Retro Diffusion multi-candidate, tileset, GIF, and spritesheet
    smoke tests.
-5. Build the Scenario still-image spike from issue #52 with dry-run cost, submit, poll,
+4. Build the Scenario still-image spike from issue #52 with dry-run cost, submit, poll,
    download, and one custom-model or reference-image benchmark.
-6. Design ComfyUI Cloud as a separate authenticated and billable adapter.
-7. Consider general raster marketplaces only with explicit nearest-neighbor,
+5. Design ComfyUI Cloud as a separate authenticated and billable adapter.
+6. Consider general raster marketplaces only with explicit nearest-neighbor,
    palette, transparency, and reproducibility checks.
 
 Midjourney is not an adapter target without an official public API. Automating

package/README.md

@@ -197,8 +197,10 @@ and native-grid recovery for model output that only looks like pixel art. The
 ComfyUI guidance is quality-first: start with 48–128px native components,
 apply the final palette after grid recovery, require prompt-coverage and human
 cluster-and-silhouette review, and compose larger scenes from accepted parts
-instead of chasing a larger raster. Those cleanup and approval steps are manual
-today.
+instead of chasing a larger raster. Background removal and the art decision
+still need the graph and a person. `pixelkiln refine` now handles grid recovery,
+final palette enforcement, measurable checks, and the hash-bound approval
+record.
 
 The schema rejects unknown fields and invalid generator combinations before
 planning. See the [Manifest reference](./docs/MANIFEST.md).
@@ -219,6 +221,12 @@ pixelkiln restore
 # Optional local gates.
 pixelkiln audit --check --max-distance 35 --min-transparency 0.1
 pixelkiln cache --check
+
+# Provider-neutral pixel cleanup after selecting a generated candidate.
+pixelkiln refine --from candidate.png --out art/native.png \
+  --palette "#141b1e,#23312a,#384d4f,#526a8d,#709fcf,#865c45,#c6a766,#f1bb70"
+pixelkiln refine approve --from art/native.pixelkiln.json --reviewer "Your Name"
+pixelkiln refine check --from art/native.pixelkiln.json
 ```
 
 Repeated `--style`, `--only`, `--claims`, and `--output-role` filters
@@ -339,9 +347,10 @@ const plan = await buildPlan(specs, await loadLock("pixelkiln.lock.json"))
 console.log(plan.cost, plan.costUnit, plan.actionable.length)
 ```
 
-The package also exports audit gates, lock/output helpers, provider contracts,
-pipeline stages, sprite packing/mounting, tile exporters, managed artifact
-writes, and offline provenance verification. See [Library API](./docs/LIBRARY.md).
+The package also exports audit gates, provider-neutral refinement, lock/output
+helpers, provider contracts, pipeline stages, sprite packing/mounting, tile
+exporters, managed artifact writes, and offline provenance verification. See
+[Library API](./docs/LIBRARY.md).
 
 ## Documentation
 
@@ -356,10 +365,10 @@ writes, and offline provenance verification. See [Library API](./docs/LIBRARY.md
 | [Manifest reference](./docs/MANIFEST.md) | Every style/asset field and generator constraint. |
 | [Agent workflows](./docs/AGENTS.md) | Official skill install, operating model, and provider-aware safety. |
 | [Generators](./docs/GENERATORS.md) | Capability choice, measured costs, palettes, style references, and tiles. |
-| [Environment provider benchmark](./docs/PROVIDER_BENCHMARK.md) | Thirty provider outputs plus three deterministic native-grid results comparing large scenes, transparency, palette size, and file readiness. |
-| [Derived artifacts](./docs/ARTIFACTS.md) | Pack, mount, export, provenance, ownership, transactions, and recovery. |
+| [Environment provider benchmark](./docs/PROVIDER_BENCHMARK.md) | Thirty provider outputs plus native-grid and final-palette results comparing large scenes, transparency, palette size, and file readiness. |
+| [Derived artifacts](./docs/ARTIFACTS.md) | Refine, pack, mount, export, provenance, ownership, transactions, and recovery. |
 | [Recovery](./docs/RECOVERY.md) | Restore, caches, adopt, salvage, claims, and purge safety. |
-| [Quality gates](./docs/QUALITY.md) | Plan, doctor, audit, cache, JSON, and CI. |
+| [Quality gates](./docs/QUALITY.md) | Plan, doctor, refine, audit, cache, human approval, JSON, and CI. |
 | [Architecture](./docs/ARCHITECTURE.md) | State model, lockfile, providers, concurrency, and output identity. |
 | [Library API](./docs/LIBRARY.md) | Public TypeScript contracts and examples. |
 | [Tiles](./docs/TILES.md) | Structural outputs and generic/Tiled/Godot formats. |

package/dist/cli.d.ts

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+type GridConfidence = "low" | "medium" | "high";
+
 type TilesetFormat = "generic" | "tiled" | "godot";
 
 interface Args {
@@ -34,6 +36,12 @@ interface Args {
     minTransparency?: number;
     maxColors?: number;
     sigma?: number;
+    palette: string[];
+    fixerPython?: string;
+    fixerRevision?: string;
+    minGridConfidence?: GridConfidence;
+    reviewer?: string;
+    note?: string;
     /** `workspace`: add/remove/list/status/claims. */
     subcommand?: string;
     /** Path to a workspace catalog. Defaults to `pixelkiln.workspace.json` in cwd. */
@@ -52,7 +60,7 @@ interface Args {
      */
     explicitLock?: string;
 }
-declare const COMMANDS: readonly ["init", "plan", "doctor", "gen", "submit", "poll", "pick", "fetch", "restore", "adopt", "accept", "salvage", "purge", "prune", "audit", "cache", "pack", "mount", "export", "tag", "balance", "status", "workspace", "help", "--help", "-h", "--version", "-v"];
+declare const COMMANDS: readonly ["init", "plan", "doctor", "gen", "submit", "poll", "pick", "fetch", "restore", "adopt", "accept", "salvage", "purge", "prune", "audit", "cache", "pack", "mount", "export", "tag", "balance", "status", "refine", "workspace", "help", "--help", "-h", "--version", "-v"];
 /**
  * Strict parsing. Unknown flags are a hard error rather than being ignored,
  * because a silently-dropped filter is expensive here: `--styles neon` (plural,