Skip to content

Replace custom Lean servers with managed Lean Beam - #76

Closed
Deicyde wants to merge 10 commits into
mainfrom
codex/lean-beam-session-api
Closed

Deicyde wants to merge 10 commits into
mainfrom
codex/lean-beam-session-api

Conversation

@Deicyde

@Deicyde Deicyde commented Oct 3, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • replace Autoform's custom LSP, REPL, shared-runtime, process-pool, and protocol stack with Lean Beam as the single Lean MCP server
  • register the managed lean-beam server directly in Codex, Claude, and Muse plugin manifests
  • automatically fetch and verify the exact lock commit on first start, delegate its build to Beam's installer, store it in commit-addressed Autoform user state, verify live beam_version, and then exec Beam directly
  • add autoform beam doctor, which installs or reuses the managed runtime and emits a stable machine-readable admission report
  • shorten the internal Python package to cli and expose the upstream handoff as cli.beam_launcher, making clear that Autoform launches Beam rather than implementing another server
  • retain only dependencies still used by Autoform itself (mcp, psutil, and Python-3.10 TOML support) and bump the breaking package/plugin version to 0.6.0
  • remove roughly 7,800 lines of custom runtime implementation and tests

One-owner architecture

Autoform no longer proxies Lean LSP, parses REPL output, or maintains a second process pool. Beam owns Lean processes, workspace generations, opaque source snapshots, and proof handles. Autoform owns only:

  • exact source/version policy in lean-beam.lock.json
  • serialized first-start installation into $XDG_DATA_HOME/autoform/lean-beam/<commit>
  • bounded process-tree cleanup for Git, installer, and Lake subprocesses
  • live public-MCP identity admission before server handoff
  • plugin registration and host policy

The launcher does not proxy Lean operations or use Beam's private broker protocol.

Safety boundary

Validation

  • launcher/package/scaffold focused suite: 77 passed; broader local suite reached 837 passed and 2 skipped before its resource-starved Lean tail was stopped
  • local first-start installation completed and both autoform beam doctor --json and the registered Autoform MCP launcher returned the exact 0.2.0-beta / d5dc8fe identity
  • Ruff, lock check, diff check, bundled example render, and strict MkDocs build: passed
  • Setup, Roadmap, Human Review, and Develop Plugin skills pass skill-creator validation
  • GitHub CI: Python 3.10/3.13, Windows hardening, both real-Lean runs, CLA, and the eight Linux/macOS Beam matrix jobs pass on commit f8745807

Draft experimental evaluation only; do not merge as Autoform's default runtime while Lean Beam remains beta, the pin comes from draft upstream PR #254, and the known save/external-build issues remain open.

@Deicyde Deicyde added the awaiting author Review is complete and author action is required label Oct 3, 2026
@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Oct 3, 2026
@Deicyde Deicyde changed the title Replace custom Lean servers with Lean Beam Add an opt-in Lean Beam session preview Oct 5, 2026
@Deicyde
Deicyde marked this pull request as ready for review October 5, 2026 00:43
@Deicyde
Deicyde marked this pull request as draft October 5, 2026 00:47
@Deicyde Deicyde changed the title Add an opt-in Lean Beam session preview Integrate an automatically managed Lean Beam server Oct 5, 2026
@Deicyde
Deicyde marked this pull request as ready for review October 5, 2026 01:59
@Deicyde Deicyde changed the title Integrate an automatically managed Lean Beam server Replace custom Lean servers with managed Lean Beam Oct 5, 2026
@Deicyde

Deicyde commented Oct 5, 2026

Copy link
Copy Markdown
Contributor Author

The full Beam replacement is paused as an experimental draft. The custom-server recovery work is reinstated in #101 (REPL safety), #102 (LSP/shared runtime), #103 (import resolver), and #104 (structured import execution).

@Deicyde

Deicyde commented Oct 5, 2026

Copy link
Copy Markdown
Contributor Author

REPL recovery update: broad draft #101 was split and closed. The scoped replacement stack is #105 -> #106 -> #107; none carries the old shared LSP/runtime rewrite.

@Deicyde Deicyde closed this Oct 5, 2026
@Deicyde
Deicyde deleted the codex/lean-beam-session-api branch October 13, 2026 20:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

awaiting author Review is complete and author action is required CLA Signed This label is managed by the Meta Open Source bot.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant