Repository navigation
Releases
Releases · alphastorm/tern-sidepulse
tern-sidepulse 0.2.0
Immutable
release. Only release title and notes can be modified.
- Breaking requirement — SidePulse with
program_status(inteliwear/sidepulse#72): Requires a SidePulse build installed or updated withsidepulse updateon or after 2026-11-10 (merge commitad4a5217). When an older SidePulse is present (relay-events.sockwithoutprogram-status.sock),tern-sidepulse: doctorreports an error onreceiver(this SidePulse predates program status) with the remedysidepulse update. Usetern-sidepulse0.1.0for older SidePulse builds. - SidePulse program-status transport (
tern_sidepulse/transport.py,tern_sidepulse/coordinator.py,tern_sidepulse/doctor.py): replaces the 0.1.0 hook-event transport (events.sock,relay-events.sock,UserPromptSubmit/Interrupt/… hook-event lines, and the single combinedtern-sidepulse:<install_id>session) withSidePulseTransportover SidePulse'sprogram-status.sock($XDG_STATE_HOME/sidepulse/agent-monitor/program-status.sock,~/.local/state/sidepulse/agent-monitor/program-status.sock, or/tmp/sidepulse-status-<uid>/<sha256(path)[:16]>.sockwhen theprogram-status.sockpath exceeds 96 bytes). Each OMP session is reported as its own row under salted scopetern-sidepulse-<24 hex>(sha256(install_id NUL host NUL pane)[:24], salted byinstall_idfromidentity.json), mapped to statesworking,blocked(waiting_for_input),error(blocked_error),done(completed),idle(idle_ready), andclearacross at most 32 rows (most urgent first). Unchanged rows are not resent; active rows (working,blocked,error) refresh every 300 s; retries reuserequest_idwith 2, 4, 8, 16, 30 s backoff and wake immediately when a socket appears or changes; SidePulse restarts (including a move to another socket candidate) resubmit every current row except delivereddonerows; and a scope ledger (<runtime dir>/program-scopes.json, mode0600, salted scope hashes only) written before each scope's first report lets the next coordinator overwrite still-open panes in place and clear stale ones after a 15 s grace period following a crash (at once if they would exceed the 32-row cap). An exiting coordinator keeps clearing rows for up to 2 s, anddisablenow stops the coordinator after clearing its rows, so the coordinator thatenablelets the next snapshot start readsconfig.jsonafresh. - Per-pane rows and session labels (
window.luau,tern_sidepulse/coordinator.py,tern_sidepulse/reducer.py,tests/test_privacy.py,tests/test_rows.py,tests/test_transport.py): observations are keyed by(host, pane)(local, or a remote host'saddress,name, orid:<n>) and deduplicated across windows by mode priority (blocked_error,waiting_for_input,working,completed,idle_ready) and newest non-empty label. When a window has at least one OMP pane,window.luaureadscx.session:panes()andcx.session:tabs()at most once per 5 s pass and labels each OMP pane from its user-given tab name (TabInfo.name) or its ownPaneInfo.title(cut to 256 UTF-8 bytes in the window and sanitized in the coordinator to at most 96 characters without control, surrogate, or private-use characters). Sanitized labels are sent to SidePulse incontext.titleby default ("labels": falsein<plugin data dir>/config.jsonsends"title": ""and"display_name": "OMP in Tern"instead); host keys never appear outside coordinator memory, pane ids and host keys never leave the Mac (SidePulse reports andprogram-scopes.jsoncarry salted scope hashes only), and labels never appear incoordinator.log,doctor.json,bridge.py status, coordinator replies, orprogram-scopes.json. - Configuration, environment, CLI, and status updates (
tern_sidepulse/cli.py,tern_sidepulse/client.py,tern_sidepulse/doctor.py):<plugin data dir>/config.jsontakesprogram_sockets(replacingui_socketsandservice_sockets, which are ignored if still present) andlabels(falsedisables labels);TERN_SIDEPULSE_PROGRAM_SOCKETSreplacesTERN_SIDEPULSE_UI_SOCKETSandTERN_SIDEPULSE_SERVICE_SOCKETS;bridge.py coordinator --program-socket PATH(repeatable) replaces--ui-socketand--service-socket;doctorreplacesreceiver_uiandreceiver_servicewithreceiver(plusreceiver_rejectionswhen SidePulse rejects a report) and showsinstall <first 8 chars>…on itsidentitycheck; andstatusdropssession_idin favour of per-moderowscounts,rows_total,rows_labelled,status.transport, anddelivery = {"program_status": …}in coordinator replies. - Snapshot budget and request limits (
window.luau,tern_sidepulse/limits.py): the window keeps each encoded snapshot within 192 KiB by dropping labels and retrying once (labels_dropped), host keys are capped at 128 bytes in the window and 128 characters in the coordinator, and the coordinator request cap is raised from 256 KiB to 1 MiB. - Headless Luau window harness and contract checks (
tests/luau/,tests/test_luau_harness.py,tests/test_sidepulse_contract.py,.github/workflows/ci.yml): runs the realwindow.luauunder theluau0.745 CLI across the backoff/interpreter/latch/role test drive (drive_backoff.luau, scenarios A–G), the label and host-key drive (drive_labels.luau, scenarios L1–L12), and the snapshot-budget drive (drive_budget.luau, scenarios B1–B3), and checks theprogram_statuswire contract against SidePulsead4a5217.
tern-sidepulse 0.1.0
First release.
- Window plugin (
window.luau) for Tern: observes the OMP sessions visible in open Tern windows across local and attached remote hosts, classifies panes by theiromp.sessionsurface role, and reports aggregate status (working,waiting_for_input,completed,blocked_error,idle_ready) on SidePulse as one synthetic session (tern-sidepulse:<install_id>). - Standard-library Python 3.10+ helper and on-demand per-user coordinator (
bridge.py,tern_sidepulse): singleton lock, observer registration and 15 s leases, fixed-deadline outcome notices (15 s completion, 30 s failure), sleep-aware clock checks, bounded retry to both SidePulse receivers (events.sockfor the menu-bar app andrelay-events.sockfor the headless service), and automaticidle_readyclear and exit after the last window closes. - Tern command palette actions (
tern-sidepulse: doctor,tern-sidepulse: resync,tern-sidepulse: disable,tern-sidepulse: enable) and matchingbridge.pyCLI commands (status,doctor,resync,disable,enable). - Verified against Tern 0.9.12 (
e498b49), OMP 18.16.0, and SidePulse0.2.4.dev6+gffb1d3c2f(revisionffb1d3c2) with 111 unit and integration tests; see docs/compatibility.md. - Hardening: isolated
python3 -I -Shelper launches with bytecode cached under the plugin data directory (pycache/), strict UTF-8 JSON validation and 256 KiB request / 32-connection caps on the coordinator socket, mode0600runtime and state files in a0700directory, and automatic rejection of pre-3.10 interpreters with exponential retry backoff up to 30 s (see commitsbf38d95and8446d6a). - Presentation: the Pane mark, banner and social preview (
assets/), a synthetic demo animation (docs/media/, rendered byscripts/render_assets.py), the public site (site/, deployed by.github/workflows/pages.yml), the brand spec (docs/BRAND.md), andtests/test_site.py, which keeps the README,plugin.toml, the palette commands, and the site coherent.
Community project; not affiliated with or endorsed by the Oh My Pi, Tern, or SidePulse maintainers.