75 Commits
Author SHA1 Message Date
Kevin Gilper 06089c01f2 Document verified native illumination with exact comparison images 2026-10-28 17:50:22 -04:00
Kevin Gilper 97c5626eb1 Copy selected native carrier states exactly at unit weight 2026-10-28 17:31:03 -04:00
Kevin Gilper f4f5203b02 Add opt-in native carrier conditioning for signed studies 2026-10-28 17:28:11 -04:00
Kevin Gilper 68985b96cc Run native enhancer before the edit wrapper 2026-10-28 16:26:22 -04:00
Kevin Gilper b3aaf2fb7c Add bounded native conditioning scalar diagnostic 2026-10-27 01:49:07 -04:00
Kevin Gilper 472707f2a6 Place owned semantic poles before native prompt content
Parse complete source and donor vision blocks, then insert literal pole
payloads with owned trailing separators before prompt content. Preserve one
shared study layout and exact original token recovery and projection.

Keep verified newline carriers whole and track native output stripping
separately, retaining native role/header tokens for merged carriers. Reject
unknown carriers and malformed role or media prefixes before study encoding.
Preserve native anchoring, negative, metadata, deepstack, gain and timing.

All 219 tests and required compile checks pass. Causal scalar fixtures include
the previous append layout as a negative control; saved native mask and strip
bookkeeping agree with declared nonneural boundaries. Visual effect remains
unverified.
2026-10-26 01:27:19 -04:00
Kevin Gilper b4a1324c47 Anchor native semantic contrasts to the adopted original conditioning
Compose signed study deltas on the original native positive instead of the
all-muted combined-row study. Preserve native metadata, masks, coefficients,
timing, budget, low-load taper and exact neutral routing. Keep all study
encodes and validation counted without changing pole placement or gain.

Five build-level regressions deliberately make the study base differ from
the adopted native result; four detect the old defect. All 206 tests and
required compile checks pass. Visual semantic acceptance remains pending.
2026-10-26 00:37:09 -04:00
Kevin Gilper 32d7bfa4b2 Own native target preparation before the sampler context split
Add an optional preparation node that calls the verified native latent helper
and returns both the prepared context and its exact shared target LATENT.
Consume raw downscale metadata, preserve mask and foreign packet values, and
bind provenance to the original packet, model, format and helper state.
Keep existing consumer identity checks and the original seven node interfaces.

Reject spatial resizing after an owned grounded wrapper has primed its VAE
cache. Disabled preparation returns the original context and target unchanged.

All 201 tests and required compile checks pass. Exact native caller/helper
fixtures pass on Python 3.11 and 3.13; serving-host acceptance remains pending.
2026-10-25 23:44:00 -04:00
Kevin Gilper 03fc6b5ae6 Admit the complete reviewed Torch 2.11 native decorator profile
Bind all seven no-grad dependency definitions to one reviewed source tuple
from Torch 2.9 or 2.11. The added profile has an explicit error check and
constructor type annotations; mixed and unknown tuples remain unsupported.
Preserve loaded-code, globals, wrapper, closure and context-factory checks.

All 188 tests and required compile checks pass. Exact official source fixtures
pass 22 positive and rejection cases on Python 3.11 and 3.13. Serving-host
canonical and loaded-chain acceptance remains pending.
2026-10-25 23:10:45 -04:00
Kevin Gilper 2f211fd1db Make native source fingerprints portable across Python versions
Serialize every semantic AST field explicitly so identical reviewed Torch
definitions produce the same fingerprint on Python 3.11 and 3.13. Retain
loaded-code, decorator, closure and context-factory validation, with no new
admitted source profile.

Add regression coverage for empty fields, generic parameters, semantic edits
and dependency rejection. All 185 tests and required compile checks pass;
seven reference fingerprints and native decorator fixtures agree across both
Python versions. Serving-host acceptance remains pending.
2026-10-25 22:51:40 -04:00
Kevin Gilper b250536b89 Preserve native token row when assembling semantic poles
Byte BPE can merge final native punctuation with appended newlines, changing an
existing token before any study encode. Keep the exact native prompt/template
and image row authoritative, then insert separately tokenized plain pole payloads
with explicitly owned delimiters before its original suffix.

Require deletion of every owned span to recover the original token objects,
weights, image handles and order. Reject special/media/role pole tokens and keep
native projection, neutral identity and existing node interfaces unchanged.

