Skip to content

Add wet-glue to CLI section - #1316

Open
Noob-stupid wants to merge 1 commit into
akullpp:mainfrom
Noob-stupid:main
Open

Add wet-glue to CLI section#1316
Noob-stupid wants to merge 1 commit into
akullpp:mainfrom
Noob-stupid:main

Conversation

@Noob-stupid

@Noob-stupid Noob-stupid commented Sep 9, 2026

Copy link
Copy Markdown

Adding wet-glue under CLI.

What it does: two comment lines (// glue:begin / // glue:end) mark a code region you're undecided about — for example a lookup that might be a red-black tree or a B+ tree. You register alternative implementations, swap between them (source-level text replacement, no runtime indirection), run your own benchmark via glue verify, and finally glue seal the winner, which removes the markers and welds it as plain code.

Why it fits the criteria:

  • Java primary target — implemented in Java 17 and operates on Java source; also works on C#/Kotlin/Go/TS and any //-comment language.
  • Unique niche — as far as I know nothing else models a lifecycle for experimental code regions: experimental → candidate → sealed (↔ unseal), with an audit log (swappable.lock) and "is the glue drying" nudges.
  • Zero runtime overhead — swapping happens at edit time; sealed code is plain code, strictly equivalent to handwritten.
  • English docs + MIT license — both present.

Validation on real code: the tool was exercised end-to-end on NanoHTTPD (5k+ stars) — registering a thread-pool candidate against the classic thread-per-connection model and benchmarking both; case study.

This is self-promotion (I'm the author); disclosing that up front. Happy to adjust wording or placement to match house style.


Summary by cubic

Adds wet-glue to the CLI section of the README. It lets developers mark undecided code regions with // glue:begin/// glue:end, swap in alternative implementations, benchmark them, and seal the winner as plain code. Note: this is the author's own project.

Written for commit 3fe262e. Summary will update on new commits.

Review in cubic

Manages undecided code with two comment lines: mark a region,
swap alternative implementations in, benchmark them and seal the
winner as plain code. Fills a niche (lifecycle for experimental
code regions) with zero runtime overhead.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No issues found across 1 file

Re-trigger cubic

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