René's URL Explorer Experiment


Title: Design: globally unique local names (GUC) in the IR pipeline · Issue #139 · purescript-lua/purescript-lua · GitHub

Open Graph Title: Design: globally unique local names (GUC) in the IR pipeline · Issue #139 · purescript-lua/purescript-lua

X Title: Design: globally unique local names (GUC) in the IR pipeline · Issue #139 · purescript-lua/purescript-lua

Description: The IR currently represents locals as name plus per-name De Bruijn index (Ref (Local x) i counts enclosing x binders, Dhall-style), and capture avoidance is index arithmetic: substitute shifts the replacement under same-name binders, pas...

Open Graph Description: The IR currently represents locals as name plus per-name De Bruijn index (Ref (Local x) i counts enclosing x binders, Dhall-style), and capture avoidance is index arithmetic: substitute shifts the ...

X Description: The IR currently represents locals as name plus per-name De Bruijn index (Ref (Local x) i counts enclosing x binders, Dhall-style), and capture avoidance is index arithmetic: substitute shifts the ...

Opengraph URL: https://github.com/purescript-lua/purescript-lua/issues/139

X: @github

direct link

Domain: github.com


Hey, it has json ld scripts:
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Design: globally unique local names (GUC) in the IR pipeline","articleBody":"The IR currently represents locals as name plus per-name De Bruijn index (`Ref (Local x) i` counts enclosing `x` binders, Dhall-style), and capture avoidance is index arithmetic: `substitute` shifts the replacement under same-name binders, passes that drop binders must `unshift`, and every traversal reimplements the sequential `Let` scoping convention. The scheme is sound on paper, but its invariant is distributed across every pass, and the bug record shows what that costs: #37 (three walkers with the convention inverted), #56 (missing `unshift` in beta reduction), #133 (renameShadowedNames wrong scope in recursive groups), #134 (DCE: reversed body scope, missing `unshift`). Six independent bugs, one root. Because shifts are only needed under shadowing, these bugs are silent until a shadowed name reaches the pass, which is the worst failure mode available.\n\nThis issue proposes switching the pipeline to a global uniqueness condition (GUC), the discipline used by the Plutus compiler: make all local binders unique once, up front, and keep them unique, so that every downstream pass can treat names naively. The alternatives considered and rejected, briefly: pure De Bruijn everywhere trades readability of goldens and cheap subtree motion for canonical alpha-equivalence, which fits evaluators and wire formats (UPLC) but not a rewriting optimizer, since every structural edit becomes index migration; GHC's rapier (per-pass substitution plus in-scope set, no global invariant) is the strongest option at GHC's scale but its costs land exactly where pslua is weakest, since a forgotten in-scope-set extension fails silently and the machinery is the trickiest in this design space, while its payoff (no whole-program rename between simplifier iterations) is worthless for programs of pslua's size; locally nameless was tried in this codebase's history and rejected for the monadic boilerplate it spread. GUC with a mechanical linter keeps failures loud, which is the property that matters most for a single-maintainer project whose main safety net is golden tests.\n\n## Target invariants\n\nAfter the entry rename pass and until codegen: all local binders are unique within a top-level binding, every local `Ref` has index 0, and every pass declares whether it requires and preserves these invariants (via the `Pass` contract from #138). The linter checks the declarations after every pass in the test harness.\n\n## Plan\n\nPrerequisites, tracked separately: #138 (Pass values, linter, deterministic `SupplyM`) and the #133/#134 fixes. `renameShadowedNames` becomes the load-bearing entry pass, so its recursive-group defects must be fixed before the move.\n\nThe switch:\n\n- `uniquifyNames` runs as the first IR pass after linking (the fixed `renameShadowedNamesInExpr`, moved from the end of the pipeline to the start). Establishes `UniqueBinders` and `IndicesZero`, which are added to the `Invariant` vocabulary.\n- The inliner, the only pass that duplicates terms, re-uniquifies every inserted copy through the supply. A forgotten freshening turns the linter red on the first test.\n- Index bookkeeping is dismantled: `substitute` drops its shift logic (asserting no shadowing instead), `unshift` becomes unnecessary (the #37/#56/#134 bug class dies by construction), DCE resolves references by name without scope maps, the final `renameShadowedNames` pass is deleted, and `UnexpectedRefBound` in codegen becomes a pure internal-invariant error. The `Index` field stays in the IR type for now with a linted always-zero invariant; physically removing it is a separate decision.\n- Equality-based rules need care: after uniquification, alpha-equivalent branches stop being structurally equal, so `removeIfWithEqualBranches` would silently stop firing. Add an `alphaEq` comparison and audit other `Eq`-on-terms sites.\n- Expect one large structural golden churn when uniquification lands (accepted via `PSLUA_GOLDEN_ACCEPT`); eval goldens must pass unchanged, as the semantic net.\n\nDividends once the switch is in: the float-in pass (#136) is written as an ordinary `Pass` requiring `UniqueBinders`, with no index surgery; the usage-count inefficiencies in `optimizeModule` become straightforward to fix incrementally.\n\nThe rapier remains documented as a possible future migration if compile times ever become a problem: the GUC architecture is a subset of it, so nothing here paints us into a corner.\n\nPrerequisite of: #136. Depends on: #138, #133, #134. Origin: the 2026-07-02 backend audit and a follow-up design discussion of naming strategies (named + alpha-renaming, Barendregt, pure and per-name De Bruijn, locally nameless, GHC's rapier, Plutus GUC).\n","author":{"url":"https://github.com/Unisay","@type":"Person","name":"Unisay"},"datePublished":"2026-07-02T18:10:03Z","url":"https://github.com/purescript-lua/purescript-lua/issues/139"}

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322
route-pattern/_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format)
route-controllervoltron_issues_fragments
route-actionissue_layout
fetch-noncev2:10e239cd-ff2a-624b-6b7a-6f7b55ffb0b4
current-catalog-service-hash81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114
request-idC808:E3C4F:B155C1:E3446D:6B00F9A6
html-safe-nonce42fbc7e2d2318ec1b05af5df9440f86077925872ee879135da0b471668321f82
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDODA4OkUzQzRGOkIxNTVDMTpFMzQ0NkQ6NkIwMEY5QTYiLCJ2aXNpdG9yX2lkIjoiODYxMTgxOTIwMDIyMDAzNTQ5NCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9
visitor-hmac8dd20037a4c3b5a4bf60d56d2f84dcd1eaafe3bcb97145629ca0c26d8cb388c2
hovercard-subject-tagissue:4797081777
github-keyboard-shortcutsrepository,issues,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///voltron/issues_fragments/issue_layout
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/purescript-lua/purescript-lua/139/issue_layout
twitter:imagehttps://opengraph.githubassets.com/967652f9249098740fccd5d5ffb67dae01387b35d29db20d92dee233106c0190/purescript-lua/purescript-lua/issues/139
twitter:cardsummary_large_image
og:imagehttps://opengraph.githubassets.com/967652f9249098740fccd5d5ffb67dae01387b35d29db20d92dee233106c0190/purescript-lua/purescript-lua/issues/139
og:image:altThe IR currently represents locals as name plus per-name De Bruijn index (Ref (Local x) i counts enclosing x binders, Dhall-style), and capture avoidance is index arithmetic: substitute shifts the ...
og:image:width1200
og:image:height600
og:site_nameGitHub
og:typeobject
og:author:usernameUnisay
hostnamegithub.com
expected-hostnamegithub.com
Nonee208d86428ec00a57ade75058166297440e8128a01e5287c31a53dc042bbf187
turbo-cache-controlno-preview
go-importgithub.com/purescript-lua/purescript-lua git https://github.com/purescript-lua/purescript-lua.git
octolytics-dimension-user_id131581790
octolytics-dimension-user_loginpurescript-lua
octolytics-dimension-repository_id587200487
octolytics-dimension-repository_nwopurescript-lua/purescript-lua
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id587200487
octolytics-dimension-repository_network_root_nwopurescript-lua/purescript-lua
turbo-body-classeslogged-out env-production page-responsive
disable-turbofalse
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
release7dafd017fb7809a839c443dba08622af38e63c09
ui-targetfull
theme-color#1e2327
color-schemelight dark
react-app-nameissues

