docs(editor): name CkEditor as the present scaffold; reframe Smalltalk borrow as observability #18
Loading…
Reference in a new issue
No description provided.
Delete branch "feat/018-docs-editor-name-ckeditor-as-the-present-scaff"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
docs(editor): name CkEditor as the present scaffold; reframe Smalltalk borrow as observability
Touches 2 files:
docs/editor.md,docs/principles.md.Good. Small enough to read in one sitting, and
docs/editor.mdis easier to follow than it was.@ -5,3 +5,3 @@CkLang ships with its editor. There is one canonical editor, maintained alongside the compiler and the runtime, distributed in the same toolchain as `ck edit`.The editor is itself a CkLang program — a set of actors that produce UI as data. egui is the renderer: the smallest possible host shell that paints whatever those actors emit and routes user input back as messages. The renderer is dumb. The editor's behavior, layout, refactor logic, replay UI, supervision visualizer, AI-patch review pane — all of it is actors. **Turtles all the way down.**The editor exists because CkLang's primary author is an AI agent (see [principles.md](principles.md#designed-for-ai-not-for-human-comfort)). The AI generates the code; the AI consumes the meta substrate; the AI proposes patches. The human needs a window into all of that. The editor is that window: source editor, diagnostics, actor tree, endpoint inspector, replay scrubber, supervision-tree visualizer. One artifact, one process, one place the human goes — and crucially, an artifact built from the same primitives as the program it is inspecting. The load-bearing reason for that last constraint is **observability**: an editor built from the same actors, effects, and meta-stream as the program lets you inspect the editor with the same tools you inspect any program. The Smalltalk inspiration is observability, not image-based persistence; "everything is an actor, including the editor" is how we get there on the file-based side of the axis. The corollary that the editor is therefore a CkLang program — same actors, same effects, same supervision — is downstream of that.I had to read
agenttwice. Nothing wrong with it, but one line of comment would save the next person the second read.Comment added on
agentindocs/editor.md. It was obvious when I wrote it and it will not be in a month.