Skip to content

Torrent v2 01b: define capability and revisioned inspection contracts - #164

Closed
linroid wants to merge 1 commit into
torrent-v2-01-foundationfrom
torrent-v2-01-contracts
Closed

linroid wants to merge 1 commit into
torrent-v2-01-foundationfrom
torrent-v2-01-contracts

Conversation

@linroid

@linroid linroid commented Sep 12, 2026

Copy link
Copy Markdown
Owner

Define the typed torrent inspection boundary in library:api, including capability negotiation, bounded task summaries, completion generations, and revision ordering. A delayed response cannot replace a newer same-epoch state; delta gaps and backend epoch changes require resynchronization. Unknown protocol major versions disable known controls.

Stack: based on #163 (torrent-v2-01-foundation). Review this PR against that branch. This is the contract slice of roadmap #162 step 01; implementation continues in focused dependent PRs.

KetchApi.torrents defaults to null, preserving existing implementations and legacy torrent downloads. The protocol document defines mutation/idempotency, pagination, reconnect, migration, and seed lifecycle semantics. Runtime adapters and typed mutations ship with their implementation slices; this PR advertises no runtime capabilities and does not claim those gates are complete.

Validation: API tests pass on JVM and JavaScript, including malformed wire values, unknown capabilities/versions, stale snapshots, delta gaps, epoch changes, and selected-byte completion bounds. Existing core and remote JVM implementations compile. Resource profiles, deterministic harness, and performance baseline remain pending in step 01.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 12, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-12T11:44:47.466340Z 5838074 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions

github-actions Bot commented Sep 12, 2026 •

Copy link
Copy Markdown
Contributor

Test Results

  460 files  + 3    460 suites  +3   3m 51s ⏱️ +6s
2 272 tests +15  2 272 ✅ +15  0 💤 ±0  0 ❌ ±0 
2 848 runs  +15  2 848 ✅ +15  0 💤 ±0  0 ❌ ±0 

Results for commit b1eadef. ± Comparison against base commit 24702a3.

♻️ This comment has been updated with latest results.

@linroid

linroid commented Sep 20, 2026

Copy link
Copy Markdown
Owner Author

Superseded by #231 (Contracts, verification infrastructure and resource limits) in the consolidated eight-PR stack for #162.

The replacement preserves this PR's code and subsequent fixes; its description links the original head and review discussions. The only additional consolidation fix is the CI-discovered listener cancellation regression, documented on the replacement. All eight replacements have passed their required CI checks.

Closing without merging. This branch and its discussions remain available for reference. Review index: #162 (comment)

@linroid linroid closed this Sep 20, 2026
@linroid
linroid deleted the torrent-v2-01-contracts branch September 20, 2026 11:12
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