Skip to content

Pre-release cleanup: consolidate special-form metadata, drop design doc#23

Merged
myzie merged 1 commit into
mainfrom
cleanup-pre-release
May 8, 2026
Merged

Pre-release cleanup: consolidate special-form metadata, drop design doc#23
myzie merged 1 commit into
mainfrom
cleanup-pre-release

Conversation

@myzie
Copy link
Copy Markdown
Contributor

@myzie myzie commented May 8, 2026

Summary

Final cleanup before cutting a release.

  • Removes docs/design/language-evolution.md (the doc was untracked; deleted from disk in this branch and never committed to history).
  • Consolidates the three parallel lists describing higher-order special forms — higherOrderForms (dispatch), higherOrderNames (suggester candidates), formCallHints (call-signature hints) — into a single userForms slice in higher_order.go. A previous reviewer flagged the drift risk: adding a form meant remembering to update three places. Now there's one.
  • Adds a one-line note to docs/reference/spec.md and llms.txt recording that ?? is intentionally not provided, since ?. / ?[ + operand-returning || + try(...) cover the same use cases.

No behavior changes. The "is a special form" hint, did-you-mean suggestions, and exact-match suppression all continue to work; verified with a probe.

Test plan

  • go build ./...
  • go vet ./...
  • go test -count=1 ./... — all green
  • go test -fuzz=FuzzCompile -fuzztime=5s . — no findings
  • go test -fuzz=FuzzRewrite -fuzztime=5s ./internal/optaccess — no findings
  • Live probe: count, try, map produce special-form hints; mappdid you mean "map"?; flterdid you mean "filter"?

Collapse the three parallel lists describing higher-order forms
(higherOrderForms dispatch, higherOrderNames suggester candidates,
formCallHints signatures) into a single userForms slice in
higher_order.go. Adding a form now means appending one entry; the
derived tables stay in lockstep automatically.

Also note in spec.md and llms.txt that ?? is intentionally not
provided, since the question keeps coming up.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@myzie myzie merged commit 227a151 into main May 8, 2026
1 check passed
@myzie myzie deleted the cleanup-pre-release branch May 8, 2026 15:28
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