docs: record stances for the three not-yet protocol rows #197

Merged
natsukium merged 1 commit from docs/protocol-not-yet-trio-181 into main 2026-09-07 21:07:17 +09:00
Owner

Fixes #181.

The support matrix carried three ❌ not yet rows with no recorded stance and no
tracking issue. This records a verdict for each before the publish freeze:

  • DECCARA / DECRARA — adopt; the rectangle bounds model already serves five
    sequences. Tracked by #188.
  • In-band resize notify (?2048) — adopt; the notify carries the size in band
    on the PTY stream, ordered against the input around it. Tracked by #189.
  • XTSMGRAPHICS — refuse, for the reason Sixel is refused: it sizes Sixel/ReGIS
    surfaces and color registers felis does not keep, and Kitty graphics needs no
    numeric substitute.

Doc cascade: docs/reference/protocols/support-matrix.md (the rows now cite their
issue or the non-goal), docs/explanation/protocols/landscape.md (the rationale and
the "Revisit if …" triggers), docs/explanation/non-goals.md (the XTSMGRAPHICS
refusal beside Sixel).

Verified: just check green (fmt, clippy, nextest, deny, proto-compat); reviewed by pi luna + pi sol; docs proofread by Gemini gemini-3.8-flash-high

Follow-ups

  • #188 [v0.1/Protocol] Implement DECCARA / DECRARA rectangular attribute ops
  • #189 [v0.1/Protocol] Implement in-band resize notify (?2048)

Deferred

  • No automated guard for the tracked-issue-per-not-yet-row convention — the issue's
    own Tests section scopes verification to just prose-check and the docs-tree
    guards; a new documentation test asserting every not-yet row links an issue is
    hardening beyond the acceptance criteria, not a defect in this diff.
Fixes #181. The support matrix carried three `❌ not yet` rows with no recorded stance and no tracking issue. This records a verdict for each before the publish freeze: - **DECCARA / DECRARA** — adopt; the rectangle bounds model already serves five sequences. Tracked by #188. - **In-band resize notify (`?2048`)** — adopt; the notify carries the size in band on the PTY stream, ordered against the input around it. Tracked by #189. - **XTSMGRAPHICS** — refuse, for the reason Sixel is refused: it sizes Sixel/ReGIS surfaces and color registers felis does not keep, and Kitty graphics needs no numeric substitute. Doc cascade: `docs/reference/protocols/support-matrix.md` (the rows now cite their issue or the non-goal), `docs/explanation/protocols/landscape.md` (the rationale and the "Revisit if …" triggers), `docs/explanation/non-goals.md` (the XTSMGRAPHICS refusal beside Sixel). Verified: just check green (fmt, clippy, nextest, deny, proto-compat); reviewed by pi luna + pi sol; docs proofread by Gemini gemini-3.8-flash-high ## Follow-ups - #188 [v0.1/Protocol] Implement DECCARA / DECRARA rectangular attribute ops - #189 [v0.1/Protocol] Implement in-band resize notify (?2048) ## Deferred - No automated guard for the tracked-issue-per-not-yet-row convention — the issue's own Tests section scopes verification to `just prose-check` and the docs-tree guards; a new documentation test asserting every not-yet row links an issue is hardening beyond the acceptance criteria, not a defect in this diff.
docs: record stances for the three not-yet protocol rows
All checks were successful
darwin / detect relevant changes (pull_request) Successful in 4s
darwin / build felis (aarch64-darwin) (pull_request) Has been skipped
pr / nix flake check (pull_request) Successful in 30s
pr / cargo build / clippy / test / deny (pull_request) Successful in 2m5s
pr / wire schema is compatible with the base (pull_request) Successful in 17s
pr / frontend smoke (x86_64-linux) (pull_request) Successful in 1m9s
pr / publish felis (x86_64-linux) (pull_request) Has been skipped
windows / detect relevant changes (pull_request) Successful in 4s
windows / cargo clippy (Windows cross) (pull_request) Has been skipped
windows / cargo nextest (Windows) (pull_request) Has been skipped
windows / frontend smoke (Windows) (pull_request) Has been skipped
windows / package felis (x86_64-pc-windows-msvc) (pull_request) Has been skipped
darwin / darwin docs-only no-op (pull_request) Successful in 0s
windows / windows docs-only no-op (pull_request) Successful in 0s
3ef617c845
The support matrix carried three ` not yet` rows with no stance anywhere
and no tracking issue, so nothing said whether they were coming or refused.
Before the publish freeze each needs a verdict.

Rectangular attribute ops and `?2048` are adopted: the rectangle bounds
model already serves five sequences, and the resize notify carries the size
in band on the PTY stream, ordered against the input around it, where the
`SIGWINCH` the daemon's resize already raises costs a handler racing that
input and a `TIOCGWINSZ` round-trip. Window-size reporting stays out because
a query any program can pull answers with host pixel extents, where the
notify mode reports the PTY geometry its subscriber already owns and stubs
the pixel axes as `CSI 14 t` does.

XTSMGRAPHICS is refused for the reason Sixel is: it sizes the Sixel and
ReGIS surfaces and color registers felis does not keep. Kitty graphics
offers no numeric substitute, because `a=q` is a capability probe, and it
needs none.

Refs #181
natsukium deleted branch docs/protocol-not-yet-trio-181 2026-09-07 21:07:17 +09:00
Sign in to join this conversation.
No description provided.