tempScriptPath returns os.TempDir()/flow-warp-<uuid>.sh. UUID is 16 crypto/rand bytes hex-encoded — sufficient uniqueness for concurrent spawns. No de

temporalSummary builds the "in-progress for 5 days, due in 2 days" line for `flow show task`.

ttyForHarnessSession returns the controlling tty (e.g., "/dev/ttys012") of the process matching `binary` and carrying the given session UUID in its ar

ttyForHarnessSession returns the controlling tty (e.g., "/dev/ttys012") of the process matching `binary` and carrying the given session UUID in its ar

waitMax returns waitingMaxRunes when truncation is enabled, 0 otherwise.

windowIDForHarnessSession parses `kitty @ ls` JSON and returns the kitty window id of the first window whose foreground_processes contain a process ma

withTempFlowRoot points FLOW_ROOT at a fresh tempdir and returns the root. It does NOT open flow.db — callers that need a live DB should use showListE

wrapAccessibilityError returns a multi-line error explaining what's missing and how to fix it. The Claude session that ran `flow do` surfaces this err

wrapAccessibilityError returns a Warp-specific multi-line error pointing at the right System Settings pane and naming "Warp" (not "Terminal" — that wo

AutoRunArgv builds `claude --session-id <uuid> -p <prompt> [--dangerously-skip-permissions]` as argv (not a shell string) so the `flow do --auto` supe

InstallSkill writes content to SkillInstallPath. Creates parent dirs.

---------- launching ---------- LaunchCmd builds `claude --session-id <uuid> <quoted-prompt> [--dangerously-skip-permissions]`. Injection text (opts.I

LiveSessionIDs scans the process table for claude invocations carrying --session-id or --resume and returns counts per UUID (lowercased). A count > 1

---------- identity ----------

NewSessionID generates a v4 UUID locally. flow's caller writes it to tasks.session_id before spawning so `claude --session-id <uuid>` produces a trans

RenderTranscript opens the session jsonl at the claude convention path (~/.claude/projects/<encoded-cwd>/<sessionID>.jsonl), decodes the claude-specif

ResolveTaskOrProject resolves a ref that could be either a task or project. Supports optional task/ or project/ prefix. Without prefix, tries both. Er

ResumeBackground runs `claude --bg --resume <sessionID> [<injection>] [--dangerously-skip-permissions]`. `--bg` does not honor `--resume`'s id — it st

ResumeCmd builds `claude --resume <uuid> [<quoted-injection>] [--dangerously-skip-permissions]`.

SkillVersionPath returns the sidecar VERSION file alongside SKILL.md.

---------- headless ----------

SpawnBackground runs `claude --bg --name <name> <prompt> [--dangerously-skip-permissions]` and captures the minted session id. opts.Inject is appended

ActivateOwner clears archived_at so `flow owner start` un-retires a retired owner (otherwise it'd be active-but-hidden and never tick).

TestAmbientHarness covers the env-var probe: returns the matching harness when its session-id env var is set, nil otherwise.

TestAppendStaleVersionHintDevBuildIsEmpty pins that dev builds (Version=="dev" or "") never trigger the version check at all — running flow from `make

TestAppendStaleVersionHintMatchingIsEmpty pins that when the local version matches the latest release, no nudge is appended.

TestAppendStaleVersionHintStaleEmitsHint pins the staleness signal shape: the hook must include "flow-version-stale:" so the §4.15 trigger in the skil

TestAppleScriptHasWasRunningBranch — the keystroke AppleScript contains the warm/cold delay branch and keystrokes `bash <path>` + Return. Validates th

TestAutoExecAppendsInjection: cmdAutoExec, given a --with instruction, appends the marker + instruction to the prompt it hands to claude.

TestAutoExecFinalizesCompleted: when the headless session self-completes (task ends up 'done' and the runner returns nil), __auto-exec records 'comple

TestAutoExecFinalizesDead: a runner error (or a session that never marks itself done) finalizes as 'dead'.

TestAutoRunnerUsesHarnessArgv verifies the supervisor builds its argv from the resolved harness (not a hardcoded binary). The per-harness argv shape i

TestBGAgentStatus: a claude-bound task whose session is in the registry resolves to its live agent (status/state/pid); absent or session-less tasks re

BackgroundAgents must query with --all so exited/failed/completed sessions are visible (needed to tell "removed" from "present, idle").

TestBackgroundOverrideBeatsEnv confirms the test escape hatch: setting BackgroundOverride pins IsBackground regardless of $FLOW_TERM, so tests can for

TestBuildAutoBootstrapPrompt sanity-checks that the autonomous prompt tells the session it is headless, forbids interactive prompting, instructs self-

TestBuildBootstrapPromptInvokesSkill pins the same invariant for the fresh-spawn prompt used by `flow do` (the hook only covers resume).

An explicit --slug that collides with an existing owner should fail with a friendly message, not a raw SQL UNIQUE-constraint error.

---------- add project ----------

---------- add task ----------

TestCmdDoAutoLaunchesDetached pins the core --auto behavior: no terminal tab is spawned, the detached supervisor launcher is invoked, and the task's a

TestCmdDoAutoRefusesWhenAlreadyRunning: a second --auto launch while a prior run is still 'running' (live pid) is refused without --force.

TestCmdDoAutoRejectsHere: --auto cannot combine with --here (--here binds the current session; --auto spawns its own). --with IS allowed (see TestCmdD

TestCmdDoAutoWithInjection: --auto --with threads the instruction to the detached supervisor so it can append it to the autonomous prompt.

TestCmdDoBackgroundAlreadyRunning: re-running while the session is alive in the registry must NOT spawn or resume — just report.

TestCmdDoBackgroundFreshSpawn: $FLOW_TERM=bg flow do <task> spawns a bg agent, captures the REAL full session id (not a pre-allocated phantom), record

TestCmdDoBackgroundResumeWhenExited: a bound session that's still listed but no longer running (exited, no pid) is resumed (forked + re-recorded), not

TestCmdDoBackgroundResumeWhenGone: a bound session ABSENT from the registry is brought back via --bg --resume <oldid>, and because --bg mints a fresh