Repository navigation
Releases
v2026.11.20.1 — Pstack 0.15.46
This release updates the bundled pstack skills to 0.15.46 at upstream revision fbb86c0.
- Statechart adds a native Windows Node entry point, Windows process-tree cleanup, and CRLF handling for TLC output.
- Arena and Poteto mode pick up upstream Gemini panel defaults. Agent Workers continues to use the models and effort configured in
workers.toml.
Bundle regeneration and package installation passed, including native Pi and Codex discovery. The 37 selected Statechart CLI cases passed on Linux with recorded TLC outputs, including CRLF replay and process cleanup. Native Windows execution remains unverified.
v2026.11.19.2 — Agent Workers for Herdr and Rex
The repository is now named herdr-rex-pstack-orchestrator. The core skill and CLI are now agent-workers, and Herdr and Rex both open worker tabs titled Workers. Worker panes and blocks show the configured worker and harness.
The new CLI uses the existing workers.toml and task store. Existing tasks keep their recorded backend and terminal bindings. The new skill includes horch.py as a compatibility entry point.
If you installed herdr-orchestrator, install agent-workers in the same scope and remove the old skill. If you installed the pstack bundle, update the full bundle together. Upgrade guide
Verification covered Rex, Herdr Core, legacy Herdr, and an upgrade of the installed bundle. PR #50
v2026.11.19.1 — Native Rex worker orchestration
The orchestrator now runs workers natively in Rex. It verifies the controller's terminal context before dispatch and runs Rex workers in background rexOrch tabs in the controller's session. Rex and Herdr share the existing worker configuration and horch commands. Each task keeps its launch backend for observation and cleanup.
Rex support uses a local Unix-socket server. Verification covered two concurrent workers on an isolated Rex server, two real Codex workers with independently checked results, and the Herdr core and viewer regression suite.
v2026.11.18.1 — Pstack 0.15.43
This release bundles pstack 0.15.43. Herdr uses the roles, models and effort configured in workers.toml. The upstream worker guide is included for reference.
The workflow review covers all 22 playbooks. A live Pi controller completed all six bounded Trace forensics stages, the Herdr Core viewer fixture passed 116 checks, and the installed Babysit watcher returned a single PR status. The configured How worker reached its viewer but stopped before delivery on a provider quota.
v2026.11.16.1 — Pstack 0.15.42
Syncs the optional pstack bundle from 0.15.36 to 0.15.42, pinned at bf0c7cd.
- Simplifies How to one configured read-only explainer and Why to controller-led record research; removes obsolete references.
- Updates Arena to require a judge from a different vendor, treating Claude Fable and Claude as one vendor.
- Syncs model defaults, playbook wording, Comment Sicko, and statechart composite-entry/SANY diagnostic fixes. Configured Herdr workers still govern models and effort.
- Preserves the 60-skill bundle and existing exclusions. Reinstall the bundle to receive these changes.
Verified: regeneration equality, upstream freshness, installation of all 60 entries/593 files, and native Pi/Codex discovery without catalog errors. Python package CI passed. Rerunnable evidence.
Model workflows, statechart model checking/rendering, and native Claude Code discovery remain unverified. Bundled upstream tests and recordings are source material, not fresh runtime evidence.
Changes: PR #47.
v2026.11.05.1 — Verified controllers and worker viewers
Controller identity and core worker presentation are now verified before agents report a worker window as available.
- Herdr agent controllers must provide
--caller-paneand unique visible conversation text through--caller-text. Foreground harness/cwd and screen evidence are checked and recorded before launch, even when a shared daemon retains another pane's process ancestry. - Core viewers are checked against the live controller workspace, a separate
hcOrchtab, the pinned attach process and rendered core output.verify-viewerrefreshes this evidence before requesting user interaction; failures retain the worker and report an explicit reason. - Readiness, submission and observed execution are separate facts.
wait --rechecknever submits work or promotes a definitely unsent task to running.submitallows one explicit first submission after startup recovery and rejects sent or uncertain outcomes. - The orchestration and repository verification skills document the new commands, recovery rules and E2E procedures. The pinned pstack source remains 0.15.36.
Verification on Linux: 116 real-core lifecycle/viewer assertions, 26 caller-identity assertions and 23 caller/config preflight assertions passed, with owned runtime/workspace cleanup confirmed. Workers were deterministic fixtures; these runs did not exercise real models, trust decisions or legacy runtime. Session-mismatch coverage remains explicitly unverified because the live controller exposed no matching agent_session. macOS runtime remains unverified.
Merged main has the same file tree as the verified PR head. Package validation on Python 3.11 and 3.14 passed for the release commit.
v2026.11.04.1 — Same-workspace core viewers
Controllers running in Herdr now require hcOrch viewer panes in their verified caller's same workspace, preserving focus and the controller tab.
- Explicit
--caller-paneand inherited Herdr context are validated even when tools loseHERDR_ENV; incomplete context stops dispatch before worker allocation. - Skills now require context recovery before dispatch and immediate reporting of missing or failed viewers. Controllers outside Herdr can still run headless.
- Viewer failures preserve the existing worker.
listandcheckexpose viewer warnings, and a setup check with a viewer warning cannot report success. - The bundled pstack source remains 0.15.36.
Verification: 93 real-core E2E checks passed on Linux, including two actual attach viewers with HERDR_ENV removed, same-workspace tab reuse, unchanged focus, context rejection, delivery/cancellation, and complete owned workspace/core cleanup. The fixture is deterministic and makes no model calls. Skill validation and independent review also completed.
Merged main has the same file tree as the verified PR head and passed package validation with Python 3.11 and 3.14.
macOS runtime remains unverified. When all Herdr context is absent, the CLI cannot infer the controller's association; the skill requires restoring that context. Viewer placement alone does not confirm successful attachment.
v2026.11.03.2 — Core-first worker orchestration
Prefer herdr-core for worker execution, with legacy Herdr used only when core is absent.
- Core workers can run headless. Existing Herdr windows show them in
hcOrchtabs; legacy workers keephorchtabs. - Tasks retain backend identity, and core tasks pin their endpoint and terminal identity for waiting and cleanup.
- Native status and nonce-bound result validation remain required for delivery. Stored problem tasks no longer interrupt healthy tasks in a batch wait.
- Existing worker configuration remains valid. The bundled pstack source remains 0.15.36.
Verification includes 75 real-core fixture assertions, configured Pi delivery through both backends, installer preservation, and two independent review rounds. A fresh independent local Shipping verifier compared the parent and release head through the CLI before merge and returned PASS+NOTES.
Configured Codex and Claude task delivery remains unverified beyond native startup. Runtime validation is on Linux. Remote core orchestration is not provided.
Merged main passed package validation with Python 3.11 and 3.14. Its files match the independently tested PR head.
v2026.11.03.1 — Installer and upstream monitor fixes
Use the latest Skills CLI for installation and prevent the upstream monitor from failing while removing its temporary Git checkout.
- Installation, removal, CI, and verification instructions now use
skills@latest. The README documents Node.js 22.20 or later and links the upstream CLI. See PR #42. - Temporary upstream checkouts disable automatic Git maintenance to avoid detached writes racing with cleanup. Sanitized evidence preserves the original failures and the successful checker validation. See PR #43.
- The bundled pstack source remains 0.15.36 at
c742dd61706fbacc1b95f1a20b7b988cf096ce6c.
Verification on merged main (c6aac6f2b9c20056b890fe4f47b8cae2aab0dee9): package validation passed with Python 3.11 and 3.14, and the upstream comparison passed. Recorded installer validation with Skills CLI 1.7.4 preserved 605 files across 60 skills and passed native Pi/Codex catalog checks; Claude Code installed files were checked. Native Claude discovery and model-driven sync workflows were not exercised. The separate machine-local recovery candidate was not installed by this release.
v2026.10.29.2 — Restore README status and diagram
This release restores the README's package validation and pstack upstream status badges, along with the directly visible workflow diagram and latest release link. The diagram retains both its light and dark versions.
The shorter getting-started guide and installation documentation remain in place. See PR #40.
Verification
The restored badge and diagram markup matches the earlier README. Package validation passed on the merged main commit with Python 3.11 and 3.14.