From dd36caf000200e1878d356c3855e2b4f12bf1508 Mon Sep 17 00:00:00 2001 From: bymyself Date: Tue, 27 Oct 2026 12:24:46 +0000 Subject: [PATCH 1/3] chore: release 0.3.13 --- CHANGELOG.md | 42 ++++++++++++++++++++++++++++++++++++++++++ package-lock.json | 4 ++-- package.json | 2 +- 3 files changed, 45 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 7e95fc4..3275ac8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,48 @@ this package uses semantic versioning. ## Unreleased +## 0.3.13 - 2026-10-27 + +DynamicGroup support in the shared document (#276), with its decision records +(ADR-039, ADR-040) and replay proof (#295). No wire key, op kind or schema +version changes. + +### Added + +- Catalog entries may declare `dynamic_groups`: a row-count controller with + integer `min`/`max` bounds (`0 <= min <= max`), relative row `widgets` and + fresh-row `defaults`. Rows expand after their controller as + `..`. See `docs/dynamic-groups.md`. +- Group fields keep their identities across import, projection, top-level, + interior and promoted writes, and replay, including two groups on one node, + DynamicCombo composition, trailing widgets and seed companions. + +### Changed + +- A count change only changes projection. Hidden row fields keep their + name-keyed registers and reappear with their retained values when the count + grows; newly visible fields without a stored value project template defaults + (ADR-039). +- Agent row changes are whole-group replacement over existing `set_widget` + ops, not a structural row operation (ADR-040). + +### Fixed + +- Refuse, before mutation: counts below the group `min` or above the + allocation bound, row-field indices beyond that bound, count changes that + would require replacing an explicit `widgets_values_form`, and catalogs with + duplicate controllers, conflicting generated names, or a controller that a + selector could lay out twice. + +### Compatibility + +- Adopt this reader everywhere before pinning a catalog that contains + `dynamic_groups`. Readers up to and including 0.3.12 use the same schema v5 + but do not understand `dynamic_groups`: they can bind trailing writes to a + row position, throw on a document with stored row values, and drop rows that + have none. This is the reverse of the usual order, where the catalog pin + moves first. + ## 0.3.12 - 2026-10-21 The first MIT release of the current line. (0.3.11 is a maintenance release of diff --git a/package-lock.json b/package-lock.json index 78118e2..31ae2a5 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "@comfyorg/comfy-multi-player", - "version": "0.3.12", + "version": "0.3.13", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "@comfyorg/comfy-multi-player", - "version": "0.3.12", + "version": "0.3.13", "license": "MIT", "dependencies": { "yjs": "^13.6.27" diff --git a/package.json b/package.json index dfc3e7b..afd631f 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@comfyorg/comfy-multi-player", - "version": "0.3.12", + "version": "0.3.13", "license": "MIT", "description": "Shared workflow-document package: CRDT op applier + JSON projection used identically by the browser and the server doc host.", "type": "module", From 9d309d992ced4d20e1b43d833c141bdf162feeb3 Mon Sep 17 00:00:00 2001 From: bymyself Date: Tue, 27 Oct 2026 17:00:20 +0000 Subject: [PATCH 2/3] chore: cover #283 and #297 in the 0.3.13 changelog --- CHANGELOG.md | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3275ac8..2318174 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,8 +10,8 @@ this package uses semantic versioning. ## 0.3.13 - 2026-10-27 DynamicGroup support in the shared document (#276), with its decision records -(ADR-039, ADR-040) and replay proof (#295). No wire key, op kind or schema -version changes. +(ADR-039, ADR-040), replay proof (#295) and its own rejection codes (#283). No +wire key, op kind or schema version changes. ### Added @@ -22,6 +22,13 @@ version changes. - Group fields keep their identities across import, projection, top-level, interior and promoted writes, and replay, including two groups on one node, DynamicCombo composition, trailing widgets and seed companions. +- Rejection codes `dynamic_group_count_out_of_range` (a row count outside `min` + to the allocation bound, on `set_widget` or as a saved count in an + `add_node`, `insert_workflow` or `define_subgraph` payload) and + `dynamic_group_form_mismatch` (a count change that would require replacing an + explicit `widgets_values_form`). A row-field name beyond the bound stays + `unknown_widget`, and a catalog whose group `min` exceeds the bound stays + `apply_failed` (#283). ### Changed @@ -38,7 +45,9 @@ version changes. allocation bound, row-field indices beyond that bound, count changes that would require replacing an explicit `widgets_values_form`, and catalogs with duplicate controllers, conflicting generated names, or a controller that a - selector could lay out twice. + selector could lay out twice. A selector write on a declared ARRAY form is + refused, before the selector is written, when the newly selected option + would lay out a stored count outside the group range (#297). ### Compatibility From 3ba2906f0354d44c84f6ec5556a2f823ccf79e5e Mon Sep 17 00:00:00 2001 From: bymyself Date: Tue, 27 Oct 2026 23:54:40 +0000 Subject: [PATCH 3/3] chore: narrow the 0.3.13 compatibility note; date the release Only the schema-v5 readers (0.3.8 to 0.3.10, 0.3.12) share the failure modes; 0.3.11 is schema 4. Release date moves to the merge day. --- CHANGELOG.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 2318174..19f3d2b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,7 +7,7 @@ this package uses semantic versioning. ## Unreleased -## 0.3.13 - 2026-10-27 +## 0.3.13 - 2026-10-28 DynamicGroup support in the shared document (#276), with its decision records (ADR-039, ADR-040), replay proof (#295) and its own rejection codes (#283). No @@ -52,11 +52,11 @@ wire key, op kind or schema version changes. ### Compatibility - Adopt this reader everywhere before pinning a catalog that contains - `dynamic_groups`. Readers up to and including 0.3.12 use the same schema v5 - but do not understand `dynamic_groups`: they can bind trailing writes to a - row position, throw on a document with stored row values, and drop rows that - have none. This is the reverse of the usual order, where the catalog pin - moves first. + `dynamic_groups`. No reader up to and including 0.3.12 understands + `dynamic_groups`. The schema-v5 readers among them (0.3.8 to 0.3.10, and + 0.3.12) can bind trailing writes to a row position, throw on a document with + stored row values, and drop rows that have none. This is the reverse of the + usual order, where the catalog pin moves first. ## 0.3.12 - 2026-10-21