The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
/** Packaged CLI upgrade smoke test. Run after `npm run bundle`, optionally with the previous
* published cli.js and a frozen native hn binary as the second and third arguments. All state,
* launchers and requests stay in a disposable home and a guarded loopback fixture. */
import assert from 'node:assert/strict'
import { execFile } from 'node:child_process'
import { createHash } from 'node:crypto'
import { copyFileSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, readlinkSync, rmSync, symlinkSync, writeFileSync } from 'node:fs'
import { createServer } from 'node:http'
import { tmpdir } from 'node:os'
import { dirname, join, resolve } from 'node:path'
import { promisify } from 'node:util'
const run = promisify(execFile)
const candidate = resolve(process.argv[2] || 'dist/cli.js')
const previous = process.argv[3] && resolve(process.argv[3])
const native = process.argv[4] && resolve(process.argv[4])
const bytes = readFileSync(candidate)
const notify = readFileSync(join(dirname(candidate), 'notify.mjs'))
const root = mkdtempSync(join(tmpdir(), 'hn-upgrade-'))
const home = join(root, "home with ' quotes")
const cliDir = join(home, '.harness', 'cli')
const bin = join(home, '.local', 'bin')
const cli = join(cliDir, 'cli.js')
const harness = join(bin, 'harness')
const hn = join(bin, 'hn')
const prefix = `hn-upgrade-${process.pid}`
const port = 19449
assert(port >= 19440 && port <= 19449)
const base = `http://127.0.0.1:${port}`
const quote = value => `'${value.replace(/'/g, `'\\''`)}'`
const sha = data => createHash('sha256').update(data).digest('hex')
const tui = join(root, 'tui-fixture')
const recorder = join(root, 'record.mjs')
// Do not inherit auth, sockets, tmux, data directories or a real daemon's port.
const env = {
HOME: home, PATH: `${bin}:${dirname(process.execPath)}:/usr/bin:/bin`,
PORT: String(port), HN_SOCKET_NAME: prefix, HN_TMPDIR: root,
HARNESS_TUI_BIN: tui, ADAPTER_UPDATE_DISABLE: 'true',
ADAPTER_UPDATE_URL: `${base}/metadata.json`, HARNESS_STORE_CATALOG_URL: `${base}/catalog.json`,
ADAPTER_RUNTIME_METADATA_URL: `${base}/runtime.json`, ADAPTER_GRID_RUNTIME_METADATA_URL: `${base}/grid.json`,
SHELL: '/bin/sh', TERM: 'xterm-256color',
}
const options = { env, cwd: root, timeout: 20_000, encoding: 'utf8' }
const server = createServer()
let version
let hnVersion = '0.1.2'
let hnBadChecksum = false
const hnBytes = () => Buffer.from(`#!/bin/sh\nprintf 'hn ${hnVersion} (tmux 3.5a)\\n'\n`)
const requests = []
server.on('request', (request, response) => {
requests.push(request.url)
if (request.url === '/metadata.json') {
response.end(JSON.stringify({ cli: {
version,
cli: { url: `${base}/cli.js`, sha256: sha(bytes), size: bytes.length },
notify: { url: `${base}/notify.mjs`, sha256: sha(notify), size: notify.length },
} }))
} else if (request.url === '/hn-metadata.json') {
const nativeBytes = hnBytes()
response.end(JSON.stringify({ version: hnVersion, builds: {
[`${process.platform}-${process.arch}`]: { url: `${base}/harness-tui`, sha256: hnBadChecksum ? 'a'.repeat(64) : sha(nativeBytes), size: nativeBytes.length },
} }))
} else if (request.url === '/harness-tui') response.end(hnBytes())
else if (request.url === '/cli.js') response.end(bytes)
else if (request.url === '/notify.mjs') response.end(notify)
else { response.statusCode = 404; response.end() }
})
try {
for (const dir of [cliDir, bin]) mkdirSync(dir, { recursive: true })
writeFileSync(join(cliDir, 'package.json'), '{"type":"module"}\n')
copyFileSync(previous || candidate, cli)
writeFileSync(join(cliDir, 'notify.mjs'), notify)
writeFileSync(harness, `#!/bin/sh\nexport ADAPTER_UPDATE_DISABLE=true\nexec ${quote(process.execPath)} ${quote(cli)} "$@"\n`, { mode: 0o755 })
writeFileSync(recorder, 'console.log(JSON.stringify({args:process.argv.slice(2),home:process.env.HOME,port:process.env.PORT,socket:process.env.HN_SOCKET_NAME,pin:process.env.ADAPTER_UPDATE_DISABLE}))\n')
writeFileSync(tui, `#!/bin/sh\nexec ${quote(process.execPath)} ${quote(recorder)} "$@"\n`, { mode: 0o755 })
version = (await run(process.execPath, [candidate, 'version'], options)).stdout.trim()
assert.match(version, /^\d+\.\d+\.\d+/)
assert(!existsSync(hn), 'running a checkout must not migrate the installed copy')
await new Promise((done, reject) => { server.once('error', reject); server.listen(port, '127.0.0.1', done) })
if (previous) {
const oldVersion = (await run(harness, ['version'], options)).stdout.trim()
assert(!existsSync(hn), 'previous release fixture must predate launcher repair')
const nextVersion = version
version = oldVersion
const alreadyCurrent = await run(harness, ['update'], options)
assert(alreadyCurrent.stdout.includes(`Already on the latest version (v${oldVersion})`))
assert(!existsSync(hn), 'reproduce the missing command after an already-current update')
version = nextVersion
console.log('PASS reproduced missing hn on the already-current previous release')
const update = await run(harness, ['update'], options)
assert(update.stdout.includes(`installed v${version}`), update.stdout)
assert.equal(sha(readFileSync(cli)), sha(bytes))
assert(!existsSync(hn), 'a staging canary must not migrate the live installation')
console.log(`PASS published CLI ${oldVersion} stages ${version} with its original updater`)
}
// The first command on the new bundle also covers a machine already on the latest version.
const current = await run(harness, ['update'], options)
assert(current.stdout.includes(`Already on the latest version (v${version})`), current.stdout)
assert(existsSync(hn), 'an already-current update must add the missing hn command')
const args = ['-L', prefix, '--port', String(port), '--version']
const launched = JSON.parse((await run(hn, args, options)).stdout)
assert.deepEqual(launched, { args, home, port: String(port), socket: prefix, pin: 'true' })
assert.equal(readFileSync(hn, 'utf8'), `#!/bin/sh\nexec ${quote(harness)} tui "$@"\n`)
console.log('PASS already-current update creates hn; installed command preserves arguments, home and pin')
rmSync(hn)
await Promise.all(Array.from({ length: 8 }, () => run(harness, ['version'], options)))
assert.equal(lstatSync(hn).mode & 0o100, 0o100)
assert.deepEqual(readdirSync(bin).sort(), ['harness', 'hn'])
console.log('PASS concurrent CLI starts publish one complete launcher and clean staging files')
rmSync(hn)
const other = join(root, 'unrelated-hn')
writeFileSync(other, 'unrelated command\n')
symlinkSync(other, hn)
await run(harness, ['update'], options)
assert.equal(readlinkSync(hn), other)
assert.equal(readFileSync(other, 'utf8'), 'unrelated command\n')
console.log('PASS an existing hn symlink and its target remain unchanged')
if (native) {
rmSync(hn)
await run(harness, ['version'], options)
const output = (await run(hn, args, { ...options, env: { ...env, HARNESS_TUI_BIN: native } })).stdout.trim()
assert.match(output, /^hn \d+\.\d+\.\d+ \(tmux /)
console.log(`PASS repaired hn launcher runs the frozen native release: ${output}`)
}
rmSync(hn)
await run(harness, ['version'], options)
// An existing hn used to stay old forever when the CLI said it was already current.
const managed = join(home, '.harness', 'bin', 'harness-tui')
mkdirSync(dirname(managed), { recursive: true })
const managedEnv = { ...env, HARNESS_TUI_MANIFEST_URL: `${base}/hn-metadata.json` }
delete managedEnv.HARNESS_TUI_BIN
const managedOptions = { ...options, env: managedEnv }
const oldHn = Buffer.from("#!/bin/sh\nprintf 'hn 0.1.1 (tmux 3.5a)\\n'\n")
writeFileSync(managed, oldHn, { mode: 0o755 })
const hnUpdate = await run(harness, ['update'], managedOptions)
assert(hnUpdate.stdout.includes(`Already on the latest version (v${version})`), hnUpdate.stdout)
assert(hnUpdate.stdout.includes('Installed hn 0.1.2'), hnUpdate.stdout)
assert.equal(sha(readFileSync(managed)), sha(hnBytes()))
assert.match((await run(hn, ['--version'], managedOptions)).stdout, /^hn 0\.1\.2 /)
const downloaded = requests.filter(url => url === '/harness-tui').length
await run(harness, ['update'], managedOptions)
assert.equal(requests.filter(url => url === '/harness-tui').length, downloaded)
console.log('PASS an already-current CLI upgrades hn; the next hn launch uses it without repeated downloads')
hnVersion = '0.1.3'
hnBadChecksum = true
const failedHn = await run(harness, ['update'], managedOptions)
assert(failedHn.stderr.includes('hn update failed'), failedHn.stderr)
assert(failedHn.stdout.includes('Already on the latest version'), failedHn.stdout)
assert.match((await run(hn, ['--version'], managedOptions)).stdout, /^hn 0\.1\.2 /)
hnBadChecksum = false
await run(harness, ['update'], managedOptions)
assert.match((await run(hn, ['--version'], managedOptions)).stdout, /^hn 0\.1\.3 /)
console.log('PASS hn checksum failure preserves the installation and does not block CLI updates; retry succeeds')
hnVersion = '0.1.2'
await run(harness, ['update'], managedOptions)
assert.match((await run(hn, ['--version'], managedOptions)).stdout, /^hn 0\.1\.3 /)
rmSync(managed)
await run(harness, ['tui', '--install'], managedOptions)
assert.match((await run(hn, ['--version'], managedOptions)).stdout, /^hn 0\.1\.2 /)
console.log('PASS no automatic downgrade; explicit first install still works')
// A legacy development link bypassed the managed binary entirely. A normal update diagnoses it;
// explicit repair switches commands only after a verified download and keeps a usable backup.
const checkout = join(root, 'checkout', 'tui')
const legacy = join(checkout, 'target', 'hn-test', 'hn')
mkdirSync(dirname(legacy), { recursive: true })
writeFileSync(join(checkout, 'Cargo.toml'), '[package]\nname = "harness-tui"\n')
writeFileSync(legacy, oldHn, { mode: 0o755 })
for (const repair of [['tui', '--install'], ['update', '--force']]) {
rmSync(hn)
rmSync(managed)
symlinkSync(legacy, hn)
const bypass = await run(harness, ['update'], managedOptions)
assert(bypass.stdout.includes('does not receive automatic updates'), bypass.stdout)
assert(bypass.stdout.includes('harness tui --install'), bypass.stdout)
assert.equal(readlinkSync(hn), legacy)
assert(!existsSync(managed))
assert.match((await run(hn, ['--version'], managedOptions)).stdout, /^hn 0\.1\.1 /)
const override = await run(harness, ['update', '--force'], options)
assert(override.stdout.includes('HARNESS_TUI_BIN='), override.stdout)
assert.equal(readlinkSync(hn), legacy, 'an explicit development override prevents forced migration')
hnBadChecksum = true
await run(harness, repair, managedOptions).catch(error => assert.equal(error.code, 1))
assert.equal(readlinkSync(hn), legacy, 'failed downloads must not change the launcher')
hnBadChecksum = false
const repaired = await run(harness, repair, managedOptions)
assert(repaired.stdout.includes('hn now follows automatic updates'), repaired.stdout)
assert.equal(readFileSync(hn, 'utf8'), `#!/bin/sh\nexec ${quote(harness)} tui "$@"\n`)
assert.equal(sha(readFileSync(legacy)), sha(oldHn))
assert.match((await run(hn, ['--version'], managedOptions)).stdout, /^hn 0\.1\.2 /)
}
const backups = readdirSync(bin).filter(name => name.startsWith('.hn-backup-'))
assert.equal(backups.length, 2)
for (const backup of backups) assert.equal(readlinkSync(join(bin, backup, 'hn')), legacy)
console.log('PASS legacy development installs migrate through --install or update --force, with backups and verified downloads')
if (native) {
rmSync(hn)
copyFileSync(native, hn)
const original = sha(readFileSync(hn))
const repaired = await run(harness, ['tui', '--install'], managedOptions)
assert(repaired.stdout.includes('hn now follows automatic updates'), repaired.stdout)
const backup = readdirSync(bin).find(name => name.startsWith('.hn-backup-') && !backups.includes(name))
assert(backup)
assert.equal(sha(readFileSync(join(bin, backup, 'hn'))), original)
assert.match((await run(hn, ['--version'], managedOptions)).stdout, /^hn 0\.1\.2 /)
console.log('PASS a copied production-native hn migrates with an intact native backup')
}
rmSync(managed)
await run(harness, ['update'], managedOptions)
assert.match((await run(hn, ['--version'], managedOptions)).stdout, /^hn 0\.1\.2 /)
console.log('PASS updates restore a missing binary behind an existing managed launcher')
const shadowDir = join(root, 'earlier-bin')
mkdirSync(shadowDir)
writeFileSync(join(shadowDir, 'hn'), oldHn, { mode: 0o755 })
const shadow = await run(harness, ['update'], { ...managedOptions, env: { ...managedEnv, PATH: `${shadowDir}:${managedEnv.PATH}` } })
assert(shadow.stdout.includes(`Your PATH resolves hn to ${join(shadowDir, 'hn')}`), shadow.stdout)
assert.equal(sha(readFileSync(join(shadowDir, 'hn'))), sha(oldHn))
console.log('PASS PATH shadowing is reported without changing unrelated commands')
assert(requests.every(url => ['/metadata.json', '/cli.js', '/notify.mjs', '/hn-metadata.json', '/harness-tui'].includes(url)), JSON.stringify(requests))
} finally {
server.closeAllConnections()
if (server.listening) await new Promise(done => server.close(done))
rmSync(root, { recursive: true, force: true })
}