J4: typed write-path + auth - #4
Merged
Merged
Conversation
…}/transitions)
TDD implementation of tracker transition endpoints for J4 write-path phase:
- POST /api/v1/tracker/items/{id}/transitions: append inbox requests
- POST /api/v1/inbox: generic note appends
- Static bearer token auth via AESOP_SERVER_TOKEN env (503 if unset)
- Validation: transition checks current projected state, rejects same-status
- Inbox format: one JSON object per line (ts, source, kind, itemId, etc)
- Concurrent append safety: ReentrantLock + fsync for crash safety
- 202 Accepted response (orchestrator applies asynchronously)
Tests: 7 controller tests (validation, auth, 202 shape) + 8 service tests
(JSON format, UTF-8, concurrent 10-thread appends, parse integrity).
All 57 tests green; soak test: 156 writes, 308 concurrent reads.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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
1 participant
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
Implements J4 write-path with auth: inbox-mediated tracker transitions preserving single-writer discipline.
POST /api/v1/tracker/items/{id}/transitionsvalidates state, appends to orchestrator inbox (202 Accepted)POST /api/v1/inboxgeneric note appendsAESOP_SERVER_TOKENenv (503 if unset, fail-closed)Test Plan
What's Next
🤖 Generated with Claude Code