zzstoatzz.io
commits
deep dive into atproto's commit diff verification algorithm,
zlay's relay integration (observation mode), and SDK affordance
analysis — concluded loadCommitFromCAR is already correctly public.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- new: binary encoding patterns (CBOR, CAR, varints, arena per message)
- add: SHA-256 hashing for content addressing
- add: @constCast for inline struct literal slices
- add: std.math.cast for safe integer narrowing at system boundaries
- add: comptime-parameterized adapter pattern for callback bridging
- update: README to reflect zat's expanded scope (CBOR, firehose)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- document slice vs array behavior when struct is copied
- add copy-safe pattern from logfire-zig (internal [max_len]u8 storage)
- add logfire-zig to sources table
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- json.md: std.json.Stringify patterns, numbers vs strings gotcha
- modules.md: file + directory pattern from ghostty/tigerbeetle
- concurrency.md: background thread shutdown with acquire/release
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- database.md: zqlite, pg.zig, transactions, connection patterns
- interfaces.md: anytype validation, vtables, module boundary pattern
- projects/prefect-zig/plan.md: zig prefect server implementation plan
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- new 0.16/ directory for upcoming release
- io.md: std.Io interface, async vs concurrent, no function coloring
- sources: kristoff.it, andrewkelley.me, porting guide
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- concurrency.md: ring buffer for metrics (fixed array, head pointer, percentiles)
- comptime.md: SQL placeholder validation pattern
from leaflet-search learnings
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Adds new notes for the Model Context Protocol (MCP) including an overview and details on the FastMCP framework.
Integrates 'Atmospheric Computing' concepts into existing AT Protocol notes to better describe its philosophy and architecture:
- Introduced 'philosophy' section in atproto/README.md with Atmospheric Computing definition.
- Updated PDS description in atproto/README.md to reflect 'personal cloud' metaphor.
- Enhanced 'why this matters' in atproto/data.md to link to Atmospheric Computing benefits.
- Added blog post source for Atmospheric Computing.
- io.md: document flate.Decompress panic on x86_64-linux, workaround
- dependencies.md: tangled.sh as zig package source
- 0.15/README.md: zig issues moved to codeberg (30xxx+)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- remove filterable decorator (covered in mcp.md)
- remove lowercase aesthetic (implicit in notes style)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
async.md:
- add connection pool singleton pattern from follower-weight
- add postgres batch writes with unnest()
pydantic.md:
- add model_validator for side effects (logging setup)
firehose.md:
- replace generic batch example with realistic tap_consumer pattern
- show separate buffers, time-based flushing, pending acks
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
bind validation to types with Annotated + AfterValidator
instead of repeating @field_validator on each schema
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- add diagram showing all components (PDS, Relay, AppView, Feed Generator, Labeler)
- explain each component factually
- show data flow step by step
- remove derivative philosophy, focus on how it works
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
covers identity, data model, lexicons, firehose/jetstream,
auth, and labels. based on plyr.fm, pdsx, teal-fm patterns
and paul frazee's atmospheric computing posts.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
groups (PEP 735) stay local, optional deps go into package metadata
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- restructure into language/ and ecosystem/ subdirectories
- trim README commentary
- verify all code examples against pdsx, fastmcp, docket
- add source links to examples
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- use tuple membership dispatch, not match/case
- add RawDescriptionHelpFormatter
- add async main pattern with sys.exit(asyncio.run())
- link to actual source
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- README: recommend 3.12+
- typing.md: native generic syntax [T], type statement
- uv.md: PEP 723 inline script metadata (# /// script)
- patterns.md: argparse with subparsers
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- async.md: focus on async with as core insight, explain why
- pydantic.md: acknowledge it's a library, explain the core idea
- README: honest about language vs ecosystem, better intro
cut 250 lines of snippet gallery
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
restructure python notes to cover the language itself, not just tooling:
- typing.md: modern type hints, Protocol, generics, ParamSpec
- async.md: context managers, ContextVar, concurrency patterns
- pydantic.md: models, validators, discriminated unions, settings
- patterns.md: class design, decorators, error handling
rewrite README as friendly introduction with language/ecosystem split
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- reference plyr-python-client, pmgfal, prefect-mcp-server-demo, typsht
- add uv workspaces section
- add uv_build as simpler backend option
- mention typsht and prek as alternatives
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- organization.md: modular build.zig, Config struct, SharedDeps
- dependencies.md: lazy deps, vendored vs system libs, pinning
- codegen.md: generating zig source at build time
- cross-compilation.md: cpu targeting, glibc, universal binaries
patterns from studying two large production zig projects
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
make each file more accessible - explain what the thing is for,
why you'd care, and what the patterns mean in context.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- arraylist: focus on ownership (toOwnedSlice vs deinit), not "remember allocator"
- io: keep core patterns + tls quirk, add http.Client, delete history lesson
- build: just the 0.15 change and hash trick, delete boilerplate
- comptime: generalizable patterns, not zql description
- concurrency: design decisions (atomics vs mutex), not std.Thread syntax
-182 lines, mostly redundant/obvious content
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- arraylist.md: why allocator is now passed to every method
- io.md: writergate, explicit buffers, tls reading quirk
- build.md: createModule pattern, build.zig.zon
- comptime.md: type-returning functions, inline for, reflection
- concurrency.md: thread pools, mutexes, atomics, backoff
README is now just an index with links
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- ziglang/README.md: summary with project table and dependency links
- ziglang/0.15/README.md: patterns with specific file/line references
all links verified against source files
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
synthesized from leaflet-search, find-bufo, zql, pollz
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- new: binary encoding patterns (CBOR, CAR, varints, arena per message)
- add: SHA-256 hashing for content addressing
- add: @constCast for inline struct literal slices
- add: std.math.cast for safe integer narrowing at system boundaries
- add: comptime-parameterized adapter pattern for callback bridging
- update: README to reflect zat's expanded scope (CBOR, firehose)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- json.md: std.json.Stringify patterns, numbers vs strings gotcha
- modules.md: file + directory pattern from ghostty/tigerbeetle
- concurrency.md: background thread shutdown with acquire/release
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- database.md: zqlite, pg.zig, transactions, connection patterns
- interfaces.md: anytype validation, vtables, module boundary pattern
- projects/prefect-zig/plan.md: zig prefect server implementation plan
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Adds new notes for the Model Context Protocol (MCP) including an overview and details on the FastMCP framework.
Integrates 'Atmospheric Computing' concepts into existing AT Protocol notes to better describe its philosophy and architecture:
- Introduced 'philosophy' section in atproto/README.md with Atmospheric Computing definition.
- Updated PDS description in atproto/README.md to reflect 'personal cloud' metaphor.
- Enhanced 'why this matters' in atproto/data.md to link to Atmospheric Computing benefits.
- Added blog post source for Atmospheric Computing.
async.md:
- add connection pool singleton pattern from follower-weight
- add postgres batch writes with unnest()
pydantic.md:
- add model_validator for side effects (logging setup)
firehose.md:
- replace generic batch example with realistic tap_consumer pattern
- show separate buffers, time-based flushing, pending acks
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- add diagram showing all components (PDS, Relay, AppView, Feed Generator, Labeler)
- explain each component factually
- show data flow step by step
- remove derivative philosophy, focus on how it works
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- async.md: focus on async with as core insight, explain why
- pydantic.md: acknowledge it's a library, explain the core idea
- README: honest about language vs ecosystem, better intro
cut 250 lines of snippet gallery
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
restructure python notes to cover the language itself, not just tooling:
- typing.md: modern type hints, Protocol, generics, ParamSpec
- async.md: context managers, ContextVar, concurrency patterns
- pydantic.md: models, validators, discriminated unions, settings
- patterns.md: class design, decorators, error handling
rewrite README as friendly introduction with language/ecosystem split
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- organization.md: modular build.zig, Config struct, SharedDeps
- dependencies.md: lazy deps, vendored vs system libs, pinning
- codegen.md: generating zig source at build time
- cross-compilation.md: cpu targeting, glibc, universal binaries
patterns from studying two large production zig projects
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- arraylist: focus on ownership (toOwnedSlice vs deinit), not "remember allocator"
- io: keep core patterns + tls quirk, add http.Client, delete history lesson
- build: just the 0.15 change and hash trick, delete boilerplate
- comptime: generalizable patterns, not zql description
- concurrency: design decisions (atomics vs mutex), not std.Thread syntax
-182 lines, mostly redundant/obvious content
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- arraylist.md: why allocator is now passed to every method
- io.md: writergate, explicit buffers, tls reading quirk
- build.md: createModule pattern, build.zig.zon
- comptime.md: type-returning functions, inline for, reflection
- concurrency.md: thread pools, mutexes, atomics, backoff
README is now just an index with links
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>