Validation: 181 host-free tests, required compile, exact saved-tokenizer source
bindings and real byte-BPE construction regressions. No post-fix model or visual
acceptance is claimed.
2026-10-25 22:07:24 -04:00
Kevin Gilper 8284303897 Verify native decorator chains and actual fusion blocks
Reject wrapper layers on source-undecorated callables. Admit only each declared
native no_grad layer after checking its actual code, closure target and bound
context factory against pinned native Torch definitions. Unknown and compiled
wrappers remain unsupported.

Bind enhancer admission to the actual fusion and block instance classes and
captured forward methods. Reject per-instance, stale, compiled or hook-altered
paths before installing the owned fusion hook. Preserve existing node ports,
task recipes, source profiles and inference identity/revision limits.

Validation: 175 host-free tests, required compile and actual pinned native
decorator/source-loader counterexamples. No target or model acceptance claimed.
2026-10-25 21:11:22 -04:00
Kevin Gilper 0e49792afd Support reviewed native Krea source profile
Bind the exact older sampler and model-base pair after reviewing its no-op
writable-model scope difference for Krea. Reject mixed revisions, writable
instance overrides and additional multigpu models.

Admit the installed Krea2T revision with unchanged math and extra registrations.
Verify observed loaded call-path code and enhancer constants against admitted
source instead of relying on file hashes alone. Keep native node ports, task
recipes, inference identity/revision limits and existing defaults unchanged.

Validation: 170 host-free tests, required compile, saved-source native control,
enhancer invocation and loaded-code counterexamples. Real runtime/model and
application end-to-end acceptance remain separate.
2026-10-25 20:55:12 -04:00
Kevin Gilper 1253bb629e Add pinned native enhancer and repair V12 runtime seams
Preserve exact enhancer OFF MODEL identity and delegate the installed Krea2T
text-fusion helper under owned hook cleanup, source pins and wrapper order checks.
Keep task models, LoRAs and schedules intact, including Raw removal.

Mark inference handles explicitly unversioned, retain adopted target noise masks,
and validate native ER-SDE's actual first-sigma adjustment without replacing its
solver. Existing versioned node contracts and defaults remain unchanged.

Validation: 163 host-free tests, required compile and pinned source arithmetic
probes. Installed-host, real tensor/model and visual acceptance remain separate.
2026-10-25 20:40:44 -04:00
Kevin Gilper f7f3b163f7 Add experimental V12 native context and guider source
Add six versioned developer nodes for same-context source/donor/pole studies,
owned hook cleanup, native output projection, pinned native Euler guider
consumption and owned optional donor removal.

Preserve V9/V10/V11/Slider V1 and existing recipe defaults. V12 remains
experimental; this source delivery does not establish installed-runtime,
model-task or visual calibration support.

Validation: 145 host-free contract tests, required compile check and local
Comfy CLI metadata validation.
2026-10-25 18:33:36 -04:00
Kevin Gilper b1062390d9 Document verified V11 automatic slider scaling and migration 2026-09-22 12:50:23 -04:00
Kevin Gilper 1c2e3cd1b3 Add automatic reach and budget for V11 slider configurations 2026-09-22 12:46:46 -04:00
Kevin Gilper a10dc9d510 docs: feature V11 image examples and archive prior guides 2026-09-22 11:49:05 -04:00
Kevin Gilper 651aeb8325 docs: verify native ComfyUI V11 examples and loading instructions 2026-09-22 11:41:41 -04:00
Kevin Gilper 6aa4d5a3f5 docs: document V11 controls and worked examples 2026-09-22 11:32:19 -04:00
Kevin Gilper 90842f5003 Release 0.5.0: opt-in V11 reference and slider controls 2026-09-22 10:41:38 -04:00
Kevin Gilper e6f5241538 fix: taper V11 slider activation near neutral 2026-09-22 09:29:56 -04:00
Kevin Gilper bf74020f7a feat: add opt-in V11 reference and slider correctness controls 2026-09-22 09:12:13 -04:00
Kevin Gilper 4494390239 Add one-time sponsorship link 2026-07-12 08:30:06 -04:00
Kevin Gilper f57fef6650 Make recipe lab paths configurable 2026-07-07 11:06:27 -04:00
Kevin Gilper dbe47f93da Use a photographic golden-hour slider as the README hero
Replace the age-portrait audit sheet with a rendered three-frame hero: a
custom "golden-hour light" slider grading the same coastal photograph from
cool overcast (-3) through the untouched prompt (0) to warm golden hour
(+6), on one prompt and seed with the composition held. More photographic
and clearer than the old hero, and it doubles as a custom-poles example.
Documentation asset only - docs/ is excluded from registry packages.
2026-07-07 01:26:31 -04:00
Kevin Gilper 640d638357 Add node reference pages for the Concept Slider V1 nodes
The node documentation index promised a page for every registered node,
but the two Concept Slider nodes had none. Add their reference pages
(inputs, outputs, dial band, study reuse) in the same house format as
the V9/V10 node pages, and list them in the node index and the docs
landing page. Documentation only - docs/ is excluded from registry
packages, so the installed package is unchanged.
2026-07-07 01:10:42 -04:00
Kevin Gilper 7901507224 Release 0.4.0: Concept Slider V1 and the recipe visual guide 2026-07-07 00:57:43 -04:00
Kevin Gilper 099ae605b8 Feature Concept Sliders alongside V9 and V10 as a first-class product
The README now presents the package as two instruments - reference
conditioning (the V9/V10 guide cards) and Concept Sliders - with a
dedicated "What Concept Sliders Add" section parallel to "What V10
Adds", a Repository Structure section showing the three product
packages side by side, and slider entries in the goal table, the
workflow-thinking section, the documentation table, and the
development checks. The docs landing page gains the slider guide and
the recipe visual guide in its paths, core guides, and demo assets.
2026-07-07 00:55:53 -04:00
Kevin Gilper 2f71af0ca4 Add the recipe visual guide: every recipe demonstrated
One figure per recipe - reference image, prompt-alone baseline, and
with-card result side by side - for all twelve built-in quick recipes
and all twenty bundled pack recipes, each rendered at its documented
starting strength on a real reference under identical settings. The
figures carry honest usage notes (color-safe strengths for pose and
framing, single-mass references for big shapes, full-bleed artwork for
the style family). Linked from the documentation index and the V10
user guide.
2026-07-07 00:55:40 -04:00
Kevin Gilper 6e52a40bc5 Add Concept Slider V1: training-free attribute sliders for Krea 2
Two new nodes: a Concept Slider Card names an attribute (with optional
custom pole sentences) and a Concept Slider Stack derives the
more-vs-less axis from Krea 2's own text encoder at encode time.
-6..+6 dial, up to 8 sliders, a slider report output, and a study
cache; a slider at 0 is skipped entirely and a cardless stack matches
CLIP Text Encode exactly. Ships with the complete guide, the ten-slider
render audit sheets, a showcase workflow with a with-vs-without
comparison branch, contract tests, and a maintainer smoke test.
2026-07-07 00:55:26 -04:00
Kevin Gilper 070b838385 Add designer artwork and edit-composite recipe packs
Fifteen new bundled recipes, all render-validated under the stack's
default smart per-card timing: a ten-recipe designer artwork pack
(poster style, soft media, pattern energy, era print look, paper and
canvas, metallic accents, ornament borders, stained glass, and the
style-timing pair) and a five-recipe edit-and-composite pack (scene
light, monochrome look, atmosphere, background only, carry the subject
over). Recipe Kit README gains the smart-timing tuning rule (early is
the structure-phase volume; motif-scale borrows need early ~0.85), the
Builder reserves the new labels, and the docs list the full bundled
roster. V9 untouched.
2026-07-06 21:43:00 -04:00
Kevin Gilper 5f3f0ce240 Release 0.3.0: True style transfer and render-audited V10 recipes 2026-07-06 20:24:14 -04:00
Kevin Gilper 84e336d302 Update public docs to the retuned V10 recipes
Removes every stale claim left from the pre-retune era. The Recipe Builder's intent bases now mirror the shipped bundles (they still emitted palette-wash style/lighting/material and the even shapes table); intents whose built-in table differs from the role default always write layers, the style and lighting intents carry their shipped focus texts as defaults, and the reserved-label list includes the two newer starter recipes - all builder outputs re-verified through the real recipe loader. The remaining 0.2.1-era demo images (timing and direction journeys, material demo, showcases, gallery sheet) are re-rendered through the live nodes. README strength guidance moves to the render-calibrated bands; the V10 card page documents the four V10-only recipe overrides instead of claiming V9-identical behavior; user guides, testing checklist, docs index, and the Recipe Kit README are synced (five starter recipes, built-in focuses, strong-blur taming pattern).
2026-07-06 19:36:37 -04:00
Kevin Gilper 8bf546d016 Re-render V10 demos for the retuned recipes
The style, lighting, and big-shapes demo images (plus the gallery sheet) now show what the current tuning actually produces - the lighting demo in particular changes from a brown recolor of the sphere to a real scene-wide mood cast. Rendered through the deployed nodes with the bundled example assets, same prompts and seeds as before.
2026-07-06 19:04:31 -04:00
Kevin Gilper b9a527702b Retune V10 lighting, shape-only, and photo-finish recipes
Render-audited every V10 recipe on fresh public-domain and self-generated references. Three fixes ship: copy lighting and mood moves from palette wash (which flattened dramatic skies into flat location tones) to strong blur with a de-place focus, so storm mood lands at 0.65 and full drama by 0.9; copy big shapes only gets a structure-only layer table (structure x1.3, appearance x0.25) because the even table let the gray shape-wash study drain the result to monochrome; borrow photo finish was near-silent at its documented strengths and moves to shape 0.8 with finish x1.2 and cap 0.65, landing the photographic grade from ~0.55. borrow drawing medium keeps its deliberately quiet values with an honest description - every louder variant imported the drawing's subject (render-proven ceiling). All changes V10-only; V9 untouched.
2026-07-06 18:59:44 -04:00
Kevin Gilper 53db3aad0c Fix visual-style blur with an anti-blur focus
The style recipe's strong-blur prep is its structure-safety guarantee, but the encoder was also studying the blur itself - on soft-medium references renders came out pervasively soft. The built-in style bundle now ships a focus that de-selects softness and scene layout; prep and pulls are unchanged. A/B render-verified across five references, two strengths, three seeds, single-card and in the two-card method. Crisper prep alternatives re-opened source-scene takeover and were rejected.
2026-07-06 18:15:19 -04:00
Kevin Gilper 0663ccf15b Retune V10 material texture recipe 2026-07-05 20:53:26 -04:00
Kevin Gilper b9190aa9e0 Add focused V10 style recipes 2026-07-05 20:30:26 -04:00
Kevin Gilper 5447ebdb52 Retune V10 style transfer recipe 2026-07-05 19:54:46 -04:00
Kevin Gilper 9ac00b2d88 Release 0.2.1: sharper listing description 2026-07-03 16:25:27 -04:00
Kevin Gilper 812ad37cee Re-render the V9 demo set on the current tuning; modernize the manual-tuning demo
The shipped V9 demos predated both the appearance-recipe retune and the
bilinear palette wash, so the guide undersold what a current install
produces. All nine demos (and the README's front-page gallery) are
re-rendered through the live V9 nodes on their original seeds via the new
docs/recipe-lab/regenerate_v9_demos.py, which drives each render from its
shipped sidecar workflow so the drag-in values are exactly what rendered.

Two demos changed values, render-compared on identical seeds: the
manual-tuning card now keeps 'Shape copied' alive (0.8) under the palette
wash instead of leaning on the inert 'Overall style reach', and the style
demo runs at 0.50 where the borrowed palette lands on a crisp subject
(0.65 softened it). Guide prose and the stale 'demos predate the retune'
note are updated to match.
2026-07-03 16:19:34 -04:00
Kevin Gilper 523d5f4827 Release 0.2.0: Krea 2 V10 nodes 2026-07-03 16:04:08 -04:00
Kevin Gilper 20e6b4b704 Expand semicolon-joined statements in maintainer scripts
The registry validator's security lint flags E702 (multiple statements per
line) as a warning today and an error soon; expand them now so future
publishes stay clean. Pure reformatting - no behavior change.
2026-07-03 16:02:33 -04:00
Kevin Gilper 30e9a53cfc Regenerate all guide demos with the bilinear palette wash; update wording to match
The nearest->bilinear wash fix (5f61727) changes what palette-wash recipes
render, so every wash-affected demo is re-rendered through the live V10
nodes on the same seeds: the palette sphere is now a smooth gradient, the
toward-lamp an organic rose/sage piece, the final-only timing lamp a clean
two-tone split. Guide prose that described the old mosaic aesthetic is
reworded to describe the new renders, the V10 paper's treatment row and the
V9 paper's wash pseudocode now document the bilinear upsample (with a note
on why nearest was wrong), and the focus-validation reference images join
the recipe-lab refs.
2026-07-03 15:58:09 -04:00
Kevin Gilper 5f61727801 Fix the palette-wash pixel-block artifact: bilinear upscale instead of nearest
The wash pools the reference to a 2-10 cell color grid (the structure-safety
step) and upscaled it nearest-neighbor, leaving hard-edged giant cells - at
study 256 just 5x5 blocks of ~51px. With the retuned live shape pull the
model reproduced them literally: palette-wash recipes rendered subjects as
pixel-art mosaics (checkered spheres, quilted lamps, blocky ledges).

