[WIP] Node Manager: desired-state, reconciliation & multi-step tasks - #3948

Draft

Apollon77 wants to merge 128 commits into

mainfrom

Commits on Jun 19, 2026

feat(node): add desired-state core types and status factory
Apollon77
committed
c9694d7
feat(node): add desired-state error hierarchy
Apollon77
committed
8a629a2
feat(node): add ItemKind interface and registry

Apollon77
and
claude
committed
89938fd
feat(node): add capacity admission check
Apollon77
committed
aca8f29
feat(node): add DesiredStateBehavior with persistent intent store

Apollon77
and
claude
committed
9d9e453
fix(node): match Observable convention and drop WHAT comment in DesiredStateBehavior

Apollon77
and
claude
committed
d10e121
feat(node): mount DesiredStateBehavior on ClientNode and export

Apollon77
and
claude
committed
b3ecde0
chore(node): format desired-state model

Apollon77
and
claude
committed
b72c901
test(node): cover group capacity mapping and drop unused fixture

Apollon77
and
claude
committed
6d5a450
feat(node-manager): scaffold @matter/node-manager package

Apollon77
and
claude
committed
a589926
feat(node): make desired-state capacity cache ephemeral

Apollon77
and
claude
committed
abce65a

Commits on Jun 20, 2026

feat(node): add softwareVersionChanged signal on node lifecycle

Apollon77
and
claude
committed
281766d
feat(node-manager): add planActions reconcile decision engine

Apollon77
and
claude
committed
d9e966d
feat(node-manager): add ReconcilerBehavior with triggers and executor

Apollon77
and
claude
committed
0e0da88
chore(node-manager): format reconciler engine

Apollon77
and
claude
committed
e0ee53c
fix(node-manager): own per-peer observers and gate on active subscription

Apollon77
and
claude
committed
8219cd7
Merge node-manager engine (Phase 2a-1) into node-manager

Apollon77
and
claude
committed
48c01f1

Commits on Jun 22, 2026

feat(node-manager): verify pass re-pends drift for any item mode

Apollon77
and
claude
committed
45b0bc3
feat(node): add optional ItemKind.verify() for drift detection

Apollon77
and
claude
committed
46a60dc
feat(node-manager): add ACL subsumption coverage helper

Apollon77
and
claude
committed
d208534
feat(node-manager): add acl ItemKind with subsumption verify and priority bands

Apollon77
and
claude
committed
6feb34c
feat(node-manager): wire verify pass and register acl kind in reconciler

Apollon77
and
claude
committed
c5951cd
fix(node-manager): harden capacity-read isolation, in-flight coalescing, dispose race

Apollon77
and
claude
committed
a813c14
feat(node-manager): instrument reconciler triggers and passes at debug

Apollon77
and
claude
committed
949ccb8
refactor(node): export commissioning test harness at @matter/node/testing

Apollon77
and
claude
committed
ae648b7
test(node-manager): single-peer commissioning proof for acl reconcile

Apollon77
and
claude
committed
5263167
fix(node-manager): void un-awaited reconcile re-entries in InFlightGuard test

Apollon77
and
claude
committed
501e7fc
refactor(node-manager): drop WHAT-comment, document verify-coalescing tradeoff

Apollon77
and
claude
committed
bf1c135
fix(node-manager): assume acl spec-min capacity (4) when device limit unread

Apollon77
and
claude
committed
6bccb13
Merge branch 'main' into node-manager
Apollon77
authored
1df5c99
fix(node): escape itemMapKey parts so composite keys cannot collide

Apollon77
and
claude
committed
ad4e989
feat(node-manager): add binding ItemKind with per-endpoint targeting

Apollon77
and
claude
committed
ad0d030
test(node-manager): single-peer binding reconcile proof

Apollon77
and
claude
committed
b355d84
docs(node-manager): correct priority-band comment after binding lands

Apollon77
and
claude
committed
39cb11c
refactor(node-manager): throw ImplementationError, not Error, for missing binding endpoint

Apollon77
and
claude
committed
9dff160
refactor(node): use ASCII unit separator for itemMapKey instead of escaping

Apollon77
and
claude
committed
2a396fe
Merge remote-tracking branch 'origin/main' into node-manager
Apollon77
committed
4db156c

Commits on Jun 23, 2026

feat(node-manager): add command-based groupKey ItemKind

Apollon77
and
claude
committed
312e580
fix(node-manager): catch detached reconcile-trigger rejections; restore groupKey capacity

Apollon77
and
claude
committed
9fbd52e
feat(node-manager): add groupKeyMap ItemKind with upsert-by-group semantics

