Repository navigation
v0.11.0
Breaking: stricter CLI parsing
Scripts relying on input silently accepted by 0.10.0 must correct it before upgrading. The following now exit with code 2:
- Unknown or misspelled
--flags, such as--captur=50(#346). - Flags belonging to another subcommand, such as
send --capture=50(#348). - Boolean flags with values other than
trueorfalse, such as--enter=1; use--enter=falseto disable a flag (#338). - Invalid
--diagnosticsintervals, including non-numeric, non-positive,false, and values above 2147483 seconds (#342).
Added
- Added a bundled
omp(Oh My Pi) pattern set forpluk watch --cli=omp. pluk watchnow warns once on stderr when the--cliname has no pattern set, andpluk patterns --cli=<name>reportsno pattern setinstead of printing an empty set.
Changed
pluk attachnow writes its progress, warnings and status messages to stderr, and the JSONL event schema is documented in the README as a stable surface.- Releases publish to npm via Trusted Publishing (OIDC) through the
npmGitHub Environment; theNPM_TOKENsecret is no longer used (#303).
Fixed
- Diagnostics written to stderr no longer carry ANSI colour codes unless stderr is a TTY and
NO_COLORis unset; a small leveledlog()helper is added insrc/diagnostics.ts. pluk sessionsno longer reports STATE/CLI as unknown whenraw_outputevents (frompluk attachwith raw capture) flood the log tail; raw lines are skipped when sizing the tail window.pluk patternsandpluk subscribenow derive the builtin CLI fallback list fromBUILTIN_PATTERNS, so it includes codex and aider and cannot drift.pluk subscribeandpluk watchnow reject an empty--filter=value with an error (exit 2) instead of silently ignoring it.pluk watchnow emitsraw_outputevents when no pattern set exists for the chosen--cli, as its warning promises, without needing--include-raw.- Log rotation now also enforces
PLUK_LOG_MAX_BYTES: after trimming toPLUK_LOG_KEEP_LINES, the oldest kept lines are dropped until the log fits under the byte cap, so it no longer stays over the cap and gets rewritten every 30s. pluk patternsnow honors--patterns-dir, so a custom pattern set is shown (and its CLI names listed) instead of a false "no pattern set".tool_call_startedevents no longer cut an emoji or other astral character in half at the 120-characterinput_previewlimit; truncation now counts code points, so the preview never ends in an invalid lone surrogate.tool_call_startedevents no longer cut a ZWJ emoji sequence, flag or base-plus-combining-mark character in half at the 120-characterinput_previewlimit; truncation now counts grapheme clusters.pluk sessionsno longer showsNaNd ago(or sorts a session first) when a log event carries an unparseablets; such timestamps are ignored for last activity.pluk attachno longer word-splitspluk/rationguardpaths resolved fromPATHwhen they contain spaces; the resolved path is shell-quoted so the pipe-pane, rationguard spawn, and watcher cleanup pattern see a single word (#274).- Bare value-taking flags (e.g.
pluk send s --text hello,--run-dir /tmp/x,--filter x) are now rejected with exit code 2 and a--flag=<value>hint instead of being parsed as the stringtrue(which typedtrueinto the agent pane); fixes #278. - Log rotation now applies the
PLUK_LOG_MAX_BYTEScap even when the log has fewer thanPLUK_LOG_KEEP_LINESlines (#283). pluk watch --capture=<ms>now rejects fractional intervals such as--capture=1.5, accepting only positive integers as documented (#291).tool_call_completedevents now reportduration_msin milliseconds ((2.3s)→2300) instead of passing the on-screen seconds figure through unchanged (#294).pluk subscribewithout--from-beginningno longer replays the kept tail of the log as new events when the log is rotated before the first new line arrives; the subscriber now remembers the last line already in the file at start-up and resumes after it.pluk send --session=<name>/pluk-send --session=<name>no longer drops a positional text word that happens to equal the session name; the leading positional is treated as the session only when--sessionis absent.pluk sessionsnow prints theLAST ACTIVITYandEVENTSheadings with a gap between them and aligns every row with its column heading; the table matches the README example again.pluk attach --rationguardnow scopes its stale-watcher reap (pgrep -f) to the invoking user's processes, so another user's process with a matching command line no longer makeskillfail and abort the attach before the rationguard watcher starts.pluk attach --cli=copilotnow launches the standalonecopilotCLI (thegh copilotextension was retired) and--dangerousmaps to--allow-all-toolsfor it.pluk --help,pluk sessionsandpluk patternsno longer emit ANSI colour codes when stdout is not a TTY orNO_COLORis set; previously only stderr was gated.pluk attachnow wirestmux pipe-panebefore launching the CLI, so start-up output (trust dialog, login prompt, model line) is classified instead of lost (#331).- Document the real
PLUK_RUN_DIRdefault ($XDG_RUNTIME_DIR/pluk, else/tmp/pluk-<uid>) in the README and the session-monitoring runbook (#333). pluk sendno longer loses a trailing;(tmux treats an argument ending in;as a command separator); the text now reaches the pane byte-for-byte (#335).- Boolean flags such as
--enter,--literal,--verboseand--dangerousnow reject values other thantrue/false(e.g.--enter=1) with exit 2 instead of silently turning the flag off;--flag=falseis the explicit off spelling. pluk attachnow warns on stderr when--command,--cli-argsor--dirare passed for a tmux session that already exists, instead of silently ignoring them (#340).watch/subscribe --diagnostics=SECS: a non-numeric, non-positive orfalsevalue (abc,0,-5,5min,false) used to silently run at the 60s default; it is now rejected with exit 2, as are values above 2147483 s that would overflowsetInterval(#342).- Cap very large finite periods passed to the
startDiagnosticslibrary API at Node's maximum timer delay (2147483.647 seconds) instead of overflowing into a 1 ms reporting loop; the CLI already rejects out-of-range--diagnosticsvalues with exit 2 (#344). pluknow rejects unknown or misspelled--flags(e.g.--captur=50,--entr) with an error (exit 2) instead of silently ignoring them.pluk watch --capturenow bounds eachtmux capture-panepoll with a timeout so a hung tmux server is counted as a capture failure (visible in--diagnostics) instead of freezing the watcher silently (#353).pluk attach --rationguardno longer aborts a half-wired session when a stale watcher PID has already exited beforekill; stale watchers are reaped per PID, already-gone PIDs are ignored, and other kill failures print a warning and continue.pluk attach --dangerousnow passes--yoloto gemini and--yes-alwaysto aider; a CLI with no known auto-approve flag now prints a warning even without--verbose.pluk attach --dangerousnow launches goose withGOOSE_MODE=autoinstead of the nonexistent--non-interactiveflag, which made goose exit on an unknown argument.- Subscriber tail mode preserves a partially written event at startup and delivers it once its terminating newline is appended, instead of dropping it.
- Classifier reports the tool name for Claude tool lines such as
● Bash(ls)instead of mistaking the one-word argument for a(kind)suffix. - attach: the
--dangerousrestart hint for an existing session now includes--cli-args(#370). pluk attachnow validates the CLI command and arguments before creating the tmux session, so a bad--cli-args(e.g. an unterminated quote) is reported as a usage error (exit 2) instead of leaving an orphaned session with pipe-pane attached.pluk sessionsnow widens the SESSION and CLI columns to fit the longest value, so rows with long session or CLI names stay aligned with the header (#375).- attach:
splitShellWordskeeps explicitly empty quoted arguments (""/'') instead of dropping them, so--cli-args/--commandargv is no longer shifted (#381) pluk attach --rationguardnow also kills existing watchers that were started with a custom--rationguard-bin, so re-attaching no longer stacks duplicate watchers.pluk attachrejects invalid--rebuttalvalues with exit code 2 before touching tmux, and warns when--rebuttalor--rationguard-binis ignored without--rationguard(#280).- Reject flags that belong to another subcommand with exit 2 and a command-specific help hint instead of silently ignoring them (including flags passed to
version). Valid invocations are unchanged; help now lists all supported per-command flags, and a table-driven unit test checks every command against the flag union (#348). - Mark
command_receivedas reserved in the event documentation:pluk send/pluk-senddoes not currently emit it. - Keep
Classifier.commandReceived()sequence numbers in an independent, increasing command counter without changing subsequent classified or raw-output event sequence numbers. pluk attach --cli=omp --dangerousnow passes--approval-mode yoloas two arguments; previously omp received a single--approval-mode yolotoken and the flag had no effect.pluk --helpand the README no longer point to a Go pluk binary; thesubscribehelp line now namespluk watchas the usual publisher.--help/-hafter a subcommand (for examplepluk watch --help) now prints usage and exits 0 instead of being ignored.--helpanywhere is always treated as a help request (as it was before, viaparseArgs), even insidepluk sendtext. A bare-hafter thesendsession positional is passed through as text.pluk watch --capture --include-rawnow emitsraw_outputevents (once per changed frame) instead of silently ignoring the flag.pluk watchnow warns on stderr when--paneis passed without--capture, and--capture=(empty value) is rejected with exit 2 instead of silently selecting stream mode.
Security
SECURITY.mdnow namessecurity@hivecommons.dev(the organization's publishedsecurity.txtcontact) as the primary channel for reporting vulnerabilities, so the policy has a working private route whether or not GitHub private vulnerability reporting is enabled for the repository.