Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 51 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,57 @@ this package uses semantic versioning.

## Unreleased

## 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
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
`<controller>.<index>.<field>`. 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.
- 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

- 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. 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

- Adopt this reader everywhere before pinning a catalog that contains
`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.

Comment thread
coderabbitai[bot] marked this conversation as resolved.
Resolved
## 0.3.12 - 2026-10-21

The first MIT release of the current line. (0.3.11 is a maintenance release of
Expand Down
4 changes: 2 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -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",
Expand Down
Loading