Skip to content

feat(scripts[erlang]) Read native tmux command sites - #280

Closed
tony wants to merge 2 commits into
erlang-signature-linksfrom
erlang-source-usage
Closed

tony wants to merge 2 commits into
erlang-signature-linksfrom
erlang-source-usage

Conversation

@tony

@tony tony commented Nov 8, 2026 •

Copy link
Copy Markdown
Contributor

Summary

The shared tmux usage generator needs an Erlang reader before the port can register. Read written command sites with OTP 29 literal decoding, native module and arity identities, static imports, and exact source citations.

Computed command values, deferred function bodies, diagnostic labels and uncertain scope flags do not establish sends. Operators in an unrelated options argument do not hide a literal command. Dispatcher definitions require native function heads; transport evidence requires an eager executable-port BIF with a literal spawn mode. Strings that resemble process calls, foreign receivers and visible local shadows cannot establish transport provenance.

This reads written modules without preprocessing or variable dataflow. Unsupported declaration identities fail explicitly. The pinned transport is self-contained; included or transformed definitions need separate provenance. Port registration, reviewed usage data and publication remain separate work. Depends on #279 for extraction and native signatures. MCP remains excluded.

Test plan

  • Native reader, dispatcher and shared derivation regressions
  • Script lint and whitespace checks
  • Initial native corpus comparison; failure receipts retained
  • Current exact-head site type checks
  • Shared medium and outer loop budgets
  • Hosted checks

Independent caller and systems reviews accept the six-file correction. The combined reader, derivation and rendered-usage command passed 288 tests in 11.176 seconds; that run included the separate registration working tree, so it does not establish exact-head site qualification for this PR. Scoped lint passed in 0.158 seconds.

The prior shared medium and outer loops failed their time caps (10.624 and 60.790 seconds). Those failures remain unwaived; the timing decision is tracked in #271. Hosted qualification is still unverified. This PR must not merge on these bounded passes alone.

why: Erlang registration needs source-backed command attribution;
empty or guessed usage would hide missing sends and invent scope links.

what:
- Decode OTP 29 literals and canonical atom names with erl_scan
- Resolve module, arity and static imports with precise call citations
- Exclude deferred or computed sends and uncertain argv scope flags
- Reject unsupported declarations and cover native source regressions
@tony
tony marked this pull request as ready for review November 8, 2026 11:53
why: Command-looking strings and unrelated calls must not establish
tmux execution or source citations.

what:
- Bind declared dispatchers to native module, arity and definition heads
- Require an eager executable-port BIF with a literal spawn mode
- Resolve exact call names, receivers and lines when deriving and auditing
- Keep computed options separate from the command argument
@tony tony mentioned this pull request Nov 8, 2026
3 of 5 tasks
tony added a commit that referenced this pull request Nov 9, 2026
why: Erlang's stack continues past #280; its application manifest reader is part of the release.

what: Merge #284 at 1d66f52, keeping the Perl, OCaml, Haskell and Lisp readers beside Erlang's.
tony added a commit that referenced this pull request Nov 9, 2026
…ts (#291)

why: Six ports had docs branches ready but no published site, and
three shared fixes were waiting behind them. Releasing them together
gives one docs commit to trust for deployment and one set of caller
pins to move, instead of six separate waves.

what:
- Add OCaml (#264), Haskell (#265), Erlang (#266, #278, #279, #280,
  #284, #292), Common Lisp (#268), Perl (#274) and Clojure (#276):
  native API pages, tested guides, navigation, landing and switcher
  entries, and cross-reference data for each
- Keep browser checks from loading third-party resources, and pass
  the check origin to the three scripts that named an undefined base
  (#287)
- Render guide badges at build time instead of hotlinking shields
  (#288)
- Size the reference sidebar and member bars from the viewport, so
  the Chrome iOS keyboard no longer shrinks them (#290)
- Make the OCaml model producer verify its native build inputs in
  their checkout and reject stale ones, with controls run in CI
- Offer one switcher page per port, and title Perl's workspace guide
  "Workspace guide"
- Regenerate the registry, mention index and cross-reference counts
  for the combined port set

Base main 2593131, head dabe59b. Port heads: #264 7d4f88f
and 73fb1ad, #265 dc024e3, #268 947da1f, #274 818fa2e,
#276 a134503, #287 a437e97, #292 e7740d9.
@tony

tony commented Nov 12, 2026

Copy link
Copy Markdown
Contributor Author

Shipped in #291 (8245169, 2026-11-09 07:38 CST), the combined release: this PR's head 6783ca2bf is listed there and is an ancestor of main (cfa8a14), so the Erlang command-site reader for the shared tmux usage generator is on main. The exact-head site type checks and the shared loop budgets listed in the description stay tracked in #271. Closing, since nothing in this branch is missing from main.

@tony tony closed this Nov 12, 2026
@tony
tony temporarily deployed to docs-preview-cleanup November 12, 2026 01:53 — with GitHub Actions Inactive

This branch was previously deployed

2 inactive deployments
docs-preview-cleanup — 6783ca2b Deployed Nov 12, 2026 by tony via cleanup #240
docs-preview — 6783ca2b Deployed Nov 8, 2026 by tony via publish-preview / publish #1284
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