Skip to content

v0.6.2 — the teaching channel, hardened

Latest

Choose a tag to compare

@xezpeleta xezpeleta released this 05 Oct 19:41
· 6 commits to main since this release

v0.6.2 — the teaching channel, hardened

Every change in this revision came from watching the channel fail
to explain itself, and fixing the explanation. Same rule as ever:
argv is the unit of trust, and every refusal teaches.

sysh (host)

Script and console lines no longer collide on one scope unit

A session is one process, so every line of a script — or a console
session — derived the same transient scope name; systemd refuses
to load a unit that already exists, and lines failed with exit 1 in
an alternating pattern. Every exec now gets a unique unit
(sysh-<key>-<nanotime>-<seq>), and the journal pair per line is
stable.

help says the shebang precisely

The script section ended its sentence with a semicolon glued to the
shebang, and clients that read literally copied #!/usr/bin/sysh;
into their uploads. The shebang is now quoted:
first line "#!/usr/bin/sysh".

A refused interpreter points at the shebang

In traced mode, an exec that names a denylisted interpreter — the
#!/usr/bin/env bash habit resolving through env — now says so:
interpreters are named in the script's shebang, not exec'd as
commands. Before, it was a bare "no rule allows this argv".

The allow path teaches too

In root and permissive modes, confusing commands run — so one
stderr note beats a cryptic child error: a literal &&, 2>&1 or
; in argv gets a single explanation before the child runs (one
note, first offending word, never a wall).

help is the survival guide

help gained the exit-code block (0 ok, 30 approval parked with TTL
and single-use semantics, 125 denied, 124 timeout, 3 malformed),
and every failure surface now points at it: generic denies,
no-input detail, bare-name hints.

sy watch

  • Expired approval requests keep their teaching line for a
    three-minute grace, then the pending panel hides itself — the
    wall log keeps the story.
  • Host cards say more with less: non-zero rule counts only, colored
    policy-mode chips (root = red), the agent-scripts mode as its own
    chip, no :22, digest in mono.
  • A host with no policy answer (down, or an older sysh) no longer
    breaks the whole grid.
  • Hosts fill within seconds of opening the page — the poller
    settles before its first round and logs fetch failures.
  • The priv badge explains itself on hover: this exact argv ran as
    root under an operator-authorized sudoers grant.

docs

The bash-compatibility spectrum is now a table — direct exec,
console, lines script, traced script, root mode — stating for each:
what the agent sends, what shell features it gets, what the policy
checks, what the journal sees, and what a refusal looks like. Up
the rows the agent gains shell and the operator loses sight of the
how — never of the what, until root mode. usage.html STEP 6 adds a
per-mode guide: what each level gives the operator, and the agent.