[PR #1465] [MERGED] docs(process): clarify normalized terminal line representation #2904

New issue

Closed

opened 2026-10-17 21:11:37 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-17 21:11:37 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/morluto/rea/pull/1465
Author: @N0zoM1z0
Created: 10/10/2026
Status: ✅ Merged
Merged: 10/10/2026
Merged by: @N0zoM1z0

Base: main ← Head: docs/process-rendered-line-normalization

📝 Commits (1)

bab6354 docs(process): clarify normalized terminal line representation

📊 Changes

1 file changed (+8 additions, -5 deletions)

View changed files

📝 docs/process-capture.md (+8 -5)

📄 Description

The process-capture guide treated terminal cell width as the length of a normalized string and promised restoration by padding to columns. It also described normalized serialization as exact terminal state. Define the trimmed normalized rows, terminal cell width and normalized serialization accurately, and point readers to the retained original PTY chunks.

Verified with an actual 55-byte Linux CLI/MCP PTY target: expanding a normalization replacement produces a 93-character old row, a 15-character trimmed row and an 80-column terminal. A production renderer control also demonstrates the difference for combining Unicode. Both preserve serialized content; real capture verifies raw PTY content, source digest, text/structured parity, ping and owned cleanup.

Validation: all five renderer/process-boundary tests, complete generated-document checks via the serial docs:check:built path, and formatting pass under the documented resource guard. The reproduction and related format optimization are recorded in #1464 and #1450.

Closes #1464. Refs #1450, #1065, #723.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/morluto/rea/pull/1465 **Author:** [@N0zoM1z0](https://github.com/N0zoM1z0) **Created:** 10/10/2026 **Status:** ✅ Merged **Merged:** 10/10/2026 **Merged by:** [@N0zoM1z0](https://github.com/N0zoM1z0) **Base:** `main` ← **Head:** `docs/process-rendered-line-normalization` --- ### 📝 Commits (1) - [`bab6354`](https://github.com/morluto/rea/commit/bab6354a201f7cb1091e079a00f3a1bf3bc2df01) docs(process): clarify normalized terminal line representation ### 📊 Changes **1 file changed** (+8 additions, -5 deletions) <details> <summary>View changed files</summary> 📝 `docs/process-capture.md` (+8 -5) </details> ### 📄 Description The process-capture guide treated terminal cell width as the length of a normalized string and promised restoration by padding to `columns`. It also described normalized serialization as exact terminal state. Define the trimmed normalized rows, terminal cell width and normalized serialization accurately, and point readers to the retained original PTY chunks. Verified with an actual 55-byte Linux CLI/MCP PTY target: expanding a normalization replacement produces a 93-character old row, a 15-character trimmed row and an 80-column terminal. A production renderer control also demonstrates the difference for combining Unicode. Both preserve serialized content; real capture verifies raw PTY content, source digest, text/structured parity, ping and owned cleanup. Validation: all five renderer/process-boundary tests, complete generated-document checks via the serial `docs:check:built` path, and formatting pass under the documented resource guard. The reproduction and related format optimization are recorded in #1464 and #1450. Closes #1464. Refs #1450, #1065, #723. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-17 21:11:37 +00:00