pixelkiln 0.20.2 → 0.22.0

package/README.md

@@ -55,7 +55,7 @@ PixelKiln keeps the missing record:
 | Workflow | What PixelKiln provides |
 |---|---|
 | Plan and budget | Offline manifest/lock/disk diff, provider-grouped estimates, keyed mixed-provider budget ceilings, JSON/CI gate. |
-| Generate and review | Resumable submit/poll/pick/fetch pipeline, exact next-step hints, and candidate or atomic frame-set review. |
+| Generate and review | Resumable submit/poll/pick/fetch pipeline, exact next-step hints, candidate or atomic frame-set review, and a read-only provenance gallery. |
 | Controlled inputs | Hashed image-to-image/inpaint lineage, fail-closed parent approval, source-versus-candidate review, and content-addressed per-asset ComfyUI bindings. |
 | Existing-art onboarding | Manifest scaffolding, exact-hash account adoption, and prompt recovery. |
 | Recovery | Safe stale-output replacement, validated caches, durable references, and resumable paid jobs. |
@@ -68,21 +68,23 @@ PixelKiln keeps the missing record:
 
 ### Local human review
 
-`pixelkiln pick` opens a local candidate sheet. It preserves each image's aspect
-ratio, fits large work without blurring small sprites, and never asks a model to
-choose artwork for you.
+`pixelkiln pick` opens a local candidate sheet — native aspect ratios, crisp
+small sprites, and no model choosing artwork for you.
 
 ![PixelKiln candidate review UI](./website/public/review-ui-showcase.jpg)
 
-Use Left/Right to inspect alternatives, Enter or 1–9 to select, and 0 to leave
-a row unresolved. Nothing is applied when the window is closed without using
-**Apply selections**. See the [CLI reference](docs/CLI.md#pick) for the full
-review workflow.
+Left/Right inspects alternatives, Enter or 1–9 selects, 0 leaves a row
+unresolved, and closing without **Apply selections** applies nothing
+([CLI reference](docs/CLI.md#pick)). [`pixelkiln gallery`](docs/CLI.md#gallery)
+is its companion: every generation at integer zoom with its prompt, cost, hashes,
+lineage, and quality record; `--edit` changes prompts and adds assets; `--budget`
+generates and reviews from the page under that ceiling; `--json` prints the snapshot.
+
+![PixelKiln generation gallery UI](./website/public/gallery-ui-showcase.jpg)
 
 ## Install
 
-Requires Node.js 22 or newer. Use the latest Node.js 24 LTS release for local
-development.
+Requires Node.js 22 or newer; use the latest Node.js 24 LTS for development.
 
 ```bash
 npm install --save-dev pixelkiln
@@ -344,10 +346,9 @@ console.log(plan.groups, plan.actionable.length)
 ```
 
 The package also exports audit and image-regression gates, quality-profile
-inspection and refinement, revision-readiness checks, lock/output helpers,
-provider contracts, sprite packing/mounting, tile
-exporters, managed artifact writes, and offline provenance verification. See
-[Library API](./docs/LIBRARY.md).
+inspection and refinement, revision-readiness checks, lock/output helpers, the
+gallery snapshot, provider contracts, sprite packing/mounting, tile exporters,
+managed artifact writes, and provenance verification. See [Library API](./docs/LIBRARY.md).
 
 ## Documentation
 

package/dist/cli.d.ts

@@ -21,6 +21,8 @@ interface CliWritable {
  * cannot hold the only copy of the live URL until the server exits.
  */
 declare function announceReviewReady(info: ReviewReadyInfo, stdout?: CliWritable, stderr?: CliWritable): void;
+/** Same stream rule as review readiness: the live URL must not wait behind a pipe. */
+declare function announceGalleryReady(url: string, count: number, stdout?: CliWritable, stderr?: CliWritable, edit?: boolean, budget?: string | null): void;
 interface Args {
     command: string;
     manifest: string;
@@ -38,6 +40,8 @@ interface Args {
     check: boolean;
     noOpen: boolean;
     tag: boolean;
+    /** gallery: allow the page to edit manifest intent (prompts, sizes, tags, new assets). */
+    edit: boolean;
     from?: string;
     out?: string;
     generator?: string;
@@ -82,7 +86,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", "quality", "refine", "recipe", "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", "gallery", "quality", "refine", "recipe", "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,
@@ -91,4 +95,4 @@ declare const COMMANDS: readonly ["init", "plan", "doctor", "gen", "submit", "po
  */
 declare function parseArgs(argv: string[]): Args;
 
-export { COMMANDS, announceReviewReady, parseArgs };
+export { COMMANDS, announceGalleryReady, announceReviewReady, parseArgs };