Bilinear upscale melts the identical palette relationships into smooth
gradients. A/B on identical seeds: mosaic gone, color transfer kept, subject
and structure safety unchanged (the pool step still destroys structure).
Affects every palette-wash recipe on both node generations. 57/57 tests.
2026-07-03 15:46:36 -04:00
Kevin Gilper f8e1e89611 Documentation and workflow sync: every V10 feature covered, starter-recipe example workflow added
Full V10 documentation audit pass:
- README: What V10 Adds now covers focus, the auto-loaded starter recipes,
  and the Recipe Builder; workflow table lists the new example.
- New example workflow krea-v10-starter-recipe-workflow.json: cinematic
  color grade (from the shipped starter pack) grading the scene from the
  bundled style reference - configuration render-validated on the live node.
- V10 user guide: 'Focus: recipes that study one aspect' section with the
  render-verified select/de-select evidence and limits; What V10 Adds rows;
  focus troubleshooting entry (MD + HTML, incl. the What-V10-Adds grid).
- V10 documentation index refreshed: Recipe Kit + Builder + standalone tech
  reference in Start Here, the full twenty-demo journey list (away render
  and balance pair included - no more 'pending' notes), starter-recipe
  workflow, maintainer touchpoints incl. the builder and recipe-lab.
- Stack encoder node page: deep-dive points at the standalone V10 technical
  reference; report bullet mentions the focus line.
