Skip to content

Remove Table.oldestRetainedAuditTime() docs: the accessor is withdrawn before release - #669

Open
dawsontoth wants to merge 1 commit into
mainfrom
docs/remove-oldest-retained-audit-time
Open

Remove Table.oldestRetainedAuditTime() docs: the accessor is withdrawn before release#669
dawsontoth wants to merge 1 commit into
mainfrom
docs/remove-oldest-retained-audit-time

Conversation

@dawsontoth

Copy link
Copy Markdown
Contributor

Pure revert of #660's merge commit (0d151a2c), which documented Table.oldestRetainedAuditTime() under a v5.3.0 badge. That method is being removed from HarperFast/harper#2458 before it ships, so this page must not describe it.

Why it is withdrawn — per kriszyp's review of harper#2458 (Dawson's decision, 2026-09-10): the accessor had no caller except harper#2448; a public single-number floor binds a contract that a per-origin resume vector could not honor; and it created a second resume-validity path where replication already checks inside the operation (shouldForceBaseCopyForRetention). The audit retention floor itself still lands in #2458 — write-ahead, monotonic, verified — but as internal infrastructure. Table.subscribe consumes it inside the resume in harper#2448, and the consumer-facing docs for that behavior belong to #2448.

What this reverts: the ### oldestRetainedAuditTime(): number section and the reference #660 added to the startTime row of the subscription-options table. git revert applied cleanly against current main with no conflicts; the page is byte-identical to its pre-#660 state in that region.

#666, which corrected the removed section's contract wording, is closed for the same reason.

🤖 Generated with Claude Code

… catch-up horizon (#660)"

The accessor this documented is being removed from harper#2458 before it
ships. Per kriszyp's review there (Dawson's decision, 2026-09-10): it had
no caller except harper#2448, a public single-number floor binds a
contract a per-origin resume vector could not honor, and it created a
second resume-validity path where replication already checks inside the
operation. The floor stays as internal infrastructure; Table.subscribe
consumes it inside the resume in #2448, and that is where consumer-facing
docs belong.

This reverts commit 0d151a2.
@dawsontoth
dawsontoth requested a review from a team as a code owner September 10, 2026 14:06

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request removes the documentation for the oldestRetainedAuditTime(): number method from reference/resources/resource-api.md and simplifies the description of the startTime property. There are no review comments, and I have no feedback to provide.

@github-actions

Copy link
Copy Markdown

🚀 Preview Deployment

Your preview deployment is ready!

🔗 Preview URL: https://preview.harper-documentation.harperfabric.com/pr-669

This preview will update automatically when you push new commits.

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