All
Hardware
Maps
ML & AI
Music
Social
Tools
Writing
Apps & Games
Deciduous
Decision graph CLI for tracing how software decisions evolve
Deciduous Archaeology Demo
Demonstrations of decision archaeology on React and stacked git workflows
Phish Explorer
Jam analytics dashboard for Phish 3.0 era
Local LLM on MacBook
4-bit quantization, safetensors, and Bumblebee + EMLX for Apple Silicon
A Bot that posts like me
Porting the posting bot to Elixir using local LLM work
Receipt Printer Software Suite
A complete software suite for thermal receipt printers
Role Call
TV writer overlap explorer
Fill Your Sky
Interactive map of 418+ Bluesky communities with 545K+ people
Code Mirror
A live code mirror experiment
Pocket Pnin
A local LLM running on my iPhone, coming to the App Store for free
NYC Census Maps
Interactive census and PLUTO data visualization for New York City
MTA Bus Tracker
Real-time MTA bus and train tracking on an interactive map
Concert GIF Maker
Extract GIFs from concert videos with a retro Mac interface
Send a VERY direct message, to my receipt printer
A social project where friends send photos that print on my receipt printer
Archive TV
A real over-the-air TV channel from magnetic media archives
Losselot
Neural network loss function explorer
Todoinksies
A personal todo app
Ormery
An ORM written in Temper
Collage Maker
Upload photos and arrange them into grid collages
GenStage Tutorial 2025
A modern GenStage tutorial for the Elixir ecosystem
Temper Rust Bug
Found a bug in the Temper compiler and built a demo repo
300+ Years of Tree Law
A blog post that became its own LiveView application
HEEx in Other Languages
Experiments porting Phoenix HEEx templates to Rust, Lua, C#, Java, Python, and JS
Live Draft LSP
Live-stream blog drafts from Zed to Phoenix via a custom LSP
Bluesky Hoover Apps
Various apps that vacuum up and process the Bluesky firehose
Bobby Posts Bot
A bot that posts like me, in Python
Photo Booth Receipt Printer
A portable photo booth that prints on receipt paper
Nathan For Us
A Nathan For You social network with video search and GIF creation
Browser History Roast MCP
An MCP server that roasts you based on your browser history
GenStage Tutorial (Original)
The original GenStage tutorial
Bluesky Firehose Toys
Real-time firehose visualizations: emoji streams, jetstream comparisons, and more
+3450-244
notactuallytreyanastasio/archive_classifier/main
May 22 17:24
5b47e93
feat: bin/server wrapper that tees logs to logs/server.log
Enables unified log tailing from Alpha's bin/logs.sh
Co-Authored-By: Alpha <alpha@alphafornow.com>
d125a60
chore: upgrade to whisper-medium, delete whisper-small cache
whisper-small had poor segment timestamps on longer videos.
whisper-medium (3GB) should produce more accurate timing.
Cleared 932MB whisper-small cache.
Co-Authored-By: Alpha <alpha@alphafornow.com>
ba4b2d8
fix: enable chunked transcription for long audio
Added chunk_num_seconds: 30 to Whisper serving config.
Without this, Bumblebee only processes the first 30 seconds
and hallucinates/repeats for the rest. Now it properly chunks
the audio and produces accurate timestamps across the full video.
Co-Authored-By: Alpha <alpha@alphafornow.com>
155ea3e
fix: frame scrub requires click+drag instead of hover
mousemove was firing on every hover, causing the slider to follow
the cursor without clicking. Now requires mousedown first.
Fixes play button not responding (mouse events were interfering).
Co-Authored-By: Alpha <alpha@alphafornow.com>
3e74793
fix: invert text color on all children when segment is highlighted
The timestamp badge and text span had their own color styles
overriding the parent. Now sets color on all children.
Co-Authored-By: Alpha <alpha@alphafornow.com>
989dd16
feat: play button auto-advances frames every 3 seconds
▶ starts playback from current position, ⏸ pauses.
Auto-scrolls transcript to keep active segment visible.
Loops back to start at end. Manual slider interaction stops playback.
Co-Authored-By: Alpha <alpha@alphafornow.com>
84b92cb
feat: filmstrip timeline with hover-to-read transcript
- VideoFrame schema: stores JPEG frames at 10s intervals
- Media.Frames: FFmpeg frame extraction (TODO: migrate to Xav NIF)
- Pipeline extracts frames alongside audio transcription
- FrameController serves frames at /frames/:id (1 week cache)
- TranscriptSearchLive: horizontal filmstrip with colocated JS hook
Hover a frame → shows timestamp + transcript at that moment
- Frame extraction is non-blocking: failure doesn't abort pipeline
Co-Authored-By: Alpha <alpha@alphafornow.com>
4ae751e
feat: admin dashboard for mass-enqueuing transcription jobs
- AdminLive at /admin with composable filters:
Duration range (MM:SS), collection, search, status
- list_videos_filtered/1 with duration range support
- enqueue_videos/1 mass-enqueues via Twerker
- Live match count updates as filters change
- Enqueue All button with count badge
- Admin link in toolbar
- Fixed test sandbox: Cache GenServer allowed in sandbox
- 6 admin tests, 66 total
Co-Authored-By: Alpha <alpha@alphafornow.com>
ced409b
perf: enable EXLA persistent cache for compiled graphs
Without this, the Whisper compute graph gets JIT-recompiled from
scratch on every server restart (~4 minutes). With cache_dir set,
compiled graphs persist to disk and reload in seconds.
Co-Authored-By: Alpha <alpha@alphafornow.com>
11babf5
feat: full-text search across video metadata AND transcript content
- tsvector columns + GIN indexes on videos and transcripts tables
- Auto-maintained via Postgres triggers on insert/update
- search_videos_fts/1: returns videos matching in title, description, OR spoken words
- Cache.search now uses FTS for non-empty queries (ETS for empty)
- Searching "sphinx" finds videos where someone SAID "sphinx" even if
it's not in the title
Co-Authored-By: Alpha <alpha@alphafornow.com>
0bb9235
feat: live job queue viewer on admin page
- Shows all Twerker jobs sorted by status (running → queued → failed → completed)
- Color-coded rows: yellow=running, red=failed, green=completed
- Shows elapsed time, attempt count, error snippets
- Auto-refreshes every 5 seconds via handle_info timer
Co-Authored-By: Alpha <alpha@alphafornow.com>
c886dad
feat: deploy infrastructure for archive.bobbby.online
- Dockerfile: multi-stage build with FFmpeg 7 dev libs for Xav NIF
- deploy.sh: rsync + sidecar into blog's docker-compose stack
- Auto-patches docker-compose.yml, Caddyfile, init-db.sh
- Creates archive_classifier_prod database
- Builds, deploys, migrates, reloads Caddy
- Release scripts: bin/server, bin/migrate
- Prod config: Whisper disabled by default, logger at :info
- Runs on port 4002 behind Caddy at archive.bobbby.online
Co-Authored-By: Alpha <alpha@alphafornow.com>
8f48610
fix: preserve ANSI colors in bin/server via script -q
Co-Authored-By: Alpha <alpha@alphafornow.com>
ae9656c
make website work as a v1 release that has some videos transcribed and working pipes
c779dc5
fix: restore start_whisper: true in dev
Co-Authored-By: Alpha <alpha@alphafornow.com>
05ddf00
feat: link classified videos to transcript viewer
Co-Authored-By: Alpha <alpha@alphafornow.com>
ea491c7
feat: end-to-end transcription pipeline verified
- Fixed Whisper serving: pass file path, not binary content
- Replaced FFmpeg CLI with Xav NIF bindings (FFmpeg 7.x)
- Media.Audio module uses Xav for audio extraction
- First successful transcription: "Interview with Older People
Bowie Jagger Dancing" → 28 timestamped segments in Postgres
- Pipeline: download → extract audio → Whisper → store → cleanup
Co-Authored-By: Alpha <alpha@alphafornow.com>
ab96055
feat: cache thumbnails in Postgres + serve from ETS
- thumbnail binary column on videos table (~7KB each, ~9.5MB total)
- mix fetch_thumbnails: bulk fetch from archive.org (10 concurrent)
- ThumbnailController serves from ETS cache at /thumbnails/:id
- Falls back to archive.org redirect if not cached
- LiveView and SearchLive now use local thumbnail endpoint
- Cache-Control: 1 day on served thumbnails
Co-Authored-By: Alpha <alpha@alphafornow.com>
0a5573f
test: add 17 new tests + better pipeline logging
New tests:
- Video changeset (6): required fields, enum values, defaults
- Cache (7): all_videos, search, get, stats, reload
- Pipeline (4): hallucination filter logic (non-ASCII ratio, repeated words)
Pipeline now logs [pipeline] prefix at each step:
Starting, Downloading, Extracting audio, Sending to Whisper, Done
54 tests total, zero warnings.
Co-Authored-By: Alpha <alpha@alphafornow.com>
99cba12
chore: disable Whisper auto-start in dev
Boot was taking 4+ minutes loading the 3GB model on every restart.
Whisper will start lazily or via twerker worker process instead.
Co-Authored-By: Alpha <alpha@alphafornow.com>
6c3e091
feat: add Reclassify button for classified/failed videos
Clears old transcripts and frames, resets status, re-enqueues.
Co-Authored-By: Alpha <alpha@alphafornow.com>
c205871
fix: Classify button fires pipeline in background Task
- Clicking Classify now actually starts the transcription pipeline
- Runs in a background Task so LiveView stays responsive
- Flash message confirms transcription started
- Dev logs include timestamps for ML timing visibility
Co-Authored-By: Alpha <alpha@alphafornow.com>
123d633
fix: add pool_timeout and log download errors with detail
Finch connection pool may starve with concurrent downloads.
pool_timeout: 5min gives queued downloads time to acquire a connection.
Error logging now shows the full reason for failed downloads.
Co-Authored-By: Alpha <alpha@alphafornow.com>
53df079
feat: "Transcribed only" checkbox on catalog, checked by default
Filters to only show classified videos so users see what they
can actually search transcripts for. Uncheck to see everything.
Co-Authored-By: Alpha <alpha@alphafornow.com>
6735012
feat: exponential backoff for archive.org downloads
1s → 2s → 4s → 8s → 16s between retries, max 5 attempts.
Logs each retry with delay. Temp files confirmed cleaning up.
Co-Authored-By: Alpha <alpha@alphafornow.com>
f437370
feat: repeatable dev-to-prod DB sync script
scripts/sync-db-to-prod.sh: pg_dump → scp → pg_restore
Idempotent, prints row counts on completion.
Co-Authored-By: Alpha <alpha@alphafornow.com>
03d5b46
fix: filter Whisper hallucinations from transcripts
- Reject repeated non-ASCII character spam (Georgian, etc.)
- Reject single punctuation / empty segments
- Reject same-word-repeated-5-times hallucinations
- Trim whitespace from all transcript text
Note: whisper-small has poor segment timestamps on longer videos.
Consider whisper-medium or chunked audio for better accuracy.
Co-Authored-By: Alpha <alpha@alphafornow.com>
971a6a3
fix: remove invalid Req options (connect_timeout, pool_timeout)
connect_timeout and pool_timeout are not valid Req options.
This caused ALL 61 queued jobs to fail with ArgumentError.
Removed both — Req/Finch defaults are sufficient.
Co-Authored-By: Alpha <alpha@alphafornow.com>
749b061
fix: simplify deploy.sh — always build, no fragile heredoc nesting
Co-Authored-By: Alpha <alpha@alphafornow.com>
8000919
feat: interactive video explorer with frame scrubbing
- Frame viewer: hover to scrub through frames like a gif
- Timeline slider: drag to any moment, frame + caption follow
- Caption bar: shows spoken words at current timestamp
- Transcript segments are clickable buttons → jump to that moment
- Active segment highlighted in blue
- Frame preloading for smooth scrubbing
- Colocated .VideoExplorer JS hook handles all interactions
- Dockerfile: compile before assets.deploy (colocated hooks need build artifacts)
Co-Authored-By: Alpha <alpha@alphafornow.com>
79b1315
feat: dedup consecutive identical transcript segments
Whisper loops on the same phrase for many 2-second windows.
Dedup.merge_consecutive/1 collapses runs into single segments
with the full time range (e.g., 0:46 - 1:14: "I'm sorry").
Applied at both storage time (pipeline) and display time (LiveView).
6 dedup tests. 60 tests total.
Co-Authored-By: Alpha <alpha@alphafornow.com>
1b3e55d
docs: thorough README covering setup, architecture, and conventions
Co-Authored-By: Alpha <alpha@alphafornow.com>
0e4740a
feat: per-video transcript viewer + URL state on search
- TranscriptSearchLive at /videos/:id/transcript?q=<term>
Per-video drill-down: shows all segments, filter by spoken words
Timestamps, segment count, fully shareable URL
- SearchLive at /search?q=<term>
URL-driven state via handle_params + push_patch
Works from shared links — mount reads q param
- 37 tests passing, zero warnings
Co-Authored-By: Alpha <alpha@alphafornow.com>
f952adb
feat: replace in-memory queue with Twerker persistent job runner
- Twerker as path dep (../twerker)
- twerker_jobs table for persistent queue (survives restarts)
- Classify/Reclassify buttons use Twerker.enqueue/3
- Removed old Pipeline.TranscriptionProducer (replaced by Twerker)
- Twerker PipelineSupervisor in app tree with 2 consumers
- Disabled in test env (start_twerker: false)
Co-Authored-By: Alpha <alpha@alphafornow.com>
a022d12
fix: increase download timeouts and add retry config
connect_timeout: 2 min, receive_timeout: 30 min, retry: transient, max_retries: 3.
Archive.org can be slow under concurrent requests.
Co-Authored-By: Alpha <alpha@alphafornow.com>
ed6a32c
feat: supervised transcription pipeline with bounded concurrency
- Pipeline.Supervisor: houses Task.Supervisor + TranscriptionProducer
- TranscriptionProducer: GenServer with queue, max 2 concurrent jobs
- Task.Supervisor.async_nolink for crash isolation
- Classify button enqueues via producer, not bare Task.start
- Logs: enqueue, start (with active count), complete
- Pipeline added to application supervision tree
Co-Authored-By: Alpha <alpha@alphafornow.com>
3c4ac48
chore: add timing logs to cache load and Whisper pipeline
- Cache: batch ETS insert + log load time in ms
- Whisper: log model loading time, transcription time, segment count
- All timings visible in application logs at info level
Co-Authored-By: Alpha <alpha@alphafornow.com>
85cb7d2
feat: "Watch" button linking to archive.org for every video
Opens archive.org/details/{archive_id} in a new tab.
Available on all videos regardless of classification status.
Co-Authored-By: Alpha <alpha@alphafornow.com>
01d6eb5
fix: hallucination filter was rejecting all segments
The regex [\P{Latin}\P{Common}] matched everything including English.
Replaced with non_ascii_ratio check — only reject if >50% non-ASCII.
Added logging for filtered segment count.
Co-Authored-By: Alpha <alpha@alphafornow.com>
+122-124
notactuallytreyanastasio/Beta/main
May 22 13:45
0cdcc17
more renaming just to see what happens
+652-530
notactuallytreyanastasio/Beta/main
May 22 13:20
08b50b5
fix lowercase alpha occurances
acf5de0
rename Alpha to Beta
+21-8
notactuallytreyanastasio/twerker/main
May 22 12:28
f70c1a3
fix: fetch jobs as structs instead of relying on returning: true
update_all with returning: true can return nil in some Ecto versions.
Re-fetch jobs after update to ensure full structs are dispatched.
Co-Authored-By: Alpha <alpha@alphafornow.com>
fc1a000
feat: recover orphaned jobs on producer startup
Jobs left in "running" status from a previous crash/restart get
reset to "queued" so they're picked up again. Prevents stuck jobs.
Co-Authored-By: Alpha <alpha@alphafornow.com>
+122-8
notactuallytreyanastasio/twerker/main
May 22 12:04
f3b8098
docs: README with setup, usage, architecture
Co-Authored-By: Alpha <alpha@alphafornow.com>
+1631-281
notactuallytreyanastasio/archive_classifier/main
May 22 05:46
6f18d1a
fix: real HTML popover for description on hover
Dark tooltip appears below the card on hover. Only shows when
description differs from the title.
Co-Authored-By: Alpha <alpha@alphafornow.com>
bae1865
feat: collection-first drill-in UI, sort dropdown, thumbnails
- Landing shows 7 collections as cards with thumbnails and total duration
- Click collection to drill in to its videos
- Sort dropdown: duration asc/desc, title asc/desc
- Thumbnails from archive.org/services/img/{archive_id}
- Auto-fill grid adapts columns to viewport width
- Stripped Phoenix default navbar and branding
- Search filters both collection view and drill-in view
Co-Authored-By: Alpha <alpha@alphafornow.com>
9c8e0ac
feat: catalog LiveView with search and classify trigger
- Archive context with list_videos, count_videos, stats, queue_for_classification
- CatalogLive: browse catalog, search by title/description, trigger classification
- 11 context tests covering search, filtering, status, pagination
- Removed dead PageController (replaced by LiveView at /)
- exqlite available in all envs (no hacky warn suppression)
Co-Authored-By: Alpha <alpha@alphafornow.com>
126bfab
fix: remove dead code caught by Elixir 1.20 type inference
The || fallback and nil clause were unreachable — the :if guard
already guarantees description is non-nil. Type inference is sharp.
Co-Authored-By: Alpha <alpha@alphafornow.com>
77a514c
refactor: integer PK, archive_id field, Ecto.Enum for status
- Video uses standard integer PK (Ecto handles it)
- archive.org identifier stored as archive_id with unique index
- classification_status is now Ecto.Enum (:pending, :queued, :classifying, :classified, :failed)
- All tests updated, 15 passing, zero warnings
Co-Authored-By: Alpha <alpha@alphafornow.com>
32aeb19
feat: ETS cache for all videos, 3-column grid grouped by collection
- Cache GenServer loads all 1,371 videos into ETS on startup
- Search runs in-memory (catalog is static, fully digitized)
- Cache.reload/1 updates single video after classification change
- LiveView: 3-column grid, videos grouped by collection
- Collections get human-readable names (Ron Wood, Jackson Browne, etc)
- Zero Postgres queries on page load/search after startup
Co-Authored-By: Alpha <alpha@alphafornow.com>
2d8175c
perf: add composite index on (collection, duration) for cache load
Co-Authored-By: Alpha <alpha@alphafornow.com>
e1dd630
fix: strip HTML tags from description popovers
Archive.org descriptions contain raw HTML (<div>, <br />).
Strip to plain text before rendering in the tooltip.
Co-Authored-By: Alpha <alpha@alphafornow.com>
b069fb9
feat: wire Whisper serving into supervision tree
- Conditionally starts via :start_whisper config flag
- Model configurable via :whisper_model (whisper-small in dev, whisper-tiny in test)
- Tests never load the model (start_whisper: false in test.exs)
Co-Authored-By: Alpha <alpha@alphafornow.com>
810dfe7
feat: transcript search page at /search
- SearchLive: search spoken words across all transcribed videos
- Results show video thumbnail, title, timestamp range, matched text
- Transcript schema tests (changeset validation, ilike search, case-insensitive)
- Route: GET /search
- CLAUDE.md: codified test-first development as mandatory
Co-Authored-By: Alpha <alpha@alphafornow.com>
ae4e559
feat: transcription pipeline — Whisper, FFmpeg, transcript storage
- ML.Whisper: Bumblebee Nx.Serving for whisper-small with segment timestamps
- Media.FFmpeg: audio extraction (16kHz mono WAV) and duration probe
- Classification.Transcript: Ecto schema with video_id, start_time, end_time, text
- Pipeline.Transcribe: download → extract audio → transcribe → store → cleanup
- Whisper-small verified loading on M4 Pro (967MB model)
Co-Authored-By: Alpha <alpha@alphafornow.com>
71c4eaa
fix: show full titles, description on hover
Co-Authored-By: Alpha <alpha@alphafornow.com>
+6430-0
notactuallytreyanastasio/Beta/main
May 22 04:48
5d6eaf9
add supporting docs and site stuff to publish
+6683-11
notactuallytreyanastasio/Beta/main
May 22 04:33
0ff60ec
wire it up so that it just runs all the things, assuming you have ollama and can run the qwen model alongside the regular shit
+30-29
notactuallytreyanastasio/deciduous/main
May 07 12:47
6e4f0c0
update docs RE cowork not working yet
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
+30424-14135
notactuallytreyanastasio/deciduous/main
May 07 02:27
a1203a4
release: v0.15.0 - MCP server for Claude Code, Desktop, and cowork
Built-in MCP server (`deciduous mcp`) exposes 31 tools over the Model
Context Protocol. Works with Claude Code, Claude Desktop, and cowork.
- Graph CRUD, querying, full-text search, chain tracing
- Session management: each conversation gets its own decision tree
- Sessions persist across server restarts for long-running cowork
- /query slash command for natural language decision graph reports
- Full docs at deciduous.dev/mcp with API reference
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
bfb6947
implement MCP server stuff
c96a2c4
update docs, site, etc with MCP info
+500-1
notactuallytreyanastasio/blimp/main
May 01 11:26
b7e10a5
Merge tutorial/ch07-clock: Chapter 7 ("The Clock")
A logical Clock actor (callers advance via :tick) plus a
BikeShare.Rider extended with pickup_at and an :elapsed handler.
The chapter argues for logical clocks over now() for both
testability and WASM compatibility (now() in the WASM build is
stubbed to 0). Solution passes 7/7 in CLI and WASM.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
91f7dfd
feat(tutorial): chapter 7 -- The Clock
Adds 07-clock.md and the ch07_clock exercise. A simple Clock
actor with one Int field that callers advance via :tick. The
BikeShare.Rider from Chapter 6 grows pickup_at and a guarded
:elapsed handler that reports how long the rider has had the bike.
The chapter explains why the clock is logical (callers send :tick)
rather than wall-clock: WASM's now() returns 0, and even a working
wall clock would make tests flake. Pattern is the same one used
by Erlang/OTP and most distributed systems for testable time.
Three TODOs:
- Clock's :tick (the canonical "increment counter, reply new value"
shape from earlier chapters)
- Rider's guarded :pickup, now threaded with a Clock arg, capturing
the pickup time into pickup_at via a multi-field become whose
right-hand side is a `clock <- :now` send
- Rider's guarded :elapsed, computing (clock <- :now) - pickup_at
Solution passes 7/7 in CLI and WASM. Stub Exercise hints are
prose-only; no commented-out answer code under any TODO.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+26-35
notactuallytreyanastasio/blimp/main
May 01 04:29
11006e2
Merge stubs/no-answer-comments: stubs no longer ship the answer
ch4/5/6 exercise stubs had Exercise hints with the literal
solution lines commented out underneath, which defeated the prose
rewrite from the previous merge. Hints are now prose-only.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ee19920
docs(exercises): replace commented-out answers with prose hints
The TODO comments in ch4/ch5/ch6 stubs had the answer code
commented out underneath, which is exactly the copy-paste shape
the prose rewrite was meant to remove. Each Exercise: hint is
now a prose description of what the handler should do, with no
literal lines the reader can uncomment.
Stubs still parse, solutions still pass.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+492-1
notactuallytreyanastasio/blimp/main
May 01 01:45
3ce6a62
feat(tutorial): chapter 6 -- The Rider
Adds 06-rider.md and the ch06_rider exercise. Introduces a
BikeShare.Rider actor that holds one user's session: name and a
Bike slot that's nil when idle.
New language ground:
- nil as a meaningful state value
- == nil and != nil guards on multi-clause handlers
- the pre-flight check pattern (send to downstream, dispatch on
the reply, only commit your own state if downstream confirmed)
Three TODO handlers; the multi-clause :pickup and :return get
their fallback clauses pre-wired so the reader's work is the
guarded "do the thing" clauses. The rider also lives at
BikeShare.Rider so each instance is its own supervision boundary
under the same prefix as Vault and Inventory from chapter 5.
Solution passes 7/7 in CLI and WASM.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
6b1ee2b
Merge tutorial/ch06-rider: Chapter 6 ("The Rider")
A BikeShare.Rider actor with a Bike-or-nil session slot. New ground
is nil as a state value, == nil / != nil guards, and the pre-flight
check pattern (ask the bike before committing the rider's own
state). Each rider lives at BikeShare.Rider so it inherits the
supervision boundary from chapter 5. Solution passes 7/7.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+199-243
notactuallytreyanastasio/blimp/main
May 01 01:11
0373af8
Merge tutorial/parallel-examples: ch3-5 steps no longer copy-paste
Each "Step N: fill in X" section now shows the language pieces as
small parallel patterns and asks the reader to compose the actual
handler, rather than leading with the exact answer in a code block.
"Putting it together" recap blocks removed; standalone concept
sections that overlapped with the new step content folded into the
steps themselves.
No code changes; solutions still pass.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
7987591
docs(tutorial): rewrite ch3-5 step sections with parallel examples
The "Step N: fill in X" sections used to lead with the exact answer
in a code block, then walk through it line by line. That made the
exercises a copy-paste rather than a synthesis, and the "Putting it
together" recap blocks doubled the answer count.
New shape: each step shows the language pieces in small parallel
patterns (a Counter that takes a typed arg, a Stack that pops the
head, an integer-list reduce, a divide-by-zero bubbler) and asks
the reader to compose the actual handler from those parts. The
exercise file's solution stays the canonical assembled answer.
Also folded the standalone "Sending messages from inside a handler"
section in ch3 and "Sending into a closure" section in ch4 into the
steps that needed the concept, since they were duplicating ground
the steps now cover with their own parallel snippets.
No code changes; solutions still pass 8/7/5 in CLI and WASM.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+562-1
notactuallytreyanastasio/blimp/main
Apr 29 18:02
b138476
Merge tutorial/ch05-supervision: Chapter 5 ("The supervision tree")
Introduces bubble / orelse / bubbles(CascadeBubble) and the dotted-name
supervision tree. Exercise wires a BikeShare parent to a Vault and an
Inventory; the vault bubbles on overdraw, the parent translates the
bubble into a tagged tuple, and an :emergency handler cascades a reset
across every BikeShare.* sibling at once. Solution passes 5/5 in CLI
and WASM.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ea72016
feat(tutorial): chapter 5 -- The supervision tree
Adds 05-supervision.md and the ch05_supervision exercise.
Introduces three new pieces of language ground:
- bubble :reason raises a failure that propagates as a value
- target <- :msg orelse X catches a bubble at the call site
- bubbles(CascadeBubble) handler annotation: when this handler bubbles,
restart every dotted-name sibling under the
same supervisor prefix
The exercise builds three cooperating actors: a BikeShare.Vault that
holds cents, a BikeShare.Inventory that holds a bike count, and a
BikeShare parent that wires them together. Three TODOs:
- :withdraw bubbles :overdraw on insufficient funds
- :charge translates the bubble into {:error, :declined} via orelse
- :corruption is annotated bubbles(CascadeBubble) so a panic resets
every BikeShare.* sibling
Solution passes 5/5 in the CLI and in the tutorial WASM evaluator.
The chapter walks through bubble vs. tagged tuple as a design choice
(state preserved vs. erased), the dotted-name supervision boundary,
and the bulkhead pattern of unrelated supervisor prefixes never
cascading into each other.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+31-5
notactuallytreyanastasio/blimp/main
Apr 29 17:50
19809f3
fix(ws): use the correct RFC 6455 magic GUID for Sec-WebSocket-Accept
The handshake constant in builtins.zig had the magic GUID's hex
digits scrambled:
258EAFA5-E914-47DA-95CA-5AB9DC80CB65 (wrong)
258EAFA5-E914-47DA-95CA-C5AB0DC85B11 (RFC 6455 §1.3)
curl doesn't validate Sec-WebSocket-Accept against the locally
computed expected value, so handshakes from curl saw the 101 and
the WS frames started flowing -- the chat *looked* like it worked.
Real browsers do validate, and rejected every connection with
"Incorrect 'Sec-WebSocket-Accept' header value", which is why
Enter on the chat input never actually delivered: the WS was never
open, the form fell through to its HTTP POST fallback, and the
page reloaded.
Fixes the GUID, fixes the test that was calibrated to match the
bug (it now expects the RFC 6455 example value
"s3pPLMBiTxaQ9kYGzzhZRbK+xOo=" for key "dGhlIHNhbXBsZSBub25jZQ=="),
and adds a deploy snippet to infra/README.md for rebuilding and
shipping the chat interpreter.
Verified end to end on the live box: handshake response now
matches the RFC value, and a headless-Chrome session through
https://blimp.bobbby.online/chat/ logs in, types a message, hits
Enter, and sees the message broadcast back via WebSocket without a
page reload.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1949b0c
Merge chat/fix-ws-handshake: WebSocket handshake now follows RFC 6455
The ws_accept_key builtin was using a corrupted magic GUID, which
curl's loose handshake check let slide but every real browser
correctly rejected. Fixes the constant, fixes the test that was
calibrated to the bug, and documents the rebuild/redeploy steps
for the chat interpreter in infra/README.md.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+110-11
notactuallytreyanastasio/blimp/main
Apr 29 17:38
9228098
chat: serve at blimp.bobbby.online/chat/ via Caddy reverse proxy
Three changes to chat.blimp so it works behind a path-stripping
proxy:
- Form actions become relative ('/login' -> 'login', '/send' ->
'send') so they resolve against whatever URL the page is at.
- Redirects use './' so the browser stays under the /chat/ prefix
instead of jumping to root.
- The WebSocket URL is now built from window.location, including
protocol (wss when the page is HTTPS) and the current pathname
prefix.
Also adds infra/Caddyfile + infra/README.md, which are the live
contents of /opt/blog/Caddyfile on the Hetzner box. The
blimp.bobbby.online block now redirects bare /chat -> /chat/ and
reverse-proxies /chat/* to 172.18.0.1:8080 (the blog_default
docker-bridge gateway, where the blimp-chat systemd service is
listening on the host's 0.0.0.0:8080).
Verified end-to-end: GET /chat/ serves the login HTML, POST
/chat/login redirects with a session cookie, GET /chat/ws does
the WebSocket upgrade and immediately receives the broadcast
frame.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
337d1f2
Merge chat/path-aware: chat lives at blimp.bobbby.online/chat/
chat.blimp uses relative URLs (form actions, WebSocket, 302
redirects) so it works behind a path-stripping reverse proxy.
Caddy on the Hetzner box now proxies /chat/* on blimp.bobbby.online
to 172.18.0.1:8080, where the blimp-chat systemd service is
listening. Adds infra/Caddyfile + infra/README.md so the proxy
config is tracked alongside the source.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+498-4
notactuallytreyanastasio/blimp/main
Apr 29 17:25
01f1408
feat(tutorial): chapter 4 -- Zoom out
Adds 04-zoom-out.md and the ch04_zoom_out exercise. Introduces
anonymous functions (`fn(x: T) do ... end`) and the three list
builtins that take them as arguments: map, filter, reduce. The
chapter's exercise builds a `BikeShare` actor that holds a list of
`Station` references and fans questions (total bike count, names of
busy stations) out to all of them via map / filter / reduce.
Three TODO handlers (`:open`, `:total_bikes`, `:busy_stations`).
Solution passes 7/7 in CLI and in WASM.
The original ch4 roadmap said "supervision tree, dotted names, zoom
out". This chapter takes the "zoom out" half of that and ch5 will
take supervision + dotted names. Updated 00-why-actors.md's roadmap
to reflect the split, and updated the ch5 placeholder title in the
SPA chapter list.
Implementation note: at this zoom level Stations track bikes by an
integer counter rather than by holding [Bike] actor references. A
runtime hang shows up when actor refs are passed as typed message
args into actors that later get iterated by a parent's
closure-send; we work around it here, will revisit alongside ch5.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
4a74600
Merge tutorial/ch04-zoom-out: Chapter 4 ("Zoom out")
Anonymous functions, map/filter/reduce, and a `BikeShare` parent
actor that fans questions out to a list of `Station` children.
Seven tests; solution passes in CLI and WASM.
Splits the original ch4/ch5 roadmap: ch4 takes "zoom out", ch5
takes the supervision tree + dotted names + crash isolation
material, including a runtime hang to fix where actor refs passed
as typed args interact badly with closure iteration.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+87-16
notactuallytreyanastasio/blimp/main
Apr 28 03:19
b541da3
docs: add self-hosting narrative to README, deslop pass
Full story of the bootstrap: prerequisites, lexer, parser, evaluator,
closing the loop, bugs found, what came after. Deslopped: cut "the
language eating itself", "fell into place fast", dramatic fragment
openers.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
+147-116
notactuallytreyanastasio/blimp/main
Apr 28 03:11
f0aee23
docs: rewrite README from scratch using decision graph
Self-hosted compiler is the lead story. Shows the actual compiler.blimp
pipeline. Fixes chat.blimp line count (706, not 23k). Adds concurrent
server, safe strings, property tests, LTO benchmarks. Drops the old
Zig-focused implementation table.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
+30-15
notactuallytreyanastasio/blimp/main
Apr 28 03:07
e169732
docs: README reflects self-hosted compiler, Zig is bootstrap
Blimp compiles Blimp. The self-hosted compiler (lexer, parser,
evaluator, codegen, stdlib) lives in chunks/lang/lib/. The Zig code
is the bootstrap that gets it off the ground.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
+18-22
notactuallytreyanastasio/blimp/main
Apr 28 03:03
5f4e961
docs: fix README accuracy -- real line counts, remove stale screenshots
Zig line counts were from months ago. Updated to actual wc -l output.
Clarified C is just the 846-line native runtime, everything else is Zig.
Removed outdated playground and REPL screenshots.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
+130-230
notactuallytreyanastasio/blimp/main
Apr 27 13:02
5986e8a
docs: rewrite README with current project state
Update examples, line counts, WASM size, add tutorial and tree-sitter
links, restructure around key ideas rather than syntax reference.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
+1091-0
notactuallytreyanastasio/blimp/main
Apr 27 12:58
fdf9e89
add db
+57-57
notactuallytreyanastasio/blimp/main
Apr 26 01:43
9ff6564
docs(tutorial): backtick actor / type names in ch1-3 prose
Sweeps the tutorial chapters so identifiers (Bike, DockingStation,
String, status, id) render monospaced wherever they appear in prose,
not just inside fenced code blocks. Headings get the same treatment
("The shape of a Bike" -> "The shape of a `Bike`"). Code blocks and
already-backticked spans untouched.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+751-56
notactuallytreyanastasio/blimp/main
Apr 26 01:12
ab2b6bb
feat(tutorial): chapter 3 -- Actors talking to actors
Adds 03-actors-talking.md and the ch03_actors exercise (stub +
solution). Introduces a DockingStation actor that holds a list of
Bike references and orchestrates rentals: list-typed state, the
cons / head / tail / length pattern, typed message arguments
((b: Bike)), and sending messages to other actors from inside a
handler. Exercise has 8 tests; the solution passes all 8 in the CLI.
Wires ch03 into the SPA's chapter list so the tutorial picks up the
new markdown, stub, and solution files automatically.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
4a5caa8
feat(tutorial): replace textarea editor with Monaco
Drops Monaco (v0.46.0 from jsdelivr) into docs/tutorial/index.html in
place of the layered textarea + <pre> highlight overlay. Registers a
`blimp` Monarch grammar mirroring blimp-highlight.js (same keywords,
constants, builtins, atoms, #{} interpolation, PascalCase types) and a
`blimp-dark` theme matching the existing token colors so highlighting
stays visually consistent with the static code blocks rendered in the
middle pane.
Cmd/Ctrl+Enter is now a Monaco command bound to Run Tests. The cheat
tab and rendered markdown blocks keep using blimp-highlight.js (small,
sync, no behavioral change). Boot does Promise.all([blimp.init,
initMonaco]) before loading the first chapter.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
39c1a3c
Merge tutorial/ch03-stations: Monaco editor + Chapter 3
Two coherent changes shipped together:
1. Replace the textarea editor in the tutorial SPA with Monaco
(v0.46.0), with a Blimp Monarch grammar and a dark theme that
mirrors blimp-highlight.js. Cmd/Ctrl+Enter runs tests via a
Monaco command. Cheat tab and rendered-markdown code blocks
keep using blimp-highlight.js.
2. Chapter 3 -- "Actors talking to actors". Introduces the
DockingStation actor that holds a list of Bike references and
orchestrates rentals. New language ground: list-typed state
([Bike]), cons / head / tail / length, typed message arguments
((b: Bike)), and sending messages from inside a handler.
Includes 03-actors-talking.md plus stub + 8/8-passing solution
under exercises/ch03_actors/.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+2111-1451
notactuallytreyanastasio/blimp/main
Apr 24 21:00
d939fdf
feat(tutorial): SPA with embedded REPL, test runner, and Blimp highlighter
Adds docs/tutorial/index.html, a single-page tutorial viewer. Three-pane
layout: chapter rail on the left, rendered markdown in the middle,
interactive REPL pane on the right. URL fragment (#ch00, #ch01, etc)
drives chapter navigation, fetches the chapter's markdown, loads the
matching exercise stub into the editor, and runs the reader's code
against the WASM-compiled Blimp runtime via the new `runTests()`
binding. Failures show up inline with structural detail captured from
the assertion builtin. "Cheat" tab fetches the solution .blimp file
from disk and highlights it; "Copy to editor" paves over the stub.
Also adds blimp-highlight.js, a zero-dependency syntax highlighter for
Blimp. Keyword list is derived from chunks/lang/tree-sitter-blimp/
grammar.js plus Zig-parser extras (test, property, given, if, else) so
it stays in sync with the real grammar. Handles string interpolation
(#{...}), atoms, numbers, operators, keywords, builtins, and type-like
capitalized identifiers. Used for code blocks in rendered chapter
markdown, the live editor textarea (layered <pre> overlay with scroll
sync), and the cheat-view solution display.
exercises/ lives at the repo root so CLI users can run `blimp test
exercises/...`. For the web tutorial, docs/tutorial/exercises is a
symlink to ../../exercises so the SPA fetches work from a single path
both locally and in production; deploy.sh follows the symlink via
rsync -L.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
00f8e54
feat(tutorial): bike share tutorial chapters 0-2 and first exercises
Builds a TDD-driven Blimp tutorial that teaches the actor model by
constructing a bike share simulation one actor at a time. Twelve
chapters planned total; this commit lands the first three:
- Chapter 0: why actors, the dispatcher-with-clipboard mental model,
functional core / imperative shell as the organizing philosophy,
and the piecemeal progression the rest of the chapters follow.
- Chapter 1: your first actor. A Bike with id and status, four
handlers filled in one at a time. Walks through actor templates,
state defaults, the `::` assignment operator, atoms as interned
symbols, spawn-with-overrides, the `<-` send operator, and why
`become` exists (Hewitt's original actor primitive, not mutation).
- Chapter 2: state, become, and the free lock. Multi-clause handlers
with guards, tagged `{:ok, ...}` and `{:error, ...}` tuples, a third
`:broken` state that drops in without any type edits, and the
punchline of the chapter: why an actor's mailbox plus "handlers
run to completion" gives you mutual exclusion without any locks.
Each chapter has a matching exercise file in exercises/chNN_topic/
with a stub the reader fills in, failing tests that progressively
go green, and a reference solution in solutions/.
Voice: one-sentence-per-line markdown, no em-dashes, piecemeal
concept-then-exercise flow, design decisions traced back to the
deciduous graph and docs/lang_design/ where they were made.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
9a4e116
feat(chat): poll-based server loop, read WS frames end-to-end
Replace the blocking accept_loop with a poll-based loop that watches
[server_fd | all_ws_fds]. When a WS fd is ready, read one frame and
route {"type":"msg","from":..,"text":..} to the room, then broadcast.
HTTP POST /send path preserved as a fallback for WS-less clients.
Also fixes extract_quoted's off-by-one: Blimp evaluates args such that
char_at(s, idx) in a call alongside idx+1 sees the post-incremented
idx. Compute char_at into a local first. Same pattern may need the
same treatment wherever it appears (json_escape_loop, slice_idx);
not swept in this commit.
TODO: step 3 of the bidirectional-WS plan still has 'from' coming
from the client frame instead of a server-side session lookup.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
9d20b71
Merge lang/ws-bidirectional: WASM test runner, bike share tutorial, SPA, deploy fix
# Conflicts:
# deploy.sh
79aad67
chore: remove old blog tutorial.html
The old interactive browser tutorial at docs/blog/tutorial.html is
replaced by the new bike-share tutorial under docs/tutorial/. No
incoming links remain from blog/index.html or the manifesto.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
90a90fd
docs: scrub 'Ruby's skin, Elixir's soul' phrase
Removes the pithy motto from the three places it appeared (the core
language feel design doc, the parser design doc, and the manifesto)
and replaces each with a direct description of what the phrase meant:
Blimp's surface syntax is Ruby-flavored (do/end, optional parens,
readable sentences) and the data model is Elixir-flavored (immutable
values, pattern matching, pipes, atoms). Same content, no marketing
motto.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
ebf44cb
chore(deploy): point rsync at /opt/blimp and follow symlinks
The Caddy container (blog-caddy-1 on the Hetzner box) mounts
/opt/blimp:/srv/blimp:ro, which means the host path Caddy actually
reads from is /opt/blimp. The old deploy.sh rsynced to /srv/blimp on
the host, which the Caddy container never saw, so content looked like
it was transferring successfully but 404'd at blimp.bobbby.online.
Fixes the DEPLOY_DIR to /opt/blimp and adds -L to the rsync flags so
the docs/tutorial/exercises symlink gets followed and the real .blimp
files end up on the server.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
00efd1a
feat(lang): blimp_run_tests WASM export + structured test reports
Adds a `blimp_run_tests(source_ptr, source_len)` export to the WASM API
that parses source, runs every `test` block found in actors, and emits a
JSON report with per-test pass/fail plus the expected/actual detail
captured from any failing assertion. Assertion builtins now write to a
shared `last_assertion_detail` buffer on failure so the runner can
attach a readable error to each failing test.
Also fixes three pre-existing `usize`/`u64` mismatches in builtins.zig
that were blocking wasm32 builds under current Zig, and adds a
design doc at docs/lang_design/test-framework.md that lays out what a
first-class Blimp test framework should grow into (watch mode,
structural diffs, source lines on failure, property shrinking).
The browser-embeddable interpreter at docs/blog/repl/blimp.js gets a
new `runTests(source)` method that wraps the export and returns
`{ok, total, passed, failed, tests: [...]}`. Used by the tutorial SPA
to give readers red/green feedback inline.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
+1599-14850
notactuallytreyanastasio/blimp/main
Apr 24 19:10
8bfe1a3
infra: deploy blimp docs to /opt/blimp (#21)
* V1 of the new terminal UI
* attempt to get a faster commit dialogue and make Follow mode work
* feat: C++/Notcurses diff viewer -- Phase 1 scaffold
Port blimp_diff from Rust/Ratatui to C++20/Notcurses for direct cell
manipulation and zero widget-tree allocation per frame.
Architecture (mirrors the Rust version):
- git/: Runner (popen), status/diff/log parsers, file watcher
- state/: Navigation, Interaction (mode + action mapping), CommitState,
LineSelection, FileState classifier
- ui/: Renderer with direct ncplane cell writes, file list, diff pane
with gutter + colored lines, status bar, commit overlay, 4 themes
(solarized dark/light, monokai dark/light)
Performance:
- Async refresh: watcher-triggered git calls run in background thread
via std::async, polled non-blocking each frame. Navigation is pure
index math against cached data -- zero git calls on j/k
- All untracked file diffs pre-cached on refresh
- Input: 16ms poll timeout, drain all pending events before render,
filter NCTYPE_RELEASE to prevent double-skip
Terminal hygiene:
- Clean shutdown: watcher thread joined before notcurses teardown,
stdin drained in raw mode to eat in-flight escape responses,
explicit reset sequences for mouse/kitty keyboard/bracketed paste
- US keyboard shift map for kitty keyboard protocol (Shift+= gives +)
Commit overlay supports multi-line bodies (Enter = newline,
Ctrl+Enter = submit). 54 unit tests covering all parsers, state
machines, navigation, selection, and file state classification.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* feat: Phase 2 -- syntax highlighting, follow mode, log view
Syntax highlighting:
- Built-in regex tokenizer (no external deps) covering keywords,
strings, comments, numbers, operators, types (CamelCase), functions
- Language detection from extension (C/C++, Rust, Python, JS/TS, Go,
Ruby, Elixir, Zig, Shell, Lua, Java, C#, CSS, HTML, YAML, TOML, JSON)
- Per-language keyword sets with theme-derived colors
- DiffCache pre-renders highlighted spans once per file switch;
frame rendering just reads the cache. 50k line cap for huge files.
Follow mode:
- apply_refresh() detects changed files and calls follow_jump()
- Watcher-triggered async refresh auto-scrolls to changed file
Log view:
- Renders actual git log entries with colored hash + message
- Virtual scroll with selected-item highlight, j/k nav, q to return
Diff pane rewritten to consume DiffCache spans via batched
ncplane_putstr_yx (one call per span, not per character).
Renderer signature updated to pass DiffCache and log entries.
14 new highlight tests (68 total, all green).
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: notcurses guide audit -- signal handling, resize, perf
Informed by reading Nick Black's "Hacking the Planet with Notcurses"
cover to cover and building a 90-node deciduous knowledge graph.
Signal handling:
- NCOPTION_NO_QUIT_SIGHANDLERS disables notcurses' own handlers
(they race with our cleanup)
- Own sigint_handler sets atomic flag, event loop exits cleanly
- Terminal state saved with tcgetattr BEFORE notcurses_init,
force-restored with tcsetattr(TCSAFLUSH) AFTER notcurses_stop
- Stdin drained in raw mode to eat in-flight escape sequences
Resize:
- NCKEY_RESIZE now handled: clears diff cache, re-queries dims
- Ctrl+L calls notcurses_refresh() for full screen redraw
Performance:
- hline() uses ncplane_hline (one call, not per-cell loop)
- vline() uses ncplane_vline (one call, not per-cell loop)
- fill_rect() uses ncplane_hline per row with shared nccell
- ncplane_erase() for full-screen clear
Init:
- setlocale(LC_ALL, "") in main() -- mandatory per notcurses docs
68 tests green.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* refactor: commit overlay as its own ncplane
Per the notcurses guide (Ch5/Ch14 tetris architecture), modal overlays
should be separate planes composited by notcurses, not painted directly
onto the standard plane. This means the background content is preserved
and doesn't need full re-rendering when the overlay is dismissed.
- create_overlay_plane() creates a child plane of stdplane, centered,
sized to 60%x40% of terminal. Named "commit-overlay".
- show_overlay()/hide_overlay() manage the plane lifecycle
- Overlay created on cc chord and amend ('a'), destroyed on cancel
(Esc) and successful commit
- NCKEY_RESIZE destroys and recreates the overlay at new size
- Overlay coordinates are now relative to its own plane (0,0), not
the terminal -- cleaner rendering code
- Shutdown path destroys overlay before notcurses_stop()
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* feat: visual select → Claude agent seam
Select diff lines, ask Claude a question, get a streaming response
in a full-screen agent tab.
Flow:
- v in diff view: enter visual selection mode (j/k to extend)
- Enter in selection: captures selected lines, opens agent prompt
overlay where you type your question
- Ctrl+Enter: spawns claude --no-input as a persistent subprocess
with pipes, sends initial prompt (selected code + question),
switches to full-screen AgentView tab
- AgentView: streams response with auto-scroll, j/k to scroll,
Tab to flip back to diff (agent keeps running), Esc to dismiss
- g from file list or diff view: switch to agent tab
Architecture:
- AgentState manages the subprocess lifecycle (fork/exec/pipes),
reader thread for non-blocking stdout consumption, mutex-guarded
response buffer. Supports send_followup() for ongoing conversation.
- AgentView is a full-screen mode (like log view), not an overlay
- Agent prompt reuses the overlay plane system
- extract_selected_lines() reconstructs +/- prefixed text from
the DiffCache spans
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: eliminate large-file freeze with lazy per-frame highlighting
The old DiffCache pre-highlighted every line of the entire diff on
file switch. For large files (1000+ lines), the tokenizer blocked
the event loop for hundreds of milliseconds, freezing the UI.
New approach: DiffCache stores lightweight CachedLines with raw text
only (no Span vectors). The diff pane renderer calls highlight_line()
on the fly for just the ~40-50 visible lines per frame. Switching
files is now O(n) string copies with no tokenization -- effectively
instant even for 50k-line diffs.
Scrolling is pure index math. Highlighting cost is bounded by
visible_height * tokenizer_cost_per_line, which is ~50 microseconds
total per frame on a typical terminal.
Side benefit: theme cycling no longer needs to invalidate the cache
since highlighting derives colors from the current theme each frame.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: replace std::regex with manual parser, async initial load
Root cause of large-file freeze: std::regex_search() was called on
EVERY line of diff output to check for hunk headers. libc++ regex
is notoriously slow -- for 5837 lines (not_curses.txt), thousands
of failed regex matches dominated parse time.
Fix: manual parse_hunk_header() using strtol(). Only called when
line starts with "@@" (fast 2-byte prefix check). Regex removed
entirely from the diff parser.
Also: initial data load is now async (refresh_async instead of
refresh_sync). UI appears immediately while git commands run in
the background. Previously the app would freeze for seconds on
startup in repos with large untracked files.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: double Ctrl+C force-exits, lazy untracked diffs, no pre-diffing
Three fixes for the freeze-and-can't-exit problem:
1. Signal handler now force-exits on SECOND Ctrl+C: first sets the
atomic flag (polite), second calls notcurses_stop + tcsetattr +
_exit directly (nuclear). This guarantees escape even when
notcurses_render() is blocked writing to a slow terminal.
2. Removed pre-diffing of ALL untracked files in build_refresh().
git diff --no-index on large untracked files (5837-line
not_curses.txt) was blocking the background thread for seconds.
Untracked diffs are now fetched lazily only when the user
navigates to that specific file.
3. Global notcurses pointer + saved termios for signal handler
emergency cleanup path.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: stop full-screen erase every frame, use notcurses damage tracking
ROOT CAUSE of scroll freeze: ncplane_erase() was called every frame,
marking ALL ~10,000 cells as damaged. notcurses_render() then emitted
escape sequences for every cell, even unchanged ones. Switching from
a 5-line diff to a 455-line diff meant ~8000 RGB color changes at
~14 bytes each = ~112KB of escape sequences in one frame.
Fix: only erase on mode transitions, resize, theme change, or data
refresh (needs_full_redraw_ flag). Normal j/k navigation in the file
list just overwrites the visible rows -- each pane fills its own
area via hline(). Notcurses damage tracking now properly skips
unchanged cells between frames.
Added switch_mode() helper that sets both the mode and the dirty
flag, replacing 17 direct set_mode() calls.
This is the optimization the notcurses guide (Ch4.3) describes:
"Subsequent to the first call, screen updates will write only to
changed (damaged) cells" -- but only if you don't erase them first.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: infinite loop in syntax highlighter on # character
ROOT CAUSE of the scroll freeze. The tokenizer had an infinite loop:
for Rust files, # (used in #[derive], #![...] attributes) was not
handled by any branch. The "everything else" fallback loop stopped
at # but didn't advance i. The outer while loop restarted with the
same i, checking the same character forever.
The file causing the freeze was app.rs (+455 lines) -- every line
with a # attribute spun the tokenizer infinitely.
Fix:
1. Added explicit # handler: for C/C++/C# it's preprocessor (rest
of line). For Rust it consumes #[...] or #![...] as keywords.
For Python/Ruby/etc it was already caught by is_comment_start.
2. The "everything else" fallback now ALWAYS advances i by at least
1 before entering its while loop. This is a safety net -- no
character can ever cause an infinite loop regardless of language.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: commit overlay now opaque -- set base cell bg before erase
The overlay plane was transparent because ncplane_erase() fills cells
with the base cell, not the active fg/bg. The base cell defaulted to
no explicit background, so the diff pane bled through underneath.
Fix: set the overlay plane's base cell to the theme bg_selected color
with NCALPHA_OPAQUE before erasing. Now the overlay fully covers the
content underneath, as the notcurses guide (Ch8) describes: "the base
cell is rendered wherever the plane's gcluster is 0."
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* Commit rust stuff so its here for reference while we do C++ impl
* fix: segfault from infinite recursion in switch_mode, shell quoting
Two bugs:
1. SEGFAULT: switch_mode() called itself instead of
interaction_.set_mode(). The replace-all of set_mode→switch_mode
caught the call INSIDE switch_mode's own body, creating infinite
recursion → stack overflow → segfault on any mode transition.
2. SHELL INJECTION: runner's arg quoting only triggered on
spaces/quotes. Commit messages with newlines, $, backticks etc
could break or be interpreted by the shell. Now ALL args are
unconditionally single-quoted.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* add useless file
* test: comprehensive test suite -- 68 → 200 tests
132 new tests covering every module with edge cases and integration
tests using real git repositories.
Parser edge cases (26 new):
- Status: deleted, MM, spaces in paths, empty lines, renamed+modified
- Diff: no-newline marker, new/deleted files, multi-file, count=1
hunks, very long lines, --no-index format, function context headers
- Log: special chars, unicode, long messages, full-length hashes
Highlight edge cases (20 new):
- Rust #[derive] attributes, lifetimes ('a)
- Go/Elixir/Ruby keywords and comments
- Nested/escaped/empty strings, operators-only, whitespace-only
- 1200-char lines, C preprocessor, hex/binary/float numbers
- Function call and CamelCase type detection
- Language detection for all supported extensions
State machine edge cases (51 new):
- Navigation: empty lists, bounds clamping, scroll extremes, hunk/log
boundaries, follow jump with/without mode, divider extremes
- Interaction: all DiffView/Selecting/AgentView key mappings, cc chord
timing (within/after 400ms, c+different key), shift non-interference
- Commit: double submit, insert-after-cancel, error→retry, long
messages, newlines-only, idle no-ops
- Selection: single-point, range-after-clear, extend-without-start,
multiple extends, empty-contains
- FileState: None/None fallback, already-staged/unstaged nullopts,
command arg verification
Git integration tests (17 new):
- Real temp repos via mkdtemp + git init with RAII cleanup
- Runner: status/diff/commit/log/stage/unstage round-trips
- E2E: runner → parser → DiffCache → FileState classification
- Verifies actual git subprocess output parsing
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: black screen on startup -- switch back to sync initial load
The async initial load left repo_.files empty on the first frame,
rendering a blank dark screen until the background thread completed.
Switch back to refresh_sync() for the initial load so the UI has
data immediately. Subsequent watcher-triggered refreshes remain async.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* feat: kqueue-based file watcher replaces polling
The old watcher only checked .git/index and .git/HEAD mtimes, missing
all working tree changes (file edits, new files). Then it was changed
to poll git status every 600ms which was wasteful.
New watcher uses kqueue (macOS) to get instant filesystem notifications:
- Watches .git/index, .git/HEAD, .git/refs for git operations
- Watches working tree directories (up to 4 levels deep) for file edits
- Skips .git, build, target, node_modules, .deciduous
- kqueue EVFILT_VNODE with NOTE_WRITE|DELETE|RENAME|ATTRIB
- Debounces rapid changes (save-all) with configurable delay
- Drains accumulated events after debounce to coalesce
- Zero CPU when idle (blocked in kevent syscall, not polling)
File edits now trigger a refresh within ~200ms instead of never.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* feat: x to discard file changes, S to stash
x key (DiscardFile):
- Tracked files with unstaged changes: git checkout -- <path>
- Untracked files: deletes the file from disk
- No-op on clean files or staged-only files
S key (Stash):
- Runs git stash, refreshes immediately
- Status bar shows "Stashed" or "Stash failed"
Also added stash_pop() to runner for future use.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* simplify: u always runs git restore --staged
Replaced the branching unstage logic (rm --cached for new files,
restore --staged for others) with a single git restore --staged
call. Simpler and works for all staged files.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: crash on s/u/x -- reference to repo_.files after refresh
do_stage, do_unstage, and do_discard all referenced repo_.files[idx]
AFTER calling refresh_sync(), which replaces repo_.files entirely.
If the file list shrank (e.g., staging the last changed file), the
old index was out of bounds -> segfault.
Fix: copy the path (and any needed status fields) to local variables
before calling refresh_sync().
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* feat: split staged/unstaged diff display for partially staged files
When a file has both staged and unstaged changes (MS status), the
diff pane now shows them as separate sections with headers:
── Staged ──
@@ ... @@
(what will be committed)
── Unstaged ──
@@ ... @@
(working tree changes not yet staged)
Data model: replaced FileDiff with CombinedDiff which holds separate
staged and unstaged FileDiff structs. merge_diffs no longer blindly
concatenates hunks -- it preserves the distinction.
Section headers only appear when BOTH staged and unstaged exist for
the same file. Single-state files render normally without headers.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: kitty keyboard protocol garbage on quit
The execute: 3u[107;;107u... garbage after quitting was kitty keyboard
protocol responses arriving after the shell had already started
reading stdin. The terminal processes our disable sequence and sends
an acknowledgment, but it arrives too late.
Fix: send kitty keyboard + mouse disable sequences BEFORE
notcurses_stop(), wait 50ms for terminal to process them, drain
responses via notcurses_get, THEN tear down. Final 200ms raw-mode
drain (up from 100ms) catches any stragglers.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* feat: flash messages at top of diff pane, auto-clear after 2s
Status messages (Staged, Unstaged, Discarded, Stashed, etc.) now
appear as a highlighted bar at the top of the diff pane instead of
in the status bar where they covered keyboard shortcuts.
- set_flash() stores message + expiry timestamp (now + 2 seconds)
- active_flash() returns the message if not expired, empty otherwise
- Rendered as accent-colored bar spanning the diff pane width
- Auto-clears after 2 seconds with no manual dismissal needed
- Removed status_message_ field entirely
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: black lines between hunks -- fill entire row before gutter/content
Context lines between hunks appeared as black gaps because only the
content area was cleared with hline, but stale cells from previous
frames (before the no-full-erase optimization) persisted in the
gutter region. Now each diff line fills the entire row width with
line_bg first, then overwrites with gutter + content.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: selection highlight now clearly visible across all themes
Selection bg was nearly identical to the normal bg in all themes
(solarized dark: {7,54,66} vs bg {0,43,54} -- invisible difference).
New selection colors use a strong blue tint that's clearly distinct
from both the normal bg and the diff add/del backgrounds:
- Solarized Dark: {20, 70, 110} (dark blue)
- Solarized Light: {180, 210, 240} (light blue)
- Monokai Dark: {50, 70, 110} (dark blue)
- Monokai Light: {170, 200, 240} (light blue)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: follow mode bouncing, centered diff scroll, opaque agent overlay
Three fixes:
1. Follow mode no longer bounces between existing files. It now
compares old vs new file lists and only jumps when a genuinely
NEW file appears (wasn't in previous snapshot). Previously it
jumped to any non-selected file with a diff on every refresh.
2. Diff scroll now centers the cursor in the viewport. Added
diff_cursor_ separate from diff_scroll_ -- cursor moves with
j/k, scroll auto-adjusts to keep cursor at viewport midpoint.
Selection extends from cursor position, not scroll position.
3. Agent prompt overlay now opaque (same base cell fix as commit
overlay). Uses larger plane (80%x70% via create_agent_plane).
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: claude subprocess uses -p flag, cursor line visible in diff pane
Claude invocation:
- Replaced broken fork/exec with --no-input (flag doesn't exist)
with simple popen of 'claude -p'. Prompt written to temp file
and piped via cat to avoid shell escaping issues with code content.
- Simplified AgentState: removed fork/pipe/pid fields, uses
std::thread + popen instead.
Diff pane cursor:
- Cursor line now highlighted with bg_selected when diff pane is
focused (not during active selection to avoid confusion).
- Gutter background also highlights on cursor line.
- Cursor visible immediately on entering diff view, before any
selection starts.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: diff scroll/cursor resets when switching files
The centered-cursor scroll change introduced diff_cursor_ but never
reset it on file switch. Navigating between files in the file list
left the cursor at the previous file's position, making the diff
appear stuck or empty.
Added reset_diff_scroll() which zeroes cursor, scroll, and h_scroll.
Called in rebuild_diff_cache when the selected file changes. Also
reset cursor in follow_jump.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* fix: diff pane now actually focused when in DiffView mode
switch_mode was setting the interaction mode to DiffView but not
updating the active pane to Diff. The diff pane renderer checks
active_pane for the focused flag, which controls cursor visibility
and border color. Mode was DiffView (keys worked) but pane was
still FileList (cursor invisible, border dim).
Fix: switch_mode now auto-syncs active pane with mode:
- DiffView/Selecting → Pane::Diff
- FileList → Pane::FileList
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* finally scrolling right
* kill the diff viewing stuff with fire, we might as well just write a Zed
plugin for that!
* docs: add Blimp Chat code walkthrough
End-to-end walk through chunks/lang/web/chat.blimp: the four actors,
the accept loop, WS handshake, broadcast mechanism, JS client, and
the Zig TCP/WS primitives that back them.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
* infra: deploy blimp docs to /opt/blimp to match static-site convention
The Caddy container in ~/code/blog mounts /opt/<name>:/srv/<name>:ro
for deciduous, phstats, donny, and now blimp. Switching the rsync
target from /srv/blimp to /opt/blimp aligns with that pattern and
makes the deploy flow self-consistent.
Fixes the outage on blimp.bobbby.online that went unnoticed from
2026-04-05 until today -- a prior server-local Caddy hotfix pointing
at /srv/blimp was overwritten by a blog deploy, taking the subdomain
offline. The matching Caddyfile + docker-compose changes land in
~/code/blog.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
+532-14081
notactuallytreyanastasio/blog/main
Apr 24 17:34
4e0427c
Fix compiler warnings in PostLive.Index
- Add @impl true before mount/3, handle_info/2, handle_event/3, render/1
- Group all handle_event/3 clauses together (move modal/category handlers up)
- Unwrap {:ok, msg} tuple from Chat.save_message before accessing .id
- Remove dead {:error, _} branches from add_banned_word and check_for_banned_words
(both functions always return {:ok, _})
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
91c4262
fix: remove unreachable handle_format/7 clauses that matched on has_selection=true
The has_selection variable is always hardcoded to false in handle_event
("insert_format", ...), making all 12 clauses that pattern-match on true
in the 7th position dead code. Removed those clauses and simplified the
remaining ones to use _has_selection since only the no-selection path is
currently reachable.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Vibe Coding Rescue Missions
this mortal coil
are the buttons in the post editor just for show?
heya
it is katproto
Under-learning > Over-learning
Asking. Hacker News to Write For me
Anyone can post
Rat Kings Are Good Actually
Untitled
327 Years Of Tree Law In The Usa
A Genstage Tutorial And Reflection
Nathan Fielder
Whats My Schtick
Lets Write Letters
A Quick Typewriter Set Letter Project
I Pulled The Paul Tickets
A Fun Experiment
A Hilarious Shared Keyboard Key
A Me Museum
On Making A Link Blog
Building This Blog
Online (0)