Skip to content

Propose append-only typed output API - #54

Draft
zikolach wants to merge 2 commits into
mainfrom
docs/append-only-output-api
Draft

Propose append-only typed output API#54
zikolach wants to merge 2 commits into
mainfrom
docs/append-only-output-api

Conversation

@zikolach

@zikolach zikolach commented Jul 28, 2026

Copy link
Copy Markdown
Owner

Summary

  • propose a callback-completed, TUI-owned append operation for typed normal-screen scrollback output
  • preserve the existing non-waiting contended/reentrant flushRender() contract
  • require a running normal-screen TUI with NormalResizeClearPolicy.PreserveScrollback and a committed live frame
  • render detached one-shot components with a restricted context and retry only unpublished resize-invalidated candidates
  • reject cursor and cleanup authority, remap Kitty IDs, and bound append ownership to a 4096-ID redacted ledger
  • serialize append output with existing runtime work, redraw the retained frame, and restore hardware cursor and mouse frame origin
  • separate automated protocol/PTY guarantees from manual Kitty and iTerm2 emulator persistence checks

OpenSpec

  • change: add-append-only-output-api
  • proposal, design, specification, and 32 implementation tasks are complete
  • implementation is intentionally deferred pending proposal review

Validation

  • openspec validate --all --strict — 14 passed, 0 failed
  • git diff --check
  • confirmed the change artifacts contain no Sigma references

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant