Skip to content

docs: bring documentation current (ABI v8 / 75 handlers); trim to two flagship examples#22

Merged
SethMorrowSoftware merged 1 commit into
mainfrom
claude/relaxed-cerf-816pyn
Jun 27, 2026
Merged

docs: bring documentation current (ABI v8 / 75 handlers); trim to two flagship examples#22
SethMorrowSoftware merged 1 commit into
mainfrom
claude/relaxed-cerf-816pyn

Conversation

@SethMorrowSoftware

Copy link
Copy Markdown
Owner

A documentation pass to match the project as it now stands (ABI v8, 75 public handlers) and slim the examples to the two flagship demos.

Examples

  • Removed the three minimal single-concept demos: torrent-demo, torrent-dht-note, torrent-dht-channel.
  • Kept: the full client (torrent-client), the decentralized DHT demo (torrent-dht-channels), and the shared poll-dispatcher utility (torrent-helpers). Both flagships are self-contained and run without the helper.
  • tools/package-extension.py now stages the binding + helpers + both flagship demos — it had bundled the now-removed torrent-demo and omitted the flagships entirely.

Docs

  • README — Features rewritten to cover the v4–v8 surface (queue control, flags/modes, move-storage, scrape, per-torrent caps, file table, per-piece availability, trackers, web seeds, session ops, IP filter, streaming deadlines, extended add); Examples trimmed to the two flagships + helpers; Status notes the 75-handler / ABI v8 breadth. (The API-at-a-glance table was already current at 75.)
  • getting-started — drops the references to the removed torrent-demo; the lifecycle skeleton is presented standalone and points at the two flagship examples.
  • architecture — adds the channels demo to the stack diagram; lists the new file / tracker / availability getters among the out-buffer crossings.
  • implementation-plan — fixes the examples file tree.

Verification

  • api-reference documents all 75 public handlers (coverage cross-checked against torrent.lcb).
  • Zero dangling references to the removed files anywhere in the repo (full-tree sweep, all file types).
  • check-livecodescript passes (now 4 files = torrent.lcb + the 3 kept scripts); package-extension.py parses.
  • Docs/examples only — no shim, ABI, or record-schema change.

🤖 Generated with Claude Code

https://claude.ai/code/session_01371AXB4CUUke7enHHS8okc


Generated by Claude Code

Documentation pass to match the project as it stands (ABI v8, 75 public
handlers) and slim the examples to the two flagship demos.

Examples:
- Remove the three minimal single-concept demos: torrent-demo,
  torrent-dht-note, torrent-dht-channel. Keep the full client
  (torrent-client), the decentralized DHT demo (torrent-dht-channels), and the
  shared poll-dispatcher utility (torrent-helpers); both flagships are
  self-contained and run without the helper.
- package-extension.py now stages the binding + helpers + both flagship demos
  (it had bundled the now-removed torrent-demo and omitted the flagships).

Docs:
- README: Features rewritten to cover the v4-v8 surface (queue, flags/modes,
  move-storage, scrape, caps, file table, per-piece availability, trackers,
  web seeds, session ops, IP filter, streaming deadlines, extended add);
  Examples list trimmed to the two flagships + helpers; Status notes the
  75-handler / ABI v8 breadth. API-at-a-glance table already current (75).
- getting-started: drop references to the removed torrent-demo (the skeleton
  is presented standalone; it points at the two flagship examples instead).
- architecture: add the channels demo to the stack diagram; list the new
  file/tracker/availability getters among the out-buffer crossings.
- implementation-plan: fix the examples file tree.

Verified: api-reference documents all 75 public handlers (coverage checked);
no dangling references to the removed files anywhere in the repo;
check-livecodescript passes (4 files); package-extension.py parses.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01371AXB4CUUke7enHHS8okc
@SethMorrowSoftware SethMorrowSoftware marked this pull request as ready for review June 27, 2026 13:20
@SethMorrowSoftware SethMorrowSoftware merged commit 53098c6 into main Jun 27, 2026
8 checks passed
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.

2 participants