Skip to content

docs(plans): mark numeric loss signals plans complete#756

Merged
aalpar merged 1 commit into
masterfrom
docs/loss-signals-plan-status
May 16, 2026
Merged

docs(plans): mark numeric loss signals plans complete#756
aalpar merged 1 commit into
masterfrom
docs/loss-signals-plan-status

Conversation

@aalpar
Copy link
Copy Markdown
Owner

@aalpar aalpar commented May 16, 2026

Summary

In-place update to the two numeric-loss-signals plan documents now
that all three PRs (#753, #754, #755) are merged.

  • Design plan (plans/2026-05-14-numeric-loss-signals-design.md):
    Status field flipped from "Approved by user; refined" to "Complete
    — all three PRs merged" with the three merge-commit references and
    a note about the atan2 R7RS regression mitigation.
  • Impl plan (plans/2026-05-14-numeric-loss-signals-impl.md):
    Status field + done-definition checklist updated; new
    "Post-implementation outcome" section captures shipped-vs-planned
    deltas (including the declined LookupNumericSpec rename, the
    emergent atan2Operand helper, the runOne-helper round-trip,
    the discoverability test), LOC actuals, bench-gate results, and
    the review-findings summary.

Pure documentation; no code change.

Test plan

  • No code touched — make lint / make test not required
  • Markdown renders correctly in the GitHub preview
  • Cross-references resolve (CHANGELOG.md, docs/numeric/tower.md,
    docs/reference/r7rs-differences.md, values/CLAUDE.md,
    TODO.md tier-5 entry)

Follow-up

The "Done definition" checklist has one open item: move both plans
to memory/ per plans/CLAUDE.md convention. Deferred to a
separate closeout sweep so this PR stays scoped to the in-place
update.

🤖 Generated with Claude Code

Updates both plan documents to reflect the three-PR completion:

- Status field: 'Plan ready to start' / 'Approved by user' →
  'Complete — all three PRs merged' with the three merge-commit
  references (#753 / #754 / #755) and dates.

- Impl plan gains a 'Post-implementation outcome' section
  capturing shipped-vs-planned deltas:

  Declined:
    - LookupNumericSpec → Lookup rename (kept for cross-package
      clarity, 5 internal call sites all stable).

  Emerged during implementation:
    - atan2Operand helper in extensions/math/prim_transcendental.go
      (R7RS regression mitigation when helpers.ToFloat64 tightened).
    - runOne test helper created in PR 3, then deleted in PR 3
      fixup after a 3-lens crosscheck convergence caught it as
      duplicating the existing eval helper.
    - Discoverability test (TestLossSignalDiscoverability) added
      in PR 3 fixup after the tests lens flagged a typo-risk gap.

  Plus LOC actuals (all PRs landed larger than estimated, mostly
  due to docs + integration test + post-review fixups), bench-gate
  results (PR 2 geomean +0.26%, within the 0.5% target), and
  review-findings summaries from both Copilot and the crosscheck
  agents.

- Done definition checklist: 3/4 items checked. The fourth item
  (move both plans to memory/ per plans/CLAUDE.md convention)
  remains open as a separate closeout sweep.

The cross-references section enumerates the user-visible
documentation that ships with this work (docs/numeric/tower.md,
docs/reference/r7rs-differences.md, values/CLAUDE.md, CHANGELOG.md)
so a future reader can find the rule statement without re-tracing
plan history.
@aalpar aalpar merged commit 64b4d17 into master May 16, 2026
1 check passed
@aalpar aalpar deleted the docs/loss-signals-plan-status branch May 16, 2026 18:44
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