Apollon77
and
claude
committed
dce78b5
fix(node-manager): reject groupKeySetId 0 (IPK) in GroupKeyMapItemKind.apply

Apollon77
and
claude
committed
6d616fa
test(node-manager): single-peer groupKey + groupKeyMap reconcile proof

Apollon77
and
claude
committed
d04fb5f
feat(node-manager): re-apply drifted items directly on a verify pass

Apollon77
and
claude
committed
2f5b23a
refactor(node-manager): serialize reconciles on a per-node mutex queue

Apollon77
and
claude
committed
4a4ca68
refactor(node-manager): drop dead repend action, harden unwire teardown

Apollon77
and
claude
committed
bfc4927
refactor(node-manager): read capacity from subscription cache, not a live device read

Apollon77
and
claude
committed
14f8e21
Merge remote-tracking branch 'origin/main' into node-manager
Apollon77
committed
f180808
feat(node-manager): add endpointGroupMembership ItemKind

Apollon77
and
claude
committed
c3ee7de
feat(node-manager): register endpointGroupMembership + integration test

Apollon77
and
claude
committed
bd73f7d
Merge remote-tracking branch 'origin/main' into node-manager
Apollon77
committed
ff64e62

Commits on Jun 25, 2026

feat(node-manager): task runtime core (manager, registry, persistence, driver)

Apollon77
and
claude
committed
db13552
fix(node-manager): run() returns handle immediately, not on task completion

Apollon77
and
claude
committed
a65a23a
feat(node-manager): task convergence gates (awaitGate/awaitCommitted, park/resume)

Apollon77
and
claude
committed
7231f9d
feat(node-manager): task resume on startup + cancel-as-revert (add-log)

Apollon77
and
claude
committed
2ff668d
fix(node-manager): harden cancel test + clear stale error on cancel success

Apollon77
and
claude
committed
fa43a5c
feat(node-manager): AddNodeToGroup task + integration tests

Apollon77
and
claude
committed
ab633fa
refactor(node-manager): dedupe task-type literal + doc cancel park

Apollon77
and
claude
committed
634f429
refactor(node-manager): add task/groups domain dir; rename TaskContextImpl->RunningTaskContext

Apollon77
and
claude
committed
f8b505f
Merge remote-tracking branch 'origin/main' into node-manager
Apollon77
committed
f81d0b2

Commits on Jun 27, 2026

style(node): fix import order in SetRegulatoryConfigSideEffectTest

Apollon77
and
claude
committed
78af822

Commits on Jul 6, 2026

feat(node-manager): ItemKind.isReferenced for shared group entries

Apollon77
and
claude
committed
1ba5a38
test(node-manager): cover deletePending in groupKeyMap.isReferenced

Apollon77
and
claude
committed
3764c4b
feat(node-manager): removeIntentIfUnreferenced + reconciler itemKind accessor

Apollon77
and
claude
committed
114fb44
chore(node-manager): drop WHAT comment on ReconcilerBehavior.itemKind

Apollon77
and
claude
committed
776a5de
feat(node-manager): prior-state changeset (addLog -> changeSet)
Apollon77
committed
2114b1f
docs(node-manager): trim WHAT comments to WHY invariants in changeset

Apollon77
and
claude
committed
6ad8ac8
feat(node-manager): generic changeset-driven revert task

Apollon77
and
claude
committed
0a8dc3b
feat(node-manager): auto-rollback via spawned revert task; drop cancelFailed

Apollon77
and
claude
committed
456995c
fix(node-manager): do not spawn revert-of-revert on failed revert task

Apollon77
and
claude
committed
afee031
fix(node-manager): groupKey apply create-if-absent (no clobber)
Apollon77
committed
bc8fdb1
refactor(node-manager): reuse fakePeer in create-if-absent test; drop redundant comment

Apollon77
and
claude
committed
dbf9dde
fix(node-manager): gate parks on unreachable node instead of resolving on stale state

Apollon77
and
claude
committed
42c7965
docs(node-manager): trim gate reachability-guard comments to invariant

Apollon77
and
claude
committed
d2d7b98
fix(node-manager): guard reconcile status write against concurrent revert

Apollon77
and
claude
committed
0a8e35e
test(node-manager): rollback + cancel + create-if-absent integration

Apollon77
and
claude
committed
1815f81
Merge remote-tracking branch 'origin/main' into node-manager
Apollon77
committed
bd3f6bb

Commits on Jul 9, 2026

feat(node-manager): per-endpoint membership key so one peer joins a group on many endpoints
Apollon77
committed
3bcf56a
feat(node-manager): pre-flight capacity admission before touching nodes

Apollon77
and
claude
committed
98dd557
feat(node-manager): RemoveNodeFromGroup task (shared-entry-safe removal)
Apollon77
committed
2919c71
docs(node-manager): tighten RemoveNodeFromGroup keyset-read comment to invariant

Apollon77
and
claude
committed
c92b2b2
style(node): fix import order in merge-repointed harness test files

Apollon77
and
claude
committed
af40311
test(node-manager): RemoveNodeFromGroup + admission integration

Apollon77
and
claude
committed
90af9d6
test(node-manager): assert admission test reads device limit from cache, not fallback

Apollon77
and
claude
committed
3effae3
fix(node-manager): exclude per-endpoint membership from capacity admission

Apollon77
and
claude
committed
102c3cd
Merge remote-tracking branch 'origin/main' into node-manager
Apollon77
committed
da38995

Commits on Aug 9, 2026

feat(node-manager): Task Layer Increment 3 — group-key rotation (#4213)

Apollon77
and
claude
authored
2c02d41

Commits on Aug 10, 2026

Merge remote-tracking branch 'origin/main' into node-manager
Apollon77
committed
1ee26fc
Merge branch 'main' into node-manager
Apollon77
authored
03f07c4

Commits on Aug 13, 2026

fix(node-manager): task cancel liveness and lifecycle hardening (#4219)

Apollon77
and
claude
authored
9ceefd5

Commits on Aug 14, 2026

Merge branch 'main' into node-manager
Apollon77
committed
68f8f87

Commits on Aug 15, 2026

Merge branch 'main' into node-manager
Apollon77
committed
ba15360

Commits on Aug 28, 2026

Merge branch 'main' into node-manager
Apollon77
committed
6e1b846

Commits on Aug 30, 2026

feat(node-manager): identify a task run, not the target it changes

Apollon77
and
claude
committed
9feaf19
fix(node-manager): carry a rollback's link on every path that creates one

Apollon77
and
claude
committed
24f37d7
fix(node-manager): exclude a rollback against the slot it rewrites

Apollon77
and
claude
committed
fa1aae4
fix(node-manager): make an identity durable before it is handed out

Apollon77
and
claude
committed
79b5647
fix(node-manager): reserve an identity before the first record exists

Apollon77
and
claude
committed
9e55111
refactor(node-manager): a rollback is created by cancel, never by a caller

Apollon77
and
claude
committed
65de176
test(node-manager): reach a refused rollback without conjuring one

Apollon77
and
claude
committed
9b624a1
fix(node-manager): refuse to undo a run a later run of its slot replaced

Apollon77
and
claude
committed
aa979cf
fix(node-manager): fail a task that writes an unknown item kind

Apollon77
and
claude
committed
f928bb5
fix(node-manager): record a run's outcome and its order in one write

Apollon77
and
claude
committed
423f832
Merge remote-tracking branch 'origin/main' into node-manager
Apollon77
committed
2af06d5
refactor(node-manager): separate what a task is from one run of it

Apollon77
and
claude
committed
f40fb04
fix(node-manager): decide a finished run's cancel without rebuilding it

Apollon77
and
claude
committed
7c53775
fix(node-manager): let a live run keep the safety policy it started under

Apollon77
and
claude
committed
93cad38
feat(node-manager): give untyped parameters one place to become typed

Apollon77
and
claude
committed
fd9bda4
fix(node-manager): run the registered definition, not the caller's object

Apollon77
and
claude
committed
fe1e285
fix(node-manager): make a run's parameter type mean what it says

Apollon77
and
claude
committed
ec7609f
Merge remote-tracking branch 'origin/main' into node-manager
Apollon77
committed
3a651a3

Commits on Sep 1, 2026

refactor(node-manager): keep every run in one table

Apollon77
and
claude
committed
1e1482c
refactor(node-manager): give a run's runtime state one owner and one lifetime

Apollon77
and
claude
committed
2ff999a
refactor(node-manager): record a change before adopting it

Apollon77
and
claude
committed
cfcb4a8
fix(node-manager): leave nothing behind for a run that was never recorded

Apollon77
and
claude
committed
35bc0d2
fix(node-manager): stop hiding a slot's history, and keep a paired rollback

Apollon77
and
claude
committed
0bd9f06
Merge remote-tracking branch 'origin/main' into node-manager
Apollon77
committed
da37ed3
feat(node-manager): give up on an undo that can never finish, and say why a request was refused

Apollon77
and
claude
committed
62058f6

Commits on Sep 2, 2026

Merge remote-tracking branch 'origin/main' into node-manager

Apollon77
and
claude
committed
c5dabdd

Commits on Sep 3, 2026

Commits on Sep 5, 2026

Commits on Sep 7, 2026