Skip to content

v0.10.0

Choose a tag to compare

@github-actions github-actions released this 13 Oct 14:33
· 169 commits to main since this release
b904965

Added

  • Added test/cli-presentation-branches.test.js and a stdout-throw fault kind in test/fixtures/inject-fault.mjs, pinning the pluk watch onEvent console.log guard, the sessions default run-dir and idle-row coloring, and the patterns default CLI and (none) placeholder (#195).
  • npm test now fails on a changelog.d/ fragment whose filename is not <category>-<slug>.md (category one of added/changed/deprecated/removed/fixed/security) or whose body is empty or not a markdown bullet list, so malformed fragments are caught on the PR instead of at release roll.
  • Added a blameless postmortem template to the runbooks for bad releases and publish incidents.
  • Added a runbook for recovering from a failed publish pipeline run, by failing job.
  • Added an index for the runbooks and linked it from CONTRIBUTING.md.
  • Added a runbook for diagnosing pluk send failures and text that does not reach the agent.
  • Added a runbook for diagnosing a monitored session that stops producing events, using the --diagnostics counters.
  • Pin the Subscriber size-shrink rotation fallback with a deterministic test: a kept tail whose leading bytes match the old head fingerprint must still be detected and resumed without replay.
  • Added test/tmux-contract.test.js, which runs the tmux seam against a real tmux server on a private socket (skipped when tmux is not installed), so tmux-semantics regressions like #105 and #169 are caught by npm test.

Changed

  • CI now tests against Node 26 in addition to Node 22 and 24 (#159).
  • Declared engines.node >=22 in package.json and updated CONTRIBUTING.md to match: Node 20 is end-of-life and has not been in the CI matrix since the coverage gate landed. npm install on Node 20 now warns; a test keeps the engines floor, the Test matrix and CONTRIBUTING in sync.
  • Added the dist-tag step to the release rollback runbook so the latest tag is restored to a known-good version.
  • test/tmux-contract.test.js now fails instead of skipping when tmux is missing and CI is set, so the real-tmux lane cannot silently go dark in CI; set PLUK_TMUX_OPTIONAL=1 to skip it deliberately.

Fixed

  • pluk watch --capture now rejects zero, negative and non-numeric intervals instead of busy-looping tmux capture-pane; watch() falls back to the default interval for invalid values (#147).
  • Every tmux target pluk uses is now an exact session match (-t =<session>), so a session name can no longer resolve to a different session by prefix or be read as window.pane; session names may no longer contain .. pluk send and attach put -- before the text, so text beginning with - is no longer parsed as tmux flags (#169).
  • pluk attach --rationguard-bin / PLUK_RATIONGUARD_BIN is now validated before the session is created, and the rationguard watcher reports spawn errors and propagates its exit code instead of crashing with an unhandled ENOENT (#171).
  • pluk subscribe no longer corrupts multi-byte UTF-8 characters (such as ✻) that straddle a 16 KiB read boundary into U+FFFD (#170).
  • Anchored the bare 429 in RATE_LIMIT_PATTERN for aider, codex, gemini and goose so ordinary output such as Read 1429 lines no longer emits false rate_limit events (#172).
  • Fixed pluk attach, pluk send and pluk watch --capture failing on pane-type tmux commands: the exact session target is now =<session>:, which send-keys, pipe-pane and capture-pane accept (#188).
  • Fixed watch() stream mode leaking the input stream 'error' listener: stop() now removes it and is idempotent (#193).
  • Fixed pluk sessions showing CLI = unknown: state_change events now carry the cli field (#197).
  • Fixed log rotation dropping lines appended while a session log was being trimmed, and tailing subscribers replaying the kept tail as duplicate events when they polled mid-rotation (#199).
  • pluk watch and pluk subscribe now reject unknown or empty --filter event types with exit code 2 instead of silently matching nothing (#200).
  • pluk sessions EVENTS column now counts only log lines that parse as valid events, ignoring malformed lines (#203).
  • Require a nonempty CHANGELOG section before publishing a tagged version, and create its GitHub release from the curated notes after npm publication. Existing releases are left untouched.
  • stripANSI now also removes residual control bytes (bare BEL/backspace, a dangling ESC, DEL) left by truncated or malformed sequences, so they no longer reach event payloads (#167).
  • Fixed pluk subscribe missing an in-place log rotation when the kept tail is larger than its read offset, which produced a malformed fragment and duplicated events: rotation is now also detected when the log's leading bytes change (#208).

Security

  • pluk attach now pins its npx --yes @hivecommons/pluk pipe-pane fallback to the running package's own version instead of fetching whatever latest the registry serves, so an attach can no longer pull in an unreviewed release at runtime.
  • pluk attach --rationguard no longer falls back to npx --yes @hivecommons/rationguard (unpinned latest) when rationguard is missing from PATH. It now fails before creating the tmux session with install instructions; operators who want a registry fetch choose the exact command and version themselves via the new --rationguard-bin=<cmd> flag or PLUK_RATIONGUARD_BIN.
  • pluk subscribe --verbose now strips terminal control characters from event fields before echoing them, and stripANSI recognises the full ECMA-48 set (OSC terminated by ST, RIS, DCS/APC/PM/SOS strings, CSI with intermediate bytes, 8-bit C1 controls). Previously a monitored agent could print a model line carrying such sequences and have them replayed raw into the operator's terminal and persisted into every event payload.