Skip to content

Docs(fix): Complete wrapper first-use examples - #43

Draft
tony wants to merge 1 commit into
masterfrom
wrapper-first-use
Draft

tony wants to merge 1 commit into
masterfrom
wrapper-first-use

Conversation

@tony

@tony tony commented Sep 29, 2026

Copy link
Copy Markdown
Contributor

Kotlin and Scala first-use examples currently depend on configuration supplied by the documentation harness, and Scala install blocks contain a literal <version>. Readers can now copy complete build files and programs that select a private socket, create tmux objects, and stop their owned server.

The documentation tests compile and invoke those entry points without lending them imports or fixture variables. Scala install examples use the released 0.0.1-alpha.17, and the install gate rejects placeholder versions. The Kotlin guide explains the public DSL without draft-history or contributor-only narrative; its previous heading anchor is preserved.

Validation

  • ./gradlew :libtmux-mcp:test check --no-daemon --max-workers=2 --no-build-cache passed in 2m 52s with JDK 25, tmux 3.7c, and Bash startup files disabled. Kotlin: 62 tests; docs: 142 tests; MCP: 384 tests, one existing skip.
  • Complete programs copied verbatim into separate Gradle and sbt consumer projects ran against Maven Central 0.0.1-alpha.17 on tmux 3.2a and 3.7c.
  • Removing the Kotlin coroutine import or Scala configuration binding fails compilation. Wrong runtime assertions in either program and a restored <version> each fail the relevant test. Original source bytes were restored afterward.
  • Independent review found no remaining issues after the complete-program isolation fix.

The account's normal Bash startup reproduces an existing MCP pending-input assertion failure; /bin/sh exposes two CLI launcher assertions. All three pass together with bash --noprofile --norc, which is also the environment used for the successful full check. No product code or test assertions were changed to address those environment failures.

Give Kotlin and Scala readers complete build files and programs with explicit configuration, private tmux servers, and cleanup. Compile and invoke the documented main functions without fixture imports or variables, and reject placeholder Scala install versions.

Verified the required full check on JDK 25 and tmux 3.7c with Bash startup files disabled. Published alpha.17 consumer programs also pass on tmux 3.2a and 3.7c; deliberate import, configuration, assertion, and version defects fail the documentation gates.

This branch has not been deployed

No deployments
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