@cat-factory/orchestration 0.221.0 → 0.223.0

package/dist/modules/board/BoardService.d.ts

@@ -165,6 +165,11 @@ export declare class BoardService {
     private readonly reviewFrictionGuard;
     /** The external `/api/v1` board surface (see publicBoardReads.ts). */
     private readonly publicReads;
+    /**
+     * The headless `internal` anchor blocks a public-API run hangs off (see internalAnchors.ts).
+     * Never board state: no event announces one, and every projection filters it out.
+     */
+    private readonly internalAnchors;
     /**
      * The board's LAYOUT writes — drag a container to a new spot, drag its border to new bounds
      * (see layoutWrites.ts). Both split their write between a frame's per-board mount override and
@@ -191,23 +196,31 @@ export declare class BoardService {
     private readonly riskPolicySelection;
     constructor({ workspaceRepository, blockRepository, executionRepository, idGenerator, clock, repoProjectionRepository, repoProjectionCache, serviceRepository, workspaceMountRepository, serviceFragmentDefaultsRepository, initiativeRepository, documentRepository, taskRepository, executionEventPublisher, taskTypeRegistry, taskTypeSuppressionRepository, promptFragmentSource, workspaceSettings, reviewFrictionNotifications, resolveRunRepoContext, riskPolicyRepository, logger, }: BoardServiceDependencies);
     /**
-     * Push a coarse board-changed signal for a successful mutation. `originWorkspaceId` MUST be
+     * Push a board-changed signal for a successful mutation. `originWorkspaceId` MUST be
      * the workspace that physically HOMES the affected block (its `homeWorkspaceId`), not
      * necessarily the acting workspace: {@link FanOutEventPublisher} resolves the block's service
-     * — and thus every workspace that mounts it — by looking the block up under this origin, so
+     * (and thus every workspace that mounts it) by looking the block up under this origin, so
      * passing a mounter's id for a block homed elsewhere would find nothing and collapse the
-     * fan-out to that one board. Naming a block lets the change reach every mount; pass `null` for
+     * fan-out to that one board. Naming a block lets the change reach every mount; name none for
      * a signal that should reach the origin workspace only (e.g. a per-workspace frame-layout
      * move). Best-effort: swallow any failure so a missed push never fails the already-persisted
-     * mutation — the client reconciles by re-fetching its snapshot.
+     * mutation, since the client reconciles by re-fetching its snapshot.
+     *
+     * Pass `block` (rather than only `blockId`) when the change is FULLY described by that one
+     * block, so subscribers patch it in place instead of re-reading the whole board. That is the
+     * difference between a spawned task costing one small payload and costing a snapshot on every
+     * open board. Withhold it for a structural change whose new shape a single block cannot state:
+     * a removal or a reparent moves a block BETWEEN parents, and a cascade touches rows the event
+     * never names. A frame payload is dropped at the wire by `deliverableBoardBlock`, so naming one
+     * here is safe but pointless.
      *
-     * When `originConnectionId` is given (a user-driven mutation — move / reparent / field edit —
+     * When `originConnectionId` is given (a user-driven mutation: move / reparent / field edit,
      * carrying the acting tab's connection id), the realtime transport SKIPS delivering this
      * echo back to that connection: its REST response already carried the authoritative result,
      * so refreshing off its own event would only race an in-flight drag (snapping a block back to
      * a stale position) or trigger a redundant board-wide re-hydrate on every inspector edit. Every
-     * OTHER subscriber still receives the coarse signal and refreshes. Engine-driven board changes
-     * pass no origin id, so they fan out to everyone as before.
+     * OTHER subscriber still receives the signal. Engine-driven board changes pass no origin id, so
+     * they fan out to everyone as before.
      */
     private emitBoardChanged;
     /**
@@ -297,36 +310,16 @@ export declare class BoardService {
      * Pass `UNATTRIBUTED_BLOCK_EDITOR` for a caller with no workspace tier (see its doc).
      */
     addTask(workspaceId: string, containerId: string, input: AddTaskInput, editor: BlockEditActor, createdBy?: string | null): Promise<Block>;
-    /**
-     * Create a HEADLESS internal task — a top-level, `internal: true` block used purely to anchor
-     * a public-API run (an external "initiative breakdown"). It is EXCLUDED from every board
-     * projection (see the snapshot/board reads), so it never renders in the UI; deliberately does
-     * NOT emit a `block-added` event (nothing should flash onto a live board). Returns the block so
-     * the caller can start an execution on it. The engine writes status onto it like any block.
-     */
+    /** Public-API: create the anchor block a public-API run hangs off. */
     createInternalTask(workspaceId: string, input: {
         title: string;
         description: string;
     }): Promise<Block>;
-    /**
-     * Fetch a HEADLESS internal anchor block by id, or null when no block with that id exists in
-     * the workspace OR it is not `internal`. The public-API job reads use this to confine an
-     * external key to the runs IT created (an `internal` block) — never an arbitrary board
-     * execution that merely shares the key's workspace. See PublicApiController.
-     */
+    /** Public-API: an anchor by id, or null when the block is absent or not `internal`. */
     getInternalTask(workspaceId: string, blockId: string): Promise<Block | null>;
-    /**
-     * Delete a HEADLESS internal anchor block. Used by the public API to roll back the anchor when
-     * the run it was created for fails to start, so a failed dispatch never leaves an orphan
-     * `internal` block behind (it renders nowhere and is invisible to the cap, so it would just
-     * accumulate). A headless anchor has no children/service subtree, so a direct delete is enough.
-     */
+    /** Public-API: roll an anchor back when the run it was created for fails to start. */
     deleteInternalTask(workspaceId: string, blockId: string): Promise<void>;
-    /**
-     * How many of the workspace's headless internal "initiative" runs are still in flight — the
-     * concurrency backstop the public API checks before starting another, so a single (possibly
-     * leaked) key can't spin up unbounded LLM runs. A SQL `COUNT`, not a load-and-count.
-     */
+    /** Public-API: how many anchored runs are in flight — the concurrency backstop. */
     countActiveInternalTasks(workspaceId: string): Promise<number>;
     /** Public-API: the workspace's board services (visible service frames). */
     listServices(workspaceId: string): Promise<Block[]>;

package/dist/modules/board/BoardService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoardService.d.ts","sourceRoot":"","sources":["../../../src/modules/board/BoardService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"BoardService.d.ts","sourceRoot":"","sources":["../../../src/modules/board/BoardService.ts"],"names":[],"mappings":"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"}

