Skip to content

docs: change type to integer in number/uint32/base/identity REPL docs#11759

Merged
kgryte merged 1 commit intodevelopfrom
philipp/drift-number-uint32-base-2026-04-24
Apr 25, 2026
Merged

docs: change type to integer in number/uint32/base/identity REPL docs#11759
kgryte merged 1 commit intodevelopfrom
philipp/drift-number-uint32-base-2026-04-24

Conversation

@Planeshifter
Copy link
Copy Markdown
Member

Description

Aligning outliers in number/uint32/base with namespace majority patterns (random namespace pick, seed 42).

Namespace summary

  • Target namespace: @stdlib/number/uint32/base
  • Member count: 10 non-autogenerated packages (add, from-binary-string, identity, mul, muldw, rotl, rotr, sub, to-binary-string, to-int32)
  • Majority threshold: ≥ 8 / 10 (75%)
  • Features analyzed — structural: file tree, package.json top-level / scripts / stdlib keys, manifest.json keys, README ##/### section order, test/benchmark/example filenames. Semantic: public signature, return kind, validation prologue, error construction, JSDoc shape, @stdlib/* dependency set, and docs/repl.txt Parameters/Returns type column.
  • Features with clear majority (≥ 75%): universal core file set, universal package.json top-level keys, docs/repl.txt type column = integer for uint32 operands (9/10 = 90%).
  • Features without clear majority (excluded): JSDoc @param type {uinteger32} vs {uinteger} (60% / 30%), C-API artifacts (40%), ## Notes README section (70%), ## See Also populated (60%), manifest.json / gypfile / __stdlib__ / binding.gyp / src/ / include/ (40% — legitimately C-API-only).

number/uint32/base/identity

Normalizes the repl.txt type-column entries for number/uint32/base/identity from number to integer, bringing it in line with 9 of 10 sibling packages in the number/uint32/base/* namespace (90% conformance). The change affects the Parameters and Returns columns and is semantically correct given the function operates exclusively on unsigned 32-bit integers.

Validation

Three independent validation agents signed off on the correction:

  • Semantic review (opus) — confirmed-drift. Identity's own headline docstring describes it as operating on "an unsigned 32-bit integer", so integer is semantically correct and aligns with siblings. No other ≥ 75% semantic patterns with outliers were found.
  • Cross-reference (opus) — safe-to-fix. identity/test/test.js and identity/examples/index.js do not reference the REPL type label; no external stdlib module depends on the previous wording; _tools/repl-txt/rules/tag-typedef-typos/lib/defaults.json whitelists both number and integer, so the change is lint-clean.
  • Structural review (sonnet) — confirmed-drift. This is the only high-signal structural or documentation anomaly in the namespace; all other splits (C-API vs pure-JS, populated vs empty See Also) fall below threshold and reflect legitimate differences in package scope.

Deliberately excluded from this PR:

  • Features without a clear 75% majority.
  • Outliers whose deviation reflects a genuine semantic or scope difference (e.g., packages without a C implementation legitimately lacking manifest.json / binding.gyp / include/).
  • Fixes that would require changing observable behavior, public signatures, or test expectations.

Related Issues

None.

Questions

No.

Other

Full drift report (majority pattern, per-feature conformance, outlier list, agent verdicts, dropped corrections) saved locally at ~/drift-reports/drift-number-uint32-base-2026-04-24.md for the maintainer's audit trail.

Checklist

AI Assistance

  • Yes
  • No

If you answered "yes" above, how did you use AI assistance?

  • Code generation (e.g., when writing an implementation or fixing a bug)
  • Test/benchmark generation
  • Documentation (including examples)
  • Research and understanding

Disclosure

This PR was authored by Claude Code running a cross-package API drift detection routine that selects a random stdlib namespace (seed 42number/uint32/base), extracts structural and semantic features from every package, computes per-feature majority patterns at a 75% threshold, and validates outliers through three independent review agents before proposing the correction.


@stdlib-js/reviewers


Generated by Claude Code

…pace convention

Normalize parameter and return type column in `docs/repl.txt` from `number`
to `integer` to match 9/10 (90%) sibling packages in
`@stdlib/number/uint32/base/*`, which consistently use `integer` as the
scalar type for unsigned 32-bit integer operands in REPL documentation.
@stdlib-bot
Copy link
Copy Markdown
Contributor

Coverage Report

Package Statements Branches Functions Lines
number/uint32/base/identity $\color{green}157/157$
$\color{green}+100.00%$
$\color{green}5/5$
$\color{green}+100.00%$
$\color{green}2/2$
$\color{green}+100.00%$
$\color{green}157/157$
$\color{green}+100.00%$

The above coverage report was generated for the changes in this PR.

@kgryte kgryte added bot: Merge Pull request needing the latest project code be merged in. and removed bot: Merge Pull request needing the latest project code be merged in. labels Apr 24, 2026
@Planeshifter Planeshifter changed the title docs: align outliers in number/uint32/base with namespace majority patterns docs: change type to integer in number/uint32/base REPL docs Apr 25, 2026
@Planeshifter Planeshifter marked this pull request as ready for review April 25, 2026 22:55
@Planeshifter Planeshifter requested review from a team and kgryte April 25, 2026 22:55
@stdlib-bot stdlib-bot added the Needs Review A pull request which needs code review. label Apr 25, 2026
@kgryte kgryte removed the Needs Review A pull request which needs code review. label Apr 25, 2026
@kgryte kgryte changed the title docs: change type to integer in number/uint32/base REPL docs docs: change type to integer in number/uint32/base/identity REPL docs Apr 25, 2026
@kgryte kgryte merged commit aedb51d into develop Apr 25, 2026
62 of 63 checks passed
@kgryte kgryte deleted the philipp/drift-number-uint32-base-2026-04-24 branch April 25, 2026 23:05
@kgryte kgryte added the Documentation Improvements, additions, or changes to documentation. label Apr 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Documentation Improvements, additions, or changes to documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants