feat(stats): expose connected client geometry

[schickling-assistant]

Why

pty stats --json and queryStats() already expose the effective terminal geometry and aggregate client counts through a non-attaching STATUS request. They do not explain which connected clients requested that geometry or which client currently determines each min-wins axis.

Relates to #134. This improves point-in-time observability; it does not solve the ordered geometry-before-DATA requirement described there.

What

• Add anonymous clients.connections details while preserving all existing stats fields and semantics.
• Report each writable client's requested rows and columns, its daemon-local last request sequence, and independent row/column constraint flags.
• Distinguish readonly clients without assigning a fabricated identity or exposing socket/parser internals.
• Re-negotiate when an attached client switches to PEEK, so its former size constraint is actually released.
• Document the current-versus-new contract and its point-in-time limitation.

How

The server projects the client state it already retains for size negotiation into the STATUS response. Query connections that have not attached remain excluded, matching the existing aggregate counts. Constraint flags compare each writable request with the current effective terminal dimensions, so tied minima are represented correctly.

Attach and resize arbitration remains min-wins. The only negotiation behavior change is the public-protocol ATTACH -> PEEK transition: becoming readonly now relinquishes that connection's requested geometry and notifies remaining clients if the effective size changes.

Validation

Current head: 2bc1f63

• CI=1 npm run typecheck
• CI=1 npm run build
• CI=1 npm test -- tests/protocol.test.ts tests/integration.test.ts -t 'STATUS|reports anonymous client geometry|old-daemon|relinquishes' (15 passed)

Posted on behalf of @schickling

field	value
agent_name	co1-sage
agent_session_id	ed878dac-3735-4276-b3e0-ea1b1cd65291
agent_tool	Codex CLI
agent_tool_version	0.145.0
agent_runtime	Codex CLI 0.145.0
agent_model	unknown
runtime_profile	/nix/store/mnx8agbdq3wiyb6vz63lhgscgazkrn98-coding-agent-runtime-profile/share/coding-agents/profile.json
skills_manifest	/nix/store/5r69m9k2llmri3na81518zx0a7y0d3cn-agent-skills-corpus/share/agent-skills/manifest.json
worktree	pty/schickling-assistant/2026-07-31-stats-client-introspection
machine	dev3
tooling_profile	dotfiles@0fb7e03

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 64edbe21be

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[schickling-assistant]

@codex review

Posted on behalf of @schickling

field	value
agent_name	co1-sage
agent_session_id	ed878dac-3735-4276-b3e0-ea1b1cd65291
agent_tool	Codex CLI
agent_tool_version	0.145.0
agent_runtime	Codex CLI 0.145.0
agent_model	unknown
runtime_profile	/nix/store/mnx8agbdq3wiyb6vz63lhgscgazkrn98-coding-agent-runtime-profile/share/coding-agents/profile.json
skills_manifest	/nix/store/5r69m9k2llmri3na81518zx0a7y0d3cn-agent-skills-corpus/share/agent-skills/manifest.json
worktree	dotfiles/schickling/2026-07-20-cos-misc
machine	dev3
tooling_profile	dotfiles@0fb7e03

[chatgpt-codex-connector]

To use Codex here, create a Codex account and connect to github.

[schickling]

@codex

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e5a2686892

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[schickling-assistant]

Thank you, Nathan — especially for tightening the PEEK semantics and polishing the contract before merge. This gives Fractal both the ordered geometry primitive and the non-attaching client introspection we needed.

Posted on behalf of @schickling

field	value
agent_name	co1-sage
agent_session_id	ed878dac-3735-4276-b3e0-ea1b1cd65291
agent_tool	Codex CLI
agent_tool_version	0.145.0
agent_runtime	Codex CLI 0.145.0
agent_model	unknown
runtime_profile	/nix/store/mnx8agbdq3wiyb6vz63lhgscgazkrn98-coding-agent-runtime-profile/share/coding-agents/profile.json
skills_manifest	/nix/store/5r69m9k2llmri3na81518zx0a7y0d3cn-agent-skills-corpus/share/agent-skills/manifest.json
worktree	pty/schickling-assistant/2026-07-31-stats-client-introspection
machine	dev3
tooling_profile	dotfiles@0fb7e03