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

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:
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
+19
View File
@@ -1,5 +1,24 @@
# Clide — Initial Plan (Flutter rebuild)
> **⚠ HISTORICAL — preserved as a snapshot of the 2026-04 plan.**
>
> Several load-bearing choices in this document have since been
> superseded by formal decisions:
>
> - **No Go sidecar.** Dart is the sole core language (D-5).
> - **No separate daemon process.** The Flutter app hosts the IPC
> server in-process (D-56).
> - **No `ptyc/` C helper.** PTY spawning uses Dart FFI
> `posix_openpt()` + `posix_spawn()` (D-5 amendments, T-96).
> - **Single package at the repo root**, not `app/` + `lib/` + `bin/`.
> - **No `project.yaml`.** Project metadata lives in `pubspec.yaml`.
>
> For the current architecture, see [`docs/architecture.md`](architecture.md).
> For the decision trail, see [`governance/decisions/`](../governance/decisions/).
> The text below is left intact for anyone tracing the design history.
---
**Working name:** clide (unchanged from the Python era). Repo root:
`/var/mnt/data/projects/clide`. Flutter desktop app + Go sidecar/CLI.