package/dist/modules/board/BoardService.js

@@ -7,6 +7,7 @@ import { pruneDanglingEdges, reclaimDoomedEntities } from './removal-cascade.js'
 import { canReparent, descendantIds, gridSlot, serviceOf, tasksOf, unfinishedTasksUnder, wouldCreateCycle, } from './board.logic.js';
 import { ReviewFrictionGuard } from './reviewFrictionGuard.js';
 import { resolveNewServiceFrameDefaults } from './newServiceFrameDefaults.js';
+import { createInternalAnchors } from './internalAnchors.js';
 import { PublicBoardReads } from './publicBoardReads.js';
 import { buildReviewDescription, resolveReviewTaskTarget } from './reviewTaskTarget.js';
 import { createBlockPatchNarrowing } from './blockPatchNarrowing.js';
@@ -40,6 +41,11 @@ export class BoardService {
     reviewFrictionGuard;
     /** The external `/api/v1` board surface (see publicBoardReads.ts). */
     publicReads;
+    /**
+     * The headless `internal` anchor blocks a public-API run hangs off (see internalAnchors.ts).
+     * Never board state: no event announces one, and every projection filters it out.
+     */
+    internalAnchors;
     /**
      * The board's LAYOUT writes — drag a container to a new spot, drag its border to new bounds
      * (see layoutWrites.ts). Both split their write between a frame's per-board mount override and
@@ -116,36 +122,49 @@ export class BoardService {
             resolveBlock: (workspaceId, id) => this.resolveBlock(workspaceId, id),
             frameMount: (workspaceId, block) => this.frameMount(workspaceId, block),
             projectForWorkspace: (workspaceId, block) => this.projectForWorkspace(workspaceId, block),
-            emitBoardChanged: (originWorkspaceId, reason, blockId, originConnectionId) => this.emitBoardChanged(originWorkspaceId, reason, blockId, originConnectionId),
+            emitBoardChanged: (originWorkspaceId, change) => this.emitBoardChanged(originWorkspaceId, change),
         });
         this.publicReads = new PublicBoardReads({
             blockRepository,
             requireWorkspace: (workspaceId) => this.requireWorkspace(workspaceId),
             addTask: (workspaceId, containerId, input, editor, createdBy) => this.addTask(workspaceId, containerId, input, editor, createdBy),
         });
+        this.internalAnchors = createInternalAnchors({
+            blockRepository,
+            idGenerator,
+            requireWorkspace: (workspaceId) => this.requireWorkspace(workspaceId),
+        });
     }
     /**
-     * Push a coarse board-changed signal for a successful mutation. `originWorkspaceId` MUST be
+     * Push a board-changed signal for a successful mutation. `originWorkspaceId` MUST be
      * the workspace that physically HOMES the affected block (its `homeWorkspaceId`), not
      * necessarily the acting workspace: {@link FanOutEventPublisher} resolves the block's service
-     * — and thus every workspace that mounts it — by looking the block up under this origin, so
+     * (and thus every workspace that mounts it) by looking the block up under this origin, so
      * passing a mounter's id for a block homed elsewhere would find nothing and collapse the
-     * fan-out to that one board. Naming a block lets the change reach every mount; pass `null` for
+     * fan-out to that one board. Naming a block lets the change reach every mount; name none for
      * a signal that should reach the origin workspace only (e.g. a per-workspace frame-layout
      * move). Best-effort: swallow any failure so a missed push never fails the already-persisted
-     * mutation — the client reconciles by re-fetching its snapshot.
+     * mutation, since the client reconciles by re-fetching its snapshot.
      *
-     * When `originConnectionId` is given (a user-driven mutation — move / reparent / field edit —
+     * Pass `block` (rather than only `blockId`) when the change is FULLY described by that one
+     * block, so subscribers patch it in place instead of re-reading the whole board. That is the
+     * difference between a spawned task costing one small payload and costing a snapshot on every
+     * open board. Withhold it for a structural change whose new shape a single block cannot state:
+     * a removal or a reparent moves a block BETWEEN parents, and a cascade touches rows the event
+     * never names. A frame payload is dropped at the wire by `deliverableBoardBlock`, so naming one
+     * here is safe but pointless.
+     *
+     * When `originConnectionId` is given (a user-driven mutation: move / reparent / field edit,
      * carrying the acting tab's connection id), the realtime transport SKIPS delivering this
      * echo back to that connection: its REST response already carried the authoritative result,
      * so refreshing off its own event would only race an in-flight drag (snapping a block back to
      * a stale position) or trigger a redundant board-wide re-hydrate on every inspector edit. Every
-     * OTHER subscriber still receives the coarse signal and refreshes. Engine-driven board changes
-     * pass no origin id, so they fan out to everyone as before.
+     * OTHER subscriber still receives the signal. Engine-driven board changes pass no origin id, so
+     * they fan out to everyone as before.
      */
-    async emitBoardChanged(originWorkspaceId, reason, blockId, originConnectionId) {
+    async emitBoardChanged(originWorkspaceId, change) {
         try {
-            await this.events?.boardChanged(originWorkspaceId, reason, blockId, originConnectionId);
+            await this.events?.boardChanged(originWorkspaceId, change);
         }
         catch {
             // best-effort; the REST response already carried the mutation
@@ -273,7 +292,8 @@ export class BoardService {
         };
         const serviceId = await this.registerService(workspaceId, block);
         await this.blockRepository.insert(workspaceId, block, serviceId);
-        await this.emitBoardChanged(workspaceId, 'block-added', block.id);
+        // A service FRAME, so no payload: its position is the per-board mount, not this row.
+        await this.emitBoardChanged(workspaceId, { reason: 'block-added', blockId: block.id });
         return block;
     }
     /**
@@ -364,7 +384,8 @@ export class BoardService {
             directory: directory ?? null,
         });
         await this.blockRepository.insert(workspaceId, block, serviceId);
-        await this.emitBoardChanged(workspaceId, 'block-added', block.id);
+        // A service FRAME, so no payload (see `addBlock`).
+        await this.emitBoardChanged(workspaceId, { reason: 'block-added', blockId: block.id });
         return block;
     }
     /**
@@ -414,8 +435,12 @@ export class BoardService {
                 createdAt: this.clock.now(),
             };
             await this.workspaceMountRepository.upsert(mount);
-            // Fan out from the frame's HOME so every board mounting the shared service refreshes.
-            await this.emitBoardChanged(home.workspaceId, 'block-added', home.block.id);
+            // Fan out from the frame's HOME so every board mounting the shared service refreshes. A
+            // FRAME, and each target board reads its own mount, so there is no payload to carry.
+            await this.emitBoardChanged(home.workspaceId, {
+                reason: 'block-added',
+                blockId: home.block.id,
+            });
         }
         // The frame block is the one homed on ANOTHER board, carrying that board's coordinates —
         // return it placed where THIS board just mounted it, or the SPA drops the imported service
@@ -567,66 +592,30 @@ export class BoardService {
             block.technical = input.technical;
         await this.blockRepository.insert(homeWorkspaceId, block, await this.serviceForContainer(blocks, container));
         // Origin = the block's HOME (the mounted service's home when added to a shared board), so
-        // the fan-out reaches every workspace mounting the service, not just the acting one.
-        await this.emitBoardChanged(homeWorkspaceId, 'block-added', block.id);
+        // the fan-out reaches every workspace mounting the service, not just the acting one. A new
+        // task is fully described by itself, so it rides along and every board patches it in place
+        // rather than re-reading a snapshot: this is the event an initiative loop fires per spawn.
+        await this.emitBoardChanged(homeWorkspaceId, { reason: 'block-added', block });
         return block;
     }
-    /**
-     * Create a HEADLESS internal task — a top-level, `internal: true` block used purely to anchor
-     * a public-API run (an external "initiative breakdown"). It is EXCLUDED from every board
-     * projection (see the snapshot/board reads), so it never renders in the UI; deliberately does
-     * NOT emit a `block-added` event (nothing should flash onto a live board). Returns the block so
-     * the caller can start an execution on it. The engine writes status onto it like any block.
-     */
-    async createInternalTask(workspaceId, input) {
-        await this.requireWorkspace(workspaceId);
-        const block = {
-            id: this.idGenerator.next('task'),
-            title: input.title.trim() || 'Initiative',
-            // `type` is the service/repo CLASSIFICATION (frontend/service/library/…), orthogonal to the
-            // `level` hierarchy; there is no task-specific BlockType. This anchor is a standalone,
-            // never-rendered, repo-less `level:'task'` block, so `type` is irrelevant to it — 'service'
-            // is just the neutral default (a normal task inherits its parent service's type instead).
-            type: 'service',
-            description: input.description ?? '',
-            position: { x: 0, y: 0 },
-            status: 'planned',
-            progress: 0,
-            dependsOn: [],
-            executionId: null,
-            level: 'task',
-            parentId: null,
-            internal: true,
-        };
-        await this.blockRepository.insert(workspaceId, block);
-        return block;
+    // --- Headless internal anchors ---------------------------------------------
+    // Delegated to {@link createInternalAnchors}: the top-level `internal: true` blocks that anchor
+    // a public-API run and render on no board, ever. See that file for why the four belong together.
+    /** Public-API: create the anchor block a public-API run hangs off. */
+    createInternalTask(workspaceId, input) {
+        return this.internalAnchors.createInternalTask(workspaceId, input);
     }
-    /**
-     * Fetch a HEADLESS internal anchor block by id, or null when no block with that id exists in
-     * the workspace OR it is not `internal`. The public-API job reads use this to confine an
-     * external key to the runs IT created (an `internal` block) — never an arbitrary board
-     * execution that merely shares the key's workspace. See PublicApiController.
-     */
-    async getInternalTask(workspaceId, blockId) {
-        const block = await this.blockRepository.get(workspaceId, blockId);
-        return block?.internal ? block : null;
+    /** Public-API: an anchor by id, or null when the block is absent or not `internal`. */
+    getInternalTask(workspaceId, blockId) {
+        return this.internalAnchors.getInternalTask(workspaceId, blockId);
     }
-    /**
-     * Delete a HEADLESS internal anchor block. Used by the public API to roll back the anchor when
-     * the run it was created for fails to start, so a failed dispatch never leaves an orphan
-     * `internal` block behind (it renders nowhere and is invisible to the cap, so it would just
-     * accumulate). A headless anchor has no children/service subtree, so a direct delete is enough.
-     */
-    async deleteInternalTask(workspaceId, blockId) {
-        await this.blockRepository.deleteMany(workspaceId, [blockId]);
+    /** Public-API: roll an anchor back when the run it was created for fails to start. */
+    deleteInternalTask(workspaceId, blockId) {
+        return this.internalAnchors.deleteInternalTask(workspaceId, blockId);
     }
-    /**
-     * How many of the workspace's headless internal "initiative" runs are still in flight — the
-     * concurrency backstop the public API checks before starting another, so a single (possibly
-     * leaked) key can't spin up unbounded LLM runs. A SQL `COUNT`, not a load-and-count.
-     */
+    /** Public-API: how many anchored runs are in flight — the concurrency backstop. */
     countActiveInternalTasks(workspaceId) {
-        return this.blockRepository.countActiveInternal(workspaceId);
+        return this.internalAnchors.countActiveInternalTasks(workspaceId);
     }
     // --- Public-API board reads/writes -----------------------------------------
     // Delegated to {@link PublicBoardReads}: the external `/api/v1` surface is its own cohesive
@@ -694,7 +683,8 @@ export class BoardService {
             };
             await this.blockRepository.insert(homeWorkspaceId, block, containerServiceId);
             // Origin = the block's HOME so a module added to a mounted service fans out to all mounts.
-            await this.emitBoardChanged(homeWorkspaceId, 'block-added', block.id);
+            // A module is a sub-frame with no mount of its own, so its payload is correct everywhere.
+            await this.emitBoardChanged(homeWorkspaceId, { reason: 'block-added', block });
             created.push(block);
             n += 1;
         }
@@ -732,7 +722,7 @@ export class BoardService {
             parentId,
         };
         await this.blockRepository.insert(workspaceId, block);
-        await this.emitBoardChanged(workspaceId, 'block-added', block.id);
+        await this.emitBoardChanged(workspaceId, { reason: 'block-added', block });
         return block;
     }
     /**
@@ -754,9 +744,12 @@ export class BoardService {
             }
         }
         await this.blockRepository.update(homeWorkspaceId, taskId, { epicId });
+        // Re-read BEFORE emitting so the event carries the task it just changed: membership is a
+        // field ON the task, so the one block states the whole change and subscribers patch it.
         // Origin = the task's HOME so the fan-out resolves the (possibly mounted) service's boards.
-        await this.emitBoardChanged(homeWorkspaceId, 'epic-assigned', taskId);
-        return assertFound(await this.blockRepository.get(homeWorkspaceId, taskId), 'Block', taskId);
+        const updated = assertFound(await this.blockRepository.get(homeWorkspaceId, taskId), 'Block', taskId);
+        await this.emitBoardChanged(homeWorkspaceId, { reason: 'epic-assigned', block: updated });
+        return updated;
     }
     /** Move a block to a new spot on the board (a frame's position is its per-board override). */
     async moveBlock(workspaceId, id, position, originConnectionId) {
@@ -805,17 +798,24 @@ export class BoardService {
         // `customTaskTypeFields` (the half that may be patched) and the row stores the whole
         // `taskTypeFields`, so this is where the request type becomes the repository's.
         await this.blockRepository.update(homeWorkspaceId, id, narrow.customTaskTypeFields(effective, block));
+        const updated = assertFound(await this.blockRepository.get(homeWorkspaceId, id), 'Block', id);
         // Origin = the block's HOME so editing a shared block fans out to every board mounting it.
-        // Forward the acting tab's connection id so the realtime transport SKIPS echoing this coarse
-        // signal back to it: the REST response already carried the authoritative block (the SPA
-        // upserts it), so a self-echo would only trigger a redundant board-wide re-hydrate — the same
-        // "don't refresh off your own mutation" contract move/reparent already follow. Every OTHER
-        // subscriber still receives the signal and refreshes.
-        await this.emitBoardChanged(homeWorkspaceId, 'block-updated', id, originConnectionId);
-        // A frame's position/size come from THIS board's mount, not the row we just re-read — so a
+        // Forward the acting tab's connection id so the realtime transport SKIPS echoing this back to
+        // it: the REST response already carried the authoritative block (the SPA upserts it), so a
+        // self-echo would only trigger a redundant board-wide re-hydrate, the same "don't refresh off
+        // your own mutation" contract move/reparent already follow. Every OTHER subscriber receives
+        // the change, carrying the edited block. The UNPROJECTED row is what rides: the projection
+        // below is for THIS board, and a fan-out reaches boards with different mounts. That only ever
+        // matters for a frame, whose payload `deliverableBoardBlock` drops at the wire anyway.
+        await this.emitBoardChanged(homeWorkspaceId, {
+            reason: 'block-updated',
+            block: updated,
+            originConnectionId,
+        });
+        // A frame's position/size come from THIS board's mount, not the row we just re-read, so a
         // frame edit (rename, threshold, and above all a RESIZE) must not hand the SPA the block's
         // own, never-updated coordinates to upsert.
-        return this.projectForWorkspace(workspaceId, assertFound(await this.blockRepository.get(homeWorkspaceId, id), 'Block', id));
+        return this.projectForWorkspace(workspaceId, updated);
     }
     /** Move a block into a new container at a new local position. */
     async reparent(workspaceId, id, input, originConnectionId) {
@@ -853,8 +853,14 @@ export class BoardService {
                 const destService = await this.serviceForContainer(destBlocks, parent);
                 await this.blockRepository.setService(blockHome, [...descendantIds(destBlocks, id)], destService ?? null);
             }
-            // Origin = the block's HOME so the re-stamped subtree fans out to every mounting board.
-            await this.emitBoardChanged(blockHome, 'block-reparented', id, originConnectionId);
+            // Origin = the block's HOME so the re-stamped subtree fans out to every mounting board. No
+            // payload: a reparent moves the whole SUBTREE between parents, and the moved block alone
+            // cannot state what its descendants' service stamps became.
+            await this.emitBoardChanged(blockHome, {
+                reason: 'block-reparented',
+                blockId: id,
+                originConnectionId,
+            });
             return assertFound(await this.blockRepository.get(blockHome, id), 'Block', id);
         }
         // Cross-home: the block and its new parent belong to two services homed in different
@@ -895,10 +901,14 @@ export class BoardService {
         // service's mounts (and that board). Source side: the block is gone from its old service, so
         // the block→service join can't resolve it anymore — notify the captured source boards
         // directly (origin-only) so they refresh the subtree away.
-        await this.emitBoardChanged(parentHome, 'block-reparented', id, originConnectionId);
+        await this.emitBoardChanged(parentHome, {
+            reason: 'block-reparented',
+            blockId: id,
+            originConnectionId,
+        });
         for (const ws of sourceFanout) {
             if (ws !== parentHome) {
-                await this.emitBoardChanged(ws, 'block-reparented', null, originConnectionId);
+                await this.emitBoardChanged(ws, { reason: 'block-reparented', originConnectionId });
             }
         }
         return assertFound(await this.blockRepository.get(parentHome, id), 'Block', id);
@@ -965,9 +975,10 @@ export class BoardService {
         await this.blockRepository.deleteMany(homeWorkspaceId, [...doomed]);
         await pruneDanglingEdges(this.blockRepository, homeWorkspaceId, blocks, doomed);
         // The block + any shared service are now gone, so fan out per captured target (blockId is
-        // unresolvable post-delete) — every board that showed the block refreshes it away.
+        // unresolvable post-delete): every board that showed the block refreshes it away. There is
+        // nothing to carry, and a delete CASCADES, so the refresh is the point.
         for (const ws of fanoutTargets) {
-            await this.emitBoardChanged(ws, 'block-removed', null);
+            await this.emitBoardChanged(ws, { reason: 'block-removed' });
         }
     }
     /**
@@ -992,7 +1003,11 @@ export class BoardService {
         }
         await this.blockRepository.update(homeWorkspaceId, id, { archived });
         // Origin = the block's HOME so archiving a shared service fans out to every board mounting it.
-        await this.emitBoardChanged(homeWorkspaceId, archived ? 'block-archived' : 'block-restored', id);
+        // Always a FRAME (asserted above) and archiving hides its whole subtree, so no payload.
+        await this.emitBoardChanged(homeWorkspaceId, {
+            reason: archived ? 'block-archived' : 'block-restored',
+            blockId: id,
+        });
         // Always a frame (asserted above), so it owes the caller this board's layout override.
         return this.projectForWorkspace(workspaceId, assertFound(await this.blockRepository.get(homeWorkspaceId, id), 'Block', id));
     }
@@ -1037,8 +1052,11 @@ export class BoardService {
             }
         }
         // Origin = the target's HOME so toggling an edge on a shared task fans out to all mounts.
-        await this.emitBoardChanged(homeWorkspaceId, 'dependency-toggled', targetId);
-        return assertFound(await this.blockRepository.get(homeWorkspaceId, targetId), 'Block', targetId);
+        // Re-read first so the event carries the target: `dependsOn` lives on it, so one block
+        // states the whole change (the SOURCE block is untouched).
+        const updated = assertFound(await this.blockRepository.get(homeWorkspaceId, targetId), 'Block', targetId);
+        await this.emitBoardChanged(homeWorkspaceId, { reason: 'dependency-toggled', block: updated });
+        return updated;
     }
 }
 /**