Links:

Skip to contenthttps://github.com/purescript-lua/purescript-lua/issues/139#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpurescript-lua%2Fpurescript-lua%2Fissues%2F139
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fpurescript-lua%2Fpurescript-lua%2Fissues%2F139
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fvoltron%2Fissues_fragments%2Fissue_layout&source=header-repo&source_repo=purescript-lua%2Fpurescript-lua
Reloadhttps://github.com/purescript-lua/purescript-lua/issues/139
Reloadhttps://github.com/purescript-lua/purescript-lua/issues/139
Reloadhttps://github.com/purescript-lua/purescript-lua/issues/139
purescript-luahttps://github.com/purescript-lua
purescript-luahttps://github.com/purescript-lua/purescript-lua
Codehttps://github.com/purescript-lua/purescript-lua
Issues48 (48)https://github.com/purescript-lua/purescript-lua/issues
Pull requestshttps://github.com/purescript-lua/purescript-lua/pulls
Discussionshttps://github.com/purescript-lua/purescript-lua/discussions
Actionshttps://github.com/purescript-lua/purescript-lua/actions
Projectshttps://github.com/purescript-lua/purescript-lua/projects
Security and qualityhttps://github.com/purescript-lua/purescript-lua/security
Insightshttps://github.com/purescript-lua/purescript-lua/insights
https://github.com/purescript-lua/purescript-lua
New issuehttps://github.com/login?return_to=https://github.com/purescript-lua/purescript-lua/issues/139
New issuehttps://github.com/login?return_to=https://github.com/purescript-lua/purescript-lua/issues/139
#150https://github.com/purescript-lua/purescript-lua/pull/150
Design: globally unique local names (GUC) in the IR pipelinehttps://github.com/purescript-lua/purescript-lua/issues/139#top
#150https://github.com/purescript-lua/purescript-lua/pull/150
area: irIR / optimizer / DCE / inlinerhttps://github.com/purescript-lua/purescript-lua/issues?q=state%3Aopen%20label%3A%22area%3A%20ir%22
enhancementNew feature or requesthttps://github.com/purescript-lua/purescript-lua/issues?q=state%3Aopen%20label%3A%22enhancement%22
https://github.com/Unisay
Unisayhttps://github.com/Unisay
on Jul 2, 2026https://github.com/purescript-lua/purescript-lua/issues/139#issue-4797081777
#37https://github.com/purescript-lua/purescript-lua/issues/37
#56https://github.com/purescript-lua/purescript-lua/issues/56
#133https://github.com/purescript-lua/purescript-lua/issues/133
#134https://github.com/purescript-lua/purescript-lua/issues/134
#138https://github.com/purescript-lua/purescript-lua/issues/138
#138https://github.com/purescript-lua/purescript-lua/issues/138
#133https://github.com/purescript-lua/purescript-lua/issues/133
#134https://github.com/purescript-lua/purescript-lua/issues/134
Undefined variable in compiled code #37https://github.com/purescript-lua/purescript-lua/issues/37
Codegen: 'Unexpected bound reference Local b index 1' compiling Data.Array.foldRecM (index inflated by optimizer) #56https://github.com/purescript-lua/purescript-lua/issues/56
IR DCE mishandles Let bindings: no unshift after dropping a dead shadowing binder, body scope resolved in reverse #134https://github.com/purescript-lua/purescript-lua/issues/134
#136https://github.com/purescript-lua/purescript-lua/issues/136
#136https://github.com/purescript-lua/purescript-lua/issues/136
#138https://github.com/purescript-lua/purescript-lua/issues/138
#133https://github.com/purescript-lua/purescript-lua/issues/133
#134https://github.com/purescript-lua/purescript-lua/issues/134
Unisayhttps://github.com/Unisay
enhancementNew feature or requesthttps://github.com/purescript-lua/purescript-lua/issues?q=state%3Aopen%20label%3A%22enhancement%22
area: irIR / optimizer / DCE / inlinerhttps://github.com/purescript-lua/purescript-lua/issues?q=state%3Aopen%20label%3A%22area%3A%20ir%22
on Jul 2, 2026https://github.com/purescript-lua/purescript-lua/issues/139#event-27493733278
Unisayhttps://github.com/Unisay
completedhttps://github.com/purescript-lua/purescript-lua/issues?q=is%3Aissue%20state%3Aclosed%20archived%3Afalse%20reason%3Acompleted
#150https://github.com/purescript-lua/purescript-lua/pull/150
on Jul 3, 2026https://github.com/purescript-lua/purescript-lua/issues/139#event-27529772321
Sign up for freehttps://github.com/signup?return_to=https://github.com/purescript-lua/purescript-lua/issues/139
Sign in to commenthttps://github.com/login?return_to=https://github.com/purescript-lua/purescript-lua/issues/139
area: irIR / optimizer / DCE / inlinerhttps://github.com/purescript-lua/purescript-lua/issues?q=state%3Aopen%20label%3A%22area%3A%20ir%22
enhancementNew feature or requesthttps://github.com/purescript-lua/purescript-lua/issues?q=state%3Aopen%20label%3A%22enhancement%22
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.