pixelkiln 0.16.0 → 0.18.0

package/README.md

@@ -55,10 +55,10 @@ 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 with a fast local candidate sheet. |
-| Controlled revisions | Hashed image-to-image/inpaint lineage, fail-closed parent approval, and source-versus-candidate review; ComfyUI is the first adapter. |
+| Generate and review | Resumable submit/poll/pick/fetch pipeline, exact next-step hints, and a fast local candidate sheet. |
+| 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 | Validated local content cache, durable provider-reference restore, account object-hash cache, and resumable jobs. |
+| Recovery | Safe stale-output replacement, validated caches, durable references, and resumable paid jobs. |
 | Shared-account safety | Cross-project claim files or a registered workspace catalog, sibling-style exclusion, reviewed salvage, keep/discard tags, separate confirmed purge. |
 | Quality control | Manifest-native grid recovery, closed palettes, named approval, regression baselines, and fail-closed packaging. |
 | Sprite packaging | Deterministic RGBA packing, stable-cell mounting, explicit external input lists, structural output roles. |
@@ -356,7 +356,7 @@ exporters, managed artifact writes, and offline provenance verification. See
 | [Getting started](./docs/GETTING_STARTED.md) | First project, existing-art onboarding, everyday workflow, and what to commit. |
 | [Set up PixelLab](./docs/PIXELLAB.md) | Production-provider credentials, manifest, generators, and account workflows. |
 | [Set up Retro Diffusion](./docs/RETRO_DIFFUSION.md) | Experimental-provider credentials, styles, formats, cost checks, and limits. |
-| [Set up ComfyUI](./docs/COMFYUI.md) | Experimental self-hosted server, workflow bindings, local cost semantics, and limits. |
+| [Set up ComfyUI](./docs/COMFYUI.md) | Self-hosted workflows, per-asset input uploads, local cost semantics, and quality limits. |
 | [Set up Scenario](./docs/SCENARIO.md) | Experimental hosted models, two-part credentials, CU preflight, review, and durable downloads. |
 | [Versioned recipes](./docs/RECIPES.md) | Pinned workflow packs, model hashes, manifest templates, and quality contracts. |
 | [Controlled revisions](./docs/REVISIONS.md) | Image-to-image/inpaint parents, masks, fail-closed readiness, provenance, and ComfyUI bindings. |

package/dist/cli.d.ts

@@ -4,8 +4,23 @@ import { z } from 'zod';
 declare const GridConfidenceSchema: z.ZodEnum<["low", "medium", "high"]>;
 type GridConfidence = z.infer<typeof GridConfidenceSchema>;
 
+interface ReviewReadyInfo {
+    url: string;
+    keys: string[];
+}
+
 type TilesetFormat = "generic" | "tiled" | "godot";
 
+interface CliWritable {
+    isTTY?: boolean;
+    write(chunk: string): unknown;
+}
+/**
+ * Interactive readiness is progress, not command output. Keep it on stdout in
+ * a terminal, but use stderr when stdout is piped so consumers such as `tail`
+ * cannot hold the only copy of the live URL until the server exits.
+ */
+declare function announceReviewReady(info: ReviewReadyInfo, stdout?: CliWritable, stderr?: CliWritable): void;
 interface Args {
     command: string;
     manifest: string;
@@ -76,4 +91,4 @@ declare const COMMANDS: readonly ["init", "plan", "doctor", "gen", "submit", "po
  */
 declare function parseArgs(argv: string[]): Args;
 
-export { COMMANDS, parseArgs };
+export { COMMANDS, announceReviewReady, parseArgs };