- Testing guide: V10 smoke checklist covers starter recipes, focus report
  lines, and the Builder; demo-renders section describes the current
  twenty-journey set and its regenerator script.

All 7 example workflows parse; 57/57 tests; doc links verified.
2026-07-03 12:45:36 -04:00
Kevin Gilper b5d96a11ad Recipe Builder: reserve the starter-pack labels and point at the shipped examples
The auto-loaded starter recipes (borrow the weather / borrow the clothing
style / cinematic color grade) are now rejected as new-recipe names - across
recipe files the first definition of a label wins, so a builder-made file
reusing one would silently lose. The install card links the starter pack as
working examples. Logic re-verified under node (45 combos through the real
loader; starter labels rejected; focus carried).
2026-07-03 12:34:20 -04:00
Kevin Gilper 8fd4009254 Package the Recipe Kit and rewrite the V10 technical paper as a standalone reference
custom_recipes/README.md is now the Recipe Kit hub: Builder, auto-loaded
starter pack, template, schema + focus guide, and technical reference in one
index, with a dedicated focus section carrying the render-verified guidance
(selection works, de-selection is powerful, broad moods ride the image).

docs/krea-v10-technical-paper.md rewritten as a self-contained reference
covering every V10-exposed feature with no V9-paper dependency: both nodes'
full widget surfaces, the conditioning math (12 taps, mute-and-diff,
per-band compose, inert pooled channel), the strength model, the exact
image-prep pipeline, the prompt machinery incl. the multilingual guard and
focus lines, the complete retuned recipe tables, custom recipes + starter
pack + Builder, the study cache, both feedback outputs, V9 interop, frozen
surfaces, verification methodology, and a worked example.

Guides, node page, and CHANGELOG updated for focus + starter pack.
57/57 tests; doc links verified.
2026-07-03 12:13:54 -04:00
Kevin Gilper 988afd49d5 Ship three auto-loaded starter recipes and a focus box in the Recipe Builder
custom_recipes/starter-pack.yaml loads out of the box (delete or underscore
it to opt out): 'borrow the weather' (strong blur + low detail keeps the
reference's objects out while the sky mood arrives), 'borrow the clothing
style' (the focus line does the semantic separation - its inverse is
documented in the description), and 'cinematic color grade' (a bolder
palette sibling). All three render-validated on Krea 2, incl. the focus
A/B: same reference/seed, clothing-focus kept the red coat + gained garment
detail; environment-focus with 'not their clothing' erased the red.

Recipe Builder: optional 'Focus on one aspect' box in step 2, wired through
buildRecipe/YAML/JSON with the node's normalization (whitespace collapse,
300-char clip, omit-when-blank); honest hint that focus is strongest on
object-bound aspects. All 45 intent x loudness x focus combos (x2 formats)
re-verified through the real kg_krea_v10 loader. 57/57 tests.
2026-07-03 12:06:31 -04:00