Thales Maciel
788fc4fad4
Extend the chat-ergonomics roadmap with the remaining UX work highlighted by the readiness review. Document a second pass focused on removing shell glue from canonical CLI handoff flows, making the recommended chat-host profile more obvious without changing 3.x compatibility defaults, and polishing human-mode content reads for cleaner transcripts and copy-paste behavior. Keep these milestones explicitly workspace-first and scoped to product UX, with CLI-only shortcuts allowed where the SDK and MCP surfaces already provide the structured behavior natively.
50 lines
1.5 KiB
Markdown
50 lines
1.5 KiB
Markdown
# `3.9.0` Content-Only Reads And Human Output Polish
|
|
|
|
Status: Planned
|
|
|
|
## Goal
|
|
|
|
Make human-mode content reads cleaner for chat logs, terminal transcripts, and
|
|
copy-paste workflows.
|
|
|
|
## Public API Changes
|
|
|
|
Planned additions:
|
|
|
|
- `pyro workspace file read WORKSPACE_ID PATH --content-only`
|
|
- `pyro workspace disk read WORKSPACE_ID PATH --content-only`
|
|
|
|
Behavioral polish:
|
|
|
|
- default human-mode `workspace file read` and `workspace disk read` should
|
|
always separate content from summaries cleanly, even when the file lacks a
|
|
trailing newline
|
|
|
|
## Implementation Boundaries
|
|
|
|
- keep JSON output unchanged
|
|
- keep human-readable summary lines by default
|
|
- `--content-only` should print only the file content and no summary footer
|
|
- keep current regular-file-only constraints for live and stopped-disk reads
|
|
|
|
## Non-Goals
|
|
|
|
- no new binary dumping contract
|
|
- no removal of human summaries from the default read path
|
|
- no expansion into a generic pager or TUI reader
|
|
- no change to SDK or MCP structured read results, which are already summary-free
|
|
|
|
## Acceptance Scenarios
|
|
|
|
- reading a text file with no trailing newline still produces a clean transcript
|
|
- a user can explicitly request content-only output for copy-paste or shell
|
|
piping
|
|
- docs can show both summary mode and content-only mode without caveats about
|
|
messy output joining
|
|
|
|
## Required Repo Updates
|
|
|
|
- CLI help text updated for file and disk read commands
|
|
- stable docs and transcripts revised to use `--content-only` where it improves
|
|
readability
|
|
- tests that cover missing trailing newline cases in human mode
|