Core API

Import from untestutils.

defineRecipes / defineRecipe

export const recipes = defineRecipes({
  site: /* Recipe */,
}, import.meta.url)

Field	Notes
id	Set when registering by key
prepare?	Build into artifact dir
start	Required → Running
ready?	HTTP / custom gate
hashInputs?	Identity inputs
share?	Share policy

Running: { kind: 'url', url, stop?, pid? } and/or { kind: 'dir', dir }. Local share: always|never servers must set pid (e.g. via spawnManaged); remote attach omits stop/pid.

useHarness / leaseTarget / withHarness

const app = await useHarness('site')
// app.url, app.dir, app.$fetch, app.files.*

const leased = await leaseTarget('site')
await leased.release()

await withHarness('site', async (app) => {
  /* … */
})

prepareOnce(id) returns the prepared target without ALS bookkeeping.

Also: getCurrentHarness(), ensurePrepared(), stopAllTargets(), resolveArtifactsRoot(), resolveSessionArtifactsRoot(), sanitizeSession(), waitForHttpReady(), TargetRegistry, SCHEMA_VERSION.

Process handles

Users manage instances, not PIDs / process groups:

Export	Semantics
spawnManaged(cmd, args, opts?)	Long-lived process → ManagedProcess (stop / alive / logs)
runCommand(cmd, args, opts?)	Foreground one-shot (build / CLI tools)
stopAllTargets()	Drain live handles + registry orphans

ManagedProcess.stop(opts?): { graceMs?, signal?, keepEventLoop? } (defaults 2000 / SIGTERM). Servers use process-group / taskkill /T internally — callers never pass negative PIDs. Orphan reclaim: Troubleshooting.

See How it works · Drivers API.