# BOB-Astro — Full LLM Context & Substrate Specification (llms-full.txt)

## 1. Project Overview & Architecture
- Framework: Astro 7.4.0 (Rust Sätteri compiler, Vite 8 engine).
- Styling: Tailwind CSS v4.3.3 (CSS-first engine via @theme in src/styles/global.css, zero legacy JS config).
- Edge Deployment: Cloudflare Pages (100% pure static HTML byte streams, zero runtime Workers in functions/, zero cold start, unlimited free tier bandwidth).
- Quota: Up to 20,000 pre-rendered static pages on Cloudflare free tier.
- Configuration: Single source of truth at src/config/site.config.ts (Strict Zero-Hardcoding policy).
- Color Model: Perceptual OKLCH color space with 6 mathematical presets (amber, emerald, cobalt, crimson, violet, paper).
- Motion Spine: Lenis 1.3 kinetic smooth scroll with 60fps RAF synchronization and prefers-reduced-motion fallback.

## 2. The 3 Golden Invariants for Autonomous Coding Agents
1. ZERO-HARDCODING POLICY: Never write raw hex colors (#...) or hardcoded brand copy inside components. Every token, SVG mark, string, and navigation link must derive from src/config/site.config.ts.
2. ZERO-WORKERS STATIC EDGE PURITY: Never create a functions/ directory or runtime Worker script. Every route must pre-render (export const prerender = true). public/_routes.json must contain "exclude": ["/*"] to ensure 100% static edge serving.
3. ZERO-DIAGNOSTIC COMPILER INTEGRITY: Every build must pass npm run check with 0 errors, 0 warnings, 0 hints, and satisfy all 10 verification gates in npm run test:static.

## 3. The 33 Production Craft Primitives (src/components/craft/)
1. SmoothScroll.astro: Lenis 1.3 kinetic smooth scroll spine with 60fps frame-synced RAF.
2. NoiseOverlay.astro: Procedural SVG fractal noise filter overlay (feTurbulence) adding tactile luxury grain.
3. SignatureCanvas.astro: Pointer-reactive mathematical phyllotaxis particle constellation (phi = 1.618) on HTML5 Canvas.
4. ThemePaletteSwitcher.astro: Client-side OKLCH palette switcher with 6 mathematical presets and zero layout shift.
5. CustomCursor.astro: Lerp-smoothed trailing halo ring with magnetic target scaling on fine pointers.
6. SpotlightCard.astro: Hardware-accelerated pointer radial spotlight card with specular border highlight.
7. TiltCard.astro: 3D perspective parallax tilt card with gyro and pointer reactivity.
8. TextScramble.astro: Matrix/cipher text decryption effect on scroll or hover with RAF updates.
9. CountUp.astro: Smooth cubic-bezier RAF metric counter with IntersectionObserver trigger.
10. BadgePill.astro: Live pulsing status indicator pill with customizable semantic variants.
11. TerminalWindow.astro: Tactical CLI code preview window with macOS traffic lights and copy-to-clipboard.
12. Accordion.astro: WCAG AAA accessible disclosures with animated CSS grid row interpolation.
13. BentoGrid.astro: Asymmetrical architectural bento grid layout with golden ratio proportions.
14. KineticMarquee.astro: GPU-accelerated infinite ticker running on pure translate3d CSS keyframes.
15. MagneticButton.astro: Physics-based cursor attraction with dynamic spring easing.
16. CommandPalette.astro: Universal Command-K fuzzy search dialog with arrow key navigation and route jumping.
17. ProgressiveBlur.astro: Apple-tier 6-step graduated backdrop-filter blur mask for luxury glass transitions.
18. MaskedReveal.astro: Accessible staggered word reveals through overflow masks with zero CLS.
19. ClipImageReveal.astro: Hardware-accelerated curtain and circular clip-path media reveals with scale parallax.
20. AudioHaptics.astro: Emil Kowalski synthesized Web Audio API micro-tones with zero audio files.
21. ContainerLines.astro: Swiss architectural container guide lines, boundary markers, and corner crosshairs.
22. StickyStack.astro: Pure CSS sticky storytelling card deck with additive depth scaling and scrim fade.
23. ScrollProgressBar.astro: Hardware-accelerated 2px top reading progress indicator driven by scaleX transform.
24. KeyboardShortcutsModal.astro: Emil Kowalski / Linear keyboard shortcuts HUD modal triggered by ? or Shift+/.
25. FloatingBackToTop.astro: Kinetic floating back-to-top dial with SVG radial progress meter and Lenis scroll return.
26. OklchLab.astro: Interactive OKLCH color science synthesizer with Lightness, Chroma, Hue sliders and token generator.
27. TelemetryHud.astro: Real-time in-browser Core Web Vitals HUD measuring 60fps frame rate and edge TTFB (Alt+T).
28. AccessibilityModal.astro: Sensory & Accessibility Command Center (WCAG AAA) with motion dials and reading ruler (Alt+A).
29. ProjectShowcase.astro: Architectural flagship project showcase bento grid demonstrating edge deployments with live metrics.
30. Breadcrumb.astro: Accessible hierarchical breadcrumb trail with automated Schema.org BreadcrumbList microdata.
31. PricingTable.astro: Awwwards-grade SaaS pricing matrix with monthly/annual billing toggle and magnetic conversion CTA buttons.
32. FaqSection.astro: Accessible disclosure accordion with automated Schema.org FAQPage JSON-LD microdata for Google rich snippets.
33. BrowserWindow.astro: Apple/Linear glass browser mockup frame with macOS traffic light controls, URL omnibar, and responsive viewport slot.

## 4. The 6 OKLCH Mathematical Palettes
1. Solar Amber: oklch(0.75 0.16 75), Glow: oklch(0.75 0.16 75 / 0.15), Spark: oklch(0.85 0.18 85)
2. Cyber Emerald: oklch(0.78 0.17 150), Glow: oklch(0.78 0.17 150 / 0.15), Spark: oklch(0.88 0.19 155)
3. Deep Cobalt: oklch(0.72 0.18 245), Glow: oklch(0.72 0.18 245 / 0.15), Spark: oklch(0.82 0.20 250)
4. Cosmic Crimson: oklch(0.70 0.22 25), Glow: oklch(0.70 0.22 25 / 0.15), Spark: oklch(0.80 0.24 30)
5. Quantum Violet: oklch(0.74 0.20 305), Glow: oklch(0.74 0.20 305 / 0.15), Spark: oklch(0.84 0.22 310)
6. Solar Paper: oklch(0.55 0.16 75), Glow: oklch(0.55 0.16 75 / 0.12), Spark: oklch(0.45 0.18 75)

## 5. The Sovereign Cull & Prune Decision Matrix
- IMMUTABLE CORE (Never Delete): src/config/site.config.ts, src/layouts/Layout.astro, src/styles/global.css, public/_headers, public/_routes.json, astro.config.mjs, scripts/audit-cloudflare-static.js, scripts/fork.js.
- CORE CRAFT (Required for Base Shell): SmoothScroll.astro, NoiseOverlay.astro, ThemePaletteSwitcher.astro, BadgePill.astro, SpotlightCard.astro.
- REPLACEABLE (Safe to Customize Content): src/pages/index.astro, src/content/docs/*.md.
- OPTIONAL (Safe to Prune for Minimal Sites): src/pages/styleguide.astro, src/pages/architecture.astro, src/pages/changelog.astro, src/pages/docs/, optional non-core craft primitives.

## 6. Autonomous Rebrand & Scaffolding Command
```bash
npm run fork -- \
  --name "Your Brand" \
  --tagline "Your Tagline" \
  --author "Your Organization" \
  --url "https://your-domain.pages.dev" \
  --palette emerald \
  --detach-git
```

## 7. The 10-Gate Cloudflare Pages Purity Audit
Gate 1: Pre-rendered HTML Entry exists (dist/index.html).
Gate 2: Zero runtime Workers (functions/ absent, _routes.json verified).
Gate 3: Page count <= 20,000 free tier limit.
Gate 4: Zero hardcoded hex colors (#...) in src/components/.
Gate 5: wrangler.jsonc points pages_build_output_dir to ./dist.
Gate 6: dist/_headers includes HSTS, CSP, and immutable /_astro/* caching.
Gate 7: Astro 7 Content Layer schema and docs collections verified.
Gate 8: Craft primitives registry intact in src/components/craft/.
Gate 9: All 6 OKLCH palettes verified in site.config.ts.
Gate 10: Decoupled CLI toolchain verified at bin/bob-astro (and bin/abc-astro).