docs(runtime): sync all docs with implementation, add SDK encoding helpers#20
Merged
simonovic86 merged 1 commit intomainfrom Mar 5, 2026
Merged
docs(runtime): sync all docs with implementation, add SDK encoding helpers#20simonovic86 merged 1 commit intomainfrom
simonovic86 merged 1 commit intomainfrom
Conversation
…lpers Update stale documentation across 6 files to match current code: - CLAUDE.md: update phase status, packages, CLI flags, SDK description - IMPLEMENTATION_STATUS.md: fix version byte, header size, authority/lineage status, file reference - DEVELOPMENT.md: Go 1.22→1.25, cyclomatic max 15→20, add 12 missing packages to project structure - ARCHITECTURE.md: fix capability table status, header size, cost formula (Nanoseconds), byte layout - AGENT_LIFECYCLE.md: 4→5 exports, Tick() returns bool, cost formula, checkpoint format v0x04 - IMPROVEMENTS.md: mark all 10 items DONE with implementation details Add SDK encoding helpers for fixed-size fields: - Encoder.Raw(b) appends bytes without length prefix - Decoder.FixedBytes(n) reads exactly n bytes into new slice - Decoder.ReadInto(dst) reads len(dst) bytes into existing slice - 7 new tests covering round-trips, short reads, and size comparison Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sync documentation across all runtime modules to reflect current implementation state through Phase 5 (Hardening) and Task 15. Add new SDK encoding helpers for fixed-size checkpoint serialization.
Changes
Documentation Updates
make demotarget, clarify adaptive tick loop (1 Hz default, 10ms fast path), expand architecture section with new internal packagesagent_tick), detail v0x04 checkpoint header (209 bytes with lease/lineage metadata), update cost calculation to nanosecond precision, provide v0x04 counter exampleSDK Enhancements
Raw(b []byte)method for fixed-size fields without length prefix, addFixedBytes(n int)decoder, addReadInto(dst)convenience method for array fieldsTestEncoder_Raw_RoundTrip,TestDecoder_ReadInto,TestDecoder_FixedBytes_ShortRead,TestDecoder_ReadInto_ShortRead,TestEncoder_Raw_Empty,TestRaw_vs_Bytes_SizeComparisonplus helper testNotes
RawandFixedBytesimprove ergonomics for checkpoint serialization patterns like[16]bytearrays