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 { readdirSync, readFileSync, statSync } from 'fs'
import { join, relative } from 'path'
import { describe, expect, it } from 'vitest'
/**
* No user-visible string may call the local machine a Mac.
*
* Issue #563 was not one slip: ~30 strings across 15 files said "this Mac", and a grep is the only
* thing that found them. The helper (`machineName.ts`) fixes the ones that existed; this test is
* what stops the next string from bringing the assumption back — the same posture as
* `fs-atomic.guard.test.ts`, and for the same reason: nothing else in the toolchain can see it,
* because on the platform most of this was written on the sentence is true.
*
* COMMENTS ARE NOT SCANNED. They are not shown to anyone, they carry real history ("a Mac→SSH
* node"), and rewriting them would bury the actual copy change in noise.
*/
const REPO_ROOT = join(__dirname, '..', '..', '..')
const ROOTS = ['src/renderer', 'src/shared']
/**
* Guard comparisons use one separator regardless of the host running Vitest.
*
* `relative()` answers in the HOST's separator, while the exemption keys below are written with
* POSIX slashes — so on Windows `ALLOWED.has(rel)` missed every entry, the exempt files were
* scanned after all, and the suite failed on copy that is correct (issue #746). Same rule, same
* helper shape, as `fs-atomic.guard.test.ts` and `localStore.guard.test.ts`.
*/
function normalizedSourcePath(value: string): string {
return value.replace(/\\/g, '/')
}
/** Files where naming a Mac is the CORRECT answer, each with the reason it is exempt. */
const ALLOWED = new Map<string, string>([
[
'src/renderer/lib/machineName.ts',
'the helper itself — its doc comment and examples name all three nouns'
],
[
'src/renderer/components/PtyPressureBanner.tsx',
'genuinely macOS: kern.tty.ptmx_max and the macOS password prompt'
],
[
'src/renderer/components/onboarding/OnboardingFlow.tsx',
'the notch step exists on macOS only (see the isMac step list in that file)'
]
])
const BANNED = /\b(this|This|your|Your|a|another) Macs?\b|\bMacs\b/
function sourceFiles(dir: string, out: string[] = []): string[] {
for (const entry of readdirSync(dir)) {
const full = join(dir, entry)
if (statSync(full).isDirectory()) {
sourceFiles(full, out)
continue
}
if (!/\.tsx?$/.test(entry) || /\.test\.tsx?$/.test(entry)) continue
out.push(full)
}
return out
}
/** Drop line comments and JSDoc/block-comment continuation lines — see the module doc. */
function isComment(line: string): boolean {
const t = line.trimStart()
return t.startsWith('//') || t.startsWith('*') || t.startsWith('/*')
}
describe('no user-visible copy calls this machine a Mac', () => {
it('finds none outside the documented exemptions', () => {
const offenders: string[] = []
for (const root of ROOTS) {
for (const file of sourceFiles(join(REPO_ROOT, root))) {
const rel = normalizedSourcePath(relative(REPO_ROOT, file))
if (ALLOWED.has(rel)) continue
readFileSync(file, 'utf8')
.split('\n')
.forEach((line, i) => {
if (isComment(line) || !BANNED.test(line)) return
offenders.push(`${rel}:${i + 1}: ${line.trim()}`)
})
}
}
expect(offenders, 'use thisMachine()/thisMachineCap()/machineNoun() from lib/machineName').toEqual(
[]
)
})
it('keeps the exemption list honest — every entry still exists and still says Mac', () => {
for (const [rel, why] of ALLOWED) {
const src = readFileSync(join(REPO_ROOT, rel), 'utf8')
expect(BANNED.test(src), `${rel} no longer needs its exemption (${why})`).toBe(true)
}
})
it('every exemption actually matches a file the scan walked', () => {
// The assertion above reads each exempt file by PATH, so it passes even when the scan's own
// lookup never matched it — which is exactly how the Windows separator bug hid: the exempt
// files were scanned and reported as offenders while this test stayed green. Comparing against
// the scan's OWN keys is what makes a key that stops matching fail HERE, naming the exemption,
// instead of failing above and naming innocent copy.
const scanned = new Set(
ROOTS.flatMap((root) => sourceFiles(join(REPO_ROOT, root))).map((file) =>
normalizedSourcePath(relative(REPO_ROOT, file))
)
)
for (const rel of ALLOWED.keys()) {
expect(scanned.has(rel), `${rel} is exempt but the scan never produced that key`).toBe(true)
}
})
it('normalizes exemption keys on both POSIX and Windows-shaped paths', () => {
expect(normalizedSourcePath('src/renderer/lib/machineName.ts')).toBe(
'src/renderer/lib/machineName.ts'
)
expect(normalizedSourcePath(String.raw`src\renderer\lib\machineName.ts`)).toBe(
'src/renderer/lib/machineName.ts'
)
// A Windows-shaped path must reach the SAME exemption the POSIX one does.
for (const rel of ALLOWED.keys()) {
expect(ALLOWED.has(normalizedSourcePath(rel.replace(/\//g, '\\')))).toBe(true)
}
})
})