Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
57 commits
Select commit Hold shift + click to select a range
5aaa759
feat(bin): add shared_quota opt-out from quota-based dispatch ranking…
Dematom1 Oct 30, 2026
3b82fd8
fix(bin): distinguish recycled reaper PIDs in tombstone cleanup (#7958)
zestysoft Oct 30, 2026
05196e3
feat(bin): allow omp as a remote secondmate harness (#7939)
fabriciopirini Oct 30, 2026
c0aa730
fix(bin): name a consumed branch grant instead of a wiring bug (#7969)
c6aw Oct 30, 2026
b83dc59
fix: preserve literal ampersands in spawn and supervision paths (#7906)
WTF-Am-ID Oct 30, 2026
7647d6b
feat(bin): read dispatch provider keys from a declared credential sou…
mikeastwoody Oct 30, 2026
d95b8a8
fix: clean up remote reply temporary files and locks on exit (#6489)
cloud-practitioner Oct 30, 2026
cccdc04
chore: ignore Claude Code per-user settings (#6482)
cloud-practitioner Oct 30, 2026
df81d81
fix: prefilter inbox history for idempotent remote steering (#7905)
WTF-Am-ID Oct 30, 2026
6d01da5
feat(bin): add Kiro CLI as a crewmate/scout harness adapter (port of …
kunchenguid Oct 30, 2026
4e984c7
fix(bin): publish hold origins only after backend success (#6777)
cloud-practitioner Oct 30, 2026
355a307
feat(backends): add experimental explicit-only hc (herdr-core) runtim…
frizynn Oct 30, 2026
2520dfb
fix: refresh Herdr upstream references and licensing (#8000)
kunchenguid Oct 30, 2026
be28d8e
fix(pi): stop repeated numbered and byte excerpt reads (#7992)
kesslerio Oct 30, 2026
dbcb5ab
fix(bin): keep the PR merge watch working when a worker with a PR is …
zestysoft Oct 30, 2026
095db3b
test: pin lock staleness in malformed presentation lock wake-queue ca…
trillium Oct 31, 2026
58eb59f
feat(bin): add configurable self-update source for /updatefirstmate (…
AgardnerAU Oct 31, 2026
bb3e690
fix: bound watcher auto-arm failures and recover interrupted locks (#…
kunchenguid Oct 31, 2026
0593d83
fix(bin): cut stat forks in the wake drain by reading identity and si…
Marsjohn-11 Oct 31, 2026
30d6d15
fix(bin): keep pr= merge-poll identity last when recording captain-ho…
andrewkimcanidium Oct 31, 2026
f61b404
fix: explain how to recover missing worktree identity (#8027)
kunchenguid Oct 31, 2026
e2e4e56
fix: prevent watcher startup interruptions from cascading stale locks…
kunchenguid Oct 31, 2026
d42a699
fix(bin): allow cd to the home itself and add --help to fm-pr-merge.s…
Azd325 Oct 31, 2026
8fdf262
feat(pi): surface opted-in model-stream silence for Pi workers (#7212)
kesslerio Oct 31, 2026
043d834
feat(dispatch): bind a profile to an explicit quota_scope row (#8020)
Azd325 Oct 31, 2026
a03b3a1
fix(herdr): read pane foreground processes in one jq pass (#8029)
Marsjohn-11 Nov 1, 2026
bdaf633
fix(bin): refuse captain-hold release while the away record exists (#…
Azd325 Nov 1, 2026
95f006f
fix: harden herdr-core compatibility and message submission (#8037)
kunchenguid Nov 1, 2026
49dc31b
Fix host mirror deduplication before text capping (#7914)
WTF-Am-ID Nov 1, 2026
f1ad899
test: clear inherited launcher environment in shared fixtures (#7589)
babbarc Nov 1, 2026
41a47c0
fix(pr-health): do not enroll contributions already final (#8057)
Azd325 Nov 1, 2026
e1a7a2f
feat: monitor author-actionable pull request states (#8055)
Dematom1 Nov 1, 2026
36e67ea
test: keep shared-captain spawn test off a live Herdr server (#8064)
c6aw Nov 1, 2026
679b14a
fix(watch): surface timed-out checks on both timeout paths (#8068)
c6aw Nov 1, 2026
b7d2533
test: resolve host tools in watcher lock fixtures (#8070)
kesslerio Nov 1, 2026
8b9c22a
feat: support Rex for remote second mates (#8058)
kunchenguid Nov 2, 2026
6b342ba
docs(harness-adapters): correct claude --setting-sources worker claim…
cazalbonsamuel-dot Nov 2, 2026
d111d99
fix(bin): settle contributions per owner and bound record reads (#8023)
Azd325 Nov 2, 2026
39c6791
fix(bin): keep authenticated PR polls armed across template updates a…
kesslerio Nov 2, 2026
a4bf5f8
feat: auto-select hc inside Herdr app-projected terminals (#8060)
kunchenguid Nov 2, 2026
c61646f
feat(bin): add opt-in native Codex Stop-hook park for watcher supervi…
Moshik21 Nov 2, 2026
740855a
fix: preserve piped stdin in timed commands (#8079)
nikunj95 Nov 2, 2026
1751f20
fix(secondmate): respawn a local second mate on its recorded backend …
Marsjohn-11 Nov 2, 2026
b5e5ad4
fix(bin): stop a stale terminal run outranking newer crew-state truth…
AgardnerAU Nov 2, 2026
2118038
fix: name the closing key in OPEN DECISIONS and keep the message when…
AgardnerAU Nov 2, 2026
9224c90
feat(pr-check): record reported PRs from done lines during the check …
Azd325 Nov 2, 2026
60f95df
fix(dispatch): parenthesise openai answer check for jq 1.8 (#8066)
babbarc Nov 2, 2026
78c69df
test(tests): make anchored absence assertions real regex checks (#8017)
kesslerio Nov 2, 2026
f641b44
fix(spawn): lease the Herdr task copy so a restart restores the worke…
AgardnerAU Nov 3, 2026
9662521
fix(bin): keep inactive reconcile from reporting terminal state while…
Azd325 Nov 3, 2026
4f31f51
fix(herdr): call an unresolvable launcher pane id stale instead of am…
trillium Nov 3, 2026
e719d68
feat(bin): add Hermes TUI worker adapter for tmux crewmates (#8084)
camaragon Nov 3, 2026
5b91acf
fix: preserve late worker changes during teardown (#7932)
WTF-Am-ID Nov 3, 2026
cf6cdac
chore: merge upstream main into house
jazz127 Nov 3, 2026
21dafe1
fix: reconcile house behavior with the merged upstream changes
jazz127 Nov 3, 2026
61a0571
no-mistakes(test): Fix Codex park delivery and macOS Hermes detection
jazz127 Nov 4, 2026
50420d1
no-mistakes(document): Correct stale upstream merge documentation
jazz127 Nov 4, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 4 additions & 2 deletions .agents/skills/harness-adapters/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ For recovery and control, use the exact `harness=` in `state/<id>.meta`; never i
Deliver lifecycle actions only through `../../../bin/fm-control.sh <task-id> interrupt|exit|relaunch`.
Never type an interrupt key or exit command through `fm-send`, where routing-marked lifecycle text becomes chat.
Trust handling is complete only when inspection proves the target started processing its instructions; delivery success alone is not proof.
Muse, Gemini, Devin, Command Code, Polytoken, and Cortex are verified only for crewmate and scout work, never a secondmate or primary.
Muse, Gemini, Devin, Command Code, Polytoken, Cortex, Kiro, and Hermes are verified only for crewmate and scout work, never a secondmate or primary.

## Detection

Expand Down Expand Up @@ -97,7 +97,9 @@ A new tool remains undispatchable until the `verify` plan, its harness entry, ev
"devin": "references/harness/devin.md",
"commandcode": "references/harness/commandcode.md",
"polytoken": "references/harness/polytoken.md",
"cortex": "references/harness/cortex.md"
"cortex": "references/harness/cortex.md",
"kiro": "references/harness/kiro.md",
"hermes": "references/harness/hermes.md"
}
}
```
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ Each supported harness handles its folder-trust gate differently, and the tool r
For Claude, load `references/harness/claude.md`; its workspace-trust section owns the non-key-answerable gate and spawn-time pre-registration for every spawn kind.
agy gates every fresh worktree too; the spawn pre-registers it in agy's own store the same way, and a strict post-launch gate answers any dialog that still renders before the spawn reports success.
Cursor suppresses its dialog with launch-time `--trust`, and Muse suppresses its own with `--yolo`.
Kiro suppresses its `--trust-all-tools` confirmation modal with a `chat.disableTrustAllConfirmation` setting the spawn seeds into the per-task `KIRO_HOME`; `references/harness/kiro.md` owns that recipe and where the decision persists.
Grok renders a folder-trust gate in a linked worktree, and `references/harness/grok.md` owns how to verify the worker's real location, answer it, and where the decision persists; the project picker is a separate dialog that stays absent when the spawn starts in a git root.
Pi gates the fresh-worktree case too, but unlike Claude its dialog is answered with Enter, and `references/harness/pi.md` owns that recipe and where the decision persists.
Codex shows a directory-trust dialog on the first run for a repository root.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Claude gates a folder it has never seen behind an interactive workspace-trust di
Every Claude spawn therefore pre-registers its launch directory before launch, and the dialog does not appear: the task worktree for a ship or scout, and the home itself for a `--secondmate` spawn, in either seeded shape (a leased worktree or a standalone clone).

A second, separate dialog - "Allow external CLAUDE.md file imports?" - renders whenever a loaded CLAUDE.md chain reaches outside the project tree, which every crewmate's does through the captain's own `~/.claude/CLAUDE.md` importing `~/.claude/RTK.md`.
`--setting-sources project,local` (the minimal worker tool surface) does not suppress it either, and it gates the session exactly like the trust dialog: cursor on "No, disable external imports", no way to move the selection from firstmate's steering plane.
`--setting-sources project,local`, which only `../../../bin/fm-live-lab.sh` passes (an `fm-spawn.sh` worker loads the user settings too), does not suppress it either, and it gates the session exactly like the trust dialog: cursor on "No, disable external imports", no way to move the selection from firstmate's steering plane.

`../../../bin/fm-claude-trust.sh` records `hasTrustDialogAccepted` for both the worktree and its primary checkout in `${CLAUDE_CONFIG_DIR:-$HOME}/.claude.json`, where a home's worker account pin decides `CLAUDE_CONFIG_DIR` (`../../../docs/configuration.md` "Worker account pin"), for a ship or scout spawn; a secondmate spawn registers only its own home entry, since a secondmate home has no separate primary-checkout entry to carry import consent forward from.
For a ship or scout spawn, the external-imports flags (`hasClaudeMdExternalIncludesApproved`, `hasClaudeMdExternalIncludesWarningShown`) are carried forward alongside the trust flag only when the primary checkout's project entry already carries an explicit `hasClaudeMdExternalIncludesApproved===true` from a prior interactive session - the common first-spawn case is a project claude has never been asked about, so those two flags are left unwritten and the import dialog still renders, even though trust registers normally.
Expand Down
10 changes: 6 additions & 4 deletions .agents/skills/harness-adapters/references/harness/codex.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,14 +45,16 @@ This is why `$no-mistakes` reaches a Codex worker instead of being consumed by t
## Primary integration

The primary integration was verified on 2026-07-08 with codex-cli 0.142.1.
The firstmate primary's `.codex/hooks.json` registers a Stop hook that pipes Codex's payload to `../../../bin/fm-turnend-guard.sh`.
The firstmate primary's `.codex/hooks.json` registers a Stop hook that pipes Codex's payload to `../../../bin/fm-turnend-guard.sh`, through `../../../bin/fm-codex-stop-park.sh --guard` when that script is present.
Codex Stop hooks preserve exit status 2 and stderr to block, and expose `stop_hook_active` for the same one-block loop safety used by the guard's default mode.

The Stop payload includes `cwd`, but the tracked hook does not use it to choose the guard executable.
Codex runs the Stop command with process PWD set to the hook-loaded project root, while no `CODEX_PROJECT_DIR`, `CODEX_WORKSPACE_ROOT`, or `CODEX_CWD` root variable is set.
The tracked hook anchors to `pwd -P`, verifies that root is Firstmate-shaped and hook-bearing, and then invokes the guard with the original payload.

Codex's primary watcher protocol is `../../../bin/fm-watch-checkpoint.sh --seconds "${FM_CODEX_WATCH_CHECKPOINT:-180}"`, not `../../../bin/fm-watch-arm.sh`.
Codex cannot reason while a foreground tool call is running, so the checkpoint is deliberately foreground and bounded to return control regularly for user messages and queued notifications.
In a home with `config/supervision-host` and no `config/supervision-host-off` the checkpoint runs the supervision host instead of the watcher, with Claude's print mode as its headless engine, and holds for at least an hour while away; [`supervision-host.md`](../../../../../docs/supervision-host.md) owns the host and that bound.
Codex CLI 0.163.0 supports the native asynchronous Stop park registered by `bin/fm-codex-stop-park.sh` in a home that opts in with [`config/codex-stop-park`](../../../../../docs/configuration.md#codex-native-stop-park-configcodex-stop-park), verified in an isolated real CLI lab on 2026-10-19.
The hook waits outside the model and delivers actionable wakes with `codex queue --thread`, including in embedded mode without a shared app-server daemon.
The script owns version and native-session selection; [`codex.md`](../../../../../docs/supervision-protocols/codex.md) owns the operating protocol and failure fallback.
Homes without the opt-in, unverified versions, and sessions without the native registration keep [`codex-checkpoint.md`](../../../../../docs/supervision-protocols/codex-checkpoint.md), the unchanged bounded foreground protocol.
The [supervision host](../../../../../docs/supervision-host.md) retains its existing posture decisions on both paths.
Codex's PreToolUse watcher-arm seatbelt blocks directly through its project hook.
37 changes: 37 additions & 0 deletions .agents/skills/harness-adapters/references/harness/hermes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# Hermes Agent

Hermes is a spawned crewmate/scout TUI adapter on tmux only.
Primary and secondmate supervision, other runtime backends, desktop/web surfaces, and messaging bridges are unsupported and refused.
[Hermes verification](../../../../../docs/verification/hermes.md) owns dated vendor evidence and the live guard.

## Operating facts

| Fact | Value |
|---|---|
| Launch and profile | The interactive `hermes` CLI TUI, with native per-spawn profile selection; [`fm-spawn.sh`](../../../../../bin/fm-spawn.sh)'s header owns flags, omission, and relaunch mechanics. |
| Model and effort | The selected profile owns both axes. Firstmate refuses a non-default model override and records but omits effort. Native profile discovery is `hermes -p <profile> config get model --json` and `config get agent.reasoning_effort --json`; `/model` is the native interactive selection surface. No provider or catalog membership is inferred from a model name. |
| Busy and turn end | Native `pre_llm_call` and `on_session_end`, through [`fm-hermes-hook.sh`](../../../../../bin/fm-hermes-hook.sh) and the generation-bound busy writer; only the native `tui` platform is accepted, and the turn id binds the close across session-id rotation. |
| Hook carrier | A private native managed-scope overlay staged by [`fm-hermes-lib.sh`](../../../../../bin/fm-hermes-lib.sh); existing profile hooks are preserved, existing managed policy is refused, and no profile SOUL or configuration is edited. |
| Autonomy and hooks | The launch grants native tool autonomy and native shell-hook acceptance, including existing configured hooks. The startup guard confirms only a complete visible telemetry offer with `No thanks` already selected; native Hermes records that decline. Other first-run setup still requires a prepared profile. |
| Interrupt | Double Escape, only with a proven empty composer because the same chord discards drafts; idle double Escape preserves the worker. Ctrl+C is not used because it can exit an idle TUI. |
| Exit and relaunch | `/quit` exits to the pane shell. Relaunch starts from the stored task brief with the recorded profile and home; it does not attach to a gateway or resume an unrelated native session. |
| Identity | `FM_HERMES_HARNESS=hermes` at the launch boundary plus structural Hermes ancestry; [`fm-hermes-process-lib.sh`](../../../../../bin/fm-hermes-process-lib.sh) owns anchored Node TUI / Python module process identity. |
| Composer | Native `❯`, profile-prefixed or the default profile's unprefixed prompt, beneath a status rule; on tmux a pane showing `❯` is checked for Hermes identity before the generic cursor read, so only the Hermes classifier answers for Hermes panes; synthetic busy-hint cursor and bright drafts are distinguished by [`fm-composer-lib.sh`](../../../../../bin/fm-composer-lib.sh). Unrecognized themes, wraps, dialogs, or unreadable identity defer delivery. |
| Skills | Use ordinary text pointing at the installed skill's `SKILL.md`; native slash skill invocation has not been verified. |

## Profile safety

The selected profile's own running gateway is accepted only while idle: its native `gateway_state.json` must name the live gateway process, report `gateway_state: running` with no restart requested, `active_agents: 0` and no active work, and carry a heartbeat no older than Hermes's own 120-second staleness bound.
A mid-turn, starting, draining, or transitional gateway is refused, as is a live gateway, held native runtime lock, or active systemd unit without that idle status, and any unreadable or malformed gateway state.
A live default-root gateway, or a multiplexer launched from another home that serves the profile, is refused because its activity cannot be attributed to this profile.
An existing managed scope is refused before hooks are staged.
Firstmate does not stop, restart, or message the gateway.
The [verification record](../../../../../docs/verification/hermes.md) owns the idle-coexistence evidence and its limits.
The check is a launch preflight, not a lifetime reservation: the gateway may begin a turn after dispatch, and overlapping turns on one profile were not verified.

## Limits

The TUI's `--query-file` path did not submit the initial prompt on the verified version; the spawn uses the native interactive query path instead.
Early provider/build errors can leave the spawn-owned busy record open when the native end hook does not run; inspect the visible pane and use the ordinary recovery procedure.
User profile settings, plugins, tools, and inference credentials remain native Hermes concerns.
No primary Stop guard, pre-tool protection, watcher protocol, secondmate hook, or Herdr lifecycle was verified.
Loading
Loading