Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.
TypeScript adhdagent-orchestrationai-agentscanvasclaude-codecodexcoding-agentsdeveloper-toolselectrongeminilinuxmacosmultiplexeropencodeparallel-agentsterminalterminal-emulatorterminal-multiplexertmuxworkspace-manager
import { describe, it, expect } from 'vitest'
import { canCommitCanvas, canClearDirty, canCreateOnCanvas, liveCanvasHolds } from './persistGuards'
describe('canCommitCanvas', () => {
it('commits while the nodes in hand belong to the active project', () => {
expect(canCommitCanvas('a', 'a')).toBe(true)
})
// The field bug (2026-08-10): the 800ms autosave timer is armed under project A, the user
// switches to B (zustand updates synchronously), and the timer fires BEFORE the load effect has
// installed B's nodes — so A's nodes would be committed under B's id, wiping B.
it('refuses to commit one project canvas under another project id', () => {
expect(canCommitCanvas('a', 'b')).toBe(false)
})
// Before the first load effect runs, React Flow holds the initial `useNodesState([])` — an empty
// array that belongs to NO project. Committing it is the "both canvases went blank" wipe.
it('refuses to commit nodes that belong to no project yet', () => {
expect(canCommitCanvas(null, 'a')).toBe(false)
})
// No project open (welcome screen): there is no id to write under.
it('refuses to commit with no active project', () => {
expect(canCommitCanvas('a', '')).toBe(false)
expect(canCommitCanvas(null, '')).toBe(false)
expect(canCommitCanvas('', '')).toBe(false)
})
})
describe('canCreateOnCanvas', () => {
it('creates while the canvas on screen belongs to the active project', () => {
expect(canCreateOnCanvas('a', 'a')).toBe(true)
})
// Issue #443: the store already says B (a tab switch, or a bailed load effect that left the
// previous nodes mounted) while A's canvas is what the user sees. Creating here would insert
// the node into A's canvas but stamp B's cwd / account default / launch command onto it — for
// an agent session that is silent write access to the wrong repo. Refuse (the caller says so
// loudly); never resolve the project from ambient state that disagrees with the screen.
it('refuses to create while the canvas shows a different project than the active one', () => {
expect(canCreateOnCanvas('a', 'b')).toBe(false)
})
// Before the first load effect, or after a bailed one, React Flow's nodes belong to NO project.
it('refuses to create before any project canvas is installed', () => {
expect(canCreateOnCanvas(null, 'a')).toBe(false)
})
it('refuses to create with no active project', () => {
expect(canCreateOnCanvas('a', '')).toBe(false)
expect(canCreateOnCanvas(null, '')).toBe(false)
})
})
describe('canClearDirty', () => {
it('clears dirty when nothing changed while the save was in flight', () => {
expect(canClearDirty(7, 7)).toBe(true)
})
// Field bug 2026-08-10: a save can take seconds (SSH mirror write). Edits made DURING the await
// are not in the snapshot handed to the store, so clearing dirty marks them saved — and the
// watcher's not-dirty branch then clobbers them with a replaceProject + reload. Keep dirty set;
// the debounce re-saves.
it('keeps dirty set when an edit landed during the save', () => {
expect(canClearDirty(7, 8)).toBe(false)
})
it('keeps dirty set for a burst of edits during one save', () => {
expect(canClearDirty(0, 12)).toBe(false)
})
})
describe('liveCanvasHolds', () => {
it('a peer op for the project React Flow holds, which is also the active one, goes live', () => {
expect(liveCanvasHolds('b', 'b', 'b')).toBe(true)
})
// Task 2 review, risk E: the store already says B while React Flow still holds A (or nothing).
// Applying B's op to that array mixed it into A's nodes; the next commit wrote the mix into B.
it('never while React Flow holds another project, or none', () => {
expect(liveCanvasHolds('a', 'b', 'b')).toBe(false)
expect(liveCanvasHolds(null, 'b', 'b')).toBe(false) // a bail-out left the old nodes mounted
})
// …and never for a project that is no longer active, even if its nodes are still in hand: the
// switch has committed them, and the load that follows replaces them — the store is the copy
// that survives.
it('never for a project that is not the active one', () => {
expect(liveCanvasHolds('a', 'b', 'a')).toBe(false)
expect(liveCanvasHolds('a', null, 'a')).toBe(false)
expect(liveCanvasHolds('', '', '')).toBe(false)
})
})