jpmschweitzer/clide
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

fix onboarding docs to match current architecture (T-101)

Browse Source 
Rewrite README's Architecture section: drop the `ptyc/` description
and `make ptyc-build` line, fix the broken `decisions/` link
(governance moved it), add pointers to current docs.

Banner docs/initial-plan.md as historical with a redirect to a new
docs/architecture.md that describes today's shape (single Flutter
package at the repo root; in-process IPC + dispatcher + subsystems;
PTY via Dart FFI posix_openpt + posix_spawn).

Also banner two ptyc-era forensic notes (docs/pty-proposition.md,
docs/macos-pty-problem.md) as historical so a contributor reading
them isn't misled into thinking the C helper still exists.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
jpmschweitzer
2026-05-17 21:01:43 +02:00
co-authored by Claude Opus 4.7
parent 70ce6c270e
commit dd3b38ba85
7 changed files with 195 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/pty-proposition.md
+7
View File
@@ -1,5 +1,12 @@
# PTY on macOS: A New Diagnostic and Resolution Plan
> **⚠ HISTORICAL — `ptyc` is retired.** PTY spawning moved to
> Dart FFI `posix_openpt()` + `posix_spawn()` (D-5 amendments,
> T-96). This document captures the forensic investigation of the
> SCM_RIGHTS control-message mismatch in the old C helper. Kept for
> the diagnostic technique; the code it discusses no longer exists.
## 1. Executive Summary
Previous attempts to fix the PTY functionality on macOS have failed, even after correcting a deadlock in the Dart code. The core of the problem appears to be a fundamental mismatch in how the C helper (`ptyc`) constructs a control message and how the Dart FFI layer is trying to parse it.