Skip to content

Document current deferred GDN replay and retire stale RFC scaffolding - #198

Open
linson007 wants to merge 4 commits into
incoai:mainfrom
linson007:rfc/190-deferred-gdn
Open

linson007 wants to merge 4 commits into
incoai:mainfrom
linson007:rfc/190-deferred-gdn

Conversation

@linson007

@linson007 linson007 commented Sep 27, 2026 •

Copy link
Copy Markdown
Contributor

Commit attribution was corrected to linson007 with a metadata-only history rewrite. File trees are unchanged; historical benchmark source hashes and CI links below retain their original recorded scope.

Main already implements deferred GDN replay: commit 48a94aaae6deda31bfbaec08e8a896c2d670e37a folds a decode step's retained rows into the next step. This PR now documents that mechanism against current main 1482f6bbc2abf12375332725302019594150b6cb.

The net diff is one documentation file. The unused SPLASH_DEFERRED_GDN_REPLAY header and string/Python-mirror tests are removed from the proposal. Their placeholder counted discarded suffix rows (proposed - accepted); the actual runtime records retained rows, including the anchor. They did not implement or validate the current mechanism.

docs/rfc/190-deferred-gdn.md links the current tape, shader, state and oracle paths and records the constraints on any further work: prior retained rows, convolution carry, tape ownership, materialization/capture/cache publication, supported layouts and both state formats. It does not introduce a second runtime flag or claim a new speedup. Related issue #190 remains the discussion point for further optimization.

Merge commit a7ddcddc contains current main without rewriting the original branch. Ahead/behind checks show zero commits behind main. Local documentation links and full-patch whitespace checks pass. There are no runtime/shader/build changes to retest locally; fresh current-head CI passes all four ordinary jobs: production/CPU runtime, every native build and sanitizers, and Python 3.12, 3.13 and 3.14 tests/source checks. The opt-in release hardware gate is skipped. The Python 3.14 job runs 1,318 tests with four skips; lint and formatting pass. Older September scaffolding CI is historical, not evidence of new runtime behavior.

Upstream issue incoai#190. Default off, no behavior change.
ReplayState/DeferredReplay/onVerify with static_asserts. No new
.metal: verify_gdn_fused* is the existing resolve target.

Upstream issue incoai#190, PR incoai#198.
@linson007 linson007 changed the title rfc/190: deferred GDN replay scaffolding Document current deferred GDN replay and retire stale RFC scaffolding Oct 21, 2026
@linson007
linson007 force-pushed the rfc/190-deferred-gdn branch from a7ddcdd to 2159f78 Compare October 21, 2026 18:16
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