Skip to content

Releases

foreman 4.5.2

Choose a tag to compare

@V-Songbird V-Songbird released this 16 Nov 18:00

No behavior change.

The README shows its banner, host cards, Ember scene and evidence graphics again, in assets/. The detail pages are back under docs/knowledge/: how it works, settings, limits and benchmarks.

The README now follows the shape and the wording the Foundry plugins share.

foreman 4.5.1

Choose a tag to compare

@V-Songbird V-Songbird released this 16 Nov 09:10

Antigravity

Foreman's roadmap guard runs again on current Antigravity. That host now sends a created file as write_file and an edit as edit_file, with the path in Path. Foreman watched only the three older tool names, so on Antigravity 1.5.9 a direct write or edit of ROADMAP.jsonl or .foreman/archive.jsonl was not refused. Foreman now watches both sets of names.

The write_file and edit_file payload shapes were observed on Antigravity 1.5.9. The guard under those names is covered by Foreman's tests and was not run in a live Antigravity session.

Antigravity installs are copies: pull your Foundry clone, run git submodule update --init, and run agy plugin install again to take this release.

Claude Code and Codex

No change in behaviour.

foreman 4.5.0

Choose a tag to compare

@V-Songbird V-Songbird released this 14 Nov 23:20

Claude Code

Foreman gains an optional Roadmap pane. In a project that has a ROADMAP.jsonl, a Roadmap button joins the mode labels in the prompt footer. It opens a pane that lists the roadmap in four groups: in progress, ready, blocked and deferred, with a search field and a card per entry.

  • The pane only reads the roadmap file. It never writes it.
  • A card's Resume, Accept or Pick button sends one request as the next prompt, such as "Pick roadmap entry 12 with Foreman". Foreman's pick flow then takes that entry. To prompt puts the same request in the prompt box without sending it.
  • In a project without a roadmap nothing is drawn.
  • A roadmap line Foreman cannot read is named in the pane.
  • The pane speaks English and Spanish, by the language setting, and adds no slash command.

The pane needs Claude Code 2.1.323 or later. It was seen in the desktop app, in the dark theme and in Spanish. The light theme, English and the terminal were not seen. The pane is for Claude Code only: Codex's and Antigravity's manifests and hook files change only in the version.

Every host

scripts/roadmap.js now answers an unknown get or show subcommand with the way to read one entry, list --ids <id>, and an unknown help with --help.

The repository now holds only what Foreman uses at run time, plus its tests, CI, LICENSE, SECURITY.md and CONTRIBUTING.md, so an install downloads less. The README is text only and names Claude Code as the primary host, with Codex and Antigravity as compatibility hosts. Release notes now live on this page; the repository carries no changelog file.

foreman 3.3.0

Choose a tag to compare

@V-Songbird V-Songbird released this 14 Nov 22:00

Every host

  • Foreman has a new icon: a green tag with a plumb line, from Foundry's
    hallmark-seal identity. The README banner, wordmark and Codex plugin icon use
    it. The Ember scene now ends with a stamp pressing that seal onto the answer,
    and each README graphic carries the seal in a corner. No recorded text,
    number or timing in the graphics changed.

Codex

  • After you update Foreman, review and trust its hooks again in /hooks.
    Codex runs a hook only after you trust it. This update adds a hook on
    collaborationspawn_agent and adds Bash to the matcher of the decision
    recall hook. Both change the hook registrations, so until you trust them
    again, Codex does not run the new hook or the decision recall hook at all.
  • On Windows, each hook now starts Node from cmd instead of PowerShell. Each
    command in the Codex shell starts two Foreman hooks. On the test machine,
    those two hooks now take about 0.6 seconds less in total. When PATH has no
    Node, the hooks still find it through a configured fnm default. This changes
    the command of every Foreman hook. Until you trust the hooks again in
    /hooks, Codex runs none of them.
  • A subagent that carries a roadmap entry's handoff is now named
    foreman_<id>, for example foreman_042. When it stops, Foreman ties its
    finish to that entry. With taskCloseGate set to "block", the session that
    spawned it is blocked once from ending its turn while the entry is still
    planned or in_progress. An entry awaiting acceptance, or already closed,
    passes. So does an entry whose last note line is paused: or
    review pending:, so each collaborationfollowup_task to a subagent whose
    review is pending does not block the coordinator again. An explicit
    codex-task.js check still blocks once on such an entry.
  • A task_name that is foreman or starts with foreman_ is refused unless
    it is exactly foreman_<id> for an entry in ROADMAP.jsonl. Every other
    name passes, and a handoff spawned under another name runs normally, but its
    finish is not tied to its entry.
  • A reviewed increment that is paused or gets no answer now records
    Codex session <session id> in its note. You can continue it from a new
    process with codex exec resume <session id> -. The - makes Codex read
    your decision from standard input, so the shell does not parse it. Type or
    paste the decision, then end input with Ctrl+D in a POSIX shell or Ctrl+Z
    and Enter in PowerShell or cmd. A new session that finds the note offers this
    command before it crafts the work again.
  • When a command's output contains a [Foreman: <id>] anchor and the decision
    documents folder has <id>.md, Foreman now tells the model to read that
    document before it changes what the anchor governs. Codex reads files
    through its shell, so this covers files it reads that way. One notice names
    at most 20 decision documents and says how many it left out. Recorded
    lessons are still recalled only when Codex uses apply_patch, Read, Edit
    or Write on the file. Claude Code keeps decision recall on Read, Edit
    and Write.