Skip to content

docs: correct README to JIT render path and simplify#240

Open
obj-p wants to merge 1 commit into
mainfrom
docs/readme-jit-drift-and-simplify
Open

docs: correct README to JIT render path and simplify#240
obj-p wants to merge 1 commit into
mainfrom
docs/readme-jit-drift-and-simplify

Conversation

@obj-p

@obj-p obj-p commented Jun 21, 2026

Copy link
Copy Markdown
Owner

What

The README still described the retired dylib preview path and had drifted build instructions. It also carried some redundant/over-long prose. This is a docs-only change.

Drift fixes

  • Rendering is JIT, not dylib. The "Why PreviewsMCP?" description now says PreviewsMCP JIT-compiles and links the #Preview closure into the host process. Package.swift confirms the dylib path was retired.
  • Quickstart and From-source now build the LLVM JIT artifacts first. Package.swift fails fast at manifest evaluation unless scripts/build-jit-llvm.sh and scripts/build-jit-llvm-iossim.sh have run, so a clean swift run / swift build was broken as documented.
  • Requirements note the cmake + ninja source-build dependency, and Quickstart points at Homebrew as the no-setup path.

Simplifications

  • Tightened the micro-apps pitch.
  • Deduped the daemon auto-start explanation into the single Daemon model section.
  • Cut the --json example block from seven lines to two.
  • Trimmed the dense Debugging prose.

Verification

Docs-only. Verified scripts/build-jit-llvm*.sh exist, the #daemon-model anchor resolves, and no dylib wording remains in the README.

🤖 Generated with Claude Code

The dylib preview path was retired; rendering now goes through the LLVM
ORC JIT executor. Update the "Why" description accordingly and add the
mandatory build-jit-llvm prebuild step to Quickstart and From-source,
since Package.swift now fails fast without the artifacts. Note the
cmake/ninja requirement and point users at Homebrew for a no-setup path.

Also simplify drifted prose: tighten the micro-apps pitch, dedupe the
daemon explanation into the Daemon model section, cut the --json example
block, and trim the Debugging section.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@obj-p obj-p force-pushed the docs/readme-jit-drift-and-simplify branch from fcea340 to 0260838 Compare June 21, 2026 01:32
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