chore: update changelog, improve navigation error handling, and adjust configuration files

Author: graffhyrum

.beads/.gitignore

@@ -10,6 +10,7 @@ sync-state.json
 last-touched
 .sync.lock
 export-state/
+.write.lock
 
 # Local version tracking
 .local_version

.changeset/config.json

@@ -1,5 +1,5 @@
 {
-	"$schema": "https://unpkg.com/@changesets/config@3.0.4/schema.json",
+	"$schema": "https://unpkg.com/@changesets/config@3.1.4/schema.json",
 	"changelog": "@changesets/cli/changelog",
 	"commit": false,
 	"fixed": [],

.cursorindexingignore

@@ -0,0 +1,3 @@
+
+# Don't index SpecStory auto-save files, but allow explicit context inclusion via @ references
+.specstory/**

CHANGELOG.md

@@ -41,14 +41,12 @@
 
 - b125efa: Add breadcrumb navigation component for multi-level page context (Home > Blog > Article Title)
 - d90e7c4: feat: add visual system design tokens for shadows, transitions, and easing
-
   - Define shadow presets (card, card-hover, heading, glow-green) in Tailwind v4 @theme block
   - Define transition duration scale (fast/normal/slow) and easing curves (default/in-out/spring)
   - Mirror tokens in tailwind.config.js extend for editor intellisense support
 
 - 74b4c32: Add Playwright-based WCAG AA contrast regression tests using axe-core. Tests 8 pages in both light and dark mode (16 test cases). Includes Playwright config, scoped tsconfig for Playwright types, and test:contrast npm script.
 - d6bd63b: refactor: deepen frontend architecture — extract utilities, fix bugs, consolidate components
-
   - Extract shared slug utility (toSlug) from 4 duplicated implementations, fixing a regex ordering bug in CollectionPageLayout
   - Consolidate 4 duplicate component pairs (Card, Skill, Skills, Navigation) into canonical locations
   - Merge HTMX attributes and active-page detection into Navigation (was missing from live site)
@@ -72,7 +70,6 @@
 - 741c97c: fix: resolve remaining WCAG AA contrast violations on 404 page in both light and dark modes
 - e2ffb40: fix: 404 page heading text contrast — ensure h2 "Page Not Found" uses gray-900/gray-100 for WCAG AA compliance in both light and dark modes
 - bc17a2c: fix(a11y): blog sort button and prose link contrast for WCAG AA
-
   - Sort button active state: `bg-green-600 text-white` (3.21:1) → `bg-green-800 text-green-50` (passes 4.5:1) in both light and dark modes
   - `.content a` prose links: `text-blue-300` in light mode (1.5:1 on bg-green-200) → `text-blue-700` (passes 4.5:1); dark mode stays `text-blue-300`
   - Closes pendragon-coding-we9: all 16 axe-core contrast audit tests pass across 8 pages × 2 modes
@@ -192,23 +189,20 @@
   Implemented a theme toggle component that allows users to switch between light and dark modes with a smooth sliding animation. The theme preference is persisted in localStorage and respects system preferences on first visit.
 
   **New Features:**
-
   - Theme toggle button with sliding animation positioned at the right edge of the header
   - Sun and moon icons that smoothly transition based on the selected theme
   - localStorage persistence to remember user's theme preference across sessions
   - System preference detection on first visit (respects `prefers-color-scheme`)
   - Smooth color transitions throughout the site when switching themes (300ms duration)
 
   **Improvements:**
-
   - Light mode uses a clean gray-50 background with dark text for improved readability during daytime
   - Dark mode maintains the existing green-950 background with light text optimized for low-light environments
   - Navigation underlines adapt to theme: green-600 in light mode, green-400 in dark mode
   - Footer links have theme-aware hover states for better visual feedback
   - Accessible implementation with proper ARIA attributes and keyboard focus states
 
   **Technical Details:**
-
   - Created ThemeToggle.astro component with inline script for theme management
   - Configured Tailwind CSS with class-based dark mode strategy
   - Added tailwind.config.js with dark mode enabled
@@ -220,14 +214,12 @@
 
 - e5e448b: Add Bun test runner tooling to the project. Includes test scripts in package.json (test, test:watch, test:coverage), example test file demonstrating Bun's test syntax, and updated documentation in CLAUDE.md with testing commands and conventions.
 - b090c8e: Add GitHub Action for opencode integration on issue comments
-
   - Add .github/workflows/opencode.yml to enable opencode AI assistance
   - Triggers on issue comments containing '/oc' or '/opencode' commands
   - Uses sst/opencode/github action with opencode/big-pickle model
   - Includes proper permissions for repository access
 
 - 201f90b: Migrate blog and testimonials to Astro Content Collections API
-
   - Create content config with Zod schemas for type safety
   - Move markdown files from pages to content directory
   - Standardize blog dates to ISO format
@@ -239,7 +231,6 @@
 
 - 930f48e: Add article on DORA metrics misuse to bookshelf
 - b090c8e: Refactor testimonials to use ContentSection component like myWork page
-
   - Convert testimonials from Astro Content Collections to static TypeScript data file
   - Update testimonials page to use ContentContainer and BaseLayout instead of CollectionPageLayout
   - Remove individual testimonial markdown files and dynamic routing
@@ -261,29 +252,25 @@
   This release introduces a modern navigation system using HTMX that provides a single-page application experience while maintaining progressive enhancement and SEO-friendly fallbacks.
 
   **New Features:**
-
   - HTMX-powered navigation that swaps content without full page reloads
   - Smooth transitions between pages using HTMX's built-in transition system
   - Browser history and URL preservation with `hx-push-url`
   - Seven new API endpoints (`/api/*.html`) returning HTML fragments for HTMX requests
   - Progressive enhancement: navigation works with and without JavaScript
 
   **Improvements:**
-
   - Fixed animation stutter by eliminating conflicting CSS animations during HTMX transitions
   - Added `noAnimation` prop system to Skills and Skill components for conditional animation control
   - Faster page navigation with reduced bandwidth usage (only content updates, not full page)
   - Maintained SEO compatibility with full-page fallbacks for search engine crawlers
 
   **Code Quality Refactors:**
-
   - Refactored Navigation component to use data-driven link array, reducing code from ~93 lines to ~38 lines
   - Extracted HTMX configuration into reusable constants for maintainability
   - Created ApiContentLayout wrapper to eliminate duplication across API endpoints
   - Improved code maintainability: adding/removing navigation links now requires only updating the data array
 
   **Technical Details:**
-
   - Navigation links use `hx-get`, `hx-target`, `hx-swap`, and `hx-push-url` attributes
   - Original page routes remain unchanged for direct access and SEO
   - API endpoints share components with full pages, ensuring consistency

docs/distillation-2026-05-11T17:24:06.md

@@ -7,6 +7,7 @@
 ## Applied Changes
 
 ### cm Rules (19 added)
+
 - **Rule**: Early-return paths with global constraints — assert on each path or unify before constraint
   **Source**: post-mortem-2026-03-31-blog-excerpt
   **Category**: typescript
@@ -66,6 +67,7 @@
   **Category**: general
 
 ### Skill Update Proposals
+
 - **Skill**: hook-authoring
   **Change**: Add guidance on TTY guard placement — guard must go in shared lib, not consumer; document that any function calling Bun.stdin.text() needs a TTY guard
 - **Skill**: testing-patterns
@@ -78,29 +80,29 @@
 ## Proposed Changes (Requires Confirmation)
 
 ### Hooks
-```json
-// Proposed: Changeset YAML quote enforcement hook
+
+```text
+// Proposed: Changeset YAML quote enforcement hook (illustrative — not JSON)
 // PostToolUse on Write, pattern match .changeset/*.md
 // Block with exit 2 if single-quoted package names found
 // Pattern: ^'[^']+': (patch|minor|major)
 { "event": "PostToolUse", "command": "changeset-quote-guard" }
 ```
 
 ### Hook Proposals
+
 - **Changeset YAML quote linter** — blocks `.changeset/*.md` writes containing single-quoted package names. Pattern: `^'[^']+': (patch|minor|major)`. Survives worktree isolation.
 - **Voice-dna banned phrase lint** (low priority) — scans `.md`/`.astro` files for phrases banned by docs/voice-dna.md (em dashes, "harness", negation framing)
 
 ### Infrastructure Proposals
+
 - **ralph.ts spike timeout override** — dispatch spike-label beads with 25-min timeout instead of default 15-min
 - **Add `bun audit` to vet script** or as separate `bun run security` script for periodic vulnerability scanning
 
 ## Deferred / Low Priority
 
-- **Word-boundary truncation** — blog excerpt truncates at exactly 200 chars, potentially mid-word. Tracked as bead.
-- **Setext heading stripping** — stripMarkdown only handles ATX headings, not underline-style. Low frequency in practice.
 - **Vite audit advisory resolution** — bun vet blocked by vite GHSA entries. Dep bump or overrides needed.
 - **j2u timeout investigation** — 404 page contrast bead consistently exceeds 15-min ralph limit. May need splitting.
-- **voice-dna lint hook** — nice-to-have automated banned phrase checker. Low priority.
 - **Acceptance criteria: sentinel inputs** — backlog item to standardize AC templates to cover empty string vs undefined explicitly.
 
 ## Patterns Worth Repeating
@@ -132,29 +134,31 @@
 
 ## Metrics Summary
 
-| Metric | Value |
-|--------|-------|
-| Post-mortems consumed | 13 |
-| cm rules applied | 19 |
-| Skills updated (proposed) | 4 |
-| Hooks proposed | 2 |
-| Items deferred | 6 |
+| Metric                    | Value |
+| ------------------------- | ----- |
+| Post-mortems consumed     | 13    |
+| cm rules applied          | 19    |
+| Skills updated (proposed) | 4     |
+| Hooks proposed            | 2     |
+| Items deferred            | 3     |
 
 ## Recommendation Token Impact
 
 ### Global Context (always-loaded instructions)
-| Metric | Tokens |
-|--------|--------|
-| Always-loaded baseline (pre-distillation) | ~3548 |
-| Net change from applied global rules | 0 (cm rules are not always-loaded) |
-| Post-distillation global estimate | ~3548 |
+
+| Metric                                    | Tokens                             |
+| ----------------------------------------- | ---------------------------------- |
+| Always-loaded baseline (pre-distillation) | ~3548                              |
+| Net change from applied global rules      | 0 (cm rules are not always-loaded) |
+| Post-distillation global estimate         | ~3548                              |
 
 ### Project Context (AGENTS.md)
-| Metric | Tokens |
-|--------|--------|
-| Net change from applied project rules | 0 |
 
-*Token estimation: word_count × 1.3. Baseline from Budget Snapshot step.*
+| Metric                                | Tokens |
+| ------------------------------------- | ------ |
+| Net change from applied project rules | 0      |
+
+_Token estimation:_ word count × 1.3. Baseline from Budget Snapshot step.
 
 ## Distilled Files
 

src/scripts/navigation.ts

@@ -129,7 +129,7 @@ function showErrorToast(message: string): void {
 	document.body.append(toast);
 
 	// Trigger reflow so CSS transition activates
-	const _ = toast.offsetHeight;
+	void toast.offsetHeight;
 	toast.classList.add('visible');
 
 	setTimeout(() => {